@ai-matrx/records-ui 0.6.0 → 0.9.0

package/dist/index.d.cts

@@ -188,6 +188,41 @@ interface RecordsUiHost {
      * queue that silently died with the tab is the failure this exists to avoid.
      */
     captureQueue?: CaptureQueuePort;
+    /**
+     * OPTIONAL. THE HOST'S OWN SHARE DIALOG (SCR-N-5).
+     *
+     * This package ships no share dialog, ON PURPOSE, and for the same reason it
+     * ships no chat: AI Matrx has exactly ONE sharing surface — matrx-frontend's
+     * `features/sharing` ShareModal, with its people picker, its level picker, its
+     * grant list and its "who can see this, and why" panel — and a second one here
+     * would be a parallel sharing UI within a month. Sharing is the access model's
+     * front door, and two front doors is how a platform ends up with two answers
+     * to "who can see this".
+     *
+     * So `ShareControl` draws the BUTTON (which belongs on the record and table
+     * screens, beside everything else a person does to a thing) and hands the
+     * subject to this port, which returns the host's own dialog.
+     *
+     * Unbound, the button is ABSENT and `NO_SHARE_REASON` says which port to bind.
+     * Never a Share button that opens nothing.
+     */
+    share?: (subject: ShareSubject) => ReactNode;
+}
+/**
+ * What a host's share dialog is being opened ON. A Table is a record in this
+ * store (a `custom.record` row whose table is the Table kernel), so ONE subject
+ * shape covers both screens and `kind` is what the sentences say, not what the
+ * store looks up.
+ */
+interface ShareSubject {
+    kind: "record" | "table";
+    /** The store is keyed (organization_id, id); this package never guesses one. */
+    organizationId: Uuid$1;
+    subjectId: Uuid$1;
+    /** What to call it on screen. Never empty — the id's first eight characters at worst. */
+    name: string;
+    /** Close the dialog. The control owns the open/closed state, the host owns the dialog. */
+    onClose: () => void;
 }
 /** One member of the organization, in the words a person reads. */
 interface OrganizationMember {
@@ -223,6 +258,8 @@ interface PendingCapture {
 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 shown when no share dialog is bound. */
+declare const NO_SHARE_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 }: {
@@ -431,15 +468,19 @@ interface CustomFieldsSectionProps {
 }
 declare function CustomFieldsSection({ tableId, entityToken, recordId, title, className, }: CustomFieldsSectionProps): react.JSX.Element | null;
 
+/** `Day rate` → `day_rate`. Shown, so nothing about it is a surprise. */
+declare function keyFor(label: string): string;
 interface FieldEditorProps {
     tableId: Uuid$1;
     /** The Field being edited. Absent means a new one. */
     field?: Field | undefined;
     onSaved?: (() => void) | undefined;
     onCancel?: (() => void) | undefined;
+    /** Called after the store has accepted the removal, so the list can re-read. */
+    onRemoved?: (() => void) | undefined;
     className?: string | undefined;
 }
-declare function FieldEditor({ tableId, field, onSaved, onCancel, className }: FieldEditorProps): react.JSX.Element;
+declare function FieldEditor({ tableId, field, onSaved, onCancel, onRemoved, className }: FieldEditorProps): react.JSX.Element;
 
 interface FieldProposalRow {
     id: string;
@@ -463,9 +504,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;
@@ -518,16 +564,57 @@ declare function RecordChip({ title, onRemove, className, }: {
     className?: string | undefined;
 }): react.JSX.Element;
 
+/** Answers "what is the record with this id called", for one Field's values. */
+type LabelLookup = (field: Field$1, id: string) => string | null;
+/** Which ids a Field's stored value refers to. */
+declare function idsOf(value: unknown): string[];
+declare function isId(value: unknown): boolean;
+/** True when this Field's values are ids of other records rather than values. */
+declare function pointsAtRecords(field: Field$1): boolean;
+declare function RecordLabelProvider({ children }: {
+    children: ReactNode;
+}): react.JSX.Element;
+/**
+ * The hook a surface uses: it declares the Fields it is about to draw, and gets
+ * back the lookup. Declaring is what makes one request per Field instead of one
+ * per cell, and it is why a grid of 200 rows asks the store twice.
+ */
+declare function useRecordLabels(fields: readonly Field$1[] | undefined): LabelLookup;
+
 /** 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, 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, value: unknown): string;
+declare function renderValue(field: Field, value: unknown, document?: RecordDocument, labels?: LabelLookup): react.JSX.Element;
+/**
+ * The text of one scalar, with the Field's UNIT and FORMAT applied — FLD-N-1
+ * says both change the MEANING — and with an id resolved to the NAME of the
+ * record it points at.
+ *
+ * `labels` is the resolver from `RecordLabelProvider`. Without it, an id is
+ * drawn as "Loading…" and never as itself: a 36-character identifier in a cell
+ * reads like a value, and the 19 September verdict found it in choice cells,
+ * relation cells and as every Kanban column heading.
+ */
+declare function scalarText(field: Field, value: unknown, labels?: LabelLookup): 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;
     fieldKey: string;
 }): react.JSX.Element | null;
+/**
+ * THE VALUE, AS A COMPONENT, so a cell can resolve the ids it holds.
+ *
+ * `renderValue` is a plain function called from inside a column's `cell`
+ * callback and from a dozen other places; a function cannot ask the resolver
+ * for a name, because asking is a hook. Every read-only surface therefore draws
+ * through this instead, and the one that needs the raw function (a plain-text
+ * export, a chat line) keeps calling `renderValue` with no resolver and says
+ * "Loading…" rather than printing an id.
+ */
+declare function RecordValue({ field, value, document, }: {
+    field: Field;
+    value: unknown;
+    document?: RecordDocument | undefined;
+}): react.JSX.Element;
 
 declare const PARITY_LABEL: Record<ParityFieldType, string>;
 /** The "made of" sentence the store itself publishes, for the field editor's help text. */
@@ -541,9 +628,40 @@ type EditorKind = ParityFieldType | "relation" | "text" | "number" | "boolean" |
  * value would draw a different editor for an empty record.
  */
 declare function editorKindFor(field: Field): EditorKind;
-/** The type word a person sees in a header or a settings row. */
+/**
+ * The type word a person sees in a header or a settings row — and it is the
+ * SAME word the field panel offers, read from `FIELD_TYPE_CHOICES`, so a column
+ * added as "Money" is never described anywhere else as "Currency".
+ */
 declare function fieldTypeLabel(field: Field): string;
 
+/** 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;
+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. */
+    group: "Words" | "Numbers and dates" | "Choices and people" | "Worked out";
+}
+declare const FIELD_TYPE_CHOICES: FieldTypeChoice[];
+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 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.
+ */
+declare function parityTypesWithNoExplanation(): string[];
+
 /** One Field of a package-owned Table, in the store's own words. */
 interface SystemFieldSpec {
     key: string;
@@ -579,6 +697,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"];
@@ -1369,6 +1512,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. */
@@ -1380,4 +1535,20 @@ 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, 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 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 };
+interface ShareControlProps {
+    kind: ShareSubject["kind"];
+    organizationId: Uuid$1;
+    subjectId: Uuid$1;
+    /** What to call it in the dialog's title. */
+    name?: string | undefined;
+    size?: "sm" | "default" | undefined;
+    variant?: "ghost" | "outline" | "default" | undefined;
+    className?: string | undefined;
+}
+/** True when a host has bound a share dialog — so a caller can lay out its row. */
+declare function useCanShare(): boolean;
+/** Why there is no Share button here, for anything that asks. */
+declare function shareUnavailableReason(): string;
+declare function ShareControl({ kind, organizationId, subjectId, name, size, variant, className, }: ShareControlProps): ReactNode;
+
+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, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORM_FLOWS, FORM_TABLE, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldLabel, type FieldProposalRow, type FieldTypeChoice, 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, type LabelLookup, NO_CHAT_REASON, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_RIGHTS, NO_SAVED_VIEWS_REASON, NO_SHARE_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, type PickableFieldType, type PlainFieldType, 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, 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, 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, fieldTypeChoice, fieldTypeLabel, formDocument, formFromRecord, groupLabel, humanize, idsOf, isId, isPlainFieldType, isSignatureField, keyFor, laneFor, memberName, parityTypesWithNoExplanation, personActor, personRecordForMember, pointsAtRecords, recordName, recordsDataSource, renderValue, rowName, scalarText, shareUnavailableReason, storeDecidesRights, submissionStamp, tableName, tokenFor, useCanShare, useEmbedHandshake, useGridEditing, useRecordLabels, useRecordsUi, useSystemTable, useTableRights, useViewRecords, viewDocument, viewFromRecord, viewPatchDocument };

