@weasel-js/core 1.15.0 → 1.15.2

package/dist/canvas/useViewHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"useViewHelpers.js","names":[],"sources":["../../src/canvas/useViewHelpers.ts"],"sourcesContent":["import { useCallback, useMemo } from 'react';\nimport { framedBounds } from 'core/geometry/poseDescriptor';\nimport { useLatest } from '@weasel-js/react';\nimport type { GestureSource, GesturePreviewSource } from './gestureBounds';\nimport { useInFlightBounds } from './useInFlightBounds';\nimport type { OngoingOverlay } from '@weasel-js/routing';\nimport { unionAABB } from 'core/geometry/unionBounds';\nimport { buildChromeState, type ChromeState } from 'core/selection/chromeState';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport type { NodeId } from 'core/scene/types';\nimport type { DebugSink } from '../debug/types';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\nimport type { Scale2 } from '@weasel-js/geom';\nimport { drawnBoundsOf, type DrawnBoundsScene } from './drawnBounds';\n\nconst noOpUnsubscribe = (): void => {};\n\nconst alwaysVisible = (): boolean => true;\n\n/**\n * The half of {@link CanvasHelpers} that belongs to one view — everything\n * answered by a camera's own tools, gestures and selection. A canvas hosting\n * several viewports needs one of these per view; the surface half is shared.\n */\nexport interface CanvasViewHelpers<TPose> {\n  /** Pose currently displayed for `id` — drag/resize/rotate overlay if active,\n   *  otherwise the committed pose from the adapter. Returns `null` if the id\n   *  isn't known. */\n  getEffectivePose(id: string): TPose | null;\n  /** Overlay-aware bounds for `id`. */\n  getEffectiveBounds(id: string): Bounds | null;\n  /**\n   * World-space AABB of everything the in-flight gesture proposes — the\n   * displaced poses of nodes being moved / resized / rotated / cloned, plus\n   * any nascent insert that has no scene node yet. `null` when no gesture is\n   * in flight.\n   *\n   * This reports the *gesture*, not the document: committed content the\n   * gesture isn't touching is excluded. Select-only gestures are excluded\n   * too: a marquee or lasso has geometry but proposes no content.\n   *\n   * The result is a plain AABB — never rotated. Rotated parts are folded in\n   * by their rotated extent.\n   */\n  getGestureBounds(): Bounds | null;\n  /**\n   * Subscribe to the gesture layer's change signal, for everything on this\n   * object that moves during a drag (`getEffectivePose`, `getEffectiveBounds`,\n   * `getGestureBounds`). Returns an unsubscribe.\n   *\n   * Fires once per dispatcher pump: gesture start, every pointermove that\n   * reaches an in-flight handle, end, and cancel — plus UI-driven ongoing\n   * actions. It fires on the pump, not on a diff: a pump that changed nothing\n   * observable still notifies, so don't hang expensive work directly off the\n   * callback.\n   *\n   * It does **not** cover committed scene edits (subscribe to the scene for\n   * those) or previews a consumer's own tool publishes from React state.\n   * Without a gesture source wired — a bare `<Canvas>` — it never fires.\n   */\n  subscribeGestures(fn: () => void): () => void;\n  /**\n   * Monotonic counter bumped on exactly the events `subscribeGestures` fires\n   * on. Pair the two for `useSyncExternalStore`:\n   *\n   * ```ts\n   * const gestureVersion = useSyncExternalStore(\n   *   useCallback((cb) => helpersRef.current?.subscribeGestures(cb) ?? (() => {}), []),\n   *   () => helpersRef.current?.getGestureVersion() ?? 0,\n   * );\n   * ```\n   *\n   * Starts at 0 and only increases. `0` is also what a bare `<Canvas>` with\n   * no gesture source reports, forever.\n   */\n  getGestureVersion(): number;\n  /** The live ChromeState built once per render: overlay-aware selection\n   *  state for affordances and custom layers. */\n  getChromeState(): ChromeState;\n  /**\n   * Everything publishing an in-flight preview for this view: the handles in\n   * flight on its dispatcher, in dispatch order. Readers take the first\n   * non-null answer per id.\n   *\n   * A ghost layer must read this off its draw envelope rather than close over\n   * a dispatcher: one layer array paints every view, so a closure ghosts view\n   * zero's drag into every panel.\n   */\n  getPreviewSources(): readonly GesturePreviewSource[];\n  /** Overlay shapes this view's in-flight handles publish — marquee, lasso,\n   *  insert preview, raw commands. Same envelope rule as\n   *  {@link CanvasViewHelpers.getPreviewSources}. */\n  getGestureOverlays(): readonly OngoingOverlay[];\n  /**\n   * Chrome-caps visibility predicate, keyed by chrome id. Overlay layers and\n   * affordances call it per element to decide whether to draw / hit-test.\n   * Unwired, it is the universal `() => true`.\n   */\n  getIsVisible(): (id: string) => boolean;\n}\n\n/**\n * The half of {@link CanvasHelpers} that belongs to the surface — one GL\n * context, one debug sink, however many views are drawn on it.\n */\nexport interface CanvasSurfaceHelpers {\n  /** Active debug sink, when `<Canvas debug=...>` is enabled, for layers to\n   *  call from their `draw` callback. `null` when debug is off. */\n  getDebug(): DebugSink | null;\n}\n\n/** Live overlay-aware lookups exposed to custom layers via `helpersRef`, and\n *  what a layer receives as its `data` argument. */\nexport interface CanvasHelpers<TPose> extends CanvasViewHelpers<TPose>, CanvasSurfaceHelpers {\n  /**\n   * The view this draw is for: a `<CanvasView>` id, or `null` for the\n   * surface's own camera. One layer array paints every view, so a layer that\n   * belongs in some views and not others — a minimap's indicator — declines\n   * the rest by this id.\n   */\n  readonly viewId: string | null;\n}\n\n/** What a view's pose and bounds lookups read of an adapter. */\nexport interface ViewPoseAdapter<TPose> {\n  getPose(id: string): TPose;\n  /** Where the node is drawn, when the adapter composes poses. An adapter\n   *  without it stores absolute poses, where the two agree. */\n  getWorldPose?(id: string): TPose;\n  /** The node an id names, whose `layer` decides whether a view that hides\n   *  that layer shows its selection chrome. */\n  getNode?(id: string): { layer?: string } | undefined;\n}\n\nexport interface UseViewHelpersOpts<TPose> {\n  adapter: ViewPoseAdapter<TPose> | undefined;\n  geometry: PoseDescriptor<TPose>;\n  /** Consumer-supplied bounds resolver. Falls back to the adapter's pose. */\n  boundsOf: ((id: string) => Bounds | null) | undefined;\n  /** Bounds of `id` drawn at an in-flight `pose`. Falls back to the\n   *  geometry's box of that pose, which is wrong wherever the surface draws a\n   *  node somewhere its pose does not say — a parallax plane. */\n  boundsOfPose?: ((id: string, pose: TPose) => Bounds | null) | undefined;\n  /** The nodes the adapter's ids name: with them, the fallbacks box each as\n   *  drawn, stroke included, rather than by its pose. */\n  nodes?: DrawnBoundsScene | undefined;\n  /** The view's scale, which a screen-pixel stroke is resolved at. Default 1. */\n  getScale?: (() => Scale2) | undefined;\n  /** The ids selected, read whenever chrome asks: a view following another\n   *  reads that view's, which changes without this one rendering. */\n  selection: () => readonly NodeId[];\n  gestureSource: GestureSource | undefined;\n  /** The dispatcher's preview pose for an id, read through a ref so a change\n   *  mid-gesture doesn't rebuild the memos that depend on it. */\n  previewPoseExtra: ((id: string) => unknown) | undefined;\n  /** Chrome-caps predicate for this view. Absent means everything is visible. */\n  getIsVisible?: (() => (id: string) => boolean) | undefined;\n  /** Whether a scene layer reaches the screen in this view. Absent means\n   *  every layer the scene shows does. */\n  layerIsPainted?: ((layerId: string) => boolean) | undefined;\n}\n\nexport interface ViewHelpersBundle<TPose> {\n  helpers: CanvasViewHelpers<TPose>;\n}\n\nfunction worldPoseOf<TPose>(adapter: ViewPoseAdapter<TPose>, id: string): TPose {\n  return typeof adapter.getWorldPose === 'function' ? adapter.getWorldPose(id) : adapter.getPose(id);\n}\n\n/**\n * Build one view's overlay-aware state: its chrome and the lookups its layers\n * draw and hit-test against. A canvas with N views mounts N components each\n * calling this once.\n */\nexport function useViewHelpers<TPose>(\n  opts: UseViewHelpersOpts<TPose>,\n): ViewHelpersBundle<TPose> {\n  const {\n    adapter, geometry, boundsOf, boundsOfPose, nodes, getScale, selection, gestureSource,\n    previewPoseExtra, getIsVisible, layerIsPainted,\n  } = opts;\n  const getScaleRef = useLatest(getScale);\n  const poseBoxOf = useCallback((id: string, pose: TPose): Bounds => {\n    if (!nodes) return framedBounds(pose, geometry);\n    const scale = getScaleRef.current?.();\n    return drawnBoundsOf(nodes, id as NodeId, pose, {\n      descriptor: geometry as PoseDescriptor<unknown>,\n      ...(adapter ? { worldPoseOf: (m: NodeId) => worldPoseOf(adapter, m) } : {}),\n      ...(scale ? { scale } : {}),\n    });\n  }, [nodes, geometry, adapter, getScaleRef]);\n  const boxOf = useCallback(\n    (id: string, pose: TPose): Bounds | null =>\n      (boundsOfPose ? boundsOfPose(id, pose) : poseBoxOf(id, pose)),\n    [boundsOfPose, poseBoxOf],\n  );\n\n  const baseBoundsOf = useMemo(() => {\n    if (boundsOf) return boundsOf;\n    if (!adapter) return undefined;\n    return (id: string): Bounds | null => {\n      try {\n        // World: chrome is drawn over the picture, so it has to agree with\n        // where the renderer put the node, not with where its pose is stored.\n        return poseBoxOf(id, worldPoseOf(adapter, id));\n      } catch {\n        return null;\n      }\n    };\n  }, [boundsOf, adapter, poseBoxOf]);\n\n  const committedPoseOf = useCallback((id: string): TPose | null => {\n    if (!adapter) return null;\n    try {\n      return worldPoseOf(adapter, id);\n    } catch {\n      return null;\n    }\n  }, [adapter]);\n\n  const selectionRef = useLatest(selection);\n\n  const effectiveBoundsOf = useMemo(() => boundsOf ?? baseBoundsOf, [boundsOf, baseBoundsOf]);\n  const { previewPoseOf, previewBoundsOf } = useInFlightBounds({ gestureSource, previewPoseExtra, boxOf, committedPoseOf });\n\n  /**\n   * Bounds for `id` with any in-flight gesture folded in — what the user can\n   * see, not what is committed. Both the chrome state and the layer helpers\n   * answer bounds questions with this, so resize handles cannot end up a frame\n   * away from the shape they belong to.\n   */\n  const boundsWithPreview = useCallback((id: string): Bounds | null => {\n    const previewed = previewBoundsOf(id);\n    if (previewed) return previewed;\n    return effectiveBoundsOf ? effectiveBoundsOf(id) : null;\n  }, [previewBoundsOf, effectiveBoundsOf]);\n\n  const chromeState: ChromeState = useMemo(\n    () => buildChromeState({\n      get selection() { return selectionRef.current(); },\n      get multiActive() { return selectionRef.current().length > 1; },\n      effectiveBoundsOf: boundsWithPreview,\n      modifiers: { alt: false, shift: false, meta: false, ctrl: false },\n      // Absent adapter / unknown ids fall back to `true` so the affordance\n      // stays visible for consumers that wire bounds without an adapter.\n      canRotate: (id) => {\n        if (!geometry.supportsRotation) return true;\n        const pose = committedPoseOf(id);\n        if (pose == null) return true;\n        return geometry.supportsRotation(pose);\n      },\n      ...(layerIsPainted ? { layerIsPainted } : {}),\n      ...(adapter?.getNode ? { layerOf: (id: string) => adapter.getNode?.(id)?.layer } : {}),\n    }),\n    [selectionRef, boundsWithPreview, geometry, committedPoseOf, layerIsPainted, adapter],\n  );\n\n  const helpers: CanvasViewHelpers<TPose> = {\n    getEffectivePose: (id: string): TPose | null => {\n      return previewPoseOf(id) ?? committedPoseOf(id);\n    },\n    getEffectiveBounds: boundsWithPreview,\n    getGestureBounds: (): Bounds | null => {\n      // The same id sets the ghost layer walks, so this cannot disagree with\n      // what the user sees ghosted.\n      const parts: (Bounds | null)[] = [];\n      for (const id of new Set(gestureSource?.ids() ?? [])) parts.push(previewBoundsOf(id));\n      const extraBounds = gestureSource?.bounds();\n      if (extraBounds) for (const b of extraBounds) parts.push(b);\n      return unionAABB(parts);\n    },\n    subscribeGestures: (fn: () => void): (() => void) =>\n      gestureSource?.subscribe(fn) ?? noOpUnsubscribe,\n    getGestureVersion: (): number => gestureSource?.getVersion() ?? 0,\n    getChromeState: () => chromeState,\n    getPreviewSources: (): readonly GesturePreviewSource[] => gestureSource?.previewSources() ?? [],\n    getGestureOverlays: (): readonly OngoingOverlay[] => gestureSource?.overlays() ?? [],\n    getIsVisible: (): ((id: string) => boolean) => getIsVisible?.() ?? alwaysVisible,\n  };\n\n  return { helpers };\n}\n"],"mappings":"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"}
+{"version":3,"file":"useViewHelpers.js","names":[],"sources":["../../src/canvas/useViewHelpers.ts"],"sourcesContent":["import { useCallback, useMemo } from 'react';\nimport { framedBounds } from 'core/geometry/poseDescriptor';\nimport { useLatest } from '@weasel-js/react';\nimport type { GestureSource, GesturePreviewSource } from './gestureBounds';\nimport { useInFlightBounds } from './useInFlightBounds';\nimport type { OngoingOverlay } from '@weasel-js/routing';\nimport { unionAABB } from 'core/geometry/unionBounds';\nimport { buildChromeState, type ChromeState } from 'core/selection/chromeState';\nimport type { PoseDescriptor } from 'interactions/actions/resize/geometry';\nimport type { NodeId } from 'core/scene/types';\nimport type { DebugSink } from '../debug/types';\nimport type { Bounds } from 'core/viewport/fitViewToBounds';\nimport type { Scale2 } from '@weasel-js/geom';\nimport { drawnBoundsOf, type DrawnBoundsScene } from './drawnBounds';\n\nconst noOpUnsubscribe = (): void => {};\n\nconst alwaysVisible = (): boolean => true;\n\n/**\n * The half of {@link CanvasHelpers} that belongs to one view — everything\n * answered by a camera's own tools, gestures and selection. A canvas hosting\n * several viewports needs one of these per view; the surface half is shared.\n */\nexport interface CanvasViewHelpers<TPose> {\n  /** Pose currently displayed for `id` — drag/resize/rotate overlay if active,\n   *  otherwise the committed pose from the adapter. Returns `null` if the id\n   *  isn't known. */\n  getEffectivePose(id: string): TPose | null;\n  /** Overlay-aware bounds for `id`. */\n  getEffectiveBounds(id: string): Bounds | null;\n  /**\n   * World-space AABB of everything the in-flight gesture proposes — the\n   * displaced poses of nodes being moved / resized / rotated / cloned, plus\n   * any nascent insert that has no scene node yet. `null` when no gesture is\n   * in flight.\n   *\n   * This reports the *gesture*, not the document: committed content the\n   * gesture isn't touching is excluded. Select-only gestures are excluded\n   * too: a marquee or lasso has geometry but proposes no content.\n   *\n   * The result is a plain AABB — never rotated. Rotated parts are folded in\n   * by their rotated extent.\n   */\n  getGestureBounds(): Bounds | null;\n  /**\n   * Subscribe to the gesture layer's change signal, for everything on this\n   * object that moves during a drag (`getEffectivePose`, `getEffectiveBounds`,\n   * `getGestureBounds`). Returns an unsubscribe.\n   *\n   * Fires once per dispatcher pump: gesture start, every pointermove that\n   * reaches an in-flight handle, end, and cancel — plus UI-driven ongoing\n   * actions. It fires on the pump, not on a diff: a pump that changed nothing\n   * observable still notifies, so don't hang expensive work directly off the\n   * callback.\n   *\n   * It does **not** cover committed scene edits (subscribe to the scene for\n   * those) or previews a consumer's own tool publishes from React state.\n   * Without a gesture source wired — a bare `<Canvas>` — it never fires.\n   */\n  subscribeGestures(fn: () => void): () => void;\n  /**\n   * Monotonic counter bumped on exactly the events `subscribeGestures` fires\n   * on. Pair the two for `useSyncExternalStore`:\n   *\n   * ```ts\n   * const gestureVersion = useSyncExternalStore(\n   *   useCallback((cb) => helpersRef.current?.subscribeGestures(cb) ?? (() => {}), []),\n   *   () => helpersRef.current?.getGestureVersion() ?? 0,\n   * );\n   * ```\n   *\n   * Starts at 0 and only increases. `0` is also what a bare `<Canvas>` with\n   * no gesture source reports, forever.\n   */\n  getGestureVersion(): number;\n  /** The live ChromeState built once per render: overlay-aware selection\n   *  state for affordances and custom layers. */\n  getChromeState(): ChromeState;\n  /**\n   * Everything publishing an in-flight preview for this view: the handles in\n   * flight on its dispatcher, in dispatch order. Readers take the first\n   * non-null answer per id.\n   *\n   * A ghost layer must read this off its draw envelope rather than close over\n   * a dispatcher: one layer array paints every view, so a closure ghosts view\n   * zero's drag into every panel.\n   */\n  getPreviewSources(): readonly GesturePreviewSource[];\n  /** Overlay shapes this view's in-flight handles publish — marquee, lasso,\n   *  insert preview, raw commands. Same envelope rule as\n   *  {@link CanvasViewHelpers.getPreviewSources}. */\n  getGestureOverlays(): readonly OngoingOverlay[];\n  /**\n   * Chrome-caps visibility predicate, keyed by chrome id. Overlay layers and\n   * affordances call it per element to decide whether to draw / hit-test.\n   * Unwired, it is the universal `() => true`.\n   */\n  getIsVisible(): (id: string) => boolean;\n}\n\n/**\n * The half of {@link CanvasHelpers} that belongs to the surface — one GL\n * context, one debug sink, however many views are drawn on it.\n */\nexport interface CanvasSurfaceHelpers {\n  /** Active debug sink, when `<Canvas debug=...>` is enabled, for layers to\n   *  call from their `draw` callback. `null` when debug is off. */\n  getDebug(): DebugSink | null;\n}\n\n/** Live overlay-aware lookups exposed to custom layers via `helpersRef`, and\n *  what a layer receives as its `data` argument. */\nexport interface CanvasHelpers<TPose> extends CanvasViewHelpers<TPose>, CanvasSurfaceHelpers {\n  /**\n   * The view this draw is for: a `<CanvasView>` id, or `null` for the\n   * surface's own camera. One layer array paints every view, so a layer that\n   * belongs in some views and not others — a minimap's indicator — declines\n   * the rest by this id.\n   */\n  readonly viewId: string | null;\n}\n\n/** What a view's pose and bounds lookups read of an adapter. */\nexport interface ViewPoseAdapter<TPose> {\n  getPose(id: string): TPose;\n  /** Where the node is drawn, when the adapter composes poses. An adapter\n   *  without it stores absolute poses, where the two agree. */\n  getWorldPose?(id: string): TPose;\n  /** Where `id` is drawn if it stores `stored`. An adapter without it stores\n   *  absolute poses. */\n  worldOfStored?(id: string, stored: TPose): TPose;\n  /** The node an id names, whose `layer` decides whether a view that hides\n   *  that layer shows its selection chrome. */\n  getNode?(id: string): { layer?: string } | undefined;\n}\n\nexport interface UseViewHelpersOpts<TPose> {\n  adapter: ViewPoseAdapter<TPose> | undefined;\n  geometry: PoseDescriptor<TPose>;\n  /** Consumer-supplied bounds resolver. Falls back to the adapter's pose. */\n  boundsOf: ((id: string) => Bounds | null) | undefined;\n  /** Bounds of `id` drawn at an in-flight `pose`. Falls back to the\n   *  geometry's box of that pose, which is wrong wherever the surface draws a\n   *  node somewhere its pose does not say — a parallax plane. */\n  boundsOfPose?: ((id: string, pose: TPose) => Bounds | null) | undefined;\n  /** The nodes the adapter's ids name: with them, the fallbacks box each as\n   *  drawn, stroke included, rather than by its pose. */\n  nodes?: DrawnBoundsScene | undefined;\n  /** The view's scale, which a screen-pixel stroke is resolved at. Default 1. */\n  getScale?: (() => Scale2) | undefined;\n  /** The ids selected, read whenever chrome asks: a view following another\n   *  reads that view's, which changes without this one rendering. */\n  selection: () => readonly NodeId[];\n  gestureSource: GestureSource | undefined;\n  /** The dispatcher's preview pose for an id, read through a ref so a change\n   *  mid-gesture doesn't rebuild the memos that depend on it. */\n  previewPoseExtra: ((id: string) => unknown) | undefined;\n  /** Chrome-caps predicate for this view. Absent means everything is visible. */\n  getIsVisible?: (() => (id: string) => boolean) | undefined;\n  /** Whether a scene layer reaches the screen in this view. Absent means\n   *  every layer the scene shows does. */\n  layerIsPainted?: ((layerId: string) => boolean) | undefined;\n}\n\nexport interface ViewHelpersBundle<TPose> {\n  helpers: CanvasViewHelpers<TPose>;\n}\n\nfunction worldPoseOf<TPose>(adapter: ViewPoseAdapter<TPose>, id: string): TPose {\n  return typeof adapter.getWorldPose === 'function' ? adapter.getWorldPose(id) : adapter.getPose(id);\n}\n\n/**\n * Build one view's overlay-aware state: its chrome and the lookups its layers\n * draw and hit-test against. A canvas with N views mounts N components each\n * calling this once.\n */\nexport function useViewHelpers<TPose>(\n  opts: UseViewHelpersOpts<TPose>,\n): ViewHelpersBundle<TPose> {\n  const {\n    adapter, geometry, boundsOf, boundsOfPose, nodes, getScale, selection, gestureSource,\n    previewPoseExtra, getIsVisible, layerIsPainted,\n  } = opts;\n  const getScaleRef = useLatest(getScale);\n  const poseBoxOf = useCallback((id: string, pose: TPose): Bounds => {\n    if (!nodes) return framedBounds(pose, geometry);\n    const scale = getScaleRef.current?.();\n    return drawnBoundsOf(nodes, id as NodeId, pose, {\n      descriptor: geometry as PoseDescriptor<unknown>,\n      ...(adapter ? { worldPoseOf: (m: NodeId) => worldPoseOf(adapter, m) } : {}),\n      ...(scale ? { scale } : {}),\n    });\n  }, [nodes, geometry, adapter, getScaleRef]);\n  const boxOf = useCallback(\n    (id: string, pose: TPose): Bounds | null =>\n      (boundsOfPose ? boundsOfPose(id, pose) : poseBoxOf(id, pose)),\n    [boundsOfPose, poseBoxOf],\n  );\n\n  const baseBoundsOf = useMemo(() => {\n    if (boundsOf) return boundsOf;\n    if (!adapter) return undefined;\n    return (id: string): Bounds | null => {\n      try {\n        // World: chrome is drawn over the picture, so it has to agree with\n        // where the renderer put the node, not with where its pose is stored.\n        return poseBoxOf(id, worldPoseOf(adapter, id));\n      } catch {\n        return null;\n      }\n    };\n  }, [boundsOf, adapter, poseBoxOf]);\n\n  const committedPoseOf = useCallback((id: string): TPose | null => {\n    if (!adapter) return null;\n    try {\n      return worldPoseOf(adapter, id);\n    } catch {\n      return null;\n    }\n  }, [adapter]);\n\n  const selectionRef = useLatest(selection);\n\n  const effectiveBoundsOf = useMemo(() => boundsOf ?? baseBoundsOf, [boundsOf, baseBoundsOf]);\n  const worldOfStored = useMemo(\n    () => (adapter?.worldOfStored ? (id: string, stored: TPose) => adapter.worldOfStored!(id, stored) : undefined),\n    [adapter],\n  );\n  const { previewPoseOf, previewBoundsOf } = useInFlightBounds({\n    gestureSource, previewPoseExtra, boxOf, committedPoseOf, worldOfStored,\n  });\n\n  /**\n   * Bounds for `id` with any in-flight gesture folded in — what the user can\n   * see, not what is committed. Both the chrome state and the layer helpers\n   * answer bounds questions with this, so resize handles cannot end up a frame\n   * away from the shape they belong to.\n   */\n  const boundsWithPreview = useCallback((id: string): Bounds | null => {\n    const previewed = previewBoundsOf(id);\n    if (previewed) return previewed;\n    return effectiveBoundsOf ? effectiveBoundsOf(id) : null;\n  }, [previewBoundsOf, effectiveBoundsOf]);\n\n  const chromeState: ChromeState = useMemo(\n    () => buildChromeState({\n      get selection() { return selectionRef.current(); },\n      get multiActive() { return selectionRef.current().length > 1; },\n      effectiveBoundsOf: boundsWithPreview,\n      modifiers: { alt: false, shift: false, meta: false, ctrl: false },\n      // Absent adapter / unknown ids fall back to `true` so the affordance\n      // stays visible for consumers that wire bounds without an adapter.\n      canRotate: (id) => {\n        if (!geometry.supportsRotation) return true;\n        const pose = committedPoseOf(id);\n        if (pose == null) return true;\n        return geometry.supportsRotation(pose);\n      },\n      ...(layerIsPainted ? { layerIsPainted } : {}),\n      ...(adapter?.getNode ? { layerOf: (id: string) => adapter.getNode?.(id)?.layer } : {}),\n    }),\n    [selectionRef, boundsWithPreview, geometry, committedPoseOf, layerIsPainted, adapter],\n  );\n\n  const helpers: CanvasViewHelpers<TPose> = {\n    getEffectivePose: (id: string): TPose | null => {\n      return previewPoseOf(id) ?? committedPoseOf(id);\n    },\n    getEffectiveBounds: boundsWithPreview,\n    getGestureBounds: (): Bounds | null => {\n      // The same id sets the ghost layer walks, so this cannot disagree with\n      // what the user sees ghosted.\n      const parts: (Bounds | null)[] = [];\n      for (const id of new Set(gestureSource?.ids() ?? [])) parts.push(previewBoundsOf(id));\n      const extraBounds = gestureSource?.bounds();\n      if (extraBounds) for (const b of extraBounds) parts.push(b);\n      return unionAABB(parts);\n    },\n    subscribeGestures: (fn: () => void): (() => void) =>\n      gestureSource?.subscribe(fn) ?? noOpUnsubscribe,\n    getGestureVersion: (): number => gestureSource?.getVersion() ?? 0,\n    getChromeState: () => chromeState,\n    getPreviewSources: (): readonly GesturePreviewSource[] => gestureSource?.previewSources() ?? [],\n    getGestureOverlays: (): readonly OngoingOverlay[] => gestureSource?.overlays() ?? [],\n    getIsVisible: (): ((id: string) => boolean) => getIsVisible?.() ?? alwaysVisible,\n  };\n\n  return { helpers };\n}\n"],"mappings":"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"}

