@weasel-js/core 1.15.0 → 1.15.2

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

@@ -1 +1 @@
-{"version":3,"file":"outcomeStore.js","names":[],"sources":["../../../src/domains/snap/outcomeStore.ts"],"sourcesContent":["import type { SnapMark } from './types';\nimport type { Point } from '@weasel-js/geom';\n\n/** The marks of the snap in flight, for the readout to draw. */\nexport interface SnapOutcomeStore<P = Point> {\n  get(): readonly SnapMark<P>[];\n  set(marks: readonly SnapMark<P>[]): void;\n  subscribe(listener: () => void): () => void;\n}\n\nconst NONE: readonly never[] = [];\n\n/** An empty outcome store, which notifies only when the marks change. */\nexport function createSnapOutcomeStore<P = Point>(): SnapOutcomeStore<P> {\n  let marks: readonly SnapMark<P>[] = NONE;\n  const listeners = new Set<() => void>();\n  return {\n    get: () => marks,\n    set(next) {\n      if (next.length === 0 && marks.length === 0) return;\n      marks = next.length === 0 ? NONE : next;\n      for (const l of [...listeners]) l();\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => { listeners.delete(listener); };\n    },\n  };\n}\n"],"mappings":";AAUA,IAAM,OAAyB,CAAC;;AAGhC,SAAgB,yBAAyD;CACvE,IAAI,QAAgC;CACpC,MAAM,4BAAY,IAAI,IAAgB;CACtC,OAAO;EACL,WAAW;EACX,IAAI,MAAM;GACR,IAAI,KAAK,WAAW,KAAK,MAAM,WAAW,GAAG;GAC7C,QAAQ,KAAK,WAAW,IAAI,OAAO;GACnC,KAAK,MAAM,KAAK,CAAC,GAAG,SAAS,GAAG,EAAE;EACpC;EACA,UAAU,UAAU;GAClB,UAAU,IAAI,QAAQ;GACtB,aAAa;IAAE,UAAU,OAAO,QAAQ;GAAG;EAC7C;CACF;AACF"}
+{"version":3,"file":"outcomeStore.js","names":[],"sources":["../../../src/domains/snap/outcomeStore.ts"],"sourcesContent":["import type { SnapMark } from './types';\nimport type { Point } from '@weasel-js/geom';\nimport { createEmitter } from '@weasel-js/registry';\n\n/** The marks of the snap in flight, for the readout to draw. */\nexport interface SnapOutcomeStore<P = Point> {\n  get(): readonly SnapMark<P>[];\n  set(marks: readonly SnapMark<P>[]): void;\n  subscribe(listener: () => void): () => void;\n}\n\nconst NONE: readonly never[] = [];\n\n/** An empty outcome store, which notifies only when the marks change. */\nexport function createSnapOutcomeStore<P = Point>(): SnapOutcomeStore<P> {\n  let marks: readonly SnapMark<P>[] = NONE;\n  const changed = createEmitter();\n  return {\n    get: () => marks,\n    set(next) {\n      if (next.length === 0 && marks.length === 0) return;\n      marks = next.length === 0 ? NONE : next;\n      changed.emit();\n    },\n    subscribe: changed.subscribe,\n  };\n}\n"],"mappings":";;;AAWA,IAAM,OAAyB,CAAC;;AAGhC,SAAgB,yBAAyD;CACvE,IAAI,QAAgC;CACpC,MAAM,UAAU,cAAc;CAC9B,OAAO;EACL,WAAW;EACX,IAAI,MAAM;GACR,IAAI,KAAK,WAAW,KAAK,MAAM,WAAW,GAAG;GAC7C,QAAQ,KAAK,WAAW,IAAI,OAAO;GACnC,QAAQ,KAAK;EACf;EACA,WAAW,QAAQ;CACrB;AACF"}

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 = [];
@@ -99,6 +99,5 @@ function moveProbes(press, ids, reads, box) {
 	return out;
 }
 
