@weasel-js/ui 0.5.0 → 0.5.1

package/dist/components/Keycaps/Keycaps.d.ts

@@ -0,0 +1,29 @@
+import { type KeyCapVariant } from './Keycap';
+export interface KeySpec {
+    /** Glyph rendered in the chip (modifier or key). */
+    label: string;
+    /** When true, the chip renders inverted to mark it as not required to
+     *  trigger the action (e.g. an optional modifier). Defaults to false. */
+    optional?: boolean;
+}
+export interface KeySequenceProps {
+    /** Keys to render. `undefined` or empty renders a muted em-dash.
+     *  Modifiers are always rendered first regardless of input order; relative
+     *  order within each group is preserved. */
+    keys: readonly KeySpec[] | undefined;
+    /** Character inserted between the trailing modifier chip and the first
+     *  non-modifier chip (e.g. `'+'` renders `⌘ + K`). `null` or `''`
+     *  suppresses it. Defaults to `'+'`. */
+    separator?: string | null;
+    /** Forwarded to every `KeyCap` in the sequence. `'minimal'` renders
+     *  unfilled chips whose border + legend are `currentColor`. */
+    variant?: KeyCapVariant;
+    /** Forwarded to every `KeyCap` in the sequence. Overrides the design-
+     *  system UI font for that chip only. */
+    font?: string;
+    className?: string;
+}
+/** Renders a shortcut as a row of `KeyCap` chips, one per key. Optional
+ *  keys render inverted to distinguish them from required ones. */
+export declare function KeySequence({ keys, separator, variant, font, className }: KeySequenceProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Keycaps.d.ts.map

package/dist/components/Keycaps/Keycaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Keycaps.d.ts","sourceRoot":"","sources":["../../../src/components/Keycaps/Keycaps.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA2B,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAEvE,MAAM,WAAW,OAAO;IACtB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd;6EACyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;gDAE4C;IAC5C,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC;IACrC;;4CAEwC;IACxC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;mEAC+D;IAC/D,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;6CACyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;mEACmE;AACnE,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,SAAe,EAAE,OAAmB,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,gBAAgB,2CAwB5G"}

package/dist/components/Keycaps/index.d.ts

@@ -0,0 +1,8 @@
+export { KeyCap, inferKeycapKind } from './Keycap';
+export type { KeyCapProps, KeyCapVariant, KeycapKind } from './Keycap';
+export { KeySequence } from './Keycaps';
+export type { KeySequenceProps, KeySpec } from './Keycaps';
+export { keyGlyph } from './keyGlyph';
+export { keySpecsFromMods, keySpecFromKey, detectPlatform } from './keySpecsFromMods';
+export type { LogicalMod, LogicalModSpec, Platform, LegendStyle, KeySpecsFromModsOptions, } from './keySpecsFromMods';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Keycaps/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Keycaps/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACtF,YAAY,EACV,UAAU,EACV,cAAc,EACd,QAAQ,EACR,WAAW,EACX,uBAAuB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/components/Keycaps/keyGlyph.d.ts

@@ -0,0 +1,7 @@
+/** Apple-style glyph for a DOM `KeyboardEvent.key` value. Covers escape,
+ *  delete/backspace, arrows, enter/return, tab, space. Unknown keys are
+ *  upper-cased (so `'a'` reads as `A` on a keycap) and returned unchanged
+ *  otherwise — making this safe to apply uniformly without a `has-glyph`
+ *  check at the call site. */
+export declare function keyGlyph(rawKey: string): string;
+//# sourceMappingURL=keyGlyph.d.ts.map

package/dist/components/Keycaps/keyGlyph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyGlyph.d.ts","sourceRoot":"","sources":["../../../src/components/Keycaps/keyGlyph.ts"],"names":[],"mappings":"AAAA;;;;8BAI8B;AAC9B,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAgB/C"}

package/dist/components/Keycaps/keySpecsFromMods.d.ts

@@ -0,0 +1,81 @@
+import type { KeySpec } from './Keycaps';
+/** Logical modifier name. Matches the kit's `ModifierKey` in shape — kept as a
+ *  local type so `weasel-ui` stays independent of `@weasel-js/core`. */
+export type LogicalMod = 'mod' | 'shift' | 'alt' | 'ctrl' | 'meta';
+/** Detected (or overridden) platform. `'mod'` resolves to ⌘ on macOS,
+ *  Ctrl on Windows / Linux. */
+export type Platform = 'macos' | 'windows' | 'linux';
+/** Visual form of a modifier or named-key label.
+ *
+ *  - `'auto'` (default): the per-entry, per-platform default — whatever
+ *    label is actually printed on the physical key. macOS keys show the
+ *    Apple glyphs (⌘ ⌥ ⌃ ⇧ ⎋ ↵ ⇥). Windows keys mostly show text
+ *    (Ctrl, Alt, Shift) BUT the Win key shows its logo (⊞) and the
+ *    context-menu key shows ▤. Linux mirrors Windows with Super (⊞).
+ *  - `'symbol'` forces the Apple-style glyph everywhere a symbolic form
+ *    exists. Entries without a widely-recognized symbol still fall
+ *    back to text.
+ *  - `'text'` always spells the label out (Cmd / Option / Esc / Enter). */
+export type LegendStyle = 'auto' | 'symbol' | 'text';
+export interface LogicalModSpec {
+    name: LogicalMod;
+    /** Marks this modifier as optional (may be held but isn't required).
+     *  Forwarded as the resulting `KeySpec.optional`. */
+    optional?: boolean;
+}
+export interface KeySpecsFromModsOptions {
+    /** Override OS detection. Defaults to the detected platform, or
+     *  `'macos'` when detection is unavailable (e.g. in tests, or when
+     *  `navigator` is missing). */
+    platform?: Platform;
+    /** Defaults to `'auto'` (symbol on macOS, text everywhere else). Pass
+     *  `'symbol'` or `'text'` to force a specific style regardless of
+     *  platform. */
+    legend?: LegendStyle;
+}
+/** Detect the user's OS from the browser environment. UA sniffing — not
+ *  100% reliable, but adequate for picking a modifier-glyph convention.
+ *  Falls back to `'macos'` (matches the kit's docs convention) when
+ *  `navigator` is unavailable. */
+export declare function detectPlatform(): Platform;
+/**
+ * Map a list of **logical** modifiers (`'mod'`, `'shift'`, …) to **visual**
+ * `KeySpec`s appropriate for the current platform.
+ *
+ * The kit-side gesture grammar uses logical names so the same route reads
+ * correctly on every OS — `'mod'` means "Cmd on Mac, Ctrl on Win/Linux".
+ * `KeySequence` is purely visual and renders the labels you give it; this
+ * helper is the bridge.
+ *
+ * ```ts
+ * <KeySequence
+ *   keys={keySpecsFromMods([{ name: 'mod' }, { name: 'shift', optional: true }])}
+ * />
+ * ```
+ *
+ * On a Mac: renders `⌘ ⇧`. On Windows: renders `Ctrl Shift`. Pass an
+ * explicit `platform` to override detection (e.g. for docs that always
+ * show the macOS form). Pass `legend: 'text'` to force "Cmd" over "⌘"
+ * even on macOS.
+ */
+export declare function keySpecsFromMods(mods: readonly LogicalModSpec[], opts?: KeySpecsFromModsOptions): readonly KeySpec[];
+/**
+ * Render a raw `KeyboardEvent.key` value as a platform-appropriate
+ * `KeySpec`. Named non-modifier keys (Esc, Enter, Tab, Space, Backspace,
+ * Delete, arrows) get the platform's conventional form. Letter / digit /
+ * other keys pass through upper-cased.
+ *
+ * ```ts
+ * keySpecFromKey('Escape', { platform: 'macos' })   // { label: '⎋' }
+ * keySpecFromKey('Escape', { platform: 'windows' }) // { label: 'Esc' }
+ * keySpecFromKey('p')                               // { label: 'P' }
+ * ```
+ *
+ * Symbol mode is only meaningful on macOS — Windows / Linux keyboards
+ * print the text form on the physical key, so symbol mode there falls
+ * back to text.
+ */
+export declare function keySpecFromKey(raw: string, opts?: KeySpecsFromModsOptions & {
+    optional?: boolean;
+}): KeySpec;
+//# sourceMappingURL=keySpecsFromMods.d.ts.map

package/dist/components/Keycaps/keySpecsFromMods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keySpecsFromMods.d.ts","sourceRoot":"","sources":["../../../src/components/Keycaps/keySpecsFromMods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;wEACwE;AACxE,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnE;+BAC+B;AAC/B,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAErD;;;;;;;;;;2EAU2E;AAC3E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB;yDACqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC;;mCAE+B;IAC/B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;oBAEgB;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAgCD;;;kCAGkC;AAClC,wBAAgB,cAAc,IAAI,QAAQ,CASzC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,cAAc,EAAE,EAC/B,IAAI,GAAE,uBAA4B,GACjC,SAAS,OAAO,EAAE,CAOpB;AAuBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,uBAAuB,GAAG;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1D,OAAO,CAMT"}

package/dist/components/NumberField/NumberField.d.ts

@@ -0,0 +1,25 @@
+import { type ReactNode } from 'react';
+import { type NumberFieldProps as RACNumberFieldProps, type ValidationResult } from 'react-aria-components';
+export type NumberFieldProps = Omit<RACNumberFieldProps, 'children' | 'className'> & {
+    label?: ReactNode;
+    description?: ReactNode;
+    errorMessage?: ReactNode | ((v: ValidationResult) => ReactNode);
+    /** Hide the up/down stepper buttons. Defaults to false. */
+    hideSteppers?: boolean;
+    /** Native input placeholder — e.g. `'Mixed'` for a multi-selection
+     *  editor with no shared value. */
+    placeholder?: string;
+    className?: string;
+};
+export declare const NumberField: import("react").ForwardRefExoticComponent<Omit<RACNumberFieldProps, "children" | "className"> & {
+    label?: ReactNode;
+    description?: ReactNode;
+    errorMessage?: ReactNode | ((v: ValidationResult) => ReactNode);
+    /** Hide the up/down stepper buttons. Defaults to false. */
+    hideSteppers?: boolean;
+    /** Native input placeholder — e.g. `'Mixed'` for a multi-selection
+     *  editor with no shared value. */
+    placeholder?: string;
+    className?: string;
+} & import("react").RefAttributes<HTMLInputElement>>;
+//# sourceMappingURL=NumberField.d.ts.map

package/dist/components/NumberField/NumberField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumberField.d.ts","sourceRoot":"","sources":["../../../src/components/NumberField/NumberField.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAC7D,OAAO,EAQL,KAAK,gBAAgB,IAAI,mBAAmB,EAC5C,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAI/B,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,EAAE,UAAU,GAAG,WAAW,CAAC,GAAG;IACnF,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,YAAY,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,gBAAgB,KAAK,SAAS,CAAC,CAAC;IAChE,2DAA2D;IAC3D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;uCACmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,WAAW;YAXd,SAAS;kBACH,SAAS;mBACR,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,gBAAgB,KAAK,SAAS,CAAC;IAC/D,2DAA2D;mBAC5C,OAAO;IACtB;uCACmC;kBACrB,MAAM;gBACR,MAAM;oDA+BlB,CAAC"}

package/dist/components/NumberField/index.d.ts

@@ -0,0 +1,3 @@
+export { NumberField } from './NumberField';
+export type { NumberFieldProps } from './NumberField';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/NumberField/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/NumberField/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/components/OptionsBar/OptionsBar.d.ts

@@ -0,0 +1,25 @@
+import { type ReactElement, type ReactNode } from 'react';
+export type OptionsBarItem<V extends string | number = string> = {
+    value: V;
+    label?: ReactNode;
+    ariaLabel?: string;
+    disabled?: boolean;
+    selected: boolean;
+    onChange: (next: boolean) => void;
+};
+export type OptionsBarSize = 'sm' | 'md';
+export type OptionsBarVariant = 'default' | 'minimal';
+export type OptionsBarProps<V extends string | number = string> = {
+    items: readonly OptionsBarItem<V>[];
+    ariaLabel?: string;
+    className?: string;
+    height?: number;
+    /** Size variant. `sm` is ~60% of the default height with reduced padding
+     *  and font size — sized for dense surfaces like lab control panels. */
+    size?: OptionsBarSize;
+    /** Visual variant. `minimal` strips the pill track and glass treatment;
+     *  selection becomes a flat accent. For dense diagnostic surfaces. */
+    variant?: OptionsBarVariant;
+};
+export declare function OptionsBar<V extends string | number = string>(props: OptionsBarProps<V>): ReactElement;
+//# sourceMappingURL=OptionsBar.d.ts.map

package/dist/components/OptionsBar/OptionsBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptionsBar.d.ts","sourceRoot":"","sources":["../../../src/components/OptionsBar/OptionsBar.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAwE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGhI,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,IAAI;IAC/D,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAAC;AACzC,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,SAAS,CAAC;AAEtD,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,IAAI;IAChE,KAAK,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;4EACwE;IACxE,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB;0EACsE;IACtE,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B,CAAC;AA8BF,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,YAAY,CAwFtG"}

package/dist/components/OptionsBar/index.d.ts

@@ -0,0 +1,3 @@
+export { OptionsBar } from './OptionsBar';
+export type { OptionsBarItem, OptionsBarProps, OptionsBarSize, OptionsBarVariant } from './OptionsBar';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/OptionsBar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/OptionsBar/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/components/Plot2D/Plot2D.d.ts

@@ -0,0 +1,60 @@
+import { type CSSProperties, type KeyboardEvent as ReactKeyboardEvent, type PointerEvent as ReactPointerEvent, type ReactNode } from 'react';
+import { type Point } from './geometry';
+export interface GridSettings {
+    /** Number of evenly-spaced internal grid lines per axis (excluding
+     *  the edges). Applied to both x and y. Default 3. */
+    divisions?: number;
+    /** Stroke color override. When omitted, uses `var(--plot-grid)`. */
+    color?: string;
+}
+export interface AxesSettings {
+    /** Stroke color override. When omitted, uses `var(--plot-axis)`. */
+    color?: string;
+}
+export interface Plot2DCoords {
+    plot: Point;
+    model: Point;
+}
+export interface Plot2DProps {
+    width: number;
+    height: number;
+    /** Model-space x range. Default [0, 1]. */
+    xRange?: readonly [number, number];
+    /** Model-space y range. Default [0, 1]. */
+    yRange?: readonly [number, number];
+    /** Background grid. `false` / `null` / omitted = no grid. Pass `{}`
+     *  for default (3 divisions per axis) or populated GridSettings. */
+    grid?: GridSettings | false | null;
+    /** Axis lines. `false` / `null` = no axes. Omitted = default-styled
+     *  axes (on). Pass AxesSettings to customize. */
+    axes?: AxesSettings | false | null;
+    /** Forwarded to the underlying svg. Consumer opts into focus this way. */
+    tabIndex?: number;
+    className?: string;
+    style?: CSSProperties;
+    /** Pointer down on the SVG. Receives both plot- and model-space coords
+     *  pre-computed so consumers don't repeat the rect/transform dance. */
+    onPointerDown?: (e: ReactPointerEvent<SVGSVGElement>, coords: Plot2DCoords) => void;
+    onKeyDown?: (e: ReactKeyboardEvent<SVGSVGElement>) => void;
+    children?: ReactNode;
+}
+export interface Plot2DHandle {
+    readonly svg: SVGSVGElement | null;
+    plotToModel(pt: Point): Point;
+    modelToPlot(pt: Point): Point;
+    /** Convert a DOM event's clientX/clientY (e.g. from a window-attached
+     *  pointermove during drag) to plot-space. */
+    clientToPlot(e: {
+        clientX: number;
+        clientY: number;
+    }): Point;
+    /** Convenience: clientToPlot → plotToModel. */
+    clientToModel(e: {
+        clientX: number;
+        clientY: number;
+    }): Point;
+    readonly width: number;
+    readonly height: number;
+}
+export declare const Plot2D: import("react").ForwardRefExoticComponent<Plot2DProps & import("react").RefAttributes<Plot2DHandle>>;
+//# sourceMappingURL=Plot2D.d.ts.map

package/dist/components/Plot2D/Plot2D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plot2D.d.ts","sourceRoot":"","sources":["../../../src/components/Plot2D/Plot2D.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,aAAa,IAAI,kBAAkB,EACxC,KAAK,YAAY,IAAI,iBAAiB,EACtC,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAEY,KAAK,KAAK,EAC5B,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,YAAY;IAC3B;0DACsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,2CAA2C;IAC3C,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC;wEACoE;IACpE,IAAI,CAAC,EAAE,YAAY,GAAG,KAAK,GAAG,IAAI,CAAC;IACnC;qDACiD;IACjD,IAAI,CAAC,EAAE,YAAY,GAAG,KAAK,GAAG,IAAI,CAAC;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;2EACuE;IACvE,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,iBAAiB,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IACpF,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,kBAAkB,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,EAAE,KAAK,GAAG,KAAK,CAAC;IAC9B,WAAW,CAAC,EAAE,EAAE,KAAK,GAAG,KAAK,CAAC;IAC9B;kDAC8C;IAC9C,YAAY,CAAC,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;IAC7D,+CAA+C;IAC/C,aAAa,CAAC,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,MAAM,sGA2HjB,CAAC"}

package/dist/components/Plot2D/geometry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Coordinate transforms (model ↔ plot) for Plot2D. Pure / deterministic —
+ * no DOM, no React, no state.
+ *
+ * Model space: caller-defined xRange × yRange. Y axis goes UP.
+ * Plot space: 0..width × 0..height in CSS pixels. Y axis goes DOWN (SVG).
+ */
+export interface Point {
+    x: number;
+    y: number;
+}
+export interface ModelRange {
+    xMin: number;
+    xMax: number;
+    yMin: number;
+    yMax: number;
+}
+export interface PlotSize {
+    width: number;
+    height: number;
+}
+export declare function modelToPlot(p: Point, m: ModelRange, plot: PlotSize): Point;
+export declare function plotToModel(p: Point, m: ModelRange, plot: PlotSize): Point;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/components/Plot2D/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../../src/components/Plot2D/geometry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,KAAK,CAQ1E;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,KAAK,CAO1E"}

package/dist/components/Plot2D/index.d.ts

@@ -0,0 +1,3 @@
+export { Plot2D, type Plot2DProps, type Plot2DHandle, type Plot2DCoords, type GridSettings, type AxesSettings, } from './Plot2D';
+export { modelToPlot, plotToModel, type Point, type ModelRange, type PlotSize, } from './geometry';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Plot2D/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Plot2D/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,WAAW,EACX,WAAW,EACX,KAAK,KAAK,EACV,KAAK,UAAU,EACf,KAAK,QAAQ,GACd,MAAM,YAAY,CAAC"}

package/dist/components/PointPlotter/PointPlotter.d.ts

@@ -0,0 +1,51 @@
+import type { CSSProperties, ReactNode } from 'react';
+import { type AnchorRenderProps, type ControlPoint } from '../CurveEditor';
+import type { GridSettings, AxesSettings } from '../Plot2D';
+export interface PointPlotterProps {
+    /** Plotted points; caller-owned. */
+    value: readonly ControlPoint[];
+    /** Fires every frame during drag with the live in-flight value. */
+    onChange: (next: ControlPoint[]) => void;
+    /** Fires once per discrete user action (drag-end, add, delete) with
+     *  the new value and the value at gesture start. Wire history here. */
+    onChangeCommit?: (next: ControlPoint[], prev: readonly ControlPoint[]) => void;
+    /** Model-space x range. Default [0, 1]. */
+    xRange?: readonly [number, number];
+    /** Model-space y range. Default [0, 1]. */
+    yRange?: readonly [number, number];
+    width: number;
+    height: number;
+    grid?: GridSettings | false | null;
+    axes?: AxesSettings | false | null;
+    /** Minimum allowed point count. User-initiated deletion is refused
+     *  while `value.length <= minPoints`. */
+    minPoints?: number;
+    /** Maximum allowed point count. User-initiated insertion is refused
+     *  while `value.length >= maxPoints`. */
+    maxPoints?: number;
+    /** How new points are added. Default `'click-empty'`. Set to `'never'`
+     *  to disable insertion entirely. */
+    addPointMode?: 'click-empty' | 'never';
+    /** Built-in undo/redo via keyboard when the component has focus.
+     *  Default `true`. See `CurveEditor.history` for details. */
+    history?: boolean;
+    /** Custom per-anchor renderer. See `CurveEditor.renderAnchor`. */
+    renderAnchor?: (info: AnchorRenderProps) => ReactNode;
+    /** Extra SVG content beneath the anchors. See `CurveEditor.decorations`. */
+    decorations?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * 2D point plotter — a CurveEditor with the curve hidden. Anchors,
+ * drag, shift+click delete, right-click delete, and click-empty insert
+ * are inherited from CurveEditor verbatim, so the two components share
+ * gesture semantics and stay in sync as CurveEditor evolves.
+ *
+ * Differences from CurveEditor: no curve `<path>` drawn, no fill, no
+ * endpoint pinning, no interpolation, default `addPointMode` is
+ * `'click-empty'` (CurveEditor defaults to `'click-curve'`, which
+ * doesn't make sense without a curve to hit-test against).
+ */
+export declare function PointPlotter(props: PointPlotterProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PointPlotter.d.ts.map

package/dist/components/PointPlotter/PointPlotter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointPlotter.d.ts","sourceRoot":"","sources":["../../../src/components/PointPlotter/PointPlotter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAElB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,mEAAmE;IACnE,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;IACzC;2EACuE;IACvE,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,YAAY,EAAE,KAAK,IAAI,CAAC;IAC/E,2CAA2C;IAC3C,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,2CAA2C;IAC3C,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,YAAY,GAAG,KAAK,GAAG,IAAI,CAAC;IACnC,IAAI,CAAC,EAAE,YAAY,GAAG,KAAK,GAAG,IAAI,CAAC;IACnC;6CACyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;6CACyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;yCACqC;IACrC,YAAY,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;IACvC;iEAC6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,SAAS,CAAC;IACtD,4EAA4E;IAC5E,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,2CASpD"}

package/dist/components/PointPlotter/index.d.ts

@@ -0,0 +1,2 @@
+export { PointPlotter, type PointPlotterProps } from './PointPlotter';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/PointPlotter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/PointPlotter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/components/Powerline/Powerline.d.ts

@@ -0,0 +1,32 @@
+import type { ReactNode } from 'react';
+import type { BadgeSize, BadgeTone, BadgeVariant } from '../Badge/types';
+import type { EdgeCap } from '../Badge/bases/edgeProfiles';
+export interface PowerlineSegment {
+    text: ReactNode;
+    /** Cap on this segment's right edge. Next segment's left edge adopts the same profile. */
+    endCap?: EdgeCap;
+    tone?: BadgeTone;
+    variant?: BadgeVariant;
+    size?: BadgeSize;
+    onClick?: () => void;
+    href?: string;
+    'aria-label'?: string;
+}
+export interface PowerlineProps {
+    segments: PowerlineSegment[];
+    /** Left edge of the first segment. Defaults to 'flat'. */
+    startCap?: EdgeCap;
+    /** Default size for every segment (per-segment `size` wins). */
+    size?: BadgeSize;
+    /** Default variant for every segment (per-segment `variant` wins). */
+    variant?: BadgeVariant;
+    /** Protrusion depth in CSS px, passed through to every segment's base. */
+    depth?: number;
+    /** Visible gap between adjacent segments. Number → px; string → literal CSS length.
+     *  Default: `0.2em` (scales with the row's font size). Pass `0` for flush. */
+    gap?: number | string;
+    className?: string;
+    'aria-label'?: string;
+}
+export declare function Powerline({ segments, startCap, size, variant, depth, gap, className, ...rest }: PowerlineProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Powerline.d.ts.map

package/dist/components/Powerline/Powerline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Powerline.d.ts","sourceRoot":"","sources":["../../../src/components/Powerline/Powerline.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAG3D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,sEAAsE;IACtE,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;kFAC8E;IAC9E,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,SAAS,CAAC,EACxB,QAAQ,EACR,QAAiB,EACjB,IAAI,EACJ,OAAO,EACP,KAAK,EACL,GAAG,EACH,SAAS,EACT,GAAG,IAAI,EACR,EAAE,cAAc,2CA6BhB"}

package/dist/components/Powerline/index.d.ts

@@ -0,0 +1,5 @@
+export { Powerline } from './Powerline';
+export type { PowerlineProps, PowerlineSegment } from './Powerline';
+export type { EdgeCap, EdgeProfile, BuiltInEdgeName } from '../Badge/bases/edgeProfiles';
+export { EDGE_PROFILES } from '../Badge/bases/edgeProfiles';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Powerline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Powerline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/components/Prefs/PrefsDialog.d.ts

@@ -0,0 +1,21 @@
+import type { ReactNode } from 'react';
+import { type PrefsFormProps } from './PrefsForm';
+export interface PrefsDialogProps extends PrefsFormProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** Dialog heading. Defaults to the schema root's `name`. */
+    title?: ReactNode;
+    /** Extra chrome rendered inline with the title (e.g. a dev-mode
+     *  "Show hidden" switch). */
+    headerExtra?: ReactNode;
+    /** Class applied to the dialog's modal box. */
+    dialogClassName?: string;
+}
+/**
+ * The kit's preferences dialog: `Dialog` + `PrefsForm`. Changes apply
+ * live through `onChange` — there is no OK/Cancel staging. For custom
+ * placement (sidebar, popover, inline page), compose `PrefsForm`
+ * directly; this wrapper is intentionally thin.
+ */
+export declare function PrefsDialog(props: PrefsDialogProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PrefsDialog.d.ts.map

package/dist/components/Prefs/PrefsDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrefsDialog.d.ts","sourceRoot":"","sources":["../../../src/components/Prefs/PrefsDialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7D,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,4DAA4D;IAC5D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;iCAC6B;IAC7B,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CAsBlD"}

package/dist/components/Prefs/PrefsForm.d.ts

@@ -0,0 +1,42 @@
+import { type ReactNode } from 'react';
+import { type PrefGroup, type PrefLeaf } from './schema';
+export interface PrefRenderContext {
+    /** Dotted path of the leaf within the schema root. */
+    path: string;
+    /** The schema node. App renderers narrow this to their own kind shape. */
+    pref: PrefLeaf;
+    /** Current value — `values` at `path`, falling back to `pref.default`. */
+    value: unknown;
+    setValue: (value: unknown) => void;
+}
+export type PrefRenderer = (ctx: PrefRenderContext) => ReactNode;
+export interface PrefsFormProps {
+    /** Root of the schema tree. Core `ToolPrefGroup`s assign structurally. */
+    schema: PrefGroup;
+    /** Nested value tree (shape mirrors the schema). Sparse is fine —
+     *  missing leaves fall back to their schema `default`. */
+    values?: unknown;
+    /** Change callback with the leaf's dotted path. Values apply live;
+     *  there is no dirty/commit state. */
+    onChange: (path: string, value: unknown) => void;
+    /**
+     * Per-kind renderers for app-defined kinds. Entries also override the
+     * built-in kinds when keys collide. A renderer owns the control cell
+     * (the label/tooltip row chrome stays with the form, unless the leaf
+     * sets `block`); returning `null` collapses the row entirely. Unknown
+     * kinds with no renderer show a labeled placeholder instead of
+     * crashing.
+     */
+    renderers?: Record<string, PrefRenderer>;
+    /** Reveal `hidden` leaves (dev tooling). Default false. */
+    showHidden?: boolean;
+    className?: string;
+}
+/**
+ * Schema-driven preferences form. Top-level groups render as columns,
+ * nested groups as indented sub-panels, leaves as label + control rows.
+ * Storage-agnostic: pair with `PrefsDialog` for the modal composition,
+ * and persist however the app likes via `onChange`.
+ */
+export declare function PrefsForm(props: PrefsFormProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PrefsForm.d.ts.map

package/dist/components/Prefs/PrefsForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrefsForm.d.ts","sourceRoot":"","sources":["../../../src/components/Prefs/PrefsForm.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAWhD,OAAO,EAOL,KAAK,SAAS,EACd,KAAK,QAAQ,EAGd,MAAM,UAAU,CAAC;AAGlB,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,IAAI,EAAE,QAAQ,CAAC;IACf,0EAA0E;IAC1E,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,SAAS,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,MAAM,EAAE,SAAS,CAAC;IAClB;8DAC0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;0CACsC;IACtC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,2CAsB9C"}

package/dist/components/Prefs/index.d.ts

@@ -0,0 +1,4 @@
+export { PrefsForm, type PrefsFormProps, type PrefRenderer, type PrefRenderContext } from './PrefsForm';
+export { PrefsDialog, type PrefsDialogProps } from './PrefsDialog';
+export { isPrefLeaf, prefValueAtPath, visiblePrefSubtree, type BuiltinPref, type PrefBoolean, type PrefBooleanControl, type PrefColor, type PrefCustom, type PrefEnum, type PrefEnumControl, type PrefGroup, type PrefLeaf, type PrefNumber, type PrefNumberControl, type PrefNumberUnit, type PrefString, type PrefStringControl, } from './schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Prefs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Prefs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACxG,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EACL,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,iBAAiB,GACvB,MAAM,UAAU,CAAC"}

package/dist/components/Prefs/schema.d.ts

@@ -0,0 +1,85 @@
+/** Control-presentation hints per kind — visually-equivalent renderings
+ *  of the same value type. The persisted value is unchanged either way. */
+export type PrefNumberControl = 'input' | 'slider';
+export type PrefBooleanControl = 'checkbox' | 'switch';
+export type PrefStringControl = 'input' | 'textarea';
+export type PrefEnumControl = 'select' | 'radio';
+interface PrefBase<K extends string, Value> {
+    kind: K;
+    /** Human-readable label, e.g. "Show grid". */
+    name: string;
+    /** Longer help text — surfaces as a tooltip on the row label. */
+    description: string;
+    /** Fallback when `values` holds nothing at this leaf's path. */
+    default: Value;
+    /** Omitted from the form unless `showHidden` is set. */
+    hidden?: boolean;
+    /** Render the control full-width with no label/tooltip row — for
+     *  controls that supply their own chrome (embedded sub-panel editors).
+     *  The `description` still applies wherever the renderer surfaces it. */
+    block?: boolean;
+    /** Row-pairing hint for compact property UIs (`SelectionPanel`):
+     *  leaves sharing a `pair` id render side-by-side on one row labeled
+     *  with the `pair` string. Purely presentational. */
+    pair?: string;
+}
+/** Display-unit conversion for number leaves whose stored value uses a
+ *  canonical unit the user shouldn't see (radians → degrees). Mirrors
+ *  core's `ToolPrefNumberUnit`. */
+export interface PrefNumberUnit {
+    toDisplay: (stored: number) => number;
+    fromDisplay: (display: number) => number;
+    suffix?: string;
+}
+export interface PrefNumber extends PrefBase<'number', number> {
+    min?: number;
+    max?: number;
+    step?: number;
+    control?: PrefNumberControl;
+    unit?: PrefNumberUnit;
+}
+export interface PrefBoolean extends PrefBase<'boolean', boolean> {
+    control?: PrefBooleanControl;
+}
+export interface PrefString extends PrefBase<'string', string> {
+    control?: PrefStringControl;
+}
+export interface PrefEnum<T extends string = string> extends PrefBase<'enum', T> {
+    options: readonly {
+        value: T;
+        label: string;
+    }[];
+    control?: PrefEnumControl;
+}
+export interface PrefColor extends PrefBase<'color', string> {
+    /** Value is `#rrggbb`, or `#rrggbbaa` when `alpha` is set. */
+    alpha?: boolean;
+}
+export type BuiltinPref = PrefNumber | PrefBoolean | PrefString | PrefEnum | PrefColor;
+/**
+ * Open leaf: any node with a `kind` the form doesn't know renders via the
+ * `renderers` map (`renderers[kind]`). App schemas keep their extra fields
+ * (e.g. a registry-enum's `source`/`filter`) — renderers receive the node
+ * and narrow it themselves. Deliberately NOT index-signatured so concrete
+ * app interfaces stay assignable.
+ */
+export interface PrefCustom extends PrefBase<string, unknown> {
+}
+export type PrefLeaf = BuiltinPref | PrefCustom;
+/** Nestable group: branch nodes in the schema tree. */
+export interface PrefGroup {
+    name: string;
+    description?: string;
+    children: Record<string, PrefLeaf | PrefGroup>;
+}
+export declare function isPrefLeaf(node: PrefLeaf | PrefGroup): node is PrefLeaf;
+/** Get the value at a dotted path inside a nested value tree. Returns
+ *  `undefined` when a segment is missing or hits a non-object. */
+export declare function prefValueAtPath(values: unknown, path: string): unknown;
+/**
+ * Recursively drop `hidden` leaves (unless `showHidden`), pruning groups
+ * that end up empty. Returns null when the entire subtree is hidden.
+ */
+export declare function visiblePrefSubtree<T extends PrefLeaf | PrefGroup>(node: T, showHidden: boolean): T | null;
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/components/Prefs/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/components/Prefs/schema.ts"],"names":[],"mappings":"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"}