@dashforge/tw 0.10.0-beta → 1.0.0

package/dist/components/DataGrid/dataGrid.variants.d.ts

@@ -0,0 +1,222 @@
+import { type VariantProps } from 'tailwind-variants';
+/**
+ * `<DataGrid>` variant recipe.
+ *
+ * Sibling of `tableVariants` — shares the same visual axes (variant /
+ * size / density) and the same identity-rule patterns:
+ *  - No `dark:` variants on neutral palette (auto-invert via the
+ *    dashforgePreset() CSS var swap).
+ *  - Selected row uses LeftNav `itemActive` pattern
+ *    (`bg-primary-100 text-primary-900`) — guaranteed contrast.
+ *  - Hover uses one-tier elevation (`bg-neutral-100`).
+ *
+ * DataGrid-specific slot additions vs Table:
+ *  - `stickyLeftCell` — column that uses `cols[i].sticky === 'left'`.
+ *    Z-index ordering: `thead` (z-10) < `stickyLeftCell` (z-11) <
+ *    `header × stickyLeft top-left corner cell` (z-20).
+ *  - `paginationFooter` — wraps the optional `<Pagination>`.
+ */
+export declare const dataGridVariants: import("tailwind-variants").TVReturnType<{
+    variant: {
+        plain: {};
+        lines: {};
+        striped: {
+            row: string;
+        };
+        bordered: {
+            table: string;
+            cell: string;
+            headerCell: string;
+        };
+    };
+    size: {
+        sm: {
+            headerCell: string;
+            cell: string;
+            search: string;
+        };
+        md: {
+            headerCell: string;
+            cell: string;
+            search: string;
+        };
+        lg: {
+            headerCell: string;
+            cell: string;
+            search: string;
+        };
+    };
+    density: {
+        compact: {
+            headerCell: string;
+            cell: string;
+        };
+        comfortable: {
+            headerCell: string;
+            cell: string;
+        };
+        spacious: {
+            headerCell: string;
+            cell: string;
+        };
+    };
+}, {
+    root: string;
+    toolbar: string;
+    search: string[];
+    scroll: string;
+    table: string;
+    thead: string;
+    tbody: string;
+    headerRow: string;
+    headerCell: string[];
+    headerCellButton: string[];
+    row: string[];
+    cell: string[];
+    selectionCell: string;
+    rowActionsCell: string[];
+    emptyState: string;
+    loadingOverlay: string;
+    bulkActionFooter: string[];
+    stickyLeftCell: string;
+    stickyLeftHeaderCell: string;
+    stickyRightCell: string;
+    stickyRightHeaderCell: string;
+    paginationFooter: string;
+}, undefined, {
+    variant: {
+        plain: {};
+        lines: {};
+        striped: {
+            row: string;
+        };
+        bordered: {
+            table: string;
+            cell: string;
+            headerCell: string;
+        };
+    };
+    size: {
+        sm: {
+            headerCell: string;
+            cell: string;
+            search: string;
+        };
+        md: {
+            headerCell: string;
+            cell: string;
+            search: string;
+        };
+        lg: {
+            headerCell: string;
+            cell: string;
+            search: string;
+        };
+    };
+    density: {
+        compact: {
+            headerCell: string;
+            cell: string;
+        };
+        comfortable: {
+            headerCell: string;
+            cell: string;
+        };
+        spacious: {
+            headerCell: string;
+            cell: string;
+        };
+    };
+}, {
+    root: string;
+    toolbar: string;
+    search: string[];
+    scroll: string;
+    table: string;
+    thead: string;
+    tbody: string;
+    headerRow: string;
+    headerCell: string[];
+    headerCellButton: string[];
+    row: string[];
+    cell: string[];
+    selectionCell: string;
+    rowActionsCell: string[];
+    emptyState: string;
+    loadingOverlay: string;
+    bulkActionFooter: string[];
+    stickyLeftCell: string;
+    stickyLeftHeaderCell: string;
+    stickyRightCell: string;
+    stickyRightHeaderCell: string;
+    paginationFooter: string;
+}, import("tailwind-variants").TVReturnType<{
+    variant: {
+        plain: {};
+        lines: {};
+        striped: {
+            row: string;
+        };
+        bordered: {
+            table: string;
+            cell: string;
+            headerCell: string;
+        };
+    };
+    size: {
+        sm: {
+            headerCell: string;
+            cell: string;
+            search: string;
+        };
+        md: {
+            headerCell: string;
+            cell: string;
+            search: string;
+        };
+        lg: {
+            headerCell: string;
+            cell: string;
+            search: string;
+        };
+    };
+    density: {
+        compact: {
+            headerCell: string;
+            cell: string;
+        };
+        comfortable: {
+            headerCell: string;
+            cell: string;
+        };
+        spacious: {
+            headerCell: string;
+            cell: string;
+        };
+    };
+}, {
+    root: string;
+    toolbar: string;
+    search: string[];
+    scroll: string;
+    table: string;
+    thead: string;
+    tbody: string;
+    headerRow: string;
+    headerCell: string[];
+    headerCellButton: string[];
+    row: string[];
+    cell: string[];
+    selectionCell: string;
+    rowActionsCell: string[];
+    emptyState: string;
+    loadingOverlay: string;
+    bulkActionFooter: string[];
+    stickyLeftCell: string;
+    stickyLeftHeaderCell: string;
+    stickyRightCell: string;
+    stickyRightHeaderCell: string;
+    paginationFooter: string;
+}, undefined, unknown, unknown, undefined>>;
+export type DataGridVariants = VariantProps<typeof dataGridVariants>;
+//# sourceMappingURL=dataGrid.variants.d.ts.map

