@ai-matrx/records-ui 0.93.153 → 0.95.3

package/dist/index.d.cts

@@ -3,8 +3,8 @@ import { ReactNode, KeyboardEvent, ReactElement, ComponentType, RefObject, SVGAt
 import * as _ai_matrx_records from '@ai-matrx/records';
 import { RecordScopeContext, EnrichCell, RecordsError, Field, TableDecorations, Uuid as Uuid$1, RowAction, RecordDocument, Table, ReadRow, StoreFilter, PermissionLevel, AggregateFilter, RelationDisplay, WriteConflict, RecordsErrorCode, RecordFilter, RuleExpression, RecordsResult, SavedViewRow, DeclarableFieldKind, NewerFieldKind, ParityFieldType, NewFieldDeclaration, ChoiceRehome, FieldOptionEdit, StoredRecord, ChoiceNudge, HiddenFieldNotice, ValueEnvelope, ChecklistRequirementKind, ContextPolicy, WorkDueState, FieldSensitivity, StageRuleOnFail, SubscriptionCadence, WorkApprovalState, WorkInboxKind, FieldKind, ArchiveLane, ArchivedRow, WorkInboxView, WorkInboxItem, PortalAccent, FormSummary, PortalCard, PortalPrincipal, PortalPreviewRow, PublicPicture, PortalStyle, MySubscription, DashboardBlockKind, AggregateBucket, AggregateMeasure, AggregateCompare, DashboardTarget, DashboardBlock, DashboardSummary, DocTemplateRow, DocRenderRow, QuietHours, DashboardBlockResult, ChecklistRunStep, BookingSummary, CaptureSheetFace, CaptureField, AnonTokenBinding, RecordsConfig, RecordsActor, RecordsDataSource, HistoryActor, FieldHistoryEntry, DrillDefinition, DrillSource } from '@ai-matrx/records';
 import { ReversibleAnnouncement } from '@ai-matrx/kit/reversible';
-import { W as WhatYouMayDo, T as TableActionHost, O as ObjectAction, a as ObjectActionIcon } from './objectActions-Dgdr0E4b.cjs';
-export { A as ACTION_CHECKING_ACCESS_REASON, b as ACTION_NOT_HERE_REASON, c as ACTION_NO_ACCESS_REASON, d as ACTION_PLATFORM_TABLE_REASON, B as BuiltOnDestination, C as Capability, D as DEFAULT_ACTION_ORIGIN, K as KERNEL_REASON, L as LEVEL_WORD, N as NOT_ANSWERED_YET, e as OBJECT_ACTION_GROUPS, f as ObjectActionDropdownEntry, g as ObjectActionGroup, h as ObjectActionGroupDef, i as ObjectActionSection, S as STANDARD_VERBS, j as STRIP_FEATURE_ROWS, k as StandardVerbId, l as StripAndRows, m as TableActionSubject, n as TableActionsInput, o as dropdownActionIds, p as dropdownActions, q as groupObjectActions, r as levelNeededFor, s as rightsReason, t as tableActions, u as tableLink, v as toDropdownEntries, w as toStripAndRows, x as whatYouMayDo, y as whatYouMayDoWithTable, z as withExtensions } from './objectActions-Dgdr0E4b.cjs';
+import { W as WhatYouMayDo, T as TableActionHost, O as ObjectAction, a as ObjectActionIcon } from './objectActions-DozKWxks.cjs';
+export { A as ACTION_CHECKING_ACCESS_REASON, b as ACTION_NOT_HERE_REASON, c as ACTION_NO_ACCESS_REASON, d as ACTION_PLATFORM_TABLE_REASON, B as BuiltOnDestination, C as Capability, D as DEFAULT_ACTION_ORIGIN, K as KERNEL_REASON, L as LEVEL_WORD, N as NOT_ANSWERED_YET, e as OBJECT_ACTION_GROUPS, f as ObjectActionDropdownEntry, g as ObjectActionGroup, h as ObjectActionGroupDef, i as ObjectActionSection, S as STANDARD_VERBS, j as STRIP_FEATURE_ROWS, k as StandardVerbId, l as StripAndRows, m as TableActionSubject, n as TableActionsInput, o as dropdownActionIds, p as dropdownActions, q as groupObjectActions, r as levelNeededFor, s as rightsReason, t as tableActions, u as tableLink, v as toDropdownEntries, w as toStripAndRows, x as whatYouMayDo, y as whatYouMayDoWithTable, z as withExtensions } from './objectActions-DozKWxks.cjs';
 import { Uuid, Field as Field$1, ReadRow as ReadRow$1, StoreFilter as StoreFilter$1, useRecordsClient } from '@ai-matrx/records/react';
 import { TableStyle, GroupAggregateSpec, GroupOrder, ChoiceColorLookup, MatrxTableCardProps, StyleColor, MatrxDrillDimension, MatrxDrillMeasure, MatrxDrillFilter, MatrxDrillQuestion, MatrxDataTableDrillConfig, MatrxDrillAnswers } from '@ai-matrx/design-system/data-table';
 import { FieldFormatConfig } from '@ai-matrx/design-system/field-formats';
@@ -899,6 +899,17 @@ interface RecordsUiHost {
      * nothing is the dead control this package does not ship.
      */
     openRecords?: (ask: OpenRecordsAsk) => void;
+    /**
+     * OPTIONAL. WHERE A PAGE OPENS (v6 lane 11, wave D). A Page is a dashboard record whose
+     * `presentation.kind` is `"page"` (`pages.ts`); the host owns its route, so this hands back the
+     * address of an existing page, or of the screen that makes a new one on a Table. Unbound, the
+     * Dashboards area lists no pages and offers no "New page" — absent, never dead.
+     */
+    pageHref?: (target: {
+        pageId: Uuid$1;
+    } | {
+        newOnTable: Uuid$1;
+    }) => string;
     /**
      * OPTIONAL. ASK THE AGENT TO CHANGE THIS DASHBOARD (SCR-16).
      *
@@ -1625,7 +1636,7 @@ interface ViewSortKey {
  * sub-groups and shut sections, hidden fields, gallery size, summaries).
  */
 interface ViewSettings {
-    layout: "grid" | "kanban" | "calendar" | "gallery";
+    layout: "grid" | "kanban" | "calendar" | "gallery" | "timeline";
     filters: RecordFilter | null;
     where: RuleExpression | null;
     groupField: string | null;
@@ -2107,6 +2118,12 @@ interface GridProps {
      * with the arrows), so the panel always shows the row the person is on.
      */
     openRecordId?: Uuid | null | undefined;
+    /**
+     * CLOSE THE RECORD PANEL (grids review 3, lane H item 5): Escape on the grid, and Space on the row
+     * that is already open, put it away — Airtable's expanded record toggles the same way. Unbound,
+     * Space only opens.
+     */
+    onCloseRecord?: (() => void) | undefined;
     /** SCR-2. Called when an admin clicks the "+" at the end of the headers. */
     onAddField?: (() => void) | undefined;
     /**
@@ -2512,7 +2529,16 @@ type RelationFieldType = "relation";
  * `FIELD_TYPE_CHOICES`'s coverage and as a red `kindsWithNoChoice()` below — never as a
  * silence.
  */
-type PickableFieldType = DeclarableFieldKind | SystemFieldKind | "entity_reference" | NewerFieldKind;
+type PickableFieldType = DeclarableFieldKind | SystemFieldKind | "entity_reference" | NewerFieldKind | LookFieldKind;
+/**
+ * A KIND THAT IS A PLAIN COLUMN WEARING A LOOK (grids review 3, lane H item 5). The store keeps a
+ * column's "Shows as" on the Field (`display_format`, `custom.display_format_ids()` has `rating` and
+ * `time`), so a Rating is a whole number shown as stars and a Time is a time of day kept as its
+ * 24-hour text — declared through the ordinary door (`{ plain, display_format }`) the same way the
+ * "Shows as" picker makes one. Offered whenever the store does not yet publish the kind as its own
+ * word (`custom.field_kinds()`): a Rating the store publishes goes as `{ type: "rating", max }`.
+ */
+type LookFieldKind = "time";
 /**
  * LANE 10 P4: THE NINE NEWER KINDS (rating, duration, created by, last changed by, status, address,
  * barcode, formatted text, count). Each is listed in `FIELD_TYPE_CATALOGUE` below, so every reader
@@ -2840,8 +2866,10 @@ interface PeekProps {
     recordId: Uuid;
     onClose?: (() => void) | undefined;
     className?: string | undefined;
+    /** Drawn ON the record's own page: no "Open" link to the page it is already on. */
+    onPage?: boolean | undefined;
 }
-declare function Peek({ tableId, recordId, onClose, className }: PeekProps): react.JSX.Element;
+declare function Peek({ tableId, recordId, onClose, className, onPage }: PeekProps): react.JSX.Element;
 
 interface RecordFormProps {
     tableId: Uuid;
@@ -3480,7 +3508,7 @@ declare function archiveConfirmSentence(what: string): string;
 
 interface AnnounceTableArchived {
     notify: RecordsUiHost["notify"];
-    client: Pick<RecordsClient, "recordRestore">;
+    client: Pick<RecordsClient, "tableRestoreWhole">;
     tableId: Uuid$1;
     /** The table's name as the store gave it. */
     name: string;
@@ -3535,6 +3563,9 @@ declare const LOOK_WORDS: {
     readonly newName: "Name for the new view";
 };
 
+/** The far table's Fields, by table id — what a lookup's picked column is judged against. */
+type FarFields = ReadonlyMap<string, readonly Field[]>;
+
 interface ViewSwitcherProps {
     /**
      * THE DECLARATIVE SPEC — an agent writes the whole thing, a person tweaks it.
@@ -3555,6 +3586,8 @@ interface ViewSwitcherProps {
     onOpenRecord?: ((recordId: Uuid) => void) | undefined;
     /** The record the host has open beside a grid, which the grid's panel then follows (`Grid.openRecordId`). */
     openRecordId?: Uuid | null | undefined;
+    /** Put the record panel away (Escape, or Space on the open row): `Grid.onCloseRecord`. */
+    onCloseRecord?: (() => void) | undefined;
     /**
      * Called after a card moves between columns, so the host re-reads the rows it owns. A
      * board that moved a card and left the row list alone would show the card in two places
@@ -3631,6 +3664,8 @@ declare function useViewRecords(view: SavedViewSpec, pageSize?: number, filter?:
     total: number | null;
     /** Show one more page of them. */
     loadMore: () => void;
+    /** Read them again — a card's menu copied or archived one. */
+    reload: () => void;
     pageSize: number;
     loading: boolean;
     error: RecordsError | null;
@@ -3648,7 +3683,7 @@ declare function useViewRecords(view: SavedViewSpec, pageSize?: number, filter?:
      */
     membership: string;
 };
-declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onMoved, onNewRecordForm, onAskWhoChanged, pageSize, titleField, filter, onClearFilter, hostLayout, onHostLayoutChange, chooser, openExport, viewId, onOrderPlaced, footer, className, }: ViewSwitcherProps): react.JSX.Element;
+declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onCloseRecord, onMoved, onNewRecordForm, onAskWhoChanged, pageSize, titleField, filter, onClearFilter, hostLayout, onHostLayoutChange, chooser, openExport, viewId, onOrderPlaced, footer, className, }: ViewSwitcherProps): react.JSX.Element;
 
 type CalendarMode = "month" | "week" | "day" | "list";
 interface CalendarViewProps {
@@ -3659,6 +3694,8 @@ interface CalendarViewProps {
     dateField: Field$1;
     /** The table's columns, for the End and Colour by pickers and the default colour. */
     fields?: readonly Field$1[] | undefined;
+    /** The far tables' columns, so a lookup of one date is offered as an End (`useFarFields`). */
+    farFields?: FarFields | undefined;
     /**
      * THE END COLUMN THE VIEW KEEPS (`end_field`). Left out or null: the table's ONE other date column
      * when it has exactly one, else none until the person picks.
@@ -3706,7 +3743,7 @@ declare function packOverlaps<T extends {
     col: number;
     cols: number;
 }>;
-declare function CalendarView({ tableId, rows, dateField, fields, endKey, onEndFieldChange, endKept, titleField, onOpenRecord, onMoved, onColorFieldChange, canCreate, note, style, defaultMinutes, snapMinutes, initialDate, initialMode, className, }: CalendarViewProps): react.JSX.Element;
+declare function CalendarView({ tableId, rows, dateField, fields, farFields, endKey, onEndFieldChange, endKept, titleField, onOpenRecord, onMoved, onColorFieldChange, canCreate, note, style, defaultMinutes, snapMinutes, initialDate, initialMode, className, }: CalendarViewProps): react.JSX.Element;
 
 type TimelineZoom = "day" | "week" | "month" | "quarter";
 declare const TIMELINE_ZOOMS: readonly TimelineZoom[];
@@ -3723,6 +3760,8 @@ interface TimelineViewProps {
     rows: readonly ReadRow$1[];
     /** The table's columns: the pickers, the lanes and the colours read them. */
     fields: readonly Field$1[];
+    /** The far tables' columns, so a lookup of one date is offered as a Start or End (`useFarFields`). */
+    farFields?: FarFields | undefined;
     /** The column that names each bar (`cardTitleField`). */
     titleField: Field$1 | undefined;
     /** The view's Start column (`date_field`). Left out: the table's one date column, else asked. */
@@ -3753,7 +3792,7 @@ interface TimelineViewProps {
 declare function onlyCandidate(candidates: readonly Field$1[]): string | null;
 /** The columns a timeline can lay lanes out by: a choice, a person, a link, yes / no, or a worked-out column. */
 declare function groupableFields(all: readonly Field$1[]): Field$1[];
-declare function TimelineView({ tableId, rows, fields, titleField, startKey, endKey, groupKey, colorKey, onSettingsChange, layoutKept, onOpenRecord, onMoved, note, style, initialZoom, initialDate, className, }: TimelineViewProps): react.JSX.Element;
+declare function TimelineView({ tableId, rows, fields, farFields, titleField, startKey, endKey, groupKey, colorKey, onSettingsChange, layoutKept, onOpenRecord, onMoved, note, style, initialZoom, initialDate, className, }: TimelineViewProps): react.JSX.Element;
 
 /** The colour of each record's card under `colorKey` (null: the table's own decorations only). */
 declare function useRowColorBy(all: readonly Field$1[], colorKey: string | null, style?: TableStyle | undefined): (row: ReadRow$1) => StyleColor | null;
@@ -4802,9 +4841,11 @@ interface ChartBlockProps {
     block: DashboardBlockResult;
     /** The dashboard's subject Table, for a block that names none of its own. */
     subject: Uuid$1;
+    /** The table this chart reads, named in its header on a dashboard across tables. */
+    tableName?: string | undefined;
     className?: string | undefined;
 }
-declare function ChartBlock({ block, subject, className }: ChartBlockProps): react.JSX.Element;
+declare function ChartBlock({ block, subject, tableName, className }: ChartBlockProps): react.JSX.Element;
 
 interface DashboardCanvasProps {
     /** The Table these blocks are about. */
@@ -4823,6 +4864,253 @@ interface DashboardCanvasProps {
 }
 declare function DashboardCanvas({ tableId, activeDashboardId, filter, createOnMount, onCreated, className }: DashboardCanvasProps): react.JSX.Element;
 
+interface QuestionPanelProps {
+    tableId: Uuid;
+    /** A saved Question the address named (`?view=questions&item=<id>`). */
+    activeQuestionId?: Uuid | null | undefined;
+    className?: string | undefined;
+}
+declare function QuestionPanel({ tableId, activeQuestionId, className }: QuestionPanelProps): react.JSX.Element;
+
+type QuestionOp = "count" | "sum" | "avg" | "min" | "max";
+declare const QUESTION_OPS: readonly QuestionOp[];
+interface QuestionMeasure {
+    op: QuestionOp;
+    /** The Field measured; absent for `count`. */
+    key?: string | undefined;
+}
+/** What the answer is cut into. */
+type QuestionGroup = {
+    kind: "field";
+    key: string;
+} | {
+    kind: "bucket";
+    key: string;
+    by: AggregateBucket;
+}
+/** A column of the table a relation points at: `Patient.Referring physician`. */
+ | {
+    kind: "through";
+    relation: string;
+    key: string;
+};
+/** A condition on a column of the table a relation points at ("Patient.Referring physician is …"). */
+interface ThroughCondition {
+    relation: string;
+    key: string;
+    value: string | number | boolean | null;
+}
+type QuestionShow = "table" | "bar" | "column" | "line" | "donut" | "number";
+interface QuestionSpec {
+    v: 1;
+    measures: QuestionMeasure[];
+    /** The grid's condition builder's Rule, on this table's own Fields (by id). */
+    where: RuleExpression | null;
+    /** Conditions across a relation, ANDed with `where`. */
+    through: ThroughCondition[];
+    group: QuestionGroup | null;
+    /** An ISO moment: the table as the store held it then. Null = now. */
+    asOf: string | null;
+    /** Groups sorted by the FIRST measure (`measure`) or by how many records each holds. Null = the store's default. */
+    order: {
+        by: "measure" | "count";
+        direction: "desc" | "asc";
+    } | null;
+    /** How many groups are shown. */
+    limit: number;
+    show: QuestionShow;
+}
+declare function newQuestion(): QuestionSpec;
+/** A kept definition read back: anything malformed becomes the empty question, never a throw. */
+declare function questionFromDefinition(definition: unknown): QuestionSpec;
+interface QuestionRow {
+    /** The group's stored value (a relation's record id, a period's local moment, a word), or null. */
+    group: string | null;
+    /** By measure key (`count`, `sum_copay`). Null = no value (never 0 passed off as one). */
+    values: Record<string, number | null>;
+    /** A measure over a column this reader may not read: the store's own notice, by measure key. */
+    withheld: Record<string, HiddenFieldNotice & {
+        says?: string;
+    }>;
+    /** How many records the group was measured over. */
+    n: number;
+}
+interface QuestionAnswer {
+    rows: QuestionRow[];
+    /** The measure keys, in the order asked. */
+    measures: string[];
+    /** The key the group values are under (a bucket's is `<key>_<by>`), or null. */
+    groupKey: string | null;
+    /** How many groups exist; `groupsExact` false when it is "at least". */
+    groupsTotal: number | null;
+    groupsExact: boolean;
+    truncated: boolean;
+    asOf: string | null;
+}
+/**
+ * The Rule as a FLAT map (Field key → value) when it is only "is" conditions joined by ALL — the
+ * one shape the as-of door and a condition across a relation can carry. Null when it is more.
+ */
+declare function flatWhere(where: RuleExpression | null, fields: readonly Field[]): Record<string, unknown> | null;
+/**
+ * ASK THE STORE. `fields` are this table's Fields (the condition builder writes Fields by id, and a
+ * formula column cannot be asked "as of"). Every number in the answer is a door's.
+ */
+declare function askQuestion(client: RecordsClient, tableId: Uuid$1, spec: QuestionSpec, fields: readonly Field[]): Promise<RecordsResult<QuestionAnswer>>;
+/**
+ * THE COLUMNS THIS READER MAY NOT READ, asked of the store: one aggregate measuring how many
+ * records fill each column that carries a sensitivity, and every measure the store WITHHOLDS is a
+ * column never offered. Nothing is guessed from levels here; the store decides, as it does for the
+ * grid's cells.
+ */
+declare function unreadableKeys(client: RecordsClient, tableId: Uuid$1, fields: readonly Field[]): Promise<Set<string>>;
+/** The columns a measure other than count may read: numbers (formula arithmetic included); min/max also dates. */
+declare function measurableFields(fields: readonly Field[], op: QuestionOp): Field[];
+/** The saved-view surface a Question is kept under, beside the table's views (`custom/records`). */
+declare const QUESTION_SURFACE = "custom/records/question";
+interface SavedQuestion {
+    id: Uuid$1;
+    name: string;
+    spec: QuestionSpec;
+    /** Shared with the organization (`internal`) or kept for its maker (`personal`). */
+    shared: boolean;
+    version: number;
+    createdBy: Uuid$1 | null;
+}
+/** The table's Questions this person may read (the row's own access decides). */
+declare function questionsOf(client: RecordsClient, tableId: Uuid$1): Promise<RecordsResult<SavedQuestion[]>>;
+/** Keep a Question (new when `id` is absent). `null` data = somebody changed it first. */
+declare function questionSave(client: RecordsClient, args: {
+    id?: Uuid$1 | null;
+    tableId: Uuid$1;
+    name: string;
+    spec: QuestionSpec;
+    shared: boolean;
+    expectedVersion?: number;
+}): Promise<RecordsResult<SavedQuestion | null>>;
+/** Archive a Question (its maker, or an admin of it). */
+declare function questionArchive(client: RecordsClient, id: Uuid$1, version?: number): Promise<RecordsResult<boolean>>;
+
+interface PageScreenProps {
+    /** The page to open. */
+    pageId?: Uuid | null | undefined;
+    /** Make a new page on this Table instead (its starter: a list and a record panel), then open it. */
+    newOnTable?: Uuid | null | undefined;
+    /** The signed-in person: "Assigned to me" is her own Person record. */
+    viewerUserId?: string | null | undefined;
+    /** Told the id of the page `newOnTable` made. */
+    onCreated?: ((pageId: Uuid) => void) | undefined;
+    /** The page was archived: the host leaves it. */
+    onArchived?: (() => void) | undefined;
+    /** Open in edit mode (a page just made). */
+    startEditing?: boolean | undefined;
+    /** The host's header, handed the page's name and its controls. Left out, a plain row is drawn. */
+    header?: ((args: {
+        name: string;
+        actions: ReactNode;
+    }) => ReactNode) | undefined;
+    className?: string | undefined;
+}
+declare function PageScreen({ pageId, newOnTable, viewerUserId, onCreated, onArchived, startEditing, header, className, }: PageScreenProps): react.JSX.Element;
+
+/** Every kind of block a page holds. `chart` points at a block in the dashboard's own `blocks`. */
+declare const PAGE_BLOCK_KINDS: readonly ["list", "record", "button", "form", "filter", "chart", "heading", "text"];
+type PageBlockKind = (typeof PAGE_BLOCK_KINDS)[number];
+/** What "Add block" reads for each kind. */
+declare const PAGE_BLOCK_LABEL: Record<PageBlockKind, string>;
+interface PageBlockBase {
+    /** Stable across saves, moves and resizes. */
+    id: string;
+    /** Width in twelfths from 640 px up (`dashboardLayout.ts`); full width on a phone. */
+    span?: number;
+    title?: string;
+}
+interface ListPageBlock extends PageBlockBase {
+    kind: "list";
+    table_id: Uuid$1;
+    /** A saved view of the table: its filter and sort shape the list. */
+    view_id?: Uuid$1 | null;
+    /** The block's own question, the store's flat filter (field key → value). */
+    filter?: RecordFilter;
+    /** The columns shown, by field key; left out, the first few the table declares. */
+    columns?: string[];
+    /** A person column. Offers "Assigned to me": the viewer's own Person record against it. */
+    me_field?: string | null;
+    /** Whether "Assigned to me" starts on. */
+    me_default?: boolean;
+    limit?: number;
+}
+interface RecordPageBlock extends PageBlockBase {
+    kind: "record";
+    /** The list block whose selected row this panel shows. */
+    source: string;
+}
+interface ButtonPageBlock extends PageBlockBase {
+    kind: "button";
+    /** The list block whose selected row the action runs on. */
+    source: string;
+    table_id: Uuid$1;
+    /** An existing row action of that table (`custom.row_actions`). */
+    action_id: Uuid$1;
+}
+interface FormPageBlock extends PageBlockBase {
+    kind: "form";
+    table_id: Uuid$1;
+    form_id: Uuid$1;
+}
+interface FilterPageBlock extends PageBlockBase {
+    kind: "filter";
+    table_id: Uuid$1;
+    /** A choice (or yes/no) column of that table. */
+    field: string;
+    /** The list blocks it narrows. Empty = every list on the page over the same table. */
+    targets?: string[];
+}
+interface ChartPageBlock extends PageBlockBase {
+    kind: "chart";
+}
+interface HeadingPageBlock extends PageBlockBase {
+    kind: "heading";
+    text: string;
+}
+interface TextPageBlock extends PageBlockBase {
+    kind: "text";
+    text: string;
+}
+type PageBlock = ListPageBlock | RecordPageBlock | ButtonPageBlock | FormPageBlock | FilterPageBlock | ChartPageBlock | HeadingPageBlock | TextPageBlock;
+/** The `presentation.kind` that makes a dashboard record a Page. */
+declare const PAGE_KIND = "page";
+/** Is this dashboard row a Page? Every row with no kind is a dashboard (the store's default). */
+declare function isPage(row: Pick<DashboardSummary, "presentation"> | {
+    presentation?: unknown;
+}): boolean;
+/**
+ * The page's blocks in reading order, read strictly out of `presentation`. A chart the store holds
+ * in `blocks` but the order does not name is appended (it was added by an agent or the old canvas),
+ * and a `chart` entry whose block is gone is dropped — the page never draws a block it cannot answer.
+ */
+declare function pageBlocksOf(presentation: Record<string, unknown> | null | undefined, chartIds: readonly string[]): PageBlock[];
+/** The presentation a page is saved with: its kind and its blocks, everything else it held kept. */
+declare function pagePresentation(presentation: Record<string, unknown> | null | undefined, blocks: readonly PageBlock[]): Record<string, unknown>;
+/**
+ * THE STARTER PAGE on one table, the way Airtable's record-review layout starts: the table's records
+ * on the left, the chosen one on the right. One press makes a page that already works.
+ */
+declare function starterPageBlocks(tableId: Uuid$1): PageBlock[];
+/** The list blocks a filter block narrows: those it names, or every list over its table. */
+declare function filterTargets(filter: FilterPageBlock, blocks: readonly PageBlock[]): string[];
+/**
+ * ONE QUESTION FOR A LIST BLOCK, in the store's own filter shapes. `base` is the view's question —
+ * its `where` Rule or its flat `filters` — and `extra` the page's own (the block's filter, the
+ * filter blocks, "Assigned to me"), all equalities by key. Both flat: one merged map (the page's
+ * value wins). The view asks a Rule: the extras join it under `and`, by field id, which is the only
+ * way the Rule shape names a column (REC-17). An extra whose key has no id is left out and named.
+ */
+declare function combineFilter(base: StoreFilter | null | undefined, extra: RecordFilter, fieldIdOf: (key: string) => string | undefined): {
+    filter: StoreFilter | null;
+    dropped: string[];
+};
+
 interface FormsPanelProps {
     tableId: Uuid;
     /**
@@ -5001,10 +5289,16 @@ declare function ChecklistsPanel({ tableId, onOpenRecord, className }: Checklist
  * sentence arrives BEFORE the save rather than after it. There is no second
  * validator here: a rule written twice is a rule that will disagree with itself.
  */
-declare function ChecklistTemplateEditor({ aboutTableId, templateId, onDone, className, }: {
+declare function ChecklistTemplateEditor({ aboutTableId, templateId, onDone, onSaved, className, }: {
     aboutTableId: Uuid;
     templateId?: Uuid | null | undefined;
+    /** Cancel; and, when the host passes no `onSaved`, a finished Save. */
     onDone?: (() => void) | undefined;
+    /**
+     * A Save landed: the checklist's id. Passed, the editor STAYS open and says it is saved (the
+     * host decides where to go); every later Save re-states that same checklist.
+     */
+    onSaved?: ((templateId: Uuid) => void) | undefined;
     className?: string | undefined;
 }): react.JSX.Element;
 
@@ -5195,40 +5489,6 @@ interface RecordsMountProps {
 }
 declare function RecordsMount({ config, host, letTheStoreDecideRights, children, }: RecordsMountProps): react.JSX.Element;
 declare function personActor(userId: Uuid$1 | null | undefined): RecordsActor;
-/**
- * A supabase-js client AS this package's data seam.
- *
- * `RecordsDataSource` is deliberately a small structural subset of
- * `SupabaseClient` — the package holds no key and opens no connection, the host
- * hands it a client that already carries the person's session.
- *
- * IT IS NOT AN IDENTITY CAST, and it cost a live screen to learn why
- * (2026-09-19, /data-v2's first load): the port's `rpc(fn, args, { schema })`
- * says the schema OUT LOUD, because every door of this store is `custom.<name>`
- * and every door of the trust layer is `iam.<name>`. supabase-js's own
- * `rpc(fn, args, options)` has no `schema` option at all — its third argument is
- * `{ head, get, count }` — so a client passed straight through silently asked
- * its default PostgREST profile and the store answered, correctly and uselessly,
- * "Could not find the function public.table_kernel_id ... PGRST202". The schema
- * is chosen the one way supabase-js offers: `client.schema(name).rpc(...)`.
- *
- * `schema(name).from(table)` already agrees structurally and is passed through.
- *
- * `fallbackSchema` is the profile a call that says NOTHING is sent to. No caller
- * in `@ai-matrx/records` omits the option — `callDoor` always says `custom` and
- * `trustDoor` always says `iam` — so it never fires today; it exists so that a
- * call which one day forgets lands on the store rather than silently on
- * `public`. It is a FALLBACK and not the answer: a version of this adapter that
- * sent EVERY door to one fixed schema would route the `iam` trust doors (the
- * external principal, the publish binding) into `custom` and get a PGRST202
- * naming the wrong schema.
- *
- * The cast itself stays HERE, once, where it is explained: a generated
- * `Database` type makes `schema().from().select()` enormous, and a host app that
- * passes its client straight into `config` gets `TS2589: Type instantiation is
- * excessively deep and possibly infinite` in its own build (matrx-frontend,
- * 2026-09-18, on all three campaign routes at once).
- */
 declare function recordsDataSource(client: object, fallbackSchema?: string): RecordsDataSource;
 
 type TableLane = "mine" | "organization" | "system" | "community" | "app";
@@ -5268,7 +5528,8 @@ declare function laneFor(table: Table): TableLane;
  * filter over these four leaves it out rather than inventing a lane for it.
  *
  * From the record's own `visibility`, the store's closed four:
- *   personal → Mine · internal → My organization · link → World · public → World.
+ *   Only me → Only me · the default → Everyone · Everyone on AI Matrx → Everyone on AI Matrx ·
+ *   Published to the web → Published to the web (an older store: its `visibility` word).
  *
  * 🚨 WHY `link` IS WORLD (chair ruling, 2026-09-23). A link anyone can open
  * WITHOUT signing in is reachable by the world; being unlisted does not make it
@@ -5279,6 +5540,12 @@ declare function laneFor(table: Table): TableLane;
  */
 type VisibilityLane = "mine" | "organization" | "community" | "world";
 declare const VISIBILITY_LANES: readonly VisibilityLane[];
+/**
+ * THE LAW'S WORDS (access ladder Words table), and no other lane names: "Shown to" Only me /
+ * Everyone / Everyone on AI Matrx, and "Published to the web" for anyone on the internet.
+ * "Everyone on AI Matrx" is offered only on a Public table; a store Table is Organization, so
+ * nothing lands there today.
+ */
 declare const VISIBILITY_LANE_TITLE: Record<VisibilityLane, string>;
 /** Which visibility lane one Table is in, or `null` when no person chose one for it. */
 declare function visibilityLaneFor(table: Table): VisibilityLane | null;
@@ -5501,6 +5768,12 @@ interface TablePageProps {
      * disabled, with its reason.
      */
     actionHost?: TablePageActionHost | undefined;
+    /**
+     * THE TABLE'S ACTIONS, HANDED TO THE HOST (lane TABLE-ACTIONS wave 4, T4.1): called with the
+     * very list the header ⋯ draws, after every render, so a host's command bar runs exactly what the
+     * menu runs (the same `run`). The page itself answers the ⌥⇧ chords (`TABLE_ACTION_KEYS`).
+     */
+    onActions?: ((actions: readonly ObjectAction[]) => void) | undefined;
     /**
      * WHAT THE PERSON IS ACTUALLY LOOKING AT (lane V24-TAILS, VERIFIER-24 item 6): the saved view
      * with her look laid over it and the address's overrides, exactly as the page draws it — so a
@@ -5603,7 +5876,7 @@ declare const VIEW_NOT_SAVED_YET: string;
  * 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";
+type MainView = "records" | "dashboards" | "archived" | "questions";
 /**
  * WHAT THE PAGE IS SHOWING — the middle and the right-hand panel, as ONE answer.
  *
@@ -5689,7 +5962,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, activeRail, activeItemId, header, actionHost, onShownViewChange, className, }: TablePageProps): react.JSX.Element;
+declare function TablePage({ tableId, pageSize, seedViews, onLeave, leaveLabel, activeDashboardId, activeRecordId, activeView, onViewChanged, activeGroupField, cameFrom, filter, activeRail, activeItemId, header, actionHost, onActions, onShownViewChange, className, }: TablePageProps): react.JSX.Element;
 
 /**
  * The page's toolbar slot: an element (controls go there), `null` (the row is mounting — draw
@@ -5889,6 +6162,8 @@ interface PipelineBoardProps {
     onOpenRecord?: ((recordId: Uuid) => void) | undefined;
     /** Called after a move lands, so the host re-reads the rows it owns. */
     onMoved?: (() => void) | undefined;
+    /** A card's menu copied or archived a record: the host re-reads the rows it owns. */
+    onChanged?: (() => void) | undefined;
     /**
      * THE COLORS THE REST OF THE VIEW PAINTS WITH (lane UI-QUICK-1) — `resolveTableStyle`'s answer,
      * the table's G1 decorations under the view's own look. `ViewSwitcher`'s board passes the one it
@@ -5903,7 +6178,7 @@ interface PipelineBoardProps {
     dateFields?: readonly Field$1[] | undefined;
     className?: string | undefined;
 }
-declare function PipelineBoard({ tableId, rows, titleKey, measure, filter, onMeasureChange, onOpenRecord, onMoved, style, dateFields, className, }: PipelineBoardProps): react.JSX.Element;
+declare function PipelineBoard({ tableId, rows, titleKey, measure, filter, onMeasureChange, onOpenRecord, onMoved, onChanged, style, dateFields, className, }: PipelineBoardProps): react.JSX.Element;
 
 /** The source's Dimensions, as the door says them; a choice and a relation read by their words. */
 declare function drillDimensionsOf(def: DrillDefinition | null, labels: ReadonlyMap<string, ReadonlyMap<string, string>>): MatrxDrillDimension[];
@@ -5974,4 +6249,92 @@ declare function ObjectActionGlyph({ name, ...props }: {
     name: ObjectActionIcon;
 } & SVGAttributes<SVGSVGElement>): react.JSX.Element;
 
-export { ABSENCE_WORD_LABEL, ABSENCE_WORD_VALUES, ACTION_KINDS, ARCHIVED_NEVER_DESTROYED, ARCHIVE_MEANS, type AbsenceWord, AccentSwatches, type AccentSwatchesProps, ActionInbox, type ActionInboxProps, type ActionKind, type AgentBuildAsk, type AnnounceTableArchived, ArchivedDisclosure, type ArchivedDisclosureProps, ArchivedPortals, type ArchivedPortalsProps, ArchivedView, type ArchivedViewProps, BOOKING_NOT_HERE_LINE, 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, ADDABLE_TYPES as CUSTOM_FIELD_ADDABLE_TYPES, type CalendarMode, CalendarView, type CalendarViewProps, 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, type ChoiceAddition, type ChoiceAsk, ChoiceAskButtons, ChoiceListEditor, type ChoiceListRow, CommentThread, type CommentThreadProps, type ConditionField, ConditionGroup, type ConditionGroupProps, ConditionRow, type ConditionRowProps, type CustomFieldAddRequest, type CustomFieldAddResult, type CustomFieldSetResult, type CustomFieldValuesRequest, type CustomFieldsAgentDoor, type CustomFieldsAgentState, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_FOOTER, DEFAULT_VIEW_NAME, DUE_STATE_LABEL, DashboardCanvas, type DashboardCanvasProps, DigestScheduler, type DigestSchedulerProps, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, ENGINEER_TEXT, ENTITY_REFERENCE_KINDS_MISSING, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, EnrichBadge, type EnrichBadgeProps, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, EntityReferenceKindPicker, type EntityReferenceKindPickerProps, ExampleTables, ExportMenu, type ExportMenuProps, FIELD_RULE_KIND_LABEL, FIELD_RULE_KIND_VALUES, FIELD_SENSITIVITY_LABEL, FIELD_TYPE_CATALOGUE, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FOOTER_WORDS, 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, type FooterPlacement, type FormAsked, FormBuilder, type FormBuilderProps, type FormFlow, type FormLook, FormLookFrame, type FormLookFrameProps, FormLookLogo, type FormLookView, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, type FormulaOp, Grid, GridCell, type GridContextRecord, type GridContextSnapshot, type GridEditing, type GridGrouping, type GridPresentation, type GridProps, GuessedFieldType, HistoryPanel, type HistoryPanelProps, type HostLayout, INBOX_GROUPINGS, INBOX_VIEWS, IN_MEMORY_QUEUE_REASON, type ImportSource, ImportWizard, type ImportWizardProps, InTableToolbar, type InboxGroup, type InboxGrouping, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LOOK_WORDS, type LabelLookup, type LinkRail, MACHINE_IDENTITY, MANUAL_SORT, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, type MainView, type MoveWritten, MyChecklistSteps, NEEDS_A_SENTENCE, 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, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, ObjectAction, ObjectActionGlyph, ObjectActionIcon, ObjectActionMenuItems, type ObjectActionMenuItemsProps, 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, PickOrAdd, type PickOrAddItem, type PickOrAddProps, type PickableFieldType, type PickerTable, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalBuilder, type PortalBuilderProps, PortalCardView, type PortalCardViewProps, PortalLookEditor, type PortalLookEditorProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, type ProposedChangeAct, ProvenanceBadge, PublicPicturePicker, type PublicPicturePickerProps, 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, type RecordMoves, RecordValue, RecordsMount, type RecordsMountProps, RecordsTableCard, type RecordsTableCardProps, type RecordsUiHost, RecordsUiProvider, ReferenceBuilder, type ReferenceBuilderProps, type ReferenceChoice, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, type RenderTextSlot, type ResolveName, type RollupAgg, SAVED_VIEWS_UNAVAILABLE, SAVE_TO_TABLE_TYPES, SAY_WHAT_YOU_ARE_WAITING_FOR_AFTER_MS, SECTIONS_UNKNOWN, SERIES_COLORS, SHARE_NOT_YOURS_LINE, SIGNED_WORD, SOMEBODY, STAGE_RULE_ON_FAIL_LABEL, STORE_ANSWERS_THESE, STORE_DECIDES_REASON, STORE_KEEPS_TIMELINE, STORE_KEPT_LAYOUTS, SUBSCRIPTION_CADENCES, SUBSCRIPTION_CADENCE_LABEL, SUBSCRIPTION_CHANNEL_LABEL, SUBSCRIPTION_CHANNEL_VALUES, SaveToTable, type SaveToTableProps, type SaveToTableSource, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, ShowListsToggle, type ShownViewReport, SignBlock, type SignBlockProps, SignaturePad, SignatureValue, type SnoozeChoice, type SortStateAction, SortStateControl, type SortStateControlProps, StageRulesSection, type StageRulesSectionProps, StepRow, type SubscriptionChannel, SubscriptionsPanel, type SubscriptionsPanelProps, type Surface, type SurfacePress, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NAME_MAX, TABLE_NOT_REACHABLE, THE_SYSTEM, TIMELINE_ZOOMS, TableActionHost, TableFoundationSwitch, type TableLane, type TableOpening, TablePage, type TablePageActionHost, type TablePageHeaderChrome, type TablePageProps, type TablePickerEntries, type TablePickerEntry, TableRenameDialog, TableRestoreRefused, type TableRights, TableSettings, type TableSettingsProps, TableShape, TableToolbarSlotContext, TablesHome, type TablesHomeProps, type TimelineSettings, TimelineView, type TimelineViewProps, type TimelineZoom, type TrackedVersion, UNREAD_RECORD_LABEL, type UseSystemTableState, VIEW_KEYS, VIEW_LAYOUTS, VIEW_NEEDS, VIEW_NOT_SAVED_YET, VISIBILITY_LANES, VISIBILITY_LANE_TITLE, ViewBar, type ViewBarProps, type ViewKeyDeclaration, type ViewKeyLayout, type ViewKeyWriter, type ViewLayout, type ViewLook, type ViewNeed, type ViewNeedKind, ViewNeeds, type ViewNeedsProps, type ViewSettings, type ViewSettingsPatch, type ViewSort, type ViewSortKey, ViewSwitcher, type ViewSwitcherProps, type VisibilityLane, WITHHELD_RECORD_LABEL, WITHHELD_WORD, WORK_APPROVAL_STATES, WORK_APPROVAL_STATE_LABEL, WORK_DUE_STATES, WORK_INBOX_KINDS, WORK_INBOX_KIND_GROUP_LABEL, WORK_INBOX_KIND_LABEL, WhatYouMayDo, WhereItLives, type WhereItLivesProps, type WhoChanged, WhoChangedSource, WithheldValue, actorBadge, actorWords, addDays, announceTableArchived, applyLook, archiveConfirmSentence, archivedRowLine, asRefusal, askableFields, blockFromSpec, bodyForReading, bodyFromKeys, calendarDayLabel, calendarDayOf, cameFromLine, cardTitleField, cardWords, carriesTimeOfDay, cellState, choiceAddition, choiceAskSentence, choiceListPatch, choiceNudgeOf, choiceRowsFrom, chooseSurface, colorFromTheValue, columnDeclarationFor, columnForField, conditionInWords, conditionIsDrawable, conditionIsSimple, conditionValue, controlFor, currencyCodeFor, customFieldRequestProblems, dashboardDeclareArgs, dashboardFromSummary, dateFormatFor, dateText, dayAt, dayKeyOf, daysBetween, declareView, defaultViewOf, designatedLayoutOf, drawnSignatureOf, drillDimensionsOf, drillMeasuresOf, drillPathsOf, drillWhere, editorKindFor, ensureSystemTable, entityReferenceSpec, envelopeFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, footerOf, formDeclareArgs, formFromSummary, formLookDocument, formLookFromDocument, formLookView, formPresentation, formatForField, freeColumnName, freshFormName, gridContextKey, gridContextSnapshot, groupInbox, groupLabel, groupableFields, handOrderLine, handOrderSortState, hasTimePart, hintForAPerson, hintIsMachineIdentity, idsOf, isChoiceAddition, isDateField, isEngineerText, isFoundationTable, isId, isKeptTable, isMachineIdentity, isParityFieldType, isPlainFieldType, isRelationFieldType, isSignatureField, isValueSet, keepLook, keptByTheApp, keyFor, kindsWithNoChoice, laneFor, lastChangeSentence, lookDiffers, lookDocument, lookFromDocument, lookPart, looksLikeId, machineIdentityIn, mayNotRestoreLine, memberName, moveRecordValue, nextInWords, nextSummaryAt, notAChoiceSentence, onlyCandidate, openingRail, openingView, packOverlaps, pageViewFromParam, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pickableTypeOf, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, previewWords, publiclyAnswerable, railFromParam, readLooks, recordName, recordNameIn, recordsDataSource, refusal, refusalForAPerson, refusalFromThrown, refusalLineForAPerson, refusalOr, renderValue, rescheduledValue, resolveTableStyle, revokeConsequence, rowName, rowNameIn, saveToViewPlan, saveViewPatch, scalarText, seedIsSatisfied, shapesOfSource, shareUnavailableReason, signatureFileIn, signatureFileOf, signatureWords, singularNoun, snoozeChoices, specFromBlock, storeDecidesRights, storeKeepsLayout, storePublishesKind, styleFromDecorations, submissionStamp, surfaceChosen, tableName, tableNameProblem, tableOpening, tablePickerEntries, tableRightsAt, unknownRailLine, unknownViewLine, useCanShare, useChoiceNudge, useDrill, useDrillAnswers, useDrillDefinition, useEmbedHandshake, useEnrichCells, useGridEditing, useLabelWait, useMeasuredWidth, useMyChecklistSteps, usePickerTables, useRecordLabels, useRecordMoves, useRecordRights, useRecordsUi, useRowColorBy, useRowRights, useSystemTable, useTableRights, useTableToolbarSlot, useViewRecords, useWhoChanged, viewDocument, viewFromRow, viewKeysFor, viewNeedFor, viewPatchDocument, viewSettings, viewSettingsFor, viewSettingsPatch, visibilityLaneFor, whatIsMissing, whatIsMissingForEntityReference, whatTheChoiceListIsMissing, whenWords, whyNotAskable, withheldNoticeOf, withheldSentence, withoutAddition, wordsList };
+/** What the list needs to know about the record. */
+interface RecordActionSubject {
+    id: Uuid$1;
+    tableId: Uuid$1;
+    /** The record's name as every card reads it (`recordNameIn` / `cardWords`). */
+    name: string;
+}
+type RecordHandler = (record: RecordActionSubject) => void | Promise<void>;
+/** THE SIDE EFFECTS THIS LIST CANNOT OWN. A handler left out keeps its action, disabled. */
+interface RecordActionHost {
+    /** Origin for Copy link and Open in new tab. Default `https://www.aimatrx.com`. */
+    origin?: string;
+    /**
+     * The record's own page (the host's `hrefForRecord`), absolute or root-relative. When given, Copy
+     * link and Open in new tab carry it instead of the table page with `?record=`.
+     */
+    href?: string;
+    open?: RecordHandler;
+    openInNewTab?: (url: string, record: RecordActionSubject) => void;
+    /** Runs inside the click (the clipboard needs the gesture). */
+    copyText?: (text: string, record: RecordActionSubject) => void | Promise<void>;
+    duplicate?: RecordHandler;
+    history?: RecordHandler;
+    archive?: RecordHandler;
+    /** Why an action whose handler is left out is unavailable here, by id (≤ 60 chars). */
+    unavailableReasons?: Readonly<Record<string, string>>;
+    /** Another lane's record entries; same rules as `TableActionHost.extend`. */
+    extend?: (record: RecordActionSubject, rights: WhatYouMayDo) => readonly ObjectAction[];
+}
+interface RecordActionsInput {
+    record: RecordActionSubject;
+    /** The person's rights on the record (its row level), or on the table when that is all there is. */
+    rights: WhatYouMayDo;
+    host: RecordActionHost;
+}
+/** The one link to a record: the table page with the record open, `<origin>/data-v2/<table>?record=<id>`. */
+declare function recordLink(tableId: string, recordId: string, origin?: string): string;
+/**
+ * THE RECORD'S ACTIONS, in the one order. Same ids, same order, same verbs for every seat and every
+ * host — only `disabledReason` varies.
+ */
+declare function recordActions(input: RecordActionsInput): ObjectAction[];
+
+interface RecordActionHostArgs {
+    tableId: Uuid;
+    row: ReadRow$1;
+    onOpenRecord?: ((recordId: Uuid) => void) | undefined;
+    /** Re-read the surface after a copy or an archive. */
+    onChanged?: (() => void) | undefined;
+}
+/** The handlers a record card's menu runs, bound to this package's client and the host's ports. */
+declare function useRecordActionHost({ tableId, row, onOpenRecord, onChanged }: RecordActionHostArgs): RecordActionHost;
+declare function ObjectActionContextMenuItems({ actions }: {
+    actions: readonly ObjectAction[];
+}): react.JSX.Element;
+interface RecordActionMenuProps extends RecordActionHostArgs {
+    /** The record's name as the card reads it. */
+    name: string;
+    /** The card itself. */
+    children: ReactNode;
+    className?: string | undefined;
+}
+/** A record card with its ⋯ and its right-click, both drawing `recordActions()`. */
+declare function RecordActionMenu({ tableId, row, name, onOpenRecord, onChanged, children, className }: RecordActionMenuProps): react.JSX.Element;
+
+interface ViewActionHost {
+    rename?: () => void;
+    duplicate?: () => void | Promise<void>;
+    archive?: () => void | Promise<void>;
+}
+/** `whyNot`: the person's reason they may not change this table's views, or null when they may. */
+declare function viewActions(whyNot: string | null, host: ViewActionHost): ObjectAction[];
+
+interface RecordPanelProps {
+    tableId: Uuid;
+    recordId: Uuid;
+    /** Put the record away (the rail's close). Absent on a page of its own. */
+    onClose?: (() => void) | undefined;
+    /**
+     * "Who changed this column?" — the rail opens its own panel. Absent, the panel answers in place,
+     * under the history.
+     */
+    onAskAboutField?: ((fieldKey: string) => void) | undefined;
+    /** Drawn as the record's own page (no "Open" link to itself). */
+    onPage?: boolean | undefined;
+}
+declare function RecordPanel({ tableId, recordId, onClose, onAskAboutField, onPage }: RecordPanelProps): react.JSX.Element;
+
+export { ABSENCE_WORD_LABEL, ABSENCE_WORD_VALUES, ACTION_KINDS, ARCHIVED_NEVER_DESTROYED, ARCHIVE_MEANS, type AbsenceWord, AccentSwatches, type AccentSwatchesProps, ActionInbox, type ActionInboxProps, type ActionKind, type AgentBuildAsk, type AnnounceTableArchived, ArchivedDisclosure, type ArchivedDisclosureProps, ArchivedPortals, type ArchivedPortalsProps, ArchivedView, type ArchivedViewProps, BOOKING_NOT_HERE_LINE, BOOKING_PAGE_STATE_LABEL, BOOKING_PAGE_STATE_VALUES, BookingBuilder, type BookingBuilderProps, type BookingPageState, BookingSlots, type BookingSlotsProps, BuildOrAsk, type BuildOrAskProps, type BuildableKind, type ButtonPageBlock, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_REQUIREMENT_KINDS, CHECKLIST_REQUIREMENT_LABEL, CONDITION_OPS, CONTEXT_POLICY_LABEL, ADDABLE_TYPES as CUSTOM_FIELD_ADDABLE_TYPES, type CalendarMode, CalendarView, type CalendarViewProps, 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 ChartPageBlock, type ChartSpec, ChartTooltipContent, ChecklistRunner, type ChecklistRunnerProps, ChecklistTemplateEditor, ChecklistsPanel, type ChecklistsPanelProps, type ChoiceAddition, type ChoiceAsk, ChoiceAskButtons, ChoiceListEditor, type ChoiceListRow, CommentThread, type CommentThreadProps, type ConditionField, ConditionGroup, type ConditionGroupProps, ConditionRow, type ConditionRowProps, type CustomFieldAddRequest, type CustomFieldAddResult, type CustomFieldSetResult, type CustomFieldValuesRequest, type CustomFieldsAgentDoor, type CustomFieldsAgentState, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_FOOTER, DEFAULT_VIEW_NAME, DUE_STATE_LABEL, DashboardCanvas, type DashboardCanvasProps, DigestScheduler, type DigestSchedulerProps, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, ENGINEER_TEXT, ENTITY_REFERENCE_KINDS_MISSING, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, EnrichBadge, type EnrichBadgeProps, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, EntityReferenceKindPicker, type EntityReferenceKindPickerProps, ExampleTables, ExportMenu, type ExportMenuProps, FIELD_RULE_KIND_LABEL, FIELD_RULE_KIND_VALUES, FIELD_SENSITIVITY_LABEL, FIELD_TYPE_CATALOGUE, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FOOTER_WORDS, 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, type FilterPageBlock, type FooterPlacement, type FormAsked, FormBuilder, type FormBuilderProps, type FormFlow, type FormLook, FormLookFrame, type FormLookFrameProps, FormLookLogo, type FormLookView, type FormPageBlock, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, type FormulaOp, Grid, GridCell, type GridContextRecord, type GridContextSnapshot, type GridEditing, type GridGrouping, type GridPresentation, type GridProps, GuessedFieldType, type HeadingPageBlock, HistoryPanel, type HistoryPanelProps, type HostLayout, INBOX_GROUPINGS, INBOX_VIEWS, IN_MEMORY_QUEUE_REASON, type ImportSource, ImportWizard, type ImportWizardProps, InTableToolbar, type InboxGroup, type InboxGrouping, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LOOK_WORDS, type LabelLookup, type LinkRail, type ListPageBlock, MACHINE_IDENTITY, MANUAL_SORT, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, type MainView, type MoveWritten, MyChecklistSteps, NEEDS_A_SENTENCE, 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, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, ObjectAction, ObjectActionContextMenuItems, ObjectActionGlyph, ObjectActionIcon, ObjectActionMenuItems, type ObjectActionMenuItemsProps, type OpenRecordsAsk, type OrganizationMember, PAGE_BLOCK_KINDS, PAGE_BLOCK_LABEL, PAGE_KIND, PAGE_VIEWS, PAGE_VIEW_LABEL, PARITY_LABEL, PARITY_MADE_OF, PORTAL_NOT_HERE_LINE, PROPOSED_CHANGE_ACT_LABEL, PROPOSED_CHANGE_ACT_VALUES, type PageBlock, type PageBlockKind, PageScreen, type PageScreenProps, type PageView, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, PickOrAdd, type PickOrAddItem, type PickOrAddProps, type PickableFieldType, type PickerTable, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalBuilder, type PortalBuilderProps, PortalCardView, type PortalCardViewProps, PortalLookEditor, type PortalLookEditorProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, type ProposedChangeAct, ProvenanceBadge, PublicPicturePicker, type PublicPicturePickerProps, PublicViewPage, type PublicViewPageProps, QUESTION_OPS, QUESTION_SURFACE, type QuestionAnswer, type QuestionGroup, type QuestionMeasure, type QuestionOp, QuestionPanel, type QuestionPanelProps, type QuestionRow, type QuestionShow, type QuestionSpec, ROLLUP_AGG_LABEL, ROLLUP_AGG_VALUES, RULE_NOT_HERE_LINE, type ReaskContext, type RecordActionHost, RecordActionMenu, type RecordActionMenuProps, type RecordActionSubject, type RecordActionsInput, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, type RecordMoves, type RecordPageBlock, RecordPanel, type RecordPanelProps, RecordValue, RecordsMount, type RecordsMountProps, RecordsTableCard, type RecordsTableCardProps, type RecordsUiHost, RecordsUiProvider, ReferenceBuilder, type ReferenceBuilderProps, type ReferenceChoice, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, type RenderTextSlot, type ResolveName, type RollupAgg, SAVED_VIEWS_UNAVAILABLE, SAVE_TO_TABLE_TYPES, SAY_WHAT_YOU_ARE_WAITING_FOR_AFTER_MS, SECTIONS_UNKNOWN, SERIES_COLORS, SHARE_NOT_YOURS_LINE, SIGNED_WORD, SOMEBODY, STAGE_RULE_ON_FAIL_LABEL, STORE_ANSWERS_THESE, STORE_DECIDES_REASON, STORE_KEEPS_TIMELINE, STORE_KEPT_LAYOUTS, SUBSCRIPTION_CADENCES, SUBSCRIPTION_CADENCE_LABEL, SUBSCRIPTION_CHANNEL_LABEL, SUBSCRIPTION_CHANNEL_VALUES, SaveToTable, type SaveToTableProps, type SaveToTableSource, type SavedDashboard, type SavedForm, type SavedQuestion, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, ShowListsToggle, type ShownViewReport, SignBlock, type SignBlockProps, SignaturePad, SignatureValue, type SnoozeChoice, type SortStateAction, SortStateControl, type SortStateControlProps, StageRulesSection, type StageRulesSectionProps, StepRow, type SubscriptionChannel, SubscriptionsPanel, type SubscriptionsPanelProps, type Surface, type SurfacePress, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NAME_MAX, TABLE_NOT_REACHABLE, THE_SYSTEM, TIMELINE_ZOOMS, TableActionHost, TableFoundationSwitch, type TableLane, type TableOpening, TablePage, type TablePageActionHost, type TablePageHeaderChrome, type TablePageProps, type TablePickerEntries, type TablePickerEntry, TableRenameDialog, TableRestoreRefused, type TableRights, TableSettings, type TableSettingsProps, TableShape, TableToolbarSlotContext, TablesHome, type TablesHomeProps, type TextPageBlock, type ThroughCondition, type TimelineSettings, TimelineView, type TimelineViewProps, type TimelineZoom, type TrackedVersion, UNREAD_RECORD_LABEL, type UseSystemTableState, VIEW_KEYS, VIEW_LAYOUTS, VIEW_NEEDS, VIEW_NOT_SAVED_YET, VISIBILITY_LANES, VISIBILITY_LANE_TITLE, ViewBar, type ViewBarProps, type ViewKeyDeclaration, type ViewKeyLayout, type ViewKeyWriter, type ViewLayout, type ViewLook, type ViewNeed, type ViewNeedKind, ViewNeeds, type ViewNeedsProps, type ViewSettings, type ViewSettingsPatch, type ViewSort, type ViewSortKey, ViewSwitcher, type ViewSwitcherProps, type VisibilityLane, WITHHELD_RECORD_LABEL, WITHHELD_WORD, WORK_APPROVAL_STATES, WORK_APPROVAL_STATE_LABEL, WORK_DUE_STATES, WORK_INBOX_KINDS, WORK_INBOX_KIND_GROUP_LABEL, WORK_INBOX_KIND_LABEL, WhatYouMayDo, WhereItLives, type WhereItLivesProps, type WhoChanged, WhoChangedSource, WithheldValue, actorBadge, actorWords, addDays, announceTableArchived, applyLook, archiveConfirmSentence, archivedRowLine, asRefusal, askQuestion, askableFields, blockFromSpec, bodyForReading, bodyFromKeys, calendarDayLabel, calendarDayOf, cameFromLine, cardTitleField, cardWords, carriesTimeOfDay, cellState, choiceAddition, choiceAskSentence, choiceListPatch, choiceNudgeOf, choiceRowsFrom, chooseSurface, colorFromTheValue, columnDeclarationFor, columnForField, combineFilter, conditionInWords, conditionIsDrawable, conditionIsSimple, conditionValue, controlFor, currencyCodeFor, customFieldRequestProblems, dashboardDeclareArgs, dashboardFromSummary, dateFormatFor, dateText, dayAt, dayKeyOf, daysBetween, declareView, defaultViewOf, designatedLayoutOf, drawnSignatureOf, drillDimensionsOf, drillMeasuresOf, drillPathsOf, drillWhere, editorKindFor, ensureSystemTable, entityReferenceSpec, envelopeFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, filterTargets, flatWhere, footerOf, formDeclareArgs, formFromSummary, formLookDocument, formLookFromDocument, formLookView, formPresentation, formatForField, freeColumnName, freshFormName, gridContextKey, gridContextSnapshot, groupInbox, groupLabel, groupableFields, handOrderLine, handOrderSortState, hasTimePart, hintForAPerson, hintIsMachineIdentity, idsOf, isChoiceAddition, isDateField, isEngineerText, isFoundationTable, isId, isKeptTable, isMachineIdentity, isPage, isParityFieldType, isPlainFieldType, isRelationFieldType, isSignatureField, isValueSet, keepLook, keptByTheApp, keyFor, kindsWithNoChoice, laneFor, lastChangeSentence, lookDiffers, lookDocument, lookFromDocument, lookPart, looksLikeId, machineIdentityIn, mayNotRestoreLine, measurableFields, memberName, moveRecordValue, newQuestion, nextInWords, nextSummaryAt, notAChoiceSentence, onlyCandidate, openingRail, openingView, packOverlaps, pageBlocksOf, pagePresentation, pageViewFromParam, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pickableTypeOf, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, previewWords, publiclyAnswerable, questionArchive, questionFromDefinition, questionSave, questionsOf, railFromParam, readLooks, recordActions, recordLink, recordName, recordNameIn, recordsDataSource, refusal, refusalForAPerson, refusalFromThrown, refusalLineForAPerson, refusalOr, renderValue, rescheduledValue, resolveTableStyle, revokeConsequence, rowName, rowNameIn, saveToViewPlan, saveViewPatch, scalarText, seedIsSatisfied, shapesOfSource, shareUnavailableReason, signatureFileIn, signatureFileOf, signatureWords, singularNoun, snoozeChoices, specFromBlock, starterPageBlocks, storeDecidesRights, storeKeepsLayout, storePublishesKind, styleFromDecorations, submissionStamp, surfaceChosen, tableName, tableNameProblem, tableOpening, tablePickerEntries, tableRightsAt, unknownRailLine, unknownViewLine, unreadableKeys, useCanShare, useChoiceNudge, useDrill, useDrillAnswers, useDrillDefinition, useEmbedHandshake, useEnrichCells, useGridEditing, useLabelWait, useMeasuredWidth, useMyChecklistSteps, usePickerTables, useRecordActionHost, useRecordLabels, useRecordMoves, useRecordRights, useRecordsUi, useRowColorBy, useRowRights, useSystemTable, useTableRights, useTableToolbarSlot, useViewRecords, useWhoChanged, viewActions, viewDocument, viewFromRow, viewKeysFor, viewNeedFor, viewPatchDocument, viewSettings, viewSettingsFor, viewSettingsPatch, visibilityLaneFor, whatIsMissing, whatIsMissingForEntityReference, whatTheChoiceListIsMissing, whenWords, whyNotAskable, withheldNoticeOf, withheldSentence, withoutAddition, wordsList };