@weasel-js/labkit 1.5.2 → 1.6.0

package/dist/_dts/index-8LiKe3A-.d.ts

@@ -1,410 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
-import { ToolPrefNumberFormat } from '@weasel-js/core';
-import { R as ResolvedConfig, a as ConfigField, d as ControlRenderer } from './types-Db-3NNk1.js';
-
-/**
- * How much room a container gives its rows — gaps, padding, and field height,
- * moved together. Set on any container in the family; it reaches every
- * descendant, so an inner group can differ from the panel around it.
- */
-type PropertyDensity = 'tight' | 'normal' | 'roomy';
-/** Where an inline row's label and control sit on the row's cross axis. Set on
- *  a container to line a whole column of them up. */
-type PropertyAlign = 'start' | 'center' | 'end' | 'baseline';
-/** Metric props every container in the family takes. Both reach descendants,
- *  so the nearest container that states one wins. */
-interface PropertyMetricProps {
-    /** Room the rows get. Unset inherits from an outer container, else `normal`. */
-    density?: PropertyDensity;
-    /**
-     * Cross-axis alignment of an inline row's label and control. `baseline` sits
-     * the control on the label's first-line baseline, which is what lines a
-     * column of swatches up against labels of different heights. Unset keeps each
-     * variant's own alignment — a color row centers its label and swatch and
-     * sinks the pair to the row's bottom edge, which keeps a paired alpha track
-     * level with its neighbour.
-     */
-    align?: PropertyAlign;
-}
-/** Props for `<PropertyPanel>`. */
-interface PropertyPanelProps extends PropertyMetricProps {
-    title?: ReactNode;
-    children: ReactNode;
-    className?: string;
-}
-/** A titled panel holding property rows — the sidebar container the rest of
- *  this module's components fill. */
-declare function PropertyPanel({ title, children, className, density, align, }: PropertyPanelProps): react_jsx_runtime.JSX.Element;
-/** How a property list packs its rows into two columns. */
-type PropertyListPack = 'auto-color' | 'pairs' | 'one-up';
-/** Props for `<PropertyList>`. */
-interface PropertyListProps extends PropertyMetricProps {
-    children: ReactNode;
-    className?: string;
-    /**
-     * How rows pack into the 2-column grid.
-     *   - `'auto-color'` (default): only color rows pair side-by-side; everything
-     *     else spans the full width. Right for sparse top-level panels.
-     *   - `'pairs'`: every row auto-places into the 2-column grid two-per-row.
-     *     Headers and subpanels still span the full width; wrap any other
-     *     full-width child in `<PropertySpan>`. Right for dense effect bodies.
-     *   - `'one-up'`: every row spans the full width, color rows included. Right
-     *     for a palette — a column of swatches read as a group.
-     */
-    pack?: PropertyListPack;
-}
-/**
- * Grid container for PropertyRows. Use standalone for chrome-less layouts, or
- * nest inside <PropertyPanel/> for the standard glass card.
- */
-declare function PropertyList({ children, className, pack, density, align, }: PropertyListProps): react_jsx_runtime.JSX.Element;
-/** Props for `<PropertySpan>`. */
-interface PropertySpanProps {
-    children: ReactNode;
-    className?: string;
-}
-/**
- * Wrapper that makes an arbitrary child span both columns of a
- * `<PropertyList pack="pairs">`, a `<PropertyGroup pack="pairs">` body, or a
- * `<Subpanel>`. `<PropertyRow span>` covers the row case; this covers
- * everything else a consumer puts in the grid.
- */
-declare function PropertySpan({ children, className }: PropertySpanProps): react_jsx_runtime.JSX.Element;
-/** Which control shape a row holds, which decides its intrinsic layout. */
-type PropertyRowVariant = 'default' | 'color' | 'checkbox';
-/** Whether a row's label sits above its control or beside it. */
-type PropertyRowLayout = 'block' | 'inline';
-/** Props for `<PropertyRow>`. */
-interface PropertyRowProps extends PropertyMetricProps {
-    label: ReactNode;
-    /** Right-aligned readout shown next to the label (e.g. current value). */
-    readout?: ReactNode;
-    /**
-     * Help text for the row, shown in a tooltip off an ⓘ affordance beside the
-     * label. Empty or absent renders no affordance.
-     */
-    description?: string;
-    variant?: PropertyRowVariant;
-    /**
-     * Label position relative to the control. Unset takes the variant's own
-     * orientation: `block` — label above control — for the default variant, and
-     * `inline` for the color and checkbox variants, which read as a row.
-     */
-    layout?: PropertyRowLayout;
-    /**
-     * Take the full width of the enclosing grid. Only has an effect inside a
-     * `<PropertyList pack="pairs">` or a `<Subpanel>`; elsewhere rows are already
-     * full width.
-     */
-    span?: boolean;
-    children: ReactNode;
-    htmlFor?: string;
-    /** The control is a group of several (a segmented toggle), not one element.
-     *  The row then renders as a `<div>`: a `<label>` hands a click on its text to
-     *  its first control, which in a group means selecting the first option. Each
-     *  member has to carry its own name. */
-    group?: boolean;
-    className?: string;
-    /** The row is auto: its value is not pinned and the owner computes it. The
-     *  control is hidden — its box kept, so the row does not resize — and the
-     *  row reads out the word instead. */
-    auto?: boolean;
-    /** Given, the row's label toggles `auto` when it is clicked. Omitted, the row
-     *  can show an auto state but not change it.
-     *
-     *  The label then names that toggle, so a control passed as `children` has to
-     *  carry its own accessible name — every row in this module does. */
-    onAutoChange?: (next: boolean) => void;
-}
-/** The label-plus-control frame every typed row below is built from. Use it
- *  directly for a control this module does not cover. */
-declare function PropertyRow({ label, readout, description, variant, layout, span, children, htmlFor, group, className, density, align, auto, onAutoChange, }: PropertyRowProps): react_jsx_runtime.JSX.Element;
-/** Props for `<SliderRow>`. */
-interface SliderRowProps extends PropertyMetricProps {
-    label: ReactNode;
-    value: number;
-    min: number;
-    max: number;
-    step?: number;
-    /**
-     * The committed value. Given `onInput` as well, it fires once a drag ends
-     * or a typed readout is accepted; on its own it fires on every move, which
-     * is what a row with one callback has always done.
-     */
-    onChange: (next: number) => void;
-    /**
-     * The live value, fired continuously through a drag. Pass it alongside
-     * `onChange` when the write is expensive — cheap state here, the costly
-     * work there. Mirrors `<Slider>`'s `onInput` / `onChange` pair.
-     */
-    onInput?: (next: number) => void;
-    /** Override how the value is rendered next to the label. Defaults to `value.toString()`. */
-    format?: (value: number) => ReactNode;
-    /**
-     * Static text in place of the editable readout. Use it when the row is not
-     * showing a number a caller could type back — an auto row's `auto`, say,
-     * which an editable field would seed a draft with and then fail to parse.
-     */
-    readout?: ReactNode;
-    /** A named display for the value: `compact` reads `2.0M`. `format` wins when both are given. */
-    notation?: ToolPrefNumberFormat;
-    /**
-     * Optional suffix rendered next to the readout. A string becomes a
-     * baseline-aligned dim "word" unit (e.g. "px"); pass JSX like `<sup>°</sup>`
-     * to get the browser's native super positioning for symbol units.
-     */
-    unit?: ReactNode;
-    layout?: PropertyRowLayout;
-    description?: string;
-    /** Take the full width of the enclosing grid — see `<PropertyRow span>`. */
-    span?: boolean;
-    /** The row is auto — see `<PropertyRow auto>`. */
-    auto?: boolean;
-    /** Toggles `auto` from the row's label — see `<PropertyRow onAutoChange>`. */
-    onAutoChange?: (next: boolean) => void;
-}
-/** A bounded number edited by dragging, with a live readout whose precision
- *  follows `step`. */
-declare function SliderRow({ label, value, min, max, step, onChange, onInput, format, readout, notation, unit, layout, description, span, density, align, auto, onAutoChange, }: SliderRowProps): react_jsx_runtime.JSX.Element;
-/** Props for `<ColorRow>`. */
-interface ColorRowProps extends PropertyMetricProps {
-    label: ReactNode;
-    value: string;
-    /**
-     * The committed color. Given `onInput` as well, it fires once the picker
-     * closes; on its own it fires on every move inside it, which is what a row
-     * with one callback has always done.
-     */
-    onChange: (next: string) => void;
-    /**
-     * The live color, fired continuously while the picker is open. Pass it
-     * alongside `onChange` when the write is expensive — cheap state here, the
-     * costly work there. Mirrors `<Slider>`'s `onInput` / `onChange` pair.
-     */
-    onInput?: (next: string) => void;
-    /** 0..1 alpha. When provided, a translucent slider renders beneath the swatch. */
-    alpha?: number;
-    /** The committed alpha, on the same terms as `onChange`. */
-    onAlphaChange?: (next: number) => void;
-    /** The live alpha, on the same terms as `onInput`. */
-    onAlphaInput?: (next: number) => void;
-    /**
-     * Render the alpha track as inert (dimmed, no thumb, not-allowed cursor).
-     * Use when the color's consumer drops alpha so the affordance reads dead.
-     */
-    alphaDisabled?: boolean;
-    /** Label beside the swatch (default) or above it. */
-    layout?: PropertyRowLayout;
-    description?: string;
-    /** Right-aligned readout shown next to the label — see `<PropertyRow readout>`. */
-    readout?: ReactNode;
-    /** Take the full width of the enclosing grid — see `<PropertyRow span>`. */
-    span?: boolean;
-    /** The row is auto — see `<PropertyRow auto>`. */
-    auto?: boolean;
-    /** Toggles `auto` from the row's label — see `<PropertyRow onAutoChange>`. */
-    onAutoChange?: (next: boolean) => void;
-}
-/** A color swatch, optionally with an alpha slider beneath it. */
-declare function ColorRow({ label, readout, value, onChange, onInput, alpha, onAlphaChange, onAlphaInput, alphaDisabled, layout, description, span, density, align, auto, onAutoChange, }: ColorRowProps): react_jsx_runtime.JSX.Element;
-/** Props for `<CheckboxRow>`. */
-interface CheckboxRowProps extends PropertyMetricProps {
-    label: ReactNode;
-    /** Absent reads as unchecked. */
-    value: boolean | undefined;
-    onChange: (next: boolean) => void;
-    /** Label beside the box (default) or above it. */
-    layout?: PropertyRowLayout;
-    description?: string;
-    /** Right-aligned readout shown next to the label — see `<PropertyRow readout>`. */
-    readout?: ReactNode;
-    /** Take the full width of the enclosing grid — see `<PropertyRow span>`. */
-    span?: boolean;
-    /** The row is auto — see `<PropertyRow auto>`. */
-    auto?: boolean;
-    /** Toggles `auto` from the row's label — see `<PropertyRow onAutoChange>`. */
-    onAutoChange?: (next: boolean) => void;
-}
-/** A boolean checkbox. */
-declare function CheckboxRow({ label, readout, value, onChange, layout, span, description, density, align, auto, onAutoChange, }: CheckboxRowProps): react_jsx_runtime.JSX.Element;
-/** Props for `<TextRow>`. */
-interface TextRowProps extends PropertyMetricProps {
-    label: ReactNode;
-    /** Absent reads as an empty field. */
-    value: string | null | undefined;
-    onChange: (next: string) => void;
-    placeholder?: string;
-    maxLength?: number;
-    layout?: PropertyRowLayout;
-    description?: string;
-    /** Right-aligned readout shown next to the label — see `<PropertyRow readout>`. */
-    readout?: ReactNode;
-    /** Take the full width of the enclosing grid — see `<PropertyRow span>`. */
-    span?: boolean;
-    /** The row is auto — see `<PropertyRow auto>`. */
-    auto?: boolean;
-    /** Toggles `auto` from the row's label — see `<PropertyRow onAutoChange>`. */
-    onAutoChange?: (next: boolean) => void;
-}
-/** A single-line text input. */
-declare function TextRow({ label, readout, value, onChange, placeholder, maxLength, layout, description, span, density, align, auto, onAutoChange, }: TextRowProps): react_jsx_runtime.JSX.Element;
-/** Props for `<NumberRow>`. */
-interface NumberRowProps extends PropertyMetricProps {
-    label: ReactNode;
-    /** Absent reads as an empty field. */
-    value: number | null | undefined;
-    /**
-     * The committed value. Given `onInput` as well, it fires on blur or Enter;
-     * on its own it fires on every keystroke, which is what a row with one
-     * callback has always done.
-     */
-    onChange: (next: number) => void;
-    /**
-     * The live value, fired per keystroke. Pass it alongside `onChange` when the
-     * write is expensive — cheap state here, the costly work there. Mirrors
-     * `<Slider>`'s `onInput` / `onChange` pair.
-     */
-    onInput?: (next: number) => void;
-    min?: number;
-    max?: number;
-    step?: number;
-    placeholder?: string;
-    /**
-     * Optional suffix rendered after the field. A string becomes a dim "word"
-     * unit (e.g. "px"); pass JSX like `<sup>°</sup>` for symbol units. Display
-     * only — it never participates in parsing, and the value stays a number.
-     */
-    unit?: ReactNode;
-    layout?: PropertyRowLayout;
-    description?: string;
-    /** Right-aligned readout shown next to the label — see `<PropertyRow readout>`. */
-    readout?: ReactNode;
-    /** Take the full width of the enclosing grid — see `<PropertyRow span>`. */
-    span?: boolean;
-    /** The row is auto — see `<PropertyRow auto>`. */
-    auto?: boolean;
-    /** Toggles `auto` from the row's label — see `<PropertyRow onAutoChange>`. */
-    onAutoChange?: (next: boolean) => void;
-}
-/** A number typed directly. Reach for `<SliderRow>` when the range matters
- *  more than the exact value. */
-declare function NumberRow({ label, readout, value, onChange, onInput, min, max, step, placeholder, unit, layout, description, span, density, align, auto, onAutoChange, }: NumberRowProps): react_jsx_runtime.JSX.Element;
-interface PropertyOption<T extends string> {
-    value: T;
-    label: ReactNode;
-}
-/** Props for `<SelectRow>`. */
-interface SelectRowProps<T extends string> extends PropertyMetricProps {
-    label: ReactNode;
-    /** Absent, or not one of `options`, shows a placeholder rather than the first option. */
-    value: T | undefined;
-    options: ReadonlyArray<PropertyOption<T>>;
-    onChange: (next: T) => void;
-    /** Shown while no option is chosen. Defaults to "Choose option…". */
-    placeholder?: string;
-    layout?: PropertyRowLayout;
-    description?: string;
-    /** Right-aligned readout shown next to the label — see `<PropertyRow readout>`. */
-    readout?: ReactNode;
-    /** Take the full width of the enclosing grid — see `<PropertyRow span>`. */
-    span?: boolean;
-    /** The row is auto — see `<PropertyRow auto>`. */
-    auto?: boolean;
-    /** Toggles `auto` from the row's label — see `<PropertyRow onAutoChange>`. */
-    onAutoChange?: (next: boolean) => void;
-}
-/** A dropdown over a fixed set of choices. Prefer `<ToggleRow>` when there
- *  are only two or three and they should all stay visible. */
-declare function SelectRow<T extends string>({ label, readout, value, options, onChange, placeholder, layout, description, span, density, align, auto, onAutoChange, }: SelectRowProps<T>): react_jsx_runtime.JSX.Element;
-/** Props for `<ToggleRow>`. */
-interface ToggleRowProps<T extends string> extends PropertyMetricProps {
-    label: ReactNode;
-    value: T;
-    options: ReadonlyArray<PropertyOption<T>>;
-    onChange: (next: T) => void;
-    layout?: PropertyRowLayout;
-    description?: string;
-    /** Right-aligned readout shown next to the label — see `<PropertyRow readout>`. */
-    readout?: ReactNode;
-    /** Take the full width of the enclosing grid — see `<PropertyRow span>`. */
-    span?: boolean;
-    /** The row is auto — see `<PropertyRow auto>`. */
-    auto?: boolean;
-    /** Toggles `auto` from the row's label — see `<PropertyRow onAutoChange>`. */
-    onAutoChange?: (next: boolean) => void;
-}
-/** A segmented control: the same choice as a select, with every option
- *  visible at once. */
-declare function ToggleRow<T extends string>({ label, readout, value, options, onChange, layout, description, span, density, align, auto, onAutoChange, }: ToggleRowProps<T>): react_jsx_runtime.JSX.Element;
-
-/** How a panel packs its rows into the two-column property grid.
- *   - `'auto'`: narrow controls (numbers, checkboxes, dropdowns, colors) sit
- *     two per row; the ones that need the width — text, sliders, segmented
- *     toggles — span it.
- *   - `'pairs'`: every row pairs. A control that needs the full width says so
- *     itself, with `<PropertyRow span>`.
- *   - `'one-up'`: one control per row, colors excepted.
- */
-type ControlPack = 'auto' | 'pairs' | 'one-up';
-interface ControlPanelProps<TC extends Record<string, unknown>> {
-    /** The instrument's resolved config schema. */
-    schema?: ResolvedConfig;
-    /** @deprecated Pass `schema`. A field list is adapted into one internally. */
-    fields?: ConfigField[];
-    config: TC;
-    /** Writes one value. The path is dotted for a leaf inside an `f.group`, and
-     *  the bare key for one at the root. */
-    setConfig: (path: string, value: unknown) => void;
-    /**
-     * Control overrides and app-defined kinds, PrefsForm-style. Keys are config
-     * paths (checked first) or leaf kinds. A renderer returning `null` collapses
-     * the row; entries override the built-in rows on collision.
-     */
-    renderers?: Record<string, ControlRenderer>;
-    /** How rows pack into the two-column grid. Defaults to `'pairs'`. */
-    pack?: ControlPack;
-    /**
-     * Where a row's label sits relative to its control. Unset takes each row's
-     * own orientation — `block` (label above, which is what leaves a paired row
-     * room for its value) for most, `inline` for colors and checkboxes.
-     */
-    layout?: PropertyRowLayout;
-    /** Room the rows get. Passed straight to the property list. */
-    density?: PropertyDensity;
-    /** Cross-axis alignment of an inline row's label and control. */
-    align?: PropertyAlign;
-    /**
-     * Fold each section away behind a twisty, starting `'open'` or `'closed'`.
-     * Unset draws the heading alone, as the panel always has — unless a section
-     * in the schema declares how it opens, which makes that section foldable on
-     * its own and outranks this for that one section.
-     */
-    collapse?: 'open' | 'closed';
-    /**
-     * Which sections are folded, keyed as `onCollapse` reports them. Given, the
-     * panel keeps no state of its own: every toggle arrives at `onCollapse`
-     * instead, which is where a lab that remembers a trial's sections writes
-     * them.
-     */
-    collapsed?: Readonly<Record<string, boolean>>;
-    /** A fold moved. The key is a section's label — prefixed by its group's
-     *  dotted path when the section sits inside one — or a group's own path. */
-    onCollapse?: (key: string, collapsed: boolean) => void;
-    /** Dotted paths currently unpinned. A row in this set hides its control and
-     *  reads out `auto`, and clicking its label writes the sentinel back through
-     *  `setConfig`. Omitted, the panel keeps the set itself: the labels still
-     *  toggle and the sentinel never reaches `setConfig`, which would otherwise
-     *  store it as the row's value. */
-    auto?: ReadonlySet<string>;
-    /** Draw leaves marked `hidden`. */
-    showHidden?: boolean;
-    className?: string;
-}
-/** Render an instrument's config schema as a stack of controls, each writing
- *  back through `setConfig`. Built on the property rows, so a lab's controls
- *  are the same aligned, themed rows the rest of the kit uses. */
-declare function ControlPanel<TC extends Record<string, unknown>>({ schema, fields, config, setConfig, renderers, pack, layout, density, align, collapse, collapsed, onCollapse, auto: given, showHidden, className, }: ControlPanelProps<TC>): react_jsx_runtime.JSX.Element;
-
-export { CheckboxRow as C, NumberRow as N, SelectRow as S, TextRow as T, ColorRow as c, ControlPanel as e, PropertyList as g, PropertyPanel as j, PropertyRow as l, PropertySpan as p, SliderRow as s, ToggleRow as v };
-export type { PropertyMetricProps as P, PropertyListPack as a, CheckboxRowProps as b, ColorRowProps as d, NumberRowProps as f, PropertyListProps as h, PropertyOption as i, PropertyPanelProps as k, PropertyRowLayout as m, PropertyRowProps as n, PropertyRowVariant as o, PropertySpanProps as q, SelectRowProps as r, SliderRowProps as t, TextRowProps as u, ToggleRowProps as w };

