@weasel-js/labkit 1.5.2 → 1.6.1

package/dist/index.d.ts

@@ -1,46 +1,47 @@
-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-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 { I as IconProps } from './_dts/Select.d-Cr8-zoup.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-Cr8-zoup.js';
+export { L as LayerList, a as LayerListItem, b as LayerListProps, c as LayerMove, m as moveLayers } from './_dts/LayerList.d-BoELAMsM.js';
+import { a as PropertyListPack } from './_dts/PropertyField.d-D0ndfIIt.js';
+import { PropertyMetricProps } from './passthrough/weasel-ui.js';
+export { b as PropertyControl, c as PropertyControlProps, d as PropertyField, e as PropertyFieldProps, f as PropertyList, g as PropertyListProps, h as PropertyOption, i as PropertyPanel, j as PropertyPanelProps, k as PropertyRow, l as PropertyRowLayout, m as PropertyRowProps, n as PropertyRowVariant, o as PropertySpan, p as PropertySpanProps } from './_dts/PropertyField.d-D0ndfIIt.js';
+import { StanceProps } from './passthrough/weasel-ui.js';
+import { SceneNode, View, DrawCommand, Path, FillStyle, ScreenLength, StrokeAlign, StyledRun, TextStyle, TextVerticalAlign, Stroke, BuiltinToolId } from '@weasel-js/core';
+import { A as AnnotationMeaning, w as AnnotationData, x as WorldRect, y as MarkStyle, z as MarkScene, B as CaptureSource, E as CaptureOptions, F as CaptureResult, G as PaintableMark, H as AnnotationTarget, J as AnnotationsApi, K as AnnotationsCapability, N as TrialInfo, O as TrialTool, Q as AnnotationKind, b as ViewTransform, R as Instrument, t as InstrumentList, s as LabMode, X as LabDensity, Y as TrialContribution, c as StorageAdapter, T as TrialRecord } from './_dts/types-B7yBTTF9.js';
+export { Z as Annotation, _ as AnnotationInit, $ as AnnotationPatch, a0 as AnnotationQuery, a1 as AnnotationStatus, a2 as AnnotationStoreOptions, a3 as AnnotationTargetInfo, a4 as AnnotationToolId, a5 as Auto, a6 as CanvasCapability, a7 as CanvasLayer, a8 as CaptureDeps, a9 as ContributionBase, C as CreateLabStoreOptions, D as DEFAULT_FRAME, q as DragDropCapability, o as DragFeedback, aa as FracPoint, ab as FracRect, ac as HitResult, ad as IconComponent, ae as LOUPE_DEFAULTS, d as LabDocument, e as LabStoreState, L as LayerCapability, a as LayerDescriptor, af as LoupeCapability, ag as LoupeDeclaration, ah as LoupeMode, ai as LoupePoint, aj as LoupeRenderArgs, n as PaletteItem, P as Point, ak as RegionContribution, al as RenderContext, am as ResolvedLoupe, f as SavedSnapshot, an as SerializedAnnotations, S as SerializedTrial, ao as SidebarSection, ap as SidebarSlotContext, aq as StageCapability, ar as StatusReadout, g as StorageChange, as as SystemEvent, at as ToolCapability, au as ToolItem, av as ToolSlotContext, aw as ToolbarItem, ax as TrialChromeContext, ay as TrialRegion, h as TrialStateHandle, az as UndoCapability, U as UndoStack, i as UndockedPanel, j as UndockedPanels, aA as ViewportControl, V as ViewportSize, W as WorldFrame, l as WorldSpec, aB as annotationsFromJSON, m as applyCamera, aC as auto, aD as createAnnotationScene, aE as createAnnotationStore, k as dockPanel, aF as fracContains, aG as fracEncloses, aH as fracToWorld, aI as isAuto, aJ as markCommands, p as panelKey, r as resolveFrame, aK as resolveLoupe, aL as roundFrac, u as undockPanel, aM as worldToFrac } from './_dts/types-B7yBTTF9.js';
+export { C as CameraContext, a as CameraContextValue, b as CameraInput, d as CameraScope, g as CanvasStack, h as CanvasStackProps, i as Stage, j as StageProps, Z as ZoomAtOptions, k as centerOn, l as fitStage, s as screenToWorld, w as worldToScreen, z as zoomAt } from './_dts/Stage-DWBBi8IU.js';
+export { C as CanvasLayerDescriptor, a as CanvasStackContext, b as CanvasStackContextValue, c as CanvasStackSurface } from './_dts/CanvasStackContext-Wo6OwIVM.js';
+import { L as LabContribution } from './_dts/index-CKyX0ME_.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-CKyX0ME_.js';
+export { BaseNode, BooleanNode, ColorNode, CustomNode, EnumNode, GroupNode, ListNode, NumberNode, SectionTree, StringNode, ValueNode, applyRules, autoPathsOf, builtinRules, f, fillConfigDefaults, fromConfigFields, hasConfigPath, isConfigBranch, isLeafVisible, resolveAutoConfig, resolveConfigSchema, schemaNodeAtPath, sectionTree, 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-DTuViBvc.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, D as DialogSpec, E as EntryValue, I as InDialogOptions, q as InferConfig, L as LeafPatch, N as NodeOptions, r as NodeValue, s as NumberField, R as ResolvedConfig, S as SectionOption, t as SectionSpec, u as SelectField, v as SelectOption, w as SliderField, T as TextField, V as ValueAtPath } from './_dts/types-DTuViBvc.js';
+export { ControlPanel, inDialog, summarizeValue } from './controls/index.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';
+import { Theme, ColorList } from '@weasel-js/theme';
 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';
