@yuzhouu/canvas-kit 0.1.2

package/_vendor/canvas-core/index.ts

@@ -0,0 +1,391 @@
+export { Editor } from "./editor/Editor";
+export {
+  distanceBetweenSegments,
+  distanceToSegment,
+  nearestPointOnSegment,
+  segmentsIntersect,
+} from "./geometry";
+export {
+  getShapeGeometry,
+  getShapeExportBounds,
+  getShapeExportPageBounds,
+  getShapeExportToPageTransform,
+  getShapeLocalBounds,
+  getShapeLocalToPageTransform,
+  getShapePositionedOutlineVertices,
+  getShapePositionedToPageTransform,
+  getShapePageBounds,
+  getShapePageCenter,
+  getShapePageCorners,
+  getShapePageOutlineVertices,
+  pagePointToShapePositionedPoint,
+  positionedShapePointToPagePoint,
+  getShapeRenderBounds,
+  getShapeRenderToPageTransform,
+} from "./editor/queries/shapeTransforms";
+export type { ShapeGeometry } from "./editor/queries/shapeTransforms";
+export type {
+  ArrowBindingPreviewState,
+  GapSnapIndicatorGapState,
+  GapSnapIndicatorState,
+  PointSnapIndicatorState,
+  SnapIndicatorState,
+  SelectionArrowMiddleHandle,
+  SelectionArrowMiddleHandleAnchor,
+  SelectionArrowTerminalHandle,
+  SelectionArrowTerminalHandleAnchor,
+  SelectionCustomHandle,
+  SelectionCustomHandleAnchor,
+  SelectionHandle,
+  SelectionOverlayFrameState,
+  SelectionOverlayFrameGeometryState,
+  SelectionOverlayFrameStyleState,
+  SelectionOverlayHandleAnchorsState,
+  SelectionOverlayHandleCountsState,
+  SelectionOverlayHandlesState,
+  SelectionOverlayState,
+  SelectionResizeHandle,
+  SelectionResizeHandleAnchor,
+  SelectionResizeHandleId,
+  SelectionRotateHandle,
+  SelectionRotateHandleAnchor,
+  SelectionRotateHandleId,
+  SelectionMirrorAxis,
+} from "./editor/selection";
+export {
+  flipSelectionLocalBounds,
+  getSelectionLocalBoundsFromPagePoints,
+  mapSelectionLocalBoundsBetweenBounds,
+  mapSelectionLocalPointBetweenBounds,
+  mirrorSelectionLocalPoint,
+  rotateSelectionPagePoint,
+  selectionLocalPointToPagePoint,
+  selectionPagePointToLocalPoint,
+} from "./editor/selection";
+export {
+  getAnchoredSelectionResizeLocalBounds,
+  getAspectRatioLockedSelectionResizeBounds,
+  getCenteredSelectionResizeBounds,
+  getConstrainedSelectionResizeBounds,
+  getSelectionResizeBounds,
+  getSelectionResizeScalesFromBounds,
+  isSelectionResizeCorner,
+  normalizeSelectionResizeBoundsFromEdges,
+  selectionResizeHandleMovesBottomEdge,
+  selectionResizeHandleMovesLeftEdge,
+  selectionResizeHandleMovesRightEdge,
+  selectionResizeHandleMovesTopEdge,
+} from "./editor/resizeGeometry";
+export { InteractionHandlerRegistry } from "./editor/interactions";
+export { SelectionHandleInteractionRegistry } from "./editor/selectionHandleInteractions";
+export type {
+  EditorEventInteractionDecision,
+  EditorEventInteractionHandler,
+  LandInteractionHandler,
+  SelectionHandleInteractionHandler,
+  SelectionHandleInteractionInput,
+  SelectionHandleInteractionSession,
+  SelectionHandleInteractionUpdateResult,
+} from "./editor/interactions";
+export type {
+  ContainerBoundsQueryOptions,
+  EditorPageState,
+  EditorOverlayDebugState,
+  EditorRenderHostDebugState,
+  EditorSelectionState,
+  LayerOrderDirection,
+  LayerOrderEdge,
+  LayerTreeNode,
+  ReparentShapePlacementInput,
+  ReparentShapePlacementFailureReason,
+  ReparentShapePlacementResult,
+  ShapeSiblingOrderDirection,
+  ShapeSiblingOrderEdge,
+  ShapeSiblingOrderState,
+  ShapeGroupState,
+  ShapeSelectionSiblingOrderState,
+  ShapePropsPatch,
+  EditorToolState,
+  EditorShapeEditingState,
+} from "./editor/Editor";
+export type { ShapeContainment } from "./editor/managers/QueryManager";
+export type {
+  ShapeAtPointOptions,
+  ShapeLineSegmentHitTestOptions,
+  SpatialQueryOptions,
+} from "./editor/managers/SpatialIndexManager";
+export type {
+  ArrowBindingTargetInput,
+  ConnectionPoint,
+  ConnectionTerminal,
+  ArrowTerminalBindingResolver,
+  ArrowTerminalBindingResolverInput,
+  ResolvedArrowTerminalBinding,
+} from "./bindings/arrow/arrowBindingHelpers";
+export type {
+  EditorCommandOptions,
+  EditorCommands,
+  CreateAssetInput,
+  CreateBindingInput,
+  CreatePageInput,
+  MovePageInput,
+  RenamePageInput,
+  ReparentShapesInput,
+  CreateShapeInput,
+  SetCameraInput,
+  ShapeUpdate,
+  StartEditingShapeInput,
+  UpdateAssetInput,
+  UpdateBindingInput,
+} from "./editor/commands";
+export { reparentShapeToContainingParent } from "./editor/commands";
+export {
+  isEditorClipboardPayload,
+} from "./editor/clipboard";
+export type {
+  ClipboardAssetSidecar,
+  DuplicateSelectionInput,
+  EditorClipboardPayload,
+  PasteClipboardPayloadInput,
+} from "./editor/clipboard";
+export type {
+  EditorEvent,
+  ClickEditorEvent,
+  PointerEditorEvent,
+  KeyboardEditorEvent,
+  WheelEditorEvent,
+  TickEditorEvent,
+  CancelEditorEvent,
+  EditorPointerType,
+} from "./editor/events";
+export type {
+  ChangeSource,
+  RecordUpdate,
+  RecordsDiff,
+  ScopedStoreRecord,
+  StoreRecord,
+  StoreChange,
+  StoreScopeOf,
+  StoreSnapshot,
+} from "@land/store";
+export {
+  composeRecordsDiff,
+  createEmptyRecordsDiff,
+  filterRecordsDiff,
+  getRecordMap,
+  getRecordsDiff,
+  hasRecordsDiff,
+  invertRecordsDiff,
+  squashRecordsDiffs,
+} from "@land/store";
+export {
+  appendStoreHistoryMark,
+  createStoreHistoryEntry,
+  createStoreHistoryMark,
+  Store,
+  StoreHistoryBuffer,
+} from "@land/store";
+export type {
+  StoreHistoryEntry,
+  StoreHistoryMark,
+  StoreHistoryState,
+} from "@land/store";
+export {
+  SnapshotParseError,
+  parseDocumentSnapshot,
+  parseSessionSnapshot,
+  migrateSnapshotRecords,
+} from "./schema/snapshots";
+export type {
+  DocumentSnapshot,
+  SessionSnapshot,
+  SnapshotMigration,
+} from "./schema/snapshots";
+export { ShapeUtil } from "./shapes/ShapeUtil";
+export type {
+  ShapeBoundsSnapGeometry,
+  ShapeBrushSelectInput,
+  ShapeBrushWrapInput,
+  ShapeBindingPointInput,
+  ShapeEditEndResult,
+  ShapeHandleSnapContext,
+  ShapeHandleSnapGeometry,
+  ShapeLineSegmentHitTestInput,
+  ShapeSelectionHandleAnchorInput,
+  ShapeSelectionHandleAnchors,
+  ShapeSelectionFrameInput,
+  ShapeSelectionFlipAxis,
+  ShapeSelectionFlipInput,
+  ShapeSelectionOverlayInfo,
+  ShapeSelectionPagePoints,
+  ShapeSelectionPagePointsInput,
+  ShapeSelectionResizeAspectRatioLockInput,
+  ShapeSelectionResizeInput,
+  ShapeSelectionTranslateInput,
+} from "./shapes/ShapeUtil";
+export { SnapManager } from "./editor/managers/SnapManager";
+export type { LaserTrailState } from "./editor/managers/InteractionTransientManager";
+export { SideEffectManager } from "./editor/managers/SideEffectManager";
+export type {
+  BeforeDeleteHandler,
+  AfterDeleteHandler,
+  RecordTypeName,
+} from "./editor/managers/SideEffectManager";
+export type {
+  HandleSnapContext,
+  HandleSnapInput,
+  HandleSnapMode,
+  HandleSnapResult,
+  HandleSnapSnapshot,
+  HandleSnapSnapshotInput,
+  ResizeSnapInput,
+  ResizeSnapResult,
+  ResizeSnapSnapshot,
+  SnapAxis,
+  SnapCoordinateSpace,
+  TranslateSnapInput,
+  TranslateSnapResult,
+  TranslateSnapSnapshot,
+} from "./editor/managers/snapTypes";
+export { ShapeUtilRegistry } from "./shapes/ShapeUtilRegistry";
+export {
+  resolveArrowTerminalBindingAtPoint,
+} from "./bindings/arrow/arrowBindingHelpers";
+export {
+  ShapeSvgExporterRegistry,
+  exportShapesToSvgString,
+  renderSvgNode,
+} from "./exports/svg";
+export type {
+  ShapeSvgExporter,
+  SvgAttributeValue,
+  SvgElementNode,
+  SvgExportContext,
+  SvgExportOptions,
+  SvgExportResult,
+  SvgExportSkipReason,
+  SvgExportSkippedShape,
+  SvgNode,
+} from "./exports/svg";
+export {
+  getExportIntegrityReport,
+  repairExportIntegrity,
+} from "./exports/integrity";
+export type {
+  ExportIntegrityIssue,
+  ExportIntegrityIssueKind,
+  ExportIntegrityRepairResult,
+  ExportIntegrityReport,
+} from "./exports/integrity";
+export { getShapeCapabilityManifest } from "./shapes/capabilities";
+export type {
+  ShapeCapabilityDefinition,
+  ShapeCapabilityManifest,
+  ShapeCapabilityManifestEntry,
+  ShapeCapabilitySupport,
+} from "./shapes/capabilities";
+export { BindingUtil } from "./bindings/BindingUtil";
+export type {
+  BindingSelectionCompanionFrameContext,
+  BindingUtilEffect,
+} from "./bindings/BindingUtil";
+export { BindingUtilRegistry } from "./bindings/BindingUtilRegistry";
+export { StateNode } from "./editor/StateNode";
+export { getEdgeScrollDelta } from "./editor/edgeScroll";
+export { HandTool } from "./tools/hand/HandTool";
+export { SelectTool } from "./tools/select/SelectTool";
+export {
+  SET_ACTIVE_TOOL_TOOLBAR_ACTION_ID,
+  TOGGLE_TOOL_LOCKED_TOOLBAR_ACTION_ID,
+} from "./toolbar";
+export type {
+  ContextMenuBadgeItem,
+  ContextMenuCanvasTarget,
+  ContextMenuCommandItem,
+  ContextMenuContext,
+  ContextMenuContribution,
+  ContextMenuContributionTarget,
+  ContextMenuItem,
+  ContextMenuOpenSnapshot,
+  ContextMenuSection,
+  ContextMenuSelectionTarget,
+  ContextMenuSeparatorItem,
+  ContextMenuShapeTarget,
+  ContextMenuTarget,
+} from "./contextMenu";
+export {
+  getEditorOptionsFromCorePlugins,
+  setupCorePlugins,
+  type LandCorePlugin,
+} from "./plugins";
+export type {
+  ToolbarAction,
+  ToolbarActionRunInput,
+  ToolbarActionValue,
+  ToolbarBadgeItem,
+  ToolbarButtonItem,
+  ToolbarContext,
+  ToolbarContribution,
+  ToolbarGroup,
+  ToolbarItem,
+  ToolbarSegmentedItem,
+  ToolbarSegmentedOption,
+  ToolbarSelectionSnapshot,
+  ToolbarSeparatorItem,
+  ToolbarStepperItem,
+  ToolbarStepperOption,
+  ToolbarTextInputItem,
+  ToolbarPlacement,
+  ToolbarSurface,
+  ToolbarSwatchesItem,
+  ToolbarSwatchOption,
+  ToolbarToolSnapshot,
+} from "./toolbar";
+export {
+  DEFAULT_CAMERA,
+  DEFAULT_PAGE_ID,
+  DEFAULT_SESSION_ID,
+  createDefaultPage,
+  createDefaultSession,
+  isAnyAssetRecord,
+  isAnyBindingRecord,
+  isAnyShapeRecord,
+  isAssetRecord,
+  isBindingRecord,
+  isDocumentRecord,
+  isPageRecord,
+  isSessionRecord,
+  isShapeRecord,
+  type AnyBindingRecord,
+  type AnyAssetRecord,
+  type AnyShapeRecord,
+  type AssetId,
+  type AssetRecord,
+  type AssetRecordBase,
+  type BaseRecord,
+  type BindingId,
+  type BindingRecordBase,
+  type BindingRecord,
+  type Camera,
+  type DocumentRecord,
+  type EditorRecord,
+  type PageCameraById,
+  type PageId,
+  type PageSelectionById,
+  type PageRecord,
+  type RecordScope,
+  type SessionRecord,
+  type ShapeId,
+  type ShapeParentId,
+  type ShapeRecordBase,
+  type ShapeRecord,
+  type ShapeEditingEntryRequest,
+  type ShapeEditingEntryMode,
+  type ShapeEditingPoint,
+  type ShapeEditingSession,
+} from "./schema/records";
+export { Vec } from "./geometry/Vec";
+export { Box } from "./geometry/Box";
+export { Mat } from "./geometry/Mat";
+export { observeValue } from "./reactivity";
+export type { ReadonlyValue } from "./reactivity";

