@12-apps/ui 5.0.0 → 5.0.1

package/dist/types/components/data-display/Chart/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Chart/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACvG,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EACL,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}

package/dist/types/components/data-display/Chip/Chip.d.ts

@@ -0,0 +1,3 @@
+import type { ChipProps } from './Chip.types';
+export declare const Chip: import("react").ForwardRefExoticComponent<ChipProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=Chip.d.ts.map

package/dist/types/components/data-display/Chip/Chip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chip.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Chip/Chip.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AA+B9C,eAAO,MAAM,IAAI,sGA4Cf,CAAC"}

package/dist/types/components/data-display/Chip/Chip.helpers.d.ts

@@ -0,0 +1,36 @@
+import type { SxProps, Theme } from '@mui/material';
+import type { KeyboardEvent, ReactElement } from 'react';
+import type { ChipProps } from './Chip.types';
+export declare const makeTestId: (dataTestId?: string) => (suffix: string) => string;
+interface KeyHandlerArgs {
+    disabled?: boolean;
+    deletable?: boolean;
+    selectable?: boolean;
+    onClick?: () => void;
+    onDelete?: () => void;
+}
+/**
+ * A chip is not a native control, so the two keyboard conventions it stands in for
+ * are wired by hand: Delete/Backspace removes it, Enter/Space activates it.
+ */
+export declare const makeKeyDownHandler: ({ disabled, deletable, selectable, onClick, onDelete }: KeyHandlerArgs) => (event: KeyboardEvent) => void;
+export declare const avatarFor: (avatar: ChipProps["avatar"], avatarSrc?: string) => ReactElement | undefined;
+interface ChipStyleArgs {
+    variant: ChipProps['variant'];
+    selected?: boolean;
+    clickable?: boolean;
+    disabled?: boolean;
+}
+/**
+ * Selection styling uses SEMANTIC palette tokens (not hardcoded rgba). A filled
+ * selected chip keeps MUI's solid `color.main` + contrast text (clear active
+ * state); an outlined selected chip gets a subtle theme-driven `action.selected`
+ * tint so it reads as active without muddying the fill.
+ */
+export declare const chipStyles: ({ variant, selected, clickable, disabled, }: ChipStyleArgs) => SxProps<Theme>;
+/** `option` when the chip belongs to a selectable set, `button` when it merely acts. */
+export declare const chipRole: (selectable?: boolean, onClick?: () => void) => "option" | "button" | undefined;
+export declare const isClickable: (disabled?: boolean, onClick?: () => void, selectable?: boolean) => boolean;
+export declare const iconWithTestId: (icon: ChipProps["icon"], testId: string) => ReactElement | undefined;
+export {};
+//# sourceMappingURL=Chip.helpers.d.ts.map

package/dist/types/components/data-display/Chip/Chip.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chip.helpers.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Chip/Chip.helpers.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAGzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,eAAO,MAAM,UAAU,GACpB,aAAa,MAAM,MACnB,QAAQ,MAAM,KAAG,MACyC,CAAC;AAE9D,UAAU,cAAc;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAKD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC5B,wDAAwD,cAAc,MACtE,OAAO,aAAa,KAAG,IAavB,CAAC;AAEJ,eAAO,MAAM,SAAS,GACpB,QAAQ,SAAS,CAAC,QAAQ,CAAC,EAC3B,YAAY,MAAM,KACjB,YAAY,GAAG,SAQjB,CAAC;AAEF,UAAU,aAAa;IACrB,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,6CAKxB,aAAa,KAAG,OAAO,CAAC,KAAK,CA8B/B,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,QAAQ,GACnB,aAAa,OAAO,EACpB,UAAU,MAAM,IAAI,KACnB,QAAQ,GAAG,QAAQ,GAAG,SAGxB,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,WAAW,OAAO,EAClB,UAAU,MAAM,IAAI,EACpB,aAAa,OAAO,KACnB,OAAiE,CAAC;AAErE,eAAO,MAAM,cAAc,GACzB,MAAM,SAAS,CAAC,MAAM,CAAC,EACvB,QAAQ,MAAM,KACb,YAAY,GAAG,SAKH,CAAC"}

