@pilotiq/pilotiq 0.1.0

package/dist/schema/TableWidget.js

@@ -0,0 +1,190 @@
+import { ServerDataElement } from './ServerDataElement.js';
+export class TableWidget extends ServerDataElement {
+    // ─── Subclass-time defaults ──────────────────────────────
+    /** Heading rendered above the table. Falls back to the class name when
+     *  unset and `viewAllUrl` is set (the link needs visible chrome). */
+    static label;
+    /** 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;
+    /** Optional "View all →" link href shown in the widget header. */
+    static viewAllUrl;
+    /** Subclass-form column factory. Called once per resolve; instance
+     *  setter wins. */
+    static columns;
+    /** Subclass-form query hook (model-driven path). Falls back to a
+     *  bare `paginate(1, 5)` when unset. */
+    static query;
+    /** Subclass-form full-records override. When set, takes precedence
+     *  over `model + query`. */
+    static records;
+    // ─── Instance state (fluent overrides) ──────────────────
+    _label;
+    _model;
+    _viewAllUrl;
+    _columns;
+    _query;
+    _records;
+    constructor(id) {
+        super();
+        if (id)
+            this._id = id;
+    }
+    static make(id) {
+        return new this(id);
+    }
+    // ─── Fluent setters ──────────────────────────────────────
+    /** Heading rendered above the table. */
+    label(text) {
+        this._label = text;
+        return this;
+    }
+    /** Bind a `ModelLike` for the default model-driven records loader. */
+    model(M) {
+        this._model = M;
+        return this;
+    }
+    /** Custom query hook — receives `M.query()` and must return a
+     *  `paginate()` promise. Composes with `.model(M)`. */
+    query(fn) {
+        this._query = fn;
+        return this;
+    }
+    /** Full records override — fully replaces the `model + query` path. */
+    records(fn) {
+        this._records = fn;
+        return 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) {
+        this._columns = cols;
+        return this;
+    }
+    /** "View all →" link href. */
+    viewAllUrl(href) {
+        this._viewAllUrl = href;
+        return this;
+    }
+    // ─── Getters ─────────────────────────────────────────────
+    /** Effective label. Instance setter wins; static is the fallback. */
+    getLabel() {
+        if (this._label !== undefined)
+            return this._label;
+        const ctor = this.constructor;
+        return ctor.label;
+    }
+    /** Effective viewAllUrl. */
+    getViewAllUrl() {
+        if (this._viewAllUrl !== undefined)
+            return this._viewAllUrl;
+        const ctor = this.constructor;
+        return ctor.viewAllUrl;
+    }
+    /** Effective model. */
+    getModel() {
+        if (this._model !== undefined)
+            return this._model;
+        const ctor = this.constructor;
+        return ctor.model;
+    }
+    /** Effective columns. Instance setter wins; static factory is the
+     *  fallback. Empty array when neither is set. */
+    getColumns() {
+        if (this._columns !== undefined)
+            return this._columns;
+        const ctor = this.constructor;
+        if (typeof ctor.columns === 'function') {
+            const out = ctor.columns();
+            this._columns = out;
+            return out;
+        }
+        return [];
+    }
+    getType() { return 'tableWidget'; }
+    toMeta() {
+        const meta = { type: 'tableWidget' };
+        const label = this.getLabel();
+        if (label !== undefined)
+            meta['label'] = label;
+        const url = this.getViewAllUrl();
+        if (url !== undefined)
+            meta['viewAllUrl'] = url;
+        meta['columns'] = this.getColumns().map(c => c.toMeta());
+        return meta;
+    }
+    // ─── Server-data resolve ────────────────────────────────
+    /**
+     * 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.
+     */
+    async resolveServerData(ctx) {
+        let payload;
+        if (this._records) {
+            payload = this.normalizeResult(await this._records(ctx));
+        }
+        else {
+            const ctor = this.constructor;
+            if (ctor.records) {
+                payload = this.normalizeResult(await ctor.records(ctx));
+            }
+            else {
+                const M = this.getModel();
+                if (!M) {
+                    throw new Error(`[Pilotiq] TableWidget "${this.getId()}" has no rows source — call .records(fn), ` +
+                        `.model(M).query(fn), or set static model / records / columns on the subclass.`);
+                }
+                const q = M.query();
+                const fn = this._query ?? this.constructor.query ?? defaultQueryHook;
+                const result = await fn(q);
+                payload = result.total !== undefined
+                    ? { rows: result.data ?? [], total: result.total }
+                    : { rows: result.data ?? [] };
+            }
+        }
+        // Per-row server-side `formatStateUsing` — same convention as the
+        // full `Table` (`row._formatted[colName]`). Skipped when no column
+        // has a formatter so we don't allocate per-row in the common case.
+        const columnsWithFormatter = this.getColumns().filter(c => c.hasFormatter());
+        if (columnsWithFormatter.length > 0) {
+            payload.rows = payload.rows.map(row => {
+                const formatted = {};
+                for (const col of columnsWithFormatter) {
+                    const fn = col.getFormatStateHandler();
+                    if (!fn)
+                        continue;
+                    try {
+                        formatted[col.name] = fn(row[col.name], row);
+                    }
+                    catch { /* fall back to raw value in renderer */ }
+                }
+                return { ...row, _formatted: formatted };
+            });
+        }
+        return payload;
+    }
+    normalizeResult(r) {
+        return r.total !== undefined
+            ? { rows: r.rows, total: r.total }
+            : { rows: r.rows };
+    }
+}
+/** Default query hook — paginate to the first 5 rows. Users override on
+ *  the subclass (`static async query(q) { return q.orderBy(...).paginate(1, 10) }`)
+ *  or via the instance setter for limits / sorts. */
+function defaultQueryHook(q) {
+    return q.paginate(1, 5);
+}
+//# sourceMappingURL=TableWidget.js.map

