@weasel-js/core 1.14.2 → 1.15.1

package/dist/canvas/SceneCanvas/useCanvasSelection.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCanvasSelection.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useCanvasSelection.ts"],"sourcesContent":["import { useMemo } from 'react';\nimport type { Node, NodeId, Scene } from 'core/scene/types';\nimport { readOnlySelection } from 'core/selection/readOnlySelection';\nimport { usePublishSceneSelection } from 'core/selection/usePublishSceneSelection';\nimport { useSelection, type SelectionApi, type UseSelectionOptions } from 'core/selection/useSelection';\nimport type { SceneCanvasProps } from './props';\n\n/**\n * The canvas's selection, published to any surrounding selection context.\n *\n * A caller-supplied api wins, and the one built here is then unused. The\n * built one is bound to the scene, so the selection an edit was made under\n * rides on the scene's history entries and undo can put it back.\n *\n * Everything the kit writes selection through (the `selection` dep, the\n * adapter's `setSelection`, ops committed through either) reads the returned\n * api, so on an unselectable canvas every write path here is closed. The\n * caller's own api is not wrapped and still writes.\n */\nexport function useCanvasSelection<TData, TLayer extends string, TPose>(args: {\n  scene: Scene<TData, TLayer, TPose>;\n  props: Pick<SceneCanvasProps<TData, TLayer, TPose>, 'selection' | 'selectionOptions' | 'describeKind'>;\n  selectable: boolean;\n  /** The canvas's routing kind, published for each node unless `describeKind` is given. */\n  kindOf: ((node: { kind: string; data: TData }) => string) | undefined;\n}): SelectionApi {\n  const { scene, selectable, kindOf } = args;\n  const { selection: supplied, selectionOptions: options, describeKind } = args.props;\n  const describe = useMemo(() => describeKind ?? (kindOf && ((node: Node<TData, TLayer, TPose>) => {\n    const kind = kindOf(node);\n    return kind === 'unknown' ? undefined : kind;\n  })), [describeKind, kindOf]);\n  const derivedOptions = useMemo<UseSelectionOptions>(\n    () => ({ scene, ...(options ?? {}) }),\n    [scene, options],\n  );\n  const internal = useSelection(derivedOptions);\n  const base = supplied ?? internal;\n  const selection = selectable ? base : readOnlySelection(base);\n  usePublishSceneSelection(scene, selection.current as readonly NodeId[], describe);\n  return selection;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAmBA,SAAgB,mBAAwD,MAMvD;CACf,MAAM,EAAE,OAAO,YAAY,WAAW;CACtC,MAAM,EAAE,WAAW,UAAU,kBAAkB,SAAS,iBAAiB,KAAK;CAC9E,MAAM,WAAW,cAAc,iBAAiB,YAAY,SAAqC;EAC/F,MAAM,OAAO,OAAO,IAAI;EACxB,OAAO,SAAS,YAAY,SAAY;CAC1C,KAAK,CAAC,cAAc,MAAM,CAAC;CAC3B,MAAM,iBAAiB,eACd;EAAE;EAAO,GAAI,WAAW,CAAC;CAAG,IACnC,CAAC,OAAO,OAAO,CACjB;CACA,MAAM,WAAW,aAAa,cAAc;CAC5C,MAAM,OAAO,YAAY;CACzB,MAAM,YAAY,aAAa,OAAO,kBAAkB,IAAI;CAC5D,yBAAyB,OAAO,UAAU,SAA8B,QAAQ;CAChF,OAAO;AACT"}
+{"version":3,"file":"useCanvasSelection.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useCanvasSelection.ts"],"sourcesContent":["import { useMemo } from 'react';\nimport type { Node, NodeId, Scene } from 'core/scene/types';\nimport { outermostSelection } from 'core/selection/outermostSelection';\nimport { readOnlySelection } from 'core/selection/readOnlySelection';\nimport { usePublishSceneSelection } from 'core/selection/usePublishSceneSelection';\nimport { useSelection, type SelectionApi, type UseSelectionOptions } from 'core/selection/useSelection';\nimport type { SceneCanvasProps } from './props';\n\n/**\n * The canvas's selection, published to any surrounding selection context.\n *\n * A caller-supplied api wins, and the one built here is then unused. The\n * built one is bound to the scene, so the selection an edit was made under\n * rides on the scene's history entries and undo can put it back.\n *\n * Everything the kit writes selection through (the `selection` dep, the\n * adapter's `setSelection`, ops committed through either) reads the returned\n * api, so on an unselectable canvas every write path here is closed, and a\n * caller's api kept off the scene still holds only outermost ids. The caller's\n * own api is not changed and still writes as it did.\n */\nexport function useCanvasSelection<TData, TLayer extends string, TPose>(args: {\n  scene: Scene<TData, TLayer, TPose>;\n  props: Pick<SceneCanvasProps<TData, TLayer, TPose>, 'selection' | 'selectionOptions' | 'describeKind'>;\n  selectable: boolean;\n  /** The canvas's routing kind, published for each node unless `describeKind` is given. */\n  kindOf: ((node: { kind: string; data: TData }) => string) | undefined;\n}): SelectionApi {\n  const { scene, selectable, kindOf } = args;\n  const { selection: supplied, selectionOptions: options, describeKind } = args.props;\n  const describe = useMemo(() => describeKind ?? (kindOf && ((node: Node<TData, TLayer, TPose>) => {\n    const kind = kindOf(node);\n    return kind === 'unknown' ? undefined : kind;\n  })), [describeKind, kindOf]);\n  const derivedOptions = useMemo<UseSelectionOptions>(\n    () => ({ scene, ...(options ?? {}) }),\n    [scene, options],\n  );\n  const internal = useSelection(derivedOptions);\n  const parentOf = useMemo(() => (id: NodeId) => scene.get(id)?.parent, [scene]);\n  const base = supplied ? outermostSelection(supplied, parentOf) : internal;\n  const selection = selectable ? base : readOnlySelection(base);\n  usePublishSceneSelection(scene, selection.current as readonly NodeId[], describe);\n  return selection;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,mBAAwD,MAMvD;CACf,MAAM,EAAE,OAAO,YAAY,WAAW;CACtC,MAAM,EAAE,WAAW,UAAU,kBAAkB,SAAS,iBAAiB,KAAK;CAC9E,MAAM,WAAW,cAAc,iBAAiB,YAAY,SAAqC;EAC/F,MAAM,OAAO,OAAO,IAAI;EACxB,OAAO,SAAS,YAAY,SAAY;CAC1C,KAAK,CAAC,cAAc,MAAM,CAAC;CAC3B,MAAM,iBAAiB,eACd;EAAE;EAAO,GAAI,WAAW,CAAC;CAAG,IACnC,CAAC,OAAO,OAAO,CACjB;CACA,MAAM,WAAW,aAAa,cAAc;CAC5C,MAAM,WAAW,eAAe,OAAe,MAAM,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC;CAC7E,MAAM,OAAO,WAAW,mBAAmB,UAAU,QAAQ,IAAI;CACjE,MAAM,YAAY,aAAa,OAAO,kBAAkB,IAAI;CAC5D,yBAAyB,OAAO,UAAU,SAA8B,QAAQ;CAChF,OAAO;AACT"}

package/dist/canvas/SceneCanvas/useCanvasTools.js

@@ -1,12 +1,12 @@
-import { createViewMarkerContribution } from "../../domains/viewports/viewMarkerDrag.js";
 import { createLongPressFeedbackContribution } from "../../domains/longPress/longPressFeedback.js";
+import { createViewMarkerContribution } from "../../domains/viewports/viewMarkerDrag.js";
 import { useTools } from "../../tools/overlayBinding.js";
 import { presetActions, presetAmbient, presetContributions, resolveFeatures } from "./features.js";
 import { useBuiltinTools } from "./useBuiltinTools.js";
 import { useEffect, useMemo } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/SceneCanvas/useCanvasTools.ts
+// src/canvas/SceneCanvas/useCanvasTools.ts
 /** Discriminate the polymorphic `tools` prop: `ToolsApi` has `setActive`
 *  / `active` / `registry`; the patch record shape has none of those. */
 function isToolsApi(tools) {
@@ -145,6 +145,5 @@ function useFeatureBindings(args) {
 	};
 }
 
-//#endregion
 export { useCanvasTools, useEnabledFeatures, useFeatureBindings };
 //# sourceMappingURL=useCanvasTools.js.map

package/dist/canvas/SceneCanvas/useChromeAffordances.js

@@ -1,9 +1,9 @@
 import { targetSizesPx } from "../../core/device/targets.js";
-import { chromeAffordances } from "../affordanceAt.js";
 import { useTargetBasePx } from "../../core/device/useTargetBasePx.js";
+import { chromeAffordances } from "../affordanceAt.js";
 import { useMemo } from "react";
 
-//#region src/canvas/SceneCanvas/useChromeAffordances.ts
+// src/canvas/SceneCanvas/useChromeAffordances.ts
 /** {@link chromeAffordances} sized by the device scale on the `targets` kit settings; an explicit `handleHitRadius` wins. */
 function useChromeAffordances(opts) {
 	const { targetScale, handleHitRadius, rotationBadge, getAnchorState, edgeHandles } = opts;
@@ -26,6 +26,5 @@ function useChromeAffordances(opts) {
 	]);
 }
 
