@weasel-js/core 0.5.0

package/dist/index.js

@@ -0,0 +1,13 @@
+export { ALWAYS, ActionDisabledReason, ActionsProvider, ActionsProviderIfRoot, ActiveToolContextProvider, ActiveToolContextProviderIfRoot, BUNDLE_TOOLS, CURVE_REPS, ColorOverrideRegistry, CropIcon, CursorCoordsHud, DEFAULT_ALPHA_DECAY, DEFAULT_ALPHA_MIN, DEFAULT_DEBUG_THEME, DEFAULT_FILL_COLOR, DEFAULT_HANDLE_SIZE, DEFAULT_PALETTE, DEFAULT_ROTATION_HANDLE_DISTANCE, DEFAULT_STROKE_COLOR, DEFAULT_TEXT_STYLE, DEFAULT_VELOCITY_DECAY, DepRegistryProvider, DepRegistryProviderIfRoot, DivideIcon, EASINGS, EllipseIcon, ExcludeIcon, EyedropperIcon, FALLBACK_FIT_VIEW, GHOST_STROKE, HandIcon, IDENTITY_POSE_COMPOSITION, IntersectIcon, KIT_SHAPE_KINDS, LassoIcon, LineIcon, MOVE_ANCHORS, MinimapCanvas, NEVER, PenIcon, PencilIcon, PickHud, PointerProviderIfRoot, PolygonIcon, RECT_ALIGN_PROJECTION, RectIcon, SPRING_PRESETS, SceneCanvas, SceneViewCanvas, SelectIcon, SelectionContextProvider, SelectionContextProviderIfRoot, StarIcon, SubtractIcon, TextIcon, UnionIcon, UnknownIcon, WeaselProvider, aabbCenter, actionIs, alignDeltaFor, alignInsertBehavior, alignMoveBehavior, alignResizeBehavior, alignedStrokeRect, always, and, animateLifecycle, animateOnSetPose, applyBooleanOp, applyHitExistingGate, areaSelectAction, arrayAdapter, asNodeId, bezierCubic, bezierQuadratic, buildChromeCtx, buildRuleCtx, buildSceneViewCommands, canBringForward, canSendBackward, capabilityAll, capabilityIn, capabilityIs, capabilityNot, caretIndexAt, cellAt, charOffsetToDomPosition, clampView, clearSelectionAction, clientToCanvas, cloneAction, composeAffordanceLayer, composePath, composeRectPose, composeSelectionPose, composeWorldPose, computeFitView, computeIndicatorCommand, computeWheelAction, cond, constrainTo45, containedThenNearest, countPathAnchors, createAnchorEditOverlayLayer, createCellHighlightLayer, createChildrenLayer, createCornerResizeAffordance, createDebugOverlayLayer, createDebugSink, createDispatcher, createGridLayer, createGuidesLayer, createHistory, createMarkdownRenderer, createMoveToIndexOp, createNodeProperties, createNodeRouting, createParallaxLayer, createPathEditingOverlayLayer, createPathLayer, createPenPreviewLayer, createReorderOp, createRotationAffordance, createScene, createSelectionHandlesLayer, createSelectionOutlineLayer, createSelectionOverlayLayer, createSetDataOp, createSetLayerOp, createSetPathOp, createSetTextOp, createTextLayer, createToolsDispatcher, createViewportLayer, cycleVertexColors, decomposePath, decomposeRectPose, defaultCommitAdapter, defaultDrawOne, defaultLabelTextRenderer, defaultNodeProperties, defaultNodeRouting, defaultVisibilityRules, defineTool, deriveAlignmentGuides, deriveParallaxView, 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, enterTextEditAction, enumerateAnchors, evaluate, evaluateEnabled, findNodeShape, findShapeSilhouette, fitTextPose, fitToBounds, fitViewToBounds, fitZoom, focused, fontString, forEachCoalesced, freeform, gateLayer, gesturing, getAlpha01, getImageBitmap, getNodeShapes, getStylusData, hexToRgba, hitAnchor, hitRotationHandle, hovering, hoveringSelected, imageStatus, inferredNodeProperties, inferredNodeRouting, insertAction, isCanvasFont, isEditableTarget, lassoSelectAction, layoutMarkdown, lerpColorArray, lerpOklab, lerpOklch, linear, makeViewportZoomAction, markdownToRuns, matchAlignment, matchesKeyBinding, measureText, measureTextBounds, mergeAlphaFromPrev, modeIn, modeIs, modeNot, modifierHeld, momentum, moveAction, multiActive, nearest, nearestWithin, nestedHitTester, never, none, normalizeHex, not, nurbs, oklabToOklch, oklabToSrgbU8, oklchToOklab, openFilePicker, or, 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, registerCanvasFont, registerContentHandler, registerFont, registerNodeShape, renderLabel, renderSceneToCanvas, renderSceneToPixels, resizeAction, resolveColor, resolveRuns, resolveTextStyle, resolveVisibility, rgbaToHex, rotateAction, rotateAroundAABBCenter, rotatePathAround, rotatePoint, rotatedRectCorners, rotationDegreesUnit, rotationHandle, roundToCell, runsToDom, runsToMarkdown, runsToPlainText, sceneFromJSON, sceneNodeClientRect, sceneToAdapter, screenToWorld, selectFromLasso, selectFromMarquee, selectionAtLeast, selectionEmpty, selectionIs, sliceAction, snapPoint, solidVertexColors, spiro, splitPathByLine, splitSubpaths, springPose, springVertexColors, srgbU8ToOklab, staggerVertexColors, startThresholdDrag, subscribeGlyphReady, subscribeImageReady, textCommand, tileGrid, toHex8, toRuns, translatePoseViaDescriptor, translateRectPose, tweenPose, tweenVertexColors, unionBounds, unionBoundsPath, unregisterCanvasFont, useAction, useActionsRegistry, useActiveToolContext, useAlign, useAnimator, useArrayAdapter, useAutoCenter, useBooleans, useBooleansAdapter, useCanvasFocus, useCanvasSize, useDecayLoop, useDepRegistry, useDepSource, useDistribute, useDragGesture, useDragHandle, useDragRadial, useDragRect, useDropZone, useEllipseTool, useEyedropperTool, useGestureDispatcher, useGridCellHover, useGuides, useHandTool, useHandleDrag, useHoverTracking, useImageTool, useInsertTool, useKeybindings, useLassoTool, useLineTool, useNestedSelectTool, useOptionalActiveToolContext, useOptionalDepRegistry, usePenTool, usePencilTool, usePinchGesture, usePinchZoomTool, usePointerGestures, 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, when, withAlpha01, withCoord, worldEditToStorage, worldPoseLookup, worldToScreen, zoomAt, zoomAtLeast } from './chunk-7V6JEOXE.js';
+export { routing_exports as routing } from './chunk-AM6ARSPN.js';
+export { createReparentOp, createTransformOp, deleteScratch, getScratch, scratchKey, setScratch, snap } from './chunk-VOVKONXA.js';
+export { CORNER_ANCHORS, cornerPoint, cornerResizeHandles, hitCornerHandle, pointSnapToGrid } from './chunk-BGGZ4CVF.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, meanScale, pathPoseDescriptor, pointInPath, pointToGridCell, polygonFromPoints, rectPath, regularPolygonPath, resolveUnit, scalePathToBounds, starPath, transformPath, translatePath, translatePolygonInPlace } from './chunk-CQNKCG34.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 { cloneByAltDrag } from './chunk-UGFFCMQP.js';
+export { createSetSelectionOp } from './chunk-BHVYVFGV.js';
+export { createDeleteOp, createInsertOp, rebuildOp, registerOpFactory } from './chunk-GVCNT7UH.js';
+export { createTilePattern } from './chunk-Y52N27PF.js';
+import './chunk-PZ5AY32C.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/insert.d.ts

