@weasel-js/core 1.10.0 → 1.10.1

package/dist/{types-CIKDwlsP.d.ts → types-DBbbCy0i.d.ts}

@@ -325,6 +325,11 @@ interface SnapTarget<TPose = unknown> {
  * **Pose semantics:** `getPose` / `setPose` work in **local** coordinates —
  * relative to the node's direct parent (or world, for root-parented nodes).
  * `getWorldPose`, where an adapter has it, is the composed reading.
+ *
+ * **Every adapter carries the tree:** `getNode`, `getParent`, and
+ * `getChildren`. A list with no nesting is a tree whose nodes are all roots:
+ * `getParent` answers `null` and `getChildren(null)` answers every id,
+ * bottom first.
  */
 /** Narrow adapter for move. Apps without container-snapping leave out `findSnapTarget`. */
 interface MoveAdapter<TNode extends {
@@ -333,10 +338,8 @@ interface MoveAdapter<TNode extends {
     getNode(id: string): TNode | undefined;
     getNodes(): TNode[];
     getPose(id: string): TPose;
-    /** Optional. Required only by hierarchy-aware paths: layout-pass drop
-     *  targeting (`getLayout` present), nested-hit collapse
-     *  (`pickTopMostHit`), and group-pose composition. Flat scenes may omit. */
-    getParent?(id: string): string | null;
+    /** The node's container, `null` for a root. */
+    getParent(id: string): string | null;
     /** Optional paint depth, read by `pickTopMostHit` to resolve two *siblings*
      *  whose bodies both cover the pointer. Without it the hit list's own order
      *  decides, which is right for a back-to-front walk and wrong for anything
@@ -344,7 +347,7 @@ interface MoveAdapter<TNode extends {
     getZIndex?(id: string): number | null | undefined;
     compareZ?(a: string, b: string): number;
     setPose(id: string, pose: TPose): void;
-    /** Optional. Used only by reparent ops; flat scenes that never reparent may omit. */
+    /** Optional. Used only by reparent ops; an adapter that never reparents may omit. */
     setParent?(id: string, parentId: string | null): void;
     /** Optional. The commit point of a gesture. When omitted, ops are applied
      *  against the adapter one by one; an adapter with a history of its own
@@ -361,12 +364,12 @@ interface MoveAdapter<TNode extends {
      *  it answers `undefined`. */
     poseTarget?(id: string, descriptor?: PoseDescriptor<TPose>): Target<TPose> | undefined;
     findSnapTarget?(draggedId: string, worldX: number, worldY: number): SnapTarget<TPose> | null;
-    /** Optional: ordered children of `parentId`, `null` for the root siblings.
-     *  One contract with {@link OrderedAdapter.getChildren} — the two land on
-     *  the same adapter object, and an implementation that answers only node
-     *  ids returns `[]` for the root, which the ops read as "no siblings".
-     */
-    getChildren?(parentId: string | null): string[];
+    /** Ordered children of `parentId`, `null` for the root siblings, in
+     *  z-order: index 0 is the bottom. One contract with
+     *  {@link OrderedAdapter.getChildren} — the two land on the same adapter
+     *  object. Picking walks it, and the ops read a node's sibling slot from it.
+     *  A node with no children answers `[]`. */
+    getChildren(parentId: string | null): string[];
     /** Optional: layout strategy attached to a container, or null if the
      *  container uses absolute positioning. When present, a move uses it to
      *  compute drop targets, sibling reflow, and the commit op batch. */
@@ -455,6 +458,11 @@ interface LassoSelectAdapter extends AreaSelectAdapter {
 interface InsertAdapter<TNode extends {
     id: string;
 }> {
+    getNode(id: string): TNode | undefined;
+    getParent(id: string): string | null;
+    /** Ordered children of `parentId`, `null` for the root siblings. An insert
+     *  resolves its sibling slot against it. */
+    getChildren(parentId: string | null): string[];
     /** Materialize a new node from drag-rect bounds (drag-to-insert tools).
      *  Optional: `sceneToAdapter` only fills it in when `options.commitInsert`
      *  is supplied. */
@@ -507,8 +515,7 @@ interface LayerEnumerableAdapter<TLayer extends string = string> {
     subscribeLayers?(listener: () => void): () => void;
 }
 /**
- * Optional adapter mixin for sibling z-order. Reorder ops no-op when either
- * method is absent.
+ * Sibling z-order: what the reorder ops read and write.
  *
  * **Convention:** array order IS z-order. Index 0 is the bottom of the
  * stack, the last index is the top. Hit-testing should iterate the returned
@@ -519,10 +526,10 @@ interface OrderedAdapter {
     /** Ordered children of `parentId` (or root siblings if null), in z-order:
      *  index 0 is bottom, last index is top. The same contract
      *  {@link MoveAdapter.getChildren} declares — one method, two readers. */
-    getChildren?(parentId: string | null): string[];
+    getChildren(parentId: string | null): string[];
     /** Rewrite the order of `parentId`'s children. Length and contents must
      *  match the existing children — reorder only, no add/remove. */
-    setChildOrder?(parentId: string | null, ids: string[]): void;
+    setChildOrder(parentId: string | null, ids: string[]): void;
 }
 
 export { type AreaSelectAdapter as A, toPlane as B, type ContainerBounds as C, type DropRegion as D, type InsertAdapter as I, type LayoutStrategy as L, type MoveAdapter as M, type OrderedAdapter as O, type ParallaxOpts as P, type RegionPickView as R, type SnapTarget as S, type PlaneMap as a, type LayoutDropTargetMode as b, type ReflowTransition as c, type PasteOmission as d, type LayerEnumerableAdapter as e, type LassoHitMode as f, type ResizeAdapter as g, type RotateAdapter as h, type LassoSelectAdapter as i, type ClipboardSnapshot as j, type PasteCtx as k, type DropTarget as l, type LayoutArrival as m, type LayoutChild as n, type LayoutContainer as o, type LayoutDragged as p, type LayoutSnap as q, type ReflowGlideOptions as r, type ScalarOrXY as s, deriveParallaxView as t, fromPlane as u, planeMap as v, planeMatrix as w, planeToPlane as x, rectFromPlane as y, rectToPlane as z };

package/dist/version.js

@@ -1,5 +1,5 @@
 //#region src/version.ts
-var e = "1.10.0";
+var e = "1.10.1";
 //#endregion
 export { e as VERSION };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weasel-js/core",
-  "version": "1.10.0",
+  "version": "1.10.1",
   "description": "A 2D scene-graph engine for React, rendered on WebGL2: the scene tree, viewport math, pointer and keyboard input, layered rendering, and op-based undo.",
   "license": "MIT",
   "author": "orochi235",
@@ -86,29 +86,29 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "peerDependencies": {
-    "@weasel-js/font": "1.10.0",
+    "@weasel-js/font": "1.10.1",
     "react": ">=18"
   },
   "dependencies": {
     "@msb235/blits": "0.10.0",
-    "@weasel-js/animator": "1.10.0",
-    "@weasel-js/cursor": "1.10.0",
-    "@weasel-js/geom": "1.10.0",
-    "@weasel-js/gestures": "1.10.0",
-    "@weasel-js/history": "1.10.0",
-    "@weasel-js/modes": "1.10.0",
-    "@weasel-js/paint": "1.10.0",
-    "@weasel-js/prefs": "1.10.0",
-    "@weasel-js/quantity": "1.10.0",
-    "@weasel-js/react": "1.10.0",
-    "@weasel-js/registry": "1.10.0",
-    "@weasel-js/renderer": "1.10.0",
-    "@weasel-js/routing": "1.10.0",
-    "@weasel-js/select": "1.10.0",
-    "@weasel-js/simulation": "1.10.0",
-    "@weasel-js/stroke": "1.10.0",
-    "@weasel-js/text": "1.10.0",
-    "@weasel-js/text-dom": "1.10.0",
+    "@weasel-js/animator": "1.10.1",
+    "@weasel-js/cursor": "1.10.1",
+    "@weasel-js/geom": "1.10.1",
+    "@weasel-js/gestures": "1.10.1",
+    "@weasel-js/history": "1.10.1",
+    "@weasel-js/modes": "1.10.1",
+    "@weasel-js/paint": "1.10.1",
+    "@weasel-js/prefs": "1.10.1",
+    "@weasel-js/quantity": "1.10.1",
+    "@weasel-js/react": "1.10.1",
+    "@weasel-js/registry": "1.10.1",
+    "@weasel-js/renderer": "1.10.1",
+    "@weasel-js/routing": "1.10.1",
+    "@weasel-js/select": "1.10.1",
+    "@weasel-js/simulation": "1.10.1",
+    "@weasel-js/stroke": "1.10.1",
+    "@weasel-js/text": "1.10.1",
+    "@weasel-js/text-dom": "1.10.1",
     "earcut": "3.2.3",
     "polygon-clipping": "^0.15.7"
   },
@@ -126,7 +126,7 @@
     "2d"
   ],
   "devDependencies": {
-    "@weasel-js/modes": "1.10.0",
-    "@weasel-js/theme": "1.10.0"
+    "@weasel-js/modes": "1.10.1",
+    "@weasel-js/theme": "1.10.1"
   }
 }

package/dist/canvas/surface.module.js

@@ -1,6 +0,0 @@
-//#region src/canvas/surface.module.css
-var e = "_surface_c2e145", t = { surface: e };
-//#endregion
-export { t as default, e as surface };
-
-//# sourceMappingURL=surface.module.js.map

package/dist/canvas/surface.module.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"surface.module.js","names":["surface","surface_module_default"],"sources":["../../src/canvas/surface.module.css"],"sourcesContent":["/* The CSS size of a canvas the kit renders: its `width` and `height` props.\n   Zero specificity, so a class the consumer passes resizes the element. */\n:where(.surface) {\n  width: var(--wzl-surface-width);\n  height: var(--wzl-surface-height);\n}\n"],"mappings":""}

package/dist/canvas/surfaceBox.js

@@ -1,16 +0,0 @@
-import e from "./surface.module.js";
-//#region src/canvas/surfaceBox.ts
-function t(t, n, r, i) {
-	return {
-		className: r ? `${e.surface} ${r}` : e.surface,
-		style: {
-			...i,
-			"--wzl-surface-width": `${t}px`,
-			"--wzl-surface-height": `${n}px`
-		}
-	};
-}
-//#endregion
-export { t as surfaceBox };
-
-//# sourceMappingURL=surfaceBox.js.map

package/dist/canvas/surfaceBox.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"surfaceBox.js","names":["s","surface_module_default","surfaceBox","className","style","width","height"],"sources":["../../src/canvas/surfaceBox.ts"],"sourcesContent":["/// <reference path=\"../css-modules.d.ts\" />\nimport type { CSSProperties } from 'react';\nimport s from './surface.module.css';\n\n/** The class and style for a `<canvas>` the kit renders at `width` × `height`\n *  CSS pixels. The renderer sizes only the drawing buffer, so without these\n *  the element is as large as its buffer: `dpr` times too big. */\nexport function surfaceBox(\n  width: number,\n  height: number,\n  className?: string,\n  style?: CSSProperties,\n): { className: string; style: CSSProperties } {\n  return {\n    className: className ? `${s.surface} ${className}` : s.surface,\n    style: { ...style, '--wzl-surface-width': `${width}px`, '--wzl-surface-height': `${height}px` } as CSSProperties,\n  };\n}\n"],"mappings":";;AAOA,SAAgBE,EACd,GACA,GACA,GACA,GAC6C;CAC7C,OAAO;EACL,WAAWC,IAAY,GAAGH,EAAE,QAAQ,GAAGG,MAAcH,EAAE;EACvD,OAAO;GAAE,GAAGI;GAAO,uBAAuB,GAAGC,EAAM;GAAK,wBAAwB,GAAGC,EAAO;EAAI;CAChG;AACF"}

