@weasel-js/core 1.14.2 → 1.15.1

package/CHANGELOG.md

@@ -1,5 +1,256 @@
 # Changelog
 
+## 1.15.1
+
+### Patch Changes
+
+- 424ba52: The Smudge brush, the Simplify brush, a warp's control drag, and Warp Settings can be the last operation, their
+  settings changed after the fact in the last-operation panel. A brush stroke replays every dab from its start with the
+  new Size, Strength or Tolerance; text the Smudge brush converted is put back and converted again wherever the brush
+  at its new size meets it. A warp drag replays with the warp remade under the new Mode, Rows, Columns, Mapping or
+  Tolerance, the control moved as it was first, so an envelope's new grid is resampled from the mesh the drag bent.
+  Warp Settings shows only the settings a run changed. Each stays one undo entry.
+  
+  A tool's options and its action's panel are one setting: `ActionTuning.keep` is handed the params a panel change set,
+  and the tuning `<SceneCanvas>` makes from `toolOptionValues` writes them back there, so an options row shows the
+  values the next stroke uses. `OngoingHandle.params` reports params a gesture took from what it edited rather than
+  from its binding, such as a held warp's own grid, which the panel shows and replay receives. A gesture that opens a
+  journal as it starts is now kept as the last operation. `SMUDGE_BRUSH_PARAMS` and `SIMPLIFY_BRUSH_PARAMS` are the
+  forms the brushes' options use, and `warpDragParams`, `configureWarpParams`, and `WARP_SETTING_FIELDS` the warps'.
+- 9515681: A marquee or lasso now selects at the depth a click does. A hit inside a group that isn't entered selects the outermost such group, not the marks inside it. `AreaSelectDep` and `LassoSelectDep` take an optional `targetOf(id)` for this, and `<SceneCanvas>` wires it from the entered group.
+  
+  A clone's selection outline now lands on its ghost under a parent away from the origin. A previewed pose is read in the frame the node is stored in, as the ghost and the published overrides read it. The scene adapter gains `worldOfStored(id, stored)` to carry it to world, and `getEffectivePose` now answers world during a preview as well as after it.
+- 5e66a10: A unit scope can declare the magnification its frame is drawn at: `units: { system, drawnAt: 0.4 }` on a node
+  whose scale `transform` draws its children at 0.4×. The declaration draws nothing; it says what the transform is
+  meant to be, so lengths read on screen can be divided back to the size they were modeled at.
+  
+  - `magnificationOf(scopes)` (quantity) multiplies the chain's `drawnAt`; `sceneMagnification(scene, ids)` and
+    `sceneDeclaredScopes(scene, id)` (core) read it off a scene.
+  - Equal-spacing snap marks and `distanceReadout` divide their lengths by the declared magnification of the nodes
+    they measure.
+  - `undeclaredMagnifications(scene)` (core) lists every container under a declared scope whose children are drawn
+    at a size its scopes do not declare, and `SceneCanvas` warns once per container in development: a container
+    drawn at 1.5× with nothing declaring it is what turns a 20″ cabinet into 30″ of board.
+  - `scaleBar` (quantity) picks a round length for a frame's scopes, and `<ScaleBar>` (ui) draws it, labeled in the
+    frame's own units and saying what size the frame is drawn at.
+- 2992b55: Dependency updates: `@msb235/blits` 0.16.1 (core, animator, clock, labkit), `earcut` 3.2.4 (core, geom's peer
+  range, labkit), `react-aria` 3.53.1 and `react-aria-components` 1.22.1 (ui), and `magic-string` 1.4.5, `oxc-parser`
+  0.156.0 and `unplugin` 3.7.0 (icons-plugin). geom's `earcut` peer is an exact pin, so a consumer installing geom
+  beside its own `earcut` needs 3.2.4.
+- 8ad43af: A core `Page` can carry `meta`: values other packages keep on the page, each under its owner's key. Every page edit
+  (`addPage`, `removePage`, `movePage`, `resizePage`, `renamePage`, `setPages`) and `layoutPages` carry it, and undo
+  restores it with the page.
+  
+  `documentSpecs` writes a graph page's `notation`, `layout`, and `direction` to its page's `meta['diagram:graph']`, and
+  `documentFromScene` reads them back, so a Mermaid class, state, C4, block, or other non-flowchart page drawn into a
+  scene exports as the same kind, a block diagram keeps its columns, spans, and spaces, and a flowchart keeps its
+  direction. `GRAPH_PAGE_META_KEY`, `graphPageSettingsOf`, and `GraphPageSettings` are exported. This adds API.
+- 120420a: `reconcileSpecs` now puts siblings in `next`'s order wherever a parent's children there differ from `prev`'s, by an addition or a reorder. A node added among existing siblings used to land after all of them, so it could paint above a node `next` listed after it. A reorder made in the scene still stands while `next` keeps the same order, and a child no spec names keeps its place.
+- e982d8a: A selection never holds a node together with its descendant: a selected node holds its whole subtree, which counts as selected and can't be selected on its own. The scene's selection keeps only the outermost of the ids written to it, whichever order they come in, and drops a node moved under a selected one. `<SceneCanvas>` applies the same rule to a `selection` kept off the scene, on every write the canvas makes. Selecting a group whose child is selected replaces the child with the group, and Shift-clicking a child of a selected group leaves the selection as it was.
+  
+  `@weasel-js/select` adds `outermost(ids, parentOf)`, the ids no ancestor among them holds, and `holderOf(selected, id, parentOf)`, the selected id that holds `id`: itself or its nearest selected ancestor.
+- Updated dependencies [d2110bc]
+- Updated dependencies [424ba52]
+- Updated dependencies [5e66a10]
+- Updated dependencies [2992b55]
+- Updated dependencies [3105d13]
+- Updated dependencies [027c59a]
+- Updated dependencies [8b52282]
+- Updated dependencies [937167e]
+- Updated dependencies [9c051bd]
+- Updated dependencies [b6a97f4]
+- Updated dependencies [e982d8a]
+- Updated dependencies [fa1c9a7]
+- Updated dependencies [13b0604]
+  - @weasel-js/font@1.15.1
+  - @weasel-js/text@1.15.1
+  - @weasel-js/routing@1.15.1
+  - @weasel-js/quantity@1.15.1
+  - @weasel-js/geom@1.15.1
+  - @weasel-js/animator@1.15.1
+  - @weasel-js/gestures@1.15.1
+  - @weasel-js/ui-logic@1.15.1
+  - @weasel-js/prefs@1.15.1
+  - @weasel-js/select@1.15.1
+  - @weasel-js/renderer@1.15.1
+  - @weasel-js/text-dom@1.15.1
+  - @weasel-js/stroke@1.15.1
+  - @weasel-js/simulation@1.15.1
+  - @weasel-js/cursor@1.15.1
+  - @weasel-js/history@1.15.1
+  - @weasel-js/icons@1.15.1
+  - @weasel-js/modes@1.15.1
+  - @weasel-js/paint@1.15.1
+  - @weasel-js/react@1.15.1
+  - @weasel-js/registry@1.15.1
+
+## 1.15.0
+
+### Minor Changes
+
+- 48b6c4c: <!-- bump-approved: minor: maintainer — 1.15.0 release requested 2026-10-31 -->
+  
+  An action can declare its params as a form, `Action.params` (a `@weasel-js/prefs` group of labels, ranges, steps,
+  and defaults). An immediate run of such an action that commits one history entry becomes the actions tree's last
+  operation, read with `useLastOperation()` / `useLastOperationStore()` (or `lastOperationOf(registry)`). Its
+  `adjust(patch)` undoes that entry, puts back the selection the run started from, reruns the action with the patch
+  over the values it used, and keeps the new entry in place of the old one, so the history still holds one entry. Any
+  other history step, an undo or redo, or `dismiss()` clears it. The values last used become the action's params for
+  the rest of the session, under any tuning. Core publishes a `selectionSnapshot` dep that captures the node selection
+  and the anchor selection together, which the rerun restores.
+  
+  `@weasel-js/ui` adds `<LastOperationPanel>`, which draws the last operation as a form titled with the command's label,
+  adjusting it on each change and dismissing it from its close button; it renders nothing while there is none.
+  
+  `bridgePaths` and `bridgeAnchors` declare their Tension (`BRIDGE_PARAMS`), `resamplePath` its count, spacing, corners,
+  and tolerance (`RESAMPLE_PARAMS`), and `addExtremeAnchors` a new Turns param (`ADD_EXTREMES_PARAMS`). `resamplePath`
+  is now an immediate command committing one entry, where it was an ongoing action previewed through `begin`: code
+  driving it with `useOngoingAction` must trigger it instead. `addExtremeAnchors` takes `params.axes` — `'xy'` (the
+  default), `'x'`, or `'y'` — and geom's `segmentExtremaTs` and `addExtremaAnchors` take the same choice as a last
+  argument (`ExtremaAxes`).
+
+### Patch Changes
+
+- 8461e7b: `NodeGates.hidden` and `NodeGates.locked` take the node itself as well as its id, and answer the same for
+  either; a walk that already holds the node saves looking it up. The pick walk now hands them its
+  candidates, decides a marquee from a node's bounds before building anything to test its outline, and no
+  longer allocates per candidate. Scene edits and history pushes allocate less per op. No result changes.
+- 70a64a3: Tools can declare options: `ToolDef.options` names the action they are params of, a prefs group of number leaves
+  (their bounds and defaults), and which one is the tool's size and which its strength. `<SceneCanvas>` tunes the
+  action from the values the host keeps in the new `toolOptionValues` dep (`ToolOptionValues`, published with
+  `useToolOptionValues`; `createToolOptionValues` keeps them in memory). `defineTool` adds step actions for the size
+  and strength, bound to `[` `]` and `Shift+[` `Shift+]` while the tool is the active one, so they win over the same keys'
+  anchor-selection commands only then.
+  
+  The Smudge brush (`SMUDGE_BRUSH_OPTIONS`: size, strength) and the Simplify brush (`SIMPLIFY_BRUSH_OPTIONS`: size,
+  tolerance) declare theirs. Size steps by ×1.25; the Smudge brush's strength by 0.1, the Simplify brush's tolerance by
+  ×1.25.
+- f77e789: A canvas left to fill its parent now shows its new size, painted, in the frame its parent resized in, rather than
+  one frame late at the old size. `<Canvas>`, `<SceneCanvas>`, `<DrawCanvas>`, and `<SceneViewCanvas>` also paint a
+  commit that changes their size in place instead of on the next frame. `useElementSize` and `useCanvasSize` take
+  `{ beforePaint: true }` to render their caller with a new size inside the `ResizeObserver` callback; it suits only a
+  caller whose render lays out nothing outside the observed element, since the browser reports anything else that
+  resizes there as a loop error. Without it the size arrives in a task after the callback, as before. A canvas's
+  `onResize` now fires from a passive effect.
+- 0e60598: Drawing a polygon or a star leaves the last-operation panel up with its sides, or its points and inner radius
+  (`insertParams`, `POLYGON_INSERT_PARAMS`, `STAR_INSERT_PARAMS`); a change redraws the shape in place from the same
+  drag, as one undo entry. A drag that insert behaviors answered gets no panel. The star's "Inner" property row is now
+  "Inner radius". The scene's history answers `activeJournal()`, and its journals `observe`, so the last operation
+  follows edits into an open journal, such as path edit's.
+- a1cb281: Images drawn at half their size or smaller are now smoothed through mipmaps by default: `imageMinification` defaults
+  to `'auto'` on `WeaselRenderer` and `<Canvas>`, which builds an image's mipmaps the first time a frame draws the whole of
+  it that small. This changes the pixels of every image drawn small; pass `imageMinification: 'linear'` for the old
+  single-tap look. A draw with `source` and a `sprites` run never sample mipmaps, under any mode, so a sprite-sheet cell
+  drawn small no longer takes color from the cells beside it under `'mipmap'` or `'auto'`.
+- c41c917: Path edit's tools are ordinary tools, and a mode can name the tool it starts on.
+  
+  **Breaking:** the `pathEditTool.*` toggle actions (`pathEditToolAction`, `exitPathEditToolAction`,
+  `pathEditToolActive`, `simplifyBrushToolAction`, `lengthenToolAction`, `SIMPLIFY_BRUSH_TOOL`, `LENGTHEN_TOOL`) are
+  removed, as are the `editAnchors` dep's `tool` and `setTool`, `PathEditHost`'s `tool` and `setTool`, and
+  `AnchorState.tool`. The `simplifyBrush` and `lengthenPath` actions no longer bind a drag themselves: mount
+  `useSimplifyBrushTool` and `useLengthenTool` (or `usePathEditTools`, named by `PATH_EDIT_TOOLS`; `usePathToolsTools`
+  includes them), each carrying `edits-anchors`. Their bindings sit at the active tier, so they outrank anchor
+  editing's ambient drags; a Lengthen drag on an anchor that is no open end falls through to moving it.
+  
+  `ModeDefinition.defaultTool` names the tool a mode starts on: entering the mode activates it, leaving restores the
+  tool active at entry, and Escape with another tool on returns to it before a second Escape leaves: a mode shortcut's
+  `exit` and `cancel` and core's `exitPathEdit` each call `returnToModeDefault` first, reading the new `modeDefaultTool`
+  dep `<SceneCanvas>` sources. `PATH_EDIT` names core's new `anchors` tool (key A, glyph `core:anchors`), which the
+  `pathEdit` preset mounts and `ANCHOR_TOOLS` names; it binds nothing and holds path edit's active slot. The pointer
+  cursor over an anchor or handle is now `editAnchors`' own `cursor`, so a path-edit tool's cursor shows there.
+  
+  A `chromeRules` dep, which `<SceneCanvas>` sources, reads and sets chrome-visibility rules at run time. The toggles
+  `pathEdit.show.direction`, `.comb`, `.balance`, and `.corners` (group `pathOverlays`) use it to flip each overlay
+  between `always` and `never`, and come with the preset that draws it.
+  
+  `ToolPalette` takes `ineligible: 'dim' | 'hide'`, default `dim`; `hide` leaves out every tool the current mode does
+  not allow. The Girth tool's palette group is now `path`, beside Trim, Extend, and the Smudge brush.
+  
+  In the dev server and under vitest, `weaselIcons` in app mode stops looking for tables at the nearest workspace root
+  above the app, and reads that workspace's packages' source tables. It used to walk on into an enclosing checkout's
+  `node_modules` (a git worktree sits inside its main checkout), so a worktree served that checkout's glyphs: a glyph
+  added on the branch drew as "?", and one redrawn there drew as before.
+- d25ad30: A runs array can now be refilled in place. `clearRuns(runs)` in `@weasel-js/text` forgets what the layout and
+  paint caches hold for it while leaving it filed, `resolveRunsInto(out, runs, style)` resolves into an array the
+  caller owns, rewriting each run object whose optional fields match, and `textCommandFromRunsInto(cmd, …)` in
+  `@weasel-js/renderer` refills a text command and its runs. Core re-exports all three.
+  
+  A HUD text widget now keeps one command and one runs array for its life and refills them when its text, color
+  or family changes, so a readout rewritten every frame no longer allocates a command, its runs, or a cache
+  entry per label. What its `draw` returned shows the widget's current text rather than a snapshot of the
+  text it had then.
+- 1de1aab: The Smudge brush now smudges text: a text node it may push (selected, or any unlocked, shown one while nothing is
+  selected) is converted to outlines, as Create Outlines does, the moment the brush touches it, and its paths are
+  smudged from then on. Conversion and smudge are one undo entry labeled "Smudge brush", and Escape mid-stroke puts the
+  text back. Text whose face has no outlines is left alone, and the user is told once per stroke. In a host with no
+  `createOutlinesAdapter` dep, text is skipped. A selected group is now smudged as its path leaves.
+  
+  `applyCreateOutlines(adapter, ids?)` converts the given text nodes rather than only the selection.
+  
+  A journal can now open inside another (`Journal.beginJournal`), and `scene.history.beginJournal` opens inside the
+  journal edits are going to when there is one, so a gesture journaled during a mode lands in the mode's journal as one
+  entry. A journal opened on `scene.history` now takes the scene's `applyBatch` edits without an active-journal accessor.
+  
+  New `notices` dep (`NoticesDep`, published with `useNotices`): where an action tells the user something went wrong.
+  Create Outlines, Outline Stroke, Pathfinder, and the Smudge brush report text they cannot outline through it, and fall
+  back to the console without it.
+- fce0494: A node can now declare points of its own that a move snaps, through `<SceneCanvas snap={{ anchors }}>`
+  or `createSnapSession2d({ anchors })`: a function from a node id to points in that node's box frame,
+  such as a cabinet's hanger holes. Each becomes a probe of the new role `'anchor'`, offered only to a
+  source whose `roles` list it, so a grid can land the holes on a pegboard's while alignment and spacing
+  keep measuring the box.
+- 746fab0: The warp tools (Distort, Envelope, Puppet Warp) now work on a selected group: one set of controls is laid around all
+  of its paths, and they warp together. Selected text converts to outlines when a warp begins on it (a drag on the fresh
+  controls, or a pin placed), conversion and warp landing as one undo step; canceling the drag puts the text back, and
+  text whose face has no outlines is left alone with a notice. While a warp tool is active, the selection's resize and
+  rotation handles no longer draw over its controls or take its presses.
+  
+  New `ToolDef.hides`: chrome ids hidden, in paint and hit-test alike, while that tool is the active one (carried to
+  rules as `RuleCtx.hiddenChrome`).
+- Updated dependencies [2bdba7b]
+- Updated dependencies [8461e7b]
+- Updated dependencies [70a64a3]
+- Updated dependencies [3f13a49]
+- Updated dependencies [719d457]
+- Updated dependencies [d40f593]
+- Updated dependencies [81a1b94]
+- Updated dependencies [b7d362d]
+- Updated dependencies [a95d3a4]
+- Updated dependencies [e05ddd3]
+- Updated dependencies [30bf607]
+- Updated dependencies [35f0277]
+- Updated dependencies [48b6c4c]
+- Updated dependencies [a1cb281]
+- Updated dependencies [2e2f76c]
+- Updated dependencies [c41c917]
+- Updated dependencies [fbc7ebf]
+- Updated dependencies [d25ad30]
+- Updated dependencies [1de1aab]
+- Updated dependencies [fce0494]
+- Updated dependencies [51ca29e]
+- Updated dependencies [746fab0]
+  - @weasel-js/renderer@1.15.0
+  - @weasel-js/history@1.15.0
+  - @weasel-js/routing@1.15.0
+  - @weasel-js/font@1.15.0
+  - @weasel-js/text@1.15.0
+  - @weasel-js/geom@1.15.0
+  - @weasel-js/modes@1.15.0
+  - @weasel-js/stroke@1.15.0
+  - @weasel-js/text-dom@1.15.0
+  - @weasel-js/animator@1.15.0
+  - @weasel-js/headless@1.15.0
+  - @weasel-js/gestures@1.15.0
+  - @weasel-js/cursor@1.15.0
+  - @weasel-js/icons@1.15.0
+  - @weasel-js/paint@1.15.0
+  - @weasel-js/prefs@1.15.0
+  - @weasel-js/quantity@1.15.0
+  - @weasel-js/react@1.15.0
+  - @weasel-js/registry@1.15.0
+  - @weasel-js/select@1.15.0
+  - @weasel-js/simulation@1.15.0
+
 ## 1.14.2
 
 ### Patch Changes

