@portel/photon-core 2.3.0 → 2.5.0

package/dist/ui-types/Progress.js

@@ -0,0 +1,191 @@
+/**
+ * Progress - Purpose-driven type for progress indicators
+ *
+ * Automatically renders as progress bars or steps.
+ *
+ * @example
+ * ```typescript
+ * // Simple progress bar
+ * async uploadStatus() {
+ *   return new Progress(75)
+ *     .label('Uploading files...')
+ *     .color('blue');
+ * }
+ *
+ * // Multiple progress bars
+ * async projectStatus() {
+ *   return new Progress()
+ *     .bar('Design', 100, { color: 'green' })
+ *     .bar('Development', 65, { color: 'blue' })
+ *     .bar('Testing', 20, { color: 'yellow' });
+ * }
+ *
+ * // Step indicator
+ * async checkoutSteps() {
+ *   return new Progress('steps')
+ *     .step('Cart', 'completed')
+ *     .step('Shipping', 'current')
+ *     .step('Payment', 'pending')
+ *     .step('Confirm', 'pending');
+ * }
+ * ```
+ */
+import { PhotonUIType } from './base.js';
+export class Progress extends PhotonUIType {
+    _photonType = 'progress';
+    _bars = [];
+    _steps = [];
+    _value = 0;
+    _max = 100;
+    _options = {
+        style: 'bar',
+        size: 'md',
+        showValue: true,
+        animated: true,
+    };
+    /**
+     * Create a new Progress indicator
+     * @param valueOrStyle Initial value (0-100) or style ('steps', 'circle')
+     */
+    constructor(valueOrStyle) {
+        super();
+        if (typeof valueOrStyle === 'number') {
+            this._value = valueOrStyle;
+        }
+        else if (valueOrStyle) {
+            this._options.style = valueOrStyle;
+        }
+    }
+    /**
+     * Set progress value (0-100)
+     */
+    value(val, max) {
+        this._value = val;
+        if (max !== undefined)
+            this._max = max;
+        return this;
+    }
+    /**
+     * Set label
+     */
+    label(text) {
+        this._options.title = text;
+        return this;
+    }
+    /**
+     * Add a progress bar (for multi-bar display)
+     */
+    bar(label, value, options) {
+        this._bars.push({
+            label,
+            value,
+            max: options?.max ?? 100,
+            color: options?.color,
+            showValue: options?.showValue ?? true,
+        });
+        return this;
+    }
+    /**
+     * Add a step (for step indicator)
+     */
+    step(label, status = 'pending', options) {
+        this._options.style = 'steps';
+        this._steps.push({
+            label,
+            status,
+            ...options,
+        });
+        return this;
+    }
+    /**
+     * Set color
+     */
+    color(color) {
+        this._options.color = color;
+        return this;
+    }
+    /**
+     * Set size
+     */
+    size(size) {
+        this._options.size = size;
+        return this;
+    }
+    /**
+     * Use striped style
+     */
+    striped(enabled = true) {
+        this._options.striped = enabled;
+        return this;
+    }
+    /**
+     * Enable animation
+     */
+    animated(enabled = true) {
+        this._options.animated = enabled;
+        return this;
+    }
+    /**
+     * Show/hide value text
+     */
+    showValue(enabled = true) {
+        this._options.showValue = enabled;
+        return this;
+    }
+    /**
+     * Use circle style
+     */
+    circle() {
+        this._options.style = 'circle';
+        return this;
+    }
+    toJSON() {
+        return {
+            _photonType: this._photonType,
+            value: this._value,
+            max: this._max,
+            bars: this._bars,
+            steps: this._steps,
+            options: this._options,
+        };
+    }
+    /**
+     * Render as plain text for MCP clients
+     */
+    toString() {
+        const lines = [];
+        if (this._options.title) {
+            lines.push(this._options.title);
+        }
+        // Steps display
+        if (this._steps.length > 0) {
+            const stepMarkers = this._steps.map(s => {
+                switch (s.status) {
+                    case 'completed': return `[✓] ${s.label}`;
+                    case 'current': return `[●] ${s.label}`;
+                    case 'error': return `[✗] ${s.label}`;
+                    default: return `[ ] ${s.label}`;
+                }
+            });
+            lines.push(stepMarkers.join(' → '));
+            return lines.join('\n');
+        }
+        // Multiple bars
+        if (this._bars.length > 0) {
+            for (const bar of this._bars) {
+                const pct = Math.round((bar.value / (bar.max ?? 100)) * 100);
+                const filled = Math.round(pct / 5);
+                const barStr = '█'.repeat(filled) + '░'.repeat(20 - filled);
+                lines.push(`${bar.label}: [${barStr}] ${pct}%`);
+            }
+            return lines.join('\n');
+        }
+        // Single progress bar
+        const pct = Math.round((this._value / this._max) * 100);
+        const filled = Math.round(pct / 5);
+        const barStr = '█'.repeat(filled) + '░'.repeat(20 - filled);
+        lines.push(`[${barStr}] ${pct}%`);
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=Progress.js.map

package/dist/ui-types/Progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Progress.js","sourceRoot":"","sources":["../../src/ui-types/Progress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AA8BzC,MAAM,OAAO,QAAS,SAAQ,YAAY;IAC/B,WAAW,GAAG,UAAmB,CAAC;IAEnC,KAAK,GAAkB,EAAE,CAAC;IAC1B,MAAM,GAAmB,EAAE,CAAC;IAC5B,MAAM,GAAW,CAAC,CAAC;IACnB,IAAI,GAAW,GAAG,CAAC;IACnB,QAAQ,GAAoB;QAClC,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,IAAI;QACV,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;KACf,CAAC;IAEF;;;OAGG;IACH,YAAY,YAAqC;QAC/C,KAAK,EAAE,CAAC;QACR,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACrC,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;QAC7B,CAAC;aAAM,IAAI,YAAY,EAAE,CAAC;YACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,YAAY,CAAC;QACrC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAW,EAAE,GAAY;QAC7B,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;QAClB,IAAI,GAAG,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAa,EAAE,KAAa,EAAE,OAA+D;QAC/F,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACd,KAAK;YACL,KAAK;YACL,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,GAAG;YACxB,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI;SACtC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAa,EAAE,SAAqB,SAAS,EAAE,OAAiD;QACnG,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,OAAO,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,KAAK;YACL,MAAM;YACN,GAAG,OAAO;SACX,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAwB;QAC3B,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,UAAmB,IAAI;QAC7B,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,UAAmB,IAAI;QAC9B,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,UAAmB,IAAI;QAC/B,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,OAAO,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM;QACJ,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,GAAG,EAAE,IAAI,CAAC,IAAI;YACd,IAAI,EAAE,IAAI,CAAC,KAAK;YAChB,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,OAAO,EAAE,IAAI,CAAC,QAAQ;SACvB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QAED,gBAAgB;QAChB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;gBACtC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;oBACjB,KAAK,WAAW,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;oBAC1C,KAAK,SAAS,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;oBACxC,KAAK,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;oBACtC,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;gBACnC,CAAC;YACH,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACpC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,gBAAgB;QAChB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;gBAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;gBACnC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;gBAC5D,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,MAAM,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,sBAAsB;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC;QAElC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/ui-types/Stats.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Stats - Purpose-driven type for key metrics/KPIs
+ *
+ * Automatically renders as a dashboard-style stats display.
+ *
+ * @example
+ * ```typescript
+ * async overview() {
+ *   return new Stats()
+ *     .stat('Users', 1234, { trend: '+12%', trendUp: true })
+ *     .stat('Revenue', 50000, { format: 'currency', prefix: '$' })
+ *     .stat('Orders', 89, { suffix: 'today' })
+ *     .stat('Conversion', 3.2, { format: 'percent' });
+ * }
+ * ```
+ */
+import { PhotonUIType } from './base.js';
+export type StatFormat = 'number' | 'currency' | 'percent' | 'compact';
+export interface StatItem {
+    label: string;
+    value: number | string;
+    format?: StatFormat;
+    prefix?: string;
+    suffix?: string;
+    trend?: string;
+    trendUp?: boolean;
+    icon?: string;
+    color?: string;
+    description?: string;
+}
+export interface StatsOptions {
+    title?: string;
+    columns?: 2 | 3 | 4 | 6;
+    compact?: boolean;
+    bordered?: boolean;
+    animated?: boolean;
+}
+export declare class Stats extends PhotonUIType {
+    readonly _photonType: "stats";
+    private _stats;
+    private _options;
+    /**
+     * Create a new Stats display
+     */
+    constructor();
+    /**
+     * Add a stat
+     */
+    stat(label: string, value: number | string, options?: Partial<Omit<StatItem, 'label' | 'value'>>): this;
+    /**
+     * Add a currency stat
+     */
+    currency(label: string, value: number, options?: {
+        prefix?: string;
+        trend?: string;
+        trendUp?: boolean;
+    }): this;
+    /**
+     * Add a percentage stat
+     */
+    percent(label: string, value: number, options?: {
+        trend?: string;
+        trendUp?: boolean;
+    }): this;
+    /**
+     * Add a count stat with compact formatting (1.2K, 5M, etc.)
+     */
+    count(label: string, value: number, options?: {
+        trend?: string;
+        trendUp?: boolean;
+        suffix?: string;
+    }): this;
+    /**
+     * Set section title
+     */
+    title(title: string): this;
+    /**
+     * Set number of columns
+     */
+    columns(count: 2 | 3 | 4 | 6): this;
+    /**
+     * Use compact layout
+     */
+    compact(enabled?: boolean): this;
+    /**
+     * Show borders
+     */
+    bordered(enabled?: boolean): this;
+    /**
+     * Enable count-up animation
+     */
+    animated(enabled?: boolean): this;
+    /**
+     * Get stat count
+     */
+    get length(): number;
+    toJSON(): {
+        _photonType: "stats";
+        stats: StatItem[];
+        options: StatsOptions;
+    };
+    /**
+     * Render as plain text for MCP clients
+     */
+    toString(): string;
+    private _formatCompact;
+}
+//# sourceMappingURL=Stats.d.ts.map

package/dist/ui-types/Stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stats.d.ts","sourceRoot":"","sources":["../../src/ui-types/Stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,KAAM,SAAQ,YAAY;IACrC,QAAQ,CAAC,WAAW,EAAG,OAAO,CAAU;IAExC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAId;IAEF;;OAEG;;IAKH;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI;IASvG;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAS9G;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAQ5F;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAO3G;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK1B;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI;IAKnC;;OAEG;IACH,OAAO,CAAC,OAAO,GAAE,OAAc,GAAG,IAAI;IAKtC;;OAEG;IACH,QAAQ,CAAC,OAAO,GAAE,OAAc,GAAG,IAAI;IAKvC;;OAEG;IACH,QAAQ,CAAC,OAAO,GAAE,OAAc,GAAG,IAAI;IAKvC;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,MAAM;;;;;IAQN;;OAEG;IACH,QAAQ,IAAI,MAAM;IAoClB,OAAO,CAAC,cAAc;CAKvB"}

package/dist/ui-types/Stats.js

@@ -0,0 +1,162 @@
+/**
+ * Stats - Purpose-driven type for key metrics/KPIs
+ *
+ * Automatically renders as a dashboard-style stats display.
+ *
+ * @example
+ * ```typescript
+ * async overview() {
+ *   return new Stats()
+ *     .stat('Users', 1234, { trend: '+12%', trendUp: true })
+ *     .stat('Revenue', 50000, { format: 'currency', prefix: '$' })
+ *     .stat('Orders', 89, { suffix: 'today' })
+ *     .stat('Conversion', 3.2, { format: 'percent' });
+ * }
+ * ```
+ */
+import { PhotonUIType } from './base.js';
+export class Stats extends PhotonUIType {
+    _photonType = 'stats';
+    _stats = [];
+    _options = {
+        columns: 4,
+        bordered: true,
+        animated: true,
+    };
+    /**
+     * Create a new Stats display
+     */
+    constructor() {
+        super();
+    }
+    /**
+     * Add a stat
+     */
+    stat(label, value, options) {
+        this._stats.push({
+            label,
+            value,
+            ...options,
+        });
+        return this;
+    }
+    /**
+     * Add a currency stat
+     */
+    currency(label, value, options) {
+        return this.stat(label, value, {
+            format: 'currency',
+            prefix: options?.prefix ?? '$',
+            trend: options?.trend,
+            trendUp: options?.trendUp,
+        });
+    }
+    /**
+     * Add a percentage stat
+     */
+    percent(label, value, options) {
+        return this.stat(label, value, {
+            format: 'percent',
+            suffix: '%',
+            ...options,
+        });
+    }
+    /**
+     * Add a count stat with compact formatting (1.2K, 5M, etc.)
+     */
+    count(label, value, options) {
+        return this.stat(label, value, {
+            format: 'compact',
+            ...options,
+        });
+    }
+    /**
+     * Set section title
+     */
+    title(title) {
+        this._options.title = title;
+        return this;
+    }
+    /**
+     * Set number of columns
+     */
+    columns(count) {
+        this._options.columns = count;
+        return this;
+    }
+    /**
+     * Use compact layout
+     */
+    compact(enabled = true) {
+        this._options.compact = enabled;
+        return this;
+    }
+    /**
+     * Show borders
+     */
+    bordered(enabled = true) {
+        this._options.bordered = enabled;
+        return this;
+    }
+    /**
+     * Enable count-up animation
+     */
+    animated(enabled = true) {
+        this._options.animated = enabled;
+        return this;
+    }
+    /**
+     * Get stat count
+     */
+    get length() {
+        return this._stats.length;
+    }
+    toJSON() {
+        return {
+            _photonType: this._photonType,
+            stats: this._stats,
+            options: this._options,
+        };
+    }
+    /**
+     * Render as plain text for MCP clients
+     */
+    toString() {
+        const lines = [];
+        if (this._options.title) {
+            lines.push(`## ${this._options.title}`, '');
+        }
+        for (const stat of this._stats) {
+            let value = String(stat.value);
+            // Format value
+            if (stat.format === 'currency' || stat.prefix) {
+                value = (stat.prefix ?? '$') + value;
+            }
+            if (stat.format === 'percent' || stat.suffix === '%') {
+                value = value + '%';
+            }
+            else if (stat.suffix) {
+                value = value + ' ' + stat.suffix;
+            }
+            if (stat.format === 'compact' && typeof stat.value === 'number') {
+                value = this._formatCompact(stat.value);
+            }
+            // Add trend
+            let line = `**${stat.label}**: ${value}`;
+            if (stat.trend) {
+                const arrow = stat.trendUp ? '↑' : stat.trendUp === false ? '↓' : '';
+                line += ` (${arrow}${stat.trend})`;
+            }
+            lines.push(line);
+        }
+        return lines.join('\n');
+    }
+    _formatCompact(num) {
+        if (num >= 1_000_000)
+            return (num / 1_000_000).toFixed(1) + 'M';
+        if (num >= 1_000)
+            return (num / 1_000).toFixed(1) + 'K';
+        return String(num);
+    }
+}
+//# sourceMappingURL=Stats.js.map

package/dist/ui-types/Stats.js.map

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

package/dist/ui-types/Table.d.ts

@@ -0,0 +1,206 @@
+/**
+ * Table - Purpose-driven type for tabular data
+ *
+ * Automatically renders as a table UI with sorting, filtering, etc.
+ *
+ * @example Basic usage
+ * ```typescript
+ * async users() {
+ *   return new Table()
+ *     .column('name', 'Name', 'string')
+ *     .column('email', 'Email', 'string')
+ *     .rows(users);
+ * }
+ * ```
+ *
+ * @example With Field system (React Admin-style)
+ * ```typescript
+ * async products() {
+ *   return new Table()
+ *     .fields([
+ *       Field.image('thumbnail', { width: 60, rounded: true }),
+ *       Field.text('name', { link: '/products/{id}' }),
+ *       Field.price('price', { originalSource: 'msrp', currency: 'USD' }),
+ *       Field.rating('rating', { countSource: 'reviewCount' }),
+ *       Field.badge('status', { colors: { active: 'green', draft: 'gray' } }),
+ *       Field.actions([
+ *         { label: 'Edit', method: 'edit', icon: 'pencil' },
+ *         { label: 'Delete', method: 'delete', confirm: true },
+ *       ]),
+ *     ])
+ *     .rows(products);
+ * }
+ * ```
+ */
+import { PhotonUIType } from './base.js';
+import { FieldDefinition, Field } from './Field.js';
+export type ColumnType = 'string' | 'number' | 'boolean' | 'date' | 'currency' | 'link' | 'image' | 'badge';
+export interface TableColumn {
+    key: string;
+    label: string;
+    type: ColumnType;
+    sortable?: boolean;
+    width?: string;
+    align?: 'left' | 'center' | 'right';
+    format?: string;
+}
+export interface TableOptions {
+    title?: string;
+    searchable?: boolean;
+    sortable?: boolean;
+    paginated?: boolean;
+    pageSize?: number;
+    selectable?: boolean;
+    striped?: boolean;
+    compact?: boolean;
+}
+export declare class Table extends PhotonUIType {
+    readonly _photonType: "table";
+    private _columns;
+    private _fields;
+    private _rows;
+    private _options;
+    /**
+     * Create a new Table
+     * @param data Optional initial data (array of objects)
+     */
+    constructor(data?: Record<string, any>[]);
+    /**
+     * Add a column definition
+     */
+    column(key: string, label: string, type?: ColumnType, options?: Partial<TableColumn>): this;
+    /**
+     * Add multiple columns at once
+     */
+    columns(cols: Array<[key: string, label: string, type?: ColumnType] | TableColumn>): this;
+    /**
+     * Add fields using the Field system
+     */
+    fields(fieldDefs: FieldDefinition[]): this;
+    /**
+     * Add a single field
+     */
+    field(fieldDef: FieldDefinition): this;
+    /** Add text field */
+    text(source: string, options?: Parameters<typeof Field.text>[1]): this;
+    /** Add email field */
+    email(source: string, options?: Parameters<typeof Field.email>[1]): this;
+    /** Add URL field */
+    url(source: string, options?: Parameters<typeof Field.url>[1]): this;
+    /** Add phone field */
+    phone(source: string, options?: Parameters<typeof Field.phone>[1]): this;
+    /** Add number field */
+    number(source: string, options?: Parameters<typeof Field.number>[1]): this;
+    /** Add currency field */
+    currency(source: string, options?: Parameters<typeof Field.currency>[1]): this;
+    /** Add percent field */
+    percent(source: string, options?: Parameters<typeof Field.percent>[1]): this;
+    /** Add date field */
+    date(source: string, options?: Parameters<typeof Field.date>[1]): this;
+    /** Add datetime field */
+    datetime(source: string, options?: Parameters<typeof Field.datetime>[1]): this;
+    /** Add boolean field */
+    boolean(source: string, options?: Parameters<typeof Field.boolean>[1]): this;
+    /** Add image field */
+    image(source: string, options?: Parameters<typeof Field.image>[1]): this;
+    /** Add avatar field */
+    avatar(source: string, options?: Parameters<typeof Field.avatar>[1]): this;
+    /** Add badge field */
+    badge(source: string, options?: Parameters<typeof Field.badge>[1]): this;
+    /** Add tags field */
+    tags(source: string, options?: Parameters<typeof Field.tags>[1]): this;
+    /** Add rating field */
+    rating(source: string, options?: Parameters<typeof Field.rating>[1]): this;
+    /** Add price field */
+    price(source: string, options?: Parameters<typeof Field.price>[1]): this;
+    /** Add stock field */
+    stock(source: string, options?: Parameters<typeof Field.stock>[1]): this;
+    /** Add user field */
+    user(source: string, options?: Parameters<typeof Field.user>[1]): this;
+    /** Add reference field */
+    reference(source: string, options?: Parameters<typeof Field.reference>[1]): this;
+    /** Add actions field */
+    actions(items: Parameters<typeof Field.actions>[0], options?: Parameters<typeof Field.actions>[1]): this;
+    /** Add custom field */
+    custom(source: string, render: Parameters<typeof Field.custom>[1], options?: Parameters<typeof Field.custom>[2]): this;
+    /**
+     * Set the table rows
+     */
+    rows(data: Record<string, any>[]): this;
+    /**
+     * Add a single row
+     */
+    row(data: Record<string, any>): this;
+    /**
+     * Set table title
+     */
+    title(title: string): this;
+    /**
+     * Enable/disable search
+     */
+    searchable(enabled?: boolean): this;
+    /**
+     * Enable/disable sorting
+     */
+    sortable(enabled?: boolean): this;
+    /**
+     * Enable pagination
+     */
+    paginated(pageSize?: number): this;
+    /**
+     * Enable row selection
+     */
+    selectable(enabled?: boolean): this;
+    /**
+     * Use striped rows
+     */
+    striped(enabled?: boolean): this;
+    /**
+     * Use compact layout
+     */
+    compact(enabled?: boolean): this;
+    /**
+     * Infer columns from a data row
+     */
+    private _inferColumns;
+    /**
+     * Infer column type from value
+     */
+    private _inferType;
+    /**
+     * Format key to human-readable label
+     */
+    private _formatLabel;
+    /**
+     * Get row count
+     */
+    get length(): number;
+    /**
+     * Check if table is empty
+     */
+    get isEmpty(): boolean;
+    /**
+     * Check if using Field system or legacy columns
+     */
+    private get _useFields();
+    /**
+     * Get effective headers for display
+     */
+    private _getHeaders;
+    /**
+     * Get cell values for a row
+     */
+    private _getCells;
+    toJSON(): {
+        _photonType: "table";
+        columns: TableColumn[];
+        fields: FieldDefinition[];
+        rows: Record<string, any>[];
+        options: TableOptions;
+    };
+    /**
+     * Render as plain text/markdown for MCP clients
+     */
+    toString(): string;
+}
+//# sourceMappingURL=Table.d.ts.map