@dashforge/tw 0.10.0-beta → 1.0.0

package/dist/components/ConfirmDialog/confirmDialog.types.d.ts

@@ -0,0 +1,80 @@
+import type { ReactNode } from 'react';
+import type { ConfirmDialogVariants } from './confirmDialog.variants.js';
+/**
+ * Severity / intent of the confirmation request — drives the accent
+ * color of the confirm button (info / warning / danger / success).
+ */
+export type ConfirmSeverity = 'info' | 'warning' | 'danger' | 'success';
+export interface ConfirmDialogSlotProps {
+    backdrop?: {
+        className?: string;
+    };
+    dialog?: {
+        className?: string;
+    };
+    title?: {
+        className?: string;
+    };
+    body?: {
+        className?: string;
+    };
+    actions?: {
+        className?: string;
+    };
+    confirmButton?: {
+        className?: string;
+    };
+    cancelButton?: {
+        className?: string;
+    };
+}
+/**
+ * One-shot confirmation request.
+ *
+ * Passed to `confirm()` from `useConfirm()` — the consumer awaits the
+ * returned promise. Resolves `true` when the user clicks confirm,
+ * `false` otherwise (cancel, backdrop, Escape).
+ */
+export interface ConfirmOptions {
+    title?: ReactNode;
+    /**
+     * Body content. Either a plain node (rendered inside `<p>`) or a
+     * fully custom render — accepted as a ReactNode to keep the API simple.
+     */
+    body?: ReactNode;
+    /** Confirm button label. @default 'Confirm' */
+    confirmLabel?: ReactNode;
+    /** Cancel button label. @default 'Cancel' */
+    cancelLabel?: ReactNode;
+    /** Severity drives confirm button color. @default 'info' */
+    severity?: ConfirmSeverity;
+    /** Disable the backdrop-click close. @default false */
+    disableBackdropClose?: boolean;
+    /** Disable the Escape-key close. @default false */
+    disableEscapeClose?: boolean;
+    /** Per-slot className overrides for this single invocation. */
+    slotProps?: ConfirmDialogSlotProps;
+}
+/**
+ * Imperative API exposed by `useConfirm()`.
+ *
+ * ```tsx
+ * const confirm = useConfirm();
+ * const ok = await confirm({
+ *   title: 'Delete record?',
+ *   body: 'This action cannot be undone.',
+ *   severity: 'danger',
+ *   confirmLabel: 'Delete',
+ * });
+ * if (ok) { ... }
+ * ```
+ */
+export type ConfirmFn = (options?: ConfirmOptions) => Promise<boolean>;
+export interface ConfirmDialogProviderProps extends ConfirmDialogVariants {
+    children: ReactNode;
+    /** Default options merged into every `confirm()` invocation. */
+    defaults?: ConfirmOptions;
+    /** Per-slot className overrides applied to ALL invocations. */
+    slotProps?: ConfirmDialogSlotProps;
+}
+//# sourceMappingURL=confirmDialog.types.d.ts.map

package/dist/components/ConfirmDialog/confirmDialog.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmDialog.types.d.ts","sourceRoot":"","sources":["../../../src/components/ConfirmDialog/confirmDialog.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAExE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,aAAa,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,uDAAuD;IACvD,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,mDAAmD;IACnD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEvE,MAAM,WAAW,0BAA2B,SAAQ,qBAAqB;IACvE,QAAQ,EAAE,SAAS,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC"}

package/dist/components/ConfirmDialog/confirmDialog.variants.d.ts

