@weasel-js/labkit 1.3.0-pre.0 → 1.3.0

package/dist/index.d.ts

@@ -1,174 +1,481 @@
-export { CanvasLayerDescriptor, CanvasStack, CanvasStackContext, CanvasStackContextValue, CanvasStackProps, screenToWorld, worldToScreen } from './canvas/index.js';
+export { LayerStack, LayerStackItem, LayerStackProps } from './ui/layers/index.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
-import { WheelEvent, PointerEvent, ReactNode } from 'react';
+import { ReactNode, WheelEvent, PointerEvent } from 'react';
+export { CanvasLayerDescriptor, CanvasStack, CanvasStackContext, CanvasStackContextValue, CanvasStackProps, screenToWorld, worldToScreen } from './canvas/index.js';
 export { PaletteRegion, PaletteRegionProps, SidebarRegion, SidebarRegionProps, StatusRegion, StatusRegionProps, TitleBarRegion, TitleBarRegionProps, ToolbarRegion, ToolbarRegionProps, ViewportRegion, ViewportRegionProps, builtinContributions, mergeContributions, suppressContributions } from './chrome/index.js';
-import { I as Instrument, a as InstrumentList, T as TrialContribution, b as TrialTool, V as ViewTransform } from './_dts/index-DgcNdEdh.js';
-export { C as CanvasCapability, c as CanvasLayer, D as DragDropCapability, d as DragFeedback, H as HitResult, e as IconComponent, L as LayerCapability, f as LayerDescriptor, P as PaletteItem, g as Point, R as RenderContext, S as SidebarSection, h as StatusReadout, i as SystemEvent, j as ToolCapability, k as ToolItem, l as ToolbarItem, m as TrialChromeContext, n as TrialRegion, U as UndoCapability, o as ViewportControl } from './_dts/index-DgcNdEdh.js';
+import { I as Instrument, c as InstrumentList, T as TrialContribution, d as TrialTool, V as ViewTransform } from './_dts/types-BttTIent.js';
+export { C as CanvasCapability, e as CanvasLayer, b as DragDropCapability, D as DragFeedback, H as HitResult, f as IconComponent, L as LayerCapability, g as LayerDescriptor, P as PaletteItem, a as Point, R as RenderContext, S as SidebarSection, h as StatusReadout, i as SystemEvent, j as ToolCapability, k as ToolItem, l as ToolbarItem, m as TrialChromeContext, n as TrialRegion, U as UndoCapability, o as ViewportControl } from './_dts/types-BttTIent.js';
 import { T as ToolPrefLeaf } from './_dts/PrefsForm-BYa6cWnO.js';
-import { C as ConfigNode, A as Annotations, N as NodeOptions, a as ControlRenderer, b as ConfigOption, c as ConfigSchema, I as InferConfig, d as ConfigField, R as ResolvedConfig, e as ConfigRule, L as LeafPatch, f as ConfigRuleContext } from './_dts/types-AHlQxBNN.js';
-export { g as CheckboxField, h as ColorField, i as ConfigFieldBase, j as ConfigFieldType, k as ConfigOf, l as NodeValue, m as NumberField, S as SectionSpec, n as SelectField, o as SelectOption, p as SliderField, T as TextField } from './_dts/types-AHlQxBNN.js';
+import { b as ConfigNode, A as Annotations, N as NodeOptions, c as ControlRenderer, d as ConfigOption, a as ConfigSchema, I as InferConfig, C as ConfigField, R as ResolvedConfig, e as ConfigRule, L as LeafPatch, f as ConfigRuleContext } from './_dts/types-DCGEcMO_.js';
+export { g as CheckboxField, h as ColorField, i as ConfigFieldBase, j as ConfigFieldType, k as ConfigOf, l as NodeValue, m as NumberField, S as SectionSpec, n as SelectField, o as SelectOption, p as SliderField, T as TextField } from './_dts/types-DCGEcMO_.js';
 export { ControlPanel } from './controls/index.js';
 import { J as JobHandle } from './_dts/types-DJ79Tg5J.js';
 export { a as JobCapability, b as JobEvent, c as JobFailure, d as JobStatus } from './_dts/types-DJ79Tg5J.js';
 export { UseJobOptions, useJob } from './job/index.js';
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import { a as StorageAdapter, e as LabMode, T as TrialRecord, c as SavedSnapshot } from './_dts/types-1Sdxy_Pv.js';
 export { C as CreateLabStoreOptions, L as LabDocument, b as LabStoreState, S as SerializedTrial, d as TrialStateHandle, U as UndoStack } from './_dts/types-1Sdxy_Pv.js';
 export { LayerList, LayerListProps } from './layers/index.js';
 export { FloatingPanel, FloatingPanelProps, FpsMeter, JobProgress, JobProgressProps, Legend, LegendEntry, LegendMark, LegendProps, ScaleIndicator, ScaleIndicatorProps, Sidebar, SidebarProps, StatusBar, StatusBarProps, StatusBarSectionProps, Toolbar, ToolbarButtonProps, ToolbarGroupProps, ToolbarProps, ZoomControl, ZoomControlProps } from './primitives/index.js';
 export { C as CURRENT_DOCUMENT_VERSION, b as LabStoreContext, c as LabStoreProvider, T as TrialIdContext, d as TrialIdProvider, f as createMemoryAdapter, l as labDocumentKey, g as localStorageAdapter, n as noneAdapter, q as quarantineKey, s as sessionStorageAdapter, u as urlHashAdapter, h as useLabStore, i as useTrialId, j as useTrialState } from './_dts/useTrialState-CsGMjhu9.js';
 export { Box, Rect, SurfaceContext, SurfaceFrame, SurfaceHandle, UseTiledSurfaceOptions, composeRects, rectsEqual, toDeviceRect, useSurface, useSurfaceOptional, useSurfaceTile, useTiledSurface } from './surface/index.js';
-export { LayerStack, LayerStackItem, LayerStackProps } from './ui/layers/index.js';
 export { EventBus, EventListener, clearUndo, createEventBus, emptyStack, pushSnapshot, redo, undo } from './undo/index.js';
 import 'windease';
 import 'zustand/vanilla';
 