package/dist/types/components/data-display/Chip/Chip.types.d.ts

@@ -0,0 +1,71 @@
+import type { ColorValue, SizeValue } from '../../../tokens/scales';
+import type { ReactNode } from 'react';
+export type ChipVariant = 'filled' | 'outlined';
+/**
+ * The house size scale, abbreviated like every other component's.
+ *
+ * `Avatar`, `Badge`, `Progress`, `Input`, `Modal` and `Dialog` all use `sm`/`md`;
+ * this was `'small' | 'medium'`, MUI's spelling, and the sole outlier in the
+ * package. That was not merely inconsistent — callers wrote `size="sm"` because
+ * every neighbouring component taught them to, it type-checked against the old
+ * `ChipSize` nowhere and reached MUI as an unknown value, and the chip silently
+ * rendered at the default `medium`. Twelve of them are doing that today.
+ *
+ * All five stops, and `Chip.tsx` draws them: MUI gives a chip two heights, so
+ * `xs`/`sm` map to small and `md` and up to medium. Offering fewer than five
+ * here is what made callers write `size="sm"` against a type that did not have
+ * it — the scale is the vocabulary, and a component that speaks a dialect of it
+ * is the problem, not the solution.
+ */
+export type ChipSize = SizeValue;
+/**
+ * The colours a chip can draw — THE HOUSE VOCABULARY, identical to `ButtonProps`.
+ *
+ * `danger` and `neutral` are ours; the rest are MUI's own names already. That is
+ * the same sentence `Button.tsx` carries, and deliberately so: `Button`, `Alert`,
+ * `Text`, `Heading`, `Paragraph` and `Blockquote` all speak this vocabulary, so a
+ * chip is the odd one out if it does not.
+ *
+ * This prop was `string`, and the widening was not free. `danger` — the house
+ * word for the destructive meaning, and what every neighbouring component
+ * accepts — reached MUI as an unknown value and fell back to the default grey.
+ * The chip that most needed emphasis rendered without any, and nothing said so.
+ *
+ * The fix is NOT to reject `danger`. Rejecting it would punish a caller for
+ * using the vocabulary the rest of the system taught them. The fix is for the
+ * chip to speak it and translate at the MUI boundary, exactly as `Button` does.
+ */
+export type ChipColor = ColorValue;
+export interface ChipProps {
+    /** Text content displayed in the chip */
+    label: string;
+    /** Visual style variant */
+    variant?: ChipVariant;
+    /** Size of the chip */
+    size?: ChipSize;
+    /** Theme color token. See {@link ChipColor} for why this is a closed set. */
+    color?: ChipColor;
+    /** Source URL for avatar image */
+    avatarSrc?: string;
+    /** Custom avatar React node (overrides avatarSrc) */
+    avatar?: ReactNode;
+    /** Leading icon React node */
+    icon?: ReactNode;
+    /** Current selection state */
+    selected?: boolean;
+    /** Enables selection toggle capability */
+    selectable?: boolean;
+    /** Shows delete button */
+    deletable?: boolean;
+    /** Disables all interactions */
+    disabled?: boolean;
+    /** Click/selection handler */
+    onClick?: () => void;
+    /** Delete action handler */
+    onDelete?: () => void;
+    /** Additional CSS classes */
+    className?: string;
+    /** Test ID for component testing */
+    dataTestId?: string;
+}
+//# sourceMappingURL=Chip.types.d.ts.map

package/dist/types/components/data-display/Chip/Chip.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chip.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Chip/Chip.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC;AAEjC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC;AAEnC,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IAEd,2BAA2B;IAC3B,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB,uBAAuB;IACvB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAEhB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qDAAqD;IACrD,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAEtB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/components/data-display/Chip/index.d.ts

@@ -0,0 +1,3 @@
+export { Chip } from './Chip';
+export type { ChipColor, ChipProps, ChipSize, ChipVariant } from './Chip.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/data-display/Chip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Chip/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/components/data-display/DataGrid/DataGrid.body.d.ts

