@weasel-js/labkit 1.2.0 → 1.3.0-pre.0

package/dist/layers/index.d.ts

@@ -1,8 +1,10 @@
-import { d as LayerDescriptor } from '../_dts/index-JFAYj5Tv.js';
-export { L as LayerCapability } from '../_dts/index-JFAYj5Tv.js';
+import { f as LayerDescriptor } from '../_dts/index-DgcNdEdh.js';
+export { L as LayerCapability } from '../_dts/index-DgcNdEdh.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'react';
-import '../_dts/types-x92Kfeme.js';
+import '../_dts/types-AHlQxBNN.js';
+import '../_dts/PrefsForm-BYa6cWnO.js';
+import '../_dts/types-1Sdxy_Pv.js';
 import '../_dts/types-DJ79Tg5J.js';
 
 /** Props for `<LayerList>`. */

package/dist/layers/index.js

@@ -1,3 +1,4 @@
-export { LayerList } from '../chunk-SFL7NFKN.js';
+export { LayerList } from '../chunk-V7PRSIRQ.js';
+import '../chunk-PQJ5B2U2.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/passthrough/weasel-canvas.d.ts

@@ -1,6 +1,68 @@
+import { N as Node, V as View, P as Path, D as DrawCommand, S as Scene, B as Bounds, a as ViewportDims, b as PathDrawCommand } from '../_dts/DrawCommand-DBB45NfN.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Ref } from 'react';
-import { N as Node, V as View, D as DrawCommand, S as Scene, B as Bounds, a as ViewportDims, P as PathDrawCommand } from '../_dts/DrawCommand-C_XboUpz.js';
+
+/**
+ * NodeShape — the **shape trait's** registry. Each trait of a node
+ * (shape, routing, label, icon, affordances, …) is its own registry;
+ * this one holds the per-kind `paint` + `silhouette` (and future
+ * fields) used by `defaultDrawOne`, clipping, non-rect hit-testing,
+ * and lasso/area-select.
+ *
+ * Teaching the kit about a new kind of shape goes through this registry
+ * rather than by overriding `drawOne`. Overrides are still possible but
+ * shouldn't be the default seam: most consumers want the same dispatch
+ * logic, just extended with their own shape kinds (images, custom paths,
+ * SVG fragments, etc.).
+ *
+ * Built-in entries (`kit:text`, `kit:path`, `kit:rect-fallback`) are
+ * registered at module load. Consumer entries added via
+ * `registerNodeShape` join the chain; the first entry whose
+ * `matches` predicate returns true paints the node.
+ *
+ * Two priority tiers:
+ *   - `'high'` — checked before all `'normal'` entries. Use this to
+ *     override a kit built-in for a specific data shape (e.g. a custom
+ *     text renderer that wins over `kit:text`).
+ *   - `'normal'` (default) — appended after the built-ins.
+ *
+ * Within a tier, entries run in registration order. Each
+ * `registerNodeShape` call returns a disposer that removes the
+ * entry — useful for tests, for plugin lifecycles, and for swapping
+ * implementations at runtime.
+ *
+ * See `docs/superpowers/specs/2026-05-24-node-traits-reframe-design.md`
+ * for the trait taxonomy.
+ */
+
+/** Optional per-call paint context, threaded through `defaultDrawOne`'s third
+ *  argument. Lets a rendering entry point override ambient environment reads
+ *  — the headless `renderSceneToPixels` path supplies its own bitmap resolver
+ *  here so consumers reuse their own decode caches. Custom painters may
+ *  ignore it entirely. */
+interface NodePaintCtx {
+    /** Override bitmap resolution for image nodes. When set it is authoritative:
+     *  the global `imageCache` is not consulted, and an `undefined` result
+     *  paints the deterministic grey placeholder outline (never the ambient
+     *  load-status error variant). */
+    resolveImage?: (node: Node<unknown, string, unknown>) => ImageBitmap | undefined;
+    /** The node's derived path, resolved by the scene-aware `drawOne` wrapper
+     *  before painting: `paint` has no scene handle, and deriving needs the
+     *  dependencies' poses. **Absent** for a node that derives from nothing —
+     *  the wrapper hands such a node the caller's own ctx untouched. `null`
+     *  means the node derives but has nothing to draw. */
+    derivedPath?: Path | null;
+}
+/**
+ * Per-node draw function — the scene-slot `drawOne` signature shared by
+ * `<SceneCanvas>`, `renderSceneToCanvas` and `renderSceneToPixels`, so a
+ * consumer can reuse one callback across a main canvas and a detached view.
+ *
+ * Called once per node in the walk. Returned commands are world-space; the
+ * caller applies the view transform at the group level. `ctx` is supplied by
+ * the scene-aware wrappers — see {@link NodePaintCtx}.
+ */
+type SceneViewDrawOne<TData, TLayer extends string, TPose> = (node: Node<TData, TLayer, TPose>, pose: TPose, view: View, ctx?: NodePaintCtx) => DrawCommand[];
 
 /**
  * `renderSceneToCanvas` — substrate for detached, read-only scene views
@@ -21,17 +83,6 @@ import { N as Node, V as View, D as DrawCommand, S as Scene, B as Bounds, a as V
  * in sync by hand where it matters (DPR handling, viewToMat3 wrap).
  */
 
