@weasel-js/core 1.6.1 → 1.7.0

package/dist/grid-CY5UKlZh.d.ts

@@ -0,0 +1,98 @@
+import { M as MoveBehavior, S as SnapStrategy } from './types-qYpyTAiZ.js';
+import { UnitValue, UnitSystem } from '@weasel-js/quantity';
+import { DebugSink } from '@weasel-js/routing';
+
+/** Option surface for the `move` action. */
+
+/** Options for the `move` action: the behaviors (snapping, momentum) layered
+ *  over the raw drag, the ids a drag carries, and its history and lifecycle.
+ *  `selectionMoveBindings` threads them into the move bindings. */
+interface UseMoveOptions<TPose> {
+    behaviors?: MoveBehavior<TPose>[];
+    /** Screen travel, in CSS pixels, before the drag moves anything. Default
+     *  `DRAG_THRESHOLD_PX`. The dispatcher opens no drag before that, so a
+     *  smaller value has no effect; a larger one holds the selection in place
+     *  until the pointer has gone that far. */
+    dragThresholdPx?: number;
+    /** History label for the committed move. Unset, a behavior's or a layout
+     *  drop's own op label names it, else `'Move'`. */
+    moveLabel?: string;
+    /** Commit without an undo entry (`scene.untracked`), bypassing the
+     *  consumer `applyOps` hook. Unset, a behavior's `defaultTransient` decides. */
+    transient?: boolean;
+    /** Fired once the drag passes its threshold, with the ids it moves. */
+    onGestureStart?(ids: string[]): void;
+    /** Fired once per `onGestureStart`: `true` when the move wrote to the
+     *  document, `false` on cancel, a behavior abort, or no net movement. */
+    onGestureEnd?(committed: boolean): void;
+    /** Replace the selection with the ids the drag moves — to carry linked
+     *  nodes along, say. Called once at drag start; the result is what
+     *  behaviors see as `draggedIds` and what the commit writes (each id's
+     *  descendants follow it as usual). Returning `[]` declines the drag.
+     *  Default: the selection. */
+    expandIds?: (ids: string[]) => string[];
+}
+
+/**
+ * Projection used by `gridSnapStrategy` when `TPose` doesn't expose `{x,y}`
+ * directly (Path, polygon, etc.). The strategy reads the snap point via
+ * `getOrigin`, rounds it to the grid, then asks `translate` to move the
+ * pose by the resulting delta.
+ */
+interface OriginProjection<TPose> {
+    getOrigin(pose: TPose): {
+        x: number;
+        y: number;
+    };
+    translate(pose: TPose, dx: number, dy: number): TPose;
+}
+/** Identity projection for `TPose extends { x; y }`. */
+declare const RECT_ORIGIN_PROJECTION: OriginProjection<{
+    x: number;
+    y: number;
+}>;
+/** Snap-strategy that rounds the pose's origin to the nearest multiple of
+ *  `spacing` (resolved through `unitSystem`). For non-rect TPose pass an
+ *  `OriginProjection` so the strategy knows how to read/write the origin. */
+declare function gridSnapStrategy<TPose>(spacing: UnitValue, unitSystem?: UnitSystem): SnapStrategy<TPose>;
+/** As above, additionally reporting each candidate to a debug sink. */
+declare function gridSnapStrategy<TPose>(spacing: UnitValue, opts: {
+    unitSystem?: UnitSystem;
+    debug?: DebugSink;
+}): SnapStrategy<TPose>;
+/** As above, for a `TPose` that is not a rect: `origin` tells the strategy how
+ *  to read and write the pose's origin. */
+declare function gridSnapStrategy<TPose>(spacing: UnitValue, opts: {
+    unitSystem?: UnitSystem;
+    origin: OriginProjection<TPose>;
+    debug?: DebugSink;
+}): SnapStrategy<TPose>;
+/**
+ * Compute the integer cell `{col, row}` that contains `point`, given a grid
+ * `spacing` and optional `origin` and `unitSystem`. Pair with
+ * `createCellHighlightLayer` (its `getCell` callback) to draw a snap-target
+ * preview that uses the same spacing as `gridSnapStrategy` — so the visual
+ * and behavioral grids stay in lockstep:
+ *
+ *     const SPACING = 20;
+ *     const snap = gridSnapStrategy(SPACING);
+ *     // visual grid:
+ *     createGridLayer({ spacing: SPACING, bounds: () => ... });
+ *     // hover-preview overlay:
+ *     createCellHighlightLayer({
+ *       spacing: SPACING,
+ *       getCell: () => hoverPoint && pointToGridCell(hoverPoint, SPACING),
+ *     });
+ */
+declare function pointToGridCell(point: {
+    x: number;
+    y: number;
+}, spacing: UnitValue, unitSystem?: UnitSystem, origin?: {
+    x: number;
+    y: number;
+}): {
+    col: number;
+    row: number;
+};
+
+export { type OriginProjection as O, RECT_ORIGIN_PROJECTION as R, type UseMoveOptions as U, gridSnapStrategy as g, pointToGridCell as p };

