pxengine 0.1.66 → 0.1.68

package/dist/registry.json

@@ -1,7 +1,7 @@
 {
   "name": "@pxengine/ui",
   "version": "1.0.0",
-  "lastUpdated": "2026-04-28T09:34:09.074Z",
+  "lastUpdated": "2026-04-29T05:21:50.138Z",
   "components": {
     "AccordionAtom": {
       "name": "AccordionAtom",
@@ -490,8 +490,13 @@
         },
         "action": {
           "type": "string",
+          "required": true,
+          "description": "REQUIRED — Submission handler action.\n- \"submit\": Collects all sibling inputs and sends them as Q/A pairs to the agent via Run SSE\n- \"reset\": Clears all input values\n- \"cancel\": Closes/cancels the widget\n- \"next\" / \"back\": Multi-step navigation\n- \"custom\": User-defined handler via onAction prop"
+        },
+        "actionPayload": {
+          "type": "record<string, any>",
           "required": false,
-          "description": ""
+          "description": "Optional payload key sent alongside Q/A pairs (e.g. agent name, custom intent)"
         },
         "disabled": {
           "type": "boolean",
@@ -5839,6 +5844,21 @@
           "required": true,
           "description": ""
         },
+        "label": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
+        "question": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
+        "fieldKey": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
         "mode": {
           "type": "enum",
           "required": false,
@@ -6128,6 +6148,16 @@
           "required": false,
           "description": ""
         },
+        "question": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
+        "fieldKey": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
         "checked": {
           "type": "boolean",
           "required": false,
@@ -12031,12 +12061,14 @@
           "description": "",
           "enums": [
             "number",
+            "color",
             "checkbox",
             "radio",
             "search",
             "slider",
             "switch",
             "date",
+            "time",
             "text",
             "email",
             "password",
@@ -12045,13 +12077,20 @@
             "textarea",
             "select",
             "otp",
+            "datetime-local",
+            "file",
             "dropdown"
           ]
         },
         "label": {
           "type": "string",
           "required": false,
-          "description": ""
+          "description": "Visible label for the field — auto-used as the Q in Q/A submission if `question` is unset"
+        },
+        "question": {
+          "type": "string",
+          "required": false,
+          "description": "Explicit Q text used when serializing this input for agent submission. Falls back to `label`."
         },
         "placeholder": {
           "type": "string",
@@ -12088,6 +12127,11 @@
           "required": false,
           "description": ""
         },
+        "fieldKey": {
+          "type": "string",
+          "required": false,
+          "description": "Stable key for the answer in Q/A submission. Defaults to id."
+        },
         "id": {
           "type": "string",
           "required": true,
@@ -12134,6 +12178,21 @@
           "required": true,
           "description": ""
         },
+        "label": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
+        "question": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
+        "fieldKey": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
         "length": {
           "type": "number",
           "required": true,
@@ -12546,6 +12605,21 @@
           "required": true,
           "description": ""
         },
+        "label": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
+        "question": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
+        "fieldKey": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
         "options": {
           "type": "{ label: string; value: string; }[]",
           "required": true,
@@ -12613,13 +12687,28 @@
       "name": "RatingAtom",
       "type": "atom",
       "isBuilderComponent": true,
-      "description": "RatingAtom\nA star rating component for display or user input.",
+      "description": "RatingAtom\nA star rating component for display or user input, with optional label.",
       "props": {
         "type": {
           "type": "\"rating\"",
           "required": true,
           "description": ""
         },
+        "label": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
+        "question": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
+        "fieldKey": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
         "value": {
           "type": "number",
           "required": true,
@@ -12949,13 +13038,28 @@
       "name": "SliderAtom",
       "type": "atom",
       "isBuilderComponent": false,
-      "description": "SliderAtom\nWraps shadcn Slider",
+      "description": "SliderAtom\nWraps shadcn Slider with optional label",
       "props": {
         "type": {
           "type": "\"slider\"",
           "required": true,
           "description": ""
         },
+        "label": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
+        "question": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
+        "fieldKey": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
         "defaultValue": {
           "type": "number[]",
           "required": false,
@@ -13083,6 +13187,16 @@
           "required": false,
           "description": ""
         },
+        "question": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
+        "fieldKey": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
         "checked": {
           "type": "boolean",
           "required": false,
@@ -13300,12 +13414,14 @@
           "description": "",
           "enums": [
             "number",
+            "color",
             "checkbox",
             "radio",
             "search",
             "slider",
             "switch",
             "date",
+            "time",
             "text",
             "email",
             "password",
@@ -13314,13 +13430,20 @@
             "textarea",
             "select",
             "otp",
+            "datetime-local",
+            "file",
             "dropdown"
           ]
         },
         "label": {
           "type": "string",
           "required": false,
-          "description": ""
+          "description": "Visible label for the field — auto-used as the Q in Q/A submission if `question` is unset"
+        },
+        "question": {
+          "type": "string",
+          "required": false,
+          "description": "Explicit Q text used when serializing this input for agent submission. Falls back to `label`."
         },
         "placeholder": {
           "type": "string",
@@ -13357,6 +13480,11 @@
           "required": false,
           "description": ""
         },
+        "fieldKey": {
+          "type": "string",
+          "required": false,
+          "description": "Stable key for the answer in Q/A submission. Defaults to id."
+        },
         "id": {
           "type": "string",
           "required": true,
@@ -16296,6 +16424,84 @@
       "preview": null,
       "layoutHints": null
     },
+    "InputWidget": {
+      "name": "InputWidget",
+      "type": "molecule",
+      "isBuilderComponent": true,
+      "description": "InputWidget\n\nA self-contained input molecule that *guarantees*:\n  1. Every field has a label (no headless inputs)\n  2. A submit button is always rendered\n  3. On submit, all field values are formatted as Q/A pairs and handed\n     back to the caller for transmission via Run SSE.\n\nThis is the canonical wrapper for any user-facing input widget built in\nthe widget builder.",
+      "props": {
+        "onSubmit": {
+          "type": "(qamessage: string, fields: collectedfield[]) => void",
+          "required": false,
+          "description": "Called when the submit button is pressed.\nReceives the formatted Q/A message string AND the structured field list.\nCaller wires this to a Run SSE sendMessage handler."
+        },
+        "onAction": {
+          "type": "(action: string, payload?: record<string, any>) => void",
+          "required": false,
+          "description": "Called for any non-submit button action (cancel, reset, custom)."
+        },
+        "isSubmitting": {
+          "type": "boolean",
+          "required": false,
+          "defaultValue": "false",
+          "description": ""
+        },
+        "id": {
+          "type": "string",
+          "required": true,
+          "description": ""
+        },
+        "type": {
+          "type": "\"input-widget\"",
+          "required": true,
+          "description": ""
+        },
+        "title": {
+          "type": "string",
+          "required": false,
+          "description": "Heading shown above the field (optional — falls back to field label)."
+        },
+        "description": {
+          "type": "string",
+          "required": false,
+          "description": "Description / helper text shown under the title (optional)."
+        },
+        "fields": {
+          "type": "inputwidgetfield[]",
+          "required": true,
+          "description": "The fields that make up this input widget — at least one is required."
+        },
+        "submitButton": {
+          "type": "enum",
+          "required": false,
+          "description": "Submit button config — auto-included with action: \"submit\" by default.",
+          "enums": [
+            "{ label?: string; action: string; actionPayload?: Record<string, any>; variant?: default",
+            "secondary",
+            "outline",
+            "purple",
+            "gradient; }"
+          ]
+        },
+        "secondaryButton": {
+          "type": "{ label?: string; action: string; }",
+          "required": false,
+          "description": "Optional secondary button (cancel/reset/back)."
+        },
+        "className": {
+          "type": "string",
+          "required": false,
+          "description": ""
+        },
+        "style": {
+          "type": "cssproperties",
+          "required": false,
+          "description": ""
+        }
+      },
+      "preview": null,
+      "layoutHints": null
+    },
     "LoadingOverlay": {
       "name": "LoadingOverlay",
       "type": "molecule",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pxengine",
-  "version": "0.1.66",
+  "version": "0.1.68",
   "type": "module",
   "description": "Shadcn-based UI component library for agent-driven interfaces",
   "main": "./dist/index.cjs",