@ai-matrx/records-ui 0.92.2 → 0.93.2

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
@@ -1821,6 +1840,13 @@ interface GridProps {
      * the store compiles both into the one WHERE clause.
      */
     filter?: StoreFilter$1 | undefined;
+    /**
+     * Clear the question `filter` carries (the view's own filter), for the "No rows match these
+     * filters" screen's Clear filters. Left out, that screen clears only the grid's own search and
+     * column filters, and when `filter` alone holds every row back it says so instead of offering a
+     * button that could not clear it.
+     */
+    onClearFilter?: (() => void) | undefined;
     /** Opened from a row's handle, Space or the row menu. A host that has a record page passes its own. */
     onOpenRecord?: ((recordId: Uuid) => void) | undefined;
     /**
@@ -1889,7 +1915,7 @@ interface GridProps {
     footer?: FooterPlacement | undefined;
     className?: string | undefined;
 }
-declare function Grid({ tableId, pageSize, filter, onOpenRecord, openRecordId, onAddField, onNewRecordForm, toolbarActions, editable, presentation, onPresentationChange, viewOrder, footer, className, onAskWhoChanged, }: GridProps): react.JSX.Element;
+declare function Grid({ tableId, pageSize, filter, onClearFilter, onOpenRecord, openRecordId, onAddField, onNewRecordForm, toolbarActions, editable, presentation, onPresentationChange, viewOrder, footer, className, onAskWhoChanged, }: GridProps): react.JSX.Element;
 
 /** Answers "what is the record with this id called", for one Field's values. */
 type LabelLookup = (field: Field$1, id: string) => string | null;
@@ -2436,7 +2462,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;
@@ -2459,6 +2485,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
@@ -2771,6 +2803,11 @@ interface ViewSwitcherProps {
      * store's Rule shape). The grid, the board's headings and the numbers all ask it.
      */
     filter?: StoreFilter | undefined;
+    /**
+     * Clear the question `filter` carries, for the "No rows match these filters" screen of every
+     * layout. Left out, that screen says the view's filter holds every row back without a button.
+     */
+    onClearFilter?: (() => void) | undefined;
     /**
      * The HOST layout showing now (`RecordsUiHost.layouts`, by id), or null for the
      * package's own. Controlled by the page, because the address names it.
@@ -2826,7 +2863,7 @@ declare function useViewRecords(view: SavedViewSpec, pageSize?: number, filter?:
      */
     membership: string;
 };
-declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onMoved, onNewRecordForm, onAskWhoChanged, pageSize, titleField, filter, hostLayout, onHostLayoutChange, chooser, openExport, viewId, onOrderPlaced, footer, className, }: ViewSwitcherProps): react.JSX.Element;
+declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onMoved, onNewRecordForm, onAskWhoChanged, pageSize, titleField, filter, onClearFilter, hostLayout, onHostLayoutChange, chooser, openExport, viewId, onOrderPlaced, footer, className, }: ViewSwitcherProps): react.JSX.Element;
 
 /** What the screen says above the list, so nobody has to be told twice that nothing was destroyed. */
 declare const ARCHIVE_MEANS = "Archiving never destroys anything. A record you remove from the grid waits here until somebody brings it back.";

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
@@ -1821,6 +1840,13 @@ interface GridProps {
      * the store compiles both into the one WHERE clause.
      */
     filter?: StoreFilter$1 | undefined;
+    /**
+     * Clear the question `filter` carries (the view's own filter), for the "No rows match these
+     * filters" screen's Clear filters. Left out, that screen clears only the grid's own search and
+     * column filters, and when `filter` alone holds every row back it says so instead of offering a
+     * button that could not clear it.
+     */
+    onClearFilter?: (() => void) | undefined;
     /** Opened from a row's handle, Space or the row menu. A host that has a record page passes its own. */
     onOpenRecord?: ((recordId: Uuid) => void) | undefined;
     /**
@@ -1889,7 +1915,7 @@ interface GridProps {
     footer?: FooterPlacement | undefined;
     className?: string | undefined;
 }
-declare function Grid({ tableId, pageSize, filter, onOpenRecord, openRecordId, onAddField, onNewRecordForm, toolbarActions, editable, presentation, onPresentationChange, viewOrder, footer, className, onAskWhoChanged, }: GridProps): react.JSX.Element;
+declare function Grid({ tableId, pageSize, filter, onClearFilter, onOpenRecord, openRecordId, onAddField, onNewRecordForm, toolbarActions, editable, presentation, onPresentationChange, viewOrder, footer, className, onAskWhoChanged, }: GridProps): react.JSX.Element;
 
 /** Answers "what is the record with this id called", for one Field's values. */
 type LabelLookup = (field: Field$1, id: string) => string | null;
@@ -2436,7 +2462,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;
@@ -2459,6 +2485,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
@@ -2771,6 +2803,11 @@ interface ViewSwitcherProps {
      * store's Rule shape). The grid, the board's headings and the numbers all ask it.
      */
     filter?: StoreFilter | undefined;
+    /**
+     * Clear the question `filter` carries, for the "No rows match these filters" screen of every
+     * layout. Left out, that screen says the view's filter holds every row back without a button.
+     */
+    onClearFilter?: (() => void) | undefined;
     /**
      * The HOST layout showing now (`RecordsUiHost.layouts`, by id), or null for the
      * package's own. Controlled by the page, because the address names it.
@@ -2826,7 +2863,7 @@ declare function useViewRecords(view: SavedViewSpec, pageSize?: number, filter?:
      */
     membership: string;
 };
-declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onMoved, onNewRecordForm, onAskWhoChanged, pageSize, titleField, filter, hostLayout, onHostLayoutChange, chooser, openExport, viewId, onOrderPlaced, footer, className, }: ViewSwitcherProps): react.JSX.Element;
+declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onMoved, onNewRecordForm, onAskWhoChanged, pageSize, titleField, filter, onClearFilter, hostLayout, onHostLayoutChange, chooser, openExport, viewId, onOrderPlaced, footer, className, }: ViewSwitcherProps): react.JSX.Element;
 
 /** What the screen says above the list, so nobody has to be told twice that nothing was destroyed. */
 declare const ARCHIVE_MEANS = "Archiving never destroys anything. A record you remove from the grid waits here until somebody brings it back.";