@weasel-js/core 1.10.0 → 1.11.0

package/dist/canvas/derivedPath.js.map

@@ -1 +1 @@
-{"version":3,"file":"derivedPath.js","names":["scenePaintedPoseOf","local","toPose","effectivePose","scene","node","composesFrames","chain","n","asNodeId","id","definesFrame","composeWorldPose","sceneDepLookup","slot","memoSlotFor","derivedDepOf","ctx","SlotDep","posed","resolveDerivedPath","showsComputedPath","sceneDerivedPathOf","depOf","childrenOf","derived","toPoseScopes","frame","composes","scopes","createNodeMemoScope","withDerivedPaths","derivedPathOf","drawOne","pose","view"],"sources":["../../src/canvas/derivedPath.ts"],"sourcesContent":["/**\n * The render walk's half of derived paths: resolving one against a scene, and\n * handing it to the painter.\n *\n * The resolver itself lives in `core/scene/derivedPath.ts`, beside\n * `derivedPose` — a *pose* can derive from a dependency's path, so\n * `effectivePose` has to be able to reach it.\n */\nimport type { DerivedDep, Node, NodeId, Scene } from 'core/scene/types';\nimport type { Path } from '@weasel-js/geom';\nimport { asNodeId } from 'core/scene/types';\nimport { definesFrame, derivedDepOf, effectivePose } from 'core/scene/effectivePose';\nimport { composesFrames, composeWorldPose, type PoseAdapter } from 'core/scene/composeFrame';\nimport { resolveDerivedPath } from 'core/scene/derivedPath';\nimport { createNodeMemoScope, type NodeMemoScope } from 'core/scene/nodeMemo';\nimport type { SceneViewDrawOne } from './NodeShape';\n\nexport { resolveDerivedPath } from 'core/scene/derivedPath';\n\n/**\n * `(node) => the pose it is painted at`: the slot's `toPose` if it has one,\n * else the scene's effective pose, folded through the parent chain when\n * the scene's composition makes a stored pose local to its container.\n */\nexport function scenePaintedPoseOf<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose?: (node: Node<TData, TLayer, TPose>) => TPose,\n): (node: Node<TData, TLayer, TPose>) => TPose {\n  const local = toPose ?? ((node: Node<TData, TLayer, TPose>) => effectivePose(scene, node));\n  if (!composesFrames(scene.composition)) return local;\n  const chain: PoseAdapter<TPose> = {\n    getPose: (id) => {\n      const n = scene.get(asNodeId(id));\n      return n ? local(n) : (undefined as unknown as TPose);\n    },\n    getParent: (id) => scene.get(asNodeId(id))?.parent ?? null,\n    definesFrame: (id) => {\n      const n = scene.get(asNodeId(id));\n      return n === undefined || definesFrame(n);\n    },\n  };\n  return (node) => composeWorldPose(chain, node.id, scene.composition.compose);\n}\n\n/**\n * `(id) => that node, the pose it is painted at, and the path it derives` —\n * resolved against the scene, so a dependency that is itself derived resolves\n * before it is read.\n *\n * A derived edge is drawn from these coordinates and must meet the nodes it\n * connects, so this reads the pose each one is painted at: see\n * {@link scenePaintedPoseOf}.\n */\nexport function sceneDepLookup<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose?: (node: Node<TData, TLayer, TPose>) => TPose,\n): (id: NodeId) => DerivedDep<TPose> | undefined {\n  const slot = memoSlotFor(toPose, composesFrames(scene.composition));\n  if (slot === undefined) return (id) => derivedDepOf(scene, id);\n  const ctx: SlotLookup<TPose> = {\n    at: scenePaintedPoseOf(scene, toPose) as (node: unknown) => TPose,\n    slot,\n    childrenOf: (id: NodeId) => scene.childrenOf(id),\n    lookup: (id: NodeId) => {\n      const node = scene.get(id);\n      return node === undefined ? undefined : new SlotDep(node, ctx);\n    },\n  };\n  return ctx.lookup;\n}\n\ninterface SlotLookup<TPose> {\n  at: (node: unknown) => TPose;\n  slot: string | NodeMemoScope;\n  childrenOf: (id: NodeId) => readonly NodeId[];\n  lookup: (id: NodeId) => DerivedDep<TPose> | undefined;\n}\n\n/** A class, not an object literal with a `get path()` — see `SceneDep` in\n *  `core/scene/effectivePose.ts` for why. */\nclass SlotDep<TPose> implements DerivedDep<TPose> {\n  readonly node: Node<unknown, string, TPose>;\n  readonly pose: TPose;\n\n  constructor(posed: unknown, private readonly ctx: SlotLookup<TPose>) {\n    this.node = posed as Node<unknown, string, TPose>;\n    this.pose = ctx.at(posed);\n  }\n\n  get path(): Path | null {\n    return resolveDerivedPath(\n      this.node as never, this.ctx.lookup, this.ctx.childrenOf, this.ctx.slot,\n    );\n  }\n}\n\n/** Whether something outside `node`'s data says what path it shows: it derives one, or a\n *  pose override carries one. The gate both scene walks check before resolving a path. */\nexport function showsComputedPath<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  node: { id: NodeId; dependsOn?: readonly NodeId[] | 'children' },\n): boolean {\n  return node.dependsOn !== undefined || scene.overrides.read(node.id)?.path !== undefined;\n}\n\n/**\n * `(node) => the path it shows in place of its data's`: a pose override's `path`, else the\n * one it derives, read through {@link sceneDepLookup}.\n *\n * An override path is in the scene's own frame, so a reader painting through a `toPose` is\n * answered the derived path alone.\n */\nexport function sceneDerivedPathOf<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose?: (node: Node<TData, TLayer, TPose>) => TPose,\n): (node: Node<TData, TLayer, TPose>) => Path | null {\n  const depOf = sceneDepLookup(scene, toPose);\n  const slot = memoSlotFor(toPose, composesFrames(scene.composition));\n  const childrenOf = (id: NodeId): readonly NodeId[] => scene.childrenOf(id);\n  const derived = (node: Node<TData, TLayer, TPose>): Path | null =>\n    resolveDerivedPath(node, depOf, childrenOf, slot);\n  if (toPose !== undefined) return derived;\n  return (node) => scene.overrides.read(node.id)?.path ?? derived(node);\n}\n\nconst toPoseScopes = new WeakMap<object, { local?: NodeMemoScope; world?: NodeMemoScope }>();\n\n/** Where one way of reading poses memoizes its paths, or `undefined` for the\n *  scene's own slot: two readers painting one scene at different poses must\n *  not serve each other's paths. Every reader composing stored poses shares a\n *  slot; a `toPose` gets a scope that is collected with the function. */\nfunction memoSlotFor(\n  toPose: object | undefined,\n  composes: boolean,\n): string | NodeMemoScope | undefined {\n  const frame = composes ? 'world' : 'local';\n  if (toPose === undefined) return frame === 'world' ? 'kit:derivedPath:world' : undefined;\n  let scopes = toPoseScopes.get(toPose);\n  if (scopes === undefined) {\n    scopes = {};\n    toPoseScopes.set(toPose, scopes);\n  }\n  return (scopes[frame] ??= createNodeMemoScope());\n}\n\n/**\n * Wrap a `drawOne` so a node that derives its geometry, or whose pose override\n * carries a path, arrives at the painter with the resolved path. The painter has no scene handle and so cannot read\n * the dependencies' poses itself; both scene walks wrap here instead.\n *\n * A node that derives nothing passes the caller's `ctx` through untouched —\n * this runs per node per frame, and an added `{ derivedPath: null }` would be\n * an allocation per node for a field no painter reads.\n */\nexport function withDerivedPaths<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  drawOne: SceneViewDrawOne<TData, TLayer, TPose>,\n  toPose?: (node: Node<TData, TLayer, TPose>) => TPose,\n): SceneViewDrawOne<TData, TLayer, TPose> {\n  const derivedPathOf = sceneDerivedPathOf(scene, toPose);\n  return (node, pose, view, ctx) => {\n    if (toPose !== undefined ? node.dependsOn === undefined : !showsComputedPath(scene, node)) {\n      return drawOne(node, pose, view, ctx);\n    }\n    return drawOne(node, pose, view, { ...ctx, derivedPath: derivedPathOf(node) });\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"derivedPath.js","names":[],"sources":["../../src/canvas/derivedPath.ts"],"sourcesContent":["/**\n * The render walk's half of derived paths: resolving one against a scene, and\n * handing it to the painter.\n *\n * The resolver itself lives in `core/scene/derivedPath.ts`, beside\n * `derivedPose` — a *pose* can derive from a dependency's path, so\n * `effectivePose` has to be able to reach it.\n */\nimport type { DerivedDep, Node, NodeId, Scene } from 'core/scene/types';\nimport { multiply, poseFrameInverseOf, poseFrameOf, type Path } from '@weasel-js/geom';\nimport { asNodeId } from 'core/scene/types';\nimport { definesFrame, derivedDepOf, effectivePose } from 'core/scene/effectivePose';\nimport { composesFrames, composeWorldPose, type PoseAdapter } from 'core/scene/composeFrame';\nimport { resolveDerivedPath } from 'core/scene/derivedPath';\nimport { createNodeMemoScope, type NodeMemoScope } from 'core/scene/nodeMemo';\nimport { carryBoxPath, carryPathBy, pathAsPainted } from 'core/scene/depFrame';\nimport type { SceneViewDrawOne } from './NodeShape';\n\nexport { resolveDerivedPath } from 'core/scene/derivedPath';\n\ntype ToPose<TData, TLayer extends string, TPose> = (node: Node<TData, TLayer, TPose>) => TPose;\n\n/** `node` as the scene shows it, its `pose` an override's or a derived one: the stored node\n *  itself where the two agree. */\nfunction shownNode<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  node: Node<TData, TLayer, TPose>,\n): Node<TData, TLayer, TPose> {\n  const pose = effectivePose(scene, node);\n  return pose === node.pose ? node : { ...node, pose };\n}\n\n/** A slot's `toPose`, handed each node as the scene shows it, so a view drawn through one\n *  shows a drag in flight and a rig's motion as every other view does. */\nexport function sceneShownToPose<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose: ToPose<TData, TLayer, TPose>,\n): ToPose<TData, TLayer, TPose> {\n  return (node) => toPose(shownNode(scene, node));\n}\n\n/**\n * `(node) => the path its pose override shows it by`, in the frame the reader paints in: as\n * the override has it, or under a `toPose` carried from the box the scene shows the node at\n * to the box `toPose` answers.\n */\nfunction sceneOverridePathOf<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose?: ToPose<TData, TLayer, TPose>,\n): (node: Node<TData, TLayer, TPose>) => Path | undefined {\n  if (toPose === undefined) return (node) => scene.overrides.read(node.id)?.path;\n  return (node) => {\n    const path = scene.overrides.read(node.id)?.path;\n    if (path === undefined) return undefined;\n    const shown = shownNode(scene, node);\n    return carryBoxPath(path, shown.pose, toPose(shown));\n  };\n}\n\n/**\n * `(node) => the pose it is painted at`: the slot's `toPose` of the node as the scene shows\n * it if it has one, else the scene's effective pose, folded through the parent chain when\n * the scene's composition makes a stored pose local to its container.\n */\nexport function scenePaintedPoseOf<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose?: (node: Node<TData, TLayer, TPose>) => TPose,\n): (node: Node<TData, TLayer, TPose>) => TPose {\n  const local = toPose\n    ? sceneShownToPose(scene, toPose)\n    : (node: Node<TData, TLayer, TPose>) => effectivePose(scene, node);\n  if (!composesFrames(scene.composition)) return local;\n  const chain: PoseAdapter<TPose> = {\n    getPose: (id) => {\n      const n = scene.get(asNodeId(id));\n      return n ? local(n) : (undefined as unknown as TPose);\n    },\n    getParent: (id) => scene.get(asNodeId(id))?.parent ?? null,\n    definesFrame: (id) => {\n      const n = scene.get(asNodeId(id));\n      return n === undefined || definesFrame(n);\n    },\n  };\n  return (node) => composeWorldPose(chain, node.id, scene.composition.compose);\n}\n\n/**\n * `(id) => that node, the pose it is painted at, and the path it derives` —\n * resolved against the scene, so a dependency that is itself derived resolves\n * before it is read.\n *\n * A derived edge is drawn from these coordinates and must meet the nodes it\n * connects, so this reads the pose each one is painted at: see\n * {@link scenePaintedPoseOf}.\n */\nexport function sceneDepLookup<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose?: (node: Node<TData, TLayer, TPose>) => TPose,\n): (id: NodeId) => DerivedDep<TPose> | undefined {\n  const slot = memoSlotFor(toPose, composesFrames(scene.composition));\n  if (slot === undefined) return (id) => derivedDepOf(scene, id);\n  const ctx: SlotLookup<TPose> = {\n    at: scenePaintedPoseOf(scene, toPose) as (node: unknown) => TPose,\n    local: (toPose\n      ? sceneShownToPose(scene, toPose)\n      : (node: Node<TData, TLayer, TPose>) => effectivePose(scene, node)) as (node: unknown) => TPose,\n    slot,\n    shown: sceneOverridePathOf(scene, toPose) as (node: unknown) => Path | undefined,\n    childrenOf: (id: NodeId) => scene.childrenOf(id),\n    lookup: (id: NodeId) => {\n      const node = scene.get(id);\n      return node === undefined ? undefined : new SlotDep(node, ctx);\n    },\n  };\n  return ctx.lookup;\n}\n\ninterface SlotLookup<TPose> {\n  at: (node: unknown) => TPose;\n  /** The pose the node is shown at in its own frame: the box its override path is drawn in. */\n  local: (node: unknown) => TPose;\n  slot: string | NodeMemoScope;\n  /** The path a pose override shows a node by, where it has one. */\n  shown: (node: unknown) => Path | undefined;\n  childrenOf: (id: NodeId) => readonly NodeId[];\n  lookup: (id: NodeId) => DerivedDep<TPose> | undefined;\n}\n\n/** A class, not an object literal with a `get path()` — see `SceneDep` in\n *  `core/scene/effectivePose.ts` for why. */\nclass SlotDep<TPose> implements DerivedDep<TPose> {\n  readonly node: Node<unknown, string, TPose>;\n  readonly pose: TPose;\n\n  constructor(posed: unknown, private readonly ctx: SlotLookup<TPose>) {\n    this.node = posed as Node<unknown, string, TPose>;\n    this.pose = ctx.at(posed);\n  }\n\n  get path(): Path | null {\n    const shown = this.ctx.shown(this.node);\n    if (shown !== undefined) return pathAsPainted(shown, this.ctx.local(this.node), this.pose);\n    return resolveDerivedPath(\n      this.node as never, this.ctx.lookup, this.ctx.childrenOf, this.ctx.slot,\n    );\n  }\n}\n\n/** Whether something outside `node`'s data says what path it shows: it derives one, or a\n *  pose override carries one. The gate both scene walks check before resolving a path. */\nexport function showsComputedPath<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  node: { id: NodeId; dependsOn?: readonly NodeId[] | 'children' },\n): boolean {\n  return node.dependsOn !== undefined || scene.overrides.read(node.id)?.path !== undefined;\n}\n\n/**\n * `(node) => the path it shows in place of its data's`: a pose override's `path`, else the\n * one it derives, read through {@link sceneDepLookup}. A reader painting through a `toPose`\n * is answered the override's path carried into the box its `toPose` answers.\n */\nexport function sceneDerivedPathOf<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  toPose?: (node: Node<TData, TLayer, TPose>) => TPose,\n): (node: Node<TData, TLayer, TPose>) => Path | null {\n  const depOf = sceneDepLookup(scene, toPose);\n  const slot = memoSlotFor(toPose, composesFrames(scene.composition));\n  const childrenOf = (id: NodeId): readonly NodeId[] => scene.childrenOf(id);\n  const derived = (node: Node<TData, TLayer, TPose>): Path | null =>\n    resolveDerivedPath(node, depOf, childrenOf, slot);\n  const overridePathOf = sceneOverridePathOf(scene, toPose);\n  return (node) => overridePathOf(node) ?? derived(node);\n}\n\nconst toPoseScopes = new WeakMap<object, { local?: NodeMemoScope; world?: NodeMemoScope }>();\n\n/** Where one way of reading poses memoizes its paths, or `undefined` for the\n *  scene's own slot: two readers painting one scene at different poses must\n *  not serve each other's paths. Every reader composing stored poses shares a\n *  slot; a `toPose` gets a scope that is collected with the function. */\nfunction memoSlotFor(\n  toPose: object | undefined,\n  composes: boolean,\n): string | NodeMemoScope | undefined {\n  const frame = composes ? 'world' : 'local';\n  if (toPose === undefined) return frame === 'world' ? 'kit:derivedPath:world' : undefined;\n  let scopes = toPoseScopes.get(toPose);\n  if (scopes === undefined) {\n    scopes = {};\n    toPoseScopes.set(toPose, scopes);\n  }\n  return (scopes[frame] ??= createNodeMemoScope());\n}\n\n/**\n * Wrap a `drawOne` so a node that derives its geometry, or whose pose override\n * carries a path, arrives at the painter with the resolved path. The painter has no scene handle and so cannot read\n * the dependencies' poses itself; both scene walks wrap here instead.\n *\n * A node that derives nothing passes the caller's `ctx` through untouched —\n * this runs per node per frame, and an added `{ derivedPath: null }` would be\n * an allocation per node for a field no painter reads.\n */\nexport function withDerivedPaths<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  drawOne: SceneViewDrawOne<TData, TLayer, TPose>,\n  toPose?: (node: Node<TData, TLayer, TPose>) => TPose,\n): SceneViewDrawOne<TData, TLayer, TPose> {\n  const derivedPathOf = sceneDerivedPathOf(scene, toPose);\n  const ownPoseOf = composesFrames(scene.composition)\n    ? (toPose ? sceneShownToPose(scene, toPose) : (node: Node<TData, TLayer, TPose>) => effectivePose(scene, node))\n    : null;\n  return (node, pose, view, ctx) => {\n    if (!showsComputedPath(scene, node)) return drawOne(node, pose, view, ctx);\n    let path = derivedPathOf(node);\n    if (path !== null && ownPoseOf !== null && scene.overrides.read(node.id)?.path === undefined) {\n      path = withoutInheritedFrame(path, pose, ownPoseOf(node));\n    }\n    return drawOne(node, pose, view, { ...ctx, derivedPath: path });\n  };\n}\n\n/**\n * A derived path is drawn from its dependencies' painted poses, so it is already where it\n * shows; but the pose rotation the walk wraps every node in is `painted`'s, which carries its\n * containers' turns as well as its own. Carried back through what the containers add, the\n * wrap turns it by its own frame alone, as it does a root's.\n */\nfunction withoutInheritedFrame(path: Path, painted: unknown, own: unknown): Path {\n  const undo = poseFrameInverseOf(painted);\n  if (undo === null) return path;\n  const box = painted as { x: number; y: number; width: number; height: number };\n  const o = own as { rotation?: number; transform?: unknown } | null;\n  const redo = poseFrameOf({ x: box.x, y: box.y, width: box.width, height: box.height, rotation: o?.rotation, transform: o?.transform });\n  return carryPathBy(path, redo === null ? undo : multiply(undo, redo));\n}\n"],"mappings":"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"}

