@weasel-js/core 1.15.0 → 1.15.2

package/dist/core/scene/renderOrder.js

@@ -1,6 +1,6 @@
 import { hasChildren } from "./treeShape.js";
 
-//#region src/core/scene/renderOrder.ts
+// src/core/scene/renderOrder.ts
 /**
 * A scene's render order: its nodes layer-major, each layer in tree preorder,
 * cached until the structure changes.
@@ -131,6 +131,5 @@ function createRenderOrder(state) {
 	};
 }
 
-//#endregion
 export { createRenderOrder };
 //# sourceMappingURL=renderOrder.js.map

package/dist/core/scene/sameValue.js

@@ -1,6 +1,6 @@
 import { isPlainObject } from "../isPlainObject.js";
 
-//#region src/core/scene/sameValue.ts
+// src/core/scene/sameValue.ts
 /** Structural equality over plain objects and arrays; anything else by identity. */
 function sameValue(a, b) {
 	if (Object.is(a, b)) return true;
@@ -12,6 +12,5 @@ function sameValue(a, b) {
 	return false;
 }
 
-//#endregion
 export { sameValue };
 //# sourceMappingURL=sameValue.js.map

package/dist/core/scene/scene.js

@@ -1,24 +1,24 @@
-import { RIGID_POSE_COMPOSITION } from "./composePose.js";
-import { effectivePose } from "./effectivePose.js";
-import { createScrollOffsets } from "./scrollOffsets.js";
-import { asNodeId } from "./types.js";
-import { documentReads, sceneMutators } from "./sceneMutators.js";
 import { withKitRegistry } from "./kitRegistry.js";
 import { createPoseOverrides } from "./poseOverrides.js";
+import { createScrollOffsets } from "./scrollOffsets.js";
 import { createArrivalWindow } from "./arrivalWindow.js";
+import { documentReads, sceneMutators } from "./sceneMutators.js";
 import { createNotifier } from "./notifier.js";
 import { sceneChanges } from "./sceneChanges.js";
 import { createPoseWriteLog } from "./poseWrites.js";
+import { effectivePose } from "./effectivePose.js";
 import { createEditMode } from "./editMode.js";
-import { resolveLayoutFrame, runLayoutPass } from "./layoutPass.js";
-import { systemLayerRecord } from "./layerStack.js";
 import { createSceneEdits } from "./sceneEdits.js";
 import { createSceneRecording } from "./sceneRecording.js";
 import { createSceneSelection } from "./sceneSelection.js";
-import { layerFromSerialized, specsFromSerialized } from "./serialization.js";
 import { createSceneState } from "./sceneState.js";
+import { systemLayerRecord } from "./layerStack.js";
+import { layerFromSerialized, specsFromSerialized } from "./serialization.js";
+import { resolveLayoutFrame, runLayoutPass } from "./layoutPass.js";
+import { RIGID_POSE_COMPOSITION } from "./composePose.js";
+import { asNodeId } from "./types.js";
 
-//#region src/core/scene/scene.ts
+// src/core/scene/scene.ts
 /** A node still in `scene`, with the pose it is shown at. */
 function shownNode(scene, id) {
 	const node = scene.get(id);
@@ -29,6 +29,17 @@ function shownNode(scene, id) {
 }
 var defaultIdCounter = 0;
 var defaultGenerateId = () => asNodeId(`n${(defaultIdCounter++).toString(36)}-${Math.random().toString(36).slice(2, 8)}`);
+/** `mint`, passing over any id `taken` already holds: a document reloaded into a new session keeps the ids the last
+*  session minted, and a generator restarted with the session can mint them again. */
+function freshIds(mint, taken) {
+	return () => {
+		for (let tries = 0; tries < 1e3; tries++) {
+			const id = mint();
+			if (!taken(id)) return id;
+		}
+		throw new Error("scene: generateId gave 1000 ids the scene already holds");
+	};
+}
 /** Build a scene outside React. `useScene` is the usual entry point; reach for
 *  this in tests, in headless rendering, or wherever a scene must outlive a
 *  component. Throws if no system layers are declared. */
@@ -58,8 +69,8 @@ function buildScene(options, layers, initialNodes, initialDoc) {
 		recordsBareEdits: () => !mode.open(),
 		writePose
 	});
-	const generateId = options.generateId ?? defaultGenerateId;
-	const selection = createSceneSelection(locks.reachable);
+	const generateId = freshIds(options.generateId ?? defaultGenerateId, (id) => state.nodes.has(id));
+	const selection = createSceneSelection(locks.reachable, (id) => state.nodes.get(id)?.parent);
 	selection.subscribe(notifier.notify);
 	/** Ephemeral, deliberately not part of `state`: not document content, never in `toJSON` or history. */
 	const overrides = createPoseOverrides((id) => state.nodes.get(id), doc.store.invalidateDependents);
@@ -133,7 +144,7 @@ function buildScene(options, layers, initialNodes, initialDoc) {
 			doc.reset(json.systemLayers.map(layerFromSerialized), json.doc);
 			recording.clearHistory();
 			poseWrites.quiet(() => edits.construct(specs));
-			selection.replace(locks.reachable(selection.get().filter((id) => state.nodes.has(id))));
+			selection.replace(selection.legal(selection.get().filter((id) => state.nodes.has(id))));
 			notifier.notify();
 		},
 		...sceneChanges(notifier, selection)
@@ -154,6 +165,5 @@ function sceneFromJSON(json, options = {}) {
 	return buildScene(options, json.systemLayers.map(layerFromSerialized), (registry) => specsFromSerialized(json, registry, options), json.doc);
 }
 
-//#endregion
 export { createScene, sceneFromJSON };
 //# sourceMappingURL=scene.js.map

package/dist/core/scene/scene.js.map

@@ -1 +1 @@
-{"version":3,"file":"scene.js","names":[],"sources":["../../../src/core/scene/scene.ts"],"sourcesContent":["import { withKitRegistry } from './kitRegistry';\nimport { createPoseOverrides } from './poseOverrides';\nimport { createScrollOffsets } from './scrollOffsets';\nimport { createArrivalWindow } from './arrivalWindow';\nimport { documentReads, sceneMutators } from './sceneMutators';\nimport { createNotifier } from './notifier';\nimport type { SerializedDoc } from './docValues';\nimport { sceneChanges } from './sceneChanges';\nimport { createPoseWriteLog } from './poseWrites';\nimport { effectivePose } from './effectivePose';\nimport { createEditMode } from './editMode';\nimport { createSceneEdits } from './sceneEdits';\nimport { createSceneRecording } from './sceneRecording';\nimport { createSceneSelection } from './sceneSelection';\nimport { createSceneState } from './sceneState';\nimport { systemLayerRecord } from './layerStack';\nimport { layerFromSerialized, specsFromSerialized, type SpecsFromSerializedOptions } from './serialization';\nimport { resolveLayoutFrame, runLayoutPass } from './layoutPass';\nimport type { PoseComposition } from './composeFrame';\nimport { RIGID_POSE_COMPOSITION } from './composePose';\nimport type { SceneOptions } from './useSceneOptions';\nimport {\n  asNodeId,\n  type AddNodeSpec,\n  type LayerRecord,\n  type NodeId,\n  type RegisteredOp,\n  type Scene,\n  type SceneRegistry,\n  type SavedScene,\n  type UseSceneOptions,\n} from './types';\n\n/** A node still in `scene`, with the pose it is shown at. */\nfunction shownNode<TData, TLayer extends string, TPose>(scene: Scene<TData, TLayer, TPose>, id: NodeId) {\n  const node = scene.get(id);\n  return node && { node, pose: effectivePose(scene, node) };\n}\n\nlet defaultIdCounter = 0;\nconst defaultGenerateId = (): NodeId =>\n  asNodeId(`n${(defaultIdCounter++).toString(36)}-${Math.random().toString(36).slice(2, 8)}`);\n\n/** Build a scene outside React. `useScene` is the usual entry point; reach for\n *  this in tests, in headless rendering, or wherever a scene must outlive a\n *  component. Throws if no system layers are declared. */\nexport function createScene<TData, TLayer extends string, TPose = import('./composePose').RectPose>(\n  options: UseSceneOptions<TData, TLayer, TPose>,\n): Scene<TData, TLayer, TPose> {\n  return buildScene(options, (options.systemLayers ?? []).map(systemLayerRecord), () => options.initial, options.doc);\n}\n\ntype SceneConfig<TData, TLayer extends string, TPose> =\n  Omit<SceneOptions<TData, TLayer, TPose>, 'systemLayers' | 'initial' | 'doc'>;\n\n/** A scene holding `layers`, the document values `initialDoc`, and the nodes\n *  `initialNodes` answers with once it is handed the registry their functions\n *  resolve against. */\nfunction buildScene<TData, TLayer extends string, TPose>(\n  options: SceneConfig<TData, TLayer, TPose>,\n  layers: readonly LayerRecord<TLayer>[],\n  initialNodes: (registry: SceneRegistry<TPose, TData, TLayer>) => readonly AddNodeSpec<TData, TLayer, TPose>[] | undefined,\n  initialDoc: SerializedDoc | undefined,\n): Scene<TData, TLayer, TPose> {\n  if (layers.length === 0) throw new Error('Scene: systemLayers must declare at least one layer');\n\n  // The kit's own registry entries sit under the consumer's, so a snapshot carrying a kit-attached\n  // function (a grouped container's derived pose) reloads in any scene, not only one that registered it.\n  const registry = withKitRegistry(options.registry ?? {});\n\n  const doc = createSceneState<TData, TLayer, TPose>(registry, layers, () => arrivals.layoutDeclared(), initialDoc);\n  const { state, locks, reads } = doc;\n  const notifier = createNotifier();\n  const mode = createEditMode();\n  const poseWrites = createPoseWriteLog({ untracked: mode.untracked, changes: notifier, shown: (id) => shownNode(scene, id) });\n  const writePose = (id: string, pose: unknown): void => poseWrites.layout(() => scene.setPose(asNodeId(id), pose as TPose));\n\n  const layoutFrame = resolveLayoutFrame(options.layoutFrame);\n  const arrivals = createArrivalWindow<TData, TLayer, TPose>({\n    nodes: state.nodes,\n    layoutPass: (arrived, touched, departed) =>\n      runLayoutPass(scene, reads.layoutOf, arrived, touched, layoutFrame, departed),\n    recordsBareEdits: () => !mode.open(),\n    writePose,\n  });\n\n  const generateId = options.generateId ?? defaultGenerateId;\n  const selection = createSceneSelection(locks.reachable);\n  // A selection change is a scene change to every subscriber.\n  selection.subscribe(notifier.notify);\n\n  /** Ephemeral, deliberately not part of `state`: not document content, never in `toJSON` or history. */\n  const overrides = createPoseOverrides<TPose, TData>((id) => state.nodes.get(id), doc.store.invalidateDependents);\n  const scroll = createScrollOffsets();\n\n  const recording = createSceneRecording({\n    notifier,\n    mode,\n    passAdapter: () => ({ ...sceneMutators(scene), ...documentReads(scene) }),\n    stale: doc.stale,\n    lifted: locks.lifted,\n    selection,\n    arrivals,\n    writePose,\n    poseWrites,\n    config: options,\n  });\n\n  const edits = createSceneEdits<TData, TLayer, TPose>({\n    state,\n    store: doc.store,\n    locks,\n    layers: doc.layers,\n    invalidateOrder: doc.order.invalidate,\n    fnFields: doc.fnFields,\n    ops: { ...recording.ops, register: poseWrites.reporting(recording.ops.register) },\n    recorder: recording.recorder,\n    arrivals,\n    layoutFrame,\n    generateId,\n    narrowSelection: selection.narrow,\n    clearOverride: overrides.clear,\n  });\n  for (const [kind, handler] of Object.entries(options.ops ?? {})) recording.ops.register(kind, handler);\n\n  const scene: Scene<TData, TLayer, TPose> = {\n    get nodes() { return state.nodes; },\n    get roots() { return state.roots; },\n    get layers() { return state.layers; },\n    registry,\n\n    ...reads,\n\n    mintId: generateId,\n    composition: options.composition ?? (RIGID_POSE_COMPOSITION as PoseComposition<TPose>),\n\n    ...edits.methods,\n    ...recording.methods,\n\n    unlocked: (fn) => locks.lifted(fn),\n\n    setArrivalHandler: arrivals.setHandler,\n    onReflow: arrivals.onReflow,\n    onPoseWrite: poseWrites.subscribe,\n\n    overrides,\n    scroll,\n\n    getSelection: selection.get,\n    setSelection: (ids) => selection.set([...ids]),\n\n    loadState(json, opts) {\n      // Validate + map up front: throws on a bad version or registry key before live state is touched.\n      const specs = specsFromSerialized(json, registry, { composition: scene.composition, ...opts });\n      if (mode.open()) {\n        throw new Error('Scene: cannot loadState inside another edit — it replaces the state that edit would revert to');\n      }\n      // Ephemeral, and every id is a new node after this.\n      overrides.clearAll();\n      scroll.clearAll();\n      doc.reset(json.systemLayers.map(layerFromSerialized), json.doc);\n      recording.clearHistory();\n      poseWrites.quiet(() => edits.construct(specs));\n      selection.replace(locks.reachable(selection.get().filter((id) => state.nodes.has(id))));\n      notifier.notify();\n    },\n\n    ...sceneChanges(notifier, selection),\n  };\n\n  const initial = initialNodes(registry);\n  if (initial) {\n    poseWrites.quiet(() => edits.construct(initial));\n    notifier.notify();\n  }\n\n  return scene;\n}\n\n/** Reconstruct a Scene from a JSON snapshot produced by `scene.toJSON()`.\n *  Function fields (e.g., `clipFromPose`) are resolved by string key via the\n *  registry passed in `options`. Throws on unknown version, unknown registry\n *  keys, or invalid scene shape (cross-layer subtrees, unknown layer ids).\n *  The scene starts with empty history. */\nexport function sceneFromJSON<TData, TLayer extends string, TPose>(\n  json: SavedScene<TData, TLayer, TPose>,\n  options: {\n    registry?: SceneRegistry<TPose, TData, TLayer>;\n    historyLimit?: number;\n    coalesceWindowMs?: number;\n    generateId?: () => NodeId;\n    ops?: Readonly<Record<string, RegisteredOp<unknown>>>;\n    composition?: SceneOptions<TData, TLayer, TPose>['composition'];\n    layoutFrame?: SceneOptions<TData, TLayer, TPose>['layoutFrame'];\n  } & SpecsFromSerializedOptions<TData, TLayer, TPose> = {},\n): Scene<TData, TLayer, TPose> {\n  return buildScene(\n    options,\n    json.systemLayers.map(layerFromSerialized),\n    (registry) => specsFromSerialized(json, registry, options),\n    json.doc,\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"scene.js","names":[],"sources":["../../../src/core/scene/scene.ts"],"sourcesContent":["import { withKitRegistry } from './kitRegistry';\nimport { createPoseOverrides } from './poseOverrides';\nimport { createScrollOffsets } from './scrollOffsets';\nimport { createArrivalWindow } from './arrivalWindow';\nimport { documentReads, sceneMutators } from './sceneMutators';\nimport { createNotifier } from './notifier';\nimport type { SerializedDoc } from './docValues';\nimport { sceneChanges } from './sceneChanges';\nimport { createPoseWriteLog } from './poseWrites';\nimport { effectivePose } from './effectivePose';\nimport { createEditMode } from './editMode';\nimport { createSceneEdits } from './sceneEdits';\nimport { createSceneRecording } from './sceneRecording';\nimport { createSceneSelection } from './sceneSelection';\nimport { createSceneState } from './sceneState';\nimport { systemLayerRecord } from './layerStack';\nimport { layerFromSerialized, specsFromSerialized, type SpecsFromSerializedOptions } from './serialization';\nimport { resolveLayoutFrame, runLayoutPass } from './layoutPass';\nimport type { PoseComposition } from './composeFrame';\nimport { RIGID_POSE_COMPOSITION } from './composePose';\nimport type { SceneOptions } from './useSceneOptions';\nimport {\n  asNodeId,\n  type AddNodeSpec,\n  type LayerRecord,\n  type NodeId,\n  type RegisteredOp,\n  type Scene,\n  type SceneRegistry,\n  type SavedScene,\n  type UseSceneOptions,\n} from './types';\n\n/** A node still in `scene`, with the pose it is shown at. */\nfunction shownNode<TData, TLayer extends string, TPose>(scene: Scene<TData, TLayer, TPose>, id: NodeId) {\n  const node = scene.get(id);\n  return node && { node, pose: effectivePose(scene, node) };\n}\n\nlet defaultIdCounter = 0;\nconst defaultGenerateId = (): NodeId =>\n  asNodeId(`n${(defaultIdCounter++).toString(36)}-${Math.random().toString(36).slice(2, 8)}`);\n\n/** `mint`, passing over any id `taken` already holds: a document reloaded into a new session keeps the ids the last\n *  session minted, and a generator restarted with the session can mint them again. */\nfunction freshIds(mint: () => NodeId, taken: (id: NodeId) => boolean): () => NodeId {\n  return () => {\n    for (let tries = 0; tries < 1000; tries++) {\n      const id = mint();\n      if (!taken(id)) return id;\n    }\n    throw new Error('scene: generateId gave 1000 ids the scene already holds');\n  };\n}\n\n/** Build a scene outside React. `useScene` is the usual entry point; reach for\n *  this in tests, in headless rendering, or wherever a scene must outlive a\n *  component. Throws if no system layers are declared. */\nexport function createScene<TData, TLayer extends string, TPose = import('./composePose').RectPose>(\n  options: UseSceneOptions<TData, TLayer, TPose>,\n): Scene<TData, TLayer, TPose> {\n  return buildScene(options, (options.systemLayers ?? []).map(systemLayerRecord), () => options.initial, options.doc);\n}\n\ntype SceneConfig<TData, TLayer extends string, TPose> =\n  Omit<SceneOptions<TData, TLayer, TPose>, 'systemLayers' | 'initial' | 'doc'>;\n\n/** A scene holding `layers`, the document values `initialDoc`, and the nodes\n *  `initialNodes` answers with once it is handed the registry their functions\n *  resolve against. */\nfunction buildScene<TData, TLayer extends string, TPose>(\n  options: SceneConfig<TData, TLayer, TPose>,\n  layers: readonly LayerRecord<TLayer>[],\n  initialNodes: (registry: SceneRegistry<TPose, TData, TLayer>) => readonly AddNodeSpec<TData, TLayer, TPose>[] | undefined,\n  initialDoc: SerializedDoc | undefined,\n): Scene<TData, TLayer, TPose> {\n  if (layers.length === 0) throw new Error('Scene: systemLayers must declare at least one layer');\n\n  // The kit's own registry entries sit under the consumer's, so a snapshot carrying a kit-attached\n  // function (a grouped container's derived pose) reloads in any scene, not only one that registered it.\n  const registry = withKitRegistry(options.registry ?? {});\n\n  const doc = createSceneState<TData, TLayer, TPose>(registry, layers, () => arrivals.layoutDeclared(), initialDoc);\n  const { state, locks, reads } = doc;\n  const notifier = createNotifier();\n  const mode = createEditMode();\n  const poseWrites = createPoseWriteLog({ untracked: mode.untracked, changes: notifier, shown: (id) => shownNode(scene, id) });\n  const writePose = (id: string, pose: unknown): void => poseWrites.layout(() => scene.setPose(asNodeId(id), pose as TPose));\n\n  const layoutFrame = resolveLayoutFrame(options.layoutFrame);\n  const arrivals = createArrivalWindow<TData, TLayer, TPose>({\n    nodes: state.nodes,\n    layoutPass: (arrived, touched, departed) =>\n      runLayoutPass(scene, reads.layoutOf, arrived, touched, layoutFrame, departed),\n    recordsBareEdits: () => !mode.open(),\n    writePose,\n  });\n\n  const generateId = freshIds(options.generateId ?? defaultGenerateId, (id) => state.nodes.has(id));\n  const selection = createSceneSelection(locks.reachable, (id) => state.nodes.get(id)?.parent);\n  // A selection change is a scene change to every subscriber.\n  selection.subscribe(notifier.notify);\n\n  /** Ephemeral, deliberately not part of `state`: not document content, never in `toJSON` or history. */\n  const overrides = createPoseOverrides<TPose, TData>((id) => state.nodes.get(id), doc.store.invalidateDependents);\n  const scroll = createScrollOffsets();\n\n  const recording = createSceneRecording({\n    notifier,\n    mode,\n    passAdapter: () => ({ ...sceneMutators(scene), ...documentReads(scene) }),\n    stale: doc.stale,\n    lifted: locks.lifted,\n    selection,\n    arrivals,\n    writePose,\n    poseWrites,\n    config: options,\n  });\n\n  const edits = createSceneEdits<TData, TLayer, TPose>({\n    state,\n    store: doc.store,\n    locks,\n    layers: doc.layers,\n    invalidateOrder: doc.order.invalidate,\n    fnFields: doc.fnFields,\n    ops: { ...recording.ops, register: poseWrites.reporting(recording.ops.register) },\n    recorder: recording.recorder,\n    arrivals,\n    layoutFrame,\n    generateId,\n    narrowSelection: selection.narrow,\n    clearOverride: overrides.clear,\n  });\n  for (const [kind, handler] of Object.entries(options.ops ?? {})) recording.ops.register(kind, handler);\n\n  const scene: Scene<TData, TLayer, TPose> = {\n    get nodes() { return state.nodes; },\n    get roots() { return state.roots; },\n    get layers() { return state.layers; },\n    registry,\n\n    ...reads,\n\n    mintId: generateId,\n    composition: options.composition ?? (RIGID_POSE_COMPOSITION as PoseComposition<TPose>),\n\n    ...edits.methods,\n    ...recording.methods,\n\n    unlocked: (fn) => locks.lifted(fn),\n\n    setArrivalHandler: arrivals.setHandler,\n    onReflow: arrivals.onReflow,\n    onPoseWrite: poseWrites.subscribe,\n\n    overrides,\n    scroll,\n\n    getSelection: selection.get,\n    setSelection: (ids) => selection.set([...ids]),\n\n    loadState(json, opts) {\n      // Validate + map up front: throws on a bad version or registry key before live state is touched.\n      const specs = specsFromSerialized(json, registry, { composition: scene.composition, ...opts });\n      if (mode.open()) {\n        throw new Error('Scene: cannot loadState inside another edit — it replaces the state that edit would revert to');\n      }\n      // Ephemeral, and every id is a new node after this.\n      overrides.clearAll();\n      scroll.clearAll();\n      doc.reset(json.systemLayers.map(layerFromSerialized), json.doc);\n      recording.clearHistory();\n      poseWrites.quiet(() => edits.construct(specs));\n      selection.replace(selection.legal(selection.get().filter((id) => state.nodes.has(id))));\n      notifier.notify();\n    },\n\n    ...sceneChanges(notifier, selection),\n  };\n\n  const initial = initialNodes(registry);\n  if (initial) {\n    poseWrites.quiet(() => edits.construct(initial));\n    notifier.notify();\n  }\n\n  return scene;\n}\n\n/** Reconstruct a Scene from a JSON snapshot produced by `scene.toJSON()`.\n *  Function fields (e.g., `clipFromPose`) are resolved by string key via the\n *  registry passed in `options`. Throws on unknown version, unknown registry\n *  keys, or invalid scene shape (cross-layer subtrees, unknown layer ids).\n *  The scene starts with empty history. */\nexport function sceneFromJSON<TData, TLayer extends string, TPose>(\n  json: SavedScene<TData, TLayer, TPose>,\n  options: {\n    registry?: SceneRegistry<TPose, TData, TLayer>;\n    historyLimit?: number;\n    coalesceWindowMs?: number;\n    generateId?: () => NodeId;\n    ops?: Readonly<Record<string, RegisteredOp<unknown>>>;\n    composition?: SceneOptions<TData, TLayer, TPose>['composition'];\n    layoutFrame?: SceneOptions<TData, TLayer, TPose>['layoutFrame'];\n  } & SpecsFromSerializedOptions<TData, TLayer, TPose> = {},\n): Scene<TData, TLayer, TPose> {\n  return buildScene(\n    options,\n    json.systemLayers.map(layerFromSerialized),\n    (registry) => specsFromSerialized(json, registry, options),\n    json.doc,\n  );\n}\n"],"mappings":"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"}

package/dist/core/scene/sceneChanges.js

@@ -1,4 +1,4 @@
-//#region src/core/scene/sceneChanges.ts
+// src/core/scene/sceneChanges.ts
 /** A scene's change members, over its notifier and its selection's own count of changes. */
 function sceneChanges(notifier, selection) {
 	return {
@@ -8,6 +8,5 @@ function sceneChanges(notifier, selection) {
 	};
 }
 
-//#endregion
 export { sceneChanges };
 //# sourceMappingURL=sceneChanges.js.map

package/dist/core/scene/sceneEdits.js

@@ -6,7 +6,7 @@ import { createNodeFlags } from "./nodeFlags.js";
 import { createLayerEdits } from "./layerStack.js";
 import { createTreeEdits } from "./treeEdits.js";
 
-//#region src/core/scene/sceneEdits.ts
+// src/core/scene/sceneEdits.ts
 function createSceneEdits(env) {
 	const { state, store, locks, layers, fnFields, recorder, arrivals } = env;
 	const { layoutRefs } = registerKitOps({
@@ -84,6 +84,5 @@ function createSceneEdits(env) {
 	};
 }
 
-//#endregion
 export { createSceneEdits };
 //# sourceMappingURL=sceneEdits.js.map

package/dist/core/scene/sceneJournals.js

@@ -1,4 +1,4 @@
-//#region src/core/scene/sceneJournals.ts
+// src/core/scene/sceneJournals.ts
 /** A journal drives adapter mutation itself, so its applies and undos
 *  re-enter scene mutation methods the way the facade's do. */
 function wrapJournal(raw, env, open) {
@@ -73,6 +73,5 @@ function createSceneJournals(env) {
 	};
 }
 
-//#endregion
 export { createSceneJournals };
 //# sourceMappingURL=sceneJournals.js.map

package/dist/core/scene/sceneMutators.js

@@ -1,9 +1,9 @@
 import { documentPose } from "./effectivePose.js";
-import { asNodeId } from "./types.js";
 import { fnFieldsOfNode } from "./nodeFnFields.js";
 import { statedFields } from "./statedFields.js";
+import { asNodeId } from "./types.js";
 
-//#region src/core/scene/sceneMutators.ts
+// src/core/scene/sceneMutators.ts
 function sceneMutators(scene) {
 	const getChildren = (parentId) => parentId === null ? [...scene.roots] : [...scene.childrenOf(asNodeId(parentId))];
 	return {
@@ -53,6 +53,5 @@ function documentReads(scene) {
 	};
 }
 
-//#endregion
 export { documentReads, sceneMutators };
 //# sourceMappingURL=sceneMutators.js.map

package/dist/core/scene/scenePoseAdapter.js

@@ -1,7 +1,7 @@
 import { definesFrame, documentPose } from "./effectivePose.js";
 import { viewPoseAdapter } from "./scrollOffsets.js";
 
-//#region src/core/scene/scenePoseAdapter.ts
+// src/core/scene/scenePoseAdapter.ts
 /** Build a `PoseAdapter` over a `Scene` for `composePose` helpers.
 *  `getParent` returns the live parent at call time so mid-batch
 *  parent updates compose correctly. */
@@ -24,6 +24,5 @@ function sceneViewPoseAdapter(scene) {
 	return viewPoseAdapter(scene, scenePoseAdapter(scene));
 }
 
-//#endregion
 export { scenePoseAdapter, sceneViewPoseAdapter };
 //# sourceMappingURL=scenePoseAdapter.js.map

package/dist/core/scene/sceneRecording.js

@@ -6,7 +6,7 @@ import { createOpTable } from "./opTable.js";
 import { createOuterOps } from "./outerOps.js";
 import { createRecorder } from "./recorder.js";
 
-//#region src/core/scene/sceneRecording.ts
+// src/core/scene/sceneRecording.ts
 function createSceneRecording(env) {
 	const { notifier, mode, stale, lifted, selection, arrivals, config, poseWrites } = env;
 	const { notify } = notifier;
@@ -120,6 +120,5 @@ function createSceneRecording(env) {
 	};
 }
 
-//#endregion
 export { createSceneRecording };
 //# sourceMappingURL=sceneRecording.js.map

package/dist/core/scene/sceneSelection.js

@@ -1,19 +1,23 @@
 import { createEmitter } from "@weasel-js/registry";
+import { outermost } from "@weasel-js/select";
 
-//#region src/core/scene/sceneSelection.ts
-function createSceneSelection(reachable) {
+// src/core/scene/sceneSelection.ts
+function createSceneSelection(reachable, parentOf) {
+	const legal = (next) => outermost(reachable(next), parentOf);
 	let ids = [];
 	let changes = 0;
 	const changed = createEmitter();
 	return {
 		get: () => ids,
+		legal,
 		set(next) {
-			ids = reachable(next);
+			ids = legal(next);
 			changes++;
 			changed.emit();
 		},
 		narrow(gone) {
-			ids = reachable(gone !== void 0 && ids.some((id) => gone.has(id)) ? ids.filter((id) => !gone.has(id)) : ids);
+			const kept = gone !== void 0 && ids.some((id) => gone.has(id)) ? ids.filter((id) => !gone.has(id)) : ids;
+			ids = legal(kept);
 		},
 		replace(next) {
 			ids = next;
@@ -33,6 +37,5 @@ function sceneSelectionStore(scene) {
 	};
 }
 
-//#endregion
 export { createSceneSelection, sceneSelectionStore };
 //# sourceMappingURL=sceneSelection.js.map

package/dist/core/scene/sceneSelection.js.map

@@ -1 +1 @@
-{"version":3,"file":"sceneSelection.js","names":[],"sources":["../../../src/core/scene/sceneSelection.ts"],"sourcesContent":["/**\n * The scene's selection: the transient set of active ids. Not document\n * content, so it never reaches `toJSON`; it does ride on history entries.\n */\nimport type { HistorySelection } from '@weasel-js/history';\nimport { createEmitter } from '@weasel-js/registry';\nimport type { NodeId } from './types';\n\nexport interface SceneSelection {\n  get(): readonly NodeId[];\n  /** Select the ids of `ids` that are in reach, and tell subscribers. */\n  set(ids: readonly NodeId[]): void;\n  /** Drop the ids in `gone`, and any a lock has put out of reach. Tells no\n   *  one: the edit that took them is what subscribers hear about. */\n  narrow(gone?: ReadonlySet<NodeId>): void;\n  /** Put a selection in place exactly as given, telling no one: for a caller\n   *  returning what it read earlier, or one that has already filtered. */\n  replace(ids: readonly NodeId[]): void;\n  subscribe(listener: () => void): () => void;\n  /** How many times subscribers have been told the selection changed. */\n  changes(): number;\n}\n\nexport function createSceneSelection(\n  /** `ids` less those out of reach; the same array when none is. */\n  reachable: (ids: readonly NodeId[]) => readonly NodeId[],\n): SceneSelection {\n  let ids: readonly NodeId[] = [];\n  let changes = 0;\n  const changed = createEmitter();\n\n  return {\n    get: () => ids,\n    set(next) {\n      ids = reachable(next);\n      changes++;\n      changed.emit();\n    },\n    narrow(gone) {\n      // A new array only when one is dropped: readers compare the selection by identity.\n      const kept = gone !== undefined && ids.some((id) => gone.has(id)) ? ids.filter((id) => !gone.has(id)) : ids;\n      ids = reachable(kept);\n    },\n    replace(next) {\n      ids = next;\n    },\n    subscribe: changed.subscribe,\n    changes: () => changes,\n  };\n}\n\n/** The scene's selection in the shape `createHistory` wants, for a consumer\n *  building a second History over the same scene (a modality machine, a\n *  journal owner) that should restore selection the way the scene's own\n *  history does. */\nexport function sceneSelectionStore(scene: {\n  getSelection(): readonly NodeId[];\n  setSelection(ids: readonly NodeId[]): void;\n}): HistorySelection {\n  return {\n    get: () => scene.getSelection(),\n    set: (ids) => scene.setSelection(ids as readonly NodeId[]),\n  };\n}\n"],"mappings":";;;AAuBA,SAAgB,qBAEd,WACgB;CAChB,IAAI,MAAyB,CAAC;CAC9B,IAAI,UAAU;CACd,MAAM,UAAU,cAAc;CAE9B,OAAO;EACL,WAAW;EACX,IAAI,MAAM;GACR,MAAM,UAAU,IAAI;GACpB;GACA,QAAQ,KAAK;EACf;EACA,OAAO,MAAM;GAGX,MAAM,UADO,SAAS,UAAa,IAAI,MAAM,OAAO,KAAK,IAAI,EAAE,CAAC,IAAI,IAAI,QAAQ,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,GACpF;EACtB;EACA,QAAQ,MAAM;GACZ,MAAM;EACR;EACA,WAAW,QAAQ;EACnB,eAAe;CACjB;AACF;;;;;AAMA,SAAgB,oBAAoB,OAGf;CACnB,OAAO;EACL,WAAW,MAAM,aAAa;EAC9B,MAAM,QAAQ,MAAM,aAAa,GAAwB;CAC3D;AACF"}
+{"version":3,"file":"sceneSelection.js","names":[],"sources":["../../../src/core/scene/sceneSelection.ts"],"sourcesContent":["/**\n * The scene's selection: the transient set of active ids. Not document\n * content, so it never reaches `toJSON`; it does ride on history entries.\n * A selected node holds its subtree, so the selection keeps only the\n * outermost of the ids written to it.\n */\nimport type { HistorySelection } from '@weasel-js/history';\nimport { createEmitter } from '@weasel-js/registry';\nimport { outermost } from '@weasel-js/select';\nimport type { NodeId } from './types';\n\nexport interface SceneSelection {\n  get(): readonly NodeId[];\n  /** `ids` as the selection may hold them: in reach, and none held by an ancestor among them. */\n  legal(ids: readonly NodeId[]): readonly NodeId[];\n  /** Select the ids of `ids` that are in reach, and tell subscribers. */\n  set(ids: readonly NodeId[]): void;\n  /** Drop the ids in `gone`, any a lock has put out of reach, and any an\n   *  ancestor now holds. Tells no one: the edit that took them is what\n   *  subscribers hear about. */\n  narrow(gone?: ReadonlySet<NodeId>): void;\n  /** Put a selection in place exactly as given, telling no one: for a caller\n   *  returning what it read earlier, or one that has already filtered. */\n  replace(ids: readonly NodeId[]): void;\n  subscribe(listener: () => void): () => void;\n  /** How many times subscribers have been told the selection changed. */\n  changes(): number;\n}\n\nexport function createSceneSelection(\n  /** `ids` less those out of reach; the same array when none is. */\n  reachable: (ids: readonly NodeId[]) => readonly NodeId[],\n  parentOf: (id: NodeId) => NodeId | null | undefined,\n): SceneSelection {\n  const legal = (next: readonly NodeId[]) => outermost(reachable(next), parentOf);\n  let ids: readonly NodeId[] = [];\n  let changes = 0;\n  const changed = createEmitter();\n\n  return {\n    get: () => ids,\n    legal,\n    set(next) {\n      ids = legal(next);\n      changes++;\n      changed.emit();\n    },\n    narrow(gone) {\n      // A new array only when one is dropped: readers compare the selection by identity.\n      const kept = gone !== undefined && ids.some((id) => gone.has(id)) ? ids.filter((id) => !gone.has(id)) : ids;\n      ids = legal(kept);\n    },\n    replace(next) {\n      ids = next;\n    },\n    subscribe: changed.subscribe,\n    changes: () => changes,\n  };\n}\n\n/** The scene's selection in the shape `createHistory` wants, for a consumer\n *  building a second History over the same scene (a modality machine, a\n *  journal owner) that should restore selection the way the scene's own\n *  history does. */\nexport function sceneSelectionStore(scene: {\n  getSelection(): readonly NodeId[];\n  setSelection(ids: readonly NodeId[]): void;\n}): HistorySelection {\n  return {\n    get: () => scene.getSelection(),\n    set: (ids) => scene.setSelection(ids as readonly NodeId[]),\n  };\n}\n"],"mappings":";;;;AA6BA,SAAgB,qBAEd,WACA,UACgB;CAChB,MAAM,SAAS,SAA4B,UAAU,UAAU,IAAI,GAAG,QAAQ;CAC9E,IAAI,MAAyB,CAAC;CAC9B,IAAI,UAAU;CACd,MAAM,UAAU,cAAc;CAE9B,OAAO;EACL,WAAW;EACX;EACA,IAAI,MAAM;GACR,MAAM,MAAM,IAAI;GAChB;GACA,QAAQ,KAAK;EACf;EACA,OAAO,MAAM;GAEX,MAAM,OAAO,SAAS,UAAa,IAAI,MAAM,OAAO,KAAK,IAAI,EAAE,CAAC,IAAI,IAAI,QAAQ,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI;GACxG,MAAM,MAAM,IAAI;EAClB;EACA,QAAQ,MAAM;GACZ,MAAM;EACR;EACA,WAAW,QAAQ;EACnB,eAAe;CACjB;AACF;;;;;AAMA,SAAgB,oBAAoB,OAGf;CACnB,OAAO;EACL,WAAW,MAAM,aAAa;EAC9B,MAAM,QAAQ,MAAM,aAAa,GAAwB;CAC3D;AACF"}

package/dist/core/scene/sceneState.js

@@ -1,14 +1,14 @@
-import { createNodeFnFields } from "./nodeFnFields.js";
 import { createDocStore } from "./docValues.js";
 import { createLayerStack } from "./layerStack.js";
-import { createStaleReplay } from "./staleReplay.js";
 import { createLockGuard } from "./lockGuard.js";
+import { createNodeFnFields } from "./nodeFnFields.js";
 import { createNodeStore } from "./nodeStore.js";
 import { createRenderOrder } from "./renderOrder.js";
 import { serializeScene } from "./serialization.js";
+import { createStaleReplay } from "./staleReplay.js";
 import { createTreeReads } from "./treeReads.js";
 
-//#region src/core/scene/sceneState.ts
+// src/core/scene/sceneState.ts
 /**
 * A scene's document state — its nodes, roots, and layers — with the modules
 * that read and write it directly.
@@ -67,6 +67,5 @@ function createSceneState(registry, initialLayers, layoutDeclared, initialDoc) {
 	};
 }
 
-//#endregion
 export { createSceneState };
 //# sourceMappingURL=sceneState.js.map

package/dist/core/scene/scrollOffsets.js

@@ -1,7 +1,7 @@
 import { isDocument } from "./documentOf.js";
 import { createEmitter } from "@weasel-js/registry";
 
-//#region src/core/scene/scrollOffsets.ts
+// src/core/scene/scrollOffsets.ts
 /**
 * How far each container's content is scrolled: view state, never document.
 *
@@ -88,6 +88,5 @@ function viewPoseAdapter(scene, adapter) {
 	};
 }
 
-//#endregion
 export { createScrollOffsets, scrolledFrames, viewPoseAdapter };
 //# sourceMappingURL=scrollOffsets.js.map

package/dist/core/scene/serialization.js

@@ -1,9 +1,9 @@
-import { RIGID_POSE_COMPOSITION } from "./composePose.js";
 import { NODE_FN_FIELDS, fnKeysOf } from "./nodeFnFields.js";
 import { treePreorder } from "./treeOrder.js";
+import { RIGID_POSE_COMPOSITION } from "./composePose.js";
 import { localizeWorldPoses } from "./worldSave.js";
 
-//#region src/core/scene/serialization.ts
+// src/core/scene/serialization.ts
 /**
 * A scene to and from its JSON snapshot: the walk that writes one, and the
 * two readers that turn one back into layer records and node specs.
@@ -151,6 +151,5 @@ function nodeKindOf(version, n, classify) {
 	return classify ? classify(n) : "group";
 }
 
-//#endregion
 export { isSerializedScene, layerFromSerialized, nodeKindOf, serializeScene, specsFromSerialized };
 //# sourceMappingURL=serialization.js.map

package/dist/core/scene/staleReplay.js

@@ -1,6 +1,6 @@
 import { hasChildren } from "./treeShape.js";
 
-//#region src/core/scene/staleReplay.ts
+// src/core/scene/staleReplay.ts
 /** A scene edit named a node the scene does not hold, or one it already does. */
 var SceneMembershipError = class extends Error {};
 function createStaleReplay(nodes) {
@@ -58,6 +58,5 @@ function createStaleReplay(nodes) {
 	};
 }
 
-//#endregion
 export { SceneMembershipError, createStaleReplay };
 //# sourceMappingURL=staleReplay.js.map

package/dist/core/scene/statedFields.js

@@ -1,4 +1,4 @@
-//#region src/core/scene/statedFields.ts
+// src/core/scene/statedFields.ts
 /** The plain optional fields of a node or spec as a spread for `scene.add`:
 *  each present only when stated, so an unstated one keeps the scene's
 *  default, and a flag states only `true`. What a copy of a node carries over
@@ -14,6 +14,5 @@ function statedFields(n) {
 	return out;
 }
 
-//#endregion
 export { statedFields };
 //# sourceMappingURL=statedFields.js.map

package/dist/core/scene/strategyView.js

@@ -1,6 +1,6 @@
 import { samePoseValue } from "./poseSnapshot.js";
 
-//#region src/core/scene/strategyView.ts
+// src/core/scene/strategyView.ts
 /**
 * How a strategy sees a container at world `pose`: upright, in its own frame,
 * moved so its box is centered on the box `measure` gives the world pose. A
@@ -30,6 +30,5 @@ function strategyView(pose, { compose, decompose }, measure, place) {
 	};
 }
 
-//#endregion
 export { strategyView };
 //# sourceMappingURL=strategyView.js.map

package/dist/core/scene/treeEdits.js

@@ -1,8 +1,8 @@
 import { fnKeysOf } from "./nodeFnFields.js";
-import { statedFields } from "./statedFields.js";
 import { SceneMembershipError } from "./staleReplay.js";
+import { statedFields } from "./statedFields.js";
 
-//#region src/core/scene/treeEdits.ts
+// src/core/scene/treeEdits.ts
 /** What `kit:remove` carries for the nodes `ids`, read before any of them
 *  goes. Throws on an id that is not in the scene. */
 function removeSnapshot(ids, removing, store, fnFields) {
@@ -146,6 +146,5 @@ function createTreeEdits(env) {
 	};
 }
 
-//#endregion
 export { createTreeEdits };
 //# sourceMappingURL=treeEdits.js.map

package/dist/core/scene/treeOrder.js

@@ -1,6 +1,6 @@
 import { hasChildren } from "./treeShape.js";
 
-//#region src/core/scene/treeOrder.ts
+// src/core/scene/treeOrder.ts
 /** Every node reachable from `roots`, in tree preorder: a parent before its
 *  children, siblings in sibling order, whatever layer each sits on. */
 function treePreorder(roots, nodes) {
@@ -15,6 +15,5 @@ function treePreorder(roots, nodes) {
 	return out;
 }
 
-//#endregion
 export { treePreorder };
 //# sourceMappingURL=treeOrder.js.map

package/dist/core/scene/treeReads.js

@@ -1,4 +1,4 @@
-//#region src/core/scene/treeReads.ts
+// src/core/scene/treeReads.ts
 function createTreeReads(nodes) {
 	const incarnations = /* @__PURE__ */ new WeakMap();
 	let nextIncarnation = 1;
@@ -29,6 +29,5 @@ function createTreeReads(nodes) {
 	};
 }
 
-//#endregion
 export { createTreeReads };
 //# sourceMappingURL=treeReads.js.map

package/dist/core/scene/treeShape.js

@@ -1,4 +1,4 @@
-//#region src/core/scene/treeShape.ts
+// src/core/scene/treeShape.ts
 /** True for a node with no children: absent and empty are the same thing. */
 function isLeaf(node) {
 	return node.children === void 0 || node.children.length === 0;
@@ -8,6 +8,5 @@ function hasChildren(node) {
 	return node.children !== void 0 && node.children.length > 0;
 }
 
-//#endregion
 export { hasChildren, isLeaf };
 //# sourceMappingURL=treeShape.js.map

package/dist/core/scene/types.js

@@ -1,7 +1,6 @@
-//#region src/core/scene/types.ts
+// src/core/scene/types.ts
 /** Brand a string as a NodeId. */
 var asNodeId = (s) => s;
 
-//#endregion
 export { asNodeId };
 //# sourceMappingURL=types.js.map