@ai-matrx/canvas 0.9.2 → 0.10.0

package/dist/react.d.cts

@@ -1,6 +1,78 @@
 import * as react from 'react';
 import { ComponentType, ReactNode, CSSProperties, ButtonHTMLAttributes, HTMLAttributes, ReactElement } from 'react';
-import { b as CanvasJson, i as CanvasItem, d as CanvasPaneId, h as CanvasController, a as CanvasWindowId, Q as CanvasPresentation, V as CanvasSessionEvent, T as CanvasSessionAttachReason, U as CanvasSessionDetachReason, P as CanvasPreferredTarget, C as CanvasItemId, S as CanvasRect, e as CanvasStoreBinding, O as CanvasPersistencePort, F as CanvasErrorSink, I as CanvasLayoutRules, a0 as ToggleKindInput, H as CanvasKindVisibility, f as CanvasState } from './toggleKind-CI2nBjum.cjs';
+import { i as CanvasItem, C as CanvasItemId, b as CanvasJson, d as CanvasPaneId, h as CanvasController, a as CanvasWindowId, Q as CanvasPresentation, V as CanvasSessionEvent, T as CanvasSessionAttachReason, U as CanvasSessionDetachReason, P as CanvasPreferredTarget, S as CanvasRect, e as CanvasStoreBinding, O as CanvasPersistencePort, F as CanvasErrorSink, I as CanvasLayoutRules, a0 as ToggleKindInput, H as CanvasKindVisibility, f as CanvasState } from './toggleKind-CI2nBjum.cjs';
+
+/** What a body (or a kind) can do with its rendered output right now. */
+interface CanvasOutputHandlers {
+    /** Print exactly what is shown (a frame page asks its own page to print). Runs inside the click. */
+    readonly print?: (() => void | Promise<void>) | undefined;
+    /** Save as PDF. Absent ⇒ the print dialog's "Save as PDF" (the Print handler) when there is one. */
+    readonly savePdf?: (() => void | Promise<void>) | undefined;
+    /** A full image of the item exactly as rendered (full height, the viewer's width). */
+    readonly capture?: (() => Promise<Blob>) | undefined;
+    /** A short honest reason an entry cannot run NOW ("Publishing the page…"). Shown in the menu, disabled. */
+    readonly unavailable?: {
+        readonly print?: string | undefined;
+        readonly capture?: string | undefined;
+    } | undefined;
+}
+/** One request to the host's engines. */
+interface CanvasOutputRequest {
+    readonly item: CanvasItem;
+    readonly kind: AnyCanvasKind | undefined;
+    readonly surface: CanvasKindSurface;
+    /** The body's root element in this window (null when it is not mounted here). */
+    readonly element: HTMLElement | null;
+    /** Tab title. */
+    readonly title: string;
+}
+/**
+ * The host's print / capture / attach engines (web: `@ai-matrx/print` and DOM
+ * capture; desktop: `webContents.print` / `capturePage`). Each returns null
+ * when it cannot serve that request — the entry is then absent.
+ */
+interface CanvasOutputPorts {
+    /** Print engine for an item the kind/body does not print itself ("dom" bodies). */
+    readonly print?: ((request: CanvasOutputRequest) => (() => void | Promise<void>) | null) | undefined;
+    /** Save-as-PDF engine. Absent ⇒ Print stands in (the print dialog saves PDFs). */
+    readonly savePdf?: ((request: CanvasOutputRequest) => (() => void | Promise<void>) | null) | undefined;
+    /** Capture engine (an image of the item). */
+    readonly capture?: ((request: CanvasOutputRequest) => (() => Promise<Blob>) | null) | undefined;
+    /** Puts an image on the clipboard. Default: `navigator.clipboard.write` with a PNG ClipboardItem. */
+    readonly copyImage?: ((image: Blob, request: CanvasOutputRequest) => Promise<void>) | undefined;
+    /** "Attach to chat ▸" options for the item (code · screenshot · text). Given the resolved capture, if any. */
+    readonly attachOptions?: ((request: CanvasOutputRequest, capture: (() => Promise<Blob>) | null) => readonly CanvasMenuItem[]) | undefined;
+    /** Where a failed entry is reported. Default: console.error. */
+    readonly onError?: ((message: string, error: unknown) => void) | undefined;
+}
+/** The body element of `itemId` in this document (the live tab, never a kept step). */
+declare function canvasItemElement(itemId: string): HTMLElement | null;
+/** A kind's surface, read defensively (a kind registered without `defineCanvasKind`). */
+declare function canvasKindSurface(kind: AnyCanvasKind | undefined): CanvasKindSurface;
+/**
+ * The standard entries for one item, in order: Print, Save as PDF, Copy
+ * image, then the host's Attach options. An entry nobody can serve is absent;
+ * one declared unavailable shows its reason, disabled — never a silent no-op.
+ */
+declare function canvasOutputMenu(input: {
+    readonly item: CanvasItem;
+    readonly kind: AnyCanvasKind | undefined;
+    readonly title: string;
+    readonly body: CanvasOutputHandlers;
+    readonly ports: CanvasOutputPorts | undefined;
+}): CanvasMenuItem[];
+/**
+ * A body offers its rendered output: `print` (a page printing itself),
+ * `capture` (an exact image), or an honest `unavailable` reason. The latest
+ * handlers are read each time the menu opens.
+ */
+declare function useCanvasOutput(itemId: CanvasItemId | string | null | undefined, handlers: CanvasOutputHandlers): void;
+/**
+ * Guard for hosts' tests: what a kind's declaration lacks under the standard.
+ * Every kind declares `surface`; a "frame" or "native" kind declares `print`
+ * and `capture` (a handler, or an honest reason string).
+ */
+declare function canvasKindOutputProblems(kind: AnyCanvasKind): string[];
 
 /**
  * THE canvas kind registry. A kind is one sort of thing the canvas can show —
@@ -46,9 +118,31 @@ interface CanvasMenuItem {
     readonly icon?: ReactNode;
     readonly onSelect: () => void;
     readonly destructive?: boolean;
+    /** Shown but not choosable — an honest "cannot, and why" entry (its label says why). */
+    readonly disabled?: boolean;
 }
