@pilotiq/pilotiq 0.1.0

package/dist/schema/Stat.js

@@ -0,0 +1,116 @@
+/**
+ * Plan #15 Phase B — `Stat` is the fluent value object emitted by
+ * `StatsOverview.getStats(ctx)`. It does NOT extend Element — it has no
+ * place in the schema tree on its own. `StatsOverview.resolveServerData`
+ * collects the array of Stats and ships them as JSON-clean
+ * `StatMeta[]` payloads under `_widgetData[id]`.
+ *
+ *   Stat.make('Users')
+ *     .value(await User.query().count())
+ *     .description('+12% this month')
+ *     .descriptionIcon('trending-up', 'before')
+ *     .icon('users')
+ *     .color('success')
+ *     .chart([12, 4, 8, 15, 22, 18, 30])      // sparkline
+ *     .url('/admin/users').openUrlInNewTab()
+ *
+ * Surface mirrors Filament v5's `Stat` 1:1, modulo TS naming
+ * (`openUrlInNewTab(true)` not `->openUrlInNewTab()`).
+ */
+export class Stat {
+    _label;
+    _value;
+    _description;
+    _descriptionIcon;
+    _icon;
+    _color;
+    _chart;
+    _url;
+    _openInNewTab;
+    _extraAttributes;
+    constructor(_label) {
+        this._label = _label;
+    }
+    /** Factory. The single positional arg is the stat's *label*
+     *  (e.g. 'Users') — the value is set fluently via `.value(...)`. */
+    static make(label) {
+        return new Stat(label);
+    }
+    /** Main number / string. `null` and `undefined` round-trip as `null`
+     *  so the renderer can show a placeholder ("—") for "not yet
+     *  computed" / "not applicable" without an extra sentinel. */
+    value(v) {
+        this._value = v ?? null;
+        return this;
+    }
+    /** Supplementary line below the value (e.g. '+12% this month'). */
+    description(t) {
+        this._description = t;
+        return this;
+    }
+    /** Tiny icon glued to the description. Position defaults to `'after'`
+     *  (matches Filament v5's `IconPosition::After`). */
+    descriptionIcon(name, position = 'after') {
+        this._descriptionIcon = { name, position };
+        return this;
+    }
+    /** Main icon shown in the card chrome. String key into the panel's
+     *  icon registry — same lookup as `Resource.icon`. */
+    icon(name) {
+        this._icon = name;
+        return this;
+    }
+    /** Color tint for the value + icon. */
+    color(c) {
+        this._color = c;
+        return this;
+    }
+    /** Inline-SVG sparkline data. Array of raw numbers — the renderer
+     *  draws a path scaled to the card. No chart-lib dep. */
+    chart(values) {
+        this._chart = [...values];
+        return this;
+    }
+    /** Wrap the card in an `<a href>`. */
+    url(href) {
+        this._url = href;
+        return this;
+    }
+    /** When `.url()` is set, open it in a new tab. */
+    openUrlInNewTab(value = true) {
+        this._openInNewTab = value;
+        return this;
+    }
+    /** Extra HTML attributes spread onto the card root. JSON-clean only —
+     *  values must serialize. */
+    extraAttributes(attrs) {
+        this._extraAttributes = { ...attrs };
+        return this;
+    }
+    /** Serialize to the wire shape. Stats are ferried through
+     *  `_widgetData` so this is a plain JSON object — no children, no
+     *  `type` discriminator (the parent `StatsOverview` carries that). */
+    toMeta() {
+        const out = { label: this._label };
+        if (this._value !== undefined)
+            out.value = this._value;
+        if (this._description !== undefined)
+            out.description = this._description;
+        if (this._descriptionIcon !== undefined)
+            out.descriptionIcon = this._descriptionIcon;
+        if (this._icon !== undefined)
+            out.icon = this._icon;
+        if (this._color !== undefined)
+            out.color = this._color;
+        if (this._chart !== undefined)
+            out.chart = this._chart;
+        if (this._url !== undefined)
+            out.url = this._url;
+        if (this._openInNewTab !== undefined)
+            out.openInNewTab = this._openInNewTab;
+        if (this._extraAttributes !== undefined)
+            out.extraAttributes = this._extraAttributes;
+        return out;
+    }
+}
+//# sourceMappingURL=Stat.js.map

