@zhama/a2ui-core 0.6.0 → 0.9.0

package/dist/surface/index.d.cts

@@ -1,5 +1,5 @@
-import { ServerToClientMessageV09, ComponentInstance, DataObject } from '../types/index.cjs';
-import '../primitives-DLbBDhLq.cjs';
+import { ServerToClientMessage, Theme, ComponentInstance, DataObject } from '../types/index.cjs';
+import '../primitives-DRaAeo-1.cjs';
 
 /**
  * Surface IDs and Configuration
@@ -91,16 +91,27 @@ declare function resetSurfaceIdCounter(): void;
  */
 interface SurfaceResult {
     /** 构建的消息数组 */
-    messages: ServerToClientMessageV09[];
+    messages: ServerToClientMessage[];
     /** Surface ID */
     surfaceId: string;
 }
+/**
+ * Surface 选项
+ */
+interface SurfaceOptions {
+    /** Surface ID（可选，自动生成） */
+    surfaceId?: string;
+    /** 主题配置 */
+    theme?: Theme;
+    /** 是否发送数据模型 */
+    sendDataModel?: boolean;
+}
 /**
  * 创建 A2UI Surface 消息
  *
  * @param rootId - 根组件 ID
  * @param components - 组件列表（v0.9 格式）
- * @param surfaceId - Surface ID（可选，自动生成）
+ * @param options - 可选配置
  * @returns Surface 构建结果
  *
  * @example
@@ -110,17 +121,19 @@ interface SurfaceResult {
  * const title = h1('Hello', { id: 'title' });
  * const root = column(['title'], { id: 'root' });
  *
- * const { messages, surfaceId } = createA2UISurface('root', [title, root], SURFACE_IDS.CHAT);
+ * const { messages, surfaceId } = createA2UISurface('root', [title, root], {
+ *   surfaceId: SURFACE_IDS.CHAT
+ * });
  * ```
  */
-declare function createA2UISurface(rootId: string, components: ComponentInstance[], surfaceId?: string): SurfaceResult;
+declare function createA2UISurface(rootId: string, components: ComponentInstance[], options?: SurfaceOptions): SurfaceResult;
 /**
  * 创建带数据模型的 A2UI Surface
  *
  * @param rootId - 根组件 ID
  * @param components - 组件列表（v0.9 格式）
  * @param dataModel - 数据模型对象
- * @param surfaceId - Surface ID（可选）
+ * @param options - 可选配置
  * @returns Surface 构建结果
  *
  * @example
@@ -129,37 +142,37 @@ declare function createA2UISurface(rootId: string, components: ComponentInstance
  *   'root',
  *   [title, greeting, root],
  *   { user: { name: 'John' } },
- *   SURFACE_IDS.CHAT
+ *   { surfaceId: SURFACE_IDS.CHAT }
  * );
  * ```
  */
-declare function createA2UISurfaceWithData(rootId: string, components: ComponentInstance[], dataModel: DataObject, surfaceId?: string): SurfaceResult;
+declare function createA2UISurfaceWithData(rootId: string, components: ComponentInstance[], dataModel: DataObject, options?: SurfaceOptions): SurfaceResult;
 /**
  * 创建删除 Surface 的消息
  *
  * @param surfaceId - 要删除的 Surface ID
  * @returns 删除消息
  */
-declare function createDeleteSurfaceMessage(surfaceId: string): ServerToClientMessageV09;
+declare function createDeleteSurfaceMessage(surfaceId: string): ServerToClientMessage;
 /**
  * 创建聊天区 Surface
  */
-declare function createChatSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+declare function createChatSurface(rootId: string, components: ComponentInstance[], options?: Omit<SurfaceOptions, 'surfaceId'>): SurfaceResult;
 /**
  * 创建智能体推荐区 Surface
  */
-declare function createRecommendationSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+declare function createRecommendationSurface(rootId: string, components: ComponentInstance[], options?: Omit<SurfaceOptions, 'surfaceId'>): SurfaceResult;
 /**
  * 创建输入表单区 Surface
  */
