@ai-matrx/records-ui 0.113.30 → 0.113.32

package/dist/first-page.d.cts

@@ -1,7 +1,10 @@
-import { Uuid, RecordFilter, RuleExpression, RecordsConfig, StoreFilter, RecordPageSort, Table, Field } from '@ai-matrx/records';
-import { RecordsClient, RecordsSeed } from '@ai-matrx/records/core';
+import * as _ai_matrx_records_views from '@ai-matrx/records/views';
 import { TableStyle, GroupAggregateSpec, GroupOrder } from '@ai-matrx/design-system/data-table';
 import { FieldFormatConfig } from '@ai-matrx/design-system/field-formats';
+import * as _ai_matrx_records_first_page from '@ai-matrx/records/first-page';
+export { EMBEDDED_PAGE_SIZE, FirstGridPageArgs, TABLE_PAGE_SIZE, TileSpec, askChartSeed, askEntityBlockSeed, askTileSeed, firstGridPageArgs, mergeSeeds, serverRowsOf, viewFilterOf } from '@ai-matrx/records/first-page';
+import * as _ai_matrx_records from '@ai-matrx/records';
+import * as _ai_matrx_records_core from '@ai-matrx/records/core';
 
 /**
  * HOW A TABLE LOOKS — colors, formats and the frozen column.
@@ -160,259 +163,22 @@ type GridPresentation = {
 /** Where a grid's footer sits. */
 type FooterPlacement = "sticky" | "inline";
 
