@weasel-js/core 1.14.2 → 1.15.1

package/dist/domains/snap/marks.js

@@ -1,6 +1,6 @@
 import { fromPlane } from "../../core/viewport/parallax.js";
 
-//#region src/domains/snap/marks.ts
+// src/domains/snap/marks.ts
 /** `marks` with repeats dropped, so a target several probes meet is drawn once. */
 function distinct(marks) {
 	const seen = /* @__PURE__ */ new Set();
@@ -24,6 +24,5 @@ function markFromPlane(m, plane) {
 	};
 }
 
-//#endregion
 export { distinct, markFromPlane };
 //# sourceMappingURL=marks.js.map

package/dist/domains/snap/outcomeStore.js

@@ -1,4 +1,4 @@
-//#region src/domains/snap/outcomeStore.ts
+// src/domains/snap/outcomeStore.ts
 var NONE = [];
 /** An empty outcome store, which notifies only when the marks change. */
 function createSnapOutcomeStore() {
@@ -20,6 +20,5 @@ function createSnapOutcomeStore() {
 	};
 }
 
-//#endregion
 export { createSnapOutcomeStore };
 //# sourceMappingURL=outcomeStore.js.map

package/dist/domains/snap/pointSnap.js

@@ -1,6 +1,6 @@
 import { inputSession } from "./session2d.js";
 
-//#region src/domains/snap/pointSnap.ts
+// src/domains/snap/pointSnap.ts
 var FREE = {
 	suspend: false,
 	constrain: false
@@ -43,6 +43,5 @@ function pointSnap() {
 	};
 }
 
-//#endregion
 export { pointSnap };
 //# sourceMappingURL=pointSnap.js.map

package/dist/domains/snap/probes2d.js

@@ -1,7 +1,7 @@
 import { unionBounds } from "../../core/geometry/unionBounds.js";
 import { resizeProbes, resizeSubject } from "./resizeBox.js";
 
-//#region src/domains/snap/probes2d.ts
+// src/domains/snap/probes2d.ts
 /** The union drawn box of the subjects, or null when none is left. */
 function subjectBox(ids, reads) {
 	const boxes = [];
@@ -60,6 +60,11 @@ function moveProbes(press, ids, reads, box) {
 			role: "origin"
 		});
 	}
