@weasel-js/core 1.9.2 → 1.9.4

package/dist/core/isPlainObject.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"isPlainObject.js","names":["isPlainPrototype","proto","isPlainObject","value"],"sources":["../../src/core/isPlainObject.ts"],"sourcesContent":["/** Whether `proto` is the prototype a plain object has: `null`, or some\n *  realm's `Object.prototype`. Comparing against this realm's alone misses\n *  objects made in an iframe, a VM context, or by `structuredClone` under jsdom. */\nexport function isPlainPrototype(proto: object | null): boolean {\n  return proto === Object.prototype || proto === null || Object.getPrototypeOf(proto) === null;\n}\n\n/** Whether `value` is a plain object — a literal or `Object.create(null)` — from any realm. */\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && isPlainPrototype(Object.getPrototypeOf(value));\n}\n"],"mappings":";AAGA,SAAgBA,EAAiB,GAA+B;CAC9D,OAAOC,MAAU,OAAO,aAAaA,MAAU,QAAQ,OAAO,eAAeA,CAAK,MAAM;AAC1F;AAGA,SAAgBC,EAAc,GAAkD;CAC9E,OAAO,OAAOC,KAAU,cAAYA,KAAkBH,EAAiB,OAAO,eAAeG,CAAK,CAAC;AACrG"}

package/dist/debug/flag.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"flag.js","names":["KEYS","cached","read","empty","k","v","get","isDebugEnabled","c","namespace","dlog","args","dwarn"],"sources":["../../src/debug/flag.ts"],"sourcesContent":["/**\n * Namespaced, opt-in console tracing for the kit.\n *\n * Enable in the browser:\n *\n *   localStorage.setItem('weasel.debug', '*')                 // all namespaces\n *   localStorage.setItem('weasel.debug', 'tools,dispatch')    // specific ones\n *   localStorage.setItem('weasel.debug', '1')                 // legacy \"all\"\n *\n * Each call site picks a stable namespace string. Off by default; the flag\n * is read once and cached per page session — reload to pick up a change.\n *\n * Mirrors `packages/ui/src/dlog.ts`. The two impls live in separate\n * packages because weasel-ui doesn't depend on the kit, but both read the\n * same localStorage keys so behavior is uniform from a debugger's POV.\n *\n * Known kit namespaces:\n *   - tools           — active-tool + hotkey transitions (useTools)\n *   - dispatch        — gesture start / end / cancel (dispatcher)\n *   - drag-rect       — useDragRect lifecycle\n *   - drag-radial     — useDragRadial lifecycle\n *   - scene           — restored-op replay gaps (history persistence)\n *   - scene-canvas    — SceneCanvas mount / unmount; adapter paste-translation warnings\n *   - history         — applyOps push, no-op suppression, serialize/restore\n *   - clipboard       — OS clipboard write/read failures, malformed payloads\n */\n\nconst KEYS = ['weasel.debug', 'weaseldraw.debug'] as const;\n\ninterface Cached {\n  all: boolean;\n  set: Set<string>;\n}\n\nlet cached: Cached | null = null;\n\nfunction read(): Cached {\n  const empty: Cached = { all: false, set: new Set() };\n  if (typeof localStorage === 'undefined') return empty;\n  try {\n    for (const k of KEYS) {\n      const v = localStorage.getItem(k);\n      if (v == null || v === '') continue;\n      if (v === '1' || v === 'true' || v === '*') return { all: true, set: new Set() };\n      return { all: false, set: new Set(v.split(/[\\s,]+/).filter(Boolean)) };\n    }\n    return empty;\n  } catch {\n    return empty;\n  }\n}\n\nfunction get(): Cached {\n  if (cached === null) cached = read();\n  return cached;\n}\n\n/** True when `namespace` (or `*`) is enabled. Pass no argument to test\n *  whether *any* namespace is on (legacy global-flag semantics). */\nexport function isDebugEnabled(namespace?: string): boolean {\n  const c = get();\n  if (c.all) return true;\n  if (namespace === undefined) return c.set.size > 0;\n  return c.set.has(namespace);\n}\n\n/** Conditional `console.debug` — no-op unless `namespace` (or `*`) is enabled.\n *  Each call is prefixed with `[namespace]` so the source is searchable. */\nexport function dlog(namespace: string, ...args: unknown[]): void {\n  if (!isDebugEnabled(namespace)) return;\n  // eslint-disable-next-line no-console\n  console.debug(`[${namespace}]`, ...args);\n}\n\n/** Conditional `console.warn` — like `dlog` but at warn level. Use for\n *  diagnostics that indicate something worth surfacing during debugging\n *  (e.g. no-op op batches suppressed). */\nexport function dwarn(namespace: string, ...args: unknown[]): void {\n  if (!isDebugEnabled(namespace)) return;\n  console.warn(`[${namespace}]`, ...args);\n}\n"],"mappings":";AA2BA,IAAMA,IAAO,CAAC,gBAAgB,kBAAkB,GAO5CC,IAAwB;AAE5B,SAASC,IAAe;CACtB,IAAMC,IAAgB;EAAE,KAAK;EAAO,qBAAK,IAAI,IAAI;CAAE;CACnD,IAAI,OAAO,eAAiB,KAAa,OAAOA;CAChD,IAAI;EACF,KAAK,IAAMC,KAAKJ,GAAM;GACpB,IAAMK,IAAI,aAAa,QAAQD,CAAC;GAChC,IAAIC,KAAK,QAAQA,MAAM,IAEvB,OADIA,MAAM,OAAOA,MAAM,UAAUA,MAAM,MAAY;IAAE,KAAK;IAAM,qBAAK,IAAI,IAAI;GAAE,IACxE;IAAE,KAAK;IAAO,KAAK,IAAI,IAAIA,EAAE,MAAM,QAAQ,CAAC,CAAC,OAAO,OAAO,CAAC;GAAE;EACvE;EACA,OAAOF;CACT,QAAQ;EACN,OAAOA;CACT;AACF;AAEA,SAASG,IAAc;CAErB,OADIL,MAAW,SAAM,IAASC,EAAK,IAC5BD;AACT;AAIA,SAAgBM,EAAe,GAA6B;CAC1D,IAAMC,IAAIF,EAAI;CAGd,OAFIE,EAAE,MAAY,KACdC,MAAc,KAAA,IAAkBD,EAAE,IAAI,OAAO,IAC1CA,EAAE,IAAI,IAAIC,CAAS;AAC5B;AAIA,SAAgBC,EAAK,GAAmB,GAAGC,GAAuB;CAChE,AAAKJ,EAAeE,CAAS,KAE7B,QAAQ,MAAM,IAAIA,EAAU,IAAI,GAAGE,CAAI;AACzC;AAKA,SAAgBC,EAAM,GAAmB,GAAGD,GAAuB;CACjE,AAAKJ,EAAeE,CAAS,KAC7B,QAAQ,KAAK,IAAIA,EAAU,IAAI,GAAGE,CAAI;AACxC"}