@@ -0,0 +1,33 @@
+export { U as UseInsertOptions } from './options-BPPBWMa7.js';
+import { M as ModifierState, I as InsertBehavior } from './types-BjUi2vA-.js';
+import { G as Guide } from './types-D2tTKEU0.js';
+import { V as View } from './view-DSQgxBJB.js';
+import '@weasel-js/history';
+import './types-B_-khFM0.js';
+
+type ModKey$1 = keyof ModifierState;
+declare function snapToGrid<TPose>(args: {
+    spacing: number;
+    bypassKey?: ModKey$1;
+}): InsertBehavior<TPose>;
+
+type ModKey = keyof ModifierState;
+/** Options for the insert-flavored `snapToGuides`. */
+interface SnapToGuidesInsertArgs {
+    /** Stable getter into the live guide list (typically from `useGuides`). */
+    getGuides: () => readonly Guide[];
+    /** Snap tolerance (screen px when `getView` is set, world units otherwise). */
+    tolerance?: number;
+    /** Read the active view; required for screen-pixel tolerance. */
+    getView?: () => View;
+    /** Modifier key that bypasses snapping while held. */
+    bypassKey?: ModKey;
+}
+/**
+ * Insert behavior that snaps the start anchor (on gesture start) and the
+ * live current point (during drag) to the nearest guide on each axis when
+ * within `tolerance`. Pair with `useGuides` and `createGuidesLayer`.
+ */
+declare function snapToGuides<TPose>(args: SnapToGuidesInsertArgs): InsertBehavior<TPose>;
+
+export { snapToGrid, snapToGuides };