package/dist/schema/Stat.js.map

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

package/dist/schema/StatsOverview.d.ts

@@ -0,0 +1,76 @@
+import { ServerDataElement } from './ServerDataElement.js';
+import type { RenderContext } from './resolveSchema.js';
+import { Stat, type StatMeta } from './Stat.js';
+/**
+ * Plan #15 Phase B — `StatsOverview` is the KPI-card row widget.
+ * Subclasses return an array of `Stat`s from `getStats(ctx)`; the
+ * resolver lays them out as a grid of cards.
+ *
+ * Subclass form (primary):
+ *
+ *   import { StatsOverview, Stat } from '@pilotiq/pilotiq'
+ *
+ *   export class UsersStats extends StatsOverview {
+ *     static override columns = 3
+ *     static override async getStats(ctx) {
+ *       return [
+ *         Stat.make('Users').value(await User.query().count()).color('success'),
+ *         Stat.make('Active sessions').value(await Session.query().active().count()),
+ *         Stat.make('Revenue (MTD)').value('$' + total).icon('dollar-sign'),
+ *       ]
+ *     }
+ *   }
+ *
+ *   // Page.schema()
+ *   UsersStats.make()
+ *
+ * Fluent form (one-off — no subclass):
+ *
+ *   StatsOverview.make('quick-kpis')
+ *     .columns(2)
+ *     .getStatsHandler(async () => [Stat.make('Foo').value(1)])
+ *
+ * Wire-shape:
+ *   meta:       { type: 'stats', columns?, serverData, id, lazy[, poll] }
+ *   _widgetData[id]: { stats: StatMeta[] }
+ *
+ * Lazy default = true (inherited from `ServerDataElement`).
+ */
+export type StatsHandler = (ctx: RenderContext) => Stat[] | Promise<Stat[]>;
+export interface StatsOverviewPayload {
+    stats: StatMeta[];
+}
+export declare class StatsOverview extends ServerDataElement {
+    /** Subclass-time defaults — read by `make()`-built instances unless
+     *  the fluent setter overrides. Mirrors the `View.componentName /
+     *  getData` precedent. */
+    static columns?: number;
+    static getStats?: StatsHandler;
+    private _columns?;
+    private _getStats?;
+    constructor(id?: string);
+    static make(this: new (id?: string) => StatsOverview, id?: string): StatsOverview;
+    /** Cards-per-row. Falls back to the static `columns` if the fluent
+     *  setter wasn't called; renderer defaults further to a sensible
+     *  number when neither is set. */
+    columns(n: number): this;
+    /** Override the data hook. Useful for the fluent (no-subclass) form;
+     *  for the subclass form prefer `static override async getStats(...)`. */
+    getStatsHandler(fn: StatsHandler): this;
+    getType(): string;
+    /** Effective columns count. Instance setter wins; static is the
+     *  fallback. Returns `undefined` when neither is set. */
+    getColumns(): number | undefined;
+    toMeta(): Record<string, unknown>;
+    /**
+     * Run the configured stats hook. Falls back through:
+     *   1. instance setter (`overview.getStatsHandler(fn)`),
+     *   2. static method on the subclass (`static async getStats(ctx) {…}`),
+     *   3. empty list (`{ stats: [] }`).
+     *
+     * Resolved Stat objects are serialized to JSON-clean `StatMeta`s here
+     * so the renderer doesn't need to know about the `Stat` class.
+     */
+    resolveServerData(ctx: RenderContext): Promise<StatsOverviewPayload>;
+}
+//# sourceMappingURL=StatsOverview.d.ts.map

