@lerianstudio/sindarian-ui 1.2.0 → 1.3.0-beta.2

package/dist/esm/enterprise/index.js

@@ -0,0 +1,22 @@
+// Owned by lane enterprise — see docs/plans/2026-08-26-sindarian-x-retirement/
+//
+// The composed enterprise layer absorbed from @lerianstudio/sindarian-x@0.15.0.
+// Outer public APIs are byte-compatible with that package; internals are
+// recomposed over sindarian-ui primitives and its design tokens.
+//
+// Names already exported by sindarian-ui are NEVER re-exported here (FC-4):
+// consumers adapt to sindarian-ui's API for Button, Badge, Table*, Sidebar*,
+// EntityBox*, Stepper*, PageHeader, ConfirmationDialog and friends.
+export { AlertBanner } from './alert-banner/index.js';
+export { AppShell } from './app-shell/index.js';
+export { CursorPager } from './cursor-pager/index.js';
+export { DataTable } from './data-table/index.js';
+export { DateRangePicker } from './date-range-picker/index.js';
+export { DetailPanel } from './detail-panel/index.js';
+export { EmptyState } from './empty-state/index.js';
+export { NumberInput } from './number-input/index.js';
+export { SearchInput } from './search-input/index.js';
+export { StatCard } from './stat-card/index.js';
+export { DEFAULT_STATUS_VARIANTS, StatusBadge } from './status-badge/index.js';
+export { VirtualizedTable } from './virtualized-table/index.js';
+export { useIsMobile } from './use-is-mobile.js';

package/dist/esm/enterprise/number-input/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * NumberInput — a controlled numeric input with +/- steppers.
+ *
+ * Composes sindarian-ui's Input (the text field) and IconButton (the two
+ * steppers). The external contract is a plain `number | null` (null = empty).
+ * Steppers step by `step` and clamp the result to [min, max]. While focused the
+ * field shows the raw, editable string the user is typing; on blur it reformats
+ * the committed number via Intl.NumberFormat(locale, { maximumFractionDigits:
+ * precision }) (e.g. 1,234.50). Parsing always emits the raw number, so digits
+ * the user types are never silently rewritten mid-edit.
+ */
+import * as React from 'react';
+export type NumberInputProps = {
+    /** Committed value. `null` means the field is empty. */
+    value: number | null;
+    /** Fires on every edit and stepper press; `null` when the field is cleared. */
+    onValueChange: (next: number | null) => void;
+    min?: number;
+    max?: number;
+    /** Stepper increment. Defaults to 1. */
+    step?: number;
+    /** Fraction digits used for the blurred Intl.NumberFormat display. */
+    precision?: number;
+    /** BCP 47 locale tag for the blurred display. Defaults to the host's. */
+    locale?: string;
+    disabled?: boolean;
+    /** Accessible label for the field; also names the +/- buttons. */
+    'aria-label'?: string;
+    /** Wired as aria-describedby on the input. */
+    'aria-describedby'?: string;
+    /** id (and de-facto testid) for the input element. */
+    id?: string;
+    className?: string;
+    placeholder?: string;
+};
+/**
+ * Parse the editable string into a number, round-tripping the component's
+ * `locale`: strip the locale group separators, swap the locale decimal mark to
+ * '.', then `Number()`. Null when empty/unparseable.
+ *
+ * Internal (not part of the public barrel) but exported for its unit tests —
+ * numeric-entry correctness is the load-bearing behavior here.
+ */
+export declare function parseRaw(raw: string, locale?: string): number | null;
+/**
+ * A transient partial entry that should not commit yet — a lone sign, a lone
+ * decimal mark, sign+decimal, or a value ending in the decimal mark (the user
+ * is still typing). Suppressing these keeps the external value from
+ * round-tripping through `null` mid-edit.
+ *
+ * Internal (not part of the public barrel) but exported for its unit tests.
+ */
+export declare function isTransientPartial(raw: string, locale?: string): boolean;
+export declare function NumberInput({ value, onValueChange, min, max, step, precision, locale, disabled, id, className, placeholder, 'aria-label': ariaLabel, 'aria-describedby': ariaDescribedBy }: NumberInputProps): React.JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/enterprise/number-input/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/enterprise/number-input/index.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAQ9B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wDAAwD;IACxD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,+EAA+E;IAC/E,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,sDAAsD;IACtD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAmED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBpE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAMxE;AAED,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,aAAa,EACb,GAAG,EACH,GAAG,EACH,IAAQ,EACR,SAAS,EACT,MAAM,EACN,QAAgB,EAChB,EAAE,EACF,SAAS,EACT,WAAW,EACX,YAAY,EAAE,SAAS,EACvB,kBAAkB,EAAE,eAAe,EACpC,EAAE,gBAAgB,qBAgJlB"}

