@ai-matrx/records-ui 0.71.0 → 0.76.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, ParityFieldType, NewFieldDeclaration, RuleExpression, ValueEnvelope, ChecklistRequirementKind, ContextPolicy, WorkDueState, FieldSensitivity, StageRuleOnFail, SubscriptionCadence, WorkInboxKind, FieldKind, RecordFilter as RecordFilter$1, 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, 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';
@@ -1136,6 +1136,34 @@ interface ExportMenuProps {
 }
 declare function ExportMenu({ tableId, rows, label, className }: ExportMenuProps): react.JSX.Element;
 
+interface FilePickerProps {
+    /** What the button says when nothing is chosen yet. */
+    label: string;
+    /** The `accept` list, exactly as the native input takes it. */
+    accept?: string | undefined;
+    /**
+     * The accessible name of the file input itself, when it must differ from the
+     * button's word — an import screen's input has been called "Choose a file to
+     * import" since it existed, and every automation and screen-reader script
+     * that knows this screen resolves that sentence. A name is a contract.
+     */
+    inputLabel?: string | undefined;
+    /**
+     * One sentence describing a good file — the thing the bare input never said.
+     * Shown under the control, before anything is chosen.
+     */
+    hint?: ReactNode;
+    disabled?: boolean | undefined;
+    /** The chosen file. Called once per choice; re-choosing calls it again. */
+    onFile: (file: File) => void;
+    /** Forget the chosen file and go back to the empty state. */
+    onClear?: (() => void) | undefined;
+    /** The name of the file currently in play, when the owner is holding one. */
+    chosenName?: string | null | undefined;
+    className?: string | undefined;
+}
+declare function FilePicker({ label, accept, inputLabel, hint, disabled, onFile, onClear, chosenName, className, }: FilePickerProps): react.JSX.Element;
+
 interface ImportWizardProps {
     tableId: Uuid;
     onDone?: ((written: number) => void) | undefined;
@@ -1174,8 +1202,25 @@ type PlainFieldType = "text" | "long_text" | "number";
  * directions: it does not appear there, and it cannot hide a real gap there.
  */
 type RelationFieldType = "relation";
-/** What a person picks in the panel: one of the fourteen, one of the three, or a link. */
-type PickableFieldType = ParityFieldType | PlainFieldType | RelationFieldType;
+/**
+ * What a person picks in the panel — AND IT IS THE STORE'S OWN LIST, not a union
+ * assembled here.
+ *
+ * 🚨 THE CLASS FIX (FIX-10B-F6, VERIFIER-10). This used to read
+ * `ParityFieldType | PlainFieldType | RelationFieldType` — the parity floor plus two words
+ * this file knew about — and that union was the whole defect. `custom.doc_sign` accepts
+ * exactly one field, a text column whose format is `signature`, and it is granted to
+ * `authenticated`; the Documents screen told a person in so many words to go and declare
+ * one; and no list any screen could read named it, so the control did not exist and the
+ * e-sign half of Documents was unreachable from the product. A kind the store takes and no
+ * screen offers is invisible, and nothing failed — which is the only reason it survived.
+ *
+ * `custom.field_kinds()` is now the ONE registry and `DECLARABLE_FIELD_KINDS` is generated
+ * from it, so the next kind the store learns arrives here as a TYPE ERROR in
+ * `FIELD_TYPE_CHOICES`'s coverage and as a red `kindsWithNoChoice()` below — never as a
+ * silence.
+ */
+type PickableFieldType = DeclarableFieldKind;
 interface FieldTypeChoice {
     id: PickableFieldType;
     /** The word on the menu. */
@@ -1197,6 +1242,16 @@ declare function isPlainFieldType(id: string): id is PlainFieldType;
  * and not an inline string comparison at four call sites.
  */
 declare function isRelationFieldType(id: string): id is RelationFieldType;
+/**
+ * One of FLD-11's fourteen, which is what `parity_type` on a declaration means.
+ *
+ * Read from the store's own generated floor, never from a list here — because a kind that
+ * is NOT one of the fourteen (plain text, a person-aimed relation, a signature) has to be
+ * declared by its WORD (`type`) and a panel that sent `parity_type` for it would be refused
+ * "There is no field type called …". That is the shape of the F6 defect: the panel's `save`
+ * had exactly two branches, relation and plain, and everything else fell into `parity_type`.
+ */
+declare function isParityFieldType(id: string): id is ParityFieldType;
 /**
  * THE GUARD THIS FILE NEEDS, because the list it explains is generated.
  *
@@ -1209,6 +1264,22 @@ declare function isRelationFieldType(id: string): id is RelationFieldType;
  * list and a behaviour that carries no parity type is not in it.
  */
 declare function parityTypesWithNoExplanation(): string[];
+/**
+ * 🚨 THE GUARD THAT CLOSES THE CLASS (FIX-10B-F6).
+ *
+ * `parityTypesWithNoExplanation()` above watches the parity FLOOR, and the floor was never
+ * the whole list: the store also declares plain text, long text, number, a person-aimed
+ * relation and a signature, and for months nothing anywhere compared the panel's menu with
+ * THAT. So `signature` — the one field `custom.doc_sign` accepts, on a door granted to
+ * every signed-in person, named to the person by the Documents screen itself — was absent
+ * from the menu and every check stayed green.
+ *
+ * This returns the kinds `custom.field_kinds()` publishes that this panel does not offer.
+ * The suite asserts it is empty, so a kind the store learns tomorrow either reaches the
+ * person or turns a test red the same day. It is the class, not the instance: it would have
+ * caught `signature`, and it will catch the twentieth kind nobody has thought of yet.
+ */
+declare function kindsWithNoChoice(): string[];
 
 /** `Day rate` → `day_rate`. Shown, so nothing about it is a surprise. */
 declare function keyFor(label: string): string;
@@ -1772,7 +1843,23 @@ declare const LAYOUT_FIELD_KIND: Record<ViewLayout, "choice" | "date" | null>;
  * dashboard" is one of the ways to look at this table, and a link to it has to
  * work like a link to the board.
  */
-declare const PAGE_VIEWS: readonly ["grid", "kanban", "calendar", "gallery", "dashboards"];
+/**
+ * 🚨 `archived` IS THE SIXTH VALUE, AND IT IS NOT A SPECIAL CASE EITHER (lane
+ * FIX-10A-ARCHIVE, 2026-09-22; VERIFIER-10 F4).
+ *
+ * Archiving a record used to be a ONE-WAY DOOR: the grid's row action soft-
+ * deletes correctly — `deleted_at` set, version bumped, nothing removed — and
+ * then no screen anywhere in the platform could bring it back. The store's
+ * `custom.record_restore` was there the whole time and did exactly the right
+ * thing; nothing reached it, because every read door answers live rows only.
+ *
+ * So the archive is a WAY OF LOOKING AT THIS TABLE, like the board and the
+ * dashboards, reached by the same row of buttons and named by the same
+ * `?view=` parameter — never a Trash area of the app somebody has to know
+ * exists, and never a per-table screen. Every Table inherits it the moment it
+ * is in this list.
+ */
+declare const PAGE_VIEWS: readonly ["grid", "kanban", "calendar", "gallery", "dashboards", "archived"];
 type PageView = (typeof PAGE_VIEWS)[number];
 declare const PAGE_VIEW_LABEL: Record<PageView, string>;
 /**
@@ -1841,11 +1928,91 @@ declare function useViewRecords(view: SavedViewSpec, pageSize?: number, filter?:
     rows: ReadRow$1[];
     loading: boolean;
     error: RecordsError | null;
-    /** Where membership came from, in a sentence. A screen that hides this is hiding the view's meaning. */
+    /**
+     * Where membership came from, in a sentence. A screen that hides this is hiding the
+     * view's meaning — and a screen that says the WRONG one is worse than one that says
+     * nothing at all.
+     *
+     * 🚨 IT SAID "holds the whole table" OVER FOUR OF FORTY-TWO ROWS. Seen on Rincon
+     * Plumbing Co's board the moment a dashboard number could narrow it (lane DRILL,
+     * 2026-09-22): the column read "Scheduled 4", every card under it was real, and the
+     * line above them said this view holds the whole table. The sentence was written when
+     * the only two possibilities were a Rule or everything; a question from the address is
+     * a third, and it gets its own words rather than the nearest wrong one.
+     */
     membership: string;
 };
 declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, onMoved, onNewRecordForm, onAskWhoChanged, pageSize, filter, className, }: ViewSwitcherProps): react.JSX.Element;
 