package/dist/schema/TableWidget.js.map

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

package/dist/schema/Tabs.d.ts

@@ -0,0 +1,40 @@
+import { Element } from './Element.js';
+/**
+ * Single tab within a `Tabs` container. Holds a label, optional icon/badge,
+ * and a list of child Elements. Resolves to its own meta entry inside the
+ * parent's children array.
+ */
+export declare class Tab extends Element {
+    private _label;
+    private _icon?;
+    private _badge?;
+    private constructor();
+    static make(label: string): Tab;
+    icon(i: string): this;
+    badge(b: string): this;
+    schema(elements: Element[]): this;
+    getType(): string;
+    toMeta(): Record<string, unknown>;
+}
+export type TabsVariant = 'pills' | 'underline';
+/**
+ * Multi-tab container. Children are `Tab` instances; each Tab has its own
+ * children rendered when its tab is active. Mirrors panels' `Tabs` element
+ * for the static case (model-backed and array-backed Tabs are a future
+ * extension).
+ */
+export declare class Tabs extends Element {
+    private _variant;
+    private constructor();
+    static make(): Tabs;
+    /** Set the tab list. Each entry is a `Tab` instance with its own schema. */
+    tabs(tabs: Tab[]): this;
+    /**
+     * Visual style. `'pills'` (default) — shadcn pill background with sliding
+     * indicator. `'underline'` — bottom border on active tab.
+     */
+    variant(v: TabsVariant): this;
+    getType(): string;
+    toMeta(): Record<string, unknown>;
+}
+//# sourceMappingURL=Tabs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../src/schema/Tabs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC;;;;GAIG;AACH,qBAAa,GAAI,SAAQ,OAAO;IAIV,OAAO,CAAC,MAAM;IAHlC,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,MAAM,CAAC,CAAQ;IAEvB,OAAO;IAIP,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG;IAI/B,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IACrB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAEtB,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAKjC,OAAO,IAAI,MAAM;IAEjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,WAAW,CAAA;AAE/C;;;;;GAKG;AACH,qBAAa,IAAK,SAAQ,OAAO;IAC/B,OAAO,CAAC,QAAQ,CAAuB;IAEvC,OAAO;IAIP,MAAM,CAAC,IAAI,IAAI,IAAI;IAInB,4EAA4E;IAC5E,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAKvB;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI;IAK7B,OAAO,IAAI,MAAM;IAEjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAGlC"}

