@lynx-js/genui 0.0.1-rc.0

package/a2ui-prompt/dist/index.js

@@ -0,0 +1,767 @@
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, resolve } from "node:path";
+const BASIC_CATALOG_ID = 'https://a2ui.org/specification/v0_9/basic_catalog.json';
+const BASIC_CATALOG_EXAMPLES = [
+    {
+        name: 'login-card',
+        user: 'Generate a login card with email, password, and a submit button.',
+        messages: [
+            {
+                version: 'v0.9',
+                createSurface: {
+                    surfaceId: 'main',
+                    catalogId: BASIC_CATALOG_ID
+                }
+            },
+            {
+                version: 'v0.9',
+                updateComponents: {
+                    surfaceId: 'main',
+                    components: [
+                        {
+                            id: 'root',
+                            component: 'Card',
+                            child: 'form-column'
+                        },
+                        {
+                            id: 'form-column',
+                            component: 'Column',
+                            children: [
+                                'title',
+                                'email',
+                                'password',
+                                'submit'
+                            ]
+                        },
+                        {
+                            id: 'title',
+                            component: 'Text',
+                            text: 'Sign in',
+                            variant: 'h2'
+                        },
+                        {
+                            id: 'email',
+                            component: 'TextField',
+                            label: 'Email',
+                            value: {
+                                path: '/form/email'
+                            }
+                        },
+                        {
+                            id: 'password',
+                            component: 'TextField',
+                            label: 'Password',
+                            variant: 'obscured',
+                            value: {
+                                path: '/form/password'
+                            }
+                        },
+                        {
+                            id: 'submit',
+                            component: 'Button',
+                            variant: 'primary',
+                            child: 'submit-label',
+                            action: {
+                                event: {
+                                    name: 'submit_login',
+                                    context: {
+                                        email: {
+                                            path: '/form/email'
+                                        },
+                                        password: {
+                                            path: '/form/password'
+                                        }
+                                    }
+                                }
+                            }
+                        },
+                        {
+                            id: 'submit-label',
+                            component: 'Text',
+                            text: 'Sign in'
+                        }
+                    ]
+                }
+            },
+            {
+                version: 'v0.9',
+                updateDataModel: {
+                    surfaceId: 'main',
+                    value: {
+                        form: {
+                            email: '',
+                            password: ''
+                        }
+                    }
+                }
+            }
+        ]
+    },
+    {
+        name: 'dynamic-list',
+        user: 'Show three trip ideas as a compact list.',
+        messages: [
+            {
+                version: 'v0.9',
+                createSurface: {
+                    surfaceId: 'main',
+                    catalogId: BASIC_CATALOG_ID
+                }
+            },
+            {
+                version: 'v0.9',
+                updateComponents: {
+                    surfaceId: 'main',
+                    components: [
+                        {
+                            id: 'root',
+                            component: 'Column',
+                            children: [
+                                'title',
+                                'trip-list'
+                            ]
+                        },
+                        {
+                            id: 'title',
+                            component: 'Text',
+                            text: 'Trip ideas',
+                            variant: 'h2'
+                        },
+                        {
+                            id: 'trip-list',
+                            component: 'List',
+                            direction: 'vertical',
+                            children: {
+                                path: '/items',
+                                componentId: 'trip-row'
+                            }
+                        },
+                        {
+                            id: 'trip-row',
+                            component: 'Row',
+                            children: [
+                                'trip-icon',
+                                'trip-copy'
+                            ],
+                            align: 'center'
+                        },
+                        {
+                            id: 'trip-icon',
+                            component: 'Icon',
+                            name: 'location_on'
+                        },
+                        {
+                            id: 'trip-copy',
+                            component: 'Column',
+                            children: [
+                                'trip-name',
+                                'trip-detail'
+                            ]
+                        },
+                        {
+                            id: 'trip-name',
+                            component: 'Text',
+                            text: {
+                                path: '/items/*/name'
+                            },
+                            variant: 'h3'
+                        },
+                        {
+                            id: 'trip-detail',
+                            component: 'Text',
+                            text: {
+                                path: '/items/*/detail'
+                            },
+                            variant: 'body'
+                        }
+                    ]
+                }
+            },
+            {
+                version: 'v0.9',
+                updateDataModel: {
+                    surfaceId: 'main',
+                    path: '/items',
+                    value: [
+                        {
+                            name: 'Canal walk',
+                            detail: 'Morning coffee and quiet bridges'
+                        },
+                        {
+                            name: 'Museum loop',
+                            detail: 'Design exhibits plus lunch nearby'
+                        },
+                        {
+                            name: 'Sunset hill',
+                            detail: 'Short climb with skyline views'
+                        }
+                    ]
+                }
+            }
+        ]
+    },
+    {
+        name: 'chart-card',
+        user: 'Show weekly active users as a line chart.',
+        messages: [
+            {
+                version: 'v0.9',
+                createSurface: {
+                    surfaceId: 'main',
+                    catalogId: BASIC_CATALOG_ID
+                }
+            },
+            {
+                version: 'v0.9',
+                updateComponents: {
+                    surfaceId: 'main',
+                    components: [
+                        {
+                            id: 'root',
+                            component: 'Card',
+                            child: 'chart-column'
+                        },
+                        {
+                            id: 'chart-column',
+                            component: 'Column',
+                            children: [
+                                'title',
+                                'chart'
+                            ]
+                        },
+                        {
+                            id: 'title',
+                            component: 'Text',
+                            text: 'Weekly active users',
+                            variant: 'h2'
+                        },
+                        {
+                            id: 'chart',
+                            component: 'LineChart',
+                            labels: {
+                                path: '/chart/labels'
+                            },
+                            series: {
+                                path: '/chart/series'
+                            },
+                            xLabel: 'Day',
+                            yLabel: 'Users',
+                            showGrid: true,
+                            showLegend: true
+                        }
+                    ]
+                }
+            },
+            {
+                version: 'v0.9',
+                updateDataModel: {
+                    surfaceId: 'main',
+                    value: {
+                        chart: {
+                            labels: [
+                                'Mon',
+                                'Tue',
+                                'Wed',
+                                'Thu',
+                                'Fri'
+                            ],
+                            series: [
+                                {
+                                    name: 'Users',
+                                    values: [
+                                        120,
+                                        148,
+                                        132,
+                                        171,
+                                        190
+                                    ]
+                                }
+                            ]
+                        }
+                    }
+                }
+            }
+        ]
+    },
+    {
+        name: 'action-update',
+        user: 'A2UI_USER_ACTION: {"surfaceId":"main","action":{"name":"submit_login","context":{"email":"me@example.com"}}}',
+        messages: [
+            {
+                version: 'v0.9',
+                updateDataModel: {
+                    surfaceId: 'main',
+                    path: '/status',
+                    value: {
+                        kind: 'success',
+                        message: 'Signed in as me@example.com'
+                    }
+                }
+            },
+            {
+                version: 'v0.9',
+                updateComponents: {
+                    surfaceId: 'main',
+                    components: [
+                        {
+                            id: 'root',
+                            component: 'Card',
+                            child: 'status-column'
+                        },
+                        {
+                            id: 'status-column',
+                            component: 'Column',
+                            children: [
+                                'status-title',
+                                'status-message'
+                            ]
+                        },
+                        {
+                            id: 'status-title',
+                            component: 'Text',
+                            text: 'Success',
+                            variant: 'h2'
+                        },
+                        {
+                            id: 'status-message',
+                            component: 'Text',
+                            text: {
+                                path: '/status/message'
+                            }
+                        }
+                    ]
+                }
+            }
+        ]
+    }
+];
+var catalog_namespaceObject = JSON.parse('{"Button":{"properties":{"child":{"type":"string"},"variant":{"type":"string","enum":["primary","borderless"]},"isValid":{"type":"boolean"},"action":{"oneOf":[{"type":"object","properties":{"event":{"type":"object","properties":{"name":{"type":"string"},"context":{"type":"object","additionalProperties":true,"description":"Context is a JSON object map in v0.9."}},"required":["name"],"additionalProperties":false}},"required":["event"],"additionalProperties":false},{"type":"object","properties":{"functionCall":{"type":"object","properties":{"call":{"type":"string"},"args":{"type":"object","additionalProperties":true},"returnType":{"type":"string","enum":["string","number","boolean","object","array","any","void"]}},"required":["call","args"],"additionalProperties":false}},"required":["functionCall"],"additionalProperties":false}],"description":"v0.9 actions should use the `event` wrapper for server-dispatched clicks."},"checks":{"type":"array","items":{"type":"object","properties":{"condition":{"oneOf":[{"type":"boolean"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false},{"type":"object","properties":{"call":{"type":"string"},"args":{"type":"object","additionalProperties":true},"returnType":{"type":"string","enum":["string","number","boolean","object","array","any","void"]}},"required":["call","args"],"additionalProperties":false}]},"message":{"type":"string"}},"required":["condition","message"],"additionalProperties":false}}},"required":["child","action"]}}');
+var Card_catalog_namespaceObject = JSON.parse('{"Card":{"properties":{"child":{"type":"string"},"variant":{"type":"string","enum":["elevated","outlined","filled","ghost"]},"weight":{"type":"number"}},"required":["child"]}}');
+var CheckBox_catalog_namespaceObject = JSON.parse('{"CheckBox":{"properties":{"label":{"oneOf":[{"type":"string"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false},{"type":"object","properties":{"call":{"type":"string"},"args":{"type":"object","additionalProperties":true},"returnType":{"type":"string","enum":["string","number","boolean","object","array","any","void"]}},"required":["call","args"],"additionalProperties":false}]},"value":{"oneOf":[{"type":"boolean"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false},{"type":"object","properties":{"call":{"type":"string"},"args":{"type":"object","additionalProperties":true},"returnType":{"type":"string","enum":["string","number","boolean","object","array","any","void"]}},"required":["call","args"],"additionalProperties":false}]},"checks":{"type":"array","items":{"type":"object","properties":{"condition":{"oneOf":[{"type":"boolean"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false},{"type":"object","properties":{"call":{"type":"string"},"args":{"type":"object","additionalProperties":true},"returnType":{"type":"string","enum":["string","number","boolean","object","array","any","void"]}},"required":["call","args"],"additionalProperties":false}]},"message":{"type":"string"}},"required":["condition","message"],"additionalProperties":false}}},"required":["label","value"]}}');
+var Column_catalog_namespaceObject = JSON.parse('{"Column":{"properties":{"children":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"object","properties":{"componentId":{"type":"string"},"path":{"type":"string"}},"required":["componentId","path"],"additionalProperties":false}],"description":"Static child IDs array or template object."},"align":{"type":"string","enum":["start","center","end","stretch"]},"justify":{"type":"string","enum":["start","center","end","stretch","spaceBetween","spaceAround","spaceEvenly"]}},"required":["children"]}}');
+var Divider_catalog_namespaceObject = JSON.parse('{"Divider":{"properties":{"axis":{"type":"string","enum":["horizontal","vertical"]}},"required":[]}}');
+var Icon_catalog_namespaceObject = JSON.parse('{"Icon":{"properties":{"name":{"oneOf":[{"type":"string"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false}],"description":"Material icon name (camelCase or snake_case), e.g. \\"info\\", \\"skipNext\\", \\"play_arrow\\"."},"size":{"type":"string","enum":["sm","md","lg"]},"color":{"type":"string","enum":["primary","muted","inherit"]}},"required":["name"]}}');
+var Image_catalog_namespaceObject = JSON.parse('{"Image":{"properties":{"url":{"oneOf":[{"type":"string"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false}],"description":"Image URL or path binding."},"fit":{"type":"string","enum":["contain","cover","fill","none","scale-down"]},"mode":{"type":"string","enum":["center","scaleToFill","aspectFit","aspectFill"]},"variant":{"type":"string","enum":["icon","avatar","smallFeature","mediumFeature","largeFeature","header"]},"weight":{"type":"number"}},"required":["url"]}}');
+var LineChart_catalog_namespaceObject = JSON.parse('{"LineChart":{"properties":{"labels":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false}],"description":"Category labels shown along the x axis."},"series":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{"type":"number"}},"color":{"type":"string"}},"required":["name","values"],"additionalProperties":false}},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false}],"description":"One or more line series to render over the shared labels."},"variant":{"type":"string","enum":["linear","natural","step"]},"xLabel":{"type":"string"},"yLabel":{"type":"string"},"showGrid":{"type":"boolean"},"showLegend":{"type":"boolean"},"height":{"type":"number"}},"required":["labels","series"]}}');
+var List_catalog_namespaceObject = JSON.parse('{"List":{"properties":{"children":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"object","properties":{"componentId":{"type":"string"},"path":{"type":"string"}},"required":["componentId","path"],"additionalProperties":false}],"description":"Static child IDs array or template object."},"direction":{"type":"string","enum":["horizontal","vertical"]},"align":{"type":"string","enum":["start","center","end","stretch"]}},"required":["children"]}}');
+var Modal_catalog_namespaceObject = JSON.parse('{"Modal":{"properties":{"trigger":{"type":"string","description":"The ID of the component that opens the modal when interacted with."},"content":{"type":"string","description":"The ID of the component to display inside the modal."}},"required":["trigger","content"]}}');
+var RadioGroup_catalog_namespaceObject = JSON.parse('{"RadioGroup":{"properties":{"items":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false},{"type":"object","properties":{"call":{"type":"string"},"args":{"type":"object","additionalProperties":true},"returnType":{"type":"string","enum":["string","number","boolean","object","array","any","void"]}},"required":["call","args"],"additionalProperties":false}],"description":"The list of string options to display."},"value":{"oneOf":[{"type":"string"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false},{"type":"object","properties":{"call":{"type":"string"},"args":{"type":"object","additionalProperties":true},"returnType":{"type":"string","enum":["string","number","boolean","object","array","any","void"]}},"required":["call","args"],"additionalProperties":false}],"description":"The currently selected value."},"usageHint":{"type":"string","enum":["default","card","row"],"description":"A hint for the visual style of the radio group."},"checks":{"type":"array","items":{"type":"object","properties":{"condition":{"oneOf":[{"type":"boolean"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false},{"type":"object","properties":{"call":{"type":"string"},"args":{"type":"object","additionalProperties":true},"returnType":{"type":"string","enum":["string","number","boolean","object","array","any","void"]}},"required":["call","args"],"additionalProperties":false}]},"message":{"type":"string"}},"required":["condition","message"],"additionalProperties":false}}},"required":["items","value"]}}');
+var Row_catalog_namespaceObject = JSON.parse('{"Row":{"properties":{"children":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"object","properties":{"componentId":{"type":"string"},"path":{"type":"string"}},"required":["componentId","path"],"additionalProperties":false}],"description":"Static child IDs array or template object."},"justify":{"type":"string","enum":["start","center","end","stretch","spaceBetween","spaceAround","spaceEvenly"]},"align":{"type":"string","enum":["start","center","end","stretch"]}},"required":["children"]}}');
+var Slider_catalog_namespaceObject = JSON.parse('{"Slider":{"properties":{"label":{"oneOf":[{"type":"string"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false},{"type":"object","properties":{"call":{"type":"string"},"args":{"type":"object","additionalProperties":true},"returnType":{"type":"string","enum":["string","number","boolean","object","array","any","void"]}},"required":["call","args"],"additionalProperties":false}],"description":"The label for the slider."},"min":{"type":"number","description":"The minimum value of the slider."},"max":{"type":"number","description":"The maximum value of the slider."},"value":{"oneOf":[{"type":"number"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false},{"type":"object","properties":{"call":{"type":"string"},"args":{"type":"object","additionalProperties":true},"returnType":{"type":"string","enum":["string","number","boolean","object","array","any","void"]}},"required":["call","args"],"additionalProperties":false}],"description":"The current value of the slider."},"checks":{"type":"array","items":{"type":"object","properties":{"condition":{"oneOf":[{"type":"boolean"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false},{"type":"object","properties":{"call":{"type":"string"},"args":{"type":"object","additionalProperties":true},"returnType":{"type":"string","enum":["string","number","boolean","object","array","any","void"]}},"required":["call","args"],"additionalProperties":false}],"description":"The condition that indicates whether the check passes."},"message":{"type":"string","description":"The error message to display if the check fails."}},"required":["condition","message"],"additionalProperties":false},"description":"A list of checks to perform."}},"required":["max","value"]}}');
+var Tabs_catalog_namespaceObject = JSON.parse('{"Tabs":{"properties":{"tabs":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"child":{"type":"string"}},"required":["title","child"],"additionalProperties":false}}},"required":["tabs"]}}');
+var Text_catalog_namespaceObject = JSON.parse('{"Text":{"properties":{"text":{"oneOf":[{"type":"string"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false},{"type":"object","properties":{"call":{"type":"string"},"args":{"type":"object","additionalProperties":true},"returnType":{"type":"string","enum":["string","number","boolean","object","array","any","void"]}},"required":["call","args"],"additionalProperties":false}],"description":"Literal text, path binding, or function call."},"variant":{"type":"string","enum":["h1","h2","h3","h4","h5","caption","body","markdown"]},"weight":{"type":"number"}},"required":["text"]}}');
+var TextField_catalog_namespaceObject = JSON.parse('{"TextField":{"properties":{"label":{"oneOf":[{"type":"string"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false}],"description":"The text label for the input field."},"value":{"oneOf":[{"type":"string"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false}],"description":"The value of the text field."},"variant":{"type":"string","enum":["number","longText","shortText","obscured"],"description":"The type of input field to display."},"validationRegexp":{"type":"string","description":"A regular expression used for client-side validation of the input."},"checks":{"type":"array","items":{"type":"object","properties":{"condition":{"oneOf":[{"type":"boolean"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false},{"type":"object","properties":{"call":{"type":"string"},"args":{"type":"object","additionalProperties":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false}]}},"returnType":{"type":"string","enum":["boolean"]}},"required":["call"],"additionalProperties":false}],"description":"The condition that indicates whether the check passes."},"message":{"type":"string","description":"The error message to display if the check fails."}},"required":["condition","message"],"additionalProperties":false},"description":"A list of checks to perform."}},"required":["label"]}}');
+const a2ui_catalog_BASIC_CATALOG_ID = 'https://a2ui.org/specification/v0_9/basic_catalog.json';
+const CATALOG_MANIFESTS = [
+    Text_catalog_namespaceObject,
+    Image_catalog_namespaceObject,
+    Icon_catalog_namespaceObject,
+    Divider_catalog_namespaceObject,
+    LineChart_catalog_namespaceObject,
+    Row_catalog_namespaceObject,
+    Column_catalog_namespaceObject,
+    List_catalog_namespaceObject,
+    Card_catalog_namespaceObject,
+    Tabs_catalog_namespaceObject,
+    Modal_catalog_namespaceObject,
+    catalog_namespaceObject,
+    TextField_catalog_namespaceObject,
+    CheckBox_catalog_namespaceObject,
+    RadioGroup_catalog_namespaceObject,
+    Slider_catalog_namespaceObject
+];
+const COMPONENT_SUMMARIES = {
+    Button: 'Clickable button. MUST always include an action. Has no "label" prop; use a child Text component for the visible label.',
+    Card: 'Card container with exactly one child. Wrap multiple elements in a Column/Row/List first.',
+    CheckBox: 'Boolean checkbox with a label and optional validation checks.',
+    Column: 'Vertical layout container.',
+    Divider: 'Horizontal or vertical separator line.',
+    Icon: 'Display an icon by name.',
+    Image: 'Display an image by URL.',
+    LineChart: 'Display one or more numeric line series over shared labels.',
+    List: 'Repeating layout container, commonly bound to a data path.',
+    Modal: 'Modal dialog with a trigger component and a content component. The trigger opens the modal locally when tapped.',
+    RadioGroup: 'Single-choice selector for a list of string options.',
+    Row: 'Horizontal layout container.',
+    Slider: 'Numeric slider with an optional label and validation checks.',
+    Tabs: 'Tabbed container; each tab references a child component id.',
+    Text: 'Display styled text. Supports literal text, data bindings, and function calls.',
+    TextField: 'Single-line or multi-line text input.'
+};
+const CONTAINER_SHAPES = {
+    Button: 'child',
+    Card: 'child',
+    Column: 'children',
+    List: 'children',
+    Modal: 'trigger-content',
+    Row: 'children',
+    Tabs: 'tabs'
+};
+function isRecord(value) {
+    return null !== value && 'object' == typeof value && !Array.isArray(value);
+}
+function inferType(schema) {
+    if (!schema) return 'unknown';
+    if (schema.oneOf && schema.oneOf.length > 0) return schema.oneOf.map((item)=>inferType(item)).join(' | ');
+    if ('array' === schema.type) return `${inferType(schema.items)}[]`;
+    if ('object' === schema.type) {
+        const properties = schema.properties ?? {};
+        const keys = Object.keys(properties);
+        if (0 === keys.length) return 'object';
+        const required = new Set(schema.required ?? []);
+        const fields = keys.map((key)=>{
+            const optional = required.has(key) ? '' : '?';
+            return `${key}${optional}: ${inferType(properties[key])}`;
+        });
+        return `{ ${fields.join('; ')} }`;
+    }
+    if ('string' === schema.type) {
+        if (Array.isArray(schema.enum) && schema.enum.length > 0) return schema.enum.filter((item)=>'string' == typeof item).map((item)=>`"${item}"`).join(' | ');
+        return 'string';
+    }
+    if ('number' === schema.type) return 'number';
+    if ('boolean' === schema.type) return 'boolean';
+    return schema.type ?? 'unknown';
+}
+function inferEnums(schema) {
+    if (!schema) return;
+    if (Array.isArray(schema.enum)) {
+        const values = schema.enum.filter((item)=>'string' == typeof item);
+        return values.length > 0 ? values : void 0;
+    }
+    if (!schema.oneOf) return;
+    const nested = schema.oneOf.flatMap((item)=>inferEnums(item) ?? []);
+    return nested.length > 0 ? [
+        ...new Set(nested)
+    ] : void 0;
+}
+function componentFromManifest(manifest) {
+    const [name, schema] = Object.entries(manifest)[0] ?? [];
+    if (!name || !schema) return null;
+    const properties = isRecord(schema.properties) ? schema.properties : {};
+    const required = new Set(schema.required ?? []);
+    const props = Object.entries(properties).map(([propName, propSchema])=>{
+        const enums = inferEnums(propSchema);
+        return {
+            name: propName,
+            type: inferType(propSchema),
+            description: propSchema.description ?? '',
+            required: required.has(propName),
+            schema: propSchema,
+            ...enums ? {
+                enums
+            } : {}
+        };
+    });
+    return {
+        name,
+        summary: COMPONENT_SUMMARIES[name] ?? `${name} component.`,
+        props,
+        ...'Button' === name ? {
+            requiresAction: true
+        } : {},
+        ...CONTAINER_SHAPES[name] ? {
+            containerShape: CONTAINER_SHAPES[name]
+        } : {}
+    };
+}
+function createA2UICatalogFromManifests(options) {
+    return {
+        id: options.catalogId,
+        label: options.label ?? `A2UI catalog (${options.catalogId})`,
+        ...options.version ? {
+            version: options.version
+        } : {},
+        components: options.componentManifests.map((manifest)=>componentFromManifest(manifest)).filter((component)=>null !== component),
+        ...options.extraRules ? {
+            extraRules: options.extraRules
+        } : {},
+        ...options.examples ? {
+            examples: options.examples
+        } : {},
+        ...options.functions ? {
+            functions: options.functions
+        } : {}
+    };
+}
+const BASIC_CATALOG = {
+    id: a2ui_catalog_BASIC_CATALOG_ID,
+    label: 'Lynx A2UI basic catalog (v0.9)',
+    version: 'v0.9',
+    components: CATALOG_MANIFESTS.map((manifest)=>componentFromManifest(manifest)).filter((component)=>null !== component),
+    extraRules: [
+        'Use only components listed in this catalog; unsupported examples such as Video, AudioPlayer, DatePicker, or Checkbox are not available unless they appear here.',
+        'The implemented checkbox component is named "CheckBox" with a capital B.'
+    ],
+    examples: BASIC_CATALOG_EXAMPLES
+};
+function renderCatalogReference(catalog) {
+    const lines = [];
+    lines.push(`## Component catalog (${catalog.label}; catalogId=${catalog.id})`);
+    lines.push('');
+    for (const c of catalog.components){
+        const required = c.props.filter((p)=>p.required).map((p)=>p.name).join(', ');
+        const header = required ? `### ${c.name}  (required: ${required})` : `### ${c.name}`;
+        lines.push(header);
+        lines.push(`- ${c.summary}`);
+        for (const p of c.props){
+            const req = p.required ? ' [required]' : '';
+            const en = p.enums ? `  enum: ${p.enums.join(' | ')}` : '';
+            const desc = p.description ? ` — ${p.description}` : '';
+            lines.push(`  · ${p.name}: ${p.type}${req}${desc}${en}`);
+        }
+        if (c.requiresAction) lines.push('  · NOTE: this component MUST include a non-empty `action`.');
+        lines.push('');
+    }
+    if (void 0 !== catalog.extraRules && catalog.extraRules.length > 0) {
+        lines.push('### Additional catalog rules');
+        for (const r of catalog.extraRules)lines.push(`- ${r}`);
+        lines.push('');
+    }
+    if (void 0 !== catalog.functions && catalog.functions.length > 0) {
+        lines.push('### Available functions');
+        for (const fn of catalog.functions){
+            lines.push(`- ${fn.name}: returns ${fn.returnType}`);
+            if (fn.description) lines.push(`  ${fn.description}`);
+            lines.push(`  parameters: ${JSON.stringify(fn.parameters)}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+const A2UI_PROTOCOL_VERSION = 'v0.9';
+const PROTOCOL_OVERVIEW = `# A2UI (Agent-to-UI) Protocol v0.9
+
+A2UI is a JSON-based, streaming UI protocol from Google
+(https://github.com/google/A2UI). It lets an LLM agent describe a user interface
+by emitting a sequence of declarative JSON messages that a renderer turns into
+native widgets. There is NO arbitrary code: the renderer only knows the
+components in the agreed-upon catalog.
+
+## Official v0.9 design principles
+- Prompt-first: v0.9 is meant to be embedded directly in the model prompt, so
+  emit JSON that follows the in-context schema and examples exactly.
+- Safe like data, expressive like code: describe UI intent using trusted catalog
+  components only. Never emit JavaScript, HTML, CSS, event handlers or scripts.
+- Structure/data separation: component messages define the flat UI structure;
+  data model messages populate or change values used by dynamic bindings.
+- Progressive rendering: clients may render after each valid message. Prefer a
+  useful minimal UI first, then add data and refinements in later messages.
+- Transport-agnostic: A2UI messages can travel over SSE, REST, WebSocket, A2A,
+  AG UI or MCP. This service wraps the streamed messages in one JSON array for
+  validation and transport convenience.
+
+## Server-to-client message types
+Every message MUST be a top-level JSON object with the field "version": "v0.9"
+and exactly ONE of the following keys:
+
+1. "createSurface"   – initialise a new UI surface.
+2. "updateComponents" – send/replace the list of components on a surface.
+3. "updateDataModel" – set values inside the surface's data model.
+4. "deleteSurface"   – tear down a surface.
+
+## Required ordering for a fresh response
+1. createSurface  (with surfaceId + catalogId)
+2. updateComponents (the FIRST one MUST contain a component whose id is "root")
+3. zero or more updateDataModel  (populate dynamic data referenced by paths)
+4. (optional) further updateComponents / updateDataModel for incremental UI
+
+## Envelope semantics
+- createSurface creates a surface. Once created, its surfaceId and catalogId are
+  fixed. To change catalog/theme, delete and recreate the surface.
+- updateComponents adds or replaces component definitions for that surface. It
+  may reference data paths that will be populated by updateDataModel.
+- updateDataModel replaces the whole data model when "path" is omitted or "/".
+  With a specific "path", it replaces only the value at that JSON Pointer.
+- deleteSurface removes a surface when the UI is no longer needed.
+
+## Component model
+- Components are kept FLAT (adjacency-list style). Children are referenced by
+  string ids, never inlined.
+- Every component object has shape:
+    {
+      "id":        "string",       // unique within the surface
+      "component": "Text|Card|...", // discriminator from the catalog
+      ...component specific props
+    }
+- The component with id "root" is the entry point of the tree.
+- Layout containers (Row / Column / List) take "children": ["id1", "id2", ...].
+  To repeat from the data model, use "children":
+    { "path": "/items", "componentId": "itemRow" }
+- Card uses "child": "id".  Modal uses "trigger" + "content".  Tabs uses an
+  array of {title, child}.
+
+## Data binding
+- Static text:  "text": "Hello"
+- Bound text:   "text": { "path": "/user/name" }
+- Bound list children:
+    "children": { "path": "/items", "componentId": "itemRow" }
+- Use updateDataModel messages to populate values at those paths.
+- DynamicString/DynamicNumber/DynamicBoolean props accept either a literal value
+  or { "path": "/json/pointer" }. If you bind a prop to a path, create the
+  matching value in updateDataModel.
+
+## Client-to-server events
+- Interactive components carry an "action":
+    { "event": { "name": "submit_booking",
+                 "context": { "restaurantId": { "path": "/selected/id" } } } }
+- Button has NO "label" prop. Its visible label is a child Text component
+  (use "child": "<text-id>" and add a separate Text component with that id).
+- The renderer will POST that action back to /a2ui/action with the same
+  surfaceId and current client-held conversation. Your next turn may receive a
+  user message whose content starts with "A2UI_USER_ACTION:" followed by JSON
+  describing the action; handle it by emitting additional updateComponents /
+  updateDataModel messages to update the same surface.
+`;
+function buildHardRules(catalogId) {
+    return `## Hard rules
+1. Output MUST be a JSON ARRAY of A2UI messages. No prose, no Markdown, no
+   code fences, no XML. First character '[' – last character ']'.
+2. Each element MUST include "version": "v0.9".
+3. For a fresh non-action response, the first message MUST be createSurface with
+   catalogId = "${catalogId}". Use surfaceId "main" unless the user specifies
+   otherwise.
+4. For a fresh non-action response, the second message MUST be
+   updateComponents; its components list MUST contain exactly one component
+   with id "root".
+5. Use property-based component discriminators: "component": "Text", not
+   wrapper objects such as { "Text": {...} }.
+6. Children are referenced by id only. NEVER inline a child component.
+7. Container references MUST point to components present in the same response.
+8. Card.child is exactly one id; wrap multiple elements in Row/Column/List.
+9. Buttons MUST include a non-empty "action.event.name". Button has NO "label"
+   prop – provide the label via a child Text component ("child": "<text-id>").
+10. Any "{path:...}" reference MUST be populated by some updateDataModel in the
+   same response.
+11. Ids are kebab-case, unique per surface ("root", "title-text", "submit-btn").
+12. Do not invent components outside the catalog.
+13. No comments, trailing commas or unknown fields.
+14. If the user asks for impossible, unsafe, or unsupported UI, render a concise
+    explanatory A2UI surface using supported components rather than prose.
+15. If the latest user message starts with "A2UI_USER_ACTION:", this is an
+    action response for an existing surface. Return a non-empty JSON array with
+    updateDataModel and/or updateComponents for that same surfaceId. Do NOT
+    return [] and do NOT create a new surface unless the action explicitly asks
+    to replace the whole UI.
+16. For UI that should change after a button tap, keep the initial response in
+    the pre-action state. Put confirmation, success, or result details in the
+    action response instead of showing them before the action happens.
+17. For Image.url, provide a short English image search query such as
+    "fresh pasta on a table" or "city skyline at night". Do NOT invent photo
+    CDN URLs. The server resolves Image.url values through its image provider.
+`;
+}
+function renderCatalogExamples(catalog) {
+    if (!catalog.examples || 0 === catalog.examples.length) return '';
+    const lines = [
+        '## Validated examples'
+    ];
+    for (const example of catalog.examples){
+        lines.push('');
+        lines.push(`### ${example.name}`);
+        lines.push(`User: ${JSON.stringify(example.user)}`);
+        lines.push('Assistant (raw JSON array, no fences):');
+        lines.push(JSON.stringify(example.messages, null, 2));
+    }
+    return lines.join('\n');
+}
+function buildA2UISystemPrompt(opts = {}) {
+    const catalog = opts.catalog ?? BASIC_CATALOG;
+    const parts = [
+        'You are an A2UI (Agent-to-UI) generation agent. Translate the user\'s',
+        'natural-language request into a stream of A2UI v0.9 JSON messages that a',
+        'client renderer can consume. A downstream validator will reject malformed',
+        'output – if you violate the protocol the user sees nothing.',
+        '',
+        PROTOCOL_OVERVIEW,
+        '',
+        renderCatalogReference(catalog),
+        '',
+        buildHardRules(catalog.id),
+        '',
+        renderCatalogExamples(catalog)
+    ];
+    if (opts.appendix) parts.push('', opts.appendix);
+    return parts.join('\n');
+}
+const A2UI_SYSTEM_PROMPT = buildA2UISystemPrompt();
+function readA2UICatalogFromDirectory(options) {
+    const cwd = options.cwd ? resolve(options.cwd) : process.cwd();
+    const catalogDir = resolve(cwd, options.catalogDir);
+    if (!existsSync(catalogDir)) throw new Error(`[a2ui-prompt] Catalog directory does not exist: ${options.catalogDir}`);
+    if (!statSync(catalogDir).isDirectory()) throw new Error(`[a2ui-prompt] Catalog path is not a directory: ${options.catalogDir}`);
+    const componentManifests = [];
+    for (const entry of readdirSync(catalogDir, {
+        withFileTypes: true
+    })){
+        if (!entry.isDirectory() || 'functions' === entry.name) continue;
+        const catalogJsonPath = join(catalogDir, entry.name, 'catalog.json');
+        if (existsSync(catalogJsonPath)) componentManifests.push(readCatalogManifest(catalogJsonPath));
+    }
+    if (0 === componentManifests.length) throw new Error(`[a2ui-prompt] No component catalog files found in ${options.catalogDir}. Expected files like <Component>/catalog.json. Run "genui a2ui generate catalog" first or pass --catalog-dir to the generated catalog directory.`);
+    return createA2UICatalogFromManifests({
+        catalogId: options.catalogId,
+        componentManifests,
+        functions: readFunctionDefinitions(catalogDir),
+        ...options.label ? {
+            label: options.label
+        } : {},
+        ...options.version ? {
+            version: options.version
+        } : {}
+    });
+}
+function readFunctionDefinitions(catalogDir) {
+    const functionsDir = join(catalogDir, 'functions');
+    if (!existsSync(functionsDir)) return [];
+    if (!statSync(functionsDir).isDirectory()) throw new Error(`[a2ui-prompt] Expected functions directory at ${functionsDir}.`);
+    const functions = [];
+    for (const entry of readdirSync(functionsDir, {
+        withFileTypes: true
+    })){
+        if (!entry.isFile() || !entry.name.endsWith('.json')) continue;
+        const functionRecord = readJsonObject(join(functionsDir, entry.name));
+        for (const [name, value] of Object.entries(functionRecord)){
+            if (!src_isRecord(value)) continue;
+            const description = value["description"];
+            const parameters = value['parameters'];
+            const returnType = value['returnType'];
+            functions.push({
+                name,
+                ...'string' == typeof description ? {
+                    description
+                } : {},
+                parameters: src_isRecord(parameters) ? parameters : {
+                    type: 'object',
+                    properties: {},
+                    additionalProperties: false
+                },
+                returnType: isReturnType(returnType) ? returnType : 'any'
+            });
+        }
+    }
+    return functions.sort((left, right)=>left.name.localeCompare(right.name));
+}
+function readJsonObject(filePath) {
+    const value = JSON.parse(readFileSync(filePath, 'utf8'));
+    if (!src_isRecord(value)) throw new Error(`[a2ui-prompt] Expected JSON object in ${filePath}.`);
+    return value;
+}
+function readCatalogManifest(filePath) {
+    const manifest = readJsonObject(filePath);
+    const keys = Object.keys(manifest);
+    if (1 !== keys.length) throw new Error(`[a2ui-prompt] Expected exactly one component manifest in ${filePath}, found ${keys.length}.`);
+    const componentName = keys[0];
+    const schema = manifest[componentName];
+    if (!src_isRecord(schema)) throw new Error(`[a2ui-prompt] Expected JSON schema object for ${componentName} in ${filePath}.`);
+    return {
+        [componentName]: schema
+    };
+}
+function src_isRecord(value) {
+    return null !== value && 'object' == typeof value && !Array.isArray(value);
+}
+function isReturnType(value) {
+    return 'string' === value || 'number' === value || 'boolean' === value || 'array' === value || 'object' === value || 'any' === value || 'void' === value;
+}
+export { A2UI_PROTOCOL_VERSION, A2UI_SYSTEM_PROMPT, BASIC_CATALOG, BASIC_CATALOG_EXAMPLES, a2ui_catalog_BASIC_CATALOG_ID as BASIC_CATALOG_ID, buildA2UISystemPrompt, createA2UICatalogFromManifests, readA2UICatalogFromDirectory, renderCatalogReference };