@zhama/a2ui-core 0.4.0 → 0.6.0

package/dist/index.js

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

package/dist/{primitives-nmkVz-tB.d.cts → primitives-DLbBDhLq.d.cts}

@@ -36,40 +36,6 @@ type BooleanOrPath = boolean | {
 type StringArrayOrPath = string[] | {
     path: string;
 };
-/**
- * v0.8 格式的字符串值（带有 literalString/path 区分）
- */
-interface StringValue {
-    path?: string;
-    literalString?: string;
-    /** @deprecated 使用 literalString */
-    literal?: string;
-}
-/**
- * v0.8 格式的数值（带有 literalNumber/path 区分）
- */
-interface NumberValue {
-    path?: string;
-    literalNumber?: number;
-    /** @deprecated 使用 literalNumber */
-    literal?: number;
-}
-/**
- * v0.8 格式的布尔值（带有 literalBoolean/path 区分）
- */
-interface BooleanValue {
-    path?: string;
-    literalBoolean?: boolean;
-    /** @deprecated 使用 literalBoolean */
-    literal?: boolean;
-}
-/**
- * v0.8 格式的字符串数组值
- */
-interface StringArrayValue {
-    path?: string;
-    literalArray?: string[];
-}
 /**
  * Context value - 用于 Action context 中的值
  */
@@ -77,4 +43,4 @@ type ContextValue = string | number | boolean | {
     path: string;
 };
 
-export type { BooleanOrPath as B, ContextValue as C, NumberOrPath as N, StringOrPath as S, StringArrayOrPath as a, StringValue as b, NumberValue as c, BooleanValue as d, StringArrayValue as e };
+export type { BooleanOrPath as B, ContextValue as C, NumberOrPath as N, StringOrPath as S, StringArrayOrPath as a };

package/dist/{primitives-nmkVz-tB.d.ts → primitives-DLbBDhLq.d.ts}

@@ -36,40 +36,6 @@ type BooleanOrPath = boolean | {
 type StringArrayOrPath = string[] | {
     path: string;
 };
-/**
- * v0.8 格式的字符串值（带有 literalString/path 区分）
- */
-interface StringValue {
-    path?: string;
-    literalString?: string;
-    /** @deprecated 使用 literalString */
-    literal?: string;
-}
-/**
- * v0.8 格式的数值（带有 literalNumber/path 区分）
- */
-interface NumberValue {
-    path?: string;
-    literalNumber?: number;
-    /** @deprecated 使用 literalNumber */
-    literal?: number;
-}
-/**
- * v0.8 格式的布尔值（带有 literalBoolean/path 区分）
- */
-interface BooleanValue {
-    path?: string;
-    literalBoolean?: boolean;
-    /** @deprecated 使用 literalBoolean */
-    literal?: boolean;
-}
-/**
- * v0.8 格式的字符串数组值
- */
-interface StringArrayValue {
-    path?: string;
-    literalArray?: string[];
-}
 /**
  * Context value - 用于 Action context 中的值
  */
@@ -77,4 +43,4 @@ type ContextValue = string | number | boolean | {
     path: string;
 };
 
-export type { BooleanOrPath as B, ContextValue as C, NumberOrPath as N, StringOrPath as S, StringArrayOrPath as a, StringValue as b, NumberValue as c, BooleanValue as d, StringArrayValue as e };
+export type { BooleanOrPath as B, ContextValue as C, NumberOrPath as N, StringOrPath as S, StringArrayOrPath as a };

package/dist/surface/index.cjs

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

package/dist/surface/index.d.cts

@@ -1,5 +1,5 @@
 import { ServerToClientMessageV09, ComponentInstance, DataObject } from '../types/index.cjs';
-import '../primitives-nmkVz-tB.cjs';
+import '../primitives-DLbBDhLq.cjs';
 
 /**
  * Surface IDs and Configuration

package/dist/surface/index.d.ts

@@ -1,5 +1,5 @@
 import { ServerToClientMessageV09, ComponentInstance, DataObject } from '../types/index.js';
-import '../primitives-nmkVz-tB.js';
+import '../primitives-DLbBDhLq.js';
 
 /**
  * Surface IDs and Configuration

package/dist/surface/index.js

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

package/dist/types/index.cjs

@@ -1,2 +1,2 @@
-'use strict';function t(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 a="https://a2ui.dev/specification/0.9/standard_catalog_definition.json",o="https://a2ui.org/a2a-extension/a2ui/v0.8",r="https://a2ui.dev/specification/0.9",s="application/json+a2ui";
-exports.A2UI_EXTENSION_URI=r;exports.A2UI_EXTENSION_URI_V08=o;exports.A2UI_MIME_TYPE=s;exports.STANDARD_CATALOG_ID=a;exports.isV08Message=n;exports.isV09Message=t;
+'use strict';function t(e){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e}var n="https://a2ui.dev/specification/0.9/standard_catalog_definition.json";var r="https://a2ui.dev/specification/0.9",a="application/json+a2ui";
+exports.A2UI_EXTENSION_URI=r;exports.A2UI_MIME_TYPE=a;exports.STANDARD_CATALOG_ID=n;exports.isV09Message=t;

package/dist/types/index.d.cts

@@ -1,5 +1,5 @@
-import { S as StringOrPath, N as NumberOrPath, B as BooleanOrPath, a as StringArrayOrPath } from '../primitives-nmkVz-tB.cjs';
-export { d as BooleanValue, C as ContextValue, c as NumberValue, e as StringArrayValue, b as StringValue } from '../primitives-nmkVz-tB.cjs';
+import { S as StringOrPath, N as NumberOrPath, B as BooleanOrPath, a as StringArrayOrPath } from '../primitives-DLbBDhLq.cjs';
+export { C as ContextValue } from '../primitives-DLbBDhLq.cjs';
 
 /**
  * A2UI Component Types
@@ -24,25 +24,6 @@ interface Action {
      */
     context?: Record<string, StringOrPath | NumberOrPath | BooleanOrPath>;
 }
-/**
- * v0.8 格式的 Action 上下文项
- */
-interface ActionContextItem {
-    key: string;
-    value: {
-        path?: string;
-        literalString?: string;
-        literalNumber?: number;
-        literalBoolean?: boolean;
-    };
-}
-/**
- * v0.8 格式的 Action
- */
-interface ActionV08 {
-    name: string;
-    context?: ActionContextItem[];
-}
 /**
  * 组件公共属性
  */
@@ -55,6 +36,11 @@ interface ComponentCommon {
      * 在 Row 或 Column 中的相对权重（类似 CSS flex-grow）
      */
     weight?: number;
+    /**
+     * 额外的 CSS 类名（A2UI 工具类或自定义类）
+     * @example ['a2-overflow-y-auto', 'a2-max-h-20']
+     */
+    classes?: string[];
 }
 /**
  * Text 组件 - 显示文本内容
@@ -547,18 +533,19 @@ type ServerToClientMessage = ServerToClientMessageV08 | ServerToClientMessageV09
  * 判断是否为 v0.9 消息
  */
 declare function isV09Message(message: ServerToClientMessage): message is ServerToClientMessageV09;
-/**
- * 判断是否为 v0.8 消息
- */
-declare function isV08Message(message: ServerToClientMessage): message is ServerToClientMessageV08;
 /**
  * 用户操作事件
+ * @see https://a2ui.dev/specification/0.9/client_to_server.json
  */
 interface UserActionEvent {
     /**
-     * 操作名称
+     * 操作名称（来自组件的 action.name）
+     */
+    name: string;
+    /**
+     * 触发操作的 Surface ID
      */
-    actionName: string;
+    surfaceId: string;
     /**
      * 触发组件的 ID
      */
@@ -568,9 +555,9 @@ interface UserActionEvent {
      */
     timestamp: string;
     /**
-     * 操作上下文（解析后的值）
+     * 操作上下文（解析数据绑定后的键值对）
      */
-    context?: Record<string, unknown>;
+    context: Record<string, unknown>;
 }
 /**
  * 数据变更事件
@@ -593,6 +580,54 @@ interface DataChangeEvent {
      */
     sourceComponentId: string;
 }
+/**
+ * 验证失败错误
+ * @see https://a2ui.dev/specification/0.9/client_to_server.json
+ */
+interface ValidationFailedError {
+    /**
+     * 错误代码
+     */
+    code: 'VALIDATION_FAILED';
+    /**
+     * 发生错误的 Surface ID
+     */
+    surfaceId: string;
+    /**
+     * 验证失败的字段路径（JSON Pointer 格式）
+     * @example "/components/0/text"
+     */
+    path: string;
+    /**
+     * 错误描述
+     */
+    message: string;
+}
+/**
+ * 通用错误
+ */
+interface GenericError {
+    /**
+     * 错误代码（非 VALIDATION_FAILED）
+     */
+    code: string;
+    /**
+     * 发生错误的 Surface ID
+     */
+    surfaceId: string;
+    /**
+     * 错误描述
+     */
+    message: string;
+    /**
+     * 其他附加信息
+     */
+    [key: string]: unknown;
+}
+/**
+ * 客户端错误消息
+ */
+type ClientErrorMessage = ValidationFailedError | GenericError;
 /**
  * 客户端到服务器消息
  */
@@ -600,6 +635,8 @@ type ClientToServerMessage = {
     userAction: UserActionEvent;
 } | {
     dataChange: DataChangeEvent;
+} | {
+    error: ClientErrorMessage;
 };
 /**
  * 数据模型值类型
@@ -619,10 +656,6 @@ type DataArray = DataValue[];
  * A2UI 标准 Catalog ID
  */
 declare const STANDARD_CATALOG_ID = "https://a2ui.dev/specification/0.9/standard_catalog_definition.json";
-/**
- * A2UI 扩展 URI (v0.8)
- */
-declare const A2UI_EXTENSION_URI_V08 = "https://a2ui.org/a2a-extension/a2ui/v0.8";
 /**
  * A2UI 扩展 URI (v0.9)
  */
@@ -632,4 +665,4 @@ declare const A2UI_EXTENSION_URI = "https://a2ui.dev/specification/0.9";
  */
 declare const A2UI_MIME_TYPE = "application/json+a2ui";
 
-export { A2UI_EXTENSION_URI, A2UI_EXTENSION_URI_V08, A2UI_MIME_TYPE, type Action, type ActionContextItem, type ActionV08, type AnyComponent, type AudioPlayerComponent, type BeginRenderingMessage, BooleanOrPath, type ButtonComponent, type CardComponent, type CheckBoxComponent, type ChildrenProperty, type ChoicePickerComponent, type ClientToServerMessage, type ColumnComponent, type ComponentCommon, type ComponentInstance, type ComponentInstanceV08, type ComponentType, type CreateSurfaceMessage, type DataArray, type DataChangeEvent, type DataModelUpdateMessage, type DataObject, type DataValue, type DateTimeInputComponent, type DeleteSurfaceMessage, type DeleteSurfaceMessageV08, type DividerComponent, type IconComponent, type ImageComponent, type ListComponent, type ModalComponent, NumberOrPath, type RowComponent, STANDARD_CATALOG_ID, type ServerToClientMessage, type ServerToClientMessageV08, type ServerToClientMessageV09, type SliderComponent, type StandardIconName, StringArrayOrPath, StringOrPath, type SurfaceUpdateMessage, type TabsComponent, type TextComponent, type TextFieldComponent, type Theme, type UpdateComponentsMessage, type UpdateDataModelMessage, type UserActionEvent, type ValueMap, type VideoComponent, isV08Message, isV09Message };
+export { A2UI_EXTENSION_URI, A2UI_MIME_TYPE, type Action, type AnyComponent, type AudioPlayerComponent, BooleanOrPath, type ButtonComponent, type CardComponent, type CheckBoxComponent, type ChildrenProperty, type ChoicePickerComponent, type ClientErrorMessage, type ClientToServerMessage, type ColumnComponent, type ComponentCommon, type ComponentInstance, type ComponentType, type CreateSurfaceMessage, type DataArray, type DataChangeEvent, type DataObject, type DataValue, type DateTimeInputComponent, type DeleteSurfaceMessage, type DividerComponent, type GenericError, type IconComponent, type ImageComponent, type ListComponent, type ModalComponent, NumberOrPath, type RowComponent, STANDARD_CATALOG_ID, type ServerToClientMessageV09, type SliderComponent, type StandardIconName, StringArrayOrPath, StringOrPath, type TabsComponent, type TextComponent, type TextFieldComponent, type Theme, type UpdateComponentsMessage, type UpdateDataModelMessage, type UserActionEvent, type ValidationFailedError, type VideoComponent, isV09Message };

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
-import { S as StringOrPath, N as NumberOrPath, B as BooleanOrPath, a as StringArrayOrPath } from '../primitives-nmkVz-tB.js';
-export { d as BooleanValue, C as ContextValue, c as NumberValue, e as StringArrayValue, b as StringValue } from '../primitives-nmkVz-tB.js';
+import { S as StringOrPath, N as NumberOrPath, B as BooleanOrPath, a as StringArrayOrPath } from '../primitives-DLbBDhLq.js';
+export { C as ContextValue } from '../primitives-DLbBDhLq.js';
 
 /**
  * A2UI Component Types
@@ -24,25 +24,6 @@ interface Action {
      */
     context?: Record<string, StringOrPath | NumberOrPath | BooleanOrPath>;
 }