package/dist/schema/Tabs.js

@@ -0,0 +1,66 @@
+import { Element } from './Element.js';
+/**
+ * Single tab within a `Tabs` container. Holds a label, optional icon/badge,
+ * and a list of child Elements. Resolves to its own meta entry inside the
+ * parent's children array.
+ */
+export class Tab extends Element {
+    _label;
+    _icon;
+    _badge;
+    constructor(_label) {
+        super();
+        this._label = _label;
+    }
+    static make(label) {
+        return new Tab(label);
+    }
+    icon(i) { this._icon = i; return this; }
+    badge(b) { this._badge = b; return this; }
+    schema(elements) {
+        this._children = elements;
+        return this;
+    }
+    getType() { return 'tab'; }
+    toMeta() {
+        return {
+            type: 'tab',
+            label: this._label,
+            ...(this._icon ? { icon: this._icon } : {}),
+            ...(this._badge ? { badge: this._badge } : {}),
+        };
+    }
+}
+/**
+ * Multi-tab container. Children are `Tab` instances; each Tab has its own
+ * children rendered when its tab is active. Mirrors panels' `Tabs` element
+ * for the static case (model-backed and array-backed Tabs are a future
+ * extension).
+ */
+export class Tabs extends Element {
+    _variant = 'pills';
+    constructor() {
+        super();
+    }
+    static make() {
+        return new Tabs();
+    }
+    /** Set the tab list. Each entry is a `Tab` instance with its own schema. */
+    tabs(tabs) {
+        this._children = tabs;
+        return this;
+    }
+    /**
+     * Visual style. `'pills'` (default) — shadcn pill background with sliding
+     * indicator. `'underline'` — bottom border on active tab.
+     */
+    variant(v) {
+        this._variant = v;
+        return this;
+    }
+    getType() { return 'tabs'; }
+    toMeta() {
+        return { type: 'tabs', variant: this._variant };
+    }
+}
+//# sourceMappingURL=Tabs.js.map

package/dist/schema/Tabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tabs.js","sourceRoot":"","sources":["../../src/schema/Tabs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC;;;;GAIG;AACH,MAAM,OAAO,GAAI,SAAQ,OAAO;IAIF;IAHpB,KAAK,CAAS;IACd,MAAM,CAAS;IAEvB,YAA4B,MAAc;QACxC,KAAK,EAAE,CAAA;QADmB,WAAM,GAAN,MAAM,CAAQ;IAE1C,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;IACvB,CAAC;IAED,IAAI,CAAC,CAAS,IAAU,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IACrD,KAAK,CAAC,CAAS,IAAU,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAEvD,MAAM,CAAC,QAAmB;QACxB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAA;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAa,OAAO,KAAK,CAAA,CAAC,CAAC;IAElC,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,KAAc;YACpB,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAE,CAAC,CAAC,EAAE,IAAI,EAAG,IAAI,CAAC,KAAK,EAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C,CAAA;IACH,CAAC;CACF;AAID;;;;;GAKG;AACH,MAAM,OAAO,IAAK,SAAQ,OAAO;IACvB,QAAQ,GAAgB,OAAO,CAAA;IAEvC;QACE,KAAK,EAAE,CAAA;IACT,CAAC;IAED,MAAM,CAAC,IAAI;QACT,OAAO,IAAI,IAAI,EAAE,CAAA;IACnB,CAAC;IAED,4EAA4E;IAC5E,IAAI,CAAC,IAAW;QACd,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,CAAc;QACpB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;QACjB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAa,OAAO,MAAM,CAAA,CAAC,CAAC;IAEnC,MAAM;QACJ,OAAO,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAA;IAC1D,CAAC;CACF"}