package/dist/esm/enterprise/number-input/index.js

@@ -0,0 +1,214 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * NumberInput — a controlled numeric input with +/- steppers.
+ *
+ * Composes sindarian-ui's Input (the text field) and IconButton (the two
+ * steppers). The external contract is a plain `number | null` (null = empty).
+ * Steppers step by `step` and clamp the result to [min, max]. While focused the
+ * field shows the raw, editable string the user is typing; on blur it reformats
+ * the committed number via Intl.NumberFormat(locale, { maximumFractionDigits:
+ * precision }) (e.g. 1,234.50). Parsing always emits the raw number, so digits
+ * the user types are never silently rewritten mid-edit.
+ */
+import * as React from 'react';
+import { Minus, Plus } from 'lucide-react';
+import { safeLocale } from '../../domain/format.js';
+import { IconButton } from '../../components/ui/icon-button/index.js';
+import { Input } from '../../components/ui/input/index.js';
+import { cn } from '../../lib/utils.js';
+function clamp(value, min, max) {
+    let next = value;
+    if (typeof min === 'number' && next < min)
+        next = min;
+    if (typeof max === 'number' && next > max)
+        next = max;
+    return next;
+}
+/**
+ * `Number.prototype.toFixed` rejects more than 100 fraction digits. Denormals
+ * genuinely need more (`decimalPlaces(5e-324)` is 324), so this is a RangeError
+ * guard, not a precision policy — no step a person types comes close.
+ */
+const MAX_FIXED_DIGITS = 100;
+/**
+ * Fraction digits a number carries, reading exponent notation correctly.
+ * `String(1e-7)` is `'1e-7'`, which has no '.' at all, so counting characters
+ * after a decimal point reports 0 and silently kills any step below 1e-6.
+ * `toExponential()` gives a canonical mantissa/exponent pair instead:
+ * 1e-7 -> mantissa '1', exponent -7 -> 7 fraction digits.
+ */
+function decimalPlaces(value) {
+    if (!Number.isFinite(value) || Number.isInteger(value))
+        return 0;
+    const [mantissa, exponent] = value.toExponential().split('e');
+    const mantissaDigits = (mantissa.split('.')[1] ?? '').length;
+    return Math.max(0, mantissaDigits - Number(exponent));
+}
+/**
+ * Snap a stepped result to the fraction digits its own operands carry, so
+ * binary float drift never escapes to the parent: stepping 0.1 by 0.2 must
+ * commit 0.3, not 0.30000000000000004.
+ *
+ * Anchoring on the OPERANDS is what makes this safe at both ends of the range.
+ * Rounding to a fixed number of significant digits cannot work: at 1e15 the
+ * 15th significant digit is the units place, so 1e15 + 0.5 would snap straight
+ * back to 1e15 and the stepper would die. Nor can a "is this change small
+ * enough to be noise?" tolerance decide it — 1e15 + 0.125 is exactly
+ * representable and must be kept, yet its relative distance from the rounded
+ * form (1.25e-16) is SMALLER than genuine drift in 0.1 + 0.2 (1.85e-16), so no
+ * threshold separates the two cases. The operands do: `1e15` and `0.5` need one
+ * fraction digit between them, `0.1` and `0.2` also one, and rounding each
+ * result to its own digit count keeps the first and repairs the second.
+ *
+ * `toFixed` (not `value * 10 ** digits`) does the rounding: the multiply
+ * overflows Number.MAX_SAFE_INTEGER for large values and hands back the very
+ * drift it was meant to remove.
+ */
+function snapToStep(value, base, step) {
+    if (!Number.isFinite(value))
+        return value;
+    const digits = Math.min(MAX_FIXED_DIGITS, Math.max(decimalPlaces(base), decimalPlaces(step)));
+    return Number(value.toFixed(digits));
+}
+/** The locale's decimal and group separators, derived from a known sample. */
+function localeSeparators(locale) {
+    const parts = new Intl.NumberFormat(safeLocale(locale)).formatToParts(11111.1);
+    const decimal = parts.find((p) => p.type === 'decimal')?.value ?? '.';
+    const group = parts.find((p) => p.type === 'group')?.value ?? '';
+    return { decimal, group };
+}
+/**
+ * Parse the editable string into a number, round-tripping the component's
+ * `locale`: strip the locale group separators, swap the locale decimal mark to
+ * '.', then `Number()`. Null when empty/unparseable.
+ *
+ * Internal (not part of the public barrel) but exported for its unit tests —
+ * numeric-entry correctness is the load-bearing behavior here.
+ */
+export function parseRaw(raw, locale) {
+    const trimmed = raw.trim();
+    if (trimmed === '')
+        return null;
+    const { decimal, group } = localeSeparators(locale);
+    let normalized = trimmed;
+    if (group)
+        normalized = normalized.split(group).join('');
+    if (decimal !== '.')
+        normalized = normalized.split(decimal).join('.');
+    if (normalized === '')
+        return null;
+    const parsed = Number(normalized);
+    // NaN is not the only unusable result: `Number('1e999')` and `Number('Infinity')`
+    // are both `Infinity`, which passed the NaN check and was committed straight to
+    // `onValueChange`. An infinite committed value poisons everything downstream —
+    // `clamp` returns it verbatim with no `max`, `toFixed` cannot render it, and a
+    // form submits it. A non-finite entry is no number at all, so the committed
+    // value stays where it was.
+    return Number.isFinite(parsed) ? parsed : null;
+}
+/**
+ * A transient partial entry that should not commit yet — a lone sign, a lone
+ * decimal mark, sign+decimal, or a value ending in the decimal mark (the user
+ * is still typing). Suppressing these keeps the external value from
+ * round-tripping through `null` mid-edit.
+ *
+ * Internal (not part of the public barrel) but exported for its unit tests.
+ */
+export function isTransientPartial(raw, locale) {
+    const trimmed = raw.trim();
+    if (trimmed === '')
+        return false;
+    const { decimal } = localeSeparators(locale);
+    const d = decimal.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`^-?(${d})?$|${d}$`).test(trimmed);
+}
+export function NumberInput({ value, onValueChange, min, max, step = 1, precision, locale, disabled = false, id, className, placeholder, 'aria-label': ariaLabel, 'aria-describedby': ariaDescribedBy }) {
+    const [focused, setFocused] = React.useState(false);
+    // The string the user is editing. Only authoritative while focused.
+    const [draft, setDraft] = React.useState('');
+    // A step has to be a POSITIVE FINITE number or the control stops meaning what
+    // its buttons say: a negative step makes "+" decrease and "−" increase, a zero
+    // or NaN step commits a value that never progresses (and NaN escapes into the
+    // form), and an infinite step commits Infinity the moment `max` is unset.
+    // None of those is a step, so an unusable one falls back to the documented
+    // default of 1 rather than being fed to the arithmetic.
+    const safeStep = Number.isFinite(step) && step > 0 ? step : 1;
+    const formatter = React.useMemo(() => new Intl.NumberFormat(safeLocale(locale), {
+        maximumFractionDigits: precision ?? 20,
+        minimumFractionDigits: precision ?? 0,
+        useGrouping: true
+    }), [locale, precision]);
+    // Blurred display: locale-formatted committed value, or empty.
+    const displayValue = focused
+        ? draft
+        : value === null
+            ? ''
+            : formatter.format(value);
+    const commit = (next) => {
+        onValueChange(next);
+    };
+    const stepBy = (direction) => {
+        const base = value ?? 0;
+        // Snap FIRST, then clamp — never the other way round. Snapping rounds to
+        // the operands' fraction digits, so snapping a CLAMPED value rounds the
+        // bound itself: stepping 0.2 by 0.1 under max 0.25 clamps to 0.25, which
+        // then snaps to one digit as 0.3 and escapes the maximum. Clamping last
+        // makes the bound the final word, and `clamp` returns it verbatim, so a
+        // bound is emitted exactly as the caller gave it.
+        const next = clamp(snapToStep(base + direction * safeStep, base, safeStep), min, max);
+        commit(next);
+        // Seed the draft via the locale formatter so a stepper press doesn't flip
+        // the user's separators (e.g. ',' → '.').
+        if (focused)
+            setDraft(formatter.format(next));
+    };
+    const onChange = (event) => {
+        const raw = event.target.value;
+        setDraft(raw);
+        // Commit only a genuine clear or a parsed number; suppress transient
+        // partials ("-", ".", "-.", trailing separator) so typing a negative or
+        // decimal doesn't round-trip the external value through null mid-entry.
+        if (raw.trim() === '') {
+            commit(null);
+            return;
+        }
+        if (isTransientPartial(raw, locale))
+            return;
+        const parsed = parseRaw(raw, locale);
+        if (parsed !== null)
+            commit(parsed);
+    };
+    // Keyboard stepping (WCAG 2.1.1): the steppers are tabIndex={-1}, so the
+    // input owns keyboard interaction per the ARIA spinbutton pattern.
+    const onKeyDown = (event) => {
+        if (disabled)
+            return;
+        if (event.key === 'ArrowUp') {
+            event.preventDefault();
+            stepBy(1);
+        }
+        else if (event.key === 'ArrowDown') {
+            event.preventDefault();
+            stepBy(-1);
+        }
+    };
+    const onFocus = () => {
+        setFocused(true);
+        // Seed via the locale formatter (not String(value), which forces '.') so
+        // focusing doesn't flip the separator the user expects.
+        setDraft(value === null ? '' : formatter.format(value));
+    };
+    const onBlur = () => {
+        setFocused(false);
+        // Re-clamp the committed value so a typed out-of-range entry settles.
+        if (value !== null) {
+            const clamped = clamp(value, min, max);
+            if (clamped !== value)
+                commit(clamped);
+        }
+    };
+    const atMin = typeof min === 'number' && value !== null && value <= min;
+    const atMax = typeof max === 'number' && value !== null && value >= max;
+    return (_jsxs("div", { className: cn('inline-flex items-stretch gap-1', className), children: [_jsx(IconButton, { type: "button", variant: "outline", disabled: disabled || atMin, "aria-label": `Decrease${ariaLabel ? ` ${ariaLabel}` : ''}`, onClick: () => stepBy(-1), tabIndex: -1, children: _jsx(Minus, { className: "size-4", "aria-hidden": true }) }), _jsx("div", { className: "w-28", children: _jsx(Input, { id: id, inputMode: "decimal", role: "spinbutton", "aria-valuenow": value ?? undefined, "aria-valuemin": min, "aria-valuemax": max, className: "text-right tabular-nums", value: displayValue, placeholder: placeholder, disabled: disabled, "aria-label": ariaLabel, "aria-describedby": ariaDescribedBy, onChange: onChange, onKeyDown: onKeyDown, onFocus: onFocus, onBlur: onBlur }) }), _jsx(IconButton, { type: "button", variant: "outline", disabled: disabled || atMax, "aria-label": `Increase${ariaLabel ? ` ${ariaLabel}` : ''}`, onClick: () => stepBy(1), tabIndex: -1, children: _jsx(Plus, { className: "size-4", "aria-hidden": true }) })] }));
+}