+/** What the screen says above the list, so nobody has to be told twice that nothing was destroyed. */
+declare const ARCHIVE_MEANS = "Archiving never destroys anything. A record you remove from the grid waits here until somebody brings it back.";
+/** The sentence a person who may not restore reads INSTEAD of a control they cannot use. */
+declare function mayNotRestoreLine(why: string): string;
+/** What one row in the archive says, as one string — pulled out so the guard can read it. */
+declare function archivedRowLine(row: ArchivedRow, titleKey?: string | null): string;
+interface ArchivedViewProps {
+    tableId: Uuid$1;
+    /** Rows per page. The store refuses above its own ceiling by name rather than quietly serving fewer. */
+    pageSize?: number | undefined;
+    /** Which lane the address or the host asked for. Absent, the organization's. */
+    lane?: ArchiveLane | undefined;
+    /** Called when the person switches lane, so the host can put it in the URL. */
+    onLaneChange?: ((lane: ArchiveLane) => void) | undefined;
+    /** Called after a record comes back, so the host re-reads the rows it owns. */
+    onRestored?: ((recordId: Uuid$1) => void) | undefined;
+    className?: string | undefined;
+}
+declare function ArchivedView({ tableId, pageSize, lane: laneFromHost, onLaneChange, onRestored, className, }: ArchivedViewProps): react.JSX.Element;
+
+/** What every archive on this platform promises, said once. */
+declare const ARCHIVED_NEVER_DESTROYED = "Archiving never destroys anything. What you put away waits here until somebody brings it back.";
+interface ArchivedDisclosureProps {
+    /** What is archived, in the plural: "portals", "forms". Drawn as “Archived portals”. */
+    noun: string;
+    /**
+     * How many are archived, when the surface already knows. Absent, the control
+     * still draws — a count nobody has read is not a reason to hide the way in,
+     * and a "(0)" the screen guessed would be a lie.
+     */
+    count?: number | undefined;
+    /** Open on first render — the address asked for the archive. */
+    defaultOpen?: boolean | undefined;
+    /** Told when it opens or closes, so a host can put it in the URL. */
+    onOpenChange?: ((open: boolean) => void) | undefined;
+    children: ReactNode;
+    className?: string | undefined;
+}
+/**
+ * ONE CLICK, ON THE SURFACE ITSELF. Not a tab, not a page, not a filter buried
+ * in a menu: the law says revealing the archived things is one press where you
+ * already are, and this is that press for every rail in this package.
+ */
+declare function ArchivedDisclosure({ noun, count, defaultOpen, onOpenChange, children, className, }: ArchivedDisclosureProps): react.JSX.Element;
+interface ArchivedPortalsProps {
+    /** Called after a portal comes back, so the rail re-reads the list it owns. */
+    onRestored?: ((portalId: Uuid) => void) | undefined;
+    /**
+     * Bumped by the surface above whenever IT changed something that lands here —
+     * archiving a portal from the live rail, most of all. Without it an archive
+     * standing open would keep showing the list it read when it opened, which is
+     * the quiet lie this package refuses everywhere else.
+     */
+    refreshToken?: number | undefined;
+    defaultOpen?: boolean | undefined;
+    className?: string | undefined;
+}
+/**
+ * THE ARCHIVED PORTALS OF THIS ORGANIZATION, AND THE WAY BACK.
+ *
+ * It reads `custom.list_portals(org, 'archived')` — the archive-aware reader the
+ * store grew for exactly this — rather than filtering a list `custom.portals`
+ * already hid. It is organization-wide on purpose, unlike the live rail above
+ * it: a portal is archived precisely because nobody is standing on it any more,
+ * and narrowing the archive to the Table you happen to be on is how an archived
+ * portal becomes unreachable from every page at once.
+ */
+declare function ArchivedPortals({ onRestored, refreshToken, defaultOpen, className, }: ArchivedPortalsProps): react.JSX.Element;
+
 interface ViewBarProps {
     /** The Table whose views these are. */
     tableId: Uuid;
@@ -3003,7 +3170,17 @@ declare const VIEW_NOT_SAVED_YET: string;
  * somewhere else in the product would be a second answer to "how is the work
  * going", reached by knowing where to click.
  */
-type MainView = "records" | "dashboards";
+/**
+ * 🚨 `archived` IS THE THIRD (lane FIX-10A-ARCHIVE, 2026-09-22; VERIFIER-10 F4).
+ * Archiving a record was a ONE-WAY DOOR — the row left the grid and no screen
+ * anywhere could bring it back, although `custom.record_restore` was there the
+ * whole time — because nothing in this package listed archived rows and no read
+ * door could answer them. It belongs HERE, beside the records and the counts of
+ * them, for exactly the reason the dashboards do: to the person, the archive is
+ * one of the ways to look at this table, not a Trash area of the app somebody
+ * has to know exists.
+ */
+type MainView = "records" | "dashboards" | "archived";
 /**
  * WHAT THE PAGE IS SHOWING — the middle and the right-hand panel, as ONE answer.
  *
@@ -3259,4 +3436,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, type AbsenceWord, ActionInbox, type ActionInboxProps, type ActionKind, type AgentBuildAsk, 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, 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, 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, isPlainFieldType, isRelationFieldType, isSignatureField, keyFor, laneFor, lastChangeSentence, looksLikeId, machineIdentityIn, 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, 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 };

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, ParityFieldType, NewFieldDeclaration, RuleExpression, ValueEnvelope, ChecklistRequirementKind, ContextPolicy, WorkDueState, FieldSensitivity, StageRuleOnFail, SubscriptionCadence, WorkInboxKind, FieldKind, RecordFilter as RecordFilter$1, 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, 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';
@@ -1136,6 +1136,34 @@ interface ExportMenuProps {
 }
 declare function ExportMenu({ tableId, rows, label, className }: ExportMenuProps): react.JSX.Element;
 
+interface FilePickerProps {
+    /** What the button says when nothing is chosen yet. */
+    label: string;
+    /** The `accept` list, exactly as the native input takes it. */
+    accept?: string | undefined;
+    /**
+     * The accessible name of the file input itself, when it must differ from the
+     * button's word — an import screen's input has been called "Choose a file to
+     * import" since it existed, and every automation and screen-reader script
+     * that knows this screen resolves that sentence. A name is a contract.
+     */
+    inputLabel?: string | undefined;
+    /**
+     * One sentence describing a good file — the thing the bare input never said.
+     * Shown under the control, before anything is chosen.
+     */
+    hint?: ReactNode;
+    disabled?: boolean | undefined;
+    /** The chosen file. Called once per choice; re-choosing calls it again. */
+    onFile: (file: File) => void;
+    /** Forget the chosen file and go back to the empty state. */
+    onClear?: (() => void) | undefined;
+    /** The name of the file currently in play, when the owner is holding one. */
+    chosenName?: string | null | undefined;
+    className?: string | undefined;
+}
+declare function FilePicker({ label, accept, inputLabel, hint, disabled, onFile, onClear, chosenName, className, }: FilePickerProps): react.JSX.Element;
+
 interface ImportWizardProps {
     tableId: Uuid;
     onDone?: ((written: number) => void) | undefined;
@@ -1174,8 +1202,25 @@ type PlainFieldType = "text" | "long_text" | "number";
  * directions: it does not appear there, and it cannot hide a real gap there.
  */
 type RelationFieldType = "relation";
-/** What a person picks in the panel: one of the fourteen, one of the three, or a link. */
-type PickableFieldType = ParityFieldType | PlainFieldType | RelationFieldType;
+/**
+ * What a person picks in the panel — AND IT IS THE STORE'S OWN LIST, not a union
+ * assembled here.
+ *
+ * 🚨 THE CLASS FIX (FIX-10B-F6, VERIFIER-10). This used to read
+ * `ParityFieldType | PlainFieldType | RelationFieldType` — the parity floor plus two words
+ * this file knew about — and that union was the whole defect. `custom.doc_sign` accepts
+ * exactly one field, a text column whose format is `signature`, and it is granted to
+ * `authenticated`; the Documents screen told a person in so many words to go and declare
+ * one; and no list any screen could read named it, so the control did not exist and the
+ * e-sign half of Documents was unreachable from the product. A kind the store takes and no
+ * screen offers is invisible, and nothing failed — which is the only reason it survived.
+ *
+ * `custom.field_kinds()` is now the ONE registry and `DECLARABLE_FIELD_KINDS` is generated
+ * from it, so the next kind the store learns arrives here as a TYPE ERROR in
+ * `FIELD_TYPE_CHOICES`'s coverage and as a red `kindsWithNoChoice()` below — never as a
+ * silence.
+ */
+type PickableFieldType = DeclarableFieldKind;
 interface FieldTypeChoice {
     id: PickableFieldType;
     /** The word on the menu. */
@@ -1197,6 +1242,16 @@ declare function isPlainFieldType(id: string): id is PlainFieldType;
  * and not an inline string comparison at four call sites.
  */
 declare function isRelationFieldType(id: string): id is RelationFieldType;
+/**
+ * One of FLD-11's fourteen, which is what `parity_type` on a declaration means.
+ *
+ * Read from the store's own generated floor, never from a list here — because a kind that
+ * is NOT one of the fourteen (plain text, a person-aimed relation, a signature) has to be
+ * declared by its WORD (`type`) and a panel that sent `parity_type` for it would be refused
+ * "There is no field type called …". That is the shape of the F6 defect: the panel's `save`
+ * had exactly two branches, relation and plain, and everything else fell into `parity_type`.
+ */
+declare function isParityFieldType(id: string): id is ParityFieldType;
 /**
  * THE GUARD THIS FILE NEEDS, because the list it explains is generated.
  *
@@ -1209,6 +1264,22 @@ declare function isRelationFieldType(id: string): id is RelationFieldType;
  * list and a behaviour that carries no parity type is not in it.
  */
 declare function parityTypesWithNoExplanation(): string[];
+/**
+ * 🚨 THE GUARD THAT CLOSES THE CLASS (FIX-10B-F6).
+ *
+ * `parityTypesWithNoExplanation()` above watches the parity FLOOR, and the floor was never
+ * the whole list: the store also declares plain text, long text, number, a person-aimed
+ * relation and a signature, and for months nothing anywhere compared the panel's menu with
+ * THAT. So `signature` — the one field `custom.doc_sign` accepts, on a door granted to
+ * every signed-in person, named to the person by the Documents screen itself — was absent
+ * from the menu and every check stayed green.
+ *
+ * This returns the kinds `custom.field_kinds()` publishes that this panel does not offer.
+ * The suite asserts it is empty, so a kind the store learns tomorrow either reaches the
+ * person or turns a test red the same day. It is the class, not the instance: it would have
+ * caught `signature`, and it will catch the twentieth kind nobody has thought of yet.
+ */
+declare function kindsWithNoChoice(): string[];
 
 /** `Day rate` → `day_rate`. Shown, so nothing about it is a surprise. */
 declare function keyFor(label: string): string;
@@ -1772,7 +1843,23 @@ declare const LAYOUT_FIELD_KIND: Record<ViewLayout, "choice" | "date" | null>;
  * dashboard" is one of the ways to look at this table, and a link to it has to
  * work like a link to the board.
  */
-declare const PAGE_VIEWS: readonly ["grid", "kanban", "calendar", "gallery", "dashboards"];
+/**
+ * 🚨 `archived` IS THE SIXTH VALUE, AND IT IS NOT A SPECIAL CASE EITHER (lane
+ * FIX-10A-ARCHIVE, 2026-09-22; VERIFIER-10 F4).
+ *
+ * Archiving a record used to be a ONE-WAY DOOR: the grid's row action soft-
+ * deletes correctly — `deleted_at` set, version bumped, nothing removed — and
+ * then no screen anywhere in the platform could bring it back. The store's
+ * `custom.record_restore` was there the whole time and did exactly the right
+ * thing; nothing reached it, because every read door answers live rows only.
+ *
+ * So the archive is a WAY OF LOOKING AT THIS TABLE, like the board and the
+ * dashboards, reached by the same row of buttons and named by the same
+ * `?view=` parameter — never a Trash area of the app somebody has to know
+ * exists, and never a per-table screen. Every Table inherits it the moment it
+ * is in this list.
+ */
+declare const PAGE_VIEWS: readonly ["grid", "kanban", "calendar", "gallery", "dashboards", "archived"];
 type PageView = (typeof PAGE_VIEWS)[number];
 declare const PAGE_VIEW_LABEL: Record<PageView, string>;
 /**
@@ -1841,11 +1928,91 @@ declare function useViewRecords(view: SavedViewSpec, pageSize?: number, filter?:
     rows: ReadRow$1[];
     loading: boolean;
     error: RecordsError | null;
-    /** Where membership came from, in a sentence. A screen that hides this is hiding the view's meaning. */
+    /**
+     * Where membership came from, in a sentence. A screen that hides this is hiding the
+     * view's meaning — and a screen that says the WRONG one is worse than one that says
+     * nothing at all.
+     *
+     * 🚨 IT SAID "holds the whole table" OVER FOUR OF FORTY-TWO ROWS. Seen on Rincon
+     * Plumbing Co's board the moment a dashboard number could narrow it (lane DRILL,
+     * 2026-09-22): the column read "Scheduled 4", every card under it was real, and the
+     * line above them said this view holds the whole table. The sentence was written when
+     * the only two possibilities were a Rule or everything; a question from the address is
+     * a third, and it gets its own words rather than the nearest wrong one.
+     */
     membership: string;
 };
 declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, onMoved, onNewRecordForm, onAskWhoChanged, pageSize, filter, className, }: ViewSwitcherProps): react.JSX.Element;
 