package/dist/canvas/useViewLayerGate.js

@@ -2,7 +2,7 @@ import { createSceneLayerGate } from "./sceneLayerPaint.js";
 import { useCallback, useState } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/useViewLayerGate.ts
+// src/canvas/useViewLayerGate.ts
 /**
 * Whether a surface's own view paints a scene layer, judged against the stack
 * `surfaceLayers` returns, read at ask time, so a consumer slot anchored
@@ -24,6 +24,5 @@ function useViewLayerGate(layerVisibility, layerOrder, surfaceLayers) {
 	return layerVisibility !== void 0 || layerOrder !== void 0 ? layerIsPainted : void 0;
 }
 
-//#endregion
 export { useViewLayerGate };
 //# sourceMappingURL=useViewLayerGate.js.map

package/dist/canvas/useViewNesting.js

@@ -1,7 +1,7 @@
 import { createSceneLayerGate, viewPaintedLayers } from "./sceneLayerPaint.js";
 import { useCallback, useRef, useState } from "react";
 
-//#region src/canvas/useViewNesting.ts
+// src/canvas/useViewNesting.ts
 /**
 * How a `<CanvasView>` sits in the view it is nested in: the frame its
 * `bounds` and derived camera are measured against, and the layers it may
@@ -127,6 +127,5 @@ function useViewNesting(registry, live) {
 	};
 }
 
-//#endregion
 export { NO_RECT, sizeOf, useViewNesting };
 //# sourceMappingURL=useViewNesting.js.map

package/dist/canvas/useViewRegistrySurface.js

@@ -1,7 +1,8 @@
+import { viewScreenToWorld } from "@weasel-js/geom";
 import { useEffect } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/canvas/useViewRegistrySurface.ts
+// src/canvas/useViewRegistrySurface.ts
 /**
 * Attach this canvas to the view registry as its surface. The stack a view paints through its
 * own camera is this canvas's `layers`, before the views themselves are folded in — otherwise
@@ -23,9 +24,11 @@ function useViewRegistrySurface(viewRegistry, layers, frame, services) {
 			setView,
 			claimsAbove: (x, y) => {
 				const view = viewRef.current;
-				const worldX = x / view.scale.x + view.x;
-				const worldY = y / view.scale.y + view.y;
-				return hitTestExtrasIn(worldX, worldY, view, dimsRef.current, helpersRef.current) !== null;
+				const world = viewScreenToWorld(view, {
+					x,
+					y
+				});
+				return hitTestExtrasIn(world.x, world.y, view, dimsRef.current, helpersRef.current) !== null;
 			}
 		});
 	}, [
@@ -41,6 +44,5 @@ function useViewRegistrySurface(viewRegistry, layers, frame, services) {
 	]);
 }
 
-//#endregion
 export { useViewRegistrySurface };
 //# sourceMappingURL=useViewRegistrySurface.js.map

package/dist/canvas/useViewRegistrySurface.js.map

@@ -1 +1 @@
-{"version":3,"file":"useViewRegistrySurface.js","names":[],"sources":["../../src/canvas/useViewRegistrySurface.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { View } from 'core/viewport/view';\nimport type { Dims, RenderLayer } from 'core/layers/render';\nimport type { CanvasHelpers } from './useViewHelpers';\nimport type { SurfaceHandle, ViewRegistry } from './viewRegistry';\n\n/** What the canvas reads at draw and hit time that changes outside a render. */\nexport interface SurfaceFrame {\n  viewRef: { readonly current: View };\n  dimsRef: { readonly current: Dims };\n  helpersRef: { readonly current: Pick<CanvasHelpers<unknown>, 'getChromeState'> | null };\n}\n\n/** What the canvas does for a view that asks. */\nexport interface SurfaceServices {\n  requestRedraw: () => void;\n  hitTestExtrasIn: SurfaceHandle['hitTestExtras'];\n  clientToWorld: SurfaceHandle['clientToWorld'];\n  setView: NonNullable<SurfaceHandle['setView']>;\n}\n\n/**\n * Attach this canvas to the view registry as its surface. The stack a view paints through its\n * own camera is this canvas's `layers`, before the views themselves are folded in — otherwise\n * a view would contain itself. Published by reference and read at draw time.\n */\nexport function useViewRegistrySurface(\n  viewRegistry: ViewRegistry | null,\n  layers: readonly RenderLayer<unknown>[],\n  frame: SurfaceFrame,\n  services: SurfaceServices,\n): void {\n  const surfaceLayersRef = useLatest<readonly RenderLayer<unknown>[]>(layers);\n  const { viewRef, dimsRef, helpersRef } = frame;\n  const { requestRedraw, hitTestExtrasIn, clientToWorld, setView } = services;\n  useEffect(() => {\n    return viewRegistry?.attachSurface({\n      view: () => viewRef.current,\n      dims: () => dimsRef.current,\n      layers: () => surfaceLayersRef.current,\n      requestRedraw,\n      chromeState: () => helpersRef.current!.getChromeState(),\n      hitTestExtras: hitTestExtrasIn,\n      clientToWorld,\n      setView,\n      claimsAbove: (x, y) => {\n        const view = viewRef.current;\n        const worldX = x / view.scale.x + view.x;\n        const worldY = y / view.scale.y + view.y;\n        return hitTestExtrasIn(worldX, worldY, view, dimsRef.current, helpersRef.current) !== null;\n      },\n    });\n  }, [viewRegistry, requestRedraw, hitTestExtrasIn, dimsRef, surfaceLayersRef, viewRef, helpersRef, clientToWorld, setView]);\n}\n"],"mappings":";;;;;;;;;AA2BA,SAAgB,uBACd,cACA,QACA,OACA,UACM;CACN,MAAM,mBAAmB,UAA2C,MAAM;CAC1E,MAAM,EAAE,SAAS,SAAS,eAAe;CACzC,MAAM,EAAE,eAAe,iBAAiB,eAAe,YAAY;CACnE,gBAAgB;EACd,OAAO,cAAc,cAAc;GACjC,YAAY,QAAQ;GACpB,YAAY,QAAQ;GACpB,cAAc,iBAAiB;GAC/B;GACA,mBAAmB,WAAW,QAAS,eAAe;GACtD,eAAe;GACf;GACA;GACA,cAAc,GAAG,MAAM;IACrB,MAAM,OAAO,QAAQ;IACrB,MAAM,SAAS,IAAI,KAAK,MAAM,IAAI,KAAK;IACvC,MAAM,SAAS,IAAI,KAAK,MAAM,IAAI,KAAK;IACvC,OAAO,gBAAgB,QAAQ,QAAQ,MAAM,QAAQ,SAAS,WAAW,OAAO,MAAM;GACxF;EACF,CAAC;CACH,GAAG;EAAC;EAAc;EAAe;EAAiB;EAAS;EAAkB;EAAS;EAAY;EAAe;CAAO,CAAC;AAC3H"}
+{"version":3,"file":"useViewRegistrySurface.js","names":[],"sources":["../../src/canvas/useViewRegistrySurface.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { viewScreenToWorld } from '@weasel-js/geom';\nimport type { View } from 'core/viewport/view';\nimport type { Dims, RenderLayer } from 'core/layers/render';\nimport type { CanvasHelpers } from './useViewHelpers';\nimport type { SurfaceHandle, ViewRegistry } from './viewRegistry';\n\n/** What the canvas reads at draw and hit time that changes outside a render. */\nexport interface SurfaceFrame {\n  viewRef: { readonly current: View };\n  dimsRef: { readonly current: Dims };\n  helpersRef: { readonly current: Pick<CanvasHelpers<unknown>, 'getChromeState'> | null };\n}\n\n/** What the canvas does for a view that asks. */\nexport interface SurfaceServices {\n  requestRedraw: () => void;\n  hitTestExtrasIn: SurfaceHandle['hitTestExtras'];\n  clientToWorld: SurfaceHandle['clientToWorld'];\n  setView: NonNullable<SurfaceHandle['setView']>;\n}\n\n/**\n * Attach this canvas to the view registry as its surface. The stack a view paints through its\n * own camera is this canvas's `layers`, before the views themselves are folded in — otherwise\n * a view would contain itself. Published by reference and read at draw time.\n */\nexport function useViewRegistrySurface(\n  viewRegistry: ViewRegistry | null,\n  layers: readonly RenderLayer<unknown>[],\n  frame: SurfaceFrame,\n  services: SurfaceServices,\n): void {\n  const surfaceLayersRef = useLatest<readonly RenderLayer<unknown>[]>(layers);\n  const { viewRef, dimsRef, helpersRef } = frame;\n  const { requestRedraw, hitTestExtrasIn, clientToWorld, setView } = services;\n  useEffect(() => {\n    return viewRegistry?.attachSurface({\n      view: () => viewRef.current,\n      dims: () => dimsRef.current,\n      layers: () => surfaceLayersRef.current,\n      requestRedraw,\n      chromeState: () => helpersRef.current!.getChromeState(),\n      hitTestExtras: hitTestExtrasIn,\n      clientToWorld,\n      setView,\n      claimsAbove: (x, y) => {\n        const view = viewRef.current;\n        const world = viewScreenToWorld(view, { x, y });\n        return hitTestExtrasIn(world.x, world.y, view, dimsRef.current, helpersRef.current) !== null;\n      },\n    });\n  }, [viewRegistry, requestRedraw, hitTestExtrasIn, dimsRef, surfaceLayersRef, viewRef, helpersRef, clientToWorld, setView]);\n}\n"],"mappings":";;;;;;;;;;AA4BA,SAAgB,uBACd,cACA,QACA,OACA,UACM;CACN,MAAM,mBAAmB,UAA2C,MAAM;CAC1E,MAAM,EAAE,SAAS,SAAS,eAAe;CACzC,MAAM,EAAE,eAAe,iBAAiB,eAAe,YAAY;CACnE,gBAAgB;EACd,OAAO,cAAc,cAAc;GACjC,YAAY,QAAQ;GACpB,YAAY,QAAQ;GACpB,cAAc,iBAAiB;GAC/B;GACA,mBAAmB,WAAW,QAAS,eAAe;GACtD,eAAe;GACf;GACA;GACA,cAAc,GAAG,MAAM;IACrB,MAAM,OAAO,QAAQ;IACrB,MAAM,QAAQ,kBAAkB,MAAM;KAAE;KAAG;IAAE,CAAC;IAC9C,OAAO,gBAAgB,MAAM,GAAG,MAAM,GAAG,MAAM,QAAQ,SAAS,WAAW,OAAO,MAAM;GAC1F;EACF,CAAC;CACH,GAAG;EAAC;EAAc;EAAe;EAAiB;EAAS;EAAkB;EAAS;EAAY;EAAe;CAAO,CAAC;AAC3H"}