-/** A point in the space the instrument works in. */
-interface Vec3 {
+/** An annotation drawn over a curve plot: a shaded band across a range of x,
+ *  or a vertical line at one x. */
+type CurveMark = {
+    kind: 'band';
+    x: [number, number];
+    color?: string;
+} | {
+    kind: 'line';
     x: number;
-    y: number;
-    z: number;
-}
-/** An orbit camera as a trial view: where it looks from, and what it looks at.
- *  labkit does not turn this into a matrix — the host's renderer does. */
-interface OrbitView {
-    yaw: number;
-    pitch: number;
-    distance: number;
-    target: Vec3;
-}
-/** Just short of the pole. At exactly ±PI/2 the azimuth is undefined and the
- *  camera rolls, which reads as the model jumping rather than as a limit. */
-declare const PITCH_LIMIT: number;
-declare function clampPitch(pitch: number): number;
-declare function wrapYaw(yaw: number): number;
-/** The view a drag of (dx, dy) from `start` produces. Absolute against the drag
- *  start, so it can be re-applied any number of times without compounding. */
-declare function orbitAfterDrag(start: OrbitView, dx: number, dy: number): OrbitView;
-/** Multiplicative, so one notch covers the same proportion of the distance
- *  whether the camera is near or far. */
-declare function orbitAfterWheel(view: OrbitView, deltaY: number, minDistance: number, maxDistance: number): OrbitView;
-interface UseOrbitOptions {
-    view: OrbitView;
-    onViewChange: (v: OrbitView) => void;
-    /** Restored on double-click. Defaults to the view the hook first saw. */
-    home?: OrbitView;
-    minDistance?: number;
-    maxDistance?: number;
-}
-interface OrbitHandlers {
-    onWheel: (e: WheelEvent<HTMLElement>) => void;
-    onPointerDown: (e: PointerEvent<HTMLElement>) => void;
-    onPointerMove: (e: PointerEvent<HTMLElement>) => void;
-    onPointerUp: (e: PointerEvent<HTMLElement>) => void;
-    onDoubleClick: () => void;
-    isDragging: () => boolean;
+    color?: string;
+};
+/** Props for `<CurveField>`. */
+interface CurveFieldProps {
+    /** Flat [x0, y0, x1, y1, …] — matches how curve-as-array configs
+     *  serialize in JSON snapshots. */
+    values: number[];
+    min: number;
+    max: number;
+    step: number;
+    /** Plot width in CSS px. Caller sizes (typically uses a ResizeObserver). */
+    width: number;
+    /** Plot height in CSS px. Default 110. */
+    height?: number;
+    /** Flat default curve. When provided, a Reset button restores it. */
+    defaults?: readonly number[];
+    onChange: (next: number[]) => void;
+    /** Optional vertical marks overlaid on the plot (e.g. landmarks). */
+    marks?: readonly CurveMark[];
 }
-/** Pointer gestures over an orbit view: drag to turn, wheel or pinch to dolly,
- *  double-click to go home. The 3D peer of `usePanZoom`. */
-declare function useOrbit({ view, onViewChange, home, minDistance, maxDistance, }: UseOrbitOptions): OrbitHandlers;
+/**
+ * A function-domain (y = f(x), x ∈ [0,1]) curve editor with per-stop
+ * numeric readouts and flip buttons. Wraps weasel-ui's
+ * `CurveEditor`; consumers wanting the raw editor (2D paths,
+ * custom anchors) should import that instead.
+ */
+declare function CurveField({ values, min, max, step, width, height, defaults, onChange, marks, }: CurveFieldProps): react_jsx_runtime.JSX.Element;
 
-/** Shared chaining surface. Every method clones, so a node can be reused as a
- *  base for several leaves without one bleeding into the next. */
-declare abstract class BaseNode<T> implements ConfigNode<T> {
-    readonly annotations: Readonly<Annotations>;
-    readonly options: Readonly<NodeOptions>;
-    abstract readonly kind: string | null;
-    readonly default: T;
-    constructor(defaultValue: T, annotations?: Readonly<Annotations>, options?: Readonly<NodeOptions>);
-    /** Clone into the same subclass. Subclasses with extra constructor
-     *  arguments override this. */
-    protected with(annotations: Annotations, options: NodeOptions): this;
-    protected ann(patch: Annotations): this;
-    protected opt(patch: NodeOptions): this;
-    /** Human-readable label. Defaults to the key, title-cased. */
-    label(name: string): this;
-    /** Longer help text, surfaced as a tooltip on the row label. */
-    describe(description: string): this;
-    /** Omit from the panel unless it is asked to show hidden leaves. */
-    hidden(): this;
-    /** Pair with a sibling sharing this id, side-by-side on one row. */
-    pair(pair: string): this;
-    /** Render under a named section heading. */
-    section(section: string): this;
-    /** Show this row only while the predicate holds. Presentational — the value
-     *  stays in config and the instrument still reads it. */
-    showIf(predicate: (config: Record<string, unknown>) => boolean): this;
-    /** Draw this one row yourself, keeping the kind, default and validation. */
-    render(renderer: ControlRenderer): this;
-}
-declare class NumberNode extends BaseNode<number> {
-    readonly kind = "number";
-    /** Bound the value. A number with both bounds renders as a slider. */
-    range(min: number, max: number): this;
-    step(step: number): this;
-    /** Force a slider even without both bounds. */
-    slider(): this;
-    /** Force a typed input even when both bounds are set. */
-    input(): this;
-}
-declare class BooleanNode extends BaseNode<boolean> {
-    readonly kind = "boolean";
-    /** Ask for a switch. `ControlPanel` still draws a checkbox; weasel-ui's
-     *  `PrefsForm` honors the distinction. */
-    toggle(): this;
-}
-declare class StringNode extends BaseNode<string> {
-    readonly kind = "string";
-    placeholder(placeholder: string): this;
-    maxLength(maxLength: number): this;
-    /** Milliseconds to debounce live writes. 0 commits every keystroke. */
-    debounce(debounceMs: number): this;
+/** Props for `<Subpanel>`. */
+interface SubpanelProps {
+    title: ReactNode;
+    children: ReactNode;
+    className?: string;
 }
-declare class ColorNode extends BaseNode<string> {
-    readonly kind = "color";
+/** A typographic divider inside a property list: a small title flanked by a
+ *  rule. Purely a heading — use `<PropertyGroup>` for a bordered section. */
+declare function Subpanel({ title, children, className }: SubpanelProps): react_jsx_runtime.JSX.Element;
+/** Props for `<EffectCard>`. */
+interface EffectCardProps {
+    /** Card title rendered in the title bar (e.g. effect kind label or a select). */
+    title: ReactNode;
+    /** Optional badge/chip displayed before the remove button (e.g. primary value summary). */
+    primary?: ReactNode;
+    /** Optional accent color in any CSS color form. Sets --wzl-effect-card-accent on the card. */
+    accent?: string;
+    /** Optional ordinal badge that doubles as the drag handle (used by tail cards in SB). */
+    index?: number;
+    expanded?: boolean;
+    onToggleExpanded?: () => void;
+    onRemove?: () => void;
+    /**
+     * Drag-handle wiring. When provided, an inline handle (⋮⋮ icon or `index`)
+     * activates HTML5 drag on press. Consumer owns the drag/drop coordination —
+     * see EffectCardList for the batteries-included wrapper.
+     */
+    draggable?: boolean;
+    onPressHandle?: () => void;
+    onReleaseHandle?: () => void;
+    onDragStart?: (e: React.DragEvent<HTMLDivElement>) => void;
+    onDragEnd?: (e: React.DragEvent<HTMLDivElement>) => void;
+    onDragOver?: (e: React.DragEvent<HTMLDivElement>) => void;
+    onDragLeave?: (e: React.DragEvent<HTMLDivElement>) => void;
+    onDrop?: (e: React.DragEvent<HTMLDivElement>) => void;
+    dragging?: boolean;
+    children?: ReactNode;
+    className?: string;
 }
-declare class EnumNode<T extends string> extends BaseNode<T> {
-    readonly kind = "enum";
-    /** Render as a segmented control rather than a select. */
-    radio(): this;
-    /** Relabel the choices. Named `labels` rather than `options` because
-     *  `options` is the node's own extras bag. */
-    labels(options: readonly ConfigOption[]): this;
+/** An accented, collapsible card for one item in a list of like things —
+ *  effects, layers, tails. The accent color rebinds the theme accent token
+ *  within the card, so its controls pick it up too. */
+declare function EffectCard({ title, primary, accent, index, expanded, onToggleExpanded, onRemove, draggable, onPressHandle, onReleaseHandle, onDragStart, onDragEnd, onDragOver, onDragLeave, onDrop, dragging, children, className, }: EffectCardProps): react_jsx_runtime.JSX.Element;
+/** The minimum an item must carry to appear in an `<EffectCardList>`. */
+interface EffectCardListItem {
+    id: string | number;
 }
-/** A leaf whose kind the rule chain decides. */
-declare class ValueNode<T> extends BaseNode<T> {
-    readonly kind: null;
+/** Props for `<EffectCardList>`. */
+interface EffectCardListProps<T extends EffectCardListItem> {
+    items: ReadonlyArray<T>;
+    renderItem: (item: T, helpers: {
+        isExpanded: boolean;
+        isDragging: boolean;
+        toggleExpanded: () => void;
+        cardProps: Pick<EffectCardProps, 'expanded' | 'dragging' | 'draggable' | 'onToggleExpanded' | 'onPressHandle' | 'onReleaseHandle' | 'onDragStart' | 'onDragEnd' | 'onDragOver' | 'onDragLeave' | 'onDrop'>;
+    }) => ReactNode;
+    onReorder: (sourceId: T['id'], targetId: T['id'], position: 'before' | 'after') => void;
+    /** Optional rendered when the list is empty. */
+    empty?: ReactNode;
+    /** IDs to render expanded on first mount. Defaults to all collapsed. */
+    defaultExpandedIds?: ReadonlyArray<T['id']>;
 }
-/** A leaf of a kind labkit does not ship a row for. */
-declare class CustomNode<T> extends BaseNode<T> {
-    readonly kind: string;
-    constructor(kind: string, defaultValue: T, annotations?: Readonly<Annotations>, options?: Readonly<NodeOptions>);
-    protected with(annotations: Annotations, options: NodeOptions): this;
+/** A drag-reorderable list of `<EffectCard>`s. Owns the expanded and dragging
+ *  state and hands it back to `renderItem`, so the caller only supplies each
+ *  card's contents. */
+declare function EffectCardList<T extends EffectCardListItem>({ items, renderItem, onReorder, empty, defaultExpandedIds, }: EffectCardListProps<T>): react_jsx_runtime.JSX.Element;
+
+/** Props for `<PropertyGroup>`. */
+interface PropertyGroupProps {
+    /** Title rendered between two rules at the top of the group. */
+    title: ReactNode;
+    /** When true the group renders nothing — useful for conditional sections. */
+    hidden?: boolean;
+    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.
+     *   - `'pairs'`: every row auto-places into the 2-column grid two-per-row.
+     */
+    pack?: 'auto-color' | 'pairs';
 }
 /**
- * Builds an instrument's config: the values, their types, and how each is
- * edited, in one declaration.
- *
- * ```ts
- * const config = f.schema({
- *   showGrid: f.boolean(true),
- *   cellSize: f.number(20).range(5, 80).step(5).label('Grid spacing'),
- * })
- * ```
+ * Visually-bordered group inside a PropertyList. Use to scope a set of
+ * related rows under a heading (e.g. "Aqua", "Bevel", "Dome" sections
+ * inside a fill effect's controls).
  */
-declare const f: {
-    number: (def: number) => NumberNode;
-    boolean: (def: boolean) => BooleanNode;
-    string: (def: string) => StringNode;
-    color: (def: string) => ColorNode;
-    /** A fixed set of choices. The default's literal type flows into the config
-     *  type, so `f.enum('fast', ['fast', 'accurate'])` gives
-     *  `'fast' | 'accurate'` with no `as const`. */
-    enum: <const T extends string>(def: T, options: readonly T[] | readonly ConfigOption[]) => EnumNode<T>;
-    /** A leaf with no declared kind: the rule chain decides, which is how a lab
-     *  states a convention like "every `*Color` key is a color picker". */
-    value: <T>(def: T) => ValueNode<T>;
-    /** A leaf of a kind a lab supplies the control for, through `controls`. */
-    custom: <T>(kind: string, def: T, validate?: (leaf: ToolPrefLeaf) => string[]) => CustomNode<T>;
-    /** Collect leaves into an instrument's config. */
-    schema<S extends Record<string, ConfigNode>>(nodes: S): ConfigSchema<InferConfig<S>>;
-};
+declare function PropertyGroup({ title, hidden, children, className, pack, }: PropertyGroupProps): react_jsx_runtime.JSX.Element | null;
+
+/** Props for `<PropertyPanel>`. */
+interface PropertyPanelProps {
+    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 }: PropertyPanelProps): react_jsx_runtime.JSX.Element;
+/** How a property list packs its rows into two columns. */
+type PropertyListPack = 'auto-color' | 'pairs';
+/** Props for `<PropertyList>`. */
+interface PropertyListProps {
+    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.
+     */
+    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 }: 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 {
+    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. "block" (default) stacks
+     * label above control; "inline" places the label to the left.
+     * Color and checkbox variants are always inline by their own nature.
+     */
+    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;
+    className?: string;
+}
+/** 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, className, }: PropertyRowProps): react_jsx_runtime.JSX.Element;
+/** Props for `<SliderRow>`. */
+interface SliderRowProps {
+    label: ReactNode;
+    value: number;
+    min: number;
+    max: number;
+    step?: number;
+    onChange: (next: number) => void;
+    /** Override how the value is rendered next to the label. Defaults to `value.toString()`. */
+    format?: (value: number) => ReactNode;
+    /**
+     * 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;
+}
+/** A bounded number edited by dragging, with a live readout whose precision
+ *  follows `step`. */
+declare function SliderRow({ label, value, min, max, step, onChange, format, unit, layout, description, }: SliderRowProps): react_jsx_runtime.JSX.Element;
+/** Props for `<ColorRow>`. */
+interface ColorRowProps {
+    label: ReactNode;
+    value: string;
+    onChange: (next: string) => void;
+    /** 0..1 alpha. When provided, a translucent slider renders beneath the swatch. */
+    alpha?: number;
+    onAlphaChange?: (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;
+    description?: string;
+}
+/** A color swatch, optionally with an alpha slider beneath it. */
+declare function ColorRow({ label, value, onChange, alpha, onAlphaChange, alphaDisabled, description, }: ColorRowProps): react_jsx_runtime.JSX.Element;
+/** Props for `<CheckboxRow>`. */
+interface CheckboxRowProps {
+    label: ReactNode;
+    value: boolean;
+    onChange: (next: boolean) => void;
+    description?: string;
+}
+/** A boolean checkbox. */
+declare function CheckboxRow({ label, value, onChange, description }: CheckboxRowProps): react_jsx_runtime.JSX.Element;
+/** Props for `<TextRow>`. */
+interface TextRowProps {
+    label: ReactNode;
+    value: string;
+    onChange: (next: string) => void;
+    placeholder?: string;
+    maxLength?: number;
+    layout?: PropertyRowLayout;
+    description?: string;
+}
+/** A single-line text input. */
+declare function TextRow({ label, value, onChange, placeholder, maxLength, layout, description, }: TextRowProps): react_jsx_runtime.JSX.Element;
+/** Props for `<NumberRow>`. */
+interface NumberRowProps {
+    label: ReactNode;
+    value: number;
+    onChange: (next: number) => void;
+    min?: number;
+    max?: number;
+    step?: number;
+    placeholder?: string;
+    layout?: PropertyRowLayout;
+    description?: string;
+}
+/** A number typed directly. Reach for `<SliderRow>` when the range matters
+ *  more than the exact value. */
+declare function NumberRow({ label, value, onChange, min, max, step, placeholder, layout, description, }: NumberRowProps): react_jsx_runtime.JSX.Element;
+interface PropertyOption<T extends string> {
+    value: T;
+    label: ReactNode;
+}
+/** Props for `<SelectRow>`. */
+interface SelectRowProps<T extends string> {
+    label: ReactNode;
+    value: T;
+    options: ReadonlyArray<PropertyOption<T>>;
+    onChange: (next: T) => void;
+    layout?: PropertyRowLayout;
+    description?: string;
+}
+/** 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, value, options, onChange, layout, description, }: SelectRowProps<T>): react_jsx_runtime.JSX.Element;
+/** Props for `<ToggleRow>`. */
+interface ToggleRowProps<T extends string> {
+    label: ReactNode;
+    value: T;
+    options: ReadonlyArray<PropertyOption<T>>;
+    onChange: (next: T) => void;
+    layout?: PropertyRowLayout;
+    description?: string;
+}
+/** A segmented control: the same choice as a select, with every option
+ *  visible at once. */
+declare function ToggleRow<T extends string>({ label, value, options, onChange, layout, description, }: ToggleRowProps<T>): react_jsx_runtime.JSX.Element;
+
+/** A point in the space the instrument works in. */
+interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+/** An orbit camera as a trial view: where it looks from, and what it looks at.
+ *  labkit does not turn this into a matrix — the host's renderer does. */
+interface OrbitView {
+    yaw: number;
+    pitch: number;
+    distance: number;
+    target: Vec3;
+}
+/** Just short of the pole. At exactly ±PI/2 the azimuth is undefined and the
+ *  camera rolls, which reads as the model jumping rather than as a limit. */
+declare const PITCH_LIMIT: number;
+declare function clampPitch(pitch: number): number;
+declare function wrapYaw(yaw: number): number;
+/** The view a drag of (dx, dy) from `start` produces. Absolute against the drag
+ *  start, so it can be re-applied any number of times without compounding. */
+declare function orbitAfterDrag(start: OrbitView, dx: number, dy: number): OrbitView;
+/** Multiplicative, so one notch covers the same proportion of the distance
+ *  whether the camera is near or far. */
+declare function orbitAfterWheel(view: OrbitView, deltaY: number, minDistance: number, maxDistance: number): OrbitView;
+interface UseOrbitOptions {
+    view: OrbitView;
+    onViewChange: (v: OrbitView) => void;
+    /** Restored on double-click. Defaults to the view the hook first saw. */
+    home?: OrbitView;
+    minDistance?: number;
+    maxDistance?: number;
+}
+interface OrbitHandlers {
+    onWheel: (e: WheelEvent<HTMLElement>) => void;
+    onPointerDown: (e: PointerEvent<HTMLElement>) => void;
+    onPointerMove: (e: PointerEvent<HTMLElement>) => void;
+    onPointerUp: (e: PointerEvent<HTMLElement>) => void;
+    onDoubleClick: () => void;
+    isDragging: () => boolean;
+}
+/** Pointer gestures over an orbit view: drag to turn, wheel or pinch to dolly,
+ *  double-click to go home. The 3D peer of `usePanZoom`. */
+declare function useOrbit({ view, onViewChange, home, minDistance, maxDistance, }: UseOrbitOptions): OrbitHandlers;
+
+/** Shared chaining surface. Every method clones, so a node can be reused as a
+ *  base for several leaves without one bleeding into the next. */
+declare abstract class BaseNode<T> implements ConfigNode<T> {
+    readonly annotations: Readonly<Annotations>;
+    readonly options: Readonly<NodeOptions>;
+    abstract readonly kind: string | null;
+    readonly default: T;
+    constructor(defaultValue: T, annotations?: Readonly<Annotations>, options?: Readonly<NodeOptions>);
+    /** Clone into the same subclass. Subclasses with extra constructor
+     *  arguments override this. */
+    protected with(annotations: Annotations, options: NodeOptions): this;
+    protected ann(patch: Annotations): this;
+    protected opt(patch: NodeOptions): this;
+    /** Human-readable label. Defaults to the key, title-cased. */
+    label(name: string): this;
+    /** Longer help text, surfaced as a tooltip on the row label. */
+    describe(description: string): this;
+    /** Omit from the panel unless it is asked to show hidden leaves. */
+    hidden(): this;
+    /** Pair with a sibling sharing this id, side-by-side on one row. */
+    pair(pair: string): this;
+    /** Render under a named section heading. */
+    section(section: string): this;
+    /** Show this row only while the predicate holds. Presentational — the value
+     *  stays in config and the instrument still reads it. */
+    showIf(predicate: (config: Record<string, unknown>) => boolean): this;
+    /** Draw this one row yourself, keeping the kind, default and validation. */
+    render(renderer: ControlRenderer): this;
+}
+declare class NumberNode extends BaseNode<number> {
+    readonly kind = "number";
+    /** Bound the value. A number with both bounds renders as a slider. */
+    range(min: number, max: number): this;
+    step(step: number): this;
+    /** Force a slider even without both bounds. */
+    slider(): this;
+    /** Force a typed input even when both bounds are set. */
+    input(): this;
+}
+declare class BooleanNode extends BaseNode<boolean> {
+    readonly kind = "boolean";
+    /** Ask for a switch. `ControlPanel` still draws a checkbox; weasel-ui's
+     *  `PrefsForm` honors the distinction. */
+    toggle(): this;
+}
+declare class StringNode extends BaseNode<string> {
+    readonly kind = "string";
+    placeholder(placeholder: string): this;
+    maxLength(maxLength: number): this;
+    /** Milliseconds to debounce live writes. 0 commits every keystroke. */
+    debounce(debounceMs: number): this;
+}
+declare class ColorNode extends BaseNode<string> {
+    readonly kind = "color";
+}
+declare class EnumNode<T extends string> extends BaseNode<T> {
+    readonly kind = "enum";
+    /** Render as a segmented control rather than a select. */
+    radio(): this;
+    /** Relabel the choices. Named `labels` rather than `options` because
+     *  `options` is the node's own extras bag. */
+    labels(options: readonly ConfigOption[]): this;
+}
+/** A leaf whose kind the rule chain decides. */
+declare class ValueNode<T> extends BaseNode<T> {
+    readonly kind: null;
+}
+/** A leaf of a kind labkit does not ship a row for. */
+declare class CustomNode<T> extends BaseNode<T> {
+    readonly kind: string;
+    constructor(kind: string, defaultValue: T, annotations?: Readonly<Annotations>, options?: Readonly<NodeOptions>);
+    protected with(annotations: Annotations, options: NodeOptions): this;
+}
+/**
+ * Builds an instrument's config: the values, their types, and how each is
+ * edited, in one declaration.
+ *
+ * ```ts
+ * const config = f.schema({
+ *   showGrid: f.boolean(true),
+ *   cellSize: f.number(20).range(5, 80).step(5).label('Grid spacing'),
+ * })
+ * ```
+ */
+declare const f: {
+    number: (def: number) => NumberNode;
+    boolean: (def: boolean) => BooleanNode;
+    string: (def: string) => StringNode;
+    color: (def: string) => ColorNode;
+    /** A fixed set of choices. The default's literal type flows into the config
+     *  type, so `f.enum('fast', ['fast', 'accurate'])` gives
+     *  `'fast' | 'accurate'` with no `as const`. */
+    enum: <const T extends string>(def: T, options: readonly T[] | readonly ConfigOption[]) => EnumNode<T>;
+    /** A leaf with no declared kind: the rule chain decides, which is how a lab
+     *  states a convention like "every `*Color` key is a color picker". */
+    value: <T>(def: T) => ValueNode<T>;
+    /** A leaf of a kind a lab supplies the control for, through `controls`. */
+    custom: <T>(kind: string, def: T, validate?: (leaf: ToolPrefLeaf) => string[]) => CustomNode<T>;
+    /** Collect leaves into an instrument's config. */
+    schema<S extends Record<string, ConfigNode>>(nodes: S): ConfigSchema<InferConfig<S>>;
+};
 
 /**
  * Adapt a legacy `configSchema(): ConfigField[]` into the resolved shape, so
@@ -386,414 +693,137 @@ interface WorkspaceProps {
     /** Fires when a tile's extent changes. Persist it and hand it back as
      *  `layout` to make a resize survive a reload. */
     onLayoutChange?: (layout: TrialLayout) => void;
-    gap?: number;
-    padding?: number;
-    /**
-     * Fixed tiling extent. Omit in an app — the grid measures its own box. Supply
-     * it where nothing measures, notably jsdom: at a zero measurement the grid
-     * renders no tiles at all.
-     */
-    viewport?: {
-        w: number;
-        h: number;
-    };
-}
-/**
- * Auto-balanced tiling of trials, `ceil(sqrt(n))` columns wide.
- *
- * Tiles are absolutely positioned at the rects `gridStrategy` computes, not
- * laid out by CSS — `windease/styles.css` (folded into
- * `@weasel-js/labkit/styles.css`) carries the rules that positioning depends on.
- */
-declare function Workspace({ children, ids, resizable, reorderable, onReorder, layout, onLayoutChange, gap, padding, viewport, }: WorkspaceProps): react_jsx_runtime.JSX.Element;
-
-/** The 2D view labkit has always shipped, and what a trial gets when it names no
- *  other. Re-exported under its own name so a consumer can say which it means. */
-type ViewTransform2D = ViewTransform;
-declare const DEFAULT_VIEW: ViewTransform2D;
-/** A trial's view is opaque to labkit, so anything that needs the 2D shape — the
- *  zoom chrome, `CanvasStack` — asks for it and handles not getting it. */
-declare function as2DView(view: unknown): ViewTransform2D | null;
-
-type TokenValue = string | number | readonly (string | number)[];
-/**
- * A single design token as authored, before aliases are resolved: a DTCG-shaped
- * `{ type, value }` pair where `value` may still be a `{ref}` to another token.
- */
-interface RawToken {
-    readonly type: string;
-    readonly value: TokenValue;
-    /** Render the referenced color at this alpha, 0–1. */
-    readonly alpha?: number | undefined;
-    readonly description?: string | undefined;
-}
-/** A token graph flattened to one level, keyed by token name (no `--wzl-`
- *  prefix). Still unresolved — see `ResolvedTokenMap` for the output side. */
-type FlatTokens = Record<string, RawToken>;
-
-/**
- * A theme: a named set of design tokens, organized into a mode-invariant layer
- * plus one layer per mode (light, dark, …), optionally extending another theme.
- * Tokens are held unresolved — aliases between them are collapsed later by
- * `resolveTheme`, so an override of a base primitive still reaches everything
- * that references it.
- */
-interface Theme {
-    readonly name: string;
-    readonly extends: Theme | null;
-    readonly defaultMode: string;
-    readonly tokens: FlatTokens;
-    readonly modes: Readonly<Record<string, FlatTokens>>;
-}
-
-/**
- * labkit's theme: a cosmic dark and a warm parchment light, extending the
- * built-in weasel theme. Authored as DTCG and loaded at import time — the
- * interchange path a theme exported from a design tool would take.
- */
-declare const interstellarTheme: Theme;
-
-/** Props for `<Trial>`. */
-interface TrialProps {
-    id: string;
-    /** Contributions the lab adds to this trial's chrome, merged after the
-     *  instrument's own. */
-    chrome?: readonly TrialContribution[];
-    /** Built-in contribution ids to drop. Throws on an id that is not there. */
-    suppress?: readonly string[];
-}
-/** Renders one trial from the lab store: looks up its record and
- *  instrument, and mounts the instrument inside the trial chrome. */
-declare function Trial({ id, chrome, suppress }: TrialProps): react_jsx_runtime.JSX.Element;
-
-interface UndoBindings {
-    canUndo: boolean;
-    canRedo: boolean;
-    undo: () => void;
-    redo: () => void;
-}
-/** Props for `<TrialChrome>`. */
-interface TrialChromeProps {
-    trialId: string;
-    record: TrialRecord;
-    instrument: Instrument;
-    isLastTrial: boolean;
-    undoBindings?: UndoBindings;
-    /** Supplied when the instrument declares a `job`. */
-    job?: JobHandle;
-    /** Contributions the trial runtime itself adds — the drag palette and the
-     *  layer list, which depend on runtime state the instrument cannot reach. */
-    trialChrome?: readonly TrialContribution[];
-    /** Contributions from the lab, merged last. */
-    chrome?: readonly TrialContribution[];
-    /** Built-in contribution ids to drop. Throws on an id that is not there. */
-    suppress?: readonly string[];
-    /** The trial's resolved tool slot, and the setter that writes whichever
-     *  slot it resolved to. `Trial` owns the resolution. */
-    activeToolId?: string | null;
-    setActiveTool?: (id: string) => void;
-    children: ReactNode;
-}
-/** The frame around a running instrument. Builds one chrome context, assembles
- *  the contributions the instrument, the runtime and the lab declare, and hands
- *  each region its slice. */
-declare function TrialChrome({ trialId, record, instrument, isLastTrial, undoBindings, job, trialChrome, chrome, suppress, activeToolId, setActiveTool, children, }: TrialChromeProps): react_jsx_runtime.JSX.Element;
-
-/** Append a new trial running `instrumentName`, at that instrument's
- *  default config and initial state. */
-declare function addTrial(trials: TrialRecord[], instruments: InstrumentList, instrumentName: string): TrialRecord[];
-/** Insert a deep copy of a trial directly after it. The copy starts with
- *  an empty undo history — the original's is not shared. */
-declare function cloneTrial(trials: TrialRecord[], id: string): TrialRecord[];
-/** Remove a trial, unless it is the last one — a lab always has at least
- *  one. */
-declare function closeTrial(trials: TrialRecord[], id: string): TrialRecord[];
-/** Return a trial to its instrument's defaults, keeping its id and its
- *  place in the list. */
-declare function resetTrial(trials: TrialRecord[], id: string, instruments: InstrumentList): TrialRecord[];
-/**
- * Reorder to match `ids`. Ids the list doesn't mention keep their relative
- * order at the end, and ids it names that no longer exist are dropped — a
- * reorder that raced a close should not resurrect the closed trial.
- */
-declare function reorderTrials(trials: TrialRecord[], ids: readonly string[]): TrialRecord[];
-
-/** An annotation drawn over a curve plot: a shaded band across a range of x,
- *  or a vertical line at one x. */
-type CurveMark = {
-    kind: 'band';
-    x: [number, number];
-    color?: string;
-} | {
-    kind: 'line';
-    x: number;
-    color?: string;
-};
-/** Props for `<CurveField>`. */
-interface CurveFieldProps {
-    /** Flat [x0, y0, x1, y1, …] — matches how curve-as-array configs
-     *  serialize in JSON snapshots. */
-    values: number[];
-    min: number;
-    max: number;
-    step: number;
-    /** Plot width in CSS px. Caller sizes (typically uses a ResizeObserver). */
-    width: number;
-    /** Plot height in CSS px. Default 110. */
-    height?: number;
-    /** Flat default curve. When provided, a Reset button restores it. */
-    defaults?: readonly number[];
-    onChange: (next: number[]) => void;
-    /** Optional vertical marks overlaid on the plot (e.g. landmarks). */
-    marks?: readonly CurveMark[];
-}
-/**
- * A function-domain (y = f(x), x ∈ [0,1]) curve editor with per-stop
- * numeric readouts and flip buttons. Wraps weasel-ui's
- * `CurveEditor`; consumers wanting the raw editor (2D paths,
- * custom anchors) should import it from `@weasel-js/labkit/weasel-ui`.
- */
-declare function CurveField({ values, min, max, step, width, height, defaults, onChange, marks, }: CurveFieldProps): react_jsx_runtime.JSX.Element;
-
-/** Props for `<Subpanel>`. */
-interface SubpanelProps {
-    title: ReactNode;
-    children: ReactNode;
-    className?: string;
-}
-/** A typographic divider inside a property list: a small title flanked by a
- *  rule. Purely a heading — use `<PropertyGroup>` for a bordered section. */
-declare function Subpanel({ title, children, className }: SubpanelProps): react_jsx_runtime.JSX.Element;
-/** Props for `<EffectCard>`. */
-interface EffectCardProps {
-    /** Card title rendered in the title bar (e.g. effect kind label or a select). */
-    title: ReactNode;
-    /** Optional badge/chip displayed before the remove button (e.g. primary value summary). */
-    primary?: ReactNode;
-    /** Optional accent color in any CSS color form. Sets --lk-panel-accent on the card. */
-    accent?: string;
-    /** Optional ordinal badge that doubles as the drag handle (used by tail cards in SB). */
-    index?: number;
-    expanded?: boolean;
-    onToggleExpanded?: () => void;
-    onRemove?: () => void;
-    /**
-     * Drag-handle wiring. When provided, an inline handle (⋮⋮ icon or `index`)
-     * activates HTML5 drag on press. Consumer owns the drag/drop coordination —
-     * see EffectCardList for the batteries-included wrapper.
-     */
-    draggable?: boolean;
-    onPressHandle?: () => void;
-    onReleaseHandle?: () => void;
-    onDragStart?: (e: React.DragEvent<HTMLDivElement>) => void;
-    onDragEnd?: (e: React.DragEvent<HTMLDivElement>) => void;
-    onDragOver?: (e: React.DragEvent<HTMLDivElement>) => void;
-    onDragLeave?: (e: React.DragEvent<HTMLDivElement>) => void;
-    onDrop?: (e: React.DragEvent<HTMLDivElement>) => void;
-    dragging?: boolean;
-    children?: ReactNode;
-    className?: string;
-}
-/** An accented, collapsible card for one item in a list of like things —
- *  effects, layers, tails. The accent color rebinds the theme accent token
- *  within the card, so its controls pick it up too. */
-declare function EffectCard({ title, primary, accent, index, expanded, onToggleExpanded, onRemove, draggable, onPressHandle, onReleaseHandle, onDragStart, onDragEnd, onDragOver, onDragLeave, onDrop, dragging, children, className, }: EffectCardProps): react_jsx_runtime.JSX.Element;
-/** The minimum an item must carry to appear in an `<EffectCardList>`. */
-interface EffectCardListItem {
-    id: string | number;
-}
-/** Props for `<EffectCardList>`. */
-interface EffectCardListProps<T extends EffectCardListItem> {
-    items: ReadonlyArray<T>;
-    renderItem: (item: T, helpers: {
-        isExpanded: boolean;
-        isDragging: boolean;
-        toggleExpanded: () => void;
-        cardProps: Pick<EffectCardProps, 'expanded' | 'dragging' | 'draggable' | 'onToggleExpanded' | 'onPressHandle' | 'onReleaseHandle' | 'onDragStart' | 'onDragEnd' | 'onDragOver' | 'onDragLeave' | 'onDrop'>;
-    }) => ReactNode;
-    onReorder: (sourceId: T['id'], targetId: T['id'], position: 'before' | 'after') => void;
-    /** Optional rendered when the list is empty. */
-    empty?: ReactNode;
-    /** IDs to render expanded on first mount. Defaults to all collapsed. */
-    defaultExpandedIds?: ReadonlyArray<T['id']>;
-}
-/** A drag-reorderable list of `<EffectCard>`s. Owns the expanded and dragging
- *  state and hands it back to `renderItem`, so the caller only supplies each
- *  card's contents. */
-declare function EffectCardList<T extends EffectCardListItem>({ items, renderItem, onReorder, empty, defaultExpandedIds, }: EffectCardListProps<T>): react_jsx_runtime.JSX.Element;
-
-/** Props for `<PropertyGroup>`. */
-interface PropertyGroupProps {
-    /** Title rendered between two rules at the top of the group. */
-    title: ReactNode;
-    /** When true the group renders nothing — useful for conditional sections. */
-    hidden?: boolean;
-    children: ReactNode;
-    className?: string;
+    gap?: number;
+    padding?: number;
     /**
-     * How rows pack into the 2-column grid.
-     *   - `'auto-color'` (default): only color rows pair side-by-side; everything
-     *     else spans the full width.
-     *   - `'pairs'`: every row auto-places into the 2-column grid two-per-row.
+     * Fixed tiling extent. Omit in an app — the grid measures its own box. Supply
+     * it where nothing measures, notably jsdom: at a zero measurement the grid
+     * renders no tiles at all.
      */
-    pack?: 'auto-color' | 'pairs';
+    viewport?: {
+        w: number;
+        h: number;
+    };
 }
 /**
- * Visually-bordered group inside a PropertyList. Use to scope a set of
- * related rows under a heading (e.g. "Aqua", "Bevel", "Dome" sections
- * inside a fill effect's controls).
+ * Auto-balanced tiling of trials, `ceil(sqrt(n))` columns wide.
+ *
+ * Tiles are absolutely positioned at the rects `gridStrategy` computes, not
+ * laid out by CSS — `windease/styles.css` (folded into
+ * `@weasel-js/labkit/styles.css`) carries the rules that positioning depends on.
  */
-declare function PropertyGroup({ title, hidden, children, className, pack, }: PropertyGroupProps): react_jsx_runtime.JSX.Element | null;
+declare function Workspace({ children, ids, resizable, reorderable, onReorder, layout, onLayoutChange, gap, padding, viewport, }: WorkspaceProps): react_jsx_runtime.JSX.Element;
 
-/** Props for `<PropertyPanel>`. */
-interface PropertyPanelProps {
-    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 }: PropertyPanelProps): react_jsx_runtime.JSX.Element;
-/** How a property list packs its rows into two columns. */
-type PropertyListPack = 'auto-color' | 'pairs';
-/** Props for `<PropertyList>`. */
-interface PropertyListProps {
-    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, subpanels, and full-width children (`<hr>`, curve blocks)
-     *     still span via `lk-property-list__span`. Right for dense effect bodies.
-     */
-    pack?: PropertyListPack;
-}
+/** The 2D view labkit has always shipped, and what a trial gets when it names no
+ *  other. Re-exported under its own name so a consumer can say which it means. */
+type ViewTransform2D = ViewTransform;
+declare const DEFAULT_VIEW: ViewTransform2D;
+/** A trial's view is opaque to labkit, so anything that needs the 2D shape — the
+ *  zoom chrome, `CanvasStack` — asks for it and handles not getting it. */
+declare function as2DView(view: unknown): ViewTransform2D | null;
+
+type TokenValue = string | number | readonly (string | number)[];
 /**
- * Grid container for PropertyRows. Use standalone for chrome-less layouts, or
- * nest inside <PropertyPanel/> for the standard glass card.
+ * A single design token as authored, before aliases are resolved: a DTCG-shaped
+ * `{ type, value }` pair where `value` may still be a `{ref}` to another token.
  */
-declare function PropertyList({ children, className, pack }: PropertyListProps): 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 {
-    label: ReactNode;
-    /** Right-aligned readout shown next to the label (e.g. current value). */
-    readout?: ReactNode;
-    variant?: PropertyRowVariant;
-    /**
-     * Label position relative to the control. "block" (default) stacks
-     * label above control; "inline" places the label to the left.
-     * Color and checkbox variants are always inline by their own nature.
-     */
-    layout?: PropertyRowLayout;
-    children: ReactNode;
-    htmlFor?: string;
-    className?: string;
-}
-/** 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, variant, layout, children, htmlFor, className, }: PropertyRowProps): react_jsx_runtime.JSX.Element;
-/** Props for `<SliderRow>`. */
-interface SliderRowProps {
-    label: ReactNode;
-    value: number;
-    min: number;
-    max: number;
-    step?: number;
-    onChange: (next: number) => void;
-    /** Override how the value is rendered next to the label. Defaults to `value.toString()`. */
-    format?: (value: number) => ReactNode;
-    /**
-     * 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;
-}
-/** A bounded number edited by dragging, with a live readout whose precision
- *  follows `step`. */
-declare function SliderRow({ label, value, min, max, step, onChange, format, unit, layout, }: SliderRowProps): react_jsx_runtime.JSX.Element;
-/** Props for `<ColorRow>`. */
-interface ColorRowProps {
-    label: ReactNode;
-    value: string;
-    onChange: (next: string) => void;
-    /** 0..1 alpha. When provided, a translucent slider renders beneath the swatch. */
-    alpha?: number;
-    onAlphaChange?: (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;
-}
-/** A color swatch, optionally with an alpha slider beneath it. */
-declare function ColorRow({ label, value, onChange, alpha, onAlphaChange, alphaDisabled, }: ColorRowProps): react_jsx_runtime.JSX.Element;
-/** Props for `<CheckboxRow>`. */
-interface CheckboxRowProps {
-    label: ReactNode;
-    value: boolean;
-    onChange: (next: boolean) => void;
-}
-/** A boolean checkbox. */
-declare function CheckboxRow({ label, value, onChange }: CheckboxRowProps): react_jsx_runtime.JSX.Element;
-/** Props for `<TextRow>`. */
-interface TextRowProps {
-    label: ReactNode;
-    value: string;
-    onChange: (next: string) => void;
-    placeholder?: string;
-    maxLength?: number;
-    layout?: PropertyRowLayout;
+interface RawToken {
+    readonly type: string;
+    readonly value: TokenValue;
+    /** Render the referenced color at this alpha, 0–1. */
+    readonly alpha?: number | undefined;
+    readonly description?: string | undefined;
 }
-/** A single-line text input. */
-declare function TextRow({ label, value, onChange, placeholder, maxLength, layout }: TextRowProps): react_jsx_runtime.JSX.Element;
-/** Props for `<NumberRow>`. */
-interface NumberRowProps {
-    label: ReactNode;
-    value: number;
-    onChange: (next: number) => void;
-    min?: number;
-    max?: number;
-    step?: number;
-    placeholder?: string;
-    layout?: PropertyRowLayout;
+/** A token graph flattened to one level, keyed by token name (no `--wzl-`
+ *  prefix). Still unresolved — see `ResolvedTokenMap` for the output side. */
+type FlatTokens = Record<string, RawToken>;
+
+/**
+ * A theme: a named set of design tokens, organized into a mode-invariant layer
+ * plus one layer per mode (light, dark, …), optionally extending another theme.
+ * Tokens are held unresolved — aliases between them are collapsed later by
+ * `resolveTheme`, so an override of a base primitive still reaches everything
+ * that references it.
+ */
+interface Theme {
+    readonly name: string;
+    readonly extends: Theme | null;
+    readonly defaultMode: string;
+    readonly tokens: FlatTokens;
+    readonly modes: Readonly<Record<string, FlatTokens>>;
 }
-/** A number typed directly. Reach for `<SliderRow>` when the range matters
- *  more than the exact value. */
-declare function NumberRow({ label, value, onChange, min, max, step, placeholder, layout, }: NumberRowProps): react_jsx_runtime.JSX.Element;
-interface SelectOption<T extends string> {
-    value: T;
-    label: ReactNode;
+
+/**
+ * labkit's theme: a cosmic dark and a warm parchment light, extending the
+ * built-in weasel theme. Authored as DTCG and loaded at import time — the
+ * interchange path a theme exported from a design tool would take.
+ */
+declare const interstellarTheme: Theme;
+
+/** Props for `<Trial>`. */
+interface TrialProps {
+    id: string;
+    /** Contributions the lab adds to this trial's chrome, merged after the
+     *  instrument's own. */
+    chrome?: readonly TrialContribution[];
+    /** Built-in contribution ids to drop. Throws on an id that is not there. */
+    suppress?: readonly string[];
 }
-/** Props for `<SelectRow>`. */
-interface SelectRowProps<T extends string> {
-    label: ReactNode;
-    value: T;
-    options: ReadonlyArray<SelectOption<T>>;
-    onChange: (next: T) => void;
-    layout?: PropertyRowLayout;
+/** Renders one trial from the lab store: looks up its record and
+ *  instrument, and mounts the instrument inside the trial chrome. */
+declare function Trial({ id, chrome, suppress }: TrialProps): react_jsx_runtime.JSX.Element;
+
+interface UndoBindings {
+    canUndo: boolean;
+    canRedo: boolean;
+    undo: () => void;
+    redo: () => 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, value, options, onChange, layout, }: SelectRowProps<T>): react_jsx_runtime.JSX.Element;
-/** Props for `<ToggleRow>`. */
-interface ToggleRowProps<T extends string> {
-    label: ReactNode;
-    value: T;
-    options: ReadonlyArray<SelectOption<T>>;
-    onChange: (next: T) => void;
-    layout?: PropertyRowLayout;
+/** Props for `<TrialChrome>`. */
+interface TrialChromeProps {
+    trialId: string;
+    record: TrialRecord;
+    instrument: Instrument;
+    isLastTrial: boolean;
+    undoBindings?: UndoBindings;
+    /** Supplied when the instrument declares a `job`. */
+    job?: JobHandle;
+    /** Contributions the trial runtime itself adds — the drag palette and the
+     *  layer list, which depend on runtime state the instrument cannot reach. */
+    trialChrome?: readonly TrialContribution[];
+    /** Contributions from the lab, merged last. */
+    chrome?: readonly TrialContribution[];
+    /** Built-in contribution ids to drop. Throws on an id that is not there. */
+    suppress?: readonly string[];
+    /** The trial's resolved tool slot, and the setter that writes whichever
+     *  slot it resolved to. `Trial` owns the resolution. */
+    activeToolId?: string | null;
+    setActiveTool?: (id: string) => void;
+    children: ReactNode;
 }
-/** A segmented control: the same choice as a select, with every option
- *  visible at once. */
-declare function ToggleRow<T extends string>({ label, value, options, onChange, layout, }: ToggleRowProps<T>): react_jsx_runtime.JSX.Element;
+/** The frame around a running instrument. Builds one chrome context, assembles
+ *  the contributions the instrument, the runtime and the lab declare, and hands
+ *  each region its slice. */
+declare function TrialChrome({ trialId, record, instrument, isLastTrial, undoBindings, job, trialChrome, chrome, suppress, activeToolId, setActiveTool, children, }: TrialChromeProps): react_jsx_runtime.JSX.Element;
+
+/** Append a new trial running `instrumentName`, at that instrument's
+ *  default config and initial state. */
+declare function addTrial(trials: TrialRecord[], instruments: InstrumentList, instrumentName: string): TrialRecord[];
+/** Insert a deep copy of a trial directly after it. The copy starts with
+ *  an empty undo history — the original's is not shared. */
+declare function cloneTrial(trials: TrialRecord[], id: string): TrialRecord[];
+/** Remove a trial, unless it is the last one — a lab always has at least
+ *  one. */
+declare function closeTrial(trials: TrialRecord[], id: string): TrialRecord[];
+/** Return a trial to its instrument's defaults, keeping its id and its
+ *  place in the list. */
+declare function resetTrial(trials: TrialRecord[], id: string, instruments: InstrumentList): TrialRecord[];
+/**
+ * Reorder to match `ids`. Ids the list doesn't mention keep their relative
+ * order at the end, and ids it names that no longer exist are dropped — a
+ * reorder that raced a close should not resurrect the closed trial.
+ */
+declare function reorderTrials(trials: TrialRecord[], ids: readonly string[]): TrialRecord[];
 
-export { Annotations, CheckboxRow, ColorRow, ConfigField, ConfigNode, ConfigOption, ConfigRule, ConfigRuleContext, ConfigSchema, ControlRenderer, CurveField, DEFAULT_VIEW, EffectCard, EffectCardList, InferConfig, Instrument, InstrumentList, JobHandle, Lab, LabContext, LabMode, LabPalette, LabShell, LeafPatch, NodeOptions, NumberRow, PITCH_LIMIT, PropertyGroup, PropertyList, PropertyPanel, PropertyRow, ResolvedConfig, SavedSnapshot, SelectRow, SliderRow, StorageAdapter, Subpanel, TextRow, ToggleRow, Trial, TrialChrome, TrialContribution, TrialRecord, TrialTool, ViewTransform, Workspace, addTrial, applyRules, as2DView, builtinRules, clampPitch, cloneTrial, closeTrial, defineInstrument, f, fromConfigFields, interstellarTheme, isLeafVisible, orbitAfterDrag, orbitAfterWheel, reorderTrials, resetTrial, resolveConfigSchema, titleCase, useConfigSchema, useLabContext, useOrbit, validateConfigSchema, wrapYaw };
-export type { CheckboxRowProps, ColorRowProps, CurveFieldProps, CurveMark, EffectCardListItem, EffectCardListProps, EffectCardProps, InstrumentSpec, LabContextValue, LabPaletteProps, LabProps, LabShellProps, NumberRowProps, OrbitHandlers, OrbitView, PropertyGroupProps, PropertyListPack, PropertyListProps, PropertyPanelProps, PropertyRowLayout, PropertyRowProps, PropertyRowVariant, SelectRowProps, SliderRowProps, SubpanelProps, TextRowProps, ToggleRowProps, TrialChromeProps, TrialProps, UndoBindings, UseOrbitOptions, ValidationResult, Vec3, ViewTransform2D, WorkspaceProps };
+export { Annotations, CheckboxRow, ColorRow, ConfigField, ConfigNode, ConfigOption, ConfigRule, ConfigRuleContext, ConfigSchema, ControlRenderer, CurveField, DEFAULT_VIEW, EffectCard, EffectCardList, InferConfig, Instrument, InstrumentList, JobHandle, Lab, LabContext, LabMode, LabPalette, LabShell, LeafPatch, NodeOptions, NumberRow, PITCH_LIMIT, PropertyGroup, PropertyList, PropertyPanel, PropertyRow, PropertySpan, ResolvedConfig, SavedSnapshot, SelectRow, SliderRow, StorageAdapter, Subpanel, TextRow, ToggleRow, Trial, TrialChrome, TrialContribution, TrialRecord, TrialTool, ViewTransform, Workspace, addTrial, applyRules, as2DView, builtinRules, clampPitch, cloneTrial, closeTrial, defineInstrument, f, fromConfigFields, interstellarTheme, isLeafVisible, orbitAfterDrag, orbitAfterWheel, reorderTrials, resetTrial, resolveConfigSchema, titleCase, useConfigSchema, useLabContext, useOrbit, validateConfigSchema, wrapYaw };
+export type { CheckboxRowProps, ColorRowProps, CurveFieldProps, CurveMark, EffectCardListItem, EffectCardListProps, EffectCardProps, InstrumentSpec, LabContextValue, LabPaletteProps, LabProps, LabShellProps, NumberRowProps, OrbitHandlers, OrbitView, PropertyGroupProps, PropertyListPack, PropertyListProps, PropertyOption, PropertyPanelProps, PropertyRowLayout, PropertyRowProps, PropertyRowVariant, PropertySpanProps, SelectRowProps, SliderRowProps, SubpanelProps, TextRowProps, ToggleRowProps, TrialChromeProps, TrialLayout, TrialProps, UndoBindings, UseOrbitOptions, ValidationResult, Vec3, ViewTransform2D, WorkspaceProps };