package/dist/insert.js

@@ -0,0 +1,81 @@
+import { DEFAULT_GUIDE_TOLERANCE_PX, meanScale } from './chunk-CQNKCG34.js';
+import './chunk-PZ5AY32C.js';
+
+// src/interactions/actions/insert/behaviors/snapToGrid.ts
+function snapToGrid(args) {
+  const { spacing, bypassKey } = args;
+  const round = (v) => Math.round(v / spacing) * spacing;
+  return {
+    onStart(ctx) {
+      if (bypassKey && ctx.modifiers[bypassKey]) return;
+      const id = ctx.draggedIds[0];
+      const o = ctx.origin.get(id);
+      if (!o) return;
+      ctx.origin.set(id, { x: round(o.x), y: round(o.y) });
+    },
+    onMove(ctx, { current }) {
+      if (bypassKey && ctx.modifiers[bypassKey]) return;
+      return { current: { x: round(current.x), y: round(current.y) } };
+    }
+  };
+}
+
+// src/interactions/actions/insert/behaviors/snapToGuides.ts
+function snapPoint(p, guides, worldTolerance) {
+  let bestDx = 0;
+  let bestAbsDx = Infinity;
+  let bestDy = 0;
+  let bestAbsDy = Infinity;
+  for (const g of guides) {
+    if (g.axis === "x") {
+      const d = g.offset - p.x;
+      const ad = Math.abs(d);
+      if (ad <= worldTolerance && ad < bestAbsDx) {
+        bestAbsDx = ad;
+        bestDx = d;
+      }
+    } else {
+      const d = g.offset - p.y;
+      const ad = Math.abs(d);
+      if (ad <= worldTolerance && ad < bestAbsDy) {
+        bestAbsDy = ad;
+        bestDy = d;
+      }
+    }
+  }
+  if (bestAbsDx === Infinity && bestAbsDy === Infinity) return null;
+  const dx = bestAbsDx === Infinity ? 0 : bestDx;
+  const dy = bestAbsDy === Infinity ? 0 : bestDy;
+  if (dx === 0 && dy === 0) return null;
+  return { x: p.x + dx, y: p.y + dy };
+}
+function snapToGuides(args) {
+  const tolerance = args.tolerance ?? DEFAULT_GUIDE_TOLERANCE_PX;
+  const getView = args.getView;
+  const bypassKey = args.bypassKey;
+  const computeWorldTol = () => getView ? tolerance / Math.max(1e-9, meanScale(getView().scale)) : tolerance;
+  return {
+    onStart(ctx) {
+      if (bypassKey && ctx.modifiers[bypassKey]) return;
+      const guides = args.getGuides();
+      if (guides.length === 0) return;
+      const id = ctx.draggedIds[0];
+      const o = ctx.origin.get(id);
+      if (!o) return;
+      const snapped = snapPoint(o, guides, computeWorldTol());
+      if (snapped) ctx.origin.set(id, snapped);
+    },
+    onMove(ctx, { current }) {
+      if (bypassKey && ctx.modifiers[bypassKey]) return;
+      const guides = args.getGuides();
+      if (guides.length === 0) return;
+      const snapped = snapPoint(current, guides, computeWorldTol());
+      if (!snapped) return;
+      return { current: snapped };
+    }
+  };
+}
+
+export { snapToGrid, snapToGuides };
+//# sourceMappingURL=insert.js.map
+//# sourceMappingURL=insert.js.map

package/dist/insert.js.map

@@ -0,0 +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 { meanScale } from 'core/viewport/meanScale';\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  worldTolerance: 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 <= worldTolerance && 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 <= worldTolerance && 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  const computeWorldTol = (): number =>\n    getView ? tolerance / Math.max(1e-9, meanScale(getView().scale)) : 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

