@weasel-js/labkit 1.4.0 → 1.4.2

package/README.md

@@ -120,6 +120,14 @@ changed draws dashed and reports `isStale`. `meaning.statuses` is the optional
 vocabulary a mark can be labelled with — a status carries its own color, which
 the mark on the canvas follows.
 
+`targets` is declared once per instrument and called once per trial, with the
+asking trial as its third argument: `targets(state, config, trial)`. `trial.id`
+is the id `useTileId` scopes a surface tile under, so a consumer holding its own
+per-trial refs keys them by it and hands back the ones this trial owns; a
+module-level ref like the one above is one ref shared by every trial of the
+instrument, which only shows once a second trial is open. `trial.view` is that
+trial's camera.
+
 Marks live in the trial's record and survive a reload. An instrument that would
 rather keep them in a format it already owns declares `annotations.storage` with
 a `load`/`save` pair, and labkit never writes its own slot.

package/dist/_dts/{CanvasStackContext-D6M0o8cQ.d.ts → CanvasStackContext-kjILVnPj.d.ts}

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { RefObject } from 'react';
-import { V as ViewTransform, W as WorldFrame } from './frac-QS7XzvpG.js';
+import { V as ViewTransform, W as WorldFrame } from './frac-A4R6v4ld.js';
 
 /** One layer of a canvas stack: its id, whether it is currently shown, and how
  *  it paints itself. */

package/dist/_dts/PrefsForm.d-CgxUequc.d.ts

@@ -0,0 +1,20 @@
+import { ReactNode } from 'react';
+import { T as ToolPrefLeaf } from './weasel-canvas-FJTFi3ZZ.js';
+
+/** What a {@link PrefRenderer} is given for the leaf it is rendering. */
+interface PrefRenderContext {
+    /** Dotted path of the leaf within the schema root. */
+    path: string;
+    /** The schema node. App renderers narrow this to their own kind shape. */
+    pref: ToolPrefLeaf;
+    /** Current value — `values` at `path`, falling back to `pref.default`. */
+    value: unknown;
+    setValue: (value: unknown) => void;
+}
+/**
+ * Renders the control cell for one preference leaf. Returning `null`
+ * collapses the row.
+ */
+type PrefRenderer = (ctx: PrefRenderContext) => ReactNode;
+
+export type { PrefRenderer as P, PrefRenderContext as a };

package/dist/_dts/{frac-QS7XzvpG.d.ts → frac-A4R6v4ld.d.ts}

@@ -1,8 +1,8 @@
 import { ComponentType, ReactNode, RefObject } from 'react';
-import { R as ResolvedConfig, C as ConfigField, a as ConfigSchema } from './types-C1Zw7s5P.js';
-import { c as SavedSnapshot } from './types-ChVJJHvk.js';
+import { R as ResolvedConfig, C as ConfigField, a as ConfigSchema } from './types-lg4TSCb2.js';
+import { c as SavedSnapshot, i as TrialInfo } from './types-BbXpvQa8.js';
 import { J as JobHandle, a as JobCapability } from './types-DJ79Tg5J.js';
-import { S as Scene } from './types-C-gh9Ap-.js';
+import { S as Scene } from './weasel-canvas-FJTFi3ZZ.js';
 
 /** How an instrument's world sits on the canvas, independent of the camera.
  *  The defaults reproduce the convention labkit shipped before this existed:
@@ -53,7 +53,10 @@ interface ToolbarItem {
     pressed?: boolean;
     /** Render the label beside the glyph rather than only in the tooltip. */
     showLabel?: boolean;
