@weasel-js/labkit 1.5.0 → 1.5.2

package/dist/index.d.ts

@@ -1,34 +1,47 @@
-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';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { I as IconProps } from './_dts/Select.d-ZTiwzYyT.js';
+export { B as Button, a as ButtonProps, b as ButtonSize, c as ButtonVariant, d as Icon, e as Input, f as InputProps, S as Select, g as SelectProps, T as ToggleBar, h as ToggleBarItem, i as ToggleBarProps, j as ToggleBarSize, k as ToggleBarVariant } from './_dts/Select.d-ZTiwzYyT.js';
+export { LayerStack, LayerStackItem, LayerStackProps } from './ui/layers/index.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { P as PropertyMetricProps, a as PropertyListPack } from './_dts/index-retnAut7.js';
-export { C as CheckboxRow, b as CheckboxRowProps, c as ColorRow, d as ColorRowProps, e as ControlPanel, N as NumberRow, f as NumberRowProps, g as PropertyList, h as PropertyListProps, i as PropertyOption, j as PropertyPanel, k as PropertyPanelProps, l as PropertyRow, m as PropertyRowLayout, n as PropertyRowProps, o as PropertyRowVariant, p as PropertySpan, q as PropertySpanProps, S as SelectRow, r as SelectRowProps, s as SliderRow, t as SliderRowProps, T as TextRow, u as TextRowProps, v as ToggleRow, w as ToggleRowProps } from './_dts/index-retnAut7.js';
-import { DrawCommand, SceneNode, View, Path, FillStyle, StyledRun, TextStyle, Stroke, BuiltinToolId } from '@weasel-js/core';
-import { t as WorldRect, A as AnnotationData, v as AnnotationMeaning, w as MarkScene, x as CaptureSource, y as CaptureOptions, z as CaptureResult, B as AnnotationTarget, E as AnnotationsApi, F as AnnotationsCapability, G as TrialInfo, H as TrialTool, J as AnnotationKind, k as ViewTransform, K as Instrument, q as InstrumentList, o as LabMode, N as TrialContribution, c as StorageAdapter, T as TrialRecord } from './_dts/frac-8R6UmlvN.js';
-export { O as Annotation, Q as AnnotationInit, R as AnnotationPatch, X as AnnotationQuery, Y as AnnotationStatus, Z as AnnotationStoreOptions, _ as AnnotationTargetInfo, $ as CanvasCapability, a0 as CanvasLayer, a1 as CaptureDeps, a2 as ContributionBase, C as CreateLabStoreOptions, D as DEFAULT_FRAME, n as DragDropCapability, m as DragFeedback, a3 as FracPoint, a4 as FracRect, a5 as HitResult, a6 as IconComponent, a7 as LOUPE_DEFAULTS, L as LabDocument, d as LabStoreState, a8 as LayerCapability, a9 as LayerDescriptor, aa as LoupeCapability, ab as LoupeDeclaration, ac as LoupeRenderArgs, P as PaletteItem, l as Point, ad as RegionContribution, ae as RenderContext, af as ResolvedLoupe, e as SavedSnapshot, ag as SerializedAnnotations, S as SerializedTrial, ah as SidebarSection, ai as SidebarSlotContext, aj as StageCapability, ak as StatusReadout, f as StorageChange, al as SystemEvent, am as ToolCapability, an as ToolItem, ao as ToolSlotContext, ap as ToolbarItem, aq as TrialChromeContext, ar as TrialRegion, g as TrialStateHandle, as as UndoCapability, U as UndoStack, h as UndockedPanel, i as UndockedPanels, at as ViewportControl, V as ViewportSize, W as WorldFrame, a as WorldSpec, au as annotationsFromJSON, b as applyCamera, av as createAnnotationScene, aw as createAnnotationStore, j as dockPanel, ax as fracContains, ay as fracEncloses, az as fracToWorld, p as panelKey, r as resolveFrame, aA as resolveLoupe, aB as roundFrac, u as undockPanel, aC as worldToFrac } from './_dts/frac-8R6UmlvN.js';
-export { C as CanvasStack, a as CanvasStackProps, O as OrbitHandlers, b as OrbitView, P as PITCH_LIMIT, c as PanZoomHandlers, S as Stage, d as StageProps, U as UseOrbitOptions, e as UsePanZoomOptions, V as Vec3, Z as ZoomAtOptions, f as centerOn, g as clampPitch, h as fitStage, o as orbitAfterDrag, i as orbitAfterWheel, s as screenToWorld, u as useOrbit, j as usePanZoom, w as worldToScreen, k as wrapYaw, z as zoomAt } from './_dts/usePanZoom-nS798rOF.js';
-export { C as CanvasLayerDescriptor, a as CanvasStackContext, b as CanvasStackContextValue, c as CanvasStackSurface } from './_dts/CanvasStackContext-CqkxkFJW.js';
-import { L as LabContribution } from './_dts/index-B8uu2ba7.js';
-export { A as AddTrialOptions, a as LabChromeContext, b as LabContext, c as LabContextValue, d as LabFooterRegion, e as LabHeaderRegion, f as LabRegion, g as LabRegionProps, h as LabSidebarRegion, P as PaletteRegion, i as PaletteRegionProps, S as SidebarRegion, j as SidebarRegionProps, k as StatusRegion, l as StatusRegionProps, T as TitleBarPlacement, m as TitleBarRegion, n as TitleBarRegionProps, o as ToolbarRegion, p as ToolbarRegionProps, V as ViewportRegion, q as ViewportRegionProps, r as addTrial, s as builtinContributions, t as cloneTrial, u as closeTrial, v as contributionsIn, w as labContributions, x as mergeContributions, y as reorderTrials, z as resetTrial, B as suppressContributions, C as toolContributions, D as useLabChromeContext, E as useLabContext } from './_dts/index-B8uu2ba7.js';
-export { BaseNode, BooleanNode, ColorNode, CustomNode, EnumNode, GroupNode, NumberNode, StringNode, ValueNode, applyRules, builtinRules, f, fillConfigDefaults, fromConfigFields, hasConfigPath, isConfigBranch, isLeafVisible, resolveConfigSchema, schemaNodeAtPath, titleCase, useConfigSchema, valueAtPath, withValueAtPath } from './config/index.js';
-import { b as ConfigSchema, a as ConfigField, c as ConfigRule, d as ControlRenderer } from './_dts/types-Ca2LCnPq.js';
-export { A as Annotations, B as BranchAnnotations, e as BranchOptions, f as CheckboxField, g as ColorField, h as ConfigBranch, i as ConfigEntry, j as ConfigFieldBase, k as ConfigFieldType, l as ConfigNode, m as ConfigOf, n as ConfigOption, C as ConfigPath, o as ConfigRuleContext, p as ConfigShape, E as EntryValue, I as InferConfig, L as LeafPatch, N as NodeOptions, q as NodeValue, r as NumberField, R as ResolvedConfig, S as SectionSpec, s as SelectField, t as SelectOption, u as SliderField, T as TextField, V as ValueAtPath } from './_dts/types-Ca2LCnPq.js';
+import { P as PropertyMetricProps, a as PropertyListPack } from './_dts/index-8LiKe3A-.js';
+export { C as CheckboxRow, b as CheckboxRowProps, c as ColorRow, d as ColorRowProps, e as ControlPanel, N as NumberRow, f as NumberRowProps, g as PropertyList, h as PropertyListProps, i as PropertyOption, j as PropertyPanel, k as PropertyPanelProps, l as PropertyRow, m as PropertyRowLayout, n as PropertyRowProps, o as PropertyRowVariant, p as PropertySpan, q as PropertySpanProps, S as SelectRow, r as SelectRowProps, s as SliderRow, t as SliderRowProps, T as TextRow, u as TextRowProps, v as ToggleRow, w as ToggleRowProps } from './_dts/index-8LiKe3A-.js';
+import { DrawCommand, SceneNode, View, Path, FillStyle, ScreenLength, StrokeAlign, StyledRun, TextStyle, TextVerticalAlign, Stroke, BuiltinToolId } from '@weasel-js/core';
+import { t as WorldRect, A as AnnotationData, v as AnnotationMeaning, w as MarkScene, x as CaptureSource, y as CaptureOptions, z as CaptureResult, B as AnnotationTarget, E as AnnotationsApi, F as AnnotationsCapability, G as TrialInfo, H as TrialTool, J as AnnotationKind, k as ViewTransform, K as Instrument, q as InstrumentList, o as LabMode, N as LabDensity, O as TrialContribution, c as StorageAdapter, T as TrialRecord } from './_dts/frac-B4hFJMiN.js';
+export { Q as Annotation, R as AnnotationInit, X as AnnotationPatch, Y as AnnotationQuery, Z as AnnotationStatus, _ as AnnotationStoreOptions, $ as AnnotationTargetInfo, a0 as Auto, a1 as CanvasCapability, a2 as CanvasLayer, a3 as CaptureDeps, a4 as ContributionBase, C as CreateLabStoreOptions, D as DEFAULT_FRAME, n as DragDropCapability, m as DragFeedback, a5 as FracPoint, a6 as FracRect, a7 as HitResult, a8 as IconComponent, a9 as LOUPE_DEFAULTS, L as LabDocument, d as LabStoreState, aa as LayerCapability, ab as LayerDescriptor, ac as LoupeCapability, ad as LoupeDeclaration, ae as LoupeRenderArgs, P as PaletteItem, l as Point, af as RegionContribution, ag as RenderContext, ah as ResolvedLoupe, e as SavedSnapshot, ai as SerializedAnnotations, S as SerializedTrial, aj as SidebarSection, ak as SidebarSlotContext, al as StageCapability, am as StatusReadout, f as StorageChange, an as SystemEvent, ao as ToolCapability, ap as ToolItem, aq as ToolSlotContext, ar as ToolbarItem, as as TrialChromeContext, at as TrialRegion, g as TrialStateHandle, au as UndoCapability, U as UndoStack, h as UndockedPanel, i as UndockedPanels, av as ViewportControl, V as ViewportSize, W as WorldFrame, a as WorldSpec, aw as annotationsFromJSON, b as applyCamera, ax as auto, ay as createAnnotationScene, az as createAnnotationStore, j as dockPanel, aA as fracContains, aB as fracEncloses, aC as fracToWorld, aD as isAuto, p as panelKey, r as resolveFrame, aE as resolveLoupe, aF as roundFrac, u as undockPanel, aG as worldToFrac } from './_dts/frac-B4hFJMiN.js';
+export { C as CanvasStack, a as CanvasStackProps, P as PanZoomHandlers, S as Stage, b as StageProps, U as UsePanZoomOptions, Z as ZoomAtOptions, c as centerOn, f as fitStage, s as screenToWorld, u as usePanZoom, w as worldToScreen, z as zoomAt } from './_dts/usePanZoom-SSTZe410.js';
+export { C as CanvasLayerDescriptor, a as CanvasStackContext, b as CanvasStackContextValue, c as CanvasStackSurface } from './_dts/CanvasStackContext-CMMo180l.js';
+import { L as LabContribution } from './_dts/index-DlKolEIZ.js';
+export { A as AddTrialOptions, a as LabAsideRegion, b as LabChromeContext, c as LabContext, d as LabContextValue, e as LabFooterRegion, f as LabHeaderRegion, g as LabRegion, h as LabRegionProps, i as LabSidebarRegion, P as PaletteRegion, j as PaletteRegionProps, S as SidebarRegion, k as SidebarRegionProps, l as StatusRegion, m as StatusRegionProps, T as TitleBarPlacement, n as TitleBarRegion, o as TitleBarRegionProps, p as ToolbarRegion, q as ToolbarRegionProps, V as ViewportRegion, r as ViewportRegionProps, s as addTrial, t as builtinContributions, u as cloneTrial, v as closeTrial, w as contributionsIn, x as labContributions, y as mergeContributions, z as reorderTrials, B as resetTrial, C as suppressContributions, D as toolContributions, E as useLabChromeContext, F as useLabContext } from './_dts/index-DlKolEIZ.js';
+export { BaseNode, BooleanNode, ColorNode, CustomNode, EnumNode, GroupNode, NumberNode, StringNode, ValueNode, applyRules, autoPathsOf, builtinRules, f, fillConfigDefaults, fromConfigFields, hasConfigPath, isConfigBranch, isLeafVisible, resolveAutoConfig, resolveConfigSchema, schemaNodeAtPath, titleCase, useConfigSchema, useResolvedConfig, valueAtPath, withValueAtPath } from './config/index.js';
+import { b as ConfigSchema, a as ConfigField, c as ConfigRule, d as ControlRenderer } from './_dts/types-Db-3NNk1.js';
+export { A as Annotations, B as BranchAnnotations, e as BranchOptions, f as CheckboxField, g as ColorField, h as ConfigBranch, i as ConfigEntry, j as ConfigFieldBase, k as ConfigFieldType, l as ConfigNode, m as ConfigOf, n as ConfigOption, C as ConfigPath, o as ConfigRuleContext, p as ConfigShape, E as EntryValue, I as InferConfig, L as LeafPatch, N as NodeOptions, q as NodeValue, r as NumberField, R as ResolvedConfig, S as SectionSpec, s as SelectField, t as SelectOption, u as SliderField, T as TextField, V as ValueAtPath } from './_dts/types-Db-3NNk1.js';
 import { J as JobHandle } from './_dts/types-DJ79Tg5J.js';
 export { a as JobCapability, b as JobEvent, c as JobFailure, d as JobStatus } from './_dts/types-DJ79Tg5J.js';
 export { UseJobOptions, useJob } from './job/index.js';
 export { LayerList, LayerListProps, LayerTreeNode } from './layers/index.js';
