@ai-matrx/records-ui 0.85.4 → 0.85.6

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, ComponentType, RefObject } from 'react';
 import * as _ai_matrx_records from '@ai-matrx/records';
-import { PermissionLevel, Table, RecordScopeContext, EnrichCell, RecordsError, Uuid as Uuid$1, StoreFilter, AggregateFilter, Field, RecordDocument, ReadRow, RelationDisplay, WriteConflict, RecordsErrorCode, DeclarableFieldKind, ParityFieldType, NewFieldDeclaration, RuleExpression, ValueEnvelope, ChecklistRequirementKind, ContextPolicy, WorkDueState, FieldSensitivity, StageRuleOnFail, SubscriptionCadence, WorkInboxKind, FieldKind, RecordFilter, RecordsResult, SavedViewRow, ArchiveLane, ArchivedRow, FormSummary, PortalCard, PortalPrincipal, PortalPreviewRow, MySubscription, DashboardBlockKind, AggregateBucket, AggregateMeasure, AggregateCompare, DashboardTarget, DashboardBlock, DashboardSummary, DocTemplateRow, DocRenderRow, QuietHours, DashboardBlockResult, ChecklistRunStep, BookingSummary, CaptureSheetFace, CaptureField, AnonTokenBinding, RecordsConfig, RecordsActor, RecordsDataSource, HistoryActor, FieldHistoryEntry } from '@ai-matrx/records';
+import { PermissionLevel, Table, RecordScopeContext, EnrichCell, RecordsError, Uuid as Uuid$1, StoreFilter, AggregateFilter, Field, ReadRow, RecordDocument, RelationDisplay, WriteConflict, RecordsErrorCode, TableDecorations, DeclarableFieldKind, ParityFieldType, NewFieldDeclaration, RuleExpression, HiddenFieldNotice, ValueEnvelope, ChecklistRequirementKind, ContextPolicy, WorkDueState, FieldSensitivity, StageRuleOnFail, SubscriptionCadence, WorkApprovalState, WorkInboxKind, FieldKind, RecordFilter, RecordsResult, SavedViewRow, ArchiveLane, ArchivedRow, WorkInboxItem, FormSummary, PortalCard, PortalPrincipal, PortalPreviewRow, MySubscription, DashboardBlockKind, AggregateBucket, AggregateMeasure, AggregateCompare, DashboardTarget, DashboardBlock, DashboardSummary, DocTemplateRow, DocRenderRow, QuietHours, DashboardBlockResult, ChecklistRunStep, BookingSummary, CaptureSheetFace, CaptureField, AnonTokenBinding, RecordsConfig, RecordsActor, RecordsDataSource, HistoryActor, FieldHistoryEntry } from '@ai-matrx/records';
 import { Uuid, StoreFilter as StoreFilter$1, Field as Field$1, ReadRow as ReadRow$1 } from '@ai-matrx/records/react';
 import { RecordsClient } from '@ai-matrx/records/core';
 export { DEFAULT_FIELDS, DeclareResult, NewFieldSpec, NewTableSpec, addFields, declareTable, fieldDeclarationFor, tokenFor } from '@ai-matrx/records/core';
@@ -757,6 +757,15 @@ declare function rowNameIn(table: TitledTable, row: ReadRow | undefined, fallbac
  * 2026-09-20).
  */
 declare const WITHHELD_RECORD_LABEL = "A record you have not been given access to";