package/dist/interactions/actions/defaults/freshNodeId.js

@@ -1,10 +0,0 @@
-import { asNodeId as e } from "../../../core/scene/types.js";
-//#region src/interactions/actions/defaults/freshNodeId.ts
-var t = 0;
-function n() {
-	return e(`n${(t++).toString(36)}-${Math.random().toString(36).slice(2, 8)}`);
-}
-//#endregion
-export { n as freshNodeId };
-
-//# sourceMappingURL=freshNodeId.js.map

package/dist/interactions/actions/defaults/freshNodeId.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"freshNodeId.js","names":["counter","freshNodeId","asNodeId"],"sources":["../../../../src/interactions/actions/defaults/freshNodeId.ts"],"sourcesContent":["import type { NodeId } from 'core/scene/types';\nimport { asNodeId } from 'core/scene/types';\n\nlet counter = 0;\n\n/**\n * Mint a fresh `NodeId` for a node an action materializes itself.\n *\n * Actions that build `createInsertOp` ops can't let the scene generate the id\n * the way `scene.add(spec)` does — the op carries a whole node, so the id has\n * to exist before the op does. Mirrors the scene's own `n{counter}-{random}`\n * scheme, which `core/scene/scene.ts` keeps module-private.\n */\nexport function freshNodeId(): NodeId {\n  return asNodeId(`n${(counter++).toString(36)}-${Math.random().toString(36).slice(2, 8)}`);\n}\n"],"mappings":";;AAGA,IAAIA,IAAU;AAUd,SAAgBC,IAAsB;CACpC,OAAOC,EAAS,KAAK,IAAA,CAAW,SAAS,EAAE,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG;AAC1F"}

package/dist/renderer/shaders/imageFill.js

