nudge-ui 0.2.5 → 0.2.6

package/dist/inspector/canvas/agentPresentation.d.ts

@@ -1,10 +1,6 @@
 import { type CanvasCommand, type CanvasCommandResult, type CanvasGroup, type CanvasState } from "../../internal/agent-protocol.js";
 import { type CanvasCard } from "./canvasStore.js";
-/**
- * Renderer acknowledgements are deliberately shorter than the companion's
- * request timeout. A controller can therefore receive a useful partial-failure
- * acknowledgement instead of waiting for the browser bridge to expire first.
- */
+/** Deliberately shorter than the companion's request timeout, so partial failures surface as acknowledgements. */
 export declare const DEFAULT_RENDERER_READY_TIMEOUT_MS = 4000;
 export declare const MAX_RENDERER_READY_TIMEOUT_MS = 5000;
 export declare const MAX_PRESENTATION_ROUTES: 64;
@@ -17,7 +13,6 @@ export interface AgentRendererReadiness {
     failedCardIds: string[];
     timedOutCardIds: string[];
 }
-/** Direct callers may use URL strings; the shared command uses AgentRoute. */
 export interface AgentPresentationRoute {
     url: string;
     title?: string | null;
@@ -46,13 +41,11 @@ export declare class AgentPresentationError extends Error {
     readonly code: AgentPresentationErrorCode;
     constructor(code: AgentPresentationErrorCode, message: string);
 }
-/** Records the renderer acknowledgement for one newly presented card. */
 export declare function acknowledgeAgentRendererReady(cardId: string): void;
 /** Records a bounded, non-throwing renderer failure for one presented card. */
 export declare function acknowledgeAgentRendererError(cardId: string, message?: string): void;
 export declare function forgetAgentRendererReadiness(cardIds: readonly string[]): void;
 export declare function waitForAgentRendererReadiness(cardIds: readonly string[], timeoutMs?: number): Promise<AgentRendererReadiness>;
-/** Returns the compact state shape shared with the companion bridge. */
 export declare function readCanvasState(): CanvasState;
 export declare function presentAgentRoutes(input: PresentAgentRoutesInput): Promise<AgentRoutesPresentation>;
 export declare function focusAgentGroup(groupId: string, viewport?: {
@@ -77,11 +70,7 @@ export interface AgentPresentationCommandPort {
     execute(command: unknown): Promise<CanvasCommandResult>;
     dispose(): void;
 }
-/**
- * Creates the browser-controller adapter consumed by the inspector's
- * CopyPromptButton. It does not install window events or define a second
- * message protocol; callers pass the plain shared CanvasCommand they received.
- */
+/** Does not install window events or define a second message protocol; callers pass the shared CanvasCommand. */
 export declare function createAgentPresentationAdapter(options?: AgentPresentationAdapterOptions): AgentPresentationCommandPort;
 /** Clears presentation-only state between browser sessions and unit tests. */
 export declare function resetAgentPresentationState(): void;

package/dist/inspector/canvas/agentPresentation.js

@@ -6,11 +6,7 @@ import { canWriteWorkspace } from "./workspaceLease.js";
 import { removeFrame } from "../workspace/commands.js";
 import { appendAgentRouteCards, getFrameGroup, getFrameGroups, setFrameGroup, removeFrameGroup, batchCanvasChanges, fitAllCards, focusCard, focusCanvasCards, getCanvasCards, getFocusedCardId, } from "./canvasStore.js";
 import { getCanvasMode, setCanvasMode } from "./viewStore.js";
-/**
- * Renderer acknowledgements are deliberately shorter than the companion's
- * request timeout. A controller can therefore receive a useful partial-failure
- * acknowledgement instead of waiting for the browser bridge to expire first.
- */
+/** Deliberately shorter than the companion's request timeout, so partial failures surface as acknowledgements. */
 export const DEFAULT_RENDERER_READY_TIMEOUT_MS = 4_000;
 export const MAX_RENDERER_READY_TIMEOUT_MS = 5_000;
 export const MAX_PRESENTATION_ROUTES = AGENT_PROTOCOL_LIMITS.routeCount;
@@ -147,7 +143,6 @@ function beginRendererReadiness(cardIds) {
         rendererReadiness.set(cardId, { status: "pending" });
     settleReadinessWaiters();
 }
-/** Records the renderer acknowledgement for one newly presented card. */
 export function acknowledgeAgentRendererReady(cardId) {
     if (!isNonEmptyString(cardId))
         return;
@@ -208,7 +203,6 @@ function groupCardIds(groupId) {
         .filter((card) => card.groupId === groupId)
         .map((card) => card.id);
 }
-/** Returns the compact state shape shared with the companion bridge. */
 export function readCanvasState() {
     const focusedCardId = getFocusedCardId();
     const focusedCard = focusedCardId
@@ -249,8 +243,7 @@ export async function presentAgentRoutes(input) {
             throw new AgentPresentationError("group-id-conflict", `Route group ${groupId} already exists.`);
         }
         const readyTimeoutMs = clampReadyTimeout(input.readyTimeoutMs);
-        // Opening Canvas for an agent group appends only the requested routes. It
-        // never creates or repositions the current Inspect route.
+        // Appends only the requested routes; the current Inspect route is never created or repositioned.
         setCanvasMode("canvas");
         const cards = batchCanvasChanges(() => {
             setFrameGroup({ id: groupId, kind: "agent", label, agentId, routes: routes.map((route) => ({ ...route })) });
@@ -396,11 +389,7 @@ function credentialsFrom(options) {
         agentId: options.agentId ?? DEFAULT_AGENT_ID,
     };
 }
-/**
- * Creates the browser-controller adapter consumed by the inspector's
- * CopyPromptButton. It does not install window events or define a second
- * message protocol; callers pass the plain shared CanvasCommand they received.
- */
+/** Does not install window events or define a second message protocol; callers pass the shared CanvasCommand. */
 export function createAgentPresentationAdapter(options = {}) {
     const credentials = credentialsFrom(options);
     let disposed = false;

package/dist/inspector/canvas/canvasFrame.d.ts

@@ -1,7 +1,4 @@
-/**
- * The renderer behind a Canvas card, as controller code sees it. Cards on the
- * Canvas pass their iframe; the page surface passes the inspected window.
- */
+/** The renderer behind a Canvas card (its iframe) or the page surface (the inspected window). */
 export interface CanvasFrame {
     readonly contentWindow: Window | null;
     readonly contentDocument: Document | null;
@@ -10,7 +7,6 @@ export interface CanvasFrame {
     readonly clientHeight: number;
     getBoundingClientRect(): DOMRect;
 }
-/** The card's iframe element, or null for the page surface. */
 export declare function canvasFrameElement(frame: CanvasFrame): HTMLIFrameElement | null;
-/** The element sketch capture measures: the iframe, or the page's root element. */
+/** What sketch capture measures: the iframe, or the page's root element. */
 export declare function canvasFrameHost(frame: CanvasFrame | null): HTMLElement | null;

package/dist/inspector/canvas/canvasFrame.js

@@ -1,8 +1,7 @@
-/** The card's iframe element, or null for the page surface. */
 export function canvasFrameElement(frame) {
     return typeof HTMLIFrameElement !== "undefined" && frame instanceof HTMLIFrameElement ? frame : null;
 }
-/** The element sketch capture measures: the iframe, or the page's root element. */
+/** What sketch capture measures: the iframe, or the page's root element. */
 export function canvasFrameHost(frame) {
     if (!frame)
         return null;

package/dist/inspector/canvas/canvasResize.d.ts

@@ -19,12 +19,7 @@ interface ResizeEdges {
     readonly horizontal: "left" | "right" | null;
     readonly vertical: "top" | "bottom" | null;
 }
-/** Returns the anchored edges affected by a resize handle. */
 export declare function getCanvasResizeEdges(direction: CanvasResizeDirection): ResizeEdges;
-/**
- * Applies a pointer delta to a Canvas card while keeping the opposite edges
- * fixed. Minimum dimensions are clamped at the moving edge, so dragging past
- * the minimum does not move the anchored side.
- */
+/** Minimum dimensions clamp at the moving edge, so dragging past it never moves the anchored side. */
 export declare function resizeCanvasRect(rect: CanvasResizeRect, direction: CanvasResizeDirection, delta: CanvasResizeDelta, minimum?: CanvasResizeMinimum): CanvasResizeRect;
 export {};

package/dist/inspector/canvas/canvasResize.js

@@ -10,15 +10,10 @@ const RESIZE_EDGES = {
     "bottom-left": { horizontal: "left", vertical: "bottom" },
     left: { horizontal: "left", vertical: null },
 };
-/** Returns the anchored edges affected by a resize handle. */
 export function getCanvasResizeEdges(direction) {
     return RESIZE_EDGES[direction];
 }
-/**
- * Applies a pointer delta to a Canvas card while keeping the opposite edges
- * fixed. Minimum dimensions are clamped at the moving edge, so dragging past
- * the minimum does not move the anchored side.
- */
+/** Minimum dimensions clamp at the moving edge, so dragging past it never moves the anchored side. */
 export function resizeCanvasRect(rect, direction, delta, minimum = { width: MIN_CARD_WIDTH, height: MIN_CARD_HEIGHT }) {
     const edges = getCanvasResizeEdges(direction);
     const minWidth = Math.max(0, minimum.width);

package/dist/inspector/canvas/canvasStore.d.ts

@@ -38,7 +38,7 @@ export declare const PRIMARY_CARD_INSET = 40;
 declare function subscribe(cb: () => void): () => void;
 declare function getCards(): CanvasCard[];
 export declare function batchCanvasChanges<T>(operation: () => T): T;
-/** Adds one card while retaining the existing placement policy. */
+/** Adds one card to the end of the row. */
 export declare function addCanvasCard(url: string, title?: string): CanvasCard;
 export declare function appendAgentRouteCards(groupId: string, routes: readonly {
     url: string;
@@ -49,10 +49,7 @@ export declare function setCanvasHistoryActivator(activate: (cardId: string) =>
 export declare function removeCanvasCard(id: string, { undoable }?: {
     undoable?: boolean;
 }): void;
-/**
- * Opens one editor target in the iframe workspace without replacing restored
- * cards or their dimensions.
- */
+/** Opens one editor target without replacing restored cards or their dimensions. */
 export declare function activateIframeWorkspace(url: string, viewport: {
     width: number;
     height: number;
@@ -75,7 +72,7 @@ export declare function fitAllCards(viewport?: {
     width: number;
     height: number;
 }): void;
-/** Centers a selected set of cards without changing the current zoom. */
+/** Centers the cards without changing the current zoom. */
 export declare function focusCanvasCards(cardIds: readonly string[], viewport?: {
     width: number;
     height: number;
@@ -89,14 +86,9 @@ export declare function getSelectedCardId(): string | null;
 export declare function useSelectedCardId(): string | null;
 export declare function useFocusedCardId(): string | null;
 export declare function setCardPosition(id: string, x: number, y: number): void;
-/**
- * Starts a user move or resize. The returned commit records the whole gesture
- * as one undo step; programmatic placement through `setCardPosition` and
- * `resizeCard` stays out of history.
- */
+/** The returned commit records the whole gesture as one undo step; programmatic placement stays out of history. */
 export declare function beginCardGeometryChange(id: string): () => void;
 export declare function hydrateCanvasStore(newMode: CanvasMode, newCards: CanvasCard[], newCamera: CanvasCamera, restoredFocusedCardId?: string | null, restoredPresentation?: CanvasPresentation, restoredGroups?: readonly FrameGroup[]): void;
 export { subscribe, getCards, getCards as getCanvasCards, };
 export declare function useCanvasCards(): CanvasCard[];
-/** Returns a route-based label that distinguishes copies and HTML iterations. */
 export declare function getCanvasCardLabel(card: CanvasCard, frameCards?: readonly CanvasCard[]): string;

package/dist/inspector/canvas/canvasStore.js

@@ -1,11 +1,9 @@
-import { iterationId, contentSourceUrl, contentEditTarget } from "./frameContent.js";
-import { isDraftLocked, forgetDraft } from "../drafts/store.js";
+import { iterationId, contentSourceUrl } from "./frameContent.js";
+import { frameLifecycle } from "./frameLifecycle.js";
 import { recordCanvasChange, discardCanvasHistory } from "../workspace/timeline.js";
-import { targetKey } from "../drafts/model.js";
 import { useSyncExternalStore } from "react";
 import { DEFAULT_CAMERA, getBoardCamera, placeBoardCamera, restoreCanvasView, setCanvasMode, } from "./viewStore.js";
 import { normalizeUrl, normalizedUrlKey } from "./normalizeUrl.js";
-import { removeHtmlArtifact } from "../iterations/client.js";
 import { applyLayoutShifts, boundsOf, centerCamera, fitCamera, layoutShifts, nextCardPosition, pushOverlappingCards, reinsertInRecordedOrder, iterationPosition, } from "./layout.js";
 const frameGroups = new Map();
 export function setFrameGroup(group) { frameGroups.set(group.id, group); }
@@ -76,7 +74,7 @@ function notify() {
     }
     listeners.forEach((l) => l());
 }
-/** Adds one card while retaining the existing placement policy. */
+/** Adds one card to the end of the row. */
 export function addCanvasCard(url, title) {
     const before = cards;
     const size = lastUsedCardSize ?? defaultViewportSize();
@@ -140,8 +138,7 @@ function recordCreation(before, created) {
     const shifts = layoutShifts(before, cards);
     const restore = (redo) => {
         if (!redo) {
-            // Direct creation drags finish placement after the creation was recorded.
-            // Redo must recover the dropped position, dimensions, and loaded title.
+            // Direct creation drags finish placement after recording, so redo must recover the dropped geometry and title.
             for (const [index, recorded] of after.entries()) {
                 const current = createdIds.has(recorded.id) && cards.find((card) => card.id === recorded.id);
                 if (current)
@@ -184,14 +181,11 @@ function selectFallbackAfterRemoval(removedIds) {
     if (removedIds.has(focusedCardId ?? ""))
         focusedCardId = fallbackId;
 }
-function releaseUnusedIteration(card) {
-    const artifactId = iterationId(card.content);
-    if (!artifactId || cards.some((candidate) => iterationId(candidate.content) === artifactId))
+/** Reports removed iteration content; the drafts/artifacts owner decides what to release. */
+function releaseUnusedIteration(card, remaining = cards) {
+    if (!iterationId(card.content))
         return;
-    forgetDraft(targetKey(contentEditTarget(card.content)));
-    void removeHtmlArtifact(artifactId).catch((error) => {
-        console.warn("Nudge UI could not remove an unused HTML iteration:", error);
-    });
+    frameLifecycle().release(card.content, remaining.map((candidate) => candidate.content));
 }
 function recordRemoval(before, removed) {
     let snapshot = removed;
@@ -216,7 +210,7 @@ function recordRemoval(before, removed) {
     });
 }
 export function removeCanvasCard(id, { undoable = false } = {}) {
-    if (isDraftLocked())
+    if (!frameLifecycle().canEdit())
         return;
     const removed = cards.find((card) => card.id === id);
     if (!removed)
@@ -232,10 +226,7 @@ export function removeCanvasCard(id, { undoable = false } = {}) {
     if (!undoable)
         releaseUnusedIteration(removed);
 }
-/**
- * Opens one editor target in the iframe workspace without replacing restored
- * cards or their dimensions.
- */
+/** Opens one editor target without replacing restored cards or their dimensions. */
 export function activateIframeWorkspace(url, viewport, options = {}) {
     const normalized = normalizeUrl(url);
     if (!normalized || normalized.origin !== window.location.origin)
@@ -369,7 +360,7 @@ export function fitAllCards(viewport) {
         return;
     placeBoardCamera(fitCamera(bounds, viewport ?? windowViewport(), FIT_ALL_PADDING) ?? DEFAULT_CAMERA);
 }
-/** Centers a selected set of cards without changing the current zoom. */
+/** Centers the cards without changing the current zoom. */
 export function focusCanvasCards(cardIds, viewport) {
     const bounds = selectedBounds(cardIds);
     if (!bounds)
@@ -429,11 +420,7 @@ function cardGeometry(id) {
     const card = cards.find((candidate) => candidate.id === id);
     return card ? { x: card.x, y: card.y, width: card.width, height: card.height } : null;
 }
-/**
- * Starts a user move or resize. The returned commit records the whole gesture
- * as one undo step; programmatic placement through `setCardPosition` and
- * `resizeCard` stays out of history.
- */
+/** The returned commit records the whole gesture as one undo step; programmatic placement stays out of history. */
 export function beginCardGeometryChange(id) {
     const before = cardGeometry(id);
     let committed = false;
@@ -504,7 +491,6 @@ function frameRoute(card) {
         label: normalized.pathname,
     };
 }
-/** Returns a route-based label that distinguishes copies and HTML iterations. */
 export function getCanvasCardLabel(card, frameCards = cards) {
     const route = frameRoute(card);
     const candidates = frameCards.some((candidate) => candidate.id === card.id) ? frameCards : [...frameCards, card];

package/dist/inspector/canvas/frameConnection.d.ts

@@ -7,15 +7,10 @@ export interface FramePoint {
     readonly x: number;
     readonly y: number;
 }
-/**
- * Where a frame sits in the controller viewport, measured at one instant.
- * `scale` is measured rather than read from the camera, so it is the board
- * zoom on the Canvas, 1 in focus view, and correct mid-transition.
- */
+/** Measured, not read from the camera: correct on the board, in focus view, and mid-transition. */
 export interface FrameViewport extends Readonly<Rect> {
     readonly scale: number;
 }
-/** A renderer-owned element named by a frame message. */
 export interface RendererElementRef {
     readonly elementId: string;
     readonly cid: string;
@@ -24,7 +19,6 @@ export interface RendererElementRef {
 type Envelope = "protocolVersion" | "projectId" | "workspaceId" | "cardId";
 type WithoutEnvelope<T> = T extends unknown ? Omit<T, Envelope> : never;
 export type ControllerMessageBody = WithoutEnvelope<ControllerToRendererMessage>;
-/** One mounted Canvas frame as the controller sees it. */
 export interface FrameConnection {
     readonly cardId: string;
     readonly iframe: CanvasFrame;

package/dist/inspector/canvas/frameContent.d.ts

@@ -1,5 +1,4 @@
 import { type DraftTarget } from "../drafts/model.js";
-/** Content identity is independent of frame geometry and its editable draft. */
 export type FrameContent = {
     kind: "route";
     url: string;

package/dist/inspector/canvas/frameLifecycle.d.ts

@@ -0,0 +1,12 @@
+import type { FrameContent } from "./frameContent.js";
+/**
+ * Cross-store effects a frame removal needs: whether drafts allow editing, and
+ * who releases the frame's draft and HTML artifact. Canvas registers nothing
+ * itself, so it never imports drafts or the iteration client.
+ */
+export interface FrameLifecycle {
+    readonly canEdit: () => boolean;
+    readonly release: (released: FrameContent, remaining: readonly FrameContent[]) => void;
+}
+export declare function setFrameLifecycle(next: FrameLifecycle | null): void;
+export declare function frameLifecycle(): FrameLifecycle;

package/dist/inspector/canvas/frameLifecycle.js

@@ -0,0 +1,11 @@
+const allowAll = {
+    canEdit: () => true,
+    release: () => undefined,
+};
+let lifecycle = allowAll;
+export function setFrameLifecycle(next) {
+    lifecycle = next ?? allowAll;
+}
+export function frameLifecycle() {
+    return lifecycle;
+}

package/dist/inspector/canvas/frameProtocol.d.ts

@@ -8,12 +8,7 @@ export interface FrameMessage {
     type: string;
     protocolVersion: number;
 }
-/**
- * Pre-identity solicitation from a renderer whose bootstrap finished after
- * the controller's load-time parent-ready (or whose document never received
- * one). Carries no FrameIdentity: the whole point is that the renderer does
- * not have one yet. The controller answers with ParentReadyMessage.
- */
+/** Pre-identity solicitation from a renderer that missed parent-ready; carries no FrameIdentity. */
 export interface RendererHelloMessage extends FrameMessage {
     type: "renderer-hello";
 }
@@ -60,34 +55,26 @@ export interface ReplaceStylesMessage extends FrameMessage {
     instanceOverrides: RenderedInstanceOverride[];
     /** Controller-owned structural intent; renderers never own this change log. */
     structuralChanges: import("../projection/structuralProjection.js").StructuralChange[];
-    /** Controller-owned durable rendered text intent. */
     textContentChanges: import("../changes/types.js").TextContentChangeRecord[];
-    /** Controller-owned semantic component overrides for Canvas runtimes. */
     componentOverrides: ComponentOverride[];
     /** Generated identities the edits refer to; omitted while edits are hidden. */
     runtimeIdentities?: import("../runtime/runtimeIdentityClaims.js").RuntimeIdentityClaim[];
 }
-/** Renderer acknowledgement that one complete controller snapshot is applied. */
 export interface ProjectionAppliedMessage extends RendererMessage {
     type: "projection-applied";
     revision: number;
 }
-/**
- * Renderer-local outcomes for one controller snapshot. This is diagnostic
- * data only: accepting it never changes controller-owned structural intent.
- */
+/** Diagnostics only: accepting these never changes controller-owned structural intent. */
 export interface StructuralProjectionReportMessage extends RendererMessage {
     type: "structural-projection-report";
     revision: number;
     reports: import("../projection/structuralProjection.js").StructuralProjectionReport[];
 }
-/** Renderer-local CSS-instance outcomes for one controller snapshot. */
 export interface RenderedInstanceProjectionReportMessage extends RendererMessage {
     type: "rendered-instance-projection-report";
     revision: number;
     reports: import("../projection/renderedInstance.js").DocumentProjectionReport[];
 }
-/** Renderer-local outcomes for one controller-owned text snapshot. */
 export interface TextProjectionReportMessage extends RendererMessage {
     type: "text-projection-report";
     revision: number;
@@ -99,7 +86,6 @@ export interface NavigationIntentMessage extends RendererMessage {
     /** The renderer kept its own route and asks the controller for a card instead. */
     openInCard?: boolean;
 }
-/** Tells a renderer whether ordinary link clicks open a new canvas card. */
 export interface LinkTargetStateMessage extends RendererMessage {
     type: "link-target-state";
     openInCard: boolean;
@@ -133,15 +119,12 @@ export interface ElementHoverMessage extends RendererMessage {
         x: number;
         y: number;
     } | null;
-    /** The spacing handle under the pointer. Drives the resize cursor and drag
-     * start; only present when the pointer is inside the handle hit area. */
+    /** The spacing handle under the pointer; only present inside the handle hit area. */
     spacing?: SpacingDescriptor | null;
-    /** The padding bar or layout gap area under the pointer, regardless of the
-     * handle. Drives the hover fill overlay across the whole area. */
+    /** The padding bar or layout gap area under the pointer, regardless of the handle. */
     hoverSpacing?: SpacingDescriptor | null;
 }
-/** Modifier state stays inside one renderer frame; the parent never infers it
- * from its own keyboard events because focus lives in the iframe. */
+/** The parent never infers modifier state: focus lives in the iframe. */
 export interface ElementMeasureStateMessage extends RendererMessage {
     type: "element-measure-state";
     altKey: boolean;
@@ -159,7 +142,6 @@ export interface ElementClickMessage extends RendererMessage {
     /** True for a Shift-click that toggles this target in the selection group. */
     additive?: boolean;
 }
-/** Requests controller-owned inline text editing for an element in this frame. */
 export interface InlineTextIntentMessage extends RendererMessage {
     type: "inline-text-intent";
     intent: "pointer-down" | "double-click";
@@ -173,7 +155,6 @@ export interface InlineTextIntentMessage extends RendererMessage {
     clickCount?: number;
     emptyProjectionId?: string;
 }
-/** Renderer request to clear the controller-owned element selection. */
 export interface ElementDeselectMessage extends RendererMessage {
     type: "element-deselect";
 }
@@ -202,7 +183,6 @@ export interface ElementDragMoveMessage extends RendererMessage {
         x: number;
         y: number;
     };
-    /** True while Shift is held; spacing drags use this to snap by 8px steps. */
     shiftKey?: boolean;
 }
 export interface ElementDragEndMessage extends RendererMessage {
@@ -211,7 +191,6 @@ export interface ElementDragEndMessage extends RendererMessage {
         x: number;
         y: number;
     };
-    /** True while Shift is held; spacing drags use this to snap by 8px steps. */
     shiftKey?: boolean;
     /** True when the renderer lost the gesture before the pointer was released. */
     cancelled?: boolean;
@@ -234,7 +213,6 @@ export interface HistoryRequestMessage extends RendererMessage {
     type: "history-request";
     action: "undo" | "redo";
 }
-/** Requests the parent-owned inspector visibility toggle from frame focus. */
 export interface InspectorToggleRequestMessage extends RendererMessage {
     type: "inspector-toggle-request";
 }
@@ -244,7 +222,6 @@ export interface InspectorOpenRequestMessage extends RendererMessage {
 }
 export type KeyboardShortcutCode = "Backslash" | "KeyI" | "KeyV" | "KeyC" | "KeyP" | "KeyS";
 export type KeyboardShortcutPhase = "keydown" | "keyup";
-/** Forwards controller-owned keyboard shortcuts from an iframe document. */
 export interface KeyboardShortcutMessage extends RendererMessage {
     type: "keyboard-shortcut";
     phase: KeyboardShortcutPhase;
@@ -284,7 +261,6 @@ export interface BoardGestureStateMessage extends RendererMessage {
     /** Ordinary wheel gestures pan the board instead of scrolling the app. */
     panScroll?: boolean;
 }
-/** Proxies modified wheel gestures that originate inside an iframe card. */
 export interface ZoomMessage extends RendererMessage {
     type: "zoom";
     deltaY: number;
@@ -293,7 +269,6 @@ export interface ZoomMessage extends RendererMessage {
         y: number;
     };
 }
-/** Proxies ordinary wheel gestures as normalized pixel distances. */
 export interface WheelPanMessage extends RendererMessage {
     type: "wheel-pan";
     deltaX: number;
@@ -304,7 +279,6 @@ export interface AppInteractionModifierMessage extends RendererMessage {
     type: "app-interaction-modifier";
     held: boolean;
 }
-/** Tells a renderer whether the inspector is open and which cursor its gestures show. */
 export interface InspectorInteractionStateMessage extends RendererMessage {
     type: "inspector-interaction-state";
     open: boolean;
@@ -313,9 +287,7 @@ export interface InspectorInteractionStateMessage extends RendererMessage {
     /** CSS cursor for the Comment tool; the controller renders it. */
     commentCursor?: string;
 }
-/** Messages a renderer sends to the controller. */
 export type RendererToControllerMessage = RendererHelloMessage | FrameReadyMessage | FrameRuntimeMessage | FrameMetadataMessage | FrameLoadError | ProjectionAppliedMessage | StructuralProjectionReportMessage | RenderedInstanceProjectionReportMessage | TextProjectionReportMessage | NavigationIntentMessage | ElementHoverMessage | ElementMeasureStateMessage | ElementClickMessage | InlineTextIntentMessage | ElementDeselectMessage | ElementDragStartMessage | ElementDragMoveMessage | ElementDragEndMessage | ElementDeleteMessage | ElementNudgeMessage | HistoryRequestMessage | InspectorToggleRequestMessage | InspectorOpenRequestMessage | KeyboardShortcutMessage | PanStartMessage | PanMoveMessage | PanEndMessage | PanModifierMessage | ZoomMessage | WheelPanMessage | AppInteractionModifierMessage;
-/** Messages the controller sends to a renderer. */
 export type ControllerToRendererMessage = ParentReadyMessage | ReplaceStylesMessage | LinkTargetStateMessage | PanModifierMessage | MeasureModifierMessage | BoardGestureStateMessage | InspectorInteractionStateMessage;
 export declare function isRendererMessageType(type: unknown): type is RendererToControllerMessage["type"];
 export type FrameProtocolMessage = ParentReadyMessage | RendererHelloMessage | FrameReadyMessage | FrameRuntimeMessage | FrameMetadataMessage | FrameLoadError | ReplaceStylesMessage | ProjectionAppliedMessage | StructuralProjectionReportMessage | RenderedInstanceProjectionReportMessage | TextProjectionReportMessage | NavigationIntentMessage | LinkTargetStateMessage | ElementHoverMessage | ElementMeasureStateMessage | ElementClickMessage | InlineTextIntentMessage | ElementDeselectMessage | ElementDragStartMessage | ElementDragMoveMessage | ElementDragEndMessage | ElementDeleteMessage | ElementNudgeMessage | HistoryRequestMessage | InspectorToggleRequestMessage | InspectorOpenRequestMessage | KeyboardShortcutMessage | PanStartMessage | PanMoveMessage | PanEndMessage | PanModifierMessage | MeasureModifierMessage | BoardGestureStateMessage | ZoomMessage | WheelPanMessage | AppInteractionModifierMessage | InspectorInteractionStateMessage;
@@ -324,19 +296,12 @@ export declare function clearRendererIdentity(expected?: FrameIdentity): void;
 export declare function getRendererIdentity(): FrameIdentity | null;
 export declare function isRendererMessageFor(value: unknown, identity: FrameIdentity): value is RendererMessage;
 export declare function isKeyboardShortcutCode(value: unknown): value is KeyboardShortcutCode;
-/** Strict JSON-only schema for renderer-originated global keyboard shortcuts. */
 export declare function isKeyboardShortcutMessage(value: unknown, identity: FrameIdentity): value is KeyboardShortcutMessage;
-/** Strict JSON-only schema for selecting an element from a renderer frame. */
 export declare function isElementClickMessage(value: unknown, identity: FrameIdentity): value is ElementClickMessage;
-/** Strict JSON-only schema for starting controller-owned inline text editing. */
 export declare function isInlineTextIntentMessage(value: unknown, identity: FrameIdentity): value is InlineTextIntentMessage;
-/** Strict JSON-only schema for renderer diagnostics before the parent records them. */
 export declare function isStructuralProjectionReportMessage(value: unknown, identity: FrameIdentity): value is StructuralProjectionReportMessage;
-/** Strict JSON-only schema for renderer CSS-instance diagnostics. */
 export declare function isRenderedInstanceProjectionReportMessage(value: unknown, identity: FrameIdentity): value is RenderedInstanceProjectionReportMessage;
-/** Strict JSON-only schema for renderer rendered-text diagnostics. */
 export declare function isTextProjectionReportMessage(value: unknown, identity: FrameIdentity): value is TextProjectionReportMessage;
-/** Strict JSON-only acknowledgement for a fully applied Canvas snapshot. */
 export declare function isProjectionAppliedMessage(value: unknown, identity: FrameIdentity): value is ProjectionAppliedMessage;
 export declare function isComponentOverrideList(value: unknown): value is ComponentOverride[];
 export declare function sendToParent(msg: FrameProtocolMessage): void;

package/dist/inspector/canvas/frameProtocol.js

@@ -1,23 +1,7 @@
 import { isDocumentProjectionReport } from "../projection/renderedInstance.js";
 import { isTextProjectionReport } from "../projection/textProjection.js";
 import { isStructuralProjectionReport } from "../projection/structuralProjectionBoundary.js";
-// v21 adds the Comment tool cursor and C shortcut.
-// v20 adds Shift state to element drag messages so spacing handles can snap
-// changes to 8px increments.
-// v19 adds spacing drag gestures (hover point, spacing descriptor, start
-// point, and cancelled drag-end) plus renderer-to-controller keyboard shortcut
-// forwarding for Canvas frames.
-// v18 adds parent-to-renderer Alt modifier forwarding for Canvas measurements.
-// v17 adds an idempotent renderer request to open the parent inspector. v16
-// adds controller-owned inline-text intents for Canvas frames. v15 adds
-// renderer-to-controller element deselection for Canvas frames. v14
-// adds border widths to hover geometry so containment measurements can exclude
-// the container border. v13 adds source-parent-aware structural moves and
-// bounded structural failure reasons to the full projection snapshot. v12
-// added the projection-applied acknowledgement: the controller can avoid
-// rereading a Canvas iframe until the renderer has applied its revision. v11
-// added the renderer-hello handshake solicitation for runtimes whose boot
-// completes after the controller's load-time parent-ready.
+// Bumped on every message-shape change; the controller and renderer must agree exactly.
 export const PROTOCOL_VERSION = 21;
 const RENDERER_MESSAGE_TYPES = {
     "renderer-hello": true,
@@ -82,7 +66,6 @@ export function isKeyboardShortcutCode(value) {
         || value === "KeyP"
         || value === "KeyS";
 }
-/** Strict JSON-only schema for renderer-originated global keyboard shortcuts. */
 export function isKeyboardShortcutMessage(value, identity) {
     if (!isRendererMessageFor(value, identity) || !isProtocolObject(value))
         return false;
@@ -94,7 +77,6 @@ export function isKeyboardShortcutMessage(value, identity) {
         && (ownValue(value, "phase") === "keydown" || ownValue(value, "phase") === "keyup")
         && isKeyboardShortcutCode(ownValue(value, "code"));
 }
-/** Strict JSON-only schema for selecting an element from a renderer frame. */
 export function isElementClickMessage(value, identity) {
     if (!isRendererMessageFor(value, identity) || !isProtocolObject(value))
         return false;
@@ -115,7 +97,6 @@ export function isElementClickMessage(value, identity) {
         && typeof ownValue(value, "component") === "string"
         && (additive === undefined || typeof additive === "boolean");
 }
-/** Strict JSON-only schema for starting controller-owned inline text editing. */
 export function isInlineTextIntentMessage(value, identity) {
     if (!isRendererMessageFor(value, identity) || !isProtocolObject(value))
         return false;
@@ -140,7 +121,6 @@ export function isInlineTextIntentMessage(value, identity) {
         && (clickCount === undefined || (typeof clickCount === "number" && Number.isSafeInteger(clickCount) && clickCount >= 0))
         && (emptyProjectionId === undefined || typeof emptyProjectionId === "string");
 }
-/** Strict JSON-only schema for renderer diagnostics before the parent records them. */
 export function isStructuralProjectionReportMessage(value, identity) {
     if (!isRendererMessageFor(value, identity) || !value || typeof value !== "object")
         return false;
@@ -155,7 +135,6 @@ export function isStructuralProjectionReportMessage(value, identity) {
         && Array.isArray(message.reports)
         && message.reports.every(isStructuralProjectionReport);
 }
-/** Strict JSON-only schema for renderer CSS-instance diagnostics. */
 export function isRenderedInstanceProjectionReportMessage(value, identity) {
     if (!isRendererMessageFor(value, identity) || !value || typeof value !== "object")
         return false;
@@ -170,7 +149,6 @@ export function isRenderedInstanceProjectionReportMessage(value, identity) {
         && Array.isArray(message.reports)
         && message.reports.every(isDocumentProjectionReport);
 }
-/** Strict JSON-only schema for renderer rendered-text diagnostics. */
 export function isTextProjectionReportMessage(value, identity) {
     if (!isRendererMessageFor(value, identity) || !isProtocolObject(value))
         return false;
@@ -186,7 +164,6 @@ export function isTextProjectionReportMessage(value, identity) {
         && Array.isArray(reports)
         && reports.every(isTextProjectionReport);
 }
-/** Strict JSON-only acknowledgement for a fully applied Canvas snapshot. */
 export function isProjectionAppliedMessage(value, identity) {
     if (!isRendererMessageFor(value, identity) || !isProtocolObject(value))
         return false;

package/dist/inspector/canvas/frameScrollbarStyles.d.ts

@@ -1,3 +1,2 @@
 export declare const FRAME_SCROLLBAR_STYLE_ID = "nudge-ui-frame-scrollbar-styles";
-/** Gives frame documents thin scrollbars over a transparent track by default. */
 export declare function installFrameScrollbarStyles(doc: Document): () => void;

package/dist/inspector/canvas/frameScrollbarStyles.js

@@ -9,7 +9,6 @@ const FRAME_SCROLLBAR_CSS = `
     scrollbar-width: thin;
   }
 `;
-/** Gives frame documents thin scrollbars over a transparent track by default. */
 export function installFrameScrollbarStyles(doc) {
     if (!doc.head || doc.getElementById(FRAME_SCROLLBAR_STYLE_ID))
         return () => undefined;