@@ -0,0 +1,69 @@
+import { O as OriginProjection } from './grid-Cf87knjU.js';
+export { U as UseMoveOptions } from './grid-Cf87knjU.js';
+import { M as ModifierState, a as MoveBehavior } from './types-BjUi2vA-.js';
+import { S as SnapTarget } from './types-B_-khFM0.js';
+import { G as Guide } from './types-D2tTKEU0.js';
+import { V as View } from './view-DSQgxBJB.js';
+import './types-BJ8_cyT7.js';
+import '@weasel-js/history';
+
+type ModKey$1 = keyof ModifierState;
+declare function snapToGrid<TPose extends {
+    x: number;
+    y: number;
+}>(args: {
+    spacing: number;
+    bypassKey?: ModKey$1;
+}): MoveBehavior<TPose>;
+
+declare function snapToContainer<TPose>(args: {
+    dwellMs: number;
+    findTarget: (draggedId: string, worldX: number, worldY: number) => SnapTarget<TPose> | null;
+    isInstant?: (target: SnapTarget<TPose>) => boolean;
+    moveLabel?: string;
+    reparentLabel?: string;
+}): MoveBehavior<TPose>;
+
+declare function snapBackOrDelete<TPose extends {
+    x: number;
+    y: number;
+}>(args: {
+    radius: number;
+    onFreeRelease: 'snap-back' | 'delete';
+    deleteLabel?: string;
+}): MoveBehavior<TPose>;
+declare function snapBackOrDelete<TPose>(args: {
+    radius: number;
+    onFreeRelease: 'snap-back' | 'delete';
+    deleteLabel?: string;
+    origin: OriginProjection<TPose>;
+}): MoveBehavior<TPose>;
+
+type ModKey = keyof ModifierState;
+/** Options for the move-flavored `snapToGuides`. */
+interface SnapToGuidesMoveArgs<TPose> {
+    /** Stable getter into the live guide list (typically from `useGuides`). */
+    getGuides: () => readonly Guide[];
+    /** Snap tolerance (screen px when `getView` is set, world units otherwise). */
+    tolerance?: number;
+    /** Read the active view; required for screen-pixel tolerance. */
+    getView?: () => View;
+    /** Modifier key that bypasses snapping while held. */
+    bypassKey?: ModKey;
+    /** Origin projection for non-rect TPose (e.g. Path). */
+    origin?: OriginProjection<TPose>;
+}
+/**
+ * Move behavior that snaps the dragged pose's origin to the nearest world-space
+ * guide line within `tolerance`. Closest-guide-per-axis wins; the two axes are
+ * considered independently. Pair with `useGuides` and `createGuidesLayer`.
+ */
+declare function snapToGuides<TPose extends {
+    x: number;
+    y: number;
+}>(args: Omit<SnapToGuidesMoveArgs<TPose>, 'origin'>): MoveBehavior<TPose>;
+declare function snapToGuides<TPose>(args: SnapToGuidesMoveArgs<TPose> & {
+    origin: OriginProjection<TPose>;
+}): MoveBehavior<TPose>;
+
+export { snapBackOrDelete, snapToContainer, snapToGrid, snapToGuides };

package/dist/move.js

