@ai-matrx/records-ui 0.30.0 → 0.40.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import * as react from 'react';
 import { ReactNode, ComponentType, RefObject } from 'react';
-import { PermissionLevel, Table, Uuid as Uuid$1, AggregateFilter, RecordsError, Field, RecordDocument, ReadRow, WriteConflict, ParityFieldType, NewFieldDeclaration, ValueEnvelope, WorkInboxKind, RuleExpression, FormSummary, PortalCard, PortalPrincipal, PortalPreviewRow, DashboardBlockKind, AggregateBucket, AggregateMeasure, DashboardBlock, DashboardSummary, DocTemplateRow, DocRenderRow, DashboardBlockResult, AnonTokenBinding, RecordsConfig, RecordsActor, RecordsDataSource, FieldTypeWord } from '@ai-matrx/records';
+import * as _ai_matrx_records from '@ai-matrx/records';
+import { PermissionLevel, Table, RecordScopeContext, EnrichCell, RecordsError, Uuid as Uuid$1, AggregateFilter, Field, RecordDocument, ReadRow, WriteConflict, ParityFieldType, NewFieldDeclaration, ValueEnvelope, WorkInboxKind, RuleExpression, FormSummary, PortalCard, PortalPrincipal, PortalPreviewRow, DashboardBlockKind, AggregateBucket, AggregateMeasure, DashboardBlock, DashboardSummary, DocTemplateRow, DocRenderRow, QuietHours, DashboardBlockResult, CaptureSheetFace, CaptureField, AnonTokenBinding, RecordsConfig, RecordsActor, RecordsDataSource, FieldTypeWord } from '@ai-matrx/records';
 import { Uuid, Field as Field$1, ReadRow as ReadRow$1 } from '@ai-matrx/records/react';
 import { RecordsClient } from '@ai-matrx/records/core';
 import { FieldFormatConfig } from '@ai-matrx/design-system/field-formats';
@@ -52,13 +53,34 @@ interface RecordChatEntry {
     label: string;
     /** `text` for a scalar, `json` for a structure. The host maps this to its own vocabulary. */
     type: "text" | "json";
+    /**
+     * DYN: a merge field resolves to a TRIPLE, not a string. The prompt gets the
+     * rendered value; the RUN gets this, and it is the only thing a "where did
+     * that come from" question can be answered from — so a host can turn a cited
+     * answer into a link to the record AND to the version it was read at.
+     */
+    cite?: {
+        record_id: Uuid;
+        field_id: Uuid;
+        value_version: number;
+        written_at: string | null;
+    };
 }
