@ai-matrx/records-ui 0.115.74 → 0.115.76

package/dist/index.d.cts

@@ -2059,6 +2059,8 @@ interface GridProps {
      * Space only opens.
      */
     onCloseRecord?: (() => void) | undefined;
+    /** The ids the grid is showing, in the order it shows them (AT-RECORD: previous / next in the expanded record). */
+    onRowsShown?: ((ids: Uuid$1[]) => void) | undefined;
     /** SCR-2. Called when an admin clicks the "+" at the end of the headers. */
     onAddField?: (() => void) | undefined;
     /**
@@ -3502,7 +3504,7 @@ declare const SUBSCRIPTION_CADENCE_LABEL: Record<SubscriptionCadence, string>;
 declare const SUBSCRIPTION_CHANNEL_VALUES: readonly ["in_app", "email", "sms"];
 type SubscriptionChannel = (typeof SUBSCRIPTION_CHANNEL_VALUES)[number];
 declare const SUBSCRIPTION_CHANNEL_LABEL: Record<SubscriptionChannel, string>;
-declare const ROLLUP_AGG_VALUES: readonly ["count", "sum", "avg", "min", "max"];
+declare const ROLLUP_AGG_VALUES: readonly ["count", "sum", "avg", "min", "max", "countall", "counta", "and", "or", "xor", "arrayjoin", "concatenate", "arrayunique", "arraycompact"];
 type RollupAgg = (typeof ROLLUP_AGG_VALUES)[number];
 declare const ROLLUP_AGG_LABEL: Record<RollupAgg, string>;
 declare const FORMULA_OP_VALUES: readonly ["concat", "add", "sub", "mul", "div"];
@@ -3792,10 +3794,10 @@ declare function announceTableArchived({ notify, client, tableId, name, onRestor
 
 /** What a look may hold, with this package's grid look. */
 type ViewLook = base.ViewLook<GridPresentation>;
-declare const lookDocument: (look: Partial<Pick<base.SavedViewSpec<GridPresentation>, "layout" | "measure" | "presentation" | "where" | "sorts" | "groupField" | "swimlaneField" | "collapsedColumns" | "dateField" | "startField" | "endField" | "imageField">>) => Record<string, unknown>;
-declare const lookFromDocument: (doc: Record<string, unknown> | null | undefined) => Partial<Pick<base.SavedViewSpec<GridPresentation>, "layout" | "measure" | "presentation" | "where" | "sorts" | "groupField" | "swimlaneField" | "collapsedColumns" | "dateField" | "startField" | "endField" | "imageField">>;
-declare const readLooks: (client: Pick<_ai_matrx_records_core.RecordsClient, "viewLookRead">, tableId: _ai_matrx_records.Uuid) => Promise<_ai_matrx_records.RecordsResult<Record<string, Partial<Pick<base.SavedViewSpec<GridPresentation>, "layout" | "measure" | "presentation" | "where" | "sorts" | "groupField" | "swimlaneField" | "collapsedColumns" | "dateField" | "startField" | "endField" | "imageField">>>>>;
-declare const keepLook: (client: Pick<_ai_matrx_records_core.RecordsClient, "viewLookSet">, tableId: _ai_matrx_records.Uuid, viewId: _ai_matrx_records.Uuid, look: Partial<Pick<base.SavedViewSpec<GridPresentation>, "layout" | "measure" | "presentation" | "where" | "sorts" | "groupField" | "swimlaneField" | "collapsedColumns" | "dateField" | "startField" | "endField" | "imageField">> | null) => Promise<_ai_matrx_records.RecordsResult<Record<string, unknown> | null>>;
+declare const lookDocument: (look: Partial<Pick<base.SavedViewSpec<GridPresentation>, "presentation" | "layout" | "measure" | "where" | "sorts" | "groupField" | "swimlaneField" | "collapsedColumns" | "dateField" | "startField" | "endField" | "imageField">>) => Record<string, unknown>;
+declare const lookFromDocument: (doc: Record<string, unknown> | null | undefined) => Partial<Pick<base.SavedViewSpec<GridPresentation>, "presentation" | "layout" | "measure" | "where" | "sorts" | "groupField" | "swimlaneField" | "collapsedColumns" | "dateField" | "startField" | "endField" | "imageField">>;
+declare const readLooks: (client: Pick<_ai_matrx_records_core.RecordsClient, "viewLookRead">, tableId: _ai_matrx_records.Uuid) => Promise<_ai_matrx_records.RecordsResult<Record<string, Partial<Pick<base.SavedViewSpec<GridPresentation>, "presentation" | "layout" | "measure" | "where" | "sorts" | "groupField" | "swimlaneField" | "collapsedColumns" | "dateField" | "startField" | "endField" | "imageField">>>>>;
+declare const keepLook: (client: Pick<_ai_matrx_records_core.RecordsClient, "viewLookSet">, tableId: _ai_matrx_records.Uuid, viewId: _ai_matrx_records.Uuid, look: Partial<Pick<base.SavedViewSpec<GridPresentation>, "presentation" | "layout" | "measure" | "where" | "sorts" | "groupField" | "swimlaneField" | "collapsedColumns" | "dateField" | "startField" | "endField" | "imageField">> | null) => Promise<_ai_matrx_records.RecordsResult<Record<string, unknown> | null>>;
 /** The words of the look bar. One sentence, then the doors. */
 declare const LOOK_WORDS: {
     /** The reason, for a tooltip or a screen reader — never a line on the page (interface-text). */
@@ -3835,6 +3837,8 @@ interface ViewSwitcherProps {
     openRecordId?: Uuid$1 | null | undefined;
     /** Put the record panel away (Escape, or Space on the open row): `Grid.onCloseRecord`. */
     onCloseRecord?: (() => void) | undefined;
+    /** The ids the grid shows, in its order (`Grid.onRowsShown`). */
+    onRowsShown?: ((ids: Uuid$1[]) => void) | undefined;
     /**
      * Called after a card moves between columns, so the host re-reads the rows it owns. A
      * board that moved a card and left the row list alone would show the card in two places
@@ -3942,7 +3946,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, hideRefusedRowActions, newRowLabel, className, }: ViewSwitcherProps): react.JSX.Element;
+declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onCloseRecord, onRowsShown, 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;
@@ -5906,6 +5910,12 @@ interface TablePageProps$1 {
      * Absent, nothing changes: the page opens exactly as it did.
      */
     activeRecordId?: Uuid | null | undefined;
+    /**
+     * THE RECORD IN THE ADDRESS (AT-RECORD). Told whenever the open record changes (null: shut), so the
+     * host can write `?record=` — pushed when one opens, replaced when she steps to the next, so Back
+     * closes it and a pasted link reopens it. Read back through `activeRecordId`.
+     */
+    onRecordChange?: ((recordId: Uuid | null, how: "open" | "step" | "close") => void) | undefined;
     /**
      * WHICH VIEW THE ADDRESS NAMES — `grid`, `kanban`, `calendar`, `gallery` or
      * `dashboards`, exactly as the host read it out of `?view=`.
@@ -6826,10 +6836,19 @@ interface ViewActionHost {
     togglePersonal?: () => void | Promise<void>;
     /** Move the view to a named section of the list. Left out, no such verb. */
     moveToSection?: () => void | Promise<void>;
+    /** Copy another view's settings onto this one (AT-RECORD, Airtable's "Copy view configuration"). Left out, no such verb. */
+    copySettings?: () => void | Promise<void>;
 }
 /** `whyNot`: the person's reason they may not change this table's views, or null when they may. */
 declare function viewActions(whyNot: string | null, host: ViewActionHost, locked?: boolean, personal?: boolean): ObjectAction[];
 
+interface RecordNeighbors {
+    index: number;
+    total: number;
+    previous: string | null;
+    next: string | null;
+}
+
 interface RecordPanelProps {
     tableId: Uuid$1;
     recordId: Uuid$1;
@@ -6842,8 +6861,14 @@ interface RecordPanelProps {
     onAskAboutField?: ((fieldKey: string) => void) | undefined;
     /** Drawn as the record's own page (no "Open" link to itself). */
     onPage?: boolean | undefined;
-}
-declare function RecordPanel({ tableId, recordId, onClose, onAskAboutField, onPage }: RecordPanelProps): react.JSX.Element;
+    /** Where this record sits in the view the grid shows, and how to move to another (AT-RECORD). */
+    neighbors?: RecordNeighbors | null | undefined;
+    onStep?: ((recordId: Uuid$1) => void) | undefined;
+    /** Drawn over the grid, wide (true) or beside it; `onToggleExpand` draws the control. */
+    expanded?: boolean | undefined;
+    onToggleExpand?: (() => void) | undefined;
+}
+declare function RecordPanel({ tableId, recordId, onClose, onAskAboutField, onPage, neighbors, onStep, expanded, onToggleExpand }: RecordPanelProps): react.JSX.Element;
 
 /**
  * The column a record page writes its body in: the formatted-text column NAMED like a page's body

package/dist/index.d.ts

@@ -2059,6 +2059,8 @@ interface GridProps {
      * Space only opens.
      */
     onCloseRecord?: (() => void) | undefined;
+    /** The ids the grid is showing, in the order it shows them (AT-RECORD: previous / next in the expanded record). */
+    onRowsShown?: ((ids: Uuid$1[]) => void) | undefined;
     /** SCR-2. Called when an admin clicks the "+" at the end of the headers. */
     onAddField?: (() => void) | undefined;
     /**
@@ -3502,7 +3504,7 @@ declare const SUBSCRIPTION_CADENCE_LABEL: Record<SubscriptionCadence, string>;
 declare const SUBSCRIPTION_CHANNEL_VALUES: readonly ["in_app", "email", "sms"];
 type SubscriptionChannel = (typeof SUBSCRIPTION_CHANNEL_VALUES)[number];
 declare const SUBSCRIPTION_CHANNEL_LABEL: Record<SubscriptionChannel, string>;
-declare const ROLLUP_AGG_VALUES: readonly ["count", "sum", "avg", "min", "max"];
+declare const ROLLUP_AGG_VALUES: readonly ["count", "sum", "avg", "min", "max", "countall", "counta", "and", "or", "xor", "arrayjoin", "concatenate", "arrayunique", "arraycompact"];
 type RollupAgg = (typeof ROLLUP_AGG_VALUES)[number];
 declare const ROLLUP_AGG_LABEL: Record<RollupAgg, string>;
 declare const FORMULA_OP_VALUES: readonly ["concat", "add", "sub", "mul", "div"];
@@ -3792,10 +3794,10 @@ declare function announceTableArchived({ notify, client, tableId, name, onRestor
 
 /** What a look may hold, with this package's grid look. */
 type ViewLook = base.ViewLook<GridPresentation>;
-declare const lookDocument: (look: Partial<Pick<base.SavedViewSpec<GridPresentation>, "layout" | "measure" | "presentation" | "where" | "sorts" | "groupField" | "swimlaneField" | "collapsedColumns" | "dateField" | "startField" | "endField" | "imageField">>) => Record<string, unknown>;
-declare const lookFromDocument: (doc: Record<string, unknown> | null | undefined) => Partial<Pick<base.SavedViewSpec<GridPresentation>, "layout" | "measure" | "presentation" | "where" | "sorts" | "groupField" | "swimlaneField" | "collapsedColumns" | "dateField" | "startField" | "endField" | "imageField">>;
-declare const readLooks: (client: Pick<_ai_matrx_records_core.RecordsClient, "viewLookRead">, tableId: _ai_matrx_records.Uuid) => Promise<_ai_matrx_records.RecordsResult<Record<string, Partial<Pick<base.SavedViewSpec<GridPresentation>, "layout" | "measure" | "presentation" | "where" | "sorts" | "groupField" | "swimlaneField" | "collapsedColumns" | "dateField" | "startField" | "endField" | "imageField">>>>>;
-declare const keepLook: (client: Pick<_ai_matrx_records_core.RecordsClient, "viewLookSet">, tableId: _ai_matrx_records.Uuid, viewId: _ai_matrx_records.Uuid, look: Partial<Pick<base.SavedViewSpec<GridPresentation>, "layout" | "measure" | "presentation" | "where" | "sorts" | "groupField" | "swimlaneField" | "collapsedColumns" | "dateField" | "startField" | "endField" | "imageField">> | null) => Promise<_ai_matrx_records.RecordsResult<Record<string, unknown> | null>>;
+declare const lookDocument: (look: Partial<Pick<base.SavedViewSpec<GridPresentation>, "presentation" | "layout" | "measure" | "where" | "sorts" | "groupField" | "swimlaneField" | "collapsedColumns" | "dateField" | "startField" | "endField" | "imageField">>) => Record<string, unknown>;
+declare const lookFromDocument: (doc: Record<string, unknown> | null | undefined) => Partial<Pick<base.SavedViewSpec<GridPresentation>, "presentation" | "layout" | "measure" | "where" | "sorts" | "groupField" | "swimlaneField" | "collapsedColumns" | "dateField" | "startField" | "endField" | "imageField">>;
+declare const readLooks: (client: Pick<_ai_matrx_records_core.RecordsClient, "viewLookRead">, tableId: _ai_matrx_records.Uuid) => Promise<_ai_matrx_records.RecordsResult<Record<string, Partial<Pick<base.SavedViewSpec<GridPresentation>, "presentation" | "layout" | "measure" | "where" | "sorts" | "groupField" | "swimlaneField" | "collapsedColumns" | "dateField" | "startField" | "endField" | "imageField">>>>>;
+declare const keepLook: (client: Pick<_ai_matrx_records_core.RecordsClient, "viewLookSet">, tableId: _ai_matrx_records.Uuid, viewId: _ai_matrx_records.Uuid, look: Partial<Pick<base.SavedViewSpec<GridPresentation>, "presentation" | "layout" | "measure" | "where" | "sorts" | "groupField" | "swimlaneField" | "collapsedColumns" | "dateField" | "startField" | "endField" | "imageField">> | null) => Promise<_ai_matrx_records.RecordsResult<Record<string, unknown> | null>>;
 /** The words of the look bar. One sentence, then the doors. */
 declare const LOOK_WORDS: {
     /** The reason, for a tooltip or a screen reader — never a line on the page (interface-text). */
@@ -3835,6 +3837,8 @@ interface ViewSwitcherProps {
     openRecordId?: Uuid$1 | null | undefined;
     /** Put the record panel away (Escape, or Space on the open row): `Grid.onCloseRecord`. */
     onCloseRecord?: (() => void) | undefined;
+    /** The ids the grid shows, in its order (`Grid.onRowsShown`). */
+    onRowsShown?: ((ids: Uuid$1[]) => void) | undefined;
     /**
      * Called after a card moves between columns, so the host re-reads the rows it owns. A
      * board that moved a card and left the row list alone would show the card in two places
@@ -3942,7 +3946,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, hideRefusedRowActions, newRowLabel, className, }: ViewSwitcherProps): react.JSX.Element;
+declare function ViewSwitcher({ view, onLayoutChange, onViewChange, onOpenRecord, openRecordId, onCloseRecord, onRowsShown, 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;
@@ -5906,6 +5910,12 @@ interface TablePageProps$1 {
      * Absent, nothing changes: the page opens exactly as it did.
      */
     activeRecordId?: Uuid | null | undefined;
+    /**
+     * THE RECORD IN THE ADDRESS (AT-RECORD). Told whenever the open record changes (null: shut), so the
+     * host can write `?record=` — pushed when one opens, replaced when she steps to the next, so Back
+     * closes it and a pasted link reopens it. Read back through `activeRecordId`.
+     */
+    onRecordChange?: ((recordId: Uuid | null, how: "open" | "step" | "close") => void) | undefined;
     /**
      * WHICH VIEW THE ADDRESS NAMES — `grid`, `kanban`, `calendar`, `gallery` or
      * `dashboards`, exactly as the host read it out of `?view=`.
@@ -6826,10 +6836,19 @@ interface ViewActionHost {
     togglePersonal?: () => void | Promise<void>;
     /** Move the view to a named section of the list. Left out, no such verb. */
     moveToSection?: () => void | Promise<void>;
+    /** Copy another view's settings onto this one (AT-RECORD, Airtable's "Copy view configuration"). Left out, no such verb. */
+    copySettings?: () => void | Promise<void>;
 }
 /** `whyNot`: the person's reason they may not change this table's views, or null when they may. */
 declare function viewActions(whyNot: string | null, host: ViewActionHost, locked?: boolean, personal?: boolean): ObjectAction[];
 
+interface RecordNeighbors {
+    index: number;
+    total: number;
+    previous: string | null;
+    next: string | null;
+}
+
 interface RecordPanelProps {
     tableId: Uuid$1;
     recordId: Uuid$1;
@@ -6842,8 +6861,14 @@ interface RecordPanelProps {
     onAskAboutField?: ((fieldKey: string) => void) | undefined;
     /** Drawn as the record's own page (no "Open" link to itself). */
     onPage?: boolean | undefined;
-}
-declare function RecordPanel({ tableId, recordId, onClose, onAskAboutField, onPage }: RecordPanelProps): react.JSX.Element;
+    /** Where this record sits in the view the grid shows, and how to move to another (AT-RECORD). */
+    neighbors?: RecordNeighbors | null | undefined;
+    onStep?: ((recordId: Uuid$1) => void) | undefined;
+    /** Drawn over the grid, wide (true) or beside it; `onToggleExpand` draws the control. */
+    expanded?: boolean | undefined;
+    onToggleExpand?: (() => void) | undefined;
+}
+declare function RecordPanel({ tableId, recordId, onClose, onAskAboutField, onPage, neighbors, onStep, expanded, onToggleExpand }: RecordPanelProps): react.JSX.Element;
 
 /**
  * The column a record page writes its body in: the formatted-text column NAMED like a page's body