@weasel-js/core 1.12.0 → 1.13.0

package/dist/{depSchema-mG19aEdD.d.ts → depSchema-CpIQzKWQ.d.ts}

@@ -1,5 +1,5 @@
 import * as _weasel_js_paint from '@weasel-js/paint';
-import { TileKind, Paint, GradStop, TilePaint, PaintedFill, PaintedStroke, Inherit, Fill, Stroke, CommandFill, CommandStroke, CommandPaint } from '@weasel-js/paint';
+import { TileKind, Paint, GradStop, TilePaint, Fill, Stroke, Inherit, CommandFill, CommandStroke, CommandPaint } from '@weasel-js/paint';
 import { Reflection } from '@weasel-js/registry';
 import { ComponentType } from 'react';
 import { IconRef } from '@weasel-js/icons';
@@ -7,18 +7,18 @@ import { PaintDrawKind, DrawCommand, Effect, CompositeOp, BlendFactors } from '@
 import * as _weasel_js_routing_react from '@weasel-js/routing/react';
 import * as _weasel_js_geom from '@weasel-js/geom';
 import { FramedBox, View, Path, Affine, Rect, Scale2, PolygonPath, PathFillRule, AnchorSet, PointOrigin } from '@weasel-js/geom';
+import { I as InheritedPaint, S as Scene, R as RectPose } from './types-BEdRIhNc.js';
 import { Op, History } from '@weasel-js/history';
 import { NodeId, ModifierState, OverlayRole, ResizeAnchor, ActionDeps, OngoingHandle, OngoingOverlay, SelectionApi, IngestItem, Point2, DragSample, DebugSink, LongPressState } from '@weasel-js/routing';
 import { TextNodeSource, TextOutlinesError, TextStyle, StyledRun, TextVerticalAlign } from '@weasel-js/text';
 import { CursorSpec } from '@weasel-js/cursor';
 import { ClaimableGesture } from '@weasel-js/gestures';
 import { SnapTier, ProbeRole } from '@weasel-js/geom/nd';
-import { S as Scene, R as RectPose } from './types-CniVctmk.js';
-import { a as PlaneMap, L as LayoutStrategy, b as LayoutDropTargetMode, R as ReflowTransition } from './types-7puAuVD2.js';
+import { a as PlaneMap, L as LayoutStrategy, b as LayoutDropTargetMode, R as ReflowTransition } from './types-49uYJN3j.js';
 import { O as OriginProjection } from './originProjection-gY0jb4Wb.js';
 import { EasingSpec, InterpolatorFactory, Target, Animator, TargetAxes } from '@weasel-js/animator';
-import { I as InsertAdapter, P as PasteOmission, R as RegionPickView } from './types-oFeQ5VjV.js';
-import { B as BoundsConstraint } from './clone-C3e0OTuF.js';
+import { I as InsertAdapter, P as PasteOmission, R as RegionPickView } from './types-p2alu-R1.js';
+import { B as BoundsConstraint } from './clone-qb2e1F5p.js';
 import { P as PoseDescriptor } from './poseDescriptor-DN2yfnq_.js';
 
 /** Pixel dimensions of the canvas viewport. */
@@ -201,53 +201,6 @@ declare function paintKindOf(fill: Paint): PaintKindEntry | undefined;
 /** @internal Test helper — do not call from product code. */
 declare function _resetPaintKindsForTests(): void;
 
