pmx-canvas 0.1.30 → 0.1.31

package/CHANGELOG.md

@@ -3,6 +3,63 @@
 All notable changes to `pmx-canvas` are documented here. This project follows
 [Semantic Versioning](https://semver.org/).
 
+## [0.1.31] - 2026-06-07
+
+### Added
+
+- **Default docked status + context widgets.** A freshly opened canvas now shows
+  the agent's status widget docked at the left of the top menu and the context
+  widget docked at the right — flanking the toolbar as one continuous bar at the
+  same height. They are the same `status-main` / `context-main` nodes the
+  agent-event path already creates, just present from the start. Each collapsed
+  widget has an expand (▸) and an undock (⊙) control; undocking returns it to the
+  canvas as a normal node. Seeded **once on first run** (brand-new workspace
+  only) — never added to a canvas that already has content, and deleting or
+  undocking them is remembered (they are not re-seeded). `--demo` is unaffected
+  (it seeds the demo board instead).
+
+### Changed
+
+- **Collapsed docked widgets match the toolbar height.** The collapsed context
+  widget now renders inline in the top HUD row (mirroring the status widget)
+  instead of as a separate right-edge side-tab, and a shared `--hud-bar-height`
+  keeps the toolbar and both docked pills at an identical height.
+
+### Fixed
+
+- **Context nodes can be undocked.** Previously a `context` node was re-forced to
+  `dockPosition: 'right'` on every write, so it could never leave the dock. The
+  right-docked collapsed default is now applied at create time only; updates
+  (including undock → `dockPosition: null`) are respected.
+
+- **SDK node-response parity (report #31/#32).** `PmxCanvas.addNode`, `getNode`,
+  and `addHtmlNode` now return the fully serialized node enriched with a
+  `surfaceUrl` (for surface-eligible types) and a `nodeId` alias for `id`,
+  matching the HTTP/CLI `node`-create responses field-for-field. `addHtmlNode`
+  now returns the created node object instead of a bare id string (consistent
+  with `addNode`); read `.id` if you only need the identifier. The internal
+  `CanvasAccess` contract is unchanged (still returns a bare id).
+
+- **HTML "Open as site" tab title (report #35).** The standalone surface document
+  for an `html` node now carries a `<title>` (the node title) when the author
+  HTML does not already declare one, so the browser tab shows the node title
+  instead of falling back to the raw `/api/canvas/surface/<id>` URL. An
+  author-provided `<title>` is never overridden, and the injected title is
+  HTML-escaped.
+
+### Notes
+
+- **Report #33/#34/#36 — not reproduced.** #33 (elicitation/mode immediate
+  resolve) and #34 (delivery "claim" route) were already closed by the tester's
+  Codex retest as wrong-route repros. #36 (CLI emitting invalid JSON for html
+  primitives) does not reproduce: all 19 primitive kinds return valid JSON
+  through both `pmx-canvas html primitive add | jq` and raw `curl | jq`, with
+  zero unescaped control characters — the CLI re-serializes via `JSON.stringify`
+  and the server uses `Response.json`, both of which always escape U+0000–U+001F.
+  The full rendered HTML body is intentionally retained in the create response
+  (it is relied upon by consumers and renderer tests; agents wanting a compact
+  payload can use the MCP tool, which is already compact by default).
+
 ## [0.1.30] - 2026-06-07
 
 ### Added
@@ -1575,6 +1632,7 @@ otherwise have to discover by trial and error.
 - Regression coverage for snapshot flat-`id` aliases on both MCP and
   HTTP surfaces, plus async / top-level-`await` WebView script bodies.
 
+[0.1.31]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.1.31
 [0.1.30]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.1.30
 [0.1.29]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.1.29
 [0.1.28]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.1.28

package/dist/canvas/global.css

@@ -56,6 +56,10 @@
   --mono: "IBM Plex Mono", "SF Mono", "Fira Code", monospace;
   --radius: 10px;
   --radius-sm: 6px;
+  /* Shared height for the top HUD row so the toolbar and the collapsed docked
+     status/context widgets that flank it line up to the same height. Matches the
+     toolbar's natural content height (icon buttons at 6px padding). */
+  --hud-bar-height: 44px;
 }
 
 :root[data-theme="light"] {
@@ -481,6 +485,8 @@ body,
   align-items: center;
   gap: 6px;
   padding: 6px 10px;
+  min-height: var(--hud-bar-height);
+  box-sizing: border-box;
   background: var(--c-panel-glass);
   backdrop-filter: blur(12px);
   border: 1px solid var(--c-line);
@@ -1409,6 +1415,38 @@ html.is-node-resizing .ext-app-preview-catcher {
   max-width: 320px;
 }
 
+/* Collapsed docked widget = a single menu-height pill that flanks the toolbar.
+   Pinned to the same height as .canvas-toolbar so the top HUD row reads as one
+   continuous bar (status on the left, context on the right). */
+.docked-node--collapsed {
+  height: var(--hud-bar-height);
+  box-sizing: border-box;
+  justify-content: center;
+  width: auto;
+  /* Reset the base .docked-node min-width so the collapsed pill hugs its content
+     (badge + count + controls) instead of stretching to a 200px bar. */
+  min-width: 0;
+}
+.docked-node--collapsed .docked-node-header {
+  height: 100%;
+  padding: 0 10px;
+  border-bottom: none;
+}
+.docked-node-count {
+  min-width: 18px;
+  height: 18px;
+  padding: 0 5px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 9px;
+  background: var(--c-accent);
+  color: var(--c-contrast-fg);
+  font-size: 10px;
+  font-weight: 700;
+  flex-shrink: 0;
+}
+
 .docked-node-header {
   display: flex;
   align-items: center;
@@ -1948,62 +1986,6 @@ html.is-node-resizing .ext-app-preview-catcher {
   max-width: 200px;
 }
 
-/* Context dock — collapsed pill mirrors Updates pill, sits above it */
-.context-dock-tab {
-  position: fixed;
-  top: 92px;
-  right: 0;
-  display: flex;
-  align-items: center;
-  gap: 8px;
-  padding: 8px 12px 8px 14px;
-  background: color-mix(in srgb, var(--c-panel-glass) 96%, transparent);
-  backdrop-filter: blur(16px);
-  border: 1px solid color-mix(in srgb, var(--c-line) 82%, var(--c-accent) 18%);
-  border-right: 0;
-  border-radius: 14px 0 0 14px;
-  box-shadow: 0 12px 36px var(--c-shadow);
-  color: var(--c-text);
-  cursor: pointer;
-  font: inherit;
-  font-size: 11px;
-  font-weight: 600;
-  letter-spacing: 0.08em;
-  text-transform: uppercase;
-  z-index: 60;
-}
-
-.context-dock-tab:hover {
-  border-color: color-mix(in srgb, var(--c-accent) 40%, var(--c-line) 60%);
-  color: var(--c-accent);
-}
-
-.context-dock-tab svg {
-  display: block;
-  color: var(--c-accent);
-  flex-shrink: 0;
-}
-
-.context-dock-tab-label {
-  white-space: nowrap;
-}
-
-.context-dock-tab-badge {
-  min-width: 18px;
-  height: 18px;
-  padding: 0 5px;
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  border-radius: 9px;
-  background: var(--c-accent);
-  color: var(--c-contrast-fg);
-  font-size: 10px;
-  font-weight: 700;
-  letter-spacing: 0;
-  text-transform: none;
-}
-
 /* Context dock — expanded panel anchored top-right edge.
    Mutually exclusive with the Updates panel (see DockedNode.tsx and
    AttentionHistory.tsx) — opening one collapses the other, so they can both