@ai-matrx/canvas 0.1.1 → 0.2.1

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { C as CanvasItemId, a as CanvasJson, b as CanvasLayoutNode, c as CanvasPaneId, d as CanvasState, e as CanvasItem, f as CanvasPane } from './controller-oY84BN2c.cjs';
-export { g as CANVAS_DEFAULT_WIDTH, h as CANVAS_MIN_SPLIT_FRACTION, i as CANVAS_MIN_WIDTH, j as CANVAS_STORAGE_KEY, k as CanvasAction, l as CanvasController, m as CanvasControllerOptions, n as CanvasErrorReport, o as CanvasErrorSink, p as CanvasOpenInput, q as CanvasOpenTarget, r as CanvasOrientation, s as CanvasPersistencePort, t as CanvasSplitId, u as CanvasStoreBinding, R as ReduxStoreLike, v as bindCanvasToReduxStore, w as canvasActions, x as canvasReducer, y as consoleCanvasErrorSink, z as createCanvasController, A as createCanvasStore, B as createInitialCanvasState, D as createLocalStorageCanvasPersistence, E as isCanvasAction, F as sanitizeCanvasSnapshot, G as toPersistableSnapshot } from './controller-oY84BN2c.cjs';
+import { C as CanvasItemId, a as CanvasWindowId, b as CanvasJson, c as CanvasLayoutNode, d as CanvasPaneId, e as CanvasStoreBinding, f as CanvasState, g as CanvasAction, h as CanvasController, i as CanvasItem, j as CanvasExtraWindow, k as CanvasPane, l as canvasWindowOfItem } from './controller-Dv6J6XZm.cjs';
+export { m as CANVAS_DEFAULT_WIDTH, n as CANVAS_DESKTOP_LAYOUT_RULES, o as CANVAS_MAIN_WINDOW, p as CANVAS_MIN_SPLIT_FRACTION, q as CANVAS_MIN_WIDTH, r as CANVAS_STORAGE_KEY, s as CANVAS_WEB_LAYOUT_RULES, t as CanvasControllerOptions, u as CanvasErrorReport, v as CanvasErrorSink, w as CanvasKeyValueStore, x as CanvasLayoutRules, y as CanvasOpenInput, z as CanvasOpenTarget, A as CanvasOrientation, B as CanvasPersistencePort, D as CanvasRect, E as CanvasSessionAttachReason, F as CanvasSessionDetachReason, G as CanvasSessionEvent, H as CanvasSessionHooks, I as CanvasSplitId, J as CanvasWindowCloseMode, K as CanvasWindowFrame, L as CanvasWindowPorts, R as ReduxStoreLike, M as bindCanvasToReduxStore, N as canvasActions, O as canvasReducer, P as canvasWindowFrame, Q as canvasWindowOfPane, S as clampDraggedCanvasWidth, T as consoleCanvasErrorSink, U as createCanvasController, V as createCanvasStore, W as createInitialCanvasState, X as createKeyValueCanvasPersistence, Y as createLocalStorageCanvasPersistence, Z as defaultCanvasWidth, _ as fitCanvasWidth, $ as foldCanvasWindows, a0 as isCanvasAction, a1 as listCanvasWindowIds, a2 as resolveCanvasLayoutRules, a3 as sanitizeCanvasSnapshot, a4 as shouldStackSplit, a5 as toPersistableSnapshot } from './controller-Dv6J6XZm.cjs';
 
 declare function canvasItemId(kind: string, key: string): CanvasItemId;
 declare function parseCanvasItemId(id: CanvasItemId): {
@@ -13,6 +13,8 @@ declare function parseCanvasItemId(id: CanvasItemId): {
  */
 declare function findNonJson(value: unknown, path?: string): string | null;
 declare function isCanvasJson(value: unknown): value is CanvasJson;
+/** Brands a host's window id. `CANVAS_MAIN_WINDOW` is the default window. */
+declare function canvasWindowId(id: string): CanvasWindowId;
 
 /**
  * Pure helpers over the canvas layout tree. Every function returns a new tree
@@ -23,17 +25,122 @@ declare function listPaneIds(node: CanvasLayoutNode): CanvasPaneId[];
 /** Renormalizes to sum 1; falls back to even sizes for garbage input. */
 declare function normalizeSizes(sizes: readonly number[], count: number): number[];
 
-declare const selectCanvasIsOpen: (s: CanvasState) => boolean;
-declare const selectCanvasIsFullscreen: (s: CanvasState) => boolean;
-declare const selectCanvasWidth: (s: CanvasState) => number;
-declare const selectCanvasLayout: (s: CanvasState) => CanvasLayoutNode;
-declare const selectCanvasFocusedPaneId: (s: CanvasState) => CanvasPaneId;
+/**
+ * A canvas store that lives in ANOTHER process — an Electron renderer bound to
+ * the one store in the main process over IPC.
+ *
+ *  - dispatch is async and fire-and-forget: the action goes to the owner, and
+ *    the state changes when the owner's next snapshot arrives (no optimistic
+ *    copy that could disagree with the owner);
+ *  - every update is a WHOLE snapshot with no shared object identity, so each
+ *    one is merged into the previous state structurally: anything unchanged
+ *    keeps its old reference, an identical snapshot changes nothing and wakes
+ *    nobody — selector results stay stable and useSyncExternalStore never loops;
+ *  - the binding is marked `authority: "remote"`: the owner hydrates and saves,
+ *    so a controller over it never does.
+ *
+ * The owner side (main process) is the ordinary `createCanvasStore()` +
+ * `createCanvasController({ persistence })`; see the README.
+ */
+
+interface RemoteCanvasStoreOptions {
+    /** The owner's state at connect time (e.g. from an `invoke("canvas:get")`). */
+    readonly initialSnapshot: CanvasState;
+    /** Sends one action to the owner. A rejection is reported, never swallowed. */
+    readonly dispatch: (action: CanvasAction) => Promise<void> | void;
+    /** Delivers every new owner snapshot; returns the unsubscribe. */
+    readonly subscribe: (onSnapshot: (snapshot: CanvasState) => void) => () => void;
+    /** Where a failed dispatch is reported. Default: console.error. */
+    readonly onError?: ((error: unknown, action: CanvasAction) => void) | undefined;
+}
+interface RemoteCanvasStore extends CanvasStoreBinding {
+    /** Stops listening to the owner. */
+    dispose(): void;
+}
+declare function createRemoteCanvasStore(options: RemoteCanvasStoreOptions): RemoteCanvasStore;
+/**
+ * Returns `next`, but with every subtree that is deep-equal to the same subtree
+ * of `prev` replaced by `prev`'s object. When nothing changed it returns `prev`
+ * itself. Plain JSON only (what crosses a process boundary).
+ */
+declare function shareStructure<T>(prev: T, next: T): T;
+
+/**
+ * The canvas's keyboard shortcuts, as DATA. A web host gets them bound in the
+ * DOM by `CanvasProvider`; a desktop host binds the same table in its main
+ * process (menu accelerators / `before-input-event`), because keys pressed
+ * inside a native web view never reach the renderer's DOM. Every shortcut runs
+ * through `runCanvasCommand`, so both paths do exactly the same thing.
+ */
+
+type CanvasCommandId = "canvas.toggle" | "canvas.toggleFullscreen" | "canvas.exitFullscreen" | "canvas.closeTab" | "canvas.nextTab" | "canvas.previousTab" | "canvas.splitRight" | "canvas.splitDown";
+/**
+ * When a shortcut applies:
+ *  - "presented": a canvas column is on screen in this window;
+ *  - "fullscreen": the canvas is expanded (and Escape is not owned by a menu or dialog);
+ *  - "canvas-focus": keyboard focus is inside the canvas (a tab, a pane, a native body).
+ */
+type CanvasShortcutWhen = "presented" | "fullscreen" | "canvas-focus";
+interface CanvasShortcut {
+    readonly id: CanvasCommandId;
+    /** Electron accelerator syntax: "CmdOrCtrl+\\", "Escape", "Ctrl+Shift+Tab". */
+    readonly accelerator: string;
+    readonly when: CanvasShortcutWhen;
+    readonly label: string;
+    /** False when browsers reserve the keys (⌘W, Ctrl+Tab): only a desktop host can bind it. */
+    readonly web: boolean;
+}
+declare const CANVAS_SHORTCUTS: readonly CanvasShortcut[];
+/** The tooltip hint for a command, e.g. "⌘\\" on a Mac. */
+declare function canvasShortcutHint(id: CanvasCommandId, isMac: boolean): string | null;
+/**
+ * Runs one command against a window's canvas. Returns true when it did
+ * something (so a binding knows whether to swallow the key).
+ */
+declare function runCanvasCommand(controller: CanvasController, id: CanvasCommandId, windowId?: CanvasWindowId): boolean;
+/** The subset of a KeyboardEvent an accelerator is matched against. */
+interface CanvasKeyInput {
+    readonly key: string;
+    readonly code?: string;
+    readonly metaKey: boolean;
+    readonly ctrlKey: boolean;
+    readonly altKey: boolean;
+    readonly shiftKey: boolean;
+}
+/**
+ * Whether a key event is this accelerator. "CmdOrCtrl" is ⌘ on a Mac and Ctrl
+ * elsewhere; symbol keys match by physical key (⌥\ types « on a Mac).
+ */
+declare function matchesCanvasAccelerator(input: CanvasKeyInput, accelerator: string, isMac: boolean): boolean;
+
+/**
+ * Selectors over CanvasState. Each returns a value that is referentially
+ * stable for an unchanged state, so they are safe in useSyncExternalStore and
+ * in a host's useSelector. Window-scoped selectors default to the main window;
+ * an unknown window reads as closed and empty.
+ */
+
+declare const selectCanvasIsOpen: (s: CanvasState, windowId?: CanvasWindowId) => boolean;
+declare const selectCanvasIsFullscreen: (s: CanvasState, windowId?: CanvasWindowId) => boolean;
+/** The width the person chose, or null while the host's layout rule decides. */
+declare const selectCanvasWidth: (s: CanvasState, windowId?: CanvasWindowId) => number | null;
+declare const selectCanvasLayout: (s: CanvasState, windowId?: CanvasWindowId) => CanvasLayoutNode | null;
+declare const selectCanvasFocusedPaneId: (s: CanvasState, windowId?: CanvasWindowId) => CanvasPaneId | null;
 declare const selectCanvasIsHydrated: (s: CanvasState) => boolean;
+/** Every item on the canvas, in every window. */
 declare const selectCanvasItemCount: (s: CanvasState) => number;
 declare const selectCanvasPane: (s: CanvasState, paneId: CanvasPaneId) => CanvasPane | undefined;
 declare const selectCanvasItem: (s: CanvasState, itemId: CanvasItemId) => CanvasItem | undefined;
-declare function selectCanvasPaneCount(s: CanvasState): number;
-/** The item the person is looking at in the focused pane. */
-declare function selectCanvasActiveItem(s: CanvasState): CanvasItem | null;
+declare function selectCanvasPaneCount(s: CanvasState, windowId?: CanvasWindowId): number;
+/** Items shown in one window. */
+declare function selectCanvasWindowItemCount(s: CanvasState, windowId?: CanvasWindowId): number;
+/** The item the person is looking at in a window's focused pane. */
+declare function selectCanvasActiveItem(s: CanvasState, windowId?: CanvasWindowId): CanvasItem | null;
+/** Windows other than main (second app windows and pop-outs), by id. Stable per state. */
+declare function selectCanvasWindows(s: CanvasState): CanvasState["windows"];
+/** One extra window, or undefined (main is never in this map). */
+declare const selectCanvasExtraWindow: (s: CanvasState, windowId: CanvasWindowId) => CanvasExtraWindow | undefined;
+/** The window an item is in, or null when it is not on the canvas. */
+declare const selectCanvasWindowOfItem: typeof canvasWindowOfItem;
 
-export { CanvasItem, CanvasItemId, CanvasJson, CanvasLayoutNode, CanvasPane, CanvasPaneId, CanvasState, canvasItemId, findNonJson, isCanvasJson, listPaneIds, normalizeSizes, parseCanvasItemId, selectCanvasActiveItem, selectCanvasFocusedPaneId, selectCanvasIsFullscreen, selectCanvasIsHydrated, selectCanvasIsOpen, selectCanvasItem, selectCanvasItemCount, selectCanvasLayout, selectCanvasPane, selectCanvasPaneCount, selectCanvasWidth };
+export { CANVAS_SHORTCUTS, CanvasAction, type CanvasCommandId, CanvasController, CanvasExtraWindow, CanvasItem, CanvasItemId, CanvasJson, type CanvasKeyInput, CanvasLayoutNode, CanvasPane, CanvasPaneId, type CanvasShortcut, type CanvasShortcutWhen, CanvasState, CanvasStoreBinding, CanvasWindowId, type RemoteCanvasStore, type RemoteCanvasStoreOptions, canvasItemId, canvasShortcutHint, canvasWindowId, canvasWindowOfItem, createRemoteCanvasStore, findNonJson, isCanvasJson, listPaneIds, matchesCanvasAccelerator, normalizeSizes, parseCanvasItemId, runCanvasCommand, selectCanvasActiveItem, selectCanvasExtraWindow, selectCanvasFocusedPaneId, selectCanvasIsFullscreen, selectCanvasIsHydrated, selectCanvasIsOpen, selectCanvasItem, selectCanvasItemCount, selectCanvasLayout, selectCanvasPane, selectCanvasPaneCount, selectCanvasWidth, selectCanvasWindowItemCount, selectCanvasWindowOfItem, selectCanvasWindows, shareStructure };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CanvasItemId, a as CanvasJson, b as CanvasLayoutNode, c as CanvasPaneId, d as CanvasState, e as CanvasItem, f as CanvasPane } from './controller-oY84BN2c.js';
-export { g as CANVAS_DEFAULT_WIDTH, h as CANVAS_MIN_SPLIT_FRACTION, i as CANVAS_MIN_WIDTH, j as CANVAS_STORAGE_KEY, k as CanvasAction, l as CanvasController, m as CanvasControllerOptions, n as CanvasErrorReport, o as CanvasErrorSink, p as CanvasOpenInput, q as CanvasOpenTarget, r as CanvasOrientation, s as CanvasPersistencePort, t as CanvasSplitId, u as CanvasStoreBinding, R as ReduxStoreLike, v as bindCanvasToReduxStore, w as canvasActions, x as canvasReducer, y as consoleCanvasErrorSink, z as createCanvasController, A as createCanvasStore, B as createInitialCanvasState, D as createLocalStorageCanvasPersistence, E as isCanvasAction, F as sanitizeCanvasSnapshot, G as toPersistableSnapshot } from './controller-oY84BN2c.js';
+import { C as CanvasItemId, a as CanvasWindowId, b as CanvasJson, c as CanvasLayoutNode, d as CanvasPaneId, e as CanvasStoreBinding, f as CanvasState, g as CanvasAction, h as CanvasController, i as CanvasItem, j as CanvasExtraWindow, k as CanvasPane, l as canvasWindowOfItem } from './controller-Dv6J6XZm.js';
+export { m as CANVAS_DEFAULT_WIDTH, n as CANVAS_DESKTOP_LAYOUT_RULES, o as CANVAS_MAIN_WINDOW, p as CANVAS_MIN_SPLIT_FRACTION, q as CANVAS_MIN_WIDTH, r as CANVAS_STORAGE_KEY, s as CANVAS_WEB_LAYOUT_RULES, t as CanvasControllerOptions, u as CanvasErrorReport, v as CanvasErrorSink, w as CanvasKeyValueStore, x as CanvasLayoutRules, y as CanvasOpenInput, z as CanvasOpenTarget, A as CanvasOrientation, B as CanvasPersistencePort, D as CanvasRect, E as CanvasSessionAttachReason, F as CanvasSessionDetachReason, G as CanvasSessionEvent, H as CanvasSessionHooks, I as CanvasSplitId, J as CanvasWindowCloseMode, K as CanvasWindowFrame, L as CanvasWindowPorts, R as ReduxStoreLike, M as bindCanvasToReduxStore, N as canvasActions, O as canvasReducer, P as canvasWindowFrame, Q as canvasWindowOfPane, S as clampDraggedCanvasWidth, T as consoleCanvasErrorSink, U as createCanvasController, V as createCanvasStore, W as createInitialCanvasState, X as createKeyValueCanvasPersistence, Y as createLocalStorageCanvasPersistence, Z as defaultCanvasWidth, _ as fitCanvasWidth, $ as foldCanvasWindows, a0 as isCanvasAction, a1 as listCanvasWindowIds, a2 as resolveCanvasLayoutRules, a3 as sanitizeCanvasSnapshot, a4 as shouldStackSplit, a5 as toPersistableSnapshot } from './controller-Dv6J6XZm.js';
 
 declare function canvasItemId(kind: string, key: string): CanvasItemId;
 declare function parseCanvasItemId(id: CanvasItemId): {
@@ -13,6 +13,8 @@ declare function parseCanvasItemId(id: CanvasItemId): {
  */
 declare function findNonJson(value: unknown, path?: string): string | null;
 declare function isCanvasJson(value: unknown): value is CanvasJson;
+/** Brands a host's window id. `CANVAS_MAIN_WINDOW` is the default window. */
+declare function canvasWindowId(id: string): CanvasWindowId;
 
 /**
  * Pure helpers over the canvas layout tree. Every function returns a new tree
@@ -23,17 +25,122 @@ declare function listPaneIds(node: CanvasLayoutNode): CanvasPaneId[];
 /** Renormalizes to sum 1; falls back to even sizes for garbage input. */
 declare function normalizeSizes(sizes: readonly number[], count: number): number[];
 
-declare const selectCanvasIsOpen: (s: CanvasState) => boolean;
-declare const selectCanvasIsFullscreen: (s: CanvasState) => boolean;
-declare const selectCanvasWidth: (s: CanvasState) => number;
-declare const selectCanvasLayout: (s: CanvasState) => CanvasLayoutNode;
-declare const selectCanvasFocusedPaneId: (s: CanvasState) => CanvasPaneId;
+/**
+ * A canvas store that lives in ANOTHER process — an Electron renderer bound to
+ * the one store in the main process over IPC.
+ *
+ *  - dispatch is async and fire-and-forget: the action goes to the owner, and
+ *    the state changes when the owner's next snapshot arrives (no optimistic
+ *    copy that could disagree with the owner);
+ *  - every update is a WHOLE snapshot with no shared object identity, so each
+ *    one is merged into the previous state structurally: anything unchanged
+ *    keeps its old reference, an identical snapshot changes nothing and wakes
+ *    nobody — selector results stay stable and useSyncExternalStore never loops;
+ *  - the binding is marked `authority: "remote"`: the owner hydrates and saves,
+ *    so a controller over it never does.
+ *
+ * The owner side (main process) is the ordinary `createCanvasStore()` +
+ * `createCanvasController({ persistence })`; see the README.
+ */
+
+interface RemoteCanvasStoreOptions {
+    /** The owner's state at connect time (e.g. from an `invoke("canvas:get")`). */
+    readonly initialSnapshot: CanvasState;
+    /** Sends one action to the owner. A rejection is reported, never swallowed. */
+    readonly dispatch: (action: CanvasAction) => Promise<void> | void;
+    /** Delivers every new owner snapshot; returns the unsubscribe. */
+    readonly subscribe: (onSnapshot: (snapshot: CanvasState) => void) => () => void;
+    /** Where a failed dispatch is reported. Default: console.error. */
+    readonly onError?: ((error: unknown, action: CanvasAction) => void) | undefined;
+}
+interface RemoteCanvasStore extends CanvasStoreBinding {
+    /** Stops listening to the owner. */
+    dispose(): void;
+}
+declare function createRemoteCanvasStore(options: RemoteCanvasStoreOptions): RemoteCanvasStore;
+/**
+ * Returns `next`, but with every subtree that is deep-equal to the same subtree
+ * of `prev` replaced by `prev`'s object. When nothing changed it returns `prev`
+ * itself. Plain JSON only (what crosses a process boundary).
+ */
+declare function shareStructure<T>(prev: T, next: T): T;
+
+/**
+ * The canvas's keyboard shortcuts, as DATA. A web host gets them bound in the
+ * DOM by `CanvasProvider`; a desktop host binds the same table in its main
+ * process (menu accelerators / `before-input-event`), because keys pressed
+ * inside a native web view never reach the renderer's DOM. Every shortcut runs
+ * through `runCanvasCommand`, so both paths do exactly the same thing.
+ */
+
+type CanvasCommandId = "canvas.toggle" | "canvas.toggleFullscreen" | "canvas.exitFullscreen" | "canvas.closeTab" | "canvas.nextTab" | "canvas.previousTab" | "canvas.splitRight" | "canvas.splitDown";
+/**
+ * When a shortcut applies:
+ *  - "presented": a canvas column is on screen in this window;
+ *  - "fullscreen": the canvas is expanded (and Escape is not owned by a menu or dialog);
+ *  - "canvas-focus": keyboard focus is inside the canvas (a tab, a pane, a native body).
+ */
+type CanvasShortcutWhen = "presented" | "fullscreen" | "canvas-focus";
+interface CanvasShortcut {
+    readonly id: CanvasCommandId;
+    /** Electron accelerator syntax: "CmdOrCtrl+\\", "Escape", "Ctrl+Shift+Tab". */
+    readonly accelerator: string;
+    readonly when: CanvasShortcutWhen;
+    readonly label: string;
+    /** False when browsers reserve the keys (⌘W, Ctrl+Tab): only a desktop host can bind it. */
+    readonly web: boolean;
+}
+declare const CANVAS_SHORTCUTS: readonly CanvasShortcut[];
+/** The tooltip hint for a command, e.g. "⌘\\" on a Mac. */
+declare function canvasShortcutHint(id: CanvasCommandId, isMac: boolean): string | null;
+/**
+ * Runs one command against a window's canvas. Returns true when it did
+ * something (so a binding knows whether to swallow the key).
+ */
+declare function runCanvasCommand(controller: CanvasController, id: CanvasCommandId, windowId?: CanvasWindowId): boolean;
+/** The subset of a KeyboardEvent an accelerator is matched against. */
+interface CanvasKeyInput {
+    readonly key: string;
+    readonly code?: string;
+    readonly metaKey: boolean;
+    readonly ctrlKey: boolean;
+    readonly altKey: boolean;
+    readonly shiftKey: boolean;
+}
+/**
+ * Whether a key event is this accelerator. "CmdOrCtrl" is ⌘ on a Mac and Ctrl
+ * elsewhere; symbol keys match by physical key (⌥\ types « on a Mac).
+ */
+declare function matchesCanvasAccelerator(input: CanvasKeyInput, accelerator: string, isMac: boolean): boolean;
+
+/**
+ * Selectors over CanvasState. Each returns a value that is referentially
+ * stable for an unchanged state, so they are safe in useSyncExternalStore and
+ * in a host's useSelector. Window-scoped selectors default to the main window;
+ * an unknown window reads as closed and empty.
+ */
+
+declare const selectCanvasIsOpen: (s: CanvasState, windowId?: CanvasWindowId) => boolean;
+declare const selectCanvasIsFullscreen: (s: CanvasState, windowId?: CanvasWindowId) => boolean;
+/** The width the person chose, or null while the host's layout rule decides. */
+declare const selectCanvasWidth: (s: CanvasState, windowId?: CanvasWindowId) => number | null;
+declare const selectCanvasLayout: (s: CanvasState, windowId?: CanvasWindowId) => CanvasLayoutNode | null;
+declare const selectCanvasFocusedPaneId: (s: CanvasState, windowId?: CanvasWindowId) => CanvasPaneId | null;
 declare const selectCanvasIsHydrated: (s: CanvasState) => boolean;
+/** Every item on the canvas, in every window. */
 declare const selectCanvasItemCount: (s: CanvasState) => number;
 declare const selectCanvasPane: (s: CanvasState, paneId: CanvasPaneId) => CanvasPane | undefined;
 declare const selectCanvasItem: (s: CanvasState, itemId: CanvasItemId) => CanvasItem | undefined;
-declare function selectCanvasPaneCount(s: CanvasState): number;
-/** The item the person is looking at in the focused pane. */
-declare function selectCanvasActiveItem(s: CanvasState): CanvasItem | null;
+declare function selectCanvasPaneCount(s: CanvasState, windowId?: CanvasWindowId): number;
+/** Items shown in one window. */
+declare function selectCanvasWindowItemCount(s: CanvasState, windowId?: CanvasWindowId): number;
+/** The item the person is looking at in a window's focused pane. */
+declare function selectCanvasActiveItem(s: CanvasState, windowId?: CanvasWindowId): CanvasItem | null;
+/** Windows other than main (second app windows and pop-outs), by id. Stable per state. */
+declare function selectCanvasWindows(s: CanvasState): CanvasState["windows"];
+/** One extra window, or undefined (main is never in this map). */
+declare const selectCanvasExtraWindow: (s: CanvasState, windowId: CanvasWindowId) => CanvasExtraWindow | undefined;
+/** The window an item is in, or null when it is not on the canvas. */
+declare const selectCanvasWindowOfItem: typeof canvasWindowOfItem;
 
-export { CanvasItem, CanvasItemId, CanvasJson, CanvasLayoutNode, CanvasPane, CanvasPaneId, CanvasState, canvasItemId, findNonJson, isCanvasJson, listPaneIds, normalizeSizes, parseCanvasItemId, selectCanvasActiveItem, selectCanvasFocusedPaneId, selectCanvasIsFullscreen, selectCanvasIsHydrated, selectCanvasIsOpen, selectCanvasItem, selectCanvasItemCount, selectCanvasLayout, selectCanvasPane, selectCanvasPaneCount, selectCanvasWidth };
+export { CANVAS_SHORTCUTS, CanvasAction, type CanvasCommandId, CanvasController, CanvasExtraWindow, CanvasItem, CanvasItemId, CanvasJson, type CanvasKeyInput, CanvasLayoutNode, CanvasPane, CanvasPaneId, type CanvasShortcut, type CanvasShortcutWhen, CanvasState, CanvasStoreBinding, CanvasWindowId, type RemoteCanvasStore, type RemoteCanvasStoreOptions, canvasItemId, canvasShortcutHint, canvasWindowId, canvasWindowOfItem, createRemoteCanvasStore, findNonJson, isCanvasJson, listPaneIds, matchesCanvasAccelerator, normalizeSizes, parseCanvasItemId, runCanvasCommand, selectCanvasActiveItem, selectCanvasExtraWindow, selectCanvasFocusedPaneId, selectCanvasIsFullscreen, selectCanvasIsHydrated, selectCanvasIsOpen, selectCanvasItem, selectCanvasItemCount, selectCanvasLayout, selectCanvasPane, selectCanvasPaneCount, selectCanvasWidth, selectCanvasWindowItemCount, selectCanvasWindowOfItem, selectCanvasWindows, shareStructure };