@weasel-js/labkit 1.4.4 → 1.5.0

package/dist/layers/index.d.ts

@@ -1,12 +1,10 @@
-import { E as LayerDescriptor } from '../_dts/frac-z7ker2Vx.js';
-export { B as LayerCapability } from '../_dts/frac-z7ker2Vx.js';
+import { a9 as LayerDescriptor } from '../_dts/frac-8R6UmlvN.js';
+export { a8 as LayerCapability } from '../_dts/frac-8R6UmlvN.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'react';
-import '../_dts/types-B9_zrHmb.js';
+import '../_dts/types-Ca2LCnPq.js';
 import '@weasel-js/core';
 import '../_dts/PrefsForm.d-DDHFANkc.js';
-import '../_dts/types-x92Kfeme.js';
-import '../_dts/types-BP2OCcpg.js';
 import '../_dts/types-DJ79Tg5J.js';
 
 /** A layer that may itself contain layers. A plain `LayerDescriptor` is one

package/dist/layers/index.js

@@ -1,5 +1,5 @@
-export { LayerList } from '../chunk-BKFVHKJH.js';
+export { LayerList } from '../chunk-MUKOW3TC.js';
 import '../chunk-SBXNQW4G.js';
-import '../chunk-W3ECWC2K.js';
+import '../chunk-S2SHZRD7.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/loupe/index.d.ts

@@ -1,13 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ae as LoupePoint, af as LoupeMode, V as ViewTransform, W as WorldFrame, c as WorldSpec, a2 as ViewportSize, K as LoupeRenderArgs, N as ResolvedLoupe } from '../_dts/frac-z7ker2Vx.js';
-export { L as LOUPE_DEFAULTS, G as LoupeCapability, J as LoupeDeclaration, ab as resolveLoupe } from '../_dts/frac-z7ker2Vx.js';
-import { c as CanvasStackSurface, C as CanvasLayerDescriptor } from '../_dts/CanvasStackContext-kTEZvEgE.js';
+import { aD as LoupePoint, aE as LoupeMode, k as ViewTransform, W as WorldFrame, a as WorldSpec, V as ViewportSize, ac as LoupeRenderArgs, af as ResolvedLoupe } from '../_dts/frac-8R6UmlvN.js';
+export { a7 as LOUPE_DEFAULTS, aa as LoupeCapability, ab as LoupeDeclaration, aA as resolveLoupe } from '../_dts/frac-8R6UmlvN.js';
+import { c as CanvasStackSurface, C as CanvasLayerDescriptor } from '../_dts/CanvasStackContext-CqkxkFJW.js';
 import { RefObject, ReactNode } from 'react';
-import '../_dts/types-B9_zrHmb.js';
+import '../_dts/types-Ca2LCnPq.js';
 import '@weasel-js/core';
 import '../_dts/PrefsForm.d-DDHFANkc.js';
-import '../_dts/types-x92Kfeme.js';
-import '../_dts/types-BP2OCcpg.js';
 import '../_dts/types-DJ79Tg5J.js';
 
 /** Props for `<CanvasLoupe>`. */
@@ -56,7 +54,7 @@ interface SourceRect {
  */
 declare function lensSourceRect(aim: LoupePoint, factor: number, diameter: number, dpr: number): SourceRect;
 /**
- * The colour a stack presents at a point: the topmost visible layer with
+ * The color a stack presents at a point: the topmost visible layer with
  * anything opaque there, or `null` when every layer is transparent — which is
  * the honest answer for a point showing nothing but the workspace behind.
  */
@@ -148,7 +146,7 @@ interface UseLoupeOptions {
     hostRef: RefObject<HTMLElement | null>;
     /** Whether the loupe is turned on. Hold-to-peek shows it regardless. */
     enabled: boolean;
-    /** Hex colour at a host point. Omitted, the loupe reports no colour — which
+    /** Hex color at a host point. Omitted, the loupe reports no color — which
      *  is the honest answer for a surface with no pixels to read. */
     sample?: (p: LoupePoint) => string | null;
 }

package/dist/loupe/index.js

@@ -1,5 +1,5 @@
-export { CanvasLoupe, DomLoupe, LOUPE_DEFAULTS, LoupeBubble, TrialLoupe, drawCanvasLens, lensCamera, lensSourceRect, resolveLoupe, sampleStack, useLoupe } from '../chunk-TJ7QY3OC.js';
-import '../chunk-CTRKTLYZ.js';
+export { CanvasLoupe, DomLoupe, LOUPE_DEFAULTS, LoupeBubble, TrialLoupe, drawCanvasLens, lensCamera, lensSourceRect, resolveLoupe, sampleStack, useLoupe } from '../chunk-ZPH5WTWF.js';
+import '../chunk-H6ZAOWNE.js';
 import '../chunk-2AYGEN57.js';
 import '../chunk-CQLQPQ4P.js';
 //# sourceMappingURL=index.js.map

package/dist/passthrough/weasel-ui.d.ts

@@ -2,7 +2,8 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ToolPrefLeaf, ToolPrefGroup, ToolsApi } from '@weasel-js/core';
 export { ToolPref as BuiltinPref, ToolPrefBoolean as PrefBoolean, ToolPrefBooleanControl as PrefBooleanControl, ToolPrefColor as PrefColor, ToolPrefCustom as PrefCustom, ToolPrefEnum as PrefEnum, ToolPrefEnumControl as PrefEnumControl, ToolPrefEnumEncoding as PrefEnumEncoding, ToolPrefGroup as PrefGroup, ToolPrefKind as PrefKind, ToolPrefLeaf as PrefLeaf, ToolPrefNumber as PrefNumber, ToolPrefNumberControl as PrefNumberControl, ToolPrefNumberUnit as PrefNumberUnit, ToolPrefObject as PrefObject, ToolPrefPaint as PrefPaint, ToolPrefString as PrefString, ToolPrefStringControl as PrefStringControl } from '@weasel-js/core';
 import * as react from 'react';