+/**
+ * What a kind's body is, for printing and capturing it:
+ * - "dom": same-origin DOM — the host's DOM print and capture copy it as drawn.
+ * - "frame": drawn in a frame or a drawing surface (an iframe page, a canvas,
+ *   WebGL, a map) that a DOM copy cannot reproduce — the kind declares its own
+ *   `print` and `capture` (or an honest reason it cannot).
+ * - "native": drawn by the host outside the DOM (`body: "native"`) — same.
+ */
+type CanvasKindSurface = "dom" | "frame" | "native";
 interface CanvasKind<TData extends CanvasJson = CanvasJson> {
     readonly id: string;
+    /** Required, no default — see `CanvasKindSurface`. A guard holds every registered kind to it. */
+    readonly surface: CanvasKindSurface;
+    /**
+     * How a tab of this kind prints (the pane menu's Print / Save as PDF): a
+     * handler, or a short honest reason it cannot ("not yet for live apps"),
+     * shown disabled; `false` when there is nothing to print (a launcher). Absent on a "dom" kind ⇒ the host's DOM print. A body can
+     * offer a better answer at run time with `useCanvasOutput`.
+     */
+    readonly print?: ((request: CanvasOutputRequest) => void | Promise<void>) | string | false;
+    /** How a tab of this kind becomes an image (Copy image, Attach screenshot): a handler or an honest reason. */
+    readonly capture?: ((request: CanvasOutputRequest) => Promise<Blob>) | string | false;
     /** Singular noun shown in menus and the empty-pane launcher. */
     readonly label: string;
     readonly icon: ComponentType<{
@@ -178,6 +272,7 @@ type CanvasMenuEntry = {
     readonly id: string;
     readonly label: string;
     readonly destructive?: boolean;
+    readonly disabled?: boolean;
 } | {
     readonly type: "separator";
 };
@@ -220,6 +315,12 @@ interface CanvasHostPorts {
     readonly overlay?: CanvasOverlayPort | undefined;
     /** Where each native-body kind's view goes, reported in the frame the layout changed. */
     readonly onNativeBodyFrame?: CanvasNativeBodyFrame | undefined;
+    /**
+     * The print / capture / attach engines behind the standard entries (Print,
+     * Save as PDF, Copy image, Attach to chat ▸). Absent ⇒ only what kinds and
+     * bodies serve themselves is offered.
+     */
+    readonly output?: CanvasOutputPorts | undefined;
 }
 type CanvasTabStripMode = "auto" | "always";
 /**
@@ -547,4 +648,4 @@ interface BrowserBarProps {
 /** A browser's back · forward · reload · address bar, for a kind's leading slot or its body. */
 declare function BrowserBar({ url, canGoBack, canGoForward, onBack, onForward, onReload, onNavigate, trailing, className }: BrowserBarProps): react.JSX.Element;
 
-export { type AnyCanvasKind, BrowserBar, type BrowserBarProps, type BrowserTab, BrowserTabs, type BrowserTabsProps, CANVAS_TAB_LIST_ROOM, CANVAS_TAB_MIN_WIDTH, CanvasColumn, type CanvasColumnProps, type CanvasFloating, CanvasFrame, CanvasHeaderButton, type CanvasHeaderButtonProps, type CanvasHostPorts, type CanvasKind, type CanvasKindIcon, CanvasKindIcons, type CanvasKindProps, type CanvasLauncherEntry, type CanvasMenuEntry, type CanvasMenuItem, CanvasMenuTrigger, type CanvasNativeBodyFrame, type CanvasNativeBodyInfo, type CanvasNativeRect, type CanvasOverlayPort, CanvasPaneView, CanvasPanel, CanvasPanelEmpty, type CanvasPanelProps, CanvasProvider, type CanvasProviderProps, type CanvasShowMenu, type CanvasStripEntry, type CanvasStripTab, CanvasTab, type CanvasTabProps, type CanvasTabStripMode, type CanvasTabWindow, CanvasToggle, CanvasWindowScope, CanvasWindowTabs, beginCanvasResize, canvasSessionKey, defineCanvasKind, fitCanvasTabWindow, getCanvasKind, itemTitle, listCanvasKinds, planCanvasTabStrip, registerCanvasKind, registerCanvasKinds, useCanvas, useCanvasColumnWidth, useCanvasHostPorts, useCanvasIsPresented, useCanvasKind, useCanvasKindToggle, useCanvasKinds, useCanvasLauncherEntries, useCanvasLauncherEntry, useCanvasMenuItems, useCanvasNativeBodies, useCanvasPresentation, useCanvasState, useCanvasWindowId, useOptionalCanvas, useOptionalCanvasState };
+export { type AnyCanvasKind, BrowserBar, type BrowserBarProps, type BrowserTab, BrowserTabs, type BrowserTabsProps, CANVAS_TAB_LIST_ROOM, CANVAS_TAB_MIN_WIDTH, CanvasColumn, type CanvasColumnProps, type CanvasFloating, CanvasFrame, CanvasHeaderButton, type CanvasHeaderButtonProps, type CanvasHostPorts, type CanvasKind, type CanvasKindIcon, CanvasKindIcons, type CanvasKindProps, type CanvasKindSurface, type CanvasLauncherEntry, type CanvasMenuEntry, type CanvasMenuItem, CanvasMenuTrigger, type CanvasNativeBodyFrame, type CanvasNativeBodyInfo, type CanvasNativeRect, type CanvasOutputHandlers, type CanvasOutputPorts, type CanvasOutputRequest, type CanvasOverlayPort, CanvasPaneView, CanvasPanel, CanvasPanelEmpty, type CanvasPanelProps, CanvasProvider, type CanvasProviderProps, type CanvasShowMenu, type CanvasStripEntry, type CanvasStripTab, CanvasTab, type CanvasTabProps, type CanvasTabStripMode, type CanvasTabWindow, CanvasToggle, CanvasWindowScope, CanvasWindowTabs, beginCanvasResize, canvasItemElement, canvasKindOutputProblems, canvasKindSurface, canvasOutputMenu, canvasSessionKey, defineCanvasKind, fitCanvasTabWindow, getCanvasKind, itemTitle, listCanvasKinds, planCanvasTabStrip, registerCanvasKind, registerCanvasKinds, useCanvas, useCanvasColumnWidth, useCanvasHostPorts, useCanvasIsPresented, useCanvasKind, useCanvasKindToggle, useCanvasKinds, useCanvasLauncherEntries, useCanvasLauncherEntry, useCanvasMenuItems, useCanvasNativeBodies, useCanvasOutput, useCanvasPresentation, useCanvasState, useCanvasWindowId, useOptionalCanvas, useOptionalCanvasState };

package/dist/react.d.ts

@@ -1,6 +1,78 @@
 import * as react from 'react';
 import { ComponentType, ReactNode, CSSProperties, ButtonHTMLAttributes, HTMLAttributes, ReactElement } from 'react';
-import { b as CanvasJson, i as CanvasItem, d as CanvasPaneId, h as CanvasController, a as CanvasWindowId, Q as CanvasPresentation, V as CanvasSessionEvent, T as CanvasSessionAttachReason, U as CanvasSessionDetachReason, P as CanvasPreferredTarget, C as CanvasItemId, S as CanvasRect, e as CanvasStoreBinding, O as CanvasPersistencePort, F as CanvasErrorSink, I as CanvasLayoutRules, a0 as ToggleKindInput, H as CanvasKindVisibility, f as CanvasState } from './toggleKind-CI2nBjum.js';
+import { i as CanvasItem, C as CanvasItemId, b as CanvasJson, d as CanvasPaneId, h as CanvasController, a as CanvasWindowId, Q as CanvasPresentation, V as CanvasSessionEvent, T as CanvasSessionAttachReason, U as CanvasSessionDetachReason, P as CanvasPreferredTarget, S as CanvasRect, e as CanvasStoreBinding, O as CanvasPersistencePort, F as CanvasErrorSink, I as CanvasLayoutRules, a0 as ToggleKindInput, H as CanvasKindVisibility, f as CanvasState } from './toggleKind-CI2nBjum.js';
+
+/** What a body (or a kind) can do with its rendered output right now. */
+interface CanvasOutputHandlers {
+    /** Print exactly what is shown (a frame page asks its own page to print). Runs inside the click. */
+    readonly print?: (() => void | Promise<void>) | undefined;
+    /** Save as PDF. Absent ⇒ the print dialog's "Save as PDF" (the Print handler) when there is one. */
+    readonly savePdf?: (() => void | Promise<void>) | undefined;
+    /** A full image of the item exactly as rendered (full height, the viewer's width). */
+    readonly capture?: (() => Promise<Blob>) | undefined;
+    /** A short honest reason an entry cannot run NOW ("Publishing the page…"). Shown in the menu, disabled. */
+    readonly unavailable?: {
+        readonly print?: string | undefined;
+        readonly capture?: string | undefined;
+    } | undefined;
+}
+/** One request to the host's engines. */
+interface CanvasOutputRequest {
+    readonly item: CanvasItem;
+    readonly kind: AnyCanvasKind | undefined;
+    readonly surface: CanvasKindSurface;
+    /** The body's root element in this window (null when it is not mounted here). */
+    readonly element: HTMLElement | null;
+    /** Tab title. */
+    readonly title: string;
+}
+/**
+ * The host's print / capture / attach engines (web: `@ai-matrx/print` and DOM
+ * capture; desktop: `webContents.print` / `capturePage`). Each returns null
+ * when it cannot serve that request — the entry is then absent.
+ */
+interface CanvasOutputPorts {
+    /** Print engine for an item the kind/body does not print itself ("dom" bodies). */
+    readonly print?: ((request: CanvasOutputRequest) => (() => void | Promise<void>) | null) | undefined;
+    /** Save-as-PDF engine. Absent ⇒ Print stands in (the print dialog saves PDFs). */
+    readonly savePdf?: ((request: CanvasOutputRequest) => (() => void | Promise<void>) | null) | undefined;
+    /** Capture engine (an image of the item). */
+    readonly capture?: ((request: CanvasOutputRequest) => (() => Promise<Blob>) | null) | undefined;
+    /** Puts an image on the clipboard. Default: `navigator.clipboard.write` with a PNG ClipboardItem. */
+    readonly copyImage?: ((image: Blob, request: CanvasOutputRequest) => Promise<void>) | undefined;
+    /** "Attach to chat ▸" options for the item (code · screenshot · text). Given the resolved capture, if any. */
+    readonly attachOptions?: ((request: CanvasOutputRequest, capture: (() => Promise<Blob>) | null) => readonly CanvasMenuItem[]) | undefined;
+    /** Where a failed entry is reported. Default: console.error. */
+    readonly onError?: ((message: string, error: unknown) => void) | undefined;
+}
+/** The body element of `itemId` in this document (the live tab, never a kept step). */
+declare function canvasItemElement(itemId: string): HTMLElement | null;
+/** A kind's surface, read defensively (a kind registered without `defineCanvasKind`). */
+declare function canvasKindSurface(kind: AnyCanvasKind | undefined): CanvasKindSurface;
+/**
+ * The standard entries for one item, in order: Print, Save as PDF, Copy
+ * image, then the host's Attach options. An entry nobody can serve is absent;
+ * one declared unavailable shows its reason, disabled — never a silent no-op.
+ */
+declare function canvasOutputMenu(input: {
+    readonly item: CanvasItem;
+    readonly kind: AnyCanvasKind | undefined;
+    readonly title: string;
+    readonly body: CanvasOutputHandlers;
+    readonly ports: CanvasOutputPorts | undefined;
+}): CanvasMenuItem[];
+/**
+ * A body offers its rendered output: `print` (a page printing itself),
+ * `capture` (an exact image), or an honest `unavailable` reason. The latest
+ * handlers are read each time the menu opens.
+ */
+declare function useCanvasOutput(itemId: CanvasItemId | string | null | undefined, handlers: CanvasOutputHandlers): void;
+/**
+ * Guard for hosts' tests: what a kind's declaration lacks under the standard.
+ * Every kind declares `surface`; a "frame" or "native" kind declares `print`
+ * and `capture` (a handler, or an honest reason string).
+ */
+declare function canvasKindOutputProblems(kind: AnyCanvasKind): string[];
 
 /**
  * THE canvas kind registry. A kind is one sort of thing the canvas can show —
@@ -46,9 +118,31 @@ interface CanvasMenuItem {
     readonly icon?: ReactNode;
     readonly onSelect: () => void;
     readonly destructive?: boolean;
+    /** Shown but not choosable — an honest "cannot, and why" entry (its label says why). */
+    readonly disabled?: boolean;
 }
+/**
+ * What a kind's body is, for printing and capturing it:
+ * - "dom": same-origin DOM — the host's DOM print and capture copy it as drawn.
+ * - "frame": drawn in a frame or a drawing surface (an iframe page, a canvas,
+ *   WebGL, a map) that a DOM copy cannot reproduce — the kind declares its own
+ *   `print` and `capture` (or an honest reason it cannot).
+ * - "native": drawn by the host outside the DOM (`body: "native"`) — same.
+ */
+type CanvasKindSurface = "dom" | "frame" | "native";
 interface CanvasKind<TData extends CanvasJson = CanvasJson> {
     readonly id: string;
+    /** Required, no default — see `CanvasKindSurface`. A guard holds every registered kind to it. */
+    readonly surface: CanvasKindSurface;
+    /**
+     * How a tab of this kind prints (the pane menu's Print / Save as PDF): a
+     * handler, or a short honest reason it cannot ("not yet for live apps"),
+     * shown disabled; `false` when there is nothing to print (a launcher). Absent on a "dom" kind ⇒ the host's DOM print. A body can
+     * offer a better answer at run time with `useCanvasOutput`.
+     */
+    readonly print?: ((request: CanvasOutputRequest) => void | Promise<void>) | string | false;
+    /** How a tab of this kind becomes an image (Copy image, Attach screenshot): a handler or an honest reason. */
+    readonly capture?: ((request: CanvasOutputRequest) => Promise<Blob>) | string | false;
     /** Singular noun shown in menus and the empty-pane launcher. */
     readonly label: string;
     readonly icon: ComponentType<{
@@ -178,6 +272,7 @@ type CanvasMenuEntry = {
     readonly id: string;
     readonly label: string;
     readonly destructive?: boolean;
+    readonly disabled?: boolean;
 } | {
     readonly type: "separator";
 };
@@ -220,6 +315,12 @@ interface CanvasHostPorts {
     readonly overlay?: CanvasOverlayPort | undefined;
     /** Where each native-body kind's view goes, reported in the frame the layout changed. */
     readonly onNativeBodyFrame?: CanvasNativeBodyFrame | undefined;
+    /**
+     * The print / capture / attach engines behind the standard entries (Print,
+     * Save as PDF, Copy image, Attach to chat ▸). Absent ⇒ only what kinds and
+     * bodies serve themselves is offered.
+     */
+    readonly output?: CanvasOutputPorts | undefined;
 }
 type CanvasTabStripMode = "auto" | "always";
 /**
@@ -547,4 +648,4 @@ interface BrowserBarProps {
 /** A browser's back · forward · reload · address bar, for a kind's leading slot or its body. */
 declare function BrowserBar({ url, canGoBack, canGoForward, onBack, onForward, onReload, onNavigate, trailing, className }: BrowserBarProps): react.JSX.Element;
 
-export { type AnyCanvasKind, BrowserBar, type BrowserBarProps, type BrowserTab, BrowserTabs, type BrowserTabsProps, CANVAS_TAB_LIST_ROOM, CANVAS_TAB_MIN_WIDTH, CanvasColumn, type CanvasColumnProps, type CanvasFloating, CanvasFrame, CanvasHeaderButton, type CanvasHeaderButtonProps, type CanvasHostPorts, type CanvasKind, type CanvasKindIcon, CanvasKindIcons, type CanvasKindProps, type CanvasLauncherEntry, type CanvasMenuEntry, type CanvasMenuItem, CanvasMenuTrigger, type CanvasNativeBodyFrame, type CanvasNativeBodyInfo, type CanvasNativeRect, type CanvasOverlayPort, CanvasPaneView, CanvasPanel, CanvasPanelEmpty, type CanvasPanelProps, CanvasProvider, type CanvasProviderProps, type CanvasShowMenu, type CanvasStripEntry, type CanvasStripTab, CanvasTab, type CanvasTabProps, type CanvasTabStripMode, type CanvasTabWindow, CanvasToggle, CanvasWindowScope, CanvasWindowTabs, beginCanvasResize, canvasSessionKey, defineCanvasKind, fitCanvasTabWindow, getCanvasKind, itemTitle, listCanvasKinds, planCanvasTabStrip, registerCanvasKind, registerCanvasKinds, useCanvas, useCanvasColumnWidth, useCanvasHostPorts, useCanvasIsPresented, useCanvasKind, useCanvasKindToggle, useCanvasKinds, useCanvasLauncherEntries, useCanvasLauncherEntry, useCanvasMenuItems, useCanvasNativeBodies, useCanvasPresentation, useCanvasState, useCanvasWindowId, useOptionalCanvas, useOptionalCanvasState };
+export { type AnyCanvasKind, BrowserBar, type BrowserBarProps, type BrowserTab, BrowserTabs, type BrowserTabsProps, CANVAS_TAB_LIST_ROOM, CANVAS_TAB_MIN_WIDTH, CanvasColumn, type CanvasColumnProps, type CanvasFloating, CanvasFrame, CanvasHeaderButton, type CanvasHeaderButtonProps, type CanvasHostPorts, type CanvasKind, type CanvasKindIcon, CanvasKindIcons, type CanvasKindProps, type CanvasKindSurface, type CanvasLauncherEntry, type CanvasMenuEntry, type CanvasMenuItem, CanvasMenuTrigger, type CanvasNativeBodyFrame, type CanvasNativeBodyInfo, type CanvasNativeRect, type CanvasOutputHandlers, type CanvasOutputPorts, type CanvasOutputRequest, type CanvasOverlayPort, CanvasPaneView, CanvasPanel, CanvasPanelEmpty, type CanvasPanelProps, CanvasProvider, type CanvasProviderProps, type CanvasShowMenu, type CanvasStripEntry, type CanvasStripTab, CanvasTab, type CanvasTabProps, type CanvasTabStripMode, type CanvasTabWindow, CanvasToggle, CanvasWindowScope, CanvasWindowTabs, beginCanvasResize, canvasItemElement, canvasKindOutputProblems, canvasKindSurface, canvasOutputMenu, canvasSessionKey, defineCanvasKind, fitCanvasTabWindow, getCanvasKind, itemTitle, listCanvasKinds, planCanvasTabStrip, registerCanvasKind, registerCanvasKinds, useCanvas, useCanvasColumnWidth, useCanvasHostPorts, useCanvasIsPresented, useCanvasKind, useCanvasKindToggle, useCanvasKinds, useCanvasLauncherEntries, useCanvasLauncherEntry, useCanvasMenuItems, useCanvasNativeBodies, useCanvasOutput, useCanvasPresentation, useCanvasState, useCanvasWindowId, useOptionalCanvas, useOptionalCanvasState };