+export { a as FloatingPanel, F as FloatingPanelProps } from './_dts/FloatingPanel-7j0IcXwz.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-pnAE-UBD.js';
+export { FpsMeter, JobProgress, JobProgressProps, Legend, LegendEntry, LegendMark, LegendProps, ScaleIndicator, ScaleIndicatorProps, 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-CMaV6UD4.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 '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;
+declare const ResetIcon: (p: IconProps) => react.JSX.Element;
+declare const CloseIcon: (p: IconProps) => react.JSX.Element;
+declare const PlayIcon: (p: IconProps) => react.JSX.Element;
+declare const PauseIcon: (p: IconProps) => react.JSX.Element;
+declare const StopIcon: (p: IconProps) => react.JSX.Element;
+declare const StepBackIcon: (p: IconProps) => react.JSX.Element;
+declare const StepForwardIcon: (p: IconProps) => react.JSX.Element;
+declare const CollapseIcon: (p: IconProps) => react.JSX.Element;
+declare const ExpandIcon: (p: IconProps) => react.JSX.Element;
 
 /** An annotation drawn over a curve plot: a shaded band across a range of x,
  *  or a vertical line at one x. */
@@ -77,79 +78,16 @@ interface CurveFieldProps {
  * `CurveEditor`; consumers wanting the raw editor (2D paths,
  * custom anchors) should import that instead.
  */
-declare function CurveField({ values, min, max, step, width, height, defaults, onChange, marks, }: CurveFieldProps): react_jsx_runtime.JSX.Element;
-
-/** Props for `<Subpanel>`. */
-interface SubpanelProps extends PropertyMetricProps {
-    title: ReactNode;
-    children: ReactNode;
-    className?: string;
-}
-/** A typographic divider inside a property list: a small title flanked by a
- *  rule. Purely a heading — use `<PropertyGroup>` for a bordered section. */
-declare function Subpanel({ title, children, className, density, align }: SubpanelProps): react_jsx_runtime.JSX.Element;
-/** Props for `<EffectCard>`. */
-interface EffectCardProps {
-    /** Card title rendered in the title bar (e.g. effect kind label or a select). */
-    title: ReactNode;
-    /** Optional badge/chip displayed before the remove button (e.g. primary value summary). */
-    primary?: ReactNode;
-    /** Optional accent color in any CSS color form. Sets --wzl-effect-card-accent on the card. */
-    accent?: string;
-    /** Optional ordinal badge that doubles as the drag handle (used by tail cards in SB). */
-    index?: number;
-    expanded?: boolean;
-    onToggleExpanded?: () => void;
-    onRemove?: () => void;
-    /**
-     * Drag-handle wiring. When provided, an inline handle (⋮⋮ icon or `index`)
-     * activates HTML5 drag on press. Consumer owns the drag/drop coordination —
-     * see EffectCardList for the batteries-included wrapper.
-     */
-    draggable?: boolean;
-    onPressHandle?: () => void;
-    onReleaseHandle?: () => void;
-    onDragStart?: (e: React.DragEvent<HTMLDivElement>) => void;
-    onDragEnd?: (e: React.DragEvent<HTMLDivElement>) => void;
-    onDragOver?: (e: React.DragEvent<HTMLDivElement>) => void;
-    onDragLeave?: (e: React.DragEvent<HTMLDivElement>) => void;
-    onDrop?: (e: React.DragEvent<HTMLDivElement>) => void;
-    dragging?: boolean;
-    children?: ReactNode;
-    className?: string;
-}
-/** An accented, collapsible card for one item in a list of like things —
- *  effects, layers, tails. The accent color rebinds the theme accent token
- *  within the card, so its controls pick it up too. */
-declare function EffectCard({ title, primary, accent, index, expanded, onToggleExpanded, onRemove, draggable, onPressHandle, onReleaseHandle, onDragStart, onDragEnd, onDragOver, onDragLeave, onDrop, dragging, children, className, }: EffectCardProps): react_jsx_runtime.JSX.Element;
-/** The minimum an item must carry to appear in an `<EffectCardList>`. */
-interface EffectCardListItem {
-    id: string | number;
-}
-/** Props for `<EffectCardList>`. */
-interface EffectCardListProps<T extends EffectCardListItem> {
-    items: ReadonlyArray<T>;
-    renderItem: (item: T, helpers: {
-        isExpanded: boolean;
-        isDragging: boolean;
-        toggleExpanded: () => void;
-        cardProps: Pick<EffectCardProps, 'expanded' | 'dragging' | 'draggable' | 'onToggleExpanded' | 'onPressHandle' | 'onReleaseHandle' | 'onDragStart' | 'onDragEnd' | 'onDragOver' | 'onDragLeave' | 'onDrop'>;
-    }) => ReactNode;
-    onReorder: (sourceId: T['id'], targetId: T['id'], position: 'before' | 'after') => void;
-    /** Optional rendered when the list is empty. */
-    empty?: ReactNode;
-    /** IDs to render expanded on first mount. Defaults to all collapsed. */
-    defaultExpandedIds?: ReadonlyArray<T['id']>;
-}
-/** A drag-reorderable list of `<EffectCard>`s. Owns the expanded and dragging
- *  state and hands it back to `renderItem`, so the caller only supplies each
- *  card's contents. */
-declare function EffectCardList<T extends EffectCardListItem>({ items, renderItem, onReorder, empty, defaultExpandedIds, }: EffectCardListProps<T>): react_jsx_runtime.JSX.Element;
+declare function CurveField({ values, min, max, step, width, height, defaults, onChange, marks, }: CurveFieldProps): react.JSX.Element;
 
 /** Props for `<PropertyGroup>`. */
-interface PropertyGroupProps extends PropertyMetricProps {
+interface PropertyGroupProps extends PropertyMetricProps, StanceProps {
     /** Title rendered between two rules at the top of the group. */
     title: ReactNode;
+    /** Before the title: a drag handle, an ordinal. Clicks here do not fold the group. */
+    leading?: ReactNode;
+    /** After the title: a summary of the group's value, a remove button. Clicks here do not fold the group. */
+    actions?: ReactNode;
     /** Help text for the whole group, drawn under the title and above the
      *  rows. `<PropertyRow description>` covers the per-row case. */
     description?: ReactNode;
@@ -184,9 +122,24 @@ interface PropertyGroupProps extends PropertyMetricProps {
  * inside a fill effect's controls).
  *
  * A collapsible group keeps its rows mounted and hides them, so a control's
- * local state survives being folded away.
+ * local state survives being folded away. `stance` and `tone` work as on
+ * `<PropertyPanel>`; a tone also draws the group's leading edge in it, which
+ * is how a list of like groups — effects, tails — tells its members apart.
+ * `leading` and `actions` put a handle and controls in the title row, and the
+ * groups of a `<PropertyList>` reorder with `useReorderDragList`.
  */
-declare function PropertyGroup({ title, description, hidden, collapsible, defaultCollapsed, collapsed, onCollapsedChange, children, className, span, pack, density, align, }: PropertyGroupProps): react_jsx_runtime.JSX.Element | null;
+declare function PropertyGroup({ title, leading, actions, description, hidden, collapsible, defaultCollapsed, collapsed, onCollapsedChange, children, className, span, pack, density, align, stance, tone, }: PropertyGroupProps): react.JSX.Element | null;
+
+/** Props for `<Subpanel>`. */
+interface SubpanelProps extends PropertyMetricProps, StanceProps {
+    title: ReactNode;
+    children: ReactNode;
+    className?: string;
+}
+/** A typographic divider inside a property list: a small title flanked by a
+ *  rule. Purely a heading — use `<PropertyGroup>` for a bordered section. A
+ *  stance or tone colors the title and rule. */
+declare function Subpanel({ title, children, className, density, align, stance, tone }: SubpanelProps): react.JSX.Element;
 
 /** A design token as `TokenPanel` edits it. */
 interface TokenEntry {
@@ -264,7 +217,7 @@ interface TokenPanelProps {
  * 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;
+declare function TokenPanel({ tokens, onChange, collapsed, onCollapsedChange, scales, onScaleChange, categorize, familySize, density, className, }: TokenPanelProps): react.JSX.Element;
 
 /** Props for {@link Jog}. */
 interface JogProps {
@@ -291,34 +244,7 @@ interface JogProps {
  *
  * 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 {
-    pose: WorldRect;
-    data: AnnotationData;
-}
-/** How a mark is drawn, as opposed to where. Resolved by the overlay from the
- *  instrument's vocabulary and the mark's own staleness. */
-interface MarkStyle {
-    /** The status's color, or the default. */
-    color?: string;
-    /** A mark whose stored position no longer describes the picture. Drawn
-     *  dashed rather than hidden: it still describes *something*, and dropping
-     *  it would lose it. */
-    stale?: boolean;
-}
-/**
- * What one mark draws, in its target's world.
- *
- * Pure: a node and the target's content box in, draw commands out. Geometry
- * that a bounding box cannot describe — a line's ends, a stroke's path — comes
- * from `data.points`, which is in fractions like the bounds.
- */
-declare function markCommands(m: PaintableMark, content: {
-    w: number;
-    h: number;
-}, style?: MarkStyle): DrawCommand[];
+declare function Jog(props: JogProps): react.JSX.Element;
 
 /** What resolving a mark's appearance needs beyond the mark itself. */
 interface MarkDrawOptions {
@@ -395,7 +321,7 @@ declare function captureTarget(args: CaptureArgs, opts?: CaptureOptions): Promis
  * Reads the store through the hook the way `<MarkList>` does — the chrome
  * context carries no instrument state and is not the route to it.
  */
-declare function ExportMenu(): react_jsx_runtime.JSX.Element | null;
+declare function ExportMenu(): react.JSX.Element | null;
 
 /** Props for `<MarkList>`. */
 interface MarkListProps {
@@ -410,7 +336,7 @@ interface MarkListProps {
  *
  *  Reads the store through the hook, which re-renders on every mutation — so a
  *  mark drawn on a pane appears here without anything wiring the two. */
-declare function MarkList({ meaning, config }: MarkListProps): react_jsx_runtime.JSX.Element;
+declare function MarkList({ meaning, config }: MarkListProps): react.JSX.Element;
 
 /**
  * Whether a stored mark still describes the picture the current config
@@ -732,7 +658,7 @@ interface AnnotationTargetsProps {
     activeToolId: string | null;
 }
 /** One overlay per region the instrument said accepts marks. */
-declare function AnnotationTargets({ capability, state, config, trial, annotations, activeToolId, }: AnnotationTargetsProps): react_jsx_runtime.JSX.Element;
+declare function AnnotationTargets({ capability, state, config, trial, annotations, activeToolId, }: AnnotationTargetsProps): react.JSX.Element;
 
 /** Which weasel tool an annotation tool drives, and what kind of mark that
  *  makes. `select` makes none. */
@@ -815,7 +741,8 @@ declare function validateConfigSchema(fields: ConfigField[]): ValidationResult;
 
 /** One page in a project's set of labs. */
 interface LabPage {
-    /** The page's own URL, and how the switcher knows which page is open. */
+    /** The page's own URL, and how the switcher knows which page is open. A
+     *  hash route (`#/dev/tools`) names a page on the current document. */
     href: string;
     label: string;
 }
@@ -834,7 +761,11 @@ interface LabSwitcherProps {
  *  Matched on the end of the path so a query string, a trailing slash or a
  *  leftover `.html` cannot lose it: a project whose dev server maps `/stats`
  *  to `stats.html` serves both spellings, and a bookmark from before the URLs
- *  lost their extension still resolves to the same page. */
+ *  lost their extension still resolves to the same page.
+ *
+ *  A page whose `href` carries a hash is a route on a single document and wins
+ *  when the path's hash is that route or one under it. A page without one
+ *  ignores the hash, so an in-page anchor does not lose it. */
 declare function currentPage(path: string, pages: readonly LabPage[]): number;
 /** A project's lab title, doubling as the way to reach its other labs.
  *
@@ -846,7 +777,7 @@ declare function currentPage(path: string, pages: readonly LabPage[]): number;
  *
  *  Pages accumulate -- a project grows a wall, a dashboard, an ingest page, a
  *  bench -- and a tab strip is the layout that stops working first. */
-declare function LabSwitcher({ title, pages, path, className }: LabSwitcherProps): react_jsx_runtime.JSX.Element;
+declare function LabSwitcher({ title, pages, path, className }: LabSwitcherProps): react.JSX.Element;
 
 interface LabBaseProps {
     /** May change while mounted. An instrument that is a different object from
@@ -859,15 +790,20 @@ interface LabBaseProps {
      *  window is the whole app, rather than a panel beside one, reads better at
      *  `'roomy'`. The trials' own contents are unaffected. */
     density?: LabDensity;
+    /** The theme the lab's chrome resolves against, applied at `mode` and
+     *  `density`. Default `interstellarTheme`; extend it rather than replace it to
+     *  keep the lab's look while changing a few tokens. */
+    theme?: Theme;
     /** Rendered while a stored lab loads. Default: the lab's empty shell. */
     fallback?: ReactNode;
     /**
-     * Optional list of CSS colors used to compose the interstellar theme's
-     * cosmic backdrop. Each color becomes one radial-gradient blob on the
-     * dark void base. Order maps to a fixed spread of positions; extras wrap
-     * around. Ignored unless the resolved mode is dark.
+     * Colors composing the interstellar theme's cosmic backdrop. Each becomes
+     * one radial-gradient blob on the dark void base, in a fixed spread of
+     * positions; extras wrap around. A theme ramp resolves against the lab's
+     * theme; a function list gives as many blobs as there are positions.
+     * Ignored unless the resolved mode is dark.
      */
-    nebula?: readonly string[];
+    nebula?: ColorList;
     title?: string;
     /** The project's other labs. Given two or more, the title becomes the way to
      *  reach them — the same switcher `<LabShell>` renders, so a lab reached from
@@ -914,7 +850,22 @@ 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): 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;
+declare function Lab(props: LabProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | react.JSX.Element | null;
+
+/** Props for `<LabBoundary>`. */
+interface LabBoundaryProps {
+    children: ReactNode;
+}
+/**
+ * Renders its children as though no lab, trial or theme were above them: every context a `<Lab>` or a
+ * `<Trial>` publishes reads as absent below it, so a labkit piece mounted inside a trial behaves the way it
+ * does on a bare page. A `<LabRoot>` under it applies its own theme instead of deferring to the lab's, and a
+ * `usePersistedState` under it keeps local state instead of writing into the enclosing lab's records.
+ *
+ * For a host that shows arbitrary content inside a trial, such as a component workshop; a lab's own chrome
+ * never needs it.
+ */
+declare function LabBoundary({ children }: LabBoundaryProps): react.JSX.Element;
 
 /** Props for `<LabPalette>`. */
 interface LabPaletteProps {
@@ -926,7 +877,7 @@ interface LabPaletteProps {
 /** The lab's tool rail. Writes the lab's tool slot, which every trial whose
  *  instrument declares no tools of its own resolves to. Renders nothing when
  *  the lab contributes no tool rail. */
-declare function LabPalette({ tools, contributions }: LabPaletteProps): react_jsx_runtime.JSX.Element;
+declare function LabPalette({ tools, contributions }: LabPaletteProps): react.JSX.Element;
 
 /** Props for `<LabRoot>`. */
 interface LabRootProps {
@@ -946,7 +897,7 @@ interface LabRootProps {
  *  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;
+declare function LabRoot({ children, mode, className }: LabRootProps): react.JSX.Element;
 
 /** Props for `<LabShell>`. */
 interface LabShellProps {
@@ -964,11 +915,14 @@ interface LabShellProps {
     /** The path the switcher reads to mark the open page. Defaults to the
      *  current location. */
     path?: string;
+    /** Set as `document.title` while the shell is mounted, and the previous
+     *  title restored after. Omitted, the document's title is left alone. */
+    documentTitle?: string;
 }
 /** 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, documentTitle, }: LabShellProps): react.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. */
@@ -1030,7 +984,7 @@ interface PanelDescriptor {
     title: string;
     as: 'tile' | 'floating';
 }
-declare function Workspace({ children, ids, panels, resizable, reorderable, onReorder, layout, onLayoutChange, gap, padding, viewport, }: WorkspaceProps): react_jsx_runtime.JSX.Element;
+declare function Workspace({ children, ids, panels, resizable, reorderable, onReorder, layout, onLayoutChange, gap, padding, viewport, }: WorkspaceProps): react.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"];
@@ -1042,7 +996,7 @@ declare const SPECIMEN_SECTIONS: readonly ["Buttons & toggles", "Fields & picker
  */
 declare function Specimen({ className }: {
     className?: string;
-}): react_jsx_runtime.JSX.Element;
+}): react.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. */
@@ -1053,8 +1007,8 @@ declare const DEFAULT_VIEW: ViewTransform2D;
 declare function as2DView(view: unknown): ViewTransform2D | null;
 
 /**
- * labkit's theme: a cosmic dark and a warm parchment light, extending the
- * built-in weasel theme. A pins-only theme definition: nothing in it is
+ * labkit's theme: a cosmic dark over the built-in weasel theme, whose light
+ * mode it keeps as is. A pins-only theme definition: nothing in it is
  * derived, so it loads without the engine.
  */
 declare const interstellarTheme: Theme;
@@ -1070,7 +1024,7 @@ interface TrialProps {
 }
 /** Renders one trial from the lab store: looks up its record and
  *  instrument, and mounts the instrument inside the trial chrome. */
-declare function Trial({ id, chrome, suppress }: TrialProps): react_jsx_runtime.JSX.Element;
+declare function Trial({ id, chrome, suppress }: TrialProps): react.JSX.Element;
 
 /** Props for `<TrialBody>`. */
 interface TrialBodyProps extends Omit<SplitProps, 'sidebar' | 'children' | 'className' | 'sidebarClassName' | 'label'> {
@@ -1083,7 +1037,7 @@ interface TrialBodyProps extends Omit<SplitProps, 'sidebar' | 'children' | 'clas
     contentClassName?: string;
 }
 /** A trial's sidebar and content as a `Split`, wearing the trial's classes. */
-declare function TrialBody({ sidebar, children, contentClassName, ...rest }: TrialBodyProps): react_jsx_runtime.JSX.Element;
+declare function TrialBody({ sidebar, children, contentClassName, ...rest }: TrialBodyProps): react.JSX.Element;
 
 /** The trial's loupe as its chrome sees it: a switch and its position. */
 interface LoupeBindings {
@@ -1124,7 +1078,7 @@ interface TrialChromeProps {
 /** The frame around a running instrument. Builds one chrome context, assembles
  *  the contributions the instrument, the runtime and the lab declare, and hands
  *  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;
+declare function TrialChrome({ trialId, record, instrument, isLastTrial, undoBindings, job, loupe, trialChrome, chrome, suppress, activeToolId, setActiveTool, children, }: TrialChromeProps): react.JSX.Element;
 
-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 };
+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, ExpandIcon, ExportMenu, IconProps, Instrument, InstrumentList, JobHandle, Jog, Lab, LabBoundary, LabContribution, LabDensity, LabMode, LabPalette, LabRoot, LabShell, LabSwitcher, MarkList, MarkScene, MarkStyle, PaintableMark, 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, markSvgNodes, refitScale, resolveMarkStyle, seenFrom, toWeaselView, useAnnotations, useAnnotationsOptional, validateConfigSchema };
+export type { AnnotationOverlayProps, AnnotationTargetsProps, AnnotationToolInfo, CaptureArgs, CapturePlan, ComposeSvgArgs, ContentSize, CurveFieldProps, CurveMark, InstrumentSpec, JogProps, LabBoundaryProps, LabPage, LabPaletteProps, LabProps, LabRootProps, LabShellProps, LabSwitcherProps, MarkDrawOptions, MarkListProps, PaneSize, PanelDescriptor, PropertyGroupProps, SubpanelProps, TokenCategory, TokenEntry, TokenPanelProps, TokenScale, TokenScaleRule, TrialBodyProps, TrialChromeProps, TrialLayout, TrialProps, UndoBindings, ValidationResult, ViewTransform2D, WorkspaceProps };