-/** The ways one saved view can be looked at (SCR-6; the timeline, lane VIEWS-AND-FIELDS TL). */
-declare const VIEW_LAYOUTS: readonly ["grid", "kanban", "calendar", "gallery", "timeline", "list"];
-type ViewLayout = (typeof VIEW_LAYOUTS)[number];
-/** One sort clause. The Field's key and a direction; nothing else is a sort. */
-interface ViewSort {
-    field: string;
-    direction: "asc" | "desc";
-}
-/** How a saved view is ordered: by hand, by its sort, or it never said (the same as sorted). */
-type ViewOrder = "manual" | "sorted" | null;
-/**
- * THE DECLARATIVE SPEC. An agent writes this whole object; a person tweaks it.
- * Every builder component in this package takes one of these as a prop.
- */
-interface SavedViewSpec {
-    name: string;
-    /** The Table this view looks at. */
-    subject: Uuid;
-    layout: ViewLayout;
-    /** Kanban: the Field whose value becomes a column. */
-    groupField?: string | null;
-    /**
-     * Kanban: a number Field to TOTAL under each column heading. It lives on the VIEW for
-     * the same reason the colours do — two people read one board two ways and neither
-     * reading is a fact about the records.
-     */
-    measure?: string | null;
-    /**
-     * Kanban: the Field whose values cut the board into SWIMLANES across the columns — a
-     * dispatcher's board by Status, one lane per Technician (S1-PRIME VIEW-KEYS). Never the
-     * column Field itself; the store refuses that.
-     */
-    swimlaneField?: string | null;
-    /** Kanban: the columns this view keeps shut to a strip, by the column's stored value. */
-    collapsedColumns?: string[];
-    /** Calendar: the Field that places a record in the month. */
-    dateField?: string | null;
-    /** Timeline: the Field a record's bar starts on (`start_field`). */
-    startField?: string | null;
-    /** Calendar and timeline: the Field a record ends on (`end_field`). */
-    endField?: string | null;
-    /** Gallery: the Field shown large on the card. */
-    imageField?: string | null;
-    sorts?: ViewSort[];
-    /**
-     * HOW THE VIEW IS ORDERED (ORDER-FIX): `"manual"` — the positions a person set by hand ARE the
-     * view's sort, and it carries no `sorts`; `"sorted"` or null — by `sorts`. READ ONLY: the store
-     * writes "manual" only when the rows are placed (`custom.view_record_order_set`) and turns it
-     * off itself when a sort is saved, so no patch ever sends it (`viewSettingsPatch` does not).
-     */
-    order?: ViewOrder;
-    /**
-     * The membership Rule. The STORE decides who is in this view; this is a
-     * reference to its Rule record, never a predicate this package evaluates.
-     */
-    ruleId?: Uuid | null;
-    /**
-     * THE FLAT FILTER a digest or a notify rule wrote the view with — the one shape
-     * `custom.record_filter_sql` compiles, by Field KEY. A view saved in the bar has
-     * none; a view saved by `DigestScheduler` ("where Status is Open") does, and the
-     * grid and the board show exactly the records it names.
-     */
-    filters?: RecordFilter;
-    /**
-     * S2-PRIME — THE VIEW'S OWN QUESTION, as the condition builder writes it: the store's Rule
-     * shape `{op, args}`, ALL / ANY / NOT groups nested to any depth, Fields by id. Kept in the
-     * definition as `where` and asked of the store unchanged — the grid's list door, the board's
-     * headings and the dashboard's numbers compile it into the one WHERE clause
-     * (`custom.record_filter_sql`). Never stored under `filters`: that key is the flat map the
-     * digests and the notifier read, and they would refuse it by name.
-     */
-    where?: RuleExpression | null;
-    isDefault?: boolean;
-    /**
-     * HOW THIS VIEW LOOKS — its colors, its per-column formats and its frozen
-     * column (`presentation.ts`).
-     *
-     * It lives on the VIEW and not on the Fields because two people read one
-     * table two ways and neither reading is a fact about the records; it lives on
-     * a RECORD, not a new column, because that is what makes it something an
-     * agent writes with the same `records` tool as everything else.
-     */
-    presentation?: GridPresentation;
-}
-/**
- * A saved view as it comes back out of the store, with its row's own id.
- *
- * It carries no version: `custom.view_declare` MERGES one key at a time, so two
- * tabs pressing two different controls on one view both stand, and one control
- * pressed in both keeps the latest — how Airtable and Notion keep a view change.
- */
-interface SavedView extends SavedViewSpec {
-    id: Uuid;
-    /** Where the view came from when it was moved in (the mover, the S0 repair), else null. */
-    movedFrom: Record<string, unknown> | null;
-}
-
-/** The block's own props that decide a chart's question. */
-interface EntityChartQuestionInput {
-    /** The Dimension to group by. Absent: one total. */
-    by?: string | undefined;
-    /** What to count: the rows (default) or a number column summed. */
-    measure?: {
-        op: "count";
-    } | {
-        op: "sum" | "avg" | "min" | "max";
-        of: string;
-    } | undefined;
-    where?: Record<string, unknown> | undefined;
-    organization?: string | undefined;
-}
-
-type Base = {
-    dataSource: unknown;
-    organizationId: Uuid;
-    actor: RecordsConfig["actor"];
-};
-/** Several seeds as one: the later answer wins on the same door and arguments; `at` is the oldest. */
-declare function mergeSeeds(...seeds: Array<RecordsSeed | null | undefined>): RecordsSeed;
-/**
- * AN ENTITY SOURCE'S BLOCK (a table, board or card of "task", "project", "crm_deal", "hr_employee"):
- * its columns and first page, asked through the entity engine's own port with the question the block's
- * `useEntityTable` sends — `question.pageSize` (the block's page size: 100, or 50 embedded) and the
- * viewer's `question.search`, if any. Never throws.
- */
-declare function askEntityBlockSeed(input: Base & {
-    token: string;
-    question?: {
-        pageSize?: number | undefined;
-        search?: string | null | undefined;
-    };
-}): Promise<RecordsSeed>;
-/**
- * AN ENTITY SOURCE'S CHART (`EntityChartBlock`): `platform.drill_ask` with the question the block sends.
- * `question` is the block's own props: `by`, `measure`, `where`, `organization`.
- */
-declare function askChartSeed(input: Base & {
-    source: {
-        kind: "entity";
-        token: string;
-    };
-    question?: EntityChartQuestionInput;
-}): Promise<RecordsSeed>;
-/** One aggregate question of a tile: `client.recordAggregate`'s arguments but the table. */
-type TileSpec = Omit<Parameters<RecordsClient["recordAggregate"]>[0], "table_id">;
-/**
- * A TABLE'S TILE: `custom.record_aggregate` over `tableId` for each `spec` (a tile that also shows a
- * whole-table total gives both). The tile reads the number back with `useSeededAggregate`
- * (`@ai-matrx/records/react`) under the very same spec.
- */
-declare function askTileSeed(input: Base & {
-    tableId: Uuid;
-    spec: TileSpec | TileSpec[];
-}): Promise<RecordsSeed>;
-
-/** The table page's own page size (`TablePage`: 100 unless embedded). */
-declare const TABLE_PAGE_SIZE = 100;
-/**
- * HOW MANY ROWS AN EMBEDDED TABLE READS AT A TIME (CHAIR-EMBEDDED-FIDELITY 16): its first page, and
- * each "Show more" press brings about this many more. `embeddedLook.tsx` re-exports it.
- */
-declare const EMBEDDED_PAGE_SIZE = 50;
-interface FirstGridPageArgs {
-    p_table_id: Uuid;
-    p_filter: StoreFilter | Record<string, never>;
-    p_search: null;
-    p_sort: RecordPageSort[];
-    p_view_id: null;
-    p_limit: number;
-    p_offset: 0;
-}
-/**
- * THE VIEW'S OWN QUESTION, as the grid asks it (`TablePage` `shownFilter`): its Rule, else its flat filter,
- * through the one question builder. Undefined when it asks none.
- */
-declare function viewFilterOf(shown: Pick<SavedViewSpec, "where" | "filters"> | null, fields: readonly Field[]): StoreFilter | undefined;
-/** The request for the plain opening, from what the screen itself reads — or null. Pure. */
-declare function firstGridPageArgs(input: {
-    tableId: Uuid;
-    table: Pick<Table, "default_sort"> | null;
-    fields: readonly Field[];
-    /** The view as THIS person sees it (the saved view with her look over it), or null for none. */
-    shown: SavedView | null;
-    pageSize?: number;
-    /**
-     * The host draws the MERGED grid (`RecordsUiProvider grid="merged"`), which keeps a plain grouping as rows
-     * under group headers: the page is then read in group order. The classic grid opens the drill for a
-     * grouped view, so a grouped view stays unseeded there.
-     */
-    merged?: boolean;
-}): FirstGridPageArgs | null;
-/**
- * Read what the screen reads (through `client`, e.g. one served from `custom.table_page_bundle`)
- * and build the first page's request. Null when anything it needs is not answered.
- */
-declare function firstGridPageRequest(client: Pick<RecordsClient, "tableRead" | "fields" | "views" | "viewLookRead">, tableId: Uuid, options?: {
+declare const firstGridPageRequest: (client: Pick<_ai_matrx_records_core.RecordsClient, "tableRead" | "fields" | "views" | "viewLookRead">, tableId: _ai_matrx_records.Uuid, options?: {
     pageSize?: number;
     merged?: boolean;
-}): Promise<FirstGridPageArgs | null>;
-/**
- * A TABLE PAGE'S SEED, ASKED BY THE SERVER AS THE PERSON (lane SSR-ROWS).
- *
- * Asks what the table page opens on — the table's bundle (`custom.table_page_bundle`, through the
- * records client exactly as the browser would), the grid's first page when `firstGridPageRequest`
- * can predict it, and on a record page the record's bundle — through a recording data source, and
- * answers every door answer it got as a `RecordsSeed`. The host hands that to
- * `<RecordsSeedProvider>` (`@ai-matrx/records/react`) above the table page: the page is drawn with
- * its rows in the server's HTML and hydrates onto them without asking again.
- *
- * `dataSource` is the person's own (a server supabase client carrying her session): every door
- * decides exactly as it does from the browser. Never throws; a door that refuses is simply not in
- * the seed, and the page asks it for itself.
- */
-/**
- * THE PERSON'S SERVER-ROWS KNOBS, FROM THE TABLE'S BUNDLE (lanes SSR-ROWS-2, SSR-ROWS-3):
- * `custom.table_page_bundle` carries a `server_rows` part — `data.server_rows` and
- * `data.server_rows_cap_ms` (how long the page may wait for the server's rows before the browser asks
- * for itself) resolved for the person asking in that organization. Null when the seed holds no such
- * answer (an older store, a refused part): the host treats that as off.
- */
-declare function serverRowsOf(seed: RecordsSeed | null | undefined): {
-    on: boolean;
-    capMs: number | null;
-} | null;
-declare function askTablePageSeed(input: {
+}) => Promise<_ai_matrx_records_first_page.FirstGridPageArgs | null>;
+declare const askTablePageSeed: (input: Omit<{
     dataSource: unknown;
-    organizationId: Uuid;
-    tableId: Uuid;
-    actor: RecordsConfig["actor"];
-    /** A record page: its record's bundle (`custom.record_page_bundle`) is asked beside the table's. */
-    recordId?: Uuid | null;
-    /**
-     * Ask the grid's first page (default true). Off when the address opens something else. A function
-     * decides once the table's shape (its bundle) has been answered — it is handed everything asked so
-     * far, so a host can read the person's `server_rows` knob from the bundle (`serverRowsOf`) and ask
-     * the rows only when it is on, at no extra read.
-     */
-    rows?: boolean | ((asked: RecordsSeed) => boolean);
-    /** The table is drawn EMBEDDED (`TablePage presentation="embedded"`, a Space's inline table): its page size. */
+    organizationId: _ai_matrx_records.Uuid;
+    tableId: _ai_matrx_records.Uuid;
+    actor: _ai_matrx_records.RecordsConfig["actor"];
+    recordId?: _ai_matrx_records.Uuid | null;
+    rows?: boolean | ((asked: _ai_matrx_records_core.RecordsSeed) => boolean);
     embedded?: boolean;
     pageSize?: number;
-    /**
-     * The host draws the merged grid. A view grouped by one field (no sub-levels, pivot or drill trail) is then
-     * seeded too: the page in group order, the group counts, the summary bar, and the words of the links on the
-     * page — each asked with the arguments the grid sends, so the browser's own call finds its answer.
-     */
     merged?: boolean;
-    /**
-     * THE VIEW THE HOST HANDS THE GRID (a Space's own spec: sorts, filters, `where`, grouping), for a table with
-     * no saved view behind it. The first page is built from it exactly as the grid reads it; the table's saved
-     * views and looks are not asked.
-     */
-    view?: SavedViewSpec | undefined;
-}): Promise<RecordsSeed>;
+    view?: _ai_matrx_records_views.SavedViewSpec<GridPresentation> | undefined;
+    codec?: _ai_matrx_records_views.ViewPresentationCodec<GridPresentation>;
+}, "codec">) => Promise<_ai_matrx_records_core.RecordsSeed>;
 