+/**
+ * THE FIELD A CARD IS TITLED BY — kanban, calendar, gallery and pipeline alike.
+ *
+ * Order: the Table's `title_field` → a conventional name key (`title`, `name`, …) → the first
+ * text column in declared `sort` order → the first other column that can title (never a
+ * checkbox, never the group column, never a system stamp). `undefined` when nothing can, and
+ * the card falls back to `rowName`, which says "Untitled" rather than "false".
+ */
+declare function cardTitleField(fields: readonly Field[], titleKey: string | null | undefined, exclude?: readonly (string | null | undefined)[]): Field | undefined;
 
 /** What a person has chosen: the table, and optionally which of its columns to show. */
 interface ReferenceChoice {
@@ -1168,6 +1177,42 @@ declare function currencyCodeFor(unit: string | null | undefined): string;
  * that changes and every screen follows.
  */
 declare const colorFromTheValue: ChoiceColorLookup;
+/**
+ * G1's TABLE-LEVEL COLORS (`custom.table_decorations` / `client.tableDecorations`),
+ * TRANSLATED INTO A `TableStyle` — the same document a saved view's own `presentation.style`
+ * is, so one resolver (`resolveTableStyle`, below) can treat "the table's colors" and "this
+ * view's colors" as two layers of the SAME thing instead of two unrelated systems.
+ *
+ * THE TRANSLATION IS NECESSARY AND IT IS THE ONLY ONE. G1 addresses a Field by its ID
+ * (REC-17 — a column renamed keeps its color), because it is the STORE's own door; a
+ * `TableStyle` addresses a Field by its KEY, because it reads straight off `row.document`,
+ * which is keyed by Field key. A rule or a color-by whose Field has been deleted (its id no
+ * longer resolves to a key) is dropped rather than crashing the whole style — a defect in
+ * one rule costs that rule, never the read.
+ */
+declare function styleFromDecorations(decorations: TableDecorations | null | undefined, fields: readonly Field[]): TableStyle;
+/**
+ * THE ONE PRESENTATION RESOLVER every colored surface in this package reads —
+ * `Grid`, and (via `Card`) the kanban board, the calendar and the gallery.
+ *
+ * THE CLASS THIS CLOSES (lane UI-QUICK-1, TABLE-PARITY review, 2026-09-24). Threading
+ * `view.presentation.style` into `Card` closed the instance the CALENDAR-GALLERY bench
+ * found — a VIEW that had its own color-by looked right everywhere — but it left the
+ * class open: a table whose colors are the ORGANIZATION's decorations (G1's
+ * `custom.table_decorations` — "color rows by Account Type", "MAXED and NEAR rules" on
+ * Arman's own Coding Accounts table) and whose views never set a `presentation.style` of
+ * their own drew NOTHING, on the grid exactly as much as on every other layout, because
+ * nothing in this package had ever read G1's door at all.
+ *
+ * TWO LAYERS, ONE DOCUMENT. The table's decorations are the base coat — what every view
+ * of this table shows until a view says otherwise. A view's OWN `presentation.style` is
+ * an override, piece by piece: a view that only ever set manual row highlights still
+ * inherits the table's color-by and rules for everything it never touched, and a view
+ * that fully redecorated (its own `colorBy` AND its own `rules`) is not haunted by a
+ * table rule it meant to replace. Per-piece, never all-or-nothing, because a view is a
+ * LOOK on top of the table, not a wholesale substitute for it.
+ */
+declare function resolveTableStyle(decorations: TableDecorations | null | undefined, fields: readonly Field[], viewStyle: TableStyle | undefined): TableStyle;
 
 /**
  * WHAT A TABLE WITH NO COLUMNS SAYS. Named here because the gate asserts on it:
@@ -1805,7 +1850,7 @@ declare function ProvenanceBadge({ document, fieldKey }: {
  * export, a chat line) keeps calling `renderValue` with no resolver and says
  * "Loading…" rather than printing an id.
  */
-declare function RecordValue({ field, value, document, format, }: {
+declare function RecordValue({ field, value, document, format, withheld, }: {
     field: Field;
     value: unknown;
     document?: RecordDocument | undefined;
@@ -1822,12 +1867,35 @@ declare function RecordValue({ field, value, document, format, }: {
      * blank.
      */
     format?: FieldFormatConfig | undefined;
+    /**
+     * THE STORE'S REASON, when it withheld this value from the reader (`ReadRow.hidden[key]`).
+     * A withheld value reads "Withheld" with the store's sentence on hover — never "—", which
+     * means the cell is empty (`withheld.tsx`).
+     */
+    withheld?: HiddenFieldNotice | null | undefined;
 }): react.JSX.Element;
+/**
+ * WHAT ONE CARD SAYS — the kanban's, the calendar's, the gallery's and the pipeline's alike, so
+ * no card can read a record differently from another. `field` is the card's title column
+ * (`cardTitleField`); a value the store withheld reads "Withheld" and carries the store's reason
+ * for the card's hover (`withheld.tsx`), never a bare "—".
+ */
+declare function cardWords(record: {
+    document?: RecordDocument | null;
+    hidden?: Record<string, HiddenFieldNotice> | null;
+} & Parameters<typeof rowName>[0], field: Field | undefined, labels?: LabelLookup): {
+    text: string;
+    withheld: string | null;
+};
 
 declare const WORK_DUE_STATES: readonly ["overdue", "due_today", "scheduled", "undated", "finished"];
 declare const DUE_STATE_LABEL: Record<WorkDueState, string>;
 declare const WORK_INBOX_KINDS: readonly ["assignment", "approval", "proposal"];
 declare const WORK_INBOX_KIND_LABEL: Record<WorkInboxKind, string>;
+/** The heading an inbox grouped by kind reads (lane S5-PRIME) — plural, the way Linear groups. */
+declare const WORK_INBOX_KIND_GROUP_LABEL: Record<WorkInboxKind, string>;
+declare const WORK_APPROVAL_STATES: readonly ["pending", "approved", "declined", "withdrawn"];
+declare const WORK_APPROVAL_STATE_LABEL: Record<WorkApprovalState, string>;
 declare const CHECKLIST_REQUIREMENT_KINDS: readonly ["none", "note", "answer", "record_field", "form", "document"];
 declare const CHECKLIST_REQUIREMENT_LABEL: Record<ChecklistRequirementKind, string>;
 declare const FIELD_SENSITIVITY_LABEL: Record<FieldSensitivity, string>;
@@ -2057,6 +2125,49 @@ interface SavedView extends SavedViewSpec {
      */
     designatedLayout?: string | null;
 }
+/**
+ * WHICH LAYOUT A VIEW WAS DESIGNATED, OR NULL (lane DATA-V2-FACE, owner 2026-09-24).
+ *
+ * "For something like my data tables, which are predetermined with a default view of 'Sheet'
+ * I want to see … it just shows them the way it should in the default view. That's how you take
+ * custom systems and fake like they're hard-coded builtin systems."
+ *
+ * A designation is a DELIBERATE write, never a click: a view whose stored kind is a layout the
+ * HOST draws (`sheet` — a layout the store's view-keys registry declares, and one the layout
+ * buttons never write onto a view). That is the ONE way a table is designated (lane
+ * VIEW-KEYS-SHEET): the mover and the repair write `layout: "sheet"` on a copied older table's
+ * default view; `moved_from` says only where a view came from and designates nothing. A package
+ * kind (`grid`, `kanban`, …) is not a designation: picking Kanban writes `layout: "kanban"` onto
+ * the view, and a click must never take the layout chooser away.
+ */
+declare function designatedLayoutOf(definition: Record<string, unknown> | null | undefined): string | null;
+/**
+ * HOW THE TABLE OPENS, decided once from its default view and the layouts the host draws.
+ *
+ *   · `designated` — the default view names a host layout this host registered: the page opens
+ *     IN it and offers no other layout by default (the others sit in the page's one menu);
+ *   · `chooser`    — nothing designated (or the host does not draw what was designated): the
+ *     page opens on the view's own layout and shows the layout chooser.
+ *
+ * Only the DEFAULT view designates: a person who opens another saved view is choosing, and the
+ * chooser is theirs.
+ */
+type TableOpening = {
+    kind: "designated";
+    hostLayout: string;
+} | {
+    kind: "chooser";
+};
+declare function tableOpening(view: Pick<SavedView, "isDefault" | "designatedLayout"> | null | undefined, hostLayoutIds: readonly string[]): TableOpening;
+/**
+ * THE TABLE'S DEFAULT VIEW WHEN MORE THAN ONE SAYS IT IS (lane DATA-V2-FACE-2).
+ *
+ * Two views can both claim the default: the mover's designated one (the older table's own, the
+ * Sheet) and a page seed that a later move of the view bar's older store brings in beside it —
+ * both named "All records", so the store's name order cannot tell them apart. A designation is a
+ * deliberate write and a seed is not, so the designated default wins; then the first default.
+ */
+declare function defaultViewOf<V extends Pick<SavedView, "isDefault" | "designatedLayout">>(views: readonly V[]): V | undefined;
 /**
  * WHICH FIELD EACH LAYOUT CAN BE DRAWN FROM, decided from the FIELD'S OWN
  * DECLARATION and never from the values it happens to hold.
@@ -2249,6 +2360,13 @@ interface ViewSwitcherProps {
     /** "Who changed this?" from a grid cell — the host opens that column's timeline. */
     onAskWhoChanged?: ((fieldKey: string, recordId: Uuid) => void) | undefined;
     pageSize?: number | undefined;
+    /**
+     * THE TABLE'S OWN TITLE COLUMN (`title_field`, REC-2), from the table the host already holds.
+     * Every card is named by it (`cardTitleField`); the switcher never reads the table a second
+     * time to find it. Left out, a card is titled by a conventional name column, then the first
+     * text column — never a checkbox or the column the board is grouped by.
+     */
+    titleField?: string | null | undefined;
     /**
      * THE QUESTION THE ADDRESS ASKED, in the store's one filter shape — the same
      * object the chart counted with. It narrows the grid AND the board through
@@ -2295,7 +2413,7 @@ declare function useViewRecords(view: SavedViewSpec, pageSize?: number, filter?:
      */
     membership: string;
 };
-declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, onMoved, onNewRecordForm, onAskWhoChanged, pageSize, filter, hostLayout, onHostLayoutChange, chooser, openExport, className, }: ViewSwitcherProps): react.JSX.Element;
+declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, onMoved, onNewRecordForm, onAskWhoChanged, pageSize, titleField, filter, hostLayout, onHostLayoutChange, chooser, openExport, className, }: ViewSwitcherProps): react.JSX.Element;
 
 /** What the screen says above the list, so nobody has to be told twice that nothing was destroyed. */
 declare const ARCHIVE_MEANS = "Archiving never destroys anything. A record you remove from the grid waits here until somebody brings it back.";
