@ai-matrx/design-system 0.39.5 → 0.41.0

package/dist/data-table/index.d.cts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { ReactNode } from 'react';
-import { h as MatrxDataTableProps, i as TableViewSnapshot, d as MatrxDataTableRecordControls, j as ColumnMarker, M as MatrxColumnDef } from '../types-D7O3uOIs.cjs';
-export { A as AnyOfColumnSearch, k as CellEditType, l as CellEditsMap, f as ColumnFilterKind, a as ColumnFilterValue, C as ColumnFiltersState, m as MatrxDataTableContextMenuConfig, g as MatrxDataTableCopyConfig, n as MatrxDataTableCoverageConfig, c as MatrxDataTableDensity, o as MatrxDataTableDetailConfig, p as MatrxDataTableEditConfig, q as MatrxDataTableEmptyState, r as MatrxDataTableExpandedDetailConfig, s as MatrxDataTableFacetsConfig, t as MatrxDataTableFilterUi, u as MatrxDataTableGroupingConfig, v as MatrxDataTableHierarchyConfig, w as MatrxDataTableHierarchyMove, x as MatrxDataTableMobileCardControls, y as MatrxDataTableMultiExpandedDetailConfig, z as MatrxDataTableQueryControl, e as MatrxDataTableQueryState, B as MatrxDataTableSelectionConfig, D as MatrxDataTableSingleExpandedDetailConfig, E as MatrxDataTableSourceProcessing, F as MatrxDataTableSpreadsheetConfig, G as MatrxDataTableStyleConfig, H as MatrxDataTableToolbar, I as MatrxDataTableUrlStateConfig, J as MatrxDataTableVirtualizeConfig, K as MatrxDataTableWindowConfig, N as MatrxTablePagination, O as SortDirection, S as SortState, P as TableRankedSearchOptions, b as TableSavedViewsProps, T as TableSearchMatchMode, Q as TableSearchRole, R as TableSearchScope, U as TableViewQuery, V as TextFilterMode, W as ToolbarFacet, X as inferTableSearchRole, Y as rankTableSearchRows, Z as resolveTableSearchScopes } from '../types-D7O3uOIs.cjs';
+import { h as MatrxDataTableProps, i as TableViewSnapshot, d as MatrxDataTableRecordControls, j as ColumnMarker, M as MatrxColumnDef } from '../types-DNkbHRVK.cjs';
+export { A as AnyOfColumnSearch, k as CellEditType, l as CellEditsMap, f as ColumnFilterKind, a as ColumnFilterValue, C as ColumnFiltersState, m as MatrxDataTableContextMenuConfig, g as MatrxDataTableCopyConfig, n as MatrxDataTableCoverageConfig, c as MatrxDataTableDensity, o as MatrxDataTableDetailConfig, p as MatrxDataTableEditConfig, q as MatrxDataTableEmptyState, r as MatrxDataTableExpandedDetailConfig, s as MatrxDataTableFacetsConfig, t as MatrxDataTableFilterUi, u as MatrxDataTableGroupingConfig, v as MatrxDataTableHierarchyConfig, w as MatrxDataTableHierarchyMove, x as MatrxDataTableMobileCardControls, y as MatrxDataTableMultiExpandedDetailConfig, z as MatrxDataTableQueryControl, e as MatrxDataTableQueryState, B as MatrxDataTableSelectionConfig, D as MatrxDataTableSingleExpandedDetailConfig, E as MatrxDataTableSourceProcessing, F as MatrxDataTableSpreadsheetConfig, G as MatrxDataTableStyleConfig, H as MatrxDataTableToolbar, I as MatrxDataTableUrlStateConfig, J as MatrxDataTableVirtualizeConfig, K as MatrxDataTableWindowConfig, N as MatrxTablePagination, O as SortDirection, S as SortState, P as TableRankedSearchOptions, b as TableSavedViewsProps, T as TableSearchMatchMode, Q as TableSearchRole, R as TableSearchScope, U as TableViewQuery, V as TextFilterMode, W as ToolbarFacet, X as inferTableSearchRole, Y as rankTableSearchRows, Z as resolveTableSearchScopes } from '../types-DNkbHRVK.cjs';
 export { MatrxDataTableHost, MatrxDataTableProvider, MatrxTableRowAlchemy, TableDoors, TableEntityRefProps, TableLinkProps, TablePeekProps, TableSidePanelProps, TableToolbarActionProps, TableWindowPanelProps, useMatrxDataTableHost, useMatrxTableRowAlchemy } from './host.cjs';
 import { CopyControlProps } from './copy-types.cjs';
 export { AgentPayloadInput } from './copy-types.cjs';
