@weasel-js/core 1.10.0 → 1.11.0

package/dist/canvas/SceneCanvas/features.js

@@ -1,7 +1,9 @@
-import { selectionMoveContribution as e, selectionResizeContribution as t, selectionRotateContribution as n } from "../../tools/builtin/select/selectionContributions.js";
-import { never as r } from "../../features/chrome-caps/conditions.js";
+import { never } from "../../features/chrome-caps/conditions.js";
+
 //#region src/canvas/SceneCanvas/features.ts
-var i = [
+/** Every name `<SceneCanvas features>` accepts, each composite after the
+*  presets it names. */
+var SCENE_CANVAS_FEATURES = [
 	"view",
 	"select",
 	"outline",
@@ -15,135 +17,89 @@ var i = [
 	"paths",
 	"ingest",
 	"draw"
-], a = {
-	view: {
-		actions: ["viewport.dragPan", "viewport.pinchZoom"],
-		tools: ["hand"]
-	},
-	select: {
-		actions: [
-			"areaSelect",
-			"clearSelection",
-			"lassoSelect"
-		],
-		tools: ["select"]
-	},
-	outline: {
-		actions: [],
-		chrome: ["selection.outline"]
-	},
-	resize: {
-		actions: ["resize"],
-		ambient: () => t(),
-		chrome: ["selection.resize-handles"]
-	},
-	rotate: {
-		actions: ["rotate"],
-		ambient: ({ rotate: e }) => n({ rotate: e }),
-		chrome: ["selection.rotation-handle"]
-	},
-	move: {
-		actions: ["move", "clone"],
-		ambient: ({ move: t }) => e({ move: t })
-	},
-	edit: { actions: [
-		"escape",
-		"cancelGesture",
-		"selectAll",
-		"duplicate",
-		"delete",
-		"group",
-		"ungroup",
-		"undo",
-		"redo",
-		"nudge.up",
-		"nudge.down",
-		"nudge.left",
-		"nudge.right",
-		"clipboard.cut",
-		"clipboard.copy",
-		"clipboard.paste",
-		"clipboard.pasteEvent",
-		"setFill",
-		"setStroke",
-		"setFillOpacity",
-		"setStrokeOpacity"
-	] },
-	arrange: { actions: [
-		"flip",
-		"reorder.forward",
-		"reorder.backward",
-		"align.left",
-		"align.centerX",
-		"align.right",
-		"align.top",
-		"align.centerY",
-		"align.bottom",
-		"distribute.horizontal",
-		"distribute.vertical"
-	] },
-	paths: { actions: [
-		"pathfinder.union",
-		"pathfinder.subtract",
-		"pathfinder.intersect",
-		"pathfinder.exclude",
-		"pathfinder.divide",
-		"pathfinder.crop",
-		"pathfinder.trim",
-		"pathfinder.merge",
-		"createOutlines",
-		"outlineStroke",
-		"editAnchors",
-		"enterPathEdit",
-		"exitPathEdit",
-		"insertPathAnchor",
-		"nudgeAnchors.up",
-		"nudgeAnchors.down",
-		"nudgeAnchors.left",
-		"nudgeAnchors.right",
-		"deleteAnchors",
-		"cutPathAtAnchor",
-		"marqueeAnchors",
-		"selectAnchor"
-	] },
-	ingest: { actions: ["ingest"] }
-}, o = Object.keys(a), s = {
-	pick: ["select", "outline"],
-	transform: ["resize", "rotate"],
-	draw: o
-}, c = Object.fromEntries(o.map((e) => [e, a[e].actions])), l = [
-	"insert",
-	"insert.adjustRotation",
-	"enterTextEdit"
 ];
-function u(e, t = {}) {
-	let n = /* @__PURE__ */ new Set();
-	for (let t of e ?? []) if (t in s) for (let e of s[t]) n.add(e);
-	else n.add(t);
-	return t.viewport && n.add("view"), n;
+/**
+* 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
+* keep the order given. Where names resolve, a `viewport` config turns on the
+* `view` preset, since that prop only configures what `view` turns on.
+*/
+function resolveFeatures(features, named, opts = {}) {
+	const listed = [];
+	const byId = /* @__PURE__ */ new Map();
+	const add = (p) => {
+		const held = byId.get(p.id);
+		if (held === p) return;
+		if (held) throw new Error(`[SceneCanvas] two different presets have the id "${p.id}"`);
+		byId.set(p.id, p);
+		for (const inner of p.includes ?? []) add(inner);
+		listed.push(p);
+	};
+	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);
+	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);
+		ordered.push(p);
+	};
+	for (const p of listed) place(p);
+	return {
+		presets: ordered,
+		pathEdit: ordered.flatMap((p) => p.pathEdit ?? []),
+		snapSources: ordered.flatMap((p) => p.snapSources ?? []),
+		has: (id) => byId.has(id)
+	};
 }
