@pilotiq/pilotiq 0.1.0

package/dist/react/useResizableWidth.js

@@ -0,0 +1,99 @@
+import { useCallback, useEffect, useState } from 'react';
+const DEFAULT_MIN = 240;
+const DEFAULT_MAX = 800;
+const DEFAULT_DEFAULT = 360;
+/**
+ * Clamp a candidate width into `[min, max]`, falling back to `defaultWidth`
+ * when the value can't be coerced to a finite number. Exported so the
+ * resize hook and any test (or one-off seed-from-meta path) share the
+ * same sanitization logic.
+ */
+export function clampPanelWidth(value, opts = {}) {
+    const min = opts.min ?? DEFAULT_MIN;
+    const max = opts.max ?? DEFAULT_MAX;
+    const defaultWidth = opts.defaultWidth ?? DEFAULT_DEFAULT;
+    // Explicit "no value" — null / undefined / empty-string land here from
+    // the localStorage round-trip and should fall back to the default
+    // rather than clamp upward via `Number(null) === 0` → MIN.
+    if (value === null || value === undefined || value === '') {
+        return Math.min(Math.max(defaultWidth, min), max);
+    }
+    const n = typeof value === 'number' ? value : Number(value);
+    if (!Number.isFinite(n))
+        return Math.min(Math.max(defaultWidth, min), max);
+    if (n < min)
+        return min;
+    if (n > max)
+        return max;
+    return n;
+}
+function readStoredWidth(key, opts) {
+    const fallback = clampPanelWidth(opts.defaultWidth, opts);
+    if (key === null)
+        return fallback;
+    if (typeof window === 'undefined')
+        return fallback;
+    try {
+        const raw = window.localStorage?.getItem(key);
+        if (raw === null || raw === undefined)
+            return fallback;
+        return clampPanelWidth(raw, opts);
+    }
+    catch {
+        return fallback;
+    }
+}
+export function useResizableWidth(opts) {
+    const min = opts.min ?? DEFAULT_MIN;
+    const max = opts.max ?? DEFAULT_MAX;
+    const defaultWidth = opts.defaultWidth ?? DEFAULT_DEFAULT;
+    const edge = opts.edge ?? 'left';
+    const [width, setWidthState] = useState(() => readStoredWidth(opts.storageKey, { min, max, defaultWidth }));
+    const [resizing, setResizing] = useState(false);
+    // Re-seed when the storage key changes (e.g. basePath flip on a
+    // multi-panel host). New key, fresh width.
+    useEffect(() => {
+        setWidthState(readStoredWidth(opts.storageKey, { min, max, defaultWidth }));
+        // Intentionally exclude width — we only want this on storageKey flip.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [opts.storageKey]);
+    const setWidth = useCallback((px) => {
+        setWidthState(clampPanelWidth(px, { min, max, defaultWidth }));
+    }, [min, max, defaultWidth]);
+    const onResizeStart = useCallback((e) => {
+        e.preventDefault();
+        const startX = e.clientX;
+        const startWidth = width;
+        setResizing(true);
+        const onMove = (ev) => {
+            const rawDelta = edge === 'left'
+                ? startX - ev.clientX // left-edge handle on right-docked panel
+                : ev.clientX - startX; // right-edge handle on left-docked panel
+            setWidthState(clampPanelWidth(startWidth + rawDelta, { min, max, defaultWidth }));
+        };
+        const onUp = () => {
+            document.removeEventListener('pointermove', onMove);
+            document.removeEventListener('pointerup', onUp);
+            setResizing(false);
+            // Persist once on pointer-up so we don't churn Storage during drag.
+            if (opts.storageKey === null)
+                return;
+            try {
+                // Read latest width via a setState callback — closure captured
+                // `startWidth` is stale by the time we reach pointerup.
+                setWidthState((w) => {
+                    try {
+                        window.localStorage?.setItem(opts.storageKey, String(w));
+                    }
+                    catch { /* private mode / quota — width still works in-session */ }
+                    return w;
+                });
+            }
+            catch { /* SSR / no window */ }
+        };
+        document.addEventListener('pointermove', onMove);
+        document.addEventListener('pointerup', onUp);
+    }, [width, edge, min, max, defaultWidth, opts.storageKey]);
+    return { width, setWidth, onResizeStart, resizing };
+}
+//# sourceMappingURL=useResizableWidth.js.map

package/dist/react/useResizableWidth.js.map

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

package/dist/react/utils.d.ts

@@ -0,0 +1,3 @@
+import { type ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/react/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/react/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,MAAM,CAAA;AAG5C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC"}

package/dist/react/utils.js

@@ -0,0 +1,6 @@
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}
+//# sourceMappingURL=utils.js.map

package/dist/react/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/react/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,MAAM,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAExC,MAAM,UAAU,EAAE,CAAC,GAAG,MAAoB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;AAC9B,CAAC"}

package/dist/react/widgetRegistry.d.ts

@@ -0,0 +1,33 @@
+import type { ComponentType } from 'react';
+import type { ElementMeta } from '../schema/Element.js';
+/**
+ * Plan #15 Phase C — runtime registry for widget renderers (Chart,
+ * future Table-widget slim mode, etc.). Mirrors the field-renderer
+ * registry pattern so adapter packages can plug their renderer in
+ * without forcing pilotiq core to import their dependencies.
+ *
+ * Built-in widget types (`stats`, `view`) are dispatched directly inside
+ * SchemaRenderer's switch. Adapter-package widgets (`chart` from
+ * `@pilotiq/recharts`) register here and SchemaRenderer's default case
+ * consults the registry before falling through.
+ *
+ * Call once at app boot, client-side:
+ *
+ *   import { registerChartRenderer } from '@pilotiq/recharts'
+ *   registerChartRenderer()
+ *
+ * Without the boot call, SchemaRenderer surfaces a clear "package not
+ * registered" error at the call site rather than silently rendering
+ * nothing.
+ */
+export interface WidgetRendererProps {
+    meta: ElementMeta;
+}
+/** Register a renderer for a widget element `type`. Re-registering
+ *  overwrites, which is convenient for HMR. */
+export declare function registerWidgetRenderer(type: string, Component: ComponentType<WidgetRendererProps>): void;
+/** Look up a registered renderer; `undefined` for unregistered types. */
+export declare function getWidgetRenderer(type: string): ComponentType<WidgetRendererProps> | undefined;
+/** Test-only — clear the registry. Not part of the public surface. */
+export declare function _resetWidgetRendererRegistryForTests(): void;
+//# sourceMappingURL=widgetRegistry.d.ts.map

package/dist/react/widgetRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgetRegistry.d.ts","sourceRoot":"","sources":["../../src/react/widgetRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,CAAA;CAClB;AAID;+CAC+C;AAC/C,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,aAAa,CAAC,mBAAmB,CAAC,GAC5C,IAAI,CAEN;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,GACX,aAAa,CAAC,mBAAmB,CAAC,GAAG,SAAS,CAEhD;AAED,sEAAsE;AACtE,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D"}

package/dist/react/widgetRegistry.js

@@ -0,0 +1,15 @@
+const renderers = new Map();
+/** Register a renderer for a widget element `type`. Re-registering
+ *  overwrites, which is convenient for HMR. */
+export function registerWidgetRenderer(type, Component) {
+    renderers.set(type, Component);
+}
+/** Look up a registered renderer; `undefined` for unregistered types. */
+export function getWidgetRenderer(type) {
+    return renderers.get(type);
+}
+/** Test-only — clear the registry. Not part of the public surface. */
+export function _resetWidgetRendererRegistryForTests() {
+    renderers.clear();
+}
+//# sourceMappingURL=widgetRegistry.js.map

package/dist/react/widgetRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgetRegistry.js","sourceRoot":"","sources":["../../src/react/widgetRegistry.ts"],"names":[],"mappings":"AA4BA,MAAM,SAAS,GAAG,IAAI,GAAG,EAA8C,CAAA;AAEvE;+CAC+C;AAC/C,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,SAA6C;IAE7C,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;AAChC,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,iBAAiB,CAC/B,IAAY;IAEZ,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AAC5B,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,oCAAoC;IAClD,SAAS,CAAC,KAAK,EAAE,CAAA;AACnB,CAAC"}

package/dist/react/widgets/StatsOverviewRenderer.d.ts

@@ -0,0 +1,6 @@
+import type { ElementMeta } from '../../schema/Element.js';
+export interface StatsOverviewRendererProps {
+    meta: ElementMeta;
+}
+export declare function StatsOverviewRenderer({ meta }: StatsOverviewRendererProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=StatsOverviewRenderer.d.ts.map

package/dist/react/widgets/StatsOverviewRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatsOverviewRenderer.d.ts","sourceRoot":"","sources":["../../../src/react/widgets/StatsOverviewRenderer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAyC1D,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,WAAW,CAAA;CAClB;AAED,wBAAgB,qBAAqB,CAAC,EAAE,IAAI,EAAE,EAAE,0BAA0B,kDAiBzE"}

package/dist/react/widgets/StatsOverviewRenderer.js

@@ -0,0 +1,124 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useWidgetData } from '../WidgetDataContext.js';
+import { useIconFor } from '../icon-context.js';
+/**
+ * Plan #15 Phase B — `StatsOverviewRenderer`.
+ *
+ * Reads the resolved `_widgetData[id]` payload through `useWidgetData`,
+ * lays out a card grid keyed off `meta.columns`, and falls back to a
+ * skeleton row while the lazy fetch is in flight.
+ */
+const COLOR_CARD_CLASSES = {
+    default: 'border-border',
+    primary: 'border-primary/30',
+    success: 'border-emerald-500/40',
+    warning: 'border-amber-500/40',
+    destructive: 'border-red-500/40',
+    info: 'border-blue-500/40',
+};
+const COLOR_VALUE_CLASSES = {
+    default: 'text-foreground',
+    primary: 'text-primary',
+    success: 'text-emerald-600 dark:text-emerald-400',
+    warning: 'text-amber-600 dark:text-amber-400',
+    destructive: 'text-red-600 dark:text-red-400',
+    info: 'text-blue-600 dark:text-blue-400',
+};
+const COLOR_SPARKLINE_CLASSES = {
+    default: 'text-muted-foreground',
+    primary: 'text-primary',
+    success: 'text-emerald-500',
+    warning: 'text-amber-500',
+    destructive: 'text-red-500',
+    info: 'text-blue-500',
+};
+export function StatsOverviewRenderer({ meta }) {
+    const columns = clampColumns(meta['columns']);
+    const { data, error, isLoading } = useWidgetData(meta);
+    if (isLoading)
+        return _jsx(StatsSkeleton, { columns: columns });
+    if (error)
+        return _jsx(StatsError, { message: error, columns: columns });
+    const stats = readStats(data);
+    if (stats.length === 0)
+        return null;
+    return (_jsx("div", { className: "grid gap-4", style: { gridTemplateColumns: `repeat(${columns}, minmax(0, 1fr))` }, children: stats.map((s, i) => _jsx(StatCard, { stat: s }, i)) }));
+}
+function clampColumns(raw) {
+    const n = Number(raw);
+    if (!Number.isFinite(n) || n <= 0)
+        return 3;
+    return Math.min(6, Math.max(1, Math.floor(n)));
+}
+function readStats(data) {
+    if (!data || typeof data !== 'object')
+        return [];
+    const stats = data.stats;
+    return Array.isArray(stats) ? stats : [];
+}
+function StatCard({ stat }) {
+    const color = stat.color ?? 'default';
+    const cardClass = `rounded-xl border bg-card p-5 shadow-sm transition ${COLOR_CARD_CLASSES[color]}`;
+    const valueClass = `text-3xl font-semibold tracking-tight tabular-nums ${COLOR_VALUE_CLASSES[color]}`;
+    const Inner = (_jsxs("div", { className: "flex flex-col gap-2", children: [_jsxs("div", { className: "flex items-start justify-between gap-3", children: [_jsx("p", { className: "text-sm font-medium text-muted-foreground", children: stat.label }), stat.icon && _jsx(StatIcon, { name: stat.icon, className: `size-5 ${COLOR_VALUE_CLASSES[color]}` })] }), _jsx("p", { className: valueClass, children: formatValue(stat.value) }), (stat.description || stat.descriptionIcon) && (_jsx(StatDescription, { stat: stat })), stat.chart && stat.chart.length > 0 && (_jsx(Sparkline, { values: stat.chart, className: COLOR_SPARKLINE_CLASSES[color] }))] }));
+    const extraAttrs = (stat.extraAttributes ?? {});
+    if (stat.url) {
+        return (_jsx("a", { href: stat.url, target: stat.openInNewTab ? '_blank' : undefined, rel: stat.openInNewTab ? 'noopener noreferrer' : undefined, className: `${cardClass} block hover:border-foreground/30 hover:shadow-md`, ...extraAttrs, children: Inner }));
+    }
+    return _jsx("div", { className: cardClass, ...extraAttrs, children: Inner });
+}
+function formatValue(v) {
+    if (v === null || v === undefined)
+        return '—';
+    if (typeof v === 'number')
+        return v.toLocaleString();
+    return String(v);
+}
+function StatDescription({ stat }) {
+    const icon = stat.descriptionIcon;
+    const before = icon?.position === 'before';
+    const text = stat.description;
+    return (_jsxs("div", { className: "flex items-center gap-1.5 text-xs text-muted-foreground", children: [icon && before && _jsx(StatIcon, { name: icon.name, className: "size-3.5" }), text && _jsx("span", { children: text }), icon && !before && _jsx(StatIcon, { name: icon.name, className: "size-3.5" })] }));
+}
+function StatIcon({ name, className }) {
+    // Stats ship icons as registry-name strings; mirror Resource.icon /
+    // panel chrome lookup so the same registry serves both. The lookup
+    // accepts a `SerializedIcon` shape — wrap the bare string.
+    const serialized = name;
+    const Icon = useIconFor(serialized);
+    if (!Icon)
+        return null;
+    return _jsx(Icon, { className: className, "aria-hidden": true });
+}
+/**
+ * Inline-SVG sparkline. Sized fluidly via `viewBox` + `preserveAspectRatio`
+ * — the parent card sets the rendered height. No deps, no chart lib.
+ *
+ * Single-value series renders a flat horizontal line at mid-height; flat
+ * series (all values equal) likewise — avoids divide-by-zero when the
+ * range collapses.
+ */
+function Sparkline({ values, className }) {
+    if (values.length === 0)
+        return null;
+    const W = 100;
+    const H = 30;
+    const min = Math.min(...values);
+    const max = Math.max(...values);
+    const range = max - min || 1;
+    const stepX = values.length > 1 ? W / (values.length - 1) : 0;
+    const points = values.map((v, i) => {
+        const x = stepX === 0 ? W / 2 : i * stepX;
+        const y = H - ((v - min) / range) * H;
+        return `${x.toFixed(2)},${y.toFixed(2)}`;
+    }).join(' ');
+    return (_jsx("svg", { viewBox: `0 0 ${W} ${H}`, preserveAspectRatio: "none", className: `mt-2 h-8 w-full ${className}`, "aria-hidden": true, children: _jsx("polyline", { fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", points: points }) }));
+}
+// ─── Skeleton + error ─────────────────────────────────────
+function StatsSkeleton({ columns }) {
+    return (_jsx("div", { className: "grid gap-4", style: { gridTemplateColumns: `repeat(${columns}, minmax(0, 1fr))` }, children: Array.from({ length: columns }, (_, i) => (_jsx("div", { className: "rounded-xl border border-border bg-card p-5 shadow-sm", children: _jsxs("div", { className: "flex flex-col gap-3", children: [_jsx("div", { className: "h-4 w-24 rounded bg-muted animate-pulse" }), _jsx("div", { className: "h-8 w-20 rounded bg-muted animate-pulse" }), _jsx("div", { className: "h-3 w-32 rounded bg-muted animate-pulse" })] }) }, i))) }));
+}
+function StatsError({ message, columns }) {
+    return (_jsx("div", { className: "grid gap-4", style: { gridTemplateColumns: `repeat(${columns}, minmax(0, 1fr))` }, children: _jsxs("div", { className: "rounded-xl border border-red-500/40 bg-red-50 p-5 text-sm text-red-700 dark:bg-red-950/30 dark:text-red-300", children: ["Failed to load stats: ", message] }) }));
+}
+//# sourceMappingURL=StatsOverviewRenderer.js.map

package/dist/react/widgets/StatsOverviewRenderer.js.map

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

package/dist/react/widgets/TableWidgetRenderer.d.ts

@@ -0,0 +1,6 @@
+import type { ElementMeta } from '../../schema/Element.js';
+export interface TableWidgetRendererProps {
+    meta: ElementMeta;
+}
+export declare function TableWidgetRenderer({ meta }: TableWidgetRendererProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=TableWidgetRenderer.d.ts.map

package/dist/react/widgets/TableWidgetRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableWidgetRenderer.d.ts","sourceRoot":"","sources":["../../../src/react/widgets/TableWidgetRenderer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AA0B1D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,WAAW,CAAA;CAClB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,IAAI,EAAE,EAAE,wBAAwB,2CAiCrE"}

package/dist/react/widgets/TableWidgetRenderer.js

@@ -0,0 +1,123 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useWidgetData } from '../WidgetDataContext.js';
+export function TableWidgetRenderer({ meta }) {
+    const label = typeof meta['label'] === 'string' ? meta['label'] : undefined;
+    const viewAllUrl = typeof meta['viewAllUrl'] === 'string' ? meta['viewAllUrl'] : undefined;
+    const columns = readColumns(meta['columns']);
+    const { data, error, isLoading } = useWidgetData(meta);
+    return (_jsxs("div", { className: "rounded-xl border border-border bg-card shadow-sm", children: [(label || viewAllUrl) && (_jsxs("div", { className: "flex items-center justify-between gap-3 border-b border-border px-4 py-3", children: [label
+                        ? _jsx("h3", { className: "text-sm font-medium text-foreground", children: label })
+                        : _jsx("span", {}), viewAllUrl && (_jsx("a", { href: viewAllUrl, className: "text-xs font-medium text-primary hover:underline", children: "View all \u2192" }))] })), _jsx("div", { className: "overflow-x-auto", children: isLoading
+                    ? _jsx(TableSkeleton, { columns: columns })
+                    : error
+                        ? _jsx(TableError, { message: error })
+                        : _jsx(TableBody, { columns: columns, rows: readRows(data) }) })] }));
+}
+function readColumns(raw) {
+    return Array.isArray(raw) ? raw : [];
+}
+function readRows(data) {
+    if (!data || typeof data !== 'object')
+        return [];
+    const rows = data.rows;
+    return Array.isArray(rows) ? rows : [];
+}
+function TableBody({ columns, rows }) {
+    if (columns.length === 0) {
+        return _jsx("p", { className: "px-4 py-6 text-sm text-muted-foreground", children: "No columns configured." });
+    }
+    if (rows.length === 0) {
+        return _jsx("p", { className: "px-4 py-6 text-sm text-muted-foreground", children: "No records to display." });
+    }
+    return (_jsxs("table", { className: "w-full text-sm", children: [_jsx("thead", { className: "border-b border-border bg-muted/30", children: _jsx("tr", { children: columns.map(col => (_jsx("th", { className: `px-4 py-2 text-left font-medium text-muted-foreground ${alignClass(col.alignment)}`, style: col.width ? { width: col.width } : undefined, children: col.label }, col.name))) }) }), _jsx("tbody", { children: rows.map((row, i) => (_jsx("tr", { className: "border-b border-border last:border-0", children: columns.map(col => (_jsx("td", { className: `px-4 py-2 ${alignClass(col.alignment)}`, children: renderCell(row[col.name], col, row) }, col.name))) }, i))) })] }));
+}
+function alignClass(a) {
+    if (a === 'center')
+        return 'text-center';
+    if (a === 'end')
+        return 'text-right';
+    return 'text-left';
+}
+/** Slim cell renderer — handles per-row `_formatted` overrides + the
+ *  built-in `format` spec. Falls back to a plain stringification for
+ *  unhandled `columnType`s; richer painting (badges, icons, images)
+ *  belongs to the full `TableRenderer` for the Resource list page. */
+function renderCell(value, col, row) {
+    const fallback = col.default ?? '—';
+    const formatted = row['_formatted']?.[col.name];
+    if (formatted !== undefined && formatted !== '')
+        return formatted;
+    if (value === null || value === undefined || value === '') {
+        return _jsx("span", { className: "text-muted-foreground", children: fallback });
+    }
+    const fmt = col.format;
+    if (fmt)
+        return applyFormat(value, fmt);
+    if (value instanceof Date) {
+        return value.toLocaleString(undefined, { dateStyle: 'medium', timeStyle: 'short' });
+    }
+    if (typeof value === 'boolean')
+        return value ? 'Yes' : 'No';
+    if (typeof value === 'object')
+        return JSON.stringify(value);
+    return String(value);
+}
+function applyFormat(value, fmt) {
+    switch (fmt.kind) {
+        case 'dateTime': {
+            const d = value instanceof Date ? value : new Date(String(value));
+            if (Number.isNaN(d.getTime()))
+                return String(value);
+            return d.toLocaleString(undefined, { dateStyle: 'medium', timeStyle: 'short' });
+        }
+        case 'since': {
+            const d = value instanceof Date ? value : new Date(String(value));
+            if (Number.isNaN(d.getTime()))
+                return String(value);
+            const seconds = Math.round((Date.now() - d.getTime()) / 1000);
+            if (seconds < 60)
+                return `${seconds}s ago`;
+            if (seconds < 3600)
+                return `${Math.floor(seconds / 60)}m ago`;
+            if (seconds < 86_400)
+                return `${Math.floor(seconds / 3600)}h ago`;
+            return `${Math.floor(seconds / 86_400)}d ago`;
+        }
+        case 'money': {
+            const n = Number(value);
+            if (!Number.isFinite(n))
+                return String(value);
+            return new Intl.NumberFormat(fmt.locale, { style: 'currency', currency: fmt.currency }).format(n);
+        }
+        case 'numeric': {
+            const n = Number(value);
+            if (!Number.isFinite(n))
+                return String(value);
+            const decimals = fmt.decimals ?? 0;
+            return new Intl.NumberFormat(fmt.locale, {
+                minimumFractionDigits: decimals,
+                maximumFractionDigits: decimals,
+            }).format(n);
+        }
+        case 'limit': {
+            const s = String(value);
+            return s.length > fmt.chars ? `${s.slice(0, fmt.chars)}…` : s;
+        }
+        case 'words': {
+            const s = String(value).trim();
+            if (s.length === 0)
+                return s;
+            const tokens = s.split(/\s+/);
+            return tokens.length > fmt.words ? `${tokens.slice(0, fmt.words).join(' ')}…` : s;
+        }
+    }
+}
+// ─── Skeleton + error ─────────────────────────────────────
+function TableSkeleton({ columns }) {
+    const cols = Math.max(1, columns.length || 3);
+    return (_jsxs("table", { className: "w-full text-sm", children: [_jsx("thead", { className: "border-b border-border bg-muted/30", children: _jsx("tr", { children: Array.from({ length: cols }, (_, i) => (_jsx("th", { className: "px-4 py-2", children: _jsx("div", { className: "h-3 w-16 rounded bg-muted animate-pulse" }) }, i))) }) }), _jsx("tbody", { children: Array.from({ length: 3 }, (_, r) => (_jsx("tr", { className: "border-b border-border last:border-0", children: Array.from({ length: cols }, (_, c) => (_jsx("td", { className: "px-4 py-3", children: _jsx("div", { className: "h-3 w-full max-w-[10rem] rounded bg-muted animate-pulse" }) }, c))) }, r))) })] }));
+}
+function TableError({ message }) {
+    return (_jsxs("div", { className: "border-t border-red-500/40 bg-red-50 px-4 py-3 text-sm text-red-700 dark:bg-red-950/30 dark:text-red-300", children: ["Failed to load table: ", message] }));
+}
+//# sourceMappingURL=TableWidgetRenderer.js.map

package/dist/react/widgets/TableWidgetRenderer.js.map

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

package/dist/react/widgets/ViewRenderer.d.ts

@@ -0,0 +1,16 @@
+import type { ElementMeta } from '../../schema/Element.js';
+/**
+ * Plan #15 — `ViewRenderer`. Mounts the user-supplied React component
+ * registered under `meta.component` via `registerWidgetComponents()`,
+ * passing `data` resolved from `View.getData(ctx)` (or fetched lazily
+ * via the polling endpoint).
+ *
+ * Failure modes paint inline error panels rather than throwing — a
+ * misnamed `View.component('Foo')` in production should surface a clear
+ * pointer at the registration step, not a blank widget slot.
+ */
+export interface ViewRendererProps {
+    meta: ElementMeta;
+}
+export declare function ViewRenderer({ meta }: ViewRendererProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ViewRenderer.d.ts.map

package/dist/react/widgets/ViewRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewRenderer.d.ts","sourceRoot":"","sources":["../../../src/react/widgets/ViewRenderer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAI1D;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAA;CAClB;AAED,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE,iBAAiB,2CA8BvD"}

package/dist/react/widgets/ViewRenderer.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useWidgetData } from '../WidgetDataContext.js';
+import { getWidgetComponent } from '../../widgets/registry.js';
+export function ViewRenderer({ meta }) {
+    const componentName = String(meta['component'] ?? '');
+    const { data, error, isLoading } = useWidgetData(meta);
+    if (!componentName) {
+        return (_jsxs(ViewError, { children: ["View widget is missing its ", _jsx("code", { className: "font-mono", children: "component" }), " name \u2014 set ", _jsx("code", { className: "font-mono", children: "static componentName = '...'" }), " on the subclass or call ", _jsx("code", { className: "font-mono", children: ".component('...')" }), " in the fluent form."] }));
+    }
+    const Component = getWidgetComponent(componentName);
+    if (!Component) {
+        return (_jsxs(ViewError, { children: ["No component registered under name ", _jsx("code", { className: "font-mono", children: componentName }), ". Register it at app boot:", _jsx("pre", { className: "mt-2 overflow-x-auto rounded bg-amber-100/60 p-2 text-xs dark:bg-amber-900/30", children: `import { registerWidgetComponents } from '@pilotiq/pilotiq/widgets'\nregisterWidgetComponents({ ${componentName}: ${componentName} })` })] }));
+    }
+    if (isLoading)
+        return _jsx(ViewSkeleton, {});
+    if (error)
+        return _jsx(ViewError, { children: error });
+    return _jsx(Component, { data: data });
+}
+function ViewSkeleton() {
+    return (_jsx("div", { role: "status", "aria-label": "Loading", className: "h-32 animate-pulse rounded-md border border-border bg-muted/40" }));
+}
+function ViewError({ children }) {
+    return (_jsx("div", { role: "alert", className: "rounded-md border border-amber-500/40 bg-amber-50 p-3 text-sm text-amber-800 dark:bg-amber-950/30 dark:text-amber-200", children: children }));
+}
+//# sourceMappingURL=ViewRenderer.js.map

package/dist/react/widgets/ViewRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewRenderer.js","sourceRoot":"","sources":["../../../src/react/widgets/ViewRenderer.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAgB9D,MAAM,UAAU,YAAY,CAAC,EAAE,IAAI,EAAqB;IACtD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAA;IACrD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,aAAa,CAAC,IAA2C,CAAC,CAAA;IAE7F,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,CACL,MAAC,SAAS,8CACmB,eAAM,SAAS,EAAC,WAAW,0BAAiB,uBACnE,eAAM,SAAS,EAAC,WAAW,6CAAoC,+BAClD,eAAM,SAAS,EAAC,WAAW,kCAAyB,4BAE3D,CACb,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAA;IACnD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CACL,MAAC,SAAS,sDAC2B,eAAM,SAAS,EAAC,WAAW,YAAE,aAAa,GAAQ,gCAErF,cAAK,SAAS,EAAC,+EAA+E,YAAE,mGAAmG,aAAa,KAAK,aAAa,KAAK,GAAO,IACpO,CACb,CAAA;IACH,CAAC;IAED,IAAI,SAAS;QAAE,OAAO,KAAC,YAAY,KAAG,CAAA;IACtC,IAAI,KAAK;QAAM,OAAO,KAAC,SAAS,cAAE,KAAK,GAAa,CAAA;IAEpD,OAAO,KAAC,SAAS,IAAC,IAAI,EAAE,IAAI,GAAI,CAAA;AAClC,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,CACL,cACE,IAAI,EAAC,QAAQ,gBACF,SAAS,EACpB,SAAS,EAAC,gEAAgE,GAC1E,CACH,CAAA;AACH,CAAC;AAED,SAAS,SAAS,CAAC,EAAE,QAAQ,EAAiC;IAC5D,OAAO,CACL,cACE,IAAI,EAAC,OAAO,EACZ,SAAS,EAAC,uHAAuH,YAEhI,QAAQ,GACL,CACP,CAAA;AACH,CAAC"}

package/dist/richtext/index.d.ts

@@ -0,0 +1,2 @@
+export { registerRichTextRenderer, getRichTextRenderer, getRichTextDetector, tryRenderRichText, type RichTextRenderer, type RichTextDetector, } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/richtext/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/richtext/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAA"}

package/dist/richtext/index.js

@@ -0,0 +1,2 @@
+export { registerRichTextRenderer, getRichTextRenderer, getRichTextDetector, tryRenderRichText, } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/richtext/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/richtext/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,GAGlB,MAAM,eAAe,CAAA"}

package/dist/richtext/registry.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Server-side rich-text renderer registry.
+ *
+ * Pilotiq core has no runtime dep on `@pilotiq/tiptap` (or any other
+ * adapter), but display surfaces — `TextEntry`, `TextColumn` — want to
+ * convert stored Tiptap content to HTML at meta-build time so views and
+ * tables render finished markup without shipping the editor parser to
+ * the client.
+ *
+ * Adapter packages (`@pilotiq/tiptap` ships one via `registerTiptap`)
+ * register their renderer here. Display surfaces auto-detect richtext
+ * values (`isRichTextValue(v)` returns `true`) and pipe them through
+ * `getRichTextRenderer()` when one is registered. No registration → no
+ * auto-render; the surface falls back to its default formatter.
+ *
+ * Mirrors the `registerWidgetComponents / registerEntryComponents`
+ * pattern — runtime, name-less, single-renderer registry (no plurality
+ * needed: a panel only loads one editor adapter).
+ */
+/**
+ * Pure conversion from Tiptap content to HTML. Implementations must be
+ * server-safe (no DOM, no Tiptap runtime) and synchronous.
+ */
+export type RichTextRenderer = (content: unknown) => string;
+/**
+ * Conservative detector — returns `true` only when the value is
+ * recognizably Tiptap content. Adapter packages provide their own to
+ * keep core agnostic to the storage shape.
+ */
+export type RichTextDetector = (value: unknown) => boolean;
+/**
+ * Register a richtext renderer + detector. Call once at app boot from a
+ * bootstrap provider (or via `registerTiptap(panel)`); subsequent calls
+ * overwrite the prior registration.
+ *
+ * @example
+ *   import { registerRichTextRenderer } from '@pilotiq/pilotiq/richtext'
+ *   import { renderRichTextToHtml, isRichTextValue } from '@pilotiq/tiptap/render'
+ *   registerRichTextRenderer(renderRichTextToHtml, isRichTextValue)
+ */
+export declare function registerRichTextRenderer(render: RichTextRenderer, detect: RichTextDetector): void;
+/** Get the registered renderer, or `undefined` when none has been wired. */
+export declare function getRichTextRenderer(): RichTextRenderer | undefined;
+/** Get the registered detector. Returns `undefined` when no renderer is
+ *  registered — display surfaces should fall through to default formatting. */
+export declare function getRichTextDetector(): RichTextDetector | undefined;
+/**
+ * Combined helper — when a renderer is registered AND the value passes
+ * its detector, render and return the HTML; otherwise return `null` so
+ * the caller falls back to its own formatter chain.
+ */
+export declare function tryRenderRichText(value: unknown): string | null;
+/** Test-only: clear the registry between tests. Not part of the public surface. */
+export declare function _resetRichTextRegistryForTests(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/richtext/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/richtext/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAA;AAE3D;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;AAS1D;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAEN;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,SAAS,CAElE;AAED;+EAC+E;AAC/E,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,SAAS,CAElE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAU/D;AAED,mFAAmF;AACnF,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}