-/** A Field the STORE masked for this reader, named rather than silently dropped. */
+/** A Field the agent was NOT given, named rather than silently dropped. */
 interface RecordChatWithheld {
     key: string;
     label: string;
     /** The store's own reason. */
     reason: string;
+    /**
+     * WHICH ABSENCE THIS IS. `masked` — the store kept it from THIS READER.
+     * `policy` — the organization keeps it out of conversations, and the same
+     * person can read it on the record two inches away. A screen that collapsed
+     * the two would tell somebody the wrong thing about their own access.
+     */
+    because?: "masked" | "policy";
+    /** The whole sentence, already written. A screen prints it; it composes nothing. */
+    says?: string;
 }
 /** Everything the host's chat surface needs, and nothing about how it should look. */
 interface RecordChatContext {
@@ -73,10 +95,18 @@ interface RecordChatContext {
     tableName: string;
     /** The record's own title, for the panel's one-row header and the chip. */
     title: string;
+    /** What the scope chip says: `About: Acme Industrial`. */
+    chip: string;
     /** The grounding, already read through the read door. */
     entries: RecordChatEntry[];
     /** What this reader is NOT being given, with the store's reason for each. */
     withheld: RecordChatWithheld[];
+    /** Questions derived from THIS record's shape. Never a fixed list. */
+    suggested: string[];
+    /** One sentence naming what is not in the conversation. Printed verbatim. */
+    says: string;
+    /** The whole door answer, for a host that wants the history or the relations. */
+    scope: RecordScopeContext;
 }
 declare const NO_CHAT_REASON: string;
 interface RecordChatProps {
@@ -86,29 +116,73 @@ interface RecordChatProps {
 }
 declare function RecordChat({ tableId, recordId, className }: RecordChatProps): react.JSX.Element;
 
-/** What the host is asked to have the server's `records` tool do. */
+/** What the host is asked to have the SERVER's `records` tool do. */
 interface EnrichAsk {
     tableId: Uuid;
-    recordId: Uuid;
-    /** The agent Fields to refill, each with why this panel thinks it is due. */
-    fields: Array<{
-        key: string;
-        label: string;
-        because: string;
-    }>;
+    fieldId: Uuid;
+    fieldKey: string;
+    /** How many records this run covers. */
+    rows: number;
+    /** True: ask the model and report what it WOULD write, writing nothing. */
+    previewOnly: boolean;
 }
 interface EnrichOutcome {
     ok: boolean;
     /** What happened, in a sentence — the server's own words when it has some. */
     message: string;
+    /** For a preview: what would go in each cell. */
+    wouldWrite?: Array<{
+        record_id: string;
+        value?: unknown;
+        absent?: string;
+        says?: string;
+    }>;
 }
 declare const NO_ENRICH_REASON: string;
+/** Which of the four things this cell is. One place, so nothing can disagree. */
+declare function cellState(cell: EnrichCell | undefined): "none" | "agent" | "yours" | "unsure";
+interface EnrichBadgeProps {
+    cell: EnrichCell | undefined;
+    /** Bound when this person may change the record; absent, no pin control is drawn. */
+    onPin?: ((pinned: boolean) => void | Promise<void>) | undefined;
+    className?: string | undefined;
+}
+/**
+ * THE BADGE. Drawn beside every agent-owned value, always.
+ *
+ * The word on it is the state; `stale` rides along as a second, smaller word rather than a
+ * colour, because "this is six weeks old" is a sentence and not a hue — a person reading a
+ * red cell has to be told what red means, and then told again next week.
+ */
+declare function EnrichBadge({ cell, onPin, className }: EnrichBadgeProps): react.JSX.Element | null;
+/**
+ * Every badge on a page of a grid, in ONE round trip.
+ *
+ * A badge asked per cell is one round trip per badge — fifty round trips to draw fifty
+ * badges, which is why the store answers the whole page at once. The hook is keyed by the
+ * record ids the grid is actually drawing, so paging re-asks and scrolling does not.
+ */
+declare function useEnrichCells(tableId: Uuid | undefined, recordIds: Uuid[] | undefined): {
+    cells: Map<string, EnrichCell>;
+    refresh: () => Promise<void>;
+    error: RecordsError | null;
+};
 interface EnrichPanelProps {
     tableId: Uuid;
-    recordId: Uuid;
+    /** Open straight onto one column. Absent, the panel lists every agent-owned column. */
+    fieldId?: Uuid | undefined;
     className?: string | undefined;
 }
-declare function EnrichPanel({ tableId, recordId, className }: EnrichPanelProps): react.JSX.Element;
+/**
+ * THE PANEL — the whole of an enrichment in one screen, in a person's own words.
+ *
+ * It is deliberately NOT a settings form with a Save button at the bottom. The order is the
+ * order somebody actually thinks in: what should go in this column · what it may look at ·
+ * how often to check it again · what it has cost so far · SEE IT ON FIVE ROWS · and only
+ * then, turn it on. The preview is not a nicety: it is the only honest way to find out what
+ * a model will write into other people's data before it writes it.
+ */
+declare function EnrichPanel({ tableId, fieldId, className }: EnrichPanelProps): react.JSX.Element;
 
 /**
  * What a person may do to one table. The four words and the ladder are the
@@ -229,6 +303,26 @@ interface RecordsUiHost {
      * nowhere.
      */
     chat?: (context: RecordChatContext) => ReactNode;
+    /**
+     * OPTIONAL. "TALK TO THIS RECORD" — the HOST opens its own one chat surface
+     * (AGT-N-9, PRODUCTS row 11).
+     *
+     * `chat` is the port that RENDERS a chat inside a panel this package draws.
+     * This one is the other direction: a menu entry in the grid, the cell menu or
+     * the record header says "the person wants to talk about this record", and the
+     * host opens the chat where the host puts chats — full height, the platform's
+     * own pattern — and binds the conversation to the record through
+     * `conversationScopeBind`. Drawing a chat next to a grid row from inside this
+     * package would be the parallel layer the canvas ruling forbids.
+     *
+     * ABSENT, NEVER DEAD: where neither this nor `chat` is bound, the entries do
+     * not render at all.
+     */
+    talkToRecord?: (target: {
+        tableId: Uuid$1;
+        recordId: Uuid$1;
+        title: string;
+    }) => void;
     /**
      * OPTIONAL. THE SERVER'S `records` TOOL (SCR-27).
      *
@@ -592,10 +686,20 @@ declare function useGridEditing({ tableId, fields, rows, reload, canWrite, mayWr
  * `data-matrx-cell-control` is the data table's own opt-out from whole-row
  * click, so opening a cell never also opens the record panel behind it.
  */
-declare function GridCell({ field, row, editing, canWrite, whyNot, format, }: {
+declare function GridCell({ field, row, editing, canWrite, whyNot, format, onAskWhoChanged, }: {
     field: Field;
     row: ReadRow;
-    editing: GridEditing;
+    /**
+     * The edit session, or NULL on a cell nobody may edit.
+     *
+     * 🚨 Null is not "do not render me". "Who changed this?" is a READING
+     * question — the person who may not edit a cell is exactly the person who
+     * wants to know who did — and the cell used to disappear entirely the moment
+     * editing was off, taking the control with it while this file's own comments
+     * claimed it was offered at viewer. A null session means no editor, nothing
+     * else.
+     */
+    editing: GridEditing | null;
     /** Whether this person may write THIS row. Asked before the cell is drawn. */
     canWrite: boolean;
     /**
@@ -606,6 +710,12 @@ declare function GridCell({ field, row, editing, canWrite, whyNot, format, }: {
     whyNot?: string | undefined;
     /** The column's declared format, so the read view reads like its header. */
     format?: FieldFormatConfig | undefined;
+    /**
+     * "WHO CHANGED THIS?" — the question a person asks of the CELL they are
+     * looking at. Bound by the host; absent, no control is drawn at all, because
+     * a control that opens nothing is the thing this package exists to prevent.
+     */
+    onAskWhoChanged?: ((fieldKey: string, recordId: Uuid$1) => void) | undefined;
 }): react.JSX.Element;
 
 /**
@@ -762,6 +872,15 @@ interface GridProps {
     onOpenRecord?: ((recordId: Uuid) => void) | undefined;
     /** SCR-2. Called when an admin clicks the "+" at the end of the headers. */
     onAddField?: (() => void) | undefined;
+    /**
+     * "WHO CHANGED THIS?" — from the cell, about that column, on that record.
+     *
+     * The question people actually ask is about a CELL they are looking at, not
+     * about a record they then have to open. The store answers it
+     * (`custom.field_history`), and the host decides where the answer appears —
+     * a side panel, a window, a route. Unbound, the control is ABSENT, not dead.
+     */
+    onAskWhoChanged?: ((fieldKey: string, recordId: Uuid) => void) | undefined;
     /**
      * The host's whole-record form. Offered BY NAME when the store refuses an
      * empty record — a Table with a required Field cannot be added to one cell at
@@ -802,7 +921,7 @@ interface GridProps {
     onPresentationChange?: ((next: GridPresentation) => void) | undefined;
     className?: string | undefined;
 }
-declare function Grid({ tableId, pageSize, onOpenRecord, onAddField, onNewRecordForm, toolbarActions, editable, presentation, onPresentationChange, className, }: GridProps): react.JSX.Element;
+declare function Grid({ tableId, pageSize, onOpenRecord, onAddField, onNewRecordForm, toolbarActions, editable, presentation, onPresentationChange, className, onAskWhoChanged, }: GridProps): react.JSX.Element;
 /**
  * One Field becomes one column. The header is the Field's own NAME — never its
  * key (`names.ts`) — and the cell is the value, rendered by its parity type and
@@ -811,6 +930,18 @@ declare function Grid({ tableId, pageSize, onOpenRecord, onAddField, onNewRecord
 declare function columnForField(field: Field$1, editing?: GridEditing | null, mayWriteRow?: (rowId: Uuid) => boolean, whyNotRow?: (rowId: Uuid) => string, look?: {
     format?: FieldFormatConfig;
     frozen?: boolean;
+}, 
+/** "Who changed this?" from the cell's own menu. Absent, no control is drawn. */
+onAskWhoChanged?: ((fieldKey: string, recordId: Uuid) => void) | undefined, 
+/**
+ * PRODUCTS row 10 — the provenance of a cell a MODEL owns. `cellFor` answers the page's
+ * already-fetched badge data for one row; `onPin` is bound only where this person may
+ * change the record, so a viewer reads every badge and is offered no control they do not
+ * have. Absent entirely, no badge is drawn and the column looks exactly as it did.
+ */
+enrich?: {
+    cellFor: (recordId: Uuid) => _ai_matrx_records.EnrichCell | undefined;
+    onPin?: ((recordId: Uuid, fieldKey: string, pinned: boolean) => void | Promise<void>) | undefined;
 }): MatrxColumnDef<ReadRow$1>;
 
 interface ExportMenuProps {
@@ -825,12 +956,10 @@ declare function ExportMenu({ tableId, rows, label, className }: ExportMenuProps
 
 interface ImportWizardProps {
     tableId: Uuid;
-    /** SCR-N-7: what "add this as a field" does. Absent means the offer is not made. */
-    onProposeField?: ((header: string) => void) | undefined;
     onDone?: ((written: number) => void) | undefined;
     className?: string | undefined;
 }
-declare function ImportWizard({ tableId, onProposeField, onDone, className }: ImportWizardProps): react.JSX.Element;
+declare function ImportWizard({ tableId, onDone, className }: ImportWizardProps): react.JSX.Element;
 
 interface CustomFieldsSectionProps {
     /** The standard table's registered token (REC-33), e.g. `party`, `crm_deal`. */
@@ -845,15 +974,33 @@ declare function CustomFieldsSection({ entityToken, recordId, title, className,
 
 /** The three behaviours that carry no parity type of their own. */
 type PlainFieldType = "text" | "long_text" | "number";
-/** What a person picks in the panel: one of the thirteen, or one of the three. */
-type PickableFieldType = ParityFieldType | PlainFieldType;
+/**
+ * THE ONE A PERSON COMING FROM AIRTABLE REACHES FOR FIRST, AND IT WAS NOT HERE.
+ *
+ * The list above offered `member` (a Person) and `attachment` (a File) — the two
+ * relations whose target is a Table the PLATFORM keeps — and nothing at all for
+ * "this job belongs to that customer". The store has taken it since 2026-09-20
+ * (`custom.field_declare` with `type: "relation"` and a `relation_target`), the
+ * Field type has named it since the same day, and `editorKindFor` has answered
+ * `"relation"` for one since long before that. Only the menu did not offer it,
+ * so the guide's section 3 told a person to pick a kind that did not exist.
+ *
+ * It is NOT a fourteenth parity type. `custom.parity_field_types()` ships
+ * thirteen and a relation is a BEHAVIOUR — the same behaviour `member` and
+ * `attachment` are made of — so it sits beside the three plain ones as its own
+ * word, and `parityTypesWithNoExplanation()` is unaffected by it in both
+ * directions: it does not appear there, and it cannot hide a real gap there.
+ */
+type RelationFieldType = "relation";
+/** What a person picks in the panel: one of the thirteen, one of the three, or a link. */
+type PickableFieldType = ParityFieldType | PlainFieldType | RelationFieldType;
 interface FieldTypeChoice {
     id: PickableFieldType;
     /** The word on the menu. */
     label: string;
     /** One line, under the word, saying what it is FOR. Never what it is made of. */
     explanation: string;
-    /** The heading it sits under, so sixteen choices read as four short lists. */
+    /** The heading it sits under, so seventeen choices read as four short lists. */
     group: "Words" | "Numbers and dates" | "Choices and people" | "Worked out";
 }
 declare const FIELD_TYPE_CHOICES: FieldTypeChoice[];
@@ -861,12 +1008,23 @@ declare const FIELD_TYPE_GROUPS: FieldTypeChoice["group"][];
 declare function fieldTypeChoice(id: string): FieldTypeChoice | undefined;
 /** The three that are a plain behaviour rather than one of the thirteen. */
 declare function isPlainFieldType(id: string): id is PlainFieldType;
+/**
+ * The one that is a relation a person aims themselves. It is neither plain nor
+ * one of the thirteen, so every caller that branched on `isPlainFieldType`
+ * alone has to answer this question too — which is why it is a named function
+ * and not an inline string comparison at four call sites.
+ */
+declare function isRelationFieldType(id: string): id is RelationFieldType;
 /**
  * THE GUARD THIS FILE NEEDS, because the list it explains is generated.
  *
  * Returns the parity types the store ships that nothing here explains. The
  * suite asserts it is empty; a fourteenth type would otherwise reach the menu
  * with a blank line under it and nobody would notice until a person did.
+ *
+ * `relation` is deliberately NOT one of the thirteen and therefore never
+ * appears in this answer: `PARITY_FIELD_TYPES` is the store's own generated
+ * list and a behaviour that carries no parity type is not in it.
  */
 declare function parityTypesWithNoExplanation(): string[];
 
@@ -905,6 +1063,8 @@ declare function whatIsMissing(state: {
     of: string;
     relations: Field[];
     formulaFields: string[];
+    /** Only a link asks for one, so a caller about any other kind leaves it out. */
+    relationTarget?: string;
 }): string | null;
 
 interface FieldProposalRow {
@@ -1170,6 +1330,12 @@ interface SavedViewSpec {
     layout: ViewLayout;
     /** Kanban: the Field whose value becomes a column. */
     groupField?: string | null;
+    /**
+     * Kanban: a number Field to TOTAL under each column heading. It lives on the VIEW for
+     * the same reason the colours do — two people read one board two ways and neither
+     * reading is a fact about the records.
+     */
+    measure?: string | null;
     /** Calendar: the Field that places a record in the month. */
     dateField?: string | null;
     /** Gallery: the Field shown large on the card. */
@@ -1250,8 +1416,16 @@ interface ViewSwitcherProps {
      */
     onViewChange?: ((patch: Partial<SavedViewSpec>) => void) | undefined;
     onOpenRecord?: ((recordId: Uuid) => void) | undefined;
+    /**
+     * Called after a card moves between columns, so the host re-reads the rows it owns. A
+     * board that moved a card and left the row list alone would show the card in two places
+     * until something else happened to reload.
+     */
+    onMoved?: (() => void) | undefined;
     /** The host's whole-record form, offered by the grid when an empty record is refused. */
     onNewRecordForm?: (() => void) | undefined;
+    /** "Who changed this?" from a grid cell — the host opens that column's timeline. */
+    onAskWhoChanged?: ((fieldKey: string, recordId: Uuid) => void) | undefined;
     pageSize?: number | undefined;
     className?: string | undefined;
 }
@@ -1263,7 +1437,7 @@ declare function useViewRecords(view: SavedViewSpec, pageSize?: number): {
     /** Where membership came from, in a sentence. A screen that hides this is hiding the view's meaning. */
     membership: string;
 };
-declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, onNewRecordForm, pageSize, className, }: ViewSwitcherProps): react.JSX.Element;
+declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, onMoved, onNewRecordForm, onAskWhoChanged, pageSize, className, }: ViewSwitcherProps): react.JSX.Element;
 
 interface ViewBarProps {
     /** The Table whose views these are. */
@@ -1353,20 +1527,39 @@ declare function ActionInbox({ tableId, includeSettled, onOpenRecord, className
 interface HistoryPanelProps {
     tableId: Uuid;
     recordId: Uuid;
+    /**
+     * "Who changed THIS column?" — the host opens that field's own timeline. Left
+     * out, the per-field control is absent rather than dead.
+     */
+    onAskAboutField?: ((fieldKey: string) => void) | undefined;
     className?: string | undefined;
 }
-declare function HistoryPanel({ tableId, recordId, className }: HistoryPanelProps): react.JSX.Element;
+declare function HistoryPanel({ tableId, recordId, onAskAboutField, className }: HistoryPanelProps): react.JSX.Element;
 
-/** The package-owned Table every comment is a record of. */
-declare const COMMENT_TABLE: SystemTableSpec;
 interface CommentThreadProps {
-    /** The Table the commented-on record belongs to — its rights decide the composer. */
+    /** The Table the commented-on record belongs to — its Fields name an anchor. */
     tableId: Uuid;
     /** The record being discussed. */
     recordId: Uuid;
+    /** Open on the thread about ONE column, and post there by default. */
+    fieldKey?: string | undefined;
+    className?: string | undefined;
+}
+declare function CommentThread({ tableId, recordId, fieldKey, className }: CommentThreadProps): react.JSX.Element;
+
+interface FieldHistoryPanelProps {
+    tableId: Uuid;
+    /** The column being asked about, by its key. */
+    fieldKey: string;
+    /** Scoped to ONE record when present; the whole Table when absent. */
+    recordId?: Uuid | undefined;
+    /** The host's way back — a cell menu opens this, so it closes too. */
+    onClose?: (() => void) | undefined;
+    /** Open a record from one of its rows. Absent, the row is not a link. */
+    onOpenRecord?: ((recordId: Uuid) => void) | undefined;
     className?: string | undefined;
 }
-declare function CommentThread({ tableId, recordId, className }: CommentThreadProps): react.JSX.Element;
+declare function FieldHistoryPanel({ tableId, fieldKey, recordId, onClose, onOpenRecord, className, }: FieldHistoryPanelProps): react.JSX.Element;
 
 /** How a form is put in front of a person. */
 declare const FORM_FLOWS: readonly ["one-at-a-time", "single-page"];
@@ -1748,11 +1941,13 @@ declare function SignBlock({ tableId, recordId, render, className }: SignBlockPr
 interface NotifyRuleSpec {
     name: string;
     savedViewId: Uuid;
-    /** `immediate` fires on the change; `digest` is collected and sent on a schedule. */
+    /** `instant` fires the moment a record enters the view; the rest are summaries. */
     cadence?: string;
-    /** The digest's schedule, in the store's own words. Meaningless for `immediate`. */
+    /** The summary's schedule — "monday 08:00". Meaningless for `instant`. */
     schedule?: string | null;
     channel?: string;
+    /** The hours not to be told in. A send inside them is MOVED, never dropped. */
+    quietHours?: QuietHours | null;
     /** Who is told. Left out, the person setting it up — "tell ME". */
     recipientUserId?: Uuid | null;
     eventKey?: string;
@@ -1887,7 +2082,18 @@ declare const CAPTURE_MODES: readonly ["reading", "photo", "voice"];
 type CaptureMode = (typeof CAPTURE_MODES)[number];
 declare const IN_MEMORY_QUEUE_REASON: string;
 interface CaptureSheetProps {
-    /** The Table a capture becomes a record in. */
+    /**
+     * A DECLARED capture sheet. Given one, this component runs THAT sheet — its
+     * questions, in its order, with its required ones, one at a time, through
+     * `custom.capture_open` and `custom.capture_submit`, with the durable queue. That is
+     * the crew case (PRODUCTS row 15) and it is what twelve people doing the same round
+     * need: somebody has SAID what the questions are.
+     *
+     * Without one this stays the ad-hoc capture below, which guesses which Field a
+     * reading goes in — right for a quick one-off, wrong for a crew.
+     */
+    sheetId?: Uuid | undefined;
+    /** The Table a capture becomes a record in. Not needed when `sheetId` is given. */
     tableId: Uuid;
     /** Which Field a reading's number goes in. Defaults to the first range Field. */
     readingField?: string | undefined;
@@ -1897,7 +2103,20 @@ interface CaptureSheetProps {
     attachmentField?: string | undefined;
     className?: string | undefined;
 }
-declare function CaptureSheet({ tableId, readingField, noteField, attachmentField, className, }: CaptureSheetProps): react.JSX.Element;
+declare function CaptureSheet({ sheetId, tableId, readingField, noteField, attachmentField, className, }: CaptureSheetProps): react.JSX.Element;
+
+interface CaptureRunProps {
+    sheetId: Uuid$1;
+    /**
+     * The sheet, already loaded — by a server render, or from the phone's own copy. Given
+     * one, this component makes NO network call before the first question is on screen.
+     */
+    face?: CaptureSheetFace | null | undefined;
+    className?: string | undefined;
+}
+/** What control one question gets. `attachment` is why a phone opens its camera. */
+declare function controlFor(field: CaptureField | undefined): "photo" | "voice" | "number" | "text";
+declare function CaptureRun({ sheetId, face: given, className }: CaptureRunProps): react.JSX.Element;
 
 interface PortalShellProps {
     /** The Table the outsider's records belong to. */
@@ -2228,4 +2447,18 @@ declare function useCanShare(): boolean;
 declare function shareUnavailableReason(): string;
 declare function ShareControl({ kind, organizationId, subjectId, name, may, size, variant, className, }: ShareControlProps): ReactNode;
 
-export { ACTION_KINDS, ActionInbox, type ActionInboxProps, type ActionKind, BookingSlots, type BookingSlotsProps, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_TABLE, COMMENT_TABLE, type Capability, type CaptureMode, type CaptureQueuePort, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartConfig, ChartFrame, type ChartKind, ChartLegendContent, type ChartSpec, ChartTooltipContent, ChecklistRunner, type ChecklistRunnerProps, type ChecklistSpec, type ChecklistStepSpec, CommentThread, type CommentThreadProps, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DashboardCanvas, type DashboardCanvasProps, type DeclareResult, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORM_FLOWS, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldLabel, type FieldProposalRow, type FieldTypeChoice, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, Grid, GridCell, type GridEditing, type GridGrouping, type GridPresentation, type GridProps, HistoryPanel, type HistoryPanelProps, 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, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, NOT_ANSWERED_YET, 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_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PARITY_LABEL, PARITY_MADE_OF, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalCardView, type PortalCardViewProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, RefusalLine, RefusalNotice, RelationPicker, type RelationPickerProps, SERIES_COLORS, STORE_DECIDES_REASON, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, SubscriptionsPanel, type SubscriptionsPanelProps, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, type WhatYouMayDo, addFields, blockFromSpec, bodyForReading, bodyFromKeys, colorFromTheValue, columnForField, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldDeclarationFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupLabel, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isId, isMachineIdentity, isPlainFieldType, isSignatureField, keyFor, laneFor, machineIdentityIn, memberName, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, recordName, recordsDataSource, refusalForAPerson, refusalLineForAPerson, renderValue, revokeConsequence, rowName, scalarText, shareUnavailableReason, specFromBlock, storeDecidesRights, submissionStamp, tableName, tableRightsAt, tokenFor, useCanShare, useEmbedHandshake, useGridEditing, useMeasuredWidth, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, viewDocument, viewFromRecord, viewPatchDocument, whatIsMissing, whatYouMayDo, whatYouMayDoWithTable };
+interface PipelineBoardProps {
+    tableId: Uuid;
+    /** The rows the view holds — the SAME rows every other layout of this view draws. */
+    rows: ReadRow$1[];
+    /** A number column to total under each heading. The person picks it; nothing is guessed. */
+    measure?: string | null;
+    onMeasureChange?: ((key: string | null) => void) | undefined;
+    onOpenRecord?: ((recordId: Uuid) => void) | undefined;
+    /** Called after a move lands, so the host re-reads the rows it owns. */
+    onMoved?: (() => void) | undefined;
+    className?: string | undefined;
+}
+declare function PipelineBoard({ tableId, rows, measure, onMeasureChange, onOpenRecord, onMoved, className, }: PipelineBoardProps): react.JSX.Element;
+
+export { ACTION_KINDS, ActionInbox, type ActionInboxProps, type ActionKind, BookingSlots, type BookingSlotsProps, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_TABLE, 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, type ChecklistSpec, type ChecklistStepSpec, CommentThread, type CommentThreadProps, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DashboardCanvas, type DashboardCanvasProps, type DeclareResult, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, EnrichBadge, type EnrichBadgeProps, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORM_FLOWS, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldHistoryPanel, type FieldHistoryPanelProps, FieldLabel, type FieldProposalRow, type FieldTypeChoice, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, Grid, GridCell, type GridEditing, type GridGrouping, type GridPresentation, type GridProps, HistoryPanel, type HistoryPanelProps, 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, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, NOT_ANSWERED_YET, 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_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PARITY_LABEL, PARITY_MADE_OF, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalCardView, type PortalCardViewProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, SERIES_COLORS, STORE_DECIDES_REASON, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, SubscriptionsPanel, type SubscriptionsPanelProps, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, type WhatYouMayDo, addFields, blockFromSpec, bodyForReading, bodyFromKeys, cellState, colorFromTheValue, columnForField, controlFor, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldDeclarationFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupLabel, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isId, isMachineIdentity, isPlainFieldType, isRelationFieldType, isSignatureField, keyFor, laneFor, machineIdentityIn, memberName, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, recordName, recordsDataSource, refusalForAPerson, refusalLineForAPerson, renderValue, revokeConsequence, rowName, scalarText, shareUnavailableReason, specFromBlock, storeDecidesRights, submissionStamp, tableName, tableRightsAt, tokenFor, useCanShare, useEmbedHandshake, useEnrichCells, useGridEditing, useMeasuredWidth, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, viewDocument, viewFromRecord, viewPatchDocument, whatIsMissing, whatYouMayDo, whatYouMayDoWithTable };