@ai-matrx/records-ui 0.6.0 → 0.7.0

package/dist/index.d.cts

@@ -463,9 +463,14 @@ interface TableSettingsProps {
     proposals?: FieldProposalRow[] | undefined;
     onAcceptProposal?: ((proposal: FieldProposalRow) => void) | undefined;
     onRejectProposal?: ((proposal: FieldProposalRow) => void) | undefined;
+    /**
+     * SCR-3's fourth verb. Called after the store has accepted the delete, so the
+     * host can leave a page that is now about a table nobody can open.
+     */
+    onDeleted?: (() => void) | undefined;
     className?: string | undefined;
 }
-declare function TableSettings({ tableId, proposals, onAcceptProposal, onRejectProposal, className, }: TableSettingsProps): react.JSX.Element;
+declare function TableSettings({ tableId, proposals, onAcceptProposal, onRejectProposal, onDeleted, className, }: TableSettingsProps): react.JSX.Element;
 
 interface PeekProps {
     tableId: Uuid;
@@ -579,6 +584,31 @@ interface UseSystemTableState {
 }
 /** The hook every package-owned component opens with. */
 declare function useSystemTable(spec: SystemTableSpec): UseSystemTableState;
+/**
+ * THE VERSION OF THE ONE RECORD BEING EDITED.
+ *
+ * The read door (`custom.read_records`) answers documents, never versions —
+ * deliberately, because a version is a fact about the row and not about what
+ * this reader may see. A screen that saves optimistically still needs the
+ * version it LOADED, so it reads it here, for the one record it is editing and
+ * never for a list, through `custom.io_revisions`.
+ *
+ * `null` is an honest answer: the save then carries no expected version and is
+ * the store's ordinary last-writer-wins write. It is never a guess.
+ */
+/** What `useRecordVersion` hands a screen that writes the record more than once. */
+interface TrackedVersion {
+    /** The version this screen is writing against, or `null` when none was read. */
+    version: number | null;
+    /**
+     * TELL IT THE STORE MOVED. Every successful write answers the record's NEW
+     * version; a screen that does not hand it back here will write against the
+     * old one next time and the store will — correctly — refuse it as a conflict
+     * with somebody who turns out to be the same person. Measured 2026-09-19:
+     * switching a saved view's layout twice in a row did exactly that.
+     */
+    note: (version: number) => void;
+}
 
 /** The four ways one saved view can be looked at (SCR-6). */
 declare const VIEW_LAYOUTS: readonly ["grid", "kanban", "calendar", "gallery"];
@@ -1369,6 +1399,18 @@ type DeclareResult = {
 /** `My Sales Pipeline` → `my_sales_pipeline`. A token, never a sentence. */
 declare function tokenFor(name: string): string;
 /** The one Field a Table cannot be declared without: something to call a record. */
+/**
+ * WHY THE FIRST FIELD IS NOT REQUIRED.
+ *
+ * It was, and the cost showed up the moment the grid could add a row: "New
+ * record" writes an empty record and puts you in the first cell, and the store
+ * correctly refused every one of them — `REC-51: Title is required` — so the
+ * one gesture that makes a grid feel like a grid never worked on a table a
+ * person had just made. A title is what makes a record a CHIP (REC-2), which is
+ * a fact about how it is shown, not a promise it can never be written without;
+ * an organization that wants it demanded says so in the field editor, and the
+ * store then enforces it for everyone.
+ */
 declare const DEFAULT_FIELDS: NewFieldSpec[];
 declare function declareTable(client: RecordsClient, spec: NewTableSpec): Promise<DeclareResult>;
 /** Write Field records for an existing Table. Used by the create path and by import. */
@@ -1380,4 +1422,4 @@ declare function addFields(client: RecordsClient, tableId: Uuid$1, fields: NewFi
     error: RecordsError;
 }>;
 
-export { ACTION_KINDS, ACTION_TABLE, ActionInbox, type ActionInboxProps, type ActionKind, BookingSlots, type BookingSlotsProps, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_TABLE, COMMENT_TABLE, type CaptureMode, type CaptureQueuePort, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartKind, type ChartSpec, ChecklistRunner, type ChecklistRunnerProps, type ChecklistSpec, type ChecklistStepSpec, CommentThread, type CommentThreadProps, CustomFieldsSection, type CustomFieldsSectionProps, DASHBOARD_TABLE, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DashboardCanvas, type DashboardCanvasProps, type DashboardSpec, type DeclareResult, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FORM_FLOWS, FORM_TABLE, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldLabel, type FieldProposalRow, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormTheme, Grid, GridCell, type GridEditing, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, NO_CHAT_REASON, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_RIGHTS, NO_SAVED_VIEWS_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OrganizationMember, PARITY_LABEL, PARITY_MADE_OF, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, PortalShell, type PortalShellProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, type QueuedAction, type QueuedActionSpec, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, RefusalLine, RefusalNotice, RelationPicker, type RelationPickerProps, SERIES_COLORS, STORE_DECIDES_REASON, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, SignBlock, type SignBlockProps, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type UseSystemTableState, VIEW_LAYOUTS, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, actionDocument, addFields, bodyForReading, bodyFromKeys, columnForField, dashboardDocument, dashboardFromRecord, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldIsEditable, fieldName, fieldToken, fieldTypeLabel, formDocument, formFromRecord, groupLabel, humanize, isSignatureField, laneFor, memberName, personActor, personRecordForMember, recordName, recordsDataSource, renderValue, rowName, scalarText, storeDecidesRights, submissionStamp, tableName, tokenFor, useEmbedHandshake, useGridEditing, useRecordsUi, useSystemTable, useTableRights, useViewRecords, viewDocument, viewFromRecord, viewPatchDocument };
+export { ACTION_KINDS, ACTION_TABLE, ActionInbox, type ActionInboxProps, type ActionKind, BookingSlots, type BookingSlotsProps, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_TABLE, COMMENT_TABLE, type CaptureMode, type CaptureQueuePort, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartKind, type ChartSpec, ChecklistRunner, type ChecklistRunnerProps, type ChecklistSpec, type ChecklistStepSpec, CommentThread, type CommentThreadProps, CustomFieldsSection, type CustomFieldsSectionProps, DASHBOARD_TABLE, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DashboardCanvas, type DashboardCanvasProps, type DashboardSpec, type DeclareResult, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FORM_FLOWS, FORM_TABLE, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldLabel, type FieldProposalRow, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormTheme, Grid, GridCell, type GridEditing, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, NO_CHAT_REASON, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_RIGHTS, NO_SAVED_VIEWS_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OrganizationMember, PARITY_LABEL, PARITY_MADE_OF, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, PortalShell, type PortalShellProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, type QueuedAction, type QueuedActionSpec, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, RefusalLine, RefusalNotice, RelationPicker, type RelationPickerProps, SERIES_COLORS, STORE_DECIDES_REASON, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, SignBlock, type SignBlockProps, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_LAYOUTS, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, actionDocument, addFields, bodyForReading, bodyFromKeys, columnForField, dashboardDocument, dashboardFromRecord, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldIsEditable, fieldName, fieldToken, fieldTypeLabel, formDocument, formFromRecord, groupLabel, humanize, isSignatureField, laneFor, memberName, personActor, personRecordForMember, recordName, recordsDataSource, renderValue, rowName, scalarText, storeDecidesRights, submissionStamp, tableName, tokenFor, useEmbedHandshake, useGridEditing, useRecordsUi, useSystemTable, useTableRights, useViewRecords, viewDocument, viewFromRecord, viewPatchDocument };

package/dist/index.d.ts

@@ -463,9 +463,14 @@ interface TableSettingsProps {
     proposals?: FieldProposalRow[] | undefined;
     onAcceptProposal?: ((proposal: FieldProposalRow) => void) | undefined;
     onRejectProposal?: ((proposal: FieldProposalRow) => void) | undefined;
+    /**
+     * SCR-3's fourth verb. Called after the store has accepted the delete, so the
+     * host can leave a page that is now about a table nobody can open.
+     */
+    onDeleted?: (() => void) | undefined;
     className?: string | undefined;
 }
-declare function TableSettings({ tableId, proposals, onAcceptProposal, onRejectProposal, className, }: TableSettingsProps): react.JSX.Element;
+declare function TableSettings({ tableId, proposals, onAcceptProposal, onRejectProposal, onDeleted, className, }: TableSettingsProps): react.JSX.Element;
 
 interface PeekProps {
     tableId: Uuid;
@@ -579,6 +584,31 @@ interface UseSystemTableState {
 }
 /** The hook every package-owned component opens with. */
 declare function useSystemTable(spec: SystemTableSpec): UseSystemTableState;
+/**
+ * THE VERSION OF THE ONE RECORD BEING EDITED.
+ *
+ * The read door (`custom.read_records`) answers documents, never versions —
+ * deliberately, because a version is a fact about the row and not about what
+ * this reader may see. A screen that saves optimistically still needs the
+ * version it LOADED, so it reads it here, for the one record it is editing and
+ * never for a list, through `custom.io_revisions`.
+ *
+ * `null` is an honest answer: the save then carries no expected version and is
+ * the store's ordinary last-writer-wins write. It is never a guess.
+ */
+/** What `useRecordVersion` hands a screen that writes the record more than once. */
+interface TrackedVersion {
+    /** The version this screen is writing against, or `null` when none was read. */
+    version: number | null;
+    /**
+     * TELL IT THE STORE MOVED. Every successful write answers the record's NEW
+     * version; a screen that does not hand it back here will write against the
+     * old one next time and the store will — correctly — refuse it as a conflict
+     * with somebody who turns out to be the same person. Measured 2026-09-19:
+     * switching a saved view's layout twice in a row did exactly that.
+     */
+    note: (version: number) => void;
+}
 
 /** The four ways one saved view can be looked at (SCR-6). */
 declare const VIEW_LAYOUTS: readonly ["grid", "kanban", "calendar", "gallery"];
@@ -1369,6 +1399,18 @@ type DeclareResult = {
 /** `My Sales Pipeline` → `my_sales_pipeline`. A token, never a sentence. */
 declare function tokenFor(name: string): string;
 /** The one Field a Table cannot be declared without: something to call a record. */
+/**
+ * WHY THE FIRST FIELD IS NOT REQUIRED.
+ *
+ * It was, and the cost showed up the moment the grid could add a row: "New
+ * record" writes an empty record and puts you in the first cell, and the store
+ * correctly refused every one of them — `REC-51: Title is required` — so the
+ * one gesture that makes a grid feel like a grid never worked on a table a
+ * person had just made. A title is what makes a record a CHIP (REC-2), which is
+ * a fact about how it is shown, not a promise it can never be written without;
+ * an organization that wants it demanded says so in the field editor, and the
+ * store then enforces it for everyone.
+ */
 declare const DEFAULT_FIELDS: NewFieldSpec[];
 declare function declareTable(client: RecordsClient, spec: NewTableSpec): Promise<DeclareResult>;
 /** Write Field records for an existing Table. Used by the create path and by import. */
@@ -1380,4 +1422,4 @@ declare function addFields(client: RecordsClient, tableId: Uuid$1, fields: NewFi
     error: RecordsError;
 }>;
 
-export { ACTION_KINDS, ACTION_TABLE, ActionInbox, type ActionInboxProps, type ActionKind, BookingSlots, type BookingSlotsProps, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_TABLE, COMMENT_TABLE, type CaptureMode, type CaptureQueuePort, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartKind, type ChartSpec, ChecklistRunner, type ChecklistRunnerProps, type ChecklistSpec, type ChecklistStepSpec, CommentThread, type CommentThreadProps, CustomFieldsSection, type CustomFieldsSectionProps, DASHBOARD_TABLE, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DashboardCanvas, type DashboardCanvasProps, type DashboardSpec, type DeclareResult, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FORM_FLOWS, FORM_TABLE, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldLabel, type FieldProposalRow, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormTheme, Grid, GridCell, type GridEditing, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, NO_CHAT_REASON, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_RIGHTS, NO_SAVED_VIEWS_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OrganizationMember, PARITY_LABEL, PARITY_MADE_OF, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, PortalShell, type PortalShellProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, type QueuedAction, type QueuedActionSpec, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, RefusalLine, RefusalNotice, RelationPicker, type RelationPickerProps, SERIES_COLORS, STORE_DECIDES_REASON, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, SignBlock, type SignBlockProps, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type UseSystemTableState, VIEW_LAYOUTS, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, actionDocument, addFields, bodyForReading, bodyFromKeys, columnForField, dashboardDocument, dashboardFromRecord, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldIsEditable, fieldName, fieldToken, fieldTypeLabel, formDocument, formFromRecord, groupLabel, humanize, isSignatureField, laneFor, memberName, personActor, personRecordForMember, recordName, recordsDataSource, renderValue, rowName, scalarText, storeDecidesRights, submissionStamp, tableName, tokenFor, useEmbedHandshake, useGridEditing, useRecordsUi, useSystemTable, useTableRights, useViewRecords, viewDocument, viewFromRecord, viewPatchDocument };
+export { ACTION_KINDS, ACTION_TABLE, ActionInbox, type ActionInboxProps, type ActionKind, BookingSlots, type BookingSlotsProps, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_TABLE, COMMENT_TABLE, type CaptureMode, type CaptureQueuePort, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartKind, type ChartSpec, ChecklistRunner, type ChecklistRunnerProps, type ChecklistSpec, type ChecklistStepSpec, CommentThread, type CommentThreadProps, CustomFieldsSection, type CustomFieldsSectionProps, DASHBOARD_TABLE, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DashboardCanvas, type DashboardCanvasProps, type DashboardSpec, type DeclareResult, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FORM_FLOWS, FORM_TABLE, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldLabel, type FieldProposalRow, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormTheme, Grid, GridCell, type GridEditing, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, NO_CHAT_REASON, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_RIGHTS, NO_SAVED_VIEWS_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OrganizationMember, PARITY_LABEL, PARITY_MADE_OF, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, PortalShell, type PortalShellProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, type QueuedAction, type QueuedActionSpec, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, RefusalLine, RefusalNotice, RelationPicker, type RelationPickerProps, SERIES_COLORS, STORE_DECIDES_REASON, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, SignBlock, type SignBlockProps, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_LAYOUTS, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, actionDocument, addFields, bodyForReading, bodyFromKeys, columnForField, dashboardDocument, dashboardFromRecord, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldIsEditable, fieldName, fieldToken, fieldTypeLabel, formDocument, formFromRecord, groupLabel, humanize, isSignatureField, laneFor, memberName, personActor, personRecordForMember, recordName, recordsDataSource, renderValue, rowName, scalarText, storeDecidesRights, submissionStamp, tableName, tokenFor, useEmbedHandshake, useGridEditing, useRecordsUi, useSystemTable, useTableRights, useViewRecords, viewDocument, viewFromRecord, viewPatchDocument };

package/dist/index.js

@@ -812,6 +812,7 @@ function useGridEditing({ tableId, fields, rows, reload, canWrite }) {
   const [rowError, setRowError] = useState4(null);
   const [busy, setBusy] = useState4(false);
   const versions = useRef(/* @__PURE__ */ new Map());
+  const queues = useRef(/* @__PURE__ */ new Map());
   const editable = useMemo4(() => fields.filter(fieldIsEditable), [fields]);
   const order = useMemo4(() => editable.map((f) => f.key), [editable]);
   const rowIds = useMemo4(() => rows.map((r) => r.id), [rows]);
@@ -845,7 +846,7 @@ function useGridEditing({ tableId, fields, rows, reload, canWrite }) {
     [canWrite, client]
   );
   const cancel = useCallback2(() => setEditing(null), []);
-  const writeCell = useCallback2(
+  const writeCellNow = useCallback2(
     async (rowId, key, value2) => {
       const id = cellKey(rowId, key);
       setOptimistic((held) => ({ ...held, [id]: value2 }));
@@ -889,6 +890,22 @@ function useGridEditing({ tableId, fields, rows, reload, canWrite }) {
     },
     [client, reload]
   );
+  const writeCell = useCallback2(
+    (rowId, key, value2) => {
+      const behind = queues.current.get(rowId) ?? Promise.resolve();
+      const next = behind.then(() => writeCellNow(rowId, key, value2));
+      queues.current.set(
+        rowId,
+        next.then(
+          () => void 0,
+          () => void 0
+        )
+      );
+      return next;
+    },
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [client, reload]
+  );
   const commit = useCallback2(
     (value2, move = null) => {
       const open = editing;
@@ -1097,10 +1114,16 @@ function OpenCell({
   const [draft, setDraft] = useState4(value2);
   const multiline = editorKindFor(field) === "long_text";
   const blurCommits = closesOnBlur(field);
+  const done = useRef(false);
+  const once = (run) => {
+    if (done.current) return;
+    done.current = true;
+    run();
+  };
   const blur = blurCommits ? {
     onBlur: (event) => {
       if (event.currentTarget.contains(event.relatedTarget)) return;
-      onCommit(draft, null);
+      once(() => onCommit(draft, null));
     }
   } : {};
   return /* @__PURE__ */ jsxs5(
@@ -1117,27 +1140,27 @@ function OpenCell({
         if (event.key === "Escape") {
           event.preventDefault();
           event.stopPropagation();
-          onCancel();
+          once(onCancel);
           return;
         }
         if (event.key === "Tab") {
           event.preventDefault();
           event.stopPropagation();
-          onCommit(draft, event.shiftKey ? "previous" : "next");
+          once(() => onCommit(draft, event.shiftKey ? "previous" : "next"));
           return;
         }
         if (event.key === "Enter" && (!multiline || event.metaKey || event.ctrlKey)) {
           event.preventDefault();
           event.stopPropagation();
-          onCommit(draft, null);
+          once(() => onCommit(draft, null));
         }
       },
       ...blur,
       children: [
         /* @__PURE__ */ jsx7(FieldControl, { field, value: draft, onChange: setDraft, id: `cell-${field.id}` }),
         blurCommits ? /* @__PURE__ */ jsx7("span", { className: "text-[10px] text-muted-foreground", children: multiline ? "\u2318\u23CE saves \xB7 Esc cancels \xB7 Tab next" : "\u23CE saves \xB7 Esc cancels \xB7 Tab next" }) : /* @__PURE__ */ jsxs5("span", { className: "flex items-center gap-1", children: [
-          /* @__PURE__ */ jsx7(Button4, { size: "sm", onClick: () => onCommit(draft, null), children: "Save" }),
-          /* @__PURE__ */ jsx7(Button4, { size: "sm", variant: "ghost", onClick: onCancel, children: "Cancel" })
+          /* @__PURE__ */ jsx7(Button4, { size: "sm", onClick: () => once(() => onCommit(draft, null)), children: "Save" }),
+          /* @__PURE__ */ jsx7(Button4, { size: "sm", variant: "ghost", onClick: () => once(onCancel), children: "Cancel" })
         ] })
       ]
     }
@@ -1755,7 +1778,7 @@ function useRecordVersion(recordId) {
       cancelled = true;
     };
   }, [client, recordId]);
-  return version;
+  return { version, note: setVersion };
 }
 
 // src/RecordForm.tsx
@@ -1774,7 +1797,8 @@ function RecordForm({
   const mutation = useRecordMutation2();
   const [draft, setDraft] = useState9({});
   const [touched, setTouched] = useState9(false);
-  const loadedVersion = useRecordVersion(recordId ?? null);
+  const loaded = useRecordVersion(recordId ?? null);
+  const loadedVersion = loaded.version;
   useEffect5(() => {
     const document3 = existing.data?.document;
     if (document3) setDraft({ ...document3 });
@@ -1803,6 +1827,7 @@ function RecordForm({
         ...version === null ? {} : { expectedVersion: version }
       });
       if (moved !== null) {
+        loaded.note(moved);
         host.notify?.success("Saved");
         existing.reload();
         onSaved?.(recordId);
@@ -2169,12 +2194,13 @@ var FIELD_KERNEL = KERNEL_TABLES2.find((t) => t.name === "Field").id;
 import { useState as useState12 } from "react";
 import { useFields as useFields6, useRecordMutation as useRecordMutation4, useTable as useTable5 } from "@ai-matrx/records/react";
 import { Badge as Badge4, Button as Button11, Separator as Separator5, cn as cn13 } from "@ai-matrx/design-system";
-import { jsx as jsx14, jsxs as jsxs12 } from "react/jsx-runtime";
+import { Fragment as Fragment3, jsx as jsx14, jsxs as jsxs12 } from "react/jsx-runtime";
 function TableSettings({
   tableId,
   proposals,
   onAcceptProposal,
   onRejectProposal,
+  onDeleted,
   className
 }) {
   const table = useTable5(tableId);
@@ -2182,6 +2208,7 @@ function TableSettings({
   const rights = useTableRights(table.data);
   const mutation = useRecordMutation4();
   const [editing, setEditing] = useState12(null);
+  const [askingToDelete, setAskingToDelete] = useState12(false);
   if (table.error) return /* @__PURE__ */ jsx14(RefusalNotice, { error: table.error, className });
   if (fields.error) return /* @__PURE__ */ jsx14(RefusalNotice, { error: fields.error, className });
   if (!rights.admin) return /* @__PURE__ */ jsx14("p", { className: cn13("text-xs text-muted-foreground", className), children: rights.reason });
@@ -2198,6 +2225,11 @@ function TableSettings({
     await mutation.remove({ record_id: field.id });
     fields.reload();
   };
+  const deleteTable = async () => {
+    const gone = await mutation.remove({ record_id: tableId });
+    setAskingToDelete(false);
+    if (gone !== null) onDeleted?.();
+  };
   if (editing) {
     return /* @__PURE__ */ jsx14(
       FieldEditor,
@@ -2273,7 +2305,28 @@ function TableSettings({
       /* @__PURE__ */ jsx14(Badge4, { variant: "secondary", className: "text-[10px] font-normal", children: proposal.proposed_by }),
       /* @__PURE__ */ jsx14(Button11, { size: "sm", variant: "outline", onClick: () => onAcceptProposal?.(proposal), children: "Accept" }),
       /* @__PURE__ */ jsx14(Button11, { size: "sm", variant: "ghost", onClick: () => onRejectProposal?.(proposal), children: "Reject" })
-    ] }, proposal.id)) })
+    ] }, proposal.id)) }),
+    /* @__PURE__ */ jsx14(Separator5, {}),
+    /* @__PURE__ */ jsxs12("div", { className: "flex flex-col gap-1", children: [
+      /* @__PURE__ */ jsx14("span", { className: "font-medium", children: "This table" }),
+      askingToDelete ? /* @__PURE__ */ jsxs12(Fragment3, { children: [
+        /* @__PURE__ */ jsxs12("p", { className: "text-muted-foreground", children: [
+          "Deleting ",
+          table.data ? tableName(table.data) : "this table",
+          " takes it out of everyone's list, with its ",
+          rows.length,
+          " field",
+          rows.length === 1 ? "" : "s",
+          " and every record in it.",
+          table.data?.retention_days ? ` The store keeps them for ${table.data.retention_days} days, so it can still be restored.` : " The store keeps them, so it can still be restored."
+        ] }),
+        /* @__PURE__ */ jsxs12("div", { className: "flex gap-1", children: [
+          /* @__PURE__ */ jsx14(Button11, { size: "sm", variant: "destructive", disabled: mutation.saving, onClick: () => void deleteTable(), children: mutation.saving ? "Deleting\u2026" : "Delete this table" }),
+          /* @__PURE__ */ jsx14(Button11, { size: "sm", variant: "ghost", onClick: () => setAskingToDelete(false), children: "Keep it" })
+        ] })
+      ] }) : /* @__PURE__ */ jsx14("div", { children: /* @__PURE__ */ jsx14(Button11, { size: "sm", variant: "outline", onClick: () => setAskingToDelete(true), children: "Delete this table" }) }),
+      mutation.error ? /* @__PURE__ */ jsx14(RefusalNotice, { error: mutation.error }) : null
+    ] })
   ] });
 }
 
@@ -2282,7 +2335,7 @@ import { useState as useState13 } from "react";
 import { useFields as useFields7, useRecord as useRecord3, useTable as useTable6 } from "@ai-matrx/records/react";
 import { AlchemyMenu as AlchemyMenu2 } from "@ai-matrx/alchemy/react";
 import { Button as Button12, Separator as Separator6, Skeleton as Skeleton2, cn as cn14 } from "@ai-matrx/design-system";
-import { Fragment as Fragment3, jsx as jsx15, jsxs as jsxs13 } from "react/jsx-runtime";
+import { Fragment as Fragment4, jsx as jsx15, jsxs as jsxs13 } from "react/jsx-runtime";
 function Peek({ tableId, recordId, onClose, className }) {
   const table = useTable6(tableId);
   const fields = useFields7(tableId);
@@ -2331,7 +2384,7 @@ function Peek({ tableId, recordId, onClose, className }) {
       ] }),
       /* @__PURE__ */ jsx15("dd", { className: "min-w-0", children: renderValue(field, document2?.[field.key], document2) })
     ] }, field.id)) }),