@@ -0,0 +1,13 @@
+import type React from 'react';
+import type { DataGridModel } from './DataGrid.model';
+import type { DataGridProps } from './DataGrid.types';
+export interface GridSectionProps<T extends Record<string, unknown>> {
+    model: DataGridModel<T>;
+    props: DataGridProps<T>;
+    totalColumns: number;
+}
+/** The caller's `getRowId`, or the row's own `id`, or its index. */
+export declare function rowIdOf<T extends Record<string, unknown>>(props: DataGridProps<T>, row: T, index: number): string | number;
+export declare function GridHeader<T extends Record<string, unknown>>(section: GridSectionProps<T>): React.JSX.Element;
+export declare function GridBody<T extends Record<string, unknown>>(section: GridSectionProps<T>): React.JSX.Element;
+//# sourceMappingURL=DataGrid.body.d.ts.map

package/dist/types/components/data-display/DataGrid/DataGrid.body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataGrid.body.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataGrid/DataGrid.body.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACxB,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AA0CD,oEAAoE;AACpE,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvD,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,MAAM,CAIjB;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1D,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC3B,KAAK,CAAC,GAAG,CAAC,OAAO,CAsBnB;AAYD,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxD,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC3B,KAAK,CAAC,GAAG,CAAC,OAAO,CA+BnB"}

package/dist/types/components/data-display/DataGrid/DataGrid.cells.d.ts

@@ -0,0 +1,34 @@
+import React from 'react';
+import type { DataGridModel } from './DataGrid.model';
+import type { DataGridProps, GridColumn, GridSort } from './DataGrid.types';
+export interface HeaderCellProps<T extends Record<string, unknown>> {
+    column: GridColumn<T>;
+    sort: GridSort | undefined;
+    sortable: boolean;
+    stickyHeader: boolean;
+    headerHeight: number;
+    onSort: (columnId: string) => void;
+}
+export declare function HeaderCell<T extends Record<string, unknown>>({ column, sort, sortable, stickyHeader, headerHeight, onSort, }: HeaderCellProps<T>): React.JSX.Element;
+export interface DataCellProps<T extends Record<string, unknown>> {
+    row: T;
+    rowIndex: number;
+    rowId: string | number;
+    column: GridColumn<T>;
+    rowHeight: number;
+    editing: NonNullable<DataGridProps<T>['editing']>;
+    model: Pick<DataGridModel<T>, 'editingCell' | 'setEditingCell'>;
+}
+export declare function DataCell<T extends Record<string, unknown>>({ row, rowIndex, rowId, column, rowHeight, editing, model, }: DataCellProps<T>): React.JSX.Element;
+export interface GridRowProps<T extends Record<string, unknown>> {
+    row: T;
+    index: number;
+    rowId: string | number;
+    isSelected: boolean;
+    isExpanded: boolean;
+    totalColumns: number;
+    model: DataGridModel<T>;
+    props: DataGridProps<T>;
+}
+export declare function GridRow<T extends Record<string, unknown>>(rowProps: GridRowProps<T>): React.JSX.Element;
+//# sourceMappingURL=DataGrid.cells.d.ts.map

package/dist/types/components/data-display/DataGrid/DataGrid.cells.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataGrid.cells.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataGrid/DataGrid.cells.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAc5E,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC5D,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,MAAM,GACP,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA6CxC;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9D,GAAG,EAAE,CAAC,CAAC;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAClD,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,GAAG,gBAAgB,CAAC,CAAC;CACjE;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC1D,GAAG,EACH,QAAQ,EACR,KAAK,EACL,MAAM,EACN,SAAS,EACT,OAAO,EACP,KAAK,GACN,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAmCtC;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,GAAG,EAAE,CAAC,CAAC;IACP,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACxB,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;CACzB;AAsCD,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvD,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GACxB,KAAK,CAAC,GAAG,CAAC,OAAO,CAuCnB"}

package/dist/types/components/data-display/DataGrid/DataGrid.d.ts

@@ -0,0 +1,7 @@
+import type React from 'react';
+import type { DataGridProps } from './DataGrid.types';
+export declare const DataGrid: {
+    <T extends Record<string, unknown> = Record<string, unknown>>(props: DataGridProps<T>): React.JSX.Element;
+    displayName: string;
+};
+//# sourceMappingURL=DataGrid.d.ts.map

