nudge-ui 0.2.0 → 0.2.2

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

@@ -0,0 +1,5 @@
+/** Resolves only the selected or focused frame. */
+export declare function resolveActiveCanvasFrame(frames: ReadonlyMap<string, HTMLIFrameElement>, selectedCardId: string | null, focusedCardId: string | null): HTMLIFrameElement | null;
+export declare function getActiveCanvasDocument(): Document | null;
+/** Returns the iframe that owns the active renderer document. */
+export declare function getActiveCanvasFrame(): HTMLIFrameElement | null;

package/dist/inspector/canvas/activeCanvasDocument.js

@@ -0,0 +1,23 @@
+import { getFocusedCardId, getSelectedCardId } from "./canvasStore.js";
+import { getRegisteredFrames } from "./projection.js";
+/** Resolves only the selected or focused frame. */
+export function resolveActiveCanvasFrame(frames, selectedCardId, focusedCardId) {
+    const activeCardId = selectedCardId ?? focusedCardId;
+    return activeCardId ? frames.get(activeCardId) ?? null : null;
+}
+export function getActiveCanvasDocument() {
+    const frame = getActiveCanvasFrame();
+    if (!frame)
+        return null;
+    try {
+        return frame.contentDocument;
+    }
+    catch {
+        // Cross-origin frames cannot supply trusted document data.
+        return null;
+    }
+}
+/** Returns the iframe that owns the active renderer document. */
+export function getActiveCanvasFrame() {
+    return resolveActiveCanvasFrame(getRegisteredFrames(), getSelectedCardId(), getFocusedCardId());
+}

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

@@ -0,0 +1,30 @@
+export declare const MIN_CARD_WIDTH = 200;
+export declare const MIN_CARD_HEIGHT = 150;
+export type CanvasResizeDirection = "top-left" | "top" | "top-right" | "right" | "bottom-right" | "bottom" | "bottom-left" | "left";
+export interface CanvasResizeRect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export interface CanvasResizeDelta {
+    readonly x: number;
+    readonly y: number;
+}
+export interface CanvasResizeMinimum {
+    readonly width: number;
+    readonly height: number;
+}
+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.
+ */
+export declare function resizeCanvasRect(rect: CanvasResizeRect, direction: CanvasResizeDirection, delta: CanvasResizeDelta, minimum?: CanvasResizeMinimum): CanvasResizeRect;
+export {};

package/dist/inspector/canvas/canvasResize.js

@@ -0,0 +1,52 @@
+export const MIN_CARD_WIDTH = 200;
+export const MIN_CARD_HEIGHT = 150;
+const RESIZE_EDGES = {
+    "top-left": { horizontal: "left", vertical: "top" },
+    top: { horizontal: null, vertical: "top" },
+    "top-right": { horizontal: "right", vertical: "top" },
+    right: { horizontal: "right", vertical: null },
+    "bottom-right": { horizontal: "right", vertical: "bottom" },
+    bottom: { horizontal: null, vertical: "bottom" },
+    "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.
+ */
+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);
+    const minHeight = Math.max(0, minimum.height);
+    const initialWidth = Math.max(rect.width, minWidth);
+    const initialHeight = Math.max(rect.height, minHeight);
+    const initialRight = rect.x + initialWidth;
+    const initialBottom = rect.y + initialHeight;
+    let left = rect.x;
+    let right = initialRight;
+    let top = rect.y;
+    let bottom = initialBottom;
+    if (edges.horizontal === "left") {
+        left = Math.min(initialRight - minWidth, rect.x + delta.x);
+    }
+    else if (edges.horizontal === "right") {
+        right = Math.max(rect.x + minWidth, initialRight + delta.x);
+    }
+    if (edges.vertical === "top") {
+        top = Math.min(initialBottom - minHeight, rect.y + delta.y);
+    }
+    else if (edges.vertical === "bottom") {
+        bottom = Math.max(rect.y + minHeight, initialBottom + delta.y);
+    }
+    return {
+        x: left,
+        y: top,
+        width: right - left,
+        height: bottom - top,
+    };
+}

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