-import { ReactNode, CSSProperties, ButtonHTMLAttributes, ReactElement, KeyboardEvent, RefObject, PointerEvent, RefCallback } from 'react';
+import { ReactNode, CSSProperties, ReactElement, KeyboardEvent, RefObject, PointerEvent, RefCallback } from 'react';
+export { B as Button, a as ButtonProps, b as ButtonSize, c as ButtonVariant, T as ToggleBar, d as ToggleBarItem, e as ToggleBarProps, f as ToggleBarSize, g as ToggleBarVariant } from '../_dts/ToggleBar.d-DbHoWKIA.js';
 export { LayerStack, LayerStackItem, LayerStackProps } from '../ui/layers/index.js';
 export { a as PrefRenderContext, P as PrefRenderer } from '../_dts/PrefsForm.d-DDHFANkc.js';
 import { TextFieldProps, ValidationResult, CheckboxProps as CheckboxProps$1, SwitchProps as SwitchProps$1, TabProps as TabProps$1, TabListProps as TabListProps$1, TabPanelProps as TabPanelProps$1, TabsProps as TabsProps$1, RadioProps as RadioProps$1, RadioGroupProps as RadioGroupProps$1, NumberFieldProps as NumberFieldProps$1, SelectProps as SelectProps$1, ListBoxItemProps, ComboBoxProps as ComboBoxProps$1, SliderProps as SliderProps$1, ModalOverlayProps, DialogProps as DialogProps$1, PopoverProps } from 'react-aria-components';
@@ -885,51 +886,6 @@ type BadgeProps = BadgePropsByShape;
  */
 declare function Badge(props: BadgeProps): react_jsx_runtime.JSX.Element;
 
-/** Visual weight of a button. Defaults to `secondary`. */
-type ButtonVariant = 'primary' | 'secondary' | 'ghost';
-/** Button height and type scale. */
-type ButtonSize = 'sm' | 'md';
-type ButtonBase = {
-    variant?: ButtonVariant;
-    size?: ButtonSize;
-    /** A button that stays down: renders `aria-pressed` and holds the active
-     *  treatment while it is on. For a control that reports a state rather than
-     *  firing an action -- a panel toggle, a mode switch. Left off, the button
-     *  announces no pressed state at all, which is what an action button wants. */
-    pressed?: boolean;
-    disabled?: boolean;
-    loading?: boolean;
-    leadingIcon?: ReactNode;
-    trailingIcon?: ReactNode;
-    fullWidth?: boolean;
-    type?: 'button' | 'submit' | 'reset';
-    className?: string;
-    style?: ButtonHTMLAttributes<HTMLButtonElement>['style'];
-    children?: ReactNode;
-    onClick?: ButtonHTMLAttributes<HTMLButtonElement>['onClick'];
-};
-type ButtonRegular = ButtonBase & {
-    iconOnly?: false;
-    ariaLabel?: string;
-};
-type ButtonIconOnly = ButtonBase & {
-    iconOnly: true;
-    ariaLabel: string;
-};
-/**
- * Props for {@link Button}. Setting `iconOnly` makes `ariaLabel` required,
- * since an icon-only button has no text for a screen reader to announce.
- */
-type ButtonProps = ButtonRegular | ButtonIconOnly;
-/**
- * Standard button. `loading` swaps the leading icon for a spinner, marks the
- * button `aria-busy`, and leaves the label in place; it does not disable the
- * button, so pass `disabled` too if the click should be blocked.
- *
- * `ref` forwards to the underlying `<button>`.
- */
-declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<HTMLButtonElement>>;
-
 /**
  * One column of a {@link DataGrid}. `id` doubles as the default property name
  * read off each row when no `accessor` is given.
@@ -1318,72 +1274,6 @@ type SliderProps<T extends Thumb = Thumb> = {
  */
 declare function Slider<T extends Thumb = Thumb>(props: SliderProps<T>): ReactElement;
 
-/** One segment of a {@link ToggleBar}, identified by its `value`. */
-type ToggleBarItem<V extends string | number = string> = {
-    value: V;
-    label?: ReactNode;
-    ariaLabel?: string;
-    disabled?: boolean;
-};
-/** Segment height and type scale for a {@link ToggleBar}. */
-type ToggleBarSize = 'sm' | 'md';
-/** Visual treatment of a {@link ToggleBar}. */
-type ToggleBarVariant = 'default' | 'minimal' | 'flat';
-type CommonProps = {
-    ariaLabel?: string;
-    className?: string;
-    height?: number;
-    /** Size variant. `sm` is ~60% of the default height with reduced padding
-     *  and font size — sized for dense surfaces like lab control panels. */
-    size?: ToggleBarSize;
-    /** Visual variant. `minimal` strips the pill track and glass treatment;
-     *  selection becomes a flat accent. For dense diagnostic surfaces. */
-    variant?: ToggleBarVariant;
-};
-/**
- * Props for {@link ToggleBar}, discriminated on `mode`. Single mode is
- * controlled by one value or `null`; multiple mode by an array, and only it
- * accepts `mixedValues`.
- */
-type ToggleBarProps<V extends string | number = string> = (CommonProps & {
-    mode?: 'single';
-    items: readonly ToggleBarItem<V>[];
-    value: V | null;
-    onChange: (next: V | null) => void;
-    allowDeselect?: boolean;
-}) | (CommonProps & {
-    mode: 'multiple';
-    items: readonly ToggleBarItem<V>[];
-    value: readonly V[];
-    /**
-     * Values that are neither on nor off — the sources this bar
-     * aggregates disagree (a text range that is bold in part of it, a
-     * multi-selection whose nodes differ). Rendered `aria-pressed="mixed"`,
-     * the ARIA tri-state a toggle button actually has, rather than
-     * `SelectionPanel`'s reduced-opacity-plus-`title` workaround for
-     * `Switch`, which has no indeterminate state to render.
-     *
-     * `value` wins where the two lists overlap, so a caller that can't
-     * cheaply keep them disjoint doesn't get an ambiguous segment.
-     *
-     * Clicking a mixed segment turns it fully **on**, matching the
-     * everywhere-else convention (and `toggleFlagInRange`'s rule for a
-     * partially-styled text range) that a mixed toggle resolves toward
-     * the affirmative rather than clearing.
-     */
-    mixedValues?: readonly V[];
-    onChange: (next: V[]) => void;
-});
-/**
- * Segmented control for choosing among a fixed set of values — one of them
- * (`mode: 'single'`, the default) or any number (`mode: 'multiple'`).
- *
- * Single mode ignores a click on the already-selected segment unless
- * `allowDeselect` is set. Arrow keys move focus without changing the value;
- * Space and Enter commit.
- */
-declare function ToggleBar<V extends string | number = string>(props: ToggleBarProps<V>): ReactElement;
-
 /**
  * One segment of an {@link OptionsBar}. Unlike `ToggleBar`, each item carries
  * its own selected state and its own `onChange`.
@@ -1979,12 +1869,12 @@ type SelectOption = {
      */
     textValue?: string;
 };