-export { EMBEDDED_PAGE_SIZE, type FirstGridPageArgs, TABLE_PAGE_SIZE, type TileSpec, askChartSeed, askEntityBlockSeed, askTablePageSeed, askTileSeed, firstGridPageArgs, firstGridPageRequest, mergeSeeds, serverRowsOf, viewFilterOf };
+export { askTablePageSeed, firstGridPageRequest };

package/dist/first-page.d.ts

@@ -1,7 +1,10 @@
-import { Uuid, RecordFilter, RuleExpression, RecordsConfig, StoreFilter, RecordPageSort, Table, Field } from '@ai-matrx/records';
-import { RecordsClient, RecordsSeed } from '@ai-matrx/records/core';
+import * as _ai_matrx_records_views from '@ai-matrx/records/views';
 import { TableStyle, GroupAggregateSpec, GroupOrder } from '@ai-matrx/design-system/data-table';
 import { FieldFormatConfig } from '@ai-matrx/design-system/field-formats';
+import * as _ai_matrx_records_first_page from '@ai-matrx/records/first-page';
+export { EMBEDDED_PAGE_SIZE, FirstGridPageArgs, TABLE_PAGE_SIZE, TileSpec, askChartSeed, askEntityBlockSeed, askTileSeed, firstGridPageArgs, mergeSeeds, serverRowsOf, viewFilterOf } from '@ai-matrx/records/first-page';
+import * as _ai_matrx_records from '@ai-matrx/records';
+import * as _ai_matrx_records_core from '@ai-matrx/records/core';
 
 /**
  * HOW A TABLE LOOKS — colors, formats and the frozen column.
@@ -160,259 +163,22 @@ type GridPresentation = {
 /** Where a grid's footer sits. */
 type FooterPlacement = "sticky" | "inline";
 
