pxengine 0.1.159 → 0.1.160

package/dist/registry.json

@@ -1,7 +1,7 @@
 {
   "name": "@pxengine/ui",
   "version": "1.0.0",
-  "lastUpdated": "2026-09-18T06:34:58.052Z",
+  "lastUpdated": "2026-09-21T08:12:00.867Z",
   "components": {
     "AccordionAtom": {
       "name": "AccordionAtom",
@@ -8673,60 +8673,6 @@
       },
       "category": null
     },
-    "FilterBar": {
-      "name": "FilterBar",
-      "type": "molecule",
-      "isBuilderComponent": true,
-      "description": "FilterBar\nA horizontal bar with active filter chips and search.",
-      "props": {
-        "type": {
-          "type": "\"filter-bar\"",
-          "required": true,
-          "description": ""
-        },
-        "filters": {
-          "type": "{ label: string; value: string; active?: boolean; }[]",
-          "required": true,
-          "description": ""
-        },
-        "showSearch": {
-          "type": "boolean",
-          "required": false,
-          "defaultValue": "true",
-          "description": ""
-        },
-        "id": {
-          "type": "string",
-          "required": true,
-          "description": ""
-        },
-        "className": {
-          "type": "string",
-          "required": false,
-          "description": ""
-        },
-        "style": {
-          "type": "cssproperties",
-          "required": false,
-          "description": ""
-        },
-        "onFilterToggle": {
-          "type": "(val: string) => void",
-          "required": false,
-          "description": ""
-        },
-        "onSearch": {
-          "type": "(val: string) => void",
-          "required": false,
-          "description": ""
-        }
-      },
-      "preview": null,
-      "layoutHints": {
-        "height": 90
-      },
-      "category": "form"
-    },
     "FormCard": {
       "name": "FormCard",
       "type": "molecule",
@@ -10060,6 +10006,97 @@
       },
       "category": "list"
     },
+    "QuestionnaireCard": {
+      "name": "QuestionnaireCard",
+      "type": "molecule",
+      "isBuilderComponent": true,
+      "description": "QuestionnaireCard\n\nA molecule for asking a themed set of questions as one paginated card,\ninstead of one MCQCard block per question. Modeled on the\nClaude/ChatGPT onboarding-preferences UI: dark rounded card, minimal\nheader with pagination chevrons + \"X of N\" + close, plain option rows,\nsmall pill action button.\n\nSelf-contained: when `sessionId` + `sendMessage` are provided, it manages\nits own persistence and agent communication, keyed by\n(sessionId, cardId, questionId) since one card instance holds multiple\nquestions.",
+      "props": {
+        "questions": {
+          "type": "questionnairequestion[]",
+          "required": true,
+          "description": "The set of questions to ask, in order."
+        },
+        "cardId": {
+          "type": "string",
+          "required": false,
+          "description": "Stable identifier for this card instance, used (together with sessionId\nand each question's id) to key persisted answers. Defaults to a hash of\nthe question ids/text, so the same schema resolves to the same card\nacross reloads without one being explicitly provided."
+        },
+        "answers": {
+          "type": "record<string, questionnaireanswer>",
+          "required": false,
+          "description": "Pre-existing answers, keyed by questionId (historical/reload view)."
+        },
+        "onAnswer": {
+          "type": "(answer: questionnaireanswer) => void",
+          "required": false,
+          "description": "Fires whenever a question is answered, edited, or skipped."
+        },
+        "onComplete": {
+          "type": "(answers: record<string, questionnaireanswer>) => void",
+          "required": false,
+          "description": "Fires once every question has been answered or skipped."
+        },
+        "onClose": {
+          "type": "() => void",
+          "required": false,
+          "description": "Fires when the user dismisses the whole card via the close (X) button."
+        },
+        "isLatestMessage": {
+          "type": "boolean",
+          "required": false,
+          "description": "Whether this message is the latest (controls interactivity). Chevron\nnavigation stays available even when false, so a historical card can\nstill be browsed read-only."
+        },
+        "isLoading": {
+          "type": "boolean",
+          "required": false,
+          "description": "Loading state during submission."
+        },
+        "className": {
+          "type": "string",
+          "required": false,
+          "description": "Custom wrapper class name."
+        },
+        "onAction": {
+          "type": "(action: any) => void",
+          "required": false,
+          "description": "Optional action callback for external state management (e.g. PXEngine)."
+        },
+        "disabled": {
+          "type": "boolean",
+          "required": false,
+          "description": "Whether the interaction is disabled externally."
+        },
+        "theme": {
+          "type": "widgettheme",
+          "required": false,
+          "description": "Optional brand theme."
+        },
+        "sessionId": {
+          "type": "string",
+          "required": false,
+          "description": "Session ID for self-contained persistence."
+        },
+        "sendMessage": {
+          "type": "(text: string) => void",
+          "required": false,
+          "description": "Callback to send a message to the agent. Called once per question, the\nfirst time the user navigates past it (or when the questionnaire\ncompletes / is closed) with any unrecorded answers still pending."
+        },
+        "fetchSelections": {
+          "type": "(sessionid: string) => promise<record<string, string>>",
+          "required": false,
+          "description": "Custom fetcher for loading existing answers for this session.\nDefaults to hitting the generic custom-agent session-state endpoint\n(`state_key: \"questionnaire_selections\"`), the same infra MCQCard's\ndefault fetchers build on. Returns a flat map of\n`${cardId}::${questionId}` -> JSON-encoded answer string."
+        },
+        "persistSelection": {
+          "type": "(sessionid: string, questionkey: string, value: string) => promise<void>",
+          "required": false,
+          "description": "Custom persister for a single question's answer, keyed by\n`${cardId}::${questionId}` — mirrors MCQCard's\nfetchSelections/persistSelection signature, extended to key by\n(sessionId, cardId, questionId) since a card instance now holds\nmultiple questions."
+        }
+      },
+      "preview": null,
+      "layoutHints": null,
+      "category": null
+    },
     "RecommendationCard": {
       "name": "RecommendationCard",
       "type": "molecule",
@@ -10618,50 +10655,6 @@
       "layoutHints": null,
       "category": null
     },