@@ -1,14 +0,0 @@
-//#region src/renderer/shaders/imageFill.ts
-var e = "#version 300 es\nin vec2 a_position;\nin vec2 a_uv;\nuniform mat3 u_proj;\nuniform mat3 u_model;\nout vec2 v_uv;\nvoid main() {\n  vec3 screen = u_model * vec3(a_position, 1.0);\n  vec3 clip   = u_proj  * vec3(screen.xy, 1.0);\n  gl_Position = vec4(clip.xy, 0.0, 1.0);\n  v_uv = a_uv;\n}\n", t = "#version 300 es\nprecision highp float;\nin vec2 v_uv;\nuniform sampler2D u_sampler;\nuniform float u_opacity;\nuniform float u_alpha;\nuniform mat4 u_colorMatrix;\nuniform vec4 u_colorBias;\nout vec4 outColor;\nvoid main() {\n  vec4 texel = texture(u_sampler, v_uv);\n  vec4 mapped = clamp(u_colorMatrix * texel + u_colorBias, 0.0, 1.0);\n  float a = mapped.a * u_opacity * u_alpha;\n  outColor = vec4(mapped.rgb * a, a);\n}\n", n = [
-	"u_proj",
-	"u_model",
-	"u_sampler",
-	"u_opacity",
-	"u_alpha",
-	"u_colorMatrix",
-	"u_colorBias"
-], r = ["a_position", "a_uv"];
-//#endregion
-export { r as IMAGE_FILL_ATTRIBUTES, n as IMAGE_FILL_UNIFORMS, t as IMAGE_FRAG_SRC, e as IMAGE_VERT_SRC };
-
-//# sourceMappingURL=imageFill.js.map

package/dist/renderer/shaders/imageFill.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"imageFill.js","names":["IMAGE_VERT_SRC","IMAGE_FRAG_SRC","IMAGE_FILL_UNIFORMS","IMAGE_FILL_ATTRIBUTES"],"sources":["../../../src/renderer/shaders/imageFill.ts"],"sourcesContent":["/**\n * GLSL ES 3.0 sources for the image / pattern fill shader.\n *\n * Two variants:\n *   - Flat: IMAGE_VERT_SRC + IMAGE_FRAG_SRC, one quad under `u_opacity`.\n *   - VOpacity: IMAGE_VOPACITY_VERT_SRC + IMAGE_VOPACITY_FRAG_SRC, which reads\n *     the same factor off a per-vertex `a_opacity` instead. The batch draws\n *     with it so quads differing only in opacity still share one draw.\n *\n * The fold is exact, not an approximation under conditions the way the solid\n * batch's is: `u_opacity` multiplies the alpha *after* the color matrix, so\n * moving it to an attribute cannot interact with the matrix. Group alpha\n * multiplies there too, which is why the batch folds it into the same\n * attribute and leaves `u_alpha` at 1.\n *\n * Inputs:\n *   a_position  vec2   screen-space x,y of the quad corner\n *   a_uv        vec2   texture coordinate 0..1\n *   a_opacity   float  VOpacity only — replaces `u_opacity` per vertex\n *\n * Uniforms:\n *   u_proj         mat3        screen → clip projection\n *   u_model        mat3        cumulative group transform\n *   u_sampler      sampler2D   image texture (TEXTURE0)\n *   u_opacity      float       flat only — overall opacity, 0..1\n *   u_alpha        float       group alpha, 0..1 (the batch leaves it at 1)\n *   u_colorMatrix  mat4        color transform applied to sampled texel before premultiply\n *   u_colorBias    vec4        bias added after the matrix (identity = zero bias)\n *\n * Output convention §2: PREMULTIPLIED alpha — `vec4(rgb * a, a)`.\n * Pattern fills reuse this shader; wrapping is baked into the texture state.\n */\n\nexport const IMAGE_VERT_SRC = /* glsl */ `#version 300 es\nin vec2 a_position;\nin vec2 a_uv;\nuniform mat3 u_proj;\nuniform mat3 u_model;\nout vec2 v_uv;\nvoid main() {\n  vec3 screen = u_model * vec3(a_position, 1.0);\n  vec3 clip   = u_proj  * vec3(screen.xy, 1.0);\n  gl_Position = vec4(clip.xy, 0.0, 1.0);\n  v_uv = a_uv;\n}\n`;\n\nexport const IMAGE_FRAG_SRC = /* glsl */ `#version 300 es\nprecision highp float;\nin vec2 v_uv;\nuniform sampler2D u_sampler;\nuniform float u_opacity;\nuniform float u_alpha;\nuniform mat4 u_colorMatrix;\nuniform vec4 u_colorBias;\nout vec4 outColor;\nvoid main() {\n  vec4 texel = texture(u_sampler, v_uv);\n  vec4 mapped = clamp(u_colorMatrix * texel + u_colorBias, 0.0, 1.0);\n  float a = mapped.a * u_opacity * u_alpha;\n  outColor = vec4(mapped.rgb * a, a);\n}\n`;\n\nexport const IMAGE_VOPACITY_VERT_SRC = /* glsl */ `#version 300 es\nin vec2 a_position;\nin vec2 a_uv;\nin float a_opacity;\nuniform mat3 u_proj;\nuniform mat3 u_model;\nout vec2 v_uv;\nout float v_opacity;\nvoid main() {\n  vec3 screen = u_model * vec3(a_position, 1.0);\n  vec3 clip   = u_proj  * vec3(screen.xy, 1.0);\n  gl_Position = vec4(clip.xy, 0.0, 1.0);\n  v_uv = a_uv;\n  v_opacity = a_opacity;\n}\n`;\n\nexport const IMAGE_VOPACITY_FRAG_SRC = /* glsl */ `#version 300 es\nprecision highp float;\nin vec2 v_uv;\nin float v_opacity;\nuniform sampler2D u_sampler;\nuniform float u_alpha;\nuniform mat4 u_colorMatrix;\nuniform vec4 u_colorBias;\nout vec4 outColor;\nvoid main() {\n  vec4 texel = texture(u_sampler, v_uv);\n  vec4 mapped = clamp(u_colorMatrix * texel + u_colorBias, 0.0, 1.0);\n  float a = mapped.a * v_opacity * u_alpha;\n  outColor = vec4(mapped.rgb * a, a);\n}\n`;\n\nexport const IMAGE_FILL_UNIFORMS = [\n  'u_proj', 'u_model', 'u_sampler', 'u_opacity', 'u_alpha',\n  'u_colorMatrix', 'u_colorBias',\n] as const;\n\nexport const IMAGE_FILL_ATTRIBUTES = ['a_position', 'a_uv'] as const;\n\n/** `u_opacity` is absent: the driver strips a uniform the source never reads,\n *  so looking it up here would cache an undefined location under a live name. */\nexport const IMAGE_VOPACITY_UNIFORMS = [\n  'u_proj', 'u_model', 'u_sampler', 'u_alpha',\n  'u_colorMatrix', 'u_colorBias',\n] as const;\n\nexport const IMAGE_VOPACITY_ATTRIBUTES = ['a_position', 'a_uv', 'a_opacity'] as const;\n"],"mappings":";AAiCA,IAAaA,IAA4B,qSAc5BC,IAA4B,+aAmD5BC,IAAsB;CACjC;CAAU;CAAW;CAAa;CAAa;CAC/C;CAAiB;AACnB,GAEaC,IAAwB,CAAC,cAAc,MAAM"}

