@weasel-js/labkit 1.6.0 → 1.7.0

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

@@ -1,15 +1,14 @@
-import { j as ToggleBarSize, k as ToggleBarVariant, l as SegmentTooltipFields, F as FieldOrientation, O as OverlayPortalProps, W as WithoutPortalTarget } from '../_dts/Select.d-BchGMC2Y.js';
-export { B as Button, a as ButtonProps, b as ButtonSize, c as ButtonVariant, m as Field, n as FieldProps, o as ICON_PATHS, d as Icon, p as IconName, I as IconProps, e as Input, f as InputProps, S as Select, q as SelectItem, r as SelectItemProps, s as SelectOption, g as SelectProps, T as ToggleBar, h as ToggleBarItem, i as ToggleBarProps, t as fieldClasses } from '../_dts/Select.d-BchGMC2Y.js';
+import { S as StanceProps, D as Display, P as PrefRenderer } from '../_dts/PrefsRow.d-TOZ7BgD9.js';
+export { M as MINUS_SIGN, a as PrefRenderContext, f as formatNumber } from '../_dts/PrefsRow.d-TOZ7BgD9.js';
+import { j as ToggleBarSize, k as ToggleBarVariant, b as ButtonSize, c as ButtonVariant, l as SegmentTooltipFields, F as FieldOrientation, O as OverlayPortalProps, W as WithoutPortalTarget } from '../_dts/Select.d-Bensr_MT.js';
+export { B as Button, a as ButtonProps, m as Field, n as FieldProps, o as ICON_PATHS, d as Icon, p as IconName, I as IconProps, e as Input, f as InputProps, S as Select, q as SelectItem, r as SelectItemProps, s as SelectOption, g as SelectProps, T as ToggleBar, h as ToggleBarItem, i as ToggleBarProps, t as fieldClasses } from '../_dts/Select.d-Bensr_MT.js';
 import { ToolPrefLeaf, ToolPrefGroup, ToolsApi, oklchDegToHex } from '@weasel-js/core';
-export { ToolPref as BuiltinPref, ToolPrefBoolean as PrefBoolean, ToolPrefBooleanControl as PrefBooleanControl, ToolPrefColor as PrefColor, ToolPrefCustom as PrefCustom, ToolPrefEnum as PrefEnum, ToolPrefEnumControl as PrefEnumControl, ToolPrefEnumEncoding as PrefEnumEncoding, ToolPrefGroup as PrefGroup, ToolPrefKind as PrefKind, ToolPrefLeaf as PrefLeaf, ToolPrefNumber as PrefNumber, ToolPrefNumberControl as PrefNumberControl, ToolPrefNumberUnit as PrefNumberUnit, ToolPrefObject as PrefObject, ToolPrefPaint as PrefPaint, ToolPrefString as PrefString, ToolPrefStringControl as PrefStringControl } from '@weasel-js/core';
-import * as react_jsx_runtime from 'react/jsx-runtime';
+export { ToolPref as BuiltinPref, ToolPrefBoolean as PrefBoolean, ToolPrefBooleanControl as PrefBooleanControl, ToolPrefBooleanEncoding as PrefBooleanEncoding, ToolPrefColor as PrefColor, ToolPrefCustom as PrefCustom, ToolPrefEnum as PrefEnum, ToolPrefEnumControl as PrefEnumControl, ToolPrefEnumEncoding as PrefEnumEncoding, ToolPrefGroup as PrefGroup, ToolPrefKind as PrefKind, ToolPrefLeaf as PrefLeaf, ToolPrefNumber as PrefNumber, ToolPrefNumberControl as PrefNumberControl, ToolPrefNumberUnit as PrefNumberUnit, ToolPrefObject as PrefObject, ToolPrefPaint as PrefPaint, ToolPrefString as PrefString, ToolPrefStringControl as PrefStringControl } from '@weasel-js/core';
 import * as react from 'react';
-import { ReactNode, CSSProperties, HTMLAttributes, ReactElement, PointerEvent, RefCallback, KeyboardEvent, RefObject } from 'react';
-import { S as StanceProps, P as PrefRenderer } from '../_dts/PrefsRow.d-DFpPIeIC.js';
-export { a as PrefRenderContext } from '../_dts/PrefsRow.d-DFpPIeIC.js';
-export { L as LayerList, a as LayerListItem, b as LayerListProps, c as LayerMove, m as moveLayers } from '../_dts/LayerList.d-2c9yup5Y.js';
+import { ReactNode, CSSProperties, HTMLAttributes, ButtonHTMLAttributes, ReactElement, PointerEvent, RefCallback, KeyboardEvent, RefObject } from 'react';
+export { L as LayerList, a as LayerListItem, b as LayerListProps, c as LayerMove, m as moveLayers } from '../_dts/LayerList.d-DiuEArKq.js';
 import { ColorModePreference } from '@weasel-js/theme';
-export { M as MINUS_SIGN, f as formatNumber } from '../_dts/number.d-OeQYQoUO.js';
+export { l as PropertyAlign, m as PropertyDensity, P as PropertyMetricProps } from '../_dts/PropertyPanel.d-D-1paCbE.js';
 import { CheckboxProps as CheckboxProps$1, SwitchProps as SwitchProps$1, TabProps as TabProps$1, TabListProps as TabListProps$1, TabPanelProps as TabPanelProps$1, TabsProps as TabsProps$1, RadioProps as RadioProps$1, RadioGroupProps as RadioGroupProps$1, ValidationResult, NumberFieldProps as NumberFieldProps$1, ComboBoxProps as ComboBoxProps$1, ListBoxItemProps, SliderProps as SliderProps$1, ModalOverlayProps, DialogProps as DialogProps$1, PopoverProps } from 'react-aria-components';
 export { DialogTrigger as CalloutTrigger } from 'react-aria-components';
 