package/dist/canvas/viewInputs.js

@@ -1,7 +1,7 @@
 import { createContext, useContext } from "react";
 import { jsx } from "react/jsx-runtime";
 
-//#region src/canvas/viewInputs.tsx
+// src/canvas/viewInputs.tsx
 var ViewInputsContext = createContext(null);
 /** @internal */
 function ViewInputsProvider({ value, children }) {
@@ -15,6 +15,5 @@ function useOptionalViewInputs() {
 	return useContext(ViewInputsContext);
 }
 
-//#endregion
 export { ViewInputsProvider, useOptionalViewInputs };
 //# sourceMappingURL=viewInputs.js.map

package/dist/canvas/viewMarkers.js

@@ -2,7 +2,7 @@ import { aimSpace2d } from "../domains/viewports/aim.js";
 import { createViewMarkerLayer, grabViewMarker } from "../domains/viewports/viewMarker.js";
 import { layerAffordance } from "./affordanceAt.js";
 
-//#region src/canvas/viewMarkers.ts
+// src/canvas/viewMarkers.ts
 /** @internal */
 function createViewMarkerRegistry(markers, deps) {
 	let gate = null;
@@ -58,6 +58,5 @@ function createViewMarkerRegistry(markers, deps) {
 	};
 }
 
-//#endregion
 export { createViewMarkerRegistry };
 //# sourceMappingURL=viewMarkers.js.map

package/dist/canvas/viewRegistry.js

@@ -2,11 +2,12 @@ import { createViewResolver, viewContains } from "../domains/viewports/viewResol
 import { isRectAim, rectAim, viewForAim } from "../domains/viewports/aim.js";
 import { viewportWorldRect } from "../core/viewport/viewportWorldRect.js";
 import { createViewMarkerRegistry } from "./viewMarkers.js";
+import { viewWorldToScreen } from "@weasel-js/geom";
 import { createEmitter } from "@weasel-js/registry";
 import { createContext, useContext, useMemo, useRef } from "react";
 import { jsx } from "react/jsx-runtime";
 
-//#region src/canvas/viewRegistry.tsx
+// src/canvas/viewRegistry.tsx
 /**
 * The seam between a canvas surface and the views drawn on it.
 *
@@ -29,11 +30,10 @@ function surfaceLocal(surface, clientX, clientY) {
 		y: clientY
 	};
 	const [worldX, worldY] = surface.clientToWorld(clientX, clientY);
-	const view = surface.view();
-	return {
-		x: (worldX - view.x) * view.scale.x,
-		y: (worldY - view.y) * view.scale.y
-	};
+	return viewWorldToScreen(surface.view(), {
+		x: worldX,
+		y: worldY
+	});
 }
 var ViewRegistryContext = createContext(null);
 /** Mounts the registry for one surface. `<SceneCanvas>` mounts one; a view
@@ -186,6 +186,5 @@ var IDENTITY_VIEW = {
 	}
 };
 
-//#endregion
 export { IDENTITY_VIEW, UNMEASURED_DIMS, ViewRegistryProvider, surfaceLocal, useOptionalViewRegistry };
 //# sourceMappingURL=viewRegistry.js.map

package/dist/canvas/viewRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"viewRegistry.js","names":[],"sources":["../../src/canvas/viewRegistry.tsx"],"sourcesContent":["/**\n * The seam between a canvas surface and the views drawn on it.\n *\n * Traffic runs both ways: the surface attaches a handle onto its frame and its\n * layer stack, and each view registers what it contributes back — the viewport\n * node it paints into and the record the gesture dispatcher routes its events\n * to. Both sides are thunks, read at draw and dispatch time, so neither can\n * serve the other a frame that has already moved.\n */\nimport { createContext, useContext, useMemo, useRef, type ReactNode } from 'react';\nimport type { Dims, RenderLayer } from 'core/layers/render';\nimport type { LayerHit } from 'affordances/types';\nimport type { ChromeState } from 'core/selection/chromeState';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport type { View } from 'core/viewport/view';\nimport type { ViewportLayer } from 'domains/viewports/viewportLayer';\nimport type { DispatcherViewTarget } from '@weasel-js/routing/internal';\nimport { createViewResolver, viewContains, type ViewResolver } from 'domains/viewports/viewResolver';\nimport { createEmitter } from '@weasel-js/registry';\nimport type { ViewAt } from './canvasExtension';\nimport { isRectAim, rectAim, viewForAim, type ViewAim } from 'domains/viewports/aim';\nimport { viewportWorldRect } from 'core/viewport/viewportWorldRect';\nimport type { ViewMarkerProps } from 'domains/viewports/viewMarker';\nimport { createViewMarkerRegistry, type ViewMarkerRegistry } from './viewMarkers';\n\n/**\n * What a view needs from the surface hosting it.\n *\n * @internal Attached by the surface, read by `<CanvasView>`.\n */\nexport interface SurfaceHandle {\n  /** A client point in the surface's own world — the conversion the surface\n   *  itself makes, its `clientToWorld` override included. */\n  clientToWorld(clientX: number, clientY: number): [number, number];\n  /** The outer camera. */\n  view(): View;\n  /** The canvas's CSS-pixel size. */\n  dims(): Dims;\n  /** The stack a view paints through its own camera, unless it narrows it. */\n  layers(): readonly RenderLayer<unknown>[];\n  requestRedraw(): void;\n  /** The canvas's own view chrome — its selection, its overlay-aware bounds.\n   *  What a `<CanvasView>` answers for itself, answered for view zero. */\n  chromeState(): ChromeState;\n  /** Hit-test the externally registered layers at a world point, against the\n   *  frame and draw envelope of whichever view is asking. The public\n   *  `hitTestExtras` is this with the canvas's own frame and envelope. */\n  hitTestExtras(\n    worldX: number,\n    worldY: number,\n    view: View,\n    dims: Dims,\n    data: unknown,\n    /** Consider only these layers — the ones the asking view paints. A layer\n     *  asked on a frame it was not drawn in answers for the wrong pixels. */\n    only?: readonly RenderLayer<unknown>[],\n  ): { layerId: string; hit: LayerHit } | null;\n  /** Whether a registered layer claims a canvas-local point on the surface's\n   *  own frame. Registered layers paint over every view, so such a point is\n   *  theirs even inside a view's rect. */\n  claimsAbove(x: number, y: number): boolean;\n  /** The root camera's input write: clamped, forwarded when controlled, and ending a glide. */\n  setView?(next: View): void;\n}\n\n/**\n * A client point in the surface's CSS pixels, from its top-left: the surface's\n * own world point put back through its camera, so a `clientToWorld` override\n * reaches every view declared on it.\n *\n * @internal\n */\nexport function surfaceLocal(\n  surface: Pick<SurfaceHandle, 'clientToWorld' | 'view'> | null,\n  clientX: number,\n  clientY: number,\n): { x: number; y: number } {\n  if (!surface) return { x: clientX, y: clientY };\n  const [worldX, worldY] = surface.clientToWorld(clientX, clientY);\n  const view = surface.view();\n  return { x: (worldX - view.x) * view.scale.x, y: (worldY - view.y) * view.scale.y };\n}\n\n/**\n * What one view contributes to the surface hosting it.\n *\n * @internal Written by `<CanvasView>`, read by the surface. Consumers declare\n *   a view, not a registration.\n */\nexport interface ViewRegistration {\n  id: string;\n  /** The view this one is nested in: listed, painted and hit after it, and\n   *  its `layer` measures itself from that view's rect and camera. */\n  parent?: string;\n  /**\n   * Paint and hit order, low to high. Views declared as props take their array\n   * index; a view mounted as a child takes `Infinity`, so it lands after them\n   * however React happens to order the mount effects.\n   */\n  order: number;\n  /** The viewport node this view paints into. Its `resolvable` is what routes\n   *  input here. */\n  layer: ViewportLayer<unknown>;\n  /** `false` keeps input over the view on the canvas beneath it. */\n  interactive: boolean;\n  /** `false` leaves `layer` for a host to draw — a HUD window's interior — so\n   *  the surface does not paint it too. */\n  paint: boolean;\n  /** Everything about dispatching to this view except its id. */\n  target: Omit<DispatcherViewTarget, 'id'>;\n  /** Whether a scene layer reaches the screen in this view. For input that\n   *  reaches a view without a dispatch — hover — so it judges this view's\n   *  paint rather than the surface's. */\n  layerIsPainted(layerId: string): boolean;\n  /** The layers this view draws, in order — what a view nested in it paints\n   *  from. */\n  drawnLayers(): readonly RenderLayer<unknown>[];\n  /** The selection the view owns, or the one the view it follows owns;\n   *  `undefined` while it shares the surface's. */\n  selection(): SelectionApi | undefined;\n  /** Whether the view keeps its camera or its aim; the other is derived. */\n  held: 'camera' | 'aim';\n  /** What the view shows: the aim it holds, or its camera's. */\n  aim(): ViewAim;\n  /** `false` for an aim the view cannot read, or one with nowhere to go. */\n  setAim(aim: ViewAim): boolean;\n}\n\n\n/** @internal */\nexport interface ViewRegistry extends ViewMarkerRegistry {\n  /** Returns an unregister. */\n  register(reg: ViewRegistration): () => void;\n  /** Live registrations in paint order, each nested view after the view it\n   *  is nested in. */\n  list(): readonly ViewRegistration[];\n  /** The live registration with `id`, if any. */\n  get(id: string): ViewRegistration | undefined;\n  /** The innermost view painted under a canvas-local point, whether or not it\n   *  takes input, passing over `except` and the views nested in it. */\n  viewAt(at: { x: number; y: number }, opts?: { except?: string }): ViewAt;\n  /** What view `id` shows (`null`: the surface's root), or `null` while there is no such view. */\n  aimOf(id: string | null): ViewAim | null;\n  /** Point view `id` at `aim`; `false` when it cannot. */\n  setAim(id: string | null, aim: ViewAim): boolean;\n  /** Bumped whenever the list changes. Pair with {@link ViewRegistry.subscribe}\n   *  for `useSyncExternalStore`. */\n  getVersion(): number;\n  subscribe(fn: () => void): () => void;\n  /** Which view a client point belongs to, sticky for a captured pointer.\n   *  One per surface: every caller that routes input — the dispatcher, pinch,\n   *  hover — must agree about where a point landed. */\n  readonly resolver: ViewResolver;\n  /** The hosting surface, or `null` before one attaches. */\n  surface(): SurfaceHandle | null;\n  /** Returns a detach, which leaves a handle attached since alone. */\n  attachSurface(handle: SurfaceHandle): () => void;\n}\n\nconst ViewRegistryContext = createContext<ViewRegistry | null>(null);\n\n/** Mounts the registry for one surface. `<SceneCanvas>` mounts one; a view\n *  declaring itself as a child must be inside it. */\nexport function ViewRegistryProvider({ children }: { children: ReactNode }) {\n  const entriesRef = useRef(new Map<ViewRegistration, number>());\n  const seqRef = useRef(0);\n  const versionRef = useRef(0);\n  const surfaceRef = useRef<SurfaceHandle | null>(null);\n  const markersRef = useRef(new Map<() => ViewMarkerProps, RenderLayer<unknown>>());\n\n  const registry = useMemo<ViewRegistry>(() => {\n    const listeners = createEmitter();\n    const changed = (): void => {\n      versionRef.current++;\n      listeners.emit();\n    };\n    const ordered = (): ViewRegistration[] => nestedOrder([...entriesRef.current.keys()].sort((a, b) => (\n      a.order - b.order || entriesRef.current.get(a)! - entriesRef.current.get(b)!\n    )));\n    const get = (id: string): ViewRegistration | undefined => {\n      for (const r of entriesRef.current.keys()) if (r.id === id) return r;\n      return undefined;\n    };\n    /** Whether `r` is `id` or nested in it, however deep. */\n    const within = (r: ViewRegistration, id: string): boolean => {\n      const seen = new Set<ViewRegistration>();\n      for (let at: ViewRegistration | undefined = r; at && !seen.has(at); at = at.parent === undefined ? undefined : get(at.parent)) {\n        if (at.id === id) return true;\n        seen.add(at);\n      }\n      return false;\n    };\n    const resolver = createViewResolver({\n      views: () => {\n        const surface = surfaceRef.current;\n        const view = surface?.view() ?? IDENTITY_VIEW;\n        const dims = surface?.dims() ?? UNMEASURED_DIMS;\n        return ordered().filter((r) => r.interactive).map((r) => r.layer.resolvable(view, dims));\n      },\n      root: () => surfaceRef.current?.view() ?? IDENTITY_VIEW,\n      toLocal: (clientX, clientY) => surfaceLocal(surfaceRef.current, clientX, clientY),\n      occluded: (x, y) => surfaceRef.current?.claimsAbove(x, y) ?? false,\n    });\n    const registry: ViewRegistry = {\n      resolver,\n      register: (reg) => {\n        entriesRef.current.set(reg, seqRef.current++);\n        changed();\n        return () => { entriesRef.current.delete(reg); changed(); };\n      },\n      list: ordered,\n      get,\n      viewAt: ({ x, y }, opts) => {\n        const surface = surfaceRef.current;\n        const view = surface?.view() ?? IDENTITY_VIEW;\n        const dims = surface?.dims() ?? UNMEASURED_DIMS;\n        const except = opts?.except;\n        const list = ordered();\n        for (let i = list.length - 1; i >= 0; i--) {\n          const r = list[i]!;\n          if (except !== undefined && within(r, except)) continue;\n          const v = r.layer.resolvable(view, dims);\n          if (viewContains(v, x, y)) return { id: v.id, view: v.view, rect: v.rect };\n        }\n        return { id: null, view, rect: { x: 0, y: 0, w: dims.width, h: dims.height } };\n      },\n      aimOf: (id) => {\n        if (id !== null) return get(id)?.aim() ?? null;\n        const surface = surfaceRef.current;\n        return surface ? rectAim(null, viewportWorldRect(surface.view(), surface.dims())) : null;\n      },\n      setAim: (id, aim) => {\n        if (id !== null) return get(id)?.setAim(aim) ?? false;\n        const surface = surfaceRef.current;\n        if (!isRectAim(aim) || !surface?.setView) return false;\n        surface.setView(viewForAim(aim.extent, surface.dims(), 'exact'));\n        return true;\n      },\n      ...createViewMarkerRegistry(markersRef.current, {\n        host: { aimOf: (id) => registry.aimOf(id), setAim: (id, aim) => registry.setAim(id, aim) },\n        surface: () => surfaceRef.current,\n        resolve: (id, outer, dims) => get(id)?.layer.resolvable(outer, dims),\n        changed,\n      }),\n      getVersion: () => versionRef.current,\n      subscribe: listeners.subscribe,\n      surface: () => surfaceRef.current,\n      attachSurface: (handle) => {\n        surfaceRef.current = handle;\n        return () => { if (surfaceRef.current === handle) surfaceRef.current = null; };\n      },\n    };\n    return registry;\n  }, []);\n\n  return <ViewRegistryContext.Provider value={registry}>{children}</ViewRegistryContext.Provider>;\n}\n\n/** The surface's view registry, or `null` outside one. */\nexport function useOptionalViewRegistry(): ViewRegistry | null {\n  return useContext(ViewRegistryContext);\n}\n\n/** Each view followed by the views nested in it, in the order given. A view\n *  whose parent is not registered keeps its place; one caught in a cycle\n *  goes last. */\nfunction nestedOrder(sorted: readonly ViewRegistration[]): ViewRegistration[] {\n  const ids = new Set(sorted.map((r) => r.id));\n  const out: ViewRegistration[] = [];\n  const placed = new Set<ViewRegistration>();\n  const place = (r: ViewRegistration): void => {\n    if (placed.has(r)) return;\n    placed.add(r);\n    out.push(r);\n    for (const child of sorted) if (child.parent === r.id) place(child);\n  };\n  for (const r of sorted) if (r.parent === undefined || !ids.has(r.parent)) place(r);\n  for (const r of sorted) place(r);\n  return out;\n}\n\n/** The `Dims` a surface reports before it has measured itself. */\nexport const UNMEASURED_DIMS: Dims = { width: 0, height: 0 };\n\n/** The camera a view resolves against before its surface attaches. */\nexport const IDENTITY_VIEW: View = { x: 0, y: 0, scale: { x: 1, y: 1 } };\n"],"mappings":"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"}
+{"version":3,"file":"viewRegistry.js","names":[],"sources":["../../src/canvas/viewRegistry.tsx"],"sourcesContent":["/**\n * The seam between a canvas surface and the views drawn on it.\n *\n * Traffic runs both ways: the surface attaches a handle onto its frame and its\n * layer stack, and each view registers what it contributes back — the viewport\n * node it paints into and the record the gesture dispatcher routes its events\n * to. Both sides are thunks, read at draw and dispatch time, so neither can\n * serve the other a frame that has already moved.\n */\nimport { createContext, useContext, useMemo, useRef, type ReactNode } from 'react';\nimport type { Dims, RenderLayer } from 'core/layers/render';\nimport type { LayerHit } from 'affordances/types';\nimport type { ChromeState } from 'core/selection/chromeState';\nimport type { SelectionApi } from 'core/selection/useSelection';\nimport type { View } from 'core/viewport/view';\nimport type { ViewportLayer } from 'domains/viewports/viewportLayer';\nimport type { DispatcherViewTarget } from '@weasel-js/routing/internal';\nimport { createViewResolver, viewContains, type ViewResolver } from 'domains/viewports/viewResolver';\nimport { createEmitter } from '@weasel-js/registry';\nimport { viewWorldToScreen } from '@weasel-js/geom';\nimport type { ViewAt } from './canvasExtension';\nimport { isRectAim, rectAim, viewForAim, type ViewAim } from 'domains/viewports/aim';\nimport { viewportWorldRect } from 'core/viewport/viewportWorldRect';\nimport type { ViewMarkerProps } from 'domains/viewports/viewMarker';\nimport { createViewMarkerRegistry, type ViewMarkerRegistry } from './viewMarkers';\n\n/**\n * What a view needs from the surface hosting it.\n *\n * @internal Attached by the surface, read by `<CanvasView>`.\n */\nexport interface SurfaceHandle {\n  /** A client point in the surface's own world — the conversion the surface\n   *  itself makes, its `clientToWorld` override included. */\n  clientToWorld(clientX: number, clientY: number): [number, number];\n  /** The outer camera. */\n  view(): View;\n  /** The canvas's CSS-pixel size. */\n  dims(): Dims;\n  /** The stack a view paints through its own camera, unless it narrows it. */\n  layers(): readonly RenderLayer<unknown>[];\n  requestRedraw(): void;\n  /** The canvas's own view chrome — its selection, its overlay-aware bounds.\n   *  What a `<CanvasView>` answers for itself, answered for view zero. */\n  chromeState(): ChromeState;\n  /** Hit-test the externally registered layers at a world point, against the\n   *  frame and draw envelope of whichever view is asking. The public\n   *  `hitTestExtras` is this with the canvas's own frame and envelope. */\n  hitTestExtras(\n    worldX: number,\n    worldY: number,\n    view: View,\n    dims: Dims,\n    data: unknown,\n    /** Consider only these layers — the ones the asking view paints. A layer\n     *  asked on a frame it was not drawn in answers for the wrong pixels. */\n    only?: readonly RenderLayer<unknown>[],\n  ): { layerId: string; hit: LayerHit } | null;\n  /** Whether a registered layer claims a canvas-local point on the surface's\n   *  own frame. Registered layers paint over every view, so such a point is\n   *  theirs even inside a view's rect. */\n  claimsAbove(x: number, y: number): boolean;\n  /** The root camera's input write: clamped, forwarded when controlled, and ending a glide. */\n  setView?(next: View): void;\n}\n\n/**\n * A client point in the surface's CSS pixels, from its top-left: the surface's\n * own world point put back through its camera, so a `clientToWorld` override\n * reaches every view declared on it.\n *\n * @internal\n */\nexport function surfaceLocal(\n  surface: Pick<SurfaceHandle, 'clientToWorld' | 'view'> | null,\n  clientX: number,\n  clientY: number,\n): { x: number; y: number } {\n  if (!surface) return { x: clientX, y: clientY };\n  const [worldX, worldY] = surface.clientToWorld(clientX, clientY);\n  return viewWorldToScreen(surface.view(), { x: worldX, y: worldY });\n}\n\n/**\n * What one view contributes to the surface hosting it.\n *\n * @internal Written by `<CanvasView>`, read by the surface. Consumers declare\n *   a view, not a registration.\n */\nexport interface ViewRegistration {\n  id: string;\n  /** The view this one is nested in: listed, painted and hit after it, and\n   *  its `layer` measures itself from that view's rect and camera. */\n  parent?: string;\n  /**\n   * Paint and hit order, low to high. Views declared as props take their array\n   * index; a view mounted as a child takes `Infinity`, so it lands after them\n   * however React happens to order the mount effects.\n   */\n  order: number;\n  /** The viewport node this view paints into. Its `resolvable` is what routes\n   *  input here. */\n  layer: ViewportLayer<unknown>;\n  /** `false` keeps input over the view on the canvas beneath it. */\n  interactive: boolean;\n  /** `false` leaves `layer` for a host to draw — a HUD window's interior — so\n   *  the surface does not paint it too. */\n  paint: boolean;\n  /** Everything about dispatching to this view except its id. */\n  target: Omit<DispatcherViewTarget, 'id'>;\n  /** Whether a scene layer reaches the screen in this view. For input that\n   *  reaches a view without a dispatch — hover — so it judges this view's\n   *  paint rather than the surface's. */\n  layerIsPainted(layerId: string): boolean;\n  /** The layers this view draws, in order — what a view nested in it paints\n   *  from. */\n  drawnLayers(): readonly RenderLayer<unknown>[];\n  /** The selection the view owns, or the one the view it follows owns;\n   *  `undefined` while it shares the surface's. */\n  selection(): SelectionApi | undefined;\n  /** Whether the view keeps its camera or its aim; the other is derived. */\n  held: 'camera' | 'aim';\n  /** What the view shows: the aim it holds, or its camera's. */\n  aim(): ViewAim;\n  /** `false` for an aim the view cannot read, or one with nowhere to go. */\n  setAim(aim: ViewAim): boolean;\n}\n\n\n/** @internal */\nexport interface ViewRegistry extends ViewMarkerRegistry {\n  /** Returns an unregister. */\n  register(reg: ViewRegistration): () => void;\n  /** Live registrations in paint order, each nested view after the view it\n   *  is nested in. */\n  list(): readonly ViewRegistration[];\n  /** The live registration with `id`, if any. */\n  get(id: string): ViewRegistration | undefined;\n  /** The innermost view painted under a canvas-local point, whether or not it\n   *  takes input, passing over `except` and the views nested in it. */\n  viewAt(at: { x: number; y: number }, opts?: { except?: string }): ViewAt;\n  /** What view `id` shows (`null`: the surface's root), or `null` while there is no such view. */\n  aimOf(id: string | null): ViewAim | null;\n  /** Point view `id` at `aim`; `false` when it cannot. */\n  setAim(id: string | null, aim: ViewAim): boolean;\n  /** Bumped whenever the list changes. Pair with {@link ViewRegistry.subscribe}\n   *  for `useSyncExternalStore`. */\n  getVersion(): number;\n  subscribe(fn: () => void): () => void;\n  /** Which view a client point belongs to, sticky for a captured pointer.\n   *  One per surface: every caller that routes input — the dispatcher, pinch,\n   *  hover — must agree about where a point landed. */\n  readonly resolver: ViewResolver;\n  /** The hosting surface, or `null` before one attaches. */\n  surface(): SurfaceHandle | null;\n  /** Returns a detach, which leaves a handle attached since alone. */\n  attachSurface(handle: SurfaceHandle): () => void;\n}\n\nconst ViewRegistryContext = createContext<ViewRegistry | null>(null);\n\n/** Mounts the registry for one surface. `<SceneCanvas>` mounts one; a view\n *  declaring itself as a child must be inside it. */\nexport function ViewRegistryProvider({ children }: { children: ReactNode }) {\n  const entriesRef = useRef(new Map<ViewRegistration, number>());\n  const seqRef = useRef(0);\n  const versionRef = useRef(0);\n  const surfaceRef = useRef<SurfaceHandle | null>(null);\n  const markersRef = useRef(new Map<() => ViewMarkerProps, RenderLayer<unknown>>());\n\n  const registry = useMemo<ViewRegistry>(() => {\n    const listeners = createEmitter();\n    const changed = (): void => {\n      versionRef.current++;\n      listeners.emit();\n    };\n    const ordered = (): ViewRegistration[] => nestedOrder([...entriesRef.current.keys()].sort((a, b) => (\n      a.order - b.order || entriesRef.current.get(a)! - entriesRef.current.get(b)!\n    )));\n    const get = (id: string): ViewRegistration | undefined => {\n      for (const r of entriesRef.current.keys()) if (r.id === id) return r;\n      return undefined;\n    };\n    /** Whether `r` is `id` or nested in it, however deep. */\n    const within = (r: ViewRegistration, id: string): boolean => {\n      const seen = new Set<ViewRegistration>();\n      for (let at: ViewRegistration | undefined = r; at && !seen.has(at); at = at.parent === undefined ? undefined : get(at.parent)) {\n        if (at.id === id) return true;\n        seen.add(at);\n      }\n      return false;\n    };\n    const resolver = createViewResolver({\n      views: () => {\n        const surface = surfaceRef.current;\n        const view = surface?.view() ?? IDENTITY_VIEW;\n        const dims = surface?.dims() ?? UNMEASURED_DIMS;\n        return ordered().filter((r) => r.interactive).map((r) => r.layer.resolvable(view, dims));\n      },\n      root: () => surfaceRef.current?.view() ?? IDENTITY_VIEW,\n      toLocal: (clientX, clientY) => surfaceLocal(surfaceRef.current, clientX, clientY),\n      occluded: (x, y) => surfaceRef.current?.claimsAbove(x, y) ?? false,\n    });\n    const registry: ViewRegistry = {\n      resolver,\n      register: (reg) => {\n        entriesRef.current.set(reg, seqRef.current++);\n        changed();\n        return () => { entriesRef.current.delete(reg); changed(); };\n      },\n      list: ordered,\n      get,\n      viewAt: ({ x, y }, opts) => {\n        const surface = surfaceRef.current;\n        const view = surface?.view() ?? IDENTITY_VIEW;\n        const dims = surface?.dims() ?? UNMEASURED_DIMS;\n        const except = opts?.except;\n        const list = ordered();\n        for (let i = list.length - 1; i >= 0; i--) {\n          const r = list[i]!;\n          if (except !== undefined && within(r, except)) continue;\n          const v = r.layer.resolvable(view, dims);\n          if (viewContains(v, x, y)) return { id: v.id, view: v.view, rect: v.rect };\n        }\n        return { id: null, view, rect: { x: 0, y: 0, w: dims.width, h: dims.height } };\n      },\n      aimOf: (id) => {\n        if (id !== null) return get(id)?.aim() ?? null;\n        const surface = surfaceRef.current;\n        return surface ? rectAim(null, viewportWorldRect(surface.view(), surface.dims())) : null;\n      },\n      setAim: (id, aim) => {\n        if (id !== null) return get(id)?.setAim(aim) ?? false;\n        const surface = surfaceRef.current;\n        if (!isRectAim(aim) || !surface?.setView) return false;\n        surface.setView(viewForAim(aim.extent, surface.dims(), 'exact'));\n        return true;\n      },\n      ...createViewMarkerRegistry(markersRef.current, {\n        host: { aimOf: (id) => registry.aimOf(id), setAim: (id, aim) => registry.setAim(id, aim) },\n        surface: () => surfaceRef.current,\n        resolve: (id, outer, dims) => get(id)?.layer.resolvable(outer, dims),\n        changed,\n      }),\n      getVersion: () => versionRef.current,\n      subscribe: listeners.subscribe,\n      surface: () => surfaceRef.current,\n      attachSurface: (handle) => {\n        surfaceRef.current = handle;\n        return () => { if (surfaceRef.current === handle) surfaceRef.current = null; };\n      },\n    };\n    return registry;\n  }, []);\n\n  return <ViewRegistryContext.Provider value={registry}>{children}</ViewRegistryContext.Provider>;\n}\n\n/** The surface's view registry, or `null` outside one. */\nexport function useOptionalViewRegistry(): ViewRegistry | null {\n  return useContext(ViewRegistryContext);\n}\n\n/** Each view followed by the views nested in it, in the order given. A view\n *  whose parent is not registered keeps its place; one caught in a cycle\n *  goes last. */\nfunction nestedOrder(sorted: readonly ViewRegistration[]): ViewRegistration[] {\n  const ids = new Set(sorted.map((r) => r.id));\n  const out: ViewRegistration[] = [];\n  const placed = new Set<ViewRegistration>();\n  const place = (r: ViewRegistration): void => {\n    if (placed.has(r)) return;\n    placed.add(r);\n    out.push(r);\n    for (const child of sorted) if (child.parent === r.id) place(child);\n  };\n  for (const r of sorted) if (r.parent === undefined || !ids.has(r.parent)) place(r);\n  for (const r of sorted) place(r);\n  return out;\n}\n\n/** The `Dims` a surface reports before it has measured itself. */\nexport const UNMEASURED_DIMS: Dims = { width: 0, height: 0 };\n\n/** The camera a view resolves against before its surface attaches. */\nexport const IDENTITY_VIEW: View = { x: 0, y: 0, scale: { x: 1, y: 1 } };\n"],"mappings":"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"}

package/dist/canvas/viewSnap.js

@@ -1,6 +1,6 @@
 import { sameView } from "../core/viewport/view.js";
 
-//#region src/canvas/viewSnap.ts
+// src/canvas/viewSnap.ts
 /** A move within this of a whole device pixel is one: the renderer's own slack. */
 var SLACK = 1e-4;
 /**
@@ -62,6 +62,5 @@ function whole(n) {
 	return Math.abs(n - Math.round(n)) <= SLACK;
 }
 
-//#endregion
 export { ViewSnap };
 //# sourceMappingURL=viewSnap.js.map

package/dist/canvas/watchElementMove.js

@@ -1,4 +1,4 @@
-//#region src/canvas/watchElementMove.ts
+// src/canvas/watchElementMove.ts
 /**
 * Call `onMove` when `element`'s box moves in the viewport for a reason no
 * event reports: a sibling collapsing, content loading above it. A scroll or a
@@ -76,6 +76,5 @@ function watchElementMove(element, onMove) {
 	return stop;
 }
 
-//#endregion
 export { watchElementMove };
 //# sourceMappingURL=watchElementMove.js.map

package/dist/canvas/wrapNodeOutput.js

@@ -1,7 +1,7 @@
 import { wrapWithPoseRotation } from "./poseRotation.js";
 import { overChildren, splitOverChildren } from "./overChildren.js";
 
-//#region src/canvas/wrapNodeOutput.ts
+// src/canvas/wrapNodeOutput.ts
 /** Rotate `cmds` about the pose's AABB center and multiply by `alpha`.
 *  Both wraps are skipped when they would be no-ops (zero/absent rotation,
 *  alpha exactly 1, empty command list), so an upright opaque node emits the
@@ -21,6 +21,5 @@ function wrapPart(cmds, pose, alpha) {
 	return rotated;
 }
 
-//#endregion
 export { wrapNodeOutput };
 //# sourceMappingURL=wrapNodeOutput.js.map

package/dist/core/adapters/testing/rootsTree.js

@@ -1,4 +1,4 @@
-//#region src/core/adapters/testing/rootsTree.ts
+// src/core/adapters/testing/rootsTree.ts
 /** The tree of a fake adapter whose nodes never nest: every id in `order` is a root, bottom
 *  first. `setChildOrder` rewrites `order` in place. */
 function rootsTree(order = [], nodeOf = () => void 0) {
@@ -12,6 +12,5 @@ function rootsTree(order = [], nodeOf = () => void 0) {
 	};
 }
 
-//#endregion
 export { rootsTree };
 //# sourceMappingURL=rootsTree.js.map

package/dist/core/applyOps.js

@@ -1,4 +1,4 @@
-//#region src/core/applyOps.ts
+// src/core/applyOps.ts
 /**
 * Default `applyOps` implementation: apply each op in order against
 * `adapter`. Used by hooks when an adapter omits `applyOps`. Apps that
@@ -23,6 +23,5 @@ function dispatchApplyBatch(adapter, ops, label) {
 	else applyOpsTo(adapter, ops, label);
 }
 
-//#endregion
 export { applyOpsTo, dispatchApplyBatch };
 //# sourceMappingURL=applyOps.js.map

package/dist/core/device/targets.js

@@ -1,4 +1,4 @@
-//#region src/core/device/targets.ts
+// src/core/device/targets.ts
 /**
 * Base sizes for grabbable chrome, in CSS pixels at `targetScale = 1`, and the
 * one accessor that resolves them for a live pointer type.
@@ -33,6 +33,5 @@ function targetSizesPx(targetScale = 1, base = {}) {
 	};
 }
 
-//#endregion
 export { ANCHOR_HIT_BASE_PX, HANDLE_BASE_PX, ROTATION_HANDLE_BASE_PX, targetSizesPx };
 //# sourceMappingURL=targets.js.map

package/dist/core/device/useDeviceProfile.js

@@ -2,7 +2,7 @@ import { watchDevicePixelRatio } from "./watchDevicePixelRatio.js";
 import { createContext, createElement, useContext, useEffect, useMemo, useState } from "react";
 import { DEFAULT_DEVICE_PROFILE, resolveDeviceProfile } from "@weasel-js/routing";
 
-//#region src/core/device/useDeviceProfile.ts
+// src/core/device/useDeviceProfile.ts
 var COARSE_QUERY = "(pointer: coarse)";
 var HOVER_QUERY = "(hover: hover)";
 function hasMatchMedia() {
@@ -98,6 +98,5 @@ function DeviceProfileProvider({ value, children }) {
 	return createElement(DeviceProfileContext.Provider, { value: profile }, children);
 }
 
-//#endregion
 export { DeviceProfileProvider, useDeviceProfile };
 //# sourceMappingURL=useDeviceProfile.js.map

package/dist/core/device/useTargetBasePx.js

@@ -1,7 +1,7 @@
 import { useMemo } from "react";
 import { useKitSetting } from "@weasel-js/react";
 
-//#region src/core/device/useTargetBasePx.ts
+// src/core/device/useTargetBasePx.ts
 /** The unscaled chrome sizes the `targets` kit settings give, for `targetSizesPx`'s `base`. */
 function useTargetBasePx() {
 	const handle = useKitSetting("targets.handlePx");
@@ -18,6 +18,5 @@ function useTargetBasePx() {
 	]);
 }
 
