@pilotiq/pilotiq 0.1.0

package/dist/elements/Table.js

@@ -0,0 +1,481 @@
+import { Element } from '../schema/Element.js';
+import { Column } from '../Column.js';
+import { Filter } from '../filters/Filter.js';
+import { TableGroup } from './TableGroup.js';
+/**
+ * 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 class Table extends Element {
+    _query;
+    _records;
+    _defaultSort;
+    _perPage;
+    // Top-bar chrome
+    _heading;
+    _description;
+    _striped = false;
+    _emptyState;
+    _filteredEmptyState;
+    // Render-time state
+    _rows;
+    _total;
+    _currentSort;
+    _currentSearch;
+    _currentPage;
+    _currentPath;
+    _recordUrl;
+    _recordClasses;
+    _pollInterval;
+    _defaultGroup;
+    // Variance-relaxed — Filament-style covariant `TableGroup<R>[]` ergonomics
+    // matter more than tight invariance against the table's `R` parameter.
+    _groups = []; // eslint-disable-line @typescript-eslint/no-explicit-any
+    _activeGroup;
+    _summaries;
+    _groupSummaries;
+    _reorderableColumn;
+    _reorderUrl;
+    _deferred = false;
+    _tableUrl;
+    _queryStringIdentifier;
+    _contentLayout = 'table';
+    _cardSchema;
+    _cardsPerRow;
+    _filtersLayout = 'modal';
+    constructor() { super(); }
+    static make() {
+        return new Table();
+    }
+    // ─── Children ─────────────────────────────────────────
+    /** Set children directly — typically a mix of Columns and Actions. */
+    schema(elements) {
+        this._children = elements;
+        return this;
+    }
+    /** Shorthand: replace the column children. Existing actions are preserved. */
+    columns(cols) {
+        const existing = this._children ?? [];
+        const nonColumns = existing.filter(el => !(el instanceof Column));
+        this._children = [...cols, ...nonColumns];
+        return 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) {
+        const existing = this._children ?? [];
+        this._children = [...existing, ...acts];
+        return 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) {
+        return this.actions(acts.map(a => a.placement('row')));
+    }
+    /** Header actions slot — rendered top-right of the table. */
+    headerActions(acts) {
+        return this.actions(acts.map(a => a.placement('header')));
+    }
+    /** Bulk actions slot — shown in a toolbar when rows are selected. */
+    bulkActions(acts) {
+        return this.actions(acts.map(a => a.placement('bulk')));
+    }
+    /** Shorthand: replace the filter children. Existing columns/actions stay. */
+    filters(filters) {
+        const existing = this._children ?? [];
+        const nonFilters = existing.filter(el => !(el instanceof Filter));
+        this._children = [...nonFilters, ...filters];
+        return this;
+    }
+    // ─── Lifecycle config ────────────────────────────────
+    /** Adapter-flavored query builder hook. Reserved for ORM adapters in Phase 3+. */
+    query(fn) { this._query = fn; return this; }
+    /** Row loader — receives a `TableContext` and returns rows (and optional total). */
+    records(fn) { this._records = fn; return this; }
+    defaultSort(column, direction = 'asc') {
+        this._defaultSort = { column, direction };
+        return this;
+    }
+    paginate(perPage) { this._perPage = perPage; return this; }
+    // ─── Top-bar chrome ───────────────────────────────────
+    /** Title rendered above the table (left of the header bar). */
+    heading(s) { this._heading = s; return this; }
+    /** Subtitle rendered under the heading. */
+    description(s) { this._description = s; return this; }
+    /** Alternating row backgrounds for visual scanning. */
+    striped(v = true) { this._striped = v; return this; }
+    /** Customize the "no records" placeholder. */
+    emptyState(state) {
+        this._emptyState = state;
+        return 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) {
+        this._filteredEmptyState = state;
+        return 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) {
+        this._recordUrl = fn;
+        return 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) {
+        this._recordClasses = fn;
+        return 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) {
+        if (seconds > 0)
+            this._pollInterval = seconds;
+        return 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.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    defaultGroup(group) {
+        if (typeof group === 'string') {
+            this._defaultGroup = group;
+        }
+        else {
+            this._defaultGroup = group.getColumn();
+            const already = this._groups.some(g => g.getColumn() === group.getColumn());
+            if (!already)
+                this._groups.push(group);
+        }
+        return 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.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    groups(items) {
+        this._groups = items;
+        return 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 = 'sort') {
+        this._reorderableColumn = column;
+        return this;
+    }
+    // ─── Render-time state ────────────────────────────────
+    /** Attach loaded rows + total. Called by the framework after `records()` runs. */
+    withRows(rows, total) {
+        this._rows = rows;
+        if (total !== undefined)
+            this._total = total;
+        return this;
+    }
+    withSort(column, direction) {
+        this._currentSort = { column, direction };
+        return this;
+    }
+    withSearch(query) { this._currentSearch = query; return this; }
+    withPage(page) { this._currentPage = page; return this; }
+    withCurrentPath(path) { this._currentPath = path; return this; }
+    withSummaries(summaries) {
+        this._summaries = summaries;
+        return 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) {
+        this._groupSummaries = groupSummaries;
+        return this;
+    }
+    /** Stamp the reorder POST URL. Called by `tagTableReorderUrls` during
+     * `resourceIndexData` so the renderer knows where to send drops. */
+    withReorderUrl(url) {
+        this._reorderUrl = url;
+        return 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 = true) {
+        this._deferred = v;
+        return this;
+    }
+    /** Stamp the deferred-load fetch URL. Set alongside `withDeferred`
+     * by `tagTableUrls` during `resourceIndexData`. */
+    withTableUrl(url) {
+        this._tableUrl = url;
+        return 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) {
+        if (!/^[A-Za-z0-9_-]+$/.test(id)) {
+            throw new Error(`Table.queryStringIdentifier: invalid id ${JSON.stringify(id)} — must match /^[A-Za-z0-9_-]+$/`);
+        }
+        this._queryStringIdentifier = id;
+        return 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) {
+        this._contentLayout = layout;
+        return this;
+    }
+    /** Sugar for `contentLayout('cards')`. */
+    cards() { return this.contentLayout('cards'); }
+    /**
+     * 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) {
+        this._cardSchema = fn;
+        return 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) {
+        this._cardsPerRow = opts;
+        return 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) {
+        this._filtersLayout = layout;
+        return 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) {
+        if (column === undefined)
+            delete this._activeGroup;
+        else
+            this._activeGroup = column;
+        return this;
+    }
+    // ─── Getters ──────────────────────────────────────────
+    getQuery() { return this._query; }
+    getRecords() { return this._records; }
+    getDefaultSort() { return this._defaultSort; }
+    getPerPage() { return this._perPage; }
+    getRows() { return this._rows; }
+    getTotal() { return this._total; }
+    getCurrentSort() { return this._currentSort; }
+    getCurrentSearch() { return this._currentSearch; }
+    getCurrentPage() { return this._currentPage; }
+    getCurrentPath() { return this._currentPath; }
+    getRecordUrl() { return this._recordUrl; }
+    getRecordClasses() { return this._recordClasses; }
+    getPollInterval() { return this._pollInterval; }
+    getDefaultGroup() { return this._defaultGroup; }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getGroups() { return this._groups; }
+    getActiveGroup() { return this._activeGroup; }
+    /** 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. */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getActiveGroupInstance() {
+        const col = this._activeGroup;
+        if (!col)
+            return undefined;
+        const found = this._groups.find(g => g.getColumn() === col);
+        return found ?? TableGroup.make(col);
+    }
+    getSummaries() { return this._summaries; }
+    getGroupSummaries() { return this._groupSummaries; }
+    getReorderableColumn() { return this._reorderableColumn; }
+    isReorderable() { return this._reorderableColumn !== undefined; }
+    getReorderUrl() { return this._reorderUrl; }
+    isDeferred() { return this._deferred; }
+    getTableUrl() { return this._tableUrl; }
+    getQueryStringIdentifier() { return this._queryStringIdentifier; }
+    getContentLayout() { return this._contentLayout; }
+    isCardsLayout() { return this._contentLayout === 'cards'; }
+    getCardSchema() { return this._cardSchema; }
+    getCardsPerRow() { return this._cardsPerRow; }
+    getFiltersLayout() { return this._filtersLayout; }
+    /** Convenience: the `Column` children only. */
+    getColumns() {
+        return (this._children ?? []).filter((el) => el instanceof Column);
+    }
+    /** Convenience: the `Filter` children only. */
+    getFilters() {
+        return (this._children ?? []).filter((el) => el instanceof Filter);
+    }
+    // ─── Serialization ────────────────────────────────────
+    getType() { return 'table'; }
+    toMeta() {
+        const searchable = this.getColumns().some(c => c.isSearchable());
+        if (this._contentLayout === 'cards' && this._cardSchema === undefined) {
+            throw new Error('Table.contentLayout("cards") requires .cardSchema((record, ctx) => Element[]). ' +
+                'Cards mode renders each row from a per-row schema; configure one before rendering.');
+        }
+        const cardsPerRow = this._cardsPerRow !== undefined
+            ? clampCardsPerRow(this._cardsPerRow)
+            : undefined;
+        return {
+            type: 'table',
+            searchable,
+            ...(this._defaultSort ? { defaultSort: this._defaultSort } : {}),
+            ...(this._perPage !== undefined ? { perPage: this._perPage } : {}),
+            ...(this._heading !== undefined ? { heading: this._heading } : {}),
+            ...(this._description !== undefined ? { description: this._description } : {}),
+            ...(this._striped ? { striped: true } : {}),
+            ...(this._emptyState !== undefined ? { emptyState: this._emptyState } : {}),
+            ...(this._filteredEmptyState !== undefined ? { filteredEmptyState: this._filteredEmptyState } : {}),
+            ...(this._recordUrl !== undefined ? { recordUrl: true } : {}),
+            ...(this._recordClasses !== undefined ? { recordClasses: true } : {}),
+            ...(this._pollInterval !== undefined ? { pollInterval: this._pollInterval } : {}),
+            // `defaultGroup` on the meta means "the column rows are actually
+            // grouped by for this render". Prefer the render-time activeGroup
+            // (set by `loadTableRecords` after reconciling `?group=` and the
+            // configured default); fall back to the configured default when
+            // no request-side reconciliation has happened (e.g. tests calling
+            // `toMeta()` directly).
+            ...(this._activeGroup !== undefined
+                ? (this._activeGroup === ''
+                    ? {}
+                    : { defaultGroup: this._activeGroup })
+                : (this._defaultGroup !== undefined
+                    ? { defaultGroup: this._defaultGroup }
+                    : {})),
+            ...(this._groups.length > 0
+                ? { groups: this._groups.map(g => g.toMeta()) }
+                : {}),
+            ...(this._summaries !== undefined ? { summaries: this._summaries } : {}),
+            ...(this._groupSummaries !== undefined ? { groupSummaries: this._groupSummaries } : {}),
+            ...(this._reorderableColumn !== undefined ? { reorderable: true, reorderableColumn: this._reorderableColumn } : {}),
+            ...(this._reorderUrl !== undefined ? { reorderUrl: this._reorderUrl } : {}),
+            ...(this._deferred ? { deferred: true } : {}),
+            ...(this._tableUrl !== undefined ? { tableUrl: this._tableUrl } : {}),
+            ...(this._queryStringIdentifier !== undefined
+                ? { queryStringIdentifier: this._queryStringIdentifier } : {}),
+            ...(this._contentLayout === 'cards' ? { contentLayout: 'cards' } : {}),
+            ...(cardsPerRow !== undefined ? { cardsPerRow } : {}),
+            ...(this._filtersLayout !== 'modal' ? { filtersLayout: this._filtersLayout } : {}),
+            ...(this._rows !== undefined ? { rows: this._rows } : {}),
+            ...(this._total !== undefined ? { total: this._total } : {}),
+            ...(this._currentSort !== undefined ? { currentSort: this._currentSort } : {}),
+            ...(this._currentSearch !== undefined ? { search: this._currentSearch } : {}),
+            ...(this._currentPage !== undefined ? { currentPage: this._currentPage } : {}),
+            ...(this._currentPath !== undefined ? { currentPath: this._currentPath } : {}),
+        };
+    }
+}
+const CARDS_PER_ROW_KEYS = ['default', 'sm', 'md', 'lg', 'xl', '2xl'];
+function clampCardsPerRow(opts) {
+    const out = {};
+    for (const key of CARDS_PER_ROW_KEYS) {
+        const v = opts[key];
+        if (v === undefined)
+            continue;
+        const n = Math.floor(Number(v));
+        if (!Number.isFinite(n))
+            continue;
+        out[key] = Math.min(12, Math.max(1, n));
+    }
+    return out;
+}
+//# sourceMappingURL=Table.js.map

package/dist/elements/Table.js.map

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

package/dist/elements/TableGroup.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Table grouping option. Owned by `Table` (not an `Element` — doesn't
+ * sit in the schema tree). Each `TableGroup` defines one column the
+ * table can band rows by, plus optional chrome (label, collapsibility,
+ * record-derived title and description, date bucketing).
+ *
+ * Multiple `TableGroup`s can live on a single table via `Table.groups([…])`
+ * — the renderer mounts a "Group by" dropdown above the table when more
+ * than one is registered. The active selection round-trips through the
+ * URL via the reserved `?group=` key.
+ */
+export type TableGroupTitleHandler<R = unknown> = (record: R) => string | undefined;
+export type TableGroupDescriptionHandler<R = unknown> = (record: R) => string | undefined;
+/**
+ * Comparator on resolved group keys. Receives the same string values that
+ * the dispatcher stamps onto `_groupValue` (so for `date()` groups the keys
+ * are `YYYY-MM-DD`, not raw timestamps). Return < 0 to put `a` first, > 0
+ * to put `b` first, 0 to keep insertion order. The empty-bucket-last rule
+ * is still applied AFTER your comparator — the empty bucket stays at the
+ * bottom regardless of what you return for it.
+ */
+export type TableGroupKeyComparator = (a: string, b: string) => number;
+export interface TableGroupMeta {
+    column: string;
+    label: string;
+    collapsible?: true;
+    collapsed?: true;
+    /** Server-side date bucketing is on (column read as a date, grouped
+     * by day). Renderer doesn't need to do anything special — `_groupValue`
+     * already arrives as `YYYY-MM-DD` and `_groupTitle` carries the
+     * formatted display text. */
+    date?: true;
+}
+export declare class TableGroup<R = unknown> {
+    private _column;
+    private _label?;
+    private _collapsible;
+    private _collapsed;
+    private _titleFn?;
+    private _descriptionFn?;
+    private _date;
+    private _keyComparator?;
+    private constructor();
+    static make<R = unknown>(column: string): TableGroup<R>;
+    /** Display label in the group selector dropdown. Falls back to the
+     * column name when omitted. */
+    label(text: string): this;
+    /** Allow individual groups to be folded. Adds a chevron in the heading row. */
+    collapsible(v?: boolean): this;
+    /** Start collapsed by default. Per-group state is persisted client-
+     * side in localStorage; this just seeds the initial state. */
+    collapsed(v?: boolean): this;
+    /** Custom heading text per row. Receives the full record. Falls back
+     * to the raw column value when omitted. Stamped per row server-side
+     * as `_groupTitle`. */
+    getTitleFromRecordUsing(fn: TableGroupTitleHandler<R>): this;
+    /** Subtitle below the title. Stamped per row as `_groupDescription`. */
+    getDescriptionFromRecordUsing(fn: TableGroupDescriptionHandler<R>): this;
+    /** Sugar for grouping by day — the column is read as a date and
+     * bucketed to `YYYY-MM-DD`. Uses `_groupValue` for the bucket key
+     * (so stable-sort still works) and a default title formatter ("May
+     * 4, 2026"). User-supplied title formatter wins. */
+    date(v?: boolean): this;
+    /**
+     * Override the alphabetic ordering of group buckets with a custom
+     * comparator on resolved group keys. Useful for pinning enums in a
+     * meaningful order (e.g. `'draft' → 'published' → 'archived'`).
+     *
+     * The empty-bucket-last rule still runs AFTER this comparator — rows
+     * with no group value always sort to the bottom regardless of what
+     * the comparator returns for the empty key. Pass an array of keys
+     * for the convenient case via the `orderByKeys` helper below.
+     *
+     * Example:
+     * ```ts
+     * TableGroup.make('status').orderUsing(orderByKeys([
+     *   'draft', 'published', 'archived',
+     * ]))
+     * ```
+     */
+    orderUsing(comparator: TableGroupKeyComparator): this;
+    getColumn(): string;
+    /** Resolved label — `.label(text)` if set, else the column name. */
+    getLabel(): string;
+    isCollapsible(): boolean;
+    isCollapsed(): boolean;
+    getTitleHandler(): TableGroupTitleHandler<R> | undefined;
+    getDescriptionHandler(): TableGroupDescriptionHandler<R> | undefined;
+    isDate(): boolean;
+    getKeyComparator(): TableGroupKeyComparator | undefined;
+    toMeta(): TableGroupMeta;
+}
+/**
+ * Bucket a date-like value to a `YYYY-MM-DD` key. Used by `TableGroup.date()`
+ * to compute the stable-sort key for `_groupValue`. Returns `''` for
+ * unparseable inputs so they cluster under the empty bucket (which the
+ * dispatcher already pushes to the bottom).
+ */
+export declare function bucketDateValue(raw: unknown): string;
+/**
+ * Convenience comparator factory for `TableGroup.orderUsing(...)`. Returns
+ * a comparator that sorts the supplied keys in declaration order, with any
+ * unknown keys falling through to alphabetic ordering AFTER the listed ones.
+ *
+ * Use it to pin enum-like values without writing a manual switch:
+ *
+ * ```ts
+ * TableGroup.make('status').orderUsing(orderByKeys(['draft', 'published']))
+ * ```
+ *
+ * The empty bucket is unaffected — `dispatchTable` always sinks empty groups
+ * to the bottom regardless of what your comparator returns for them.
+ */
+export declare function orderByKeys(keys: ReadonlyArray<string>): TableGroupKeyComparator;
+/**
+ * Default title formatter used when `TableGroup.date()` is on but the
+ * user didn't supply `getTitleFromRecordUsing`. Returns "May 4, 2026"-
+ * style text, or the raw bucket key if the date is unparseable.
+ */
+export declare function formatDateBucketTitle(raw: unknown): string;
+//# sourceMappingURL=TableGroup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TableGroup.d.ts","sourceRoot":"","sources":["../../src/elements/TableGroup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,sBAAsB,CAAC,CAAC,GAAG,OAAO,IAAI,CAChD,MAAM,EAAE,CAAC,KACN,MAAM,GAAG,SAAS,CAAA;AAEvB,MAAM,MAAM,4BAA4B,CAAC,CAAC,GAAG,OAAO,IAAI,CACtD,MAAM,EAAE,CAAC,KACN,MAAM,GAAG,SAAS,CAAA;AAEvB;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;AAEtE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAS,MAAM,CAAA;IACrB,KAAK,EAAU,MAAM,CAAA;IACrB,WAAW,CAAC,EAAG,IAAI,CAAA;IACnB,SAAS,CAAC,EAAK,IAAI,CAAA;IACnB;;;iCAG6B;IAC7B,IAAI,CAAC,EAAU,IAAI,CAAA;CACpB;AAED,qBAAa,UAAU,CAAC,CAAC,GAAG,OAAO;IACjC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,MAAM,CAAC,CAAe;IAC9B,OAAO,CAAC,YAAY,CAAW;IAC/B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAC,CAAiC;IAClD,OAAO,CAAC,cAAc,CAAC,CAAiC;IACxD,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,cAAc,CAAC,CAAyB;IAEhD,OAAO;IAIP,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAIvD;mCAC+B;IAC/B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAEzB,+EAA+E;IAC/E,WAAW,CAAC,CAAC,GAAE,OAAc,GAAG,IAAI;IAEpC;kEAC8D;IAC9D,SAAS,CAAC,CAAC,GAAE,OAAc,GAAG,IAAI;IAElC;;2BAEuB;IACvB,uBAAuB,CAAC,EAAE,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,IAAI;IAK5D,wEAAwE;IACxE,6BAA6B,CAAC,EAAE,EAAE,4BAA4B,CAAC,CAAC,CAAC,GAAG,IAAI;IAKxE;;;wDAGoD;IACpD,IAAI,CAAC,CAAC,GAAE,OAAc,GAAG,IAAI;IAE7B;;;;;;;;;;;;;;;;OAgBG;IACH,UAAU,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI;IAOrD,SAAS,IAAI,MAAM;IACnB,oEAAoE;IACpE,QAAQ,IAAI,MAAM;IAClB,aAAa,IAAI,OAAO;IACxB,WAAW,IAAM,OAAO;IACxB,eAAe,IAAU,sBAAsB,CAAC,CAAC,CAAC,GAAS,SAAS;IACpE,qBAAqB,IAAI,4BAA4B,CAAC,CAAC,CAAC,GAAG,SAAS;IACpE,MAAM,IAAI,OAAO;IACjB,gBAAgB,IAAI,uBAAuB,GAAG,SAAS;IAEvD,MAAM,IAAI,cAAc;CASzB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAUpD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,uBAAuB,CAWhF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAY1D"}