package/dist/schema/Text.d.ts

@@ -0,0 +1,33 @@
+import { Element } from './Element.js';
+import type { BadgeColor } from '../columns/BadgeColumn.js';
+export type TextColor = 'default' | 'muted' | 'primary' | 'destructive' | 'success' | 'warning' | 'info';
+export type TextSize = 'xs' | 'sm' | 'base' | 'lg' | 'xl';
+export type TextWeight = 'normal' | 'medium' | 'semibold' | 'bold';
+export declare class Text extends Element {
+    private content;
+    private _color?;
+    private _size?;
+    private _weight?;
+    private _badge;
+    private _badgeColor?;
+    private constructor();
+    static make(content: string): Text;
+    color(c: TextColor): this;
+    size(s: TextSize): this;
+    weight(w: TextWeight): this;
+    /** Render the content as a pill/badge instead of plain text.
+     *  Pair with `.badgeColor()` for tinted variants. */
+    badge(v?: boolean): this;
+    badgeColor(c: BadgeColor): this;
+    getType(): string;
+    toMeta(): {
+        badgeColor?: BadgeColor;
+        badge?: boolean;
+        weight?: TextWeight;
+        size?: TextSize;
+        color?: TextColor;
+        type: "text";
+        content: string;
+    };
+}
+//# sourceMappingURL=Text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Text.d.ts","sourceRoot":"","sources":["../../src/schema/Text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAE3D,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,OAAO,GACP,SAAS,GACT,aAAa,GACb,SAAS,GACT,SAAS,GACT,MAAM,CAAA;AAEV,MAAM,MAAM,QAAQ,GAAK,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;AAC3D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAA;AAElE,qBAAa,IAAK,SAAQ,OAAO;IAOX,OAAO,CAAC,OAAO;IANnC,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,KAAK,CAAC,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAY;IAC5B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAY;IAEhC,OAAO;IAIP,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIlC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI;IACzB,IAAI,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI;IACvB,MAAM,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI;IAE3B;yDACqD;IACrD,KAAK,CAAC,CAAC,UAAO,GAAG,IAAI;IAErB,UAAU,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI;IAM/B,OAAO,IAAI,MAAM;IAEjB,MAAM;;;;;;;;;CAWP"}

package/dist/schema/Text.js

@@ -0,0 +1,40 @@
+import { Element } from './Element.js';
+export class Text extends Element {
+    content;
+    _color;
+    _size;
+    _weight;
+    _badge = false;
+    _badgeColor;
+    constructor(content) {
+        super();
+        this.content = content;
+    }
+    static make(content) {
+        return new Text(content);
+    }
+    color(c) { this._color = c; return this; }
+    size(s) { this._size = s; return this; }
+    weight(w) { this._weight = w; return this; }
+    /** Render the content as a pill/badge instead of plain text.
+     *  Pair with `.badgeColor()` for tinted variants. */
+    badge(v = true) { this._badge = v; return this; }
+    badgeColor(c) {
+        this._badgeColor = c;
+        this._badge = true;
+        return this;
+    }
+    getType() { return 'text'; }
+    toMeta() {
+        return {
+            type: 'text',
+            content: this.content,
+            ...(this._color ? { color: this._color } : {}),
+            ...(this._size ? { size: this._size } : {}),
+            ...(this._weight ? { weight: this._weight } : {}),
+            ...(this._badge ? { badge: true } : {}),
+            ...(this._badgeColor ? { badgeColor: this._badgeColor } : {}),
+        };
+    }
+}
+//# sourceMappingURL=Text.js.map

