@ai-matrx/records-ui 0.93.0 → 0.93.3

package/dist/index.d.cts

@@ -559,8 +559,12 @@ interface HostLayout {
         toolbarSlot?: HTMLElement | null | undefined;
     }) => ReactNode;
 }
-/** The authored-text slots `renderText` is asked to draw. */
-type RenderTextSlot = "form-intro" | "form-help" | "form-thank-you";
+/**
+ * The authored-text slots `renderText` is asked to draw. `cell`: a long-text cell of the merged
+ * grid and the whole-text dialog's preview — the host may return block content there (the grid
+ * clips it to the row); the form slots take phrasing content only.
+ */
+type RenderTextSlot = "form-intro" | "form-help" | "form-thank-you" | "cell";
 
 interface RecordsUiHost {
     /**
@@ -666,6 +670,21 @@ interface RecordsUiHost {
         ok: false;
         reason: string;
     }>;
+    /**
+     * OPTIONAL. THE HOST'S OWN FILE WINDOW (one-grid merge, inventory: the older grid's
+     * AttachmentInput). An attachment cell adds files the person already holds through the host's
+     * file picker — Airtable's "Attach" over your own files — rather than a second browser this
+     * package would invent. `multiple`: the column holds several files; `accept`: the native
+     * `accept` list, when the column restricts types. Resolves the host's file ids (the store turns
+     * each into its kernel File record at the write door), or `null` when the person cancelled.
+     *
+     * Unbound, the editor offers `upload` alone; with neither bound it says no file store is bound
+     * (`NO_UPLOAD_REASON`) — never a dead button.
+     */
+    pickFiles?: (ask: {
+        multiple: boolean;
+        accept?: string;
+    }) => Promise<Uuid$1[] | null>;
     /**
      * Where this app serves its PUBLIC pages from, when that is not the origin
      * the screen is running on. A form's link is built here, so an owner copying
@@ -1306,6 +1325,13 @@ interface GridEditing {
     rowError: RecordsError | null;
     clearRowError: () => void;
     busy: boolean;
+    /**
+     * EVERYTHING THIS SESSION HOLDS THAT CHANGES HOW ONE ROW DRAWS (lane RENDER-AUDIT, 2026-09-26):
+     * the open cell and what is typed in it, an optimistic value, a save in flight, a refusal. The
+     * grid hands it to the data table as `rowVersion`, so a keystroke, a save or a refusal redraws
+     * the ONE row it belongs to and no other.
+     */
+    rowSignature: (rowId: Uuid$1) => readonly unknown[];
 }
 interface Options {
     tableId: Uuid$1;
@@ -2443,7 +2469,7 @@ declare function ProvenanceBadge({ document, fieldKey }: {
  * export, a chat line) keeps calling `renderValue` with no resolver and says
  * "Loading…" rather than printing an id.
  */
-declare function RecordValue({ field, value, document, format, withheld, }: {
+declare function RecordValue({ field, value, document, format, withheld, inCell, }: {
     field: Field;
     value: unknown;
     document?: RecordDocument | undefined;
@@ -2466,6 +2492,12 @@ declare function RecordValue({ field, value, document, format, withheld, }: {
      * means the cell is empty (`withheld.tsx`).
      */
     withheld?: HiddenFieldNotice | null | undefined;
+    /**
+     * Drawn in a GRID CELL. In the merged grid a long-text cell reads through the host's text
+     * renderer (`RecordsUiHost.renderText`, slot `cell` — markdown, formatted), clipped to the row;
+     * unbound, the words as written.
+     */
+    inCell?: boolean | undefined;
 }): react.JSX.Element;
 /**
  * WHAT ONE CARD SAYS — the kanban's, the calendar's, the gallery's and the pipeline's alike, so
@@ -4029,11 +4061,6 @@ interface RecordsMountProps {
     children: ReactNode;
 }
 declare function RecordsMount({ config, host, letTheStoreDecideRights, children, }: RecordsMountProps): react.JSX.Element;
-/**
- * The actor a signed-in person is. `user` is the store's own word (the closed
- * ACTOR_VOCABULARY is `user` · `agent` · `system`), and AGT-N-4 means an agent
- * acting for this person carries exactly this authority and no other.
- */
 declare function personActor(userId: Uuid$1 | null | undefined): RecordsActor;
 /**
  * A supabase-js client AS this package's data seam.

package/dist/index.d.ts

@@ -559,8 +559,12 @@ interface HostLayout {
         toolbarSlot?: HTMLElement | null | undefined;
     }) => ReactNode;
 }
-/** The authored-text slots `renderText` is asked to draw. */
-type RenderTextSlot = "form-intro" | "form-help" | "form-thank-you";
+/**
+ * The authored-text slots `renderText` is asked to draw. `cell`: a long-text cell of the merged
+ * grid and the whole-text dialog's preview — the host may return block content there (the grid
+ * clips it to the row); the form slots take phrasing content only.
+ */
+type RenderTextSlot = "form-intro" | "form-help" | "form-thank-you" | "cell";
 
 interface RecordsUiHost {
     /**
@@ -666,6 +670,21 @@ interface RecordsUiHost {
         ok: false;
         reason: string;
     }>;
+    /**
+     * OPTIONAL. THE HOST'S OWN FILE WINDOW (one-grid merge, inventory: the older grid's
+     * AttachmentInput). An attachment cell adds files the person already holds through the host's
+     * file picker — Airtable's "Attach" over your own files — rather than a second browser this
+     * package would invent. `multiple`: the column holds several files; `accept`: the native
+     * `accept` list, when the column restricts types. Resolves the host's file ids (the store turns
+     * each into its kernel File record at the write door), or `null` when the person cancelled.
+     *
+     * Unbound, the editor offers `upload` alone; with neither bound it says no file store is bound
+     * (`NO_UPLOAD_REASON`) — never a dead button.
+     */
+    pickFiles?: (ask: {
+        multiple: boolean;
+        accept?: string;
+    }) => Promise<Uuid$1[] | null>;
     /**
      * Where this app serves its PUBLIC pages from, when that is not the origin
      * the screen is running on. A form's link is built here, so an owner copying
@@ -1306,6 +1325,13 @@ interface GridEditing {
     rowError: RecordsError | null;
     clearRowError: () => void;
     busy: boolean;
+    /**
+     * EVERYTHING THIS SESSION HOLDS THAT CHANGES HOW ONE ROW DRAWS (lane RENDER-AUDIT, 2026-09-26):
+     * the open cell and what is typed in it, an optimistic value, a save in flight, a refusal. The
+     * grid hands it to the data table as `rowVersion`, so a keystroke, a save or a refusal redraws
+     * the ONE row it belongs to and no other.
+     */
+    rowSignature: (rowId: Uuid$1) => readonly unknown[];
 }
 interface Options {
     tableId: Uuid$1;
@@ -2443,7 +2469,7 @@ declare function ProvenanceBadge({ document, fieldKey }: {
  * export, a chat line) keeps calling `renderValue` with no resolver and says
  * "Loading…" rather than printing an id.
  */
-declare function RecordValue({ field, value, document, format, withheld, }: {
+declare function RecordValue({ field, value, document, format, withheld, inCell, }: {
     field: Field;
     value: unknown;
     document?: RecordDocument | undefined;
@@ -2466,6 +2492,12 @@ declare function RecordValue({ field, value, document, format, withheld, }: {
      * means the cell is empty (`withheld.tsx`).
      */
     withheld?: HiddenFieldNotice | null | undefined;
+    /**
+     * Drawn in a GRID CELL. In the merged grid a long-text cell reads through the host's text
+     * renderer (`RecordsUiHost.renderText`, slot `cell` — markdown, formatted), clipped to the row;
+     * unbound, the words as written.
+     */
+    inCell?: boolean | undefined;
 }): react.JSX.Element;
 /**
  * WHAT ONE CARD SAYS — the kanban's, the calendar's, the gallery's and the pipeline's alike, so
@@ -4029,11 +4061,6 @@ interface RecordsMountProps {
     children: ReactNode;
 }
 declare function RecordsMount({ config, host, letTheStoreDecideRights, children, }: RecordsMountProps): react.JSX.Element;
-/**
- * The actor a signed-in person is. `user` is the store's own word (the closed
- * ACTOR_VOCABULARY is `user` · `agent` · `system`), and AGT-N-4 means an agent
- * acting for this person carries exactly this authority and no other.
- */
 declare function personActor(userId: Uuid$1 | null | undefined): RecordsActor;
 /**
  * A supabase-js client AS this package's data seam.