package/dist/types/components/data-display/DataGrid/DataGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataGrid.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataGrid/DataGrid.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA0CtD,eAAO,MAAM,QAAQ;KAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,mCACjD,aAAa,CAAC,CAAC,CAAC,GACtB,KAAK,CAAC,GAAG,CAAC,OAAO;;CAyCnB,CAAC"}

package/dist/types/components/data-display/DataGrid/DataGrid.model.d.ts

@@ -0,0 +1,35 @@
+import type React from 'react';
+import type { DataGridProps, GridColumn, GridSort } from './DataGrid.types';
+/** Which id is being edited, or `null`. */
+export interface EditingCell {
+    rowId: string | number;
+    colId: string;
+}
+/** The visible slice of a virtualized body. */
+export interface VisibleRange {
+    start: number;
+    end: number;
+}
+/** Everything the render needs, and nothing it has to derive. */
+export interface DataGridModel<T extends Record<string, unknown>> {
+    containerRef: React.RefObject<HTMLDivElement | null>;
+    rowHeight: number;
+    visibleColumns: GridColumn<T>[];
+    processedRows: T[];
+    visibleRows: T[];
+    visibleRange: VisibleRange;
+    virtualized: boolean;
+    sortBy: readonly GridSort[];
+    selectedRowIds: Array<string | number>;
+    selectedRowIdsSet: ReadonlySet<string | number>;
+    expandedRowIdsSet: ReadonlySet<string | number>;
+    editingCell: EditingCell | null;
+    setEditingCell: (cell: EditingCell | null) => void;
+    setSelectedRowIds: (ids: Array<string | number>) => void;
+    onSort: (columnId: string) => void;
+    onToggleRow: (rowId: string | number, isSelected: boolean) => void;
+    onToggleExpansion: (rowId: string | number) => void;
+    onScroll: (event: React.UIEvent<HTMLDivElement>) => void;
+}
+export declare function useDataGridModel<T extends Record<string, unknown>>(props: DataGridProps<T>): DataGridModel<T>;
+//# sourceMappingURL=DataGrid.model.d.ts.map

package/dist/types/components/data-display/DataGrid/DataGrid.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataGrid.model.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataGrid/DataGrid.model.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EAEV,QAAQ,EAET,MAAM,kBAAkB,CAAC;AAa1B,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9D,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAChC,aAAa,EAAE,CAAC,EAAE,CAAC;IACnB,WAAW,EAAE,CAAC,EAAE,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC5B,cAAc,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACvC,iBAAiB,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAChD,iBAAiB,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAChD,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACnD,iBAAiB,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC;IACzD,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IACnE,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IACpD,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;CAC1D;AAqND,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GACtB,aAAa,CAAC,CAAC,CAAC,CAgClB"}

package/dist/types/components/data-display/DataGrid/DataGrid.rows.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The DataGrid's CLIENT-MODE row pipeline: filter, sort, paginate.
+ *
+ * Lifted out of the component so it is a pure function of its inputs — no
+ * hooks, no theme, no refs — which is the only way the comparator can be read
+ * (and tested) at all. Server modes skip every step here: the rows arrived
+ * already filtered, sorted and paged, and re-doing any of it locally would make
+ * the grid disagree with the page count the server just sent.
+ */
+import type { GridColumn, GridFilter, GridSort } from './DataGrid.types';
+/** The value a column reads out of a row: accessor fn, accessor key, or id. */
+export declare function cellValue<T extends Record<string, unknown>>(row: T, column: GridColumn<T>): unknown;
+/** Which client-mode steps this render actually needs. */
+interface RowPipeline<T extends Record<string, unknown>> {
+    rows: T[];
+    columnMap: ReadonlyMap<string, GridColumn<T>>;
+    filters: readonly GridFilter[];
+    sortBy: readonly GridSort[];
+    needsFiltering: boolean;
+    needsSorting: boolean;
+    needsPagination: boolean;
+    pageIndex: number;
+    pageSize: number;
+}
+/**
+ * Run the pipeline, copying the array only when a step actually has to modify
+ * it. The identity of the untouched array is load-bearing: the grid's memos and
+ * every consumer's `rows === prev` check depend on a no-op pipeline returning
+ * exactly what it was given.
+ */
+export declare function processRows<T extends Record<string, unknown>>(pipeline: RowPipeline<T>): T[];
+export {};
+//# sourceMappingURL=DataGrid.rows.d.ts.map

