@weasel-js/labkit 1.6.1 → 1.7.0

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

@@ -1,14 +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-Cr8-zoup.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-Cr8-zoup.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';
+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-BoELAMsM.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, q as PropertyAlign, r as PropertyDensity, P as PropertyMetricProps, s as formatNumber } from '../_dts/PropertyField.d-D0ndfIIt.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';
 
@@ -466,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). */
@@ -810,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.
@@ -892,7 +919,7 @@ 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.Element;
@@ -968,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;
 }
@@ -978,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.Element;
+declare function DragGrip({ size }: DragGripProps): react.JSX.Element;
 
 /**
  * Width class of a keycap: a modifier glyph, a multi-character legend that
@@ -1031,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;
@@ -1051,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.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
@@ -1215,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 = {
@@ -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
@@ -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`.
@@ -1549,6 +1633,24 @@ interface PowerlineProps {
  */
 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;
 /** Get the value at a dotted path inside a nested value tree. Returns
@@ -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.
      */
@@ -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,7 +2017,8 @@ 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.
@@ -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
@@ -2260,7 +2409,7 @@ declare function Callout(props: CalloutProps): react.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
@@ -2554,8 +2721,11 @@ 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, OverlayPortalProps, Plot2D, PointPlotter, Powerline, PrefRenderer, PrefsDialog, PrefsForm, Radio, RadioGroup, RangeSlider, SegmentTooltipFields, Sidebar, SidebarPanel, Slider, StanceProps, Switch, Tab, TabList, TabPanel, Tabs, ToggleBarSize, ToggleBarVariant, ToolButton, ToolGroup, ToolPalette, WithoutPortalTarget, 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 };

package/dist/passthrough/weasel-ui.js

@@ -1,5 +1,5 @@
-import '../chunk-SBXNQW4G.js';
-export { v as ActionBar, Ht as Badge, c as Button, a7 as ButtonBar, g2 as Callout, u6 as CalloutTrigger, o3 as Checkbox, s3 as ColorModeControl, y2 as ComboBox, S3 as ComboBoxItem, L as CurveEditor, f as DataGrid, u3 as Dialog, i2 as Disclosure, r as DisclosureMark, a2 as DisclosureRow, a3 as DragGhost, n4 as DragHandleGlyph, Qe as EDGE_PROFILES, n5 as Field, n as ICON_PATHS, l as Icon, u4 as Input, f2 as KeyCap, p as KeySequence, D as LayerList, s2 as ListEditor, e2 as MINUS_SIGN, d2 as MenuButton, g as NumberField, r3 as OptionsBar, w as Plot2D, n9 as PointPlotter, r4 as Powerline, F2 as PrefsDialog, A2 as PrefsForm, u5 as Radio, l5 as RadioGroup, l8 as RangeSlider, T as Select, L2 as SelectItem, n6 as Sidebar, s5 as SidebarPanel, y as Slider, a6 as Switch, c5 as Tab, s6 as TabList, l7 as TabPanel, o5 as Tabs, a5 as ToggleBar, o4 as ToolButton, n8 as ToolGroup, h2 as ToolPalette, Z2 as chromaAt, o2 as detectPlatform, a as dlog, r2 as fieldClasses, t2 as formatNumber, n2 as formatShortcut, t as formatShortcutParts, d as inferKeycapKind, i as isDebugEnabled, s4 as isPrefLeaf, e as keyGlyph, l3 as keySpecFromKey, s as keySpecsFromMods, m as keySpecsFromShortcut, S2 as moveLayers, X2 as oklchToHex, v2 as paintGradientTrack, c2 as prefValueAtPath, Li as useAsyncOptions, u2 as useReorderDragList, a4 as useRovingTabIndex, l6 as visiblePrefSubtree } from '../chunk-TYN6MLXX.js';
-import '../chunk-QGMOA2YE.js';
+import '../chunk-CZZPXUOU.js';
+export { v as ActionBar, Xt as Badge, c as Button, a10 as ButtonBar, a9 as COLOR_MODE_OPTIONS, _2 as Callout, d4 as CalloutTrigger, o5 as Checkbox, a2 as CloseButton, s2 as ColorModeControl, y2 as ComboBox, S2 as ComboBoxItem, L as CurveEditor, f as DataGrid, d2 as Dialog, i2 as Disclosure, r as DisclosureMark, a3 as DisclosureRow, a5 as DragGhost, n4 as DragGrip, Ze as EDGE_PROFILES, n5 as Field, p3 as GestureRoute, n as ICON_PATHS, l as Icon, u3 as Input, f2 as KeyCap, p as KeySequence, E3 as LayerList, c2 as ListEditor, MINUS_SIGN, d3 as MenuButton, y as NumberField, r3 as OptionsBar, w as Plot2D, n9 as PointPlotter, r4 as Powerline, I2 as PrefsDialog, j as PrefsForm, u4 as Radio, l4 as RadioGroup, l7 as RangeSlider, E2 as Select, L2 as SelectItem, n6 as Sidebar, a11 as SidebarPanel, S as Slider, a8 as Switch, c6 as Tab, s4 as TabList, l6 as TabPanel, o6 as Tabs, o3 as ThemeSwitcher, a7 as ToggleBar, o4 as ToolButton, n8 as ToolGroup, h2 as ToolPalette, Z2 as chromaAt, o2 as detectPlatform, a as dlog, r2 as fieldClasses, formatNumber, n2 as formatShortcut, t as formatShortcutParts, f4 as gestureRouteSegments, d as inferKeycapKind, i as isDebugEnabled, s3 as isPrefLeaf, e as keyGlyph, l3 as keySpecFromKey, s as keySpecsFromMods, m as keySpecsFromShortcut, x3 as moveLayers, X2 as oklchToHex, C2 as paintGradientTrack, c3 as prefValueAtPath, x as sampleByInterpolation, wi as useAsyncOptions, u2 as useReorderDragList, a6 as useRovingTabIndex, l5 as visiblePrefSubtree } from '../chunk-MIM5R4ZT.js';
+import '../chunk-275JRRVD.js';
 //# sourceMappingURL=weasel-ui.js.map
 //# sourceMappingURL=weasel-ui.js.map