package/dist/index.css

@@ -1,4 +1,4 @@
-/* src/canvas/PickHud.module.css */
+/* src/canvas/hud.module.css */
 .hud {
   position: fixed;
   z-index: 10000;
@@ -14,17 +14,24 @@
   pointer-events: none;
   line-height: 1.4;
   text-align: right;
+}
+.sized {
   min-width: 120px;
   max-width: 260px;
 }
-.header {
+.pre {
+  white-space: pre;
+}
+.muted {
   color: #888;
-  margin-bottom: 2px;
 }
-.empty {
+.absent {
   color: #888;
   font-style: italic;
 }
+.header {
+  margin-bottom: 2px;
+}
 .list {
   list-style: none;
   margin: 0;
@@ -41,46 +48,15 @@
 .itemBest {
   font-weight: 700;
 }
-
-/* src/canvas/ModalityHud.module.css */
-.hud {
-  position: fixed;
-  z-index: 10000;
-  background: rgba(0, 0, 0, 0.7);
-  color: #e8e8e8;
-  font:
-    11px ui-monospace,
-    SFMono-Regular,
-    Menlo,
-    monospace;
-  padding: 6px 8px;
-  border-radius: 4px;
-  pointer-events: none;
-  line-height: 1.4;
-  text-align: right;
-  min-width: 120px;
-  max-width: 260px;
-}
 .row {
   display: flex;
   gap: 8px;
   justify-content: flex-end;
   white-space: nowrap;
 }
-.label {
-  color: #888;
-}
-.value {
-  color: #e8e8e8;
-}
-.valueMuted {
-  color: #888;
-  font-style: italic;
-}
 .stack {
   display: flex;
   flex-direction: column;
-  gap: 0;
   align-items: flex-end;
 }
 /*# sourceMappingURL=index.css.map */

package/dist/index.css.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/canvas/PickHud.module.css","../src/canvas/ModalityHud.module.css"],"sourcesContent":[".hud {\n  position: fixed;\n  z-index: 10000;\n  background: rgba(0, 0, 0, 0.7);\n  color: #e8e8e8;\n  font: 11px ui-monospace, SFMono-Regular, Menlo, monospace;\n  padding: 6px 8px;\n  border-radius: 4px;\n  pointer-events: none;\n  line-height: 1.4;\n  text-align: right;\n  min-width: 120px;\n  max-width: 260px;\n}\n\n.header {\n  color: #888;\n  margin-bottom: 2px;\n}\n\n.empty {\n  color: #888;\n  font-style: italic;\n}\n\n.list {\n  list-style: none;\n  margin: 0;\n  padding: 0;\n  display: flex;\n  flex-direction: column;\n  gap: 1px;\n}\n\n.item {\n  white-space: nowrap;\n  overflow: hidden;\n  text-overflow: ellipsis;\n}\n\n.itemBest {\n  font-weight: 700;\n}\n",".hud {\n  position: fixed;\n  z-index: 10000;\n  background: rgba(0, 0, 0, 0.7);\n  color: #e8e8e8;\n  font: 11px ui-monospace, SFMono-Regular, Menlo, monospace;\n  padding: 6px 8px;\n  border-radius: 4px;\n  pointer-events: none;\n  line-height: 1.4;\n  text-align: right;\n  min-width: 120px;\n  max-width: 260px;\n}\n\n.row {\n  display: flex;\n  gap: 8px;\n  justify-content: flex-end;\n  white-space: nowrap;\n}\n\n.label {\n  color: #888;\n}\n\n.value {\n  color: #e8e8e8;\n}\n\n.valueMuted {\n  color: #888;\n  font-style: italic;\n}\n\n.stack {\n  display: flex;\n  flex-direction: column;\n  gap: 0;\n  align-items: flex-end;\n}\n"],"mappings":";AAAA,CAAC;AACC,YAAU;AACV,WAAS;AACT,cAAY,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;AAC1B,SAAO;AACP;AAAA,IAAM,KAAK,YAAY;AAAA,IAAE,cAAc;AAAA,IAAE,KAAK;AAAA,IAAE;AAChD,WAAS,IAAI;AACb,iBAAe;AACf,kBAAgB;AAChB,eAAa;AACb,cAAY;AACZ,aAAW;AACX,aAAW;AACb;AAEA,CAAC;AACC,SAAO;AACP,iBAAe;AACjB;AAEA,CAAC;AACC,SAAO;AACP,cAAY;AACd;AAEA,CAAC;AACC,cAAY;AACZ,UAAQ;AACR,WAAS;AACT,WAAS;AACT,kBAAgB;AAChB,OAAK;AACP;AAEA,CAAC;AACC,eAAa;AACb,YAAU;AACV,iBAAe;AACjB;AAEA,CAAC;AACC,eAAa;AACf;;;AC1CA,CAAC;AACC,YAAU;AACV,WAAS;AACT,cAAY,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;AAC1B,SAAO;AACP;AAAA,IAAM,KAAK,YAAY;AAAA,IAAE,cAAc;AAAA,IAAE,KAAK;AAAA,IAAE;AAChD,WAAS,IAAI;AACb,iBAAe;AACf,kBAAgB;AAChB,eAAa;AACb,cAAY;AACZ,aAAW;AACX,aAAW;AACb;AAEA,CAAC;AACC,WAAS;AACT,OAAK;AACL,mBAAiB;AACjB,eAAa;AACf;AAEA,CAAC;AACC,SAAO;AACT;AAEA,CAAC;AACC,SAAO;AACT;AAEA,CAAC;AACC,SAAO;AACP,cAAY;AACd;AAEA,CAAC;AACC,WAAS;AACT,kBAAgB;AAChB,OAAK;AACL,eAAa;AACf;","names":[]}
+{"version":3,"sources":["../src/canvas/hud.module.css"],"sourcesContent":["/* The debug HUDs <Canvas> can draw: CursorCoordsHud, PickHud, ModalityHud. */\n.hud {\n  position: fixed;\n  z-index: 10000;\n  background: rgba(0, 0, 0, 0.7);\n  color: #e8e8e8;\n  font: 11px ui-monospace, SFMono-Regular, Menlo, monospace;\n  padding: 6px 8px;\n  border-radius: 4px;\n  pointer-events: none;\n  line-height: 1.4;\n  text-align: right;\n}\n\n.sized {\n  min-width: 120px;\n  max-width: 260px;\n}\n\n.pre {\n  white-space: pre;\n}\n\n.muted {\n  color: #888;\n}\n\n/* A value that is not there: an em dash, \"off-canvas\". */\n.absent {\n  color: #888;\n  font-style: italic;\n}\n\n.header {\n  margin-bottom: 2px;\n}\n\n.list {\n  list-style: none;\n  margin: 0;\n  padding: 0;\n  display: flex;\n  flex-direction: column;\n  gap: 1px;\n}\n\n.item {\n  white-space: nowrap;\n  overflow: hidden;\n  text-overflow: ellipsis;\n}\n\n.itemBest {\n  font-weight: 700;\n}\n\n.row {\n  display: flex;\n  gap: 8px;\n  justify-content: flex-end;\n  white-space: nowrap;\n}\n\n.stack {\n  display: flex;\n  flex-direction: column;\n  align-items: flex-end;\n}\n"],"mappings":";AACA,CAAC;AACC,YAAU;AACV,WAAS;AACT,cAAY,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;AAC1B,SAAO;AACP;AAAA,IAAM,KAAK,YAAY;AAAA,IAAE,cAAc;AAAA,IAAE,KAAK;AAAA,IAAE;AAChD,WAAS,IAAI;AACb,iBAAe;AACf,kBAAgB;AAChB,eAAa;AACb,cAAY;AACd;AAEA,CAAC;AACC,aAAW;AACX,aAAW;AACb;AAEA,CAAC;AACC,eAAa;AACf;AAEA,CAAC;AACC,SAAO;AACT;AAGA,CAAC;AACC,SAAO;AACP,cAAY;AACd;AAEA,CAAC;AACC,iBAAe;AACjB;AAEA,CAAC;AACC,cAAY;AACZ,UAAQ;AACR,WAAS;AACT,WAAS;AACT,kBAAgB;AAChB,OAAK;AACP;AAEA,CAAC;AACC,eAAa;AACb,YAAU;AACV,iBAAe;AACjB;AAEA,CAAC;AACC,eAAa;AACf;AAEA,CAAC;AACC,WAAS;AACT,OAAK;AACL,mBAAiB;AACjB,eAAa;AACf;AAEA,CAAC;AACC,WAAS;AACT,kBAAgB;AAChB,eAAa;AACf;","names":[]}