-//#endregion
 export { useTargetBasePx };
 //# sourceMappingURL=useTargetBasePx.js.map

package/dist/core/device/watchDevicePixelRatio.js

@@ -1,4 +1,4 @@
-//#region src/core/device/watchDevicePixelRatio.ts
+// src/core/device/watchDevicePixelRatio.ts
 /**
 * Call `onChange` each time `window.devicePixelRatio` changes: the window
 * moved to a display of another density, or the page zoomed. Returns the
@@ -29,6 +29,5 @@ function watchDevicePixelRatio(onChange) {
 	};
 }
 
-//#endregion
 export { watchDevicePixelRatio };
 //# sourceMappingURL=watchDevicePixelRatio.js.map

package/dist/core/geometry/autoPoseDescriptor.js

@@ -1,7 +1,7 @@
-import { RECT_POSE_DESCRIPTOR } from "./poseDescriptor.js";
 import { pathPoseDescriptor } from "./pathPoseDescriptor.js";
+import { RECT_POSE_DESCRIPTOR } from "./poseDescriptor.js";
 
-//#region src/core/geometry/autoPoseDescriptor.ts
+// src/core/geometry/autoPoseDescriptor.ts
 /** True for Path-shaped poses (`{kind: 'polygon' | 'rect'}`). Useful for
 *  callers that need to fork between `pathPoseDescriptor` and
 *  `RECT_POSE_DESCRIPTOR` without forcing the consumer to wire
@@ -41,6 +41,5 @@ var AUTO_POSE_DESCRIPTOR = {
 	}
 };
 
-//#endregion
 export { AUTO_POSE_DESCRIPTOR, isPathLike, isRectPose };
 //# sourceMappingURL=autoPoseDescriptor.js.map

package/dist/core/geometry/booleanOfPaths.js

@@ -1,6 +1,6 @@
 import { pathExclude, pathIntersect, pathSubtract, pathUnion } from "@weasel-js/geom/booleans";
 
-//#region src/core/geometry/booleanOfPaths.ts
+// src/core/geometry/booleanOfPaths.ts
 /**
 * `op` over `paths`, given back to front, as one path. Subtract is
 * Illustrator's "Minus Front": the backmost less everything in front of it.
@@ -18,6 +18,5 @@ function booleanOfPaths(op, paths) {
 	}
 }
 
-//#endregion
 export { booleanOfPaths };
 //# sourceMappingURL=booleanOfPaths.js.map

package/dist/core/geometry/inkExtents.js

@@ -1,6 +1,6 @@
 import { localToWorld, targetTransformOf } from "./targetFrame.js";
 
-//#region src/core/geometry/inkExtents.ts
+// src/core/geometry/inkExtents.ts
 var NO_INK_EXTENTS = Object.freeze({
 	left: 0,
 	top: 0,
@@ -55,6 +55,5 @@ function insetBox(box, e) {
 	});
 }
 
-//#endregion
 export { NO_INK_EXTENTS, inkExtentsBetween, insetBox, isNoInkExtents, outsetBox };
 //# sourceMappingURL=inkExtents.js.map

package/dist/core/geometry/pathPoseDescriptor.js

@@ -1,6 +1,6 @@
 import { boundsOfPath, boxToBox, coordsFrom, lerpCorners, transformPath, translatePath, worldCoords } from "@weasel-js/geom";
 
-//#region src/core/geometry/pathPoseDescriptor.ts
+// src/core/geometry/pathPoseDescriptor.ts
 /**
 * `PoseDescriptor` for `Path` poses — wires `useResize` to operate
 * on `Path` directly. `getBounds` defers to the same `boundsOfPath` kernel
@@ -111,6 +111,5 @@ var pathPoseDescriptor = {
 	supportsRotation: () => false
 };
 
-//#endregion
 export { pathPoseDescriptor };
 //# sourceMappingURL=pathPoseDescriptor.js.map

package/dist/core/geometry/poseDescriptor.js

@@ -1,7 +1,7 @@
 import { axisAlignedBounds } from "./unionBounds.js";
 import { multiply, poseLinearOf, rotate } from "@weasel-js/geom";
 
-//#region src/core/geometry/poseDescriptor.ts
+// src/core/geometry/poseDescriptor.ts
 /** A world `lead` expressed in the frame whose world pose is `frameWorld`, for a
 *  pose stored there; `null` is the root frame, where it is unchanged. */
 function leadUnder(pc, frameWorld, lead) {
@@ -235,6 +235,5 @@ function translatePoseViaDescriptor(pose, dx, dy, geometry, lead) {
 	return geometry.remapBounds(pose, src, dst);
 }
 
-//#endregion
 export { RECT_POSE_DESCRIPTOR, ROTATED_POSE_DESCRIPTOR, framedBounds, leadUnder, poseDescriptorForNode, remapRotatedLeaf, translatePoseViaDescriptor, visualBoundsViaDescriptor };
 //# sourceMappingURL=poseDescriptor.js.map

package/dist/core/geometry/regionHit.js

@@ -2,7 +2,7 @@ import { nodeMemo } from "../scene/nodeMemo.js";
 import { visualBoundsViaDescriptor } from "./poseDescriptor.js";
 import { boxContainsBox, pathThroughPoseFrame, pointInPolygon, polygonContainsPath, polygonIntersectsPath, poseFrameOf } from "@weasel-js/geom";
 
-//#region src/core/geometry/regionHit.ts
+// src/core/geometry/regionHit.ts
 /**
 * Whether a marquee or a lasso takes one node: the per-node decision the
 * scene's area walk (`canvas/deps/hitTestArea`) makes.
@@ -161,6 +161,5 @@ function regionTakes(region, mode, pose, b, outline, filled = () => true) {
 	return polygonIntersectsPath(region.verts, drawn);
 }
 
-//#endregion
 export { isSilhouettePose, polygonRegion, poseOutline, rectRegion, regionBoundsOf, regionOf, regionTakes, regionTakesByBounds };
 //# sourceMappingURL=regionHit.js.map

package/dist/core/geometry/targetFrame.js

@@ -1,6 +1,6 @@
 import { applyToPoint, invert, poseFrameOf, pxExtentInFrame } from "@weasel-js/geom";
 
-//#region src/core/geometry/targetFrame.ts
+// src/core/geometry/targetFrame.ts
 /**
 * The frame selection chrome reads a target in: `poseFrameOf` over the
 * target's bounds, with the helpers the outline, the handles, their hit
@@ -102,6 +102,5 @@ function targetCorners(b, xf) {
 	];
 }
 
-//#endregion
 export { IDENTITY_TARGET, angleOf, isRigid, localToWorld, normalToWorld, pxExtentIn, targetCorners, targetTransformOf, worldDeltaToLocal, worldToLocal };
 //# sourceMappingURL=targetFrame.js.map

package/dist/core/geometry/unionBounds.js

@@ -1,6 +1,6 @@
 import { applyToPoint, poseFrameOf } from "@weasel-js/geom";
 
-//#region src/core/geometry/unionBounds.ts
+// src/core/geometry/unionBounds.ts
 /**
 * Union math over rect-shaped poses.
 *
@@ -111,6 +111,5 @@ function unionAABB(parts) {
 	};
 }
 
-//#endregion
 export { axisAlignedBounds, unionAABB, unionBounds };
 //# sourceMappingURL=unionBounds.js.map

package/dist/core/layers/backgroundFill.js

@@ -1,6 +1,6 @@
 import { commandPaint } from "@weasel-js/renderer";
 
-//#region src/core/layers/backgroundFill.ts
+// src/core/layers/backgroundFill.ts
 /** The id of the layer {@link createBackgroundFillLayer} builds. */
 var BACKGROUND_FILL_LAYER_ID = "scene-background-fill";
 /**
@@ -34,6 +34,5 @@ function createBackgroundFillLayer(paint) {
 	};
 }
 
-//#endregion
 export { BACKGROUND_FILL_LAYER_ID, backgroundFillCommands, createBackgroundFillLayer };
 //# sourceMappingURL=backgroundFill.js.map

package/dist/core/layers/children.js

@@ -1,4 +1,4 @@
-//#region src/core/layers/children.ts
+// src/core/layers/children.ts
 /** Build a `RenderLayer` that draws an `OrderedAdapter`'s children in z-order. */
 function createChildrenLayer(opts) {
 	return {
@@ -19,6 +19,5 @@ function createChildrenLayer(opts) {
 	};
 }
 
-//#endregion
 export { createChildrenLayer };
 //# sourceMappingURL=children.js.map

package/dist/core/layers/gateLayer.js

@@ -1,6 +1,6 @@
 import { subscribeToSources } from "./redrawSource.js";
 
-//#region src/core/layers/gateLayer.ts
+// src/core/layers/gateLayer.ts
 /**
 * `RenderLayer` wrapper that conditionally emits draw commands based on a
 * predicate.
@@ -23,6 +23,5 @@ function gateLayer(opts) {
 	return wrapped;
 }
 
-//#endregion
 export { gateLayer };
 //# sourceMappingURL=gateLayer.js.map