-export { CanvasLoupe, CanvasLoupeProps, DomLoupe, DomLoupeProps, LensCamera, LoupeBubble, LoupeBubbleProps, LoupeState, SourceRect, TrialLoupe, TrialLoupeProps, UseLoupeOptions, drawCanvasLens, lensCamera, lensSourceRect, sampleStack, useLoupe } from './loupe/index.js';
+export { CanvasLoupe, CanvasLoupeProps, DomLoupe, DomLoupeProps, LOUPE_MAGNIFY_ID, LOUPE_PEEK_ID, LensCamera, LoupeBubble, LoupeBubbleProps, LoupeGestures, LoupeGesturesProps, LoupeInputApi, LoupeState, SourceRect, TrialLoupe, TrialLoupeProps, UseLoupeOptions, createLoupeActions, drawCanvasLens, lensCamera, lensSourceRect, sampleStack, useLoupe } from './loupe/index.js';
 import { SplitProps } from './primitives/index.js';
 export { FloatingPanel, FloatingPanelProps, FpsMeter, JobProgress, JobProgressProps, Legend, LegendEntry, LegendMark, LegendProps, ScaleIndicator, ScaleIndicatorProps, Sidebar, SidebarProps, Split, StatusBar, StatusBarProps, StatusBarSectionProps, Toolbar, ToolbarButtonProps, ToolbarGroupProps, ToolbarProps, ZoomControl, ZoomControlProps } from './primitives/index.js';
