@weasel-js/labkit 1.4.1 → 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-BIRUVVGH.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-X7mWgd7y.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/{frac-X7mWgd7y.d.ts → frac-A4R6v4ld.d.ts}

@@ -1,6 +1,6 @@
 import { ComponentType, ReactNode, RefObject } from 'react';
 import { R as ResolvedConfig, C as ConfigField, a as ConfigSchema } from './types-lg4TSCb2.js';
-import { c as SavedSnapshot } from './types-ChVJJHvk.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 './weasel-canvas-FJTFi3ZZ.js';
 
@@ -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. */
@@ -283,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. */
@@ -641,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

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

@@ -2,19 +2,43 @@ 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-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/{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;

package/dist/canvas/index.d.ts

@@ -1,13 +1,13 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, WheelEvent, PointerEvent as PointerEvent$1 } from 'react';
-import { V as ViewTransform, c as WorldSpec, a2 as ViewportSize, a as Point, W as WorldFrame } from '../_dts/frac-X7mWgd7y.js';
-export { x as DEFAULT_FRAME, a4 as applyCamera, aa as resolveFrame } from '../_dts/frac-X7mWgd7y.js';
-import { C as CanvasLayerDescriptor } from '../_dts/CanvasStackContext-BIRUVVGH.js';
-export { a as CanvasStackContext, b as CanvasStackContextValue, c as CanvasStackSurface } from '../_dts/CanvasStackContext-BIRUVVGH.js';
+import { V as ViewTransform, c as WorldSpec, a2 as ViewportSize, a as Point, W as WorldFrame } from '../_dts/frac-A4R6v4ld.js';
+export { x as DEFAULT_FRAME, a4 as applyCamera, aa as resolveFrame } from '../_dts/frac-A4R6v4ld.js';
+import { C as CanvasLayerDescriptor } from '../_dts/CanvasStackContext-kjILVnPj.js';
+export { a as CanvasStackContext, b as CanvasStackContextValue, c as CanvasStackSurface } from '../_dts/CanvasStackContext-kjILVnPj.js';
 import '../_dts/types-lg4TSCb2.js';
 import '../_dts/weasel-canvas-FJTFi3ZZ.js';
 import '../_dts/PrefsForm.d-CgxUequc.js';
-import '../_dts/types-ChVJJHvk.js';
+import '../_dts/types-BbXpvQa8.js';
 import '../_dts/types-DJ79Tg5J.js';
 
 /** Props for `<CanvasStack>`. */

package/dist/canvas/index.js

@@ -1,7 +1,7 @@
-export { CanvasStack, PITCH_LIMIT, clampPitch, orbitAfterDrag, orbitAfterWheel, useOrbit, usePanZoom, wrapYaw } from '../chunk-PP7ZWAMV.js';
+export { CanvasStack, PITCH_LIMIT, clampPitch, orbitAfterDrag, orbitAfterWheel, useOrbit, usePanZoom, wrapYaw } from '../chunk-FJG4PHTL.js';
 export { centerOn, zoomAt } from '../chunk-CTRKTLYZ.js';
 export { DEFAULT_FRAME, applyCamera, resolveFrame, screenToWorld, worldToScreen } from '../chunk-2AYGEN57.js';
 export { CanvasStackContext } from '../chunk-CQLQPQ4P.js';
-import '../chunk-DG2IFMLA.js';
+import '../chunk-54ZWZ5FQ.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/chrome/index.d.ts

@@ -1,11 +1,11 @@
 import { c as ControlRenderer } from '../_dts/types-lg4TSCb2.js';