-//#endregion
 export { buildProbes, subjectBox, subjectOf };
 //# sourceMappingURL=probes2d.js.map

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,9 +1,9 @@
-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) {
@@ -71,6 +71,5 @@ function withSubtrees(scene, ids) {
 	return [...out];
 }
 
-//#endregion
 export { sceneProbeReads, sceneRotations, sceneSnapFrames, withSubtrees };
 //# sourceMappingURL=sceneReads.js.map

package/dist/domains/snap/sceneSession2d.js

@@ -1,10 +1,10 @@
 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({
@@ -79,6 +79,5 @@ function createSnapSession2d(opts) {
 	});
 }
 
-//#endregion
 export { createSnapSession2d, sceneSession2d };
 //# sourceMappingURL=sceneSession2d.js.map

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/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,13 +1,13 @@
-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 { poseFrameOf } from "@weasel-js/geom";
+import { inheritedPaintIn, withInheritedPaint } from "../../core/scene/inheritedPaint.js";
+import { findMountedCanvas } from "../../canvas/mountedCanvases.js";
+import { textBoxOf } from "../../canvas/nodeShapes/textPainter.js";
+import { poseFrameOf, viewScreenToWorld } from "@weasel-js/geom";
 import { useCallback, useEffect, useMemo, useRef } from "react";
 import { useLatest } from "@weasel-js/react";
 import { clientToCanvas } from "@weasel-js/routing";
@@ -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
@@ -132,9 +132,14 @@ function useSceneTextEditor(scene, container, options = {}) {
 		const [canvasX, canvasY] = clientToCanvas(canvas, e.clientX, e.clientY);
 		const root = containerRef.current;
 		const view = resolveView(optsRef.current.view) ?? (root ? findMountedCanvas(root, canvas)?.getView() : void 0);
-		const cx = view ? canvasX / view.scale.x + view.x : canvasX;
-		const cy = view ? canvasY / view.scale.y + view.y : canvasY;
-		const hit = textHitAt(sceneRef.current, read, cx, cy);
+		const at = view ? viewScreenToWorld(view, {
+			x: canvasX,
+			y: canvasY
+		}) : {
+			x: canvasX,
+			y: canvasY
+		};
+		const hit = textHitAt(sceneRef.current, read, at.x, at.y);
 		if (!hit) return;
 		openedOnRef.current = canvas;
 		edit.startEdit(hit.id, { caret: hit.caret });
@@ -232,6 +237,5 @@ function shownTextPaint(scene, node) {
 	};
 }
 
-//#endregion
 export { useSceneTextEdit, useSceneTextEditor };
 //# sourceMappingURL=useSceneTextEdit.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useSceneTextEdit.js","names":[],"sources":["../../../src/domains/text/useSceneTextEdit.ts"],"sourcesContent":["/**\n * `useSceneTextEdit` — scene-aware wrapper around `useTextEdit`: scene\n * lookups for text / style / runs / screen-pose, and\n * `scene.update(id, { data })` for commits. The overlay and a double-click\n * both read the pose a node is painted at, so text inside a container whose\n * pose is a frame is edited where it is drawn.\n *\n * Defaults assume the node's `data` carries `text` / `style` / `runs`\n * directly. For custom data shapes, override any of the optional projections.\n * Consumers with non-rect poses should drop down to raw `useTextEdit` and\n * supply their own `getScreenPose`.\n */\nimport { useCallback, useEffect, useMemo, useRef } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { asNodeId } from '../../core/scene/types';\nimport { scenePaintedPoseOf } from '../../canvas/derivedPath';\nimport type { Scene } from '../../core/scene/types';\nimport { drawOneEditing, type EditingDrawOne } from './editingDrawOne';\nimport { textHitAt } from './textHitAt';\nimport { registerHostTextEditor } from './hostTextEditors';\nimport { editedData, sceneTextDrafts } from './sceneTextDrafts';\nimport type { Stroke, Fill, Inherit } from '@weasel-js/paint';\nimport { resolveScreenLength } from '@weasel-js/paint';\nimport { inheritedPaintIn } from '../../canvas/inheritedPaints';\nimport { withInheritedPaint } from '../../core/scene/inheritedPaint';\nimport { clientToCanvas } from '@weasel-js/routing';\nimport { findMountedCanvas, type MountedCanvas } from '../../canvas/mountedCanvases';\nimport type { View } from '../../core/viewport/view';\nimport type { RectPose } from 'core/geometry/unionBounds';\nimport { poseFrameOf } from '@weasel-js/geom';\nimport { isTextData, type StyledRun, type TextPaint, type TextStyle, type TextVerticalAlign } from '@weasel-js/text';\nimport { textBoxOf, type TextOverflow } from '../../canvas/nodeShapes/textPainter';\nimport { useTextEdit, type TextEditClipRect, type TextEditScreenPose, type UseTextEditReturn } from '@weasel-js/text-dom';\n\n/** Shape the default projections expect `data` to satisfy. All fields\n *  optional so any object satisfies the constraint — projections fill in\n *  the gaps for non-default shapes. */\nexport interface DefaultTextData {\n  text?: string;\n  style?: TextStyle;\n  runs?: readonly StyledRun[];\n  fill?: Fill | Inherit | null;\n  stroke?: Stroke | Inherit | null;\n  verticalAlign?: TextVerticalAlign;\n  padding?: number;\n  overflow?: TextOverflow;\n}\n\n/** All-optional projections + fontSize fallback. */\nexport interface UseSceneTextEditOptions<TData> {\n  /**\n   * Is this node text? A double-click opens an edit only on a node that\n   * answers yes, and passes through any other to the text under it. Default:\n   * `isTextData`, the test `inferredNodeRouting` classifies a text node by. Pass one when `getText` reads some other shape.\n   */\n  isText?: (data: TData) => boolean;\n  /** Read plain text from `data`. Default: `data.text ?? ''`. */\n  getText?: (data: TData) => string;\n  /** Read style from `data`. Default: `data.style`. */\n  getStyle?: (data: TData) => TextStyle | undefined;\n  /** Read the node's paint from `data`. Default: `data.fill` / `data.stroke`. */\n  getPaint?: (data: TData) => TextPaint | undefined;\n  /** Read rich-text runs from `data`. Default: `data.runs`. */\n  getRuns?: (data: TData) => readonly StyledRun[] | undefined;\n  /** Read the box vertical alignment from `data`. Default: `data.verticalAlign`. */\n  getVerticalAlign?: (data: TData) => TextVerticalAlign | undefined;\n  /** Read the inset from the node's box to its text from `data`. Default: `data.padding`. */\n  getPadding?: (data: TData) => number | undefined;\n  /** Read whether the node cuts its text at its box from `data`, which the\n   *  overlay then does too. Default: `data.overflow`. */\n  getOverflow?: (data: TData) => TextOverflow | undefined;\n  /** Produce updated data with new text. Default: `{ ...data, text }`. */\n  setText?: (data: TData, text: string) => TData;\n  /** Produce updated data with new runs. Default: `{ ...data, runs }`. */\n  setRuns?: (data: TData, runs: StyledRun[]) => TData;\n  /**\n   * Produce updated data with a new node-wide style. Default:\n   * `{ ...data, style }`. Written only when a range toggle has to *clear* a\n   * flag the node itself sets — the run algebra is additive, so that edit\n   * lowers the node flag and raises it on the runs outside the range. See\n   * `useTextEdit`'s `setStyle`.\n   *\n   * An edit's text, runs, and style are folded through these three and\n   * written as one `scene.update`, so a commit is one undo step.\n   */\n  setStyle?: (data: TData, style: TextStyle) => TData;\n  /** Fallback fontSize when `style.fontSize` is unset. Default `16`. */\n  defaultFontSize?: number;\n  /**\n   * The view to project through. Omit it and the view is read live from the\n   * weasel canvas mounted inside `container` (the one a double-click landed\n   * on, when there are several). With no canvas there, the node's world box\n   * is passed through as screen pixels.\n   *\n   * A thunk is re-read on every projection; a plain `View` is the value from\n   * the render that supplied it.\n   */\n  view?: View | (() => View);\n  /**\n   * Forwarded to `useTextEdit`: is `el` part of the editor's own chrome?\n   * Focus moving into it does not end the edit. Wire it to whatever renders\n   * the character controls.\n   */\n  isEditorChrome?: (el: Element) => boolean;\n  /** Forwarded to `useTextEdit`: what Escape does to the edit. */\n  escape?: 'cancel' | 'commit';\n  /** Forwarded to `useTextEdit`: how long an edit waits for its face. */\n  fontHold?: number;\n  /** Forwarded to `useTextEdit`: called as an edit of the node `id` opens,\n   *  whichever way it was started. */\n  onStart?: (id: string) => void;\n  /** Forwarded to `useTextEdit`: called as the edit of `id` closes, after\n   *  any commit has been written to the scene. */\n  onEnd?: (id: string) => void;\n}\n\nfunction resolveView(view: View | (() => View) | undefined): View | undefined {\n  return typeof view === 'function' ? view() : view;\n}\n\n/** What `onDoubleClick` reads of the event: a React or a DOM `MouseEvent`. */\nexport type TextEditDoubleClick = Pick<MouseEvent, 'target' | 'clientX' | 'clientY'>;\n\n/** Return shape extends `UseTextEditReturn` with an `onDoubleClick`\n *  binding for the canvas container. Double-clicking inside a text\n *  node enters edit mode with the caret seeded at the clicked glyph. */\nexport interface UseSceneTextEditReturn extends UseTextEditReturn {\n  /** Bind to the element wrapping `<SceneCanvas>` (the same element\n   *  passed as `container`, or any ancestor that receives the dblclick\n   *  bubble). Starts an edit on the top-most text node under the cursor. */\n  onDoubleClick: (e: TextEditDoubleClick) => void;\n  /** The `isText` option asked of the node with this id: what\n   *  `TextEditDep.isTextNode` wants, so both ways into an edit agree. */\n  isTextNode: (id: string) => boolean;\n  /**\n   * `defaultDrawOne`, less the glyphs of the node being edited: the overlay\n   * stands in for its text, and the rest of the node, a `background` among\n   * it, goes on painting. Pass it as `layers.scene.drawOne`, with\n   * `paintBounds: defaultPaintBounds`, in place of an `alphaFor` that hides\n   * the whole node.\n   */\n  drawOne: EditingDrawOne;\n}\n\n/** How each field is read from a node's `data`: the option's projection, else the default shape. */\nfunction projectionsOf<TData extends DefaultTextData>(opts: { readonly current: UseSceneTextEditOptions<TData> }) {\n  return {\n    isText: (data: TData): boolean =>\n      opts.current.isText ? opts.current.isText(data) : isTextData(data),\n    text: (data: TData): string =>\n      opts.current.getText ? opts.current.getText(data) : (data.text ?? ''),\n    style: (data: TData): TextStyle | undefined =>\n      opts.current.getStyle ? opts.current.getStyle(data) : data.style,\n    runs: (data: TData): readonly StyledRun[] | undefined =>\n      opts.current.getRuns ? opts.current.getRuns(data) : data.runs,\n    verticalAlign: (data: TData): TextVerticalAlign | undefined =>\n      opts.current.getVerticalAlign ? opts.current.getVerticalAlign(data) : data.verticalAlign,\n    padding: (data: TData): number | undefined =>\n      opts.current.getPadding ? opts.current.getPadding(data) : data.padding,\n    overflow: (data: TData): TextOverflow | undefined =>\n      opts.current.getOverflow ? opts.current.getOverflow(data) : data.overflow,\n  };\n}\n\n/** Wire double-click-to-edit text on a scene: mounts a DOM editing overlay\n *  over the node being edited and writes the result back as an undoable op.\n *  `<SceneCanvas>`'s own editor stands down for any canvas inside `container`. */\nexport function useSceneTextEdit<\n  TData extends DefaultTextData,\n  TLayer extends string,\n  TPose extends RectPose = RectPose,\n>(\n  scene: Scene<TData, TLayer, TPose>,\n  container: HTMLElement | null,\n  options: UseSceneTextEditOptions<TData> = {},\n): UseSceneTextEditReturn {\n  useEffect(() => (container ? registerHostTextEditor(container) : undefined), [container]);\n  return useSceneTextEditor(scene, container, options);\n}\n\n/** `useSceneTextEdit` without announcing itself as a host's editor: what\n *  `<SceneCanvas>` mounts as its own. */\nexport function useSceneTextEditor<\n  TData extends DefaultTextData,\n  TLayer extends string,\n  TPose extends RectPose = RectPose,\n>(\n  scene: Scene<TData, TLayer, TPose>,\n  container: HTMLElement | null,\n  options: UseSceneTextEditOptions<TData> = {},\n): UseSceneTextEditReturn {\n  // Refs, so the useTextEdit callbacks always see the current values\n  // without re-binding.\n  const sceneRef = useLatest(scene);\n  const optsRef = useLatest(options);\n  const containerRef = useLatest(container);\n  // The last double-click's target, so the overlay projects through the\n  // canvas the edit was opened on.\n  const openedOnRef = useRef<EventTarget | null>(null);\n  const drafts = useMemo(() => sceneTextDrafts(sceneRef, optsRef), [sceneRef, optsRef]);\n  useEffect(() => () => drafts.close(), [drafts]);\n\n  // The canvas's box in container pixels is both the origin its view projects\n  // from and the region its glyphs are clipped to.\n  const surface = (): { canvas: MountedCanvas; box: TextEditClipRect } | null => {\n    const root = containerRef.current;\n    const canvas = root ? findMountedCanvas(root, openedOnRef.current) : null;\n    if (!root || !canvas) return null;\n    const a = canvas.element.getBoundingClientRect();\n    const b = root.getBoundingClientRect();\n    return {\n      canvas,\n      box: {\n        x: a.left - b.left - root.clientLeft + root.scrollLeft,\n        y: a.top - b.top - root.clientTop + root.scrollTop,\n        width: a.width,\n        height: a.height,\n      },\n    };\n  };\n\n  const read = useMemo(() => projectionsOf(optsRef), [optsRef]);\n\n  const edit = useTextEdit({\n    container,\n    isEditorChrome: (el) => optsRef.current.isEditorChrome?.(el) ?? false,\n    escape: options.escape,\n    fontHold: options.fontHold,\n    onStart: (id) => optsRef.current.onStart?.(id),\n    onEnd: (id) => {\n      drafts.end(id);\n      optsRef.current.onEnd?.(id);\n    },\n    onDraft: drafts.draft,\n    getText: (id) => {\n      const node = sceneRef.current.get(asNodeId(id));\n      return node ? read.text(node.data) : '';\n    },\n    getStyle: (id) => {\n      const node = sceneRef.current.get(asNodeId(id));\n      return node ? read.style(node.data) : undefined;\n    },\n    getPaint: (id) => {\n      const node = sceneRef.current.get(asNodeId(id));\n      if (!node) return undefined;\n      const get = optsRef.current.getPaint;\n      return get ? get(node.data) : shownTextPaint(sceneRef.current, node);\n    },\n    getScreenPose: (id) => {\n      const scene = sceneRef.current;\n      const node = scene.get(asNodeId(id));\n      if (!node) return null;\n      const at = surface();\n      const view = resolveView(optsRef.current.view) ?? at?.canvas.getView();\n      return screenPoseOf(node.data, scenePaintedPoseOf(scene)(node), read, view, at?.box, optsRef.current.defaultFontSize);\n    },\n    getClipRect: () => surface()?.box ?? null,\n    getRuns: (id) => {\n      const node = sceneRef.current.get(asNodeId(id));\n      return node ? read.runs(node.data) : undefined;\n    },\n    commit: (id, { text, runs, style }) => {\n      const nid = asNodeId(id);\n      const node = sceneRef.current.get(nid);\n      if (!node) return;\n      drafts.commit(id, editedData(node.data, { text, runs, style }, optsRef.current));\n    },\n  });\n\n  const onDoubleClick = useCallback((e: TextEditDoubleClick) => {\n    // The dblclick bubbles from the canvas up to any wrapping container; the\n    // element it started on is what the click coordinates are relative to.\n    const canvas = e.target instanceof HTMLElement ? e.target : null;\n    if (!canvas) return;\n    // Inside the editor a double-click selects a word, and its target is a run\n    // span whose box the click would be measured against as if it were a canvas.\n    if (canvas.closest('[contenteditable=\"true\"]')) return;\n\n    // The click is un-projected here; `textHitAt` takes it back through the\n    // frame the node is drawn in.\n    const [canvasX, canvasY] = clientToCanvas(canvas, e.clientX, e.clientY);\n    const root = containerRef.current;\n    const view = resolveView(optsRef.current.view)\n      ?? (root ? findMountedCanvas(root, canvas)?.getView() : undefined);\n    const cx = view ? canvasX / view.scale.x + view.x : canvasX;\n    const cy = view ? canvasY / view.scale.y + view.y : canvasY;\n    const hit = textHitAt(sceneRef.current, read, cx, cy);\n    if (!hit) return;\n    openedOnRef.current = canvas;\n    edit.startEdit(hit.id, { caret: hit.caret });\n  }, [edit, containerRef, optsRef, read, sceneRef]);\n\n  const isTextNode = useCallback((id: string): boolean => {\n    const node = sceneRef.current.get(asNodeId(id));\n    return node !== undefined && read.isText(node.data);\n  }, [read, sceneRef]);\n\n  const drawOne = useMemo(() => drawOneEditing(edit.editingId), [edit.editingId]);\n  return { ...edit, onDoubleClick, isTextNode, drawOne };\n}\n\n/** The overlay's pose for a node painted at `painted`: its text box, inset\n *  about the box center, which is all the overlay's frame needs, projected\n *  through `view`. */\nfunction screenPoseOf<TData extends DefaultTextData>(\n  d: TData,\n  painted: RectPose,\n  read: ReturnType<typeof projectionsOf<TData>>,\n  view: View | undefined,\n  origin: TextEditClipRect | undefined,\n  defaultFontSize = 16,\n): TextEditScreenPose {\n  const inset = textBoxOf({ padding: read.padding(d) }, painted);\n  const box = screenBoxOf({ ...painted, ...inset }, view, origin);\n  return {\n    ...box,\n    // Against `zoom`, the same factor the overlay scales back up by, so a\n    // `{ px }` size arrives on screen at the pixel count it names.\n    fontSize: resolveScreenLength(read.style(d)?.fontSize ?? defaultFontSize, box.zoom),\n    verticalAlign: read.verticalAlign(d),\n    ...(read.overflow(d) === 'clip' ? { clip: clipToBox(inset, painted) } : {}),\n  };\n}\n\n/** How far `box` reaches past `inner` on each side: the overlay's cut at\n *  `box` when its own pose is `inner`. */\nfunction clipToBox(inner: RectPose, box: RectPose): NonNullable<TextEditScreenPose['clip']> {\n  return {\n    top: inner.y - box.y,\n    left: inner.x - box.x,\n    bottom: box.y + box.height - (inner.y + inner.height),\n    right: box.x + box.width - (inner.x + inner.width),\n  };\n}\n\n/**\n * `pose`'s box as the overlay takes it, `origin` being the canvas's corner in\n * container pixels. Only the box center is projected, since the overlay's\n * frame is about it. Width and height stay in world units and reach the\n * screen through the overlay's own `scale(zoom)` — see\n * `TextEditScreenPose.zoom`.\n */\nfunction screenBoxOf(\n  pose: RectPose,\n  view: View | undefined,\n  origin: { x: number; y: number } | undefined,\n): Pick<TextEditScreenPose, 'x' | 'y' | 'width' | 'height' | 'frame'> & { zoom: number } {\n  const zoom = view ? view.scale.x : 1;\n  const zoomY = view ? view.scale.y : 1;\n  const cx = (origin?.x ?? 0) + (pose.x + pose.width / 2 - (view?.x ?? 0)) * zoom;\n  const cy = (origin?.y ?? 0) + (pose.y + pose.height / 2 - (view?.y ?? 0)) * zoomY;\n  return {\n    x: cx - (pose.width * zoom) / 2,\n    y: cy - (pose.height * zoom) / 2,\n    width: pose.width,\n    height: pose.height,\n    zoom,\n    frame: frameLinearOf(pose, zoomY / zoom),\n  };\n}\n\n/** The linear part of the frame `pose` is drawn in, as the overlay takes it.\n *  `stretch` is the view's y scale over its x scale: the overlay scales both\n *  axes by the x scale, so the frame carries what is left of y. */\nfunction frameLinearOf(pose: unknown, stretch: number): TextEditScreenPose['frame'] {\n  const m = poseFrameOf(pose);\n  if (!m && stretch === 1) return undefined;\n  const [a, b, c, d] = m ?? [1, 0, 0, 1];\n  return [a, b * stretch, c, d * stretch];\n}\n\n/** A text node's paint as the canvas paints it: an inherited one is its container's. */\nfunction shownTextPaint<TData extends DefaultTextData>(\n  scene: Scene<TData, string, unknown>,\n  node: NonNullable<ReturnType<Scene<TData, string, unknown>['get']>>,\n): TextPaint {\n  const { fill, stroke } = withInheritedPaint(node.data, inheritedPaintIn(scene, node));\n  return { fill, stroke };\n}\n"],"mappings":"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"}
+{"version":3,"file":"useSceneTextEdit.js","names":[],"sources":["../../../src/domains/text/useSceneTextEdit.ts"],"sourcesContent":["/**\n * `useSceneTextEdit` — scene-aware wrapper around `useTextEdit`: scene\n * lookups for text / style / runs / screen-pose, and\n * `scene.update(id, { data })` for commits. The overlay and a double-click\n * both read the pose a node is painted at, so text inside a container whose\n * pose is a frame is edited where it is drawn.\n *\n * Defaults assume the node's `data` carries `text` / `style` / `runs`\n * directly. For custom data shapes, override any of the optional projections.\n * Consumers with non-rect poses should drop down to raw `useTextEdit` and\n * supply their own `getScreenPose`.\n */\nimport { useCallback, useEffect, useMemo, useRef } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { asNodeId } from '../../core/scene/types';\nimport { scenePaintedPoseOf } from '../../canvas/derivedPath';\nimport type { Scene } from '../../core/scene/types';\nimport { drawOneEditing, type EditingDrawOne } from './editingDrawOne';\nimport { textHitAt } from './textHitAt';\nimport { registerHostTextEditor } from './hostTextEditors';\nimport { editedData, sceneTextDrafts } from './sceneTextDrafts';\nimport type { Stroke, Fill, Inherit } from '@weasel-js/paint';\nimport { resolveScreenLength } from '@weasel-js/paint';\nimport { inheritedPaintIn } from '../../canvas/inheritedPaints';\nimport { withInheritedPaint } from '../../core/scene/inheritedPaint';\nimport { clientToCanvas } from '@weasel-js/routing';\nimport { findMountedCanvas, type MountedCanvas } from '../../canvas/mountedCanvases';\nimport type { View } from '../../core/viewport/view';\nimport type { RectPose } from 'core/geometry/unionBounds';\nimport { poseFrameOf, viewScreenToWorld } from '@weasel-js/geom';\nimport { isTextData, type StyledRun, type TextPaint, type TextStyle, type TextVerticalAlign } from '@weasel-js/text';\nimport { textBoxOf, type TextOverflow } from '../../canvas/nodeShapes/textPainter';\nimport { useTextEdit, type TextEditClipRect, type TextEditScreenPose, type UseTextEditReturn } from '@weasel-js/text-dom';\n\n/** Shape the default projections expect `data` to satisfy. All fields\n *  optional so any object satisfies the constraint — projections fill in\n *  the gaps for non-default shapes. */\nexport interface DefaultTextData {\n  text?: string;\n  style?: TextStyle;\n  runs?: readonly StyledRun[];\n  fill?: Fill | Inherit | null;\n  stroke?: Stroke | Inherit | null;\n  verticalAlign?: TextVerticalAlign;\n  padding?: number;\n  overflow?: TextOverflow;\n}\n\n/** All-optional projections + fontSize fallback. */\nexport interface UseSceneTextEditOptions<TData> {\n  /**\n   * Is this node text? A double-click opens an edit only on a node that\n   * answers yes, and passes through any other to the text under it. Default:\n   * `isTextData`, the test `inferredNodeRouting` classifies a text node by. Pass one when `getText` reads some other shape.\n   */\n  isText?: (data: TData) => boolean;\n  /** Read plain text from `data`. Default: `data.text ?? ''`. */\n  getText?: (data: TData) => string;\n  /** Read style from `data`. Default: `data.style`. */\n  getStyle?: (data: TData) => TextStyle | undefined;\n  /** Read the node's paint from `data`. Default: `data.fill` / `data.stroke`. */\n  getPaint?: (data: TData) => TextPaint | undefined;\n  /** Read rich-text runs from `data`. Default: `data.runs`. */\n  getRuns?: (data: TData) => readonly StyledRun[] | undefined;\n  /** Read the box vertical alignment from `data`. Default: `data.verticalAlign`. */\n  getVerticalAlign?: (data: TData) => TextVerticalAlign | undefined;\n  /** Read the inset from the node's box to its text from `data`. Default: `data.padding`. */\n  getPadding?: (data: TData) => number | undefined;\n  /** Read whether the node cuts its text at its box from `data`, which the\n   *  overlay then does too. Default: `data.overflow`. */\n  getOverflow?: (data: TData) => TextOverflow | undefined;\n  /** Produce updated data with new text. Default: `{ ...data, text }`. */\n  setText?: (data: TData, text: string) => TData;\n  /** Produce updated data with new runs. Default: `{ ...data, runs }`. */\n  setRuns?: (data: TData, runs: StyledRun[]) => TData;\n  /**\n   * Produce updated data with a new node-wide style. Default:\n   * `{ ...data, style }`. Written only when a range toggle has to *clear* a\n   * flag the node itself sets — the run algebra is additive, so that edit\n   * lowers the node flag and raises it on the runs outside the range. See\n   * `useTextEdit`'s `setStyle`.\n   *\n   * An edit's text, runs, and style are folded through these three and\n   * written as one `scene.update`, so a commit is one undo step.\n   */\n  setStyle?: (data: TData, style: TextStyle) => TData;\n  /** Fallback fontSize when `style.fontSize` is unset. Default `16`. */\n  defaultFontSize?: number;\n  /**\n   * The view to project through. Omit it and the view is read live from the\n   * weasel canvas mounted inside `container` (the one a double-click landed\n   * on, when there are several). With no canvas there, the node's world box\n   * is passed through as screen pixels.\n   *\n   * A thunk is re-read on every projection; a plain `View` is the value from\n   * the render that supplied it.\n   */\n  view?: View | (() => View);\n  /**\n   * Forwarded to `useTextEdit`: is `el` part of the editor's own chrome?\n   * Focus moving into it does not end the edit. Wire it to whatever renders\n   * the character controls.\n   */\n  isEditorChrome?: (el: Element) => boolean;\n  /** Forwarded to `useTextEdit`: what Escape does to the edit. */\n  escape?: 'cancel' | 'commit';\n  /** Forwarded to `useTextEdit`: how long an edit waits for its face. */\n  fontHold?: number;\n  /** Forwarded to `useTextEdit`: called as an edit of the node `id` opens,\n   *  whichever way it was started. */\n  onStart?: (id: string) => void;\n  /** Forwarded to `useTextEdit`: called as the edit of `id` closes, after\n   *  any commit has been written to the scene. */\n  onEnd?: (id: string) => void;\n}\n\nfunction resolveView(view: View | (() => View) | undefined): View | undefined {\n  return typeof view === 'function' ? view() : view;\n}\n\n/** What `onDoubleClick` reads of the event: a React or a DOM `MouseEvent`. */\nexport type TextEditDoubleClick = Pick<MouseEvent, 'target' | 'clientX' | 'clientY'>;\n\n/** Return shape extends `UseTextEditReturn` with an `onDoubleClick`\n *  binding for the canvas container. Double-clicking inside a text\n *  node enters edit mode with the caret seeded at the clicked glyph. */\nexport interface UseSceneTextEditReturn extends UseTextEditReturn {\n  /** Bind to the element wrapping `<SceneCanvas>` (the same element\n   *  passed as `container`, or any ancestor that receives the dblclick\n   *  bubble). Starts an edit on the top-most text node under the cursor. */\n  onDoubleClick: (e: TextEditDoubleClick) => void;\n  /** The `isText` option asked of the node with this id: what\n   *  `TextEditDep.isTextNode` wants, so both ways into an edit agree. */\n  isTextNode: (id: string) => boolean;\n  /**\n   * `defaultDrawOne`, less the glyphs of the node being edited: the overlay\n   * stands in for its text, and the rest of the node, a `background` among\n   * it, goes on painting. Pass it as `layers.scene.drawOne`, with\n   * `paintBounds: defaultPaintBounds`, in place of an `alphaFor` that hides\n   * the whole node.\n   */\n  drawOne: EditingDrawOne;\n}\n\n/** How each field is read from a node's `data`: the option's projection, else the default shape. */\nfunction projectionsOf<TData extends DefaultTextData>(opts: { readonly current: UseSceneTextEditOptions<TData> }) {\n  return {\n    isText: (data: TData): boolean =>\n      opts.current.isText ? opts.current.isText(data) : isTextData(data),\n    text: (data: TData): string =>\n      opts.current.getText ? opts.current.getText(data) : (data.text ?? ''),\n    style: (data: TData): TextStyle | undefined =>\n      opts.current.getStyle ? opts.current.getStyle(data) : data.style,\n    runs: (data: TData): readonly StyledRun[] | undefined =>\n      opts.current.getRuns ? opts.current.getRuns(data) : data.runs,\n    verticalAlign: (data: TData): TextVerticalAlign | undefined =>\n      opts.current.getVerticalAlign ? opts.current.getVerticalAlign(data) : data.verticalAlign,\n    padding: (data: TData): number | undefined =>\n      opts.current.getPadding ? opts.current.getPadding(data) : data.padding,\n    overflow: (data: TData): TextOverflow | undefined =>\n      opts.current.getOverflow ? opts.current.getOverflow(data) : data.overflow,\n  };\n}\n\n/** Wire double-click-to-edit text on a scene: mounts a DOM editing overlay\n *  over the node being edited and writes the result back as an undoable op.\n *  `<SceneCanvas>`'s own editor stands down for any canvas inside `container`. */\nexport function useSceneTextEdit<\n  TData extends DefaultTextData,\n  TLayer extends string,\n  TPose extends RectPose = RectPose,\n>(\n  scene: Scene<TData, TLayer, TPose>,\n  container: HTMLElement | null,\n  options: UseSceneTextEditOptions<TData> = {},\n): UseSceneTextEditReturn {\n  useEffect(() => (container ? registerHostTextEditor(container) : undefined), [container]);\n  return useSceneTextEditor(scene, container, options);\n}\n\n/** `useSceneTextEdit` without announcing itself as a host's editor: what\n *  `<SceneCanvas>` mounts as its own. */\nexport function useSceneTextEditor<\n  TData extends DefaultTextData,\n  TLayer extends string,\n  TPose extends RectPose = RectPose,\n>(\n  scene: Scene<TData, TLayer, TPose>,\n  container: HTMLElement | null,\n  options: UseSceneTextEditOptions<TData> = {},\n): UseSceneTextEditReturn {\n  // Refs, so the useTextEdit callbacks always see the current values\n  // without re-binding.\n  const sceneRef = useLatest(scene);\n  const optsRef = useLatest(options);\n  const containerRef = useLatest(container);\n  // The last double-click's target, so the overlay projects through the\n  // canvas the edit was opened on.\n  const openedOnRef = useRef<EventTarget | null>(null);\n  const drafts = useMemo(() => sceneTextDrafts(sceneRef, optsRef), [sceneRef, optsRef]);\n  useEffect(() => () => drafts.close(), [drafts]);\n\n  // The canvas's box in container pixels is both the origin its view projects\n  // from and the region its glyphs are clipped to.\n  const surface = (): { canvas: MountedCanvas; box: TextEditClipRect } | null => {\n    const root = containerRef.current;\n    const canvas = root ? findMountedCanvas(root, openedOnRef.current) : null;\n    if (!root || !canvas) return null;\n    const a = canvas.element.getBoundingClientRect();\n    const b = root.getBoundingClientRect();\n    return {\n      canvas,\n      box: {\n        x: a.left - b.left - root.clientLeft + root.scrollLeft,\n        y: a.top - b.top - root.clientTop + root.scrollTop,\n        width: a.width,\n        height: a.height,\n      },\n    };\n  };\n\n  const read = useMemo(() => projectionsOf(optsRef), [optsRef]);\n\n  const edit = useTextEdit({\n    container,\n    isEditorChrome: (el) => optsRef.current.isEditorChrome?.(el) ?? false,\n    escape: options.escape,\n    fontHold: options.fontHold,\n    onStart: (id) => optsRef.current.onStart?.(id),\n    onEnd: (id) => {\n      drafts.end(id);\n      optsRef.current.onEnd?.(id);\n    },\n    onDraft: drafts.draft,\n    getText: (id) => {\n      const node = sceneRef.current.get(asNodeId(id));\n      return node ? read.text(node.data) : '';\n    },\n    getStyle: (id) => {\n      const node = sceneRef.current.get(asNodeId(id));\n      return node ? read.style(node.data) : undefined;\n    },\n    getPaint: (id) => {\n      const node = sceneRef.current.get(asNodeId(id));\n      if (!node) return undefined;\n      const get = optsRef.current.getPaint;\n      return get ? get(node.data) : shownTextPaint(sceneRef.current, node);\n    },\n    getScreenPose: (id) => {\n      const scene = sceneRef.current;\n      const node = scene.get(asNodeId(id));\n      if (!node) return null;\n      const at = surface();\n      const view = resolveView(optsRef.current.view) ?? at?.canvas.getView();\n      return screenPoseOf(node.data, scenePaintedPoseOf(scene)(node), read, view, at?.box, optsRef.current.defaultFontSize);\n    },\n    getClipRect: () => surface()?.box ?? null,\n    getRuns: (id) => {\n      const node = sceneRef.current.get(asNodeId(id));\n      return node ? read.runs(node.data) : undefined;\n    },\n    commit: (id, { text, runs, style }) => {\n      const nid = asNodeId(id);\n      const node = sceneRef.current.get(nid);\n      if (!node) return;\n      drafts.commit(id, editedData(node.data, { text, runs, style }, optsRef.current));\n    },\n  });\n\n  const onDoubleClick = useCallback((e: TextEditDoubleClick) => {\n    // The dblclick bubbles from the canvas up to any wrapping container; the\n    // element it started on is what the click coordinates are relative to.\n    const canvas = e.target instanceof HTMLElement ? e.target : null;\n    if (!canvas) return;\n    // Inside the editor a double-click selects a word, and its target is a run\n    // span whose box the click would be measured against as if it were a canvas.\n    if (canvas.closest('[contenteditable=\"true\"]')) return;\n\n    // The click is un-projected here; `textHitAt` takes it back through the\n    // frame the node is drawn in.\n    const [canvasX, canvasY] = clientToCanvas(canvas, e.clientX, e.clientY);\n    const root = containerRef.current;\n    const view = resolveView(optsRef.current.view)\n      ?? (root ? findMountedCanvas(root, canvas)?.getView() : undefined);\n    const at = view ? viewScreenToWorld(view, { x: canvasX, y: canvasY }) : { x: canvasX, y: canvasY };\n    const hit = textHitAt(sceneRef.current, read, at.x, at.y);\n    if (!hit) return;\n    openedOnRef.current = canvas;\n    edit.startEdit(hit.id, { caret: hit.caret });\n  }, [edit, containerRef, optsRef, read, sceneRef]);\n\n  const isTextNode = useCallback((id: string): boolean => {\n    const node = sceneRef.current.get(asNodeId(id));\n    return node !== undefined && read.isText(node.data);\n  }, [read, sceneRef]);\n\n  const drawOne = useMemo(() => drawOneEditing(edit.editingId), [edit.editingId]);\n  return { ...edit, onDoubleClick, isTextNode, drawOne };\n}\n\n/** The overlay's pose for a node painted at `painted`: its text box, inset\n *  about the box center, which is all the overlay's frame needs, projected\n *  through `view`. */\nfunction screenPoseOf<TData extends DefaultTextData>(\n  d: TData,\n  painted: RectPose,\n  read: ReturnType<typeof projectionsOf<TData>>,\n  view: View | undefined,\n  origin: TextEditClipRect | undefined,\n  defaultFontSize = 16,\n): TextEditScreenPose {\n  const inset = textBoxOf({ padding: read.padding(d) }, painted);\n  const box = screenBoxOf({ ...painted, ...inset }, view, origin);\n  return {\n    ...box,\n    // Against `zoom`, the same factor the overlay scales back up by, so a\n    // `{ px }` size arrives on screen at the pixel count it names.\n    fontSize: resolveScreenLength(read.style(d)?.fontSize ?? defaultFontSize, box.zoom),\n    verticalAlign: read.verticalAlign(d),\n    ...(read.overflow(d) === 'clip' ? { clip: clipToBox(inset, painted) } : {}),\n  };\n}\n\n/** How far `box` reaches past `inner` on each side: the overlay's cut at\n *  `box` when its own pose is `inner`. */\nfunction clipToBox(inner: RectPose, box: RectPose): NonNullable<TextEditScreenPose['clip']> {\n  return {\n    top: inner.y - box.y,\n    left: inner.x - box.x,\n    bottom: box.y + box.height - (inner.y + inner.height),\n    right: box.x + box.width - (inner.x + inner.width),\n  };\n}\n\n/**\n * `pose`'s box as the overlay takes it, `origin` being the canvas's corner in\n * container pixels. Only the box center is projected, since the overlay's\n * frame is about it. Width and height stay in world units and reach the\n * screen through the overlay's own `scale(zoom)` — see\n * `TextEditScreenPose.zoom`.\n */\nfunction screenBoxOf(\n  pose: RectPose,\n  view: View | undefined,\n  origin: { x: number; y: number } | undefined,\n): Pick<TextEditScreenPose, 'x' | 'y' | 'width' | 'height' | 'frame'> & { zoom: number } {\n  const zoom = view ? view.scale.x : 1;\n  const zoomY = view ? view.scale.y : 1;\n  const cx = (origin?.x ?? 0) + (pose.x + pose.width / 2 - (view?.x ?? 0)) * zoom;\n  const cy = (origin?.y ?? 0) + (pose.y + pose.height / 2 - (view?.y ?? 0)) * zoomY;\n  return {\n    x: cx - (pose.width * zoom) / 2,\n    y: cy - (pose.height * zoom) / 2,\n    width: pose.width,\n    height: pose.height,\n    zoom,\n    frame: frameLinearOf(pose, zoomY / zoom),\n  };\n}\n\n/** The linear part of the frame `pose` is drawn in, as the overlay takes it.\n *  `stretch` is the view's y scale over its x scale: the overlay scales both\n *  axes by the x scale, so the frame carries what is left of y. */\nfunction frameLinearOf(pose: unknown, stretch: number): TextEditScreenPose['frame'] {\n  const m = poseFrameOf(pose);\n  if (!m && stretch === 1) return undefined;\n  const [a, b, c, d] = m ?? [1, 0, 0, 1];\n  return [a, b * stretch, c, d * stretch];\n}\n\n/** A text node's paint as the canvas paints it: an inherited one is its container's. */\nfunction shownTextPaint<TData extends DefaultTextData>(\n  scene: Scene<TData, string, unknown>,\n  node: NonNullable<ReturnType<Scene<TData, string, unknown>['get']>>,\n): TextPaint {\n  const { fill, stroke } = withInheritedPaint(node.data, inheritedPaintIn(scene, node));\n  return { fill, stroke };\n}\n"],"mappings":"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"}

package/dist/domains/viewports/aim.js

@@ -1,8 +1,9 @@
-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";
+import { viewScreenToWorld, viewWorldToScreen } from "@weasel-js/geom";
 
-//#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 {
@@ -61,14 +62,8 @@ function aimSpace2d(viewId, view, size) {
 			width: size.width,
 			height: size.height
 		},
-		project: (p) => ({
-			x: (p.x - view.x) * view.scale.x,
-			y: (p.y - view.y) * view.scale.y
-		}),
-		unproject: (px) => ({
-			x: px.x / view.scale.x + view.x,
-			y: px.y / view.scale.y + view.y
-		})
+		project: (p) => viewWorldToScreen(view, p),
+		unproject: (px) => viewScreenToWorld(view, px)
 	};
 }
 var UNUSED_CURRENT = {
@@ -100,6 +95,5 @@ function viewForAim(rect, size, fit) {
 	}));
 }
 