package/dist/types/components/data-display/DataGrid/DataGrid.rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataGrid.rows.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataGrid/DataGrid.rows.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEzE,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GACpB,OAAO,CAKT;AAqDD,0DAA0D;AAC1D,UAAU,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrD,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAmB5F"}

package/dist/types/components/data-display/DataGrid/DataGrid.states.d.ts

@@ -0,0 +1,22 @@
+import type React from 'react';
+/** Shared by all three: the same box, the same role, the same id. */
+interface PlaceholderProps {
+    dataTestId?: string;
+    ariaLabel?: string;
+    className?: string;
+    style?: React.CSSProperties;
+    htmlProps: React.HTMLAttributes<HTMLElement>;
+    children: React.ReactNode;
+    /** The single state flag this placeholder sets (`data-loading` etc.). */
+    flag: 'data-loading' | 'data-error' | 'data-empty';
+}
+type StateProps = Omit<PlaceholderProps, 'children' | 'flag'>;
+export declare function DataGridLoading(props: StateProps): React.JSX.Element;
+export declare function DataGridError(props: StateProps & {
+    error: React.ReactNode;
+}): React.JSX.Element;
+export declare function DataGridEmpty(props: StateProps & {
+    emptyState?: React.ReactNode;
+}): React.JSX.Element;
+export {};
+//# sourceMappingURL=DataGrid.states.d.ts.map

package/dist/types/components/data-display/DataGrid/DataGrid.states.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataGrid.states.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataGrid/DataGrid.states.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,qEAAqE;AACrE,UAAU,gBAAgB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,SAAS,EAAE,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAC7C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,yEAAyE;IACzE,IAAI,EAAE,cAAc,GAAG,YAAY,GAAG,YAAY,CAAC;CACpD;AAmCD,KAAK,UAAU,GAAG,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,MAAM,CAAC,CAAC;AAE9D,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAMpE;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,GAC7C,KAAK,CAAC,GAAG,CAAC,OAAO,CASnB;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,GAAG;IAAE,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,GACnD,KAAK,CAAC,GAAG,CAAC,OAAO,CAWnB"}

package/dist/types/components/data-display/DataGrid/DataGrid.types.d.ts

