@ai-matrx/records-ui 0.79.0 → 0.82.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, ComponentType, RefObject } from 'react';
 import * as _ai_matrx_records from '@ai-matrx/records';
-import { PermissionLevel, Table, RecordScopeContext, EnrichCell, RecordsError, Uuid as Uuid$1, AggregateFilter, Field, RecordDocument, ReadRow, RelationDisplay, WriteConflict, DeclarableFieldKind, ParityFieldType, NewFieldDeclaration, RuleExpression, ValueEnvelope, ChecklistRequirementKind, ContextPolicy, WorkDueState, FieldSensitivity, StageRuleOnFail, SubscriptionCadence, WorkInboxKind, FieldKind, RecordFilter as RecordFilter$1, ArchiveLane, ArchivedRow, FormSummary, PortalCard, PortalPrincipal, PortalPreviewRow, DashboardBlockKind, AggregateBucket, AggregateMeasure, DashboardBlock, DashboardSummary, DocTemplateRow, DocRenderRow, QuietHours, DashboardBlockResult, ChecklistRunStep, BookingSummary, CaptureSheetFace, CaptureField, AnonTokenBinding, RecordsConfig, RecordsActor, RecordsDataSource, HistoryActor, FieldHistoryEntry, FieldTypeWord } from '@ai-matrx/records';
+import { PermissionLevel, Table, RecordScopeContext, EnrichCell, RecordsError, Uuid as Uuid$1, AggregateFilter, Field, RecordDocument, ReadRow, RelationDisplay, WriteConflict, RecordsErrorCode, DeclarableFieldKind, ParityFieldType, NewFieldDeclaration, RuleExpression, ValueEnvelope, ChecklistRequirementKind, ContextPolicy, WorkDueState, FieldSensitivity, StageRuleOnFail, SubscriptionCadence, WorkInboxKind, FieldKind, RecordFilter as RecordFilter$1, ArchiveLane, ArchivedRow, FormSummary, PortalCard, PortalPrincipal, PortalPreviewRow, DashboardBlockKind, AggregateBucket, AggregateMeasure, DashboardBlock, DashboardSummary, DocTemplateRow, DocRenderRow, QuietHours, DashboardBlockResult, ChecklistRunStep, BookingSummary, CaptureSheetFace, CaptureField, AnonTokenBinding, RecordsConfig, RecordsActor, RecordsDataSource, HistoryActor, FieldHistoryEntry, FieldTypeWord } from '@ai-matrx/records';
 import { Uuid, RecordFilter, Field as Field$1, ReadRow as ReadRow$1 } from '@ai-matrx/records/react';
 import { RecordsClient } from '@ai-matrx/records/core';
 import { FieldFormatConfig } from '@ai-matrx/design-system/field-formats';