-//#endregion
 export { aimSpace2d, isRectAim, rectAim, viewForAim };
 //# sourceMappingURL=aim.js.map

package/dist/domains/viewports/aim.js.map

@@ -1 +1 @@
-{"version":3,"file":"aim.js","names":[],"sources":["../../../src/domains/viewports/aim.ts"],"sourcesContent":["import { fitViewToBounds, type Bounds } from 'core/viewport/fitViewToBounds';\nimport type { Dims } from 'core/layers/render';\nimport { normalizeView, type View } from 'core/viewport/view';\nimport { ZOOM_FLOOR } from 'core/viewport/zoomBounds';\n\n/** A point in a view's world. A 2D world is the plane z = 0, so `z` is absent there. */\nexport interface AimPoint {\n  x: number;\n  y: number;\n  z?: number;\n}\n\n/** A closed outline in a frame's CSS px, from the frame's top-left; at least 3 points. */\nexport type AimOutline = readonly { x: number; y: number }[];\n\n/** A target view, as an aim is drawn into it: its world, and its frame. */\nexport interface AimSpace {\n  /** The view whose frame this is; `null` for a surface's root view. */\n  readonly viewId: string | null;\n  /** `'2d'` for core's views; any other value is its owner's (kernel3d: `'3d'`). */\n  readonly kind: string;\n  readonly size: { width: number; height: number };\n  /** World point to frame px; `null` where the point does not draw (behind a 3D camera). */\n  project(p: AimPoint): { x: number; y: number } | null;\n  /** Frame px to the world point under it; `null` where there is none (a 3D ray missing its plane). */\n  unproject(px: { x: number; y: number }): AimPoint | null;\n}\n\n/** What a viewport shows, read in the world of the view it names. */\nexport interface ViewAim<TExtent = unknown> {\n  readonly viewId: string | null;\n  /** Discriminates `extent`: `'rect'` for core's 2D views. */\n  readonly kind: string;\n  /** Where the aim lies in its world, in its owner's own terms. */\n  readonly extent: TExtent;\n  /** The aim's outline in `space`'s frame, or `null` when it cannot be drawn there. */\n  outlineIn(space: AimSpace): AimOutline | null;\n  /** This aim moved so the world point under frame px `from` in `space` ends up under `to`; `null` when either misses. */\n  pannedIn(space: AimSpace, from: { x: number; y: number }, to: { x: number; y: number }): ViewAim<TExtent> | null;\n}\n\n/** Core's 2D aim: a world rect a view shows. */\nexport type RectAim = ViewAim<Bounds> & { readonly kind: 'rect' };\n\n/** The aim of view `viewId` (`null`: a surface's root) showing world rect `rect`. */\nexport function rectAim(viewId: string | null, rect: Bounds): RectAim {\n  return {\n    viewId,\n    kind: 'rect',\n    extent: rect,\n    outlineIn(space) {\n      const { x, y, width, height } = rect;\n      const out: { x: number; y: number }[] = [];\n      for (const corner of [\n        { x, y },\n        { x: x + width, y },\n        { x: x + width, y: y + height },\n        { x, y: y + height },\n      ]) {\n        const p = space.project(corner);\n        if (!p) return null;\n        out.push(p);\n      }\n      return out;\n    },\n    pannedIn(space, from, to) {\n      const a = space.unproject(from);\n      const b = space.unproject(to);\n      if (!a || !b) return null;\n      return rectAim(viewId, { ...rect, x: rect.x + (b.x - a.x), y: rect.y + (b.y - a.y) });\n    },\n  };\n}\n\n/** Whether `aim` is core's 2D rect aim, so its `extent` is a world rect. */\nexport function isRectAim(aim: ViewAim): aim is RectAim {\n  return aim.kind === 'rect';\n}\n\n/** A 2D view's frame: `view` is its camera and `size` its frame; frame px are measured from the frame's top-left. */\nexport function aimSpace2d(viewId: string | null, view: View, size: Dims): AimSpace {\n  return {\n    viewId,\n    kind: '2d',\n    size: { width: size.width, height: size.height },\n    project: (p) => ({ x: (p.x - view.x) * view.scale.x, y: (p.y - view.y) * view.scale.y }),\n    unproject: (px) => ({ x: px.x / view.scale.x + view.x, y: px.y / view.scale.y + view.y }),\n  };\n}\n\nconst UNUSED_CURRENT: View = { x: 0, y: 0, scale: { x: 1, y: 1 } };\n\n/**\n * The camera that shows `rect` in a frame of `size`: `'exact'` per axis (the inverse of `viewportWorldRect`),\n * `'contain'` uniform and centered. Not clamped to a zoom range, and finite for an empty rect or frame. Normalized.\n */\nexport function viewForAim(rect: Bounds, size: Dims, fit: 'exact' | 'contain'): View {\n  if (!(rect.width > 0 && rect.height > 0 && size.width > 0 && size.height > 0)) {\n    return normalizeView({ x: rect.x, y: rect.y, scale: { x: ZOOM_FLOOR, y: ZOOM_FLOOR } });\n  }\n  return normalizeView(fitViewToBounds(rect, size, UNUSED_CURRENT, {\n    mode: fit === 'exact' ? 'stretch' : 'contain', padding: 0, minScale: 0, maxScale: Infinity,\n  }));\n}\n"],"mappings":";;;;;;AA6CA,SAAgB,QAAQ,QAAuB,MAAuB;CACpE,OAAO;EACL;EACA,MAAM;EACN,QAAQ;EACR,UAAU,OAAO;GACf,MAAM,EAAE,GAAG,GAAG,OAAO,WAAW;GAChC,MAAM,MAAkC,CAAC;GACzC,KAAK,MAAM,UAAU;IACnB;KAAE;KAAG;IAAE;IACP;KAAE,GAAG,IAAI;KAAO;IAAE;IAClB;KAAE,GAAG,IAAI;KAAO,GAAG,IAAI;IAAO;IAC9B;KAAE;KAAG,GAAG,IAAI;IAAO;GACrB,GAAG;IACD,MAAM,IAAI,MAAM,QAAQ,MAAM;IAC9B,IAAI,CAAC,GAAG,OAAO;IACf,IAAI,KAAK,CAAC;GACZ;GACA,OAAO;EACT;EACA,SAAS,OAAO,MAAM,IAAI;GACxB,MAAM,IAAI,MAAM,UAAU,IAAI;GAC9B,MAAM,IAAI,MAAM,UAAU,EAAE;GAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,OAAO;GACrB,OAAO,QAAQ,QAAQ;IAAE,GAAG;IAAM,GAAG,KAAK,KAAK,EAAE,IAAI,EAAE;IAAI,GAAG,KAAK,KAAK,EAAE,IAAI,EAAE;GAAG,CAAC;EACtF;CACF;AACF;;AAGA,SAAgB,UAAU,KAA8B;CACtD,OAAO,IAAI,SAAS;AACtB;;AAGA,SAAgB,WAAW,QAAuB,MAAY,MAAsB;CAClF,OAAO;EACL;EACA,MAAM;EACN,MAAM;GAAE,OAAO,KAAK;GAAO,QAAQ,KAAK;EAAO;EAC/C,UAAU,OAAO;GAAE,IAAI,EAAE,IAAI,KAAK,KAAK,KAAK,MAAM;GAAG,IAAI,EAAE,IAAI,KAAK,KAAK,KAAK,MAAM;EAAE;EACtF,YAAY,QAAQ;GAAE,GAAG,GAAG,IAAI,KAAK,MAAM,IAAI,KAAK;GAAG,GAAG,GAAG,IAAI,KAAK,MAAM,IAAI,KAAK;EAAE;CACzF;AACF;AAEA,IAAM,iBAAuB;CAAE,GAAG;CAAG,GAAG;CAAG,OAAO;EAAE,GAAG;EAAG,GAAG;CAAE;AAAE;;;;;AAMjE,SAAgB,WAAW,MAAc,MAAY,KAAgC;CACnF,IAAI,EAAE,KAAK,QAAQ,KAAK,KAAK,SAAS,KAAK,KAAK,QAAQ,KAAK,KAAK,SAAS,IACzE,OAAO,cAAc;EAAE,GAAG,KAAK;EAAG,GAAG,KAAK;EAAG,OAAO;GAAE,GAAG;GAAY,GAAG;EAAW;CAAE,CAAC;CAExF,OAAO,cAAc,gBAAgB,MAAM,MAAM,gBAAgB;EAC/D,MAAM,QAAQ,UAAU,YAAY;EAAW,SAAS;EAAG,UAAU;EAAG,UAAU;CACpF,CAAC,CAAC;AACJ"}
+{"version":3,"file":"aim.js","names":[],"sources":["../../../src/domains/viewports/aim.ts"],"sourcesContent":["import { fitViewToBounds, type Bounds } from 'core/viewport/fitViewToBounds';\nimport type { Dims } from 'core/layers/render';\nimport { normalizeView, type View } from 'core/viewport/view';\nimport { ZOOM_FLOOR } from 'core/viewport/zoomBounds';\nimport { viewScreenToWorld, viewWorldToScreen } from '@weasel-js/geom';\n\n/** A point in a view's world. A 2D world is the plane z = 0, so `z` is absent there. */\nexport interface AimPoint {\n  x: number;\n  y: number;\n  z?: number;\n}\n\n/** A closed outline in a frame's CSS px, from the frame's top-left; at least 3 points. */\nexport type AimOutline = readonly { x: number; y: number }[];\n\n/** A target view, as an aim is drawn into it: its world, and its frame. */\nexport interface AimSpace {\n  /** The view whose frame this is; `null` for a surface's root view. */\n  readonly viewId: string | null;\n  /** `'2d'` for core's views; any other value is its owner's (kernel3d: `'3d'`). */\n  readonly kind: string;\n  readonly size: { width: number; height: number };\n  /** World point to frame px; `null` where the point does not draw (behind a 3D camera). */\n  project(p: AimPoint): { x: number; y: number } | null;\n  /** Frame px to the world point under it; `null` where there is none (a 3D ray missing its plane). */\n  unproject(px: { x: number; y: number }): AimPoint | null;\n}\n\n/** What a viewport shows, read in the world of the view it names. */\nexport interface ViewAim<TExtent = unknown> {\n  readonly viewId: string | null;\n  /** Discriminates `extent`: `'rect'` for core's 2D views. */\n  readonly kind: string;\n  /** Where the aim lies in its world, in its owner's own terms. */\n  readonly extent: TExtent;\n  /** The aim's outline in `space`'s frame, or `null` when it cannot be drawn there. */\n  outlineIn(space: AimSpace): AimOutline | null;\n  /** This aim moved so the world point under frame px `from` in `space` ends up under `to`; `null` when either misses. */\n  pannedIn(space: AimSpace, from: { x: number; y: number }, to: { x: number; y: number }): ViewAim<TExtent> | null;\n}\n\n/** Core's 2D aim: a world rect a view shows. */\nexport type RectAim = ViewAim<Bounds> & { readonly kind: 'rect' };\n\n/** The aim of view `viewId` (`null`: a surface's root) showing world rect `rect`. */\nexport function rectAim(viewId: string | null, rect: Bounds): RectAim {\n  return {\n    viewId,\n    kind: 'rect',\n    extent: rect,\n    outlineIn(space) {\n      const { x, y, width, height } = rect;\n      const out: { x: number; y: number }[] = [];\n      for (const corner of [\n        { x, y },\n        { x: x + width, y },\n        { x: x + width, y: y + height },\n        { x, y: y + height },\n      ]) {\n        const p = space.project(corner);\n        if (!p) return null;\n        out.push(p);\n      }\n      return out;\n    },\n    pannedIn(space, from, to) {\n      const a = space.unproject(from);\n      const b = space.unproject(to);\n      if (!a || !b) return null;\n      return rectAim(viewId, { ...rect, x: rect.x + (b.x - a.x), y: rect.y + (b.y - a.y) });\n    },\n  };\n}\n\n/** Whether `aim` is core's 2D rect aim, so its `extent` is a world rect. */\nexport function isRectAim(aim: ViewAim): aim is RectAim {\n  return aim.kind === 'rect';\n}\n\n/** A 2D view's frame: `view` is its camera and `size` its frame; frame px are measured from the frame's top-left. */\nexport function aimSpace2d(viewId: string | null, view: View, size: Dims): AimSpace {\n  return {\n    viewId,\n    kind: '2d',\n    size: { width: size.width, height: size.height },\n    project: (p) => viewWorldToScreen(view, p),\n    unproject: (px) => viewScreenToWorld(view, px),\n  };\n}\n\nconst UNUSED_CURRENT: View = { x: 0, y: 0, scale: { x: 1, y: 1 } };\n\n/**\n * The camera that shows `rect` in a frame of `size`: `'exact'` per axis (the inverse of `viewportWorldRect`),\n * `'contain'` uniform and centered. Not clamped to a zoom range, and finite for an empty rect or frame. Normalized.\n */\nexport function viewForAim(rect: Bounds, size: Dims, fit: 'exact' | 'contain'): View {\n  if (!(rect.width > 0 && rect.height > 0 && size.width > 0 && size.height > 0)) {\n    return normalizeView({ x: rect.x, y: rect.y, scale: { x: ZOOM_FLOOR, y: ZOOM_FLOOR } });\n  }\n  return normalizeView(fitViewToBounds(rect, size, UNUSED_CURRENT, {\n    mode: fit === 'exact' ? 'stretch' : 'contain', padding: 0, minScale: 0, maxScale: Infinity,\n  }));\n}\n"],"mappings":";;;;;;;AA8CA,SAAgB,QAAQ,QAAuB,MAAuB;CACpE,OAAO;EACL;EACA,MAAM;EACN,QAAQ;EACR,UAAU,OAAO;GACf,MAAM,EAAE,GAAG,GAAG,OAAO,WAAW;GAChC,MAAM,MAAkC,CAAC;GACzC,KAAK,MAAM,UAAU;IACnB;KAAE;KAAG;IAAE;IACP;KAAE,GAAG,IAAI;KAAO;IAAE;IAClB;KAAE,GAAG,IAAI;KAAO,GAAG,IAAI;IAAO;IAC9B;KAAE;KAAG,GAAG,IAAI;IAAO;GACrB,GAAG;IACD,MAAM,IAAI,MAAM,QAAQ,MAAM;IAC9B,IAAI,CAAC,GAAG,OAAO;IACf,IAAI,KAAK,CAAC;GACZ;GACA,OAAO;EACT;EACA,SAAS,OAAO,MAAM,IAAI;GACxB,MAAM,IAAI,MAAM,UAAU,IAAI;GAC9B,MAAM,IAAI,MAAM,UAAU,EAAE;GAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,OAAO;GACrB,OAAO,QAAQ,QAAQ;IAAE,GAAG;IAAM,GAAG,KAAK,KAAK,EAAE,IAAI,EAAE;IAAI,GAAG,KAAK,KAAK,EAAE,IAAI,EAAE;GAAG,CAAC;EACtF;CACF;AACF;;AAGA,SAAgB,UAAU,KAA8B;CACtD,OAAO,IAAI,SAAS;AACtB;;AAGA,SAAgB,WAAW,QAAuB,MAAY,MAAsB;CAClF,OAAO;EACL;EACA,MAAM;EACN,MAAM;GAAE,OAAO,KAAK;GAAO,QAAQ,KAAK;EAAO;EAC/C,UAAU,MAAM,kBAAkB,MAAM,CAAC;EACzC,YAAY,OAAO,kBAAkB,MAAM,EAAE;CAC/C;AACF;AAEA,IAAM,iBAAuB;CAAE,GAAG;CAAG,GAAG;CAAG,OAAO;EAAE,GAAG;EAAG,GAAG;CAAE;AAAE;;;;;AAMjE,SAAgB,WAAW,MAAc,MAAY,KAAgC;CACnF,IAAI,EAAE,KAAK,QAAQ,KAAK,KAAK,SAAS,KAAK,KAAK,QAAQ,KAAK,KAAK,SAAS,IACzE,OAAO,cAAc;EAAE,GAAG,KAAK;EAAG,GAAG,KAAK;EAAG,OAAO;GAAE,GAAG;GAAY,GAAG;EAAW;CAAE,CAAC;CAExF,OAAO,cAAc,gBAAgB,MAAM,MAAM,gBAAgB;EAC/D,MAAM,QAAQ,UAAU,YAAY;EAAW,SAAS;EAAG,UAAU;EAAG,UAAU;CACpF,CAAC,CAAC;AACJ"}

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