-declare function createInputFormSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+declare function createInputFormSurface(rootId: string, components: ComponentInstance[], options?: Omit<SurfaceOptions, 'surfaceId'>): SurfaceResult;
 /**
  * 创建编排面板 Surface
  */
-declare function createOrchestrationSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+declare function createOrchestrationSurface(rootId: string, components: ComponentInstance[], options?: Omit<SurfaceOptions, 'surfaceId'>): SurfaceResult;
 /**
  * 创建状态提示 Surface
  */
-declare function createStatusSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+declare function createStatusSurface(rootId: string, components: ComponentInstance[], options?: Omit<SurfaceOptions, 'surfaceId'>): SurfaceResult;
 
-export { SURFACE_IDS, type SurfaceConfig, type SurfaceIdType, type SurfaceResult, createA2UISurface, createA2UISurfaceWithData, createChatSurface, createDeleteSurfaceMessage, createInputFormSurface, createOrchestrationSurface, createRecommendationSurface, createStatusSurface, generateSurfaceId, resetSurfaceIdCounter };
+export { SURFACE_IDS, type SurfaceConfig, type SurfaceIdType, type SurfaceOptions, type SurfaceResult, createA2UISurface, createA2UISurfaceWithData, createChatSurface, createDeleteSurfaceMessage, createInputFormSurface, createOrchestrationSurface, createRecommendationSurface, createStatusSurface, generateSurfaceId, resetSurfaceIdCounter };

package/dist/surface/index.d.ts

@@ -1,5 +1,5 @@
-import { ServerToClientMessageV09, ComponentInstance, DataObject } from '../types/index.js';
-import '../primitives-DLbBDhLq.js';
+import { ServerToClientMessage, Theme, ComponentInstance, DataObject } from '../types/index.js';
+import '../primitives-DRaAeo-1.js';
 
 /**
  * Surface IDs and Configuration
@@ -91,16 +91,27 @@ declare function resetSurfaceIdCounter(): void;
  */
 interface SurfaceResult {
     /** 构建的消息数组 */
-    messages: ServerToClientMessageV09[];
+    messages: ServerToClientMessage[];
     /** Surface ID */
     surfaceId: string;
 }
+/**
+ * Surface 选项
+ */
+interface SurfaceOptions {
+    /** Surface ID（可选，自动生成） */
+    surfaceId?: string;
+    /** 主题配置 */
+    theme?: Theme;
+    /** 是否发送数据模型 */
+    sendDataModel?: boolean;
+}
 /**
  * 创建 A2UI Surface 消息
  *
  * @param rootId - 根组件 ID
  * @param components - 组件列表（v0.9 格式）
- * @param surfaceId - Surface ID（可选，自动生成）
+ * @param options - 可选配置
  * @returns Surface 构建结果
  *
  * @example
@@ -110,17 +121,19 @@ interface SurfaceResult {
  * const title = h1('Hello', { id: 'title' });
  * const root = column(['title'], { id: 'root' });
  *
- * const { messages, surfaceId } = createA2UISurface('root', [title, root], SURFACE_IDS.CHAT);
+ * const { messages, surfaceId } = createA2UISurface('root', [title, root], {
+ *   surfaceId: SURFACE_IDS.CHAT
+ * });
  * ```
  */
-declare function createA2UISurface(rootId: string, components: ComponentInstance[], surfaceId?: string): SurfaceResult;
+declare function createA2UISurface(rootId: string, components: ComponentInstance[], options?: SurfaceOptions): SurfaceResult;
 /**
  * 创建带数据模型的 A2UI Surface
  *
  * @param rootId - 根组件 ID
  * @param components - 组件列表（v0.9 格式）
  * @param dataModel - 数据模型对象
- * @param surfaceId - Surface ID（可选）
+ * @param options - 可选配置
  * @returns Surface 构建结果
  *
  * @example
@@ -129,37 +142,37 @@ declare function createA2UISurface(rootId: string, components: ComponentInstance
  *   'root',
  *   [title, greeting, root],
  *   { user: { name: 'John' } },
- *   SURFACE_IDS.CHAT
+ *   { surfaceId: SURFACE_IDS.CHAT }
  * );
  * ```
  */
