@dashforge/tw 0.11.0-beta → 1.0.0

package/dist/components/Table/table.types.d.ts

@@ -0,0 +1,399 @@
+import type { ReactNode } from 'react';
+import type { AccessRequirement } from '@dashforge/rbac';
+import type { TableVariants } from './table.variants.js';
+/**
+ * Type-level dotted path through an object's nested structure.
+ *
+ * `NestedKeyOf<{ user: { name: string } }>` → `'user' | 'user.name'`.
+ *
+ * Used as the `field` of a column to give autocomplete on nested
+ * paths. The runtime lookup happens via `getNestedValue` in
+ * `_internal/getNestedValue.ts` (split on `.` and walk).
+ */
+export type NestedKeyOf<T extends object> = {
+    [K in keyof T & (string | number)]: T[K] extends object | undefined ? T[K] extends ReadonlyArray<unknown> ? `${K}` : NonNullable<T[K]> extends object ? `${K}` | `${K}.${NestedKeyOf<NonNullable<T[K]>>}` : `${K}` : `${K}`;
+}[keyof T & (string | number)];
+/**
+ * Auto-detected primitive type for a column. Drives smart defaults:
+ *  - `number`  → align right + monospace (`tabular-nums`)
+ *  - `date`    → align left + monospace (consistent ISO width)
+ *  - `boolean` → align center
+ *  - `string`  → align left (default)
+ *  - `unknown` → fallback to left, no monospace
+ */
+export type TableColumnInferredType = 'number' | 'date' | 'boolean' | 'string' | 'unknown';
+/**
+ * Context passed to a custom `cellRenderer`. Mirrors what the consumer
+ * needs to render a cell: row, resolved value, position, selection
+ * state, expand state, and the resolved RBAC access state for THIS
+ * column.
+ */
+export interface TableCellContext<T> {
+    row: T;
+    value: unknown;
+    rowIndex: number;
+    isSelected: boolean;
+    isExpanded: boolean;
+    /** Resolved RBAC state for this column. `null` if no `access` set. */
+    access: {
+        hidden: boolean;
+        disabled: boolean;
+        readonly: boolean;
+    } | null;
+}
+/**
+ * One column definition for `<Table>`.
+ *
+ * **i18n**: pass `t('users.name')` directly to `header` — `header`
+ * accepts `string` for the common case. Use the function form
+ * `header: () => <span>…</span>` only when you need richer JSX.
+ *
+ * **Smart defaults**: when `align` / `monospace` are omitted, the
+ * Table auto-detects the column type from the first non-null value
+ * across the visible rows and applies `right + tabular-nums` for
+ * numbers, `center` for booleans, etc. Explicit props always win.
+ */
+export interface TableColumn<T extends object> {
+    /**
+     * Dotted path to the value in each row. Supports nested keys
+     * (`'address.city.zipCode'`) thanks to `NestedKeyOf<T>` typing +
+     * runtime `getNestedValue()`.
+     */
+    field: NestedKeyOf<T> | (string & {});
+    /**
+     * Visible header. Pass a translation string directly:
+     * `header: t('users.name')`. Use the function form for richer
+     * JSX (e.g. header with an icon).
+     */
+    header: string | (() => ReactNode);
+    /** Pixel width (`px`). Mutually informative with `flex`. */
+    width?: number;
+    /** Flex grow factor (CSS `flex: <n> 1 0`). */
+    flex?: number;
+    /** Minimum pixel width (for resizable columns — deferred to v1-bis). */
+    minWidth?: number;
+    /**
+     * Horizontal alignment. Default is auto-detected from value type
+     * (number → right, boolean → center, otherwise left).
+     */
+    align?: 'left' | 'right' | 'center';
+    /**
+     * Opt-in to a monospace **font family** for this column. The
+     * library never auto-applies `font-mono` — it would override the
+     * consumer's theme `font-sans`. Set `true` explicitly only when
+     * the design calls for a typewriter font (e.g. raw hex IDs).
+     *
+     * The dashforgePreset does NOT own the `fontFamily` axis; the
+     * consumer configures the mono stack in their own
+     * `tailwind.config.ts` (`theme.extend.fontFamily.mono`).
+     */
+    monospace?: boolean;
+    /**
+     * Apply `font-variant-numeric: tabular-nums` so every digit
+     * occupies the same width — clean alignment for currency / metric
+     * columns. Does NOT change the font family. Auto-applied for
+     * `number` and `date` columns; pass `false` explicitly to opt out
+     * or `true` to force on a string column.
+     */
+    tabularNums?: boolean;
+    /**
+     * Make the column sortable. Pass `true` for default comparator
+     * (works for string/number/date/boolean) or a custom
+     * `(a, b) => number`.
+     */
+    sortable?: boolean | ((a: T, b: T) => number);
+    /**
+     * Include this column in the global search filter.
+     * @default false
+     */
+    searchable?: boolean;
+    /**
+     * Enable per-column quick filter UI in the column header.
+     * @default false
+     */
+    filterable?: boolean;
+    /**
+     * Override the filter UI type. By default the type is auto-detected
+     * from `useColumnAutoDetect` (number → range, date → range,
+     * boolean → select, anything else → text contains). Force a
+     * specific UI when the autodetect picks the wrong one — e.g. an
+     * ID column stored as a number that should filter by text contains.
+     */
+    filterType?: TableFilterType;
+    /**
+     * Custom cell renderer. Receives the full row + the resolved
+     * (potentially nested) value, the row index, selection state,
+     * expansion state, and the RBAC access state.
+     */
+    cellRenderer?: (ctx: TableCellContext<T>) => ReactNode;
+    /**
+     * Per-column RBAC. `onUnauthorized: 'hide'` removes the column
+     * entirely from header AND every row cell (a11y-correct).
+     * `disable` / `readonly` are forwarded to `cellRenderer` via
+     * `ctx.access` — the renderer is expected to honor them.
+     */
+    access?: AccessRequirement;
+    /**
+     * Pin this column during horizontal scroll. `'left'` (DataGrid v1)
+     * uses CSS `position: sticky; left: 0`. `'right'` is reserved for
+     * v1-bis (CSS edge cases around last-column borders). Table
+     * (non-virtualized) ignores this prop today — only DataGrid honors
+     * it (Sprint 4.2).
+     */
+    sticky?: 'left' | 'right';
+    /**
+     * Allow user to hide this column from the column-visibility dialog.
+     * Pass `false` for structurally required columns (e.g. an ID column).
+     * @default true
+     */
+    hideable?: boolean;
+    /** Hidden on first render (the user can re-show via the dialog). */
+    defaultHidden?: boolean;
+    /**
+     * Allow user to resize this column by dragging the right edge of
+     * its header. Pass `false` to opt out per-column. The grid-level
+     * `enableColumnResize` flag must also be on (default `true`).
+     * @default true
+     */
+    resizable?: boolean;
+    /** Maximum width (px) honored by the resize drag. */
+    maxWidth?: number;
+    /**
+     * Allow user to reorder this column by dragging its header. Pass
+     * `false` to pin its position. The grid-level `enableColumnReorder`
+     * flag must also be on (default `true`).
+     * @default true
+     */
+    reorderable?: boolean;
+}
+export type TableSortDirection = 'asc' | 'desc';
+export interface TableSortItem {
+    field: string;
+    direction: TableSortDirection;
+}
+/**
+ * Sort model. Single-column sort = array of length 1. Multi-column
+ * sort = array of N (typically up to 3). The order matters: first
+ * item is the primary sort key, subsequent items break ties.
+ */
+export type TableSortModel = TableSortItem[];
+/**
+ * Filter operator. The value shape depends on the operator:
+ *  - `contains` → `value: string` (text substring match)
+ *  - `equals` → `value: unknown` (exact match, used for booleans)
+ *  - `between` → `value: [min, max]` where each end can be `null`
+ *    for an open range. Used for number ranges (`value: [10, 50]`)
+ *    and date ranges (`value: ['2024-01-01', '2024-12-31']` as ISO).
+ */
+export type TableFilterOperator = 'contains' | 'equals' | 'between';
+export interface TableFilterItem {
+    field: string;
+    op: TableFilterOperator;
+    value: unknown;
+}
+export type TableFilterModel = TableFilterItem[];
+/**
+ * Column-level filter type hint. Determines which filter UI to
+ * render in the column header Popover. Auto-detected from
+ * `useColumnAutoDetect` when omitted:
+ *
+ *  - `number` → number range filter
+ *  - `date` → date range filter
+ *  - `boolean` → true/false/all select
+ *  - `string` (or anything else) → text contains
+ */
+export type TableFilterType = 'text' | 'number' | 'boolean' | 'date';
+export type TableRowSelectionMode = 'none' | 'single' | 'multiple';
+/**
+ * Internal default strings used by the Table for accessibility
+ * announcements, density toggle, search placeholder, etc. Pass the
+ * subset you need to translate; the rest fall back to English.
+ *
+ * For column headers, empty state, bulk actions and row action
+ * labels — pass the translated value directly via the matching
+ * prop (`header`, `emptyState`, `bulkActions`, `rowActions`).
+ */
+export interface TableLabels {
+    searchPlaceholder?: string;
+    /** Shown when the dataset itself is empty (0 input rows). */
+    noData?: string;
+    /**
+     * Shown when the dataset has rows but an active search / filter
+     * excluded them all. Distinct from `noData` so the user can tell
+     * "nothing here" from "nothing matches your query".
+     */
+    noResults?: string;
+    loading?: string;
+    ariaSortNone?: string;
+    ariaSortAscending?: string;
+    ariaSortDescending?: string;
+    ariaSelectRow?: string;
+    ariaSelectAllRows?: string;
+    ariaExpandRow?: string;
+    ariaCollapseRow?: string;
+    /** "X selected" — `{count}` placeholder gets replaced. */
+    selectedCount?: string;
+    clearSelection?: string;
+    /** Per-column filter Popover. */
+    filterColumn?: string;
+    filterApply?: string;
+    filterClear?: string;
+    /** Number / date range filter inputs. */
+    filterMin?: string;
+    filterMax?: string;
+    filterFrom?: string;
+    filterTo?: string;
+    /** Boolean filter radio options. */
+    filterAll?: string;
+    filterTrue?: string;
+    filterFalse?: string;
+    /** Density toggle. */
+    density?: string;
+    densityCompact?: string;
+    densityComfortable?: string;
+    densitySpacious?: string;
+    /** Column visibility menu (Popover-based, auto-commit). */
+    columnsButton?: string;
+    columnsTitle?: string;
+    /** Aria-label for the tri-state show/hide-all master checkbox. */
+    columnsToggleAll?: string;
+}
+export interface TableSlotProps {
+    root?: {
+        className?: string;
+    };
+    toolbar?: {
+        className?: string;
+    };
+    search?: {
+        className?: string;
+    };
+    scroll?: {
+        className?: string;
+    };
+    table?: {
+        className?: string;
+    };
+    thead?: {
+        className?: string;
+    };
+    tbody?: {
+        className?: string;
+    };
+    headerRow?: {
+        className?: string;
+    };
+    headerCell?: {
+        className?: string;
+    };
+    row?: {
+        className?: string;
+    };
+    cell?: {
+        className?: string;
+    };
+    emptyState?: {
+        className?: string;
+    };
+    loadingOverlay?: {
+        className?: string;
+    };
+    selectionCell?: {
+        className?: string;
+    };
+    expandToggleCell?: {
+        className?: string;
+    };
+    expandedRow?: {
+        className?: string;
+    };
+    rowActionsCell?: {
+        className?: string;
+    };
+    bulkActionFooter?: {
+        className?: string;
+    };
+}
+export interface TableExpandableConfig<T> {
+    render: (row: T) => ReactNode;
+    expandedRowIds?: string[];
+    onExpandChange?: (ids: string[]) => void;
+}
+/**
+ * Props for `<Table>`.
+ *
+ * Hybrid declarative-first architecture: by default every state piece
+ * (sort, filter, search, selection, expansion) is internal. Pass the
+ * matching controlled prop + change handler to lift state up.
+ *
+ * Smart defaults: column types are auto-detected on first render —
+ * number columns get right-align + tabular-nums, dates get monospace,
+ * booleans get center-align, etc. Override via explicit `align` /
+ * `monospace` per column.
+ *
+ * Visual style: Stripe-inspired clean lines by default
+ * (`variant="lines"`), row actions revealed on hover, sticky header,
+ * `comfortable` density. Switch via variant / density / size props.
+ *
+ * i18n: column `header` accepts plain strings (use `t('...')`
+ * directly). All internal label strings configurable via `labels`
+ * prop with English defaults.
+ */
+export interface TableProps<T extends object> extends Pick<TableVariants, 'variant' | 'size' | 'density'> {
+    rows: T[];
+    cols: TableColumn<T>[];
+    /**
+     * Stable row-id resolver — the React key + the identity used by
+     * selection and row-expansion state.
+     *
+     * **Strongly recommended whenever sort / search / selection /
+     * expandable rows are used.** The default falls back to the
+     * positional index (`String(index)`); once rows reorder (sort) or
+     * change presence (search / filter), index `2` points at a
+     * *different* row, so selection and expansion state silently jump
+     * to the wrong rows. Pass a value derived from the data itself:
+     *
+     * ```tsx
+     * <Table getRowId={(row) => row.id} … />
+     * ```
+     *
+     * Dashforge emits a `console.warn` in development when `getRowId`
+     * is omitted and one of those features is active. (`<DataGrid>`
+     * makes this prop required for the same reason.)
+     */
+    getRowId?: (row: T, index: number) => string;
+    sortModel?: TableSortModel;
+    onSortChange?: (model: TableSortModel) => void;
+    /** Default sort applied when uncontrolled. */
+    defaultSortModel?: TableSortModel;
+    enableSearch?: boolean;
+    searchQuery?: string;
+    onSearchQueryChange?: (q: string) => void;
+    searchPlaceholder?: string;
+    searchDebounceMs?: number;
+    filterModel?: TableFilterModel;
+    onFilterChange?: (model: TableFilterModel) => void;
+    rowSelection?: TableRowSelectionMode;
+    selectedRowIds?: string[];
+    onSelectionChange?: (ids: string[]) => void;
+    /** Sticky bulk action footer (visible only when selection > 0). */
+    bulkActions?: (selectedRows: T[]) => ReactNode;
+    expandable?: TableExpandableConfig<T>;
+    rowActions?: (row: T) => ReactNode;
+    loading?: boolean;
+    /** Number of skeleton rows shown while `loading=true`. @default 5 */
+    loadingRowCount?: number;
+    emptyState?: ReactNode;
+    /** Sticky header. @default true */
+    stickyHeader?: boolean;
+    /** Optional caption for screen readers. */
+    caption?: ReactNode;
+    /** Renders the caption visually too (otherwise sr-only). @default false */
+    showCaption?: boolean;
+    /** Table-level RBAC. `hide` returns null; `disable` greys everything. */
+    access?: AccessRequirement;
+    labels?: TableLabels;
+    sx?: string;
+    slotProps?: TableSlotProps;
+}
+//# sourceMappingURL=table.types.d.ts.map