@@ -2456,19 +2574,31 @@ declare function ProposalRow({ change, outcome, onApply, onReject, readOnlyReaso
 /** The three things that land in the queue, exactly as the door names them. */
 declare const ACTION_KINDS: readonly ["approval", "assignment", "proposal"];
 type ActionKind = WorkInboxKind;
+/** How the rows are gathered under headings. `g` cycles kind → table → none. */
+type InboxGrouping = "kind" | "table" | "none";
+declare const INBOX_GROUPINGS: readonly InboxGrouping[];
+interface InboxGroup {
+    key: string;
+    label: string | null;
+    items: WorkInboxItem[];
+}
+/** THE grouping, pure: the headings and, flattened, the order the keys walk. */
+declare function groupInbox(items: readonly WorkInboxItem[], by: InboxGrouping): InboxGroup[];
 interface ActionInboxProps {
     /**
-     * Narrow to one table's work. The door answers the organization; this filters
-     * the assignments to the table a person is looking at, and leaves approvals
-     * and proposals alone because those are about a change, not about a table.
+     * Narrow to one table's work. Every row now carries the table it is about
+     * (lane S5-PRIME), so this narrows approvals, proposals and assignments alike;
+     * when the table has nothing, the inbox says how many wait elsewhere and offers them.
      */
     tableId?: Uuid | null | undefined;
-    /** Show decided rows too. The default is what is still waiting. */
+    /** Show decided rows too, from the start. `h` (or the button) toggles it. */
     includeSettled?: boolean | undefined;
+    /** How the rows start out grouped. Default: by kind. */
+    defaultGroupBy?: InboxGrouping | undefined;
     onOpenRecord?: ((recordId: Uuid, tableId: Uuid) => void) | undefined;
     className?: string | undefined;
 }
-declare function ActionInbox({ tableId, includeSettled, onOpenRecord, className }: ActionInboxProps): react.JSX.Element;
+declare function ActionInbox({ tableId, includeSettled, defaultGroupBy, onOpenRecord, className, }: ActionInboxProps): react.JSX.Element;
 
 interface HistoryPanelProps {
     tableId: Uuid;
@@ -3563,9 +3693,17 @@ interface TablesHomeProps {
      * name it, the chips are absent rather than a row of "unknown".
      */
     organizationName?: string | null | undefined;
+    /**
+     * ONLY THE WAYS TO MAKE A TABLE — New table, Start from an example, and the import that
+     * follows — and none of the lists (lane UI-FIX-18, VERIFIER-18 M3). A host page that already
+     * lists the organization's tables, dashboards and booking pages (matrx-frontend's
+     * organization hub) passes this, so one page never draws two full lists of the same tables.
+     * Default false: the package's own home, lists and all.
+     */
+    makingOnly?: boolean | undefined;
     className?: string | undefined;
 }
-declare function TablesHome({ onOpenTable, organizationName, className }: TablesHomeProps): react.JSX.Element;
+declare function TablesHome({ onOpenTable, organizationName, makingOnly, className }: TablesHomeProps): react.JSX.Element;
 
 interface WhereItLivesProps {
     tableId: Uuid$1;
@@ -3580,8 +3718,11 @@ interface WhereItLivesProps {
         id: Uuid$1;
         name: string;
     }) => void) | undefined;
-    /** `row` is quieter, for a list; `header` for an object page. */
-    variant?: "header" | "row" | undefined;
+    /**
+     * `row` is quieter, for a list; `header` for an object page's own row; `title` rides the page
+     * header beside the object's name (Linear's team beside the issue title) — no frame, muted.
+     */
+    variant?: "header" | "row" | "title" | undefined;
 }
 declare function WhereItLives({ tableId, knownOrganizationName, onMoved, variant }: WhereItLivesProps): react.JSX.Element;
 
@@ -3719,6 +3860,20 @@ interface TablePageProps {
      * said out loud by the rail, never replaced by its first row.
      */
     activeItemId?: Uuid$1 | null | undefined;
+    /**
+     * What the HOST puts at the start of the table's one row — the organization the table lives
+     * in, named quietly (the app's where-it-lives chip). One row: never a second bar above it.
+     */
+    leading?: ReactNode | undefined;
+    /**
+     * What the HOST adds to the table's one menu — a capability the package cannot know about (the
+     * app's "When a row changes, run an agent…"). Drawn after the package's own entries.
+     */
+    menuExtras?: ReadonlyArray<{
+        key: string;
+        label: string;
+        onSelect: () => void;
+    }> | undefined;
     className?: string | undefined;
 }
 /**
@@ -3865,7 +4020,22 @@ declare function openingView(activeView: string | null | undefined, activeDashbo
     layout: ViewLayout | null;
     unknown: string | null;
 };
-declare function TablePage({ tableId, pageSize, seedViews, onLeave, leaveLabel, activeDashboardId, activeRecordId, activeView, onViewChanged, activeGroupField, cameFrom, filter, activeRail, activeItemId, className, }: TablePageProps): react.JSX.Element;
+/**
+ * EVERYTHING A TABLE CAN DO THAT IS NOT LOOKING AT IT — in the table's ONE menu (lane
+ * DATA-V2-FACE). They were fourteen buttons in a row above the records, which is a toolbar
+ * describing the platform rather than the table; the owner met it on his own table and asked
+ * whether somebody was copying Notion and failing. Groups: the records themselves, what is
+ * built on them, and bringing things in and out.
+ */
+interface MenuEntryDef {
+    key: string;
+    label: string;
+    press: SurfacePress;
+    group: 1 | 2 | 3;
+    shown: (rights: ReturnType<typeof useTableRights>) => boolean;
+}
+declare const TABLE_MENU: readonly MenuEntryDef[];
+declare function TablePage({ tableId, pageSize, seedViews, onLeave, leaveLabel, activeDashboardId, activeRecordId, activeView, onViewChanged, activeGroupField, cameFrom, filter, activeRail, activeItemId, leading, menuExtras, className, }: TablePageProps): react.JSX.Element;
 
 /** What the roster can tell us about a user id. `null` when it cannot. */
 type ResolveName = (userId: Uuid$1) => string | null;
@@ -3946,10 +4116,92 @@ declare function useCanShare(): boolean;
 declare function shareUnavailableReason(): string;
 declare function ShareControl({ kind, organizationId, subjectId, name, may, initiallyOpen, size, variant, className, }: ShareControlProps): ReactNode;
 
+/**
+ * 🚨 THE ONE DATE HELPER EVERY LAYOUT READS (lane UI-FIX-18, VERIFIER-18 H2 / M1).
+ *
+ * MEASURED 2026-09-24 on production, browser in America/Los_Angeles: Kitchen's start date,
+ * stored `2026-04-01`, read **Apr 1** in the grid, **Mar 31** on the calendar, **3/31** in
+ * the gallery, and Backyard Deck's May 1 read **4/30** in the record panel. The grid was right
+ * because it formats through the design system's registry (`formatFieldValue`), which reads a
+ * bare `YYYY-MM-DD` as a day on a calendar. Every other surface called `new Date("2026-04-01")`
+ * itself — which JavaScript parses as UTC MIDNIGHT — and then printed it in the viewer's zone,
+ * so everybody west of Greenwich saw the day before.
+ *
+ * THE CLASS, NOT THE INSTANCE. No component in this package parses or prints a date on its
+ * own any more; it asks this file, and this file asks the SAME registry the grid asks. The
+ * calendar's day key is the one thing the registry does not answer, and it is answered here
+ * by the same rule: a bare calendar date IS its own day (read the characters), an instant
+ * (`…Z`, `…+hh:mm`) is placed on the viewer's own calendar.
+ *
+ * The store's own stamps — Created time and Last changed time (`fx.created_time`,
+ * `fx.modified_time`) — are instants, and are printed like every other date-and-time cell
+ * (VERIFIER-18 M1 found `2026-09-25T00:13:34.564Z` in the grid, the gallery and the panel).
+ */
+
+/**
+ * Does this value (or, with no value, this Field) carry a TIME OF DAY as well as a date?
+ *
+ * A DATE IS A DATE (chair ruling, 2026-09-24). The control and the text follow the STORED
+ * VALUE's shape, never `config.kind` alone: a value with no time part — `1988-06-14`, a date
+ * of birth on a `kind: "datetime"` Field — gets a date-only control and a date-only reading
+ * everywhere (grid, form, panel, calendar). With no value yet, only a Field that says so
+ * outright carries a time: the older `format: "datetime"`, or the store's own Created / Last
+ * changed stamps (instants by construction).
+ */
+declare function carriesTimeOfDay(field: Pick<Field, "type" | "config" | "format">, value?: unknown): boolean;
+/** A value that names a moment in the day, not just the day. */
+declare function hasTimePart(value: unknown): boolean;
+/** Is this Field a date column at all — a dated range, or the store's own time stamp? */
+declare function isDateField(field: Pick<Field, "type" | "config">): boolean;
+/**
+ * The format a date-ish Field draws with, or `undefined` for a Field that is not one. With a
+ * value, it is that value's own shape; without, the Field's (`carriesTimeOfDay`).
+ * `presentation.formatForField` answers dates through this, so the grid and every card agree.
+ */
+declare function dateFormatFor(field: Pick<Field, "type" | "config" | "format">, value?: unknown): FieldFormatConfig | undefined;
+/**
+ * THE TEXT OF ONE DATE VALUE, in the viewer's language — through the design system's
+ * registry, exactly as the grid prints it, in the value's own shape. `null` when the value is
+ * not a date at all, so the caller can fall back to its own reading (THE FALLBACK LAW).
+ */
+declare function dateText(field: Pick<Field, "type" | "config" | "format">, value: unknown): string | null;
+/**
+ * THE CALENDAR DAY a value falls on, as `YYYY-MM-DD` — the key a calendar files a card under.
+ *
+ * A bare calendar date is its own day. An instant is placed on the VIEWER's calendar: a visit
+ * logged at 5:13 PM Pacific on 24 September is on the 24th for the person in Pacific time,
+ * even though it is already the 25th in UTC.
+ */
+declare function calendarDayOf(value: unknown): string | null;
+/** The heading of one calendar day — `Apr 1, 2026` — built on local midnight, never UTC. */
+declare function calendarDayLabel(day: string): string;
+
+/** The word a withheld cell shows in place of a value. Never "—", which means empty. */
+declare const WITHHELD_WORD = "Withheld";
+type Hidden = Readonly<Record<string, HiddenFieldNotice | undefined>> | null | undefined;
+/** The store's notice for this column of this row, when the store withheld it. */
+declare function withheldNoticeOf(hidden: Hidden, key: string): HiddenFieldNotice | null;
+/**
+ * THE SENTENCE, in the store's own words: the notice's `says` when the store wrote one (a
+ * worked-out column names what it reads), else the notice's reason, the level it needs and the
+ * other way in.
+ */
+declare function withheldSentence(field: Pick<Field, "key" | "label" | "name">, notice: HiddenFieldNotice): string;
+/** A withheld cell as a person reads it: the word, with the store's reason on hover. */
+declare function WithheldValue({ field, notice }: {
+    field: Field;
+    notice: HiddenFieldNotice;
+}): react.JSX.Element;
+
 interface PipelineBoardProps {
     tableId: Uuid;
     /** The rows the view holds — the SAME rows every other layout of this view draws. */
     rows: ReadRow$1[];
+    /**
+     * The table's own title column (`title_field`), from the table the host already holds — each
+     * card is named by it through `cardTitleField`. The board never reads the table again for it.
+     */
+    titleKey?: string | null | undefined;
     /** A number column to total under each heading. The person picks it; nothing is guessed. */
     measure?: string | null;
     /**
@@ -3971,6 +4223,6 @@ interface PipelineBoardProps {
     style?: TableStyle | undefined;
     className?: string | undefined;
 }
-declare function PipelineBoard({ tableId, rows, measure, filter, onMeasureChange, onOpenRecord, onMoved, style, className, }: PipelineBoardProps): react.JSX.Element;
+declare function PipelineBoard({ tableId, rows, titleKey, measure, filter, onMeasureChange, onOpenRecord, onMoved, style, className, }: PipelineBoardProps): react.JSX.Element;
 
-export { ABSENCE_WORD_LABEL, ABSENCE_WORD_VALUES, ACTION_KINDS, ARCHIVED_NEVER_DESTROYED, ARCHIVE_MEANS, type AbsenceWord, ActionInbox, type ActionInboxProps, type ActionKind, type AgentBuildAsk, ArchivedDisclosure, type ArchivedDisclosureProps, ArchivedPortals, type ArchivedPortalsProps, ArchivedView, type ArchivedViewProps, BOOKING_NOT_HERE_LINE, BOOKING_PAGE_STATE_LABEL, BOOKING_PAGE_STATE_VALUES, BookingBuilder, type BookingBuilderProps, type BookingPageState, BookingSlots, type BookingSlotsProps, BuildOrAsk, type BuildOrAskProps, type BuildableKind, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_REQUIREMENT_KINDS, CHECKLIST_REQUIREMENT_LABEL, CONDITION_OPS, CONTEXT_POLICY_LABEL, type Capability, type CaptureMode, type CaptureQueuePort, CaptureRun, type CaptureRunProps, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartConfig, ChartFrame, type ChartKind, ChartLegendContent, type ChartSpec, ChartTooltipContent, ChecklistRunner, type ChecklistRunnerProps, ChecklistTemplateEditor, ChecklistsPanel, type ChecklistsPanelProps, CommentThread, type CommentThreadProps, type ConditionField, ConditionGroup, type ConditionGroupProps, ConditionRow, type ConditionRowProps, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_VIEW_NAME, DUE_STATE_LABEL, DashboardCanvas, type DashboardCanvasProps, DigestScheduler, type DigestSchedulerProps, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, ENGINEER_TEXT, ENTITY_REFERENCE_KINDS_MISSING, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, EnrichBadge, type EnrichBadgeProps, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, EntityReferenceKindPicker, type EntityReferenceKindPickerProps, ExportMenu, type ExportMenuProps, FIELD_RULE_KIND_LABEL, FIELD_RULE_KIND_VALUES, FIELD_SENSITIVITY_LABEL, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORMULA_OP_JOINS, FORMULA_OP_LABEL, FORMULA_OP_VALUES, FORM_FLOWS, FORM_NOT_HERE_LINE, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldHistoryPanel, type FieldHistoryPanelProps, FieldLabel, type FieldProposalRow, type FieldRuleKindValue, type FieldTypeChoice, FilePicker, type FilePickerProps, type FormAsked, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, type FormulaOp, Grid, GridCell, type GridEditing, type GridGrouping, type GridPresentation, type GridProps, HistoryPanel, type HistoryPanelProps, type HostLayout, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, type LabelLookup, type LinkRail, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, type MainView, MyChecklistSteps, NEEDS_A_SENTENCE, NOT_ANSWERED_YET, NOT_DRAWN_HERE, NO_AGENT_PORT, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_RULES_YET, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PAGE_VIEWS, PAGE_VIEW_LABEL, PARITY_LABEL, PARITY_MADE_OF, PORTAL_NOT_HERE_LINE, PROPOSED_CHANGE_ACT_LABEL, PROPOSED_CHANGE_ACT_VALUES, type PageView, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalBuilder, type PortalBuilderProps, PortalCardView, type PortalCardViewProps, PortalLookEditor, type PortalLookEditorProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, type ProposedChangeAct, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, ROLLUP_AGG_LABEL, ROLLUP_AGG_VALUES, RULE_NOT_HERE_LINE, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, ReferenceBuilder, type ReferenceBuilderProps, type ReferenceChoice, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, type ResolveName, type RollupAgg, SAVED_VIEWS_UNAVAILABLE, SAY_WHAT_YOU_ARE_WAITING_FOR_AFTER_MS, SECTIONS_UNKNOWN, SERIES_COLORS, SHARE_NOT_YOURS_LINE, SOMEBODY, STAGE_RULE_ON_FAIL_LABEL, STORE_ANSWERS_THESE, STORE_DECIDES_REASON, SUBSCRIPTION_CADENCES, SUBSCRIPTION_CADENCE_LABEL, SUBSCRIPTION_CHANNEL_LABEL, SUBSCRIPTION_CHANNEL_VALUES, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, StageRulesSection, type StageRulesSectionProps, StepRow, type SubscriptionChannel, SubscriptionsPanel, type SubscriptionsPanelProps, type Surface, type SurfacePress, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, THE_SYSTEM, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_KEYS, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VISIBILITY_LANES, VISIBILITY_LANE_TITLE, ViewBar, type ViewBarProps, type ViewKeyDeclaration, type ViewKeyLayout, type ViewKeyWriter, type ViewLayout, type ViewSettings, type ViewSettingsPatch, type ViewSort, type ViewSortKey, ViewSwitcher, type ViewSwitcherProps, type VisibilityLane, WITHHELD_RECORD_LABEL, WORK_DUE_STATES, WORK_INBOX_KINDS, WORK_INBOX_KIND_LABEL, type WhatYouMayDo, WhereItLives, type WhereItLivesProps, type WhoChanged, WhoChangedSource, actorBadge, actorWords, archivedRowLine, asRefusal, askableFields, blockFromSpec, bodyForReading, bodyFromKeys, cameFromLine, cellState, chooseSurface, colorFromTheValue, columnForField, conditionInWords, conditionIsDrawable, conditionIsSimple, conditionValue, controlFor, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, declareView, editorKindFor, ensureSystemTable, entityReferenceSpec, envelopeFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupLabel, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isEngineerText, isId, isMachineIdentity, isParityFieldType, isPlainFieldType, isRelationFieldType, isSignatureField, keptByTheApp, keyFor, kindsWithNoChoice, laneFor, lastChangeSentence, looksLikeId, machineIdentityIn, mayNotRestoreLine, memberName, nextInWords, nextSummaryAt, openingRail, openingView, pageViewFromParam, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, previewWords, publiclyAnswerable, railFromParam, recordName, recordNameIn, recordsDataSource, refusal, refusalForAPerson, refusalFromThrown, refusalLineForAPerson, refusalOr, renderValue, revokeConsequence, rowName, rowNameIn, saveViewPatch, scalarText, seedIsSatisfied, shareUnavailableReason, specFromBlock, storeDecidesRights, submissionStamp, surfaceChosen, tableName, tableRightsAt, unknownRailLine, unknownViewLine, useCanShare, useEmbedHandshake, useEnrichCells, useGridEditing, useLabelWait, useMeasuredWidth, useMyChecklistSteps, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, useWhoChanged, viewDocument, viewFromRow, viewKeysFor, viewPatchDocument, viewSettings, viewSettingsFor, viewSettingsPatch, visibilityLaneFor, whatIsMissing, whatIsMissingForEntityReference, whatYouMayDo, whatYouMayDoWithTable, whenWords, whyNotAskable };
+export { ABSENCE_WORD_LABEL, ABSENCE_WORD_VALUES, ACTION_KINDS, ARCHIVED_NEVER_DESTROYED, ARCHIVE_MEANS, type AbsenceWord, ActionInbox, type ActionInboxProps, type ActionKind, type AgentBuildAsk, ArchivedDisclosure, type ArchivedDisclosureProps, ArchivedPortals, type ArchivedPortalsProps, ArchivedView, type ArchivedViewProps, BOOKING_NOT_HERE_LINE, BOOKING_PAGE_STATE_LABEL, BOOKING_PAGE_STATE_VALUES, BookingBuilder, type BookingBuilderProps, type BookingPageState, BookingSlots, type BookingSlotsProps, BuildOrAsk, type BuildOrAskProps, type BuildableKind, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_REQUIREMENT_KINDS, CHECKLIST_REQUIREMENT_LABEL, CONDITION_OPS, CONTEXT_POLICY_LABEL, type Capability, type CaptureMode, type CaptureQueuePort, CaptureRun, type CaptureRunProps, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartConfig, ChartFrame, type ChartKind, ChartLegendContent, type ChartSpec, ChartTooltipContent, ChecklistRunner, type ChecklistRunnerProps, ChecklistTemplateEditor, ChecklistsPanel, type ChecklistsPanelProps, CommentThread, type CommentThreadProps, type ConditionField, ConditionGroup, type ConditionGroupProps, ConditionRow, type ConditionRowProps, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_VIEW_NAME, DUE_STATE_LABEL, DashboardCanvas, type DashboardCanvasProps, DigestScheduler, type DigestSchedulerProps, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, ENGINEER_TEXT, ENTITY_REFERENCE_KINDS_MISSING, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, EnrichBadge, type EnrichBadgeProps, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, EntityReferenceKindPicker, type EntityReferenceKindPickerProps, ExportMenu, type ExportMenuProps, FIELD_RULE_KIND_LABEL, FIELD_RULE_KIND_VALUES, FIELD_SENSITIVITY_LABEL, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORMULA_OP_JOINS, FORMULA_OP_LABEL, FORMULA_OP_VALUES, FORM_FLOWS, FORM_NOT_HERE_LINE, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldHistoryPanel, type FieldHistoryPanelProps, FieldLabel, type FieldProposalRow, type FieldRuleKindValue, type FieldTypeChoice, FilePicker, type FilePickerProps, type FormAsked, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, type FormulaOp, Grid, GridCell, type GridEditing, type GridGrouping, type GridPresentation, type GridProps, HistoryPanel, type HistoryPanelProps, type HostLayout, INBOX_GROUPINGS, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, type InboxGroup, type InboxGrouping, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, type LabelLookup, type LinkRail, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, type MainView, MyChecklistSteps, NEEDS_A_SENTENCE, NOT_ANSWERED_YET, NOT_DRAWN_HERE, NO_AGENT_PORT, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_RULES_YET, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PAGE_VIEWS, PAGE_VIEW_LABEL, PARITY_LABEL, PARITY_MADE_OF, PORTAL_NOT_HERE_LINE, PROPOSED_CHANGE_ACT_LABEL, PROPOSED_CHANGE_ACT_VALUES, type PageView, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalBuilder, type PortalBuilderProps, PortalCardView, type PortalCardViewProps, PortalLookEditor, type PortalLookEditorProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, type ProposedChangeAct, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, ROLLUP_AGG_LABEL, ROLLUP_AGG_VALUES, RULE_NOT_HERE_LINE, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, ReferenceBuilder, type ReferenceBuilderProps, type ReferenceChoice, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, type ResolveName, type RollupAgg, SAVED_VIEWS_UNAVAILABLE, SAY_WHAT_YOU_ARE_WAITING_FOR_AFTER_MS, SECTIONS_UNKNOWN, SERIES_COLORS, SHARE_NOT_YOURS_LINE, SOMEBODY, STAGE_RULE_ON_FAIL_LABEL, STORE_ANSWERS_THESE, STORE_DECIDES_REASON, SUBSCRIPTION_CADENCES, SUBSCRIPTION_CADENCE_LABEL, SUBSCRIPTION_CHANNEL_LABEL, SUBSCRIPTION_CHANNEL_VALUES, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, StageRulesSection, type StageRulesSectionProps, StepRow, type SubscriptionChannel, SubscriptionsPanel, type SubscriptionsPanelProps, type Surface, type SurfacePress, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_MENU, TABLE_NOT_REACHABLE, THE_SYSTEM, type TableLane, type TableOpening, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_KEYS, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VISIBILITY_LANES, VISIBILITY_LANE_TITLE, ViewBar, type ViewBarProps, type ViewKeyDeclaration, type ViewKeyLayout, type ViewKeyWriter, type ViewLayout, type ViewSettings, type ViewSettingsPatch, type ViewSort, type ViewSortKey, ViewSwitcher, type ViewSwitcherProps, type VisibilityLane, WITHHELD_RECORD_LABEL, WITHHELD_WORD, WORK_APPROVAL_STATES, WORK_APPROVAL_STATE_LABEL, WORK_DUE_STATES, WORK_INBOX_KINDS, WORK_INBOX_KIND_GROUP_LABEL, WORK_INBOX_KIND_LABEL, type WhatYouMayDo, WhereItLives, type WhereItLivesProps, type WhoChanged, WhoChangedSource, WithheldValue, actorBadge, actorWords, archivedRowLine, asRefusal, askableFields, blockFromSpec, bodyForReading, bodyFromKeys, calendarDayLabel, calendarDayOf, cameFromLine, cardTitleField, cardWords, carriesTimeOfDay, cellState, chooseSurface, colorFromTheValue, columnForField, conditionInWords, conditionIsDrawable, conditionIsSimple, conditionValue, controlFor, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, dateFormatFor, dateText, declareView, defaultViewOf, designatedLayoutOf, editorKindFor, ensureSystemTable, entityReferenceSpec, envelopeFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupInbox, groupLabel, hasTimePart, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isDateField, isEngineerText, isId, isMachineIdentity, isParityFieldType, isPlainFieldType, isRelationFieldType, isSignatureField, keptByTheApp, keyFor, kindsWithNoChoice, laneFor, lastChangeSentence, looksLikeId, machineIdentityIn, mayNotRestoreLine, memberName, nextInWords, nextSummaryAt, openingRail, openingView, pageViewFromParam, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, previewWords, publiclyAnswerable, railFromParam, recordName, recordNameIn, recordsDataSource, refusal, refusalForAPerson, refusalFromThrown, refusalLineForAPerson, refusalOr, renderValue, resolveTableStyle, revokeConsequence, rowName, rowNameIn, saveViewPatch, scalarText, seedIsSatisfied, shareUnavailableReason, specFromBlock, storeDecidesRights, styleFromDecorations, submissionStamp, surfaceChosen, tableName, tableOpening, tableRightsAt, unknownRailLine, unknownViewLine, useCanShare, useEmbedHandshake, useEnrichCells, useGridEditing, useLabelWait, useMeasuredWidth, useMyChecklistSteps, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, useWhoChanged, viewDocument, viewFromRow, viewKeysFor, viewPatchDocument, viewSettings, viewSettingsFor, viewSettingsPatch, visibilityLaneFor, whatIsMissing, whatIsMissingForEntityReference, whatYouMayDo, whatYouMayDoWithTable, whenWords, whyNotAskable, withheldNoticeOf, withheldSentence };