@agent-native/toolkit 0.0.0-beta-20260819143124

package/dist/design-system/types.d.ts

@@ -0,0 +1,292 @@
+import type { ComponentType, CSSProperties, KeyboardEvent as ReactKeyboardEvent, MouseEvent as ReactMouseEvent, ReactElement, ReactNode, Ref, RefObject } from "react";
+export declare const DESIGN_SYSTEM_CONTRACT_VERSION: 1;
+export type DesignSystemIntent = "primary" | "neutral" | "danger";
+export type DesignSystemEmphasis = "solid" | "outline" | "ghost";
+export type DesignSystemSize = "compact" | "default" | "large";
+export type DesignSystemTone = "neutral" | "info" | "success" | "warning" | "danger";
+export type DesignSystemPlacement = "top" | "right" | "bottom" | "left";
+export type DesignSystemAlign = "start" | "center" | "end";
+export type DesignSystemKey = string | number;
+export type DesignSystemPressEvent = ReactMouseEvent<HTMLElement> | ReactKeyboardEvent<HTMLElement>;
+/**
+ * Styling hooks are optional interoperability affordances. Adapters must not
+ * rely on either hook being present, and Toolkit views must not pass
+ * framework-specific utility classes through this contract.
+ */
+export interface DesignSystemStyleProps {
+    className?: string;
+    style?: CSSProperties;
+}
+export interface DesignSystemAccessibleProps {
+    id?: string;
+    title?: string;
+    "aria-label"?: string;
+    "aria-labelledby"?: string;
+    "aria-describedby"?: string;
+    "aria-controls"?: string;
+    "aria-expanded"?: boolean;
+    "aria-haspopup"?: boolean | "dialog" | "grid" | "listbox" | "menu" | "tree";
+    "aria-pressed"?: boolean | "mixed";
+}
+export interface DesignSystemOverlayProps extends DesignSystemStyleProps {
+    portalContainer?: Element | null;
+    placement?: DesignSystemPlacement;
+    align?: DesignSystemAlign;
+    collisionPadding?: number;
+}
+export interface ActionButtonProps extends DesignSystemStyleProps, DesignSystemAccessibleProps {
+    children?: ReactNode;
+    intent?: DesignSystemIntent;
+    emphasis?: DesignSystemEmphasis;
+    size?: DesignSystemSize;
+    pending?: boolean;
+    disabled?: boolean;
+    type?: "button" | "submit" | "reset";
+    leadingIcon?: ReactNode;
+    trailingIcon?: ReactNode;
+    onPress?: (event?: DesignSystemPressEvent) => void;
+    /** Native click interoperability for Radix `asChild` composition. */
+    onClick?: (event: ReactMouseEvent<HTMLButtonElement>) => void;
+    elementRef?: Ref<HTMLButtonElement>;
+}
+export interface IconButtonProps extends DesignSystemStyleProps, DesignSystemAccessibleProps {
+    label: string;
+    icon: ReactNode;
+    intent?: DesignSystemIntent;
+    emphasis?: DesignSystemEmphasis;
+    size?: DesignSystemSize;
+    pending?: boolean;
+    disabled?: boolean;
+    type?: "button" | "submit" | "reset";
+    onPress?: (event?: DesignSystemPressEvent) => void;
+    /** Native click interoperability for Radix `asChild` composition. */
+    onClick?: (event: ReactMouseEvent<HTMLButtonElement>) => void;
+    elementRef?: Ref<HTMLButtonElement>;
+}
+export type DesignSystemTextInputType = "text" | "email" | "password" | "search" | "tel" | "url";
+export interface TextFieldProps extends DesignSystemStyleProps, DesignSystemAccessibleProps {
+    value: string;
+    onChange: (value: string) => void;
+    label?: ReactNode;
+    description?: ReactNode;
+    errorMessage?: ReactNode;
+    placeholder?: string;
+    /** Optional native datalist id for editable fields with suggestions. */
+    list?: string;
+    name?: string;
+    type?: DesignSystemTextInputType;
+    inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search";
+    autoComplete?: string;
+    autoFocus?: boolean;
+    required?: boolean;
+    readOnly?: boolean;
+    disabled?: boolean;
+    invalid?: boolean;
+    leadingContent?: ReactNode;
+    trailingContent?: ReactNode;
+    onBlur?: () => void;
+    onFocus?: () => void;
+    onKeyDown?: (event: ReactKeyboardEvent<HTMLElement>) => void;
+    inputRef?: Ref<HTMLInputElement>;
+}
+export interface TextAreaProps extends DesignSystemStyleProps, DesignSystemAccessibleProps {
+    value: string;
+    onChange: (value: string) => void;
+    label?: ReactNode;
+    description?: ReactNode;
+    errorMessage?: ReactNode;
+    placeholder?: string;
+    name?: string;
+    rows?: number;
+    maxLength?: number;
+    autoFocus?: boolean;
+    required?: boolean;
+    readOnly?: boolean;
+    disabled?: boolean;
+    invalid?: boolean;
+    onBlur?: () => void;
+    onFocus?: () => void;
+    onKeyDown?: (event: ReactKeyboardEvent<HTMLElement>) => void;
+    textAreaRef?: Ref<HTMLTextAreaElement>;
+}
+export interface SpinnerProps extends DesignSystemStyleProps, DesignSystemAccessibleProps {
+    label?: string;
+    size?: DesignSystemSize;
+}
+export interface SkeletonProps extends DesignSystemStyleProps, DesignSystemAccessibleProps {
+    width?: string | number;
+    height?: string | number;
+    shape?: "line" | "rectangle" | "circle";
+}
+export interface StatusProps extends DesignSystemStyleProps, DesignSystemAccessibleProps {
+    children: ReactNode;
+    tone?: DesignSystemTone;
+    icon?: ReactNode;
+    size?: DesignSystemSize;
+}
+export interface SurfaceProps extends DesignSystemStyleProps, DesignSystemAccessibleProps {
+    children: ReactNode;
+    as?: "div" | "section" | "article" | "aside";
+    elevation?: "none" | "low" | "medium";
+    padding?: "none" | "compact" | "default" | "spacious";
+    interactive?: boolean;
+    onPress?: (event?: DesignSystemPressEvent) => void;
+}
+export interface AvatarProps extends DesignSystemStyleProps, DesignSystemAccessibleProps {
+    name: string;
+    src?: string | null;
+    fallback?: ReactNode;
+    size?: DesignSystemSize;
+    status?: "online" | "offline" | "busy" | "away";
+    imageRef?: Ref<HTMLImageElement>;
+}
+export interface TooltipProps extends DesignSystemOverlayProps {
+    trigger: ReactElement;
+    content: ReactNode;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    delayMs?: number;
+    disabled?: boolean;
+}
+export interface MenuItem {
+    id: DesignSystemKey;
+    label: ReactNode;
+    description?: ReactNode;
+    icon?: ReactNode;
+    shortcut?: ReactNode;
+    disabled?: boolean;
+    intent?: Extract<DesignSystemIntent, "neutral" | "danger">;
+    selected?: boolean;
+    children?: readonly MenuItem[];
+}
+export interface MenuSection {
+    id: DesignSystemKey;
+    label?: ReactNode;
+    items: readonly MenuItem[];
+}
+export interface MenuProps extends DesignSystemOverlayProps {
+    trigger: ReactElement;
+    items?: readonly MenuItem[];
+    sections?: readonly MenuSection[];
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    onAction: (id: DesignSystemKey) => void;
+    closeOnAction?: boolean;
+}
+export interface PopoverProps extends DesignSystemOverlayProps {
+    trigger: ReactElement;
+    children: ReactNode;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    modal?: boolean;
+    dismissible?: boolean;
+    initialFocusRef?: RefObject<HTMLElement | null>;
+    restoreFocusRef?: RefObject<HTMLElement | null>;
+}
+export interface DialogProps extends DesignSystemOverlayProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    title: ReactNode;
+    children: ReactNode;
+    description?: ReactNode;
+    footer?: ReactNode;
+    trigger?: ReactElement;
+    size?: "small" | "medium" | "large" | "fullscreen";
+    dismissible?: boolean;
+    closeLabel?: string;
+    initialFocusRef?: RefObject<HTMLElement | null>;
+    restoreFocusRef?: RefObject<HTMLElement | null>;
+}
+export interface PickerOption<Value extends DesignSystemKey = string> {
+    value: Value;
+    label: ReactNode;
+    textValue?: string;
+    description?: ReactNode;
+    icon?: ReactNode;
+    disabled?: boolean;
+    keywords?: readonly string[];
+}
+export interface PickerProps<Value extends DesignSystemKey = string> extends DesignSystemOverlayProps, DesignSystemAccessibleProps {
+    mode: "select" | "combobox";
+    options: readonly PickerOption<Value>[];
+    value: Value | null;
+    onChange: (value: Value | null) => void;
+    label?: ReactNode;
+    description?: ReactNode;
+    errorMessage?: ReactNode;
+    placeholder?: string;
+    searchValue?: string;
+    onSearchChange?: (value: string) => void;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    emptyContent?: ReactNode;
+    loadingContent?: ReactNode;
+    loading?: boolean;
+    required?: boolean;
+    disabled?: boolean;
+    invalid?: boolean;
+    pickerRef?: Ref<HTMLElement>;
+}
+export interface CheckboxProps extends DesignSystemStyleProps, DesignSystemAccessibleProps {
+    checked: boolean;
+    onChange: (checked: boolean) => void;
+    label?: ReactNode;
+    description?: ReactNode;
+    indeterminate?: boolean;
+    required?: boolean;
+    disabled?: boolean;
+    invalid?: boolean;
+    inputRef?: Ref<HTMLButtonElement>;
+}
+export interface SwitchProps extends DesignSystemStyleProps, DesignSystemAccessibleProps {
+    checked: boolean;
+    onChange: (checked: boolean) => void;
+    label?: ReactNode;
+    description?: ReactNode;
+    disabled?: boolean;
+    inputRef?: Ref<HTMLButtonElement>;
+}
+export interface TabItem<Value extends DesignSystemKey = string> {
+    value: Value;
+    label: ReactNode;
+    content: ReactNode;
+    disabled?: boolean;
+    icon?: ReactNode;
+}
+export interface TabsProps<Value extends DesignSystemKey = string> extends DesignSystemStyleProps, DesignSystemAccessibleProps {
+    items: readonly TabItem<Value>[];
+    value: Value;
+    onChange: (value: Value) => void;
+    orientation?: "horizontal" | "vertical";
+    activationMode?: "automatic" | "manual";
+}
+export interface PickerComponent {
+    <Value extends DesignSystemKey = string>(props: PickerProps<Value>): ReactNode;
+}
+export interface TabsComponent {
+    <Value extends DesignSystemKey = string>(props: TabsProps<Value>): ReactNode;
+}
+export interface DesignSystemComponents {
+    ActionButton: ComponentType<ActionButtonProps>;
+    IconButton: ComponentType<IconButtonProps>;
+    TextField: ComponentType<TextFieldProps>;
+    TextArea: ComponentType<TextAreaProps>;
+    Spinner: ComponentType<SpinnerProps>;
+    Skeleton: ComponentType<SkeletonProps>;
+    Status: ComponentType<StatusProps>;
+    Surface: ComponentType<SurfaceProps>;
+    Avatar: ComponentType<AvatarProps>;
+    Tooltip: ComponentType<TooltipProps>;
+    Menu: ComponentType<MenuProps>;
+    Popover: ComponentType<PopoverProps>;
+    Dialog: ComponentType<DialogProps>;
+    Picker: PickerComponent;
+    Checkbox: ComponentType<CheckboxProps>;
+    Switch: ComponentType<SwitchProps>;
+    Tabs: TabsComponent;
+}
+export type DesignSystemComponentName = keyof DesignSystemComponents;
+//# sourceMappingURL=types.d.ts.map