@@ -0,0 +1,158 @@
+import type React from 'react';
+export type GridSizeMode = 'auto' | 'fixed' | 'fill';
+export type GridDensity = 'compact' | 'comfortable' | 'spacious';
+export type SortDirection = 'asc' | 'desc' | null;
+export type GridSelectionMode = 'none' | 'single' | 'multi';
+export type PaginationMode = 'client' | 'server';
+export type SortMode = 'client' | 'server';
+export type FilterMode = 'client' | 'server';
+export type EditMode = 'none' | 'cell' | 'row';
+export interface GridColumn<T = Record<string, unknown>> {
+    /** Unique column id (stable across renders) */
+    id: string;
+    /** Column header label (string or node) */
+    header: React.ReactNode;
+    /** Accessor: key or function to derive value from row */
+    accessor?: keyof T | ((row: T) => unknown);
+    /** Column type influences default formatting and editors */
+    type?: 'text' | 'number' | 'date' | 'datetime' | 'boolean' | 'currency' | 'actions';
+    /** Width hints (px) and min/max constraints */
+    width?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    /** Column is initially hidden */
+    hidden?: boolean;
+    /** Pin to left/right (sticky) */
+    pin?: 'left' | 'right';
+    /** Enable/disable sort, filter, resize, reorder, edit per column */
+    enableSort?: boolean;
+    enableFilter?: boolean;
+    enableResize?: boolean;
+    enableReorder?: boolean;
+    enableEdit?: boolean;
+    /** Custom renderers */
+    cell?: (ctx: {
+        value: unknown;
+        row: T;
+        rowIndex: number;
+        col: GridColumn<T>;
+    }) => React.ReactNode;
+    headerCell?: (col: GridColumn<T>) => React.ReactNode;
+    /** Cell editor renderer (edit mode) */
+    editor?: (ctx: {
+        value: unknown;
+        row: T;
+        onChange: (next: unknown) => void;
+        commit: () => void;
+        cancel: () => void;
+    }) => React.ReactNode;
+    /** Column-specific filter UI and predicate (client mode) */
+    filterComponent?: (ctx: {
+        value: unknown;
+        setValue: (next: unknown) => void;
+        col: GridColumn<T>;
+    }) => React.ReactNode;
+    filterPredicate?: (value: unknown, filterValue: unknown, row: T) => boolean;
+    /** Accessibility label for header button controls */
+    ariaLabel?: string;
+}
+export interface GridSort {
+    id: string;
+    dir: SortDirection;
+}
+export interface GridFilter {
+    id: string;
+    value: unknown;
+}
+export interface GridRowExpansion<T = Record<string, unknown>> {
+    /** Render expanded content */
+    render: (row: T, rowIndex: number) => React.ReactNode;
+    /** Controlled expanded row ids */
+    expandedRowIds?: Array<string | number>;
+    /** Uncontrolled defaults */
+    defaultExpandedRowIds?: Array<string | number>;
+    /** Row id equality uses `getRowId` */
+    onChangeExpanded?: (ids: Array<string | number>) => void;
+}
+export interface GridSelection {
+    mode?: GridSelectionMode;
+    selectedRowIds?: Array<string | number>;
+    defaultSelectedRowIds?: Array<string | number>;
+    onChangeSelected?: (ids: Array<string | number>) => void;
+}
+export interface GridPagination {
+    mode?: PaginationMode;
+    pageIndex?: number;
+    pageSize?: number;
+    rowCount?: number;
+    onChangePage?: (nextIndex: number) => void;
+    onChangePageSize?: (nextSize: number) => void;
+}
+export interface GridSorting {
+    mode?: SortMode;
+    sortBy?: GridSort[];
+    defaultSortBy?: GridSort[];
+    onChangeSortBy?: (next: GridSort[]) => void;
+}
+export interface GridFiltering {
+    mode?: FilterMode;
+    filters?: GridFilter[];
+    defaultFilters?: GridFilter[];
+    onChangeFilters?: (next: GridFilter[]) => void;
+}
+export interface GridEditing<T = Record<string, unknown>> {
+    mode?: EditMode;
+    /** Called when a cell (or row) attempts to commit a value */
+    onEditCommit?: (ctx: {
+        rowId: string | number;
+        colId: string;
+        value: unknown;
+        row: T;
+    }) => Promise<void> | void;
+    /** Validation error message per cell (controlled) */
+    getCellError?: (rowId: string | number, colId: string) => string | undefined;
+}
+export interface DataGridProps<T = Record<string, unknown>> extends React.HTMLAttributes<HTMLElement> {
+    /** Dataset (client mode uses this array; server mode renders current page) */
+    rows: T[];
+    /** Stable row id accessor */
+    getRowId?: (row: T, index: number) => string | number;
+    /** Column definitions */
+    columns: GridColumn<T>[];
+    /** Sizing, density, and layout */
+    sizeMode?: GridSizeMode;
+    density?: GridDensity;
+    rowHeight?: number;
+    headerHeight?: number;
+    footerHeight?: number;
+    /** Interaction features */
+    selection?: GridSelection;
+    pagination?: GridPagination;
+    sorting?: GridSorting;
+    filtering?: GridFiltering;
+    expansion?: GridRowExpansion<T>;
+    editing?: GridEditing<T>;
+    /** Virtualization toggles */
+    virtualizeRows?: boolean;
+    virtualizeColumns?: boolean;
+    /** Sticky headers/footers and pinned columns */
+    stickyHeader?: boolean;
+    stickyFooter?: boolean;
+    /** Empty/loading/error states */
+    loading?: boolean;
+    error?: React.ReactNode;
+    emptyState?: React.ReactNode;
+    /** Server-fetch hooks (used by server modes) */
+    onRequestData?: (params: {
+        pageIndex?: number;
+        pageSize?: number;
+        sortBy?: GridSort[];
+        filters?: GridFilter[];
+    }) => void;
+    /** Accessibility */
+    ariaLabel?: string;
+    ariaDescription?: string;
+    /** Testing id passthrough */
+    'data-testid'?: string;
+}
+//# sourceMappingURL=DataGrid.types.d.ts.map