-/**
- * v0.8 格式的 Action 上下文项
- */
-interface ActionContextItem {
-    key: string;
-    value: {
-        path?: string;
-        literalString?: string;
-        literalNumber?: number;
-        literalBoolean?: boolean;
-    };
-}
-/**
- * v0.8 格式的 Action
- */
-interface ActionV08 {
-    name: string;
-    context?: ActionContextItem[];
-}
 /**
  * 组件公共属性
  */
@@ -55,6 +36,11 @@ interface ComponentCommon {
      * 在 Row 或 Column 中的相对权重（类似 CSS flex-grow）
      */
     weight?: number;
+    /**
+     * 额外的 CSS 类名（A2UI 工具类或自定义类）
+     * @example ['a2-overflow-y-auto', 'a2-max-h-20']
+     */
+    classes?: string[];
 }
 /**
  * Text 组件 - 显示文本内容
@@ -547,18 +533,19 @@ type ServerToClientMessage = ServerToClientMessageV08 | ServerToClientMessageV09
  * 判断是否为 v0.9 消息
  */
 declare function isV09Message(message: ServerToClientMessage): message is ServerToClientMessageV09;
-/**
- * 判断是否为 v0.8 消息
- */
-declare function isV08Message(message: ServerToClientMessage): message is ServerToClientMessageV08;
 /**
  * 用户操作事件
+ * @see https://a2ui.dev/specification/0.9/client_to_server.json
  */
 interface UserActionEvent {
     /**
-     * 操作名称
+     * 操作名称（来自组件的 action.name）
+     */
+    name: string;
+    /**
+     * 触发操作的 Surface ID
      */
-    actionName: string;
+    surfaceId: string;
     /**
      * 触发组件的 ID
      */
@@ -568,9 +555,9 @@ interface UserActionEvent {
      */
     timestamp: string;
     /**
-     * 操作上下文（解析后的值）
+     * 操作上下文（解析数据绑定后的键值对）
      */
-    context?: Record<string, unknown>;
+    context: Record<string, unknown>;
 }
 /**
  * 数据变更事件
@@ -593,6 +580,54 @@ interface DataChangeEvent {
      */
     sourceComponentId: string;
 }