package/dist/chunk-6BUQ77ZV.js

@@ -1,18 +0,0 @@
-import { LabContext } from './chunk-Z76KEZAX.js';
-import { resolveConfigSchema } from './chunk-A2ACAGW6.js';
-import { fromConfigFields } from './chunk-EMXAIRUJ.js';
-import { useContext, useMemo } from 'react';
-
-var NO_RULES = [];
-function useConfigSchema(instrument) {
-  const lab = useContext(LabContext);
-  const rules = lab?.configRules ?? NO_RULES;
-  return useMemo(
-    () => instrument.config ? resolveConfigSchema(instrument.config, rules) : fromConfigFields(instrument.configSchema?.() ?? []),
-    [instrument, rules]
-  );
-}
-
-export { useConfigSchema };
-//# sourceMappingURL=chunk-6BUQ77ZV.js.map
-//# sourceMappingURL=chunk-6BUQ77ZV.js.map

package/dist/chunk-6BUQ77ZV.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/config/useConfigSchema.ts"],"names":[],"mappings":";;;;;AAOA,IAAM,WAAwB,EAAC;AASxB,SAAS,gBAEd,UAAA,EACgB;AAChB,EAAA,MAAM,GAAA,GAAM,WAAW,UAAU,CAAA;AACjC,EAAA,MAAM,KAAA,GAAQ,KAAK,WAAA,IAAe,QAAA;AAClC,EAAA,OAAO,OAAA;AAAA,IACL,MACE,UAAA,CAAW,MAAA,GACP,mBAAA,CAAoB,UAAA,CAAW,MAAA,EAAQ,KAAK,CAAA,GAC5C,gBAAA,CAAiB,UAAA,CAAW,YAAA,IAAe,IAAK,EAAE,CAAA;AAAA,IACxD,CAAC,YAAY,KAAK;AAAA,GACpB;AACF","file":"chunk-6BUQ77ZV.js","sourcesContent":["import { useContext, useMemo } from 'react';\nimport type { Instrument } from '../instrument/types';\nimport { LabContext } from '../lab/LabContext';\nimport { fromConfigFields } from './fromConfigField';\nimport { resolveConfigSchema } from './resolve';\nimport type { ResolvedConfig } from './types';\n\nconst NO_RULES: readonly [] = [];\n\n/**\n * An instrument's controls, resolved against the surrounding lab's rules.\n *\n * Resolution cannot happen in `defineInstrument` — rules are lab-scoped and\n * that runs at module load — so it happens here, at render. Both instrument\n * paths land in the same shape, so callers never branch on which was used.\n */\nexport function useConfigSchema(\n  // biome-ignore lint/suspicious/noExplicitAny: instruments are stored contravariantly; see InstrumentList\n  instrument: Instrument<any, any, any>, // eslint-disable-line @typescript-eslint/no-explicit-any\n): ResolvedConfig {\n  const lab = useContext(LabContext);\n  const rules = lab?.configRules ?? NO_RULES;\n  return useMemo(\n    () =>\n      instrument.config\n        ? resolveConfigSchema(instrument.config, rules)\n        : fromConfigFields(instrument.configSchema?.() ?? []),\n    [instrument, rules],\n  );\n}\n"]}

package/dist/chunk-753Y6HE6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/primitives/useRovingTabIndex.ts","../src/primitives/Toolbar.tsx","../src/primitives/fpsAverage.ts","../src/primitives/FpsMeter.tsx","../src/primitives/ScaleIndicator.tsx","../src/primitives/ZoomControl.tsx","../src/primitives/StatusBar.tsx"],"names":["useRef","useEffect","jsx","jsxs","b"],"mappings":"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","file":"chunk-753Y6HE6.js","sourcesContent":["import { type KeyboardEvent, useCallback, useEffect, useRef } from 'react';\n\n/** Which axis a toolbar's arrow keys walk. Matches `aria-orientation`. */\nexport type RovingOrientation = 'horizontal' | 'vertical';\n\n/** Where a key takes focus within `count` items, or null if it does not move it.\n *\n *  Only the arrows on the toolbar's own axis move focus — APG leaves the\n *  cross-axis arrows to the page, so a vertical strip does not swallow\n *  ArrowLeft. `Home` / `End` work on both. */\nexport function nextIndex(\n  current: number,\n  key: string,\n  count: number,\n  orientation: RovingOrientation = 'horizontal',\n): number | null {\n  if (count === 0) return null;\n  const forward = orientation === 'vertical' ? 'ArrowDown' : 'ArrowRight';\n  const back = orientation === 'vertical' ? 'ArrowUp' : 'ArrowLeft';\n  if (key === forward) return (current + 1) % count;\n  if (key === back) return (current - 1 + count) % count;\n  if (key === 'Home') return 0;\n  if (key === 'End') return count - 1;\n  return null;\n}\n\n/**\n * The APG roving-tabindex contract: exactly one item in the tab order, arrows\n * moving focus within. `tabIndex` is written onto the DOM nodes rather than\n * threaded through props, because the items are arbitrary children — the\n * container never sees them as a list it could index.\n */\nexport function useRovingTabIndex<T extends HTMLElement>(\n  orientation: RovingOrientation = 'horizontal',\n) {\n  const ref = useRef<T | null>(null);\n  const stop = useRef(0);\n\n  const items = useCallback(\n    (): HTMLElement[] =>\n      ref.current\n        ? Array.from(\n            ref.current.querySelectorAll<HTMLElement>('button:not([disabled]), [role=\"button\"]'),\n          )\n        : [],\n    [],\n  );\n\n  const setTabStop = useCallback(\n    (index: number) => {\n      const found = items();\n      const at = Math.min(Math.max(index, 0), Math.max(found.length - 1, 0));\n      stop.current = at;\n      for (const [i, el] of found.entries()) el.tabIndex = i === at ? 0 : -1;\n    },\n    [items],\n  );\n\n  // Re-establish the tab stop whenever the item set changes — a trial's toolbar\n  // contributions are dynamic, and `disabled` moves a button in and out of the\n  // set without touching the child list. The focused item keeps the stop.\n  useEffect(() => {\n    const resync = () => {\n      const focused = items().indexOf(document.activeElement as HTMLElement);\n      setTabStop(focused === -1 ? stop.current : focused);\n    };\n    resync();\n    if (!ref.current) return;\n    const mo = new MutationObserver(resync);\n    mo.observe(ref.current, { childList: true, subtree: true, attributeFilter: ['disabled'] });\n    return () => mo.disconnect();\n  }, [items, setTabStop]);\n\n  const onKeyDown = useCallback(\n    (e: KeyboardEvent<T>) => {\n      const found = items();\n      const current = found.indexOf(document.activeElement as HTMLElement);\n      const next = nextIndex(current === -1 ? 0 : current, e.key, found.length, orientation);\n      if (next === null) return;\n      e.preventDefault();\n      found[next]?.focus();\n      setTabStop(next);\n    },\n    [items, setTabStop, orientation],\n  );\n\n  return { ref, onKeyDown };\n}\n","import type { MouseEventHandler, ReactNode } from 'react';\nimport { useRovingTabIndex } from './useRovingTabIndex';\n\n/** Props for `<Toolbar>`. */\nexport interface ToolbarProps {\n  children: ReactNode;\n  /** Names the toolbar for assistive tech. Required by the APG pattern when a\n   *  view holds more than one. */\n  'aria-label'?: string;\n}\n\n/** A horizontal bar of controls. Fill it with `<Toolbar.Title>`,\n *  `<Toolbar.Group>`, `<Toolbar.Button>` and `<Toolbar.Spacer>`. */\nexport function Toolbar({ children, 'aria-label': ariaLabel }: ToolbarProps) {\n  const { ref, onKeyDown } = useRovingTabIndex<HTMLDivElement>();\n  return (\n    <div\n      ref={ref}\n      className=\"lk-toolbar\"\n      role=\"toolbar\"\n      aria-label={ariaLabel}\n      onKeyDown={onKeyDown}\n    >\n      {children}\n    </div>\n  );\n}\n\ninterface TitleProps {\n  children: ReactNode;\n}\nfunction Title({ children }: TitleProps) {\n  return <span className=\"lk-toolbar-title\">{children}</span>;\n}\n\n/** Props for `<Toolbar.Group>`. */\nexport interface ToolbarGroupProps {\n  children: ReactNode;\n  /** Pushes this group, and everything after it, to the far end. */\n  end?: boolean;\n  'aria-label'?: string;\n}\n\n/** Related controls, kept tight and ruled off from their neighbors. Group\n *  rather than separate with repeated `<Toolbar.Spacer>`: consecutive spacers\n *  share the free space, so every gap collapses to the same slack and the bar\n *  reads as one undifferentiated run. */\nfunction Group({ children, end, 'aria-label': ariaLabel }: ToolbarGroupProps) {\n  return (\n    // biome-ignore lint/a11y/useSemanticElements: a group inside role=\"toolbar\" is the APG pattern; the rule is local and cannot see the parent. <fieldset> means form controls, needs a <legend> to be named, and its UA min-width breaks flex children.\n    <div\n      className={`lk-toolbar-group${end ? ' lk-toolbar-group--end' : ''}`}\n      role=\"group\"\n      aria-label={ariaLabel}\n    >\n      {children}\n    </div>\n  );\n}\n\n/** Props for `<Toolbar.Button>`. */\nexport interface ToolbarButtonProps {\n  children: ReactNode;\n  onClick: MouseEventHandler<HTMLButtonElement>;\n  disabled?: boolean;\n  title?: string;\n  /** Required when `children` is an icon with no text of its own. */\n  'aria-label'?: string;\n  /** `danger` reddens on hover — for actions that discard work. */\n  variant?: 'default' | 'danger';\n  /** Square, for a button whose whole content is one glyph. */\n  iconOnly?: boolean;\n  /** Makes this a toggle: `aria-pressed`, and held down while true. */\n  pressed?: boolean;\n}\n\nfunction Button({\n  children,\n  onClick,\n  disabled,\n  title,\n  'aria-label': ariaLabel,\n  variant = 'default',\n  iconOnly,\n  pressed,\n}: ToolbarButtonProps) {\n  const cls = [\n    'lk-toolbar-button',\n    variant === 'danger' && 'lk-toolbar-button--danger',\n    iconOnly && 'lk-toolbar-button--icon',\n    pressed && 'lk-toolbar-button--pressed',\n  ]\n    .filter(Boolean)\n    .join(' ');\n  return (\n    <button\n      type=\"button\"\n      className={cls}\n      onClick={onClick}\n      disabled={disabled}\n      title={title}\n      aria-label={ariaLabel ?? title}\n      aria-pressed={pressed}\n    >\n      {children}\n    </button>\n  );\n}\n\nfunction Spacer() {\n  return <span className=\"lk-toolbar-spacer\" aria-hidden=\"true\" />;\n}\n\n/** A label within a toolbar. */\nToolbar.Title = Title;\n/** A ruled-off run of related controls. */\nToolbar.Group = Group;\n/** A button within a toolbar. */\nToolbar.Button = Button;\n/** Flexible space that pushes what follows to the far end of the toolbar. */\nToolbar.Spacer = Spacer;\n","export function rollingAverage(samples: readonly number[]): number {\n  if (samples.length === 0) return 0;\n  const sum = samples.reduce((acc, n) => acc + n, 0);\n  return Math.round(sum / samples.length);\n}\n","import { useVisibleRaf } from '@weasel-js/core';\nimport { useEffect, useRef, useState } from 'react';\nimport { rollingAverage } from './fpsAverage';\n\nconst SAMPLE_WINDOW = 30;\n\n/** A live frame-rate readout, averaged over the last 30 frames. */\nexport function FpsMeter() {\n  const [fps, setFps] = useState(0);\n  const samplesRef = useRef<number[]>([]);\n  const lastTimeRef = useRef<number | null>(null);\n  const rootRef = useRef<HTMLDivElement | null>(null);\n\n  const loop = useVisibleRaf(\n    (time) => {\n      const last = lastTimeRef.current;\n      if (last !== null) {\n        const delta = time - last;\n        if (delta > 0) {\n          const samples = samplesRef.current;\n          samples.push(1000 / delta);\n          if (samples.length > SAMPLE_WINDOW) samples.shift();\n          setFps(rollingAverage(samples));\n        }\n      }\n      lastTimeRef.current = time;\n      loop.request();\n    },\n    {\n      target: rootRef,\n      // The gap spent suspended is not a frame that took an hour to draw.\n      onResume: () => {\n        lastTimeRef.current = null;\n      },\n    },\n  );\n\n  useEffect(() => {\n    loop.request();\n    return () => loop.cancel();\n  }, [loop]);\n\n  return (\n    <div className=\"lk-fps-meter\" ref={rootRef}>\n      <span className=\"lk-fps-meter-label\">FPS</span>\n      {/* The number is its own cell because it is the only part that changes:\n          in one box with the label, every digit it gains or loses resizes the\n          readout, and the status bar it sits in wraps to a second line and\n          back — which in a small trial resizes the window. */}\n      <span className=\"lk-fps-meter-value\">{fps}</span>\n    </div>\n  );\n}\n","import { useContext } from 'react';\nimport { CanvasStackContext } from '../canvas/CanvasStackContext';\n\n/** Props for `<ScaleIndicator>`. */\nexport interface ScaleIndicatorProps {\n  /** Current view zoom factor. If omitted, reads from CanvasStackContext. Defaults to 1. */\n  zoom?: number;\n  /** World pixels per unit at zoom=1. Default: 1. */\n  pixelsPerUnit?: number;\n  /** Unit label. Default: 'px'. */\n  unit?: string;\n  /** Target bar width in display pixels. Default: 100. */\n  targetWidth?: number;\n}\n\n// Rounds n to a \"nice\" number — 1, 2, 5, 10, 20, 50, ...\nfunction niceNumber(n: number): number {\n  if (n <= 0) return 1;\n  const exp = Math.floor(Math.log10(n));\n  const fraction = n / 10 ** exp;\n  let nice: number;\n  if (fraction < 1.5) nice = 1;\n  else if (fraction < 3.5) nice = 2;\n  else if (fraction < 7.5) nice = 5;\n  else nice = 10;\n  return nice * 10 ** exp;\n}\n\n/** A scale bar: a labeled rule showing how far a round number of world units\n *  is at the current zoom. Reads the zoom from the surrounding canvas stack\n *  unless one is passed. */\nexport function ScaleIndicator({\n  zoom,\n  pixelsPerUnit = 1,\n  unit = 'px',\n  targetWidth = 100,\n}: ScaleIndicatorProps) {\n  const ctxValue = useContext(CanvasStackContext);\n  const effectiveZoom = zoom ?? ctxValue?.view.zoom ?? 1;\n  const effectivePxPerUnit = pixelsPerUnit * effectiveZoom;\n  const targetUnits = targetWidth / effectivePxPerUnit;\n  const niceUnits = niceNumber(targetUnits);\n  const barWidth = niceUnits * effectivePxPerUnit;\n  return (\n    <div className=\"lk-scale-indicator\" role=\"img\" aria-label={`Scale: ${niceUnits} ${unit}`}>\n      <div className=\"lk-scale-indicator-bar\" style={{ width: `${barWidth}px` }} />\n      <span className=\"lk-scale-indicator-label\">\n        {niceUnits} {unit}\n      </span>\n    </div>\n  );\n}\n","import { normalizeZoom } from '@weasel-js/core';\nimport { NumberField, Slider } from '../passthrough/weasel-ui';\n\n/** Props for `<ZoomControl>`. */\nexport interface ZoomControlProps {\n  /** Current zoom as a scale factor: 1 is actual size. */\n  zoom: number;\n  /** Fired continuously while the slider drags. */\n  onZoomChange: (zoom: number) => void;\n  /** Fired when a drag settles or the field is committed. Defaults to\n   *  `onZoomChange`. */\n  onZoomCommit?: (zoom: number) => void;\n  /** Smallest selectable zoom. Defaults to 0.1 (10%). */\n  min?: number;\n  /** Largest selectable zoom. Defaults to 8 (800%). */\n  max?: number;\n  className?: string;\n}\n\n// Zoom is perceptually geometric — halving is as big a step as doubling — so\n// the slider runs on log2 and 100% lands mid-track for a symmetric range.\nconst toTrack = (zoom: number): number => Math.log2(zoom);\nconst fromTrack = (v: number): number => 2 ** v;\n\nconst clamp = (v: number, lo: number, hi: number): number => Math.max(lo, Math.min(hi, v));\n\n/** Zoom as a log-scaled slider with an editable percentage beside it. Pair it\n *  with zoom-in / zoom-out buttons in a `<Toolbar.Group>`; this component owns\n *  only the continuous part. */\nexport function ZoomControl({\n  zoom,\n  onZoomChange,\n  onZoomCommit,\n  min: minProp = 0.1,\n  max: maxProp = 8,\n  className,\n}: ZoomControlProps) {\n  const min = normalizeZoom(minProp);\n  const max = normalizeZoom(maxProp);\n  const commit = onZoomCommit ?? onZoomChange;\n  const emit = (track: number, done: boolean): void => {\n    const next = clamp(fromTrack(track), min, max);\n    (done ? commit : onZoomChange)(next);\n  };\n\n  return (\n    <div className={`lk-zoom${className ? ` ${className}` : ''}`}>\n      <Slider\n        className=\"lk-zoom__slider\"\n        ariaLabel=\"Zoom\"\n        density=\"slim\"\n        min={toTrack(min)}\n        max={toTrack(max)}\n        // Detents at the octaves plus actual size, so 25/50/100/200/400% are\n        // reachable by drag rather than only by typing.\n        stops={[-2, -1, 0, 1, 2]}\n        thumbs={[{ value: clamp(toTrack(zoom), toTrack(min), toTrack(max)) }]}\n        onInput={(next) => emit(next[0].value, false)}\n        onChange={(next) => emit(next[0].value, true)}\n        readoutPlacement=\"none\"\n      />\n      {/* `style: 'percent'` formats a fraction, so the field carries the scale\n          factor itself and renders 0.5 as \"50%\". */}\n      <NumberField\n        className=\"lk-zoom__field\"\n        width=\"fit\"\n        aria-label=\"Zoom\"\n        value={zoom}\n        minValue={min}\n        maxValue={max}\n        step={0.01}\n        hideSteppers\n        ghost\n        formatOptions={{ style: 'percent', maximumFractionDigits: 0 }}\n        onChange={(next) => {\n          if (!Number.isFinite(next)) return;\n          commit(clamp(next, min, max));\n        }}\n      />\n    </div>\n  );\n}\n","import type { ReactNode } from 'react';\n\n/** Props for `<StatusBar>`. */\nexport interface StatusBarProps {\n  children: ReactNode;\n}\n\n/** A footer strip for readouts. Fill it with `<StatusBar.Section>`. */\nexport function StatusBar({ children }: StatusBarProps) {\n  return <div className=\"lk-status-bar\">{children}</div>;\n}\n\n/** Props for `<StatusBar.Section>`. */\nexport interface StatusBarSectionProps {\n  children: ReactNode;\n  /** Pushes this section, and everything after it, to the far end. */\n  end?: boolean;\n}\nfunction Section({ children, end }: StatusBarSectionProps) {\n  return (\n    <span className={`lk-status-bar-section${end ? ' lk-status-bar-section--end' : ''}`}>\n      {children}\n    </span>\n  );\n}\n\n/** One readout within a status bar. */\nStatusBar.Section = Section;\n"]}

package/dist/chunk-A2ACAGW6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/config/builder.ts","../src/config/rules.ts","../src/config/resolve.ts","../src/config/useResolvedConfig.ts"],"names":[],"mappings":"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","file":"chunk-A2ACAGW6.js","sourcesContent":["import type { PrefLeaf, PrefNumberFormat, PrefNumberUnit } from '@weasel-js/ui';\nimport { type Auto, isAuto } from './auto';\nimport type {\n  Annotations,\n  BranchAnnotations,\n  BranchOptions,\n  ConfigBranch,\n  ConfigEntry,\n  ConfigNode,\n  ConfigOption,\n  ConfigSchema,\n  ConfigShape,\n  ControlRenderer,\n  InferConfig,\n  NodeOptions,\n  SectionOption,\n} from './types';\n\n/** Whether a schema entry is a branch rather than a leaf. */\nexport function isConfigBranch(entry: ConfigEntry): entry is ConfigBranch {\n  return 'children' in entry;\n}\n\n/** Shared chaining surface. Every method clones, so a node can be reused as a\n *  base for several leaves without one bleeding into the next. */\nexport abstract class BaseNode<T> implements ConfigNode<T> {\n  abstract readonly kind: string | null;\n\n  // `default` is a reserved word in a parameter position, so the field is\n  // declared rather than taken as a parameter property.\n  readonly default: T;\n\n  constructor(\n    defaultValue: T,\n    readonly annotations: Readonly<Annotations> = {},\n    readonly options: Readonly<NodeOptions> = {},\n  ) {\n    this.default = defaultValue;\n  }\n\n  /** Clone into the same subclass. Subclasses with extra constructor\n   *  arguments override this. */\n  protected with(annotations: Annotations, options: NodeOptions): this {\n    const Ctor = this.constructor as new (d: T, a: Annotations, o: NodeOptions) => this;\n    return new Ctor(this.default, annotations, options);\n  }\n\n  protected ann(patch: Annotations): this {\n    return this.with({ ...this.annotations, ...patch }, this.options);\n  }\n\n  protected opt(patch: NodeOptions): this {\n    return this.with(this.annotations, { ...this.options, ...patch });\n  }\n\n  /** Human-readable label. Defaults to the key, title-cased. */\n  label(name: string): this {\n    return this.ann({ name });\n  }\n\n  /** Longer help text, surfaced as a tooltip on the row label. */\n  describe(description: string): this {\n    return this.ann({ description });\n  }\n\n  /** Omit from the panel unless it is asked to show hidden leaves. */\n  hidden(): this {\n    return this.ann({ hidden: true });\n  }\n\n  /** Pair with a sibling sharing this id, side-by-side on one row. */\n  pair(pair: string): this {\n    return this.ann({ pair });\n  }\n\n  /** Render under a named section heading. `collapsed` opens the section\n   *  folded, and `layout` and `pack` lay out its rows — say each on any one of\n   *  the section's leaves. */\n  section(label: string, opts: Omit<SectionOption, 'label'> = {}): this {\n    return this.opt({ section: { label, ...opts } });\n  }\n\n  /** Show this row only while the predicate holds. Presentational — the value\n   *  stays in config and the instrument still reads it. */\n  showIf(predicate: (config: Record<string, unknown>) => boolean): this {\n    return this.opt({ showIf: predicate });\n  }\n\n  /** Draw this one row yourself, keeping the kind, default and validation. */\n  render(renderer: ControlRenderer): this {\n    return this.opt({ render: renderer });\n  }\n\n  /**\n   * Compute this leaf's value while it is auto, instead of leaving it\n   * `undefined`. The resolver is given the config with every other auto path\n   * already resolved.\n   */\n  auto(resolve: (config: Record<string, unknown>) => T): this {\n    return this.opt({ autoResolve: resolve as (c: Record<string, unknown>) => unknown });\n  }\n\n  /**\n   * Start this leaf auto rather than pinned at its default. Takes `auto` and\n   * nothing else — the constructor argument already declares the value, and a\n   * second way to say it would fight with the first.\n   */\n  initial(value: Auto): this {\n    if (!isAuto(value)) throw new Error('[labkit] .initial() takes `auto` and nothing else');\n    return this.opt({ unpinned: true });\n  }\n\n  /** Never auto. The row's label does not toggle. */\n  manual(): this {\n    return this.opt({ manual: true });\n  }\n}\n\nexport class NumberNode extends BaseNode<number> {\n  readonly kind = 'number';\n\n  /** Bound the value. A number with both bounds renders as a slider. */\n  range(min: number, max: number): this {\n    return this.ann({ min, max });\n  }\n\n  step(step: number): this {\n    return this.ann({ step });\n  }\n\n  /** A display suffix for the value — `'px'`, `'ms'`, `'°'`. Presentation only:\n   *  it is never parsed, and the stored value stays a plain number. */\n  suffix(suffix: string): this {\n    return this.ann({ suffix });\n  }\n\n  /** Show the value in a named format — `'compact'` reads `2.0M`. Presentation\n   *  only: the stored value stays a plain number, and a typed `2.5m` reads back. */\n  format(format: PrefNumberFormat): this {\n    return this.ann({ format });\n  }\n\n  /**\n   * Store the value in one unit and edit it in another — radians stored,\n   * degrees typed. `min`, `max` and `step` are declared in the stored unit\n   * alongside the value, and convert with it. `prefUnit` builds one from a\n   * `UnitSystem`.\n   */\n  unit(unit: PrefNumberUnit): this {\n    return this.ann({ unit });\n  }\n\n  /** Force a slider even without both bounds. */\n  slider(): this {\n    return this.ann({ control: 'slider' });\n  }\n\n  /** Force a typed input even when both bounds are set. */\n  input(): this {\n    return this.ann({ control: 'input' });\n  }\n}\n\nexport class BooleanNode extends BaseNode<boolean> {\n  readonly kind = 'boolean';\n\n  /** Ask for a switch rather than a checkbox. */\n  toggle(): this {\n    return this.ann({ control: 'switch' });\n  }\n}\n\nexport class StringNode extends BaseNode<string> {\n  readonly kind = 'string';\n\n  placeholder(placeholder: string): this {\n    return this.ann({ placeholder });\n  }\n\n  maxLength(maxLength: number): this {\n    return this.ann({ maxLength });\n  }\n\n  /** Milliseconds to debounce live writes. 0 commits every keystroke. */\n  debounce(debounceMs: number): this {\n    return this.ann({ debounceMs });\n  }\n}\n\nexport class ColorNode extends BaseNode<string> {\n  readonly kind = 'color';\n\n  /** The value carries alpha as `#rrggbbaa`, and the row gets an opacity\n   *  track beside the swatch. */\n  alpha(): this {\n    return this.ann({ alpha: true });\n  }\n}\n\nexport class EnumNode<T extends string> extends BaseNode<T> {\n  readonly kind = 'enum';\n\n  /** Render as a segmented control rather than a select. */\n  radio(): this {\n    return this.ann({ control: 'radio' });\n  }\n\n  /** Relabel the choices. Named `labels` rather than `options` because\n   *  `options` is the node's own extras bag. */\n  labels(options: readonly ConfigOption[]): this {\n    return this.ann({ options });\n  }\n}\n\n/** A leaf whose kind the rule chain decides. */\nexport class ValueNode<T> extends BaseNode<T> {\n  readonly kind = null;\n}\n\n/** A leaf of a kind labkit does not ship a row for. */\nexport class CustomNode<T> extends BaseNode<T> {\n  constructor(\n    readonly kind: string,\n    defaultValue: T,\n    annotations: Readonly<Annotations> = {},\n    options: Readonly<NodeOptions> = {},\n  ) {\n    super(defaultValue, annotations, options);\n  }\n\n  protected override with(annotations: Annotations, options: NodeOptions): this {\n    return new CustomNode(this.kind, this.default, annotations, options) as this;\n  }\n}\n\n/**\n * A branch of the schema: its children nest under its key, so a leaf inside\n * one is read and written at a dotted path. Distinct from `.section()`, which\n * puts a heading over sibling leaves and leaves their paths alone.\n */\nexport class GroupNode<S extends ConfigShape> implements ConfigBranch<S> {\n  constructor(\n    readonly children: S,\n    readonly annotations: Readonly<BranchAnnotations> = {},\n    readonly options: Readonly<BranchOptions> = {},\n  ) {}\n\n  private with(annotations: BranchAnnotations, options: BranchOptions): GroupNode<S> {\n    return new GroupNode(this.children, annotations, options);\n  }\n\n  /** Heading for the group's rows. Defaults to the key, title-cased. */\n  label(name: string): GroupNode<S> {\n    return this.with({ ...this.annotations, name }, this.options);\n  }\n\n  /** Longer help text. Carried on the resolved `PrefGroup`; both weasel-ui's\n   *  `PrefsForm` and `ControlPanel` draw it under the heading. */\n  describe(description: string): GroupNode<S> {\n    return this.with({ ...this.annotations, description }, this.options);\n  }\n\n  /** Render this whole group under a named section heading. */\n  section(label: string, opts: Omit<SectionOption, 'label'> = {}): GroupNode<S> {\n    return this.with(this.annotations, { ...this.options, section: { label, ...opts } });\n  }\n\n  /** Show this group only while the predicate holds. Presentational — every\n   *  value beneath it stays in config and the instrument still reads it. */\n  showIf(predicate: (config: Record<string, unknown>) => boolean): GroupNode<S> {\n    return this.with(this.annotations, { ...this.options, showIf: predicate });\n  }\n}\n\n/** Every default in a shape, nested the way the shape is. */\nfunction shapeDefaults(shape: ConfigShape): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [key, entry] of Object.entries(shape)) {\n    out[key] = isConfigBranch(entry) ? shapeDefaults(entry.children) : entry.default;\n  }\n  return out;\n}\n\nconst expand = <T extends string>(\n  options: readonly T[] | readonly ConfigOption[],\n): readonly ConfigOption[] =>\n  options.map((o) => (typeof o === 'string' ? { value: o, label: o } : o));\n\n/**\n * Builds an instrument's config: the values, their types, and how each is\n * edited, in one declaration.\n *\n * ```ts\n * const config = f.schema({\n *   showGrid: f.boolean(true),\n *   cellSize: f.number(20).range(5, 80).step(5).label('Grid spacing'),\n *   // Nested: read and written at `grid.color`.\n *   grid: f.group({ color: f.color('#ffffff') }),\n * })\n * ```\n */\nexport const f = {\n  number: (def: number): NumberNode => new NumberNode(def),\n  boolean: (def: boolean): BooleanNode => new BooleanNode(def),\n  string: (def: string): StringNode => new StringNode(def),\n  color: (def: string): ColorNode => new ColorNode(def),\n\n  /** A fixed set of choices. The default's literal type flows into the config\n   *  type, so `f.enum('fast', ['fast', 'accurate'])` gives\n   *  `'fast' | 'accurate'` with no `as const`. */\n  enum: <const T extends string>(\n    def: T,\n    options: readonly T[] | readonly ConfigOption[],\n  ): EnumNode<T> => new EnumNode<T>(def, { options: expand(options) }),\n\n  /** A leaf with no declared kind: the rule chain decides, which is how a lab\n   *  states a convention like \"every `*Color` key is a color picker\". */\n  value: <T>(def: T): ValueNode<T> => new ValueNode(def),\n\n  /** A branch: its children nest under this key, so `grid: f.group({ size })`\n   *  puts the value at `config.grid.size` and addresses it as `'grid.size'`.\n   *  Groups nest as deeply as the schema wants. */\n  group: <const S extends ConfigShape>(children: S): GroupNode<S> => new GroupNode(children),\n\n  /** A leaf of a kind a lab supplies the control for, through `controls`. */\n  custom: <T>(\n    kind: string,\n    def: T,\n    validate?: (leaf: PrefLeaf, config: Record<string, unknown>) => string[],\n  ): CustomNode<T> => new CustomNode(kind, def, {}, validate ? { validate } : {}),\n\n  /** Collect leaves and groups into an instrument's config. */\n  schema<S extends ConfigShape>(nodes: S): ConfigSchema<InferConfig<S>> {\n    return { nodes, defaults: () => shapeDefaults(nodes) as InferConfig<S> };\n  },\n};\n","import type { ConfigRule, ConfigRuleContext, LeafPatch } from './types';\n\n/** `cellSize` -> `Cell size`. Splits camelCase without shattering acronyms. */\nexport function titleCase(key: string): string {\n  const words = key\n    .replace(/[_-]+/g, ' ')\n    .split(/(?<=[a-z0-9])(?=[A-Z])/)\n    .join(' ')\n    .trim()\n    .toLowerCase();\n  return words.length === 0 ? words : words[0].toUpperCase() + words.slice(1);\n}\n\n/** An `f.value` leaf takes its kind from the shape of its default. */\nconst kindFromValue: ConfigRule = (ctx) => {\n  const t = typeof ctx.default;\n  if (t === 'boolean' || t === 'number' || t === 'string') return { kind: t };\n  return null;\n};\n\nconst labelFromKey: ConfigRule = (ctx) => ({ name: titleCase(ctx.key) });\n\n/** A number bounded on both sides is a slider; one bound or none is an input. */\nconst sliderWhenBounded: ConfigRule = (ctx) => {\n  if (ctx.leaf.kind !== 'number') return null;\n  const bounded = ctx.leaf.min !== undefined && ctx.leaf.max !== undefined;\n  return bounded ? { control: 'slider' } : null;\n};\n\n/** `PrefBase.description` is required, so every leaf must end up with one. */\nconst descriptionDefault: ConfigRule = () => ({ description: '' });\n\n/**\n * labkit's own inference, expressed in the same vocabulary a consumer\n * extends. Runs after the consumer's rules, so a lab always wins.\n *\n * If one of these ever needs something a `ConfigRule` cannot express, the\n * seam is too weak — that is the point of writing them this way.\n */\nexport const builtinRules: readonly ConfigRule[] = [\n  kindFromValue,\n  labelFromKey,\n  sliderWhenBounded,\n  descriptionDefault,\n];\n\n/**\n * Fold a rule chain into one leaf patch. Gap-filling: a property already\n * settled is never overwritten, so the accumulator seeded with the author's\n * annotations beats every rule, and earlier rules beat later ones.\n */\nexport function applyRules(\n  seed: LeafPatch,\n  ctx: Omit<ConfigRuleContext, 'leaf'>,\n  rules: readonly ConfigRule[],\n): LeafPatch {\n  const acc: LeafPatch = { ...seed };\n  for (const rule of rules) {\n    const patch = rule({ ...ctx, leaf: acc });\n    if (patch === null) continue;\n    for (const [k, v] of Object.entries(patch)) {\n      if (v !== undefined && acc[k as keyof LeafPatch] === undefined) {\n        (acc as Record<string, unknown>)[k] = v;\n      }\n    }\n  }\n  return acc;\n}\n","import type { PrefGroup, PrefLeaf } from '@weasel-js/ui';\nimport { isConfigBranch } from './builder';\nimport { applyRules, builtinRules, titleCase } from './rules';\nimport type {\n  ConfigEntry,\n  ConfigRule,\n  ConfigSchema,\n  ConfigShape,\n  ControlRenderer,\n  LeafPatch,\n  ResolvedConfig,\n  SectionSpec,\n} from './types';\n\n/** Drop keys whose value is undefined, so an unset annotation stays a gap the\n *  rule chain can fill rather than a settled `undefined`. */\nfunction defined(annotations: Record<string, unknown>): LeafPatch {\n  const out: Record<string, unknown> = {};\n  for (const [k, v] of Object.entries(annotations)) if (v !== undefined) out[k] = v;\n  return out as LeafPatch;\n}\n\n/** What the walk collects on the side of the `PrefGroup` tree. */\ninterface Sink {\n  sections: SectionSpec[];\n  showIf: Map<string, (config: Record<string, unknown>) => boolean>;\n  renderers: Record<string, ControlRenderer>;\n  chain: readonly ConfigRule[];\n}\n\n/**\n * Resolve a schema into the vocabulary weasel-ui renders, running each leaf\n * through the consumer's rules and then labkit's own.\n *\n * The group mirrors the schema's own nesting: an `f.group` becomes a nested\n * `PrefGroup`, so a leaf's dotted path within the tree is the path its value\n * is written at, and both `ControlPanel` and `PrefsForm` address it\n * identically.\n */\nexport function resolveConfigSchema<TC>(\n  schema: ConfigSchema<TC>,\n  rules: readonly ConfigRule[] = [],\n): ResolvedConfig {\n  const sink: Sink = {\n    sections: [],\n    showIf: new Map(),\n    renderers: {},\n    chain: [...rules, ...builtinRules],\n  };\n  const group = resolveShape(schema.nodes, '', '', sink);\n  return { group, sections: sink.sections, showIf: sink.showIf, renderers: sink.renderers };\n}\n\n/** A section while it is still being filled. */\ntype OpenSection = Omit<SectionSpec, 'paths'> & { paths: string[] };\n\nfunction resolveShape(shape: ConfigShape, at: string, name: string, sink: Sink): PrefGroup {\n  const children: Record<string, PrefLeaf | PrefGroup> = {};\n  const sections = new Map<string, OpenSection>();\n\n  for (const [key, entry] of Object.entries(shape)) {\n    const path = at === '' ? key : `${at}.${key}`;\n    children[key] = resolveEntry(entry, key, path, sink);\n\n    const { section, showIf: predicate } = entry.options;\n    if (section !== undefined) {\n      let spec = sections.get(section.label);\n      if (!spec) {\n        spec = { at, label: section.label, paths: [] };\n        sections.set(section.label, spec);\n        sink.sections.push(spec);\n      }\n      spec.paths.push(path);\n      // One node saying `collapsed` settles the section, so a schema does not\n      // have to repeat it on every node under the heading.\n      if (section.collapsed !== undefined) {\n        spec.collapsed = (spec.collapsed ?? false) || section.collapsed;\n      }\n      if (section.layout !== undefined && spec.layout === undefined) spec.layout = section.layout;\n      if (section.pack !== undefined && spec.pack === undefined) spec.pack = section.pack;\n    }\n    if (predicate) sink.showIf.set(path, predicate);\n    if (!isConfigBranch(entry) && entry.options.render) sink.renderers[path] = entry.options.render;\n  }\n\n  return { name, children };\n}\n\nfunction resolveEntry(\n  entry: ConfigEntry,\n  key: string,\n  path: string,\n  sink: Sink,\n): PrefLeaf | PrefGroup {\n  if (isConfigBranch(entry)) {\n    const group = resolveShape(\n      entry.children,\n      path,\n      entry.annotations.name ?? titleCase(key),\n      sink,\n    );\n    return entry.annotations.description === undefined\n      ? group\n      : { ...group, description: entry.annotations.description };\n  }\n  if (entry.options.manual && entry.options.unpinned) {\n    throw new Error(\n      `[labkit] \"${path}\" is both .manual() and .initial(auto) — a field that can never be auto cannot start auto`,\n    );\n  }\n  const seed: LeafPatch = defined({\n    ...entry.annotations,\n    ...(entry.kind === null ? {} : { kind: entry.kind }),\n  });\n  const patch = applyRules(seed, { key, path, default: entry.default }, sink.chain);\n  const { autoResolve, unpinned, manual } = entry.options;\n  return {\n    ...patch,\n    default: entry.default,\n    // Extra keys survive onto the leaf at runtime; `ControlPanel` reads them\n    // back with its `extra<T>` helper, the same as `min`, `step` and the rest.\n    ...(autoResolve === undefined ? {} : { autoResolve }),\n    ...(unpinned === undefined ? {} : { unpinned }),\n    ...(manual === undefined ? {} : { manual }),\n  } as PrefLeaf;\n}\n","import { useMemo } from 'react';\nimport { resolveAutoConfig } from './autoConfig';\nimport type { ResolvedConfig } from './types';\n\nconst NONE: ReadonlySet<string> = new Set();\n\n/**\n * The config an instrument reads: the stored one with every unpinned path\n * resolved. The single place resolution happens, so `Trial` and\n * `useTrialState` cannot disagree about what an instrument is looking at.\n */\nexport function useResolvedConfig<TC>(\n  schema: ResolvedConfig | undefined,\n  config: TC,\n  autoPaths: readonly string[] | undefined,\n): { config: TC; auto: ReadonlySet<string> } {\n  const auto = useMemo(\n    () => (autoPaths && autoPaths.length > 0 ? new Set(autoPaths) : NONE),\n    [autoPaths],\n  );\n  const resolvedConfig = useMemo(\n    () => (schema ? resolveAutoConfig(schema, config, auto) : config),\n    [schema, config, auto],\n  );\n  return { config: resolvedConfig, auto };\n}\n"]}