package/dist/types/components/data-display/DataGrid/DataGrid.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataGrid.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataGrid/DataGrid.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;AACjE,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;AAClD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC3C,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC7C,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE/C,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrD,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC;IAC3C,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IACpF,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,oEAAoE;IACpE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uBAAuB;IACvB,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,CAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;KAAE,KAAK,KAAK,CAAC,SAAS,CAAC;IAClG,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;IACrD,uCAAuC;IACvC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE;QACb,KAAK,EAAE,OAAO,CAAC;QACf,GAAG,EAAE,CAAC,CAAC;QACP,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;QAClC,MAAM,EAAE,MAAM,IAAI,CAAC;QACnB,MAAM,EAAE,MAAM,IAAI,CAAC;KACpB,KAAK,KAAK,CAAC,SAAS,CAAC;IACtB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QACtB,KAAK,EAAE,OAAO,CAAC;QACf,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;QAClC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;KACpB,KAAK,KAAK,CAAC,SAAS,CAAC;IACtB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC;IAC5E,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,aAAa,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,8BAA8B;IAC9B,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IACtD,kCAAkC;IAClC,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACxC,4BAA4B;IAC5B,qBAAqB,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/C,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACxC,qBAAqB,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/C,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,UAAU,EAAE,CAAC;IAC9B,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtD,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE;QACnB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,OAAO,CAAC;QACf,GAAG,EAAE,CAAC,CAAC;KACR,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3B,qDAAqD;IACrD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC9E;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,SAAQ,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC;IACnG,8EAA8E;IAC9E,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAAC;IACtD,yBAAyB;IACzB,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,SAAS,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAEzB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,gDAAgD;IAChD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE7B,gDAAgD;IAChD,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;QACpB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;KACxB,KAAK,IAAI,CAAC;IAEX,oBAAoB;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/types/components/data-display/DataGrid/index.d.ts

@@ -0,0 +1,3 @@
+export { DataGrid } from './DataGrid';
+export type { DataGridProps, EditMode, FilterMode, GridColumn, GridDensity, GridEditing, GridFilter, GridFiltering, GridPagination, GridRowExpansion, GridSelection, GridSelectionMode, GridSizeMode, GridSort, GridSorting, PaginationMode, SortDirection, SortMode, } from './DataGrid.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/data-display/DataGrid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataGrid/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EACV,aAAa,EACb,QAAQ,EACR,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,cAAc,EACd,aAAa,EACb,QAAQ,GACT,MAAM,kBAAkB,CAAC"}

package/dist/types/components/data-display/DataViews/DataViewsBoard.d.ts

