@weasel-js/core 1.10.1 → 1.11.1

package/dist/core/selection/chromeState.js

@@ -1,31 +1,55 @@
-import { unionAABB as e } from "../geometry/unionBounds.js";
+import { unionAABB } from "../geometry/unionBounds.js";
+
 //#region src/core/selection/chromeState.ts
-var t = {
+/** Nothing selected, nothing resolvable — what a caller reads before a
+*  surface has attached, or where chrome state has no owner. */
+var EMPTY_CHROME_STATE = {
 	selection: [],
-	multiActive: !1,
+	multiActive: false,
 	boundsOf: () => null,
 	unionBounds: null,
 	modifiers: {
-		alt: !1,
-		shift: !1,
-		meta: !1,
-		ctrl: !1
+		alt: false,
+		shift: false,
+		meta: false,
+		ctrl: false
 	}
 };
-function n(t) {
-	let { selection: n, multiActive: r, effectiveBoundsOf: i, modifiers: a, canRotate: o } = t;
+/** Whether chrome goes on something painted on `layer`, as `gate` — a
+*  `ChromeState`, a `ViewApi` — says. No layer, or no gate: it does. */
+function paintsLayer(gate, layer) {
+	return layer === void 0 || gate?.layerIsPainted?.(layer) !== false;
+}
+function buildChromeState(args) {
+	const { effectiveBoundsOf, modifiers, canRotate, layerIsPainted, layerOf } = args;
+	const gate = { ...layerIsPainted ? { layerIsPainted } : {} };
+	const shown = () => {
+		if (!layerIsPainted || !layerOf) return args.selection;
+		const kept = args.selection.filter((id) => paintsLayer(gate, layerOf(id)));
+		return kept.length === args.selection.length ? args.selection : kept;
+	};
+	const multi = () => {
+		const ids = shown();
+		return args.multiActive && (ids === args.selection || ids.length > 1);
+	};
 	return {
-		selection: n,
-		multiActive: r,
-		boundsOf: i,
-		modifiers: a,
-		canRotate: o ?? (() => !0),
+		get selection() {
+			return shown();
+		},
+		get multiActive() {
+			return multi();
+		},
+		boundsOf: effectiveBoundsOf,
+		modifiers,
+		canRotate: canRotate ?? (() => true),
+		...gate,
 		get unionBounds() {
-			return r ? e(n.map((e) => i(e))) : null;
+			if (!multi()) return null;
+			return unionAABB(shown().map((id) => effectiveBoundsOf(id)));
 		}
 	};
 }
-//#endregion
-export { t as EMPTY_CHROME_STATE, n as buildChromeState };
 
+//#endregion
+export { EMPTY_CHROME_STATE, buildChromeState, paintsLayer };
 //# sourceMappingURL=chromeState.js.map

package/dist/core/selection/chromeState.js.map

@@ -1 +1 @@
-{"version":3,"file":"chromeState.js","names":["EMPTY_CHROME_STATE","buildChromeState","args","effectiveBoundsOf","canRotate","multiActive","unionAABB","selection","id"],"sources":["../../../src/core/selection/chromeState.ts"],"sourcesContent":["import type { NodeId } from '../scene/types';\nimport type { ModifierState } from '../modifierState';\nimport type { Bounds } from '../viewport/fitViewToBounds';\nimport { unionAABB } from 'core/geometry/unionBounds';\n\nexport type { Bounds };\n\n/** Nothing selected, nothing resolvable — what a caller reads before a\n *  surface has attached, or where chrome state has no owner. */\nexport const EMPTY_CHROME_STATE: ChromeState = {\n  selection: [],\n  multiActive: false,\n  boundsOf: () => null,\n  unionBounds: null,\n  modifiers: { alt: false, shift: false, meta: false, ctrl: false },\n};\n\n/**\n * Read-only state that affordances consult on every render and hit-test\n * call. Built via `buildChromeState` and held across renders, so affordances\n * must not cache anything they read from it.\n */\nexport interface ChromeState {\n  /** Currently selected ids. Live; reflects useSelection's React state. */\n  readonly selection: readonly NodeId[];\n  /** True when the canvas is in multi-mode AND >= 2 ids are selected. */\n  readonly multiActive: boolean;\n  /** Bounds for any selection member id. Honors active-tool overlay state\n   *  (move/resize/rotate ghosts → ghost bounds; otherwise → committed\n   *  pose bounds). Returns null for unknown ids or ids whose bounds aren't\n   *  computable. */\n  boundsOf(id: string): Bounds | null;\n  /** Multi-union AABB when `multiActive`. Recomputed from `boundsOf` over\n   *  every selected id on each read, expanding rotated members to the extent\n   *  of their ink; null otherwise. */\n  readonly unionBounds: Bounds | null;\n  /** Active modifier state at the moment of the call. */\n  readonly modifiers: ModifierState;\n  /** True iff the node's pose-descriptor declares it can carry a rotation.\n   *  Affordances consult this to decide whether to expose rotate cursors /\n   *  drag-bands. Defaults to `true` when the descriptor doesn't declare\n   *  (back-compat) or when the id is unknown — the rotation gesture will\n   *  no-op visually for poses without AABB fields, but the affordance\n   *  doesn't lie about the cursor. Optional on the interface so unit-test\n   *  call sites that construct `ChromeState` by hand keep compiling;\n   *  affordances should treat an absent predicate as \"true\". */\n  canRotate?(id: string): boolean;\n}\n\nexport interface BuildChromeStateArgs {\n  selection: readonly NodeId[];\n  multiActive: boolean;\n  effectiveBoundsOf: (id: string) => Bounds | null;\n  modifiers: ModifierState;\n  /** Optional rotation-support predicate. When omitted, `canRotate` returns\n   *  `true` for every id — preserves pre-existing affordance behavior for\n   *  unit-test call sites that don't wire pose-descriptor capability. */\n  canRotate?: (id: string) => boolean;\n}\n\nexport function buildChromeState(args: BuildChromeStateArgs): ChromeState {\n  const { selection, multiActive, effectiveBoundsOf, modifiers, canRotate } = args;\n  return {\n    selection,\n    multiActive,\n    boundsOf: effectiveBoundsOf,\n    modifiers,\n    canRotate: canRotate ?? (() => true),\n    // Not cached: the state is memoized across renders, and poses move under\n    // it (a committed move, a live preview) without any of its inputs changing.\n    get unionBounds() {\n      if (!multiActive) return null;\n      return unionAABB(selection.map((id) => effectiveBoundsOf(id)));\n    },\n  };\n}\n"],"mappings":";;AASA,IAAaA,IAAkC;CAC7C,WAAW,CAAC;CACZ,aAAa;CACb,gBAAgB;CAChB,aAAa;CACb,WAAW;EAAE,KAAK;EAAO,OAAO;EAAO,MAAM;EAAO,MAAM;CAAM;AAClE;AA6CA,SAAgBC,EAAiB,GAAyC;CACxE,IAAM,EAAE,cAAW,gBAAa,sBAAmB,cAAW,iBAAcC;CAC5E,OAAO;EACL;EACA;EACA,UAAUC;EACV;EACA,WAAWC,YAAoB;EAG/B,IAAI,cAAc;GAEhB,OADKC,IACEC,EAAUC,EAAU,KAAK,MAAOJ,EAAkBK,CAAE,CAAC,CAAC,IADpC;EAE3B;CACF;AACF"}
+{"version":3,"file":"chromeState.js","names":[],"sources":["../../../src/core/selection/chromeState.ts"],"sourcesContent":["import type { NodeId } from '../scene/types';\nimport type { ModifierState } from '../modifierState';\nimport type { Bounds } from '../viewport/fitViewToBounds';\nimport { unionAABB } from 'core/geometry/unionBounds';\n\nexport type { Bounds };\n\n/** Nothing selected, nothing resolvable — what a caller reads before a\n *  surface has attached, or where chrome state has no owner. */\nexport const EMPTY_CHROME_STATE: ChromeState = {\n  selection: [],\n  multiActive: false,\n  boundsOf: () => null,\n  unionBounds: null,\n  modifiers: { alt: false, shift: false, meta: false, ctrl: false },\n};\n\n/**\n * Read-only state that affordances consult on every render and hit-test\n * call. Built via `buildChromeState` and held across renders, so affordances\n * must not cache anything they read from it.\n */\nexport interface ChromeState {\n  /** Currently selected ids. Live; reflects useSelection's React state,\n   *  less any on a layer this view does not paint. */\n  readonly selection: readonly NodeId[];\n  /** True when the canvas is in multi-mode AND >= 2 ids are selected, and\n   *  still >= 2 once `selection` drops the ones this view does not paint. */\n  readonly multiActive: boolean;\n  /** Bounds for any selection member id. Honors active-tool overlay state\n   *  (move/resize/rotate ghosts → ghost bounds; otherwise → committed\n   *  pose bounds). Returns null for unknown ids or ids whose bounds aren't\n   *  computable. */\n  boundsOf(id: string): Bounds | null;\n  /** Multi-union AABB when `multiActive`. Recomputed from `boundsOf` over\n   *  every selected id on each read, expanding rotated members to the extent\n   *  of their ink; null otherwise. */\n  readonly unionBounds: Bounds | null;\n  /** Active modifier state at the moment of the call. */\n  readonly modifiers: ModifierState;\n  /** True iff the node's pose-descriptor declares it can carry a rotation.\n   *  Affordances consult this to decide whether to expose rotate cursors /\n   *  drag-bands. Defaults to `true` when the descriptor doesn't declare\n   *  (back-compat) or when the id is unknown — the rotation gesture will\n   *  no-op visually for poses without AABB fields, but the affordance\n   *  doesn't lie about the cursor. Optional on the interface so unit-test\n   *  call sites that construct `ChromeState` by hand keep compiling;\n   *  affordances should treat an absent predicate as \"true\". */\n  canRotate?(id: string): boolean;\n  /** Whether a scene layer reaches the screen in the view this state was\n   *  built for — its `layerVisibility` / `layerOrder`, as `ViewApi` answers\n   *  it. Absent: the view paints every layer the scene shows. An affordance\n   *  that reads it puts no chrome on a node whose layer it says `false` to. */\n  layerIsPainted?(layerId: string): boolean;\n}\n\nexport interface BuildChromeStateArgs {\n  selection: readonly NodeId[];\n  multiActive: boolean;\n  effectiveBoundsOf: (id: string) => Bounds | null;\n  modifiers: ModifierState;\n  /** Optional rotation-support predicate. When omitted, `canRotate` returns\n   *  `true` for every id — preserves pre-existing affordance behavior for\n   *  unit-test call sites that don't wire pose-descriptor capability. */\n  canRotate?: (id: string) => boolean;\n  layerIsPainted?: (layerId: string) => boolean;\n  /** The scene layer a selected id is painted on. With `layerIsPainted`,\n   *  drops from `selection` every id this view does not paint. */\n  layerOf?: (id: string) => string | undefined;\n}\n\n/** Whether chrome goes on something painted on `layer`, as `gate` — a\n *  `ChromeState`, a `ViewApi` — says. No layer, or no gate: it does. */\nexport function paintsLayer(\n  gate: { layerIsPainted?(layerId: string): boolean } | null | undefined,\n  layer: string | undefined,\n): boolean {\n  return layer === undefined || gate?.layerIsPainted?.(layer) !== false;\n}\n\nexport function buildChromeState(args: BuildChromeStateArgs): ChromeState {\n  const { effectiveBoundsOf, modifiers, canRotate, layerIsPainted, layerOf } = args;\n  const gate = { ...(layerIsPainted ? { layerIsPainted } : {}) };\n  // Read per call, like `unionBounds`: the view's layer settings change under a memoized state.\n  const shown = (): readonly NodeId[] => {\n    if (!layerIsPainted || !layerOf) return args.selection;\n    const kept = args.selection.filter((id) => paintsLayer(gate, layerOf(id)));\n    return kept.length === args.selection.length ? args.selection : kept;\n  };\n  const multi = (): boolean => {\n    const ids = shown();\n    return args.multiActive && (ids === args.selection || ids.length > 1);\n  };\n  return {\n    get selection() { return shown(); },\n    get multiActive() { return multi(); },\n    boundsOf: effectiveBoundsOf,\n    modifiers,\n    canRotate: canRotate ?? (() => true),\n    ...gate,\n    // Not cached: the state is memoized across renders, and poses move under\n    // it (a committed move, a live preview) without any of its inputs changing.\n    get unionBounds() {\n      if (!multi()) return null;\n      return unionAABB(shown().map((id) => effectiveBoundsOf(id)));\n    },\n  };\n}\n"],"mappings":";;;;;AASA,IAAa,qBAAkC;CAC7C,WAAW,CAAC;CACZ,aAAa;CACb,gBAAgB;CAChB,aAAa;CACb,WAAW;EAAE,KAAK;EAAO,OAAO;EAAO,MAAM;EAAO,MAAM;CAAM;AAClE;;;AA0DA,SAAgB,YACd,MACA,OACS;CACT,OAAO,UAAU,UAAa,MAAM,iBAAiB,KAAK,MAAM;AAClE;AAEA,SAAgB,iBAAiB,MAAyC;CACxE,MAAM,EAAE,mBAAmB,WAAW,WAAW,gBAAgB,YAAY;CAC7E,MAAM,OAAO,EAAE,GAAI,iBAAiB,EAAE,eAAe,IAAI,CAAC,EAAG;CAE7D,MAAM,cAAiC;EACrC,IAAI,CAAC,kBAAkB,CAAC,SAAS,OAAO,KAAK;EAC7C,MAAM,OAAO,KAAK,UAAU,QAAQ,OAAO,YAAY,MAAM,QAAQ,EAAE,CAAC,CAAC;EACzE,OAAO,KAAK,WAAW,KAAK,UAAU,SAAS,KAAK,YAAY;CAClE;CACA,MAAM,cAAuB;EAC3B,MAAM,MAAM,MAAM;EAClB,OAAO,KAAK,gBAAgB,QAAQ,KAAK,aAAa,IAAI,SAAS;CACrE;CACA,OAAO;EACL,IAAI,YAAY;GAAE,OAAO,MAAM;EAAG;EAClC,IAAI,cAAc;GAAE,OAAO,MAAM;EAAG;EACpC,UAAU;EACV;EACA,WAAW,oBAAoB;EAC/B,GAAG;EAGH,IAAI,cAAc;GAChB,IAAI,CAAC,MAAM,GAAG,OAAO;GACrB,OAAO,UAAU,MAAM,CAAC,CAAC,KAAK,OAAO,kBAAkB,EAAE,CAAC,CAAC;EAC7D;CACF;AACF"}

package/dist/core/selection/readOnlySelection.js

@@ -1,32 +1,47 @@
 //#region src/core/selection/readOnlySelection.ts
-var e = /* @__PURE__ */ new WeakMap(), t = /* @__PURE__ */ new WeakMap(), n = () => {};
-function r(t) {
-	let r = e.get(t);
-	return r || (r = {
-		getSelection: () => t.getSelection(),
-		setSelection: n
-	}, e.set(t, r)), r;
+var methodViews = /* @__PURE__ */ new WeakMap();
+var apiViews = /* @__PURE__ */ new WeakMap();
+var ignore = () => {};
+function readOnlyAdapterMethods(methods) {
+	let view = methodViews.get(methods);
+	if (!view) {
+		view = {
+			getSelection: () => methods.getSelection(),
+			setSelection: ignore
+		};
+		methodViews.set(methods, view);
+	}
+	return view;
 }
-function i(e) {
-	let i = r(e.adapterMethods), a = t.get(e);
-	if (a && a.adapterMethods === i) return a;
-	let o = {
+/**
+* A view of `api` that reads the live selection and ignores every write.
+* `api` itself is untouched and still writes.
+*
+* One view per `api`, and one set of `adapterMethods` per `api.adapterMethods`,
+* so either is as stable a memo or effect dependency as the object it wraps.
+*/
+function readOnlySelection(api) {
+	const adapterMethods = readOnlyAdapterMethods(api.adapterMethods);
+	const cached = apiViews.get(api);
+	if (cached && cached.adapterMethods === adapterMethods) return cached;
+	const view = {
 		get current() {
-			return e.current;
+			return api.current;
 		},
-		get: e.get,
-		contains: e.contains,
-		set: n,
-		add: n,
-		remove: n,
-		toggle: n,
-		clear: n,
-		applyClick: n,
-		adapterMethods: i
+		get: api.get,
+		contains: api.contains,
+		set: ignore,
+		add: ignore,
+		remove: ignore,
+		toggle: ignore,
+		clear: ignore,
+		applyClick: ignore,
+		adapterMethods
 	};
-	return t.set(e, o), o;
+	apiViews.set(api, view);
+	return view;
 }
-//#endregion
-export { i as readOnlySelection };
 
+//#endregion
+export { readOnlySelection };
 //# sourceMappingURL=readOnlySelection.js.map

package/dist/core/selection/readOnlySelection.js.map

@@ -1 +1 @@
-{"version":3,"file":"readOnlySelection.js","names":["methodViews","apiViews","ignore","readOnlyAdapterMethods","view","methods","readOnlySelection","adapterMethods","api","cached"],"sources":["../../../src/core/selection/readOnlySelection.ts"],"sourcesContent":["import type { SelectionApi } from './useSelection';\n\ntype AdapterMethods = SelectionApi['adapterMethods'];\n\nconst methodViews = new WeakMap<AdapterMethods, AdapterMethods>();\nconst apiViews = new WeakMap<SelectionApi, SelectionApi>();\n\nconst ignore = (): void => {};\n\nfunction readOnlyAdapterMethods(methods: AdapterMethods): AdapterMethods {\n  let view = methodViews.get(methods);\n  if (!view) {\n    view = { getSelection: () => methods.getSelection(), setSelection: ignore };\n    methodViews.set(methods, view);\n  }\n  return view;\n}\n\n/**\n * A view of `api` that reads the live selection and ignores every write.\n * `api` itself is untouched and still writes.\n *\n * One view per `api`, and one set of `adapterMethods` per `api.adapterMethods`,\n * so either is as stable a memo or effect dependency as the object it wraps.\n */\nexport function readOnlySelection(api: SelectionApi): SelectionApi {\n  const adapterMethods = readOnlyAdapterMethods(api.adapterMethods);\n  const cached = apiViews.get(api);\n  if (cached && cached.adapterMethods === adapterMethods) return cached;\n  const view: SelectionApi = {\n    get current() { return api.current; },\n    get: api.get,\n    contains: api.contains,\n    set: ignore,\n    add: ignore,\n    remove: ignore,\n    toggle: ignore,\n    clear: ignore,\n    applyClick: ignore,\n    adapterMethods,\n  };\n  apiViews.set(api, view);\n  return view;\n}\n"],"mappings":";AAIA,IAAMA,oBAAc,IAAI,QAAwC,GAC1DC,oBAAW,IAAI,QAAoC,GAEnDC,UAAqB,CAAC;AAE5B,SAASC,EAAuB,GAAyC;CACvE,IAAIC,IAAOJ,EAAY,IAAIK,CAAO;CAKlC,OAJKD,MACH,IAAO;EAAE,oBAAoBC,EAAQ,aAAa;EAAG,cAAcH;CAAO,GAC1EF,EAAY,IAAIK,GAASD,CAAI,IAExBA;AACT;AASA,SAAgBE,EAAkB,GAAiC;CACjE,IAAMC,IAAiBJ,EAAuBK,EAAI,cAAc,GAC1DC,IAASR,EAAS,IAAIO,CAAG;CAC/B,IAAIC,KAAUA,EAAO,mBAAmBF,GAAgB,OAAOE;CAC/D,IAAML,IAAqB;EACzB,IAAI,UAAU;GAAE,OAAOI,EAAI;EAAS;EACpC,KAAKA,EAAI;EACT,UAAUA,EAAI;EACd,KAAKN;EACL,KAAKA;EACL,QAAQA;EACR,QAAQA;EACR,OAAOA;EACP,YAAYA;EACZ;CACF;CAEA,OADAD,EAAS,IAAIO,GAAKJ,CAAI,GACfA;AACT"}
+{"version":3,"file":"readOnlySelection.js","names":[],"sources":["../../../src/core/selection/readOnlySelection.ts"],"sourcesContent":["import type { SelectionApi } from './useSelection';\n\ntype AdapterMethods = SelectionApi['adapterMethods'];\n\nconst methodViews = new WeakMap<AdapterMethods, AdapterMethods>();\nconst apiViews = new WeakMap<SelectionApi, SelectionApi>();\n\nconst ignore = (): void => {};\n\nfunction readOnlyAdapterMethods(methods: AdapterMethods): AdapterMethods {\n  let view = methodViews.get(methods);\n  if (!view) {\n    view = { getSelection: () => methods.getSelection(), setSelection: ignore };\n    methodViews.set(methods, view);\n  }\n  return view;\n}\n\n/**\n * A view of `api` that reads the live selection and ignores every write.\n * `api` itself is untouched and still writes.\n *\n * One view per `api`, and one set of `adapterMethods` per `api.adapterMethods`,\n * so either is as stable a memo or effect dependency as the object it wraps.\n */\nexport function readOnlySelection(api: SelectionApi): SelectionApi {\n  const adapterMethods = readOnlyAdapterMethods(api.adapterMethods);\n  const cached = apiViews.get(api);\n  if (cached && cached.adapterMethods === adapterMethods) return cached;\n  const view: SelectionApi = {\n    get current() { return api.current; },\n    get: api.get,\n    contains: api.contains,\n    set: ignore,\n    add: ignore,\n    remove: ignore,\n    toggle: ignore,\n    clear: ignore,\n    applyClick: ignore,\n    adapterMethods,\n  };\n  apiViews.set(api, view);\n  return view;\n}\n"],"mappings":";AAIA,IAAM,8BAAc,IAAI,QAAwC;AAChE,IAAM,2BAAW,IAAI,QAAoC;AAEzD,IAAM,eAAqB,CAAC;AAE5B,SAAS,uBAAuB,SAAyC;CACvE,IAAI,OAAO,YAAY,IAAI,OAAO;CAClC,IAAI,CAAC,MAAM;EACT,OAAO;GAAE,oBAAoB,QAAQ,aAAa;GAAG,cAAc;EAAO;EAC1E,YAAY,IAAI,SAAS,IAAI;CAC/B;CACA,OAAO;AACT;;;;;;;;AASA,SAAgB,kBAAkB,KAAiC;CACjE,MAAM,iBAAiB,uBAAuB,IAAI,cAAc;CAChE,MAAM,SAAS,SAAS,IAAI,GAAG;CAC/B,IAAI,UAAU,OAAO,mBAAmB,gBAAgB,OAAO;CAC/D,MAAM,OAAqB;EACzB,IAAI,UAAU;GAAE,OAAO,IAAI;EAAS;EACpC,KAAK,IAAI;EACT,UAAU,IAAI;EACd,KAAK;EACL,KAAK;EACL,QAAQ;EACR,QAAQ;EACR,OAAO;EACP,YAAY;EACZ;CACF;CACA,SAAS,IAAI,KAAK,IAAI;CACtB,OAAO;AACT"}

package/dist/core/selection/selectionTarget.js

@@ -1,6 +1,17 @@
 //#region src/core/selection/selectionTarget.ts
-var e = "__weasel:multi-selection";
-//#endregion
-export { e as MULTI_RESIZE_TARGET_ID };
+/** Synthetic id a canvas uses to address the
+*  union-AABB target when 2+ real ids are selected. The selection-overlay
+*  layer and the affordance hit-tester both resolve it to `ChromeState`'s
+*  `unionBounds`; consumers wiring their own selection-overlay layer can
+*  reference the same constant.
+*
+*  Lives in `core/selection` (next to `ChromeState`) because it's a
+*  selection-derived concept, not a tool concept — `affordances/`,
+*  `features/selection/`, and `tools/` all consume it, so it must sit at
+*  the bottom of the layering (`core` → `affordances` → `tools` →
+*  `features`). */
+var MULTI_RESIZE_TARGET_ID = "__weasel:multi-selection";
 
+//#endregion
+export { MULTI_RESIZE_TARGET_ID };
 //# sourceMappingURL=selectionTarget.js.map

package/dist/core/selection/selectionTarget.js.map

@@ -1 +1 @@
-{"version":3,"file":"selectionTarget.js","names":["MULTI_RESIZE_TARGET_ID"],"sources":["../../../src/core/selection/selectionTarget.ts"],"sourcesContent":["/** Synthetic id a canvas uses to address the\n *  union-AABB target when 2+ real ids are selected. The selection-overlay\n *  layer and the affordance hit-tester both resolve it to `ChromeState`'s\n *  `unionBounds`; consumers wiring their own selection-overlay layer can\n *  reference the same constant.\n *\n *  Lives in `core/selection` (next to `ChromeState`) because it's a\n *  selection-derived concept, not a tool concept — `affordances/`,\n *  `features/selection/`, and `tools/` all consume it, so it must sit at\n *  the bottom of the layering (`core` → `affordances` → `tools` →\n *  `features`). */\nexport const MULTI_RESIZE_TARGET_ID = '__weasel:multi-selection';\n"],"mappings":";AAWA,IAAaA,IAAyB"}
+{"version":3,"file":"selectionTarget.js","names":[],"sources":["../../../src/core/selection/selectionTarget.ts"],"sourcesContent":["/** Synthetic id a canvas uses to address the\n *  union-AABB target when 2+ real ids are selected. The selection-overlay\n *  layer and the affordance hit-tester both resolve it to `ChromeState`'s\n *  `unionBounds`; consumers wiring their own selection-overlay layer can\n *  reference the same constant.\n *\n *  Lives in `core/selection` (next to `ChromeState`) because it's a\n *  selection-derived concept, not a tool concept — `affordances/`,\n *  `features/selection/`, and `tools/` all consume it, so it must sit at\n *  the bottom of the layering (`core` → `affordances` → `tools` →\n *  `features`). */\nexport const MULTI_RESIZE_TARGET_ID = '__weasel:multi-selection';\n"],"mappings":";;;;;;;;;;;;AAWA,IAAa,yBAAyB"}

package/dist/core/selection/usePublishSceneSelection.js

@@ -1,26 +1,27 @@
-import { useMemo as e } from "react";
-import { usePublishSelection as t } from "@weasel-js/routing/react";
+import { useMemo } from "react";
+import { usePublishSelection } from "@weasel-js/routing/react";
+
 //#region src/core/selection/usePublishSceneSelection.ts
-function n(e) {
-	if (e.kind === "container") return "group";
-	let t = e.pose;
-	if (t && typeof t == "object" && "kind" in t && typeof t.kind == "string") return "path";
-}
-function r(e, t, r) {
-	if (t.length !== 0) return t.map((t) => {
-		let i = e.get(t);
-		if (i) return r ? r(i) : n(i);
+/** The label published beside each selected id, parallel to `ids`; `undefined` when
+*  nothing is selected. Without `describe`, every entry is unlabeled. */
+function selectionKindLabels(scene, ids, describe) {
+	if (ids.length === 0) return void 0;
+	return ids.map((id) => {
+		const node = scene.get(id);
+		return node && describe ? describe(node) : void 0;
 	});
 }
-function i(n, i, a) {
-	let o = e(() => r(n, i, a), [
-		n,
-		i,
-		a
+/** Publishes a scene's selection, with a kind label per id, into any surrounding
+*  `<SelectionContextProvider>`. A no-op without one. */
+function usePublishSceneSelection(scene, ids, describe) {
+	const kinds = useMemo(() => selectionKindLabels(scene, ids, describe), [
+		scene,
+		ids,
+		describe
 	]);
-	t(i, o);
+	usePublishSelection(ids, kinds);
 }
-//#endregion
-export { r as selectionKindLabels, i as usePublishSceneSelection };
 
+//#endregion
+export { selectionKindLabels, usePublishSceneSelection };
 //# sourceMappingURL=usePublishSceneSelection.js.map

package/dist/core/selection/usePublishSceneSelection.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePublishSceneSelection.js","names":["defaultKindLabel","node","pose","selectionKindLabels","ids","scene","id","describeKind","usePublishSceneSelection","kinds","useMemo"],"sources":["../../../src/core/selection/usePublishSceneSelection.ts"],"sourcesContent":["import { usePublishSelection } from '@weasel-js/routing/react';\nimport type { Node, NodeId, Scene } from 'core/scene/types';\nimport { useMemo } from 'react';\n\ntype KindLabel = string | undefined;\n\n// Not the routing kind: this reads the node and its pose where `NodeRouting.classify` reads\n// `data`, and the two disagree on most nodes (`SceneCanvas.selectionKinds.test.tsx`).\nfunction defaultKindLabel(node: Node<unknown, string, unknown>): KindLabel {\n  if (node.kind === 'container') return 'group';\n  const pose = node.pose as { kind?: unknown } | null;\n  if (pose && typeof pose === 'object' && 'kind' in pose && typeof pose.kind === 'string') return 'path';\n  return undefined;\n}\n\n/** The label published beside each selected id, parallel to `ids`; `undefined` when\n *  nothing is selected. `describeKind` replaces the default for every node. */\nexport function selectionKindLabels<TData, TLayer extends string, TPose>(\n  scene: Pick<Scene<TData, TLayer, TPose>, 'get'>,\n  ids: readonly NodeId[],\n  describeKind?: (node: Node<TData, TLayer, TPose>) => KindLabel,\n): readonly KindLabel[] | undefined {\n  if (ids.length === 0) return undefined;\n  return ids.map((id) => {\n    const node = scene.get(id);\n    if (!node) return undefined;\n    return describeKind ? describeKind(node) : defaultKindLabel(node as Node<unknown, string, unknown>);\n  });\n}\n\n/** Publishes a scene's selection, with a kind label per id, into any surrounding\n *  `<SelectionContextProvider>`. A no-op without one. */\nexport function usePublishSceneSelection<TData, TLayer extends string, TPose>(\n  scene: Pick<Scene<TData, TLayer, TPose>, 'get'>,\n  ids: readonly NodeId[],\n  describeKind?: (node: Node<TData, TLayer, TPose>) => KindLabel,\n): void {\n  const kinds = useMemo(() => selectionKindLabels(scene, ids, describeKind), [scene, ids, describeKind]);\n  usePublishSelection(ids, kinds);\n}\n"],"mappings":";;;AAQA,SAASA,EAAiB,GAAiD;CACzE,IAAIC,EAAK,SAAS,aAAa,OAAO;CACtC,IAAMC,IAAOD,EAAK;CAClB,IAAIC,KAAQ,OAAOA,KAAS,YAAY,UAAUA,KAAQ,OAAOA,EAAK,QAAS,UAAU,OAAO;AAElG;AAIA,SAAgBC,EACd,GACA,GACA,GACkC;CAClC,IAAIC,EAAI,WAAW,GACnB,OAAOA,EAAI,KAAK,MAAO;EACrB,IAAMH,IAAOI,EAAM,IAAIC,CAAE;EACzB,IAAKL,GACL,OAAOM,IAAeA,EAAaN,CAAI,IAAID,EAAiBC,CAAsC;CACpG,CAAC;AACH;AAIA,SAAgBO,EACd,GACA,GACA,GACM;CACN,IAAMC,IAAQC,QAAcP,EAAoBE,GAAOD,GAAKG,CAAY,GAAG;EAACF;EAAOD;EAAKG;CAAY,CAAC;CACrG,EAAoBH,GAAKK,CAAK;AAChC"}
+{"version":3,"file":"usePublishSceneSelection.js","names":[],"sources":["../../../src/core/selection/usePublishSceneSelection.ts"],"sourcesContent":["import { usePublishSelection } from '@weasel-js/routing/react';\nimport type { Node, NodeId, Scene } from 'core/scene/types';\nimport { useMemo } from 'react';\n\ntype KindLabel = string | undefined;\n\n/** The label published beside each selected id, parallel to `ids`; `undefined` when\n *  nothing is selected. Without `describe`, every entry is unlabeled. */\nexport function selectionKindLabels<TData, TLayer extends string, TPose>(\n  scene: Pick<Scene<TData, TLayer, TPose>, 'get'>,\n  ids: readonly NodeId[],\n  describe?: (node: Node<TData, TLayer, TPose>) => KindLabel,\n): readonly KindLabel[] | undefined {\n  if (ids.length === 0) return undefined;\n  return ids.map((id) => {\n    const node = scene.get(id);\n    return node && describe ? describe(node) : undefined;\n  });\n}\n\n/** Publishes a scene's selection, with a kind label per id, into any surrounding\n *  `<SelectionContextProvider>`. A no-op without one. */\nexport function usePublishSceneSelection<TData, TLayer extends string, TPose>(\n  scene: Pick<Scene<TData, TLayer, TPose>, 'get'>,\n  ids: readonly NodeId[],\n  describe?: (node: Node<TData, TLayer, TPose>) => KindLabel,\n): void {\n  const kinds = useMemo(() => selectionKindLabels(scene, ids, describe), [scene, ids, describe]);\n  usePublishSelection(ids, kinds);\n}\n"],"mappings":";;;;;;AAQA,SAAgB,oBACd,OACA,KACA,UACkC;CAClC,IAAI,IAAI,WAAW,GAAG,OAAO;CAC7B,OAAO,IAAI,KAAK,OAAO;EACrB,MAAM,OAAO,MAAM,IAAI,EAAE;EACzB,OAAO,QAAQ,WAAW,SAAS,IAAI,IAAI;CAC7C,CAAC;AACH;;;AAIA,SAAgB,yBACd,OACA,KACA,UACM;CACN,MAAM,QAAQ,cAAc,oBAAoB,OAAO,KAAK,QAAQ,GAAG;EAAC;EAAO;EAAK;CAAQ,CAAC;CAC7F,oBAAoB,KAAK,KAAK;AAChC"}

package/dist/core/selection/useSelection.js

@@ -1,74 +1,107 @@
-import { dlog as e } from "../../debug/flag.js";
-import { useLayoutEffect as t, useMemo as n, useRef as r, useState as i, useSyncExternalStore as a } from "react";
-import { useLatest as o } from "@weasel-js/react";
-import { createSelectionStore as s, intentOf as c, select as l } from "@weasel-js/select";
+import { dlog } from "../../debug/flag.js";
+import { useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+import { useLatest } from "@weasel-js/react";
+import { createSelectionStore, intentOf, select } from "@weasel-js/select";
+
 //#region src/core/selection/useSelection.ts
-function u(e) {
-	let { renderOrder: t } = e;
-	return typeof t == "function" ? () => t.call(e) : void 0;
+/** The order a store paints its nodes in, when it is a scene and has one. */
+function paintOrderOf(store) {
+	const { renderOrder } = store;
+	return typeof renderOrder === "function" ? () => renderOrder.call(store) : void 0;
 }
-function d(d = {}) {
-	let { mode: f = "single", extend: p = "shift", initial: m = [], lock: h = !1, scene: g, range: _, order: v } = d, [y] = i(() => s([...m])), b = g ?? y, x = r(m);
-	a(b.subscribe, () => b.getSelection());
-	let S = r(!1);
-	t(() => {
-		g && !S.current && (S.current = !0, x.current.length > 0 && g.getSelection().length === 0 && g.setSelection([...x.current]));
-	}, [g]);
-	let C = o({
-		mode: f,
-		extend: p,
-		lock: h,
-		range: _,
-		order: v
-	}), w = r(null);
-	return n(() => {
-		let t = () => b.getSelection(), n = (n) => {
-			C.current.lock || (e("selection", "set", {
-				from: t().length,
-				to: n.length,
-				ids: n
-			}), b.setSelection(n));
-		}, r = (e) => t().filter((t) => t !== e);
+/**
+* Owns selection state, exposes a click-policy helper (single vs multi with
+* an extend key), and pre-builds the `getSelection` / `setSelection` adapter
+* methods:
+*
+* ```tsx
+* const selection = useSelection({ mode: 'multi' });
+* const adapter = useSceneAdapter(scene, { selection: selection.adapterMethods });
+* ```
+*
+* Returns the same object for as long as `scene` is the same store, so it is
+* safe as a memo or effect dependency. The calling component re-renders when
+* the selection changes; key anything derived from the ids on
+* `selection.current`.
+*/
+function useSelection(opts = {}) {
+	const { mode = "single", extend = "shift", initial = [], lock = false, scene, range, order } = opts;
+	const [local] = useState(() => createSelectionStore([...initial]));
+	const store = scene ?? local;
+	const initialRef = useRef(initial);
+	useSyncExternalStore(store.subscribe, () => store.getSelection());
+	const seeded = useRef(false);
+	useLayoutEffect(() => {
+		if (!scene || seeded.current) return;
+		seeded.current = true;
+		if (initialRef.current.length > 0 && scene.getSelection().length === 0) scene.setSelection([...initialRef.current]);
+	}, [scene]);
+	const optsRef = useLatest({
+		mode,
+		extend,
+		lock,
+		range,
+		order
+	});
+	const anchorRef = useRef(null);
+	return useMemo(() => {
+		const get = () => store.getSelection();
+		const set = (ids) => {
+			if (optsRef.current.lock) return;
+			dlog("selection", "set", {
+				from: get().length,
+				to: ids.length,
+				ids
+			});
+			store.setSelection(ids);
+		};
+		const without = (id) => get().filter((x) => x !== id);
 		return {
 			get current() {
-				return t();
+				return get();
 			},
-			get: t,
-			set: n,
-			add(e) {
-				C.current.mode === "single" ? n([e]) : t().includes(e) || n([...t(), e]);
+			get,
+			set,
+			add(id) {
+				if (optsRef.current.mode === "single") set([id]);
+				else if (!get().includes(id)) set([...get(), id]);
 			},
-			remove(e) {
-				t().includes(e) && n(r(e));
+			remove(id) {
+				if (get().includes(id)) set(without(id));
 			},
-			toggle(e) {
-				t().includes(e) ? n(r(e)) : n(C.current.mode === "single" ? [e] : [...t(), e]);
+			toggle(id) {
+				if (get().includes(id)) set(without(id));
+				else set(optsRef.current.mode === "single" ? [id] : [...get(), id]);
 			},
 			clear() {
-				n([]);
+				set([]);
 			},
-			contains: (e) => t().includes(e),
-			applyClick(e, r) {
-				let { mode: i, extend: a, range: o, order: s = u(b), lock: d } = C.current;
-				if (d) return;
-				let f = t(), p = w.current !== null && f.includes(w.current) ? w.current : f.at(-1) ?? null, m = c(r, {
-					mode: i,
-					toggle: a,
-					range: o
-				}), h = l({
-					ids: f,
-					anchor: p
-				}, e, m, m === "range" && s ? { order: [...s()] } : {});
-				w.current = h.anchor, n([...h.ids]);
+			contains: (id) => get().includes(id),
+			applyClick(id, modifiers) {
+				const { mode: m, extend: key, range: rangeKey, order: walk = paintOrderOf(store), lock: locked } = optsRef.current;
+				if (locked) return;
+				const ids = get();
+				const anchor = anchorRef.current !== null && ids.includes(anchorRef.current) ? anchorRef.current : ids.at(-1) ?? null;
+				const intent = intentOf(modifiers, {
+					mode: m,
+					toggle: key,
+					range: rangeKey
+				});
+				const next = select({
+					ids,
+					anchor
+				}, id, intent, intent === "range" && walk ? { order: [...walk()] } : {});
+				anchorRef.current = next.anchor;
+				set([...next.ids]);
 			},
 			adapterMethods: {
-				getSelection: () => t(),
-				setSelection: (e) => n(e)
+				getSelection: () => get(),
+				setSelection: (ids) => set(ids)
 			}
 		};
-	}, [b, C]);
+	}, [store, optsRef]);
 }
-//#endregion
-export { d as useSelection };
 
+//#endregion
+export { useSelection };
 //# sourceMappingURL=useSelection.js.map

package/dist/core/selection/useSelection.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSelection.js","names":["paintOrderOf","store","renderOrder","useSelection","opts","local","useState","createSelectionStore","initial","scene","initialRef","useRef","seeded","optsRef","useLatest","anchorRef","useMemo","get","set","dlog","ids","without","x","id","m","key","rangeKey","walk","locked","anchor","intent","intentOf","modifiers","next","select"],"sources":["../../../src/core/selection/useSelection.ts"],"sourcesContent":["import { useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { createSelectionStore, intentOf, select, type SelectionStore as Store } from '@weasel-js/select';\nimport type { NodeId } from 'core/scene/types';\nimport { dlog } from 'debug/flag';\n\n/** Declared in `@weasel-js/routing`; re-exported here, beside the hook that returns one. */\nimport type { SelectionApi, SelectionMode, SelectionExtendKey } from '@weasel-js/routing';\nexport type { SelectionApi, SelectionMode, SelectionExtendKey };\n\n/** Somewhere selection can live outside this hook. `Scene` satisfies it;\n *  so does any store with the same three methods. */\nexport type SelectionStore = Store<NodeId>;\n\n/** Options for {@link useSelection}. */\nexport interface UseSelectionOptions {\n  /** Default `'single'`. */\n  mode?: SelectionMode;\n  /** Default `'shift'`. Ignored in single-mode. */\n  extend?: SelectionExtendKey;\n  /** The key that selects everything from the last pressed id to this one,\n   *  along `order`. Absent, nothing ranges. It beats `extend` when both name\n   *  one key, so give them different keys. Ignored in single-mode. */\n  range?: SelectionExtendKey;\n  /** The sequence a range walks: a layer panel's rows, a timeline's tracks.\n   *  Default is the order the `scene` paints in, back to front; with neither,\n   *  the range key replaces. */\n  order?: () => Iterable<NodeId>;\n  /** Default `[]`. */\n  initial?: readonly NodeId[];\n  /** Keep the selection on this store rather than in the hook, so every\n   *  consumer of the same scene shares one selection and undo / redo can\n   *  restore it. `initial` then only seeds a store that has none yet.\n   *  Omit it and the hook owns a selection nobody else sees. */\n  scene?: SelectionStore;\n  /** When `true`, every mutator (`set`/`add`/`remove`/`toggle`/`clear`/\n   *  `applyClick`) is a no-op — selection stays at whatever `initial`\n   *  pinned it to. */\n  lock?: boolean;\n}\n\n/** The order a store paints its nodes in, when it is a scene and has one. */\nfunction paintOrderOf(store: SelectionStore): (() => Iterable<NodeId>) | undefined {\n  const { renderOrder } = store as { renderOrder?: () => Iterable<NodeId> };\n  return typeof renderOrder === 'function' ? () => renderOrder.call(store) : undefined;\n}\n\n/**\n * Owns selection state, exposes a click-policy helper (single vs multi with\n * an extend key), and pre-builds the `getSelection` / `setSelection` adapter\n * methods:\n *\n * ```tsx\n * const selection = useSelection({ mode: 'multi' });\n * const adapter = useSceneAdapter(scene, { selection: selection.adapterMethods });\n * ```\n *\n * Returns the same object for as long as `scene` is the same store, so it is\n * safe as a memo or effect dependency. The calling component re-renders when\n * the selection changes; key anything derived from the ids on\n * `selection.current`.\n */\nexport function useSelection(opts: UseSelectionOptions = {}): SelectionApi {\n  const { mode = 'single', extend = 'shift', initial = [], lock = false, scene, range, order } = opts;\n  // Without a `scene` the hook still keeps its ids in a store, so `get()` reads one store either\n  // way and a write is visible before the re-render it causes.\n  const [local] = useState(() => createSelectionStore<NodeId>([...initial]));\n  const store = scene ?? local;\n  const initialRef = useRef(initial);\n\n  useSyncExternalStore(store.subscribe, () => store.getSelection());\n\n  // A store that already holds a selection wins: the hook is joining it, not\n  // resetting it. In an effect, not during render — the store has other\n  // subscribers.\n  const seeded = useRef(false);\n  useLayoutEffect(() => {\n    if (!scene || seeded.current) return;\n    seeded.current = true;\n    if (initialRef.current.length > 0 && scene.getSelection().length === 0) {\n      scene.setSelection([...initialRef.current]);\n    }\n  }, [scene]);\n\n  const optsRef = useLatest({ mode, extend, lock, range, order });\n  const anchorRef = useRef<NodeId | null>(null);\n\n  return useMemo<SelectionApi>(() => {\n    const get = (): NodeId[] => store.getSelection() as NodeId[];\n    const set = (ids: NodeId[]): void => {\n      if (optsRef.current.lock) return;\n      dlog('selection', 'set', { from: get().length, to: ids.length, ids });\n      store.setSelection(ids);\n    };\n    const without = (id: NodeId) => get().filter((x) => x !== id);\n    return {\n      get current() { return get(); },\n      get,\n      set,\n      add(id) {\n        if (optsRef.current.mode === 'single') set([id]);\n        else if (!get().includes(id)) set([...get(), id]);\n      },\n      remove(id) {\n        if (get().includes(id)) set(without(id));\n      },\n      toggle(id) {\n        if (get().includes(id)) set(without(id));\n        else set(optsRef.current.mode === 'single' ? [id] : [...get(), id]);\n      },\n      clear() { set([]); },\n      contains: (id) => get().includes(id),\n      applyClick(id, modifiers) {\n        const { mode: m, extend: key, range: rangeKey, order: walk = paintOrderOf(store), lock: locked } = optsRef.current;\n        if (locked) return;\n        const ids = get();\n        // A selection something else set — a marquee, an undo — ranges from its last id.\n        const anchor = anchorRef.current !== null && ids.includes(anchorRef.current)\n          ? anchorRef.current\n          : (ids.at(-1) ?? null);\n        const intent = intentOf(modifiers, { mode: m, toggle: key, range: rangeKey });\n        const next = select({ ids, anchor }, id, intent, intent === 'range' && walk ? { order: [...walk()] } : {});\n        anchorRef.current = next.anchor;\n        set([...next.ids]);\n      },\n      adapterMethods: {\n        getSelection: () => get(),\n        setSelection: (ids: NodeId[]) => set(ids),\n      },\n    };\n  }, [store, optsRef]);\n}\n"],"mappings":"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"}
+{"version":3,"file":"useSelection.js","names":[],"sources":["../../../src/core/selection/useSelection.ts"],"sourcesContent":["import { useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { createSelectionStore, intentOf, select, type SelectionStore as Store } from '@weasel-js/select';\nimport type { NodeId } from 'core/scene/types';\nimport { dlog } from 'debug/flag';\n\n/** Declared in `@weasel-js/routing`; re-exported here, beside the hook that returns one. */\nimport type { SelectionApi, SelectionMode, SelectionExtendKey } from '@weasel-js/routing';\nexport type { SelectionApi, SelectionMode, SelectionExtendKey };\n\n/** Somewhere selection can live outside this hook. `Scene` satisfies it;\n *  so does any store with the same three methods. */\nexport type SelectionStore = Store<NodeId>;\n\n/** Options for {@link useSelection}. */\nexport interface UseSelectionOptions {\n  /** Default `'single'`. */\n  mode?: SelectionMode;\n  /** Default `'shift'`. Ignored in single-mode. */\n  extend?: SelectionExtendKey;\n  /** The key that selects everything from the last pressed id to this one,\n   *  along `order`. Absent, nothing ranges. It beats `extend` when both name\n   *  one key, so give them different keys. Ignored in single-mode. */\n  range?: SelectionExtendKey;\n  /** The sequence a range walks: a layer panel's rows, a timeline's tracks.\n   *  Default is the order the `scene` paints in, back to front; with neither,\n   *  the range key replaces. */\n  order?: () => Iterable<NodeId>;\n  /** Default `[]`. */\n  initial?: readonly NodeId[];\n  /** Keep the selection on this store rather than in the hook, so every\n   *  consumer of the same scene shares one selection and undo / redo can\n   *  restore it. `initial` then only seeds a store that has none yet.\n   *  Omit it and the hook owns a selection nobody else sees. */\n  scene?: SelectionStore;\n  /** When `true`, every mutator (`set`/`add`/`remove`/`toggle`/`clear`/\n   *  `applyClick`) is a no-op — selection stays at whatever `initial`\n   *  pinned it to. */\n  lock?: boolean;\n}\n\n/** The order a store paints its nodes in, when it is a scene and has one. */\nfunction paintOrderOf(store: SelectionStore): (() => Iterable<NodeId>) | undefined {\n  const { renderOrder } = store as { renderOrder?: () => Iterable<NodeId> };\n  return typeof renderOrder === 'function' ? () => renderOrder.call(store) : undefined;\n}\n\n/**\n * Owns selection state, exposes a click-policy helper (single vs multi with\n * an extend key), and pre-builds the `getSelection` / `setSelection` adapter\n * methods:\n *\n * ```tsx\n * const selection = useSelection({ mode: 'multi' });\n * const adapter = useSceneAdapter(scene, { selection: selection.adapterMethods });\n * ```\n *\n * Returns the same object for as long as `scene` is the same store, so it is\n * safe as a memo or effect dependency. The calling component re-renders when\n * the selection changes; key anything derived from the ids on\n * `selection.current`.\n */\nexport function useSelection(opts: UseSelectionOptions = {}): SelectionApi {\n  const { mode = 'single', extend = 'shift', initial = [], lock = false, scene, range, order } = opts;\n  // Without a `scene` the hook still keeps its ids in a store, so `get()` reads one store either\n  // way and a write is visible before the re-render it causes.\n  const [local] = useState(() => createSelectionStore<NodeId>([...initial]));\n  const store = scene ?? local;\n  const initialRef = useRef(initial);\n\n  useSyncExternalStore(store.subscribe, () => store.getSelection());\n\n  // A store that already holds a selection wins: the hook is joining it, not\n  // resetting it. In an effect, not during render — the store has other\n  // subscribers.\n  const seeded = useRef(false);\n  useLayoutEffect(() => {\n    if (!scene || seeded.current) return;\n    seeded.current = true;\n    if (initialRef.current.length > 0 && scene.getSelection().length === 0) {\n      scene.setSelection([...initialRef.current]);\n    }\n  }, [scene]);\n\n  const optsRef = useLatest({ mode, extend, lock, range, order });\n  const anchorRef = useRef<NodeId | null>(null);\n\n  return useMemo<SelectionApi>(() => {\n    const get = (): NodeId[] => store.getSelection() as NodeId[];\n    const set = (ids: NodeId[]): void => {\n      if (optsRef.current.lock) return;\n      dlog('selection', 'set', { from: get().length, to: ids.length, ids });\n      store.setSelection(ids);\n    };\n    const without = (id: NodeId) => get().filter((x) => x !== id);\n    return {\n      get current() { return get(); },\n      get,\n      set,\n      add(id) {\n        if (optsRef.current.mode === 'single') set([id]);\n        else if (!get().includes(id)) set([...get(), id]);\n      },\n      remove(id) {\n        if (get().includes(id)) set(without(id));\n      },\n      toggle(id) {\n        if (get().includes(id)) set(without(id));\n        else set(optsRef.current.mode === 'single' ? [id] : [...get(), id]);\n      },\n      clear() { set([]); },\n      contains: (id) => get().includes(id),\n      applyClick(id, modifiers) {\n        const { mode: m, extend: key, range: rangeKey, order: walk = paintOrderOf(store), lock: locked } = optsRef.current;\n        if (locked) return;\n        const ids = get();\n        // A selection something else set — a marquee, an undo — ranges from its last id.\n        const anchor = anchorRef.current !== null && ids.includes(anchorRef.current)\n          ? anchorRef.current\n          : (ids.at(-1) ?? null);\n        const intent = intentOf(modifiers, { mode: m, toggle: key, range: rangeKey });\n        const next = select({ ids, anchor }, id, intent, intent === 'range' && walk ? { order: [...walk()] } : {});\n        anchorRef.current = next.anchor;\n        set([...next.ids]);\n      },\n      adapterMethods: {\n        getSelection: () => get(),\n        setSelection: (ids: NodeId[]) => set(ids),\n      },\n    };\n  }, [store, optsRef]);\n}\n"],"mappings":"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"}

package/dist/core/shapeKinds.js

@@ -1,54 +1,83 @@
 //#region src/core/shapeKinds.ts
-var e = {
+/**
+* Declaration order is the enumeration order of every derived list —
+* `KIT_SHAPE_KINDS`, and through it `defaultNodeRouting` /
+* `defaultNodeProperties` / `BUILTIN_TOOL_IDS`.
+*/
+var SHAPE_KINDS = {
 	rect: {
-		tool: !0,
-		insertPreview: !0
+		tool: true,
+		insertPreview: true,
+		family: "shape"
 	},
 	ellipse: {
-		tool: !0,
-		insertPreview: !0
+		tool: true,
+		insertPreview: true,
+		family: "shape"
 	},
 	line: {
-		tool: !0,
-		insertPreview: !0
+		tool: true,
+		insertPreview: true,
+		family: "shape"
 	},
 	polygon: {
-		tool: !0,
-		insertPreview: !0
+		tool: true,
+		insertPreview: true,
+		family: "shape"
 	},
 	star: {
-		tool: !0,
-		insertPreview: !0
+		tool: true,
+		insertPreview: true,
+		family: "shape"
 	},
 	pen: {
-		tool: !0,
-		insertPreview: !1
+		tool: true,
+		insertPreview: false,
+		family: "draw"
 	},
 	pencil: {
-		tool: !0,
-		insertPreview: !0
+		tool: true,
+		insertPreview: true,
+		family: "draw"
 	},
 	lasso: {
-		tool: !0,
-		insertPreview: !1
+		tool: true,
+		insertPreview: false,
+		family: "select"
 	},
 	text: {
-		tool: !0,
-		insertPreview: !0
+		tool: true,
+		insertPreview: true,
+		text: true,
+		family: "type"
+	},
+	sticky: {
+		tool: true,
+		insertPreview: true,
+		text: true,
+		family: "type"
 	},
 	image: {
-		tool: !1,
-		insertPreview: !0
+		tool: false,
+		insertPreview: true
 	}
 };
-function t(e, t) {
-	return Object.keys(e).filter((n) => e[n][t]);
+/** Kinds in `table` whose descriptor sets `field`, in declaration order. */
+function shapeKindsWhere(table, field) {
+	return Object.keys(table).filter((k) => table[k][field]);
 }
-function n(t) {
-	return e[t];
+/** The descriptor for `kind`, or `undefined` for a kind the kit doesn't ship.
+*  The one accessor: ask it rather than testing membership of a derived list. */
+function shapeKindInfo(kind) {
+	return SHAPE_KINDS[kind];
+}
+/** Runtime, iterable list of the shape-tool ids in `BuiltinShapeToolId`. */
+var KIT_SHAPE_KINDS = shapeKindsWhere(SHAPE_KINDS, "tool");
+/** The shape-tool ids of one family, in declaration order. */
+function kitShapeKindsOf(family) {
+	return KIT_SHAPE_KINDS.filter((k) => SHAPE_KINDS[k].family === family);
 }
-var r = t(e, "tool");
-//#endregion
-export { r as KIT_SHAPE_KINDS, e as SHAPE_KINDS, n as shapeKindInfo, t as shapeKindsWhere };
 
+//#endregion
+export { KIT_SHAPE_KINDS, SHAPE_KINDS, kitShapeKindsOf, shapeKindInfo, shapeKindsWhere };
 //# sourceMappingURL=shapeKinds.js.map