+	if (reads.anchors) for (const id of ids) reads.anchors(id).forEach((at, i) => out.push({
+		id: `anchor:${id}:${i}`,
+		at,
+		role: "anchor"
+	}));
 	if (box) out.push({
 		id: "box.min",
 		at: {
@@ -94,6 +99,5 @@ function moveProbes(press, ids, reads, box) {
 	return out;
 }
 
-//#endregion
 export { buildProbes, subjectBox, subjectOf };
 //# sourceMappingURL=probes2d.js.map

package/dist/domains/snap/probes2d.js.map

@@ -1 +1 @@
-{"version":3,"file":"probes2d.js","names":[],"sources":["../../../src/domains/snap/probes2d.ts"],"sourcesContent":["import { unionBounds } from 'core/geometry/unionBounds';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\nimport type { SnapBegin } from 'interactions/actions/snapDep';\nimport type { SnapProbeAt } from './types';\nimport { resizeProbes, resizeSubject, type ResizeSubject } from './resizeBox';\nimport type { Point } from '@weasel-js/geom';\n\n/** How a 2D session reads its subject at press. */\nexport interface ProbeReads {\n  /** `id`'s world pose now, or undefined when it is gone. */\n  pose(id: string): unknown;\n  /** The axis-aligned box `id` is drawn with at `pose`, stroke included. */\n  drawnBox(id: string, pose: unknown): Bounds;\n  /** The point of `pose` the `origin` probe sits at: its `OriginProjection` origin. */\n  origin(pose: unknown): Point;\n  /** The point of the subject's own geometry nearest `press`, or null. */\n  geometryAt?(press: Point, ids: readonly string[]): Point | null;\n}\n\n/** The union drawn box of the subjects, or null when none is left. */\nexport function subjectBox(ids: readonly string[], reads: ProbeReads): Bounds | null {\n  const boxes: Bounds[] = [];\n  for (const id of ids) {\n    const pose = reads.pose(id);\n    if (pose !== undefined) boxes.push(reads.drawnBox(id, pose));\n  }\n  return unionBounds(boxes);\n}\n\n/** What a gesture drags, read once at press. */\nexport interface Subject2d {\n  /** A move's subjects' union drawn box. */\n  box: Bounds | null;\n  /** A resize's box and frame: the one it names, else the subjects' drawn\n   *  box, axis-aligned. */\n  resize: ResizeSubject | null;\n}\n\n/** The subject of `req`, null where the gesture has none or nothing is left. */\nexport function subjectOf(req: SnapBegin, reads: ProbeReads): Subject2d {\n  if (req.gesture === 'move') return { box: subjectBox(req.ids ?? [], reads), resize: null };\n  if (req.gesture !== 'resize' || !req.handle) return { box: null, resize: null };\n  if (req.box) return { box: null, resize: resizeSubject(req.box, req.handle) };\n  const bounds = subjectBox(req.ids ?? [], reads);\n  return { box: null, resize: bounds ? resizeSubject({ bounds }, req.handle) : null };\n}\n\n/** The probes a gesture snaps, where they are at press. */\nexport function buildProbes(req: SnapBegin, reads: ProbeReads, subject = subjectOf(req, reads)): SnapProbeAt[] {\n  const ids = req.ids ?? [];\n  switch (req.gesture) {\n    case 'point':\n      return [{ id: 'pointer', at: req.press, role: 'pointer' }];\n    case 'resize':\n      return subject.resize ? resizeProbes(subject.resize) : [{ id: 'pointer', at: req.press, role: 'pointer' }];\n    case 'move':\n      return moveProbes(req.press, ids, reads, subject.box);\n    case 'rotate':\n    case 'handle':\n      return [];\n  }\n}\n\nfunction moveProbes(press: Point, ids: readonly string[], reads: ProbeReads, box: Bounds | null): SnapProbeAt[] {\n  const out: SnapProbeAt[] = [];\n  for (const id of ids) {\n    const pose = reads.pose(id);\n    if (pose !== undefined) out.push({ id: `origin:${id}`, at: reads.origin(pose), role: 'origin' });\n  }\n  if (box) {\n    out.push(\n      { id: 'box.min', at: { x: box.x, y: box.y }, role: 'box' },\n      { id: 'box.center', at: { x: box.x + box.width / 2, y: box.y + box.height / 2 }, role: 'box' },\n      { id: 'box.max', at: { x: box.x + box.width, y: box.y + box.height }, role: 'box' },\n    );\n  }\n  const geometry = reads.geometryAt?.(press, ids) ?? press;\n  out.push({ id: 'geometry', at: { x: geometry.x, y: geometry.y }, role: 'geometry' });\n  return out;\n}\n"],"mappings":";;;;;AAoBA,SAAgB,WAAW,KAAwB,OAAkC;CACnF,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,MAAM,KAAK;EACpB,MAAM,OAAO,MAAM,KAAK,EAAE;EAC1B,IAAI,SAAS,QAAW,MAAM,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC;CAC7D;CACA,OAAO,YAAY,KAAK;AAC1B;;AAYA,SAAgB,UAAU,KAAgB,OAA8B;CACtE,IAAI,IAAI,YAAY,QAAQ,OAAO;EAAE,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,KAAK;EAAG,QAAQ;CAAK;CACzF,IAAI,IAAI,YAAY,YAAY,CAAC,IAAI,QAAQ,OAAO;EAAE,KAAK;EAAM,QAAQ;CAAK;CAC9E,IAAI,IAAI,KAAK,OAAO;EAAE,KAAK;EAAM,QAAQ,cAAc,IAAI,KAAK,IAAI,MAAM;CAAE;CAC5E,MAAM,SAAS,WAAW,IAAI,OAAO,CAAC,GAAG,KAAK;CAC9C,OAAO;EAAE,KAAK;EAAM,QAAQ,SAAS,cAAc,EAAE,OAAO,GAAG,IAAI,MAAM,IAAI;CAAK;AACpF;;AAGA,SAAgB,YAAY,KAAgB,OAAmB,UAAU,UAAU,KAAK,KAAK,GAAkB;CAC7G,MAAM,MAAM,IAAI,OAAO,CAAC;CACxB,QAAQ,IAAI,SAAZ;EACE,KAAK,SACH,OAAO,CAAC;GAAE,IAAI;GAAW,IAAI,IAAI;GAAO,MAAM;EAAU,CAAC;EAC3D,KAAK,UACH,OAAO,QAAQ,SAAS,aAAa,QAAQ,MAAM,IAAI,CAAC;GAAE,IAAI;GAAW,IAAI,IAAI;GAAO,MAAM;EAAU,CAAC;EAC3G,KAAK,QACH,OAAO,WAAW,IAAI,OAAO,KAAK,OAAO,QAAQ,GAAG;EACtD,KAAK;EACL,KAAK,UACH,OAAO,CAAC;CACZ;AACF;AAEA,SAAS,WAAW,OAAc,KAAwB,OAAmB,KAAmC;CAC9G,MAAM,MAAqB,CAAC;CAC5B,KAAK,MAAM,MAAM,KAAK;EACpB,MAAM,OAAO,MAAM,KAAK,EAAE;EAC1B,IAAI,SAAS,QAAW,IAAI,KAAK;GAAE,IAAI,UAAU;GAAM,IAAI,MAAM,OAAO,IAAI;GAAG,MAAM;EAAS,CAAC;CACjG;CACA,IAAI,KACF,IAAI,KACF;EAAE,IAAI;EAAW,IAAI;GAAE,GAAG,IAAI;GAAG,GAAG,IAAI;EAAE;EAAG,MAAM;CAAM,GACzD;EAAE,IAAI;EAAc,IAAI;GAAE,GAAG,IAAI,IAAI,IAAI,QAAQ;GAAG,GAAG,IAAI,IAAI,IAAI,SAAS;EAAE;EAAG,MAAM;CAAM,GAC7F;EAAE,IAAI;EAAW,IAAI;GAAE,GAAG,IAAI,IAAI,IAAI;GAAO,GAAG,IAAI,IAAI,IAAI;EAAO;EAAG,MAAM;CAAM,CACpF;CAEF,MAAM,WAAW,MAAM,aAAa,OAAO,GAAG,KAAK;CACnD,IAAI,KAAK;EAAE,IAAI;EAAY,IAAI;GAAE,GAAG,SAAS;GAAG,GAAG,SAAS;EAAE;EAAG,MAAM;CAAW,CAAC;CACnF,OAAO;AACT"}
+{"version":3,"file":"probes2d.js","names":[],"sources":["../../../src/domains/snap/probes2d.ts"],"sourcesContent":["import { unionBounds } from 'core/geometry/unionBounds';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\nimport type { SnapBegin } from 'interactions/actions/snapDep';\nimport type { SnapProbeAt } from './types';\nimport { resizeProbes, resizeSubject, type ResizeSubject } from './resizeBox';\nimport type { Point } from '@weasel-js/geom';\n\n/** How a 2D session reads its subject at press. */\nexport interface ProbeReads {\n  /** `id`'s world pose now, or undefined when it is gone. */\n  pose(id: string): unknown;\n  /** The axis-aligned box `id` is drawn with at `pose`, stroke included. */\n  drawnBox(id: string, pose: unknown): Bounds;\n  /** The point of `pose` the `origin` probe sits at: its `OriginProjection` origin. */\n  origin(pose: unknown): Point;\n  /** The point of the subject's own geometry nearest `press`, or null. */\n  geometryAt?(press: Point, ids: readonly string[]): Point | null;\n  /** `id`'s declared snap anchors, in world. */\n  anchors?(id: string): readonly Point[];\n}\n\n/** The union drawn box of the subjects, or null when none is left. */\nexport function subjectBox(ids: readonly string[], reads: ProbeReads): Bounds | null {\n  const boxes: Bounds[] = [];\n  for (const id of ids) {\n    const pose = reads.pose(id);\n    if (pose !== undefined) boxes.push(reads.drawnBox(id, pose));\n  }\n  return unionBounds(boxes);\n}\n\n/** What a gesture drags, read once at press. */\nexport interface Subject2d {\n  /** A move's subjects' union drawn box. */\n  box: Bounds | null;\n  /** A resize's box and frame: the one it names, else the subjects' drawn\n   *  box, axis-aligned. */\n  resize: ResizeSubject | null;\n}\n\n/** The subject of `req`, null where the gesture has none or nothing is left. */\nexport function subjectOf(req: SnapBegin, reads: ProbeReads): Subject2d {\n  if (req.gesture === 'move') return { box: subjectBox(req.ids ?? [], reads), resize: null };\n  if (req.gesture !== 'resize' || !req.handle) return { box: null, resize: null };\n  if (req.box) return { box: null, resize: resizeSubject(req.box, req.handle) };\n  const bounds = subjectBox(req.ids ?? [], reads);\n  return { box: null, resize: bounds ? resizeSubject({ bounds }, req.handle) : null };\n}\n\n/** The probes a gesture snaps, where they are at press. */\nexport function buildProbes(req: SnapBegin, reads: ProbeReads, subject = subjectOf(req, reads)): SnapProbeAt[] {\n  const ids = req.ids ?? [];\n  switch (req.gesture) {\n    case 'point':\n      return [{ id: 'pointer', at: req.press, role: 'pointer' }];\n    case 'resize':\n      return subject.resize ? resizeProbes(subject.resize) : [{ id: 'pointer', at: req.press, role: 'pointer' }];\n    case 'move':\n      return moveProbes(req.press, ids, reads, subject.box);\n    case 'rotate':\n    case 'handle':\n      return [];\n  }\n}\n\nfunction moveProbes(press: Point, ids: readonly string[], reads: ProbeReads, box: Bounds | null): SnapProbeAt[] {\n  const out: SnapProbeAt[] = [];\n  for (const id of ids) {\n    const pose = reads.pose(id);\n    if (pose !== undefined) out.push({ id: `origin:${id}`, at: reads.origin(pose), role: 'origin' });\n  }\n  if (reads.anchors) {\n    for (const id of ids) {\n      reads.anchors(id).forEach((at, i) => out.push({ id: `anchor:${id}:${i}`, at, role: 'anchor' }));\n    }\n  }\n  if (box) {\n    out.push(\n      { id: 'box.min', at: { x: box.x, y: box.y }, role: 'box' },\n      { id: 'box.center', at: { x: box.x + box.width / 2, y: box.y + box.height / 2 }, role: 'box' },\n      { id: 'box.max', at: { x: box.x + box.width, y: box.y + box.height }, role: 'box' },\n    );\n  }\n  const geometry = reads.geometryAt?.(press, ids) ?? press;\n  out.push({ id: 'geometry', at: { x: geometry.x, y: geometry.y }, role: 'geometry' });\n  return out;\n}\n"],"mappings":";;;;;AAsBA,SAAgB,WAAW,KAAwB,OAAkC;CACnF,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,MAAM,KAAK;EACpB,MAAM,OAAO,MAAM,KAAK,EAAE;EAC1B,IAAI,SAAS,QAAW,MAAM,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC;CAC7D;CACA,OAAO,YAAY,KAAK;AAC1B;;AAYA,SAAgB,UAAU,KAAgB,OAA8B;CACtE,IAAI,IAAI,YAAY,QAAQ,OAAO;EAAE,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,KAAK;EAAG,QAAQ;CAAK;CACzF,IAAI,IAAI,YAAY,YAAY,CAAC,IAAI,QAAQ,OAAO;EAAE,KAAK;EAAM,QAAQ;CAAK;CAC9E,IAAI,IAAI,KAAK,OAAO;EAAE,KAAK;EAAM,QAAQ,cAAc,IAAI,KAAK,IAAI,MAAM;CAAE;CAC5E,MAAM,SAAS,WAAW,IAAI,OAAO,CAAC,GAAG,KAAK;CAC9C,OAAO;EAAE,KAAK;EAAM,QAAQ,SAAS,cAAc,EAAE,OAAO,GAAG,IAAI,MAAM,IAAI;CAAK;AACpF;;AAGA,SAAgB,YAAY,KAAgB,OAAmB,UAAU,UAAU,KAAK,KAAK,GAAkB;CAC7G,MAAM,MAAM,IAAI,OAAO,CAAC;CACxB,QAAQ,IAAI,SAAZ;EACE,KAAK,SACH,OAAO,CAAC;GAAE,IAAI;GAAW,IAAI,IAAI;GAAO,MAAM;EAAU,CAAC;EAC3D,KAAK,UACH,OAAO,QAAQ,SAAS,aAAa,QAAQ,MAAM,IAAI,CAAC;GAAE,IAAI;GAAW,IAAI,IAAI;GAAO,MAAM;EAAU,CAAC;EAC3G,KAAK,QACH,OAAO,WAAW,IAAI,OAAO,KAAK,OAAO,QAAQ,GAAG;EACtD,KAAK;EACL,KAAK,UACH,OAAO,CAAC;CACZ;AACF;AAEA,SAAS,WAAW,OAAc,KAAwB,OAAmB,KAAmC;CAC9G,MAAM,MAAqB,CAAC;CAC5B,KAAK,MAAM,MAAM,KAAK;EACpB,MAAM,OAAO,MAAM,KAAK,EAAE;EAC1B,IAAI,SAAS,QAAW,IAAI,KAAK;GAAE,IAAI,UAAU;GAAM,IAAI,MAAM,OAAO,IAAI;GAAG,MAAM;EAAS,CAAC;CACjG;CACA,IAAI,MAAM,SACR,KAAK,MAAM,MAAM,KACf,MAAM,QAAQ,EAAE,CAAC,CAAC,SAAS,IAAI,MAAM,IAAI,KAAK;EAAE,IAAI,UAAU,GAAG,GAAG;EAAK;EAAI,MAAM;CAAS,CAAC,CAAC;CAGlG,IAAI,KACF,IAAI,KACF;EAAE,IAAI;EAAW,IAAI;GAAE,GAAG,IAAI;GAAG,GAAG,IAAI;EAAE;EAAG,MAAM;CAAM,GACzD;EAAE,IAAI;EAAc,IAAI;GAAE,GAAG,IAAI,IAAI,IAAI,QAAQ;GAAG,GAAG,IAAI,IAAI,IAAI,SAAS;EAAE;EAAG,MAAM;CAAM,GAC7F;EAAE,IAAI;EAAW,IAAI;GAAE,GAAG,IAAI,IAAI,IAAI;GAAO,GAAG,IAAI,IAAI,IAAI;EAAO;EAAG,MAAM;CAAM,CACpF;CAEF,MAAM,WAAW,MAAM,aAAa,OAAO,GAAG,KAAK;CACnD,IAAI,KAAK;EAAE,IAAI;EAAY,IAAI;GAAE,GAAG,SAAS;GAAG,GAAG,SAAS;EAAE;EAAG,MAAM;CAAW,CAAC;CACnF,OAAO;AACT"}

package/dist/domains/snap/readoutDraw.js

@@ -2,7 +2,7 @@ import { pathSnapGlyph } from "../paths/pathSnap/glyphs.js";
 import { textCommand, textCommandFromRuns } from "@weasel-js/renderer";
 import { PATH_L, PATH_M, pathFromD, rectPath } from "@weasel-js/geom";
 
-//#region src/domains/snap/readoutDraw.ts
+// src/domains/snap/readoutDraw.ts
 /**
 * The screen-space drawing the snap readout and the guides overlay share:
 * ticked segments, number pills, and the glyph-and-label of a point mark.
@@ -88,6 +88,5 @@ function glyphCommands(glyph, x, y, label, color, r = 5, fontSize = 11) {
 	return out;
 }
 
-//#endregion
 export { glyphCommands, measuredSegmentCommands, pillCommands, tickedSegment };
 //# sourceMappingURL=readoutDraw.js.map

package/dist/domains/snap/readoutLayer.js

@@ -2,7 +2,7 @@ import { viewToTransform } from "../../core/viewport/view.js";
 import { worldToScreen } from "../../core/viewport/viewTransform.js";
 import { glyphCommands, measuredSegmentCommands } from "./readoutDraw.js";
 
-//#region src/domains/snap/readoutLayer.ts
+// src/domains/snap/readoutLayer.ts
 var TICK = 6;
 /** A screen-space layer drawing the marks in `store`, redrawn when they change. */
 function createSnapReadoutLayer(store, style = {}) {
@@ -44,6 +44,5 @@ function createSnapReadoutLayer(store, style = {}) {
 	};
 }
 
-//#endregion
 export { createSnapReadoutLayer };
 //# sourceMappingURL=readoutLayer.js.map

package/dist/domains/snap/registry.js

@@ -1,6 +1,6 @@
 import { createContext, useContext, useEffect } from "react";
 
-//#region src/domains/snap/registry.ts
+// src/domains/snap/registry.ts
 function createSnapSourceRegistry() {
 	let sources = [];
 	return {
@@ -22,6 +22,5 @@ function useSnapSource(source) {
 	useEffect(() => registry.add(source), [registry, source]);
 }
 
-//#endregion
 export { SnapSourceRegistryContext, createSnapSourceRegistry, useSnapSource };
 //# sourceMappingURL=registry.js.map

package/dist/domains/snap/resizeBox.js

@@ -1,6 +1,6 @@
 import { fixedCornerOf, movedEdges, movingPoint } from "../../interactions/actions/resize/cornerHandles.js";
 
-//#region src/domains/snap/resizeBox.ts
+// src/domains/snap/resizeBox.ts
 var EPS = 1e-9;
 function resizeSubject(box, handle) {
 	const at = box.toWorld ?? ((p) => p);
@@ -153,6 +153,5 @@ function resizeSides(s, delta) {
 	return out;
 }
 
-//#endregion
 export { EPS, diagonal, edgeAxis, resizeProbes, resizeSides, resizeSubject, resizedBox };
 //# sourceMappingURL=resizeBox.js.map

package/dist/domains/snap/roles.js

@@ -1,6 +1,6 @@
 import { roleReader } from "@weasel-js/routing";
 
-//#region src/domains/snap/roles.ts
+// src/domains/snap/roles.ts
 /** The modifier roles a snapping action declares. */
 var SNAP_ROLES = {
 	"snap.suspend": {
@@ -27,6 +27,5 @@ function snapMods(ctx) {
 	};
 }
 
-//#endregion
 export { SNAP_ANGLE_STEP, SNAP_AXIS_STEP, SNAP_ROLES, snapMods };
 //# sourceMappingURL=roles.js.map

package/dist/domains/snap/rotationSource.js

@@ -1,4 +1,4 @@
-//#region src/domains/snap/rotationSource.ts
+// src/domains/snap/rotationSource.ts
 var QUARTER = Math.PI / 2;
 /**
 * A rotate's angle targets: every quarter turn, and the world rotation of
@@ -42,6 +42,5 @@ function rotationSnapSource() {
 	};
 }
 
-//#endregion
 export { rotationSnapSource };
 //# sourceMappingURL=rotationSource.js.map

package/dist/domains/snap/sceneReads.js

@@ -1,19 +1,29 @@
-import { sceneBoxFrames, scenePoseFrame } from "../../interactions/actions/poseFrame.js";
 import { nodeDescriptors, poseDescriptorOf } from "../../interactions/actions/poseDescriptorDep.js";
+import { sceneBoxFrames, scenePoseFrame } from "../../interactions/actions/poseFrame.js";
 import { AUTO_ORIGIN_PROJECTION } from "../../interactions/gestures/shared/originProjection.js";
 import { applyToPoint, invert } from "@weasel-js/geom";
 
-//#region src/domains/snap/sceneReads.ts
+// src/domains/snap/sceneReads.ts
 /** {@link ProbeReads} over a canvas's scene, read when a session begins.
 *  `boxes` is the canvas's `drawnBoxes`, which alignment measures with too. */
 function sceneProbeReads(args) {
 	const { scene } = args;
 	const frame = scenePoseFrame(scene);
+	const anchors = args.anchors;
 	return {
 		pose: (id) => scene.get(id) === void 0 ? void 0 : frame.world(id),
 		drawnBox: (id, pose) => args.boxes.aabb(id, pose),
 		origin: (pose) => (args.originProjection ?? AUTO_ORIGIN_PROJECTION).getOrigin(pose),
-		...args.geometryAt ? { geometryAt: args.geometryAt } : {}
+		...args.geometryAt ? { geometryAt: args.geometryAt } : {},
+		...anchors ? { anchors: worldAnchors(scene, anchors) } : {}
+	};
+}
+function worldAnchors(scene, anchors) {
+	const frames = sceneSnapFrames(scene);
+	return (id) => {
+		const local = anchors(id);
+		const frame = local?.length ? frames(id) : void 0;
+		return local && frame ? local.map((p) => frame.toWorld(p)) : [];
 	};
 }
 /** Each node's world rotation, read through its own descriptor the way a
@@ -61,6 +71,5 @@ function withSubtrees(scene, ids) {
 	return [...out];
 }
 
-//#endregion
 export { sceneProbeReads, sceneRotations, sceneSnapFrames, withSubtrees };
 //# sourceMappingURL=sceneReads.js.map

package/dist/domains/snap/sceneReads.js.map

@@ -1 +1 @@
-{"version":3,"file":"sceneReads.js","names":[],"sources":["../../../src/domains/snap/sceneReads.ts"],"sourcesContent":["import { applyToPoint, invert, type Point } from '@weasel-js/geom';\nimport type { WorldPoint } from '@weasel-js/routing';\nimport type { NodeId, Scene } from 'core/scene/types';\nimport type { DrawnBoxes } from 'interactions/actions/drawnBoxes';\nimport { nodeDescriptors, poseDescriptorOf } from 'interactions/actions/poseDescriptorDep';\nimport { sceneBoxFrames, scenePoseFrame } from 'interactions/actions/poseFrame';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport { AUTO_ORIGIN_PROJECTION, type OriginProjection } from 'interactions/gestures/shared/originProjection';\nimport type { ProbeReads } from './probes2d';\nimport type { SnapFrame } from './types';\n\n/** {@link ProbeReads} over a canvas's scene, read when a session begins.\n *  `boxes` is the canvas's `drawnBoxes`, which alignment measures with too. */\nexport function sceneProbeReads(args: {\n  scene: Scene<unknown, string, unknown>;\n  boxes: DrawnBoxes;\n  geometryAt?: (press: WorldPoint, ids: readonly string[]) => WorldPoint | null;\n  /** How a pose's origin is read. Default `AUTO_ORIGIN_PROJECTION`. */\n  originProjection?: OriginProjection<unknown>;\n}): ProbeReads {\n  const { scene } = args;\n  const frame = scenePoseFrame(scene);\n  return {\n    pose: (id) => (scene.get(id as NodeId) === undefined ? undefined : frame.world(id as NodeId)),\n    drawnBox: (id, pose) => args.boxes.aabb(id, pose),\n    origin: (pose) => (args.originProjection ?? AUTO_ORIGIN_PROJECTION).getOrigin(pose),\n    ...(args.geometryAt ? { geometryAt: args.geometryAt } : {}),\n  };\n}\n\n/** Each node's world rotation, read through its own descriptor the way a\n *  rotate reads its subject; undefined for a node that cannot turn. */\nexport function sceneRotations(\n  scene: Scene<unknown, string, unknown>,\n  descriptor?: PoseDescriptor<unknown>,\n): (id: string) => number | undefined {\n  const frame = scenePoseFrame(scene);\n  const descriptorOf = nodeDescriptors(scene, poseDescriptorOf(descriptor));\n  return (id) => {\n    const node = scene.get(id as NodeId);\n    if (!node) return undefined;\n    const d = descriptorOf(id);\n    if (!d.withRotation || !d.getRotation || d.supportsRotation?.(node.pose) === false) return undefined;\n    return d.getRotation(frame.world(id as NodeId));\n  };\n}\n\n/** Each node's box frame, as `SnapCollect.frameOf` hands it to a source. */\nexport function sceneSnapFrames(scene: Scene<unknown, string, unknown>): (id: string) => SnapFrame | undefined {\n  const boxes = sceneBoxFrames(scene);\n  return (id) => {\n    const m = boxes(id);\n    if (!m) return undefined;\n    const back = invert(m);\n    const through = (t: typeof m, p: Point): Point => {\n      const [x, y] = applyToPoint(t, p.x, p.y);\n      return { x, y };\n    };\n    return { toWorld: (p) => through(m, p), toLocal: (p) => (back ? through(back, p) : null) };\n  };\n}\n\n/** `ids` and every node under them: what a gesture moving `ids` carries. */\nexport function withSubtrees(scene: Scene<unknown, string, unknown>, ids: readonly string[]): string[] {\n  const out = new Set<string>();\n  const walk = (id: string): void => {\n    if (out.has(id)) return;\n    out.add(id);\n    if (scene.get(id as NodeId) !== undefined) for (const c of scene.childrenOf(id as NodeId)) walk(c);\n  };\n  for (const id of ids) walk(id);\n  return [...out];\n}\n"],"mappings":";;;;;;;;AAaA,SAAgB,gBAAgB,MAMjB;CACb,MAAM,EAAE,UAAU;CAClB,MAAM,QAAQ,eAAe,KAAK;CAClC,OAAO;EACL,OAAO,OAAQ,MAAM,IAAI,EAAY,MAAM,SAAY,SAAY,MAAM,MAAM,EAAY;EAC3F,WAAW,IAAI,SAAS,KAAK,MAAM,KAAK,IAAI,IAAI;EAChD,SAAS,UAAU,KAAK,oBAAoB,uBAAA,CAAwB,UAAU,IAAI;EAClF,GAAI,KAAK,aAAa,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;CAC3D;AACF;;;AAIA,SAAgB,eACd,OACA,YACoC;CACpC,MAAM,QAAQ,eAAe,KAAK;CAClC,MAAM,eAAe,gBAAgB,OAAO,iBAAiB,UAAU,CAAC;CACxE,QAAQ,OAAO;EACb,MAAM,OAAO,MAAM,IAAI,EAAY;EACnC,IAAI,CAAC,MAAM,OAAO;EAClB,MAAM,IAAI,aAAa,EAAE;EACzB,IAAI,CAAC,EAAE,gBAAgB,CAAC,EAAE,eAAe,EAAE,mBAAmB,KAAK,IAAI,MAAM,OAAO,OAAO;EAC3F,OAAO,EAAE,YAAY,MAAM,MAAM,EAAY,CAAC;CAChD;AACF;;AAGA,SAAgB,gBAAgB,OAA+E;CAC7G,MAAM,QAAQ,eAAe,KAAK;CAClC,QAAQ,OAAO;EACb,MAAM,IAAI,MAAM,EAAE;EAClB,IAAI,CAAC,GAAG,OAAO;EACf,MAAM,OAAO,OAAO,CAAC;EACrB,MAAM,WAAW,GAAa,MAAoB;GAChD,MAAM,CAAC,GAAG,KAAK,aAAa,GAAG,EAAE,GAAG,EAAE,CAAC;GACvC,OAAO;IAAE;IAAG;GAAE;EAChB;EACA,OAAO;GAAE,UAAU,MAAM,QAAQ,GAAG,CAAC;GAAG,UAAU,MAAO,OAAO,QAAQ,MAAM,CAAC,IAAI;EAAM;CAC3F;AACF;;AAGA,SAAgB,aAAa,OAAwC,KAAkC;CACrG,MAAM,sBAAM,IAAI,IAAY;CAC5B,MAAM,QAAQ,OAAqB;EACjC,IAAI,IAAI,IAAI,EAAE,GAAG;EACjB,IAAI,IAAI,EAAE;EACV,IAAI,MAAM,IAAI,EAAY,MAAM,QAAW,KAAK,MAAM,KAAK,MAAM,WAAW,EAAY,GAAG,KAAK,CAAC;CACnG;CACA,KAAK,MAAM,MAAM,KAAK,KAAK,EAAE;CAC7B,OAAO,CAAC,GAAG,GAAG;AAChB"}
+{"version":3,"file":"sceneReads.js","names":[],"sources":["../../../src/domains/snap/sceneReads.ts"],"sourcesContent":["import { applyToPoint, invert, type Point } from '@weasel-js/geom';\nimport type { WorldPoint } from '@weasel-js/routing';\nimport type { NodeId, Scene } from 'core/scene/types';\nimport type { DrawnBoxes } from 'interactions/actions/drawnBoxes';\nimport { nodeDescriptors, poseDescriptorOf } from 'interactions/actions/poseDescriptorDep';\nimport { sceneBoxFrames, scenePoseFrame } from 'interactions/actions/poseFrame';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport { AUTO_ORIGIN_PROJECTION, type OriginProjection } from 'interactions/gestures/shared/originProjection';\nimport type { ProbeReads } from './probes2d';\nimport type { SnapAnchors, SnapFrame } from './types';\n\n/** {@link ProbeReads} over a canvas's scene, read when a session begins.\n *  `boxes` is the canvas's `drawnBoxes`, which alignment measures with too. */\nexport function sceneProbeReads(args: {\n  scene: Scene<unknown, string, unknown>;\n  boxes: DrawnBoxes;\n  geometryAt?: (press: WorldPoint, ids: readonly string[]) => WorldPoint | null;\n  /** How a pose's origin is read. Default `AUTO_ORIGIN_PROJECTION`. */\n  originProjection?: OriginProjection<unknown>;\n  /** Each node's snap anchors, in its box frame. */\n  anchors?: SnapAnchors;\n}): ProbeReads {\n  const { scene } = args;\n  const frame = scenePoseFrame(scene);\n  const anchors = args.anchors;\n  return {\n    pose: (id) => (scene.get(id as NodeId) === undefined ? undefined : frame.world(id as NodeId)),\n    drawnBox: (id, pose) => args.boxes.aabb(id, pose),\n    origin: (pose) => (args.originProjection ?? AUTO_ORIGIN_PROJECTION).getOrigin(pose),\n    ...(args.geometryAt ? { geometryAt: args.geometryAt } : {}),\n    ...(anchors ? { anchors: worldAnchors(scene, anchors) } : {}),\n  };\n}\n\nfunction worldAnchors(scene: Scene<unknown, string, unknown>, anchors: SnapAnchors): (id: string) => readonly Point[] {\n  const frames = sceneSnapFrames(scene);\n  return (id) => {\n    const local = anchors(id);\n    const frame = local?.length ? frames(id) : undefined;\n    return local && frame ? local.map((p) => frame.toWorld(p)) : [];\n  };\n}\n\n/** Each node's world rotation, read through its own descriptor the way a\n *  rotate reads its subject; undefined for a node that cannot turn. */\nexport function sceneRotations(\n  scene: Scene<unknown, string, unknown>,\n  descriptor?: PoseDescriptor<unknown>,\n): (id: string) => number | undefined {\n  const frame = scenePoseFrame(scene);\n  const descriptorOf = nodeDescriptors(scene, poseDescriptorOf(descriptor));\n  return (id) => {\n    const node = scene.get(id as NodeId);\n    if (!node) return undefined;\n    const d = descriptorOf(id);\n    if (!d.withRotation || !d.getRotation || d.supportsRotation?.(node.pose) === false) return undefined;\n    return d.getRotation(frame.world(id as NodeId));\n  };\n}\n\n/** Each node's box frame, as `SnapCollect.frameOf` hands it to a source. */\nexport function sceneSnapFrames(scene: Scene<unknown, string, unknown>): (id: string) => SnapFrame | undefined {\n  const boxes = sceneBoxFrames(scene);\n  return (id) => {\n    const m = boxes(id);\n    if (!m) return undefined;\n    const back = invert(m);\n    const through = (t: typeof m, p: Point): Point => {\n      const [x, y] = applyToPoint(t, p.x, p.y);\n      return { x, y };\n    };\n    return { toWorld: (p) => through(m, p), toLocal: (p) => (back ? through(back, p) : null) };\n  };\n}\n\n/** `ids` and every node under them: what a gesture moving `ids` carries. */\nexport function withSubtrees(scene: Scene<unknown, string, unknown>, ids: readonly string[]): string[] {\n  const out = new Set<string>();\n  const walk = (id: string): void => {\n    if (out.has(id)) return;\n    out.add(id);\n    if (scene.get(id as NodeId) !== undefined) for (const c of scene.childrenOf(id as NodeId)) walk(c);\n  };\n  for (const id of ids) walk(id);\n  return [...out];\n}\n"],"mappings":";;;;;;;;AAaA,SAAgB,gBAAgB,MAQjB;CACb,MAAM,EAAE,UAAU;CAClB,MAAM,QAAQ,eAAe,KAAK;CAClC,MAAM,UAAU,KAAK;CACrB,OAAO;EACL,OAAO,OAAQ,MAAM,IAAI,EAAY,MAAM,SAAY,SAAY,MAAM,MAAM,EAAY;EAC3F,WAAW,IAAI,SAAS,KAAK,MAAM,KAAK,IAAI,IAAI;EAChD,SAAS,UAAU,KAAK,oBAAoB,uBAAA,CAAwB,UAAU,IAAI;EAClF,GAAI,KAAK,aAAa,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;EACzD,GAAI,UAAU,EAAE,SAAS,aAAa,OAAO,OAAO,EAAE,IAAI,CAAC;CAC7D;AACF;AAEA,SAAS,aAAa,OAAwC,SAAwD;CACpH,MAAM,SAAS,gBAAgB,KAAK;CACpC,QAAQ,OAAO;EACb,MAAM,QAAQ,QAAQ,EAAE;EACxB,MAAM,QAAQ,OAAO,SAAS,OAAO,EAAE,IAAI;EAC3C,OAAO,SAAS,QAAQ,MAAM,KAAK,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC;CAChE;AACF;;;AAIA,SAAgB,eACd,OACA,YACoC;CACpC,MAAM,QAAQ,eAAe,KAAK;CAClC,MAAM,eAAe,gBAAgB,OAAO,iBAAiB,UAAU,CAAC;CACxE,QAAQ,OAAO;EACb,MAAM,OAAO,MAAM,IAAI,EAAY;EACnC,IAAI,CAAC,MAAM,OAAO;EAClB,MAAM,IAAI,aAAa,EAAE;EACzB,IAAI,CAAC,EAAE,gBAAgB,CAAC,EAAE,eAAe,EAAE,mBAAmB,KAAK,IAAI,MAAM,OAAO,OAAO;EAC3F,OAAO,EAAE,YAAY,MAAM,MAAM,EAAY,CAAC;CAChD;AACF;;AAGA,SAAgB,gBAAgB,OAA+E;CAC7G,MAAM,QAAQ,eAAe,KAAK;CAClC,QAAQ,OAAO;EACb,MAAM,IAAI,MAAM,EAAE;EAClB,IAAI,CAAC,GAAG,OAAO;EACf,MAAM,OAAO,OAAO,CAAC;EACrB,MAAM,WAAW,GAAa,MAAoB;GAChD,MAAM,CAAC,GAAG,KAAK,aAAa,GAAG,EAAE,GAAG,EAAE,CAAC;GACvC,OAAO;IAAE;IAAG;GAAE;EAChB;EACA,OAAO;GAAE,UAAU,MAAM,QAAQ,GAAG,CAAC;GAAG,UAAU,MAAO,OAAO,QAAQ,MAAM,CAAC,IAAI;EAAM;CAC3F;AACF;;AAGA,SAAgB,aAAa,OAAwC,KAAkC;CACrG,MAAM,sBAAM,IAAI,IAAY;CAC5B,MAAM,QAAQ,OAAqB;EACjC,IAAI,IAAI,IAAI,EAAE,GAAG;EACjB,IAAI,IAAI,EAAE;EACV,IAAI,MAAM,IAAI,EAAY,MAAM,QAAW,KAAK,MAAM,KAAK,MAAM,WAAW,EAAY,GAAG,KAAK,CAAC;CACnG;CACA,KAAK,MAAM,MAAM,KAAK,KAAK,EAAE;CAC7B,OAAO,CAAC,GAAG,GAAG;AAChB"}

package/dist/domains/snap/sceneSession2d.js

@@ -1,17 +1,18 @@
 import { drawnBoxes } from "../../interactions/actions/drawnBoxes.js";
 import { createSnapOutcomeStore } from "./outcomeStore.js";
-import { DEFAULT_SNAP_PX, createSession2d } from "./session2d.js";
 import { buildProbes, subjectOf } from "./probes2d.js";
 import { sceneProbeReads, sceneRotations, sceneSnapFrames, withSubtrees } from "./sceneReads.js";
+import { DEFAULT_SNAP_PX, createSession2d } from "./session2d.js";
 
-//#region src/domains/snap/sceneSession2d.ts
+// src/domains/snap/sceneSession2d.ts
 /** A 2D session whose probes are the subject's, read from the scene at press. */
 function sceneSession2d(i) {
 	const reads = sceneProbeReads({
 		scene: i.scene,
 		boxes: i.boxes,
 		...i.geometryAt ? { geometryAt: i.geometryAt } : {},
-		...i.originProjection ? { originProjection: i.originProjection } : {}
+		...i.originProjection ? { originProjection: i.originProjection } : {},
+		...i.anchors ? { anchors: i.anchors } : {}
 	});
 	const subject = subjectOf(i.req, reads);
 	return createSession2d({
@@ -73,10 +74,10 @@ function createSnapSession2d(opts) {
 		reachPx: opts.reachPx ?? DEFAULT_SNAP_PX,
 		store: opts.store ?? createSnapOutcomeStore(),
 		...opts.originProjection ? { originProjection: opts.originProjection } : {},
-		...opts.poseDescriptor ? { poseDescriptor: opts.poseDescriptor } : {}
+		...opts.poseDescriptor ? { poseDescriptor: opts.poseDescriptor } : {},
+		...opts.anchors ? { anchors: opts.anchors } : {}
 	});
 }
 
-//#endregion
 export { createSnapSession2d, sceneSession2d };
 //# sourceMappingURL=sceneSession2d.js.map

package/dist/domains/snap/sceneSession2d.js.map

@@ -1 +1 @@
-{"version":3,"file":"sceneSession2d.js","names":[],"sources":["../../../src/domains/snap/sceneSession2d.ts"],"sourcesContent":["import type { ResizeAnchor, WorldPoint } from '@weasel-js/routing';\nimport type { View } from '@weasel-js/geom';\nimport type { DebugSink } from '@weasel-js/routing';\nimport type { PoseDescriptor } from 'core/geometry/poseDescriptor';\nimport type { Scene } from 'core/scene/types';\nimport type { PlaneMap } from 'core/viewport/parallax';\nimport type { OriginProjection } from 'interactions/gestures/shared/originProjection';\nimport { drawnBoxes, type DrawnBoxes } from 'interactions/actions/drawnBoxes';\nimport type { SnapBegin, SnapConstrain, SnapGeometry, SnapResizeBox, SnapSession } from 'interactions/actions/snapDep';\nimport { createSnapOutcomeStore, type SnapOutcomeStore } from './outcomeStore';\nimport { buildProbes, subjectOf } from './probes2d';\nimport { sceneProbeReads, sceneRotations, sceneSnapFrames, withSubtrees } from './sceneReads';\nimport { createSession2d, DEFAULT_SNAP_PX } from './session2d';\nimport type { SnapGesture, SnapSource } from './types';\n\ntype AnyScene = Scene<unknown, string, unknown>;\n\n/** What a session over a scene runs on: its subject's probes and boxes come\n *  from `scene`, measured through `boxes`. */\nexport interface SceneSessionInputs {\n  req: SnapBegin;\n  scene: AnyScene;\n  boxes: DrawnBoxes;\n  sources: readonly SnapSource[];\n  view(): View | null;\n  reachPx: number;\n  store: SnapOutcomeStore;\n  geometryAt?: (press: WorldPoint, ids: readonly string[]) => WorldPoint | null;\n  /** How a pose's origin is read. Default `AUTO_ORIGIN_PROJECTION`. */\n  originProjection?: OriginProjection<unknown>;\n  /** How a node's rotation is read. Default `AUTO_POSE_DESCRIPTOR`. */\n  poseDescriptor?: PoseDescriptor<unknown>;\n  /** Where each frame's candidates are recorded. */\n  debug?: DebugSink;\n}\n\n/** A 2D session whose probes are the subject's, read from the scene at press. */\nexport function sceneSession2d(i: SceneSessionInputs): SnapSession {\n  const reads = sceneProbeReads({\n    scene: i.scene, boxes: i.boxes,\n    ...(i.geometryAt ? { geometryAt: i.geometryAt } : {}),\n    ...(i.originProjection ? { originProjection: i.originProjection } : {}),\n  });\n  const subject = subjectOf(i.req, reads);\n  return createSession2d({\n    req: i.req,\n    sources: i.sources,\n    probes: buildProbes(i.req, reads, subject),\n    box: subject.box,\n    resize: subject.resize,\n    drawnBox: (id) => {\n      const pose = reads.pose(id);\n      return pose === undefined ? undefined : reads.drawnBox(id, pose);\n    },\n    ...(i.req.ids ? { exclude: withSubtrees(i.scene, i.req.ids) } : {}),\n    view: i.view,\n    reachPx: i.reachPx,\n    scene: i.scene,\n    rotationOf: sceneRotations(i.scene, i.poseDescriptor),\n    frameOf: sceneSnapFrames(i.scene),\n    store: i.store,\n    ...(i.debug ? { debug: i.debug } : {}),\n  });\n}\n\n/** Options for {@link createSnapSession2d}. */\nexport interface SnapSession2dOptions {\n  scene: AnyScene;\n  /** The camera the reach is measured through. */\n  view: View;\n  sources: readonly SnapSource[];\n  gesture: SnapGesture;\n  /** World coords. */\n  press: WorldPoint;\n  /** The subject, whose geometry offers no targets. */\n  ids?: readonly string[];\n  /** The container a subject not yet in the scene lands in. */\n  parent?: string;\n  /** Point gestures: the previous anchor, a line's start. */\n  origin?: WorldPoint;\n  constrain?: SnapConstrain;\n  /** Resize: the sides the drag pins. */\n  handle?: ResizeAnchor;\n  /** Rotate: the point the angle turns about. */\n  pivot?: WorldPoint;\n  /** Rotate: the subject's angle at press. */\n  theta0?: number;\n  /** Angle gestures: the reach as an angle, radians. */\n  reachRad?: number;\n  /** Resize: the box `handle` belongs to. Default: the subjects' drawn box. */\n  box?: SnapResizeBox;\n  also?: SnapGeometry;\n  /** The reach of a source that sets none, in screen px. Default `DEFAULT_SNAP_PX`. */\n  reachPx?: number;\n  /** Where the session writes its marks. Default: a store of its own. */\n  store?: SnapOutcomeStore;\n  /** How poses are read. Default `AUTO_POSE_DESCRIPTOR`. */\n  poseDescriptor?: PoseDescriptor<unknown>;\n  /** Whether drawn boxes include the stroke. Default `true`. */\n  boundsIncludeStroke?: boolean;\n  /** How a pose's origin, the point a grid or a guide snaps, is read.\n   *  Default `AUTO_ORIGIN_PROJECTION`: a rect's `{x, y}`, a path's bounds. */\n  originProjection?: OriginProjection<unknown>;\n  /** How `view`'s world maps into the parallax plane the gesture's points\n   *  are in. Default: they are in `view`'s own world. */\n  plane?: PlaneMap | null;\n}\n\n/**\n * One gesture's snapping over a scene, for a host without `<SceneCanvas>`:\n * the session a canvas's `snap` dep begins, built from the same probes and\n * drawn boxes. Call `at` with each world point the gesture reaches, and\n * `end` when it lets go.\n */\nexport function createSnapSession2d(opts: SnapSession2dOptions): SnapSession {\n  const view = opts.view;\n  const req: SnapBegin = {\n    gesture: opts.gesture,\n    press: opts.press,\n    ...(opts.ids ? { ids: opts.ids } : {}),\n    ...(opts.parent !== undefined ? { parent: opts.parent } : {}),\n    ...(opts.origin ? { origin: opts.origin } : {}),\n    ...(opts.constrain ? { constrain: opts.constrain } : {}),\n    ...(opts.handle ? { handle: opts.handle } : {}),\n    ...(opts.pivot ? { pivot: opts.pivot } : {}),\n    ...(opts.theta0 !== undefined ? { theta0: opts.theta0 } : {}),\n    ...(opts.reachRad !== undefined ? { reachRad: opts.reachRad } : {}),\n    ...(opts.box ? { box: opts.box } : {}),\n    ...(opts.also ? { also: opts.also } : {}),\n    ...(opts.plane ? { plane: () => opts.plane ?? null } : {}),\n  };\n  return sceneSession2d({\n    req,\n    scene: opts.scene,\n    boxes: drawnBoxes({\n      scene: opts.scene,\n      view: { get: () => view, set: () => {} },\n      ...(opts.poseDescriptor ? { poseDescriptor: opts.poseDescriptor } : {}),\n      ...(opts.boundsIncludeStroke !== undefined ? { boundsIncludeStroke: opts.boundsIncludeStroke } : {}),\n    }),\n    sources: opts.sources,\n    view: () => view,\n    reachPx: opts.reachPx ?? DEFAULT_SNAP_PX,\n    store: opts.store ?? createSnapOutcomeStore(),\n    ...(opts.originProjection ? { originProjection: opts.originProjection } : {}),\n    ...(opts.poseDescriptor ? { poseDescriptor: opts.poseDescriptor } : {}),\n  });\n}\n"],"mappings":";;;;;;;;AAqCA,SAAgB,eAAe,GAAoC;CACjE,MAAM,QAAQ,gBAAgB;EAC5B,OAAO,EAAE;EAAO,OAAO,EAAE;EACzB,GAAI,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,IAAI,CAAC;EACnD,GAAI,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,IAAI,CAAC;CACvE,CAAC;CACD,MAAM,UAAU,UAAU,EAAE,KAAK,KAAK;CACtC,OAAO,gBAAgB;EACrB,KAAK,EAAE;EACP,SAAS,EAAE;EACX,QAAQ,YAAY,EAAE,KAAK,OAAO,OAAO;EACzC,KAAK,QAAQ;EACb,QAAQ,QAAQ;EAChB,WAAW,OAAO;GAChB,MAAM,OAAO,MAAM,KAAK,EAAE;GAC1B,OAAO,SAAS,SAAY,SAAY,MAAM,SAAS,IAAI,IAAI;EACjE;EACA,GAAI,EAAE,IAAI,MAAM,EAAE,SAAS,aAAa,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,IAAI,CAAC;EACjE,MAAM,EAAE;EACR,SAAS,EAAE;EACX,OAAO,EAAE;EACT,YAAY,eAAe,EAAE,OAAO,EAAE,cAAc;EACpD,SAAS,gBAAgB,EAAE,KAAK;EAChC,OAAO,EAAE;EACT,GAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;CACtC,CAAC;AACH;;;;;;;AAmDA,SAAgB,oBAAoB,MAAyC;CAC3E,MAAM,OAAO,KAAK;CAgBlB,OAAO,eAAe;EACpB;GAfA,SAAS,KAAK;GACd,OAAO,KAAK;GACZ,GAAI,KAAK,MAAM,EAAE,KAAK,KAAK,IAAI,IAAI,CAAC;GACpC,GAAI,KAAK,WAAW,SAAY,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;GAC3D,GAAI,KAAK,SAAS,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;GAC7C,GAAI,KAAK,YAAY,EAAE,WAAW,KAAK,UAAU,IAAI,CAAC;GACtD,GAAI,KAAK,SAAS,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;GAC7C,GAAI,KAAK,QAAQ,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;GAC1C,GAAI,KAAK,WAAW,SAAY,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;GAC3D,GAAI,KAAK,aAAa,SAAY,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC;GACjE,GAAI,KAAK,MAAM,EAAE,KAAK,KAAK,IAAI,IAAI,CAAC;GACpC,GAAI,KAAK,OAAO,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC;GACvC,GAAI,KAAK,QAAQ,EAAE,aAAa,KAAK,SAAS,KAAK,IAAI,CAAC;EAGxD;EACA,OAAO,KAAK;EACZ,OAAO,WAAW;GAChB,OAAO,KAAK;GACZ,MAAM;IAAE,WAAW;IAAM,WAAW,CAAC;GAAE;GACvC,GAAI,KAAK,iBAAiB,EAAE,gBAAgB,KAAK,eAAe,IAAI,CAAC;GACrE,GAAI,KAAK,wBAAwB,SAAY,EAAE,qBAAqB,KAAK,oBAAoB,IAAI,CAAC;EACpG,CAAC;EACD,SAAS,KAAK;EACd,YAAY;EACZ,SAAS,KAAK,WAAW;EACzB,OAAO,KAAK,SAAS,uBAAuB;EAC5C,GAAI,KAAK,mBAAmB,EAAE,kBAAkB,KAAK,iBAAiB,IAAI,CAAC;EAC3E,GAAI,KAAK,iBAAiB,EAAE,gBAAgB,KAAK,eAAe,IAAI,CAAC;CACvE,CAAC;AACH"}
+{"version":3,"file":"sceneSession2d.js","names":[],"sources":["../../../src/domains/snap/sceneSession2d.ts"],"sourcesContent":["import type { ResizeAnchor, WorldPoint } from '@weasel-js/routing';\nimport type { View } from '@weasel-js/geom';\nimport type { DebugSink } from '@weasel-js/routing';\nimport type { PoseDescriptor } from 'core/geometry/poseDescriptor';\nimport type { Scene } from 'core/scene/types';\nimport type { PlaneMap } from 'core/viewport/parallax';\nimport type { OriginProjection } from 'interactions/gestures/shared/originProjection';\nimport { drawnBoxes, type DrawnBoxes } from 'interactions/actions/drawnBoxes';\nimport type { SnapBegin, SnapConstrain, SnapGeometry, SnapResizeBox, SnapSession } from 'interactions/actions/snapDep';\nimport { createSnapOutcomeStore, type SnapOutcomeStore } from './outcomeStore';\nimport { buildProbes, subjectOf } from './probes2d';\nimport { sceneProbeReads, sceneRotations, sceneSnapFrames, withSubtrees } from './sceneReads';\nimport { createSession2d, DEFAULT_SNAP_PX } from './session2d';\nimport type { SnapAnchors, SnapGesture, SnapSource } from './types';\n\ntype AnyScene = Scene<unknown, string, unknown>;\n\n/** What a session over a scene runs on: its subject's probes and boxes come\n *  from `scene`, measured through `boxes`. */\nexport interface SceneSessionInputs {\n  req: SnapBegin;\n  scene: AnyScene;\n  boxes: DrawnBoxes;\n  sources: readonly SnapSource[];\n  view(): View | null;\n  reachPx: number;\n  store: SnapOutcomeStore;\n  geometryAt?: (press: WorldPoint, ids: readonly string[]) => WorldPoint | null;\n  /** How a pose's origin is read. Default `AUTO_ORIGIN_PROJECTION`. */\n  originProjection?: OriginProjection<unknown>;\n  /** How a node's rotation is read. Default `AUTO_POSE_DESCRIPTOR`. */\n  poseDescriptor?: PoseDescriptor<unknown>;\n  /** Each node's snap anchors, in its box frame: `SceneCanvasSnap.anchors`. */\n  anchors?: SnapAnchors;\n  /** Where each frame's candidates are recorded. */\n  debug?: DebugSink;\n}\n\n/** A 2D session whose probes are the subject's, read from the scene at press. */\nexport function sceneSession2d(i: SceneSessionInputs): SnapSession {\n  const reads = sceneProbeReads({\n    scene: i.scene, boxes: i.boxes,\n    ...(i.geometryAt ? { geometryAt: i.geometryAt } : {}),\n    ...(i.originProjection ? { originProjection: i.originProjection } : {}),\n    ...(i.anchors ? { anchors: i.anchors } : {}),\n  });\n  const subject = subjectOf(i.req, reads);\n  return createSession2d({\n    req: i.req,\n    sources: i.sources,\n    probes: buildProbes(i.req, reads, subject),\n    box: subject.box,\n    resize: subject.resize,\n    drawnBox: (id) => {\n      const pose = reads.pose(id);\n      return pose === undefined ? undefined : reads.drawnBox(id, pose);\n    },\n    ...(i.req.ids ? { exclude: withSubtrees(i.scene, i.req.ids) } : {}),\n    view: i.view,\n    reachPx: i.reachPx,\n    scene: i.scene,\n    rotationOf: sceneRotations(i.scene, i.poseDescriptor),\n    frameOf: sceneSnapFrames(i.scene),\n    store: i.store,\n    ...(i.debug ? { debug: i.debug } : {}),\n  });\n}\n\n/** Options for {@link createSnapSession2d}. */\nexport interface SnapSession2dOptions {\n  scene: AnyScene;\n  /** The camera the reach is measured through. */\n  view: View;\n  sources: readonly SnapSource[];\n  gesture: SnapGesture;\n  /** World coords. */\n  press: WorldPoint;\n  /** The subject, whose geometry offers no targets. */\n  ids?: readonly string[];\n  /** The container a subject not yet in the scene lands in. */\n  parent?: string;\n  /** Point gestures: the previous anchor, a line's start. */\n  origin?: WorldPoint;\n  constrain?: SnapConstrain;\n  /** Resize: the sides the drag pins. */\n  handle?: ResizeAnchor;\n  /** Rotate: the point the angle turns about. */\n  pivot?: WorldPoint;\n  /** Rotate: the subject's angle at press. */\n  theta0?: number;\n  /** Angle gestures: the reach as an angle, radians. */\n  reachRad?: number;\n  /** Resize: the box `handle` belongs to. Default: the subjects' drawn box. */\n  box?: SnapResizeBox;\n  also?: SnapGeometry;\n  /** The reach of a source that sets none, in screen px. Default `DEFAULT_SNAP_PX`. */\n  reachPx?: number;\n  /** Where the session writes its marks. Default: a store of its own. */\n  store?: SnapOutcomeStore;\n  /** How poses are read. Default `AUTO_POSE_DESCRIPTOR`. */\n  poseDescriptor?: PoseDescriptor<unknown>;\n  /** Whether drawn boxes include the stroke. Default `true`. */\n  boundsIncludeStroke?: boolean;\n  /** How a pose's origin, the point a grid or a guide snaps, is read.\n   *  Default `AUTO_ORIGIN_PROJECTION`: a rect's `{x, y}`, a path's bounds. */\n  originProjection?: OriginProjection<unknown>;\n  /** Points of each node a move snaps, in its own box frame, as\n   *  `SceneCanvasSnap.anchors`. */\n  anchors?: SnapAnchors;\n  /** How `view`'s world maps into the parallax plane the gesture's points\n   *  are in. Default: they are in `view`'s own world. */\n  plane?: PlaneMap | null;\n}\n\n/**\n * One gesture's snapping over a scene, for a host without `<SceneCanvas>`:\n * the session a canvas's `snap` dep begins, built from the same probes and\n * drawn boxes. Call `at` with each world point the gesture reaches, and\n * `end` when it lets go.\n */\nexport function createSnapSession2d(opts: SnapSession2dOptions): SnapSession {\n  const view = opts.view;\n  const req: SnapBegin = {\n    gesture: opts.gesture,\n    press: opts.press,\n    ...(opts.ids ? { ids: opts.ids } : {}),\n    ...(opts.parent !== undefined ? { parent: opts.parent } : {}),\n    ...(opts.origin ? { origin: opts.origin } : {}),\n    ...(opts.constrain ? { constrain: opts.constrain } : {}),\n    ...(opts.handle ? { handle: opts.handle } : {}),\n    ...(opts.pivot ? { pivot: opts.pivot } : {}),\n    ...(opts.theta0 !== undefined ? { theta0: opts.theta0 } : {}),\n    ...(opts.reachRad !== undefined ? { reachRad: opts.reachRad } : {}),\n    ...(opts.box ? { box: opts.box } : {}),\n    ...(opts.also ? { also: opts.also } : {}),\n    ...(opts.plane ? { plane: () => opts.plane ?? null } : {}),\n  };\n  return sceneSession2d({\n    req,\n    scene: opts.scene,\n    boxes: drawnBoxes({\n      scene: opts.scene,\n      view: { get: () => view, set: () => {} },\n      ...(opts.poseDescriptor ? { poseDescriptor: opts.poseDescriptor } : {}),\n      ...(opts.boundsIncludeStroke !== undefined ? { boundsIncludeStroke: opts.boundsIncludeStroke } : {}),\n    }),\n    sources: opts.sources,\n    view: () => view,\n    reachPx: opts.reachPx ?? DEFAULT_SNAP_PX,\n    store: opts.store ?? createSnapOutcomeStore(),\n    ...(opts.originProjection ? { originProjection: opts.originProjection } : {}),\n    ...(opts.poseDescriptor ? { poseDescriptor: opts.poseDescriptor } : {}),\n    ...(opts.anchors ? { anchors: opts.anchors } : {}),\n  });\n}\n"],"mappings":";;;;;;;;AAuCA,SAAgB,eAAe,GAAoC;CACjE,MAAM,QAAQ,gBAAgB;EAC5B,OAAO,EAAE;EAAO,OAAO,EAAE;EACzB,GAAI,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,IAAI,CAAC;EACnD,GAAI,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,IAAI,CAAC;EACrE,GAAI,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,IAAI,CAAC;CAC5C,CAAC;CACD,MAAM,UAAU,UAAU,EAAE,KAAK,KAAK;CACtC,OAAO,gBAAgB;EACrB,KAAK,EAAE;EACP,SAAS,EAAE;EACX,QAAQ,YAAY,EAAE,KAAK,OAAO,OAAO;EACzC,KAAK,QAAQ;EACb,QAAQ,QAAQ;EAChB,WAAW,OAAO;GAChB,MAAM,OAAO,MAAM,KAAK,EAAE;GAC1B,OAAO,SAAS,SAAY,SAAY,MAAM,SAAS,IAAI,IAAI;EACjE;EACA,GAAI,EAAE,IAAI,MAAM,EAAE,SAAS,aAAa,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,IAAI,CAAC;EACjE,MAAM,EAAE;EACR,SAAS,EAAE;EACX,OAAO,EAAE;EACT,YAAY,eAAe,EAAE,OAAO,EAAE,cAAc;EACpD,SAAS,gBAAgB,EAAE,KAAK;EAChC,OAAO,EAAE;EACT,GAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;CACtC,CAAC;AACH;;;;;;;AAsDA,SAAgB,oBAAoB,MAAyC;CAC3E,MAAM,OAAO,KAAK;CAgBlB,OAAO,eAAe;EACpB;GAfA,SAAS,KAAK;GACd,OAAO,KAAK;GACZ,GAAI,KAAK,MAAM,EAAE,KAAK,KAAK,IAAI,IAAI,CAAC;GACpC,GAAI,KAAK,WAAW,SAAY,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;GAC3D,GAAI,KAAK,SAAS,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;GAC7C,GAAI,KAAK,YAAY,EAAE,WAAW,KAAK,UAAU,IAAI,CAAC;GACtD,GAAI,KAAK,SAAS,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;GAC7C,GAAI,KAAK,QAAQ,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;GAC1C,GAAI,KAAK,WAAW,SAAY,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;GAC3D,GAAI,KAAK,aAAa,SAAY,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC;GACjE,GAAI,KAAK,MAAM,EAAE,KAAK,KAAK,IAAI,IAAI,CAAC;GACpC,GAAI,KAAK,OAAO,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC;GACvC,GAAI,KAAK,QAAQ,EAAE,aAAa,KAAK,SAAS,KAAK,IAAI,CAAC;EAGxD;EACA,OAAO,KAAK;EACZ,OAAO,WAAW;GAChB,OAAO,KAAK;GACZ,MAAM;IAAE,WAAW;IAAM,WAAW,CAAC;GAAE;GACvC,GAAI,KAAK,iBAAiB,EAAE,gBAAgB,KAAK,eAAe,IAAI,CAAC;GACrE,GAAI,KAAK,wBAAwB,SAAY,EAAE,qBAAqB,KAAK,oBAAoB,IAAI,CAAC;EACpG,CAAC;EACD,SAAS,KAAK;EACd,YAAY;EACZ,SAAS,KAAK,WAAW;EACzB,OAAO,KAAK,SAAS,uBAAuB;EAC5C,GAAI,KAAK,mBAAmB,EAAE,kBAAkB,KAAK,iBAAiB,IAAI,CAAC;EAC3E,GAAI,KAAK,iBAAiB,EAAE,gBAAgB,KAAK,eAAe,IAAI,CAAC;EACrE,GAAI,KAAK,UAAU,EAAE,SAAS,KAAK,QAAQ,IAAI,CAAC;CAClD,CAAC;AACH"}

package/dist/domains/snap/screen.js

@@ -1,8 +1,8 @@
 import { viewToTransform } from "../../core/viewport/view.js";
-import { fromPlane } from "../../core/viewport/parallax.js";
 import { worldToScreen } from "../../core/viewport/viewTransform.js";
+import { fromPlane } from "../../core/viewport/parallax.js";
 
-//#region src/domains/snap/screen.ts
+// src/domains/snap/screen.ts
 /** A point in the gesture's plane to screen px. */
 function screenOf(view, plane) {
 	const t = view ? viewToTransform(view) : null;
@@ -18,6 +18,5 @@ function screenOf(view, plane) {
 	};
 }
 
-//#endregion
 export { screenOf };
 //# sourceMappingURL=screen.js.map

package/dist/domains/snap/session2d.js

@@ -1,14 +1,14 @@
-import { resizeSides, resizeSubject, resizedBox } from "./resizeBox.js";
-import { markFromPlane } from "./marks.js";
-import { screenOf } from "./screen.js";
 import { angleAt } from "./angle2d.js";
 import { inputFlat } from "./inputSubspace.js";
 import { gatherSnapCandidates, resolvedSnapMarks, snapSourcesFor } from "./gather.js";
 import { recordSnapCandidates } from "./debugCandidates.js";
+import { markFromPlane } from "./marks.js";
 import { createSnapOutcomeStore } from "./outcomeStore.js";
+import { resizeSides, resizeSubject, resizedBox } from "./resizeBox.js";
+import { screenOf } from "./screen.js";
 import { closestOnFlat, resolveSnap } from "@weasel-js/geom/nd";
 
-//#region src/domains/snap/session2d.ts
+// src/domains/snap/session2d.ts
 /** The canvas's reach when neither a source nor the kit settings name one. */
 var DEFAULT_SNAP_PX = 8;
 /** A snap session over a 2D canvas: ctx points are world points. */
@@ -146,6 +146,5 @@ function inputSession(req) {
 	});
 }
 
-//#endregion
 export { DEFAULT_SNAP_PX, createSession2d, inputSession };
 //# sourceMappingURL=session2d.js.map

package/dist/domains/snap/spanSnap.js

@@ -1,6 +1,6 @@
 import { inputSession } from "./session2d.js";
 
-//#region src/domains/snap/spanSnap.ts
+// src/domains/snap/spanSnap.ts
 /**
 * A `point` session for each end of a span. The end's session has the
 * snapped start as its `origin`, so a `constrain` step turns about the start
@@ -75,6 +75,5 @@ function spanSnap(dep, constrain = () => void 0, common = {}) {
 	};
 }
 
-//#endregion
 export { spanSnap };
 //# sourceMappingURL=spanSnap.js.map

package/dist/domains/snap/stepAngles.js

@@ -1,4 +1,4 @@
-//#region src/domains/snap/stepAngles.ts
+// src/domains/snap/stepAngles.ts
 /** The multiples of `step` either side of `theta`, and the nearest: the
 *  angles an angle step offers a direction at `theta`. Radians. */
 function stepAngles(theta, step) {
@@ -10,6 +10,5 @@ function stepAngles(theta, step) {
 	].map((i) => i * step);
 }
 
-//#endregion
 export { stepAngles };
 //# sourceMappingURL=stepAngles.js.map

package/dist/domains/text/editingDrawOne.js

@@ -1,6 +1,6 @@
 import { defaultDrawOne } from "../../canvas/defaultDrawOne.js";
 
-//#region src/domains/text/editingDrawOne.ts
+// src/domains/text/editingDrawOne.ts
 /** `base`, `defaultDrawOne` by default, less the text commands of the node `editingId` names. */
 function drawOneEditing(editingId, base = defaultDrawOne) {
 	return (node, pose, view, ctx) => {
@@ -27,6 +27,5 @@ function withoutText(cmds) {
 	return out;
 }
 
-//#endregion
 export { drawOneEditing };
 //# sourceMappingURL=editingDrawOne.js.map

package/dist/domains/text/hostTextEditors.js

@@ -1,4 +1,4 @@
-//#region src/domains/text/hostTextEditors.ts
+// src/domains/text/hostTextEditors.ts
 /**
 * The containers of every text editor a host mounted with `useSceneTextEdit`.
 * `<SceneCanvas>`'s own editor stands down for a canvas inside one, so a host
@@ -19,6 +19,5 @@ function hostTextEditorHolds(el) {
 	return false;
 }
 
-//#endregion
 export { hostTextEditorHolds, registerHostTextEditor };
 //# sourceMappingURL=hostTextEditors.js.map

package/dist/domains/text/index.js

@@ -1,7 +1,7 @@
 import { useSceneTextEdit } from "./useSceneTextEdit.js";
 import { createTextLayer } from "./textLayer.js";
-import { textCommand as textCommand$1, textCommandFromPose as textCommandFromPose$1, textCommandFromRuns as textCommandFromRuns$1 } from "@weasel-js/renderer";
+import { textCommand as textCommand$1, textCommandFromPose as textCommandFromPose$1, textCommandFromRuns as textCommandFromRuns$1, textCommandFromRunsInto } from "@weasel-js/renderer";
 import { TextOutlinesError as TextOutlinesError$1, loadTextOutlines as loadTextOutlines$1, textToPath as textToPath$1, textToPathsByPaint as textToPathsByPaint$1 } from "@weasel-js/text";
 import { TEXT_EDIT_FONT_HOLD, charOffsetToDomPosition, domPositionToCharOffset, domToRuns, runsToDom, useTextEdit as useTextEdit$1 } from "@weasel-js/text-dom";
 
-export { TEXT_EDIT_FONT_HOLD, TextOutlinesError$1 as TextOutlinesError, charOffsetToDomPosition, createTextLayer, domPositionToCharOffset, domToRuns, loadTextOutlines$1 as loadTextOutlines, runsToDom, textCommand$1 as textCommand, textCommandFromPose$1 as textCommandFromPose, textCommandFromRuns$1 as textCommandFromRuns, textToPath$1 as textToPath, textToPathsByPaint$1 as textToPathsByPaint, useSceneTextEdit, useTextEdit$1 as useTextEdit };
+export { TEXT_EDIT_FONT_HOLD, TextOutlinesError$1 as TextOutlinesError, charOffsetToDomPosition, createTextLayer, domPositionToCharOffset, domToRuns, loadTextOutlines$1 as loadTextOutlines, runsToDom, textCommand$1 as textCommand, textCommandFromPose$1 as textCommandFromPose, textCommandFromRuns$1 as textCommandFromRuns, textCommandFromRunsInto, textToPath$1 as textToPath, textToPathsByPaint$1 as textToPathsByPaint, useSceneTextEdit, useTextEdit$1 as useTextEdit };

package/dist/domains/text/sceneTextDrafts.js

@@ -1,6 +1,6 @@
 import { asNodeId } from "../../core/scene/types.js";
 
-//#region src/domains/text/sceneTextDrafts.ts
+// src/domains/text/sceneTextDrafts.ts
 /**
 * A text edit shown to the scene keystroke by keystroke, for the readers that
 * see a node somewhere besides the overlay: text something derives from, such
@@ -59,6 +59,5 @@ function sceneTextDrafts(sceneRef, optsRef) {
 	};
 }
 
-//#endregion
 export { editedData, sceneTextDrafts };
 //# sourceMappingURL=sceneTextDrafts.js.map

package/dist/domains/text/textHitAt.js

@@ -1,15 +1,15 @@
+import { sceneDerivedPathOf, scenePaintedPoseOf } from "../../canvas/derivedPath.js";
 import { derivedPartsOf } from "../../core/scene/derivedParts.js";
 import { nodesAsShown, shownLookup } from "../../core/scene/nodeAsShown.js";
-import { AUTO_POSE_DESCRIPTOR } from "../../core/geometry/autoPoseDescriptor.js";
+import { effectSourceFor } from "../pathEffects/effectSources.js";
 import { targetTransformOf, worldToLocal } from "../../core/geometry/targetFrame.js";
 import { textBoxOf } from "../../canvas/nodeShapes/textPainter.js";
-import { sceneDerivedPathOf, scenePaintedPoseOf } from "../../canvas/derivedPath.js";
+import { AUTO_POSE_DESCRIPTOR } from "../../core/geometry/autoPoseDescriptor.js";
 import { indexedCandidates } from "../../canvas/pickIndex/scenePickIndex.js";
-import { effectSourceFor } from "../pathEffects/effectSources.js";
 import { boundsOfPath, pathContainsPoint } from "@weasel-js/geom";
 import { caretIndexAt, pointInTextPose } from "@weasel-js/text";
 
-//#region src/domains/text/textHitAt.ts
+// src/domains/text/textHitAt.ts
 /**
 * The top-most unlocked text node at world `(cx, cy)`, and the caret there.
 *
@@ -93,6 +93,5 @@ function onAGlyph(path, x, y) {
 	});
 }
 
-//#endregion
 export { textHitAt };
 //# sourceMappingURL=textHitAt.js.map

package/dist/domains/text/textLayer.js

@@ -2,7 +2,18 @@ import { clippedToBox } from "../../canvas/nodeShapes/textPainter.js";
 import { textCommandFromPose } from "@weasel-js/renderer";
 import { runsToPlainText } from "@weasel-js/text";
 
-//#region src/domains/text/textLayer.ts
+// src/domains/text/textLayer.ts
+/**
+* Text RenderLayer for text that is not in a scene: one `textCommandFromPose`
+* command per item, the same command the `kit:text` node painter emits, so an
+* item lays out — and wraps, or doesn't, per its style — as a node would.
+*
+* The GL renderer uses MSDF text. The resolved style's `fontFamily` must
+* be registered via `registerFont(family, variant, metricsUrl, atlasUrl)`
+* from the renderer module *before* the GL backend dispatches this layer.
+* Unregistered families render with a warning and no glyphs (see
+* `TextDrawCommand`'s contract).
+*/
 /** Build a `RenderLayer` that emits one `TextDrawCommand` per text node. */
 function createTextLayer(opts) {
 	const { id = "text", label = "Text", getTexts, getPose, isHidden, clipToBounds = false } = opts;
@@ -24,6 +35,5 @@ function createTextLayer(opts) {
 	};
 }
 
-//#endregion
 export { createTextLayer };
 //# sourceMappingURL=textLayer.js.map

package/dist/domains/text/textLayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"textLayer.js","names":[],"sources":["../../../src/domains/text/textLayer.ts"],"sourcesContent":["/**\n * Text RenderLayer for text that is not in a scene: one `textCommandFromPose`\n * command per item, the same command the `kit:text` node painter emits, so an\n * item lays out — and wraps, or doesn't, per its style — as a node would.\n *\n * The GL renderer uses MSDF text. The resolved style's `fontFamily` must\n * be registered via `registerFont(family, variant, metricsUrl, atlasUrl)`\n * from the renderer module *before* the GL backend dispatches this layer.\n * Unregistered families render with a warning and no glyphs (see\n * `TextDrawCommand`'s contract).\n */\n\nimport { type DrawCommand } from '@weasel-js/renderer';\nimport type { TextPose } from '@weasel-js/text';\n\nimport type { RenderLayer } from 'core/layers/render';\nimport { textCommandFromPose } from '@weasel-js/renderer';\nimport { runsToPlainText } from '@weasel-js/text';\nimport { clippedToBox } from '../../canvas/nodeShapes/textPainter';\n\n\n/** Options for `createTextLayer`. */\nexport interface CreateTextLayerOpts<T> {\n  id?: string;\n  label?: string;\n  getTexts: () => readonly T[];\n  getPose: (node: T) => TextPose;\n  /** Optional per-node hide hook (e.g., suppress while editing). */\n  isHidden?: (node: T) => boolean;\n  /** When `true`, each text command is wrapped in a clipped group so any\n   *  overflow beyond the pose's `(width × height)` is hidden. Default\n   *  `false` (legacy: text can spill outside the declared bounds). Opt-in\n   *  so existing consumers who rely on overflow keep working. */\n  clipToBounds?: boolean;\n}\n\n/** Build a `RenderLayer` that emits one `TextDrawCommand` per text node. */\nexport function createTextLayer<T>(opts: CreateTextLayerOpts<T>): RenderLayer<unknown> {\n  const { id = 'text', label = 'Text', getTexts, getPose, isHidden, clipToBounds = false } = opts;\n  return {\n    id,\n    label,\n    draw: (_data, view) => {\n      // A world-space layer, so a `{ px }` size in a pose's style resolves\n      // against the live camera. Radial in effect — one factor for both axes.\n      const scale = (view.scale.x + view.scale.y) / 2;\n      const children: DrawCommand[] = [];\n      for (const node of getTexts()) {\n        if (isHidden?.(node)) continue;\n        const pose = getPose(node);\n        if (pose.runs && pose.runs.length > 0 && runsToPlainText(pose.runs) !== pose.text) {\n          throw new Error(\n            `weasel createTextLayer: TextPose invariant violated — ` +\n            `runsToPlainText(runs) !== text. Either omit \\`runs\\` or keep it ` +\n            `synchronized with \\`text\\`.`,\n          );\n        }\n        const textCmd = textCommandFromPose(pose, scale);\n        children.push(clipToBounds ? clippedToBox(textCmd, pose) : textCmd);\n      }\n      // World-space commands; drawLayers wraps in viewToMat3 automatically.\n      return children;\n    },\n  };\n}\n"],"mappings":";;;;;;AAqCA,SAAgB,gBAAmB,MAAoD;CACrF,MAAM,EAAE,KAAK,QAAQ,QAAQ,QAAQ,UAAU,SAAS,UAAU,eAAe,UAAU;CAC3F,OAAO;EACL;EACA;EACA,OAAO,OAAO,SAAS;GAGrB,MAAM,SAAS,KAAK,MAAM,IAAI,KAAK,MAAM,KAAK;GAC9C,MAAM,WAA0B,CAAC;GACjC,KAAK,MAAM,QAAQ,SAAS,GAAG;IAC7B,IAAI,WAAW,IAAI,GAAG;IACtB,MAAM,OAAO,QAAQ,IAAI;IACzB,IAAI,KAAK,QAAQ,KAAK,KAAK,SAAS,KAAK,gBAAgB,KAAK,IAAI,MAAM,KAAK,MAC3E,MAAM,IAAI,MACR,+IAGF;IAEF,MAAM,UAAU,oBAAoB,MAAM,KAAK;IAC/C,SAAS,KAAK,eAAe,aAAa,SAAS,IAAI,IAAI,OAAO;GACpE;GAEA,OAAO;EACT;CACF;AACF"}
+{"version":3,"file":"textLayer.js","names":[],"sources":["../../../src/domains/text/textLayer.ts"],"sourcesContent":["/**\n * Text RenderLayer for text that is not in a scene: one `textCommandFromPose`\n * command per item, the same command the `kit:text` node painter emits, so an\n * item lays out — and wraps, or doesn't, per its style — as a node would.\n *\n * The GL renderer uses MSDF text. The resolved style's `fontFamily` must\n * be registered via `registerFont(family, variant, metricsUrl, atlasUrl)`\n * from the renderer module *before* the GL backend dispatches this layer.\n * Unregistered families render with a warning and no glyphs (see\n * `TextDrawCommand`'s contract).\n */\n\nimport { type DrawCommand } from '@weasel-js/renderer';\nimport type { TextPose } from '@weasel-js/text';\n\nimport type { RenderLayer } from 'core/layers/render';\nimport { textCommandFromPose } from '@weasel-js/renderer';\nimport { runsToPlainText } from '@weasel-js/text';\nimport { clippedToBox } from '../../canvas/nodeShapes/textPainter';\n\n\n/** Options for `createTextLayer`. */\nexport interface CreateTextLayerOpts<T> {\n  id?: string;\n  label?: string;\n  getTexts: () => readonly T[];\n  getPose: (node: T) => TextPose;\n  /** Optional per-node hide hook (e.g., suppress while editing). */\n  isHidden?: (node: T) => boolean;\n  /** When `true`, each text command is wrapped in a clipped group so any\n   *  overflow beyond the pose's `(width × height)` is hidden. Default\n   *  `false` (legacy: text can spill outside the declared bounds). Opt-in\n   *  so existing consumers who rely on overflow keep working. */\n  clipToBounds?: boolean;\n}\n\n/** Build a `RenderLayer` that emits one `TextDrawCommand` per text node. */\nexport function createTextLayer<T>(opts: CreateTextLayerOpts<T>): RenderLayer<unknown> {\n  const { id = 'text', label = 'Text', getTexts, getPose, isHidden, clipToBounds = false } = opts;\n  return {\n    id,\n    label,\n    draw: (_data, view) => {\n      // A world-space layer, so a `{ px }` size in a pose's style resolves\n      // against the live camera. Radial in effect — one factor for both axes.\n      const scale = (view.scale.x + view.scale.y) / 2;\n      const children: DrawCommand[] = [];\n      for (const node of getTexts()) {\n        if (isHidden?.(node)) continue;\n        const pose = getPose(node);\n        if (pose.runs && pose.runs.length > 0 && runsToPlainText(pose.runs) !== pose.text) {\n          throw new Error(\n            `weasel createTextLayer: TextPose invariant violated — ` +\n            `runsToPlainText(runs) !== text. Either omit \\`runs\\` or keep it ` +\n            `synchronized with \\`text\\`.`,\n          );\n        }\n        const textCmd = textCommandFromPose(pose, scale);\n        children.push(clipToBounds ? clippedToBox(textCmd, pose) : textCmd);\n      }\n      // World-space commands; drawLayers wraps in viewToMat3 automatically.\n      return children;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAqCA,SAAgB,gBAAmB,MAAoD;CACrF,MAAM,EAAE,KAAK,QAAQ,QAAQ,QAAQ,UAAU,SAAS,UAAU,eAAe,UAAU;CAC3F,OAAO;EACL;EACA;EACA,OAAO,OAAO,SAAS;GAGrB,MAAM,SAAS,KAAK,MAAM,IAAI,KAAK,MAAM,KAAK;GAC9C,MAAM,WAA0B,CAAC;GACjC,KAAK,MAAM,QAAQ,SAAS,GAAG;IAC7B,IAAI,WAAW,IAAI,GAAG;IACtB,MAAM,OAAO,QAAQ,IAAI;IACzB,IAAI,KAAK,QAAQ,KAAK,KAAK,SAAS,KAAK,gBAAgB,KAAK,IAAI,MAAM,KAAK,MAC3E,MAAM,IAAI,MACR,+IAGF;IAEF,MAAM,UAAU,oBAAoB,MAAM,KAAK;IAC/C,SAAS,KAAK,eAAe,aAAa,SAAS,IAAI,IAAI,OAAO;GACpE;GAEA,OAAO;EACT;CACF;AACF"}

package/dist/domains/text/useSceneTextEdit.js

@@ -1,12 +1,12 @@
-import { inheritedPaintIn, withInheritedPaint } from "../../core/scene/inheritedPaint.js";
-import { textBoxOf } from "../../canvas/nodeShapes/textPainter.js";
 import { asNodeId } from "../../core/scene/types.js";
 import { scenePaintedPoseOf } from "../../canvas/derivedPath.js";
-import { findMountedCanvas } from "../../canvas/mountedCanvases.js";
 import { drawOneEditing } from "./editingDrawOne.js";
 import { textHitAt } from "./textHitAt.js";
 import { registerHostTextEditor } from "./hostTextEditors.js";
 import { editedData, sceneTextDrafts } from "./sceneTextDrafts.js";
+import { inheritedPaintIn, withInheritedPaint } from "../../core/scene/inheritedPaint.js";
+import { findMountedCanvas } from "../../canvas/mountedCanvases.js";
+import { textBoxOf } from "../../canvas/nodeShapes/textPainter.js";
 import { poseFrameOf } from "@weasel-js/geom";
 import { useCallback, useEffect, useMemo, useRef } from "react";
 import { useLatest } from "@weasel-js/react";
@@ -15,7 +15,7 @@ import { resolveScreenLength } from "@weasel-js/paint";
 import { isTextData } from "@weasel-js/text";
 import { useTextEdit } from "@weasel-js/text-dom";
 
-//#region src/domains/text/useSceneTextEdit.ts
+// src/domains/text/useSceneTextEdit.ts
 /**
 * `useSceneTextEdit` — scene-aware wrapper around `useTextEdit`: scene
 * lookups for text / style / runs / screen-pose, and
@@ -232,6 +232,5 @@ function shownTextPaint(scene, node) {
 	};
 }
 
-//#endregion
 export { useSceneTextEdit, useSceneTextEditor };
 //# sourceMappingURL=useSceneTextEdit.js.map

package/dist/domains/viewports/aim.js

@@ -1,8 +1,8 @@
-import { ZOOM_FLOOR } from "../../core/viewport/zoomBounds.js";
-import { normalizeView } from "../../core/viewport/view.js";
 import { fitViewToBounds } from "../../core/viewport/fitViewToBounds.js";
+import { normalizeView } from "../../core/viewport/view.js";
+import { ZOOM_FLOOR } from "../../core/viewport/zoomBounds.js";
 
-//#region src/domains/viewports/aim.ts
+// src/domains/viewports/aim.ts
 /** The aim of view `viewId` (`null`: a surface's root) showing world rect `rect`. */
 function rectAim(viewId, rect) {
 	return {
@@ -100,6 +100,5 @@ function viewForAim(rect, size, fit) {
 	}));
 }
 
-//#endregion
 export { aimSpace2d, isRectAim, rectAim, viewForAim };
 //# sourceMappingURL=aim.js.map

package/dist/domains/viewports/viewMarker.js

@@ -1,7 +1,7 @@
 import { aimSpace2d } from "./aim.js";
 import { pointInPolygon, pointSegmentDist2, polygonFromPoints } from "@weasel-js/geom";
 
-//#region src/domains/viewports/viewMarker.ts
+// src/domains/viewports/viewMarker.ts
 /** The marker style a {@link ViewMarkerProps.style} fills in from: the minimap indicator's. */
 var VIEW_MARKER_DEFAULT_STYLE = {
 	stroke: "#ffffff",
@@ -95,6 +95,5 @@ function outlineHolds(outline, p, slop, interior) {
 	return false;
 }
 
-//#endregion
 export { VIEW_MARKER_DEFAULT_STYLE, VIEW_MARKER_HIT_SLOP_PX, createViewMarkerLayer, grabViewMarker, markerSourceAim };
 //# sourceMappingURL=viewMarker.js.map