package/dist/canvas/doubleClickTarget.js

@@ -0,0 +1,20 @@
+//#region src/canvas/doubleClickTarget.ts
+/**
+* The node a double-click on `hitId` names: the outermost group on the way up from it, stopping
+* below `scope`, or `hitId` itself where no group stands between them. So a double-click on a
+* grouped member names the group, and each one inside an isolated group names the next group in.
+*/
+function doubleClickTarget(hitId, tree) {
+	const { parentOf, kindOf, scope } = tree;
+	let named = hitId;
+	let id = hitId;
+	for (let depth = 0; id !== null && id !== scope && depth < 1e4; depth++) {
+		if (kindOf(id) === "group") named = id;
+		id = parentOf(id);
+	}
+	return named;
+}
+
+//#endregion
+export { doubleClickTarget };
+//# sourceMappingURL=doubleClickTarget.js.map

package/dist/canvas/doubleClickTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doubleClickTarget.js","names":[],"sources":["../../src/canvas/doubleClickTarget.ts"],"sourcesContent":["/** How {@link doubleClickTarget} reads the tree. */\nexport interface DoubleClickTree {\n  parentOf: (id: string) => string | null;\n  /** A node's routing kind; a node routed `'group'` is one a double-click can name. */\n  kindOf: (id: string) => string | undefined;\n  /** The group isolation is working inside, or null at the scene root. */\n  scope: string | null;\n}\n\n/**\n * The node a double-click on `hitId` names: the outermost group on the way up from it, stopping\n * below `scope`, or `hitId` itself where no group stands between them. So a double-click on a\n * grouped member names the group, and each one inside an isolated group names the next group in.\n */\nexport function doubleClickTarget(hitId: string, tree: DoubleClickTree): string {\n  const { parentOf, kindOf, scope } = tree;\n  let named = hitId;\n  let id: string | null = hitId;\n  // Capped so a cyclic parent chain cannot hang the pick.\n  for (let depth = 0; id !== null && id !== scope && depth < 10_000; depth++) {\n    if (kindOf(id) === 'group') named = id;\n    id = parentOf(id);\n  }\n  return named;\n}\n"],"mappings":";;;;;;AAcA,SAAgB,kBAAkB,OAAe,MAA+B;CAC9E,MAAM,EAAE,UAAU,QAAQ,UAAU;CACpC,IAAI,QAAQ;CACZ,IAAI,KAAoB;CAExB,KAAK,IAAI,QAAQ,GAAG,OAAO,QAAQ,OAAO,SAAS,QAAQ,KAAQ,SAAS;EAC1E,IAAI,OAAO,EAAE,MAAM,SAAS,QAAQ;EACpC,KAAK,SAAS,EAAE;CAClB;CACA,OAAO;AACT"}

package/dist/canvas/drawEnvelope.js

@@ -1,26 +1,35 @@
 //#region src/canvas/drawEnvelope.ts
-function e(e, t) {
-	let n = e;
-	return typeof n?.[t] == "function" ? n[t] : void 0;
+function thunk(data, key) {
+	const maybe = data;
+	return typeof maybe?.[key] === "function" ? maybe[key] : void 0;
 }
-function t(t) {
-	return e(t, "getChromeState")?.() ?? null;
+/** This view's chrome state, or `null` when the caller passed plain data. */
+function chromeStateFrom(data) {
+	return thunk(data, "getChromeState")?.() ?? null;
 }
-function n(t) {
-	return e(t, "getIsVisible")?.() ?? null;
+/** This view's chrome-caps predicate, or `null` when the caller passed plain
+*  data — the layer then paints unconditionally. */
+function isVisibleFrom(data) {
+	return thunk(data, "getIsVisible")?.() ?? null;
 }
-function r(t) {
-	return e(t, "getPreviewSources")?.() ?? o;
+/** This view's in-flight preview surfaces, in resolution order. Empty when
+*  nothing is in flight and when the caller passed plain data. */
+function previewSourcesFrom(data) {
+	return thunk(data, "getPreviewSources")?.() ?? EMPTY_SOURCES;
 }
-function i(t) {
-	return e(t, "getGestureOverlays")?.() ?? s;
+/** The overlay shapes this view's in-flight handles publish. */
+function gestureOverlaysFrom(data) {
+	return thunk(data, "getGestureOverlays")?.() ?? EMPTY_OVERLAYS;
 }
-function a(e) {
-	let t = e?.getDebug;
-	return typeof t == "function" ? t() : null;
+/** The surface's debug sink, or `null` when debugging is off and when the
+*  caller passed plain data. */
+function debugSinkFrom(data) {
+	const getDebug = data?.getDebug;
+	return typeof getDebug === "function" ? getDebug() : null;
 }
-var o = [], s = [];
-//#endregion
-export { t as chromeStateFrom, a as debugSinkFrom, i as gestureOverlaysFrom, n as isVisibleFrom, r as previewSourcesFrom };
+var EMPTY_SOURCES = [];
+var EMPTY_OVERLAYS = [];
 
+//#endregion
+export { chromeStateFrom, debugSinkFrom, gestureOverlaysFrom, isVisibleFrom, previewSourcesFrom };
 //# sourceMappingURL=drawEnvelope.js.map

package/dist/canvas/drawEnvelope.js.map

@@ -1 +1 @@
-{"version":3,"file":"drawEnvelope.js","names":["thunk","maybe","data","key","chromeStateFrom","isVisibleFrom","previewSourcesFrom","EMPTY_SOURCES","gestureOverlaysFrom","EMPTY_OVERLAYS","debugSinkFrom","getDebug"],"sources":["../../src/canvas/drawEnvelope.ts"],"sourcesContent":["/**\n * Reading a layer's draw envelope.\n *\n * Every `RenderLayer.draw` receives the drawing view's `CanvasHelpers` as its\n * `data` argument. A layer that answers from a construction closure instead\n * answers for view zero in every view. A layer drawn by a bare consumer may\n * get plain data, so each reader has an \"unwired\" answer rather than throwing.\n */\nimport type { ChromeState } from 'core/selection/chromeState';\nimport type { OngoingOverlay } from '@weasel-js/routing';\nimport type { GesturePreviewSource } from './gestureBounds';\nimport type { DebugSink } from '../debug/types';\nimport type { CanvasSurfaceHelpers, CanvasViewHelpers } from './useViewHelpers';\n\ntype PartialEnvelope = Partial<CanvasViewHelpers<unknown>>;\n\nfunction thunk<K extends keyof CanvasViewHelpers<unknown>>(\n  data: unknown,\n  key: K,\n): CanvasViewHelpers<unknown>[K] | undefined {\n  const maybe = data as PartialEnvelope | null | undefined;\n  return typeof maybe?.[key] === 'function' ? maybe[key] : undefined;\n}\n\n/** This view's chrome state, or `null` when the caller passed plain data. */\nexport function chromeStateFrom(data: unknown): ChromeState | null {\n  return thunk(data, 'getChromeState')?.() ?? null;\n}\n\n/** This view's chrome-caps predicate, or `null` when the caller passed plain\n *  data — the layer then paints unconditionally. */\nexport function isVisibleFrom(data: unknown): ((id: string) => boolean) | null {\n  return thunk(data, 'getIsVisible')?.() ?? null;\n}\n\n/** This view's in-flight preview surfaces, in resolution order. Empty when\n *  nothing is in flight and when the caller passed plain data. */\nexport function previewSourcesFrom(data: unknown): readonly GesturePreviewSource[] {\n  return thunk(data, 'getPreviewSources')?.() ?? EMPTY_SOURCES;\n}\n\n/** The overlay shapes this view's in-flight handles publish. */\nexport function gestureOverlaysFrom(data: unknown): readonly OngoingOverlay[] {\n  return thunk(data, 'getGestureOverlays')?.() ?? EMPTY_OVERLAYS;\n}\n\n/** The surface's debug sink, or `null` when debugging is off and when the\n *  caller passed plain data. */\nexport function debugSinkFrom(data: unknown): DebugSink | null {\n  const getDebug = (data as Partial<CanvasSurfaceHelpers> | null | undefined)?.getDebug;\n  return typeof getDebug === 'function' ? getDebug() : null;\n}\n\n/** First non-null `previewPose(id)` across `sources`, or `null`. */\nexport function previewPoseIn(\n  sources: readonly GesturePreviewSource[],\n  id: string,\n): unknown {\n  for (const s of sources) {\n    const p = s.previewPose?.(id);\n    if (p != null) return p;\n  }\n  return null;\n}\n\n/** First non-null `previewData(id)` across `sources`, or `null`. */\nexport function previewDataIn(\n  sources: readonly GesturePreviewSource[],\n  id: string,\n): unknown {\n  for (const s of sources) {\n    const d = s.previewData?.(id);\n    if (d != null) return d;\n  }\n  return null;\n}\n\nconst EMPTY_SOURCES: readonly GesturePreviewSource[] = [];\nconst EMPTY_OVERLAYS: readonly OngoingOverlay[] = [];\n"],"mappings":";AAgBA,SAASA,EACP,GACA,GAC2C;CAC3C,IAAMC,IAAQC;CACd,OAAO,OAAOD,IAAQE,MAAS,aAAaF,EAAME,KAAO,KAAA;AAC3D;AAGA,SAAgBC,EAAgB,GAAmC;CACjE,OAAOJ,EAAME,GAAM,gBAAgB,CAAC,GAAG,KAAK;AAC9C;AAIA,SAAgBG,EAAc,GAAiD;CAC7E,OAAOL,EAAME,GAAM,cAAc,CAAC,GAAG,KAAK;AAC5C;AAIA,SAAgBI,EAAmB,GAAgD;CACjF,OAAON,EAAME,GAAM,mBAAmB,CAAC,GAAG,KAAKK;AACjD;AAGA,SAAgBC,EAAoB,GAA0C;CAC5E,OAAOR,EAAME,GAAM,oBAAoB,CAAC,GAAG,KAAKO;AAClD;AAIA,SAAgBC,EAAc,GAAiC;CAC7D,IAAMC,IAAYT,GAA2D;CAC7E,OAAO,OAAOS,KAAa,aAAaA,EAAS,IAAI;AACvD;AA0BA,IAAMJ,IAAiD,CAAC,GAClDE,IAA4C,CAAC"}
+{"version":3,"file":"drawEnvelope.js","names":[],"sources":["../../src/canvas/drawEnvelope.ts"],"sourcesContent":["/**\n * Reading a layer's draw envelope.\n *\n * Every `RenderLayer.draw` receives the drawing view's `CanvasHelpers` as its\n * `data` argument. A layer that answers from a construction closure instead\n * answers for view zero in every view. A layer drawn by a bare consumer may\n * get plain data, so each reader has an \"unwired\" answer rather than throwing.\n */\nimport type { ChromeState } from 'core/selection/chromeState';\nimport type { OngoingOverlay } from '@weasel-js/routing';\nimport type { GesturePreviewSource } from './gestureBounds';\nimport type { DebugSink } from '../debug/types';\nimport type { CanvasSurfaceHelpers, CanvasViewHelpers } from './useViewHelpers';\n\ntype PartialEnvelope = Partial<CanvasViewHelpers<unknown>>;\n\nfunction thunk<K extends keyof CanvasViewHelpers<unknown>>(\n  data: unknown,\n  key: K,\n): CanvasViewHelpers<unknown>[K] | undefined {\n  const maybe = data as PartialEnvelope | null | undefined;\n  return typeof maybe?.[key] === 'function' ? maybe[key] : undefined;\n}\n\n/** This view's chrome state, or `null` when the caller passed plain data. */\nexport function chromeStateFrom(data: unknown): ChromeState | null {\n  return thunk(data, 'getChromeState')?.() ?? null;\n}\n\n/** This view's chrome-caps predicate, or `null` when the caller passed plain\n *  data — the layer then paints unconditionally. */\nexport function isVisibleFrom(data: unknown): ((id: string) => boolean) | null {\n  return thunk(data, 'getIsVisible')?.() ?? null;\n}\n\n/** This view's in-flight preview surfaces, in resolution order. Empty when\n *  nothing is in flight and when the caller passed plain data. */\nexport function previewSourcesFrom(data: unknown): readonly GesturePreviewSource[] {\n  return thunk(data, 'getPreviewSources')?.() ?? EMPTY_SOURCES;\n}\n\n/** The overlay shapes this view's in-flight handles publish. */\nexport function gestureOverlaysFrom(data: unknown): readonly OngoingOverlay[] {\n  return thunk(data, 'getGestureOverlays')?.() ?? EMPTY_OVERLAYS;\n}\n\n/** The surface's debug sink, or `null` when debugging is off and when the\n *  caller passed plain data. */\nexport function debugSinkFrom(data: unknown): DebugSink | null {\n  const getDebug = (data as Partial<CanvasSurfaceHelpers> | null | undefined)?.getDebug;\n  return typeof getDebug === 'function' ? getDebug() : null;\n}\n\n/** First non-null `previewPose(id)` across `sources`, or `null`. */\nexport function previewPoseIn(\n  sources: readonly GesturePreviewSource[],\n  id: string,\n): unknown {\n  for (const s of sources) {\n    const p = s.previewPose?.(id);\n    if (p != null) return p;\n  }\n  return null;\n}\n\n/** First non-null `previewData(id)` across `sources`, or `null`. */\nexport function previewDataIn(\n  sources: readonly GesturePreviewSource[],\n  id: string,\n): unknown {\n  for (const s of sources) {\n    const d = s.previewData?.(id);\n    if (d != null) return d;\n  }\n  return null;\n}\n\nconst EMPTY_SOURCES: readonly GesturePreviewSource[] = [];\nconst EMPTY_OVERLAYS: readonly OngoingOverlay[] = [];\n"],"mappings":";AAgBA,SAAS,MACP,MACA,KAC2C;CAC3C,MAAM,QAAQ;CACd,OAAO,OAAO,QAAQ,SAAS,aAAa,MAAM,OAAO;AAC3D;;AAGA,SAAgB,gBAAgB,MAAmC;CACjE,OAAO,MAAM,MAAM,gBAAgB,CAAC,GAAG,KAAK;AAC9C;;;AAIA,SAAgB,cAAc,MAAiD;CAC7E,OAAO,MAAM,MAAM,cAAc,CAAC,GAAG,KAAK;AAC5C;;;AAIA,SAAgB,mBAAmB,MAAgD;CACjF,OAAO,MAAM,MAAM,mBAAmB,CAAC,GAAG,KAAK;AACjD;;AAGA,SAAgB,oBAAoB,MAA0C;CAC5E,OAAO,MAAM,MAAM,oBAAoB,CAAC,GAAG,KAAK;AAClD;;;AAIA,SAAgB,cAAc,MAAiC;CAC7D,MAAM,WAAY,MAA2D;CAC7E,OAAO,OAAO,aAAa,aAAa,SAAS,IAAI;AACvD;AA0BA,IAAM,gBAAiD,CAAC;AACxD,IAAM,iBAA4C,CAAC"}

package/dist/canvas/drawnBounds.js

@@ -0,0 +1,116 @@
+import { axisAlignedBounds } from "../core/geometry/unionBounds.js";
+import { framedBounds, poseDescriptorForNode } from "../core/geometry/poseDescriptor.js";
+import { AUTO_POSE_DESCRIPTOR } from "../core/geometry/autoPoseDescriptor.js";
+import { targetCorners, targetTransformOf, worldToLocal } from "../core/geometry/targetFrame.js";
+import { NO_INK_EXTENTS, inkExtentsBetween, outsetBox } from "../core/geometry/inkExtents.js";
+import { findNodeShape } from "./NodeShape.js";
+import { meanScale } from "@weasel-js/geom";
+
+//#region src/canvas/drawnBounds.ts
+/**
+* The box of a node as drawn — its pose box with the stroke included — which
+* is what selection chrome, resize, rotate, and alignment sit on. Places that
+* store geometry (a group's derived pose, booleans, export) keep reading the
+* pose box through `framedBounds`.
+*/
+/**
+* The box of `id` drawn at `pose`, stroke included, in the frame the pose is
+* drawn in: a turned node's box comes back turned with it. A node with no
+* stroke, a painter that declares no {@link NodeShapeEntry.drawnBounds}, or
+* `includeStroke: false` answers `framedBounds` unchanged. A container's box
+* reaches as far as its members' boxes do.
+*/
+function drawnBoundsOf(scene, id, pose, opts = {}) {
+	return outsetBox(framedBounds(pose, descriptorFor(scene, id, opts)), inkExtentsOf(scene, id, pose, opts));
+}
+/** How far `id`'s ink at `pose` reaches past its pose box on each side, in
+*  the box's own frame: what {@link drawnBoundsOf} grows the pose box by. */
+function inkExtentsOf(scene, id, pose, opts = {}) {
+	if (opts.includeStroke === false) return NO_INK_EXTENTS;
+	const node = scene.get(id);
+	if (!node) return NO_INK_EXTENTS;
+	const own = framedBounds(pose, descriptorFor(scene, id, opts));
+	const unframed = {
+		x: own.x,
+		y: own.y,
+		width: own.width,
+		height: own.height
+	};
+	const members = node.kind === "container" ? scene.childrenOf?.(id) ?? [] : [];
+	if (members.length > 0) return membersExtents(scene, members, own, opts);
+	const drawn = findShapeDrawnBounds(node, pose, inkCtx(opts.scale, own));
+	return drawn === null ? NO_INK_EXTENTS : inkExtentsBetween(normalized(unframed), drawn);
+}
+/** A container's extents: its members' drawn boxes, taken into its own frame,
+*  past its own box. */
+function membersExtents(scene, members, own, opts) {
+	const xf = targetTransformOf(own);
+	const worldPoseOf = opts.worldPoseOf ?? ((m) => scene.get(m)?.pose);
+	let x0 = Infinity, y0 = Infinity, x1 = -Infinity, y1 = -Infinity;
+	for (const m of members) {
+		const box = drawnBoundsOf(scene, m, worldPoseOf(m), opts);
+		for (const c of targetCorners(box, targetTransformOf(box))) {
+			const p = worldToLocal(xf, c.x, c.y);
+			if (!p) continue;
+			x0 = Math.min(x0, p.x);
+			y0 = Math.min(y0, p.y);
+			x1 = Math.max(x1, p.x);
+			y1 = Math.max(y1, p.y);
+		}
+	}
+	if (x0 === Infinity) return NO_INK_EXTENTS;
+	return inkExtentsBetween(normalized(own), {
+		x: x0,
+		y: y0,
+		width: x1 - x0,
+		height: y1 - y0
+	});
+}
+/** {@link drawnBoundsOf} as an axis-aligned box: what a turned node covers. */
+function drawnAABBOf(scene, id, pose, opts = {}) {
+	return axisAlignedBounds(drawnBoundsOf(scene, id, pose, opts));
+}
+/** The painter's {@link NodeShapeEntry.drawnBounds} for `node`, or `null`
+*  when no painter matches or the one that does declares none. */
+function findShapeDrawnBounds(node, pose, ctx) {
+	return findNodeShape(node)?.drawnBounds?.(node, pose, ctx) ?? null;
+}
+function descriptorFor(scene, id, opts) {
+	const d = opts.descriptor ?? AUTO_POSE_DESCRIPTOR;
+	const node = scene.get(id);
+	return node ? poseDescriptorForNode(d, node) : d;
+}
+/** A per-axis view scale also carries the map from `own`'s frame to screen,
+*  so a `{ px }` stroke is measured there rather than at the mean. */
+function inkCtx(scale, own) {
+	if (scale === void 0) return void 0;
+	if (typeof scale === "number") return { scale };
+	const xf = targetTransformOf(own);
+	const [a, b, c, d] = xf.identity ? [
+		1,
+		0,
+		0,
+		1
+	] : xf.toWorld;
+	return {
+		scale: meanScale(scale),
+		screen: [
+			scale.x * a,
+			scale.y * b,
+			scale.x * c,
+			scale.y * d
+		]
+	};
+}
+function normalized(b) {
+	return {
+		x: Math.min(b.x, b.x + b.width),
+		y: Math.min(b.y, b.y + b.height),
+		width: Math.abs(b.width),
+		height: Math.abs(b.height)
+	};
+}
+
+//#endregion
+export { drawnAABBOf, drawnBoundsOf, findShapeDrawnBounds, inkExtentsOf };
+//# sourceMappingURL=drawnBounds.js.map

package/dist/canvas/drawnBounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawnBounds.js","names":[],"sources":["../../src/canvas/drawnBounds.ts"],"sourcesContent":["/**\n * The box of a node as drawn — its pose box with the stroke included — which\n * is what selection chrome, resize, rotate, and alignment sit on. Places that\n * store geometry (a group's derived pose, booleans, export) keep reading the\n * pose box through `framedBounds`.\n */\nimport { framedBounds, poseDescriptorForNode, type PoseDescriptor } from 'core/geometry/poseDescriptor';\nimport {\n  inkExtentsBetween,\n  NO_INK_EXTENTS,\n  outsetBox,\n  type InkExtents,\n} from 'core/geometry/inkExtents';\nimport { targetCorners, targetTransformOf, worldToLocal } from 'core/geometry/targetFrame';\nimport { axisAlignedBounds } from 'core/geometry/unionBounds';\nimport type { Node, NodeId } from 'core/scene/types';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\nimport { meanScale, type Scale2 } from '@weasel-js/geom';\nimport { AUTO_POSE_DESCRIPTOR } from 'core/geometry/autoPoseDescriptor';\nimport { findNodeShape, type NodeInkCtx } from './NodeShape';\n\n/** The scene reads {@link drawnBoundsOf} makes. `childrenOf` absent: every\n *  node is a leaf. */\nexport interface DrawnBoundsScene {\n  get(id: NodeId): Node<unknown, string, unknown> | undefined;\n  childrenOf?(id: NodeId): readonly NodeId[];\n}\n\n/** How {@link drawnBoundsOf} reads a node. */\nexport interface DrawnBoundsOptions {\n  /** How poses are read. Default `AUTO_POSE_DESCRIPTOR`. */\n  descriptor?: PoseDescriptor<unknown>;\n  /** A member's world pose, for boxing a container around its members.\n   *  Default: its pose as stored, which is world unless containers compose. */\n  worldPoseOf?: (id: NodeId) => unknown;\n  /** `false` answers the pose box alone. Default `true`. */\n  includeStroke?: boolean;\n  /** View scale, which a screen-pixel stroke width is resolved at. Default 1. */\n  scale?: number | Scale2;\n}\n\n/**\n * The box of `id` drawn at `pose`, stroke included, in the frame the pose is\n * drawn in: a turned node's box comes back turned with it. A node with no\n * stroke, a painter that declares no {@link NodeShapeEntry.drawnBounds}, or\n * `includeStroke: false` answers `framedBounds` unchanged. A container's box\n * reaches as far as its members' boxes do.\n */\nexport function drawnBoundsOf(\n  scene: DrawnBoundsScene,\n  id: NodeId,\n  pose: unknown,\n  opts: DrawnBoundsOptions = {},\n): Bounds {\n  return outsetBox(framedBounds(pose, descriptorFor(scene, id, opts)), inkExtentsOf(scene, id, pose, opts));\n}\n\n/** How far `id`'s ink at `pose` reaches past its pose box on each side, in\n *  the box's own frame: what {@link drawnBoundsOf} grows the pose box by. */\nexport function inkExtentsOf(\n  scene: DrawnBoundsScene,\n  id: NodeId,\n  pose: unknown,\n  opts: DrawnBoundsOptions = {},\n): InkExtents {\n  if (opts.includeStroke === false) return NO_INK_EXTENTS;\n  const node = scene.get(id);\n  if (!node) return NO_INK_EXTENTS;\n  const own = framedBounds(pose, descriptorFor(scene, id, opts));\n  const unframed = { x: own.x, y: own.y, width: own.width, height: own.height };\n  const members = node.kind === 'container' ? scene.childrenOf?.(id) ?? [] : [];\n  if (members.length > 0) return membersExtents(scene, members, own, opts);\n  const drawn = findShapeDrawnBounds(node, pose, inkCtx(opts.scale, own));\n  return drawn === null ? NO_INK_EXTENTS : inkExtentsBetween(normalized(unframed), drawn);\n}\n\n/** A container's extents: its members' drawn boxes, taken into its own frame,\n *  past its own box. */\nfunction membersExtents(\n  scene: DrawnBoundsScene,\n  members: readonly NodeId[],\n  own: Bounds,\n  opts: DrawnBoundsOptions,\n): InkExtents {\n  const xf = targetTransformOf(own);\n  const worldPoseOf = opts.worldPoseOf ?? ((m: NodeId) => scene.get(m)?.pose);\n  let x0 = Infinity, y0 = Infinity, x1 = -Infinity, y1 = -Infinity;\n  for (const m of members) {\n    const box = drawnBoundsOf(scene, m, worldPoseOf(m), opts);\n    for (const c of targetCorners(box, targetTransformOf(box))) {\n      const p = worldToLocal(xf, c.x, c.y);\n      if (!p) continue;\n      x0 = Math.min(x0, p.x); y0 = Math.min(y0, p.y);\n      x1 = Math.max(x1, p.x); y1 = Math.max(y1, p.y);\n    }\n  }\n  if (x0 === Infinity) return NO_INK_EXTENTS;\n  return inkExtentsBetween(normalized(own), { x: x0, y: y0, width: x1 - x0, height: y1 - y0 });\n}\n\n/** {@link drawnBoundsOf} as an axis-aligned box: what a turned node covers. */\nexport function drawnAABBOf(\n  scene: DrawnBoundsScene,\n  id: NodeId,\n  pose: unknown,\n  opts: DrawnBoundsOptions = {},\n): Bounds {\n  return axisAlignedBounds(drawnBoundsOf(scene, id, pose, opts));\n}\n\n/** The painter's {@link NodeShapeEntry.drawnBounds} for `node`, or `null`\n *  when no painter matches or the one that does declares none. */\nexport function findShapeDrawnBounds<TData, TPose>(\n  node: Node<TData, string, TPose>,\n  pose: TPose,\n  ctx?: NodeInkCtx,\n): Bounds | null {\n  return findNodeShape(node)?.drawnBounds?.(node, pose, ctx) ?? null;\n}\n\nfunction descriptorFor(scene: DrawnBoundsScene, id: NodeId, opts: DrawnBoundsOptions): PoseDescriptor<unknown> {\n  const d = opts.descriptor ?? AUTO_POSE_DESCRIPTOR;\n  const node = scene.get(id);\n  return node ? poseDescriptorForNode(d, node) : d;\n}\n\n/** A per-axis view scale also carries the map from `own`'s frame to screen,\n *  so a `{ px }` stroke is measured there rather than at the mean. */\nfunction inkCtx(scale: number | Scale2 | undefined, own: Bounds): NodeInkCtx | undefined {\n  if (scale === undefined) return undefined;\n  if (typeof scale === 'number') return { scale };\n  const xf = targetTransformOf(own);\n  const [a, b, c, d] = xf.identity ? [1, 0, 0, 1] : xf.toWorld;\n  return { scale: meanScale(scale), screen: [scale.x * a, scale.y * b, scale.x * c, scale.y * d] };\n}\n\nfunction normalized(b: Bounds): Bounds {\n  return {\n    x: Math.min(b.x, b.x + b.width),\n    y: Math.min(b.y, b.y + b.height),\n    width: Math.abs(b.width),\n    height: Math.abs(b.height),\n  };\n}\n"],"mappings":"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"}

package/dist/canvas/getNodeAtPoint.js

@@ -1,14 +1,17 @@
 //#region src/canvas/getNodeAtPoint.ts
-function e(e, t) {
-	return (n, r, i) => {
-		let a = e(n, r, i);
-		return a == null ? null : {
-			id: a,
-			kind: t?.(a)?.kind ?? "unknown"
+/** The node a single-hit picker names under a world point, with its kind:
+*  `'unknown'` when `nodeResolver` is absent or returns null. */
+function makeGetNodeAtPoint(pickBest, nodeResolver) {
+	return (wx, wy, view) => {
+		const id = pickBest(wx, wy, view);
+		if (id == null) return null;
+		return {
+			id,
+			kind: nodeResolver?.(id)?.kind ?? "unknown"
 		};
 	};
 }
-//#endregion
-export { e as makeGetNodeAtPoint };
 
+//#endregion
+export { makeGetNodeAtPoint };
 //# sourceMappingURL=getNodeAtPoint.js.map

package/dist/canvas/getNodeAtPoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"getNodeAtPoint.js","names":["makeGetNodeAtPoint","id","pickBest","wx","wy","view","nodeResolver"],"sources":["../../src/canvas/getNodeAtPoint.ts"],"sourcesContent":["import type { PickView } from './SceneCanvas/useSceneSelectTool';\n\n/** The hit record returned by a `getNodeAtPoint` function. */\nexport interface NodeAtPointHit {\n  id: string;\n  kind: string;\n}\n\n/** Resolves a node's routing kind. */\nexport type NodeResolver = (id: string) => { kind: string } | null;\n\n/** The node a single-hit picker names under a world point, with its kind:\n *  `'unknown'` when `nodeResolver` is absent or returns null. */\nexport function makeGetNodeAtPoint(\n  pickBest: (wx: number, wy: number, view?: PickView | null) => string | null,\n  nodeResolver?: NodeResolver,\n): (wx: number, wy: number, view?: PickView | null) => NodeAtPointHit | null {\n  return (wx: number, wy: number, view?: PickView | null): NodeAtPointHit | null => {\n    const id = pickBest(wx, wy, view);\n    if (id == null) return null;\n\n    return { id, kind: nodeResolver?.(id)?.kind ?? 'unknown' };\n  };\n}\n"],"mappings":";AAaA,SAAgBA,EACd,GACA,GAC2E;CAC3E,QAAQ,GAAY,GAAY,MAAkD;EAChF,IAAMC,IAAKC,EAASC,GAAIC,GAAIC,CAAI;EAGhC,OAFIJ,KAAM,OAAa,OAEhB;GAAE;GAAI,MAAMK,IAAeL,CAAE,CAAC,EAAE,QAAQ;EAAU;CAC3D;AACF"}
+{"version":3,"file":"getNodeAtPoint.js","names":[],"sources":["../../src/canvas/getNodeAtPoint.ts"],"sourcesContent":["import type { PickView } from './SceneCanvas/useSceneSelectTool';\n\n/** The hit record returned by a `getNodeAtPoint` function. */\nexport interface NodeAtPointHit {\n  id: string;\n  kind: string;\n}\n\n/** Resolves a node's routing kind. */\nexport type NodeResolver = (id: string) => { kind: string } | null;\n\n/** The node a single-hit picker names under a world point, with its kind:\n *  `'unknown'` when `nodeResolver` is absent or returns null. */\nexport function makeGetNodeAtPoint(\n  pickBest: (wx: number, wy: number, view?: PickView | null) => string | null,\n  nodeResolver?: NodeResolver,\n): (wx: number, wy: number, view?: PickView | null) => NodeAtPointHit | null {\n  return (wx: number, wy: number, view?: PickView | null): NodeAtPointHit | null => {\n    const id = pickBest(wx, wy, view);\n    if (id == null) return null;\n\n    return { id, kind: nodeResolver?.(id)?.kind ?? 'unknown' };\n  };\n}\n"],"mappings":";;;AAaA,SAAgB,mBACd,UACA,cAC2E;CAC3E,QAAQ,IAAY,IAAY,SAAkD;EAChF,MAAM,KAAK,SAAS,IAAI,IAAI,IAAI;EAChC,IAAI,MAAM,MAAM,OAAO;EAEvB,OAAO;GAAE;GAAI,MAAM,eAAe,EAAE,CAAC,EAAE,QAAQ;EAAU;CAC3D;AACF"}

package/dist/canvas/hostAnchor.js

@@ -1,29 +1,46 @@
-import { clampRectWithin as e } from "@weasel-js/geom";
+import { clampRectWithin } from "@weasel-js/geom";
+
 //#region src/canvas/hostAnchor.ts
-function t(e, t, n, r, i) {
-	return r === "start" ? e + i : r === "end" ? e + t - n - i : e + (t - n) / 2 + i;
+function insetAlong(start, extent, size, align, by) {
+	if (align === "start") return start + by;
+	if (align === "end") return start + extent - size - by;
+	return start + (extent - size) / 2 + by;
 }
-function n(n) {
-	let { host: r, panel: i, viewport: a, align: o, offset: s, padding: c = 0 } = n, l = {
-		x: t(r.x, r.width, i.width, o.x, s.x),
-		y: t(r.y, r.height, i.height, o.y, s.y),
-		width: i.width,
-		height: i.height
+/**
+* Where a fixed-position panel held against a host element's corner lands, once
+* it has been kept inside the viewport. Returns a rect rather than CSS so the
+* caller decides which edges to pin — see {@link hostAnchorCss}.
+*/
+function hostAnchorRect(input) {
+	const { host, panel, viewport, align, offset, padding = 0 } = input;
+	const desired = {
+		x: insetAlong(host.x, host.width, panel.width, align.x, offset.x),
+		y: insetAlong(host.y, host.height, panel.height, align.y, offset.y),
+		width: panel.width,
+		height: panel.height
 	};
-	return e(l, {
+	return clampRectWithin(desired, {
 		x: 0,
 		y: 0,
-		width: a.width,
-		height: a.height
-	}, c);
+		width: viewport.width,
+		height: viewport.height
+	}, padding);
 }
-function r(e, t, n) {
+/**
+* CSS for a resolved rect, pinning whichever edges the alignment names.
+*
+* Pinning matters beyond taste: a panel whose width tracks its content holds
+* the anchored edge still and grows away from it. Pin the wrong edge and the
+* anchored corner drifts on every content change, correcting only once a
+* resize observer catches up.
+*/
+function hostAnchorCss(rect, align, viewport) {
 	return {
-		...t.y === "end" ? { bottom: n.height - e.y - e.height } : { top: e.y },
-		...t.x === "end" ? { right: n.width - e.x - e.width } : { left: e.x }
+		...align.y === "end" ? { bottom: viewport.height - rect.y - rect.height } : { top: rect.y },
+		...align.x === "end" ? { right: viewport.width - rect.x - rect.width } : { left: rect.x }
 	};
 }
-//#endregion
-export { r as hostAnchorCss, n as hostAnchorRect };
 
+//#endregion
+export { hostAnchorCss, hostAnchorRect };
 //# sourceMappingURL=hostAnchor.js.map

package/dist/canvas/hostAnchor.js.map

@@ -1 +1 @@
-{"version":3,"file":"hostAnchor.js","names":["insetAlong","align","start","by","extent","size","hostAnchorRect","input","desired","host","panel","offset","clampRectWithin","viewport","padding","hostAnchorCss","rect"],"sources":["../../src/canvas/hostAnchor.ts"],"sourcesContent":["import { clampRectWithin, type PlacementAlign, type Rect } from '@weasel-js/geom';\n\n/** Which of the host's edges the panel is held against, per axis. */\nexport interface HostAnchorAlign {\n  x: PlacementAlign;\n  y: PlacementAlign;\n}\n\n/** Inset from the anchored corner, in CSS pixels, positive going inward. */\nexport interface HostAnchorOffset {\n  x: number;\n  y: number;\n}\n\n/** Everything {@link hostAnchorRect} needs, all in viewport coordinates. */\nexport interface HostAnchorInput {\n  host: Rect;\n  panel: { width: number; height: number };\n  viewport: { width: number; height: number };\n  align: HostAnchorAlign;\n  offset: HostAnchorOffset;\n  /** Minimum gap kept between the panel and the viewport edge. Default 0. */\n  padding?: number;\n}\n\nfunction insetAlong(start: number, extent: number, size: number, align: PlacementAlign, by: number): number {\n  if (align === 'start') return start + by;\n  if (align === 'end') return start + extent - size - by;\n  return start + (extent - size) / 2 + by;\n}\n\n/**\n * Where a fixed-position panel held against a host element's corner lands, once\n * it has been kept inside the viewport. Returns a rect rather than CSS so the\n * caller decides which edges to pin — see {@link hostAnchorCss}.\n */\nexport function hostAnchorRect(input: HostAnchorInput): Rect {\n  const { host, panel, viewport, align, offset, padding = 0 } = input;\n  const desired: Rect = {\n    x: insetAlong(host.x, host.width, panel.width, align.x, offset.x),\n    y: insetAlong(host.y, host.height, panel.height, align.y, offset.y),\n    width: panel.width,\n    height: panel.height,\n  };\n  return clampRectWithin(desired, { x: 0, y: 0, width: viewport.width, height: viewport.height }, padding);\n}\n\n/**\n * CSS for a resolved rect, pinning whichever edges the alignment names.\n *\n * Pinning matters beyond taste: a panel whose width tracks its content holds\n * the anchored edge still and grows away from it. Pin the wrong edge and the\n * anchored corner drifts on every content change, correcting only once a\n * resize observer catches up.\n */\nexport function hostAnchorCss(\n  rect: Rect,\n  align: HostAnchorAlign,\n  viewport: { width: number; height: number },\n): { top?: number; right?: number; bottom?: number; left?: number } {\n  return {\n    ...(align.y === 'end'\n      ? { bottom: viewport.height - rect.y - rect.height }\n      : { top: rect.y }),\n    ...(align.x === 'end'\n      ? { right: viewport.width - rect.x - rect.width }\n      : { left: rect.x }),\n  };\n}\n"],"mappings":";;AAyBA,SAASA,EAAW,GAAe,GAAgB,GAAc,GAAuB,GAAoB;CAG1G,OAFIC,MAAU,UAAgBC,IAAQC,IAClCF,MAAU,QAAcC,IAAQE,IAASC,IAAOF,IAC7CD,KAASE,IAASC,KAAQ,IAAIF;AACvC;AAOA,SAAgBG,EAAe,GAA8B;CAC3D,IAAM,EAAE,SAAM,UAAO,aAAU,UAAO,WAAQ,aAAU,MAAMC,GACxDC,IAAgB;EACpB,GAAGR,EAAWS,EAAK,GAAGA,EAAK,OAAOC,EAAM,OAAOT,EAAM,GAAGU,EAAO,CAAC;EAChE,GAAGX,EAAWS,EAAK,GAAGA,EAAK,QAAQC,EAAM,QAAQT,EAAM,GAAGU,EAAO,CAAC;EAClE,OAAOD,EAAM;EACb,QAAQA,EAAM;CAChB;CACA,OAAOE,EAAgBJ,GAAS;EAAE,GAAG;EAAG,GAAG;EAAG,OAAOK,EAAS;EAAO,QAAQA,EAAS;CAAO,GAAGC,CAAO;AACzG;AAUA,SAAgBC,EACd,GACA,GACA,GACkE;CAClE,OAAO;EACL,GAAId,EAAM,MAAM,QACZ,EAAE,QAAQY,EAAS,SAASG,EAAK,IAAIA,EAAK,OAAO,IACjD,EAAE,KAAKA,EAAK,EAAE;EAClB,GAAIf,EAAM,MAAM,QACZ,EAAE,OAAOY,EAAS,QAAQG,EAAK,IAAIA,EAAK,MAAM,IAC9C,EAAE,MAAMA,EAAK,EAAE;CACrB;AACF"}
+{"version":3,"file":"hostAnchor.js","names":[],"sources":["../../src/canvas/hostAnchor.ts"],"sourcesContent":["import { clampRectWithin, type PlacementAlign, type Rect } from '@weasel-js/geom';\n\n/** Which of the host's edges the panel is held against, per axis. */\nexport interface HostAnchorAlign {\n  x: PlacementAlign;\n  y: PlacementAlign;\n}\n\n/** Inset from the anchored corner, in CSS pixels, positive going inward. */\nexport interface HostAnchorOffset {\n  x: number;\n  y: number;\n}\n\n/** Everything {@link hostAnchorRect} needs, all in viewport coordinates. */\nexport interface HostAnchorInput {\n  host: Rect;\n  panel: { width: number; height: number };\n  viewport: { width: number; height: number };\n  align: HostAnchorAlign;\n  offset: HostAnchorOffset;\n  /** Minimum gap kept between the panel and the viewport edge. Default 0. */\n  padding?: number;\n}\n\nfunction insetAlong(start: number, extent: number, size: number, align: PlacementAlign, by: number): number {\n  if (align === 'start') return start + by;\n  if (align === 'end') return start + extent - size - by;\n  return start + (extent - size) / 2 + by;\n}\n\n/**\n * Where a fixed-position panel held against a host element's corner lands, once\n * it has been kept inside the viewport. Returns a rect rather than CSS so the\n * caller decides which edges to pin — see {@link hostAnchorCss}.\n */\nexport function hostAnchorRect(input: HostAnchorInput): Rect {\n  const { host, panel, viewport, align, offset, padding = 0 } = input;\n  const desired: Rect = {\n    x: insetAlong(host.x, host.width, panel.width, align.x, offset.x),\n    y: insetAlong(host.y, host.height, panel.height, align.y, offset.y),\n    width: panel.width,\n    height: panel.height,\n  };\n  return clampRectWithin(desired, { x: 0, y: 0, width: viewport.width, height: viewport.height }, padding);\n}\n\n/**\n * CSS for a resolved rect, pinning whichever edges the alignment names.\n *\n * Pinning matters beyond taste: a panel whose width tracks its content holds\n * the anchored edge still and grows away from it. Pin the wrong edge and the\n * anchored corner drifts on every content change, correcting only once a\n * resize observer catches up.\n */\nexport function hostAnchorCss(\n  rect: Rect,\n  align: HostAnchorAlign,\n  viewport: { width: number; height: number },\n): { top?: number; right?: number; bottom?: number; left?: number } {\n  return {\n    ...(align.y === 'end'\n      ? { bottom: viewport.height - rect.y - rect.height }\n      : { top: rect.y }),\n    ...(align.x === 'end'\n      ? { right: viewport.width - rect.x - rect.width }\n      : { left: rect.x }),\n  };\n}\n"],"mappings":";;;AAyBA,SAAS,WAAW,OAAe,QAAgB,MAAc,OAAuB,IAAoB;CAC1G,IAAI,UAAU,SAAS,OAAO,QAAQ;CACtC,IAAI,UAAU,OAAO,OAAO,QAAQ,SAAS,OAAO;CACpD,OAAO,SAAS,SAAS,QAAQ,IAAI;AACvC;;;;;;AAOA,SAAgB,eAAe,OAA8B;CAC3D,MAAM,EAAE,MAAM,OAAO,UAAU,OAAO,QAAQ,UAAU,MAAM;CAC9D,MAAM,UAAgB;EACpB,GAAG,WAAW,KAAK,GAAG,KAAK,OAAO,MAAM,OAAO,MAAM,GAAG,OAAO,CAAC;EAChE,GAAG,WAAW,KAAK,GAAG,KAAK,QAAQ,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC;EAClE,OAAO,MAAM;EACb,QAAQ,MAAM;CAChB;CACA,OAAO,gBAAgB,SAAS;EAAE,GAAG;EAAG,GAAG;EAAG,OAAO,SAAS;EAAO,QAAQ,SAAS;CAAO,GAAG,OAAO;AACzG;;;;;;;;;AAUA,SAAgB,cACd,MACA,OACA,UACkE;CAClE,OAAO;EACL,GAAI,MAAM,MAAM,QACZ,EAAE,QAAQ,SAAS,SAAS,KAAK,IAAI,KAAK,OAAO,IACjD,EAAE,KAAK,KAAK,EAAE;EAClB,GAAI,MAAM,MAAM,QACZ,EAAE,OAAO,SAAS,QAAQ,KAAK,IAAI,KAAK,MAAM,IAC9C,EAAE,MAAM,KAAK,EAAE;CACrB;AACF"}

package/dist/canvas/hud.module.js

@@ -1,18 +1,29 @@
 //#region src/canvas/hud.module.css
-var e = "_hud_4467cb", t = "_sized_4467cb", n = "_readings_4467cb _numeric_25fd0b", r = "_muted_4467cb", i = "_absent_4467cb", a = "_header_4467cb", o = "_list_4467cb", s = "_item_4467cb", c = "_itemBest_4467cb", l = "_row_4467cb", u = "_stack_4467cb", d = {
-	hud: e,
-	sized: t,
-	readings: n,
-	muted: r,
-	absent: i,
-	header: a,
-	list: o,
-	item: s,
-	itemBest: c,
-	row: l,
-	stack: u
+var hud = "_hud_4467cb";
+var sized = "_sized_4467cb";
+var readings = "_readings_4467cb _numeric_25fd0b";
+var muted = "_muted_4467cb";
+var absent = "_absent_4467cb";
+var header = "_header_4467cb";
+var list = "_list_4467cb";
+var item = "_item_4467cb";
+var itemBest = "_itemBest_4467cb";
+var row = "_row_4467cb";
+var stack = "_stack_4467cb";
+var hud_module_default = {
+	hud,
+	sized,
+	readings,
+	muted,
+	absent,
+	header,
+	list,
+	item,
+	itemBest,
+	row,
+	stack
 };
-//#endregion
-export { i as absent, d as default, a as header, e as hud, s as item, c as itemBest, o as list, r as muted, n as readings, l as row, t as sized, u as stack };
 
+//#endregion
+export { absent, hud_module_default as default, header, hud, item, itemBest, list, muted, readings, row, sized, stack };
 //# sourceMappingURL=hud.module.js.map

package/dist/canvas/hud.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"hud.module.js","names":["hud","sized","readings","muted","absent","header","list","item","itemBest","row","stack","hud_module_default"],"sources":["../../src/canvas/hud.module.css"],"sourcesContent":["/* The debug HUDs <Canvas> can draw: CursorCoordsHud, PickHud, ModalityHud. The\n   mono face is for the ids the pick and modality HUDs list; figures take the\n   numeric face, on a child so `.hud`'s own font cannot override it. */\n.hud {\n  position: fixed;\n  z-index: var(--wzl-z-hud, 900);\n  background: rgba(0, 0, 0, 0.7);\n  color: #e8e8e8;\n  font: 11px ui-monospace, SFMono-Regular, Menlo, monospace;\n  padding: var(--wzl-space-3, 6px) var(--wzl-space-4, 8px);\n  border-radius: 4px;\n  pointer-events: none;\n  line-height: 1.4;\n  text-align: right;\n}\n\n.sized {\n  min-width: 120px;\n  max-width: 260px;\n}\n\n.readings {\n  composes: numeric from '@weasel-js/theme/numeric.module.css';\n  display: grid;\n  grid-template-columns: auto auto;\n  column-gap: var(--wzl-space-4, 8px);\n  margin: 0;\n}\n\n.readings dt {\n  text-align: left;\n}\n\n.readings dd {\n  margin: 0;\n  white-space: nowrap;\n}\n\n.muted {\n  color: #888;\n}\n\n/* A value that is not there: an em dash, \"off-canvas\". */\n.absent {\n  color: #888;\n  font-style: italic;\n}\n\n.header {\n  margin-bottom: var(--wzl-space-1, 2px);\n}\n\n.list {\n  list-style: none;\n  margin: 0;\n  padding: 0;\n  display: flex;\n  flex-direction: column;\n  gap: 1px;\n}\n\n.item {\n  white-space: nowrap;\n  overflow: hidden;\n  text-overflow: ellipsis;\n}\n\n.itemBest {\n  font-weight: 700;\n}\n\n.row {\n  display: flex;\n  gap: var(--wzl-space-4, 8px);\n  justify-content: flex-end;\n  white-space: nowrap;\n}\n\n.stack {\n  display: flex;\n  flex-direction: column;\n  align-items: flex-end;\n}\n"],"mappings":""}
+{"version":3,"file":"hud.module.js","names":[],"sources":["../../src/canvas/hud.module.css"],"sourcesContent":["/* The debug HUDs <Canvas> can draw: CursorCoordsHud, PickHud, ModalityHud. The\n   mono face is for the ids the pick and modality HUDs list; figures take the\n   numeric face, on a child so `.hud`'s own font cannot override it. */\n.hud {\n  position: fixed;\n  z-index: var(--wzl-z-hud, 900);\n  background: rgba(0, 0, 0, 0.7);\n  color: #e8e8e8;\n  font: 11px ui-monospace, SFMono-Regular, Menlo, monospace;\n  padding: var(--wzl-space-3, 6px) var(--wzl-space-4, 8px);\n  border-radius: 4px;\n  pointer-events: none;\n  line-height: 1.4;\n  text-align: right;\n}\n\n.sized {\n  min-width: 120px;\n  max-width: 260px;\n}\n\n.readings {\n  composes: numeric from '@weasel-js/theme/numeric.module.css';\n  display: grid;\n  grid-template-columns: auto auto;\n  column-gap: var(--wzl-space-4, 8px);\n  margin: 0;\n}\n\n.readings dt {\n  text-align: left;\n}\n\n.readings dd {\n  margin: 0;\n  white-space: nowrap;\n}\n\n.muted {\n  color: #888;\n}\n\n/* A value that is not there: an em dash, \"off-canvas\". */\n.absent {\n  color: #888;\n  font-style: italic;\n}\n\n.header {\n  margin-bottom: var(--wzl-space-1, 2px);\n}\n\n.list {\n  list-style: none;\n  margin: 0;\n  padding: 0;\n  display: flex;\n  flex-direction: column;\n  gap: 1px;\n}\n\n.item {\n  white-space: nowrap;\n  overflow: hidden;\n  text-overflow: ellipsis;\n}\n\n.itemBest {\n  font-weight: 700;\n}\n\n.row {\n  display: flex;\n  gap: var(--wzl-space-4, 8px);\n  justify-content: flex-end;\n  white-space: nowrap;\n}\n\n.stack {\n  display: flex;\n  flex-direction: column;\n  align-items: flex-end;\n}\n"],"mappings":""}