@@ -16,7 +16,7 @@ export { DateColumnFilterValue, DateFilterBounds, TIME_RANGE_PRESETS, TIME_RANGE
 export { ScrollPaginationContainer, UseScrollPaginationOptions, UseScrollPaginationResult, useScrollPagination } from './scroll-pagination.cjs';
 export { tableUrlParamPrefix, useTableUrlState } from './url-state.cjs';
 export { BOOLEAN_TRUE_COLOR, CELL_TINT_CLASS, COLOR_RULE_OPS, COLOR_RULE_OP_LABELS, ChoiceColorLookup, ColorBy, ColorRule, ColorRuleOp, EMPTY_TABLE_STYLE, OPS_WITH_VALUE, ROW_TINT_CLASS, STYLE_COLORS, STYLE_COLOR_LABELS, SWATCH_CLASS, StyleColor, StylePath, StyleTarget, TABLE_STYLE_METADATA_KEY, TABLE_STYLE_VERSION, TableStyle, applyStylePath, colorForChoice, evaluateRule, isStyleColor, parseTableStyle, resolveCellColor, resolveRowColor, stylePath, tableStyleFromMetadata, tableStyleIsEmpty } from './table-style.cjs';
-import { c as FormatResult } from '../types-CJWU1Gae.cjs';
+import { c as FormatResult } from '../types-JnZD8wM0.cjs';
 export { EMPTY_GROUP_KEY, GroupAggregateColumn, GroupAggregateKind, GroupAggregateResult, GroupAggregateSpec, GroupOrder, GroupRowsOptions, GroupedRenderRow, TableGroup, coerceGroupNumber, flattenGroups, formatGroupNumber, groupKeyOf, groupRows, groupSummary, isBlankGroupValue, isGroupCollapsed, toggleGroupCollapsed } from './grouping.cjs';
 export { DEFAULT_OVERSCAN, ScrollToIndexInput, VariableWindowInput, WindowInput, WindowResult, computeVariableWindow, computeWindow, scrollOffsetForIndex } from './virtual-window.cjs';
 export { CoverageInput, CoverageResult, CoverageScope, PARTIAL_BADGE, UNKNOWN_TOTAL_BADGE, describeCoverage } from './coverage.cjs';
@@ -56,11 +56,16 @@ interface TableTitleRowProps {
     tabs?: ReactNode;
     actions?: ReactNode;
     children?: ReactNode;
+    /**
+     * One row at every width: nothing wraps onto a second line; the row scrolls sideways on a
+     * narrow screen instead (the search keeps its place in the row).
+     */
+    singleRow?: boolean;
     className?: string;
 }
 /** Shared responsive title composition. Hosts retain their existing query,
  * navigation and persistence controllers; this component owns layout only. */
-declare function TableTitleRow({ title, headingLevel, context, count, search, tabs, actions, children, className, }: TableTitleRowProps): React.JSX.Element;
+declare function TableTitleRow({ title, headingLevel, context, count, search, tabs, actions, children, singleRow, className, }: TableTitleRowProps): React.JSX.Element;
 
 interface SavedViewsControlProps {
     views: ReadonlyArray<{

package/dist/data-table/index.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { ReactNode } from 'react';
-import { h as MatrxDataTableProps, i as TableViewSnapshot, d as MatrxDataTableRecordControls, j as ColumnMarker, M as MatrxColumnDef } from '../types-p13OrDj-.js';
-export { A as AnyOfColumnSearch, k as CellEditType, l as CellEditsMap, f as ColumnFilterKind, a as ColumnFilterValue, C as ColumnFiltersState, m as MatrxDataTableContextMenuConfig, g as MatrxDataTableCopyConfig, n as MatrxDataTableCoverageConfig, c as MatrxDataTableDensity, o as MatrxDataTableDetailConfig, p as MatrxDataTableEditConfig, q as MatrxDataTableEmptyState, r as MatrxDataTableExpandedDetailConfig, s as MatrxDataTableFacetsConfig, t as MatrxDataTableFilterUi, u as MatrxDataTableGroupingConfig, v as MatrxDataTableHierarchyConfig, w as MatrxDataTableHierarchyMove, x as MatrxDataTableMobileCardControls, y as MatrxDataTableMultiExpandedDetailConfig, z as MatrxDataTableQueryControl, e as MatrxDataTableQueryState, B as MatrxDataTableSelectionConfig, D as MatrxDataTableSingleExpandedDetailConfig, E as MatrxDataTableSourceProcessing, F as MatrxDataTableSpreadsheetConfig, G as MatrxDataTableStyleConfig, H as MatrxDataTableToolbar, I as MatrxDataTableUrlStateConfig, J as MatrxDataTableVirtualizeConfig, K as MatrxDataTableWindowConfig, N as MatrxTablePagination, O as SortDirection, S as SortState, P as TableRankedSearchOptions, b as TableSavedViewsProps, T as TableSearchMatchMode, Q as TableSearchRole, R as TableSearchScope, U as TableViewQuery, V as TextFilterMode, W as ToolbarFacet, X as inferTableSearchRole, Y as rankTableSearchRows, Z as resolveTableSearchScopes } from '../types-p13OrDj-.js';
+import { h as MatrxDataTableProps, i as TableViewSnapshot, d as MatrxDataTableRecordControls, j as ColumnMarker, M as MatrxColumnDef } from '../types-Dx5hJgCi.js';
+export { A as AnyOfColumnSearch, k as CellEditType, l as CellEditsMap, f as ColumnFilterKind, a as ColumnFilterValue, C as ColumnFiltersState, m as MatrxDataTableContextMenuConfig, g as MatrxDataTableCopyConfig, n as MatrxDataTableCoverageConfig, c as MatrxDataTableDensity, o as MatrxDataTableDetailConfig, p as MatrxDataTableEditConfig, q as MatrxDataTableEmptyState, r as MatrxDataTableExpandedDetailConfig, s as MatrxDataTableFacetsConfig, t as MatrxDataTableFilterUi, u as MatrxDataTableGroupingConfig, v as MatrxDataTableHierarchyConfig, w as MatrxDataTableHierarchyMove, x as MatrxDataTableMobileCardControls, y as MatrxDataTableMultiExpandedDetailConfig, z as MatrxDataTableQueryControl, e as MatrxDataTableQueryState, B as MatrxDataTableSelectionConfig, D as MatrxDataTableSingleExpandedDetailConfig, E as MatrxDataTableSourceProcessing, F as MatrxDataTableSpreadsheetConfig, G as MatrxDataTableStyleConfig, H as MatrxDataTableToolbar, I as MatrxDataTableUrlStateConfig, J as MatrxDataTableVirtualizeConfig, K as MatrxDataTableWindowConfig, N as MatrxTablePagination, O as SortDirection, S as SortState, P as TableRankedSearchOptions, b as TableSavedViewsProps, T as TableSearchMatchMode, Q as TableSearchRole, R as TableSearchScope, U as TableViewQuery, V as TextFilterMode, W as ToolbarFacet, X as inferTableSearchRole, Y as rankTableSearchRows, Z as resolveTableSearchScopes } from '../types-Dx5hJgCi.js';
 export { MatrxDataTableHost, MatrxDataTableProvider, MatrxTableRowAlchemy, TableDoors, TableEntityRefProps, TableLinkProps, TablePeekProps, TableSidePanelProps, TableToolbarActionProps, TableWindowPanelProps, useMatrxDataTableHost, useMatrxTableRowAlchemy } from './host.js';
 import { CopyControlProps } from './copy-types.js';
 export { AgentPayloadInput } from './copy-types.js';
@@ -16,7 +16,7 @@ export { DateColumnFilterValue, DateFilterBounds, TIME_RANGE_PRESETS, TIME_RANGE
 export { ScrollPaginationContainer, UseScrollPaginationOptions, UseScrollPaginationResult, useScrollPagination } from './scroll-pagination.js';
 export { tableUrlParamPrefix, useTableUrlState } from './url-state.js';
 export { BOOLEAN_TRUE_COLOR, CELL_TINT_CLASS, COLOR_RULE_OPS, COLOR_RULE_OP_LABELS, ChoiceColorLookup, ColorBy, ColorRule, ColorRuleOp, EMPTY_TABLE_STYLE, OPS_WITH_VALUE, ROW_TINT_CLASS, STYLE_COLORS, STYLE_COLOR_LABELS, SWATCH_CLASS, StyleColor, StylePath, StyleTarget, TABLE_STYLE_METADATA_KEY, TABLE_STYLE_VERSION, TableStyle, applyStylePath, colorForChoice, evaluateRule, isStyleColor, parseTableStyle, resolveCellColor, resolveRowColor, stylePath, tableStyleFromMetadata, tableStyleIsEmpty } from './table-style.js';
-import { c as FormatResult } from '../types-CJWU1Gae.js';
+import { c as FormatResult } from '../types-JnZD8wM0.js';
 export { EMPTY_GROUP_KEY, GroupAggregateColumn, GroupAggregateKind, GroupAggregateResult, GroupAggregateSpec, GroupOrder, GroupRowsOptions, GroupedRenderRow, TableGroup, coerceGroupNumber, flattenGroups, formatGroupNumber, groupKeyOf, groupRows, groupSummary, isBlankGroupValue, isGroupCollapsed, toggleGroupCollapsed } from './grouping.js';
 export { DEFAULT_OVERSCAN, ScrollToIndexInput, VariableWindowInput, WindowInput, WindowResult, computeVariableWindow, computeWindow, scrollOffsetForIndex } from './virtual-window.js';
 export { CoverageInput, CoverageResult, CoverageScope, PARTIAL_BADGE, UNKNOWN_TOTAL_BADGE, describeCoverage } from './coverage.js';
@@ -56,11 +56,16 @@ interface TableTitleRowProps {
     tabs?: ReactNode;
     actions?: ReactNode;
     children?: ReactNode;
+    /**
+     * One row at every width: nothing wraps onto a second line; the row scrolls sideways on a
+     * narrow screen instead (the search keeps its place in the row).
+     */
+    singleRow?: boolean;
     className?: string;
 }
 /** Shared responsive title composition. Hosts retain their existing query,
  * navigation and persistence controllers; this component owns layout only. */
-declare function TableTitleRow({ title, headingLevel, context, count, search, tabs, actions, children, className, }: TableTitleRowProps): React.JSX.Element;
+declare function TableTitleRow({ title, headingLevel, context, count, search, tabs, actions, children, singleRow, className, }: TableTitleRowProps): React.JSX.Element;
 
 interface SavedViewsControlProps {
     views: ReadonlyArray<{

package/dist/data-table/index.js

@@ -13,6 +13,7 @@ import {
   useRef as useRef16,
   useState as useState22
 } from "react";
+import { createPortal as createPortal2 } from "react-dom";
 import {
   DndContext,
   DragOverlay,
@@ -941,6 +942,7 @@ function TableTitleRow({
   tabs,
   actions,
   children,
+  singleRow = false,
   className
 }) {
   const Heading = headingLevel === 1 ? "h1" : "h2";
@@ -949,7 +951,8 @@ function TableTitleRow({
     {
       "data-matrx-table-toolbar": true,
       className: cn(
-        "relative flex min-w-0 shrink-0 flex-wrap items-center gap-2",
+        "relative flex min-w-0 shrink-0 items-center gap-2",
+        singleRow ? "flex-nowrap overflow-x-auto [scrollbar-width:none] [&::-webkit-scrollbar]:hidden" : "flex-wrap",
         className
       ),
       children: [
@@ -968,7 +971,7 @@ function TableTitleRow({
           "div",
           {
             "data-matrx-table-title-search": true,
-            className: "order-last w-full min-w-0 sm:order-none sm:w-64 sm:shrink-0 sm:max-w-md",
+            className: singleRow ? "w-44 min-w-[9rem] shrink-0 sm:w-64 sm:max-w-md" : "order-last w-full min-w-0 sm:order-none sm:w-64 sm:shrink-0 sm:max-w-md",
             children: search
           }
         ) : null,
@@ -978,7 +981,7 @@ function TableTitleRow({
           "div",
           {
             "data-matrx-table-actions": true,
-            className: "ml-auto flex min-w-0 flex-wrap items-center gap-0",
+            className: cn("ml-auto flex min-w-0 items-center gap-0", singleRow ? "shrink-0 flex-nowrap" : "flex-wrap"),
             children: actions
           }
         ) : null
@@ -10184,6 +10187,35 @@ function toText(value) {
     return String(value);
   return null;
 }
+function parseTimeOfDay(value) {
+  if (value instanceof Date) {
+    return { h: value.getHours(), m: value.getMinutes(), s: value.getSeconds() };
+  }
+  if (typeof value !== "string") return null;
+  const text = value.trim();
+  if (!text) return null;
+  const m = /^(\d{1,2})(?::(\d{2}))?(?::(\d{2}))?\s*([aApP]\.?[mM]\.?)?$/.exec(text);
+  if (m) {
+    let h = Number(m[1]);
+    const min = m[2] ? Number(m[2]) : 0;
+    const sec = m[3] ? Number(m[3]) : 0;
+    const ampm = m[4]?.toLowerCase().replace(/\./g, "");
+    if (ampm) {
+      if (h < 1 || h > 12) return null;
+      if (ampm === "pm" && h !== 12) h += 12;
+      if (ampm === "am" && h === 12) h = 0;
+    }
+    if (h > 23 || min > 59 || sec > 59) return null;
+    return { h, m: min, s: sec };
+  }
+  if (/\d{4}-\d{2}-\d{2}T/.test(text)) {
+    const d = new Date(text);
+    if (!Number.isNaN(d.getTime())) {
+      return { h: d.getHours(), m: d.getMinutes(), s: d.getSeconds() };
+    }
+  }
+  return null;
+}
 var BARE_CALENDAR_DATE = /^(\d{4})-(\d{2})-(\d{2})(?:[T ]00:00(?::00(?:\.0+)?)?)?$/;
 function toDate(value) {
   if (value instanceof Date) return Number.isNaN(value.getTime()) ? null : value;
@@ -10304,6 +10336,23 @@ var DEFS = [
     },
     parse: (raw) => raw === "" || raw == null ? null : String(raw).trim()
   },
+  {
+    // A postal address. Free text by design (addresses have no one shape
+    // worldwide); the cell opens it in maps, which is the thing people do
+    // with an address in a table.
+    id: "address",
+    label: "Address",
+    description: "Street address \u2014 click to open in maps",
+    group: "Text",
+    base: "string",
+    editor: "text",
+    rich: true,
+    format: (v) => {
+      const t = toText(v)?.trim();
+      return t ? t : null;
+    },
+    parse: (raw) => raw === "" || raw == null ? null : String(raw)
+  },
   {
     id: "url",
     label: "Link",
@@ -10437,6 +10486,26 @@ var DEFS = [
     },
     parse: (raw) => toNumber(raw)
   },
+  {
+    // A percentage DRAWN as a bar — task completion, quota used, a score out of
+    // 100. Same storage and scale rule as `percent`; only the rendering differs.
+    id: "progress",
+    label: "Progress bar",
+    description: "A percentage shown as a bar",
+    group: "Numbers",
+    base: "number",
+    alsoAccepts: ["integer"],
+    editor: "number",
+    rich: true,
+    optionKeys: ["percentScale"],
+    format: (v, o) => {
+      const n2 = toNumber(v);
+      if (n2 === null) return null;
+      const shown = o.percentScale === "fraction" ? n2 * 100 : n2;
+      return `${groupedNumber(shown, { precision: 0 })}%`;
+    },
+    parse: (raw) => toNumber(raw)
+  },
   {
     id: "duration",
     label: "Duration",
@@ -10505,13 +10574,16 @@ var DEFS = [
     alsoAccepts: ["number"],
     editor: "number",
     numericAlign: true,
+    // The name says BYTES on purpose: this cell holds a genuine byte length,
+    // never a character or item count, and `formatFileSize` is only honest
+    // about a quantity that is actually bytes.
     format: (v) => {
-      const n2 = toNumber(v);
-      return n2 === null ? null : formatFileSize(n2);
+      const byteLength = toNumber(v);
+      return byteLength === null ? null : formatFileSize(byteLength);
     },
     parse: (raw) => {
-      const n2 = toNumber(raw);
-      return n2 === null ? null : Math.trunc(n2);
+      const byteLength = toNumber(raw);
+      return byteLength === null ? null : Math.trunc(byteLength);
     }
   },
   // ── Choice ────────────────────────────────────────────────────────────────
@@ -10572,6 +10644,87 @@ var DEFS = [
     },
     parse: (raw) => raw === "" || raw == null ? null : String(raw)
   },
+  {
+    // A TIME OF DAY with no date: opening hours, a shift start, a meeting slot.
+    // Stored as the string the <input type="time"> gives ("HH:MM" or
+    // "HH:MM:SS"), shown in the viewer's locale ("2:30 PM" / "14:30"). The
+    // storage type stays `string`; sorting is lexical on the 24-hour form,
+    // which is chronological — the one reason the stored form is 24-hour.
+    id: "time",
+    label: "Time",
+    description: "Time of day, without a date",
+    group: "Dates",
+    base: "string",
+    editor: "time",
+    optionKeys: ["timeSeconds"],
+    format: (v, o) => {
+      const parts = parseTimeOfDay(v);
+      if (!parts) return null;
+      const d = new Date(2e3, 0, 1, parts.h, parts.m, parts.s);
+      return d.toLocaleTimeString(void 0, {
+        hour: "numeric",
+        minute: "2-digit",
+        ...o.timeSeconds ? { second: "2-digit" } : {}
+      });
+    },
+    // Normalise to the 24-hour "HH:MM[:SS]" form; a value that is not a time
+    // is handed back unchanged so the validation layer can refuse it by name.
+    parse: (raw) => {
+      if (raw == null || raw === "") return null;
+      const parts = parseTimeOfDay(raw);
+      if (!parts) return raw;
+      const two = (n2) => String(n2).padStart(2, "0");
+      const fields = parts.s > 0 ? [parts.h, parts.m, parts.s] : [parts.h, parts.m];
+      return fields.map(two).join(":");
+    }
+  },
+  {
+    // Assigned BY THE DATABASE when the row is inserted (trigger
+    // `_udt_autonumber`), so it is the same number whichever door made the row
+    // and never shifts when another row is deleted. Stored in the cell as an
+    // integer; every editor refuses it. `prefix` turns 42 into "INV-42".
+    id: "autonumber",
+    label: "Autonumber",
+    description: "A number the table assigns to each new row \u2014 never typed",
+    group: "Numbers",
+    base: "integer",
+    alsoAccepts: ["number"],
+    editor: "computed",
+    numericAlign: true,
+    optionKeys: ["prefix"],
+    format: (v, o) => {
+      const n2 = toNumber(v);
+      if (n2 === null) return null;
+      return `${o.prefix ?? ""}${Math.trunc(n2)}`;
+    },
+    parse: () => null
+  },
+  // ── System columns ────────────────────────────────────────────────────────
+  // Filled from the ROW'S OWN RECORD on read (`withComputedColumns` in
+  // `@ai-matrx/design-system/formulas`), never typed and never stored in the
+  // cell. `editor: "computed"` makes every editor refuse them.
+  {
+    id: "created_time",
+    label: "Created time",
+    description: "When the row was added \u2014 filled in automatically",
+    group: "Dates",
+    base: "string",
+    editor: "computed",
+    optionKeys: ["dateStyle"],
+    format: (v, o) => FIELD_FORMATS.datetime.format(v, o),
+    parse: () => null
+  },
+  {
+    id: "modified_time",
+    label: "Last modified time",
+    description: "When the row last changed \u2014 filled in automatically",
+    group: "Dates",
+    base: "string",
+    editor: "computed",
+    optionKeys: ["dateStyle"],
+    format: (v, o) => FIELD_FORMATS.datetime.format(v, o),
+    parse: () => null
+  },
   {
     id: "relative_time",
     label: "Relative time",
@@ -10628,6 +10781,44 @@ var DEFS = [
       return toList(raw) ?? raw;
     }
   },
+  {
+    // FILES ATTACHED TO THE ROW. The cell stores the files feature's file ids
+    // (`files.files.id`), never a URL or a name: a rename or a move in Files
+    // changes nothing here, and access is the file's own (RLS) — a reader who
+    // may see the row but not the file gets the chip's honest "no access", not
+    // a broken link. Drawn by `AttachmentChips`, edited by `AttachmentInput`
+    // through the ONE file picker.
+    id: "attachment",
+    label: "Attachments",
+    description: "Files from your Files, shown as chips",
+    group: "Structured",
+    base: "array",
+    // Not `string`: on a text column it must appear under "Other kinds" so
+    // picking it retypes the column to a list, rather than storing a JSON
+    // string of ids in a text cell.
+    alsoAccepts: ["json"],
+    editor: "attachment",
+    rich: true,
+    format: (v) => {
+      const list = toList(v);
+      if (list === null) return null;
+      const n2 = list.filter((i) => String(i).trim()).length;
+      return n2 === 0 ? "" : n2 === 1 ? "1 file" : `${n2} files`;
+    },
+    parse: (raw) => {
+      if (raw == null || raw === "") return null;
+      if (Array.isArray(raw)) return raw.map((i) => String(i).trim()).filter(Boolean);
+      const text = String(raw).trim();
+      if (text.startsWith("[")) {
+        try {
+          const parsed = JSON.parse(text);
+          if (Array.isArray(parsed)) return parsed.map((i) => String(i).trim()).filter(Boolean);
+        } catch {
+        }
+      }
+      return text.split(",").map((s) => s.trim()).filter(Boolean);
+    }
+  },
   {
     id: "tags",
     label: "Tags",
@@ -10691,6 +10882,82 @@ var DEFS = [
       return trimmed === "" ? null : trimmed;
     }
   },
+  {
+    // A PERSON: one member of the organization the table belongs to, stored as
+    // the user id. It is a choice column whose options are the members —
+    // supplied at runtime by whoever renders it (features/data-tables/
+    // person-choices.tsx), the same door a structured-list-bound column uses —
+    // so the cell picker, the chip, filters, color-by and the agent scope are
+    // all the choice system's, with no second implementation.
+    id: "person",
+    label: "Person",
+    description: "Someone in your organization \u2014 pick from its members",
+    group: "Choice",
+    base: "string",
+    editor: "select",
+    rich: true,
+    format: (v, o) => FIELD_FORMATS.choice.format(v, o),
+    parse: (raw) => FIELD_FORMATS.choice.parse(raw, {})
+  },
+  {
+    // A RECORD OF ANOTHER TABLE. The cell stores that record's ID; the screen
+    // shows its WORDS. `person` is the precedent and the template — it has
+    // stored a user id and displayed a name through `choiceMap` since
+    // 2026-09-21 — so `relation` is a member of CHOICE_FORMAT_IDS and every
+    // one of the ten readers that print a cell resolves it through the path
+    // they already use for `person`. There is no eleventh place to remember.
+    //
+    // THREE STATES, THREE RENDERINGS, NO FOURTH (OLD-TABLES-CUTOVER §3.3):
+    //   resolved      the target's words
+    //   unresolvable  the amber fallback WITH the id, as an identifier — never
+    //                 a blank, and never the bare uuid as if it were text, so a
+    //                 person can act on it and support can trace it
+    //   withheld      platform.relation_withheld_label(), with NO id — a cell
+    //                 the reader may not see never leaks the identifier through
+    //                 the gap between the two stores' refusals
+    //
+    // `format` therefore returns null (the fallback law's "cannot interpret")
+    // for anything the resolver did not turn into words, and the renderer is
+    // what distinguishes unresolvable from withheld. It never prints a bare id.
+    id: "relation",
+    label: "Relation",
+    description: "A record of another table \u2014 pick it, and its name is shown",
+    group: "Choice",
+    base: "string",
+    alsoAccepts: ["array", "json"],
+    editor: "select",
+    rich: true,
+    optionKeys: ["relation_target", "relation_max", "on_delete", "display"],
+    // IT DOES NOT DELEGATE TO `choice`, AND THAT IS THE WHOLE POINT.
+    // `choice.format` deliberately returns the RAW VALUE when no options have
+    // resolved yet — a structured list still loading should not make every cell
+    // look off-list. For a label column that is right: the raw value IS the
+    // label. For an identifier column it is the defect §3.3 names, and it is
+    // how the first cut of this wave put four raw uuids on a real grid: the
+    // fallback arm never ran, because returning the uuid counted as SUCCESS.
+    //
+    // Here, a value that did not resolve to words is a MISMATCH — `null` — so
+    // the renderer's three-state arm owns it and shows the amber fallback with
+    // the id marked as an identifier, or the withheld sentence. The id never
+    // reaches the eye as if it were the cell's contents.
+    format: (v, options) => {
+      const list = toList(v);
+      const values = list !== null ? list : v == null ? [] : [v];
+      if (values.length === 0) return "";
+      const words2 = [];
+      for (const entry of values) {
+        const text = toText(entry);
+        if (text === null) return null;
+        const trimmed = text.trim();
+        if (trimmed === "") continue;
+        const match = findChoice(options.choices, trimmed);
+        if (!match) return null;
+        words2.push(match.label ?? match.value);
+      }
+      return words2.length === 0 ? "" : words2.join(", ");
+    },
+    parse: (raw) => FIELD_FORMATS.choice.parse(raw, {})
+  },
   {
     id: "multi_choice",
     label: "Multi-choice",
@@ -10735,7 +11002,7 @@ var DEFS = [
   // A formula column stores NOTHING. `metadata.format.options.formula` holds
   // the expression; the stored cell is always null; the value is computed on
   // read from the other columns of the same row
-  // (`features/data-tables/formulas.ts`). Grouped under Structured on purpose
+  // (`@ai-matrx/design-system/formulas`). Grouped under Structured on purpose
   // — the picker's groups are a fixed vocabulary, and a formula is structure
   // over a plain string column, not a sixth family.
   //
@@ -13429,6 +13696,11 @@ function MatrxDataTableCore({
   const rowCopyInMenu = rowCopyPlacement === "menu" && Boolean(rowActions);
   const showInlineRowCopy = showRowCopy && !rowCopyInMenu;
   const showToolbarCopy = effectiveCopy !== void 0 && effectiveCopy.showToolbar !== false;
+  const placeToolbar = (node) => {
+    if (!toolbar || !("portalInto" in toolbar)) return node;
+    const target = toolbar.portalInto;
+    return target ? createPortal2(node, target) : null;
+  };
   const renderRowActions = (row, controls) => {
     const actions = rowActions?.(row, controls);
     const scopedActions = /* @__PURE__ */ jsx42(MatrxTableRowControlsScope, { value: controls, children: actions });
@@ -14256,9 +14528,10 @@ function MatrxDataTableCore({
               notice,
               savedViewError ? /* @__PURE__ */ jsx42("p", { role: "alert", className: "shrink-0 text-xs text-destructive", children: savedViewError }) : null,
               toolbarActionError ? /* @__PURE__ */ jsx42("p", { role: "alert", className: "shrink-0 text-xs text-destructive", children: toolbarActionError }) : null,
-              !hideToolbar && (viewTabs || toolbar?.title || toolbar?.titleCount || showSearch || toolbar?.customSearch || toolbar?.anyOf || toolbar?.layeredFilters || toolbar?.facets && toolbar.facets.length > 0 || toolbar?.leading || toolbar?.actions || toolbar?.refresh || toolbar?.add || tableId && SavedViews || hasActiveFilters || showToolbarCopy || columns.length > 0) && /* @__PURE__ */ jsxs32(
+              placeToolbar(!hideToolbar && (viewTabs || toolbar?.title || toolbar?.titleCount || showSearch || toolbar?.customSearch || toolbar?.anyOf || toolbar?.layeredFilters || toolbar?.facets && toolbar.facets.length > 0 || toolbar?.leading || toolbar?.actions || toolbar?.refresh || toolbar?.add || tableId && SavedViews || hasActiveFilters || showToolbarCopy || columns.length > 0) && /* @__PURE__ */ jsxs32(
                 TableTitleRow,
                 {
+                  ...toolbar?.singleRow ? { singleRow: true } : {},
                   tabs: viewTabs ? /* @__PURE__ */ jsx42(TableViewWorkspace, { snapshot: currentViewSnapshot, onApply: applySavedView, related: relatedTableActions }, tableId ?? "table") : void 0,
                   ...toolbar?.title === void 0 ? {} : { title: toolbar.title },
                   ...toolbar?.titleCount === void 0 ? {} : { count: toolbar.titleCount },
@@ -14393,8 +14666,31 @@ function MatrxDataTableCore({
                       "div",
                       {
                         "data-matrx-table-actions": true,
-                        className: "ml-auto flex min-w-0 flex-wrap items-center gap-0",
+                        className: cn(
+                          "ml-auto flex min-w-0 items-center gap-0",
+                          toolbar?.singleRow ? "shrink-0 flex-nowrap" : "flex-wrap"
+                        ),
                         children: [
+                          toolbar?.singleRow && coverageResult && coverageResult.notice ? /* @__PURE__ */ jsxs32(Tooltip, { children: [
+                            /* @__PURE__ */ jsx42(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ jsxs32(
+                              "span",
+                              {
+                                "data-matrx-table-coverage": true,
+                                "data-matrx-table-coverage-scope": coverageResult.scope,
+                                role: "status",
+                                tabIndex: 0,
+                                className: "mr-1 inline-flex shrink-0 items-center whitespace-nowrap rounded-md border border-amber-300/70 bg-amber-50 px-2 py-0.5 text-[11px] font-semibold text-amber-900 dark:border-amber-500/40 dark:bg-amber-950/40 dark:text-amber-200",
+                                children: [
+                                  coverageResult.badge,
+                                  /* @__PURE__ */ jsxs32("span", { className: "sr-only", children: [
+                                    ": ",
+                                    coverageResult.notice
+                                  ] })
+                                ]
+                              }
+                            ) }),
+                            /* @__PURE__ */ jsx42(TooltipContent, { className: "max-w-xs", children: coverageResult.notice })
+                          ] }) : null,
                           /* @__PURE__ */ jsx42(
                             TableToolbarAction,
                             {
@@ -14537,9 +14833,9 @@ function MatrxDataTableCore({
                     )
                   ]
                 }
-              ),
+              )),
               /* @__PURE__ */ jsxs32("div", { "data-matrx-table-body-region": true, className: "flex min-h-0 flex-1 flex-col gap-2", children: [
-                coverageResult && coverageResult.notice ? /* @__PURE__ */ jsxs32(
+                coverageResult && coverageResult.notice && !toolbar?.singleRow ? /* @__PURE__ */ jsxs32(
                   "div",
                   {
                     "data-matrx-table-coverage": true,