@ai-matrx/records-ui 0.7.0 → 0.10.3

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-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 as Uuid$1, Table, Field, RecordDocument, ReadRow, RecordsError, WriteConflict, ParityFieldType, NewFieldDeclaration, ValueEnvelope, 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';
@@ -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 }: {
@@ -310,12 +347,21 @@ 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;
+    /** What has been typed into the open cell. Owned here, never by the cell. */
+    draft: unknown;
+    /** The open cell's editor reports every keystroke to the session. */
+    type: (value: unknown) => void;
     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;
+    /**
+     * Commit the open cell — whatever is in `draft`. `move` opens the
+     * next/previous editable cell after it. It takes NO value: a caller that
+     * passed one would be a second copy of the typed value, which is the defect
+     * this file's header describes.
+     */
+    commit: (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. */
@@ -353,6 +399,9 @@ declare function GridCell({ field, row, editing, canWrite, }: {
     canWrite: boolean;
 }): react.JSX.Element;
 
+declare function hintIsMachineIdentity(hint: string): boolean;
+/** The hint a PERSON should read, or null when the hint is for an engineer. */
+declare function hintForAPerson(hint: string | null | undefined): string | null;
 declare function RefusalNotice({ error, className, actions, }: {
     error: RecordsError;
     className?: string | undefined;
@@ -431,15 +480,69 @@ interface CustomFieldsSectionProps {
 }
 declare function CustomFieldsSection({ tableId, entityToken, recordId, title, className, }: CustomFieldsSectionProps): react.JSX.Element | null;
 
+/** 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[];
+
+/** `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;
+/**
+ * WHAT THE PANEL STILL NEEDS BEFORE THE STORE WOULD TAKE THIS, in plain words.
+ *
+ * It answers exactly the questions this panel asked, so every sentence names a
+ * control the person is looking at. It is NOT a second copy of the store's
+ * rules and it is not allowed to become one: the store decides, and every one
+ * of these is something the panel can see is unanswered without asking it.
+ *
+ * Exported so the suite can assert the sentences without driving the whole
+ * panel, and so the red twin can assert that removing it puts the contract row
+ * id back in front of a person.
+ */
+declare function whatIsMissing(state: {
+    type: PickableFieldType;
+    label: string;
+    options: string[];
+    via: string;
+    pick: string;
+    agg: NonNullable<NewFieldDeclaration["agg"]>;
+    of: string;
+    relations: Field[];
+    formulaFields: string[];
+}): string | null;
 
 interface FieldProposalRow {
     id: string;
@@ -523,16 +626,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. */
@@ -546,7 +690,11 @@ 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;
 
 /** One Field of a package-owned Table, in the store's own words. */
@@ -1422,4 +1570,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 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 };
+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, hintForAPerson, hintIsMachineIdentity, 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, whatIsMissing };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-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 as Uuid$1, Table, Field, RecordDocument, ReadRow, RecordsError, WriteConflict, ParityFieldType, NewFieldDeclaration, ValueEnvelope, 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';
@@ -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 }: {
@@ -310,12 +347,21 @@ 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;
+    /** What has been typed into the open cell. Owned here, never by the cell. */
+    draft: unknown;
+    /** The open cell's editor reports every keystroke to the session. */
+    type: (value: unknown) => void;
     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;
+    /**
+     * Commit the open cell — whatever is in `draft`. `move` opens the
+     * next/previous editable cell after it. It takes NO value: a caller that
+     * passed one would be a second copy of the typed value, which is the defect
+     * this file's header describes.
+     */
+    commit: (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. */
@@ -353,6 +399,9 @@ declare function GridCell({ field, row, editing, canWrite, }: {
     canWrite: boolean;
 }): react.JSX.Element;
 
+declare function hintIsMachineIdentity(hint: string): boolean;
+/** The hint a PERSON should read, or null when the hint is for an engineer. */
+declare function hintForAPerson(hint: string | null | undefined): string | null;
 declare function RefusalNotice({ error, className, actions, }: {
     error: RecordsError;
     className?: string | undefined;
@@ -431,15 +480,69 @@ interface CustomFieldsSectionProps {
 }
 declare function CustomFieldsSection({ tableId, entityToken, recordId, title, className, }: CustomFieldsSectionProps): react.JSX.Element | null;
 
+/** 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[];
+
+/** `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;
+/**
+ * WHAT THE PANEL STILL NEEDS BEFORE THE STORE WOULD TAKE THIS, in plain words.
+ *
+ * It answers exactly the questions this panel asked, so every sentence names a
+ * control the person is looking at. It is NOT a second copy of the store's
+ * rules and it is not allowed to become one: the store decides, and every one
+ * of these is something the panel can see is unanswered without asking it.
+ *
+ * Exported so the suite can assert the sentences without driving the whole
+ * panel, and so the red twin can assert that removing it puts the contract row
+ * id back in front of a person.
+ */
+declare function whatIsMissing(state: {
+    type: PickableFieldType;
+    label: string;
+    options: string[];
+    via: string;
+    pick: string;
+    agg: NonNullable<NewFieldDeclaration["agg"]>;
+    of: string;
+    relations: Field[];
+    formulaFields: string[];
+}): string | null;
 
 interface FieldProposalRow {
     id: string;
@@ -523,16 +626,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. */
@@ -546,7 +690,11 @@ 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;
 
 /** One Field of a package-owned Table, in the store's own words. */
@@ -1422,4 +1570,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 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 };
+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, hintForAPerson, hintIsMachineIdentity, 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, whatIsMissing };