@@ -0,0 +1,90 @@
+import { type VariantProps } from 'tailwind-variants';
+/**
+ * Tailwind-variants recipe for `<ConfirmDialog>`.
+ *
+ * Built on the native HTML `<dialog>` element + `showModal()`, which
+ * gives us focus-trap, Escape handling, and `::backdrop` pseudo-element
+ * for free. The styling here is for the dialog body — the backdrop is
+ * styled via the `::backdrop` selector inside the dialog rule.
+ *
+ * Slots:
+ *   - `backdrop`      — semi-opaque overlay (`::backdrop` pseudo)
+ *   - `dialog`        — the modal box
+ *   - `title`         — modal heading
+ *   - `body`          — message text
+ *   - `actions`       — bottom button row
+ *   - `confirmButton` — primary action
+ *   - `cancelButton`  — secondary action
+ */
+export declare const confirmDialogVariants: import("tailwind-variants").TVReturnType<{
+    severity: {
+        info: {
+            confirmButton: string;
+        };
+        warning: {
+            confirmButton: string;
+        };
+        danger: {
+            confirmButton: string;
+        };
+        success: {
+            confirmButton: string;
+        };
+    };
+}, {
+    backdrop: string;
+    dialog: string[];
+    title: string;
+    body: string;
+    actions: string;
+    confirmButton: string[];
+    cancelButton: string[];
+}, undefined, {
+    severity: {
+        info: {
+            confirmButton: string;
+        };
+        warning: {
+            confirmButton: string;
+        };
+        danger: {
+            confirmButton: string;
+        };
+        success: {
+            confirmButton: string;
+        };
+    };
+}, {
+    backdrop: string;
+    dialog: string[];
+    title: string;
+    body: string;
+    actions: string;
+    confirmButton: string[];
+    cancelButton: string[];
+}, import("tailwind-variants").TVReturnType<{
+    severity: {
+        info: {
+            confirmButton: string;
+        };
+        warning: {
+            confirmButton: string;
+        };
+        danger: {
+            confirmButton: string;
+        };
+        success: {
+            confirmButton: string;
+        };
+    };
+}, {
+    backdrop: string;
+    dialog: string[];
+    title: string;
+    body: string;
+    actions: string;
+    confirmButton: string[];
+    cancelButton: string[];
+}, undefined, unknown, unknown, undefined>>;
+export type ConfirmDialogVariants = VariantProps<typeof confirmDialogVariants>;
+//# sourceMappingURL=confirmDialog.variants.d.ts.map

package/dist/components/ConfirmDialog/confirmDialog.variants.d.ts.map

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

package/dist/components/Container/Container.d.ts

@@ -0,0 +1,35 @@
+import type { ContainerProps } from './container.types.js';
+/**
+ * `<Container>` — centered max-width wrapper for page-level layouts.
+ *
+ * The pattern is universal: every page-root `<div>` in a non-trivial
+ * web app boils down to "mx-auto + max-w-X + responsive horizontal
+ * padding". Container collapses that into a typed prop set so the
+ * decision lives in ONE place per app section (the Container size),
+ * not scattered as utility chains across every page file.
+ *
+ * Default size is `'xl'` (1280px) — comfortable for full app shells
+ * with a left nav + main + optional right rail. Drop to `'lg'` (1024px)
+ * for content-heavy docs/marketing, jump to `'2xl'` (1536px) for wide
+ * dashboards.
+ *
+ * Composition pattern — Container at the page root, Stack/Grid inside:
+ *
+ *   <Container size="lg" as="main">
+ *     <Stack gap={8}>
+ *       <Typography variant="h1">Page title</Typography>
+ *       <Grid container spacing={6}>
+ *         <Grid xs={12} md={6}>...</Grid>
+ *       </Grid>
+ *     </Stack>
+ *   </Container>
+ *
+ * Container handles the page chrome (centered, padded, capped width);
+ * Stack/Grid handle the actual layout of children. Two concerns, two
+ * primitives.
+ *
+ * Polymorphism rule (same as Typography/Box/Stack/Grid): when both
+ * `as` and `asChild` are passed, `asChild` wins.
+ */
+export declare const Container: import("react").ForwardRefExoticComponent<ContainerProps & import("react").RefAttributes<HTMLElement>>;
+//# sourceMappingURL=Container.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Container.d.ts","sourceRoot":"","sources":["../../../src/components/Container/Container.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,SAAS,wGAiCrB,CAAC"}

package/dist/components/Container/container.types.d.ts

@@ -0,0 +1,41 @@
+import type { ElementType, HTMLAttributes } from 'react';
+import type { ContainerVariants } from './container.variants.js';
+/**
+ * Props for `<Container>` — page-level centered max-width wrapper.
+ *
+ * Use at the page-root level (or section-root) to constrain content
+ * width and apply the canonical responsive horizontal padding ramp.
+ * Compose Stack/Grid INSIDE Container for the actual layout work.
+ *
+ * Native attribute overrides:
+ *   • `className` omitted in favour of `sx` (utility string, merged
+ *     via tailwind-merge — same convention as Box/Stack/Grid/Typography).
+ */
+export interface ContainerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'className'>, Pick<ContainerVariants, 'size' | 'px' | 'centerContent'> {
+    /**
+     * Override the rendered HTML tag. Defaults to `'div'`. Use
+     * `as="main"` for the primary content region of a page,
+     * `as="section"` for a named section, `as="article"` for a
+     * self-contained article shell.
+     *
+     * Ignored when `asChild` is true.
+     */
+    as?: ElementType;
+    /**
+     * Render via Radix `Slot` — the Container styles paint onto the
+     * single React child instead of wrapping it. Useful for letting a
+     * router `<main>` element receive the Container chrome without
+     * adding an intermediate `<div>` in the tree.
+     *
+     * Mutually exclusive with `as` (when both are passed, `asChild` wins).
+     */
+    asChild?: boolean;
+    /**
+     * Utility classes appended to the variant chain. Resolved via
+     * `tailwind-merge` so the consumer's classes always win over the
+     * variant defaults — useful for one-off vertical padding (`sx="py-8"`),
+     * custom max-width (`sx="max-w-3xl"`), etc.
+     */
+    sx?: string;
+}
+//# sourceMappingURL=container.types.d.ts.map

