@weasel-js/labkit 1.7.0 → 1.7.1

package/dist/index.d.ts

@@ -1,475 +1,33 @@
+export { Button, ButtonProps, ButtonSize, ButtonVariant, CloseIcon, CollapseIcon, CurveField, CurveFieldProps, CurveMark, DetailList, DetailListLayout, DetailListProps, DetailListValues, DetailRow, DetailRowProps, DetailRowStatus, ExpandIcon, Icon, IconProps, Input, InputProps, Jog, JogProps, LayerList, LayerListItem, LayerListProps, LayerMove, PauseIcon, PlayIcon, PropertyControl, PropertyControlProps, PropertyField, PropertyFieldProps, PropertyGroup, PropertyGroupProps, PropertyList, PropertyListPack, PropertyListProps, PropertyOption, PropertyPanel, PropertyPanelProps, PropertyRow, PropertyRowLayout, PropertyRowProps, PropertyRowVariant, PropertySpan, PropertySpanProps, ResetIcon, Select, SelectProps, StepBackIcon, StepForwardIcon, StopIcon, Subpanel, SubpanelProps, ToggleBar, ToggleBarItem, ToggleBarProps, ToggleBarSize, ToggleBarVariant, TokenCategory, TokenEntry, TokenPanel, TokenPanelProps, TokenScale, TokenScaleRule, inferTokenType, moveLayers, refitScale } from '@weasel-js/ui';
+import { SceneNode, View, DrawCommand, BuiltinToolId } from '@weasel-js/core';
+import { A as AnnotationMeaning, t as AnnotationData, v as WorldRect, w as MarkStyle, x as MarkScene, y as CaptureSource, z as CaptureOptions, B as CaptureResult, E as PaintableMark, F as AnnotationTarget, G as AnnotationsApi, H as AnnotationsCapability, J as TrialInfo, K as TrialTool, N as AnnotationKind, a as ViewTransform, O as Instrument, q as InstrumentList, o as LabMode, Q as LabDensity, R as TrialContribution, c as StorageAdapter, T as TrialRecord } from './_dts/index-DCMA4Fy1.js';
+export { X as Annotation, Y as AnnotationInit, Z as AnnotationPatch, _ as AnnotationQuery, $ as AnnotationSelectionMode, a0 as AnnotationStatus, a1 as AnnotationStoreOptions, a2 as AnnotationTargetInfo, a3 as AnnotationToolId, a4 as Auto, a5 as CanvasCapability, a6 as CanvasLayer, a7 as CaptureDeps, a8 as ContributionBase, C as CreateLabStoreOptions, D as DEFAULT_FRAME, n as DragDropCapability, m as DragFeedback, a9 as FracPoint, aa as FracRect, ab as HitResult, ac as IconComponent, L as LabDocument, d as LabStoreState, ad as LayerCapability, ae as LayerDescriptor, l as PaletteItem, P as Point, af as RegionContribution, ag as RenderContext, e as SavedSnapshot, ah as SerializedAnnotations, S as SerializedTrial, ai as SidebarSection, aj as SidebarSlotContext, ak as StageCapability, al as StatusReadout, f as StorageChange, am as SystemEvent, an as ToolCapability, ao as ToolItem, ap as ToolSlotContext, aq as ToolbarItem, ar as TrialChromeContext, as as TrialRegion, g as TrialStateHandle, at as UndoCapability, U as UndoStack, h as UndockedPanel, i as UndockedPanels, au as ViewportControl, V as ViewportSize, W as WorldFrame, b as WorldSpec, av as annotationsFromJSON, k as applyCamera, aw as auto, ax as createAnnotationScene, ay as createAnnotationStore, j as dockPanel, az as fracContains, aA as fracEncloses, aB as fracToWorld, aC as isAuto, aD as markCommands, p as panelKey, r as resolveFrame, aE as roundFrac, u as undockPanel, aF as worldToFrac } from './_dts/index-DCMA4Fy1.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
-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';
+import { SvgNode } from '@weasel-js/svg';
+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-D6t7o0pF.js';
+export { C as CanvasLayerDescriptor, a as CanvasStackContext, b as CanvasStackContextValue, c as CanvasStackSurface } from './_dts/CanvasStackContext-Cjy6I-Iv.js';
+import { L as LabContribution } from './_dts/index-BTmaRy6a.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 TRANSIENT_BUILTINS, n as TitleBarPlacement, o as TitleBarRegion, p as TitleBarRegionProps, q as ToolbarRegion, r as ToolbarRegionProps, V as ViewportRegion, s as ViewportRegionProps, t as addTrial, u as builtinContributions, v as cloneTrial, w as closeTrial, x as contributionsIn, y as labContributions, z as mergeContributions, B as reorderTrials, C as resetTrial, D as suppressContributions, E as toolContributions, F as useLabChromeContext, G as useLabContext } from './_dts/index-BTmaRy6a.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-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';
+import { C as ConfigSchema, a as ConfigField, b as ConfigRule, c as ControlRenderer } from './_dts/types-BUBSIZuV.js';
+export { A as Annotations, B as BranchAnnotations, d as BranchOptions, e as CheckboxField, f as ColorField, g as ConfigBranch, h as ConfigEntry, i as ConfigFieldBase, j as ConfigFieldType, k as ConfigNode, l as ConfigOf, m as ConfigOption, n 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-BUBSIZuV.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';
 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';
+import { SplitProps } from './primitives/index.js';
+export { FpsMeter, JobProgress, JobProgressProps, Legend, LegendEntry, LegendMark, LegendProps, Readout, ReadoutProps, ReadoutRow, 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-Bh8bzFgE.js';
+export { Box, Rect, SurfaceCanvasContext, SurfaceCanvases, SurfaceClear, SurfaceContext, SurfaceFrame, SurfaceHandle, SurfaceLayer, TilePainter, UseTiledSurfaceOptions, composeRects, 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 '@weasel-js/geom';
+import '@weasel-js/quantity';
 import 'windease';
 import 'zustand/vanilla';
 
-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. */
-type CurveMark = {
-    kind: 'band';
-    x: [number, number];
-    color?: string;
-} | {
-    kind: 'line';
-    x: number;
-    color?: string;
-};
-/** Props for `<CurveField>`. */
-interface CurveFieldProps {
-    /** Flat [x0, y0, x1, y1, …] — matches how curve-as-array configs
-     *  serialize in JSON snapshots. */
-    values: number[];
-    min: number;
-    max: number;
-    step: number;
-    /** Plot width in CSS px. Caller sizes (typically uses a ResizeObserver). */
-    width: number;
-    /** Plot height in CSS px. Default 110. */
-    height?: number;
-    /** Flat default curve. When provided, a Reset button restores it. */
-    defaults?: readonly number[];
-    onChange: (next: number[]) => void;
-    /** Optional vertical marks overlaid on the plot (e.g. landmarks). */
-    marks?: readonly CurveMark[];
-}
-/**
- * A function-domain (y = f(x), x ∈ [0,1]) curve editor with per-stop
- * numeric readouts and flip buttons. Wraps weasel-ui's
- * `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.Element;
-
-/** Props for `<PropertyGroup>`. */
-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;
-    /** When true the group renders nothing — useful for conditional sections. */
-    hidden?: boolean;
-    /**
-     * Give the title a twisty that folds the rows away. Implied by any of the
-     * three props below, so it is only needed for a group that starts open and
-     * keeps its own state.
-     */
-    collapsible?: boolean;
-    /** Start folded. Read once; the group owns the state from then on. */
-    defaultCollapsed?: boolean;
-    /**
-     * Folded or not, as the consumer holds it. Given, the group keeps no state
-     * of its own and every toggle arrives at `onCollapsedChange` instead — which
-     * is what a panel that remembers its sections past a reload needs.
-     */
-    collapsed?: boolean;
-    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;
-}
-/**
- * Visually-bordered group inside a PropertyList. Use to scope a set of
- * related rows under a heading (e.g. "Aqua", "Bevel", "Dome" sections
- * 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. `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, 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 {
-    /** 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.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.Element;
-
 /** What resolving a mark's appearance needs beyond the mark itself. */
 interface MarkDrawOptions {
     /** The target's content box — the world a mark's geometry is in. */
@@ -509,6 +67,8 @@ type CapturePlan = 'svg-document' | 'raster-stack';
  * base.
  */
 declare function capturePlan(base: CaptureSource | undefined, format: 'png' | 'svg'): CapturePlan;
+/** Inputs to `composeCaptureSvg`. `scale` is output pixels per content-box
+ *  unit; `onWarn` receives non-fatal export warnings. */
 interface ComposeSvgArgs {
     base?: CaptureSource;
     scene: MarkScene;
@@ -522,7 +82,10 @@ interface ComposeSvgArgs {
  * The outer `viewBox` is the content box, so marks — which are already in it —
  * need no transform, and `width`/`height` carry the export scale. Both halves
  * nest as child `<svg>` elements, which each establish their own viewport and
- * so keep their own `viewBox` maths out of this function.
+ * so keep their own `viewBox` math out of this function.
+ *
+ * Synchronous with no `warmSvg`: marks export nothing that loads on demand,
+ * which `svgNodes.test.ts` pins.
  */
 declare function composeCaptureSvg(args: ComposeSvgArgs): string;
 /** What a capture needs about the target it is exporting. */
@@ -581,250 +144,6 @@ 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
- * tree but uses weasel-native leaf data (`Path`, `FillStyle`) for geometry and
- * paint.
- *
- * Parsing collapses every `transform="..."` onto its descendants' geometry,
- * so the `SvgNode` tree returned from `parseSvg` never has a non-identity
- * group transform. Consumers may still construct groups with explicit
- * transforms before serializing, in which case the serializer emits a
- * single `matrix(a b c d e f)` on the `<g>`.
- */
-
-/**
- * Opaque pass-through bag for namespaced XML content.
- *
- * weasel-svg does not interpret the contents — it only ensures that any
- * attributes or child elements in a *declared* XML namespace round-trip
- * losslessly through parse → serialize. Consumers (e.g. an app-specific
- * bridge layer) hang their domain semantics off this structure.
- *
- * Keyed by namespace prefix (the prefix is a write-time choice; the URI
- * is the canonical identifier and is supplied via `ParseOptions.namespaces`
- * / `SerializeOptions.namespaces`).
- */
-interface NamespaceMeta {
-    [prefix: string]: {
-        /** Local-name → string-value map for attributes in this namespace. */
-        attrs?: Record<string, string>;
-        /**
-         * Child elements in this namespace, keyed by local name. Each entry
-         * is an array because a namespace can host multiple sibling elements
-         * with the same tag (e.g. `<wd:layer/><wd:layer/>`).
-         */
-        elements?: Record<string, NamespacedElement[]>;
-    };
-}
-/** Opaque structured representation of a namespaced element. */
-interface NamespacedElement {
-    /** Attribute local-name → string-value. */
-    attrs: Record<string, string>;
-    /** Text content, when the element contains only text (no child elements). */
-    text?: string;
-    /** Nested namespaced children, keyed by local name (recursive). */
-    children?: Record<string, NamespacedElement[]>;
-}
-/**
- * 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 = Mat3;
-/**
- * FillStyle description in the SVG sense — either explicit `none`, a solid
- * color, or a reference to a weasel-native gradient `FillStyle`. Solid colors
- * are normalized to `#rrggbb` strings; opacity is carried separately so
- * `fill-opacity` and `stroke-opacity` round-trip cleanly.
- */
-type SvgPaint = {
-    kind: 'none';
-} | {
-    kind: 'solid';
-    color: string;
-    opacity?: number;
-} | {
-    kind: 'gradient';
-    paint: FillStyle;
-};
-/** Stroke description: a paint plus structural line parameters. */
-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"`.
-     *  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';
-    /** `stroke-linejoin`. Default per SVG spec is `'miter'`. SVG's `arcs` / `miter-clip` map to `'miter'` with a warning. */
-    join?: 'miter' | 'round' | 'bevel';
-    /** `stroke-dasharray` as a flat number array. Odd-length inputs are doubled per SVG spec. */
-    dash?: number[];
-    /**
-     * `stroke-miterlimit`. SVG's default is 4. Weasel's renderer defaults to
-     * 10 (Canvas2D) when unset, so parsed strokes without an explicit
-     * 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 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
- * (`<rect>`, `<ellipse>`, etc.) are lowered to this representation on
- * parse — `<rect>` uses weasel's `RectPath` fast-path subtype when
- * possible, everything else becomes a `PolygonPath`.
- */
-interface SvgPathNode {
-    kind: 'path';
-    path: Path;
-    fill: SvgPaint;
-    stroke?: SvgStroke;
-    /** Element-level opacity (`opacity="..."`), 0..1. */
-    opacity?: number;
-    /** Element-level rotation in **radians**, pivoting around the AABB
-     *  center of the underlying `path` geometry. Emitted as SVG
-     *  `transform="rotate(angleDegrees cx cy)"`. */
-    rotation?: number;
-    /** Opaque per-element bag for declared namespaces. See `NamespaceMeta`. */
-    meta?: NamespaceMeta;
-}
-/**
- * Group node: an SVG `<g>`. On parse, `transform` is always omitted (any
- * `transform` attribute is collapsed onto descendants' geometry). On
- * serialize, a non-identity `transform` is emitted as
- * `matrix(a b c d e f)`.
- */
-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;
-}
-/**
- * Text leaf node. Mirrors the kit's `TextPose` shape — a bounding box plus
- * text content, optional rich-text `runs` (per-range styling), and an
- * optional `TextStyle` for the node-wide defaults.
- *
- * Note on SVG text geometry: native `<text>` flows from a baseline; it
- * doesn't have width/height attributes. The serializer emits
- * `dominant-baseline="text-before-edge"` so `y` is the top of the text
- * box, plus `data-weasel-width` / `data-weasel-height` so weasel's
- * explicit box dimensions round-trip losslessly. External SVG text
- * (lacking the data-* attrs) imports with the width the kit's text layout
- * measures — an em-based estimate when no registered font can — and
- * `height = fontSize * lineHeight * (lineCount || 1)`.
- *
- * `x` here is always the box's left edge. In the SVG it is the
- * `text-anchor` point, and the parser and serializer convert between them.
- */
-interface SvgTextNode {
-    kind: 'text';
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    /** Plain text. When `runs` is set, `runsToPlainText(runs)` must equal `text`. */
-    text: string;
-    /** Optional per-range styling — same shape as `TextPose.runs`. */
-    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
-     * nodes' shape — a text paint reaches the renderer through the runs, and
-     * `StyledRun.fill` / `.stroke` override these per range.
-     *
-     * `null` is SVG's `fill="none"`: outline-only text, painted by its stroke
-     * alone. Absent takes the default black.
-     */
-    fill?: FillStyle | null;
-    stroke?: Stroke;
-    /** Element-level opacity (`opacity="..."`), 0..1. */
-    opacity?: number;
-    /** Element-level rotation in **radians**, pivoting around the unrotated
-     *  AABB center `(x + width/2, y + height/2)`. Emitted as SVG
-     *  `transform="rotate(angleDegrees cx cy)"`. */
-    rotation?: number;
-    /** Opaque per-element bag for declared namespaces. See `NamespaceMeta`. */
-    meta?: NamespaceMeta;
-}
-/**
- * Raster-image leaf — an SVG `<image>`. `href` is the element's `href` (or
- * legacy `xlink:href`) verbatim: an external URL or a `data:` URI. The
- * package neither fetches nor decodes it, so an external URL round-trips as
- * 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';
-    href: string;
-    x: number;
-    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
-     *  AABB center `(x + width/2, y + height/2)`. Emitted as SVG
-     *  `transform="rotate(angleDegrees cx cy)"`. */
-    rotation?: number;
-    /** Opaque per-element bag for declared namespaces. See `NamespaceMeta`. */
-    meta?: NamespaceMeta;
-}
-/** Discriminated-union node — the leaf of the public tree. */
-type SvgNode = SvgPathNode | SvgGroupNode | SvgTextNode | SvgImageNode;
-
 /**
  * One mark as SVG nodes, converted from the very commands the pane paints.
  *
@@ -832,10 +151,7 @@ type SvgNode = SvgPathNode | SvgGroupNode | SvgTextNode | SvgImageNode;
  * and this is a translation of it. `serializeSvg` turns the result into a
  * document.
  */
-declare function markSvgNodes(m: PaintableMark, content: {
-    w: number;
-    h: number;
-}, style?: MarkStyle): SvgNode[];
+declare function markSvgNodes(m: PaintableMark, style?: MarkStyle, scale?: View['scale']): SvgNode[];
 
 /** Props for `<AnnotationOverlay>`. */
 interface AnnotationOverlayProps {
@@ -1079,7 +395,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.Element | null;
+declare function Lab(props: LabProps): string | number | bigint | boolean | react.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 `<LabBoundary>`. */
 interface LabBoundaryProps {
@@ -1175,6 +491,7 @@ type TrialLayout = Record<string, {
         rows?: number;
     };
 }>;
+/** Props for `Workspace`. */
 interface WorkspaceProps {
     children: ReactNode;
     /**
@@ -1203,7 +520,7 @@ interface WorkspaceProps {
     padding?: number;
     /** Undocked sidebar panels to render alongside the trials. A `'tile'` panel
      *  joins the grid as a peer of the trials; a `'floating'` one goes into the
-     *  floating zone above it. The body is portalled in by the trial that owns
+     *  floating zone above it. The body is portaled in by the trial that owns
      *  it, so all this renders is the frame and the host. */
     panels?: readonly PanelDescriptor[];
     /**
@@ -1223,6 +540,20 @@ interface PanelDescriptor {
     title: string;
     as: 'tile' | 'floating';
 }
+/**
+ * Auto-balanced tiling of trials, `ceil(sqrt(n))` columns wide.
+ *
+ * Tiles are absolutely positioned at the rects `gridStrategy` computes, not
+ * laid out by CSS — `windease/styles.css` (folded into
+ * `@weasel-js/labkit/styles.css`) carries the rules that positioning depends on.
+ *
+ * `panels` are undocked sidebar sections. A `'tile'` panel is registered as a
+ * peer of the trials under `PANEL_KIND`, so the grid places and resizes it like
+ * one; a `'floating'` panel goes in the overlay above. Either way this renders
+ * only the frame and an empty host: the section's content is portaled in by
+ * the trial that owns it, which is what keeps a torn-out section inside its
+ * trial's React tree instead of rebuilding it as a sibling.
+ */
 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. */
@@ -1240,6 +571,7 @@ declare function Specimen({ className }: {
 /** 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;
+/** Zoom 1, no pan. */
 declare const DEFAULT_VIEW: ViewTransform2D;
 /** A trial's view is opaque to labkit, so anything that needs the 2D shape — the
  *  zoom chrome, `CanvasStack` — asks for it and handles not getting it. */
@@ -1252,6 +584,19 @@ declare function as2DView(view: unknown): ViewTransform2D | null;
  */
 declare const interstellarTheme: Theme;
 
+/**
+ * A trial's loupe switch, as a lens mounted inside the trial finds it. The
+ * trial offers its toolbar toggle while at least one lens has called `mount`,
+ * and every lens reads `on` as whether it is turned on.
+ */
+interface LoupeSwitch {
+    on: boolean;
+    /** Reports a lens mounted; the returned function reports it gone. */
+    mount: () => () => void;
+}
+/** The loupe switch of the trial around the caller, or `null` outside one. */
+declare const LoupeSwitchContext: react.Context<LoupeSwitch | null>;
+
 /** Props for `<Trial>`. */
 interface TrialProps {
     id: string;
@@ -1283,6 +628,7 @@ interface LoupeBindings {
     on: boolean;
     toggle: () => void;
 }
+/** The trial's undo history as its chrome sees it. */
 interface UndoBindings {
     canUndo: boolean;
     canRedo: boolean;
@@ -1298,8 +644,8 @@ interface TrialChromeProps {
     undoBindings?: UndoBindings;
     /** Supplied when the instrument declares a `job`. */
     job?: JobHandle;
-    /** Supplied when the instrument declares a `loupe`. The lens itself is the
-     *  trial's to mount; the chrome only offers the switch. */
+    /** Supplied while a lens is mounted in the trial. The lens itself is the
+     *  instrument's to mount; the chrome only offers the switch. */
     loupe?: LoupeBindings;
     /** Contributions the trial runtime itself adds — the drag palette and the
      *  layer list, which depend on runtime state the instrument cannot reach. */
@@ -1319,5 +665,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.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, 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 };
+export { ANNOTATION_TOOLS, ANNOTATION_WEASEL_TOOLS, AnnotationData, AnnotationKind, AnnotationMeaning, AnnotationOverlay, AnnotationTarget, AnnotationTargets, AnnotationsApi, AnnotationsCapability, AnnotationsContext, CaptureOptions, CaptureResult, CaptureSource, ConfigField, ConfigRule, ConfigSchema, ControlRenderer, DEFAULT_VIEW, ExportMenu, Instrument, InstrumentList, JobHandle, Lab, LabBoundary, LabContribution, LabDensity, LabMode, LabPalette, LabRoot, LabShell, LabSwitcher, LabZoom, LoupeSwitchContext, MarkList, MarkScene, MarkStyle, PaintableMark, SPECIMEN_SECTIONS, Specimen, SplitProps, StorageAdapter, Trial, TrialBody, TrialChrome, TrialContribution, TrialInfo, TrialRecord, TrialTool, ViewTransform, Workspace, WorldRect, annotationToolInfo, as2DView, capturePlan, captureTarget, composeCaptureSvg, createMarkDrawOne, currentPage, defineInstrument, fitView, fromWeaselView, interstellarTheme, isStale, markSvgNodes, resolveMarkStyle, seenFrom, toWeaselView, useAnnotations, useAnnotationsOptional, validateConfigSchema };
+export type { AnnotationOverlayProps, AnnotationTargetsProps, AnnotationToolInfo, CaptureArgs, CapturePlan, ComposeSvgArgs, ContentSize, InstrumentSpec, LabBoundaryProps, LabPage, LabPaletteProps, LabProps, LabRootProps, LabShellProps, LabSwitcherProps, LoupeSwitch, MarkDrawOptions, MarkListProps, PaneSize, PanelDescriptor, TrialBodyProps, TrialChromeProps, TrialLayout, TrialProps, UndoBindings, ValidationResult, ViewTransform2D, WorkspaceProps };