package/dist/index.d.ts

@@ -188,6 +188,41 @@ interface RecordsUiHost {
      * queue that silently died with the tab is the failure this exists to avoid.
      */
     captureQueue?: CaptureQueuePort;
+    /**
+     * OPTIONAL. THE HOST'S OWN SHARE DIALOG (SCR-N-5).
+     *
+     * This package ships no share dialog, ON PURPOSE, and for the same reason it
+     * ships no chat: AI Matrx has exactly ONE sharing surface — matrx-frontend's
+     * `features/sharing` ShareModal, with its people picker, its level picker, its
+     * grant list and its "who can see this, and why" panel — and a second one here
+     * would be a parallel sharing UI within a month. Sharing is the access model's
+     * front door, and two front doors is how a platform ends up with two answers
+     * to "who can see this".
+     *
+     * So `ShareControl` draws the BUTTON (which belongs on the record and table
+     * screens, beside everything else a person does to a thing) and hands the
+     * subject to this port, which returns the host's own dialog.
+     *
+     * Unbound, the button is ABSENT and `NO_SHARE_REASON` says which port to bind.
+     * Never a Share button that opens nothing.
+     */
+    share?: (subject: ShareSubject) => ReactNode;
+}
+/**
+ * What a host's share dialog is being opened ON. A Table is a record in this
+ * store (a `custom.record` row whose table is the Table kernel), so ONE subject
+ * shape covers both screens and `kind` is what the sentences say, not what the
+ * store looks up.
+ */
+interface ShareSubject {
+    kind: "record" | "table";
+    /** The store is keyed (organization_id, id); this package never guesses one. */
+    organizationId: Uuid$1;
+    subjectId: Uuid$1;
+    /** What to call it on screen. Never empty — the id's first eight characters at worst. */
+    name: string;
+    /** Close the dialog. The control owns the open/closed state, the host owns the dialog. */
+    onClose: () => void;
 }
 /** One member of the organization, in the words a person reads. */
 interface OrganizationMember {
@@ -223,6 +258,8 @@ interface PendingCapture {
 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 shown when no share dialog is bound. */
+declare const NO_SHARE_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 }: {
@@ -431,15 +468,19 @@ interface CustomFieldsSectionProps {
 }
 declare function CustomFieldsSection({ tableId, entityToken, recordId, title, className, }: CustomFieldsSectionProps): react.JSX.Element | null;
 
+/** `Day rate` → `day_rate`. Shown, so nothing about it is a surprise. */
+declare function keyFor(label: string): string;
 interface FieldEditorProps {
     tableId: Uuid$1;
     /** The Field being edited. Absent means a new one. */
     field?: Field | undefined;
     onSaved?: (() => void) | undefined;
     onCancel?: (() => void) | undefined;
+    /** Called after the store has accepted the removal, so the list can re-read. */
+    onRemoved?: (() => void) | undefined;
     className?: string | undefined;
 }
-declare function FieldEditor({ tableId, field, onSaved, onCancel, className }: FieldEditorProps): react.JSX.Element;
+declare function FieldEditor({ tableId, field, onSaved, onCancel, onRemoved, className }: FieldEditorProps): react.JSX.Element;
 
 interface FieldProposalRow {
     id: string;
@@ -463,9 +504,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;
@@ -518,16 +564,57 @@ declare function RecordChip({ title, onRemove, className, }: {
     className?: string | undefined;
 }): react.JSX.Element;
 
+/** Answers "what is the record with this id called", for one Field's values. */
+type LabelLookup = (field: Field$1, id: string) => string | null;
+/** Which ids a Field's stored value refers to. */
+declare function idsOf(value: unknown): string[];
+declare function isId(value: unknown): boolean;
+/** True when this Field's values are ids of other records rather than values. */
+declare function pointsAtRecords(field: Field$1): boolean;
+declare function RecordLabelProvider({ children }: {
+    children: ReactNode;
+}): react.JSX.Element;
+/**
+ * The hook a surface uses: it declares the Fields it is about to draw, and gets
+ * back the lookup. Declaring is what makes one request per Field instead of one
+ * per cell, and it is why a grid of 200 rows asks the store twice.
+ */
+declare function useRecordLabels(fields: readonly Field$1[] | undefined): LabelLookup;
+
 /** 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, 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, value: unknown): string;
+declare function renderValue(field: Field, value: unknown, document?: RecordDocument, labels?: LabelLookup): react.JSX.Element;
+/**
+ * The text of one scalar, with the Field's UNIT and FORMAT applied — FLD-N-1
+ * says both change the MEANING — and with an id resolved to the NAME of the
+ * record it points at.
+ *
+ * `labels` is the resolver from `RecordLabelProvider`. Without it, an id is
+ * drawn as "Loading…" and never as itself: a 36-character identifier in a cell
+ * reads like a value, and the 19 September verdict found it in choice cells,
+ * relation cells and as every Kanban column heading.
+ */
+declare function scalarText(field: Field, value: unknown, labels?: LabelLookup): 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;
     fieldKey: string;
 }): react.JSX.Element | null;
+/**
+ * THE VALUE, AS A COMPONENT, so a cell can resolve the ids it holds.
+ *
+ * `renderValue` is a plain function called from inside a column's `cell`
+ * callback and from a dozen other places; a function cannot ask the resolver
+ * for a name, because asking is a hook. Every read-only surface therefore draws
+ * through this instead, and the one that needs the raw function (a plain-text
+ * export, a chat line) keeps calling `renderValue` with no resolver and says
+ * "Loading…" rather than printing an id.
+ */
+declare function RecordValue({ field, value, document, }: {
+    field: Field;
+    value: unknown;
+    document?: RecordDocument | undefined;
+}): react.JSX.Element;
 
 declare const PARITY_LABEL: Record<ParityFieldType, string>;
 /** The "made of" sentence the store itself publishes, for the field editor's help text. */
@@ -541,9 +628,40 @@ type EditorKind = ParityFieldType | "relation" | "text" | "number" | "boolean" |
  * value would draw a different editor for an empty record.
  */
 declare function editorKindFor(field: Field): EditorKind;
-/** The type word a person sees in a header or a settings row. */
+/**
+ * The type word a person sees in a header or a settings row — and it is the
+ * SAME word the field panel offers, read from `FIELD_TYPE_CHOICES`, so a column
+ * added as "Money" is never described anywhere else as "Currency".
+ */
 declare function fieldTypeLabel(field: Field): string;
 
+/** 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;
+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. */
+    group: "Words" | "Numbers and dates" | "Choices and people" | "Worked out";
+}
+declare const FIELD_TYPE_CHOICES: FieldTypeChoice[];
+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 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.
+ */
+declare function parityTypesWithNoExplanation(): string[];
+
 /** One Field of a package-owned Table, in the store's own words. */
 interface SystemFieldSpec {
     key: string;
@@ -579,6 +697,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"];
@@ -1369,6 +1512,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. */
@@ -1380,4 +1535,20 @@ 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, 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 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 };
+interface ShareControlProps {
+    kind: ShareSubject["kind"];
+    organizationId: Uuid$1;
+    subjectId: Uuid$1;
+    /** What to call it in the dialog's title. */
+    name?: string | undefined;
+    size?: "sm" | "default" | undefined;
+    variant?: "ghost" | "outline" | "default" | undefined;
+    className?: string | undefined;
+}
+/** True when a host has bound a share dialog — so a caller can lay out its row. */
+declare function useCanShare(): boolean;
+/** Why there is no Share button here, for anything that asks. */
+declare function shareUnavailableReason(): string;
+declare function ShareControl({ kind, organizationId, subjectId, name, size, variant, className, }: ShareControlProps): ReactNode;
+
+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, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORM_FLOWS, FORM_TABLE, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldLabel, type FieldProposalRow, type FieldTypeChoice, 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, type LabelLookup, NO_CHAT_REASON, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_RIGHTS, NO_SAVED_VIEWS_REASON, NO_SHARE_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, type PickableFieldType, type PlainFieldType, 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, 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, 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, fieldTypeChoice, fieldTypeLabel, formDocument, formFromRecord, groupLabel, humanize, idsOf, isId, isPlainFieldType, isSignatureField, keyFor, laneFor, memberName, parityTypesWithNoExplanation, personActor, personRecordForMember, pointsAtRecords, recordName, recordsDataSource, renderValue, rowName, scalarText, shareUnavailableReason, storeDecidesRights, submissionStamp, tableName, tokenFor, useCanShare, useEmbedHandshake, useGridEditing, useRecordLabels, useRecordsUi, useSystemTable, useTableRights, useViewRecords, viewDocument, viewFromRecord, viewPatchDocument };