@ai-matrx/design-system 0.18.4 → 0.18.5

package/dist/data-table/copy-helpers.cjs

@@ -20,14 +20,19 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/data-table/tableCopy.ts
 var tableCopy_exports = {};
 __export(tableCopy_exports, {
+  buildDefaultTableRowAgentInput: () => buildDefaultTableRowAgentInput,
+  buildDefaultTableViewAgentInput: () => buildDefaultTableViewAgentInput,
   buildRowAgentInput: () => buildRowAgentInput,
   buildViewAgentInput: () => buildViewAgentInput,
   buildViewHuman: () => buildViewHuman,
+  formatDefaultTableCopyRecord: () => formatDefaultTableCopyRecord,
+  projectDefaultTableCopyRow: () => projectDefaultTableCopyRow,
   rowsToCsvFromColumns: () => rowsToCsvFromColumns,
   rowsToMarkdownTable: () => rowsToMarkdownTable,
   rowsToRecordsFromColumns: () => rowsToRecordsFromColumns
 });
 module.exports = __toCommonJS(tableCopy_exports);
+var import_content_transfer = require("@ai-matrx/kit/content-transfer");
 
 // src/data-table/filter-engine.ts
 function columnId(col) {
@@ -57,6 +62,54 @@ function stringifyCellValue(value) {
 }
 
 // src/data-table/tableCopy.ts
+function projectDefaultTableCopyRow(row, columns) {
+  const record = /* @__PURE__ */ Object.create(null);
+  for (const column of columns) {
+    const value = getCellValue(row, column);
+    if (value !== void 0) record[columnId(column)] = value;
+  }
+  return (0, import_content_transfer.normalizeTransferJson)(record, { omitUndefinedObjectProperties: true });
+}
+function buildDefaultTableViewAgentInput(config, rows, all, columns, meta) {
+  const projected = rows.map((row) => projectDefaultTableCopyRow(row, columns));
+  return {
+    kind: config.listKind,
+    location: config.location,
+    description: meta?.scope === "selected" ? `${projected.length} selected ${projected.length === 1 ? config.label : config.listLabel ?? `${config.label} rows`}.` : config.listDescription ?? `${config.listLabel ?? config.label} \u2014 current filtered/sorted view.`,
+    data: projected,
+    summary: projected.map((record) => formatDefaultTableCopyRecord(record, columns)).join("\n---\n"),
+    attributes: {
+      visible_count: projected.length,
+      total_count: all.length,
+      search: meta?.search || void 0,
+      search_match: meta?.search ? meta.searchMatchMode : void 0,
+      any_of: meta?.anyOf || void 0,
+      active_filters: meta?.filterCount ?? 0,
+      sort: meta?.sort || void 0,
+      scope: meta?.scope ?? "view",
+      ...config.listAttributes?.(rows, all)
+    },
+    ...config.listContext ? { context: config.listContext(rows, all) } : {}
+  };
+}
+function buildDefaultTableRowAgentInput(config, row, columns) {
+  const projected = projectDefaultTableCopyRow(row, columns);
+  return {
+    kind: config.rowKind,
+    location: config.location,
+    description: config.rowDescription ?? `One ${config.label} row.`,
+    data: projected,
+    summary: formatDefaultTableCopyRecord(projected, columns),
+    ...config.rowAttributes ? { attributes: config.rowAttributes(row) } : {}
+  };
+}
+function formatDefaultTableCopyRecord(record, columns) {
+  return columns.map((column) => {
+    const id = columnId(column);
+    const label = column.label ?? (typeof column.header === "string" ? column.header : id);
+    return `${label}: ${stringifyCellValue(record[id])}`;
+  }).join("\n");
+}
 function rowsToMarkdownTable(rows, columns) {
   const cols = columns.filter((c) => c.filter !== false || c.accessorKey);
   if (cols.length === 0) return "";

package/dist/data-table/copy-helpers.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/data-table/tableCopy.ts","../../src/data-table/filter-engine.ts"],"sourcesContent":["import type { AgentPayloadInput } from \"./copy\";\nimport type { MatrxColumnDef, MatrxDataTableCopyConfig } from \"./types\";\nimport { columnId, getCellValue, stringifyCellValue } from \"./filter-engine\";\n\n/** Human markdown table of the current view (visible columns × rows). */\nexport function rowsToMarkdownTable<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n): string {\n  const cols = columns.filter((c) => c.filter !== false || c.accessorKey);\n  if (cols.length === 0) return \"\";\n  const headers = cols.map((c) => {\n    if (typeof c.header === \"string\") return c.header;\n    return columnId(c);\n  });\n  const lines = [\n    `| ${headers.join(\" | \")} |`,\n    `| ${headers.map(() => \"---\").join(\" | \")} |`,\n  ];\n  for (const row of rows) {\n    const cells = cols.map((c) =>\n      stringifyCellValue(getCellValue(row, c)).replace(/\\|/g, \"\\\\|\"),\n    );\n    lines.push(`| ${cells.join(\" | \")} |`);\n  }\n  return lines.join(\"\\n\");\n}\n\nexport function buildRowAgentInput<T>(\n  config: MatrxDataTableCopyConfig<T>,\n  row: T,\n): AgentPayloadInput {\n  return {\n    kind: config.rowKind,\n    location: config.location,\n    description: config.rowDescription ?? `One ${config.label} row.`,\n    data: config.agentRow ? config.agentRow(row) : row,\n    summary: config.humanRow(row),\n    ...(config.rowAttributes ? { attributes: config.rowAttributes(row) } : {}),\n  };\n}\n\nexport function buildViewAgentInput<T>(\n  config: MatrxDataTableCopyConfig<T>,\n  visible: T[],\n  all: T[],\n  meta?: {\n    search?: string;\n    searchMatchMode?: string;\n    anyOf?: string;\n    filterCount?: number;\n    sort?: string | null;\n    /** `custom` = shaped in the copy-subset window (filter & sort before copying). */\n    scope?: \"view\" | \"selected\" | \"custom\";\n  },\n): AgentPayloadInput {\n  return {\n    kind: config.listKind,\n    location: config.location,\n    description:\n      meta?.scope === \"selected\"\n        ? `${visible.length} selected ${visible.length === 1 ? config.label : (config.listLabel ?? `${config.label} rows`)}.`\n        : (config.listDescription ??\n          `${config.listLabel ?? config.label} — current filtered/sorted view.`),\n    data: visible.map((r) => (config.agentRow ? config.agentRow(r) : r)),\n    summary: visible.map((r) => config.humanRow(r)).join(\"\\n---\\n\"),\n    attributes: {\n      visible_count: visible.length,\n      total_count: all.length,\n      search: meta?.search || undefined,\n      search_match: meta?.search ? meta.searchMatchMode : undefined,\n      any_of: meta?.anyOf || undefined,\n      active_filters: meta?.filterCount ?? 0,\n      sort: meta?.sort || undefined,\n      scope: meta?.scope ?? \"view\",\n      ...config.listAttributes?.(visible, all),\n    },\n    ...(config.listContext ? { context: config.listContext(visible, all) } : {}),\n  };\n}\n\n/** CSV of the current view (visible columns × rows), for ExportMenu. */\nexport function rowsToCsvFromColumns<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n): string {\n  const cols = columns.filter((c) => c.filter !== false || c.accessorKey);\n  const escape = (value: string) =>\n    /[\",\\n\\r]/.test(value) ? `\"${value.replace(/\"/g, '\"\"')}\"` : value;\n  const lines = [\n    cols\n      .map((c) => escape(typeof c.header === \"string\" ? c.header : columnId(c)))\n      .join(\",\"),\n  ];\n  for (const row of rows) {\n    lines.push(\n      cols\n        .map((c) => escape(stringifyCellValue(getCellValue(row, c))))\n        .join(\",\"),\n    );\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * The same rows the CSV export produces, as records — the shape a Google Sheet\n * (or any other row destination) takes.\n *\n * It shares `rowsToCsvFromColumns`'s column selection and cell stringification\n * ON PURPOSE: a user who exports the view as CSV and a user who sends it to a\n * Sheet must get the SAME columns, in the same order, with the same values.\n * Two independent row builders is how those two answers start disagreeing.\n */\nexport function rowsToRecordsFromColumns<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n): Array<Record<string, unknown>> {\n  const cols = columns.filter((c) => c.filter !== false || c.accessorKey);\n  const headers = cols.map((c) =>\n    typeof c.header === \"string\" ? c.header : columnId(c),\n  );\n  return rows.map((row) => {\n    const record: Record<string, unknown> = {};\n    cols.forEach((c, index) => {\n      record[headers[index] ?? columnId(c)] = stringifyCellValue(getCellValue(row, c));\n    });\n    return record;\n  });\n}\n\nexport function buildViewHuman<T>(\n  config: MatrxDataTableCopyConfig<T>,\n  visible: T[],\n  columns: MatrxColumnDef<T>[],\n): string {\n  const md = rowsToMarkdownTable(visible, columns);\n  const summaries = visible.map((r) => config.humanRow(r)).join(\"\\n\\n\");\n  return [\n    `${config.listLabel ?? config.label} (${visible.length} rows)`,\n    \"\",\n    md,\n    \"\",\n    \"---\",\n    \"\",\n    summaries,\n  ].join(\"\\n\");\n}\n","import type {\n  ColumnFilterValue,\n  ColumnFiltersState,\n  MatrxColumnDef,\n  SortState,\n  TableSearchMatchMode,\n} from \"./types\";\nimport {\n  completeLayeredFilterRules,\n  layeredFilterMatchesValue,\n  type LayeredFilterRule,\n} from \"./layered-filters\";\n\n/**\n * Sentinel select-filter values for \"no value\" / \"any value\" — every select\n * filter offers them automatically when the column has empty cells, so any\n * table can isolate rows missing a value (or having one) without extra config.\n */\nexport const SELECT_EMPTY_VALUE = \"__empty__\";\nexport const SELECT_NOT_EMPTY_VALUE = \"__not_empty__\";\n\nexport function columnId<T>(col: MatrxColumnDef<T>): string {\n  if (col.id) return col.id;\n  if (col.accessorKey) return String(col.accessorKey);\n  throw new Error(\"MatrxDataTable column requires `id` or `accessorKey`\");\n}\n\nexport function getCellValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  if (col.accessorFn) return col.accessorFn(row);\n  if (col.accessorKey) {\n    return (row as Record<string, unknown>)[col.accessorKey];\n  }\n  return undefined;\n}\n\nexport function getFilterValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  return col.filterValue ? col.filterValue(row) : getCellValue(row, col);\n}\n\nexport function getSortValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  return col.sortValue ? col.sortValue(row) : getCellValue(row, col);\n}\n\nexport function stringifyCellValue(value: unknown): string {\n  if (value == null) return \"\";\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return String(value);\n  }\n  if (value instanceof Date) return value.toISOString();\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\n/** Unicode-aware tokenization shared by whole-word table search. */\nexport function tableSearchWords(value: string): string[] {\n  return value\n    .toLocaleLowerCase()\n    .split(/[^\\p{L}\\p{N}]+/u)\n    .filter(Boolean);\n}\n\n/**\n * Match the primary table search against one row's searchable text. In\n * whole-word mode every entered word must exist as a complete token, so\n * `are` matches `we are ready` but never `hardware`.\n */\nexport function matchesTableSearch(\n  searchableText: string,\n  query: string,\n  mode: TableSearchMatchMode = \"contains\",\n): boolean {\n  const normalizedQuery = query.trim().toLocaleLowerCase();\n  if (!normalizedQuery) return true;\n  if (mode === \"contains\") {\n    return searchableText.toLocaleLowerCase().includes(normalizedQuery);\n  }\n  const actualWords = new Set(tableSearchWords(searchableText));\n  const expectedWords = tableSearchWords(normalizedQuery);\n  return (\n    expectedWords.length > 0 &&\n    expectedWords.every((word) => actualWords.has(word))\n  );\n}\n\nfunction compareValues(a: unknown, b: unknown): number {\n  if (a == null && b == null) return 0;\n  if (a == null) return -1;\n  if (b == null) return 1;\n  if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n  if (typeof a === \"boolean\" && typeof b === \"boolean\") {\n    return Number(a) - Number(b);\n  }\n  return stringifyCellValue(a).localeCompare(stringifyCellValue(b), undefined, {\n    numeric: true,\n    sensitivity: \"base\",\n  });\n}\n\nexport function passesColumnFilter(\n  value: unknown,\n  filter: ColumnFilterValue,\n): boolean {\n  const matches = (() => {\n    switch (filter.kind) {\n    case \"text\": {\n      const s = stringifyCellValue(value);\n      if (filter.mode === \"null\") return value == null;\n      if (filter.mode === \"not_null\") return value != null;\n      if (filter.mode === \"empty\") return s.trim() === \"\";\n      if (filter.mode === \"not_empty\") return s.trim() !== \"\";\n      const q = filter.value.trim().toLowerCase();\n      if (!q) return true;\n      return s.toLowerCase().includes(q);\n    }\n    case \"select\": {\n      const selected =\n        filter.values ??\n        (filter.value && filter.value !== \"__all__\" ? [filter.value] : []);\n      if (selected.length === 0) return true;\n      const s = stringifyCellValue(value);\n      // OR semantics across the set; sentinels compose (\"A or (empty)\").\n      return selected.some((v) =>\n        v === SELECT_EMPTY_VALUE\n          ? s === \"\"\n          : v === SELECT_NOT_EMPTY_VALUE\n            ? s !== \"\"\n            : s === v,\n      );\n    }\n    case \"boolean\": {\n      return Boolean(value) === filter.value;\n    }\n    case \"number\": {\n      const n =\n        typeof value === \"number\"\n          ? value\n          : Number(stringifyCellValue(value).replace(/[^0-9.-]/g, \"\"));\n      if (Number.isNaN(n)) return false;\n      if (filter.min !== undefined && n < filter.min) return false;\n      if (filter.max !== undefined && n > filter.max) return false;\n      return true;\n    }\n    }\n  })();\n  return filter.negated ? !matches : matches;\n}\n\nexport function filterAndSortRows<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n  columnFilters: ColumnFiltersState,\n  sort: SortState | null,\n  globalSearch: string,\n  anyOf?: { columnIds: string[]; query: string },\n  layeredFilters?: readonly LayeredFilterRule[],\n  globalSearchMode: TableSearchMatchMode = \"contains\",\n  searchText?: (row: T) => string,\n): T[] {\n  const colById = new Map(columns.map((c) => [columnId(c), c]));\n  const q = globalSearch.trim().toLowerCase();\n  const anyQ = anyOf?.query.trim().toLowerCase() ?? \"\";\n  const activeLayeredFilters = completeLayeredFilterRules(layeredFilters);\n\n  let result = rows.filter((row) => {\n    for (const [id, filter] of Object.entries(columnFilters)) {\n      if (!filter) continue;\n      const col = colById.get(id);\n      if (!col || col.filter === false) continue;\n      if (!passesColumnFilter(getFilterValue(row, col), filter)) return false;\n    }\n\n    for (const rule of activeLayeredFilters) {\n      const col = colById.get(rule.field);\n      if (!col || !layeredFilterMatchesValue(getFilterValue(row, col), rule)) {\n        return false;\n      }\n    }\n\n    if (anyQ && anyOf) {\n      const hit = anyOf.columnIds.some((id) => {\n        const col = colById.get(id);\n        if (!col) return false;\n        return stringifyCellValue(getFilterValue(row, col))\n          .toLowerCase()\n          .includes(anyQ);\n      });\n      if (!hit) return false;\n    }\n\n    if (!q) return true;\n    const searchableValues = columns\n      .filter(\n        (col) =>\n          col.filter !== false || Boolean(col.accessorKey || col.accessorFn),\n      )\n      .map((col) => stringifyCellValue(getFilterValue(row, col)));\n    const additionalSearchText = searchText?.(row);\n    if (additionalSearchText) searchableValues.push(additionalSearchText);\n    if (globalSearchMode === \"contains\") {\n      return searchableValues.some((value) =>\n        matchesTableSearch(value, q, \"contains\"),\n      );\n    }\n    return matchesTableSearch(searchableValues.join(\" \"), q, \"whole_words\");\n  });\n\n  if (sort) {\n    const col = colById.get(sort.id);\n    if (col && col.sortable !== false) {\n      const dir = sort.direction === \"asc\" ? 1 : -1;\n      result = [...result].sort((a, b) => {\n        const va = getSortValue(a, col);\n        const vb = getSortValue(b, col);\n        // Empty cells (null / \"\") sort LAST in both directions — sorting a\n        // column should surface its values, never a wall of blanks.\n        const ea = va == null || stringifyCellValue(va) === \"\";\n        const eb = vb == null || stringifyCellValue(vb) === \"\";\n        if (ea !== eb) return ea ? 1 : -1;\n        return compareValues(va, vb) * dir;\n      });\n    }\n  }\n\n  return result;\n}\n\nexport function countActiveColumnFilters(filters: ColumnFiltersState): number {\n  let n = 0;\n  for (const f of Object.values(filters)) {\n    if (!f) continue;\n    switch (f.kind) {\n      case \"text\":\n        if (f.value.trim() || (f.mode && f.mode !== \"contains\")) n += 1;\n        break;\n      case \"select\":\n        if (f.values ? f.values.length > 0 : f.value && f.value !== \"__all__\")\n          n += 1;\n        break;\n      case \"boolean\":\n        n += 1;\n        break;\n      case \"number\":\n        if (f.min !== undefined || f.max !== undefined) n += 1;\n        break;\n    }\n  }\n  return n;\n}\n\nexport function isColumnFilterActive(\n  filter: ColumnFilterValue | undefined,\n): boolean {\n  if (!filter) return false;\n  switch (filter.kind) {\n    case \"text\":\n      return (\n        filter.value.trim().length > 0 ||\n        (filter.mode !== undefined && filter.mode !== \"contains\")\n      );\n    case \"select\":\n      return filter.values\n        ? filter.values.length > 0\n        : Boolean(filter.value) && filter.value !== \"__all__\";\n    case \"boolean\":\n      return true;\n    case \"number\":\n      return filter.min !== undefined || filter.max !== undefined;\n  }\n}\n\n/** Apply draft edits onto a row for display (shallow field merge). */\nexport function applyRowEdits<T>(\n  row: T,\n  edits: Record<string, unknown> | undefined,\n): T {\n  if (!edits || Object.keys(edits).length === 0) return row;\n  return { ...row, ...edits };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/data-table/tableCopy.ts","../../src/data-table/filter-engine.ts"],"sourcesContent":["import type { AgentPayloadInput } from \"./copy\";\nimport { normalizeTransferJson } from \"@ai-matrx/kit/content-transfer\";\nimport type { MatrxColumnDef, MatrxDataTableCopyConfig } from \"./types\";\nimport { columnId, getCellValue, stringifyCellValue } from \"./filter-engine\";\n\n/**\n * Typed, declared-column capture for MatrxDataTable's built-in Alchemy source.\n * It deliberately runs only at the transfer boundary: accessor functions can\n * throw useful capture errors, and rendering never evaluates them for copying.\n */\nexport function projectDefaultTableCopyRow<T>(\n  row: T,\n  columns: MatrxColumnDef<T>[],\n): Record<string, unknown> {\n  const record: Record<string, unknown> = Object.create(null) as Record<string, unknown>;\n  for (const column of columns) {\n    const value = getCellValue(row, column);\n    if (value !== undefined) record[columnId(column)] = value;\n  }\n  return normalizeTransferJson(record, { omitUndefinedObjectProperties: true }) as Record<string, unknown>;\n}\n\n/** Builds the default table's AI envelope from one already validated capture. */\nexport function buildDefaultTableViewAgentInput<T>(\n  config: MatrxDataTableCopyConfig<T>,\n  rows: T[],\n  all: T[],\n  columns: MatrxColumnDef<T>[],\n  meta?: Parameters<typeof buildViewAgentInput<T>>[3],\n): AgentPayloadInput {\n  const projected = rows.map((row) => projectDefaultTableCopyRow(row, columns));\n  return {\n    kind: config.listKind,\n    location: config.location,\n    description:\n      meta?.scope === \"selected\"\n        ? `${projected.length} selected ${projected.length === 1 ? config.label : (config.listLabel ?? `${config.label} rows`)}.`\n        : (config.listDescription ?? `${config.listLabel ?? config.label} — current filtered/sorted view.`),\n    data: projected,\n    summary: projected.map((record) => formatDefaultTableCopyRecord(record, columns)).join(\"\\n---\\n\"),\n    attributes: {\n      visible_count: projected.length,\n      total_count: all.length,\n      search: meta?.search || undefined,\n      search_match: meta?.search ? meta.searchMatchMode : undefined,\n      any_of: meta?.anyOf || undefined,\n      active_filters: meta?.filterCount ?? 0,\n      sort: meta?.sort || undefined,\n      scope: meta?.scope ?? \"view\",\n      ...config.listAttributes?.(rows, all),\n    },\n    ...(config.listContext ? { context: config.listContext(rows, all) } : {}),\n  };\n}\n\n/** Builds the default row AI envelope from one validated projection. */\nexport function buildDefaultTableRowAgentInput<T>(\n  config: MatrxDataTableCopyConfig<T>,\n  row: T,\n  columns: MatrxColumnDef<T>[],\n): AgentPayloadInput {\n  const projected = projectDefaultTableCopyRow(row, columns);\n  return {\n    kind: config.rowKind,\n    location: config.location,\n    description: config.rowDescription ?? `One ${config.label} row.`,\n    data: projected,\n    summary: formatDefaultTableCopyRecord(projected, columns),\n    ...(config.rowAttributes ? { attributes: config.rowAttributes(row) } : {}),\n  };\n}\n\nexport function formatDefaultTableCopyRecord<T>(\n  record: Record<string, unknown>,\n  columns: MatrxColumnDef<T>[],\n): string {\n  return columns\n    .map((column) => {\n      const id = columnId(column);\n      const label = column.label ?? (typeof column.header === \"string\" ? column.header : id);\n      return `${label}: ${stringifyCellValue(record[id])}`;\n    })\n    .join(\"\\n\");\n}\n\n/** Human markdown table of the current view (visible columns × rows). */\nexport function rowsToMarkdownTable<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n): string {\n  const cols = columns.filter((c) => c.filter !== false || c.accessorKey);\n  if (cols.length === 0) return \"\";\n  const headers = cols.map((c) => {\n    if (typeof c.header === \"string\") return c.header;\n    return columnId(c);\n  });\n  const lines = [\n    `| ${headers.join(\" | \")} |`,\n    `| ${headers.map(() => \"---\").join(\" | \")} |`,\n  ];\n  for (const row of rows) {\n    const cells = cols.map((c) =>\n      stringifyCellValue(getCellValue(row, c)).replace(/\\|/g, \"\\\\|\"),\n    );\n    lines.push(`| ${cells.join(\" | \")} |`);\n  }\n  return lines.join(\"\\n\");\n}\n\nexport function buildRowAgentInput<T>(\n  config: MatrxDataTableCopyConfig<T>,\n  row: T,\n): AgentPayloadInput {\n  return {\n    kind: config.rowKind,\n    location: config.location,\n    description: config.rowDescription ?? `One ${config.label} row.`,\n    data: config.agentRow ? config.agentRow(row) : row,\n    summary: config.humanRow(row),\n    ...(config.rowAttributes ? { attributes: config.rowAttributes(row) } : {}),\n  };\n}\n\nexport function buildViewAgentInput<T>(\n  config: MatrxDataTableCopyConfig<T>,\n  visible: T[],\n  all: T[],\n  meta?: {\n    search?: string;\n    searchMatchMode?: string;\n    anyOf?: string;\n    filterCount?: number;\n    sort?: string | null;\n    /** `custom` = shaped in the copy-subset window (filter & sort before copying). */\n    scope?: \"view\" | \"selected\" | \"custom\";\n  },\n): AgentPayloadInput {\n  return {\n    kind: config.listKind,\n    location: config.location,\n    description:\n      meta?.scope === \"selected\"\n        ? `${visible.length} selected ${visible.length === 1 ? config.label : (config.listLabel ?? `${config.label} rows`)}.`\n        : (config.listDescription ??\n          `${config.listLabel ?? config.label} — current filtered/sorted view.`),\n    data: visible.map((r) => (config.agentRow ? config.agentRow(r) : r)),\n    summary: visible.map((r) => config.humanRow(r)).join(\"\\n---\\n\"),\n    attributes: {\n      visible_count: visible.length,\n      total_count: all.length,\n      search: meta?.search || undefined,\n      search_match: meta?.search ? meta.searchMatchMode : undefined,\n      any_of: meta?.anyOf || undefined,\n      active_filters: meta?.filterCount ?? 0,\n      sort: meta?.sort || undefined,\n      scope: meta?.scope ?? \"view\",\n      ...config.listAttributes?.(visible, all),\n    },\n    ...(config.listContext ? { context: config.listContext(visible, all) } : {}),\n  };\n}\n\n/** CSV of the current view (visible columns × rows), for ExportMenu. */\nexport function rowsToCsvFromColumns<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n): string {\n  const cols = columns.filter((c) => c.filter !== false || c.accessorKey);\n  const escape = (value: string) =>\n    /[\",\\n\\r]/.test(value) ? `\"${value.replace(/\"/g, '\"\"')}\"` : value;\n  const lines = [\n    cols\n      .map((c) => escape(typeof c.header === \"string\" ? c.header : columnId(c)))\n      .join(\",\"),\n  ];\n  for (const row of rows) {\n    lines.push(\n      cols\n        .map((c) => escape(stringifyCellValue(getCellValue(row, c))))\n        .join(\",\"),\n    );\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * The same rows the CSV export produces, as records — the shape a Google Sheet\n * (or any other row destination) takes.\n *\n * It shares `rowsToCsvFromColumns`'s column selection and cell stringification\n * ON PURPOSE: a user who exports the view as CSV and a user who sends it to a\n * Sheet must get the SAME columns, in the same order, with the same values.\n * Two independent row builders is how those two answers start disagreeing.\n */\nexport function rowsToRecordsFromColumns<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n): Array<Record<string, unknown>> {\n  const cols = columns.filter((c) => c.filter !== false || c.accessorKey);\n  const headers = cols.map((c) =>\n    typeof c.header === \"string\" ? c.header : columnId(c),\n  );\n  return rows.map((row) => {\n    const record: Record<string, unknown> = {};\n    cols.forEach((c, index) => {\n      record[headers[index] ?? columnId(c)] = stringifyCellValue(getCellValue(row, c));\n    });\n    return record;\n  });\n}\n\nexport function buildViewHuman<T>(\n  config: MatrxDataTableCopyConfig<T>,\n  visible: T[],\n  columns: MatrxColumnDef<T>[],\n): string {\n  const md = rowsToMarkdownTable(visible, columns);\n  const summaries = visible.map((r) => config.humanRow(r)).join(\"\\n\\n\");\n  return [\n    `${config.listLabel ?? config.label} (${visible.length} rows)`,\n    \"\",\n    md,\n    \"\",\n    \"---\",\n    \"\",\n    summaries,\n  ].join(\"\\n\");\n}\n","import type {\n  ColumnFilterValue,\n  ColumnFiltersState,\n  MatrxColumnDef,\n  SortState,\n  TableSearchMatchMode,\n} from \"./types\";\nimport {\n  completeLayeredFilterRules,\n  layeredFilterMatchesValue,\n  type LayeredFilterRule,\n} from \"./layered-filters\";\n\n/**\n * Sentinel select-filter values for \"no value\" / \"any value\" — every select\n * filter offers them automatically when the column has empty cells, so any\n * table can isolate rows missing a value (or having one) without extra config.\n */\nexport const SELECT_EMPTY_VALUE = \"__empty__\";\nexport const SELECT_NOT_EMPTY_VALUE = \"__not_empty__\";\n\nexport function columnId<T>(col: MatrxColumnDef<T>): string {\n  if (col.id) return col.id;\n  if (col.accessorKey) return String(col.accessorKey);\n  throw new Error(\"MatrxDataTable column requires `id` or `accessorKey`\");\n}\n\nexport function getCellValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  if (col.accessorFn) return col.accessorFn(row);\n  if (col.accessorKey) {\n    return (row as Record<string, unknown>)[col.accessorKey];\n  }\n  return undefined;\n}\n\nexport function getFilterValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  return col.filterValue ? col.filterValue(row) : getCellValue(row, col);\n}\n\nexport function getSortValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  return col.sortValue ? col.sortValue(row) : getCellValue(row, col);\n}\n\nexport function stringifyCellValue(value: unknown): string {\n  if (value == null) return \"\";\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return String(value);\n  }\n  if (value instanceof Date) return value.toISOString();\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\n/** Unicode-aware tokenization shared by whole-word table search. */\nexport function tableSearchWords(value: string): string[] {\n  return value\n    .toLocaleLowerCase()\n    .split(/[^\\p{L}\\p{N}]+/u)\n    .filter(Boolean);\n}\n\n/**\n * Match the primary table search against one row's searchable text. In\n * whole-word mode every entered word must exist as a complete token, so\n * `are` matches `we are ready` but never `hardware`.\n */\nexport function matchesTableSearch(\n  searchableText: string,\n  query: string,\n  mode: TableSearchMatchMode = \"contains\",\n): boolean {\n  const normalizedQuery = query.trim().toLocaleLowerCase();\n  if (!normalizedQuery) return true;\n  if (mode === \"contains\") {\n    return searchableText.toLocaleLowerCase().includes(normalizedQuery);\n  }\n  const actualWords = new Set(tableSearchWords(searchableText));\n  const expectedWords = tableSearchWords(normalizedQuery);\n  return (\n    expectedWords.length > 0 &&\n    expectedWords.every((word) => actualWords.has(word))\n  );\n}\n\nfunction compareValues(a: unknown, b: unknown): number {\n  if (a == null && b == null) return 0;\n  if (a == null) return -1;\n  if (b == null) return 1;\n  if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n  if (typeof a === \"boolean\" && typeof b === \"boolean\") {\n    return Number(a) - Number(b);\n  }\n  return stringifyCellValue(a).localeCompare(stringifyCellValue(b), undefined, {\n    numeric: true,\n    sensitivity: \"base\",\n  });\n}\n\nexport function passesColumnFilter(\n  value: unknown,\n  filter: ColumnFilterValue,\n): boolean {\n  const matches = (() => {\n    switch (filter.kind) {\n    case \"text\": {\n      const s = stringifyCellValue(value);\n      if (filter.mode === \"null\") return value == null;\n      if (filter.mode === \"not_null\") return value != null;\n      if (filter.mode === \"empty\") return s.trim() === \"\";\n      if (filter.mode === \"not_empty\") return s.trim() !== \"\";\n      const q = filter.value.trim().toLowerCase();\n      if (!q) return true;\n      return s.toLowerCase().includes(q);\n    }\n    case \"select\": {\n      const selected =\n        filter.values ??\n        (filter.value && filter.value !== \"__all__\" ? [filter.value] : []);\n      if (selected.length === 0) return true;\n      const s = stringifyCellValue(value);\n      // OR semantics across the set; sentinels compose (\"A or (empty)\").\n      return selected.some((v) =>\n        v === SELECT_EMPTY_VALUE\n          ? s === \"\"\n          : v === SELECT_NOT_EMPTY_VALUE\n            ? s !== \"\"\n            : s === v,\n      );\n    }\n    case \"boolean\": {\n      return Boolean(value) === filter.value;\n    }\n    case \"number\": {\n      const n =\n        typeof value === \"number\"\n          ? value\n          : Number(stringifyCellValue(value).replace(/[^0-9.-]/g, \"\"));\n      if (Number.isNaN(n)) return false;\n      if (filter.min !== undefined && n < filter.min) return false;\n      if (filter.max !== undefined && n > filter.max) return false;\n      return true;\n    }\n    }\n  })();\n  return filter.negated ? !matches : matches;\n}\n\nexport function filterAndSortRows<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n  columnFilters: ColumnFiltersState,\n  sort: SortState | null,\n  globalSearch: string,\n  anyOf?: { columnIds: string[]; query: string },\n  layeredFilters?: readonly LayeredFilterRule[],\n  globalSearchMode: TableSearchMatchMode = \"contains\",\n  searchText?: (row: T) => string,\n): T[] {\n  const colById = new Map(columns.map((c) => [columnId(c), c]));\n  const q = globalSearch.trim().toLowerCase();\n  const anyQ = anyOf?.query.trim().toLowerCase() ?? \"\";\n  const activeLayeredFilters = completeLayeredFilterRules(layeredFilters);\n\n  let result = rows.filter((row) => {\n    for (const [id, filter] of Object.entries(columnFilters)) {\n      if (!filter) continue;\n      const col = colById.get(id);\n      if (!col || col.filter === false) continue;\n      if (!passesColumnFilter(getFilterValue(row, col), filter)) return false;\n    }\n\n    for (const rule of activeLayeredFilters) {\n      const col = colById.get(rule.field);\n      if (!col || !layeredFilterMatchesValue(getFilterValue(row, col), rule)) {\n        return false;\n      }\n    }\n\n    if (anyQ && anyOf) {\n      const hit = anyOf.columnIds.some((id) => {\n        const col = colById.get(id);\n        if (!col) return false;\n        return stringifyCellValue(getFilterValue(row, col))\n          .toLowerCase()\n          .includes(anyQ);\n      });\n      if (!hit) return false;\n    }\n\n    if (!q) return true;\n    const searchableValues = columns\n      .filter(\n        (col) =>\n          col.filter !== false || Boolean(col.accessorKey || col.accessorFn),\n      )\n      .map((col) => stringifyCellValue(getFilterValue(row, col)));\n    const additionalSearchText = searchText?.(row);\n    if (additionalSearchText) searchableValues.push(additionalSearchText);\n    if (globalSearchMode === \"contains\") {\n      return searchableValues.some((value) =>\n        matchesTableSearch(value, q, \"contains\"),\n      );\n    }\n    return matchesTableSearch(searchableValues.join(\" \"), q, \"whole_words\");\n  });\n\n  if (sort) {\n    const col = colById.get(sort.id);\n    if (col && col.sortable !== false) {\n      const dir = sort.direction === \"asc\" ? 1 : -1;\n      result = [...result].sort((a, b) => {\n        const va = getSortValue(a, col);\n        const vb = getSortValue(b, col);\n        // Empty cells (null / \"\") sort LAST in both directions — sorting a\n        // column should surface its values, never a wall of blanks.\n        const ea = va == null || stringifyCellValue(va) === \"\";\n        const eb = vb == null || stringifyCellValue(vb) === \"\";\n        if (ea !== eb) return ea ? 1 : -1;\n        return compareValues(va, vb) * dir;\n      });\n    }\n  }\n\n  return result;\n}\n\nexport function countActiveColumnFilters(filters: ColumnFiltersState): number {\n  let n = 0;\n  for (const f of Object.values(filters)) {\n    if (!f) continue;\n    switch (f.kind) {\n      case \"text\":\n        if (f.value.trim() || (f.mode && f.mode !== \"contains\")) n += 1;\n        break;\n      case \"select\":\n        if (f.values ? f.values.length > 0 : f.value && f.value !== \"__all__\")\n          n += 1;\n        break;\n      case \"boolean\":\n        n += 1;\n        break;\n      case \"number\":\n        if (f.min !== undefined || f.max !== undefined) n += 1;\n        break;\n    }\n  }\n  return n;\n}\n\nexport function isColumnFilterActive(\n  filter: ColumnFilterValue | undefined,\n): boolean {\n  if (!filter) return false;\n  switch (filter.kind) {\n    case \"text\":\n      return (\n        filter.value.trim().length > 0 ||\n        (filter.mode !== undefined && filter.mode !== \"contains\")\n      );\n    case \"select\":\n      return filter.values\n        ? filter.values.length > 0\n        : Boolean(filter.value) && filter.value !== \"__all__\";\n    case \"boolean\":\n      return true;\n    case \"number\":\n      return filter.min !== undefined || filter.max !== undefined;\n  }\n}\n\n/** Apply draft edits onto a row for display (shallow field merge). */\nexport function applyRowEdits<T>(\n  row: T,\n  edits: Record<string, unknown> | undefined,\n): T {\n  if (!edits || Object.keys(edits).length === 0) return row;\n  return { ...row, ...edits };\n}\n"],"mappings":"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","names":[]}

