@weasel-js/core 1.14.2 → 1.15.1

package/dist/canvas/scenePickSource.js

@@ -1,14 +1,14 @@
-import { planeMap } from "../core/viewport/parallax.js";
-import { resolveDerivedPath } from "../core/scene/derivedPath.js";
-import { nodeAsShown, nodesAsShown } from "../core/scene/nodeAsShown.js";
 import { asNodeId } from "../core/scene/types.js";
+import { resolveDerivedPath } from "../core/scene/derivedPath.js";
 import { annotationLayerIds } from "../core/scene/annotation.js";
 import { nodeGates } from "../core/scene/nodeGates.js";
+import { planeMap } from "../core/viewport/parallax.js";
 import { scenePaintedPoseOf } from "./derivedPath.js";
-import { sceneParentsOf, sceneShownPathOf } from "./scenePickReads.js";
 import { indexedCandidates } from "./pickIndex/scenePickIndex.js";
+import { sceneParentsOf, sceneShownPathOf } from "./scenePickReads.js";
+import { nodeAsShown, nodesAsShown } from "../core/scene/nodeAsShown.js";
 
-//#region src/canvas/scenePickSource.ts
+// src/canvas/scenePickSource.ts
 function scenePickSource(scene, opts = {}) {
 	const gates = nodeGates(scene);
 	const enumerable = typeof scene.overrides?.ids === "function";
@@ -54,8 +54,8 @@ function scenePickSource(scene, opts = {}) {
 		poseOf,
 		parentsOf: sceneParentsOf(scene),
 		...readAlpha ? { alphaOf: readAlpha } : {},
-		isLocked: (node) => gates.locked(node.id),
-		isHidden: (node) => gates.hidden(node.id),
+		isLocked: (node) => gates.locked(node),
+		isHidden: (node) => gates.hidden(node),
 		...annotations.size > 0 || layerIsPainted ? { layerIsPainted: (layer) => !annotations.has(layer) && (layerIsPainted === void 0 || layerIsPainted(layer)) } : {}
 	};
 }
@@ -69,6 +69,5 @@ function scenePlaneOf(layers, camera) {
 	return (layer) => found.get(layer) ?? null;
 }
 
-//#endregion
 export { scenePickSource, scenePlaneOf };
 //# sourceMappingURL=scenePickSource.js.map

package/dist/canvas/scenePickSource.js.map