-    "TagCloud": {
-      "name": "TagCloud",
-      "type": "molecule",
-      "isBuilderComponent": true,
-      "description": "TagCloud\nA cluster of clickable tags.",
-      "props": {
-        "type": {
-          "type": "\"tag-cloud\"",
-          "required": true,
-          "description": ""
-        },
-        "tags": {
-          "type": "{ label: string; value: string; count?: number; }[]",
-          "required": false,
-          "defaultValue": "[]",
-          "description": ""
-        },
-        "id": {
-          "type": "string",
-          "required": true,
-          "description": ""
-        },
-        "className": {
-          "type": "string",
-          "required": false,
-          "description": ""
-        },
-        "style": {
-          "type": "cssproperties",
-          "required": false,
-          "description": ""
-        },
-        "onTagClick": {
-          "type": "(val: string) => void",
-          "required": false,
-          "description": ""
-        }
-      },
-      "preview": null,
-      "layoutHints": {
-        "height": 100
-      },
-      "category": "list"
-    },
     "TimelineCard": {
       "name": "TimelineCard",
       "type": "molecule",
@@ -10704,106 +10697,6 @@
         "height": 240
       },
       "category": "list"
-    },
-    "WebSearchJobCard": {
-      "name": "WebSearchJobCard",
-      "type": "molecule",
-      "isBuilderComponent": true,
-      "description": "",
-      "props": {
-        "job_id": {
-          "type": "string",
-          "required": true,
-          "description": "Unique job identifier"
-        },
-        "title": {
-          "type": "string",
-          "required": false,
-          "description": "Card title — typically the search query"
-        },
-        "status": {
-          "type": "enum",
-          "required": true,
-          "description": "Current job status",
-          "enums": [
-            "complete",
-            "failed",
-            "pending",
-            "running"
-          ]
-        },
-        "query": {
-          "type": "string",
-          "required": false,
-          "description": "The search query string"
-        },
-        "result_count": {
-          "type": "number",
-          "required": false,
-          "description": "Total number of results returned"
-        },
-        "search_count": {
-          "type": "number",
-          "required": false,
-          "description": "Number of web searches performed"
-        },
-        "summary": {
-          "type": "string",
-          "required": false,
-          "description": "2-3 sentence summary of findings"
-        },
-        "results": {
-          "type": "websearchresult[]",
-          "required": false,
-          "description": "Structured search results"
-        },
-        "error": {
-          "type": "string",
-          "required": false,
-          "description": "Error message if job failed"
-        },
-        "progress": {
-          "type": "jobprogress",
-          "required": false,
-          "description": "Real-time progress information (populated during pending/running)"
-        },
-        "pollUrl": {
-          "type": "string",
-          "required": false,
-          "description": "URL to poll for status updates"
-        },
-        "authToken": {
-          "type": "string",
-          "required": false,
-          "description": "Auth token for polling requests"
-        },
-        "className": {
-          "type": "string",
-          "required": false,
-          "description": "Additional CSS classes"
-        },
-        "onComplete": {
-          "type": "(output: websearchjoboutput) => void",
-          "required": false,
-          "description": "Callback when job completes"
-        },
-        "onFailed": {
-          "type": "(error: string) => void",
-          "required": false,
-          "description": "Callback when job fails"
-        },
-        "compact": {
-          "type": "boolean",
-          "required": false,
-          "defaultValue": "false",
-          "description": "Compact mode — hides the results list, shows only header and summary."
-        }
-      },
-      "preview": null,
-      "layoutHints": {
-        "height": 320
-      },
-      "category": "list"
     }
   }
 }

package/package.json

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