package/dist/components/Table/table.types.d.ts.map

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

package/dist/components/Table/table.variants.d.ts

@@ -0,0 +1,285 @@
+import { type VariantProps } from 'tailwind-variants';
+/**
+ * `<Table>` variant recipe.
+ *
+ * Slots:
+ *  - `root`              — outer wrapper
+ *  - `toolbar`           — search + filter chips row above table
+ *  - `search`            — search input
+ *  - `scroll`            — `<div class="overflow-auto">` wrapping the table
+ *  - `table`             — `<table>` element
+ *  - `thead`             — `<thead>` (sticky positioning here)
+ *  - `tbody`             — `<tbody>`
+ *  - `headerRow`         — `<tr>` inside `<thead>`
+ *  - `headerCell`        — `<th>` cell
+ *  - `headerCellButton`  — `<button>` inside sortable `<th>`
+ *  - `row`               — `<tr>` inside `<tbody>` (data row)
+ *  - `cell`              — `<td>` data cell
+ *  - `selectionCell`     — first `<td>` when selection mode active
+ *  - `expandToggleCell`  — second `<td>` when expandable active
+ *  - `expandedRow`       — full-width `<tr>` rendered after an expanded row
+ *  - `rowActionsCell`    — last `<td>` when `rowActions` provided
+ *  - `emptyState`        — placeholder when rows is empty
+ *  - `loadingOverlay`    — skeleton overlay when loading
+ *  - `bulkActionFooter`  — sticky footer with bulk actions
+ *
+ * Variant axes:
+ *  - `variant` — visual row-division style:
+ *      - `plain`    — minimal separators
+ *      - `lines`    — Stripe-style thin horizontal dividers (default)
+ *      - `striped`  — alternating row backgrounds (zebra)
+ *      - `bordered` — full cell borders
+ *      - `card`     — each row rendered as a separate surface card
+ *  - `size`    — `sm` / `md` (default) / `lg`
+ *  - `density` — `compact` (40px row) / `comfortable` (default 48px) / `spacious` (56px)
+ *
+ * Smart-default alignment (per column) is applied by the Table
+ * component code, NOT here — it depends on the runtime-detected
+ * value type, which the recipe doesn't see.
+ *
+ * **Dashforge identity rule** (memory: `feedback_dashforge_preset_is_identity`):
+ * This recipe uses NO `dark:` variants on the neutral palette. The
+ * `dashforgePreset()` CSS-variable swap auto-inverts neutral tokens
+ * (`bg-neutral-50` is light surface in light mode, dark surface in
+ * dark mode — same class, different physical color). Adding a
+ * `dark:` variant on neutral palette = DOUBLE inversion = breaks
+ * dark mode. The selected-row state uses the canonical LeftNav
+ * `itemActive` pattern (`bg-primary-100 text-primary-900 font-medium`),
+ * which works in both modes because the primary palette has no
+ * inversion (both `bg` and `text` resolve to the same physical
+ * colors regardless of mode → guaranteed contrast).
+ */
+export declare const tableVariants: import("tailwind-variants").TVReturnType<{
+    variant: {
+        plain: {};
+        lines: {};
+        striped: {
+            row: string;
+        };
+        bordered: {
+            table: string;
+            cell: string;
+            headerCell: string;
+        };
+        card: {
+            scroll: string;
+            table: string;
+            row: 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;
+        };
+    };
+    stickyHeader: {
+        true: {
+            thead: string;
+        };
+        false: {};
+    };
+}, {
+    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;
+    expandToggleCell: string;
+    expandedRow: string;
+    rowActionsCell: string[];
+    emptyState: string[];
+    loadingOverlay: string[];
+    bulkActionFooter: string[];
+}, undefined, {
+    variant: {
+        plain: {};
+        lines: {};
+        striped: {
+            row: string;
+        };
+        bordered: {
+            table: string;
+            cell: string;
+            headerCell: string;
+        };
+        card: {
+            scroll: string;
+            table: string;
+            row: 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;
+        };
+    };
+    stickyHeader: {
+        true: {
+            thead: string;
+        };
+        false: {};
+    };
+}, {
+    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;
+    expandToggleCell: string;
+    expandedRow: string;
+    rowActionsCell: string[];
+    emptyState: string[];
+    loadingOverlay: string[];
+    bulkActionFooter: string[];
+}, import("tailwind-variants").TVReturnType<{
+    variant: {
+        plain: {};
+        lines: {};
+        striped: {
+            row: string;
+        };
+        bordered: {
+            table: string;
+            cell: string;
+            headerCell: string;
+        };
+        card: {
+            scroll: string;
+            table: string;
+            row: 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;
+        };
+    };
+    stickyHeader: {
+        true: {
+            thead: string;
+        };
+        false: {};
+    };
+}, {
+    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;
+    expandToggleCell: string;
+    expandedRow: string;
+    rowActionsCell: string[];
+    emptyState: string[];
+    loadingOverlay: string[];
+    bulkActionFooter: string[];
+}, undefined, unknown, unknown, undefined>>;
+export type TableVariants = VariantProps<typeof tableVariants>;
+//# sourceMappingURL=table.variants.d.ts.map

package/dist/components/Table/table.variants.d.ts.map

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