@ai-matrx/records-ui 0.5.4 → 0.7.0

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { Uuid as Uuid$1, Table, RecordsError, Field as Field$1, RecordDocument, ValueEnvelope, ParityFieldType, ReadRow as ReadRow$1, RuleExpression, AggregateBucket, AggregateMeasure, DocTemplateRow, DocRenderRow, AnonTokenBinding, RecordsConfig, RecordsActor, RecordsDataSource } from '@ai-matrx/records';
-import { Uuid, Field, ReadRow } from '@ai-matrx/records/react';
-import { MatrxColumnDef } from '@ai-matrx/design-system/data-table/types';
+import { Uuid as Uuid$1, Table, Field, RecordDocument, ReadRow, RecordsError, WriteConflict, ValueEnvelope, ParityFieldType, RuleExpression, AggregateBucket, AggregateMeasure, DocTemplateRow, DocRenderRow, AnonTokenBinding, RecordsConfig, RecordsActor, RecordsDataSource } 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 { MatrxColumnDef } from '@ai-matrx/design-system/data-table/types';
 
 /** One named piece of grounding, shaped the way the platform's context slice takes them. */
 interface RecordChatEntry {
@@ -136,6 +136,21 @@ interface RecordsUiHost {
         id: Uuid$1;
         name: string;
     }>>;
+    /**
+     * OPTIONAL. WHO IS IN THIS ORGANIZATION (FLD-11 `member`).
+     *
+     * A person field must offer PEOPLE. Who the people are is the platform's
+     * answer — organization membership lives in `iam`, not in the record store —
+     * and the store has no door onto it, so this is a port rather than a read
+     * this package invents. `PersonPicker` resolves whoever is picked to their
+     * record in the kernel Person Table, which is what the Field actually stores.
+     *
+     * Unbound, a person question is ABSENT with `NO_MEMBERS_REASON`. It never
+     * falls back to listing the kernel Person Table's contents: that Table also
+     * holds the Homes this package writes, and offering "Comments Home" as a
+     * person is exactly what this port exists to stop.
+     */
+    members?: () => Promise<OrganizationMember[]>;
     /**
      * OPTIONAL. THE HOST'S OWN CHAT SURFACE (SCR-26).
      *
@@ -174,6 +189,15 @@ interface RecordsUiHost {
      */
     captureQueue?: CaptureQueuePort;
 }
