pmx-canvas 0.10.0 → 0.11.0

package/plugins/pmx-canvas/tools.json

@@ -5148,6 +5148,38 @@
               "previous"
             ]
           },
+          "presenter": {
+            "description": "Document intent order and expected board activation",
+            "type": "object",
+            "properties": {
+              "clientId": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128
+              },
+              "intent": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+              },
+              "catalogEpoch": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128
+              },
+              "boardGeneration": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+              }
+            },
+            "required": [
+              "clientId",
+              "intent",
+              "catalogEpoch",
+              "boardGeneration"
+            ]
+          },
           "present": {
             "description": "Start presenting in viewers that are not presenting yet (default true; false only moves presenting viewers)",
             "type": "boolean"
@@ -5454,7 +5486,6 @@
                     "type": "string",
                     "enum": [
                       "tour.set",
-                      "tour.exit",
                       "annotation.remove"
                     ]
                   },
@@ -5494,142 +5525,249 @@
                     "const": "success"
                   },
                   "data": {
-                    "type": "object",
-                    "properties": {
-                      "ok": {
-                        "type": "boolean"
-                      },
-                      "index": {
-                        "type": "integer",
-                        "minimum": 0,
-                        "maximum": 9007199254740991
-                      },
-                      "total": {
-                        "type": "integer",
-                        "minimum": 0,
-                        "maximum": 9007199254740991
-                      },
-                      "stop": {
+                    "anyOf": [
+                      {
                         "type": "object",
                         "properties": {
-                          "target": {
-                            "anyOf": [
-                              {
-                                "type": "object",
-                                "properties": {
-                                  "nodeId": {
-                                    "type": "string",
-                                    "minLength": 1
-                                  }
-                                },
-                                "required": [
-                                  "nodeId"
-                                ],
-                                "additionalProperties": false
-                              },
-                              {
-                                "type": "object",
-                                "properties": {
-                                  "rect": {
+                          "ok": {
+                            "type": "boolean"
+                          },
+                          "catalogEpoch": {
+                            "type": "string"
+                          },
+                          "boardGeneration": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                          },
+                          "sequence": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                          },
+                          "index": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                          },
+                          "total": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                          },
+                          "stop": {
+                            "type": "object",
+                            "properties": {
+                              "target": {
+                                "anyOf": [
+                                  {
                                     "type": "object",
                                     "properties": {
-                                      "x": {
-                                        "type": "number"
-                                      },
-                                      "y": {
-                                        "type": "number"
-                                      },
-                                      "width": {
-                                        "type": "number",
-                                        "exclusiveMinimum": 0
-                                      },
-                                      "height": {
-                                        "type": "number",
-                                        "exclusiveMinimum": 0
+                                      "nodeId": {
+                                        "type": "string",
+                                        "minLength": 1
                                       }
                                     },
                                     "required": [
-                                      "x",
-                                      "y",
-                                      "width",
-                                      "height"
+                                      "nodeId"
                                     ],
                                     "additionalProperties": false
-                                  }
-                                },
-                                "required": [
-                                  "rect"
-                                ],
-                                "additionalProperties": false
-                              },
-                              {
-                                "type": "object",
-                                "properties": {
-                                  "viewport": {
+                                  },
+                                  {
                                     "type": "object",
                                     "properties": {
-                                      "x": {
-                                        "type": "number"
-                                      },
-                                      "y": {
-                                        "type": "number"
-                                      },
-                                      "scale": {
-                                        "type": "number",
-                                        "exclusiveMinimum": 0
+                                      "rect": {
+                                        "type": "object",
+                                        "properties": {
+                                          "x": {
+                                            "type": "number"
+                                          },
+                                          "y": {
+                                            "type": "number"
+                                          },
+                                          "width": {
+                                            "type": "number",
+                                            "exclusiveMinimum": 0
+                                          },
+                                          "height": {
+                                            "type": "number",
+                                            "exclusiveMinimum": 0
+                                          }
+                                        },
+                                        "required": [
+                                          "x",
+                                          "y",
+                                          "width",
+                                          "height"
+                                        ],
+                                        "additionalProperties": false
                                       }
                                     },
                                     "required": [
-                                      "x",
-                                      "y",
-                                      "scale"
+                                      "rect"
+                                    ],
+                                    "additionalProperties": false
+                                  },
+                                  {
+                                    "type": "object",
+                                    "properties": {
+                                      "viewport": {
+                                        "type": "object",
+                                        "properties": {
+                                          "x": {
+                                            "type": "number"
+                                          },
+                                          "y": {
+                                            "type": "number"
+                                          },
+                                          "scale": {
+                                            "type": "number",
+                                            "exclusiveMinimum": 0
+                                          }
+                                        },
+                                        "required": [
+                                          "x",
+                                          "y",
+                                          "scale"
+                                        ],
+                                        "additionalProperties": false
+                                      }
+                                    },
+                                    "required": [
+                                      "viewport"
                                     ],
                                     "additionalProperties": false
                                   }
-                                },
-                                "required": [
-                                  "viewport"
-                                ],
-                                "additionalProperties": false
+                                ]
+                              },
+                              "duration": {
+                                "type": "number",
+                                "minimum": 0,
+                                "maximum": 3600
+                              },
+                              "easing": {
+                                "type": "string",
+                                "enum": [
+                                  "linear",
+                                  "ease-in-out",
+                                  "ease-out"
+                                ]
+                              },
+                              "padding": {
+                                "type": "number",
+                                "minimum": 0
+                              },
+                              "pullback": {
+                                "type": "number",
+                                "minimum": 0,
+                                "maximum": 4
                               }
-                            ]
+                            },
+                            "required": [
+                              "target"
+                            ],
+                            "additionalProperties": false
+                          }
+                        },
+                        "required": [
+                          "ok",
+                          "catalogEpoch",
+                          "boardGeneration",
+                          "sequence",
+                          "index",
+                          "total",
+                          "stop"
+                        ],
+                        "additionalProperties": {}
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "ok": {
+                            "type": "boolean",
+                            "const": true
                           },
-                          "duration": {
-                            "type": "number",
-                            "minimum": 0,
-                            "maximum": 3600
+                          "superseded": {
+                            "type": "boolean",
+                            "const": true
+                          }
+                        },
+                        "required": [
+                          "ok",
+                          "superseded"
+                        ],
+                        "additionalProperties": false
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "operation",
+                  "outcome",
+                  "data"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "operation": {
+                    "type": "string",
+                    "const": "tour.exit"
+                  },
+                  "outcome": {
+                    "type": "string",
+                    "const": "success"
+                  },
+                  "data": {
+                    "anyOf": [
+                      {
+                        "type": "object",
+                        "properties": {
+                          "ok": {
+                            "type": "boolean"
                           },
-                          "easing": {
-                            "type": "string",
-                            "enum": [
-                              "linear",
-                              "ease-in-out",
-                              "ease-out"
-                            ]
+                          "catalogEpoch": {
+                            "type": "string"
                           },
-                          "padding": {
-                            "type": "number",
-                            "minimum": 0
+                          "boardGeneration": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
                           },
-                          "pullback": {
-                            "type": "number",
+                          "sequence": {
+                            "type": "integer",
                             "minimum": 0,
-                            "maximum": 4
+                            "maximum": 9007199254740991
                           }
                         },
                         "required": [
-                          "target"
+                          "ok",
+                          "catalogEpoch",
+                          "boardGeneration",
+                          "sequence"
+                        ],
+                        "additionalProperties": {}
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "ok": {
+                            "type": "boolean",
+                            "const": true
+                          },
+                          "superseded": {
+                            "type": "boolean",
+                            "const": true
+                          }
+                        },
+                        "required": [
+                          "ok",
+                          "superseded"
                         ],
                         "additionalProperties": false
                       }
-                    },
-                    "required": [
-                      "ok",
-                      "index",
-                      "total",
-                      "stop"
-                    ],
-                    "additionalProperties": {}
+                    ]
                   }
                 },
                 "required": [

package/skills/pmx-canvas/SKILL.md

@@ -106,7 +106,7 @@ for the authoritative stop, viewport, persistence, reset, group-order, and captu
 
 ## Runtime prerequisites
 
-PMX Canvas 0.10.0 requires **Bun >=1.4.4**, including when installed through npm.
+PMX Canvas 0.11.0 requires **Bun >=1.4.4**, including when installed through npm.
 Check `bun --version` and ensure Bun is on the MCP host's PATH, not just your shell's;
 use an absolute executable path if needed. Install/configure only when requested.
 For pinned installation, MCP configuration, managed services, and disposable verification,
@@ -525,6 +525,10 @@ Use the visible workbench when the human is actively curating layout:
 - Drop files or URLs to create matching nodes; an empty board shows starter actions (new note,
   pick files, paste a link, start an agent session).
 - Use a markdown node's Edit button to edit its content.
+- For a frameless section label, set Markdown `data.display: "heading"` (or choose
+  **Display as heading** in its menu). `"card"` restores the ordinary frame.
+- Zoom keeps the same spatial board and scales card content proportionally.
+  Viewers load automatically near the viewport, including at fit-all zoom.
 - **Groups** are frames with the name pill and an action cluster (auto-arrange children, collapse,
   ⋯ rename / ungroup / pin all) on the top edge. Membership changes only on release while the
   "release to add to <group>" pill shows (Esc keeps it out); dragging a child fully out offers
@@ -787,23 +791,12 @@ changes do not advance content revisions, while semantic edits and undo do.
 - A hosted ext-app (Excalidraw) node in a **WebKit** host panel (e.g. the GitHub Copilot app's
   embedded WKWebView) can remain blank even when its API session is healthy and `sessionStatus`
   is `ready`. This host-specific rendering issue remains open; successful Chrome/Codex rendering
-  does not establish native-host health. Since 0.4.6 the canvas runs a **paint oracle +
-  recovery ladder** under WebKit: present-at-load ext-apps mount strictly one at a time (the
-  cold burst was the trigger), each frame answers a double-rAF **paint probe** after settle, and
-  on silence the ladder escalates — soft-expand cycle (the automatic analogue of the proven
-  enlarge+close) → serialized remount → an explicit "App surface failed to paint / Retry"
-  affordance. Native Copilot/WebKit surfaces can still remain blank despite a successful
-  probe, including when visibility is reported as visible. The recovery trail
-  (`GET /api/canvas/debug/ext-app-recovery` / `window.__PMX_EXTAPP_LOG`) now records
-  `mount-slot`, `paint-ok`, `paint-fail`, `soft-expand-cycle`, `recovery-exhausted`, and
-  `assume-visible-rearm`. Treat `paint-ok`/`paint-fail` as diagnostic evidence, not compositor
-  proof. Require a rendered screenshot in the affected host before declaring its surface
-  healthy; a Chromium pass does not close a native Copilot/WebKit failure. In a host that
-  reports the document hidden, `paint-ok` is recorded as
-  `paint-ok (unverified: host hidden)` — the app answered the paint probe, but nothing is
-  proven composited, so do not treat it as a verified paint. If a
-  tile still shows the Retry affordance, click Retry (fresh recovery budget) or expand-then-close;
-  attach the recovery trail when reporting.
+  does not establish native-host health. Viewers now share one loading/paint handoff and
+  explicit **Retry**. The old WebKit recovery ladder and its
+  diagnostic log endpoint are removed. A double-rAF acknowledgement establishes document
+  scheduling, not native compositor health. Require a rendered screenshot in the affected
+  host before declaring its surface healthy. A failed replacement keeps the last painted
+  document; use its Retry control rather than expecting automatic remount cycles.
 - Ext-app frame documents live in server memory. Through 0.4.0, killing/restarting the daemon
   while a panel stays open leaves ext-app tiles on dead frame URLs (`Frame document not found`,
   0.4.0 report Finding S) until a full workbench reload. Since 0.4.1 the browser revalidates its

package/skills/pmx-canvas/references/full-reference.md

@@ -555,10 +555,15 @@ Once the board list has loaded, all workbench context-pin writes send the captur
 `expectedBoardId`; a server-side board switch returns 409 instead of changing
 another board's pins. Receipt pin actions require reopening the owning board.
 
-Embedded JSON/graph runtime readiness waits up to 10 seconds after document load
-and retries a failed handoff once while retaining the last painted document.
-After another failure, the error toast/history say **Reload to retry**; a later
-healthy authored update can recover. This is not an overall network-load timeout.
+Embedded previews mount automatically near the viewport at every zoom and remain
+mounted to preserve arbitrary app state. There is no lifetime preview cap. Mermaid renders
+inline, without an iframe. JSON/graph viewers inherit all nine named canvas themes
+and keep form drafts when the theme changes. During replacement, the pending
+document temporarily coexists with its painted predecessor.
+
+A network load or missing JSON runtime times out after 10 seconds and offers a
+visible **Retry**, retaining the last painted document during replacement.
+An already mounted offscreen runtime may wait for paint without being timed out.
 
 Native edge add accepts optional `toBoardId`: `from` is on the open source board,
 `to` is a card on the target board. CLI: `pmx-canvas edge add --from <source> --to <target>

package/skills/pmx-canvas/references/installing-pmx-canvas.md

@@ -4,7 +4,7 @@ Use this reference when the `pmx-canvas` skill is installed but the `pmx-canvas`
 
 ## Prerequisites and version
 
-The examples pin **PMX Canvas 0.10.0**, which requires **Bun >=1.4.4** even when
+The examples pin **PMX Canvas 0.11.0**, which requires **Bun >=1.4.4** even when
 installed through npm: the CLI runs through Bun, not Node. Check `bun --version`
 first. If missing or older, follow the [Bun installation instructions](https://bun.sh/docs/installation)
 with the user's authorization. Ensure Bun is on the MCP host's PATH as well as the
@@ -22,11 +22,11 @@ in `SKILL.md`. Do not pair newer checkout guidance with an older runtime unknowi
 ## Install from npm
 
 ```bash
-npm install -g pmx-canvas@0.10.0
+npm install -g pmx-canvas@0.11.0
 pmx-canvas --version
 ```
 
-Without a global install, use `bunx pmx-canvas@0.10.0` in place of `pmx-canvas` in
+Without a global install, use `bunx pmx-canvas@0.11.0` in place of `pmx-canvas` in
 the commands below. Do not use unpinned `bunx pmx-canvas` for a version-specific check.
 
 ## Choose the workspace and target
@@ -96,7 +96,7 @@ discards empty env values, remove `PMX_CANVAS_URL` from its launch environment i
   "mcpServers": {
     "canvas": {
       "command": "bunx",
-      "args": ["pmx-canvas@0.10.0", "--mcp"],
+      "args": ["pmx-canvas@0.11.0", "--mcp"],
       "env": {
         "PMX_CANVAS_WORKSPACE_ROOT": "/absolute/path/to/project",
         "PMX_CANVAS_PORT": "14313",
@@ -140,7 +140,7 @@ Amp executes, not only on the user's laptop. Merge this into that workspace's
   "amp.mcpServers": {
     "canvas": {
       "command": "bunx",
-      "args": ["pmx-canvas@0.10.0", "--mcp"],
+      "args": ["pmx-canvas@0.11.0", "--mcp"],
       "includeTools": ["canvas_*"],
       "env": {
         "PMX_CANVAS_WORKSPACE_ROOT": "/absolute/path/to/project",
@@ -174,7 +174,7 @@ The agent must not run this approval itself or move the command to global settin
 `--mcp-config` to bypass workspace trust. Approval authorizes execution of this MCP
 command; it is not a new Canvas import consent or permission to mutate arbitrary boards.
 After approval, reload MCP connections (`reload_mcp` in Amp) and require `connected`.
-Discover `canvas` tools with `tool_search`; the full unfiltered 0.10.0 server has 25 tools,
+Discover `canvas` tools with `tool_search`; the full unfiltered 0.11.0 server has 25 tools,
 including `canvas_help`. If still absent, inspect the server status, command/PATH and target instead
 of reinstalling blindly. See [Amp MCP documentation](https://ampcode.com/docs/customize/mcp).
 

package/skills/published-consumer-e2e/scripts/run-published-consumer-e2e.sh

@@ -75,11 +75,9 @@ if [[ -f "${REPO_ROOT}/LICENSE" ]]; then
   cp "${REPO_ROOT}/LICENSE" "${PACKAGE_STAGING}/package/LICENSE"
 fi
 cp -R "${REPO_ROOT}/src" "${PACKAGE_STAGING}/package/src"
-mkdir -p "${PACKAGE_STAGING}/package/dist/canvas" "${PACKAGE_STAGING}/package/dist/json-render"
-cp "${REPO_ROOT}/dist/canvas/index.js" "${PACKAGE_STAGING}/package/dist/canvas/index.js"
-cp "${REPO_ROOT}/dist/canvas/global.css" "${PACKAGE_STAGING}/package/dist/canvas/global.css"
-cp "${REPO_ROOT}/dist/json-render/index.js" "${PACKAGE_STAGING}/package/dist/json-render/index.js"
-cp "${REPO_ROOT}/dist/json-render/index.css" "${PACKAGE_STAGING}/package/dist/json-render/index.css"
+mkdir -p "${PACKAGE_STAGING}/package/dist"
+cp -R "${REPO_ROOT}/dist/canvas" "${PACKAGE_STAGING}/package/dist/canvas"
+cp -R "${REPO_ROOT}/dist/json-render" "${PACKAGE_STAGING}/package/dist/json-render"
 TARBALL="pmx-canvas-published-consumer.tgz"
 tar -czf "${PACK_DIR}/${TARBALL}" -C "${PACKAGE_STAGING}" package
 

package/src/client/canvas/BarHint.tsx

@@ -20,6 +20,7 @@ export function BarPortal({ children }: { children: VNode }) {
  * `title` hints, which are delay-gated and never render in embedded panes.
  */
 export function BarHint({
+  id,
   label,
   shortcut,
   body,
@@ -29,10 +30,12 @@ export function BarHint({
   fitWithin,
   children,
 }: {
+  /** Optional description target for the control's aria-describedby. */
+  id?: string;
   label: string;
   shortcut?: string;
-  /** One or two plain sentences under the label — the explanation a native `title` used to hide. */
-  body?: string;
+  /** Explanatory text, optionally split into readable paragraphs. */
+  body?: ComponentChildren;
   align?: 'start' | 'center' | 'end';
   /** Which way the tooltip opens. Bars at the bottom of the region open 'up'. */
   side?: 'down' | 'up';
@@ -73,7 +76,7 @@ export function BarHint({
       onFocusIn={fitWithin ? fit : undefined}
     >
       {children}
-      <span class="toolbar-tooltip" role="tooltip">
+      <span id={id} class="toolbar-tooltip" role="tooltip">
         <span class="toolbar-tooltip-label">{label}</span>
         {body && <span class="toolbar-tooltip-body">{body}</span>}
         {shortcut && (