package/dist/esm/enterprise/search-input/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * SearchInput — the console filter row's text field.
+ *
+ * A controlled text field with a leading search glyph and a trailing clear
+ * button that appears only when there is text. It debounces the *emission*
+ * (`onValueChange`) while keeping the visible field perfectly responsive: a
+ * local draft mirrors the controlled `value`, every keystroke updates the draft
+ * immediately, and a trailing timer flushes the draft to the parent after
+ * `debounceMs`. Clearing flushes synchronously (no lingering timer fighting an
+ * explicit empty).
+ *
+ * Composes sindarian-ui's Input via its start/end adornment slots.
+ */
+import * as React from 'react';
+export type SearchInputProps = {
+    /** Controlled value. The visible field mirrors this between keystrokes. */
+    value: string;
+    /** Debounced emission of the current text. */
+    onValueChange: (value: string) => void;
+    /** Trailing debounce in ms before `onValueChange` fires. Default 250. */
+    debounceMs?: number;
+    placeholder?: string;
+    /** Accessible label for the field (defaults to the placeholder or "Search"). */
+    'aria-label'?: string;
+    /** Accessible label for the clear button. */
+    clearLabel?: string;
+    disabled?: boolean;
+    className?: string;
+    id?: string;
+};
+export declare function SearchInput({ value, onValueChange, debounceMs, placeholder, 'aria-label': ariaLabel, clearLabel, disabled, className, id }: SearchInputProps): React.JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/enterprise/search-input/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/enterprise/search-input/index.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAa9B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAA;IACb,8CAA8C;IAC9C,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,aAAa,EACb,UAAgB,EAChB,WAAuB,EACvB,YAAY,EAAE,SAAS,EACvB,UAA2B,EAC3B,QAAgB,EAChB,SAAS,EACT,EAAE,EACH,EAAE,gBAAgB,qBAsGlB"}

