@weasel-js/labkit 1.6.0 → 1.7.0

package/dist/dragdrop/index.js

@@ -1,4 +1,5 @@
-export { DragGhost, DragOverlay, Palette, useDragDrop } from '../chunk-RS3HRQWU.js';
-import '../chunk-2AYGEN57.js';
+export { DragGhost, DragOverlay, Palette, useDragDrop } from '../chunk-WPLAANH4.js';
+import '../chunk-AWQG7FCC.js';
+import '../chunk-24W5VEJW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -1,47 +1,271 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { I as IconProps } from './_dts/Select.d-BchGMC2Y.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-BchGMC2Y.js';
-export { L as LayerList, a as LayerListItem, b as LayerListProps, c as LayerMove, m as moveLayers } from './_dts/LayerList.d-2c9yup5Y.js';
-import { P as PropertyMetricProps, a as PropertyListPack } from './_dts/index-DINmCuLA.js';
-export { C as ControlPanel, 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/index-DINmCuLA.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { S as StanceProps } from './_dts/PrefsRow.d-DFpPIeIC.js';
-import { DrawCommand, SceneNode, View, Path, FillStyle, ScreenLength, StrokeAlign, StyledRun, TextStyle, TextVerticalAlign, Stroke, BuiltinToolId } from '@weasel-js/core';
-import { w as WorldRect, A as AnnotationData, x as AnnotationMeaning, y as MarkScene, z as CaptureSource, B as CaptureOptions, E as CaptureResult, F as AnnotationTarget, G as AnnotationsApi, H as AnnotationsCapability, J as TrialInfo, K as TrialTool, N as AnnotationKind, m as ViewTransform, O as Instrument, t as InstrumentList, s as LabMode, Q as LabDensity, R as TrialContribution, d as StorageAdapter, T as TrialRecord } from './_dts/frac-DTRq7Xpb.js';
-export { X as Annotation, Y as AnnotationInit, Z as AnnotationPatch, _ as AnnotationQuery, $ as AnnotationStatus, a0 as AnnotationStoreOptions, a1 as AnnotationTargetInfo, a2 as Auto, a3 as CanvasCapability, a4 as CanvasLayer, a5 as CaptureDeps, a6 as ContributionBase, C as CreateLabStoreOptions, D as DEFAULT_FRAME, q as DragDropCapability, o as DragFeedback, a7 as FracPoint, a8 as FracRect, a9 as HitResult, aa as IconComponent, ab as LOUPE_DEFAULTS, e as LabDocument, f as LabStoreState, L as LayerCapability, a as LayerDescriptor, ac as LoupeCapability, ad as LoupeDeclaration, ae as LoupeRenderArgs, P as PaletteItem, n as Point, af as RegionContribution, ag as RenderContext, ah as ResolvedLoupe, g as SavedSnapshot, ai as SerializedAnnotations, S as SerializedTrial, aj as SidebarSection, ak as SidebarSlotContext, al as StageCapability, am as StatusReadout, h as StorageChange, an as SystemEvent, ao as ToolCapability, ap as ToolItem, aq as ToolSlotContext, ar as ToolbarItem, as as TrialChromeContext, at as TrialRegion, i as TrialStateHandle, au as UndoCapability, U as UndoStack, j as UndockedPanel, k as UndockedPanels, av as ViewportControl, V as ViewportSize, W as WorldFrame, b as WorldSpec, aw as annotationsFromJSON, c as applyCamera, ax as auto, ay as createAnnotationScene, az as createAnnotationStore, l 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-DTRq7Xpb.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-Bq73pwFe.js';
-export { C as CanvasLayerDescriptor, a as CanvasStackContext, b as CanvasStackContextValue, c as CanvasStackSurface } from './_dts/CanvasStackContext-DQgcH1ny.js';
-import { L as LabContribution } from './_dts/index-B0--8PEM.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-B0--8PEM.js';
+import { I as IconProps } from './_dts/Select.d-Bensr_MT.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-Bensr_MT.js';
+import { S as SplitProps } from './_dts/index-B2Yj5aA0.js';
+export { D as DetailList, a as DetailListLayout, b as DetailListProps, c as DetailListValues, d as DetailRow, e as DetailRowProps, f as DetailRowStatus, F as FpsMeter, J as JobProgress, g as JobProgressProps, L as Legend, h as LegendEntry, i as LegendMark, j as LegendProps, R as Readout, k as ReadoutProps, l as ReadoutRow, m as ScaleIndicator, n as ScaleIndicatorProps, o as Split, p as StatusBar, q as StatusBarProps, r as StatusBarSectionProps, T as Toolbar, s as ToolbarButtonProps, t as ToolbarGroupProps, u as ToolbarProps, Z as ZoomControl, v as ZoomControlProps } from './_dts/index-B2Yj5aA0.js';
+export { L as LayerList, a as LayerListItem, b as LayerListProps, c as LayerMove, m as moveLayers } from './_dts/LayerList.d-DiuEArKq.js';
+import { FillStyle, PaintKind, SceneNode, View, DrawCommand, Path, ScreenLength, StrokeAlign, MarkerRef, StyledRun, TextStyle, TextVerticalAlign, Stroke, BuiltinToolId } from '@weasel-js/core';
+import { U as UnitTable, D as Display } from './_dts/PrefsRow.d-TOZ7BgD9.js';
+import { StanceProps } from './passthrough/weasel-ui.js';
+import { a as PropertyRowLayout, b as PropertyListPack } from './_dts/PropertyPanel.d-D-1paCbE.js';
+import { PropertyMetricProps } from './passthrough/weasel-ui.js';
+export { c as PropertyList, d as PropertyListProps, e as PropertyPanel, f as PropertyPanelProps, g as PropertyRow, h as PropertyRowProps, i as PropertyRowVariant, j as PropertySpan, k as PropertySpanProps } from './_dts/PropertyPanel.d-D-1paCbE.js';
+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-CSm9jgol.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-CSm9jgol.js';
+export { C as CameraContext, a as CameraContextValue, b as CameraInput, d as CameraPublishContext, e as CameraRegistry, f as CameraRegistryContext, g as CameraScope, h as CameraView, j as CanvasStack, k as CanvasStackProps, l as Stage, m as StageProps, Z as ZoomAtOptions, n as ZoomRange, o as centerOn, p as createCameraRegistry, q as fitStage, s as screenToWorld, r as usePublishCamera, w as worldToScreen, z as zoomAt } from './_dts/Stage-CCWfQQWM.js';
+export { C as CanvasLayerDescriptor, a as CanvasStackContext, b as CanvasStackContextValue, c as CanvasStackSurface } from './_dts/CanvasStackContext-D2jnIwfk.js';
+import { L as LabContribution } from './_dts/index-CsYqUHD3.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-CsYqUHD3.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 { c as ConfigSchema, b as ConfigField, d as ConfigRule, C as ControlRenderer } from './_dts/types-B7y8hX1D.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, a 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-B7y8hX1D.js';
-export { I as InDialogOptions, i as inDialog, s as summarizeValue } from './_dts/inDialog-D5ZKGjiD.js';
+import { b as ConfigSchema, a as ConfigField, c as ConfigRule, d as ControlRenderer } from './_dts/types-CRPSGFAp.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-CRPSGFAp.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';
 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';
-import { SplitProps } from './primitives/index.js';
-export { FloatingPanel, FloatingPanelProps, 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-CP4jfuKl.js';
+export { a as FloatingPanel, F as FloatingPanelProps } from './_dts/FloatingPanel-7j0IcXwz.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-CTZPgeZ7.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';
 export { EventBus, EventListener, clearUndo, createEventBus, emptyStack, pushSnapshot, redo, undo } from './undo/index.js';
 import 'react-aria-components';
-import './_dts/number.d-OeQYQoUO.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;
+
+/** One choice of an enum field. */
+interface PropertyOption<T extends string> {
+    value: T;
+    /** The option's name. A string also names its segment for a screen reader. */
+    label: ReactNode;
+    /** What a segment shows in place of `label` when the full one would not fit
+     *  — a glyph or a letter. `label` stays the accessible name. */
+    glyph?: ReactNode;
+    /** Shown but not choosable: a value the control reports and cannot author. */
+    disabled?: boolean;
+}
+/** Props every kind of field shares. */
+interface FieldBase {
+    /** The control's accessible name. A `<PropertyField>` takes it from a string
+     *  `label` when this is omitted. */
+    name?: string;
+    /** The sources the field reads disagree — a multi-selection whose nodes
+     *  differ. The control shows no value, in whatever form it has for that. */
+    mixed?: boolean;
+    /**
+     * The sources agree on holding nothing: whatever is in effect comes from a
+     * fallback further down. The control shows no chosen value rather than
+     * inventing one, since the next edit would write the invention back.
+     */
+    unset?: boolean;
+    /** Class on the control element itself. */
+    className?: string;
+    /** Id for the control element, for a `<label htmlFor>` outside it. */
+    id?: string;
+}
+/** A boolean field. */
+interface PropertyBooleanFieldProps extends FieldBase {
+    kind: 'boolean';
+    /** `checkbox` (default), `switch`, or `toggle` — a one-segment pressable bar. */
+    control?: 'checkbox' | 'switch' | 'toggle';
+    /** Absent reads as off. */
+    value: boolean | undefined;
+    onChange: (next: boolean) => void;
+    /** A `toggle`'s segment content. Defaults to the first letter of `name`. */
+    glyph?: ReactNode;
+}
+/** A number field. */
+interface PropertyNumberFieldProps extends FieldBase {
+    kind: 'number';
+    /** `input` (default) for a typed number; `slider` for a track with an
+     *  editable readout, where the range matters more than the exact value. */
+    control?: 'input' | 'slider';
+    /** Absent reads as an empty field. */
+    value: number | null | undefined;
+    /**
+     * The committed value. Given `onInput` as well, it fires once a drag ends,
+     * or on blur, Enter or a step in a typed field; on its own it fires on every
+     * move, keystroke and step. A caller wanting settled values only passes a
+     * no-op `onInput`.
+     */
+    onChange: (next: number) => void;
+    /** The live value, fired continuously. Pass it alongside `onChange` when the
+     *  write is expensive — cheap state here, the costly work there. */
+    onInput?: (next: number) => void;
+    /** A slider's track runs 0..100 where these are omitted. */
+    min?: number;
+    max?: number;
+    step?: number;
+    /**
+     * Suffix after the value. A string becomes a dim word unit (`px`); pass JSX
+     * like `<sup>°</sup>` for a symbol. Display only — the value stays a number.
+     */
+    unit?: ReactNode;
+    /** Units a person may type into a typed field, each mapped to the factor
+     *  that turns it into the unit shown: `{ mm: 0.1, cm: 1 }`. */
+    accepts?: Readonly<UnitTable>;
+    /** How the value shows, is spoken, and reads back when typed —
+     *  `compact()` reads `2.00M`. A slider readout defaults to the value at
+     *  `step`'s precision. */
+    display?: Display;
+    /** A slider readout's text, for what no display expresses — a derived
+     *  value, a word at one end. Wins over `display`, and is spoken as shown. */
+    format?: (value: number) => ReactNode;
+    placeholder?: string;
+    /** A typed field's up and down buttons. Default `false`: a dense panel
+     *  drives its numbers by typing, the arrow keys and the wheel. */
+    steppers?: boolean;
+}
+/** A text field. */
+interface PropertyStringFieldProps extends FieldBase {
+    kind: 'string';
+    control?: 'input' | 'textarea';
+    /** Absent reads as an empty field. */
+    value: string | null | undefined;
+    /**
+     * The committed text. On its own it fires on every keystroke. Given
+     * `onInput` as well, the field drafts: `onInput` gets each keystroke and
+     * this fires once, on blur or Enter, and only if the text changed.
+     */
+    onChange: (next: string) => void;
+    onInput?: (next: string) => void;
+    placeholder?: string;
+    maxLength?: number;
+}
+/** A choice among fixed options. */
+interface PropertyEnumFieldProps<T extends string = string> extends FieldBase {
+    kind: 'enum';
+    /**
+     * `select` (default) is a dropdown. `radio` and `toggle` show every option
+     * at once — a radio group lists them, and a toggle is a row of segments.
+     */
+    control?: 'select' | 'radio' | 'toggle';
+    /** Absent, or not one of `options`, chooses nothing. */
+    value: T | undefined;
+    options: ReadonlyArray<PropertyOption<T>>;
+    onChange: (next: T) => void;
+    /**
+     * Given, choosing nothing is a value of its own: a `toggle` lets the chosen
+     * segment be clicked off, and calls this. Absent, a toggle always holds one.
+     */
+    onClear?: () => void;
+    /** Shown while no option is chosen. Defaults to "Choose option…". */
+    placeholder?: string;
+}
+/** A single color. */
+interface PropertyColorFieldProps extends FieldBase {
+    kind: 'color';
+    /** `#rrggbb`, or `#rrggbbaa` when `alpha` is `true`. */
+    value: string | undefined;
+    /**
+     * The committed color. Given `onInput` as well, it fires once per gesture —
+     * the picker closing, or the opacity track let go; on its own it fires on
+     * every move. A caller wanting settled values only passes a no-op `onInput`.
+     */
+    onChange: (next: string) => void;
+    onInput?: (next: string) => void;
+    /**
+     * Offer an opacity track. `true` keeps the alpha in `value` as `#rrggbbaa`;
+     * a number is the 0..1 alpha held apart from it, reported through
+     * `onAlphaChange` / `onAlphaInput`.
+     */
+    alpha?: boolean | number;
+    onAlphaChange?: (next: number) => void;
+    onAlphaInput?: (next: number) => void;
+    /** Draw the opacity track inert, for a consumer that drops alpha. */
+    alphaDisabled?: boolean;
+}
+/** A whole paint: a solid, a gradient, a pattern, or none. */
+interface PropertyPaintFieldProps extends FieldBase {
+    kind: 'paint';
+    /** `swatch` (default) opens the editor in a popover, for a narrow slot;
+     *  `inline` draws the kind bar and its editor in place. */
+    control?: 'swatch' | 'inline';
+    /** `null` is an explicit "no paint"; `undefined` is nothing to show. */
+    value: FillStyle | null | undefined;
+    onChange: (next: FillStyle | null) => void;
+    onInput?: (next: FillStyle | null) => void;
+    /** Offer "None". Default `true`. */
+    allowNone?: boolean;
+    /** Restrict the kinds offered. Default: every registered kind. */
+    kinds?: readonly PaintKind[];
+}
+/** A font family, picked from the live font registry. */
+interface PropertyFontFamilyFieldProps extends FieldBase {
+    kind: 'font-family';
+    value: string | undefined;
+    onChange: (next: string) => void;
+    /** The weight and slant the family is drawn at, so the picker names the
+     *  variant that will actually paint. */
+    weight?: number;
+    fontStyle?: 'normal' | 'italic';
+}
+/**
+ * One field for {@link PropertyControl} and {@link PropertyField}, keyed by
+ * `kind`.
+ */
+type PropertyControlProps<T extends string = string> = PropertyBooleanFieldProps | PropertyNumberFieldProps | PropertyStringFieldProps | PropertyEnumFieldProps<T> | PropertyColorFieldProps | PropertyPaintFieldProps | PropertyFontFamilyFieldProps;
+/** Row props {@link PropertyField} adds to the field it draws. */
+interface PropertyFieldRowProps extends PropertyMetricProps {
+    label: ReactNode;
+    /**
+     * Text beside the label. On a slider it replaces the editable readout —
+     * use it when the row is not showing a number a caller could type back,
+     * such as an auto row's `auto`.
+     */
+    readout?: ReactNode;
+    description?: string;
+    layout?: PropertyRowLayout;
+    /** Take the full width of the enclosing grid — see `<PropertyRow span>`. */
+    span?: boolean;
+    /** The row is auto — see `<PropertyRow auto>`. */
+    auto?: boolean;
+    /** Toggles `auto` from the row's label — see `<PropertyRow onAutoChange>`. */
+    onAutoChange?: (next: boolean) => void;
+    /** Class on the row. `controlClassName` reaches the control. */
+    rowClassName?: string;
+    controlClassName?: string;
+}
+/** Props for {@link PropertyField}: one field, and the row around it. */
+type PropertyFieldProps<T extends string = string> = PropertyFieldRowProps & DistributiveOmit<PropertyControlProps<T>, 'className' | 'id'>;
+type DistributiveOmit<U, K extends PropertyKey> = U extends unknown ? Omit<U, K> : never;
+/**
+ * A labeled settings row for one field, its control chosen by `kind` (and
+ * `control`): `<PropertyField kind="number" control="slider" label="Blur" …>`.
+ *
+ * The row is a {@link PropertyRow}; the control is the one
+ * {@link PropertyControl} draws for the same props. Every schema-driven
+ * settings surface in the kit — `ControlPanel`, `PrefsForm`, `SelectionPanel`
+ * — draws its built-in kinds through that one mapping, so a kind's control
+ * is decided once.
+ *
+ * Callbacks follow the field's shape: a discrete control (a box, a choice)
+ * reports each pick; a continuous or typed one reports every change through
+ * `onChange` alone, or splits them into live `onInput` and settled
+ * `onChange` when given both. `mixed` and `unset` show a field whose sources
+ * disagree, or agree on holding nothing.
+ */
+declare function PropertyField<T extends string = string>(props: PropertyFieldProps<T>): react.JSX.Element;
+/**
+ * The control for one field, with no row around it — for a cell that shares
+ * a row with others, or a surface that draws its own row. Keyed by `kind`
+ * (and `control`), the same mapping {@link PropertyField} draws.
+ *
+ * A slider brings its readout beside the track. Several elements come back
+ * as siblings rather than wrapped, so the surrounding row lays them out.
+ */
+declare function PropertyControl<T extends string = string>(typed: PropertyControlProps<T>): 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. */
@@ -78,7 +302,7 @@ 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;
+declare function CurveField({ values, min, max, step, width, height, defaults, onChange, marks, }: CurveFieldProps): react.JSX.Element;
 
 /** Props for `<PropertyGroup>`. */
 interface PropertyGroupProps extends PropertyMetricProps, StanceProps {
@@ -128,7 +352,7 @@ interface PropertyGroupProps extends PropertyMetricProps, StanceProps {
  * `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, leading, actions, description, hidden, collapsible, defaultCollapsed, collapsed, onCollapsedChange, children, className, span, pack, density, align, stance, tone, }: 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 {
@@ -139,7 +363,7 @@ interface SubpanelProps extends PropertyMetricProps, StanceProps {
 /** 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_runtime.JSX.Element;
+declare function Subpanel({ title, children, className, density, align, stance, tone }: SubpanelProps): react.JSX.Element;
 
 /** A design token as `TokenPanel` edits it. */
 interface TokenEntry {
@@ -217,7 +441,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 {
@@ -244,34 +468,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 {
@@ -348,7 +545,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 {
@@ -363,7 +560,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
@@ -481,10 +678,12 @@ interface SvgStroke {
      *  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;
-    markerEnd?: string;
+    /** `marker-start` / `marker-mid` / `marker-end` as the kit's `MarkerRef`: the
+     *  bare `url(#id)` key, or a key with the `size` the serializer writes into a
+     *  def of its own. */
+    markerStart?: MarkerRef;
+    markerMid?: MarkerRef;
+    markerEnd?: MarkerRef;
 }
 /**
  * Leaf node: a path geometry plus fill/stroke. All other v1 shapes
@@ -685,7 +884,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. */
@@ -804,7 +1003,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
@@ -853,6 +1052,9 @@ interface LabBaseProps {
     /** Offer the header's add-trial control. Default `true`; a lab that opens
      *  trials some other way passes `false`. */
     addTrial?: boolean;
+    /** Offer the header's zoom controls, which act on the focused trial's camera
+     *  and answer Mod+=, Mod+- and Mod+0. Default `true`. */
+    zoom?: boolean;
     /** Tools offered lab-wide. A trial whose instrument declares none of its own
      *  reflects and writes this slot. */
     tools?: readonly TrialTool[];
@@ -877,7 +1079,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): 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_runtime.JSX.Element | 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 {
@@ -892,7 +1094,7 @@ interface LabBoundaryProps {
  * 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_runtime.JSX.Element;
+declare function LabBoundary({ children }: LabBoundaryProps): react.JSX.Element;
 
 /** Props for `<LabPalette>`. */
 interface LabPaletteProps {
@@ -904,7 +1106,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 {
@@ -924,7 +1126,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 {
@@ -949,7 +1151,17 @@ 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, documentTitle, }: LabShellProps): react_jsx_runtime.JSX.Element;
+declare function LabShell({ title, children, header, footer, mode, pages, path, documentTitle, }: LabShellProps): react.JSX.Element;
+
+/**
+ * Zoom out, the zoom as a percentage, and zoom in, for whichever trial has the
+ * focus. The percentage resets to actual size. They route through core's
+ * `viewport.zoom` action, on a dispatcher of their own that listens for its
+ * keys — Mod+=, Mod+- and Mod+0 — so the buttons and the keys are one path.
+ * Over a trial with no camera the group stays, disabled, so the header does not
+ * reflow as the focus moves.
+ */
+declare function LabZoom(): 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. */
@@ -1011,7 +1223,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"];
@@ -1023,7 +1235,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. */
@@ -1051,7 +1263,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'> {
@@ -1064,7 +1276,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 {
@@ -1105,7 +1317,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, ExpandIcon, ExportMenu, IconProps, Instrument, InstrumentList, JobHandle, Jog, Lab, LabBoundary, 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, InstrumentSpec, JogProps, LabBoundaryProps, 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, LabZoom, MarkList, MarkScene, MarkStyle, PaintableMark, PauseIcon, PlayIcon, PropertyControl, PropertyField, PropertyGroup, PropertyListPack, PropertyRowLayout, 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, PropertyControlProps, PropertyFieldProps, PropertyGroupProps, PropertyOption, SubpanelProps, TokenCategory, TokenEntry, TokenPanelProps, TokenScale, TokenScaleRule, TrialBodyProps, TrialChromeProps, TrialLayout, TrialProps, UndoBindings, ValidationResult, ViewTransform2D, WorkspaceProps };