@ai-matrx/design-system 0.36.0 → 0.38.0

package/dist/{types-Cxm5XK0L.d.ts → types-B8vwElPz.d.ts}

@@ -2,7 +2,7 @@ import { ContentTransferReference } from './content-transfer.js';
 import { ReactNode } from 'react';
 import { AiVariant, AiCustomSource, CopyExportConfig } from './data-table/copy-types.js';
 import { F as FieldFormatConfig } from './types-CJWU1Gae.js';
-import { GroupAggregateSpec, GroupOrder } from './data-table/grouping.js';
+import { GroupAggregateSpec, GroupOrder, TableGroup } from './data-table/grouping.js';
 import { CellPatch } from './data-table/fill.js';
 import { ColumnFacets } from './data-table/facets.js';
 import { SpreadsheetIntent, SpreadsheetPastePlan } from './data-table/spreadsheet.js';
@@ -689,8 +689,19 @@ interface AnyOfColumnSearch {
 interface MatrxDataTableToolbar {
     /** Optional human-readable table title, rendered by the shared title row. */
     title?: string;
+    /** Source-owned total displayed beside the shared title. */
+    titleCount?: {
+        value: number;
+        label: string;
+    };
     /** Global search across all accessor values. Default true. */
     search?: boolean;
+    /**
+     * A caller-owned search control for a deliberately narrower query contract.
+     * It occupies the canonical title-row search slot and never changes table
+     * query state, so the caller remains honest about its source boundary.
+     */
+    customSearch?: ReactNode;
     searchPlaceholder?: string;
     searchValue?: string;
     onSearchChange?: (value: string) => void;
@@ -1181,6 +1192,12 @@ interface MatrxDataTableGroupingConfig<T> {
     emptyLabel?: string | undefined;
     /** Singular noun for a group's summary ("job" → "12 jobs"). */
     rowNoun?: string | undefined;
+    /**
+     * Replaces the group's plain-text label while retaining the canonical
+     * collapse control, count, and aggregate cells. Use when a group identity is
+     * an addressable platform entity and must keep its Open/new-tab/Peek doors.
+     */
+    renderLabel?: ((group: TableGroup<T>) => ReactNode) | undefined;
     /**
      * Reads the grouping value for a column. Defaults to the column's own
      * accessor.
@@ -1227,6 +1244,11 @@ interface MatrxDataTableVirtualizeConfig {
  * whose rows are all in hand.
  */
 interface MatrxDataTableCoverageConfig {
+    /**
+     * Number of rows loaded from the source before the host narrows `data` with
+     * a domain filter. Defaults to `data.length`.
+     */
+    loaded?: number | undefined;
     /** Rows the source says match the current query, when it can say. */
     matched?: number | undefined;
     /** Rows in the table irrespective of the query, when known. */
@@ -1425,6 +1447,8 @@ interface MatrxDataTableProps<T> {
     hideToolbar?: boolean;
     /** Hide numbered pagination; local rows remain available to the caller. */
     hidePagination?: boolean;
+    /** Host wording for a controlled source range when visible rows are a local projection. */
+    paginationLabelFormat?: (start: number, end: number, total: number) => string;
     /** Optional deferred Apply/Cancel copy for column filter popovers. */
     filterUi?: MatrxDataTableFilterUi;
     /** Row click opens the side panel unless `window.openOnRowClick` is true. */

package/dist/{types-kiV-CAuZ.d.cts → types-BuMHbFjs.d.cts}

@@ -2,7 +2,7 @@ import { ContentTransferReference } from './content-transfer.cjs';
 import { ReactNode } from 'react';
 import { AiVariant, AiCustomSource, CopyExportConfig } from './data-table/copy-types.cjs';
 import { F as FieldFormatConfig } from './types-CJWU1Gae.cjs';
-import { GroupAggregateSpec, GroupOrder } from './data-table/grouping.cjs';
+import { GroupAggregateSpec, GroupOrder, TableGroup } from './data-table/grouping.cjs';
 import { CellPatch } from './data-table/fill.cjs';
 import { ColumnFacets } from './data-table/facets.cjs';
 import { SpreadsheetIntent, SpreadsheetPastePlan } from './data-table/spreadsheet.cjs';
@@ -689,8 +689,19 @@ interface AnyOfColumnSearch {
 interface MatrxDataTableToolbar {
     /** Optional human-readable table title, rendered by the shared title row. */
     title?: string;
+    /** Source-owned total displayed beside the shared title. */
+    titleCount?: {
+        value: number;
+        label: string;
+    };
     /** Global search across all accessor values. Default true. */
     search?: boolean;
+    /**
+     * A caller-owned search control for a deliberately narrower query contract.
+     * It occupies the canonical title-row search slot and never changes table
+     * query state, so the caller remains honest about its source boundary.
+     */
+    customSearch?: ReactNode;
     searchPlaceholder?: string;
     searchValue?: string;
     onSearchChange?: (value: string) => void;
@@ -1181,6 +1192,12 @@ interface MatrxDataTableGroupingConfig<T> {
     emptyLabel?: string | undefined;
     /** Singular noun for a group's summary ("job" → "12 jobs"). */
     rowNoun?: string | undefined;
+    /**
+     * Replaces the group's plain-text label while retaining the canonical
+     * collapse control, count, and aggregate cells. Use when a group identity is
+     * an addressable platform entity and must keep its Open/new-tab/Peek doors.
+     */
+    renderLabel?: ((group: TableGroup<T>) => ReactNode) | undefined;
     /**
      * Reads the grouping value for a column. Defaults to the column's own
      * accessor.
@@ -1227,6 +1244,11 @@ interface MatrxDataTableVirtualizeConfig {
  * whose rows are all in hand.
  */
 interface MatrxDataTableCoverageConfig {
+    /**
+     * Number of rows loaded from the source before the host narrows `data` with
+     * a domain filter. Defaults to `data.length`.
+     */
+    loaded?: number | undefined;
     /** Rows the source says match the current query, when it can say. */
     matched?: number | undefined;
     /** Rows in the table irrespective of the query, when known. */
@@ -1425,6 +1447,8 @@ interface MatrxDataTableProps<T> {
     hideToolbar?: boolean;
     /** Hide numbered pagination; local rows remain available to the caller. */
     hidePagination?: boolean;
+    /** Host wording for a controlled source range when visible rows are a local projection. */
+    paginationLabelFormat?: (start: number, end: number, total: number) => string;
     /** Optional deferred Apply/Cancel copy for column filter popovers. */
     filterUi?: MatrxDataTableFilterUi;
     /** Row click opens the side panel unless `window.openOnRowClick` is true. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/design-system",
-  "version": "0.36.0",
+  "version": "0.38.0",
   "description": "AI Matrx semantic React primitives shared across Vite, Next.js, desktop, and customer-built applications.",
   "type": "module",
   "license": "MIT",
@@ -399,7 +399,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
-    "react-resizable-panels": "^4.12.4",
+    "react-resizable-panels": "^4.13.2",
     "tailwind-merge": "^3.7.0",
     "vaul": "^1.1.2",
     "xlsx": "^0.18.5",
@@ -414,18 +414,18 @@
     "@arethetypeswrong/cli": "^0.18.5",
     "@tailwindcss/vite": "^4.3.3",
     "@testing-library/react": "^16.3.3",
-    "@types/node": "^26.6.1",
+    "@types/node": "^26.6.2",
     "@types/react": "19.3.0",
     "@types/react-dom": "19.3.0",
-    "@vitejs/plugin-react": "^5.1.1",
-    "jsdom": "^30.0.1",
+    "@vitejs/plugin-react": "^5.2.0",
+    "jsdom": "^30.1.1",
     "publint": "^0.3.24",
     "react": "^19.3.0",
     "react-dom": "^19.3.0",
     "tailwindcss": "^4.3.3",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "vite": "^7.3.1",
+    "typescript": "^6.0.3",
+    "vite": "^7.3.6",
     "vitest": "^5.0.1"
   },
   "publishConfig": {