@weasel-js/core 1.0.2 → 1.0.3

package/dist/index.js

@@ -1,12 +1,12 @@
-export { ALWAYS, ANCHOR_HIT_BASE_PX, ActionsProviderIfRoot, ActiveToolContextProvider, ActiveToolContextProviderIfRoot, BUNDLE_TOOLS, COARSE_TARGET_SCALE, CURVE_REPS, ColorOverrideRegistry, CropIcon, CursorCoordsHud, DEFAULT_ALPHA_DECAY, DEFAULT_ALPHA_MIN, DEFAULT_DEBUG_STROKES, DEFAULT_DEBUG_THEME, DEFAULT_DEVICE_PROFILE, DEFAULT_FILL_COLOR, DEFAULT_HANDLE_SIZE, DEFAULT_PALETTE, DEFAULT_ROTATION_HANDLE_DISTANCE, DEFAULT_STROKE_COLOR, DEFAULT_TEXT_STYLE, DEFAULT_VELOCITY_DECAY, DepRegistryProviderIfRoot, DeviceProfileProvider, DivideIcon, EASINGS, EllipseIcon, ExcludeIcon, EyedropperIcon, FALLBACK_FIT_VIEW, GHOST_STROKE, HANDLE_BASE_PX, HandIcon, IDENTITY_POSE_COMPOSITION, IntersectIcon, KIT_SHAPE_KINDS, LassoIcon, LineIcon, MIXED, MOVE_ANCHORS, MinimapCanvas, NEVER, PATH_ANCHOR_CHROME_ID, PenIcon, PencilIcon, PickHud, PointerProviderIfRoot, PolygonIcon, RECT_ALIGN_PROJECTION, ROTATION_HANDLE_BASE_PX, RectIcon, SPRING_PRESETS, SceneCanvas, SceneViewCanvas, SelectIcon, SelectionContextProvider, SelectionContextProviderIfRoot, StarIcon, SubtractIcon, TextIcon, UnionIcon, UnknownIcon, VERSION, WeaselProvider, aabbCenter, actionIs, alignDeltaFor, alignInsertBehavior, alignMoveBehavior, alignResizeBehavior, alignedStrokeRect, always, and, animateLifecycle, animateOnSetPose, annulusSemiAxes, applyBooleanOp, applyHitExistingGate, applyStyleToRange, areaSelectAction, arrayAdapter, asNodeId, bezierCubic, bezierQuadratic, buildChromeCtx, buildRuleCtx, buildSceneViewCommands, canBringForward, canHover, canQueryLocalFonts2 as canQueryLocalFonts, canSendBackward, capabilityAll, capabilityIn, capabilityIs, capabilityNot, caretIndexAt, cellAt, charOffsetToDomPosition, clampView, clearSelectionAction, clientToCanvas, clipboardCopyAction, clipboardCutAction, cloneAction, coarsePointer, composeAffordanceLayer, composePath, composeRectPose, composeSelectionPose, composeWorldPose, computeFitView, computeIndicatorCommand, computeWheelAction, cond, constrainTo45, containedThenNearest, countPathAnchors, createCellHighlightLayer, createChildrenLayer, createCornerResizeAffordance, createDebugOverlayLayer, createDebugSink, createDispatcher, createGridLayer, createGuidesLayer, createHistory, createMarkdownRenderer, createMoveToIndexOp, createNodeProperties, createNodeRouting, createParallaxLayer, createPathAnchorAffordances, createPathEditingOverlayLayer, createPathLayer, createPenPreviewLayer, createReorderOp, createRotationAffordance, createScene, createSelectionHandlesLayer, createSelectionOutlineLayer, createSelectionOverlayLayer, createSetDataOp, createSetLayerOp, createSetPathOp, createSetTextOp, createTextLayer, createViewportLayer, cycleVertexColors, decomposePath, decomposeRectPose, defaultCommitAdapter, defaultDrawOne, defaultLabelTextRenderer, defaultNodeProperties, defaultNodeRouting, defaultVisibilityRules, defineTool, defineViewportTool, deriveAlignmentGuides, deriveParallaxView, describeRule, domPositionToCharOffset, domToRuns, drawLayers, easeIn, easeInBack, easeInBounce, easeInCirc, easeInCubic, easeInElastic, easeInExpo, easeInOut, easeInOutBack, easeInOutBounce, easeInOutCirc, easeInOutCubic, easeInOutElastic, easeInOutExpo, easeInOutQuad, easeInOutQuart, easeInOutQuint, easeInOutSine, easeInQuad, easeInQuart, easeInQuint, easeInSine, easeOut, easeOutBack, easeOutBounce, easeOutCirc, easeOutCubic, easeOutElastic, easeOutExpo, easeOutQuad, easeOutQuart, easeOutQuint, easeOutSine, editAnchorsAction, enableLocalFontOutlines2 as enableLocalFontOutlines, enterTextEditAction, enumerateAnchors, evaluate, fillInPoseFrame, fillToBoundsFrame, findNodeShape, findShapeInk, findShapeSilhouette, fitTextPose, fitToBounds, fitViewToBounds, fitZoom, focused, fontString, forEachCoalesced, freeform, gateLayer, gesturing, getAlpha01, getImageBitmap, getNodeShapes, getStylusData, gradientForBounds, gradientGeometry, hasFontOutlines2 as hasFontOutlines, hexToRgba, hitAffordanceRegions, hitAnchor, hitRotationHandle, hovering, hoveringSelected, imageStatus, inferredNodeProperties, inferredNodeRouting, insertAction, isCanvasFont2 as isCanvasFont, isEditableTarget, isPatternSpec, lassoSelectAction, layoutMarkdown, lerpColorArray, lerpOklab, lerpOklch, linear, listFontOutlines2 as listFontOutlines, liveScope, makeViewportZoomAction, markdownToRuns, matchAlignment, matchesKeyBinding, meanScale, measureText, measureTextBounds, measuredWidth, mergeAlphaFromPrev, mergeContributions, modeIn, modeIs, modeNot, modifierHeld, momentum, moveAction, multiActive, nearest, nearestWithin, nestedHitTester, never, nodeHasFlag, none, normalizeHex, not, nurbs, oklabToOklch, oklabToSrgbU8, oklchToOklab, openFilePicker, or, outlineStatus2 as outlineStatus, parseColor, parseColorToRgba255, parseDebugFlags, pathContainsPoint, pathContainsPolygon, pathContainsRect, pathDistanceToPoint, pathDivide, pathExclude, pathFromD, pathInPoseFrame, pathInWorld, pathIntersect, pathIntersectsPolygon, pathIntersectsRect, pathOriginProjection, pathSubtract, pathToAnchors, pathUnion, pickTopMostHit, pinchZoomAction, planPixelRender, pointInRotatedRect, pointInTextPose, poseRotationOf, pressureToWidth, rainbowVertexColors, rebaseLocalPose, rectCorners, registerCanvasFont2 as registerCanvasFont, registerContentHandler, registerFont2 as registerFont, registerFontOutlines2 as registerFontOutlines, registerNodeShape, renderLabel, renderSceneToCanvas, renderSceneToPixels, resizeAction, resolveColor, resolveDeviceProfile, resolveFillPattern, resolvePatternSpec, resolveRuns, resolveTextStyle, resolveVisibility, rgbaToHex, rotateAction, rotateAroundAABBCenter, rotatePathAround, rotatePoint, rotatedRectCorners, rotationDegreesUnit, rotationHandle, roundToCell, runsToDom, runsToMarkdown, runsToPlainText, sampleGradientStops, sceneFromJSON, sceneNodeClientRect, sceneToAdapter, scopeBindings, screenToWorld, selectFromLasso, selectionAtLeast, selectionEmpty, selectionIs, setFlagOverRange, shapeCoversPoint, sliceAction, snapPoint, solidVertexColors, specificity, spiro, splitPathByLine, splitSubpaths, springPose, springVertexColors, srgbU8ToOklab, staggerVertexColors, startThresholdDrag, styleAtRange, subscribeGlyphReady2 as subscribeGlyphReady, subscribeImageReady, textCommand, textLineBoxes, tileGrid, toHex8, toRuns, translatePoseViaDescriptor, translateRectPose, tweenPose, tweenVertexColors, unionBounds, unionBoundsPath, unregisterCanvasFont2 as unregisterCanvasFont, unregisterFontOutlines2 as unregisterFontOutlines, useActiveToolContext, useAlign, useAnimator, useArrayAdapter, useAutoCenter, useBooleans, useBooleansAdapter, useCanvasFocus, useCanvasSize, useDecayLoop, useDeviceProfile, useDistribute, useDragGesture, useDragHandle, useDragRadial, useDragRect, useDropZone, useEllipseTool, useEyedropperTool, useGestureDispatcher, useGridCellHover, useGuides, useHandTool, useHandleDrag, useHoverTracking, useImageTool, useKeybindings, useLassoTool, useLineTool, useOptionalActiveToolContext, usePenTool, usePencilTool, usePinchGesture, usePinchZoomTool, usePointerStylus, usePolygonTool, usePublishSelection, useRectTool, useResizePolicy, useRotateTool, useScene, useSceneAdapter, useSceneTextEdit, useSelectTool, useSelection, useSelectionContext, useSimulation, useSliceDep, useStandardActions, useStarTool, useTextEdit, useTextTool, useTools, useVelocityTracker, useViewAnimation, useViewTween, useZoom, verticalAlignOffset, viewToMat3, viewToTransform, viewportDragPanAction, viewportZoomAction, viewportsAt, when, withAlpha01, withCoord, withGradientKind, worldEditToStorage, worldPoseLookup, worldToScreen, zoomAt, zoomAtLeast } from './chunk-PI56ORHE.js';
-export { ActionDisabledReason, ActionsProvider, DepRegistryProvider, evaluateEnabled, useAction, useActionsRegistry, useDepRegistry, useDepSource, useOptionalDepRegistry } from './chunk-W2WB4352.js';
-export { createReparentOp, createTransformOp, deleteScratch, getScratch, scratchKey, setScratch, snap } from './chunk-UB6A6L77.js';
-export { CORNER_ANCHORS, cornerPoint, cornerResizeHandles, hitCornerHandle, pointSnapToGrid } from './chunk-Z3KNFTTS.js';
-export { DEFAULT_FLATTEN_TOLERANCE, DEFAULT_GUIDE_TOLERANCE_PX, IMPERIAL_INCHES, METRIC_MM, PATH_C, PATH_CMD_LENGTHS, PATH_L, PATH_M, PATH_Q, PATH_Z, PIXELS, PathBuilder, RECT_ORIGIN_PROJECTION, RECT_POSE_DESCRIPTOR, ROTATED_POSE_DESCRIPTOR, boundsOfPath, ellipsePath, flattenCubic, flattenCubicWithArcLen, flattenQuadratic, flattenQuadraticWithArcLen, formatUnit, gridSnapStrategy, guideSnapStrategy, linePath, pathPoseDescriptor, pointInPath, pointToGridCell, polygonFromPoints, pxExtent, rectPath, regularPolygonPath, resolveUnit, scaleDelta, scalePathToBounds, starPath, transformPath, translatePath, translatePolygonInPlace, withinPxBox, withinPxRadius } from './chunk-6SHZHXXR.js';
-export { PointerContextProvider, WEASEL_CLIPBOARD_MIME, WEASEL_CLIPBOARD_MIME_WEB, applyOpsTo, buildWeaselClipboardText, dispatchApplyBatch, dlog, dwarn, embedWeaselMetadataInSvg, extractWeaselClipboardFromSvg, isDebugEnabled, parseWeaselClipboardText, sniffWeaselClipboardText, useClipboardOps, usePointerContext } from './chunk-775XXAHR.js';
+export { ALWAYS, ANCHOR_HIT_BASE_PX, ActionsProviderIfRoot, ActiveToolContextProvider, ActiveToolContextProviderIfRoot, BUNDLE_TOOLS, COARSE_TARGET_SCALE, CURVE_REPS, ColorOverrideRegistry, CropIcon, CursorCoordsHud, DEFAULT_ALPHA_DECAY, DEFAULT_ALPHA_MIN, DEFAULT_DEBUG_STROKES, DEFAULT_DEBUG_THEME, DEFAULT_DEVICE_PROFILE, DEFAULT_FILL_COLOR, DEFAULT_HANDLE_SIZE, DEFAULT_PALETTE, DEFAULT_ROTATION_HANDLE_DISTANCE, DEFAULT_STROKE_COLOR, DEFAULT_TEXT_STYLE, DEFAULT_VELOCITY_DECAY, DepRegistryProviderIfRoot, DeviceProfileProvider, DivideIcon, EASINGS, EllipseIcon, ExcludeIcon, EyedropperIcon, FALLBACK_FIT_VIEW, GHOST_STROKE, HANDLE_BASE_PX, HandIcon, IDENTITY_POSE_COMPOSITION, IntersectIcon, KIT_SHAPE_KINDS, LassoIcon, LineIcon, MIXED, MOVE_ANCHORS, MinimapCanvas, NEVER, PATH_ANCHOR_CHROME_ID, PenIcon, PencilIcon, PickHud, PointerProviderIfRoot, PolygonIcon, RECT_ALIGN_PROJECTION, ROTATION_HANDLE_BASE_PX, RectIcon, SPRING_PRESETS, SceneCanvas, SceneViewCanvas, SelectIcon, SelectionContextProvider, SelectionContextProviderIfRoot, StarIcon, SubtractIcon, TextIcon, UnionIcon, UnknownIcon, VERSION, WeaselProvider, aabbCenter, actionIs, alignDeltaFor, alignInsertBehavior, alignMoveBehavior, alignResizeBehavior, alignedStrokeRect, always, and, animateLifecycle, animateOnSetPose, annulusSemiAxes, applyBooleanOp, applyHitExistingGate, applyStyleToRange, areaSelectAction, arrayAdapter, asNodeId, bezierCubic, bezierQuadratic, buildChromeCtx, buildRuleCtx, buildSceneViewCommands, canBringForward, canHover, canQueryLocalFonts2 as canQueryLocalFonts, canSendBackward, capabilityAll, capabilityIn, capabilityIs, capabilityNot, caretIndexAt, cellAt, charOffsetToDomPosition, clampView, clearSelectionAction, clientToCanvas, clipboardCopyAction, clipboardCutAction, cloneAction, coarsePointer, composeAffordanceLayer, composePath, composeRectPose, composeSelectionPose, composeWorldPose, computeFitView, computeIndicatorCommand, computeWheelAction, cond, constrainTo45, containedThenNearest, countPathAnchors, createCellHighlightLayer, createChildrenLayer, createCornerResizeAffordance, createDebugOverlayLayer, createDebugSink, createDispatcher, createGridLayer, createGuidesLayer, createHistory, createMarkdownRenderer, createMoveToIndexOp, createNodeProperties, createNodeRouting, createParallaxLayer, createPathAnchorAffordances, createPathEditingOverlayLayer, createPathLayer, createPenPreviewLayer, createReorderOp, createRotationAffordance, createScene, createSelectionHandlesLayer, createSelectionOutlineLayer, createSelectionOverlayLayer, createSetDataOp, createSetLayerOp, createSetPathOp, createSetTextOp, createTextLayer, createViewportLayer, cycleVertexColors, decomposePath, decomposeRectPose, defaultCommitAdapter, defaultDrawOne, defaultLabelTextRenderer, defaultNodeProperties, defaultNodeRouting, defaultVisibilityRules, defineTool, defineViewportTool, deriveAlignmentGuides, deriveParallaxView, describeRule, domPositionToCharOffset, domToRuns, drawLayers, easeIn, easeInBack, easeInBounce, easeInCirc, easeInCubic, easeInElastic, easeInExpo, easeInOut, easeInOutBack, easeInOutBounce, easeInOutCirc, easeInOutCubic, easeInOutElastic, easeInOutExpo, easeInOutQuad, easeInOutQuart, easeInOutQuint, easeInOutSine, easeInQuad, easeInQuart, easeInQuint, easeInSine, easeOut, easeOutBack, easeOutBounce, easeOutCirc, easeOutCubic, easeOutElastic, easeOutExpo, easeOutQuad, easeOutQuart, easeOutQuint, easeOutSine, editAnchorsAction, enableLocalFontOutlines2 as enableLocalFontOutlines, enterTextEditAction, enumerateAnchors, evaluate, fillInPoseFrame, fillToBoundsFrame, findNodeShape, findShapeInk, findShapeSilhouette, fitTextPose, fitToBounds, fitViewToBounds, fitZoom, focused, fontString, forEachCoalesced, freeform, gateLayer, gesturing, getAlpha01, getImageBitmap, getNodeShapes, getStylusData, gradientForBounds, gradientGeometry, hasFontOutlines2 as hasFontOutlines, hexToRgba, hitAffordanceRegions, hitAnchor, hitRotationHandle, hovering, hoveringSelected, imageStatus, inferredNodeProperties, inferredNodeRouting, insertAction, isCanvasFont2 as isCanvasFont, isEditableTarget, isPatternSpec, lassoSelectAction, layoutMarkdown, lerpColorArray, lerpOklab, lerpOklch, linear, listFontOutlines2 as listFontOutlines, liveScope, makeViewportZoomAction, markdownToRuns, matchAlignment, matchesKeyBinding, meanScale, measureText, measureTextBounds, measuredWidth, mergeAlphaFromPrev, mergeContributions, modeIn, modeIs, modeNot, modifierHeld, momentum, moveAction, multiActive, nearest, nearestWithin, nestedHitTester, never, nodeHasFlag, none, normalizeHex, not, nurbs, oklabToOklch, oklabToSrgbU8, oklchToOklab, openFilePicker, or, outlineStatus2 as outlineStatus, parseColor, parseColorToRgba255, parseDebugFlags, pathContainsPoint, pathContainsPolygon, pathContainsRect, pathDistanceToPoint, pathDivide, pathExclude, pathFromD, pathInPoseFrame, pathInWorld, pathIntersect, pathIntersectsPolygon, pathIntersectsRect, pathOriginProjection, pathSubtract, pathToAnchors, pathUnion, pickTopMostHit, pinchZoomAction, planPixelRender, pointInRotatedRect, pointInTextPose, poseRotationOf, pressureToWidth, rainbowVertexColors, rebaseLocalPose, rectCorners, registerCanvasFont2 as registerCanvasFont, registerContentHandler, registerFont2 as registerFont, registerFontOutlines2 as registerFontOutlines, registerNodeShape, renderLabel, renderSceneToCanvas, renderSceneToPixels, resizeAction, resolveColor, resolveDeviceProfile, resolveFillPattern, resolvePatternSpec, resolveRuns, resolveTextStyle, resolveVisibility, rgbaToHex, rotateAction, rotateAroundAABBCenter, rotatePathAround, rotatePoint, rotatedRectCorners, rotationDegreesUnit, rotationHandle, roundToCell, runsToDom, runsToMarkdown, runsToPlainText, sampleGradientStops, sceneFromJSON, sceneNodeClientRect, sceneToAdapter, scopeBindings, screenToWorld, selectFromLasso, selectionAtLeast, selectionEmpty, selectionIs, setFlagOverRange, shapeCoversPoint, sliceAction, snapPoint, solidVertexColors, specificity, spiro, splitPathByLine, splitSubpaths, springPose, springVertexColors, srgbU8ToOklab, staggerVertexColors, startThresholdDrag, styleAtRange, subscribeGlyphReady2 as subscribeGlyphReady, subscribeImageReady, textCommand, textLineBoxes, tileGrid, toHex8, toRuns, translatePoseViaDescriptor, translateRectPose, tweenPose, tweenVertexColors, unionBounds, unionBoundsPath, unregisterCanvasFont2 as unregisterCanvasFont, unregisterFontOutlines2 as unregisterFontOutlines, useActiveToolContext, useAlign, useAnimator, useArrayAdapter, useAutoCenter, useBooleans, useBooleansAdapter, useCanvasFocus, useCanvasSize, useDecayLoop, useDeviceProfile, useDistribute, useDragGesture, useDragHandle, useDragRadial, useDragRect, useDropZone, useEllipseTool, useEyedropperTool, useGestureDispatcher, useGridCellHover, useGuides, useHandTool, useHandleDrag, useHoverTracking, useImageTool, useKeybindings, useLassoTool, useLineTool, useOptionalActiveToolContext, usePenTool, usePencilTool, usePinchGesture, usePinchZoomTool, usePointerStylus, usePolygonTool, usePublishSelection, useRectTool, useResizePolicy, useRotateTool, useScene, useSceneAdapter, useSceneTextEdit, useSelectTool, useSelection, useSelectionContext, useSimulation, useSliceDep, useStandardActions, useStarTool, useTextEdit, useTextTool, useTools, useVelocityTracker, useViewAnimation, useViewTween, useZoom, verticalAlignOffset, viewToMat3, viewToTransform, viewportDragPanAction, viewportZoomAction, viewportsAt, when, withAlpha01, withCoord, withGradientKind, worldEditToStorage, worldPoseLookup, worldToScreen, zoomAt, zoomAtLeast } from './chunk-SMCZRSYB.js';
+export { ActionDisabledReason, ActionsProvider, DepRegistryProvider, evaluateEnabled, useAction, useActionsRegistry, useDepRegistry, useDepSource, useOptionalDepRegistry } from './chunk-TR3HZN34.js';
+export { createReparentOp, createTransformOp, deleteScratch, getScratch, scratchKey, setScratch, snap } from './chunk-3KGMJMOS.js';
+export { CORNER_ANCHORS, cornerPoint, cornerResizeHandles, hitCornerHandle, pointSnapToGrid } from './chunk-3JYFAQIB.js';
+export { DEFAULT_FLATTEN_TOLERANCE, DEFAULT_GUIDE_TOLERANCE_PX, IMPERIAL_INCHES, METRIC_MM, PATH_C, PATH_CMD_LENGTHS, PATH_L, PATH_M, PATH_Q, PATH_Z, PIXELS, PathBuilder, RECT_ORIGIN_PROJECTION, RECT_POSE_DESCRIPTOR, ROTATED_POSE_DESCRIPTOR, boundsOfPath, ellipsePath, flattenCubic, flattenCubicWithArcLen, flattenQuadratic, flattenQuadraticWithArcLen, formatUnit, gridSnapStrategy, guideSnapStrategy, linePath, pathPoseDescriptor, pointInPath, pointToGridCell, polygonFromPoints, pxExtent, rectPath, regularPolygonPath, resolveUnit, scaleDelta, scalePathToBounds, starPath, transformPath, translatePath, translatePolygonInPlace, withinPxBox, withinPxRadius } from './chunk-U45SODC2.js';
+export { PointerContextProvider, WEASEL_CLIPBOARD_MIME, WEASEL_CLIPBOARD_MIME_WEB, applyOpsTo, buildWeaselClipboardText, dispatchApplyBatch, dlog, dwarn, embedWeaselMetadataInSvg, extractWeaselClipboardFromSvg, isDebugEnabled, parseWeaselClipboardText, sniffWeaselClipboardText, useClipboardOps, usePointerContext } from './chunk-JOSUVS6C.js';
 export { cloneByAltDrag } from './chunk-UGFFCMQP.js';
 export { createSetSelectionOp } from './chunk-BHVYVFGV.js';
 export { createDeleteOp, createInsertOp, rebuildOp, registerOpFactory } from './chunk-GVCNT7UH.js';
