@ai-matrx/records-ui 0.110.7 → 0.110.9

package/dist/index.d.cts

@@ -2287,6 +2287,12 @@ interface GridProps {
      * row and hands the term through `searchOverride` (Spaces N-19). Default `true`.
      */
     searchBox?: boolean | undefined;
+    /**
+     * `true`: a row action the person's level refuses (Archive record for a content editor, who may
+     * change rows but not delete them) is left out of the row menu instead of drawn disabled with its
+     * reason. Default `false` (disabled, saying why). Spaces sets it: Notion offers only what works.
+     */
+    hideRefusedRowActions?: boolean | undefined;
     /** The new-row line's words ("New page"). Default "Add row". */
     newRowLabel?: string | undefined;
     /**
@@ -4044,6 +4050,8 @@ interface ViewSwitcherProps {
      * row and hands the term through `searchOverride` (Spaces N-19). Default `true`.
      */
     searchBox?: boolean | undefined;
+    /** `GridProps.hideRefusedRowActions`. */
+    hideRefusedRowActions?: boolean | undefined;
     /** The grid's new-row line words (`GridProps.newRowLabel`). */
     newRowLabel?: string | undefined;
     className?: string | undefined;
@@ -4075,7 +4083,7 @@ declare function useViewRecords(view: SavedViewSpec, pageSize?: number, filter?:
      */
     membership: string;
 };
-declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onCloseRecord, onMoved, onNewRecordForm, onAskWhoChanged, pageSize: pageSizeAsked, titleField, filter, onClearFilter, chooser, viewId, onOrderPlaced, footer, embedded, sortOverride, searchOverride, onSearchChange, searchBox, newRowLabel, className, }: ViewSwitcherProps): react.JSX.Element;
+declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onCloseRecord, onMoved, onNewRecordForm, onAskWhoChanged, pageSize: pageSizeAsked, titleField, filter, onClearFilter, chooser, viewId, onOrderPlaced, footer, embedded, sortOverride, searchOverride, onSearchChange, searchBox, hideRefusedRowActions, newRowLabel, className, }: ViewSwitcherProps): react.JSX.Element;
 
 /** The host app's saved zone (IANA). `null` / junk clears it: the device zone applies. */
 declare function setPersonTimeZone(next: string | null | undefined): void;

package/dist/index.d.ts

@@ -2287,6 +2287,12 @@ interface GridProps {
      * row and hands the term through `searchOverride` (Spaces N-19). Default `true`.
      */
     searchBox?: boolean | undefined;
+    /**
+     * `true`: a row action the person's level refuses (Archive record for a content editor, who may
+     * change rows but not delete them) is left out of the row menu instead of drawn disabled with its
+     * reason. Default `false` (disabled, saying why). Spaces sets it: Notion offers only what works.
+     */
+    hideRefusedRowActions?: boolean | undefined;
     /** The new-row line's words ("New page"). Default "Add row". */
     newRowLabel?: string | undefined;
     /**
@@ -4044,6 +4050,8 @@ interface ViewSwitcherProps {
      * row and hands the term through `searchOverride` (Spaces N-19). Default `true`.
      */
     searchBox?: boolean | undefined;
+    /** `GridProps.hideRefusedRowActions`. */
+    hideRefusedRowActions?: boolean | undefined;
     /** The grid's new-row line words (`GridProps.newRowLabel`). */
     newRowLabel?: string | undefined;
     className?: string | undefined;
@@ -4075,7 +4083,7 @@ declare function useViewRecords(view: SavedViewSpec, pageSize?: number, filter?:
      */
     membership: string;
 };
-declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onCloseRecord, onMoved, onNewRecordForm, onAskWhoChanged, pageSize: pageSizeAsked, titleField, filter, onClearFilter, chooser, viewId, onOrderPlaced, footer, embedded, sortOverride, searchOverride, onSearchChange, searchBox, newRowLabel, className, }: ViewSwitcherProps): react.JSX.Element;
+declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onCloseRecord, onMoved, onNewRecordForm, onAskWhoChanged, pageSize: pageSizeAsked, titleField, filter, onClearFilter, chooser, viewId, onOrderPlaced, footer, embedded, sortOverride, searchOverride, onSearchChange, searchBox, hideRefusedRowActions, newRowLabel, className, }: ViewSwitcherProps): react.JSX.Element;
 
 /** The host app's saved zone (IANA). `null` / junk clears it: the device zone applies. */
 declare function setPersonTimeZone(next: string | null | undefined): void;