package/dist/esm/enterprise/search-input/index.js

@@ -0,0 +1,85 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * SearchInput — the console filter row's text field.
+ *
+ * A controlled text field with a leading search glyph and a trailing clear
+ * button that appears only when there is text. It debounces the *emission*
+ * (`onValueChange`) while keeping the visible field perfectly responsive: a
+ * local draft mirrors the controlled `value`, every keystroke updates the draft
+ * immediately, and a trailing timer flushes the draft to the parent after
+ * `debounceMs`. Clearing flushes synchronously (no lingering timer fighting an
+ * explicit empty).
+ *
+ * Composes sindarian-ui's Input via its start/end adornment slots.
+ */
+import * as React from 'react';
+import { Search, X } from 'lucide-react';
+import { IconButton } from '../../components/ui/icon-button/index.js';
+import { Input, InputAdornment } from '../../components/ui/input/index.js';
+import { cn } from '../../lib/utils.js';
+/**
+ * Marks "no emission of ours is awaiting its echo". A unique object, not a
+ * string: any string sentinel is a value a parent could legitimately pass.
+ */
+const NO_PENDING_ECHO = Symbol('no pending echo');
+export function SearchInput({ value, onValueChange, debounceMs = 250, placeholder = 'Search…', 'aria-label': ariaLabel, clearLabel = 'Clear search', disabled = false, className, id }) {
+    // Local draft keeps typing instant; the controlled `value` is the source of
+    // truth between edits. When the parent changes `value` out of band (reset,
+    // programmatic set), the draft follows.
+    const [draft, setDraft] = React.useState(value);
+    const timer = React.useRef(null);
+    // The value this component last emitted and has not yet seen echoed back. The
+    // parent echoes it one render later, by which time the user may already have
+    // typed further — syncing the draft to that echo would rewind the field and
+    // swallow those keystrokes. Starts as the sentinel rather than `value`, so the
+    // initial value is never mistaken for an echo of something we sent.
+    const lastEmitted = React.useRef(NO_PENDING_ECHO);
+    React.useEffect(() => {
+        const isEcho = lastEmitted.current === value;
+        // ANY external change consumes the token, echo or not. Consuming it only on
+        // a match left a DROPPED emission pending forever: emit "pix", the parent
+        // rejects it and holds "", the parent later sets "foo" (draft follows, token
+        // still holding "pix"), the parent then sets "pix" — read as our own echo,
+        // so the draft stayed on "foo" and the visible field disagreed with the
+        // controlled value. A later external change is proof the parent moved on,
+        // which invalidates any echo still outstanding.
+        lastEmitted.current = NO_PENDING_ECHO;
+        // A genuine echo must NOT reach the draft: the parent echoes one render
+        // later, by which time the user may have typed further, and syncing would
+        // rewind the field and swallow those keystrokes.
+        if (isEcho)
+            return;
+        setDraft(value);
+    }, [value]);
+    const clearTimer = React.useCallback(() => {
+        if (timer.current !== null) {
+            clearTimeout(timer.current);
+            timer.current = null;
+        }
+    }, []);
+    // Cancel any pending debounced emission on unmount — don't fire a stale
+    // search into a parent that's tearing down. (Clearing flushes synchronously
+    // via handleClear, so a real clear is never lost.)
+    React.useEffect(() => clearTimer, [clearTimer]);
+    const handleChange = (event) => {
+        const next = event.target.value;
+        setDraft(next);
+        clearTimer();
+        timer.current = setTimeout(() => {
+            timer.current = null;
+            lastEmitted.current = next;
+            onValueChange(next);
+        }, debounceMs);
+    };
+    const handleClear = () => {
+        clearTimer();
+        setDraft('');
+        lastEmitted.current = '';
+        onValueChange('');
+    };
+    const hasValue = draft.length > 0;
+    return (_jsx("div", { className: cn('relative w-full sm:w-64', className), children: _jsx(Input, { id: id, type: "search", role: "searchbox", value: draft, onChange: handleChange, placeholder: placeholder, "aria-label": ariaLabel ?? placeholder ?? 'Search', disabled: disabled, 
+            // The native search clear glyph would duplicate our button.
+            className: "[&::-webkit-search-cancel-button]:appearance-none", startAdornment: _jsx(InputAdornment, { position: "start", children: _jsx(Search, { "aria-hidden": true }) }), endAdornment: hasValue ? (_jsx(InputAdornment, { position: "end", children: _jsx(IconButton, { type: "button", variant: "plain", size: "small", "aria-label": clearLabel, disabled: disabled, onClick: handleClear, className: "text-muted-foreground hover:text-foreground", children: _jsx(X, { className: "size-4", "aria-hidden": true }) }) })) : undefined }) }));
+}

