@lerianstudio/sindarian-ui 1.2.0-beta.13 → 1.2.0-beta.15

package/dist/esm/enterprise/date-range-picker/index.js

@@ -0,0 +1,89 @@
+'use client';
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * DateRangePicker — a two-segment popover range control.
+ *
+ * Two labelled mono trigger segments (from / to) each open the SAME two-month
+ * react-day-picker range calendar over the same range selection. The external
+ * contract is plain YYYY-MM-DD strings (empty string = unset) so state shapes
+ * that speak `date_from`/`date_to` stay untouched. The picker guarantees
+ * from <= to (react-day-picker reorders inverted picks);
+ * aria-invalid/aria-describedby pass-throughs keep external validation wiring
+ * alive. i18n is via plain string/locale props.
+ *
+ * ONE POPOVER ROOT PER SEGMENT, deliberately. A single `Popover.Root` holds ONE
+ * trigger ref and ONE open state, so wrapping the whole two-button row in a
+ * single `PopoverTrigger asChild` put Radix's dialog attributes
+ * (`aria-haspopup`, `aria-expanded`, `aria-controls`) on a plain, non-focusable
+ * `div` — an aria-allowed-attr violation, two buttons advertising the same
+ * expanded state, and focus that Radix could drop on `document.body` when the
+ * popover closed. Each segment is now a real `PopoverTrigger` button: focusable,
+ * correctly named, and the element Radix returns focus to on dismissal.
+ */
+import { useState } from 'react';
+import { CalendarDays } from 'lucide-react';
+import { enUS } from 'react-day-picker/locale';
+import { Button } from '../../components/ui/button/index.js';
+import { Calendar } from '../../components/ui/calendar/index.js';
+import { Label } from '../../components/ui/label/index.js';
+import { Popover, PopoverContent, PopoverTrigger } from '../../components/ui/popover/index.js';
+import { SECTION_LABEL_CLASS } from '../../lib/typography.js';
+import { cn } from '../../lib/utils.js';
+/** Leading YYYY-MM-DD of an ISO date (or date-time) string. */
+const ISO_DAY = /^(\d{4})-(\d{2})-(\d{2})/;
+/**
+ * Parse a YYYY-MM-DD day into a LOCAL-midnight Date — the calendar works in
+ * local time, so building from parts avoids the UTC shift `new Date(string)`
+ * applies to date-only input (which can land the picker a day early).
+ * Rejects impossible calendar days (e.g. 2024-02-31, which would roll over).
+ */
+function parseDay(value) {
+    const match = ISO_DAY.exec(value);
+    if (!match)
+        return undefined;
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    const parsed = new Date(year, month - 1, day);
+    return parsed.getFullYear() === year &&
+        parsed.getMonth() === month - 1 &&
+        parsed.getDate() === day
+        ? parsed
+        : undefined;
+}
+/** Format a Date back to YYYY-MM-DD in LOCAL time (never via toISOString). */
+function toDayString(value) {
+    if (!value)
+        return '';
+    const year = String(value.getFullYear()).padStart(4, '0');
+    const month = String(value.getMonth() + 1).padStart(2, '0');
+    const day = String(value.getDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+export function DateRangePicker({ value, onValueChange, fromId, toId, fromLabel, toLabel, invalid = false, errorId, placeholder = 'Any date', ariaLabel = 'Select date range', clearLabel = 'Clear', locale = enUS }) {
+    // Which segment's popover is open, if any. One root per segment means one open
+    // state per segment; holding the identity of the open one here keeps them
+    // mutually exclusive, so clicking "to" while "from" is open swaps the anchor
+    // instead of stacking two calendars.
+    const [openSegment, setOpenSegment] = useState(null);
+    const fromDate = parseDay(value.from);
+    const toDate = parseDay(value.to);
+    const selected = fromDate || toDate ? { from: fromDate, to: toDate } : undefined;
+    // Derived from the RAW strings, not the parsed dates: a value the calendar
+    // cannot parse still needs to be clearable, and gating Clear on `fromDate`
+    // would strand the field holding text the user can no longer remove.
+    const hasValue = value.from !== '' || value.to !== '';
+    const onSelect = (range) => {
+        onValueChange({
+            from: toDayString(range?.from),
+            to: toDayString(range?.to)
+        });
+    };
+    const triggerClass = cn('border-input bg-card hover:bg-secondary focus-visible:ring-ring flex h-9 items-center gap-2 rounded-md border px-3 text-left font-mono text-sm tabular-nums transition-colors duration-150 ease-out focus-visible:ring-2 focus-visible:ring-offset-1 focus-visible:outline-none sm:w-40', invalid && 'border-destructive');
+    // The one calendar, rendered inside whichever segment's popover is open. Both
+    // segments read and write the SAME range selection, so which one you opened
+    // changes only the anchor, never the state.
+    const calendar = (_jsxs(_Fragment, { children: [_jsx(Calendar, { mode: "range", numberOfMonths: 2, defaultMonth: fromDate ?? toDate ?? new Date(), selected: selected, onSelect: onSelect, locale: locale }), _jsx("div", { className: "border-border flex items-center justify-end border-t px-3 py-2", children: _jsx(Button, { type: "button", variant: "plain", size: "small", disabled: !hasValue, onClick: () => onValueChange({ from: '', to: '' }), children: clearLabel }) })] }));
+    const renderSegment = (segment, id, label, dateValue) => (_jsxs(Popover, { open: openSegment === segment, onOpenChange: (next) => setOpenSegment(next ? segment : null), children: [_jsxs("div", { className: "flex flex-col gap-1.5", children: [_jsx(Label, { htmlFor: id, className: SECTION_LABEL_CLASS, children: label }), _jsxs(PopoverTrigger, { type: "button", id: id, className: triggerClass, "aria-invalid": invalid || undefined, "aria-describedby": invalid ? errorId : undefined, children: [_jsx(CalendarDays, { className: "text-muted-foreground size-4 shrink-0", "aria-hidden": true }), dateValue ? (_jsx("span", { children: dateValue })) : (_jsx("span", { className: "text-muted-foreground font-sans", children: placeholder }))] })] }), _jsx(PopoverContent, { align: "start", className: "w-auto p-0", "aria-label": ariaLabel, children: calendar })] }, segment));
+    return (_jsxs("div", { className: "flex flex-col gap-3 sm:flex-row sm:items-end", children: [renderSegment('from', fromId, fromLabel, value.from), renderSegment('to', toId, toLabel, value.to)] }));
+}

package/dist/esm/enterprise/detail-panel/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * DetailPanel — the console's right-side slide-over for inspecting and editing a
+ * single record without leaving the list behind it. Built on Sheet (a Radix
+ * Dialog) with three structural slots:
+ *
+ *   - a STICKY header: the record title, an optional actions cluster, and a
+ *     close affordance, pinned to the top while the body scrolls;
+ *   - a SCROLLABLE body carrying `children`;
+ *   - an optional STICKY footer for the primary/secondary actions
+ *     (e.g. Cancel / Save), pinned to the bottom.
+ *
+ *   <DetailPanel
+ *     open={open}
+ *     onOpenChange={setOpen}
+ *     title="Transaction txn_8f2a"
+ *     footer={<>
+ *       <SheetClose asChild><Button variant="outline">Cancel</Button></SheetClose>
+ *       <Button onClick={save}>Save</Button>
+ *     </>}
+ *   >
+ *     …long body…
+ *   </DetailPanel>
+ *
+ * Controlled only: drive `open` from props and reflect dismissals via
+ * `onOpenChange`. `side` defaults to "right".
+ */
+import * as React from 'react';
+export type DetailPanelProps = {
+    /** Controlled open state. */
+    open: boolean;
+    /** Reflects every dismissal (overlay, Esc, close button) and programmatic toggle. */
+    onOpenChange: (open: boolean) => void;
+    /** Header title; also the accessible dialog name. */
+    title: React.ReactNode;
+    /** Edge the panel slides in from. Defaults to "right". */
+    side?: 'right' | 'left';
+    /** Optional header actions, placed left of the close button. */
+    actions?: React.ReactNode;
+    /** Optional sticky footer (e.g. Cancel / Save). */
+    footer?: React.ReactNode;
+    /** Accessible label for the close button. Defaults to "Close". */
+    closeLabel?: string;
+    /** Scrollable body content. */
+    children?: React.ReactNode;
+    className?: string;
+};
+/**
+ * The slide-over inspector. The header and footer stay pinned; only the body
+ * scrolls. Sheet already renders an overlay, focus trap, and Esc/overlay
+ * dismissal — we suppress its built-in corner close button (`[&>button.absolute]`)
+ * and provide our own inside the header so the layout stays deliberate.
+ */
+export declare function DetailPanel({ open, onOpenChange, title, side, actions, footer, closeLabel, children, className }: DetailPanelProps): React.JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/enterprise/detail-panel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/enterprise/detail-panel/index.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAW9B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,6BAA6B;IAC7B,IAAI,EAAE,OAAO,CAAA;IACb,qFAAqF;IACrF,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,qDAAqD;IACrD,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACvB,gEAAgE;IAChE,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,mDAAmD;IACnD,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACxB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,YAAY,EACZ,KAAK,EACL,IAAc,EACd,OAAO,EACP,MAAM,EACN,UAAoB,EACpB,QAAQ,EACR,SAAS,EACV,EAAE,gBAAgB,qBA4ClB"}

package/dist/esm/enterprise/detail-panel/index.js

@@ -0,0 +1,17 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { X } from 'lucide-react';
+import { Sheet, SheetClose, SheetContent, SheetTitle } from '../../components/ui/sheet/index.js';
+import { cn } from '../../lib/utils.js';
+/**
+ * The slide-over inspector. The header and footer stay pinned; only the body
+ * scrolls. Sheet already renders an overlay, focus trap, and Esc/overlay
+ * dismissal — we suppress its built-in corner close button (`[&>button.absolute]`)
+ * and provide our own inside the header so the layout stays deliberate.
+ */
+export function DetailPanel({ open, onOpenChange, title, side = 'right', actions, footer, closeLabel = 'Close', children, className }) {
+    return (_jsx(Sheet, { open: open, onOpenChange: onOpenChange, children: _jsxs(SheetContent, { side: side, className: cn(
+            // Reset Sheet's padding/gap and hide its built-in close button; we
+            // own the three-slot layout and the header close affordance here.
+            'flex flex-col gap-0 overflow-hidden p-0', '[&>button.absolute]:hidden', className), children: [_jsxs("header", { className: "border-border bg-card sticky top-0 z-10 flex shrink-0 items-start justify-between gap-3 border-b px-6 py-4", children: [_jsx(SheetTitle, { className: "min-w-0 flex-1 truncate text-base font-semibold tracking-tight", children: title }), _jsxs("div", { className: "flex shrink-0 items-center gap-1.5", children: [actions, _jsx(SheetClose, { "data-slot": "detail-panel-close", className: "ring-offset-background focus:ring-ring rounded-sm opacity-70 transition-opacity hover:opacity-100 focus:ring-2 focus:outline-none disabled:pointer-events-none", "aria-label": closeLabel, children: _jsx(X, { className: "size-4", "aria-hidden": true }) })] })] }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto", children: _jsx("div", { className: "px-6 py-5", children: children }) }), footer ? (_jsx("footer", { className: "border-border bg-card sticky bottom-0 z-10 flex shrink-0 flex-col-reverse gap-2 border-t px-6 py-4 sm:flex-row sm:justify-end", children: footer })) : null] }) }));
+}

package/dist/esm/enterprise/empty-state/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * EmptyState: centered icon + title + optional description and action, for
+ * "no data yet" and "no results" surfaces. Keep copy short and neutral.
+ *
+ * The `ruled` flag is the "ruled page" presentation hook: instead of the
+ * floating centered card (which reads as a void inside a ledger register), it
+ * renders a quiet, top/left-aligned notation under a hairline rule — so a
+ * sparse register reads as ruled stationery waiting for entries rather than an
+ * empty pane. The icon bubble drops; the title takes the column-head label
+ * voice; the copy aligns to the page baseline. This is the seam a pre-ruled
+ * empty-rows register (built app-side) composes with: the EmptyState sits at
+ * the head of the page and the faint ruled lines fill below it.
+ */
+import type { LucideIcon } from 'lucide-react';
+import type { ReactNode } from 'react';
+export type EmptyStateProps = {
+    /** Lucide icon component. Defaults to Inbox. */
+    icon?: LucideIcon;
+    title: string;
+    description?: string;
+    /** Optional action node (e.g. a Button). */
+    action?: ReactNode;
+    /**
+     * Render as a ruled-page notation rather than a centered card. Use inside a
+     * ledger register so a short/empty result set reads as ruled stationery, not
+     * a void. Pairs with the app-side pre-ruled empty-rows fill. Default off.
+     */
+    ruled?: boolean;
+    className?: string;
+};
+export declare function EmptyState({ icon: Icon, title, description, action, ruled, className }: EmptyStateProps): import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/enterprise/empty-state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/enterprise/empty-state/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtC,MAAM,MAAM,eAAe,GAAG;IAC5B,gDAAgD;IAChD,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,wBAAgB,UAAU,CAAC,EACzB,IAAI,EAAE,IAAY,EAClB,KAAK,EACL,WAAW,EACX,MAAM,EACN,KAAa,EACb,SAAS,EACV,EAAE,eAAe,+BA6CjB"}

package/dist/esm/enterprise/empty-state/index.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Inbox } from 'lucide-react';
+import { LABEL_VOICE_CLASS } from '../../lib/typography.js';
+import { cn } from '../../lib/utils.js';
+export function EmptyState({ icon: Icon = Inbox, title, description, action, ruled = false, className }) {
+    if (ruled) {
+        return (_jsxs("div", { "data-variant": "ruled", className: cn('border-border flex flex-col items-start gap-2 border-t px-3 py-6 text-left', className), children: [_jsxs("div", { className: "text-muted-foreground flex items-center gap-2", children: [_jsx(Icon, { className: "size-4", "aria-hidden": true }), _jsx("span", { className: LABEL_VOICE_CLASS, children: title })] }), description ? (_jsx("p", { className: "text-muted-foreground max-w-prose text-sm", children: description })) : null, action ? _jsx("div", { className: "mt-1", children: action }) : null] }));
+    }
+    return (_jsxs("div", { className: cn('flex flex-col items-center justify-center gap-3 px-6 py-16 text-center', className), children: [_jsx("div", { className: "bg-muted flex size-11 items-center justify-center rounded-full", children: _jsx(Icon, { className: "text-muted-foreground size-5", "aria-hidden": true }) }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-foreground text-sm font-medium", children: title }), description ? (_jsx("p", { className: "text-muted-foreground mx-auto max-w-sm text-sm", children: description })) : null] }), action ? _jsx("div", { className: "mt-2", children: action }) : null] }));
+}

package/dist/esm/enterprise/index.d.ts

@@ -0,0 +1,26 @@
+export { AlertBanner } from './alert-banner/index.js';
+export type { AlertBannerProps, AlertBannerTone } from './alert-banner/index.js';
+export { AppShell } from './app-shell/index.js';
+export type { AppShellProps } from './app-shell/index.js';
+export { CursorPager } from './cursor-pager/index.js';
+export type { CursorPagerProps } from './cursor-pager/index.js';
+export { DataTable } from './data-table/index.js';
+export type { DataTableProps } from './data-table/index.js';
+export { DateRangePicker } from './date-range-picker/index.js';
+export type { DateRangePickerProps, DateRangeValue } from './date-range-picker/index.js';
+export { DetailPanel } from './detail-panel/index.js';
+export type { DetailPanelProps } from './detail-panel/index.js';
+export { EmptyState } from './empty-state/index.js';
+export type { EmptyStateProps } from './empty-state/index.js';
+export { NumberInput } from './number-input/index.js';
+export type { NumberInputProps } from './number-input/index.js';
+export { SearchInput } from './search-input/index.js';
+export type { SearchInputProps } from './search-input/index.js';
+export { StatCard } from './stat-card/index.js';
+export type { StatCardProps, StatCardRow, StatCardTone } from './stat-card/index.js';
+export { DEFAULT_STATUS_VARIANTS, StatusBadge } from './status-badge/index.js';
+export type { StatusBadgeProps } from './status-badge/index.js';
+export { VirtualizedTable } from './virtualized-table/index.js';
+export type { VirtualizedTableProps } from './virtualized-table/index.js';
+export { useIsMobile } from './use-is-mobile.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/enterprise/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/enterprise/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEvE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAE/E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE3E,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACrE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA"}

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;AAO9B,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,CAUpE;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,qBAwIlB"}

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

@@ -0,0 +1,200 @@
+'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 { 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(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);
+    return Number.isNaN(parsed) ? null : parsed;
+}
+/**
+ * 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('');
+    const formatter = React.useMemo(() => new Intl.NumberFormat(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 * step, base, step), 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"}