@@ -0,0 +1,145 @@
+import { scratchKey, snap, createTransformOp, createReparentOp, getScratch, setScratch } from './chunk-VOVKONXA.js';
+import { gridSnapStrategy, RECT_ORIGIN_PROJECTION, guideSnapStrategy } from './chunk-CQNKCG34.js';
+import { createDeleteOp } from './chunk-GVCNT7UH.js';
+import './chunk-PZ5AY32C.js';
+
+// src/interactions/actions/move/behaviors/snapToGrid.ts
+function snapToGrid(args) {
+  return snap(gridSnapStrategy(args.spacing), { bypassKey: args.bypassKey });
+}
+
+// src/interactions/actions/move/behaviors/snapToContainer.ts
+var STATE = scratchKey("snapToContainer");
+function getState(ctx) {
+  let s = getScratch(ctx.scratch, STATE);
+  if (!s) {
+    s = { pendingTargetId: null, pendingTimer: null, committedSnap: null };
+    setScratch(ctx.scratch, STATE, s);
+  }
+  return s;
+}
+function clearTimer(s) {
+  if (s.pendingTimer !== null) {
+    clearTimeout(s.pendingTimer);
+    s.pendingTimer = null;
+  }
+  s.pendingTargetId = null;
+}
+function snapToContainer(args) {
+  const { dwellMs, findTarget, isInstant, moveLabel = "Move", reparentLabel = "Move and reparent" } = args;
+  return {
+    onMove(ctx, _proposed) {
+      const s = getState(ctx);
+      const target = findTarget(ctx.draggedIds[0], ctx.pointer.worldX, ctx.pointer.worldY);
+      if (s.committedSnap) {
+        if (target && target.parentId === s.committedSnap.parentId) {
+          return { pose: s.committedSnap.slotPose, snap: s.committedSnap };
+        }
+        s.committedSnap = null;
+      }
+      if (!target) {
+        clearTimer(s);
+        return;
+      }
+      if (isInstant?.(target)) {
+        clearTimer(s);
+        s.committedSnap = target;
+        return { pose: target.slotPose, snap: target };
+      }
+      if (s.pendingTargetId === target.parentId) {
+        return;
+      }
+      clearTimer(s);
+      s.pendingTargetId = target.parentId;
+      s.pendingTimer = setTimeout(() => {
+        s.committedSnap = target;
+        s.pendingTimer = null;
+      }, dwellMs);
+      return;
+    },
+    onEnd(ctx) {
+      const s = getState(ctx);
+      clearTimer(s);
+      const snap2 = s.committedSnap ?? ctx.snap;
+      if (!snap2) return;
+      const draggedId = ctx.draggedIds[0];
+      const oldParent = ctx.adapter.getParent?.(draggedId) ?? null;
+      const fromPose = ctx.origin.get(draggedId);
+      const ops = [
+        createTransformOp({
+          id: draggedId,
+          from: fromPose,
+          to: snap2.slotPose,
+          label: moveLabel
+        })
+      ];
+      if (oldParent !== snap2.parentId) {
+        ops.push(createReparentOp({
+          id: draggedId,
+          fromParentId: oldParent,
+          toParentId: snap2.parentId,
+          label: reparentLabel
+        }));
+      }
+      return ops;
+    }
+  };
+}
+
+// src/interactions/actions/move/behaviors/snapBackOrDelete.ts
+var SNAPSHOTS = scratchKey("snapBackOrDelete.snapshots");
+var INDEXES = scratchKey("snapBackOrDelete.indexes");
+function snapBackOrDelete(args) {
+  const { radius, onFreeRelease, deleteLabel = "Delete" } = args;
+  const proj = args.origin ?? RECT_ORIGIN_PROJECTION;
+  const r2 = radius * radius;
+  return {
+    onStart(ctx) {
+      const snapshots = /* @__PURE__ */ new Map();
+      const indexes = /* @__PURE__ */ new Map();
+      const nodes = ctx.adapter.getNodes();
+      for (const id of ctx.draggedIds) {
+        const obj = ctx.adapter.getNode(id) ?? { id };
+        snapshots.set(id, obj);
+        indexes.set(id, nodes.findIndex((n) => n.id === id));
+      }
+      setScratch(ctx.scratch, SNAPSHOTS, snapshots);
+      setScratch(ctx.scratch, INDEXES, indexes);
+    },
+    onEnd(ctx) {
+      if (ctx.snap) return;
+      const id = ctx.draggedIds[0];
+      const o0 = proj.getOrigin(ctx.origin.get(id));
+      const o1 = proj.getOrigin(ctx.current.get(id));
+      const dx = o1.x - o0.x;
+      const dy = o1.y - o0.y;
+      const within = dx * dx + dy * dy <= r2;
+      if (within) {
+        return null;
+      }
+      if (onFreeRelease === "delete") {
+        const snapshots = getScratch(ctx.scratch, SNAPSHOTS);
+        const indexes = getScratch(ctx.scratch, INDEXES);
+        const obj = snapshots?.get(id) ?? { id };
+        const index = indexes?.get(id) ?? -1;
+        const ops = [createDeleteOp({ node: obj, label: deleteLabel, index })];
+        return ops;
+      }
+      return;
+    }
+  };
+}
+
+// src/interactions/actions/move/behaviors/snapToGuides.ts
+function snapToGuides(args) {
+  const strategy = guideSnapStrategy(args.getGuides, {
+    tolerance: args.tolerance,
+    getView: args.getView,
+    origin: args.origin
+  });
+  return snap(strategy, { bypassKey: args.bypassKey });
+}
+
+export { snapBackOrDelete, snapToContainer, snapToGrid, snapToGuides };
+//# sourceMappingURL=move.js.map
+//# sourceMappingURL=move.js.map

package/dist/move.js.map

@@ -0,0 +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":"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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\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"]}

package/dist/options-BPPBWMa7.d.ts

