@ai-matrx/design-system 0.18.8 → 0.18.10

package/dist/styles.css

@@ -912,11 +912,18 @@
   min-width: 0;
 }
 
+[data-matrx-table] {
+  padding-bottom: var(--matrx-table-bottom-space, 12px);
+}
+
 [data-matrx-table-scroll],
 [data-matrx-table-cards-scroll] {
   min-width: 0;
   min-height: 0;
-  overscroll-behavior: contain;
+  /* Keep horizontal gestures in a wide table, but let vertical wheel/touch
+     input chain natively to the page when this scroller has no remaining
+     vertical range. */
+  overscroll-behavior-x: contain;
 }
 
 [data-matrx-table-scroll] {

package/dist/tokens.css

@@ -73,6 +73,8 @@
     --border: 240 6% 90%;
     --input: 240 6% 90%;
     --ring: 240 5% 65%;
+    /* Shared table terminal breathing room; a host may override per layout. */
+    --matrx-table-bottom-space: 12px;
 
     /* Input elevation — consumed by the `.shadow-input` rule in styles.css
        and by the Tailwind `shadow-input` utility on Tailwind hosts. */

package/dist/{types-cH8oLqUx.d.ts → types-C2xN6W_q.d.ts}

@@ -466,9 +466,46 @@ interface MatrxDataTableToolbar {
     facets?: ToolbarFacet[];
     /** Left-side extra nodes (after search / facets). */
     leading?: ReactNode;
-    /** Right-side actions (create, refresh, …). */
+    /**
+     * Standard host refresh affordance. The package owns its placement, busy
+     * state, and accessible tooltip; the host remains the sole data owner.
+     */
+    refresh?: {
+        onRefresh: () => void | Promise<void>;
+        label?: string;
+    };
+    /**
+     * Standard create affordance. The host owns authorization and the actual
+     * create flow; disabledReason is exposed through the shared tooltip.
+     */
+    add?: {
+        onAdd: () => void | Promise<void>;
+        disabled?: boolean;
+        disabledReason?: string;
+    };
+    /** Right-side domain actions, rendered after standard table controls. */
     actions?: ReactNode;
 }
+/** Query fields safe to persist in a named table view. */
+type TableViewQuery = Omit<MatrxDataTableQueryState, "page">;
+/** Portable, persistence-neutral table state saved by a host adapter. */
+interface TableViewSnapshot {
+    __kind: "matrx-table-view";
+    version: 1;
+    /** Page/cursor/selection/loaded rows are deliberately never saved. */
+    query: TableViewQuery;
+    columns: {
+        order: string[];
+        hidden: string[];
+    };
+}
+/** Host port for durable named views. The host owns actor, tenancy and CRUD. */
+interface TableSavedViewsProps {
+    tableId: string;
+    snapshot: TableViewSnapshot;
+    defaultSnapshot: TableViewSnapshot;
+    onApply: (snapshot: TableViewSnapshot) => void;
+}
 /** Optional deferred-apply copy for column filter popovers. */
 interface MatrxDataTableFilterUi {
     /** Enables the Include/Exclude control. Default false for remote-safe filters. */
@@ -684,6 +721,8 @@ interface MatrxDataTableSelectionConfig<T> {
 }
 /** Table-owned state and actions exposed to an opt-in phone card renderer. */
 interface MatrxDataTableMobileCardControls {
+    /** Render a declared column with the same editable/draft/link behavior as the grid. */
+    renderCell: (columnId: string) => ReactNode;
     /** Whether this row is in the canonical selection set. */
     selected: boolean;
     /** Whether the consumer allows this row to be selected. */
@@ -699,6 +738,10 @@ interface MatrxDataTableMobileCardControls {
 interface MatrxDataTableProps<T> {
     data: T[];
     columns: MatrxColumnDef<T>[];
+    /** Stable persistence identity for host-installed named views. */
+    tableId?: string;
+    /** Declared reset state for the host Saved Views control. */
+    defaultViewSnapshot?: TableViewSnapshot;
     /** Optional URL/source-owned column order and visibility. */
     columnState?: {
         order: string[];
@@ -708,7 +751,7 @@ interface MatrxDataTableProps<T> {
             hidden: string[];
         }) => void;
     };
-    /** Enables package-owned drag reordering in table headers. */
+    /** Enables package-owned drag reordering in table headers. Default true. */
     reorderableColumns?: boolean;
     columnManager?: {
         open: boolean;
@@ -826,4 +869,4 @@ interface MatrxDataTableProps<T> {
     onRowOpen?: (row: T) => void;
 }
 
-export { type AnyOfColumnSearch as A, LAYERED_FILTER_OPERATOR_LABELS as B, type ColumnFiltersState as C, type LayeredFilterField as D, type LayeredFilterOperator as E, columnFiltersToLayeredRules as F, completeLayeredFilterRules as G, decodeLayeredFilterRules as H, encodeLayeredFilterRules as I, isCompleteLayeredFilterRule as J, isLayeredFilterOperator as K, type LayeredFilterRule as L, type MatrxColumnDef as M, layeredFilterMatchesValue as N, layeredFilterNeedsValue as O, layeredFilterRuleSummary as P, operatorsForLayeredField as Q, type SortState as S, type TableSearchMatchMode as T, type ColumnFilterValue as a, type MatrxDataTableProps as b, type CellEditType as c, type CellEditsMap as d, type ColumnFilterKind as e, type MatrxDataTableCopyConfig as f, type MatrxDataTableDetailConfig as g, type MatrxDataTableEditConfig as h, type MatrxDataTableEmptyState as i, type MatrxDataTableFilterUi as j, type MatrxDataTableHierarchyConfig as k, type MatrxDataTableHierarchyMove as l, type MatrxDataTableMobileCardControls as m, type MatrxDataTableQueryControl as n, type MatrxDataTableQueryState as o, type MatrxDataTableRecordControls as p, type MatrxDataTableSelectionConfig as q, type MatrxDataTableSourceProcessing as r, type MatrxDataTableToolbar as s, type MatrxDataTableUrlStateConfig as t, type MatrxDataTableWindowConfig as u, type MatrxTablePagination as v, type SortDirection as w, type TextFilterMode as x, type ToolbarFacet as y, LAYERED_FILTER_OPERATORS as z };
+export { type AnyOfColumnSearch as A, type TextFilterMode as B, type ColumnFiltersState as C, type ToolbarFacet as D, LAYERED_FILTER_OPERATORS as E, LAYERED_FILTER_OPERATOR_LABELS as F, type LayeredFilterField as G, type LayeredFilterOperator as H, columnFiltersToLayeredRules as I, completeLayeredFilterRules as J, decodeLayeredFilterRules as K, type LayeredFilterRule as L, type MatrxColumnDef as M, encodeLayeredFilterRules as N, isCompleteLayeredFilterRule as O, isLayeredFilterOperator as P, layeredFilterMatchesValue as Q, layeredFilterNeedsValue as R, type SortState as S, type TableSearchMatchMode as T, layeredFilterRuleSummary as U, operatorsForLayeredField as V, type ColumnFilterValue as a, type MatrxDataTableProps as b, type TableViewSnapshot as c, type CellEditType as d, type CellEditsMap as e, type ColumnFilterKind as f, type MatrxDataTableCopyConfig as g, type MatrxDataTableDetailConfig as h, type MatrxDataTableEditConfig as i, type MatrxDataTableEmptyState as j, type MatrxDataTableFilterUi as k, type MatrxDataTableHierarchyConfig as l, type MatrxDataTableHierarchyMove as m, type MatrxDataTableMobileCardControls as n, type MatrxDataTableQueryControl as o, type MatrxDataTableQueryState as p, type MatrxDataTableRecordControls as q, type MatrxDataTableSelectionConfig as r, type MatrxDataTableSourceProcessing as s, type MatrxDataTableToolbar as t, type MatrxDataTableUrlStateConfig as u, type MatrxDataTableWindowConfig as v, type MatrxTablePagination as w, type SortDirection as x, type TableSavedViewsProps as y, type TableViewQuery as z };

package/dist/{types-0CNCWvdK.d.cts → types-D_tpuk6m.d.cts}

@@ -466,9 +466,46 @@ interface MatrxDataTableToolbar {
     facets?: ToolbarFacet[];
     /** Left-side extra nodes (after search / facets). */
     leading?: ReactNode;
-    /** Right-side actions (create, refresh, …). */
+    /**
+     * Standard host refresh affordance. The package owns its placement, busy
+     * state, and accessible tooltip; the host remains the sole data owner.
+     */
+    refresh?: {
+        onRefresh: () => void | Promise<void>;
+        label?: string;
+    };
+    /**
+     * Standard create affordance. The host owns authorization and the actual
+     * create flow; disabledReason is exposed through the shared tooltip.
+     */
+    add?: {
+        onAdd: () => void | Promise<void>;
+        disabled?: boolean;
+        disabledReason?: string;
+    };
+    /** Right-side domain actions, rendered after standard table controls. */
     actions?: ReactNode;
 }
+/** Query fields safe to persist in a named table view. */
+type TableViewQuery = Omit<MatrxDataTableQueryState, "page">;
+/** Portable, persistence-neutral table state saved by a host adapter. */
+interface TableViewSnapshot {
+    __kind: "matrx-table-view";
+    version: 1;
+    /** Page/cursor/selection/loaded rows are deliberately never saved. */
+    query: TableViewQuery;
+    columns: {
+        order: string[];
+        hidden: string[];
+    };
+}
+/** Host port for durable named views. The host owns actor, tenancy and CRUD. */
+interface TableSavedViewsProps {
+    tableId: string;
+    snapshot: TableViewSnapshot;
+    defaultSnapshot: TableViewSnapshot;
+    onApply: (snapshot: TableViewSnapshot) => void;
+}
 /** Optional deferred-apply copy for column filter popovers. */
 interface MatrxDataTableFilterUi {
     /** Enables the Include/Exclude control. Default false for remote-safe filters. */
@@ -684,6 +721,8 @@ interface MatrxDataTableSelectionConfig<T> {
 }
 /** Table-owned state and actions exposed to an opt-in phone card renderer. */
 interface MatrxDataTableMobileCardControls {
+    /** Render a declared column with the same editable/draft/link behavior as the grid. */
+    renderCell: (columnId: string) => ReactNode;
     /** Whether this row is in the canonical selection set. */
     selected: boolean;
     /** Whether the consumer allows this row to be selected. */
@@ -699,6 +738,10 @@ interface MatrxDataTableMobileCardControls {
 interface MatrxDataTableProps<T> {
     data: T[];
     columns: MatrxColumnDef<T>[];
+    /** Stable persistence identity for host-installed named views. */
+    tableId?: string;
+    /** Declared reset state for the host Saved Views control. */
+    defaultViewSnapshot?: TableViewSnapshot;
     /** Optional URL/source-owned column order and visibility. */
     columnState?: {
         order: string[];
@@ -708,7 +751,7 @@ interface MatrxDataTableProps<T> {
             hidden: string[];
         }) => void;
     };
-    /** Enables package-owned drag reordering in table headers. */
+    /** Enables package-owned drag reordering in table headers. Default true. */
     reorderableColumns?: boolean;
     columnManager?: {
         open: boolean;
@@ -826,4 +869,4 @@ interface MatrxDataTableProps<T> {
     onRowOpen?: (row: T) => void;
 }
 
-export { type AnyOfColumnSearch as A, LAYERED_FILTER_OPERATOR_LABELS as B, type ColumnFiltersState as C, type LayeredFilterField as D, type LayeredFilterOperator as E, columnFiltersToLayeredRules as F, completeLayeredFilterRules as G, decodeLayeredFilterRules as H, encodeLayeredFilterRules as I, isCompleteLayeredFilterRule as J, isLayeredFilterOperator as K, type LayeredFilterRule as L, type MatrxColumnDef as M, layeredFilterMatchesValue as N, layeredFilterNeedsValue as O, layeredFilterRuleSummary as P, operatorsForLayeredField as Q, type SortState as S, type TableSearchMatchMode as T, type ColumnFilterValue as a, type MatrxDataTableProps as b, type CellEditType as c, type CellEditsMap as d, type ColumnFilterKind as e, type MatrxDataTableCopyConfig as f, type MatrxDataTableDetailConfig as g, type MatrxDataTableEditConfig as h, type MatrxDataTableEmptyState as i, type MatrxDataTableFilterUi as j, type MatrxDataTableHierarchyConfig as k, type MatrxDataTableHierarchyMove as l, type MatrxDataTableMobileCardControls as m, type MatrxDataTableQueryControl as n, type MatrxDataTableQueryState as o, type MatrxDataTableRecordControls as p, type MatrxDataTableSelectionConfig as q, type MatrxDataTableSourceProcessing as r, type MatrxDataTableToolbar as s, type MatrxDataTableUrlStateConfig as t, type MatrxDataTableWindowConfig as u, type MatrxTablePagination as v, type SortDirection as w, type TextFilterMode as x, type ToolbarFacet as y, LAYERED_FILTER_OPERATORS as z };
+export { type AnyOfColumnSearch as A, type TextFilterMode as B, type ColumnFiltersState as C, type ToolbarFacet as D, LAYERED_FILTER_OPERATORS as E, LAYERED_FILTER_OPERATOR_LABELS as F, type LayeredFilterField as G, type LayeredFilterOperator as H, columnFiltersToLayeredRules as I, completeLayeredFilterRules as J, decodeLayeredFilterRules as K, type LayeredFilterRule as L, type MatrxColumnDef as M, encodeLayeredFilterRules as N, isCompleteLayeredFilterRule as O, isLayeredFilterOperator as P, layeredFilterMatchesValue as Q, layeredFilterNeedsValue as R, type SortState as S, type TableSearchMatchMode as T, layeredFilterRuleSummary as U, operatorsForLayeredField as V, type ColumnFilterValue as a, type MatrxDataTableProps as b, type TableViewSnapshot as c, type CellEditType as d, type CellEditsMap as e, type ColumnFilterKind as f, type MatrxDataTableCopyConfig as g, type MatrxDataTableDetailConfig as h, type MatrxDataTableEditConfig as i, type MatrxDataTableEmptyState as j, type MatrxDataTableFilterUi as k, type MatrxDataTableHierarchyConfig as l, type MatrxDataTableHierarchyMove as m, type MatrxDataTableMobileCardControls as n, type MatrxDataTableQueryControl as o, type MatrxDataTableQueryState as p, type MatrxDataTableRecordControls as q, type MatrxDataTableSelectionConfig as r, type MatrxDataTableSourceProcessing as s, type MatrxDataTableToolbar as t, type MatrxDataTableUrlStateConfig as u, type MatrxDataTableWindowConfig as v, type MatrxTablePagination as w, type SortDirection as x, type TableSavedViewsProps as y, type TableViewQuery as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/design-system",
-  "version": "0.18.8",
+  "version": "0.18.10",
   "description": "AI Matrx semantic React primitives shared across Vite, Next.js, desktop, and customer-built applications.",
   "type": "module",
   "license": "MIT",