+/** What the screen says above the list, so nobody has to be told twice that nothing was destroyed. */
+declare const ARCHIVE_MEANS = "Archiving never destroys anything. A record you remove from the grid waits here until somebody brings it back.";
+/** The sentence a person who may not restore reads INSTEAD of a control they cannot use. */
+declare function mayNotRestoreLine(why: string): string;
+/** What one row in the archive says, as one string — pulled out so the guard can read it. */
+declare function archivedRowLine(row: ArchivedRow, titleKey?: string | null): string;
+interface ArchivedViewProps {
+    tableId: Uuid$1;
+    /** Rows per page. The store refuses above its own ceiling by name rather than quietly serving fewer. */
+    pageSize?: number | undefined;
+    /** Which lane the address or the host asked for. Absent, the organization's. */
+    lane?: ArchiveLane | undefined;
+    /** Called when the person switches lane, so the host can put it in the URL. */
+    onLaneChange?: ((lane: ArchiveLane) => void) | undefined;
+    /** Called after a record comes back, so the host re-reads the rows it owns. */
+    onRestored?: ((recordId: Uuid$1) => void) | undefined;
+    className?: string | undefined;
+}
+declare function ArchivedView({ tableId, pageSize, lane: laneFromHost, onLaneChange, onRestored, className, }: ArchivedViewProps): react.JSX.Element;
+
+/** What every archive on this platform promises, said once. */
+declare const ARCHIVED_NEVER_DESTROYED = "Archiving never destroys anything. What you put away waits here until somebody brings it back.";
+interface ArchivedDisclosureProps {
+    /** What is archived, in the plural: "portals", "forms". Drawn as “Archived portals”. */
+    noun: string;
+    /**
+     * How many are archived, when the surface already knows. Absent, the control
+     * still draws — a count nobody has read is not a reason to hide the way in,
+     * and a "(0)" the screen guessed would be a lie.
+     */
+    count?: number | undefined;
+    /** Open on first render — the address asked for the archive. */
+    defaultOpen?: boolean | undefined;
+    /** Told when it opens or closes, so a host can put it in the URL. */
+    onOpenChange?: ((open: boolean) => void) | undefined;
+    children: ReactNode;
+    className?: string | undefined;
+}
+/**
+ * ONE CLICK, ON THE SURFACE ITSELF. Not a tab, not a page, not a filter buried
+ * in a menu: the law says revealing the archived things is one press where you
+ * already are, and this is that press for every rail in this package.
+ */
+declare function ArchivedDisclosure({ noun, count, defaultOpen, onOpenChange, children, className, }: ArchivedDisclosureProps): react.JSX.Element;
+interface ArchivedPortalsProps {
+    /** Called after a portal comes back, so the rail re-reads the list it owns. */
+    onRestored?: ((portalId: Uuid) => void) | undefined;
+    /**
+     * Bumped by the surface above whenever IT changed something that lands here —
+     * archiving a portal from the live rail, most of all. Without it an archive
+     * standing open would keep showing the list it read when it opened, which is
+     * the quiet lie this package refuses everywhere else.
+     */
+    refreshToken?: number | undefined;
+    defaultOpen?: boolean | undefined;
+    className?: string | undefined;
+}
+/**
+ * THE ARCHIVED PORTALS OF THIS ORGANIZATION, AND THE WAY BACK.
+ *
+ * It reads `custom.list_portals(org, 'archived')` — the archive-aware reader the
+ * store grew for exactly this — rather than filtering a list `custom.portals`
+ * already hid. It is organization-wide on purpose, unlike the live rail above
+ * it: a portal is archived precisely because nobody is standing on it any more,
+ * and narrowing the archive to the Table you happen to be on is how an archived
+ * portal becomes unreachable from every page at once.
+ */
+declare function ArchivedPortals({ onRestored, refreshToken, defaultOpen, className, }: ArchivedPortalsProps): react.JSX.Element;
+
 interface ViewBarProps {
     /** The Table whose views these are. */
     tableId: Uuid;
@@ -3003,7 +3170,17 @@ declare const VIEW_NOT_SAVED_YET: string;
  * somewhere else in the product would be a second answer to "how is the work
  * going", reached by knowing where to click.
  */
-type MainView = "records" | "dashboards";
+/**
+ * 🚨 `archived` IS THE THIRD (lane FIX-10A-ARCHIVE, 2026-09-22; VERIFIER-10 F4).
+ * Archiving a record was a ONE-WAY DOOR — the row left the grid and no screen
+ * anywhere could bring it back, although `custom.record_restore` was there the
+ * whole time — because nothing in this package listed archived rows and no read
+ * door could answer them. It belongs HERE, beside the records and the counts of
+ * them, for exactly the reason the dashboards do: to the person, the archive is
+ * one of the ways to look at this table, not a Trash area of the app somebody
+ * has to know exists.
+ */
+type MainView = "records" | "dashboards" | "archived";
 /**
  * WHAT THE PAGE IS SHOWING — the middle and the right-hand panel, as ONE answer.
  *
@@ -3259,4 +3436,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, type AbsenceWord, ActionInbox, type ActionInboxProps, type ActionKind, type AgentBuildAsk, 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, 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, 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, isPlainFieldType, isRelationFieldType, isSignatureField, keyFor, laneFor, lastChangeSentence, looksLikeId, machineIdentityIn, 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, 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 };