@zhama/a2ui-core 0.3.0 → 0.4.0

package/README.md

@@ -2,14 +2,18 @@
 
 A2UI Protocol Core Library - Framework-agnostic TypeScript types and builders for A2UI protocol.
 
+> **Note**: A2UI v0.8 is the current stable version. v0.9 is still in draft status.
+> See [a2ui.org](https://a2ui.org/) for the official specification.
+
 ## Overview
 
 A2UI (Agent to UI) is a JSON-based streaming UI protocol for dynamically rendering user interfaces. This library provides:
 
 - **Types**: Complete TypeScript type definitions for A2UI v0.8 and v0.9
-- **Builders**: Convenient functions to build messages and components
+- **Builders**: Convenient functions to build messages and components (both v0.8 and v0.9 formats)
 - **Validators**: Message validation utilities
 - **Utils**: Utility functions for path bindings and data manipulation
+- **Surface**: Surface ID constants and creation utilities
 
 ## Installation
 
@@ -64,14 +68,20 @@ You can import specific modules for tree-shaking:
 // Types only
 import type { ComponentInstance, ServerToClientMessage } from '@zhama/a2ui-core/types';
 
-// Builders only
+// Builders only (v0.9 format)
 import { text, column, createV09Messages } from '@zhama/a2ui-core/builders';
 
+// Builders only (v0.8 format - compatible with tego-server)
+import { createText, createColumn, createButton } from '@zhama/a2ui-core/builders';
+
 // Validators only
 import { validateMessage, validateMessages } from '@zhama/a2ui-core/validators';
 
 // Utils only
 import { path, uuid, deepMerge } from '@zhama/a2ui-core/utils';
+
+// Surface utilities
+import { SURFACE_IDS, createA2UISurface, createChatSurface } from '@zhama/a2ui-core/surface';
 ```
 
 ## API Reference
@@ -200,6 +210,65 @@ A2UI_EXTENSION_URI_V08  // A2UI v0.8 extension URI
 A2UI_MIME_TYPE       // A2UI MIME type (application/json+a2ui)
 ```
 
+### Surface Module
+
+```typescript
+// Surface ID constants
+SURFACE_IDS.CHAT           // '@chat' - Chat content area
+SURFACE_IDS.RECOMMENDATION // '@recommendation' - Agent recommendations
+SURFACE_IDS.INPUT_FORM     // '@input-form' - Input collection forms
+SURFACE_IDS.ORCHESTRATION  // '@orchestration' - Multi-agent orchestration
+SURFACE_IDS.STATUS         // '@status' - Status messages
+SURFACE_IDS.RESULT         // '@result' - Agent results
+SURFACE_IDS.CONFIRM        // '@confirm' - Confirmation dialogs
+SURFACE_IDS.NOTIFICATION   // '@notification' - Notifications
+
+// Surface creation functions
+createA2UISurface(rootId: string, components: ComponentInput[], surfaceId?: string): SurfaceResult
+createA2UISurfaceWithData(rootId: string, components: ComponentInput[], dataModel: DataObject, surfaceId?: string): SurfaceResult
+createDeleteSurface(surfaceId: string): A2UISurface
+
+// Convenience functions
+createChatSurface(rootId: string, components: ComponentInput[]): SurfaceResult
+createRecommendationSurface(rootId: string, components: ComponentInput[]): SurfaceResult
+createInputFormSurface(rootId: string, components: ComponentInput[]): SurfaceResult
+createOrchestrationSurface(rootId: string, components: ComponentInput[]): SurfaceResult
+createStatusSurface(rootId: string, components: ComponentInput[]): SurfaceResult
+```
+
+### v0.8 Component Builders (Stable)
+
+These functions generate v0.8 format components compatible with tego-server:
+
+```typescript
+// Text components
+createText(text: string, options?: TextOptionsV08): ComponentDefinition
+createBoundText(path: string, options?: TextOptionsV08): ComponentDefinition
+createH1(text: string, options?: { id?: string }): ComponentDefinition
+createH2(text: string, options?: { id?: string }): ComponentDefinition
+createH3(text: string, options?: { id?: string }): ComponentDefinition
+
+// Layout components
+createColumn(childIds: string[], options?: LayoutOptionsV08): ComponentDefinition
+createRow(childIds: string[], options?: LayoutOptionsV08): ComponentDefinition
+createCard(childIds: string[], options?: { id?: string; padding?: number }): ComponentDefinition
+createList(childIds: string[], options?: { id?: string; direction?: string }): ComponentDefinition
+createDivider(options?: { id?: string; axis?: string }): ComponentDefinition
+
+// Interactive components
+createButton(text: string, action: ActionDefinition, options?: ButtonOptionsV08): ButtonResult
+createSimpleButton(text: string, action: ActionDefinition, options?: { id?: string }): ButtonResult
+
+// Form components
+createTextField(options: { label?: string; placeholder?: string; ... }): ComponentDefinition
+createCheckbox(options: { label?: string; valuePath?: string; ... }): ComponentDefinition
+createMultipleChoice(options: { options: Array<{value, label}>; ... }): ComponentDefinition
+
+// Media components
+createImage(url: string, options?: { alt?: string; width?: number; height?: number }): ComponentDefinition
+createIcon(name: string, options?: IconOptionsV08): ComponentDefinition
+```
+
 ## Protocol Versions
 
 ### v0.9 (Prompt-first)

package/dist/builders/index.cjs

@@ -1,3 +1,3 @@
-'use strict';var g=0;function i(t="comp"){return `${t}_${Date.now()}_${g++}`}function V(){g=0;}function D(){return g}function p(t,e={}){let{id:n=i("text"),weight:o,usageHint:a}=e;return {id:n,component:"Text",text:t,...o!==void 0&&{weight:o},...a&&{usageHint:a}}}function v(t,e={}){let{id:n=i("image"),weight:o,fit:a,usageHint:r}=e;return {id:n,component:"Image",url:t,...o!==void 0&&{weight:o},...a&&{fit:a},...r&&{usageHint:r}}}function P(t,e={}){let{id:n=i("icon"),weight:o}=e;return {id:n,component:"Icon",name:t,...o!==void 0&&{weight:o}}}function A(t,e={}){let{id:n=i("video"),weight:o}=e;return {id:n,component:"Video",url:t,...o!==void 0&&{weight:o}}}function U(t,e={}){let{id:n=i("audio"),weight:o,description:a}=e;return {id:n,component:"AudioPlayer",url:t,...o!==void 0&&{weight:o},...a&&{description:a}}}function w(t,e={}){let{id:n=i("row"),weight:o,alignment:a,distribution:r}=e;return {id:n,component:"Row",children:t,...o!==void 0&&{weight:o},...a&&{alignment:a},...r&&{distribution:r}}}function j(t,e={}){let{id:n=i("column"),weight:o,alignment:a,distribution:r}=e;return {id:n,component:"Column",children:t,...o!==void 0&&{weight:o},...a&&{alignment:a},...r&&{distribution:r}}}function R(t,e={}){let{id:n=i("list"),weight:o,direction:a,alignment:r}=e;return {id:n,component:"List",children:t,...o!==void 0&&{weight:o},...a&&{direction:a},...r&&{alignment:r}}}function _(t,e={}){let{id:n=i("card"),weight:o}=e;return {id:n,component:"Card",child:t,...o!==void 0&&{weight:o}}}function k(t,e={}){let{id:n=i("tabs"),weight:o}=e;return {id:n,component:"Tabs",tabItems:t.map(a=>({title:a.title,child:a.childId})),...o!==void 0&&{weight:o}}}function B(t={}){let{id:e=i("divider"),weight:n,axis:o}=t;return {id:e,component:"Divider",...n!==void 0&&{weight:n},...o&&{axis:o}}}function H(t,e,n={}){let{id:o=i("modal"),weight:a}=n;return {id:o,component:"Modal",entryPointChild:t,contentChild:e,...a!==void 0&&{weight:a}}}function f(t,e,n={}){let{id:o=i("button"),weight:a,primary:r}=n;return {id:o,component:"Button",child:t,action:e,...a!==void 0&&{weight:a},...r!==void 0&&{primary:r}}}function N(t,e,n={}){let{id:o=i("checkbox"),weight:a}=n;return {id:o,component:"CheckBox",label:t,value:e,...a!==void 0&&{weight:a}}}function E(t,e,n={}){let{id:o=i("textfield"),weight:a,usageHint:r,validationRegexp:s}=n;return {id:o,component:"TextField",label:t,...e!==void 0&&{text:e},...a!==void 0&&{weight:a},...r&&{usageHint:r},...s&&{validationRegexp:s}}}function L(t,e={}){let{id:n=i("datetime"),weight:o,enableDate:a,enableTime:r,outputFormat:s,label:c}=e;return {id:n,component:"DateTimeInput",value:t,...o!==void 0&&{weight:o},...a!==void 0&&{enableDate:a},...r!==void 0&&{enableTime:r},...s&&{outputFormat:s},...c&&{label:c}}}function $(t,e,n,o={}){let{id:a=i("choice"),weight:r,label:s}=o;return {id:a,component:"ChoicePicker",options:t,value:e,usageHint:n,...r!==void 0&&{weight:r},...s&&{label:s}}}function F(t,e={}){let{id:n=i("slider"),weight:o,label:a,min:r,max:s}=e;return {id:n,component:"Slider",value:t,...o!==void 0&&{weight:o},...a&&{label:a},...r!==void 0&&{min:r},...s!==void 0&&{max:s}}}function G(t,e,n={}){let o=n.textId??i("btn_text"),a=p(t,{id:o}),r=f(o,e,n);return [a,r]}function z(t,e={}){return p(t,{...e,usageHint:"h1"})}function J(t,e={}){return p(t,{...e,usageHint:"h2"})}function X(t,e={}){return p(t,{...e,usageHint:"h3"})}function W(t,e={}){return p(t,{...e,usageHint:"h4"})}function Y(t,e={}){return p(t,{...e,usageHint:"h5"})}function K(t,e={}){return p(t,{...e,usageHint:"caption"})}function q(t,e={}){return p(t,{...e,usageHint:"body"})}var d="https://a2ui.dev/specification/0.9/standard_catalog_definition.json";var C={};function l(t,e=""){let n=[];for(let[o,a]of Object.entries(t)){let r=e?`${e}/${o}`:`/${o}`;n.push(u(r,a));}return n}function u(t,e){if(e==null)return {key:t,valueString:""};if(typeof e=="string")return {key:t,valueString:e};if(typeof e=="number")return {key:t,valueNumber:e};if(typeof e=="boolean")return {key:t,valueBoolean:e};if(Array.isArray(e))return {key:t,valueMap:e.map((n,o)=>u(String(o),n))};if(typeof e=="object"){let n=[];for(let[o,a]of Object.entries(e))n.push(u(o,a));return {key:t,valueMap:n}}return {key:t,valueString:String(e)}}function x(t,e={}){let n=t.replace(/\./g,"/");n.startsWith("/")||(n=`/${n}`);for(let[o,a]of Object.entries(e)){let r=new RegExp(`^/${o}(/|$)`);r.test(n)&&(n=n.replace(r,`/${a}$1`));}return n}function Q(t,e="",n=C){let o=[];for(let a of t){let r=a.path.startsWith("/")?a.path:`${e}/${a.path}`,s=x(r,n);if(a.value!==null&&typeof a.value=="object"&&!Array.isArray(a.value)){let c=m(a.value,s);o.push(...c);}else o.push(u(s,a.value));}return o}function m(t,e){let n=[];for(let[o,a]of Object.entries(t)){let r=`${e}/${o}`;if(a!==null&&typeof a=="object"&&!Array.isArray(a)){let s=m(a,r);n.push(...s);}else n.push(u(r,a));}return n}function M(t){let e={};for(let n of t){let o=n.key.startsWith("/")?n.key.slice(1):n.key;n.valueString!==void 0?e[o]=n.valueString:n.valueNumber!==void 0?e[o]=n.valueNumber:n.valueBoolean!==void 0?e[o]=n.valueBoolean:n.valueMap!==void 0&&(e[o]=M(n.valueMap));}return e}function O(t,e=d){return {createSurface:{surfaceId:t,catalogId:e}}}function h(t,e){return {updateComponents:{surfaceId:t,components:e}}}function I(t,e,n,o="replace"){return {updateDataModel:{surfaceId:t,...n&&{path:n},op:o,...o!=="remove"&&{value:e}}}}function Z(t){return {deleteSurface:{surfaceId:t}}}function ee(t){let{surfaceId:e,catalogId:n=d,components:o,dataModel:a}=t,r=[O(e,n),h(e,o)];return a&&r.push(I(e,a)),r}function S(t,e="@default",n){return {beginRendering:{surfaceId:e,root:t,...n&&{styles:n}}}}function T(t,e="@default"){return {surfaceUpdate:{surfaceId:e,components:t}}}function y(t,e="@default",n){return {dataModelUpdate:{surfaceId:e,contents:t,...n&&{path:n}}}}function b(t,e="@default"){return y(l(t),e)}function te(t,e,n="@default"){return {dataModelUpdate:{surfaceId:n,path:t,contents:[u("",e)]}}}function ne(t){return {deleteSurface:{surfaceId:t}}}function oe(t){let{rootId:e,components:n,dataModel:o,surfaceId:a="@default",styles:r}=t,s=[T(n,a)];return o&&s.push(b(o,a)),s.push(S(e,a,r)),s}function ae(t){return t.map(e=>JSON.stringify(e)).join(`
-`)}function re(t){return t.split(`
-`).filter(e=>e.trim()).map(e=>JSON.parse(e))}exports.DEFAULT_PATH_MAPPINGS=C;exports.audioPlayer=U;exports.beginRendering=S;exports.body=q;exports.button=f;exports.caption=K;exports.card=_;exports.checkbox=N;exports.choicePicker=$;exports.column=j;exports.createSurface=O;exports.createV08Messages=oe;exports.createV09Messages=ee;exports.dataModelInit=b;exports.dataModelUpdate=y;exports.dateTimeInput=L;exports.deleteSurface=Z;exports.deleteSurfaceV08=ne;exports.divider=B;exports.flattenObjectToValueMap=m;exports.generateId=i;exports.getIdCounter=D;exports.h1=z;exports.h2=J;exports.h3=X;exports.h4=W;exports.h5=Y;exports.icon=P;exports.image=v;exports.jsonlToMessages=re;exports.list=R;exports.messagesToJsonl=ae;exports.modal=H;exports.normalizePath=x;exports.objectToValueMap=l;exports.pathUpdate=te;exports.resetIdCounter=V;exports.row=w;exports.slider=F;exports.surfaceUpdate=T;exports.tabs=k;exports.text=p;exports.textButton=G;exports.textField=E;exports.updateComponents=h;exports.updateDataModel=I;exports.updatesToValueMap=Q;exports.valueMapToObject=M;exports.valueToValueMap=u;exports.video=A;
+'use strict';var m=0;function i(t="comp"){return `${t}_${Date.now()}_${m++}`}function I(){m=0;}function S(){return m}function p(t,e={}){let{id:n=i("text"),weight:o,usageHint:a}=e;return {id:n,component:"Text",text:t,...o!==void 0&&{weight:o},...a&&{usageHint:a}}}function y(t,e={}){let{id:n=i("image"),weight:o,fit:a,usageHint:r}=e;return {id:n,component:"Image",url:t,...o!==void 0&&{weight:o},...a&&{fit:a},...r&&{usageHint:r}}}function T(t,e={}){let{id:n=i("icon"),weight:o}=e;return {id:n,component:"Icon",name:t,...o!==void 0&&{weight:o}}}function b(t,e={}){let{id:n=i("video"),weight:o}=e;return {id:n,component:"Video",url:t,...o!==void 0&&{weight:o}}}function D(t,e={}){let{id:n=i("audio"),weight:o,description:a}=e;return {id:n,component:"AudioPlayer",url:t,...o!==void 0&&{weight:o},...a&&{description:a}}}function v(t,e={}){let{id:n=i("row"),weight:o,alignment:a,distribution:r}=e;return {id:n,component:"Row",children:t,...o!==void 0&&{weight:o},...a&&{alignment:a},...r&&{distribution:r}}}function P(t,e={}){let{id:n=i("column"),weight:o,alignment:a,distribution:r}=e;return {id:n,component:"Column",children:t,...o!==void 0&&{weight:o},...a&&{alignment:a},...r&&{distribution:r}}}function V(t,e={}){let{id:n=i("list"),weight:o,direction:a,alignment:r}=e;return {id:n,component:"List",children:t,...o!==void 0&&{weight:o},...a&&{direction:a},...r&&{alignment:r}}}function A(t,e={}){let{id:n=i("card"),weight:o}=e;return {id:n,component:"Card",child:t,...o!==void 0&&{weight:o}}}function U(t,e={}){let{id:n=i("tabs"),weight:o}=e;return {id:n,component:"Tabs",tabItems:t.map(a=>({title:a.title,child:a.childId})),...o!==void 0&&{weight:o}}}function w(t={}){let{id:e=i("divider"),weight:n,axis:o}=t;return {id:e,component:"Divider",...n!==void 0&&{weight:n},...o&&{axis:o}}}function j(t,e,n={}){let{id:o=i("modal"),weight:a}=n;return {id:o,component:"Modal",entryPointChild:t,contentChild:e,...a!==void 0&&{weight:a}}}function l(t,e,n={}){let{id:o=i("button"),weight:a,primary:r}=n;return {id:o,component:"Button",child:t,action:e,...a!==void 0&&{weight:a},...r!==void 0&&{primary:r}}}function _(t,e,n={}){let{id:o=i("checkbox"),weight:a}=n;return {id:o,component:"CheckBox",label:t,value:e,...a!==void 0&&{weight:a}}}function k(t,e,n={}){let{id:o=i("textfield"),weight:a,usageHint:r,validationRegexp:s}=n;return {id:o,component:"TextField",label:t,...e!==void 0&&{text:e},...a!==void 0&&{weight:a},...r&&{usageHint:r},...s&&{validationRegexp:s}}}function H(t,e={}){let{id:n=i("datetime"),weight:o,enableDate:a,enableTime:r,outputFormat:s,label:u}=e;return {id:n,component:"DateTimeInput",value:t,...o!==void 0&&{weight:o},...a!==void 0&&{enableDate:a},...r!==void 0&&{enableTime:r},...s&&{outputFormat:s},...u&&{label:u}}}function N(t,e,n,o={}){let{id:a=i("choice"),weight:r,label:s}=o;return {id:a,component:"ChoicePicker",options:t,value:e,usageHint:n,...r!==void 0&&{weight:r},...s&&{label:s}}}function B(t,e={}){let{id:n=i("slider"),weight:o,label:a,min:r,max:s}=e;return {id:n,component:"Slider",value:t,...o!==void 0&&{weight:o},...a&&{label:a},...r!==void 0&&{min:r},...s!==void 0&&{max:s}}}function E(t,e,n={}){let o=n.textId??i("btn_text"),a=p(t,{id:o}),r=l(o,e,n);return [a,r]}function R(t,e={}){return p(t,{...e,usageHint:"h1"})}function L(t,e={}){return p(t,{...e,usageHint:"h2"})}function $(t,e={}){return p(t,{...e,usageHint:"h3"})}function F(t,e={}){return p(t,{...e,usageHint:"h4"})}function G(t,e={}){return p(t,{...e,usageHint:"h5"})}function z(t,e={}){return p(t,{...e,usageHint:"caption"})}function J(t,e={}){return p(t,{...e,usageHint:"body"})}var d="https://a2ui.dev/specification/0.9/standard_catalog_definition.json";function f(t,e=d){return {createSurface:{surfaceId:t,catalogId:e}}}function C(t,e){return {updateComponents:{surfaceId:t,components:e}}}function x(t,e,n,o="replace"){return {updateDataModel:{surfaceId:t,...n&&{path:n},op:o,...o!=="remove"&&{value:e}}}}function X(t){return {deleteSurface:{surfaceId:t}}}function W(t){let{surfaceId:e,catalogId:n=d,components:o,dataModel:a}=t,r=[f(e,n),C(e,o)];return a&&r.push(x(e,a)),r}function Y(t){return t.map(e=>JSON.stringify(e)).join(`
+`)}function K(t){return t.split(`
+`).filter(e=>e.trim()).map(e=>JSON.parse(e))}var O={};function q(t,e=""){let n=[];for(let[o,a]of Object.entries(t)){let r=e?`${e}/${o}`:`/${o}`;n.push(c(r,a));}return n}function c(t,e){if(e==null)return {key:t,valueString:""};if(typeof e=="string")return {key:t,valueString:e};if(typeof e=="number")return {key:t,valueNumber:e};if(typeof e=="boolean")return {key:t,valueBoolean:e};if(Array.isArray(e))return {key:t,valueMap:e.map((n,o)=>c(String(o),n))};if(typeof e=="object"){let n=[];for(let[o,a]of Object.entries(e))n.push(c(o,a));return {key:t,valueMap:n}}return {key:t,valueString:String(e)}}function h(t,e={}){let n=t.replace(/\./g,"/");n.startsWith("/")||(n=`/${n}`);for(let[o,a]of Object.entries(e)){let r=new RegExp(`^/${o}(/|$)`);r.test(n)&&(n=n.replace(r,`/${a}$1`));}return n}function Q(t,e="",n=O){let o=[];for(let a of t){let r=a.path.startsWith("/")?a.path:`${e}/${a.path}`,s=h(r,n);if(a.value!==null&&typeof a.value=="object"&&!Array.isArray(a.value)){let u=g(a.value,s);o.push(...u);}else o.push(c(s,a.value));}return o}function g(t,e){let n=[];for(let[o,a]of Object.entries(t)){let r=`${e}/${o}`;if(a!==null&&typeof a=="object"&&!Array.isArray(a)){let s=g(a,r);n.push(...s);}else n.push(c(r,a));}return n}function M(t){let e={};for(let n of t){let o=n.key.startsWith("/")?n.key.slice(1):n.key;n.valueString!==void 0?e[o]=n.valueString:n.valueNumber!==void 0?e[o]=n.valueNumber:n.valueBoolean!==void 0?e[o]=n.valueBoolean:n.valueMap!==void 0&&(e[o]=M(n.valueMap));}return e}exports.DEFAULT_PATH_MAPPINGS=O;exports.audioPlayer=D;exports.body=J;exports.button=l;exports.caption=z;exports.card=A;exports.checkbox=_;exports.choicePicker=N;exports.column=P;exports.createSurface=f;exports.createV09Messages=W;exports.dateTimeInput=H;exports.deleteSurface=X;exports.divider=w;exports.flattenObjectToValueMap=g;exports.generateId=i;exports.getIdCounter=S;exports.h1=R;exports.h2=L;exports.h3=$;exports.h4=F;exports.h5=G;exports.icon=T;exports.image=y;exports.jsonlToMessages=K;exports.list=V;exports.messagesToJsonl=Y;exports.modal=j;exports.normalizePath=h;exports.objectToValueMap=q;exports.resetIdCounter=I;exports.row=v;exports.slider=B;exports.tabs=U;exports.text=p;exports.textButton=E;exports.textField=k;exports.updateComponents=C;exports.updateDataModel=x;exports.updatesToValueMap=Q;exports.valueMapToObject=M;exports.valueToValueMap=c;exports.video=b;

package/dist/builders/index.d.cts

@@ -1,5 +1,5 @@
 import { S as StringOrPath, B as BooleanOrPath, a as StringArrayOrPath, N as NumberOrPath } from '../primitives-nmkVz-tB.cjs';
-import { TextComponent, ImageComponent, RowComponent, ListComponent, DividerComponent, TextFieldComponent, ComponentInstance, ChildrenProperty, Action, ChoicePickerComponent, CreateSurfaceMessage, UpdateComponentsMessage, UpdateDataModelMessage, DeleteSurfaceMessage, DataObject, ServerToClientMessageV09, BeginRenderingMessage, ComponentInstanceV08, SurfaceUpdateMessage, ValueMap, DataModelUpdateMessage, DataValue, ServerToClientMessageV08 } from '../types/index.cjs';
+import { TextComponent, ImageComponent, RowComponent, ListComponent, DividerComponent, TextFieldComponent, ComponentInstance, ChildrenProperty, Action, ChoicePickerComponent, CreateSurfaceMessage, UpdateComponentsMessage, UpdateDataModelMessage, DeleteSurfaceMessage, DataObject, ServerToClientMessageV09, DataValue, ValueMap } from '../types/index.cjs';
 
 /**
  * ID Generator
@@ -322,35 +322,66 @@ declare function body(content: StringOrPath, options?: Omit<TextOptions, 'usageH
 /**
  * Message Builder
  *
- * 提供 A2UI 协议消息的构建工具函数
- * 支持 v0.8 和 v0.9 两种消息格式
+ * 提供 A2UI v0.9 协议消息的构建工具函数
+ *
+ * v0.9 消息类型：
+ * - createSurface: 创建新的 UI Surface
+ * - updateComponents: 更新组件
+ * - updateDataModel: 更新数据模型 (JSON Patch 风格)
+ * - deleteSurface: 删除 Surface
+ *
+ * 参考: https://a2ui.org/
  */
 
 /**
- * 创建 CreateSurface 消息 (v0.9)
+ * 创建 CreateSurface 消息
  *
  * @param surfaceId - Surface ID
  * @param catalogId - Catalog ID（默认为标准目录）
+ *
+ * @example
+ * ```typescript
+ * const msg = createSurface('my-surface');
+ * // { createSurface: { surfaceId: 'my-surface', catalogId: '...' } }
+ * ```
  */
 declare function createSurface(surfaceId: string, catalogId?: string): CreateSurfaceMessage;
 /**
- * 创建 UpdateComponents 消息 (v0.9)
+ * 创建 UpdateComponents 消息
  *
  * @param surfaceId - Surface ID
  * @param components - 组件列表
+ *
+ * @example
+ * ```typescript
+ * const title = text('Hello', { id: 'title' });
+ * const msg = updateComponents('my-surface', [title]);
+ * ```
  */
 declare function updateComponents(surfaceId: string, components: ComponentInstance[]): UpdateComponentsMessage;
 /**
- * 创建 UpdateDataModel 消息 (v0.9)
+ * 创建 UpdateDataModel 消息
  *
  * @param surfaceId - Surface ID
  * @param value - 数据值
- * @param path - 数据路径（可选）
+ * @param path - 数据路径（可选，默认为根路径）
  * @param op - 操作类型（默认为 replace）
+ *
+ * @example
+ * ```typescript
+ * // 替换整个数据模型
+ * updateDataModel('my-surface', { user: { name: 'John' } });
+ *
+ * // 更新特定路径
+ * updateDataModel('my-surface', 'Jane', '/user/name', 'replace');
+ *
+ * // 添加数据
+ * updateDataModel('my-surface', 'new-item', '/items/-', 'add');
+ * ```
  */
 declare function updateDataModel(surfaceId: string, value: unknown, path?: string, op?: 'add' | 'replace' | 'remove'): UpdateDataModelMessage;
 /**
- * 创建 DeleteSurface 消息 (v0.9)
+ * 创建 DeleteSurface 消息
  *
  * @param surfaceId - 要删除的 Surface ID
  */
@@ -360,6 +391,21 @@ declare function deleteSurface(surfaceId: string): DeleteSurfaceMessage;
  *
  * @param options - 选项
  * @returns 消息数组（可直接作为 JSONL 流发送）
+ *
+ * @example
+ * ```typescript
+ * const title = h1('Welcome', { id: 'title' });
+ * const root = column(['title'], { id: 'root' });
+ *
+ * const messages = createV09Messages({
+ *   surfaceId: '@chat',
+ *   components: [title, root],
+ *   dataModel: { user: { name: 'John' } }
+ * });
+ *
+ * // 发送为 JSONL 流
+ * const jsonl = messagesToJsonl(messages);
+ * ```
  */
 declare function createV09Messages(options: {
     surfaceId: string;
@@ -367,81 +413,26 @@ declare function createV09Messages(options: {
     components: ComponentInstance[];
     dataModel?: DataObject;
 }): ServerToClientMessageV09[];
-/**
- * 创建 BeginRendering 消息 (v0.8)
- *
- * @param rootId - 根组件 ID
- * @param surfaceId - Surface ID
- * @param styles - 样式配置
- */
-declare function beginRendering(rootId: string, surfaceId?: string, styles?: Record<string, string>): BeginRenderingMessage;
-/**
- * 创建 SurfaceUpdate 消息 (v0.8)
- *
- * @param components - 组件定义数组
- * @param surfaceId - Surface ID
- */
-declare function surfaceUpdate(components: ComponentInstanceV08[], surfaceId?: string): SurfaceUpdateMessage;
-/**
- * 创建 DataModelUpdate 消息 (v0.8)
- *
- * @param contents - ValueMap 数组
- * @param surfaceId - Surface ID
- * @param path - 数据路径（可选）
- */
-declare function dataModelUpdate(contents: ValueMap[], surfaceId?: string, path?: string): DataModelUpdateMessage;
-/**
- * 创建 DataModel 初始化消息 (v0.8)
- *
- * @param data - 初始数据对象
- * @param surfaceId - Surface ID
- */
-declare function dataModelInit(data: DataObject, surfaceId?: string): DataModelUpdateMessage;
-/**
- * 创建路径更新消息 (v0.8)
- *
- * @param path - 数据路径
- * @param value - 新值
- * @param surfaceId - Surface ID
- */
-declare function pathUpdate(path: string, value: DataValue, surfaceId?: string): DataModelUpdateMessage;
-/**
- * 创建 DeleteSurface 消息 (v0.8)
- *
- * @param surfaceId - 要删除的 Surface ID
- */
-declare function deleteSurfaceV08(surfaceId: string): {
-    deleteSurface: {
-        surfaceId: string;
-    };
-};
-/**
- * 创建完整的 v0.8 消息数组
- *
- * @param options - 选项
- * @returns 消息数组
- */
-declare function createV08Messages(options: {
-    rootId: string;
-    components: ComponentInstanceV08[];
-    dataModel?: DataObject;
-    surfaceId?: string;
-    styles?: Record<string, string>;
-}): ServerToClientMessageV08[];
 /**
  * 将消息数组转换为 JSONL 格式字符串
  *
  * @param messages - 消息数组
  * @returns JSONL 格式字符串
+ *
+ * @example
+ * ```typescript
+ * const jsonl = messagesToJsonl(messages);
+ * // 每行一个 JSON 对象
+ * ```
  */
-declare function messagesToJsonl(messages: Array<ServerToClientMessageV08 | ServerToClientMessageV09>): string;
+declare function messagesToJsonl(messages: ServerToClientMessageV09[]): string;
 /**
  * 从 JSONL 格式字符串解析消息数组
  *
  * @param jsonl - JSONL 格式字符串
  * @returns 消息数组
  */
-declare function jsonlToMessages(jsonl: string): Array<ServerToClientMessageV08 | ServerToClientMessageV09>;
+declare function jsonlToMessages(jsonl: string): ServerToClientMessageV09[];
 
 /**
  * Data Model Builder
@@ -530,4 +521,4 @@ declare function flattenObjectToValueMap(obj: DataObject, basePath: string): Val
  */
 declare function valueMapToObject(valueMaps: ValueMap[]): DataObject;
 
-export { type AudioPlayerOptions, type ButtonOptions, type CardOptions, type CheckBoxOptions, type ChoicePickerOptions, type ComponentOptions, DEFAULT_PATH_MAPPINGS, type DateTimeInputOptions, type DividerOptions, type IconOptions, type ImageOptions, type LayoutOptions, type ListOptions, type ModalOptions, type PathMappings, type SliderOptions, type TabItem, type TabsOptions, type TextFieldOptions, type TextOptions, type UpdateDataItem, type VideoOptions, audioPlayer, beginRendering, body, button, caption, card, checkbox, choicePicker, column, createSurface, createV08Messages, createV09Messages, dataModelInit, dataModelUpdate, dateTimeInput, deleteSurface, deleteSurfaceV08, divider, flattenObjectToValueMap, generateId, getIdCounter, h1, h2, h3, h4, h5, icon, image, jsonlToMessages, list, messagesToJsonl, modal, normalizePath, objectToValueMap, pathUpdate, resetIdCounter, row, slider, surfaceUpdate, tabs, text, textButton, textField, updateComponents, updateDataModel, updatesToValueMap, valueMapToObject, valueToValueMap, video };
+export { type AudioPlayerOptions, type ButtonOptions, type CardOptions, type CheckBoxOptions, type ChoicePickerOptions, type ComponentOptions, DEFAULT_PATH_MAPPINGS, type DateTimeInputOptions, type DividerOptions, type IconOptions, type ImageOptions, type LayoutOptions, type ListOptions, type ModalOptions, type PathMappings, type SliderOptions, type TabItem, type TabsOptions, type TextFieldOptions, type TextOptions, type UpdateDataItem, type VideoOptions, audioPlayer, body, button, caption, card, checkbox, choicePicker, column, createSurface, createV09Messages, dateTimeInput, deleteSurface, divider, flattenObjectToValueMap, generateId, getIdCounter, h1, h2, h3, h4, h5, icon, image, jsonlToMessages, list, messagesToJsonl, modal, normalizePath, objectToValueMap, resetIdCounter, row, slider, tabs, text, textButton, textField, updateComponents, updateDataModel, updatesToValueMap, valueMapToObject, valueToValueMap, video };

package/dist/builders/index.d.ts

@@ -1,5 +1,5 @@
 import { S as StringOrPath, B as BooleanOrPath, a as StringArrayOrPath, N as NumberOrPath } from '../primitives-nmkVz-tB.js';
-import { TextComponent, ImageComponent, RowComponent, ListComponent, DividerComponent, TextFieldComponent, ComponentInstance, ChildrenProperty, Action, ChoicePickerComponent, CreateSurfaceMessage, UpdateComponentsMessage, UpdateDataModelMessage, DeleteSurfaceMessage, DataObject, ServerToClientMessageV09, BeginRenderingMessage, ComponentInstanceV08, SurfaceUpdateMessage, ValueMap, DataModelUpdateMessage, DataValue, ServerToClientMessageV08 } from '../types/index.js';
+import { TextComponent, ImageComponent, RowComponent, ListComponent, DividerComponent, TextFieldComponent, ComponentInstance, ChildrenProperty, Action, ChoicePickerComponent, CreateSurfaceMessage, UpdateComponentsMessage, UpdateDataModelMessage, DeleteSurfaceMessage, DataObject, ServerToClientMessageV09, DataValue, ValueMap } from '../types/index.js';
 
 /**
  * ID Generator
@@ -322,35 +322,66 @@ declare function body(content: StringOrPath, options?: Omit<TextOptions, 'usageH
 /**
  * Message Builder
  *
- * 提供 A2UI 协议消息的构建工具函数
- * 支持 v0.8 和 v0.9 两种消息格式
+ * 提供 A2UI v0.9 协议消息的构建工具函数
+ *
+ * v0.9 消息类型：
+ * - createSurface: 创建新的 UI Surface
+ * - updateComponents: 更新组件
+ * - updateDataModel: 更新数据模型 (JSON Patch 风格)
+ * - deleteSurface: 删除 Surface
+ *
+ * 参考: https://a2ui.org/
  */
 
 /**
- * 创建 CreateSurface 消息 (v0.9)
+ * 创建 CreateSurface 消息
  *
  * @param surfaceId - Surface ID
  * @param catalogId - Catalog ID（默认为标准目录）
+ *
+ * @example
+ * ```typescript
+ * const msg = createSurface('my-surface');
+ * // { createSurface: { surfaceId: 'my-surface', catalogId: '...' } }
+ * ```
  */
 declare function createSurface(surfaceId: string, catalogId?: string): CreateSurfaceMessage;
 /**
- * 创建 UpdateComponents 消息 (v0.9)
+ * 创建 UpdateComponents 消息
  *
  * @param surfaceId - Surface ID
  * @param components - 组件列表
+ *
+ * @example
+ * ```typescript
+ * const title = text('Hello', { id: 'title' });
+ * const msg = updateComponents('my-surface', [title]);
+ * ```
  */
 declare function updateComponents(surfaceId: string, components: ComponentInstance[]): UpdateComponentsMessage;
 /**
- * 创建 UpdateDataModel 消息 (v0.9)
+ * 创建 UpdateDataModel 消息
  *
  * @param surfaceId - Surface ID
  * @param value - 数据值
- * @param path - 数据路径（可选）
+ * @param path - 数据路径（可选，默认为根路径）
  * @param op - 操作类型（默认为 replace）
+ *
+ * @example
+ * ```typescript
+ * // 替换整个数据模型
+ * updateDataModel('my-surface', { user: { name: 'John' } });
+ *
+ * // 更新特定路径
+ * updateDataModel('my-surface', 'Jane', '/user/name', 'replace');
+ *
+ * // 添加数据
+ * updateDataModel('my-surface', 'new-item', '/items/-', 'add');
+ * ```
  */
 declare function updateDataModel(surfaceId: string, value: unknown, path?: string, op?: 'add' | 'replace' | 'remove'): UpdateDataModelMessage;
 /**
- * 创建 DeleteSurface 消息 (v0.9)
+ * 创建 DeleteSurface 消息
  *
  * @param surfaceId - 要删除的 Surface ID
  */
@@ -360,6 +391,21 @@ declare function deleteSurface(surfaceId: string): DeleteSurfaceMessage;
  *
  * @param options - 选项
  * @returns 消息数组（可直接作为 JSONL 流发送）
+ *
+ * @example
+ * ```typescript
+ * const title = h1('Welcome', { id: 'title' });
+ * const root = column(['title'], { id: 'root' });
+ *
+ * const messages = createV09Messages({
+ *   surfaceId: '@chat',
+ *   components: [title, root],
+ *   dataModel: { user: { name: 'John' } }
+ * });
+ *
+ * // 发送为 JSONL 流
+ * const jsonl = messagesToJsonl(messages);
+ * ```
  */
 declare function createV09Messages(options: {
     surfaceId: string;
@@ -367,81 +413,26 @@ declare function createV09Messages(options: {
     components: ComponentInstance[];
     dataModel?: DataObject;
 }): ServerToClientMessageV09[];
-/**
- * 创建 BeginRendering 消息 (v0.8)
- *
- * @param rootId - 根组件 ID
- * @param surfaceId - Surface ID
- * @param styles - 样式配置
- */
-declare function beginRendering(rootId: string, surfaceId?: string, styles?: Record<string, string>): BeginRenderingMessage;
-/**
- * 创建 SurfaceUpdate 消息 (v0.8)
- *
- * @param components - 组件定义数组
- * @param surfaceId - Surface ID
- */
-declare function surfaceUpdate(components: ComponentInstanceV08[], surfaceId?: string): SurfaceUpdateMessage;
-/**
- * 创建 DataModelUpdate 消息 (v0.8)
- *
- * @param contents - ValueMap 数组
- * @param surfaceId - Surface ID
- * @param path - 数据路径（可选）
- */
-declare function dataModelUpdate(contents: ValueMap[], surfaceId?: string, path?: string): DataModelUpdateMessage;
-/**
- * 创建 DataModel 初始化消息 (v0.8)
- *
- * @param data - 初始数据对象
- * @param surfaceId - Surface ID
- */
-declare function dataModelInit(data: DataObject, surfaceId?: string): DataModelUpdateMessage;
-/**
- * 创建路径更新消息 (v0.8)
- *
- * @param path - 数据路径
- * @param value - 新值
- * @param surfaceId - Surface ID
- */
-declare function pathUpdate(path: string, value: DataValue, surfaceId?: string): DataModelUpdateMessage;
-/**
- * 创建 DeleteSurface 消息 (v0.8)
- *
- * @param surfaceId - 要删除的 Surface ID
- */
-declare function deleteSurfaceV08(surfaceId: string): {
-    deleteSurface: {
-        surfaceId: string;
-    };
-};
-/**
- * 创建完整的 v0.8 消息数组
- *
- * @param options - 选项
- * @returns 消息数组
- */
-declare function createV08Messages(options: {
-    rootId: string;
-    components: ComponentInstanceV08[];
-    dataModel?: DataObject;
-    surfaceId?: string;
-    styles?: Record<string, string>;
-}): ServerToClientMessageV08[];
 /**
  * 将消息数组转换为 JSONL 格式字符串
  *
  * @param messages - 消息数组
  * @returns JSONL 格式字符串
+ *
+ * @example
+ * ```typescript
+ * const jsonl = messagesToJsonl(messages);
+ * // 每行一个 JSON 对象
+ * ```
  */
-declare function messagesToJsonl(messages: Array<ServerToClientMessageV08 | ServerToClientMessageV09>): string;
+declare function messagesToJsonl(messages: ServerToClientMessageV09[]): string;
 /**
  * 从 JSONL 格式字符串解析消息数组
  *
  * @param jsonl - JSONL 格式字符串
  * @returns 消息数组
  */
-declare function jsonlToMessages(jsonl: string): Array<ServerToClientMessageV08 | ServerToClientMessageV09>;
+declare function jsonlToMessages(jsonl: string): ServerToClientMessageV09[];
 
 /**
  * Data Model Builder
@@ -530,4 +521,4 @@ declare function flattenObjectToValueMap(obj: DataObject, basePath: string): Val
  */
 declare function valueMapToObject(valueMaps: ValueMap[]): DataObject;
 
-export { type AudioPlayerOptions, type ButtonOptions, type CardOptions, type CheckBoxOptions, type ChoicePickerOptions, type ComponentOptions, DEFAULT_PATH_MAPPINGS, type DateTimeInputOptions, type DividerOptions, type IconOptions, type ImageOptions, type LayoutOptions, type ListOptions, type ModalOptions, type PathMappings, type SliderOptions, type TabItem, type TabsOptions, type TextFieldOptions, type TextOptions, type UpdateDataItem, type VideoOptions, audioPlayer, beginRendering, body, button, caption, card, checkbox, choicePicker, column, createSurface, createV08Messages, createV09Messages, dataModelInit, dataModelUpdate, dateTimeInput, deleteSurface, deleteSurfaceV08, divider, flattenObjectToValueMap, generateId, getIdCounter, h1, h2, h3, h4, h5, icon, image, jsonlToMessages, list, messagesToJsonl, modal, normalizePath, objectToValueMap, pathUpdate, resetIdCounter, row, slider, surfaceUpdate, tabs, text, textButton, textField, updateComponents, updateDataModel, updatesToValueMap, valueMapToObject, valueToValueMap, video };
+export { type AudioPlayerOptions, type ButtonOptions, type CardOptions, type CheckBoxOptions, type ChoicePickerOptions, type ComponentOptions, DEFAULT_PATH_MAPPINGS, type DateTimeInputOptions, type DividerOptions, type IconOptions, type ImageOptions, type LayoutOptions, type ListOptions, type ModalOptions, type PathMappings, type SliderOptions, type TabItem, type TabsOptions, type TextFieldOptions, type TextOptions, type UpdateDataItem, type VideoOptions, audioPlayer, body, button, caption, card, checkbox, choicePicker, column, createSurface, createV09Messages, dateTimeInput, deleteSurface, divider, flattenObjectToValueMap, generateId, getIdCounter, h1, h2, h3, h4, h5, icon, image, jsonlToMessages, list, messagesToJsonl, modal, normalizePath, objectToValueMap, resetIdCounter, row, slider, tabs, text, textButton, textField, updateComponents, updateDataModel, updatesToValueMap, valueMapToObject, valueToValueMap, video };

package/dist/builders/index.js

@@ -1,3 +1,3 @@
-var g=0;function i(t="comp"){return `${t}_${Date.now()}_${g++}`}function V(){g=0;}function D(){return g}function p(t,e={}){let{id:n=i("text"),weight:o,usageHint:a}=e;return {id:n,component:"Text",text:t,...o!==void 0&&{weight:o},...a&&{usageHint:a}}}function v(t,e={}){let{id:n=i("image"),weight:o,fit:a,usageHint:r}=e;return {id:n,component:"Image",url:t,...o!==void 0&&{weight:o},...a&&{fit:a},...r&&{usageHint:r}}}function P(t,e={}){let{id:n=i("icon"),weight:o}=e;return {id:n,component:"Icon",name:t,...o!==void 0&&{weight:o}}}function A(t,e={}){let{id:n=i("video"),weight:o}=e;return {id:n,component:"Video",url:t,...o!==void 0&&{weight:o}}}function U(t,e={}){let{id:n=i("audio"),weight:o,description:a}=e;return {id:n,component:"AudioPlayer",url:t,...o!==void 0&&{weight:o},...a&&{description:a}}}function w(t,e={}){let{id:n=i("row"),weight:o,alignment:a,distribution:r}=e;return {id:n,component:"Row",children:t,...o!==void 0&&{weight:o},...a&&{alignment:a},...r&&{distribution:r}}}function j(t,e={}){let{id:n=i("column"),weight:o,alignment:a,distribution:r}=e;return {id:n,component:"Column",children:t,...o!==void 0&&{weight:o},...a&&{alignment:a},...r&&{distribution:r}}}function R(t,e={}){let{id:n=i("list"),weight:o,direction:a,alignment:r}=e;return {id:n,component:"List",children:t,...o!==void 0&&{weight:o},...a&&{direction:a},...r&&{alignment:r}}}function _(t,e={}){let{id:n=i("card"),weight:o}=e;return {id:n,component:"Card",child:t,...o!==void 0&&{weight:o}}}function k(t,e={}){let{id:n=i("tabs"),weight:o}=e;return {id:n,component:"Tabs",tabItems:t.map(a=>({title:a.title,child:a.childId})),...o!==void 0&&{weight:o}}}function B(t={}){let{id:e=i("divider"),weight:n,axis:o}=t;return {id:e,component:"Divider",...n!==void 0&&{weight:n},...o&&{axis:o}}}function H(t,e,n={}){let{id:o=i("modal"),weight:a}=n;return {id:o,component:"Modal",entryPointChild:t,contentChild:e,...a!==void 0&&{weight:a}}}function f(t,e,n={}){let{id:o=i("button"),weight:a,primary:r}=n;return {id:o,component:"Button",child:t,action:e,...a!==void 0&&{weight:a},...r!==void 0&&{primary:r}}}function N(t,e,n={}){let{id:o=i("checkbox"),weight:a}=n;return {id:o,component:"CheckBox",label:t,value:e,...a!==void 0&&{weight:a}}}function E(t,e,n={}){let{id:o=i("textfield"),weight:a,usageHint:r,validationRegexp:s}=n;return {id:o,component:"TextField",label:t,...e!==void 0&&{text:e},...a!==void 0&&{weight:a},...r&&{usageHint:r},...s&&{validationRegexp:s}}}function L(t,e={}){let{id:n=i("datetime"),weight:o,enableDate:a,enableTime:r,outputFormat:s,label:c}=e;return {id:n,component:"DateTimeInput",value:t,...o!==void 0&&{weight:o},...a!==void 0&&{enableDate:a},...r!==void 0&&{enableTime:r},...s&&{outputFormat:s},...c&&{label:c}}}function $(t,e,n,o={}){let{id:a=i("choice"),weight:r,label:s}=o;return {id:a,component:"ChoicePicker",options:t,value:e,usageHint:n,...r!==void 0&&{weight:r},...s&&{label:s}}}function F(t,e={}){let{id:n=i("slider"),weight:o,label:a,min:r,max:s}=e;return {id:n,component:"Slider",value:t,...o!==void 0&&{weight:o},...a&&{label:a},...r!==void 0&&{min:r},...s!==void 0&&{max:s}}}function G(t,e,n={}){let o=n.textId??i("btn_text"),a=p(t,{id:o}),r=f(o,e,n);return [a,r]}function z(t,e={}){return p(t,{...e,usageHint:"h1"})}function J(t,e={}){return p(t,{...e,usageHint:"h2"})}function X(t,e={}){return p(t,{...e,usageHint:"h3"})}function W(t,e={}){return p(t,{...e,usageHint:"h4"})}function Y(t,e={}){return p(t,{...e,usageHint:"h5"})}function K(t,e={}){return p(t,{...e,usageHint:"caption"})}function q(t,e={}){return p(t,{...e,usageHint:"body"})}var d="https://a2ui.dev/specification/0.9/standard_catalog_definition.json";var C={};function l(t,e=""){let n=[];for(let[o,a]of Object.entries(t)){let r=e?`${e}/${o}`:`/${o}`;n.push(u(r,a));}return n}function u(t,e){if(e==null)return {key:t,valueString:""};if(typeof e=="string")return {key:t,valueString:e};if(typeof e=="number")return {key:t,valueNumber:e};if(typeof e=="boolean")return {key:t,valueBoolean:e};if(Array.isArray(e))return {key:t,valueMap:e.map((n,o)=>u(String(o),n))};if(typeof e=="object"){let n=[];for(let[o,a]of Object.entries(e))n.push(u(o,a));return {key:t,valueMap:n}}return {key:t,valueString:String(e)}}function x(t,e={}){let n=t.replace(/\./g,"/");n.startsWith("/")||(n=`/${n}`);for(let[o,a]of Object.entries(e)){let r=new RegExp(`^/${o}(/|$)`);r.test(n)&&(n=n.replace(r,`/${a}$1`));}return n}function Q(t,e="",n=C){let o=[];for(let a of t){let r=a.path.startsWith("/")?a.path:`${e}/${a.path}`,s=x(r,n);if(a.value!==null&&typeof a.value=="object"&&!Array.isArray(a.value)){let c=m(a.value,s);o.push(...c);}else o.push(u(s,a.value));}return o}function m(t,e){let n=[];for(let[o,a]of Object.entries(t)){let r=`${e}/${o}`;if(a!==null&&typeof a=="object"&&!Array.isArray(a)){let s=m(a,r);n.push(...s);}else n.push(u(r,a));}return n}function M(t){let e={};for(let n of t){let o=n.key.startsWith("/")?n.key.slice(1):n.key;n.valueString!==void 0?e[o]=n.valueString:n.valueNumber!==void 0?e[o]=n.valueNumber:n.valueBoolean!==void 0?e[o]=n.valueBoolean:n.valueMap!==void 0&&(e[o]=M(n.valueMap));}return e}function O(t,e=d){return {createSurface:{surfaceId:t,catalogId:e}}}function h(t,e){return {updateComponents:{surfaceId:t,components:e}}}function I(t,e,n,o="replace"){return {updateDataModel:{surfaceId:t,...n&&{path:n},op:o,...o!=="remove"&&{value:e}}}}function Z(t){return {deleteSurface:{surfaceId:t}}}function ee(t){let{surfaceId:e,catalogId:n=d,components:o,dataModel:a}=t,r=[O(e,n),h(e,o)];return a&&r.push(I(e,a)),r}function S(t,e="@default",n){return {beginRendering:{surfaceId:e,root:t,...n&&{styles:n}}}}function T(t,e="@default"){return {surfaceUpdate:{surfaceId:e,components:t}}}function y(t,e="@default",n){return {dataModelUpdate:{surfaceId:e,contents:t,...n&&{path:n}}}}function b(t,e="@default"){return y(l(t),e)}function te(t,e,n="@default"){return {dataModelUpdate:{surfaceId:n,path:t,contents:[u("",e)]}}}function ne(t){return {deleteSurface:{surfaceId:t}}}function oe(t){let{rootId:e,components:n,dataModel:o,surfaceId:a="@default",styles:r}=t,s=[T(n,a)];return o&&s.push(b(o,a)),s.push(S(e,a,r)),s}function ae(t){return t.map(e=>JSON.stringify(e)).join(`
-`)}function re(t){return t.split(`
-`).filter(e=>e.trim()).map(e=>JSON.parse(e))}export{C as DEFAULT_PATH_MAPPINGS,U as audioPlayer,S as beginRendering,q as body,f as button,K as caption,_ as card,N as checkbox,$ as choicePicker,j as column,O as createSurface,oe as createV08Messages,ee as createV09Messages,b as dataModelInit,y as dataModelUpdate,L as dateTimeInput,Z as deleteSurface,ne as deleteSurfaceV08,B as divider,m as flattenObjectToValueMap,i as generateId,D as getIdCounter,z as h1,J as h2,X as h3,W as h4,Y as h5,P as icon,v as image,re as jsonlToMessages,R as list,ae as messagesToJsonl,H as modal,x as normalizePath,l as objectToValueMap,te as pathUpdate,V as resetIdCounter,w as row,F as slider,T as surfaceUpdate,k as tabs,p as text,G as textButton,E as textField,h as updateComponents,I as updateDataModel,Q as updatesToValueMap,M as valueMapToObject,u as valueToValueMap,A as video};
+var m=0;function i(t="comp"){return `${t}_${Date.now()}_${m++}`}function I(){m=0;}function S(){return m}function p(t,e={}){let{id:n=i("text"),weight:o,usageHint:a}=e;return {id:n,component:"Text",text:t,...o!==void 0&&{weight:o},...a&&{usageHint:a}}}function y(t,e={}){let{id:n=i("image"),weight:o,fit:a,usageHint:r}=e;return {id:n,component:"Image",url:t,...o!==void 0&&{weight:o},...a&&{fit:a},...r&&{usageHint:r}}}function T(t,e={}){let{id:n=i("icon"),weight:o}=e;return {id:n,component:"Icon",name:t,...o!==void 0&&{weight:o}}}function b(t,e={}){let{id:n=i("video"),weight:o}=e;return {id:n,component:"Video",url:t,...o!==void 0&&{weight:o}}}function D(t,e={}){let{id:n=i("audio"),weight:o,description:a}=e;return {id:n,component:"AudioPlayer",url:t,...o!==void 0&&{weight:o},...a&&{description:a}}}function v(t,e={}){let{id:n=i("row"),weight:o,alignment:a,distribution:r}=e;return {id:n,component:"Row",children:t,...o!==void 0&&{weight:o},...a&&{alignment:a},...r&&{distribution:r}}}function P(t,e={}){let{id:n=i("column"),weight:o,alignment:a,distribution:r}=e;return {id:n,component:"Column",children:t,...o!==void 0&&{weight:o},...a&&{alignment:a},...r&&{distribution:r}}}function V(t,e={}){let{id:n=i("list"),weight:o,direction:a,alignment:r}=e;return {id:n,component:"List",children:t,...o!==void 0&&{weight:o},...a&&{direction:a},...r&&{alignment:r}}}function A(t,e={}){let{id:n=i("card"),weight:o}=e;return {id:n,component:"Card",child:t,...o!==void 0&&{weight:o}}}function U(t,e={}){let{id:n=i("tabs"),weight:o}=e;return {id:n,component:"Tabs",tabItems:t.map(a=>({title:a.title,child:a.childId})),...o!==void 0&&{weight:o}}}function w(t={}){let{id:e=i("divider"),weight:n,axis:o}=t;return {id:e,component:"Divider",...n!==void 0&&{weight:n},...o&&{axis:o}}}function j(t,e,n={}){let{id:o=i("modal"),weight:a}=n;return {id:o,component:"Modal",entryPointChild:t,contentChild:e,...a!==void 0&&{weight:a}}}function l(t,e,n={}){let{id:o=i("button"),weight:a,primary:r}=n;return {id:o,component:"Button",child:t,action:e,...a!==void 0&&{weight:a},...r!==void 0&&{primary:r}}}function _(t,e,n={}){let{id:o=i("checkbox"),weight:a}=n;return {id:o,component:"CheckBox",label:t,value:e,...a!==void 0&&{weight:a}}}function k(t,e,n={}){let{id:o=i("textfield"),weight:a,usageHint:r,validationRegexp:s}=n;return {id:o,component:"TextField",label:t,...e!==void 0&&{text:e},...a!==void 0&&{weight:a},...r&&{usageHint:r},...s&&{validationRegexp:s}}}function H(t,e={}){let{id:n=i("datetime"),weight:o,enableDate:a,enableTime:r,outputFormat:s,label:u}=e;return {id:n,component:"DateTimeInput",value:t,...o!==void 0&&{weight:o},...a!==void 0&&{enableDate:a},...r!==void 0&&{enableTime:r},...s&&{outputFormat:s},...u&&{label:u}}}function N(t,e,n,o={}){let{id:a=i("choice"),weight:r,label:s}=o;return {id:a,component:"ChoicePicker",options:t,value:e,usageHint:n,...r!==void 0&&{weight:r},...s&&{label:s}}}function B(t,e={}){let{id:n=i("slider"),weight:o,label:a,min:r,max:s}=e;return {id:n,component:"Slider",value:t,...o!==void 0&&{weight:o},...a&&{label:a},...r!==void 0&&{min:r},...s!==void 0&&{max:s}}}function E(t,e,n={}){let o=n.textId??i("btn_text"),a=p(t,{id:o}),r=l(o,e,n);return [a,r]}function R(t,e={}){return p(t,{...e,usageHint:"h1"})}function L(t,e={}){return p(t,{...e,usageHint:"h2"})}function $(t,e={}){return p(t,{...e,usageHint:"h3"})}function F(t,e={}){return p(t,{...e,usageHint:"h4"})}function G(t,e={}){return p(t,{...e,usageHint:"h5"})}function z(t,e={}){return p(t,{...e,usageHint:"caption"})}function J(t,e={}){return p(t,{...e,usageHint:"body"})}var d="https://a2ui.dev/specification/0.9/standard_catalog_definition.json";function f(t,e=d){return {createSurface:{surfaceId:t,catalogId:e}}}function C(t,e){return {updateComponents:{surfaceId:t,components:e}}}function x(t,e,n,o="replace"){return {updateDataModel:{surfaceId:t,...n&&{path:n},op:o,...o!=="remove"&&{value:e}}}}function X(t){return {deleteSurface:{surfaceId:t}}}function W(t){let{surfaceId:e,catalogId:n=d,components:o,dataModel:a}=t,r=[f(e,n),C(e,o)];return a&&r.push(x(e,a)),r}function Y(t){return t.map(e=>JSON.stringify(e)).join(`
+`)}function K(t){return t.split(`
+`).filter(e=>e.trim()).map(e=>JSON.parse(e))}var O={};function q(t,e=""){let n=[];for(let[o,a]of Object.entries(t)){let r=e?`${e}/${o}`:`/${o}`;n.push(c(r,a));}return n}function c(t,e){if(e==null)return {key:t,valueString:""};if(typeof e=="string")return {key:t,valueString:e};if(typeof e=="number")return {key:t,valueNumber:e};if(typeof e=="boolean")return {key:t,valueBoolean:e};if(Array.isArray(e))return {key:t,valueMap:e.map((n,o)=>c(String(o),n))};if(typeof e=="object"){let n=[];for(let[o,a]of Object.entries(e))n.push(c(o,a));return {key:t,valueMap:n}}return {key:t,valueString:String(e)}}function h(t,e={}){let n=t.replace(/\./g,"/");n.startsWith("/")||(n=`/${n}`);for(let[o,a]of Object.entries(e)){let r=new RegExp(`^/${o}(/|$)`);r.test(n)&&(n=n.replace(r,`/${a}$1`));}return n}function Q(t,e="",n=O){let o=[];for(let a of t){let r=a.path.startsWith("/")?a.path:`${e}/${a.path}`,s=h(r,n);if(a.value!==null&&typeof a.value=="object"&&!Array.isArray(a.value)){let u=g(a.value,s);o.push(...u);}else o.push(c(s,a.value));}return o}function g(t,e){let n=[];for(let[o,a]of Object.entries(t)){let r=`${e}/${o}`;if(a!==null&&typeof a=="object"&&!Array.isArray(a)){let s=g(a,r);n.push(...s);}else n.push(c(r,a));}return n}function M(t){let e={};for(let n of t){let o=n.key.startsWith("/")?n.key.slice(1):n.key;n.valueString!==void 0?e[o]=n.valueString:n.valueNumber!==void 0?e[o]=n.valueNumber:n.valueBoolean!==void 0?e[o]=n.valueBoolean:n.valueMap!==void 0&&(e[o]=M(n.valueMap));}return e}export{O as DEFAULT_PATH_MAPPINGS,D as audioPlayer,J as body,l as button,z as caption,A as card,_ as checkbox,N as choicePicker,P as column,f as createSurface,W as createV09Messages,H as dateTimeInput,X as deleteSurface,w as divider,g as flattenObjectToValueMap,i as generateId,S as getIdCounter,R as h1,L as h2,$ as h3,F as h4,G as h5,T as icon,y as image,K as jsonlToMessages,V as list,Y as messagesToJsonl,j as modal,h as normalizePath,q as objectToValueMap,I as resetIdCounter,v as row,B as slider,U as tabs,p as text,E as textButton,k as textField,C as updateComponents,x as updateDataModel,Q as updatesToValueMap,M as valueMapToObject,c as valueToValueMap,b as video};

package/dist/index.cjs

@@ -1,3 +1,3 @@
-'use strict';function U(e){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e}function N(e){return "beginRendering"in e||"surfaceUpdate"in e||"dataModelUpdate"in e}var l="https://a2ui.dev/specification/0.9/standard_catalog_definition.json",_="https://a2ui.org/a2a-extension/a2ui/v0.8",E="https://a2ui.dev/specification/0.9",R="application/json+a2ui";var f=0;function p(e="comp"){return `${e}_${Date.now()}_${f++}`}function w(){f=0;}function k(){return f}function d(e,t={}){let{id:n=p("text"),weight:a,usageHint:o}=t;return {id:n,component:"Text",text:e,...a!==void 0&&{weight:a},...o&&{usageHint:o}}}function j(e,t={}){let{id:n=p("image"),weight:a,fit:o,usageHint:r}=t;return {id:n,component:"Image",url:e,...a!==void 0&&{weight:a},...o&&{fit:o},...r&&{usageHint:r}}}function B(e,t={}){let{id:n=p("icon"),weight:a}=t;return {id:n,component:"Icon",name:e,...a!==void 0&&{weight:a}}}function L(e,t={}){let{id:n=p("video"),weight:a}=t;return {id:n,component:"Video",url:e,...a!==void 0&&{weight:a}}}function $(e,t={}){let{id:n=p("audio"),weight:a,description:o}=t;return {id:n,component:"AudioPlayer",url:e,...a!==void 0&&{weight:a},...o&&{description:o}}}function F(e,t={}){let{id:n=p("row"),weight:a,alignment:o,distribution:r}=t;return {id:n,component:"Row",children:e,...a!==void 0&&{weight:a},...o&&{alignment:o},...r&&{distribution:r}}}function G(e,t={}){let{id:n=p("column"),weight:a,alignment:o,distribution:r}=t;return {id:n,component:"Column",children:e,...a!==void 0&&{weight:a},...o&&{alignment:o},...r&&{distribution:r}}}function H(e,t={}){let{id:n=p("list"),weight:a,direction:o,alignment:r}=t;return {id:n,component:"List",children:e,...a!==void 0&&{weight:a},...o&&{direction:o},...r&&{alignment:r}}}function q(e,t={}){let{id:n=p("card"),weight:a}=t;return {id:n,component:"Card",child:e,...a!==void 0&&{weight:a}}}function W(e,t={}){let{id:n=p("tabs"),weight:a}=t;return {id:n,component:"Tabs",tabItems:e.map(o=>({title:o.title,child:o.childId})),...a!==void 0&&{weight:a}}}function Y(e={}){let{id:t=p("divider"),weight:n,axis:a}=e;return {id:t,component:"Divider",...n!==void 0&&{weight:n},...a&&{axis:a}}}function X(e,t,n={}){let{id:a=p("modal"),weight:o}=n;return {id:a,component:"Modal",entryPointChild:e,contentChild:t,...o!==void 0&&{weight:o}}}function C(e,t,n={}){let{id:a=p("button"),weight:o,primary:r}=n;return {id:a,component:"Button",child:e,action:t,...o!==void 0&&{weight:o},...r!==void 0&&{primary:r}}}function z(e,t,n={}){let{id:a=p("checkbox"),weight:o}=n;return {id:a,component:"CheckBox",label:e,value:t,...o!==void 0&&{weight:o}}}function J(e,t,n={}){let{id:a=p("textfield"),weight:o,usageHint:r,validationRegexp:i}=n;return {id:a,component:"TextField",label:e,...t!==void 0&&{text:t},...o!==void 0&&{weight:o},...r&&{usageHint:r},...i&&{validationRegexp:i}}}function K(e,t={}){let{id:n=p("datetime"),weight:a,enableDate:o,enableTime:r,outputFormat:i,label:s}=t;return {id:n,component:"DateTimeInput",value:e,...a!==void 0&&{weight:a},...o!==void 0&&{enableDate:o},...r!==void 0&&{enableTime:r},...i&&{outputFormat:i},...s&&{label:s}}}function Q(e,t,n,a={}){let{id:o=p("choice"),weight:r,label:i}=a;return {id:o,component:"ChoicePicker",options:e,value:t,usageHint:n,...r!==void 0&&{weight:r},...i&&{label:i}}}function Z(e,t={}){let{id:n=p("slider"),weight:a,label:o,min:r,max:i}=t;return {id:n,component:"Slider",value:e,...a!==void 0&&{weight:a},...o&&{label:o},...r!==void 0&&{min:r},...i!==void 0&&{max:i}}}function ee(e,t,n={}){let a=n.textId??p("btn_text"),o=d(e,{id:a}),r=C(a,t,n);return [o,r]}function te(e,t={}){return d(e,{...t,usageHint:"h1"})}function ne(e,t={}){return d(e,{...t,usageHint:"h2"})}function oe(e,t={}){return d(e,{...t,usageHint:"h3"})}function ae(e,t={}){return d(e,{...t,usageHint:"h4"})}function re(e,t={}){return d(e,{...t,usageHint:"h5"})}function ie(e,t={}){return d(e,{...t,usageHint:"caption"})}function se(e,t={}){return d(e,{...t,usageHint:"body"})}var M={};function g(e,t=""){let n=[];for(let[a,o]of Object.entries(e)){let r=t?`${t}/${a}`:`/${a}`;n.push(c(r,o));}return n}function c(e,t){if(t==null)return {key:e,valueString:""};if(typeof t=="string")return {key:e,valueString:t};if(typeof t=="number")return {key:e,valueNumber:t};if(typeof t=="boolean")return {key:e,valueBoolean:t};if(Array.isArray(t))return {key:e,valueMap:t.map((n,a)=>c(String(a),n))};if(typeof t=="object"){let n=[];for(let[a,o]of Object.entries(t))n.push(c(a,o));return {key:e,valueMap:n}}return {key:e,valueString:String(t)}}function I(e,t={}){let n=e.replace(/\./g,"/");n.startsWith("/")||(n=`/${n}`);for(let[a,o]of Object.entries(t)){let r=new RegExp(`^/${a}(/|$)`);r.test(n)&&(n=n.replace(r,`/${o}$1`));}return n}function pe(e,t="",n=M){let a=[];for(let o of e){let r=o.path.startsWith("/")?o.path:`${t}/${o.path}`,i=I(r,n);if(o.value!==null&&typeof o.value=="object"&&!Array.isArray(o.value)){let s=m(o.value,i);a.push(...s);}else a.push(c(i,o.value));}return a}function m(e,t){let n=[];for(let[a,o]of Object.entries(e)){let r=`${t}/${a}`;if(o!==null&&typeof o=="object"&&!Array.isArray(o)){let i=m(o,r);n.push(...i);}else n.push(c(r,o));}return n}function h(e){let t={};for(let n of e){let a=n.key.startsWith("/")?n.key.slice(1):n.key;n.valueString!==void 0?t[a]=n.valueString:n.valueNumber!==void 0?t[a]=n.valueNumber:n.valueBoolean!==void 0?t[a]=n.valueBoolean:n.valueMap!==void 0&&(t[a]=h(n.valueMap));}return t}function x(e,t=l){return {createSurface:{surfaceId:e,catalogId:t}}}function O(e,t){return {updateComponents:{surfaceId:e,components:t}}}function S(e,t,n,a="replace"){return {updateDataModel:{surfaceId:e,...n&&{path:n},op:a,...a!=="remove"&&{value:t}}}}function de(e){return {deleteSurface:{surfaceId:e}}}function ce(e){let{surfaceId:t,catalogId:n=l,components:a,dataModel:o}=e,r=[x(t,n),O(t,a)];return o&&r.push(S(t,o)),r}function T(e,t="@default",n){return {beginRendering:{surfaceId:t,root:e,...n&&{styles:n}}}}function y(e,t="@default"){return {surfaceUpdate:{surfaceId:t,components:e}}}function V(e,t="@default",n){return {dataModelUpdate:{surfaceId:t,contents:e,...n&&{path:n}}}}function D(e,t="@default"){return V(g(e),t)}function ue(e,t,n="@default"){return {dataModelUpdate:{surfaceId:n,path:e,contents:[c("",t)]}}}function le(e){return {deleteSurface:{surfaceId:e}}}function ge(e){let{rootId:t,components:n,dataModel:a,surfaceId:o="@default",styles:r}=e,i=[y(n,o)];return a&&i.push(D(a,o)),i.push(T(t,o,r)),i}function me(e){return e.map(t=>JSON.stringify(t)).join(`
-`)}function fe(e){return e.split(`
-`).filter(t=>t.trim()).map(t=>JSON.parse(t))}var Ie=["Text","Image","Icon","Video","AudioPlayer","Row","Column","List","Card","Tabs","Divider","Modal","Button","CheckBox","TextField","DateTimeInput","ChoicePicker","Slider"];function b(e,t={}){let n=[],a=[];if("createSurface"in e){let{createSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"createSurface.surfaceId is required",path:"createSurface.surfaceId"}),o.catalogId||n.push({code:"MISSING_CATALOG_ID",message:"createSurface.catalogId is required",path:"createSurface.catalogId"});}else if("updateComponents"in e){let{updateComponents:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"updateComponents.surfaceId is required",path:"updateComponents.surfaceId"}),!o.components||!Array.isArray(o.components)?n.push({code:"INVALID_COMPONENTS",message:"updateComponents.components must be an array",path:"updateComponents.components"}):he(o.components,n,a,t);}else if("updateDataModel"in e){let{updateDataModel:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"updateDataModel.surfaceId is required",path:"updateDataModel.surfaceId"});}else if("deleteSurface"in e){let{deleteSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"});}else n.push({code:"INVALID_MESSAGE_TYPE",message:"Message must contain one of: createSurface, updateComponents, updateDataModel, deleteSurface"});return {valid:n.length===0,errors:n,warnings:a}}function P(e,t={}){let n=[],a=[];if("beginRendering"in e){let{beginRendering:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"beginRendering.surfaceId is required",path:"beginRendering.surfaceId"}),o.root||n.push({code:"MISSING_ROOT",message:"beginRendering.root is required",path:"beginRendering.root"});}else if("surfaceUpdate"in e){let{surfaceUpdate:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"surfaceUpdate.surfaceId is required",path:"surfaceUpdate.surfaceId"}),!o.components||!Array.isArray(o.components)?n.push({code:"INVALID_COMPONENTS",message:"surfaceUpdate.components must be an array",path:"surfaceUpdate.components"}):xe(o.components,n,a,t);}else if("dataModelUpdate"in e){let{dataModelUpdate:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"dataModelUpdate.surfaceId is required",path:"dataModelUpdate.surfaceId"}),(!o.contents||!Array.isArray(o.contents))&&n.push({code:"INVALID_CONTENTS",message:"dataModelUpdate.contents must be an array",path:"dataModelUpdate.contents"});}else if("deleteSurface"in e){let{deleteSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"});}else n.push({code:"INVALID_MESSAGE_TYPE",message:"Message must contain one of: beginRendering, surfaceUpdate, dataModelUpdate, deleteSurface"});return {valid:n.length===0,errors:n,warnings:a}}function v(e,t={}){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e?b(e,t):"beginRendering"in e||"surfaceUpdate"in e||"dataModelUpdate"in e?P(e,t):"deleteSurface"in e?e.deleteSurface.surfaceId?{valid:true,errors:[],warnings:[]}:{valid:false,errors:[{code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"}],warnings:[]}:{valid:false,errors:[{code:"UNKNOWN_MESSAGE_TYPE",message:"Unknown message type"}],warnings:[]}}function Ce(e,t={}){let n=[],a=[];for(let o=0;o<e.length;o++){let r=e[o];if(!r)continue;let i=v(r,t);for(let s of i.errors)n.push({...s,path:`messages[${o}].${s.path??""}`});for(let s of i.warnings)a.push({...s,path:`messages[${o}].${s.path??""}`});}return {valid:n.length===0,errors:n,warnings:a}}function he(e,t,n,a){let o=new Set,r=false;for(let i=0;i<e.length;i++){let s=e[i];if(!s)continue;let u=`updateComponents.components[${i}]`;s.id?(o.has(s.id)&&t.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${s.id}`,path:`${u}.id`}),o.add(s.id),s.id==="root"&&(r=true)):t.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${u}.id`}),s.component?a.strict&&a.allowedComponents&&(a.allowedComponents.includes(s.component)||n.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${s.component}`,path:`${u}.component`})):t.push({code:"MISSING_COMPONENT_TYPE",message:"Component type is required",path:`${u}.component`});}!r&&a.strict&&n.push({code:"MISSING_ROOT_COMPONENT",message:'No component with id "root" found',path:"updateComponents.components"});}function xe(e,t,n,a){let o=new Set;for(let r=0;r<e.length;r++){let i=e[r];if(!i)continue;let s=`surfaceUpdate.components[${r}]`;if(i.id?(o.has(i.id)&&t.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${i.id}`,path:`${s}.id`}),o.add(i.id)):t.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${s}.id`}),!i.component||typeof i.component!="object")t.push({code:"MISSING_COMPONENT",message:"Component definition is required",path:`${s}.component`});else {let u=Object.keys(i.component)[0];u&&a.strict&&!Ie.includes(u)&&n.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${u}`,path:`${s}.component`});}}}function A(e){return typeof e=="object"&&e!==null&&"path"in e}function Oe(e){if(!A(e))return e}function Se(e){if(A(e))return e.path}function Te(e){return {path:e}}function Me(e,t){let n={...e};for(let a of Object.keys(t)){let o=t[a],r=n[a];o!==void 0&&typeof o=="object"&&o!==null&&!Array.isArray(o)&&typeof r=="object"&&r!==null&&!Array.isArray(r)?n[a]=Me(r,o):o!==void 0&&(n[a]=o);}return n}function ye(){return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{let t=Math.random()*16|0;return (e==="x"?t:t&3|8).toString(16)})}exports.A2UI_EXTENSION_URI=E;exports.A2UI_EXTENSION_URI_V08=_;exports.A2UI_MIME_TYPE=R;exports.DEFAULT_PATH_MAPPINGS=M;exports.STANDARD_CATALOG_ID=l;exports.audioPlayer=$;exports.beginRendering=T;exports.body=se;exports.button=C;exports.caption=ie;exports.card=q;exports.checkbox=z;exports.choicePicker=Q;exports.column=G;exports.createSurface=x;exports.createV08Messages=ge;exports.createV09Messages=ce;exports.dataModelInit=D;exports.dataModelUpdate=V;exports.dateTimeInput=K;exports.deepMerge=Me;exports.deleteSurface=de;exports.deleteSurfaceV08=le;exports.divider=Y;exports.flattenObjectToValueMap=m;exports.generateId=p;exports.getIdCounter=k;exports.getLiteralValue=Oe;exports.getPathValue=Se;exports.h1=te;exports.h2=ne;exports.h3=oe;exports.h4=ae;exports.h5=re;exports.icon=B;exports.image=j;exports.isPathBinding=A;exports.isV08Message=N;exports.isV09Message=U;exports.jsonlToMessages=fe;exports.list=H;exports.messagesToJsonl=me;exports.modal=X;exports.normalizePath=I;exports.objectToValueMap=g;exports.path=Te;exports.pathUpdate=ue;exports.resetIdCounter=w;exports.row=F;exports.slider=Z;exports.surfaceUpdate=y;exports.tabs=W;exports.text=d;exports.textButton=ee;exports.textField=J;exports.updateComponents=O;exports.updateDataModel=S;exports.updatesToValueMap=pe;exports.uuid=ye;exports.validateMessage=v;exports.validateMessages=Ce;exports.validateV08Message=P;exports.validateV09Message=b;exports.valueMapToObject=h;exports.valueToValueMap=c;exports.video=L;
+'use strict';function N(e){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e}function U(e){return "beginRendering"in e||"surfaceUpdate"in e||"dataModelUpdate"in e}var C="https://a2ui.dev/specification/0.9/standard_catalog_definition.json",_="https://a2ui.org/a2a-extension/a2ui/v0.8",E="https://a2ui.dev/specification/0.9",R="application/json+a2ui";var O=0;function p(e="comp"){return `${e}_${Date.now()}_${O++}`}function w(){O=0;}function k(){return O}function c(e,t={}){let{id:n=p("text"),weight:a,usageHint:o}=t;return {id:n,component:"Text",text:e,...a!==void 0&&{weight:a},...o&&{usageHint:o}}}function j(e,t={}){let{id:n=p("image"),weight:a,fit:o,usageHint:r}=t;return {id:n,component:"Image",url:e,...a!==void 0&&{weight:a},...o&&{fit:o},...r&&{usageHint:r}}}function F(e,t={}){let{id:n=p("icon"),weight:a}=t;return {id:n,component:"Icon",name:e,...a!==void 0&&{weight:a}}}function B(e,t={}){let{id:n=p("video"),weight:a}=t;return {id:n,component:"Video",url:e,...a!==void 0&&{weight:a}}}function $(e,t={}){let{id:n=p("audio"),weight:a,description:o}=t;return {id:n,component:"AudioPlayer",url:e,...a!==void 0&&{weight:a},...o&&{description:o}}}function L(e,t={}){let{id:n=p("row"),weight:a,alignment:o,distribution:r}=t;return {id:n,component:"Row",children:e,...a!==void 0&&{weight:a},...o&&{alignment:o},...r&&{distribution:r}}}function H(e,t={}){let{id:n=p("column"),weight:a,alignment:o,distribution:r}=t;return {id:n,component:"Column",children:e,...a!==void 0&&{weight:a},...o&&{alignment:o},...r&&{distribution:r}}}function G(e,t={}){let{id:n=p("list"),weight:a,direction:o,alignment:r}=t;return {id:n,component:"List",children:e,...a!==void 0&&{weight:a},...o&&{direction:o},...r&&{alignment:r}}}function W(e,t={}){let{id:n=p("card"),weight:a}=t;return {id:n,component:"Card",child:e,...a!==void 0&&{weight:a}}}function q(e,t={}){let{id:n=p("tabs"),weight:a}=t;return {id:n,component:"Tabs",tabItems:e.map(o=>({title:o.title,child:o.childId})),...a!==void 0&&{weight:a}}}function Y(e={}){let{id:t=p("divider"),weight:n,axis:a}=e;return {id:t,component:"Divider",...n!==void 0&&{weight:n},...a&&{axis:a}}}function X(e,t,n={}){let{id:a=p("modal"),weight:o}=n;return {id:a,component:"Modal",entryPointChild:e,contentChild:t,...o!==void 0&&{weight:o}}}function M(e,t,n={}){let{id:a=p("button"),weight:o,primary:r}=n;return {id:a,component:"Button",child:e,action:t,...o!==void 0&&{weight:o},...r!==void 0&&{primary:r}}}function z(e,t,n={}){let{id:a=p("checkbox"),weight:o}=n;return {id:a,component:"CheckBox",label:e,value:t,...o!==void 0&&{weight:o}}}function J(e,t,n={}){let{id:a=p("textfield"),weight:o,usageHint:r,validationRegexp:i}=n;return {id:a,component:"TextField",label:e,...t!==void 0&&{text:t},...o!==void 0&&{weight:o},...r&&{usageHint:r},...i&&{validationRegexp:i}}}function K(e,t={}){let{id:n=p("datetime"),weight:a,enableDate:o,enableTime:r,outputFormat:i,label:s}=t;return {id:n,component:"DateTimeInput",value:e,...a!==void 0&&{weight:a},...o!==void 0&&{enableDate:o},...r!==void 0&&{enableTime:r},...i&&{outputFormat:i},...s&&{label:s}}}function Q(e,t,n,a={}){let{id:o=p("choice"),weight:r,label:i}=a;return {id:o,component:"ChoicePicker",options:e,value:t,usageHint:n,...r!==void 0&&{weight:r},...i&&{label:i}}}function Z(e,t={}){let{id:n=p("slider"),weight:a,label:o,min:r,max:i}=t;return {id:n,component:"Slider",value:e,...a!==void 0&&{weight:a},...o&&{label:o},...r!==void 0&&{min:r},...i!==void 0&&{max:i}}}function ee(e,t,n={}){let a=n.textId??p("btn_text"),o=c(e,{id:a}),r=M(a,t,n);return [o,r]}function te(e,t={}){return c(e,{...t,usageHint:"h1"})}function ne(e,t={}){return c(e,{...t,usageHint:"h2"})}function oe(e,t={}){return c(e,{...t,usageHint:"h3"})}function ae(e,t={}){return c(e,{...t,usageHint:"h4"})}function re(e,t={}){return c(e,{...t,usageHint:"h5"})}function ie(e,t={}){return c(e,{...t,usageHint:"caption"})}function se(e,t={}){return c(e,{...t,usageHint:"body"})}function m(e,t=C){return {createSurface:{surfaceId:e,catalogId:t}}}function g(e,t){return {updateComponents:{surfaceId:e,components:t}}}function I(e,t,n,a="replace"){return {updateDataModel:{surfaceId:e,...n&&{path:n},op:a,...a!=="remove"&&{value:t}}}}function h(e){return {deleteSurface:{surfaceId:e}}}function pe(e){let{surfaceId:t,catalogId:n=C,components:a,dataModel:o}=e,r=[m(t,n),g(t,a)];return o&&r.push(I(t,o)),r}function ce(e){return e.map(t=>JSON.stringify(t)).join(`
+`)}function ue(e){return e.split(`
+`).filter(t=>t.trim()).map(t=>JSON.parse(t))}var T={};function de(e,t=""){let n=[];for(let[a,o]of Object.entries(e)){let r=t?`${t}/${a}`:`/${a}`;n.push(l(r,o));}return n}function l(e,t){if(t==null)return {key:e,valueString:""};if(typeof t=="string")return {key:e,valueString:t};if(typeof t=="number")return {key:e,valueNumber:t};if(typeof t=="boolean")return {key:e,valueBoolean:t};if(Array.isArray(t))return {key:e,valueMap:t.map((n,a)=>l(String(a),n))};if(typeof t=="object"){let n=[];for(let[a,o]of Object.entries(t))n.push(l(a,o));return {key:e,valueMap:n}}return {key:e,valueString:String(t)}}function y(e,t={}){let n=e.replace(/\./g,"/");n.startsWith("/")||(n=`/${n}`);for(let[a,o]of Object.entries(t)){let r=new RegExp(`^/${a}(/|$)`);r.test(n)&&(n=n.replace(r,`/${o}$1`));}return n}function le(e,t="",n=T){let a=[];for(let o of e){let r=o.path.startsWith("/")?o.path:`${t}/${o.path}`,i=y(r,n);if(o.value!==null&&typeof o.value=="object"&&!Array.isArray(o.value)){let s=x(o.value,i);a.push(...s);}else a.push(l(i,o.value));}return a}function x(e,t){let n=[];for(let[a,o]of Object.entries(e)){let r=`${t}/${a}`;if(o!==null&&typeof o=="object"&&!Array.isArray(o)){let i=x(o,r);n.push(...i);}else n.push(l(r,o));}return n}function V(e){let t={};for(let n of e){let a=n.key.startsWith("/")?n.key.slice(1):n.key;n.valueString!==void 0?t[a]=n.valueString:n.valueNumber!==void 0?t[a]=n.valueNumber:n.valueBoolean!==void 0?t[a]=n.valueBoolean:n.valueMap!==void 0&&(t[a]=V(n.valueMap));}return t}var Te=["Text","Image","Icon","Video","AudioPlayer","Row","Column","List","Card","Tabs","Divider","Modal","Button","CheckBox","TextField","DateTimeInput","ChoicePicker","Slider"];function D(e,t={}){let n=[],a=[];if("createSurface"in e){let{createSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"createSurface.surfaceId is required",path:"createSurface.surfaceId"}),o.catalogId||n.push({code:"MISSING_CATALOG_ID",message:"createSurface.catalogId is required",path:"createSurface.catalogId"});}else if("updateComponents"in e){let{updateComponents:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"updateComponents.surfaceId is required",path:"updateComponents.surfaceId"}),!o.components||!Array.isArray(o.components)?n.push({code:"INVALID_COMPONENTS",message:"updateComponents.components must be an array",path:"updateComponents.components"}):ye(o.components,n,a,t);}else if("updateDataModel"in e){let{updateDataModel:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"updateDataModel.surfaceId is required",path:"updateDataModel.surfaceId"});}else if("deleteSurface"in e){let{deleteSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"});}else n.push({code:"INVALID_MESSAGE_TYPE",message:"Message must contain one of: createSurface, updateComponents, updateDataModel, deleteSurface"});return {valid:n.length===0,errors:n,warnings:a}}function b(e,t={}){let n=[],a=[];if("beginRendering"in e){let{beginRendering:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"beginRendering.surfaceId is required",path:"beginRendering.surfaceId"}),o.root||n.push({code:"MISSING_ROOT",message:"beginRendering.root is required",path:"beginRendering.root"});}else if("surfaceUpdate"in e){let{surfaceUpdate:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"surfaceUpdate.surfaceId is required",path:"surfaceUpdate.surfaceId"}),!o.components||!Array.isArray(o.components)?n.push({code:"INVALID_COMPONENTS",message:"surfaceUpdate.components must be an array",path:"surfaceUpdate.components"}):Ve(o.components,n,a,t);}else if("dataModelUpdate"in e){let{dataModelUpdate:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"dataModelUpdate.surfaceId is required",path:"dataModelUpdate.surfaceId"}),(!o.contents||!Array.isArray(o.contents))&&n.push({code:"INVALID_CONTENTS",message:"dataModelUpdate.contents must be an array",path:"dataModelUpdate.contents"});}else if("deleteSurface"in e){let{deleteSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"});}else n.push({code:"INVALID_MESSAGE_TYPE",message:"Message must contain one of: beginRendering, surfaceUpdate, dataModelUpdate, deleteSurface"});return {valid:n.length===0,errors:n,warnings:a}}function A(e,t={}){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e?D(e,t):"beginRendering"in e||"surfaceUpdate"in e||"dataModelUpdate"in e?b(e,t):"deleteSurface"in e?e.deleteSurface.surfaceId?{valid:true,errors:[],warnings:[]}:{valid:false,errors:[{code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"}],warnings:[]}:{valid:false,errors:[{code:"UNKNOWN_MESSAGE_TYPE",message:"Unknown message type"}],warnings:[]}}function fe(e,t={}){let n=[],a=[];for(let o=0;o<e.length;o++){let r=e[o];if(!r)continue;let i=A(r,t);for(let s of i.errors)n.push({...s,path:`messages[${o}].${s.path??""}`});for(let s of i.warnings)a.push({...s,path:`messages[${o}].${s.path??""}`});}return {valid:n.length===0,errors:n,warnings:a}}function ye(e,t,n,a){let o=new Set,r=false;for(let i=0;i<e.length;i++){let s=e[i];if(!s)continue;let u=`updateComponents.components[${i}]`;s.id?(o.has(s.id)&&t.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${s.id}`,path:`${u}.id`}),o.add(s.id),s.id==="root"&&(r=true)):t.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${u}.id`}),s.component?a.strict&&a.allowedComponents&&(a.allowedComponents.includes(s.component)||n.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${s.component}`,path:`${u}.component`})):t.push({code:"MISSING_COMPONENT_TYPE",message:"Component type is required",path:`${u}.component`});}!r&&a.strict&&n.push({code:"MISSING_ROOT_COMPONENT",message:'No component with id "root" found',path:"updateComponents.components"});}function Ve(e,t,n,a){let o=new Set;for(let r=0;r<e.length;r++){let i=e[r];if(!i)continue;let s=`surfaceUpdate.components[${r}]`;if(i.id?(o.has(i.id)&&t.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${i.id}`,path:`${s}.id`}),o.add(i.id)):t.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${s}.id`}),!i.component||typeof i.component!="object")t.push({code:"MISSING_COMPONENT",message:"Component definition is required",path:`${s}.component`});else {let u=Object.keys(i.component)[0];u&&a.strict&&!Te.includes(u)&&n.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${u}`,path:`${s}.component`});}}}function P(e){return typeof e=="object"&&e!==null&&"path"in e}function De(e){if(!P(e))return e}function be(e){if(P(e))return e.path}function Ae(e){return {path:e}}function me(e,t){let n={...e};for(let a of Object.keys(t)){let o=t[a],r=n[a];o!==void 0&&typeof o=="object"&&o!==null&&!Array.isArray(o)&&typeof r=="object"&&r!==null&&!Array.isArray(r)?n[a]=me(r,o):o!==void 0&&(n[a]=o);}return n}function Pe(){return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{let t=Math.random()*16|0;return (e==="x"?t:t&3|8).toString(16)})}var d={CHAT:"@chat",RECOMMENDATION:"@recommendation",INPUT_FORM:"@input-form",ORCHESTRATION:"@orchestration",STATUS:"@status",RESULT:"@result",CONFIRM:"@confirm",NOTIFICATION:"@notification"},v=0;function S(e="surface"){return v++,`${e}-${Date.now()}-${v}`}function ge(){v=0;}function f(e,t,n){let a=n??S();return t.find(i=>i.id===e)||console.warn(`[A2UI] Root component "${e}" not found in components list`),{messages:[m(a),g(a,t)],surfaceId:a}}function Ce(e,t,n,a){let o=a??S();return {messages:[m(o),g(o,t),I(o,n)],surfaceId:o}}function Ie(e){return h(e)}function Se(e,t){return f(e,t,d.CHAT)}function he(e,t){return f(e,t,d.RECOMMENDATION)}function xe(e,t){return f(e,t,d.INPUT_FORM)}function Oe(e,t){return f(e,t,d.ORCHESTRATION)}function Me(e,t){return f(e,t,d.STATUS)}exports.A2UI_EXTENSION_URI=E;exports.A2UI_EXTENSION_URI_V08=_;exports.A2UI_MIME_TYPE=R;exports.DEFAULT_PATH_MAPPINGS=T;exports.STANDARD_CATALOG_ID=C;exports.SURFACE_IDS=d;exports.audioPlayer=$;exports.body=se;exports.button=M;exports.caption=ie;exports.card=W;exports.checkbox=z;exports.choicePicker=Q;exports.column=H;exports.createA2UISurface=f;exports.createA2UISurfaceWithData=Ce;exports.createChatSurface=Se;exports.createDeleteSurfaceMessage=Ie;exports.createInputFormSurface=xe;exports.createOrchestrationSurface=Oe;exports.createRecommendationSurface=he;exports.createStatusSurface=Me;exports.createSurface=m;exports.createV09Messages=pe;exports.dateTimeInput=K;exports.deepMerge=me;exports.deleteSurface=h;exports.divider=Y;exports.flattenObjectToValueMap=x;exports.generateId=p;exports.generateSurfaceId=S;exports.getIdCounter=k;exports.getLiteralValue=De;exports.getPathValue=be;exports.h1=te;exports.h2=ne;exports.h3=oe;exports.h4=ae;exports.h5=re;exports.icon=F;exports.image=j;exports.isPathBinding=P;exports.isV08Message=U;exports.isV09Message=N;exports.jsonlToMessages=ue;exports.list=G;exports.messagesToJsonl=ce;exports.modal=X;exports.normalizePath=y;exports.objectToValueMap=de;exports.path=Ae;exports.resetIdCounter=w;exports.resetSurfaceIdCounter=ge;exports.row=L;exports.slider=Z;exports.tabs=q;exports.text=c;exports.textButton=ee;exports.textField=J;exports.updateComponents=g;exports.updateDataModel=I;exports.updatesToValueMap=le;exports.uuid=Pe;exports.validateMessage=A;exports.validateMessages=fe;exports.validateV08Message=b;exports.validateV09Message=D;exports.valueMapToObject=V;exports.valueToValueMap=l;exports.video=B;

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 export { B as BooleanOrPath, d as BooleanValue, C as ContextValue, N as NumberOrPath, c as NumberValue, a as StringArrayOrPath, e as StringArrayValue, S as StringOrPath, b as StringValue } from './primitives-nmkVz-tB.cjs';
 export { A2UI_EXTENSION_URI, A2UI_EXTENSION_URI_V08, A2UI_MIME_TYPE, Action, ActionContextItem, ActionV08, AnyComponent, AudioPlayerComponent, BeginRenderingMessage, ButtonComponent, CardComponent, CheckBoxComponent, ChildrenProperty, ChoicePickerComponent, ClientToServerMessage, ColumnComponent, ComponentCommon, ComponentInstance, ComponentInstanceV08, ComponentType, CreateSurfaceMessage, DataArray, DataChangeEvent, DataModelUpdateMessage, DataObject, DataValue, DateTimeInputComponent, DeleteSurfaceMessage, DeleteSurfaceMessageV08, DividerComponent, IconComponent, ImageComponent, ListComponent, ModalComponent, RowComponent, STANDARD_CATALOG_ID, ServerToClientMessage, ServerToClientMessageV08, ServerToClientMessageV09, SliderComponent, StandardIconName, SurfaceUpdateMessage, TabsComponent, TextComponent, TextFieldComponent, Theme, UpdateComponentsMessage, UpdateDataModelMessage, UserActionEvent, ValueMap, VideoComponent, isV08Message, isV09Message } from './types/index.cjs';
-export { AudioPlayerOptions, ButtonOptions, CardOptions, CheckBoxOptions, ChoicePickerOptions, ComponentOptions, DEFAULT_PATH_MAPPINGS, DateTimeInputOptions, DividerOptions, IconOptions, ImageOptions, LayoutOptions, ListOptions, ModalOptions, PathMappings, SliderOptions, TabItem, TabsOptions, TextFieldOptions, TextOptions, UpdateDataItem, VideoOptions, audioPlayer, beginRendering, body, button, caption, card, checkbox, choicePicker, column, createSurface, createV08Messages, createV09Messages, dataModelInit, dataModelUpdate, dateTimeInput, deleteSurface, deleteSurfaceV08, divider, flattenObjectToValueMap, generateId, getIdCounter, h1, h2, h3, h4, h5, icon, image, jsonlToMessages, list, messagesToJsonl, modal, normalizePath, objectToValueMap, pathUpdate, resetIdCounter, row, slider, surfaceUpdate, tabs, text, textButton, textField, updateComponents, updateDataModel, updatesToValueMap, valueMapToObject, valueToValueMap, video } from './builders/index.cjs';
+export { AudioPlayerOptions, ButtonOptions, CardOptions, CheckBoxOptions, ChoicePickerOptions, ComponentOptions, DEFAULT_PATH_MAPPINGS, DateTimeInputOptions, DividerOptions, IconOptions, ImageOptions, LayoutOptions, ListOptions, ModalOptions, PathMappings, SliderOptions, TabItem, TabsOptions, TextFieldOptions, TextOptions, UpdateDataItem, VideoOptions, audioPlayer, body, button, caption, card, checkbox, choicePicker, column, createSurface, createV09Messages, dateTimeInput, deleteSurface, divider, flattenObjectToValueMap, generateId, getIdCounter, h1, h2, h3, h4, h5, icon, image, jsonlToMessages, list, messagesToJsonl, modal, normalizePath, objectToValueMap, resetIdCounter, row, slider, tabs, text, textButton, textField, updateComponents, updateDataModel, updatesToValueMap, valueMapToObject, valueToValueMap, video } from './builders/index.cjs';
 export { ValidationError, ValidationOptions, ValidationResult, ValidationWarning, validateMessage, validateMessages, validateV08Message, validateV09Message } from './validators/index.cjs';
 export { deepMerge, getLiteralValue, getPathValue, isPathBinding, path, uuid } from './utils/index.cjs';
+export { SURFACE_IDS, SurfaceConfig, SurfaceIdType, SurfaceResult, createA2UISurface, createA2UISurfaceWithData, createChatSurface, createDeleteSurfaceMessage, createInputFormSurface, createOrchestrationSurface, createRecommendationSurface, createStatusSurface, generateSurfaceId, resetSurfaceIdCounter } from './surface/index.cjs';

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { B as BooleanOrPath, d as BooleanValue, C as ContextValue, N as NumberOrPath, c as NumberValue, a as StringArrayOrPath, e as StringArrayValue, S as StringOrPath, b as StringValue } from './primitives-nmkVz-tB.js';
 export { A2UI_EXTENSION_URI, A2UI_EXTENSION_URI_V08, A2UI_MIME_TYPE, Action, ActionContextItem, ActionV08, AnyComponent, AudioPlayerComponent, BeginRenderingMessage, ButtonComponent, CardComponent, CheckBoxComponent, ChildrenProperty, ChoicePickerComponent, ClientToServerMessage, ColumnComponent, ComponentCommon, ComponentInstance, ComponentInstanceV08, ComponentType, CreateSurfaceMessage, DataArray, DataChangeEvent, DataModelUpdateMessage, DataObject, DataValue, DateTimeInputComponent, DeleteSurfaceMessage, DeleteSurfaceMessageV08, DividerComponent, IconComponent, ImageComponent, ListComponent, ModalComponent, RowComponent, STANDARD_CATALOG_ID, ServerToClientMessage, ServerToClientMessageV08, ServerToClientMessageV09, SliderComponent, StandardIconName, SurfaceUpdateMessage, TabsComponent, TextComponent, TextFieldComponent, Theme, UpdateComponentsMessage, UpdateDataModelMessage, UserActionEvent, ValueMap, VideoComponent, isV08Message, isV09Message } from './types/index.js';
-export { AudioPlayerOptions, ButtonOptions, CardOptions, CheckBoxOptions, ChoicePickerOptions, ComponentOptions, DEFAULT_PATH_MAPPINGS, DateTimeInputOptions, DividerOptions, IconOptions, ImageOptions, LayoutOptions, ListOptions, ModalOptions, PathMappings, SliderOptions, TabItem, TabsOptions, TextFieldOptions, TextOptions, UpdateDataItem, VideoOptions, audioPlayer, beginRendering, body, button, caption, card, checkbox, choicePicker, column, createSurface, createV08Messages, createV09Messages, dataModelInit, dataModelUpdate, dateTimeInput, deleteSurface, deleteSurfaceV08, divider, flattenObjectToValueMap, generateId, getIdCounter, h1, h2, h3, h4, h5, icon, image, jsonlToMessages, list, messagesToJsonl, modal, normalizePath, objectToValueMap, pathUpdate, resetIdCounter, row, slider, surfaceUpdate, tabs, text, textButton, textField, updateComponents, updateDataModel, updatesToValueMap, valueMapToObject, valueToValueMap, video } from './builders/index.js';
+export { AudioPlayerOptions, ButtonOptions, CardOptions, CheckBoxOptions, ChoicePickerOptions, ComponentOptions, DEFAULT_PATH_MAPPINGS, DateTimeInputOptions, DividerOptions, IconOptions, ImageOptions, LayoutOptions, ListOptions, ModalOptions, PathMappings, SliderOptions, TabItem, TabsOptions, TextFieldOptions, TextOptions, UpdateDataItem, VideoOptions, audioPlayer, body, button, caption, card, checkbox, choicePicker, column, createSurface, createV09Messages, dateTimeInput, deleteSurface, divider, flattenObjectToValueMap, generateId, getIdCounter, h1, h2, h3, h4, h5, icon, image, jsonlToMessages, list, messagesToJsonl, modal, normalizePath, objectToValueMap, resetIdCounter, row, slider, tabs, text, textButton, textField, updateComponents, updateDataModel, updatesToValueMap, valueMapToObject, valueToValueMap, video } from './builders/index.js';
 export { ValidationError, ValidationOptions, ValidationResult, ValidationWarning, validateMessage, validateMessages, validateV08Message, validateV09Message } from './validators/index.js';
 export { deepMerge, getLiteralValue, getPathValue, isPathBinding, path, uuid } from './utils/index.js';
+export { SURFACE_IDS, SurfaceConfig, SurfaceIdType, SurfaceResult, createA2UISurface, createA2UISurfaceWithData, createChatSurface, createDeleteSurfaceMessage, createInputFormSurface, createOrchestrationSurface, createRecommendationSurface, createStatusSurface, generateSurfaceId, resetSurfaceIdCounter } from './surface/index.js';

package/dist/index.js

@@ -1,3 +1,3 @@
-function U(e){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e}function N(e){return "beginRendering"in e||"surfaceUpdate"in e||"dataModelUpdate"in e}var l="https://a2ui.dev/specification/0.9/standard_catalog_definition.json",_="https://a2ui.org/a2a-extension/a2ui/v0.8",E="https://a2ui.dev/specification/0.9",R="application/json+a2ui";var f=0;function p(e="comp"){return `${e}_${Date.now()}_${f++}`}function w(){f=0;}function k(){return f}function d(e,t={}){let{id:n=p("text"),weight:a,usageHint:o}=t;return {id:n,component:"Text",text:e,...a!==void 0&&{weight:a},...o&&{usageHint:o}}}function j(e,t={}){let{id:n=p("image"),weight:a,fit:o,usageHint:r}=t;return {id:n,component:"Image",url:e,...a!==void 0&&{weight:a},...o&&{fit:o},...r&&{usageHint:r}}}function B(e,t={}){let{id:n=p("icon"),weight:a}=t;return {id:n,component:"Icon",name:e,...a!==void 0&&{weight:a}}}function L(e,t={}){let{id:n=p("video"),weight:a}=t;return {id:n,component:"Video",url:e,...a!==void 0&&{weight:a}}}function $(e,t={}){let{id:n=p("audio"),weight:a,description:o}=t;return {id:n,component:"AudioPlayer",url:e,...a!==void 0&&{weight:a},...o&&{description:o}}}function F(e,t={}){let{id:n=p("row"),weight:a,alignment:o,distribution:r}=t;return {id:n,component:"Row",children:e,...a!==void 0&&{weight:a},...o&&{alignment:o},...r&&{distribution:r}}}function G(e,t={}){let{id:n=p("column"),weight:a,alignment:o,distribution:r}=t;return {id:n,component:"Column",children:e,...a!==void 0&&{weight:a},...o&&{alignment:o},...r&&{distribution:r}}}function H(e,t={}){let{id:n=p("list"),weight:a,direction:o,alignment:r}=t;return {id:n,component:"List",children:e,...a!==void 0&&{weight:a},...o&&{direction:o},...r&&{alignment:r}}}function q(e,t={}){let{id:n=p("card"),weight:a}=t;return {id:n,component:"Card",child:e,...a!==void 0&&{weight:a}}}function W(e,t={}){let{id:n=p("tabs"),weight:a}=t;return {id:n,component:"Tabs",tabItems:e.map(o=>({title:o.title,child:o.childId})),...a!==void 0&&{weight:a}}}function Y(e={}){let{id:t=p("divider"),weight:n,axis:a}=e;return {id:t,component:"Divider",...n!==void 0&&{weight:n},...a&&{axis:a}}}function X(e,t,n={}){let{id:a=p("modal"),weight:o}=n;return {id:a,component:"Modal",entryPointChild:e,contentChild:t,...o!==void 0&&{weight:o}}}function C(e,t,n={}){let{id:a=p("button"),weight:o,primary:r}=n;return {id:a,component:"Button",child:e,action:t,...o!==void 0&&{weight:o},...r!==void 0&&{primary:r}}}function z(e,t,n={}){let{id:a=p("checkbox"),weight:o}=n;return {id:a,component:"CheckBox",label:e,value:t,...o!==void 0&&{weight:o}}}function J(e,t,n={}){let{id:a=p("textfield"),weight:o,usageHint:r,validationRegexp:i}=n;return {id:a,component:"TextField",label:e,...t!==void 0&&{text:t},...o!==void 0&&{weight:o},...r&&{usageHint:r},...i&&{validationRegexp:i}}}function K(e,t={}){let{id:n=p("datetime"),weight:a,enableDate:o,enableTime:r,outputFormat:i,label:s}=t;return {id:n,component:"DateTimeInput",value:e,...a!==void 0&&{weight:a},...o!==void 0&&{enableDate:o},...r!==void 0&&{enableTime:r},...i&&{outputFormat:i},...s&&{label:s}}}function Q(e,t,n,a={}){let{id:o=p("choice"),weight:r,label:i}=a;return {id:o,component:"ChoicePicker",options:e,value:t,usageHint:n,...r!==void 0&&{weight:r},...i&&{label:i}}}function Z(e,t={}){let{id:n=p("slider"),weight:a,label:o,min:r,max:i}=t;return {id:n,component:"Slider",value:e,...a!==void 0&&{weight:a},...o&&{label:o},...r!==void 0&&{min:r},...i!==void 0&&{max:i}}}function ee(e,t,n={}){let a=n.textId??p("btn_text"),o=d(e,{id:a}),r=C(a,t,n);return [o,r]}function te(e,t={}){return d(e,{...t,usageHint:"h1"})}function ne(e,t={}){return d(e,{...t,usageHint:"h2"})}function oe(e,t={}){return d(e,{...t,usageHint:"h3"})}function ae(e,t={}){return d(e,{...t,usageHint:"h4"})}function re(e,t={}){return d(e,{...t,usageHint:"h5"})}function ie(e,t={}){return d(e,{...t,usageHint:"caption"})}function se(e,t={}){return d(e,{...t,usageHint:"body"})}var M={};function g(e,t=""){let n=[];for(let[a,o]of Object.entries(e)){let r=t?`${t}/${a}`:`/${a}`;n.push(c(r,o));}return n}function c(e,t){if(t==null)return {key:e,valueString:""};if(typeof t=="string")return {key:e,valueString:t};if(typeof t=="number")return {key:e,valueNumber:t};if(typeof t=="boolean")return {key:e,valueBoolean:t};if(Array.isArray(t))return {key:e,valueMap:t.map((n,a)=>c(String(a),n))};if(typeof t=="object"){let n=[];for(let[a,o]of Object.entries(t))n.push(c(a,o));return {key:e,valueMap:n}}return {key:e,valueString:String(t)}}function I(e,t={}){let n=e.replace(/\./g,"/");n.startsWith("/")||(n=`/${n}`);for(let[a,o]of Object.entries(t)){let r=new RegExp(`^/${a}(/|$)`);r.test(n)&&(n=n.replace(r,`/${o}$1`));}return n}function pe(e,t="",n=M){let a=[];for(let o of e){let r=o.path.startsWith("/")?o.path:`${t}/${o.path}`,i=I(r,n);if(o.value!==null&&typeof o.value=="object"&&!Array.isArray(o.value)){let s=m(o.value,i);a.push(...s);}else a.push(c(i,o.value));}return a}function m(e,t){let n=[];for(let[a,o]of Object.entries(e)){let r=`${t}/${a}`;if(o!==null&&typeof o=="object"&&!Array.isArray(o)){let i=m(o,r);n.push(...i);}else n.push(c(r,o));}return n}function h(e){let t={};for(let n of e){let a=n.key.startsWith("/")?n.key.slice(1):n.key;n.valueString!==void 0?t[a]=n.valueString:n.valueNumber!==void 0?t[a]=n.valueNumber:n.valueBoolean!==void 0?t[a]=n.valueBoolean:n.valueMap!==void 0&&(t[a]=h(n.valueMap));}return t}function x(e,t=l){return {createSurface:{surfaceId:e,catalogId:t}}}function O(e,t){return {updateComponents:{surfaceId:e,components:t}}}function S(e,t,n,a="replace"){return {updateDataModel:{surfaceId:e,...n&&{path:n},op:a,...a!=="remove"&&{value:t}}}}function de(e){return {deleteSurface:{surfaceId:e}}}function ce(e){let{surfaceId:t,catalogId:n=l,components:a,dataModel:o}=e,r=[x(t,n),O(t,a)];return o&&r.push(S(t,o)),r}function T(e,t="@default",n){return {beginRendering:{surfaceId:t,root:e,...n&&{styles:n}}}}function y(e,t="@default"){return {surfaceUpdate:{surfaceId:t,components:e}}}function V(e,t="@default",n){return {dataModelUpdate:{surfaceId:t,contents:e,...n&&{path:n}}}}function D(e,t="@default"){return V(g(e),t)}function ue(e,t,n="@default"){return {dataModelUpdate:{surfaceId:n,path:e,contents:[c("",t)]}}}function le(e){return {deleteSurface:{surfaceId:e}}}function ge(e){let{rootId:t,components:n,dataModel:a,surfaceId:o="@default",styles:r}=e,i=[y(n,o)];return a&&i.push(D(a,o)),i.push(T(t,o,r)),i}function me(e){return e.map(t=>JSON.stringify(t)).join(`
-`)}function fe(e){return e.split(`
-`).filter(t=>t.trim()).map(t=>JSON.parse(t))}var Ie=["Text","Image","Icon","Video","AudioPlayer","Row","Column","List","Card","Tabs","Divider","Modal","Button","CheckBox","TextField","DateTimeInput","ChoicePicker","Slider"];function b(e,t={}){let n=[],a=[];if("createSurface"in e){let{createSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"createSurface.surfaceId is required",path:"createSurface.surfaceId"}),o.catalogId||n.push({code:"MISSING_CATALOG_ID",message:"createSurface.catalogId is required",path:"createSurface.catalogId"});}else if("updateComponents"in e){let{updateComponents:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"updateComponents.surfaceId is required",path:"updateComponents.surfaceId"}),!o.components||!Array.isArray(o.components)?n.push({code:"INVALID_COMPONENTS",message:"updateComponents.components must be an array",path:"updateComponents.components"}):he(o.components,n,a,t);}else if("updateDataModel"in e){let{updateDataModel:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"updateDataModel.surfaceId is required",path:"updateDataModel.surfaceId"});}else if("deleteSurface"in e){let{deleteSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"});}else n.push({code:"INVALID_MESSAGE_TYPE",message:"Message must contain one of: createSurface, updateComponents, updateDataModel, deleteSurface"});return {valid:n.length===0,errors:n,warnings:a}}function P(e,t={}){let n=[],a=[];if("beginRendering"in e){let{beginRendering:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"beginRendering.surfaceId is required",path:"beginRendering.surfaceId"}),o.root||n.push({code:"MISSING_ROOT",message:"beginRendering.root is required",path:"beginRendering.root"});}else if("surfaceUpdate"in e){let{surfaceUpdate:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"surfaceUpdate.surfaceId is required",path:"surfaceUpdate.surfaceId"}),!o.components||!Array.isArray(o.components)?n.push({code:"INVALID_COMPONENTS",message:"surfaceUpdate.components must be an array",path:"surfaceUpdate.components"}):xe(o.components,n,a,t);}else if("dataModelUpdate"in e){let{dataModelUpdate:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"dataModelUpdate.surfaceId is required",path:"dataModelUpdate.surfaceId"}),(!o.contents||!Array.isArray(o.contents))&&n.push({code:"INVALID_CONTENTS",message:"dataModelUpdate.contents must be an array",path:"dataModelUpdate.contents"});}else if("deleteSurface"in e){let{deleteSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"});}else n.push({code:"INVALID_MESSAGE_TYPE",message:"Message must contain one of: beginRendering, surfaceUpdate, dataModelUpdate, deleteSurface"});return {valid:n.length===0,errors:n,warnings:a}}function v(e,t={}){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e?b(e,t):"beginRendering"in e||"surfaceUpdate"in e||"dataModelUpdate"in e?P(e,t):"deleteSurface"in e?e.deleteSurface.surfaceId?{valid:true,errors:[],warnings:[]}:{valid:false,errors:[{code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"}],warnings:[]}:{valid:false,errors:[{code:"UNKNOWN_MESSAGE_TYPE",message:"Unknown message type"}],warnings:[]}}function Ce(e,t={}){let n=[],a=[];for(let o=0;o<e.length;o++){let r=e[o];if(!r)continue;let i=v(r,t);for(let s of i.errors)n.push({...s,path:`messages[${o}].${s.path??""}`});for(let s of i.warnings)a.push({...s,path:`messages[${o}].${s.path??""}`});}return {valid:n.length===0,errors:n,warnings:a}}function he(e,t,n,a){let o=new Set,r=false;for(let i=0;i<e.length;i++){let s=e[i];if(!s)continue;let u=`updateComponents.components[${i}]`;s.id?(o.has(s.id)&&t.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${s.id}`,path:`${u}.id`}),o.add(s.id),s.id==="root"&&(r=true)):t.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${u}.id`}),s.component?a.strict&&a.allowedComponents&&(a.allowedComponents.includes(s.component)||n.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${s.component}`,path:`${u}.component`})):t.push({code:"MISSING_COMPONENT_TYPE",message:"Component type is required",path:`${u}.component`});}!r&&a.strict&&n.push({code:"MISSING_ROOT_COMPONENT",message:'No component with id "root" found',path:"updateComponents.components"});}function xe(e,t,n,a){let o=new Set;for(let r=0;r<e.length;r++){let i=e[r];if(!i)continue;let s=`surfaceUpdate.components[${r}]`;if(i.id?(o.has(i.id)&&t.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${i.id}`,path:`${s}.id`}),o.add(i.id)):t.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${s}.id`}),!i.component||typeof i.component!="object")t.push({code:"MISSING_COMPONENT",message:"Component definition is required",path:`${s}.component`});else {let u=Object.keys(i.component)[0];u&&a.strict&&!Ie.includes(u)&&n.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${u}`,path:`${s}.component`});}}}function A(e){return typeof e=="object"&&e!==null&&"path"in e}function Oe(e){if(!A(e))return e}function Se(e){if(A(e))return e.path}function Te(e){return {path:e}}function Me(e,t){let n={...e};for(let a of Object.keys(t)){let o=t[a],r=n[a];o!==void 0&&typeof o=="object"&&o!==null&&!Array.isArray(o)&&typeof r=="object"&&r!==null&&!Array.isArray(r)?n[a]=Me(r,o):o!==void 0&&(n[a]=o);}return n}function ye(){return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{let t=Math.random()*16|0;return (e==="x"?t:t&3|8).toString(16)})}export{E as A2UI_EXTENSION_URI,_ as A2UI_EXTENSION_URI_V08,R as A2UI_MIME_TYPE,M as DEFAULT_PATH_MAPPINGS,l as STANDARD_CATALOG_ID,$ as audioPlayer,T as beginRendering,se as body,C as button,ie as caption,q as card,z as checkbox,Q as choicePicker,G as column,x as createSurface,ge as createV08Messages,ce as createV09Messages,D as dataModelInit,V as dataModelUpdate,K as dateTimeInput,Me as deepMerge,de as deleteSurface,le as deleteSurfaceV08,Y as divider,m as flattenObjectToValueMap,p as generateId,k as getIdCounter,Oe as getLiteralValue,Se as getPathValue,te as h1,ne as h2,oe as h3,ae as h4,re as h5,B as icon,j as image,A as isPathBinding,N as isV08Message,U as isV09Message,fe as jsonlToMessages,H as list,me as messagesToJsonl,X as modal,I as normalizePath,g as objectToValueMap,Te as path,ue as pathUpdate,w as resetIdCounter,F as row,Z as slider,y as surfaceUpdate,W as tabs,d as text,ee as textButton,J as textField,O as updateComponents,S as updateDataModel,pe as updatesToValueMap,ye as uuid,v as validateMessage,Ce as validateMessages,P as validateV08Message,b as validateV09Message,h as valueMapToObject,c as valueToValueMap,L as video};
+function N(e){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e}function U(e){return "beginRendering"in e||"surfaceUpdate"in e||"dataModelUpdate"in e}var C="https://a2ui.dev/specification/0.9/standard_catalog_definition.json",_="https://a2ui.org/a2a-extension/a2ui/v0.8",E="https://a2ui.dev/specification/0.9",R="application/json+a2ui";var O=0;function p(e="comp"){return `${e}_${Date.now()}_${O++}`}function w(){O=0;}function k(){return O}function c(e,t={}){let{id:n=p("text"),weight:a,usageHint:o}=t;return {id:n,component:"Text",text:e,...a!==void 0&&{weight:a},...o&&{usageHint:o}}}function j(e,t={}){let{id:n=p("image"),weight:a,fit:o,usageHint:r}=t;return {id:n,component:"Image",url:e,...a!==void 0&&{weight:a},...o&&{fit:o},...r&&{usageHint:r}}}function F(e,t={}){let{id:n=p("icon"),weight:a}=t;return {id:n,component:"Icon",name:e,...a!==void 0&&{weight:a}}}function B(e,t={}){let{id:n=p("video"),weight:a}=t;return {id:n,component:"Video",url:e,...a!==void 0&&{weight:a}}}function $(e,t={}){let{id:n=p("audio"),weight:a,description:o}=t;return {id:n,component:"AudioPlayer",url:e,...a!==void 0&&{weight:a},...o&&{description:o}}}function L(e,t={}){let{id:n=p("row"),weight:a,alignment:o,distribution:r}=t;return {id:n,component:"Row",children:e,...a!==void 0&&{weight:a},...o&&{alignment:o},...r&&{distribution:r}}}function H(e,t={}){let{id:n=p("column"),weight:a,alignment:o,distribution:r}=t;return {id:n,component:"Column",children:e,...a!==void 0&&{weight:a},...o&&{alignment:o},...r&&{distribution:r}}}function G(e,t={}){let{id:n=p("list"),weight:a,direction:o,alignment:r}=t;return {id:n,component:"List",children:e,...a!==void 0&&{weight:a},...o&&{direction:o},...r&&{alignment:r}}}function W(e,t={}){let{id:n=p("card"),weight:a}=t;return {id:n,component:"Card",child:e,...a!==void 0&&{weight:a}}}function q(e,t={}){let{id:n=p("tabs"),weight:a}=t;return {id:n,component:"Tabs",tabItems:e.map(o=>({title:o.title,child:o.childId})),...a!==void 0&&{weight:a}}}function Y(e={}){let{id:t=p("divider"),weight:n,axis:a}=e;return {id:t,component:"Divider",...n!==void 0&&{weight:n},...a&&{axis:a}}}function X(e,t,n={}){let{id:a=p("modal"),weight:o}=n;return {id:a,component:"Modal",entryPointChild:e,contentChild:t,...o!==void 0&&{weight:o}}}function M(e,t,n={}){let{id:a=p("button"),weight:o,primary:r}=n;return {id:a,component:"Button",child:e,action:t,...o!==void 0&&{weight:o},...r!==void 0&&{primary:r}}}function z(e,t,n={}){let{id:a=p("checkbox"),weight:o}=n;return {id:a,component:"CheckBox",label:e,value:t,...o!==void 0&&{weight:o}}}function J(e,t,n={}){let{id:a=p("textfield"),weight:o,usageHint:r,validationRegexp:i}=n;return {id:a,component:"TextField",label:e,...t!==void 0&&{text:t},...o!==void 0&&{weight:o},...r&&{usageHint:r},...i&&{validationRegexp:i}}}function K(e,t={}){let{id:n=p("datetime"),weight:a,enableDate:o,enableTime:r,outputFormat:i,label:s}=t;return {id:n,component:"DateTimeInput",value:e,...a!==void 0&&{weight:a},...o!==void 0&&{enableDate:o},...r!==void 0&&{enableTime:r},...i&&{outputFormat:i},...s&&{label:s}}}function Q(e,t,n,a={}){let{id:o=p("choice"),weight:r,label:i}=a;return {id:o,component:"ChoicePicker",options:e,value:t,usageHint:n,...r!==void 0&&{weight:r},...i&&{label:i}}}function Z(e,t={}){let{id:n=p("slider"),weight:a,label:o,min:r,max:i}=t;return {id:n,component:"Slider",value:e,...a!==void 0&&{weight:a},...o&&{label:o},...r!==void 0&&{min:r},...i!==void 0&&{max:i}}}function ee(e,t,n={}){let a=n.textId??p("btn_text"),o=c(e,{id:a}),r=M(a,t,n);return [o,r]}function te(e,t={}){return c(e,{...t,usageHint:"h1"})}function ne(e,t={}){return c(e,{...t,usageHint:"h2"})}function oe(e,t={}){return c(e,{...t,usageHint:"h3"})}function ae(e,t={}){return c(e,{...t,usageHint:"h4"})}function re(e,t={}){return c(e,{...t,usageHint:"h5"})}function ie(e,t={}){return c(e,{...t,usageHint:"caption"})}function se(e,t={}){return c(e,{...t,usageHint:"body"})}function m(e,t=C){return {createSurface:{surfaceId:e,catalogId:t}}}function g(e,t){return {updateComponents:{surfaceId:e,components:t}}}function I(e,t,n,a="replace"){return {updateDataModel:{surfaceId:e,...n&&{path:n},op:a,...a!=="remove"&&{value:t}}}}function h(e){return {deleteSurface:{surfaceId:e}}}function pe(e){let{surfaceId:t,catalogId:n=C,components:a,dataModel:o}=e,r=[m(t,n),g(t,a)];return o&&r.push(I(t,o)),r}function ce(e){return e.map(t=>JSON.stringify(t)).join(`
+`)}function ue(e){return e.split(`
+`).filter(t=>t.trim()).map(t=>JSON.parse(t))}var T={};function de(e,t=""){let n=[];for(let[a,o]of Object.entries(e)){let r=t?`${t}/${a}`:`/${a}`;n.push(l(r,o));}return n}function l(e,t){if(t==null)return {key:e,valueString:""};if(typeof t=="string")return {key:e,valueString:t};if(typeof t=="number")return {key:e,valueNumber:t};if(typeof t=="boolean")return {key:e,valueBoolean:t};if(Array.isArray(t))return {key:e,valueMap:t.map((n,a)=>l(String(a),n))};if(typeof t=="object"){let n=[];for(let[a,o]of Object.entries(t))n.push(l(a,o));return {key:e,valueMap:n}}return {key:e,valueString:String(t)}}function y(e,t={}){let n=e.replace(/\./g,"/");n.startsWith("/")||(n=`/${n}`);for(let[a,o]of Object.entries(t)){let r=new RegExp(`^/${a}(/|$)`);r.test(n)&&(n=n.replace(r,`/${o}$1`));}return n}function le(e,t="",n=T){let a=[];for(let o of e){let r=o.path.startsWith("/")?o.path:`${t}/${o.path}`,i=y(r,n);if(o.value!==null&&typeof o.value=="object"&&!Array.isArray(o.value)){let s=x(o.value,i);a.push(...s);}else a.push(l(i,o.value));}return a}function x(e,t){let n=[];for(let[a,o]of Object.entries(e)){let r=`${t}/${a}`;if(o!==null&&typeof o=="object"&&!Array.isArray(o)){let i=x(o,r);n.push(...i);}else n.push(l(r,o));}return n}function V(e){let t={};for(let n of e){let a=n.key.startsWith("/")?n.key.slice(1):n.key;n.valueString!==void 0?t[a]=n.valueString:n.valueNumber!==void 0?t[a]=n.valueNumber:n.valueBoolean!==void 0?t[a]=n.valueBoolean:n.valueMap!==void 0&&(t[a]=V(n.valueMap));}return t}var Te=["Text","Image","Icon","Video","AudioPlayer","Row","Column","List","Card","Tabs","Divider","Modal","Button","CheckBox","TextField","DateTimeInput","ChoicePicker","Slider"];function D(e,t={}){let n=[],a=[];if("createSurface"in e){let{createSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"createSurface.surfaceId is required",path:"createSurface.surfaceId"}),o.catalogId||n.push({code:"MISSING_CATALOG_ID",message:"createSurface.catalogId is required",path:"createSurface.catalogId"});}else if("updateComponents"in e){let{updateComponents:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"updateComponents.surfaceId is required",path:"updateComponents.surfaceId"}),!o.components||!Array.isArray(o.components)?n.push({code:"INVALID_COMPONENTS",message:"updateComponents.components must be an array",path:"updateComponents.components"}):ye(o.components,n,a,t);}else if("updateDataModel"in e){let{updateDataModel:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"updateDataModel.surfaceId is required",path:"updateDataModel.surfaceId"});}else if("deleteSurface"in e){let{deleteSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"});}else n.push({code:"INVALID_MESSAGE_TYPE",message:"Message must contain one of: createSurface, updateComponents, updateDataModel, deleteSurface"});return {valid:n.length===0,errors:n,warnings:a}}function b(e,t={}){let n=[],a=[];if("beginRendering"in e){let{beginRendering:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"beginRendering.surfaceId is required",path:"beginRendering.surfaceId"}),o.root||n.push({code:"MISSING_ROOT",message:"beginRendering.root is required",path:"beginRendering.root"});}else if("surfaceUpdate"in e){let{surfaceUpdate:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"surfaceUpdate.surfaceId is required",path:"surfaceUpdate.surfaceId"}),!o.components||!Array.isArray(o.components)?n.push({code:"INVALID_COMPONENTS",message:"surfaceUpdate.components must be an array",path:"surfaceUpdate.components"}):Ve(o.components,n,a,t);}else if("dataModelUpdate"in e){let{dataModelUpdate:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"dataModelUpdate.surfaceId is required",path:"dataModelUpdate.surfaceId"}),(!o.contents||!Array.isArray(o.contents))&&n.push({code:"INVALID_CONTENTS",message:"dataModelUpdate.contents must be an array",path:"dataModelUpdate.contents"});}else if("deleteSurface"in e){let{deleteSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"});}else n.push({code:"INVALID_MESSAGE_TYPE",message:"Message must contain one of: beginRendering, surfaceUpdate, dataModelUpdate, deleteSurface"});return {valid:n.length===0,errors:n,warnings:a}}function A(e,t={}){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e?D(e,t):"beginRendering"in e||"surfaceUpdate"in e||"dataModelUpdate"in e?b(e,t):"deleteSurface"in e?e.deleteSurface.surfaceId?{valid:true,errors:[],warnings:[]}:{valid:false,errors:[{code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"}],warnings:[]}:{valid:false,errors:[{code:"UNKNOWN_MESSAGE_TYPE",message:"Unknown message type"}],warnings:[]}}function fe(e,t={}){let n=[],a=[];for(let o=0;o<e.length;o++){let r=e[o];if(!r)continue;let i=A(r,t);for(let s of i.errors)n.push({...s,path:`messages[${o}].${s.path??""}`});for(let s of i.warnings)a.push({...s,path:`messages[${o}].${s.path??""}`});}return {valid:n.length===0,errors:n,warnings:a}}function ye(e,t,n,a){let o=new Set,r=false;for(let i=0;i<e.length;i++){let s=e[i];if(!s)continue;let u=`updateComponents.components[${i}]`;s.id?(o.has(s.id)&&t.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${s.id}`,path:`${u}.id`}),o.add(s.id),s.id==="root"&&(r=true)):t.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${u}.id`}),s.component?a.strict&&a.allowedComponents&&(a.allowedComponents.includes(s.component)||n.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${s.component}`,path:`${u}.component`})):t.push({code:"MISSING_COMPONENT_TYPE",message:"Component type is required",path:`${u}.component`});}!r&&a.strict&&n.push({code:"MISSING_ROOT_COMPONENT",message:'No component with id "root" found',path:"updateComponents.components"});}function Ve(e,t,n,a){let o=new Set;for(let r=0;r<e.length;r++){let i=e[r];if(!i)continue;let s=`surfaceUpdate.components[${r}]`;if(i.id?(o.has(i.id)&&t.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${i.id}`,path:`${s}.id`}),o.add(i.id)):t.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${s}.id`}),!i.component||typeof i.component!="object")t.push({code:"MISSING_COMPONENT",message:"Component definition is required",path:`${s}.component`});else {let u=Object.keys(i.component)[0];u&&a.strict&&!Te.includes(u)&&n.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${u}`,path:`${s}.component`});}}}function P(e){return typeof e=="object"&&e!==null&&"path"in e}function De(e){if(!P(e))return e}function be(e){if(P(e))return e.path}function Ae(e){return {path:e}}function me(e,t){let n={...e};for(let a of Object.keys(t)){let o=t[a],r=n[a];o!==void 0&&typeof o=="object"&&o!==null&&!Array.isArray(o)&&typeof r=="object"&&r!==null&&!Array.isArray(r)?n[a]=me(r,o):o!==void 0&&(n[a]=o);}return n}function Pe(){return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{let t=Math.random()*16|0;return (e==="x"?t:t&3|8).toString(16)})}var d={CHAT:"@chat",RECOMMENDATION:"@recommendation",INPUT_FORM:"@input-form",ORCHESTRATION:"@orchestration",STATUS:"@status",RESULT:"@result",CONFIRM:"@confirm",NOTIFICATION:"@notification"},v=0;function S(e="surface"){return v++,`${e}-${Date.now()}-${v}`}function ge(){v=0;}function f(e,t,n){let a=n??S();return t.find(i=>i.id===e)||console.warn(`[A2UI] Root component "${e}" not found in components list`),{messages:[m(a),g(a,t)],surfaceId:a}}function Ce(e,t,n,a){let o=a??S();return {messages:[m(o),g(o,t),I(o,n)],surfaceId:o}}function Ie(e){return h(e)}function Se(e,t){return f(e,t,d.CHAT)}function he(e,t){return f(e,t,d.RECOMMENDATION)}function xe(e,t){return f(e,t,d.INPUT_FORM)}function Oe(e,t){return f(e,t,d.ORCHESTRATION)}function Me(e,t){return f(e,t,d.STATUS)}export{E as A2UI_EXTENSION_URI,_ as A2UI_EXTENSION_URI_V08,R as A2UI_MIME_TYPE,T as DEFAULT_PATH_MAPPINGS,C as STANDARD_CATALOG_ID,d as SURFACE_IDS,$ as audioPlayer,se as body,M as button,ie as caption,W as card,z as checkbox,Q as choicePicker,H as column,f as createA2UISurface,Ce as createA2UISurfaceWithData,Se as createChatSurface,Ie as createDeleteSurfaceMessage,xe as createInputFormSurface,Oe as createOrchestrationSurface,he as createRecommendationSurface,Me as createStatusSurface,m as createSurface,pe as createV09Messages,K as dateTimeInput,me as deepMerge,h as deleteSurface,Y as divider,x as flattenObjectToValueMap,p as generateId,S as generateSurfaceId,k as getIdCounter,De as getLiteralValue,be as getPathValue,te as h1,ne as h2,oe as h3,ae as h4,re as h5,F as icon,j as image,P as isPathBinding,U as isV08Message,N as isV09Message,ue as jsonlToMessages,G as list,ce as messagesToJsonl,X as modal,y as normalizePath,de as objectToValueMap,Ae as path,w as resetIdCounter,ge as resetSurfaceIdCounter,L as row,Z as slider,q as tabs,c as text,ee as textButton,J as textField,g as updateComponents,I as updateDataModel,le as updatesToValueMap,Pe as uuid,A as validateMessage,fe as validateMessages,b as validateV08Message,D as validateV09Message,V as valueMapToObject,l as valueToValueMap,B as video};

package/dist/surface/index.cjs

@@ -0,0 +1,2 @@
+'use strict';var a={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 S(){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,r,n="replace"){return {updateDataModel:{surfaceId:e,...r,op:n,...n!=="remove"&&{value:t}}}}function d(e){return {deleteSurface:{surfaceId:e}}}function o(e,t,r){let n=r??i();return t.find(l=>l.id===e)||console.warn(`[A2UI] Root component "${e}" not found in components list`),{messages:[u(n),g(n,t)],surfaceId:n}}function C(e,t,r,n){let s=n??i();return {messages:[u(s),g(s,t),f(s,r)],surfaceId:s}}function M(e){return d(e)}function I(e,t){return o(e,t,a.CHAT)}function T(e,t){return o(e,t,a.RECOMMENDATION)}function D(e,t){return o(e,t,a.INPUT_FORM)}function x(e,t){return o(e,t,a.ORCHESTRATION)}function A(e,t){return o(e,t,a.STATUS)}
+exports.SURFACE_IDS=a;exports.createA2UISurface=o;exports.createA2UISurfaceWithData=C;exports.createChatSurface=I;exports.createDeleteSurfaceMessage=M;exports.createInputFormSurface=D;exports.createOrchestrationSurface=x;exports.createRecommendationSurface=T;exports.createStatusSurface=A;exports.generateSurfaceId=i;exports.resetSurfaceIdCounter=S;

package/dist/surface/index.d.cts

@@ -0,0 +1,165 @@
+import { ServerToClientMessageV09, ComponentInstance, DataObject } from '../types/index.cjs';
+import '../primitives-nmkVz-tB.cjs';
+
+/**
+ * Surface IDs and Configuration
+ *
+ * 预定义的 Surface ID 常量和配置
+ * 前端根据这些 ID 决定渲染位置和样式
+ */
+/**
+ * 标准 Surface ID 常量
+ *
+ * 前端可以根据这些 ID 决定：
+ * - 渲染位置（聊天区、侧边栏、模态框等）
+ * - 渲染样式（卡片、全屏、浮动等）
+ * - 交互行为（自动消失、持久化等）
+ *
+ * @example
+ * ```typescript
+ * import { SURFACE_IDS, createA2UISurface } from '@zhama/a2ui-core';
+ *
+ * const surface = createA2UISurface('root', components, SURFACE_IDS.CHAT);
+ * ```
+ */
+declare const SURFACE_IDS: {
+    /** 聊天内容区 - 普通对话消息 */
+    readonly CHAT: "@chat";
+    /** 智能体推荐区 - 展示推荐的智能体列表 */
+    readonly RECOMMENDATION: "@recommendation";
+    /** 输入收集表单 - 收集用户输入 */
+    readonly INPUT_FORM: "@input-form";
+    /** 编排面板 - 多智能体编排状态 */
+    readonly ORCHESTRATION: "@orchestration";
+    /** 临时状态提示 - loading/thinking/error 等 */
+    readonly STATUS: "@status";
+    /** 结果展示区 - 智能体执行结果 */
+    readonly RESULT: "@result";
+    /** 确认对话框 - 需要用户确认的操作 */
+    readonly CONFIRM: "@confirm";
+    /** 通知区 - 系统通知 */
+    readonly NOTIFICATION: "@notification";
+};
+/**
+ * Surface ID 类型
+ */
+type SurfaceIdType = (typeof SURFACE_IDS)[keyof typeof SURFACE_IDS];
+/**
+ * Surface 配置
+ */
+interface SurfaceConfig {
+    /** Surface ID */
+    id: SurfaceIdType | string;
+    /** 是否自动消失 */
+    autoHide?: boolean;
+    /** 自动消失延迟（毫秒） */
+    autoHideDelay?: number;
+    /** 是否可关闭 */
+    closable?: boolean;
+    /** 优先级（数字越大越优先显示） */
+    priority?: number;
+}
+/**
+ * 生成唯一的 Surface ID
+ *
+ * @param prefix - ID 前缀
+ * @returns 唯一的 Surface ID
+ *
+ * @example
+ * ```typescript
+ * const id = generateSurfaceId('status'); // 'status-1703123456789-1'
+ * ```
+ */
+declare function generateSurfaceId(prefix?: string): string;
+/**
+ * 重置 Surface ID 计数器
+ * 主要用于测试
+ */
+declare function resetSurfaceIdCounter(): void;
+
+/**
+ * Surface Builder
+ *
+ * 提供 A2UI Surface 的构建工具函数
+ * 基于 v0.9 格式
+ *
+ * 参考：https://a2ui.org/
+ */
+
+/**
+ * Surface 构建结果
+ */
+interface SurfaceResult {
+    /** 构建的消息数组 */
+    messages: ServerToClientMessageV09[];
+    /** Surface ID */
+    surfaceId: string;
+}
+/**
+ * 创建 A2UI Surface 消息
+ *
+ * @param rootId - 根组件 ID
+ * @param components - 组件列表（v0.9 格式）
+ * @param surfaceId - Surface ID（可选，自动生成）
+ * @returns Surface 构建结果
+ *
+ * @example
+ * ```typescript
+ * import { createA2UISurface, h1, column, SURFACE_IDS } from '@zhama/a2ui-core';
+ *
+ * const title = h1('Hello', { id: 'title' });
+ * const root = column(['title'], { id: 'root' });
+ *
+ * const { messages, surfaceId } = createA2UISurface('root', [title, root], SURFACE_IDS.CHAT);
+ * ```
+ */
+declare function createA2UISurface(rootId: string, components: ComponentInstance[], surfaceId?: string): SurfaceResult;
+/**
+ * 创建带数据模型的 A2UI Surface
+ *
+ * @param rootId - 根组件 ID
+ * @param components - 组件列表（v0.9 格式）
+ * @param dataModel - 数据模型对象
+ * @param surfaceId - Surface ID（可选）
+ * @returns Surface 构建结果
+ *
+ * @example
+ * ```typescript
+ * const { messages } = createA2UISurfaceWithData(
+ *   'root',
+ *   [title, greeting, root],
+ *   { user: { name: 'John' } },
+ *   SURFACE_IDS.CHAT
+ * );
+ * ```
+ */
+declare function createA2UISurfaceWithData(rootId: string, components: ComponentInstance[], dataModel: DataObject, surfaceId?: string): SurfaceResult;
+/**
+ * 创建删除 Surface 的消息
+ *
+ * @param surfaceId - 要删除的 Surface ID
+ * @returns 删除消息
+ */
+declare function createDeleteSurfaceMessage(surfaceId: string): ServerToClientMessageV09;
+/**
+ * 创建聊天区 Surface
+ */
+declare function createChatSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+/**
+ * 创建智能体推荐区 Surface
+ */
+declare function createRecommendationSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+/**
+ * 创建输入表单区 Surface
+ */
+declare function createInputFormSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+/**
+ * 创建编排面板 Surface
+ */
+declare function createOrchestrationSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+/**
+ * 创建状态提示 Surface
+ */
+declare function createStatusSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+
+export { SURFACE_IDS, type SurfaceConfig, type SurfaceIdType, type SurfaceResult, createA2UISurface, createA2UISurfaceWithData, createChatSurface, createDeleteSurfaceMessage, createInputFormSurface, createOrchestrationSurface, createRecommendationSurface, createStatusSurface, generateSurfaceId, resetSurfaceIdCounter };

package/dist/surface/index.d.ts

@@ -0,0 +1,165 @@
+import { ServerToClientMessageV09, ComponentInstance, DataObject } from '../types/index.js';
+import '../primitives-nmkVz-tB.js';
+
+/**
+ * Surface IDs and Configuration
+ *
+ * 预定义的 Surface ID 常量和配置
+ * 前端根据这些 ID 决定渲染位置和样式
+ */
+/**
+ * 标准 Surface ID 常量
+ *
+ * 前端可以根据这些 ID 决定：
+ * - 渲染位置（聊天区、侧边栏、模态框等）
+ * - 渲染样式（卡片、全屏、浮动等）
+ * - 交互行为（自动消失、持久化等）
+ *
+ * @example
+ * ```typescript
+ * import { SURFACE_IDS, createA2UISurface } from '@zhama/a2ui-core';
+ *
+ * const surface = createA2UISurface('root', components, SURFACE_IDS.CHAT);
+ * ```
+ */
+declare const SURFACE_IDS: {
+    /** 聊天内容区 - 普通对话消息 */
+    readonly CHAT: "@chat";
+    /** 智能体推荐区 - 展示推荐的智能体列表 */
+    readonly RECOMMENDATION: "@recommendation";
+    /** 输入收集表单 - 收集用户输入 */
+    readonly INPUT_FORM: "@input-form";
+    /** 编排面板 - 多智能体编排状态 */
+    readonly ORCHESTRATION: "@orchestration";
+    /** 临时状态提示 - loading/thinking/error 等 */
+    readonly STATUS: "@status";
+    /** 结果展示区 - 智能体执行结果 */
+    readonly RESULT: "@result";
+    /** 确认对话框 - 需要用户确认的操作 */
+    readonly CONFIRM: "@confirm";
+    /** 通知区 - 系统通知 */
+    readonly NOTIFICATION: "@notification";
+};
+/**
+ * Surface ID 类型
+ */
+type SurfaceIdType = (typeof SURFACE_IDS)[keyof typeof SURFACE_IDS];
+/**
+ * Surface 配置
+ */
+interface SurfaceConfig {
+    /** Surface ID */
+    id: SurfaceIdType | string;
+    /** 是否自动消失 */
+    autoHide?: boolean;
+    /** 自动消失延迟（毫秒） */
+    autoHideDelay?: number;
+    /** 是否可关闭 */
+    closable?: boolean;
+    /** 优先级（数字越大越优先显示） */
+    priority?: number;
+}
+/**
+ * 生成唯一的 Surface ID
+ *
+ * @param prefix - ID 前缀
+ * @returns 唯一的 Surface ID
+ *
+ * @example
+ * ```typescript
+ * const id = generateSurfaceId('status'); // 'status-1703123456789-1'
+ * ```
+ */
+declare function generateSurfaceId(prefix?: string): string;
+/**
+ * 重置 Surface ID 计数器
+ * 主要用于测试
+ */
+declare function resetSurfaceIdCounter(): void;
+
+/**
+ * Surface Builder
+ *
+ * 提供 A2UI Surface 的构建工具函数
+ * 基于 v0.9 格式
+ *
+ * 参考：https://a2ui.org/
+ */
+
+/**
+ * Surface 构建结果
+ */
+interface SurfaceResult {
+    /** 构建的消息数组 */
+    messages: ServerToClientMessageV09[];
+    /** Surface ID */
+    surfaceId: string;
+}
+/**
+ * 创建 A2UI Surface 消息
+ *
+ * @param rootId - 根组件 ID
+ * @param components - 组件列表（v0.9 格式）
+ * @param surfaceId - Surface ID（可选，自动生成）
+ * @returns Surface 构建结果
+ *
+ * @example
+ * ```typescript
+ * import { createA2UISurface, h1, column, SURFACE_IDS } from '@zhama/a2ui-core';
+ *
+ * const title = h1('Hello', { id: 'title' });
+ * const root = column(['title'], { id: 'root' });
+ *
+ * const { messages, surfaceId } = createA2UISurface('root', [title, root], SURFACE_IDS.CHAT);
+ * ```
+ */
+declare function createA2UISurface(rootId: string, components: ComponentInstance[], surfaceId?: string): SurfaceResult;
+/**
+ * 创建带数据模型的 A2UI Surface
+ *
+ * @param rootId - 根组件 ID
+ * @param components - 组件列表（v0.9 格式）
+ * @param dataModel - 数据模型对象
+ * @param surfaceId - Surface ID（可选）
+ * @returns Surface 构建结果
+ *
+ * @example
+ * ```typescript
+ * const { messages } = createA2UISurfaceWithData(
+ *   'root',
+ *   [title, greeting, root],
+ *   { user: { name: 'John' } },
+ *   SURFACE_IDS.CHAT
+ * );
+ * ```
+ */
+declare function createA2UISurfaceWithData(rootId: string, components: ComponentInstance[], dataModel: DataObject, surfaceId?: string): SurfaceResult;
+/**
+ * 创建删除 Surface 的消息
+ *
+ * @param surfaceId - 要删除的 Surface ID
+ * @returns 删除消息
+ */
+declare function createDeleteSurfaceMessage(surfaceId: string): ServerToClientMessageV09;
+/**
+ * 创建聊天区 Surface
+ */
+declare function createChatSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+/**
+ * 创建智能体推荐区 Surface
+ */
+declare function createRecommendationSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+/**
+ * 创建输入表单区 Surface
+ */
+declare function createInputFormSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+/**
+ * 创建编排面板 Surface
+ */
+declare function createOrchestrationSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+/**
+ * 创建状态提示 Surface
+ */
+declare function createStatusSurface(rootId: string, components: ComponentInstance[]): SurfaceResult;
+
+export { SURFACE_IDS, type SurfaceConfig, type SurfaceIdType, type SurfaceResult, createA2UISurface, createA2UISurfaceWithData, createChatSurface, createDeleteSurfaceMessage, createInputFormSurface, createOrchestrationSurface, createRecommendationSurface, createStatusSurface, generateSurfaceId, resetSurfaceIdCounter };

package/dist/surface/index.js

@@ -0,0 +1,2 @@
+var a={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 S(){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,r,n="replace"){return {updateDataModel:{surfaceId:e,...r,op:n,...n!=="remove"&&{value:t}}}}function d(e){return {deleteSurface:{surfaceId:e}}}function o(e,t,r){let n=r??i();return t.find(l=>l.id===e)||console.warn(`[A2UI] Root component "${e}" not found in components list`),{messages:[u(n),g(n,t)],surfaceId:n}}function C(e,t,r,n){let s=n??i();return {messages:[u(s),g(s,t),f(s,r)],surfaceId:s}}function M(e){return d(e)}function I(e,t){return o(e,t,a.CHAT)}function T(e,t){return o(e,t,a.RECOMMENDATION)}function D(e,t){return o(e,t,a.INPUT_FORM)}function x(e,t){return o(e,t,a.ORCHESTRATION)}function A(e,t){return o(e,t,a.STATUS)}
+export{a as SURFACE_IDS,o as createA2UISurface,C as createA2UISurfaceWithData,I as createChatSurface,M as createDeleteSurfaceMessage,D as createInputFormSurface,x as createOrchestrationSurface,T as createRecommendationSurface,A as createStatusSurface,i as generateSurfaceId,S as resetSurfaceIdCounter};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhama/a2ui-core",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "A2UI Protocol Core Library - Framework-agnostic TypeScript types and builders for A2UI protocol",
   "type": "module",
   "main": "dist/index.cjs",
@@ -36,6 +36,12 @@
       "import": "./dist/utils/index.js",
       "require": "./dist/utils/index.cjs",
       "default": "./dist/utils/index.js"
+    },
+    "./surface": {
+      "types": "./dist/surface/index.d.ts",
+      "import": "./dist/surface/index.js",
+      "require": "./dist/surface/index.cjs",
+      "default": "./dist/surface/index.js"
     }
   },
   "files": [