@yuzhouu/canvas-kit 0.1.3 → 0.1.4

package/README.md

@@ -1,102 +1,82 @@
 # @land/canvas-kit
 
-`@land/canvas-kit` 把 Land 画布打包成一个开箱即用的 React 画布套件，包含标准产品预设、插件集成和类型化 API。
+`@land/canvas-kit` is the public React SDK for the Land canvas kit. It includes the product runtime, built-in canvas extensions, image integration, persistence, chrome context, and typed controller surface behind one package root.
 
-发布包包含：
-
-- `CanvasKit`，用于直接嵌入标准画布套件
-- `createCanvasKitApi` 和 `CanvasKitApi`，用于编辑器自动化
-- `createCanvasKitProduct`，用于较底层的 `CanvasProductRoot` 产品组合
-- `@land/canvas-kit/product`，用于自定义产品 chrome
-- `@land/canvas-kit/standard`，用于标准内置插件扩展与类型化 API
-- 打包进发布产物的 Land 内部依赖
-- 作为 peer dependency 的 `react` 和 `react-dom`
-
-## 文档
-
-- [使用文档](./docs/使用文档.md) - 基于 `apps/professional` 和 `apps/zen` 示例的使用指南。
-- [API 文档](./docs/API文档.md) - `.`、`./product` 和 `./standard` 三个入口的完整 API 参考。
-
-## 安装
+## Install
 
 ```bash
 pnpm add @land/canvas-kit react react-dom
 ```
 
-## 使用
+## Basic Usage
 
 ```tsx
-import { useRef } from "react";
+import { useMemo } from "react";
 import {
-  CanvasKit,
-  type CanvasKitHandle,
+  CanvasKitRoot,
+  defineCanvasKit,
 } from "@land/canvas-kit";
 import "@land/canvas-kit/style.css";
 
 export function App() {
-  const apiRef = useRef<CanvasKitHandle>(null);
+  const product = useMemo(
+    () =>
+      defineCanvasKit({
+        onControllerReady(controller) {
+          console.log(controller.snapshot());
+        },
+      }),
+    [],
+  );
 
   return (
     <div style={{ width: "100%", height: "100vh" }}>
-      <CanvasKit
-        ref={apiRef}
-        onReady={(api) => {
-          console.log(api.snapshot());
-        }}
-      />
+      <CanvasKitRoot product={product} />
     </div>
   );
 }
 ```
 
-宿主容器需要提供明确尺寸。`CanvasKit` 会以 `width: 100%` 和 `height: 100%` 填满父容器。
-
-## 注意事项
-
-- 默认的 `canvas-kit` 产品包含画布表面、标准插件、产品运行时，以及插件自带的编辑 UI，例如文本行内格式工具条。
-- 它不会注册产品级 chrome 面板、工具栏或上下文菜单。
+The host element must provide a size. `CanvasKitRoot` fills the space provided by its parent and mounts the canvas runtime for the product.
 
-## 使用 `createCanvasKitProduct` 自定义 chrome
+## Custom Chrome
 
-`createCanvasKitProduct` 是围绕标准 Land 画布构建自定义产品壳的较底层组合入口。它负责编辑器运行时、标准插件、图片导入、剪贴板集成、持久化和 API 生命周期；你的应用只需要通过一个 `chrome(context)` 函数提供产品 UI。
+Use the `chrome` option when you want to provide your own toolbar, panels, or menus while keeping the kit runtime and built-in extensions.
 
 ```tsx
 import { useMemo } from "react";
-import { CanvasProductRoot } from "@land/canvas-product-react";
 import {
-  createCanvasKitProduct,
+  CanvasKitRoot,
+  defineCanvasKit,
+  type CanvasKitController,
   type CanvasKitChromeContext,
-} from "@land/canvas-kit/product";
-import { type CanvasKitApi } from "@land/canvas-kit";
+} from "@land/canvas-kit";
 import "@land/canvas-kit/style.css";
 
-function MyChrome({ context }: { context: CanvasKitChromeContext<CanvasKitApi> }) {
-  const { api, history, selectedShapeIds, selection, toolbarSurfaces, zoom } =
-    context;
-
+function MyChrome({
+  context,
+}: {
+  context: CanvasKitChromeContext<CanvasKitController>;
+}) {
   return (
     <>
-      <div className="my-topbar">
-        <button type="button" disabled={!history.canUndo} onClick={history.undo}>
-          撤销
-        </button>
-        <button type="button" onClick={zoom.zoomIn}>
-          放大
-        </button>
-        <button
-          type="button"
-          disabled={selection.count === 0}
-          onClick={() => api.deleteShapes([...selectedShapeIds])}
-        >
-          删除
-        </button>
-      </div>
-
-      {toolbarSurfaces.contextToolbarGroups.length > 0 ? (
-        <aside className="my-context-panel">
-          {toolbarSurfaces.contextToolbarTitle}
-        </aside>
-      ) : null}
+      <button
+        type="button"
+        disabled={!context.history.canUndo}
+        onClick={context.history.undo}
+      >
+        Undo
+      </button>
+      <button type="button" onClick={context.zoom.zoomIn}>
+        Zoom in
+      </button>
+      <button
+        type="button"
+        disabled={context.selection.count === 0}
+        onClick={() => context.controller.deleteShapes([...context.selectedShapeIds])}
+      >
+        Delete
+      </button>
     </>
   );
 }
@@ -104,41 +84,63 @@ function MyChrome({ context }: { context: CanvasKitChromeContext<CanvasKitApi> }
 export function App() {
   const product = useMemo(
     () =>
-      createCanvasKitProduct({
+      defineCanvasKit({
         chrome: (context) => <MyChrome context={context} />,
-        exposeApiOnWindow: true,
       }),
     [],
   );
 
   return (
     <div style={{ width: "100%", height: "100vh" }}>
-      <CanvasProductRoot product={product} />
+      <CanvasKitRoot product={product} />
     </div>
   );
 }
 ```
 