package/dist/WeaselProvider.js

@@ -1,11 +1,11 @@
-import { PointerProviderIfRoot } from "./canvas/SceneCanvas/PointerProviderIfRoot.js";
-import { ActionsProviderIfRoot } from "./canvas/SceneCanvas/ActionsProviderIfRoot.js";
-import { DepRegistryProviderIfRoot } from "./canvas/SceneCanvas/DepRegistryProviderIfRoot.js";
 import { IconRegistryScope } from "./iconRegistry/IconRegistryProvider.js";
+import { DepRegistryProviderIfRoot } from "./canvas/SceneCanvas/DepRegistryProviderIfRoot.js";
+import { ActionsProviderIfRoot } from "./canvas/SceneCanvas/ActionsProviderIfRoot.js";
+import { PointerProviderIfRoot } from "./canvas/SceneCanvas/PointerProviderIfRoot.js";
 import { jsx } from "react/jsx-runtime";
 import { ActionsProvider, ActiveToolContextProvider, ActiveToolContextProviderIfRoot, DepRegistryProvider, PointerContextProvider, SelectionContextProvider, SelectionContextProviderIfRoot } from "@weasel-js/routing/react";
 
-//#region src/WeaselProvider.tsx
+// src/WeaselProvider.tsx
 /**
 * Mounts every kit-wide provider at once — deps, actions, active tool,
 * selection, and pointer — each only if one is not already in scope, or
@@ -24,6 +24,5 @@ function WeaselProvider({ children, isolate = false, icons, iconVariants }) {
 	});
 }
 
-//#endregion
 export { WeaselProvider };
 //# sourceMappingURL=WeaselProvider.js.map

package/dist/affordances/composeAffordanceLayer.js

@@ -4,7 +4,7 @@ import { angleOf, isRigid, localToWorld, pxExtentIn, targetCorners } from "../co
 import { annulusSemiAxes, hitAffordanceRegions, pointRegionAnchor, pointRegionFrame, pointRegionLive, pointRegionScreenQuad, transformOf } from "./hitAffordanceRegions.js";
 import { PATH_L, PATH_M, PATH_Z, boundsOfPath } from "@weasel-js/geom";
 
-//#region src/affordances/composeAffordanceLayer.ts
+// src/affordances/composeAffordanceLayer.ts
 /**
 * Bundle a list of Affordances into a single RenderLayer.
 *
@@ -294,6 +294,5 @@ function worldOf(region, xf, view) {
 	};
 }
 
-//#endregion
 export { composeAffordanceLayer };
 //# sourceMappingURL=composeAffordanceLayer.js.map

package/dist/affordances/cornerResize.js

@@ -1,10 +1,10 @@
-import { HANDLE_BASE_PX } from "../core/device/targets.js";
-import { angleOf, localToWorld } from "../core/geometry/targetFrame.js";
 import { RESIZE_HANDLE_ANCHORS, fixedCornerOf, handlePoint, isCornerHandle } from "../interactions/actions/resize/cornerHandles.js";
-import { transformOf } from "./hitAffordanceRegions.js";
+import { angleOf, localToWorld } from "../core/geometry/targetFrame.js";
 import { MULTI_RESIZE_TARGET_ID } from "../core/selection/selectionTarget.js";
+import { transformOf } from "./hitAffordanceRegions.js";
+import { HANDLE_BASE_PX } from "../core/device/targets.js";
 
-//#region src/affordances/cornerResize.ts
+// src/affordances/cornerResize.ts
 var DEFAULT_FILL = "#d4c4a8";
 var DEFAULT_STROKE = "#1a130d";
 /**
@@ -115,6 +115,5 @@ function pickRenderTarget(state) {
 	return null;
 }
 
-//#endregion
 export { createCornerResizeAffordance };
 //# sourceMappingURL=cornerResize.js.map

package/dist/affordances/hitAffordanceRegions.js

@@ -2,7 +2,7 @@ import { IDENTITY_TARGET, angleOf, localToWorld, normalToWorld, pxExtentIn, targ
 import { edgeHandlesFit } from "../interactions/actions/resize/cornerHandles.js";
 import { multiply, scale, scaleDelta, screenAngleOf, standoff, strokeHitTest } from "@weasel-js/geom";
 
-//#region src/affordances/hitAffordanceRegions.ts
+// src/affordances/hitAffordanceRegions.ts
 /**
 * Walk affordances for a world-space hit, topmost first.
 *
@@ -173,6 +173,5 @@ function hitRegion(region, wx, wy, xf, view) {
 	return local.x >= r.x && local.x <= r.x + r.width && local.y >= r.y && local.y <= r.y + r.height;
 }
 
-//#endregion
 export { angleOf, annulusSemiAxes, hitAffordanceRegions, localToWorld, pointRegionAnchor, pointRegionFrame, pointRegionLive, pointRegionScreenQuad, transformOf };
 //# sourceMappingURL=hitAffordanceRegions.js.map

package/dist/affordances/pathAnchors.js

@@ -1,7 +1,7 @@
 import { enumerateAnchors } from "../interactions/actions/edit-anchors/geometry.js";
 import { pathToAnchors } from "@weasel-js/geom";
 
-//#region src/affordances/pathAnchors.ts
+// src/affordances/pathAnchors.ts
 /** Chrome-caps id gating the anchor, control, and segment affordances. */
 var PATH_ANCHOR_CHROME_ID = "path-edit.anchors";
 /**
@@ -46,7 +46,6 @@ function createPathAnchorAffordances(getAnchorState, opts = {}) {
 			hitRadiusPx: hitRadius
 		},
 		hitKind,
-		...getAnchorState()?.tool ? {} : { cursor },
 		bind: () => ({ initialScratch: {
 			...scratch,
 			targetId
@@ -162,6 +161,5 @@ function withEdited(selection, editingId) {
 	return editingId === null || selection.includes(editingId) ? selection : [...selection, editingId];
 }
 
-//#endregion
 export { PATH_ANCHOR_CHROME_ID, createPathAnchorAffordances };
 //# sourceMappingURL=pathAnchors.js.map

package/dist/affordances/pathAnchors.js.map

@@ -1 +1 @@
-{"version":3,"file":"pathAnchors.js","names":[],"sources":["../../src/affordances/pathAnchors.ts"],"sourcesContent":["/** Path anchor, control-handle, and segment affordances, and the parts path-edit extensions add. */\n\nimport type { CursorSpec } from '@weasel-js/cursor';\nimport type { Affordance, AffordanceBinding, AffordanceRegion, CommonAffordanceScratch } from './types';\nimport type { ChromeState } from 'core/selection/chromeState';\nimport { pathToAnchors, type AnchorSet, type PolygonPath } from '@weasel-js/geom';\nimport { enumerateAnchors } from 'interactions/actions/edit-anchors/geometry';\nimport type { PathEditExtension } from 'domains/paths/pathEditExtension';\n\n/**\n * Live anchor-editing state. The thunk that returns it is called on every\n * pointer event, so it must be cheap (O(1) field reads).\n */\nexport interface AnchorState {\n  /** Id of the path currently in anchor-edit mode, or `null`. Control handles\n   *  are only hittable on the path that is being edited. */\n  editingId: string | null;\n  /** Current editable path for a node id. Non-polygon values are ignored. */\n  getPose(id: string): unknown;\n  /** The committed pose and data of a node, which extensions' parts read. */\n  getNode?(id: string): { pose: unknown; data: unknown } | null;\n  /** The path-edit extensions whose parts are pressed, in order. */\n  extensions?: readonly PathEditExtension[];\n  /** The active path-edit tool, if any. While one is set, anchors and controls\n   *  carry no cursor of their own, so the tool's action shows its own. */\n  tool?: string | null;\n  /** The path whose outline counts as a segment press, when it is not\n   *  `getPose`'s: a path drawn from a form, edited through the form's edit\n   *  path. */\n  getOutline?(id: string): unknown;\n}\n\n/** Options for the path-anchor affordances. */\nexport interface PathAnchorAffordanceOptions {\n  /** Hit radius (screen-px) for anchor and control points. Default 8. */\n  hitRadius?: number;\n  /** Cursor while hovering an anchor or control, with no path-edit tool\n   *  active. Defaults to `'pointer'`. */\n  cursor?: CursorSpec;\n}\n\n/** What an anchor hit hands to the action that follows. */\nexport interface AnchorScratch extends CommonAffordanceScratch {\n  /** Node id of the path the anchor belongs to. */\n  targetId: string;\n  /** Sequential anchor index in path walk order. */\n  anchorIndex: number;\n  /** Which of the anchor's three grabbable points this is. */\n  part: 'anchor' | 'controlIn' | 'controlOut';\n}\n\n/** Chrome-caps id gating the anchor, control, and segment affordances. */\nexport const PATH_ANCHOR_CHROME_ID = 'path-edit.anchors';\n\n/**\n * Segment, extension-part, anchor, and control affordances for the selected\n * paths, bottom → top.\n *\n * Three affordances rather than one, so that a control handle beats an anchor\n * regardless of which is nearer, the way controls draw on top, and both beat\n * the segment they sit on. Within each, nearest wins. A press on the edited\n * path's outline is a `segment` hit, which the segment bend binds to and a\n * selection move turns down. Anchors, controls, and segments share one id:\n * chrome-caps gates anchor editing as a single piece of chrome. A part a\n * path-edit extension adds (`PathEditExtension.parts`) may name a chrome id of\n * its own as well, so it can be shown apart from the anchors.\n *\n * Order matters — spread this into an affordance list in the returned order.\n */\nexport function createPathAnchorAffordances(\n  getAnchorState: () => AnchorState | null,\n  opts: PathAnchorAffordanceOptions = {},\n): Affordance[] {\n  const { hitRadius = 8, cursor = 'pointer' } = opts;\n\n  /** Selected polygon paths, and the one being edited, paired with their node id. */\n  const editablePaths = (state: ChromeState): Array<{ id: string; path: PolygonPath }> => {\n    const anchorState = getAnchorState();\n    if (!anchorState) return [];\n    const out: Array<{ id: string; path: PolygonPath }> = [];\n    for (const id of withEdited(state.selection, anchorState.editingId)) {\n      const pose = anchorState.getPose(id);\n      if (!pose || (pose as { kind?: string }).kind !== 'polygon') continue;\n      out.push({ id, path: pose as PolygonPath });\n    }\n    return out;\n  };\n\n  const point = (\n    id: string,\n    targetId: string,\n    x: number,\n    y: number,\n    scratch: AnchorScratch,\n    hitKind: string,\n  ): AffordanceRegion => ({\n    id,\n    // Anchor coordinates are already world space, pose rotation baked in.\n    // Anchoring to `null` keeps the framework from applying it twice.\n    targetId: null,\n    shape: { kind: 'point', x, y, hitRadiusPx: hitRadius },\n    hitKind,\n    ...(getAnchorState()?.tool ? {} : { cursor }),\n    bind: (): AffordanceBinding => ({ initialScratch: { ...scratch, targetId } }),\n  });\n\n  const anchors: Affordance = {\n    id: PATH_ANCHOR_CHROME_ID,\n    regions(state) {\n      const editingId = getAnchorState()?.editingId ?? null;\n      const out: AffordanceRegion[] = [];\n      for (const { id, path } of editablePaths(state)) {\n        // `editAnchorsAction` edits whatever path the dep says is in edit\n        // mode, ignoring which one was hit — so once a path IS being edited,\n        // only its own anchors may claim the press.\n        if (editingId !== null && id !== editingId) continue;\n        for (const a of enumerateAnchors(path)) {\n          out.push(point(\n            `${id}:anchor:${a.anchorIndex}`,\n            id, a.x, a.y,\n            { targetId: id, anchorIndex: a.anchorIndex, part: 'anchor' },\n            `anchor:${a.anchorIndex}`,\n          ));\n        }\n      }\n      return out;\n    },\n  };\n\n  const controls: Affordance = {\n    id: PATH_ANCHOR_CHROME_ID,\n    regions(state) {\n      const anchorState = getAnchorState();\n      const editingId = anchorState?.editingId ?? null;\n      if (editingId === null) return [];\n      const out: AffordanceRegion[] = [];\n      for (const { id, path } of editablePaths(state)) {\n        // Controls are grabbable only on the path actually in edit mode.\n        if (id !== editingId) continue;\n        for (const a of enumerateAnchors(path)) {\n          if (a.controlIn) {\n            out.push(point(\n              `${id}:controlIn:${a.anchorIndex}`,\n              id, a.controlIn.x, a.controlIn.y,\n              { targetId: id, anchorIndex: a.anchorIndex, part: 'controlIn' },\n              `controlIn:${a.anchorIndex}`,\n            ));\n          }\n          if (a.controlOut) {\n            out.push(point(\n              `${id}:controlOut:${a.anchorIndex}`,\n              id, a.controlOut.x, a.controlOut.y,\n              { targetId: id, anchorIndex: a.anchorIndex, part: 'controlOut' },\n              `controlOut:${a.anchorIndex}`,\n            ));\n          }\n        }\n      }\n      return out;\n    },\n  };\n\n  const segments: Affordance = {\n    id: PATH_ANCHOR_CHROME_ID,\n    regions(state) {\n      const editingId = getAnchorState()?.editingId ?? null;\n      if (editingId === null) return [];\n      const edited = editablePaths(state).find(({ id }) => id === editingId);\n      if (!edited) return [];\n      const outline = getAnchorState()?.getOutline?.(editingId) as PolygonPath | null | undefined;\n      return [{\n        id: `${editingId}:segment`,\n        targetId: null,\n        shape: { kind: 'outline', path: outline?.kind === 'polygon' ? outline : edited.path, hitRadiusPx: hitRadius },\n        hitKind: 'segment',\n        bind: (): AffordanceBinding => ({ initialScratch: { targetId: editingId } }),\n      }];\n    },\n  };\n\n  return [segments, extensionParts(getAnchorState, hitRadius, cursor), anchors, controls];\n}\n\n/** The parts path-edit extensions add to the path in edit mode, each pressed\n *  as its own `hitKind`. */\nfunction extensionParts(\n  getAnchorState: () => AnchorState | null,\n  hitRadius: number,\n  cursor: CursorSpec,\n): Affordance {\n  return {\n    id: PATH_ANCHOR_CHROME_ID,\n    regions() {\n      const anchorState = getAnchorState();\n      const editingId = anchorState?.editingId ?? null;\n      const extensions = anchorState?.extensions?.filter((e) => e.parts) ?? [];\n      if (editingId === null || extensions.length === 0) return [];\n      const pose = anchorState!.getPose(editingId);\n      const node = anchorState!.getNode?.(editingId);\n      if (!node || !pose || (pose as { kind?: string }).kind !== 'polygon') return [];\n      const target = {\n        id: editingId, node, path: pose as PolygonPath, anchors: pathToAnchors(pose as PolygonPath) as AnchorSet,\n      };\n      return extensions.flatMap((ext) => ext.parts!(target).map((part): AffordanceRegion => ({\n        id: `${editingId}:${part.hitKind}`,\n        targetId: null,\n        shape: {\n          kind: 'point', x: part.x, y: part.y, hitRadiusPx: part.hitRadiusPx ?? hitRadius,\n          ...(part.standoff ? { standoff: part.standoff } : {}),\n        },\n        hitKind: part.hitKind,\n        ...(part.chromeId ? { chromeId: part.chromeId } : {}),\n        cursor,\n        bind: (): AffordanceBinding => ({ initialScratch: { targetId: editingId } }),\n      })));\n    },\n  };\n}\n\n/** `selection`, and the path being edited after it when the selection does not hold it: a path edited through the\n *  effect that hides it is edited while the effect is what is selected. */\nfunction withEdited(selection: readonly string[], editingId: string | null): readonly string[] {\n  return editingId === null || selection.includes(editingId) ? selection : [...selection, editingId];\n}\n"],"mappings":"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"}
+{"version":3,"file":"pathAnchors.js","names":[],"sources":["../../src/affordances/pathAnchors.ts"],"sourcesContent":["/** Path anchor, control-handle, and segment affordances, and the parts path-edit extensions add. */\n\nimport type { CursorSpec } from '@weasel-js/cursor';\nimport type { Affordance, AffordanceBinding, AffordanceRegion, CommonAffordanceScratch } from './types';\nimport type { ChromeState } from 'core/selection/chromeState';\nimport { pathToAnchors, type AnchorSet, type PolygonPath } from '@weasel-js/geom';\nimport { enumerateAnchors } from 'interactions/actions/edit-anchors/geometry';\nimport type { PathEditExtension } from 'domains/paths/pathEditExtension';\n\n/**\n * Live anchor-editing state. The thunk that returns it is called on every\n * pointer event, so it must be cheap (O(1) field reads).\n */\nexport interface AnchorState {\n  /** Id of the path currently in anchor-edit mode, or `null`. Control handles\n   *  are only hittable on the path that is being edited. */\n  editingId: string | null;\n  /** Current editable path for a node id. Non-polygon values are ignored. */\n  getPose(id: string): unknown;\n  /** The committed pose and data of a node, which extensions' parts read. */\n  getNode?(id: string): { pose: unknown; data: unknown } | null;\n  /** The path-edit extensions whose parts are pressed, in order. */\n  extensions?: readonly PathEditExtension[];\n  /** The path whose outline counts as a segment press, when it is not\n   *  `getPose`'s: a path drawn from a form, edited through the form's edit\n   *  path. */\n  getOutline?(id: string): unknown;\n}\n\n/** Options for the path-anchor affordances. */\nexport interface PathAnchorAffordanceOptions {\n  /** Hit radius (screen-px) for anchor and control points. Default 8. */\n  hitRadius?: number;\n  /** Cursor while hovering a part a path-edit extension adds. Defaults to\n   *  `'pointer'`. Anchors and controls carry none: the action a drag on one\n   *  would start shows its own, `editAnchors`' pointer or a path-edit tool's. */\n  cursor?: CursorSpec;\n}\n\n/** What an anchor hit hands to the action that follows. */\nexport interface AnchorScratch extends CommonAffordanceScratch {\n  /** Node id of the path the anchor belongs to. */\n  targetId: string;\n  /** Sequential anchor index in path walk order. */\n  anchorIndex: number;\n  /** Which of the anchor's three grabbable points this is. */\n  part: 'anchor' | 'controlIn' | 'controlOut';\n}\n\n/** Chrome-caps id gating the anchor, control, and segment affordances. */\nexport const PATH_ANCHOR_CHROME_ID = 'path-edit.anchors';\n\n/**\n * Segment, extension-part, anchor, and control affordances for the selected\n * paths, bottom → top.\n *\n * Three affordances rather than one, so that a control handle beats an anchor\n * regardless of which is nearer, the way controls draw on top, and both beat\n * the segment they sit on. Within each, nearest wins. A press on the edited\n * path's outline is a `segment` hit, which the segment bend binds to and a\n * selection move turns down. Anchors, controls, and segments share one id:\n * chrome-caps gates anchor editing as a single piece of chrome. A part a\n * path-edit extension adds (`PathEditExtension.parts`) may name a chrome id of\n * its own as well, so it can be shown apart from the anchors.\n *\n * Order matters — spread this into an affordance list in the returned order.\n */\nexport function createPathAnchorAffordances(\n  getAnchorState: () => AnchorState | null,\n  opts: PathAnchorAffordanceOptions = {},\n): Affordance[] {\n  const { hitRadius = 8, cursor = 'pointer' } = opts;\n\n  /** Selected polygon paths, and the one being edited, paired with their node id. */\n  const editablePaths = (state: ChromeState): Array<{ id: string; path: PolygonPath }> => {\n    const anchorState = getAnchorState();\n    if (!anchorState) return [];\n    const out: Array<{ id: string; path: PolygonPath }> = [];\n    for (const id of withEdited(state.selection, anchorState.editingId)) {\n      const pose = anchorState.getPose(id);\n      if (!pose || (pose as { kind?: string }).kind !== 'polygon') continue;\n      out.push({ id, path: pose as PolygonPath });\n    }\n    return out;\n  };\n\n  const point = (\n    id: string,\n    targetId: string,\n    x: number,\n    y: number,\n    scratch: AnchorScratch,\n    hitKind: string,\n  ): AffordanceRegion => ({\n    id,\n    // Anchor coordinates are already world space, pose rotation baked in.\n    // Anchoring to `null` keeps the framework from applying it twice.\n    targetId: null,\n    shape: { kind: 'point', x, y, hitRadiusPx: hitRadius },\n    hitKind,\n    bind: (): AffordanceBinding => ({ initialScratch: { ...scratch, targetId } }),\n  });\n\n  const anchors: Affordance = {\n    id: PATH_ANCHOR_CHROME_ID,\n    regions(state) {\n      const editingId = getAnchorState()?.editingId ?? null;\n      const out: AffordanceRegion[] = [];\n      for (const { id, path } of editablePaths(state)) {\n        // `editAnchorsAction` edits whatever path the dep says is in edit\n        // mode, ignoring which one was hit — so once a path IS being edited,\n        // only its own anchors may claim the press.\n        if (editingId !== null && id !== editingId) continue;\n        for (const a of enumerateAnchors(path)) {\n          out.push(point(\n            `${id}:anchor:${a.anchorIndex}`,\n            id, a.x, a.y,\n            { targetId: id, anchorIndex: a.anchorIndex, part: 'anchor' },\n            `anchor:${a.anchorIndex}`,\n          ));\n        }\n      }\n      return out;\n    },\n  };\n\n  const controls: Affordance = {\n    id: PATH_ANCHOR_CHROME_ID,\n    regions(state) {\n      const anchorState = getAnchorState();\n      const editingId = anchorState?.editingId ?? null;\n      if (editingId === null) return [];\n      const out: AffordanceRegion[] = [];\n      for (const { id, path } of editablePaths(state)) {\n        // Controls are grabbable only on the path actually in edit mode.\n        if (id !== editingId) continue;\n        for (const a of enumerateAnchors(path)) {\n          if (a.controlIn) {\n            out.push(point(\n              `${id}:controlIn:${a.anchorIndex}`,\n              id, a.controlIn.x, a.controlIn.y,\n              { targetId: id, anchorIndex: a.anchorIndex, part: 'controlIn' },\n              `controlIn:${a.anchorIndex}`,\n            ));\n          }\n          if (a.controlOut) {\n            out.push(point(\n              `${id}:controlOut:${a.anchorIndex}`,\n              id, a.controlOut.x, a.controlOut.y,\n              { targetId: id, anchorIndex: a.anchorIndex, part: 'controlOut' },\n              `controlOut:${a.anchorIndex}`,\n            ));\n          }\n        }\n      }\n      return out;\n    },\n  };\n\n  const segments: Affordance = {\n    id: PATH_ANCHOR_CHROME_ID,\n    regions(state) {\n      const editingId = getAnchorState()?.editingId ?? null;\n      if (editingId === null) return [];\n      const edited = editablePaths(state).find(({ id }) => id === editingId);\n      if (!edited) return [];\n      const outline = getAnchorState()?.getOutline?.(editingId) as PolygonPath | null | undefined;\n      return [{\n        id: `${editingId}:segment`,\n        targetId: null,\n        shape: { kind: 'outline', path: outline?.kind === 'polygon' ? outline : edited.path, hitRadiusPx: hitRadius },\n        hitKind: 'segment',\n        bind: (): AffordanceBinding => ({ initialScratch: { targetId: editingId } }),\n      }];\n    },\n  };\n\n  return [segments, extensionParts(getAnchorState, hitRadius, cursor), anchors, controls];\n}\n\n/** The parts path-edit extensions add to the path in edit mode, each pressed\n *  as its own `hitKind`. */\nfunction extensionParts(\n  getAnchorState: () => AnchorState | null,\n  hitRadius: number,\n  cursor: CursorSpec,\n): Affordance {\n  return {\n    id: PATH_ANCHOR_CHROME_ID,\n    regions() {\n      const anchorState = getAnchorState();\n      const editingId = anchorState?.editingId ?? null;\n      const extensions = anchorState?.extensions?.filter((e) => e.parts) ?? [];\n      if (editingId === null || extensions.length === 0) return [];\n      const pose = anchorState!.getPose(editingId);\n      const node = anchorState!.getNode?.(editingId);\n      if (!node || !pose || (pose as { kind?: string }).kind !== 'polygon') return [];\n      const target = {\n        id: editingId, node, path: pose as PolygonPath, anchors: pathToAnchors(pose as PolygonPath) as AnchorSet,\n      };\n      return extensions.flatMap((ext) => ext.parts!(target).map((part): AffordanceRegion => ({\n        id: `${editingId}:${part.hitKind}`,\n        targetId: null,\n        shape: {\n          kind: 'point', x: part.x, y: part.y, hitRadiusPx: part.hitRadiusPx ?? hitRadius,\n          ...(part.standoff ? { standoff: part.standoff } : {}),\n        },\n        hitKind: part.hitKind,\n        ...(part.chromeId ? { chromeId: part.chromeId } : {}),\n        cursor,\n        bind: (): AffordanceBinding => ({ initialScratch: { targetId: editingId } }),\n      })));\n    },\n  };\n}\n\n/** `selection`, and the path being edited after it when the selection does not hold it: a path edited through the\n *  effect that hides it is edited while the effect is what is selected. */\nfunction withEdited(selection: readonly string[], editingId: string | null): readonly string[] {\n  return editingId === null || selection.includes(editingId) ? selection : [...selection, editingId];\n}\n"],"mappings":"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"}

package/dist/affordances/rotateCursor.js

@@ -1,4 +1,4 @@
-//#region src/affordances/rotateCursor.ts
+// src/affordances/rotateCursor.ts
 /**
 * The `rotate` glyph for a pointer at world point `at` turning something
 * about world point `pivot`, seen through a view of `scale`. The glyph's arc
@@ -13,6 +13,5 @@ function rotateCursorAt(pivot, at, scale) {
 	};
 }
 
-//#endregion
 export { rotateCursorAt };
 //# sourceMappingURL=rotateCursor.js.map

package/dist/affordances/rotationHandle.js

@@ -1,9 +1,9 @@
 import { localToWorld } from "../core/geometry/targetFrame.js";
-import { transformOf } from "./hitAffordanceRegions.js";
 import { MULTI_RESIZE_TARGET_ID } from "../core/selection/selectionTarget.js";
+import { transformOf } from "./hitAffordanceRegions.js";
 import { rotateCursorAt } from "./rotateCursor.js";
 
-//#region src/affordances/rotationHandle.ts
+// src/affordances/rotationHandle.ts
 var isAnnulusForm = (paint) => "fill" in paint || "stroke" in paint || "insetPx" in paint;
 var DEFAULT_PAINT = {
 	fill: { paint: {
@@ -119,6 +119,5 @@ function pickTarget(state) {
 	return null;
 }
 
-//#endregion
 export { createRotationAffordance };
 //# sourceMappingURL=rotationHandle.js.map

package/dist/animation/behaviors/coast.js

@@ -1,4 +1,4 @@
-//#region src/animation/behaviors/coast.ts
+// src/animation/behaviors/coast.ts
 var nextCoast = 0;
 /** A cancel key no other coast holds. */
 var coastKey = () => `momentum:${nextCoast++}`;
@@ -22,6 +22,5 @@ function clampCorner(bounds, x, y) {
 	};
 }
 
-//#endregion
 export { clampCorner, coastKey, sameBounds };
 //# sourceMappingURL=coast.js.map

package/dist/animation/behaviors/coastByWrite.js

@@ -1,8 +1,8 @@
-import { translatePoseViaDescriptor } from "../../core/geometry/poseDescriptor.js";
 import { createTransformOp } from "../../core/ops/transform.js";
+import { translatePoseViaDescriptor } from "../../core/geometry/poseDescriptor.js";
 import { clampCorner, coastKey, sameBounds } from "./coast.js";
 
-//#region src/animation/behaviors/coastByWrite.ts
+// src/animation/behaviors/coastByWrite.ts
 /**
 * A coast over an adapter with no pose targets: one decay of the flick's travel, written to
 * every node it carries each frame, through `previewPoses` where the adapter has it and
@@ -130,6 +130,5 @@ function coastByWrite(a) {
 	}
 }
 
-//#endregion
 export { coastByWrite };
 //# sourceMappingURL=coastByWrite.js.map

package/dist/animation/behaviors/coastOnTargets.js

@@ -1,9 +1,9 @@
-import { translatePoseViaDescriptor } from "../../core/geometry/poseDescriptor.js";
 import { createTransformOp } from "../../core/ops/transform.js";
+import { translatePoseViaDescriptor } from "../../core/geometry/poseDescriptor.js";
 import { poseKey } from "../poseHelpers.js";
 import { clampCorner, coastKey, sameBounds } from "./coast.js";
 
-//#region src/animation/behaviors/coastOnTargets.ts
+// src/animation/behaviors/coastOnTargets.ts
 /** A world velocity as the rate of change of a pose at `at`. */
 function poseVelocity(ax, d, at, vx, vy) {
 	const base = ax.to(at);
@@ -137,6 +137,5 @@ function coastOnTargets(a, targets) {
 	for (const r of [...riders.values()]) launch(r, ctx.current.get(r.id), a.vx, a.vy);
 }
 
-//#endregion
 export { coastOnTargets };
 //# sourceMappingURL=coastOnTargets.js.map

package/dist/animation/behaviors/momentum.js

@@ -3,7 +3,7 @@ import { coastByWrite } from "./coastByWrite.js";
 import { coastOnTargets } from "./coastOnTargets.js";
 import { getScratch, scratchKey, setScratch } from "@weasel-js/routing";
 
-//#region src/animation/behaviors/momentum.ts
+// src/animation/behaviors/momentum.ts
 var SAMPLES = scratchKey("momentum.samples");
 /**
 * Move behavior that keeps a dragged node coasting after the pointer is
@@ -98,6 +98,5 @@ function momentum(opts) {
 	};
 }
 
-//#endregion
 export { momentum };
 //# sourceMappingURL=momentum.js.map

package/dist/animation/clipTargets.js

@@ -1,6 +1,6 @@
 import { scenePoseTarget } from "./poseTarget.js";
 
-//#region src/animation/clipTargets.ts
+// src/animation/clipTargets.ts
 /**
 * A `ClipBinder.target` over a scene. `pose:<node id>` is that node's pose target, the one
 * `scenePoseTarget` answers, and `rig:<name>` is the target of the rig given under that
@@ -14,6 +14,5 @@ function sceneClipTargets(scene, options = {}) {
 	};
 }
 
-//#endregion
 export { sceneClipTargets };
 //# sourceMappingURL=clipTargets.js.map

package/dist/animation/departures.js

@@ -1,7 +1,7 @@
-import { poseAxes } from "./poseTarget.js";
 import { createPoseOverrides } from "../core/scene/poseOverrides.js";
+import { poseAxes } from "./poseTarget.js";
 
-//#region src/animation/departures.ts
+// src/animation/departures.ts
 /** `base`'s poses with an opacity riding beside them, as one more axis. */
 function fadedDescriptor(base) {
 	const lerp = base.lerp;
@@ -111,6 +111,5 @@ function createDepartures() {
 	};
 }
 
-//#endregion
 export { createDepartures, fadedDescriptor };
 //# sourceMappingURL=departures.js.map

package/dist/animation/poseHelpers.js

@@ -1,8 +1,8 @@
-import { RECT_POSE_DESCRIPTOR } from "../core/geometry/poseDescriptor.js";
 import { createTransformOp } from "../core/ops/transform.js";
+import { RECT_POSE_DESCRIPTOR } from "../core/geometry/poseDescriptor.js";
 import { rewindingSpring, rewindingTween } from "./rewind.js";
 
-//#region src/animation/poseHelpers.ts
+// src/animation/poseHelpers.ts
 /** The cancel key every move of node `id`'s pose shares. */
 var poseKey = (id) => `pose:${id}`;
 function recordTransformOp(adapter, id, from, to, label) {
@@ -164,6 +164,5 @@ function staggerSpringPose(animator, adapter, opts) {
 	});
 }
 
-//#endregion
 export { poseKey, springPose, staggerSpringPose, tweenPose };
 //# sourceMappingURL=poseHelpers.js.map

package/dist/animation/poseTarget.js

@@ -1,8 +1,8 @@
-import { documentPose } from "../core/scene/effectivePose.js";
 import { RECT_POSE_DESCRIPTOR } from "../core/geometry/poseDescriptor.js";
+import { documentPose } from "../core/scene/effectivePose.js";
 import { axesOf, createTarget } from "@weasel-js/animator";
 
-//#region src/animation/poseTarget.ts
+// src/animation/poseTarget.ts
 /** How `like`'s kind of pose maps to axes: the descriptor's own mapping, else its flat numeric
 *  fields. Null for a pose with neither. */
 function poseAxes(descriptor, like) {
@@ -187,6 +187,5 @@ function scenePoseTarget(scene, id, descriptor) {
 	return target;
 }
 
-//#endregion
 export { createPoseTarget, liveAxes, poseAxes, scenePoseTarget };
 //# sourceMappingURL=poseTarget.js.map

package/dist/animation/poseTransition.js

@@ -2,7 +2,7 @@ import { createDepartures } from "./departures.js";
 import { useEffect, useMemo } from "react";
 import { useLatest } from "@weasel-js/react";
 
-//#region src/animation/poseTransition.ts
+// src/animation/poseTransition.ts
 /**
 * The writes a {@link PoseTransitionSeat} glides unless told otherwise: a
 * direct scene call, an undo, and a redo. An action's commit (`'ops'`) is
@@ -59,6 +59,5 @@ function usePoseTransition(scene, seat) {
 	return departures;
 }
 
-//#endregion
 export { bindPoseTransition, glidesByDefault, usePoseTransition };
 //# sourceMappingURL=poseTransition.js.map

package/dist/animation/reflow.js

@@ -1,11 +1,11 @@
-import { documentPose, effectivePose } from "../core/scene/effectivePose.js";
 import { RECT_POSE_DESCRIPTOR } from "../core/geometry/poseDescriptor.js";
+import { documentPose, effectivePose } from "../core/scene/effectivePose.js";
 import { liveAxes } from "./poseTarget.js";
 import { useEffect, useMemo } from "react";
 import { useLatest } from "@weasel-js/react";
 import { createTarget } from "@weasel-js/animator";
 
-//#region src/animation/reflow.ts
+// src/animation/reflow.ts
 /** The animator's cancel-key for one node's glide. */
 var keyFor = (id) => `reflow:${id}`;
 function samePose(a, b) {
@@ -231,6 +231,5 @@ function useAnimatedReflow(scene, animator, opts) {
 	return reflow;
 }
 
-//#endregion
 export { createReflowTransition, useAnimatedReflow };
 //# sourceMappingURL=reflow.js.map