package/dist/esm/enterprise/stat-card/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * StatCard — a single headline-figure cell of the console.
+ *
+ * A `LedgerPanel` holding a recessive `SectionLabel`, the dominant mono
+ * `Figure`, an optional delta line, an optional inline trend, and optional
+ * secondary `BlotterRow` key/value rows. Drop StatCards into a `LedgerSheet` so
+ * they read as connected hairline-seamed panels rather than floating cards.
+ *
+ *   <StatCard label="Match rate" value="98.4%" delta="+0.6 pts" tone="success" />
+ *   <StatCard label="In flight" value="R$ 129,004" trend={series} trendKey="v" />
+ *
+ * The `tone` escalates the value + delta color to a semantic theme token.
+ *
+ * NOTE (sindarian-x port): the legacy StatCard drew its trend with the
+ * recharts-backed Sparkline. That component is outside the port census, so the
+ * trend here is a dependency-free inline SVG; everything else composes the same
+ * ledger grammar the legacy card did.
+ */
+import type { ReactNode } from 'react';
+export type StatCardTone = 'default' | 'success' | 'warning' | 'destructive';
+export type StatCardRow = {
+    label: ReactNode;
+    value: ReactNode;
+};
+export type StatCardProps = {
+    /** Recessive uppercase heading. */
+    label: string;
+    /** The dominant headline value — rendered in the hero mono figure. */
+    value: ReactNode;
+    /** Optional delta line below the value (e.g. `+0.6 pts`, `-3`). Inherits the tone color. */
+    delta?: ReactNode;
+    /** Semantic escalation for the value + delta color. */
+    tone?: StatCardTone;
+    /** Optional trend series for the inline sparkline. */
+    trend?: ReadonlyArray<Record<string, string | number | null>>;
+    /** Key in each `trend` datum to plot. Defaults to `value`. */
+    trendKey?: string;
+    /** Optional secondary key/value rows. */
+    rows?: StatCardRow[];
+    className?: string;
+};
+export declare function StatCard({ label, value, delta, tone, trend, trendKey, rows, className }: StatCardProps): import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/enterprise/stat-card/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/enterprise/stat-card/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAQtC,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAA;AAoB5E,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,EAAE,SAAS,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,sEAAsE;IACtE,KAAK,EAAE,SAAS,CAAA;IAChB,4FAA4F;IAC5F,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,uDAAuD;IACvD,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,sDAAsD;IACtD,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC,CAAA;IAC7D,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yCAAyC;IACzC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAwED,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,KAAK,EACL,KAAK,EACL,IAAgB,EAChB,KAAK,EACL,QAAkB,EAClB,IAAI,EACJ,SAAS,EACV,EAAE,aAAa,+BAgCf"}