package/dist/components/Container/container.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.types.d.ts","sourceRoot":"","sources":["../../../src/components/Container/container.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cACf,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,EACjD,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,GAAG,eAAe,CAAC;IAChE;;;;;;;OAOG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;IAEjB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb"}

package/dist/components/Container/container.variants.d.ts

@@ -0,0 +1,93 @@
+import { type VariantProps } from 'tailwind-variants';
+/**
+ * `containerVariants` — centered max-width wrapper for page layouts.
+ *
+ * Architectural role:
+ *
+ *   Every web app has the same pattern at the page-root level: a div
+ *   that's `mx-auto`, capped at some `max-w-*`, with responsive
+ *   horizontal padding. Without Container, every page rewrites:
+ *
+ *     <div className="mx-auto max-w-7xl px-4 sm:px-6 lg:px-8">
+ *
+ *   Container collapses that into one typed prop set, with size names
+ *   that mirror Tailwind's breakpoint vocabulary so the muscle memory
+ *   carries over (`size="lg"` ↔ `max-w-screen-lg`).
+ *
+ * Size axis — maps to Tailwind's `max-w-screen-*` aliases:
+ *   • sm     → max-w-screen-sm     (640px)
+ *   • md     → max-w-screen-md     (768px)
+ *   • lg     → max-w-screen-lg     (1024px) — most common doc/content cap
+ *   • xl     → max-w-screen-xl     (1280px) — default; comfortable for full apps
+ *   • 2xl    → max-w-screen-2xl    (1536px) — wide dashboards
+ *   • fluid  → no max-width at all (full bleed, padding still applies)
+ *
+ * Padding axis (`px`):
+ *   • true (default) — responsive horizontal padding (px-4 sm:px-6 lg:px-8)
+ *     The canonical Tailwind responsive padding ramp. Designed to keep
+ *     edges from kissing the viewport on mobile and breathing more on
+ *     larger screens.
+ *   • false — no padding. Use when the consumer wants full bleed AND
+ *     handles edge padding inside (e.g. a hero section with its own
+ *     internal spacing scale).
+ *
+ * Center content axis (`centerContent`):
+ *   • true  — turns the Container into a flex column with items-center
+ *     so the page content stacks centered horizontally. Common for
+ *     marketing pages, sign-in flows, "single artifact" layouts.
+ *   • false (default) — children flow normally (block stacking).
+ */
+export declare const containerVariants: import("tailwind-variants").TVReturnType<{
+    size: {
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        '2xl': string;
+        fluid: string;
+    };
+    px: {
+        true: string;
+        false: string;
+    };
+    centerContent: {
+        true: string;
+        false: string;
+    };
+}, undefined, "mx-auto w-full", {
+    size: {
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        '2xl': string;
+        fluid: string;
+    };
+    px: {
+        true: string;
+        false: string;
+    };
+    centerContent: {
+        true: string;
+        false: string;
+    };
+}, undefined, import("tailwind-variants").TVReturnType<{
+    size: {
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        '2xl': string;
+        fluid: string;
+    };
+    px: {
+        true: string;
+        false: string;
+    };
+    centerContent: {
+        true: string;
+        false: string;
+    };
+}, undefined, "mx-auto w-full", unknown, unknown, undefined>>;
+export type ContainerVariants = VariantProps<typeof containerVariants>;
+//# sourceMappingURL=container.variants.d.ts.map

package/dist/components/Container/container.variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.variants.d.ts","sourceRoot":"","sources":["../../../src/components/Container/container.variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6DAsC5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

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