@@ -0,0 +1,64 @@
+import { Op } from '@weasel-js/history';
+import { I as InsertBehavior, R as ResizePose } from './types-BjUi2vA-.js';
+
+/** Option surface for the `insert` action.
+ *
+ *  Lives in a sibling file (not `insert.ts`) so the type contract stays stable
+ *  even after the legacy `useInsert` hook is gone.
+ *  Consumers should import from here directly; `insert.ts` re-exports the
+ *  same symbol for back-compat. */
+
+interface UseInsertOptions<TPose, TNode extends {
+    id: string;
+} = {
+    id: string;
+}> {
+    behaviors?: InsertBehavior<TPose>[];
+    insertLabel?: string;
+    /** Reserved; insert is never transient in practice. Ignored. */
+    transient?: boolean;
+    /** Strictly-greater-than thresholds; bounds with width <= or height <= abort. Default { width: 0, height: 0 }. */
+    minBounds?: {
+        width: number;
+        height: number;
+    };
+    /** Construct the in-flight pose from the drag bounds. Defaults to the
+     *  identity cast (treat bounds as TPose). Override for non-rect TPose
+     *  (e.g. `(b) => rectPath(b)` or a polygon factory). */
+    posefromBounds?: (bounds: ResizePose) => TPose;
+    /** Click / sub-threshold-drag fallback. When provided, a release whose
+     *  bounds fall <= minBounds calls `pointInsert(start)` instead of aborting.
+     *  Returning null aborts. The created object is dispatched as an InsertOp
+     *  under the same `insertLabel`. */
+    pointInsert?: (point: {
+        x: number;
+        y: number;
+    }) => TNode | null;
+    /** Drag-disabled mode. When true, every release routes to pointInsert(start)
+     *  regardless of bounds — commitInsert is never called. Used by tool hooks
+     *  that wire only pointer.onClick (no marquee). */
+    clickOnly?: boolean;
+    /** Override for op dispatch on commit. When set, this is called instead of
+     *  `dispatchApplyBatch(adapter, ...)`. Tool hooks that synthesize an adapter
+     *  but want commits to route through the active tool ctx's `applyOps`
+     *  (for history integration) supply a function that reads from a ref
+     *  captured on handler entry. Read fresh on every commit, so a ref-reader
+     *  works without retriggering memos. */
+    applyOps?: (ops: Op[], label: string) => void;
+    onGestureStart?: () => void;
+    onGestureEnd?: (committed: boolean) => void;
+    /** Optional: snap world-space points to the active grid (or any other
+     *  snap target). Applied to every coord the gesture ingests, so both the
+     *  live marquee overlay and the committed bounds track the snapped
+     *  values. When omitted, behavior is identical to today (identity
+     *  passthrough). */
+    snapPoint?: (p: {
+        x: number;
+        y: number;
+    }) => {
+        x: number;
+        y: number;
+    };
+}
+
+export type { UseInsertOptions as U };

package/dist/patterns-builtin.d.ts

@@ -0,0 +1,55 @@
+import { T as TextureHandle } from './registerTexture-BzHTLhD9.js';
+
+/**
+ * Built-in pattern factories — generic line/dot/scatter textures. Each
+ * returns a `TextureHandle` you can wrap in a `FillStyle` of
+ * `{ fill: 'pattern', pattern }` and pass to anything that accepts a `FillStyle`
+ * (`FillStyle`-aware layers, path fills, etc.).
+ * Imported from a subpath so consumers that ship their own catalog can
+ * avoid the bundle cost.
+ *
+ * All factories require an explicit `color` (and `bg` for `chunks`). No
+ * defaults are baked in — the caller's design system is the source of truth
+ * for palette decisions.
+ */
+
+/** Diagonal hatch (forward slash). */
+interface HatchParams {
+    color: string;
+    size?: number;
+    lineWidth?: number;
+}
+declare function hatch(params: HatchParams): TextureHandle | null;
+/** Diagonal hatch in both directions. */
+interface CrosshatchParams {
+    color: string;
+    size?: number;
+    lineWidth?: number;
+}
+declare function crosshatch(params: CrosshatchParams): TextureHandle | null;
+/** Regular grid of filled dots. */
+interface DotsParams {
+    color: string;
+    size?: number;
+    radius?: number;
+}
+declare function dots(params: DotsParams): TextureHandle | null;
+/**
+ * Random scatter of small ellipses on top of a solid background. Driven by a
+ * seeded PRNG so the same `seed` produces a deterministic tile.
+ *
+ * Note: the `bg` field is optional — omit it for a transparent background
+ * (the scatter shapes draw directly onto whatever sits beneath the overlay).
+ */
+interface ChunksParams {
+    color: string;
+    bg?: string;
+    size?: number;
+    /** Coverage: `chunks * chunkSize²` per `size²` tile. Range ~[0, 1]. */
+    density?: number;
+    chunkSize?: number;
+    seed?: number;
+}
+declare function chunks(params: ChunksParams): TextureHandle | null;
+
+export { type ChunksParams, type CrosshatchParams, type DotsParams, type HatchParams, chunks, crosshatch, dots, hatch };

package/dist/patterns-builtin.js