@@ -82,7 +81,7 @@ interface ActionBarProps {
  * (roving tabindex) yet — bar consumers today are short flat strips. Add
  * if/when a long bar lands.
  */
-declare function ActionBar(props: ActionBarProps): react_jsx_runtime.JSX.Element;
+declare function ActionBar(props: ActionBarProps): react.JSX.Element;
 
 /**
  * Built-in badge silhouettes. `pill`, `plain` and `square` are drawn in CSS;
@@ -467,12 +466,19 @@ interface RibbonParams {
  * returns the horizontal displacement of that point, positive to the right.
  */
 type EdgeProfile = (t: number, depth: number) => number;
-/** The named edge profiles in {@link EDGE_PROFILES}. */
-type BuiltInEdgeName = 'flat' | 'chevron' | 'slant' | 'slant-up' | 'round' | 'scallop' | 'concave-chevron';
+/** The named edge caps expressible as an {@link EdgeProfile}, in {@link EDGE_PROFILES}. */
+type BuiltInProfileName = 'flat' | 'chevron' | 'slant' | 'slant-up' | 'round' | 'scallop' | 'concave-chevron';
+/**
+ * Every named edge cap. `puzzle` is a jigsaw tab: a round knob on a narrower
+ * neck, protruding from the edge's owner into a matching socket in its
+ * neighbor. Its bulb overhangs its neck, so it is not a function of `t` and
+ * has no entry in {@link EDGE_PROFILES}.
+ */
+type BuiltInEdgeName = BuiltInProfileName | 'puzzle';
 /** An edge profile, either by name or as a function. */
 type EdgeCap = BuiltInEdgeName | EdgeProfile;
 /** The built-in {@link EdgeProfile} implementations, by name. */
-declare const EDGE_PROFILES: Record<BuiltInEdgeName, EdgeProfile>;
+declare const EDGE_PROFILES: Record<BuiltInProfileName, EdgeProfile>;
 
 interface PowerlineParams {
     /** Profile for the left edge (the cap segment N inherits from segment N-1). */
@@ -811,6 +817,26 @@ type BadgeProps = BadgePropsByShape;
  */
 declare const Badge: react.ForwardRefExoticComponent<BadgePropsByShape & react.RefAttributes<HTMLElement>>;
 
+/** Props for {@link CloseButton}. */
+interface CloseButtonProps {
+    /** Accessible name — what the press closes or removes: `Close dialog`,
+     *  `Remove Glow`. Required, since the button shows only a glyph. */
+    ariaLabel: string;
+    onClick?: ButtonHTMLAttributes<HTMLButtonElement>['onClick'];
+    /** Kit tooltip content. None by default. */
+    tooltip?: ReactNode;
+    disabled?: boolean;
+    className?: string;
+}
+/**
+ * The kit's close / dismiss / remove button: the `close` glyph at chrome size
+ * in a square `--wzl-icon-button-size` target. Kit components that dismiss a
+ * surface or remove a row draw their × with this.
+ *
+ * `ref` forwards to the underlying `<button>`.
+ */
+declare const CloseButton: react.ForwardRefExoticComponent<CloseButtonProps & react.RefAttributes<HTMLButtonElement>>;
+
 /**
  * One column of a {@link DataGrid}. `id` doubles as the default property name
  * read off each row when no `accessor` is given.
@@ -876,7 +902,7 @@ interface DataGridProps<Row extends {
  */
 declare function DataGrid<Row extends {
     id: string;
-}>(props: DataGridProps<Row>): react_jsx_runtime.JSX.Element;
+}>(props: DataGridProps<Row>): react.JSX.Element;
 
 /** Props for `<DisclosureMark>`. */
 interface DisclosureMarkProps {
@@ -893,10 +919,10 @@ interface DisclosureMarkProps {
  * button. Anywhere the mark has to be the control, use `<Disclosure>`.
  *
  * Deliberately not part of the icon register, on the same grounds as
- * `DragHandleGlyph`: that register is outline strokes at a fixed weight, and
+ * `DragGrip`: that register is outline strokes at a fixed weight, and
  * this mark is filled.
  */
-declare function DisclosureMark({ open, size, className }: DisclosureMarkProps): react_jsx_runtime.JSX.Element;
+declare function DisclosureMark({ open, size, className }: DisclosureMarkProps): react.JSX.Element;
 /** Props for `<Disclosure>`. */
 interface DisclosureProps {
     /** Whether the section it controls is open. The consumer owns this. */
@@ -932,7 +958,7 @@ interface DisclosureProps {
  * of the row's label rather than a child, so clicking to expand does not
  * actuate the label's own control.
  */
-declare function Disclosure({ open, onToggle, label, controls, size, disabled, className }: DisclosureProps): react_jsx_runtime.JSX.Element;
+declare function Disclosure({ open, onToggle, label, controls, size, disabled, className }: DisclosureProps): react.JSX.Element;
 /** Props for `<DisclosureRow>`. */
 interface DisclosureRowProps extends Omit<DisclosureProps, 'className'> {
     /** The row's own content — a label, a checkbox, a count. */
@@ -947,7 +973,7 @@ interface DisclosureRowProps extends Omit<DisclosureProps, 'className'> {
  * it, so a row whose content is a `<label>` wrapping a checkbox stays
  * clickable as a label without the twisty actuating it.
  */
-declare function DisclosureRow({ children, className, ...twisty }: DisclosureRowProps): react_jsx_runtime.JSX.Element;
+declare function DisclosureRow({ children, className, ...twisty }: DisclosureRowProps): react.JSX.Element;
 
 /** Props for `<DragGhost>`. */
 interface DragGhostProps {
@@ -969,8 +995,8 @@ interface DragGhostProps {
  */
 declare function DragGhost({ at, from, children }: DragGhostProps): react.ReactPortal;
 
-/** Props for `<DragHandleGlyph>`. */
-interface DragHandleGlyphProps {
+/** Props for `<DragGrip>`. */
+interface DragGripProps {
     /** Height in px; width scales with it. Default 16. */
     size?: number;
 }
@@ -979,7 +1005,7 @@ interface DragHandleGlyphProps {
  *  Deliberately not part of the icon register: that register is outline strokes
  *  at a fixed weight, and a grip is filled dots. Forcing it in would either
  *  break the register's rule or produce a worse glyph. */
-declare function DragHandleGlyph({ size }: DragHandleGlyphProps): react_jsx_runtime.JSX.Element;
+declare function DragGrip({ size }: DragGripProps): react.JSX.Element;
 
 /**
  * Width class of a keycap: a modifier glyph, a multi-character legend that
@@ -1022,7 +1048,7 @@ interface KeyCapProps {
 }
 /** Single bordered keycap chip for one glyph (modifier or key). Use
  *  `KeySequence` to render a full shortcut. */
-declare function KeyCap({ label, inverted, variant, className, style, font }: KeyCapProps): react_jsx_runtime.JSX.Element;
+declare function KeyCap({ label, inverted, variant, className, style, font }: KeyCapProps): react.JSX.Element;
 
 /** One key in a shortcut. */
 interface KeySpec {
@@ -1032,16 +1058,22 @@ interface KeySpec {
      *  trigger the action (e.g. an optional modifier). Defaults to false. */
     optional?: boolean;
 }
+/** Where {@link KeySequence} draws its separator. */
+type KeySequenceJoins = 'all' | 'key' | 'none';
 /** Props for {@link KeySequence}. */
 interface KeySequenceProps {
     /** Keys to render. `undefined` or empty renders a muted em-dash.
      *  Modifiers are always rendered first regardless of input order; relative
      *  order within each group is preserved. */
     keys: readonly KeySpec[] | undefined;
-    /** Character inserted between the trailing modifier chip and the first
-     *  non-modifier chip (e.g. `'+'` renders `⌘ + K`). `null` or `''`
-     *  suppresses it. Defaults to `'+'`. */
-    separator?: string | null;
+    /** Glyph drawn wherever {@link joins} places a separator. Defaults to `'+'`. */
+    separator?: string;
+    /** Where the separator goes. Defaults to `'key'`.
+     *  - `'all'`: between every pair of chips — `⌘ + ⇧ + K`, `⌘ + ⇧`, `A + B`.
+     *  - `'key'`: before every non-modifier — `⌘ ⇧ + K`, `⌘ + K + L`, `A + B`.
+     *    Modifiers stay unjoined, so `⌘ ⇧` gets none.
+     *  - `'none'`: never. */
+    joins?: KeySequenceJoins;
     /** Forwarded to every `KeyCap` in the sequence. `'minimal'` renders
      *  unfilled chips whose border + legend are `currentColor`. */
     variant?: KeyCapVariant;
@@ -1052,7 +1084,7 @@ interface KeySequenceProps {
 }
 /** Renders a shortcut as a row of `KeyCap` chips, one per key. Optional
  *  keys render inverted to distinguish them from required ones. */
-declare function KeySequence({ keys, separator, variant, font, className }: KeySequenceProps): react_jsx_runtime.JSX.Element;
+declare function KeySequence({ keys, separator, joins, variant, font, className }: KeySequenceProps): react.JSX.Element;
 
 /** Apple-style glyph for a DOM `KeyboardEvent.key` value. Covers escape,
  *  delete/backspace, arrows, enter/return, tab, space. Unknown keys are
@@ -1216,12 +1248,17 @@ type BoundsCtx = {
     index: number;
 };
 /**
- * Passed to `renderTrack`: the track's width in CSS px and a mapping from a
- * slider value to its 0..1 position along the track.
+ * Passed to `renderTrack`: the track's width in CSS px, a mapping from a
+ * slider value to its 0..1 position along the value span, and the CSS
+ * position (a `calc()` against the painted box's width) of a 0..1 fraction of
+ * that span. A painter places everything that must line up with the thumbs
+ * through `fractionToPosition`: under `thumbFit: 'inside'` the span stops half
+ * a thumb short of each end of the track.
  */
 type TrackCtx = {
     trackWidth: number;
     valueToFraction: (v: number) => number;
+    fractionToPosition: (f: number) => string;
 };
 /** A {@link Slider} stop that carries a label, drawn under the track at the stop. */
 type SliderStop = {
@@ -1250,7 +1287,8 @@ type SliderStop = {
  * `'even'` falls back to linear.
  *
  * `trackClick: 'move-nearest'` makes a press on bare track send the closest
- * thumb there and continue as a drag. It is off by default because on a
+ * thumb there, focus it, and continue as a drag. It is the default for a
+ * single thumb. With several it defaults to `'none'`, because on a
  * multi-thumb editor a stray click would yank a stop the user was not aiming
  * at; `onAddThumb`, where it is set, keeps the track press.
  *
@@ -1259,6 +1297,12 @@ type SliderStop = {
  * `onRemoveThumb` lets a right-click or a drag off the track remove one —
  * both callbacks can decline by returning `null`/`false`. `allowShiftAll`
  * makes shift-drag translate every thumb together.
+ *
+ * `thumbFit: 'inside'`, the default, runs the value span half a thumb short of
+ * each end of the track, so a thumb at `min` or `max` sits flush with the
+ * track's edge instead of hanging half over it — the layout a native range
+ * input has. `'overhang'` runs the span edge to edge and centers an end thumb
+ * on the edge.
  */
 type SliderProps<T extends Thumb = Thumb> = {
     thumbs: readonly T[];
@@ -1278,11 +1322,16 @@ type SliderProps<T extends Thumb = Thumb> = {
     onRemoveThumb?: (index: number) => boolean;
     allowShiftAll?: boolean;
     renderTrack?: (ctx: TrackCtx) => ReactNode;
+    thumbFit?: 'inside' | 'overhang';
     trackHeight?: number;
     /** `'slim'` drives the track and thumb from the kit's slider tokens, so a
      *  Slider matches the property rows. `trackHeight` still wins if given. */
     density?: 'default' | 'slim';
     renderReadout?: (thumb: T, index: number) => ReactNode;
+    /** How a thumb's value shows in the default readout and is spoken as its
+     *  `aria-valuetext` when the thumb gives no `valueText` of its own. Default:
+     *  three decimals shown, nothing spoken beyond `aria-valuenow`. */
+    display?: Display;
     readoutPlacement?: 'none' | 'inline-after' | 'below-thumb';
     ariaLabel?: string;
     className?: string;
@@ -1320,7 +1369,7 @@ interface UseReorderDragListOptions {
      *  also handles `click` sees one press, not two. A press that starts on a
      *  control inside the row (a toggle) is left to the control. */
     onPress?(id: string, mods: PressModifiers): void;
-    /** Pointer-move distance (px) before pending drag engages. Default 4. */
+    /** Pointer-move distance (px) before pending drag engages. Default `DRAG_THRESHOLD_PX`. */
     threshold?: number;
     /** Selector matching the container's children that are rows, for a list
      *  that interleaves other elements (a table's detail rows). Default: every
@@ -1417,7 +1466,7 @@ interface ListEditorProps {
  * each, and an add button under them. Enter in an entry adds one after it;
  * Backspace in an empty one removes it.
  */
-declare function ListEditor({ value, onChange, placeholder, empty, addLabel, 'aria-label': ariaLabel, className, }: ListEditorProps): react_jsx_runtime.JSX.Element;
+declare function ListEditor({ value, onChange, placeholder, empty, addLabel, 'aria-label': ariaLabel, className, }: ListEditorProps): react.JSX.Element;
 
 /** Props for {@link ColorModeControl}. */
 interface ColorModeControlProps {
@@ -1437,6 +1486,41 @@ interface ColorModeControlProps {
  */
 declare function ColorModeControl({ value, onChange, ariaLabel, size, variant, className, }: ColorModeControlProps): ReactElement;
 
+/** One stop in a {@link ThemeSwitcher}'s rotation. */
+interface ThemeSwitcherOption<T extends string = string> {
+    value: T;
+    /** Drawn in the button while this option is current. */
+    icon: ReactNode;
+    /** The option's name, read in the accessible name and tooltip. */
+    label: string;
+}
+/** The color modes, in rotation order, as {@link ThemeSwitcher} cycles them by default. */
+declare const COLOR_MODE_OPTIONS: readonly ThemeSwitcherOption<ColorModePreference>[];
+/** Props for {@link ThemeSwitcher}. */
+interface ThemeSwitcherProps<T extends string = ColorModePreference> {
+    value: T;
+    onChange: (next: T) => void;
+    /** The rotation, in order. Defaults to {@link COLOR_MODE_OPTIONS}. */
+    options?: readonly ThemeSwitcherOption<T>[];
+    /** What is being switched, leading the accessible name and tooltip
+     *  (`Theme: Auto — click for Light`). Defaults to `'Theme'`. */
+    ariaLabel?: string;
+    /** Defaults to `sm`, the size of a header's icon buttons. */
+    size?: ButtonSize;
+    /** Defaults to `ghost`. */
+    variant?: ButtonVariant;
+    className?: string;
+}
+/**
+ * One icon button that steps through a list of options: a click moves to the
+ * next, a shift-click to the previous, both wrapping. It shows the current
+ * option's icon, and its name and tooltip say what is current and what a
+ * click chooses. The compact alternative to `ColorModeControl`'s three
+ * segments. Controlled: pair the default color modes with
+ * `useColorModePreference` from `@weasel-js/theme/react`.
+ */
+declare function ThemeSwitcher<T extends string = ColorModePreference>({ value, onChange, options, ariaLabel, size, variant, className, }: ThemeSwitcherProps<T>): ReactElement;
+
 /**
  * One segment of an {@link OptionsBar}. Unlike `ToggleBar`, each item carries
  * its own selected state and its own `onChange`.
@@ -1547,7 +1631,25 @@ interface PowerlineProps {
  * Built for showing a path through a sequence of steps — the inspector uses
  * it to display how input routes from tool to gesture to action to target.
  */
-declare function Powerline({ segments, startCap, size, variant, depth, gap, className, ...rest }: PowerlineProps): react_jsx_runtime.JSX.Element;
+declare function Powerline({ segments, startCap, size, variant, depth, gap, className, ...rest }: PowerlineProps): react.JSX.Element;
+
+/**
+ * The segments {@link GestureRoute} draws for a route string: phase atoms, then
+ * `gesture(arg)`, then the held modifiers as one chord, then the target.
+ * A descriptor's default arg and a wildcard target stay visible, muted, so
+ * the strip shows the whole binding.
+ */
+declare function gestureRouteSegments(route: string): PowerlineSegment[];
+/** Props for {@link GestureRoute}. */
+interface GestureRouteProps extends Omit<PowerlineProps, 'segments'> {
+    /** A route in the dispatcher's grammar, e.g. `[initial] drag => node +shift`. */
+    route: string;
+}
+/**
+ * A dispatcher route drawn as a {@link Powerline}: phase, gesture, modifiers
+ * and target as one chevron-linked chain.
+ */
+declare function GestureRoute({ route, 'aria-label': ariaLabel, ...rest }: GestureRouteProps): react.JSX.Element;
 
 /** Distinguishes a leaf from a group while walking a schema tree. */
 declare function isPrefLeaf(node: ToolPrefLeaf | ToolPrefGroup): node is ToolPrefLeaf;
@@ -1608,7 +1710,7 @@ interface PrefsFormProps {
  * Storage-agnostic: pair with `PrefsDialog` for the modal composition, and
  * persist however the app likes via `onChange`.
  */
-declare function PrefsForm(props: PrefsFormProps): react_jsx_runtime.JSX.Element;
+declare function PrefsForm(props: PrefsFormProps): react.JSX.Element;
 
 /**
  * Props for {@link PrefsDialog} — everything {@link PrefsForm} takes, plus
@@ -1639,7 +1741,7 @@ interface PrefsDialogProps extends PrefsFormProps {
  * `layout="rail"` is what a dialog usually wants: the default columns wrap
  * sideways past two groups, and this box is 900px at its widest.
  */
-declare function PrefsDialog(props: PrefsDialogProps): react_jsx_runtime.JSX.Element;
+declare function PrefsDialog(props: PrefsDialogProps): react.JSX.Element;
 
 /** Props for {@link Sidebar}. */
 interface SidebarProps {
@@ -1670,7 +1772,7 @@ interface SidebarProps {
  *
  * Pair with `<SidebarPanel>` for collapsible sections.
  */
-declare function Sidebar(props: SidebarProps): react_jsx_runtime.JSX.Element;
+declare function Sidebar(props: SidebarProps): react.JSX.Element;
 
 /** Props for {@link SidebarPanel}. */
 interface SidebarPanelProps {
@@ -1689,7 +1791,7 @@ interface SidebarPanelProps {
      */
     onToggleCollapse?(): void;
     /**
-     * Optional close handler — when provided, the header gains a `×`
+     * Optional close handler — when provided, the header gains a close
      * button on the trailing edge. Caller flips its "hidden" state and
      * conditionally unmounts the panel from the parent.
      */
@@ -1705,7 +1807,7 @@ interface SidebarPanelProps {
  *
  * Pair with `<Sidebar>` for the docked column layout.
  */
-declare function SidebarPanel(props: SidebarPanelProps): react_jsx_runtime.JSX.Element;
+declare function SidebarPanel(props: SidebarPanelProps): react.JSX.Element;
 
 /** Props for {@link ToolButton}. */
 interface ToolButtonProps {
@@ -1749,7 +1851,7 @@ interface ToolButtonProps {
  * and similar surfaces. Headless about layout direction (parent group
  * supplies flex direction via `ToolGroup`). Theme via `--wzl-*` tokens.
  */
-declare function ToolButton(props: ToolButtonProps): react_jsx_runtime.JSX.Element;
+declare function ToolButton(props: ToolButtonProps): react.JSX.Element;
 
 /** Props for {@link ToolGroup}. */
 interface ToolGroupProps {
@@ -1774,7 +1876,7 @@ interface ToolGroupProps {
  * `<ToolButton>`s (or any children) along a chosen axis. No visual chrome
  * beyond layout; theming lives on the buttons.
  */
-declare function ToolGroup(props: ToolGroupProps): react_jsx_runtime.JSX.Element;
+declare function ToolGroup(props: ToolGroupProps): react.JSX.Element;
 
 /** The full vocabulary of capability tags shipped in the default preset.
  *  Apps and other consumers can add their own tags; this list is what
@@ -1801,6 +1903,10 @@ interface WorkspaceVisual {
  * independently undoable and `exit` is non-destructive. A `strict` mode
  * (free-transform, crop) is a transaction: the whole session collapses to one
  * undoable step and leaving requires an explicit `commit` or `cancel`.
+ *
+ * The four shortcut fields are key chords (`'Escape'`, `'Meta+T'`) that
+ * `modeShortcuts` in `@weasel-js/routing` turns into dispatcher bindings,
+ * each live only while the mode it acts on is (or, for `entry`, is not).
  */
 interface ModeDefinition {
     id: string;
@@ -1828,6 +1934,43 @@ interface ModeDefinition {
     cancel?: {
         shortcut?: string;
     };
+    /** Leave a soft mode and throw its session away, where `exit` keeps it to
+     *  resume. */
+    discard?: {
+        shortcut?: string;
+    };
+}
+
+/** One registrant of a key: its value and, when the registrant named one, where it came from. */
+interface Registrant<V> {
+    readonly value: V;
+    readonly source: string | undefined;
+}
+/** One key as a reflection reports it. */
+interface ReflectedEntry<V, K = string> extends Registrant<V> {
+    readonly key: K;
+    /** The registrants this one displaced, oldest first. Non-empty means two
+     *  registrants claimed one key — a conflict, resolved newest-wins. */
+    readonly shadowed: readonly Registrant<V>[];
+}
+/**
+ * The read-only face of a registry: what is registered, what displaced what,
+ * and a way to hear about changes. Every kit registry that embeds a
+ * {@link Reflectable} hands this out, so a debug overlay or a conflict check
+ * can walk any of them the same way.
+ *
+ * `subscribe` and `getVersion` are shaped for `useSyncExternalStore`; so is
+ * `entries`, which returns the same frozen array until the next change.
+ */
+interface Reflection<V, K = string> {
+    get(key: K): V | undefined;
+    has(key: K): boolean;
+    /** Every key's live registrant, in the order each key was first registered. */
+    entries(): readonly ReflectedEntry<V, K>[];
+    /** Called after every change. Returns the unsubscribe. */
+    subscribe(listener: () => void): () => void;
+    /** Advances on every change. */
+    getVersion(): number;
 }
 
 /** Holds the set of available modes and which one is active, and notifies
@@ -1836,10 +1979,15 @@ interface ModeDefinition {
  *  ignored. */
 interface ModeRegistry {
     current(): ModeDefinition;
+    /** Every registered mode, in registration order. */
+    list(): readonly ModeDefinition[];
     setMode(id: string): void;
     byId(id: string): ModeDefinition;
     getVersion(): number;
     subscribe(listener: () => void): () => void;
+    /** The registered modes keyed by id. Shares this registry's version, so it
+     *  also advances on `setMode`. */
+    readonly reflection: Reflection<ModeDefinition>;
 }
 
 /** Props for {@link ToolPalette}. */
@@ -1869,12 +2017,13 @@ interface ToolPaletteProps {
 /**
  * Toolbar of the registered tools, split into separator-divided groups by
  * each tool's presentation group and navigable by arrow keys. Clicking a
- * button makes that tool active.
+ * button makes that tool active. A tool whose presentation sets `hide` is
+ * left out.
  *
  * Given a `modeRegistry`, tools whose capabilities the current mode does not
  * allow render greyed out and inert rather than disappearing.
  */
-declare function ToolPalette(props: ToolPaletteProps): react_jsx_runtime.JSX.Element;
+declare function ToolPalette(props: ToolPaletteProps): react.JSX.Element;
 
 /**
  * Props for {@link Checkbox}, on top of React Aria's `Checkbox` props. The
@@ -1922,27 +2071,27 @@ type TabsProps = Omit<TabsProps$1, 'className' | 'children'> & {
  * Tab set wrapping React Aria's Tabs, skinned against the `--wzl-*` tokens.
  * Holds a {@link TabList} and one {@link TabPanel} per tab.
  */
-declare function Tabs({ children, className, ...rest }: TabsProps): react_jsx_runtime.JSX.Element;
+declare function Tabs({ children, className, ...rest }: TabsProps): react.JSX.Element;
 /** Props for {@link TabList}, on top of React Aria's `TabList` props. */
 type TabListProps<T extends object> = Omit<TabListProps$1<T>, 'className'> & {
     className?: string;
 };
 /** The row of tab buttons inside a {@link Tabs}. */
-declare function TabList<T extends object>({ className, ...rest }: TabListProps<T>): react_jsx_runtime.JSX.Element;
+declare function TabList<T extends object>({ className, ...rest }: TabListProps<T>): react.JSX.Element;
 /** Props for {@link Tab}, on top of React Aria's `Tab` props. */
 type TabProps = Omit<TabProps$1, 'className' | 'children'> & {
     children?: ReactNode;
     className?: string;
 };
 /** One tab button. Its `id` selects the {@link TabPanel} it reveals. */
-declare function Tab({ children, className, ...rest }: TabProps): react_jsx_runtime.JSX.Element;
+declare function Tab({ children, className, ...rest }: TabProps): react.JSX.Element;
 /** Props for {@link TabPanel}, on top of React Aria's `TabPanel` props. */
 type TabPanelProps = Omit<TabPanelProps$1, 'className' | 'children'> & {
     children?: ReactNode;
     className?: string;
 };
 /** The content shown for the {@link Tab} whose `id` matches this panel's. */
-declare function TabPanel({ children, className, ...rest }: TabPanelProps): react_jsx_runtime.JSX.Element;
+declare function TabPanel({ children, className, ...rest }: TabPanelProps): react.JSX.Element;
 
 /** Props for {@link RadioGroup}, on top of React Aria's `RadioGroup` props. */
 type RadioGroupProps = Omit<RadioGroupProps$1, 'children' | 'className'> & {
@@ -1957,14 +2106,14 @@ type RadioGroupProps = Omit<RadioGroupProps$1, 'children' | 'className'> & {
  * supplying the same label / description / errorMessage slots as `Input`.
  * Holds {@link Radio} children.
  */
-declare function RadioGroup(props: RadioGroupProps): react_jsx_runtime.JSX.Element;
+declare function RadioGroup(props: RadioGroupProps): react.JSX.Element;
 /** Props for {@link Radio}, on top of React Aria's `Radio` props. */
 type RadioProps = Omit<RadioProps$1, 'className' | 'children'> & {
     children?: ReactNode;
     className?: string;
 };
 /** One choice in a {@link RadioGroup}. The label is passed as children. */
-declare function Radio({ children, className, ...rest }: RadioProps): react_jsx_runtime.JSX.Element;
+declare function Radio({ children, className, ...rest }: RadioProps): react.JSX.Element;
 
 /** Props for {@link NumberField}, on top of React Aria's `NumberField` props. */
 type NumberFieldProps = Omit<NumberFieldProps$1, 'children' | 'className'> & {
@@ -2056,7 +2205,7 @@ type MenuButtonProps<T extends string = string> = {
  * `shortcut` adds a kit tooltip reading `Name (⌘N)`, named by `aria-label` or
  * a string `label`, as `Button` does; `tooltip` replaces that text.
  */
-declare function MenuButton<T extends string = string>({ label, items, onAction, isDisabled, className, 'aria-label': ariaLabel, portalContainer, shortcut, tooltip, }: MenuButtonProps<T>): react_jsx_runtime.JSX.Element;
+declare function MenuButton<T extends string = string>({ label, items, onAction, isDisabled, className, 'aria-label': ariaLabel, portalContainer, shortcut, tooltip, }: MenuButtonProps<T>): react.JSX.Element;
 
 /**
  * One option in a {@link ComboBox}'s `options` list. `textValue` is the
@@ -2136,13 +2285,13 @@ type ComboBoxProps<T extends Key$1 = string> = Omit<ComboBoxProps$1<object>, 'ch
  * type to filter; selection commits to `onSelectionChange`. When no value
  * is in the input, selection clears (key becomes null).
  */
-declare function ComboBox<T extends Key$1 = string>(props: ComboBoxProps<T>): react_jsx_runtime.JSX.Element;
+declare function ComboBox<T extends Key$1 = string>(props: ComboBoxProps<T>): react.JSX.Element;
 /** Props for {@link ComboBoxItem}, on top of React Aria's `ListBoxItem` props. */
 type ComboBoxItemProps = Omit<ListBoxItemProps, 'className'> & {
     className?: string;
 };
 /** One row in a {@link ComboBox}'s filtered list. */
-declare function ComboBoxItem({ className, ...rest }: ComboBoxItemProps): react_jsx_runtime.JSX.Element;
+declare function ComboBoxItem({ className, ...rest }: ComboBoxItemProps): react.JSX.Element;
 
 /** Props for {@link RangeSlider}, on top of React Aria's `Slider` props. */
 type RangeSliderProps = Omit<SliderProps$1, 'children' | 'className'> & {
@@ -2164,7 +2313,7 @@ type RangeSliderProps = Omit<SliderProps$1, 'children' | 'className'> & {
  * *horizontal* axis here and collapses the track to its content width. Style
  * the wrapper around one, not the root.
  */
-declare function RangeSlider(props: RangeSliderProps): react_jsx_runtime.JSX.Element;
+declare function RangeSlider(props: RangeSliderProps): react.JSX.Element;
 
 /** Props for {@link Dialog}, on top of React Aria's `ModalOverlay` props. */
 type DialogProps = Omit<WithoutPortalTarget<ModalOverlayProps>, 'children' | 'className'> & OverlayPortalProps & StanceProps & {
@@ -2197,7 +2346,7 @@ type DialogProps = Omit<WithoutPortalTarget<ModalOverlayProps>, 'children' | 'cl
  * underlying primitives. `stance` and `tone` work as on `<PropertyPanel>` —
  * a destructive confirm is `stance="danger"`.
  */
-declare function Dialog(props: DialogProps): react_jsx_runtime.JSX.Element;
+declare function Dialog(props: DialogProps): react.JSX.Element;
 
 /** Props for {@link Callout}, on top of React Aria's `Popover` props. */
 type CalloutProps = Omit<WithoutPortalTarget<PopoverProps>, 'children' | 'className' | 'isNonModal' | 'triggerRef'> & OverlayPortalProps & StanceProps & {
@@ -2214,14 +2363,14 @@ type CalloutProps = Omit<WithoutPortalTarget<PopoverProps>, 'children' | 'classN
      */
     modal?: boolean;
     /**
-     * Show the × button. Defaults to `!modal`. In programmatic
+     * Show the close button. Defaults to `!modal`. In programmatic
      * `triggerRef`/`anchorRect` modes the close button needs controlled open
      * (`isOpen` + `onOpenChange`); with only `defaultOpen` it has no open-state
      * setter to call and cannot close.
      */
     showCloseButton?: boolean;
     /**
-     * The user asked for this callout to go away — the × button or Escape.
+     * The user asked for this callout to go away — the close button or Escape.
      *
      * Distinct from `onOpenChange`, which a non-modal popover *also* fires when
      * interaction or focus merely leaves it. On a canvas that's every click on
@@ -2251,7 +2400,7 @@ type CalloutProps = Omit<WithoutPortalTarget<PopoverProps>, 'children' | 'classN
  * Wraps React Aria Popover + Dialog; positioning, collision flipping,
  * dismissal, and focus behavior come from the underlying primitives.
  */
-declare function Callout(props: CalloutProps): react_jsx_runtime.JSX.Element;
+declare function Callout(props: CalloutProps): react.JSX.Element;
 
 /**
  * Coordinate transforms (model ↔ plot) for Plot2D. Pure / deterministic —
@@ -2260,7 +2409,7 @@ declare function Callout(props: CalloutProps): react_jsx_runtime.JSX.Element;
  * Model space: caller-defined xRange × yRange. Y axis goes UP.
  * Plot space: 0..width × 0..height in CSS pixels. Y axis goes DOWN (SVG).
  */
-interface Point {
+interface Point$1 {
     x: number;
     y: number;
 }
@@ -2321,8 +2470,8 @@ interface TickSettings {
 }
 /** A pointer position given in both of the plot's coordinate systems. */
 interface Plot2DCoords {
-    plot: Point;
-    model: Point;
+    plot: Point$1;
+    model: Point$1;
 }
 /** Props for {@link Plot2D}. */
 interface Plot2DProps {
@@ -2363,19 +2512,19 @@ interface Plot2DProps {
  */
 interface Plot2DHandle {
     readonly svg: SVGSVGElement | null;
-    plotToModel(pt: Point): Point;
-    modelToPlot(pt: Point): Point;
+    plotToModel(pt: Point$1): Point$1;
+    modelToPlot(pt: Point$1): Point$1;
     /** Convert a DOM event's clientX/clientY (e.g. from a window-attached
      *  pointermove during drag) to plot-space. */
     clientToPlot(e: {
         clientX: number;
         clientY: number;
-    }): Point;
+    }): Point$1;
     /** Convenience: clientToPlot → plotToModel. */
     clientToModel(e: {
         clientX: number;
         clientY: number;
-    }): Point;
+    }): Point$1;
     readonly width: number;
     readonly height: number;
 }
@@ -2386,6 +2535,22 @@ interface Plot2DHandle {
  */
 declare const Plot2D: react.ForwardRefExoticComponent<Plot2DProps & react.RefAttributes<Plot2DHandle>>;
 
+/**
+ * Catmull-Rom spline sampling, parameterized by α.
+ *
+ * α = 0   → uniform parameterization (original Catmull-Rom). Fast, can
+ *           produce cusps and self-intersections at sharp 2D angles.
+ * α = 0.5 → centripetal (Yuksel/Schneider 2011). No cusps, no
+ *           self-intersection. The "safe default" for 2D.
+ * α = 1   → chordal. Smoother than uniform, different artifacts.
+ *
+ * `sampleCurve(...)` is the convenience alias for centripetal (α=0.5).
+ */
+interface Point {
+    x: number;
+    y: number;
+}
+
 /**
  * Interpolation mode dispatcher for CurveEditor. The vocabulary of
  * supported algorithms and the unified `sample(...)` entry point that
@@ -2398,6 +2563,8 @@ declare const Plot2D: react.ForwardRefExoticComponent<Plot2DProps & react.RefAtt
  *  every anchor); the differences are in tangent computation and
  *  parameterization. */
 type InterpolationMode = 'linear' | 'catmull-rom' | 'catmull-rom-uniform' | 'catmull-rom-chordal' | 'monotone';
+/** Sample `anchors` using the chosen interpolation mode. */
+declare function sampleByInterpolation(anchors: readonly Point[], samplesPerSegment: number, mode: InterpolationMode): Point[];
 
 /**
  * Built-in function/curve layer for LayeredCurveEditor. Bundles the
@@ -2498,7 +2665,7 @@ interface CurveEditorProps {
  * a `LayeredCurveEditor`. Reach for those directly to stack several curves
  * on one plot.
  */
-declare function CurveEditor(props: CurveEditorProps): react_jsx_runtime.JSX.Element;
+declare function CurveEditor(props: CurveEditorProps): react.JSX.Element;
 
 /** Props for {@link PointPlotter}. */
 interface PointPlotterProps {
@@ -2549,13 +2716,16 @@ interface PointPlotterProps {
  * `'click-empty'` (CurveEditor defaults to `'click-curve'`, which
  * doesn't make sense without a curve to hit-test against).
  */
-declare function PointPlotter(props: PointPlotterProps): react_jsx_runtime.JSX.Element;
+declare function PointPlotter(props: PointPlotterProps): react.JSX.Element;
 
 /**
  * Options for {@link paintGradientTrack}.
  *
- * `gradient` maps a normalized position along the track (0 to 1) to a CSS
- * color; `samples` is how many stops the resulting linear-gradient uses.
+ * `gradient` maps a normalized position along the slider's value span (0 to
+ * 1) to a CSS color; `samples` is how many stops the resulting
+ * linear-gradient uses. The ramp is laid on the same span as the thumbs, so a
+ * thumb at 0.3 sits over `gradient(0.3)`; any track beyond the span takes the
+ * end colors.
  * `activeRange`, given in the slider's own value units, keeps that span at
  * full strength and dims + hatches the rest.
  */
@@ -2697,5 +2867,5 @@ type RovingTabIndex<T extends HTMLElement = HTMLDivElement> = {
  */
 declare function useRovingTabIndex<T extends HTMLElement = HTMLDivElement>(options: UseRovingTabIndexOptions): RovingTabIndex<T>;
 
-export { ActionBar, Badge, ButtonBar, Callout, Checkbox, ColorModeControl, ComboBox, ComboBoxItem, CurveEditor, DataGrid, Dialog, Disclosure, DisclosureMark, DisclosureRow, DragGhost, DragHandleGlyph, EDGE_PROFILES, FieldOrientation, KeyCap, KeySequence, ListEditor, MenuButton, NumberField, OptionsBar, Plot2D, PointPlotter, Powerline, PrefRenderer, PrefsDialog, PrefsForm, Radio, RadioGroup, RangeSlider, Sidebar, SidebarPanel, Slider, Switch, Tab, TabList, TabPanel, Tabs, ToggleBarSize, ToggleBarVariant, ToolButton, ToolGroup, ToolPalette, chromaAt, detectPlatform, dlog, formatShortcut, formatShortcutParts, inferKeycapKind, isDebugEnabled, isPrefLeaf, keyGlyph, keySpecFromKey, keySpecsFromMods, keySpecsFromShortcut, oklchToHex, paintGradientTrack, prefValueAtPath, useAsyncOptions, useReorderDragList, useRovingTabIndex, visiblePrefSubtree };
-export type { ActionBarProps, AddPointMode, AnchorRenderProps, AsyncOption, AsyncOptionsResult, AxesSettings, BadgeProps, BadgeShape, BadgeSize, BadgeStatus, BadgeVariant, BoundsCtx, BuiltInEdgeName, ButtonBarItem, ButtonBarProps, ButtonBarSize, ButtonBarVariant, CalloutProps, CheckboxProps, ChromaCurve, ChromaCurvePoint, ColorModeControlProps, ComboBoxCommit, ComboBoxFilter, ComboBoxItemProps, ComboBoxOption, ComboBoxProps, ControlPoint, CurveDomain, CurveEditorProps, DataGridColumn, DataGridProps, DialogProps, DisclosureMarkProps, DisclosureProps, DisclosureRowProps, DragGhostProps, DragHandleGlyphProps, EdgeCap, EdgeProfile, EndpointMode, FillSettings, GradientTrackOpts, GridSettings, InterpolationMode, KeyCapProps, KeyCapVariant, KeySequenceProps, KeySpec, KeycapKind, ListEditorProps, LogicalMod, LogicalModSpec, MenuButtonItem, MenuButtonProps, NumberFieldProps, OptionsBarItem, OptionsBarProps, OptionsBarSize, OptionsBarVariant, Platform, Plot2DCoords, Plot2DHandle, Plot2DProps, PointPlotterProps, PowerlineProps, PowerlineSegment, PrefsDialogProps, PrefsFormProps, PrefsLayout, RadioGroupProps, RadioProps, RangeSliderProps, ReorderDragHandlers, ReorderDragState, ReorderGhost, RovingItem, RovingTabIndex, SidebarPanelProps, SidebarProps, SliderProps, SwitchProps, TabListProps, TabPanelProps, TabProps, TabsProps, Thumb, ThumbRenderCtx, ThumbShape, ToolButtonProps, ToolGroupProps, ToolPaletteProps, TrackCtx, UseAsyncOptionsProps, UseReorderDragListOptions, UseRovingTabIndexOptions };
+export { ActionBar, Badge, ButtonBar, ButtonSize, ButtonVariant, COLOR_MODE_OPTIONS, Callout, Checkbox, CloseButton, ColorModeControl, ComboBox, ComboBoxItem, CurveEditor, DataGrid, Dialog, Disclosure, DisclosureMark, DisclosureRow, DragGhost, DragGrip, EDGE_PROFILES, FieldOrientation, GestureRoute, KeyCap, KeySequence, ListEditor, MenuButton, NumberField, OptionsBar, OverlayPortalProps, Plot2D, PointPlotter, Powerline, PrefRenderer, PrefsDialog, PrefsForm, Radio, RadioGroup, RangeSlider, SegmentTooltipFields, Sidebar, SidebarPanel, Slider, StanceProps, Switch, Tab, TabList, TabPanel, Tabs, ThemeSwitcher, ToggleBarSize, ToggleBarVariant, ToolButton, ToolGroup, ToolPalette, WithoutPortalTarget, chromaAt, detectPlatform, dlog, formatShortcut, formatShortcutParts, gestureRouteSegments, inferKeycapKind, isDebugEnabled, isPrefLeaf, keyGlyph, keySpecFromKey, keySpecsFromMods, keySpecsFromShortcut, oklchToHex, paintGradientTrack, prefValueAtPath, sampleByInterpolation, useAsyncOptions, useReorderDragList, useRovingTabIndex, visiblePrefSubtree };
+export type { ActionBarProps, AddPointMode, AnchorRenderProps, AsyncOption, AsyncOptionsResult, AxesSettings, BadgeProps, BadgeShape, BadgeSize, BadgeStatus, BadgeVariant, BoundsCtx, BuiltInEdgeName, BuiltInProfileName, ButtonBarItem, ButtonBarProps, ButtonBarSize, ButtonBarVariant, CalloutProps, CheckboxProps, ChromaCurve, ChromaCurvePoint, CloseButtonProps, ColorModeControlProps, ComboBoxCommit, ComboBoxFilter, ComboBoxItemProps, ComboBoxOption, ComboBoxProps, ControlPoint, CurveDomain, CurveEditorProps, DataGridColumn, DataGridProps, DialogProps, DisclosureMarkProps, DisclosureProps, DisclosureRowProps, DragGhostProps, DragGripProps, EdgeCap, EdgeProfile, EndpointMode, FillSettings, GestureRouteProps, GradientTrackOpts, GridSettings, InterpolationMode, KeyCapProps, KeyCapVariant, KeySequenceJoins, KeySequenceProps, KeySpec, KeycapKind, ListEditorProps, LogicalMod, LogicalModSpec, MenuButtonItem, MenuButtonProps, NumberFieldProps, OptionsBarItem, OptionsBarProps, OptionsBarSize, OptionsBarVariant, Platform, Plot2DCoords, Plot2DHandle, Plot2DProps, PointPlotterProps, PowerlineProps, PowerlineSegment, PrefsDialogProps, PrefsFormProps, PrefsLayout, RadioGroupProps, RadioProps, RangeSliderProps, ReorderDragHandlers, ReorderDragState, ReorderGhost, RovingItem, RovingTabIndex, SidebarPanelProps, SidebarProps, SliderProps, SwitchProps, TabListProps, TabPanelProps, TabProps, TabsProps, ThemeSwitcherOption, ThemeSwitcherProps, Thumb, ThumbRenderCtx, ThumbShape, ToolButtonProps, ToolGroupProps, ToolPaletteProps, TrackCtx, UseAsyncOptionsProps, UseReorderDragListOptions, UseRovingTabIndexOptions };