+/**
+ * 验证失败错误
+ * @see https://a2ui.dev/specification/0.9/client_to_server.json
+ */
+interface ValidationFailedError {
+    /**
+     * 错误代码
+     */
+    code: 'VALIDATION_FAILED';
+    /**
+     * 发生错误的 Surface ID
+     */
+    surfaceId: string;
+    /**
+     * 验证失败的字段路径（JSON Pointer 格式）
+     * @example "/components/0/text"
+     */
+    path: string;
+    /**
+     * 错误描述
+     */
+    message: string;
+}
+/**
+ * 通用错误
+ */
+interface GenericError {
+    /**
+     * 错误代码（非 VALIDATION_FAILED）
+     */
+    code: string;
+    /**
+     * 发生错误的 Surface ID
+     */
+    surfaceId: string;
+    /**
+     * 错误描述
+     */
+    message: string;
+    /**
+     * 其他附加信息
+     */
+    [key: string]: unknown;
+}
+/**
+ * 客户端错误消息
+ */
+type ClientErrorMessage = ValidationFailedError | GenericError;
 /**
  * 客户端到服务器消息
  */
@@ -600,6 +635,8 @@ type ClientToServerMessage = {
     userAction: UserActionEvent;
 } | {
     dataChange: DataChangeEvent;
+} | {
+    error: ClientErrorMessage;
 };
 /**
  * 数据模型值类型
@@ -619,10 +656,6 @@ type DataArray = DataValue[];
  * A2UI 标准 Catalog ID
  */
 declare const STANDARD_CATALOG_ID = "https://a2ui.dev/specification/0.9/standard_catalog_definition.json";
