xiaohao-components 0.0.0-stage → 0.1.0

package/dist/fixtures.js

@@ -0,0 +1,540 @@
+const n = JSON.stringify(
+  {
+    messages: [
+      {
+        version: "v0.9",
+        createSurface: {
+          surfaceId: "cloud-console",
+          catalogId: "https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json"
+        }
+      },
+      {
+        version: "v0.9",
+        updateComponents: {
+          surfaceId: "cloud-console",
+          components: [
+            {
+              id: "root",
+              component: "Column",
+              children: ["title", "summary", "svcList", "message", "divider", "footer"]
+            },
+            { id: "title", component: "Text", text: "云端部署控制台", variant: "h3" },
+            { id: "summary", component: "Text", text: { path: "/summary" }, variant: "caption" },
+            {
+              id: "svcList",
+              component: "List",
+              direction: "vertical",
+              children: { componentId: "svcRow", path: "/services" }
+            },
+            {
+              id: "svcRow",
+              component: "Row",
+              children: ["svcName", "svcStatus", "svcReplicas", "svcActions"]
+            },
+            { id: "svcName", component: "Text", text: { path: "name" } },
+            { id: "svcStatus", component: "Text", text: { path: "status" }, variant: "caption" },
+            {
+              id: "svcReplicas",
+              component: "Text",
+              text: { path: "replicas" },
+              variant: "caption"
+            },
+            {
+              id: "svcActions",
+              component: "Row",
+              children: ["scaleBtn", "restartBtn"]
+            },
+            {
+              id: "scaleBtn",
+              component: "Button",
+              variant: "primary",
+              child: "scaleBtnText",
+              action: {
+                event: { name: "scale_up_service", context: { service: { path: "name" } } }
+              }
+            },
+            { id: "scaleBtnText", component: "Text", text: "扩容" },
+            {
+              id: "restartBtn",
+              component: "Button",
+              variant: "default",
+              child: "restartBtnText",
+              action: {
+                event: { name: "restart_service", context: { service: { path: "name" } } }
+              }
+            },
+            { id: "restartBtnText", component: "Text", text: "重启" },
+            { id: "message", component: "Text", text: { path: "/message" }, variant: "caption" },
+            { id: "divider", component: "Divider" },
+            {
+              id: "footer",
+              component: "Text",
+              text: "点任一按钮都会真实调用工具，结果写回这张卡",
+              variant: "caption"
+            }
+          ]
+        }
+      }
+    ]
+  },
+  null,
+  2
+), i = {
+  "/services": [
+    { name: "gateway-api", status: "running", replicas: 3 },
+    { name: "order-service", status: "running", replicas: 2 },
+    { name: "report-job", status: "degraded", replicas: 1 }
+  ],
+  "/summary": "共 3 个服务 · 2 个运行中 · 1 个异常",
+  "/message": "控制台已打开"
+}, c = JSON.stringify(
+  {
+    messages: [
+      {
+        version: "v0.9",
+        createSurface: {
+          surfaceId: "waybill-form",
+          catalogId: "https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json"
+        }
+      },
+      {
+        version: "v0.9",
+        updateComponents: {
+          surfaceId: "waybill-form",
+          components: [
+            {
+              id: "root",
+              component: "Column",
+              children: [
+                "title",
+                "shipperField",
+                "consigneeField",
+                "goodsField",
+                "quantityField",
+                "status",
+                "submit"
+              ]
+            },
+            { id: "title", component: "Text", text: "运单录入", variant: "h3" },
+            {
+              id: "shipperField",
+              component: "TextField",
+              label: "发货人",
+              variant: "shortText",
+              value: { path: "/shipper" }
+            },
+            {
+              id: "consigneeField",
+              component: "TextField",
+              label: "收货人",
+              variant: "shortText",
+              value: { path: "/consignee" }
+            },
+            {
+              id: "goodsField",
+              component: "TextField",
+              label: "货物名称",
+              variant: "shortText",
+              value: { path: "/goods" }
+            },
+            {
+              id: "quantityField",
+              component: "TextField",
+              label: "数量",
+              variant: "number",
+              value: { path: "/quantity" }
+            },
+            { id: "status", component: "Text", text: { path: "/status" }, variant: "caption" },
+            {
+              id: "submit",
+              component: "Button",
+              variant: "primary",
+              child: "submitText",
+              action: {
+                event: {
+                  name: "submit_waybill",
+                  context: {
+                    shipper: { path: "/shipper" },
+                    consignee: { path: "/consignee" },
+                    goods: { path: "/goods" },
+                    quantity: { path: "/quantity" }
+                  }
+                }
+              }
+              // 刻意不写 `checks`：`/formValid` 没有任何一方会置真，加上的效果是
+              // 按钮永远禁用（引擎把 checks 编译成 isValid）。提交后的冻结由
+              // 客户端 shouldFreeze 按回包的 `/submitted === true` 负责。
+            },
+            { id: "submitText", component: "Text", text: "创建运单" }
+          ]
+        }
+      }
+    ]
+  },
+  null,
+  2
+), s = {
+  "/status": "待提交",
+  "/message": "请填写运单信息",
+  "/shipper": "深圳小好科技有限公司",
+  "/consignee": "上海云之梦科技有限公司",
+  "/goods": "文件",
+  "/quantity": 2
+}, t = "deploy-console", r = JSON.stringify(
+  {
+    messages: [
+      {
+        version: "v0.9",
+        createSurface: {
+          surfaceId: t,
+          catalogId: "https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json"
+        }
+      },
+      {
+        version: "v0.9",
+        updateComponents: {
+          surfaceId: t,
+          components: [
+            {
+              id: "root",
+              component: "Column",
+              children: ["title", "keyword", "serviceSelect", "versionSelect", "status", "actions"]
+            },
+            { id: "title", component: "Text", text: "部署控制台", variant: "h3" },
+            {
+              id: "keyword",
+              component: "TextField",
+              label: "关键字",
+              variant: "shortText",
+              value: { path: "/keyword" }
+            },
+            {
+              id: "serviceSelect",
+              component: "ChoicePicker",
+              label: "服务",
+              options: { source: "/services", label: "name", value: "id" },
+              value: { path: "/selectedService" },
+              variant: "mutuallyExclusive"
+            },
+            {
+              id: "versionSelect",
+              component: "ChoicePicker",
+              label: "版本",
+              options: { source: "/versions", label: "name", value: "id" },
+              value: { path: "/selectedVersion" },
+              variant: "mutuallyExclusive"
+            },
+            { id: "status", component: "Text", text: { path: "/status" }, variant: "caption" },
+            {
+              id: "actions",
+              component: "Row",
+              children: ["action_0", "action_1", "action_2"]
+            },
+            {
+              id: "action_0",
+              component: "Button",
+              variant: "default",
+              child: "action_0_text",
+              action: {
+                event: { name: "search_services", context: { keyword: { path: "/keyword" } } }
+              }
+            },
+            { id: "action_0_text", component: "Text", text: "搜索" },
+            {
+              id: "action_1",
+              component: "Button",
+              variant: "default",
+              child: "action_1_text",
+              action: {
+                event: {
+                  name: "list_versions",
+                  context: { selectedService: { path: "/selectedService" } }
+                }
+              }
+            },
+            { id: "action_1_text", component: "Text", text: "加载版本" },
+            {
+              id: "action_2",
+              component: "Button",
+              variant: "primary",
+              child: "action_2_text",
+              action: {
+                event: {
+                  name: "submit_deployment",
+                  context: {
+                    selectedService: { path: "/selectedService" },
+                    selectedVersion: { path: "/selectedVersion" }
+                  }
+                }
+              }
+            },
+            { id: "action_2_text", component: "Text", text: "提交部署" }
+          ]
+        }
+      }
+    ]
+  },
+  null,
+  2
+), e = "waybill-track", l = JSON.stringify(
+  {
+    messages: [
+      {
+        version: "v0.9",
+        createSurface: {
+          surfaceId: e,
+          catalogId: "https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json"
+        }
+      },
+      {
+        version: "v0.9",
+        updateComponents: {
+          surfaceId: e,
+          components: [
+            {
+              id: "root",
+              component: "Column",
+              children: [
+                "title",
+                "subtitle",
+                "queryRow",
+                "status",
+                "dividerTop",
+                "tableCard",
+                "dividerBottom",
+                "formTitle",
+                "operatorField",
+                "prioritySelect",
+                "carrierSelect",
+                "remarkField",
+                "submitRow"
+              ]
+            },
+            { id: "title", component: "Text", text: "运单轨迹", variant: "h3" },
+            {
+              id: "subtitle",
+              component: "Text",
+              text: "输入运单号点「查询」，轨迹按时间列出",
+              variant: "caption"
+            },
+            { id: "queryRow", component: "Row", children: ["waybillField", "queryBtn"] },
+            {
+              id: "waybillField",
+              component: "TextField",
+              label: "运单号",
+              variant: "shortText",
+              value: { path: "/waybillNo" }
+            },
+            {
+              id: "queryBtn",
+              component: "Button",
+              variant: "default",
+              child: "queryBtnText",
+              action: {
+                event: { name: "search_tracks", context: { waybillNo: { path: "/waybillNo" } } }
+              }
+            },
+            { id: "queryBtnText", component: "Text", text: "查询" },
+            { id: "status", component: "Text", text: { path: "/status" }, variant: "caption" },
+            { id: "dividerTop", component: "Divider" },
+            { id: "tableCard", component: "Card", child: "tableInner" },
+            { id: "tableInner", component: "Column", children: ["summary", "trackTable"] },
+            { id: "summary", component: "Text", text: { path: "/summary" }, variant: "body" },
+            {
+              id: "trackTable",
+              component: "Table",
+              columns: [
+                { label: "时间", key: "trackTime", width: 150 },
+                { label: "轨迹", key: "trackInfo" },
+                { label: "站点", key: "stationId", width: 90 }
+              ],
+              // 必须 `{path}`：协同端发布校验只从这种形状里收集路径（详见 shadcn-catalog）
+              rows: { path: "/doTrackList" },
+              emptyText: "请先输入运单号并点「查询」"
+            },
+            { id: "dividerBottom", component: "Divider" },
+            { id: "formTitle", component: "Text", text: "回单登记", variant: "h4" },
+            {
+              id: "operatorField",
+              component: "TextField",
+              label: "操作人",
+              variant: "shortText",
+              value: { path: "/operator" }
+            },
+            {
+              id: "prioritySelect",
+              component: "ChoicePicker",
+              label: "优先级",
+              options: [
+                { label: "普通", value: "normal" },
+                { label: "加急", value: "urgent" },
+                { label: "特急", value: "critical" }
+              ],
+              value: { path: "/priority" },
+              variant: "mutuallyExclusive"
+            },
+            {
+              id: "carrierSelect",
+              component: "ChoicePicker",
+              label: "承运商（远程选项）",
+              // 扩展写法：工具只回纯数据，选项由渲染层按声明解析（见 remote-options.ts）
+              options: { source: "/carriers", label: "name", value: "id" },
+              value: { path: "/carrier" },
+              variant: "mutuallyExclusive"
+            },
+            {
+              id: "remarkField",
+              component: "TextField",
+              label: "备注",
+              variant: "longText",
+              value: { path: "/remark" }
+            },
+            { id: "submitRow", component: "Row", children: ["submitBtn"] },
+            {
+              id: "submitBtn",
+              component: "Button",
+              variant: "primary",
+              child: "submitBtnText",
+              action: {
+                event: {
+                  name: "submit_receipt",
+                  context: {
+                    waybillNo: { path: "/waybillNo" },
+                    operator: { path: "/operator" },
+                    priority: { path: "/priority" },
+                    carrier: { path: "/carrier" },
+                    remark: { path: "/remark" }
+                  }
+                }
+              }
+            },
+            { id: "submitBtnText", component: "Text", text: "提交回单" }
+          ]
+        }
+      }
+    ]
+  },
+  null,
+  2
+), d = {
+  "/waybillNo": "YD20260924001",
+  "/status": "输入运单号后点「查询」加载轨迹",
+  "/summary": "运单 YD20260924001 · 尚未查询",
+  // 查询前是空数组：Table 走空态文案，下拉走「暂无选项」
+  "/doTrackList": [],
+  "/carriers": [],
+  "/priority": [],
+  "/carrier": [],
+  "/operator": "",
+  "/remark": ""
+}, o = "goods-editable", a = [
+  { code: "kg", name: "千克" },
+  { code: "t", name: "吨" },
+  { code: "pcs", name: "件" },
+  { code: "box", name: "箱" }
+], p = JSON.stringify(
+  {
+    messages: [
+      {
+        version: "v0.9",
+        createSurface: {
+          surfaceId: o,
+          catalogId: "https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json"
+        }
+      },
+      {
+        version: "v0.9",
+        updateComponents: {
+          surfaceId: o,
+          components: [
+            {
+              id: "root",
+              component: "Column",
+              children: ["title", "hint", "goodsTable", "submitRow"]
+            },
+            { id: "title", component: "Text", text: "货物明细", variant: "h3" },
+            {
+              id: "hint",
+              component: "Text",
+              text: "点「添加一行」录入，行数不限",
+              variant: "caption"
+            },
+            {
+              id: "goodsTable",
+              component: "EditableTable",
+              columns: [
+                { label: "货物名称", key: "name" },
+                { label: "重量(kg)", key: "weight", type: "number", width: 90 },
+                {
+                  label: "单位",
+                  key: "unit",
+                  type: "select",
+                  width: 100,
+                  // 远程选项：数据由工具回包写进 /units（见 remote-options.ts）
+                  options: { source: "/units", label: "name", value: "code" }
+                },
+                {
+                  label: "状态",
+                  key: "status",
+                  type: "select",
+                  width: 100,
+                  options: [
+                    { label: "完好", value: "ok" },
+                    { label: "破损", value: "damaged" }
+                  ]
+                }
+              ],
+              // 必须 `{path}`，与 `Table` 同一条约束
+              rows: { path: "/goods" },
+              addLabel: "添加一行",
+              removeLabel: "删除这一行",
+              emptyHint: "还没有货物，点「添加一行」开始"
+            },
+            { id: "submitRow", component: "Row", children: ["submitBtn"] },
+            {
+              id: "submitBtn",
+              component: "Button",
+              variant: "primary",
+              child: "submitBtnText",
+              action: {
+                event: { name: "submit_goods", context: { goods: { path: "/goods" } } }
+              }
+            },
+            { id: "submitBtnText", component: "Text", text: "提交明细" }
+          ]
+        }
+      }
+    ]
+  },
+  null,
+  2
+), m = {
+  // 预置一行，打开就能看到两种下拉的实际样子；删掉它即回到「还没有货物」空态
+  "/goods": [{ name: "螺丝", weight: 12.5, unit: "kg", status: "ok" }],
+  "/units": a,
+  "/submitted": !1
+}, u = {
+  "/keyword": "",
+  "/selectedService": [],
+  "/selectedVersion": [],
+  // 两个下拉的数据源：工具回包会把它们填上（`options.source` 指的就是这两个路径）
+  "/services": [],
+  "/versions": [],
+  "/status": "输入关键字后点「搜索」"
+};
+export {
+  i as DISPLAY_SAMPLE_DATA,
+  n as DISPLAY_SAMPLE_JSON,
+  m as EDITABLE_SAMPLE_DATA,
+  p as EDITABLE_SAMPLE_JSON,
+  o as EDITABLE_SURFACE_ID,
+  a as EDITABLE_UNIT_OPTIONS,
+  s as FORM_SAMPLE_DATA,
+  c as FORM_SAMPLE_JSON,
+  u as MULTI_ACTION_SAMPLE_DATA,
+  r as MULTI_ACTION_SAMPLE_JSON,
+  t as MULTI_ACTION_SURFACE_ID,
+  d as TRACK_SAMPLE_DATA,
+  l as TRACK_SAMPLE_JSON,
+  e as TRACK_SURFACE_ID
+};

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @xiaohao/a2ui-renderer 公开 API。
+ *
+ * 定位：A2UI 卡片的 **Web 渲染层**——任何 React 18/19 页面要显示 A2UI 卡，
+ * 一律安装这个包，不再各自实现一份。宿主无关：这里不 import 任何桌面/协同端
+ * 的业务模块（网络、toast、日志全部由 props 注入）。
+ */
+export { A2uiRenderer } from './a2ui-renderer';
+export type { A2uiActionOutcome, A2uiActionRequest, A2uiCardInput, A2uiRendererProps, } from './types';
+export { A2UI_AUX_KEY, A2UI_VERSION, auxMessagesOf, buildDataModelMessages, parseA2uiCard, shouldFreeze, toDataEntries, } from './messages/a2ui-messages';
+export type { A2uiCardMessages, A2uiDataModelMessage } from './messages/a2ui-messages';
+export { DEFAULT_LABEL_KEY, DEFAULT_VALUE_KEY, isRemoteOptions, resolveRemoteOptions, } from './messages/remote-options';
+export type { ChoiceOption, RemoteOptionsDescriptor } from './messages/remote-options';
+export { collectMissingPaths } from './messages/missing-paths';
+export { deriveToolPrefix, resolveToolName } from './actions/tool-name';
+export { extractToolResultText } from './text';
+export { shadcnCatalog, shadcnCatalogId } from './catalog/shadcn-catalog';
+export { A2uiFallback } from './fallback';
+export { A2uiPortalProvider, useA2uiPortalContainer } from './lib/portal-context';
+/** 包版本（宿主可断言 `RENDERER_VERSION === 依赖里声明的版本`，防两仓漂移） */
+export declare const RENDERER_VERSION: string;