-export { C as CURRENT_DOCUMENT_VERSION, I as IndexedDbAdapterOptions, 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, 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';
+export { C as CURRENT_DOCUMENT_VERSION, I as IndexedDbAdapterOptions, 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, 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-pnAE-UBD.js';
 export { Box, Rect, SurfaceCanvasContext, SurfaceCanvases, SurfaceClear, SurfaceContext, SurfaceFrame, SurfaceHandle, SurfaceLayer, TilePainter, UseTiledSurfaceOptions, composeRects, rectsEqual, toDeviceRect, useSurface, useSurfaceCanvas, useSurfaceOptional, useSurfaceTile, useTileId, useTiledSurface } from './surface/index.js';
+import { Theme } from '@weasel-js/theme';
 export { EventBus, EventListener, clearUndo, createEventBus, emptyStack, pushSnapshot, redo, undo } from './undo/index.js';
-import './_dts/PrefsForm.d-DDHFANkc.js';
+import 'react-aria-components';
+import './_dts/PrefsForm.d-DPy9I8It.js';
 import 'windease';
 import 'zustand/vanilla';
 
+declare const ResetIcon: (p: IconProps) => react_jsx_runtime.JSX.Element;
+declare const CloseIcon: (p: IconProps) => react_jsx_runtime.JSX.Element;
+declare const PlayIcon: (p: IconProps) => react_jsx_runtime.JSX.Element;
+declare const PauseIcon: (p: IconProps) => react_jsx_runtime.JSX.Element;
+declare const StopIcon: (p: IconProps) => react_jsx_runtime.JSX.Element;
+declare const StepBackIcon: (p: IconProps) => react_jsx_runtime.JSX.Element;
+declare const StepForwardIcon: (p: IconProps) => react_jsx_runtime.JSX.Element;
+declare const CollapseIcon: (p: IconProps) => react_jsx_runtime.JSX.Element;
+declare const ExpandIcon: (p: IconProps) => react_jsx_runtime.JSX.Element;
+
 /** An annotation drawn over a curve plot: a shaded band across a range of x,
  *  or a vertical line at one x. */
 type CurveMark = {
@@ -137,6 +150,9 @@ declare function EffectCardList<T extends EffectCardListItem>({ items, renderIte
 interface PropertyGroupProps extends PropertyMetricProps {
     /** Title rendered between two rules at the top of the group. */
     title: ReactNode;
+    /** Help text for the whole group, drawn under the title and above the
+     *  rows. `<PropertyRow description>` covers the per-row case. */
+    description?: ReactNode;
     /** When true the group renders nothing — useful for conditional sections. */
     hidden?: boolean;
     /**
@@ -156,6 +172,9 @@ interface PropertyGroupProps extends PropertyMetricProps {
     onCollapsedChange?: (next: boolean) => void;
     children: ReactNode;
     className?: string;
+    /** Take the whole width of a packed grid, like `<PropertyRow span>`: a group
+     *  lays its own rows out, so half a column leaves them overlapping. */
+    span?: boolean;
     /** How rows pack into the 2-column grid — see `<PropertyList pack>`. */
     pack?: PropertyListPack;
 }
@@ -167,7 +186,112 @@ interface PropertyGroupProps extends PropertyMetricProps {
  * A collapsible group keeps its rows mounted and hides them, so a control's
  * local state survives being folded away.
  */
-declare function PropertyGroup({ title, hidden, collapsible, defaultCollapsed, collapsed, onCollapsedChange, children, className, pack, density, align, }: PropertyGroupProps): react_jsx_runtime.JSX.Element | null;
+declare function PropertyGroup({ title, description, hidden, collapsible, defaultCollapsed, collapsed, onCollapsedChange, children, className, span, pack, density, align, }: PropertyGroupProps): react_jsx_runtime.JSX.Element | null;
+
+/** A design token as `TokenPanel` edits it. */
+interface TokenEntry {
+    /** The custom property, e.g. `--wzl-gray-50`. */
+    name: string;
+    /** A DTCG type name. A type the panel has no control for edits as text. */
+    type: string;
+    /** Tokens sharing a group sit together; a color group large enough draws as one row of swatches. */
+    group: string;
+    value: string;
+    /** Whether `value` overrides the token's own, which offers Reset. */
+    overridden?: boolean;
+    description?: string;
+}
+/** How a scale's steps follow from its base: one multiplier per step, a constant ratio, or a constant step. */
+type TokenScaleRule = {
+    kind: 'factors';
+    factors: readonly number[];
+} | {
+    kind: 'ratio';
+    ratio: number;
+} | {
+    kind: 'step';
+    step: number;
+};
+/** A group whose steps are generated from a base, so the panel edits the base and the rule rather than each step. */
+interface TokenScale {
+    /** The generated tokens, smallest first. Anything else in the group draws as an ordinary step. */
+    tokens: readonly string[];
+    base: number;
+    rule: TokenScaleRule;
+}
+/**
+ * The same scale under another rule, fitted to the amounts its steps have now.
+ * A ratio or step counts from the first step, so switching to one moves the
+ * base there.
+ */
+declare function refitScale(scale: TokenScale, kind: TokenScaleRule['kind'], amounts: readonly number[]): TokenScale;
+type TokenCategory = 'color' | 'type' | 'size' | 'motion' | 'depth' | 'other';
+/** A DTCG type read off the shape of a value, for a token that arrives without one. `'string'` when nothing fits. */
+declare function inferTokenType(value: string): string;
+
+type OnChange = (name: string, value: string | null) => void;
+/** Props for `<TokenPanel>`. */
+interface TokenPanelProps {
+    tokens: readonly TokenEntry[];
+    /** A token's new value, or null to drop its override. Keep it stable: rows re-render only when it or their token changes. */
+    onChange: OnChange;
+    /** Sections held closed, by category. Omit to let the panel keep that state itself. */
+    collapsed?: Readonly<Partial<Record<TokenCategory, boolean>>>;
+    onCollapsedChange?: (category: TokenCategory, collapsed: boolean) => void;
+    /** Groups generated from a base, by group name. Such a group edits its base and rule above its steps. */
+    scales?: Readonly<Record<string, TokenScale>>;
+    /** A scale's new base or rule. The panel does not regenerate the steps; the consumer does, through `onChange`. */
+    onScaleChange?: (group: string, scale: TokenScale) => void;
+    /** Files a token under a section. Defaults to `tokenCategory`. */
+    categorize?: (token: TokenEntry) => TokenCategory;
+    /** The fewest colors, or sizes, sharing a group that draw as one row of swatches or one grid of steps. Default 3. */
+    familySize?: number;
+    /**
+     * Row layout. `tight` puts a token on one line — name, control, Reset — with the
+     * names on a fixed rail so the values read down the panel as a column, and caps
+     * the field rather than letting it span the panel. Default `normal` stacks the
+     * control under its name.
+     */
+    density?: 'tight' | 'normal';
+    className?: string;
+}
+/**
+ * Edits a set of design tokens by type: collapsible sections by category, a
+ * color group drawn as one row of swatches sized to fit, a group of sizes drawn
+ * as one grid of numbers labeled by step — with its base and rule above it when
+ * `scales` says how it is generated — and a control for each
+ * type — a number with its unit for dimensions and durations, the nine weights
+ * for a font weight, a curve beside a `cubic-bezier()`, a swatch beside a color,
+ * and text for everything else.
+ */
+declare function TokenPanel({ tokens, onChange, collapsed, onCollapsedChange, scales, onScaleChange, categorize, familySize, density, className, }: TokenPanelProps): react_jsx_runtime.JSX.Element;
+
+/** Props for {@link Jog}. */
+interface JogProps {
+    /** Which step is showing, 0-based. */
+    index: number;
+    /** How many steps there are. */
+    count: number;
+    playing: boolean;
+    onPlay: (playing: boolean) => void;
+    /** Move one step, back or forward. */
+    onStep: (by: -1 | 1) => void;
+    /** Jump to a step. Left out, no scrubber is drawn. */
+    onScrub?: (index: number) => void;
+    /** What one step is called, for the spoken labels. Defaults to `Step`. */
+    unit?: string;
+    /** Drawn after the readout — a beat's caption, a snapshot's date. */
+    caption?: ReactNode;
+    className?: string;
+}
+/**
+ * Transport for something counted rather than timed: beat 3 of 24, not 4.20s of 12.00s.
+ * `<Transport>` is the continuous-time one, and wants a playhead in milliseconds, a rate and
+ * a loop, none of which a list of steps has.
+ *
+ * Named for the jog of jog/shuttle — moving one frame at a time, as against running at speed.
+ */
+declare function Jog(props: JogProps): react_jsx_runtime.JSX.Element;
 
 /** The subset of a mark's scene node this needs: where it is, and what it is. */
 interface PaintableMark {
@@ -307,6 +431,8 @@ declare function seenFrom(config: unknown, keys: readonly string[]): Record<stri
  */
 declare function isStale(seen: Readonly<Record<string, unknown>> | undefined, config: unknown, keys: readonly string[]): boolean;
 
+type Mat3 = readonly [number, number, number, number, number, number];
+
 /**
  * Public types for `@weasel-js/svg`. The package exposes a flat,
  * discriminated-union node model (`SvgNode`) that mirrors the SVG element
@@ -354,10 +480,14 @@ interface NamespacedElement {
     children?: Record<string, NamespacedElement[]>;
 }
 /**
- * 2x3 affine matrix in column-major form (SVG's `matrix(a b c d e f)`
- * order). Maps `[x', y'] = [a*x + c*y + e, b*x + d*y + f]`.
+ * 2x3 affine matrix in SVG's `matrix(a b c d e f)` order, mapping
+ * `[x', y'] = [a*x + c*y + e, b*x + d*y + f]`.
+ *
+ * The same order the kernel's affine tier uses, so this is that type under
+ * the name the SVG spec gives it — not a parallel one. An `SvgGroupNode`'s
+ * transform and a geom `Mat3` are interchangeable without a conversion.
  */
-type Matrix = readonly [number, number, number, number, number, number];
+type Matrix = Mat3;
 /**
  * FillStyle description in the SVG sense — either explicit `none`, a solid
  * color, or a reference to a weasel-native gradient `FillStyle`. Solid colors
@@ -378,11 +508,9 @@ type SvgPaint = {
 interface SvgStroke {
     paint: SvgPaint;
     /** World units, or `{ px }` for a width that holds its rendered thickness
-     *  however the document is scaled — SVG's `vector-effect="non-scaling-stroke"`,
-     *  and the same unit system as the kit's `Stroke.width`. */
-    width: number | {
-        px: number;
-    };
+     *  however the document is scaled — SVG's `vector-effect="non-scaling-stroke"`.
+     *  Literally the kit's own unit, not a second spelling of it. */
+    width: ScreenLength;
     opacity?: number;
     /** `stroke-linecap`. Default per SVG spec is `'butt'`. */
     cap?: 'butt' | 'round' | 'square';
@@ -396,6 +524,10 @@ interface SvgStroke {
      * attribute may render with longer miters than the source SVG intended.
      */
     miterLimit?: number;
+    /** The kit stroke's `align`. SVG has no stroke alignment, so the serializer
+     *  writes the stroke centered and says so through `onWarn`; the parser
+     *  never sets it. */
+    align?: StrokeAlign;
     /** `marker-start` / `marker-mid` / `marker-end`, as the bare `url(#id)` key. */
     markerStart?: string;
     markerMid?: string;
@@ -431,6 +563,12 @@ interface SvgGroupNode {
     kind: 'group';
     children: SvgNode[];
     transform?: Matrix;
+    /** Clips the group's contents. Serializes to a `<clipPath>` def plus
+     *  `clip-path="url(#id)"`, and lives in the same space as `children` —
+     *  SVG applies the group's own `transform` to the clip as well.
+     *  A `<clipPath>` of more than one shape parses back as no clip: SVG
+     *  unions them and a `Path` holds one outline. */
+    clip?: Path;
     opacity?: number;
     /** Opaque per-element bag for declared namespaces. See `NamespaceMeta`. */
     meta?: NamespaceMeta;
@@ -464,6 +602,10 @@ interface SvgTextNode {
     runs?: StyledRun[];
     /** Node-wide typography. Defaults applied at render time via `resolveTextStyle`. */
     style?: TextStyle;
+    /** Where the laid-out text sits inside the box — `kit:text`'s
+     *  `data.verticalAlign`. SVG text has no box to align in, so this rides in
+     *  `data-weasel-vertical-align` and other readers draw the text top-aligned. */
+    verticalAlign?: TextVerticalAlign;
     /**
      * Node-wide glyph paint, the `FillStyle` / `Stroke` a kit text node holds
      * in `data.fill` / `data.stroke`. Not `SvgPaint`, which is the path
@@ -491,6 +633,12 @@ interface SvgTextNode {
  * a reference and only resolves when something downstream loads it.
  *
  * SVG's `preserveAspectRatio` is not modeled; the box is taken literally.
+ *
+ * With a `source` rect or a flip, the element is written as a `<g
+ * data-weasel-image>` holding a nested `<svg>` viewport at the box, whose
+ * `viewBox` is the source window over a unit-square `<image>` — plain SVG 1.1,
+ * which any reader crops and mirrors the same way, and which `parseSvg` reads
+ * back as one image node.
  */
 interface SvgImageNode {
     kind: 'image';
@@ -499,6 +647,20 @@ interface SvgImageNode {
     y: number;
     width: number;
     height: number;
+    /** The part of the bitmap drawn into the box, as fractions of the bitmap's
+     *  width and height from its top-left. Omitted draws the whole bitmap.
+     *  Fractions rather than bitmap pixels because this package never decodes
+     *  the image, so it cannot know its size. */
+    source?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Mirror the drawn region within the box, as `ImageDrawCommand` does. The
+     *  box does not move. */
+    flipX?: boolean;
+    flipY?: boolean;
     /** Element-level opacity (`opacity="..."`), 0..1. */
     opacity?: number;
     /** Element-level rotation in **radians**, pivoting around the unrotated
@@ -693,6 +855,10 @@ interface LabBaseProps {
     instruments: InstrumentList;
     defaultInstrument: string;
     mode?: LabMode;
+    /** How much room the lab's chrome takes. Default `'comfortable'`; a lab whose
+     *  window is the whole app, rather than a panel beside one, reads better at
+     *  `'roomy'`. The trials' own contents are unaffected. */
+    density?: LabDensity;
     /** Rendered while a stored lab loads. Default: the lab's empty shell. */
     fallback?: ReactNode;
     /**
@@ -748,7 +914,7 @@ type LabProps = LabBaseProps & ({
 });
 /** The lab runtime: opens the store, provides it, and renders one trial
  *  per record in a grid. Each trial runs one of `instruments`. */
-declare function Lab(props: LabProps): react_jsx_runtime.JSX.Element;
+declare function Lab(props: LabProps): string | number | bigint | boolean | react_jsx_runtime.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null;
 
 /** Props for `<LabPalette>`. */
 interface LabPaletteProps {
@@ -762,6 +928,26 @@ interface LabPaletteProps {
  *  the lab contributes no tool rail. */
 declare function LabPalette({ tools, contributions }: LabPaletteProps): react_jsx_runtime.JSX.Element;
 
+/** Props for `<LabRoot>`. */
+interface LabRootProps {
+    children: ReactNode;
+    /** Color mode. "auto" (default) follows prefers-color-scheme. */
+    mode?: LabMode;
+    /** Added after `lk-root` on the same element. */
+    className?: string;
+}
+/** The element every labkit component expects above it: `.lk-root`, which
+ *  carries the design tokens, the font stack, the box-sizing reset and the
+ *  element defaults a lab's bare markup is styled by, plus a theme when the
+ *  app has not already applied one.
+ *
+ *  `<LabShell>` and `<Lab>` render this themselves. Mount it by hand around a
+ *  labkit piece used on its own — a bare `<Workspace>` or `<ControlPanel>` —
+ *  or those components inherit whatever the host page happens to define.
+ *  Pair it with `import '@weasel-js/labkit/styles.css'`, which is what defines
+ *  the rules this element scopes. */
+declare function LabRoot({ children, mode, className }: LabRootProps): react_jsx_runtime.JSX.Element;
+
 /** Props for `<LabShell>`. */
 interface LabShellProps {
     title: string;
@@ -782,7 +968,7 @@ interface LabShellProps {
 /** Page frame for a lab: a titled header, a body, and an optional footer,
  *  themed for the resolved color mode. Presentational only — use `<Lab>` when
  *  the trial runtime is wanted too. */
-declare function LabShell({ title, children, header, footer, mode, pages, path }: LabShellProps): react_jsx_runtime.JSX.Element;
+declare function LabShell({ title, children, header, footer, mode, pages, path, }: LabShellProps): react_jsx_runtime.JSX.Element;
 
 /** A tile's persisted extent, keyed by the id its caller gave it. Grid resizes
  *  write `span`; `size` is here because a strategy swap would write that. */
@@ -846,6 +1032,18 @@ interface PanelDescriptor {
 }
 declare function Workspace({ children, ids, panels, resizable, reorderable, onReorder, layout, onLayoutChange, gap, padding, viewport, }: WorkspaceProps): react_jsx_runtime.JSX.Element;
 
+/** The specimen's sections, in page order. */
+declare const SPECIMEN_SECTIONS: readonly ["Buttons & toggles", "Fields & pickers", "Panels & property rows", "Overlays & feedback", "Lists & data", "Tool chrome", "Editors & plots", "Lab chrome"];
+/**
+ * One page of the kit's controls and chrome, each in a small working state: a
+ * preview surface for a theme, where every token has something on screen that
+ * reads it. Popovers, dialogs and toasts portal into the page itself, so they
+ * take whatever theme the page is under.
+ */
+declare function Specimen({ className }: {
+    className?: string;
+}): react_jsx_runtime.JSX.Element;
+
 /** The 2D view labkit has always shipped, and what a trial gets when it names no
  *  other. Re-exported under its own name so a consumer can say which it means. */
 type ViewTransform2D = ViewTransform;
@@ -854,40 +1052,10 @@ declare const DEFAULT_VIEW: ViewTransform2D;
  *  zoom chrome, `CanvasStack` — asks for it and handles not getting it. */
 declare function as2DView(view: unknown): ViewTransform2D | null;
 
-type TokenValue = string | number | readonly (string | number)[];
-/**
- * A single design token as authored, before aliases are resolved: a DTCG-shaped
- * `{ type, value }` pair where `value` may still be a `{ref}` to another token.
- */
-interface RawToken {
-    readonly type: string;
-    readonly value: TokenValue;
-    /** Render the referenced color at this alpha, 0–1. */
-    readonly alpha?: number | undefined;
-    readonly description?: string | undefined;
-}
-/** A token graph flattened to one level, keyed by token name (no `--wzl-`
- *  prefix). Still unresolved — see `ResolvedTokenMap` for the output side. */
-type FlatTokens = Record<string, RawToken>;
-/**
- * A theme: a named set of design tokens, organized into a mode-invariant layer
- * plus one layer per mode (light, dark, …), optionally extending another theme.
- * Tokens are held unresolved — aliases between them are collapsed later by
- * `resolveTheme`, so an override of a base primitive still reaches everything
- * that references it.
- */
-interface Theme {
-    readonly name: string;
-    readonly extends: Theme | null;
-    readonly defaultMode: string;
-    readonly tokens: FlatTokens;
-    readonly modes: Readonly<Record<string, FlatTokens>>;
-}
-
 /**
  * labkit's theme: a cosmic dark and a warm parchment light, extending the
- * built-in weasel theme. Authored as DTCG and loaded at import time — the
- * interchange path a theme exported from a design tool would take.
+ * built-in weasel theme. A pins-only theme definition: nothing in it is
+ * derived, so it loads without the engine.
  */
 declare const interstellarTheme: Theme;
 
@@ -958,5 +1126,5 @@ interface TrialChromeProps {
  *  each region its slice. */
 declare function TrialChrome({ trialId, record, instrument, isLastTrial, undoBindings, job, loupe, trialChrome, chrome, suppress, activeToolId, setActiveTool, children, }: TrialChromeProps): react_jsx_runtime.JSX.Element;
 
-export { ANNOTATION_TOOLS, ANNOTATION_WEASEL_TOOLS, AnnotationData, AnnotationKind, AnnotationMeaning, AnnotationOverlay, AnnotationTarget, AnnotationTargets, AnnotationsApi, AnnotationsCapability, AnnotationsContext, CaptureOptions, CaptureResult, CaptureSource, ConfigField, ConfigRule, ConfigSchema, ControlRenderer, CurveField, DEFAULT_VIEW, EffectCard, EffectCardList, ExportMenu, Instrument, InstrumentList, JobHandle, Lab, LabContribution, LabMode, LabPalette, LabShell, LabSwitcher, MarkList, MarkScene, PropertyGroup, PropertyListPack, SplitProps, StorageAdapter, Subpanel, Trial, TrialBody, TrialChrome, TrialContribution, TrialInfo, TrialRecord, TrialTool, ViewTransform, Workspace, WorldRect, annotationToolInfo, as2DView, capturePlan, captureTarget, composeCaptureSvg, createMarkDrawOne, currentPage, defineInstrument, fitView, fromWeaselView, interstellarTheme, isStale, markCommands, markSvgNodes, resolveMarkStyle, seenFrom, toWeaselView, useAnnotations, useAnnotationsOptional, validateConfigSchema };
-export type { AnnotationOverlayProps, AnnotationTargetsProps, AnnotationToolInfo, CaptureArgs, CapturePlan, ComposeSvgArgs, ContentSize, CurveFieldProps, CurveMark, EffectCardListItem, EffectCardListProps, EffectCardProps, InstrumentSpec, LabPage, LabPaletteProps, LabProps, LabShellProps, LabSwitcherProps, MarkDrawOptions, MarkListProps, MarkStyle, PaintableMark, PaneSize, PanelDescriptor, PropertyGroupProps, SubpanelProps, TrialBodyProps, TrialChromeProps, TrialLayout, TrialProps, UndoBindings, ValidationResult, ViewTransform2D, WorkspaceProps };
+export { ANNOTATION_TOOLS, ANNOTATION_WEASEL_TOOLS, AnnotationData, AnnotationKind, AnnotationMeaning, AnnotationOverlay, AnnotationTarget, AnnotationTargets, AnnotationsApi, AnnotationsCapability, AnnotationsContext, CaptureOptions, CaptureResult, CaptureSource, CloseIcon, CollapseIcon, ConfigField, ConfigRule, ConfigSchema, ControlRenderer, CurveField, DEFAULT_VIEW, EffectCard, EffectCardList, ExpandIcon, ExportMenu, IconProps, Instrument, InstrumentList, JobHandle, Jog, Lab, LabContribution, LabDensity, LabMode, LabPalette, LabRoot, LabShell, LabSwitcher, MarkList, MarkScene, PauseIcon, PlayIcon, PropertyGroup, PropertyListPack, ResetIcon, SPECIMEN_SECTIONS, Specimen, SplitProps, StepBackIcon, StepForwardIcon, StopIcon, StorageAdapter, Subpanel, TokenPanel, Trial, TrialBody, TrialChrome, TrialContribution, TrialInfo, TrialRecord, TrialTool, ViewTransform, Workspace, WorldRect, annotationToolInfo, as2DView, capturePlan, captureTarget, composeCaptureSvg, createMarkDrawOne, currentPage, defineInstrument, fitView, fromWeaselView, inferTokenType, interstellarTheme, isStale, markCommands, markSvgNodes, refitScale, resolveMarkStyle, seenFrom, toWeaselView, useAnnotations, useAnnotationsOptional, validateConfigSchema };
+export type { AnnotationOverlayProps, AnnotationTargetsProps, AnnotationToolInfo, CaptureArgs, CapturePlan, ComposeSvgArgs, ContentSize, CurveFieldProps, CurveMark, EffectCardListItem, EffectCardListProps, EffectCardProps, InstrumentSpec, JogProps, LabPage, LabPaletteProps, LabProps, LabRootProps, LabShellProps, LabSwitcherProps, MarkDrawOptions, MarkListProps, MarkStyle, PaintableMark, PaneSize, PanelDescriptor, PropertyGroupProps, SubpanelProps, TokenCategory, TokenEntry, TokenPanelProps, TokenScale, TokenScaleRule, TrialBodyProps, TrialChromeProps, TrialLayout, TrialProps, UndoBindings, ValidationResult, ViewTransform2D, WorkspaceProps };