package/dist/tools/prefs.js

@@ -1,47 +0,0 @@
-import { formatUnit as e, unitScale as t } from "@weasel-js/quantity";
-//#region src/tools/prefs.ts
-function n(n, r, i) {
-	let a;
-	try {
-		a = t(n, r);
-	} catch (e) {
-		throw Error(`prefUnit: ${e instanceof Error ? e.message : String(e)}`);
-	}
-	let o = i?.precision === void 0 ? void 0 : 10 ** i.precision, s = i?.suffix ?? r, c = { [s]: 1 };
-	for (let e of Object.keys(n.units)) {
-		let r = t(n, e), i = r.factor / a.factor, o = (r.offset - a.offset) / a.factor;
-		c[e] = o === 0 ? i : {
-			factor: i,
-			offset: o
-		};
-	}
-	return {
-		toDisplay: (e) => {
-			let t = (e - a.offset) / a.factor;
-			return o === void 0 ? t : Math.round(t * o) / o;
-		},
-		fromDisplay: (e) => e * a.factor + a.offset,
-		suffix: s,
-		accepts: c,
-		format: (t) => `${e(t, r, n, {
-			precision: i?.precision ?? 2,
-			suffix: !1
-		})}${s}`
-	};
-}
-var r = {
-	number: !0,
-	boolean: !0,
-	string: !0,
-	enum: !0,
-	color: !0,
-	paint: !0,
-	object: !0
-};
-function i(e) {
-	return Object.hasOwn(r, e.kind);
-}
-//#endregion
-export { r as TOOL_PREF_KINDS, i as isBuiltinToolPref, n as prefUnit };
-
-//# sourceMappingURL=prefs.js.map