-type Key$1 = string | number;
+type Key$2 = string | number;
 /**
  * Props for {@link Select}, on top of React Aria's `Select` props, with the
  * selection key narrowed to the option value type.
  */
-type SelectProps<T extends Key$1 = string> = Omit<SelectProps$1<object>, 'children' | 'className' | 'selectedKey' | 'defaultSelectedKey' | 'onSelectionChange'> & {
+type SelectProps<T extends Key$2 = string> = Omit<SelectProps$1<object>, 'children' | 'className' | 'selectedKey' | 'defaultSelectedKey' | 'onSelectionChange'> & {
     label?: ReactNode;
     description?: ReactNode;
     errorMessage?: ReactNode | ((v: ValidationResult) => ReactNode);
@@ -2013,7 +1903,7 @@ type SelectProps<T extends Key$1 = string> = Omit<SelectProps$1<object>, 'childr
  * The selection key type is parameterized so consumers with a string-literal
  * union for `value` (e.g. `'r' | 'g' | 'b'`) get a typed `onSelectionChange`.
  */
-declare function Select<T extends Key$1 = string>(props: SelectProps<T>): react_jsx_runtime.JSX.Element;
+declare function Select<T extends Key$2 = string>(props: SelectProps<T>): react_jsx_runtime.JSX.Element;
 /** Props for {@link SelectItem}, on top of React Aria's `ListBoxItem` props. */
 type SelectItemProps = Omit<ListBoxItemProps, 'className' | 'children'> & {
     children?: ReactNode;
@@ -2026,6 +1916,33 @@ type SelectItemProps = Omit<ListBoxItemProps, 'className' | 'children'> & {
  */
 declare function SelectItem({ children, className, textValue, ...rest }: SelectItemProps): react_jsx_runtime.JSX.Element;
 
+/** One row in a {@link MenuButton}'s list. */
+type MenuButtonItem<T extends string = string> = {
+    value: T;
+    label: ReactNode;
+    isDisabled?: boolean;
+    /** Plain-text form of `label`, for type-to-select and screen readers. A
+     *  string label supplies this itself. */
+    textValue?: string;
+};
+/** Props for {@link MenuButton}. */
+type MenuButtonProps<T extends string = string> = {
+    /** What the button says. It never changes to show a chosen row. */
+    label: ReactNode;
+    items: ReadonlyArray<MenuButtonItem<T>>;
+    /** Fired with the value of the row chosen. */
+    onAction: (value: T) => void;
+    isDisabled?: boolean;
+    className?: string;
+    'aria-label'?: string;
+} & OverlayPortalProps;
+/**
+ * A button that opens a list and acts on the row chosen — "Add trial…",
+ * "Load…". Unlike a {@link Select} it holds no value, so it sizes to its own
+ * label rather than to its widest row.
+ */
+declare function MenuButton<T extends string = string>({ label, items, onAction, isDisabled, className, 'aria-label': ariaLabel, portalContainer, }: MenuButtonProps<T>): react_jsx_runtime.JSX.Element;
+
 /**
  * One option in a {@link ComboBox}'s `options` list. `textValue` is the
  * plain-text form used for filtering and screen readers, needed only when
@@ -2037,12 +1954,29 @@ type ComboBoxOption = {
     textValue?: string;
     isDisabled?: boolean;
 };
-type Key = string | number;
+type Key$1 = string | number;
+/**
+ * How the typed text narrows the options.
+ *
+ * `'contains'` is a locale-aware substring match over each option's text.
+ * `'none'` shows every option given — what a list a server already filtered
+ * and ranked needs, since a second pass would drop rows that do not contain
+ * the query and reorder whatever survived.
+ */
+type ComboBoxFilter = 'contains' | 'none' | ((textValue: string, inputValue: string) => boolean);
+/** What the user committed: an option they picked, or text they typed. */
+type ComboBoxCommit<T extends Key$1 = string> = {
+    source: 'option';
+    key: T;
+} | {
+    source: 'text';
+    text: string;
+};
 /**
  * Props for {@link ComboBox}, on top of React Aria's `ComboBox` props, with
  * the selection key narrowed to the option value type.
  */
-type ComboBoxProps<T extends Key = string> = Omit<ComboBoxProps$1<object>, 'children' | 'className' | 'selectedKey' | 'defaultSelectedKey' | 'onSelectionChange'> & {
+type ComboBoxProps<T extends Key$1 = string> = Omit<ComboBoxProps$1<object>, 'children' | 'className' | 'selectedKey' | 'defaultSelectedKey' | 'onSelectionChange'> & {
     label?: ReactNode;
     description?: ReactNode;
     errorMessage?: ReactNode | ((v: ValidationResult) => ReactNode);
@@ -2055,6 +1989,25 @@ type ComboBoxProps<T extends Key = string> = Omit<ComboBoxProps$1<object>, 'chil
     defaultSelectedKey?: T;
     onSelectionChange?: (key: T | null) => void;
     emptyLabel?: ReactNode;
+    /** Shown in place of `emptyLabel` while `loadError` is set. */
+    errorLabel?: ReactNode;
+    /**
+     * How typed text narrows `options`. Defaults to `'contains'`. `'none'` also
+     * keeps the popover open on an empty collection: a list the kit does not
+     * filter can arrive empty from a server mid-query, and without that the
+     * popover closes and `emptyLabel` is never seen.
+     */
+    filter?: ComboBoxFilter;
+    /** Marks the options as out of date while the next set is being fetched. */
+    isLoading?: boolean;
+    /** A failed load, shown as `errorLabel` rather than as an empty corpus. */
+    loadError?: unknown | null;
+    /**
+     * Fires when the user commits — Enter on the active option, a click on one,
+     * or Enter on text matching none of them when `allowsCustomValue` is set.
+     * Empty text commits nothing.
+     */
+    onCommit?: (commit: ComboBoxCommit<T>) => void;
     /**
      * `'fill'` (the default) takes the width of whatever row the combo box sits
      * in. `'fit'` sizes the input to its widest option, so it neither swallows a
@@ -2068,7 +2021,7 @@ type ComboBoxProps<T extends Key = string> = Omit<ComboBoxProps$1<object>, 'chil
  * type to filter; selection commits to `onSelectionChange`. When no value
  * is in the input, selection clears (key becomes null).
  */
-declare function ComboBox<T extends Key = string>(props: ComboBoxProps<T>): react_jsx_runtime.JSX.Element;
+declare function ComboBox<T extends Key$1 = string>(props: ComboBoxProps<T>): react_jsx_runtime.JSX.Element;
 /** Props for {@link ComboBoxItem}, on top of React Aria's `ListBoxItem` props. */
 type ComboBoxItemProps = Omit<ListBoxItemProps, 'className'> & {
     className?: string;
@@ -2197,6 +2150,20 @@ interface Point {
     y: number;
 }
 
+/**
+ * Tick placement for a numeric axis. Pure — no DOM, no React.
+ */
+/** What a tick label formatter knows about the column it is part of. */
+interface TickFormatCtx {
+    /** Places after the point that every label in the column shares. */
+    decimals: number;
+    /** Distance between neighboring ticks, or 0 when the ticks were given
+     *  explicitly and are not evenly spaced. */
+    step: number;
+}
+/** Turns a tick value into its label. */
+type TickFormatter = (value: number, ctx: TickFormatCtx) => string;
+
 /** Background grid configuration for a {@link Plot2D}. */
 interface GridSettings {
     /** Number of evenly-spaced internal grid lines per axis (excluding
@@ -2210,6 +2177,33 @@ interface AxesSettings {
     /** Stroke color override. When omitted, uses `var(--plot-axis)`. */
     color?: string;
 }
+/**
+ * Ticks along one axis of a {@link Plot2D}: a line across the plot at each
+ * tick value, and a label naming it. Every label in a column is formatted
+ * to the same number of decimal places.
+ */
+interface TickSettings {
+    /** Tick values in model space; any outside the range are skipped.
+     *  Omitted = round 1/2/5 steps, as many as `minSpacing` allows at the
+     *  plot's current size. */
+    values?: readonly number[];
+    /** Smallest gap between generated ticks, in px. Default 24 on y, 64 on x. */
+    minSpacing?: number;
+    /** A generated tick nearer either end of the axis than this is dropped,
+     *  so its label stays on the plot, in px. Default 4 on y, 16 on x. */
+    inset?: number;
+    /** Draw a line across the plot at each tick. Default true. */
+    lines?: boolean;
+    /** Where labels sit: `'inside'` the plot along its left (y) or bottom (x)
+     *  edge, `'outside'` it past that edge in space the caller leaves free,
+     *  or `false` for none. Default `'inside'`. */
+    labels?: 'inside' | 'outside' | false;
+    /** Space between a label and the plot edge it sits against, in px.
+     *  Default 4. */
+    gap?: number;
+    /** Label text for a tick. Default {@link formatTick}. */
+    format?: TickFormatter;
+}
 /** A pointer position given in both of the plot's coordinate systems. */
 interface Plot2DCoords {
     plot: Point;
@@ -2229,8 +2223,16 @@ interface Plot2DProps {
     /** Axis lines. `false` / `null` = no axes. Omitted = default-styled
      *  axes (on). Pass AxesSettings to customize. */
     axes?: AxesSettings | false | null;
+    /** Ticks at x values. `false` / `null` / omitted = none; `{}` = defaults. */
+    xTicks?: TickSettings | false | null;
+    /** Ticks at y values. `false` / `null` / omitted = none; `{}` = defaults. */
+    yTicks?: TickSettings | false | null;
     /** Forwarded to the underlying svg. Consumer opts into focus this way. */
     tabIndex?: number;
+    /** Default `'img'`. A plot holding focusable marks must not be an image,
+     *  whose children are presentational to assistive technology. */
+    role?: string;
+    'aria-label'?: string;
     className?: string;
     style?: CSSProperties;
     /** Pointer down on the SVG. Receives both plot- and model-space coords
@@ -2263,8 +2265,8 @@ interface Plot2DHandle {
     readonly height: number;
 }
 /**
- * An SVG plotting surface with an optional grid and axes. It draws the frame
- * and owns the model-space to plot-space mapping; the plotted content is
+ * An SVG plotting surface with an optional grid, axes and ticks. It draws the
+ * frame and owns the model-space to plot-space mapping; the plotted content is
  * whatever children are passed, positioned in plot space.
  */
 declare const Plot2D: react.ForwardRefExoticComponent<Plot2DProps & react.RefAttributes<Plot2DHandle>>;
@@ -2357,6 +2359,8 @@ interface CurveEditorProps {
     height: number;
     grid?: GridSettings | false | null;
     axes?: AxesSettings | false | null;
+    xTicks?: TickSettings | false | null;
+    yTicks?: TickSettings | false | null;
     curve?: CurveSettings | false | null;
     fill?: FillSettings | false | null;
     hideNonInteractive?: boolean;
@@ -2398,6 +2402,8 @@ interface PointPlotterProps {
     height: number;
     grid?: GridSettings | false | null;
     axes?: AxesSettings | false | null;
+    xTicks?: TickSettings | false | null;
+    yTicks?: TickSettings | false | null;
     /** Minimum allowed point count. User-initiated deletion is refused
      *  while `value.length <= minPoints`. */
     minPoints?: number;
@@ -2482,6 +2488,42 @@ declare function oklchToHex(L: number, C: number, Hdeg: number): string;
 /** Evaluates a {@link ChromaCurve} at a lightness, clamping outside its range. */
 declare function chromaAt(L: number, curve: ChromaCurve): number;
 
+type Key = string | number;
+/** An option list keyed to the value type its combo box commits. */
+type AsyncOption<T extends Key> = ComboBoxOption & {
+    value: T;
+};
+/** Options for {@link useAsyncOptions}. */
+type UseAsyncOptionsProps<T extends Key> = {
+    /**
+     * Fetches the options for a query. The signal aborts when a later keystroke
+     * supersedes this call, so a `fetch` should forward it.
+     */
+    load: (query: string, signal: AbortSignal) => Promise<ReadonlyArray<AsyncOption<T>>>;
+    /** Quiet period before a query is sent. */
+    debounceMs?: number;
+    /** Shorter queries are not sent, and empty the options. */
+    minLength?: number;
+};
+/** What {@link useAsyncOptions} returns, shaped to spread into a `ComboBox`. */
+type AsyncOptionsResult<T extends Key> = {
+    options: ReadonlyArray<AsyncOption<T>>;
+    isLoading: boolean;
+    loadError: unknown | null;
+    inputValue: string;
+    onInputChange: (next: string) => void;
+};
+/**
+ * Drives a combo box whose options come from a server: debounces the query,
+ * discards responses overtaken by a later one, and reports a failed load
+ * separately from an empty result.
+ *
+ * `options` holds the last *resolved* list and is never emptied to mean
+ * "working", so the previous results stay on screen — and stay arrowable —
+ * while the next request is in flight.
+ */
+declare function useAsyncOptions<T extends Key = string>({ load, debounceMs, minLength, }: UseAsyncOptionsProps<T>): AsyncOptionsResult<T>;
+
 /** One row in a reorderable list. */
 interface LayerListItem {
     id: string;
@@ -2625,5 +2667,5 @@ declare const MINUS_SIGN = "\u2212";
  */
 declare function formatNumber(value: number, options?: Intl.NumberFormatOptions): string;
 
-export { ActionBar, ActionsBar, Badge, Button, Callout, Checkbox, ComboBox, ComboBoxItem, CurveEditor, DataGrid, Dialog, Disclosure, DisclosureRow, DragHandleGlyph, EDGE_PROFILES, Field, ICON_PATHS, Icon, Input, KeyCap, KeySequence, MINUS_SIGN, NumberField, OptionsBar, Plot2D, PointPlotter, Powerline, Radio, RadioGroup, RangeSlider, Select, SelectItem, Sidebar, SidebarPanel, Slider, Switch, Tab, TabList, TabPanel, Tabs, ToggleBar, ToolButton, ToolGroup, ToolPalette, chromaAt, detectPlatform, dlog, fieldClasses, formatNumber, formatShortcut, formatShortcutParts, inferKeycapKind, isDebugEnabled, isPrefLeaf, keyGlyph, keySpecFromKey, keySpecsFromMods, oklchToHex, paintGradientTrack, prefValueAtPath, useReorderDragList, useRovingTabIndex, visiblePrefSubtree };
-export type { ActionBarProps, ActionsBarItem, ActionsBarProps, ActionsBarSize, ActionsBarVariant, AddPointMode, AnchorRenderProps, AxesSettings, BadgeProps, BadgeShape, BadgeSize, BadgeTone, BadgeVariant, BoundsCtx, BuiltInEdgeName, ButtonProps, ButtonSize, ButtonVariant, CalloutProps, CheckboxProps, ChromaCurve, ChromaCurvePoint, ComboBoxItemProps, ComboBoxOption, ComboBoxProps, ControlPoint, CurveDomain, CurveEditorProps, DataGridColumn, DataGridProps, DialogProps, DisclosureDirection, DisclosureProps, DisclosureRowProps, DragHandleGlyphProps, EdgeCap, EdgeProfile, EndpointMode, FieldOrientation, FieldProps, FillSettings, GradientTrackOpts, GridSettings, IconName, IconProps, InputProps, InterpolationMode, KeyCapProps, KeyCapVariant, KeySequenceProps, KeySpec, KeycapKind, LayerListItem, LogicalMod, LogicalModSpec, NumberFieldProps, OptionsBarItem, OptionsBarProps, OptionsBarSize, OptionsBarVariant, Platform, Plot2DCoords, Plot2DHandle, Plot2DProps, PointPlotterProps, PowerlineProps, PowerlineSegment, RadioGroupProps, RadioProps, RangeSliderProps, ReorderDragHandlers, ReorderDragState, RovingItem, RovingTabIndex, SelectItemProps, SelectOption, SelectProps, SidebarPanelProps, SidebarProps, SliderProps, SwitchProps, TabListProps, TabPanelProps, TabProps, TabsProps, Thumb, ThumbRenderCtx, ThumbShape, ToggleBarItem, ToggleBarProps, ToggleBarSize, ToggleBarVariant, ToolButtonProps, ToolGroupProps, ToolPaletteProps, TrackCtx, UseReorderDragListOptions, UseRovingTabIndexOptions };
+export { ActionBar, ActionsBar, Badge, Callout, Checkbox, ComboBox, ComboBoxItem, CurveEditor, DataGrid, Dialog, Disclosure, DisclosureRow, DragHandleGlyph, EDGE_PROFILES, Field, ICON_PATHS, Icon, Input, KeyCap, KeySequence, MINUS_SIGN, MenuButton, NumberField, OptionsBar, Plot2D, PointPlotter, Powerline, Radio, RadioGroup, RangeSlider, Select, SelectItem, Sidebar, SidebarPanel, Slider, Switch, Tab, TabList, TabPanel, Tabs, ToolButton, ToolGroup, ToolPalette, chromaAt, detectPlatform, dlog, fieldClasses, formatNumber, formatShortcut, formatShortcutParts, inferKeycapKind, isDebugEnabled, isPrefLeaf, keyGlyph, keySpecFromKey, keySpecsFromMods, oklchToHex, paintGradientTrack, prefValueAtPath, useAsyncOptions, useReorderDragList, useRovingTabIndex, visiblePrefSubtree };
+export type { ActionBarProps, ActionsBarItem, ActionsBarProps, ActionsBarSize, ActionsBarVariant, AddPointMode, AnchorRenderProps, AsyncOption, AsyncOptionsResult, AxesSettings, BadgeProps, BadgeShape, BadgeSize, BadgeTone, BadgeVariant, BoundsCtx, BuiltInEdgeName, CalloutProps, CheckboxProps, ChromaCurve, ChromaCurvePoint, ComboBoxCommit, ComboBoxFilter, ComboBoxItemProps, ComboBoxOption, ComboBoxProps, ControlPoint, CurveDomain, CurveEditorProps, DataGridColumn, DataGridProps, DialogProps, DisclosureDirection, DisclosureProps, DisclosureRowProps, DragHandleGlyphProps, EdgeCap, EdgeProfile, EndpointMode, FieldOrientation, FieldProps, FillSettings, GradientTrackOpts, GridSettings, IconName, IconProps, InputProps, InterpolationMode, KeyCapProps, KeyCapVariant, KeySequenceProps, KeySpec, KeycapKind, LayerListItem, LogicalMod, LogicalModSpec, MenuButtonItem, MenuButtonProps, NumberFieldProps, OptionsBarItem, OptionsBarProps, OptionsBarSize, OptionsBarVariant, Platform, Plot2DCoords, Plot2DHandle, Plot2DProps, PointPlotterProps, PowerlineProps, PowerlineSegment, RadioGroupProps, RadioProps, RangeSliderProps, ReorderDragHandlers, ReorderDragState, RovingItem, RovingTabIndex, SelectItemProps, SelectOption, SelectProps, SidebarPanelProps, SidebarProps, SliderProps, SwitchProps, TabListProps, TabPanelProps, TabProps, TabsProps, Thumb, ThumbRenderCtx, ThumbShape, ToolButtonProps, ToolGroupProps, ToolPaletteProps, TrackCtx, UseAsyncOptionsProps, UseReorderDragListOptions, UseRovingTabIndexOptions };

package/dist/passthrough/weasel-ui.js

@@ -1,4 +1,4 @@
 import '../chunk-SBXNQW4G.js';
-export { m as ActionBar, r8 as ActionsBar, Lt as Badge, a3 as Button, g3 as Callout, l5 as CalloutTrigger, o as Checkbox, g2 as ComboBox, v3 as ComboBoxItem, L as CurveEditor, s2 as DataGrid, l3 as Dialog, r5 as Disclosure, i2 as DisclosureRow, n4 as DragHandleGlyph, Je as EDGE_PROFILES, n2 as Field, t as ICON_PATHS, r as Icon, u2 as Input, s3 as KeyCap, c2 as KeySequence, c3 as LayerStack, e2 as MINUS_SIGN, f2 as NumberField, r7 as OptionsBar, f3 as Plot2D, n7 as PointPlotter, r9 as Powerline, u3 as Radio, l as RadioGroup, l2 as RangeSlider, g as Select, b2 as SelectItem, n5 as Sidebar, s4 as SidebarPanel, y2 as Slider, a2 as Switch, c4 as Tab, s5 as TabList, l4 as TabPanel, o4 as Tabs, r6 as ToggleBar, o3 as ToolButton, n6 as ToolGroup, _2 as ToolPalette, Jn as chromaAt, u4 as detectPlatform, a as dlog, r3 as fieldClasses, t3 as formatNumber, d2 as formatShortcut, u5 as formatShortcutParts, o2 as inferKeycapKind, i as isDebugEnabled, t2 as isPrefLeaf, e as keyGlyph, p2 as keySpecFromKey, d as keySpecsFromMods, qn as oklchToHex, v2 as paintGradientTrack, n3 as prefValueAtPath, s as useReorderDragList, a4 as useRovingTabIndex, r4 as visiblePrefSubtree } from '../chunk-W3ECWC2K.js';
+export { m as ActionBar, r8 as ActionsBar, Lt as Badge, a3 as Button, g3 as Callout, l6 as CalloutTrigger, o as Checkbox, y3 as ComboBox, S as ComboBoxItem, P2 as CurveEditor, s2 as DataGrid, l3 as Dialog, r5 as Disclosure, i3 as DisclosureRow, n4 as DragHandleGlyph, Je as EDGE_PROFILES, n2 as Field, t as ICON_PATHS, r as Icon, u2 as Input, s3 as KeyCap, c2 as KeySequence, c3 as LayerStack, e as MINUS_SIGN, l5 as MenuButton, g2 as NumberField, r7 as OptionsBar, w2 as Plot2D, n7 as PointPlotter, r9 as Powerline, u3 as Radio, l as RadioGroup, l2 as RangeSlider, g as Select, b2 as SelectItem, n5 as Sidebar, s4 as SidebarPanel, y2 as Slider, a2 as Switch, c4 as Tab, s5 as TabList, l4 as TabPanel, o4 as Tabs, r6 as ToggleBar, o3 as ToolButton, n6 as ToolGroup, _2 as ToolPalette, dr as chromaAt, u4 as detectPlatform, a as dlog, r3 as fieldClasses, t2 as formatNumber, d2 as formatShortcut, u5 as formatShortcutParts, o2 as inferKeycapKind, i as isDebugEnabled, n3 as isPrefLeaf, e2 as keyGlyph, p2 as keySpecFromKey, d as keySpecsFromMods, ur as oklchToHex, v2 as paintGradientTrack, r4 as prefValueAtPath, fr as useAsyncOptions, s as useReorderDragList, a4 as useRovingTabIndex, i2 as visiblePrefSubtree } from '../chunk-S2SHZRD7.js';
 //# sourceMappingURL=weasel-ui.js.map
 //# sourceMappingURL=weasel-ui.js.map

package/dist/primitives/index.d.ts

@@ -12,8 +12,10 @@ interface FloatingPanelProps {
     snapCorners?: readonly Corner[];
     /** Pixels in from a corner when snapped. Default 12. */
     inset?: number;
-    /** localStorage key to remember its position under. Omit to forget on reload. */
-    storageKey?: string;
+    /** Name to remember its position under, through `usePersistedState` — so it
+     *  is remembered only inside a lab or a `<Persistence>`. Omit to forget on
+     *  reload. */
+    persist?: string;
     className?: string;
 }
 /**
@@ -24,7 +26,7 @@ interface FloatingPanelProps {
  * model would be all cost. Pointer handling is therefore this component's, and
  * windease's own affordance rendering never participates.
  */
-declare function FloatingPanel({ children, anchor, snapCorners, inset, storageKey, className, }: FloatingPanelProps): react_jsx_runtime.JSX.Element;
+declare function FloatingPanel({ children, anchor, snapCorners, inset, persist, className, }: FloatingPanelProps): react_jsx_runtime.JSX.Element;
 
 /** A live frame-rate readout, averaged over the last 30 frames. */
 declare function FpsMeter(): react_jsx_runtime.JSX.Element;
@@ -84,6 +86,51 @@ interface SidebarProps {
  *  caller's to hold. */
 declare function Sidebar({ children, title, collapsed, onToggle }: SidebarProps): react_jsx_runtime.JSX.Element;
 
+/** Props for `<Split>`. */
+interface SplitProps {
+    /** The sidebar pane's contents. */
+    sidebar: ReactNode;
+    /** The content pane's contents. */
+    children: ReactNode;
+    /** Names the sidebar pane, and through it the seam. Default `'Sidebar'`. */
+    label?: string;
+    /** Extra classes on the strip, which always has `lk-split`. */
+    className?: string;
+    /** The class on the sidebar pane. */
+    sidebarClassName?: string;
+    /** The class on the content pane. */
+    contentClassName?: string;
+    /** The sidebar's current extent in pixels. Omit to leave it unpersisted: the
+     *  seam still works, its result just does not outlive the mount. */
+    width?: number;
+    /** Where the sidebar starts before anyone drags it. */
+    defaultWidth?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    /** How little the content pane may be squeezed to. Reported as the seam's
+     *  reachable maximum, so the drag stops there rather than clamping silently. */
+    contentMinWidth?: number;
+    /** Fires through the drag, not on release: the pane is already there. */
+    onWidthChange?: (width: number) => void;
+    /**
+     * Fixed extent. Omit in an app — the strip measures its own box. Supply it
+     * where nothing measures, notably jsdom, or both panes lay out at zero.
+     */
+    viewport?: {
+        w: number;
+        h: number;
+    };
+}
+/**
+ * A sidebar and a content pane as a two-pane strip with a draggable seam.
+ *
+ * The seam is `stripStrategy`'s own resize affordance, so it arrives as a
+ * `role="separator"` carrying the reachable range, operable by pointer and by
+ * arrows / Home / End, and clamped against the content pane's floor rather
+ * than against the sidebar's alone.
+ */
+declare function Split({ sidebar, children, label, className, sidebarClassName, contentClassName, width, defaultWidth, minWidth, maxWidth, contentMinWidth, onWidthChange, viewport, }: SplitProps): react_jsx_runtime.JSX.Element;
+
 /** Props for `<StatusBar>`. */
 interface StatusBarProps {
     children: ReactNode;
@@ -160,7 +207,7 @@ interface ZoomControlProps {
 /** Zoom as a log-scaled slider with an editable percentage beside it. Pair it
  *  with zoom-in / zoom-out buttons in a `<Toolbar.Group>`; this component owns
  *  only the continuous part. */
-declare function ZoomControl({ zoom, onZoomChange, onZoomCommit, min, max, className, }: ZoomControlProps): react_jsx_runtime.JSX.Element;
+declare function ZoomControl({ zoom, onZoomChange, onZoomCommit, min: minProp, max: maxProp, className, }: ZoomControlProps): react_jsx_runtime.JSX.Element;
 
-export { FloatingPanel, FpsMeter, JobProgress, Legend, ScaleIndicator, Sidebar, StatusBar, Toolbar, ZoomControl };
-export type { FloatingPanelProps, JobProgressProps, LegendEntry, LegendMark, LegendProps, ScaleIndicatorProps, SidebarProps, StatusBarProps, StatusBarSectionProps, ToolbarButtonProps, ToolbarGroupProps, ToolbarProps, ZoomControlProps };
+export { FloatingPanel, FpsMeter, JobProgress, Legend, ScaleIndicator, Sidebar, Split, StatusBar, Toolbar, ZoomControl };
+export type { FloatingPanelProps, JobProgressProps, LegendEntry, LegendMark, LegendProps, ScaleIndicatorProps, SidebarProps, SplitProps, StatusBarProps, StatusBarSectionProps, ToolbarButtonProps, ToolbarGroupProps, ToolbarProps, ZoomControlProps };

package/dist/primitives/index.js

@@ -1,7 +1,9 @@
-export { FloatingPanel, JobProgress, Legend, Sidebar } from '../chunk-MOM3GOVY.js';
-export { FpsMeter, ScaleIndicator, StatusBar, Toolbar, ZoomControl } from '../chunk-SMHP6XZ4.js';
-import '../chunk-SBXNQW4G.js';
-import '../chunk-W3ECWC2K.js';
+export { FloatingPanel, JobProgress, Legend, Sidebar, Split } from '../chunk-EKIICY6X.js';
+export { FpsMeter, ScaleIndicator, StatusBar, Toolbar, ZoomControl } from '../chunk-KJALCDWE.js';
+import '../chunk-RWNDDKOH.js';
 import '../chunk-CQLQPQ4P.js';
+import '../chunk-2YILQ7Y5.js';
+import '../chunk-SBXNQW4G.js';
+import '../chunk-S2SHZRD7.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/state/index.d.ts

@@ -1,12 +1,13 @@
-export { C as CURRENT_DOCUMENT_VERSION, L as LabStore, a as LabStoreActions, b as LabStoreContext, c as LabStoreProvider, T as TrialIdContext, d as TrialIdProvider, e as createLabStore, f as createMemoryAdapter, l as labDocumentKey, g as localStorageAdapter, n as noneAdapter, q as quarantineKey, s as sessionStorageAdapter, u as urlHashAdapter, h as useLabStore, i as useTrialId, j as useTrialState } from '../_dts/useTrialState-D6Vb3T-g.js';
-import { S as SerializedTrial, I as InstrumentSerializers, T as TrialRecord, U as UndoStack, a as StorageAdapter } from '../_dts/types-BP2OCcpg.js';
-export { C as CreateLabStoreOptions, L as LabDocument, b as LabStoreState, M as Migration, c as SavedSnapshot, d as TrialStateHandle, e as UndockedPanel, f as UndockedPanels, g as dockPanel, p as panelKey, u as undockPanel } from '../_dts/types-BP2OCcpg.js';
+export { C as CURRENT_DOCUMENT_VERSION, I as IndexedDbAdapterOptions, L as LabStore, a as LabStoreActions, b as LabStoreContext, c as LabStoreProvider, O as OpenLabStoreOptions, d as OpenedLabStore, P as PersistedStateOptions, e as Persistence, f as PersistenceProps, R as RecordCache, g as RecordChange, T as TrialIdContext, h as TrialIdProvider, i as createIndexedDbAdapter, j as createLabStore, k as createMemoryAdapter, l as indexedDbAdapter, m as labDocumentKey, n as localStorageAdapter, o as noneAdapter, p as openLabStore, q as quarantineKey, s as sessionStorageAdapter, u as urlHashAdapter, r as useLabStore, t as usePersistedState, v as useTrialId, w as useTrialState } from '../_dts/useTrialState-jcx_TdU6.js';
+import { S as SerializedTrial, I as InstrumentSerializers, T as TrialRecord, U as UndoStack, c as StorageAdapter } from '../_dts/frac-8R6UmlvN.js';
+export { C as CreateLabStoreOptions, L as LabDocument, d as LabStoreState, M as Migration, e as SavedSnapshot, f as StorageChange, g as TrialStateHandle, h as UndockedPanel, i as UndockedPanels, j as dockPanel, p as panelKey, u as undockPanel } from '../_dts/frac-8R6UmlvN.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import 'zustand/vanilla';
-import '../_dts/types-B9_zrHmb.js';
+import '../_dts/types-Ca2LCnPq.js';
 import '@weasel-js/core';
 import '../_dts/PrefsForm.d-DDHFANkc.js';
+import '../_dts/types-DJ79Tg5J.js';
 
 /** The storage key a lab writes one of its buckets under. Namespaced by
  *  `storageKey` so two labs sharing an origin do not collide. */
@@ -34,17 +35,21 @@ interface SingletonExperimentProviderProps<TS, TC> {
     id: string;
     initialConfig: TC;
     initialState: TS;
-    storage: StorageAdapter;
     storageKey: string;
+    /** Default: IndexedDB, or localStorage where IndexedDB will not open. */
+    storage?: StorageAdapter;
+    /** Rendered until the stored experiment has loaded. Default: nothing. */
+    fallback?: ReactNode;
     children: ReactNode;
 }
 /**
  * One-trial `<Lab>` substitute for single-screen experiments. Mounts
  * a `LabStoreProvider` + `TrialIdProvider` with one synthetic
  * trial, so `useTrialState` works without going through the
- * full `<Lab instruments={...}>` runtime.
+ * full `<Lab instruments={...}>` runtime. `storageKey` and `storage` are read
+ * once, at mount.
  */
-declare function SingletonExperimentProvider<TS, TC>({ id, initialConfig, initialState, storage, storageKey, children, }: SingletonExperimentProviderProps<TS, TC>): react_jsx_runtime.JSX.Element;
+declare function SingletonExperimentProvider<TS, TC>({ id, initialConfig, initialState, storage, storageKey, fallback, children, }: SingletonExperimentProviderProps<TS, TC>): react_jsx_runtime.JSX.Element;
 
 export { InstrumentSerializers, SerializedTrial, SingletonExperimentProvider, StorageAdapter, TrialRecord, UndoStack, decodeUrlHash, deserializeTrials, emptyUndoStack, encodeUrlHash, labStorageKey, serializeTrials };
 export type { SingletonExperimentProviderProps };