-function d(e) {
-	let t = /* @__PURE__ */ new Set();
-	for (let n of e) for (let e of a[n].actions) t.add(e);
-	return t;
+/** The actions the given presets register, in registration order. */
+function presetActions(enabled) {
+	return enabled.presets.flatMap((p) => p.actions ?? []);
 }
-function f(e) {
-	let t = /* @__PURE__ */ new Set();
-	for (let n of e) for (let e of a[n].tools ?? []) t.add(e);
-	return t;
+/** The built-in tool ids the given presets mount. */
+function presetBuiltinTools(enabled) {
+	const ids = /* @__PURE__ */ new Set();
+	for (const p of enabled.presets) for (const t of p.tools ?? []) if (typeof t === "string") ids.add(t);
+	return ids;
 }
-function p(e, t) {
-	return o.flatMap((n) => {
-		let r = e.has(n) ? a[n].ambient : void 0;
-		return r ? [r(t)] : [];
-	});
+/** The tools of their own the given presets mount, by id. */
+function presetOwnTools(enabled) {
+	const out = {};
+	for (const p of enabled.presets) for (const t of p.tools ?? []) if (typeof t !== "string") out[t.id] = t;
+	return out;
 }
-function m(e) {
-	let t = {};
-	for (let n of o) if (!e.has(n)) for (let e of a[n].chrome ?? []) t[e] = r;
-	return t;
+/** The given presets' ambient entries and contributions, in the order they are
+*  matched. Their `moveBehaviors` follow the ones `options.move` brings. */
+function presetAmbient(enabled, options) {
+	const extra = enabled.presets.flatMap((p) => p.moveBehaviors ?? []);
+	const move = extra.length === 0 ? options.move : {
+		...options.move,
+		behaviors: [...options.move?.behaviors ?? [], ...extra]
+	};
+	const opts = {
+		...options,
+		move
+	};
+	return enabled.presets.flatMap((p) => p.ambient ? [p.ambient(opts)] : []);
+}
+/** The given presets' contributions, in preset order. */
+function presetContributions(enabled) {
+	return enabled.presets.flatMap((p) => p.contributions ?? []);
+}
+/** The enabled presets' own `chromeRules`, then rules hiding each chrome id
+*  in `owned` that no enabled preset turns on. `never` also takes a handle out
+*  of hit-testing, so a hidden one cannot be grabbed. */
+function presetChromeRules(enabled, owned) {
+	const on = new Set(enabled.presets.flatMap((p) => p.chrome ?? []));
+	const rules = Object.assign({}, ...enabled.presets.map((p) => p.chromeRules ?? {}));
+	for (const id of owned) if (!on.has(id)) rules[id] = never;
+	return rules;
 }
-//#endregion
-export { s as COMPOSITE_FEATURES, c as FEATURE_ACTION_IDS, a as FEATURE_PRESETS, i as SCENE_CANVAS_FEATURES, l as TOOL_DRIVEN_ACTION_IDS, d as featureActionIds, p as featureAmbient, m as featureChromeRules, f as featureToolIds, u as resolveFeatures };
 
+//#endregion
+export { SCENE_CANVAS_FEATURES, presetActions, presetAmbient, presetBuiltinTools, presetChromeRules, presetContributions, presetOwnTools, resolveFeatures };
 //# sourceMappingURL=features.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"features.js","names":["SCENE_CANVAS_FEATURES","FEATURE_PRESETS","selectionResizeContribution","selectionRotateContribution","selectionMoveContribution","BASE_FEATURES","COMPOSITE_FEATURES","FEATURE_ACTION_IDS","f","TOOL_DRIVEN_ACTION_IDS","resolveFeatures","out","features","b","opts","featureActionIds","ids","id","featureToolIds","featureAmbient","ambient","options","featureChromeRules","rules","never"],"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 naming a preset here.\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 { never } from 'features/chrome-caps/conditions';\nimport type { ChromeId, VisibilityRules } from 'features/chrome-caps/types';\nimport type { UseMoveOptions } from 'interactions/actions/move/options';\nimport type { UseRotateOptions } from 'interactions/actions/rotate/options';\nimport {\n  selectionMoveContribution,\n  selectionResizeContribution,\n  selectionRotateContribution,\n} from 'tools/builtin/select/selectionContributions';\nimport type { Contribution } from 'tools/overlayBinding';\nimport type { BuiltinToolId } from './props';\n\n/** A 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 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 behavior preset for `<SceneCanvas features>`. */\nexport type Feature = BaseFeature | CompositeFeature;\n\n/** Every preset `<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/** Everything turning one preset on means. */\nexport interface FeaturePreset {\n  /** The kit-standard actions it registers. */\n  actions: readonly string[];\n  /** The built-in tools it mounts. */\n  tools?: readonly BuiltinToolId[];\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  ambient?: (options: FeatureBindingOptions) => Contribution;\n  /** The selection chrome that is drawn, and can be grabbed, only while it is on. */\n  chrome?: readonly ChromeId[];\n}\n\n/**\n * What each preset turns on.\n *\n * Row order is the order ambient bindings are matched in, and a tie goes to\n * the first: a handle sits over the selected body, so `resize` and `rotate`\n * come before `move`, whose binding matches a handle drag too.\n *\n * Every id `useStandardActions` knows appears under exactly one preset, except\n * the ones in {@link TOOL_DRIVEN_ACTION_IDS}.\n *\n * Cmd/Ctrl+V arrives as a DOM `paste` event, and two presets answer it.\n * `edit` brings `clipboard.pasteEvent`, which pastes nodes a kit canvas\n * copied and nothing else; `ingest` brings `ingest`, which takes those plus\n * images, SVG, files, consumer content handlers, and every OS drop. With both\n * on, `ingest` answers alone: `useStandardActions` holds\n * `clipboard.pasteEvent` back wherever `ingest` is registered.\n */\nexport const FEATURE_PRESETS: Readonly<Record<BaseFeature, FeaturePreset>> = {\n  view: {\n    actions: ['viewport.dragPan', 'viewport.pinchZoom'],\n    tools: ['hand'],\n  },\n  select: {\n    actions: ['areaSelect', 'clearSelection', 'lassoSelect'],\n    tools: ['select'],\n  },\n  outline: {\n    actions: [],\n    chrome: ['selection.outline'],\n  },\n  resize: {\n    actions: ['resize'],\n    ambient: () => selectionResizeContribution(),\n    chrome: ['selection.resize-handles'],\n  },\n  rotate: {\n    actions: ['rotate'],\n    ambient: ({ rotate }) => selectionRotateContribution({ rotate }),\n    chrome: ['selection.rotation-handle'],\n  },\n  move: {\n    actions: ['move', 'clone'],\n    ambient: ({ move }) => selectionMoveContribution({ move }),\n  },\n  edit: {\n    actions: [\n      'escape', 'cancelGesture', 'selectAll', 'duplicate', 'delete',\n      'group', 'ungroup', 'undo', 'redo',\n      'nudge.up', 'nudge.down', 'nudge.left', 'nudge.right',\n      'clipboard.cut', 'clipboard.copy', 'clipboard.paste', 'clipboard.pasteEvent',\n      'setFill', 'setStroke', 'setFillOpacity', 'setStrokeOpacity',\n    ],\n  },\n  arrange: {\n    actions: [\n      'flip',\n      'reorder.forward', 'reorder.backward',\n      'align.left', 'align.centerX', 'align.right',\n      'align.top', 'align.centerY', 'align.bottom',\n      'distribute.horizontal', 'distribute.vertical',\n    ],\n  },\n  paths: {\n    actions: [\n      'pathfinder.union', 'pathfinder.subtract', 'pathfinder.intersect',\n      'pathfinder.exclude', 'pathfinder.divide', 'pathfinder.crop', 'pathfinder.trim', 'pathfinder.merge',\n      'createOutlines', 'outlineStroke',\n      'editAnchors', 'enterPathEdit', 'exitPathEdit', 'insertPathAnchor',\n      'nudgeAnchors.up', 'nudgeAnchors.down', 'nudgeAnchors.left', 'nudgeAnchors.right',\n      'deleteAnchors', 'cutPathAtAnchor', 'marqueeAnchors', 'selectAnchor',\n    ],\n  },\n  ingest: {\n    actions: ['ingest'],\n  },\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 kit-standard actions each preset registers. */\nexport const FEATURE_ACTION_IDS = Object.fromEntries(\n  BASE_FEATURES.map((f) => [f, FEATURE_PRESETS[f].actions]),\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[] = ['insert', 'insert.adjustRotation', 'enterTextEdit'];\n\n/**\n * The base presets a canvas runs with: `features` with every composite\n * expanded, plus `view` whenever the canvas was handed a `viewport` config,\n * since that prop only configures what `view` turns on.\n */\nexport function resolveFeatures(\n  features: readonly Feature[] | undefined,\n  opts: { viewport?: boolean } = {},\n): ReadonlySet<BaseFeature> {\n  const out = new Set<BaseFeature>();\n  for (const f of features ?? []) {\n    if (f in COMPOSITE_FEATURES) {\n      for (const b of COMPOSITE_FEATURES[f as CompositeFeature]) out.add(b);\n    } else {\n      out.add(f as BaseFeature);\n    }\n  }\n  if (opts.viewport) out.add('view');\n  return out;\n}\n\n/** The kit-standard action ids the given presets register. */\nexport function featureActionIds(features: ReadonlySet<BaseFeature>): Set<string> {\n  const ids = new Set<string>();\n  for (const f of features) for (const id of FEATURE_PRESETS[f].actions) ids.add(id);\n  return ids;\n}\n\n/** The built-in tools the given presets mount. */\nexport function featureToolIds(features: ReadonlySet<BaseFeature>): Set<BuiltinToolId> {\n  const ids = new Set<BuiltinToolId>();\n  for (const f of features) for (const id of FEATURE_PRESETS[f].tools ?? []) ids.add(id);\n  return ids;\n}\n\n/** The given presets' ambient entries, in the order they are matched. */\nexport function featureAmbient(\n  features: ReadonlySet<BaseFeature>,\n  options: FeatureBindingOptions,\n): Contribution[] {\n  return BASE_FEATURES.flatMap((f) => {\n    const ambient = features.has(f) ? FEATURE_PRESETS[f].ambient : undefined;\n    return ambient ? [ambient(options)] : [];\n  });\n}\n\n/** Rules hiding the chrome of every preset that is not among `features`.\n *  `never` also takes a handle out of hit-testing, so a hidden one cannot be\n *  grabbed. */\nexport function featureChromeRules(features: ReadonlySet<BaseFeature>): VisibilityRules {\n  const rules: VisibilityRules = {};\n  for (const f of BASE_FEATURES) {\n    if (features.has(f)) continue;\n    for (const id of FEATURE_PRESETS[f].chrome ?? []) rules[id] = never;\n  }\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 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 type { Action } 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 tool of its own. */\n  readonly tools?: readonly (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 */\nexport function resolveFeatures(\n  features: readonly FeatureEntry[] | undefined,\n  named: NamedPresets | null,\n  opts: { viewport?: 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  return {\n    presets: ordered,\n    pathEdit: ordered.flatMap((p) => p.pathEdit ?? []),\n    snapSources: ordered.flatMap((p) => p.snapSources ?? []),\n    has: (id) => byId.has(id),\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/** 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) for (const t of p.tools ?? []) if (typeof t === 'string') ids.add(t);\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 (typeof t !== 'string') 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/insertPreviewCommands.js

@@ -0,0 +1,115 @@
+import { viewToTransform } from "../../core/viewport/view.js";
+import { worldToScreen } from "../../core/viewport/viewTransform.js";
+import { getImageBitmap } from "@weasel-js/renderer";
+import { ellipsePath, invert, linePath, mat3 as mat3$1, multiply, polylineFromPoints, rectPath, regularPolygonPath, starPath } from "@weasel-js/geom";
+
+//#region src/canvas/SceneCanvas/insertPreviewCommands.ts
+/** Alpha for content previewed inside an in-flight gesture. Matches the
+*  preview-ghost layer, so a dragged node and an uncommitted insert read as
+*  equally provisional. */
+var PREVIEW_CONTENT_OPACITY = .85;
+/** An insert preview in screen space: its outline, under each copy it will be
+*  drawn in, and the dot at the press. */
+function insertPreviewCommands(ov, view, cfg) {
+	const t = viewToTransform(view);
+	const out = [];
+	const b = ov.bounds;
+	const projectPoint = (wx, wy) => {
+		const [sx, sy] = worldToScreen(wx, wy, t);
+		return {
+			x: sx,
+			y: sy
+		};
+	};
+	const projectPoints = (pts) => pts.map((p) => projectPoint(p.x, p.y));
+	const radialScale = (view.scale.x + view.scale.y) / 2;
+	let pathCmd = null;
+	const geom = ov.geometry;
+	switch (geom.kind) {
+		case "box": {
+			const [sx, sy] = worldToScreen(b.x, b.y, t);
+			const sw = b.width * view.scale.x;
+			const sh = b.height * view.scale.y;
+			if (ov.shape === "image") {
+				const e = ov.extras;
+				const bmp = e.preview === "outline" || !e.src ? void 0 : getImageBitmap(e.src);
+				if (bmp) out.push({
+					kind: "image",
+					image: bmp,
+					x: sx,
+					y: sy,
+					w: sw,
+					h: sh,
+					opacity: PREVIEW_CONTENT_OPACITY
+				});
+			}
+			pathCmd = ov.shape === "ellipse" ? ellipsePath({
+				x: sx,
+				y: sy,
+				width: sw,
+				height: sh
+			}) : rectPath(sx, sy, sw, sh);
+			break;
+		}
+		case "line":
+			pathCmd = linePath(projectPoint(geom.a.x, geom.a.y), projectPoint(geom.b.x, geom.b.y));
+			break;
+		case "polygon":
+			pathCmd = regularPolygonPath(projectPoint(geom.center.x, geom.center.y), geom.radius * radialScale, geom.sides, geom.rotation);
+			break;
+		case "star":
+			pathCmd = starPath(projectPoint(geom.center.x, geom.center.y), geom.outerRadius * radialScale, geom.points, geom.innerRadius * radialScale, geom.rotation);
+			break;
+		case "pencil": pathCmd = polylineFromPoints(projectPoints(geom.samples));
+	}
+	if (!pathCmd) return out;
+	const cmd = {
+		kind: "path",
+		path: pathCmd,
+		fill: ov.shape === "line" || ov.shape === "pencil" || ov.shape === "image" ? void 0 : { paint: { color: cfg.fill } },
+		stroke: {
+			paint: { color: cfg.stroke },
+			width: cfg.lineWidth,
+			dash: cfg.dash
+		}
+	};
+	out.push(cmd);
+	if (ov.copies && ov.copies.length > 0) {
+		const toScreen = [
+			view.scale.x,
+			0,
+			0,
+			view.scale.y,
+			t.panX,
+			t.panY
+		];
+		const toWorld = invert(toScreen);
+		for (const m of ov.copies) {
+			if (!toWorld) break;
+			const s = multiply(toScreen, multiply(m, toWorld));
+			out.push({
+				kind: "group",
+				transform: mat3$1.fromAffine(s),
+				children: [cmd]
+			});
+		}
+	}
+	if (ov.anchorPoint) {
+		const anchorScreen = projectPoint(ov.anchorPoint.x, ov.anchorPoint.y);
+		out.push({
+			kind: "path",
+			path: ellipsePath({
+				x: anchorScreen.x - 4,
+				y: anchorScreen.y - 4,
+				width: 8,
+				height: 8
+			}),
+			fill: { paint: { color: cfg.stroke } }
+		});
+	}
+	return out;
+}
+
+//#endregion
+export { insertPreviewCommands };
+//# sourceMappingURL=insertPreviewCommands.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"insertPreviewCommands.js","names":["mat3"],"sources":["../../../src/canvas/SceneCanvas/insertPreviewCommands.ts"],"sourcesContent":["import {\n  ellipsePath, invert, linePath, mat3, multiply, rectPath, regularPolygonPath, starPath, polylineFromPoints,\n  type Affine,\n} from '@weasel-js/geom';\nimport { getImageBitmap, type DrawCommand, type PathDrawCommand } from '@weasel-js/renderer';\nimport { viewToTransform, type View } from 'core/viewport/view';\nimport { worldToScreen } from 'core/viewport/viewTransform';\nimport type { ResolvedOverlay } from 'interactions/actions/resolveOverlays';\n\n/** Alpha for content previewed inside an in-flight gesture. Matches the\n *  preview-ghost layer, so a dragged node and an uncommitted insert read as\n *  equally provisional. */\nconst PREVIEW_CONTENT_OPACITY = 0.85;\n\n/** The overlay colors an insert preview is drawn in. */\nexport interface InsertPreviewStyle {\n  fill: string;\n  stroke: string;\n  lineWidth: number;\n  dash: number[];\n}\n\n/** An insert preview in screen space: its outline, under each copy it will be\n *  drawn in, and the dot at the press. */\nexport function insertPreviewCommands(\n  ov: Extract<ResolvedOverlay, { kind: 'insertPreview' }>,\n  view: View,\n  cfg: InsertPreviewStyle,\n): DrawCommand[] {\n  const t = viewToTransform(view);\n  const out: DrawCommand[] = [];\n  const b = ov.bounds;\n  const projectPoint = (wx: number, wy: number): { x: number; y: number } => {\n    const [sx, sy] = worldToScreen(wx, wy, t);\n    return { x: sx, y: sy };\n  };\n  const projectPoints = (\n    pts: ReadonlyArray<{ x: number; y: number }>,\n  ): { x: number; y: number }[] => pts.map((p) => projectPoint(p.x, p.y));\n  // Radial shapes inscribe in a square, so a single screen-space\n  // radius needs one scale factor; average the axes.\n  const radialScale = (view.scale.x + view.scale.y) / 2;\n\n  let pathCmd: PathDrawCommand['path'] | null = null;\n  const geom = ov.geometry;\n  switch (geom.kind) {\n    case 'box': {\n      const [sx, sy] = worldToScreen(b.x, b.y, t);\n      const sw = b.width * view.scale.x;\n      const sh = b.height * view.scale.y;\n      if (ov.shape === 'image') {\n        const e = ov.extras as Partial<{ src: string; preview: string }>;\n        // The bitmap when it has decoded, the bare outline until then\n        // (or when the tool opted out) — the outline is drawn either\n        // way, so the drag always has an edge to read.\n        const bmp = e.preview === 'outline' || !e.src\n          ? undefined\n          : getImageBitmap(e.src);\n        if (bmp) {\n          out.push({\n            kind: 'image',\n            image: bmp,\n            x: sx, y: sy, w: sw, h: sh,\n            opacity: PREVIEW_CONTENT_OPACITY,\n          });\n        }\n      }\n      pathCmd = ov.shape === 'ellipse'\n        ? ellipsePath({ x: sx, y: sy, width: sw, height: sh })\n        : rectPath(sx, sy, sw, sh);\n      break;\n    }\n    case 'line':\n      pathCmd = linePath(projectPoint(geom.a.x, geom.a.y), projectPoint(geom.b.x, geom.b.y));\n      break;\n    case 'polygon':\n      pathCmd = regularPolygonPath(\n        projectPoint(geom.center.x, geom.center.y),\n        geom.radius * radialScale,\n        geom.sides,\n        geom.rotation,\n      );\n      break;\n    case 'star':\n      pathCmd = starPath(\n        projectPoint(geom.center.x, geom.center.y),\n        geom.outerRadius * radialScale,\n        geom.points,\n        geom.innerRadius * radialScale,\n        geom.rotation,\n      );\n      break;\n    case 'pencil':\n      // Genuinely open: `polygonFromPoints` closes the path, and the\n      // closing edge from the last sample back to the first reads as\n      // a marquee rather than as the stroke being drawn.\n      pathCmd = polylineFromPoints(projectPoints(geom.samples));\n      break;\n  }\n\n  if (!pathCmd) return out;\n  const cmd: PathDrawCommand = {\n    kind: 'path',\n    path: pathCmd,\n    fill: ov.shape === 'line' || ov.shape === 'pencil' || ov.shape === 'image'\n      ? undefined\n      : { paint: { color: cfg.fill } },\n    stroke: { paint: { color: cfg.stroke }, width: cfg.lineWidth, dash: cfg.dash },\n  };\n  out.push(cmd);\n  // Each copy the shape will be drawn in, carried into screen space.\n  if (ov.copies && ov.copies.length > 0) {\n    const toScreen: Affine = [view.scale.x, 0, 0, view.scale.y, t.panX, t.panY];\n    const toWorld = invert(toScreen);\n    for (const m of ov.copies) {\n      if (!toWorld) break;\n      const s = multiply(toScreen, multiply(m, toWorld));\n      out.push({ kind: 'group', transform: mat3.fromAffine(s), children: [cmd] });\n    }\n  }\n  // Anchor dot at the drag's click point: for radial shapes no\n  // vertex sits at the AABB corner, and in center mode the dot marks\n  // the growth axis.\n  if (ov.anchorPoint) {\n    const anchorScreen = projectPoint(ov.anchorPoint.x, ov.anchorPoint.y);\n    out.push({\n      kind: 'path',\n      path: ellipsePath({\n        x: anchorScreen.x - 4,\n        y: anchorScreen.y - 4,\n        width: 8,\n        height: 8,\n      }),\n      fill: { paint: { color: cfg.stroke } },\n    });\n  }\n  return out;\n}\n"],"mappings":"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"}

package/dist/canvas/SceneCanvas/mergeLayers.js

@@ -0,0 +1,43 @@
+import { targetSizesPx } from "../../core/device/targets.js";
+import { defaultDrawOne, defaultPaintBounds, paintBoundsFor } from "../defaultDrawOne.js";
+import { isCustomEntry } from "../layerSlots.js";
+
+//#region src/canvas/SceneCanvas/mergeLayers.ts
+/** 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
+*  default slot config. `targetScale` (from the {@link DeviceProfile}) and `baseSizes` go to `targetSizesPx`. */
+function mergeLayersWithDefaults(user, targetScale = 1, baseSizes = {}) {
+	const defaults = {
+		scene: {
+			drawOne: defaultDrawOne,
+			paintBounds: defaultPaintBounds
+		},
+		selectionOverlay: { handles: { size: targetSizesPx(targetScale, baseSizes).handle } }
+	};
+	if (!user) return defaults;
+	const result = { ...user };
+	if (!("scene" in user)) result.scene = defaults.scene;
+	else if (user.scene === null || isCustomEntry(user.scene)) result.scene = user.scene;
+	else {
+		const scene = {
+			...defaults.scene,
+			...user.scene
+		};
+		result.scene = user.scene && "paintBounds" in user.scene ? scene : {
+			...scene,
+			paintBounds: paintBoundsFor(scene.drawOne)
+		};
+	}
+	if (!("selectionOverlay" in user)) result.selectionOverlay = defaults.selectionOverlay;
+	else if (user.selectionOverlay === null || isCustomEntry(user.selectionOverlay)) result.selectionOverlay = user.selectionOverlay;
+	else result.selectionOverlay = {
+		...defaults.selectionOverlay,
+		...user.selectionOverlay
+	};
+	return result;
+}
+
+//#endregion
+export { mergeLayersWithDefaults };
+//# sourceMappingURL=mergeLayers.js.map

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

@@ -0,0 +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"}

package/dist/canvas/SceneCanvas/namedPresets.js

@@ -0,0 +1,56 @@
+import { arrangePreset } from "./presets/arrange.js";
+import { editPreset } from "./presets/edit.js";
+import { ingestPreset } from "./presets/ingest.js";
+import { pathsPreset } from "./presets/paths.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";
+
+//#region src/canvas/SceneCanvas/namedPresets.ts
+/** Each core preset by name. `draw` turns them on in this order. */
+var FEATURE_PRESETS = {
+	view: viewPreset,
+	select: selectPreset,
+	outline: outlinePreset,
+	resize: resizePreset,
+	rotate: rotatePreset,
+	move: movePreset,
+	edit: editPreset,
+	arrange: arrangePreset,
+	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
+};
+/** 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)]));
+/**
+* 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
+*  tool-driven ones. */
+var KIT_STANDARD_ACTIONS = [...BASE_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
+};
+
+//#endregion
+export { COMPOSITE_FEATURES, 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

@@ -0,0 +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"}