package/dist/tools/prefs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"prefs.js","names":["prefUnit","self","unitScale","system","display","scale","opts","suffix","accepts","name","other","factor","offset","shown","stored","formatUnit","TOOL_PREF_KINDS","isBuiltinToolPref","leaf"],"sources":["../../src/tools/prefs.ts"],"sourcesContent":["// src/tools/prefs.ts\n//\n// Minimal pref descriptor for tools that want to expose user-facing\n// settings (commit-on-close, snap thresholds, etc.). Host apps compose\n// these into their own preferences registry; the kit ships no storage\n// or UI of its own. The shape is intentionally narrow — number,\n// boolean, string, enum, plus rendering hints — so it's a clean\n// structural subset of whatever a host app already has.\n\nimport { formatUnit, unitScale } from '@weasel-js/quantity';\nimport type { Display, InfinityText, Unit, UnitEntry, UnitScale, UnitSystem } from '@weasel-js/quantity';\n\n/** The value types a built-in pref leaf can hold. */\nexport type ToolPrefKind =\n  | 'number' | 'boolean' | 'string' | 'enum' | 'color' | 'paint' | 'object';\n\n/** The fields every leaf pref shares, keyed by its `kind` and typed by its stored value. */\nexport interface ToolPrefBase<K extends string, Value> {\n  kind: K;\n  /** Human-readable label. */\n  name: string;\n  /** Longer help text — shown in tooltips / a settings pane. */\n  description: string;\n  /** Fallback when nothing is persisted. */\n  default: Value;\n  /** Hide from a host app's settings UI by default. */\n  hidden?: boolean;\n  /** Render full-width with no label row in schema-driven settings UIs\n   *  (weasel-ui `PrefsForm` honors this for leaves whose control brings\n   *  its own chrome). */\n  block?: boolean;\n  /** Glyph naming this leaf in a host UI's icon set (weasel-ui resolves it\n   *  against `ICON_PATHS`). A plain string because core ships no icon set and\n   *  cannot depend on one. Read where a leaf's `name` has nowhere to go — a\n   *  `pair`ed row is labeled by the pair, so its fields have only the glyph\n   *  to tell them apart. */\n  icon?: string;\n  /** Row-pairing hint for compact property UIs (weasel-ui\n   *  `SelectionPanel`): leaves sharing a `pair` id render side-by-side\n   *  on one row labeled with the `pair` string (e.g. `'Position'` for\n   *  `pose.x` / `pose.y`). Purely presentational. */\n  pair?: string;\n  /** Shorter forms of `name`, longest first. A surface short of room for\n   *  `name` — a strip of controls on one line, a segment in a `pair`ed row —\n   *  shows the longest of them that fits. `name` stays the accessible name, so\n   *  these abbreviate without costing anything. */\n  short?: readonly string[];\n}\n\n/** How a schema-driven UI should present a number pref. */\nexport type ToolPrefNumberControl = 'input' | 'slider';\n/** How a schema-driven UI should present a boolean pref. */\nexport type ToolPrefBooleanControl = 'checkbox' | 'switch' | 'toggle';\n/** How a schema-driven UI should present a string pref. */\nexport type ToolPrefStringControl = 'input' | 'textarea';\n/** How a schema-driven UI should present an enum pref. */\nexport type ToolPrefEnumControl = 'select' | 'radio' | 'toggle';\n\n/** Display-unit conversion for number leaves whose stored value uses a\n *  canonical unit the user shouldn't see (e.g. radians stored, degrees\n *  shown). The stored value stays canonical; UIs convert at the edge. */\nexport interface ToolPrefNumberUnit {\n  toDisplay: (stored: number) => number;\n  fromDisplay: (display: number) => number;\n  /** Shown after the input, e.g. `'°'`. */\n  suffix?: string;\n  /** Suffixes a person may type, each mapped to the scale that turns a\n   *  number in that unit into a display number: `{ mm: 0.1, cm: 1 }` for a\n   *  field showing centimeters. A unit that disagrees with the display unit\n   *  about zero carries an `offset` as well. */\n  accepts?: Readonly<Record<string, UnitEntry>>;\n  /** The stored value as display text, suffix included. */\n  format?: (stored: number) => string;\n}\n\n/**\n * A display unit built from a {@link UnitSystem}: values are stored in the\n * system's base and shown in `display`, rounded to `precision` places when\n * given, and every unit in the system is accepted as typed text. `suffix`\n * defaults to the unit's name and is accepted too.\n */\nexport function prefUnit(\n  system: UnitSystem,\n  display: Unit,\n  opts?: { precision?: number; suffix?: string },\n): ToolPrefNumberUnit {\n  let self: Required<UnitScale>;\n  try {\n    self = unitScale(system, display);\n  } catch (e) {\n    throw new Error(`prefUnit: ${e instanceof Error ? e.message : String(e)}`);\n  }\n  const scale = opts?.precision === undefined ? undefined : 10 ** opts.precision;\n  const suffix = opts?.suffix ?? display;\n  const accepts: Record<string, UnitEntry> = { [suffix]: 1 };\n  for (const name of Object.keys(system.units)) {\n    const other = unitScale(system, name);\n    // A number typed in `name` reaches display units through base:\n    // `(n * factor + offset - self.offset) / self.factor`.\n    const factor = other.factor / self.factor;\n    const offset = (other.offset - self.offset) / self.factor;\n    accepts[name] = offset === 0 ? factor : { factor, offset };\n  }\n  const toDisplay = (stored: number) => {\n    const shown = (stored - self.offset) / self.factor;\n    return scale === undefined ? shown : Math.round(shown * scale) / scale;\n  };\n  return {\n    toDisplay,\n    fromDisplay: (shown) => shown * self.factor + self.offset,\n    suffix,\n    accepts,\n    format: (stored) =>\n      `${formatUnit(stored, display, system, {\n        precision: opts?.precision ?? 2,\n        suffix: false,\n      })}${suffix}`,\n  };\n}\n\n/** A numeric pref, optionally bounded and stepped, and optionally stored in a\n *  different unit from the one shown. */\nexport interface ToolPrefNumber extends ToolPrefBase<'number', number> {\n  min?: number;\n  max?: number;\n  step?: number;\n  control?: ToolPrefNumberControl;\n  /** How the value shows, speaks and reads back when typed — `compact()`\n   *  reads `2.00M`. Presentation only: the stored value stays a number. */\n  display?: Display;\n  unit?: ToolPrefNumberUnit;\n  /** Which end of a slider stands for infinity: the value there is ±Infinity. */\n  endless?: 'min' | 'max' | 'both';\n  /** The word infinity shows as — `'never'`, `'uncapped'`. Default `∞`. */\n  infinity?: InfinityText;\n}\n/**\n * Stored-value bridge for a boolean leaf whose field is not a boolean — the\n * flag counterpart of {@link ToolPrefEnumEncoding}. `TextStyle.fontStyle` is\n * the case: it stores `'italic'`, and the control is an Italic toggle.\n */\nexport interface ToolPrefBooleanEncoding {\n  /** Whether `stored` reads as on. */\n  read: (stored: unknown, siblings: Record<string, unknown> | undefined) => boolean;\n  /** What to store for `on`. `undefined` removes the field. */\n  write: (on: boolean, siblings: Record<string, unknown> | undefined) => unknown;\n}\n\n/** An on/off pref. */\nexport interface ToolPrefBoolean extends ToolPrefBase<'boolean', boolean> {\n  control?: ToolPrefBooleanControl;\n  encoding?: ToolPrefBooleanEncoding;\n}\n/** A free-text pref. */\nexport interface ToolPrefString extends ToolPrefBase<'string', string> {\n  control?: ToolPrefStringControl;\n}\n/**\n * Stored-value bridge for an enum leaf whose value is not the option string —\n * the counterpart of {@link ToolPrefNumberUnit}, which does the same for a\n * number stored in a canonical unit.\n *\n * A dash array is the case that needs it: `Stroke.dash` stores lengths, and\n * the thing a person chooses is a style. The presets scale by the stroke's\n * width, so both directions are given the object's other fields — a style is\n * meaningless without the width it is a multiple of.\n */\nexport interface ToolPrefEnumEncoding<T extends string = string> {\n  /**\n   * The option `stored` reads as, or `undefined` for none — which a UI shows\n   * the way it shows a mixed selection, by selecting nothing.\n   *\n   * `siblings` is the object the leaf is a field of, or `undefined` when the\n   * node does not hold that object (and for a top-level leaf, which has none).\n   */\n  read: (stored: unknown, siblings: Record<string, unknown> | undefined) => T | undefined;\n  /** What to store for `option`. `undefined` removes the field. */\n  write: (option: T, siblings: Record<string, unknown> | undefined) => unknown;\n}\n\n/** A pref with a fixed set of labeled choices. `default` is `undefined` only\n *  for a {@link ToolPrefEnum.clearable} leaf, whose absence is a value. */\nexport interface ToolPrefEnum<T extends string = string>\n  extends ToolPrefBase<'enum', T | undefined> {\n  /**\n   * The field may hold none of the options, and that absence is a state of\n   * its own rather than a missing value — a script that is neither super nor\n   * sub. A toggle control then lets the chosen segment be clicked off, which\n   * removes the field.\n   */\n  clearable?: boolean;\n  /** `short` holds shorter forms of `label`, longest first, for a segmented\n   *  control too narrow for the full one — down to a capital or two. `icon`\n   *  names a glyph in the host UI's set (weasel-ui resolves it against\n   *  `ICON_PATHS`), drawn in place of any text form where it resolves. It is\n   *  a plain string because core ships no icon set and cannot depend on one.\n   *  The full `label` stays the accessible name, so\n   *  neither the abbreviation nor the glyph becomes the only thing naming\n   *  the option.\n   *\n   *  `disabled` marks an option a control reports but cannot author — the\n   *  value a stored form reads as when it matches nothing offered. Dropping it\n   *  from the list instead would leave the control selecting nothing and\n   *  claiming the field is unset. */\n  options: readonly {\n    value: T;\n    label: string;\n    short?: readonly string[];\n    icon?: string;\n    disabled?: boolean;\n  }[];\n  control?: ToolPrefEnumControl;\n  encoding?: ToolPrefEnumEncoding<T>;\n}\n\n/** A single color, stored as a hex string. For a value that may also be a\n *  gradient or a pattern, use {@link ToolPrefPaint} instead. */\nexport interface ToolPrefColor extends ToolPrefBase<'color', string> {\n  /** Value is `#rrggbb`, or `#rrggbbaa` when `alpha` is set (UIs then\n   *  offer an opacity control). */\n  alpha?: boolean;\n}\n\n/**\n * Open leaf: any node with a `kind` outside the built-ins. Schema-driven\n * UIs (weasel-ui `PrefsForm` / `SelectionPanel`) dispatch it to an\n * app-supplied renderer. Deliberately NOT index-signatured so concrete\n * app interfaces stay assignable. Mirrors weasel-ui's `PrefCustom`.\n */\nexport type ToolPrefCustom = ToolPrefBase<string, unknown>;\n\n/**\n * A whole `FillStyle`, not a color inside one. Use it wherever the value is\n * the tagged paint union — a solid color, a pattern, a gradient — rather\n * than a hex string.\n *\n * Addressing `…fill.color` instead reads `undefined` off a gradient (so the\n * control shows its default and claims the text is black) and writes a\n * hybrid `{ fill: 'gradient', stops, color }` that the renderer's structural\n * `'color' in paint` checks then paint flat solid. The union has to be\n * edited as a union.\n */\nexport interface ToolPrefPaint extends ToolPrefBase<'paint', unknown> {\n  /** Offer an opacity control alongside the color. */\n  alpha?: boolean;\n}\n\n/**\n * A leaf whose value is one object, with its own fields hanging off it.\n *\n * A compound value — a stroke, a shadow, a pattern spec — could be described\n * as several sibling leaves addressing into it (`data.stroke.width`,\n * `data.stroke.cap`). It shouldn't be: each control would then write one field\n * of a value it can only half see, and writing into something that is not an\n * object yet corrupts it. Here the fields are `children` of one leaf, and\n * every edit commits the parent object whole.\n *\n * `children` paths are relative to the object. They are ordinary leaves, so a\n * field that is itself a union (a stroke's `paint`) declares the kind that\n * edits that union. A child may also be a {@link ToolPrefGroup}, which\n * organises the fields under a heading without contributing to the path —\n * the same rule group keys follow at the top level. A `TextStyle` needs it:\n * its character and paragraph fields belong to one value but read as two\n * lists.\n */\nexport interface ToolPrefObject extends ToolPrefBase<'object', unknown> {\n  children: Record<string, ToolPrefLeaf | ToolPrefGroup>;\n  /**\n   * Lift a non-object value into the object form, for a consumer field that\n   * may also be held as a scalar. Called before a child edit is applied;\n   * without it a scalar-valued leaf shows its children empty and refuses the\n   * edit.\n   */\n  fromScalar?: (value: unknown) => Record<string, unknown>;\n}\n\n/** One built-in pref leaf. `ToolPrefLeaf` widens this to include\n *  app-defined kinds. */\nexport type ToolPref =\n  | ToolPrefNumber\n  | ToolPrefBoolean\n  | ToolPrefString\n  | ToolPrefEnum\n  | ToolPrefColor\n  | ToolPrefPaint\n  | ToolPrefObject;\n\n// Compile-time tie: every built-in leaf kind must appear in ToolPrefKind\n// and vice versa (ToolPrefBase's K is open for ToolPrefCustom's sake, so\n// the union no longer enforces it).\ntype _BuiltinKindsExact = [ToolPref['kind']] extends [ToolPrefKind]\n  ? [ToolPrefKind] extends [ToolPref['kind']] ? true : never\n  : never;\nconst _builtinKindsExact: _BuiltinKindsExact = true;\nvoid _builtinKindsExact;\n\n/**\n * The built-in kinds, as a table. A kind added to {@link ToolPrefKind} is a\n * compile error here, and from here it is one in every renderer's `never`\n * guard — the only thing standing between a new kind and rendering as\n * nothing in four places at once.\n */\nexport const TOOL_PREF_KINDS: Record<ToolPrefKind, true> = {\n  number: true,\n  boolean: true,\n  string: true,\n  enum: true,\n  color: true,\n  paint: true,\n  object: true,\n};\n\n/**\n * Narrows a leaf to the built-in union, so a renderer's switch discriminates\n * on {@link ToolPrefKind} instead of the open `string` that\n * {@link ToolPrefCustom} widens `kind` to. An app-defined kind answers false\n * and belongs to the renderer's custom-renderer path.\n */\nexport function isBuiltinToolPref(leaf: ToolPrefLeaf): leaf is ToolPref {\n  return Object.hasOwn(TOOL_PREF_KINDS, leaf.kind);\n}\n\n/** Built-in or app-defined leaf. */\nexport type ToolPrefLeaf = ToolPref | ToolPrefCustom;\n\n/** Nestable group: branch nodes a tool can use to organize its prefs. */\nexport interface ToolPrefGroup {\n  /** Heading for the group's rows. **Empty means no heading** — for a group\n   *  that exists to organise, not to name: one whose children are themselves\n   *  groups carrying the labels a reader needs. Give it a name whenever the\n   *  name is the referent (a `Border` group over `Top` / `Right` / `Bottom`\n   *  reads as nothing without it). */\n  name: string;\n  description?: string;\n  children: Record<string, ToolPrefLeaf | ToolPrefGroup>;\n}\n"],"mappings":";;AAiFA,SAAgBA,EACd,GACA,GACA,GACoB;CACpB,IAAIC;CACJ,IAAI;EACF,IAAOC,EAAUC,GAAQC,CAAO;CAClC,SAAS,GAAG;EACV,MAAU,MAAM,aAAa,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC,GAAG;CAC3E;CACA,IAAMC,IAAQC,GAAM,cAAc,KAAA,IAAY,KAAA,IAAY,MAAMA,EAAK,WAC/DC,IAASD,GAAM,UAAUF,GACzBI,IAAqC,GAAGD,IAAS,EAAE;CACzD,KAAK,IAAME,KAAQ,OAAO,KAAKN,EAAO,KAAK,GAAG;EAC5C,IAAMO,IAAQR,EAAUC,GAAQM,CAAI,GAG9BE,IAASD,EAAM,SAAST,EAAK,QAC7BW,KAAUF,EAAM,SAAST,EAAK,UAAUA,EAAK;EACnD,EAAQQ,KAAQG,MAAW,IAAID,IAAS;GAAE;GAAQ;EAAO;CAC3D;CAKA,OAAO;EACL,YALiB,MAAmB;GACpC,IAAME,KAASC,IAASb,EAAK,UAAUA,EAAK;GAC5C,OAAOI,MAAU,KAAA,IAAYQ,IAAQ,KAAK,MAAMA,IAAQR,CAAK,IAAIA;EACnE;EAGE,cAAc,MAAUQ,IAAQZ,EAAK,SAASA,EAAK;EACnD;EACA;EACA,SAAS,MACP,GAAGc,EAAWD,GAAQV,GAASD,GAAQ;GACrC,WAAWG,GAAM,aAAa;GAC9B,QAAQ;EACV,CAAC,IAAIC;CACT;AACF;AAwLA,IAAaS,IAA8C;CACzD,QAAQ;CACR,SAAS;CACT,QAAQ;CACR,MAAM;CACN,OAAO;CACP,OAAO;CACP,QAAQ;AACV;AAQA,SAAgBC,EAAkB,GAAsC;CACtE,OAAO,OAAO,OAAOD,GAAiBE,EAAK,IAAI;AACjD"}