@ai-matrx/records-ui 0.85.15 → 0.85.17

package/dist/index.d.cts

@@ -2418,6 +2418,44 @@ declare function viewSettingsFor(settings: ViewSettings, layout: ViewKeyLayout):
  */
 declare function viewSettingsPatch(patch: ViewSettingsPatch): Record<string, unknown>;
 
+/**
+ * WHAT A LOOK MAY HOLD — how a person looks, never what the view is: not its name, not whether it
+ * is the default (`view_designate`), not its Rule, not the flat filters the digests read, not the
+ * order the store writes. The store refuses anything else by name.
+ */
+type ViewLook = Partial<Pick<SavedViewSpec, "layout" | "groupField" | "swimlaneField" | "collapsedColumns" | "measure" | "dateField" | "imageField" | "sorts" | "where" | "presentation">>;
+/** Only the look's own keys of a press — a name, a default, a Rule or an order is never a look. */
+declare function lookPart(patch: Partial<SavedViewSpec>): ViewLook;
+/** The look as the definition keys the store keeps (`view_look_set`); a cleared key is null. */
+declare function lookDocument(look: ViewLook): Record<string, unknown>;
+/** A kept look back into the spec's words. Only the keys it holds; a null key is "none, for me". */
+declare function lookFromDocument(doc: Record<string, unknown> | null | undefined): ViewLook;
+/** THE VIEW AS THIS PERSON SEES IT: the saved view, with her look laid over it. */
+declare function applyLook(view: SavedView, look: ViewLook | null | undefined): SavedView;
+/** Whether the look shows anything the view does not — which is when "Save to view" means something. */
+declare function lookDiffers(view: SavedView, look: ViewLook | null | undefined): boolean;
+/**
+ * WHAT "SAVE TO VIEW" SENDS, and what stays the person's own afterwards. The default view's layout
+ * is the table's designation (`viewPatchFor`): it is never saved here — "Make … the default" is —
+ * so a look's layout on the default view stays her look.
+ */
+declare function saveToViewPlan(view: SavedView, look: ViewLook): {
+    patch: Partial<SavedViewSpec>;
+    left: ViewLook | null;
+};
+/** The caller's own looks at every view of a table, by view id. */
+declare function readLooks(client: Pick<RecordsClient, "viewLookRead">, tableId: Uuid$1): Promise<RecordsResult<Record<string, ViewLook>>>;
+/** Keep the whole look (null: "Reset to view"). The shared view is never written. */
+declare function keepLook(client: Pick<RecordsClient, "viewLookSet">, tableId: Uuid$1, viewId: Uuid$1, look: ViewLook | null): Promise<RecordsResult<Record<string, unknown> | null>>;
+/** The words of the look bar. One sentence, then the doors. */
+declare const LOOK_WORDS: {
+    readonly yours: "You changed how this view looks. Only you see it.";
+    readonly saveToView: "Save to view";
+    readonly saveAsNew: "Save as new view";
+    readonly reset: "Reset to view";
+    readonly newName: "Name for the new view";
+};
+
 interface ViewSwitcherProps {
     /**
      * THE DECLARATIVE SPEC — an agent writes the whole thing, a person tweaks it.
@@ -4352,4 +4390,4 @@ interface PipelineBoardProps {
 }
 declare function PipelineBoard({ tableId, rows, titleKey, measure, filter, onMeasureChange, onOpenRecord, onMoved, style, dateFields, className, }: PipelineBoardProps): react.JSX.Element;
 
-export { ABSENCE_WORD_LABEL, ABSENCE_WORD_VALUES, ACTION_KINDS, ARCHIVED_NEVER_DESTROYED, ARCHIVE_MEANS, type AbsenceWord, ActionInbox, type ActionInboxProps, type ActionKind, type AgentBuildAsk, ArchivedDisclosure, type ArchivedDisclosureProps, ArchivedPortals, type ArchivedPortalsProps, ArchivedView, type ArchivedViewProps, BOOKING_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, 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_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, ExportMenu, type ExportMenuProps, FIELD_RULE_KIND_LABEL, FIELD_RULE_KIND_VALUES, FIELD_SENSITIVITY_LABEL, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORMULA_OP_JOINS, FORMULA_OP_LABEL, FORMULA_OP_VALUES, FORM_FLOWS, FORM_NOT_HERE_LINE, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldHistoryPanel, type FieldHistoryPanelProps, FieldLabel, type FieldProposalRow, type FieldRuleKindValue, type FieldTypeChoice, FilePicker, type FilePickerProps, type FormAsked, 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, type HostLayout, INBOX_GROUPINGS, INBOX_VIEWS, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, type InboxGroup, type InboxGrouping, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, type LabelLookup, type LinkRail, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, type MainView, MyChecklistSteps, NEEDS_A_SENTENCE, NOT_ANSWERED_YET, NOT_DRAWN_HERE, NO_AGENT_PORT, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_RULES_YET, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PAGE_VIEWS, PAGE_VIEW_LABEL, PARITY_LABEL, PARITY_MADE_OF, PORTAL_NOT_HERE_LINE, PROPOSED_CHANGE_ACT_LABEL, PROPOSED_CHANGE_ACT_VALUES, type PageView, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalBuilder, type PortalBuilderProps, PortalCardView, type PortalCardViewProps, PortalLookEditor, type PortalLookEditorProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, type ProposedChangeAct, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, ROLLUP_AGG_LABEL, ROLLUP_AGG_VALUES, RULE_NOT_HERE_LINE, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, ReferenceBuilder, type ReferenceBuilderProps, type ReferenceChoice, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, type RenderTextSlot, type ResolveName, type RollupAgg, SAVED_VIEWS_UNAVAILABLE, SAY_WHAT_YOU_ARE_WAITING_FOR_AFTER_MS, SECTIONS_UNKNOWN, SERIES_COLORS, SHARE_NOT_YOURS_LINE, SOMEBODY, STAGE_RULE_ON_FAIL_LABEL, STORE_ANSWERS_THESE, STORE_DECIDES_REASON, SUBSCRIPTION_CADENCES, SUBSCRIPTION_CADENCE_LABEL, SUBSCRIPTION_CHANNEL_LABEL, SUBSCRIPTION_CHANNEL_VALUES, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, type SnoozeChoice, StageRulesSection, type StageRulesSectionProps, StepRow, type SubscriptionChannel, SubscriptionsPanel, type SubscriptionsPanelProps, type Surface, type SurfacePress, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_MENU, TABLE_NOT_REACHABLE, THE_SYSTEM, type TableLane, type TableOpening, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_KEYS, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VISIBILITY_LANES, VISIBILITY_LANE_TITLE, ViewBar, type ViewBarProps, type ViewKeyDeclaration, type ViewKeyLayout, type ViewKeyWriter, type ViewLayout, 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, type WhatYouMayDo, WhereItLives, type WhereItLivesProps, type WhoChanged, WhoChangedSource, WithheldValue, actorBadge, actorWords, archivedRowLine, asRefusal, askableFields, blockFromSpec, bodyForReading, bodyFromKeys, calendarDayLabel, calendarDayOf, cameFromLine, cardTitleField, cardWords, carriesTimeOfDay, cellState, chooseSurface, colorFromTheValue, columnForField, conditionInWords, conditionIsDrawable, conditionIsSimple, conditionValue, controlFor, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, dateFormatFor, dateText, declareView, defaultViewOf, designatedLayoutOf, editorKindFor, ensureSystemTable, entityReferenceSpec, envelopeFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupInbox, groupLabel, hasTimePart, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isDateField, isEngineerText, isId, isMachineIdentity, isParityFieldType, isPlainFieldType, isRelationFieldType, isSignatureField, keptByTheApp, keyFor, kindsWithNoChoice, laneFor, lastChangeSentence, looksLikeId, machineIdentityIn, mayNotRestoreLine, memberName, nextInWords, nextSummaryAt, openingRail, openingView, pageViewFromParam, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, previewWords, publiclyAnswerable, railFromParam, recordName, recordNameIn, recordsDataSource, refusal, refusalForAPerson, refusalFromThrown, refusalLineForAPerson, refusalOr, renderValue, resolveTableStyle, revokeConsequence, rowName, rowNameIn, saveViewPatch, scalarText, seedIsSatisfied, shareUnavailableReason, snoozeChoices, specFromBlock, storeDecidesRights, styleFromDecorations, submissionStamp, surfaceChosen, tableName, tableOpening, tableRightsAt, unknownRailLine, unknownViewLine, useCanShare, useEmbedHandshake, useEnrichCells, useGridEditing, useLabelWait, useMeasuredWidth, useMyChecklistSteps, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, useWhoChanged, viewDocument, viewFromRow, viewKeysFor, viewPatchDocument, viewSettings, viewSettingsFor, viewSettingsPatch, visibilityLaneFor, whatIsMissing, whatIsMissingForEntityReference, whatYouMayDo, whatYouMayDoWithTable, whenWords, whyNotAskable, withheldNoticeOf, withheldSentence };
+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_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, 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_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, ExportMenu, type ExportMenuProps, FIELD_RULE_KIND_LABEL, FIELD_RULE_KIND_VALUES, FIELD_SENSITIVITY_LABEL, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORMULA_OP_JOINS, FORMULA_OP_LABEL, FORMULA_OP_VALUES, FORM_FLOWS, FORM_NOT_HERE_LINE, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldHistoryPanel, type FieldHistoryPanelProps, FieldLabel, type FieldProposalRow, type FieldRuleKindValue, type FieldTypeChoice, FilePicker, type FilePickerProps, type FormAsked, 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, type HostLayout, INBOX_GROUPINGS, INBOX_VIEWS, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, type InboxGroup, type InboxGrouping, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, LOOK_WORDS, type LabelLookup, type LinkRail, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, type MainView, MyChecklistSteps, NEEDS_A_SENTENCE, NOT_ANSWERED_YET, NOT_DRAWN_HERE, NO_AGENT_PORT, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_RULES_YET, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PAGE_VIEWS, PAGE_VIEW_LABEL, PARITY_LABEL, PARITY_MADE_OF, PORTAL_NOT_HERE_LINE, PROPOSED_CHANGE_ACT_LABEL, PROPOSED_CHANGE_ACT_VALUES, type PageView, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalBuilder, type PortalBuilderProps, PortalCardView, type PortalCardViewProps, PortalLookEditor, type PortalLookEditorProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, type ProposedChangeAct, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, ROLLUP_AGG_LABEL, ROLLUP_AGG_VALUES, RULE_NOT_HERE_LINE, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, ReferenceBuilder, type ReferenceBuilderProps, type ReferenceChoice, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, type RenderTextSlot, type ResolveName, type RollupAgg, SAVED_VIEWS_UNAVAILABLE, SAY_WHAT_YOU_ARE_WAITING_FOR_AFTER_MS, SECTIONS_UNKNOWN, SERIES_COLORS, SHARE_NOT_YOURS_LINE, SOMEBODY, STAGE_RULE_ON_FAIL_LABEL, STORE_ANSWERS_THESE, STORE_DECIDES_REASON, SUBSCRIPTION_CADENCES, SUBSCRIPTION_CADENCE_LABEL, SUBSCRIPTION_CHANNEL_LABEL, SUBSCRIPTION_CHANNEL_VALUES, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, type SnoozeChoice, StageRulesSection, type StageRulesSectionProps, StepRow, type SubscriptionChannel, SubscriptionsPanel, type SubscriptionsPanelProps, type Surface, type SurfacePress, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_MENU, TABLE_NOT_REACHABLE, THE_SYSTEM, type TableLane, type TableOpening, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_KEYS, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VISIBILITY_LANES, VISIBILITY_LANE_TITLE, ViewBar, type ViewBarProps, type ViewKeyDeclaration, type ViewKeyLayout, type ViewKeyWriter, type ViewLayout, type ViewLook, 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, type WhatYouMayDo, WhereItLives, type WhereItLivesProps, type WhoChanged, WhoChangedSource, WithheldValue, actorBadge, actorWords, applyLook, archivedRowLine, asRefusal, askableFields, blockFromSpec, bodyForReading, bodyFromKeys, calendarDayLabel, calendarDayOf, cameFromLine, cardTitleField, cardWords, carriesTimeOfDay, cellState, chooseSurface, colorFromTheValue, columnForField, conditionInWords, conditionIsDrawable, conditionIsSimple, conditionValue, controlFor, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, dateFormatFor, dateText, declareView, defaultViewOf, designatedLayoutOf, editorKindFor, ensureSystemTable, entityReferenceSpec, envelopeFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupInbox, groupLabel, hasTimePart, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isDateField, isEngineerText, isId, isMachineIdentity, isParityFieldType, isPlainFieldType, isRelationFieldType, isSignatureField, keepLook, keptByTheApp, keyFor, kindsWithNoChoice, laneFor, lastChangeSentence, lookDiffers, lookDocument, lookFromDocument, lookPart, looksLikeId, machineIdentityIn, mayNotRestoreLine, memberName, nextInWords, nextSummaryAt, openingRail, openingView, pageViewFromParam, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, previewWords, publiclyAnswerable, railFromParam, readLooks, recordName, recordNameIn, recordsDataSource, refusal, refusalForAPerson, refusalFromThrown, refusalLineForAPerson, refusalOr, renderValue, resolveTableStyle, revokeConsequence, rowName, rowNameIn, saveToViewPlan, saveViewPatch, scalarText, seedIsSatisfied, shareUnavailableReason, snoozeChoices, specFromBlock, storeDecidesRights, styleFromDecorations, submissionStamp, surfaceChosen, tableName, tableOpening, tableRightsAt, unknownRailLine, unknownViewLine, useCanShare, useEmbedHandshake, useEnrichCells, useGridEditing, useLabelWait, useMeasuredWidth, useMyChecklistSteps, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, useWhoChanged, viewDocument, viewFromRow, viewKeysFor, viewPatchDocument, viewSettings, viewSettingsFor, viewSettingsPatch, visibilityLaneFor, whatIsMissing, whatIsMissingForEntityReference, whatYouMayDo, whatYouMayDoWithTable, whenWords, whyNotAskable, withheldNoticeOf, withheldSentence };

package/dist/index.d.ts

@@ -2418,6 +2418,44 @@ declare function viewSettingsFor(settings: ViewSettings, layout: ViewKeyLayout):
  */
 declare function viewSettingsPatch(patch: ViewSettingsPatch): Record<string, unknown>;
 
+/**
+ * WHAT A LOOK MAY HOLD — how a person looks, never what the view is: not its name, not whether it
+ * is the default (`view_designate`), not its Rule, not the flat filters the digests read, not the
+ * order the store writes. The store refuses anything else by name.
+ */
+type ViewLook = Partial<Pick<SavedViewSpec, "layout" | "groupField" | "swimlaneField" | "collapsedColumns" | "measure" | "dateField" | "imageField" | "sorts" | "where" | "presentation">>;
+/** Only the look's own keys of a press — a name, a default, a Rule or an order is never a look. */
+declare function lookPart(patch: Partial<SavedViewSpec>): ViewLook;
+/** The look as the definition keys the store keeps (`view_look_set`); a cleared key is null. */
+declare function lookDocument(look: ViewLook): Record<string, unknown>;
+/** A kept look back into the spec's words. Only the keys it holds; a null key is "none, for me". */
+declare function lookFromDocument(doc: Record<string, unknown> | null | undefined): ViewLook;
+/** THE VIEW AS THIS PERSON SEES IT: the saved view, with her look laid over it. */
+declare function applyLook(view: SavedView, look: ViewLook | null | undefined): SavedView;
+/** Whether the look shows anything the view does not — which is when "Save to view" means something. */
+declare function lookDiffers(view: SavedView, look: ViewLook | null | undefined): boolean;
+/**
+ * WHAT "SAVE TO VIEW" SENDS, and what stays the person's own afterwards. The default view's layout
+ * is the table's designation (`viewPatchFor`): it is never saved here — "Make … the default" is —
+ * so a look's layout on the default view stays her look.
+ */
+declare function saveToViewPlan(view: SavedView, look: ViewLook): {
+    patch: Partial<SavedViewSpec>;
+    left: ViewLook | null;
+};
+/** The caller's own looks at every view of a table, by view id. */
+declare function readLooks(client: Pick<RecordsClient, "viewLookRead">, tableId: Uuid$1): Promise<RecordsResult<Record<string, ViewLook>>>;
+/** Keep the whole look (null: "Reset to view"). The shared view is never written. */
+declare function keepLook(client: Pick<RecordsClient, "viewLookSet">, tableId: Uuid$1, viewId: Uuid$1, look: ViewLook | null): Promise<RecordsResult<Record<string, unknown> | null>>;
+/** The words of the look bar. One sentence, then the doors. */
+declare const LOOK_WORDS: {
+    readonly yours: "You changed how this view looks. Only you see it.";
+    readonly saveToView: "Save to view";
+    readonly saveAsNew: "Save as new view";
+    readonly reset: "Reset to view";
+    readonly newName: "Name for the new view";
+};
+
 interface ViewSwitcherProps {
     /**
      * THE DECLARATIVE SPEC — an agent writes the whole thing, a person tweaks it.
@@ -4352,4 +4390,4 @@ interface PipelineBoardProps {
 }
 declare function PipelineBoard({ tableId, rows, titleKey, measure, filter, onMeasureChange, onOpenRecord, onMoved, style, dateFields, className, }: PipelineBoardProps): react.JSX.Element;
 
-export { ABSENCE_WORD_LABEL, ABSENCE_WORD_VALUES, ACTION_KINDS, ARCHIVED_NEVER_DESTROYED, ARCHIVE_MEANS, type AbsenceWord, ActionInbox, type ActionInboxProps, type ActionKind, type AgentBuildAsk, ArchivedDisclosure, type ArchivedDisclosureProps, ArchivedPortals, type ArchivedPortalsProps, ArchivedView, type ArchivedViewProps, BOOKING_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, 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_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, ExportMenu, type ExportMenuProps, FIELD_RULE_KIND_LABEL, FIELD_RULE_KIND_VALUES, FIELD_SENSITIVITY_LABEL, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORMULA_OP_JOINS, FORMULA_OP_LABEL, FORMULA_OP_VALUES, FORM_FLOWS, FORM_NOT_HERE_LINE, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldHistoryPanel, type FieldHistoryPanelProps, FieldLabel, type FieldProposalRow, type FieldRuleKindValue, type FieldTypeChoice, FilePicker, type FilePickerProps, type FormAsked, 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, type HostLayout, INBOX_GROUPINGS, INBOX_VIEWS, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, type InboxGroup, type InboxGrouping, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, type LabelLookup, type LinkRail, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, type MainView, MyChecklistSteps, NEEDS_A_SENTENCE, NOT_ANSWERED_YET, NOT_DRAWN_HERE, NO_AGENT_PORT, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_RULES_YET, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PAGE_VIEWS, PAGE_VIEW_LABEL, PARITY_LABEL, PARITY_MADE_OF, PORTAL_NOT_HERE_LINE, PROPOSED_CHANGE_ACT_LABEL, PROPOSED_CHANGE_ACT_VALUES, type PageView, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalBuilder, type PortalBuilderProps, PortalCardView, type PortalCardViewProps, PortalLookEditor, type PortalLookEditorProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, type ProposedChangeAct, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, ROLLUP_AGG_LABEL, ROLLUP_AGG_VALUES, RULE_NOT_HERE_LINE, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, ReferenceBuilder, type ReferenceBuilderProps, type ReferenceChoice, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, type RenderTextSlot, type ResolveName, type RollupAgg, SAVED_VIEWS_UNAVAILABLE, SAY_WHAT_YOU_ARE_WAITING_FOR_AFTER_MS, SECTIONS_UNKNOWN, SERIES_COLORS, SHARE_NOT_YOURS_LINE, SOMEBODY, STAGE_RULE_ON_FAIL_LABEL, STORE_ANSWERS_THESE, STORE_DECIDES_REASON, SUBSCRIPTION_CADENCES, SUBSCRIPTION_CADENCE_LABEL, SUBSCRIPTION_CHANNEL_LABEL, SUBSCRIPTION_CHANNEL_VALUES, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, type SnoozeChoice, StageRulesSection, type StageRulesSectionProps, StepRow, type SubscriptionChannel, SubscriptionsPanel, type SubscriptionsPanelProps, type Surface, type SurfacePress, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_MENU, TABLE_NOT_REACHABLE, THE_SYSTEM, type TableLane, type TableOpening, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_KEYS, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VISIBILITY_LANES, VISIBILITY_LANE_TITLE, ViewBar, type ViewBarProps, type ViewKeyDeclaration, type ViewKeyLayout, type ViewKeyWriter, type ViewLayout, 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, type WhatYouMayDo, WhereItLives, type WhereItLivesProps, type WhoChanged, WhoChangedSource, WithheldValue, actorBadge, actorWords, archivedRowLine, asRefusal, askableFields, blockFromSpec, bodyForReading, bodyFromKeys, calendarDayLabel, calendarDayOf, cameFromLine, cardTitleField, cardWords, carriesTimeOfDay, cellState, chooseSurface, colorFromTheValue, columnForField, conditionInWords, conditionIsDrawable, conditionIsSimple, conditionValue, controlFor, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, dateFormatFor, dateText, declareView, defaultViewOf, designatedLayoutOf, editorKindFor, ensureSystemTable, entityReferenceSpec, envelopeFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupInbox, groupLabel, hasTimePart, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isDateField, isEngineerText, isId, isMachineIdentity, isParityFieldType, isPlainFieldType, isRelationFieldType, isSignatureField, keptByTheApp, keyFor, kindsWithNoChoice, laneFor, lastChangeSentence, looksLikeId, machineIdentityIn, mayNotRestoreLine, memberName, nextInWords, nextSummaryAt, openingRail, openingView, pageViewFromParam, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, previewWords, publiclyAnswerable, railFromParam, recordName, recordNameIn, recordsDataSource, refusal, refusalForAPerson, refusalFromThrown, refusalLineForAPerson, refusalOr, renderValue, resolveTableStyle, revokeConsequence, rowName, rowNameIn, saveViewPatch, scalarText, seedIsSatisfied, shareUnavailableReason, snoozeChoices, specFromBlock, storeDecidesRights, styleFromDecorations, submissionStamp, surfaceChosen, tableName, tableOpening, tableRightsAt, unknownRailLine, unknownViewLine, useCanShare, useEmbedHandshake, useEnrichCells, useGridEditing, useLabelWait, useMeasuredWidth, useMyChecklistSteps, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, useWhoChanged, viewDocument, viewFromRow, viewKeysFor, viewPatchDocument, viewSettings, viewSettingsFor, viewSettingsPatch, visibilityLaneFor, whatIsMissing, whatIsMissingForEntityReference, whatYouMayDo, whatYouMayDoWithTable, whenWords, whyNotAskable, withheldNoticeOf, withheldSentence };
+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_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, 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_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, ExportMenu, type ExportMenuProps, FIELD_RULE_KIND_LABEL, FIELD_RULE_KIND_VALUES, FIELD_SENSITIVITY_LABEL, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORMULA_OP_JOINS, FORMULA_OP_LABEL, FORMULA_OP_VALUES, FORM_FLOWS, FORM_NOT_HERE_LINE, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldHistoryPanel, type FieldHistoryPanelProps, FieldLabel, type FieldProposalRow, type FieldRuleKindValue, type FieldTypeChoice, FilePicker, type FilePickerProps, type FormAsked, 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, type HostLayout, INBOX_GROUPINGS, INBOX_VIEWS, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, type InboxGroup, type InboxGrouping, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, LOOK_WORDS, type LabelLookup, type LinkRail, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, type MainView, MyChecklistSteps, NEEDS_A_SENTENCE, NOT_ANSWERED_YET, NOT_DRAWN_HERE, NO_AGENT_PORT, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_RULES_YET, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PAGE_VIEWS, PAGE_VIEW_LABEL, PARITY_LABEL, PARITY_MADE_OF, PORTAL_NOT_HERE_LINE, PROPOSED_CHANGE_ACT_LABEL, PROPOSED_CHANGE_ACT_VALUES, type PageView, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalBuilder, type PortalBuilderProps, PortalCardView, type PortalCardViewProps, PortalLookEditor, type PortalLookEditorProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, type ProposedChangeAct, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, ROLLUP_AGG_LABEL, ROLLUP_AGG_VALUES, RULE_NOT_HERE_LINE, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, ReferenceBuilder, type ReferenceBuilderProps, type ReferenceChoice, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, type RenderTextSlot, type ResolveName, type RollupAgg, SAVED_VIEWS_UNAVAILABLE, SAY_WHAT_YOU_ARE_WAITING_FOR_AFTER_MS, SECTIONS_UNKNOWN, SERIES_COLORS, SHARE_NOT_YOURS_LINE, SOMEBODY, STAGE_RULE_ON_FAIL_LABEL, STORE_ANSWERS_THESE, STORE_DECIDES_REASON, SUBSCRIPTION_CADENCES, SUBSCRIPTION_CADENCE_LABEL, SUBSCRIPTION_CHANNEL_LABEL, SUBSCRIPTION_CHANNEL_VALUES, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, type SnoozeChoice, StageRulesSection, type StageRulesSectionProps, StepRow, type SubscriptionChannel, SubscriptionsPanel, type SubscriptionsPanelProps, type Surface, type SurfacePress, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_MENU, TABLE_NOT_REACHABLE, THE_SYSTEM, type TableLane, type TableOpening, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_KEYS, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VISIBILITY_LANES, VISIBILITY_LANE_TITLE, ViewBar, type ViewBarProps, type ViewKeyDeclaration, type ViewKeyLayout, type ViewKeyWriter, type ViewLayout, type ViewLook, 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, type WhatYouMayDo, WhereItLives, type WhereItLivesProps, type WhoChanged, WhoChangedSource, WithheldValue, actorBadge, actorWords, applyLook, archivedRowLine, asRefusal, askableFields, blockFromSpec, bodyForReading, bodyFromKeys, calendarDayLabel, calendarDayOf, cameFromLine, cardTitleField, cardWords, carriesTimeOfDay, cellState, chooseSurface, colorFromTheValue, columnForField, conditionInWords, conditionIsDrawable, conditionIsSimple, conditionValue, controlFor, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, dateFormatFor, dateText, declareView, defaultViewOf, designatedLayoutOf, editorKindFor, ensureSystemTable, entityReferenceSpec, envelopeFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupInbox, groupLabel, hasTimePart, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isDateField, isEngineerText, isId, isMachineIdentity, isParityFieldType, isPlainFieldType, isRelationFieldType, isSignatureField, keepLook, keptByTheApp, keyFor, kindsWithNoChoice, laneFor, lastChangeSentence, lookDiffers, lookDocument, lookFromDocument, lookPart, looksLikeId, machineIdentityIn, mayNotRestoreLine, memberName, nextInWords, nextSummaryAt, openingRail, openingView, pageViewFromParam, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, previewWords, publiclyAnswerable, railFromParam, readLooks, recordName, recordNameIn, recordsDataSource, refusal, refusalForAPerson, refusalFromThrown, refusalLineForAPerson, refusalOr, renderValue, resolveTableStyle, revokeConsequence, rowName, rowNameIn, saveToViewPlan, saveViewPatch, scalarText, seedIsSatisfied, shareUnavailableReason, snoozeChoices, specFromBlock, storeDecidesRights, styleFromDecorations, submissionStamp, surfaceChosen, tableName, tableOpening, tableRightsAt, unknownRailLine, unknownViewLine, useCanShare, useEmbedHandshake, useEnrichCells, useGridEditing, useLabelWait, useMeasuredWidth, useMyChecklistSteps, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, useWhoChanged, viewDocument, viewFromRow, viewKeysFor, viewPatchDocument, viewSettings, viewSettingsFor, viewSettingsPatch, visibilityLaneFor, whatIsMissing, whatIsMissingForEntityReference, whatYouMayDo, whatYouMayDoWithTable, whenWords, whyNotAskable, withheldNoticeOf, withheldSentence };

package/dist/index.js

@@ -10607,6 +10607,86 @@ function computedInPlainWords(row, field) {
   return `${name} was worked out as ${shown3}${at}.`;
 }
 
+// src/viewLook.ts
+var LOOK_KEYS = [
+  "layout",
+  "groupField",
+  "swimlaneField",
+  "collapsedColumns",
+  "measure",
+  "dateField",
+  "imageField",
+  "sorts",
+  "where",
+  "presentation"
+];
+function lookPart(patch) {
+  const out = {};
+  for (const key of LOOK_KEYS) {
+    if (patch[key] !== void 0) out[key] = patch[key];
+  }
+  return out;
+}
+function lookDocument(look) {
+  return viewSettingsPatch(look);
+}
+function lookFromDocument(doc) {
+  const data = doc ?? {};
+  const read = viewSettings(data);
+  const out = {};
+  const has = (key) => Object.prototype.hasOwnProperty.call(data, key);
+  if (has("layout") && VIEW_LAYOUTS.includes(String(data["layout"]))) {
+    out.layout = data["layout"];
+  }
+  if (has("group_field")) out.groupField = read.groupField;
+  if (has("swimlane_field")) out.swimlaneField = read.swimlaneField;
+  if (has("collapsed_columns")) out.collapsedColumns = read.collapsedColumns;
+  if (has("measure")) out.measure = read.measure;
+  if (has("date_field")) out.dateField = read.dateField;
+  if (has("image_field")) out.imageField = read.imageField;
+  if (has("sorts")) out.sorts = read.sorts;
+  if (has("where")) out.where = read.where;
+  if (has("presentation")) out.presentation = parseGridPresentation(data["presentation"]);
+  return out;
+}
+function applyLook(view, look) {
+  if (!look) return view;
+  return { ...view, ...look };
+}
+function lookDiffers(view, look) {
+  if (!look) return false;
+  const shown3 = applyLook(view, look);
+  return LOOK_KEYS.some(
+    (key) => look[key] !== void 0 && JSON.stringify(shown3[key] ?? null) !== JSON.stringify(view[key] ?? null)
+  );
+}
+function saveToViewPlan(view, look) {
+  const patch = viewPatchFor(view, look);
+  const left = {};
+  if (look.layout !== void 0 && patch.layout === void 0 && look.layout !== view.layout) left.layout = look.layout;
+  return { patch, left: Object.keys(left).length > 0 ? left : null };
+}
+async function readLooks(client, tableId) {
+  const answered = await client.viewLookRead({ table_id: tableId });
+  if (!answered.ok) return answered;
+  const out = {};
+  for (const [viewId, row] of Object.entries(answered.data ?? {})) {
+    out[viewId] = lookFromDocument(row?.look ?? null);
+  }
+  return { ok: true, data: out };
+}
+async function keepLook(client, tableId, viewId, look) {
+  const doc = look ? lookDocument(look) : null;
+  return client.viewLookSet({ table_id: tableId, view_id: viewId, look: doc && Object.keys(doc).length > 0 ? doc : null });
+}
+var LOOK_WORDS = {
+  yours: "You changed how this view looks. Only you see it.",
+  saveToView: "Save to view",
+  saveAsNew: "Save as new view",
+  reset: "Reset to view",
+  newName: "Name for the new view"
+};
+
 // src/ViewSwitcher.tsx
 import { useEffect as useEffect23, useMemo as useMemo25, useState as useState33 } from "react";
 import { useFields as useFields13, useRecords as useRecords6, useRecordsClient as useRecordsClient22 } from "@ai-matrx/records/react";
@@ -11521,10 +11601,14 @@ function ViewSwitcher({
             viewId,
             order: local.order !== void 0 ? local.order : view.order ?? null,
             sorts: local.sorts ?? view.sorts ?? [],
-            onPlaced: () => {
-              setLocal((held) => ({ ...held, order: "manual", sorts: [] }));
-              onOrderPlaced?.();
-            },
+            /* Placing the rows saves the VIEW's order, so Reorder is offered only when the
+               host bound it (TablePage: to someone who may edit the table). */
+            ...onOrderPlaced ? {
+              onPlaced: () => {
+                setLocal((held) => ({ ...held, order: "manual", sorts: [] }));
+                onOrderPlaced();
+              }
+            } : {},
             ...onViewChange ? {
               onUseSort: (sort) => change({ sorts: [sort], order: "sorted" })
             } : {}
@@ -22171,6 +22255,7 @@ import {
   DropdownMenuRadioItem as DropdownMenuRadioItem2,
   DropdownMenuSeparator as DropdownMenuSeparator3,
   DropdownMenuTrigger as DropdownMenuTrigger4,
+  Input as Input6,
   Separator as Separator12,
   Skeleton as Skeleton38,
   cn as cn66,
@@ -22537,6 +22622,21 @@ function TablePage({
   const askedInWords = filter ? filterInWords(filter, pageFields.data ?? []) : null;
   const organizationId = useRecordsClient56().config.organizationId;
   const [view, setView] = useState70(null);
+  const [looks, setLooks] = useState70(void 0);
+  useEffect59(() => {
+    let live = true;
+    setLooks(void 0);
+    void readLooks(client, tableId).then((answered) => {
+      if (!live) return;
+      setLooks(answered.ok ? answered.data : {});
+    });
+    return () => {
+      live = false;
+    };
+  }, [client, tableId]);
+  const look = view && looks ? looks[view.id] : void 0;
+  const shown3 = view ? applyLook(view, look) : null;
+  const [viewsEpoch, setViewsEpoch] = useState70(0);
   const opening = openingRail(activeRecordId, activeRail);
   const hostLayouts = useRecordsUi().layouts ?? [];
   const hostLayoutFor = (asked) => openingHostLayout(asked, hostLayouts);
@@ -22571,9 +22671,9 @@ function TablePage({
     if (hostFromLink || opened.layout || layoutChosen) return;
     setHostLayout(face.hostLayout);
   }, [face.kind, face.kind === "designated" ? face.hostLayout : null, layoutChosen]);
-  const faceUnknown = !hostFromLink && !opened.layout && (views === void 0 || Array.isArray(views) && views.length > 0 && view === null);
-  const shownLayout = layoutFromLink ?? view?.layout ?? "grid";
-  const shownFilter = filter ?? (view?.where ? view.where : null) ?? (view?.filters && Object.keys(view.filters).length > 0 ? view.filters : null);
+  const faceUnknown = !hostFromLink && !opened.layout && (views === void 0 || Array.isArray(views) && views.length > 0 && (view === null || looks === void 0));
+  const shownLayout = layoutFromLink ?? shown3?.layout ?? "grid";
+  const shownFilter = filter ?? (shown3?.where ? shown3.where : null) ?? (shown3?.filters && Object.keys(shown3.filters).length > 0 ? shown3.filters : null);
   const press = (pressed) => {
     const next = chooseSurface(surface, pressed);
     setSurface(next);
@@ -22628,16 +22728,79 @@ function TablePage({
     async (asked) => {
       const current = view;
       if (!current) return;
-      const patch = viewPatchFor(current, asked);
-      setView({ ...current, ...patch });
-      if (Object.keys(viewPatchDocument(patch)).length === 0 && patch.name === void 0 && patch.filters === void 0) return;
+      const part = lookPart(asked);
+      if (Object.keys(part).length === 0) return;
+      const before = looks?.[current.id];
+      const next = { ...before ?? {}, ...part };
+      setLooks((all) => ({ ...all ?? {}, [current.id]: next }));
       setViewSaveRefused(null);
-      const written = await saveViewPatch(client, tableId, current.id, patch);
-      if (written.ok) return;
-      setViewSaveRefused({ error: written.error, patch, before: current });
+      const kept = await keepLook(client, tableId, current.id, next);
+      if (kept.ok) return;
+      setViewSaveRefused({ error: kept.error, patch: asked, lookBefore: before });
     },
-    [client, tableId, view]
+    [client, tableId, view, looks]
   );
+  const lookShowing = Boolean(view && looks && lookDiffers(view, looks[view.id]));
+  const [lookRefused, setLookRefused] = useState70(null);
+  const [namingLook, setNamingLook] = useState70(false);
+  const [lookName, setLookName] = useState70("");
+  const resetLook = async () => {
+    const current = view;
+    if (!current) return;
+    setLookRefused(null);
+    setViewSaveRefused(null);
+    const before = looks?.[current.id];
+    setLooks((all) => {
+      const { [current.id]: _gone, ...rest } = all ?? {};
+      return rest;
+    });
+    const kept = await keepLook(client, tableId, current.id, null);
+    if (!kept.ok) {
+      setLooks((all) => ({ ...all ?? {}, [current.id]: before ?? {} }));
+      setLookRefused(kept.error);
+    }
+  };
+  const saveLookToView = async () => {
+    const current = view;
+    const mine = current && looks ? looks[current.id] : void 0;
+    if (!current || !mine) return;
+    setLookRefused(null);
+    const { patch, left } = saveToViewPlan(current, mine);
+    if (Object.keys(viewPatchDocument(patch)).length > 0) {
+      const written = await saveViewPatch(client, tableId, current.id, patch);
+      if (!written.ok) {
+        setLookRefused(written.error);
+        return;
+      }
+      setView({ ...current, ...patch });
+    }
+    setLooks((all) => {
+      const { [current.id]: _saved, ...rest } = all ?? {};
+      return left ? { ...rest, [current.id]: left } : rest;
+    });
+    const kept = await keepLook(client, tableId, current.id, left);
+    if (!kept.ok) setLookRefused(kept.error);
+  };
+  const saveLookAsNewView = async (name) => {
+    const current = view;
+    const seen = shown3;
+    if (!current || !seen || name.trim() === "") return;
+    setLookRefused(null);
+    const written = await declareView(client, { ...seen, name: name.trim(), subject: tableId, isDefault: false });
+    if (!written.ok) {
+      setLookRefused(written.error);
+      return;
+    }
+    setNamingLook(false);
+    setLookName("");
+    setLooks((all) => {
+      const { [current.id]: _moved, ...rest } = all ?? {};
+      return rest;
+    });
+    void keepLook(client, tableId, current.id, null);
+    setPickedViewId(written.data);
+    setViewsEpoch((n) => n + 1);
+  };
   const [designateRefused, setDesignateRefused] = useState70(null);
   const opensAs = view?.isDefault ? openingLayoutOf(view) : null;
   const canDesignate = Boolean(rights.write && view && layoutShowing && layoutShowing !== opensAs);
@@ -22680,7 +22843,8 @@ function TablePage({
             quietWhenAlone: !showViews,
             seed: seedViews ?? [defaultView(tableId)],
             className: "min-w-0 flex-1"
-          }
+          },
+          viewsEpoch
         ),
         /* @__PURE__ */ jsxs73("div", { className: "ml-auto flex shrink-0 items-center gap-1", "data-table-cluster": "", children: [
           chooserInline ? /* @__PURE__ */ jsxs73("div", { className: "flex items-center gap-0.5", role: "group", "aria-label": "Layout", children: [
@@ -22707,7 +22871,7 @@ function TablePage({
               `host:${option.id}`
             ))
           ] }) : null,
-          main === "records" && !hostLayout ? /* @__PURE__ */ jsx79(ViewFilter, { tableId, view, onApply: (where) => void patchView({ where }) }) : null,
+          main === "records" && !hostLayout ? /* @__PURE__ */ jsx79(ViewFilter, { tableId, view: shown3, onApply: (where) => void patchView({ where }) }) : null,
           rights.write && view && main === "records" && !hostLayout && shownLayout !== "grid" ? /* @__PURE__ */ jsx79(Button64, { size: "sm", onClick: () => show("new-record"), children: "New record" }) : null,
           openedFromMenu ? /* @__PURE__ */ jsx79(
             Button64,
@@ -22807,7 +22971,13 @@ function TablePage({
                 size: "sm",
                 variant: "ghost",
                 onClick: () => {
-                  setView(viewSaveRefused.before);
+                  const current = view;
+                  if (current) {
+                    setLooks((all) => {
+                      const { [current.id]: _dropped, ...rest } = all ?? {};
+                      return viewSaveRefused.lookBefore ? { ...rest, [current.id]: viewSaveRefused.lookBefore } : rest;
+                    });
+                  }
                   setViewSaveRefused(null);
                 },
                 children: "Discard"
@@ -22816,6 +22986,36 @@ function TablePage({
           ] })
         }
       ) : null,
+      lookShowing && main === "records" ? /* @__PURE__ */ jsxs73("div", { className: "flex min-w-0 flex-wrap items-center gap-1.5 text-xs text-muted-foreground", "data-view-look": "", children: [
+        /* @__PURE__ */ jsx79("span", { className: "truncate", children: LOOK_WORDS.yours }),
+        rights.write && view && Object.keys(viewPatchDocument(saveToViewPlan(view, look ?? {}).patch)).length > 0 ? /* @__PURE__ */ jsx79(Button64, { size: "sm", variant: "outline", className: "h-7", onClick: () => void saveLookToView(), "data-view-look-save": "", children: LOOK_WORDS.saveToView }) : null,
+        rights.write ? namingLook ? /* @__PURE__ */ jsxs73(
+          "form",
+          {
+            className: "flex items-center gap-1",
+            onSubmit: (e) => {
+              e.preventDefault();
+              void saveLookAsNewView(lookName);
+            },
+            children: [
+              /* @__PURE__ */ jsx79(
+                Input6,
+                {
+                  autoFocus: true,
+                  "aria-label": LOOK_WORDS.newName,
+                  value: lookName,
+                  onChange: (e) => setLookName(e.target.value),
+                  className: "h-7 w-44 text-xs",
+                  placeholder: "View name"
+                }
+              ),
+              /* @__PURE__ */ jsx79(Button64, { size: "sm", type: "submit", className: "h-7", disabled: lookName.trim() === "", children: "Save" })
+            ]
+          }
+        ) : /* @__PURE__ */ jsx79(Button64, { size: "sm", variant: "ghost", className: "h-7", onClick: () => setNamingLook(true), "data-view-look-save-new": "", children: LOOK_WORDS.saveAsNew }) : null,
+        /* @__PURE__ */ jsx79(Button64, { size: "sm", variant: "ghost", className: "h-7", onClick: () => void resetLook(), "data-view-look-reset": "", children: LOOK_WORDS.reset })
+      ] }) : null,
+      lookRefused ? /* @__PURE__ */ jsx79(RefusalNotice, { error: lookRefused }) : null,
       main === "dashboards" ? /* @__PURE__ */ jsx79(DashboardCanvas, { tableId, activeDashboardId: activeDashboardId ?? null }) : main === "archived" ? (
         /* THE ROWS THAT LEFT. Restoring one puts it back in the grid, so the
            page returns to the records rather than leaving the person looking
@@ -22851,7 +23051,7 @@ function TablePage({
             chooser: false,
             openExport: () => setRail("export"),
             view: {
-              ...view ?? defaultView(tableId),
+              ...shown3 ?? defaultView(tableId),
               layout: shownLayout,
               // The address's field wins for this visit; silence keeps the
               // saved view's own choice, exactly as it always did.
@@ -22872,7 +23072,12 @@ function TablePage({
             ...view ? { onViewChange: (patch) => void patchView(patch) } : {},
             ...view ? {
               viewId: view.id,
-              onOrderPlaced: () => setView((current) => current ? { ...current, order: "manual", sorts: [] } : current)
+              /* A hand-set order is the VIEW's sort for everybody (VIEW-STATE-PERSONAL): placing
+                 the rows is saving to the view, so it is offered to someone who may edit the
+                 table and is absent otherwise (the store refuses it too). */
+              ...rights.write ? {
+                onOrderPlaced: () => setView((current) => current ? { ...current, order: "manual", sorts: [] } : current)
+              } : {}
             } : {},
             ...rights.write ? { onNewRecordForm: () => setRail("new-record") } : {},
             onOpenRecord: (recordId) => {
@@ -23055,6 +23260,7 @@ export {
   LAYOUT_NEEDS,
   LAYOUT_NO_FIELD,
   LEVEL_WORD,
+  LOOK_WORDS,
   MACHINE_IDENTITY,
   MAX_ROW_HEIGHT,
   MIN_ROW_HEIGHT,
@@ -23154,6 +23360,7 @@ export {
   actorBadge,
   actorWords,
   addFields,
+  applyLook,
   archivedRowLine,
   asRefusal,
   askableFields,
@@ -23213,11 +23420,16 @@ export {
   isPlainFieldType,
   isRelationFieldType,
   isSignatureField,
+  keepLook,
   keptByTheApp,
   keyFor,
   kindsWithNoChoice,
   laneFor,
   lastChangeSentence,
+  lookDiffers,
+  lookDocument,
+  lookFromDocument,
+  lookPart,
   looksLikeId,
   machineIdentityIn,
   mayNotRestoreLine,
@@ -23238,6 +23450,7 @@ export {
   previewWords,
   publiclyAnswerable,
   railFromParam,
+  readLooks,
   recordName,
   recordNameIn,
   recordsDataSource,
@@ -23251,6 +23464,7 @@ export {
   revokeConsequence,
   rowName,
   rowNameIn,
+  saveToViewPlan,
   saveViewPatch,
   scalarText,
   seedIsSatisfied,