@maxhealth.tech/prefab 0.1.2

package/dist/core/component.js

@@ -0,0 +1,122 @@
+/**
+ * Core component base classes.
+ *
+ * Every UI component inherits from Component. Container components
+ * (Column, Row, Card, etc.) extend ContainerComponent which adds children.
+ * StatefulMixin adds name/value tracking for form elements.
+ *
+ * Serialization: Components produce a flat JSON tree matching the
+ * Python prefab-ui wire format:
+ *   { type: "Button", label: "Hi", variant: "default" }
+ *   { type: "Column", gap: 4, children: [...] }
+ */
+// ── Helpers ──────────────────────────────────────────────────────────────────
+/** Convert snake_case or camelCase prop name to JSON camelCase */
+function toCamelCase(key) {
+    return key.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+/** Serialize a value for JSON output */
+export function serializeValue(v) {
+    if (v === undefined || v === null)
+        return undefined;
+    if (typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean')
+        return v;
+    if (v instanceof Component)
+        return v.toJSON();
+    if (typeof v === 'object' && 'toJSON' in v && typeof v.toJSON === 'function') {
+        return v.toJSON();
+    }
+    if (Array.isArray(v))
+        return v.map(serializeValue);
+    if (typeof v === 'object') {
+        const result = {};
+        for (const [k, val] of Object.entries(v)) {
+            const serialized = serializeValue(val);
+            if (serialized !== undefined)
+                result[toCamelCase(k)] = serialized;
+        }
+        return result;
+    }
+    return v;
+}
+export class Component {
+    componentType;
+    id;
+    cssClass;
+    onMount;
+    constructor(type, props) {
+        this.componentType = type;
+        if (props?.id)
+            this.id = props.id;
+        if (props?.cssClass)
+            this.cssClass = props.cssClass;
+        if (props?.onMount)
+            this.onMount = props.onMount;
+    }
+    /** Override in subclasses to add component-specific props */
+    getProps() {
+        return {};
+    }
+    toJSON() {
+        const json = { type: this.componentType };
+        if (this.id)
+            json.id = this.id;
+        if (this.cssClass)
+            json.cssClass = this.cssClass;
+        if (this.onMount) {
+            json.onMount = Array.isArray(this.onMount)
+                ? this.onMount.map(a => a.toJSON())
+                : this.onMount.toJSON();
+        }
+        // Merge component-specific props
+        const props = this.getProps();
+        for (const [key, value] of Object.entries(props)) {
+            const serialized = serializeValue(value);
+            if (serialized !== undefined) {
+                json[toCamelCase(key)] = serialized;
+            }
+        }
+        return json;
+    }
+}
+export class ContainerComponent extends Component {
+    children;
+    constructor(type, props) {
+        super(type, props);
+        this.children = props?.children ?? [];
+    }
+    toJSON() {
+        const json = super.toJSON();
+        if (this.children.length > 0) {
+            json.children = this.children.map(c => c.toJSON());
+        }
+        return json;
+    }
+}
+/**
+ * Base class for stateful form components (Input, Checkbox, Select, etc.).
+ * Provides a `name` for state binding and an optional `onChange` action.
+ */
+export class StatefulComponent extends Component {
+    name;
+    value;
+    onChange;
+    constructor(type, props) {
+        super(type, props);
+        this.name = props.name;
+        this.value = props.value;
+        this.onChange = props.onChange;
+    }
+    getProps() {
+        return {
+            name: this.name,
+            ...(this.value !== undefined && { value: this.value }),
+            ...(this.onChange && {
+                onChange: Array.isArray(this.onChange)
+                    ? this.onChange.map(a => a.toJSON())
+                    : this.onChange.toJSON(),
+            }),
+        };
+    }
+}
+//# sourceMappingURL=component.js.map

package/dist/core/component.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,5 @@
+export { Component, ContainerComponent, StatefulComponent, serializeValue } from './component.js';
+export type { ComponentJSON, ComponentProps, ContainerProps, StatefulProps, RxStr } from './component.js';
+export { validateWireFormat, isValidWireFormat } from './validate.js';
+export type { ValidationError, ValidationResult } from './validate.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACjG,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACzG,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACrE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA"}

package/dist/core/index.js

@@ -0,0 +1,3 @@
+export { Component, ContainerComponent, StatefulComponent, serializeValue } from './component.js';
+export { validateWireFormat, isValidWireFormat } from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEjG,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}

package/dist/core/validate.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Wire format validation — runtime schema checks for $prefab wire data.
+ *
+ * Validates that incoming JSON conforms to the $prefab wire format
+ * and returns structured error information.
+ */
+import type { PrefabWireFormat } from '../app.js';
+export interface ValidationError {
+    path: string;
+    message: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+/**
+ * Validate a wire format payload. Returns `{ valid: true, errors: [] }` if OK,
+ * or `{ valid: false, errors: [...] }` with details about what's wrong.
+ *
+ * @param data - The raw parsed JSON to validate
+ * @param opts - Optional: `strict` mode warns on unknown component types
+ */
+export declare function validateWireFormat(data: unknown, opts?: {
+    strict?: boolean;
+}): ValidationResult;
+/**
+ * Quick boolean check — returns true if data looks like valid $prefab wire format.
+ */
+export declare function isValidWireFormat(data: unknown): data is PrefabWireFormat;
+//# sourceMappingURL=validate.d.ts.map

package/dist/core/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/core/validate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAIjD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B;AA0CD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9B,gBAAgB,CA+DlB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,gBAAgB,CAEzE"}

package/dist/core/validate.js

@@ -0,0 +1,178 @@
+/**
+ * Wire format validation — runtime schema checks for $prefab wire data.
+ *
+ * Validates that incoming JSON conforms to the $prefab wire format
+ * and returns structured error information.
+ */
+// ── Known component types (all registered) ───────────────────────────────────
+const KNOWN_TYPES = new Set([
+    // Layout
+    'Column', 'Row', 'Grid', 'GridItem', 'Container', 'Div', 'Span',
+    'Dashboard', 'DashboardItem', 'Pages', 'Page',
+    // Typography
+    'Heading', 'H1', 'H2', 'H3', 'H4', 'Text', 'P', 'Lead', 'Large',
+    'Small', 'Muted', 'BlockQuote', 'Label', 'Link', 'Code', 'Markdown', 'Kbd',
+    // Card
+    'Card', 'CardHeader', 'CardTitle', 'CardDescription', 'CardContent', 'CardFooter',
+    // Data
+    'DataTable', 'Badge', 'Dot', 'Metric', 'Ring', 'Progress', 'Separator', 'Loader', 'Icon',
+    // Table
+    'Table', 'TableHead', 'TableBody', 'TableFooter', 'TableRow',
+    'TableHeader', 'TableCell', 'TableCaption', 'ExpandableRow',
+    // Form
+    'Form', 'Input', 'Textarea', 'Button', 'ButtonGroup',
+    'Select', 'SelectOption', 'SelectGroup', 'SelectLabel', 'SelectSeparator',
+    'Checkbox', 'Switch', 'Slider',
+    'Radio', 'RadioGroup',
+    'Combobox', 'ComboboxOption', 'ComboboxGroup', 'ComboboxLabel', 'ComboboxSeparator',
+    'Calendar', 'DatePicker',
+    'Field', 'FieldTitle', 'FieldDescription', 'FieldContent', 'FieldError', 'ChoiceCard',
+    // Interactive
+    'Tabs', 'Tab', 'Accordion', 'AccordionItem', 'Dialog', 'Popover',
+    'Tooltip', 'HoverCard', 'Carousel',
+    // Control
+    'ForEach', 'If', 'Elif', 'Else', 'Define', 'Use', 'Slot',
+    // Alert
+    'Alert', 'AlertTitle', 'AlertDescription',
+    // Media
+    'Image', 'Audio', 'Video', 'Embed', 'Svg', 'DropZone', 'Mermaid',
+    // Charts
+    'BarChart', 'LineChart', 'AreaChart', 'PieChart', 'RadarChart',
+    'ScatterChart', 'Sparkline', 'RadialChart', 'Histogram',
+]);
+// ── Validator ────────────────────────────────────────────────────────────────
+/**
+ * Validate a wire format payload. Returns `{ valid: true, errors: [] }` if OK,
+ * or `{ valid: false, errors: [...] }` with details about what's wrong.
+ *
+ * @param data - The raw parsed JSON to validate
+ * @param opts - Optional: `strict` mode warns on unknown component types
+ */
+export function validateWireFormat(data, opts = {}) {
+    const errors = [];
+    const strict = opts.strict ?? false;
+    if (data == null || typeof data !== 'object') {
+        errors.push({ path: '$', message: 'Wire data must be a non-null object' });
+        return { valid: false, errors };
+    }
+    const obj = data;
+    // $prefab header
+    if (obj.$prefab == null || typeof obj.$prefab !== 'object') {
+        errors.push({ path: '$.$prefab', message: 'Missing or invalid $prefab header' });
+    }
+    else {
+        const header = obj.$prefab;
+        if (typeof header.version !== 'string') {
+            errors.push({ path: '$.$prefab.version', message: 'version must be a string' });
+        }
+    }
+    // view (required)
+    if (obj.view == null) {
+        errors.push({ path: '$.view', message: 'Missing required "view" field' });
+    }
+    else {
+        validateComponent(obj.view, '$.view', errors, strict);
+    }
+    // state (optional)
+    if (obj.state !== undefined) {
+        if (obj.state === null || typeof obj.state !== 'object' || Array.isArray(obj.state)) {
+            errors.push({ path: '$.state', message: 'state must be a plain object' });
+        }
+    }
+    // theme (optional)
+    if (obj.theme !== undefined) {
+        validateTheme(obj.theme, errors);
+    }
+    // defs (optional)
+    if (obj.defs !== undefined) {
+        if (obj.defs === null || typeof obj.defs !== 'object' || Array.isArray(obj.defs)) {
+            errors.push({ path: '$.defs', message: 'defs must be a plain object' });
+        }
+        else {
+            for (const [name, def] of Object.entries(obj.defs)) {
+                validateComponent(def, `$.defs.${name}`, errors, strict);
+            }
+        }
+    }
+    // keyBindings (optional)
+    if (obj.keyBindings !== undefined) {
+        if (obj.keyBindings === null || typeof obj.keyBindings !== 'object' || Array.isArray(obj.keyBindings)) {
+            errors.push({ path: '$.keyBindings', message: 'keyBindings must be a plain object' });
+        }
+        else {
+            for (const [key, action] of Object.entries(obj.keyBindings)) {
+                validateAction(action, `$.keyBindings.${key}`, errors);
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Quick boolean check — returns true if data looks like valid $prefab wire format.
+ */
+export function isValidWireFormat(data) {
+    return validateWireFormat(data).valid;
+}
+// ── Internal helpers ─────────────────────────────────────────────────────────
+function validateComponent(node, path, errors, strict) {
+    if (node == null || typeof node !== 'object' || Array.isArray(node)) {
+        errors.push({ path, message: 'Component must be a plain object' });
+        return;
+    }
+    const comp = node;
+    if (typeof comp.type !== 'string' || comp.type.length === 0) {
+        errors.push({ path: `${path}.type`, message: 'Component must have a non-empty "type" string' });
+        return;
+    }
+    if (strict && !KNOWN_TYPES.has(comp.type)) {
+        errors.push({ path: `${path}.type`, message: `Unknown component type: "${comp.type}"` });
+    }
+    // Validate children recursively
+    if (comp.children !== undefined) {
+        if (!Array.isArray(comp.children)) {
+            errors.push({ path: `${path}.children`, message: 'children must be an array' });
+        }
+        else {
+            for (let i = 0; i < comp.children.length; i++) {
+                validateComponent(comp.children[i], `${path}.children[${i}]`, errors, strict);
+            }
+        }
+    }
+    // Validate action props
+    for (const prop of ['onClick', 'onChange', 'onSubmit', 'onMount', 'onClose']) {
+        if (comp[prop] !== undefined) {
+            validateAction(comp[prop], `${path}.${prop}`, errors);
+        }
+    }
+}
+function validateAction(action, path, errors) {
+    if (Array.isArray(action)) {
+        for (let i = 0; i < action.length; i++) {
+            validateAction(action[i], `${path}[${i}]`, errors);
+        }
+        return;
+    }
+    if (action == null || typeof action !== 'object') {
+        errors.push({ path, message: 'Action must be an object or array of objects' });
+        return;
+    }
+    const act = action;
+    if (typeof act.type !== 'string' || act.type.length === 0) {
+        errors.push({ path: `${path}.type`, message: 'Action must have a non-empty "type" string' });
+    }
+}
+function validateTheme(theme, errors) {
+    if (theme === null || typeof theme !== 'object' || Array.isArray(theme)) {
+        errors.push({ path: '$.theme', message: 'theme must be a plain object' });
+        return;
+    }
+    const t = theme;
+    for (const mode of ['light', 'dark']) {
+        if (t[mode] !== undefined) {
+            if (t[mode] === null || typeof t[mode] !== 'object' || Array.isArray(t[mode])) {
+                errors.push({ path: `$.theme.${mode}`, message: `theme.${mode} must be a plain object` });
+            }
+        }
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/core/validate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * prefab — TypeScript declarative UI component library for MCP apps.
+ *
+ * Wire-compatible with the Python prefab-ui library.
+ * Serializes to JSON component trees using the $prefab wire format.
+ */
+export { Component, ContainerComponent, StatefulComponent } from './core/index.js';
+export type { ComponentJSON, ComponentProps, ContainerProps, StatefulProps, RxStr } from './core/index.js';
+export { validateWireFormat, isValidWireFormat } from './core/validate.js';
+export type { ValidationError, ValidationResult } from './core/validate.js';
+export { PrefabApp } from './app.js';
+export type { PrefabAppOptions, PrefabWireFormat, Theme } from './app.js';
+export { Column, Row, Grid, GridItem, Container, Div, Span, Dashboard, DashboardItem, Pages, Page } from './components/layout/index.js';
+export { Heading, H1, H2, H3, H4, Text, P, Lead, Large, Small, Muted, BlockQuote, Label, Link, Code, Markdown, Kbd } from './components/typography/index.js';
+export { Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter } from './components/card/index.js';
+export { DataTable, col, Badge, Dot, Metric, Ring, Progress, Separator, Loader, Icon } from './components/data/index.js';
+export type { DataTableColumnDef, DataTableProps, BadgeVariant, MetricProps } from './components/data/index.js';
+export { Table, TableHead, TableBody, TableFooter, TableRow, TableHeader, TableCell, TableCaption, ExpandableRow } from './components/table/index.js';
+export { Form, Input, Textarea, Button, ButtonGroup, Select, SelectOption, SelectGroup, SelectLabel, SelectSeparator, Checkbox, Switch, Slider, Radio, RadioGroup, Combobox, ComboboxOption, ComboboxGroup, ComboboxLabel, ComboboxSeparator, Calendar, DatePicker, Field, FieldTitle, FieldDescription, FieldContent, FieldError, ChoiceCard, } from './components/form/index.js';
+export type { FormProps, InputProps, ButtonVariant, ButtonSize } from './components/form/index.js';
+export { Tabs, Tab, Accordion, AccordionItem, Dialog, Popover, Tooltip, HoverCard, Carousel } from './components/interactive/index.js';
+export { ForEach, If, Elif, Else, Define, Use, Slot } from './components/control/index.js';
+export { Alert, AlertTitle, AlertDescription } from './components/alert/index.js';
+export { Image, Audio, Video, Embed, Svg, DropZone, Mermaid } from './components/media/index.js';
+export { BarChart, LineChart, AreaChart, PieChart, RadarChart, ScatterChart, Sparkline, RadialChart, Histogram } from './components/charts/index.js';
+export type { ChartSeries, BaseChartProps, BarChartProps, SparklineProps, RadialChartProps, HistogramProps } from './components/charts/index.js';
+export { autoDetail, autoTable, statusVariant, registerStatusVariants } from './auto/index.js';
+export { autoChart } from './auto/chart.js';
+export { autoForm } from './auto/form.js';
+export { autoComparison } from './auto/comparison.js';
+export { autoMetrics } from './auto/metrics.js';
+export { autoTimeline } from './auto/timeline.js';
+export { autoProgress } from './auto/progress.js';
+export type { AutoDetailOptions, AutoTableOptions } from './auto/index.js';
+export type { AutoChartOptions, ChartType } from './auto/chart.js';
+export type { AutoFormField, AutoFormOptions } from './auto/form.js';
+export type { AutoComparisonOptions } from './auto/comparison.js';
+export type { AutoMetricDef, AutoMetricsOptions } from './auto/metrics.js';
+export type { AutoTimelineEvent, AutoTimelineOptions } from './auto/timeline.js';
+export type { AutoProgressStep, AutoProgressOptions } from './auto/progress.js';
+export { display, display_form, display_update, display_error } from './mcp/display.js';
+export type { DisplayOptions, DisplayFormOptions, DisplayErrorOptions, StateUpdate, PrefabUpdateWire } from './mcp/display.js';
+export type { McpToolResult, McpContent, McpTextContent } from './mcp/types.js';
+export { rx, Rx, ITEM, INDEX, EVENT, ERROR, RESULT, STATE } from './rx/index.js';
+export { SetState, ToggleState, AppendState, PopState, ShowToast, CloseOverlay, OpenLink, SetInterval, Fetch, OpenFilePicker, CallHandler } from './actions/client.js';
+export { CallTool, SendMessage, UpdateContext, RequestDisplayMode } from './actions/mcp.js';
+export type { Action, ActionJSON } from './actions/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,48 @@
+/**
+ * prefab — TypeScript declarative UI component library for MCP apps.
+ *
+ * Wire-compatible with the Python prefab-ui library.
+ * Serializes to JSON component trees using the $prefab wire format.
+ */
+// ── Core ─────────────────────────────────────────────────────────────────────
+export { Component, ContainerComponent, StatefulComponent } from './core/index.js';
+export { validateWireFormat, isValidWireFormat } from './core/validate.js';
+// ── App ──────────────────────────────────────────────────────────────────────
+export { PrefabApp } from './app.js';
+// ── Layout ───────────────────────────────────────────────────────────────────
+export { Column, Row, Grid, GridItem, Container, Div, Span, Dashboard, DashboardItem, Pages, Page } from './components/layout/index.js';
+// ── Typography ───────────────────────────────────────────────────────────────
+export { Heading, H1, H2, H3, H4, Text, P, Lead, Large, Small, Muted, BlockQuote, Label, Link, Code, Markdown, Kbd } from './components/typography/index.js';
+// ── Card ─────────────────────────────────────────────────────────────────────
+export { Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter } from './components/card/index.js';
+// ── Data Display ─────────────────────────────────────────────────────────────
+export { DataTable, col, Badge, Dot, Metric, Ring, Progress, Separator, Loader, Icon } from './components/data/index.js';
+// ── Table ────────────────────────────────────────────────────────────────────
+export { Table, TableHead, TableBody, TableFooter, TableRow, TableHeader, TableCell, TableCaption, ExpandableRow } from './components/table/index.js';
+// ── Form ─────────────────────────────────────────────────────────────────────
+export { Form, Input, Textarea, Button, ButtonGroup, Select, SelectOption, SelectGroup, SelectLabel, SelectSeparator, Checkbox, Switch, Slider, Radio, RadioGroup, Combobox, ComboboxOption, ComboboxGroup, ComboboxLabel, ComboboxSeparator, Calendar, DatePicker, Field, FieldTitle, FieldDescription, FieldContent, FieldError, ChoiceCard, } from './components/form/index.js';
+// ── Interactive ──────────────────────────────────────────────────────────────
+export { Tabs, Tab, Accordion, AccordionItem, Dialog, Popover, Tooltip, HoverCard, Carousel } from './components/interactive/index.js';
+// ── Control Flow ─────────────────────────────────────────────────────────────
+export { ForEach, If, Elif, Else, Define, Use, Slot } from './components/control/index.js';
+// ── Alert ────────────────────────────────────────────────────────────────────
+export { Alert, AlertTitle, AlertDescription } from './components/alert/index.js';
+// ── Media ────────────────────────────────────────────────────────────────────
+export { Image, Audio, Video, Embed, Svg, DropZone, Mermaid } from './components/media/index.js';
+// ── Charts ───────────────────────────────────────────────────────────────────
+export { BarChart, LineChart, AreaChart, PieChart, RadarChart, ScatterChart, Sparkline, RadialChart, Histogram } from './components/charts/index.js';
+// ── Auto-rendering ───────────────────────────────────────────────────────────
+export { autoDetail, autoTable, statusVariant, registerStatusVariants } from './auto/index.js';
+export { autoChart } from './auto/chart.js';
+export { autoForm } from './auto/form.js';
+export { autoComparison } from './auto/comparison.js';
+export { autoMetrics } from './auto/metrics.js';
+export { autoTimeline } from './auto/timeline.js';
+export { autoProgress } from './auto/progress.js';
+// ── MCP Display Helpers ──────────────────────────────────────────────────────
+export { display, display_form, display_update, display_error } from './mcp/display.js';
+// ── Re-export actions and rx for convenience ─────────────────────────────────
+export { rx, Rx, ITEM, INDEX, EVENT, ERROR, RESULT, STATE } from './rx/index.js';
+export { SetState, ToggleState, AppendState, PopState, ShowToast, CloseOverlay, OpenLink, SetInterval, Fetch, OpenFilePicker, CallHandler } from './actions/client.js';
+export { CallTool, SendMessage, UpdateContext, RequestDisplayMode } from './actions/mcp.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gFAAgF;AAChF,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAElF,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAG1E,gFAAgF;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAGpC,gFAAgF;AAChF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AAEvI,gFAAgF;AAChF,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,kCAAkC,CAAA;AAE5J,gFAAgF;AAChF,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAElH,gFAAgF;AAChF,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAA;AAGxH,gFAAgF;AAChF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAErJ,gFAAgF;AAChF,OAAO,EACL,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAC1C,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAC/D,QAAQ,EAAE,MAAM,EAAE,MAAM,EACxB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EACzE,QAAQ,EAAE,UAAU,EACpB,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAC7D,UAAU,GACX,MAAM,4BAA4B,CAAA;AAGnC,gFAAgF;AAChF,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAA;AAEtI,gFAAgF;AAChF,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAA;AAE1F,gFAAgF;AAChF,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAEjF,gFAAgF;AAChF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAEhG,gFAAgF;AAChF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAGpJ,gFAAgF;AAChF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AASjD,gFAAgF;AAChF,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAIvF,gFAAgF;AAChF,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAChF,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtK,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/mcp/display.d.ts

@@ -0,0 +1,102 @@
+/**
+ * MCP Display Helpers — return prefab UIs as MCP tool results.
+ *
+ * These functions wrap PrefabApp / Component trees into MCP-compatible
+ * tool result content arrays, ready to return from tool handlers.
+ *
+ * @example
+ * ```ts
+ * import { display, display_error } from '@maxhealth.tech/prefab/mcp'
+ * import { autoTable } from '@maxhealth.tech/prefab'
+ *
+ * // In a FastMCP tool handler:
+ * async function listPatients(args, context) {
+ *   const patients = await fetchPatients()
+ *   return display(autoTable(patients), { title: 'Patient List' })
+ * }
+ * ```
+ */
+import { type Component } from '../core/component.js';
+import { PrefabApp } from '../app.js';
+import type { Theme } from '../app.js';
+import type { Action } from '../actions/types.js';
+import type { McpToolResult } from './types.js';
+export interface DisplayOptions {
+    /** Page / app title. */
+    title?: string;
+    /** Initial reactive state. */
+    state?: Record<string, unknown>;
+    /** Light/dark theme overrides. */
+    theme?: Theme;
+    /** Reusable component definitions. */
+    defs?: Record<string, Component>;
+    /** Action(s) to run when the UI mounts. */
+    onMount?: Action | Action[];
+    /** Keyboard shortcuts. */
+    keyBindings?: Record<string, Action | Action[]>;
+    /** Extra CSS class on root element. */
+    cssClass?: string;
+}
+/**
+ * Wrap a Component (or PrefabApp) as an MCP tool result.
+ *
+ * If given a Component, it's wrapped in a PrefabApp automatically.
+ * If given a PrefabApp, it's serialized as-is.
+ *
+ * @returns MCP tool result with the prefab wire format JSON as text content.
+ */
+export declare function display(viewOrApp: Component | PrefabApp, options?: DisplayOptions): McpToolResult;
+import type { AutoFormField, AutoFormOptions } from '../auto/form.js';
+export interface DisplayFormOptions extends AutoFormOptions {
+    /** Initial state values for form fields. */
+    state?: Record<string, unknown>;
+    /** Theme overrides. */
+    theme?: Theme;
+}
+/**
+ * Return a form UI as an MCP tool result.
+ *
+ * The form submits back to the specified MCP tool via CallTool.
+ * Field definitions map to Input components; the submit action
+ * invokes `submitTool` with all field values.
+ *
+ * @returns MCP tool result with form prefab UI.
+ */
+export declare function display_form(fields: AutoFormField[], submitTool: string, options?: DisplayFormOptions): McpToolResult;
+export interface StateUpdate {
+    /** State key-value pairs to merge into the existing UI state. */
+    state: Record<string, unknown>;
+}
+export interface PrefabUpdateWire {
+    $prefab: {
+        version: string;
+    };
+    update: StateUpdate;
+}
+/**
+ * Return a partial state update for an existing prefab UI.
+ *
+ * Instead of re-rendering the entire UI, this sends a state delta
+ * that the renderer merges into its reactive store.
+ *
+ * @returns MCP tool result with a $prefab update payload.
+ */
+export declare function display_update(state: Record<string, unknown>): McpToolResult;
+export interface DisplayErrorOptions {
+    /** Error detail / stack trace to show in a code block. */
+    detail?: string;
+    /** Hint for the user on how to fix the issue. */
+    hint?: string;
+    /** Theme overrides. */
+    theme?: Theme;
+}
+/**
+ * Return a standardized error view as an MCP tool result.
+ *
+ * Renders a destructive Alert with title + message, optional detail
+ * code block, and optional hint. Sets `isError: true` on the MCP result.
+ *
+ * @returns MCP tool result with error UI and isError flag.
+ */
+export declare function display_error(title: string, message: string, options?: DisplayErrorOptions): McpToolResult;
+//# sourceMappingURL=display.d.ts.map

package/dist/mcp/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/mcp/display.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAI/C,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,kCAAkC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAChC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC3B,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;IAC/C,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CACrB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,aAAa,CAiBf;AAKD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAErE,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,uBAAuB;IACvB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,EAAE,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,aAAa,CAYf;AAID,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5B,MAAM,EAAE,WAAW,CAAA;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,aAAa,CASf;AASD,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uBAAuB;IACvB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,mBAAmB,GAC5B,aAAa,CAgCf"}