@@ -897,10 +897,20 @@ declare function GridCell({ field, row, editing, canWrite, whyNot, format, onAsk
 declare function hintIsMachineIdentity(hint: string): boolean;
 /** The hint a PERSON should read, or null when it is written for an engineer. */
 declare function hintForAPerson(hint: string | null | undefined): string | null;
-declare function RefusalNotice({ error, className, actions, }: {
+declare function RefusalNotice({ error, className, actions, onKeepEditing, onDiscard, }: {
     error: RecordsError;
     className?: string | undefined;
     actions?: ReactNode | undefined;
+    /**
+     * KEEP EDITING / DISCARD (lane REFUSAL-SWEEP, 2026-09-23). Pass these ONLY where
+     * an editor is open holding what the person typed and the refusal is about that
+     * text: the notice then owns the two doors out, so the notice — never a clock —
+     * decides how long the typed text is kept. Keep editing hands the person back
+     * to their text; Discard throws it away and puts back what was there. A surface
+     * with nothing typed to keep passes neither and gets no buttons.
+     */
+    onKeepEditing?: (() => void) | undefined;
+    onDiscard?: (() => void) | undefined;
 }): react.JSX.Element;
 /** A small inline one, for a cell or a field where a block would break the layout. */
 declare function RefusalLine({ error, className }: {
@@ -908,6 +918,34 @@ declare function RefusalLine({ error, className }: {
     className?: string | undefined;
 }): react.JSX.Element;
 
+/**
+ * A refusal in this package's own words.
+ *
+ * @param code     what KIND of refusal — picks the notice's title and its fallback remedy.
+ * @param sentence what happened, for a person.
+ * @param remedy   what to do now, when this call site knows better than the code's default.
+ * @param diagnostic an engineer's note (a thrown message, a status) — rendered out of sight.
+ */
+declare function refusal(code: RecordsErrorCode, sentence: string, remedy?: string | null, diagnostic?: string | null): RecordsError;
+/**
+ * A refusal made from something THROWN in the browser. The thrown text is an
+ * engineer's (a parser's "Unexpected token } in JSON at position 14", a
+ * library's stack) and goes out of sight; the person reads `sentence`.
+ */
+declare function refusalFromThrown(thrown: unknown, sentence: string, remedy?: string | null, code?: RecordsErrorCode): RecordsError;
+/**
+ * The store's refusal when there is one, otherwise this package's own sentence —
+ * for the call sites whose answer MAY carry an error (`res.error?.message ?? "…"`
+ * was the old shape, and it printed the store's message raw).
+ */
+declare function refusalOr(error: RecordsError | null | undefined, code: RecordsErrorCode, sentence: string): RecordsError;
+/**
+ * Whatever a host callback threw, as a refusal: the store's own `RecordsError`
+ * when that is what arrived (it is drawn with its own words and remedy), and
+ * otherwise `refusalFromThrown` — the thrown text out of sight, `sentence` in view.
+ */
+declare function asRefusal(thrown: unknown, sentence: string, remedy?: string | null, code?: RecordsErrorCode): RecordsError;
+
 /**
  * HOW A TABLE LOOKS — colors, formats and the frozen column.
  *
@@ -1166,10 +1204,30 @@ declare function FilePicker({ label, accept, inputLabel, hint, disabled, onFile,
 
 interface ImportWizardProps {
     tableId: Uuid;
+    /**
+     * FIX-12 F2: THE PERSON SAYS WHEN THEY ARE FINISHED WITH AN IMPORT — NOT THE
+     * LAST ROW.
+     *
+     * This used to fire the moment `io_import_finish` answered, and every host
+     * wires it to close the rail. So the screen that finally knew the truth — the
+     * ledger sentence, the refusal list, the columns that went to the inbox — was
+     * unmounted in the same tick it became true. VERIFIER-12 watched a 40-row file
+     * land 28 and refuse 12 and saw NOTHING at all: the whole run fitted inside
+     * one call, so the report existed for less than a paint. A long file only
+     * looked better because the person had time to read the PROGRESS; its report
+     * was destroyed just as fast.
+     *
+     * It is now the "Done" button on the report, and nothing else calls it.
+     */
     onDone?: ((written: number) => void) | undefined;
+    /**
+     * FIX-12 F2: the rows landed. Fired when the run finishes, for a host that
+     * needs to refresh behind the panel — never for closing it.
+     */
+    onWrote?: ((written: number) => void) | undefined;
     className?: string | undefined;
 }
-declare function ImportWizard({ tableId, onDone, className }: ImportWizardProps): react.JSX.Element;
+declare function ImportWizard({ tableId, onDone, onWrote, className }: ImportWizardProps): react.JSX.Element;
 
 interface CustomFieldsSectionProps {
     /** The standard table's registered token (REC-33), e.g. `party`, `crm_deal`. */
@@ -2264,6 +2322,8 @@ interface PortalBuilderProps {
 }
 declare function PortalBuilder({ tableId, portalId, onSaved, onClose, className }: PortalBuilderProps): react.JSX.Element;
 
+/** The sentence when a link named a portal this table is not in. */
+declare const PORTAL_NOT_HERE_LINE: string;
 interface PortalsPanelProps {
     /**
      * The Table whose page this rail is on. THE RAIL IS SCOPED TO IT: it lists
@@ -2287,6 +2347,12 @@ interface PortalsPanelProps {
      * mount that is not standing on a table.
      */
     tableId?: Uuid | undefined;
+    /**
+     * THE PORTAL A LINK NAMED (`?rail=portals&item=<portal>`, lane HUB-FIX). Its
+     * card opens on arrival and is scrolled to. A portal this table is not in is
+     * said out loud, never swapped for another portal.
+     */
+    activePortalId?: Uuid | null | undefined;
     className?: string | undefined;
 }
 /** What a door answered, for a view that never holds a client of its own. */
@@ -2316,7 +2382,7 @@ declare function revokeConsequence(person: PortalPrincipal, portalTitle: string)
  * the screen can say whose eyes these are and be right.
  */
 declare function previewLine(person: PortalPrincipal): string;
-declare function PortalsPanel({ tableId, className }: PortalsPanelProps): react.JSX.Element;
+declare function PortalsPanel({ tableId, activePortalId, className }: PortalsPanelProps): react.JSX.Element;
 interface PortalCardViewProps {
     /** Exactly what `custom.portal_card` answered. */
     card: PortalCard;
@@ -2371,9 +2437,18 @@ declare function DigestScheduler({ tableId, savedViewId, subjectName, filters, o
 
 interface SubscriptionsPanelProps {
     tableId: Uuid;
+    /**
+     * THE DIGEST A LINK NAMED (`?rail=notifications&item=<rule>`, lane HUB-FIX).
+     * The rule is marked and scrolled to. This rail lists the subscriptions of the
+     * person signed in, so a rule that is somebody else's is said out loud as
+     * exactly that — never replaced by one of theirs.
+     */
+    activeRuleId?: Uuid | null | undefined;
     className?: string | undefined;
 }
-declare function SubscriptionsPanel({ tableId, className }: SubscriptionsPanelProps): react.JSX.Element;
+/** The sentence when a link named a digest that is not in this person's list for this table. */
+declare const RULE_NOT_HERE_LINE: string;
+declare function SubscriptionsPanel({ tableId, activeRuleId, className }: SubscriptionsPanelProps): react.JSX.Element;
 
 /** What a person is asking to have made, in the store's own word for it. */
 type BuildableKind = "form" | "booking" | "portal" | "digest";
@@ -2663,9 +2738,18 @@ declare function DashboardCanvas({ tableId, activeDashboardId, filter, className
 
 interface FormsPanelProps {
     tableId: Uuid;
+    /**
+     * THE FORM A LINK NAMED (`?rail=forms&item=<form>`, lane HUB-FIX). The rail
+     * opens ON it: marked and scrolled to, and — for somebody who may build — its
+     * builder open on that form. An id this table has no form by is said out
+     * loud, never swapped for the first form in the list.
+     */
+    activeFormId?: Uuid | null | undefined;
     className?: string | undefined;
 }
-declare function FormsPanel({ tableId, className }: FormsPanelProps): react.JSX.Element;
+/** The sentence when a link named a form this table does not have. */
+declare const FORM_NOT_HERE_LINE: string;
+declare function FormsPanel({ tableId, activeFormId, className }: FormsPanelProps): react.JSX.Element;
 
 /** What the public arm's `onSubmit` answers. A refusal carries the door's words. */
 type FormSubmitOutcome = {
@@ -2675,6 +2759,12 @@ type FormSubmitOutcome = {
 } | {
     ok: false;
     message: string;
+    /**
+     * The store's own refusal, when the arm has one. Drawn by `RefusalNotice`, so
+     * its machine identity is excised and its remedy is shown; an arm that only
+     * has `message` still gets a notice built from it (lane REFUSAL-SWEEP).
+     */
+    error?: RecordsError | undefined;
 };
 interface FormRunnerProps {
     /** The complete spec. An agent wrote it; `FormBuilder` saved it; this runs it. */
@@ -3120,6 +3210,31 @@ interface TablePageProps {
      * `activeGroupField`, and is never written onto the saved view.
      */
     filter?: RecordFilter$1 | null | undefined;
+    /**
+     * WHICH RAIL THE ADDRESS OPENS — `forms`, `bookings`, `checklists`,
+     * `notifications` (also `digests`), `portals`, `settings`, `import`, `inbox`
+     * or `share`, exactly as the host read it out of `?rail=`.
+     *
+     * 🚨 THE DEAD LINK THIS CLOSES (lane HUB-FIX, 2026-09-23; VERIFIER-14 item 2).
+     * The organization hub lists every form, digest, portal and outside share of
+     * an organization, and every one of those rows opened `/data-v2/<table>` —
+     * the table's GRID — because nothing in this page could be addressed below
+     * the layout: the rails were `useState` with no prop and no URL spelling. A
+     * person who clicked "Spring drain-cleaning intake" landed on 400 rows of jobs
+     * and had to find the Forms button, then the form. Same shape as `?view=`: a
+     * word this page does not know is said out loud (`unknownRailLine`), never a
+     * silent grid.
+     *
+     * Absent, the page opens exactly as it did.
+     */
+    activeRail?: string | null | undefined;
+    /**
+     * WHICH THING INSIDE THAT RAIL — the form, the portal or the digest rule the
+     * link named. The rail opens ON it: the form's builder, the portal's card
+     * opened, the rule marked and scrolled to. An id the rail does not hold is
+     * said out loud by the rail, never replaced by its first row.
+     */
+    activeItemId?: Uuid$1 | null | undefined;
     className?: string | undefined;
 }
 /**
@@ -3233,10 +3348,18 @@ declare function surfaceChosen(current: Surface, asking: SurfacePress): boolean;
  * WHAT THE PAGE OPENS SHOWING — one pure function, so the dead link can be shown failing.
  * See `TablePageProps.activeRecordId` for the defect it closes.
  */
-declare function openingRail(activeRecordId: Uuid$1 | null | undefined): {
-    rail: "record" | "none";
+declare function openingRail(activeRecordId: Uuid$1 | null | undefined, activeRail?: string | null | undefined): {
+    rail: "record" | "none" | Exclude<LinkRail, "share">;
     record: Uuid$1 | null;
 };
+/** The rails a link may open, plus `share`, which opens the share dialog over the page. */
+type LinkRail = "forms" | "bookings" | "checklists" | "notifications" | "portals" | "settings" | "import" | "inbox" | "share";
+/** What a `?rail=` value means, or `null` when it means nothing here. */
+declare function railFromParam(raw: string | null | undefined): LinkRail | null;
+/** The sentence a link that named a rail nobody has says. Never silent. */
+declare function unknownRailLine(raw: string): string;
+/** The sentence when the link asked for the share dialog and this person may not share. */
+declare const SHARE_NOT_YOURS_LINE: string;
 /**
  * WHICH VIEW A LINK OPENS — one pure function, so the dead link can be shown
  * failing. See `TablePageProps.activeView` for the defect it closes.
@@ -3258,7 +3381,7 @@ declare function openingView(activeView: string | null | undefined, activeDashbo
     layout: ViewLayout | null;
     unknown: string | null;
 };
-declare function TablePage({ tableId, pageSize, seedViews, onLeave, leaveLabel, activeDashboardId, activeRecordId, activeView, onViewChanged, activeGroupField, cameFrom, filter, className, }: TablePageProps): react.JSX.Element;
+declare function TablePage({ tableId, pageSize, seedViews, onLeave, leaveLabel, activeDashboardId, activeRecordId, activeView, onViewChanged, activeGroupField, cameFrom, filter, activeRail, activeItemId, className, }: TablePageProps): react.JSX.Element;
 
 /** What the roster can tell us about a user id. `null` when it cannot. */
 type ResolveName = (userId: Uuid$1) => string | null;
@@ -3412,6 +3535,12 @@ interface ShareControlProps {
      * assumption, which is the whole of this lane.
      */
     may?: boolean | undefined;
+    /**
+     * OPEN THE DIALOG ON ARRIVAL — a link (`?rail=share`) named this share, so the
+     * page opens on it rather than making the person find the button. It still
+     * opens only for somebody who may share; the caller says why when not.
+     */
+    initiallyOpen?: boolean | undefined;
     size?: "sm" | "default" | undefined;
     variant?: "ghost" | "outline" | "default" | undefined;
     className?: string | undefined;
@@ -3420,7 +3549,7 @@ interface ShareControlProps {
 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, may, size, variant, className, }: ShareControlProps): ReactNode;
+declare function ShareControl({ kind, organizationId, subjectId, name, may, initiallyOpen, size, variant, className, }: ShareControlProps): ReactNode;
 
 interface PipelineBoardProps {
     tableId: Uuid;
@@ -3436,4 +3565,4 @@ interface PipelineBoardProps {
 }
 declare function PipelineBoard({ tableId, rows, measure, onMeasureChange, onOpenRecord, onMoved, className, }: PipelineBoardProps): react.JSX.Element;
 
-export { ABSENCE_WORD_LABEL, ABSENCE_WORD_VALUES, ACTION_KINDS, ARCHIVED_NEVER_DESTROYED, ARCHIVE_MEANS, type AbsenceWord, ActionInbox, type ActionInboxProps, type ActionKind, type AgentBuildAsk, ArchivedDisclosure, type ArchivedDisclosureProps, ArchivedPortals, type ArchivedPortalsProps, ArchivedView, type ArchivedViewProps, BOOKING_PAGE_STATE_LABEL, BOOKING_PAGE_STATE_VALUES, BookingBuilder, type BookingBuilderProps, type BookingPageState, BookingSlots, type BookingSlotsProps, BuildOrAsk, type BuildOrAskProps, type BuildableKind, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_REQUIREMENT_KINDS, CHECKLIST_REQUIREMENT_LABEL, CONDITION_OPS, CONTEXT_POLICY_LABEL, type Capability, type CaptureMode, type CaptureQueuePort, CaptureRun, type CaptureRunProps, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartConfig, ChartFrame, type ChartKind, ChartLegendContent, type ChartSpec, ChartTooltipContent, ChecklistRunner, type ChecklistRunnerProps, ChecklistTemplateEditor, ChecklistsPanel, type ChecklistsPanelProps, CommentThread, type CommentThreadProps, type ConditionField, ConditionGroup, type ConditionGroupProps, ConditionRow, type ConditionRowProps, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DUE_STATE_LABEL, DashboardCanvas, type DashboardCanvasProps, type DeclareResult, DigestScheduler, type DigestSchedulerProps, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, ENGINEER_TEXT, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, EnrichBadge, type EnrichBadgeProps, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FIELD_RULE_KIND_LABEL, FIELD_RULE_KIND_VALUES, FIELD_SENSITIVITY_LABEL, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORMULA_OP_JOINS, FORMULA_OP_LABEL, FORMULA_OP_VALUES, FORM_FLOWS, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldHistoryPanel, type FieldHistoryPanelProps, FieldLabel, type FieldProposalRow, type FieldRuleKindValue, type FieldTypeChoice, FilePicker, type FilePickerProps, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, type FormulaOp, Grid, GridCell, type GridEditing, type GridGrouping, type GridPresentation, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, type LabelLookup, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, type MainView, MyChecklistSteps, NEEDS_A_SENTENCE, NOT_ANSWERED_YET, NOT_DRAWN_HERE, NO_AGENT_PORT, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_RULES_YET, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PAGE_VIEWS, PAGE_VIEW_LABEL, PARITY_LABEL, PARITY_MADE_OF, PROPOSED_CHANGE_ACT_LABEL, PROPOSED_CHANGE_ACT_VALUES, type PageView, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalBuilder, type PortalBuilderProps, PortalCardView, type PortalCardViewProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, type ProposedChangeAct, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, ROLLUP_AGG_LABEL, ROLLUP_AGG_VALUES, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, ReferenceBuilder, type ReferenceBuilderProps, type ReferenceChoice, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, type ResolveName, type RollupAgg, SAVED_VIEWS_UNAVAILABLE, SAY_WHAT_YOU_ARE_WAITING_FOR_AFTER_MS, SERIES_COLORS, SOMEBODY, STAGE_RULE_ON_FAIL_LABEL, STORE_ANSWERS_THESE, STORE_DECIDES_REASON, SUBSCRIPTION_CADENCES, SUBSCRIPTION_CADENCE_LABEL, SUBSCRIPTION_CHANNEL_LABEL, SUBSCRIPTION_CHANNEL_VALUES, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, StageRulesSection, type StageRulesSectionProps, StepRow, type SubscriptionChannel, SubscriptionsPanel, type SubscriptionsPanelProps, type Surface, type SurfacePress, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, THE_SYSTEM, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, WITHHELD_RECORD_LABEL, WORK_DUE_STATES, WORK_INBOX_KINDS, WORK_INBOX_KIND_LABEL, type WhatYouMayDo, type WhoChanged, WhoChangedSource, actorBadge, actorWords, addFields, archivedRowLine, askableFields, blockFromSpec, bodyForReading, bodyFromKeys, cameFromLine, cellState, chooseSurface, colorFromTheValue, columnForField, conditionInWords, conditionIsDrawable, conditionIsSimple, conditionValue, controlFor, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldDeclarationFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupLabel, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isEngineerText, isId, isMachineIdentity, isParityFieldType, isPlainFieldType, isRelationFieldType, isSignatureField, keyFor, kindsWithNoChoice, laneFor, lastChangeSentence, looksLikeId, machineIdentityIn, mayNotRestoreLine, memberName, nextInWords, openingRail, openingView, pageViewFromParam, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, previewWords, publiclyAnswerable, recordName, recordNameIn, recordsDataSource, refusalForAPerson, refusalLineForAPerson, renderValue, revokeConsequence, rowName, rowNameIn, scalarText, shareUnavailableReason, specFromBlock, storeDecidesRights, submissionStamp, surfaceChosen, tableName, tableRightsAt, tokenFor, unknownViewLine, useCanShare, useEmbedHandshake, useEnrichCells, useGridEditing, useLabelWait, useMeasuredWidth, useMyChecklistSteps, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, useWhoChanged, viewDocument, viewFromRecord, viewPatchDocument, whatIsMissing, whatYouMayDo, whatYouMayDoWithTable, whenWords, whyNotAskable };
+export { ABSENCE_WORD_LABEL, ABSENCE_WORD_VALUES, ACTION_KINDS, ARCHIVED_NEVER_DESTROYED, ARCHIVE_MEANS, type AbsenceWord, ActionInbox, type ActionInboxProps, type ActionKind, type AgentBuildAsk, ArchivedDisclosure, type ArchivedDisclosureProps, ArchivedPortals, type ArchivedPortalsProps, ArchivedView, type ArchivedViewProps, BOOKING_PAGE_STATE_LABEL, BOOKING_PAGE_STATE_VALUES, BookingBuilder, type BookingBuilderProps, type BookingPageState, BookingSlots, type BookingSlotsProps, BuildOrAsk, type BuildOrAskProps, type BuildableKind, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_REQUIREMENT_KINDS, CHECKLIST_REQUIREMENT_LABEL, CONDITION_OPS, CONTEXT_POLICY_LABEL, type Capability, type CaptureMode, type CaptureQueuePort, CaptureRun, type CaptureRunProps, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartConfig, ChartFrame, type ChartKind, ChartLegendContent, type ChartSpec, ChartTooltipContent, ChecklistRunner, type ChecklistRunnerProps, ChecklistTemplateEditor, ChecklistsPanel, type ChecklistsPanelProps, CommentThread, type CommentThreadProps, type ConditionField, ConditionGroup, type ConditionGroupProps, ConditionRow, type ConditionRowProps, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DUE_STATE_LABEL, DashboardCanvas, type DashboardCanvasProps, type DeclareResult, DigestScheduler, type DigestSchedulerProps, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, ENGINEER_TEXT, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, EnrichBadge, type EnrichBadgeProps, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FIELD_RULE_KIND_LABEL, FIELD_RULE_KIND_VALUES, FIELD_SENSITIVITY_LABEL, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORMULA_OP_JOINS, FORMULA_OP_LABEL, FORMULA_OP_VALUES, FORM_FLOWS, FORM_NOT_HERE_LINE, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldHistoryPanel, type FieldHistoryPanelProps, FieldLabel, type FieldProposalRow, type FieldRuleKindValue, type FieldTypeChoice, FilePicker, type FilePickerProps, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, type FormulaOp, Grid, GridCell, type GridEditing, type GridGrouping, type GridPresentation, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, type LabelLookup, type LinkRail, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, type MainView, MyChecklistSteps, NEEDS_A_SENTENCE, NOT_ANSWERED_YET, NOT_DRAWN_HERE, NO_AGENT_PORT, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_RULES_YET, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PAGE_VIEWS, PAGE_VIEW_LABEL, PARITY_LABEL, PARITY_MADE_OF, PORTAL_NOT_HERE_LINE, PROPOSED_CHANGE_ACT_LABEL, PROPOSED_CHANGE_ACT_VALUES, type PageView, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalBuilder, type PortalBuilderProps, PortalCardView, type PortalCardViewProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, type ProposedChangeAct, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, ROLLUP_AGG_LABEL, ROLLUP_AGG_VALUES, RULE_NOT_HERE_LINE, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, ReferenceBuilder, type ReferenceBuilderProps, type ReferenceChoice, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, type ResolveName, type RollupAgg, SAVED_VIEWS_UNAVAILABLE, SAY_WHAT_YOU_ARE_WAITING_FOR_AFTER_MS, SERIES_COLORS, SHARE_NOT_YOURS_LINE, SOMEBODY, STAGE_RULE_ON_FAIL_LABEL, STORE_ANSWERS_THESE, STORE_DECIDES_REASON, SUBSCRIPTION_CADENCES, SUBSCRIPTION_CADENCE_LABEL, SUBSCRIPTION_CHANNEL_LABEL, SUBSCRIPTION_CHANNEL_VALUES, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, StageRulesSection, type StageRulesSectionProps, StepRow, type SubscriptionChannel, SubscriptionsPanel, type SubscriptionsPanelProps, type Surface, type SurfacePress, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, THE_SYSTEM, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, WITHHELD_RECORD_LABEL, WORK_DUE_STATES, WORK_INBOX_KINDS, WORK_INBOX_KIND_LABEL, type WhatYouMayDo, type WhoChanged, WhoChangedSource, actorBadge, actorWords, addFields, archivedRowLine, asRefusal, askableFields, blockFromSpec, bodyForReading, bodyFromKeys, cameFromLine, cellState, chooseSurface, colorFromTheValue, columnForField, conditionInWords, conditionIsDrawable, conditionIsSimple, conditionValue, controlFor, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldDeclarationFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupLabel, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isEngineerText, isId, isMachineIdentity, isParityFieldType, isPlainFieldType, isRelationFieldType, isSignatureField, keyFor, kindsWithNoChoice, laneFor, lastChangeSentence, looksLikeId, machineIdentityIn, mayNotRestoreLine, memberName, nextInWords, openingRail, openingView, pageViewFromParam, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, previewWords, publiclyAnswerable, railFromParam, recordName, recordNameIn, recordsDataSource, refusal, refusalForAPerson, refusalFromThrown, refusalLineForAPerson, refusalOr, renderValue, revokeConsequence, rowName, rowNameIn, scalarText, shareUnavailableReason, specFromBlock, storeDecidesRights, submissionStamp, surfaceChosen, tableName, tableRightsAt, tokenFor, unknownRailLine, unknownViewLine, useCanShare, useEmbedHandshake, useEnrichCells, useGridEditing, useLabelWait, useMeasuredWidth, useMyChecklistSteps, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, useWhoChanged, viewDocument, viewFromRecord, viewPatchDocument, whatIsMissing, whatYouMayDo, whatYouMayDoWithTable, whenWords, whyNotAskable };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, ComponentType, RefObject } from 'react';
 import * as _ai_matrx_records from '@ai-matrx/records';
-import { PermissionLevel, Table, RecordScopeContext, EnrichCell, RecordsError, Uuid as Uuid$1, AggregateFilter, Field, RecordDocument, ReadRow, RelationDisplay, WriteConflict, DeclarableFieldKind, ParityFieldType, NewFieldDeclaration, RuleExpression, ValueEnvelope, ChecklistRequirementKind, ContextPolicy, WorkDueState, FieldSensitivity, StageRuleOnFail, SubscriptionCadence, WorkInboxKind, FieldKind, RecordFilter as RecordFilter$1, ArchiveLane, ArchivedRow, FormSummary, PortalCard, PortalPrincipal, PortalPreviewRow, DashboardBlockKind, AggregateBucket, AggregateMeasure, DashboardBlock, DashboardSummary, DocTemplateRow, DocRenderRow, QuietHours, DashboardBlockResult, ChecklistRunStep, BookingSummary, CaptureSheetFace, CaptureField, AnonTokenBinding, RecordsConfig, RecordsActor, RecordsDataSource, HistoryActor, FieldHistoryEntry, FieldTypeWord } from '@ai-matrx/records';
+import { PermissionLevel, Table, RecordScopeContext, EnrichCell, RecordsError, Uuid as Uuid$1, AggregateFilter, Field, RecordDocument, ReadRow, RelationDisplay, WriteConflict, RecordsErrorCode, DeclarableFieldKind, ParityFieldType, NewFieldDeclaration, RuleExpression, ValueEnvelope, ChecklistRequirementKind, ContextPolicy, WorkDueState, FieldSensitivity, StageRuleOnFail, SubscriptionCadence, WorkInboxKind, FieldKind, RecordFilter as RecordFilter$1, ArchiveLane, ArchivedRow, FormSummary, PortalCard, PortalPrincipal, PortalPreviewRow, DashboardBlockKind, AggregateBucket, AggregateMeasure, DashboardBlock, DashboardSummary, DocTemplateRow, DocRenderRow, QuietHours, DashboardBlockResult, ChecklistRunStep, BookingSummary, CaptureSheetFace, CaptureField, AnonTokenBinding, RecordsConfig, RecordsActor, RecordsDataSource, HistoryActor, FieldHistoryEntry, FieldTypeWord } from '@ai-matrx/records';
 import { Uuid, RecordFilter, Field as Field$1, ReadRow as ReadRow$1 } from '@ai-matrx/records/react';
 import { RecordsClient } from '@ai-matrx/records/core';
 import { FieldFormatConfig } from '@ai-matrx/design-system/field-formats';
@@ -897,10 +897,20 @@ declare function GridCell({ field, row, editing, canWrite, whyNot, format, onAsk
 declare function hintIsMachineIdentity(hint: string): boolean;
 /** The hint a PERSON should read, or null when it is written for an engineer. */
 declare function hintForAPerson(hint: string | null | undefined): string | null;
-declare function RefusalNotice({ error, className, actions, }: {
+declare function RefusalNotice({ error, className, actions, onKeepEditing, onDiscard, }: {
     error: RecordsError;
     className?: string | undefined;
     actions?: ReactNode | undefined;
+    /**
+     * KEEP EDITING / DISCARD (lane REFUSAL-SWEEP, 2026-09-23). Pass these ONLY where
+     * an editor is open holding what the person typed and the refusal is about that
+     * text: the notice then owns the two doors out, so the notice — never a clock —
+     * decides how long the typed text is kept. Keep editing hands the person back
+     * to their text; Discard throws it away and puts back what was there. A surface
+     * with nothing typed to keep passes neither and gets no buttons.
+     */
+    onKeepEditing?: (() => void) | undefined;
+    onDiscard?: (() => void) | undefined;
 }): react.JSX.Element;
 /** A small inline one, for a cell or a field where a block would break the layout. */
 declare function RefusalLine({ error, className }: {
@@ -908,6 +918,34 @@ declare function RefusalLine({ error, className }: {
     className?: string | undefined;
 }): react.JSX.Element;
 
+/**
+ * A refusal in this package's own words.
+ *
+ * @param code     what KIND of refusal — picks the notice's title and its fallback remedy.
+ * @param sentence what happened, for a person.
+ * @param remedy   what to do now, when this call site knows better than the code's default.
+ * @param diagnostic an engineer's note (a thrown message, a status) — rendered out of sight.
+ */
+declare function refusal(code: RecordsErrorCode, sentence: string, remedy?: string | null, diagnostic?: string | null): RecordsError;
+/**
+ * A refusal made from something THROWN in the browser. The thrown text is an
+ * engineer's (a parser's "Unexpected token } in JSON at position 14", a
+ * library's stack) and goes out of sight; the person reads `sentence`.
+ */
+declare function refusalFromThrown(thrown: unknown, sentence: string, remedy?: string | null, code?: RecordsErrorCode): RecordsError;
+/**
+ * The store's refusal when there is one, otherwise this package's own sentence —
+ * for the call sites whose answer MAY carry an error (`res.error?.message ?? "…"`
+ * was the old shape, and it printed the store's message raw).
+ */
+declare function refusalOr(error: RecordsError | null | undefined, code: RecordsErrorCode, sentence: string): RecordsError;
+/**
+ * Whatever a host callback threw, as a refusal: the store's own `RecordsError`
+ * when that is what arrived (it is drawn with its own words and remedy), and
+ * otherwise `refusalFromThrown` — the thrown text out of sight, `sentence` in view.
+ */
+declare function asRefusal(thrown: unknown, sentence: string, remedy?: string | null, code?: RecordsErrorCode): RecordsError;
+
 /**
  * HOW A TABLE LOOKS — colors, formats and the frozen column.
  *
@@ -1166,10 +1204,30 @@ declare function FilePicker({ label, accept, inputLabel, hint, disabled, onFile,
 
 interface ImportWizardProps {
     tableId: Uuid;
+    /**
+     * FIX-12 F2: THE PERSON SAYS WHEN THEY ARE FINISHED WITH AN IMPORT — NOT THE
+     * LAST ROW.
+     *
+     * This used to fire the moment `io_import_finish` answered, and every host
+     * wires it to close the rail. So the screen that finally knew the truth — the
+     * ledger sentence, the refusal list, the columns that went to the inbox — was
+     * unmounted in the same tick it became true. VERIFIER-12 watched a 40-row file
+     * land 28 and refuse 12 and saw NOTHING at all: the whole run fitted inside
+     * one call, so the report existed for less than a paint. A long file only
+     * looked better because the person had time to read the PROGRESS; its report
+     * was destroyed just as fast.
+     *
+     * It is now the "Done" button on the report, and nothing else calls it.
+     */
     onDone?: ((written: number) => void) | undefined;
+    /**
+     * FIX-12 F2: the rows landed. Fired when the run finishes, for a host that
+     * needs to refresh behind the panel — never for closing it.
+     */
+    onWrote?: ((written: number) => void) | undefined;
     className?: string | undefined;
 }
-declare function ImportWizard({ tableId, onDone, className }: ImportWizardProps): react.JSX.Element;
+declare function ImportWizard({ tableId, onDone, onWrote, className }: ImportWizardProps): react.JSX.Element;
 
 interface CustomFieldsSectionProps {
     /** The standard table's registered token (REC-33), e.g. `party`, `crm_deal`. */
@@ -2264,6 +2322,8 @@ interface PortalBuilderProps {
 }
 declare function PortalBuilder({ tableId, portalId, onSaved, onClose, className }: PortalBuilderProps): react.JSX.Element;
 
+/** The sentence when a link named a portal this table is not in. */
+declare const PORTAL_NOT_HERE_LINE: string;
 interface PortalsPanelProps {
     /**
      * The Table whose page this rail is on. THE RAIL IS SCOPED TO IT: it lists
@@ -2287,6 +2347,12 @@ interface PortalsPanelProps {
      * mount that is not standing on a table.
      */
     tableId?: Uuid | undefined;
+    /**
+     * THE PORTAL A LINK NAMED (`?rail=portals&item=<portal>`, lane HUB-FIX). Its
+     * card opens on arrival and is scrolled to. A portal this table is not in is
+     * said out loud, never swapped for another portal.
+     */
+    activePortalId?: Uuid | null | undefined;
     className?: string | undefined;
 }
 /** What a door answered, for a view that never holds a client of its own. */
@@ -2316,7 +2382,7 @@ declare function revokeConsequence(person: PortalPrincipal, portalTitle: string)
  * the screen can say whose eyes these are and be right.
  */
 declare function previewLine(person: PortalPrincipal): string;
-declare function PortalsPanel({ tableId, className }: PortalsPanelProps): react.JSX.Element;
+declare function PortalsPanel({ tableId, activePortalId, className }: PortalsPanelProps): react.JSX.Element;
 interface PortalCardViewProps {
     /** Exactly what `custom.portal_card` answered. */
     card: PortalCard;
@@ -2371,9 +2437,18 @@ declare function DigestScheduler({ tableId, savedViewId, subjectName, filters, o
 
 interface SubscriptionsPanelProps {
     tableId: Uuid;
+    /**
+     * THE DIGEST A LINK NAMED (`?rail=notifications&item=<rule>`, lane HUB-FIX).
+     * The rule is marked and scrolled to. This rail lists the subscriptions of the
+     * person signed in, so a rule that is somebody else's is said out loud as
+     * exactly that — never replaced by one of theirs.
+     */
+    activeRuleId?: Uuid | null | undefined;
     className?: string | undefined;
 }
-declare function SubscriptionsPanel({ tableId, className }: SubscriptionsPanelProps): react.JSX.Element;
+/** The sentence when a link named a digest that is not in this person's list for this table. */
+declare const RULE_NOT_HERE_LINE: string;
+declare function SubscriptionsPanel({ tableId, activeRuleId, className }: SubscriptionsPanelProps): react.JSX.Element;
 
 /** What a person is asking to have made, in the store's own word for it. */
 type BuildableKind = "form" | "booking" | "portal" | "digest";
@@ -2663,9 +2738,18 @@ declare function DashboardCanvas({ tableId, activeDashboardId, filter, className
 
 interface FormsPanelProps {
     tableId: Uuid;
+    /**
+     * THE FORM A LINK NAMED (`?rail=forms&item=<form>`, lane HUB-FIX). The rail
+     * opens ON it: marked and scrolled to, and — for somebody who may build — its
+     * builder open on that form. An id this table has no form by is said out
+     * loud, never swapped for the first form in the list.
+     */
+    activeFormId?: Uuid | null | undefined;
     className?: string | undefined;
 }
-declare function FormsPanel({ tableId, className }: FormsPanelProps): react.JSX.Element;
+/** The sentence when a link named a form this table does not have. */
+declare const FORM_NOT_HERE_LINE: string;
+declare function FormsPanel({ tableId, activeFormId, className }: FormsPanelProps): react.JSX.Element;
 
 /** What the public arm's `onSubmit` answers. A refusal carries the door's words. */
 type FormSubmitOutcome = {
@@ -2675,6 +2759,12 @@ type FormSubmitOutcome = {
 } | {
     ok: false;
     message: string;
+    /**
+     * The store's own refusal, when the arm has one. Drawn by `RefusalNotice`, so
+     * its machine identity is excised and its remedy is shown; an arm that only
+     * has `message` still gets a notice built from it (lane REFUSAL-SWEEP).
+     */
+    error?: RecordsError | undefined;
 };
 interface FormRunnerProps {
     /** The complete spec. An agent wrote it; `FormBuilder` saved it; this runs it. */
@@ -3120,6 +3210,31 @@ interface TablePageProps {
      * `activeGroupField`, and is never written onto the saved view.
      */
     filter?: RecordFilter$1 | null | undefined;
+    /**
+     * WHICH RAIL THE ADDRESS OPENS — `forms`, `bookings`, `checklists`,
+     * `notifications` (also `digests`), `portals`, `settings`, `import`, `inbox`
+     * or `share`, exactly as the host read it out of `?rail=`.
+     *
+     * 🚨 THE DEAD LINK THIS CLOSES (lane HUB-FIX, 2026-09-23; VERIFIER-14 item 2).
+     * The organization hub lists every form, digest, portal and outside share of
+     * an organization, and every one of those rows opened `/data-v2/<table>` —
+     * the table's GRID — because nothing in this page could be addressed below
+     * the layout: the rails were `useState` with no prop and no URL spelling. A
+     * person who clicked "Spring drain-cleaning intake" landed on 400 rows of jobs
+     * and had to find the Forms button, then the form. Same shape as `?view=`: a
+     * word this page does not know is said out loud (`unknownRailLine`), never a
+     * silent grid.
+     *
+     * Absent, the page opens exactly as it did.
+     */
+    activeRail?: string | null | undefined;
+    /**
+     * WHICH THING INSIDE THAT RAIL — the form, the portal or the digest rule the
+     * link named. The rail opens ON it: the form's builder, the portal's card
+     * opened, the rule marked and scrolled to. An id the rail does not hold is
+     * said out loud by the rail, never replaced by its first row.
+     */
+    activeItemId?: Uuid$1 | null | undefined;
     className?: string | undefined;
 }
 /**
@@ -3233,10 +3348,18 @@ declare function surfaceChosen(current: Surface, asking: SurfacePress): boolean;
  * WHAT THE PAGE OPENS SHOWING — one pure function, so the dead link can be shown failing.
  * See `TablePageProps.activeRecordId` for the defect it closes.
  */
-declare function openingRail(activeRecordId: Uuid$1 | null | undefined): {
-    rail: "record" | "none";
+declare function openingRail(activeRecordId: Uuid$1 | null | undefined, activeRail?: string | null | undefined): {
+    rail: "record" | "none" | Exclude<LinkRail, "share">;
     record: Uuid$1 | null;
 };
+/** The rails a link may open, plus `share`, which opens the share dialog over the page. */
+type LinkRail = "forms" | "bookings" | "checklists" | "notifications" | "portals" | "settings" | "import" | "inbox" | "share";
+/** What a `?rail=` value means, or `null` when it means nothing here. */
+declare function railFromParam(raw: string | null | undefined): LinkRail | null;
+/** The sentence a link that named a rail nobody has says. Never silent. */
+declare function unknownRailLine(raw: string): string;
+/** The sentence when the link asked for the share dialog and this person may not share. */
+declare const SHARE_NOT_YOURS_LINE: string;
 /**
  * WHICH VIEW A LINK OPENS — one pure function, so the dead link can be shown
  * failing. See `TablePageProps.activeView` for the defect it closes.
@@ -3258,7 +3381,7 @@ declare function openingView(activeView: string | null | undefined, activeDashbo
     layout: ViewLayout | null;
     unknown: string | null;
 };
-declare function TablePage({ tableId, pageSize, seedViews, onLeave, leaveLabel, activeDashboardId, activeRecordId, activeView, onViewChanged, activeGroupField, cameFrom, filter, className, }: TablePageProps): react.JSX.Element;
+declare function TablePage({ tableId, pageSize, seedViews, onLeave, leaveLabel, activeDashboardId, activeRecordId, activeView, onViewChanged, activeGroupField, cameFrom, filter, activeRail, activeItemId, className, }: TablePageProps): react.JSX.Element;
 
 /** What the roster can tell us about a user id. `null` when it cannot. */
 type ResolveName = (userId: Uuid$1) => string | null;
@@ -3412,6 +3535,12 @@ interface ShareControlProps {
      * assumption, which is the whole of this lane.
      */
     may?: boolean | undefined;
+    /**
+     * OPEN THE DIALOG ON ARRIVAL — a link (`?rail=share`) named this share, so the
+     * page opens on it rather than making the person find the button. It still
+     * opens only for somebody who may share; the caller says why when not.
+     */
+    initiallyOpen?: boolean | undefined;
     size?: "sm" | "default" | undefined;
     variant?: "ghost" | "outline" | "default" | undefined;
     className?: string | undefined;
@@ -3420,7 +3549,7 @@ interface ShareControlProps {
 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, may, size, variant, className, }: ShareControlProps): ReactNode;
+declare function ShareControl({ kind, organizationId, subjectId, name, may, initiallyOpen, size, variant, className, }: ShareControlProps): ReactNode;
 
 interface PipelineBoardProps {
     tableId: Uuid;
@@ -3436,4 +3565,4 @@ interface PipelineBoardProps {
 }
 declare function PipelineBoard({ tableId, rows, measure, onMeasureChange, onOpenRecord, onMoved, className, }: PipelineBoardProps): react.JSX.Element;
 
-export { ABSENCE_WORD_LABEL, ABSENCE_WORD_VALUES, ACTION_KINDS, ARCHIVED_NEVER_DESTROYED, ARCHIVE_MEANS, type AbsenceWord, ActionInbox, type ActionInboxProps, type ActionKind, type AgentBuildAsk, ArchivedDisclosure, type ArchivedDisclosureProps, ArchivedPortals, type ArchivedPortalsProps, ArchivedView, type ArchivedViewProps, BOOKING_PAGE_STATE_LABEL, BOOKING_PAGE_STATE_VALUES, BookingBuilder, type BookingBuilderProps, type BookingPageState, BookingSlots, type BookingSlotsProps, BuildOrAsk, type BuildOrAskProps, type BuildableKind, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_REQUIREMENT_KINDS, CHECKLIST_REQUIREMENT_LABEL, CONDITION_OPS, CONTEXT_POLICY_LABEL, type Capability, type CaptureMode, type CaptureQueuePort, CaptureRun, type CaptureRunProps, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartConfig, ChartFrame, type ChartKind, ChartLegendContent, type ChartSpec, ChartTooltipContent, ChecklistRunner, type ChecklistRunnerProps, ChecklistTemplateEditor, ChecklistsPanel, type ChecklistsPanelProps, CommentThread, type CommentThreadProps, type ConditionField, ConditionGroup, type ConditionGroupProps, ConditionRow, type ConditionRowProps, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DUE_STATE_LABEL, DashboardCanvas, type DashboardCanvasProps, type DeclareResult, DigestScheduler, type DigestSchedulerProps, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, ENGINEER_TEXT, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, EnrichBadge, type EnrichBadgeProps, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FIELD_RULE_KIND_LABEL, FIELD_RULE_KIND_VALUES, FIELD_SENSITIVITY_LABEL, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORMULA_OP_JOINS, FORMULA_OP_LABEL, FORMULA_OP_VALUES, FORM_FLOWS, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldHistoryPanel, type FieldHistoryPanelProps, FieldLabel, type FieldProposalRow, type FieldRuleKindValue, type FieldTypeChoice, FilePicker, type FilePickerProps, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, type FormulaOp, Grid, GridCell, type GridEditing, type GridGrouping, type GridPresentation, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, type LabelLookup, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, type MainView, MyChecklistSteps, NEEDS_A_SENTENCE, NOT_ANSWERED_YET, NOT_DRAWN_HERE, NO_AGENT_PORT, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_RULES_YET, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PAGE_VIEWS, PAGE_VIEW_LABEL, PARITY_LABEL, PARITY_MADE_OF, PROPOSED_CHANGE_ACT_LABEL, PROPOSED_CHANGE_ACT_VALUES, type PageView, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalBuilder, type PortalBuilderProps, PortalCardView, type PortalCardViewProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, type ProposedChangeAct, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, ROLLUP_AGG_LABEL, ROLLUP_AGG_VALUES, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, ReferenceBuilder, type ReferenceBuilderProps, type ReferenceChoice, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, type ResolveName, type RollupAgg, SAVED_VIEWS_UNAVAILABLE, SAY_WHAT_YOU_ARE_WAITING_FOR_AFTER_MS, SERIES_COLORS, SOMEBODY, STAGE_RULE_ON_FAIL_LABEL, STORE_ANSWERS_THESE, STORE_DECIDES_REASON, SUBSCRIPTION_CADENCES, SUBSCRIPTION_CADENCE_LABEL, SUBSCRIPTION_CHANNEL_LABEL, SUBSCRIPTION_CHANNEL_VALUES, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, StageRulesSection, type StageRulesSectionProps, StepRow, type SubscriptionChannel, SubscriptionsPanel, type SubscriptionsPanelProps, type Surface, type SurfacePress, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, THE_SYSTEM, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, WITHHELD_RECORD_LABEL, WORK_DUE_STATES, WORK_INBOX_KINDS, WORK_INBOX_KIND_LABEL, type WhatYouMayDo, type WhoChanged, WhoChangedSource, actorBadge, actorWords, addFields, archivedRowLine, askableFields, blockFromSpec, bodyForReading, bodyFromKeys, cameFromLine, cellState, chooseSurface, colorFromTheValue, columnForField, conditionInWords, conditionIsDrawable, conditionIsSimple, conditionValue, controlFor, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldDeclarationFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupLabel, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isEngineerText, isId, isMachineIdentity, isParityFieldType, isPlainFieldType, isRelationFieldType, isSignatureField, keyFor, kindsWithNoChoice, laneFor, lastChangeSentence, looksLikeId, machineIdentityIn, mayNotRestoreLine, memberName, nextInWords, openingRail, openingView, pageViewFromParam, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, previewWords, publiclyAnswerable, recordName, recordNameIn, recordsDataSource, refusalForAPerson, refusalLineForAPerson, renderValue, revokeConsequence, rowName, rowNameIn, scalarText, shareUnavailableReason, specFromBlock, storeDecidesRights, submissionStamp, surfaceChosen, tableName, tableRightsAt, tokenFor, unknownViewLine, useCanShare, useEmbedHandshake, useEnrichCells, useGridEditing, useLabelWait, useMeasuredWidth, useMyChecklistSteps, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, useWhoChanged, viewDocument, viewFromRecord, viewPatchDocument, whatIsMissing, whatYouMayDo, whatYouMayDoWithTable, whenWords, whyNotAskable };
+export { ABSENCE_WORD_LABEL, ABSENCE_WORD_VALUES, ACTION_KINDS, ARCHIVED_NEVER_DESTROYED, ARCHIVE_MEANS, type AbsenceWord, ActionInbox, type ActionInboxProps, type ActionKind, type AgentBuildAsk, ArchivedDisclosure, type ArchivedDisclosureProps, ArchivedPortals, type ArchivedPortalsProps, ArchivedView, type ArchivedViewProps, BOOKING_PAGE_STATE_LABEL, BOOKING_PAGE_STATE_VALUES, BookingBuilder, type BookingBuilderProps, type BookingPageState, BookingSlots, type BookingSlotsProps, BuildOrAsk, type BuildOrAskProps, type BuildableKind, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_REQUIREMENT_KINDS, CHECKLIST_REQUIREMENT_LABEL, CONDITION_OPS, CONTEXT_POLICY_LABEL, type Capability, type CaptureMode, type CaptureQueuePort, CaptureRun, type CaptureRunProps, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartConfig, ChartFrame, type ChartKind, ChartLegendContent, type ChartSpec, ChartTooltipContent, ChecklistRunner, type ChecklistRunnerProps, ChecklistTemplateEditor, ChecklistsPanel, type ChecklistsPanelProps, CommentThread, type CommentThreadProps, type ConditionField, ConditionGroup, type ConditionGroupProps, ConditionRow, type ConditionRowProps, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DUE_STATE_LABEL, DashboardCanvas, type DashboardCanvasProps, type DeclareResult, DigestScheduler, type DigestSchedulerProps, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, ENGINEER_TEXT, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, EnrichBadge, type EnrichBadgeProps, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FIELD_RULE_KIND_LABEL, FIELD_RULE_KIND_VALUES, FIELD_SENSITIVITY_LABEL, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORMULA_OP_JOINS, FORMULA_OP_LABEL, FORMULA_OP_VALUES, FORM_FLOWS, FORM_NOT_HERE_LINE, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldHistoryPanel, type FieldHistoryPanelProps, FieldLabel, type FieldProposalRow, type FieldRuleKindValue, type FieldTypeChoice, FilePicker, type FilePickerProps, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, type FormulaOp, Grid, GridCell, type GridEditing, type GridGrouping, type GridPresentation, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, type LabelLookup, type LinkRail, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, type MainView, MyChecklistSteps, NEEDS_A_SENTENCE, NOT_ANSWERED_YET, NOT_DRAWN_HERE, NO_AGENT_PORT, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_RULES_YET, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PAGE_VIEWS, PAGE_VIEW_LABEL, PARITY_LABEL, PARITY_MADE_OF, PORTAL_NOT_HERE_LINE, PROPOSED_CHANGE_ACT_LABEL, PROPOSED_CHANGE_ACT_VALUES, type PageView, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalBuilder, type PortalBuilderProps, PortalCardView, type PortalCardViewProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, type ProposedChangeAct, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, ROLLUP_AGG_LABEL, ROLLUP_AGG_VALUES, RULE_NOT_HERE_LINE, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, ReferenceBuilder, type ReferenceBuilderProps, type ReferenceChoice, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, type ResolveName, type RollupAgg, SAVED_VIEWS_UNAVAILABLE, SAY_WHAT_YOU_ARE_WAITING_FOR_AFTER_MS, SERIES_COLORS, SHARE_NOT_YOURS_LINE, SOMEBODY, STAGE_RULE_ON_FAIL_LABEL, STORE_ANSWERS_THESE, STORE_DECIDES_REASON, SUBSCRIPTION_CADENCES, SUBSCRIPTION_CADENCE_LABEL, SUBSCRIPTION_CHANNEL_LABEL, SUBSCRIPTION_CHANNEL_VALUES, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, StageRulesSection, type StageRulesSectionProps, StepRow, type SubscriptionChannel, SubscriptionsPanel, type SubscriptionsPanelProps, type Surface, type SurfacePress, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, THE_SYSTEM, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, WITHHELD_RECORD_LABEL, WORK_DUE_STATES, WORK_INBOX_KINDS, WORK_INBOX_KIND_LABEL, type WhatYouMayDo, type WhoChanged, WhoChangedSource, actorBadge, actorWords, addFields, archivedRowLine, asRefusal, askableFields, blockFromSpec, bodyForReading, bodyFromKeys, cameFromLine, cellState, chooseSurface, colorFromTheValue, columnForField, conditionInWords, conditionIsDrawable, conditionIsSimple, conditionValue, controlFor, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldDeclarationFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupLabel, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isEngineerText, isId, isMachineIdentity, isParityFieldType, isPlainFieldType, isRelationFieldType, isSignatureField, keyFor, kindsWithNoChoice, laneFor, lastChangeSentence, looksLikeId, machineIdentityIn, mayNotRestoreLine, memberName, nextInWords, openingRail, openingView, pageViewFromParam, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, previewWords, publiclyAnswerable, railFromParam, recordName, recordNameIn, recordsDataSource, refusal, refusalForAPerson, refusalFromThrown, refusalLineForAPerson, refusalOr, renderValue, revokeConsequence, rowName, rowNameIn, scalarText, shareUnavailableReason, specFromBlock, storeDecidesRights, submissionStamp, surfaceChosen, tableName, tableRightsAt, tokenFor, unknownRailLine, unknownViewLine, useCanShare, useEmbedHandshake, useEnrichCells, useGridEditing, useLabelWait, useMeasuredWidth, useMyChecklistSteps, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, useWhoChanged, viewDocument, viewFromRecord, viewPatchDocument, whatIsMissing, whatYouMayDo, whatYouMayDoWithTable, whenWords, whyNotAskable };