@agent-native/toolkit 0.11.2 → 0.12.0

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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"}

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

@@ -0,0 +1,66 @@
+import { type ReactNode } from "react";
+import { type ScrubExpressionOptions } from "./scrub-input-utils.js";
+type ScrubInputIcon = (props: {
+    className?: string;
+    "aria-hidden"?: boolean;
+}) => ReactNode;
+export interface ScrubInputChangeMeta {
+    source: "commit" | "keyboard" | "scrub";
+    expression?: string;
+    /**
+     * Gesture-lifecycle signal for downstream consumers that want to throttle
+     * expensive work during a drag and only do the expensive commit once.
+     *
+     * - "preview": a live, in-progress tick — e.g. one pointermove sample while
+     *   scrubbing. There can be many of these per gesture; treat each as a
+     *   cheap, throttleable preview of the value, not a point to commit at full
+     *   cost.
+     * - "commit": the gesture's authoritative, final value. Fired exactly once
+     *   per gesture: on pointerup that ends a scrub drag, and for every
+     *   `source: "commit"` (blur/Enter) or `source: "keyboard"` (arrow step)
+     *   change, since those are already discrete, complete edits.
+     */
+    phase: "preview" | "commit";
+    /**
+     * Set when an arrow-key nudge fires on a `mixed` selection (see
+     * `handleKeyDown`): there is no single current value to step from across a
+     * mixed selection, so `onChange`'s `value` arg is the step delta itself
+     * (not a new absolute value) and consumers that support per-target relative
+     * application should add this delta to each selected target's own current
+     * value instead of overwriting every target with `value`. Omitted for
+     * every other change — existing consumers that don't check for it keep
+     * receiving absolute values exactly as before.
+     */
+    relativeDelta?: number;
+}
+export interface ScrubInputProps extends ScrubExpressionOptions {
+    label: string;
+    value: number;
+    onChange: (value: number, meta: ScrubInputChangeMeta) => void;
+    id?: string;
+    step?: number;
+    icon?: ScrubInputIcon | null;
+    /** Use the compact icon-only prefix treatment without relying on CSS selectors. */
+    prefix?: "label" | "icon";
+    disabled?: boolean;
+    placeholder?: string;
+    mixed?: boolean;
+    mixedLabel?: string;
+    className?: string;
+    inputClassName?: string;
+    labelClassName?: string;
+    ariaLabel?: string;
+    tooltipLabel?: string;
+}
+export interface PendingScrubCommit {
+    value: number;
+    /** Incoming prop value at commit time. While this exact value remains, the
+     * host has not acknowledged the write yet and the optimistic draft should
+     * stay visible. A different incoming value is authoritative host
+     * normalization/rejection and must supersede the optimistic draft. */
+    baseline: number;
+}
+export declare function resolvePendingScrubCommit(pending: PendingScrubCommit | null, incomingValue: number, options: ScrubExpressionOptions): "none" | "hold" | "confirmed" | "superseded";
+export declare function VisualScrubInput({ label, value, onChange, id, step, unit, min, max, precision, icon: Icon, prefix, disabled, placeholder, mixed, mixedLabel, className, inputClassName, labelClassName, ariaLabel, tooltipLabel, }: ScrubInputProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=scrub-input.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scrub-input.d.ts","sourceRoot":"","sources":["../../src/design-tweaks/scrub-input.tsx"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAWf,OAAO,EAQL,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAC;AAEhC,KAAK,cAAc,GAAG,CAAC,KAAK,EAAE;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,KAAK,SAAS,CAAC;AAEhB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;;OAYG;IACH,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAgB,SAAQ,sBAAsB;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC9D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7B,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd;;;0EAGsE;IACtE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,kBAAkB,GAAG,IAAI,EAClC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,sBAAsB,GAC9B,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,CAK9C;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,KAAK,EACL,QAAQ,EACR,EAAE,EACF,IAAQ,EACR,IAAI,EACJ,GAAG,EACH,GAAG,EACH,SAAS,EACT,IAAI,EAAE,IAA2B,EACjC,MAAgB,EAChB,QAAgB,EAChB,WAAW,EACX,KAAa,EACb,UAAU,EACV,SAAS,EACT,cAAc,EACd,cAAc,EACd,SAAS,EACT,YAAY,GACb,EAAE,eAAe,+BA2WjB"}