-export { createTilePattern } from './chunk-IO5Z75X4.js';
+export { createTilePattern } from './chunk-HGF5X6MZ.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/insert.d.ts

@@ -1,11 +1,14 @@
-export { U as UseInsertOptions } from './options-DoOvx50U.js';
-import { M as ModifierState, I as InsertBehavior } from './types-Ct4n0Z38.js';
+export { U as UseInsertOptions } from './options-CbsIgQci.js';
+import { M as ModifierState, I as InsertBehavior } from './types-ByZxoD6P.js';
 import { G as Guide } from './types-D2tTKEU0.js';
 import { V as View } from './view-DSQgxBJB.js';
 import '@weasel-js/history';
-import './types-Ch0Goo-j.js';
+import './types-DpQ0cWYC.js';
 
 type ModKey$1 = keyof ModifierState;
+/** Insert behavior that rounds the insertion point to a grid, so a shape
+ *  drawn freehand lands on grid intersections. Hold `bypassKey` to place
+ *  freely. */
 declare function snapToGrid<TPose>(args: {
     spacing: number;
     bypassKey?: ModKey$1;

package/dist/insert.js

@@ -1,4 +1,4 @@
-import { DEFAULT_GUIDE_TOLERANCE_PX, pxExtent } from './chunk-6SHZHXXR.js';
+import { DEFAULT_GUIDE_TOLERANCE_PX, pxExtent } from './chunk-U45SODC2.js';
 
 // src/interactions/actions/insert/behaviors/snapToGrid.ts
 function snapToGrid(args) {

package/dist/insert.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/interactions/actions/insert/behaviors/snapToGrid.ts","../src/interactions/actions/insert/behaviors/snapToGuides.ts"],"names":[],"mappings":"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","file":"insert.js","sourcesContent":["import type {\n  InsertBehavior,\n  InsertPoint,\n  ModifierState,\n} from '../../../gestures/types';\n\ntype ModKey = keyof ModifierState;\n\nexport function snapToGrid<TPose>(args: {\n  spacing: number;\n  bypassKey?: ModKey;\n}): InsertBehavior<TPose> {\n  const { spacing, bypassKey } = args;\n  const round = (v: number) => Math.round(v / spacing) * spacing;\n  return {\n    onStart(ctx) {\n      if (bypassKey && ctx.modifiers[bypassKey]) return;\n      const id = ctx.draggedIds[0];\n      const o = ctx.origin.get(id) as unknown as InsertPoint | undefined;\n      if (!o) return;\n      ctx.origin.set(id, { x: round(o.x), y: round(o.y) } as unknown as TPose);\n    },\n    onMove(ctx, { current }) {\n      if (bypassKey && ctx.modifiers[bypassKey]) return;\n      return { current: { x: round(current.x), y: round(current.y) } };\n    },\n  };\n}\n","import type {\n  InsertBehavior,\n  InsertPoint,\n  ModifierState,\n} from '../../../gestures/types';\nimport type { Guide } from 'features/guides/types';\nimport type { View } from 'core/viewport/view';\nimport { pxExtent } from 'core/viewport/pxExtent';\nimport { DEFAULT_GUIDE_TOLERANCE_PX } from '../../../gestures/shared/strategies/guides';\n\ntype ModKey = keyof ModifierState;\n\n/** Options for the insert-flavored `snapToGuides`. */\nexport interface SnapToGuidesInsertArgs {\n  /** Stable getter into the live guide list (typically from `useGuides`). */\n  getGuides: () => readonly Guide[];\n  /** Snap tolerance (screen px when `getView` is set, world units otherwise). */\n  tolerance?: number;\n  /** Read the active view; required for screen-pixel tolerance. */\n  getView?: () => View;\n  /** Modifier key that bypasses snapping while held. */\n  bypassKey?: ModKey;\n}\n\nfunction snapPoint(\n  p: InsertPoint,\n  guides: readonly Guide[],\n  tol: { x: number; y: number },\n): InsertPoint | null {\n  let bestDx = 0;\n  let bestAbsDx = Infinity;\n  let bestDy = 0;\n  let bestAbsDy = Infinity;\n  for (const g of guides) {\n    if (g.axis === 'x') {\n      const d = g.offset - p.x;\n      const ad = Math.abs(d);\n      if (ad <= tol.x && ad < bestAbsDx) {\n        bestAbsDx = ad;\n        bestDx = d;\n      }\n    } else {\n      const d = g.offset - p.y;\n      const ad = Math.abs(d);\n      if (ad <= tol.y && ad < bestAbsDy) {\n        bestAbsDy = ad;\n        bestDy = d;\n      }\n    }\n  }\n  if (bestAbsDx === Infinity && bestAbsDy === Infinity) return null;\n  const dx = bestAbsDx === Infinity ? 0 : bestDx;\n  const dy = bestAbsDy === Infinity ? 0 : bestDy;\n  if (dx === 0 && dy === 0) return null;\n  return { x: p.x + dx, y: p.y + dy };\n}\n\n/**\n * Insert behavior that snaps the start anchor (on gesture start) and the\n * live current point (during drag) to the nearest guide on each axis when\n * within `tolerance`. Pair with `useGuides` and `createGuidesLayer`.\n */\nexport function snapToGuides<TPose>(\n  args: SnapToGuidesInsertArgs,\n): InsertBehavior<TPose> {\n  const tolerance = args.tolerance ?? DEFAULT_GUIDE_TOLERANCE_PX;\n  const getView = args.getView;\n  const bypassKey = args.bypassKey;\n\n  // Per axis: a vertical guide is matched by a horizontal distance, so it\n  // answers to `scale.x` alone.\n  const computeWorldTol = (): { x: number; y: number } =>\n    getView ? pxExtent(tolerance, getView().scale) : { x: tolerance, y: tolerance };\n\n  return {\n    onStart(ctx) {\n      if (bypassKey && ctx.modifiers[bypassKey]) return;\n      const guides = args.getGuides();\n      if (guides.length === 0) return;\n      const id = ctx.draggedIds[0];\n      const o = ctx.origin.get(id) as unknown as InsertPoint | undefined;\n      if (!o) return;\n      const snapped = snapPoint(o, guides, computeWorldTol());\n      if (snapped) ctx.origin.set(id, snapped as unknown as TPose);\n    },\n    onMove(ctx, { current }) {\n      if (bypassKey && ctx.modifiers[bypassKey]) return;\n      const guides = args.getGuides();\n      if (guides.length === 0) return;\n      const snapped = snapPoint(current, guides, computeWorldTol());\n      if (!snapped) return;\n      return { current: snapped };\n    },\n  };\n}\n"]}
+{"version":3,"sources":["../src/interactions/actions/insert/behaviors/snapToGrid.ts","../src/interactions/actions/insert/behaviors/snapToGuides.ts"],"names":[],"mappings":"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","file":"insert.js","sourcesContent":["import type {\n  InsertBehavior,\n  InsertPoint,\n  ModifierState,\n} from '../../../gestures/types';\n\ntype ModKey = keyof ModifierState;\n\n/** Insert behavior that rounds the insertion point to a grid, so a shape\n *  drawn freehand lands on grid intersections. Hold `bypassKey` to place\n *  freely. */\nexport function snapToGrid<TPose>(args: {\n  spacing: number;\n  bypassKey?: ModKey;\n}): InsertBehavior<TPose> {\n  const { spacing, bypassKey } = args;\n  const round = (v: number) => Math.round(v / spacing) * spacing;\n  return {\n    onStart(ctx) {\n      if (bypassKey && ctx.modifiers[bypassKey]) return;\n      const id = ctx.draggedIds[0];\n      const o = ctx.origin.get(id) as unknown as InsertPoint | undefined;\n      if (!o) return;\n      ctx.origin.set(id, { x: round(o.x), y: round(o.y) } as unknown as TPose);\n    },\n    onMove(ctx, { current }) {\n      if (bypassKey && ctx.modifiers[bypassKey]) return;\n      return { current: { x: round(current.x), y: round(current.y) } };\n    },\n  };\n}\n","import type {\n  InsertBehavior,\n  InsertPoint,\n  ModifierState,\n} from '../../../gestures/types';\nimport type { Guide } from 'features/guides/types';\nimport type { View } from 'core/viewport/view';\nimport { pxExtent } from 'core/viewport/pxExtent';\nimport { DEFAULT_GUIDE_TOLERANCE_PX } from '../../../gestures/shared/strategies/guides';\n\ntype ModKey = keyof ModifierState;\n\n/** Options for the insert-flavored `snapToGuides`. */\nexport interface SnapToGuidesInsertArgs {\n  /** Stable getter into the live guide list (typically from `useGuides`). */\n  getGuides: () => readonly Guide[];\n  /** Snap tolerance (screen px when `getView` is set, world units otherwise). */\n  tolerance?: number;\n  /** Read the active view; required for screen-pixel tolerance. */\n  getView?: () => View;\n  /** Modifier key that bypasses snapping while held. */\n  bypassKey?: ModKey;\n}\n\nfunction snapPoint(\n  p: InsertPoint,\n  guides: readonly Guide[],\n  tol: { x: number; y: number },\n): InsertPoint | null {\n  let bestDx = 0;\n  let bestAbsDx = Infinity;\n  let bestDy = 0;\n  let bestAbsDy = Infinity;\n  for (const g of guides) {\n    if (g.axis === 'x') {\n      const d = g.offset - p.x;\n      const ad = Math.abs(d);\n      if (ad <= tol.x && ad < bestAbsDx) {\n        bestAbsDx = ad;\n        bestDx = d;\n      }\n    } else {\n      const d = g.offset - p.y;\n      const ad = Math.abs(d);\n      if (ad <= tol.y && ad < bestAbsDy) {\n        bestAbsDy = ad;\n        bestDy = d;\n      }\n    }\n  }\n  if (bestAbsDx === Infinity && bestAbsDy === Infinity) return null;\n  const dx = bestAbsDx === Infinity ? 0 : bestDx;\n  const dy = bestAbsDy === Infinity ? 0 : bestDy;\n  if (dx === 0 && dy === 0) return null;\n  return { x: p.x + dx, y: p.y + dy };\n}\n\n/**\n * Insert behavior that snaps the start anchor (on gesture start) and the\n * live current point (during drag) to the nearest guide on each axis when\n * within `tolerance`. Pair with `useGuides` and `createGuidesLayer`.\n */\nexport function snapToGuides<TPose>(\n  args: SnapToGuidesInsertArgs,\n): InsertBehavior<TPose> {\n  const tolerance = args.tolerance ?? DEFAULT_GUIDE_TOLERANCE_PX;\n  const getView = args.getView;\n  const bypassKey = args.bypassKey;\n\n  // Per axis: a vertical guide is matched by a horizontal distance, so it\n  // answers to `scale.x` alone.\n  const computeWorldTol = (): { x: number; y: number } =>\n    getView ? pxExtent(tolerance, getView().scale) : { x: tolerance, y: tolerance };\n\n  return {\n    onStart(ctx) {\n      if (bypassKey && ctx.modifiers[bypassKey]) return;\n      const guides = args.getGuides();\n      if (guides.length === 0) return;\n      const id = ctx.draggedIds[0];\n      const o = ctx.origin.get(id) as unknown as InsertPoint | undefined;\n      if (!o) return;\n      const snapped = snapPoint(o, guides, computeWorldTol());\n      if (snapped) ctx.origin.set(id, snapped as unknown as TPose);\n    },\n    onMove(ctx, { current }) {\n      if (bypassKey && ctx.modifiers[bypassKey]) return;\n      const guides = args.getGuides();\n      if (guides.length === 0) return;\n      const snapped = snapPoint(current, guides, computeWorldTol());\n      if (!snapped) return;\n      return { current: snapped };\n    },\n  };\n}\n"]}

package/dist/move.d.ts

@@ -1,13 +1,15 @@
-import { O as OriginProjection } from './grid-CBiLBnyc.js';
-export { U as UseMoveOptions } from './grid-CBiLBnyc.js';
-import { M as ModifierState, b as MoveBehavior } from './types-Ct4n0Z38.js';
-import { S as SnapTarget } from './types-Ch0Goo-j.js';
+import { O as OriginProjection } from './grid-sfilv5HP.js';
+export { U as UseMoveOptions } from './grid-sfilv5HP.js';
+import { M as ModifierState, b as MoveBehavior } from './types-ByZxoD6P.js';
+import { S as SnapTarget } from './types-DpQ0cWYC.js';
 import { G as Guide } from './types-D2tTKEU0.js';
 import { V as View } from './view-DSQgxBJB.js';
-import './types-Dtxe7jTS.js';
+import './types-BHK2dkMu.js';
 import '@weasel-js/history';
 
 type ModKey$1 = keyof ModifierState;
+/** Move behavior that snaps the dragged pose's origin to a grid. Hold
+ *  `bypassKey` to drag freely. */
 declare function snapToGrid<TPose extends {
     x: number;
     y: number;
@@ -16,6 +18,14 @@ declare function snapToGrid<TPose extends {
     bypassKey?: ModKey$1;
 }): MoveBehavior<TPose>;
 
+/**
+ * Move behavior that drops the dragged node into a container it hovers over
+ * for `dwellMs`, reparenting it and taking the pose the container's layout
+ * assigns.
+ *
+ * The dwell is what keeps a drag that merely passes over a container from
+ * being captured by it.
+ */
 declare function snapToContainer<TPose>(args: {
     dwellMs: number;
     findTarget: (draggedId: string, worldX: number, worldY: number) => SnapTarget<TPose> | null;
@@ -24,6 +34,13 @@ declare function snapToContainer<TPose>(args: {
     reparentLabel?: string;
 }): MoveBehavior<TPose>;
 
+/**
+ * Move behavior for a drag that is only meaningful near where it started:
+ * release inside `radius` and the node returns to its original pose; release
+ * outside it and the node either springs back anyway or is deleted, per
+ * `onFreeRelease`. A deletion is recorded as an undoable op with paint order
+ * preserved.
+ */
 declare function snapBackOrDelete<TPose extends {
     x: number;
     y: number;
@@ -32,6 +49,8 @@ declare function snapBackOrDelete<TPose extends {
     onFreeRelease: 'snap-back' | 'delete';
     deleteLabel?: string;
 }): MoveBehavior<TPose>;
+/** As above, for a `TPose` that is not a rect: `origin` tells the behavior how
+ *  to read and write the pose's origin. */
 declare function snapBackOrDelete<TPose>(args: {
     radius: number;
     onFreeRelease: 'snap-back' | 'delete';
@@ -62,6 +81,8 @@ declare function snapToGuides<TPose extends {
     x: number;
     y: number;
 }>(args: Omit<SnapToGuidesMoveArgs<TPose>, 'origin'>): MoveBehavior<TPose>;
+/** As above, for a `TPose` that is not a rect: `origin` tells the behavior how
+ *  to read and write the pose's origin. */
 declare function snapToGuides<TPose>(args: SnapToGuidesMoveArgs<TPose> & {
     origin: OriginProjection<TPose>;
 }): MoveBehavior<TPose>;

package/dist/move.js

@@ -1,5 +1,5 @@
-import { scratchKey, snap, createTransformOp, createReparentOp, getScratch, setScratch } from './chunk-UB6A6L77.js';
-import { gridSnapStrategy, RECT_ORIGIN_PROJECTION, guideSnapStrategy } from './chunk-6SHZHXXR.js';
+import { scratchKey, snap, createTransformOp, createReparentOp, getScratch, setScratch } from './chunk-3KGMJMOS.js';
+import { gridSnapStrategy, RECT_ORIGIN_PROJECTION, guideSnapStrategy } from './chunk-U45SODC2.js';
 import { createDeleteOp } from './chunk-GVCNT7UH.js';
 
 // src/interactions/actions/move/behaviors/snapToGrid.ts

package/dist/move.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/interactions/actions/move/behaviors/snapToGrid.ts","../src/interactions/actions/move/behaviors/snapToContainer.ts","../src/interactions/actions/move/behaviors/snapBackOrDelete.ts","../src/interactions/actions/move/behaviors/snapToGuides.ts"],"names":["snap"],"mappings":";;;;;AAMO,SAAS,WAAmD,IAAA,EAG3C;AACtB,EAAA,OAAO,IAAA,CAAK,iBAAwB,IAAA,CAAK,OAAO,GAAG,EAAE,SAAA,EAAW,IAAA,CAAK,SAAA,EAAW,CAAA;AAClF;;;ACMA,IAAM,KAAA,GAAQ,WAA+B,iBAAiB,CAAA;AAE9D,SAAS,SAAgB,GAAA,EAA8C;AACrE,EAAA,IAAI,CAAA,GAAI,UAAA,CAAW,GAAA,CAAI,OAAA,EAAS,KAAK,CAAA;AACrC,EAAA,IAAI,CAAC,CAAA,EAAG;AACN,IAAA,CAAA,GAAI,EAAE,eAAA,EAAiB,IAAA,EAAM,YAAA,EAAc,IAAA,EAAM,eAAe,IAAA,EAAK;AACrE,IAAA,UAAA,CAAW,GAAA,CAAI,OAAA,EAAS,KAAA,EAAO,CAAuB,CAAA;AAAA,EACxD;AACA,EAAA,OAAO,CAAA;AACT;AAEA,SAAS,WAAkB,CAAA,EAAqB;AAC9C,EAAA,IAAI,CAAA,CAAE,iBAAiB,IAAA,EAAM;AAC3B,IAAA,YAAA,CAAa,EAAE,YAAY,CAAA;AAC3B,IAAA,CAAA,CAAE,YAAA,GAAe,IAAA;AAAA,EACnB;AACA,EAAA,CAAA,CAAE,eAAA,GAAkB,IAAA;AACtB;AAEO,SAAS,gBAAuB,IAAA,EAUf;AACtB,EAAA,MAAM,EAAE,SAAS,UAAA,EAAY,SAAA,EAAW,YAAY,MAAA,EAAQ,aAAA,GAAgB,qBAAoB,GAAI,IAAA;AAEpG,EAAA,OAAO;AAAA,IACL,MAAA,CAAO,KAAK,SAAA,EAAW;AACrB,MAAA,MAAM,CAAA,GAAI,SAAgB,GAAG,CAAA;AAC7B,MAAA,MAAM,MAAA,GAAS,UAAA,CAAW,GAAA,CAAI,UAAA,CAAW,CAAC,CAAA,EAAG,GAAA,CAAI,OAAA,CAAQ,MAAA,EAAQ,GAAA,CAAI,OAAA,CAAQ,MAAM,CAAA;AAEnF,MAAA,IAAI,EAAE,aAAA,EAAe;AACnB,QAAA,IAAI,MAAA,IAAU,MAAA,CAAO,QAAA,KAAa,CAAA,CAAE,cAAc,QAAA,EAAU;AAC1D,UAAA,OAAO,EAAE,IAAA,EAAM,CAAA,CAAE,cAAc,QAAA,EAAU,IAAA,EAAM,EAAE,aAAA,EAAc;AAAA,QACjE;AACA,QAAA,CAAA,CAAE,aAAA,GAAgB,IAAA;AAAA,MACpB;AAEA,MAAA,IAAI,CAAC,MAAA,EAAQ;AACX,QAAA,UAAA,CAAW,CAAC,CAAA;AACZ,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,SAAA,GAAY,MAAM,CAAA,EAAG;AACvB,QAAA,UAAA,CAAW,CAAC,CAAA;AACZ,QAAA,CAAA,CAAE,aAAA,GAAgB,MAAA;AAClB,QAAA,OAAO,EAAE,IAAA,EAAM,MAAA,CAAO,QAAA,EAAU,MAAM,MAAA,EAAO;AAAA,MAC/C;AAEA,MAAA,IAAI,CAAA,CAAE,eAAA,KAAoB,MAAA,CAAO,QAAA,EAAU;AACzC,QAAA;AAAA,MACF;AACA,MAAA,UAAA,CAAW,CAAC,CAAA;AACZ,MAAA,CAAA,CAAE,kBAAkB,MAAA,CAAO,QAAA;AAC3B,MAAA,CAAA,CAAE,YAAA,GAAe,WAAW,MAAM;AAChC,QAAA,CAAA,CAAE,aAAA,GAAgB,MAAA;AAClB,QAAA,CAAA,CAAE,YAAA,GAAe,IAAA;AAAA,MACnB,GAAG,OAAO,CAAA;AACV,MAAA;AAAA,IACF,CAAA;AAAA,IAEA,MAAM,GAAA,EAAK;AACT,MAAA,MAAM,CAAA,GAAI,SAAgB,GAAG,CAAA;AAC7B,MAAA,UAAA,CAAW,CAAC,CAAA;AACZ,MAAA,MAAMA,KAAAA,GAAO,CAAA,CAAE,aAAA,IAAiB,GAAA,CAAI,IAAA;AACpC,MAAA,IAAI,CAACA,KAAAA,EAAM;AACX,MAAA,MAAM,SAAA,GAAY,GAAA,CAAI,UAAA,CAAW,CAAC,CAAA;AAClC,MAAA,MAAM,SAAA,GAAY,GAAA,CAAI,OAAA,CAAQ,SAAA,GAAY,SAAS,CAAA,IAAK,IAAA;AACxD,MAAA,MAAM,QAAA,GAAW,GAAA,CAAI,MAAA,CAAO,GAAA,CAAI,SAAS,CAAA;AACzC,MAAA,MAAM,GAAA,GAAY;AAAA,QAChB,iBAAA,CAAyB;AAAA,UACvB,EAAA,EAAI,SAAA;AAAA,UACJ,IAAA,EAAM,QAAA;AAAA,UACN,IAAIA,KAAAA,CAAK,QAAA;AAAA,UACT,KAAA,EAAO;AAAA,SACR;AAAA,OACH;AACA,MAAA,IAAI,SAAA,KAAcA,MAAK,QAAA,EAAU;AAC/B,QAAA,GAAA,CAAI,KAAK,gBAAA,CAAiB;AAAA,UACxB,EAAA,EAAI,SAAA;AAAA,UACJ,YAAA,EAAc,SAAA;AAAA,UACd,YAAYA,KAAAA,CAAK,QAAA;AAAA,UACjB,KAAA,EAAO;AAAA,SACR,CAAC,CAAA;AAAA,MACJ;AACA,MAAA,OAAO,GAAA;AAAA,IACT;AAAA,GACF;AACF;;;ACtGA,IAAM,SAAA,GAAY,WAAwC,4BAA4B,CAAA;AACtF,IAAM,OAAA,GAAU,WAAgC,0BAA0B,CAAA;AAanE,SAAS,iBAAwB,IAAA,EAKhB;AACtB,EAAA,MAAM,EAAE,MAAA,EAAQ,aAAA,EAAe,WAAA,GAAc,UAAS,GAAI,IAAA;AAC1D,EAAA,MAAM,IAAA,GACJ,KAAK,MAAA,IAAW,sBAAA;AAClB,EAAA,MAAM,KAAK,MAAA,GAAS,MAAA;AAEpB,EAAA,OAAO;AAAA,IACL,QAAQ,GAAA,EAAK;AAGX,MAAA,MAAM,SAAA,uBAAgB,GAAA,EAA4B;AAClD,MAAA,MAAM,OAAA,uBAAc,GAAA,EAAoB;AACxC,MAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,OAAA,CAAQ,QAAA,EAAS;AACnC,MAAA,KAAA,MAAW,EAAA,IAAM,IAAI,UAAA,EAAY;AAC/B,QAAA,MAAM,MAAM,GAAA,CAAI,OAAA,CAAQ,QAAQ,EAAE,CAAA,IAAK,EAAE,EAAA,EAAG;AAC5C,QAAA,SAAA,CAAU,GAAA,CAAI,IAAI,GAAG,CAAA;AACrB,QAAA,OAAA,CAAQ,GAAA,CAAI,IAAI,KAAA,CAAM,SAAA,CAAU,CAAC,CAAA,KAAM,CAAA,CAAE,EAAA,KAAO,EAAE,CAAC,CAAA;AAAA,MACrD;AACA,MAAA,UAAA,CAAW,GAAA,CAAI,OAAA,EAAS,SAAA,EAAW,SAAS,CAAA;AAC5C,MAAA,UAAA,CAAW,GAAA,CAAI,OAAA,EAAS,OAAA,EAAS,OAAO,CAAA;AAAA,IAC1C,CAAA;AAAA,IAEA,MAAM,GAAA,EAAK;AACT,MAAA,IAAI,IAAI,IAAA,EAAM;AACd,MAAA,MAAM,EAAA,GAAK,GAAA,CAAI,UAAA,CAAW,CAAC,CAAA;AAC3B,MAAA,MAAM,KAAK,IAAA,CAAK,SAAA,CAAU,IAAI,MAAA,CAAO,GAAA,CAAI,EAAE,CAAE,CAAA;AAC7C,MAAA,MAAM,KAAK,IAAA,CAAK,SAAA,CAAU,IAAI,OAAA,CAAQ,GAAA,CAAI,EAAE,CAAE,CAAA;AAC9C,MAAA,MAAM,EAAA,GAAK,EAAA,CAAG,CAAA,GAAI,EAAA,CAAG,CAAA;AACrB,MAAA,MAAM,EAAA,GAAK,EAAA,CAAG,CAAA,GAAI,EAAA,CAAG,CAAA;AACrB,MAAA,MAAM,MAAA,GAAS,EAAA,GAAK,EAAA,GAAK,EAAA,GAAK,EAAA,IAAM,EAAA;AACpC,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,OAAO,IAAA;AAAA,MACT;AACA,MAAA,IAAI,kBAAkB,QAAA,EAAU;AAC9B,QAAA,MAAM,SAAA,GAAY,UAAA,CAAW,GAAA,CAAI,OAAA,EAAS,SAAS,CAAA;AACnD,QAAA,MAAM,OAAA,GAAU,UAAA,CAAW,GAAA,CAAI,OAAA,EAAS,OAAO,CAAA;AAC/C,QAAA,MAAM,MAAM,SAAA,EAAW,GAAA,CAAI,EAAE,CAAA,IAAK,EAAE,EAAA,EAAG;AACvC,QAAA,MAAM,KAAA,GAAQ,OAAA,EAAS,GAAA,CAAI,EAAE,CAAA,IAAK,EAAA;AAClC,QAAA,MAAM,GAAA,GAAY,CAAC,cAAA,CAAe,EAAE,IAAA,EAAM,KAAK,KAAA,EAAO,WAAA,EAAa,KAAA,EAAO,CAAC,CAAA;AAC3E,QAAA,OAAO,GAAA;AAAA,MACT;AACA,MAAA;AAAA,IACF;AAAA,GACF;AACF;;;ACtCO,SAAS,aACd,IAAA,EACqB;AACrB,EAAA,MAAM,QAAA,GAAW,iBAAA,CAAyB,IAAA,CAAK,SAAA,EAAW;AAAA,IACxD,WAAW,IAAA,CAAK,SAAA;AAAA,IAChB,SAAS,IAAA,CAAK,OAAA;AAAA,IACd,QAAQ,IAAA,CAAK;AAAA,GACd,CAAA;AACD,EAAA,OAAO,KAAK,QAAA,EAAU,EAAE,SAAA,EAAW,IAAA,CAAK,WAAW,CAAA;AACrD","file":"move.js","sourcesContent":["import type { ModifierState, MoveBehavior } from '../../../gestures/types';\nimport { snap } from '../../../gestures/shared/snap';\nimport { gridSnapStrategy } from '../../../gestures/shared/strategies/grid';\n\ntype ModKey = keyof ModifierState;\n\nexport function snapToGrid<TPose extends { x: number; y: number }>(args: {\n  spacing: number;\n  bypassKey?: ModKey;\n}): MoveBehavior<TPose> {\n  return snap(gridSnapStrategy<TPose>(args.spacing), { bypassKey: args.bypassKey });\n}\n","import { createTransformOp } from 'core/ops/transform';\nimport { createReparentOp } from 'core/ops/reparent';\nimport type { Op } from 'core/ops/types';\nimport type { SnapTarget } from 'core/adapters/types';\nimport type { MoveBehavior, GestureContext } from '../../../gestures/types';\nimport { scratchKey, getScratch, setScratch } from '../../../scratchKey';\n\ninterface SnapState<TPose> {\n  pendingTargetId: string | null;\n  pendingTimer: ReturnType<typeof setTimeout> | null;\n  committedSnap: SnapTarget<TPose> | null;\n}\n\n// The slot is generic over TPose; we keep the unknown-pose key at module\n// scope and project it through `as` at the read site (each consumer call\n// of `snapToContainer<TPose>` is the only writer of its own SnapState\n// instance, so the cast is safe at runtime).\nconst STATE = scratchKey<SnapState<unknown>>('snapToContainer');\n\nfunction getState<TPose>(ctx: GestureContext<TPose>): SnapState<TPose> {\n  let s = getScratch(ctx.scratch, STATE) as SnapState<TPose> | undefined;\n  if (!s) {\n    s = { pendingTargetId: null, pendingTimer: null, committedSnap: null };\n    setScratch(ctx.scratch, STATE, s as SnapState<unknown>);\n  }\n  return s;\n}\n\nfunction clearTimer<TPose>(s: SnapState<TPose>) {\n  if (s.pendingTimer !== null) {\n    clearTimeout(s.pendingTimer);\n    s.pendingTimer = null;\n  }\n  s.pendingTargetId = null;\n}\n\nexport function snapToContainer<TPose>(args: {\n  dwellMs: number;\n  findTarget: (\n    draggedId: string,\n    worldX: number,\n    worldY: number,\n  ) => SnapTarget<TPose> | null;\n  isInstant?: (target: SnapTarget<TPose>) => boolean;\n  moveLabel?: string;\n  reparentLabel?: string;\n}): MoveBehavior<TPose> {\n  const { dwellMs, findTarget, isInstant, moveLabel = 'Move', reparentLabel = 'Move and reparent' } = args;\n\n  return {\n    onMove(ctx, _proposed) {\n      const s = getState<TPose>(ctx);\n      const target = findTarget(ctx.draggedIds[0], ctx.pointer.worldX, ctx.pointer.worldY);\n\n      if (s.committedSnap) {\n        if (target && target.parentId === s.committedSnap.parentId) {\n          return { pose: s.committedSnap.slotPose, snap: s.committedSnap };\n        }\n        s.committedSnap = null;\n      }\n\n      if (!target) {\n        clearTimer(s);\n        return;\n      }\n\n      if (isInstant?.(target)) {\n        clearTimer(s);\n        s.committedSnap = target;\n        return { pose: target.slotPose, snap: target };\n      }\n\n      if (s.pendingTargetId === target.parentId) {\n        return;\n      }\n      clearTimer(s);\n      s.pendingTargetId = target.parentId;\n      s.pendingTimer = setTimeout(() => {\n        s.committedSnap = target;\n        s.pendingTimer = null;\n      }, dwellMs);\n      return;\n    },\n\n    onEnd(ctx) {\n      const s = getState<TPose>(ctx);\n      clearTimer(s);\n      const snap = s.committedSnap ?? ctx.snap;\n      if (!snap) return;\n      const draggedId = ctx.draggedIds[0];\n      const oldParent = ctx.adapter.getParent?.(draggedId) ?? null;\n      const fromPose = ctx.origin.get(draggedId)!;\n      const ops: Op[] = [\n        createTransformOp<TPose>({\n          id: draggedId,\n          from: fromPose,\n          to: snap.slotPose,\n          label: moveLabel,\n        }),\n      ];\n      if (oldParent !== snap.parentId) {\n        ops.push(createReparentOp({\n          id: draggedId,\n          fromParentId: oldParent,\n          toParentId: snap.parentId,\n          label: reparentLabel,\n        }));\n      }\n      return ops;\n    },\n  };\n}\n","import { createDeleteOp } from 'core/ops/delete';\nimport type { Op } from 'core/ops/types';\nimport type { MoveBehavior } from '../../../gestures/types';\nimport {\n  RECT_ORIGIN_PROJECTION,\n  type OriginProjection,\n} from '../../../gestures/shared/strategies';\nimport { scratchKey, getScratch, setScratch } from '../../../scratchKey';\n\nconst SNAPSHOTS = scratchKey<Map<string, { id: string }>>('snapBackOrDelete.snapshots');\nconst INDEXES = scratchKey<Map<string, number>>('snapBackOrDelete.indexes');\n\nexport function snapBackOrDelete<TPose extends { x: number; y: number }>(args: {\n  radius: number;\n  onFreeRelease: 'snap-back' | 'delete';\n  deleteLabel?: string;\n}): MoveBehavior<TPose>;\nexport function snapBackOrDelete<TPose>(args: {\n  radius: number;\n  onFreeRelease: 'snap-back' | 'delete';\n  deleteLabel?: string;\n  origin: OriginProjection<TPose>;\n}): MoveBehavior<TPose>;\nexport function snapBackOrDelete<TPose>(args: {\n  radius: number;\n  onFreeRelease: 'snap-back' | 'delete';\n  deleteLabel?: string;\n  origin?: OriginProjection<TPose>;\n}): MoveBehavior<TPose> {\n  const { radius, onFreeRelease, deleteLabel = 'Delete' } = args;\n  const proj: OriginProjection<TPose> =\n    args.origin ?? (RECT_ORIGIN_PROJECTION as unknown as OriginProjection<TPose>);\n  const r2 = radius * radius;\n\n  return {\n    onStart(ctx) {\n      // Snapshot the dragged objects + their z-indexes at gesture start so\n      // delete can undo with paint order intact.\n      const snapshots = new Map<string, { id: string }>();\n      const indexes = new Map<string, number>();\n      const nodes = ctx.adapter.getNodes();\n      for (const id of ctx.draggedIds) {\n        const obj = ctx.adapter.getNode(id) ?? { id };\n        snapshots.set(id, obj);\n        indexes.set(id, nodes.findIndex((n) => n.id === id));\n      }\n      setScratch(ctx.scratch, SNAPSHOTS, snapshots);\n      setScratch(ctx.scratch, INDEXES, indexes);\n    },\n\n    onEnd(ctx) {\n      if (ctx.snap) return;\n      const id = ctx.draggedIds[0];\n      const o0 = proj.getOrigin(ctx.origin.get(id)!);\n      const o1 = proj.getOrigin(ctx.current.get(id)!);\n      const dx = o1.x - o0.x;\n      const dy = o1.y - o0.y;\n      const within = dx * dx + dy * dy <= r2;\n      if (within) {\n        return null;\n      }\n      if (onFreeRelease === 'delete') {\n        const snapshots = getScratch(ctx.scratch, SNAPSHOTS);\n        const indexes = getScratch(ctx.scratch, INDEXES);\n        const obj = snapshots?.get(id) ?? { id };\n        const index = indexes?.get(id) ?? -1;\n        const ops: Op[] = [createDeleteOp({ node: obj, label: deleteLabel, index })];\n        return ops;\n      }\n      return;\n    },\n  };\n}\n","import type { ModifierState, MoveBehavior } from '../../../gestures/types';\nimport type { Guide } from 'features/guides/types';\nimport type { View } from 'core/viewport/view';\nimport type { OriginProjection } from '../../../gestures/shared/strategies/grid';\nimport { snap } from '../../../gestures/shared/snap';\nimport { guideSnapStrategy } from '../../../gestures/shared/strategies/guides';\n\ntype ModKey = keyof ModifierState;\n\n/** Options for the move-flavored `snapToGuides`. */\nexport interface SnapToGuidesMoveArgs<TPose> {\n  /** Stable getter into the live guide list (typically from `useGuides`). */\n  getGuides: () => readonly Guide[];\n  /** Snap tolerance (screen px when `getView` is set, world units otherwise). */\n  tolerance?: number;\n  /** Read the active view; required for screen-pixel tolerance. */\n  getView?: () => View;\n  /** Modifier key that bypasses snapping while held. */\n  bypassKey?: ModKey;\n  /** Origin projection for non-rect TPose (e.g. Path). */\n  origin?: OriginProjection<TPose>;\n}\n\n/**\n * Move behavior that snaps the dragged pose's origin to the nearest world-space\n * guide line within `tolerance`. Closest-guide-per-axis wins; the two axes are\n * considered independently. Pair with `useGuides` and `createGuidesLayer`.\n */\nexport function snapToGuides<TPose extends { x: number; y: number }>(\n  args: Omit<SnapToGuidesMoveArgs<TPose>, 'origin'>,\n): MoveBehavior<TPose>;\nexport function snapToGuides<TPose>(\n  args: SnapToGuidesMoveArgs<TPose> & { origin: OriginProjection<TPose> },\n): MoveBehavior<TPose>;\nexport function snapToGuides<TPose>(\n  args: SnapToGuidesMoveArgs<TPose>,\n): MoveBehavior<TPose> {\n  const strategy = guideSnapStrategy<TPose>(args.getGuides, {\n    tolerance: args.tolerance,\n    getView: args.getView,\n    origin: args.origin as OriginProjection<TPose>,\n  });\n  return snap(strategy, { bypassKey: args.bypassKey });\n}\n"]}
+{"version":3,"sources":["../src/interactions/actions/move/behaviors/snapToGrid.ts","../src/interactions/actions/move/behaviors/snapToContainer.ts","../src/interactions/actions/move/behaviors/snapBackOrDelete.ts","../src/interactions/actions/move/behaviors/snapToGuides.ts"],"names":["snap"],"mappings":"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","file":"move.js","sourcesContent":["import type { ModifierState, MoveBehavior } from '../../../gestures/types';\nimport { snap } from '../../../gestures/shared/snap';\nimport { gridSnapStrategy } from '../../../gestures/shared/strategies/grid';\n\ntype ModKey = keyof ModifierState;\n\n/** Move behavior that snaps the dragged pose's origin to a grid. Hold\n *  `bypassKey` to drag freely. */\nexport function snapToGrid<TPose extends { x: number; y: number }>(args: {\n  spacing: number;\n  bypassKey?: ModKey;\n}): MoveBehavior<TPose> {\n  return snap(gridSnapStrategy<TPose>(args.spacing), { bypassKey: args.bypassKey });\n}\n","import { createTransformOp } from 'core/ops/transform';\nimport { createReparentOp } from 'core/ops/reparent';\nimport type { Op } from 'core/ops/types';\nimport type { SnapTarget } from 'core/adapters/types';\nimport type { MoveBehavior, GestureContext } from '../../../gestures/types';\nimport { scratchKey, getScratch, setScratch } from '../../../scratchKey';\n\ninterface SnapState<TPose> {\n  pendingTargetId: string | null;\n  pendingTimer: ReturnType<typeof setTimeout> | null;\n  committedSnap: SnapTarget<TPose> | null;\n}\n\n// The slot is generic over TPose; we keep the unknown-pose key at module\n// scope and project it through `as` at the read site (each consumer call\n// of `snapToContainer<TPose>` is the only writer of its own SnapState\n// instance, so the cast is safe at runtime).\nconst STATE = scratchKey<SnapState<unknown>>('snapToContainer');\n\nfunction getState<TPose>(ctx: GestureContext<TPose>): SnapState<TPose> {\n  let s = getScratch(ctx.scratch, STATE) as SnapState<TPose> | undefined;\n  if (!s) {\n    s = { pendingTargetId: null, pendingTimer: null, committedSnap: null };\n    setScratch(ctx.scratch, STATE, s as SnapState<unknown>);\n  }\n  return s;\n}\n\nfunction clearTimer<TPose>(s: SnapState<TPose>) {\n  if (s.pendingTimer !== null) {\n    clearTimeout(s.pendingTimer);\n    s.pendingTimer = null;\n  }\n  s.pendingTargetId = null;\n}\n\n/**\n * Move behavior that drops the dragged node into a container it hovers over\n * for `dwellMs`, reparenting it and taking the pose the container's layout\n * assigns.\n *\n * The dwell is what keeps a drag that merely passes over a container from\n * being captured by it.\n */\nexport function snapToContainer<TPose>(args: {\n  dwellMs: number;\n  findTarget: (\n    draggedId: string,\n    worldX: number,\n    worldY: number,\n  ) => SnapTarget<TPose> | null;\n  isInstant?: (target: SnapTarget<TPose>) => boolean;\n  moveLabel?: string;\n  reparentLabel?: string;\n}): MoveBehavior<TPose> {\n  const { dwellMs, findTarget, isInstant, moveLabel = 'Move', reparentLabel = 'Move and reparent' } = args;\n\n  return {\n    onMove(ctx, _proposed) {\n      const s = getState<TPose>(ctx);\n      const target = findTarget(ctx.draggedIds[0], ctx.pointer.worldX, ctx.pointer.worldY);\n\n      if (s.committedSnap) {\n        if (target && target.parentId === s.committedSnap.parentId) {\n          return { pose: s.committedSnap.slotPose, snap: s.committedSnap };\n        }\n        s.committedSnap = null;\n      }\n\n      if (!target) {\n        clearTimer(s);\n        return;\n      }\n\n      if (isInstant?.(target)) {\n        clearTimer(s);\n        s.committedSnap = target;\n        return { pose: target.slotPose, snap: target };\n      }\n\n      if (s.pendingTargetId === target.parentId) {\n        return;\n      }\n      clearTimer(s);\n      s.pendingTargetId = target.parentId;\n      s.pendingTimer = setTimeout(() => {\n        s.committedSnap = target;\n        s.pendingTimer = null;\n      }, dwellMs);\n      return;\n    },\n\n    onEnd(ctx) {\n      const s = getState<TPose>(ctx);\n      clearTimer(s);\n      const snap = s.committedSnap ?? ctx.snap;\n      if (!snap) return;\n      const draggedId = ctx.draggedIds[0];\n      const oldParent = ctx.adapter.getParent?.(draggedId) ?? null;\n      const fromPose = ctx.origin.get(draggedId)!;\n      const ops: Op[] = [\n        createTransformOp<TPose>({\n          id: draggedId,\n          from: fromPose,\n          to: snap.slotPose,\n          label: moveLabel,\n        }),\n      ];\n      if (oldParent !== snap.parentId) {\n        ops.push(createReparentOp({\n          id: draggedId,\n          fromParentId: oldParent,\n          toParentId: snap.parentId,\n          label: reparentLabel,\n        }));\n      }\n      return ops;\n    },\n  };\n}\n","import { createDeleteOp } from 'core/ops/delete';\nimport type { Op } from 'core/ops/types';\nimport type { MoveBehavior } from '../../../gestures/types';\nimport {\n  RECT_ORIGIN_PROJECTION,\n  type OriginProjection,\n} from '../../../gestures/shared/strategies';\nimport { scratchKey, getScratch, setScratch } from '../../../scratchKey';\n\nconst SNAPSHOTS = scratchKey<Map<string, { id: string }>>('snapBackOrDelete.snapshots');\nconst INDEXES = scratchKey<Map<string, number>>('snapBackOrDelete.indexes');\n\n/**\n * Move behavior for a drag that is only meaningful near where it started:\n * release inside `radius` and the node returns to its original pose; release\n * outside it and the node either springs back anyway or is deleted, per\n * `onFreeRelease`. A deletion is recorded as an undoable op with paint order\n * preserved.\n */\nexport function snapBackOrDelete<TPose extends { x: number; y: number }>(args: {\n  radius: number;\n  onFreeRelease: 'snap-back' | 'delete';\n  deleteLabel?: string;\n}): MoveBehavior<TPose>;\n/** As above, for a `TPose` that is not a rect: `origin` tells the behavior how\n *  to read and write the pose's origin. */\nexport function snapBackOrDelete<TPose>(args: {\n  radius: number;\n  onFreeRelease: 'snap-back' | 'delete';\n  deleteLabel?: string;\n  origin: OriginProjection<TPose>;\n}): MoveBehavior<TPose>;\n/** Snap back to the origin pose, or delete, depending on where the drag is\n *  released. */\nexport function snapBackOrDelete<TPose>(args: {\n  radius: number;\n  onFreeRelease: 'snap-back' | 'delete';\n  deleteLabel?: string;\n  origin?: OriginProjection<TPose>;\n}): MoveBehavior<TPose> {\n  const { radius, onFreeRelease, deleteLabel = 'Delete' } = args;\n  const proj: OriginProjection<TPose> =\n    args.origin ?? (RECT_ORIGIN_PROJECTION as unknown as OriginProjection<TPose>);\n  const r2 = radius * radius;\n\n  return {\n    onStart(ctx) {\n      // Snapshot the dragged objects + their z-indexes at gesture start so\n      // delete can undo with paint order intact.\n      const snapshots = new Map<string, { id: string }>();\n      const indexes = new Map<string, number>();\n      const nodes = ctx.adapter.getNodes();\n      for (const id of ctx.draggedIds) {\n        const obj = ctx.adapter.getNode(id) ?? { id };\n        snapshots.set(id, obj);\n        indexes.set(id, nodes.findIndex((n) => n.id === id));\n      }\n      setScratch(ctx.scratch, SNAPSHOTS, snapshots);\n      setScratch(ctx.scratch, INDEXES, indexes);\n    },\n\n    onEnd(ctx) {\n      if (ctx.snap) return;\n      const id = ctx.draggedIds[0];\n      const o0 = proj.getOrigin(ctx.origin.get(id)!);\n      const o1 = proj.getOrigin(ctx.current.get(id)!);\n      const dx = o1.x - o0.x;\n      const dy = o1.y - o0.y;\n      const within = dx * dx + dy * dy <= r2;\n      if (within) {\n        return null;\n      }\n      if (onFreeRelease === 'delete') {\n        const snapshots = getScratch(ctx.scratch, SNAPSHOTS);\n        const indexes = getScratch(ctx.scratch, INDEXES);\n        const obj = snapshots?.get(id) ?? { id };\n        const index = indexes?.get(id) ?? -1;\n        const ops: Op[] = [createDeleteOp({ node: obj, label: deleteLabel, index })];\n        return ops;\n      }\n      return;\n    },\n  };\n}\n","import type { ModifierState, MoveBehavior } from '../../../gestures/types';\nimport type { Guide } from 'features/guides/types';\nimport type { View } from 'core/viewport/view';\nimport type { OriginProjection } from '../../../gestures/shared/strategies/grid';\nimport { snap } from '../../../gestures/shared/snap';\nimport { guideSnapStrategy } from '../../../gestures/shared/strategies/guides';\n\ntype ModKey = keyof ModifierState;\n\n/** Options for the move-flavored `snapToGuides`. */\nexport interface SnapToGuidesMoveArgs<TPose> {\n  /** Stable getter into the live guide list (typically from `useGuides`). */\n  getGuides: () => readonly Guide[];\n  /** Snap tolerance (screen px when `getView` is set, world units otherwise). */\n  tolerance?: number;\n  /** Read the active view; required for screen-pixel tolerance. */\n  getView?: () => View;\n  /** Modifier key that bypasses snapping while held. */\n  bypassKey?: ModKey;\n  /** Origin projection for non-rect TPose (e.g. Path). */\n  origin?: OriginProjection<TPose>;\n}\n\n/**\n * Move behavior that snaps the dragged pose's origin to the nearest world-space\n * guide line within `tolerance`. Closest-guide-per-axis wins; the two axes are\n * considered independently. Pair with `useGuides` and `createGuidesLayer`.\n */\nexport function snapToGuides<TPose extends { x: number; y: number }>(\n  args: Omit<SnapToGuidesMoveArgs<TPose>, 'origin'>,\n): MoveBehavior<TPose>;\n/** As above, for a `TPose` that is not a rect: `origin` tells the behavior how\n *  to read and write the pose's origin. */\nexport function snapToGuides<TPose>(\n  args: SnapToGuidesMoveArgs<TPose> & { origin: OriginProjection<TPose> },\n): MoveBehavior<TPose>;\n/** Snap the dragged pose's origin to the nearest guide line, per axis. */\nexport function snapToGuides<TPose>(\n  args: SnapToGuidesMoveArgs<TPose>,\n): MoveBehavior<TPose> {\n  const strategy = guideSnapStrategy<TPose>(args.getGuides, {\n    tolerance: args.tolerance,\n    getView: args.getView,\n    origin: args.origin as OriginProjection<TPose>,\n  });\n  return snap(strategy, { bypassKey: args.bypassKey });\n}\n"]}

package/dist/{options-DoOvx50U.d.ts → options-CbsIgQci.d.ts}

@@ -1,5 +1,5 @@
 import { Op } from '@weasel-js/history';
-import { I as InsertBehavior, R as ResizePose } from './types-Ct4n0Z38.js';
+import { I as InsertBehavior, R as ResizePose } from './types-ByZxoD6P.js';
 
 /** Option surface for the `insert` action.
  *
@@ -8,6 +8,8 @@ import { I as InsertBehavior, R as ResizePose } from './types-Ct4n0Z38.js';
  *  Consumers should import from here directly; `insert.ts` re-exports the
  *  same symbol for back-compat. */
 
+/** Options for the `insert` action: what the drag bounds become, what a click
+ *  with no drag does, and the behaviors that shape the pose along the way. */
 interface UseInsertOptions<TPose, TNode extends {
     id: string;
 } = {

package/dist/patterns-builtin.d.ts

@@ -9,6 +9,7 @@ import { T as TilePatternSpec, a as TextureHandle } from './paint-types-CnLIzqq1
  * serializer would let the raster and vector forms drift apart silently.
  */
 
+/** One primitive within a pattern tile, in tile-local coordinates. */
 type TileShape = {
     kind: 'line';
     x1: number;
@@ -46,6 +47,9 @@ interface TileGeometry {
 }
 /** Defaults per tile kind, matching each factory's signature. */
 declare function tileSize(spec: TilePatternSpec): number;
+/** Resolve a pattern spec to the shapes that make up one tile. Consumers that
+ *  want to draw a pattern swatch themselves — a picker, an SVG export — read
+ *  this rather than rasterizing a texture. */
 declare function tileGeometry(spec: TilePatternSpec): TileGeometry;
 /** Draw a tile's shapes to a 2D context — the raster half of the pair. */
 declare function drawTileShapes(oc: CanvasRenderingContext2D, geometry: TileGeometry): void;
@@ -74,6 +78,7 @@ interface HatchParams {
     size?: number;
     lineWidth?: number;
 }
+/** Build a diagonal-hatch pattern texture. */
 declare function hatch(params: HatchParams): TextureHandle | null;
 /** Diagonal hatch in both directions. */
 interface CrosshatchParams {
@@ -81,6 +86,7 @@ interface CrosshatchParams {
     size?: number;
     lineWidth?: number;
 }
+/** Build a crosshatch pattern texture. */
 declare function crosshatch(params: CrosshatchParams): TextureHandle | null;
 /** Regular grid of filled dots. */
 interface DotsParams {
@@ -88,6 +94,7 @@ interface DotsParams {
     size?: number;
     radius?: number;
 }
+/** Build a dot-grid pattern texture. */
 declare function dots(params: DotsParams): TextureHandle | null;
 /**
  * Random scatter of small ellipses on top of a solid background. Driven by a
@@ -105,6 +112,7 @@ interface ChunksParams {
     chunkSize?: number;
     seed?: number;
 }
+/** Build a seeded random-scatter pattern texture. */
 declare function chunks(params: ChunksParams): TextureHandle | null;
 
 export { type ChunksParams, type CrosshatchParams, type DotsParams, type HatchParams, type TileGeometry, type TileShape, chunks, crosshatch, dots, drawTileShapes, hatch, tileGeometry, tileSize };

package/dist/patterns-builtin.js

@@ -1,3 +1,3 @@
-export { chunks, crosshatch, dots, drawTileShapes, hatch, tileGeometry, tileSize } from './chunk-IO5Z75X4.js';
+export { chunks, crosshatch, dots, drawTileShapes, hatch, tileGeometry, tileSize } from './chunk-HGF5X6MZ.js';
 //# sourceMappingURL=patterns-builtin.js.map
 //# sourceMappingURL=patterns-builtin.js.map

package/dist/{pointSnapToGrid-Bj4r_lEQ.d.ts → pointSnapToGrid-C3wowsQy.d.ts}

@@ -1,6 +1,6 @@
-import { c as ResizeAnchor, R as ResizePose, B as BoundsConstraint, P as PointSnapBehavior, d as PointSnapFrame, M as ModifierState } from './types-Ct4n0Z38.js';
-import { B as Bounds, P as PoseProjection } from './geometry-CnISZ11w.js';
-import { D as DebugSink } from './types-Dtxe7jTS.js';
+import { c as ResizeAnchor, R as ResizePose, B as BoundsConstraint, P as PointSnapBehavior, d as PointSnapFrame, M as ModifierState } from './types-ByZxoD6P.js';
+import { B as Bounds, P as PoseProjection } from './geometry-5X6TrAkX.js';
+import { D as DebugSink } from './types-BHK2dkMu.js';
 
 /** Corner resize-handle: world-space center plus the anchor that pins the opposite corner during resize. */
 interface CornerHandle {
@@ -71,6 +71,8 @@ declare function fixedCornerOf(bounds: Bounds, anchor: ResizeAnchor): {
  *  Consumers should import from here directly; `resize.ts` re-exports the
  *  same symbol for back-compat. */
 
+/** Options for the `resize` action: how the pose projects to and from a
+ *  bounding box, and the constraints applied to that box during the drag. */
 interface UseResizeOptions<TPose> {
     /** Behaviors are rect-typed: they read/write `{x,y,width,height}`. When
      *  `TPose` is non-rect, pass `geometry` to project pose↔bounds; behaviors
@@ -125,6 +127,10 @@ interface UseResizeOptions<TPose> {
     resizable?: (id: string) => boolean;
 }
 
+/** Resize behavior that snaps one reference point of the resize — the dragged
+ *  corner, the fixed corner, or the center, per `frame` — to a grid, moving
+ *  the whole pose by the same delta. Unlike the bounds-level `snapToGrid`,
+ *  this preserves the node's dimensions. */
 declare function pointSnapToGrid<TPose extends ResizePose>(args: {
     spacing: number;
     frame?: PointSnapFrame;

package/dist/{registry-BQL4oyTg.d.ts → registry-CxnkXbG8.d.ts}

@@ -1,18 +1,18 @@
-import { N as NodeId, R as RectPose, S as Scene } from './types-Kh_osAq9.js';
-import { M as ModifierState, A as ActionBehavior, c as ResizeAnchor, R as ResizePose, B as BoundsConstraint, P as PointSnapBehavior } from './types-Ct4n0Z38.js';
+import { N as NodeId, R as RectPose, S as Scene } from './types-vqxpCFVp.js';
+import { M as ModifierState, A as ActionBehavior, c as ResizeAnchor, R as ResizePose, B as BoundsConstraint, P as PointSnapBehavior } from './types-ByZxoD6P.js';
 import { V as View } from './view-DSQgxBJB.js';
 import { CapabilityTag } from '@weasel-js/modes';
 import * as React from 'react';
 import { MutableRefObject, ReactNode, ReactElement } from 'react';
 import { GestureSpec, IngestItem, InputEvent } from '@weasel-js/gestures';
-import { B as Bounds, P as PoseProjection } from './geometry-CnISZ11w.js';
+import { B as Bounds, P as PoseProjection } from './geometry-5X6TrAkX.js';
 import { F as FillStyle, S as Stroke } from './paint-types-CnLIzqq1.js';
-import { D as DrawCommand } from './DrawCommand-DCmiNkBj.js';
+import { D as DrawCommand } from './DrawCommand-BbPrSTra.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { P as Path } from './path-B6MMiodD.js';
 import { Op, History } from '@weasel-js/history';
-import { L as LayoutStrategy, I as InsertAdapter } from './types-Ch0Goo-j.js';
-import { D as DebugSink } from './types-Dtxe7jTS.js';
+import { L as LayoutStrategy, I as InsertAdapter } from './types-DpQ0cWYC.js';
+import { D as DebugSink } from './types-BHK2dkMu.js';
 import { Mat3 } from '@weasel-js/geom';
 
 /**
@@ -455,6 +455,8 @@ interface RuleCtx {
      *  an absent profile is behavior-preserving by construction. */
     readonly device?: DeviceProfile;
 }
+/** The live state a `RuleCtx` is assembled from — the chrome context plus
+ *  what the active mode allows. */
 interface BuildRuleCtxArgs {
     focused: boolean;
     selection: readonly NodeId[];
@@ -475,6 +477,8 @@ interface BuildRuleCtxArgs {
     /** Optional — omitted means {@link DEFAULT_DEVICE_PROFILE}. */
     device?: DeviceProfile;
 }
+/** Gather the current canvas and mode state into the context that action
+ *  eligibility and chrome-visibility rules are evaluated against. */
 declare function buildRuleCtx(args: BuildRuleCtxArgs): RuleCtx;
 
 /**
@@ -535,6 +539,7 @@ type Rule = Selector | {
 };
 /** Constant rules. Kept here so they have a single source. */
 declare const ALWAYS: Rule;
+/** A rule that never passes. `any` of nothing is false. */
 declare const NEVER: Rule;
 /**
  * Render a {@link Rule} as a short human-readable string, for inspectors and
@@ -551,6 +556,8 @@ declare const NEVER: Rule;
  * on a cyclic value and renders the `when` arm as a useless `{}`.
  */
 declare function describeRule(rule: Rule): string;
+/** Evaluate a rule against a context. Pure, and cheap enough to run per
+ *  frame for every piece of chrome. */
 declare function evaluate(rule: Rule, ctx: RuleCtx): boolean;
 
 /**
@@ -1008,6 +1015,9 @@ type Invoker = ImmediateInvoker | OngoingInvoker;
  * See `docs/superpowers/specs/2026-05-16-registry-unification-design.md`.
  */
 
+/** An interaction: a gesture spec composed with the id of the action it
+ *  invokes. Tools declare arrays of these; the dispatcher matches an incoming
+ *  input event against them and runs the winner's action. */
 interface GestureBinding {
     spec: GestureSpec;
     actionId: string;
@@ -1169,6 +1179,15 @@ type BooleanOpResult = {
     kind: 'noop';
     reason: 'no-paths' | 'too-few-for-subtract' | 'empty-result';
 };
+/**
+ * Run one Boolean operation over the selected paths and commit the result as a
+ * single undoable batch.
+ *
+ * Operands are ordered back-to-front, which is what makes `subtract` mean
+ * "everything in front removed from the backmost shape". Returns without
+ * mutating anything when the selection holds no paths, or too few for the
+ * requested operation.
+ */
 declare function applyBooleanOp(adapter: BooleansAdapter, op: BooleanOp): BooleanOpResult;
 
 /**
@@ -1291,6 +1310,9 @@ interface IngestCtx {
     /** Full action-deps bag, for consumer handlers that need more. */
     deps: ActionDeps;
 }
+/** A handler for content arriving by paste, drop or file picker. Handlers are
+ *  matched by MIME glob or predicate and run highest-priority first; the kit's
+ *  own register at a low priority so a consumer's handler wins by default. */
 interface ContentHandlerEntry {
     /** Stable identifier — used for unregistration and debugging
      *  (`'kit:image'`, `'app:csv'`). */
@@ -1357,6 +1379,9 @@ declare function PointerContextProvider({ children }: {
  *  no provider is in scope. */
 declare function usePointerContext(): PointerContextValue | null;
 
+/** Which tool is active, plus the stack of tools temporarily held active by a
+ *  hotkey (space-for-hand and the like). The dispatcher reads this to decide
+ *  whose bindings are in scope. */
 interface ActiveToolContextValue {
     active: string;
     hotkeyStack: string[];
@@ -1364,11 +1389,15 @@ interface ActiveToolContextValue {
     pushHotkey(id: string): void;
     popHotkey(): void;
 }
+/** Props for `<ActiveToolContextProvider>`. */
 interface ActiveToolContextProviderProps {
     children: ReactNode;
     initialActive?: string;
 }
+/** Provides active-tool state for a canvas. `<SceneCanvas>` mounts one. */
 declare function ActiveToolContextProvider({ children, initialActive, }: ActiveToolContextProviderProps): react_jsx_runtime.JSX.Element;
+/** The active-tool state in scope. Throws outside a provider; use
+ *  `useActiveToolContextOptional` where one is not guaranteed. */
 declare function useActiveToolContext(): ActiveToolContextValue;
 /**
  * Like `useActiveToolContext`, but returns `null` when no
@@ -1600,6 +1629,8 @@ type NodeAtPointDep = (point: {
     x: number;
     y: number;
 }, exclude?: Iterable<NodeId>) => NodeId | null;
+/** What an area-selecting action needs: a way to ask what a region covers,
+ *  and a way to read and replace the selection. */
 interface AreaSelectDep {
     /** Return ids of all scene nodes whose AABB overlaps `bounds`. */
     hitTestArea(bounds: {
@@ -1938,6 +1969,14 @@ interface ResizePolicy<TPose> {
 interface LayoutDep {
     getLayout(containerId: string): LayoutStrategy<unknown> | null;
 }
+/**
+ * The names an action may declare in `requires`, and what each resolves to.
+ *
+ * This is the whole vocabulary of things an action can reach — selection,
+ * scene, view, history, and the rest. Consumers add their own entries by
+ * augmenting the interface (`declare module '@weasel-js/core'`), which is what
+ * makes a custom dep name type-check in `requires` and in the deps bag.
+ */
 interface DepSchema {
     /** Kit selection state — ids of currently selected nodes. */
     selection: SelectionApi;
@@ -2124,13 +2163,19 @@ interface DepSchema {
  */
 type DepName = keyof DepSchema;
 
+/** Holds the live sources an action's declared dependencies resolve to.
+ *  Sources are thunks, read at invocation time, so an action never captures
+ *  stale state. */
 interface DepRegistry {
     register<K extends DepName>(name: K, source: () => DepSchema[K]): () => void;
     get<K extends DepName>(name: K): DepSchema[K] | undefined;
 }
+/** Provides the dep registry for a canvas. `<SceneCanvas>` mounts one; a
+ *  consumer registering its own dep sources must be inside it. */
 declare function DepRegistryProvider({ children }: {
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
+/** The dep registry in scope. Throws outside a `<DepRegistryProvider>`. */
 declare function useDepRegistry(): DepRegistry;
 /**
  * Like `useDepRegistry`, but returns `null` when no `<DepRegistryProvider>` is
@@ -2207,6 +2252,15 @@ interface ToolKeybinding {
      */
     shift?: boolean | 'optional';
 }
+/**
+ * What a tool declares.
+ *
+ * A tool is a declarative shell, not an event handler: it names the gestures
+ * it responds to and, for each, the action to invoke. The dispatcher owns the
+ * gesture, and the action owns the preview and the commit — so a tool
+ * definition is mostly `bindings`, plus presentation and any actions the tool
+ * itself introduces.
+ */
 interface ToolDef<TScratch = void> {
     id: string;
     /** Capability tags for modality eligibility. Forwarded onto `Tool.capabilities`. */
@@ -2411,7 +2465,11 @@ type AnyTool = Tool<any>;
  * binding-scope / matchBest logic on top.
  */
 
+/** Where a binding came from, which is also its priority: a held hotkey beats
+ *  the active tool, which beats bindings that are always in scope. */
 type BindingScope = 'ambient' | 'active' | 'hotkey';
+/** A binding paired with where it came from, ready to be matched against an
+ *  event. */
 interface ScopedBinding {
     binding: GestureBinding;
     scope: BindingScope;
@@ -2420,6 +2478,7 @@ interface ScopedBinding {
      *  Action with no owning tool. */
     ownerToolId: string | null;
 }
+/** The binding that won a match. */
 interface MatchResult {
     binding: GestureBinding;
     scope: BindingScope;
@@ -2479,6 +2538,11 @@ declare function specificity(spec: GestureSpec): readonly [number, number, numbe
  * the misconfiguration at dev time.
  */
 
+/** Everything the dispatcher must consult to route one input event: the
+ *  registered actions and their deps, which tool is active, which hotkeys are
+ *  held, and — optionally — the chrome state that action eligibility rules are
+ *  evaluated against. Rebuilt per event rather than held, so the dispatcher
+ *  itself stays stateless apart from in-flight gestures. */
 interface DispatcherContext {
     /** All registered actions; the dispatcher walks `.defaultBinding` for ambient bindings. */
     actions: ActionsRegistry;
@@ -2584,6 +2648,15 @@ interface ResolveAllOptions {
      */
     evaluateShadowed?: boolean;
 }
+/**
+ * Routes input events to actions.
+ *
+ * For each event it assembles the bindings in scope (hotkey, then active tool,
+ * then ambient), matches them in specificity order, filters by eligibility and
+ * each action's `enabled` gate, and invokes the first survivor. Ongoing
+ * actions — anything that runs across a drag — are kept in flight here and
+ * pumped with subsequent moves until the gesture ends.
+ */
 interface Dispatcher {
     /**
      * Route an input event through the binding pipeline. Returns `'handled'`
@@ -2720,6 +2793,8 @@ interface Dispatcher {
      */
     beginUiOngoing(actionId: string, deps: ActionDeps, params?: Record<string, unknown>): UiOngoingControl | null;
 }
+/** Build a dispatcher. `getAction` overrides how action ids are resolved;
+ *  by default the `DispatcherContext`'s registry is used. */
 declare function createDispatcher(opts?: {
     getAction?: (id: string) => Action | undefined;
 }): Dispatcher;
@@ -2873,6 +2948,7 @@ declare const ActionDisabledReason: {
     /** Sentinel: the predicate threw. Surfaced by `evaluateEnabled`'s catch. */
     readonly PredicateThrew: "predicate-threw";
 };
+/** Why an action is unavailable right now. */
 type ActionDisabledReason = (typeof ActionDisabledReason)[keyof typeof ActionDisabledReason];
 /**
  * @experimental
@@ -2882,6 +2958,14 @@ interface ActionEnabledResult {
     enabled: boolean;
     reason?: ActionDisabledReason;
 }
+/**
+ * @experimental
+ * Safely evaluate an action's `enabled` predicate. Returns `{enabled: true}`
+ * when no predicate is supplied. Catches throws and treats them as disabled
+ * with reason `'(predicate threw)'`. In dev mode, warns once per action id
+ * when a single call exceeds 4ms (single frame at 240fps — generous; real
+ * predicates should be sub-millisecond).
+ */
 declare function evaluateEnabled(action: Action, deps?: ActionDeps): ActionEnabledResult;
 /**
  * @experimental