@@ -0,0 +1,100 @@
+import { createTilePattern } from './chunk-Y52N27PF.js';
+import './chunk-PZ5AY32C.js';
+
+// src/features/patterns/patterns-builtin.ts
+function hatch(params) {
+  const { color, size = 5, lineWidth = 1 } = params;
+  return createTilePattern({
+    size,
+    draw: (oc, s) => {
+      oc.strokeStyle = color;
+      oc.lineWidth = lineWidth;
+      oc.beginPath();
+      oc.moveTo(-1, s + 1);
+      oc.lineTo(s + 1, -1);
+      oc.moveTo(-1, 1);
+      oc.lineTo(1, -1);
+      oc.moveTo(s - 1, s + 1);
+      oc.lineTo(s + 1, s - 1);
+      oc.stroke();
+    }
+  });
+}
+function crosshatch(params) {
+  const { color, size = 6, lineWidth = 0.8 } = params;
+  return createTilePattern({
+    size,
+    draw: (oc, s) => {
+      oc.strokeStyle = color;
+      oc.lineWidth = lineWidth;
+      oc.beginPath();
+      oc.moveTo(-1, s + 1);
+      oc.lineTo(s + 1, -1);
+      oc.moveTo(-1, 1);
+      oc.lineTo(1, -1);
+      oc.moveTo(s - 1, s + 1);
+      oc.lineTo(s + 1, s - 1);
+      oc.moveTo(-1, -1);
+      oc.lineTo(s + 1, s + 1);
+      oc.moveTo(s - 1, -1);
+      oc.lineTo(s + 1, 1);
+      oc.moveTo(-1, s - 1);
+      oc.lineTo(1, s + 1);
+      oc.stroke();
+    }
+  });
+}
+function dots(params) {
+  const { color, size = 6, radius = 1 } = params;
+  return createTilePattern({
+    size,
+    draw: (oc, s) => {
+      oc.fillStyle = color;
+      oc.beginPath();
+      oc.arc(s / 2, s / 2, radius, 0, Math.PI * 2);
+      oc.fill();
+    }
+  });
+}
+function mulberry32(seed) {
+  let s = seed | 0;
+  return () => {
+    s = s + 1831565813 | 0;
+    let t = Math.imul(s ^ s >>> 15, 1 | s);
+    t = t + Math.imul(t ^ t >>> 7, 61 | t) ^ t;
+    return ((t ^ t >>> 14) >>> 0) / 4294967296;
+  };
+}
+function chunks(params) {
+  const { color, bg, size = 48, density = 0.35, chunkSize = 3, seed = 42 } = params;
+  return createTilePattern({
+    size,
+    draw: (oc, s) => {
+      if (bg !== void 0) {
+        oc.fillStyle = bg;
+        oc.fillRect(0, 0, s, s);
+      }
+      const rand = mulberry32(seed);
+      const count = Math.round(s * s * density / (chunkSize * chunkSize));
+      oc.fillStyle = color;
+      for (let i = 0; i < count; i++) {
+        const cx = rand() * s;
+        const cy = rand() * s;
+        const w = chunkSize * (0.5 + rand());
+        const h = chunkSize * (0.5 + rand());
+        const angle = rand() * Math.PI;
+        oc.save();
+        oc.translate(cx, cy);
+        oc.rotate(angle);
+        oc.beginPath();
+        oc.ellipse(0, 0, w / 2, h / 2, 0, 0, Math.PI * 2);
+        oc.fill();
+        oc.restore();
+      }
+    }
+  });
+}
+
+export { chunks, crosshatch, dots, hatch };
+//# sourceMappingURL=patterns-builtin.js.map
+//# sourceMappingURL=patterns-builtin.js.map