package/dist/components/DataGrid/dataGrid.variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataGrid.variants.d.ts","sourceRoot":"","sources":["../../../src/components/DataGrid/dataGrid.variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAkI3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/components/DataGrid/filters/ColumnFilters.d.ts

@@ -0,0 +1,23 @@
+import type { TableFilterModel, TableFilterType } from '../../Table/table.types.js';
+export interface ColumnFilterLabels {
+    filterColumn?: string;
+    filterApply?: string;
+    filterClear?: string;
+    filterMin?: string;
+    filterMax?: string;
+    filterFrom?: string;
+    filterTo?: string;
+    filterAll?: string;
+    filterTrue?: string;
+    filterFalse?: string;
+}
+export interface ColumnFilterTriggerProps {
+    field: string;
+    filterType: TableFilterType;
+    filterModel: TableFilterModel;
+    onFilterChange: (model: TableFilterModel) => void;
+    disabled?: boolean;
+    labels?: ColumnFilterLabels;
+}
+export declare function ColumnFilterTrigger(props: ColumnFilterTriggerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ColumnFilters.d.ts.map

package/dist/components/DataGrid/filters/ColumnFilters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColumnFilters.d.ts","sourceRoot":"","sources":["../../../../src/components/DataGrid/filters/ColumnFilters.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,gBAAgB,EAChB,eAAe,EAChB,MAAM,4BAA4B,CAAC;AAqDpC,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAiBD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,CAAC;IAC5B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,cAAc,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,2CAkDlE"}

package/dist/components/DataGrid/reorder/useColumnReorder.d.ts

@@ -0,0 +1,50 @@
+import { type DragEvent } from 'react';
+/**
+ * Native HTML5 drag-and-drop reorder for DataGrid column headers.
+ *
+ * Zero new runtime deps — uses the browser's built-in drag events.
+ * The hook returns handler factories you wire onto each `<th>` plus
+ * a `dropTarget` state used to render the visual indicator (a left
+ * or right border on the hovered column).
+ *
+ *  - `dragStart(field)` → onDragStart; stashes source field in a ref
+ *    + sets `dataTransfer.effectAllowed = 'move'`.
+ *  - `dragOver(field)` → onDragOver; preventDefault + computes
+ *    whether the cursor is over the LEFT or RIGHT half of the
+ *    target → updates dropTarget so the indicator renders.
+ *  - `drop(field)` → onDrop; computes the new order array via
+ *    `moveColumn(source, target, side)` and commits it.
+ *  - `dragEnd()` → onDragEnd; clears state.
+ *
+ * Reorder math: when dropping `source` onto the LEFT half of
+ * `target`, the source is inserted BEFORE the target's position
+ * in the order list. RIGHT half → AFTER.
+ */
+export interface UseColumnReorderArgs {
+    /** The current order. */
+    order: string[];
+    /** Commit a new order. */
+    onChange: (next: string[]) => void;
+}
+export interface DropTarget {
+    field: string;
+    side: 'left' | 'right';
+}
+export interface ColumnReorderHandlers {
+    /** Current drop target (used by the renderer to show the indicator). */
+    dropTarget: DropTarget | null;
+    /** Field currently being dragged (used to dim the source header). */
+    draggingField: string | null;
+    dragStart: (field: string) => (e: DragEvent<HTMLElement>) => void;
+    dragOver: (field: string) => (e: DragEvent<HTMLElement>) => void;
+    drop: (field: string) => (e: DragEvent<HTMLElement>) => void;
+    dragEnd: () => void;
+}
+export declare function useColumnReorder(args: UseColumnReorderArgs): ColumnReorderHandlers;
+/**
+ * Move `source` next to `target` in the `order` list.
+ * `side='left'` inserts before; `side='right'` inserts after.
+ * Exposed for unit testing.
+ */
+export declare function moveColumn(order: string[], source: string, target: string, side: 'left' | 'right'): string[];
+//# sourceMappingURL=useColumnReorder.d.ts.map

package/dist/components/DataGrid/reorder/useColumnReorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useColumnReorder.d.ts","sourceRoot":"","sources":["../../../../src/components/DataGrid/reorder/useColumnReorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,0BAA0B;IAC1B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,qEAAqE;IACrE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAClE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACjE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC7D,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,oBAAoB,GACzB,qBAAqB,CA+DvB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GAAG,OAAO,GACrB,MAAM,EAAE,CAUV"}

package/dist/components/DataGrid/resize/useColumnResize.d.ts

@@ -0,0 +1,39 @@
+import { type PointerEvent as RPointerEvent } from 'react';
+/**
+ * Native column-resize behavior for DataGrid (and Table later if
+ * promoted to `_shared`).
+ *
+ * The returned `startResize` is wired to a `pointerdown` handler on a
+ * thin grabber positioned at the right edge of a `<th>`. We capture
+ * the pointer on the target element so `pointermove` / `pointerup`
+ * keep flowing even if the cursor leaves the grabber.
+ *
+ * Why native pointer events vs a drag library:
+ *  - Zero new runtime deps (sprint constraint)
+ *  - Pointer events normalize mouse/touch/pen out of the box
+ *  - Pointer capture means we don't have to track the global
+ *    `mousemove` / `mouseup` — the browser routes events to our
+ *    listener until release.
+ */
+export interface UseColumnResizeArgs {
+    /** Current column widths (Record<field, px>). */
+    widths: Record<string, number>;
+    /** Commit a new width map. */
+    onChange: (next: Record<string, number>) => void;
+    /** Hard floor for any column (px). @default 40 */
+    minWidth?: number;
+    /** Hard ceiling for any column (px). @default 1200 */
+    maxWidth?: number;
+}
+export interface ColumnResizeHandlers {
+    startResize: (field: string, startWidth: number, clampMin: number, clampMax: number) => (e: RPointerEvent<HTMLElement>) => void;
+    /**
+     * Commit a single clamped width delta — the keyboard-resize path.
+     * Wired to ArrowLeft/ArrowRight on the focused resize handle so the
+     * feature is reachable without a pointer (WCAG 2.1 — keyboard
+     * operability). Same clamping as the drag path.
+     */
+    nudge: (field: string, currentWidth: number, delta: number, clampMin: number, clampMax: number) => void;
+}
+export declare function useColumnResize(args: UseColumnResizeArgs): ColumnResizeHandlers;
+//# sourceMappingURL=useColumnResize.d.ts.map

package/dist/components/DataGrid/resize/useColumnResize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useColumnResize.d.ts","sourceRoot":"","sources":["../../../../src/components/DataGrid/resize/useColumnResize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,YAAY,IAAI,aAAa,EAAE,MAAM,OAAO,CAAC;AAEhF;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,8BAA8B;IAC9B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IACjD,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,CACX,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,KACb,CAAC,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC7C;;;;;OAKG;IACH,KAAK,EAAE,CACL,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,KACb,IAAI,CAAC;CACX;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,oBAAoB,CA4E/E"}

package/dist/components/DataGrid/visibility/ColumnVisibilityMenu.d.ts

@@ -0,0 +1,44 @@
+import type { TableColumn } from '../../Table/table.types.js';
+/**
+ * Column visibility menu for DataGrid.
+ *
+ * Renders a toolbar button (the trigger) that opens a `<Popover>`
+ * with one checkbox per `hideable` column. Auto-commits on every
+ * toggle — there's no draft / commit step. Outside-click and Esc
+ * close the popover (Radix-managed).
+ *
+ * UX rationale for Popover-over-Dialog:
+ *  - Lightweight, non-modal: the user can keep referring to the grid
+ *    while picking columns. A modal Dialog would interrupt the flow.
+ *  - Auto-commit reads as a "settings panel" rather than a
+ *    "configuration form" — matches AG-Grid / MUI DataGrid v6 /
+ *    TanStack examples.
+ *  - No focus trap on the rest of the page; the user can scroll the
+ *    grid or click the column resize handles without dismissing the
+ *    panel first.
+ *
+ * Columns with `hideable: false` are NEVER shown in the menu —
+ * those are considered structurally required (e.g. an ID column).
+ *
+ * RBAC-hidden columns (`access.onUnauthorized === 'hide'`) are also
+ * excluded — they're already removed from `visibleCols` upstream.
+ */
+export interface ColumnVisibilityLabels {
+    columnsButton?: string;
+    columnsTitle?: string;
+    /**
+     * Accessible label for the tri-state master checkbox that
+     * shows/hides every hideable column at once. Not shown as visible
+     * text — surfaced to assistive tech via `aria-label`.
+     */
+    columnsToggleAll?: string;
+}
+export interface ColumnVisibilityTriggerProps<T extends object> {
+    cols: TableColumn<T>[];
+    hiddenColumns: string[];
+    onChange: (next: string[]) => void;
+    disabled?: boolean;
+    labels?: ColumnVisibilityLabels;
+}
+export declare function ColumnVisibilityTrigger<T extends object>(props: ColumnVisibilityTriggerProps<T>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ColumnVisibilityMenu.d.ts.map

package/dist/components/DataGrid/visibility/ColumnVisibilityMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColumnVisibilityMenu.d.ts","sourceRoot":"","sources":["../../../../src/components/DataGrid/visibility/ColumnVisibilityMenu.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAQD,MAAM,WAAW,4BAA4B,CAAC,CAAC,SAAS,MAAM;IAC5D,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,sBAAsB,CAAC;CACjC;AAED,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,EACtD,KAAK,EAAE,4BAA4B,CAAC,CAAC,CAAC,2CA2GvC"}

package/dist/components/DatePicker/DatePicker.d.ts

@@ -0,0 +1,14 @@
+import type { DatePickerProps } from './datePicker.types.js';
+/**
+ * Dashforge TW `<DatePicker>` — a form-bound single-date field.
+ *
+ * A read-only trigger button paired with a `<Calendar>` popover (Radix
+ * Popover — toggle / Escape / outside-click / focus-trap are Radix-managed).
+ * Integrates with the Dashforge form bridge + RBAC, mirroring the other
+ * `@dashforge/tw` form fields.
+ *
+ * Storage contract: an ISO `YYYY-MM-DD` string, or `null` — shared with the
+ * MUI `@dashforge/ui` `DatePicker`.
+ */
+export declare function DatePicker(props: DatePickerProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=DatePicker.d.ts.map

package/dist/components/DatePicker/DatePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/DatePicker.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAqD7D;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,kDAoOhD"}

package/dist/components/DatePicker/datePicker.types.d.ts

@@ -0,0 +1,88 @@
+import type { ReactNode } from 'react';
+import type { Engine } from '@dashforge/ui-core';
+import type { AccessRequirement } from '@dashforge/rbac';
+import type { ISODate, WeekDay } from '@dashforge/calendar-core';
+/** Per-slot `className` overrides for `<DatePicker>`. */
+export interface DatePickerSlotProps {
+    root?: {
+        className?: string;
+    };
+    label?: {
+        className?: string;
+    };
+    requiredMark?: {
+        className?: string;
+    };
+    trigger?: {
+        className?: string;
+    };
+    helperText?: {
+        className?: string;
+    };
+    errorText?: {
+        className?: string;
+    };
+}
+/**
+ * Props for the `<DatePicker>` form field (Tailwind skin).
+ *
+ * A read-only trigger button paired with a `<Calendar>` popover, integrated
+ * with the Dashforge form bridge + RBAC. The stored value is a plain ISO
+ * calendar date — `YYYY-MM-DD` — or `null`. (A pure date carries no time or
+ * timezone, which removes the whole class of DST round-trip hazards.)
+ *
+ * The prop surface mirrors the MUI `@dashforge/ui` `DatePicker` so the API
+ * is consistent across both ecosystems; only the styling escape hatches
+ * (`sx` / `slotProps`) follow the Tailwind conventions.
+ */
+export interface DatePickerProps {
+    /** Field name — the bridge registration key. Required. */
+    name: string;
+    /** Validation rules forwarded to the form bridge. */
+    rules?: unknown;
+    /** Field label. */
+    label?: ReactNode;
+    /** Helper text below the control (overrides a bridge error message). */
+    helperText?: ReactNode;
+    /** Explicit error state (overrides the bridge's auto error). */
+    error?: boolean;
+    /** Marks the field required (adds the label asterisk). */
+    required?: boolean;
+    /** Disables the field. */
+    disabled?: boolean;
+    /** Placeholder shown when no date is selected. */
+    placeholder?: string;
+    /** Label/control layout. */
+    layout?: 'stacked' | 'inline';
+    /** Reactive visibility predicate evaluated against the form engine. */
+    visibleWhen?: (engine: Engine) => boolean;
+    /** RBAC access requirement. */
+    access?: AccessRequirement;
+    /** Controlled value — ISO `YYYY-MM-DD` or `null`. */
+    value?: ISODate | null;
+    /** Uncontrolled initial value. */
+    defaultValue?: ISODate | null;
+    /** Fired with the new ISO date (or `null` when cleared). */
+    onChange?: (value: ISODate | null) => void;
+    /** Earliest selectable date (inclusive). */
+    minDate?: ISODate;
+    /** Latest selectable date (inclusive). */
+    maxDate?: ISODate;
+    /** Explicit list of disabled dates. */
+    disabledDates?: readonly ISODate[];
+    /** Predicate marking arbitrary dates disabled. */
+    isDateDisabled?: (date: ISODate) => boolean;
+    /** Weekday of the calendar's first column (`0` = Sunday). */
+    weekStartDay?: WeekDay;
+    /** BCP-47 locale for the calendar and the display format. */
+    locale?: string;
+    /** Stretches the field to its container width. */
+    fullWidth?: boolean;
+    /** Root-level Tailwind class override. */
+    sx?: string;
+    /** Per-slot `className` overrides. */
+    slotProps?: DatePickerSlotProps;
+    /** Test id applied to the field root. */
+    testId?: string;
+}
+//# sourceMappingURL=datePicker.types.d.ts.map

package/dist/components/DatePicker/datePicker.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datePicker.types.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/datePicker.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEjE,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mBAAmB;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,wEAAwE;IACxE,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC9B,uEAAuE;IACvE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,+BAA+B;IAC/B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,kCAAkC;IAClC,YAAY,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3C,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,aAAa,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACnC,kDAAkD;IAClD,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IAC5C,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0CAA0C;IAC1C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/components/DatePicker/datePicker.variants.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Slots for `<DatePicker>` — a bridge-integrated date field whose trigger
+ * is a `<button>` styled as an input, opening a `<Calendar>` popover.
+ *
+ * Theme identity: bare neutral / brand token-backed classes only — no
+ * `dark:` variants on the neutral palette (the preset CSS-var swap
+ * auto-inverts). See `_shared/themeIdentity.test.ts`.
+ */
+export declare const datePickerVariants: import("tailwind-variants").TVReturnType<{
+    layout: {
+        stacked: {};
+        inline: {
+            root: string;
+            label: string;
+        };
+    };
+    error: {
+        true: {
+            trigger: string;
+        };
+    };
+    fullWidth: {
+        true: {
+            root: string;
+            trigger: string;
+        };
+    };
+}, {
+    root: string;
+    label: string;
+    requiredMark: string;
+    trigger: string;
+    value: string;
+    placeholder: string;
+    icon: string;
+    helperText: string;
+    errorText: string;
+}, undefined, {
+    layout: {
+        stacked: {};
+        inline: {
+            root: string;
+            label: string;
+        };
+    };
+    error: {
+        true: {
+            trigger: string;
+        };
+    };
+    fullWidth: {
+        true: {
+            root: string;
+            trigger: string;
+        };
+    };
+}, {
+    root: string;
+    label: string;
+    requiredMark: string;
+    trigger: string;
+    value: string;
+    placeholder: string;
+    icon: string;
+    helperText: string;
+    errorText: string;
+}, import("tailwind-variants").TVReturnType<{
+    layout: {
+        stacked: {};
+        inline: {
+            root: string;
+            label: string;
+        };
+    };
+    error: {
+        true: {
+            trigger: string;
+        };
+    };
+    fullWidth: {
+        true: {
+            root: string;
+            trigger: string;
+        };
+    };
+}, {
+    root: string;
+    label: string;
+    requiredMark: string;
+    trigger: string;
+    value: string;
+    placeholder: string;
+    icon: string;
+    helperText: string;
+    errorText: string;
+}, undefined, unknown, unknown, undefined>>;
+//# sourceMappingURL=datePicker.variants.d.ts.map

package/dist/components/DatePicker/datePicker.variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datePicker.variants.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/datePicker.variants.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAuC7B,CAAC"}

package/dist/components/DateRangePicker/DateRangePicker.d.ts

@@ -0,0 +1,13 @@
+import type { DateRangePickerProps } from './dateRangePicker.types.js';
+/**
+ * Dashforge TW `<DateRangePicker>` — a form-bound start/end date field.
+ *
+ * A read-only trigger button paired with a dual-month range calendar popover
+ * (Radix Popover), built on the headless `useDateRange` engine. Integrates
+ * with the Dashforge form bridge + RBAC.
+ *
+ * Storage contract: a `{ start, end }` pair of ISO `YYYY-MM-DD` dates —
+ * shared with the MUI `@dashforge/ui` `DateRangePicker`.
+ */
+export declare function DateRangePicker(props: DateRangePickerProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=DateRangePicker.d.ts.map

package/dist/components/DateRangePicker/DateRangePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateRangePicker.d.ts","sourceRoot":"","sources":["../../../src/components/DateRangePicker/DateRangePicker.tsx"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAoQvE;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,kDAoN1D"}