@pilotiq/pilotiq 0.1.0

package/dist/elements/Table.d.ts

@@ -0,0 +1,535 @@
+import { Element, type ElementMeta } from '../schema/Element.js';
+import { Column } from '../Column.js';
+import { Action } from '../actions/Action.js';
+import { ActionGroup } from '../actions/ActionGroup.js';
+import { Filter } from '../filters/Filter.js';
+import type { SummaryResult } from '../summarizers/Summarizer.js';
+import { TableGroup, type TableGroupMeta } from './TableGroup.js';
+/** Either a plain `Action` or an `ActionGroup` (a labelled dropdown of
+ * actions). Both can sit in any of the table action slots — the slot
+ * stamps the placement automatically on whichever shape arrives. */
+type ActionOrGroup = Action | ActionGroup;
+export type SortDirection = 'asc' | 'desc';
+export interface TableContext<R = unknown> {
+    request?: unknown;
+    search?: string;
+    sort?: {
+        column: string;
+        direction: SortDirection;
+    };
+    page?: number;
+    perPage?: number;
+    records?: R[];
+    /** Active filter values keyed by filter name (e.g. `{ status: 'published' }`).
+     * Empty / unsupplied filters are absent. */
+    filters?: Record<string, string>;
+    /** Active list-page tab name (e.g. `'drafts'`). Set by
+     * `pageData.resourceIndexData` from `?tab=` before records run. User-
+     * supplied `Table.records(fn)` handlers can branch on this for custom
+     * narrowing; the model adapter consults `tabQuery` instead. */
+    tab?: string;
+    /** Active list-page tab's `modifyQuery` chain — applied alongside
+     * filter `where` clauses in `modelTableRecords`. Set by the framework;
+     * users configure it via `ListTab.modifyQuery(fn)`. */
+    tabQuery?: (q: import('../orm/modelDefaults.js').ModelQuery) => import('../orm/modelDefaults.js').ModelQuery;
+    /** Whatever `Pilotiq.user(req => …)` returned for the current request.
+     * Forwarded into `Resource.query(ctx)` by `modelTableRecords` so user-
+     * installed scopes (tenant filters, etc.) see the same opaque user
+     * shape that authorization predicates do. Absent on the dispatcher's
+     * input ctx when no user resolver is configured. */
+    user?: unknown;
+    [key: string]: unknown;
+}
+export type TableQueryHandler<Q = unknown> = (query: Q, ctx: TableContext) => Q | Promise<Q>;
+/**
+ * User-supplied row loader. Returns the records to render plus an optional
+ * `total` for pagination. When `total` is omitted the framework treats
+ * `rows.length` as the total.
+ */
+export interface TableRecordsResult<R = unknown> {
+    rows: R[];
+    total?: number;
+}
+export type TableRecordsHandler<R = unknown> = (ctx: TableContext<R>) => TableRecordsResult<R> | R[] | Promise<TableRecordsResult<R> | R[]>;
+export interface TableEmptyState {
+    heading?: string;
+    description?: string;
+    icon?: string;
+}
+/**
+ * Per-row URL function. Returns the destination URL for clicks on a
+ * row's data cells — each data column wraps its content in a real
+ * `<a href>` (Filament-style), so right-click / cmd-click / middle-click
+ * "open in new tab" all work natively. Plain left-clicks are intercepted
+ * for SPA navigation. Return `undefined` for rows that shouldn't be
+ * clickable. Action and bulk-select cells are never wrapped.
+ *
+ * Per-column overrides: `Column.recordUrl(fn)` swaps in a different URL
+ * for that column's cell, and `Column.recordUrl(false)` opts a column
+ * out entirely.
+ */
+export type RecordUrlHandler<R = unknown> = (record: R) => string | undefined;
+/**
+ * Per-row CSS class function. Returns extra Tailwind / CSS class names
+ * appended to that row's `<tr>`. Useful for status-driven row tinting
+ * ("destructive" when overdue, "warning" when stale). Result is appended
+ * after the framework's own row classes (striped, cursor-pointer); user
+ * classes win on equal specificity. Throwing or returning falsy stays
+ * silent — the row just renders without extras.
+ */
+export type RecordClassesHandler<R = unknown> = (record: R) => string | undefined;
+/**
+ * Per-row card content function. Receives the record + the current
+ * `TableContext` and returns an `Element[]` rendered inside a card in
+ * `contentLayout('cards')` mode. Resolved via `resolveSchema` per-row in
+ * `loadTableRecords`; the result is stamped onto `row._cardChildren`.
+ *
+ * Typical content: `Image`, `Heading`, `Text`, `Icon`, `Badge`-style
+ * `Entry` primitives, plus layout primitives like `Group / Split / Grid`.
+ * Display-only — `Form` / `Field` / `Filter` / `Action` inside the card
+ * schema is unsupported in v1.
+ */
+export type CardSchemaHandler<R = unknown> = (record: R, ctx: TableContext<R>) => Element[] | Promise<Element[]>;
+/**
+ * Responsive grid column counts for `contentLayout('cards')`. Each
+ * breakpoint maps to its Tailwind container query (`@sm` = ≥40rem etc.);
+ * `default` is the base (no media query). Unspecified breakpoints inherit
+ * the next-smaller. v1 caps each value at 12 to match the grid's column
+ * limits — values outside `[1, 12]` clamp.
+ */
+export interface CardsPerRow {
+    default?: number;
+    sm?: number;
+    md?: number;
+    lg?: number;
+    xl?: number;
+    '2xl'?: number;
+}
+/**
+ * Table content-layout mode. `'table'` (default) renders the classic
+ * `<thead>` + `<tbody>` HTML table. `'cards'` hides the header row and
+ * renders each row as a card in a CSS grid. Columns still drive search /
+ * sort / filter / group / summarize semantics in cards mode; only the
+ * row-level rendering differs.
+ */
+export type ContentLayout = 'table' | 'cards';
+/**
+ * Where filters render relative to the table.
+ * - `'modal'` (default) — chrome-only popover above the table, opened by
+ *   the toolbar Filters button.
+ * - `'above-content'` — inline strip rendered between the header bar and
+ *   the table; every filter widget is always visible.
+ * - `'above-content-collapsible'` — same strip, hidden behind the toolbar
+ *   Filters button. Open / closed state persists per table path.
+ * - `'below-content'` — inline strip rendered after the table (under the
+ *   pagination row).
+ *
+ * Filament v5's sidebar positions (`BeforeContent` / `AfterContent`)
+ * reshape the page rather than the table chrome and are deferred until a
+ * consumer asks.
+ */
+export type FiltersLayout = 'modal' | 'above-content' | 'above-content-collapsible' | 'below-content';
+export interface TableMeta extends ElementMeta {
+    type: 'table';
+    defaultSort?: {
+        column: string;
+        direction: SortDirection;
+    };
+    perPage?: number;
+    searchable: boolean;
+    heading?: string;
+    description?: string;
+    striped?: boolean;
+    emptyState?: TableEmptyState;
+    /**
+     * Distinct empty-state for the "filter/search active but no rows match"
+     * case. When set AND a search query or one or more URL filter keys are
+     * present, the renderer picks this shape over `emptyState`. When unset,
+     * the renderer falls back to `emptyState` (or the framework defaults
+     * — "No matching records" with a generic clear-filters hint).
+     */
+    filteredEmptyState?: TableEmptyState;
+    /**
+     * Per-row URL stamped onto each row's data under the reserved
+     * `_recordUrl` key (alongside the existing `_visibleActions` /
+     * `_disabledActions` / `_formatted` keys). The renderer reads from
+     * the row, not the table meta — `RecordUrlHandler` is server-side only.
+     */
+    recordUrl?: true;
+    /**
+     * Server-side per-row CSS marker — same convention as `recordUrl`.
+     * Each row's `_recordClasses` carries the resolved string; this flag
+     * is just a hint for the renderer to look for it.
+     */
+    recordClasses?: true;
+    /**
+     * Auto-refresh interval in seconds. The client renderer kicks off a
+     * `setInterval` that re-fetches the current URL via the SPA navigator
+     * — pagination / sort / filter state is preserved because we re-visit
+     * the same `pathname + search`. Hidden tabs pause to avoid hammering
+     * the server in the background; resume on visibility change. Unset =
+     * no polling.
+     */
+    pollInterval?: number;
+    /** The currently active group — the column rows are banded by. Set
+     * each request from either `?group=` or `defaultGroup(...)`. The
+     * renderer emits a heading row whenever `_groupValue` changes between
+     * adjacent rows. Always a column name; the rich metadata (label /
+     * collapsibility / etc.) lives on `groups` below. */
+    defaultGroup?: string;
+    /** Group selector options. When 2+ groups are registered the renderer
+     * mounts a "Group by" dropdown above the table; the user's selection
+     * round-trips via `?group=`. Empty / absent means the bare-column form
+     * (`Table.defaultGroup('col')` only). */
+    groups?: TableGroupMeta[];
+    /** Per-column summary results — keyed by column name, each entry is the
+     * computed `SummaryResult[]` for that column's `summarize([…])`. Filled
+     * in by `loadTableRecords` after `records()` runs. Renderer emits a
+     * `<tfoot>` row when this is present. */
+    summaries?: Record<string, SummaryResult[]>;
+    /** Per-group summaries — outer key = `_groupValue`, inner = column
+     * name, value = `SummaryResult[]`. Computed only when an active group
+     * is set AND at least one column has summarizers. Renderer emits an
+     * inline summary row at the END of each group band, aligned to the
+     * same columns as the global footer. */
+    groupSummaries?: Record<string, Record<string, SummaryResult[]>>;
+    /** Drag-to-reorder is enabled on this table. The renderer adds a grip
+     * handle column and binds HTML5 DnD on each `<tr>`. The actual sort
+     * column the order is written back to lives on `reorderableColumn`. */
+    reorderable?: true;
+    /** Name of the column the persisted order is written to. Defaults to
+     * `'sort'` when `Table.reorderable()` is called without an argument.
+     * Pilotiq's default `Table.records()` adapter uses this as the default
+     * sort column when the URL doesn't override `?sort=…`. */
+    reorderableColumn?: string;
+    /** Stamped server-side at render time. The renderer POSTs the new id
+     * order here when a row is dropped. Absent when the route handler
+     * hasn't tagged the table (panel boot will throw before that point if
+     * `reorderable()` is set without a corresponding `model.reorder`). */
+    reorderUrl?: string;
+    /** Tier-3 — set when `Resource.deferLoading = true`. The SSR pass
+     * skips `Table.records()` so the client paints a skeleton on first
+     * frame and fetches rows from `tableUrl` after mount. URL chrome
+     * (current sort / search / page / group) still mirrors so the
+     * skeleton frame doesn't reset user-visible state. */
+    deferred?: true;
+    /** Stamped server-side at render time alongside `deferred`. The
+     * renderer GETs this URL with the page's current query string to
+     * fetch rows after mount. Empty when `deferLoading` is off. */
+    tableUrl?: string;
+    /** Tier-3 — when set, the table's URL state (search / sort / page /
+     * perPage / group / filter values) is namespaced under the identifier
+     * so multiple tables on one page don't fight over `?search=` etc.
+     * `?orders_search=foo&invoices_sort=date:desc`. Off by default — bare
+     * keys are still used when no identifier is set. Custom-page-only:
+     * resource list pages have one table by default and don't need it. */
+    queryStringIdentifier?: string;
+    /** Content-layout mode. Absent = `'table'` (classic HTML table); when
+     * `'cards'` the renderer hides the column header row and arranges rows
+     * as cards in a CSS grid. Per-row card content is stamped on each row
+     * under `_cardChildren: ElementMeta[]` by `loadTableRecords`. Columns
+     * still drive search / sort / filter / group / summarize semantics. */
+    contentLayout?: 'cards';
+    /** Responsive card column counts for `contentLayout: 'cards'`. Renderer
+     * maps each breakpoint to a `@container`-scoped Tailwind grid class. */
+    cardsPerRow?: CardsPerRow;
+    /** Filter layout position. Absent = `'modal'` (current popover behavior).
+     * The renderer swaps the toolbar Filters button for an inline strip in
+     * the matching slot when set. See `FiltersLayout` for the full enum. */
+    filtersLayout?: Exclude<FiltersLayout, 'modal'>;
+    rows?: unknown[];
+    total?: number;
+    currentSort?: {
+        column: string;
+        direction: SortDirection;
+    };
+    search?: string;
+    currentPage?: number;
+    /** Absolute pathname the table lives at (e.g. `/admin/articles`). The
+     * renderer prefixes sort/pagination/search hrefs with this so SPA
+     * navigation resolves against the right route — Vike's client-side
+     * router doesn't follow `?qs`-only relative links. */
+    currentPath?: string;
+}
+/**
+ * Table container. Children are typically `Column[]` plus header / row /
+ * bulk Actions. The query hook stays server-side; toMeta emits the
+ * configured sort/pagination state, the searchable flag, and (after the
+ * framework runs `records()`) the resolved rows + pagination state.
+ */
+export declare class Table<R = unknown, Q = unknown> extends Element {
+    private _query?;
+    private _records?;
+    private _defaultSort?;
+    private _perPage?;
+    private _heading?;
+    private _description?;
+    private _striped;
+    private _emptyState?;
+    private _filteredEmptyState?;
+    private _rows?;
+    private _total?;
+    private _currentSort?;
+    private _currentSearch?;
+    private _currentPage?;
+    private _currentPath?;
+    private _recordUrl?;
+    private _recordClasses?;
+    private _pollInterval?;
+    private _defaultGroup?;
+    private _groups;
+    private _activeGroup?;
+    private _summaries?;
+    private _groupSummaries?;
+    private _reorderableColumn?;
+    private _reorderUrl?;
+    private _deferred;
+    private _tableUrl?;
+    private _queryStringIdentifier?;
+    private _contentLayout;
+    private _cardSchema?;
+    private _cardsPerRow?;
+    private _filtersLayout;
+    private constructor();
+    static make<R = unknown, Q = unknown>(): Table<R, Q>;
+    /** Set children directly — typically a mix of Columns and Actions. */
+    schema(elements: Element[]): this;
+    /** Shorthand: replace the column children. Existing actions are preserved. */
+    columns(cols: Column[]): this;
+    /** Shorthand: append actions to the children. Placement on each action /
+     * group is preserved as-is; use the slot variants below
+     * (`recordActions`, `headerActions`, `bulkActions`) when you want the
+     * table to assign placement automatically. Both `Action` and
+     * `ActionGroup` are accepted — groups render as dropdown triggers. */
+    actions(acts: ActionOrGroup[]): this;
+    /** Per-row actions slot — rendered in a DropdownMenu on each row.
+     * Stamps `placement: 'row'` on each action so callers don't need
+     * `Action.make(...).row()` boilerplate. */
+    recordActions(acts: ActionOrGroup[]): this;
+    /** Header actions slot — rendered top-right of the table. */
+    headerActions(acts: ActionOrGroup[]): this;
+    /** Bulk actions slot — shown in a toolbar when rows are selected. */
+    bulkActions(acts: ActionOrGroup[]): this;
+    /** Shorthand: replace the filter children. Existing columns/actions stay. */
+    filters(filters: Filter[]): this;
+    /** Adapter-flavored query builder hook. Reserved for ORM adapters in Phase 3+. */
+    query(fn: TableQueryHandler<Q>): this;
+    /** Row loader — receives a `TableContext` and returns rows (and optional total). */
+    records(fn: TableRecordsHandler<R>): this;
+    defaultSort(column: string, direction?: SortDirection): this;
+    paginate(perPage: number): this;
+    /** Title rendered above the table (left of the header bar). */
+    heading(s: string): this;
+    /** Subtitle rendered under the heading. */
+    description(s: string): this;
+    /** Alternating row backgrounds for visual scanning. */
+    striped(v?: boolean): this;
+    /** Customize the "no records" placeholder. */
+    emptyState(state: TableEmptyState): this;
+    /**
+     * Customize the "no matching records" placeholder shown when a search
+     * query or filter is active but the result set is empty. Distinct from
+     * `emptyState(...)` so the two cases can read differently — empty
+     * tables typically want a "create your first one" call to action,
+     * while filtered-empty tables want a "clear filters / adjust search"
+     * hint.
+     *
+     * Falls back to `emptyState(...)` (or the framework defaults) when
+     * unset, so opting into the distinction is purely additive.
+     */
+    filteredEmptyState(state: TableEmptyState): this;
+    /**
+     * Set a per-row URL — each data cell renders as a real `<a href>` so
+     * "open in new tab" works natively (right-click / cmd-click / middle-
+     * click). Plain left-clicks SPA-navigate via `useNavigate()`. Action
+     * and bulk-select cells stay unwrapped, so clicking a row action only
+     * fires the action — there's no overlapping row-level click handler.
+     *
+     * The URL is stamped onto each row under the reserved `_recordUrl`
+     * key during `loadTableRecords` — same convention as
+     * `_visibleActions` / `_formatted`.
+     *
+     * Per-column overrides: pair with `Column.recordUrl(fn)` to swap a
+     * column-specific URL, or `Column.recordUrl(false)` to opt a column
+     * out (e.g. a column whose cell content has its own click affordance).
+     */
+    recordUrl(fn: RecordUrlHandler<R>): this;
+    /**
+     * Per-row CSS class hook. The handler runs server-side once per row,
+     * after `records()` resolves; the result is stamped under the reserved
+     * `_recordClasses` key on the row and appended to the rendered `<tr>`'s
+     * className. Pair with semantic Tailwind tokens (`bg-destructive/10`,
+     * `text-warning`) so theming stays consistent.
+     */
+    recordClasses(fn: RecordClassesHandler<R>): this;
+    /**
+     * Auto-refresh the table at a regular interval. `seconds` is positive;
+     * non-positive values silently disable polling. SPA-friendly — the
+     * client navigates to `pathname + search` (the current URL) so sort /
+     * filter / pagination state survive the refresh, and AppShell stays
+     * mounted. Polling pauses while the document is hidden.
+     */
+    poll(seconds: number): this;
+    /**
+     * Band rows by a column's value. Stable-sorts the rendered rows so
+     * shared values cluster together, then stamps each row's `_groupValue`
+     * — the renderer inserts a heading row whenever the value changes.
+     *
+     * Accepts either a bare column name or a `TableGroup` instance. When
+     * passed a `TableGroup` it's auto-added to `groups([…])` if it isn't
+     * registered already, so `defaultGroup(TableGroup.make('status').label('Status'))`
+     * doesn't require repeating the registration.
+     */
+    defaultGroup(group: string | TableGroup<any>): this;
+    /**
+     * Register the available group options. The renderer mounts a "Group
+     * by" dropdown above the table when 2+ groups are registered (or 1
+     * group with rich metadata — label / collapsible / record-derived
+     * title). The active selection round-trips through the URL via the
+     * reserved `?group=` key.
+     */
+    groups(items: TableGroup<any>[]): this;
+    /**
+     * Enable drag-to-reorder. `column` names the model attribute the new
+     * order is written back to (defaults to `'sort'`, matching Filament).
+     * The route registers `POST {base}/{slug}/_reorder` — the renderer
+     * POSTs `{ ids }` there on every drop. Boot panics when this is set
+     * but `Resource.model.reorder` is missing.
+     *
+     * The reorder column also doubles as the default sort: when no
+     * `defaultSort()` is configured and reorder is on, rows render
+     * `(reorderColumn, asc)` so the visible order matches the persisted
+     * order. URL `?sort=…` still wins.
+     */
+    reorderable(column?: string): this;
+    /** Attach loaded rows + total. Called by the framework after `records()` runs. */
+    withRows(rows: R[], total?: number): this;
+    withSort(column: string, direction: SortDirection): this;
+    withSearch(query: string): this;
+    withPage(page: number): this;
+    withCurrentPath(path: string): this;
+    withSummaries(summaries: Record<string, SummaryResult[]>): this;
+    /** Stamp per-group summary results. Outer key = `_groupValue`,
+     * inner = column name. Set by `loadTableRecords` only when an active
+     * group is set AND at least one column has summarizers. */
+    withGroupSummaries(groupSummaries: Record<string, Record<string, SummaryResult[]>>): this;
+    /** Stamp the reorder POST URL. Called by `tagTableReorderUrls` during
+     * `resourceIndexData` so the renderer knows where to send drops. */
+    withReorderUrl(url: string): this;
+    /** Mark this table as deferred — the SSR pass skips `records()` and
+     * the client fetches rows from `tableUrl` after mount. Set by
+     * `resourceIndexData` when `Resource.deferLoading = true`; user code
+     * doesn't typically call this directly. */
+    withDeferred(v?: boolean): this;
+    /** Stamp the deferred-load fetch URL. Set alongside `withDeferred`
+     * by `tagTableUrls` during `resourceIndexData`. */
+    withTableUrl(url: string): this;
+    /**
+     * Namespace this table's URL state under an identifier so multiple
+     * tables on the same page don't collide on `?search=` / `?sort=` /
+     * `?page=` / filter keys. With `queryStringIdentifier('orders')`, every
+     * key is read and written as `orders_<key>` (e.g. `?orders_search=foo`,
+     * `?orders_sort=date:desc`, `?orders_status=open`). Off by default —
+     * resource list pages have one Table and don't need a prefix.
+     *
+     * The empty string is rejected (would silently disable namespacing
+     * while implying it's on); identifiers must match `[A-Za-z0-9_-]+`
+     * so they don't smuggle reserved characters into URL keys.
+     */
+    queryStringIdentifier(id: string): this;
+    /**
+     * Pick the content layout for this table. `'table'` (default) renders
+     * the classic `<thead>` + `<tbody>` HTML table. `'cards'` hides the
+     * column header row and renders each row as a card in a CSS grid; the
+     * per-row content comes from `cardSchema(...)`.
+     *
+     * Columns still drive search / sort / filter / group / summarize
+     * semantics in cards mode — they're just not painted as table headers.
+     * The top-bar gains a "Sort by" dropdown built from `Column.sortable()`
+     * columns since column headers (the usual sort affordance) are hidden.
+     */
+    contentLayout(layout: ContentLayout): this;
+    /** Sugar for `contentLayout('cards')`. */
+    cards(): this;
+    /**
+     * Per-row card content. Returns an `Element[]` rendered inside a card
+     * for the given record + ctx. Resolved server-side per row in
+     * `loadTableRecords` and stamped on `row._cardChildren`. Required when
+     * `contentLayout === 'cards'`; `toMeta()` throws otherwise.
+     *
+     * Display-only — `Form / Field / Filter / Action` inside the card
+     * schema is unsupported in v1. Reuse `Heading`, `Text`, `Image`, `Icon`,
+     * `Group / Split / Grid`, and the read-only `Entry` family
+     * (`TextEntry / BadgeEntry / IconEntry / ImageEntry / KeyValueEntry /
+     * ColorEntry / ComponentEntry`) for content.
+     */
+    cardSchema(fn: CardSchemaHandler<R>): this;
+    /**
+     * Responsive grid column counts in cards mode. Each entry maps to a
+     * Tailwind container query (`@sm` = ≥40rem, etc.). Unspecified
+     * breakpoints inherit the next-smaller; `default` is the base.
+     * Values clamp to `[1, 12]`. Default `{ default: 1, sm: 2, lg: 3 }`.
+     */
+    cardsPerRow(opts: CardsPerRow): this;
+    /**
+     * Where filters render relative to the table. Default `'modal'` keeps
+     * the toolbar Filters button + popover. The three inline modes
+     * (`'above-content'` / `'above-content-collapsible'` / `'below-content'`)
+     * lay every filter widget out as a horizontal strip in place of the
+     * popover.
+     */
+    filtersLayout(layout: FiltersLayout): this;
+    /** Render-time setter — the column rows are actually banded by for
+     * this request, after `?group=` and `defaultGroup(...)` are reconciled.
+     * Set by `loadTableRecords`. Empty string explicitly clears (URL
+     * `?group=` overrode `defaultGroup`). */
+    withActiveGroup(column: string | undefined): this;
+    getQuery(): TableQueryHandler<Q> | undefined;
+    getRecords(): TableRecordsHandler<R> | undefined;
+    getDefaultSort(): {
+        column: string;
+        direction: SortDirection;
+    } | undefined;
+    getPerPage(): number | undefined;
+    getRows(): R[] | undefined;
+    getTotal(): number | undefined;
+    getCurrentSort(): {
+        column: string;
+        direction: SortDirection;
+    } | undefined;
+    getCurrentSearch(): string | undefined;
+    getCurrentPage(): number | undefined;
+    getCurrentPath(): string | undefined;
+    getRecordUrl(): RecordUrlHandler<R> | undefined;
+    getRecordClasses(): RecordClassesHandler<R> | undefined;
+    getPollInterval(): number | undefined;
+    getDefaultGroup(): string | undefined;
+    getGroups(): TableGroup<any>[];
+    getActiveGroup(): string | undefined;
+    /** Resolve the active column to a `TableGroup` instance. Returns the
+     * matching registered group, or — when the active column is set but
+     * not registered (bare-column form) — synthesizes a no-metadata group
+     * so the dispatcher has a uniform shape to work with. */
+    getActiveGroupInstance(): TableGroup<any> | undefined;
+    getSummaries(): Record<string, SummaryResult[]> | undefined;
+    getGroupSummaries(): Record<string, Record<string, SummaryResult[]>> | undefined;
+    getReorderableColumn(): string | undefined;
+    isReorderable(): boolean;
+    getReorderUrl(): string | undefined;
+    isDeferred(): boolean;
+    getTableUrl(): string | undefined;
+    getQueryStringIdentifier(): string | undefined;
+    getContentLayout(): ContentLayout;
+    isCardsLayout(): boolean;
+    getCardSchema(): CardSchemaHandler<R> | undefined;
+    getCardsPerRow(): CardsPerRow | undefined;
+    getFiltersLayout(): FiltersLayout;
+    /** Convenience: the `Column` children only. */
+    getColumns(): Column[];
+    /** Convenience: the `Filter` children only. */
+    getFilters(): Filter[];
+    getType(): string;
+    toMeta(): TableMeta;
+}
+export {};
+//# sourceMappingURL=Table.d.ts.map

package/dist/elements/Table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Table.d.ts","sourceRoot":"","sources":["../../src/elements/Table.ts"],"names":[],"mappings":"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"}