-/**
- * Per-node draw function. Mirrors the scene-slot `drawOne` signature on
- * `<SceneCanvas>` (`SceneSlotConfig.drawOne`) so consumers can reuse the
- * same callback (or a simplified variant) between a main canvas and a
- * detached scene-view canvas.
- *
- * The function is called once per node in `scene.renderOrder()`. Returned
- * commands are in world coords; the caller's `view` is applied at the
- * group level (see `renderSceneToCanvas`'s implementation).
- */
-type SceneViewDrawOne<TData, TLayer extends string, TPose> = (node: Node<TData, TLayer, TPose>, pose: TPose, view: View) => DrawCommand[];
 /** What to draw into an existing canvas: the scene, the view, and the same
  *  painting hooks `<SceneCanvas>` takes. */
 interface RenderSceneToCanvasArgs<TData, TLayer extends string, TPose> {
@@ -254,7 +305,12 @@ interface MinimapCanvasProps<TData, TLayer extends string, TPose> {
      *  can reuse it (typically simplified — just colored AABBs). */
     drawOne: SceneViewDrawOne<TData, TLayer, TPose>;
     /** Fit policy. Defaults to `"scene"` (AABB union of leaf poses). See
-     *  `MinimapFit` for the full shape. */
+     *  `MinimapFit` for the full shape.
+     *
+     *  Framing is derived from **document** poses, not `scene.overrides` — a
+     *  node moved by an override paints where the override puts it, outside the
+     *  frame if it goes there, rather than making the whole minimap rescale on
+     *  every frame of a drag or a settle. */
     fit?: MinimapFit<TData, TLayer, TPose>;
     /** Pose → AABB. Defaults to identity (`pose as Bounds`), matching
      *  `sceneAdapter` / `useSelectTool`. */

package/dist/passthrough/weasel-canvas.js

@@ -1,3 +1,3 @@
-export { FALLBACK_FIT_VIEW, MinimapCanvas, SceneViewCanvas, buildSceneViewCommands, computeFitView, computeIndicatorCommand, renderSceneToCanvas } from '../chunk-BOHF3PQO.js';
+export { FALLBACK_FIT_VIEW, MinimapCanvas, SceneViewCanvas, buildSceneViewCommands, computeFitView, computeIndicatorCommand, renderSceneToCanvas } from '../chunk-Z6HJ5FEM.js';
 //# sourceMappingURL=weasel-canvas.js.map
 //# sourceMappingURL=weasel-canvas.js.map