@zhama/a2ui 0.10.4 → 0.11.0

package/dist/data/index.cjs

@@ -1,2 +1,2 @@
-'use strict';var K=Object.defineProperty;var W=(e,t,r)=>t in e?K(e,t,{enumerable:true,configurable:true,writable:true,value:r}):e[t]=r;var R=(e,t,r)=>W(e,typeof t!="symbol"?t+"":t,r);function G(e){return a(e)&&"key"in e}function D(e,t){return e==="path"&&typeof t=="string"}function a(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function I(e){return a(e)?"explicitList"in e||"template"in e:false}function h(e){return a(e)&&("path"in e||"literal"in e&&typeof e.literal=="string"||"literalString"in e)}function J(e){return a(e)&&("path"in e||"literal"in e&&typeof e.literal=="number"||"literalNumber"in e)}function _(e){return a(e)&&("path"in e||"literal"in e&&typeof e.literal=="boolean"||"literalBoolean"in e)}function y(e){return a(e)?"id"in e&&"type"in e&&"properties"in e:false}function M(e){return a(e)&&"url"in e&&h(e.url)}function A(e){return a(e)&&"child"in e&&y(e.child)&&"action"in e}function x(e){return a(e)?"child"in e?y(e.child):"children"in e?Array.isArray(e.children)&&e.children.every(y):false:false}function b(e){return a(e)&&"label"in e&&h(e.label)&&"value"in e&&_(e.value)}function S(e){return a(e)&&"children"in e&&Array.isArray(e.children)&&e.children.every(y)}function k(e){return a(e)&&"value"in e&&h(e.value)}function V(e){return a(e)}function T(e){return a(e)&&"url"in e&&h(e.url)}function $(e){return a(e)&&"name"in e&&h(e.name)}function P(e){return a(e)&&"children"in e&&Array.isArray(e.children)&&e.children.every(y)}function E(e){return a(e)&&"entryPointChild"in e&&y(e.entryPointChild)&&"contentChild"in e&&y(e.contentChild)}function B(e){return a(e)&&"selections"in e}function N(e){return a(e)&&"children"in e&&Array.isArray(e.children)&&e.children.every(y)}function U(e){return a(e)&&"value"in e&&J(e.value)}function z(e){return a(e)&&"title"in e&&h(e.title)&&"child"in e&&y(e.child)}function j(e){return a(e)&&"tabItems"in e&&Array.isArray(e.tabItems)&&e.tabItems.every(z)}function O(e){return a(e)&&"text"in e&&h(e.text)}function F(e){return a(e)&&"label"in e&&h(e.label)}function L(e){return a(e)&&"url"in e&&h(e.url)}var g=class g{constructor(t={}){R(this,"mapCtor",Map);R(this,"arrayCtor",Array);R(this,"setCtor",Set);R(this,"objCtor",Object);R(this,"surfaces");this.arrayCtor=t.arrayCtor??Array,this.mapCtor=t.mapCtor??Map,this.setCtor=t.setCtor??Set,this.objCtor=t.objCtor??Object,this.surfaces=new this.mapCtor;}getSurfaces(){return this.surfaces}clearSurfaces(){this.surfaces.clear();}processMessages(t){for(let r of t)r.beginRendering&&this.handleBeginRendering(r.beginRendering,r.beginRendering.surfaceId),r.surfaceUpdate&&this.handleSurfaceUpdate(r.surfaceUpdate,r.surfaceUpdate.surfaceId),r.dataModelUpdate&&this.handleDataModelUpdate(r.dataModelUpdate,r.dataModelUpdate.surfaceId),r.deleteSurface&&this.handleDeleteSurface(r.deleteSurface);}getData(t,r,n=g.DEFAULT_SURFACE_ID){let o=this.getOrCreateSurface(n);if(!o)return null;let i;return r==="."||r===""?i=t.dataContextPath??"/":i=this.resolvePath(r,t.dataContextPath),this.getDataByPath(o.dataModel,i)}setData(t,r,n,o=g.DEFAULT_SURFACE_ID){if(!t){console.warn("No component node set");return}let i=this.getOrCreateSurface(o);if(!i)return;let l;r==="."||r===""?l=t.dataContextPath??"/":l=this.resolvePath(r,t.dataContextPath),this.setDataByPath(i.dataModel,l,n);}resolvePath(t,r){return t.startsWith("/")?t:r&&r!=="/"?r.endsWith("/")?`${r}${t}`:`${r}/${t}`:`/${t}`}parseIfJsonString(t){if(typeof t!="string")return t;let r=t.trim();if(r.startsWith("{")&&r.endsWith("}")||r.startsWith("[")&&r.endsWith("]"))try{return JSON.parse(t)}catch{return console.warn(`Failed to parse potential JSON string: "${t.substring(0,50)}..."`),t}return t}convertKeyValueArrayToMap(t){let r=new this.mapCtor;for(let n of t){if(!a(n)||!("key"in n))continue;let o=n.key,i=this.findValueKey(n);if(!i)continue;let l=n[i];i==="valueMap"&&Array.isArray(l)?l=this.convertKeyValueArrayToMap(l):typeof l=="string"&&(l=this.parseIfJsonString(l)),this.setDataByPath(r,o,l);}return r}setDataByPath(t,r,n){if(Array.isArray(n)&&(n.length===0||a(n[0])&&"key"in n[0]))if(n.length===1&&a(n[0])&&n[0].key==="."){let c=n[0],u=this.findValueKey(c);u?(n=c[u],u==="valueMap"&&Array.isArray(n)?n=this.convertKeyValueArrayToMap(n):typeof n=="string"&&(n=this.parseIfJsonString(n))):n=this.convertKeyValueArrayToMap(n);}else n=this.convertKeyValueArrayToMap(n);let o=this.normalizePath(r).split("/").filter(c=>c);if(o.length===0){if(n instanceof Map||a(n)){!(n instanceof Map)&&a(n)&&(n=new this.mapCtor(Object.entries(n))),t.clear();for(let[c,u]of n.entries())t.set(c,u);}else console.error("Cannot set root of DataModel to a non-Map value.");return}let i=t;for(let c=0;c<o.length-1;c++){let u=o[c],f;i instanceof Map?f=i.get(u):Array.isArray(i)&&/^\d+$/.test(u)&&(f=i[parseInt(u,10)]),(f===void 0||typeof f!="object"||f===null)&&(f=new this.mapCtor,i instanceof this.mapCtor?i.set(u,f):Array.isArray(i)&&(i[parseInt(u,10)]=f)),i=f;}let l=o[o.length-1];i instanceof this.mapCtor?i.set(l,n):Array.isArray(i)&&/^\d+$/.test(l)&&(i[parseInt(l,10)]=n);}normalizePath(t){return "/"+t.replace(/\[(\d+)\]/g,".$1").split(".").filter(o=>o.length>0).join("/")}getDataByPath(t,r){let n=this.normalizePath(r).split("/").filter(i=>i),o=t;for(let i of n){if(o==null)return null;if(o instanceof Map)o=o.get(i);else if(Array.isArray(o)&&/^\d+$/.test(i))o=o[parseInt(i,10)];else if(a(o))o=o[i];else return null}return o??null}getOrCreateSurface(t){let r=this.surfaces.get(t);return r||(r={rootComponentId:null,componentTree:null,dataModel:new this.mapCtor,components:new this.mapCtor,styles:{}},this.surfaces.set(t,r)),r}handleBeginRendering(t,r){let n=this.getOrCreateSurface(r);n.rootComponentId=t.root,n.styles=t.styles??{},this.rebuildComponentTree(n);}handleSurfaceUpdate(t,r){let n=this.getOrCreateSurface(r);for(let o of t.components)n.components.set(o.id,o);this.rebuildComponentTree(n);}handleDataModelUpdate(t,r){let n=this.getOrCreateSurface(r),o=t.path??"/";this.setDataByPath(n.dataModel,o,t.contents),this.rebuildComponentTree(n);}handleDeleteSurface(t){this.surfaces.delete(t.surfaceId);}rebuildComponentTree(t){if(!t.rootComponentId){t.componentTree=null;return}let r=new this.setCtor;t.componentTree=this.buildNodeRecursive(t.rootComponentId,t,r,"/","");}findValueKey(t){return Object.keys(t).find(r=>r.startsWith("value"))}buildNodeRecursive(t,r,n,o,i=""){let l=`${t}${i}`,{components:c}=r;if(!c.has(t))return null;if(n.has(l))throw new Error(`Circular dependency for component "${l}".`);n.add(l);let u=c.get(t),f=u.component??{},d=Object.keys(f)[0]??"Unknown",m=f[d],s={};if(a(m))for(let[v,w]of Object.entries(m))s[v]=this.resolvePropertyValue(w,r,n,o,i);n.delete(l);let p={id:l,dataContextPath:o,weight:u.weight??"initial"};switch(d){case "Text":if(!O(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Text",properties:s};case "Image":if(!T(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Image",properties:s};case "Icon":if(!$(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Icon",properties:s};case "Video":if(!L(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Video",properties:s};case "AudioPlayer":if(!M(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"AudioPlayer",properties:s};case "Row":if(!N(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Row",properties:s};case "Column":if(!S(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Column",properties:s};case "List":if(!P(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"List",properties:s};case "Card":if(!x(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Card",properties:s};case "Tabs":if(!j(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Tabs",properties:s};case "Divider":if(!V(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Divider",properties:s};case "Modal":if(!E(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Modal",properties:s};case "Button":if(!A(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Button",properties:s};case "CheckBox":if(!b(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"CheckBox",properties:s};case "TextField":if(!F(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"TextField",properties:s};case "DateTimeInput":if(!k(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"DateTimeInput",properties:s};case "MultipleChoice":if(!B(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"MultipleChoice",properties:s};case "Slider":if(!U(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Slider",properties:s};default:return {...p,type:d,properties:s}}}resolvePropertyValue(t,r,n,o,i=""){if(typeof t=="string"&&r.components.has(t))return this.buildNodeRecursive(t,r,n,o,i);if(I(t)){if(t.explicitList)return t.explicitList.map(l=>this.buildNodeRecursive(l,r,n,o,i));if(t.template){let l=this.resolvePath(t.template.dataBinding,o),c=this.getDataByPath(r.dataModel,l),u=t.template;return Array.isArray(c)?c.map((f,d)=>{let p=`:${[...o.split("/").filter(w=>/^\d+$/.test(w)),d].join(":")}`,v=`${l}/${d}`;return this.buildNodeRecursive(u.componentId,r,n,v,p)}):c instanceof Map?Array.from(c.keys(),f=>{let d=`:${f}`,m=`${l}/${f}`;return this.buildNodeRecursive(u.componentId,r,n,m,d)}):[]}}if(Array.isArray(t))return t.map(l=>this.resolvePropertyValue(l,r,n,o,i));if(a(t)){let l={};for(let[c,u]of Object.entries(t)){let f=u;if(D(c,u)&&o!=="/"){f=u.replace(/^\.?\/item/,"").replace(/^\.?\/text/,"").replace(/^\.?\/label/,"").replace(/^\.?\//,""),l[c]=f;continue}l[c]=this.resolvePropertyValue(f,r,n,o,i);}return l}return t}};R(g,"DEFAULT_SURFACE_ID","@default");var C=g;function X(){return new C}
-exports.A2uiMessageProcessor=C;exports.createMessageProcessor=X;exports.isAnyComponentNode=y;exports.isBooleanValue=_;exports.isComponentArrayReference=I;exports.isNumberValue=J;exports.isObject=a;exports.isPath=D;exports.isResolvedAudioPlayer=M;exports.isResolvedButton=A;exports.isResolvedCard=x;exports.isResolvedCheckbox=b;exports.isResolvedColumn=S;exports.isResolvedDateTimeInput=k;exports.isResolvedDivider=V;exports.isResolvedIcon=$;exports.isResolvedImage=T;exports.isResolvedList=P;exports.isResolvedModal=E;exports.isResolvedMultipleChoice=B;exports.isResolvedRow=N;exports.isResolvedSlider=U;exports.isResolvedTabItem=z;exports.isResolvedTabs=j;exports.isResolvedText=O;exports.isResolvedTextField=F;exports.isResolvedVideo=L;exports.isStringValue=h;exports.isValueMap=G;
+'use strict';var z=Object.defineProperty;var _=(e,t,r)=>t in e?z(e,t,{enumerable:true,configurable:true,writable:true,value:r}):e[t]=r;var y=(e,t,r)=>_(e,typeof t!="symbol"?t+"":t,r);function J(e){return d(e)}function D(e,t){return e==="path"&&typeof t=="string"}function d(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function I(e){return d(e)?"explicitList"in e||"template"in e:false}function v(e){return !!(typeof e=="string"||d(e)&&"path"in e&&typeof e.path=="string")}function W(e){return !!(typeof e=="number"||d(e)&&"path"in e&&typeof e.path=="string")}function q(e){return !!(typeof e=="boolean"||d(e)&&"path"in e&&typeof e.path=="string")}function h(e){return d(e)?"id"in e&&"type"in e&&"properties"in e:false}function M(e){return d(e)&&"url"in e&&v(e.url)}function x(e){return d(e)&&"child"in e&&h(e.child)&&"action"in e}function A(e){return d(e)?"child"in e?h(e.child):"children"in e?Array.isArray(e.children)&&e.children.every(h):false:false}function b(e){return d(e)&&"label"in e&&v(e.label)&&"value"in e&&q(e.value)}function S(e){return d(e)&&"children"in e&&Array.isArray(e.children)&&e.children.every(h)}function k(e){return d(e)&&"value"in e&&v(e.value)}function V(e){return d(e)}function T(e){return d(e)&&"url"in e&&v(e.url)}function $(e){return d(e)&&"name"in e&&v(e.name)}function P(e){return d(e)&&"children"in e&&Array.isArray(e.children)&&e.children.every(h)}function E(e){return d(e)&&"entryPointChild"in e&&h(e.entryPointChild)&&"contentChild"in e&&h(e.contentChild)}function O(e){return d(e)&&"selections"in e}function j(e){return d(e)&&"children"in e&&Array.isArray(e.children)&&e.children.every(h)}function B(e){return d(e)&&"value"in e&&W(e.value)}function G(e){return d(e)&&"title"in e&&v(e.title)&&"child"in e&&h(e.child)}function U(e){return d(e)&&"tabItems"in e&&Array.isArray(e.tabItems)&&e.tabItems.every(G)}function N(e){return d(e)&&"text"in e&&v(e.text)}function F(e){return d(e)&&"label"in e&&v(e.label)}function L(e){return d(e)&&"url"in e&&v(e.url)}var m=class m{constructor(t={}){y(this,"mapCtor",Map);y(this,"arrayCtor",Array);y(this,"setCtor",Set);y(this,"objCtor",Object);y(this,"surfaces");this.arrayCtor=t.arrayCtor??Array,this.mapCtor=t.mapCtor??Map,this.setCtor=t.setCtor??Set,this.objCtor=t.objCtor??Object,this.surfaces=new this.mapCtor;}getSurfaces(){return this.surfaces}clearSurfaces(){this.surfaces.clear();}processMessages(t){console.log("[A2UI] processMessages called with",t.length,"messages");for(let r of t)"createSurface"in r?this.handleCreateSurface(r):"updateComponents"in r?this.handleUpdateComponents(r):"updateDataModel"in r?this.handleUpdateDataModel(r):"deleteSurface"in r?this.handleDeleteSurface(r):console.warn("[A2UI] Unknown message type:",Object.keys(r));}getData(t,r,a=m.DEFAULT_SURFACE_ID){let n=this.getOrCreateSurface(a);if(!n)return console.warn("[A2UI] getData: surface not found:",a),null;let o;return r==="."||r===""?o=t.dataContextPath??"/":o=this.resolvePath(r,t.dataContextPath),this.getDataByPath(n.dataModel,o)}setData(t,r,a,n=m.DEFAULT_SURFACE_ID){if(!t){console.warn("No component node set");return}let o=this.getOrCreateSurface(n);if(!o)return;let l;r==="."||r===""?l=t.dataContextPath??"/":l=this.resolvePath(r,t.dataContextPath),this.setDataByPath(o.dataModel,l,a);}resolvePath(t,r){return t.startsWith("/")?t:r&&r!=="/"?r.endsWith("/")?`${r}${t}`:`${r}/${t}`:`/${t}`}handleCreateSurface(t){let{createSurface:r}=t,a=r.surfaceId,n=this.getOrCreateSurface(a);n.catalogId=r.catalogId;}handleUpdateComponents(t){let{updateComponents:r}=t,a=r.surfaceId,n=this.getOrCreateSurface(a);for(let o of r.components)n.components.set(o.id,o),n.rootComponentId||(n.rootComponentId=o.id);this.rebuildComponentTree(n);}handleUpdateDataModel(t){let{updateDataModel:r}=t,a=r.surfaceId,n=this.getOrCreateSurface(a),o=r.path??"/",l=r.op??"replace",u=r.value;l==="remove"?this.removeDataByPath(n.dataModel,o):u!==void 0&&this.setDataByPath(n.dataModel,o,u),this.rebuildComponentTree(n);}handleDeleteSurface(t){let{deleteSurface:r}=t;this.surfaces.delete(r.surfaceId);}setDataByPath(t,r,a){let n=this.normalizePath(r).split("/").filter(u=>u);if(n.length===0){if(d(a)&&!(a instanceof Map)){t.clear();for(let[u,c]of Object.entries(a))t.set(u,c);}return}let o=t;for(let u=0;u<n.length-1;u++){let c=n[u],i;if(o instanceof Map?i=o.get(c):Array.isArray(o)&&/^\d+$/.test(c)&&(i=o[parseInt(c,10)]),i===void 0||typeof i!="object"||i===null){let f=new this.mapCtor;o instanceof Map?o.set(c,f):Array.isArray(o)&&(o[parseInt(c,10)]=f),i=f;}o=i;}let l=n[n.length-1];o instanceof Map?o.set(l,a):Array.isArray(o)&&/^\d+$/.test(l)&&(o[parseInt(l,10)]=a);}removeDataByPath(t,r){let a=this.normalizePath(r).split("/").filter(l=>l);if(a.length===0){t.clear();return}let n=t;for(let l=0;l<a.length-1;l++){let u=a[l],c;if(n instanceof Map?c=n.get(u):Array.isArray(n)&&/^\d+$/.test(u)&&(c=n[parseInt(u,10)]),c===void 0||typeof c!="object"||c===null)return;n=c;}let o=a[a.length-1];n instanceof Map&&n.delete(o);}normalizePath(t){return "/"+t.replace(/\[(\d+)\]/g,".$1").split(".").filter(n=>n.length>0).join("/")}getDataByPath(t,r){let a=this.normalizePath(r).split("/").filter(o=>o),n=t;for(let o of a){if(n==null)return null;if(n instanceof Map)n=n.get(o);else if(Array.isArray(n)&&/^\d+$/.test(o))n=n[parseInt(o,10)];else if(d(n))n=n[o];else return null}return n??null}getOrCreateSurface(t){let r=this.surfaces.get(t);return r||(r={rootComponentId:null,componentTree:null,dataModel:new this.mapCtor,components:new this.mapCtor,styles:{}},this.surfaces.set(t,r)),r}rebuildComponentTree(t){if(!t.rootComponentId){t.componentTree=null;return}let r=new this.setCtor;t.componentTree=this.buildNodeRecursive(t.rootComponentId,t,r,"/","");}buildNodeRecursive(t,r,a,n,o=""){let l=`${t}${o}`,{components:u}=r;if(!u.has(t))return null;if(a.has(l))throw new Error(`Circular dependency for component "${l}".`);a.add(l);let c=u.get(t),i=c.component,f={...c};delete f.id,delete f.component;let s={};for(let[R,w]of Object.entries(f))s[R]=this.resolvePropertyValue(w,r,a,n,o);a.delete(l);let g=c.weight,p={id:l,dataContextPath:n,weight:typeof g=="number"||typeof g=="string"?g:void 0};switch(i){case "Text":if(!N(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Text",properties:s};case "Image":if(!T(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Image",properties:s};case "Icon":if(!$(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Icon",properties:s};case "Video":if(!L(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Video",properties:s};case "AudioPlayer":if(!M(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"AudioPlayer",properties:s};case "Row":if(!j(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Row",properties:s};case "Column":if(!S(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Column",properties:s};case "List":if(!P(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"List",properties:s};case "Card":if(!A(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Card",properties:s};case "Tabs":if(!U(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Tabs",properties:s};case "Divider":if(!V(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Divider",properties:s};case "Modal":if(!E(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Modal",properties:s};case "Button":if(!x(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Button",properties:s};case "CheckBox":if(!b(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"CheckBox",properties:s};case "TextField":if(!F(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"TextField",properties:s};case "DateTimeInput":if(!k(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"DateTimeInput",properties:s};case "MultipleChoice":if(!O(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"MultipleChoice",properties:s};case "Slider":if(!B(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Slider",properties:s};default:return {...p,type:i,properties:s}}}resolvePropertyValue(t,r,a,n,o=""){if(typeof t=="string"&&r.components.has(t))return this.buildNodeRecursive(t,r,a,n,o);if(I(t)){if(t.explicitList)return t.explicitList.map(l=>this.buildNodeRecursive(l,r,a,n,o));if(t.template){let l=this.resolvePath(t.template.dataBinding,n),u=this.getDataByPath(r.dataModel,l),c=t.template;return Array.isArray(u)?u.map((i,f)=>{let p=`:${[...n.split("/").filter(w=>/^\d+$/.test(w)),f].join(":")}`,R=`${l}/${f}`;return this.buildNodeRecursive(c.componentId,r,a,R,p)}):u instanceof Map?Array.from(u.keys(),i=>{let f=`:${i}`,s=`${l}/${i}`;return this.buildNodeRecursive(c.componentId,r,a,s,f)}):[]}}if(Array.isArray(t))return t.map(l=>this.resolvePropertyValue(l,r,a,n,o));if(d(t)){let l={};for(let[u,c]of Object.entries(t)){let i=c;if(D(u,c)&&n!=="/"){i=c.replace(/^\.?\/item/,"").replace(/^\.?\/text/,"").replace(/^\.?\/label/,"").replace(/^\.?\//,""),l[u]=i;continue}l[u]=this.resolvePropertyValue(i,r,a,n,o);}return l}return t}};y(m,"DEFAULT_SURFACE_ID","@default");var C=m;function X(){return new C}
+exports.A2uiMessageProcessor=C;exports.createMessageProcessor=X;exports.isAnyComponentNode=h;exports.isBooleanValue=q;exports.isComponentArrayReference=I;exports.isNumberValue=W;exports.isObject=d;exports.isPath=D;exports.isResolvedAudioPlayer=M;exports.isResolvedButton=x;exports.isResolvedCard=A;exports.isResolvedCheckbox=b;exports.isResolvedColumn=S;exports.isResolvedDateTimeInput=k;exports.isResolvedDivider=V;exports.isResolvedIcon=$;exports.isResolvedImage=T;exports.isResolvedList=P;exports.isResolvedModal=E;exports.isResolvedMultipleChoice=O;exports.isResolvedRow=j;exports.isResolvedSlider=B;exports.isResolvedTabItem=G;exports.isResolvedTabs=U;exports.isResolvedText=N;exports.isResolvedTextField=F;exports.isResolvedVideo=L;exports.isStringValue=v;exports.isValueMap=J;

package/dist/data/index.d.cts

@@ -1,2 +1,3 @@
-export { A as A2uiMessageProcessor, c as createMessageProcessor, j as isAnyComponentNode, h as isBooleanValue, e as isComponentArrayReference, g as isNumberValue, d as isObject, b as isPath, k as isResolvedAudioPlayer, l as isResolvedButton, m as isResolvedCard, n as isResolvedCheckbox, o as isResolvedColumn, p as isResolvedDateTimeInput, q as isResolvedDivider, s as isResolvedIcon, r as isResolvedImage, t as isResolvedList, u as isResolvedModal, v as isResolvedMultipleChoice, w as isResolvedRow, x as isResolvedSlider, y as isResolvedTabItem, z as isResolvedTabs, B as isResolvedText, C as isResolvedTextField, D as isResolvedVideo, f as isStringValue, a as isValueMap } from '../index-DKh6MRhF.cjs';
-import '../types-CtrG7MJe.cjs';
+export { A as A2uiMessageProcessor, c as createMessageProcessor, j as isAnyComponentNode, h as isBooleanValue, e as isComponentArrayReference, g as isNumberValue, d as isObject, b as isPath, k as isResolvedAudioPlayer, l as isResolvedButton, m as isResolvedCard, n as isResolvedCheckbox, o as isResolvedColumn, p as isResolvedDateTimeInput, q as isResolvedDivider, s as isResolvedIcon, r as isResolvedImage, t as isResolvedList, u as isResolvedModal, v as isResolvedMultipleChoice, w as isResolvedRow, x as isResolvedSlider, y as isResolvedTabItem, z as isResolvedTabs, B as isResolvedText, C as isResolvedTextField, D as isResolvedVideo, f as isStringValue, a as isValueMap } from '../index-PGBpNFSS.cjs';
+import '@zhama/a2ui-core';
+import '../types-Csi2jaoN.cjs';

package/dist/data/index.d.ts

@@ -1,2 +1,3 @@
-export { A as A2uiMessageProcessor, c as createMessageProcessor, j as isAnyComponentNode, h as isBooleanValue, e as isComponentArrayReference, g as isNumberValue, d as isObject, b as isPath, k as isResolvedAudioPlayer, l as isResolvedButton, m as isResolvedCard, n as isResolvedCheckbox, o as isResolvedColumn, p as isResolvedDateTimeInput, q as isResolvedDivider, s as isResolvedIcon, r as isResolvedImage, t as isResolvedList, u as isResolvedModal, v as isResolvedMultipleChoice, w as isResolvedRow, x as isResolvedSlider, y as isResolvedTabItem, z as isResolvedTabs, B as isResolvedText, C as isResolvedTextField, D as isResolvedVideo, f as isStringValue, a as isValueMap } from '../index-BJe-XUR4.js';
-import '../types-CtrG7MJe.js';
+export { A as A2uiMessageProcessor, c as createMessageProcessor, j as isAnyComponentNode, h as isBooleanValue, e as isComponentArrayReference, g as isNumberValue, d as isObject, b as isPath, k as isResolvedAudioPlayer, l as isResolvedButton, m as isResolvedCard, n as isResolvedCheckbox, o as isResolvedColumn, p as isResolvedDateTimeInput, q as isResolvedDivider, s as isResolvedIcon, r as isResolvedImage, t as isResolvedList, u as isResolvedModal, v as isResolvedMultipleChoice, w as isResolvedRow, x as isResolvedSlider, y as isResolvedTabItem, z as isResolvedTabs, B as isResolvedText, C as isResolvedTextField, D as isResolvedVideo, f as isStringValue, a as isValueMap } from '../index-K0C1W74m.js';
+import '@zhama/a2ui-core';
+import '../types-Csi2jaoN.js';

package/dist/data/index.js

@@ -1,2 +1,2 @@
-var K=Object.defineProperty;var W=(e,t,r)=>t in e?K(e,t,{enumerable:true,configurable:true,writable:true,value:r}):e[t]=r;var R=(e,t,r)=>W(e,typeof t!="symbol"?t+"":t,r);function G(e){return a(e)&&"key"in e}function D(e,t){return e==="path"&&typeof t=="string"}function a(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function I(e){return a(e)?"explicitList"in e||"template"in e:false}function h(e){return a(e)&&("path"in e||"literal"in e&&typeof e.literal=="string"||"literalString"in e)}function J(e){return a(e)&&("path"in e||"literal"in e&&typeof e.literal=="number"||"literalNumber"in e)}function _(e){return a(e)&&("path"in e||"literal"in e&&typeof e.literal=="boolean"||"literalBoolean"in e)}function y(e){return a(e)?"id"in e&&"type"in e&&"properties"in e:false}function M(e){return a(e)&&"url"in e&&h(e.url)}function A(e){return a(e)&&"child"in e&&y(e.child)&&"action"in e}function x(e){return a(e)?"child"in e?y(e.child):"children"in e?Array.isArray(e.children)&&e.children.every(y):false:false}function b(e){return a(e)&&"label"in e&&h(e.label)&&"value"in e&&_(e.value)}function S(e){return a(e)&&"children"in e&&Array.isArray(e.children)&&e.children.every(y)}function k(e){return a(e)&&"value"in e&&h(e.value)}function V(e){return a(e)}function T(e){return a(e)&&"url"in e&&h(e.url)}function $(e){return a(e)&&"name"in e&&h(e.name)}function P(e){return a(e)&&"children"in e&&Array.isArray(e.children)&&e.children.every(y)}function E(e){return a(e)&&"entryPointChild"in e&&y(e.entryPointChild)&&"contentChild"in e&&y(e.contentChild)}function B(e){return a(e)&&"selections"in e}function N(e){return a(e)&&"children"in e&&Array.isArray(e.children)&&e.children.every(y)}function U(e){return a(e)&&"value"in e&&J(e.value)}function z(e){return a(e)&&"title"in e&&h(e.title)&&"child"in e&&y(e.child)}function j(e){return a(e)&&"tabItems"in e&&Array.isArray(e.tabItems)&&e.tabItems.every(z)}function O(e){return a(e)&&"text"in e&&h(e.text)}function F(e){return a(e)&&"label"in e&&h(e.label)}function L(e){return a(e)&&"url"in e&&h(e.url)}var g=class g{constructor(t={}){R(this,"mapCtor",Map);R(this,"arrayCtor",Array);R(this,"setCtor",Set);R(this,"objCtor",Object);R(this,"surfaces");this.arrayCtor=t.arrayCtor??Array,this.mapCtor=t.mapCtor??Map,this.setCtor=t.setCtor??Set,this.objCtor=t.objCtor??Object,this.surfaces=new this.mapCtor;}getSurfaces(){return this.surfaces}clearSurfaces(){this.surfaces.clear();}processMessages(t){for(let r of t)r.beginRendering&&this.handleBeginRendering(r.beginRendering,r.beginRendering.surfaceId),r.surfaceUpdate&&this.handleSurfaceUpdate(r.surfaceUpdate,r.surfaceUpdate.surfaceId),r.dataModelUpdate&&this.handleDataModelUpdate(r.dataModelUpdate,r.dataModelUpdate.surfaceId),r.deleteSurface&&this.handleDeleteSurface(r.deleteSurface);}getData(t,r,n=g.DEFAULT_SURFACE_ID){let o=this.getOrCreateSurface(n);if(!o)return null;let i;return r==="."||r===""?i=t.dataContextPath??"/":i=this.resolvePath(r,t.dataContextPath),this.getDataByPath(o.dataModel,i)}setData(t,r,n,o=g.DEFAULT_SURFACE_ID){if(!t){console.warn("No component node set");return}let i=this.getOrCreateSurface(o);if(!i)return;let l;r==="."||r===""?l=t.dataContextPath??"/":l=this.resolvePath(r,t.dataContextPath),this.setDataByPath(i.dataModel,l,n);}resolvePath(t,r){return t.startsWith("/")?t:r&&r!=="/"?r.endsWith("/")?`${r}${t}`:`${r}/${t}`:`/${t}`}parseIfJsonString(t){if(typeof t!="string")return t;let r=t.trim();if(r.startsWith("{")&&r.endsWith("}")||r.startsWith("[")&&r.endsWith("]"))try{return JSON.parse(t)}catch{return console.warn(`Failed to parse potential JSON string: "${t.substring(0,50)}..."`),t}return t}convertKeyValueArrayToMap(t){let r=new this.mapCtor;for(let n of t){if(!a(n)||!("key"in n))continue;let o=n.key,i=this.findValueKey(n);if(!i)continue;let l=n[i];i==="valueMap"&&Array.isArray(l)?l=this.convertKeyValueArrayToMap(l):typeof l=="string"&&(l=this.parseIfJsonString(l)),this.setDataByPath(r,o,l);}return r}setDataByPath(t,r,n){if(Array.isArray(n)&&(n.length===0||a(n[0])&&"key"in n[0]))if(n.length===1&&a(n[0])&&n[0].key==="."){let c=n[0],u=this.findValueKey(c);u?(n=c[u],u==="valueMap"&&Array.isArray(n)?n=this.convertKeyValueArrayToMap(n):typeof n=="string"&&(n=this.parseIfJsonString(n))):n=this.convertKeyValueArrayToMap(n);}else n=this.convertKeyValueArrayToMap(n);let o=this.normalizePath(r).split("/").filter(c=>c);if(o.length===0){if(n instanceof Map||a(n)){!(n instanceof Map)&&a(n)&&(n=new this.mapCtor(Object.entries(n))),t.clear();for(let[c,u]of n.entries())t.set(c,u);}else console.error("Cannot set root of DataModel to a non-Map value.");return}let i=t;for(let c=0;c<o.length-1;c++){let u=o[c],f;i instanceof Map?f=i.get(u):Array.isArray(i)&&/^\d+$/.test(u)&&(f=i[parseInt(u,10)]),(f===void 0||typeof f!="object"||f===null)&&(f=new this.mapCtor,i instanceof this.mapCtor?i.set(u,f):Array.isArray(i)&&(i[parseInt(u,10)]=f)),i=f;}let l=o[o.length-1];i instanceof this.mapCtor?i.set(l,n):Array.isArray(i)&&/^\d+$/.test(l)&&(i[parseInt(l,10)]=n);}normalizePath(t){return "/"+t.replace(/\[(\d+)\]/g,".$1").split(".").filter(o=>o.length>0).join("/")}getDataByPath(t,r){let n=this.normalizePath(r).split("/").filter(i=>i),o=t;for(let i of n){if(o==null)return null;if(o instanceof Map)o=o.get(i);else if(Array.isArray(o)&&/^\d+$/.test(i))o=o[parseInt(i,10)];else if(a(o))o=o[i];else return null}return o??null}getOrCreateSurface(t){let r=this.surfaces.get(t);return r||(r={rootComponentId:null,componentTree:null,dataModel:new this.mapCtor,components:new this.mapCtor,styles:{}},this.surfaces.set(t,r)),r}handleBeginRendering(t,r){let n=this.getOrCreateSurface(r);n.rootComponentId=t.root,n.styles=t.styles??{},this.rebuildComponentTree(n);}handleSurfaceUpdate(t,r){let n=this.getOrCreateSurface(r);for(let o of t.components)n.components.set(o.id,o);this.rebuildComponentTree(n);}handleDataModelUpdate(t,r){let n=this.getOrCreateSurface(r),o=t.path??"/";this.setDataByPath(n.dataModel,o,t.contents),this.rebuildComponentTree(n);}handleDeleteSurface(t){this.surfaces.delete(t.surfaceId);}rebuildComponentTree(t){if(!t.rootComponentId){t.componentTree=null;return}let r=new this.setCtor;t.componentTree=this.buildNodeRecursive(t.rootComponentId,t,r,"/","");}findValueKey(t){return Object.keys(t).find(r=>r.startsWith("value"))}buildNodeRecursive(t,r,n,o,i=""){let l=`${t}${i}`,{components:c}=r;if(!c.has(t))return null;if(n.has(l))throw new Error(`Circular dependency for component "${l}".`);n.add(l);let u=c.get(t),f=u.component??{},d=Object.keys(f)[0]??"Unknown",m=f[d],s={};if(a(m))for(let[v,w]of Object.entries(m))s[v]=this.resolvePropertyValue(w,r,n,o,i);n.delete(l);let p={id:l,dataContextPath:o,weight:u.weight??"initial"};switch(d){case "Text":if(!O(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Text",properties:s};case "Image":if(!T(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Image",properties:s};case "Icon":if(!$(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Icon",properties:s};case "Video":if(!L(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Video",properties:s};case "AudioPlayer":if(!M(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"AudioPlayer",properties:s};case "Row":if(!N(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Row",properties:s};case "Column":if(!S(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Column",properties:s};case "List":if(!P(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"List",properties:s};case "Card":if(!x(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Card",properties:s};case "Tabs":if(!j(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Tabs",properties:s};case "Divider":if(!V(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Divider",properties:s};case "Modal":if(!E(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Modal",properties:s};case "Button":if(!A(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Button",properties:s};case "CheckBox":if(!b(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"CheckBox",properties:s};case "TextField":if(!F(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"TextField",properties:s};case "DateTimeInput":if(!k(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"DateTimeInput",properties:s};case "MultipleChoice":if(!B(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"MultipleChoice",properties:s};case "Slider":if(!U(s))throw new Error(`Invalid data; expected ${d}`);return {...p,type:"Slider",properties:s};default:return {...p,type:d,properties:s}}}resolvePropertyValue(t,r,n,o,i=""){if(typeof t=="string"&&r.components.has(t))return this.buildNodeRecursive(t,r,n,o,i);if(I(t)){if(t.explicitList)return t.explicitList.map(l=>this.buildNodeRecursive(l,r,n,o,i));if(t.template){let l=this.resolvePath(t.template.dataBinding,o),c=this.getDataByPath(r.dataModel,l),u=t.template;return Array.isArray(c)?c.map((f,d)=>{let p=`:${[...o.split("/").filter(w=>/^\d+$/.test(w)),d].join(":")}`,v=`${l}/${d}`;return this.buildNodeRecursive(u.componentId,r,n,v,p)}):c instanceof Map?Array.from(c.keys(),f=>{let d=`:${f}`,m=`${l}/${f}`;return this.buildNodeRecursive(u.componentId,r,n,m,d)}):[]}}if(Array.isArray(t))return t.map(l=>this.resolvePropertyValue(l,r,n,o,i));if(a(t)){let l={};for(let[c,u]of Object.entries(t)){let f=u;if(D(c,u)&&o!=="/"){f=u.replace(/^\.?\/item/,"").replace(/^\.?\/text/,"").replace(/^\.?\/label/,"").replace(/^\.?\//,""),l[c]=f;continue}l[c]=this.resolvePropertyValue(f,r,n,o,i);}return l}return t}};R(g,"DEFAULT_SURFACE_ID","@default");var C=g;function X(){return new C}
-export{C as A2uiMessageProcessor,X as createMessageProcessor,y as isAnyComponentNode,_ as isBooleanValue,I as isComponentArrayReference,J as isNumberValue,a as isObject,D as isPath,M as isResolvedAudioPlayer,A as isResolvedButton,x as isResolvedCard,b as isResolvedCheckbox,S as isResolvedColumn,k as isResolvedDateTimeInput,V as isResolvedDivider,$ as isResolvedIcon,T as isResolvedImage,P as isResolvedList,E as isResolvedModal,B as isResolvedMultipleChoice,N as isResolvedRow,U as isResolvedSlider,z as isResolvedTabItem,j as isResolvedTabs,O as isResolvedText,F as isResolvedTextField,L as isResolvedVideo,h as isStringValue,G as isValueMap};
+var z=Object.defineProperty;var _=(e,t,r)=>t in e?z(e,t,{enumerable:true,configurable:true,writable:true,value:r}):e[t]=r;var y=(e,t,r)=>_(e,typeof t!="symbol"?t+"":t,r);function J(e){return d(e)}function D(e,t){return e==="path"&&typeof t=="string"}function d(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function I(e){return d(e)?"explicitList"in e||"template"in e:false}function v(e){return !!(typeof e=="string"||d(e)&&"path"in e&&typeof e.path=="string")}function W(e){return !!(typeof e=="number"||d(e)&&"path"in e&&typeof e.path=="string")}function q(e){return !!(typeof e=="boolean"||d(e)&&"path"in e&&typeof e.path=="string")}function h(e){return d(e)?"id"in e&&"type"in e&&"properties"in e:false}function M(e){return d(e)&&"url"in e&&v(e.url)}function x(e){return d(e)&&"child"in e&&h(e.child)&&"action"in e}function A(e){return d(e)?"child"in e?h(e.child):"children"in e?Array.isArray(e.children)&&e.children.every(h):false:false}function b(e){return d(e)&&"label"in e&&v(e.label)&&"value"in e&&q(e.value)}function S(e){return d(e)&&"children"in e&&Array.isArray(e.children)&&e.children.every(h)}function k(e){return d(e)&&"value"in e&&v(e.value)}function V(e){return d(e)}function T(e){return d(e)&&"url"in e&&v(e.url)}function $(e){return d(e)&&"name"in e&&v(e.name)}function P(e){return d(e)&&"children"in e&&Array.isArray(e.children)&&e.children.every(h)}function E(e){return d(e)&&"entryPointChild"in e&&h(e.entryPointChild)&&"contentChild"in e&&h(e.contentChild)}function O(e){return d(e)&&"selections"in e}function j(e){return d(e)&&"children"in e&&Array.isArray(e.children)&&e.children.every(h)}function B(e){return d(e)&&"value"in e&&W(e.value)}function G(e){return d(e)&&"title"in e&&v(e.title)&&"child"in e&&h(e.child)}function U(e){return d(e)&&"tabItems"in e&&Array.isArray(e.tabItems)&&e.tabItems.every(G)}function N(e){return d(e)&&"text"in e&&v(e.text)}function F(e){return d(e)&&"label"in e&&v(e.label)}function L(e){return d(e)&&"url"in e&&v(e.url)}var m=class m{constructor(t={}){y(this,"mapCtor",Map);y(this,"arrayCtor",Array);y(this,"setCtor",Set);y(this,"objCtor",Object);y(this,"surfaces");this.arrayCtor=t.arrayCtor??Array,this.mapCtor=t.mapCtor??Map,this.setCtor=t.setCtor??Set,this.objCtor=t.objCtor??Object,this.surfaces=new this.mapCtor;}getSurfaces(){return this.surfaces}clearSurfaces(){this.surfaces.clear();}processMessages(t){console.log("[A2UI] processMessages called with",t.length,"messages");for(let r of t)"createSurface"in r?this.handleCreateSurface(r):"updateComponents"in r?this.handleUpdateComponents(r):"updateDataModel"in r?this.handleUpdateDataModel(r):"deleteSurface"in r?this.handleDeleteSurface(r):console.warn("[A2UI] Unknown message type:",Object.keys(r));}getData(t,r,a=m.DEFAULT_SURFACE_ID){let n=this.getOrCreateSurface(a);if(!n)return console.warn("[A2UI] getData: surface not found:",a),null;let o;return r==="."||r===""?o=t.dataContextPath??"/":o=this.resolvePath(r,t.dataContextPath),this.getDataByPath(n.dataModel,o)}setData(t,r,a,n=m.DEFAULT_SURFACE_ID){if(!t){console.warn("No component node set");return}let o=this.getOrCreateSurface(n);if(!o)return;let l;r==="."||r===""?l=t.dataContextPath??"/":l=this.resolvePath(r,t.dataContextPath),this.setDataByPath(o.dataModel,l,a);}resolvePath(t,r){return t.startsWith("/")?t:r&&r!=="/"?r.endsWith("/")?`${r}${t}`:`${r}/${t}`:`/${t}`}handleCreateSurface(t){let{createSurface:r}=t,a=r.surfaceId,n=this.getOrCreateSurface(a);n.catalogId=r.catalogId;}handleUpdateComponents(t){let{updateComponents:r}=t,a=r.surfaceId,n=this.getOrCreateSurface(a);for(let o of r.components)n.components.set(o.id,o),n.rootComponentId||(n.rootComponentId=o.id);this.rebuildComponentTree(n);}handleUpdateDataModel(t){let{updateDataModel:r}=t,a=r.surfaceId,n=this.getOrCreateSurface(a),o=r.path??"/",l=r.op??"replace",u=r.value;l==="remove"?this.removeDataByPath(n.dataModel,o):u!==void 0&&this.setDataByPath(n.dataModel,o,u),this.rebuildComponentTree(n);}handleDeleteSurface(t){let{deleteSurface:r}=t;this.surfaces.delete(r.surfaceId);}setDataByPath(t,r,a){let n=this.normalizePath(r).split("/").filter(u=>u);if(n.length===0){if(d(a)&&!(a instanceof Map)){t.clear();for(let[u,c]of Object.entries(a))t.set(u,c);}return}let o=t;for(let u=0;u<n.length-1;u++){let c=n[u],i;if(o instanceof Map?i=o.get(c):Array.isArray(o)&&/^\d+$/.test(c)&&(i=o[parseInt(c,10)]),i===void 0||typeof i!="object"||i===null){let f=new this.mapCtor;o instanceof Map?o.set(c,f):Array.isArray(o)&&(o[parseInt(c,10)]=f),i=f;}o=i;}let l=n[n.length-1];o instanceof Map?o.set(l,a):Array.isArray(o)&&/^\d+$/.test(l)&&(o[parseInt(l,10)]=a);}removeDataByPath(t,r){let a=this.normalizePath(r).split("/").filter(l=>l);if(a.length===0){t.clear();return}let n=t;for(let l=0;l<a.length-1;l++){let u=a[l],c;if(n instanceof Map?c=n.get(u):Array.isArray(n)&&/^\d+$/.test(u)&&(c=n[parseInt(u,10)]),c===void 0||typeof c!="object"||c===null)return;n=c;}let o=a[a.length-1];n instanceof Map&&n.delete(o);}normalizePath(t){return "/"+t.replace(/\[(\d+)\]/g,".$1").split(".").filter(n=>n.length>0).join("/")}getDataByPath(t,r){let a=this.normalizePath(r).split("/").filter(o=>o),n=t;for(let o of a){if(n==null)return null;if(n instanceof Map)n=n.get(o);else if(Array.isArray(n)&&/^\d+$/.test(o))n=n[parseInt(o,10)];else if(d(n))n=n[o];else return null}return n??null}getOrCreateSurface(t){let r=this.surfaces.get(t);return r||(r={rootComponentId:null,componentTree:null,dataModel:new this.mapCtor,components:new this.mapCtor,styles:{}},this.surfaces.set(t,r)),r}rebuildComponentTree(t){if(!t.rootComponentId){t.componentTree=null;return}let r=new this.setCtor;t.componentTree=this.buildNodeRecursive(t.rootComponentId,t,r,"/","");}buildNodeRecursive(t,r,a,n,o=""){let l=`${t}${o}`,{components:u}=r;if(!u.has(t))return null;if(a.has(l))throw new Error(`Circular dependency for component "${l}".`);a.add(l);let c=u.get(t),i=c.component,f={...c};delete f.id,delete f.component;let s={};for(let[R,w]of Object.entries(f))s[R]=this.resolvePropertyValue(w,r,a,n,o);a.delete(l);let g=c.weight,p={id:l,dataContextPath:n,weight:typeof g=="number"||typeof g=="string"?g:void 0};switch(i){case "Text":if(!N(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Text",properties:s};case "Image":if(!T(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Image",properties:s};case "Icon":if(!$(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Icon",properties:s};case "Video":if(!L(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Video",properties:s};case "AudioPlayer":if(!M(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"AudioPlayer",properties:s};case "Row":if(!j(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Row",properties:s};case "Column":if(!S(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Column",properties:s};case "List":if(!P(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"List",properties:s};case "Card":if(!A(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Card",properties:s};case "Tabs":if(!U(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Tabs",properties:s};case "Divider":if(!V(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Divider",properties:s};case "Modal":if(!E(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Modal",properties:s};case "Button":if(!x(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Button",properties:s};case "CheckBox":if(!b(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"CheckBox",properties:s};case "TextField":if(!F(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"TextField",properties:s};case "DateTimeInput":if(!k(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"DateTimeInput",properties:s};case "MultipleChoice":if(!O(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"MultipleChoice",properties:s};case "Slider":if(!B(s))throw new Error(`Invalid data; expected ${i}`);return {...p,type:"Slider",properties:s};default:return {...p,type:i,properties:s}}}resolvePropertyValue(t,r,a,n,o=""){if(typeof t=="string"&&r.components.has(t))return this.buildNodeRecursive(t,r,a,n,o);if(I(t)){if(t.explicitList)return t.explicitList.map(l=>this.buildNodeRecursive(l,r,a,n,o));if(t.template){let l=this.resolvePath(t.template.dataBinding,n),u=this.getDataByPath(r.dataModel,l),c=t.template;return Array.isArray(u)?u.map((i,f)=>{let p=`:${[...n.split("/").filter(w=>/^\d+$/.test(w)),f].join(":")}`,R=`${l}/${f}`;return this.buildNodeRecursive(c.componentId,r,a,R,p)}):u instanceof Map?Array.from(u.keys(),i=>{let f=`:${i}`,s=`${l}/${i}`;return this.buildNodeRecursive(c.componentId,r,a,s,f)}):[]}}if(Array.isArray(t))return t.map(l=>this.resolvePropertyValue(l,r,a,n,o));if(d(t)){let l={};for(let[u,c]of Object.entries(t)){let i=c;if(D(u,c)&&n!=="/"){i=c.replace(/^\.?\/item/,"").replace(/^\.?\/text/,"").replace(/^\.?\/label/,"").replace(/^\.?\//,""),l[u]=i;continue}l[u]=this.resolvePropertyValue(i,r,a,n,o);}return l}return t}};y(m,"DEFAULT_SURFACE_ID","@default");var C=m;function X(){return new C}
+export{C as A2uiMessageProcessor,X as createMessageProcessor,h as isAnyComponentNode,q as isBooleanValue,I as isComponentArrayReference,W as isNumberValue,d as isObject,D as isPath,M as isResolvedAudioPlayer,x as isResolvedButton,A as isResolvedCard,b as isResolvedCheckbox,S as isResolvedColumn,k as isResolvedDateTimeInput,V as isResolvedDivider,$ as isResolvedIcon,T as isResolvedImage,P as isResolvedList,E as isResolvedModal,O as isResolvedMultipleChoice,j as isResolvedRow,B as isResolvedSlider,G as isResolvedTabItem,U as isResolvedTabs,N as isResolvedText,F as isResolvedTextField,L as isResolvedVideo,v as isStringValue,J as isValueMap};

package/dist/events/index.d.cts

@@ -1,2 +1,3 @@
-export { A as A2UIAction, a as A2UIEventDetailMap, b as A2UIEventType, c as A2UI_EVENT_NAME, B as BaseEventDetail } from '../a2ui-vyxwZCoa.cjs';
-import '../types-CtrG7MJe.cjs';
+export { A as A2UIAction, a as A2UIEventDetailMap, b as A2UIEventType, c as A2UI_EVENT_NAME, B as BaseEventDetail } from '../a2ui-Dpl-E-Do.cjs';
+import '@zhama/a2ui-core';
+import '../types-Csi2jaoN.cjs';

package/dist/events/index.d.ts

@@ -1,2 +1,3 @@
-export { A as A2UIAction, a as A2UIEventDetailMap, b as A2UIEventType, c as A2UI_EVENT_NAME, B as BaseEventDetail } from '../a2ui-CnaCcq4c.js';
-import '../types-CtrG7MJe.js';
+export { A as A2UIAction, a as A2UIEventDetailMap, b as A2UIEventType, c as A2UI_EVENT_NAME, B as BaseEventDetail } from '../a2ui-CZYqbeoz.js';
+import '@zhama/a2ui-core';
+import '../types-Csi2jaoN.js';

package/dist/index-BvhdLkQ7.d.ts

@@ -0,0 +1,111 @@
+import { ClientToServerMessage, Theme, A2UI_EXTENSION_URI, A2UI_MIME_TYPE, Action, AnyComponent, AudioPlayerComponent, BooleanOrPath, ButtonComponent, CardComponent, CheckBoxComponent, ChildrenProperty, ChoicePickerComponent, ColumnComponent, ComponentInstance, ComponentType, CreateSurfaceMessage, DataArray, DataChangeEvent, DataObject, DataValue, DateTimeInputComponent, DeleteSurfaceMessage, DividerComponent, IconComponent, ImageComponent, ListComponent, ModalComponent, NumberOrPath, RowComponent, STANDARD_CATALOG_ID, ServerToClientMessageV09, SliderComponent, StringArrayOrPath, StringOrPath, TabsComponent, TextComponent, TextFieldComponent, UpdateComponentsMessage, UpdateDataModelMessage, UserActionEvent, VideoComponent, isV09Message } from '@zhama/a2ui-core';
+import { A as AnyComponentNode, g as AudioPlayerNode, B as ButtonNode, j as CardNode, n as CheckboxNode, _ as ClientCapabilitiesDynamic, i as ColumnNode, a as ComponentArrayReference, C as ComponentArrayTemplate, b as ComponentProperties, r as CustomNode, X as CustomNodeProperties, D as DataMap, p as DateTimeInputNode, l as DividerNode, f as IconNode, I as ImageNode, L as ListNode, M as MessageProcessor, m as ModalNode, q as MultipleChoiceNode, d as ResolvedArray, w as ResolvedAudioPlayer, K as ResolvedButton, O as ResolvedCard, y as ResolvedCheckbox, J as ResolvedColumn, E as ResolvedDateTimeInput, x as ResolvedDivider, t as ResolvedIcon, u as ResolvedImage, N as ResolvedList, c as ResolvedMap, W as ResolvedModal, F as ResolvedMultipleChoice, H as ResolvedRow, G as ResolvedSlider, P as ResolvedTabItem, Q as ResolvedTabs, s as ResolvedText, z as ResolvedTextField, R as ResolvedValue, v as ResolvedVideo, h as RowNode, $ as ServerToClientMessage, S as SliderNode, Z as Surface, Y as SurfaceID, k as TabsNode, o as TextFieldNode, e as TextNode, T as Theme$1, U as UserAction, V as VideoNode } from './types-Csi2jaoN.js';
+
+/**
+ * A2UI Types Module - v0.9 Protocol
+ *
+ * 类型分层：
+ * - 协议类型：从 @zhama/a2ui-core 重导出
+ * - 渲染器类型：本包特有的类型（组件节点、解析值等）
+ */
+
+declare const index_A2UI_EXTENSION_URI: typeof A2UI_EXTENSION_URI;
+declare const index_A2UI_MIME_TYPE: typeof A2UI_MIME_TYPE;
+declare const index_Action: typeof Action;
+declare const index_AnyComponent: typeof AnyComponent;
+declare const index_AnyComponentNode: typeof AnyComponentNode;
+declare const index_AudioPlayerComponent: typeof AudioPlayerComponent;
+declare const index_AudioPlayerNode: typeof AudioPlayerNode;
+declare const index_BooleanOrPath: typeof BooleanOrPath;
+declare const index_ButtonComponent: typeof ButtonComponent;
+declare const index_ButtonNode: typeof ButtonNode;
+declare const index_CardComponent: typeof CardComponent;
+declare const index_CardNode: typeof CardNode;
+declare const index_CheckBoxComponent: typeof CheckBoxComponent;
+declare const index_CheckboxNode: typeof CheckboxNode;
+declare const index_ChildrenProperty: typeof ChildrenProperty;
+declare const index_ChoicePickerComponent: typeof ChoicePickerComponent;
+declare const index_ClientCapabilitiesDynamic: typeof ClientCapabilitiesDynamic;
+declare const index_ClientToServerMessage: typeof ClientToServerMessage;
+declare const index_ColumnComponent: typeof ColumnComponent;
+declare const index_ColumnNode: typeof ColumnNode;
+declare const index_ComponentArrayReference: typeof ComponentArrayReference;
+declare const index_ComponentArrayTemplate: typeof ComponentArrayTemplate;
+declare const index_ComponentInstance: typeof ComponentInstance;
+declare const index_ComponentProperties: typeof ComponentProperties;
+declare const index_ComponentType: typeof ComponentType;
+declare const index_CreateSurfaceMessage: typeof CreateSurfaceMessage;
+declare const index_CustomNode: typeof CustomNode;
+declare const index_CustomNodeProperties: typeof CustomNodeProperties;
+declare const index_DataArray: typeof DataArray;
+declare const index_DataChangeEvent: typeof DataChangeEvent;
+declare const index_DataMap: typeof DataMap;
+declare const index_DataObject: typeof DataObject;
+declare const index_DataValue: typeof DataValue;
+declare const index_DateTimeInputComponent: typeof DateTimeInputComponent;
+declare const index_DateTimeInputNode: typeof DateTimeInputNode;
+declare const index_DeleteSurfaceMessage: typeof DeleteSurfaceMessage;
+declare const index_DividerComponent: typeof DividerComponent;
+declare const index_DividerNode: typeof DividerNode;
+declare const index_IconComponent: typeof IconComponent;
+declare const index_IconNode: typeof IconNode;
+declare const index_ImageComponent: typeof ImageComponent;
+declare const index_ImageNode: typeof ImageNode;
+declare const index_ListComponent: typeof ListComponent;
+declare const index_ListNode: typeof ListNode;
+declare const index_MessageProcessor: typeof MessageProcessor;
+declare const index_ModalComponent: typeof ModalComponent;
+declare const index_ModalNode: typeof ModalNode;
+declare const index_MultipleChoiceNode: typeof MultipleChoiceNode;
+declare const index_NumberOrPath: typeof NumberOrPath;
+declare const index_ResolvedArray: typeof ResolvedArray;
+declare const index_ResolvedAudioPlayer: typeof ResolvedAudioPlayer;
+declare const index_ResolvedButton: typeof ResolvedButton;
+declare const index_ResolvedCard: typeof ResolvedCard;
+declare const index_ResolvedCheckbox: typeof ResolvedCheckbox;
+declare const index_ResolvedColumn: typeof ResolvedColumn;
+declare const index_ResolvedDateTimeInput: typeof ResolvedDateTimeInput;
+declare const index_ResolvedDivider: typeof ResolvedDivider;
+declare const index_ResolvedIcon: typeof ResolvedIcon;
+declare const index_ResolvedImage: typeof ResolvedImage;
+declare const index_ResolvedList: typeof ResolvedList;
+declare const index_ResolvedMap: typeof ResolvedMap;
+declare const index_ResolvedModal: typeof ResolvedModal;
+declare const index_ResolvedMultipleChoice: typeof ResolvedMultipleChoice;
+declare const index_ResolvedRow: typeof ResolvedRow;
+declare const index_ResolvedSlider: typeof ResolvedSlider;
+declare const index_ResolvedTabItem: typeof ResolvedTabItem;
+declare const index_ResolvedTabs: typeof ResolvedTabs;
+declare const index_ResolvedText: typeof ResolvedText;
+declare const index_ResolvedTextField: typeof ResolvedTextField;
+declare const index_ResolvedValue: typeof ResolvedValue;
+declare const index_ResolvedVideo: typeof ResolvedVideo;
+declare const index_RowComponent: typeof RowComponent;
+declare const index_RowNode: typeof RowNode;
+declare const index_STANDARD_CATALOG_ID: typeof STANDARD_CATALOG_ID;
+declare const index_ServerToClientMessage: typeof ServerToClientMessage;
+declare const index_ServerToClientMessageV09: typeof ServerToClientMessageV09;
+declare const index_SliderComponent: typeof SliderComponent;
+declare const index_SliderNode: typeof SliderNode;
+declare const index_StringArrayOrPath: typeof StringArrayOrPath;
+declare const index_StringOrPath: typeof StringOrPath;
+declare const index_Surface: typeof Surface;
+declare const index_SurfaceID: typeof SurfaceID;
+declare const index_TabsComponent: typeof TabsComponent;
+declare const index_TabsNode: typeof TabsNode;
+declare const index_TextComponent: typeof TextComponent;
+declare const index_TextFieldComponent: typeof TextFieldComponent;
+declare const index_TextFieldNode: typeof TextFieldNode;
+declare const index_TextNode: typeof TextNode;
+declare const index_UpdateComponentsMessage: typeof UpdateComponentsMessage;
+declare const index_UpdateDataModelMessage: typeof UpdateDataModelMessage;
+declare const index_UserAction: typeof UserAction;
+declare const index_UserActionEvent: typeof UserActionEvent;
+declare const index_VideoComponent: typeof VideoComponent;
+declare const index_VideoNode: typeof VideoNode;
+declare const index_isV09Message: typeof isV09Message;
+declare namespace index {
+  export { ClientToServerMessage as A2UIClientEventMessage, Theme as A2UITheme, index_A2UI_EXTENSION_URI as A2UI_EXTENSION_URI, index_A2UI_MIME_TYPE as A2UI_MIME_TYPE, index_Action as Action, index_AnyComponent as AnyComponent, index_AnyComponentNode as AnyComponentNode, AudioPlayerComponent as AudioPlayer, index_AudioPlayerComponent as AudioPlayerComponent, index_AudioPlayerNode as AudioPlayerNode, index_BooleanOrPath as BooleanOrPath, ButtonComponent as Button, index_ButtonComponent as ButtonComponent, index_ButtonNode as ButtonNode, index_CardComponent as CardComponent, index_CardNode as CardNode, index_CheckBoxComponent as CheckBoxComponent, CheckBoxComponent as Checkbox, index_CheckboxNode as CheckboxNode, index_ChildrenProperty as ChildrenProperty, index_ChoicePickerComponent as ChoicePickerComponent, index_ClientCapabilitiesDynamic as ClientCapabilitiesDynamic, index_ClientToServerMessage as ClientToServerMessage, index_ColumnComponent as ColumnComponent, index_ColumnNode as ColumnNode, index_ComponentArrayReference as ComponentArrayReference, index_ComponentArrayTemplate as ComponentArrayTemplate, index_ComponentInstance as ComponentInstance, index_ComponentProperties as ComponentProperties, index_ComponentType as ComponentType, index_CreateSurfaceMessage as CreateSurfaceMessage, index_CustomNode as CustomNode, index_CustomNodeProperties as CustomNodeProperties, index_DataArray as DataArray, index_DataChangeEvent as DataChangeEvent, index_DataMap as DataMap, index_DataObject as DataObject, index_DataValue as DataValue, DateTimeInputComponent as DateTimeInput, index_DateTimeInputComponent as DateTimeInputComponent, index_DateTimeInputNode as DateTimeInputNode, index_DeleteSurfaceMessage as DeleteSurfaceMessage, DividerComponent as Divider, index_DividerComponent as DividerComponent, index_DividerNode as DividerNode, IconComponent as Icon, index_IconComponent as IconComponent, index_IconNode as IconNode, ImageComponent as Image, index_ImageComponent as ImageComponent, index_ImageNode as ImageNode, index_ListComponent as ListComponent, index_ListNode as ListNode, index_MessageProcessor as MessageProcessor, ModalComponent as Modal, index_ModalComponent as ModalComponent, index_ModalNode as ModalNode, ChoicePickerComponent as MultipleChoice, index_MultipleChoiceNode as MultipleChoiceNode, index_NumberOrPath as NumberOrPath, index_ResolvedArray as ResolvedArray, index_ResolvedAudioPlayer as ResolvedAudioPlayer, index_ResolvedButton as ResolvedButton, index_ResolvedCard as ResolvedCard, index_ResolvedCheckbox as ResolvedCheckbox, index_ResolvedColumn as ResolvedColumn, index_ResolvedDateTimeInput as ResolvedDateTimeInput, index_ResolvedDivider as ResolvedDivider, index_ResolvedIcon as ResolvedIcon, index_ResolvedImage as ResolvedImage, index_ResolvedList as ResolvedList, index_ResolvedMap as ResolvedMap, index_ResolvedModal as ResolvedModal, index_ResolvedMultipleChoice as ResolvedMultipleChoice, index_ResolvedRow as ResolvedRow, index_ResolvedSlider as ResolvedSlider, index_ResolvedTabItem as ResolvedTabItem, index_ResolvedTabs as ResolvedTabs, index_ResolvedText as ResolvedText, index_ResolvedTextField as ResolvedTextField, index_ResolvedValue as ResolvedValue, index_ResolvedVideo as ResolvedVideo, index_RowComponent as RowComponent, index_RowNode as RowNode, index_STANDARD_CATALOG_ID as STANDARD_CATALOG_ID, index_ServerToClientMessage as ServerToClientMessage, index_ServerToClientMessageV09 as ServerToClientMessageV09, SliderComponent as Slider, index_SliderComponent as SliderComponent, index_SliderNode as SliderNode, index_StringArrayOrPath as StringArrayOrPath, index_StringOrPath as StringOrPath, index_Surface as Surface, index_SurfaceID as SurfaceID, TabsComponent as Tabs, index_TabsComponent as TabsComponent, index_TabsNode as TabsNode, TextComponent as Text, index_TextComponent as TextComponent, TextFieldComponent as TextField, index_TextFieldComponent as TextFieldComponent, index_TextFieldNode as TextFieldNode, index_TextNode as TextNode, Theme$1 as Theme, index_UpdateComponentsMessage as UpdateComponentsMessage, index_UpdateDataModelMessage as UpdateDataModelMessage, index_UserAction as UserAction, index_UserActionEvent as UserActionEvent, VideoComponent as Video, index_VideoComponent as VideoComponent, index_VideoNode as VideoNode, index_isV09Message as isV09Message };
+}
+
+export { index as i };

package/dist/{index-DCv59E9u.d.cts → index-CWQNUF1X.d.ts}

@@ -1,7 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { E as AnyComponentNode, i as MessageProcessor, ao as SurfaceID, a4 as ResolvedText, a6 as ResolvedImage, a5 as ResolvedIcon, a7 as ResolvedVideo, a8 as ResolvedAudioPlayer, ah as ResolvedButton, af as ResolvedRow, ag as ResolvedColumn, ai as ResolvedList, S as StringValue, a9 as ResolvedDivider, aa as ResolvedCheckbox, ab as ResolvedTextField, ac as ResolvedDateTimeInput, ad as ResolvedMultipleChoice, ae as ResolvedSlider, ap as Surface$1, N as NumberValue } from './types-CtrG7MJe.cjs';
+import { A as AnyComponentNode, M as MessageProcessor, Y as SurfaceID, s as ResolvedText, u as ResolvedImage, t as ResolvedIcon, v as ResolvedVideo, w as ResolvedAudioPlayer, K as ResolvedButton, H as ResolvedRow, J as ResolvedColumn, N as ResolvedList, x as ResolvedDivider, y as ResolvedCheckbox, z as ResolvedTextField, E as ResolvedDateTimeInput, F as ResolvedMultipleChoice, G as ResolvedSlider, Z as Surface$1 } from './types-Csi2jaoN.js';
 import { ReactNode, ComponentType } from 'react';
-import { A as A2UIAction } from './a2ui-vyxwZCoa.cjs';
+import { A as A2UIAction } from './a2ui-CZYqbeoz.js';
+import * as _zhama_a2ui_core from '@zhama/a2ui-core';
+import { StringOrPath, NumberOrPath } from '@zhama/a2ui-core';
 
 interface TextProps {
     component: AnyComponentNode;
@@ -97,9 +99,14 @@ interface ListProps {
     processor: MessageProcessor | null;
     surfaceId: SurfaceID | null;
     direction?: ResolvedList['direction'];
+    /**
+     * 网格列数（仅在 direction='grid' 时生效）
+     * @default 2
+     */
+    columns?: number;
     children?: ReactNode;
 }
-declare function List({ direction, children }: ListProps): react_jsx_runtime.JSX.Element;
+declare function List({ component, direction, columns, children }: ListProps): react_jsx_runtime.JSX.Element;
 
 interface CardProps {
     component: AnyComponentNode;
@@ -107,7 +114,9 @@ interface CardProps {
     surfaceId: SurfaceID | null;
     children?: ReactNode;
 }
-declare function Card({ children }: CardProps): react_jsx_runtime.JSX.Element;
+declare function Card({ component, children }: CardProps): react_jsx_runtime.JSX.Element;
+
+type StringValue = _zhama_a2ui_core.StringOrPath;
 
 interface TabsProps {
     component: AnyComponentNode;
@@ -152,10 +161,10 @@ interface TextFieldProps {
     surfaceId: SurfaceID | null;
     label: ResolvedTextField['label'];
     text?: ResolvedTextField['text'];
-    type?: ResolvedTextField['type'];
+    usageHint?: ResolvedTextField['usageHint'];
     validationRegexp?: ResolvedTextField['validationRegexp'];
 }
-declare function TextField({ component, processor, surfaceId, label, text, type, }: TextFieldProps): react_jsx_runtime.JSX.Element;
+declare function TextField({ component, processor, surfaceId, label, text, usageHint, }: TextFieldProps): react_jsx_runtime.JSX.Element;
 
 interface DateTimeInputProps {
     component: AnyComponentNode;
@@ -171,21 +180,23 @@ interface MultipleChoiceProps {
     component: AnyComponentNode;
     processor: MessageProcessor | null;
     surfaceId: SurfaceID | null;
-    selections: ResolvedMultipleChoice['selections'];
+    value?: ResolvedMultipleChoice['value'];
     options?: ResolvedMultipleChoice['options'];
-    maxAllowedSelections?: ResolvedMultipleChoice['maxAllowedSelections'];
+    label?: ResolvedMultipleChoice['label'];
+    usageHint?: ResolvedMultipleChoice['usageHint'];
 }
-declare function MultipleChoice({ component, processor, surfaceId, selections, options, }: MultipleChoiceProps): react_jsx_runtime.JSX.Element;
+declare function MultipleChoice({ component, processor, surfaceId, value, options, label, }: MultipleChoiceProps): react_jsx_runtime.JSX.Element;
 
 interface SliderProps {
     component: AnyComponentNode;
     processor: MessageProcessor | null;
     surfaceId: SurfaceID | null;
     value: ResolvedSlider['value'];
-    minValue?: ResolvedSlider['minValue'];
-    maxValue?: ResolvedSlider['maxValue'];
+    min?: ResolvedSlider['min'];
+    max?: ResolvedSlider['max'];
+    label?: ResolvedSlider['label'];
 }
-declare function Slider({ component, processor, surfaceId, value, minValue, maxValue, }: SliderProps): react_jsx_runtime.JSX.Element;
+declare function Slider({ component, processor, surfaceId, value, min, max, }: SliderProps): react_jsx_runtime.JSX.Element;
 
 interface RootProps {
     processor: MessageProcessor | null;
@@ -204,14 +215,48 @@ interface ComponentRendererProps {
 }
 declare function ComponentRenderer({ component, processor, surfaceId, enableCustomElements, onAction, }: ComponentRendererProps): ReactNode;
 
+/**
+ * Primary 色阶覆盖配置
+ * 用于自定义 A2UI 组件的主题色
+ */
+interface PrimaryColorScale {
+    '--p-5'?: string;
+    '--p-10'?: string;
+    '--p-15'?: string;
+    '--p-20'?: string;
+    '--p-25'?: string;
+    '--p-30'?: string;
+    '--p-35'?: string;
+    '--p-40'?: string;
+    '--p-50'?: string;
+    '--p-60'?: string;
+    '--p-70'?: string;
+    '--p-80'?: string;
+    '--p-90'?: string;
+    '--p-95'?: string;
+}
 interface SurfaceProps {
     surfaceId: SurfaceID;
     surface: Surface$1 | null;
     processor: MessageProcessor | null;
     enableCustomElements?: boolean;
     onAction?: (event: A2UIAction) => void;
+    /**
+     * 主题色覆盖
+     * 传入 CSS 变量覆盖 A2UI 默认的 primary 色阶
+     * @example
+     * ```tsx
+     * <Surface
+     *   themeColors={{
+     *     '--p-35': 'oklch(72% 0.16 250)',
+     *     '--p-50': 'oklch(63% 0.19 250)',
+     *   }}
+     * />
+     * ```
+     */
+    themeColors?: PrimaryColorScale;
 }
-declare function Surface({ surfaceId, surface, processor, enableCustomElements, onAction, }: SurfaceProps): react_jsx_runtime.JSX.Element | null;
+declare function Surface({ surfaceId, surface, processor, enableCustomElements, onAction, themeColors, }: SurfaceProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * A2UI Component Registry
@@ -274,21 +319,21 @@ declare function Markdown({ children, className }: MarkdownProps): react_jsx_run
 declare function renderMarkdown(value: string): ReactNode;
 
 /**
- * A2UI UI Utilities
+ * A2UI UI Utilities - v0.9 Protocol
  */
 
 /**
- * 从 StringValue 提取实际字符串值
+ * 从 StringOrPath 提取实际字符串值 (v0.9 格式)
  */
-declare function extractStringValue(val: StringValue | null, component: AnyComponentNode | null, processor: MessageProcessor | null, surfaceId: string | null): string;
+declare function extractStringValue(val: StringOrPath | null, component: AnyComponentNode | null, processor: MessageProcessor | null, surfaceId: string | null): string;
 /**
- * 从 NumberValue 提取实际数字值
+ * 从 NumberOrPath 提取实际数字值 (v0.9 格式)
  */
-declare function extractNumberValue(val: NumberValue | null, component: AnyComponentNode | null, processor: MessageProcessor | null, surfaceId: string | null): number;
+declare function extractNumberValue(val: NumberOrPath | null, component: AnyComponentNode | null, processor: MessageProcessor | null, surfaceId: string | null): number;
 /**
- * 合并 className
+ * 合并 className（支持 string 和 Record<string, boolean>）
  */
-declare function cn(...classes: (string | Record<string, boolean> | undefined | null | false)[]): string;
+declare function cn(...inputs: (string | Record<string, boolean> | undefined | null | false)[]): string;
 
 /**
  * A2UI UI Module

package/dist/index-Ccel8ysN.d.cts

@@ -0,0 +1,111 @@
+import { ClientToServerMessage, Theme, A2UI_EXTENSION_URI, A2UI_MIME_TYPE, Action, AnyComponent, AudioPlayerComponent, BooleanOrPath, ButtonComponent, CardComponent, CheckBoxComponent, ChildrenProperty, ChoicePickerComponent, ColumnComponent, ComponentInstance, ComponentType, CreateSurfaceMessage, DataArray, DataChangeEvent, DataObject, DataValue, DateTimeInputComponent, DeleteSurfaceMessage, DividerComponent, IconComponent, ImageComponent, ListComponent, ModalComponent, NumberOrPath, RowComponent, STANDARD_CATALOG_ID, ServerToClientMessageV09, SliderComponent, StringArrayOrPath, StringOrPath, TabsComponent, TextComponent, TextFieldComponent, UpdateComponentsMessage, UpdateDataModelMessage, UserActionEvent, VideoComponent, isV09Message } from '@zhama/a2ui-core';
+import { A as AnyComponentNode, g as AudioPlayerNode, B as ButtonNode, j as CardNode, n as CheckboxNode, _ as ClientCapabilitiesDynamic, i as ColumnNode, a as ComponentArrayReference, C as ComponentArrayTemplate, b as ComponentProperties, r as CustomNode, X as CustomNodeProperties, D as DataMap, p as DateTimeInputNode, l as DividerNode, f as IconNode, I as ImageNode, L as ListNode, M as MessageProcessor, m as ModalNode, q as MultipleChoiceNode, d as ResolvedArray, w as ResolvedAudioPlayer, K as ResolvedButton, O as ResolvedCard, y as ResolvedCheckbox, J as ResolvedColumn, E as ResolvedDateTimeInput, x as ResolvedDivider, t as ResolvedIcon, u as ResolvedImage, N as ResolvedList, c as ResolvedMap, W as ResolvedModal, F as ResolvedMultipleChoice, H as ResolvedRow, G as ResolvedSlider, P as ResolvedTabItem, Q as ResolvedTabs, s as ResolvedText, z as ResolvedTextField, R as ResolvedValue, v as ResolvedVideo, h as RowNode, $ as ServerToClientMessage, S as SliderNode, Z as Surface, Y as SurfaceID, k as TabsNode, o as TextFieldNode, e as TextNode, T as Theme$1, U as UserAction, V as VideoNode } from './types-Csi2jaoN.cjs';
+
+/**
+ * A2UI Types Module - v0.9 Protocol
+ *
+ * 类型分层：
+ * - 协议类型：从 @zhama/a2ui-core 重导出
+ * - 渲染器类型：本包特有的类型（组件节点、解析值等）
+ */
+
+declare const index_A2UI_EXTENSION_URI: typeof A2UI_EXTENSION_URI;
+declare const index_A2UI_MIME_TYPE: typeof A2UI_MIME_TYPE;
+declare const index_Action: typeof Action;
+declare const index_AnyComponent: typeof AnyComponent;
+declare const index_AnyComponentNode: typeof AnyComponentNode;
+declare const index_AudioPlayerComponent: typeof AudioPlayerComponent;
+declare const index_AudioPlayerNode: typeof AudioPlayerNode;
+declare const index_BooleanOrPath: typeof BooleanOrPath;
+declare const index_ButtonComponent: typeof ButtonComponent;
+declare const index_ButtonNode: typeof ButtonNode;
+declare const index_CardComponent: typeof CardComponent;
+declare const index_CardNode: typeof CardNode;
+declare const index_CheckBoxComponent: typeof CheckBoxComponent;
+declare const index_CheckboxNode: typeof CheckboxNode;
+declare const index_ChildrenProperty: typeof ChildrenProperty;
+declare const index_ChoicePickerComponent: typeof ChoicePickerComponent;
+declare const index_ClientCapabilitiesDynamic: typeof ClientCapabilitiesDynamic;
+declare const index_ClientToServerMessage: typeof ClientToServerMessage;
+declare const index_ColumnComponent: typeof ColumnComponent;
+declare const index_ColumnNode: typeof ColumnNode;
+declare const index_ComponentArrayReference: typeof ComponentArrayReference;
+declare const index_ComponentArrayTemplate: typeof ComponentArrayTemplate;
+declare const index_ComponentInstance: typeof ComponentInstance;
+declare const index_ComponentProperties: typeof ComponentProperties;
+declare const index_ComponentType: typeof ComponentType;
+declare const index_CreateSurfaceMessage: typeof CreateSurfaceMessage;
+declare const index_CustomNode: typeof CustomNode;
+declare const index_CustomNodeProperties: typeof CustomNodeProperties;
+declare const index_DataArray: typeof DataArray;
+declare const index_DataChangeEvent: typeof DataChangeEvent;
+declare const index_DataMap: typeof DataMap;
+declare const index_DataObject: typeof DataObject;
+declare const index_DataValue: typeof DataValue;
+declare const index_DateTimeInputComponent: typeof DateTimeInputComponent;
+declare const index_DateTimeInputNode: typeof DateTimeInputNode;
+declare const index_DeleteSurfaceMessage: typeof DeleteSurfaceMessage;
+declare const index_DividerComponent: typeof DividerComponent;
+declare const index_DividerNode: typeof DividerNode;
+declare const index_IconComponent: typeof IconComponent;
+declare const index_IconNode: typeof IconNode;
+declare const index_ImageComponent: typeof ImageComponent;
+declare const index_ImageNode: typeof ImageNode;
+declare const index_ListComponent: typeof ListComponent;
+declare const index_ListNode: typeof ListNode;
+declare const index_MessageProcessor: typeof MessageProcessor;
+declare const index_ModalComponent: typeof ModalComponent;
+declare const index_ModalNode: typeof ModalNode;
+declare const index_MultipleChoiceNode: typeof MultipleChoiceNode;
+declare const index_NumberOrPath: typeof NumberOrPath;
+declare const index_ResolvedArray: typeof ResolvedArray;
+declare const index_ResolvedAudioPlayer: typeof ResolvedAudioPlayer;
+declare const index_ResolvedButton: typeof ResolvedButton;
+declare const index_ResolvedCard: typeof ResolvedCard;
+declare const index_ResolvedCheckbox: typeof ResolvedCheckbox;
+declare const index_ResolvedColumn: typeof ResolvedColumn;
+declare const index_ResolvedDateTimeInput: typeof ResolvedDateTimeInput;
+declare const index_ResolvedDivider: typeof ResolvedDivider;
+declare const index_ResolvedIcon: typeof ResolvedIcon;
+declare const index_ResolvedImage: typeof ResolvedImage;
+declare const index_ResolvedList: typeof ResolvedList;
+declare const index_ResolvedMap: typeof ResolvedMap;
+declare const index_ResolvedModal: typeof ResolvedModal;
+declare const index_ResolvedMultipleChoice: typeof ResolvedMultipleChoice;
+declare const index_ResolvedRow: typeof ResolvedRow;
+declare const index_ResolvedSlider: typeof ResolvedSlider;
+declare const index_ResolvedTabItem: typeof ResolvedTabItem;
+declare const index_ResolvedTabs: typeof ResolvedTabs;
+declare const index_ResolvedText: typeof ResolvedText;
+declare const index_ResolvedTextField: typeof ResolvedTextField;
+declare const index_ResolvedValue: typeof ResolvedValue;
+declare const index_ResolvedVideo: typeof ResolvedVideo;
+declare const index_RowComponent: typeof RowComponent;
+declare const index_RowNode: typeof RowNode;
+declare const index_STANDARD_CATALOG_ID: typeof STANDARD_CATALOG_ID;
+declare const index_ServerToClientMessage: typeof ServerToClientMessage;
+declare const index_ServerToClientMessageV09: typeof ServerToClientMessageV09;
+declare const index_SliderComponent: typeof SliderComponent;
+declare const index_SliderNode: typeof SliderNode;
+declare const index_StringArrayOrPath: typeof StringArrayOrPath;
+declare const index_StringOrPath: typeof StringOrPath;
+declare const index_Surface: typeof Surface;
+declare const index_SurfaceID: typeof SurfaceID;
+declare const index_TabsComponent: typeof TabsComponent;
+declare const index_TabsNode: typeof TabsNode;
+declare const index_TextComponent: typeof TextComponent;
+declare const index_TextFieldComponent: typeof TextFieldComponent;
+declare const index_TextFieldNode: typeof TextFieldNode;
+declare const index_TextNode: typeof TextNode;
+declare const index_UpdateComponentsMessage: typeof UpdateComponentsMessage;
+declare const index_UpdateDataModelMessage: typeof UpdateDataModelMessage;
+declare const index_UserAction: typeof UserAction;
+declare const index_UserActionEvent: typeof UserActionEvent;
+declare const index_VideoComponent: typeof VideoComponent;
+declare const index_VideoNode: typeof VideoNode;
+declare const index_isV09Message: typeof isV09Message;
+declare namespace index {
+  export { ClientToServerMessage as A2UIClientEventMessage, Theme as A2UITheme, index_A2UI_EXTENSION_URI as A2UI_EXTENSION_URI, index_A2UI_MIME_TYPE as A2UI_MIME_TYPE, index_Action as Action, index_AnyComponent as AnyComponent, index_AnyComponentNode as AnyComponentNode, AudioPlayerComponent as AudioPlayer, index_AudioPlayerComponent as AudioPlayerComponent, index_AudioPlayerNode as AudioPlayerNode, index_BooleanOrPath as BooleanOrPath, ButtonComponent as Button, index_ButtonComponent as ButtonComponent, index_ButtonNode as ButtonNode, index_CardComponent as CardComponent, index_CardNode as CardNode, index_CheckBoxComponent as CheckBoxComponent, CheckBoxComponent as Checkbox, index_CheckboxNode as CheckboxNode, index_ChildrenProperty as ChildrenProperty, index_ChoicePickerComponent as ChoicePickerComponent, index_ClientCapabilitiesDynamic as ClientCapabilitiesDynamic, index_ClientToServerMessage as ClientToServerMessage, index_ColumnComponent as ColumnComponent, index_ColumnNode as ColumnNode, index_ComponentArrayReference as ComponentArrayReference, index_ComponentArrayTemplate as ComponentArrayTemplate, index_ComponentInstance as ComponentInstance, index_ComponentProperties as ComponentProperties, index_ComponentType as ComponentType, index_CreateSurfaceMessage as CreateSurfaceMessage, index_CustomNode as CustomNode, index_CustomNodeProperties as CustomNodeProperties, index_DataArray as DataArray, index_DataChangeEvent as DataChangeEvent, index_DataMap as DataMap, index_DataObject as DataObject, index_DataValue as DataValue, DateTimeInputComponent as DateTimeInput, index_DateTimeInputComponent as DateTimeInputComponent, index_DateTimeInputNode as DateTimeInputNode, index_DeleteSurfaceMessage as DeleteSurfaceMessage, DividerComponent as Divider, index_DividerComponent as DividerComponent, index_DividerNode as DividerNode, IconComponent as Icon, index_IconComponent as IconComponent, index_IconNode as IconNode, ImageComponent as Image, index_ImageComponent as ImageComponent, index_ImageNode as ImageNode, index_ListComponent as ListComponent, index_ListNode as ListNode, index_MessageProcessor as MessageProcessor, ModalComponent as Modal, index_ModalComponent as ModalComponent, index_ModalNode as ModalNode, ChoicePickerComponent as MultipleChoice, index_MultipleChoiceNode as MultipleChoiceNode, index_NumberOrPath as NumberOrPath, index_ResolvedArray as ResolvedArray, index_ResolvedAudioPlayer as ResolvedAudioPlayer, index_ResolvedButton as ResolvedButton, index_ResolvedCard as ResolvedCard, index_ResolvedCheckbox as ResolvedCheckbox, index_ResolvedColumn as ResolvedColumn, index_ResolvedDateTimeInput as ResolvedDateTimeInput, index_ResolvedDivider as ResolvedDivider, index_ResolvedIcon as ResolvedIcon, index_ResolvedImage as ResolvedImage, index_ResolvedList as ResolvedList, index_ResolvedMap as ResolvedMap, index_ResolvedModal as ResolvedModal, index_ResolvedMultipleChoice as ResolvedMultipleChoice, index_ResolvedRow as ResolvedRow, index_ResolvedSlider as ResolvedSlider, index_ResolvedTabItem as ResolvedTabItem, index_ResolvedTabs as ResolvedTabs, index_ResolvedText as ResolvedText, index_ResolvedTextField as ResolvedTextField, index_ResolvedValue as ResolvedValue, index_ResolvedVideo as ResolvedVideo, index_RowComponent as RowComponent, index_RowNode as RowNode, index_STANDARD_CATALOG_ID as STANDARD_CATALOG_ID, index_ServerToClientMessage as ServerToClientMessage, index_ServerToClientMessageV09 as ServerToClientMessageV09, SliderComponent as Slider, index_SliderComponent as SliderComponent, index_SliderNode as SliderNode, index_StringArrayOrPath as StringArrayOrPath, index_StringOrPath as StringOrPath, index_Surface as Surface, index_SurfaceID as SurfaceID, TabsComponent as Tabs, index_TabsComponent as TabsComponent, index_TabsNode as TabsNode, TextComponent as Text, index_TextComponent as TextComponent, TextFieldComponent as TextField, index_TextFieldComponent as TextFieldComponent, index_TextFieldNode as TextFieldNode, index_TextNode as TextNode, Theme$1 as Theme, index_UpdateComponentsMessage as UpdateComponentsMessage, index_UpdateDataModelMessage as UpdateDataModelMessage, index_UserAction as UserAction, index_UserActionEvent as UserActionEvent, VideoComponent as Video, index_VideoComponent as VideoComponent, index_VideoNode as VideoNode, index_isV09Message as isV09Message };
+}
+
+export { index as i };