-/** The ways one saved view can be looked at (SCR-6; the timeline, lane VIEWS-AND-FIELDS TL). */
-declare const VIEW_LAYOUTS: readonly ["grid", "kanban", "calendar", "gallery", "timeline", "list"];
-type ViewLayout = (typeof VIEW_LAYOUTS)[number];
-/** One sort clause. The Field's key and a direction; nothing else is a sort. */
-interface ViewSort {
-    field: string;
-    direction: "asc" | "desc";
-}
-/** How a saved view is ordered: by hand, by its sort, or it never said (the same as sorted). */
-type ViewOrder = "manual" | "sorted" | null;
-/**
- * THE DECLARATIVE SPEC. An agent writes this whole object; a person tweaks it.
- * Every builder component in this package takes one of these as a prop.
- */
-interface SavedViewSpec {
-    name: string;
-    /** The Table this view looks at. */
-    subject: Uuid;
-    layout: ViewLayout;
-    /** Kanban: the Field whose value becomes a column. */
-    groupField?: string | null;
-    /**
-     * Kanban: a number Field to TOTAL under each column heading. It lives on the VIEW for
-     * the same reason the colours do — two people read one board two ways and neither
-     * reading is a fact about the records.
-     */
-    measure?: string | null;
-    /**
-     * Kanban: the Field whose values cut the board into SWIMLANES across the columns — a
-     * dispatcher's board by Status, one lane per Technician (S1-PRIME VIEW-KEYS). Never the
-     * column Field itself; the store refuses that.
-     */
-    swimlaneField?: string | null;
-    /** Kanban: the columns this view keeps shut to a strip, by the column's stored value. */
-    collapsedColumns?: string[];
-    /** Calendar: the Field that places a record in the month. */
-    dateField?: string | null;
-    /** Timeline: the Field a record's bar starts on (`start_field`). */
-    startField?: string | null;
-    /** Calendar and timeline: the Field a record ends on (`end_field`). */
-    endField?: string | null;
-    /** Gallery: the Field shown large on the card. */
-    imageField?: string | null;
-    sorts?: ViewSort[];
-    /**
-     * HOW THE VIEW IS ORDERED (ORDER-FIX): `"manual"` — the positions a person set by hand ARE the
-     * view's sort, and it carries no `sorts`; `"sorted"` or null — by `sorts`. READ ONLY: the store
-     * writes "manual" only when the rows are placed (`custom.view_record_order_set`) and turns it
-     * off itself when a sort is saved, so no patch ever sends it (`viewSettingsPatch` does not).
-     */
-    order?: ViewOrder;
-    /**
-     * The membership Rule. The STORE decides who is in this view; this is a
-     * reference to its Rule record, never a predicate this package evaluates.
-     */
-    ruleId?: Uuid | null;
-    /**
-     * THE FLAT FILTER a digest or a notify rule wrote the view with — the one shape
-     * `custom.record_filter_sql` compiles, by Field KEY. A view saved in the bar has
-     * none; a view saved by `DigestScheduler` ("where Status is Open") does, and the
-     * grid and the board show exactly the records it names.
-     */
-    filters?: RecordFilter;
-    /**
-     * S2-PRIME — THE VIEW'S OWN QUESTION, as the condition builder writes it: the store's Rule
-     * shape `{op, args}`, ALL / ANY / NOT groups nested to any depth, Fields by id. Kept in the
-     * definition as `where` and asked of the store unchanged — the grid's list door, the board's
-     * headings and the dashboard's numbers compile it into the one WHERE clause
-     * (`custom.record_filter_sql`). Never stored under `filters`: that key is the flat map the
-     * digests and the notifier read, and they would refuse it by name.
-     */
-    where?: RuleExpression | null;
-    isDefault?: boolean;
-    /**
-     * HOW THIS VIEW LOOKS — its colors, its per-column formats and its frozen
-     * column (`presentation.ts`).
-     *
-     * It lives on the VIEW and not on the Fields because two people read one
-     * table two ways and neither reading is a fact about the records; it lives on
-     * a RECORD, not a new column, because that is what makes it something an
-     * agent writes with the same `records` tool as everything else.
-     */
-    presentation?: GridPresentation;
-}
-/**
- * A saved view as it comes back out of the store, with its row's own id.
- *
- * It carries no version: `custom.view_declare` MERGES one key at a time, so two
- * tabs pressing two different controls on one view both stand, and one control
- * pressed in both keeps the latest — how Airtable and Notion keep a view change.
- */
-interface SavedView extends SavedViewSpec {
-    id: Uuid;
-    /** Where the view came from when it was moved in (the mover, the S0 repair), else null. */
-    movedFrom: Record<string, unknown> | null;
-}
-
-/** The block's own props that decide a chart's question. */
-interface EntityChartQuestionInput {
-    /** The Dimension to group by. Absent: one total. */
-    by?: string | undefined;
-    /** What to count: the rows (default) or a number column summed. */
-    measure?: {
-        op: "count";
-    } | {
-        op: "sum" | "avg" | "min" | "max";
-        of: string;
-    } | undefined;
-    where?: Record<string, unknown> | undefined;
-    organization?: string | undefined;
-}
-
-type Base = {
-    dataSource: unknown;
-    organizationId: Uuid;
-    actor: RecordsConfig["actor"];
-};
-/** Several seeds as one: the later answer wins on the same door and arguments; `at` is the oldest. */
-declare function mergeSeeds(...seeds: Array<RecordsSeed | null | undefined>): RecordsSeed;
-/**
- * AN ENTITY SOURCE'S BLOCK (a table, board or card of "task", "project", "crm_deal", "hr_employee"):
- * its columns and first page, asked through the entity engine's own port with the question the block's
- * `useEntityTable` sends — `question.pageSize` (the block's page size: 100, or 50 embedded) and the
- * viewer's `question.search`, if any. Never throws.
- */
-declare function askEntityBlockSeed(input: Base & {
-    token: string;
-    question?: {
-        pageSize?: number | undefined;
-        search?: string | null | undefined;
-    };
-}): Promise<RecordsSeed>;
-/**
- * AN ENTITY SOURCE'S CHART (`EntityChartBlock`): `platform.drill_ask` with the question the block sends.
- * `question` is the block's own props: `by`, `measure`, `where`, `organization`.
- */
-declare function askChartSeed(input: Base & {
-    source: {
-        kind: "entity";
-        token: string;
-    };
-    question?: EntityChartQuestionInput;
-}): Promise<RecordsSeed>;
-/** One aggregate question of a tile: `client.recordAggregate`'s arguments but the table. */
-type TileSpec = Omit<Parameters<RecordsClient["recordAggregate"]>[0], "table_id">;
-/**
- * A TABLE'S TILE: `custom.record_aggregate` over `tableId` for each `spec` (a tile that also shows a
- * whole-table total gives both). The tile reads the number back with `useSeededAggregate`
- * (`@ai-matrx/records/react`) under the very same spec.
- */
-declare function askTileSeed(input: Base & {
-    tableId: Uuid;
-    spec: TileSpec | TileSpec[];
-}): Promise<RecordsSeed>;
-
-/** The table page's own page size (`TablePage`: 100 unless embedded). */
-declare const TABLE_PAGE_SIZE = 100;
-/**
- * HOW MANY ROWS AN EMBEDDED TABLE READS AT A TIME (CHAIR-EMBEDDED-FIDELITY 16): its first page, and
- * each "Show more" press brings about this many more. `embeddedLook.tsx` re-exports it.
- */
-declare const EMBEDDED_PAGE_SIZE = 50;
-interface FirstGridPageArgs {
-    p_table_id: Uuid;
-    p_filter: StoreFilter | Record<string, never>;
-    p_search: null;
-    p_sort: RecordPageSort[];
-    p_view_id: null;
-    p_limit: number;
-    p_offset: 0;
-}
-/**
- * THE VIEW'S OWN QUESTION, as the grid asks it (`TablePage` `shownFilter`): its Rule, else its flat filter,
- * through the one question builder. Undefined when it asks none.
- */
-declare function viewFilterOf(shown: Pick<SavedViewSpec, "where" | "filters"> | null, fields: readonly Field[]): StoreFilter | undefined;
-/** The request for the plain opening, from what the screen itself reads — or null. Pure. */
-declare function firstGridPageArgs(input: {
-    tableId: Uuid;
-    table: Pick<Table, "default_sort"> | null;
-    fields: readonly Field[];
-    /** The view as THIS person sees it (the saved view with her look over it), or null for none. */
-    shown: SavedView | null;
-    pageSize?: number;
-    /**
-     * The host draws the MERGED grid (`RecordsUiProvider grid="merged"`), which keeps a plain grouping as rows
-     * under group headers: the page is then read in group order. The classic grid opens the drill for a
-     * grouped view, so a grouped view stays unseeded there.
-     */
-    merged?: boolean;
-}): FirstGridPageArgs | null;
-/**
- * Read what the screen reads (through `client`, e.g. one served from `custom.table_page_bundle`)
- * and build the first page's request. Null when anything it needs is not answered.
- */
-declare function firstGridPageRequest(client: Pick<RecordsClient, "tableRead" | "fields" | "views" | "viewLookRead">, tableId: Uuid, options?: {
+declare const firstGridPageRequest: (client: Pick<_ai_matrx_records_core.RecordsClient, "tableRead" | "fields" | "views" | "viewLookRead">, tableId: _ai_matrx_records.Uuid, options?: {
     pageSize?: number;
     merged?: boolean;
-}): Promise<FirstGridPageArgs | null>;
-/**
- * A TABLE PAGE'S SEED, ASKED BY THE SERVER AS THE PERSON (lane SSR-ROWS).
- *
- * Asks what the table page opens on — the table's bundle (`custom.table_page_bundle`, through the
- * records client exactly as the browser would), the grid's first page when `firstGridPageRequest`
- * can predict it, and on a record page the record's bundle — through a recording data source, and
- * answers every door answer it got as a `RecordsSeed`. The host hands that to
- * `<RecordsSeedProvider>` (`@ai-matrx/records/react`) above the table page: the page is drawn with
- * its rows in the server's HTML and hydrates onto them without asking again.
- *
- * `dataSource` is the person's own (a server supabase client carrying her session): every door
- * decides exactly as it does from the browser. Never throws; a door that refuses is simply not in
- * the seed, and the page asks it for itself.
- */
-/**
- * THE PERSON'S SERVER-ROWS KNOBS, FROM THE TABLE'S BUNDLE (lanes SSR-ROWS-2, SSR-ROWS-3):
- * `custom.table_page_bundle` carries a `server_rows` part — `data.server_rows` and
- * `data.server_rows_cap_ms` (how long the page may wait for the server's rows before the browser asks
- * for itself) resolved for the person asking in that organization. Null when the seed holds no such
- * answer (an older store, a refused part): the host treats that as off.
- */
-declare function serverRowsOf(seed: RecordsSeed | null | undefined): {
-    on: boolean;
-    capMs: number | null;
-} | null;
-declare function askTablePageSeed(input: {
+}) => Promise<_ai_matrx_records_first_page.FirstGridPageArgs | null>;
+declare const askTablePageSeed: (input: Omit<{
     dataSource: unknown;
-    organizationId: Uuid;
-    tableId: Uuid;
-    actor: RecordsConfig["actor"];
-    /** A record page: its record's bundle (`custom.record_page_bundle`) is asked beside the table's. */
-    recordId?: Uuid | null;
-    /**
-     * Ask the grid's first page (default true). Off when the address opens something else. A function
-     * decides once the table's shape (its bundle) has been answered — it is handed everything asked so
-     * far, so a host can read the person's `server_rows` knob from the bundle (`serverRowsOf`) and ask
-     * the rows only when it is on, at no extra read.
-     */
-    rows?: boolean | ((asked: RecordsSeed) => boolean);
-    /** The table is drawn EMBEDDED (`TablePage presentation="embedded"`, a Space's inline table): its page size. */
+    organizationId: _ai_matrx_records.Uuid;
+    tableId: _ai_matrx_records.Uuid;
+    actor: _ai_matrx_records.RecordsConfig["actor"];
+    recordId?: _ai_matrx_records.Uuid | null;
+    rows?: boolean | ((asked: _ai_matrx_records_core.RecordsSeed) => boolean);
     embedded?: boolean;
     pageSize?: number;
-    /**
-     * The host draws the merged grid. A view grouped by one field (no sub-levels, pivot or drill trail) is then
-     * seeded too: the page in group order, the group counts, the summary bar, and the words of the links on the
-     * page — each asked with the arguments the grid sends, so the browser's own call finds its answer.
-     */
     merged?: boolean;
-    /**
-     * THE VIEW THE HOST HANDS THE GRID (a Space's own spec: sorts, filters, `where`, grouping), for a table with
-     * no saved view behind it. The first page is built from it exactly as the grid reads it; the table's saved
-     * views and looks are not asked.
-     */
-    view?: SavedViewSpec | undefined;
-}): Promise<RecordsSeed>;
+    view?: _ai_matrx_records_views.SavedViewSpec<GridPresentation> | undefined;
+    codec?: _ai_matrx_records_views.ViewPresentationCodec<GridPresentation>;
+}, "codec">) => Promise<_ai_matrx_records_core.RecordsSeed>;
 
-export { EMBEDDED_PAGE_SIZE, type FirstGridPageArgs, TABLE_PAGE_SIZE, type TileSpec, askChartSeed, askEntityBlockSeed, askTablePageSeed, askTileSeed, firstGridPageArgs, firstGridPageRequest, mergeSeeds, serverRowsOf, viewFilterOf };
+export { askTablePageSeed, firstGridPageRequest };