@@ -1 +1 @@
-{"version":3,"file":"scenePickSource.js","names":[],"sources":["../../src/canvas/scenePickSource.ts"],"sourcesContent":["/** The pick source over a `Scene`: its render order, painted poses and gates,\n *  and, given a descriptor, the pick index that narrows the walk. */\nimport type { Path } from '@weasel-js/geom';\nimport type { DerivedDep, Node, NodeId, Scene } from 'core/scene/types';\nimport { asNodeId } from 'core/scene/types';\nimport { annotationLayerIds } from 'core/scene/annotation';\nimport { nodeGates } from 'core/scene/nodeGates';\nimport { planeMap, type ParallaxOpts, type PlaneMap } from 'core/viewport/parallax';\nimport type { View } from 'core/viewport/view';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport { resolveDerivedPath, scenePaintedPoseOf } from './derivedPath';\nimport { indexedCandidates } from './pickIndex/scenePickIndex';\nimport type { PickBroad, PickCandidate, PickSource, ViewPickGates } from './pickWalk';\nimport { sceneParentsOf, sceneShownPathOf } from './scenePickReads';\nimport { nodeAsShown, nodesAsShown } from 'core/scene/nodeAsShown';\n\nexport interface ScenePickSourceOptions<TPose> extends ViewPickGates {\n  /** Pose lookup, when the caller holds an adapter that already resolves\n   *  overrides. Defaults to `effectivePose` against the scene's own. */\n  getPose?: (id: string) => TPose;\n  /** The asking view's composed alpha — `alphaFor(id)` times override alpha.\n   *  Defaults to the override alpha alone, which is all a bare scene knows. */\n  alphaOf?: (id: string) => number;\n  /** The asking view's answer to \"does this scene layer reach the screen\",\n   *  which is `layerVisibility` and `layerOrder` on top of the scene's own\n   *  `visible` flag. Consulted after the scene's flag, never instead of it. */\n  layerIsPainted?: (layer: string) => boolean;\n  /** The asking view's camera. With it, a layer carrying `parallax` is picked\n   *  through its plane; without it, every layer is taken to move with the\n   *  camera. */\n  camera?: View;\n  /** Box every node once per scene change, so a query carrying a `broad` box\n   *  visits only the nodes it can hit. `descriptor` must be the one the\n   *  query reads poses through. */\n  index?: { descriptor: PoseDescriptor<unknown> };\n}\n\nexport function scenePickSource<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  opts: ScenePickSourceOptions<TPose> = {},\n): PickSource<TPose> {\n  // Partial scene stand-ins carry only `layers` and `get`, which is all the gates read.\n  const gates = nodeGates(scene as never);\n  const enumerable = typeof scene.overrides?.ids === 'function';\n  // Pick candidates carry a plain string id; the scene answers them all the same.\n  const asShown = <N extends { id: string; data?: unknown }>(node: N): N =>\n    (scene.overrides ? nodeAsShown(scene.overrides, node as N & { id: NodeId }) : node);\n  const allAsShown = <N extends { id: string; data?: unknown }>(nodes: readonly N[]): readonly N[] =>\n    (enumerable ? nodesAsShown(scene.overrides, nodes as readonly (N & { id: NodeId })[]) : nodes.map(asShown));\n  const annotations = annotationLayerIds(scene.layers);\n  const { getPose, alphaOf, layerIsPainted } = opts;\n\n  // Resolved once per walk rather than once per candidate. Needs enumeration — a\n  // partial scene stand-in carrying only `read` falls back to reading per node.\n  let faded: Set<string> | null = null;\n  if (!alphaOf && enumerable) {\n    for (const id of scene.overrides.ids()) {\n      const a = scene.overrides.read(id)?.alpha;\n      if (a !== undefined && a <= 0) (faded ??= new Set()).add(id);\n    }\n  }\n  const readAlpha = alphaOf\n    ?? (enumerable\n      ? (faded ? (id: string) => (faded.has(id) ? 0 : 1) : undefined)\n      : (id: string) => scene.overrides.read(asNodeId(id))?.alpha ?? 1);\n\n  // A composing strategy makes a node's own pose local, so picking folds the\n  // parent chain the same way the render walk does: one definition of both.\n  const paintedPoseOf = scenePaintedPoseOf(scene);\n  const poseOf = getPose\n    ? (node: PickCandidate<TPose>) => getPose(node.id)\n    : (node: PickCandidate<TPose>) => paintedPoseOf(node as never);\n\n  // Through `poseOf`, not the document pose: a derived node has to be tested\n  // where the renderer draws its dependencies, which is what an override says.\n  const childrenOf = (id: NodeId): readonly NodeId[] => scene.childrenOf(id);\n  const depOf = (id: NodeId): DerivedDep<TPose> | undefined => {\n    const stored = scene.get(id);\n    if (stored === undefined) return undefined;\n    const dep = asShown(stored);\n    return {\n      node: dep as Node<unknown, string, TPose>,\n      pose: poseOf(dep as never),\n      get path(): Path | null {\n        return resolveDerivedPath(dep as never, depOf, childrenOf);\n      },\n    };\n  };\n\n  const derivedPathOf = getPose\n    ? (node: PickCandidate<TPose>): Path | null => {\n      const n = node as unknown as Node<TData, TLayer, TPose>;\n      return n.dependsOn === undefined ? null : resolveDerivedPath(n, depOf, childrenOf);\n    }\n    : sceneShownPathOf(scene);\n\n  const planeOf = opts.camera ? scenePlaneOf(scene.layers, opts.camera) : null;\n\n  // The index boxes nodes at the scene's painted poses; a custom `getPose` must be shown to agree first.\n  // A partial stand-in has no versions for it to key on.\n  const index = getPose || typeof scene.getVersion !== 'function' ? undefined : opts.index;\n  return {\n    ...(planeOf ? { planeOf } : {}),\n    ...(index ? {\n      candidates: (broadFor: (layer: string | undefined) => PickBroad | null | undefined) => {\n        const found = indexedCandidates(scene as never, index.descriptor, broadFor) as readonly PickCandidate<TPose>[] | null;\n        return found === null ? null : allAsShown(found);\n      },\n    } : {}),\n    order: () => allAsShown(scene.renderOrderNodes() as unknown as readonly PickCandidate<TPose>[]),\n    derivedPathOf,\n    poseOf,\n    parentsOf: sceneParentsOf(scene),\n    // Absent entirely when nothing is faded, so the walk skips the gate.\n    ...(readAlpha ? { alphaOf: readAlpha } : {}),\n    isLocked: (node: PickCandidate<TPose>) => gates.locked(node.id),\n    isHidden: (node: PickCandidate<TPose>) => gates.hidden(node.id),\n    ...(annotations.size > 0 || layerIsPainted\n      ? {\n        layerIsPainted: (layer: string) =>\n          !annotations.has(layer) && (layerIsPainted === undefined || layerIsPainted(layer)),\n      }\n      : {}),\n  };\n}\n\n/** Each parallax layer's plane map under `camera`, or null when no layer is a\n *  plane — which keeps the per-layer lookup off the walk entirely. */\nexport function scenePlaneOf(\n  layers: readonly { id: string; parallax?: ParallaxOpts }[] | undefined,\n  camera: View,\n): ((layer: string) => PlaneMap | null) | null {\n  let maps: Map<string, PlaneMap> | null = null;\n  for (const l of layers ?? []) {\n    if (l.parallax) (maps ??= new Map()).set(l.id, planeMap(camera, l.parallax));\n  }\n  if (maps === null) return null;\n  const found = maps;\n  return (layer) => found.get(layer) ?? null;\n}\n"],"mappings":";;;;;;;;;;;AAqCA,SAAgB,gBACd,OACA,OAAsC,CAAC,GACpB;CAEnB,MAAM,QAAQ,UAAU,KAAc;CACtC,MAAM,aAAa,OAAO,MAAM,WAAW,QAAQ;CAEnD,MAAM,WAAqD,SACxD,MAAM,YAAY,YAAY,MAAM,WAAW,IAA0B,IAAI;CAChF,MAAM,cAAwD,UAC3D,aAAa,aAAa,MAAM,WAAW,KAAwC,IAAI,MAAM,IAAI,OAAO;CAC3G,MAAM,cAAc,mBAAmB,MAAM,MAAM;CACnD,MAAM,EAAE,SAAS,SAAS,mBAAmB;CAI7C,IAAI,QAA4B;CAChC,IAAI,CAAC,WAAW,YACd,KAAK,MAAM,MAAM,MAAM,UAAU,IAAI,GAAG;EACtC,MAAM,IAAI,MAAM,UAAU,KAAK,EAAE,CAAC,EAAE;EACpC,IAAI,MAAM,UAAa,KAAK,GAAG,CAAC,0BAAU,IAAI,IAAI,EAAA,CAAG,IAAI,EAAE;CAC7D;CAEF,MAAM,YAAY,YACZ,aACC,SAAS,OAAgB,MAAM,IAAI,EAAE,IAAI,IAAI,IAAK,UAClD,OAAe,MAAM,UAAU,KAAK,SAAS,EAAE,CAAC,CAAC,EAAE,SAAS;CAInE,MAAM,gBAAgB,mBAAmB,KAAK;CAC9C,MAAM,SAAS,WACV,SAA+B,QAAQ,KAAK,EAAE,KAC9C,SAA+B,cAAc,IAAa;CAI/D,MAAM,cAAc,OAAkC,MAAM,WAAW,EAAE;CACzE,MAAM,SAAS,OAA8C;EAC3D,MAAM,SAAS,MAAM,IAAI,EAAE;EAC3B,IAAI,WAAW,QAAW,OAAO;EACjC,MAAM,MAAM,QAAQ,MAAM;EAC1B,OAAO;GACL,MAAM;GACN,MAAM,OAAO,GAAY;GACzB,IAAI,OAAoB;IACtB,OAAO,mBAAmB,KAAc,OAAO,UAAU;GAC3D;EACF;CACF;CAEA,MAAM,gBAAgB,WACjB,SAA4C;EAC7C,MAAM,IAAI;EACV,OAAO,EAAE,cAAc,SAAY,OAAO,mBAAmB,GAAG,OAAO,UAAU;CACnF,IACE,iBAAiB,KAAK;CAE1B,MAAM,UAAU,KAAK,SAAS,aAAa,MAAM,QAAQ,KAAK,MAAM,IAAI;CAIxE,MAAM,QAAQ,WAAW,OAAO,MAAM,eAAe,aAAa,SAAY,KAAK;CACnF,OAAO;EACL,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;EAC7B,GAAI,QAAQ,EACV,aAAa,aAA0E;GACrF,MAAM,QAAQ,kBAAkB,OAAgB,MAAM,YAAY,QAAQ;GAC1E,OAAO,UAAU,OAAO,OAAO,WAAW,KAAK;EACjD,EACF,IAAI,CAAC;EACL,aAAa,WAAW,MAAM,iBAAiB,CAA+C;EAC9F;EACA;EACA,WAAW,eAAe,KAAK;EAE/B,GAAI,YAAY,EAAE,SAAS,UAAU,IAAI,CAAC;EAC1C,WAAW,SAA+B,MAAM,OAAO,KAAK,EAAE;EAC9D,WAAW,SAA+B,MAAM,OAAO,KAAK,EAAE;EAC9D,GAAI,YAAY,OAAO,KAAK,iBACxB,EACA,iBAAiB,UACf,CAAC,YAAY,IAAI,KAAK,MAAM,mBAAmB,UAAa,eAAe,KAAK,GACpF,IACE,CAAC;CACP;AACF;;;AAIA,SAAgB,aACd,QACA,QAC6C;CAC7C,IAAI,OAAqC;CACzC,KAAK,MAAM,KAAK,UAAU,CAAC,GACzB,IAAI,EAAE,UAAU,CAAC,yBAAS,IAAI,IAAI,EAAA,CAAG,IAAI,EAAE,IAAI,SAAS,QAAQ,EAAE,QAAQ,CAAC;CAE7E,IAAI,SAAS,MAAM,OAAO;CAC1B,MAAM,QAAQ;CACd,QAAQ,UAAU,MAAM,IAAI,KAAK,KAAK;AACxC"}
+{"version":3,"file":"scenePickSource.js","names":[],"sources":["../../src/canvas/scenePickSource.ts"],"sourcesContent":["/** The pick source over a `Scene`: its render order, painted poses and gates,\n *  and, given a descriptor, the pick index that narrows the walk. */\nimport type { Path } from '@weasel-js/geom';\nimport type { DerivedDep, Node, NodeId, Scene } from 'core/scene/types';\nimport { asNodeId } from 'core/scene/types';\nimport { annotationLayerIds } from 'core/scene/annotation';\nimport { nodeGates, type GatedNode } from 'core/scene/nodeGates';\nimport { planeMap, type ParallaxOpts, type PlaneMap } from 'core/viewport/parallax';\nimport type { View } from 'core/viewport/view';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport { resolveDerivedPath, scenePaintedPoseOf } from './derivedPath';\nimport { indexedCandidates } from './pickIndex/scenePickIndex';\nimport type { PickBroad, PickCandidate, PickSource, ViewPickGates } from './pickWalk';\nimport { sceneParentsOf, sceneShownPathOf } from './scenePickReads';\nimport { nodeAsShown, nodesAsShown } from 'core/scene/nodeAsShown';\n\nexport interface ScenePickSourceOptions<TPose> extends ViewPickGates {\n  /** Pose lookup, when the caller holds an adapter that already resolves\n   *  overrides. Defaults to `effectivePose` against the scene's own. */\n  getPose?: (id: string) => TPose;\n  /** The asking view's composed alpha — `alphaFor(id)` times override alpha.\n   *  Defaults to the override alpha alone, which is all a bare scene knows. */\n  alphaOf?: (id: string) => number;\n  /** The asking view's answer to \"does this scene layer reach the screen\",\n   *  which is `layerVisibility` and `layerOrder` on top of the scene's own\n   *  `visible` flag. Consulted after the scene's flag, never instead of it. */\n  layerIsPainted?: (layer: string) => boolean;\n  /** The asking view's camera. With it, a layer carrying `parallax` is picked\n   *  through its plane; without it, every layer is taken to move with the\n   *  camera. */\n  camera?: View;\n  /** Box every node once per scene change, so a query carrying a `broad` box\n   *  visits only the nodes it can hit. `descriptor` must be the one the\n   *  query reads poses through. */\n  index?: { descriptor: PoseDescriptor<unknown> };\n}\n\nexport function scenePickSource<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  opts: ScenePickSourceOptions<TPose> = {},\n): PickSource<TPose> {\n  // Partial scene stand-ins carry only `layers` and `get`, which is all the gates read.\n  const gates = nodeGates(scene as never);\n  const enumerable = typeof scene.overrides?.ids === 'function';\n  // Pick candidates carry a plain string id; the scene answers them all the same.\n  const asShown = <N extends { id: string; data?: unknown }>(node: N): N =>\n    (scene.overrides ? nodeAsShown(scene.overrides, node as N & { id: NodeId }) : node);\n  const allAsShown = <N extends { id: string; data?: unknown }>(nodes: readonly N[]): readonly N[] =>\n    (enumerable ? nodesAsShown(scene.overrides, nodes as readonly (N & { id: NodeId })[]) : nodes.map(asShown));\n  const annotations = annotationLayerIds(scene.layers);\n  const { getPose, alphaOf, layerIsPainted } = opts;\n\n  // Resolved once per walk rather than once per candidate. Needs enumeration — a\n  // partial scene stand-in carrying only `read` falls back to reading per node.\n  let faded: Set<string> | null = null;\n  if (!alphaOf && enumerable) {\n    for (const id of scene.overrides.ids()) {\n      const a = scene.overrides.read(id)?.alpha;\n      if (a !== undefined && a <= 0) (faded ??= new Set()).add(id);\n    }\n  }\n  const readAlpha = alphaOf\n    ?? (enumerable\n      ? (faded ? (id: string) => (faded.has(id) ? 0 : 1) : undefined)\n      : (id: string) => scene.overrides.read(asNodeId(id))?.alpha ?? 1);\n\n  // A composing strategy makes a node's own pose local, so picking folds the\n  // parent chain the same way the render walk does: one definition of both.\n  const paintedPoseOf = scenePaintedPoseOf(scene);\n  const poseOf = getPose\n    ? (node: PickCandidate<TPose>) => getPose(node.id)\n    : (node: PickCandidate<TPose>) => paintedPoseOf(node as never);\n\n  // Through `poseOf`, not the document pose: a derived node has to be tested\n  // where the renderer draws its dependencies, which is what an override says.\n  const childrenOf = (id: NodeId): readonly NodeId[] => scene.childrenOf(id);\n  const depOf = (id: NodeId): DerivedDep<TPose> | undefined => {\n    const stored = scene.get(id);\n    if (stored === undefined) return undefined;\n    const dep = asShown(stored);\n    return {\n      node: dep as Node<unknown, string, TPose>,\n      pose: poseOf(dep as never),\n      get path(): Path | null {\n        return resolveDerivedPath(dep as never, depOf, childrenOf);\n      },\n    };\n  };\n\n  const derivedPathOf = getPose\n    ? (node: PickCandidate<TPose>): Path | null => {\n      const n = node as unknown as Node<TData, TLayer, TPose>;\n      return n.dependsOn === undefined ? null : resolveDerivedPath(n, depOf, childrenOf);\n    }\n    : sceneShownPathOf(scene);\n\n  const planeOf = opts.camera ? scenePlaneOf(scene.layers, opts.camera) : null;\n\n  // The index boxes nodes at the scene's painted poses; a custom `getPose` must be shown to agree first.\n  // A partial stand-in has no versions for it to key on.\n  const index = getPose || typeof scene.getVersion !== 'function' ? undefined : opts.index;\n  return {\n    ...(planeOf ? { planeOf } : {}),\n    ...(index ? {\n      candidates: (broadFor: (layer: string | undefined) => PickBroad | null | undefined) => {\n        const found = indexedCandidates(scene as never, index.descriptor, broadFor) as readonly PickCandidate<TPose>[] | null;\n        return found === null ? null : allAsShown(found);\n      },\n    } : {}),\n    order: () => allAsShown(scene.renderOrderNodes() as unknown as readonly PickCandidate<TPose>[]),\n    derivedPathOf,\n    poseOf,\n    parentsOf: sceneParentsOf(scene),\n    // Absent entirely when nothing is faded, so the walk skips the gate.\n    ...(readAlpha ? { alphaOf: readAlpha } : {}),\n    isLocked: (node: PickCandidate<TPose>) => gates.locked(node as GatedNode),\n    isHidden: (node: PickCandidate<TPose>) => gates.hidden(node as GatedNode),\n    ...(annotations.size > 0 || layerIsPainted\n      ? {\n        layerIsPainted: (layer: string) =>\n          !annotations.has(layer) && (layerIsPainted === undefined || layerIsPainted(layer)),\n      }\n      : {}),\n  };\n}\n\n/** Each parallax layer's plane map under `camera`, or null when no layer is a\n *  plane — which keeps the per-layer lookup off the walk entirely. */\nexport function scenePlaneOf(\n  layers: readonly { id: string; parallax?: ParallaxOpts }[] | undefined,\n  camera: View,\n): ((layer: string) => PlaneMap | null) | null {\n  let maps: Map<string, PlaneMap> | null = null;\n  for (const l of layers ?? []) {\n    if (l.parallax) (maps ??= new Map()).set(l.id, planeMap(camera, l.parallax));\n  }\n  if (maps === null) return null;\n  const found = maps;\n  return (layer) => found.get(layer) ?? null;\n}\n"],"mappings":";;;;;;;;;;;AAqCA,SAAgB,gBACd,OACA,OAAsC,CAAC,GACpB;CAEnB,MAAM,QAAQ,UAAU,KAAc;CACtC,MAAM,aAAa,OAAO,MAAM,WAAW,QAAQ;CAEnD,MAAM,WAAqD,SACxD,MAAM,YAAY,YAAY,MAAM,WAAW,IAA0B,IAAI;CAChF,MAAM,cAAwD,UAC3D,aAAa,aAAa,MAAM,WAAW,KAAwC,IAAI,MAAM,IAAI,OAAO;CAC3G,MAAM,cAAc,mBAAmB,MAAM,MAAM;CACnD,MAAM,EAAE,SAAS,SAAS,mBAAmB;CAI7C,IAAI,QAA4B;CAChC,IAAI,CAAC,WAAW,YACd,KAAK,MAAM,MAAM,MAAM,UAAU,IAAI,GAAG;EACtC,MAAM,IAAI,MAAM,UAAU,KAAK,EAAE,CAAC,EAAE;EACpC,IAAI,MAAM,UAAa,KAAK,GAAG,CAAC,0BAAU,IAAI,IAAI,EAAA,CAAG,IAAI,EAAE;CAC7D;CAEF,MAAM,YAAY,YACZ,aACC,SAAS,OAAgB,MAAM,IAAI,EAAE,IAAI,IAAI,IAAK,UAClD,OAAe,MAAM,UAAU,KAAK,SAAS,EAAE,CAAC,CAAC,EAAE,SAAS;CAInE,MAAM,gBAAgB,mBAAmB,KAAK;CAC9C,MAAM,SAAS,WACV,SAA+B,QAAQ,KAAK,EAAE,KAC9C,SAA+B,cAAc,IAAa;CAI/D,MAAM,cAAc,OAAkC,MAAM,WAAW,EAAE;CACzE,MAAM,SAAS,OAA8C;EAC3D,MAAM,SAAS,MAAM,IAAI,EAAE;EAC3B,IAAI,WAAW,QAAW,OAAO;EACjC,MAAM,MAAM,QAAQ,MAAM;EAC1B,OAAO;GACL,MAAM;GACN,MAAM,OAAO,GAAY;GACzB,IAAI,OAAoB;IACtB,OAAO,mBAAmB,KAAc,OAAO,UAAU;GAC3D;EACF;CACF;CAEA,MAAM,gBAAgB,WACjB,SAA4C;EAC7C,MAAM,IAAI;EACV,OAAO,EAAE,cAAc,SAAY,OAAO,mBAAmB,GAAG,OAAO,UAAU;CACnF,IACE,iBAAiB,KAAK;CAE1B,MAAM,UAAU,KAAK,SAAS,aAAa,MAAM,QAAQ,KAAK,MAAM,IAAI;CAIxE,MAAM,QAAQ,WAAW,OAAO,MAAM,eAAe,aAAa,SAAY,KAAK;CACnF,OAAO;EACL,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;EAC7B,GAAI,QAAQ,EACV,aAAa,aAA0E;GACrF,MAAM,QAAQ,kBAAkB,OAAgB,MAAM,YAAY,QAAQ;GAC1E,OAAO,UAAU,OAAO,OAAO,WAAW,KAAK;EACjD,EACF,IAAI,CAAC;EACL,aAAa,WAAW,MAAM,iBAAiB,CAA+C;EAC9F;EACA;EACA,WAAW,eAAe,KAAK;EAE/B,GAAI,YAAY,EAAE,SAAS,UAAU,IAAI,CAAC;EAC1C,WAAW,SAA+B,MAAM,OAAO,IAAiB;EACxE,WAAW,SAA+B,MAAM,OAAO,IAAiB;EACxE,GAAI,YAAY,OAAO,KAAK,iBACxB,EACA,iBAAiB,UACf,CAAC,YAAY,IAAI,KAAK,MAAM,mBAAmB,UAAa,eAAe,KAAK,GACpF,IACE,CAAC;CACP;AACF;;;AAIA,SAAgB,aACd,QACA,QAC6C;CAC7C,IAAI,OAAqC;CACzC,KAAK,MAAM,KAAK,UAAU,CAAC,GACzB,IAAI,EAAE,UAAU,CAAC,yBAAS,IAAI,IAAI,EAAA,CAAG,IAAI,EAAE,IAAI,SAAS,QAAQ,EAAE,QAAQ,CAAC;CAE7E,IAAI,SAAS,MAAM,OAAO;CAC1B,MAAM,QAAQ;CACd,QAAQ,UAAU,MAAM,IAAI,KAAK,KAAK;AACxC"}