package/dist/schema/StatsOverview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatsOverview.d.ts","sourceRoot":"","sources":["../../src/schema/StatsOverview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAA;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;AAE3E,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB;AAED,qBAAa,aAAc,SAAQ,iBAAiB;IAClD;;8BAE0B;IAC1B,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;IAG9B,OAAO,CAAC,QAAQ,CAAC,CAAU;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAe;gBAGrB,EAAE,CAAC,EAAE,MAAM;IAKvB,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,aAAa,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,aAAa;IAIjF;;sCAEkC;IAClC,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKxB;8EAC0E;IAC1E,eAAe,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI;IAKvC,OAAO,IAAI,MAAM;IAEjB;6DACyD;IACzD,UAAU,IAAI,MAAM,GAAG,SAAS;IAMhC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAOjC;;;;;;;;OAQG;IACG,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAU3E"}

package/dist/schema/StatsOverview.js

@@ -0,0 +1,71 @@
+import { ServerDataElement } from './ServerDataElement.js';
+export class StatsOverview extends ServerDataElement {
+    /** Subclass-time defaults — read by `make()`-built instances unless
+     *  the fluent setter overrides. Mirrors the `View.componentName /
+     *  getData` precedent. */
+    static columns;
+    static getStats;
+    // ─── Instance state (fluent overrides) ─────────────────────
+    _columns;
+    _getStats;
+    // Public for subclass `new this(id)` (matches `View`).
+    constructor(id) {
+        super();
+        if (id)
+            this._id = id;
+    }
+    static make(id) {
+        return new this(id);
+    }
+    /** Cards-per-row. Falls back to the static `columns` if the fluent
+     *  setter wasn't called; renderer defaults further to a sensible
+     *  number when neither is set. */
+    columns(n) {
+        this._columns = n;
+        return this;
+    }
+    /** Override the data hook. Useful for the fluent (no-subclass) form;
+     *  for the subclass form prefer `static override async getStats(...)`. */
+    getStatsHandler(fn) {
+        this._getStats = fn;
+        return this;
+    }
+    getType() { return 'stats'; }
+    /** Effective columns count. Instance setter wins; static is the
+     *  fallback. Returns `undefined` when neither is set. */
+    getColumns() {
+        if (this._columns !== undefined)
+            return this._columns;
+        const ctor = this.constructor;
+        return ctor.columns;
+    }
+    toMeta() {
+        const meta = { type: 'stats' };
+        const cols = this.getColumns();
+        if (cols !== undefined)
+            meta['columns'] = cols;
+        return meta;
+    }
+    /**
+     * Run the configured stats hook. Falls back through:
+     *   1. instance setter (`overview.getStatsHandler(fn)`),
+     *   2. static method on the subclass (`static async getStats(ctx) {…}`),
+     *   3. empty list (`{ stats: [] }`).
+     *
+     * Resolved Stat objects are serialized to JSON-clean `StatMeta`s here
+     * so the renderer doesn't need to know about the `Stat` class.
+     */
+    async resolveServerData(ctx) {
+        let stats = [];
+        if (this._getStats) {
+            stats = await this._getStats(ctx);
+        }
+        else {
+            const ctor = this.constructor;
+            if (ctor.getStats)
+                stats = await ctor.getStats(ctx);
+        }
+        return { stats: stats.map(s => s.toMeta()) };
+    }
+}
+//# sourceMappingURL=StatsOverview.js.map

