@weasel-js/core 1.15.0 → 1.15.2

package/CHANGELOG.md

@@ -1,5 +1,204 @@
 # Changelog
 
+## 1.15.2
+
+### Patch Changes
+
+- 946faff: `clampMove({ bounds })` from `@weasel-js/core/move` is a move behavior that keeps the dragged nodes inside a
+  world rect: the drag's translation is clamped so the box around every dragged node stays in `bounds`, in
+  the preview and the commit alike. `bounds` can be a function, read each frame, for a rect that changes
+  size.
+- 507f539: paint exports `relativeLuminance` and `luminanceContrast`, the WCAG luminance and ratio `contrastRatio` is built on; core re-exports both. theme's `luminance`/`contrast`, its test helpers, ui's painted-contrast helpers and forge's pixel contrast readout now use them.
+  
+  Color strings that theme's `withAlpha`/`atAlpha`, ui's `TokenPanel` hex conversion and diagram-formats' DOT and Mermaid writers read are parsed by paint's `parseColor`. The `TokenPanel` color input now converts float and percent `rgb()` channels, named colors and `hsl()` without a browser, and diagram-formats writes percent `rgb()` channels as hex instead of passing them through. diagram-formats now depends on `@weasel-js/paint`.
+  
+  labkit's loupe and ui's `Timeline` ruler and lane graph measure their element with core's `useElementSize`.
+- a4138b6: `@weasel-js/geom` states the nearest point of a segment, point distance and lerp once, in any
+  dimension, and every tier answers through that one rule.
+  
+  - `@weasel-js/geom/nd` adds `segmentT`, `closestPointOnSegment`, `pointSegmentDist`,
+    `pointSegmentDist2`, `distance`, `distance2` and `lerp` over plain number arrays.
+  - The root barrel adds `segmentT` and `pointSegmentDist` over loose scalars, which allocate nothing,
+    beside the existing `pointSegmentDist2`; `distance`, `distance2` and `lerpPoint` over `Point`; and a
+    scalar `lerp`.
+  - `@weasel-js/geom/3d`'s `closestPointOnSegment` and `lerp` now go through the same rule, so a planar
+    problem gets the same numbers in 2D, 3D and `nd`.
+  
+  A segment's parameter is clamped to [0, 1] and is 0 on a zero-length segment; at `t = 1` the nearest
+  point is the far end exactly. `nearestOnLine` and the private copies in core's measurement hit test,
+  animator's auto-skinning, diagram's route and label code, stroke's edge test, path-tools'
+  extend-to-meet and guides' layout snaps now call these, so their distances can move by a rounding
+  step (`Math.hypot` became a square root of the summed squares).
+  
+  Corner shapes (`cornerShapePieces`) now fit the true superellipse within `CORNER_FIT_TOLERANCE` for
+  every finite `k`. Past `|k| ≈ 9` they strayed up to nine times the tolerance off the curve's straight
+  legs, because the fit stepped in an angle that crowds those legs into less than a double resolves;
+  it now steps evenly along each leg. The same corners draw with about a third fewer cubics.
+- f1906a8: The rest of the kit's stores notify through registry's `createEmitter`: the entered group, the snap
+  outcome, devtools roots and transports, kit settings, the menu host and menu controller, tool
+  options, `RunSlots`, the seam preview, the HUD list, the effect runners, the symmetry controller,
+  the devtools client, and forge's loupe and CSS-variable stores. A listener that throws is logged
+  and no longer stops the others, and a listener unsubscribed mid-notify is no longer called; the
+  menu host, `RunSlots` and the HUD list used to walk their live set. diagram, diagram-formats, menu,
+  symmetry and devtools now depend on `@weasel-js/registry`.
+  
+  Structural comparisons that went through `JSON.stringify` use `deepEqual` instead, so key order no
+  longer makes two equal values differ (theme baking, diagram export's style diffs, trial marks, path
+  constraints, unit rows, toolbar dock drops). PrefSchemaEditor's three-way merge keeps
+  `JSON.stringify`, because there a reordered key is an edit.
+  
+  New: `sameList(a, b, same?)` in `@weasel-js/registry`, whether two lists hold equal elements in
+  order. `@weasel-js/react`'s `sameList` is now this function, and ui's `samePath` is an alias of it.
+- e804540: **Behavior change:** `matchesKeyBinding` and `historyKey` now read `mod` the way `@weasel-js/gestures`
+  does: Command on an Apple platform, Ctrl elsewhere, and the other key forbidden. Before, either key
+  fired a `mod` binding on every platform, so Ctrl+Z undid on a Mac and Cmd+Z undid on Windows; now
+  neither does, and neither does Cmd+Ctrl+Z. Both take an optional `isMac` argument, defaulting to
+  `isApplePlatform()`. Everything built on them follows: labkit's trial chrome and `useUndoKeys`, and
+  the undo keys in `AssetEditor`, `LayeredCurveEditor` and forge's CSS-vars panel. A trial's snapshot
+  chord is Mod+S alone; Shift+Mod+S no longer takes a snapshot.
+  
+  `rowKey` takes a sixth argument, `apple`, and selects all on Mod+A as above; Ctrl+A on a Mac no
+  longer selects all in a `Tree` or any list on `useRowNavigation`, which passes `isApplePlatform()`.
+  `rowKey` called without it reads `mod` as Ctrl.
+  
+  `@weasel-js/react` reads the system color scheme: `systemColorScheme()`, `watchColorScheme(fn)` and
+  `useSystemColorScheme(follow?)`, with `DEFAULT_COLOR_SCHEME`, dark, wherever `matchMedia` is missing or
+  the system states no preference. Dark is the mode the theme's tokens paint at `:root`. theme's
+  `useResolvedColorMode`, core's `watchThemeOf` and forge's loupe conditions use it. **Behavior change:**
+  forge's loupe read a missing `matchMedia` as light; it now reads it as dark, as the theme always has.
+  
+  `scene.mintId()`, and the id `add` gives a spec with none, now pass over any id the scene already
+  holds. A document reopened in a new session keeps the ids the last one minted, and a `generateId` that
+  starts over with the session could mint them again; a generator that gives 1000 taken ids in a row
+  throws.
+- 2f6b10d: `usePublishPointer(elementRef, locate)` from `@weasel-js/core` publishes the pointer over an element into
+  the pointer store in scope, placed by `locate(pointerId, clientX, clientY)`. It is what `<SceneCanvas>`
+  does for its own canvas: a pointer pressed on the element keeps reporting once a drag leaves it, and a
+  free pointer leaving clears the store unless another view has published since. The minimap and labkit's
+  cameras now publish through it, so a drag that runs off a minimap or a lab stage no longer stops
+  reporting where the pointer is.
+- 5f6111b: `@weasel-js/geom` exports `viewWorldToScreen(view, p)`, `viewScreenToWorld(view, p)` and
+  `viewRectToScreen(view, rect)`, which convert between world and screen through a `View` directly;
+  `@weasel-js/core` re-exports them. Core, guides, diagram, hud, labkit and path-tools now use them in
+  place of their own inline copies of the same arithmetic.
+  
+  Under a flipped view (a negative `scale` axis), diagram overlays, labkit lens hit boxes and the
+  path-edit marquee now get a rect with a positive width and height. labkit's camera zoom keeps a
+  flipped axis flipped instead of turning it back to positive.
+- Updated dependencies [507f539]
+- Updated dependencies [c6edab2]
+- Updated dependencies [a4138b6]
+- Updated dependencies [5a0375b]
+- Updated dependencies [f1906a8]
+- Updated dependencies [e804540]
+- Updated dependencies [6544399]
+- Updated dependencies [5f6111b]
+  - @weasel-js/paint@1.15.2
+  - @weasel-js/geom@1.15.2
+  - @weasel-js/animator@1.15.2
+  - @weasel-js/stroke@1.15.2
+  - @weasel-js/react@1.15.2
+  - @weasel-js/routing@1.15.2
+  - @weasel-js/registry@1.15.2
+  - @weasel-js/text@1.15.2
+  - @weasel-js/ui-logic@1.15.2
+  - @weasel-js/prefs@1.15.2
+  - @weasel-js/renderer@1.15.2
+  - @weasel-js/text-dom@1.15.2
+  - @weasel-js/simulation@1.15.2
+  - @weasel-js/gestures@1.15.2
+  - @weasel-js/cursor@1.15.2
+  - @weasel-js/font@1.15.2
+  - @weasel-js/history@1.15.2
+  - @weasel-js/icons@1.15.2
+  - @weasel-js/modes@1.15.2
+  - @weasel-js/select@1.15.2
+  - @weasel-js/quantity@1.15.2
+
+## 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

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";
 /**
@@ -161,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/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) {
@@ -112,7 +112,7 @@ function createPoseTarget(opts) {
 }
 var sceneTargets = /* @__PURE__ */ new WeakMap();
 /** Whether two poses hold the same fields, compared without allocating: a running target asks on every publish. */