package/dist/layout/arrivals.js

@@ -1,33 +0,0 @@
-import { poseDescriptorForNode as e } from "../core/geometry/poseDescriptor.js";
-import { AUTO_POSE_DESCRIPTOR as t } from "../core/geometry/autoPoseDescriptor.js";
-import { runLayoutPass as n } from "../core/scene/layoutPass.js";
-import { useEffect as r } from "react";
-import { useLatest as i } from "@weasel-js/react";
-//#region src/layout/arrivals.ts
-function a(r, i) {
-	let { layouts: a } = i, o = typeof a == "function" ? a : (e) => a[e] ?? null, s = (e) => r.layoutOf(e) ?? o(e), c = i.poseDescriptor ?? t, l = (t) => e(c, r.get(t)), u = {
-		bounds: (e, t) => l(t).getBounds(e),
-		remap: (e, t, n, r) => l(r).remapBounds(e, t, n)
-	};
-	return (e, t, i) => n(r, s, e, t, u, i);
-}
-function o(e, t) {
-	let n = i(t), o = t.layouts !== void 0;
-	r(() => {
-		if (o) return e.setArrivalHandler((t, r, i) => {
-			let { layouts: o, poseDescriptor: s } = n.current;
-			return o ? a(e, {
-				layouts: o,
-				poseDescriptor: s
-			})(t, r, i) : /* @__PURE__ */ new Map();
-		});
-	}, [
-		e,
-		o,
-		n
-	]);
-}
-//#endregion
-export { a as layoutArrivalHandler, o as useLayoutArrivals };
-
-//# sourceMappingURL=arrivals.js.map