package/dist/canvas/sceneSlotWiring.js

@@ -1,10 +1,10 @@
-import { nodeAsShown, shownLookup } from "../core/scene/nodeAsShown.js";
 import { withInheritedPaintBounds, withInheritedPaints } from "./inheritedPaints.js";
 import { sceneDerivedPathOf, sceneShownToPose, withDerivedPaths } from "./derivedPath.js";
 import { withColorOverrides } from "./colorOverrides.js";
+import { nodeAsShown, shownLookup } from "../core/scene/nodeAsShown.js";
 import { withShownNode } from "./shownNodes.js";
 
-//#region src/canvas/sceneSlotWiring.ts
+// src/canvas/sceneSlotWiring.ts
 /**
 * The alpha a view paints a node at: the view's own `alphaFor` times any
 * ephemeral override alpha.
@@ -32,6 +32,5 @@ function wireSceneSlotToScene(slot, scene, alphaFor, colorOverrides) {
 	};
 }
 
-//#endregion
 export { composeAlphaFor, wireSceneSlotToScene };
 //# sourceMappingURL=sceneSlotWiring.js.map

package/dist/canvas/sceneViewRender.js

@@ -1,19 +1,19 @@
-import { nodeAsShown, shownLookup } from "../core/scene/nodeAsShown.js";
-import { withInheritedPaintBounds, withInheritedPaints } from "./inheritedPaints.js";
-import { paintedSceneLayers } from "./sceneLayerPaint.js";
 import { paintCanvas, resolveDpr } from "./canvasRenderer.js";
 import { wrapNodeOutput } from "./wrapNodeOutput.js";
-import { sceneDerivedPathOf, withDerivedPaths } from "./derivedPath.js";
 import { buildSceneTree } from "./buildSceneTree.js";
 import { sceneToAdapter } from "./sceneAdapter.js";
+import { withInheritedPaintBounds, withInheritedPaints } from "./inheritedPaints.js";
+import { sceneDerivedPathOf, withDerivedPaths } from "./derivedPath.js";
 import { withColorOverrides } from "./colorOverrides.js";
+import { paintedSceneLayers } from "./sceneLayerPaint.js";
 import { paintMissesView } from "./paintCull.js";
 import { paintBoundsFor } from "./defaultDrawOne.js";
+import { nodeAsShown, shownLookup } from "../core/scene/nodeAsShown.js";
 import { withShownNode } from "./shownNodes.js";
 import { cullDrawCommands } from "@weasel-js/renderer";
 import { viewToMat3 as viewToMat3$1 } from "@weasel-js/geom";
 
-//#region src/canvas/sceneViewRender.ts
+// src/canvas/sceneViewRender.ts
 /**
 * Present a `Scene` as the reading surface `buildSceneTree` walks: the scene
 * adapter's own reads, under this view's layer list.
@@ -104,6 +104,5 @@ function renderSceneToCanvas(args) {
 	});
 }
 
-//#endregion
 export { buildSceneViewCommands, renderSceneToCanvas, sceneViewFrame };
 //# sourceMappingURL=sceneViewRender.js.map

package/dist/canvas/shownNodes.js

@@ -1,6 +1,6 @@
 import { nodeAsShown } from "../core/scene/nodeAsShown.js";
 
-//#region src/canvas/shownNodes.ts
+// src/canvas/shownNodes.ts
 /**
 * The scene walks' half of `PoseOverride.data`: handing painters and cull
 * bounds each node as the scene shows it, through `nodeAsShown`.
@@ -10,6 +10,5 @@ function withShownNode(overrides, fn) {
 	return (node, a, b, c) => fn(nodeAsShown(overrides, node), a, b, c);
 }
 
-//#endregion
 export { withShownNode };
 //# sourceMappingURL=shownNodes.js.map

package/dist/canvas/slopsDebugLayer.js

@@ -2,7 +2,7 @@ import { pointRegionLive, pointRegionScreenQuad, transformOf } from "../affordan
 import { chromeStateFrom, isVisibleFrom } from "./drawEnvelope.js";
 import { PATH_L, PATH_M, PATH_Z } from "@weasel-js/geom";
 
-//#region src/canvas/slopsDebugLayer.ts
+// src/canvas/slopsDebugLayer.ts
 var SLOP_FILL = "rgba(255, 80, 140, 0.18)";
 var SLOP_STROKE = "rgba(255, 80, 140, 0.55)";
 function createSlopsDebugLayer(opts) {
@@ -65,6 +65,5 @@ function createSlopsDebugLayer(opts) {
 	};
 }
 
-//#endregion
 export { createSlopsDebugLayer };
 //# sourceMappingURL=slopsDebugLayer.js.map

package/dist/canvas/surfaceContribution.js

@@ -1,6 +1,6 @@
 import { mergeContributions } from "@weasel-js/routing";
 
-//#region src/canvas/surfaceContribution.ts
+// src/canvas/surfaceContribution.ts
 /**
 * The canvas's unit of extension: a routing `Contribution` plus the roles only
 * a surface can install — views on it, and whatever else needs the mounted
@@ -26,6 +26,5 @@ function claimIds(entries, kind, of) {
 	}
 }
 
-//#endregion
 export { mergeContributions$1 as mergeContributions };
 //# sourceMappingURL=surfaceContribution.js.map

package/dist/canvas/useCanvasElements.js

@@ -1,7 +1,7 @@
 import { useCallback, useInsertionEffect, useRef } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/useCanvasElements.ts
+// src/canvas/useCanvasElements.ts
 function useCanvasElements(paintInto, inputElement) {
 	const canvasRef = useRef(null);
 	const ownCanvasRef = useRef(null);
@@ -26,6 +26,5 @@ function useCanvasElements(paintInto, inputElement) {
 	};
 }
 
-//#endregion
 export { useCanvasElements };
 //# sourceMappingURL=useCanvasElements.js.map

package/dist/canvas/useCanvasHandle.js

@@ -1,6 +1,6 @@
 import { useCallback, useImperativeHandle } from "react";
 
-//#region src/canvas/useCanvasHandle.ts
+// src/canvas/useCanvasHandle.ts
 /** The bare canvas's imperative handle. Its own-frame members answer against `frame`. */
 function useCanvasHandle(ref, target, frame, api) {
 	const { canvasRef, ownCanvasRef, detached, paintRectRef, inputElement, paintCanvas } = target;
@@ -64,6 +64,5 @@ function useCanvasHandle(ref, target, frame, api) {
 	]);
 }
 
-//#endregion
 export { useCanvasHandle };
 //# sourceMappingURL=useCanvasHandle.js.map

package/dist/canvas/useCanvasPaint.js

@@ -1,14 +1,14 @@
 import { DEFAULT_LAYER_RETAIN } from "../core/layers/retain.js";
 import { drawLayers } from "../core/layers/render.js";
-import { resolveDpr } from "./canvasRenderer.js";
 import { beginDebugFrame } from "../debug/useDebugSink.js";
+import { resolveDpr } from "./canvasRenderer.js";
 import { NO_LAYER_VISIBILITY } from "./useExtraLayers.js";
 import { ViewSnap } from "./viewSnap.js";
 import { viewToMat3 } from "@weasel-js/renderer";
 import { useCallback, useEffect, useInsertionEffect, useRef } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/useCanvasPaint.ts