@@ -0,0 +1,90 @@
+import type { DataViewCardSelection } from "./data-views-types";
+/**
+ * One column of the board — a single value of the grouping field, with the label
+ * to print above it.
+ *
+ * `tone` is an opaque palette hint (e.g. `"success"`, `"error"`) the host picks
+ * from its own state machine; the board only uses it to colour the column's
+ * header accent, so an unknown tone degrades to the default rather than throwing.
+ */
+export interface BoardGroup {
+    value: string;
+    label: string;
+    tone?: string;
+}
+/**
+ * The BOARD layout's configuration: the same page the table rendered, laid out
+ * as columns of the entity's own card.
+ *
+ * The board earns its place when a page's buckets are STATES IN A STATE MACHINE
+ * rather than arbitrary groupings — payments are exactly that shape. Derive
+ * `groups` and the table's `scopes` from ONE state-machine definition: two
+ * hand-maintained lists of the same states will drift, and the drift shows up as
+ * a column the tabs do not have.
+ */
+export interface BoardConfig<T extends Record<string, unknown>> {
+    /** The row field whose value places a card in a column. */
+    groupBy: keyof T & string;
+    /** The columns, in DELIBERATE reading order — the board renders this order. */
+    groups: BoardGroup[];
+    /** Optional numeric row field summed per column (e.g. the amount in cents). */
+    sumBy?: keyof T & string;
+    /**
+     * Formats a column's total. The PAGE's own formatter, so the board prints
+     * money in the store's currency instead of inventing a second convention.
+     * Omitted ⇒ the raw sum.
+     */
+    formatSum?: (total: number) => string;
+    /** Header for the column collecting rows in states the front end does not declare. */
+    extraLabel?: string;
+}
+/** One resolved column: a declared group (or the catch-all) plus its loaded rows. */
+interface ResolvedColumn<T> {
+    key: string;
+    label: string;
+    tone?: string;
+    rows: T[];
+}
+/**
+ * Place every loaded row into a column, in the DECLARED order, and collect the
+ * leftovers into one extra column at the end.
+ *
+ * Nothing is ever dropped, and that is the point: a state added to the back end
+ * before the front end knows about it must not make rows disappear. On a
+ * payments board, a silently dropped row is money nobody can see. The extra
+ * column only exists when something landed in it — once every row is placed it
+ * is gone, so the common case shows exactly the declared columns.
+ *
+ * A declared group with no rows KEEPS its position: the order is a reading
+ * order chosen by the host, not a ranking derived from the data.
+ */
+export declare function groupRows<T extends Record<string, unknown>>(rows: T[], board: BoardConfig<T>): ResolvedColumn<T>[];
+interface DataViewsBoardProps<T extends Record<string, unknown>> {
+    /** The LOADED page, verbatim. The board never filters, sorts or paginates. */
+    rows: T[];
+    board: BoardConfig<T>;
+    getRowId: (row: T) => string | number;
+    renderCard: (row: T, selection: DataViewCardSelection) => React.ReactNode;
+    selectedIds: Set<string | number>;
+    onToggleId: (id: string | number) => void;
+    /** Card size multiplier from the toolbar zoom slider — the same knob as cards. */
+    cardScale: number;
+    dataTestId?: string;
+}
+/**
+ * The BOARD layout: the loaded page distributed into columns of the entity's own
+ * card. A rendering, not a second source of truth — switching to it emits no
+ * query, and it shows exactly the rows the table showed.
+ *
+ * The board scrolls HORIZONTALLY inside its own box rather than letting the page
+ * scroll sideways, and its columns keep a usable width at every zoom, so a phone
+ * gets a real board instead of six unreadable slivers.
+ *
+ * Cards are not draggable between columns. Dragging a payment from Recusado to
+ * Pago is a domain transition with side effects, not a re-render: it needs the
+ * allowed-transition set from the state machine plus a confirmation, and
+ * `RowAction.isVisible` is the existing per-row guard to reuse when that lands.
+ */
+export declare function DataViewsBoard<T extends Record<string, unknown>>({ rows, board, getRowId, renderCard, selectedIds, onToggleId, cardScale, dataTestId, }: DataViewsBoardProps<T>): React.JSX.Element;
+export {};
+//# sourceMappingURL=DataViewsBoard.d.ts.map

package/dist/types/components/data-display/DataViews/DataViewsBoard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataViewsBoard.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/DataViewsBoard.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IACzB;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,qFAAqF;AACrF,UAAU,cAAc,CAAC,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,CAAC,EAAE,CAAC;CACX;AAQD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,IAAI,EAAE,CAAC,EAAE,EACT,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GACpB,cAAc,CAAC,CAAC,CAAC,EAAE,CAkBrB;AAgJD,UAAU,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,8EAA8E;IAC9E,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACtB,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,CAAC;IACtC,UAAU,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,SAAS,EAAE,qBAAqB,KAAK,KAAK,CAAC,SAAS,CAAC;IAC1E,WAAW,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAClC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAC1C,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAChE,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,UAAU,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,GACX,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA0C5C"}