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

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 = [
     {
@@ -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"]}}');
@@ -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.',
@@ -573,6 +579,10 @@ and exactly ONE of the following keys:
   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.
+  Its fields MUST be nested inside "updateDataModel":
+    { "version": "v0.9",
+      "updateDataModel": { "surfaceId": "main", "path": "/", "value": {} } }
+  Never put "path" beside "updateDataModel" at the top level of the message.
 - deleteSurface removes a surface when the UI is no longer needed.
 
 ## Component model
@@ -618,35 +628,59 @@ 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
+6. 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
+7. 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"
+8. Children are referenced by id only. NEVER inline a child component.
+9. Container references MUST point to components present in the same response.
+10. Card.child is exactly one id; wrap multiple elements in Row/Column/List.
+11. 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
+12. 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.
+13. 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.
+14. The "weight" prop is a small layout ratio for Row/Column children, not CSS
+   font-weight. Do NOT use values like 400, 500, 600, or 700 for typography.
+   Use text variants for typography, and use small weights such as 1, 1.5, 2,
+   3, or 5 only when balancing sibling layout.
+15. 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
+16. In an updateDataModel message, "path" MUST be inside "updateDataModel",
+    never at the top level. Correct:
+    { "version": "v0.9", "updateDataModel": { "surfaceId": "main", "path": "/", "value": {} } }
+    Wrong:
+    { "version": "v0.9", "updateDataModel": { "surfaceId": "main", "value": {} }, "path": "/" }
+17. Ids are kebab-case, unique per surface ("root", "title-text", "submit-btn").
+18. Do not invent components outside the catalog.
+19. No comments, trailing commas or unknown fields.
+20. 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
+21. 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
+22. For action responses, prefer the smallest valid patch: one updateDataModel
+    for changed data, plus one updateComponents only if the visible structure
+    needs to change.
+23. 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
+24. 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;
 }