-    record.data?.computed?.length ? /* @__PURE__ */ jsxs13(Fragment3, { children: [
+    record.data?.computed?.length ? /* @__PURE__ */ jsxs13(Fragment4, { children: [
       /* @__PURE__ */ jsx15(Separator6, {}),
       /* @__PURE__ */ jsxs13("div", { className: "flex flex-col gap-1", children: [
         /* @__PURE__ */ jsx15("span", { className: "font-medium", children: "Worked out by the system" }),
@@ -3553,7 +3606,7 @@ import { useCallback as useCallback8, useEffect as useEffect11, useMemo as useMe
 import { useFields as useFields10, useRecordsClient as useRecordsClient12 } from "@ai-matrx/records/react";
 import { doorExists, DOORS } from "@ai-matrx/records/core";
 import { Button as Button19, Progress, Skeleton as Skeleton8, cn as cn21 } from "@ai-matrx/design-system";
-import { Fragment as Fragment4, jsx as jsx22, jsxs as jsxs20 } from "react/jsx-runtime";
+import { Fragment as Fragment5, jsx as jsx22, jsxs as jsxs20 } from "react/jsx-runtime";
 function FormRunner({ form, preview = false, onSubmitted, className }) {
   const client = useRecordsClient12();
   const host = useRecordsUi();
@@ -3741,7 +3794,7 @@ function Question({
   return /* @__PURE__ */ jsxs20("div", { className: "flex flex-col gap-1.5", children: [
     /* @__PURE__ */ jsx22(FieldLabel, { field: { ...field, label: question.ask, required: question.required }, htmlFor: id }),
     question.help ? /* @__PURE__ */ jsx22("p", { className: "text-xs text-muted-foreground", children: question.help }) : null,
-    isAttachment && !upload ? /* @__PURE__ */ jsx22("p", { className: "rounded border border-dashed px-2 py-1 text-xs text-muted-foreground", children: NO_UPLOAD_REASON }) : isAttachment ? /* @__PURE__ */ jsxs20(Fragment4, { children: [
+    isAttachment && !upload ? /* @__PURE__ */ jsx22("p", { className: "rounded border border-dashed px-2 py-1 text-xs text-muted-foreground", children: NO_UPLOAD_REASON }) : isAttachment ? /* @__PURE__ */ jsxs20(Fragment5, { children: [
       /* @__PURE__ */ jsx22(
         "input",
         {
@@ -3766,7 +3819,7 @@ function Question({
 }
 
 // src/FormBuilder.tsx
-import { Fragment as Fragment5, jsx as jsx23, jsxs as jsxs21 } from "react/jsx-runtime";
+import { Fragment as Fragment6, jsx as jsx23, jsxs as jsxs21 } from "react/jsx-runtime";
 var CONDITION_OPS = [
   { op: "eq", label: "is" },
   { op: "ne", label: "is not" },
@@ -3787,7 +3840,7 @@ function FormBuilder({ tableId, seed, activeFormId, onActiveForm, className }) {
   const [draft, setDraft] = useState21(null);
   const [saving, setSaving] = useState21(false);
   const [saved, setSaved] = useState21(null);
-  const loadedVersion = useRecordVersion(activeId);
+  const loaded = useRecordVersion(activeId);
   const formTableId = home.tableId;
   const load = useCallback9(async () => {
     if (!formTableId) return;
@@ -3851,13 +3904,14 @@ function FormBuilder({ tableId, seed, activeFormId, onActiveForm, className }) {
       record_id: draft.id,
       patch: document2,
       // The form record's own version: two people editing one form are TOLD.
-      ...loadedVersion === null ? {} : { expectedVersion: loadedVersion }
+      ...loaded.version === null ? {} : { expectedVersion: loaded.version }
     });
     setSaving(false);
     if (!written.ok) {
       setError(written.error);
       return;
     }
+    loaded.note(written.data);
     setSaved("Saved.");
     await load();
   }
@@ -3913,7 +3967,7 @@ function FormBuilder({ tableId, seed, activeFormId, onActiveForm, className }) {
           /* @__PURE__ */ jsx23(Button20, { size: "sm", disabled: saving || !draft, onClick: () => void save(), children: saving ? "Saving\u2026" : "Save" })
         ] })
       ] }),
-      !draft ? /* @__PURE__ */ jsx23("p", { className: "text-xs text-muted-foreground", children: 'No form collects into this table yet. "New form" makes one, or an agent writes a whole one with a single record.' }) : /* @__PURE__ */ jsxs21(Fragment5, { children: [
+      !draft ? /* @__PURE__ */ jsx23("p", { className: "text-xs text-muted-foreground", children: 'No form collects into this table yet. "New form" makes one, or an agent writes a whole one with a single record.' }) : /* @__PURE__ */ jsxs21(Fragment6, { children: [
         /* @__PURE__ */ jsxs21("div", { className: "grid grid-cols-2 gap-2", children: [
           /* @__PURE__ */ jsxs21("label", { className: "flex flex-col gap-1", children: [
             /* @__PURE__ */ jsx23(Label3, { className: "text-xs font-medium", children: "Name" }),
@@ -4076,7 +4130,7 @@ function Condition({
         ]
       }
     ),
-    onField ? /* @__PURE__ */ jsxs21(Fragment5, { children: [
+    onField ? /* @__PURE__ */ jsxs21(Fragment6, { children: [
       /* @__PURE__ */ jsx23(
         "select",
         {
@@ -4960,7 +5014,7 @@ function DashboardCanvas({ tableId, seed, activeDashboardId, className }) {
   const [boards, setBoards] = useState27(null);
   const [error, setError] = useState27(null);
   const [activeId, setActiveId] = useState27(activeDashboardId ?? null);
-  const loadedVersion = useRecordVersion(activeId);
+  const loaded = useRecordVersion(activeId);
   const boardTableId = home.tableId;
   const load = useCallback14(async () => {
     if (!boardTableId) return;
@@ -5006,12 +5060,13 @@ function DashboardCanvas({ tableId, seed, activeDashboardId, className }) {
       record_id: board2.id,
       patch: dashboardDocument({ ...board2, blocks }),
       // The dashboard record's own version: two tabs editing one board are TOLD.
-      ...loadedVersion === null ? {} : { expectedVersion: loadedVersion }
+      ...loaded.version === null ? {} : { expectedVersion: loaded.version }
     });
     if (!updated.ok) {
       setError(updated.error);
       return;
     }
+    loaded.note(updated.data);
     await load();
   }
   async function create() {
@@ -5876,7 +5931,7 @@ function whenText(at) {
 import { useCallback as useCallback18, useEffect as useEffect23, useRef as useRef5, useState as useState32 } from "react";
 import { useFields as useFields17, useRecordsClient as useRecordsClient24, useTable as useTable19 } from "@ai-matrx/records/react";
 import { Button as Button29, Input as Input2, Skeleton as Skeleton20, Textarea as Textarea2, cn as cn33 } from "@ai-matrx/design-system";
-import { Fragment as Fragment6, jsx as jsx34, jsxs as jsxs32 } from "react/jsx-runtime";
+import { Fragment as Fragment7, jsx as jsx34, jsxs as jsxs32 } from "react/jsx-runtime";
 var CAPTURE_MODES = ["reading", "photo", "voice"];
 var IN_MEMORY_QUEUE_REASON = "No capture queue is bound, so anything that cannot be sent right now is held in this page's memory and is lost if the page closes. Bind `captureQueue` on <RecordsUiProvider> with your host's own durable store (IndexedDB in a browser) and a queued capture survives the tab, the reload and the flight. It is said here rather than discovered later.";
 function mintClientKey() {
@@ -6033,7 +6088,7 @@ function CaptureSheet({
       " ",
       /* @__PURE__ */ jsx34("code", { children: "attachmentField" }),
       "."
-    ] }) : /* @__PURE__ */ jsxs32(Fragment6, { children: [
+    ] }) : /* @__PURE__ */ jsxs32(Fragment7, { children: [
       /* @__PURE__ */ jsx34(
         "input",
         {
@@ -6287,7 +6342,7 @@ import { useCallback as useCallback21, useEffect as useEffect26, useState as use
 import { useRecordsClient as useRecordsClient27 } from "@ai-matrx/records/react";
 import { Button as Button31, Input as Input3, Skeleton as Skeleton23, Textarea as Textarea3, cn as cn36 } from "@ai-matrx/design-system";
 import { useTable as useTable20 } from "@ai-matrx/records/react";
-import { Fragment as Fragment7, jsx as jsx37, jsxs as jsxs35 } from "react/jsx-runtime";
+import { Fragment as Fragment8, jsx as jsx37, jsxs as jsxs35 } from "react/jsx-runtime";
 function EmbedFrame({
   tableId,
   formId,
@@ -6371,7 +6426,7 @@ function EmbedFrame({
         " will not pass."
       ] })
     ] }),
-    !secret ? /* @__PURE__ */ jsx37(Button31, { size: "sm", className: "self-start", disabled: busy || parsed.length === 0, onClick: () => void issue(), children: busy ? "Issuing\u2026" : "Issue embed" }) : /* @__PURE__ */ jsxs35(Fragment7, { children: [
+    !secret ? /* @__PURE__ */ jsx37(Button31, { size: "sm", className: "self-start", disabled: busy || parsed.length === 0, onClick: () => void issue(), children: busy ? "Issuing\u2026" : "Issue embed" }) : /* @__PURE__ */ jsxs35(Fragment8, { children: [
       /* @__PURE__ */ jsx37("p", { className: "rounded border px-2 py-1 text-xs text-muted-foreground", children: "Copy this now. Only its digest is stored, so nobody \u2014 including us \u2014 can show it to you again; if it is lost, issue a new one and replace the old." }),
       /* @__PURE__ */ jsx37(Textarea3, { "aria-label": "Embed snippet", readOnly: true, rows: 3, className: "font-mono text-[11px]", value: snippet ?? "" }),
       /* @__PURE__ */ jsxs35("div", { className: "flex gap-2", children: [
@@ -6466,7 +6521,7 @@ function tokenFor(name) {
   return name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "").slice(0, 48) || "table";
 }
 var DEFAULT_FIELDS = [
-  { key: "title", label: "Title", type: "text", sort: 10, required: true }
+  { key: "title", label: "Title", type: "text", sort: 10, required: false }
 ];
 async function declareTable(client, spec) {
   const fields = spec.fields && spec.fields.length > 0 ? spec.fields : DEFAULT_FIELDS;
@@ -6536,7 +6591,7 @@ async function addFields(client, tableId, fields) {
 }
 
 // src/TablesHome.tsx
-import { Fragment as Fragment8, jsx as jsx39, jsxs as jsxs36 } from "react/jsx-runtime";
+import { Fragment as Fragment9, jsx as jsx39, jsxs as jsxs36 } from "react/jsx-runtime";
 var TABLE_LANES = ["mine", "organization", "system", "community", "app"];
 var LANE_TITLE = {
   mine: "Mine",
@@ -6589,7 +6644,7 @@ function TablesHome({ onOpenTable, className }) {
     [client, name, onOpenTable, tables]
   );
   return /* @__PURE__ */ jsxs36("div", { className: cn37("flex min-h-0 flex-col gap-4", className), children: [
-    /* @__PURE__ */ jsx39("div", { className: "flex items-center gap-2", children: creating ? /* @__PURE__ */ jsxs36(Fragment8, { children: [
+    /* @__PURE__ */ jsx39("div", { className: "flex items-center gap-2", children: creating ? /* @__PURE__ */ jsxs36(Fragment9, { children: [
       /* @__PURE__ */ jsx39(
         BasicInput8,
         {
@@ -6663,7 +6718,7 @@ function TablesHome({ onOpenTable, className }) {
 import { useCallback as useCallback23, useState as useState37 } from "react";
 import { useRecordsClient as useRecordsClient29, useTable as useTable21 } from "@ai-matrx/records/react";
 import { Button as Button33, Separator as Separator7, Skeleton as Skeleton25, cn as cn38 } from "@ai-matrx/design-system";
-import { Fragment as Fragment9, jsx as jsx40, jsxs as jsxs37 } from "react/jsx-runtime";
+import { Fragment as Fragment10, jsx as jsx40, jsxs as jsxs37 } from "react/jsx-runtime";
 var TABLE_NOT_REACHABLE = "This table is not in the organization you are working in, so there is nothing here to show. Switch to the organization that owns it and open it again \u2014 or it may have been deleted.";
 var DEFAULT_VIEW_NAME = "All records";
 function defaultView(tableId) {
@@ -6692,11 +6747,12 @@ function TablePage({
       setView({ ...current, ...patch });
       const document2 = viewPatchDocument(patch);
       if (Object.keys(document2).length === 0) return;
-      await client.recordUpdate({
+      const written = await client.recordUpdate({
         record_id: current.id,
         patch: document2,
-        ...viewVersion === null ? {} : { expectedVersion: viewVersion }
+        ...viewVersion.version === null ? {} : { expectedVersion: viewVersion.version }
       });
+      if (written.ok) viewVersion.note(written.data);
     },
     [client, view, viewVersion]
   );
@@ -6722,7 +6778,7 @@ function TablePage({
           }
         ),
         rights.write && view && view.layout !== "grid" ? /* @__PURE__ */ jsx40(Button33, { size: "sm", onClick: () => show("new-record"), children: "New record" }) : null,
-        rights.admin ? /* @__PURE__ */ jsxs37(Fragment9, { children: [
+        rights.admin ? /* @__PURE__ */ jsxs37(Fragment10, { children: [
           /* @__PURE__ */ jsx40(Button33, { size: "sm", variant: "outline", onClick: () => show("field"), children: "Add field" }),
           /* @__PURE__ */ jsx40(Button33, { size: "sm", variant: "ghost", onClick: () => show("settings"), children: "Settings" }),
           /* @__PURE__ */ jsx40(Button33, { size: "sm", variant: "ghost", onClick: () => show("import"), children: "Import" })
@@ -6749,7 +6805,13 @@ function TablePage({
       ] })
     ] }),
     rail === "none" ? null : /* @__PURE__ */ jsxs37("aside", { className: "w-[26rem] shrink-0 overflow-y-auto rounded-md border p-3", children: [
-      rail === "settings" ? /* @__PURE__ */ jsx40(TableSettings, { tableId }) : null,
+      rail === "settings" ? /* @__PURE__ */ jsx40(
+        TableSettings,
+        {
+          tableId,
+          ...onLeave ? { onDeleted: onLeave } : {}
+        }
+      ) : null,
       rail === "inbox" ? /* @__PURE__ */ jsx40(
         ActionInbox,
         {