package/dist/patterns-builtin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/features/patterns/patterns-builtin.ts"],"names":[],"mappings":"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","file":"patterns-builtin.js","sourcesContent":["/**\n * Built-in pattern factories — generic line/dot/scatter textures. Each\n * returns a `TextureHandle` you can wrap in a `FillStyle` of\n * `{ fill: 'pattern', pattern }` and pass to anything that accepts a `FillStyle`\n * (`FillStyle`-aware layers, path fills, etc.).\n * Imported from a subpath so consumers that ship their own catalog can\n * avoid the bundle cost.\n *\n * All factories require an explicit `color` (and `bg` for `chunks`). No\n * defaults are baked in — the caller's design system is the source of truth\n * for palette decisions.\n */\n\nimport { createTilePattern } from '.';\nimport type { TextureHandle } from '../../renderer/textures/registerTexture';\n\n/** Diagonal hatch (forward slash). */\nexport interface HatchParams {\n  color: string;\n  size?: number;\n  lineWidth?: number;\n}\n\nexport function hatch(params: HatchParams): TextureHandle | null {\n  const { color, size = 5, lineWidth = 1 } = params;\n  return createTilePattern({\n    size,\n    draw: (oc, s) => {\n      oc.strokeStyle = color;\n      oc.lineWidth = lineWidth;\n      oc.beginPath();\n      oc.moveTo(-1, s + 1);\n      oc.lineTo(s + 1, -1);\n      oc.moveTo(-1, 1);\n      oc.lineTo(1, -1);\n      oc.moveTo(s - 1, s + 1);\n      oc.lineTo(s + 1, s - 1);\n      oc.stroke();\n    },\n  });\n}\n\n/** Diagonal hatch in both directions. */\nexport interface CrosshatchParams {\n  color: string;\n  size?: number;\n  lineWidth?: number;\n}\n\nexport function crosshatch(params: CrosshatchParams): TextureHandle | null {\n  const { color, size = 6, lineWidth = 0.8 } = params;\n  return createTilePattern({\n    size,\n    draw: (oc, s) => {\n      oc.strokeStyle = color;\n      oc.lineWidth = lineWidth;\n      oc.beginPath();\n      // Forward diagonal (with seamless tiling).\n      oc.moveTo(-1, s + 1);\n      oc.lineTo(s + 1, -1);\n      oc.moveTo(-1, 1);\n      oc.lineTo(1, -1);\n      oc.moveTo(s - 1, s + 1);\n      oc.lineTo(s + 1, s - 1);\n      // Backward diagonal.\n      oc.moveTo(-1, -1);\n      oc.lineTo(s + 1, s + 1);\n      oc.moveTo(s - 1, -1);\n      oc.lineTo(s + 1, 1);\n      oc.moveTo(-1, s - 1);\n      oc.lineTo(1, s + 1);\n      oc.stroke();\n    },\n  });\n}\n\n/** Regular grid of filled dots. */\nexport interface DotsParams {\n  color: string;\n  size?: number;\n  radius?: number;\n}\n\nexport function dots(params: DotsParams): TextureHandle | null {\n  const { color, size = 6, radius = 1 } = params;\n  return createTilePattern({\n    size,\n    draw: (oc, s) => {\n      oc.fillStyle = color;\n      oc.beginPath();\n      oc.arc(s / 2, s / 2, radius, 0, Math.PI * 2);\n      oc.fill();\n    },\n  });\n}\n\n/**\n * Random scatter of small ellipses on top of a solid background. Driven by a\n * seeded PRNG so the same `seed` produces a deterministic tile.\n *\n * Note: the `bg` field is optional — omit it for a transparent background\n * (the scatter shapes draw directly onto whatever sits beneath the overlay).\n */\nexport interface ChunksParams {\n  color: string;\n  bg?: string;\n  size?: number;\n  /** Coverage: `chunks * chunkSize²` per `size²` tile. Range ~[0, 1]. */\n  density?: number;\n  chunkSize?: number;\n  seed?: number;\n}\n\n/** Simple seeded PRNG (mulberry32) for deterministic chunk placement. */\nfunction mulberry32(seed: number): () => number {\n  let s = seed | 0;\n  return () => {\n    s = (s + 0x6D2B79F5) | 0;\n    let t = Math.imul(s ^ (s >>> 15), 1 | s);\n    t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;\n    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;\n  };\n}\n\nexport function chunks(params: ChunksParams): TextureHandle | null {\n  const { color, bg, size = 48, density = 0.35, chunkSize = 3, seed = 42 } = params;\n  return createTilePattern({\n    size,\n    draw: (oc, s) => {\n      if (bg !== undefined) {\n        oc.fillStyle = bg;\n        oc.fillRect(0, 0, s, s);\n      }\n      const rand = mulberry32(seed);\n      const count = Math.round((s * s * density) / (chunkSize * chunkSize));\n      oc.fillStyle = color;\n      for (let i = 0; i < count; i++) {\n        const cx = rand() * s;\n        const cy = rand() * s;\n        const w = chunkSize * (0.5 + rand());\n        const h = chunkSize * (0.5 + rand());\n        const angle = rand() * Math.PI;\n        oc.save();\n        oc.translate(cx, cy);\n        oc.rotate(angle);\n        oc.beginPath();\n        oc.ellipse(0, 0, w / 2, h / 2, 0, 0, Math.PI * 2);\n        oc.fill();\n        oc.restore();\n      }\n    },\n  });\n}\n"]}