@ai-matrx/design-system 0.48.16 → 0.49.2

package/dist/{types-bIcXnlYS.d.cts → types-ClxgLUFi.d.cts}

@@ -1033,6 +1033,37 @@ interface MatrxDataTableRead {
     /** What was read, in the reader's words ("your tasks"). Default "these rows". */
     what?: string | undefined;
 }
+/** The rows a table summary is allowed to describe. */
+interface MatrxDataTableSummaryContext<T> {
+    /** Filtered and sorted rows, always before pagination. */
+    rows: readonly T[];
+    /** True when any table-owned search, facet, or column filter is active. */
+    isFiltered: boolean;
+    /** Whether the browser holds all matching rows, loaded rows, or one controlled page. */
+    coverage: "all" | "loaded" | "page";
+}
+interface MatrxDataTableSummaryMetric<T> {
+    id: string;
+    /** Plain text keeps the KPI's visible label and unavailable announcement identical. */
+    label: string;
+    value: (context: MatrxDataTableSummaryContext<T>) => ReactNode;
+}
+/**
+ * Optional KPIs and aligned column totals owned by the canonical table.
+ *
+ * Callback totals run over the filtered/sorted row set before pagination. A
+ * source override is for an externally computed aggregate: once declared, the
+ * table never substitutes its loaded rows for a missing source value.
+ */
+interface MatrxDataTableSummaryConfig<T> {
+    metrics: MatrxDataTableSummaryMetric<T>[];
+    totals?: Record<string, (context: MatrxDataTableSummaryContext<T>) => ReactNode>;
+    source?: {
+        isFiltered: boolean;
+        metrics?: Record<string, ReactNode>;
+        totals?: Record<string, ReactNode>;
+    };
+}
 /** Pending cell edits keyed by row id → partial field map. */
 type CellEditsMap = Record<string, Record<string, unknown>>;
 interface MatrxDataTableEditConfig<T> {
@@ -1577,6 +1608,8 @@ interface MatrxDataTableProps<T> {
     rowActions?: (row: T, controls: MatrxDataTableRecordControls) => ReactNode;
     /** Extra rows rendered in the table footer with the same columns as data rows. */
     footerRows?: T[];
+    /** Optional KPIs above the toolbar and aligned totals in the canonical footer. */
+    summary?: MatrxDataTableSummaryConfig<T>;
     /** Per-row presentation class, after canonical selection/highlight state. */
     rowClassName?: (row: T, index: number) => string | undefined;
     /**
@@ -1718,4 +1751,4 @@ interface MatrxDataTableProps<T> {
     onRowOpen?: (row: T) => void;
 }
 
-export { TableViewTabs as $, type AnyOfColumnSearch as A, type MatrxDataTableQueryControl as B, type ColumnFiltersState as C, type MatrxDataTableReadStatus as D, type MatrxDataTableSelectionConfig as E, type MatrxDataTableSingleExpandedDetailConfig as F, type MatrxDataTableSourceProcessing as G, type MatrxDataTableSpreadsheetConfig as H, type MatrxDataTableStyleConfig as I, type MatrxDataTableToolbar as J, type MatrxDataTableUrlStateConfig as K, type LayeredFilterRule as L, type MatrxColumnDef as M, type MatrxDataTableVirtualizeConfig as N, type MatrxDataTableWindowConfig as O, type MatrxTablePagination as P, type NumberFilterOp as Q, type SavedTableViewTab as R, type SortState as S, type TableSearchMatchMode as T, type SortDirection as U, type SpreadsheetSelection as V, type TableRankedSearchOptions as W, type TableSearchRole as X, type TableSearchScope as Y, type TableViewQuery as Z, type TableViewTab as _, type ColumnFilterValue as a, type TableViewTabsProps as a0, type TableViewTabsStore as a1, type TextFilterMode as a2, type ToolbarFacet as a3, inferTableSearchRole as a4, rankTableSearchRows as a5, resolveTableSearchScopes as a6, LAYERED_FILTER_OPERATORS as a7, LAYERED_FILTER_OPERATOR_LABELS as a8, type LayeredFilterField as a9, type LayeredFilterOperator as aa, columnFiltersToLayeredRules as ab, completeLayeredFilterRules as ac, decodeLayeredFilterRules as ad, encodeLayeredFilterRules as ae, isCompleteLayeredFilterRule as af, isLayeredFilterOperator as ag, layeredFilterMatchesValue as ah, layeredFilterNeedsValue as ai, layeredFilterRuleSummary as aj, operatorsForLayeredField as ak, type TableSavedViewsProps as b, type MatrxDataTableDensity as c, type MatrxDataTableRecordControls as d, type MatrxDataTableQueryState as e, type ColumnFilterKind as f, type MatrxDataTableCopyConfig as g, type MatrxDataTableProps as h, type TableViewSnapshot as i, type MatrxDataTableRead as j, type ColumnMarker as k, type CellEditType as l, type CellEditsMap as m, type MatrxDataTableContextMenuConfig as n, type MatrxDataTableCoverageConfig as o, type MatrxDataTableDetailConfig as p, type MatrxDataTableEditConfig as q, type MatrxDataTableEmptyState as r, type MatrxDataTableExpandedDetailConfig as s, type MatrxDataTableFacetsConfig as t, type MatrxDataTableFilterUi as u, type MatrxDataTableGroupingConfig as v, type MatrxDataTableHierarchyConfig as w, type MatrxDataTableHierarchyMove as x, type MatrxDataTableMobileCardControls as y, type MatrxDataTableMultiExpandedDetailConfig as z };
+export { type TableSearchScope as $, type AnyOfColumnSearch as A, type MatrxDataTableQueryControl as B, type ColumnFiltersState as C, type MatrxDataTableReadStatus as D, type MatrxDataTableSelectionConfig as E, type MatrxDataTableSingleExpandedDetailConfig as F, type MatrxDataTableSourceProcessing as G, type MatrxDataTableSpreadsheetConfig as H, type MatrxDataTableStyleConfig as I, type MatrxDataTableSummaryConfig as J, type MatrxDataTableSummaryContext as K, type LayeredFilterRule as L, type MatrxColumnDef as M, type MatrxDataTableSummaryMetric as N, type MatrxDataTableToolbar as O, type MatrxDataTableUrlStateConfig as P, type MatrxDataTableVirtualizeConfig as Q, type MatrxDataTableWindowConfig as R, type SortState as S, type TableSearchMatchMode as T, type MatrxTablePagination as U, type NumberFilterOp as V, type SavedTableViewTab as W, type SortDirection as X, type SpreadsheetSelection as Y, type TableRankedSearchOptions as Z, type TableSearchRole as _, type ColumnFilterValue as a, type TableViewQuery as a0, type TableViewTab as a1, TableViewTabs as a2, type TableViewTabsProps as a3, type TableViewTabsStore as a4, type TextFilterMode as a5, type ToolbarFacet as a6, inferTableSearchRole as a7, rankTableSearchRows as a8, resolveTableSearchScopes as a9, LAYERED_FILTER_OPERATORS as aa, LAYERED_FILTER_OPERATOR_LABELS as ab, type LayeredFilterField as ac, type LayeredFilterOperator as ad, columnFiltersToLayeredRules as ae, completeLayeredFilterRules as af, decodeLayeredFilterRules as ag, encodeLayeredFilterRules as ah, isCompleteLayeredFilterRule as ai, isLayeredFilterOperator as aj, layeredFilterMatchesValue as ak, layeredFilterNeedsValue as al, layeredFilterRuleSummary as am, operatorsForLayeredField as an, type TableSavedViewsProps as b, type MatrxDataTableDensity as c, type MatrxDataTableRecordControls as d, type MatrxDataTableQueryState as e, type ColumnFilterKind as f, type MatrxDataTableCopyConfig as g, type MatrxDataTableProps as h, type TableViewSnapshot as i, type MatrxDataTableRead as j, type ColumnMarker as k, type CellEditType as l, type CellEditsMap as m, type MatrxDataTableContextMenuConfig as n, type MatrxDataTableCoverageConfig as o, type MatrxDataTableDetailConfig as p, type MatrxDataTableEditConfig as q, type MatrxDataTableEmptyState as r, type MatrxDataTableExpandedDetailConfig as s, type MatrxDataTableFacetsConfig as t, type MatrxDataTableFilterUi as u, type MatrxDataTableGroupingConfig as v, type MatrxDataTableHierarchyConfig as w, type MatrxDataTableHierarchyMove as x, type MatrxDataTableMobileCardControls as y, type MatrxDataTableMultiExpandedDetailConfig as z };

package/dist/{types-DVTNnzU5.d.ts → types-DlgTSJsC.d.ts}

@@ -1033,6 +1033,37 @@ interface MatrxDataTableRead {
     /** What was read, in the reader's words ("your tasks"). Default "these rows". */
     what?: string | undefined;
 }
+/** The rows a table summary is allowed to describe. */
+interface MatrxDataTableSummaryContext<T> {
+    /** Filtered and sorted rows, always before pagination. */
+    rows: readonly T[];
+    /** True when any table-owned search, facet, or column filter is active. */
+    isFiltered: boolean;
+    /** Whether the browser holds all matching rows, loaded rows, or one controlled page. */
+    coverage: "all" | "loaded" | "page";
+}
+interface MatrxDataTableSummaryMetric<T> {
+    id: string;
+    /** Plain text keeps the KPI's visible label and unavailable announcement identical. */
+    label: string;
+    value: (context: MatrxDataTableSummaryContext<T>) => ReactNode;
+}
+/**
+ * Optional KPIs and aligned column totals owned by the canonical table.
+ *
+ * Callback totals run over the filtered/sorted row set before pagination. A
+ * source override is for an externally computed aggregate: once declared, the
+ * table never substitutes its loaded rows for a missing source value.
+ */
+interface MatrxDataTableSummaryConfig<T> {
+    metrics: MatrxDataTableSummaryMetric<T>[];
+    totals?: Record<string, (context: MatrxDataTableSummaryContext<T>) => ReactNode>;
+    source?: {
+        isFiltered: boolean;
+        metrics?: Record<string, ReactNode>;
+        totals?: Record<string, ReactNode>;
+    };
+}
 /** Pending cell edits keyed by row id → partial field map. */
 type CellEditsMap = Record<string, Record<string, unknown>>;
 interface MatrxDataTableEditConfig<T> {
@@ -1577,6 +1608,8 @@ interface MatrxDataTableProps<T> {
     rowActions?: (row: T, controls: MatrxDataTableRecordControls) => ReactNode;
     /** Extra rows rendered in the table footer with the same columns as data rows. */
     footerRows?: T[];
+    /** Optional KPIs above the toolbar and aligned totals in the canonical footer. */
+    summary?: MatrxDataTableSummaryConfig<T>;
     /** Per-row presentation class, after canonical selection/highlight state. */
     rowClassName?: (row: T, index: number) => string | undefined;
     /**
@@ -1718,4 +1751,4 @@ interface MatrxDataTableProps<T> {
     onRowOpen?: (row: T) => void;
 }
 
-export { TableViewTabs as $, type AnyOfColumnSearch as A, type MatrxDataTableQueryControl as B, type ColumnFiltersState as C, type MatrxDataTableReadStatus as D, type MatrxDataTableSelectionConfig as E, type MatrxDataTableSingleExpandedDetailConfig as F, type MatrxDataTableSourceProcessing as G, type MatrxDataTableSpreadsheetConfig as H, type MatrxDataTableStyleConfig as I, type MatrxDataTableToolbar as J, type MatrxDataTableUrlStateConfig as K, type LayeredFilterRule as L, type MatrxColumnDef as M, type MatrxDataTableVirtualizeConfig as N, type MatrxDataTableWindowConfig as O, type MatrxTablePagination as P, type NumberFilterOp as Q, type SavedTableViewTab as R, type SortState as S, type TableSearchMatchMode as T, type SortDirection as U, type SpreadsheetSelection as V, type TableRankedSearchOptions as W, type TableSearchRole as X, type TableSearchScope as Y, type TableViewQuery as Z, type TableViewTab as _, type ColumnFilterValue as a, type TableViewTabsProps as a0, type TableViewTabsStore as a1, type TextFilterMode as a2, type ToolbarFacet as a3, inferTableSearchRole as a4, rankTableSearchRows as a5, resolveTableSearchScopes as a6, LAYERED_FILTER_OPERATORS as a7, LAYERED_FILTER_OPERATOR_LABELS as a8, type LayeredFilterField as a9, type LayeredFilterOperator as aa, columnFiltersToLayeredRules as ab, completeLayeredFilterRules as ac, decodeLayeredFilterRules as ad, encodeLayeredFilterRules as ae, isCompleteLayeredFilterRule as af, isLayeredFilterOperator as ag, layeredFilterMatchesValue as ah, layeredFilterNeedsValue as ai, layeredFilterRuleSummary as aj, operatorsForLayeredField as ak, type TableSavedViewsProps as b, type MatrxDataTableDensity as c, type MatrxDataTableRecordControls as d, type MatrxDataTableQueryState as e, type ColumnFilterKind as f, type MatrxDataTableCopyConfig as g, type MatrxDataTableProps as h, type TableViewSnapshot as i, type MatrxDataTableRead as j, type ColumnMarker as k, type CellEditType as l, type CellEditsMap as m, type MatrxDataTableContextMenuConfig as n, type MatrxDataTableCoverageConfig as o, type MatrxDataTableDetailConfig as p, type MatrxDataTableEditConfig as q, type MatrxDataTableEmptyState as r, type MatrxDataTableExpandedDetailConfig as s, type MatrxDataTableFacetsConfig as t, type MatrxDataTableFilterUi as u, type MatrxDataTableGroupingConfig as v, type MatrxDataTableHierarchyConfig as w, type MatrxDataTableHierarchyMove as x, type MatrxDataTableMobileCardControls as y, type MatrxDataTableMultiExpandedDetailConfig as z };
+export { type TableSearchScope as $, type AnyOfColumnSearch as A, type MatrxDataTableQueryControl as B, type ColumnFiltersState as C, type MatrxDataTableReadStatus as D, type MatrxDataTableSelectionConfig as E, type MatrxDataTableSingleExpandedDetailConfig as F, type MatrxDataTableSourceProcessing as G, type MatrxDataTableSpreadsheetConfig as H, type MatrxDataTableStyleConfig as I, type MatrxDataTableSummaryConfig as J, type MatrxDataTableSummaryContext as K, type LayeredFilterRule as L, type MatrxColumnDef as M, type MatrxDataTableSummaryMetric as N, type MatrxDataTableToolbar as O, type MatrxDataTableUrlStateConfig as P, type MatrxDataTableVirtualizeConfig as Q, type MatrxDataTableWindowConfig as R, type SortState as S, type TableSearchMatchMode as T, type MatrxTablePagination as U, type NumberFilterOp as V, type SavedTableViewTab as W, type SortDirection as X, type SpreadsheetSelection as Y, type TableRankedSearchOptions as Z, type TableSearchRole as _, type ColumnFilterValue as a, type TableViewQuery as a0, type TableViewTab as a1, TableViewTabs as a2, type TableViewTabsProps as a3, type TableViewTabsStore as a4, type TextFilterMode as a5, type ToolbarFacet as a6, inferTableSearchRole as a7, rankTableSearchRows as a8, resolveTableSearchScopes as a9, LAYERED_FILTER_OPERATORS as aa, LAYERED_FILTER_OPERATOR_LABELS as ab, type LayeredFilterField as ac, type LayeredFilterOperator as ad, columnFiltersToLayeredRules as ae, completeLayeredFilterRules as af, decodeLayeredFilterRules as ag, encodeLayeredFilterRules as ah, isCompleteLayeredFilterRule as ai, isLayeredFilterOperator as aj, layeredFilterMatchesValue as ak, layeredFilterNeedsValue as al, layeredFilterRuleSummary as am, operatorsForLayeredField as an, type TableSavedViewsProps as b, type MatrxDataTableDensity as c, type MatrxDataTableRecordControls as d, type MatrxDataTableQueryState as e, type ColumnFilterKind as f, type MatrxDataTableCopyConfig as g, type MatrxDataTableProps as h, type TableViewSnapshot as i, type MatrxDataTableRead as j, type ColumnMarker as k, type CellEditType as l, type CellEditsMap as m, type MatrxDataTableContextMenuConfig as n, type MatrxDataTableCoverageConfig as o, type MatrxDataTableDetailConfig as p, type MatrxDataTableEditConfig as q, type MatrxDataTableEmptyState as r, type MatrxDataTableExpandedDetailConfig as s, type MatrxDataTableFacetsConfig as t, type MatrxDataTableFilterUi as u, type MatrxDataTableGroupingConfig as v, type MatrxDataTableHierarchyConfig as w, type MatrxDataTableHierarchyMove as x, type MatrxDataTableMobileCardControls as y, type MatrxDataTableMultiExpandedDetailConfig as z };

package/package.json

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