-    onActivate: () => void;
+    /** Handed the trial's chrome context, so a contribution declared from the
+     *  lab can reach `ctx.saveSnapshot()` and the rest without the `render`
+     *  escape. A zero-argument handler stays valid. */
+    onActivate: (ctx: TrialChromeContext) => void;
 }
 /** A selectable tool in the palette region. */
 interface ToolItem {
@@ -65,7 +68,7 @@ interface ToolItem {
 /** A titled block in the sidebar. */
 interface SidebarSection {
     title: string;
-    /** Starts collapsed. The open/closed state itself is the region's. */
+    /** Starts collapsed, until the trial remembers a fold of its own. */
     defaultCollapsed?: boolean;
     /** Offer the tear-out control. On by default; a section that only makes
      *  sense beside its trial sets this false. */
@@ -79,7 +82,8 @@ interface ViewportControl {
     icon: IconComponent;
     label: string;
     disabled?: boolean;
-    onActivate: () => void;
+    /** Handed the trial's chrome context, as `ToolbarItem.onActivate` is. */
+    onActivate: (ctx: TrialChromeContext) => void;
 }
 /** A readout in the status bar. */
 interface StatusReadout {
@@ -139,6 +143,12 @@ type TrialContribution = (ContributionBase & {
 interface TrialChromeContext {
     trialId: string;
     instrumentName: string;
+    /** What the title bar reads, which is the instrument's name until something
+     *  calls `setTitle`. */
+    title: string;
+    /** Retitle this trial; `null` restores the instrument name. Persisted with
+     *  the trial, so a title survives a reload. */
+    setTitle: (title: string | null) => void;
     isLastTrial: boolean;
     /** Null when the trial holds a view that is not the 2D one. */
     zoom: number | null;
@@ -159,6 +169,13 @@ interface TrialChromeContext {
     configFields: ConfigField[];
     config: unknown;
     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 —
+     *  a control panel's property group — is keyed `<contribution id>/<label>`.
+     *  A section absent here is at its own default. Persisted with the trial. */
+    collapsedSections: Readonly<Record<string, boolean>>;
+    /** Fold or unfold one section, keyed as `collapsedSections` is. */
+    setSectionCollapsed: (key: string, collapsed: boolean) => void;
     /** Section ids this trial currently has torn out of its sidebar. */
     undockedPanels: readonly string[];
     /** Tear a sidebar section out into the workspace. */
@@ -177,6 +194,12 @@ interface TrialChromeContext {
     setActiveTool: (id: string) => void;
 }
 
+/** A point on the magnified surface, in its own CSS pixels. */
+interface LoupePoint {
+    x: number;
+    y: number;
+}
+
 /** How a loupe magnifies. `'vector'` re-renders the source through a zoomed-in
  *  view, so content stays sharp at any factor; `'pixel'` blows up the actual
  *  pixels the surface presented. */
@@ -277,11 +300,9 @@ interface RenderContext<TS = unknown, TC = unknown> {
     config: TC;
     setState: (next: TS | ((prev: TS) => TS)) => void;
     setConfig: (key: keyof TC, value: unknown) => void;
-    trial: {
-        id: string;
-        /** The trial's view, in whatever shape this instrument chose. labkit persists
-         *  it and restores it on Reset without ever reading into it. */
-        view: unknown;
+    /** labkit persists `view` and restores it on Reset without ever reading
+     *  into it. */
+    trial: TrialInfo & {
         setView: (next: unknown) => void;
         /** 2D convenience over `view`. Reads 1 and writes nothing when the trial holds
          *  a view that is not the 2D one. */
@@ -635,7 +656,9 @@ interface AnnotationStorage {
 /** Declares that an instrument accepts marks: which regions take them,
  *  optionally what a mark is allowed to mean, and optionally where they live. */
 interface AnnotationsCapability<TS = unknown, TC = unknown> {
-    targets: (state: TS, config: TC) => readonly AnnotationTarget[];
+    /** `trial` is which trial is asking: a declaration made once per instrument
+     *  is called once per trial, and its targets are that trial's own. */
+    targets: (state: TS, config: TC, trial: TrialInfo) => readonly AnnotationTarget[];
     meaning?: AnnotationMeaning;
     storage?: AnnotationStorage;
     /** Fires after every finished export, labkit's own chrome included. A
@@ -732,4 +755,4 @@ declare function fracContains(box: FracRect, pt: FracPoint, tol?: number): boole
 declare function fracIntersects(outer: FracRect, inner: FracRect): boolean;
 
 export { LOUPE_DEFAULTS as L, annotationsFromJSON as a3, applyCamera as a4, createAnnotationScene as a5, createAnnotationStore as a6, fracContains as a7, fracIntersects as a8, fracToWorld as a9, resolveFrame as aa, resolveLoupe as ab, roundFrac as ac, worldToFrac as ad, DEFAULT_FRAME as x };
-export type { TrialRegion as $, AnnotationData as A, LayerCapability as B, CaptureSource as C, DragFeedback as D, LayerDescriptor as E, FracPoint as F, LoupeCapability as G, HitResult as H, Instrument as I, LoupeDeclaration as J, LoupeRenderArgs as K, MarkScene as M, ResolvedLoupe as N, SidebarSection as O, PaletteItem as P, StatusReadout as Q, RenderContext as R, SerializedAnnotations as S, TrialTool as T, SystemEvent as U, ViewTransform as V, WorldFrame as W, ToolCapability as X, ToolItem as Y, ToolbarItem as Z, TrialChromeContext as _, Point as a, UndoCapability as a0, ViewportControl as a1, ViewportSize as a2, LoupeMode as ae, DragDropCapability as b, WorldSpec as c, WorldRect as d, AnnotationMeaning as e, CaptureOptions as f, CaptureResult as g, AnnotationTarget as h, AnnotationsApi as i, AnnotationsCapability as j, AnnotationKind as k, InstrumentList as l, TrialContribution as m, Annotation as n, AnnotationInit as o, AnnotationPatch as p, AnnotationQuery as q, AnnotationStatus as r, AnnotationStoreOptions as s, AnnotationTargetInfo as t, CanvasCapability as u, CanvasLayer as v, CaptureDeps as w, FracRect as y, IconComponent as z };
+export type { TrialRegion as $, AnnotationData as A, LayerCapability as B, CaptureSource as C, DragFeedback as D, LayerDescriptor as E, FracPoint as F, LoupeCapability as G, HitResult as H, Instrument as I, LoupeDeclaration as J, LoupeRenderArgs as K, MarkScene as M, ResolvedLoupe as N, SidebarSection as O, PaletteItem as P, StatusReadout as Q, RenderContext as R, SerializedAnnotations as S, TrialTool as T, SystemEvent as U, ViewTransform as V, WorldFrame as W, ToolCapability as X, ToolItem as Y, ToolbarItem as Z, TrialChromeContext as _, Point as a, UndoCapability as a0, ViewportControl as a1, ViewportSize as a2, LoupePoint as ae, LoupeMode as af, DragDropCapability as b, WorldSpec as c, WorldRect as d, AnnotationMeaning as e, CaptureOptions as f, CaptureResult as g, AnnotationTarget as h, AnnotationsApi as i, AnnotationsCapability as j, AnnotationKind as k, InstrumentList as l, TrialContribution as m, Annotation as n, AnnotationInit as o, AnnotationPatch as p, AnnotationQuery as q, AnnotationStatus as r, AnnotationStoreOptions as s, AnnotationTargetInfo as t, CanvasCapability as u, CanvasLayer as v, CaptureDeps as w, FracRect as y, IconComponent as z };

package/dist/_dts/{index-B2X21G1c.d.ts → index-CsU9WhjM.d.ts}

@@ -1,20 +1,44 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { R as ResolvedConfig, C as ConfigField, c as ControlRenderer } from './types-C1Zw7s5P.js';
+import { R as ResolvedConfig, C as ConfigField, c as ControlRenderer } from './types-lg4TSCb2.js';
 
+/**
+ * How much room a container gives its rows — gaps, padding, and field height,
+ * moved together. Set on any container in the family; it reaches every
+ * descendant, so an inner group can differ from the panel around it.
+ */
+type PropertyDensity = 'tight' | 'normal' | 'roomy';
+/** Where an inline row's label and control sit on the row's cross axis. Set on
+ *  a container to line a whole column of them up. */
+type PropertyAlign = 'start' | 'center' | 'end' | 'baseline';
+/** Metric props every container in the family takes. Both reach descendants,
+ *  so the nearest container that states one wins. */
+interface PropertyMetricProps {
+    /** Room the rows get. Unset inherits from an outer container, else `normal`. */
+    density?: PropertyDensity;
+    /**
+     * Cross-axis alignment of an inline row's label and control. `baseline` sits
+     * the control on the label's first-line baseline, which is what lines a
+     * column of swatches up against labels of different heights. Unset keeps each
+     * variant's own alignment — a color row centers its label and swatch and
+     * sinks the pair to the row's bottom edge, which keeps a paired alpha track
+     * level with its neighbour.
+     */
+    align?: PropertyAlign;
+}
 /** Props for `<PropertyPanel>`. */
-interface PropertyPanelProps {
+interface PropertyPanelProps extends PropertyMetricProps {
     title?: ReactNode;
     children: ReactNode;
     className?: string;
 }
 /** A titled panel holding property rows — the sidebar container the rest of
  *  this module's components fill. */
-declare function PropertyPanel({ title, children, className }: PropertyPanelProps): react_jsx_runtime.JSX.Element;
+declare function PropertyPanel({ title, children, className, density, align, }: PropertyPanelProps): react_jsx_runtime.JSX.Element;
 /** How a property list packs its rows into two columns. */
-type PropertyListPack = 'auto-color' | 'pairs';
+type PropertyListPack = 'auto-color' | 'pairs' | 'one-up';
 /** Props for `<PropertyList>`. */
-interface PropertyListProps {
+interface PropertyListProps extends PropertyMetricProps {
     children: ReactNode;
     className?: string;
     /**
@@ -24,6 +48,8 @@ interface PropertyListProps {
      *   - `'pairs'`: every row auto-places into the 2-column grid two-per-row.
      *     Headers and subpanels still span the full width; wrap any other
      *     full-width child in `<PropertySpan>`. Right for dense effect bodies.
+     *   - `'one-up'`: every row spans the full width, color rows included. Right
+     *     for a palette — a column of swatches read as a group.
      */
     pack?: PropertyListPack;
 }
@@ -31,7 +57,7 @@ interface PropertyListProps {
  * 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;
+declare function PropertyList({ children, className, pack, density, align, }: PropertyListProps): react_jsx_runtime.JSX.Element;
 /** Props for `<PropertySpan>`. */
 interface PropertySpanProps {
     children: ReactNode;
@@ -49,7 +75,7 @@ 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 {
+interface PropertyRowProps extends PropertyMetricProps {
     label: ReactNode;
     /** Right-aligned readout shown next to the label (e.g. current value). */
     readout?: ReactNode;
@@ -60,9 +86,9 @@ interface PropertyRowProps {
     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.
+     * Label position relative to the control. Unset takes the variant's own
+     * orientation: `block` — label above control — for the default variant, and
+     * `inline` for the color and checkbox variants, which read as a row.
      */
     layout?: PropertyRowLayout;
     /**
@@ -77,15 +103,26 @@ interface PropertyRowProps {
 }
 /** 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;
+declare function PropertyRow({ label, readout, description, variant, layout, span, children, htmlFor, className, density, align, }: PropertyRowProps): react_jsx_runtime.JSX.Element;
 /** Props for `<SliderRow>`. */
-interface SliderRowProps {
+interface SliderRowProps extends PropertyMetricProps {
     label: ReactNode;
     value: number;
     min: number;
     max: number;
     step?: number;
+    /**
+     * The committed value. Given `onInput` as well, it fires once a drag ends
+     * or a typed readout is accepted; on its own it fires on every move, which
+     * is what a row with one callback has always done.
+     */
     onChange: (next: number) => void;
+    /**
+     * The live value, fired continuously through a drag. Pass it alongside
+     * `onChange` when the write is expensive — cheap state here, the costly
+     * work there. Mirrors `<Slider>`'s `onInput` / `onChange` pair.
+     */
+    onInput?: (next: number) => void;
     /** Override how the value is rendered next to the label. Defaults to `value.toString()`. */
     format?: (value: number) => ReactNode;
     /**
@@ -101,9 +138,9 @@ interface SliderRowProps {
 }
 /** 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, span, }: SliderRowProps): react_jsx_runtime.JSX.Element;
+declare function SliderRow({ label, value, min, max, step, onChange, onInput, format, unit, layout, description, span, density, align, }: SliderRowProps): react_jsx_runtime.JSX.Element;
 /** Props for `<ColorRow>`. */
-interface ColorRowProps {
+interface ColorRowProps extends PropertyMetricProps {
     label: ReactNode;
     value: string;
     onChange: (next: string) => void;
@@ -115,25 +152,29 @@ interface ColorRowProps {
      * Use when the color's consumer drops alpha so the affordance reads dead.
      */
     alphaDisabled?: boolean;
+    /** Label beside the swatch (default) or above it. */
+    layout?: PropertyRowLayout;
     description?: string;
     /** Take the full width of the enclosing grid — see `<PropertyRow span>`. */
     span?: boolean;
 }
 /** A color swatch, optionally with an alpha slider beneath it. */
-declare function ColorRow({ label, value, onChange, alpha, onAlphaChange, alphaDisabled, description, span, }: ColorRowProps): react_jsx_runtime.JSX.Element;
+declare function ColorRow({ label, value, onChange, alpha, onAlphaChange, alphaDisabled, layout, description, span, density, align, }: ColorRowProps): react_jsx_runtime.JSX.Element;
 /** Props for `<CheckboxRow>`. */
-interface CheckboxRowProps {
+interface CheckboxRowProps extends PropertyMetricProps {
     label: ReactNode;
     value: boolean;
     onChange: (next: boolean) => void;
+    /** Label beside the box (default) or above it. */
+    layout?: PropertyRowLayout;
     description?: string;
     /** Take the full width of the enclosing grid — see `<PropertyRow span>`. */
     span?: boolean;
 }
 /** A boolean checkbox. */
-declare function CheckboxRow({ label, value, onChange, span, description }: CheckboxRowProps): react_jsx_runtime.JSX.Element;
+declare function CheckboxRow({ label, value, onChange, layout, span, description, density, align, }: CheckboxRowProps): react_jsx_runtime.JSX.Element;
 /** Props for `<TextRow>`. */
-interface TextRowProps {
+interface TextRowProps extends PropertyMetricProps {
     label: ReactNode;
     value: string;
     onChange: (next: string) => void;
@@ -145,9 +186,9 @@ interface TextRowProps {
     span?: boolean;
 }
 /** A single-line text input. */
-declare function TextRow({ label, value, onChange, placeholder, maxLength, layout, description, span, }: TextRowProps): react_jsx_runtime.JSX.Element;
+declare function TextRow({ label, value, onChange, placeholder, maxLength, layout, description, span, density, align, }: TextRowProps): react_jsx_runtime.JSX.Element;
 /** Props for `<NumberRow>`. */
-interface NumberRowProps {
+interface NumberRowProps extends PropertyMetricProps {
     label: ReactNode;
     value: number;
     onChange: (next: number) => void;
@@ -168,13 +209,13 @@ interface NumberRowProps {
 }
 /** 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, unit, layout, description, span, }: NumberRowProps): react_jsx_runtime.JSX.Element;
+declare function NumberRow({ label, value, onChange, min, max, step, placeholder, unit, layout, description, span, density, align, }: NumberRowProps): react_jsx_runtime.JSX.Element;
 interface PropertyOption<T extends string> {
     value: T;
     label: ReactNode;
 }
 /** Props for `<SelectRow>`. */
-interface SelectRowProps<T extends string> {
+interface SelectRowProps<T extends string> extends PropertyMetricProps {
     label: ReactNode;
     value: T;
     options: ReadonlyArray<PropertyOption<T>>;
@@ -186,9 +227,9 @@ interface SelectRowProps<T extends 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, span, }: SelectRowProps<T>): react_jsx_runtime.JSX.Element;
+declare function SelectRow<T extends string>({ label, value, options, onChange, layout, description, span, density, align, }: SelectRowProps<T>): react_jsx_runtime.JSX.Element;
 /** Props for `<ToggleRow>`. */
-interface ToggleRowProps<T extends string> {
+interface ToggleRowProps<T extends string> extends PropertyMetricProps {
     label: ReactNode;
     value: T;
     options: ReadonlyArray<PropertyOption<T>>;
@@ -200,7 +241,7 @@ interface ToggleRowProps<T extends 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, }: ToggleRowProps<T>): react_jsx_runtime.JSX.Element;
+declare function ToggleRow<T extends string>({ label, value, options, onChange, layout, description, span, density, align, }: 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, colours) sit
@@ -226,9 +267,28 @@ interface ControlPanelProps<TC extends Record<string, unknown>> {
     renderers?: Record<string, ControlRenderer>;
     /** How rows pack into the two-column grid. Defaults to `'pairs'`. */
     pack?: ControlPack;
-    /** Where a row's label sits relative to its control. Defaults to `'block'`
-     *  — above it, which is what leaves a paired row room for its value. */
+    /**
+     * Where a row's label sits relative to its control. Unset takes each row's
+     * own orientation — `block` (label above, which is what leaves a paired row
+     * room for its value) for most, `inline` for colors and checkboxes.
+     */
     layout?: PropertyRowLayout;
+    /** Room the rows get. Passed straight to the property list. */
+    density?: PropertyDensity;
+    /** Cross-axis alignment of an inline row's label and control. */
+    align?: PropertyAlign;
+    /**
+     * Fold each section away behind a twisty, starting `'open'` or `'closed'`.
+     * Unset draws the heading alone, as the panel always has.
+     */
+    collapse?: 'open' | 'closed';
+    /**
+     * Which sections are folded, keyed by section label. Given, the panel keeps
+     * no state of its own: every toggle arrives at `onCollapse` instead, which
+     * is where a lab that remembers a trial's sections writes them.
+     */
+    collapsed?: Readonly<Record<string, boolean>>;
+    onCollapse?: (label: string, collapsed: boolean) => void;
     /** Draw leaves marked `hidden`. */
     showHidden?: boolean;
     className?: string;
@@ -236,7 +296,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, 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, showHidden, className, }: ControlPanelProps<TC>): react_jsx_runtime.JSX.Element;
 
-export { CheckboxRow as C, NumberRow as N, PropertyList as P, SelectRow as S, TextRow as T, ColorRow as b, ControlPanel as d, PropertyPanel as i, PropertyRow as k, PropertySpan as o, SliderRow as r, ToggleRow as u };
-export type { CheckboxRowProps as a, ColorRowProps as c, NumberRowProps as e, PropertyListPack as f, PropertyListProps as g, PropertyOption as h, PropertyPanelProps as j, PropertyRowLayout as l, PropertyRowProps as m, PropertyRowVariant as n, PropertySpanProps as p, SelectRowProps as q, SliderRowProps as s, TextRowProps as t, ToggleRowProps as v };
+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/{types-ChVJJHvk.d.ts → types-BbXpvQa8.d.ts}

@@ -18,6 +18,14 @@ interface UndoStack {
     past: unknown[];
     future: unknown[];
 }
+/** The trial a per-trial call is coming from. `id` is the id `useTileId`
+ *  scopes a surface tile under, so a consumer keying its own per-trial
+ *  registry and labkit's tiles agree on the key. */
+interface TrialInfo<TV = unknown> {
+    id: string;
+    /** The trial's view, in whatever shape the instrument keeps it. */
+    view: TV;
+}
 /** One trial as the store holds it: which instrument it runs, that
  *  instrument's config and state, the camera, and the undo history. */
 interface TrialRecord<TS = unknown, TC = unknown, TV = unknown> {
@@ -28,11 +36,22 @@ interface TrialRecord<TS = unknown, TC = unknown, TV = unknown> {
     /** Opaque to labkit: persisted, restored on Reset and handed to the instrument,
      *  but never read into. A 3D lab puts an orbit here and keeps all three. */
     view: TV;
+    /** The config `addTrial` opened this trial on, overlaid on the instrument's
+     *  defaults. Kept so Reset restores the trial's own subject rather than the
+     *  bare defaults. */
+    configSeed?: Partial<TC>;
     /** 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
      *  until someone moves the seam. */
     sidebarWidth?: number;
+    /** What the title bar reads. Undefined — the state a trial opens in, and the
+     *  one `setTitle(null)` returns it to — means the instrument's name. */
+    title?: string | null;
+    /** Which of the trial's collapsible sections are folded, keyed as
+     *  `TrialChromeContext.collapsedSections` describes. A key that is absent
+     *  takes the section's own default. */
+    collapsedSections?: Record<string, boolean>;
     /** The marks on this trial's annotation targets, as `AnnotationsApi.toJSON`
      *  wrote them. Opaque here, and absent for a trial whose instrument declares
      *  no `annotations` — or declares its own `storage`. Not in `state`, which
@@ -115,4 +134,4 @@ interface LabDocument {
 type Migration = (doc: Record<string, unknown>) => Record<string, unknown>;
 
 export { dockPanel as g, panelKey as p, undockPanel as u };
-export type { CreateLabStoreOptions as C, InstrumentSerializers as I, LabDocument as L, Migration as M, SerializedTrial as S, TrialRecord as T, UndoStack as U, StorageAdapter as a, LabStoreState as b, SavedSnapshot as c, TrialStateHandle as d, UndockedPanel as e, UndockedPanels as f, LabMode as h };
+export type { CreateLabStoreOptions as C, InstrumentSerializers as I, LabDocument as L, Migration as M, SerializedTrial as S, TrialRecord as T, UndoStack as U, StorageAdapter as a, LabStoreState as b, SavedSnapshot as c, TrialStateHandle as d, UndockedPanel as e, UndockedPanels as f, LabMode as h, TrialInfo as i };

package/dist/_dts/{types-C1Zw7s5P.d.ts → types-lg4TSCb2.d.ts}

@@ -1,4 +1,5 @@
-import { P as PrefRenderer, T as ToolPrefLeaf, a as ToolPrefGroup } from './PrefsForm-BkUJZx0A.js';
+import { T as ToolPrefLeaf, a as ToolPrefGroup } from './weasel-canvas-FJTFi3ZZ.js';
+import { P as PrefRenderer } from './PrefsForm.d-CgxUequc.js';
 
 /**
  * Renders the control cell for one config leaf. Identical to weasel-ui's

package/dist/_dts/{useTrialState-Cdm13fvl.d.ts → useTrialState-DKjqpv20.d.ts}

@@ -1,4 +1,4 @@
-import { a as StorageAdapter, b as LabStoreState, T as TrialRecord, c as SavedSnapshot, h as LabMode, e as UndockedPanel, I as InstrumentSerializers, C as CreateLabStoreOptions, d as TrialStateHandle } from './types-ChVJJHvk.js';
+import { a as StorageAdapter, b as LabStoreState, T as TrialRecord, c as SavedSnapshot, h as LabMode, e as UndockedPanel, I as InstrumentSerializers, C as CreateLabStoreOptions, d as TrialStateHandle } from './types-BbXpvQa8.js';
 import * as react from 'react';
 import { ReactNode, ReactElement } from 'react';
 import { StoreApi } from 'zustand/vanilla';
@@ -26,6 +26,10 @@ interface LabStoreActions {
     updateTrialConfig: <TC>(id: string, key: keyof TC, value: TC[keyof TC]) => void;
     updateTrialView: (id: string, view: unknown) => void;
     updateTrialSidebarWidth: (id: string, width: number) => void;
+    /** Retitle a trial. `null` returns it to its instrument's name. */
+    setTrialTitle: (id: string, title: string | null) => void;
+    /** Fold or unfold one of a trial's sections. */
+    setTrialSectionCollapsed: (id: string, key: string, collapsed: boolean) => void;
     updateTrialAnnotations: (id: string, doc: unknown) => void;
     updateTrialUndoStack: (id: string, next: TrialRecord['undoStack'] | ((prev: TrialRecord['undoStack']) => TrialRecord['undoStack'])) => void;
     setTrialInstrument: (id: string, instrumentName: string) => void;