-如果要做 professional 风格的产品，可以围绕 `CanvasKitChromeContext` 添加自己的面板，并把文档改动保持在 `context.api` 上。chrome 不需要直接访问 `Editor`、`@land/canvas-core` 或 `@land/canvas-react/host`。
+Chrome should operate through `CanvasKitChromeContext` and `context.controller`. The product shell owns canvas mounting, so custom chrome should render controls and overlays rather than the canvas itself. It should not import `@land/canvas-core`, `@land/canvas-react`, built-in plugin packages, or kit internals.
 
-## 高级入口
+The package no longer exposes a one-component direct render entry. Apps should define a product with `defineCanvasKit` and render it through `CanvasKitRoot`.
 
-包根入口会刻意保持精简。较底层的产品套件辅助方法请从显式子路径导入：
+## Local Persistence
 
-```tsx
-import { createCanvasKitProduct } from "@land/canvas-kit/product";
-import { standardCanvasExtensions } from "@land/canvas-kit/standard";
-```
+Default browser persistence restores supported records even when a saved
+snapshot also contains unsupported shape or binding types. Unsupported raw
+records are preserved outside the live editor and merged back into future saves.
+When this happens, `CanvasKitRoot` shows a persistence notice and custom
+chrome can inspect `context.persistence.status` or call
+`context.persistence.discardUnsupportedRecords?.()` after explicit user
+confirmation.
+
+## Internal Assembly
+
+The public product remains opaque. Internally, `defineCanvasKit()` resolves options into explicit product fields:
+
+- `LandExtension[]` installs editor/canvas plugins through `@land/canvas-react/host`.
+- `CanvasKitHostExtension[]` installs product-host behavior such as clipboard, toolbar, context menu, image import, asset URL resolution, SVG asset inlining, and controller components.
+- Service factories and asset resolver tokens wire product-level services into runtime.
+- `CanvasKitRuntime` creates services, the plugin host runtime, the editor, controller registry, and then runs product runtime setup.
+
+This keeps app chrome on the root package controller while keeping browser-specific host behavior out of concrete shape plugins and out of `canvas-core`.
+
+## Public Exports
+
+The published package intentionally exposes only:
+
+- `@land/canvas-kit`
+- `@land/canvas-kit/style.css`
+
+Package subpaths are internal implementation details.
 
-## 本仓库本地构建
+## Local Build
 
-从 workspace 根目录执行：
+Run from the workspace root:
 
 ```bash
 pnpm build:canvas-kit:bundle
 ```
 