package/dist/design-system/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/design-system/types.ts"],"names":[],"mappings":"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"}

package/dist/design-system/types.js

@@ -0,0 +1,2 @@
+export const DESIGN_SYSTEM_CONTRACT_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/design-system/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/design-system/types.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAU,CAAC"}

package/dist/design-tweaks/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./visual-style-controls.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/design-tweaks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/design-tweaks/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC"}

package/dist/design-tweaks/index.js

@@ -0,0 +1,2 @@
+export * from "./visual-style-controls.js";
+//# sourceMappingURL=index.js.map

package/dist/design-tweaks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/design-tweaks/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC"}

package/dist/design-tweaks/scrub-input-utils.d.ts

@@ -0,0 +1,61 @@
+export interface ScrubExpressionOptions {
+    unit?: string;
+    min?: number;
+    max?: number;
+    precision?: number;
+}
+/** Cumulative pointer movement (px) required before a drag start is treated
+ * as a real scrub rather than jitter during a plain click. Mirrors
+ * ScrubInput's DRAG_THRESHOLD_PX. */
+export declare const SCRUB_DRAG_THRESHOLD_PX = 3;
+export interface ScrubDragState {
+    startX: number;
+    prevX: number;
+    hasDragged: boolean;
+}
+/** Begins tracking a new scrub gesture at the given starting pointer X. */
+export declare function startScrubDrag(startX: number): ScrubDragState;
+export interface ScrubDragTick {
+    /** The updated drag state after this pointermove sample. */
+    state: ScrubDragState;
+    /** The incremental delta (px) to apply this tick, or null when the move
+     * should be ignored (no movement, or still under the jitter threshold). */
+    deltaX: number | null;
+}
+/**
+ * Processes one pointermove sample against the in-progress drag state.
+ * Mirrors ScrubInput's handlePointerMove threshold/hasDragged logic exactly:
+ * a move is ignored until cumulative movement clears SCRUB_DRAG_THRESHOLD_PX,
+ * after which every subsequent move (including this one) yields an
+ * incremental delta and marks the gesture as a real drag.
+ */
+export declare function updateScrubDrag(state: ScrubDragState, clientX: number): ScrubDragTick;
+export interface ParsedScrubExpression {
+    value: number;
+    normalized: string;
+}
+export declare function parseScrubExpression(input: string, currentValue: number, options?: ScrubExpressionOptions): ParsedScrubExpression | null;
+export declare function normalizeScrubNumber(value: number, options?: ScrubExpressionOptions): number;
+/**
+ * Whether a field's unit should snap to whole numbers while the user is
+ * actively pointer-dragging (scrubbing) it. Px-type fields (padding, gap,
+ * position, size, radius, etc.) read as integers in Figma-style editors even
+ * though the underlying `precision` option (which also governs *typed* input
+ * and keyboard nudges) allows one decimal place so a typed "12.5" still
+ * commits legally. Scoped to "px" specifically — unitless fields like
+ * line-height (precision-based, fractional by design) and other units (deg,
+ * %) are untouched.
+ */
+export declare function scrubSnapsToInteger(unit: string | undefined): boolean;
+/**
+ * Rounds a live scrub-drag value to a whole number when the field's unit
+ * calls for integer-only scrubbing (see `scrubSnapsToInteger`), applied
+ * *before* `normalizeScrubNumber`'s own min/max/precision clamp so a
+ * following precision clamp (if any) can't reintroduce a fraction. Only the
+ * pointer-drag scrub gesture should call this — typed input and keyboard
+ * nudges keep their existing `precision`-based rounding untouched.
+ */
+export declare function roundScrubDragValue(value: number, unit: string | undefined): number;
+export declare function formatScrubValue(value: number, options?: Pick<ScrubExpressionOptions, "precision" | "unit">): string;
+export declare function getScrubStepFromEvent(event: Pick<KeyboardEvent | PointerEvent, "altKey" | "shiftKey">, step: number): number;
+//# sourceMappingURL=scrub-input-utils.d.ts.map