package/dist/data-table/copy-helpers.d.cts

@@ -1,7 +1,18 @@
 import { AgentPayloadInput } from './copy-types.cjs';
-import { f as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-Bx9SfdJM.cjs';
+import { f as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-0CNCWvdK.cjs';
 import 'react';
 
+/**
+ * Typed, declared-column capture for MatrxDataTable's built-in Alchemy source.
+ * It deliberately runs only at the transfer boundary: accessor functions can
+ * throw useful capture errors, and rendering never evaluates them for copying.
+ */
+declare function projectDefaultTableCopyRow<T>(row: T, columns: MatrxColumnDef<T>[]): Record<string, unknown>;
+/** Builds the default table's AI envelope from one already validated capture. */
+declare function buildDefaultTableViewAgentInput<T>(config: MatrxDataTableCopyConfig<T>, rows: T[], all: T[], columns: MatrxColumnDef<T>[], meta?: Parameters<typeof buildViewAgentInput<T>>[3]): AgentPayloadInput;
+/** Builds the default row AI envelope from one validated projection. */
+declare function buildDefaultTableRowAgentInput<T>(config: MatrxDataTableCopyConfig<T>, row: T, columns: MatrxColumnDef<T>[]): AgentPayloadInput;
+declare function formatDefaultTableCopyRecord<T>(record: Record<string, unknown>, columns: MatrxColumnDef<T>[]): string;
 /** Human markdown table of the current view (visible columns × rows). */
 declare function rowsToMarkdownTable<T>(rows: T[], columns: MatrxColumnDef<T>[]): string;
 declare function buildRowAgentInput<T>(config: MatrxDataTableCopyConfig<T>, row: T): AgentPayloadInput;
@@ -28,4 +39,4 @@ declare function rowsToCsvFromColumns<T>(rows: T[], columns: MatrxColumnDef<T>[]
 declare function rowsToRecordsFromColumns<T>(rows: T[], columns: MatrxColumnDef<T>[]): Array<Record<string, unknown>>;
 declare function buildViewHuman<T>(config: MatrxDataTableCopyConfig<T>, visible: T[], columns: MatrxColumnDef<T>[]): string;
 
-export { buildRowAgentInput, buildViewAgentInput, buildViewHuman, rowsToCsvFromColumns, rowsToMarkdownTable, rowsToRecordsFromColumns };
+export { buildDefaultTableRowAgentInput, buildDefaultTableViewAgentInput, buildRowAgentInput, buildViewAgentInput, buildViewHuman, formatDefaultTableCopyRecord, projectDefaultTableCopyRow, rowsToCsvFromColumns, rowsToMarkdownTable, rowsToRecordsFromColumns };

package/dist/data-table/copy-helpers.d.ts

@@ -1,7 +1,18 @@
 import { AgentPayloadInput } from './copy-types.js';
-import { f as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-DyByb6tW.js';
+import { f as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-cH8oLqUx.js';
 import 'react';
 
+/**
+ * Typed, declared-column capture for MatrxDataTable's built-in Alchemy source.
+ * It deliberately runs only at the transfer boundary: accessor functions can
+ * throw useful capture errors, and rendering never evaluates them for copying.
+ */
+declare function projectDefaultTableCopyRow<T>(row: T, columns: MatrxColumnDef<T>[]): Record<string, unknown>;
+/** Builds the default table's AI envelope from one already validated capture. */
+declare function buildDefaultTableViewAgentInput<T>(config: MatrxDataTableCopyConfig<T>, rows: T[], all: T[], columns: MatrxColumnDef<T>[], meta?: Parameters<typeof buildViewAgentInput<T>>[3]): AgentPayloadInput;
+/** Builds the default row AI envelope from one validated projection. */
+declare function buildDefaultTableRowAgentInput<T>(config: MatrxDataTableCopyConfig<T>, row: T, columns: MatrxColumnDef<T>[]): AgentPayloadInput;
+declare function formatDefaultTableCopyRecord<T>(record: Record<string, unknown>, columns: MatrxColumnDef<T>[]): string;
 /** Human markdown table of the current view (visible columns × rows). */
 declare function rowsToMarkdownTable<T>(rows: T[], columns: MatrxColumnDef<T>[]): string;
 declare function buildRowAgentInput<T>(config: MatrxDataTableCopyConfig<T>, row: T): AgentPayloadInput;
@@ -28,4 +39,4 @@ declare function rowsToCsvFromColumns<T>(rows: T[], columns: MatrxColumnDef<T>[]
 declare function rowsToRecordsFromColumns<T>(rows: T[], columns: MatrxColumnDef<T>[]): Array<Record<string, unknown>>;
 declare function buildViewHuman<T>(config: MatrxDataTableCopyConfig<T>, visible: T[], columns: MatrxColumnDef<T>[]): string;
 
-export { buildRowAgentInput, buildViewAgentInput, buildViewHuman, rowsToCsvFromColumns, rowsToMarkdownTable, rowsToRecordsFromColumns };
+export { buildDefaultTableRowAgentInput, buildDefaultTableViewAgentInput, buildRowAgentInput, buildViewAgentInput, buildViewHuman, formatDefaultTableCopyRecord, projectDefaultTableCopyRow, rowsToCsvFromColumns, rowsToMarkdownTable, rowsToRecordsFromColumns };

package/dist/data-table/copy-helpers.js

@@ -1,4 +1,7 @@
 
+// src/data-table/tableCopy.ts
+import { normalizeTransferJson } from "@ai-matrx/kit/content-transfer";
+
 // src/data-table/filter-engine.ts
 function columnId(col) {
   if (col.id) return col.id;
@@ -27,6 +30,54 @@ function stringifyCellValue(value) {
 }
 
 // src/data-table/tableCopy.ts
+function projectDefaultTableCopyRow(row, columns) {
+  const record = /* @__PURE__ */ Object.create(null);
+  for (const column of columns) {
+    const value = getCellValue(row, column);
+    if (value !== void 0) record[columnId(column)] = value;
+  }
+  return normalizeTransferJson(record, { omitUndefinedObjectProperties: true });
+}
+function buildDefaultTableViewAgentInput(config, rows, all, columns, meta) {
+  const projected = rows.map((row) => projectDefaultTableCopyRow(row, columns));
+  return {
+    kind: config.listKind,
+    location: config.location,
+    description: meta?.scope === "selected" ? `${projected.length} selected ${projected.length === 1 ? config.label : config.listLabel ?? `${config.label} rows`}.` : config.listDescription ?? `${config.listLabel ?? config.label} \u2014 current filtered/sorted view.`,
+    data: projected,
+    summary: projected.map((record) => formatDefaultTableCopyRecord(record, columns)).join("\n---\n"),
+    attributes: {
+      visible_count: projected.length,
+      total_count: all.length,
+      search: meta?.search || void 0,
+      search_match: meta?.search ? meta.searchMatchMode : void 0,
+      any_of: meta?.anyOf || void 0,
+      active_filters: meta?.filterCount ?? 0,
+      sort: meta?.sort || void 0,
+      scope: meta?.scope ?? "view",
+      ...config.listAttributes?.(rows, all)
+    },
+    ...config.listContext ? { context: config.listContext(rows, all) } : {}
+  };
+}
+function buildDefaultTableRowAgentInput(config, row, columns) {
+  const projected = projectDefaultTableCopyRow(row, columns);
+  return {
+    kind: config.rowKind,
+    location: config.location,
+    description: config.rowDescription ?? `One ${config.label} row.`,
+    data: projected,
+    summary: formatDefaultTableCopyRecord(projected, columns),
+    ...config.rowAttributes ? { attributes: config.rowAttributes(row) } : {}
+  };
+}
+function formatDefaultTableCopyRecord(record, columns) {
+  return columns.map((column) => {
+    const id = columnId(column);
+    const label = column.label ?? (typeof column.header === "string" ? column.header : id);
+    return `${label}: ${stringifyCellValue(record[id])}`;
+  }).join("\n");
+}
 function rowsToMarkdownTable(rows, columns) {
   const cols = columns.filter((c) => c.filter !== false || c.accessorKey);
   if (cols.length === 0) return "";
@@ -117,9 +168,13 @@ function buildViewHuman(config, visible, columns) {
   ].join("\n");
 }
 export {
+  buildDefaultTableRowAgentInput,
+  buildDefaultTableViewAgentInput,
   buildRowAgentInput,
   buildViewAgentInput,
   buildViewHuman,
+  formatDefaultTableCopyRecord,
+  projectDefaultTableCopyRow,
   rowsToCsvFromColumns,
   rowsToMarkdownTable,
   rowsToRecordsFromColumns

package/dist/data-table/copy-helpers.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/data-table/filter-engine.ts","../../src/data-table/tableCopy.ts"],"sourcesContent":["import type {\n  ColumnFilterValue,\n  ColumnFiltersState,\n  MatrxColumnDef,\n  SortState,\n  TableSearchMatchMode,\n} from \"./types\";\nimport {\n  completeLayeredFilterRules,\n  layeredFilterMatchesValue,\n  type LayeredFilterRule,\n} from \"./layered-filters\";\n\n/**\n * Sentinel select-filter values for \"no value\" / \"any value\" — every select\n * filter offers them automatically when the column has empty cells, so any\n * table can isolate rows missing a value (or having one) without extra config.\n */\nexport const SELECT_EMPTY_VALUE = \"__empty__\";\nexport const SELECT_NOT_EMPTY_VALUE = \"__not_empty__\";\n\nexport function columnId<T>(col: MatrxColumnDef<T>): string {\n  if (col.id) return col.id;\n  if (col.accessorKey) return String(col.accessorKey);\n  throw new Error(\"MatrxDataTable column requires `id` or `accessorKey`\");\n}\n\nexport function getCellValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  if (col.accessorFn) return col.accessorFn(row);\n  if (col.accessorKey) {\n    return (row as Record<string, unknown>)[col.accessorKey];\n  }\n  return undefined;\n}\n\nexport function getFilterValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  return col.filterValue ? col.filterValue(row) : getCellValue(row, col);\n}\n\nexport function getSortValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  return col.sortValue ? col.sortValue(row) : getCellValue(row, col);\n}\n\nexport function stringifyCellValue(value: unknown): string {\n  if (value == null) return \"\";\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return String(value);\n  }\n  if (value instanceof Date) return value.toISOString();\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\n/** Unicode-aware tokenization shared by whole-word table search. */\nexport function tableSearchWords(value: string): string[] {\n  return value\n    .toLocaleLowerCase()\n    .split(/[^\\p{L}\\p{N}]+/u)\n    .filter(Boolean);\n}\n\n/**\n * Match the primary table search against one row's searchable text. In\n * whole-word mode every entered word must exist as a complete token, so\n * `are` matches `we are ready` but never `hardware`.\n */\nexport function matchesTableSearch(\n  searchableText: string,\n  query: string,\n  mode: TableSearchMatchMode = \"contains\",\n): boolean {\n  const normalizedQuery = query.trim().toLocaleLowerCase();\n  if (!normalizedQuery) return true;\n  if (mode === \"contains\") {\n    return searchableText.toLocaleLowerCase().includes(normalizedQuery);\n  }\n  const actualWords = new Set(tableSearchWords(searchableText));\n  const expectedWords = tableSearchWords(normalizedQuery);\n  return (\n    expectedWords.length > 0 &&\n    expectedWords.every((word) => actualWords.has(word))\n  );\n}\n\nfunction compareValues(a: unknown, b: unknown): number {\n  if (a == null && b == null) return 0;\n  if (a == null) return -1;\n  if (b == null) return 1;\n  if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n  if (typeof a === \"boolean\" && typeof b === \"boolean\") {\n    return Number(a) - Number(b);\n  }\n  return stringifyCellValue(a).localeCompare(stringifyCellValue(b), undefined, {\n    numeric: true,\n    sensitivity: \"base\",\n  });\n}\n\nexport function passesColumnFilter(\n  value: unknown,\n  filter: ColumnFilterValue,\n): boolean {\n  const matches = (() => {\n    switch (filter.kind) {\n    case \"text\": {\n      const s = stringifyCellValue(value);\n      if (filter.mode === \"null\") return value == null;\n      if (filter.mode === \"not_null\") return value != null;\n      if (filter.mode === \"empty\") return s.trim() === \"\";\n      if (filter.mode === \"not_empty\") return s.trim() !== \"\";\n      const q = filter.value.trim().toLowerCase();\n      if (!q) return true;\n      return s.toLowerCase().includes(q);\n    }\n    case \"select\": {\n      const selected =\n        filter.values ??\n        (filter.value && filter.value !== \"__all__\" ? [filter.value] : []);\n      if (selected.length === 0) return true;\n      const s = stringifyCellValue(value);\n      // OR semantics across the set; sentinels compose (\"A or (empty)\").\n      return selected.some((v) =>\n        v === SELECT_EMPTY_VALUE\n          ? s === \"\"\n          : v === SELECT_NOT_EMPTY_VALUE\n            ? s !== \"\"\n            : s === v,\n      );\n    }\n    case \"boolean\": {\n      return Boolean(value) === filter.value;\n    }\n    case \"number\": {\n      const n =\n        typeof value === \"number\"\n          ? value\n          : Number(stringifyCellValue(value).replace(/[^0-9.-]/g, \"\"));\n      if (Number.isNaN(n)) return false;\n      if (filter.min !== undefined && n < filter.min) return false;\n      if (filter.max !== undefined && n > filter.max) return false;\n      return true;\n    }\n    }\n  })();\n  return filter.negated ? !matches : matches;\n}\n\nexport function filterAndSortRows<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n  columnFilters: ColumnFiltersState,\n  sort: SortState | null,\n  globalSearch: string,\n  anyOf?: { columnIds: string[]; query: string },\n  layeredFilters?: readonly LayeredFilterRule[],\n  globalSearchMode: TableSearchMatchMode = \"contains\",\n  searchText?: (row: T) => string,\n): T[] {\n  const colById = new Map(columns.map((c) => [columnId(c), c]));\n  const q = globalSearch.trim().toLowerCase();\n  const anyQ = anyOf?.query.trim().toLowerCase() ?? \"\";\n  const activeLayeredFilters = completeLayeredFilterRules(layeredFilters);\n\n  let result = rows.filter((row) => {\n    for (const [id, filter] of Object.entries(columnFilters)) {\n      if (!filter) continue;\n      const col = colById.get(id);\n      if (!col || col.filter === false) continue;\n      if (!passesColumnFilter(getFilterValue(row, col), filter)) return false;\n    }\n\n    for (const rule of activeLayeredFilters) {\n      const col = colById.get(rule.field);\n      if (!col || !layeredFilterMatchesValue(getFilterValue(row, col), rule)) {\n        return false;\n      }\n    }\n\n    if (anyQ && anyOf) {\n      const hit = anyOf.columnIds.some((id) => {\n        const col = colById.get(id);\n        if (!col) return false;\n        return stringifyCellValue(getFilterValue(row, col))\n          .toLowerCase()\n          .includes(anyQ);\n      });\n      if (!hit) return false;\n    }\n\n    if (!q) return true;\n    const searchableValues = columns\n      .filter(\n        (col) =>\n          col.filter !== false || Boolean(col.accessorKey || col.accessorFn),\n      )\n      .map((col) => stringifyCellValue(getFilterValue(row, col)));\n    const additionalSearchText = searchText?.(row);\n    if (additionalSearchText) searchableValues.push(additionalSearchText);\n    if (globalSearchMode === \"contains\") {\n      return searchableValues.some((value) =>\n        matchesTableSearch(value, q, \"contains\"),\n      );\n    }\n    return matchesTableSearch(searchableValues.join(\" \"), q, \"whole_words\");\n  });\n\n  if (sort) {\n    const col = colById.get(sort.id);\n    if (col && col.sortable !== false) {\n      const dir = sort.direction === \"asc\" ? 1 : -1;\n      result = [...result].sort((a, b) => {\n        const va = getSortValue(a, col);\n        const vb = getSortValue(b, col);\n        // Empty cells (null / \"\") sort LAST in both directions — sorting a\n        // column should surface its values, never a wall of blanks.\n        const ea = va == null || stringifyCellValue(va) === \"\";\n        const eb = vb == null || stringifyCellValue(vb) === \"\";\n        if (ea !== eb) return ea ? 1 : -1;\n        return compareValues(va, vb) * dir;\n      });\n    }\n  }\n\n  return result;\n}\n\nexport function countActiveColumnFilters(filters: ColumnFiltersState): number {\n  let n = 0;\n  for (const f of Object.values(filters)) {\n    if (!f) continue;\n    switch (f.kind) {\n      case \"text\":\n        if (f.value.trim() || (f.mode && f.mode !== \"contains\")) n += 1;\n        break;\n      case \"select\":\n        if (f.values ? f.values.length > 0 : f.value && f.value !== \"__all__\")\n          n += 1;\n        break;\n      case \"boolean\":\n        n += 1;\n        break;\n      case \"number\":\n        if (f.min !== undefined || f.max !== undefined) n += 1;\n        break;\n    }\n  }\n  return n;\n}\n\nexport function isColumnFilterActive(\n  filter: ColumnFilterValue | undefined,\n): boolean {\n  if (!filter) return false;\n  switch (filter.kind) {\n    case \"text\":\n      return (\n        filter.value.trim().length > 0 ||\n        (filter.mode !== undefined && filter.mode !== \"contains\")\n      );\n    case \"select\":\n      return filter.values\n        ? filter.values.length > 0\n        : Boolean(filter.value) && filter.value !== \"__all__\";\n    case \"boolean\":\n      return true;\n    case \"number\":\n      return filter.min !== undefined || filter.max !== undefined;\n  }\n}\n\n/** Apply draft edits onto a row for display (shallow field merge). */\nexport function applyRowEdits<T>(\n  row: T,\n  edits: Record<string, unknown> | undefined,\n): T {\n  if (!edits || Object.keys(edits).length === 0) return row;\n  return { ...row, ...edits };\n}\n","import type { AgentPayloadInput } from \"./copy\";\nimport type { MatrxColumnDef, MatrxDataTableCopyConfig } from \"./types\";\nimport { columnId, getCellValue, stringifyCellValue } from \"./filter-engine\";\n\n/** Human markdown table of the current view (visible columns × rows). */\nexport function rowsToMarkdownTable<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n): string {\n  const cols = columns.filter((c) => c.filter !== false || c.accessorKey);\n  if (cols.length === 0) return \"\";\n  const headers = cols.map((c) => {\n    if (typeof c.header === \"string\") return c.header;\n    return columnId(c);\n  });\n  const lines = [\n    `| ${headers.join(\" | \")} |`,\n    `| ${headers.map(() => \"---\").join(\" | \")} |`,\n  ];\n  for (const row of rows) {\n    const cells = cols.map((c) =>\n      stringifyCellValue(getCellValue(row, c)).replace(/\\|/g, \"\\\\|\"),\n    );\n    lines.push(`| ${cells.join(\" | \")} |`);\n  }\n  return lines.join(\"\\n\");\n}\n\nexport function buildRowAgentInput<T>(\n  config: MatrxDataTableCopyConfig<T>,\n  row: T,\n): AgentPayloadInput {\n  return {\n    kind: config.rowKind,\n    location: config.location,\n    description: config.rowDescription ?? `One ${config.label} row.`,\n    data: config.agentRow ? config.agentRow(row) : row,\n    summary: config.humanRow(row),\n    ...(config.rowAttributes ? { attributes: config.rowAttributes(row) } : {}),\n  };\n}\n\nexport function buildViewAgentInput<T>(\n  config: MatrxDataTableCopyConfig<T>,\n  visible: T[],\n  all: T[],\n  meta?: {\n    search?: string;\n    searchMatchMode?: string;\n    anyOf?: string;\n    filterCount?: number;\n    sort?: string | null;\n    /** `custom` = shaped in the copy-subset window (filter & sort before copying). */\n    scope?: \"view\" | \"selected\" | \"custom\";\n  },\n): AgentPayloadInput {\n  return {\n    kind: config.listKind,\n    location: config.location,\n    description:\n      meta?.scope === \"selected\"\n        ? `${visible.length} selected ${visible.length === 1 ? config.label : (config.listLabel ?? `${config.label} rows`)}.`\n        : (config.listDescription ??\n          `${config.listLabel ?? config.label} — current filtered/sorted view.`),\n    data: visible.map((r) => (config.agentRow ? config.agentRow(r) : r)),\n    summary: visible.map((r) => config.humanRow(r)).join(\"\\n---\\n\"),\n    attributes: {\n      visible_count: visible.length,\n      total_count: all.length,\n      search: meta?.search || undefined,\n      search_match: meta?.search ? meta.searchMatchMode : undefined,\n      any_of: meta?.anyOf || undefined,\n      active_filters: meta?.filterCount ?? 0,\n      sort: meta?.sort || undefined,\n      scope: meta?.scope ?? \"view\",\n      ...config.listAttributes?.(visible, all),\n    },\n    ...(config.listContext ? { context: config.listContext(visible, all) } : {}),\n  };\n}\n\n/** CSV of the current view (visible columns × rows), for ExportMenu. */\nexport function rowsToCsvFromColumns<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n): string {\n  const cols = columns.filter((c) => c.filter !== false || c.accessorKey);\n  const escape = (value: string) =>\n    /[\",\\n\\r]/.test(value) ? `\"${value.replace(/\"/g, '\"\"')}\"` : value;\n  const lines = [\n    cols\n      .map((c) => escape(typeof c.header === \"string\" ? c.header : columnId(c)))\n      .join(\",\"),\n  ];\n  for (const row of rows) {\n    lines.push(\n      cols\n        .map((c) => escape(stringifyCellValue(getCellValue(row, c))))\n        .join(\",\"),\n    );\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * The same rows the CSV export produces, as records — the shape a Google Sheet\n * (or any other row destination) takes.\n *\n * It shares `rowsToCsvFromColumns`'s column selection and cell stringification\n * ON PURPOSE: a user who exports the view as CSV and a user who sends it to a\n * Sheet must get the SAME columns, in the same order, with the same values.\n * Two independent row builders is how those two answers start disagreeing.\n */\nexport function rowsToRecordsFromColumns<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n): Array<Record<string, unknown>> {\n  const cols = columns.filter((c) => c.filter !== false || c.accessorKey);\n  const headers = cols.map((c) =>\n    typeof c.header === \"string\" ? c.header : columnId(c),\n  );\n  return rows.map((row) => {\n    const record: Record<string, unknown> = {};\n    cols.forEach((c, index) => {\n      record[headers[index] ?? columnId(c)] = stringifyCellValue(getCellValue(row, c));\n    });\n    return record;\n  });\n}\n\nexport function buildViewHuman<T>(\n  config: MatrxDataTableCopyConfig<T>,\n  visible: T[],\n  columns: MatrxColumnDef<T>[],\n): string {\n  const md = rowsToMarkdownTable(visible, columns);\n  const summaries = visible.map((r) => config.humanRow(r)).join(\"\\n\\n\");\n  return [\n    `${config.listLabel ?? config.label} (${visible.length} rows)`,\n    \"\",\n    md,\n    \"\",\n    \"---\",\n    \"\",\n    summaries,\n  ].join(\"\\n\");\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/data-table/tableCopy.ts","../../src/data-table/filter-engine.ts"],"sourcesContent":["import type { AgentPayloadInput } from \"./copy\";\nimport { normalizeTransferJson } from \"@ai-matrx/kit/content-transfer\";\nimport type { MatrxColumnDef, MatrxDataTableCopyConfig } from \"./types\";\nimport { columnId, getCellValue, stringifyCellValue } from \"./filter-engine\";\n\n/**\n * Typed, declared-column capture for MatrxDataTable's built-in Alchemy source.\n * It deliberately runs only at the transfer boundary: accessor functions can\n * throw useful capture errors, and rendering never evaluates them for copying.\n */\nexport function projectDefaultTableCopyRow<T>(\n  row: T,\n  columns: MatrxColumnDef<T>[],\n): Record<string, unknown> {\n  const record: Record<string, unknown> = Object.create(null) as Record<string, unknown>;\n  for (const column of columns) {\n    const value = getCellValue(row, column);\n    if (value !== undefined) record[columnId(column)] = value;\n  }\n  return normalizeTransferJson(record, { omitUndefinedObjectProperties: true }) as Record<string, unknown>;\n}\n\n/** Builds the default table's AI envelope from one already validated capture. */\nexport function buildDefaultTableViewAgentInput<T>(\n  config: MatrxDataTableCopyConfig<T>,\n  rows: T[],\n  all: T[],\n  columns: MatrxColumnDef<T>[],\n  meta?: Parameters<typeof buildViewAgentInput<T>>[3],\n): AgentPayloadInput {\n  const projected = rows.map((row) => projectDefaultTableCopyRow(row, columns));\n  return {\n    kind: config.listKind,\n    location: config.location,\n    description:\n      meta?.scope === \"selected\"\n        ? `${projected.length} selected ${projected.length === 1 ? config.label : (config.listLabel ?? `${config.label} rows`)}.`\n        : (config.listDescription ?? `${config.listLabel ?? config.label} — current filtered/sorted view.`),\n    data: projected,\n    summary: projected.map((record) => formatDefaultTableCopyRecord(record, columns)).join(\"\\n---\\n\"),\n    attributes: {\n      visible_count: projected.length,\n      total_count: all.length,\n      search: meta?.search || undefined,\n      search_match: meta?.search ? meta.searchMatchMode : undefined,\n      any_of: meta?.anyOf || undefined,\n      active_filters: meta?.filterCount ?? 0,\n      sort: meta?.sort || undefined,\n      scope: meta?.scope ?? \"view\",\n      ...config.listAttributes?.(rows, all),\n    },\n    ...(config.listContext ? { context: config.listContext(rows, all) } : {}),\n  };\n}\n\n/** Builds the default row AI envelope from one validated projection. */\nexport function buildDefaultTableRowAgentInput<T>(\n  config: MatrxDataTableCopyConfig<T>,\n  row: T,\n  columns: MatrxColumnDef<T>[],\n): AgentPayloadInput {\n  const projected = projectDefaultTableCopyRow(row, columns);\n  return {\n    kind: config.rowKind,\n    location: config.location,\n    description: config.rowDescription ?? `One ${config.label} row.`,\n    data: projected,\n    summary: formatDefaultTableCopyRecord(projected, columns),\n    ...(config.rowAttributes ? { attributes: config.rowAttributes(row) } : {}),\n  };\n}\n\nexport function formatDefaultTableCopyRecord<T>(\n  record: Record<string, unknown>,\n  columns: MatrxColumnDef<T>[],\n): string {\n  return columns\n    .map((column) => {\n      const id = columnId(column);\n      const label = column.label ?? (typeof column.header === \"string\" ? column.header : id);\n      return `${label}: ${stringifyCellValue(record[id])}`;\n    })\n    .join(\"\\n\");\n}\n\n/** Human markdown table of the current view (visible columns × rows). */\nexport function rowsToMarkdownTable<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n): string {\n  const cols = columns.filter((c) => c.filter !== false || c.accessorKey);\n  if (cols.length === 0) return \"\";\n  const headers = cols.map((c) => {\n    if (typeof c.header === \"string\") return c.header;\n    return columnId(c);\n  });\n  const lines = [\n    `| ${headers.join(\" | \")} |`,\n    `| ${headers.map(() => \"---\").join(\" | \")} |`,\n  ];\n  for (const row of rows) {\n    const cells = cols.map((c) =>\n      stringifyCellValue(getCellValue(row, c)).replace(/\\|/g, \"\\\\|\"),\n    );\n    lines.push(`| ${cells.join(\" | \")} |`);\n  }\n  return lines.join(\"\\n\");\n}\n\nexport function buildRowAgentInput<T>(\n  config: MatrxDataTableCopyConfig<T>,\n  row: T,\n): AgentPayloadInput {\n  return {\n    kind: config.rowKind,\n    location: config.location,\n    description: config.rowDescription ?? `One ${config.label} row.`,\n    data: config.agentRow ? config.agentRow(row) : row,\n    summary: config.humanRow(row),\n    ...(config.rowAttributes ? { attributes: config.rowAttributes(row) } : {}),\n  };\n}\n\nexport function buildViewAgentInput<T>(\n  config: MatrxDataTableCopyConfig<T>,\n  visible: T[],\n  all: T[],\n  meta?: {\n    search?: string;\n    searchMatchMode?: string;\n    anyOf?: string;\n    filterCount?: number;\n    sort?: string | null;\n    /** `custom` = shaped in the copy-subset window (filter & sort before copying). */\n    scope?: \"view\" | \"selected\" | \"custom\";\n  },\n): AgentPayloadInput {\n  return {\n    kind: config.listKind,\n    location: config.location,\n    description:\n      meta?.scope === \"selected\"\n        ? `${visible.length} selected ${visible.length === 1 ? config.label : (config.listLabel ?? `${config.label} rows`)}.`\n        : (config.listDescription ??\n          `${config.listLabel ?? config.label} — current filtered/sorted view.`),\n    data: visible.map((r) => (config.agentRow ? config.agentRow(r) : r)),\n    summary: visible.map((r) => config.humanRow(r)).join(\"\\n---\\n\"),\n    attributes: {\n      visible_count: visible.length,\n      total_count: all.length,\n      search: meta?.search || undefined,\n      search_match: meta?.search ? meta.searchMatchMode : undefined,\n      any_of: meta?.anyOf || undefined,\n      active_filters: meta?.filterCount ?? 0,\n      sort: meta?.sort || undefined,\n      scope: meta?.scope ?? \"view\",\n      ...config.listAttributes?.(visible, all),\n    },\n    ...(config.listContext ? { context: config.listContext(visible, all) } : {}),\n  };\n}\n\n/** CSV of the current view (visible columns × rows), for ExportMenu. */\nexport function rowsToCsvFromColumns<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n): string {\n  const cols = columns.filter((c) => c.filter !== false || c.accessorKey);\n  const escape = (value: string) =>\n    /[\",\\n\\r]/.test(value) ? `\"${value.replace(/\"/g, '\"\"')}\"` : value;\n  const lines = [\n    cols\n      .map((c) => escape(typeof c.header === \"string\" ? c.header : columnId(c)))\n      .join(\",\"),\n  ];\n  for (const row of rows) {\n    lines.push(\n      cols\n        .map((c) => escape(stringifyCellValue(getCellValue(row, c))))\n        .join(\",\"),\n    );\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * The same rows the CSV export produces, as records — the shape a Google Sheet\n * (or any other row destination) takes.\n *\n * It shares `rowsToCsvFromColumns`'s column selection and cell stringification\n * ON PURPOSE: a user who exports the view as CSV and a user who sends it to a\n * Sheet must get the SAME columns, in the same order, with the same values.\n * Two independent row builders is how those two answers start disagreeing.\n */\nexport function rowsToRecordsFromColumns<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n): Array<Record<string, unknown>> {\n  const cols = columns.filter((c) => c.filter !== false || c.accessorKey);\n  const headers = cols.map((c) =>\n    typeof c.header === \"string\" ? c.header : columnId(c),\n  );\n  return rows.map((row) => {\n    const record: Record<string, unknown> = {};\n    cols.forEach((c, index) => {\n      record[headers[index] ?? columnId(c)] = stringifyCellValue(getCellValue(row, c));\n    });\n    return record;\n  });\n}\n\nexport function buildViewHuman<T>(\n  config: MatrxDataTableCopyConfig<T>,\n  visible: T[],\n  columns: MatrxColumnDef<T>[],\n): string {\n  const md = rowsToMarkdownTable(visible, columns);\n  const summaries = visible.map((r) => config.humanRow(r)).join(\"\\n\\n\");\n  return [\n    `${config.listLabel ?? config.label} (${visible.length} rows)`,\n    \"\",\n    md,\n    \"\",\n    \"---\",\n    \"\",\n    summaries,\n  ].join(\"\\n\");\n}\n","import type {\n  ColumnFilterValue,\n  ColumnFiltersState,\n  MatrxColumnDef,\n  SortState,\n  TableSearchMatchMode,\n} from \"./types\";\nimport {\n  completeLayeredFilterRules,\n  layeredFilterMatchesValue,\n  type LayeredFilterRule,\n} from \"./layered-filters\";\n\n/**\n * Sentinel select-filter values for \"no value\" / \"any value\" — every select\n * filter offers them automatically when the column has empty cells, so any\n * table can isolate rows missing a value (or having one) without extra config.\n */\nexport const SELECT_EMPTY_VALUE = \"__empty__\";\nexport const SELECT_NOT_EMPTY_VALUE = \"__not_empty__\";\n\nexport function columnId<T>(col: MatrxColumnDef<T>): string {\n  if (col.id) return col.id;\n  if (col.accessorKey) return String(col.accessorKey);\n  throw new Error(\"MatrxDataTable column requires `id` or `accessorKey`\");\n}\n\nexport function getCellValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  if (col.accessorFn) return col.accessorFn(row);\n  if (col.accessorKey) {\n    return (row as Record<string, unknown>)[col.accessorKey];\n  }\n  return undefined;\n}\n\nexport function getFilterValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  return col.filterValue ? col.filterValue(row) : getCellValue(row, col);\n}\n\nexport function getSortValue<T>(row: T, col: MatrxColumnDef<T>): unknown {\n  return col.sortValue ? col.sortValue(row) : getCellValue(row, col);\n}\n\nexport function stringifyCellValue(value: unknown): string {\n  if (value == null) return \"\";\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return String(value);\n  }\n  if (value instanceof Date) return value.toISOString();\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\n/** Unicode-aware tokenization shared by whole-word table search. */\nexport function tableSearchWords(value: string): string[] {\n  return value\n    .toLocaleLowerCase()\n    .split(/[^\\p{L}\\p{N}]+/u)\n    .filter(Boolean);\n}\n\n/**\n * Match the primary table search against one row's searchable text. In\n * whole-word mode every entered word must exist as a complete token, so\n * `are` matches `we are ready` but never `hardware`.\n */\nexport function matchesTableSearch(\n  searchableText: string,\n  query: string,\n  mode: TableSearchMatchMode = \"contains\",\n): boolean {\n  const normalizedQuery = query.trim().toLocaleLowerCase();\n  if (!normalizedQuery) return true;\n  if (mode === \"contains\") {\n    return searchableText.toLocaleLowerCase().includes(normalizedQuery);\n  }\n  const actualWords = new Set(tableSearchWords(searchableText));\n  const expectedWords = tableSearchWords(normalizedQuery);\n  return (\n    expectedWords.length > 0 &&\n    expectedWords.every((word) => actualWords.has(word))\n  );\n}\n\nfunction compareValues(a: unknown, b: unknown): number {\n  if (a == null && b == null) return 0;\n  if (a == null) return -1;\n  if (b == null) return 1;\n  if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n  if (typeof a === \"boolean\" && typeof b === \"boolean\") {\n    return Number(a) - Number(b);\n  }\n  return stringifyCellValue(a).localeCompare(stringifyCellValue(b), undefined, {\n    numeric: true,\n    sensitivity: \"base\",\n  });\n}\n\nexport function passesColumnFilter(\n  value: unknown,\n  filter: ColumnFilterValue,\n): boolean {\n  const matches = (() => {\n    switch (filter.kind) {\n    case \"text\": {\n      const s = stringifyCellValue(value);\n      if (filter.mode === \"null\") return value == null;\n      if (filter.mode === \"not_null\") return value != null;\n      if (filter.mode === \"empty\") return s.trim() === \"\";\n      if (filter.mode === \"not_empty\") return s.trim() !== \"\";\n      const q = filter.value.trim().toLowerCase();\n      if (!q) return true;\n      return s.toLowerCase().includes(q);\n    }\n    case \"select\": {\n      const selected =\n        filter.values ??\n        (filter.value && filter.value !== \"__all__\" ? [filter.value] : []);\n      if (selected.length === 0) return true;\n      const s = stringifyCellValue(value);\n      // OR semantics across the set; sentinels compose (\"A or (empty)\").\n      return selected.some((v) =>\n        v === SELECT_EMPTY_VALUE\n          ? s === \"\"\n          : v === SELECT_NOT_EMPTY_VALUE\n            ? s !== \"\"\n            : s === v,\n      );\n    }\n    case \"boolean\": {\n      return Boolean(value) === filter.value;\n    }\n    case \"number\": {\n      const n =\n        typeof value === \"number\"\n          ? value\n          : Number(stringifyCellValue(value).replace(/[^0-9.-]/g, \"\"));\n      if (Number.isNaN(n)) return false;\n      if (filter.min !== undefined && n < filter.min) return false;\n      if (filter.max !== undefined && n > filter.max) return false;\n      return true;\n    }\n    }\n  })();\n  return filter.negated ? !matches : matches;\n}\n\nexport function filterAndSortRows<T>(\n  rows: T[],\n  columns: MatrxColumnDef<T>[],\n  columnFilters: ColumnFiltersState,\n  sort: SortState | null,\n  globalSearch: string,\n  anyOf?: { columnIds: string[]; query: string },\n  layeredFilters?: readonly LayeredFilterRule[],\n  globalSearchMode: TableSearchMatchMode = \"contains\",\n  searchText?: (row: T) => string,\n): T[] {\n  const colById = new Map(columns.map((c) => [columnId(c), c]));\n  const q = globalSearch.trim().toLowerCase();\n  const anyQ = anyOf?.query.trim().toLowerCase() ?? \"\";\n  const activeLayeredFilters = completeLayeredFilterRules(layeredFilters);\n\n  let result = rows.filter((row) => {\n    for (const [id, filter] of Object.entries(columnFilters)) {\n      if (!filter) continue;\n      const col = colById.get(id);\n      if (!col || col.filter === false) continue;\n      if (!passesColumnFilter(getFilterValue(row, col), filter)) return false;\n    }\n\n    for (const rule of activeLayeredFilters) {\n      const col = colById.get(rule.field);\n      if (!col || !layeredFilterMatchesValue(getFilterValue(row, col), rule)) {\n        return false;\n      }\n    }\n\n    if (anyQ && anyOf) {\n      const hit = anyOf.columnIds.some((id) => {\n        const col = colById.get(id);\n        if (!col) return false;\n        return stringifyCellValue(getFilterValue(row, col))\n          .toLowerCase()\n          .includes(anyQ);\n      });\n      if (!hit) return false;\n    }\n\n    if (!q) return true;\n    const searchableValues = columns\n      .filter(\n        (col) =>\n          col.filter !== false || Boolean(col.accessorKey || col.accessorFn),\n      )\n      .map((col) => stringifyCellValue(getFilterValue(row, col)));\n    const additionalSearchText = searchText?.(row);\n    if (additionalSearchText) searchableValues.push(additionalSearchText);\n    if (globalSearchMode === \"contains\") {\n      return searchableValues.some((value) =>\n        matchesTableSearch(value, q, \"contains\"),\n      );\n    }\n    return matchesTableSearch(searchableValues.join(\" \"), q, \"whole_words\");\n  });\n\n  if (sort) {\n    const col = colById.get(sort.id);\n    if (col && col.sortable !== false) {\n      const dir = sort.direction === \"asc\" ? 1 : -1;\n      result = [...result].sort((a, b) => {\n        const va = getSortValue(a, col);\n        const vb = getSortValue(b, col);\n        // Empty cells (null / \"\") sort LAST in both directions — sorting a\n        // column should surface its values, never a wall of blanks.\n        const ea = va == null || stringifyCellValue(va) === \"\";\n        const eb = vb == null || stringifyCellValue(vb) === \"\";\n        if (ea !== eb) return ea ? 1 : -1;\n        return compareValues(va, vb) * dir;\n      });\n    }\n  }\n\n  return result;\n}\n\nexport function countActiveColumnFilters(filters: ColumnFiltersState): number {\n  let n = 0;\n  for (const f of Object.values(filters)) {\n    if (!f) continue;\n    switch (f.kind) {\n      case \"text\":\n        if (f.value.trim() || (f.mode && f.mode !== \"contains\")) n += 1;\n        break;\n      case \"select\":\n        if (f.values ? f.values.length > 0 : f.value && f.value !== \"__all__\")\n          n += 1;\n        break;\n      case \"boolean\":\n        n += 1;\n        break;\n      case \"number\":\n        if (f.min !== undefined || f.max !== undefined) n += 1;\n        break;\n    }\n  }\n  return n;\n}\n\nexport function isColumnFilterActive(\n  filter: ColumnFilterValue | undefined,\n): boolean {\n  if (!filter) return false;\n  switch (filter.kind) {\n    case \"text\":\n      return (\n        filter.value.trim().length > 0 ||\n        (filter.mode !== undefined && filter.mode !== \"contains\")\n      );\n    case \"select\":\n      return filter.values\n        ? filter.values.length > 0\n        : Boolean(filter.value) && filter.value !== \"__all__\";\n    case \"boolean\":\n      return true;\n    case \"number\":\n      return filter.min !== undefined || filter.max !== undefined;\n  }\n}\n\n/** Apply draft edits onto a row for display (shallow field merge). */\nexport function applyRowEdits<T>(\n  row: T,\n  edits: Record<string, unknown> | undefined,\n): T {\n  if (!edits || Object.keys(edits).length === 0) return row;\n  return { ...row, ...edits };\n}\n"],"mappings":"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","names":[]}

package/dist/data-table/copy-types.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/data-table/copy-types.ts"],"sourcesContent":["import type { ComponentType, ReactNode } from \"react\";\n\nexport type CopyResolvable<T> = T | (() => T);\nexport type CopyScalar = string | number | boolean | null | undefined;\nexport interface AgentPayloadInput { kind: string; location: string; description: string; data: unknown; summary?: string; context?: Record<string, CopyScalar>; attributes?: Record<string, CopyScalar>; }\nexport type AiIcon = ComponentType<{ className?: string }>;\nexport interface AiVariant { id: string; label: string; hint?: string; icon?: AiIcon; section?: \"copy\" | \"ai\"; ariaLabel?: string; successMessage?: string; build?: () => AgentPayloadInput | string | Promise<AgentPayloadInput | string>; onSelect?: () => void; modal?: (props: { open: boolean; onOpenChange: (open: boolean) => void }) => ReactNode; }\nexport type AiCustomOption =\n  | { kind: \"toggle\"; key: string; label: string; hint?: string; default: boolean }\n  | { kind: \"preset\"; key: string; label: string; options: { label: string; value: number }[]; default: number }\n  | { kind: \"slider\"; key: string; label: string; hint?: string; stops: number[]; default: number; formatValue: (value: number) => string }\n  | { kind: \"number\"; key: string; label: string; hint?: string; min?: number; step?: number; presets?: { label: string; value: number }[]; default: number };\nexport type AiOptionValues = Record<string, boolean | number>;\nexport interface AiCustomSource { label?: string; hint?: string; options: AiCustomOption[]; build: (options: AiOptionValues) => { text: string; meta?: Record<string, string | number | boolean | undefined> }; wrap: (text: string, options: AiOptionValues, meta?: Record<string, string | number | boolean | undefined>) => AgentPayloadInput; dialogTitle?: string; dialogDescription?: string; }\nexport interface ExportItem { id: string; label: string; build?: () => { content: BlobPart; extension: string; mime: string }; onSelect?: () => void | Promise<void>; }\nexport interface CopyExportConfig { items: ExportItem[]; sheetRows?: () => Array<Record<string, unknown>>; }\n/** Exact portable table-copy API. Host adapters import this, never recreate it. */\nexport interface CopyControlProps {\n  /** Changes reset the preparation session when a mounted control changes record. */\n  sourceId?: string;\n  /** Canonical table controls opt into row preparation when sheet rows exist. */\n  primarySource?: \"table\";\n  human?: CopyResolvable<string>;\n  agent?: CopyResolvable<AgentPayloadInput | string>;\n  json?: CopyResolvable<unknown>;\n  label: string;\n  size?: \"xs\" | \"icon\" | \"sm\";\n  /** Accepted for direct compatibility; package chrome has no application groomer engine. */\n  appearance?: \"segmented\" | \"bare\";\n  disabled?: boolean;\n  stopPropagation?: boolean;\n  className?: string;\n  /** Legacy source compatibility; controls are already grouped by default. */\n  grouped?: boolean;\n  aiVariants?: AiVariant[];\n  agentVariant?: { id?: string; label?: string; hint?: string; position?: \"first\" | \"last\" };\n  aiCustom?: AiCustomSource;\n  export?: CopyExportConfig;\n  hide?: Array<\"copy\" | \"ai\" | \"export\">;\n}\nexport interface CopySubsetColumn<T> { id: string; header: string; accessorKey?: keyof T & string; accessorFn?: (row: T) => unknown; hidden?: boolean; }\nexport interface CopySubsetSource<T> { label: string; location: string; kind: string; rows: T[]; columns: CopySubsetColumn<T>[]; getRowId: (row: T) => string; serializer?: (rows: T[]) => AgentPayloadInput; }\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/data-table/copy-types.ts"],"sourcesContent":["import type { ComponentType, ReactNode } from \"react\";\n\nexport type CopyResolvable<T> = T | (() => T);\nexport type CopyScalar = string | number | boolean | null | undefined;\nexport interface AgentPayloadInput { kind: string; location: string; description: string; data: unknown; summary?: string; context?: Record<string, CopyScalar>; attributes?: Record<string, CopyScalar>; }\nexport type AiIcon = ComponentType<{ className?: string }>;\nexport interface AiVariant { id: string; label: string; hint?: string; icon?: AiIcon; section?: \"copy\" | \"ai\"; ariaLabel?: string; successMessage?: string; build?: () => AgentPayloadInput | string | Promise<AgentPayloadInput | string>; onSelect?: () => void; modal?: (props: { open: boolean; onOpenChange: (open: boolean) => void }) => ReactNode; }\nexport type AiCustomOption =\n  | { kind: \"toggle\"; key: string; label: string; hint?: string; default: boolean }\n  | { kind: \"preset\"; key: string; label: string; options: { label: string; value: number }[]; default: number }\n  | { kind: \"slider\"; key: string; label: string; hint?: string; stops: number[]; default: number; formatValue: (value: number) => string }\n  | { kind: \"number\"; key: string; label: string; hint?: string; min?: number; step?: number; presets?: { label: string; value: number }[]; default: number };\nexport type AiOptionValues = Record<string, boolean | number>;\nexport interface AiCustomSource { label?: string; hint?: string; options: AiCustomOption[]; build: (options: AiOptionValues) => { text: string; meta?: Record<string, string | number | boolean | undefined> }; wrap: (text: string, options: AiOptionValues, meta?: Record<string, string | number | boolean | undefined>) => AgentPayloadInput; dialogTitle?: string; dialogDescription?: string; }\nexport interface ExportItem { id: string; label: string; build?: () => { content: BlobPart; extension: string; mime: string }; onSelect?: () => void | Promise<void>; }\nexport interface CopyExportConfig { items: ExportItem[]; sheetRows?: () => Array<Record<string, unknown>>; sheetColumns?: () => Array<{ id: string; label: string }>; }\n/** Exact portable table-copy API. Host adapters import this, never recreate it. */\nexport interface CopyControlProps {\n  /** Changes reset the preparation session when a mounted control changes record. */\n  sourceId?: string;\n  /** Canonical table controls opt into row preparation when sheet rows exist. */\n  primarySource?: \"table\";\n  human?: CopyResolvable<string>;\n  agent?: CopyResolvable<AgentPayloadInput | string>;\n  json?: CopyResolvable<unknown>;\n  label: string;\n  size?: \"xs\" | \"icon\" | \"sm\";\n  /** Accepted for direct compatibility; package chrome has no application groomer engine. */\n  appearance?: \"segmented\" | \"bare\";\n  disabled?: boolean;\n  stopPropagation?: boolean;\n  className?: string;\n  /** Legacy source compatibility; controls are already grouped by default. */\n  grouped?: boolean;\n  aiVariants?: AiVariant[];\n  agentVariant?: { id?: string; label?: string; hint?: string; position?: \"first\" | \"last\" };\n  aiCustom?: AiCustomSource;\n  export?: CopyExportConfig;\n  hide?: Array<\"copy\" | \"ai\" | \"export\">;\n}\nexport interface CopySubsetColumn<T> { id: string; header: string; accessorKey?: keyof T & string; accessorFn?: (row: T) => unknown; hidden?: boolean; }\nexport interface CopySubsetSource<T> { label: string; location: string; kind: string; rows: T[]; columns: CopySubsetColumn<T>[]; getRowId: (row: T) => string; serializer?: (rows: T[]) => AgentPayloadInput; }\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/data-table/copy-types.d.cts

@@ -91,6 +91,10 @@ interface ExportItem {
 interface CopyExportConfig {
     items: ExportItem[];
     sheetRows?: () => Array<Record<string, unknown>>;
+    sheetColumns?: () => Array<{
+        id: string;
+        label: string;
+    }>;
 }
 /** Exact portable table-copy API. Host adapters import this, never recreate it. */
 interface CopyControlProps {

package/dist/data-table/copy-types.d.ts

@@ -91,6 +91,10 @@ interface ExportItem {
 interface CopyExportConfig {
     items: ExportItem[];
     sheetRows?: () => Array<Record<string, unknown>>;
+    sheetColumns?: () => Array<{
+        id: string;
+        label: string;
+    }>;
 }
 /** Exact portable table-copy API. Host adapters import this, never recreate it. */
 interface CopyControlProps {

package/dist/data-table/data-row-inspector.cjs

@@ -1580,14 +1580,21 @@ function MatrxCopyMenuSession(props) {
     ))
       throw new Error("Sheet rows must be JSON objects.");
     const rows = value;
-    const keys = [...new Set(rows.flatMap((row) => Object.keys(row)))];
+    const suppliedColumns = props.export.sheetColumns?.();
+    const columns = suppliedColumns ?? [...new Set(rows.flatMap((row) => Object.keys(row)))].map((id) => ({ id, label: id }));
+    const ids = /* @__PURE__ */ new Set();
+    for (const column of columns) {
+      if (!column.id || !column.label || ids.has(column.id)) throw new Error("Sheet columns require unique nonempty ids and labels.");
+      ids.add(column.id);
+    }
+    for (const row of rows) for (const key of Object.keys(row)) if (!ids.has(key)) throw new Error(`Sheet row key "${key}" is not declared in sheetColumns.`);
     return {
       kind: "rows",
       rows,
-      columns: keys.map((key) => ({
-        id: key,
-        label: key,
-        path: `/${key.replace(/~/g, "~0").replace(/\//g, "~1")}`,
+      columns: columns.map((column) => ({
+        id: column.id,
+        label: column.label,
+        path: `/${column.id.replace(/~/g, "~0").replace(/\//g, "~1")}`,
         visible: true
       }))
     };
@@ -2237,7 +2244,7 @@ function MatrxUuidCell({
     }
     return /* @__PURE__ */ (0, import_jsx_runtime14.jsx)("span", { className: "min-w-0 truncate font-mono text-xs text-muted-foreground tabular-nums select-all", children: display });
   })();
-  return /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(TooltipProvider, { delayDuration: 200, children: /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)(
     "span",
     {
       "data-matrx-cell-control": true,
@@ -2247,51 +2254,64 @@ function MatrxUuidCell({
       ),
       onClick: stop,
       children: [
-        /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(TooltipProvider, { delayDuration: 200, children: /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)(Tooltip, { children: [
+        /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)(Tooltip, { children: [
           /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ (0, import_jsx_runtime14.jsx)("span", { className: "inline-flex min-w-0 max-w-full items-center", children: idNode }) }),
           /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(TooltipContent, { side: "top", className: "max-w-sm break-all font-mono", children: forbidden ? `No access \xB7 ${tip}` : tip })
-        ] }) }),
-        /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(
-          "button",
-          {
-            type: "button",
-            onClick: onCopy,
-            "aria-label": copied ? "Copied" : `Copy ${label ?? "id"}`,
-            title: `Copy ${label ?? "id"}: ${value}`,
-            className: cn(
-              "inline-flex h-4 w-4 shrink-0 items-center justify-center rounded text-muted-foreground transition-colors hover:text-foreground focus:outline-none",
-              copied && "text-primary"
-            ),
-            children: copied ? /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(Check, { className: "h-3 w-3" }) : /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(Copy, { className: "h-3 w-3" })
-          }
-        ),
-        canPeek ? /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(
-          "button",
-          {
-            type: "button",
-            onClick: (e) => {
-              stop(e);
-              setPeekOpen(true);
-            },
-            "aria-label": `Quick look at ${label ?? "record"}`,
-            title: `Quick look at ${label ?? "record"}`,
-            className: "inline-flex h-4 w-4 shrink-0 items-center justify-center rounded text-muted-foreground transition-colors hover:text-foreground focus:outline-none",
-            children: /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(Lightbulb, { className: "h-3 w-3" })
-          }
-        ) : null,
-        onOpen && resolvedHref && !forbidden ? /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(
-          "a",
-          {
-            href: resolvedHref,
-            target: "_blank",
-            rel: "noopener noreferrer",
-            onClick: stop,
-            "aria-label": `Open ${label ?? "record"} in a new tab`,
-            title: `Open ${label ?? "record"} in a new tab`,
-            className: "inline-flex h-4 w-4 shrink-0 items-center justify-center rounded text-muted-foreground transition-colors hover:text-foreground focus:outline-none",
-            children: /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(ExternalLink, { className: "h-3 w-3" })
-          }
-        ) : null,
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)(Tooltip, { children: [
+          /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(
+            "button",
+            {
+              type: "button",
+              onClick: onCopy,
+              "aria-label": copied ? "Copied" : `Copy ${label ?? "id"}`,
+              className: cn(
+                "inline-flex h-4 w-4 shrink-0 items-center justify-center rounded text-muted-foreground transition-colors hover:text-foreground focus:outline-none",
+                copied && "text-primary"
+              ),
+              children: copied ? /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(Check, { className: "h-3 w-3" }) : /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(Copy, { className: "h-3 w-3" })
+            }
+          ) }),
+          /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(TooltipContent, { side: "top", children: copied ? "Copied" : `Copy ${label ?? "id"}: ${value}` })
+        ] }),
+        canPeek ? /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)(Tooltip, { children: [
+          /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(
+            "button",
+            {
+              type: "button",
+              onClick: (e) => {
+                stop(e);
+                setPeekOpen(true);
+              },
+              "aria-label": `Quick look at ${label ?? "record"}`,
+              className: "inline-flex h-4 w-4 shrink-0 items-center justify-center rounded text-muted-foreground transition-colors hover:text-foreground focus:outline-none",
+              children: /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(Lightbulb, { className: "h-3 w-3" })
+            }
+          ) }),
+          /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)(TooltipContent, { side: "top", children: [
+            "Quick look at ",
+            label ?? "record"
+          ] })
+        ] }) : null,
+        onOpen && resolvedHref && !forbidden ? /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)(Tooltip, { children: [
+          /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(
+            "a",
+            {
+              href: resolvedHref,
+              target: "_blank",
+              rel: "noopener noreferrer",
+              onClick: stop,
+              "aria-label": `Open ${label ?? "record"} in a new tab`,
+              className: "inline-flex h-4 w-4 shrink-0 items-center justify-center rounded text-muted-foreground transition-colors hover:text-foreground focus:outline-none",
+              children: /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(ExternalLink, { className: "h-3 w-3" })
+            }
+          ) }),
+          /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)(TooltipContent, { side: "top", children: [
+            "Open ",
+            label ?? "record",
+            " in a new tab"
+          ] })
+        ] }) : null,
         trailing,
         notice,
         canPeek && peekOpen && ResourcePeek ? /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(
@@ -2305,7 +2325,7 @@ function MatrxUuidCell({
         ) : null
       ]
     }
-  );
+  ) });
 }
 
 // src/data-table/entity.ts