-//#endregion
 export { useChromeAffordances };
 //# sourceMappingURL=useChromeAffordances.js.map

package/dist/canvas/SceneCanvas/useContributionRoles.js

@@ -1,10 +1,11 @@
+import { useToolOptionTunings } from "../../tools/toolOptions.js";
 import { checkRequirements } from "../kitRequirements.js";
 import { useContributionFrameHooks } from "./contributionFrameHooks.js";
 import { useEffect, useRef } from "react";
 import { isDev } from "@weasel-js/react";
 import { useActionsRegistry, useMenuHost, useOffhandAction, useOptionalDepRegistry } from "@weasel-js/routing/react";
 
-//#region src/canvas/SceneCanvas/useContributionRoles.ts
+// src/canvas/SceneCanvas/useContributionRoles.ts
 /**
 * `useContributionRoles` — installs the roles of every entry in the tools
 * registry that a surface owns rather than the dispatcher: its actions into the
@@ -94,6 +95,7 @@ function useContributionRoles(tools, api, versionCheck = "warn", surface = NO_SU
 		toolRegistry,
 		ambient
 	]);
+	useToolOptionTunings(registry, toolRegistry);
 	const menuHost = useMenuHost();
 	useEffect(() => {
 		if (!menuHost) return;
@@ -136,6 +138,5 @@ function registerDeps(depRegistry, deps) {
 	};
 }
 
-//#endregion
 export { contributionEntries, useContributionRoles };
 //# sourceMappingURL=useContributionRoles.js.map

package/dist/canvas/SceneCanvas/useContributionRoles.js.map

@@ -1 +1 @@
-{"version":3,"file":"useContributionRoles.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useContributionRoles.ts"],"sourcesContent":["/**\n * `useContributionRoles` — installs the roles of every entry in the tools\n * registry that a surface owns rather than the dispatcher: its actions into the\n * `<ActionsProvider>`, its deps into the dep registry, and its `attach` against\n * the mounted canvas. Views are the fourth such role; `<SceneCanvas>` renders\n * those itself, because a view is a component.\n *\n * Tool hooks run wherever the consumer calls them, which may be outside any\n * registry. Declaring roles on the entry and installing them from in here keeps\n * the tool hook callable from anywhere.\n */\nimport { useEffect, useRef } from 'react';\nimport { useActionsRegistry, useMenuHost, useOffhandAction, useOptionalDepRegistry } from '@weasel-js/routing/react';\nimport type { DepRegistry } from '@weasel-js/routing/react';\nimport type { DepName } from 'interactions/actions/depSchema';\nimport type { ToolsApi } from '../../tools/overlayBinding';\nimport type { CanvasExtensionApi } from '../canvasExtension';\nimport type { SurfaceContribution } from '../surfaceContribution';\nimport { checkRequirements, type RequirementMismatch } from '../kitRequirements';\nimport { useContributionFrameHooks } from './contributionFrameHooks';\nimport { isDev } from '@weasel-js/react';\n\n/** How a surface treats an entry whose `requires` the running kit does not\n *  meet: warn in development (the default), throw, or not check. */\nexport type VersionCheck = 'warn' | 'strict' | 'off';\n\nconst NO_DEPS = { get: () => undefined };\nconst warnedRequirements = new WeakSet<object>();\n\nfunction describeMismatch(m: RequirementMismatch): string {\n  switch (m.reason) {\n    case 'unsatisfied': return `${m.package} ${m.range} (running ${m.running})`;\n    case 'invalid-range': return `${m.package} \"${m.range}\", which is not a range this check reads`;\n    case 'unknown-package': return `${m.package} ${m.range}, but ${m.package} reports no version`;\n  }\n}\n\nfunction checkEntryRequirements(entries: readonly SurfaceContribution[], mode: VersionCheck): void {\n  if (mode === 'off') return;\n  for (const entry of entries) {\n    const requires = entry.requires;\n    if (!requires) continue;\n    if (mode === 'warn' && warnedRequirements.has(requires)) continue;\n    const mismatches = checkRequirements(requires);\n    if (mismatches.length === 0) continue;\n    const message = `[weasel] contribution \"${entry.id}\" requires ${mismatches.map(describeMismatch).join('; ')}.`;\n    if (mode === 'strict') throw new Error(message);\n    warnedRequirements.add(requires);\n    console.warn(message);\n  }\n}\n\n/** Every entry the registry holds, registry and ambient alike. */\nexport function contributionEntries(tools: Pick<ToolsApi, 'registry' | 'ambient'>): SurfaceContribution[] {\n  return [...Object.values(tools.registry), ...tools.ambient] as SurfaceContribution[];\n}\n\n/**\n * Keep one installation per key alive: install keys that appeared, tear down\n * keys that went. Keys are role objects the consumer owns, so an entry the\n * host re-wraps every render — `useTools` restates eligibility on a copy —\n * still installs once.\n */\nfunction useKeyedInstall(\n  items: ReadonlyMap<object, () => () => void>,\n): void {\n  const live = useRef(new Map<object, () => void>());\n  useEffect(() => {\n    for (const [key, teardown] of live.current) {\n      if (items.has(key)) continue;\n      teardown();\n      live.current.delete(key);\n    }\n    for (const [key, install] of items) {\n      if (live.current.has(key)) continue;\n      live.current.set(key, install());\n    }\n  });\n  useEffect(() => () => {\n    for (const teardown of live.current.values()) teardown();\n    live.current.clear();\n  }, []);\n}\n\nconst NO_SURFACE: readonly SurfaceContribution[] = [];\n\n/**\n * `surface` is the canvas's own entries installed beside a takeover, which the\n * takeover's `ToolsApi` does not hold: their deps, `watch`, `attach`, frame\n * hooks and overlay install here, the overlay as a registered layer since no\n * tool set lists it. Their actions are the canvas's standard actions, so they\n * are not registered again.\n */\nexport function useContributionRoles(\n  tools: ToolsApi,\n  api: CanvasExtensionApi | null,\n  versionCheck: VersionCheck = 'warn',\n  surface: readonly SurfaceContribution[] = NO_SURFACE,\n): void {\n  const registry = useActionsRegistry();\n  const depRegistry = useOptionalDepRegistry();\n  const { registry: toolRegistry, ambient } = tools;\n\n  useEffect(() => {\n    if (!registry) return;\n    const unregisters: Array<() => void> = [];\n    // Ambient entries included: an always-on entry owns actions its own\n    // bindings reference exactly as a registry tool does, and leaving them out\n    // gives the same silent failure this hook exists to prevent — a binding\n    // pointing at an id nothing registered.\n    for (const entry of contributionEntries({ registry: toolRegistry, ambient })) {\n      for (const action of entry.actions ?? []) {\n        unregisters.push(registry.register(action));\n      }\n    }\n    return () => { for (const u of unregisters) u(); };\n  }, [registry, toolRegistry, ambient]);\n\n  const menuHost = useMenuHost();\n  useEffect(() => {\n    if (!menuHost) return;\n    const releases: Array<() => void> = [];\n    for (const [id, entry] of Object.entries(toolRegistry)) {\n      for (const def of (entry as SurfaceContribution).menus ?? []) releases.push(menuHost.define(def, id));\n    }\n    for (const entry of ambient) {\n      for (const def of (entry as SurfaceContribution).menus ?? []) releases.push(menuHost.define(def, null));\n    }\n    return () => { for (const r of releases) r(); };\n  }, [menuHost, toolRegistry, ambient]);\n\n  const entries = [...contributionEntries(tools), ...surface];\n  // Development only for a warning; a strict surface asked to be stopped, so\n  // it throws in every build.\n  if (versionCheck === 'strict' || (versionCheck === 'warn' && isDev())) {\n    checkEntryRequirements(entries, versionCheck);\n  }\n\n  const reader = depRegistry ?? NO_DEPS;\n  const installs = new Map<object, () => () => void>();\n  for (const entry of entries) {\n    const deps = entry.deps;\n    if (deps && depRegistry) installs.set(deps, () => registerDeps(depRegistry, deps));\n    const watch = entry.watch;\n    if (watch && depRegistry) installs.set(watch, () => watch(() => depRegistry.changed?.()));\n    const attach = entry.attach;\n    if (attach && api) installs.set(attach, () => attach(api, reader));\n  }\n  for (const entry of surface) {\n    const overlay = entry.overlay;\n    if (!overlay || !api) continue;\n    for (const layer of Array.isArray(overlay) ? overlay : [overlay]) installs.set(layer, () => api.registerLayer(layer));\n  }\n  useKeyedInstall(installs);\n  useContributionFrameHooks(entries, api, reader);\n\n  // Tool assembly runs above the provider too, so its own registration of\n  // held-key engagement finds no registry unless the consumer mounted one.\n  useOffhandAction(contributionEntries(tools));\n}\n\nfunction registerDeps(\n  depRegistry: DepRegistry,\n  deps: NonNullable<SurfaceContribution['deps']>,\n): () => void {\n  const unregisters = (Object.keys(deps) as DepName[]).map((name) =>\n    depRegistry.register(name, deps[name] as never));\n  return () => { for (const u of unregisters) u(); };\n}\n"],"mappings":"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"}
+{"version":3,"file":"useContributionRoles.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useContributionRoles.ts"],"sourcesContent":["/**\n * `useContributionRoles` — installs the roles of every entry in the tools\n * registry that a surface owns rather than the dispatcher: its actions into the\n * `<ActionsProvider>`, its deps into the dep registry, and its `attach` against\n * the mounted canvas. Views are the fourth such role; `<SceneCanvas>` renders\n * those itself, because a view is a component.\n *\n * Tool hooks run wherever the consumer calls them, which may be outside any\n * registry. Declaring roles on the entry and installing them from in here keeps\n * the tool hook callable from anywhere.\n */\nimport { useEffect, useRef } from 'react';\nimport { useActionsRegistry, useMenuHost, useOffhandAction, useOptionalDepRegistry } from '@weasel-js/routing/react';\nimport type { DepRegistry } from '@weasel-js/routing/react';\nimport type { DepName } from 'interactions/actions/depSchema';\nimport { useToolOptionTunings } from 'tools/toolOptions';\nimport type { ToolsApi } from '../../tools/overlayBinding';\nimport type { CanvasExtensionApi } from '../canvasExtension';\nimport type { SurfaceContribution } from '../surfaceContribution';\nimport { checkRequirements, type RequirementMismatch } from '../kitRequirements';\nimport { useContributionFrameHooks } from './contributionFrameHooks';\nimport { isDev } from '@weasel-js/react';\n\n/** How a surface treats an entry whose `requires` the running kit does not\n *  meet: warn in development (the default), throw, or not check. */\nexport type VersionCheck = 'warn' | 'strict' | 'off';\n\nconst NO_DEPS = { get: () => undefined };\nconst warnedRequirements = new WeakSet<object>();\n\nfunction describeMismatch(m: RequirementMismatch): string {\n  switch (m.reason) {\n    case 'unsatisfied': return `${m.package} ${m.range} (running ${m.running})`;\n    case 'invalid-range': return `${m.package} \"${m.range}\", which is not a range this check reads`;\n    case 'unknown-package': return `${m.package} ${m.range}, but ${m.package} reports no version`;\n  }\n}\n\nfunction checkEntryRequirements(entries: readonly SurfaceContribution[], mode: VersionCheck): void {\n  if (mode === 'off') return;\n  for (const entry of entries) {\n    const requires = entry.requires;\n    if (!requires) continue;\n    if (mode === 'warn' && warnedRequirements.has(requires)) continue;\n    const mismatches = checkRequirements(requires);\n    if (mismatches.length === 0) continue;\n    const message = `[weasel] contribution \"${entry.id}\" requires ${mismatches.map(describeMismatch).join('; ')}.`;\n    if (mode === 'strict') throw new Error(message);\n    warnedRequirements.add(requires);\n    console.warn(message);\n  }\n}\n\n/** Every entry the registry holds, registry and ambient alike. */\nexport function contributionEntries(tools: Pick<ToolsApi, 'registry' | 'ambient'>): SurfaceContribution[] {\n  return [...Object.values(tools.registry), ...tools.ambient] as SurfaceContribution[];\n}\n\n/**\n * Keep one installation per key alive: install keys that appeared, tear down\n * keys that went. Keys are role objects the consumer owns, so an entry the\n * host re-wraps every render — `useTools` restates eligibility on a copy —\n * still installs once.\n */\nfunction useKeyedInstall(\n  items: ReadonlyMap<object, () => () => void>,\n): void {\n  const live = useRef(new Map<object, () => void>());\n  useEffect(() => {\n    for (const [key, teardown] of live.current) {\n      if (items.has(key)) continue;\n      teardown();\n      live.current.delete(key);\n    }\n    for (const [key, install] of items) {\n      if (live.current.has(key)) continue;\n      live.current.set(key, install());\n    }\n  });\n  useEffect(() => () => {\n    for (const teardown of live.current.values()) teardown();\n    live.current.clear();\n  }, []);\n}\n\nconst NO_SURFACE: readonly SurfaceContribution[] = [];\n\n/**\n * `surface` is the canvas's own entries installed beside a takeover, which the\n * takeover's `ToolsApi` does not hold: their deps, `watch`, `attach`, frame\n * hooks and overlay install here, the overlay as a registered layer since no\n * tool set lists it. Their actions are the canvas's standard actions, so they\n * are not registered again.\n */\nexport function useContributionRoles(\n  tools: ToolsApi,\n  api: CanvasExtensionApi | null,\n  versionCheck: VersionCheck = 'warn',\n  surface: readonly SurfaceContribution[] = NO_SURFACE,\n): void {\n  const registry = useActionsRegistry();\n  const depRegistry = useOptionalDepRegistry();\n  const { registry: toolRegistry, ambient } = tools;\n\n  useEffect(() => {\n    if (!registry) return;\n    const unregisters: Array<() => void> = [];\n    // Ambient entries included: an always-on entry owns actions its own\n    // bindings reference exactly as a registry tool does, and leaving them out\n    // gives the same silent failure this hook exists to prevent — a binding\n    // pointing at an id nothing registered.\n    for (const entry of contributionEntries({ registry: toolRegistry, ambient })) {\n      for (const action of entry.actions ?? []) {\n        unregisters.push(registry.register(action));\n      }\n    }\n    return () => { for (const u of unregisters) u(); };\n  }, [registry, toolRegistry, ambient]);\n  useToolOptionTunings(registry, toolRegistry);\n\n  const menuHost = useMenuHost();\n  useEffect(() => {\n    if (!menuHost) return;\n    const releases: Array<() => void> = [];\n    for (const [id, entry] of Object.entries(toolRegistry)) {\n      for (const def of (entry as SurfaceContribution).menus ?? []) releases.push(menuHost.define(def, id));\n    }\n    for (const entry of ambient) {\n      for (const def of (entry as SurfaceContribution).menus ?? []) releases.push(menuHost.define(def, null));\n    }\n    return () => { for (const r of releases) r(); };\n  }, [menuHost, toolRegistry, ambient]);\n\n  const entries = [...contributionEntries(tools), ...surface];\n  // Development only for a warning; a strict surface asked to be stopped, so\n  // it throws in every build.\n  if (versionCheck === 'strict' || (versionCheck === 'warn' && isDev())) {\n    checkEntryRequirements(entries, versionCheck);\n  }\n\n  const reader = depRegistry ?? NO_DEPS;\n  const installs = new Map<object, () => () => void>();\n  for (const entry of entries) {\n    const deps = entry.deps;\n    if (deps && depRegistry) installs.set(deps, () => registerDeps(depRegistry, deps));\n    const watch = entry.watch;\n    if (watch && depRegistry) installs.set(watch, () => watch(() => depRegistry.changed?.()));\n    const attach = entry.attach;\n    if (attach && api) installs.set(attach, () => attach(api, reader));\n  }\n  for (const entry of surface) {\n    const overlay = entry.overlay;\n    if (!overlay || !api) continue;\n    for (const layer of Array.isArray(overlay) ? overlay : [overlay]) installs.set(layer, () => api.registerLayer(layer));\n  }\n  useKeyedInstall(installs);\n  useContributionFrameHooks(entries, api, reader);\n\n  // Tool assembly runs above the provider too, so its own registration of\n  // held-key engagement finds no registry unless the consumer mounted one.\n  useOffhandAction(contributionEntries(tools));\n}\n\nfunction registerDeps(\n  depRegistry: DepRegistry,\n  deps: NonNullable<SurfaceContribution['deps']>,\n): () => void {\n  const unregisters = (Object.keys(deps) as DepName[]).map((name) =>\n    depRegistry.register(name, deps[name] as never));\n  return () => { for (const u of unregisters) u(); };\n}\n"],"mappings":"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"}

package/dist/canvas/SceneCanvas/useDepartureGhostLayer.js

@@ -1,13 +1,13 @@
-import { deriveParallaxView } from "../../core/viewport/parallax.js";
 import { composeChildFrame, composesFrames } from "../../core/scene/composeFrame.js";
-import { definesFrame, effectivePose } from "../../core/scene/effectivePose.js";
 import { viewPoseAdapter } from "../../core/scene/scrollOffsets.js";
-import { wrapWithPoseRotation } from "../poseRotation.js";
+import { definesFrame, effectivePose } from "../../core/scene/effectivePose.js";
+import { deriveParallaxView } from "../../core/viewport/parallax.js";
 import { isCustomEntry } from "../layerSlots.js";
+import { wrapWithPoseRotation } from "../poseRotation.js";
 import { useMemo } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/SceneCanvas/useDepartureGhostLayer.ts
+// src/canvas/SceneCanvas/useDepartureGhostLayer.ts
 /**
 * The layer `<SceneCanvas poseTransition exit>` draws removed nodes leaving
 * on: each ghost through the scene slot's `drawOne`, at the pose and opacity
@@ -60,6 +60,5 @@ function useDepartureGhostLayer(args) {
 	]);
 }
 
-//#endregion
 export { useDepartureGhostLayer };
 //# sourceMappingURL=useDepartureGhostLayer.js.map

package/dist/canvas/SceneCanvas/useDispatcherOverlayLayer.js

@@ -1,15 +1,15 @@
 import { viewToTransform } from "../../core/viewport/view.js";
 import { worldToScreen } from "../../core/viewport/viewTransform.js";
-import { OVERLAY_ROLE_STROKES } from "../overlayRoleStrokes.js";
 import { resolveOverlays } from "../../interactions/actions/resolveOverlays.js";
 import { gestureOverlaysFrom, isVisibleFrom } from "../drawEnvelope.js";
 import { insertPreviewCommands } from "./insertPreviewCommands.js";
+import { OVERLAY_ROLE_STROKES } from "../overlayRoleStrokes.js";
 import { brushOverlayCommands } from "./brushOverlay.js";
 import { polygonFromPoints, polylineFromPoints } from "@weasel-js/geom";
 import { useEffect, useMemo, useReducer } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/SceneCanvas/useDispatcherOverlayLayer.ts
+// src/canvas/SceneCanvas/useDispatcherOverlayLayer.ts
 /**
 * Dispatcher overlay render layer for `<SceneCanvas>`.
 *
@@ -136,6 +136,5 @@ function useDispatcherOverlayLayer(args) {
 	}), [styleRef]);
 }
 
-//#endregion
 export { useDispatcherOverlayLayer };
 //# sourceMappingURL=useDispatcherOverlayLayer.js.map

package/dist/canvas/SceneCanvas/useHeldModifiers.js

@@ -1,7 +1,7 @@
 import { useKeyState } from "../../input/useKeyState.js";
 import { useMemo } from "react";
 
-//#region src/canvas/SceneCanvas/useHeldModifiers.ts
+// src/canvas/SceneCanvas/useHeldModifiers.ts
 /** The modifier keys held, for a surface's rule context. */
 /** The modifiers held anywhere in the window, a text field included: a rule
 *  is asked about the keyboard, not about where focus is. `subscribe` reports
@@ -22,6 +22,5 @@ function useHeldModifiers() {
 	}), [keys]);
 }
 
-//#endregion
 export { useHeldModifiers };
 //# sourceMappingURL=useHeldModifiers.js.map

package/dist/canvas/SceneCanvas/useMagnificationCheck.js

@@ -0,0 +1,41 @@
+import { undeclaredMagnifications } from "../../interactions/actions/magnification.js";
+import { isDev } from "@weasel-js/registry";
+import { useEffect } from "react";
+
+// src/canvas/SceneCanvas/useMagnificationCheck.ts
+var SETTLE_MS = 250;
+var times = (n) => `${Number(n.toFixed(3))}×`;
+/**
+* In development, warns once per container and size when `scene` draws a
+* container's children at a magnification its unit scopes do not declare in
+* `drawnAt`: what silently turned a 20″ cabinet into 30″ of board. Checks
+* after edits settle rather than on every frame of a drag.
+*/
+function useMagnificationCheck(scene) {
+	useEffect(() => {
+		if (!isDev()) return;
+		const warned = /* @__PURE__ */ new Set();
+		let timer = null;
+		const check = () => {
+			timer = null;
+			for (const { id, drawn, declared } of undeclaredMagnifications(scene)) {
+				const size = drawn.x === drawn.y ? times(drawn.x) : `${times(drawn.x)} by ${times(drawn.y)}`;
+				const key = `${id}:${size}:${declared}`;
+				if (warned.has(key)) continue;
+				warned.add(key);
+				console.warn(`weasel: node "${id}" draws its children at ${size}, but its unit scopes declare ${times(declared)}. Set \`units.drawnAt\` on the node whose transform scales them, or correct the transform.`);
+			}
+		};
+		check();
+		const unsubscribe = scene.subscribe(() => {
+			timer ??= setTimeout(check, SETTLE_MS);
+		});
+		return () => {
+			unsubscribe();
+			if (timer !== null) clearTimeout(timer);
+		};
+	}, [scene]);
+}
+
+export { useMagnificationCheck };
+//# sourceMappingURL=useMagnificationCheck.js.map

package/dist/canvas/SceneCanvas/useMagnificationCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMagnificationCheck.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useMagnificationCheck.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport { isDev } from '@weasel-js/registry';\nimport type { Scene } from 'core/scene/types';\nimport { undeclaredMagnifications } from 'interactions/actions/magnification';\n\nconst SETTLE_MS = 250;\nconst times = (n: number): string => `${Number(n.toFixed(3))}×`;\n\n/**\n * In development, warns once per container and size when `scene` draws a\n * container's children at a magnification its unit scopes do not declare in\n * `drawnAt`: what silently turned a 20″ cabinet into 30″ of board. Checks\n * after edits settle rather than on every frame of a drag.\n */\nexport function useMagnificationCheck(scene: Scene<unknown, string, unknown>): void {\n  useEffect(() => {\n    if (!isDev()) return;\n    const warned = new Set<string>();\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    const check = (): void => {\n      timer = null;\n      for (const { id, drawn, declared } of undeclaredMagnifications(scene)) {\n        const size = drawn.x === drawn.y ? times(drawn.x) : `${times(drawn.x)} by ${times(drawn.y)}`;\n        const key = `${id}:${size}:${declared}`;\n        if (warned.has(key)) continue;\n        warned.add(key);\n        console.warn(\n          `weasel: node \"${id}\" draws its children at ${size}, but its unit scopes declare ${times(declared)}. `\n          + 'Set `units.drawnAt` on the node whose transform scales them, or correct the transform.',\n        );\n      }\n    };\n    check();\n    const unsubscribe = scene.subscribe(() => {\n      timer ??= setTimeout(check, SETTLE_MS);\n    });\n    return () => {\n      unsubscribe();\n      if (timer !== null) clearTimeout(timer);\n    };\n  }, [scene]);\n}\n"],"mappings":";;;;;AAKA,IAAM,YAAY;AAClB,IAAM,SAAS,MAAsB,GAAG,OAAO,EAAE,QAAQ,CAAC,CAAC,EAAE;;;;;;;AAQ7D,SAAgB,sBAAsB,OAA8C;CAClF,gBAAgB;EACd,IAAI,CAAC,MAAM,GAAG;EACd,MAAM,yBAAS,IAAI,IAAY;EAC/B,IAAI,QAA8C;EAClD,MAAM,cAAoB;GACxB,QAAQ;GACR,KAAK,MAAM,EAAE,IAAI,OAAO,cAAc,yBAAyB,KAAK,GAAG;IACrE,MAAM,OAAO,MAAM,MAAM,MAAM,IAAI,MAAM,MAAM,CAAC,IAAI,GAAG,MAAM,MAAM,CAAC,EAAE,MAAM,MAAM,MAAM,CAAC;IACzF,MAAM,MAAM,GAAG,GAAG,GAAG,KAAK,GAAG;IAC7B,IAAI,OAAO,IAAI,GAAG,GAAG;IACrB,OAAO,IAAI,GAAG;IACd,QAAQ,KACN,iBAAiB,GAAG,0BAA0B,KAAK,gCAAgC,MAAM,QAAQ,EAAE,2FAErG;GACF;EACF;EACA,MAAM;EACN,MAAM,cAAc,MAAM,gBAAgB;GACxC,UAAU,WAAW,OAAO,SAAS;EACvC,CAAC;EACD,aAAa;GACX,YAAY;GACZ,IAAI,UAAU,MAAM,aAAa,KAAK;EACxC;CACF,GAAG,CAAC,KAAK,CAAC;AACZ"}

package/dist/canvas/SceneCanvas/useNodeAtPoint.js

@@ -1,7 +1,7 @@
 import { makeGetNodeAtPoint } from "../getNodeAtPoint.js";
 import { useMemo } from "react";
 
-//#region src/canvas/SceneCanvas/useNodeAtPoint.ts
+// src/canvas/SceneCanvas/useNodeAtPoint.ts
 /**
 * The node under a world point with its routing kind, resolved through the
 * select tool's own single-hit picker, so `onClick`, `onDoubleClick`, hover,
@@ -23,6 +23,5 @@ function useNodeAtPoint(args) {
 	]);
 }
 
-//#endregion
 export { useNodeAtPoint };
 //# sourceMappingURL=useNodeAtPoint.js.map

package/dist/canvas/SceneCanvas/useNodeKinds.js

@@ -1,8 +1,8 @@
-import { inferredNodeRouting } from "./defaultNodeRouting.js";
 import { createNodeRouting } from "../../core/scene/NodeRouting.js";
+import { inferredNodeRouting } from "./defaultNodeRouting.js";
 import { useMemo } from "react";
 
-//#region src/canvas/SceneCanvas/useNodeKinds.ts
+// src/canvas/SceneCanvas/useNodeKinds.ts
 /**
 * The canvas's routing-trait classifier, by node data and by node id, so
 * `target: 'kind:text'` on a binding speaks the vocabulary of `Hit.kind`.
@@ -30,6 +30,5 @@ function useNodeKinds(scene, routing) {
 	};
 }
 
-//#endregion
 export { useNodeKinds };
 //# sourceMappingURL=useNodeKinds.js.map

package/dist/canvas/SceneCanvas/usePreviewGhostLayer.js

@@ -1,21 +1,21 @@
-import { deriveParallaxView } from "../../core/viewport/parallax.js";
-import { inheritedPaintOf, inheritsPaint, sceneAncestors } from "../../core/scene/inheritedPaint.js";
-import { withShownData } from "../../core/scene/nodeAsShown.js";
-import { planeTransform } from "../planeClips.js";
-import { wrapWithPoseRotation } from "../poseRotation.js";
-import { ownClipOf } from "../ownClip.js";
-import { scenePaintedPoseOf } from "../derivedPath.js";
-import { scenePlaneOf } from "../scenePickSource.js";
-import { copiesAbove } from "../copiesAbove.js";
 import { isCustomEntry } from "../layerSlots.js";
+import { ownClipOf } from "../ownClip.js";
+import { wrapWithPoseRotation } from "../poseRotation.js";
 import { previewSourcesFrom } from "../drawEnvelope.js";
 import { flattenPreviews, resolvePreviews } from "../../interactions/actions/resolvePreviews.js";
+import { scenePlaneOf } from "../scenePickSource.js";
+import { planeTransform } from "../planeClips.js";
+import { deriveParallaxView } from "../../core/viewport/parallax.js";
+import { copiesAbove } from "../copiesAbove.js";
+import { scenePaintedPoseOf } from "../derivedPath.js";
+import { inheritedPaintOf, inheritsPaint, sceneAncestors } from "../../core/scene/inheritedPaint.js";
+import { withShownData } from "../../core/scene/nodeAsShown.js";
 import "@weasel-js/renderer";
 import { mat3 as mat3$1 } from "@weasel-js/geom";
 import { useEffect, useMemo, useReducer } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/SceneCanvas/usePreviewGhostLayer.ts
+// src/canvas/SceneCanvas/usePreviewGhostLayer.ts
 /**
 * Preview-ghost render layer for `<SceneCanvas>`. Renders in-flight gesture
 * poses on top of the committed scene by reusing the scene slot's `drawOne`.
@@ -110,6 +110,5 @@ function usePreviewGhostLayer(args) {
 	}), [sceneRef, sceneSlotRef]);
 }
 
-//#endregion
 export { usePreviewGhostLayer };
 //# sourceMappingURL=usePreviewGhostLayer.js.map

package/dist/canvas/SceneCanvas/useSceneCanvasHandle.js

@@ -2,7 +2,7 @@ import { IDENTITY_VIEW, useOptionalViewRegistry } from "../viewRegistry.js";
 import { useCallback, useState } from "react";
 import { assignRef } from "@weasel-js/react";
 
-//#region src/canvas/SceneCanvas/useSceneCanvasHandle.ts
+// src/canvas/SceneCanvas/useSceneCanvasHandle.ts
 /** Views added through the handle rather than declared as props or children. */
 function useAddedViews() {
 	const surfaceViewRegistry = useOptionalViewRegistry();
@@ -75,6 +75,5 @@ function useSceneCanvasHandle(args) {
 	};
 }
 
-//#endregion
 export { useAddedViews, useSceneCanvasHandle };
 //# sourceMappingURL=useSceneCanvasHandle.js.map

package/dist/canvas/SceneCanvas/useSceneCanvasLayers.js

@@ -1,10 +1,8 @@
-import { targetSizesPx } from "../../core/device/targets.js";
-import { drawnBoundsScene } from "../derivedPath.js";
-import { createSnapOutcomeStore } from "../../domains/snap/outcomeStore.js";
-import { builtLayersOf, isCustomEntry } from "../layerSlots.js";
-import { useTargetBasePx } from "../../core/device/useTargetBasePx.js";
 import { usePathEditOverlayLayer } from "../../domains/paths/usePathEdit.js";
+import { builtLayersOf, isCustomEntry } from "../layerSlots.js";
 import { createSlopsDebugLayer } from "../slopsDebugLayer.js";
+import { useTargetBasePx } from "../../core/device/useTargetBasePx.js";
+import { targetSizesPx } from "../../core/device/targets.js";
 import { layersOverPresets, mergeLayersWithDefaults } from "./mergeLayers.js";
 import { useDispatcherOverlayLayer } from "./useDispatcherOverlayLayer.js";
 import { usePreviewGhostLayer } from "./usePreviewGhostLayer.js";
@@ -13,11 +11,13 @@ import { useEffectSourcesLayer } from "../../domains/pathEffects/useEffectSource
 import { usePoseTransition } from "../../animation/poseTransition.js";
 import { useSceneSlotLayers } from "./useSceneSlotLayers.js";
 import { useSelectionOverlayLayer } from "./useSelectionOverlayLayer.js";
+import { drawnBoundsScene } from "../derivedPath.js";
 import { useEnteredGroupFrameLayer } from "../../domains/selection/enteredGroupFrame.js";
+import { createSnapOutcomeStore } from "../../domains/snap/outcomeStore.js";
 import { createSnapReadoutLayer } from "../../domains/snap/readoutLayer.js";
 import { useMemo, useRef, useState } from "react";
 
-//#region src/canvas/SceneCanvas/useSceneCanvasLayers.ts
+// src/canvas/SceneCanvas/useSceneCanvasLayers.ts
 /**
 * The layer map `<SceneCanvas>` hands `<Canvas>`: the caller's `layers` over
 * the kit defaults, with the scene and selection-overlay slots built, and the
@@ -148,6 +148,5 @@ function useSceneCanvasLayers(args) {
 	};
 }
 
-//#endregion
 export { useSceneCanvasLayers };
 //# sourceMappingURL=useSceneCanvasLayers.js.map

package/dist/canvas/SceneCanvas/useSceneCanvasPathEdit.js

@@ -2,7 +2,7 @@ import { isSelectedNode } from "../../domains/paths/pathEditState.js";
 import { usePathEditState } from "../../domains/paths/usePathEdit.js";
 import { useMemo } from "react";
 
-//#region src/canvas/SceneCanvas/useSceneCanvasPathEdit.ts
+// src/canvas/SceneCanvas/useSceneCanvasPathEdit.ts
 /**
 * The canvas's path-edit state, and the select tool options that defer shift-click to it while
 * a path is being anchor-edited.
@@ -25,6 +25,5 @@ function useSceneCanvasPathEdit(args) {
 	};
 }
 
-//#endregion
 export { useSceneCanvasPathEdit };
 //# sourceMappingURL=useSceneCanvasPathEdit.js.map

package/dist/canvas/SceneCanvas/useSceneCanvasTools.js

@@ -1,6 +1,6 @@
 import { useCanvasTools, useFeatureBindings } from "./useCanvasTools.js";
 
-//#region src/canvas/SceneCanvas/useSceneCanvasTools.ts
+// src/canvas/SceneCanvas/useSceneCanvasTools.ts
 /** The canvas's tools, and the contributions and standard actions its presets bring. */
 function useSceneCanvasTools(args) {
 	const { props, select, enabled } = args;
@@ -38,6 +38,5 @@ function useSceneCanvasTools(args) {
 	};
 }
 
-//#endregion
 export { useSceneCanvasTools };
 //# sourceMappingURL=useSceneCanvasTools.js.map

package/dist/canvas/SceneCanvas/useSceneChrome.js

@@ -1,14 +1,15 @@
-import { useOptionalViewRegistry } from "../viewRegistry.js";
-import { worldPointAt } from "./worldPointAt.js";
-import { PRESET_OWNED_CHROME } from "./presets/chrome.js";
 import { never } from "../../domains/chrome-caps/conditions.js";
-import { presetChromeRules } from "./features.js";
 import { useHoverTracking } from "../../domains/chrome-caps/useHoverTracking.js";
 import { useChromeCaps } from "../../domains/chrome-caps/useChromeCaps.js";
+import { useOptionalViewRegistry } from "../viewRegistry.js";
+import { presetChromeRules } from "./features.js";
+import { PRESET_OWNED_CHROME } from "./presets/chrome.js";
+import { worldPointAt } from "./worldPointAt.js";
+import { useChromeRulesDep } from "../deps/chromeRules.js";
 import { useCallback, useMemo } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/SceneCanvas/useSceneChrome.ts
+// src/canvas/SceneCanvas/useSceneChrome.ts
 /**
 * The node under the pointer, for `RuleCtx.hover`. One lookup, not a
 * client-to-world thunk beside a picker: the point and the camera its
@@ -66,6 +67,15 @@ function useChromeRules(args) {
 		enabled
 	]);
 }
+var hiddenSets = /* @__PURE__ */ new WeakMap();
+/** The chrome the active tool hides (`ToolDef.hides`), or undefined. */
+function hiddenChromeOf(tools) {
+	const hides = tools.active ? tools.registry[tools.active]?.hides : void 0;
+	if (!hides) return void 0;
+	let set = hiddenSets.get(hides);
+	if (!set) hiddenSets.set(hides, set = new Set(hides));
+	return set;
+}
 /** The chrome-caps answers for the surface's own view. */
 function useSurfaceChromeCaps(args) {
 	const { viewRef, dispatcher } = args;
@@ -87,8 +97,8 @@ function useSurfaceChromeCaps(args) {
 	};
 }
 /**
-* The surface's chrome: hover tracking, the visibility rules, and the chrome-caps answers they
-* feed. `source` is the chrome-caps source minus the parts built here.
+* The surface's chrome: hover tracking, the visibility rules with the `chromeRules` dep that sets
+* them at run time, and the chrome-caps answers they feed. `source` is the chrome-caps source minus the parts built here.
 */
 function useSceneCanvasChrome(args) {
 	const { rules, viewRef } = args;
@@ -97,10 +107,11 @@ function useSceneCanvasChrome(args) {
 		viewRef,
 		enabled: rules.chromeVisibility !== void 0 || args.hover.onChange !== void 0
 	});
+	const chromeRules = useChromeRulesDep(useChromeRules(rules));
 	return {
 		...useSurfaceChromeCaps({
 			source: {
-				rules: useChromeRules(rules),
+				rules: chromeRules.rules,
 				getHover,
 				...args.source
 			},
@@ -108,10 +119,10 @@ function useSceneCanvasChrome(args) {
 			viewRef,
 			dispatcher: args.dispatcher
 		}),
-		trackHoverOn
+		trackHoverOn,
+		chromeRules: chromeRules.dep
 	};
 }
 
-//#endregion
-export { useChromeRules, useSceneCanvasChrome, useSceneHover, useSurfaceChromeCaps };
+export { hiddenChromeOf, useChromeRules, useSceneCanvasChrome, useSceneHover, useSurfaceChromeCaps };
 //# sourceMappingURL=useSceneChrome.js.map

package/dist/canvas/SceneCanvas/useSceneChrome.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSceneChrome.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useSceneChrome.ts"],"sourcesContent":["import { useCallback, useMemo, type RefObject } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { Dispatcher, RuleCtx } from '@weasel-js/routing';\nimport type { NodeId } from 'core/scene/types';\nimport type { View } from 'core/viewport/view';\nimport { never, useHoverTracking, type HoverTracking, type VisibilityRules } from 'domains/chrome-caps';\nimport {\n  useChromeCaps,\n  type ChromeCaps,\n  type ChromeCapsSource,\n  type ViewRuleInputs,\n} from 'domains/chrome-caps/useChromeCaps';\nimport type { CanvasExtensionApi } from '../canvasExtension';\nimport { useOptionalViewRegistry } from '../viewRegistry';\nimport { presetChromeRules, type EnabledPresets } from './features';\nimport { PRESET_OWNED_CHROME } from './presets/chrome';\nimport type { NodeAtPoint } from './useNodeAtPoint';\nimport { worldPointAt } from './worldPointAt';\n\n/**\n * The node under the pointer, for `RuleCtx.hover`. One lookup, not a\n * client-to-world thunk beside a picker: the point and the camera its\n * tolerance converts against have to come from the same view. Hover has no\n * pointer to capture, so whichever view is under the cursor owns the point.\n */\nexport function useSceneHover(args: {\n  canvasApiRef: RefObject<Pick<CanvasExtensionApi, 'clientToWorld'> | null>;\n  /** The surface's own camera, for a point no declared view claims. */\n  viewRef: { readonly current: View };\n  nodeAtPointRef: { readonly current: NodeAtPoint | undefined };\n  enabled: boolean;\n  onChange?: (id: NodeId | null) => void;\n}): HoverTracking {\n  const { canvasApiRef, viewRef, nodeAtPointRef, enabled, onChange } = args;\n  const surfaceViewRegistry = useOptionalViewRegistry();\n  return useHoverTracking({\n    nodeAtClientPoint: (clientX, clientY) => {\n      const api = canvasApiRef.current;\n      if (!api) return null;\n      const target = surfaceViewRegistry?.resolver.at(null, clientX, clientY);\n      const view = target?.view ?? viewRef.current;\n      const [x, y] = worldPointAt(api, target, clientX, clientY);\n      // A view judges its own layers; the surface's gate is the picker's default.\n      const reg = target?.id != null\n        ? surfaceViewRegistry?.list().find((r) => r.id === target.id)\n        : undefined;\n      const hit = nodeAtPointRef.current?.(\n        { x, y }, reg ? { scale: view.scale, layerIsPainted: reg.layerIsPainted } : view,\n      );\n      return hit ? { id: hit.id as NodeId } : null;\n    },\n    enabled,\n    ...(onChange ? { onChange } : {}),\n  });\n}\n\n/**\n * The surface's chrome-visibility rules: the presets' defaults under the\n * consumer's `chromeVisibility`, which wins.\n *\n * An unselectable canvas hides the marquee and lasso by default: every\n * selection write no-ops there, so the select tool's empty-drag binding still\n * claims the gesture, keeping it from falling through to an ambient drag such\n * as insert, but paints nothing.\n */\nexport function useChromeRules(args: {\n  enabled: EnabledPresets;\n  selectable: boolean;\n  chromeVisibility: VisibilityRules | undefined;\n}): VisibilityRules {\n  const { enabled, selectable, chromeVisibility } = args;\n  return useMemo(() => {\n    const defaults = presetChromeRules(enabled, PRESET_OWNED_CHROME);\n    if (!selectable) {\n      defaults['action.marquee'] = never;\n      defaults['action.lasso'] = never;\n    }\n    return { ...defaults, ...chromeVisibility };\n  }, [chromeVisibility, selectable, enabled]);\n}\n\n/** The chrome-caps answers for the surface's own view. */\nexport function useSurfaceChromeCaps(args: {\n  source: ChromeCapsSource;\n  /** The selection as rendered. `SelectionApi.current` can be a live getter\n   *  that runs ahead of the commit the painted chrome was built from. */\n  selection: readonly NodeId[];\n  viewRef: { readonly current: View };\n  dispatcher: Pick<Dispatcher, 'getActiveAction'>;\n}): {\n  chromeCaps: ChromeCaps;\n  getIsVisible: () => (id: string) => boolean;\n  getRuleCtx: () => RuleCtx | undefined;\n} {\n  const { viewRef, dispatcher } = args;\n  const chromeCaps = useChromeCaps(args.source);\n  const committedSelectionRef = useLatest(args.selection);\n  const currentRuleInputs = useCallback((): ViewRuleInputs => ({\n    selection: committedSelectionRef.current,\n    view: viewRef.current,\n    action: dispatcher.getActiveAction(),\n  }), [dispatcher, committedSelectionRef, viewRef]);\n  const getIsVisible = useCallback(\n    (): ((id: string) => boolean) => chromeCaps.isVisible(currentRuleInputs()),\n    [chromeCaps, currentRuleInputs],\n  );\n  const getRuleCtx = useCallback(\n    () => chromeCaps.ruleCtx(currentRuleInputs()),\n    [chromeCaps, currentRuleInputs],\n  );\n  return { chromeCaps, getIsVisible, getRuleCtx };\n}\n\n/**\n * The surface's chrome: hover tracking, the visibility rules, and the chrome-caps answers they\n * feed. `source` is the chrome-caps source minus the parts built here.\n */\nexport function useSceneCanvasChrome(args: {\n  source: Omit<ChromeCapsSource, 'rules' | 'getHover'>;\n  rules: Parameters<typeof useChromeRules>[0];\n  hover: Omit<Parameters<typeof useSceneHover>[0], 'enabled' | 'viewRef'>;\n  selection: readonly NodeId[];\n  viewRef: { readonly current: View };\n  dispatcher: Pick<Dispatcher, 'getActiveAction'>;\n}) {\n  const { rules, viewRef } = args;\n  const { getHover, canvasRef: trackHoverOn } = useSceneHover({\n    ...args.hover, viewRef, enabled: rules.chromeVisibility !== undefined || args.hover.onChange !== undefined,\n  });\n  const chromeRules = useChromeRules(rules);\n  const caps = useSurfaceChromeCaps({\n    source: { rules: chromeRules, getHover, ...args.source },\n    selection: args.selection,\n    viewRef,\n    dispatcher: args.dispatcher,\n  });\n  return { ...caps, trackHoverOn };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAyBA,SAAgB,cAAc,MAOZ;CAChB,MAAM,EAAE,cAAc,SAAS,gBAAgB,SAAS,aAAa;CACrE,MAAM,sBAAsB,wBAAwB;CACpD,OAAO,iBAAiB;EACtB,oBAAoB,SAAS,YAAY;GACvC,MAAM,MAAM,aAAa;GACzB,IAAI,CAAC,KAAK,OAAO;GACjB,MAAM,SAAS,qBAAqB,SAAS,GAAG,MAAM,SAAS,OAAO;GACtE,MAAM,OAAO,QAAQ,QAAQ,QAAQ;GACrC,MAAM,CAAC,GAAG,KAAK,aAAa,KAAK,QAAQ,SAAS,OAAO;GAEzD,MAAM,MAAM,QAAQ,MAAM,OACtB,qBAAqB,KAAK,CAAC,CAAC,MAAM,MAAM,EAAE,OAAO,OAAO,EAAE,IAC1D;GACJ,MAAM,MAAM,eAAe,UACzB;IAAE;IAAG;GAAE,GAAG,MAAM;IAAE,OAAO,KAAK;IAAO,gBAAgB,IAAI;GAAe,IAAI,IAC9E;GACA,OAAO,MAAM,EAAE,IAAI,IAAI,GAAa,IAAI;EAC1C;EACA;EACA,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;CACjC,CAAC;AACH;;;;;;;;;;AAWA,SAAgB,eAAe,MAIX;CAClB,MAAM,EAAE,SAAS,YAAY,qBAAqB;CAClD,OAAO,cAAc;EACnB,MAAM,WAAW,kBAAkB,SAAS,mBAAmB;EAC/D,IAAI,CAAC,YAAY;GACf,SAAS,oBAAoB;GAC7B,SAAS,kBAAkB;EAC7B;EACA,OAAO;GAAE,GAAG;GAAU,GAAG;EAAiB;CAC5C,GAAG;EAAC;EAAkB;EAAY;CAAO,CAAC;AAC5C;;AAGA,SAAgB,qBAAqB,MAWnC;CACA,MAAM,EAAE,SAAS,eAAe;CAChC,MAAM,aAAa,cAAc,KAAK,MAAM;CAC5C,MAAM,wBAAwB,UAAU,KAAK,SAAS;CACtD,MAAM,oBAAoB,mBAAmC;EAC3D,WAAW,sBAAsB;EACjC,MAAM,QAAQ;EACd,QAAQ,WAAW,gBAAgB;CACrC,IAAI;EAAC;EAAY;EAAuB;CAAO,CAAC;CAShD,OAAO;EAAE;EAAY,cARA,kBACc,WAAW,UAAU,kBAAkB,CAAC,GACzE,CAAC,YAAY,iBAAiB,CAMX;EAAc,YAJhB,kBACX,WAAW,QAAQ,kBAAkB,CAAC,GAC5C,CAAC,YAAY,iBAAiB,CAEG;CAAW;AAChD;;;;;AAMA,SAAgB,qBAAqB,MAOlC;CACD,MAAM,EAAE,OAAO,YAAY;CAC3B,MAAM,EAAE,UAAU,WAAW,iBAAiB,cAAc;EAC1D,GAAG,KAAK;EAAO;EAAS,SAAS,MAAM,qBAAqB,UAAa,KAAK,MAAM,aAAa;CACnG,CAAC;CAQD,OAAO;EAAE,GANI,qBAAqB;GAChC,QAAQ;IAAE,OAFQ,eAAe,KAEhB;IAAa;IAAU,GAAG,KAAK;GAAO;GACvD,WAAW,KAAK;GAChB;GACA,YAAY,KAAK;EACnB,CACY;EAAM;CAAa;AACjC"}
+{"version":3,"file":"useSceneChrome.js","names":[],"sources":["../../../src/canvas/SceneCanvas/useSceneChrome.ts"],"sourcesContent":["import { useCallback, useMemo, type RefObject } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { Dispatcher, RuleCtx } from '@weasel-js/routing';\nimport type { NodeId } from 'core/scene/types';\nimport type { View } from 'core/viewport/view';\nimport { never, useHoverTracking, type HoverTracking, type VisibilityRules } from 'domains/chrome-caps';\nimport {\n  useChromeCaps,\n  type ChromeCaps,\n  type ChromeCapsSource,\n  type ViewRuleInputs,\n} from 'domains/chrome-caps/useChromeCaps';\nimport type { CanvasExtensionApi } from '../canvasExtension';\nimport { useOptionalViewRegistry } from '../viewRegistry';\nimport { presetChromeRules, type EnabledPresets } from './features';\nimport { PRESET_OWNED_CHROME } from './presets/chrome';\nimport type { NodeAtPoint } from './useNodeAtPoint';\nimport { worldPointAt } from './worldPointAt';\nimport { useChromeRulesDep } from '../deps/chromeRules';\n\n/**\n * The node under the pointer, for `RuleCtx.hover`. One lookup, not a\n * client-to-world thunk beside a picker: the point and the camera its\n * tolerance converts against have to come from the same view. Hover has no\n * pointer to capture, so whichever view is under the cursor owns the point.\n */\nexport function useSceneHover(args: {\n  canvasApiRef: RefObject<Pick<CanvasExtensionApi, 'clientToWorld'> | null>;\n  /** The surface's own camera, for a point no declared view claims. */\n  viewRef: { readonly current: View };\n  nodeAtPointRef: { readonly current: NodeAtPoint | undefined };\n  enabled: boolean;\n  onChange?: (id: NodeId | null) => void;\n}): HoverTracking {\n  const { canvasApiRef, viewRef, nodeAtPointRef, enabled, onChange } = args;\n  const surfaceViewRegistry = useOptionalViewRegistry();\n  return useHoverTracking({\n    nodeAtClientPoint: (clientX, clientY) => {\n      const api = canvasApiRef.current;\n      if (!api) return null;\n      const target = surfaceViewRegistry?.resolver.at(null, clientX, clientY);\n      const view = target?.view ?? viewRef.current;\n      const [x, y] = worldPointAt(api, target, clientX, clientY);\n      // A view judges its own layers; the surface's gate is the picker's default.\n      const reg = target?.id != null\n        ? surfaceViewRegistry?.list().find((r) => r.id === target.id)\n        : undefined;\n      const hit = nodeAtPointRef.current?.(\n        { x, y }, reg ? { scale: view.scale, layerIsPainted: reg.layerIsPainted } : view,\n      );\n      return hit ? { id: hit.id as NodeId } : null;\n    },\n    enabled,\n    ...(onChange ? { onChange } : {}),\n  });\n}\n\n/**\n * The surface's chrome-visibility rules: the presets' defaults under the\n * consumer's `chromeVisibility`, which wins.\n *\n * An unselectable canvas hides the marquee and lasso by default: every\n * selection write no-ops there, so the select tool's empty-drag binding still\n * claims the gesture, keeping it from falling through to an ambient drag such\n * as insert, but paints nothing.\n */\nexport function useChromeRules(args: {\n  enabled: EnabledPresets;\n  selectable: boolean;\n  chromeVisibility: VisibilityRules | undefined;\n}): VisibilityRules {\n  const { enabled, selectable, chromeVisibility } = args;\n  return useMemo(() => {\n    const defaults = presetChromeRules(enabled, PRESET_OWNED_CHROME);\n    if (!selectable) {\n      defaults['action.marquee'] = never;\n      defaults['action.lasso'] = never;\n    }\n    return { ...defaults, ...chromeVisibility };\n  }, [chromeVisibility, selectable, enabled]);\n}\n\nconst hiddenSets = new WeakMap<readonly string[], ReadonlySet<string>>();\n\n/** The chrome the active tool hides (`ToolDef.hides`), or undefined. */\nexport function hiddenChromeOf(tools: { active: string | null; registry: Readonly<Record<string, { hides?: readonly string[] }>> }): ReadonlySet<string> | undefined {\n  const hides = tools.active ? tools.registry[tools.active]?.hides : undefined;\n  if (!hides) return undefined;\n  let set = hiddenSets.get(hides);\n  if (!set) hiddenSets.set(hides, (set = new Set(hides)));\n  return set;\n}\n\n/** The chrome-caps answers for the surface's own view. */\nexport function useSurfaceChromeCaps(args: {\n  source: ChromeCapsSource;\n  /** The selection as rendered. `SelectionApi.current` can be a live getter\n   *  that runs ahead of the commit the painted chrome was built from. */\n  selection: readonly NodeId[];\n  viewRef: { readonly current: View };\n  dispatcher: Pick<Dispatcher, 'getActiveAction'>;\n}): {\n  chromeCaps: ChromeCaps;\n  getIsVisible: () => (id: string) => boolean;\n  getRuleCtx: () => RuleCtx | undefined;\n} {\n  const { viewRef, dispatcher } = args;\n  const chromeCaps = useChromeCaps(args.source);\n  const committedSelectionRef = useLatest(args.selection);\n  const currentRuleInputs = useCallback((): ViewRuleInputs => ({\n    selection: committedSelectionRef.current,\n    view: viewRef.current,\n    action: dispatcher.getActiveAction(),\n  }), [dispatcher, committedSelectionRef, viewRef]);\n  const getIsVisible = useCallback(\n    (): ((id: string) => boolean) => chromeCaps.isVisible(currentRuleInputs()),\n    [chromeCaps, currentRuleInputs],\n  );\n  const getRuleCtx = useCallback(\n    () => chromeCaps.ruleCtx(currentRuleInputs()),\n    [chromeCaps, currentRuleInputs],\n  );\n  return { chromeCaps, getIsVisible, getRuleCtx };\n}\n\n/**\n * The surface's chrome: hover tracking, the visibility rules with the `chromeRules` dep that sets\n * them at run time, and the chrome-caps answers they feed. `source` is the chrome-caps source minus the parts built here.\n */\nexport function useSceneCanvasChrome(args: {\n  source: Omit<ChromeCapsSource, 'rules' | 'getHover'>;\n  rules: Parameters<typeof useChromeRules>[0];\n  hover: Omit<Parameters<typeof useSceneHover>[0], 'enabled' | 'viewRef'>;\n  selection: readonly NodeId[];\n  viewRef: { readonly current: View };\n  dispatcher: Pick<Dispatcher, 'getActiveAction'>;\n}) {\n  const { rules, viewRef } = args;\n  const { getHover, canvasRef: trackHoverOn } = useSceneHover({\n    ...args.hover, viewRef, enabled: rules.chromeVisibility !== undefined || args.hover.onChange !== undefined,\n  });\n  const chromeRules = useChromeRulesDep(useChromeRules(rules));\n  const caps = useSurfaceChromeCaps({\n    source: { rules: chromeRules.rules, getHover, ...args.source },\n    selection: args.selection,\n    viewRef,\n    dispatcher: args.dispatcher,\n  });\n  return { ...caps, trackHoverOn, chromeRules: chromeRules.dep };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA0BA,SAAgB,cAAc,MAOZ;CAChB,MAAM,EAAE,cAAc,SAAS,gBAAgB,SAAS,aAAa;CACrE,MAAM,sBAAsB,wBAAwB;CACpD,OAAO,iBAAiB;EACtB,oBAAoB,SAAS,YAAY;GACvC,MAAM,MAAM,aAAa;GACzB,IAAI,CAAC,KAAK,OAAO;GACjB,MAAM,SAAS,qBAAqB,SAAS,GAAG,MAAM,SAAS,OAAO;GACtE,MAAM,OAAO,QAAQ,QAAQ,QAAQ;GACrC,MAAM,CAAC,GAAG,KAAK,aAAa,KAAK,QAAQ,SAAS,OAAO;GAEzD,MAAM,MAAM,QAAQ,MAAM,OACtB,qBAAqB,KAAK,CAAC,CAAC,MAAM,MAAM,EAAE,OAAO,OAAO,EAAE,IAC1D;GACJ,MAAM,MAAM,eAAe,UACzB;IAAE;IAAG;GAAE,GAAG,MAAM;IAAE,OAAO,KAAK;IAAO,gBAAgB,IAAI;GAAe,IAAI,IAC9E;GACA,OAAO,MAAM,EAAE,IAAI,IAAI,GAAa,IAAI;EAC1C;EACA;EACA,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;CACjC,CAAC;AACH;;;;;;;;;;AAWA,SAAgB,eAAe,MAIX;CAClB,MAAM,EAAE,SAAS,YAAY,qBAAqB;CAClD,OAAO,cAAc;EACnB,MAAM,WAAW,kBAAkB,SAAS,mBAAmB;EAC/D,IAAI,CAAC,YAAY;GACf,SAAS,oBAAoB;GAC7B,SAAS,kBAAkB;EAC7B;EACA,OAAO;GAAE,GAAG;GAAU,GAAG;EAAiB;CAC5C,GAAG;EAAC;EAAkB;EAAY;CAAO,CAAC;AAC5C;AAEA,IAAM,6BAAa,IAAI,QAAgD;;AAGvE,SAAgB,eAAe,OAAsI;CACnK,MAAM,QAAQ,MAAM,SAAS,MAAM,SAAS,MAAM,OAAO,EAAE,QAAQ;CACnE,IAAI,CAAC,OAAO,OAAO;CACnB,IAAI,MAAM,WAAW,IAAI,KAAK;CAC9B,IAAI,CAAC,KAAK,WAAW,IAAI,OAAQ,MAAM,IAAI,IAAI,KAAK,CAAE;CACtD,OAAO;AACT;;AAGA,SAAgB,qBAAqB,MAWnC;CACA,MAAM,EAAE,SAAS,eAAe;CAChC,MAAM,aAAa,cAAc,KAAK,MAAM;CAC5C,MAAM,wBAAwB,UAAU,KAAK,SAAS;CACtD,MAAM,oBAAoB,mBAAmC;EAC3D,WAAW,sBAAsB;EACjC,MAAM,QAAQ;EACd,QAAQ,WAAW,gBAAgB;CACrC,IAAI;EAAC;EAAY;EAAuB;CAAO,CAAC;CAShD,OAAO;EAAE;EAAY,cARA,kBACc,WAAW,UAAU,kBAAkB,CAAC,GACzE,CAAC,YAAY,iBAAiB,CAMX;EAAc,YAJhB,kBACX,WAAW,QAAQ,kBAAkB,CAAC,GAC5C,CAAC,YAAY,iBAAiB,CAEG;CAAW;AAChD;;;;;AAMA,SAAgB,qBAAqB,MAOlC;CACD,MAAM,EAAE,OAAO,YAAY;CAC3B,MAAM,EAAE,UAAU,WAAW,iBAAiB,cAAc;EAC1D,GAAG,KAAK;EAAO;EAAS,SAAS,MAAM,qBAAqB,UAAa,KAAK,MAAM,aAAa;CACnG,CAAC;CACD,MAAM,cAAc,kBAAkB,eAAe,KAAK,CAAC;CAO3D,OAAO;EAAE,GANI,qBAAqB;GAChC,QAAQ;IAAE,OAAO,YAAY;IAAO;IAAU,GAAG,KAAK;GAAO;GAC7D,WAAW,KAAK;GAChB;GACA,YAAY,KAAK;EACnB,CACY;EAAM;EAAc,aAAa,YAAY;CAAI;AAC/D"}

package/dist/canvas/SceneCanvas/useSceneGestureDispatcher.js

@@ -1,19 +1,19 @@
 import { EMPTY_CHROME_STATE } from "../../core/selection/chromeState.js";
-import { anchorStateFrom, buildAffordanceAt, buildClassifyTarget, layerAffordance } from "../affordanceAt.js";
-import { useOptionalViewRegistry } from "../viewRegistry.js";
 import { useDispatchDepSources } from "../deps/dispatchSources.js";
-import { pathFromPlane } from "../planeClips.js";
-import { VIEW_MARKER_ENTRY_ID } from "../../domains/viewports/viewMarkerDrag.js";
-import { useKitSettingsDepSource } from "../deps/kitSettings.js";
+import { anchorStateFrom, buildAffordanceAt, buildClassifyTarget, layerAffordance } from "../affordanceAt.js";
 import { useChromeAffordances } from "./useChromeAffordances.js";
+import { useKitSettingsDepSource } from "../deps/kitSettings.js";
+import { pathFromPlane } from "../planeClips.js";
+import { useOptionalViewRegistry } from "../viewRegistry.js";
 import { useSurfaceRouting } from "./useSurfaceRouting.js";
 import { traceConversion } from "./coordTrace.js";
+import { VIEW_MARKER_ENTRY_ID } from "../../domains/viewports/viewMarkerDrag.js";
 import { useCallback, useEffect, useInsertionEffect, useMemo, useState } from "react";
 import { useLatest } from "@weasel-js/react";
 import { createLongPressStore } from "@weasel-js/routing";
 import { useActionsRegistry, useDepRegistry, useGestureDispatcher } from "@weasel-js/routing/react";
 
-//#region src/canvas/SceneCanvas/useSceneGestureDispatcher.ts
+// src/canvas/SceneCanvas/useSceneGestureDispatcher.ts
 /** What a press on the canvas grabs: a registered layer's widget, else a piece of the
 *  selection chrome. */
 function useAffordanceAt(inputs, depRegistry, viewRegistry) {
@@ -175,6 +175,5 @@ function useSceneGestureDispatcher(inputs) {
 	useKitSettingsDepSource();
 }
 
-//#endregion
 export { useSceneGestureDispatcher };
 //# sourceMappingURL=useSceneGestureDispatcher.js.map

package/dist/canvas/SceneCanvas/useScenePicking.js

@@ -1,18 +1,18 @@
-import { useOptionalViewRegistry } from "../viewRegistry.js";
 import { asNodeId } from "../../core/scene/types.js";
-import { useEnteredGroup } from "../deps/enteredGroup.js";
-import { useViewLayerGate } from "../useViewLayerGate.js";
-import { composeAlphaFor } from "../sceneSlotWiring.js";
 import { doubleClickTarget } from "../doubleClickTarget.js";
+import { useEnteredGroup } from "../deps/enteredGroup.js";
 import { createEnteredGroupScope } from "../../domains/selection/enteredGroupScope.js";
+import { composeAlphaFor } from "../sceneSlotWiring.js";
 import { useSceneAdapter } from "../useSceneAdapter.js";
 import { useNodeAtPoint } from "./useNodeAtPoint.js";
 import { useSceneSelectTool } from "./useSceneSelectTool.js";
+import { useOptionalViewRegistry } from "../viewRegistry.js";
+import { useViewLayerGate } from "../useViewLayerGate.js";
 import { useCallback, useMemo } from "react";
 import { useLatest } from "@weasel-js/react";
 import { useOptionalDepRegistry } from "@weasel-js/routing/react";
 
-//#region src/canvas/SceneCanvas/useScenePicking.ts
+// src/canvas/SceneCanvas/useScenePicking.ts
 /**
 * The canvas's adapter and everything that answers "what is under this point": the select
 * tool's pickers and bounds, the node kinds, and the paint gates picking shares with the painter.
@@ -85,6 +85,5 @@ function useScenePicking(args) {
 	};
 }
 
-//#endregion
 export { useScenePicking };
 //# sourceMappingURL=useScenePicking.js.map

package/dist/canvas/SceneCanvas/useSceneRedrawSources.js

@@ -1,6 +1,6 @@
 import { useMemo } from "react";
 
-//#region src/canvas/SceneCanvas/useSceneRedrawSources.ts
+// src/canvas/SceneCanvas/useSceneRedrawSources.ts
 /**
 * What repaints a `<SceneCanvas>` besides its own render: the caller's
 * sources, then the canvas's. Neither a scene write nor an override write
@@ -30,6 +30,5 @@ function useSceneRedrawSources(args) {
 	]);
 }
 
-//#endregion
 export { useSceneRedrawSources };
 //# sourceMappingURL=useSceneRedrawSources.js.map