@lynx-js/genui 0.0.1-rc.0 → 0.0.2

package/a2ui-prompt/README.md

@@ -37,8 +37,7 @@ const prompt = buildA2UISystemPrompt({ catalog });
 
 `readA2UICatalogFromDirectory` expects generated files such as
 `<Component>/catalog.json` and optional function definitions under `functions/`.
-Use `genui a2ui generate catalog` or
-`@lynx-js/genui/a2ui-catalog-extractor` to create those artifacts.
+Use `genui a2ui generate catalog` to create those artifacts.
 
 ## Exports
 

package/a2ui-prompt/dist/index.js

@@ -1,5 +1,5 @@
-import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
-import { join, resolve } from "node:path";
+import * as __rspack_external_node_fs_5ea92f0c from "node:fs";
+import * as __rspack_external_node_path_c5b9b54f from "node:path";
 const BASIC_CATALOG_ID = 'https://a2ui.org/specification/v0_9/basic_catalog.json';
 const BASIC_CATALOG_EXAMPLES = [
     {
@@ -13,6 +13,18 @@ const BASIC_CATALOG_EXAMPLES = [
                     catalogId: BASIC_CATALOG_ID
                 }
             },
+            {
+                version: 'v0.9',
+                updateDataModel: {
+                    surfaceId: 'main',
+                    value: {
+                        form: {
+                            email: '',
+                            password: ''
+                        }
+                    }
+                }
+            },
             {
                 version: 'v0.9',
                 updateComponents: {
@@ -82,18 +94,6 @@ const BASIC_CATALOG_EXAMPLES = [
                         }
                     ]
                 }
-            },
-            {
-                version: 'v0.9',
-                updateDataModel: {
-                    surfaceId: 'main',
-                    value: {
-                        form: {
-                            email: '',
-                            password: ''
-                        }
-                    }
-                }
             }
         ]
     },
@@ -108,6 +108,27 @@ const BASIC_CATALOG_EXAMPLES = [
                     catalogId: BASIC_CATALOG_ID
                 }
             },
+            {
+                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'
+                        }
+                    ]
+                }
+            },
             {
                 version: 'v0.9',
                 updateComponents: {
@@ -176,27 +197,6 @@ const BASIC_CATALOG_EXAMPLES = [
                         }
                     ]
                 }
-            },
-            {
-                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'
-                        }
-                    ]
-                }
             }
         ]
     },
@@ -211,6 +211,35 @@ const BASIC_CATALOG_EXAMPLES = [
                     catalogId: BASIC_CATALOG_ID
                 }
             },
+            {
+                version: 'v0.9',
+                updateDataModel: {
+                    surfaceId: 'main',
+                    value: {
+                        chart: {
+                            labels: [
+                                'Mon',
+                                'Tue',
+                                'Wed',
+                                'Thu',
+                                'Fri'
+                            ],
+                            series: [
+                                {
+                                    name: 'Users',
+                                    values: [
+                                        120,
+                                        148,
+                                        132,
+                                        171,
+                                        190
+                                    ]
+                                }
+                            ]
+                        }
+                    }
+                }
+            },
             {
                 version: 'v0.9',
                 updateComponents: {
@@ -251,35 +280,6 @@ const BASIC_CATALOG_EXAMPLES = [
                         }
                     ]
                 }
-            },
-            {
-                version: 'v0.9',
-                updateDataModel: {
-                    surfaceId: 'main',
-                    value: {
-                        chart: {
-                            labels: [
-                                'Mon',
-                                'Tue',
-                                'Wed',
-                                'Thu',
-                                'Fri'
-                            ],
-                            series: [
-                                {
-                                    name: 'Users',
-                                    values: [
-                                        120,
-                                        148,
-                                        132,
-                                        171,
-                                        190
-                                    ]
-                                }
-                            ]
-                        }
-                    }
-                }
             }
         ]
     },
