@yuzhouu/canvas-kit 0.1.2 → 0.1.3

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

@@ -0,0 +1,45 @@
+import type { Editor } from "../editor/Editor";
+import type { SelectionOverlayFrameGeometryState } from "../editor/selection";
+import type { BindingId, BindingRecord, BindingRecordBase, ShapeRecord } from "../schema/records";
+export interface BindingUtilEffect {
+    shapes?: ShapeRecord[];
+    bindings?: BindingRecord[];
+    deleteShapeIds?: ShapeRecord["id"][];
+    deleteBindingIds?: BindingId[];
+}
+export interface BindingShapeChangeContext {
+    before: ShapeRecord;
+    after: ShapeRecord;
+    role: "from" | "to";
+}
+export interface BindingShapeDeleteContext {
+    shape: ShapeRecord;
+    role: "from" | "to";
+}
+export interface BindingEndpointContext {
+    fromShape: ShapeRecord;
+    toShape: ShapeRecord;
+}
+export interface BindingSelectionCompanionFrameContext {
+    selectedShape: ShapeRecord;
+}
+export interface BindingShapeGeometryDependencyContext {
+    shape: ShapeRecord;
+    role: "from" | "to";
+}
+export declare abstract class BindingUtil<B extends BindingRecordBase = BindingRecordBase> {
+    abstract readonly type: B["type"];
+    abstract getDefaultProps(): B["props"];
+    abstract validateProps(props: unknown): B["props"];
+    canBind?(editor: Editor, binding: B, context: BindingEndpointContext): boolean;
+    getExclusiveBindingKey?(binding: B): string | null;
+    onBindingCreate?(editor: Editor, binding: B): BindingUtilEffect | void;
+    onBindingUpdate?(editor: Editor, before: B, after: B): BindingUtilEffect | void;
+    onBindingLoad?(editor: Editor, binding: B): BindingUtilEffect | void;
+    onAfterShapeChange?(editor: Editor, binding: B, context: BindingShapeChangeContext): BindingUtilEffect | void;
+    onBeforeDeleteShape?(editor: Editor, binding: B, context: BindingShapeDeleteContext): BindingUtilEffect | void;
+    onBeforeDeleteBinding?(editor: Editor, binding: B): BindingUtilEffect | void;
+    getExportShapeIds?(editor: Editor, binding: B): ShapeRecord["id"][];
+    getGeometryDependentShapeIds?(editor: Editor, binding: B, context: BindingShapeGeometryDependencyContext): ShapeRecord["id"][];
+    getSelectionCompanionFrameGeometries?(editor: Editor, binding: B, context: BindingSelectionCompanionFrameContext): SelectionOverlayFrameGeometryState[];
+}

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

@@ -0,0 +1,8 @@
+import type { BindingRecordBase } from "../schema/records";
+import { BindingUtil } from "./BindingUtil";
+export declare class BindingUtilRegistry {
+    private readonly registry;
+    register<B extends BindingRecordBase>(util: BindingUtil<B>): void;
+    values(): IterableIterator<BindingUtil>;
+    get<B extends BindingRecordBase>(type: B["type"]): BindingUtil<B>;
+}

package/_vendor/canvas-core/bindings/arrow/arrowBindingHelpers.d.ts

@@ -0,0 +1,28 @@
+import { Vec } from "../../geometry/Vec";
+import type { Editor } from "../../editor/Editor";
+import type { ArrowBindingPreviewState } from "../../editor/selection";
+import type { ShapeId } from "../../schema/records";
+export interface ConnectionPoint {
+    x: number;
+    y: number;
+}
+export type ConnectionTerminal = "start" | "end";
+export interface ArrowBindingTargetInput {
+    targetShapeId: ShapeId;
+    normalizedAnchor: ConnectionPoint;
+}
+export interface ResolvedArrowTerminalBinding {
+    pagePoint: Vec;
+    binding: ArrowBindingTargetInput | null;
+    preview: ArrowBindingPreviewState | null;
+}
+export interface ArrowTerminalBindingResolverInput {
+    terminal: ConnectionTerminal;
+    rawPagePoint: Vec;
+    oppositePagePoint: Vec;
+    excludeShapeId?: ShapeId;
+    ignoreTargets?: boolean;
+}
+export type ArrowTerminalBindingResolver = (editor: Editor, input: ArrowTerminalBindingResolverInput) => ResolvedArrowTerminalBinding;
+export declare function getFreeArrowTerminalBinding({ rawPagePoint, }: ArrowTerminalBindingResolverInput): ResolvedArrowTerminalBinding;
+export declare function resolveArrowTerminalBindingAtPoint(editor: Editor, input: ArrowTerminalBindingResolverInput): ResolvedArrowTerminalBinding;

package/_vendor/canvas-core/contextMenu.d.ts

@@ -0,0 +1,62 @@
+import type { ShapeId, ShapeRecordBase } from "./schema/records";
+import type { ToolbarActionValue, ToolbarContext } from "./toolbar";
+import type { Vec } from "./geometry";
+export interface ContextMenuCanvasTarget {
+    type: "canvas";
+}
+export interface ContextMenuShapeTarget {
+    type: "shape";
+    shapeId: ShapeId;
+    shapeType: ShapeRecordBase["type"];
+    selected: boolean;
+}
+export interface ContextMenuSelectionTarget {
+    type: "selection";
+    selectedShapeIds: readonly ShapeId[];
+}
+export type ContextMenuTarget = ContextMenuCanvasTarget | ContextMenuShapeTarget | ContextMenuSelectionTarget;
+export interface ContextMenuOpenSnapshot {
+    screenPoint: Vec;
+    pagePoint: Vec;
+    target: ContextMenuTarget;
+}
+export interface ContextMenuContext extends ToolbarContext {
+    menu: ContextMenuOpenSnapshot;
+}
+export type ContextMenuContributionTarget = "canvas" | "selection" | "shape" | "any";
+export interface ContextMenuCommandItem {
+    kind: "command";
+    id: string;
+    actionId: string;
+    label: string;
+    icon?: string;
+    value?: ToolbarActionValue;
+    shortcut?: string;
+    tone?: "default" | "destructive";
+    dataUi?: string;
+}
+export interface ContextMenuSeparatorItem {
+    kind: "separator";
+    id: string;
+}
+export interface ContextMenuBadgeItem {
+    kind: "badge";
+    id: string;
+    label: string;
+    dataUi?: string;
+}
+export type ContextMenuItem = ContextMenuCommandItem | ContextMenuSeparatorItem | ContextMenuBadgeItem;
+export interface ContextMenuSection {
+    id: string;
+    order?: number;
+    title?: string;
+    items: readonly ContextMenuItem[];
+}
+export interface ContextMenuContribution {
+    id: string;
+    target: ContextMenuContributionTarget;
+    order?: number;
+    actionIds: readonly string[];
+    when?(context: ContextMenuContext): boolean;
+    getSections(context: ContextMenuContext): readonly ContextMenuSection[];
+}