@weasel-js/labkit 1.5.0 → 1.5.1

package/dist/_dts/{frac-8R6UmlvN.d.ts → frac-B4okC2lX.d.ts}

@@ -1,5 +1,5 @@
 import { ComponentType, ReactNode, RefObject } from 'react';
-import { C as ConfigPath, V as ValueAtPath, R as ResolvedConfig, a as ConfigField, b as ConfigSchema } from './types-Ca2LCnPq.js';
+import { R as ResolvedConfig, C as ConfigPath, V as ValueAtPath, a as ConfigField, b as ConfigSchema } from './types-DzoNY1pO.js';
 import { J as JobHandle, a as JobCapability } from './types-DJ79Tg5J.js';
 import { Scene } from '@weasel-js/core';
 
@@ -31,6 +31,18 @@ declare function resolveFrame(spec: WorldSpec | undefined, size: ViewportSize):
  *  `draw` works in them. Must stay the exact inverse of `screenToWorld`. */
 declare function applyCamera(ctx: CanvasRenderingContext2D, view: ViewTransform, frame?: WorldFrame): void;
 
+/**
+ * Written at a config path to mean "do not pin this — let the instrument
+ * decide". Accepted by `setConfig`, by a trial's `configSeed`, and by
+ * `.initial()` in a schema. It is normalized into the trial's set of unpinned
+ * paths on the way into the store and is never itself stored, so a serialized
+ * trial contains no sentinel and the last pinned value survives.
+ */
+declare const auto: unique symbol;
+/** The type of the `auto` sentinel, for widening a value parameter. */
+type Auto = typeof auto;
+declare function isAuto(value: unknown): value is Auto;
+
 /** A sidebar section torn out of its trial, and where it went. */
 interface UndockedPanel {
     trialId: string;
@@ -73,6 +85,15 @@ interface TrialRecord<TS = unknown, TC = unknown, TV = unknown> {
      *  defaults. Kept so Reset restores the trial's own subject rather than the
      *  bare defaults. */
     configSeed?: Partial<TC>;
+    /** Dotted paths the trial's seed config opened as auto. Kept beside
+     *  `configSeed`, which cannot carry them: the sentinel is stripped on the way
+     *  in, so Reset would otherwise have no way back to the state the trial
+     *  opened in. Absent means none. */
+    autoSeed?: readonly string[];
+    /** Dotted paths this trial has unpinned. The value at such a path stays in
+     *  `config` — it is what the field pins back to — but the instrument reads
+     *  the resolver's value, or `undefined`, instead. Absent means none. */
+    auto?: readonly string[];
     /** This trial's own tool slot. Undefined means it reads the lab's. */
     activeToolId?: string | null;
     /** The extent the trial's sidebar was last dragged to, in pixels. Undefined
@@ -101,6 +122,10 @@ interface SavedSnapshot {
     instrumentName: string;
     config: unknown;
     state: unknown;
+    /** The trial's `auto` paths when saved; empty means every field was pinned.
+     *  Absent on a snapshot saved before snapshots carried them, which loads
+     *  over the trial's current set rather than guessing one. */
+    auto?: readonly string[];
     savedAt: number;
 }
 /** `auto` follows the OS; the other two are an explicit choice. */
@@ -147,9 +172,14 @@ interface TrialStateHandle<TS, TC> {
     state: TS;
     setState: (next: TS | ((prev: TS) => TS)) => void;
     config: TC;
+    /** The config as stored, before any auto path is resolved. What the control
+     *  panel renders, so a ghosted control sits at the value it pins back to. */
+    raw: TC;
+    /** Dotted paths this trial has unpinned. */
+    auto: ReadonlySet<string>;
     /** Write one config value, by dotted path — `'grid.size'` for a leaf under
      *  an `f.group`, `'cellSize'` for one at the root. */
-    setConfig: <P extends ConfigPath<TC> & string>(path: P, value: ValueAtPath<TC, P>) => void;
+    setConfig: <P extends ConfigPath<TC> & string>(path: P, value: ValueAtPath<TC, P> | Auto) => void;
 }
 /** Options for `createLabStore`, which knows nothing about storage. */
 interface CreateLabStoreOptions {
@@ -164,6 +194,10 @@ interface CreateLabStoreOptions {
     /** Each instrument's `migrateConfig`, keyed by instrument name, run on a
      *  stored config before its defaults fill it. */
     configMigrations?: Record<string, (stored: unknown) => unknown>;
+    /** Each instrument's resolved config schema, keyed by instrument name. What
+     *  a trial's auto paths are read against, away from the lab that would
+     *  otherwise supply the rules. */
+    configSchemas?: Record<string, ResolvedConfig>;
     /** How each instrument's state survives a reload. Hydration is the first
      *  thing `createLabStore` does, so these have to arrive with the store. */
     serializers?: InstrumentSerializers;
@@ -176,6 +210,7 @@ interface InstrumentHooks {
     serializers: InstrumentSerializers;
     configDefaults: Record<string, () => unknown>;
     configMigrations: Record<string, (stored: unknown) => unknown>;
+    configSchemas: Record<string, ResolvedConfig>;
 }
 /** Per-instrument serialize/deserialize hooks, keyed by instrument name. An
  *  instrument whose state is already JSON-safe needs no entry. `deserialize`
@@ -368,6 +403,9 @@ interface TrialChromeContext extends ToolSlotContext, SidebarSlotContext {
      *  `config`, since a builder schema has no `ConfigField[]` form. */
     configFields: ConfigField[];
     config: unknown;
+    /** The trial's unpinned paths. `config` stays raw, so a control drawn from
+     *  it sits at the value un-pinning writes back. */
+    auto: ReadonlySet<string>;
     setConfig: (key: string, value: unknown) => void;
     /** Which of this trial's collapsible sections are folded. A sidebar
      *  section's key is its contribution id; a section *inside* a contribution —
@@ -980,5 +1018,5 @@ declare function fracContains(box: FracRect, pt: FracPoint, tol?: number): boole
  *  answers false for two rects that merely overlap. */
 declare function fracEncloses(outer: FracRect, inner: FracRect): boolean;
 
-export { DEFAULT_FRAME as D, LOUPE_DEFAULTS as a7, resolveLoupe as aA, roundFrac as aB, worldToFrac as aC, annotationsFromJSON as au, createAnnotationScene as av, createAnnotationStore as aw, fracContains as ax, fracEncloses as ay, fracToWorld as az, applyCamera as b, dockPanel as j, panelKey as p, resolveFrame as r, undockPanel as u };
-export type { CanvasCapability as $, AnnotationData as A, AnnotationTarget as B, CreateLabStoreOptions as C, AnnotationsApi as E, AnnotationsCapability as F, TrialInfo as G, TrialTool as H, InstrumentSerializers as I, AnnotationKind as J, Instrument as K, LabDocument as L, Migration as M, TrialContribution as N, Annotation as O, PaletteItem as P, AnnotationInit as Q, AnnotationPatch as R, SerializedTrial as S, TrialRecord as T, UndoStack as U, ViewportSize as V, WorldFrame as W, AnnotationQuery as X, AnnotationStatus as Y, AnnotationStoreOptions as Z, AnnotationTargetInfo as _, WorldSpec as a, CanvasLayer as a0, CaptureDeps as a1, ContributionBase as a2, FracPoint as a3, FracRect as a4, HitResult as a5, IconComponent as a6, LayerCapability as a8, LayerDescriptor as a9, LoupePoint as aD, LoupeMode as aE, LoupeCapability as aa, LoupeDeclaration as ab, LoupeRenderArgs as ac, RegionContribution as ad, RenderContext as ae, ResolvedLoupe as af, SerializedAnnotations as ag, SidebarSection as ah, SidebarSlotContext as ai, StageCapability as aj, StatusReadout as ak, SystemEvent as al, ToolCapability as am, ToolItem as an, ToolSlotContext as ao, ToolbarItem as ap, TrialChromeContext as aq, TrialRegion as ar, UndoCapability as as, ViewportControl as at, StorageAdapter as c, LabStoreState as d, SavedSnapshot as e, StorageChange as f, TrialStateHandle as g, UndockedPanel as h, UndockedPanels as i, ViewTransform as k, Point as l, DragFeedback as m, DragDropCapability as n, LabMode as o, InstrumentList as q, InstrumentHooks as s, WorldRect as t, AnnotationMeaning as v, MarkScene as w, CaptureSource as x, CaptureOptions as y, CaptureResult as z };
+export { DEFAULT_FRAME as D, LOUPE_DEFAULTS as a8, fracEncloses as aA, fracToWorld as aB, isAuto as aC, resolveLoupe as aD, roundFrac as aE, worldToFrac as aF, annotationsFromJSON as av, auto as aw, createAnnotationScene as ax, createAnnotationStore as ay, fracContains as az, applyCamera as b, dockPanel as j, panelKey as p, resolveFrame as r, undockPanel as u };
+export type { Auto as $, AnnotationData as A, AnnotationTarget as B, CreateLabStoreOptions as C, AnnotationsApi as E, AnnotationsCapability as F, TrialInfo as G, TrialTool as H, InstrumentSerializers as I, AnnotationKind as J, Instrument as K, LabDocument as L, Migration as M, TrialContribution as N, Annotation as O, PaletteItem as P, AnnotationInit as Q, AnnotationPatch as R, SerializedTrial as S, TrialRecord as T, UndoStack as U, ViewportSize as V, WorldFrame as W, AnnotationQuery as X, AnnotationStatus as Y, AnnotationStoreOptions as Z, AnnotationTargetInfo as _, WorldSpec as a, CanvasCapability as a0, CanvasLayer as a1, CaptureDeps as a2, ContributionBase as a3, FracPoint as a4, FracRect as a5, HitResult as a6, IconComponent as a7, LayerCapability as a9, LoupePoint as aG, LoupeMode as aH, LayerDescriptor as aa, LoupeCapability as ab, LoupeDeclaration as ac, LoupeRenderArgs as ad, RegionContribution as ae, RenderContext as af, ResolvedLoupe as ag, SerializedAnnotations as ah, SidebarSection as ai, SidebarSlotContext as aj, StageCapability as ak, StatusReadout as al, SystemEvent as am, ToolCapability as an, ToolItem as ao, ToolSlotContext as ap, ToolbarItem as aq, TrialChromeContext as ar, TrialRegion as as, UndoCapability as at, ViewportControl as au, StorageAdapter as c, LabStoreState as d, SavedSnapshot as e, StorageChange as f, TrialStateHandle as g, UndockedPanel as h, UndockedPanels as i, ViewTransform as k, Point as l, DragFeedback as m, DragDropCapability as n, LabMode as o, InstrumentList as q, InstrumentHooks as s, WorldRect as t, AnnotationMeaning as v, MarkScene as w, CaptureSource as x, CaptureOptions as y, CaptureResult as z };

package/dist/_dts/{index-retnAut7.d.ts → index-BNdz-tNd.d.ts}

@@ -1,7 +1,7 @@
 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-Ca2LCnPq.js';
+import { R as ResolvedConfig, a as ConfigField, d as ControlRenderer } from './types-DzoNY1pO.js';
 
 /**
  * How much room a container gives its rows — gaps, padding, and field height,
@@ -100,11 +100,25 @@ interface PropertyRowProps extends PropertyMetricProps {
     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. Draws
+     *  the control ghosted and colorless. */
+    auto?: boolean;
+    /** Given, the row carries a pin dot that toggles `auto`. Omitted, the row can
+     *  show an auto state but not change it. */
+    onAutoChange?: (next: boolean) => void;
+    /** Marks the row's element for a panel-level gesture handler. `PropertyRow`
+     *  does not spread unknown props, so this is declared rather than inherited. */
+    'data-auto-path'?: 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, density, align, }: PropertyRowProps): react_jsx_runtime.JSX.Element;
+declare function PropertyRow({ label, readout, description, variant, layout, span, children, htmlFor, group, className, density, align, auto, onAutoChange, 'data-auto-path': autoPath, }: PropertyRowProps): react_jsx_runtime.JSX.Element;
 /** Props for `<SliderRow>`. */
 interface SliderRowProps extends PropertyMetricProps {
     label: ReactNode;
@@ -126,6 +140,12 @@ interface SliderRowProps extends PropertyMetricProps {
     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 · 18`, 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;
     /**
@@ -138,10 +158,16 @@ interface SliderRowProps extends PropertyMetricProps {
     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 a pin dot — see `<PropertyRow onAutoChange>`. */
+    onAutoChange?: (next: boolean) => void;
+    /** Marks the row for a panel-level gesture handler — see `<PropertyRow data-auto-path>`. */
+    'data-auto-path'?: string;
 }
 /** 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, notation, unit, layout, description, span, density, align, }: SliderRowProps): react_jsx_runtime.JSX.Element;
+declare function SliderRow({ label, value, min, max, step, onChange, onInput, format, readout, notation, unit, layout, description, span, density, align, auto, onAutoChange, 'data-auto-path': autoPath, }: SliderRowProps): react_jsx_runtime.JSX.Element;
 /** Props for `<ColorRow>`. */
 interface ColorRowProps extends PropertyMetricProps {
     label: ReactNode;
@@ -172,11 +198,19 @@ interface ColorRowProps extends PropertyMetricProps {
     /** 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 a pin dot — see `<PropertyRow onAutoChange>`. */
+    onAutoChange?: (next: boolean) => void;
+    /** Marks the row for a panel-level gesture handler — see `<PropertyRow data-auto-path>`. */
+    'data-auto-path'?: string;
 }
 /** A color swatch, optionally with an alpha slider beneath it. */
-declare function ColorRow({ label, value, onChange, onInput, alpha, onAlphaChange, onAlphaInput, alphaDisabled, layout, description, span, density, align, }: ColorRowProps): react_jsx_runtime.JSX.Element;
+declare function ColorRow({ label, readout, value, onChange, onInput, alpha, onAlphaChange, onAlphaInput, alphaDisabled, layout, description, span, density, align, auto, onAutoChange, 'data-auto-path': autoPath, }: ColorRowProps): react_jsx_runtime.JSX.Element;
 /** Props for `<CheckboxRow>`. */
 interface CheckboxRowProps extends PropertyMetricProps {
     label: ReactNode;
@@ -186,11 +220,19 @@ interface CheckboxRowProps extends PropertyMetricProps {
     /** 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 a pin dot — see `<PropertyRow onAutoChange>`. */
+    onAutoChange?: (next: boolean) => void;
+    /** Marks the row for a panel-level gesture handler — see `<PropertyRow data-auto-path>`. */
+    'data-auto-path'?: string;
 }
 /** A boolean checkbox. */
-declare function CheckboxRow({ label, value, onChange, layout, span, description, density, align, }: CheckboxRowProps): react_jsx_runtime.JSX.Element;
+declare function CheckboxRow({ label, readout, value, onChange, layout, span, description, density, align, auto, onAutoChange, 'data-auto-path': autoPath, }: CheckboxRowProps): react_jsx_runtime.JSX.Element;
 /** Props for `<TextRow>`. */
 interface TextRowProps extends PropertyMetricProps {
     label: ReactNode;
@@ -201,11 +243,19 @@ interface TextRowProps extends PropertyMetricProps {
     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 a pin dot — see `<PropertyRow onAutoChange>`. */
+    onAutoChange?: (next: boolean) => void;
+    /** Marks the row for a panel-level gesture handler — see `<PropertyRow data-auto-path>`. */
+    'data-auto-path'?: string;
 }
 /** A single-line text input. */
-declare function TextRow({ label, value, onChange, placeholder, maxLength, layout, description, span, density, align, }: TextRowProps): react_jsx_runtime.JSX.Element;
+declare function TextRow({ label, readout, value, onChange, placeholder, maxLength, layout, description, span, density, align, auto, onAutoChange, 'data-auto-path': autoPath, }: TextRowProps): react_jsx_runtime.JSX.Element;
 /** Props for `<NumberRow>`. */
 interface NumberRowProps extends PropertyMetricProps {
     label: ReactNode;
@@ -235,12 +285,20 @@ interface NumberRowProps extends PropertyMetricProps {
     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 a pin dot — see `<PropertyRow onAutoChange>`. */
+    onAutoChange?: (next: boolean) => void;
+    /** Marks the row for a panel-level gesture handler — see `<PropertyRow data-auto-path>`. */
+    'data-auto-path'?: string;
 }
 /** A number typed directly. Reach for `<SliderRow>` when the range matters
  *  more than the exact value. */
-declare function NumberRow({ label, value, onChange, onInput, min, max, step, placeholder, unit, layout, description, span, density, align, }: NumberRowProps): react_jsx_runtime.JSX.Element;
+declare function NumberRow({ label, readout, value, onChange, onInput, min, max, step, placeholder, unit, layout, description, span, density, align, auto, onAutoChange, 'data-auto-path': autoPath, }: NumberRowProps): react_jsx_runtime.JSX.Element;
 interface PropertyOption<T extends string> {
     value: T;
     label: ReactNode;
@@ -256,12 +314,20 @@ interface SelectRowProps<T extends string> extends PropertyMetricProps {
     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 a pin dot — see `<PropertyRow onAutoChange>`. */
+    onAutoChange?: (next: boolean) => void;
+    /** Marks the row for a panel-level gesture handler — see `<PropertyRow data-auto-path>`. */
+    'data-auto-path'?: 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, placeholder, layout, description, span, density, align, }: SelectRowProps<T>): react_jsx_runtime.JSX.Element;
+declare function SelectRow<T extends string>({ label, readout, value, options, onChange, placeholder, layout, description, span, density, align, auto, onAutoChange, 'data-auto-path': autoPath, }: SelectRowProps<T>): react_jsx_runtime.JSX.Element;
 /** Props for `<ToggleRow>`. */
 interface ToggleRowProps<T extends string> extends PropertyMetricProps {
     label: ReactNode;
@@ -270,12 +336,20 @@ interface ToggleRowProps<T extends string> extends PropertyMetricProps {
     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 a pin dot — see `<PropertyRow onAutoChange>`. */
+    onAutoChange?: (next: boolean) => void;
+    /** Marks the row for a panel-level gesture handler — see `<PropertyRow data-auto-path>`. */
+    'data-auto-path'?: 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, span, density, align, }: ToggleRowProps<T>): react_jsx_runtime.JSX.Element;
+declare function ToggleRow<T extends string>({ label, readout, value, options, onChange, layout, description, span, density, align, auto, onAutoChange, 'data-auto-path': autoPath, }: 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
@@ -330,6 +404,12 @@ interface ControlPanelProps<TC extends Record<string, unknown>> {
     /** 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 draws ghosted and its
+     *  dot reads as auto, and the dot writes the sentinel back through
+     *  `setConfig`. Omitted, the panel keeps the set itself: the dots still work
+     *  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;
@@ -337,7 +417,7 @@ interface ControlPanelProps<TC extends Record<string, unknown>> {
 /** 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, showHidden, className, }: ControlPanelProps<TC>): react_jsx_runtime.JSX.Element;
+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/_dts/{index-B8uu2ba7.d.ts → index-CSJoj4LC.d.ts}

@@ -1,5 +1,5 @@
-import { d as ControlRenderer, c as ConfigRule } from './types-Ca2LCnPq.js';
-import { K as Instrument, aq as TrialChromeContext, N as TrialContribution, T as TrialRecord, q as InstrumentList, e as SavedSnapshot, o as LabMode, ao as ToolSlotContext, a2 as ContributionBase, ap as ToolbarItem, an as ToolItem, ah as SidebarSection, ak as StatusReadout, H as TrialTool, ad as RegionContribution, ai as SidebarSlotContext } from './frac-8R6UmlvN.js';
+import { d as ControlRenderer, c as ConfigRule } from './types-DzoNY1pO.js';
+import { K as Instrument, ar as TrialChromeContext, N as TrialContribution, T as TrialRecord, q as InstrumentList, e as SavedSnapshot, o as LabMode, ap as ToolSlotContext, a3 as ContributionBase, aq as ToolbarItem, ao as ToolItem, ai as SidebarSection, al as StatusReadout, H as TrialTool, ae as RegionContribution, aj as SidebarSlotContext } from './frac-B4okC2lX.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
@@ -52,6 +52,14 @@ interface LabContextValue {
     closeTrial: (id: string) => void;
     resetTrial: (id: string) => void;
     reorderTrials: (ids: readonly string[]) => void;
+    /** Put a fresh trial running `instrumentName` in trial `id`'s place, at its
+     *  size. The replacement has a new id, and takes the focus if `id` had it. */
+    swapTrial: (id: string, instrumentName: string, options?: AddTrialOptions) => void;
+    /** The trial last pointed at or focused, counting focus that moved into a
+     *  frame inside it. A trial `addTrial` or `cloneTrial` opens takes it. Falls
+     *  back to the first trial; null only when there are none. */
+    focusedTrialId: string | null;
+    focusTrial: (id: string) => void;
     savedSnapshots: SavedSnapshot[];
     saveSnapshot: (trialId: string, name?: string) => void;
     loadSnapshot: (trialId: string, snapshotId: string) => void;
@@ -75,7 +83,7 @@ declare function useLabContext(): LabContextValue;
  * `<LabShell>` names them; `palette` is the tool rail down the side of the
  * workspace; `sidebar` is a column of sections left of the tool rail.
  */
-type LabRegion = 'header' | 'palette' | 'sidebar' | 'footer';
+type LabRegion = 'header' | 'palette' | 'sidebar' | 'aside' | 'footer';
 /**
  * Everything a lab-level contribution can read and command: the lab's own
  * state and operations, plus the lab's tool slot — which every trial whose
@@ -102,7 +110,7 @@ type LabContribution<TCtx = LabChromeContext> = (ContributionBase & {
     item: ToolItem;
     render?: never;
 }) | (ContributionBase & {
-    region: 'sidebar';
+    region: 'sidebar' | 'aside';
     item: SidebarSection;
     render?: never;
 }) | (ContributionBase & {
@@ -138,6 +146,9 @@ declare function LabHeaderRegion({ contributions }: LabRegionProps): react_jsx_r
 /** The lab's sidebar sections. Fold state is a lab-scoped persisted value, so it
  *  survives a reload in a stored lab and lasts the session in an unstored one. */
 declare function LabSidebarRegion({ contributions }: LabRegionProps): react_jsx_runtime.JSX.Element;
+/** The lab's aside sections, on the far side of the workspace from the sidebar.
+ *  Fold state persists the way the sidebar's does. */
+declare function LabAsideRegion({ contributions }: LabRegionProps): react_jsx_runtime.JSX.Element;
 /** The lab's readouts, in the shell footer below the workspace. */
 declare function LabFooterRegion({ contributions }: LabRegionProps): react_jsx_runtime.JSX.Element;
 
@@ -233,5 +244,5 @@ interface ViewportRegionProps {
  */
 declare function ViewportRegion({ contributions, ctx }: ViewportRegionProps): react_jsx_runtime.JSX.Element | null;
 
-export { suppressContributions as B, toolContributions as C, useLabChromeContext as D, useLabContext as E, PaletteRegion as P, SidebarRegion as S, ViewportRegion as V, LabContext as b, LabFooterRegion as d, LabHeaderRegion as e, LabSidebarRegion as h, StatusRegion as k, TitleBarRegion as m, ToolbarRegion as o, addTrial as r, builtinContributions as s, cloneTrial as t, closeTrial as u, contributionsIn as v, labContributions as w, mergeContributions as x, reorderTrials as y, resetTrial as z };
-export type { AddTrialOptions as A, LabContribution as L, TitleBarPlacement as T, LabChromeContext as a, LabContextValue as c, LabRegion as f, LabRegionProps as g, PaletteRegionProps as i, SidebarRegionProps as j, StatusRegionProps as l, TitleBarRegionProps as n, ToolbarRegionProps as p, ViewportRegionProps as q };
+export { resetTrial as B, suppressContributions as C, toolContributions as D, useLabChromeContext as E, useLabContext as F, PaletteRegion as P, SidebarRegion as S, ViewportRegion as V, LabAsideRegion as a, LabContext as c, LabFooterRegion as e, LabHeaderRegion as f, LabSidebarRegion as i, StatusRegion as l, TitleBarRegion as n, ToolbarRegion as p, addTrial as s, builtinContributions as t, cloneTrial as u, closeTrial as v, contributionsIn as w, labContributions as x, mergeContributions as y, reorderTrials as z };
+export type { AddTrialOptions as A, LabContribution as L, TitleBarPlacement as T, LabChromeContext as b, LabContextValue as d, LabRegion as g, LabRegionProps as h, PaletteRegionProps as j, SidebarRegionProps as k, StatusRegionProps as m, TitleBarRegionProps as o, ToolbarRegionProps as q, ViewportRegionProps as r };

package/dist/_dts/{types-Ca2LCnPq.d.ts → types-DzoNY1pO.d.ts}

@@ -1,5 +1,5 @@
-import { ToolPrefNumberFormat, ToolPrefLeaf, ToolPrefGroup } from '@weasel-js/core';
-import { P as PrefRenderer } from './PrefsForm.d-DDHFANkc.js';
+import { ToolPrefNumberFormat, ToolPrefNumberUnit, ToolPrefLeaf, ToolPrefGroup } from '@weasel-js/core';
+import { P as PrefRenderer } from './PrefsForm.d-DPy9I8It.js';
 
 /**
  * Renders the control cell for one config leaf. Identical to weasel-ui's
@@ -26,6 +26,11 @@ interface Annotations {
     suffix?: string;
     /** How a number's value is shown. `compact` abbreviates from a thousand up. */
     format?: ToolPrefNumberFormat;
+    /** Display-unit conversion for a number stored in a canonical unit — the
+     *  value, its bounds and its step all convert at the control's edge. */
+    unit?: ToolPrefNumberUnit;
+    /** A color leaf's value carries alpha (`#rrggbbaa`) and its row edits it. */
+    alpha?: boolean;
     control?: string;
     options?: readonly ConfigOption[];
     placeholder?: string;
@@ -73,6 +78,10 @@ interface SectionSpec {
      *  whether or not it was given a panel-wide `collapse`; a fold the reader
      *  has since toggled outranks it. */
     collapsed?: boolean;
+    /** Where the section's rows put their labels, over the panel's `layout`. */
+    layout?: 'block' | 'inline';
+    /** How the section packs its rows, over the panel's `pack`. */
+    pack?: 'auto' | 'pairs' | 'one-up';
 }
 /** A schema resolved against a set of rules: the vocabulary weasel-ui renders,
  *  plus the three things labkit keeps on the side because `PrefLeaf` has no
@@ -92,11 +101,26 @@ interface ResolvedConfig {
 interface SectionOption {
     label: string;
     collapsed?: boolean;
+    /** Where the section's rows put their labels, over the panel's `layout`. */
+    layout?: 'block' | 'inline';
+    /** How the section packs its rows, over the panel's `pack`. */
+    pack?: 'auto' | 'pairs' | 'one-up';
 }
 /** Per-node extras that do not belong on a `PrefLeaf`. */
 interface NodeOptions extends BranchOptions {
     render?: ControlRenderer;
-    validate?: (leaf: ToolPrefLeaf) => string[];
+    /** Errors for this leaf under `config`, the instrument's whole config. */
+    validate?: (leaf: ToolPrefLeaf, config: Record<string, unknown>) => string[];
+    /** Computes this leaf's value while it is auto. Attaching one is what lets
+     *  the ghosted control draw a real value and keeps the instrument off
+     *  `?? compute()`. */
+    autoResolve?: (config: Record<string, unknown>) => unknown;
+    /** The leaf starts auto rather than pinned at its default. Set by
+     *  `.initial(auto)`. */
+    unpinned?: boolean;
+    /** The leaf can never be auto: the row takes no pin dot and ignores the
+     *  gesture. For a value the instrument cannot receive as `undefined`. */
+    manual?: boolean;
 }
 /** What a branch can say about itself, beyond its children. */
 interface BranchOptions {
@@ -226,4 +250,4 @@ interface ColorField extends ConfigFieldBase {
  *  panel renders, and what `validateConfigSchema` checks. */
 type ConfigField = SliderField | CheckboxField | SelectField | NumberField | TextField | ColorField;
 
-export type { Annotations as A, BranchAnnotations as B, ConfigPath as C, EntryValue as E, InferConfig as I, LeafPatch as L, NodeOptions as N, ResolvedConfig as R, SectionSpec as S, TextField as T, ValueAtPath as V, ConfigField as a, ConfigSchema as b, ConfigRule as c, ControlRenderer as d, BranchOptions as e, CheckboxField as f, ColorField as g, ConfigBranch as h, ConfigEntry as i, ConfigFieldBase as j, ConfigFieldType as k, ConfigNode as l, ConfigOf as m, ConfigOption as n, ConfigRuleContext as o, ConfigShape as p, NodeValue as q, NumberField as r, SelectField as s, SelectOption as t, SliderField as u };
+export type { Annotations as A, BranchAnnotations as B, ConfigPath as C, EntryValue as E, InferConfig as I, LeafPatch as L, NodeOptions as N, ResolvedConfig as R, SectionSpec as S, TextField as T, ValueAtPath as V, ConfigField as a, ConfigSchema as b, ConfigRule as c, ControlRenderer as d, BranchOptions as e, CheckboxField as f, ColorField as g, ConfigBranch as h, ConfigEntry as i, ConfigFieldBase as j, ConfigFieldType as k, ConfigNode as l, ConfigOf as m, ConfigOption as n, ConfigRuleContext as o, ConfigShape as p, NodeValue as q, NumberField as r, SelectField as s, SelectOption as t, SliderField as u, SectionOption as v };

package/dist/_dts/{usePanZoom-nS798rOF.d.ts → usePanZoom-Pzf9f2jh.d.ts}

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, WheelEvent, PointerEvent as PointerEvent$1 } from 'react';
-import { k as ViewTransform, a as WorldSpec, V as ViewportSize, l as Point, W as WorldFrame } from './frac-8R6UmlvN.js';
-import { C as CanvasLayerDescriptor } from './CanvasStackContext-CqkxkFJW.js';
+import { k as ViewTransform, a as WorldSpec, V as ViewportSize, l as Point, W as WorldFrame } from './frac-B4okC2lX.js';
+import { C as CanvasLayerDescriptor } from './CanvasStackContext-CJNMS6mz.js';
 
 /** Props for `<CanvasStack>`. */
 interface CanvasStackProps {

package/dist/_dts/{useTrialState-jcx_TdU6.d.ts → useTrialState-uLlmaccn.d.ts}

@@ -1,4 +1,4 @@
-import { c as StorageAdapter, d as LabStoreState, T as TrialRecord, e as SavedSnapshot, o as LabMode, h as UndockedPanel, q as InstrumentList, s as InstrumentHooks, C as CreateLabStoreOptions, g as TrialStateHandle } from './frac-8R6UmlvN.js';
+import { c as StorageAdapter, d as LabStoreState, T as TrialRecord, e as SavedSnapshot, o as LabMode, h as UndockedPanel, q as InstrumentList, s as InstrumentHooks, C as CreateLabStoreOptions, g as TrialStateHandle } from './frac-B4okC2lX.js';
 import * as react from 'react';
 import { ReactNode, ReactElement, Dispatch, SetStateAction } from 'react';
 import { StoreApi } from 'zustand/vanilla';

package/dist/canvas/index.d.ts

@@ -1,11 +1,11 @@
 import * as react from 'react';
-export { C as CanvasStack, a as CanvasStackProps, O as OrbitHandlers, b as OrbitView, P as PITCH_LIMIT, c as PanZoomHandlers, S as Stage, d as StageProps, U as UseOrbitOptions, e as UsePanZoomOptions, V as Vec3, Z as ZoomAtOptions, f as centerOn, g as clampPitch, h as fitStage, o as orbitAfterDrag, i as orbitAfterWheel, s as screenToWorld, u as useOrbit, j as usePanZoom, w as worldToScreen, k as wrapYaw, z as zoomAt } from '../_dts/usePanZoom-nS798rOF.js';
-export { C as CanvasLayerDescriptor, a as CanvasStackContext, b as CanvasStackContextValue, c as CanvasStackSurface } from '../_dts/CanvasStackContext-CqkxkFJW.js';
-export { D as DEFAULT_FRAME, V as ViewportSize, W as WorldFrame, a as WorldSpec, b as applyCamera, r as resolveFrame } from '../_dts/frac-8R6UmlvN.js';
+export { C as CanvasStack, a as CanvasStackProps, O as OrbitHandlers, b as OrbitView, P as PITCH_LIMIT, c as PanZoomHandlers, S as Stage, d as StageProps, U as UseOrbitOptions, e as UsePanZoomOptions, V as Vec3, Z as ZoomAtOptions, f as centerOn, g as clampPitch, h as fitStage, o as orbitAfterDrag, i as orbitAfterWheel, s as screenToWorld, u as useOrbit, j as usePanZoom, w as worldToScreen, k as wrapYaw, z as zoomAt } from '../_dts/usePanZoom-Pzf9f2jh.js';
+export { C as CanvasLayerDescriptor, a as CanvasStackContext, b as CanvasStackContextValue, c as CanvasStackSurface } from '../_dts/CanvasStackContext-CJNMS6mz.js';
+export { D as DEFAULT_FRAME, V as ViewportSize, W as WorldFrame, a as WorldSpec, b as applyCamera, r as resolveFrame } from '../_dts/frac-B4okC2lX.js';
 import 'react/jsx-runtime';
-import '../_dts/types-Ca2LCnPq.js';
+import '../_dts/types-DzoNY1pO.js';
 import '@weasel-js/core';
-import '../_dts/PrefsForm.d-DDHFANkc.js';
+import '../_dts/PrefsForm.d-DPy9I8It.js';
 import '../_dts/types-DJ79Tg5J.js';
 
 /** Where a trial's camera takes a wheel event from outside its own element. */

package/dist/canvas/index.js

@@ -1,4 +1,4 @@
-export { CameraWheelContext, CanvasStack, PITCH_LIMIT, Stage, clampPitch, fitStage, orbitAfterDrag, orbitAfterWheel, useOrbit, usePanZoom, wrapYaw } from '../chunk-PGETSEDK.js';
+export { CameraWheelContext, CanvasStack, PITCH_LIMIT, Stage, clampPitch, fitStage, orbitAfterDrag, orbitAfterWheel, useOrbit, usePanZoom, wrapYaw } from '../chunk-CEIUBPPW.js';
 export { centerOn, zoomAt } from '../chunk-H6ZAOWNE.js';
 export { DEFAULT_FRAME, applyCamera, resolveFrame, screenToWorld, worldToScreen } from '../chunk-2AYGEN57.js';
 import '../chunk-WIG6XHJ7.js';

package/dist/chrome/index.d.ts

@@ -1,8 +1,8 @@
-export { a as LabChromeContext, L as LabContribution, d as LabFooterRegion, e as LabHeaderRegion, f as LabRegion, g as LabRegionProps, h as LabSidebarRegion, P as PaletteRegion, i as PaletteRegionProps, S as SidebarRegion, j as SidebarRegionProps, k as StatusRegion, l as StatusRegionProps, T as TitleBarPlacement, m as TitleBarRegion, n as TitleBarRegionProps, o as ToolbarRegion, p as ToolbarRegionProps, V as ViewportRegion, q as ViewportRegionProps, s as builtinContributions, v as contributionsIn, w as labContributions, x as mergeContributions, B as suppressContributions, C as toolContributions, D as useLabChromeContext } from '../_dts/index-B8uu2ba7.js';
-export { a2 as ContributionBase, a6 as IconComponent, ad as RegionContribution, ah as SidebarSection, ai as SidebarSlotContext, ak as StatusReadout, an as ToolItem, ao as ToolSlotContext, ap as ToolbarItem, aq as TrialChromeContext, N as TrialContribution, ar as TrialRegion, at as ViewportControl } from '../_dts/frac-8R6UmlvN.js';
-import '../_dts/types-Ca2LCnPq.js';
+export { a as LabAsideRegion, b as LabChromeContext, L as LabContribution, e as LabFooterRegion, f as LabHeaderRegion, g as LabRegion, h as LabRegionProps, i as LabSidebarRegion, P as PaletteRegion, j as PaletteRegionProps, S as SidebarRegion, k as SidebarRegionProps, l as StatusRegion, m as StatusRegionProps, T as TitleBarPlacement, n as TitleBarRegion, o as TitleBarRegionProps, p as ToolbarRegion, q as ToolbarRegionProps, V as ViewportRegion, r as ViewportRegionProps, t as builtinContributions, w as contributionsIn, x as labContributions, y as mergeContributions, C as suppressContributions, D as toolContributions, E as useLabChromeContext } from '../_dts/index-CSJoj4LC.js';
+export { a3 as ContributionBase, a7 as IconComponent, ae as RegionContribution, ai as SidebarSection, aj as SidebarSlotContext, al as StatusReadout, ao as ToolItem, ap as ToolSlotContext, aq as ToolbarItem, ar as TrialChromeContext, N as TrialContribution, as as TrialRegion, au as ViewportControl } from '../_dts/frac-B4okC2lX.js';
+import '../_dts/types-DzoNY1pO.js';
 import '@weasel-js/core';
-import '../_dts/PrefsForm.d-DDHFANkc.js';
+import '../_dts/PrefsForm.d-DPy9I8It.js';
 import 'react';
 import 'react/jsx-runtime';
 import '../_dts/types-DJ79Tg5J.js';

package/dist/chrome/index.js

@@ -1,13 +1,13 @@
-export { LabFooterRegion, LabHeaderRegion, LabSidebarRegion, PaletteRegion, SidebarRegion, StatusRegion, TitleBarRegion, ToolbarRegion, ViewportRegion, builtinContributions, contributionsIn, labContributions, mergeContributions, suppressContributions, toolContributions, useLabChromeContext } from '../chunk-NS64DXMN.js';
-import '../chunk-KJALCDWE.js';
+export { LabAsideRegion, LabFooterRegion, LabHeaderRegion, LabSidebarRegion, PaletteRegion, SidebarRegion, StatusRegion, TitleBarRegion, ToolbarRegion, ViewportRegion, builtinContributions, contributionsIn, labContributions, mergeContributions, suppressContributions, toolContributions, useLabChromeContext } from '../chunk-IHUVQ3TX.js';
+import '../chunk-UN4U4P63.js';
 import '../chunk-RWNDDKOH.js';
-import '../chunk-TQBBYTAF.js';
-import '../chunk-NDRYLVOW.js';
-import '../chunk-UU3NJO6N.js';
-import '../chunk-E44SU6XS.js';
+import '../chunk-EH7UEQV7.js';
+import '../chunk-Z76KEZAX.js';
+import '../chunk-PHK4W562.js';
+import '../chunk-7PFH3CNM.js';
 import '../chunk-CQLQPQ4P.js';
 import '../chunk-2YILQ7Y5.js';
 import '../chunk-SBXNQW4G.js';
-import '../chunk-S2SHZRD7.js';
+import '../chunk-T3EC2DXD.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map