package/_vendor/canvas-core/plugins/index.ts

@@ -0,0 +1,5 @@
+export {
+  getEditorOptionsFromCorePlugins,
+  setupCorePlugins,
+  type LandCorePlugin,
+} from "./types";

package/_vendor/canvas-core/plugins/types.ts

@@ -0,0 +1,53 @@
+import type { BindingUtil } from "../bindings/BindingUtil";
+import type { Editor } from "../editor/Editor";
+import type { LandInteractionHandler } from "../editor/interactions";
+import type { ShapeSvgExporter } from "../exports/svg";
+import type { ShapeCapabilityDefinition } from "../shapes/capabilities";
+import type { ShapeUtil } from "../shapes/ShapeUtil";
+import type { ToolbarAction, ToolbarContribution } from "../toolbar";
+import type { ContextMenuContribution } from "../contextMenu";
+
+export interface LandCorePlugin {
+  id: string;
+  shapeCapabilities?: ShapeCapabilityDefinition[];
+  shapeUtils?: ShapeUtil[];
+  shapeSvgExporters?: ShapeSvgExporter[];
+  bindingUtils?: BindingUtil[];
+  interactionHandlers?: LandInteractionHandler[];
+  toolbarActions?: ToolbarAction[];
+  toolbarContributions?: ToolbarContribution[];
+  contextMenuContributions?: ContextMenuContribution[];
+  setup?(editor: Editor): void;
+}
+
+export function getEditorOptionsFromCorePlugins(
+  plugins: readonly LandCorePlugin[],
+): {
+  shapeUtils: ShapeUtil[];
+  shapeSvgExporters: ShapeSvgExporter[];
+  bindingUtils: BindingUtil[];
+  shapeCapabilities: ShapeCapabilityDefinition[];
+} {
+  return {
+    shapeUtils: plugins.flatMap((plugin) => plugin.shapeUtils ?? []),
+    shapeSvgExporters: plugins.flatMap(
+      (plugin) => plugin.shapeSvgExporters ?? [],
+    ),
+    bindingUtils: plugins.flatMap((plugin) => plugin.bindingUtils ?? []),
+    shapeCapabilities: plugins.flatMap(
+      (plugin) => plugin.shapeCapabilities ?? [],
+    ),
+  };
+}
+
+export function setupCorePlugins(
+  editor: Editor,
+  plugins: readonly LandCorePlugin[],
+): void {
+  for (const plugin of plugins) {
+    for (const interactionHandler of plugin.interactionHandlers ?? []) {
+      editor.interactions.register(interactionHandler);
+    }
+    plugin.setup?.(editor);
+  }
+}