+// src/canvas/useCanvasPaint.ts
 /**
 * Which content version the last paint showed. `markPainted` records the current one, read
 * from `contentVersion`'s latest committed value.
@@ -95,6 +95,5 @@ function useCanvasPaint(paintRef, lease, target, frame, markPainted, requestRedr
 	}, []);
 }
 
-//#endregion
 export { useCanvasPaint, usePaintedVersion };
 //# sourceMappingURL=useCanvasPaint.js.map

package/dist/canvas/useCanvasRenderer.js

@@ -3,7 +3,7 @@ import { leaseCanvasRenderer, shaderKeyOf } from "./canvasRenderer.js";
 import { getProgramSource, programSourceRegistry } from "@weasel-js/renderer";
 import { useEffect, useState } from "react";
 
-//#region src/canvas/useCanvasRenderer.ts
+// src/canvas/useCanvasRenderer.ts
 /**
 * The React lifetime of `leaseCanvasRenderer`: a stable lease for the
 * component's canvas, whose renderer and GL objects are freed on unmount.
@@ -48,6 +48,5 @@ function useRedrawOnShaderSource(shaders, requestRedraw) {
 	}, [key, requestRedraw]);
 }
 
-//#endregion
 export { useCanvasRenderer, useRedrawOnDensityChange, useRedrawOnRestore, useRedrawOnShaderSource };
 //# sourceMappingURL=useCanvasRenderer.js.map

package/dist/canvas/useCanvasSurface.js

@@ -4,7 +4,7 @@ import { useLateContentRedraw } from "./useLateContentRedraw.js";
 import { useRedrawOn } from "./useRedrawOn.js";
 import { useEffect, useLayoutEffect, useRef } from "react";
 
-//#region src/canvas/useCanvasSurface.ts
+// src/canvas/useCanvasSurface.ts
 /**
 * Everything a canvas surface in core needs around its paint: the renderer
 * lease, the frame loop, and a repaint for each thing that changes pixels with
@@ -22,16 +22,34 @@ function useCanvasSurface(paint, options = {}) {
 	useLateContentRedraw(requestRedraw);
 	useRedrawOnShaderSource(options.shaders, requestRedraw);
 	useRedrawOn(options.redrawOn, requestRedraw);
-	useRedrawOnCommit(options.onCommit, () => paint(lease), requestRedraw);
+	const resized = usePaintOnResize(options.size, loop.paintNow);
+	useRedrawOnCommit(options.onCommit, () => paint(lease), requestRedraw, resized);
 	return {
 		...loop,
 		lease
 	};
 }
-function useRedrawOnCommit(mode, paintNow, requestRedraw) {
+/** Paints a commit that resized the surface in place. Returns whether this commit did. */
+function usePaintOnResize(size, paintNow) {
+	const last = useRef(null);
+	const resized = useRef(false);
+	const width = size?.width ?? 0;
+	const height = size?.height ?? 0;
+	useLayoutEffect(() => {
+		const was = last.current;
+		last.current = {
+			width,
+			height
+		};
+		resized.current = was !== null && (was.width !== width || was.height !== height);
+		if (resized.current) paintNow();
+	});
+	return resized;
+}
+function useRedrawOnCommit(mode, paintNow, requestRedraw, resized) {
 	const paintedRef = useRef(false);
 	useLayoutEffect(() => {
-		if (!mode) return;
+		if (!mode || resized.current) return;
 		if (mode === "redraw" || paintedRef.current) {
 			requestRedraw();
 			return;
@@ -44,6 +62,5 @@ function useRedrawOnCommit(mode, paintNow, requestRedraw) {
 	}, []);
 }
 
-//#endregion
 export { useCanvasSurface };
 //# sourceMappingURL=useCanvasSurface.js.map

package/dist/canvas/useCanvasSurface.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCanvasSurface.js","names":[],"sources":["../../src/canvas/useCanvasSurface.ts"],"sourcesContent":["import { useEffect, useLayoutEffect, useRef } from 'react';\nimport type { ShaderProgramHandle } from '@weasel-js/renderer';\nimport type { RedrawSource } from '../core/layers/render';\nimport type { CanvasRendererLease } from './canvasRenderer';\nimport {\n  useCanvasRenderer, useRedrawOnDensityChange, useRedrawOnRestore, useRedrawOnShaderSource,\n} from './useCanvasRenderer';\nimport { useFrameLoop, type FrameLoop, type FrameLoopOptions } from './useFrameLoop';\nimport { useLateContentRedraw } from './useLateContentRedraw';\nimport { useRedrawOn } from './useRedrawOn';\n\n/** What a surface tells {@link useCanvasSurface} about itself, beyond its paint. */\nexport interface CanvasSurfaceOptions extends FrameLoopOptions {\n  /** The surface's own density. Omit to follow `devicePixelRatio`. */\n  dpr?: number;\n  /** External state the paint reads; each source repaints when it notifies. */\n  redrawOn?: readonly RedrawSource[];\n  /** Custom programs the paint draws with; new source for one repaints. */\n  shaders?: readonly ShaderProgramHandle[];\n  /** Mark the surface dirty on every committed render, so a surface whose\n   *  paint reads its props cannot paint them stale. `'paint'` also paints the\n   *  first commit in place, in the caller's stack, so the first frame shown is\n   *  the content and not a blank canvas. */\n  onCommit?: 'redraw' | 'paint';\n}\n\n/** A surface's frame loop and the renderer lease its paint draws through. */\nexport interface CanvasSurface extends FrameLoop {\n  lease: CanvasRendererLease;\n}\n\n/**\n * Everything a canvas surface in core needs around its paint: the renderer\n * lease, the frame loop, and a repaint for each thing that changes pixels with\n * no React render behind it — a restored GL context, a density change, late\n * content, a re-registered shader, and the caller's own `redrawOn` sources.\n *\n * @param paint As `useFrameLoop`'s, handed the lease to draw through.\n */\nexport function useCanvasSurface(\n  paint: (lease: CanvasRendererLease) => boolean,\n  options: CanvasSurfaceOptions = {},\n): CanvasSurface {\n  const lease = useCanvasRenderer();\n  const loop = useFrameLoop(() => paint(lease), options);\n  const { requestRedraw } = loop;\n  useRedrawOnRestore(lease, requestRedraw);\n  useRedrawOnDensityChange(requestRedraw, options.dpr);\n  useLateContentRedraw(requestRedraw);\n  useRedrawOnShaderSource(options.shaders, requestRedraw);\n  useRedrawOn(options.redrawOn, requestRedraw);\n  useRedrawOnCommit(options.onCommit, () => paint(lease), requestRedraw);\n  return { ...loop, lease };\n}\n\nfunction useRedrawOnCommit(\n  mode: CanvasSurfaceOptions['onCommit'],\n  paintNow: () => boolean,\n  requestRedraw: () => void,\n): void {\n  const paintedRef = useRef(false);\n  // No dependency array: the paint reads whatever the render did.\n  useLayoutEffect(() => {\n    if (!mode) return;\n    if (mode === 'redraw' || paintedRef.current) { requestRedraw(); return; }\n    paintedRef.current = paintNow();\n    if (!paintedRef.current) requestRedraw();\n  });\n  // The renderer is freed on unmount; a remount (StrictMode) paints its first\n  // frame in place again.\n  useEffect(() => () => { paintedRef.current = false; }, []);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAuCA,SAAgB,iBACd,OACA,UAAgC,CAAC,GAClB;CACf,MAAM,QAAQ,kBAAkB;CAChC,MAAM,OAAO,mBAAmB,MAAM,KAAK,GAAG,OAAO;CACrD,MAAM,EAAE,kBAAkB;CAC1B,mBAAmB,OAAO,aAAa;CACvC,yBAAyB,eAAe,QAAQ,GAAG;CACnD,qBAAqB,aAAa;CAClC,wBAAwB,QAAQ,SAAS,aAAa;CACtD,YAAY,QAAQ,UAAU,aAAa;CAC3C,kBAAkB,QAAQ,gBAAgB,MAAM,KAAK,GAAG,aAAa;CACrE,OAAO;EAAE,GAAG;EAAM;CAAM;AAC1B;AAEA,SAAS,kBACP,MACA,UACA,eACM;CACN,MAAM,aAAa,OAAO,KAAK;CAE/B,sBAAsB;EACpB,IAAI,CAAC,MAAM;EACX,IAAI,SAAS,YAAY,WAAW,SAAS;GAAE,cAAc;GAAG;EAAQ;EACxE,WAAW,UAAU,SAAS;EAC9B,IAAI,CAAC,WAAW,SAAS,cAAc;CACzC,CAAC;CAGD,sBAAsB;EAAE,WAAW,UAAU;CAAO,GAAG,CAAC,CAAC;AAC3D"}
+{"version":3,"file":"useCanvasSurface.js","names":[],"sources":["../../src/canvas/useCanvasSurface.ts"],"sourcesContent":["import { useEffect, useLayoutEffect, useRef } from 'react';\nimport type { ShaderProgramHandle } from '@weasel-js/renderer';\nimport type { RedrawSource } from '../core/layers/render';\nimport type { CanvasRendererLease } from './canvasRenderer';\nimport {\n  useCanvasRenderer, useRedrawOnDensityChange, useRedrawOnRestore, useRedrawOnShaderSource,\n} from './useCanvasRenderer';\nimport { useFrameLoop, type FrameLoop, type FrameLoopOptions } from './useFrameLoop';\nimport { useLateContentRedraw } from './useLateContentRedraw';\nimport { useRedrawOn } from './useRedrawOn';\n\n/** What a surface tells {@link useCanvasSurface} about itself, beyond its paint. */\nexport interface CanvasSurfaceOptions extends FrameLoopOptions {\n  /** The surface's own density. Omit to follow `devicePixelRatio`. */\n  dpr?: number;\n  /** External state the paint reads; each source repaints when it notifies. */\n  redrawOn?: readonly RedrawSource[];\n  /** Custom programs the paint draws with; new source for one repaints. */\n  shaders?: readonly ShaderProgramHandle[];\n  /** Mark the surface dirty on every committed render, so a surface whose\n   *  paint reads its props cannot paint them stale. `'paint'` also paints the\n   *  first commit in place, in the caller's stack, so the first frame shown is\n   *  the content and not a blank canvas. */\n  onCommit?: 'redraw' | 'paint';\n  /** The size the surface paints at. A commit that changes it paints in place: React has written the element's\n   *  new size, which clears its buffer, and a resize committed from a `ResizeObserver` callback has no frame\n   *  left before the browser paints. */\n  size?: { width: number; height: number };\n}\n\n/** A surface's frame loop and the renderer lease its paint draws through. */\nexport interface CanvasSurface extends FrameLoop {\n  lease: CanvasRendererLease;\n}\n\n/**\n * Everything a canvas surface in core needs around its paint: the renderer\n * lease, the frame loop, and a repaint for each thing that changes pixels with\n * no React render behind it — a restored GL context, a density change, late\n * content, a re-registered shader, and the caller's own `redrawOn` sources.\n *\n * @param paint As `useFrameLoop`'s, handed the lease to draw through.\n */\nexport function useCanvasSurface(\n  paint: (lease: CanvasRendererLease) => boolean,\n  options: CanvasSurfaceOptions = {},\n): CanvasSurface {\n  const lease = useCanvasRenderer();\n  const loop = useFrameLoop(() => paint(lease), options);\n  const { requestRedraw } = loop;\n  useRedrawOnRestore(lease, requestRedraw);\n  useRedrawOnDensityChange(requestRedraw, options.dpr);\n  useLateContentRedraw(requestRedraw);\n  useRedrawOnShaderSource(options.shaders, requestRedraw);\n  useRedrawOn(options.redrawOn, requestRedraw);\n  const resized = usePaintOnResize(options.size, loop.paintNow);\n  useRedrawOnCommit(options.onCommit, () => paint(lease), requestRedraw, resized);\n  return { ...loop, lease };\n}\n\n/** Paints a commit that resized the surface in place. Returns whether this commit did. */\nfunction usePaintOnResize(size: CanvasSurfaceOptions['size'], paintNow: () => void): { readonly current: boolean } {\n  const last = useRef<{ width: number; height: number } | null>(null);\n  const resized = useRef(false);\n  const width = size?.width ?? 0;\n  const height = size?.height ?? 0;\n  useLayoutEffect(() => {\n    const was = last.current;\n    last.current = { width, height };\n    resized.current = was !== null && (was.width !== width || was.height !== height);\n    if (resized.current) paintNow();\n  });\n  return resized;\n}\n\nfunction useRedrawOnCommit(\n  mode: CanvasSurfaceOptions['onCommit'],\n  paintNow: () => boolean,\n  requestRedraw: () => void,\n  resized: { readonly current: boolean },\n): void {\n  const paintedRef = useRef(false);\n  // No dependency array: the paint reads whatever the render did.\n  useLayoutEffect(() => {\n    if (!mode || resized.current) return;\n    if (mode === 'redraw' || paintedRef.current) { requestRedraw(); return; }\n    paintedRef.current = paintNow();\n    if (!paintedRef.current) requestRedraw();\n  });\n  // The renderer is freed on unmount; a remount (StrictMode) paints its first\n  // frame in place again.\n  useEffect(() => () => { paintedRef.current = false; }, []);\n}\n"],"mappings":";;;;;;;;;;;;;;;AA2CA,SAAgB,iBACd,OACA,UAAgC,CAAC,GAClB;CACf,MAAM,QAAQ,kBAAkB;CAChC,MAAM,OAAO,mBAAmB,MAAM,KAAK,GAAG,OAAO;CACrD,MAAM,EAAE,kBAAkB;CAC1B,mBAAmB,OAAO,aAAa;CACvC,yBAAyB,eAAe,QAAQ,GAAG;CACnD,qBAAqB,aAAa;CAClC,wBAAwB,QAAQ,SAAS,aAAa;CACtD,YAAY,QAAQ,UAAU,aAAa;CAC3C,MAAM,UAAU,iBAAiB,QAAQ,MAAM,KAAK,QAAQ;CAC5D,kBAAkB,QAAQ,gBAAgB,MAAM,KAAK,GAAG,eAAe,OAAO;CAC9E,OAAO;EAAE,GAAG;EAAM;CAAM;AAC1B;;AAGA,SAAS,iBAAiB,MAAoC,UAAqD;CACjH,MAAM,OAAO,OAAiD,IAAI;CAClE,MAAM,UAAU,OAAO,KAAK;CAC5B,MAAM,QAAQ,MAAM,SAAS;CAC7B,MAAM,SAAS,MAAM,UAAU;CAC/B,sBAAsB;EACpB,MAAM,MAAM,KAAK;EACjB,KAAK,UAAU;GAAE;GAAO;EAAO;EAC/B,QAAQ,UAAU,QAAQ,SAAS,IAAI,UAAU,SAAS,IAAI,WAAW;EACzE,IAAI,QAAQ,SAAS,SAAS;CAChC,CAAC;CACD,OAAO;AACT;AAEA,SAAS,kBACP,MACA,UACA,eACA,SACM;CACN,MAAM,aAAa,OAAO,KAAK;CAE/B,sBAAsB;EACpB,IAAI,CAAC,QAAQ,QAAQ,SAAS;EAC9B,IAAI,SAAS,YAAY,WAAW,SAAS;GAAE,cAAc;GAAG;EAAQ;EACxE,WAAW,UAAU,SAAS;EAC9B,IAAI,CAAC,WAAW,SAAS,cAAc;CACzC,CAAC;CAGD,sBAAsB;EAAE,WAAW,UAAU;CAAO,GAAG,CAAC,CAAC;AAC3D"}

package/dist/canvas/useCanvasView.js

@@ -1,9 +1,9 @@
-import { normalizeView, sameView } from "../core/viewport/view.js";
 import { clampView } from "../core/viewport/clampView.js";
+import { normalizeView, sameView } from "../core/viewport/view.js";
 import { useCallback, useRef } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/useCanvasView.ts
+// src/canvas/useCanvasView.ts
 /**
 * A camera: held in a ref when uncontrolled, taken from the `view` option when
 * controlled, with one write path and one subscriber list over both.
@@ -94,6 +94,5 @@ function useCanvasView(opts) {
 	};
 }
 
-//#endregion
 export { useCanvasView };
 //# sourceMappingURL=useCanvasView.js.map

package/dist/canvas/useClientToWorld.js

@@ -2,7 +2,7 @@ import { clientToWorld } from "../core/viewport/clientToWorld.js";
 import { useCallback } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/useClientToWorld.ts
+// src/canvas/useClientToWorld.ts
 /**
 * The canvas's one client→world conversion: hover, the view registry and both handles answer
 * with it, so a `clientToWorld` override reaches all of them or none.
@@ -22,6 +22,5 @@ function useClientToWorld(elementRef, clientToWorld$1, viewRef) {
 	]);
 }
 
-//#endregion
 export { useClientToWorld };
 //# sourceMappingURL=useClientToWorld.js.map

package/dist/canvas/useExtraLayers.js

@@ -1,7 +1,7 @@
 import { isLayerPainted } from "../core/layers/render.js";
 import { useCallback, useRef, useState } from "react";
 
-//#region src/canvas/useExtraLayers.ts
+// src/canvas/useExtraLayers.ts
 var alwaysVisible = (_id) => true;
 var NO_LAYER_VISIBILITY = {};
 /** Layers attached from outside the `layers` prop (a HUD, a loupe), and hit-testing over them. */
@@ -40,6 +40,5 @@ function useExtraLayers(gateRef) {
 	};
 }
 
-//#endregion
 export { NO_LAYER_VISIBILITY, alwaysVisible, useExtraLayers };
 //# sourceMappingURL=useExtraLayers.js.map

package/dist/canvas/useFrameLoop.js

@@ -1,7 +1,7 @@
 import { useCallback, useInsertionEffect, useLayoutEffect, useRef } from "react";
 import { useLatest, useVisibleRaf } from "@weasel-js/react";
 
-//#region src/canvas/useFrameLoop.ts
+// src/canvas/useFrameLoop.ts
 /**
 * The frame loop behind `<Canvas>`: a dirty flag, one frame in flight at a
 * time, and a subscriber set notified after a paint lands. When frames may run
@@ -73,18 +73,16 @@ function useFrameLoop(paint, options = {}) {
 			frame.request();
 		};
 	});
-	const requestRedraw = useCallback(() => {
+	const redraw = useCallback((inPlace) => {
 		dirtyRef.current = true;
-		if (syncRef.current && aliveRef.current && !paintingRef.current && frame.isVisible()) {
+		if (inPlace && aliveRef.current && !paintingRef.current && frame.isVisible()) {
 			runPaint(performance.now());
 			return;
 		}
 		frame.request();
-	}, [
-		frame,
-		runPaint,
-		syncRef
-	]);
+	}, [frame, runPaint]);
+	const requestRedraw = useCallback(() => redraw(syncRef.current), [redraw, syncRef]);
+	const paintNow = useCallback(() => redraw(true), [redraw]);
 	const subscribeFrame = useCallback((fn) => {
 		subsRef.current.add(fn);
 		return () => {
@@ -117,12 +115,12 @@ function useFrameLoop(paint, options = {}) {
 	}, []);
 	return {
 		requestRedraw,
+		paintNow,
 		subscribeFrame,
 		subscribeBeforePaint,
 		subscribeResume
 	};
 }
 
-//#endregion
 export { useFrameLoop };
 //# sourceMappingURL=useFrameLoop.js.map

package/dist/canvas/useFrameLoop.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFrameLoop.js","names":[],"sources":["../../src/canvas/useFrameLoop.ts"],"sourcesContent":["/**\n * The frame loop behind `<Canvas>`: a dirty flag, one frame in flight at a\n * time, and a subscriber set notified after a paint lands. When frames may run\n * at all is `useVisibleRaf`'s question, not this hook's — a redraw requested\n * while nothing can see the surface is held there and re-armed on resume.\n *\n * @internal Not consumer surface. Canvas exposes `requestRedraw` and\n *   `subscribeFrame` on its ref handle; this is how they are implemented.\n */\n\nimport { useCallback, useInsertionEffect, useLayoutEffect, useRef } from 'react';\nimport { useLatest, useVisibleRaf, type VisibleRafTarget } from '@weasel-js/react';\n\nexport interface FrameLoop {\n  /** Mark the surface dirty and schedule a frame. Identity is stable for the\n   *  lifetime of the component — consumers capture it. */\n  requestRedraw(): void;\n  /** Run `fn` after every landed paint, with the frame's time. Returns an\n   *  unsubscribe. */\n  subscribeFrame(fn: (time: number) => void): () => void;\n  /** Run `fn` on every frame just before its paint, with the frame's time.\n   *  Returns an unsubscribe. */\n  subscribeBeforePaint(fn: (time: number) => void): () => void;\n  /** Run `fn` when the loop leaves suspension, before the frame that follows.\n   *  Returns an unsubscribe. */\n  subscribeResume(fn: () => void): () => void;\n}\n\nexport interface FrameLoopOptions {\n  /** Paint in the caller's own stack — the commit or event that asked for the\n   *  redraw — instead of on the next animation frame. Read live, so toggling\n   *  it takes effect from the next `requestRedraw` on. */\n  syncPaint?: boolean;\n  /** The surface being painted. Given one, the loop also stops while that\n   *  element sits outside the viewport, not only while the tab is hidden. */\n  target?: VisibleRafTarget;\n}\n\n/**\n * @param paint Runs on the frame; returns whether pixels landed. A `false`\n *   leaves the surface dirty and notifies nobody, so the next request retries.\n */\nexport function useFrameLoop(paint: () => boolean, options: FrameLoopOptions = {}): FrameLoop {\n  const dirtyRef = useRef(true);\n  const aliveRef = useRef(true);\n  const paintingRef = useRef(false);\n  const paintRef = useLatest(paint);\n  const syncRef = useLatest(options.syncPaint ?? false);\n  const subsRef = useRef<Set<(time: number) => void>>(new Set());\n  const beforeRef = useRef<Set<(time: number) => void>>(new Set());\n  const resumeRef = useRef<Set<() => void>>(new Set());\n  /** The last time handed to subscribers. A sync paint reads the clock at the\n   *  call and a rAF frame carries its frame's start, so within one animation\n   *  frame the second can be the earlier of the two. */\n  const lastTimeRef = useRef(-Infinity);\n\n  /** Set while recovering from a paint that threw, so one bad frame is retried\n   *  and a permanently throwing one still doesn't spin at frame rate. */\n  const retriedRef = useRef(false);\n  /** `frame.request`, which doesn't exist until after `runPaint` is built. */\n  const rearmRef = useRef<(() => void) | null>(null);\n\n  const runPaint = useCallback((at: number) => {\n    const time = Math.max(at, lastTimeRef.current);\n    lastTimeRef.current = time;\n    dirtyRef.current = false;\n    paintingRef.current = true;\n    let landed = false;\n    try {\n      for (const fn of beforeRef.current) fn(time);\n      landed = paintRef.current();\n      if (!landed) {\n        dirtyRef.current = true;\n        return;\n      }\n      retriedRef.current = false;\n      // Notified inside the guard: a subscriber calling `requestRedraw` under\n      // `syncPaint` would otherwise re-enter this synchronously, without bound.\n      for (const fn of subsRef.current) fn(time);\n    } catch (err) {\n      // A throw skips the `!landed` branch above, so without this the surface\n      // is left clean but unpainted — the pixels on screen are whatever the\n      // last landed frame left, and nothing repaints until something\n      // unrelated happens to request a redraw. That is how a single\n      // malformed node blanked a whole document until the pointer moved.\n      dirtyRef.current = true;\n      if (!retriedRef.current) {\n        retriedRef.current = true;\n        rearmRef.current?.();\n      }\n      throw err;\n    } finally {\n      paintingRef.current = false;\n    }\n  }, [paintRef]);\n\n  const frame = useVisibleRaf(\n    useCallback((time: number) => {\n      if (!aliveRef.current || !dirtyRef.current) return;\n      runPaint(time);\n    }, [runPaint]),\n    {\n      target: options.target,\n      onResume: useCallback(() => { for (const fn of resumeRef.current) fn(); }, []),\n    },\n  );\n  useInsertionEffect(() => {\n    rearmRef.current = () => { frame.request(); };\n  });\n\n  const requestRedraw = useCallback(() => {\n    dirtyRef.current = true;\n    // The gate suppresses the sync path too: a background tab still commits\n    // React updates, and that is the one paint browser throttling does not stop.\n    // A request made from inside a draw or a frame subscriber would recurse\n    // forever if it painted here, so re-entrant ones fall through to a frame.\n    if (syncRef.current && aliveRef.current && !paintingRef.current && frame.isVisible()) {\n      runPaint(performance.now());\n      return;\n    }\n    frame.request();\n  }, [frame, runPaint, syncRef]);\n\n  const subscribeFrame = useCallback((fn: (time: number) => void) => {\n    subsRef.current.add(fn);\n    return () => { subsRef.current.delete(fn); };\n  }, []);\n  const subscribeBeforePaint = useCallback((fn: (time: number) => void) => {\n    beforeRef.current.add(fn);\n    return () => { beforeRef.current.delete(fn); };\n  }, []);\n\n  const subscribeResume = useCallback((fn: () => void) => {\n    resumeRef.current.add(fn);\n    return () => { resumeRef.current.delete(fn); };\n  }, []);\n\n  // `requestRedraw` outlives the component: `@weasel-js/hud` calls it from a\n  // `.then()`, and `viewRegistry.attachSurface` hands it to the consumer.\n  // Re-armed in setup because refs survive StrictMode's simulated remount, and\n  // a layout effect so the arming precedes Canvas's own layout effects — the\n  // sync-paint path runs in one of those.\n  useLayoutEffect(() => {\n    aliveRef.current = true;\n    const subs = subsRef.current;\n    const before = beforeRef.current;\n    const resume = resumeRef.current;\n    return () => {\n      aliveRef.current = false;\n      subs.clear();\n      before.clear();\n      resume.clear();\n    };\n  }, []);\n\n  return { requestRedraw, subscribeFrame, subscribeBeforePaint, subscribeResume };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA0CA,SAAgB,aAAa,OAAsB,UAA4B,CAAC,GAAc;CAC5F,MAAM,WAAW,OAAO,IAAI;CAC5B,MAAM,WAAW,OAAO,IAAI;CAC5B,MAAM,cAAc,OAAO,KAAK;CAChC,MAAM,WAAW,UAAU,KAAK;CAChC,MAAM,UAAU,UAAU,QAAQ,aAAa,KAAK;CACpD,MAAM,UAAU,uBAAoC,IAAI,IAAI,CAAC;CAC7D,MAAM,YAAY,uBAAoC,IAAI,IAAI,CAAC;CAC/D,MAAM,YAAY,uBAAwB,IAAI,IAAI,CAAC;;;;CAInD,MAAM,cAAc,OAAO,SAAS;;;CAIpC,MAAM,aAAa,OAAO,KAAK;;CAE/B,MAAM,WAAW,OAA4B,IAAI;CAEjD,MAAM,WAAW,aAAa,OAAe;EAC3C,MAAM,OAAO,KAAK,IAAI,IAAI,YAAY,OAAO;EAC7C,YAAY,UAAU;EACtB,SAAS,UAAU;EACnB,YAAY,UAAU;EACtB,IAAI,SAAS;EACb,IAAI;GACF,KAAK,MAAM,MAAM,UAAU,SAAS,GAAG,IAAI;GAC3C,SAAS,SAAS,QAAQ;GAC1B,IAAI,CAAC,QAAQ;IACX,SAAS,UAAU;IACnB;GACF;GACA,WAAW,UAAU;GAGrB,KAAK,MAAM,MAAM,QAAQ,SAAS,GAAG,IAAI;EAC3C,SAAS,KAAK;GAMZ,SAAS,UAAU;GACnB,IAAI,CAAC,WAAW,SAAS;IACvB,WAAW,UAAU;IACrB,SAAS,UAAU;GACrB;GACA,MAAM;EACR,UAAU;GACR,YAAY,UAAU;EACxB;CACF,GAAG,CAAC,QAAQ,CAAC;CAEb,MAAM,QAAQ,cACZ,aAAa,SAAiB;EAC5B,IAAI,CAAC,SAAS,WAAW,CAAC,SAAS,SAAS;EAC5C,SAAS,IAAI;CACf,GAAG,CAAC,QAAQ,CAAC,GACb;EACE,QAAQ,QAAQ;EAChB,UAAU,kBAAkB;GAAE,KAAK,MAAM,MAAM,UAAU,SAAS,GAAG;EAAG,GAAG,CAAC,CAAC;CAC/E,CACF;CACA,yBAAyB;EACvB,SAAS,gBAAgB;GAAE,MAAM,QAAQ;EAAG;CAC9C,CAAC;CAED,MAAM,gBAAgB,kBAAkB;EACtC,SAAS,UAAU;EAKnB,IAAI,QAAQ,WAAW,SAAS,WAAW,CAAC,YAAY,WAAW,MAAM,UAAU,GAAG;GACpF,SAAS,YAAY,IAAI,CAAC;GAC1B;EACF;EACA,MAAM,QAAQ;CAChB,GAAG;EAAC;EAAO;EAAU;CAAO,CAAC;CAE7B,MAAM,iBAAiB,aAAa,OAA+B;EACjE,QAAQ,QAAQ,IAAI,EAAE;EACtB,aAAa;GAAE,QAAQ,QAAQ,OAAO,EAAE;EAAG;CAC7C,GAAG,CAAC,CAAC;CACL,MAAM,uBAAuB,aAAa,OAA+B;EACvE,UAAU,QAAQ,IAAI,EAAE;EACxB,aAAa;GAAE,UAAU,QAAQ,OAAO,EAAE;EAAG;CAC/C,GAAG,CAAC,CAAC;CAEL,MAAM,kBAAkB,aAAa,OAAmB;EACtD,UAAU,QAAQ,IAAI,EAAE;EACxB,aAAa;GAAE,UAAU,QAAQ,OAAO,EAAE;EAAG;CAC/C,GAAG,CAAC,CAAC;CAOL,sBAAsB;EACpB,SAAS,UAAU;EACnB,MAAM,OAAO,QAAQ;EACrB,MAAM,SAAS,UAAU;EACzB,MAAM,SAAS,UAAU;EACzB,aAAa;GACX,SAAS,UAAU;GACnB,KAAK,MAAM;GACX,OAAO,MAAM;GACb,OAAO,MAAM;EACf;CACF,GAAG,CAAC,CAAC;CAEL,OAAO;EAAE;EAAe;EAAgB;EAAsB;CAAgB;AAChF"}
+{"version":3,"file":"useFrameLoop.js","names":[],"sources":["../../src/canvas/useFrameLoop.ts"],"sourcesContent":["/**\n * The frame loop behind `<Canvas>`: a dirty flag, one frame in flight at a\n * time, and a subscriber set notified after a paint lands. When frames may run\n * at all is `useVisibleRaf`'s question, not this hook's — a redraw requested\n * while nothing can see the surface is held there and re-armed on resume.\n *\n * @internal Not consumer surface. Canvas exposes `requestRedraw` and\n *   `subscribeFrame` on its ref handle; this is how they are implemented.\n */\n\nimport { useCallback, useInsertionEffect, useLayoutEffect, useRef } from 'react';\nimport { useLatest, useVisibleRaf, type VisibleRafTarget } from '@weasel-js/react';\n\nexport interface FrameLoop {\n  /** Mark the surface dirty and schedule a frame. Identity is stable for the\n   *  lifetime of the component — consumers capture it. */\n  requestRedraw(): void;\n  /** `requestRedraw`, painting in the caller's stack as `syncPaint` does whatever that is set to. */\n  paintNow(): void;\n  /** Run `fn` after every landed paint, with the frame's time. Returns an\n   *  unsubscribe. */\n  subscribeFrame(fn: (time: number) => void): () => void;\n  /** Run `fn` on every frame just before its paint, with the frame's time.\n   *  Returns an unsubscribe. */\n  subscribeBeforePaint(fn: (time: number) => void): () => void;\n  /** Run `fn` when the loop leaves suspension, before the frame that follows.\n   *  Returns an unsubscribe. */\n  subscribeResume(fn: () => void): () => void;\n}\n\nexport interface FrameLoopOptions {\n  /** Paint in the caller's own stack — the commit or event that asked for the\n   *  redraw — instead of on the next animation frame. Read live, so toggling\n   *  it takes effect from the next `requestRedraw` on. */\n  syncPaint?: boolean;\n  /** The surface being painted. Given one, the loop also stops while that\n   *  element sits outside the viewport, not only while the tab is hidden. */\n  target?: VisibleRafTarget;\n}\n\n/**\n * @param paint Runs on the frame; returns whether pixels landed. A `false`\n *   leaves the surface dirty and notifies nobody, so the next request retries.\n */\nexport function useFrameLoop(paint: () => boolean, options: FrameLoopOptions = {}): FrameLoop {\n  const dirtyRef = useRef(true);\n  const aliveRef = useRef(true);\n  const paintingRef = useRef(false);\n  const paintRef = useLatest(paint);\n  const syncRef = useLatest(options.syncPaint ?? false);\n  const subsRef = useRef<Set<(time: number) => void>>(new Set());\n  const beforeRef = useRef<Set<(time: number) => void>>(new Set());\n  const resumeRef = useRef<Set<() => void>>(new Set());\n  /** The last time handed to subscribers. A sync paint reads the clock at the\n   *  call and a rAF frame carries its frame's start, so within one animation\n   *  frame the second can be the earlier of the two. */\n  const lastTimeRef = useRef(-Infinity);\n\n  /** Set while recovering from a paint that threw, so one bad frame is retried\n   *  and a permanently throwing one still doesn't spin at frame rate. */\n  const retriedRef = useRef(false);\n  /** `frame.request`, which doesn't exist until after `runPaint` is built. */\n  const rearmRef = useRef<(() => void) | null>(null);\n\n  const runPaint = useCallback((at: number) => {\n    const time = Math.max(at, lastTimeRef.current);\n    lastTimeRef.current = time;\n    dirtyRef.current = false;\n    paintingRef.current = true;\n    let landed = false;\n    try {\n      for (const fn of beforeRef.current) fn(time);\n      landed = paintRef.current();\n      if (!landed) {\n        dirtyRef.current = true;\n        return;\n      }\n      retriedRef.current = false;\n      // Notified inside the guard: a subscriber calling `requestRedraw` under\n      // `syncPaint` would otherwise re-enter this synchronously, without bound.\n      for (const fn of subsRef.current) fn(time);\n    } catch (err) {\n      // A throw skips the `!landed` branch above, so without this the surface\n      // is left clean but unpainted — the pixels on screen are whatever the\n      // last landed frame left, and nothing repaints until something\n      // unrelated happens to request a redraw. That is how a single\n      // malformed node blanked a whole document until the pointer moved.\n      dirtyRef.current = true;\n      if (!retriedRef.current) {\n        retriedRef.current = true;\n        rearmRef.current?.();\n      }\n      throw err;\n    } finally {\n      paintingRef.current = false;\n    }\n  }, [paintRef]);\n\n  const frame = useVisibleRaf(\n    useCallback((time: number) => {\n      if (!aliveRef.current || !dirtyRef.current) return;\n      runPaint(time);\n    }, [runPaint]),\n    {\n      target: options.target,\n      onResume: useCallback(() => { for (const fn of resumeRef.current) fn(); }, []),\n    },\n  );\n  useInsertionEffect(() => {\n    rearmRef.current = () => { frame.request(); };\n  });\n\n  const redraw = useCallback((inPlace: boolean) => {\n    dirtyRef.current = true;\n    // The gate suppresses the sync path too: a background tab still commits\n    // React updates, and that is the one paint browser throttling does not stop.\n    // A request made from inside a draw or a frame subscriber would recurse\n    // forever if it painted here, so re-entrant ones fall through to a frame.\n    if (inPlace && aliveRef.current && !paintingRef.current && frame.isVisible()) {\n      runPaint(performance.now());\n      return;\n    }\n    frame.request();\n  }, [frame, runPaint]);\n  const requestRedraw = useCallback(() => redraw(syncRef.current), [redraw, syncRef]);\n  const paintNow = useCallback(() => redraw(true), [redraw]);\n\n  const subscribeFrame = useCallback((fn: (time: number) => void) => {\n    subsRef.current.add(fn);\n    return () => { subsRef.current.delete(fn); };\n  }, []);\n  const subscribeBeforePaint = useCallback((fn: (time: number) => void) => {\n    beforeRef.current.add(fn);\n    return () => { beforeRef.current.delete(fn); };\n  }, []);\n\n  const subscribeResume = useCallback((fn: () => void) => {\n    resumeRef.current.add(fn);\n    return () => { resumeRef.current.delete(fn); };\n  }, []);\n\n  // `requestRedraw` outlives the component: `@weasel-js/hud` calls it from a\n  // `.then()`, and `viewRegistry.attachSurface` hands it to the consumer.\n  // Re-armed in setup because refs survive StrictMode's simulated remount, and\n  // a layout effect so the arming precedes Canvas's own layout effects — the\n  // sync-paint path runs in one of those.\n  useLayoutEffect(() => {\n    aliveRef.current = true;\n    const subs = subsRef.current;\n    const before = beforeRef.current;\n    const resume = resumeRef.current;\n    return () => {\n      aliveRef.current = false;\n      subs.clear();\n      before.clear();\n      resume.clear();\n    };\n  }, []);\n\n  return { requestRedraw, paintNow, subscribeFrame, subscribeBeforePaint, subscribeResume };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA4CA,SAAgB,aAAa,OAAsB,UAA4B,CAAC,GAAc;CAC5F,MAAM,WAAW,OAAO,IAAI;CAC5B,MAAM,WAAW,OAAO,IAAI;CAC5B,MAAM,cAAc,OAAO,KAAK;CAChC,MAAM,WAAW,UAAU,KAAK;CAChC,MAAM,UAAU,UAAU,QAAQ,aAAa,KAAK;CACpD,MAAM,UAAU,uBAAoC,IAAI,IAAI,CAAC;CAC7D,MAAM,YAAY,uBAAoC,IAAI,IAAI,CAAC;CAC/D,MAAM,YAAY,uBAAwB,IAAI,IAAI,CAAC;;;;CAInD,MAAM,cAAc,OAAO,SAAS;;;CAIpC,MAAM,aAAa,OAAO,KAAK;;CAE/B,MAAM,WAAW,OAA4B,IAAI;CAEjD,MAAM,WAAW,aAAa,OAAe;EAC3C,MAAM,OAAO,KAAK,IAAI,IAAI,YAAY,OAAO;EAC7C,YAAY,UAAU;EACtB,SAAS,UAAU;EACnB,YAAY,UAAU;EACtB,IAAI,SAAS;EACb,IAAI;GACF,KAAK,MAAM,MAAM,UAAU,SAAS,GAAG,IAAI;GAC3C,SAAS,SAAS,QAAQ;GAC1B,IAAI,CAAC,QAAQ;IACX,SAAS,UAAU;IACnB;GACF;GACA,WAAW,UAAU;GAGrB,KAAK,MAAM,MAAM,QAAQ,SAAS,GAAG,IAAI;EAC3C,SAAS,KAAK;GAMZ,SAAS,UAAU;GACnB,IAAI,CAAC,WAAW,SAAS;IACvB,WAAW,UAAU;IACrB,SAAS,UAAU;GACrB;GACA,MAAM;EACR,UAAU;GACR,YAAY,UAAU;EACxB;CACF,GAAG,CAAC,QAAQ,CAAC;CAEb,MAAM,QAAQ,cACZ,aAAa,SAAiB;EAC5B,IAAI,CAAC,SAAS,WAAW,CAAC,SAAS,SAAS;EAC5C,SAAS,IAAI;CACf,GAAG,CAAC,QAAQ,CAAC,GACb;EACE,QAAQ,QAAQ;EAChB,UAAU,kBAAkB;GAAE,KAAK,MAAM,MAAM,UAAU,SAAS,GAAG;EAAG,GAAG,CAAC,CAAC;CAC/E,CACF;CACA,yBAAyB;EACvB,SAAS,gBAAgB;GAAE,MAAM,QAAQ;EAAG;CAC9C,CAAC;CAED,MAAM,SAAS,aAAa,YAAqB;EAC/C,SAAS,UAAU;EAKnB,IAAI,WAAW,SAAS,WAAW,CAAC,YAAY,WAAW,MAAM,UAAU,GAAG;GAC5E,SAAS,YAAY,IAAI,CAAC;GAC1B;EACF;EACA,MAAM,QAAQ;CAChB,GAAG,CAAC,OAAO,QAAQ,CAAC;CACpB,MAAM,gBAAgB,kBAAkB,OAAO,QAAQ,OAAO,GAAG,CAAC,QAAQ,OAAO,CAAC;CAClF,MAAM,WAAW,kBAAkB,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC;CAEzD,MAAM,iBAAiB,aAAa,OAA+B;EACjE,QAAQ,QAAQ,IAAI,EAAE;EACtB,aAAa;GAAE,QAAQ,QAAQ,OAAO,EAAE;EAAG;CAC7C,GAAG,CAAC,CAAC;CACL,MAAM,uBAAuB,aAAa,OAA+B;EACvE,UAAU,QAAQ,IAAI,EAAE;EACxB,aAAa;GAAE,UAAU,QAAQ,OAAO,EAAE;EAAG;CAC/C,GAAG,CAAC,CAAC;CAEL,MAAM,kBAAkB,aAAa,OAAmB;EACtD,UAAU,QAAQ,IAAI,EAAE;EACxB,aAAa;GAAE,UAAU,QAAQ,OAAO,EAAE;EAAG;CAC/C,GAAG,CAAC,CAAC;CAOL,sBAAsB;EACpB,SAAS,UAAU;EACnB,MAAM,OAAO,QAAQ;EACrB,MAAM,SAAS,UAAU;EACzB,MAAM,SAAS,UAAU;EACzB,aAAa;GACX,SAAS,UAAU;GACnB,KAAK,MAAM;GACX,OAAO,MAAM;GACb,OAAO,MAAM;EACf;CACF,GAAG,CAAC,CAAC;CAEL,OAAO;EAAE;EAAe;EAAU;EAAgB;EAAsB;CAAgB;AAC1F"}

package/dist/canvas/useHitObserver.js

@@ -1,7 +1,7 @@
 import { useMemo } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/useHitObserver.ts
+// src/canvas/useHitObserver.ts
 /** Turns a consumer's hit callback into the world-point observer the gesture
 *  dispatcher takes, resolving the hit with the canvas's own picker. Identity
 *  changes only between wired and not, so the dispatcher isn't rebuilt per
@@ -25,6 +25,5 @@ function useHitObserver(cb, pickerRef) {
 	]);
 }
 
-//#endregion
 export { useHitObserver };
 //# sourceMappingURL=useHitObserver.js.map

package/dist/canvas/useHostAnchor.js

@@ -3,7 +3,7 @@ import { watchElementMove } from "./watchElementMove.js";
 import { useCallback, useEffect, useState } from "react";
 import { useLatest, useVisibleRaf } from "@weasel-js/react";
 
-//#region src/canvas/useHostAnchor.ts
+// src/canvas/useHostAnchor.ts
 /**
 * Hold a fixed-position panel against a host element's corner, kept inside the
 * viewport, following it through scrolls, resizes, and reflows, a host moved by
@@ -98,6 +98,5 @@ function useHostAnchor(resolveHost, options) {
 	};
 }
 
-//#endregion
 export { useHostAnchor };
 //# sourceMappingURL=useHostAnchor.js.map

package/dist/canvas/useInFlightBounds.js

@@ -1,20 +1,21 @@
 import { useCallback, useRef } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/useInFlightBounds.ts
+// src/canvas/useInFlightBounds.ts
 /**
 * Where a view boxes the nodes an in-flight gesture names: at the pose a
-* source previews, else at the node's effective pose — a transform's poses
+* source previews, carried to world, else at the node's effective pose — a transform's poses
 * live in the scene's overrides, not on its handle. Boxed through `boxOf`
 * either way, since a consumer `boundsOf` answers for the document pose only.
 */
 function useInFlightBounds(args) {
-	const { gestureSource, boxOf, committedPoseOf } = args;
+	const { gestureSource, boxOf, committedPoseOf, worldOfStored } = args;
 	const previewPoseExtraRef = useLatest(args.previewPoseExtra);
 	const previewPoseOf = useCallback((id) => {
 		const p = previewPoseExtraRef.current?.(id);
-		return p != null ? p : null;
-	}, [previewPoseExtraRef]);
+		if (p == null) return null;
+		return worldOfStored ? worldOfStored(id, p) : p;
+	}, [previewPoseExtraRef, worldOfStored]);
 	const inFlight = useRef(null);
 	const isInFlight = useCallback((id) => {
 		if (!gestureSource) return false;
@@ -47,6 +48,5 @@ function useInFlightBounds(args) {
 	};
 }
 
-//#endregion
 export { useInFlightBounds };
 //# sourceMappingURL=useInFlightBounds.js.map

package/dist/canvas/useInFlightBounds.js.map

@@ -1 +1 @@
-{"version":3,"file":"useInFlightBounds.js","names":[],"sources":["../../src/canvas/useInFlightBounds.ts"],"sourcesContent":["import { useCallback, useRef } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { GestureSource } from './gestureBounds';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\n\n/**\n * Where a view boxes the nodes an in-flight gesture names: at the pose a\n * source previews, else at the node's effective pose — a transform's poses\n * live in the scene's overrides, not on its handle. Boxed through `boxOf`\n * either way, since a consumer `boundsOf` answers for the document pose only.\n */\nexport function useInFlightBounds<TPose>(args: {\n  gestureSource: GestureSource | undefined;\n  /** Read through a ref, so a change mid-gesture rebuilds nothing. */\n  previewPoseExtra: ((id: string) => unknown) | undefined;\n  boxOf: (id: string, pose: TPose) => Bounds | null;\n  /** The node's effective world pose. */\n  committedPoseOf: (id: string) => TPose | null;\n}): {\n  previewPoseOf: (id: string) => TPose | null;\n  previewBoundsOf: (id: string) => Bounds | null;\n} {\n  const { gestureSource, boxOf, committedPoseOf } = args;\n  const previewPoseExtraRef = useLatest(args.previewPoseExtra);\n  const previewPoseOf = useCallback((id: string): TPose | null => {\n    const p = previewPoseExtraRef.current?.(id);\n    return p != null ? (p as TPose) : null;\n  }, [previewPoseExtraRef]);\n\n  // The source's ids, re-read only when its version moves.\n  const inFlight = useRef<{ source: GestureSource; version: number; ids: ReadonlySet<string> } | null>(null);\n  const isInFlight = useCallback((id: string): boolean => {\n    if (!gestureSource) return false;\n    const version = gestureSource.getVersion();\n    let entry = inFlight.current;\n    if (entry === null || entry.source !== gestureSource || entry.version !== version) {\n      entry = { source: gestureSource, version, ids: new Set(gestureSource.ids() ?? []) };\n      inFlight.current = entry;\n    }\n    return entry.ids.has(id);\n  }, [gestureSource]);\n\n  const previewBoundsOf = useCallback((id: string): Bounds | null => {\n    const p = previewPoseOf(id);\n    if (p != null) return boxOf(id, p);\n    if (!isInFlight(id)) return null;\n    const shown = committedPoseOf(id);\n    return shown != null ? boxOf(id, shown) : null;\n  }, [previewPoseOf, boxOf, isInFlight, committedPoseOf]);\n\n  return { previewPoseOf, previewBoundsOf };\n}\n"],"mappings":";;;;;;;;;;AAWA,SAAgB,kBAAyB,MAUvC;CACA,MAAM,EAAE,eAAe,OAAO,oBAAoB;CAClD,MAAM,sBAAsB,UAAU,KAAK,gBAAgB;CAC3D,MAAM,gBAAgB,aAAa,OAA6B;EAC9D,MAAM,IAAI,oBAAoB,UAAU,EAAE;EAC1C,OAAO,KAAK,OAAQ,IAAc;CACpC,GAAG,CAAC,mBAAmB,CAAC;CAGxB,MAAM,WAAW,OAAoF,IAAI;CACzG,MAAM,aAAa,aAAa,OAAwB;EACtD,IAAI,CAAC,eAAe,OAAO;EAC3B,MAAM,UAAU,cAAc,WAAW;EACzC,IAAI,QAAQ,SAAS;EACrB,IAAI,UAAU,QAAQ,MAAM,WAAW,iBAAiB,MAAM,YAAY,SAAS;GACjF,QAAQ;IAAE,QAAQ;IAAe;IAAS,KAAK,IAAI,IAAI,cAAc,IAAI,KAAK,CAAC,CAAC;GAAE;GAClF,SAAS,UAAU;EACrB;EACA,OAAO,MAAM,IAAI,IAAI,EAAE;CACzB,GAAG,CAAC,aAAa,CAAC;CAUlB,OAAO;EAAE;EAAe,iBARA,aAAa,OAA8B;GACjE,MAAM,IAAI,cAAc,EAAE;GAC1B,IAAI,KAAK,MAAM,OAAO,MAAM,IAAI,CAAC;GACjC,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO;GAC5B,MAAM,QAAQ,gBAAgB,EAAE;GAChC,OAAO,SAAS,OAAO,MAAM,IAAI,KAAK,IAAI;EAC5C,GAAG;GAAC;GAAe;GAAO;GAAY;EAAe,CAE7B;CAAgB;AAC1C"}
+{"version":3,"file":"useInFlightBounds.js","names":[],"sources":["../../src/canvas/useInFlightBounds.ts"],"sourcesContent":["import { useCallback, useRef } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { GestureSource } from './gestureBounds';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\n\n/**\n * Where a view boxes the nodes an in-flight gesture names: at the pose a\n * source previews, carried to world, else at the node's effective pose — a transform's poses\n * live in the scene's overrides, not on its handle. Boxed through `boxOf`\n * either way, since a consumer `boundsOf` answers for the document pose only.\n */\nexport function useInFlightBounds<TPose>(args: {\n  gestureSource: GestureSource | undefined;\n  /** Read through a ref, so a change mid-gesture rebuilds nothing. */\n  previewPoseExtra: ((id: string) => unknown) | undefined;\n  boxOf: (id: string, pose: TPose) => Bounds | null;\n  /** The node's effective world pose. */\n  committedPoseOf: (id: string) => TPose | null;\n  /** Where `id` is drawn if it stores `stored`: a previewed pose is in the\n   *  frame the node is stored in, as a published override is. Absent means\n   *  stored poses are world. */\n  worldOfStored?: ((id: string, stored: TPose) => TPose) | undefined;\n}): {\n  previewPoseOf: (id: string) => TPose | null;\n  previewBoundsOf: (id: string) => Bounds | null;\n} {\n  const { gestureSource, boxOf, committedPoseOf, worldOfStored } = args;\n  const previewPoseExtraRef = useLatest(args.previewPoseExtra);\n  const previewPoseOf = useCallback((id: string): TPose | null => {\n    const p = previewPoseExtraRef.current?.(id);\n    if (p == null) return null;\n    return worldOfStored ? worldOfStored(id, p as TPose) : (p as TPose);\n  }, [previewPoseExtraRef, worldOfStored]);\n\n  // The source's ids, re-read only when its version moves.\n  const inFlight = useRef<{ source: GestureSource; version: number; ids: ReadonlySet<string> } | null>(null);\n  const isInFlight = useCallback((id: string): boolean => {\n    if (!gestureSource) return false;\n    const version = gestureSource.getVersion();\n    let entry = inFlight.current;\n    if (entry === null || entry.source !== gestureSource || entry.version !== version) {\n      entry = { source: gestureSource, version, ids: new Set(gestureSource.ids() ?? []) };\n      inFlight.current = entry;\n    }\n    return entry.ids.has(id);\n  }, [gestureSource]);\n\n  const previewBoundsOf = useCallback((id: string): Bounds | null => {\n    const p = previewPoseOf(id);\n    if (p != null) return boxOf(id, p);\n    if (!isInFlight(id)) return null;\n    const shown = committedPoseOf(id);\n    return shown != null ? boxOf(id, shown) : null;\n  }, [previewPoseOf, boxOf, isInFlight, committedPoseOf]);\n\n  return { previewPoseOf, previewBoundsOf };\n}\n"],"mappings":";;;;;;;;;;AAWA,SAAgB,kBAAyB,MAcvC;CACA,MAAM,EAAE,eAAe,OAAO,iBAAiB,kBAAkB;CACjE,MAAM,sBAAsB,UAAU,KAAK,gBAAgB;CAC3D,MAAM,gBAAgB,aAAa,OAA6B;EAC9D,MAAM,IAAI,oBAAoB,UAAU,EAAE;EAC1C,IAAI,KAAK,MAAM,OAAO;EACtB,OAAO,gBAAgB,cAAc,IAAI,CAAU,IAAK;CAC1D,GAAG,CAAC,qBAAqB,aAAa,CAAC;CAGvC,MAAM,WAAW,OAAoF,IAAI;CACzG,MAAM,aAAa,aAAa,OAAwB;EACtD,IAAI,CAAC,eAAe,OAAO;EAC3B,MAAM,UAAU,cAAc,WAAW;EACzC,IAAI,QAAQ,SAAS;EACrB,IAAI,UAAU,QAAQ,MAAM,WAAW,iBAAiB,MAAM,YAAY,SAAS;GACjF,QAAQ;IAAE,QAAQ;IAAe;IAAS,KAAK,IAAI,IAAI,cAAc,IAAI,KAAK,CAAC,CAAC;GAAE;GAClF,SAAS,UAAU;EACrB;EACA,OAAO,MAAM,IAAI,IAAI,EAAE;CACzB,GAAG,CAAC,aAAa,CAAC;CAUlB,OAAO;EAAE;EAAe,iBARA,aAAa,OAA8B;GACjE,MAAM,IAAI,cAAc,EAAE;GAC1B,IAAI,KAAK,MAAM,OAAO,MAAM,IAAI,CAAC;GACjC,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO;GAC5B,MAAM,QAAQ,gBAAgB,EAAE;GAChC,OAAO,SAAS,OAAO,MAAM,IAAI,KAAK,IAAI;EAC5C,GAAG;GAAC;GAAe;GAAO;GAAY;EAAe,CAE7B;CAAgB;AAC1C"}

package/dist/canvas/useLateContentRedraw.js

@@ -3,7 +3,7 @@ import { subscribeImageReady } from "@weasel-js/renderer";
 import { useEffect } from "react";
 import { subscribeGlyphReady } from "@weasel-js/font";
 
-//#region src/canvas/useLateContentRedraw.ts
+// src/canvas/useLateContentRedraw.ts
 /**
 * Repaint whenever something a frame could not draw becomes drawable: an image
 * finishes decoding, a deferred glyph bake or font load lands, or a paint kind
@@ -23,6 +23,5 @@ function useLateContentRedraw(requestRedraw) {
 	}, [requestRedraw]);
 }
 
-//#endregion
 export { useLateContentRedraw };
 //# sourceMappingURL=useLateContentRedraw.js.map

package/dist/canvas/useLayerStack.js

@@ -1,9 +1,9 @@
 import { createBackgroundFillLayer } from "../core/layers/backgroundFill.js";
-import { isCustomEntry } from "./layerSlots.js";
 import { composeOrderedLayers, placeToolOverlays } from "./layerOrder.js";
+import { isCustomEntry } from "./layerSlots.js";
 import { useCallback, useEffect, useMemo, useSyncExternalStore } from "react";
 
-//#region src/canvas/useLayerStack.ts
+// src/canvas/useLayerStack.ts
 /** The `layers` prop's slots and custom entries in draw order, with the background fill beneath,
 *  the decoration layer above, and the active tool's overlays placed among them. */
 function useSlotLayers(layersMap, tools, backgroundFill, decorationLayer) {
@@ -71,6 +71,5 @@ function useComposedLayers(layers, above, requestRedraw) {
 	return composed;
 }
 
-//#endregion
 export { useComposedLayers, useSlotLayers };
 //# sourceMappingURL=useLayerStack.js.map

package/dist/canvas/usePaintedCursor.js

@@ -2,7 +2,7 @@ import { createPaintedCursorLayer } from "./paintedCursorLayer.js";
 import { useEffect, useMemo } from "react";
 import { createCursorSink, createPaintedCursorState } from "@weasel-js/cursor";
 
-//#region src/canvas/usePaintedCursor.ts
+// src/canvas/usePaintedCursor.ts
 /**
 * The painted cursor tier's channel. The canvas owns it because it owns both ends: the tool
 * cursor that feeds it and the frame loop that has to repaint when it changes.
@@ -23,6 +23,5 @@ function usePaintedCursor(canvasRef, requestRedraw) {
 	};
 }
 
-//#endregion
 export { usePaintedCursor };
 //# sourceMappingURL=usePaintedCursor.js.map