@@ -338,9 +338,11 @@ const BASIC_CATALOG_EXAMPLES = [
 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 ChoicePicker_catalog_namespaceObject = JSON.parse('{"ChoicePicker":{"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 group of options."},"variant":{"type":"string","enum":["multipleSelection","mutuallyExclusive"],"description":"A hint for how the choice picker should be displayed and behave."},"options":{"type":"array","items":{"type":"object","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 text to display for this option."},"value":{"type":"string","description":"The stable value associated with this option."}},"required":["label","value"],"additionalProperties":false},"description":"The list of available options to choose from."},"value":{"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 currently selected values."},"displayStyle":{"type":"string","enum":["checkbox","chips"],"description":"The display style of the component."},"filterable":{"type":"boolean","description":"If true, displays a search input to filter the options."},"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":["options","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 DateTimeInput_catalog_namespaceObject = JSON.parse('{"DateTimeInput":{"properties":{"value":{"oneOf":[{"type":"string"},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false}],"description":"The current date/time value. Typically bound to a data path."},"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 text label for the input field."},"enableDate":{"type":"boolean","description":"Whether to show the date picker."},"enableTime":{"type":"boolean","description":"Whether to show the time picker."},"outputFormat":{"type":"string","description":"Format string for the output value. Supports YYYY, MM, DD, HH, and mm."},"min":{"type":"string","description":"Minimum allowed date/time value."},"max":{"type":"string","description":"Maximum allowed date/time value."},"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":["value"]}}');
 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 Icon_catalog_namespaceObject = JSON.parse('{"Icon":{"properties":{"name":{"oneOf":[{"type":"string","enum":["account_circle","add","arrow_back","arrow_forward","camera","check","close","delete","edit","error","favorite","help","home","info","location_on","lock","mail","menu","more_vert","pause","person","play_arrow","refresh","search","send","settings","share","star","warning"]},{"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false}],"description":"Google Material icon ligature name, e.g. \\"info\\", \\"account_circle\\", \\"arrow_back\\"."},"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"]}}');
@@ -349,7 +351,7 @@ var RadioGroup_catalog_namespaceObject = JSON.parse('{"RadioGroup":{"properties"
 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 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"]},"emphasis":{"type":"string","enum":["medium","strong"]}},"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 = [
@@ -367,6 +369,8 @@ const CATALOG_MANIFESTS = [
     catalog_namespaceObject,
     TextField_catalog_namespaceObject,
     CheckBox_catalog_namespaceObject,
+    ChoicePicker_catalog_namespaceObject,
+    DateTimeInput_catalog_namespaceObject,
     RadioGroup_catalog_namespaceObject,
     Slider_catalog_namespaceObject
 ];
@@ -374,7 +378,9 @@ 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.',
+    ChoicePicker: 'Single- or multi-select choice picker with checkbox and chip display styles.',
     Column: 'Vertical layout container.',
+    DateTimeInput: 'Date and/or time input with a calendar panel. Without outputFormat, date-enabled inputs write YYYY-MM-DD.',
     Divider: 'Horizontal or vertical separator line.',
     Icon: 'Display an icon by name.',
     Image: 'Display an image by URL.',
@@ -562,17 +568,23 @@ and exactly ONE of the following keys:
 
 ## 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
+2. updateDataModel for every initial value referenced by a { "path": ... }
+   binding. Send this before the first component that reads those paths.
+3. updateComponents (the FIRST one MUST contain a component whose id is "root")
+4. (optional) further updateDataModel / updateComponents for incremental UI.
+   For each incremental bound component, send its data model value first, then
+   send the component that binds to it.
 
 ## 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.
+  may reference data paths, but for smooth streaming those paths SHOULD already
+  be populated by an earlier updateDataModel in the same response.
+- updateDataModel has shape:
+    { "version": "v0.9",
+      "updateDataModel": { "surfaceId": string, "path"?: string, "value"?: any } }
+  "path" defaults to "/" and "value" may be any JSON value.
 - deleteSurface removes a surface when the UI is no longer needed.
 
 ## Component model
@@ -618,35 +630,57 @@ function buildHardRules(catalogId) {
 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
+3. Output pretty-printed JSON with 2-space indentation. Do NOT emit minified
+   single-line JSON. Put each message object and each component object on its
+   own lines so brackets and braces stay balanced.
+4. Before finishing, check the final characters: every component object closes
+   once, every "components" array closes once, every message object closes
+   once, and the outer array closes exactly once.
+5. 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
+6. For "{path:...}" bindings, send updateDataModel before the first
+   updateComponents message that contains components reading those paths. After
+   createSurface, either send a literal root/skeleton updateComponents first, or
+   send updateDataModel first when the first visible components use bindings.
+7. For a fresh non-action response, the first updateComponents message MUST
+   contain exactly one component with id "root".
+8. 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
+9. Children are referenced by id only. NEVER inline a child component.
+10. Container references MUST point to components present in the same response.
+11. Card.child is exactly one id; wrap multiple elements in Row/Column/List.
+12. Buttons MUST include a dispatchable "action": either non-empty
+   "action.event.name" or non-empty "action.functionCall.call". Button has NO
+   "label" prop – provide the label via a child Text component
+   ("child": "<text-id>").
+13. When using Modal for a confirmation flow, do NOT put the server action on
+   the Modal trigger. The trigger only opens the modal. Put a separate confirm
+   Button inside Modal.content, and attach the action to that confirm Button.
+14. Render a Modal by placing the Modal component itself where the trigger
+   should appear. Do NOT also list the trigger component as a sibling in the
+   parent container, because Modal renders its trigger internally.
+15. The "weight" prop is only a small Row/Column child layout ratio, not CSS
+   font-weight. Do NOT use values like 400, 500, 600, or 700 for typography.
+   Use Text.variant for base typography and Text.emphasis ("medium" or
+   "strong") for extra text emphasis.
+16. Ids are kebab-case, unique per surface ("root", "title-text", "submit-btn").
+17. Do not invent components outside the catalog.
+18. No comments, trailing commas or unknown fields.
+19. 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
+20. 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
+21. For action responses, prefer the smallest valid patch: one updateDataModel
+    for changed data, plus one updateComponents only if the visible structure
+    needs to change.
+22. 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
+23. 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.
 `;
@@ -686,17 +720,17 @@ function buildA2UISystemPrompt(opts = {}) {
 }
 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 cwd = options.cwd ? __rspack_external_node_path_c5b9b54f.resolve(options.cwd) : process.cwd();
+    const catalogDir = __rspack_external_node_path_c5b9b54f.resolve(cwd, options.catalogDir);
+    if (!__rspack_external_node_fs_5ea92f0c.existsSync(catalogDir)) throw new Error(`[a2ui-prompt] Catalog directory does not exist: ${options.catalogDir}`);
+    if (!__rspack_external_node_fs_5ea92f0c.statSync(catalogDir).isDirectory()) throw new Error(`[a2ui-prompt] Catalog path is not a directory: ${options.catalogDir}`);
     const componentManifests = [];
-    for (const entry of readdirSync(catalogDir, {
+    for (const entry of __rspack_external_node_fs_5ea92f0c.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));
+        const catalogJsonPath = __rspack_external_node_path_c5b9b54f.join(catalogDir, entry.name, 'catalog.json');
+        if (__rspack_external_node_fs_5ea92f0c.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({
@@ -712,15 +746,15 @@ function readA2UICatalogFromDirectory(options) {
     });
 }
 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 functionsDir = __rspack_external_node_path_c5b9b54f.join(catalogDir, 'functions');
+    if (!__rspack_external_node_fs_5ea92f0c.existsSync(functionsDir)) return [];
+    if (!__rspack_external_node_fs_5ea92f0c.statSync(functionsDir).isDirectory()) throw new Error(`[a2ui-prompt] Expected functions directory at ${functionsDir}.`);
     const functions = [];
-    for (const entry of readdirSync(functionsDir, {
+    for (const entry of __rspack_external_node_fs_5ea92f0c.readdirSync(functionsDir, {
         withFileTypes: true
     })){
         if (!entry.isFile() || !entry.name.endsWith('.json')) continue;
-        const functionRecord = readJsonObject(join(functionsDir, entry.name));
+        const functionRecord = readJsonObject(__rspack_external_node_path_c5b9b54f.join(functionsDir, entry.name));
         for (const [name, value] of Object.entries(functionRecord)){
             if (!src_isRecord(value)) continue;
             const description = value["description"];
@@ -743,7 +777,7 @@ function readFunctionDefinitions(catalogDir) {
     return functions.sort((left, right)=>left.name.localeCompare(right.name));
 }
 function readJsonObject(filePath) {
-    const value = JSON.parse(readFileSync(filePath, 'utf8'));
+    const value = JSON.parse(__rspack_external_node_fs_5ea92f0c.readFileSync(filePath, 'utf8'));
     if (!src_isRecord(value)) throw new Error(`[a2ui-prompt] Expected JSON object in ${filePath}.`);
     return value;
 }

package/cli/bin/cli.js

@@ -266,6 +266,9 @@ function printPackageVersion() {
 }
 
 function isMain(moduleUrl) {
-  return process.argv[1] !== undefined
-    && moduleUrl === pathToFileURL(process.argv[1]).href;
+  if (process.argv[1] === undefined) {
+    return false;
+  }
+
+  return moduleUrl === pathToFileURL(fs.realpathSync(process.argv[1])).href;
 }