package/dist/index.js

@@ -1092,6 +1092,11 @@ function inColumnWords(error, fields) {
 }
 
 // src/askOnce.ts
+import { onTableStructureChanged } from "@ai-matrx/records/core";
+var structureEpoch = 0;
+onTableStructureChanged(() => {
+  structureEpoch += 1;
+});
 var asked = /* @__PURE__ */ new WeakMap();
 var byPerson = /* @__PURE__ */ new WeakMap();
 function heldFor(client) {
@@ -1122,7 +1127,7 @@ function askOnce(client, key, ask, freshMs) {
   const held = heldFor(client);
   const now = Date.now();
   const kept = held.get(key);
-  if (kept && now - kept.at <= freshMs) return kept.answer;
+  if (kept && kept.epoch === structureEpoch && now - kept.at <= freshMs) return kept.answer;
   const answer = ask().then(
     (result) => {
       if (!result.ok) held.delete(key);
@@ -1133,17 +1138,18 @@ function askOnce(client, key, ask, freshMs) {
       throw thrown;
     }
   );
-  held.set(key, { at: now, answer });
+  held.set(key, { at: now, epoch: structureEpoch, answer });
   return answer;
 }
 function forgetAsked(client, prefix) {
   const held = heldFor(client);
   for (const key of [...held.keys()]) if (key.startsWith(prefix)) held.delete(key);
 }
-var FIELD_OPTIONS_FRESH_MS = 2e3;
+var FIELD_OPTIONS_FRESH_MS = 1e4;
 function fieldOptionsOnce(client, fieldId) {
   return askOnce(client, `field_options:${fieldId}`, () => client.fieldOptions({ field_id: fieldId }), FIELD_OPTIONS_FRESH_MS);
 }
+var ENRICH_CELLS_FRESH_MS = 5e3;
 
 // src/labels.tsx
 import { createContext as createContext3, useCallback, useContext as useContext3, useEffect as useEffect2, useMemo as useMemo2, useRef as useRef2, useState as useState2 } from "react";
@@ -2238,15 +2244,18 @@ function rowSection(rowId, ctx, rowText) {
     items.push({ id: "row-history", label: "Row history", icon: "history", onSelect: () => a.openRecord?.(rowId) });
   }
   items.push(...ctx.extras?.row?.(rowId) ?? []);
-  items.push({
-    id: "row-archive",
-    label: "Archive record",
-    icon: "trash",
-    destructive: true,
-    separatorBefore: true,
-    disabledReason: mayWrite ? void 0 : ctx.whyNotWrite(rowId),
-    onSelect: () => a.archiveRow(rowId)
-  });
+  const mayRemove = mayWrite && (ctx.mayRemoveRow ? ctx.mayRemoveRow(rowId) : true);
+  if (mayRemove || !ctx.hideRefusedRowActions) {
+    items.push({
+      id: "row-archive",
+      label: "Archive record",
+      icon: "trash",
+      destructive: true,
+      separatorBefore: true,
+      disabledReason: mayRemove ? void 0 : !mayWrite ? ctx.whyNotWrite(rowId) : ctx.whyNotRemove?.(rowId) ?? ctx.whyNotWrite(rowId),
+      onSelect: () => a.archiveRow(rowId)
+    });
+  }
   return { id: "row", title: ctx.extras?.rowTitle?.(rowId) || "Row", items };
 }
 function columnSection(columnId2, columnLabel2, ctx) {
@@ -16011,6 +16020,9 @@ function useMergedGridControls(args) {
     canWrite,
     mayWriteRow,
     whyNotRow,
+    mayRemoveRow,
+    whyNotRemoveRow,
+    hideRefusedRowActions,
     rights,
     editable,
     presentation,
@@ -16268,6 +16280,9 @@ function useMergedGridControls(args) {
       titleField: table?.title_field ?? null,
       mayWriteRow: (rowId) => canWrite && mayWriteRow(rowId),
       whyNotWrite: (rowId) => !editable ? "Editing is off here." : rowId ? whyNotRow(rowId) : rights.why("write"),
+      mayRemoveRow: (rowId) => canWrite && mayRemoveRow(rowId),
+      whyNotRemove: (rowId) => rowId ? whyNotRemoveRow(rowId) : rights.why("remove"),
+      hideRefusedRowActions,
       mayAddRecord: editable && rights.write,
       whyNotAdd: editable ? rights.why("write") : "Editing is off here.",
       mayStructure,
@@ -18562,12 +18577,14 @@ function useEnrichCells(tableId, recordIds) {
   const [cells, setCells] = useState51(/* @__PURE__ */ new Map());
   const [error, setError] = useState51(null);
   const key = (recordIds ?? []).join(",");
-  const refresh = useCallback20(async () => {
+  const load = useCallback20(async (fresh) => {
     if (!tableId || !recordIds || recordIds.length === 0) {
       setCells(/* @__PURE__ */ new Map());
       return;
     }
-    const answered = await client.enrichCells({ table_id: tableId, record_ids: recordIds });
+    const asking = `enrich_cells:${tableId}:${key}`;
+    if (fresh) forgetAsked(client, asking);
+    const answered = await askOnce(client, asking, () => client.enrichCells({ table_id: tableId, record_ids: recordIds }), ENRICH_CELLS_FRESH_MS);
     if (!answered.ok) {
       setError(answered.error);
       return;
@@ -18577,9 +18594,10 @@ function useEnrichCells(tableId, recordIds) {
     for (const cell2 of answered.data) next.set(`${cell2.record_id}:${cell2.field_key}`, cell2);
     setCells(next);
   }, [client, tableId, key]);
+  const refresh = useCallback20(() => load(true), [load]);
   useEffect42(() => {
-    void refresh();
-  }, [refresh]);
+    void load(false);
+  }, [load]);
   return { cells, refresh, error };
 }
 var NEVER2 = "Fill it in once and leave it alone";
@@ -23593,7 +23611,8 @@ function GridBody({
   sortOverride,
   searchOverride,
   onSearchChange,
-  searchBox = true
+  searchBox = true,
+  hideRefusedRowActions = false
 }) {
   const toolbarSlot = useTableToolbarSlot();
   const tableCard = useMatrxTableCard();
@@ -23832,6 +23851,14 @@ function GridBody({
     (rowId) => askPerRow ? rowRights(rowId)?.write ?? false : rights.write,
     [askPerRow, rowRights, rights.write]
   );
+  const mayRemoveRow = useCallback28(
+    (rowId) => askPerRow ? rowRights(rowId)?.remove ?? false : rights.remove,
+    [askPerRow, rowRights, rights.remove]
+  );
+  const whyNotRemoveRow = useCallback28(
+    (rowId) => askPerRow ? rowRights(rowId)?.why("remove") ?? rights.why("remove") : rights.why("remove"),
+    [askPerRow, rowRights, rights]
+  );
   const whyNotRow = useCallback28(
     (rowId) => askPerRow ? rowRights(rowId)?.why("write") ?? rights.why("write") : rights.why("write"),
     [askPerRow, rowRights, rights]
@@ -24502,6 +24529,9 @@ function GridBody({
     canWrite,
     mayWriteRow,
     whyNotRow,
+    mayRemoveRow,
+    whyNotRemoveRow,
+    hideRefusedRowActions,
     rights,
     editable: Boolean(editable),
     readOnly,
@@ -34123,6 +34153,7 @@ function ViewSwitcher({
   searchOverride,
   onSearchChange,
   searchBox,
+  hideRefusedRowActions,
   newRowLabel,
   className
 }) {
@@ -34168,6 +34199,7 @@ function ViewSwitcher({
         ...searchOverride !== void 0 ? { searchOverride } : {},
         ...onSearchChange ? { onSearchChange } : {},
         ...searchBox === false ? { searchBox } : {},
+        ...hideRefusedRowActions ? { hideRefusedRowActions } : {},
         ...newRowLabel ? { newRowLabel } : {},
         ...filter ? { filter } : {},
         ...onClearFilter ? { onClearFilter } : {},