package/dist/esm/enterprise/stat-card/index.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Blotter, BlotterRow } from '../../domain/blotter/index.js';
+import { Figure } from '../../domain/figure/index.js';
+import { LedgerPanel } from '../../domain/ledger-sheet/index.js';
+import { SectionLabel } from '../../domain/section-label/index.js';
+import { cn } from '../../lib/utils.js';
+/** Value/delta color per tone. `default` keeps the high-contrast foreground;
+ *  the rest escalate to a semantic theme token that tracks light/dark. */
+const TONE_VALUE = {
+    default: 'text-foreground',
+    success: 'text-system-success-text',
+    warning: 'text-system-alert-text',
+    destructive: 'text-destructive'
+};
+/** Trend stroke color per tone. Resolved through the `--color-*` wrappers (the
+ *  raw `--chart-N` tokens are bare HSL triples, not usable colors). */
+const TONE_TREND = {
+    default: 'var(--color-chart-1)',
+    success: 'var(--color-system-success)',
+    warning: 'var(--color-system-alert)',
+    destructive: 'var(--color-destructive)'
+};
+const TREND_VIEWBOX_WIDTH = 100;
+const TREND_VIEWBOX_HEIGHT = 40;
+/**
+ * Chrome-less inline trend: no axes, grid, legend or tooltip. Decorative by
+ * construction (`aria-hidden`) — the figure above it carries the meaning.
+ * Renders nothing when fewer than two points are plottable.
+ */
+function TrendSpark({ data, dataKey, color }) {
+    // Drop absent samples BEFORE coercing: Number(null) and Number('') are both
+    // 0, which would draw a phantom dip to the floor where the series simply has
+    // no reading.
+    const points = [];
+    for (const row of data) {
+        const raw = row[dataKey];
+        if (raw === null || raw === undefined || raw === '')
+            continue;
+        const n = Number(raw);
+        if (Number.isFinite(n))
+            points.push(n);
+    }
+    if (points.length < 2)
+        return null;
+    const min = Math.min(...points);
+    const max = Math.max(...points);
+    // A flat series has zero span; pin it to the vertical midline instead of
+    // dividing by zero.
+    const span = max - min;
+    const stepX = TREND_VIEWBOX_WIDTH / (points.length - 1);
+    const coords = points.map((n, i) => {
+        const x = i * stepX;
+        const y = span === 0
+            ? TREND_VIEWBOX_HEIGHT / 2
+            : TREND_VIEWBOX_HEIGHT - ((n - min) / span) * TREND_VIEWBOX_HEIGHT;
+        return `${x.toFixed(2)},${y.toFixed(2)}`;
+    });
+    return (_jsxs("svg", { "aria-hidden": true, role: "presentation", viewBox: `0 0 ${TREND_VIEWBOX_WIDTH} ${TREND_VIEWBOX_HEIGHT}`, preserveAspectRatio: "none", className: "h-10 w-full", children: [_jsx("polygon", { points: `0,${TREND_VIEWBOX_HEIGHT} ${coords.join(' ')} ${TREND_VIEWBOX_WIDTH},${TREND_VIEWBOX_HEIGHT}`, fill: color, fillOpacity: 0.15 }), _jsx("polyline", { points: coords.join(' '), fill: "none", stroke: color, strokeWidth: 1.75, vectorEffect: "non-scaling-stroke" })] }));
+}
+export function StatCard({ label, value, delta, tone = 'default', trend, trendKey = 'value', rows, className }) {
+    const hasTrend = trend !== undefined && trend.length > 0;
+    const hasRows = rows !== undefined && rows.length > 0;
+    return (_jsxs(LedgerPanel, { "data-tone": tone, className: className, children: [_jsx(SectionLabel, { children: label }), _jsxs("div", { className: "space-y-1", children: [_jsx(Figure, { size: "hero", className: cn('block', TONE_VALUE[tone]), children: value }), delta !== undefined ? (_jsx("p", { className: cn('font-mono text-xs tabular-nums', TONE_VALUE[tone]), children: delta })) : null] }), hasTrend ? (_jsx(TrendSpark, { data: trend, dataKey: trendKey, color: TONE_TREND[tone] })) : null, hasRows ? (_jsx(Blotter, { className: "mt-auto", children: rows.map((row, i) => (_jsx(BlotterRow, { label: row.label, value: row.value }, i))) })) : null] }));
+}

