@yuzhouu/canvas-kit 0.1.5 → 0.1.6

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

@@ -41,7 +41,7 @@ import type { DuplicateSelectionInput, EditorClipboardPayload, PasteClipboardPay
 import { InteractionHandlerRegistry } from "./interactions";
 import { SelectionHandleInteractionRegistry } from "./selectionHandleInteractions";
 import { type SelectedShapeOverlayItem } from "./selectionOverlay";
-import type { BindingPreviewState, SnapIndicatorState, SelectionBindingSegment, SelectionHandle, SelectionFrame, SelectionOverlayFrameState, SelectionOverlayFrameGeometryState, SelectionOverlayFrameStyleState, SelectionOverlayHandleAnchorsState, SelectionOverlayHandleCountsState, SelectionOverlayHandlesState, SelectionOverlayState } from "./selection";
+import type { BindingPreviewState, SnapIndicatorState, SelectionBindingSegment, TerminalBindingGuideState, SelectionHandle, SelectionFrame, SelectionOverlayFrameState, SelectionOverlayFrameGeometryState, SelectionOverlayFrameStyleState, SelectionOverlayHandleAnchorsState, SelectionOverlayHandleCountsState, SelectionOverlayHandlesState, SelectionOverlayState } from "./selection";
 export interface EditorOptions {
     shapeUtils?: ShapeUtil[];
     shapeSvgExporters?: ShapeSvgExporter[];
@@ -213,7 +213,9 @@ export declare class Editor {
     readonly laserTrailActiveSignal: Signal<boolean>;
     readonly bindingPreviewSignal: Signal<BindingPreviewState | null>;
     readonly bindingPreviewActiveSignal: Signal<boolean>;
+    readonly terminalBindingGuidesSignal: Signal<TerminalBindingGuideState[]>;
     readonly dropTargetShapeIdSignal: Signal<ShapeId | null>;
+    readonly hoveredShapeIdSignal: Signal<ShapeId | null>;
     readonly selectionTranslationActiveSignal: Signal<boolean>;
     readonly snapIndicatorsSignal: Signal<SnapIndicatorState[]>;
     readonly snapIndicatorsActiveSignal: Signal<boolean>;
@@ -249,6 +251,7 @@ export declare class Editor {
     readonly shapeEditingStateSignal: import("../../signals/index").Computed<EditorShapeEditingState>;
     readonly currentCameraSignal: import("../../signals/index").Computed<Camera>;
     readonly selectedShapeIdsSignal: import("../../signals/index").Computed<`shape:${string}`[]>;
+    readonly selectionCountSignal: import("../../signals/index").Computed<number>;
     readonly selectedShapeIdSetSignal: import("../../signals/index").Computed<Set<`shape:${string}`>>;
     readonly selectedShapesSignal: import("../../signals/index").Computed<ShapeRecord[]>;
     readonly selectedShapeOverlayItemsSignal: import("../../signals/index").Computed<SelectedShapeOverlayItem[]>;
@@ -272,6 +275,7 @@ export declare class Editor {
     private readonly shapeDocumentVisibleSignals;
     private readonly shapeEditingSessionSignals;
     private readonly shapeDropTargetSignals;
+    private readonly shapeHoveredSignals;
     private readonly shapeErasingSignals;
     private readonly shapeSelectedDescendantTransformAncestorSignals;
     private lastPointerDownForClickCount;
@@ -390,6 +394,7 @@ export declare class Editor {
     getShapeDocumentVisibleSignal(id: ShapeId): Signal<boolean>;
     getShapeEditingSessionForShapeSignal(id: ShapeId): Signal<ShapeEditingSession | null>;
     getShapeDropTargetSignal(id: ShapeId): Signal<boolean>;
+    getShapeHoveredSignal(id: ShapeId): Signal<boolean>;
     getShapeErasingSignal(id: ShapeId): Signal<boolean>;
     getShapeSelectedDescendantTransformAncestorSignal(id: ShapeId): Signal<boolean>;
     getBinding(id: BindingId): BindingRecord | undefined;
@@ -464,7 +469,9 @@ export declare class Editor {
     finishLaserTrail(sessionId: number): void;
     clearLaserTrail(sessionId: number): void;
     setBindingPreview(preview: BindingPreviewState | null): void;
+    setTerminalBindingGuides(guides: readonly TerminalBindingGuideState[] | null): void;
     setDropTargetShapeId(shapeId: ShapeId | null): void;
+    setHoveredShapeId(shapeId: ShapeId | null): void;
     setSelectionTranslationActive(active: boolean): void;
     setSnapIndicators(indicators: SnapIndicatorState[] | null): void;
     setTerminalBindingResolver(resolver: TerminalBindingResolver): void;

package/_vendor/canvas-core/editor/managers/interactionTransientManager.d.ts

@@ -4,7 +4,7 @@ import type { Box } from "../../geometry/box";
 import type { Vec } from "../../geometry/vec";
 import type { ShapeId } from "../../schema/records";
 import type { Editor } from "../editor";
-import type { BindingPreviewState, SnapIndicatorState } from "../selection";
+import type { BindingPreviewState, SnapIndicatorState, TerminalBindingGuideState } from "../selection";
 export interface LaserTrailState {
     sessionId: number;
     phase: "active" | "ending";
@@ -28,8 +28,12 @@ export declare class InteractionTransientManager {
     private readonly _bindingPreviewSignal;
     readonly bindingPreviewSignal: Signal<BindingPreviewState | null>;
     readonly bindingPreviewActiveSignal: import("../../../signals/index").Computed<boolean>;
+    private readonly _terminalBindingGuidesSignal;
+    readonly terminalBindingGuidesSignal: Signal<TerminalBindingGuideState[]>;
     private readonly _dropTargetShapeIdSignal;
     readonly dropTargetShapeIdSignal: Signal<ShapeId | null>;
+    private readonly _hoveredShapeIdSignal;
+    readonly hoveredShapeIdSignal: Signal<ShapeId | null>;
     private readonly _selectionTranslationActiveSignal;
     readonly selectionTranslationActiveSignal: Signal<boolean>;
     private terminalBindingResolver;
@@ -46,7 +50,9 @@ export declare class InteractionTransientManager {
     finishLaserTrail(sessionId: number): void;
     clearLaserTrail(sessionId: number): void;
     setBindingPreview(preview: BindingPreviewState | null): void;
+    setTerminalBindingGuides(guides: readonly TerminalBindingGuideState[] | null): void;
     setDropTargetShapeId(shapeId: ShapeId | null): void;
+    setHoveredShapeId(shapeId: ShapeId | null): void;
     setSelectionTranslationActive(active: boolean): void;
     setSnapIndicators(indicators: SnapIndicatorState[] | null): void;
     setTerminalBindingResolver(resolver: TerminalBindingResolver): void;

package/_vendor/canvas-core/editor/managers/shapeHierarchyManager.d.ts

@@ -27,6 +27,9 @@ export declare class ShapeHierarchyManager {
     canUngroupShapes(ids: readonly ShapeId[]): boolean;
     ungroupShapes(ids: readonly ShapeId[], source?: ChangeSource): ShapeId[];
     ungroupSelection(source?: ChangeSource): ShapeId[];
+    private getOutermostUngroupableShapeIds;
+    private isShapeDescendantOfAny;
+    private removeUngroupedContainerShapes;
     getSelectionSiblingOrderState(): ShapeSiblingOrderState | null;
     canMoveSelectionWithinParent(direction: ShapeSiblingOrderDirection): boolean;
     canMoveSelectionInParentOrder(direction: ShapeSiblingOrderDirection): boolean;

package/_vendor/canvas-core/editor/managers/spatialIndexManager.d.ts

@@ -8,6 +8,7 @@ export interface SpatialQueryOptions {
 }
 export interface ShapeAtPointOptions extends SpatialQueryOptions {
     filter?: (shape: ShapeRecord) => boolean;
+    hitTest?: "point" | "bindingTarget";
 }
 export interface ShapeLineSegmentHitTestOptions extends SpatialQueryOptions {
     margin?: number;

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

@@ -118,6 +118,10 @@ export interface SelectionBindingSegment {
     boundaryPagePoint: Vec;
     guidePath?: string | null;
 }
+export interface TerminalBindingGuideState extends SelectionBindingSegment {
+    ownerShapeId: ShapeId;
+    targetShapeId?: ShapeId | null;
+}
 export interface PointSnapIndicatorState {
     id: string;
     type: "points";

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

@@ -0,0 +1,7 @@
+import type { SelectionBindingSegment, TerminalBindingGuideState } from "./selection";
+export declare function cloneSelectionBindingSegment<T extends SelectionBindingSegment>(segment: T): T;
+export declare function cloneSelectionBindingSegments<T extends SelectionBindingSegment>(segments: readonly T[]): T[];
+export declare function areSelectionBindingSegmentsEqual(a: SelectionBindingSegment, b: SelectionBindingSegment): boolean;
+export declare function areSelectionBindingSegmentArraysEqual(a: readonly SelectionBindingSegment[], b: readonly SelectionBindingSegment[]): boolean;
+export declare function areTerminalBindingGuideStatesEqual(a: TerminalBindingGuideState, b: TerminalBindingGuideState): boolean;
+export declare function areTerminalBindingGuideStateArraysEqual(a: readonly TerminalBindingGuideState[], b: readonly TerminalBindingGuideState[]): boolean;

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

@@ -18,7 +18,6 @@ export interface SelectionHandleState {
     middleHandles: SelectionBindingMiddleHandle[];
     customHandles: SelectionCustomHandle[];
 }
-export declare function areSelectionBindingSegmentArraysEqual(a: readonly SelectionBindingSegment[], b: readonly SelectionBindingSegment[]): boolean;
 export declare function areSelectedShapeOverlayItemsEqual(a: SelectedShapeOverlayItem[], b: SelectedShapeOverlayItem[]): boolean;
 export declare function areSelectionOverlayFrameStatesEqual(a: SelectionOverlayFrameState | null, b: SelectionOverlayFrameState | null): boolean;
 export declare function areSelectionOverlayFrameGeometryStatesEqual(a: SelectionOverlayFrameGeometryState | null, b: SelectionOverlayFrameGeometryState | null): boolean;

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

@@ -3,7 +3,7 @@ export { createEditorWithPlugins, type CreateEditorWithPluginsOptions, } from ".
 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 { BindingPreviewState, GapSnapIndicatorGapState, GapSnapIndicatorState, PointSnapIndicatorState, SnapIndicatorState, SelectionBindingSegment, SelectionBindingMiddleHandle, SelectionBindingMiddleHandleAnchor, SelectionBindingTerminalHandle, SelectionBindingTerminalHandleAnchor, SelectionCustomHandle, SelectionCustomHandleAnchor, SelectionHandle, SelectionOverlayFrameState, SelectionOverlayFrameGeometryState, SelectionOverlayFrameStyleState, SelectionOverlayHandleAnchorsState, SelectionOverlayHandleCountsState, SelectionOverlayHandlesState, SelectionOverlayState, SelectionResizeHandle, SelectionResizeHandleAnchor, SelectionResizeHandleId, SelectionRotateHandle, SelectionRotateHandleAnchor, SelectionRotateHandleId, SelectionMirrorAxis, } from "./editor/selection";
+export type { BindingPreviewState, GapSnapIndicatorGapState, GapSnapIndicatorState, PointSnapIndicatorState, SnapIndicatorState, SelectionBindingSegment, TerminalBindingGuideState, SelectionBindingMiddleHandle, SelectionBindingMiddleHandleAnchor, SelectionBindingTerminalHandle, SelectionBindingTerminalHandleAnchor, 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";
@@ -26,7 +26,7 @@ export type { DocumentSnapshot, SessionSnapshot, SnapshotMigration, } from "./sc
 export { createDocumentSnapshotSupport, filterDocumentSnapshotBySupport, getDocumentSnapshotRequirements, getUnsupportedDocumentSnapshotRequirements, } from "./schema/snapshotSupport";
 export type { DocumentSnapshotRequirements, DocumentSnapshotSupport, FilterDocumentSnapshotBySupportResult, UnsupportedDocumentSnapshotRequirements, } from "./schema/snapshotSupport";
 export { ShapeUtil } from "./shapes/shapeUtil";
-export type { ShapeBoundsSnapGeometry, ShapeBrushSelectInput, ShapeBrushWrapInput, ShapeBindingPointInput, ShapeEditEndResult, ShapeGeometryInput, ShapeHandleSnapContext, ShapeHandleSnapGeometry, ShapeLineSegmentHitTestInput, ShapePointHitTestInput, ShapeSelectionHandleAnchorInput, ShapeSelectionHandleAnchors, ShapeSelectionFrameInput, ShapeSelectionFlipAxis, ShapeSelectionFlipInput, ShapeSelectionOverlayInfo, ShapeSelectionOverlayInfoInput, ShapeSelectionPagePoints, ShapeSelectionPagePointsInput, ShapeSelectionResizeAspectRatioLockInput, ShapeSelectionResizeInput, ShapeSelectionTranslateInput, } from "./shapes/shapeUtil";
+export type { ShapeBoundsSnapGeometry, ShapeBrushSelectInput, ShapeBrushWrapInput, ShapeBindingPointInput, ShapeBindingTargetHitTestInput, ShapeEditEndResult, ShapeGeometryInput, ShapeHandleSnapContext, ShapeHandleSnapGeometry, ShapeLineSegmentHitTestInput, ShapePointHitTestInput, ShapeSelectionHandleAnchorInput, ShapeSelectionHandleAnchors, ShapeSelectionFrameInput, ShapeSelectionFlipAxis, ShapeSelectionFlipInput, ShapeSelectionOverlayInfo, ShapeSelectionOverlayInfoInput, ShapeSelectionPagePoints, ShapeSelectionPagePointsInput, ShapeSelectionResizeAspectRatioLockInput, ShapeSelectionResizeInput, ShapeSelectionTranslateInput, } from "./shapes/shapeUtil";
 export type { LaserTrailState } from "./editor/managers/interactionTransientManager";
 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";

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

@@ -1,4 +1,6 @@
 export interface ReadonlyValue<T> {
     get(): T;
 }
-export declare function observeValue<T>(name: string, value: ReadonlyValue<T>, onChange: () => void): () => void;
+export declare function observeValue<T>(name: string, value: ReadonlyValue<T>, onChange: () => void, options?: {
+    fireImmediately?: boolean;
+}): () => void;

package/_vendor/canvas-core/shapes/shapeUtil.d.ts

@@ -63,6 +63,8 @@ export interface ShapePointHitTestInput extends ShapeGeometryInput {
     pagePoint: Vec;
     positionedPoint: Vec;
 }
+export interface ShapeBindingTargetHitTestInput extends ShapePointHitTestInput {
+}
 export interface ShapeBoundsSnapGeometry {
     points?: readonly Vec[];
 }
@@ -124,8 +126,9 @@ export declare abstract class ShapeUtil<S extends ShapeRecordBase = ShapeRecordB
     canUseSelectionFrameHandles(_shape: S, _input: ShapeSelectionFrameInput): boolean;
     getSelectionTargetId(shape: S, _input: ShapeSelectionFrameInput): ShapeId;
     getTranslateTargetId(shape: S, _input: ShapeSelectionTranslateInput): ShapeId;
-    shouldTransformDescendants(_shape: S): boolean;
+    isTransformDescendantContainer(_shape: S): boolean;
     shouldRotateDescendants(shape: S): boolean;
+    canUngroupChildren(_shape: S): boolean;
     canStartTranslateFromSelectionBounds(_shape: S): boolean;
     canSnap(_shape: S): boolean;
     getBoundsSnapGeometry(_shape: S): ShapeBoundsSnapGeometry;
@@ -138,9 +141,11 @@ export declare abstract class ShapeUtil<S extends ShapeRecordBase = ShapeRecordB
     getLocalToPageTransform(shape: S): Mat;
     canEdit(_shape: S): boolean;
     canReceiveChildren(_shape: S): boolean;
+    canReceiveTerminalBinding(_shape: S, _input?: ShapeGeometryInput): boolean;
     repairLoadedShape(_shape: S): S | null;
     onEditEnd(_shape: S): ShapeEditEndResult | void;
     hitTest(shape: S, positionedPoint: Vec, _input?: ShapePointHitTestInput): boolean;
+    hitTestBindingTarget(shape: S, positionedPoint: Vec, input?: ShapeBindingTargetHitTestInput): boolean;
     hitTestLineSegment(shape: S, input: ShapeLineSegmentHitTestInput): boolean;
-    resolveBindingPoint(_shape: S, input: ShapeBindingPointInput): Vec;
+    resolveBindingPoint(shape: S, input: ShapeBindingPointInput): Vec;
 }

package/_vendor/canvas-react/components/ShapeLayer.d.ts

@@ -1,4 +1 @@
-import { type ShapeId } from "../../canvas-core/index";
-export declare function ShapeLayer({ hoveredShapeId, }: {
-    hoveredShapeId?: ShapeId | null;
-}): import("react/jsx-runtime").JSX.Element;
+export declare function ShapeLayer(): import("react/jsx-runtime").JSX.Element;

package/_vendor/canvas-react/components/overlays/BindingGuide.d.ts

@@ -2,7 +2,7 @@ export interface PagePointLike {
     x: number;
     y: number;
 }
-export type DashedGuideSegmentKind = "binding-preview" | "selection-binding";
+export type DashedGuideSegmentKind = "binding-preview" | "selection-binding" | "terminal-binding-guide";
 export declare function DashedGuideSegment({ start, end, startInset, endInset, strokeWidth, dashSize, gapSize, kind, terminal, }: {
     start: PagePointLike;
     end: PagePointLike;

package/_vendor/canvas-react/components/overlays/SelectionPathOverlay.d.ts

@@ -1 +1,8 @@
+import { type SelectionBindingSegment } from "../../../canvas-core/index";
+import { type DashedGuideSegmentKind } from "./BindingGuide";
 export declare const SelectionPathOverlay: import("react").NamedExoticComponent<object>;
+export declare const BindingSegmentsOverlay: import("react").NamedExoticComponent<{
+    bindingSegments: readonly SelectionBindingSegment[];
+    kind?: DashedGuideSegmentKind;
+    strokeWidth: number;
+}>;

package/_vendor/canvas-react/components/overlays/TerminalBindingGuidesOverlay.d.ts

@@ -0,0 +1 @@
+export declare const TerminalBindingGuidesOverlay: import("react").NamedExoticComponent<object>;

package/_vendor/canvas-react/components/useCanvasDomEvents.d.ts

@@ -1,5 +1,5 @@
 import { type MouseEvent as ReactMouseEvent, type PointerEvent as ReactPointerEvent, type RefObject } from "react";
-import { type ActiveContextMenu, type Editor, type ShapeEditingSession, type ShapeId } from "../../canvas-core/index";
+import { type ActiveContextMenu, type Editor, type ShapeEditingSession } from "../../canvas-core/index";
 import type { CanvasDomEventGuardRegistry } from "../host/domEventGuards";
 export interface CanvasDomEventHandlers {
     onPointerDown: (event: ReactPointerEvent<HTMLDivElement>) => void;
@@ -8,7 +8,6 @@ export interface CanvasDomEventHandlers {
 export interface CanvasDomEventState {
     containerRef: RefObject<HTMLDivElement | null>;
     handlers: CanvasDomEventHandlers;
-    hoveredShapeId: ShapeId | null;
     isPointerActive: boolean;
     surfaceCursor: string | undefined;
 }

package/_vendor/plugin-arrow/arrowBindingTargets.d.ts

@@ -0,0 +1,3 @@
+import type { Editor, ShapeRecord } from "../canvas-core/index";
+export declare function canReceiveArrowBindingTarget(editor: Editor, shape: ShapeRecord | undefined): shape is ShapeRecord;
+export declare function getPreferredArrowBindingTarget(editor: Editor, candidates: readonly ShapeRecord[]): ShapeRecord | null;

package/_vendor/plugin-arrow/arrowBindingUtil.d.ts

@@ -4,7 +4,7 @@ export declare class ArrowBindingUtil extends BindingUtil<ArrowBindingRecord> {
     readonly type: "arrow";
     getDefaultProps(): ArrowBindingRecord["props"];
     validateProps(props: unknown): ArrowBindingRecord["props"];
-    canBind(_editor: Editor, _binding: ArrowBindingRecord, context: {
+    canBind(editor: Editor, _binding: ArrowBindingRecord, context: {
         fromShape: ShapeRecord;
         toShape: ShapeRecord;
     }): boolean;

package/_vendor/plugin-draw/drawShapeUtil.d.ts

@@ -8,6 +8,7 @@ export declare class DrawShapeUtil extends ShapeUtil<DrawShapeRecord> {
     getLocalBounds(shape: DrawShapeRecord): Box;
     getRenderBounds(shape: DrawShapeRecord): Box;
     getExportBounds(shape: DrawShapeRecord): Box;
+    canReceiveTerminalBinding(_shape: DrawShapeRecord): boolean;
     getSelectionResizeLocalBounds(shape: DrawShapeRecord): Box;
     resizeSelectionBounds(shape: DrawShapeRecord, input: ShapeSelectionResizeInput): ShapeUpdate;
     flipSelectionBounds(shape: DrawShapeRecord, input: ShapeSelectionFlipInput): ShapeUpdate;

package/_vendor/plugin-frame/frameShapeUtil.d.ts

@@ -15,9 +15,11 @@ export declare class FrameShapeUtil extends ShapeUtil<FrameShapeRecord> {
     getBounds(shape: FrameShapeRecord): Box;
     getPointHitTestBounds(shape: FrameShapeRecord): Box;
     canReceiveChildren(_shape: FrameShapeRecord): boolean;
+    canReceiveTerminalBinding(_shape: FrameShapeRecord): boolean;
     shouldRotateDescendants(_shape: FrameShapeRecord): boolean;
     getChildClipLocalBounds(shape: FrameShapeRecord): Box | null;
     canSelectByBrush(shape: FrameShapeRecord, input: ShapeBrushSelectInput): boolean;
     hitTest(shape: FrameShapeRecord, positionedPoint: Vec): boolean;
+    hitTestBindingTarget(shape: FrameShapeRecord, positionedPoint: Vec): boolean;
     hitTestLineSegment(shape: FrameShapeRecord, input: ShapeLineSegmentHitTestInput): boolean;
 }

package/_vendor/plugin-geo/geoShapeUtil.d.ts

@@ -5,6 +5,7 @@ export declare class GeoShapeUtil extends ShapeUtil<GeoShapeRecord> {
     getDefaultProps(): GeoShapeProps;
     validateProps(props: unknown): GeoShapeProps;
     getBounds(shape: GeoShapeRecord): Box;
+    canReceiveTerminalBinding(_shape: GeoShapeRecord): boolean;
     getPositionedOutlineVertices(shape: GeoShapeRecord): Vec[];
     getHandleSnapGeometry(shape: GeoShapeRecord): ShapeHandleSnapGeometry;
     hitTest(shape: GeoShapeRecord, positionedPoint: Vec): boolean;

package/_vendor/plugin-group/groupShapeUtil.d.ts

@@ -10,6 +10,7 @@ export declare class GroupShapeUtil extends ShapeUtil<GroupShapeRecord> {
     validateProps(props: unknown): GroupShapeProps;
     getBounds(shape: GroupShapeRecord): Box;
     hitTest(_shape: GroupShapeRecord, _positionedPoint: Vec): boolean;
-    shouldTransformDescendants(_shape: GroupShapeRecord): boolean;
+    isTransformDescendantContainer(_shape: GroupShapeRecord): boolean;
+    canUngroupChildren(_shape: GroupShapeRecord): boolean;
     canReceiveChildren(_shape: GroupShapeRecord): boolean;
 }

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

@@ -5,6 +5,7 @@ export declare class ImageShapeUtil extends ShapeUtil<ImageShapeRecord> {
     getDefaultProps(): ImageShapeProps;
     validateProps(props: unknown): ImageShapeProps;
     getBounds(shape: ImageShapeRecord): Box;
+    canReceiveTerminalBinding(_shape: ImageShapeRecord): boolean;
     getSelectionResizeAspectRatioLock(_shape: ImageShapeRecord, input: ShapeSelectionResizeAspectRatioLockInput): boolean | null;
     canEdit(_shape: ImageShapeRecord): boolean;
     getSelectionHandleAnchors(shape: ImageShapeRecord, input: ShapeSelectionHandleAnchorInput): ShapeSelectionHandleAnchors;

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

@@ -8,6 +8,7 @@ export declare class TextShapeUtil extends ShapeUtil<TextShapeRecord> {
     getLocalBounds(shape: TextShapeRecord): Box;
     getRenderBounds(shape: TextShapeRecord): Box;
     getExportBounds(shape: TextShapeRecord): Box;
+    canReceiveTerminalBinding(_shape: TextShapeRecord): boolean;
     canEdit(_shape: TextShapeRecord): boolean;
     contributesToSelectionFrame(shape: TextShapeRecord, input: ShapeSelectionFrameInput): boolean;
     canUseSelectionFrameHandles(shape: TextShapeRecord, input: ShapeSelectionFrameInput): boolean;

package/builtins/extensions.d.ts

@@ -9,9 +9,10 @@ export interface BuiltInCanvasExtensionOptions {
     group?: boolean;
     image?: boolean;
     laser?: boolean;
+    path?: boolean;
     text?: boolean | LandExtensionOptionsInput<TextExtensionOptions>;
 }
-export declare const builtInCanvasExtensions: readonly [import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<TextExtensionOptions>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>];
+export declare const builtInCanvasExtensions: readonly [import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<TextExtensionOptions>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>, import("../_vendor/canvas-react/host/index").ConfigurableLandExtension<Record<string, never>>];
 export type BuiltInCanvasExtension = (typeof builtInCanvasExtensions)[number];
 export declare function createBuiltInCanvasExtensions(options?: BuiltInCanvasExtensionOptions): readonly BuiltInCanvasExtension[];
 export declare function hasBuiltInCanvasExtension(extensions: readonly BuiltInCanvasExtension[], name: keyof BuiltInCanvasExtensionOptions): boolean;

package/chrome/bindings/useCanvasKitLayerTree.d.ts

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

package/chrome/types.d.ts

@@ -37,13 +37,17 @@ export interface CanvasKitPersistenceControls {
     isDiscardingUnsupportedRecords: boolean;
     status: ProductPersistenceStatus | null;
 }
+export interface CanvasKitLayerTreeSource {
+    getSnapshot(pageId?: string): readonly BuiltInCanvasLayerNode[];
+    subscribe(onStoreChange: () => void): () => void;
+}
 export interface CanvasKitChromeContext<TController extends CanvasKitBaseController = CanvasKitController> {
     controller: TController;
     contextMenu: CanvasKitContextMenuState;
     currentPageId: string;
     currentPageShapeIds: readonly ShapeId[];
     history: HistoryControls;
-    layers: readonly BuiltInCanvasLayerNode[];
+    layerTree: CanvasKitLayerTreeSource;
     pages: PageControls;
     selection: EditorSelectionState;
     selectedShapeIds: readonly ShapeId[];

package/chrome/useCanvasKitChromeContext.d.ts

@@ -1,5 +1,5 @@
 import { type RefObject } from "react";
-import type { ActiveContextMenu } from "../_vendor/canvas-core/index";
+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";

package/controller/canvasKitController.d.ts

@@ -7,7 +7,7 @@ export type CanvasKitTextInput = BuiltInCanvasTextInput;
 export type CanvasKitFrameInput = BuiltInCanvasFrameInput;
 export interface CanvasKitBaseController<TToolId extends string = string> extends CanvasProductController<TToolId> {
 }
-export declare const CANVAS_KIT_TOOL_IDS: readonly ["select", "hand", "rectangle", "ellipse", "diamond", "triangle", "hexagon", "star", "arrow", "draw", "text", "frame", "eraser", "laser"];
+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;

package/core/controller/canvasProductController.d.ts

@@ -1,4 +1,4 @@
-import type { Camera, Editor, LayerOrderDirection, LayerOrderEdge, ReparentShapePlacementFailureReason, ShapeId } from "../../_vendor/canvas-core/index";
+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";
 export interface CanvasProductShapeRef {
@@ -28,6 +28,14 @@ export interface CanvasProductControllerSnapshot<TToolId extends string = string
     shapeCount: number;
     session: CanvasProductSessionSnapshot<TToolId>;
 }
+export type CanvasProductControllerChangeKey = "document" | "session" | "pageId" | "activeToolId" | "selectedShapeIds" | "shapeCount";
+export interface CanvasProductControllerChange<TToolId extends string = string> {
+    source: ChangeSource;
+    changes: readonly CanvasProductControllerChangeKey[];
+    snapshot: CanvasProductControllerSnapshot<TToolId>;
+    previousSnapshot: CanvasProductControllerSnapshot<TToolId>;
+}
+export type CanvasProductControllerChangeListener<TToolId extends string = string> = (change: CanvasProductControllerChange<TToolId>) => void;
 export interface CanvasProductLayerNode {
     id: ShapeId;
     parentId: string;
@@ -69,6 +77,7 @@ export interface CanvasProductPageRef {
 export interface CanvasProductController<TToolId extends string = string> {
     features: ProductFeatureControllerRegistry;
     snapshot(): CanvasProductControllerSnapshot<TToolId>;
+    subscribe(listener: CanvasProductControllerChangeListener<TToolId>): () => void;
     clearHistory(): void;
     canUndo(): boolean;
     canRedo(): boolean;

package/core/controller/index.d.ts

@@ -1,4 +1,4 @@
 export { createProductFeatureControllerRegistry, createProductFeatureControllerToken, } from "./featureControllerRegistry";
 export type { ProductFeatureControllerRegistry, ProductFeatureControllerRegistryRuntime, ProductFeatureControllerToken, } from "./featureControllerRegistry";
 export { createCanvasProductController } from "./canvasProductController";
-export type { CanvasProductController, CanvasProductControllerContext, CanvasProductControllerOptions, CanvasProductControllerSnapshot, CanvasProductLayerActionState, CanvasProductLayerNode, CanvasProductLayerPlacement, CanvasProductLayerPlacementFailureReason, CanvasProductLayerPlacementResult, CanvasProductPageRef, CanvasProductSessionPageState, CanvasProductSessionSnapshot, CanvasProductShapeRef, } from "./canvasProductController";
+export type { CanvasProductController, CanvasProductControllerChange, CanvasProductControllerChangeKey, CanvasProductControllerChangeListener, CanvasProductControllerContext, CanvasProductControllerOptions, CanvasProductControllerSnapshot, CanvasProductLayerActionState, CanvasProductLayerNode, CanvasProductLayerPlacement, CanvasProductLayerPlacementFailureReason, CanvasProductLayerPlacementResult, CanvasProductPageRef, CanvasProductSessionPageState, CanvasProductSessionSnapshot, CanvasProductShapeRef, } from "./canvasProductController";

package/core/index.d.ts

@@ -8,6 +8,7 @@ export type { CanvasProductRuntimeContribution, } from "./runtime/productContrib
 export type { 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, } 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";

package/index.d.ts

@@ -4,12 +4,14 @@ export type { TextExtensionOptions, TextFontDefinition, TextFontFaceSource, Text
 export type { CustomShapeColorRef, ShapeColor, ShapeColorRef, ThemeColorSlot, ThemeColorTokenName, ThemeShapeColorRef, } from "./_vendor/canvas-core/index";
 export { CanvasKitFloatingToolbarLayer, } from "./chrome/CanvasKitFloatingToolbarLayer";
 export { FloatingSelectionToolbarPageSpace, } from "./chrome/FloatingSelectionToolbarPageSpace";
+export { useCanvasKitLayerTree, } from "./chrome/bindings/useCanvasKitLayerTree";
 import "./index.css";
 export { createCanvasKitController, createCanvasKitControllerWithTools, } from "./controller/canvasKitController";
 export { CanvasKitRoot } from "./react/CanvasKitRoot";
 export { defineCanvasKit } from "./product/canvasKitProduct";
 export { CANVAS_KIT_TOOL_IDS } from "./controller/canvasKitController";
 export type { CanvasKitController, CanvasKitControllerRuntimeContext, CanvasKitControllerOptions, CanvasKitControllerSnapshot, CanvasKitControllerWithToolsOptions, CanvasKitBaseController, CanvasKitControllerWithTools, CanvasKitFrameInput, CanvasKitShapeInput, CanvasKitTextInput, CanvasKitToolId, } from "./controller/canvasKitController";
-export type { CanvasKitChromeContext, CanvasKitContextMenuState, CanvasKitGridControls, CanvasKitLayerNode, CanvasKitPersistenceControls, CanvasKitToolbarActionState, CanvasKitToolbarRuntime, ContextMenuCommandItem, ContextMenuItem, ContextMenuSection, EditorSelectionState, HistoryControls, PageControls, ShapeId, SvgExportControls, CanvasActionValue, CanvasActionContext, ToolbarGroup, ToolbarItem, ToolbarSurfaces, ZoomControlsState, } from "./chrome/types";
+export type { CanvasProductControllerChange, CanvasProductControllerChangeKey, CanvasProductControllerChangeListener, } from "./core";
+export type { CanvasKitChromeContext, CanvasKitContextMenuState, CanvasKitGridControls, CanvasKitLayerNode, CanvasKitLayerTreeSource, CanvasKitPersistenceControls, CanvasKitToolbarActionState, CanvasKitToolbarRuntime, ContextMenuCommandItem, ContextMenuItem, ContextMenuSection, EditorSelectionState, HistoryControls, PageControls, ShapeId, SvgExportControls, CanvasActionValue, CanvasActionContext, ToolbarGroup, ToolbarItem, ToolbarSurfaces, ZoomControlsState, } from "./chrome/types";
 export type { CanvasKitDocumentSeed, CanvasKitExtensionOptions, CanvasKitProduct, CanvasKitProductOptions, CanvasKitChromeRenderer, } from "./product/canvasKitProduct";
 export type { ExportStatus, ProductPersistenceStatus, } from "./core";