@weasel-js/core 1.13.0-rc.0 → 1.14.0

package/dist/canvas/SceneCanvas/defaultTextEditor.js

@@ -0,0 +1,108 @@
+import { defaultDrawOne, defaultPaintBounds, paintBoundsFor } from "../defaultDrawOne.js";
+import { isCustomEntry } from "../layerSlots.js";
+import { drawOneEditing } from "../../domains/text/editingDrawOne.js";
+import { hostTextEditorHolds } from "../../domains/text/hostTextEditors.js";
+import { useSceneTextEditor } from "../../domains/text/useSceneTextEdit.js";
+import { useEffect, useLayoutEffect, useMemo, useState } from "react";
+import { useLatest } from "@weasel-js/react";
+import { useDepRegistry, useDepSource } from "@weasel-js/routing/react";
+
+//#region src/canvas/SceneCanvas/defaultTextEditor.tsx
+/**
+* `<SceneCanvas>`'s own text editor: the one a text or sticky tool's
+* `enterTextEdit` reaches, and a double-click on a text node opens, when the
+* host has wired none of its own. It stands down for a host editor — a
+* `useSceneTextEdit` whose container holds the canvas, or a `textEdit` dep
+* registered over it.
+*/
+/**
+* The editor, mounted into the canvas's containing block — its offset parent,
+* else its parent — so the overlay is positioned against the box it is
+* measured from. `on` false mounts it nowhere.
+*/
+function useDefaultTextEditor(scene, elementRef, config, on) {
+	const [element, setElement] = useState(null);
+	useLayoutEffect(() => {
+		if (elementRef.current !== element) setElement(elementRef.current);
+	});
+	const container = on && config !== false && element ? element.offsetParent ?? element.parentElement : null;
+	const edit = useSceneTextEditor(scene, container, config || {});
+	const editRef = useLatest(edit);
+	const elRef = useLatest(element);
+	const dep = useMemo(() => ({
+		startEdit: (id, opts) => editRef.current.startEdit(id, opts),
+		isTextNode: (id) => editRef.current.isTextNode(id)
+	}), [editRef]);
+	const yields = useMemo(() => () => {
+		const el = elRef.current;
+		return el === null || hostTextEditorHolds(el);
+	}, [elRef]);
+	return {
+		edit,
+		dep,
+		element: container ? element : null,
+		yields
+	};
+}
+/**
+* Publishes the editor as the `textEdit` dep and opens it on a double-click.
+* Rendered after the canvas's standard deps and before its children, so it
+* sits over the stub and under any `textEdit` a child registers.
+*/
+function DefaultTextEditDep({ editor, onDoubleClick }) {
+	const { dep, element, yields, edit } = editor;
+	const registry = useDepRegistry();
+	const editRef = useLatest(edit);
+	useDepSource("textEdit", (below) => element && !yields() ? dep : below());
+	useEffect(() => {
+		if (!element || !onDoubleClick) return;
+		const open = (e) => {
+			if (registry.get("textEdit") === dep) editRef.current.onDoubleClick(e);
+		};
+		element.addEventListener("dblclick", open);
+		return () => element.removeEventListener("dblclick", open);
+	}, [
+		element,
+		onDoubleClick,
+		registry,
+		dep,
+		editRef
+	]);
+	return null;
+}
+/**
+* The canvas's own editor, and its `layers` with the edited node's glyphs left
+* out. Not mounted under `paintInto`, where the canvas element is the host's.
+*/
+function useCanvasTextEditor(scene, elementRef, props) {
+	const editor = useDefaultTextEditor(scene, elementRef, props.textEditor, !props.paintInto);
+	const editingId = editor.edit.editingId;
+	return {
+		editor,
+		layers: useMemo(() => layersWhileEditing(props.layers, editingId), [props.layers, editingId])
+	};
+}
+/**
+* `layers` with the scene slot's `drawOne` leaving out the glyphs of the node
+* `editingId` names, which the overlay stands in for; `layers` itself when
+* nothing is being edited, or the slot is not the kit's.
+*/
+function layersWhileEditing(layers, editingId) {
+	if (editingId === null) return layers;
+	const slot = layers?.scene;
+	if (slot === null || isCustomEntry(slot)) return layers;
+	const base = slot?.drawOne ?? defaultDrawOne;
+	const paintBounds = slot && "paintBounds" in slot ? slot.paintBounds : slot?.drawOne ? paintBoundsFor(base) : defaultPaintBounds;
+	return {
+		...layers,
+		scene: {
+			...slot,
+			drawOne: drawOneEditing(editingId, base),
+			paintBounds
+		}
+	};
+}
+
+//#endregion
+export { DefaultTextEditDep, layersWhileEditing, useCanvasTextEditor, useDefaultTextEditor };
+//# sourceMappingURL=defaultTextEditor.js.map