@@ -0,0 +1,29 @@
+import type { DataGridProps } from './dataGrid.types.js';
+/**
+ * Dashforge TW `<DataGrid>` — virtualized data table.
+ *
+ * Companion to `<Table>` for large data sets (~500+ rows up to
+ * millions via virtualization). Same column model, sort/search/
+ * filter/selection logic (shared via `_shared/data/` helpers) —
+ * differs in render path: only the visible window of rows is mounted
+ * in DOM, with spacer `<tr>` above and below to preserve scrollbar
+ * size.
+ *
+ * Virtualization: hand-rolled (`useVirtualizer`) using
+ * `IntersectionObserver` + scroll-event + `requestAnimationFrame`
+ * debounce + `ResizeObserver`. Zero new runtime deps.
+ *
+ * Server-side mode (4 independent opt-in flags):
+ *  - `serverSideSort` — emits `onSortChange` but does NOT sort locally
+ *  - `serverSideFilter` — emits `onFilterChange` but does NOT filter
+ *  - `serverSideSearch` — emits `onSearchQueryChange` (debounced)
+ *  - `serverSidePagination` — `totalCount` prop sizes the virtual
+ *    scrollbar; `rows` is the page slice from the server
+ *
+ * Selection at scale: `selectAllScope`:
+ *  - `'allLoaded'` (default) — header checkbox toggles all rows in
+ *    `rows` prop
+ *  - `'visible'` — toggles only the current viewport window
+ */
+export declare function DataGrid<T extends object>(props: DataGridProps<T>): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=DataGrid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataGrid.d.ts","sourceRoot":"","sources":["../../../src/components/DataGrid/DataGrid.tsx"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA0CzD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,kDA6jBjE"}

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