-import { I as Instrument, _ as TrialChromeContext, m as TrialContribution } from '../_dts/frac-X7mWgd7y.js';
-export { z as IconComponent, O as SidebarSection, Q as StatusReadout, Y as ToolItem, Z as ToolbarItem, $ as TrialRegion, a1 as ViewportControl } from '../_dts/frac-X7mWgd7y.js';
+import { I as Instrument, _ as TrialChromeContext, m as TrialContribution } from '../_dts/frac-A4R6v4ld.js';
+export { z as IconComponent, O as SidebarSection, Q as StatusReadout, Y as ToolItem, Z as ToolbarItem, $ as TrialRegion, a1 as ViewportControl } from '../_dts/frac-A4R6v4ld.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import '../_dts/weasel-canvas-FJTFi3ZZ.js';
 import 'react';
 import '../_dts/PrefsForm.d-CgxUequc.js';
-import '../_dts/types-ChVJJHvk.js';
+import '../_dts/types-BbXpvQa8.js';
 import '../_dts/types-DJ79Tg5J.js';
 
 /**
@@ -58,13 +58,19 @@ interface StatusRegionProps {
 /** Lays a trial's `status` contributions out as readouts. */
 declare function StatusRegion({ contributions, ctx }: StatusRegionProps): react_jsx_runtime.JSX.Element | null;
 
+/** Which end of the title bar a `<TitleBarRegion>` lays out: `'lead'` renders
+ *  the contributions that leave `end` unset, before the title; `'actions'`
+ *  renders the ones that set it, after everything else. */
+type TitleBarPlacement = 'lead' | 'actions';
 /** Props for `<TitleBarRegion>`. */
 interface TitleBarRegionProps {
     contributions: readonly TrialContribution[];
     ctx: TrialChromeContext;
+    /** Defaults to `'actions'`, where the built-ins live. */
+    placement?: TitleBarPlacement;
 }
-/** Lays a trial's `titlebar` contributions out, at the far end of the bar. */
-declare function TitleBarRegion({ contributions, ctx }: TitleBarRegionProps): react_jsx_runtime.JSX.Element | null;
+/** Lays a trial's `titlebar` contributions out at one end of the bar. */
+declare function TitleBarRegion({ contributions, ctx, placement }: TitleBarRegionProps): react_jsx_runtime.JSX.Element | null;
 
 /** Props for `<ToolbarRegion>`. */
 interface ToolbarRegionProps {
@@ -86,4 +92,4 @@ interface ViewportRegionProps {
 declare function ViewportRegion({ contributions, ctx }: ViewportRegionProps): react_jsx_runtime.JSX.Element | null;
 
 export { PaletteRegion, SidebarRegion, StatusRegion, TitleBarRegion, ToolbarRegion, TrialChromeContext, TrialContribution, ViewportRegion, builtinContributions, mergeContributions, suppressContributions };
-export type { PaletteRegionProps, SidebarRegionProps, StatusRegionProps, TitleBarRegionProps, ToolbarRegionProps, ViewportRegionProps };
+export type { PaletteRegionProps, SidebarRegionProps, StatusRegionProps, TitleBarPlacement, TitleBarRegionProps, ToolbarRegionProps, ViewportRegionProps };

package/dist/chrome/index.js

@@ -1,9 +1,9 @@
-export { PaletteRegion, SidebarRegion, StatusRegion, TitleBarRegion, ToolbarRegion, ViewportRegion, builtinContributions, mergeContributions, suppressContributions } from '../chunk-BMQWLKOL.js';
-import '../chunk-MSR7EVS6.js';
-import '../chunk-53AZ2O2N.js';
+export { PaletteRegion, SidebarRegion, StatusRegion, TitleBarRegion, ToolbarRegion, ViewportRegion, builtinContributions, mergeContributions, suppressContributions } from '../chunk-W2FJR5FF.js';
+import '../chunk-UTOEDPNU.js';
+import '../chunk-XKENZTNE.js';
 import '../chunk-SBXNQW4G.js';
-import '../chunk-J6SBFZYT.js';
+import '../chunk-ISSVF5PT.js';
 import '../chunk-CQLQPQ4P.js';
-import '../chunk-DG2IFMLA.js';
+import '../chunk-54ZWZ5FQ.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map