package/dist/canvas/SceneCanvas/defaultTextEditor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultTextEditor.js","names":[],"sources":["../../../src/canvas/SceneCanvas/defaultTextEditor.tsx"],"sourcesContent":["/**\n * `<SceneCanvas>`'s own text editor: the one a text or sticky tool's\n * `enterTextEdit` reaches, and a double-click on a text node opens, when the\n * host has wired none of its own. It stands down for a host editor — a\n * `useSceneTextEdit` whose container holds the canvas, or a `textEdit` dep\n * registered over it.\n */\nimport { useEffect, useLayoutEffect, useMemo, useState, type MutableRefObject } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { useDepRegistry, useDepSource } from '@weasel-js/routing/react';\nimport type { TextEditDep } from 'interactions/actions/depSchema';\nimport type { Node, Scene } from 'core/scene/types';\nimport {\n  useSceneTextEditor, type DefaultTextData, type UseSceneTextEditOptions, type UseSceneTextEditReturn,\n} from 'domains/text/useSceneTextEdit';\nimport { hostTextEditorHolds } from 'domains/text/hostTextEditors';\nimport { drawOneEditing, type EditingDrawOne } from 'domains/text/editingDrawOne';\nimport { defaultDrawOne, defaultPaintBounds, paintBoundsFor } from '../defaultDrawOne';\nimport { isCustomEntry } from '../layerSlots';\nimport type { SceneCanvasLayers } from './props';\n\n/** `<SceneCanvas textEditor>`: its own editor's options, or `false` for none. */\nexport type SceneCanvasTextEditor<TData> = false | UseSceneTextEditOptions<TData>;\n\nexport interface DefaultTextEditor {\n  edit: UseSceneTextEditReturn;\n  /** The `textEdit` dep this editor answers with while it is the one standing. */\n  dep: TextEditDep;\n  element: HTMLElement | null;\n  /** Whether the host has an editor of its own over this canvas. */\n  yields: () => boolean;\n}\n\n/**\n * The editor, mounted into the canvas's containing block — its offset parent,\n * else its parent — so the overlay is positioned against the box it is\n * measured from. `on` false mounts it nowhere.\n */\nexport function useDefaultTextEditor<TData>(\n  scene: Scene<TData, string, unknown>,\n  elementRef: MutableRefObject<HTMLElement | null>,\n  config: SceneCanvasTextEditor<TData> | undefined,\n  on: boolean,\n): DefaultTextEditor {\n  const [element, setElement] = useState<HTMLElement | null>(null);\n  // eslint-disable-next-line react-hooks/exhaustive-deps -- the canvas fills elementRef on commit, so every commit rereads it; the guard stops a loop\n  useLayoutEffect(() => {\n    if (elementRef.current !== element) setElement(elementRef.current);\n  });\n  const live = on && config !== false;\n  const container = live && element ? ((element.offsetParent ?? element.parentElement) as HTMLElement | null) : null;\n  const edit = useSceneTextEditor(\n    scene as unknown as Scene<DefaultTextData, string>, container, (config || {}) as unknown as UseSceneTextEditOptions<DefaultTextData>,\n  );\n  const editRef = useLatest(edit);\n  const elRef = useLatest(element);\n  const dep = useMemo<TextEditDep>(() => ({\n    startEdit: (id, opts) => editRef.current.startEdit(id, opts),\n    isTextNode: (id) => editRef.current.isTextNode(id),\n  }), [editRef]);\n  const yields = useMemo(() => () => {\n    const el = elRef.current;\n    return el === null || hostTextEditorHolds(el);\n  }, [elRef]);\n  return { edit, dep, element: container ? element : null, yields };\n}\n\n/**\n * Publishes the editor as the `textEdit` dep and opens it on a double-click.\n * Rendered after the canvas's standard deps and before its children, so it\n * sits over the stub and under any `textEdit` a child registers.\n */\nexport function DefaultTextEditDep({ editor, onDoubleClick }: {\n  editor: DefaultTextEditor;\n  /** Whether a double-click on a text node opens it: the `edit` feature. */\n  onDoubleClick: boolean;\n}): null {\n  const { dep, element, yields, edit } = editor;\n  const registry = useDepRegistry();\n  const editRef = useLatest(edit);\n  useDepSource('textEdit', (below) => (element && !yields() ? dep : (below() as TextEditDep)));\n  useEffect(() => {\n    if (!element || !onDoubleClick) return;\n    const open = (e: MouseEvent) => {\n      if (registry.get('textEdit') === dep) editRef.current.onDoubleClick(e);\n    };\n    element.addEventListener('dblclick', open);\n    return () => element.removeEventListener('dblclick', open);\n  }, [element, onDoubleClick, registry, dep, editRef]);\n  return null;\n}\n\n/**\n * The canvas's own editor, and its `layers` with the edited node's glyphs left\n * out. Not mounted under `paintInto`, where the canvas element is the host's.\n */\nexport function useCanvasTextEditor<TData, TLayer extends string, TPose>(\n  scene: Scene<TData, string, unknown>,\n  elementRef: MutableRefObject<HTMLElement | null>,\n  props: {\n    textEditor?: SceneCanvasTextEditor<TData>;\n    paintInto?: unknown;\n    layers?: SceneCanvasLayers<Node<TData, TLayer, TPose>, TPose>;\n  },\n): { editor: DefaultTextEditor; layers: SceneCanvasLayers<Node<TData, TLayer, TPose>, TPose> | undefined } {\n  const editor = useDefaultTextEditor(scene, elementRef, props.textEditor, !props.paintInto);\n  const editingId = editor.edit.editingId;\n  const layers = useMemo(() => layersWhileEditing(props.layers, editingId), [props.layers, editingId]);\n  return { editor, layers };\n}\n\n/**\n * `layers` with the scene slot's `drawOne` leaving out the glyphs of the node\n * `editingId` names, which the overlay stands in for; `layers` itself when\n * nothing is being edited, or the slot is not the kit's.\n */\nexport function layersWhileEditing<TData, TLayer extends string, TPose>(\n  layers: SceneCanvasLayers<Node<TData, TLayer, TPose>, TPose> | undefined,\n  editingId: string | null,\n): SceneCanvasLayers<Node<TData, TLayer, TPose>, TPose> | undefined {\n  if (editingId === null) return layers;\n  const slot = layers?.scene;\n  if (slot === null || isCustomEntry(slot)) return layers;\n  const base = (slot?.drawOne ?? defaultDrawOne) as EditingDrawOne;\n  const paintBounds = slot && 'paintBounds' in slot\n    ? slot.paintBounds\n    : slot?.drawOne ? paintBoundsFor(base) : defaultPaintBounds;\n  return {\n    ...layers, scene: { ...slot, drawOne: drawOneEditing(editingId, base), paintBounds },\n  } as SceneCanvasLayers<Node<TData, TLayer, TPose>, TPose>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAsCA,SAAgB,qBACd,OACA,YACA,QACA,IACmB;CACnB,MAAM,CAAC,SAAS,cAAc,SAA6B,IAAI;CAE/D,sBAAsB;EACpB,IAAI,WAAW,YAAY,SAAS,WAAW,WAAW,OAAO;CACnE,CAAC;CAED,MAAM,YADO,MAAM,WAAW,SACJ,UAAY,QAAQ,gBAAgB,QAAQ,gBAAwC;CAC9G,MAAM,OAAO,mBACX,OAAoD,WAAY,UAAU,CAAC,CAC7E;CACA,MAAM,UAAU,UAAU,IAAI;CAC9B,MAAM,QAAQ,UAAU,OAAO;CAC/B,MAAM,MAAM,eAA4B;EACtC,YAAY,IAAI,SAAS,QAAQ,QAAQ,UAAU,IAAI,IAAI;EAC3D,aAAa,OAAO,QAAQ,QAAQ,WAAW,EAAE;CACnD,IAAI,CAAC,OAAO,CAAC;CACb,MAAM,SAAS,oBAAoB;EACjC,MAAM,KAAK,MAAM;EACjB,OAAO,OAAO,QAAQ,oBAAoB,EAAE;CAC9C,GAAG,CAAC,KAAK,CAAC;CACV,OAAO;EAAE;EAAM;EAAK,SAAS,YAAY,UAAU;EAAM;CAAO;AAClE;;;;;;AAOA,SAAgB,mBAAmB,EAAE,QAAQ,iBAIpC;CACP,MAAM,EAAE,KAAK,SAAS,QAAQ,SAAS;CACvC,MAAM,WAAW,eAAe;CAChC,MAAM,UAAU,UAAU,IAAI;CAC9B,aAAa,aAAa,UAAW,WAAW,CAAC,OAAO,IAAI,MAAO,MAAM,CAAkB;CAC3F,gBAAgB;EACd,IAAI,CAAC,WAAW,CAAC,eAAe;EAChC,MAAM,QAAQ,MAAkB;GAC9B,IAAI,SAAS,IAAI,UAAU,MAAM,KAAK,QAAQ,QAAQ,cAAc,CAAC;EACvE;EACA,QAAQ,iBAAiB,YAAY,IAAI;EACzC,aAAa,QAAQ,oBAAoB,YAAY,IAAI;CAC3D,GAAG;EAAC;EAAS;EAAe;EAAU;EAAK;CAAO,CAAC;CACnD,OAAO;AACT;;;;;AAMA,SAAgB,oBACd,OACA,YACA,OAKyG;CACzG,MAAM,SAAS,qBAAqB,OAAO,YAAY,MAAM,YAAY,CAAC,MAAM,SAAS;CACzF,MAAM,YAAY,OAAO,KAAK;CAE9B,OAAO;EAAE;EAAQ,QADF,cAAc,mBAAmB,MAAM,QAAQ,SAAS,GAAG,CAAC,MAAM,QAAQ,SAAS,CACjF;CAAO;AAC1B;;;;;;AAOA,SAAgB,mBACd,QACA,WACkE;CAClE,IAAI,cAAc,MAAM,OAAO;CAC/B,MAAM,OAAO,QAAQ;CACrB,IAAI,SAAS,QAAQ,cAAc,IAAI,GAAG,OAAO;CACjD,MAAM,OAAQ,MAAM,WAAW;CAC/B,MAAM,cAAc,QAAQ,iBAAiB,OACzC,KAAK,cACL,MAAM,UAAU,eAAe,IAAI,IAAI;CAC3C,OAAO;EACL,GAAG;EAAQ,OAAO;GAAE,GAAG;GAAM,SAAS,eAAe,WAAW,IAAI;GAAG;EAAY;CACrF;AACF"}

package/dist/canvas/SceneCanvas/describePresets.js

@@ -0,0 +1,47 @@
+import { namesBuiltins, presetToolIds } from "./features.js";
+
+//#region src/canvas/SceneCanvas/describePresets.ts
+var ATOM_ROLES = [
+	"ambient",
+	"moveBehaviors",
+	"snapSources",
+	"layers",
+	"chrome",
+	"chromeRules",
+	"pathEdit",
+	"contributions",
+	"refines"
+];
+var filled = (v) => v !== void 0 && (typeof v !== "object" || v === null || (Array.isArray(v) ? v.length > 0 : Object.keys(v).length > 0));
+/** Whether `preset` is an atom: it holds a role beyond actions, built-in tools, and includes. */
+function isAtom(preset) {
+	return ATOM_ROLES.some((role) => filled(preset[role])) || (preset.tools ?? []).some((t) => !namesBuiltins(t));
+}
+/**
+* Every preset reachable from `sources` (keyed by the package that ships them), its includes followed, once each,
+* each after the presets it includes. A preset reached from two packages is the first's.
+*/
+function describePresets(sources) {
+	const out = [];
+	const seen = /* @__PURE__ */ new Set();
+	const visit = (p, pkg) => {
+		if (seen.has(p.id)) return;
+		seen.add(p.id);
+		for (const inner of p.includes ?? []) visit(inner, pkg);
+		out.push({
+			id: p.id,
+			label: p.label ?? p.id,
+			package: pkg,
+			atom: isAtom(p),
+			actions: (p.actions ?? []).map((a) => a.id),
+			tools: presetToolIds(p),
+			includes: (p.includes ?? []).map((inner) => inner.id)
+		});
+	};
+	for (const [pkg, presets] of Object.entries(sources)) for (const p of presets) visit(p, pkg);
+	return out;
+}
+
+//#endregion
+export { describePresets, isAtom };
+//# sourceMappingURL=describePresets.js.map

package/dist/canvas/SceneCanvas/describePresets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describePresets.js","names":[],"sources":["../../../src/canvas/SceneCanvas/describePresets.ts"],"sourcesContent":["import { namesBuiltins, presetToolIds, type FeaturePreset } from './features';\n\n/** One preset as data: what it holds by id, for a tool that lists or rearranges presets. */\nexport interface PresetDescription {\n  id: string;\n  label: string;\n  /** The package that ships it, as `describePresets` was told. */\n  package: string;\n  /** It has a role beyond actions, built-in tools, and includes, so its parts only work together. */\n  atom: boolean;\n  /** Its own action ids, in registration order. */\n  actions: readonly string[];\n  /** Its own tools' ids: built-ins with their sets opened, then tools of its own. */\n  tools: readonly string[];\n  /** The ids of the presets it includes. */\n  includes: readonly string[];\n}\n\nconst ATOM_ROLES = [\n  'ambient', 'moveBehaviors', 'snapSources', 'layers', 'chrome', 'chromeRules', 'pathEdit', 'contributions', 'refines',\n] as const satisfies readonly (keyof FeaturePreset)[];\n\nconst filled = (v: unknown): boolean =>\n  v !== undefined && (typeof v !== 'object' || v === null || (Array.isArray(v) ? v.length > 0 : Object.keys(v).length > 0));\n\n/** Whether `preset` is an atom: it holds a role beyond actions, built-in tools, and includes. */\nexport function isAtom(preset: FeaturePreset): boolean {\n  return ATOM_ROLES.some((role) => filled(preset[role])) || (preset.tools ?? []).some((t) => !namesBuiltins(t));\n}\n\n/**\n * Every preset reachable from `sources` (keyed by the package that ships them), its includes followed, once each,\n * each after the presets it includes. A preset reached from two packages is the first's.\n */\nexport function describePresets(sources: Readonly<Record<string, readonly FeaturePreset[]>>): PresetDescription[] {\n  const out: PresetDescription[] = [];\n  const seen = new Set<string>();\n  const visit = (p: FeaturePreset, pkg: string): void => {\n    if (seen.has(p.id)) return;\n    seen.add(p.id);\n    for (const inner of p.includes ?? []) visit(inner, pkg);\n    out.push({\n      id: p.id,\n      label: p.label ?? p.id,\n      package: pkg,\n      atom: isAtom(p),\n      actions: (p.actions ?? []).map((a) => a.id),\n      tools: presetToolIds(p),\n      includes: (p.includes ?? []).map((inner) => inner.id),\n    });\n  };\n  for (const [pkg, presets] of Object.entries(sources)) for (const p of presets) visit(p, pkg);\n  return out;\n}\n"],"mappings":";;;AAkBA,IAAM,aAAa;CACjB;CAAW;CAAiB;CAAe;CAAU;CAAU;CAAe;CAAY;CAAiB;AAC7G;AAEA,IAAM,UAAU,MACd,MAAM,WAAc,OAAO,MAAM,YAAY,MAAM,SAAS,MAAM,QAAQ,CAAC,IAAI,EAAE,SAAS,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,SAAS;;AAGxH,SAAgB,OAAO,QAAgC;CACrD,OAAO,WAAW,MAAM,SAAS,OAAO,OAAO,KAAK,CAAC,MAAM,OAAO,SAAS,CAAC,EAAA,CAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;AAC9G;;;;;AAMA,SAAgB,gBAAgB,SAAkF;CAChH,MAAM,MAA2B,CAAC;CAClC,MAAM,uBAAO,IAAI,IAAY;CAC7B,MAAM,SAAS,GAAkB,QAAsB;EACrD,IAAI,KAAK,IAAI,EAAE,EAAE,GAAG;EACpB,KAAK,IAAI,EAAE,EAAE;EACb,KAAK,MAAM,SAAS,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,GAAG;EACtD,IAAI,KAAK;GACP,IAAI,EAAE;GACN,OAAO,EAAE,SAAS,EAAE;GACpB,SAAS;GACT,MAAM,OAAO,CAAC;GACd,UAAU,EAAE,WAAW,CAAC,EAAA,CAAG,KAAK,MAAM,EAAE,EAAE;GAC1C,OAAO,cAAc,CAAC;GACtB,WAAW,EAAE,YAAY,CAAC,EAAA,CAAG,KAAK,UAAU,MAAM,EAAE;EACtD,CAAC;CACH;CACA,KAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,OAAO,GAAG,KAAK,MAAM,KAAK,SAAS,MAAM,GAAG,GAAG;CAC3F,OAAO;AACT"}

package/dist/canvas/SceneCanvas/features.js

@@ -1,25 +1,33 @@
-import { never } from "../../features/chrome-caps/conditions.js";
+import { never } from "../../domains/chrome-caps/conditions.js";
 import { toolIdsOf } from "@weasel-js/routing";
 
 //#region src/canvas/SceneCanvas/features.ts
 /**
 * The behavior presets `<SceneCanvas features>` composes. A bare canvas renders
-* its scene and keeps a selection nothing sets; every behavior beyond that is
-* turned on by a preset.
+* its scene, keeps a selection nothing sets, and undoes and redoes whatever
+* changed it; every behavior beyond that is turned on by a preset.
 *
 * A preset is a {@link FeaturePreset} object: the actions, tools, bindings,
-* chrome, and contributions one behavior brings. Core's own are named
-* (`'select'`, `'draw'`) and live in `namedPresets.ts`; a package ships its
-* own the same way and an app passes the object. Nothing here imports an
-* action, so a canvas reaches only the presets it is handed.
+* chrome, and contributions one behavior brings, and the presets it includes.
+* One that holds only actions, tools, and includes is a bundle, pure grouping;
+* one with any other role is an atom, whose parts only work together. Core's
+* own are named (`'select'`, `'draw'`) and live in `namedPresets.ts`; a
+* package ships its own the same way and an app passes the object. Nothing
+* here imports an action, so a canvas reaches only the presets it is handed.
 *
-* A preset is not one of the `packages/core/src/features/<name>/` source
+* A preset is not one of the `packages/core/src/domains/<name>/` source
 * directories that `docs/taxonomy.md` calls a feature; the two share a word
 * and nothing else.
 */
-/** Every name `<SceneCanvas features>` accepts, each composite after the
-*  presets it names. */
+/** Every core preset's name `<SceneCanvas features>` accepts, each after the
+*  presets it includes. */
 var SCENE_CANVAS_FEATURES = [
+	"tools:select",
+	"tools:view",
+	"tools:shape",
+	"tools:draw",
+	"tools:type",
+	"tools:page",
 	"view",
 	"select",
 	"outline",
@@ -28,15 +36,33 @@ var SCENE_CANVAS_FEATURES = [
 	"resize",
 	"rotate",
 	"transform",
+	"escape",
+	"contextMenu",
+	"selectAll",
+	"duplicate",
+	"delete",
+	"group",
+	"nudge",
+	"style",
+	"clipboard",
 	"edit",
+	"flip",
+	"reorder",
+	"align",
+	"distribute",
 	"arrange",
+	"anchorKeys",
+	"pathfinder",
+	"outlines",
+	"pathEdit",
+	"pathCommands",
 	"paths",
 	"ingest",
 	"draw"
 ];
 /**
 * The presets a canvas runs with: names expanded, `includes` pulled in, each
-* preset once, and every one placed ahead of the presets it `refines`. Ties
+* preset once, and every one placed ahead of the presets it `refines` and what those include. Ties
 * keep the order given. Where names resolve, a `viewport` config turns on the
 * `view` preset, since that prop only configures what `view` turns on.
 *
@@ -57,15 +83,24 @@ function resolveFeatures(features, named, opts = {}) {
 	};
 	for (const f of features ?? []) if (typeof f !== "string") add(f);
 	else if (!named) throw new Error(`[SceneCanvas] this canvas resolves no preset names; pass the preset for "${f}"`);
-	else if (f in named.composite) for (const b of named.composite[f]) add(named.base[b]);
-	else add(named.base[f]);
-	if (opts.viewport && named) add(named.base.view);
+	else if (!Object.hasOwn(named, f)) throw new Error(`[SceneCanvas] no preset is named "${f}"`);
+	else add(named[f]);
+	if (opts.viewport && named?.view) add(named.view);
+	const parents = /* @__PURE__ */ new Map();
+	for (const p of listed) for (const inner of p.includes ?? []) parents.set(inner.id, [...parents.get(inner.id) ?? [], p.id]);
+	const namesFor = (id, out = /* @__PURE__ */ new Set()) => {
+		if (out.has(id)) return out;
+		out.add(id);
+		for (const up of parents.get(id) ?? []) namesFor(up, out);
+		return out;
+	};
 	const ordered = [];
 	const placed = /* @__PURE__ */ new Set();
 	const place = (p) => {
 		if (placed.has(p.id)) return;
 		placed.add(p.id);
-		for (const r of listed) if (r.refines?.includes(p.id)) place(r);
+		const names = namesFor(p.id);
+		for (const r of listed) if (r.refines?.some((id) => names.has(id))) place(r);
 		ordered.push(p);
 	};
 	for (const p of listed) place(p);
@@ -74,6 +109,7 @@ function resolveFeatures(features, named, opts = {}) {
 		presets,
 		pathEdit: presets.flatMap((p) => p.pathEdit ?? []),
 		snapSources: presets.flatMap((p) => p.snapSources ?? []),
+		layers: Object.assign({}, ...presets.map((p) => p.layers ?? {})),
 		has: (id) => byId.has(id)
 	};
 }
@@ -100,6 +136,11 @@ function presetActions(enabled) {
 }
 /** Whether a preset's `tools` entry names built-ins, by id or set, rather than being a tool of its own. */
 var namesBuiltins = (t) => typeof t === "string" || "members" in t;
+/** The ids of the tools `preset` mounts itself: built-ins with their sets opened, then tools of its own. */
+var presetToolIds = (preset) => {
+	const tools = preset.tools ?? [];
+	return [...toolIdsOf(tools.filter(namesBuiltins)), ...tools.filter((t) => !namesBuiltins(t)).map((t) => t.id)];
+};
 /** The built-in tool ids the given presets mount. */
 function presetBuiltinTools(enabled) {
 	const ids = /* @__PURE__ */ new Set();
@@ -141,5 +182,5 @@ function presetChromeRules(enabled, owned) {
 }
 
 //#endregion
-export { SCENE_CANVAS_FEATURES, presetActions, presetAmbient, presetBuiltinTools, presetChromeRules, presetContributions, presetOwnTools, resolveFeatures };
+export { SCENE_CANVAS_FEATURES, namesBuiltins, presetActions, presetAmbient, presetBuiltinTools, presetChromeRules, presetContributions, presetOwnTools, presetToolIds, resolveFeatures };
 //# sourceMappingURL=features.js.map

package/dist/canvas/SceneCanvas/features.js.map

@@ -1 +1 @@
-{"version":3,"file":"features.js","names":[],"sources":["../../../src/canvas/SceneCanvas/features.ts"],"sourcesContent":["/**\n * The behavior presets `<SceneCanvas features>` composes. A bare canvas renders\n * its scene and keeps a selection nothing sets; every behavior beyond that is\n * turned on by a preset.\n *\n * A preset is a {@link FeaturePreset} object: the actions, tools, bindings,\n * chrome, and contributions one behavior brings. Core's own are named\n * (`'select'`, `'draw'`) and live in `namedPresets.ts`; a package ships its\n * own the same way and an app passes the object. Nothing here imports an\n * action, so a canvas reaches only the presets it is handed.\n *\n * A preset is not one of the `packages/core/src/features/<name>/` source\n * directories that `docs/taxonomy.md` calls a feature; the two share a word\n * and nothing else.\n */\nimport { toolIdsOf, type Action, type ToolEntry } from '@weasel-js/routing';\nimport { never } from 'features/chrome-caps/conditions';\nimport type { ChromeId, VisibilityRules } from 'features/chrome-caps/types';\nimport type { MoveBehavior } from 'interactions/gestures/types';\nimport type { UseMoveOptions } from 'interactions/actions/move/options';\nimport type { UseRotateOptions } from 'interactions/actions/rotate/options';\nimport type { Contribution, Tool } from 'tools/overlayBinding';\nimport type { PathEditExtension } from 'features/paths/pathEditExtension';\nimport type { SnapSource } from 'features/snap/types';\nimport type { SurfaceContribution } from '../surfaceContribution';\nimport type { BuiltinToolId } from './props';\n\n/** A core preset that names one behavior and abbreviates nothing. */\nexport type BaseFeature =\n  | 'view'\n  | 'select'\n  | 'outline'\n  | 'move'\n  | 'resize'\n  | 'rotate'\n  | 'edit'\n  | 'arrange'\n  | 'paths'\n  | 'ingest';\n\n/** A core preset that abbreviates others: `pick` is `select` + `outline`,\n *  `transform` is `resize` + `rotate`, and `draw` is every base preset. */\nexport type CompositeFeature = 'pick' | 'transform' | 'draw';\n\n/** A core preset's name, as `<SceneCanvas features>` takes it. */\nexport type Feature = BaseFeature | CompositeFeature;\n\n/** Every name `<SceneCanvas features>` accepts, each composite after the\n *  presets it names. */\nexport const SCENE_CANVAS_FEATURES: readonly Feature[] = [\n  'view', 'select', 'outline', 'pick', 'move', 'resize', 'rotate', 'transform',\n  'edit', 'arrange', 'paths', 'ingest', 'draw',\n];\n\n/** What a preset's ambient bindings are built from: the `selectTool` options\n *  that configure them. */\nexport interface FeatureBindingOptions {\n  move?: UseMoveOptions<unknown>;\n  rotate?: UseRotateOptions<unknown>;\n}\n\n/**\n * Everything turning one preset on means. Every role is optional.\n *\n * A package's preset is the unit an app opts into: the app imports it and\n * passes it to `features`, and an app that does not never loads its code.\n */\nexport interface FeaturePreset {\n  /** Unique per canvas. `refines` names presets by it, and two different\n   *  presets with one id on one canvas throw. */\n  readonly id: string;\n  /** The action descriptors it registers, in the order they register. They\n   *  are standard actions: `<SceneCanvas actions>` overrides and mutes them,\n   *  and `tune` reaches them. */\n  readonly actions?: readonly Action[];\n  /** Tools it mounts: a built-in by id or a set of them, or a tool of its own. */\n  readonly tools?: readonly (ToolEntry<BuiltinToolId> | Tool)[];\n  /** Its ambient bindings: an always-live entry routing a gesture to its\n   *  actions under any tool that does not claim the gesture itself. */\n  readonly ambient?: (options: FeatureBindingOptions) => Contribution;\n  /** Behaviors folded into every move the presets' ambient bindings run,\n   *  after the select tool's own: a snap, a readout of the drag. They reach\n   *  only a move some enabled preset binds, `move` or `draw`'s. */\n  readonly moveBehaviors?: readonly MoveBehavior<unknown>[];\n  /** Snap sources every snap session on the canvas asks, after\n   *  `<SceneCanvas snap.sources>` and the presets before it. */\n  readonly snapSources?: readonly SnapSource[];\n  /** The selection chrome that is drawn, and can be grabbed, only while it is on. */\n  readonly chrome?: readonly ChromeId[];\n  /** Default chrome-caps rules for chrome of its own, under the consumer's\n   *  `chromeVisibility`: a mark it draws only on request, say. */\n  readonly chromeRules?: VisibilityRules;\n  /** What it adds to path edit: marks, grabbable parts, what an edit keeps\n   *  true. Consulted in preset order. */\n  readonly pathEdit?: readonly PathEditExtension[];\n  /** Entries installed beside `<SceneCanvas ambient>`, with every role they\n   *  declare: deps, overlays, `attach`, views, frame hooks. A `tools` takeover\n   *  brings its own ambient and leaves them out. */\n  readonly contributions?: readonly SurfaceContribution[];\n  /** Ids of presets whose actions this one's register ahead of, so that where\n   *  both bind one gesture, this one's is tried first: anchor nudging ahead of\n   *  node nudging. A preset named here that is not on is ignored. */\n  readonly refines?: readonly string[];\n  /** Presets it turns on with itself, ahead of its own place in the order. */\n  readonly includes?: readonly FeaturePreset[];\n}\n\n/** What `<SceneCanvas features>` takes: a core preset's name or any preset. */\nexport type FeatureEntry = Feature | FeaturePreset;\n\n/** The names a canvas resolves: one preset each, or the presets a composite\n *  abbreviates. */\nexport interface NamedPresets {\n  readonly base: Readonly<Record<BaseFeature, FeaturePreset>>;\n  readonly composite: Readonly<Record<CompositeFeature, readonly BaseFeature[]>>;\n}\n\n/** Where a canvas finds presets beyond the objects it is handed: the names it\n *  resolves, if any, and the actions it registers once a tool binds them. */\nexport interface PresetSource {\n  readonly named: NamedPresets | null;\n  /** Actions registered only when a tool or contribution binds them. */\n  readonly pool: readonly Action[];\n}\n\n/** The presets a canvas runs with, in the order their actions register. */\nexport interface EnabledPresets {\n  readonly presets: readonly FeaturePreset[];\n  /** Their path-edit extensions, in order. */\n  readonly pathEdit: readonly PathEditExtension[];\n  /** Their snap sources, in order. */\n  readonly snapSources: readonly SnapSource[];\n  /** Whether a preset with this id is on. */\n  has(id: string): boolean;\n}\n\n/**\n * The presets a canvas runs with: names expanded, `includes` pulled in, each\n * preset once, and every one placed ahead of the presets it `refines`. Ties\n * keep the order given. Where names resolve, a `viewport` config turns on the\n * `view` preset, since that prop only configures what `view` turns on.\n *\n * `selectRotates: false` is `selectTool.rotate === false`: every preset keeps\n * its actions, but loses its ambient `rotate` bindings and the rotation handle\n * from its chrome, which hides the handle unless a consumer rule shows it.\n */\nexport function resolveFeatures(\n  features: readonly FeatureEntry[] | undefined,\n  named: NamedPresets | null,\n  opts: { viewport?: boolean; selectRotates?: boolean } = {},\n): EnabledPresets {\n  const listed: FeaturePreset[] = [];\n  const byId = new Map<string, FeaturePreset>();\n  const add = (p: FeaturePreset): void => {\n    const held = byId.get(p.id);\n    if (held === p) return;\n    if (held) throw new Error(`[SceneCanvas] two different presets have the id \"${p.id}\"`);\n    byId.set(p.id, p);\n    for (const inner of p.includes ?? []) add(inner);\n    listed.push(p);\n  };\n  for (const f of features ?? []) {\n    if (typeof f !== 'string') add(f);\n    else if (!named) throw new Error(`[SceneCanvas] this canvas resolves no preset names; pass the preset for \"${f}\"`);\n    else if (f in named.composite) for (const b of named.composite[f as CompositeFeature]) add(named.base[b]);\n    else add(named.base[f as BaseFeature]);\n  }\n  if (opts.viewport && named) add(named.base.view);\n\n  const ordered: FeaturePreset[] = [];\n  const placed = new Set<string>();\n  const place = (p: FeaturePreset): void => {\n    if (placed.has(p.id)) return;\n    placed.add(p.id);\n    for (const r of listed) if (r.refines?.includes(p.id)) place(r);\n    ordered.push(p);\n  };\n  for (const p of listed) place(p);\n  const presets = opts.selectRotates === false ? ordered.map(withoutSelectRotate) : ordered;\n  return {\n    presets,\n    pathEdit: presets.flatMap((p) => p.pathEdit ?? []),\n    snapSources: presets.flatMap((p) => p.snapSources ?? []),\n    has: (id) => byId.has(id),\n  };\n}\n\nconst ROTATION_HANDLE: ChromeId = 'selection.rotation-handle';\n\n/** `p` without its ambient `rotate` bindings or the rotation handle. */\nfunction withoutSelectRotate(p: FeaturePreset): FeaturePreset {\n  const { ambient, chrome } = p;\n  if (!ambient && !chrome?.includes(ROTATION_HANDLE)) return p;\n  return {\n    ...p,\n    ...(ambient ? {\n      ambient: (o: FeatureBindingOptions): Contribution => {\n        const c = ambient(o);\n        return c.bindings ? { ...c, bindings: c.bindings.filter((b) => b.actionId !== 'rotate') } : c;\n      },\n    } : {}),\n    ...(chrome ? { chrome: chrome.filter((id) => id !== ROTATION_HANDLE) } : {}),\n  };\n}\n\n/** The actions the given presets register, in registration order. */\nexport function presetActions(enabled: EnabledPresets): Action[] {\n  return enabled.presets.flatMap((p) => p.actions ?? []);\n}\n\n/** Whether a preset's `tools` entry names built-ins, by id or set, rather than being a tool of its own. */\nconst namesBuiltins = (t: ToolEntry<BuiltinToolId> | Tool): t is ToolEntry<BuiltinToolId> =>\n  typeof t === 'string' || 'members' in t;\n\n/** The built-in tool ids the given presets mount. */\nexport function presetBuiltinTools(enabled: EnabledPresets): Set<BuiltinToolId> {\n  const ids = new Set<BuiltinToolId>();\n  for (const p of enabled.presets) {\n    for (const id of toolIdsOf((p.tools ?? []).filter(namesBuiltins))) ids.add(id);\n  }\n  return ids;\n}\n\n/** The tools of their own the given presets mount, by id. */\nexport function presetOwnTools(enabled: EnabledPresets): Record<string, Tool> {\n  const out: Record<string, Tool> = {};\n  for (const p of enabled.presets) for (const t of p.tools ?? []) if (!namesBuiltins(t)) out[t.id] = t;\n  return out;\n}\n\n/** The given presets' ambient entries and contributions, in the order they are\n *  matched. Their `moveBehaviors` follow the ones `options.move` brings. */\nexport function presetAmbient(enabled: EnabledPresets, options: FeatureBindingOptions): Contribution[] {\n  const extra = enabled.presets.flatMap((p) => p.moveBehaviors ?? []);\n  const move = extra.length === 0\n    ? options.move\n    : { ...options.move, behaviors: [...(options.move?.behaviors ?? []), ...extra] };\n  const opts = { ...options, move };\n  return enabled.presets.flatMap((p) => (p.ambient ? [p.ambient(opts)] : []));\n}\n\n/** The given presets' contributions, in preset order. */\nexport function presetContributions(enabled: EnabledPresets): SurfaceContribution[] {\n  return enabled.presets.flatMap((p) => p.contributions ?? []);\n}\n\n/** The enabled presets' own `chromeRules`, then rules hiding each chrome id\n *  in `owned` that no enabled preset turns on. `never` also takes a handle out\n *  of hit-testing, so a hidden one cannot be grabbed. */\nexport function presetChromeRules(enabled: EnabledPresets, owned: readonly ChromeId[]): VisibilityRules {\n  const on = new Set(enabled.presets.flatMap((p) => p.chrome ?? []));\n  const rules: VisibilityRules = Object.assign({}, ...enabled.presets.map((p) => p.chromeRules ?? {}));\n  for (const id of owned) if (!on.has(id)) rules[id] = never;\n  return rules;\n}\n"],"mappings":"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"}
+{"version":3,"file":"features.js","names":[],"sources":["../../../src/canvas/SceneCanvas/features.ts"],"sourcesContent":["/**\n * The behavior presets `<SceneCanvas features>` composes. A bare canvas renders\n * its scene, keeps a selection nothing sets, and undoes and redoes whatever\n * changed it; every behavior beyond that is turned on by a preset.\n *\n * A preset is a {@link FeaturePreset} object: the actions, tools, bindings,\n * chrome, and contributions one behavior brings, and the presets it includes.\n * One that holds only actions, tools, and includes is a bundle, pure grouping;\n * one with any other role is an atom, whose parts only work together. Core's\n * own are named (`'select'`, `'draw'`) and live in `namedPresets.ts`; a\n * package ships its own the same way and an app passes the object. Nothing\n * here imports an action, so a canvas reaches only the presets it is handed.\n *\n * A preset is not one of the `packages/core/src/domains/<name>/` source\n * directories that `docs/taxonomy.md` calls a feature; the two share a word\n * and nothing else.\n */\nimport { toolIdsOf, type Action, type ToolEntry } from '@weasel-js/routing';\nimport { never } from 'domains/chrome-caps/conditions';\nimport type { ChromeId, VisibilityRules } from 'domains/chrome-caps/types';\nimport type { MoveBehavior } from 'interactions/gestures/types';\nimport type { UseMoveOptions } from 'interactions/actions/move/options';\nimport type { UseRotateOptions } from 'interactions/actions/rotate/options';\nimport type { Contribution, Tool } from 'tools/overlayBinding';\nimport type { PathEditExtension } from 'domains/paths/pathEditExtension';\nimport type { SnapSource } from 'domains/snap/types';\nimport type { SurfaceContribution } from '../surfaceContribution';\nimport type { CustomLayerEntry } from '../layerSlots';\nimport type { BuiltinToolId } from './props';\n\n/** Every core preset's name `<SceneCanvas features>` accepts, each after the\n *  presets it includes. */\nexport const SCENE_CANVAS_FEATURES = [\n  'tools:select', 'tools:view', 'tools:shape', 'tools:draw', 'tools:type', 'tools:page',\n  'view', 'select', 'outline', 'pick', 'move', 'resize', 'rotate', 'transform',\n  'escape', 'contextMenu', 'selectAll', 'duplicate', 'delete', 'group', 'nudge', 'style', 'clipboard', 'edit',\n  'flip', 'reorder', 'align', 'distribute', 'arrange',\n  'anchorKeys', 'pathfinder', 'outlines', 'pathEdit', 'pathCommands', 'paths',\n  'ingest', 'draw',\n] as const;\n\n/** A core preset's name, as `<SceneCanvas features>` takes it. */\nexport type Feature = (typeof SCENE_CANVAS_FEATURES)[number];\n\n/** What a preset's ambient bindings are built from: the `selectTool` options\n *  that configure them. */\nexport interface FeatureBindingOptions {\n  move?: UseMoveOptions<unknown>;\n  rotate?: UseRotateOptions<unknown>;\n}\n\n/**\n * Everything turning one preset on means. Every role is optional.\n *\n * A package's preset is the unit an app opts into: the app imports it and\n * passes it to `features`, and an app that does not never loads its code.\n */\nexport interface FeaturePreset {\n  /** What a person calls it, where one is listed. Absent, the id. */\n  readonly label?: string;\n  /** Unique per canvas. `refines` names presets by it, and two different\n   *  presets with one id on one canvas throw. */\n  readonly id: string;\n  /** The action descriptors it registers, in the order they register. They\n   *  are standard actions: `<SceneCanvas actions>` overrides and mutes them,\n   *  and `tune` reaches them. */\n  readonly actions?: readonly Action[];\n  /** Tools it mounts: a built-in by id or a set of them, or a tool of its own. */\n  readonly tools?: readonly (ToolEntry<BuiltinToolId> | Tool)[];\n  /** Its ambient bindings: an always-live entry routing a gesture to its\n   *  actions under any tool that does not claim the gesture itself. */\n  readonly ambient?: (options: FeatureBindingOptions) => Contribution;\n  /** Behaviors folded into every move the presets' ambient bindings run,\n   *  after the select tool's own: a snap, a readout of the drag. They reach\n   *  only a move some enabled preset binds, `move` or `draw`'s. */\n  readonly moveBehaviors?: readonly MoveBehavior<unknown>[];\n  /** Snap sources every snap session on the canvas asks, after\n   *  `<SceneCanvas snap.sources>` and the presets before it. */\n  readonly snapSources?: readonly SnapSource[];\n  /** Layers it adds to the render stack, by slot, as `<SceneCanvas layers>`\n   *  takes them: `grid` fills the grid slot, any other key adds a layer. A\n   *  slot `<SceneCanvas layers>` names, `null` included, keeps the consumer's. */\n  readonly layers?: Readonly<Record<string, CustomLayerEntry>>;\n  /** The selection chrome that is drawn, and can be grabbed, only while it is on. */\n  readonly chrome?: readonly ChromeId[];\n  /** Default chrome-caps rules for chrome of its own, under the consumer's\n   *  `chromeVisibility`: a mark it draws only on request, say. */\n  readonly chromeRules?: VisibilityRules;\n  /** What it adds to path edit: marks, grabbable parts, what an edit keeps\n   *  true. Consulted in preset order. */\n  readonly pathEdit?: readonly PathEditExtension[];\n  /** Entries installed beside `<SceneCanvas ambient>`, with every role they\n   *  declare: deps, overlays, `attach`, views, frame hooks. A `tools` takeover\n   *  brings its own ambient and leaves them out. */\n  readonly contributions?: readonly SurfaceContribution[];\n  /** Ids of presets whose actions, and those of every preset they include,\n   *  this one's register ahead of, so that where both bind one gesture, this\n   *  one's is tried first: anchor nudging ahead of node nudging. A preset named\n   *  here that is not on is ignored. */\n  readonly refines?: readonly string[];\n  /** Presets it turns on with itself, ahead of its own place in the order. */\n  readonly includes?: readonly FeaturePreset[];\n}\n\n/** What `<SceneCanvas features>` takes: a core preset's name or any preset. */\nexport type FeatureEntry = Feature | FeaturePreset;\n\n/** The names a canvas resolves, each to its preset. */\nexport type NamedPresets = Readonly<Record<string, FeaturePreset>>;\n\n/** Where a canvas finds presets beyond the objects it is handed: the names it\n *  resolves, if any, and the actions it registers once a tool binds them. */\nexport interface PresetSource {\n  readonly named: NamedPresets | null;\n  /** Actions every canvas registers whatever its presets: undo and redo, since anything that changes\n   *  the scene — a preset's action, a tool, the host — leaves history to step through. */\n  readonly baseline?: readonly Action[];\n  /** Actions registered only when a tool or contribution binds them. */\n  readonly pool: readonly Action[];\n}\n\n/** The presets a canvas runs with, in the order their actions register. */\nexport interface EnabledPresets {\n  readonly presets: readonly FeaturePreset[];\n  /** Their path-edit extensions, in order. */\n  readonly pathEdit: readonly PathEditExtension[];\n  /** Their snap sources, in order. */\n  readonly snapSources: readonly SnapSource[];\n  /** Their layers by slot; a later preset's wins a slot both name. */\n  readonly layers: Readonly<Record<string, CustomLayerEntry>>;\n  /** Whether a preset with this id is on. */\n  has(id: string): boolean;\n}\n\n/**\n * The presets a canvas runs with: names expanded, `includes` pulled in, each\n * preset once, and every one placed ahead of the presets it `refines` and what those include. Ties\n * keep the order given. Where names resolve, a `viewport` config turns on the\n * `view` preset, since that prop only configures what `view` turns on.\n *\n * `selectRotates: false` is `selectTool.rotate === false`: every preset keeps\n * its actions, but loses its ambient `rotate` bindings and the rotation handle\n * from its chrome, which hides the handle unless a consumer rule shows it.\n */\nexport function resolveFeatures(\n  features: readonly FeatureEntry[] | undefined,\n  named: NamedPresets | null,\n  opts: { viewport?: boolean; selectRotates?: boolean } = {},\n): EnabledPresets {\n  const listed: FeaturePreset[] = [];\n  const byId = new Map<string, FeaturePreset>();\n  const add = (p: FeaturePreset): void => {\n    const held = byId.get(p.id);\n    if (held === p) return;\n    if (held) throw new Error(`[SceneCanvas] two different presets have the id \"${p.id}\"`);\n    byId.set(p.id, p);\n    for (const inner of p.includes ?? []) add(inner);\n    listed.push(p);\n  };\n  for (const f of features ?? []) {\n    if (typeof f !== 'string') add(f);\n    else if (!named) throw new Error(`[SceneCanvas] this canvas resolves no preset names; pass the preset for \"${f}\"`);\n    else if (!Object.hasOwn(named, f)) throw new Error(`[SceneCanvas] no preset is named \"${f}\"`);\n    else add(named[f]!);\n  }\n  if (opts.viewport && named?.view) add(named.view);\n\n  // Each preset's id and the ids of every preset that includes it, at any depth: what a refinement of it can name.\n  const parents = new Map<string, string[]>();\n  for (const p of listed) for (const inner of p.includes ?? []) parents.set(inner.id, [...(parents.get(inner.id) ?? []), p.id]);\n  const namesFor = (id: string, out = new Set<string>()): Set<string> => {\n    if (out.has(id)) return out;\n    out.add(id);\n    for (const up of parents.get(id) ?? []) namesFor(up, out);\n    return out;\n  };\n  const ordered: FeaturePreset[] = [];\n  const placed = new Set<string>();\n  const place = (p: FeaturePreset): void => {\n    if (placed.has(p.id)) return;\n    placed.add(p.id);\n    const names = namesFor(p.id);\n    for (const r of listed) if (r.refines?.some((id) => names.has(id))) place(r);\n    ordered.push(p);\n  };\n  for (const p of listed) place(p);\n  const presets = opts.selectRotates === false ? ordered.map(withoutSelectRotate) : ordered;\n  return {\n    presets,\n    pathEdit: presets.flatMap((p) => p.pathEdit ?? []),\n    snapSources: presets.flatMap((p) => p.snapSources ?? []),\n    layers: Object.assign({}, ...presets.map((p) => p.layers ?? {})) as Record<string, CustomLayerEntry>,\n    has: (id) => byId.has(id),\n  };\n}\n\nconst ROTATION_HANDLE: ChromeId = 'selection.rotation-handle';\n\n/** `p` without its ambient `rotate` bindings or the rotation handle. */\nfunction withoutSelectRotate(p: FeaturePreset): FeaturePreset {\n  const { ambient, chrome } = p;\n  if (!ambient && !chrome?.includes(ROTATION_HANDLE)) return p;\n  return {\n    ...p,\n    ...(ambient ? {\n      ambient: (o: FeatureBindingOptions): Contribution => {\n        const c = ambient(o);\n        return c.bindings ? { ...c, bindings: c.bindings.filter((b) => b.actionId !== 'rotate') } : c;\n      },\n    } : {}),\n    ...(chrome ? { chrome: chrome.filter((id) => id !== ROTATION_HANDLE) } : {}),\n  };\n}\n\n/** The actions the given presets register, in registration order. */\nexport function presetActions(enabled: EnabledPresets): Action[] {\n  return enabled.presets.flatMap((p) => p.actions ?? []);\n}\n\n/** Whether a preset's `tools` entry names built-ins, by id or set, rather than being a tool of its own. */\nexport const namesBuiltins = (t: ToolEntry<BuiltinToolId> | Tool): t is ToolEntry<BuiltinToolId> =>\n  typeof t === 'string' || 'members' in t;\n\n/** The ids of the tools `preset` mounts itself: built-ins with their sets opened, then tools of its own. */\nexport const presetToolIds = (preset: FeaturePreset): string[] => {\n  const tools = preset.tools ?? [];\n  return [...toolIdsOf(tools.filter(namesBuiltins)), ...tools.filter((t): t is Tool => !namesBuiltins(t)).map((t) => t.id)];\n};\n\n/** The built-in tool ids the given presets mount. */\nexport function presetBuiltinTools(enabled: EnabledPresets): Set<BuiltinToolId> {\n  const ids = new Set<BuiltinToolId>();\n  for (const p of enabled.presets) {\n    for (const id of toolIdsOf((p.tools ?? []).filter(namesBuiltins))) ids.add(id);\n  }\n  return ids;\n}\n\n/** The tools of their own the given presets mount, by id. */\nexport function presetOwnTools(enabled: EnabledPresets): Record<string, Tool> {\n  const out: Record<string, Tool> = {};\n  for (const p of enabled.presets) for (const t of p.tools ?? []) if (!namesBuiltins(t)) out[t.id] = t;\n  return out;\n}\n\n/** The given presets' ambient entries and contributions, in the order they are\n *  matched. Their `moveBehaviors` follow the ones `options.move` brings. */\nexport function presetAmbient(enabled: EnabledPresets, options: FeatureBindingOptions): Contribution[] {\n  const extra = enabled.presets.flatMap((p) => p.moveBehaviors ?? []);\n  const move = extra.length === 0\n    ? options.move\n    : { ...options.move, behaviors: [...(options.move?.behaviors ?? []), ...extra] };\n  const opts = { ...options, move };\n  return enabled.presets.flatMap((p) => (p.ambient ? [p.ambient(opts)] : []));\n}\n\n/** The given presets' contributions, in preset order. */\nexport function presetContributions(enabled: EnabledPresets): SurfaceContribution[] {\n  return enabled.presets.flatMap((p) => p.contributions ?? []);\n}\n\n/** The enabled presets' own `chromeRules`, then rules hiding each chrome id\n *  in `owned` that no enabled preset turns on. `never` also takes a handle out\n *  of hit-testing, so a hidden one cannot be grabbed. */\nexport function presetChromeRules(enabled: EnabledPresets, owned: readonly ChromeId[]): VisibilityRules {\n  const on = new Set(enabled.presets.flatMap((p) => p.chrome ?? []));\n  const rules: VisibilityRules = Object.assign({}, ...enabled.presets.map((p) => p.chromeRules ?? {}));\n  for (const id of owned) if (!on.has(id)) rules[id] = never;\n  return rules;\n}\n"],"mappings":"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"}

package/dist/canvas/SceneCanvas/mergeLayers.js

@@ -3,6 +3,15 @@ import { defaultDrawOne, defaultPaintBounds, paintBoundsFor } from "../defaultDr
 import { isCustomEntry } from "../layerSlots.js";
 
 //#region src/canvas/SceneCanvas/mergeLayers.ts
+/** `<SceneCanvas layers>` laid over the enabled presets' layers: a slot the
+*  consumer names, `null` included, is theirs, and the rest are the presets'. */
+function layersOverPresets(presetLayers, user) {
+	if (Object.keys(presetLayers).length === 0) return user;
+	return {
+		...presetLayers,
+		...user
+	};
+}
 /** Deep-merge user-supplied `layers` with kit defaults. Slots the user
 *  doesn't mention get filled with defaults; slots explicitly set to
 *  `null` are dropped. Partial slot configs are shallow-spread on top of the
@@ -39,5 +48,5 @@ function mergeLayersWithDefaults(user, targetScale = 1, baseSizes = {}) {
 }
 
 //#endregion
-export { mergeLayersWithDefaults };
+export { layersOverPresets, mergeLayersWithDefaults };
 //# sourceMappingURL=mergeLayers.js.map

package/dist/canvas/SceneCanvas/mergeLayers.js.map

@@ -1 +1 @@
-{"version":3,"file":"mergeLayers.js","names":[],"sources":["../../../src/canvas/SceneCanvas/mergeLayers.ts"],"sourcesContent":["import type { DrawCommand } from '@weasel-js/renderer';\nimport { targetSizesPx, type TargetSizesPx } from '../../core/device/targets';\nimport type { Node } from 'core/scene/types';\nimport { defaultDrawOne, defaultPaintBounds, paintBoundsFor } from '../defaultDrawOne';\nimport { isCustomEntry, type LayersMap } from '../layerSlots';\nimport type { SceneCanvasLayers } from './props';\n\n/** Deep-merge user-supplied `layers` with kit defaults. Slots the user\n *  doesn't mention get filled with defaults; slots explicitly set to\n *  `null` are dropped. Partial slot configs are shallow-spread on top of the\n *  default slot config. `targetScale` (from the {@link DeviceProfile}) and `baseSizes` go to `targetSizesPx`. */\nexport function mergeLayersWithDefaults<TData, TLayer extends string, TPose>(\n  user: SceneCanvasLayers<Node<TData, TLayer, TPose>, TPose> | undefined,\n  targetScale = 1, baseSizes: Partial<TargetSizesPx> = {},\n): LayersMap<Node<TData, TLayer, TPose>, TPose> {\n  const defaults = {\n    scene: {\n      drawOne: defaultDrawOne as (\n        node: Node<TData, TLayer, TPose>,\n        pose: TPose,\n      ) => DrawCommand[],\n      paintBounds: defaultPaintBounds<TData, TLayer, TPose>,\n    },\n    selectionOverlay: { handles: { size: targetSizesPx(targetScale, baseSizes).handle } },\n  };\n\n  if (!user) return defaults as LayersMap<Node<TData, TLayer, TPose>, TPose>;\n\n  // Start from a shallow copy of the user map so unknown slots pass through.\n  const result = { ...user } as LayersMap<Node<TData, TLayer, TPose>, TPose>;\n\n  if (!('scene' in user)) {\n    result.scene = defaults.scene;\n  } else if (user.scene === null || isCustomEntry(user.scene)) {\n    result.scene = user.scene;\n  } else {\n    const scene = { ...defaults.scene, ...user.scene };\n    result.scene = user.scene && 'paintBounds' in user.scene\n      ? scene\n      : { ...scene, paintBounds: paintBoundsFor<TData, TLayer, TPose>(scene.drawOne) };\n  }\n\n  if (!('selectionOverlay' in user)) {\n    result.selectionOverlay = defaults.selectionOverlay;\n  } else if (user.selectionOverlay === null || isCustomEntry(user.selectionOverlay)) {\n    result.selectionOverlay = user.selectionOverlay;\n  } else {\n    result.selectionOverlay = { ...defaults.selectionOverlay, ...user.selectionOverlay };\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;AAWA,SAAgB,wBACd,MACA,cAAc,GAAG,YAAoC,CAAC,GACR;CAC9C,MAAM,WAAW;EACf,OAAO;GACL,SAAS;GAIT,aAAa;EACf;EACA,kBAAkB,EAAE,SAAS,EAAE,MAAM,cAAc,aAAa,SAAS,CAAC,CAAC,OAAO,EAAE;CACtF;CAEA,IAAI,CAAC,MAAM,OAAO;CAGlB,MAAM,SAAS,EAAE,GAAG,KAAK;CAEzB,IAAI,EAAE,WAAW,OACf,OAAO,QAAQ,SAAS;MACnB,IAAI,KAAK,UAAU,QAAQ,cAAc,KAAK,KAAK,GACxD,OAAO,QAAQ,KAAK;MACf;EACL,MAAM,QAAQ;GAAE,GAAG,SAAS;GAAO,GAAG,KAAK;EAAM;EACjD,OAAO,QAAQ,KAAK,SAAS,iBAAiB,KAAK,QAC/C,QACA;GAAE,GAAG;GAAO,aAAa,eAAqC,MAAM,OAAO;EAAE;CACnF;CAEA,IAAI,EAAE,sBAAsB,OAC1B,OAAO,mBAAmB,SAAS;MAC9B,IAAI,KAAK,qBAAqB,QAAQ,cAAc,KAAK,gBAAgB,GAC9E,OAAO,mBAAmB,KAAK;MAE/B,OAAO,mBAAmB;EAAE,GAAG,SAAS;EAAkB,GAAG,KAAK;CAAiB;CAGrF,OAAO;AACT"}
+{"version":3,"file":"mergeLayers.js","names":[],"sources":["../../../src/canvas/SceneCanvas/mergeLayers.ts"],"sourcesContent":["import type { DrawCommand } from '@weasel-js/renderer';\nimport { targetSizesPx, type TargetSizesPx } from '../../core/device/targets';\nimport type { Node } from 'core/scene/types';\nimport { defaultDrawOne, defaultPaintBounds, paintBoundsFor } from '../defaultDrawOne';\nimport { isCustomEntry, type CustomLayerEntry, type LayersMap } from '../layerSlots';\nimport type { SceneCanvasLayers } from './props';\n\n/** `<SceneCanvas layers>` laid over the enabled presets' layers: a slot the\n *  consumer names, `null` included, is theirs, and the rest are the presets'. */\nexport function layersOverPresets<L extends object>(\n  presetLayers: Readonly<Record<string, CustomLayerEntry>>,\n  user: L | undefined,\n): L | undefined {\n  if (Object.keys(presetLayers).length === 0) return user;\n  return { ...presetLayers, ...user } as L;\n}\n\n/** Deep-merge user-supplied `layers` with kit defaults. Slots the user\n *  doesn't mention get filled with defaults; slots explicitly set to\n *  `null` are dropped. Partial slot configs are shallow-spread on top of the\n *  default slot config. `targetScale` (from the {@link DeviceProfile}) and `baseSizes` go to `targetSizesPx`. */\nexport function mergeLayersWithDefaults<TData, TLayer extends string, TPose>(\n  user: SceneCanvasLayers<Node<TData, TLayer, TPose>, TPose> | undefined,\n  targetScale = 1, baseSizes: Partial<TargetSizesPx> = {},\n): LayersMap<Node<TData, TLayer, TPose>, TPose> {\n  const defaults = {\n    scene: {\n      drawOne: defaultDrawOne as (\n        node: Node<TData, TLayer, TPose>,\n        pose: TPose,\n      ) => DrawCommand[],\n      paintBounds: defaultPaintBounds<TData, TLayer, TPose>,\n    },\n    selectionOverlay: { handles: { size: targetSizesPx(targetScale, baseSizes).handle } },\n  };\n\n  if (!user) return defaults as LayersMap<Node<TData, TLayer, TPose>, TPose>;\n\n  // Start from a shallow copy of the user map so unknown slots pass through.\n  const result = { ...user } as LayersMap<Node<TData, TLayer, TPose>, TPose>;\n\n  if (!('scene' in user)) {\n    result.scene = defaults.scene;\n  } else if (user.scene === null || isCustomEntry(user.scene)) {\n    result.scene = user.scene;\n  } else {\n    const scene = { ...defaults.scene, ...user.scene };\n    result.scene = user.scene && 'paintBounds' in user.scene\n      ? scene\n      : { ...scene, paintBounds: paintBoundsFor<TData, TLayer, TPose>(scene.drawOne) };\n  }\n\n  if (!('selectionOverlay' in user)) {\n    result.selectionOverlay = defaults.selectionOverlay;\n  } else if (user.selectionOverlay === null || isCustomEntry(user.selectionOverlay)) {\n    result.selectionOverlay = user.selectionOverlay;\n  } else {\n    result.selectionOverlay = { ...defaults.selectionOverlay, ...user.selectionOverlay };\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;AASA,SAAgB,kBACd,cACA,MACe;CACf,IAAI,OAAO,KAAK,YAAY,CAAC,CAAC,WAAW,GAAG,OAAO;CACnD,OAAO;EAAE,GAAG;EAAc,GAAG;CAAK;AACpC;;;;;AAMA,SAAgB,wBACd,MACA,cAAc,GAAG,YAAoC,CAAC,GACR;CAC9C,MAAM,WAAW;EACf,OAAO;GACL,SAAS;GAIT,aAAa;EACf;EACA,kBAAkB,EAAE,SAAS,EAAE,MAAM,cAAc,aAAa,SAAS,CAAC,CAAC,OAAO,EAAE;CACtF;CAEA,IAAI,CAAC,MAAM,OAAO;CAGlB,MAAM,SAAS,EAAE,GAAG,KAAK;CAEzB,IAAI,EAAE,WAAW,OACf,OAAO,QAAQ,SAAS;MACnB,IAAI,KAAK,UAAU,QAAQ,cAAc,KAAK,KAAK,GACxD,OAAO,QAAQ,KAAK;MACf;EACL,MAAM,QAAQ;GAAE,GAAG,SAAS;GAAO,GAAG,KAAK;EAAM;EACjD,OAAO,QAAQ,KAAK,SAAS,iBAAiB,KAAK,QAC/C,QACA;GAAE,GAAG;GAAO,aAAa,eAAqC,MAAM,OAAO;EAAE;CACnF;CAEA,IAAI,EAAE,sBAAsB,OAC1B,OAAO,mBAAmB,SAAS;MAC9B,IAAI,KAAK,qBAAqB,QAAQ,cAAc,KAAK,gBAAgB,GAC9E,OAAO,mBAAmB,KAAK;MAE/B,OAAO,mBAAmB;EAAE,GAAG,SAAS;EAAkB,GAAG,KAAK;CAAiB;CAGrF,OAAO;AACT"}

package/dist/canvas/SceneCanvas/namedPresets.js

@@ -1,56 +1,84 @@
-import { arrangePreset } from "./presets/arrange.js";
-import { editPreset } from "./presets/edit.js";
+import { alignPreset, arrangePreset, distributePreset, flipPreset, reorderPreset } from "./presets/arrange.js";
+import { clipboardPreset, contextMenuPreset, deletePreset, duplicatePreset, editPreset, escapePreset, groupPreset, nudgePreset, selectAllPreset, stylePreset } from "./presets/edit.js";
 import { ingestPreset } from "./presets/ingest.js";
-import { pathsPreset } from "./presets/paths.js";
+import { anchorKeysPreset, outlinesPreset, pathCommandsPreset, pathEditPreset, pathfinderPreset, pathsPreset } from "./presets/paths.js";
+import { drawToolsPreset, pageToolsPreset, selectToolsPreset, shapeToolsPreset, typeToolsPreset, viewToolsPreset } from "./presets/tools.js";
 import { selectPreset } from "./presets/select.js";
-import { toolDrivenActions } from "./presets/toolDriven.js";
 import { movePreset, outlinePreset, resizePreset, rotatePreset } from "./presets/transform.js";
 import { viewPreset } from "./presets/view.js";
+import { drawPreset, pickPreset, transformPreset } from "./presets/composites.js";
+import { toolDrivenActions } from "./presets/toolDriven.js";
+import { BASELINE_ACTIONS } from "./presets/baseline.js";
 
 //#region src/canvas/SceneCanvas/namedPresets.ts
-/** Each core preset by name. `draw` turns them on in this order. */
+/** Each core preset by name, in the order `SCENE_CANVAS_FEATURES` lists them. */
 var FEATURE_PRESETS = {
+	"tools:select": selectToolsPreset,
+	"tools:view": viewToolsPreset,
+	"tools:shape": shapeToolsPreset,
+	"tools:draw": drawToolsPreset,
+	"tools:type": typeToolsPreset,
+	"tools:page": pageToolsPreset,
 	view: viewPreset,
 	select: selectPreset,
 	outline: outlinePreset,
+	pick: pickPreset,
+	move: movePreset,
 	resize: resizePreset,
 	rotate: rotatePreset,
-	move: movePreset,
+	transform: transformPreset,
+	escape: escapePreset,
+	contextMenu: contextMenuPreset,
+	selectAll: selectAllPreset,
+	duplicate: duplicatePreset,
+	delete: deletePreset,
+	group: groupPreset,
+	nudge: nudgePreset,
+	style: stylePreset,
+	clipboard: clipboardPreset,
 	edit: editPreset,
+	flip: flipPreset,
+	reorder: reorderPreset,
+	align: alignPreset,
+	distribute: distributePreset,
 	arrange: arrangePreset,
+	anchorKeys: anchorKeysPreset,
+	pathfinder: pathfinderPreset,
+	outlines: outlinesPreset,
+	pathEdit: pathEditPreset,
+	pathCommands: pathCommandsPreset,
 	paths: pathsPreset,
-	ingest: ingestPreset
-};
-var BASE_FEATURES = Object.keys(FEATURE_PRESETS);
-/** The base presets each composite preset turns on. */
-var COMPOSITE_FEATURES = {
-	pick: ["select", "outline"],
-	transform: ["resize", "rotate"],
-	draw: BASE_FEATURES
+	ingest: ingestPreset,
+	draw: drawPreset
 };
+var FEATURES = Object.keys(FEATURE_PRESETS);
 /** The names `<SceneCanvas>` resolves. */
-var CORE_NAMED_PRESETS = {
-	base: FEATURE_PRESETS,
-	composite: COMPOSITE_FEATURES
-};
-/** The kit-standard action ids each preset registers. */
-var FEATURE_ACTION_IDS = Object.fromEntries(BASE_FEATURES.map((f) => [f, (FEATURE_PRESETS[f].actions ?? []).map((a) => a.id)]));
+var CORE_NAMED_PRESETS = FEATURE_PRESETS;
+/** The kit-standard action ids each preset registers itself, leaving out those of the presets it includes. */
+var FEATURE_ACTION_IDS = Object.fromEntries(FEATURES.map((f) => [f, (FEATURE_PRESETS[f].actions ?? []).map((a) => a.id)]));
 /**
 * Kit-standard actions no preset registers: they belong to the tools that bind
 * them. A canvas registers each one whenever a tool it carries names it in a
 * binding — `insert` with any shape tool, `enterTextEdit` with the text tool.
 */
 var TOOL_DRIVEN_ACTION_IDS = toolDrivenActions.map((a) => a.id);
-/** Every kit-standard action: each core preset's, in table order, then the
+/** The kit-standard actions every canvas registers, preset or none: undo and redo. */
+var BASELINE_ACTION_IDS = BASELINE_ACTIONS.map((a) => a.id);
+/** Every kit-standard action: the baseline, each core preset's in table order, then the
 *  tool-driven ones. */
-var KIT_STANDARD_ACTIONS = [...BASE_FEATURES.flatMap((f) => FEATURE_PRESETS[f].actions ?? []), ...toolDrivenActions];
+var KIT_STANDARD_ACTIONS = [
+	...BASELINE_ACTIONS,
+	...FEATURES.flatMap((f) => FEATURE_PRESETS[f].actions ?? []),
+	...toolDrivenActions
+];
 /** What `<SceneCanvas>` resolves `features` through: every core name, and
 *  every kit-standard action for its tools to bring. */
 var CORE_PRESET_SOURCE = {
 	named: CORE_NAMED_PRESETS,
-	pool: KIT_STANDARD_ACTIONS
+	pool: KIT_STANDARD_ACTIONS,
+	baseline: BASELINE_ACTIONS
 };
 
 //#endregion
-export { COMPOSITE_FEATURES, CORE_NAMED_PRESETS, CORE_PRESET_SOURCE, FEATURE_ACTION_IDS, FEATURE_PRESETS, KIT_STANDARD_ACTIONS, TOOL_DRIVEN_ACTION_IDS };
+export { BASELINE_ACTION_IDS, CORE_NAMED_PRESETS, CORE_PRESET_SOURCE, FEATURE_ACTION_IDS, FEATURE_PRESETS, KIT_STANDARD_ACTIONS, TOOL_DRIVEN_ACTION_IDS };
 //# sourceMappingURL=namedPresets.js.map

package/dist/canvas/SceneCanvas/namedPresets.js.map

@@ -1 +1 @@
-{"version":3,"file":"namedPresets.js","names":[],"sources":["../../../src/canvas/SceneCanvas/namedPresets.ts"],"sourcesContent":["/**\n * Core's presets by name: what `features={['draw']}` resolves through.\n * Importing this module loads every core preset's actions; a canvas handed\n * only preset objects never reaches it.\n */\nimport type { Action } from '@weasel-js/routing';\nimport type { BaseFeature, CompositeFeature, FeaturePreset, NamedPresets, PresetSource } from './features';\nimport { arrangePreset } from './presets/arrange';\nimport { editPreset } from './presets/edit';\nimport { ingestPreset } from './presets/ingest';\nimport { pathsPreset } from './presets/paths';\nimport { selectPreset } from './presets/select';\nimport { toolDrivenActions } from './presets/toolDriven';\nimport { movePreset, outlinePreset, resizePreset, rotatePreset } from './presets/transform';\nimport { viewPreset } from './presets/view';\n\n/** Each core preset by name. `draw` turns them on in this order. */\nexport const FEATURE_PRESETS: Readonly<Record<BaseFeature, FeaturePreset>> = {\n  view: viewPreset,\n  select: selectPreset,\n  outline: outlinePreset,\n  resize: resizePreset,\n  rotate: rotatePreset,\n  move: movePreset,\n  edit: editPreset,\n  arrange: arrangePreset,\n  paths: pathsPreset,\n  ingest: ingestPreset,\n};\n\nconst BASE_FEATURES = Object.keys(FEATURE_PRESETS) as BaseFeature[];\n\n/** The base presets each composite preset turns on. */\nexport const COMPOSITE_FEATURES: Readonly<Record<CompositeFeature, readonly BaseFeature[]>> = {\n  pick: ['select', 'outline'],\n  transform: ['resize', 'rotate'],\n  draw: BASE_FEATURES,\n};\n\n/** The names `<SceneCanvas>` resolves. */\nexport const CORE_NAMED_PRESETS: NamedPresets = { base: FEATURE_PRESETS, composite: COMPOSITE_FEATURES };\n\n/** The kit-standard action ids each preset registers. */\nexport const FEATURE_ACTION_IDS = Object.fromEntries(\n  BASE_FEATURES.map((f): [BaseFeature, readonly string[]] => [f, (FEATURE_PRESETS[f].actions ?? []).map((a) => a.id)]),\n) as Readonly<Record<BaseFeature, readonly string[]>>;\n\n/**\n * Kit-standard actions no preset registers: they belong to the tools that bind\n * them. A canvas registers each one whenever a tool it carries names it in a\n * binding — `insert` with any shape tool, `enterTextEdit` with the text tool.\n */\nexport const TOOL_DRIVEN_ACTION_IDS: readonly string[] = toolDrivenActions.map((a) => a.id);\n\n/** Every kit-standard action: each core preset's, in table order, then the\n *  tool-driven ones. */\nexport const KIT_STANDARD_ACTIONS: readonly Action[] = [\n  ...BASE_FEATURES.flatMap((f) => FEATURE_PRESETS[f].actions ?? []),\n  ...toolDrivenActions,\n];\n\n/** What `<SceneCanvas>` resolves `features` through: every core name, and\n *  every kit-standard action for its tools to bring. */\nexport const CORE_PRESET_SOURCE: PresetSource = { named: CORE_NAMED_PRESETS, pool: KIT_STANDARD_ACTIONS };\n"],"mappings":";;;;;;;;;;;AAiBA,IAAa,kBAAgE;CAC3E,MAAM;CACN,QAAQ;CACR,SAAS;CACT,QAAQ;CACR,QAAQ;CACR,MAAM;CACN,MAAM;CACN,SAAS;CACT,OAAO;CACP,QAAQ;AACV;AAEA,IAAM,gBAAgB,OAAO,KAAK,eAAe;;AAGjD,IAAa,qBAAiF;CAC5F,MAAM,CAAC,UAAU,SAAS;CAC1B,WAAW,CAAC,UAAU,QAAQ;CAC9B,MAAM;AACR;;AAGA,IAAa,qBAAmC;CAAE,MAAM;CAAiB,WAAW;AAAmB;;AAGvG,IAAa,qBAAqB,OAAO,YACvC,cAAc,KAAK,MAAwC,CAAC,IAAI,gBAAgB,EAAE,CAAC,WAAW,CAAC,EAAA,CAAG,KAAK,MAAM,EAAE,EAAE,CAAC,CAAC,CACrH;;;;;;AAOA,IAAa,yBAA4C,kBAAkB,KAAK,MAAM,EAAE,EAAE;;;AAI1F,IAAa,uBAA0C,CACrD,GAAG,cAAc,SAAS,MAAM,gBAAgB,EAAE,CAAC,WAAW,CAAC,CAAC,GAChE,GAAG,iBACL;;;AAIA,IAAa,qBAAmC;CAAE,OAAO;CAAoB,MAAM;AAAqB"}
+{"version":3,"file":"namedPresets.js","names":[],"sources":["../../../src/canvas/SceneCanvas/namedPresets.ts"],"sourcesContent":["/**\n * Core's presets by name: what `features={['draw']}` resolves through.\n * Importing this module loads every core preset's actions; a canvas handed\n * only preset objects never reaches it.\n */\nimport type { Action } from '@weasel-js/routing';\nimport type { Feature, FeaturePreset, NamedPresets, PresetSource } from './features';\nimport {\n  alignPreset, arrangePreset, distributePreset, flipPreset, reorderPreset,\n} from './presets/arrange';\nimport { drawPreset, pickPreset, transformPreset } from './presets/composites';\nimport {\n  clipboardPreset, contextMenuPreset, deletePreset, duplicatePreset, editPreset, escapePreset, groupPreset,\n  nudgePreset, selectAllPreset, stylePreset,\n} from './presets/edit';\nimport { ingestPreset } from './presets/ingest';\nimport {\n  anchorKeysPreset, outlinesPreset, pathCommandsPreset, pathEditPreset, pathfinderPreset, pathsPreset,\n} from './presets/paths';\nimport { selectPreset } from './presets/select';\nimport { toolDrivenActions } from './presets/toolDriven';\nimport {\n  drawToolsPreset, pageToolsPreset, selectToolsPreset, shapeToolsPreset, typeToolsPreset, viewToolsPreset,\n} from './presets/tools';\nimport { BASELINE_ACTIONS } from './presets/baseline';\nimport { movePreset, outlinePreset, resizePreset, rotatePreset } from './presets/transform';\nimport { viewPreset } from './presets/view';\n\n/** Each core preset by name, in the order `SCENE_CANVAS_FEATURES` lists them. */\nexport const FEATURE_PRESETS: Readonly<Record<Feature, FeaturePreset>> = {\n  'tools:select': selectToolsPreset,\n  'tools:view': viewToolsPreset,\n  'tools:shape': shapeToolsPreset,\n  'tools:draw': drawToolsPreset,\n  'tools:type': typeToolsPreset,\n  'tools:page': pageToolsPreset,\n  view: viewPreset,\n  select: selectPreset,\n  outline: outlinePreset,\n  pick: pickPreset,\n  move: movePreset,\n  resize: resizePreset,\n  rotate: rotatePreset,\n  transform: transformPreset,\n  escape: escapePreset,\n  contextMenu: contextMenuPreset,\n  selectAll: selectAllPreset,\n  duplicate: duplicatePreset,\n  delete: deletePreset,\n  group: groupPreset,\n  nudge: nudgePreset,\n  style: stylePreset,\n  clipboard: clipboardPreset,\n  edit: editPreset,\n  flip: flipPreset,\n  reorder: reorderPreset,\n  align: alignPreset,\n  distribute: distributePreset,\n  arrange: arrangePreset,\n  anchorKeys: anchorKeysPreset,\n  pathfinder: pathfinderPreset,\n  outlines: outlinesPreset,\n  pathEdit: pathEditPreset,\n  pathCommands: pathCommandsPreset,\n  paths: pathsPreset,\n  ingest: ingestPreset,\n  draw: drawPreset,\n};\n\nconst FEATURES = Object.keys(FEATURE_PRESETS) as Feature[];\n\n/** The names `<SceneCanvas>` resolves. */\nexport const CORE_NAMED_PRESETS: NamedPresets = FEATURE_PRESETS;\n\n/** The kit-standard action ids each preset registers itself, leaving out those of the presets it includes. */\nexport const FEATURE_ACTION_IDS = Object.fromEntries(\n  FEATURES.map((f): [Feature, readonly string[]] => [f, (FEATURE_PRESETS[f].actions ?? []).map((a) => a.id)]),\n) as Readonly<Record<Feature, readonly string[]>>;\n\n/**\n * Kit-standard actions no preset registers: they belong to the tools that bind\n * them. A canvas registers each one whenever a tool it carries names it in a\n * binding — `insert` with any shape tool, `enterTextEdit` with the text tool.\n */\nexport const TOOL_DRIVEN_ACTION_IDS: readonly string[] = toolDrivenActions.map((a) => a.id);\n\n/** The kit-standard actions every canvas registers, preset or none: undo and redo. */\nexport const BASELINE_ACTION_IDS: readonly string[] = BASELINE_ACTIONS.map((a) => a.id);\n\n/** Every kit-standard action: the baseline, each core preset's in table order, then the\n *  tool-driven ones. */\nexport const KIT_STANDARD_ACTIONS: readonly Action[] = [\n  ...BASELINE_ACTIONS,\n  ...FEATURES.flatMap((f) => FEATURE_PRESETS[f].actions ?? []),\n  ...toolDrivenActions,\n];\n\n/** What `<SceneCanvas>` resolves `features` through: every core name, and\n *  every kit-standard action for its tools to bring. */\nexport const CORE_PRESET_SOURCE: PresetSource = { named: CORE_NAMED_PRESETS, pool: KIT_STANDARD_ACTIONS, baseline: BASELINE_ACTIONS };\n"],"mappings":";;;;;;;;;;;;;;AA6BA,IAAa,kBAA4D;CACvE,gBAAgB;CAChB,cAAc;CACd,eAAe;CACf,cAAc;CACd,cAAc;CACd,cAAc;CACd,MAAM;CACN,QAAQ;CACR,SAAS;CACT,MAAM;CACN,MAAM;CACN,QAAQ;CACR,QAAQ;CACR,WAAW;CACX,QAAQ;CACR,aAAa;CACb,WAAW;CACX,WAAW;CACX,QAAQ;CACR,OAAO;CACP,OAAO;CACP,OAAO;CACP,WAAW;CACX,MAAM;CACN,MAAM;CACN,SAAS;CACT,OAAO;CACP,YAAY;CACZ,SAAS;CACT,YAAY;CACZ,YAAY;CACZ,UAAU;CACV,UAAU;CACV,cAAc;CACd,OAAO;CACP,QAAQ;CACR,MAAM;AACR;AAEA,IAAM,WAAW,OAAO,KAAK,eAAe;;AAG5C,IAAa,qBAAmC;;AAGhD,IAAa,qBAAqB,OAAO,YACvC,SAAS,KAAK,MAAoC,CAAC,IAAI,gBAAgB,EAAE,CAAC,WAAW,CAAC,EAAA,CAAG,KAAK,MAAM,EAAE,EAAE,CAAC,CAAC,CAC5G;;;;;;AAOA,IAAa,yBAA4C,kBAAkB,KAAK,MAAM,EAAE,EAAE;;AAG1F,IAAa,sBAAyC,iBAAiB,KAAK,MAAM,EAAE,EAAE;;;AAItF,IAAa,uBAA0C;CACrD,GAAG;CACH,GAAG,SAAS,SAAS,MAAM,gBAAgB,EAAE,CAAC,WAAW,CAAC,CAAC;CAC3D,GAAG;AACL;;;AAIA,IAAa,qBAAmC;CAAE,OAAO;CAAoB,MAAM;CAAsB,UAAU;AAAiB"}