@yuzhouu/canvas-kit 0.1.7 → 0.1.9

package/_vendor/plugin-image/smudge.d.ts

@@ -0,0 +1,63 @@
+import type { Editor, ShapeId } from "../canvas-core/index";
+import type { ImageShapeRecord } from "./types";
+export declare const IMAGE_SMUDGE_TOOLBAR_ACTION_ID = "image.smudge";
+export declare const IMAGE_SMUDGE_CANCEL_TOOLBAR_ACTION_ID = "image.smudge.cancel";
+export declare const IMAGE_SMUDGE_CONFIRM_TOOLBAR_ACTION_ID = "image.smudge.confirm";
+export declare const IMAGE_SMUDGE_BRUSH_SIZE_TOOLBAR_ACTION_ID = "image.smudge.brush-size";
+export declare const IMAGE_SMUDGE_BRUSH_COLOR_TOOLBAR_ACTION_ID = "image.smudge.brush-color";
+export declare const IMAGE_SMUDGE_HISTORY_MARK_PREFIX = "image.smudge:";
+export declare const IMAGE_SMUDGE_MODE_ENTRY_MARK_PREFIX = "image.smudge:edit:";
+export declare const DEFAULT_IMAGE_SMUDGE_BRUSH_SIZE = 24;
+export declare const DEFAULT_IMAGE_SMUDGE_BRUSH_COLOR = "#ffff00";
+export declare const IMAGE_SMUDGE_BRUSH_SIZE_MIN = 1;
+export declare const IMAGE_SMUDGE_BRUSH_SIZE_MAX = 128;
+export interface ImageSmudgeBrush {
+    size: number;
+    color?: string;
+    opacity?: number;
+}
+export interface ImageSmudgeStrokePoint {
+    x: number;
+    y: number;
+    pressure?: number;
+}
+export interface ImageSmudgeStroke {
+    id: string;
+    points: ImageSmudgeStrokePoint[];
+    brush: ImageSmudgeBrush;
+}
+export interface ImageSmudgeConfirmInput {
+    replace?: boolean;
+}
+export type ImageSmudgeSessionSnapshot = Readonly<{
+    shapeId: ShapeId;
+    brush: ImageSmudgeBrush;
+    strokes: readonly ImageSmudgeStroke[];
+}>;
+type ImageSmudgeSubscriber = () => void;
+type ImageSmudgeConfirmHandler = (input?: ImageSmudgeConfirmInput) => Promise<unknown>;
+export declare function getImageSmudgeModeMarkId(shapeId: ShapeId): string;
+export declare function isImageSmudgeModeForShape(shape: ImageShapeRecord, markId: string | null | undefined): boolean;
+export declare function isImageSmudgeToolbarActionId(actionId: string): boolean;
+export declare function normalizeImageSmudgeBrush(brush?: Partial<ImageSmudgeBrush>): ImageSmudgeBrush;
+export declare function startImageSmudgeSession({ brush, editor, shape, }: {
+    brush?: Partial<ImageSmudgeBrush>;
+    editor: Editor;
+    shape: ImageShapeRecord;
+}): boolean;
+export declare function cancelImageSmudgeSession(editor: Editor): void;
+export declare function completeImageSmudgeSession(editor: Editor): void;
+export declare function cancelImageSmudgeSessionIfActive(editor: Editor): boolean;
+export declare function clearImageSmudgeSessionForShape(editor: Editor, shapeId: ShapeId): void;
+export declare function updateImageSmudgeBrush(editor: Editor, brush: Partial<ImageSmudgeBrush>): boolean;
+export declare function getImageSmudgeSessionSnapshot(editor: Editor, shapeId: ShapeId): ImageSmudgeSessionSnapshot | null;
+export declare function getActiveImageSmudgeSession(editor: Editor): ImageSmudgeSessionSnapshot | null;
+export declare function subscribeImageSmudgeSession(editor: Editor, subscriber: ImageSmudgeSubscriber): () => void;
+export declare function beginImageSmudgeStroke(editor: Editor, point: ImageSmudgeStrokePoint): void;
+export declare function addImageSmudgeStrokePoint(editor: Editor, point: ImageSmudgeStrokePoint): void;
+export declare function appendImageSmudgeStrokePoint(editor: Editor, point: ImageSmudgeStrokePoint): void;
+export declare function endImageSmudgeStroke(editor: Editor): void;
+export declare function registerImageSmudgeConfirmHandler(editor: Editor, handler: ImageSmudgeConfirmHandler): () => void;
+export declare function requestImageSmudgeConfirm(editor: Editor, input?: ImageSmudgeConfirmInput): Promise<unknown>;
+export declare function cloneImageSmudgeStrokes(strokes: readonly ImageSmudgeStroke[]): ImageSmudgeStroke[];
+export {};

package/_vendor/plugin-image/smudgeInteractions.d.ts

@@ -0,0 +1,2 @@
+import { type LandInteractionHandler } from "../canvas-core/index";
+export declare function createImageSmudgeInteractionHandler(): LandInteractionHandler;

package/_vendor/plugin-image/smudgeRuntime.d.ts

@@ -0,0 +1,2 @@
+import type { CanvasAction } from "../canvas-core/index";
+export declare function createImageSmudgeCanvasActions(): CanvasAction[];

package/_vendor/plugin-image/styleRuntime.d.ts