-/**
- * What a node's `'inherit'` fill and stroke resolve to: its nearest enclosing
- * container's, `null` for none. A field the node does not inherit is `null`
- * here whatever its containers hold.
- */
-interface InheritedPaint {
-    readonly fill: PaintedFill | null;
-    readonly stroke: PaintedStroke | null;
-}
-/** Whether `node`'s fill or stroke is {@link INHERIT}, so painting it needs
- *  its containers' paint. */
-declare function inheritsPaint(node: {
-    data?: unknown;
-}): boolean;
-/**
- * {@link InheritedPaint} for `node`, given its ancestors innermost first. Only
- * containers are sources; one whose own field is `'inherit'` passes the
- * question on to the next, and running out of containers is none.
- *
- * Hands back the object it returned last time for `node` while both values
- * are the same references, so a memo can key on it.
- */
-declare function inheritedPaintOf(node: {
-    data?: unknown;
-}, ancestors: Iterable<{
-    kind?: string;
-    data?: unknown;
-}>): InheritedPaint;
-/** The fields {@link withInheritedPaint} resolves. */
-type ResolvedPaintFields<T> = Omit<T, 'fill' | 'stroke'> & {
-    fill?: Exclude<T extends {
-        fill?: infer F;
-    } ? F : never, Inherit>;
-    stroke?: Exclude<T extends {
-        stroke?: infer S;
-    } ? S : never, Inherit>;
-};
-/**
- * `data` with an `'inherit'` fill or stroke replaced by what `inherited` says
- * it resolves to, for a reader that wants the paint a node shows rather than
- * the one it declares. Hands `data` back as is when nothing inherits.
- */
-declare function withInheritedPaint<T extends {
-    fill?: unknown;
-    stroke?: unknown;
-}>(data: T, inherited: InheritedPaint | undefined): ResolvedPaintFields<T>;
-
 /** The paint a path node wears, resolved: what an action that turns ink into
  *  geometry reads from a node and tells a consumer to put on a result. */
 interface PathPaint {
@@ -794,7 +747,7 @@ interface LayerHit<TScratch = unknown> extends AffordanceBinding<TScratch> {
  * separated in the render order is drawn as one bracket per run, with a
  * warning.
  *
- * This is a render-stack bracket, not a scene `ContainerNode`.
+ * This is a render-stack bracket, not a scene `GroupNode`.
  */
 interface LayerGroup {
     /** Names the group in warnings; not a layer id and never drawn. */
@@ -852,11 +805,17 @@ declare function subscribeToSources(sources: readonly {
     subscribe?: RedrawSource['subscribe'];
 }[])): RedrawSource['subscribe'];
 
-/** Canvas size in CSS pixels, so layers don't have to know about DPR. */
+/** Canvas size in CSS pixels. */
 interface Dims {
     width: number;
     height: number;
 }
+/** What a layer draws into: its size, and the device pixels to the CSS pixel
+ *  the frame is painted at, which is what an effect's reach is measured in. */
+interface LayerDims extends Dims {
+    dpr: number;
+}
+
 /**
  * What a layer's `draw` threw, and which layer threw it. A throw that escaped
  * the frame loop would take the whole frame with it, every other layer
@@ -893,7 +852,7 @@ interface RenderLayer<TData> {
      * Emit a DrawCommand tree, in the coordinates `space` names. A world-space
      * layer must NOT apply the view transform itself.
      */
-    draw: (data: TData, view: View, dims: Dims) => DrawCommand[];
+    draw: (data: TData, view: View, dims: LayerDims) => DrawCommand[];
     /**
      * Optional cache key. When present and a `LayerCommandCache` is supplied to
      * `drawLayers`, the layer's previous `DrawCommand[]` is reused as long as
@@ -908,7 +867,7 @@ interface RenderLayer<TData> {
      * the way world-space layers are** (see `space` below) — include them in
      * `deps` if `draw` reads them.
      */
-    deps?: (data: TData, view: View, dims: Dims) => readonly unknown[];
+    deps?: (data: TData, view: View, dims: LayerDims) => readonly unknown[];
     /** Whether the layer is shown when no explicit visibility entry exists.
      *  Defaults to `true` when absent. */
     defaultVisible?: boolean;
@@ -995,7 +954,7 @@ interface LayerDrawSpan {
  * layer drawn. `retain` decides which unchanged layers the renderer keeps
  * as pixels between frames; `false` keeps none.
  */
-declare function drawLayers<TData>(layers: RenderLayer<TData>[], data: TData, visibility: Record<string, boolean>, order: string[] | undefined, view: View | undefined, dims: Dims, cache?: LayerCommandCache, onLayerError?: (failure: LayerDrawFailure) => void, groups?: readonly LayerGroup[], spans?: LayerDrawSpan[], retain?: LayerRetainPolicy | false): DrawCommand[];
+declare function drawLayers<TData>(layers: RenderLayer<TData>[], data: TData, visibility: Record<string, boolean>, order: string[] | undefined, view: View | undefined, dims: LayerDims, cache?: LayerCommandCache, onLayerError?: (failure: LayerDrawFailure) => void, groups?: readonly LayerGroup[], spans?: LayerDrawSpan[], retain?: LayerRetainPolicy | false): DrawCommand[];
 /**
  * Resolve one layer's visibility: `alwaysOn` wins, then an explicit entry in
  * `visibility`, then `defaultVisible`, defaulting to shown.
@@ -1027,7 +986,7 @@ declare function paintedLayers<TData>(layers: readonly RenderLayer<TData>[], vis
  * layer it was. The layer's cache entry goes with it, so the next frame is a
  * real re-attempt.
  */
-declare function drawOneLayer<TData>(layer: RenderLayer<TData>, data: TData, view: View, dims: Dims, cache?: LayerCommandCache, onLayerError?: (failure: LayerDrawFailure) => void): DrawCommand[];
+declare function drawOneLayer<TData>(layer: RenderLayer<TData>, data: TData, view: View, dims: LayerDims, cache?: LayerCommandCache, onLayerError?: (failure: LayerDrawFailure) => void): DrawCommand[];
 /** Whether `b` matches `a` entry for entry under `Object.is` — how
  *  `RenderLayer.deps` is compared, and any cache keyed the same way. */
 declare function depsUnchanged(a: readonly unknown[], b: readonly unknown[]): boolean;
@@ -2160,6 +2119,22 @@ interface EditAnchorsDep {
     setSelectedMark?(mark: PathEditMark | null): void;
 }
 
+/** The group a press resolves inside of, held beside the selection; `<SceneCanvas enteredGroup>` takes one. */
+interface EnteredGroupApi {
+    get(): NodeId | null;
+    enter(id: NodeId): void;
+    /** Moves to the nearest group above the current one, or to none. */
+    leave(): void;
+    /** Leaves every entered group at once. */
+    leaveAll(): void;
+    subscribe(fn: () => void): () => void;
+}
+type SceneReads = Pick<Scene<unknown, string, unknown>, 'get' | 'ancestorsOf' | 'subscribe'>;
+/** An entered-group store over `scene`, with nothing entered. */
+declare function createEnteredGroup(scene: SceneReads): EnteredGroupApi;
+/** One entered-group store for the life of the scene. */
+declare function useEnteredGroup(scene: SceneReads): EnteredGroupApi;
+
 /** Context handed to every content handler for one ingest event. */
 interface IngestCtx {
     /** World-space arrival point (drop / pointed imperative ingest); `null`
@@ -2672,6 +2647,10 @@ declare module '@weasel-js/routing' {
     interface DepSchema {
         /** Kit selection state — ids of currently selected nodes. */
         selection: SelectionApi;
+        /** The group the user has entered, or null — session state beside the
+         *  selection, not scene data and not undoable. Optional: absent means
+         *  inside no group. */
+        enteredGroup?: EnteredGroupApi;
         /** Current viewport — camera position + scale. */
         view: ViewApi;
         /**
@@ -2848,4 +2827,4 @@ declare module '@weasel-js/routing' {
     }
 }
 
-export { type SnapProbeAt as $, type AnchorMarkerShape as A, type PaintKindEntry as B, type ContentHandlerEntry as C, type Dims as D, type EditAnchorsDep as E, type FitViewToBoundsOptions as F, type GestureLifecycleOptions as G, type HandleLocks as H, type InheritedPaint as I, type PathEditTarget as J, type FinishedEditFrame as K, type LayerHit as L, type PathSymmetryDep as M, type BooleanOpOptions as N, type BooleansAdapter as O, type PathEditMark as P, type BooleanOp as Q, type RenderLayer as R, type SnapSource as S, type TransformFollower as T, type PathPaint as U, type ViewAnimationOptions as V, type BooleanOpResult as W, type BooleanStrokes as X, type SnapMods as Y, type SourceCandidate as Z, _resetPaintKindsForTests as _, type PathEditExtension as a, type SnapEdge as a$, type SnapCollect as a0, type SnapMark as a1, type SnapDep as a2, type SnapOutcome as a3, type SnapReadoutStyle as a4, type AngleCandidate as a5, type AngleCollect as a6, type AnimateToBoundsOptions as a7, type AreaSelectDep as a8, type BooleanOpPreview as a9, type MinSize as aA, type NodeAtPointDep as aB, type OutlinePathSpec as aC, PATH_OVERLAY_ROLES as aD, type PaintKind as aE, type PaintKindEditorProps as aF, type PaintKindFamily as aG, type PaintKindLoader as aH, type PanBounds as aI, type PathEditDrag as aJ, type PathEditDragStart as aK, type PathEditFinishCtx as aL, type PathEditHandleMove as aM, type PathEditMarksCtx as aN, type PathEditOther as aO, type PathEditPart as aP, type PathEditStore as aQ, type PathForm as aR, type PathOverlay as aS, type PathOverlayOptions as aT, type PathOverlayStyle as aU, type PathRepresentation as aV, type PathTransformFinishCtx as aW, type PreviewPathsDep as aX, type ResizePolicy as aY, STICKY_DEFAULTS as aZ, type SnapBegin as a_, type BooleanPreviewPiece as aa, type CanDropIntoDep as ab, type ClipboardDep as ac, type ClipboardIngestCtx as ad, type CreateOutlinesResult as ae, type CustomPaintContext as af, DEFAULT_LAYER_RETAIN as ag, type DecayLoopConfig as ah, type FinishedPathEdit as ai, GEOMETRY_BOUND_DATA as aj, type HandleLock as ak, type HitTestView as al, type IngestCtx as am, type IngestionDep as an, type InsertDep as ao, type InsertEnds as ap, type InsertExtras as aq, type InsertIntoDep as ar, type InsertLive as as, type LassoSelectDep as at, type LayerCommandCache as au, type LayerDrawFailure as av, type LayerDrawSpan as aw, type LayerRetainPolicy as ax, type LayoutDep as ay, type Locus as az, type SnapGesture as b, type SnapEdges as b0, type SnapMarks as b1, type SnapReadoutDep as b2, type SvgUnpacker as b3, type TextEditDep as b4, type TextNodeData as b5, type TransformPreviewNode as b6, type TransientPath as b7, VIEW_ANIMATION_KEY as b8, type ViewAnimationApi as b9, previewBooleanOp as bA, registerContentHandler as bB, registerPaintKind as bC, registerPaintKindLoader as bD, seedTile as bE, stickyData as bF, stickyNodeFactory as bG, subscribeToSources as bH, switchGradientKind as bI, textBoxOf as bJ, useDecayLoop as bK, useViewAnimation as bL, useViewAnimationOn as bM, viewAxes as bN, withInheritedPaint as bO, withoutGeometryBoundData as bP, type ViewApi as ba, type ViewChannel as bb, applyBooleanOp as bc, applyCreateOutlines as bd, asPaint as be, createPathOverlay as bf, createSnapOutcomeStore as bg, depsUnchanged as bh, drawLayers as bi, drawOneLayer as bj, fitViewToBounds as bk, getPaintKind as bl, inheritedPaintOf as bm, inheritsPaint as bn, isLayerPainted as bo, isLayerVisible as bp, listGradientKinds as bq, listPaintKinds as br, minSizeOf as bs, paintKindOf as bt, paintKindRegistry as bu, paintedLayers as bv, paintsLayer as bw, paletteInsertPaint as bx, pathPaintOf as by, patternFamily as bz, type SnapConstrain as c, type SnapResizeBox as d, type SnapGeometry as e, type SnapOutcomeStore as f, type SnapSession as g, type ViewportDims as h, type RedrawSource as i, type EditAnchorsParams as j, type InertiaConfig as k, type SliceDep as l, type StickyStyle as m, type ChromeState as n, type LayerGroup as o, type GeometryProjection as p, type InsertNodeFactory as q, type InsertPaint as r, type SvgIngestOptions as s, type SceneCanvasSnap as t, type Affordance as u, type AffordanceRegion as v, type AffordanceBinding as w, type CommonAffordanceScratch as x, type TextOverflow as y, type CreateOutlinesAdapter as z };
+export { type SourceCandidate as $, type AnchorMarkerShape as A, type CreateOutlinesAdapter as B, type ContentHandlerEntry as C, type Dims as D, type EditAnchorsDep as E, type FitViewToBoundsOptions as F, type GestureLifecycleOptions as G, type HandleLocks as H, type InertiaConfig as I, type PaintKindEntry as J, type PathEditTarget as K, type LayerHit as L, type FinishedEditFrame as M, type PathSymmetryDep as N, type BooleanOpOptions as O, type PathEditMark as P, type BooleansAdapter as Q, type RenderLayer as R, type SnapSource as S, type TransformFollower as T, type BooleanOp as U, type ViewAnimationOptions as V, type PathPaint as W, type BooleanOpResult as X, type BooleanStrokes as Y, type SnapMods as Z, _resetPaintKindsForTests as _, type PathEditExtension as a, type SnapBegin as a$, type SnapProbeAt as a0, type SnapCollect as a1, type SnapMark as a2, type SnapDep as a3, type SnapOutcome as a4, type SnapReadoutStyle as a5, type AngleCandidate as a6, type AngleCollect as a7, type AnimateToBoundsOptions as a8, type AreaSelectDep as a9, type Locus as aA, type MinSize as aB, type NodeAtPointDep as aC, type OutlinePathSpec as aD, PATH_OVERLAY_ROLES as aE, type PaintKind as aF, type PaintKindEditorProps as aG, type PaintKindFamily as aH, type PaintKindLoader as aI, type PanBounds as aJ, type PathEditDrag as aK, type PathEditDragStart as aL, type PathEditFinishCtx as aM, type PathEditHandleMove as aN, type PathEditMarksCtx as aO, type PathEditOther as aP, type PathEditPart as aQ, type PathEditStore as aR, type PathForm as aS, type PathOverlay as aT, type PathOverlayOptions as aU, type PathOverlayStyle as aV, type PathRepresentation as aW, type PathTransformFinishCtx as aX, type PreviewPathsDep as aY, type ResizePolicy as aZ, STICKY_DEFAULTS as a_, type BooleanOpPreview as aa, type BooleanPreviewPiece as ab, type CanDropIntoDep as ac, type ClipboardDep as ad, type ClipboardIngestCtx as ae, type CreateOutlinesResult as af, type CustomPaintContext as ag, DEFAULT_LAYER_RETAIN as ah, type DecayLoopConfig as ai, type FinishedPathEdit as aj, GEOMETRY_BOUND_DATA as ak, type HandleLock as al, type HitTestView as am, type IngestCtx as an, type IngestionDep as ao, type InsertDep as ap, type InsertEnds as aq, type InsertExtras as ar, type InsertIntoDep as as, type InsertLive as at, type LassoSelectDep as au, type LayerCommandCache as av, type LayerDrawFailure as aw, type LayerDrawSpan as ax, type LayerRetainPolicy as ay, type LayoutDep as az, type SnapGesture as b, type SnapEdge as b0, type SnapEdges as b1, type SnapMarks as b2, type SnapReadoutDep as b3, type SvgUnpacker as b4, type TextEditDep as b5, type TextNodeData as b6, type TransformPreviewNode as b7, type TransientPath as b8, VIEW_ANIMATION_KEY as b9, previewBooleanOp as bA, registerContentHandler as bB, registerPaintKind as bC, registerPaintKindLoader as bD, seedTile as bE, stickyData as bF, stickyNodeFactory as bG, subscribeToSources as bH, switchGradientKind as bI, textBoxOf as bJ, useDecayLoop as bK, useEnteredGroup as bL, useViewAnimation as bM, useViewAnimationOn as bN, viewAxes as bO, withoutGeometryBoundData as bP, type ViewAnimationApi as ba, type ViewApi as bb, type ViewChannel as bc, applyBooleanOp as bd, applyCreateOutlines as be, asPaint as bf, createEnteredGroup as bg, createPathOverlay as bh, createSnapOutcomeStore as bi, depsUnchanged as bj, drawLayers as bk, drawOneLayer as bl, fitViewToBounds as bm, getPaintKind as bn, isLayerPainted as bo, isLayerVisible as bp, listGradientKinds as bq, listPaintKinds as br, minSizeOf as bs, paintKindOf as bt, paintKindRegistry as bu, paintedLayers as bv, paintsLayer as bw, paletteInsertPaint as bx, pathPaintOf as by, patternFamily as bz, type SnapConstrain as c, type SnapResizeBox as d, type SnapGeometry as e, type SnapOutcomeStore as f, type SnapSession as g, type LayerDims as h, type ViewportDims as i, type RedrawSource as j, type EditAnchorsParams as k, type SliceDep as l, type StickyStyle as m, type EnteredGroupApi as n, type ChromeState as o, type LayerGroup as p, type GeometryProjection as q, type InsertNodeFactory as r, type InsertPaint as s, type SvgIngestOptions as t, type SceneCanvasSnap as u, type Affordance as v, type AffordanceRegion as w, type AffordanceBinding as x, type CommonAffordanceScratch as y, type TextOverflow as z };

package/dist/devtools/handlers.js

@@ -12,7 +12,7 @@ function summaryOf(node) {
 		id: node.id,
 		kind: node.kind,
 		layer: node.layer,
-		childCount: node.kind === "container" ? node.children.length : 0,
+		childCount: node.children?.length ?? 0,
 		hidden: node.hidden === true,
 		locked: node.locked === true,
 		pickable: node.pickable !== false

package/dist/devtools/handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.js","names":[],"sources":["../../src/devtools/handlers.ts"],"sourcesContent":["/** The answer to each devtools request, for one root. The session owns the override a steering request changes. */\nimport type { Node, NodeId, Scene } from 'core/scene/types';\nimport type { DebugConfig } from '../debug/types';\nimport type { DevtoolsRoot } from './root';\nimport type {\n  DevtoolsNodeDetail, DevtoolsNodeSummary, DevtoolsOverlays, DevtoolsRequest, DevtoolsResult,\n  DevtoolsRootState, DevtoolsTraceSlice,\n} from './protocol';\nimport { serialize } from './serialize';\nimport { historySlice } from './history';\n\ntype AnyScene = Scene<unknown, string, unknown>;\ntype AnyNode = Node<unknown, string, unknown>;\n\nfunction sceneOf(root: DevtoolsRoot): AnyScene {\n  const scene = root.source.scene();\n  if (!scene) throw new Error('scene not mounted yet');\n  return scene;\n}\n\nfunction summaryOf(node: AnyNode): DevtoolsNodeSummary {\n  return {\n    id: node.id,\n    kind: node.kind,\n    layer: node.layer,\n    childCount: node.kind === 'container' ? node.children.length : 0,\n    hidden: node.hidden === true,\n    locked: node.locked === true,\n    pickable: node.pickable !== false,\n  };\n}\n\nfunction nodeOf(scene: AnyScene, id: string): AnyNode {\n  const node = scene.get(id as NodeId);\n  if (!node) throw new Error(`no node \"${id}\"`);\n  return node;\n}\n\nexport function childrenOf(root: DevtoolsRoot, nodeId: string | undefined): DevtoolsNodeSummary[] {\n  const scene = sceneOf(root);\n  const ids = nodeId === undefined ? scene.roots : (nodeOf(scene, nodeId), scene.childrenOf(nodeId as NodeId));\n  return ids.map((id) => summaryOf(nodeOf(scene, id)));\n}\n\nexport function nodeDetail(root: DevtoolsRoot, nodeId: string): DevtoolsNodeDetail {\n  const node = nodeOf(sceneOf(root), nodeId);\n  return {\n    ...summaryOf(node),\n    parent: node.parent ?? null,\n    pose: serialize(node.pose),\n    data: serialize(node.data),\n  };\n}\n\n/** The on/off features of a debug config, leaving out its theme and strokes. */\nexport function overlayFlags(config: DebugConfig | null): DevtoolsOverlays {\n  const flags: DevtoolsOverlays = {};\n  if (!config) return flags;\n  for (const [key, value] of Object.entries(config)) {\n    if (typeof value === 'boolean') (flags as Record<string, boolean>)[key] = value;\n  }\n  return flags;\n}\n\nexport function rootState(root: DevtoolsRoot): DevtoolsRootState {\n  const { source } = root;\n  const probes: DevtoolsRootState['probes'] = {};\n  for (const [name, read] of root.probes) {\n    try {\n      probes[name] = serialize(read());\n    } catch (err) {\n      probes[name] = `[threw: ${(err as Error).message}]`;\n    }\n  }\n  return {\n    selection: [...source.selection()],\n    view: serialize(source.view()),\n    activeTool: source.activeTool(),\n    tools: [...source.tools()],\n    overlays: overlayFlags(source.overlays()),\n    probes,\n  };\n}\n\n/** Trace records are plain data by contract, and nest deeper than a node's data is shown. */\nconst RECORD = { depth: 12 };\n\nexport function traceSlice(root: DevtoolsRoot, cursor: number, coordCursor: number | undefined): DevtoolsTraceSlice {\n  const { trace, coords } = root.source;\n  const slice = trace.since(cursor);\n  const out: DevtoolsTraceSlice = {\n    entries: slice.entries.map((e) => serialize(e, RECORD)),\n    cursor: slice.cursor,\n    live: serialize(trace.live(), RECORD),\n  };\n  if (coordCursor !== undefined) {\n    const c = coords.since(coordCursor);\n    out.coords = { entries: c.entries.map((e) => serialize(e, RECORD)), cursor: c.cursor };\n  }\n  return out;\n}\n\n/** Answer `req` about `root`. `steer` lays a change over the panel's override. Throws on a bad request. */\nexport function answer(\n  root: DevtoolsRoot,\n  req: DevtoolsRequest,\n  steer: (change: { overlays?: DevtoolsOverlays; highlight?: readonly string[] }) => void,\n): DevtoolsResult {\n  switch (req.type) {\n    case 'get-children': return childrenOf(root, req.nodeId);\n    case 'get-node': return nodeDetail(root, req.nodeId);\n    case 'get-state': return rootState(root);\n    case 'get-trace': return traceSlice(root, req.cursor, req.coordCursor);\n    case 'get-frame': return serialize(root.source.frame());\n    case 'get-registry':\n      if (!root.source.registry) throw new Error('this root serves no registry');\n      return root.source.registry();\n    case 'get-history': return historySlice(root, req.cursor, req.checkpoints);\n    case 'select':\n      root.source.select(req.ids);\n      return null;\n    case 'set-tool':\n      if (req.toolId !== null && !root.source.tools().includes(req.toolId)) throw new Error(`no tool \"${req.toolId}\"`);\n      root.source.setTool(req.toolId);\n      return null;\n    case 'highlight':\n      steer({ highlight: [...req.ids] });\n      return null;\n    case 'set-overlays':\n      steer({ overlays: req.overlays });\n      return null;\n  }\n}\n"],"mappings":";;;;AAcA,SAAS,QAAQ,MAA8B;CAC7C,MAAM,QAAQ,KAAK,OAAO,MAAM;CAChC,IAAI,CAAC,OAAO,MAAM,IAAI,MAAM,uBAAuB;CACnD,OAAO;AACT;AAEA,SAAS,UAAU,MAAoC;CACrD,OAAO;EACL,IAAI,KAAK;EACT,MAAM,KAAK;EACX,OAAO,KAAK;EACZ,YAAY,KAAK,SAAS,cAAc,KAAK,SAAS,SAAS;EAC/D,QAAQ,KAAK,WAAW;EACxB,QAAQ,KAAK,WAAW;EACxB,UAAU,KAAK,aAAa;CAC9B;AACF;AAEA,SAAS,OAAO,OAAiB,IAAqB;CACpD,MAAM,OAAO,MAAM,IAAI,EAAY;CACnC,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,YAAY,GAAG,EAAE;CAC5C,OAAO;AACT;AAEA,SAAgB,WAAW,MAAoB,QAAmD;CAChG,MAAM,QAAQ,QAAQ,IAAI;CAE1B,QADY,WAAW,SAAY,MAAM,SAAS,OAAO,OAAO,MAAM,GAAG,MAAM,WAAW,MAAgB,GACnG,CAAI,KAAK,OAAO,UAAU,OAAO,OAAO,EAAE,CAAC,CAAC;AACrD;AAEA,SAAgB,WAAW,MAAoB,QAAoC;CACjF,MAAM,OAAO,OAAO,QAAQ,IAAI,GAAG,MAAM;CACzC,OAAO;EACL,GAAG,UAAU,IAAI;EACjB,QAAQ,KAAK,UAAU;EACvB,MAAM,UAAU,KAAK,IAAI;EACzB,MAAM,UAAU,KAAK,IAAI;CAC3B;AACF;;AAGA,SAAgB,aAAa,QAA8C;CACzE,MAAM,QAA0B,CAAC;CACjC,IAAI,CAAC,QAAQ,OAAO;CACpB,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,GAC9C,IAAI,OAAO,UAAU,WAAW,MAAmC,OAAO;CAE5E,OAAO;AACT;AAEA,SAAgB,UAAU,MAAuC;CAC/D,MAAM,EAAE,WAAW;CACnB,MAAM,SAAsC,CAAC;CAC7C,KAAK,MAAM,CAAC,MAAM,SAAS,KAAK,QAC9B,IAAI;EACF,OAAO,QAAQ,UAAU,KAAK,CAAC;CACjC,SAAS,KAAK;EACZ,OAAO,QAAQ,WAAY,IAAc,QAAQ;CACnD;CAEF,OAAO;EACL,WAAW,CAAC,GAAG,OAAO,UAAU,CAAC;EACjC,MAAM,UAAU,OAAO,KAAK,CAAC;EAC7B,YAAY,OAAO,WAAW;EAC9B,OAAO,CAAC,GAAG,OAAO,MAAM,CAAC;EACzB,UAAU,aAAa,OAAO,SAAS,CAAC;EACxC;CACF;AACF;;AAGA,IAAM,SAAS,EAAE,OAAO,GAAG;AAE3B,SAAgB,WAAW,MAAoB,QAAgB,aAAqD;CAClH,MAAM,EAAE,OAAO,WAAW,KAAK;CAC/B,MAAM,QAAQ,MAAM,MAAM,MAAM;CAChC,MAAM,MAA0B;EAC9B,SAAS,MAAM,QAAQ,KAAK,MAAM,UAAU,GAAG,MAAM,CAAC;EACtD,QAAQ,MAAM;EACd,MAAM,UAAU,MAAM,KAAK,GAAG,MAAM;CACtC;CACA,IAAI,gBAAgB,QAAW;EAC7B,MAAM,IAAI,OAAO,MAAM,WAAW;EAClC,IAAI,SAAS;GAAE,SAAS,EAAE,QAAQ,KAAK,MAAM,UAAU,GAAG,MAAM,CAAC;GAAG,QAAQ,EAAE;EAAO;CACvF;CACA,OAAO;AACT;;AAGA,SAAgB,OACd,MACA,KACA,OACgB;CAChB,QAAQ,IAAI,MAAZ;EACE,KAAK,gBAAgB,OAAO,WAAW,MAAM,IAAI,MAAM;EACvD,KAAK,YAAY,OAAO,WAAW,MAAM,IAAI,MAAM;EACnD,KAAK,aAAa,OAAO,UAAU,IAAI;EACvC,KAAK,aAAa,OAAO,WAAW,MAAM,IAAI,QAAQ,IAAI,WAAW;EACrE,KAAK,aAAa,OAAO,UAAU,KAAK,OAAO,MAAM,CAAC;EACtD,KAAK;GACH,IAAI,CAAC,KAAK,OAAO,UAAU,MAAM,IAAI,MAAM,8BAA8B;GACzE,OAAO,KAAK,OAAO,SAAS;EAC9B,KAAK,eAAe,OAAO,aAAa,MAAM,IAAI,QAAQ,IAAI,WAAW;EACzE,KAAK;GACH,KAAK,OAAO,OAAO,IAAI,GAAG;GAC1B,OAAO;EACT,KAAK;GACH,IAAI,IAAI,WAAW,QAAQ,CAAC,KAAK,OAAO,MAAM,CAAC,CAAC,SAAS,IAAI,MAAM,GAAG,MAAM,IAAI,MAAM,YAAY,IAAI,OAAO,EAAE;GAC/G,KAAK,OAAO,QAAQ,IAAI,MAAM;GAC9B,OAAO;EACT,KAAK;GACH,MAAM,EAAE,WAAW,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC;GACjC,OAAO;EACT,KAAK;GACH,MAAM,EAAE,UAAU,IAAI,SAAS,CAAC;GAChC,OAAO;CACX;AACF"}
+{"version":3,"file":"handlers.js","names":[],"sources":["../../src/devtools/handlers.ts"],"sourcesContent":["/** The answer to each devtools request, for one root. The session owns the override a steering request changes. */\nimport type { Node, NodeId, Scene } from 'core/scene/types';\nimport type { DebugConfig } from '../debug/types';\nimport type { DevtoolsRoot } from './root';\nimport type {\n  DevtoolsNodeDetail, DevtoolsNodeSummary, DevtoolsOverlays, DevtoolsRequest, DevtoolsResult,\n  DevtoolsRootState, DevtoolsTraceSlice,\n} from './protocol';\nimport { serialize } from './serialize';\nimport { historySlice } from './history';\n\ntype AnyScene = Scene<unknown, string, unknown>;\ntype AnyNode = Node<unknown, string, unknown>;\n\nfunction sceneOf(root: DevtoolsRoot): AnyScene {\n  const scene = root.source.scene();\n  if (!scene) throw new Error('scene not mounted yet');\n  return scene;\n}\n\nfunction summaryOf(node: AnyNode): DevtoolsNodeSummary {\n  return {\n    id: node.id,\n    kind: node.kind,\n    layer: node.layer,\n    childCount: node.children?.length ?? 0,\n    hidden: node.hidden === true,\n    locked: node.locked === true,\n    pickable: node.pickable !== false,\n  };\n}\n\nfunction nodeOf(scene: AnyScene, id: string): AnyNode {\n  const node = scene.get(id as NodeId);\n  if (!node) throw new Error(`no node \"${id}\"`);\n  return node;\n}\n\nexport function childrenOf(root: DevtoolsRoot, nodeId: string | undefined): DevtoolsNodeSummary[] {\n  const scene = sceneOf(root);\n  const ids = nodeId === undefined ? scene.roots : (nodeOf(scene, nodeId), scene.childrenOf(nodeId as NodeId));\n  return ids.map((id) => summaryOf(nodeOf(scene, id)));\n}\n\nexport function nodeDetail(root: DevtoolsRoot, nodeId: string): DevtoolsNodeDetail {\n  const node = nodeOf(sceneOf(root), nodeId);\n  return {\n    ...summaryOf(node),\n    parent: node.parent ?? null,\n    pose: serialize(node.pose),\n    data: serialize(node.data),\n  };\n}\n\n/** The on/off features of a debug config, leaving out its theme and strokes. */\nexport function overlayFlags(config: DebugConfig | null): DevtoolsOverlays {\n  const flags: DevtoolsOverlays = {};\n  if (!config) return flags;\n  for (const [key, value] of Object.entries(config)) {\n    if (typeof value === 'boolean') (flags as Record<string, boolean>)[key] = value;\n  }\n  return flags;\n}\n\nexport function rootState(root: DevtoolsRoot): DevtoolsRootState {\n  const { source } = root;\n  const probes: DevtoolsRootState['probes'] = {};\n  for (const [name, read] of root.probes) {\n    try {\n      probes[name] = serialize(read());\n    } catch (err) {\n      probes[name] = `[threw: ${(err as Error).message}]`;\n    }\n  }\n  return {\n    selection: [...source.selection()],\n    view: serialize(source.view()),\n    activeTool: source.activeTool(),\n    tools: [...source.tools()],\n    overlays: overlayFlags(source.overlays()),\n    probes,\n  };\n}\n\n/** Trace records are plain data by contract, and nest deeper than a node's data is shown. */\nconst RECORD = { depth: 12 };\n\nexport function traceSlice(root: DevtoolsRoot, cursor: number, coordCursor: number | undefined): DevtoolsTraceSlice {\n  const { trace, coords } = root.source;\n  const slice = trace.since(cursor);\n  const out: DevtoolsTraceSlice = {\n    entries: slice.entries.map((e) => serialize(e, RECORD)),\n    cursor: slice.cursor,\n    live: serialize(trace.live(), RECORD),\n  };\n  if (coordCursor !== undefined) {\n    const c = coords.since(coordCursor);\n    out.coords = { entries: c.entries.map((e) => serialize(e, RECORD)), cursor: c.cursor };\n  }\n  return out;\n}\n\n/** Answer `req` about `root`. `steer` lays a change over the panel's override. Throws on a bad request. */\nexport function answer(\n  root: DevtoolsRoot,\n  req: DevtoolsRequest,\n  steer: (change: { overlays?: DevtoolsOverlays; highlight?: readonly string[] }) => void,\n): DevtoolsResult {\n  switch (req.type) {\n    case 'get-children': return childrenOf(root, req.nodeId);\n    case 'get-node': return nodeDetail(root, req.nodeId);\n    case 'get-state': return rootState(root);\n    case 'get-trace': return traceSlice(root, req.cursor, req.coordCursor);\n    case 'get-frame': return serialize(root.source.frame());\n    case 'get-registry':\n      if (!root.source.registry) throw new Error('this root serves no registry');\n      return root.source.registry();\n    case 'get-history': return historySlice(root, req.cursor, req.checkpoints);\n    case 'select':\n      root.source.select(req.ids);\n      return null;\n    case 'set-tool':\n      if (req.toolId !== null && !root.source.tools().includes(req.toolId)) throw new Error(`no tool \"${req.toolId}\"`);\n      root.source.setTool(req.toolId);\n      return null;\n    case 'highlight':\n      steer({ highlight: [...req.ids] });\n      return null;\n    case 'set-overlays':\n      steer({ overlays: req.overlays });\n      return null;\n  }\n}\n"],"mappings":"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"}

package/dist/devtools/protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","names":[],"sources":["../../src/devtools/protocol.ts"],"sourcesContent":["/**\n * The messages a devtools panel and a page running weasel exchange. Plain\n * data only, so the same messages cross a direct call or `window.postMessage`.\n */\nimport type { DebugFeature } from '../debug/types';\nimport type { SerializedValue } from './serialize';\n\n/** Bumped on any change a panel built against the previous number would misread. */\nexport const DEVTOOLS_PROTOCOL = 1;\n\n/** The areas of a root a `changed` notice reports. */\nexport type DevtoolsArea = 'scene' | 'selection' | 'view' | 'tool' | 'trace' | 'registry' | 'history';\n\n/** One mounted `<SceneCanvas>`. */\nexport interface DevtoolsRootInfo {\n  id: string;\n  /** The canvas's `aria-label`, else its DOM id, else its root id. */\n  label: string;\n  dimension: '2d' | '3d';\n}\n\n/** Debug overlay features a panel turns on or off over the canvas's own `debug` prop. */\nexport type DevtoolsOverlays = Partial<Record<DebugFeature, boolean>>;\n\n/** A request a panel sends about one root. */\nexport type DevtoolsRequest = { protocol: number; requestId: number; rootId: string } & (\n  | { type: 'get-children'; nodeId?: string }\n  | { type: 'get-node'; nodeId: string }\n  | { type: 'get-state' }\n  /** Coord records come back only when `coordCursor` is given. */\n  | { type: 'get-trace'; cursor: number; coordCursor?: number }\n  | { type: 'get-frame' }\n  | { type: 'get-registry' }\n  /** The stack's entry labels come back only when `checkpoints` is true. */\n  | { type: 'get-history'; cursor: number; checkpoints?: boolean }\n  | { type: 'select'; ids: string[] }\n  | { type: 'highlight'; ids: string[] }\n  | { type: 'set-tool'; toolId: string | null }\n  | { type: 'set-overlays'; overlays: DevtoolsOverlays }\n);\n\n/** Every message a panel sends the page. */\nexport type PanelMessage =\n  | { type: 'yo'; protocol: number }\n  /** The panel is closing: drop its overlays and highlight, and stop tracing for it. */\n  | { type: 'bye'; protocol: number }\n  | DevtoolsRequest;\n\n/** Every message the page sends a panel. */\nexport type PageMessage =\n  | { type: 'sup'; protocol: number; kitVersion: string; roots: DevtoolsRootInfo[] }\n  | { type: 'root-added'; protocol: number; root: DevtoolsRootInfo }\n  | { type: 'root-removed'; protocol: number; rootId: string }\n  /** Each changed area with its new version. At most one per root per frame. */\n  | { type: 'changed'; protocol: number; rootId: string; areas: Partial<Record<DevtoolsArea, number>> }\n  | { type: 'result'; protocol: number; requestId: number; result: DevtoolsResult }\n  /** `requestId` is null for a message that was not a request. */\n  | { type: 'error'; protocol: number; requestId: number | null; message: string };\n\n/** One child row of the scene tree. `nodeId` absent asks for the top level. */\nexport interface DevtoolsNodeSummary {\n  id: string;\n  kind: 'leaf' | 'container';\n  layer: string;\n  childCount: number;\n  hidden: boolean;\n  locked: boolean;\n  pickable: boolean;\n}\n\n/** A node as `get-node` returns it: its row in the tree, plus its parent, pose and data. */\nexport interface DevtoolsNodeDetail extends DevtoolsNodeSummary {\n  parent: string | null;\n  pose: SerializedValue;\n  data: SerializedValue;\n}\n\n/** What `get-state` returns about a root. */\nexport interface DevtoolsRootState {\n  selection: string[];\n  view: SerializedValue;\n  activeTool: string | null;\n  tools: string[];\n  /** The debug overlay features in effect: the canvas's own, with the panel's over them. */\n  overlays: DevtoolsOverlays;\n  /** Probes registered through the test hook, by name. */\n  probes: Record<string, SerializedValue>;\n}\n\n/** What `get-trace` returns: the records after the cursor, and the cursor to send next. */\nexport interface DevtoolsTraceSlice {\n  entries: SerializedValue[];\n  cursor: number;\n  /** What a press at the pointer would do, or null when the pointer is off the canvas. */\n  live: SerializedValue;\n  coords?: { entries: SerializedValue[]; cursor: number };\n}\n\n/** One gesture-to-action binding, as a tool, an always-on entry or an action declares it. */\nexport interface DevtoolsBinding {\n  actionId: string;\n  /** The `GestureSpec` as written. */\n  spec: SerializedValue;\n  /** The spec in the route grammar, one string per route it expands to. */\n  routes: string[];\n  /** The binding's `BindingOpts`: params, roles, views. */\n  opts: SerializedValue;\n}\n\n/** A tool or other contribution the canvas's dispatcher assembles bindings from. */\nexport interface DevtoolsToolEntry {\n  id: string;\n  /** A switchable tool, an always-on entry, or one a `features` preset brought. */\n  slot: 'tool' | 'ambient' | 'contribution';\n  label: string;\n  /** The icon's qualified name. */\n  icon: string | null;\n  group: string | null;\n  shortcut: string | null;\n  /** The key that holds it engaged while pressed. */\n  hotkey: string | null;\n  hidden: boolean;\n  cursor: SerializedValue;\n  eligibility: SerializedValue;\n  bindings: DevtoolsBinding[];\n  /** Ids of the actions it brings with it. */\n  actions: string[];\n  /** Names of the deps it registers. */\n  deps: string[];\n  hasOverlay: boolean;\n}\n\n/** A registered action. `enabled` and `active` are asked when the registry is read. */\nexport interface DevtoolsActionEntry {\n  id: string;\n  label: string;\n  icon: string | null;\n  group: string | null;\n  tags: string[];\n  shortcut: string | null;\n  /** Which binding scope its own bindings ride. */\n  scope: 'hotkey' | 'ambient';\n  invoker: 'immediate' | 'ongoing' | null;\n  requires: string[];\n  variants: { key: string; label: string; icon: string | null; params: SerializedValue }[];\n  /** `true`, or the reason it is disabled. */\n  enabled: true | string;\n  /** Null for an action with no pressed state. */\n  active: boolean | null;\n  hasPreview: boolean;\n  /** The eligibility rule, or null for always eligible. */\n  eligible: SerializedValue;\n  bindings: DevtoolsBinding[];\n}\n\n/** A dep name the canvas's registry answers. */\nexport interface DevtoolsDepEntry {\n  name: string;\n  /** How many scopes above the canvas's own its live source sits: 0 for the canvas's. */\n  depth: number;\n  /** How many sources are stacked under the name there, the live one included. */\n  stacked: number;\n}\n\n/** What `get-registry` returns: what one canvas has registered. */\nexport interface DevtoolsRegistry {\n  tools: DevtoolsToolEntry[];\n  actions: DevtoolsActionEntry[];\n  deps: DevtoolsDepEntry[];\n  /** The node routing kinds a binding's `kind:` target can name, in classify order. */\n  routingKinds: string[];\n}\n\n/** One op of a recorded history step. */\nexport interface DevtoolsHistoryOp {\n  /** The op's registered name, `'kit:setPose'` and the like; `'?'` for an op with none. */\n  kind: string;\n  /** The node ids its args address. */\n  targets: string[];\n  summary: SerializedValue;\n}\n\n/** One change to a scene's history: an edit recorded, merged, undone, redone or jumped across. */\nexport interface DevtoolsHistoryRecord {\n  ts: number;\n  step: 'push' | 'coalesce' | 'undo' | 'redo' | 'goto' | 'branch' | 'prune' | 'clear' | 'restore';\n  /** The entries the step pushed, merged into or walked across, in the order it touched them. */\n  entries: { id: number; label: string; opCount: number; ops: DevtoolsHistoryOp[] }[];\n  /** Where the history stood after the step: entries applied, and entries in all. */\n  position: { index: number; total: number };\n}\n\n/** What `get-history` returns: the steps after the cursor, the cursor to send next, and where the history stands. */\nexport interface DevtoolsHistorySlice {\n  entries: DevtoolsHistoryRecord[];\n  cursor: number;\n  position: { index: number; total: number; canUndo: boolean; canRedo: boolean };\n  /** Every entry on the stacks, oldest applied first, then the redoable ones. */\n  checkpoints?: { id: string; label: string }[];\n}\n\n/** The body of a `result` reply; which one depends on the request it answers. */\nexport type DevtoolsResult =\n  | DevtoolsNodeSummary[]\n  | DevtoolsNodeDetail\n  | DevtoolsRootState\n  | DevtoolsTraceSlice\n  | DevtoolsRegistry\n  | DevtoolsHistorySlice\n  | SerializedValue\n  | null;\n"],"mappings":";;AAQA,IAAa,oBAAoB"}
+{"version":3,"file":"protocol.js","names":[],"sources":["../../src/devtools/protocol.ts"],"sourcesContent":["/**\n * The messages a devtools panel and a page running weasel exchange. Plain\n * data only, so the same messages cross a direct call or `window.postMessage`.\n */\nimport type { DebugFeature } from '../debug/types';\nimport type { SerializedValue } from './serialize';\n\n/** Bumped on any change a panel built against the previous number would misread. */\nexport const DEVTOOLS_PROTOCOL = 1;\n\n/** The areas of a root a `changed` notice reports. */\nexport type DevtoolsArea = 'scene' | 'selection' | 'view' | 'tool' | 'trace' | 'registry' | 'history';\n\n/** One mounted `<SceneCanvas>`. */\nexport interface DevtoolsRootInfo {\n  id: string;\n  /** The canvas's `aria-label`, else its DOM id, else its root id. */\n  label: string;\n  dimension: '2d' | '3d';\n}\n\n/** Debug overlay features a panel turns on or off over the canvas's own `debug` prop. */\nexport type DevtoolsOverlays = Partial<Record<DebugFeature, boolean>>;\n\n/** A request a panel sends about one root. */\nexport type DevtoolsRequest = { protocol: number; requestId: number; rootId: string } & (\n  | { type: 'get-children'; nodeId?: string }\n  | { type: 'get-node'; nodeId: string }\n  | { type: 'get-state' }\n  /** Coord records come back only when `coordCursor` is given. */\n  | { type: 'get-trace'; cursor: number; coordCursor?: number }\n  | { type: 'get-frame' }\n  | { type: 'get-registry' }\n  /** The stack's entry labels come back only when `checkpoints` is true. */\n  | { type: 'get-history'; cursor: number; checkpoints?: boolean }\n  | { type: 'select'; ids: string[] }\n  | { type: 'highlight'; ids: string[] }\n  | { type: 'set-tool'; toolId: string | null }\n  | { type: 'set-overlays'; overlays: DevtoolsOverlays }\n);\n\n/** Every message a panel sends the page. */\nexport type PanelMessage =\n  | { type: 'yo'; protocol: number }\n  /** The panel is closing: drop its overlays and highlight, and stop tracing for it. */\n  | { type: 'bye'; protocol: number }\n  | DevtoolsRequest;\n\n/** Every message the page sends a panel. */\nexport type PageMessage =\n  | { type: 'sup'; protocol: number; kitVersion: string; roots: DevtoolsRootInfo[] }\n  | { type: 'root-added'; protocol: number; root: DevtoolsRootInfo }\n  | { type: 'root-removed'; protocol: number; rootId: string }\n  /** Each changed area with its new version. At most one per root per frame. */\n  | { type: 'changed'; protocol: number; rootId: string; areas: Partial<Record<DevtoolsArea, number>> }\n  | { type: 'result'; protocol: number; requestId: number; result: DevtoolsResult }\n  /** `requestId` is null for a message that was not a request. */\n  | { type: 'error'; protocol: number; requestId: number | null; message: string };\n\n/** One child row of the scene tree. `nodeId` absent asks for the top level. */\nexport interface DevtoolsNodeSummary {\n  id: string;\n  kind: 'mark' | 'group';\n  layer: string;\n  childCount: number;\n  hidden: boolean;\n  locked: boolean;\n  pickable: boolean;\n}\n\n/** A node as `get-node` returns it: its row in the tree, plus its parent, pose and data. */\nexport interface DevtoolsNodeDetail extends DevtoolsNodeSummary {\n  parent: string | null;\n  pose: SerializedValue;\n  data: SerializedValue;\n}\n\n/** What `get-state` returns about a root. */\nexport interface DevtoolsRootState {\n  selection: string[];\n  view: SerializedValue;\n  activeTool: string | null;\n  tools: string[];\n  /** The debug overlay features in effect: the canvas's own, with the panel's over them. */\n  overlays: DevtoolsOverlays;\n  /** Probes registered through the test hook, by name. */\n  probes: Record<string, SerializedValue>;\n}\n\n/** What `get-trace` returns: the records after the cursor, and the cursor to send next. */\nexport interface DevtoolsTraceSlice {\n  entries: SerializedValue[];\n  cursor: number;\n  /** What a press at the pointer would do, or null when the pointer is off the canvas. */\n  live: SerializedValue;\n  coords?: { entries: SerializedValue[]; cursor: number };\n}\n\n/** One gesture-to-action binding, as a tool, an always-on entry or an action declares it. */\nexport interface DevtoolsBinding {\n  actionId: string;\n  /** The `GestureSpec` as written. */\n  spec: SerializedValue;\n  /** The spec in the route grammar, one string per route it expands to. */\n  routes: string[];\n  /** The binding's `BindingOpts`: params, roles, views. */\n  opts: SerializedValue;\n}\n\n/** A tool or other contribution the canvas's dispatcher assembles bindings from. */\nexport interface DevtoolsToolEntry {\n  id: string;\n  /** A switchable tool, an always-on entry, or one a `features` preset brought. */\n  slot: 'tool' | 'ambient' | 'contribution';\n  label: string;\n  /** The icon's qualified name. */\n  icon: string | null;\n  group: string | null;\n  shortcut: string | null;\n  /** The key that holds it engaged while pressed. */\n  hotkey: string | null;\n  hidden: boolean;\n  cursor: SerializedValue;\n  eligibility: SerializedValue;\n  bindings: DevtoolsBinding[];\n  /** Ids of the actions it brings with it. */\n  actions: string[];\n  /** Names of the deps it registers. */\n  deps: string[];\n  hasOverlay: boolean;\n}\n\n/** A registered action. `enabled` and `active` are asked when the registry is read. */\nexport interface DevtoolsActionEntry {\n  id: string;\n  label: string;\n  icon: string | null;\n  group: string | null;\n  tags: string[];\n  shortcut: string | null;\n  /** Which binding scope its own bindings ride. */\n  scope: 'hotkey' | 'ambient';\n  invoker: 'immediate' | 'ongoing' | null;\n  requires: string[];\n  variants: { key: string; label: string; icon: string | null; params: SerializedValue }[];\n  /** `true`, or the reason it is disabled. */\n  enabled: true | string;\n  /** Null for an action with no pressed state. */\n  active: boolean | null;\n  hasPreview: boolean;\n  /** The eligibility rule, or null for always eligible. */\n  eligible: SerializedValue;\n  bindings: DevtoolsBinding[];\n}\n\n/** A dep name the canvas's registry answers. */\nexport interface DevtoolsDepEntry {\n  name: string;\n  /** How many scopes above the canvas's own its live source sits: 0 for the canvas's. */\n  depth: number;\n  /** How many sources are stacked under the name there, the live one included. */\n  stacked: number;\n}\n\n/** What `get-registry` returns: what one canvas has registered. */\nexport interface DevtoolsRegistry {\n  tools: DevtoolsToolEntry[];\n  actions: DevtoolsActionEntry[];\n  deps: DevtoolsDepEntry[];\n  /** The node routing kinds a binding's `kind:` target can name, in classify order. */\n  routingKinds: string[];\n}\n\n/** One op of a recorded history step. */\nexport interface DevtoolsHistoryOp {\n  /** The op's registered name, `'kit:setPose'` and the like; `'?'` for an op with none. */\n  kind: string;\n  /** The node ids its args address. */\n  targets: string[];\n  summary: SerializedValue;\n}\n\n/** One change to a scene's history: an edit recorded, merged, undone, redone or jumped across. */\nexport interface DevtoolsHistoryRecord {\n  ts: number;\n  step: 'push' | 'coalesce' | 'undo' | 'redo' | 'goto' | 'branch' | 'prune' | 'clear' | 'restore';\n  /** The entries the step pushed, merged into or walked across, in the order it touched them. */\n  entries: { id: number; label: string; opCount: number; ops: DevtoolsHistoryOp[] }[];\n  /** Where the history stood after the step: entries applied, and entries in all. */\n  position: { index: number; total: number };\n}\n\n/** What `get-history` returns: the steps after the cursor, the cursor to send next, and where the history stands. */\nexport interface DevtoolsHistorySlice {\n  entries: DevtoolsHistoryRecord[];\n  cursor: number;\n  position: { index: number; total: number; canUndo: boolean; canRedo: boolean };\n  /** Every entry on the stacks, oldest applied first, then the redoable ones. */\n  checkpoints?: { id: string; label: string }[];\n}\n\n/** The body of a `result` reply; which one depends on the request it answers. */\nexport type DevtoolsResult =\n  | DevtoolsNodeSummary[]\n  | DevtoolsNodeDetail\n  | DevtoolsRootState\n  | DevtoolsTraceSlice\n  | DevtoolsRegistry\n  | DevtoolsHistorySlice\n  | SerializedValue\n  | null;\n"],"mappings":";;AAQA,IAAa,oBAAoB"}

package/dist/devtools-protocol.d.ts

@@ -1,10 +1,11 @@
 import { e as DebugFeature, a as DebugConfig } from './types-BN9hbdMI.js';
 import { DispatchTrace, TraceRing } from '@weasel-js/routing';
-import { S as Scene } from './types-CniVctmk.js';
+import { S as Scene } from './types-BEdRIhNc.js';
 import '@weasel-js/history';
-import './types-7puAuVD2.js';
+import './types-49uYJN3j.js';
 import '@weasel-js/geom';
 import '@weasel-js/quantity';
+import '@weasel-js/paint';
 
 /**
  * Turn any value into plain data a panel can display. A node's `data` is the
@@ -134,7 +135,7 @@ type PageMessage = {
 /** One child row of the scene tree. `nodeId` absent asks for the top level. */
 interface DevtoolsNodeSummary {
     id: string;
-    kind: 'leaf' | 'container';
+    kind: 'mark' | 'group';
     layer: string;
     childCount: number;
     hidden: boolean;

package/dist/devtools.d.ts

@@ -1,8 +1,9 @@
 export { DEVTOOLS_ENVELOPE, DEVTOOLS_PROTOCOL, DevtoolsActionEntry, DevtoolsArea, DevtoolsBinding, DevtoolsDepEntry, DevtoolsEnvelope, DevtoolsHistoryOp, DevtoolsHistoryRecord, DevtoolsHistorySlice, DevtoolsNodeDetail, DevtoolsNodeSummary, DevtoolsOverlays, DevtoolsRegistry, DevtoolsRequest, DevtoolsResult, DevtoolsRoot, DevtoolsRootInfo, DevtoolsRootSource, DevtoolsRootState, DevtoolsSchedule, DevtoolsToolEntry, DevtoolsTraceSlice, DevtoolsTransport, PageMessage, PageTransport, PanelMessage, PanelTransport, SerializeLimits, SerializedValue, WeaselDevtoolsHook, createDevtoolsHook, createDevtoolsRoot, createInPageTransports, createWindowPageTransport, createWindowPanelTransport, installDevtoolsHook, isDevtoolsEnvelope, serialize } from './devtools-protocol.js';
 import './types-BN9hbdMI.js';
 import '@weasel-js/routing';
-import './types-CniVctmk.js';
+import './types-BEdRIhNc.js';
 import '@weasel-js/history';
-import './types-7puAuVD2.js';
+import './types-49uYJN3j.js';
 import '@weasel-js/geom';
 import '@weasel-js/quantity';
+import '@weasel-js/paint';

package/dist/features/measure/measureHit.js

@@ -1,3 +1,4 @@
+import { nodesAsShown, shownLookup } from "../../core/scene/nodeAsShown.js";
 import { measureEndsOf } from "./measurement.js";
 import { nodeGates } from "../../core/scene/nodeGates.js";
 import { measureIds } from "./measurements.js";
@@ -17,9 +18,10 @@ function distanceToSegment(p, a, b) {
 */
 function measureAt(scene, ms, p, tolerance) {
 	const gates = nodeGates(scene);
+	const shown = shownLookup(scene);
 	const ids = measureIds(scene, ms).reverse().filter((id) => !gates.hidden(id) && !gates.locked(id));
 	for (const id of ids) {
-		const ends = measureEndsOf(scene.get(id));
+		const ends = measureEndsOf(shown.get(id));
 		if (!ends) continue;
 		for (const part of ["end", "start"]) if (Math.hypot(p.x - ends[part].x, p.y - ends[part].y) <= tolerance) return {
 			id,
@@ -27,7 +29,7 @@ function measureAt(scene, ms, p, tolerance) {
 		};
 	}
 	for (const id of ids) {
-		const ends = measureEndsOf(scene.get(id));
+		const ends = measureEndsOf(shown.get(id));
 		if (ends && distanceToSegment(p, ends.start, ends.end) <= tolerance) return {
 			id,
 			part: "line"
@@ -46,7 +48,7 @@ function measureEndSource(opts = {}) {
 			const gates = nodeGates(q.scene);
 			const skip = new Set(q.exclude);
 			const reach = q.reachWorld(q.reachPx);
-			for (const node of q.scene.renderOrderNodes()) {
+			for (const node of nodesAsShown(q.scene.overrides, q.scene.renderOrderNodes())) {
 				const ends = measureEndsOf(node);
 				if (!ends || skip.has(node.id) || gates.hidden(node.id)) continue;
 				for (const end of [ends.start, ends.end]) {

package/dist/features/measure/measureHit.js.map

@@ -1 +1 @@
-{"version":3,"file":"measureHit.js","names":[],"sources":["../../../src/features/measure/measureHit.ts"],"sourcesContent":["import type { NodeId, Scene } from 'core/scene/types';\nimport { measureEndsOf, type MeasureEnd, type MeasurePoint } from './measurement';\nimport { measureIds, type Measurements } from './measurements';\nimport { nodeGates } from 'core/scene/nodeGates';\nimport type { SnapSource } from 'features/snap/types';\n\n/** Which part of which measurement lies under a point. */\nexport interface MeasureHit {\n  id: NodeId;\n  part: MeasureEnd | 'line';\n}\n\n\nfunction distanceToSegment(p: MeasurePoint, a: MeasurePoint, b: MeasurePoint): number {\n  const dx = b.x - a.x;\n  const dy = b.y - a.y;\n  const len2 = dx * dx + dy * dy;\n  const t = len2 === 0 ? 0 : Math.max(0, Math.min(1, ((p.x - a.x) * dx + (p.y - a.y) * dy) / len2));\n  return Math.hypot(p.x - (a.x + t * dx), p.y - (a.y + t * dy));\n}\n\n/**\n * The measurement under `p`, newest first: an end within `tolerance` world\n * units of it, else a line within the same distance. A hidden or locked\n * measurement (`nodeGates`) is passed over.\n */\nexport function measureAt(\n  scene: Pick<Scene<unknown, string, unknown>, 'renderOrderNodes' | 'get' | 'layers'>,\n  ms: Pick<Measurements, 'layer'>,\n  p: MeasurePoint,\n  tolerance: number,\n): MeasureHit | null {\n  const gates = nodeGates(scene);\n  const ids = measureIds(scene, ms).reverse().filter((id) => !gates.hidden(id) && !gates.locked(id));\n  for (const id of ids) {\n    const ends = measureEndsOf(scene.get(id));\n    if (!ends) continue;\n    for (const part of ['end', 'start'] as const) {\n      if (Math.hypot(p.x - ends[part].x, p.y - ends[part].y) <= tolerance) return { id, part };\n    }\n  }\n  for (const id of ids) {\n    const ends = measureEndsOf(scene.get(id));\n    if (ends && distanceToSegment(p, ends.start, ends.end) <= tolerance) return { id, part: 'line' };\n  }\n  return null;\n}\n\n/** Options for `measureEndSource`. */\nexport interface MeasureEndSourceOptions {\n  /** Overrides the canvas's reach for measurement ends, in screen px. */\n  reachPx?: number;\n}\n\n/** The ends of every shown measurement as snap targets for a pointer probe. */\nexport function measureEndSource(opts: MeasureEndSourceOptions = {}): SnapSource {\n  return {\n    id: 'measure-ends',\n    roles: ['pointer'],\n    ...(opts.reachPx !== undefined ? { reachPx: opts.reachPx } : {}),\n    *collect(q) {\n      if (!q.scene) return;\n      const gates = nodeGates(q.scene);\n      const skip = new Set(q.exclude);\n      const reach = q.reachWorld(q.reachPx);\n      for (const node of q.scene.renderOrderNodes()) {\n        const ends = measureEndsOf(node);\n        if (!ends || skip.has(node.id) || gates.hidden(node.id)) continue;\n        for (const end of [ends.start, ends.end]) {\n          const at = { x: end.x, y: end.y };\n          for (const p of q.probes) {\n            if (Math.hypot(at.x - p.at.x, at.y - p.at.y) > reach) continue;\n            yield { probe: p.id, locus: { at, dirs: [] }, mark: { kind: 'point', at, glyph: 'center' } };\n          }\n        }\n      }\n    },\n  };\n}\n"],"mappings":";;;;;AAaA,SAAS,kBAAkB,GAAiB,GAAiB,GAAyB;CACpF,MAAM,KAAK,EAAE,IAAI,EAAE;CACnB,MAAM,KAAK,EAAE,IAAI,EAAE;CACnB,MAAM,OAAO,KAAK,KAAK,KAAK;CAC5B,MAAM,IAAI,SAAS,IAAI,IAAI,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,MAAM,IAAI,CAAC;CAChG,OAAO,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,KAAK,EAAE,KAAK,EAAE,IAAI,IAAI,GAAG;AAC9D;;;;;;AAOA,SAAgB,UACd,OACA,IACA,GACA,WACmB;CACnB,MAAM,QAAQ,UAAU,KAAK;CAC7B,MAAM,MAAM,WAAW,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,QAAQ,OAAO,CAAC,MAAM,OAAO,EAAE,KAAK,CAAC,MAAM,OAAO,EAAE,CAAC;CACjG,KAAK,MAAM,MAAM,KAAK;EACpB,MAAM,OAAO,cAAc,MAAM,IAAI,EAAE,CAAC;EACxC,IAAI,CAAC,MAAM;EACX,KAAK,MAAM,QAAQ,CAAC,OAAO,OAAO,GAChC,IAAI,KAAK,MAAM,EAAE,IAAI,KAAK,KAAK,CAAC,GAAG,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,KAAK,WAAW,OAAO;GAAE;GAAI;EAAK;CAE3F;CACA,KAAK,MAAM,MAAM,KAAK;EACpB,MAAM,OAAO,cAAc,MAAM,IAAI,EAAE,CAAC;EACxC,IAAI,QAAQ,kBAAkB,GAAG,KAAK,OAAO,KAAK,GAAG,KAAK,WAAW,OAAO;GAAE;GAAI,MAAM;EAAO;CACjG;CACA,OAAO;AACT;;AASA,SAAgB,iBAAiB,OAAgC,CAAC,GAAe;CAC/E,OAAO;EACL,IAAI;EACJ,OAAO,CAAC,SAAS;EACjB,GAAI,KAAK,YAAY,SAAY,EAAE,SAAS,KAAK,QAAQ,IAAI,CAAC;EAC9D,CAAC,QAAQ,GAAG;GACV,IAAI,CAAC,EAAE,OAAO;GACd,MAAM,QAAQ,UAAU,EAAE,KAAK;GAC/B,MAAM,OAAO,IAAI,IAAI,EAAE,OAAO;GAC9B,MAAM,QAAQ,EAAE,WAAW,EAAE,OAAO;GACpC,KAAK,MAAM,QAAQ,EAAE,MAAM,iBAAiB,GAAG;IAC7C,MAAM,OAAO,cAAc,IAAI;IAC/B,IAAI,CAAC,QAAQ,KAAK,IAAI,KAAK,EAAE,KAAK,MAAM,OAAO,KAAK,EAAE,GAAG;IACzD,KAAK,MAAM,OAAO,CAAC,KAAK,OAAO,KAAK,GAAG,GAAG;KACxC,MAAM,KAAK;MAAE,GAAG,IAAI;MAAG,GAAG,IAAI;KAAE;KAChC,KAAK,MAAM,KAAK,EAAE,QAAQ;MACxB,IAAI,KAAK,MAAM,GAAG,IAAI,EAAE,GAAG,GAAG,GAAG,IAAI,EAAE,GAAG,CAAC,IAAI,OAAO;MACtD,MAAM;OAAE,OAAO,EAAE;OAAI,OAAO;QAAE;QAAI,MAAM,CAAC;OAAE;OAAG,MAAM;QAAE,MAAM;QAAS;QAAI,OAAO;OAAS;MAAE;KAC7F;IACF;GACF;EACF;CACF;AACF"}
+{"version":3,"file":"measureHit.js","names":[],"sources":["../../../src/features/measure/measureHit.ts"],"sourcesContent":["import type { NodeId, Scene } from 'core/scene/types';\nimport { measureEndsOf, type MeasureEnd, type MeasurePoint } from './measurement';\nimport { measureIds, type Measurements } from './measurements';\nimport { nodesAsShown, shownLookup } from 'core/scene/nodeAsShown';\nimport { nodeGates } from 'core/scene/nodeGates';\nimport type { SnapSource } from 'features/snap/types';\n\n/** Which part of which measurement lies under a point. */\nexport interface MeasureHit {\n  id: NodeId;\n  part: MeasureEnd | 'line';\n}\n\n\nfunction distanceToSegment(p: MeasurePoint, a: MeasurePoint, b: MeasurePoint): number {\n  const dx = b.x - a.x;\n  const dy = b.y - a.y;\n  const len2 = dx * dx + dy * dy;\n  const t = len2 === 0 ? 0 : Math.max(0, Math.min(1, ((p.x - a.x) * dx + (p.y - a.y) * dy) / len2));\n  return Math.hypot(p.x - (a.x + t * dx), p.y - (a.y + t * dy));\n}\n\n/**\n * The measurement under `p`, newest first: an end within `tolerance` world\n * units of it, else a line within the same distance. A hidden or locked\n * measurement (`nodeGates`) is passed over.\n */\nexport function measureAt(\n  scene: Pick<Scene<unknown, string, unknown>, 'renderOrderNodes' | 'get' | 'layers' | 'overrides'>,\n  ms: Pick<Measurements, 'layer'>,\n  p: MeasurePoint,\n  tolerance: number,\n): MeasureHit | null {\n  const gates = nodeGates(scene);\n  // Hit where the ends are shown: a gesture moving one publishes it as a data override.\n  const shown = shownLookup(scene);\n  const ids = measureIds(scene, ms).reverse().filter((id) => !gates.hidden(id) && !gates.locked(id));\n  for (const id of ids) {\n    const ends = measureEndsOf(shown.get(id));\n    if (!ends) continue;\n    for (const part of ['end', 'start'] as const) {\n      if (Math.hypot(p.x - ends[part].x, p.y - ends[part].y) <= tolerance) return { id, part };\n    }\n  }\n  for (const id of ids) {\n    const ends = measureEndsOf(shown.get(id));\n    if (ends && distanceToSegment(p, ends.start, ends.end) <= tolerance) return { id, part: 'line' };\n  }\n  return null;\n}\n\n/** Options for `measureEndSource`. */\nexport interface MeasureEndSourceOptions {\n  /** Overrides the canvas's reach for measurement ends, in screen px. */\n  reachPx?: number;\n}\n\n/** The ends of every shown measurement as snap targets for a pointer probe. */\nexport function measureEndSource(opts: MeasureEndSourceOptions = {}): SnapSource {\n  return {\n    id: 'measure-ends',\n    roles: ['pointer'],\n    ...(opts.reachPx !== undefined ? { reachPx: opts.reachPx } : {}),\n    *collect(q) {\n      if (!q.scene) return;\n      const gates = nodeGates(q.scene);\n      const skip = new Set(q.exclude);\n      const reach = q.reachWorld(q.reachPx);\n      for (const node of nodesAsShown(q.scene.overrides, q.scene.renderOrderNodes())) {\n        const ends = measureEndsOf(node);\n        if (!ends || skip.has(node.id) || gates.hidden(node.id)) continue;\n        for (const end of [ends.start, ends.end]) {\n          const at = { x: end.x, y: end.y };\n          for (const p of q.probes) {\n            if (Math.hypot(at.x - p.at.x, at.y - p.at.y) > reach) continue;\n            yield { probe: p.id, locus: { at, dirs: [] }, mark: { kind: 'point', at, glyph: 'center' } };\n          }\n        }\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;AAcA,SAAS,kBAAkB,GAAiB,GAAiB,GAAyB;CACpF,MAAM,KAAK,EAAE,IAAI,EAAE;CACnB,MAAM,KAAK,EAAE,IAAI,EAAE;CACnB,MAAM,OAAO,KAAK,KAAK,KAAK;CAC5B,MAAM,IAAI,SAAS,IAAI,IAAI,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,MAAM,IAAI,CAAC;CAChG,OAAO,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,KAAK,EAAE,KAAK,EAAE,IAAI,IAAI,GAAG;AAC9D;;;;;;AAOA,SAAgB,UACd,OACA,IACA,GACA,WACmB;CACnB,MAAM,QAAQ,UAAU,KAAK;CAE7B,MAAM,QAAQ,YAAY,KAAK;CAC/B,MAAM,MAAM,WAAW,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,QAAQ,OAAO,CAAC,MAAM,OAAO,EAAE,KAAK,CAAC,MAAM,OAAO,EAAE,CAAC;CACjG,KAAK,MAAM,MAAM,KAAK;EACpB,MAAM,OAAO,cAAc,MAAM,IAAI,EAAE,CAAC;EACxC,IAAI,CAAC,MAAM;EACX,KAAK,MAAM,QAAQ,CAAC,OAAO,OAAO,GAChC,IAAI,KAAK,MAAM,EAAE,IAAI,KAAK,KAAK,CAAC,GAAG,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,KAAK,WAAW,OAAO;GAAE;GAAI;EAAK;CAE3F;CACA,KAAK,MAAM,MAAM,KAAK;EACpB,MAAM,OAAO,cAAc,MAAM,IAAI,EAAE,CAAC;EACxC,IAAI,QAAQ,kBAAkB,GAAG,KAAK,OAAO,KAAK,GAAG,KAAK,WAAW,OAAO;GAAE;GAAI,MAAM;EAAO;CACjG;CACA,OAAO;AACT;;AASA,SAAgB,iBAAiB,OAAgC,CAAC,GAAe;CAC/E,OAAO;EACL,IAAI;EACJ,OAAO,CAAC,SAAS;EACjB,GAAI,KAAK,YAAY,SAAY,EAAE,SAAS,KAAK,QAAQ,IAAI,CAAC;EAC9D,CAAC,QAAQ,GAAG;GACV,IAAI,CAAC,EAAE,OAAO;GACd,MAAM,QAAQ,UAAU,EAAE,KAAK;GAC/B,MAAM,OAAO,IAAI,IAAI,EAAE,OAAO;GAC9B,MAAM,QAAQ,EAAE,WAAW,EAAE,OAAO;GACpC,KAAK,MAAM,QAAQ,aAAa,EAAE,MAAM,WAAW,EAAE,MAAM,iBAAiB,CAAC,GAAG;IAC9E,MAAM,OAAO,cAAc,IAAI;IAC/B,IAAI,CAAC,QAAQ,KAAK,IAAI,KAAK,EAAE,KAAK,MAAM,OAAO,KAAK,EAAE,GAAG;IACzD,KAAK,MAAM,OAAO,CAAC,KAAK,OAAO,KAAK,GAAG,GAAG;KACxC,MAAM,KAAK;MAAE,GAAG,IAAI;MAAG,GAAG,IAAI;KAAE;KAChC,KAAK,MAAM,KAAK,EAAE,QAAQ;MACxB,IAAI,KAAK,MAAM,GAAG,IAAI,EAAE,GAAG,GAAG,GAAG,IAAI,EAAE,GAAG,CAAC,IAAI,OAAO;MACtD,MAAM;OAAE,OAAO,EAAE;OAAI,OAAO;QAAE;QAAI,MAAM,CAAC;OAAE;OAAG,MAAM;QAAE,MAAM;QAAS;QAAI,OAAO;OAAS;MAAE;KAC7F;IACF;GACF;EACF;CACF;AACF"}

package/dist/features/measure/measurement.js

@@ -47,7 +47,7 @@ function measureNode(id, layer, start, end) {
 	} };
 	return {
 		id,
-		kind: "leaf",
+		kind: "mark",
 		layer,
 		parent: null,
 		pose: measurePose(start, end),

package/dist/features/measure/measurement.js.map

@@ -1 +1 @@
-{"version":3,"file":"measurement.js","names":[],"sources":["../../../src/features/measure/measurement.ts"],"sourcesContent":["import type { Node, NodeId, RectPose } from 'core/scene/types';\n\n/** A world-space point. */\nexport interface MeasurePoint { x: number; y: number }\n\n/**\n * The offset from `start` to `end`, in world units. `dx` and `dy` are on the\n * world's own axes, where y grows downward; `angle` reads like a protractor\n * instead, counterclockwise-positive on screen, so a line rising up and to\n * the right at 30° reads +30°. The canvas's own rotations are\n * clockwise-positive: a rotate that follows the line turns by `-angle`.\n */\nexport interface Measurement {\n  readonly start: MeasurePoint;\n  readonly end: MeasurePoint;\n  readonly dx: number;\n  readonly dy: number;\n  readonly distance: number;\n  /** `atan2(-dy, dx)`, in `(-π, π]`. Zero for a zero-length measurement. */\n  readonly angle: number;\n}\n\n/** Measure from `start` to `end`. */\nexport function measureBetween(start: MeasurePoint, end: MeasurePoint): Measurement {\n  const dx = end.x - start.x;\n  const dy = end.y - start.y;\n  return {\n    start: { x: start.x, y: start.y },\n    end: { x: end.x, y: end.y },\n    dx,\n    dy,\n    distance: Math.hypot(dx, dy),\n    // `|| 0` drops the sign of a negated zero, which would read a leftward line as -π.\n    angle: dx === 0 && dy === 0 ? 0 : Math.atan2(-dy || 0, dx),\n  };\n}\n\n/** What a measurement node keeps in `data`: its two ends, in world units. A\n *  `label` beside it names the node in a layer list. */\nexport interface MeasureData {\n  measure: { start: MeasurePoint; end: MeasurePoint };\n  label?: string;\n}\n\n/** Which end of a measurement. */\nexport type MeasureEnd = 'start' | 'end';\n\n\n/** The ends `node` measures between, or null when it is not a measurement. */\nexport function measureEndsOf(node: Pick<Node<unknown, string, unknown>, 'data'> | undefined): MeasureData['measure'] | null {\n  const m = (node?.data as Partial<MeasureData> | null | undefined)?.measure;\n  if (!m || typeof m !== 'object' || !m.start || !m.end) return null;\n  return m;\n}\n\n/** The measurement `node` holds, or null when it is not one. */\nexport function measurementOf(node: Pick<Node<unknown, string, unknown>, 'data'> | undefined): Measurement | null {\n  const ends = measureEndsOf(node);\n  return ends ? measureBetween(ends.start, ends.end) : null;\n}\n\n/** The box a measurement's pose holds: its two ends' bounds, which is what\n *  culling, area queries, and fitting the view read. */\nexport function measurePose(start: MeasurePoint, end: MeasurePoint): RectPose {\n  return {\n    x: Math.min(start.x, end.x),\n    y: Math.min(start.y, end.y),\n    width: Math.abs(end.x - start.x),\n    height: Math.abs(end.y - start.y),\n  };\n}\n\n/** A measurement node on `layer`, ready to insert. */\nexport function measureNode(id: NodeId, layer: string, start: MeasurePoint, end: MeasurePoint): Node<unknown, string, unknown> {\n  const data: MeasureData = { measure: { start: { ...start }, end: { ...end } } };\n  return { id, kind: 'leaf', layer, parent: null, pose: measurePose(start, end), data };\n}\n\n/** `node`'s data and pose with its `which` end moved to `to`. */\nexport function withMeasureEnd(\n  node: Node<unknown, string, unknown>,\n  which: MeasureEnd,\n  to: MeasurePoint,\n): { data: MeasureData; pose: RectPose } | null {\n  const ends = measureEndsOf(node);\n  if (!ends) return null;\n  const next = { ...ends, [which]: { x: to.x, y: to.y } };\n  const data: MeasureData = { ...(node.data as MeasureData), measure: next };\n  return { data, pose: measurePose(next.start, next.end) };\n}\n"],"mappings":";;AAuBA,SAAgB,eAAe,OAAqB,KAAgC;CAClF,MAAM,KAAK,IAAI,IAAI,MAAM;CACzB,MAAM,KAAK,IAAI,IAAI,MAAM;CACzB,OAAO;EACL,OAAO;GAAE,GAAG,MAAM;GAAG,GAAG,MAAM;EAAE;EAChC,KAAK;GAAE,GAAG,IAAI;GAAG,GAAG,IAAI;EAAE;EAC1B;EACA;EACA,UAAU,KAAK,MAAM,IAAI,EAAE;EAE3B,OAAO,OAAO,KAAK,OAAO,IAAI,IAAI,KAAK,MAAM,CAAC,MAAM,GAAG,EAAE;CAC3D;AACF;;AAcA,SAAgB,cAAc,MAA+F;CAC3H,MAAM,KAAK,MAAM,KAAA,EAAkD;CACnE,IAAI,CAAC,KAAK,OAAO,MAAM,YAAY,CAAC,EAAE,SAAS,CAAC,EAAE,KAAK,OAAO;CAC9D,OAAO;AACT;;AAGA,SAAgB,cAAc,MAAoF;CAChH,MAAM,OAAO,cAAc,IAAI;CAC/B,OAAO,OAAO,eAAe,KAAK,OAAO,KAAK,GAAG,IAAI;AACvD;;;AAIA,SAAgB,YAAY,OAAqB,KAA6B;CAC5E,OAAO;EACL,GAAG,KAAK,IAAI,MAAM,GAAG,IAAI,CAAC;EAC1B,GAAG,KAAK,IAAI,MAAM,GAAG,IAAI,CAAC;EAC1B,OAAO,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC;EAC/B,QAAQ,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC;CAClC;AACF;;AAGA,SAAgB,YAAY,IAAY,OAAe,OAAqB,KAAmD;CAC7H,MAAM,OAAoB,EAAE,SAAS;EAAE,OAAO,EAAE,GAAG,MAAM;EAAG,KAAK,EAAE,GAAG,IAAI;CAAE,EAAE;CAC9E,OAAO;EAAE;EAAI,MAAM;EAAQ;EAAO,QAAQ;EAAM,MAAM,YAAY,OAAO,GAAG;EAAG;CAAK;AACtF;;AAGA,SAAgB,eACd,MACA,OACA,IAC8C;CAC9C,MAAM,OAAO,cAAc,IAAI;CAC/B,IAAI,CAAC,MAAM,OAAO;CAClB,MAAM,OAAO;EAAE,GAAG;GAAO,QAAQ;GAAE,GAAG,GAAG;GAAG,GAAG,GAAG;EAAE;CAAE;CAEtD,OAAO;EAAE;GADmB,GAAI,KAAK;GAAsB,SAAS;EAC3D;EAAM,MAAM,YAAY,KAAK,OAAO,KAAK,GAAG;CAAE;AACzD"}
+{"version":3,"file":"measurement.js","names":[],"sources":["../../../src/features/measure/measurement.ts"],"sourcesContent":["import type { Node, NodeId, RectPose } from 'core/scene/types';\n\n/** A world-space point. */\nexport interface MeasurePoint { x: number; y: number }\n\n/**\n * The offset from `start` to `end`, in world units. `dx` and `dy` are on the\n * world's own axes, where y grows downward; `angle` reads like a protractor\n * instead, counterclockwise-positive on screen, so a line rising up and to\n * the right at 30° reads +30°. The canvas's own rotations are\n * clockwise-positive: a rotate that follows the line turns by `-angle`.\n */\nexport interface Measurement {\n  readonly start: MeasurePoint;\n  readonly end: MeasurePoint;\n  readonly dx: number;\n  readonly dy: number;\n  readonly distance: number;\n  /** `atan2(-dy, dx)`, in `(-π, π]`. Zero for a zero-length measurement. */\n  readonly angle: number;\n}\n\n/** Measure from `start` to `end`. */\nexport function measureBetween(start: MeasurePoint, end: MeasurePoint): Measurement {\n  const dx = end.x - start.x;\n  const dy = end.y - start.y;\n  return {\n    start: { x: start.x, y: start.y },\n    end: { x: end.x, y: end.y },\n    dx,\n    dy,\n    distance: Math.hypot(dx, dy),\n    // `|| 0` drops the sign of a negated zero, which would read a leftward line as -π.\n    angle: dx === 0 && dy === 0 ? 0 : Math.atan2(-dy || 0, dx),\n  };\n}\n\n/** What a measurement node keeps in `data`: its two ends, in world units. A\n *  `label` beside it names the node in a layer list. */\nexport interface MeasureData {\n  measure: { start: MeasurePoint; end: MeasurePoint };\n  label?: string;\n}\n\n/** Which end of a measurement. */\nexport type MeasureEnd = 'start' | 'end';\n\n\n/** The ends `node` measures between, or null when it is not a measurement. */\nexport function measureEndsOf(node: Pick<Node<unknown, string, unknown>, 'data'> | undefined): MeasureData['measure'] | null {\n  const m = (node?.data as Partial<MeasureData> | null | undefined)?.measure;\n  if (!m || typeof m !== 'object' || !m.start || !m.end) return null;\n  return m;\n}\n\n/** The measurement `node` holds, or null when it is not one. */\nexport function measurementOf(node: Pick<Node<unknown, string, unknown>, 'data'> | undefined): Measurement | null {\n  const ends = measureEndsOf(node);\n  return ends ? measureBetween(ends.start, ends.end) : null;\n}\n\n/** The box a measurement's pose holds: its two ends' bounds, which is what\n *  culling, area queries, and fitting the view read. */\nexport function measurePose(start: MeasurePoint, end: MeasurePoint): RectPose {\n  return {\n    x: Math.min(start.x, end.x),\n    y: Math.min(start.y, end.y),\n    width: Math.abs(end.x - start.x),\n    height: Math.abs(end.y - start.y),\n  };\n}\n\n/** A measurement node on `layer`, ready to insert. */\nexport function measureNode(id: NodeId, layer: string, start: MeasurePoint, end: MeasurePoint): Node<unknown, string, unknown> {\n  const data: MeasureData = { measure: { start: { ...start }, end: { ...end } } };\n  return { id, kind: 'mark', layer, parent: null, pose: measurePose(start, end), data };\n}\n\n/** `node`'s data and pose with its `which` end moved to `to`. */\nexport function withMeasureEnd(\n  node: Node<unknown, string, unknown>,\n  which: MeasureEnd,\n  to: MeasurePoint,\n): { data: MeasureData; pose: RectPose } | null {\n  const ends = measureEndsOf(node);\n  if (!ends) return null;\n  const next = { ...ends, [which]: { x: to.x, y: to.y } };\n  const data: MeasureData = { ...(node.data as MeasureData), measure: next };\n  return { data, pose: measurePose(next.start, next.end) };\n}\n"],"mappings":";;AAuBA,SAAgB,eAAe,OAAqB,KAAgC;CAClF,MAAM,KAAK,IAAI,IAAI,MAAM;CACzB,MAAM,KAAK,IAAI,IAAI,MAAM;CACzB,OAAO;EACL,OAAO;GAAE,GAAG,MAAM;GAAG,GAAG,MAAM;EAAE;EAChC,KAAK;GAAE,GAAG,IAAI;GAAG,GAAG,IAAI;EAAE;EAC1B;EACA;EACA,UAAU,KAAK,MAAM,IAAI,EAAE;EAE3B,OAAO,OAAO,KAAK,OAAO,IAAI,IAAI,KAAK,MAAM,CAAC,MAAM,GAAG,EAAE;CAC3D;AACF;;AAcA,SAAgB,cAAc,MAA+F;CAC3H,MAAM,KAAK,MAAM,KAAA,EAAkD;CACnE,IAAI,CAAC,KAAK,OAAO,MAAM,YAAY,CAAC,EAAE,SAAS,CAAC,EAAE,KAAK,OAAO;CAC9D,OAAO;AACT;;AAGA,SAAgB,cAAc,MAAoF;CAChH,MAAM,OAAO,cAAc,IAAI;CAC/B,OAAO,OAAO,eAAe,KAAK,OAAO,KAAK,GAAG,IAAI;AACvD;;;AAIA,SAAgB,YAAY,OAAqB,KAA6B;CAC5E,OAAO;EACL,GAAG,KAAK,IAAI,MAAM,GAAG,IAAI,CAAC;EAC1B,GAAG,KAAK,IAAI,MAAM,GAAG,IAAI,CAAC;EAC1B,OAAO,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC;EAC/B,QAAQ,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC;CAClC;AACF;;AAGA,SAAgB,YAAY,IAAY,OAAe,OAAqB,KAAmD;CAC7H,MAAM,OAAoB,EAAE,SAAS;EAAE,OAAO,EAAE,GAAG,MAAM;EAAG,KAAK,EAAE,GAAG,IAAI;CAAE,EAAE;CAC9E,OAAO;EAAE;EAAI,MAAM;EAAQ;EAAO,QAAQ;EAAM,MAAM,YAAY,OAAO,GAAG;EAAG;CAAK;AACtF;;AAGA,SAAgB,eACd,MACA,OACA,IAC8C;CAC9C,MAAM,OAAO,cAAc,IAAI;CAC/B,IAAI,CAAC,MAAM,OAAO;CAClB,MAAM,OAAO;EAAE,GAAG;GAAO,QAAQ;GAAE,GAAG,GAAG;GAAG,GAAG,GAAG;EAAE;CAAE;CAEtD,OAAO;EAAE;GADmB,GAAI,KAAK;GAAsB,SAAS;EAC3D;EAAM,MAAM,YAAY,KAAK,OAAO,KAAK,GAAG;CAAE;AACzD"}

package/dist/features/modes/modeLayers.js

@@ -4,10 +4,9 @@ import { worldToScreen } from "../../core/viewport/viewTransform.js";
 //#region src/features/modes/modeLayers.ts
 var DEFAULT_INTENSITY = .12;
 /**
-* A screen-space layer painting the active mode's `WorkspaceVisual`: nothing in
-* a mode without a tint, otherwise a wash at the mode's intensity, bottom-up or
-* top-down when the mode names a gradient. It subscribes to the registry, so a
-* mode switch repaints it.
+* A screen-space layer painting the active mode's `WorkspaceVisual`, or the `fallback`'s in a
+* mode without one: a wash at `intensity`, else that visual's own, bottom-up or top-down when it
+* names a gradient.
 */
 function workspaceTintLayer(opts) {
 	const { registry } = opts;
@@ -15,11 +14,19 @@ function workspaceTintLayer(opts) {
 		id: opts.id ?? "mode-tint",
 		label: opts.label ?? "Mode tint",
 		space: "screen",
-		subscribe: registry.subscribe,
+		subscribe: (repaint) => {
+			const offMode = registry.subscribe(repaint);
+			const offFallback = opts.fallback?.subscribe(repaint);
+			return () => {
+				offMode();
+				offFallback?.();
+			};
+		},
 		draw: (_data, view, dims) => {
-			const ws = registry.current().workspace;
+			const own = registry.current().workspace;
+			const ws = own?.tint && own.tint !== "transparent" ? own : opts.fallback?.visual() ?? void 0;
 			const tint = ws?.tint;
-			if (!tint || tint === "transparent") return [];
+			if (!ws || !tint || tint === "transparent") return [];
 			const opacity = opts.intensity ?? ws.intensity ?? DEFAULT_INTENSITY;
 			const { width: W, height: H } = dims;
 			const strip = (x, y, width, height, from, to) => ({

package/dist/features/modes/modeLayers.js.map

@@ -1 +1 @@
-{"version":3,"file":"modeLayers.js","names":[],"sources":["../../../src/features/modes/modeLayers.ts"],"sourcesContent":["import type { Rect } from '@weasel-js/geom';\nimport type { ModeDecorations, ModeRegistry } from '@weasel-js/modes';\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport type { RenderLayer } from 'core/layers/render';\nimport { viewToTransform } from 'core/viewport/view';\nimport { worldToScreen } from 'core/viewport/viewTransform';\n\n/** Options for {@link workspaceTintLayer}. */\nexport interface WorkspaceTintLayerOptions {\n  registry: ModeRegistry;\n  /** The page, in world coordinates. When given, the tint covers only the\n   *  workspace around it, each strip fading toward the page edge if the mode\n   *  names a gradient. Without it the tint covers the whole canvas. */\n  page?: () => Rect | null;\n  /** Opacity for every mode's tint, in place of its `workspace.intensity`. */\n  intensity?: number;\n  id?: string;\n  label?: string;\n}\n\nconst DEFAULT_INTENSITY = 0.12;\n\n/**\n * A screen-space layer painting the active mode's `WorkspaceVisual`: nothing in\n * a mode without a tint, otherwise a wash at the mode's intensity, bottom-up or\n * top-down when the mode names a gradient. It subscribes to the registry, so a\n * mode switch repaints it.\n */\nexport function workspaceTintLayer(opts: WorkspaceTintLayerOptions): RenderLayer<unknown> {\n  const { registry } = opts;\n  return {\n    id: opts.id ?? 'mode-tint',\n    label: opts.label ?? 'Mode tint',\n    space: 'screen',\n    subscribe: registry.subscribe,\n    draw: (_data, view, dims) => {\n      const ws = registry.current().workspace;\n      const tint = ws?.tint;\n      if (!tint || tint === 'transparent') return [];\n      const opacity = opts.intensity ?? ws.intensity ?? DEFAULT_INTENSITY;\n      const { width: W, height: H } = dims;\n\n      const strip = (\n        x: number, y: number, width: number, height: number,\n        from: { x: number; y: number }, to: { x: number; y: number },\n      ): DrawCommand => ({\n        kind: 'path',\n        path: { kind: 'rect', x, y, width, height },\n        fill: { paint: ws.gradient\n          ? { kind: 'linear-gradient', from, to, stops: [{ offset: 0, color: tint }, { offset: 1, color: 'transparent' }], opacity }\n          : { kind: 'solid', color: tint, opacity } },\n      });\n\n      const whole = (): DrawCommand[] => [\n        ws.gradient === 'top-down'\n          ? strip(0, 0, W, H, { x: 0, y: 0 }, { x: 0, y: H })\n          : strip(0, 0, W, H, { x: 0, y: H }, { x: 0, y: 0 }),\n      ];\n\n      const page = opts.page?.();\n      if (!page) return whole();\n\n      const t = viewToTransform(view);\n      const [sx0, sy0] = worldToScreen(page.x, page.y, t);\n      const [sx1, sy1] = worldToScreen(page.x + page.width, page.y + page.height, t);\n      const pl = Math.max(0, Math.min(sx0, sx1));\n      const pt = Math.max(0, Math.min(sy0, sy1));\n      const pr = Math.min(W, Math.max(sx0, sx1));\n      const pb = Math.min(H, Math.max(sy0, sy1));\n      if (pr <= pl || pb <= pt) {\n        return [{ kind: 'path', path: { kind: 'rect', x: 0, y: 0, width: W, height: H }, fill: { paint: { kind: 'solid', color: tint, opacity } } }];\n      }\n\n      const cmds: DrawCommand[] = [];\n      const push = (\n        x: number, y: number, w: number, h: number,\n        from: { x: number; y: number }, to: { x: number; y: number },\n      ): void => { if (w > 0 && h > 0) cmds.push(strip(x, y, w, h, from, to)); };\n      push(0, 0, W, pt, { x: 0, y: 0 }, { x: 0, y: pt });\n      push(0, pb, W, H - pb, { x: 0, y: H }, { x: 0, y: pb });\n      push(0, pt, pl, pb - pt, { x: 0, y: 0 }, { x: pl, y: 0 });\n      push(pr, pt, W - pr, pb - pt, { x: W, y: 0 }, { x: pr, y: 0 });\n      return cmds;\n    },\n  };\n}\n\n/** A world-space layer drawing a `ModeDecorations`' active painter. It\n *  subscribes to the decorations, so a mode switch or a new painter repaints\n *  it. */\nexport function modeDecorationLayer(\n  decorations: ModeDecorations,\n  opts: { id?: string; label?: string } = {},\n): RenderLayer<unknown> {\n  return {\n    id: opts.id ?? 'mode-decorations',\n    label: opts.label ?? 'Mode decorations',\n    subscribe: decorations.subscribe,\n    draw: () => decorations.paint() as DrawCommand[],\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"modeLayers.js","names":[],"sources":["../../../src/features/modes/modeLayers.ts"],"sourcesContent":["import type { Rect } from '@weasel-js/geom';\nimport type { ModeDecorations, ModeRegistry, WorkspaceVisual } from '@weasel-js/modes';\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport type { RenderLayer } from 'core/layers/render';\nimport { viewToTransform } from 'core/viewport/view';\nimport { worldToScreen } from 'core/viewport/viewTransform';\n\n/** Options for {@link workspaceTintLayer}. */\nexport interface WorkspaceTintLayerOptions {\n  registry: ModeRegistry;\n  /** The page, in world coordinates. When given, the tint covers only the\n   *  workspace around it, each strip fading toward the page edge if the mode\n   *  names a gradient. Without it the tint covers the whole canvas. */\n  page?: () => Rect | null;\n  /** Opacity for every mode's tint, in place of its `workspace.intensity`. */\n  intensity?: number;\n  /** The tint shown in a mode with none of its own, and what announces a change to it. */\n  fallback?: { visual: () => WorkspaceVisual | null; subscribe: (fn: () => void) => () => void };\n  id?: string;\n  label?: string;\n}\n\nconst DEFAULT_INTENSITY = 0.12;\n\n/**\n * A screen-space layer painting the active mode's `WorkspaceVisual`, or the `fallback`'s in a\n * mode without one: a wash at `intensity`, else that visual's own, bottom-up or top-down when it\n * names a gradient.\n */\nexport function workspaceTintLayer(opts: WorkspaceTintLayerOptions): RenderLayer<unknown> {\n  const { registry } = opts;\n  return {\n    id: opts.id ?? 'mode-tint',\n    label: opts.label ?? 'Mode tint',\n    space: 'screen',\n    subscribe: (repaint) => {\n      const offMode = registry.subscribe(repaint);\n      const offFallback = opts.fallback?.subscribe(repaint);\n      return () => { offMode(); offFallback?.(); };\n    },\n    draw: (_data, view, dims) => {\n      const own = registry.current().workspace;\n      const ws = own?.tint && own.tint !== 'transparent' ? own : opts.fallback?.visual() ?? undefined;\n      const tint = ws?.tint;\n      if (!ws || !tint || tint === 'transparent') return [];\n      const opacity = opts.intensity ?? ws.intensity ?? DEFAULT_INTENSITY;\n      const { width: W, height: H } = dims;\n\n      const strip = (\n        x: number, y: number, width: number, height: number,\n        from: { x: number; y: number }, to: { x: number; y: number },\n      ): DrawCommand => ({\n        kind: 'path',\n        path: { kind: 'rect', x, y, width, height },\n        fill: { paint: ws.gradient\n          ? { kind: 'linear-gradient', from, to, stops: [{ offset: 0, color: tint }, { offset: 1, color: 'transparent' }], opacity }\n          : { kind: 'solid', color: tint, opacity } },\n      });\n\n      const whole = (): DrawCommand[] => [\n        ws.gradient === 'top-down'\n          ? strip(0, 0, W, H, { x: 0, y: 0 }, { x: 0, y: H })\n          : strip(0, 0, W, H, { x: 0, y: H }, { x: 0, y: 0 }),\n      ];\n\n      const page = opts.page?.();\n      if (!page) return whole();\n\n      const t = viewToTransform(view);\n      const [sx0, sy0] = worldToScreen(page.x, page.y, t);\n      const [sx1, sy1] = worldToScreen(page.x + page.width, page.y + page.height, t);\n      const pl = Math.max(0, Math.min(sx0, sx1));\n      const pt = Math.max(0, Math.min(sy0, sy1));\n      const pr = Math.min(W, Math.max(sx0, sx1));\n      const pb = Math.min(H, Math.max(sy0, sy1));\n      if (pr <= pl || pb <= pt) {\n        return [{ kind: 'path', path: { kind: 'rect', x: 0, y: 0, width: W, height: H }, fill: { paint: { kind: 'solid', color: tint, opacity } } }];\n      }\n\n      const cmds: DrawCommand[] = [];\n      const push = (\n        x: number, y: number, w: number, h: number,\n        from: { x: number; y: number }, to: { x: number; y: number },\n      ): void => { if (w > 0 && h > 0) cmds.push(strip(x, y, w, h, from, to)); };\n      push(0, 0, W, pt, { x: 0, y: 0 }, { x: 0, y: pt });\n      push(0, pb, W, H - pb, { x: 0, y: H }, { x: 0, y: pb });\n      push(0, pt, pl, pb - pt, { x: 0, y: 0 }, { x: pl, y: 0 });\n      push(pr, pt, W - pr, pb - pt, { x: W, y: 0 }, { x: pr, y: 0 });\n      return cmds;\n    },\n  };\n}\n\n/** A world-space layer drawing a `ModeDecorations`' active painter. It\n *  subscribes to the decorations, so a mode switch or a new painter repaints\n *  it. */\nexport function modeDecorationLayer(\n  decorations: ModeDecorations,\n  opts: { id?: string; label?: string } = {},\n): RenderLayer<unknown> {\n  return {\n    id: opts.id ?? 'mode-decorations',\n    label: opts.label ?? 'Mode decorations',\n    subscribe: decorations.subscribe,\n    draw: () => decorations.paint() as DrawCommand[],\n  };\n}\n"],"mappings":"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"}

package/dist/features/modes/modeTriggers.js

@@ -10,9 +10,9 @@ import { modeLabel } from "@weasel-js/modes";
 *
 * The target is the node the dispatcher classified the double-click on (the `hitAt` dep's
 * `doubleClick`, else its hit), the one the binding's `kind:` target matched: a double-click on
-* a grouped member names its outermost group inside `<SceneCanvas isolatedGroup>`. The action is live in every mode, the target mode
-* included, so a double-click on another node moves a mode onto it; `canEnter` and `enter`
-* decide what a switch from the current mode means.
+* a grouped member names its outermost group inside the entered group (`<SceneCanvas enteredGroup>`).
+* The action is live in every mode, the target mode included, so a double-click on another node
+* moves a mode onto it; `canEnter` and `enter` decide what a switch from the current mode means.
 *
 * The bindings ride the ambient tier: a tool that claims the double-click itself, the pen
 * finishing a stroke, keeps it.

package/dist/features/modes/modeTriggers.js.map

@@ -1 +1 @@
-{"version":3,"file":"modeTriggers.js","names":[],"sources":["../../../src/features/modes/modeTriggers.ts"],"sourcesContent":["import { modeLabel, type ModeDefinition, type ModeRegistry } from '@weasel-js/modes';\nimport { ActionDisabledReason, type Action, type ActionDeps, type Contribution } from '@weasel-js/routing';\n\n/** What a mode's double-click trigger does. */\nexport interface ModeTriggerHandlers {\n  /** Enter mode `id` on the node `targetId`. Without it nothing is bound. */\n  enter?: (id: string, targetId: string) => void;\n  /**\n   * Whether mode `id` can be entered on `targetId` now. Where it says no the double-click falls\n   * through to the next binding on it, so a canvas action that already enters the mode on some\n   * of those nodes keeps them: `enterPathEdit` on a path with anchors, say. Default yes.\n   */\n  canEnter?: (id: string, targetId: string) => boolean;\n}\n\n/**\n * The registry's double-click entries as an always-on contribution: for each mode whose\n * `entry.trigger` is `'double-click-target'`, one action bound to a double-click on each routing\n * kind its `entry.targets` names, entering the mode on the node double-clicked. Install it with\n * `<SceneCanvas ambient>`, beside `modeShortcuts`.\n *\n * The target is the node the dispatcher classified the double-click on (the `hitAt` dep's\n * `doubleClick`, else its hit), the one the binding's `kind:` target matched: a double-click on\n * a grouped member names its outermost group inside `<SceneCanvas isolatedGroup>`. The action is live in every mode, the target mode\n * included, so a double-click on another node moves a mode onto it; `canEnter` and `enter`\n * decide what a switch from the current mode means.\n *\n * The bindings ride the ambient tier: a tool that claims the double-click itself, the pen\n * finishing a stroke, keeps it.\n */\nexport function modeTriggers(registry: ModeRegistry, handlers: ModeTriggerHandlers): Contribution<never> {\n  const actions: Action[] = [];\n  const { enter } = handlers;\n  if (enter) {\n    for (const mode of registry.list()) {\n      const targets = mode.entry?.trigger === 'double-click-target' ? mode.entry.targets ?? [] : [];\n      if (targets.length > 0) actions.push(triggerAction(mode, targets, enter, handlers.canEnter));\n    }\n  }\n  return { id: 'modes.triggers', eligibility: { always: true }, actions };\n}\n\nfunction triggerAction(\n  mode: ModeDefinition,\n  targets: readonly string[],\n  enter: (id: string, targetId: string) => void,\n  canEnter: ModeTriggerHandlers['canEnter'],\n): Action {\n  const targetAt = (deps: ActionDeps | undefined, at: { x: number; y: number } | undefined): string | null => {\n    if (!at) return null;\n    const hit = deps?.hitAt?.(at);\n    const id = (hit?.doubleClick ?? hit)?.id;\n    if (id === undefined) return null;\n    return canEnter?.(mode.id, id) === false ? null : id;\n  };\n  const id = `mode.${mode.id}.trigger`;\n  return {\n    id,\n    label: `Enter ${modeLabel(mode)}`,\n    defaultBinding: targets.map((kind) => ({\n      spec: { kind: 'doubleClick' as const, target: `kind:${kind}` as const },\n      opts: { id: `${id}.doubleClick.${kind}` },\n    })),\n    requires: ['hitAt'],\n    enabled: (deps, at) => (targetAt(deps, at) !== null ? true : ActionDisabledReason.NotApplicable),\n    invoker: {\n      timing: 'immediate',\n      run: (deps, params) => {\n        const x = params?.worldX, y = params?.worldY;\n        const id = typeof x === 'number' && typeof y === 'number' ? targetAt(deps, { x, y }) : null;\n        if (id !== null) enter(mode.id, id);\n      },\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,aAAa,UAAwB,UAAoD;CACvG,MAAM,UAAoB,CAAC;CAC3B,MAAM,EAAE,UAAU;CAClB,IAAI,OACF,KAAK,MAAM,QAAQ,SAAS,KAAK,GAAG;EAClC,MAAM,UAAU,KAAK,OAAO,YAAY,wBAAwB,KAAK,MAAM,WAAW,CAAC,IAAI,CAAC;EAC5F,IAAI,QAAQ,SAAS,GAAG,QAAQ,KAAK,cAAc,MAAM,SAAS,OAAO,SAAS,QAAQ,CAAC;CAC7F;CAEF,OAAO;EAAE,IAAI;EAAkB,aAAa,EAAE,QAAQ,KAAK;EAAG;CAAQ;AACxE;AAEA,SAAS,cACP,MACA,SACA,OACA,UACQ;CACR,MAAM,YAAY,MAA8B,OAA4D;EAC1G,IAAI,CAAC,IAAI,OAAO;EAChB,MAAM,MAAM,MAAM,QAAQ,EAAE;EAC5B,MAAM,MAAM,KAAK,eAAe,IAAA,EAAM;EACtC,IAAI,OAAO,QAAW,OAAO;EAC7B,OAAO,WAAW,KAAK,IAAI,EAAE,MAAM,QAAQ,OAAO;CACpD;CACA,MAAM,KAAK,QAAQ,KAAK,GAAG;CAC3B,OAAO;EACL;EACA,OAAO,SAAS,UAAU,IAAI;EAC9B,gBAAgB,QAAQ,KAAK,UAAU;GACrC,MAAM;IAAE,MAAM;IAAwB,QAAQ,QAAQ;GAAgB;GACtE,MAAM,EAAE,IAAI,GAAG,GAAG,eAAe,OAAO;EAC1C,EAAE;EACF,UAAU,CAAC,OAAO;EAClB,UAAU,MAAM,OAAQ,SAAS,MAAM,EAAE,MAAM,OAAO,OAAO,qBAAqB;EAClF,SAAS;GACP,QAAQ;GACR,MAAM,MAAM,WAAW;IACrB,MAAM,IAAI,QAAQ,QAAQ,IAAI,QAAQ;IACtC,MAAM,KAAK,OAAO,MAAM,YAAY,OAAO,MAAM,WAAW,SAAS,MAAM;KAAE;KAAG;IAAE,CAAC,IAAI;IACvF,IAAI,OAAO,MAAM,MAAM,KAAK,IAAI,EAAE;GACpC;EACF;CACF;AACF"}
+{"version":3,"file":"modeTriggers.js","names":[],"sources":["../../../src/features/modes/modeTriggers.ts"],"sourcesContent":["import { modeLabel, type ModeDefinition, type ModeRegistry } from '@weasel-js/modes';\nimport { ActionDisabledReason, type Action, type ActionDeps, type Contribution } from '@weasel-js/routing';\n\n/** What a mode's double-click trigger does. */\nexport interface ModeTriggerHandlers {\n  /** Enter mode `id` on the node `targetId`. Without it nothing is bound. */\n  enter?: (id: string, targetId: string) => void;\n  /**\n   * Whether mode `id` can be entered on `targetId` now. Where it says no the double-click falls\n   * through to the next binding on it, so a canvas action that already enters the mode on some\n   * of those nodes keeps them: `enterPathEdit` on a path with anchors, say. Default yes.\n   */\n  canEnter?: (id: string, targetId: string) => boolean;\n}\n\n/**\n * The registry's double-click entries as an always-on contribution: for each mode whose\n * `entry.trigger` is `'double-click-target'`, one action bound to a double-click on each routing\n * kind its `entry.targets` names, entering the mode on the node double-clicked. Install it with\n * `<SceneCanvas ambient>`, beside `modeShortcuts`.\n *\n * The target is the node the dispatcher classified the double-click on (the `hitAt` dep's\n * `doubleClick`, else its hit), the one the binding's `kind:` target matched: a double-click on\n * a grouped member names its outermost group inside the entered group (`<SceneCanvas enteredGroup>`).\n * The action is live in every mode, the target mode included, so a double-click on another node\n * moves a mode onto it; `canEnter` and `enter` decide what a switch from the current mode means.\n *\n * The bindings ride the ambient tier: a tool that claims the double-click itself, the pen\n * finishing a stroke, keeps it.\n */\nexport function modeTriggers(registry: ModeRegistry, handlers: ModeTriggerHandlers): Contribution<never> {\n  const actions: Action[] = [];\n  const { enter } = handlers;\n  if (enter) {\n    for (const mode of registry.list()) {\n      const targets = mode.entry?.trigger === 'double-click-target' ? mode.entry.targets ?? [] : [];\n      if (targets.length > 0) actions.push(triggerAction(mode, targets, enter, handlers.canEnter));\n    }\n  }\n  return { id: 'modes.triggers', eligibility: { always: true }, actions };\n}\n\nfunction triggerAction(\n  mode: ModeDefinition,\n  targets: readonly string[],\n  enter: (id: string, targetId: string) => void,\n  canEnter: ModeTriggerHandlers['canEnter'],\n): Action {\n  const targetAt = (deps: ActionDeps | undefined, at: { x: number; y: number } | undefined): string | null => {\n    if (!at) return null;\n    const hit = deps?.hitAt?.(at);\n    const id = (hit?.doubleClick ?? hit)?.id;\n    if (id === undefined) return null;\n    return canEnter?.(mode.id, id) === false ? null : id;\n  };\n  const id = `mode.${mode.id}.trigger`;\n  return {\n    id,\n    label: `Enter ${modeLabel(mode)}`,\n    defaultBinding: targets.map((kind) => ({\n      spec: { kind: 'doubleClick' as const, target: `kind:${kind}` as const },\n      opts: { id: `${id}.doubleClick.${kind}` },\n    })),\n    requires: ['hitAt'],\n    enabled: (deps, at) => (targetAt(deps, at) !== null ? true : ActionDisabledReason.NotApplicable),\n    invoker: {\n      timing: 'immediate',\n      run: (deps, params) => {\n        const x = params?.worldX, y = params?.worldY;\n        const id = typeof x === 'number' && typeof y === 'number' ? targetAt(deps, { x, y }) : null;\n        if (id !== null) enter(mode.id, id);\n      },\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,aAAa,UAAwB,UAAoD;CACvG,MAAM,UAAoB,CAAC;CAC3B,MAAM,EAAE,UAAU;CAClB,IAAI,OACF,KAAK,MAAM,QAAQ,SAAS,KAAK,GAAG;EAClC,MAAM,UAAU,KAAK,OAAO,YAAY,wBAAwB,KAAK,MAAM,WAAW,CAAC,IAAI,CAAC;EAC5F,IAAI,QAAQ,SAAS,GAAG,QAAQ,KAAK,cAAc,MAAM,SAAS,OAAO,SAAS,QAAQ,CAAC;CAC7F;CAEF,OAAO;EAAE,IAAI;EAAkB,aAAa,EAAE,QAAQ,KAAK;EAAG;CAAQ;AACxE;AAEA,SAAS,cACP,MACA,SACA,OACA,UACQ;CACR,MAAM,YAAY,MAA8B,OAA4D;EAC1G,IAAI,CAAC,IAAI,OAAO;EAChB,MAAM,MAAM,MAAM,QAAQ,EAAE;EAC5B,MAAM,MAAM,KAAK,eAAe,IAAA,EAAM;EACtC,IAAI,OAAO,QAAW,OAAO;EAC7B,OAAO,WAAW,KAAK,IAAI,EAAE,MAAM,QAAQ,OAAO;CACpD;CACA,MAAM,KAAK,QAAQ,KAAK,GAAG;CAC3B,OAAO;EACL;EACA,OAAO,SAAS,UAAU,IAAI;EAC9B,gBAAgB,QAAQ,KAAK,UAAU;GACrC,MAAM;IAAE,MAAM;IAAwB,QAAQ,QAAQ;GAAgB;GACtE,MAAM,EAAE,IAAI,GAAG,GAAG,eAAe,OAAO;EAC1C,EAAE;EACF,UAAU,CAAC,OAAO;EAClB,UAAU,MAAM,OAAQ,SAAS,MAAM,EAAE,MAAM,OAAO,OAAO,qBAAqB;EAClF,SAAS;GACP,QAAQ;GACR,MAAM,MAAM,WAAW;IACrB,MAAM,IAAI,QAAQ,QAAQ,IAAI,QAAQ;IACtC,MAAM,KAAK,OAAO,MAAM,YAAY,OAAO,MAAM,WAAW,SAAS,MAAM;KAAE;KAAG;IAAE,CAAC,IAAI;IACvF,IAAI,OAAO,MAAM,MAAM,KAAK,IAAI,EAAE;GACpC;EACF;CACF;AACF"}