package/dist/esm/enterprise/status-badge/index.d.ts

@@ -0,0 +1,31 @@
+import { type BadgeProps } from '../../components/ui/badge/index.js';
+type BadgeVariant = NonNullable<BadgeProps['variant']>;
+/**
+ * Generic lifecycle defaults — extend per-app via the `variantMap` prop.
+ *
+ * The KEYS are the frozen legacy contract (apps merge their own domain statuses
+ * into this map). The VALUES are sindarian-ui Badge variants: sindarian-ui is
+ * senior, so the legacy `muted`/`warning` variants resolve to sindarian-ui's
+ * `inactive`/`alert`.
+ */
+export declare const DEFAULT_STATUS_VARIANTS: Record<string, BadgeVariant>;
+export type StatusBadgeProps = {
+    /** Raw status/severity value (case-insensitive). */
+    status: string | null | undefined;
+    /** Override the displayed label; defaults to a humanized form. */
+    label?: string;
+    /** Shallow-merged over DEFAULT_STATUS_VARIANTS to add/override mappings. */
+    variantMap?: Record<string, BadgeVariant>;
+    /**
+     * Render the non-color severity cue: a leading glyph + an sr-only severity
+     * word, so the badge does not carry meaning by tint alone (WCAG 1.4.1).
+     * Opt-in; defaults to false to keep existing color-only usage unchanged.
+     */
+    withIcon?: boolean;
+    /** Label shown when `status` is empty. */
+    unknownLabel?: string;
+    className?: string;
+};
+export declare function StatusBadge({ status, label, variantMap, withIcon, unknownLabel, className }: StatusBadgeProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/enterprise/status-badge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/enterprise/status-badge/index.tsx"],"names":[],"mappings":"AAsBA,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAG9D,KAAK,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAA;AAEtD;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA6BhE,CAAA;AAqDD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,oDAAoD;IACpD,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACjC,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACzC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,KAAK,EACL,UAAU,EACV,QAAgB,EAChB,YAAwB,EACxB,SAAS,EACV,EAAE,gBAAgB,+BA6BlB"}