-/**
- * A2UI 扩展 URI (v0.8)
- */
-declare const A2UI_EXTENSION_URI_V08 = "https://a2ui.org/a2a-extension/a2ui/v0.8";
 /**
  * A2UI 扩展 URI (v0.9)
  */
@@ -632,4 +665,4 @@ declare const A2UI_EXTENSION_URI = "https://a2ui.dev/specification/0.9";
  */
 declare const A2UI_MIME_TYPE = "application/json+a2ui";
 
-export { A2UI_EXTENSION_URI, A2UI_EXTENSION_URI_V08, A2UI_MIME_TYPE, type Action, type ActionContextItem, type ActionV08, type AnyComponent, type AudioPlayerComponent, type BeginRenderingMessage, BooleanOrPath, type ButtonComponent, type CardComponent, type CheckBoxComponent, type ChildrenProperty, type ChoicePickerComponent, type ClientToServerMessage, type ColumnComponent, type ComponentCommon, type ComponentInstance, type ComponentInstanceV08, type ComponentType, type CreateSurfaceMessage, type DataArray, type DataChangeEvent, type DataModelUpdateMessage, type DataObject, type DataValue, type DateTimeInputComponent, type DeleteSurfaceMessage, type DeleteSurfaceMessageV08, type DividerComponent, type IconComponent, type ImageComponent, type ListComponent, type ModalComponent, NumberOrPath, type RowComponent, STANDARD_CATALOG_ID, type ServerToClientMessage, type ServerToClientMessageV08, type ServerToClientMessageV09, type SliderComponent, type StandardIconName, StringArrayOrPath, StringOrPath, type SurfaceUpdateMessage, type TabsComponent, type TextComponent, type TextFieldComponent, type Theme, type UpdateComponentsMessage, type UpdateDataModelMessage, type UserActionEvent, type ValueMap, type VideoComponent, isV08Message, isV09Message };
+export { A2UI_EXTENSION_URI, A2UI_MIME_TYPE, type Action, type AnyComponent, type AudioPlayerComponent, BooleanOrPath, type ButtonComponent, type CardComponent, type CheckBoxComponent, type ChildrenProperty, type ChoicePickerComponent, type ClientErrorMessage, type ClientToServerMessage, type ColumnComponent, type ComponentCommon, type ComponentInstance, type ComponentType, type CreateSurfaceMessage, type DataArray, type DataChangeEvent, type DataObject, type DataValue, type DateTimeInputComponent, type DeleteSurfaceMessage, type DividerComponent, type GenericError, type IconComponent, type ImageComponent, type ListComponent, type ModalComponent, NumberOrPath, type RowComponent, STANDARD_CATALOG_ID, type ServerToClientMessageV09, type SliderComponent, type StandardIconName, StringArrayOrPath, StringOrPath, type TabsComponent, type TextComponent, type TextFieldComponent, type Theme, type UpdateComponentsMessage, type UpdateDataModelMessage, type UserActionEvent, type ValidationFailedError, type VideoComponent, isV09Message };