@@ -1,8 +1,11 @@
 import { type NormalizedUrl } from "./normalizeUrl.js";
 export type CanvasMode = "inspect" | "canvas";
+export type CanvasPresentation = "focus" | "canvas";
 export interface CanvasCard {
     id: string;
     url: string;
+    /** A controller-requested document load. Renderer metadata must not set this. */
+    navigationUrl?: string;
     title: string | null;
     x: number;
     y: number;
@@ -36,15 +39,23 @@ export declare const MIN_CAMERA_ZOOM = 0.25;
 export declare const MAX_CAMERA_ZOOM = 3;
 export declare const CARD_GAP = 40;
 export declare const FIT_ALL_PADDING = 80;
+export declare const PRIMARY_CARD_INSET = 40;
 declare function subscribe(cb: () => void): () => void;
 declare function getMode(): CanvasMode;
 declare function getCards(): CanvasCard[];
 declare function getComparisonGroups(): CanvasComparisonGroup[];
 export declare function setCanvasMode(newMode: CanvasMode): void;
-export declare function enterCanvas(): void;
-export declare function exitCanvas(): void;
-/** Return to inspect mode on a canvas card's route. */
-export declare function exitCanvasToCard(card: CanvasCard): void;
+/**
+ * Changes how the mounted iframe workspace is presented.
+ *
+ * Canvas starts from the active card centered in the supplied viewport. Card
+ * geometry remains durable, but the camera does not carry over from a prior
+ * Canvas session.
+ */
+export declare function setCanvasPresentation(next: CanvasPresentation, viewport?: {
+    width: number;
+    height: number;
+}): void;
 /** Adds one card while retaining the existing placement policy. */
 export declare function addCanvasCard(url: string, title?: string): CanvasCard;
 /**
@@ -68,10 +79,21 @@ export declare function removeCanvasComparisonGroup(id: string): CanvasCompariso
 /** Clears group metadata while leaving ordinary cards intact. */
 export declare function clearCanvasComparisonGroups(): void;
 export declare function removeCanvasCard(id: string): void;
+/**
+ * Opens one editor target in the iframe workspace without replacing restored
+ * cards or their dimensions.
+ */
+export declare function activateIframeWorkspace(url: string, viewport: {
+    width: number;
+    height: number;
+}): CanvasCard | null;
 export declare function updateCardTitle(id: string, title: string): void;
 export declare function updateCardUrl(id: string, url: string): void;
 export declare function duplicateCard(sourceId: string): CanvasCard | null;
-export declare function resizeCard(id: string, width: number, height: number): void;
+export declare function resizeCard(id: string, width: number, height: number, position?: {
+    readonly x: number;
+    readonly y: number;
+}): void;
 export declare function getBoardCamera(): CanvasCamera;
 export declare function setBoardCamera(camera: CanvasCamera): void;
 export declare function updateBoardCamera(partial: Partial<CanvasCamera>): void;
@@ -100,9 +122,11 @@ 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;
-export declare function hydrateCanvasStore(newMode: CanvasMode, newCards: CanvasCard[], newCamera: CanvasCamera, newComparisonGroups?: CanvasComparisonGroup[]): void;
+export declare function hydrateCanvasStore(newMode: CanvasMode, newCards: CanvasCard[], newCamera: CanvasCamera, newComparisonGroups?: CanvasComparisonGroup[], restoredFocusedCardId?: string | null): void;
 export { subscribe, getMode, getCards, getComparisonGroups, getMode as getCanvasMode, getCards as getCanvasCards, getComparisonGroups as getCanvasComparisonGroups, };
 export declare function useCanvasMode(): CanvasMode;
+export declare function useCanvasPresentation(): CanvasPresentation;
+export declare function useCanvasPresentationTransitioning(): boolean;
 export declare function useCanvasCards(): CanvasCard[];
 export declare function useCanvasComparisonGroups(): CanvasComparisonGroup[];
 export declare function useBoardCamera(): CanvasCamera;

package/dist/inspector/canvas/canvasStore.js

@@ -4,6 +4,7 @@ export const MIN_CAMERA_ZOOM = 0.25;
 export const MAX_CAMERA_ZOOM = 3;
 export const CARD_GAP = 40;
 export const FIT_ALL_PADDING = 80;
+export const PRIMARY_CARD_INSET = 40;
 const DEFAULT_CAMERA = { x: 0, y: 0, zoom: 1 };
 function defaultViewportSize() {
     return {
@@ -12,6 +13,9 @@ function defaultViewportSize() {
     };
 }
 let mode = "inspect";
+let presentation = "focus";
+let presentationTransitioning = false;
+let presentationTransitionTimer = null;
 let cards = [];
 let comparisonGroups = [];
 let focusedCardId = null;
@@ -30,6 +34,12 @@ function subscribe(cb) {
 function getMode() {
     return mode;
 }
+function getPresentation() {
+    return presentation;
+}
+function getPresentationTransitioning() {
+    return presentationTransitioning;
+}
 function getCards() {
     return cards;
 }
@@ -70,53 +80,45 @@ export function setCanvasMode(newMode) {
     mode = newMode;
     notify();
 }
-export function enterCanvas() {
-    if (mode === "canvas")
+/**
+ * Changes how the mounted iframe workspace is presented.
+ *
+ * Canvas starts from the active card centered in the supplied viewport. Card
+ * geometry remains durable, but the camera does not carry over from a prior
+ * Canvas session.
+ */
+export function setCanvasPresentation(next, viewport) {
+    if (presentation === next)
         return;
-    mode = "canvas";
-    if (cards.length === 0) {
-        const size = lastUsedCardSize ?? defaultViewportSize();
-        const card = {
-            id: `card-${++cardIdCounter}`,
-            url: window.location.href,
-            title: document.title,
-            x: 0,
-            y: 0,
-            width: size.width,
-            height: size.height,
-        };
-        cards = [card];
-        lastUsedCardSize = { width: size.width, height: size.height };
-        cachedBoardCamera = { ...DEFAULT_CAMERA };
-        fitAllRan = false;
-    }
-    else {
-        const currentRoute = normalizeUrl(window.location.href);
-        const existing = currentRoute ? findCardByNormalizedUrl(currentRoute) : undefined;
-        if (existing) {
-            focusCard(existing.id);
-        }
-        else {
-            const added = addCanvasCard(window.location.href, document.title);
-            focusCard(added.id);
-            fitAllRan = false;
-        }
-    }
+    if (next === "canvas")
+        resetCameraToActiveCard(viewport);
+    presentation = next;
+    presentationTransitioning = !window.matchMedia?.("(prefers-reduced-motion: reduce)").matches;
+    if (presentationTransitionTimer !== null)
+        window.clearTimeout(presentationTransitionTimer);
+    presentationTransitionTimer = presentationTransitioning
+        ? window.setTimeout(() => {
+            presentationTransitionTimer = null;
+            presentationTransitioning = false;
+            notify();
+        }, 220)
+        : null;
     notify();
 }
-export function exitCanvas() {
-    if (mode === "inspect")
+function resetCameraToActiveCard(viewport) {
+    const activeCardId = selectedCardId ?? focusedCardId;
+    const activeCard = cards.find((card) => card.id === activeCardId) ?? cards[0];
+    if (!activeCard) {
+        cachedBoardCamera = { ...DEFAULT_CAMERA };
         return;
-    mode = "inspect";
-    notify();
-}
-/** Return to inspect mode on a canvas card's route. */
-export function exitCanvasToCard(card) {
-    exitCanvas();
-    resetFitAllFlag();
-    if (card.url !== window.location.href) {
-        window.location.href = card.url;
     }
+    const zoom = 0.9;
+    const view = viewport ?? defaultViewportSize();
+    cachedBoardCamera = {
+        x: view.width / 2 - (activeCard.x + activeCard.width / 2) * zoom,
+        y: view.height / 2 - (activeCard.y + activeCard.height / 2) * zoom,
+        zoom,
+    };
 }
 /** Adds one card while retaining the existing placement policy. */
 export function addCanvasCard(url, title) {
@@ -189,15 +191,17 @@ export function removeCanvasComparisonGroup(id) {
     const groupCardIds = new Set(group.cardIds);
     cards = cards.filter((card) => !groupCardIds.has(card.id));
     comparisonGroups = comparisonGroups.filter((candidate) => candidate.id !== id);
-    if (groupCardIds.has(selectedCardId ?? ""))
-        selectedCardId = null;
-    if (groupCardIds.has(focusedCardId ?? ""))
-        focusedCardId = null;
-    if (cards.length === 0 && mode === "canvas")
-        mode = "inspect";
+    selectFallbackAfterRemoval(groupCardIds);
     notify();
     return group;
 }
+function selectFallbackAfterRemoval(removedIds) {
+    const fallbackId = cards[0]?.id ?? null;
+    if (removedIds.has(selectedCardId ?? ""))
+        selectedCardId = fallbackId;
+    if (removedIds.has(focusedCardId ?? ""))
+        focusedCardId = fallbackId;
+}
 /** Clears group metadata while leaving ordinary cards intact. */
 export function clearCanvasComparisonGroups() {
     if (comparisonGroups.length === 0 && !cards.some((card) => card.comparisonGroupId))
@@ -223,13 +227,10 @@ function updateComparisonGroupRoutes(groupId, cardId, patchGroup) {
 }
 export function removeCanvasCard(id) {
     const removed = cards.find((card) => card.id === id);
+    if (!removed)
+        return;
     cards = cards.filter((c) => c.id !== id);
-    if (selectedCardId === id) {
-        selectedCardId = null;
-    }
-    if (focusedCardId === id) {
-        focusedCardId = null;
-    }
+    selectFallbackAfterRemoval(new Set([id]));
     if (removed?.comparisonGroupId) {
         updateComparisonGroupRoutes(removed.comparisonGroupId, id, (group, routeIndex) => ({
             ...group,
@@ -238,11 +239,62 @@ export function removeCanvasCard(id) {
         }));
         comparisonGroups = comparisonGroups.filter((group) => group.cardIds.length > 0);
     }
-    if (cards.length === 0 && mode === "canvas") {
-        mode = "inspect";
-    }
     notify();
 }
+/**
+ * Opens one editor target in the iframe workspace without replacing restored
+ * cards or their dimensions.
+ */
+export function activateIframeWorkspace(url, viewport) {
+    const normalized = normalizeUrl(url);
+    if (!normalized || normalized.origin !== window.location.origin)
+        return null;
+    const targetHref = new URL(url).href;
+    mode = "canvas";
+    const focused = cards.find((card) => card.id === focusedCardId);
+    const focusedUrl = focused ? normalizeUrl(focused.url) : null;
+    const existing = focused && focusedUrl
+        && normalizedUrlKey(focusedUrl) === normalizedUrlKey(normalized)
+        ? focused
+        : cards.find((card) => card.url === targetHref) ?? findCardByNormalizedUrl(normalized);
+    if (existing) {
+        let activated = existing;
+        if (existing.url !== targetHref) {
+            activated = { ...existing, url: targetHref, navigationUrl: targetHref };
+            cards = cards.map((card) => card.id === existing.id ? activated : card);
+        }
+        focusedCardId = existing.id;
+        selectedCardId = existing.id;
+        notify();
+        return activated;
+    }
+    if (cards.length === 0) {
+        const width = Math.max(200, viewport.width - PRIMARY_CARD_INSET * 2);
+        const height = Math.max(150, viewport.height - PRIMARY_CARD_INSET * 2);
+        const card = {
+            id: `card-${++cardIdCounter}`,
+            url: targetHref,
+            title: null,
+            x: 0,
+            y: 0,
+            width,
+            height,
+        };
+        cards = [card];
+        lastUsedCardSize = { width, height };
+        focusedCardId = card.id;
+        selectedCardId = card.id;
+        cachedBoardCamera = { x: PRIMARY_CARD_INSET, y: PRIMARY_CARD_INSET, zoom: 1 };
+        fitAllRan = true;
+        notify();
+        return card;
+    }
+    const card = addCanvasCard(targetHref);
+    focusedCardId = card.id;
+    selectedCardId = card.id;
+    focusCanvasCards([card.id], viewport);
+    return card;
+}
 export function updateCardTitle(id, title) {
     const card = cards.find((candidate) => candidate.id === id);
     cards = cards.map((c) => (c.id === id ? { ...c, title } : c));
@@ -285,8 +337,10 @@ export function duplicateCard(sourceId) {
     notify();
     return card;
 }
-export function resizeCard(id, width, height) {
-    cards = cards.map((c) => (c.id === id ? { ...c, width, height } : c));
+export function resizeCard(id, width, height, position) {
+    cards = cards.map((c) => (c.id === id
+        ? { ...c, width, height, ...(position ? { x: position.x, y: position.y } : {}) }
+        : c));
     lastUsedCardSize = { width, height };
     notify();
 }
@@ -386,6 +440,7 @@ export function getFocusedCardId() {
     return focusedCardId;
 }
 export function selectCard(id) {
+    focusedCardId = id;
     selectedCardId = id;
     notify();
 }
@@ -406,7 +461,7 @@ export function setCardPosition(id, x, y) {
     cards = cards.map((c) => (c.id === id ? { ...c, x, y } : c));
     notify();
 }
-export function hydrateCanvasStore(newMode, newCards, newCamera, newComparisonGroups = []) {
+export function hydrateCanvasStore(newMode, newCards, newCamera, newComparisonGroups = [], restoredFocusedCardId = null) {
     mode = newMode;
     cards = newCards.map((card) => ({ ...card }));
     comparisonGroups = newComparisonGroups.map((group) => ({
@@ -415,9 +470,15 @@ export function hydrateCanvasStore(newMode, newCards, newCamera, newComparisonGr
         cardIds: [...group.cardIds],
         routes: group.routes.map((route) => ({ ...route })),
     }));
-    focusedCardId = null;
+    focusedCardId = newCards.some((card) => card.id === restoredFocusedCardId)
+        ? restoredFocusedCardId
+        : null;
     selectedCardId = null;
     cachedBoardCamera = { ...newCamera };
+    const lastCard = newCards.at(-1);
+    lastUsedCardSize = lastCard
+        ? { width: lastCard.width, height: lastCard.height }
+        : null;
     if (newCards.length > 0) {
         let maxNum = 0;
         for (const c of newCards) {
@@ -437,6 +498,12 @@ export { subscribe, getMode, getCards, getComparisonGroups, getMode as getCanvas
 export function useCanvasMode() {
     return useSyncExternalStore(subscribe, getMode, getMode);
 }
+export function useCanvasPresentation() {
+    return useSyncExternalStore(subscribe, getPresentation, getPresentation);
+}
+export function useCanvasPresentationTransitioning() {
+    return useSyncExternalStore(subscribe, getPresentationTransitioning, getPresentationTransitioning);
+}
 export function useCanvasCards() {
     return useSyncExternalStore(subscribe, getCards, getCards);
 }

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

@@ -1,6 +1,8 @@
 import type { ComponentOverride } from "../componentSemantics/types.js";
 import type { RenderedInstanceOverride } from "../changes/editModel.js";
-export declare const PROTOCOL_VERSION = 15;
+import type { NudgeUiRuntimeConfig } from "../runtime/runtimeConfig.js";
+import type { SpacingDescriptor } from "../overlay/spacingGestures.js";
+export declare const PROTOCOL_VERSION = 20;
 export interface FrameMessage {
     type: string;
     protocolVersion: number;
@@ -31,6 +33,11 @@ export interface FrameReadyMessage extends RendererMessage {
     type: "frame-ready";
     url: string;
     title: string;
+    runtime: NudgeUiRuntimeConfig;
+}
+export interface FrameRuntimeMessage extends RendererMessage {
+    type: "frame-runtime";
+    runtime: NudgeUiRuntimeConfig;
 }
 export interface FrameMetadataMessage extends RendererMessage {
     type: "frame-metadata";
@@ -86,6 +93,13 @@ export interface TextProjectionReportMessage extends RendererMessage {
 export interface NavigationIntentMessage extends RendererMessage {
     type: "navigation-intent";
     url: string;
+    /** 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;
 }
 export interface ElementHoverMessage extends RendererMessage {
     type: "element-hover";
@@ -111,6 +125,13 @@ export interface ElementHoverMessage extends RendererMessage {
         bottom: number;
         left: number;
     } | null;
+    /** Last pointer position in the renderer viewport, used for spacing guides. */
+    point?: {
+        x: number;
+        y: number;
+    } | null;
+    /** The padding or layout gap under the pointer, when one is draggable. */
+    spacing?: 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. */
@@ -131,6 +152,20 @@ 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";
+    cid: string;
+    src: string;
+    elementId: string;
+    point: {
+        x: number;
+        y: number;
+    };
+    clickCount?: number;
+    emptyProjectionId?: string;
+}
 /** Renderer request to clear the controller-owned element selection. */
 export interface ElementDeselectMessage extends RendererMessage {
     type: "element-deselect";
@@ -144,6 +179,15 @@ export interface ElementDragStartMessage extends RendererMessage {
         x: number;
         y: number;
     };
+    /** Original pointer position; the current point may already be outside the affordance. */
+    startPoint?: {
+        x: number;
+        y: number;
+    };
+    /** Spacing affordance captured at pointer-down, if this is a spacing drag. */
+    spacing?: SpacingDescriptor | null;
+    /** True while Shift is held; spacing drags use this to snap by 8px steps. */
+    shiftKey?: boolean;
 }
 export interface ElementDragMoveMessage extends RendererMessage {
     type: "element-drag-move";
@@ -151,6 +195,8 @@ 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 {
     type: "element-drag-end";
@@ -158,6 +204,10 @@ 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;
 }
 export interface ElementDeleteMessage extends RendererMessage {
     type: "element-delete";
@@ -177,9 +227,21 @@ export interface HistoryRequestMessage extends RendererMessage {
     type: "history-request";
     action: "undo" | "redo";
 }
-export interface ExternalNavigationMessage extends RendererMessage {
-    type: "external-navigation";
-    url: string;
+/** Requests the parent-owned inspector visibility toggle from frame focus. */
+export interface InspectorToggleRequestMessage extends RendererMessage {
+    type: "inspector-toggle-request";
+}
+/** Requests that the parent-owned inspector be open without toggling it closed. */
+export interface InspectorOpenRequestMessage extends RendererMessage {
+    type: "inspector-open-request";
+}
+export type KeyboardShortcutCode = "Backslash" | "KeyI" | "KeyV" | "KeyH" | "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;
+    code: KeyboardShortcutCode;
 }
 export interface PanStartMessage extends RendererMessage {
     type: "pan-start";
@@ -203,6 +265,16 @@ export interface PanModifierMessage extends RendererMessage {
     type: "pan-modifier";
     spaceHeld: boolean;
 }
+/** Keeps iframe measurement state synchronized when focus is in the parent. */
+export interface MeasureModifierMessage extends RendererMessage {
+    type: "measure-modifier";
+    altKey: boolean;
+}
+/** Enables board-only pan and zoom interception inside a mounted preview. */
+export interface BoardGestureStateMessage extends RendererMessage {
+    type: "board-gesture-state";
+    enabled: boolean;
+}
 /** Proxies modified wheel gestures that originate inside an iframe card. */
 export interface ZoomMessage extends RendererMessage {
     type: "zoom";
@@ -212,13 +284,18 @@ export interface ZoomMessage extends RendererMessage {
         y: number;
     };
 }
-export type FrameProtocolMessage = ParentReadyMessage | RendererHelloMessage | FrameReadyMessage | FrameMetadataMessage | FrameLoadError | ReplaceStylesMessage | ProjectionAppliedMessage | StructuralProjectionReportMessage | RenderedInstanceProjectionReportMessage | TextProjectionReportMessage | NavigationIntentMessage | ElementHoverMessage | ElementMeasureStateMessage | ElementClickMessage | ElementDeselectMessage | ElementDragStartMessage | ElementDragMoveMessage | ElementDragEndMessage | ElementDeleteMessage | ElementNudgeMessage | HistoryRequestMessage | ExternalNavigationMessage | PanStartMessage | PanMoveMessage | PanEndMessage | PanModifierMessage | ZoomMessage;
+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;
 export declare function setRendererIdentity(identity: FrameIdentity): void;
 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. */