package/dist/schema/Text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Text.js","sourceRoot":"","sources":["../../src/schema/Text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAetC,MAAM,OAAO,IAAK,SAAQ,OAAO;IAOH;IANpB,MAAM,CAAa;IACnB,KAAK,CAAa;IAClB,OAAO,CAAa;IACpB,MAAM,GAAU,KAAK,CAAA;IACrB,WAAW,CAAa;IAEhC,YAA4B,OAAe;QACzC,KAAK,EAAE,CAAA;QADmB,YAAO,GAAP,OAAO,CAAQ;IAE3C,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,OAAe;QACzB,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAA;IAC1B,CAAC;IAED,KAAK,CAAC,CAAY,IAAY,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAC5D,IAAI,CAAC,CAAW,IAAc,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAC3D,MAAM,CAAC,CAAa,IAAU,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAE7D;yDACqD;IACrD,KAAK,CAAC,CAAC,GAAG,IAAI,IAAU,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAEtD,UAAU,CAAC,CAAa;QACtB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAA;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAa,OAAO,MAAM,CAAA,CAAC,CAAC;IAEnC,MAAM;QACJ,OAAO;YACL,IAAI,EAAK,MAAe;YACxB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAO,CAAC,CAAC,EAAE,KAAK,EAAO,IAAI,CAAC,MAAM,EAAE,CAAO,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,KAAK,CAAQ,CAAC,CAAC,EAAE,IAAI,EAAQ,IAAI,CAAC,KAAK,EAAE,CAAQ,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,OAAO,CAAM,CAAC,CAAC,EAAE,MAAM,EAAM,IAAI,CAAC,OAAO,EAAE,CAAM,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,MAAM,CAAO,CAAC,CAAC,EAAE,KAAK,EAAO,IAAI,EAAE,CAAc,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,WAAW,CAAE,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,CAAE,CAAC,CAAC,EAAE,CAAC;SAChE,CAAA;IACH,CAAC;CACF"}

package/dist/schema/UnorderedList.d.ts

@@ -0,0 +1,36 @@
+import { Element } from './Element.js';
+import type { TextColor, TextSize, TextWeight } from './Text.js';
+/**
+ * Read-only bullet list prime — sibling of `Heading / Text / Alert / Divider`.
+ *
+ * Items are plain strings stamped at schema build time. For dynamic data,
+ * compose with Resource state in your schema callback (the items array
+ * accepts the result of any expression).
+ *
+ * Cosmetic chrome mirrors `Text` — `color / size / weight` flow through to
+ * each `<li>` so the list reads consistently against neighbouring text in
+ * a detail view.
+ */
+export declare class UnorderedList extends Element {
+    private _items;
+    private _color?;
+    private _size?;
+    private _weight?;
+    private constructor();
+    /** Create a list. Pass the items inline or via `.items()` later. */
+    static make(items?: string[]): UnorderedList;
+    /** Replace the items array. Last call wins. */
+    items(items: string[]): this;
+    color(c: TextColor): this;
+    size(s: TextSize): this;
+    weight(w: TextWeight): this;
+    getType(): string;
+    toMeta(): {
+        weight?: TextWeight;
+        size?: TextSize;
+        color?: TextColor;
+        type: "unorderedList";
+        items: string[];
+    };
+}
+//# sourceMappingURL=UnorderedList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UnorderedList.d.ts","sourceRoot":"","sources":["../../src/schema/UnorderedList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEhE;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,KAAK,CAAC,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAY;IAE5B,OAAO;IAKP,oEAAoE;IACpE,MAAM,CAAC,IAAI,CAAC,KAAK,GAAE,MAAM,EAAO,GAAG,aAAa;IAIhD,+CAA+C;IAC/C,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAE5B,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI;IACzB,IAAI,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI;IACvB,MAAM,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI;IAE3B,OAAO,IAAI,MAAM;IAEjB,MAAM;;;;;;;CASP"}

package/dist/schema/UnorderedList.js