package/dist/schema/StatsOverview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatsOverview.js","sourceRoot":"","sources":["../../src/schema/StatsOverview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AA8C1D,MAAM,OAAO,aAAc,SAAQ,iBAAiB;IAClD;;8BAE0B;IAC1B,MAAM,CAAC,OAAO,CAAS;IACvB,MAAM,CAAC,QAAQ,CAAe;IAE9B,8DAA8D;IACtD,QAAQ,CAAW;IACnB,SAAS,CAAgB;IAEjC,uDAAuD;IACvD,YAAY,EAAW;QACrB,KAAK,EAAE,CAAA;QACP,IAAI,EAAE;YAAE,IAAI,CAAC,GAAG,GAAG,EAAE,CAAA;IACvB,CAAC;IAED,MAAM,CAAC,IAAI,CAA2C,EAAW;QAC/D,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;IACrB,CAAC;IAED;;sCAEkC;IAClC,OAAO,CAAC,CAAS;QACf,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;QACjB,OAAO,IAAI,CAAA;IACb,CAAC;IAED;8EAC0E;IAC1E,eAAe,CAAC,EAAgB;QAC9B,IAAI,CAAC,SAAS,GAAG,EAAE,CAAA;QACnB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAa,OAAO,OAAO,CAAA,CAAC,CAAC;IAEpC;6DACyD;IACzD,UAAU;QACR,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAA;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAmC,CAAA;QACrD,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED,MAAM;QACJ,MAAM,IAAI,GAA4B,EAAE,IAAI,EAAE,OAAgB,EAAE,CAAA;QAChE,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAA;QAC9B,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAA;QAC9C,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,iBAAiB,CAAC,GAAkB;QACxC,IAAI,KAAK,GAAW,EAAE,CAAA;QACtB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,IAAI,CAAC,WAA0C,CAAA;YAC5D,IAAI,IAAI,CAAC,QAAQ;gBAAE,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QACrD,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAA;IAC9C,CAAC;CACF"}

package/dist/schema/StyleTag.d.ts

@@ -0,0 +1,32 @@
+import { Element } from './Element.js';
+/**
+ * Head-safe element — emits an inline `<style>` block inside the panel's
+ * `<head>`. Use for CSS-variable overrides, conditional theming, or
+ * per-tenant brand colors that need to ship with the SSR document so
+ * there's no FOUC.
+ *
+ * For external stylesheets reach for `LinkTag.make({ rel: 'stylesheet',
+ * href: '...' })` instead.
+ *
+ * @example
+ *   Pilotiq.renderHook('panels::styles', ({ user }) => [
+ *     StyleTag.make(`
+ *       :root { --pilotiq-brand: ${tenantBrand(user)} }
+ *     `),
+ *   ])
+ */
+export declare class StyleTag extends Element {
+    private css;
+    private nonce?;
+    private constructor();
+    static make(css: string, opts?: {
+        nonce?: string;
+    }): StyleTag;
+    getType(): string;
+    toMeta(): {
+        nonce?: string;
+        type: "style";
+        css: string;
+    };
+}
+//# sourceMappingURL=StyleTag.d.ts.map

package/dist/schema/StyleTag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StyleTag.d.ts","sourceRoot":"","sources":["../../src/schema/StyleTag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAS,SAAQ,OAAO;IACf,OAAO,CAAC,GAAG;IAAU,OAAO,CAAC,KAAK,CAAC;IAAvD,OAAO;IAEP,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ;IAI7D,OAAO,IAAI,MAAM;IAEjB,MAAM;;;;;CAOP"}

package/dist/schema/StyleTag.js

@@ -0,0 +1,38 @@
+import { Element } from './Element.js';
+/**
+ * Head-safe element — emits an inline `<style>` block inside the panel's
+ * `<head>`. Use for CSS-variable overrides, conditional theming, or
+ * per-tenant brand colors that need to ship with the SSR document so
+ * there's no FOUC.
+ *
+ * For external stylesheets reach for `LinkTag.make({ rel: 'stylesheet',
+ * href: '...' })` instead.
+ *
+ * @example
+ *   Pilotiq.renderHook('panels::styles', ({ user }) => [
+ *     StyleTag.make(`
+ *       :root { --pilotiq-brand: ${tenantBrand(user)} }
+ *     `),
+ *   ])
+ */
+export class StyleTag extends Element {
+    css;
+    nonce;
+    constructor(css, nonce) {
+        super();
+        this.css = css;
+        this.nonce = nonce;
+    }
+    static make(css, opts) {
+        return new StyleTag(css, opts?.nonce);
+    }
+    getType() { return 'style'; }
+    toMeta() {
+        return {
+            type: 'style',
+            css: this.css,
+            ...(this.nonce ? { nonce: this.nonce } : {}),
+        };
+    }
+}
+//# sourceMappingURL=StyleTag.js.map