@@ -0,0 +1,17 @@
+import { type CanvasAction, type ToolbarGroup } from "../canvas-core/index";
+export declare function createImageStyleCanvasActions(): CanvasAction[];
+export declare function createImageCornerRadiusToolbarGroup({ dataUiPrefix, id, order, }: {
+    dataUiPrefix: string;
+    id: string;
+    order: number;
+}): ToolbarGroup;
+export declare function createImageCornerRadiusToolbarItem({ dataUiPrefix, }: {
+    dataUiPrefix: string;
+}): {
+    kind: "text-input";
+    id: string;
+    actionId: string;
+    label: string;
+    placeholder: string;
+    dataUi: string;
+};

package/_vendor/plugin-image/toolbarRuntime.d.ts

@@ -0,0 +1,3 @@
+import type { ContextMenuContribution, ToolbarContribution } from "../canvas-core/index";
+export declare function createImageToolbarContributions(): ToolbarContribution[];
+export declare function createImageContextMenuContributions(): ContextMenuContribution[];

package/_vendor/plugin-image/types.d.ts

@@ -1,9 +1,24 @@
 import { type AssetId, type AssetRecordBase, type BaseRecord, type ShapeRecordBase } from "../canvas-core/index";
+export type ImageRemoteCopyState = {
+    status: "pending-local-copy";
+} | {
+    status: "copy-failed";
+    errorMessage?: string;
+};
+export type ImageAssetSource = {
+    kind: "local";
+    storageKey: string;
+    originalUrl?: string;
+} | {
+    kind: "remote";
+    url: string;
+    copyState?: ImageRemoteCopyState;
+};
 export interface ImageAssetProps {
     w: number;
     h: number;
     name: string;
-    storageKey: string;
+    source: ImageAssetSource;
     mimeType: string | null;
     fileSize?: number;
     isAnimated: boolean;

package/_vendor/plugin-laser/canvasRender.d.ts

@@ -0,0 +1,2 @@
+import { type LandCanvasRenderPlugin } from "../canvas-react/host/index";
+export declare function createLaserCanvasRenderPlugin(): LandCanvasRenderPlugin;

package/_vendor/plugin-laser/editorRuntime.d.ts

@@ -0,0 +1,2 @@
+import { type LandEditorRuntimePlugin } from "../canvas-core/index";
+export declare function createLaserEditorRuntimePlugin(): LandEditorRuntimePlugin;

package/_vendor/plugin-laser/index.d.ts

@@ -1,4 +1,4 @@
 export { LaserTool } from "./laserTool";
-export { createLaserCanvasPlugin } from "./canvas";
-export { createLaserEditorPlugin } from "./editor";
+export { createLaserCanvasRenderPlugin } from "./canvasRender";
+export { createLaserEditorRuntimePlugin } from "./editorRuntime";
 export { Laser, createLaserFeatureBundle } from "./feature";

package/_vendor/plugin-text/canvasRender.d.ts

@@ -0,0 +1,5 @@
+import { type TextFontCatalog } from "./textFonts";
+import { type LandCanvasRenderPlugin } from "../canvas-react/host/index";
+export declare function createTextCanvasRenderPlugin({ fontCatalog, }?: {
+    fontCatalog?: TextFontCatalog;
+}): LandCanvasRenderPlugin;

package/_vendor/plugin-text/editorRuntime.d.ts

@@ -0,0 +1,5 @@
+import { type LandEditorRuntimePlugin } from "../canvas-core/index";
+import { type TextFontCatalog } from "./textFonts";
+export declare function createTextEditorRuntimePlugin({ fontCatalog, }?: {
+    fontCatalog?: TextFontCatalog;
+}): LandEditorRuntimePlugin;

package/_vendor/plugin-text/host/RichTextLinkPopover.d.ts

@@ -0,0 +1,14 @@
+export interface RichTextLinkHoverState {
+    href: string;
+    path: readonly number[];
+    rect: DOMRect;
+}
+export declare function RichTextLinkPopover({ link, onApply, onKeepVisible, onClear, }: {
+    link: RichTextLinkHoverState | null;
+    onApply(input: {
+        path: readonly number[];
+        href: string | null;
+    }): void;
+    onKeepVisible(): void;
+    onClear(): void;
+}): import("react").ReactPortal | null;

package/_vendor/plugin-text/host/richTextRendering.d.ts

@@ -1,3 +1,11 @@
 import type { ReactNode } from "react";
 import type { RichTextDocument } from "../textTypes";
-export declare function renderRichTextDocument(richText: RichTextDocument): ReactNode;
+export interface RichTextRenderLinkHandlers {
+    onPointerEnter?(input: {
+        href: string;
+        path: readonly number[];
+        element: HTMLSpanElement;
+    }): void;
+    onPointerLeave?(): void;
+}
+export declare function renderRichTextDocument(richText: RichTextDocument, linkHandlers?: RichTextRenderLinkHandlers): ReactNode;

package/_vendor/plugin-text/index.d.ts

@@ -1,4 +1,6 @@
 export { Text, createTextFeatureBundle } from "./feature";
+export { createTextEditorRuntimePlugin } from "./editorRuntime";
+export { createTextCanvasRenderPlugin } from "./canvasRender";
 export { DEFAULT_TEXT_FONT, HOST_TEXT_FONT, createDefaultTextFontCatalog, createDefaultTextExtensionOptions, } from "./textFonts";
 export { createRichTextFromPlainText, getPlainTextFromRichText, validateRichTextDocument, } from "./richTextUtils";
 export { isTextShapeRecord, updateTextShapeRichText, } from "./textShapeHelpers";

package/_vendor/plugin-text/richTextLinks.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeRichTextLinkHref(value: string): string | null;
+export declare function isAllowedRichTextLinkHref(value: string): boolean;
+export declare function openRichTextLink(href: string): void;

package/_vendor/plugin-text/richTextUtils.d.ts

@@ -7,7 +7,7 @@ export type RichTextTextNode = JSONContent & {
 export interface RichTextMarkStyle {
     fontWeight?: number;
     fontStyle?: "italic";
-    textDecorationLine?: "line-through";
+    textDecorationLine?: string;
 }
 export declare function createRichTextFromPlainText(text: string): RichTextDocument;
 export declare function getPlainTextFromRichText(richTextDocument: RichTextDocument): string;
@@ -16,3 +16,4 @@ export declare function renderRichTextDocumentToHtml(richText: RichTextDocument)
 export declare function isRichTextTextNode(node: JSONContent): node is RichTextTextNode;
 export declare function getRichTextTextNodeStyle(node: RichTextTextNode): string | undefined;
 export declare function getRichTextMarkStyle(marks: JSONContent["marks"]): RichTextMarkStyle | undefined;
+export declare function getRichTextLinkHref(marks: JSONContent["marks"]): string | undefined;

package/browser/indexedDb.d.ts

@@ -0,0 +1,10 @@
+export declare const LAND_DOCUMENT_INDEXEDDB_NAME = "land.canvas.persistence";
+export declare const LAND_DOCUMENT_INDEXEDDB_STORE = "snapshots";
+export declare const LAND_IMAGE_BLOB_INDEXEDDB_STORE = "imageBlobs";
+export declare const LAND_DOCUMENT_INDEXEDDB_VERSION = 2;
+export declare function openLandCanvasDatabase(): Promise<IDBDatabase | null>;
+export declare function readLandCanvasStoreValue(storeName: string, key: IDBValidKey): Promise<unknown | null>;
+export declare function readLandCanvasStoreValues(storeName: string, keys: readonly IDBValidKey[]): Promise<readonly unknown[] | null>;
+export declare function writeLandCanvasStoreValues(storeName: string, entries: readonly (readonly [IDBValidKey, unknown])[]): Promise<void>;
+export declare function deleteLandCanvasStoreValue(storeName: string, key: IDBValidKey): Promise<void>;
+export declare function getAllLandCanvasStoreKeys(storeName: string): Promise<IDBValidKey[] | null>;

package/browser/persistence.d.ts

@@ -1,12 +1,10 @@
 import type { Editor, StoreSnapshot } from "../_vendor/canvas-core/index";
 import type { ProductPersistenceAdapter } from "../core/runtime/productDefinition";
 import { type PersistedEditorSnapshots } from "./localSnapshotRestore";
-export declare const LAND_DOCUMENT_INDEXEDDB_NAME = "land.canvas.persistence";
-export declare const LAND_DOCUMENT_INDEXEDDB_STORE = "snapshots";
-export declare const LAND_IMAGE_BLOB_INDEXEDDB_STORE = "imageBlobs";
+import { LAND_DOCUMENT_INDEXEDDB_NAME, LAND_DOCUMENT_INDEXEDDB_STORE, LAND_DOCUMENT_INDEXEDDB_VERSION, LAND_IMAGE_BLOB_INDEXEDDB_STORE } from "./indexedDb";
 export declare const LAND_DOCUMENT_STORAGE_KEY = "land.canvas.document";
 export declare const LAND_SESSION_STORAGE_KEY = "land.canvas.session";
-export declare const LAND_DOCUMENT_INDEXEDDB_VERSION = 2;
+export { LAND_DOCUMENT_INDEXEDDB_NAME, LAND_DOCUMENT_INDEXEDDB_STORE, LAND_DOCUMENT_INDEXEDDB_VERSION, LAND_IMAGE_BLOB_INDEXEDDB_STORE, };
 export interface LocalSnapshotPersistenceOptions {
     storageNamespace?: string;
 }

package/builtins/controller/createBuiltInCanvasController.d.ts

@@ -1,5 +1,5 @@
 import type { ShapeId } from "../../_vendor/canvas-core/index";
-import type { CanvasProductController, CanvasProductControllerSnapshot, CanvasProductControllerOptions, CanvasProductSessionSnapshot } from "../../core/controller";
+import type { CanvasProductController, CanvasProductControllerSnapshot, CanvasProductControllerOptions, CanvasProductSessionSnapshot } from "../../core/product-controller";
 import { type BuiltInCanvasShapeCreationControllers } from "./shapeCreationController";
 import { type BuiltInCanvasLayerNode } from "./layerController";
 export interface BuiltInCanvasControllerSnapshot<TToolId extends string = string> extends CanvasProductControllerSnapshot<TToolId> {

package/builtins/controller/layerController.d.ts

@@ -1,6 +1,6 @@
 import type { AssetId, Editor } from "../../_vendor/canvas-core/index";
 import type { GeoShapeKind } from "../../_vendor/plugin-geo/index";
-import type { CanvasProductLayerNode } from "../../core/controller";
+import type { CanvasProductLayerNode } from "../../core/product-controller";
 export interface BuiltInCanvasLayerNode extends CanvasProductLayerNode {
     geoKind?: GeoShapeKind;
     imageAssetId?: AssetId | null;

package/builtins/controller/shapeCreationController.d.ts

@@ -1,7 +1,8 @@
 import type { Editor, ShapeColor, ShapeId } from "../../_vendor/canvas-core/index";
 import { type ArrowShapeProps } from "../../_vendor/plugin-arrow/index";
+import type { GeoShapeProps } from "../../_vendor/plugin-geo/index";
 import { type TextShapeProps } from "../../_vendor/plugin-text/index";
-import type { CanvasProductShapeRef } from "../../core/controller";
+import type { CanvasProductShapeRef } from "../../core/product-controller";
 export interface BuiltInCanvasShapeInput {
     x: number;
     y: number;
@@ -12,6 +13,9 @@ export interface BuiltInCanvasShapeInput {
     strokeWidth?: number;
     meta?: Record<string, unknown>;
 }
+export interface BuiltInCanvasRectangleInput extends BuiltInCanvasShapeInput {
+    cornerRadiusPercent?: GeoShapeProps["cornerRadiusPercent"];
+}
 export interface BuiltInCanvasTextInput {
     x: number;
     y: number;
@@ -53,7 +57,7 @@ export interface BuiltInCanvasArrowInput {
     meta?: Record<string, unknown>;
 }
 export interface BuiltInGeoController {
-    createRectangle(input: BuiltInCanvasShapeInput): CanvasProductShapeRef | null;
+    createRectangle(input: BuiltInCanvasRectangleInput): CanvasProductShapeRef | null;
     createEllipse(input: BuiltInCanvasShapeInput): CanvasProductShapeRef | null;
     createDiamond(input: BuiltInCanvasShapeInput): CanvasProductShapeRef | null;
     createTriangle(input: BuiltInCanvasShapeInput): CanvasProductShapeRef | null;

package/builtins/index.d.ts

@@ -2,4 +2,4 @@ export { builtInCanvasExtensions, createBuiltInCanvasExtensions, hasBuiltInCanva
 export type { BuiltInCanvasExtension, BuiltInCanvasExtensionOptions, } from "./extensions";
 export { createBuiltInCanvasController, useBuiltInCanvasController, } from "./controller/createBuiltInCanvasController";
 export type { BuiltInCanvasController, BuiltInCanvasControllerSnapshot, BuiltInCanvasLayerNode, } from "./controller/createBuiltInCanvasController";
-export type { BuiltInArrowController, BuiltInCanvasArrowBindingInput, BuiltInCanvasArrowInput, BuiltInCanvasFrameInput, BuiltInCanvasShapeCreationControllers, BuiltInCanvasShapeInput, BuiltInCanvasTextInput, BuiltInFrameController, BuiltInGeoController, BuiltInTextController, } from "./controller/shapeCreationController";
+export type { BuiltInArrowController, BuiltInCanvasArrowBindingInput, BuiltInCanvasArrowInput, BuiltInCanvasFrameInput, BuiltInCanvasRectangleInput, BuiltInCanvasShapeCreationControllers, BuiltInCanvasShapeInput, BuiltInCanvasTextInput, BuiltInFrameController, BuiltInGeoController, BuiltInTextController, } from "./controller/shapeCreationController";

package/chrome/toolbar/CanvasKitWheelCapture.d.ts

@@ -0,0 +1,2 @@
+import { type RefObject } from "react";
+export declare function useCanvasKitWheelCapture(ref: RefObject<HTMLElement | null>): void;

package/chrome/{FloatingSelectionToolbarPageSpace.d.ts → toolbar/FloatingSelectionToolbarPageSpace.d.ts}

@@ -1,5 +1,5 @@
 import { type ReactNode } from "react";
-import type { ToolbarSurfaces } from "./bindings/useToolbarSurfaces";
+import type { ToolbarSurfaces } from "./useToolbarSurfaces";
 export declare function FloatingSelectionToolbarPageSpace({ children, className, dataUi, offset, surfaces, }: {
     children: ReactNode;
     className?: string;

package/{core/features → chrome}/toolbar/toolbarLabels.d.ts

@@ -1,4 +1,4 @@
-import { type ToolbarGroup } from "../../../_vendor/canvas-core/index";
+import { type ToolbarGroup } from "../../_vendor/canvas-core/index";
 export declare function getActiveToolLabel(groups: readonly ToolbarGroup[], activeToolId: string): string;
 export declare function getSelectionToolbarTitle({ commonShapeType, count, isMixedFrameAndPointHandleSelection, singleShapeType, }: {
     commonShapeType: string | null;

package/chrome/{bindings → toolbar}/useToolbarSurfaces.d.ts

@@ -1,5 +1,5 @@
 import type { Editor, CanvasActionContext, ToolbarGroup } from "../../_vendor/canvas-core/index";
-import type { CanvasPluginHostRuntime } from "../../_vendor/canvas-react/host/index";
+import type { CanvasRenderPluginHostRuntime } from "../../_vendor/canvas-react/host/index";
 export interface FloatingSelectionToolbarPageAnchor {
     x: number;
     y: number;
@@ -22,5 +22,5 @@ export interface ToolbarSurfaces {
 export declare function useToolbarSurfaces({ canShowContextToolbarDuringEditing, editor, pluginHostRuntime, }: {
     canShowContextToolbarDuringEditing?: (context: CanvasActionContext) => boolean;
     editor: Editor;
-    pluginHostRuntime: CanvasPluginHostRuntime;
+    pluginHostRuntime: CanvasRenderPluginHostRuntime;
 }): ToolbarSurfaces;

package/chrome/types.d.ts

@@ -1,16 +1,20 @@
 import type { CanvasKitController, CanvasKitBaseController } from "../controller/canvasKitController";
 import type { BuiltInCanvasLayerNode } from "../builtins";
 import type { ActiveContextMenu, EditorSelectionState, ShapeId, CanvasActionValue, CanvasActionContext } from "../_vendor/canvas-core/index";
-import type { HistoryControls, PageControls, ZoomControlsState } from "./bindings/useCanvasKitChromeControls";
-import type { ContextMenuSurface } from "./bindings/useContextMenuSurface";
-import type { SvgExportControls } from "./bindings/useSvgExport";
-import type { ToolbarSurfaces } from "./bindings/useToolbarSurfaces";
+import type { HistoryControls } from "./useHistoryControls";
+import type { PageControls } from "./usePageControls";
+import type { ZoomControlsState } from "./useZoomControls";
+import type { ContextMenuSurface } from "./useContextMenuSurface";
+import type { SvgExportControls } from "./useSvgExport";
+import type { ToolbarSurfaces } from "./toolbar/useToolbarSurfaces";
 import type { ProductPersistenceStatus } from "../core";
 export type { ContextMenuCommandItem, ContextMenuItem, ContextMenuSection, EditorSelectionState, ShapeId, CanvasActionValue, CanvasActionContext, ToolbarGroup, ToolbarItem, } from "../_vendor/canvas-core/index";
-export type { HistoryControls, PageControls, ZoomControlsState, } from "./bindings/useCanvasKitChromeControls";
-export type { ContextMenuSurface } from "./bindings/useContextMenuSurface";
-export type { SvgExportControls, } from "./bindings/useSvgExport";
-export type { ToolbarSurfaces, } from "./bindings/useToolbarSurfaces";
+export type { HistoryControls } from "./useHistoryControls";
+export type { PageControls } from "./usePageControls";
+export type { ZoomControlsState } from "./useZoomControls";
+export type { ContextMenuSurface } from "./useContextMenuSurface";
+export type { SvgExportControls, } from "./useSvgExport";
+export type { ToolbarSurfaces, } from "./toolbar/useToolbarSurfaces";
 export type CanvasKitLayerNode = BuiltInCanvasLayerNode;
 export interface CanvasKitToolbarActionState {
     value: CanvasActionValue | undefined;

package/chrome/useCanvasKitChromeContext.d.ts

@@ -2,15 +2,17 @@ import { type RefObject } from "react";
 import { type ActiveContextMenu } from "../_vendor/canvas-core/index";
 import type { CanvasKitBaseController } from "../controller/canvasKitController";
 import type { CanvasKitRuntime } from "../runtime/canvasKitRuntime";
-import type { CanvasKitHostExtension } from "../runtime/canvasKitHostExtensions";
-import type { ProductServiceRegistry } from "../core";
+import type { CanvasKitChromeSlot, CanvasKitHostFeature } from "../runtime/canvasKitHostContracts";
+import type { ProductApiRegistry, ProductServiceRegistry } from "../core";
 import type { CanvasKitChromeContext, CanvasKitGridControls, CanvasKitPersistenceControls } from "./types";
-export declare function useCanvasKitChromeContext<TController extends CanvasKitBaseController>({ controller, activeContextMenu, editor, grid, hostExtensions, onActiveContextMenuChange, persistence, pluginHostRuntime, services, themeRootRef, }: {
+export declare function useCanvasKitChromeContext<TController extends CanvasKitBaseController>({ apis, controller, activeContextMenu, chromeSlots, editor, grid, hostFeatures, onActiveContextMenuChange, persistence, pluginHostRuntime, services, themeRootRef, }: {
+    apis: ProductApiRegistry;
     controller: TController;
     activeContextMenu: ActiveContextMenu | null;
+    chromeSlots: readonly CanvasKitChromeSlot<string, unknown>[];
     editor: CanvasKitRuntime["editor"];
     grid: CanvasKitGridControls;
-    hostExtensions: readonly CanvasKitHostExtension[];
+    hostFeatures: readonly CanvasKitHostFeature[];
     onActiveContextMenuChange: (activeContextMenu: ActiveContextMenu | null) => void;
     persistence: CanvasKitPersistenceControls;
     pluginHostRuntime: CanvasKitRuntime["pluginHostRuntime"];

package/chrome/{bindings/useCanvasKitLayerTree.d.ts → useCanvasKitLayerTree.d.ts}

@@ -1,4 +1,4 @@
-import type { CanvasKitLayerTreeSource, CanvasKitLayerNode } from "../types";
+import type { CanvasKitLayerTreeSource, CanvasKitLayerNode } from "./types";
 export declare function useCanvasKitLayerTree(source: CanvasKitLayerTreeSource, options?: {
     enabled?: boolean;
     pageId?: string;

package/chrome/{bindings/useContextMenuSurface.d.ts → useContextMenuSurface.d.ts}

@@ -1,5 +1,5 @@
-import type { ContextMenuContext, ActiveContextMenu, ContextMenuSection, Editor } from "../../_vendor/canvas-core/index";
-import type { CanvasPluginHostRuntime } from "../../_vendor/canvas-react/host/index";
+import type { ContextMenuContext, ActiveContextMenu, ContextMenuSection, Editor } from "../_vendor/canvas-core/index";
+import type { CanvasRenderPluginHostRuntime } from "../_vendor/canvas-react/host/index";
 export interface ContextMenuSurface {
     context: ContextMenuContext | null;
     activeContextMenu: ActiveContextMenu | null;
@@ -8,5 +8,5 @@ export interface ContextMenuSurface {
 export declare function useContextMenuSurface({ editor, activeContextMenu, pluginHostRuntime, }: {
     editor: Editor;
     activeContextMenu: ActiveContextMenu | null;
-    pluginHostRuntime: CanvasPluginHostRuntime;
+    pluginHostRuntime: CanvasRenderPluginHostRuntime;
 }): ContextMenuSurface;

package/chrome/useHistoryControls.d.ts

@@ -0,0 +1,12 @@
+import type { Editor } from "../_vendor/canvas-core/index";
+import type { CanvasKitHostFeature } from "../runtime/canvasKitHostContracts";
+export interface HistoryControls {
+    canUndo: boolean;
+    canRedo: boolean;
+    undo(): void;
+    redo(): void;
+}
+export declare function useHistoryControls({ editor, hostFeatures, }: {
+    editor: Editor;
+    hostFeatures: readonly CanvasKitHostFeature[];
+}): HistoryControls;

package/chrome/usePageControls.d.ts

@@ -0,0 +1,16 @@
+import type { Editor, PageId, PageRecord } from "../_vendor/canvas-core/index";
+import type { CanvasKitHostFeature } from "../runtime/canvasKitHostContracts";
+export interface PageControls {
+    pages: readonly PageRecord[];
+    currentPage: PageRecord | null;
+    currentPageId: PageId;
+    canDeleteCurrentPage: boolean;
+    createPage(): void;
+    deleteCurrentPage(): void;
+    renameCurrentPage(nextName: string): void;
+    selectPage(pageId: PageId): void;
+}
+export declare function usePageControls({ editor, hostFeatures, }: {
+    editor: Editor;
+    hostFeatures: readonly CanvasKitHostFeature[];
+}): PageControls;

package/chrome/{bindings/useSvgExport.d.ts → useSvgExport.d.ts}

@@ -1,6 +1,6 @@
 import { type RefObject } from "react";
-import type { Editor, ShapeId } from "../../_vendor/canvas-core/index";
-import { type ExportStatus as ProductExportStatus, type SvgAssetInliner as ProductSvgAssetInliner, type SvgExportResult as ProductSvgExportResult } from "../../core";
+import type { Editor, ShapeId } from "../_vendor/canvas-core/index";
+import { type ExportStatus as ProductExportStatus, type SvgAssetInliner as ProductSvgAssetInliner, type SvgExportResult as ProductSvgExportResult } from "../features/export/svgExport";
 export type ExportStatus = ProductExportStatus;
 export type SvgAssetInliner = ProductSvgAssetInliner;
 export type SvgExportResult = ProductSvgExportResult;

package/chrome/useZoomControls.d.ts

@@ -0,0 +1,9 @@
+import type { Editor } from "../_vendor/canvas-core/index";
+export interface ZoomControlsState {
+    zoom: number;
+    label: string;
+    zoomIn(): void;
+    zoomOut(): void;
+    resetZoom(): void;
+}
+export declare function useZoomControls(editor: Editor): ZoomControlsState;

package/controller/canvasKitController.d.ts

@@ -1,24 +1,27 @@
-import { type CanvasProductController, type CanvasProductControllerContext, type CanvasProductSessionSnapshot } from "../core/controller";
-import type { CanvasPluginHostRuntime } from "../_vendor/canvas-react/host/index";
-import { type BuiltInCanvasController, type BuiltInCanvasControllerSnapshot, type BuiltInCanvasFrameInput, type BuiltInCanvasShapeInput, type BuiltInCanvasTextInput } from "../builtins";
-import { type ImageProductController } from "../features/image";
+import { type CanvasProductController, type CanvasProductControllerContext, type CanvasProductSessionSnapshot } from "../core/product-controller";
+import type { CanvasRenderPluginHostRuntime } from "../_vendor/canvas-react/host/index";
+import { type BuiltInCanvasController, type BuiltInCanvasControllerSnapshot, type BuiltInCanvasFrameInput, type BuiltInCanvasRectangleInput, type BuiltInCanvasShapeInput, type BuiltInCanvasTextInput } from "../builtins";
+import type { CanvasKitControllerSlot } from "../runtime/canvasKitHostContracts";
 export type CanvasKitShapeInput = BuiltInCanvasShapeInput;
+export type CanvasKitRectangleInput = BuiltInCanvasRectangleInput;
 export type CanvasKitTextInput = BuiltInCanvasTextInput;
 export type CanvasKitFrameInput = BuiltInCanvasFrameInput;
 export interface CanvasKitBaseController<TToolId extends string = string> extends CanvasProductController<TToolId> {
 }
+export interface CanvasKitControllerSlots {
+}
 export declare const CANVAS_KIT_TOOL_IDS: readonly ["select", "hand", "rectangle", "ellipse", "diamond", "triangle", "hexagon", "star", "arrow", "draw", "path", "text", "frame", "eraser", "laser"];
 export type CanvasKitToolId = (typeof CANVAS_KIT_TOOL_IDS)[number];
 export interface CanvasKitControllerSnapshot<TToolId extends string = CanvasKitToolId> extends BuiltInCanvasControllerSnapshot<TToolId> {
     productId: string;
     session: CanvasProductSessionSnapshot<TToolId>;
 }
-export interface CanvasKitController<TToolId extends string = CanvasKitToolId> extends BuiltInCanvasController<TToolId> {
-    image: ImageProductController | null;
+export interface CanvasKitController<TToolId extends string = CanvasKitToolId> extends BuiltInCanvasController<TToolId>, CanvasKitControllerSlots {
     snapshot(): CanvasKitControllerSnapshot<TToolId>;
 }
 export interface CanvasKitControllerRuntimeContext extends Omit<CanvasProductControllerContext, "pluginHostRuntime"> {
-    pluginHostRuntime: CanvasPluginHostRuntime;
+    controllerSlots: readonly CanvasKitControllerSlot<string, unknown>[];
+    pluginHostRuntime: CanvasRenderPluginHostRuntime;
 }
 export interface CanvasKitControllerOptions<TToolId extends string = CanvasKitToolId> extends CanvasKitControllerRuntimeContext {
     assertToolId?: (toolId: string) => asserts toolId is TToolId;

package/core/api/apiRegistry.d.ts

@@ -0,0 +1,12 @@
+export interface ProductApiToken<TApi> {
+    readonly id: string;
+    readonly __api?: TApi;
+}
+export interface ProductApiRegistry {
+    get<TApi>(token: ProductApiToken<TApi>): TApi | null;
+}
+export interface ProductApiRegistryRuntime extends ProductApiRegistry {
+    register<TApi>(token: ProductApiToken<TApi>, api: TApi): void;
+}
+export declare function createProductApiToken<TApi>(id: string): ProductApiToken<TApi>;
+export declare function createProductApiRegistry(): ProductApiRegistryRuntime;

package/core/index.d.ts

@@ -1,24 +1,9 @@
 export { createDefaultCanvasProductEditor } from "./runtime/productEditor";
 export { cleanupProductAssetsAfterRestore, preloadProductAssets, resolveProductAssetUrl, } from "./runtime/productAssets";
-export { createProductFeatureControllerRegistry, createProductFeatureControllerToken, } from "./controller/featureControllerRegistry";
+export { createProductApiRegistry, createProductApiToken, } from "./api/apiRegistry";
 export { createProductServiceRegistry, createProductServiceToken, requireProductService, } from "./runtime/productServices";
-export { CANVAS_KIT_HOST_ACTION_IDS } from "./features/hostActionIds";
 export type { CanvasProductRuntimeInitializer, CanvasProductRuntimeInitializerContext, CreateCanvasProductEditorOptions, ProductPersistenceAdapter, ProductPersistenceRestoreResult, ProductPersistenceStatus, } from "./runtime/productDefinition";
-export type { CanvasProductRuntimeContribution, } from "./runtime/productContributions";
-export type { ProductContextMenuRegistry, ProductPluginHostRuntime, ProductToolbarRegistry, } from "./runtime/productHost";
+export type { ProductActionRegistry, ProductContextMenuRegistry, ProductPluginHostRuntime, ProductToolbarRegistry, } from "./runtime/productHost";
 export type { ProductAssetResolverService, ProductServiceFactory, ProductServiceFactoryContext, ProductServiceRegistry, ProductServiceRegistryRuntime, ProductServiceToken, } from "./runtime/productServices";
-export type { ProductFeatureControllerRegistry, ProductFeatureControllerRegistryRuntime, ProductFeatureControllerToken, } from "./controller/featureControllerRegistry";
-export type { CanvasProductControllerChange, CanvasProductControllerChangeKey, CanvasProductControllerChangeListener, CanvasProductShapeData, CanvasProductShapeUpdate, } from "./controller";
-export { SYSTEM_SELECTION_BRING_FORWARD_ACTION_ID, SYSTEM_SELECTION_BRING_TO_FRONT_ACTION_ID, SYSTEM_SELECTION_DELETE_ACTION_ID, SYSTEM_SELECTION_DUPLICATE_ACTION_ID, SYSTEM_SELECTION_FLIP_HORIZONTAL_ACTION_ID, SYSTEM_SELECTION_FLIP_VERTICAL_ACTION_ID, SYSTEM_SELECTION_GROUP_ACTION_ID, SYSTEM_SELECTION_RESET_ROTATION_ACTION_ID, SYSTEM_SELECTION_SELECT_ALL_ACTION_ID, SYSTEM_SELECTION_SEND_BACKWARD_ACTION_ID, SYSTEM_SELECTION_SEND_TO_BACK_ACTION_ID, SYSTEM_SELECTION_UNGROUP_ACTION_ID, runCanvasAction, } from "./features/actions/canvasActions";
-export { createToolbarProductContribution } from "./features/toolbar/toolbarContribution";
-export { createCanvasActionContext } from "./features/actions/canvasActionContext";
-export { getActiveToolLabel, getSelectionToolbarTitle, } from "./features/toolbar/toolbarLabels";
-export { SYSTEM_VIEW_RESET_ZOOM_ACTION_ID, SYSTEM_VIEW_ZOOM_IN_ACTION_ID, SYSTEM_VIEW_ZOOM_OUT_ACTION_ID, runContextMenuAction, } from "./features/context-menu/contextMenuActions";
-export { createContextMenuProductContribution } from "./features/context-menu/contextMenuContribution";
-export { createContextMenuContext, getContextMenuContributionTarget, } from "./features/context-menu/contextMenuContext";
-export { canvasClipboardServiceToken, memoryCanvasClipboardService, } from "./features/clipboard/clipboardService";
-export type { CanvasClipboardService } from "./features/clipboard/clipboardService";
-export { SYSTEM_CLIPBOARD_COPY_ACTION_ID, SYSTEM_CLIPBOARD_CUT_ACTION_ID, SYSTEM_CLIPBOARD_PASTE_ACTION_ID, SYSTEM_CLIPBOARD_PASTE_AT_POINT_ACTION_ID, createClipboardProductContribution, registerClipboardActions, } from "./features/clipboard/clipboardContribution";
-export { getCanvasClipboardService, } from "./features/clipboard/clipboardService";
-export { exportEditorSvg, getSvgExportStatus, } from "./features/export/svgExport";
-export type { ExportStatus, SvgAssetInliner, SvgExportOptions, SvgExportResult, } from "./features/export/svgExport";
+export type { ProductApiRegistry, ProductApiRegistryRuntime, ProductApiToken, } from "./api/apiRegistry";
+export type { CanvasProductControllerChange, CanvasProductControllerChangeKey, CanvasProductControllerChangeListener, CanvasProductCreatePageInput, CanvasProductDocumentRef, CanvasProductShapeData, CanvasProductShapeUpdate, } from "./product-controller";

package/core/{controller → product-controller}/canvasProductController.d.ts

@@ -1,6 +1,6 @@
 import type { Camera, ChangeSource, Editor, LayerOrderDirection, LayerOrderEdge, ReparentShapePlacementFailureReason, ShapeId } from "../../_vendor/canvas-core/index";
 import type { ProductServiceRegistry } from "../runtime/productServices";
-import type { ProductFeatureControllerRegistry } from "./featureControllerRegistry";
+import type { ProductApiRegistry } from "../api/apiRegistry";
 export interface CanvasProductShapeRef {
     id: ShapeId;
     type: string;
@@ -52,8 +52,13 @@ export interface CanvasProductSessionSnapshot<TToolId extends string = string> {
     isToolLocked: boolean;
     pages: CanvasProductSessionPageState[];
 }
+export interface CanvasProductDocumentRef {
+    id: string;
+    meta: Record<string, unknown>;
+}
 export interface CanvasProductControllerSnapshot<TToolId extends string = string> {
     productId: string;
+    document: CanvasProductDocumentRef;
     pageId: string;
     activeToolId: TToolId;
     selectedShapeIds: ShapeId[];
@@ -105,9 +110,14 @@ export interface CanvasProductPageRef {
     id: string;
     name: string;
     index: string;
+    meta: Record<string, unknown>;
+}
+export interface CanvasProductCreatePageInput {
+    name?: string;
+    meta?: Record<string, unknown>;
 }
 export interface CanvasProductController<TToolId extends string = string> {
-    features: ProductFeatureControllerRegistry;
+    apis: ProductApiRegistry;
     snapshot(): CanvasProductControllerSnapshot<TToolId>;
     subscribe(listener: CanvasProductControllerChangeListener<TToolId>): () => void;
     clearHistory(): void;
@@ -115,6 +125,8 @@ export interface CanvasProductController<TToolId extends string = string> {
     canRedo(): boolean;
     undo(): boolean;
     redo(): boolean;
+    getDocument(): CanvasProductDocumentRef;
+    updateDocumentMeta(patch: Record<string, unknown>): CanvasProductDocumentRef;
     select(ids: ShapeId[]): void;
     selectAll(): void;
     deleteSelection(): void;
@@ -139,8 +151,9 @@ export interface CanvasProductController<TToolId extends string = string> {
     setCamera(camera: Partial<Camera>, pageId?: string): void;
     resetView(): void;
     getPages(): CanvasProductPageRef[];
-    createPage(name?: string): CanvasProductPageRef;
+    createPage(input?: CanvasProductCreatePageInput): CanvasProductPageRef;
     renamePage(pageId: string, name: string): void;
+    updatePageMeta(pageId: string, patch: Record<string, unknown>): string | null;
     deletePage(pageId: string): boolean;
     selectPage(pageId: string): void;
     exportSelectionSvg(): string | null;
@@ -150,7 +163,7 @@ export interface CanvasProductControllerContext {
     editor: Editor;
     services: ProductServiceRegistry;
     pluginHostRuntime: unknown;
-    featureControllers: ProductFeatureControllerRegistry;
+    apis: ProductApiRegistry;
     productId: string;
 }
 export interface CanvasProductControllerOptions<TToolId extends string = string> extends CanvasProductControllerContext {

package/core/product-controller/index.d.ts

@@ -0,0 +1,2 @@
+export { createCanvasProductController } from "./canvasProductController";
+export type { CanvasProductController, CanvasProductControllerChange, CanvasProductControllerChangeKey, CanvasProductControllerChangeListener, CanvasProductControllerContext, CanvasProductControllerOptions, CanvasProductControllerSnapshot, CanvasProductCreatePageInput, CanvasProductDocumentRef, CanvasProductLayerActionState, CanvasProductLayerNode, CanvasProductLayerPlacement, CanvasProductLayerPlacementFailureReason, CanvasProductLayerPlacementResult, CanvasProductPageRef, CanvasProductShapeData, CanvasProductSessionPageState, CanvasProductSessionSnapshot, CanvasProductShapeRef, CanvasProductShapeUpdate, } from "./canvasProductController";