package/dist/types/index.js

@@ -1,2 +1,2 @@
-function t(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 a="https://a2ui.dev/specification/0.9/standard_catalog_definition.json",o="https://a2ui.org/a2a-extension/a2ui/v0.8",r="https://a2ui.dev/specification/0.9",s="application/json+a2ui";
-export{r as A2UI_EXTENSION_URI,o as A2UI_EXTENSION_URI_V08,s as A2UI_MIME_TYPE,a as STANDARD_CATALOG_ID,n as isV08Message,t as isV09Message};
+function t(e){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e}var n="https://a2ui.dev/specification/0.9/standard_catalog_definition.json";var r="https://a2ui.dev/specification/0.9",a="application/json+a2ui";
+export{r as A2UI_EXTENSION_URI,a as A2UI_MIME_TYPE,n as STANDARD_CATALOG_ID,t as isV09Message};

package/dist/utils/index.d.cts

@@ -1,4 +1,4 @@
-import { S as StringOrPath, N as NumberOrPath, B as BooleanOrPath } from '../primitives-nmkVz-tB.cjs';
+import { S as StringOrPath, N as NumberOrPath, B as BooleanOrPath } from '../primitives-DLbBDhLq.cjs';
 
 /**
  * A2UI Utilities

package/dist/utils/index.d.ts

@@ -1,4 +1,4 @@
-import { S as StringOrPath, N as NumberOrPath, B as BooleanOrPath } from '../primitives-nmkVz-tB.js';
+import { S as StringOrPath, N as NumberOrPath, B as BooleanOrPath } from '../primitives-DLbBDhLq.js';
 
 /**
  * A2UI Utilities

package/dist/validators/index.cjs

@@ -1 +1 @@
-'use strict';var l=["Text","Image","Icon","Video","AudioPlayer","Row","Column","List","Card","Tabs","Divider","Modal","Button","CheckBox","TextField","DateTimeInput","ChoicePicker","Slider"];function c(e,o={}){let a=[],s=[];if("createSurface"in e){let{createSurface:t}=e;t.surfaceId||a.push({code:"MISSING_SURFACE_ID",message:"createSurface.surfaceId is required",path:"createSurface.surfaceId"}),t.catalogId||a.push({code:"MISSING_CATALOG_ID",message:"createSurface.catalogId is required",path:"createSurface.catalogId"});}else if("updateComponents"in e){let{updateComponents:t}=e;t.surfaceId||a.push({code:"MISSING_SURFACE_ID",message:"updateComponents.surfaceId is required",path:"updateComponents.surfaceId"}),!t.components||!Array.isArray(t.components)?a.push({code:"INVALID_COMPONENTS",message:"updateComponents.components must be an array",path:"updateComponents.components"}):I(t.components,a,s,o);}else if("updateDataModel"in e){let{updateDataModel:t}=e;t.surfaceId||a.push({code:"MISSING_SURFACE_ID",message:"updateDataModel.surfaceId is required",path:"updateDataModel.surfaceId"});}else if("deleteSurface"in e){let{deleteSurface:t}=e;t.surfaceId||a.push({code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"});}else a.push({code:"INVALID_MESSAGE_TYPE",message:"Message must contain one of: createSurface, updateComponents, updateDataModel, deleteSurface"});return {valid:a.length===0,errors:a,warnings:s}}function p(e,o={}){let a=[],s=[];if("beginRendering"in e){let{beginRendering:t}=e;t.surfaceId||a.push({code:"MISSING_SURFACE_ID",message:"beginRendering.surfaceId is required",path:"beginRendering.surfaceId"}),t.root||a.push({code:"MISSING_ROOT",message:"beginRendering.root is required",path:"beginRendering.root"});}else if("surfaceUpdate"in e){let{surfaceUpdate:t}=e;t.surfaceId||a.push({code:"MISSING_SURFACE_ID",message:"surfaceUpdate.surfaceId is required",path:"surfaceUpdate.surfaceId"}),!t.components||!Array.isArray(t.components)?a.push({code:"INVALID_COMPONENTS",message:"surfaceUpdate.components must be an array",path:"surfaceUpdate.components"}):S(t.components,a,s,o);}else if("dataModelUpdate"in e){let{dataModelUpdate:t}=e;t.surfaceId||a.push({code:"MISSING_SURFACE_ID",message:"dataModelUpdate.surfaceId is required",path:"dataModelUpdate.surfaceId"}),(!t.contents||!Array.isArray(t.contents))&&a.push({code:"INVALID_CONTENTS",message:"dataModelUpdate.contents must be an array",path:"dataModelUpdate.contents"});}else if("deleteSurface"in e){let{deleteSurface:t}=e;t.surfaceId||a.push({code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"});}else a.push({code:"INVALID_MESSAGE_TYPE",message:"Message must contain one of: beginRendering, surfaceUpdate, dataModelUpdate, deleteSurface"});return {valid:a.length===0,errors:a,warnings:s}}function u(e,o={}){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e?c(e,o):"beginRendering"in e||"surfaceUpdate"in e||"dataModelUpdate"in e?p(e,o):"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 f(e,o={}){let a=[],s=[];for(let t=0;t<e.length;t++){let r=e[t];if(!r)continue;let i=u(r,o);for(let n of i.errors)a.push({...n,path:`messages[${t}].${n.path??""}`});for(let n of i.warnings)s.push({...n,path:`messages[${t}].${n.path??""}`});}return {valid:a.length===0,errors:a,warnings:s}}function I(e,o,a,s){let t=new Set,r=false;for(let i=0;i<e.length;i++){let n=e[i];if(!n)continue;let d=`updateComponents.components[${i}]`;n.id?(t.has(n.id)&&o.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${n.id}`,path:`${d}.id`}),t.add(n.id),n.id==="root"&&(r=true)):o.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${d}.id`}),n.component?s.strict&&s.allowedComponents&&(s.allowedComponents.includes(n.component)||a.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${n.component}`,path:`${d}.component`})):o.push({code:"MISSING_COMPONENT_TYPE",message:"Component type is required",path:`${d}.component`});}!r&&s.strict&&a.push({code:"MISSING_ROOT_COMPONENT",message:'No component with id "root" found',path:"updateComponents.components"});}function S(e,o,a,s){let t=new Set;for(let r=0;r<e.length;r++){let i=e[r];if(!i)continue;let n=`surfaceUpdate.components[${r}]`;if(i.id?(t.has(i.id)&&o.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${i.id}`,path:`${n}.id`}),t.add(i.id)):o.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${n}.id`}),!i.component||typeof i.component!="object")o.push({code:"MISSING_COMPONENT",message:"Component definition is required",path:`${n}.component`});else {let d=Object.keys(i.component)[0];d&&s.strict&&!l.includes(d)&&a.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${d}`,path:`${n}.component`});}}}exports.validateMessage=u;exports.validateMessages=f;exports.validateV08Message=p;exports.validateV09Message=c;
+'use strict';var u=["Text","Image","Icon","Video","AudioPlayer","Row","Column","List","Card","Tabs","Divider","Modal","Button","CheckBox","TextField","DateTimeInput","ChoicePicker","Slider"];function p(t,i={}){let a=[],n=[];if("createSurface"in t){let{createSurface:e}=t;e.surfaceId||a.push({code:"MISSING_SURFACE_ID",message:"createSurface.surfaceId is required",path:"createSurface.surfaceId"}),e.catalogId||a.push({code:"MISSING_CATALOG_ID",message:"createSurface.catalogId is required",path:"createSurface.catalogId"});}else if("updateComponents"in t){let{updateComponents:e}=t;e.surfaceId||a.push({code:"MISSING_SURFACE_ID",message:"updateComponents.surfaceId is required",path:"updateComponents.surfaceId"}),!e.components||!Array.isArray(e.components)?a.push({code:"INVALID_COMPONENTS",message:"updateComponents.components must be an array",path:"updateComponents.components"}):f(e.components,a,n,i);}else if("updateDataModel"in t){let{updateDataModel:e}=t;e.surfaceId||a.push({code:"MISSING_SURFACE_ID",message:"updateDataModel.surfaceId is required",path:"updateDataModel.surfaceId"}),e.op&&!["add","replace","remove"].includes(e.op)&&a.push({code:"INVALID_OP",message:"updateDataModel.op must be one of: add, replace, remove",path:"updateDataModel.op"}),e.op==="remove"&&e.value!==void 0&&n.push({code:"UNNECESSARY_VALUE",message:"updateDataModel.value should not be provided for remove operation",path:"updateDataModel.value"}),e.op!=="remove"&&e.value===void 0&&e.op==="add"&&a.push({code:"MISSING_VALUE",message:"updateDataModel.value is required for add operation",path:"updateDataModel.value"});}else if("deleteSurface"in t){let{deleteSurface:e}=t;e.surfaceId||a.push({code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"});}else a.push({code:"INVALID_MESSAGE_TYPE",message:"Message must contain one of: createSurface, updateComponents, updateDataModel, deleteSurface"});return {valid:a.length===0,errors:a,warnings:n}}function c(t,i={}){return p(t,i)}function l(t,i={}){let a=[],n=[];for(let e=0;e<t.length;e++){let r=t[e];if(!r)continue;let s=c(r,i);for(let o of s.errors)a.push({...o,path:`messages[${e}].${o.path??""}`});for(let o of s.warnings)n.push({...o,path:`messages[${e}].${o.path??""}`});}return {valid:a.length===0,errors:a,warnings:n}}function f(t,i,a,n){let e=new Set,r=false;for(let s=0;s<t.length;s++){let o=t[s];if(!o)continue;let d=`updateComponents.components[${s}]`;o.id?(e.has(o.id)&&i.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${o.id}`,path:`${d}.id`}),e.add(o.id),o.id==="root"&&(r=true)):i.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${d}.id`}),o.component?n.strict&&!u.includes(o.component)&&n.allowedComponents&&!n.allowedComponents.includes(o.component)&&a.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${o.component}`,path:`${d}.component`}):i.push({code:"MISSING_COMPONENT_TYPE",message:"Component type is required",path:`${d}.component`});}!r&&n.strict&&a.push({code:"MISSING_ROOT_COMPONENT",message:'No component with id "root" found',path:"updateComponents.components"});}exports.validateMessage=c;exports.validateMessages=l;exports.validateV09Message=p;