@@ -0,0 +1,42 @@
+import { Element } from './Element.js';
+/**
+ * Read-only bullet list prime — sibling of `Heading / Text / Alert / Divider`.
+ *
+ * Items are plain strings stamped at schema build time. For dynamic data,
+ * compose with Resource state in your schema callback (the items array
+ * accepts the result of any expression).
+ *
+ * Cosmetic chrome mirrors `Text` — `color / size / weight` flow through to
+ * each `<li>` so the list reads consistently against neighbouring text in
+ * a detail view.
+ */
+export class UnorderedList extends Element {
+    _items;
+    _color;
+    _size;
+    _weight;
+    constructor(items) {
+        super();
+        this._items = items;
+    }
+    /** Create a list. Pass the items inline or via `.items()` later. */
+    static make(items = []) {
+        return new UnorderedList(items);
+    }
+    /** Replace the items array. Last call wins. */
+    items(items) { this._items = items; return this; }
+    color(c) { this._color = c; return this; }
+    size(s) { this._size = s; return this; }
+    weight(w) { this._weight = w; return this; }
+    getType() { return 'unorderedList'; }
+    toMeta() {
+        return {
+            type: 'unorderedList',
+            items: this._items,
+            ...(this._color ? { color: this._color } : {}),
+            ...(this._size ? { size: this._size } : {}),
+            ...(this._weight ? { weight: this._weight } : {}),
+        };
+    }
+}
+//# sourceMappingURL=UnorderedList.js.map

package/dist/schema/UnorderedList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnorderedList.js","sourceRoot":"","sources":["../../src/schema/UnorderedList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGtC;;;;;;;;;;GAUG;AACH,MAAM,OAAO,aAAc,SAAQ,OAAO;IAChC,MAAM,CAAU;IAChB,MAAM,CAAa;IACnB,KAAK,CAAa;IAClB,OAAO,CAAa;IAE5B,YAAoB,KAAe;QACjC,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;IACrB,CAAC;IAED,oEAAoE;IACpE,MAAM,CAAC,IAAI,CAAC,QAAkB,EAAE;QAC9B,OAAO,IAAI,aAAa,CAAC,KAAK,CAAC,CAAA;IACjC,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,KAAe,IAAU,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAEjE,KAAK,CAAC,CAAY,IAAY,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAC5D,IAAI,CAAC,CAAW,IAAc,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAC3D,MAAM,CAAC,CAAa,IAAU,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAE7D,OAAO,KAAa,OAAO,eAAe,CAAA,CAAC,CAAC;IAE5C,MAAM;QACJ,OAAO;YACL,IAAI,EAAG,eAAwB;YAC/B,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAE,CAAC,CAAC,EAAE,KAAK,EAAG,IAAI,CAAC,MAAM,EAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAG,CAAC,CAAC,EAAE,IAAI,EAAI,IAAI,CAAC,KAAK,EAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClD,CAAA;IACH,CAAC;CACF"}

package/dist/schema/View.d.ts