-function samePose(a, b) {
+function samePoseShallow(a, b) {
 	if (a === b) return true;
 	if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) return false;
 	const ra = a;
@@ -169,7 +169,7 @@ function scenePoseTarget(scene, id, descriptor) {
 			if (!n) return;
 			writing = true;
 			try {
-				if (!samePose(n.pose, pose)) scene.untracked(() => scene.setPose(nid, pose));
+				if (!samePoseShallow(n.pose, pose)) scene.untracked(() => scene.setPose(nid, pose));
 			} finally {
 				writing = false;
 			}
@@ -180,13 +180,12 @@ function scenePoseTarget(scene, id, descriptor) {
 	}, () => {
 		if (writing) return false;
 		const n = scene.get(nid);
-		return !!n && mine !== void 0 && !samePose(n.pose, mine);
+		return !!n && mine !== void 0 && !samePoseShallow(n.pose, mine);
 	});
 	if (!target) return void 0;
 	made.set(id, target);
 	return target;
 }
 
-//#endregion
 export { createPoseTarget, liveAxes, poseAxes, scenePoseTarget };
 //# sourceMappingURL=poseTarget.js.map

package/dist/animation/poseTarget.js.map

@@ -1 +1 @@
-{"version":3,"file":"poseTarget.js","names":[],"sources":["../../src/animation/poseTarget.ts"],"sourcesContent":["import { RECT_POSE_DESCRIPTOR, type PoseDescriptor } from '../core/geometry/poseDescriptor';\nimport { documentPose, type PoseSource } from '../core/scene/effectivePose';\nimport type { NodeId, PoseOverride, PoseOverrides } from '../core/scene/types';\nimport { axesOf } from '@weasel-js/animator';\nimport { createTarget, type Target, type TargetAxes } from '@weasel-js/animator';\n\n/** What {@link createPoseTarget} takes. */\nexport interface PoseTargetOptions<TPose> {\n  /** The node whose pose it is. */\n  id: string;\n  /** The node's committed pose: where the document says it is. */\n  get(): TPose;\n  /** Commits a pose: an animation's destination as it starts, and where a canceled one stopped. */\n  set(pose: TPose): void;\n  /** Where the pose on screen is published while the node moves. */\n  overrides: PoseOverrides<TPose>;\n  /** Supplies the pose's axes through `PoseDescriptor.axes`. Without one, or where it answers\n   *  null, the pose has to be a number, an array of numbers, or an object of numeric fields. */\n  descriptor?: PoseDescriptor<TPose>;\n}\n\n/** The part of a scene {@link scenePoseTarget} reads and writes. A `Scene` satisfies it. */\nexport interface PoseTargetScene<TPose> extends PoseSource<TPose> {\n  readonly overrides: PoseOverrides<TPose>;\n  setPose(id: NodeId, pose: TPose): void;\n  untracked<T>(fn: () => T): T;\n}\n\n/** How `like`'s kind of pose maps to axes: the descriptor's own mapping, else its flat numeric\n *  fields. Null for a pose with neither. */\nexport function poseAxes<TPose>(\n  descriptor: PoseDescriptor<TPose> | undefined,\n  like: TPose,\n): TargetAxes<TPose> | null {\n  return descriptor?.axes?.(like) ?? (axesOf(like) as TargetAxes<TPose> | null);\n}\n\nconst publishers = new WeakMap<object, () => void>();\n\n/** One function per overrides table, so every target publishing into it shares one commit a frame. */\nfunction publisherOf<TPose>(overrides: PoseOverrides<TPose>): () => void {\n  let publish = publishers.get(overrides);\n  if (!publish) {\n    publish = () => overrides.commit();\n    publishers.set(overrides, publish);\n  }\n  return publish;\n}\n\n/**\n * `poseAxes` for the pose `get` answers, with `from` keeping the fields that are not axes as\n * that pose has them now. Reading them once would leave them stale in every pose a canceled\n * animation commits. Null where the pose has no axes.\n */\nexport function liveAxes<TPose>(\n  descriptor: PoseDescriptor<TPose> | undefined,\n  get: () => TPose,\n): TargetAxes<TPose> | null {\n  let like = get();\n  let axes = poseAxes(descriptor, like);\n  if (!axes) return null;\n  const { count, angles } = axes;\n  const current = (): TargetAxes<TPose> => {\n    const now = get();\n    if (now !== like) {\n      const next = poseAxes(descriptor, now);\n      if (next && next.count === count) axes = next;\n      like = now;\n    }\n    return axes!;\n  };\n  return {\n    count,\n    angles,\n    to: (p) => current().to(p),\n    from: (a) => current().from(a),\n    add: axes.add && ((p, d) => {\n      const now = current();\n      if (now.add) return now.add(p, d);\n      return now.from(now.to(p).map((n, i) => n + d[i]!));\n    }),\n    write: axes.write && ((p, out, at) => {\n      const now = current();\n      if (now.write) now.write(p, out, at);\n      else now.to(p).forEach((n, i) => { out[at + i] = n; });\n    }),\n  };\n}\n\nfunction build<TPose>(\n  opts: PoseTargetOptions<TPose>,\n  onRest?: () => void,\n  /** Whether something else has written the committed pose since an animation last did. */\n  overwritten?: () => boolean,\n): Target<TPose> | null {\n  const { overrides } = opts;\n  const id = opts.id as NodeId;\n  const axes = liveAxes(opts.descriptor, opts.get);\n  if (!axes) return null;\n  const entry: PoseOverride<TPose> = {};\n  let installed = false;\n  /** While installed, stops the run as soon as the table changes after something else wrote\n   *  the pose: a drag laid over the run commits and then lets go, which would show this run's\n   *  last frame until its next one. */\n  let unwatch: (() => void) | null = null;\n  const rest = (): void => {\n    installed = false;\n    unwatch?.();\n    unwatch = null;\n    overrides.clear(id, entry);\n    onRest?.();\n  };\n  const target = createTarget<TPose>({\n    get: opts.get,\n    set: opts.set,\n    axes,\n    show(pose) {\n      // The writer wins: what was left to travel belonged to a pose that is no longer committed.\n      if (target.active && overwritten?.()) target.stop({ commit: false });\n      if (!target.active) {\n        rest();\n        return;\n      }\n      entry.pose = pose;\n      // Reinstalled where it stood if the table dropped it; an override laid over it since, a drag's, is not taken back.\n      if (!overrides.has(id, entry)) overrides.set(id, entry);\n      installed = true;\n      if (overwritten && unwatch === null) {\n        unwatch = overrides.subscribe(() => {\n          if (!target.active || !overwritten()) return;\n          target.stop({ commit: false });\n          if (installed) rest();\n        });\n      }\n    },\n    publish: publisherOf(overrides),\n  });\n  return target;\n}\n\n/**\n * A {@link Target} over one node's pose. Animations on it commit their destination through\n * `set` as they start, and the pose on screen reaches the paint and pick walks as a pose\n * override: installed while the node moves and cleared when it comes to rest.\n *\n * Throws for a pose with no axes. Make one per node: two targets over one node do not add.\n * {@link scenePoseTarget} keeps that one for a scene's nodes.\n */\nexport function createPoseTarget<TPose>(opts: PoseTargetOptions<TPose>): Target<TPose> {\n  const target = build(opts);\n  if (!target) {\n    throw new Error('createPoseTarget: this pose has no axes; give a descriptor whose `axes` maps it');\n  }\n  return target;\n}\n\nconst sceneTargets = new WeakMap<object, Map<string, Target<unknown>>>();\n\n/** Whether two poses hold the same fields, compared without allocating: a running target asks on every publish. */\nfunction samePose(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null) return false;\n  const ra = a as Record<string, unknown>;\n  const rb = b as Record<string, unknown>;\n  let count = 0;\n  for (const k in ra) {\n    if (!Object.hasOwn(ra, k)) continue;\n    if (!Object.hasOwn(rb, k) || ra[k] !== rb[k]) return false;\n    count++;\n  }\n  for (const k in rb) if (Object.hasOwn(rb, k)) count--;\n  return count === 0;\n}\n\n/**\n * The pose target of node `id` in `scene`: the same one on every call, so everything animating\n * the node adds. Its committed value is the node's document pose, written without recording;\n * a caller that wants the move in history records its own op first.\n *\n * Undefined for a node that is not in the scene, or whose pose has no axes. `descriptor`\n * defaults to `RECT_POSE_DESCRIPTOR`, and is read the first time a node's target is made.\n */\nexport function scenePoseTarget<TPose>(\n  scene: PoseTargetScene<TPose>,\n  id: string,\n  descriptor?: PoseDescriptor<TPose>,\n): Target<TPose> | undefined {\n  let made = sceneTargets.get(scene.overrides);\n  if (!made) {\n    made = new Map();\n    sceneTargets.set(scene.overrides, made);\n  }\n  const nid = id as NodeId;\n  const node = scene.get(nid);\n  const by = descriptor ?? (RECT_POSE_DESCRIPTOR as unknown as PoseDescriptor<TPose>);\n  const held = made.get(id) as Target<TPose> | undefined;\n  // A pose that has changed shape at rest, a polygon given more points, needs axes made for it.\n  const fits = !held || held.active || !node\n    || poseAxes(by, documentPose(scene, node))?.count === held.axisCount;\n  if (held && fits) return held;\n  if (!node) return undefined;\n  // A node removed mid-flight keeps answering with the last pose it had.\n  let last = documentPose(scene, node);\n  /** The node's pose as an animation last left it, or as it was when the first one started. */\n  let mine: TPose | undefined;\n  /** While this target's own commit is being written. */\n  let writing = false;\n  const cache = made;\n  let target: Target<TPose> | null = null;\n  target = build<TPose>({\n    id,\n    descriptor: by,\n    overrides: scene.overrides,\n    get() {\n      const n = scene.get(nid);\n      if (n) last = documentPose(scene, n);\n      if (n && !target?.active) mine = n.pose;\n      return last;\n    },\n    set(pose) {\n      const n = scene.get(nid);\n      if (!n) return;\n      // The write runs the layout's reflow at once, and a reflow publishes glides to the overrides.\n      writing = true;\n      try {\n        if (!samePose(n.pose, pose)) scene.untracked(() => scene.setPose(nid, pose));\n      } finally {\n        writing = false;\n      }\n      mine = scene.get(nid)?.pose;\n    },\n  }, () => {\n    if (!scene.get(nid)) cache.delete(id);\n  }, () => {\n    if (writing) return false;\n    const n = scene.get(nid);\n    return !!n && mine !== undefined && !samePose(n.pose, mine);\n  });\n  if (!target) return undefined;\n  made.set(id, target as Target<unknown>);\n  return target;\n}\n"],"mappings":"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"}
+{"version":3,"file":"poseTarget.js","names":[],"sources":["../../src/animation/poseTarget.ts"],"sourcesContent":["import { RECT_POSE_DESCRIPTOR, type PoseDescriptor } from '../core/geometry/poseDescriptor';\nimport { documentPose, type PoseSource } from '../core/scene/effectivePose';\nimport type { NodeId, PoseOverride, PoseOverrides } from '../core/scene/types';\nimport { axesOf } from '@weasel-js/animator';\nimport { createTarget, type Target, type TargetAxes } from '@weasel-js/animator';\n\n/** What {@link createPoseTarget} takes. */\nexport interface PoseTargetOptions<TPose> {\n  /** The node whose pose it is. */\n  id: string;\n  /** The node's committed pose: where the document says it is. */\n  get(): TPose;\n  /** Commits a pose: an animation's destination as it starts, and where a canceled one stopped. */\n  set(pose: TPose): void;\n  /** Where the pose on screen is published while the node moves. */\n  overrides: PoseOverrides<TPose>;\n  /** Supplies the pose's axes through `PoseDescriptor.axes`. Without one, or where it answers\n   *  null, the pose has to be a number, an array of numbers, or an object of numeric fields. */\n  descriptor?: PoseDescriptor<TPose>;\n}\n\n/** The part of a scene {@link scenePoseTarget} reads and writes. A `Scene` satisfies it. */\nexport interface PoseTargetScene<TPose> extends PoseSource<TPose> {\n  readonly overrides: PoseOverrides<TPose>;\n  setPose(id: NodeId, pose: TPose): void;\n  untracked<T>(fn: () => T): T;\n}\n\n/** How `like`'s kind of pose maps to axes: the descriptor's own mapping, else its flat numeric\n *  fields. Null for a pose with neither. */\nexport function poseAxes<TPose>(\n  descriptor: PoseDescriptor<TPose> | undefined,\n  like: TPose,\n): TargetAxes<TPose> | null {\n  return descriptor?.axes?.(like) ?? (axesOf(like) as TargetAxes<TPose> | null);\n}\n\nconst publishers = new WeakMap<object, () => void>();\n\n/** One function per overrides table, so every target publishing into it shares one commit a frame. */\nfunction publisherOf<TPose>(overrides: PoseOverrides<TPose>): () => void {\n  let publish = publishers.get(overrides);\n  if (!publish) {\n    publish = () => overrides.commit();\n    publishers.set(overrides, publish);\n  }\n  return publish;\n}\n\n/**\n * `poseAxes` for the pose `get` answers, with `from` keeping the fields that are not axes as\n * that pose has them now. Reading them once would leave them stale in every pose a canceled\n * animation commits. Null where the pose has no axes.\n */\nexport function liveAxes<TPose>(\n  descriptor: PoseDescriptor<TPose> | undefined,\n  get: () => TPose,\n): TargetAxes<TPose> | null {\n  let like = get();\n  let axes = poseAxes(descriptor, like);\n  if (!axes) return null;\n  const { count, angles } = axes;\n  const current = (): TargetAxes<TPose> => {\n    const now = get();\n    if (now !== like) {\n      const next = poseAxes(descriptor, now);\n      if (next && next.count === count) axes = next;\n      like = now;\n    }\n    return axes!;\n  };\n  return {\n    count,\n    angles,\n    to: (p) => current().to(p),\n    from: (a) => current().from(a),\n    add: axes.add && ((p, d) => {\n      const now = current();\n      if (now.add) return now.add(p, d);\n      return now.from(now.to(p).map((n, i) => n + d[i]!));\n    }),\n    write: axes.write && ((p, out, at) => {\n      const now = current();\n      if (now.write) now.write(p, out, at);\n      else now.to(p).forEach((n, i) => { out[at + i] = n; });\n    }),\n  };\n}\n\nfunction build<TPose>(\n  opts: PoseTargetOptions<TPose>,\n  onRest?: () => void,\n  /** Whether something else has written the committed pose since an animation last did. */\n  overwritten?: () => boolean,\n): Target<TPose> | null {\n  const { overrides } = opts;\n  const id = opts.id as NodeId;\n  const axes = liveAxes(opts.descriptor, opts.get);\n  if (!axes) return null;\n  const entry: PoseOverride<TPose> = {};\n  let installed = false;\n  /** While installed, stops the run as soon as the table changes after something else wrote\n   *  the pose: a drag laid over the run commits and then lets go, which would show this run's\n   *  last frame until its next one. */\n  let unwatch: (() => void) | null = null;\n  const rest = (): void => {\n    installed = false;\n    unwatch?.();\n    unwatch = null;\n    overrides.clear(id, entry);\n    onRest?.();\n  };\n  const target = createTarget<TPose>({\n    get: opts.get,\n    set: opts.set,\n    axes,\n    show(pose) {\n      // The writer wins: what was left to travel belonged to a pose that is no longer committed.\n      if (target.active && overwritten?.()) target.stop({ commit: false });\n      if (!target.active) {\n        rest();\n        return;\n      }\n      entry.pose = pose;\n      // Reinstalled where it stood if the table dropped it; an override laid over it since, a drag's, is not taken back.\n      if (!overrides.has(id, entry)) overrides.set(id, entry);\n      installed = true;\n      if (overwritten && unwatch === null) {\n        unwatch = overrides.subscribe(() => {\n          if (!target.active || !overwritten()) return;\n          target.stop({ commit: false });\n          if (installed) rest();\n        });\n      }\n    },\n    publish: publisherOf(overrides),\n  });\n  return target;\n}\n\n/**\n * A {@link Target} over one node's pose. Animations on it commit their destination through\n * `set` as they start, and the pose on screen reaches the paint and pick walks as a pose\n * override: installed while the node moves and cleared when it comes to rest.\n *\n * Throws for a pose with no axes. Make one per node: two targets over one node do not add.\n * {@link scenePoseTarget} keeps that one for a scene's nodes.\n */\nexport function createPoseTarget<TPose>(opts: PoseTargetOptions<TPose>): Target<TPose> {\n  const target = build(opts);\n  if (!target) {\n    throw new Error('createPoseTarget: this pose has no axes; give a descriptor whose `axes` maps it');\n  }\n  return target;\n}\n\nconst sceneTargets = new WeakMap<object, Map<string, Target<unknown>>>();\n\n/** Whether two poses hold the same fields, compared without allocating: a running target asks on every publish. */\nfunction samePoseShallow(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null) return false;\n  const ra = a as Record<string, unknown>;\n  const rb = b as Record<string, unknown>;\n  let count = 0;\n  for (const k in ra) {\n    if (!Object.hasOwn(ra, k)) continue;\n    if (!Object.hasOwn(rb, k) || ra[k] !== rb[k]) return false;\n    count++;\n  }\n  for (const k in rb) if (Object.hasOwn(rb, k)) count--;\n  return count === 0;\n}\n\n/**\n * The pose target of node `id` in `scene`: the same one on every call, so everything animating\n * the node adds. Its committed value is the node's document pose, written without recording;\n * a caller that wants the move in history records its own op first.\n *\n * Undefined for a node that is not in the scene, or whose pose has no axes. `descriptor`\n * defaults to `RECT_POSE_DESCRIPTOR`, and is read the first time a node's target is made.\n */\nexport function scenePoseTarget<TPose>(\n  scene: PoseTargetScene<TPose>,\n  id: string,\n  descriptor?: PoseDescriptor<TPose>,\n): Target<TPose> | undefined {\n  let made = sceneTargets.get(scene.overrides);\n  if (!made) {\n    made = new Map();\n    sceneTargets.set(scene.overrides, made);\n  }\n  const nid = id as NodeId;\n  const node = scene.get(nid);\n  const by = descriptor ?? (RECT_POSE_DESCRIPTOR as unknown as PoseDescriptor<TPose>);\n  const held = made.get(id) as Target<TPose> | undefined;\n  // A pose that has changed shape at rest, a polygon given more points, needs axes made for it.\n  const fits = !held || held.active || !node\n    || poseAxes(by, documentPose(scene, node))?.count === held.axisCount;\n  if (held && fits) return held;\n  if (!node) return undefined;\n  // A node removed mid-flight keeps answering with the last pose it had.\n  let last = documentPose(scene, node);\n  /** The node's pose as an animation last left it, or as it was when the first one started. */\n  let mine: TPose | undefined;\n  /** While this target's own commit is being written. */\n  let writing = false;\n  const cache = made;\n  let target: Target<TPose> | null = null;\n  target = build<TPose>({\n    id,\n    descriptor: by,\n    overrides: scene.overrides,\n    get() {\n      const n = scene.get(nid);\n      if (n) last = documentPose(scene, n);\n      if (n && !target?.active) mine = n.pose;\n      return last;\n    },\n    set(pose) {\n      const n = scene.get(nid);\n      if (!n) return;\n      // The write runs the layout's reflow at once, and a reflow publishes glides to the overrides.\n      writing = true;\n      try {\n        if (!samePoseShallow(n.pose, pose)) scene.untracked(() => scene.setPose(nid, pose));\n      } finally {\n        writing = false;\n      }\n      mine = scene.get(nid)?.pose;\n    },\n  }, () => {\n    if (!scene.get(nid)) cache.delete(id);\n  }, () => {\n    if (writing) return false;\n    const n = scene.get(nid);\n    return !!n && mine !== undefined && !samePoseShallow(n.pose, mine);\n  });\n  if (!target) return undefined;\n  made.set(id, target as Target<unknown>);\n  return target;\n}\n"],"mappings":"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"}

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