-declare function createA2UISurfaceWithData(rootId: string, components: ComponentInstance[], dataModel: DataObject, surfaceId?: string): SurfaceResult;
+declare function createA2UISurfaceWithData(rootId: string, components: ComponentInstance[], dataModel: DataObject, options?: SurfaceOptions): SurfaceResult;
 /**
  * 创建删除 Surface 的消息
  *
  * @param surfaceId - 要删除的 Surface ID
  * @returns 删除消息
  */
-declare function createDeleteSurfaceMessage(surfaceId: string): ServerToClientMessageV09;
+declare function createDeleteSurfaceMessage(surfaceId: string): ServerToClientMessage;
 /**
  * 创建聊天区 Surface
  */
-declare function createChatSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+declare function createChatSurface(rootId: string, components: ComponentInstance[], options?: Omit<SurfaceOptions, 'surfaceId'>): SurfaceResult;
 /**
  * 创建智能体推荐区 Surface
  */
-declare function createRecommendationSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+declare function createRecommendationSurface(rootId: string, components: ComponentInstance[], options?: Omit<SurfaceOptions, 'surfaceId'>): SurfaceResult;
 /**
  * 创建输入表单区 Surface
  */
-declare function createInputFormSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+declare function createInputFormSurface(rootId: string, components: ComponentInstance[], options?: Omit<SurfaceOptions, 'surfaceId'>): SurfaceResult;
 /**
  * 创建编排面板 Surface
  */
-declare function createOrchestrationSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+declare function createOrchestrationSurface(rootId: string, components: ComponentInstance[], options?: Omit<SurfaceOptions, 'surfaceId'>): SurfaceResult;
 /**
  * 创建状态提示 Surface
  */
-declare function createStatusSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+declare function createStatusSurface(rootId: string, components: ComponentInstance[], options?: Omit<SurfaceOptions, 'surfaceId'>): SurfaceResult;
 
-export { SURFACE_IDS, type SurfaceConfig, type SurfaceIdType, type SurfaceResult, createA2UISurface, createA2UISurfaceWithData, createChatSurface, createDeleteSurfaceMessage, createInputFormSurface, createOrchestrationSurface, createRecommendationSurface, createStatusSurface, generateSurfaceId, resetSurfaceIdCounter };
+export { SURFACE_IDS, type SurfaceConfig, type SurfaceIdType, type SurfaceOptions, type SurfaceResult, createA2UISurface, createA2UISurfaceWithData, createChatSurface, createDeleteSurfaceMessage, createInputFormSurface, createOrchestrationSurface, createRecommendationSurface, createStatusSurface, generateSurfaceId, resetSurfaceIdCounter };

package/dist/surface/index.js