@@ -0,0 +1,81 @@
+import { ServerDataElement } from './ServerDataElement.js';
+import type { RenderContext } from './resolveSchema.js';
+/**
+ * Plan #15 — `View` is the escape-hatch widget. Drops down to a
+ * user-supplied React component, optionally fed by a server-side
+ * `getData(ctx)` hook. Useful when the built-in widgets (Stat / Chart /
+ * Table) don't fit — calendar heatmaps, custom map embeds, anything
+ * one-off enough to not warrant a new built-in.
+ *
+ * Two usage patterns:
+ *
+ * **Subclass form** — extend `View` so the component reference + data
+ * hook both live as statics on a stable class:
+ *
+ *   import { View } from '@pilotiq/pilotiq'
+ *   export class ContributionMap extends View {
+ *     static columnSpan = 3
+ *     static componentName = 'CalendarHeatmap'
+ *     static async getData(ctx) {
+ *       return { days: await Activity.query().last(365).countByDay() }
+ *     }
+ *   }
+ *
+ *   // bootstrap/providers.ts
+ *   registerWidgetComponents({ CalendarHeatmap })
+ *
+ *   // Page.schema()
+ *   ContributionMap.make()
+ *
+ * **Fluent form** — for one-off cases where a subclass is overkill:
+ *
+ *   View.make('contribs')
+ *     .component('CalendarHeatmap')
+ *     .getData(async () => ({ days: ... }))
+ *
+ * The component receives `{ data }` as its sole prop (resolved from
+ * `getData / resolveServerData`). Components are looked up at render
+ * through the `widgets/registry` (see `registerWidgetComponents`).
+ */
+export type ViewDataHandler = (ctx: RenderContext) => unknown | Promise<unknown>;
+export declare class View extends ServerDataElement {
+    /**
+     * Component name used to look up the registered React component at
+     * render time. Subclasses set this as a static; the fluent form sets
+     * it via `.component(name)`.
+     *
+     * (Despite the name, this is a *string key* into the runtime registry,
+     * not a component reference itself — keeps `View` shippable through
+     * `viewProps` and avoids the `_components.ts` manifest walker.)
+     */
+    static componentName?: string;
+    /** Subclass-time getData hook. The fluent setter overrides this. */
+    static getData?: ViewDataHandler;
+    private _componentName?;
+    private _getData?;
+    constructor(id?: string);
+    /**
+     * Factory. Optional id — when omitted, `getId()` falls back to the
+     * subclass's class name (e.g. `ContributionMap`). Pass an explicit id
+     * when two instances of the same subclass appear on the same page,
+     * or for the bare `View.make('foo')` fluent form (no subclass to
+     * derive a name from).
+     */
+    static make(this: new (id?: string) => View, id?: string): View;
+    /** Set / override the registered component name. */
+    component(name: string): this;
+    /** Set / override the data handler. */
+    getDataHandler(fn: ViewDataHandler): this;
+    getType(): string;
+    /** Resolve the effective component name (instance > static > fallback to id). */
+    getComponentName(): string;
+    toMeta(): Record<string, unknown>;
+    /**
+     * Run the configured `getData(ctx)`. Falls back through:
+     *   1. instance setter (`view.getDataHandler(fn)`),
+     *   2. static method on the subclass (`static async getData(ctx) {…}`),
+     *   3. `null` (View renders the component with `data: null`).
+     */
+    resolveServerData(ctx: RenderContext): Promise<unknown>;
+}
+//# sourceMappingURL=View.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"View.d.ts","sourceRoot":"","sources":["../../src/schema/View.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAEhF,qBAAa,IAAK,SAAQ,iBAAiB;IACzC;;;;;;;;OAQG;IACH,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAE7B,oEAAoE;IACpE,MAAM,CAAC,OAAO,CAAC,EAAE,eAAe,CAAA;IAGhC,OAAO,CAAC,cAAc,CAAC,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,CAAuB;gBAK5B,EAAE,CAAC,EAAE,MAAM;IAKvB;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAI/D,oDAAoD;IACpD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7B,uCAAuC;IACvC,cAAc,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI;IAKzC,OAAO,IAAI,MAAM;IAEjB,iFAAiF;IACjF,gBAAgB,IAAI,MAAM;IAW1B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAOjC;;;;;OAKG;IACG,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;CAM9D"}

package/dist/schema/View.js