package/dist/layout/arrivals.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"arrivals.js","names":["layoutArrivalHandler","opts","getLayout","layouts","id","layoutOf","scene","d","AUTO_POSE_DESCRIPTOR","descriptorOf","poseDescriptorForNode","frame","pose","from","to","runLayoutPass","arrivals","changed","departures","useLayoutArrivals","latest","useLatest","wired"],"sources":["../../src/layout/arrivals.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { runLayoutPass, type ResolvedLayoutFrame } from 'core/scene/layoutPass';\nimport type { NodeId, Scene, SceneArrivalHandler } from 'core/scene/types';\nimport { poseDescriptorForNode, type PoseDescriptor } from 'core/geometry/poseDescriptor';\nimport { AUTO_POSE_DESCRIPTOR } from 'core/geometry/autoPoseDescriptor';\nimport type { LayoutStrategy } from './types';\n\n/** Where a container's layout comes from: a map by container id, or a\n *  resolver. The same shape `<SceneCanvas layouts>` takes. */\nexport type LayoutSource<TPose> =\n  | Record<string, LayoutStrategy<TPose>>\n  | ((containerId: string) => LayoutStrategy<TPose> | null);\n\n/** Options for {@link layoutArrivalHandler} and {@link useLayoutArrivals}. */\nexport interface LayoutArrivalOptions<TPose> {\n  layouts: LayoutSource<TPose>;\n  /** How poses are read and resized. Default `AUTO_POSE_DESCRIPTOR`. */\n  poseDescriptor?: PoseDescriptor<TPose>;\n}\n\n/**\n * A scene arrival handler over `layouts`: the scene's own layout pass\n * (`depart` for children that left a container, `arrive` for children that\n * joined it, `childPoses` for any other change to its children or size),\n * measured through the canvas's pose\n * descriptor. A container that declares its own layout\n * (`ContainerNode.layout`) is arranged by that one; `layouts` fills in for\n * the rest.\n */\nexport function layoutArrivalHandler<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  opts: LayoutArrivalOptions<TPose>,\n): SceneArrivalHandler<TPose> {\n  const { layouts } = opts;\n  const getLayout = typeof layouts === 'function'\n    ? layouts\n    : (id: string) => layouts[id] ?? null;\n  const layoutOf = (id: NodeId) => scene.layoutOf(id) ?? getLayout(id as string);\n  const d = (opts.poseDescriptor ?? AUTO_POSE_DESCRIPTOR) as PoseDescriptor<TPose>;\n  const descriptorOf = (id: NodeId) => poseDescriptorForNode(d, scene.get(id));\n  const frame: ResolvedLayoutFrame<TPose> = {\n    bounds: (pose, id) => descriptorOf(id).getBounds(pose),\n    remap: (pose, from, to, id) => descriptorOf(id).remapBounds(pose, from, to),\n  };\n  return (arrivals, changed, departures) =>\n    runLayoutPass(scene, layoutOf, arrivals, changed, frame, departures);\n}\n\n/**\n * Install {@link layoutArrivalHandler} on `scene` for as long as the calling\n * component is mounted. `<SceneCanvas layouts>` does this itself; call it\n * when a canvas is wired by hand through `sceneToAdapter({ layouts })`.\n */\nexport function useLayoutArrivals<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, TLayer, TPose>,\n  opts: Partial<LayoutArrivalOptions<TPose>>,\n): void {\n  const latest = useLatest(opts);\n  const wired = opts.layouts !== undefined;\n  useEffect(() => {\n    if (!wired) return;\n    return scene.setArrivalHandler((arrivals, changed, departures) => {\n      const { layouts, poseDescriptor } = latest.current;\n      if (!layouts) return new Map();\n      return layoutArrivalHandler(scene, { layouts, poseDescriptor })(arrivals, changed, departures);\n    });\n  }, [scene, wired, latest]);\n}\n"],"mappings":";;;;;;AA8BA,SAAgBA,EACd,GACA,GAC4B;CAC5B,IAAM,EAAE,eAAYC,GACdC,IAAY,OAAOC,KAAY,aACjCA,KACC,MAAeA,EAAQC,MAAO,MAC7BC,KAAY,MAAeC,EAAM,SAASF,CAAE,KAAKF,EAAUE,CAAY,GACvEG,IAAKN,EAAK,kBAAkBO,GAC5BC,KAAgB,MAAeC,EAAsBH,GAAGD,EAAM,IAAIF,CAAE,CAAC,GACrEO,IAAoC;EACxC,SAAS,GAAM,MAAOF,EAAaL,CAAE,CAAC,CAAC,UAAUQ,CAAI;EACrD,QAAQ,GAAM,GAAM,GAAI,MAAOH,EAAaL,CAAE,CAAC,CAAC,YAAYQ,GAAMC,GAAMC,CAAE;CAC5E;CACA,QAAQ,GAAU,GAAS,MACzBC,EAAcT,GAAOD,GAAUW,GAAUC,GAASN,GAAOO,CAAU;AACvE;AAOA,SAAgBC,EACd,GACA,GACM;CACN,IAAMC,IAASC,EAAUpB,CAAI,GACvBqB,IAAQrB,EAAK,YAAY,KAAA;CAC/B,QAAgB;EACd,IAAKqB,GACL,OAAOhB,EAAM,mBAAmB,GAAU,GAAS,MAAe;GAChE,IAAM,EAAE,YAAS,sBAAmBc,EAAO;GAE3C,OADKjB,IACEH,EAAqBM,GAAO;IAAE;IAAS;GAAe,CAAC,CAAC,CAACU,GAAUC,GAASC,CAAU,oBADxE,IAAI,IAAI;EAE/B,CAAC;CACH,GAAG;EAACZ;EAAOgB;EAAOF;CAAM,CAAC;AAC3B"}