package/_vendor/canvas-core/reactivity.ts

@@ -0,0 +1,16 @@
+import { effect } from "@land/signals";
+
+export interface ReadonlyValue<T> {
+  get(): T;
+}
+
+export function observeValue<T>(
+  name: string,
+  value: ReadonlyValue<T>,
+  onChange: () => void,
+): () => void {
+  return effect(name, () => {
+    value.get();
+    onChange();
+  });
+}

package/_vendor/canvas-core/schema/records.ts

@@ -0,0 +1,221 @@
+export type RecordScope = "document" | "session";
+
+export type PageId = `page:${string}`;
+export type ShapeId = `shape:${string}`;
+export type BindingId = `binding:${string}`;
+export type AssetId = `asset:${string}`;
+export type SessionId = "session:main";
+export type ShapeParentId = PageId | ShapeId;
+
+export type PageCameraById = Partial<Record<PageId, Camera>>;
+export type PageSelectionById = Partial<Record<PageId, ShapeId[]>>;
+
+export interface ShapeEditingPoint {
+  x: number;
+  y: number;
+}
+
+export type ShapeEditingEntryMode = "selectAll" | "placeCaret" | "focusEnd";
+
+export interface ShapeEditingEntryRequest {
+  id: number;
+  shapeId: ShapeId;
+  entryMode: ShapeEditingEntryMode;
+  caretPagePoint?: ShapeEditingPoint;
+}
+
+export interface ShapeEditingSession {
+  shapeId: ShapeId;
+  markId: string;
+  entryMode: ShapeEditingEntryMode;
+  caretPagePoint?: ShapeEditingPoint;
+  isComposing: boolean;
+}
+
+export interface Camera {
+  x: number;
+  y: number;
+  z: number;
+}
+
+export interface BaseRecord {
+  id: string;
+  typeName: string;
+  scope: RecordScope;
+  meta: Record<string, unknown>;
+}
+
+export interface PageRecord extends BaseRecord {
+  id: PageId;
+  typeName: "page";
+  scope: "document";
+  name: string;
+  index: string;
+}
+
+export interface ShapeRecordBase<
+  Type extends string = string,
+  Props extends object = object,
+> extends BaseRecord {
+  id: ShapeId;
+  typeName: "shape";
+  scope: "document";
+  type: Type;
+  parentId: ShapeParentId;
+  index: string;
+  x: number;
+  y: number;
+  rotation: number;
+  scaleX: number;
+  scaleY: number;
+  opacity: number;
+  isHidden: boolean;
+  isLocked: boolean;
+  props: Props;
+}
+
+export interface BindingRecordBase<
+  Type extends string = string,
+  Props extends object = object,
+> extends BaseRecord {
+  id: BindingId;
+  typeName: "binding";
+  scope: "document";
+  type: Type;
+  fromId: ShapeId;
+  toId: ShapeId;
+  props: Props;
+}
+
+export interface AssetRecordBase<
+  Type extends string = string,
+  Props extends object = object,
+> extends BaseRecord {
+  id: AssetId;
+  typeName: "asset";
+  scope: "document";
+  type: Type;
+  props: Props;
+}
+
+export type ShapeRecord = ShapeRecordBase<string, object>;
+export type BindingRecord = BindingRecordBase<string, object>;
+export type AssetRecord = AssetRecordBase<string, object>;
+export type AnyShapeRecord = ShapeRecord;
+export type AnyBindingRecord = BindingRecord;
+export type AnyAssetRecord = AssetRecord;
+
+export interface SessionRecord extends BaseRecord {
+  id: SessionId;
+  typeName: "session";
+  scope: "session";
+  currentPageId: PageId;
+  activeToolId: string;
+  isToolLocked: boolean;
+  editingShapeId: ShapeId | null;
+  shapeEditingSession: ShapeEditingSession | null;
+  pageCameraById: PageCameraById;
+  pageSelectedShapeIdsById: PageSelectionById;
+}
+
+export type DocumentRecord =
+  | PageRecord
+  | AnyShapeRecord
+  | AnyBindingRecord
+  | AnyAssetRecord;
+export type EditorRecord = DocumentRecord | SessionRecord;
+
+export const DEFAULT_PAGE_ID: PageId = "page:default";
+export const DEFAULT_SESSION_ID: SessionId = "session:main";
+export const DEFAULT_CAMERA: Camera = {
+  x: 0,
+  y: 0,
+  z: 1,
+};
+
+export function createDefaultPage(): PageRecord {
+  return {
+    id: DEFAULT_PAGE_ID,
+    typeName: "page",
+    scope: "document",
+    name: "Page 1",
+    index: "0001",
+    meta: {},
+  };
+}
+
+export function createDefaultSession(
+  currentPageId: PageId = DEFAULT_PAGE_ID,
+): SessionRecord {
+  return {
+    id: DEFAULT_SESSION_ID,
+    typeName: "session",
+    scope: "session",
+    currentPageId,
+    activeToolId: "select",
+    isToolLocked: false,
+    editingShapeId: null,
+    shapeEditingSession: null,
+    pageCameraById: {
+      [currentPageId]: { ...DEFAULT_CAMERA },
+    },
+    pageSelectedShapeIdsById: {
+      [currentPageId]: [],
+    },
+    meta: {},
+  };
+}
+
+export function isPageRecord(
+  record: BaseRecord | null | undefined,
+): record is PageRecord {
+  return !!record && record.typeName === "page";
+}
+
+export function isShapeRecord(
+  record: BaseRecord | null | undefined,
+): record is ShapeRecord {
+  return !!record && record.typeName === "shape";
+}
+
+export function isAnyShapeRecord(
+  record: BaseRecord | null | undefined,
+): record is AnyShapeRecord {
+  return !!record && record.typeName === "shape";
+}
+
+export function isSessionRecord(
+  record: BaseRecord | null | undefined,
+): record is SessionRecord {
+  return !!record && record.typeName === "session";
+}
+
+export function isBindingRecord(
+  record: BaseRecord | null | undefined,
+): record is BindingRecord {
+  return !!record && record.typeName === "binding";
+}
+
+export function isAnyBindingRecord(
+  record: BaseRecord | null | undefined,
+): record is AnyBindingRecord {
+  return !!record && record.typeName === "binding";
+}
+
+export function isAssetRecord(
+  record: BaseRecord | null | undefined,
+): record is AssetRecord {
+  return !!record && record.typeName === "asset";
+}
+
+export function isAnyAssetRecord(
+  record: BaseRecord | null | undefined,
+): record is AnyAssetRecord {
+  return !!record && record.typeName === "asset";
+}
+
+export function isDocumentRecord(
+  record: EditorRecord,
+): record is DocumentRecord {
+  return record.scope === "document";
+}