package/dist/design-tweaks/scrub-input-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrub-input-utils.d.ts","sourceRoot":"","sources":["../../src/design-tweaks/scrub-input-utils.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AASD;;qCAEqC;AACrC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAE7D;AAED,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,KAAK,EAAE,cAAc,CAAC;IACtB;+EAC2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,GACd,aAAa,CAaf;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAeD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,GAAG,IAAI,CAa9B;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,sBAA2B,GACnC,MAAM,CAWR;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,CAER;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,IAAI,CAAC,sBAAsB,EAAE,WAAW,GAAG,MAAM,CAAM,GAC/D,MAAM,CAoBR;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,IAAI,CAAC,aAAa,GAAG,YAAY,EAAE,QAAQ,GAAG,UAAU,CAAC,EAChE,IAAI,EAAE,MAAM,GACX,MAAM,CAQR"}

package/dist/design-tweaks/scrub-input-utils.js

@@ -0,0 +1,235 @@
+// ─── Scrub-drag gesture-lifecycle state machine ───────────────────────────────
+//
+// Pure mirror of the pointerdown/pointermove/pointerup bookkeeping in
+// ScrubInput's dragRef, extracted so the "exactly one commit-phase emission
+// per gesture" contract can be unit tested without simulating real DOM
+// pointer events (this template has no jsdom/testing-library dependency).
+/** Cumulative pointer movement (px) required before a drag start is treated
+ * as a real scrub rather than jitter during a plain click. Mirrors
+ * ScrubInput's DRAG_THRESHOLD_PX. */
+export const SCRUB_DRAG_THRESHOLD_PX = 3;
+/** Begins tracking a new scrub gesture at the given starting pointer X. */
+export function startScrubDrag(startX) {
+    return { startX, prevX: startX, hasDragged: false };
+}
+/**
+ * Processes one pointermove sample against the in-progress drag state.
+ * Mirrors ScrubInput's handlePointerMove threshold/hasDragged logic exactly:
+ * a move is ignored until cumulative movement clears SCRUB_DRAG_THRESHOLD_PX,
+ * after which every subsequent move (including this one) yields an
+ * incremental delta and marks the gesture as a real drag.
+ */
+export function updateScrubDrag(state, clientX) {
+    const incr = clientX - state.prevX;
+    if (incr === 0) {
+        return { state, deltaX: null };
+    }
+    const cumulativeDelta = Math.abs(clientX - state.startX);
+    if (!state.hasDragged && cumulativeDelta < SCRUB_DRAG_THRESHOLD_PX) {
+        return { state: { ...state, prevX: clientX }, deltaX: null };
+    }
+    return {
+        state: { ...state, prevX: clientX, hasDragged: true },
+        deltaX: incr,
+    };
+}
+const NUMBER_CHAR_PATTERN = /[0-9.]/;
+// Comma is only treated as a digit character while scanning a number token
+// (see tokenizeExpression) so a locale-style decimal comma ("12,5") parses as
+// 12.5, without swallowing the "," that a caller might use to separate
+// distinct expressions elsewhere.
+const NUMBER_OR_COMMA_CHAR_PATTERN = /[0-9.,]/;
+export function parseScrubExpression(input, currentValue, options = {}) {
+    const raw = input.trim();
+    if (!raw)
+        return null;
+    const expression = toNumericExpression(raw, currentValue, options.unit);
+    const value = evaluateNumericExpression(expression);
+    if (value === null)
+        return null;
+    const normalizedValue = normalizeScrubNumber(value, options);
+    return {
+        value: normalizedValue,
+        normalized: formatScrubValue(normalizedValue, options),
+    };
+}
+export function normalizeScrubNumber(value, options = {}) {
+    if (!Number.isFinite(value))
+        return 0;
+    let next = value;
+    if (Number.isFinite(options.min))
+        next = Math.max(options.min, next);
+    if (Number.isFinite(options.max))
+        next = Math.min(options.max, next);
+    if (Number.isFinite(options.precision)) {
+        const scale = 10 ** Math.max(0, options.precision);
+        next = Math.round(next * scale) / scale;
+    }
+    return Object.is(next, -0) ? 0 : next;
+}
+/**
+ * Whether a field's unit should snap to whole numbers while the user is
+ * actively pointer-dragging (scrubbing) it. Px-type fields (padding, gap,
+ * position, size, radius, etc.) read as integers in Figma-style editors even
+ * though the underlying `precision` option (which also governs *typed* input
+ * and keyboard nudges) allows one decimal place so a typed "12.5" still
+ * commits legally. Scoped to "px" specifically — unitless fields like
+ * line-height (precision-based, fractional by design) and other units (deg,
+ * %) are untouched.
+ */
+export function scrubSnapsToInteger(unit) {
+    return unit === "px";
+}
+/**
+ * Rounds a live scrub-drag value to a whole number when the field's unit
+ * calls for integer-only scrubbing (see `scrubSnapsToInteger`), applied
+ * *before* `normalizeScrubNumber`'s own min/max/precision clamp so a
+ * following precision clamp (if any) can't reintroduce a fraction. Only the
+ * pointer-drag scrub gesture should call this — typed input and keyboard
+ * nudges keep their existing `precision`-based rounding untouched.
+ */
+export function roundScrubDragValue(value, unit) {
+    return scrubSnapsToInteger(unit) ? Math.round(value) : value;
+}
+export function formatScrubValue(value, options = {}) {
+    const normalized = normalizeScrubNumber(value, options);
+    let numeric;
+    if (Number.isFinite(options.precision) && options.precision >= 0) {
+        const fixed = normalized.toFixed(options.precision);
+        if (options.unit) {
+            // For fields with units (px, %, °, etc.) collapse all trailing zeros
+            // including the decimal point: "12.30px" → "12.3px", "10.00px" → "10px".
+            // Leave integer strings alone; otherwise precision 0 turns "100" into "1".
+            numeric = fixed.includes(".") ? fixed.replace(/\.?0+$/, "") : fixed;
+        }
+        else {
+            // For unitless fields (e.g. line-height), preserve at least one decimal
+            // digit so values like "2.0" stay "2.0" rather than collapsing to "2".
+            // Only strip redundant trailing zeros beyond the first decimal digit.
+            numeric = fixed.includes(".") ? fixed.replace(/(?<=\.\d)0+$/, "") : fixed;
+        }
+    }
+    else {
+        numeric = String(normalized);
+    }
+    return `${numeric}${options.unit ?? ""}`;
+}
+export function getScrubStepFromEvent(event, step) {
+    // Alt (fine-step) and Shift (coarse) are mutually exclusive — alt takes
+    // priority, matching Figma's modifier convention. Applying both independently
+    // would make Shift+Alt a no-op (×10 × 0.1 = ×1).
+    let multiplier = 1;
+    if (event.altKey)
+        multiplier = 0.1;
+    else if (event.shiftKey)
+        multiplier = 10;
+    return step * multiplier;
+}
+function toNumericExpression(raw, currentValue, unit) {
+    let expression = raw.trim();
+    if (unit) {
+        expression = expression.replace(new RegExp(escapeRegExp(unit), "gi"), "");
+    }
+    if (expression.startsWith("="))
+        return expression.slice(1).trim();
+    if (/^[+\-*/]/.test(expression))
+        return `${currentValue}${expression}`;
+    return expression;
+}
+function evaluateNumericExpression(expression) {
+    const tokens = tokenizeExpression(expression);
+    if (!tokens.length)
+        return null;
+    const values = [];
+    const operators = [];
+    for (const token of tokens) {
+        if (token.type === "number") {
+            values.push(token.value);
+            continue;
+        }
+        while (operators.length &&
+            precedence(operators[operators.length - 1]) >= precedence(token.value)) {
+            if (!applyTopOperator(values, operators))
+                return null;
+        }
+        operators.push(token.value);
+    }
+    while (operators.length) {
+        if (!applyTopOperator(values, operators))
+            return null;
+    }
+    if (values.length !== 1 || !Number.isFinite(values[0]))
+        return null;
+    return values[0];
+}
+function tokenizeExpression(expression) {
+    const tokens = [];
+    let index = 0;
+    let previousWasOperator = true;
+    while (index < expression.length) {
+        const char = expression[index];
+        if (/\s/.test(char)) {
+            index += 1;
+            continue;
+        }
+        const signedNumber = (char === "+" || char === "-") &&
+            previousWasOperator &&
+            NUMBER_CHAR_PATTERN.test(expression[index + 1] ?? "");
+        if (NUMBER_CHAR_PATTERN.test(char) || signedNumber) {
+            const start = index;
+            index += 1;
+            // Allow a single comma decimal separator within this number token
+            // ("12,5" → 12.5), matching common European locale input. A second
+            // comma/period is left for the caller's Number() parse to reject.
+            while (NUMBER_OR_COMMA_CHAR_PATTERN.test(expression[index] ?? ""))
+                index += 1;
+            const value = Number(expression.slice(start, index).replace(",", "."));
+            if (!Number.isFinite(value))
+                return [];
+            tokens.push({ type: "number", value });
+            previousWasOperator = false;
+            continue;
+        }
+        if (isOperator(char)) {
+            tokens.push({ type: "operator", value: char });
+            previousWasOperator = true;
+            index += 1;
+            continue;
+        }
+        return [];
+    }
+    return tokens;
+}
+function applyTopOperator(values, operators) {
+    const operator = operators.pop();
+    const right = values.pop();
+    const left = values.pop();
+    if (!operator || right === undefined || left === undefined)
+        return false;
+    switch (operator) {
+        case "+":
+            values.push(left + right);
+            return true;
+        case "-":
+            values.push(left - right);
+            return true;
+        case "*":
+            values.push(left * right);
+            return true;
+        case "/":
+            if (right === 0)
+                return false;
+            values.push(left / right);
+            return true;
+    }
+}
+function precedence(operator) {
+    return operator === "*" || operator === "/" ? 2 : 1;
+}
+function isOperator(char) {
+    return char === "+" || char === "-" || char === "*" || char === "/";
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=scrub-input-utils.js.map

package/dist/design-tweaks/scrub-input-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrub-input-utils.js","sourceRoot":"","sources":["../../src/design-tweaks/scrub-input-utils.ts"],"names":[],"mappings":"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"}