@@ -1,2 +1,2 @@
-var n={CHAT:"@chat",RECOMMENDATION:"@recommendation",INPUT_FORM:"@input-form",ORCHESTRATION:"@orchestration",STATUS:"@status",RESULT:"@result",CONFIRM:"@confirm",NOTIFICATION:"@notification"},c=0;function i(e="surface"){return c++,`${e}-${Date.now()}-${c}`}function C(){c=0;}var p="https://a2ui.dev/specification/0.9/standard_catalog_definition.json";function u(e,t=p){return {createSurface:{surfaceId:e,catalogId:t}}}function g(e,t){return {updateComponents:{surfaceId:e,components:t}}}function f(e,t,a,r="replace"){return {updateDataModel:{surfaceId:e,...a,op:r,...r!=="remove"&&{value:t}}}}function d(e){return {deleteSurface:{surfaceId:e}}}function o(e,t,a){let r=a??i();return t.find(l=>l.id===e)||console.warn(`[A2UI] Root component "${e}" not found in components list`),{messages:[u(r),g(r,t)],surfaceId:r}}function S(e,t,a,r){let s=r??i();return {messages:[u(s),g(s,t),f(s,a)],surfaceId:s}}function M(e){return d(e)}function I(e,t){return o(e,t,n.CHAT)}function T(e,t){return o(e,t,n.RECOMMENDATION)}function x(e,t){return o(e,t,n.INPUT_FORM)}function D(e,t){return o(e,t,n.ORCHESTRATION)}function A(e,t){return o(e,t,n.STATUS)}
-export{n as SURFACE_IDS,o as createA2UISurface,S as createA2UISurfaceWithData,I as createChatSurface,M as createDeleteSurfaceMessage,x as createInputFormSurface,D as createOrchestrationSurface,T as createRecommendationSurface,A as createStatusSurface,i as generateSurfaceId,C as resetSurfaceIdCounter};
+var r={CHAT:"@chat",RECOMMENDATION:"@recommendation",INPUT_FORM:"@input-form",ORCHESTRATION:"@orchestration",STATUS:"@status",RESULT:"@result",CONFIRM:"@confirm",NOTIFICATION:"@notification"},f=0;function u(e="surface"){return f++,`${e}-${Date.now()}-${f}`}function I(){f=0;}var g="https://a2ui.dev/specification/v0_9/standard_catalog.json";function m(e,t={}){let{catalogId:n=g,theme:a,sendDataModel:o}=t;return {createSurface:{surfaceId:e,catalogId:n,...a&&{theme:a},...o!==void 0&&{sendDataModel:o}}}}function d(e,t){return {updateComponents:{surfaceId:e,components:t}}}function l(e,t,n){return {updateDataModel:{surfaceId:e,...n,...t!==void 0&&{value:t}}}}function C(e){return {deleteSurface:{surfaceId:e}}}function s(e,t,n={}){let{surfaceId:a,theme:o,sendDataModel:p}=n,i=a??u();return t.find(M=>M.id===e)||console.warn(`[A2UI] Root component "${e}" not found in components list`),{messages:[m(i,{theme:o,sendDataModel:p}),d(i,t)],surfaceId:i}}function D(e,t,n,a={}){let{surfaceId:o,theme:p,sendDataModel:i}=a,c=o??u();return {messages:[m(c,{theme:p,sendDataModel:i}),d(c,t),l(c,n)],surfaceId:c}}function T(e){return C(e)}function x(e,t,n={}){return s(e,t,{...n,surfaceId:r.CHAT})}function A(e,t,n={}){return s(e,t,{...n,surfaceId:r.RECOMMENDATION})}function y(e,t,n={}){return s(e,t,{...n,surfaceId:r.INPUT_FORM})}function O(e,t,n={}){return s(e,t,{...n,surfaceId:r.ORCHESTRATION})}function R(e,t,n={}){return s(e,t,{...n,surfaceId:r.STATUS})}
+export{r as SURFACE_IDS,s as createA2UISurface,D as createA2UISurfaceWithData,x as createChatSurface,T as createDeleteSurfaceMessage,y as createInputFormSurface,O as createOrchestrationSurface,A as createRecommendationSurface,R as createStatusSurface,u as generateSurfaceId,I as resetSurfaceIdCounter};

package/dist/types/index.cjs

@@ -1,2 +1,2 @@
-'use strict';function t(e){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e}var n="https://a2ui.dev/specification/0.9/standard_catalog_definition.json";var r="https://a2ui.dev/specification/0.9",a="application/json+a2ui";
-exports.A2UI_EXTENSION_URI=r;exports.A2UI_MIME_TYPE=a;exports.STANDARD_CATALOG_ID=n;exports.isV09Message=t;
+'use strict';var t="https://a2ui.dev/specification/v0_9/standard_catalog.json";function n(e){return "createSurface"in e}function a(e){return "updateComponents"in e}function o(e){return "updateDataModel"in e}function r(e){return "deleteSurface"in e}function s(e){return "action"in e}function i(e){return "error"in e}
+exports.STANDARD_CATALOG_ID=t;exports.isActionMessage=s;exports.isCreateSurfaceMessage=n;exports.isDeleteSurfaceMessage=r;exports.isErrorMessage=i;exports.isUpdateComponentsMessage=a;exports.isUpdateDataModelMessage=o;