@@ -0,0 +1,81 @@
+import { ServerDataElement } from './ServerDataElement.js';
+export class View extends ServerDataElement {
+    /**
+     * Component name used to look up the registered React component at
+     * render time. Subclasses set this as a static; the fluent form sets
+     * it via `.component(name)`.
+     *
+     * (Despite the name, this is a *string key* into the runtime registry,
+     * not a component reference itself — keeps `View` shippable through
+     * `viewProps` and avoids the `_components.ts` manifest walker.)
+     */
+    static componentName;
+    /** Subclass-time getData hook. The fluent setter overrides this. */
+    static getData;
+    // ─── Instance state (fluent overrides) ────────────────────
+    _componentName;
+    _getData;
+    // Public for `make()`'s `new this(id)` factory call from subclasses —
+    // a protected ctor here breaks `class Foo extends View {}; Foo.make()`
+    // because the typeof Foo signature wouldn't satisfy `new (id?) => View`.
+    constructor(id) {
+        super();
+        if (id)
+            this._id = id;
+    }
+    /**
+     * Factory. Optional id — when omitted, `getId()` falls back to the
+     * subclass's class name (e.g. `ContributionMap`). Pass an explicit id
+     * when two instances of the same subclass appear on the same page,
+     * or for the bare `View.make('foo')` fluent form (no subclass to
+     * derive a name from).
+     */
+    static make(id) {
+        return new this(id);
+    }
+    /** Set / override the registered component name. */
+    component(name) {
+        this._componentName = name;
+        return this;
+    }
+    /** Set / override the data handler. */
+    getDataHandler(fn) {
+        this._getData = fn;
+        return this;
+    }
+    getType() { return 'view'; }
+    /** Resolve the effective component name (instance > static > fallback to id). */
+    getComponentName() {
+        if (this._componentName)
+            return this._componentName;
+        const ctor = this.constructor;
+        if (ctor.componentName)
+            return ctor.componentName;
+        // Last resort — use the element's id so a subclass that forgets to
+        // declare a `componentName` static still has a deterministic lookup
+        // key. The renderer surfaces a "component not registered" error
+        // when the registry doesn't carry it.
+        return this.getId();
+    }
+    toMeta() {
+        return {
+            type: 'view',
+            component: this.getComponentName(),
+        };
+    }
+    /**
+     * Run the configured `getData(ctx)`. Falls back through:
+     *   1. instance setter (`view.getDataHandler(fn)`),
+     *   2. static method on the subclass (`static async getData(ctx) {…}`),
+     *   3. `null` (View renders the component with `data: null`).
+     */
+    async resolveServerData(ctx) {
+        if (this._getData)
+            return this._getData(ctx);
+        const ctor = this.constructor;
+        if (ctor.getData)
+            return ctor.getData(ctx);
+        return null;
+    }
+}
+//# sourceMappingURL=View.js.map

package/dist/schema/View.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"View.js","sourceRoot":"","sources":["../../src/schema/View.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AA2C1D,MAAM,OAAO,IAAK,SAAQ,iBAAiB;IACzC;;;;;;;;OAQG;IACH,MAAM,CAAC,aAAa,CAAS;IAE7B,oEAAoE;IACpE,MAAM,CAAC,OAAO,CAAkB;IAEhC,6DAA6D;IACrD,cAAc,CAAS;IACvB,QAAQ,CAAwB;IAExC,sEAAsE;IACtE,uEAAuE;IACvE,yEAAyE;IACzE,YAAY,EAAW;QACrB,KAAK,EAAE,CAAA;QACP,IAAI,EAAE;YAAE,IAAI,CAAC,GAAG,GAAG,EAAE,CAAA;IACvB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAkC,EAAW;QACtD,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;IACrB,CAAC;IAED,oDAAoD;IACpD,SAAS,CAAC,IAAY;QACpB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;QAC1B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,uCAAuC;IACvC,cAAc,CAAC,EAAmB;QAChC,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAA;QAClB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAa,OAAO,MAAM,CAAA,CAAC,CAAC;IAEnC,iFAAiF;IACjF,gBAAgB;QACd,IAAI,IAAI,CAAC,cAAc;YAAE,OAAO,IAAI,CAAC,cAAc,CAAA;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAyC,CAAA;QAC3D,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC,aAAa,CAAA;QACjD,mEAAmE;QACnE,oEAAoE;QACpE,gEAAgE;QAChE,sCAAsC;QACtC,OAAO,IAAI,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAO,MAAe;YAC1B,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE;SACnC,CAAA;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,iBAAiB,CAAC,GAAkB;QACxC,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,WAA4C,CAAA;QAC9D,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAC1C,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}