package/dist/schema/StyleTag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StyleTag.js","sourceRoot":"","sources":["../../src/schema/StyleTag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,QAAS,SAAQ,OAAO;IACP;IAAqB;IAAjD,YAA4B,GAAW,EAAU,KAAc;QAAI,KAAK,EAAE,CAAA;QAA9C,QAAG,GAAH,GAAG,CAAQ;QAAU,UAAK,GAAL,KAAK,CAAS;IAAY,CAAC;IAE5E,MAAM,CAAC,IAAI,CAAC,GAAW,EAAE,IAAyB;QAChD,OAAO,IAAI,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;IACvC,CAAC;IAED,OAAO,KAAa,OAAO,OAAO,CAAA,CAAC,CAAC;IAEpC,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,OAAgB;YACtB,GAAG,EAAG,IAAI,CAAC,GAAG;YACd,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7C,CAAA;IACH,CAAC;CACF"}

package/dist/schema/TableWidget.d.ts

@@ -0,0 +1,148 @@
+import { ServerDataElement } from './ServerDataElement.js';
+import type { RenderContext } from './resolveSchema.js';
+import { Column } from '../Column.js';
+import { type ModelLike, type ModelQuery } from '../orm/modelDefaults.js';
+/**
+ * Plan #15 Phase D — `TableWidget` is the slim-table dashboard widget.
+ * Mirrors Filament's `Filament\Widgets\TableWidget`: a dashboard tile
+ * that surfaces a small list of records (e.g. "5 newest posts") without
+ * the full Resource list-page chrome (no filters, no bulk actions, no
+ * pagination, no search).
+ *
+ * Distinct from the schema-element `Table` (`elements/Table.ts`) — that
+ * one drives Resource list pages and carries the full surface. The
+ * widget renders a stripped-down `<table>` paint and reads its rows from
+ * `_widgetData[id]`.
+ *
+ * **Subclass form** (primary):
+ *
+ *   import { TableWidget } from '@pilotiq/pilotiq'
+ *   import { TextColumn } from '@pilotiq/pilotiq/columns'
+ *   import { Post } from '#models'
+ *
+ *   export class RecentPosts extends TableWidget {
+ *     static override label = 'Recent posts'
+ *     static override model = Post
+ *     static override viewAllUrl = '/admin/posts'
+ *     static override async query(q) {
+ *       return q.orderBy('createdAt', 'desc').paginate(1, 5)
+ *     }
+ *     static override columns() {
+ *       return [
+ *         TextColumn.make('title').limit(40),
+ *         TextColumn.make('createdAt').dateTime(),
+ *       ]
+ *     }
+ *   }
+ *
+ * **Fluent form** — useful for one-off cases:
+ *
+ *   TableWidget.make('recent-posts')
+ *     .label('Recent posts')
+ *     .columns([Column.make('title')])
+ *     .records(async () => ({ rows: [{ title: 'Hi' }], total: 1 }))
+ *     .viewAllUrl('/admin/posts')
+ *
+ * Wire-shape:
+ *   meta:           { type: 'tableWidget', label?, viewAllUrl?, columns: ColumnMeta[],
+ *                     serverData, id, lazy[, poll] }
+ *   _widgetData[id]: { rows: Record<string, unknown>[]; total?: number }
+ *
+ * Lazy default = true (inherited from `ServerDataElement`).
+ */
+/** Result returned by `records()` — rows plus optional total. The total
+ *  is informational only in v1 (no pagination in the slim renderer);
+ *  reserved for future "View all (24)" badge sugar. */
+export interface TableWidgetRecordsResult {
+    rows: Record<string, unknown>[];
+    total?: number;
+}
+export type TableWidgetRecordsHandler = (ctx: RenderContext) => TableWidgetRecordsResult | Promise<TableWidgetRecordsResult>;
+/**
+ * Subclass-form `query(q)` hook — receives a `ModelQuery` from
+ * `static model.query()` and returns a `Promise<{ data, total }>`. The
+ * `paginate()` call lives inside the hook so users control limit (e.g.
+ * `q.orderBy(...).paginate(1, 5)` for "5 newest").
+ *
+ * Returning the bare query (without `paginate()`) is a programming error
+ * — the widget needs an awaited result, not another query builder.
+ */
+export type TableWidgetQueryHandler = (q: ModelQuery) => Promise<{
+    data: unknown[];
+    total: number;
+}>;
+export interface TableWidgetPayload {
+    rows: Record<string, unknown>[];
+    total?: number;
+}
+export declare class TableWidget extends ServerDataElement {
+    /** Heading rendered above the table. Falls back to the class name when
+     *  unset and `viewAllUrl` is set (the link needs visible chrome). */
+    static label?: string;
+    /** Optional ORM model — when set, default `records()` does
+     *  `M.query()` then runs the configured `query()` hook (which must
+     *  paginate to bound the row count). */
+    static model?: ModelLike;
+    /** Optional "View all →" link href shown in the widget header. */
+    static viewAllUrl?: string;
+    /** Subclass-form column factory. Called once per resolve; instance
+     *  setter wins. */
+    static columns?: () => Column[];
+    /** Subclass-form query hook (model-driven path). Falls back to a
+     *  bare `paginate(1, 5)` when unset. */
+    static query?: TableWidgetQueryHandler;
+    /** Subclass-form full-records override. When set, takes precedence
+     *  over `model + query`. */
+    static records?: TableWidgetRecordsHandler;
+    private _label?;
+    private _model?;
+    private _viewAllUrl?;
+    private _columns?;
+    private _query?;
+    private _records?;
+    constructor(id?: string);
+    static make(this: new (id?: string) => TableWidget, id?: string): TableWidget;
+    /** Heading rendered above the table. */
+    label(text: string): this;
+    /** Bind a `ModelLike` for the default model-driven records loader. */
+    model(M: ModelLike): this;
+    /** Custom query hook — receives `M.query()` and must return a
+     *  `paginate()` promise. Composes with `.model(M)`. */
+    query(fn: TableWidgetQueryHandler): this;
+    /** Full records override — fully replaces the `model + query` path. */
+    records(fn: TableWidgetRecordsHandler): this;
+    /** Column children. The renderer reads label / format / columnType /
+     *  formatter from each column's resolved meta — same shape as the
+     *  Resource list table. Columns are serialized inline under
+     *  `meta.columns` (not under `meta.children`) so the resolver doesn't
+     *  treat them as standalone nodes. */
+    columns(cols: Column[]): this;
+    /** "View all →" link href. */
+    viewAllUrl(href: string): this;
+    /** Effective label. Instance setter wins; static is the fallback. */
+    getLabel(): string | undefined;
+    /** Effective viewAllUrl. */
+    getViewAllUrl(): string | undefined;
+    /** Effective model. */
+    getModel(): ModelLike | undefined;
+    /** Effective columns. Instance setter wins; static factory is the
+     *  fallback. Empty array when neither is set. */
+    getColumns(): Column[];
+    getType(): string;
+    toMeta(): Record<string, unknown>;
+    /**
+     * Run the configured row loader. Falls back through:
+     *   1. instance `.records(fn)` setter,
+     *   2. subclass `static records(ctx)`,
+     *   3. instance `.model(M) + .query(fn)`,
+     *   4. subclass `static model + static query?(q)`,
+     *   5. error — at least one path must be configured.
+     *
+     * The default `query` hook (when only `model` is set) is
+     * `q => q.paginate(1, 5)`. Override on the subclass for "10 newest"
+     * etc.
+     */
+    resolveServerData(ctx: RenderContext): Promise<TableWidgetPayload>;
+    private normalizeResult;
+}
+//# sourceMappingURL=TableWidget.d.ts.map

package/dist/schema/TableWidget.d.ts.map

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