@@ -0,0 +1,214 @@
+import type { ReactNode } from 'react';
+import type { AccessRequirement } from '@dashforge/rbac';
+import type { DataGridVariants } from './dataGrid.variants.js';
+import type { TableColumn, TableSortModel, TableFilterModel, TableRowSelectionMode, TableLabels } from '../Table/table.types.js';
+/**
+ * Determines what the "select all" header checkbox covers when
+ * `rowSelection="multiple"` is enabled.
+ *
+ *  - `'visible'` — only the rows currently in the viewport (after
+ *    virtualization windowing) are toggled. Useful when the
+ *    underlying data is paginated server-side and "all" semantically
+ *    refers to the screen.
+ *  - `'allLoaded'` (default) — all rows currently in the `rows` prop
+ *    are toggled. The standard "select everything I can see in this
+ *    dataset" pattern.
+ *
+ * For "select all in server-side dataset", the consumer wires it
+ * themselves (e.g. fetch all ids + setSelectedRowIds).
+ */
+export type DataGridSelectAllScope = 'visible' | 'allLoaded';
+/**
+ * Independent opt-in flags that delegate the corresponding pipeline
+ * step to the consumer. With each flag enabled, DataGrid emits the
+ * `onXChange` callback but does NOT perform the operation locally
+ * — the consumer is expected to provide the resulting `rows` array.
+ */
+export interface DataGridServerSideFlags {
+    serverSideSort?: boolean;
+    serverSideFilter?: boolean;
+    serverSideSearch?: boolean;
+    /**
+     * When true, DataGrid does NOT slice `rows` for pagination. The
+     * virtualization math uses `totalCount` (required) to size the
+     * scroll container.
+     */
+    serverSidePagination?: boolean;
+}
+export interface DataGridPaginationConfig {
+    page: number;
+    pageSize: number;
+    onPageChange: (page: number) => void;
+    onPageSizeChange?: (pageSize: number) => void;
+    pageSizeOptions?: number[];
+}
+export interface DataGridSlotProps {
+    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;
+    };
+    rowActionsCell?: {
+        className?: string;
+    };
+    bulkActionFooter?: {
+        className?: string;
+    };
+    /** Optional Pagination wrapper below the virtualized scroll. */
+    pagination?: {
+        className?: string;
+    };
+}
+/**
+ * Props for `<DataGrid>`.
+ *
+ * Companion to `<Table>` for large data sets. Where Table renders
+ * every row in DOM, DataGrid uses **homemade virtualization**
+ * (`IntersectionObserver` + scroll-event + `requestAnimationFrame`
+ * — no external libs) to render only a window of visible rows.
+ *
+ * Required:
+ *  - `rows`, `cols`, `getRowId` — same as Table
+ *  - `rowHeight` (fixed in v1; variable-height deferred to v1-bis)
+ *  - `height` — explicit container height in CSS units, OR
+ *    consumer sets it via `sx` / parent layout (the scroll container
+ *    needs a bounded height for virtualization to work)
+ *
+ * Optional:
+ *  - `overscan` — extra rows above/below viewport (default 5)
+ *  - Server-side mode flags (4 independent opt-ins)
+ *  - Internal pagination (opt-in via `pagination` config)
+ *  - `selectAllScope` — `'visible'` vs `'allLoaded'` for header
+ *    select-all checkbox
+ *  - Everything Table accepts: sort / filter / search / selection /
+ *    row actions / RBAC / variants / i18n labels / sx / slotProps
+ */
+export interface DataGridProps<T extends object> extends Pick<DataGridVariants, 'variant' | 'size' | 'density'>, DataGridServerSideFlags {
+    rows: T[];
+    cols: TableColumn<T>[];
+    getRowId: (row: T, index: number) => string;
+    /** Required: total dataset count. In client-side mode equals
+     *  `rows.length`; in `serverSidePagination` mode the consumer
+     *  provides the full count so the virtual scroll height matches. */
+    totalCount?: number;
+    /** Fixed row height in pixels. Required for windowing math. */
+    rowHeight: number;
+    /** Rows rendered above/below the viewport. @default 5 */
+    overscan?: number;
+    /** Container height in CSS units (e.g. `"600px"`, `"100vh"`).
+     *  Required for the scroll container to bound the virtualization. */
+    height?: string;
+    sortModel?: TableSortModel;
+    onSortChange?: (model: TableSortModel) => void;
+    defaultSortModel?: TableSortModel;
+    enableSearch?: boolean;
+    searchQuery?: string;
+    onSearchQueryChange?: (q: string) => void;
+    searchPlaceholder?: string;
+    searchDebounceMs?: number;
+    filterModel?: TableFilterModel;
+    onFilterChange?: (model: TableFilterModel) => void;
+    /**
+     * List of column `field`s currently hidden. Drives the column
+     * visibility dialog. When omitted, the dialog manages state
+     * internally (seeded from each column's `defaultHidden`).
+     */
+    hiddenColumns?: string[];
+    /** Called when the user commits a change in the visibility dialog. */
+    onHiddenColumnsChange?: (next: string[]) => void;
+    /**
+     * Show the "Columns" button in the toolbar. Defaults to `true` so
+     * the dialog is discoverable; set `false` for embedded / compact
+     * grids where columns are externally controlled.
+     * @default true
+     */
+    enableColumnVisibility?: boolean;
+    /**
+     * Map of `field → width (px)` for user-resized columns. When
+     * omitted, DataGrid manages widths internally — seeded from each
+     * column's `width` prop.
+     */
+    columnWidths?: Record<string, number>;
+    /** Called when the user finishes (or actively drags) a resize. */
+    onColumnWidthsChange?: (next: Record<string, number>) => void;
+    /**
+     * Allow user-driven column resize via drag on the right edge of
+     * each `<th>`. Per-column opt-out via `col.resizable = false`.
+     * @default true
+     */
+    enableColumnResize?: boolean;
+    /**
+     * Custom display order, as a list of `field`s. Columns not in the
+     * list are appended in their original order at the end. When
+     * omitted, DataGrid uses the order from the `cols` prop.
+     */
+    columnOrder?: string[];
+    /** Called when the user finishes a reorder drag. */
+    onColumnOrderChange?: (next: string[]) => void;
+    /**
+     * Allow user-driven column reorder via native HTML5 drag-and-drop
+     * on each `<th>`. Per-column opt-out via `col.reorderable = false`.
+     * @default true
+     */
+    enableColumnReorder?: boolean;
+    rowSelection?: TableRowSelectionMode;
+    selectedRowIds?: string[];
+    onSelectionChange?: (ids: string[]) => void;
+    /** Bulk action sticky footer (visible only when selection > 0). */
+    bulkActions?: (selectedRows: T[]) => ReactNode;
+    /**
+     * Scope of the "select all" header checkbox.
+     * @default 'allLoaded'
+     */
+    selectAllScope?: DataGridSelectAllScope;
+    pagination?: DataGridPaginationConfig;
+    rowActions?: (row: T) => ReactNode;
+    loading?: boolean;
+    loadingRowCount?: number;
+    emptyState?: ReactNode;
+    stickyHeader?: boolean;
+    caption?: ReactNode;
+    showCaption?: boolean;
+    access?: AccessRequirement;
+    labels?: TableLabels;
+    sx?: string;
+    slotProps?: DataGridSlotProps;
+}
+//# sourceMappingURL=dataGrid.types.d.ts.map

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

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