-可发布产物会写入：
+The publish-ready output is written to:
 
 ```text
 packages/canvas-kit/dist-component/

package/_vendor/canvas-core/bindings/{BindingUtil.d.ts → bindingUtil.d.ts}

@@ -1,4 +1,4 @@
-import type { Editor } from "../editor/Editor";
+import type { Editor } from "../editor/editor";
 import type { SelectionOverlayFrameGeometryState } from "../editor/selection";
 import type { BindingId, BindingRecord, BindingRecordBase, ShapeRecord } from "../schema/records";
 export interface BindingUtilEffect {

package/_vendor/canvas-core/bindings/{BindingUtilRegistry.d.ts → bindingUtilRegistry.d.ts}

@@ -1,5 +1,5 @@
 import type { BindingRecordBase } from "../schema/records";
-import { BindingUtil } from "./BindingUtil";
+import { BindingUtil } from "./bindingUtil";
 export declare class BindingUtilRegistry {
     private readonly registry;
     register<B extends BindingRecordBase>(util: BindingUtil<B>): void;

package/_vendor/canvas-core/bindings/terminalBinding.d.ts

@@ -0,0 +1,28 @@
+import { Vec } from "../geometry/vec";
+import type { Editor } from "../editor/editor";
+import type { BindingPreviewState } from "../editor/selection";
+import type { ShapeId } from "../schema/records";
+export interface ConnectionPoint {
+    x: number;
+    y: number;
+}
+export type ConnectionTerminal = "start" | "end";
+export interface TerminalBindingTargetInput {
+    targetShapeId: ShapeId;
+    normalizedAnchor: ConnectionPoint;
+}
+export interface ResolvedTerminalBinding {
+    pagePoint: Vec;
+    binding: TerminalBindingTargetInput | null;
+    preview: BindingPreviewState | null;
+}
+export interface TerminalBindingResolverInput {
+    terminal: ConnectionTerminal;
+    rawPagePoint: Vec;
+    oppositePagePoint: Vec;
+    excludeShapeId?: ShapeId;
+    ignoreTargets?: boolean;
+}
+export type TerminalBindingResolver = (editor: Editor, input: TerminalBindingResolverInput) => ResolvedTerminalBinding;
+export declare function getFreeTerminalBinding({ rawPagePoint, }: TerminalBindingResolverInput): ResolvedTerminalBinding;
+export declare function resolveTerminalBindingAtPoint(editor: Editor, input: TerminalBindingResolverInput): ResolvedTerminalBinding;

package/_vendor/canvas-core/editor/clipboard.d.ts

@@ -1,7 +1,7 @@
 import type { ChangeSource } from "../../store/index";
-import { Vec } from "../geometry/Vec";
+import { Vec } from "../geometry/vec";
 import type { AssetId, AssetRecord, BindingRecord, ShapeId, ShapeRecord } from "../schema/records";
-import type { Editor } from "./Editor";
+import type { Editor } from "./editor";
 export interface EditorClipboardPayload {
     type: "land/clipboard";
     version: 1;

package/_vendor/canvas-core/editor/commands.d.ts

@@ -1,4 +1,4 @@
-import type { Editor } from "./Editor";
+import type { Editor } from "./editor";
 import type { ChangeSource } from "../../store/index";
 import type { AssetId, AssetRecord, AssetRecordBase, BindingId, BindingRecordBase, BindingRecord, Camera, PageId, PageRecord, ShapeId, ShapeParentId, ShapeRecordBase, ShapeRecord, ShapeEditingEntryMode } from "../schema/records";
 export interface EditorCommandOptions {
@@ -37,6 +37,7 @@ export interface ShapeUpdate {
     rotation?: number;
     scaleX?: number;
     scaleY?: number;
+    opacity?: number;
     isHidden?: boolean;
     isLocked?: boolean;
     parentId?: ShapeParentId;
@@ -103,6 +104,10 @@ export interface EditorCommands {
      */
     createShapesFromRecords(records: ShapeRecord[], options?: EditorCommandOptions): ShapeRecord[];
     updateShapes(updates: ShapeUpdate[], options?: EditorCommandOptions): void;
+    /**
+     * Move shapes to a new parent, appending shapes that are entering that parent
+     * to the end of its child order in the order provided by `ids`.
+     */
     reparentShapes(input: ReparentShapesInput, options?: EditorCommandOptions): void;
     deleteShapes(ids: ShapeId[], options?: EditorCommandOptions): void;
     createAsset(input: CreateAssetInput, options?: EditorCommandOptions): AssetRecord;

package/_vendor/canvas-core/editor/createEditorWithPlugins.d.ts

@@ -0,0 +1,6 @@
+import { type LandEditorPlugin } from "../plugins";
+import { Editor, type EditorOptions } from "./editor";
+export interface CreateEditorWithPluginsOptions extends Omit<EditorOptions, "shapeUtils" | "shapeSvgExporters" | "bindingUtils" | "shapeCapabilities"> {
+    editorPlugins?: readonly LandEditorPlugin[];
+}
+export declare function createEditorWithPlugins(options?: CreateEditorWithPluginsOptions): Editor;

package/_vendor/canvas-core/editor/edgeScroll.d.ts

@@ -1,4 +1,4 @@
-import { Vec } from "../geometry/Vec";
+import { Vec } from "../geometry/vec";
 export declare function getEdgeScrollDelta(screenPoint: Vec, viewportSize: {
     w: number;
     h: number;

package/_vendor/canvas-core/editor/{Editor.d.ts → editor.d.ts}

@@ -1,46 +1,47 @@
 import { type Signal } from "../../signals/index";
-import type { ArrowTerminalBindingResolver, ArrowTerminalBindingResolverInput, ResolvedArrowTerminalBinding } from "../bindings/arrow/arrowBindingHelpers";
-import type { BindingUtil } from "../bindings/BindingUtil";
-import { BindingUtilRegistry } from "../bindings/BindingUtilRegistry";
-import { Box } from "../geometry/Box";
-import { Mat } from "../geometry/Mat";
-import { Vec } from "../geometry/Vec";
+import type { TerminalBindingResolver, TerminalBindingResolverInput, ResolvedTerminalBinding } from "../bindings/terminalBinding";
+import type { BindingUtil } from "../bindings/bindingUtil";
+import { BindingUtilRegistry } from "../bindings/bindingUtilRegistry";
+import { Box } from "../geometry/box";
+import { Mat } from "../geometry/mat";
+import { Vec } from "../geometry/vec";
 import { type BindingId, type BindingRecord, type AssetId, type AssetRecord, type Camera, type PageId, type PageRecord, type EditorRecord, type RecordScope, type SessionRecord, type ShapeId, type ShapeParentId, type ShapeRecord, type ShapeEditingEntryRequest, type ShapeEditingSession } from "../schema/records";
 import { type DocumentSnapshot, type SessionSnapshot } from "../schema/snapshots";
-import type { ShapeSelectionFlipAxis, ShapeUtil } from "../shapes/ShapeUtil";
-import { ShapeUtilRegistry } from "../shapes/ShapeUtilRegistry";
+import type { ShapeSelectionFlipAxis, ShapeUtil } from "../shapes/shapeUtil";
+import { ShapeUtilRegistry } from "../shapes/shapeUtilRegistry";
 import { ShapeSvgExporterRegistry, type ShapeSvgExporter, type SvgExportOptions, type SvgExportResult } from "../exports/svg";
 import { type ExportIntegrityRepairResult, type ExportIntegrityReport } from "../exports/integrity";
 import { type ShapeCapabilityDefinition, type ShapeCapabilityManifest } from "../shapes/capabilities";
 import { Store, type ChangeSource, type StoreChange } from "../../store/index";
 import { type CreateAssetInput, type CreateBindingInput, type CreatePageInput, type CreateShapeInput, type StartEditingShapeInput, type EditorCommands } from "./commands";
 import type { CancelEditorEvent, EditorEvent } from "./events";
-import { HistoryManager, type HistoryState } from "./HistoryManager";
-import { BindingManager } from "./managers/BindingManager";
-import { CameraManager } from "./managers/CameraManager";
-import { ClipboardManager } from "./managers/ClipboardManager";
-import { DocumentSnapshotManager } from "./managers/DocumentSnapshotManager";
-import { InputsManager } from "./managers/InputsManager";
-import { InteractionTransientManager, type LaserTrailState } from "./managers/InteractionTransientManager";
-import { QueryManager, type ShapeContainment } from "./managers/QueryManager";
-import { SpatialIndexManager, type ShapeAtPointOptions, type ShapeLineSegmentHitTestOptions, type SpatialQueryOptions } from "./managers/SpatialIndexManager";
-import { SnapManager } from "./managers/SnapManager";
-import { SideEffectManager } from "./managers/SideEffectManager";
-import { SelectionLayoutManager } from "./managers/SelectionLayoutManager";
-import { SelectionManager } from "./managers/SelectionManager";
-import { SelectionOverlayManager } from "./managers/SelectionOverlayManager";
-import { ShapeEditingManager } from "./managers/ShapeEditingManager";
-import { ShapeGeometryManager } from "./managers/ShapeGeometryManager";
-import { ShapeHierarchyManager } from "./managers/ShapeHierarchyManager";
-import { RenderWindowManager } from "./managers/RenderWindowManager";
-import { ToolManager } from "./managers/ToolManager";
+import { HistoryManager, type HistoryState } from "./historyManager";
+import { BindingManager } from "./managers/bindingManager";
+import { CameraManager } from "./managers/cameraManager";
+import { ClipboardManager } from "./managers/clipboardManager";
+import { DocumentSnapshotManager } from "./managers/documentSnapshotManager";
+import { InputsManager } from "./managers/inputsManager";
+import { InteractionTransientManager, type LaserTrailState } from "./managers/interactionTransientManager";
+import { QueryManager, type ShapeContainment } from "./managers/queryManager";
+import { SpatialIndexManager, type ShapeAtPointOptions, type ShapeLineSegmentHitTestOptions, type SpatialQueryOptions } from "./managers/spatialIndexManager";
+import { SnapManager } from "./managers/snapManager";
+import { SideEffectManager } from "./managers/sideEffectManager";
+import { SelectionLayoutManager } from "./managers/selectionLayoutManager";
+import { SelectionManager } from "./managers/selectionManager";
+import { SelectionOverlayManager } from "./managers/selectionOverlayManager";
+import { ShapeEditingManager } from "./managers/shapeEditingManager";
+import { ShapeGeometryManager } from "./managers/shapeGeometryManager";
+import { ShapeHierarchyManager } from "./managers/shapeHierarchyManager";
+import { ShortcutManager } from "./managers/shortcutManager";
+import { RenderWindowManager } from "./managers/renderWindowManager";
+import { ToolManager } from "./managers/toolManager";
 import type { ShapeGeometry } from "./queries/shapeTransforms";
 import { editorStoreSymbol } from "./internal";
 import type { DuplicateSelectionInput, EditorClipboardPayload, PasteClipboardPayloadInput } from "./clipboard";
 import { InteractionHandlerRegistry } from "./interactions";
 import { SelectionHandleInteractionRegistry } from "./selectionHandleInteractions";
 import { type SelectedShapeOverlayItem } from "./selectionOverlay";
-import type { ArrowBindingPreviewState, SnapIndicatorState, SelectionHandle, SelectionFrame, SelectionOverlayFrameState, SelectionOverlayFrameGeometryState, SelectionOverlayFrameStyleState, SelectionOverlayHandleAnchorsState, SelectionOverlayHandleCountsState, SelectionOverlayHandlesState, SelectionOverlayState } from "./selection";
+import type { BindingPreviewState, SnapIndicatorState, SelectionBindingSegment, SelectionHandle, SelectionFrame, SelectionOverlayFrameState, SelectionOverlayFrameGeometryState, SelectionOverlayFrameStyleState, SelectionOverlayHandleAnchorsState, SelectionOverlayHandleCountsState, SelectionOverlayHandlesState, SelectionOverlayState } from "./selection";
 export interface EditorOptions {
     shapeUtils?: ShapeUtil[];
     shapeSvgExporters?: ShapeSvgExporter[];
@@ -103,19 +104,6 @@ export interface ShapeGroupState {
     shapeIds: ShapeId[];
     bounds: Box;
 }
-export interface LayerTreeNode {
-    id: ShapeId;
-    parentId: ShapeParentId;
-    pageId: PageId;
-    type: ShapeRecord["type"];
-    childIds: ShapeId[];
-    index: number;
-    depth: number;
-    isHidden: boolean;
-    isLocked: boolean;
-    isEffectivelyHidden: boolean;
-    isEffectivelyLocked: boolean;
-}
 export type LayerOrderDirection = "backward" | "forward";
 export type LayerOrderEdge = "back" | "front";
 export type ShapePropsPatch = Record<string, unknown>;
@@ -140,7 +128,7 @@ export interface EditorSelectionState {
     frameBounds: Box | null;
     frameRotation: number;
     frameRotationCenter: Vec | null;
-    toolbarAnchorPagePoint: Vec | null;
+    selectionAnchorPagePoint: Vec | null;
 }
 export interface EditorRenderHostDebugState {
     culledCount: number;
@@ -180,6 +168,7 @@ export interface EditorOverlayDebugState {
 interface ReadonlyStore {
     readonly recordsSignal: Signal<Map<string, EditorRecord>>;
     get(id: string): EditorRecord | undefined;
+    getRecordSignal(id: string): Signal<EditorRecord | undefined>;
     getAll(): EditorRecord[];
     getByScope(scope: RecordScope): EditorRecord[];
     listen(listener: (change: StoreChange<EditorRecord>) => void): () => void;
@@ -190,6 +179,7 @@ export declare class Editor {
     readonly inputs: InputsManager;
     readonly snapshots: DocumentSnapshotManager;
     readonly clipboard: ClipboardManager;
+    readonly shortcuts: ShortcutManager;
     readonly tools: ToolManager;
     readonly camera: CameraManager;
     readonly selection: SelectionManager;
@@ -221,9 +211,10 @@ export declare class Editor {
     readonly eraserTrailActiveSignal: Signal<boolean>;
     readonly laserTrailSignal: Signal<LaserTrailState | null>;
     readonly laserTrailActiveSignal: Signal<boolean>;
-    readonly bindingPreviewSignal: Signal<ArrowBindingPreviewState | null>;
+    readonly bindingPreviewSignal: Signal<BindingPreviewState | null>;
     readonly bindingPreviewActiveSignal: Signal<boolean>;
     readonly dropTargetShapeIdSignal: Signal<ShapeId | null>;
+    readonly selectionTranslationActiveSignal: Signal<boolean>;
     readonly snapIndicatorsSignal: Signal<SnapIndicatorState[]>;
     readonly snapIndicatorsActiveSignal: Signal<boolean>;
     get viewportScreenSizeSignal(): Signal<{
@@ -248,7 +239,7 @@ export declare class Editor {
     readonly retainedShapeIdsSignal: Signal<ShapeId[]>;
     readonly selectionPageBoundsSignal: Signal<Box | null>;
     readonly selectionFrameBoundsSignal: Signal<Box | null>;
-    readonly selectionToolbarAnchorPagePointSignal: Signal<Vec | null>;
+    readonly selectionAnchorPagePointSignal: Signal<Vec | null>;
     readonly pagesSignal: import("../../signals/index").Computed<PageRecord[]>;
     readonly currentPageSignal: import("../../signals/index").Computed<PageRecord | null>;
     readonly pageStateSignal: import("../../signals/index").Computed<EditorPageState>;
@@ -288,7 +279,8 @@ export declare class Editor {
     private currentPointerClickCount;
     readonly selectionOverlayFrameGeometrySignal: Signal<SelectionOverlayFrameGeometryState | null>;
     readonly selectionOverlayCompanionFrameGeometriesSignal: Signal<SelectionOverlayFrameGeometryState[]>;
-    readonly selectionOverlayArrowPathSignal: Signal<string | null>;
+    readonly selectionOverlayPathSignal: Signal<string | null>;
+    readonly selectionOverlayBindingSegmentsSignal: Signal<SelectionBindingSegment[]>;
     readonly selectionOverlayFrameStyleSignal: Signal<SelectionOverlayFrameStyleState>;
     readonly selectionOverlayFrameSignal: Signal<SelectionOverlayFrameState | null>;
     readonly selectionOverlayHandleAnchorsSignal: Signal<SelectionOverlayHandleAnchorsState | null>;
@@ -297,9 +289,12 @@ export declare class Editor {
     readonly selectionOverlaySignal: Signal<SelectionOverlayState | null>;
     readonly overlayDebugStateSignal: Signal<EditorOverlayDebugState>;
     constructor(options?: EditorOptions);
+    private registerBuiltInShortcuts;
     private registerBuiltInSideEffects;
     dispatch(event: EditorEvent): void;
     handleInteractionEvent(event: EditorEvent): boolean;
+    private runKeyboardShortcutTarget;
+    private runEditorKeyboardShortcut;
     private normalizeEvent;
     private getDoubleClickEvent;
     listen(listener: (change: StoreChange<EditorRecord>) => void): () => void;
@@ -336,8 +331,6 @@ export declare class Editor {
     getSelectionParentOrderState(): ShapeSelectionSiblingOrderState | null;
     getSelectionGroupState(): ShapeGroupState | null;
     canGroupSelection(): boolean;
-    getLayerTree(pageId?: PageId): LayerTreeNode[];
-    getLayerNode(id: ShapeId): LayerTreeNode | null;
     canGroupShapes(ids: readonly ShapeId[]): boolean;
     groupShapes(ids: readonly ShapeId[], source?: ChangeSource): ShapeRecord | null;
     groupSelection(source?: ChangeSource): ShapeRecord | null;
@@ -421,6 +414,7 @@ export declare class Editor {
     getShapeExportTraversalIds(shapeIds: Iterable<ShapeId>): ShapeId[];
     getShapeContainment(containerId: ShapeId, shapeId: ShapeId): ShapeContainment | null;
     getContainingShapeParentId(shapeIds: Iterable<ShapeId>): ShapeParentId | null;
+    getContainingShapeParentIdAtPoint(shapeIds: Iterable<ShapeId>, point: Vec): ShapeParentId | null;
     getContainingParentIdForShapeRecord(shape: ShapeRecord): ShapeParentId | null;
     getShapeClipAncestorIds(shapeId: ShapeId): ShapeId[];
     getShapeClipAncestorIdsSignal(shapeId: ShapeId): Signal<ShapeId[]>;
@@ -456,7 +450,7 @@ export declare class Editor {
     isPointInSelectionBounds(point: Vec): boolean;
     getSelectionFrameLocalBoundsPoint(point: Vec): Vec | null;
     getSelectionPageOutlineVertices(): Vec[];
-    getSelectionToolbarAnchorPagePoint(): Vec | null;
+    getSelectionAnchorPagePoint(): Vec | null;
     hitTestSelectionHandle(point: Vec): SelectionHandle | null;
     setBrushBox(brushBox: Box | null): void;
     getErasingShapeIds(): ShapeId[];
@@ -469,11 +463,12 @@ export declare class Editor {
     setLaserTrail(sessionId: number, points: readonly Vec[]): void;
     finishLaserTrail(sessionId: number): void;
     clearLaserTrail(sessionId: number): void;
-    setBindingPreview(preview: ArrowBindingPreviewState | null): void;
+    setBindingPreview(preview: BindingPreviewState | null): void;
     setDropTargetShapeId(shapeId: ShapeId | null): void;
+    setSelectionTranslationActive(active: boolean): void;
     setSnapIndicators(indicators: SnapIndicatorState[] | null): void;
-    setArrowTerminalBindingResolver(resolver: ArrowTerminalBindingResolver): void;
-    resolveArrowTerminalBinding(input: ArrowTerminalBindingResolverInput): ResolvedArrowTerminalBinding;
+    setTerminalBindingResolver(resolver: TerminalBindingResolver): void;
+    resolveTerminalBinding(input: TerminalBindingResolverInput): ResolvedTerminalBinding;
     clearSelectionTransients(): void;
     hitTestShape(point: Vec): ShapeRecord | null;
     hitTestShapesAtPoint(point: Vec, options?: ShapeAtPointOptions): ShapeRecord[];

package/_vendor/canvas-core/editor/editorComputedHelpers.d.ts

@@ -1,8 +1,8 @@
-import type { Box } from "../geometry/Box";
-import type { Vec } from "../geometry/Vec";
+import type { Box } from "../geometry/box";
+import type { Vec } from "../geometry/vec";
 import type { AssetId, PageId, ShapeId, ShapeRecord } from "../schema/records";
-import type { ArrowBindingPreviewState } from "./selection";
-import type { EditorOverlayDebugState, EditorRenderHostDebugState, RenderItem } from "./Editor";
+import type { BindingPreviewState } from "./selection";
+import type { EditorOverlayDebugState, EditorRenderHostDebugState, RenderItem } from "./editor";
 export declare function areShapeIdArraysEqual(a: ShapeId[], b: ShapeId[]): boolean;
 export declare function areVecsEqual(a: Vec | null, b: Vec | null): boolean;
 export declare function areVecArraysEqual(a: readonly Vec[], b: readonly Vec[]): boolean;
@@ -12,7 +12,7 @@ export declare function areRenderHostDebugStatesEqual(a: EditorRenderHostDebugSt
 export declare function areOverlayDebugStatesEqual(a: EditorOverlayDebugState, b: EditorOverlayDebugState): boolean;
 export declare function getBoxDebugSummary(box: Box | null): string;
 export declare function getShapePageIdFromParentChain(shape: ShapeRecord, shapeById: ReadonlyMap<ShapeId, ShapeRecord>, pageIds: ReadonlySet<PageId>): PageId | null;
-export declare function areBindingPreviewStatesEqual(a: ArrowBindingPreviewState | null, b: ArrowBindingPreviewState | null): boolean;
+export declare function areBindingPreviewStatesEqual(a: BindingPreviewState | null, b: BindingPreviewState | null): boolean;
 export declare function areRenderItemsEqual(a: RenderItem[], b: RenderItem[]): boolean;
 export declare function areShapeIdSetsEqual(a: Set<ShapeId>, b: Set<ShapeId>): boolean;
 export declare function getCommonShapeType(shapes: readonly ShapeRecord[]): ShapeRecord["type"] | null;

package/_vendor/canvas-core/editor/editorSelectionTransforms.d.ts

@@ -1,6 +1,6 @@
 import type { ChangeSource } from "../../store/index";
-import type { ShapeSelectionFlipAxis } from "../shapes/ShapeUtil";
+import type { ShapeSelectionFlipAxis } from "../shapes/shapeUtil";
 import type { ShapeUpdate } from "./commands";
-import type { Editor } from "./Editor";
+import type { Editor } from "./editor";
 export declare function resetEditorSelectionRotation(editor: Editor, source?: ChangeSource): void;
 export declare function getEditorSelectionFlipUpdates(editor: Editor, axis: ShapeSelectionFlipAxis): ShapeUpdate[];

package/_vendor/canvas-core/editor/events.d.ts

@@ -1,4 +1,4 @@
-import type { Vec } from "../geometry/Vec";
+import type { Vec } from "../geometry/vec";
 export type EditorPointerType = "mouse" | "touch" | "pen";
 export type EditorClickEventName = "double_click";
 export interface PointerEditorEvent {

package/_vendor/canvas-core/editor/{HistoryManager.d.ts → historyManager.d.ts}

@@ -1,6 +1,6 @@
 import { type StoreHistoryEntry, type StoreHistoryState } from "../../store/index";
 import { type DocumentRecord } from "../schema/records";
-import type { Editor } from "./Editor";
+import type { Editor } from "./editor";
 export type HistoryState = StoreHistoryState;
 export declare class HistoryManager {
     private readonly editor;

package/_vendor/canvas-core/editor/index.d.ts

@@ -1,8 +1,11 @@
-export { Editor } from "./Editor";
-export { StateNode } from "./StateNode";
-export { HistoryManager } from "./HistoryManager";
-export { InputsManager } from "./managers/InputsManager";
-export { QueryManager } from "./managers/QueryManager";
-export { SpatialIndexManager, type ShapeAtPointOptions, type SpatialQueryOptions, } from "./managers/SpatialIndexManager";
-export { ToolManager } from "./managers/ToolManager";
+export { Editor } from "./editor";
+export { createEditorWithPlugins, type CreateEditorWithPluginsOptions, } from "./createEditorWithPlugins";
+export { StateNode } from "./stateNode";
+export { HistoryManager } from "./historyManager";
+export { InputsManager } from "./managers/inputsManager";
+export { QueryManager } from "./managers/queryManager";
+export { ShortcutManager, formatKeyboardShortcut, normalizeKeyboardShortcut, } from "./managers/shortcutManager";
+export type { EditorKeyboardShortcutCommand, KeyboardShortcutBinding, KeyboardShortcutChord, KeyboardShortcutEventLike, KeyboardShortcutInput, KeyboardShortcutTarget, } from "./managers/shortcutManager";
+export { SpatialIndexManager, type ShapeAtPointOptions, type SpatialQueryOptions, } from "./managers/spatialIndexManager";
+export { ToolManager } from "./managers/toolManager";
 export type { EditorEvent } from "./events";

package/_vendor/canvas-core/editor/interactions.d.ts

@@ -1,7 +1,7 @@
 import type { ChangeSource } from "../../store/index";
-import type { Vec } from "../geometry/Vec";
+import type { Vec } from "../geometry/vec";
 import type { ShapeId, ShapeRecord } from "../schema/records";
-import type { Editor } from "./Editor";
+import type { Editor } from "./editor";
 import type { EditorEvent } from "./events";
 import type { SelectionHandle } from "./selection";
 import type { HandleSnapContext, HandleSnapMode } from "./managers/snapTypes";

package/_vendor/canvas-core/editor/internal.d.ts

@@ -1,4 +1,4 @@
-import type { Editor } from "./Editor";
+import type { Editor } from "./editor";
 import type { Store } from "../../store/index";
 import type { EditorRecord } from "../schema/records";
 declare const editorStoreSymbol: unique symbol;

package/_vendor/canvas-core/editor/managers/{BindingManager.d.ts → bindingManager.d.ts}

@@ -1,6 +1,6 @@
 import type { ChangeSource } from "../../../store/index";
 import { type BindingId, type BindingRecord, type ShapeId, type ShapeRecord } from "../../schema/records";
-import type { Editor } from "../Editor";
+import type { Editor } from "../editor";
 export interface ShapeChangeEntry {
     before: ShapeRecord;
     after: ShapeRecord;

package/_vendor/canvas-core/editor/managers/{CameraManager.d.ts → cameraManager.d.ts}

@@ -1,9 +1,9 @@
 import { type Signal } from "../../../signals/index";
 import type { ChangeSource } from "../../../store/index";
-import { Vec } from "../../geometry/Vec";
+import { Vec } from "../../geometry/vec";
 import { type Camera } from "../../schema/records";
 import type { PageId } from "../../schema/records";
-import type { Editor } from "../Editor";
+import type { Editor } from "../editor";
 /**
  * Camera and viewport-screen-size state for the editor. Owns the viewport size
  * atom (viewport + camera together define the page<->screen transform) and the