+/** One member of the organization, in the words a person reads. */
+interface OrganizationMember {
+    /** The platform's user id. This is what a Person record carries as `user_id`. */
+    userId: string;
+    /** Their display name, when the platform has one. */
+    name?: string | null;
+    email?: string | null;
+    avatarUrl?: string | null;
+}
 /** The durable half of offline capture: read the queue, write it, that is all. */
 interface CaptureQueuePort {
     load: () => Promise<PendingCapture[]>;
@@ -197,6 +221,8 @@ interface PendingCapture {
 }
 /** The sentence the notify editor shows when no saved-view port is bound. */
 declare const NO_SAVED_VIEWS_REASON: string;
+/** The sentence a person question shows when no membership port is bound. */
+declare const NO_MEMBERS_REASON: string;
 /** The sentence an attachment question shows when no file store is bound. */
 declare const NO_UPLOAD_REASON: string;
 declare function RecordsUiProvider({ value, children }: {
@@ -207,6 +233,126 @@ declare function useRecordsUi(): RecordsUiHost;
 /** The rights for one table — `NO_RIGHTS`, with its reason, when nothing is bound. */
 declare function useTableRights(table: Table | null | undefined): TableRights;
 
+/**
+ * A token (`records_ui_view`, `long_text`, `v78_widget2`) as a person would
+ * write it. Used ONLY as a last resort, when the thing carries no label at all
+ * — a raw token on a screen is the defect, and a humanised token is the least
+ * bad honest answer, because it still names the same thing.
+ */
+declare function humanize(token: string): string;
+/** The name of one Field, as a header, a form label or a peek's term. */
+declare function fieldName(field: Field): string;
+/** The name of one Table, as a card, a heading or a breadcrumb. */
+declare function tableName(table: Table): string;
+/**
+ * The name of one RECORD, for a chip, a card, a relation cell or a peek title.
+ *
+ * `titleKey` is the Table's own `title_field` when the caller knows the Table —
+ * that is the store's answer to "what makes this record a chip" (REC-2) — and
+ * the conventional keys are tried after it. A record with nothing readable is
+ * NOT shown as a truncated uuid: it says it has no name yet, because "8f2c1b0a"
+ * tells a person nothing and looks like a bug.
+ */
+declare function recordName(document: RecordDocument | undefined, titleKey?: string | null, fallback?: string): string;
+/** The same question for a row the read door returned. */
+declare function rowName(row: ReadRow | undefined, titleKey?: string | null, fallback?: string): string;
+
+interface PersonPickerProps {
+    field: Field;
+    value: unknown;
+    onChange: (value: unknown) => void;
+    disabled?: boolean | undefined;
+    id?: string | undefined;
+    className?: string | undefined;
+}
+/** A Person record in the kernel Table, as this picker needs to read it. */
+interface PersonRecord {
+    id: Uuid$1;
+    userId: string | null;
+    name: string;
+}
+/** The member's own name, as a person reads it. Never a uuid. */
+declare function memberName(member: OrganizationMember): string;
+/**
+ * Find (or write) the kernel Person record for one member. Exported because
+ * an agent filling a person field server-side needs exactly the same answer,
+ * and two implementations of "which record is this person" is two answers.
+ */
+declare function personRecordForMember(client: RecordsClient, personTableId: Uuid$1, people: PersonRecord[], member: OrganizationMember): Promise<{
+    ok: true;
+    data: Uuid$1;
+} | {
+    ok: false;
+    error: RecordsError;
+}>;
+declare function PersonPicker({ field, value, onChange, disabled, id, className }: PersonPickerProps): react.JSX.Element;
+
+/** Which cell is open. A grid opens exactly one at a time, like every other grid. */
+interface CellAddress {
+    rowId: Uuid$1;
+    key: string;
+}
+/** What one cell is doing right now, so nothing about it is guessed by a caller. */
+type CellState = "clean" | "saving" | "refused";
+interface CellRefusal {
+    error: RecordsError;
+    /** Present when the store said `PT409`: the other person's value, from the store. */
+    conflict: WriteConflict | null;
+    /** The value that was being written, so Retry can write it again. */
+    attempted: unknown;
+}
+/**
+ * FLD-9. A computed Field is not editable and never will be — the store works
+ * it out. Saying so here, once, keeps every caller from re-deciding it.
+ */
+declare function fieldIsEditable(field: Field): boolean;
+interface GridEditing {
+    /** The value to DRAW for one cell — the optimistic one when there is one. */
+    valueFor: (row: ReadRow, field: Field) => unknown;
+    editing: CellAddress | null;
+    stateOf: (rowId: Uuid$1, key: string) => CellState;
+    refusalOf: (rowId: Uuid$1, key: string) => CellRefusal | null;
+    begin: (address: CellAddress) => void;
+    cancel: () => void;
+    /** Commit the open cell. `move` opens the next/previous editable cell after it. */
+    commit: (value: unknown, move?: "next" | "previous" | null) => void;
+    /** Write the attempted value again, after re-reading the version. */
+    retry: (rowId: Uuid$1, key: string) => void;
+    /** Drop the edit and show what the other person wrote. */
+    keepTheirs: (rowId: Uuid$1, key: string) => void;
+    /** Soft delete, through the store's own door. Answers the store's refusal, or null. */
+    remove: (rowId: Uuid$1) => Promise<RecordsError | null>;
+    /** Write an empty record and open its first editable cell. */
+    addRecord: () => Promise<RecordsError | null>;
+    /** The last refusal from a delete or an add, for the grid to print. */
+    rowError: RecordsError | null;
+    clearRowError: () => void;
+    busy: boolean;
+}
+interface Options {
+    tableId: Uuid$1;
+    fields: Field[];
+    rows: ReadRow[];
+    /** Re-read the page once the store has accepted something. */
+    reload: () => void;
+    /** May this person write records at all? A read-only grid opens no editor. */
+    canWrite: boolean;
+}
+declare function useGridEditing({ tableId, fields, rows, reload, canWrite }: Options): GridEditing;
+/**
+ * ONE CELL. Read, until somebody asks to change it; then the Field's own
+ * editor, in place, with the keys a person expects from a grid.
+ *
+ * `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, }: {
+    field: Field;
+    row: ReadRow;
+    editing: GridEditing;
+    canWrite: boolean;
+}): react.JSX.Element;
+
 declare function RefusalNotice({ error, className, actions, }: {
     error: RecordsError;
     className?: string | undefined;
@@ -226,18 +372,30 @@ interface GridProps {
     onOpenRecord?: ((recordId: Uuid) => void) | undefined;
     /** SCR-2. Called when an admin clicks the "+" at the end of the headers. */
     onAddField?: (() => 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
+     * a time, and saying so beats a button that fails.
+     */
+    onNewRecordForm?: (() => void) | undefined;
     /** Extra toolbar content — the view switcher, the export menu, the view bar. */
     toolbarActions?: ReactNode | undefined;
+    /** Editing in place is on by default; a read-only surface (a portal) turns it off. */
+    editable?: boolean | undefined;
     className?: string | undefined;
 }
-declare function Grid({ tableId, pageSize, onOpenRecord, onAddField, toolbarActions, className, }: GridProps): react.JSX.Element;
-/** One Field becomes one column. The header is the Field's label; the cell is the value, rendered by its parity type. */
-declare function columnForField(field: Field): MatrxColumnDef<ReadRow>;
+declare function Grid({ tableId, pageSize, onOpenRecord, onAddField, onNewRecordForm, toolbarActions, editable, className, }: 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
+ * editable in place when an editing session is passed.
+ */
+declare function columnForField(field: Field$1, editing?: GridEditing | null): MatrxColumnDef<ReadRow$1>;
 
 interface ExportMenuProps {
     tableId: Uuid;
     /** The rows on screen. Absent means "this table's first page", read the same way. */
-    rows?: ReadRow[] | undefined;
+    rows?: ReadRow$1[] | undefined;
     /** What the file is called. The table's name by default. */
     label?: string | undefined;
     className?: string | undefined;
@@ -276,7 +434,7 @@ declare function CustomFieldsSection({ tableId, entityToken, recordId, title, cl
 interface FieldEditorProps {
     tableId: Uuid$1;
     /** The Field being edited. Absent means a new one. */
-    field?: Field$1 | undefined;
+    field?: Field | undefined;
     onSaved?: (() => void) | undefined;
     onCancel?: (() => void) | undefined;
     className?: string | undefined;
@@ -286,7 +444,7 @@ declare function FieldEditor({ tableId, field, onSaved, onCancel, className }: F
 interface FieldProposalRow {
     id: string;
     /** What the agent proposed, in the Field shape the store would store. */
-    field: Partial<Field> & {
+    field: Partial<Field$1> & {
         key: string;
         label?: string;
     };
@@ -305,9 +463,14 @@ interface TableSettingsProps {
     proposals?: FieldProposalRow[] | undefined;
     onAcceptProposal?: ((proposal: FieldProposalRow) => void) | undefined;
     onRejectProposal?: ((proposal: FieldProposalRow) => void) | undefined;
+    /**
+     * SCR-3's fourth verb. Called after the store has accepted the delete, so the
+     * host can leave a page that is now about a table nobody can open.
+     */
+    onDeleted?: (() => void) | undefined;
     className?: string | undefined;
 }
-declare function TableSettings({ tableId, proposals, onAcceptProposal, onRejectProposal, className, }: TableSettingsProps): react.JSX.Element;
+declare function TableSettings({ tableId, proposals, onAcceptProposal, onRejectProposal, onDeleted, className, }: TableSettingsProps): react.JSX.Element;
 
 interface PeekProps {
     tableId: Uuid;
@@ -330,7 +493,7 @@ interface RecordFormProps {
 declare function RecordForm({ tableId, recordId, recordType, onSaved, onCancel, className, }: RecordFormProps): react.JSX.Element;
 
 interface RelationPickerProps {
-    field: Field$1;
+    field: Field;
     value: unknown;
     onChange: (value: unknown) => void;
     disabled?: boolean | undefined;
@@ -340,7 +503,7 @@ interface RelationPickerProps {
 declare function RelationPicker({ field, value, onChange, disabled, id, className }: RelationPickerProps): react.JSX.Element;
 
 interface FieldEditorControlProps {
-    field: Field$1;
+    field: Field;
     value: unknown;
     onChange: (value: unknown) => void;
     disabled?: boolean | undefined;
@@ -348,7 +511,7 @@ interface FieldEditorControlProps {
 }
 /** The label row every editor shares: one line, the label, the unit, the required mark. */
 declare function FieldLabel({ field, htmlFor, children }: {
-    field: Field$1;
+    field: Field;
     htmlFor: string;
     children?: ReactNode;
 }): react.JSX.Element;
@@ -362,9 +525,9 @@ declare function RecordChip({ title, onRemove, className, }: {
 
 /** The envelope for one key, when the document carries one. */
 declare function envelopeFor(document: RecordDocument | undefined, key: string): ValueEnvelope | undefined;
-declare function renderValue(field: Field$1, value: unknown, document?: RecordDocument): react.JSX.Element;
+declare function renderValue(field: Field, value: unknown, document?: RecordDocument): react.JSX.Element;
 /** The text of one scalar, with the Field's UNIT and FORMAT applied — FLD-N-1 says both change the MEANING. */
-declare function scalarText(field: Field$1, value: unknown): string;
+declare function scalarText(field: Field, value: unknown): string;
 /** The provenance badge a value carries when the store interned a source for it (SCR-27). */
 declare function ProvenanceBadge({ document, fieldKey }: {
     document: RecordDocument | undefined;
@@ -375,16 +538,16 @@ declare const PARITY_LABEL: Record<ParityFieldType, string>;
 /** The "made of" sentence the store itself publishes, for the field editor's help text. */
 declare const PARITY_MADE_OF: Record<string, string>;
 /** Plain text and plain number are behaviours with no parity type of their own. */
-type EditorKind = ParityFieldType | "relation" | "text" | "number" | "boolean" | "date" | "long_text";
+type EditorKind = ParityFieldType | "relation" | "text" | "number" | "boolean" | "date" | "json" | "long_text";
 /**
  * Which editor one Field wants. Reads the Field's own declaration only — the
  * behaviour, the modifiers, the format, the relation target and the config —
  * because those are what the store stores, and a screen that guessed from a
  * value would draw a different editor for an empty record.
  */
-declare function editorKindFor(field: Field$1): EditorKind;
+declare function editorKindFor(field: Field): EditorKind;
 /** The type word a person sees in a header or a settings row. */
-declare function fieldTypeLabel(field: Field$1): string;
+declare function fieldTypeLabel(field: Field): string;
 
 /** One Field of a package-owned Table, in the store's own words. */
 interface SystemFieldSpec {
@@ -421,6 +584,31 @@ interface UseSystemTableState {
 }
 /** The hook every package-owned component opens with. */
 declare function useSystemTable(spec: SystemTableSpec): UseSystemTableState;
+/**
+ * THE VERSION OF THE ONE RECORD BEING EDITED.
+ *
+ * The read door (`custom.read_records`) answers documents, never versions —
+ * deliberately, because a version is a fact about the row and not about what
+ * this reader may see. A screen that saves optimistically still needs the
+ * version it LOADED, so it reads it here, for the one record it is editing and
+ * never for a list, through `custom.io_revisions`.
+ *
+ * `null` is an honest answer: the save then carries no expected version and is
+ * the store's ordinary last-writer-wins write. It is never a guess.
+ */
+/** What `useRecordVersion` hands a screen that writes the record more than once. */
+interface TrackedVersion {
+    /** The version this screen is writing against, or `null` when none was read. */
+    version: number | null;
+    /**
+     * TELL IT THE STORE MOVED. Every successful write answers the record's NEW
+     * version; a screen that does not hand it back here will write against the
+     * old one next time and the store will — correctly — refuse it as a conflict
+     * with somebody who turns out to be the same person. Measured 2026-09-19:
+     * switching a saved view's layout twice in a row did exactly that.
+     */
+    note: (version: number) => void;
+}
 
 /** The four ways one saved view can be looked at (SCR-6). */
 declare const VIEW_LAYOUTS: readonly ["grid", "kanban", "calendar", "gallery"];
@@ -473,10 +661,32 @@ interface SavedView extends SavedViewSpec {
 }
 /** The package-owned Table every saved view is a record of. */
 declare const VIEW_TABLE: SystemTableSpec;
+/**
+ * WHICH FIELD EACH LAYOUT CAN BE DRAWN FROM, decided from the FIELD'S OWN
+ * DECLARATION and never from the values it happens to hold.
+ *
+ * A kanban makes columns from a choice: the Field whose value is one of a
+ * closed set (FLD-5 / FLD-6 — a pick-list is a Table, and a select stores the
+ * id of one of its records). Grouping by a free-text Field produces one column
+ * per record, which is not a board. A calendar places a record in time, so it
+ * needs a Field that holds a date.
+ *
+ * These two answers are here, beside the layouts, because the picker on the
+ * screen and any agent writing a view spec must agree about what is offerable.
+ */
+declare const LAYOUT_FIELD_KIND: Record<ViewLayout, "choice" | "date" | null>;
+/** The one sentence a layout says when the table holds no Field it could use. */
+declare const LAYOUT_NO_FIELD: Record<ViewLayout, string>;
 /** The spec as the one document the store holds. */
 declare function viewDocument(spec: SavedViewSpec): Record<string, unknown>;
 /** One stored record back into the spec a screen and an agent both read. */
-declare function viewFromRecord(row: ReadRow$1): SavedView;
+declare function viewFromRecord(row: ReadRow): SavedView;
+/**
+ * A PARTIAL change to a saved view, as the patch the store takes. Only the keys
+ * the caller actually changed are written — a full document would re-write a
+ * name or a rule the person edited in another tab.
+ */
+declare function viewPatchDocument(patch: Partial<SavedViewSpec>): Record<string, unknown>;
 
 interface ViewSwitcherProps {
     /**
@@ -487,19 +697,29 @@ interface ViewSwitcherProps {
     view: SavedViewSpec;
     /** Called when the person picks another layout, so the host can save it. */
     onLayoutChange?: ((layout: ViewLayout) => void) | undefined;
+    /**
+     * Called with whatever part of the view the person just changed — the layout,
+     * the Field the kanban groups by, the Field the calendar reads. The HOST
+     * saves it onto the view record, so the choice is remembered per saved view
+     * rather than per page load. Unbound, the pickers still work for this visit
+     * and the screen says the choice is not being kept.
+     */
+    onViewChange?: ((patch: Partial<SavedViewSpec>) => void) | undefined;
     onOpenRecord?: ((recordId: Uuid) => void) | undefined;
+    /** The host's whole-record form, offered by the grid when an empty record is refused. */
+    onNewRecordForm?: (() => void) | undefined;
     pageSize?: number | undefined;
     className?: string | undefined;
 }
 /** The records this view holds: its Rule's members when it names one, the table otherwise. */
 declare function useViewRecords(view: SavedViewSpec, pageSize?: number): {
-    rows: ReadRow[];
+    rows: ReadRow$1[];
     loading: boolean;
     error: RecordsError | null;
     /** 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, onOpenRecord, pageSize, className }: ViewSwitcherProps): react.JSX.Element;
+declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, onNewRecordForm, pageSize, className, }: ViewSwitcherProps): react.JSX.Element;
 
 interface ViewBarProps {
     /** The Table whose views these are. */
@@ -701,7 +921,7 @@ declare const FORM_TABLE: SystemTableSpec;
 /** The spec as the one document the store holds. */
 declare function formDocument(spec: FormSpec): Record<string, unknown>;
 /** One stored record back into the spec a screen and an agent both read. */
-declare function formFromRecord(row: ReadRow$1): SavedForm;
+declare function formFromRecord(row: ReadRow): SavedForm;
 /**
  * THE SOURCE STAMP every submission carries. A record that arrived through a
  * form is not indistinguishable from one somebody typed into the grid: it says
@@ -779,7 +999,7 @@ interface SavedDashboard extends DashboardSpec {
 /** The package-owned Table every dashboard is a record of. */
 declare const DASHBOARD_TABLE: SystemTableSpec;
 declare function dashboardDocument(spec: DashboardSpec): Record<string, unknown>;
-declare function dashboardFromRecord(row: ReadRow$1): SavedDashboard;
+declare function dashboardFromRecord(row: ReadRow): SavedDashboard;
 /**
  * The series palette. Six SEMANTIC tokens the design system already flips for
  * dark mode, so a chart is correct in both themes without a second palette and
@@ -807,11 +1027,11 @@ interface DocTemplateSpec {
  * `custom.doc_unresolved_tokens` names it and the screen shows the store's own
  * reason — it is never quietly deleted from the body.
  */
-declare function bodyFromKeys(body: string, fields: Field$1[]): string;
+declare function bodyFromKeys(body: string, fields: Field[]): string;
 /** The reverse, for a person reading a stored body: ids shown as the Field's label. */
-declare function bodyForReading(body: string, fields: Field$1[]): string;
+declare function bodyForReading(body: string, fields: Field[]): string;
 /** VAL-10: a signature is a Value on a text Field whose format is `signature`. */
-declare function isSignatureField(field: Field$1): boolean;
+declare function isSignatureField(field: Field): boolean;
 
 interface DocTemplateProps {
     /** The Table these templates render. */
@@ -1076,8 +1296,8 @@ declare function personActor(userId: Uuid$1 | null | undefined): RecordsActor;
  */
 declare function recordsDataSource(client: object, fallbackSchema?: string): RecordsDataSource;
 
-type TableLane = "mine" | "organization" | "system" | "community";
-/** The four lanes, in the order a person reads them. Never a flat list. */
+type TableLane = "mine" | "organization" | "system" | "community" | "app";
+/** The five lanes, in the order a person reads them. Never a flat list. */
 declare const TABLE_LANES: readonly TableLane[];
 declare const LANE_TITLE: Record<TableLane, string>;
 /** What fills an empty lane. A heading with nothing under it must still teach. */
@@ -1102,9 +1322,51 @@ interface TablePageProps {
      * used — see why that default is not optional.
      */
     seedViews?: SavedViewSpec[] | undefined;
+    /**
+     * What a person does when the table is not theirs to see — switch
+     * organization, go back to the list. Absent, the screen still SAYS what
+     * happened; it just has no button to offer, which is honest and is never a
+     * blank frame.
+     */
+    onLeave?: (() => void) | undefined;
+    /** The word on that button. Defaults to "Back to your tables". */
+    leaveLabel?: string | undefined;
     className?: string | undefined;
 }
-declare function TablePage({ tableId, pageSize, seedViews, className }: TablePageProps): react.JSX.Element;
+/**
+ * THE SENTENCE A TABLE YOU CANNOT SEE SAYS.
+ *
+ * Measured on the real screen (independent verdict, 19 September): opening a
+ * table's page while another organization was active left the main area's text
+ * "literally the empty string" after eighteen seconds — no sentence, no
+ * spinner, no console error. A made-up id did the same. The cause is exactly
+ * one line of this file: `custom.table_list` correctly answers the tables this
+ * person can see in THIS organization, the table is not among them, so
+ * `useTable` answers `{ data: null, error: null }` — not a refusal, just
+ * absence — and the page rendered a skeleton for ever.
+ *
+ * Absence is an ANSWER and it gets a sentence. It deliberately does not say
+ * whether the table exists: this person cannot see it, and which of the two it
+ * is is not theirs to learn.
+ */
+declare const TABLE_NOT_REACHABLE: string;
+/**
+ * THE VIEW EVERY TABLE HAS, AND WHY IT IS NOT OPTIONAL.
+ *
+ * A view is a record, so a table nobody has saved a view for has none — and
+ * this page then renders its own honest sentence ("Waiting for this table's
+ * views") and NO RECORDS AT ALL. Measured on 2026-09-19 by walking the real
+ * product: declare a table, write a record, open the table — and the record is
+ * not on the screen, with the only remedy being a control the person has no
+ * reason to press. That is a dead end on the first table anybody makes.
+ *
+ * So the page seeds one: every record, newest work first, as a grid. It is an
+ * ordinary saved view record like any other — renamable, re-sortable,
+ * deletable — not a hidden built-in mode, because a "special" default view is a
+ * second kind of view that every feature after it has to know about.
+ */
+declare const DEFAULT_VIEW_NAME = "All records";
+declare function TablePage({ tableId, pageSize, seedViews, onLeave, leaveLabel, className, }: TablePageProps): react.JSX.Element;
 
 /** One Field a person asked for, in the store's own behaviour words (FLD-1). */
 interface NewFieldSpec {
@@ -1137,6 +1399,18 @@ type DeclareResult = {
 /** `My Sales Pipeline` → `my_sales_pipeline`. A token, never a sentence. */
 declare function tokenFor(name: string): string;
 /** The one Field a Table cannot be declared without: something to call a record. */
+/**
+ * WHY THE FIRST FIELD IS NOT REQUIRED.
+ *
+ * It was, and the cost showed up the moment the grid could add a row: "New
+ * record" writes an empty record and puts you in the first cell, and the store
+ * correctly refused every one of them — `REC-51: Title is required` — so the
+ * one gesture that makes a grid feel like a grid never worked on a table a
+ * person had just made. A title is what makes a record a CHIP (REC-2), which is
+ * a fact about how it is shown, not a promise it can never be written without;
+ * an organization that wants it demanded says so in the field editor, and the
+ * store then enforces it for everyone.
+ */
 declare const DEFAULT_FIELDS: NewFieldSpec[];
 declare function declareTable(client: RecordsClient, spec: NewTableSpec): Promise<DeclareResult>;
 /** Write Field records for an existing Table. Used by the create path and by import. */
@@ -1148,4 +1422,4 @@ declare function addFields(client: RecordsClient, tableId: Uuid$1, fields: NewFi
     error: RecordsError;
 }>;
 
-export { ACTION_KINDS, ACTION_TABLE, ActionInbox, type ActionInboxProps, type ActionKind, BookingSlots, type BookingSlotsProps, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_TABLE, COMMENT_TABLE, type CaptureMode, type CaptureQueuePort, CaptureSheet, type CaptureSheetProps, ChartBlock, type ChartBlockProps, type ChartKind, type ChartSpec, ChecklistRunner, type ChecklistRunnerProps, type ChecklistSpec, type ChecklistStepSpec, CommentThread, type CommentThreadProps, CustomFieldsSection, type CustomFieldsSectionProps, DASHBOARD_TABLE, DEFAULT_FIELDS, DashboardCanvas, type DashboardCanvasProps, type DashboardSpec, type DeclareResult, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FORM_FLOWS, FORM_TABLE, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldLabel, type FieldProposalRow, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormTheme, Grid, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_LABEL, LAYOUT_NEEDS, NO_CHAT_REASON, NO_ENRICH_REASON, NO_RIGHTS, NO_SAVED_VIEWS_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, PARITY_LABEL, PARITY_MADE_OF, Peek, type PeekProps, type PendingCapture, PortalShell, type PortalShellProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, type QueuedAction, type QueuedActionSpec, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, RefusalLine, RefusalNotice, RelationPicker, type RelationPickerProps, SERIES_COLORS, STORE_DECIDES_REASON, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, SignBlock, type SignBlockProps, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type UseSystemTableState, VIEW_LAYOUTS, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, actionDocument, addFields, bodyForReading, bodyFromKeys, columnForField, dashboardDocument, dashboardFromRecord, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldToken, fieldTypeLabel, formDocument, formFromRecord, groupLabel, isSignatureField, laneFor, personActor, recordsDataSource, renderValue, scalarText, storeDecidesRights, submissionStamp, tokenFor, useEmbedHandshake, useRecordsUi, useSystemTable, useTableRights, useViewRecords, viewDocument, viewFromRecord };
+export { ACTION_KINDS, ACTION_TABLE, ActionInbox, type ActionInboxProps, type ActionKind, BookingSlots, type BookingSlotsProps, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_TABLE, COMMENT_TABLE, type CaptureMode, type CaptureQueuePort, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartKind, type ChartSpec, ChecklistRunner, type ChecklistRunnerProps, type ChecklistSpec, type ChecklistStepSpec, CommentThread, type CommentThreadProps, CustomFieldsSection, type CustomFieldsSectionProps, DASHBOARD_TABLE, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DashboardCanvas, type DashboardCanvasProps, type DashboardSpec, type DeclareResult, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FORM_FLOWS, FORM_TABLE, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldLabel, type FieldProposalRow, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormTheme, Grid, GridCell, type GridEditing, 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, NO_CHAT_REASON, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_RIGHTS, NO_SAVED_VIEWS_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OrganizationMember, PARITY_LABEL, PARITY_MADE_OF, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, PortalShell, type PortalShellProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, type QueuedAction, type QueuedActionSpec, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, RefusalLine, RefusalNotice, RelationPicker, type RelationPickerProps, SERIES_COLORS, STORE_DECIDES_REASON, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, SignBlock, type SignBlockProps, 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_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, actionDocument, addFields, bodyForReading, bodyFromKeys, columnForField, dashboardDocument, dashboardFromRecord, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldIsEditable, fieldName, fieldToken, fieldTypeLabel, formDocument, formFromRecord, groupLabel, humanize, isSignatureField, laneFor, memberName, personActor, personRecordForMember, recordName, recordsDataSource, renderValue, rowName, scalarText, storeDecidesRights, submissionStamp, tableName, tokenFor, useEmbedHandshake, useGridEditing, useRecordsUi, useSystemTable, useTableRights, useViewRecords, viewDocument, viewFromRecord, viewPatchDocument };