@zhama/a2ui-core 0.3.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,5 +1,5 @@
1
- import { S as StringOrPath, B as BooleanOrPath, a as StringArrayOrPath, N as NumberOrPath } from '../primitives-nmkVz-tB.js';
2
- import { TextComponent, ImageComponent, RowComponent, ListComponent, DividerComponent, TextFieldComponent, ComponentInstance, ChildrenProperty, Action, ChoicePickerComponent, CreateSurfaceMessage, UpdateComponentsMessage, UpdateDataModelMessage, DeleteSurfaceMessage, DataObject, ServerToClientMessageV09, BeginRenderingMessage, ComponentInstanceV08, SurfaceUpdateMessage, ValueMap, DataModelUpdateMessage, DataValue, ServerToClientMessageV08 } from '../types/index.js';
1
+ import { S as StringOrPath, B as BooleanOrPath, a as StringArrayOrPath, N as NumberOrPath } from '../primitives-DLbBDhLq.js';
2
+ import { TextComponent, ImageComponent, RowComponent, ListComponent, DividerComponent, TextFieldComponent, ComponentInstance, ChildrenProperty, Action, ChoicePickerComponent, CreateSurfaceMessage, UpdateComponentsMessage, UpdateDataModelMessage, DeleteSurfaceMessage, DataObject, ServerToClientMessageV09, DataValue } from '../types/index.js';
3
3
 
4
4
  /**
5
5
  * ID Generator
@@ -322,35 +322,66 @@ declare function body(content: StringOrPath, options?: Omit<TextOptions, 'usageH
322
322
  /**
323
323
  * Message Builder
324
324
  *
325
- * 提供 A2UI 协议消息的构建工具函数
326
- * 支持 v0.8 和 v0.9 两种消息格式
325
+ * 提供 A2UI v0.9 协议消息的构建工具函数
326
+ *
327
+ * v0.9 消息类型:
328
+ * - createSurface: 创建新的 UI Surface
329
+ * - updateComponents: 更新组件
330
+ * - updateDataModel: 更新数据模型 (JSON Patch 风格)
331
+ * - deleteSurface: 删除 Surface
332
+ *
333
+ * 参考: https://a2ui.org/
327
334
  */
328
335
 
329
336
  /**
330
- * 创建 CreateSurface 消息 (v0.9)
337
+ * 创建 CreateSurface 消息
331
338
  *
332
339
  * @param surfaceId - Surface ID
333
340
  * @param catalogId - Catalog ID(默认为标准目录)
341
+ *
342
+ * @example
343
+ * ```typescript
344
+ * const msg = createSurface('my-surface');
345
+ * // { createSurface: { surfaceId: 'my-surface', catalogId: '...' } }
346
+ * ```
334
347
  */
335
348
  declare function createSurface(surfaceId: string, catalogId?: string): CreateSurfaceMessage;
336
349
  /**
337
- * 创建 UpdateComponents 消息 (v0.9)
350
+ * 创建 UpdateComponents 消息
338
351
  *
339
352
  * @param surfaceId - Surface ID
340
353
  * @param components - 组件列表
354
+ *
355
+ * @example
356
+ * ```typescript
357
+ * const title = text('Hello', { id: 'title' });
358
+ * const msg = updateComponents('my-surface', [title]);
359
+ * ```
341
360
  */
342
361
  declare function updateComponents(surfaceId: string, components: ComponentInstance[]): UpdateComponentsMessage;
343
362
  /**
344
- * 创建 UpdateDataModel 消息 (v0.9)
363
+ * 创建 UpdateDataModel 消息
345
364
  *
346
365
  * @param surfaceId - Surface ID
347
366
  * @param value - 数据值
348
- * @param path - 数据路径(可选)
367
+ * @param path - 数据路径(可选,默认为根路径)
349
368
  * @param op - 操作类型(默认为 replace)
369
+ *
370
+ * @example
371
+ * ```typescript
372
+ * // 替换整个数据模型
373
+ * updateDataModel('my-surface', { user: { name: 'John' } });
374
+ *
375
+ * // 更新特定路径
376
+ * updateDataModel('my-surface', 'Jane', '/user/name', 'replace');
377
+ *
378
+ * // 添加数据
379
+ * updateDataModel('my-surface', 'new-item', '/items/-', 'add');
380
+ * ```
350
381
  */
351
382
  declare function updateDataModel(surfaceId: string, value: unknown, path?: string, op?: 'add' | 'replace' | 'remove'): UpdateDataModelMessage;
352
383
  /**
353
- * 创建 DeleteSurface 消息 (v0.9)
384
+ * 创建 DeleteSurface 消息
354
385
  *
355
386
  * @param surfaceId - 要删除的 Surface ID
356
387
  */
@@ -360,6 +391,21 @@ declare function deleteSurface(surfaceId: string): DeleteSurfaceMessage;
360
391
  *
361
392
  * @param options - 选项
362
393
  * @returns 消息数组(可直接作为 JSONL 流发送)
394
+ *
395
+ * @example
396
+ * ```typescript
397
+ * const title = h1('Welcome', { id: 'title' });
398
+ * const root = column(['title'], { id: 'root' });
399
+ *
400
+ * const messages = createV09Messages({
401
+ * surfaceId: '@chat',
402
+ * components: [title, root],
403
+ * dataModel: { user: { name: 'John' } }
404
+ * });
405
+ *
406
+ * // 发送为 JSONL 流
407
+ * const jsonl = messagesToJsonl(messages);
408
+ * ```
363
409
  */
364
410
  declare function createV09Messages(options: {
365
411
  surfaceId: string;
@@ -367,89 +413,45 @@ declare function createV09Messages(options: {
367
413
  components: ComponentInstance[];
368
414
  dataModel?: DataObject;
369
415
  }): ServerToClientMessageV09[];
370
- /**
371
- * 创建 BeginRendering 消息 (v0.8)
372
- *
373
- * @param rootId - 根组件 ID
374
- * @param surfaceId - Surface ID
375
- * @param styles - 样式配置
376
- */
377
- declare function beginRendering(rootId: string, surfaceId?: string, styles?: Record<string, string>): BeginRenderingMessage;
378
- /**
379
- * 创建 SurfaceUpdate 消息 (v0.8)
380
- *
381
- * @param components - 组件定义数组
382
- * @param surfaceId - Surface ID
383
- */
384
- declare function surfaceUpdate(components: ComponentInstanceV08[], surfaceId?: string): SurfaceUpdateMessage;
385
- /**
386
- * 创建 DataModelUpdate 消息 (v0.8)
387
- *
388
- * @param contents - ValueMap 数组
389
- * @param surfaceId - Surface ID
390
- * @param path - 数据路径(可选)
391
- */
392
- declare function dataModelUpdate(contents: ValueMap[], surfaceId?: string, path?: string): DataModelUpdateMessage;
393
- /**
394
- * 创建 DataModel 初始化消息 (v0.8)
395
- *
396
- * @param data - 初始数据对象
397
- * @param surfaceId - Surface ID
398
- */
399
- declare function dataModelInit(data: DataObject, surfaceId?: string): DataModelUpdateMessage;
400
- /**
401
- * 创建路径更新消息 (v0.8)
402
- *
403
- * @param path - 数据路径
404
- * @param value - 新值
405
- * @param surfaceId - Surface ID
406
- */
407
- declare function pathUpdate(path: string, value: DataValue, surfaceId?: string): DataModelUpdateMessage;
408
- /**
409
- * 创建 DeleteSurface 消息 (v0.8)
410
- *
411
- * @param surfaceId - 要删除的 Surface ID
412
- */
413
- declare function deleteSurfaceV08(surfaceId: string): {
414
- deleteSurface: {
415
- surfaceId: string;
416
- };
417
- };
418
- /**
419
- * 创建完整的 v0.8 消息数组
420
- *
421
- * @param options - 选项
422
- * @returns 消息数组
423
- */
424
- declare function createV08Messages(options: {
425
- rootId: string;
426
- components: ComponentInstanceV08[];
427
- dataModel?: DataObject;
428
- surfaceId?: string;
429
- styles?: Record<string, string>;
430
- }): ServerToClientMessageV08[];
431
416
  /**
432
417
  * 将消息数组转换为 JSONL 格式字符串
433
418
  *
434
419
  * @param messages - 消息数组
435
420
  * @returns JSONL 格式字符串
421
+ *
422
+ * @example
423
+ * ```typescript
424
+ * const jsonl = messagesToJsonl(messages);
425
+ * // 每行一个 JSON 对象
426
+ * ```
436
427
  */
437
- declare function messagesToJsonl(messages: Array<ServerToClientMessageV08 | ServerToClientMessageV09>): string;
428
+ declare function messagesToJsonl(messages: ServerToClientMessageV09[]): string;
438
429
  /**
439
430
  * 从 JSONL 格式字符串解析消息数组
440
431
  *
441
432
  * @param jsonl - JSONL 格式字符串
442
433
  * @returns 消息数组
443
434
  */
444
- declare function jsonlToMessages(jsonl: string): Array<ServerToClientMessageV08 | ServerToClientMessageV09>;
435
+ declare function jsonlToMessages(jsonl: string): ServerToClientMessageV09[];
445
436
 
446
437
  /**
447
438
  * Data Model Builder
448
439
  *
449
440
  * 提供 DataModel 相关的构建工具函数
450
- * 符合 A2UI 协议的 ValueMap 格式
441
+ * 包括 v0.9 JSON 对象格式和 v0.8 ValueMap 格式转换
451
442
  */
452
443
 
444
+ /**
445
+ * ValueMap 格式 - 用于 v0.8 兼容和内部数据转换
446
+ * @internal
447
+ */
448
+ interface ValueMap {
449
+ key: string;
450
+ valueString?: string;
451
+ valueNumber?: number;
452
+ valueBoolean?: boolean;
453
+ valueMap?: ValueMap[];
454
+ }
453
455
  /**
454
456
  * 路径映射表类型
455
457
  */
@@ -530,4 +532,4 @@ declare function flattenObjectToValueMap(obj: DataObject, basePath: string): Val
530
532
  */
531
533
  declare function valueMapToObject(valueMaps: ValueMap[]): DataObject;
532
534
 
533
- export { type AudioPlayerOptions, type ButtonOptions, type CardOptions, type CheckBoxOptions, type ChoicePickerOptions, type ComponentOptions, DEFAULT_PATH_MAPPINGS, type DateTimeInputOptions, type DividerOptions, type IconOptions, type ImageOptions, type LayoutOptions, type ListOptions, type ModalOptions, type PathMappings, type SliderOptions, type TabItem, type TabsOptions, type TextFieldOptions, type TextOptions, type UpdateDataItem, type VideoOptions, audioPlayer, beginRendering, body, button, caption, card, checkbox, choicePicker, column, createSurface, createV08Messages, createV09Messages, dataModelInit, dataModelUpdate, dateTimeInput, deleteSurface, deleteSurfaceV08, divider, flattenObjectToValueMap, generateId, getIdCounter, h1, h2, h3, h4, h5, icon, image, jsonlToMessages, list, messagesToJsonl, modal, normalizePath, objectToValueMap, pathUpdate, resetIdCounter, row, slider, surfaceUpdate, tabs, text, textButton, textField, updateComponents, updateDataModel, updatesToValueMap, valueMapToObject, valueToValueMap, video };
535
+ export { type AudioPlayerOptions, type ButtonOptions, type CardOptions, type CheckBoxOptions, type ChoicePickerOptions, type ComponentOptions, DEFAULT_PATH_MAPPINGS, type DateTimeInputOptions, type DividerOptions, type IconOptions, type ImageOptions, type LayoutOptions, type ListOptions, type ModalOptions, type PathMappings, type SliderOptions, type TabItem, type TabsOptions, type TextFieldOptions, type TextOptions, type UpdateDataItem, type VideoOptions, audioPlayer, body, button, caption, card, checkbox, choicePicker, column, createSurface, createV09Messages, dateTimeInput, deleteSurface, divider, flattenObjectToValueMap, generateId, getIdCounter, h1, h2, h3, h4, h5, icon, image, jsonlToMessages, list, messagesToJsonl, modal, normalizePath, objectToValueMap, resetIdCounter, row, slider, tabs, text, textButton, textField, updateComponents, updateDataModel, updatesToValueMap, valueMapToObject, valueToValueMap, video };
@@ -1,3 +1,3 @@
1
- var g=0;function i(t="comp"){return `${t}_${Date.now()}_${g++}`}function V(){g=0;}function D(){return g}function p(t,e={}){let{id:n=i("text"),weight:o,usageHint:a}=e;return {id:n,component:"Text",text:t,...o!==void 0&&{weight:o},...a&&{usageHint:a}}}function v(t,e={}){let{id:n=i("image"),weight:o,fit:a,usageHint:r}=e;return {id:n,component:"Image",url:t,...o!==void 0&&{weight:o},...a&&{fit:a},...r&&{usageHint:r}}}function P(t,e={}){let{id:n=i("icon"),weight:o}=e;return {id:n,component:"Icon",name:t,...o!==void 0&&{weight:o}}}function A(t,e={}){let{id:n=i("video"),weight:o}=e;return {id:n,component:"Video",url:t,...o!==void 0&&{weight:o}}}function U(t,e={}){let{id:n=i("audio"),weight:o,description:a}=e;return {id:n,component:"AudioPlayer",url:t,...o!==void 0&&{weight:o},...a&&{description:a}}}function w(t,e={}){let{id:n=i("row"),weight:o,alignment:a,distribution:r}=e;return {id:n,component:"Row",children:t,...o!==void 0&&{weight:o},...a&&{alignment:a},...r&&{distribution:r}}}function j(t,e={}){let{id:n=i("column"),weight:o,alignment:a,distribution:r}=e;return {id:n,component:"Column",children:t,...o!==void 0&&{weight:o},...a&&{alignment:a},...r&&{distribution:r}}}function R(t,e={}){let{id:n=i("list"),weight:o,direction:a,alignment:r}=e;return {id:n,component:"List",children:t,...o!==void 0&&{weight:o},...a&&{direction:a},...r&&{alignment:r}}}function _(t,e={}){let{id:n=i("card"),weight:o}=e;return {id:n,component:"Card",child:t,...o!==void 0&&{weight:o}}}function k(t,e={}){let{id:n=i("tabs"),weight:o}=e;return {id:n,component:"Tabs",tabItems:t.map(a=>({title:a.title,child:a.childId})),...o!==void 0&&{weight:o}}}function B(t={}){let{id:e=i("divider"),weight:n,axis:o}=t;return {id:e,component:"Divider",...n!==void 0&&{weight:n},...o&&{axis:o}}}function H(t,e,n={}){let{id:o=i("modal"),weight:a}=n;return {id:o,component:"Modal",entryPointChild:t,contentChild:e,...a!==void 0&&{weight:a}}}function f(t,e,n={}){let{id:o=i("button"),weight:a,primary:r}=n;return {id:o,component:"Button",child:t,action:e,...a!==void 0&&{weight:a},...r!==void 0&&{primary:r}}}function N(t,e,n={}){let{id:o=i("checkbox"),weight:a}=n;return {id:o,component:"CheckBox",label:t,value:e,...a!==void 0&&{weight:a}}}function E(t,e,n={}){let{id:o=i("textfield"),weight:a,usageHint:r,validationRegexp:s}=n;return {id:o,component:"TextField",label:t,...e!==void 0&&{text:e},...a!==void 0&&{weight:a},...r&&{usageHint:r},...s&&{validationRegexp:s}}}function L(t,e={}){let{id:n=i("datetime"),weight:o,enableDate:a,enableTime:r,outputFormat:s,label:c}=e;return {id:n,component:"DateTimeInput",value:t,...o!==void 0&&{weight:o},...a!==void 0&&{enableDate:a},...r!==void 0&&{enableTime:r},...s&&{outputFormat:s},...c&&{label:c}}}function $(t,e,n,o={}){let{id:a=i("choice"),weight:r,label:s}=o;return {id:a,component:"ChoicePicker",options:t,value:e,usageHint:n,...r!==void 0&&{weight:r},...s&&{label:s}}}function F(t,e={}){let{id:n=i("slider"),weight:o,label:a,min:r,max:s}=e;return {id:n,component:"Slider",value:t,...o!==void 0&&{weight:o},...a&&{label:a},...r!==void 0&&{min:r},...s!==void 0&&{max:s}}}function G(t,e,n={}){let o=n.textId??i("btn_text"),a=p(t,{id:o}),r=f(o,e,n);return [a,r]}function z(t,e={}){return p(t,{...e,usageHint:"h1"})}function J(t,e={}){return p(t,{...e,usageHint:"h2"})}function X(t,e={}){return p(t,{...e,usageHint:"h3"})}function W(t,e={}){return p(t,{...e,usageHint:"h4"})}function Y(t,e={}){return p(t,{...e,usageHint:"h5"})}function K(t,e={}){return p(t,{...e,usageHint:"caption"})}function q(t,e={}){return p(t,{...e,usageHint:"body"})}var d="https://a2ui.dev/specification/0.9/standard_catalog_definition.json";var C={};function l(t,e=""){let n=[];for(let[o,a]of Object.entries(t)){let r=e?`${e}/${o}`:`/${o}`;n.push(u(r,a));}return n}function u(t,e){if(e==null)return {key:t,valueString:""};if(typeof e=="string")return {key:t,valueString:e};if(typeof e=="number")return {key:t,valueNumber:e};if(typeof e=="boolean")return {key:t,valueBoolean:e};if(Array.isArray(e))return {key:t,valueMap:e.map((n,o)=>u(String(o),n))};if(typeof e=="object"){let n=[];for(let[o,a]of Object.entries(e))n.push(u(o,a));return {key:t,valueMap:n}}return {key:t,valueString:String(e)}}function x(t,e={}){let n=t.replace(/\./g,"/");n.startsWith("/")||(n=`/${n}`);for(let[o,a]of Object.entries(e)){let r=new RegExp(`^/${o}(/|$)`);r.test(n)&&(n=n.replace(r,`/${a}$1`));}return n}function Q(t,e="",n=C){let o=[];for(let a of t){let r=a.path.startsWith("/")?a.path:`${e}/${a.path}`,s=x(r,n);if(a.value!==null&&typeof a.value=="object"&&!Array.isArray(a.value)){let c=m(a.value,s);o.push(...c);}else o.push(u(s,a.value));}return o}function m(t,e){let n=[];for(let[o,a]of Object.entries(t)){let r=`${e}/${o}`;if(a!==null&&typeof a=="object"&&!Array.isArray(a)){let s=m(a,r);n.push(...s);}else n.push(u(r,a));}return n}function M(t){let e={};for(let n of t){let o=n.key.startsWith("/")?n.key.slice(1):n.key;n.valueString!==void 0?e[o]=n.valueString:n.valueNumber!==void 0?e[o]=n.valueNumber:n.valueBoolean!==void 0?e[o]=n.valueBoolean:n.valueMap!==void 0&&(e[o]=M(n.valueMap));}return e}function O(t,e=d){return {createSurface:{surfaceId:t,catalogId:e}}}function h(t,e){return {updateComponents:{surfaceId:t,components:e}}}function I(t,e,n,o="replace"){return {updateDataModel:{surfaceId:t,...n&&{path:n},op:o,...o!=="remove"&&{value:e}}}}function Z(t){return {deleteSurface:{surfaceId:t}}}function ee(t){let{surfaceId:e,catalogId:n=d,components:o,dataModel:a}=t,r=[O(e,n),h(e,o)];return a&&r.push(I(e,a)),r}function S(t,e="@default",n){return {beginRendering:{surfaceId:e,root:t,...n&&{styles:n}}}}function T(t,e="@default"){return {surfaceUpdate:{surfaceId:e,components:t}}}function y(t,e="@default",n){return {dataModelUpdate:{surfaceId:e,contents:t,...n&&{path:n}}}}function b(t,e="@default"){return y(l(t),e)}function te(t,e,n="@default"){return {dataModelUpdate:{surfaceId:n,path:t,contents:[u("",e)]}}}function ne(t){return {deleteSurface:{surfaceId:t}}}function oe(t){let{rootId:e,components:n,dataModel:o,surfaceId:a="@default",styles:r}=t,s=[T(n,a)];return o&&s.push(b(o,a)),s.push(S(e,a,r)),s}function ae(t){return t.map(e=>JSON.stringify(e)).join(`
2
- `)}function re(t){return t.split(`
3
- `).filter(e=>e.trim()).map(e=>JSON.parse(e))}export{C as DEFAULT_PATH_MAPPINGS,U as audioPlayer,S as beginRendering,q as body,f as button,K as caption,_ as card,N as checkbox,$ as choicePicker,j as column,O as createSurface,oe as createV08Messages,ee as createV09Messages,b as dataModelInit,y as dataModelUpdate,L as dateTimeInput,Z as deleteSurface,ne as deleteSurfaceV08,B as divider,m as flattenObjectToValueMap,i as generateId,D as getIdCounter,z as h1,J as h2,X as h3,W as h4,Y as h5,P as icon,v as image,re as jsonlToMessages,R as list,ae as messagesToJsonl,H as modal,x as normalizePath,l as objectToValueMap,te as pathUpdate,V as resetIdCounter,w as row,F as slider,T as surfaceUpdate,k as tabs,p as text,G as textButton,E as textField,h as updateComponents,I as updateDataModel,Q as updatesToValueMap,M as valueMapToObject,u as valueToValueMap,A as video};
1
+ var m=0;function i(t="comp"){return `${t}_${Date.now()}_${m++}`}function I(){m=0;}function y(){return m}function p(t,e={}){let{id:n=i("text"),weight:o,usageHint:r}=e;return {id:n,component:"Text",text:t,...o!==void 0&&{weight:o},...r&&{usageHint:r}}}function S(t,e={}){let{id:n=i("image"),weight:o,fit:r,usageHint:a}=e;return {id:n,component:"Image",url:t,...o!==void 0&&{weight:o},...r&&{fit:r},...a&&{usageHint:a}}}function b(t,e={}){let{id:n=i("icon"),weight:o}=e;return {id:n,component:"Icon",name:t,...o!==void 0&&{weight:o}}}function T(t,e={}){let{id:n=i("video"),weight:o}=e;return {id:n,component:"Video",url:t,...o!==void 0&&{weight:o}}}function v(t,e={}){let{id:n=i("audio"),weight:o,description:r}=e;return {id:n,component:"AudioPlayer",url:t,...o!==void 0&&{weight:o},...r&&{description:r}}}function D(t,e={}){let{id:n=i("row"),weight:o,alignment:r,distribution:a}=e;return {id:n,component:"Row",children:t,...o!==void 0&&{weight:o},...r&&{alignment:r},...a&&{distribution:a}}}function P(t,e={}){let{id:n=i("column"),weight:o,alignment:r,distribution:a}=e;return {id:n,component:"Column",children:t,...o!==void 0&&{weight:o},...r&&{alignment:r},...a&&{distribution:a}}}function V(t,e={}){let{id:n=i("list"),weight:o,direction:r,alignment:a}=e;return {id:n,component:"List",children:t,...o!==void 0&&{weight:o},...r&&{direction:r},...a&&{alignment:a}}}function A(t,e={}){let{id:n=i("card"),weight:o}=e;return {id:n,component:"Card",child:t,...o!==void 0&&{weight:o}}}function w(t,e={}){let{id:n=i("tabs"),weight:o}=e;return {id:n,component:"Tabs",tabItems:t.map(r=>({title:r.title,child:r.childId})),...o!==void 0&&{weight:o}}}function U(t={}){let{id:e=i("divider"),weight:n,axis:o}=t;return {id:e,component:"Divider",...n!==void 0&&{weight:n},...o&&{axis:o}}}function E(t,e,n={}){let{id:o=i("modal"),weight:r}=n;return {id:o,component:"Modal",entryPointChild:t,contentChild:e,...r!==void 0&&{weight:r}}}function l(t,e,n={}){let{id:o=i("button"),weight:r,primary:a}=n;return {id:o,component:"Button",child:t,action:e,...r!==void 0&&{weight:r},...a!==void 0&&{primary:a}}}function j(t,e,n={}){let{id:o=i("checkbox"),weight:r}=n;return {id:o,component:"CheckBox",label:t,value:e,...r!==void 0&&{weight:r}}}function k(t,e,n={}){let{id:o=i("textfield"),weight:r,usageHint:a,validationRegexp:s}=n;return {id:o,component:"TextField",label:t,...e!==void 0&&{text:e},...r!==void 0&&{weight:r},...a&&{usageHint:a},...s&&{validationRegexp:s}}}function _(t,e={}){let{id:n=i("datetime"),weight:o,enableDate:r,enableTime:a,outputFormat:s,label:u}=e;return {id:n,component:"DateTimeInput",value:t,...o!==void 0&&{weight:o},...r!==void 0&&{enableDate:r},...a!==void 0&&{enableTime:a},...s&&{outputFormat:s},...u&&{label:u}}}function H(t,e,n,o={}){let{id:r=i("choice"),weight:a,label:s}=o;return {id:r,component:"ChoicePicker",options:t,value:e,usageHint:n,...a!==void 0&&{weight:a},...s&&{label:s}}}function B(t,e={}){let{id:n=i("slider"),weight:o,label:r,min:a,max:s}=e;return {id:n,component:"Slider",value:t,...o!==void 0&&{weight:o},...r&&{label:r},...a!==void 0&&{min:a},...s!==void 0&&{max:s}}}function N(t,e,n={}){let o=n.textId??i("btn_text"),r=p(t,{id:o}),a=l(o,e,n);return [r,a]}function R(t,e={}){return p(t,{...e,usageHint:"h1"})}function L(t,e={}){return p(t,{...e,usageHint:"h2"})}function F(t,e={}){return p(t,{...e,usageHint:"h3"})}function $(t,e={}){return p(t,{...e,usageHint:"h4"})}function G(t,e={}){return p(t,{...e,usageHint:"h5"})}function z(t,e={}){return p(t,{...e,usageHint:"caption"})}function J(t,e={}){return p(t,{...e,usageHint:"body"})}var d="https://a2ui.dev/specification/0.9/standard_catalog_definition.json";function f(t,e=d){return {createSurface:{surfaceId:t,catalogId:e}}}function C(t,e){return {updateComponents:{surfaceId:t,components:e}}}function x(t,e,n,o="replace"){return {updateDataModel:{surfaceId:t,...n&&{path:n},op:o,...o!=="remove"&&{value:e}}}}function W(t){return {deleteSurface:{surfaceId:t}}}function X(t){let{surfaceId:e,catalogId:n=d,components:o,dataModel:r}=t,a=[f(e,n),C(e,o)];return r&&a.push(x(e,r)),a}function Y(t){return t.map(e=>JSON.stringify(e)).join(`
2
+ `)}function K(t){return t.split(`
3
+ `).filter(e=>e.trim()).map(e=>JSON.parse(e))}var O={};function q(t,e=""){let n=[];for(let[o,r]of Object.entries(t)){let a=e?`${e}/${o}`:`/${o}`;n.push(c(a,r));}return n}function c(t,e){if(e==null)return {key:t,valueString:""};if(typeof e=="string")return {key:t,valueString:e};if(typeof e=="number")return {key:t,valueNumber:e};if(typeof e=="boolean")return {key:t,valueBoolean:e};if(Array.isArray(e))return {key:t,valueMap:e.map((n,o)=>c(String(o),n))};if(typeof e=="object"){let n=[];for(let[o,r]of Object.entries(e))n.push(c(o,r));return {key:t,valueMap:n}}return {key:t,valueString:String(e)}}function h(t,e={}){let n=t.replace(/\./g,"/");n.startsWith("/")||(n=`/${n}`);for(let[o,r]of Object.entries(e)){let a=new RegExp(`^/${o}(/|$)`);a.test(n)&&(n=n.replace(a,`/${r}$1`));}return n}function Q(t,e="",n=O){let o=[];for(let r of t){let a=r.path.startsWith("/")?r.path:`${e}/${r.path}`,s=h(a,n);if(r.value!==null&&typeof r.value=="object"&&!Array.isArray(r.value)){let u=g(r.value,s);o.push(...u);}else o.push(c(s,r.value));}return o}function g(t,e){let n=[];for(let[o,r]of Object.entries(t)){let a=`${e}/${o}`;if(r!==null&&typeof r=="object"&&!Array.isArray(r)){let s=g(r,a);n.push(...s);}else n.push(c(a,r));}return n}function M(t){let e={};for(let n of t){let o=n.key.startsWith("/")?n.key.slice(1):n.key;n.valueString!==void 0?e[o]=n.valueString:n.valueNumber!==void 0?e[o]=n.valueNumber:n.valueBoolean!==void 0?e[o]=n.valueBoolean:n.valueMap!==void 0&&(e[o]=M(n.valueMap));}return e}export{O as DEFAULT_PATH_MAPPINGS,v as audioPlayer,J as body,l as button,z as caption,A as card,j as checkbox,H as choicePicker,P as column,f as createSurface,X as createV09Messages,_ as dateTimeInput,W as deleteSurface,U as divider,g as flattenObjectToValueMap,i as generateId,y as getIdCounter,R as h1,L as h2,F as h3,$ as h4,G as h5,b as icon,S as image,K as jsonlToMessages,V as list,Y as messagesToJsonl,E as modal,h as normalizePath,q as objectToValueMap,I as resetIdCounter,D as row,B as slider,w as tabs,p as text,N as textButton,k as textField,C as updateComponents,x as updateDataModel,Q as updatesToValueMap,M as valueMapToObject,c as valueToValueMap,T as video};
package/dist/index.cjs CHANGED
@@ -1,3 +1,4 @@
1
- 'use strict';function U(e){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e}function N(e){return "beginRendering"in e||"surfaceUpdate"in e||"dataModelUpdate"in e}var l="https://a2ui.dev/specification/0.9/standard_catalog_definition.json",_="https://a2ui.org/a2a-extension/a2ui/v0.8",E="https://a2ui.dev/specification/0.9",R="application/json+a2ui";var f=0;function p(e="comp"){return `${e}_${Date.now()}_${f++}`}function w(){f=0;}function k(){return f}function d(e,t={}){let{id:n=p("text"),weight:a,usageHint:o}=t;return {id:n,component:"Text",text:e,...a!==void 0&&{weight:a},...o&&{usageHint:o}}}function j(e,t={}){let{id:n=p("image"),weight:a,fit:o,usageHint:r}=t;return {id:n,component:"Image",url:e,...a!==void 0&&{weight:a},...o&&{fit:o},...r&&{usageHint:r}}}function B(e,t={}){let{id:n=p("icon"),weight:a}=t;return {id:n,component:"Icon",name:e,...a!==void 0&&{weight:a}}}function L(e,t={}){let{id:n=p("video"),weight:a}=t;return {id:n,component:"Video",url:e,...a!==void 0&&{weight:a}}}function $(e,t={}){let{id:n=p("audio"),weight:a,description:o}=t;return {id:n,component:"AudioPlayer",url:e,...a!==void 0&&{weight:a},...o&&{description:o}}}function F(e,t={}){let{id:n=p("row"),weight:a,alignment:o,distribution:r}=t;return {id:n,component:"Row",children:e,...a!==void 0&&{weight:a},...o&&{alignment:o},...r&&{distribution:r}}}function G(e,t={}){let{id:n=p("column"),weight:a,alignment:o,distribution:r}=t;return {id:n,component:"Column",children:e,...a!==void 0&&{weight:a},...o&&{alignment:o},...r&&{distribution:r}}}function H(e,t={}){let{id:n=p("list"),weight:a,direction:o,alignment:r}=t;return {id:n,component:"List",children:e,...a!==void 0&&{weight:a},...o&&{direction:o},...r&&{alignment:r}}}function q(e,t={}){let{id:n=p("card"),weight:a}=t;return {id:n,component:"Card",child:e,...a!==void 0&&{weight:a}}}function W(e,t={}){let{id:n=p("tabs"),weight:a}=t;return {id:n,component:"Tabs",tabItems:e.map(o=>({title:o.title,child:o.childId})),...a!==void 0&&{weight:a}}}function Y(e={}){let{id:t=p("divider"),weight:n,axis:a}=e;return {id:t,component:"Divider",...n!==void 0&&{weight:n},...a&&{axis:a}}}function X(e,t,n={}){let{id:a=p("modal"),weight:o}=n;return {id:a,component:"Modal",entryPointChild:e,contentChild:t,...o!==void 0&&{weight:o}}}function C(e,t,n={}){let{id:a=p("button"),weight:o,primary:r}=n;return {id:a,component:"Button",child:e,action:t,...o!==void 0&&{weight:o},...r!==void 0&&{primary:r}}}function z(e,t,n={}){let{id:a=p("checkbox"),weight:o}=n;return {id:a,component:"CheckBox",label:e,value:t,...o!==void 0&&{weight:o}}}function J(e,t,n={}){let{id:a=p("textfield"),weight:o,usageHint:r,validationRegexp:i}=n;return {id:a,component:"TextField",label:e,...t!==void 0&&{text:t},...o!==void 0&&{weight:o},...r&&{usageHint:r},...i&&{validationRegexp:i}}}function K(e,t={}){let{id:n=p("datetime"),weight:a,enableDate:o,enableTime:r,outputFormat:i,label:s}=t;return {id:n,component:"DateTimeInput",value:e,...a!==void 0&&{weight:a},...o!==void 0&&{enableDate:o},...r!==void 0&&{enableTime:r},...i&&{outputFormat:i},...s&&{label:s}}}function Q(e,t,n,a={}){let{id:o=p("choice"),weight:r,label:i}=a;return {id:o,component:"ChoicePicker",options:e,value:t,usageHint:n,...r!==void 0&&{weight:r},...i&&{label:i}}}function Z(e,t={}){let{id:n=p("slider"),weight:a,label:o,min:r,max:i}=t;return {id:n,component:"Slider",value:e,...a!==void 0&&{weight:a},...o&&{label:o},...r!==void 0&&{min:r},...i!==void 0&&{max:i}}}function ee(e,t,n={}){let a=n.textId??p("btn_text"),o=d(e,{id:a}),r=C(a,t,n);return [o,r]}function te(e,t={}){return d(e,{...t,usageHint:"h1"})}function ne(e,t={}){return d(e,{...t,usageHint:"h2"})}function oe(e,t={}){return d(e,{...t,usageHint:"h3"})}function ae(e,t={}){return d(e,{...t,usageHint:"h4"})}function re(e,t={}){return d(e,{...t,usageHint:"h5"})}function ie(e,t={}){return d(e,{...t,usageHint:"caption"})}function se(e,t={}){return d(e,{...t,usageHint:"body"})}var M={};function g(e,t=""){let n=[];for(let[a,o]of Object.entries(e)){let r=t?`${t}/${a}`:`/${a}`;n.push(c(r,o));}return n}function c(e,t){if(t==null)return {key:e,valueString:""};if(typeof t=="string")return {key:e,valueString:t};if(typeof t=="number")return {key:e,valueNumber:t};if(typeof t=="boolean")return {key:e,valueBoolean:t};if(Array.isArray(t))return {key:e,valueMap:t.map((n,a)=>c(String(a),n))};if(typeof t=="object"){let n=[];for(let[a,o]of Object.entries(t))n.push(c(a,o));return {key:e,valueMap:n}}return {key:e,valueString:String(t)}}function I(e,t={}){let n=e.replace(/\./g,"/");n.startsWith("/")||(n=`/${n}`);for(let[a,o]of Object.entries(t)){let r=new RegExp(`^/${a}(/|$)`);r.test(n)&&(n=n.replace(r,`/${o}$1`));}return n}function pe(e,t="",n=M){let a=[];for(let o of e){let r=o.path.startsWith("/")?o.path:`${t}/${o.path}`,i=I(r,n);if(o.value!==null&&typeof o.value=="object"&&!Array.isArray(o.value)){let s=m(o.value,i);a.push(...s);}else a.push(c(i,o.value));}return a}function m(e,t){let n=[];for(let[a,o]of Object.entries(e)){let r=`${t}/${a}`;if(o!==null&&typeof o=="object"&&!Array.isArray(o)){let i=m(o,r);n.push(...i);}else n.push(c(r,o));}return n}function h(e){let t={};for(let n of e){let a=n.key.startsWith("/")?n.key.slice(1):n.key;n.valueString!==void 0?t[a]=n.valueString:n.valueNumber!==void 0?t[a]=n.valueNumber:n.valueBoolean!==void 0?t[a]=n.valueBoolean:n.valueMap!==void 0&&(t[a]=h(n.valueMap));}return t}function x(e,t=l){return {createSurface:{surfaceId:e,catalogId:t}}}function O(e,t){return {updateComponents:{surfaceId:e,components:t}}}function S(e,t,n,a="replace"){return {updateDataModel:{surfaceId:e,...n&&{path:n},op:a,...a!=="remove"&&{value:t}}}}function de(e){return {deleteSurface:{surfaceId:e}}}function ce(e){let{surfaceId:t,catalogId:n=l,components:a,dataModel:o}=e,r=[x(t,n),O(t,a)];return o&&r.push(S(t,o)),r}function T(e,t="@default",n){return {beginRendering:{surfaceId:t,root:e,...n&&{styles:n}}}}function y(e,t="@default"){return {surfaceUpdate:{surfaceId:t,components:e}}}function V(e,t="@default",n){return {dataModelUpdate:{surfaceId:t,contents:e,...n&&{path:n}}}}function D(e,t="@default"){return V(g(e),t)}function ue(e,t,n="@default"){return {dataModelUpdate:{surfaceId:n,path:e,contents:[c("",t)]}}}function le(e){return {deleteSurface:{surfaceId:e}}}function ge(e){let{rootId:t,components:n,dataModel:a,surfaceId:o="@default",styles:r}=e,i=[y(n,o)];return a&&i.push(D(a,o)),i.push(T(t,o,r)),i}function me(e){return e.map(t=>JSON.stringify(t)).join(`
2
- `)}function fe(e){return e.split(`
3
- `).filter(t=>t.trim()).map(t=>JSON.parse(t))}var Ie=["Text","Image","Icon","Video","AudioPlayer","Row","Column","List","Card","Tabs","Divider","Modal","Button","CheckBox","TextField","DateTimeInput","ChoicePicker","Slider"];function b(e,t={}){let n=[],a=[];if("createSurface"in e){let{createSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"createSurface.surfaceId is required",path:"createSurface.surfaceId"}),o.catalogId||n.push({code:"MISSING_CATALOG_ID",message:"createSurface.catalogId is required",path:"createSurface.catalogId"});}else if("updateComponents"in e){let{updateComponents:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"updateComponents.surfaceId is required",path:"updateComponents.surfaceId"}),!o.components||!Array.isArray(o.components)?n.push({code:"INVALID_COMPONENTS",message:"updateComponents.components must be an array",path:"updateComponents.components"}):he(o.components,n,a,t);}else if("updateDataModel"in e){let{updateDataModel:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"updateDataModel.surfaceId is required",path:"updateDataModel.surfaceId"});}else if("deleteSurface"in e){let{deleteSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"});}else n.push({code:"INVALID_MESSAGE_TYPE",message:"Message must contain one of: createSurface, updateComponents, updateDataModel, deleteSurface"});return {valid:n.length===0,errors:n,warnings:a}}function P(e,t={}){let n=[],a=[];if("beginRendering"in e){let{beginRendering:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"beginRendering.surfaceId is required",path:"beginRendering.surfaceId"}),o.root||n.push({code:"MISSING_ROOT",message:"beginRendering.root is required",path:"beginRendering.root"});}else if("surfaceUpdate"in e){let{surfaceUpdate:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"surfaceUpdate.surfaceId is required",path:"surfaceUpdate.surfaceId"}),!o.components||!Array.isArray(o.components)?n.push({code:"INVALID_COMPONENTS",message:"surfaceUpdate.components must be an array",path:"surfaceUpdate.components"}):xe(o.components,n,a,t);}else if("dataModelUpdate"in e){let{dataModelUpdate:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"dataModelUpdate.surfaceId is required",path:"dataModelUpdate.surfaceId"}),(!o.contents||!Array.isArray(o.contents))&&n.push({code:"INVALID_CONTENTS",message:"dataModelUpdate.contents must be an array",path:"dataModelUpdate.contents"});}else if("deleteSurface"in e){let{deleteSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"});}else n.push({code:"INVALID_MESSAGE_TYPE",message:"Message must contain one of: beginRendering, surfaceUpdate, dataModelUpdate, deleteSurface"});return {valid:n.length===0,errors:n,warnings:a}}function v(e,t={}){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e?b(e,t):"beginRendering"in e||"surfaceUpdate"in e||"dataModelUpdate"in e?P(e,t):"deleteSurface"in e?e.deleteSurface.surfaceId?{valid:true,errors:[],warnings:[]}:{valid:false,errors:[{code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"}],warnings:[]}:{valid:false,errors:[{code:"UNKNOWN_MESSAGE_TYPE",message:"Unknown message type"}],warnings:[]}}function Ce(e,t={}){let n=[],a=[];for(let o=0;o<e.length;o++){let r=e[o];if(!r)continue;let i=v(r,t);for(let s of i.errors)n.push({...s,path:`messages[${o}].${s.path??""}`});for(let s of i.warnings)a.push({...s,path:`messages[${o}].${s.path??""}`});}return {valid:n.length===0,errors:n,warnings:a}}function he(e,t,n,a){let o=new Set,r=false;for(let i=0;i<e.length;i++){let s=e[i];if(!s)continue;let u=`updateComponents.components[${i}]`;s.id?(o.has(s.id)&&t.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${s.id}`,path:`${u}.id`}),o.add(s.id),s.id==="root"&&(r=true)):t.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${u}.id`}),s.component?a.strict&&a.allowedComponents&&(a.allowedComponents.includes(s.component)||n.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${s.component}`,path:`${u}.component`})):t.push({code:"MISSING_COMPONENT_TYPE",message:"Component type is required",path:`${u}.component`});}!r&&a.strict&&n.push({code:"MISSING_ROOT_COMPONENT",message:'No component with id "root" found',path:"updateComponents.components"});}function xe(e,t,n,a){let o=new Set;for(let r=0;r<e.length;r++){let i=e[r];if(!i)continue;let s=`surfaceUpdate.components[${r}]`;if(i.id?(o.has(i.id)&&t.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${i.id}`,path:`${s}.id`}),o.add(i.id)):t.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${s}.id`}),!i.component||typeof i.component!="object")t.push({code:"MISSING_COMPONENT",message:"Component definition is required",path:`${s}.component`});else {let u=Object.keys(i.component)[0];u&&a.strict&&!Ie.includes(u)&&n.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${u}`,path:`${s}.component`});}}}function A(e){return typeof e=="object"&&e!==null&&"path"in e}function Oe(e){if(!A(e))return e}function Se(e){if(A(e))return e.path}function Te(e){return {path:e}}function Me(e,t){let n={...e};for(let a of Object.keys(t)){let o=t[a],r=n[a];o!==void 0&&typeof o=="object"&&o!==null&&!Array.isArray(o)&&typeof r=="object"&&r!==null&&!Array.isArray(r)?n[a]=Me(r,o):o!==void 0&&(n[a]=o);}return n}function ye(){return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{let t=Math.random()*16|0;return (e==="x"?t:t&3|8).toString(16)})}exports.A2UI_EXTENSION_URI=E;exports.A2UI_EXTENSION_URI_V08=_;exports.A2UI_MIME_TYPE=R;exports.DEFAULT_PATH_MAPPINGS=M;exports.STANDARD_CATALOG_ID=l;exports.audioPlayer=$;exports.beginRendering=T;exports.body=se;exports.button=C;exports.caption=ie;exports.card=q;exports.checkbox=z;exports.choicePicker=Q;exports.column=G;exports.createSurface=x;exports.createV08Messages=ge;exports.createV09Messages=ce;exports.dataModelInit=D;exports.dataModelUpdate=V;exports.dateTimeInput=K;exports.deepMerge=Me;exports.deleteSurface=de;exports.deleteSurfaceV08=le;exports.divider=Y;exports.flattenObjectToValueMap=m;exports.generateId=p;exports.getIdCounter=k;exports.getLiteralValue=Oe;exports.getPathValue=Se;exports.h1=te;exports.h2=ne;exports.h3=oe;exports.h4=ae;exports.h5=re;exports.icon=B;exports.image=j;exports.isPathBinding=A;exports.isV08Message=N;exports.isV09Message=U;exports.jsonlToMessages=fe;exports.list=H;exports.messagesToJsonl=me;exports.modal=X;exports.normalizePath=I;exports.objectToValueMap=g;exports.path=Te;exports.pathUpdate=ue;exports.resetIdCounter=w;exports.row=F;exports.slider=Z;exports.surfaceUpdate=y;exports.tabs=W;exports.text=d;exports.textButton=ee;exports.textField=J;exports.updateComponents=O;exports.updateDataModel=S;exports.updatesToValueMap=pe;exports.uuid=ye;exports.validateMessage=v;exports.validateMessages=Ce;exports.validateV08Message=P;exports.validateV09Message=b;exports.valueMapToObject=h;exports.valueToValueMap=c;exports.video=L;
1
+ 'use strict';var ke=require('ajv/dist/2020'),qe=require('ajv-formats');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var ke__default=/*#__PURE__*/_interopDefault(ke);var qe__default=/*#__PURE__*/_interopDefault(qe);var Ve=Object.defineProperty;var Ae=(e,t,n)=>t in e?Ve(e,t,{enumerable:true,configurable:true,writable:true,value:n}):e[t]=n;var S=(e,t,n)=>Ae(e,typeof t!="symbol"?t+"":t,n);function _(e){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e}var h="https://a2ui.dev/specification/0.9/standard_catalog_definition.json";var U="https://a2ui.dev/specification/0.9",E="application/json+a2ui";var b=0;function s(e="comp"){return `${e}_${Date.now()}_${b++}`}function R(){b=0;}function N(){return b}function c(e,t={}){let{id:n=s("text"),weight:r,usageHint:o}=t;return {id:n,component:"Text",text:e,...r!==void 0&&{weight:r},...o&&{usageHint:o}}}function k(e,t={}){let{id:n=s("image"),weight:r,fit:o,usageHint:a}=t;return {id:n,component:"Image",url:e,...r!==void 0&&{weight:r},...o&&{fit:o},...a&&{usageHint:a}}}function q(e,t={}){let{id:n=s("icon"),weight:r}=t;return {id:n,component:"Icon",name:e,...r!==void 0&&{weight:r}}}function F(e,t={}){let{id:n=s("video"),weight:r}=t;return {id:n,component:"Video",url:e,...r!==void 0&&{weight:r}}}function B(e,t={}){let{id:n=s("audio"),weight:r,description:o}=t;return {id:n,component:"AudioPlayer",url:e,...r!==void 0&&{weight:r},...o&&{description:o}}}function L(e,t={}){let{id:n=s("row"),weight:r,alignment:o,distribution:a}=t;return {id:n,component:"Row",children:e,...r!==void 0&&{weight:r},...o&&{alignment:o},...a&&{distribution:a}}}function H(e,t={}){let{id:n=s("column"),weight:r,alignment:o,distribution:a}=t;return {id:n,component:"Column",children:e,...r!==void 0&&{weight:r},...o&&{alignment:o},...a&&{distribution:a}}}function G(e,t={}){let{id:n=s("list"),weight:r,direction:o,alignment:a}=t;return {id:n,component:"List",children:e,...r!==void 0&&{weight:r},...o&&{direction:o},...a&&{alignment:a}}}function W(e,t={}){let{id:n=s("card"),weight:r}=t;return {id:n,component:"Card",child:e,...r!==void 0&&{weight:r}}}function z(e,t={}){let{id:n=s("tabs"),weight:r}=t;return {id:n,component:"Tabs",tabItems:e.map(o=>({title:o.title,child:o.childId})),...r!==void 0&&{weight:r}}}function J(e={}){let{id:t=s("divider"),weight:n,axis:r}=e;return {id:t,component:"Divider",...n!==void 0&&{weight:n},...r&&{axis:r}}}function Y(e,t,n={}){let{id:r=s("modal"),weight:o}=n;return {id:r,component:"Modal",entryPointChild:e,contentChild:t,...o!==void 0&&{weight:o}}}function v(e,t,n={}){let{id:r=s("button"),weight:o,primary:a}=n;return {id:r,component:"Button",child:e,action:t,...o!==void 0&&{weight:o},...a!==void 0&&{primary:a}}}function X(e,t,n={}){let{id:r=s("checkbox"),weight:o}=n;return {id:r,component:"CheckBox",label:e,value:t,...o!==void 0&&{weight:o}}}function K(e,t,n={}){let{id:r=s("textfield"),weight:o,usageHint:a,validationRegexp:i}=n;return {id:r,component:"TextField",label:e,...t!==void 0&&{text:t},...o!==void 0&&{weight:o},...a&&{usageHint:a},...i&&{validationRegexp:i}}}function Q(e,t={}){let{id:n=s("datetime"),weight:r,enableDate:o,enableTime:a,outputFormat:i,label:p}=t;return {id:n,component:"DateTimeInput",value:e,...r!==void 0&&{weight:r},...o!==void 0&&{enableDate:o},...a!==void 0&&{enableTime:a},...i&&{outputFormat:i},...p&&{label:p}}}function Z(e,t,n,r={}){let{id:o=s("choice"),weight:a,label:i}=r;return {id:o,component:"ChoicePicker",options:e,value:t,usageHint:n,...a!==void 0&&{weight:a},...i&&{label:i}}}function ee(e,t={}){let{id:n=s("slider"),weight:r,label:o,min:a,max:i}=t;return {id:n,component:"Slider",value:e,...r!==void 0&&{weight:r},...o&&{label:o},...a!==void 0&&{min:a},...i!==void 0&&{max:i}}}function te(e,t,n={}){let r=n.textId??s("btn_text"),o=c(e,{id:r}),a=v(r,t,n);return [o,a]}function ne(e,t={}){return c(e,{...t,usageHint:"h1"})}function oe(e,t={}){return c(e,{...t,usageHint:"h2"})}function re(e,t={}){return c(e,{...t,usageHint:"h3"})}function ae(e,t={}){return c(e,{...t,usageHint:"h4"})}function ie(e,t={}){return c(e,{...t,usageHint:"h5"})}function se(e,t={}){return c(e,{...t,usageHint:"caption"})}function pe(e,t={}){return c(e,{...t,usageHint:"body"})}function m(e,t=h){return {createSurface:{surfaceId:e,catalogId:t}}}function f(e,t){return {updateComponents:{surfaceId:e,components:t}}}function g(e,t,n,r="replace"){return {updateDataModel:{surfaceId:e,...n&&{path:n},op:r,...r!=="remove"&&{value:t}}}}function O(e){return {deleteSurface:{surfaceId:e}}}function ce(e){let{surfaceId:t,catalogId:n=h,components:r,dataModel:o}=e,a=[m(t,n),f(t,r)];return o&&a.push(g(t,o)),a}function de(e){return e.map(t=>JSON.stringify(t)).join(`
2
+ `)}function le(e){return e.split(`
3
+ `).filter(t=>t.trim()).map(t=>JSON.parse(t))}var M={};function ue(e,t=""){let n=[];for(let[r,o]of Object.entries(e)){let a=t?`${t}/${r}`:`/${r}`;n.push(l(a,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,r)=>l(String(r),n))};if(typeof t=="object"){let n=[];for(let[r,o]of Object.entries(t))n.push(l(r,o));return {key:e,valueMap:n}}return {key:e,valueString:String(t)}}function P(e,t={}){let n=e.replace(/\./g,"/");n.startsWith("/")||(n=`/${n}`);for(let[r,o]of Object.entries(t)){let a=new RegExp(`^/${r}(/|$)`);a.test(n)&&(n=n.replace(a,`/${o}$1`));}return n}function me(e,t="",n=M){let r=[];for(let o of e){let a=o.path.startsWith("/")?o.path:`${t}/${o.path}`,i=P(a,n);if(o.value!==null&&typeof o.value=="object"&&!Array.isArray(o.value)){let p=T(o.value,i);r.push(...p);}else r.push(l(i,o.value));}return r}function T(e,t){let n=[];for(let[r,o]of Object.entries(e)){let a=`${t}/${r}`;if(o!==null&&typeof o=="object"&&!Array.isArray(o)){let i=T(o,a);n.push(...i);}else n.push(l(a,o));}return n}function D(e){let t={};for(let n of e){let r=n.key.startsWith("/")?n.key.slice(1):n.key;n.valueString!==void 0?t[r]=n.valueString:n.valueNumber!==void 0?t[r]=n.valueNumber:n.valueBoolean!==void 0?t[r]=n.valueBoolean:n.valueMap!==void 0&&(t[r]=D(n.valueMap));}return t}var we=["Text","Image","Icon","Video","AudioPlayer","Row","Column","List","Card","Tabs","Divider","Modal","Button","CheckBox","TextField","DateTimeInput","ChoicePicker","Slider"];function j(e,t={}){let n=[],r=[];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"}):_e(o.components,n,r,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"}),o.op&&!["add","replace","remove"].includes(o.op)&&n.push({code:"INVALID_OP",message:"updateDataModel.op must be one of: add, replace, remove",path:"updateDataModel.op"}),o.op==="remove"&&o.value!==void 0&&r.push({code:"UNNECESSARY_VALUE",message:"updateDataModel.value should not be provided for remove operation",path:"updateDataModel.value"}),o.op!=="remove"&&o.value===void 0&&o.op==="add"&&n.push({code:"MISSING_VALUE",message:"updateDataModel.value is required for add operation",path:"updateDataModel.value"});}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:r}}function $(e,t={}){return j(e,t)}function fe(e,t={}){let n=[],r=[];for(let o=0;o<e.length;o++){let a=e[o];if(!a)continue;let i=$(a,t);for(let p of i.errors)n.push({...p,path:`messages[${o}].${p.path??""}`});for(let p of i.warnings)r.push({...p,path:`messages[${o}].${p.path??""}`});}return {valid:n.length===0,errors:n,warnings:r}}function _e(e,t,n,r){let o=new Set,a=false;for(let i=0;i<e.length;i++){let p=e[i];if(!p)continue;let x=`updateComponents.components[${i}]`;p.id?(o.has(p.id)&&t.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${p.id}`,path:`${x}.id`}),o.add(p.id),p.id==="root"&&(a=true)):t.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${x}.id`}),p.component?r.strict&&!we.includes(p.component)&&r.allowedComponents&&!r.allowedComponents.includes(p.component)&&n.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${p.component}`,path:`${x}.component`}):t.push({code:"MISSING_COMPONENT_TYPE",message:"Component type is required",path:`${x}.component`});}!a&&r.strict&&n.push({code:"MISSING_ROOT_COMPONENT",message:'No component with id "root" found',path:"updateComponents.components"});}var he={title:"A2UI (Agent to UI) Client-to-Server Event Schema",description:"Describes a JSON payload for a client-to-server event message.",type:"object",minProperties:1,maxProperties:1,properties:{userAction:{type:"object",description:"Reports a user-initiated action from a component.",properties:{name:{type:"string",description:"The name of the action, taken from the component's action.name property."},surfaceId:{type:"string",description:"The id of the surface where the event originated."},sourceComponentId:{type:"string",description:"The id of the component that triggered the event."},timestamp:{type:"string",format:"date-time",description:"An ISO 8601 timestamp of when the event occurred."},context:{type:"object",description:"A JSON object containing the key-value pairs from the component's action.context, after resolving all data bindings.",additionalProperties:true}},required:["name","surfaceId","sourceComponentId","timestamp","context"]},error:{description:"Reports a client-side error.",oneOf:[{type:"object",title:"Validation Failed Error",properties:{code:{const:"VALIDATION_FAILED"},surfaceId:{type:"string",description:"The id of the surface where the error occurred."},path:{type:"string",description:"The JSON pointer to the field that failed validation (e.g. '/components/0/text')."},message:{type:"string",description:"A short one-sentence description of why validation failed."}},required:["code","path","message","surfaceId"]},{type:"object",title:"Generic Error",properties:{code:{not:{const:"VALIDATION_FAILED"}},message:{type:"string",description:"A short one-sentence description of why the error occurred."},surfaceId:{type:"string",description:"The id of the surface where the error occurred."}},required:["code","surfaceId","message"],additionalProperties:true}]}},oneOf:[{required:["userAction"]},{required:["clientUiCapabilities"]},{required:["error"]}]};var ge={$schema:"https://json-schema.org/draft/2020-12/schema",$id:"https://a2ui.dev/specification/0.9/common_types.json",title:"A2UI Common Types",description:"Common type definitions used across A2UI schemas.",$defs:{stringOrPath:{description:"Represents a value that can be either a literal string or a path to a value in the data model.",oneOf:[{type:"string"},{type:"object",properties:{path:{type:"string"}},required:["path"],additionalProperties:false}]},numberOrPath:{description:"Represents a value that can be either a literal number or a path to a value in the data model.",oneOf:[{type:"number"},{type:"object",properties:{path:{type:"string"}},required:["path"],additionalProperties:false}]},booleanOrPath:{description:"Represents a value that can be either a literal boolean or a path to a value in the data model.",oneOf:[{type:"boolean"},{type:"object",properties:{path:{type:"string"}},required:["path"],additionalProperties:false}]},stringArrayOrPath:{description:"Represents a value that can be either a literal array of strings or a path to a value in the data model.",oneOf:[{type:"array",items:{type:"string"}},{type:"object",properties:{path:{type:"string"}},required:["path"],additionalProperties:false}]},id:{type:"string",description:"The unique identifier for this component."},ComponentCommon:{type:"object",properties:{id:{$ref:"#/$defs/id"},weight:{type:"number",description:"The relative weight of this component within a Row or Column. This is similar to the CSS 'flex-grow' property."}},required:["id"]},contextValue:{description:"A value that can be a string, number, boolean, or a path to a value.",oneOf:[{type:"string"},{type:"number"},{type:"boolean"},{type:"object",properties:{path:{type:"string"}},required:["path"],additionalProperties:false}]},childrenProperty:{oneOf:[{type:"array",items:{type:"string"},description:"A static list of child component IDs."},{type:"object",description:"A template for generating a dynamic list of children from a data model list. The `componentId` is the component to use as a template.",properties:{componentId:{$ref:"#/$defs/id"},path:{type:"string",description:"The path to the list of component property objects in the data model."}},required:["componentId","path"],additionalProperties:false}]}}};var ye={$schema:"https://json-schema.org/draft/2020-12/schema",$id:"https://a2ui.dev/specification/0.9/server_to_client.json",title:"A2UI Message Schema",description:"Describes a JSON payload for an A2UI (Agent to UI) message, which is used to dynamically construct and update user interfaces.",type:"object",oneOf:[{$ref:"#/$defs/CreateSurfaceMessage"},{$ref:"#/$defs/UpdateComponentsMessage"},{$ref:"#/$defs/UpdateDataModelMessage"},{$ref:"#/$defs/DeleteSurfaceMessage"}],$defs:{CreateSurfaceMessage:{properties:{createSurface:{type:"object",description:"Signals the client to create a new surface and begin rendering it. When this message is sent, the client will expect 'updateComponents' and/or 'updateDataModel' messages for the same surfaceId that define the component tree.",properties:{surfaceId:{type:"string",description:"The unique identifier for the UI surface to be rendered."},catalogId:{title:"Catalog ID",description:"A string that uniquely identifies this catalog. It is recommended to prefix this with an internet domain that you own, to avoid conflicts e.g. mycompany.com:somecatalog'.",type:"string"}},required:["surfaceId","catalogId"],additionalProperties:false}},required:["createSurface"],additionalProperties:false},UpdateComponentsMessage:{properties:{updateComponents:{type:"object",description:"Updates a surface with a new set of components. This message can be sent multiple times to update the component tree of an existing surface. One of the components in one of the components lists MUST have an 'id' of 'root' to serve as the root of the component tree. The createSurface message MUST have been previously sent with the 'catalogId' that is in this message.",properties:{surfaceId:{type:"string",description:"The unique identifier for the UI surface to be updated."},components:{type:"array",description:"A list containing all UI components for the surface.",minItems:1,items:{$ref:"standard_catalog_definition.json#/$defs/anyComponent"}}},required:["surfaceId","components"],additionalProperties:false}},required:["updateComponents"],additionalProperties:false},UpdateDataModelMessage:{properties:{updateDataModel:{type:"object",description:"Updates the data model for an existing surface. This message can be sent multiple times to update the data model. The createSurface message MUST have been previously sent with the 'catalogId' that is in this message.",properties:{surfaceId:{type:"string",description:"The unique identifier for the UI surface this data model update applies to."},path:{type:"string",description:"An optional path to a location within the data model (e.g., '/user/name'). If omitted, or set to '/', refers to the entire data model."},op:{type:"string",description:"The operation to perform on the data model. Defaults to 'replace' if omitted.",enum:["add","replace","remove"]},value:{description:"The data to be updated in the data model. Required for 'add' and 'replace' operations. Not allowed for 'remove' operation.",additionalProperties:true}},required:["surfaceId"],additionalProperties:false}},required:["updateDataModel"],additionalProperties:false},DeleteSurfaceMessage:{properties:{deleteSurface:{type:"object",description:"Signals the client to delete the surface identified by 'surfaceId'. The createSurface message MUST have been previously sent with the 'catalogId' that is in this message.",properties:{surfaceId:{type:"string",description:"The unique identifier for the UI surface to be deleted."}},required:["surfaceId"],additionalProperties:false}},required:["deleteSurface"],additionalProperties:false}}};var Ce={$schema:"https://json-schema.org/draft/2020-12/schema",$id:"https://a2ui.dev/specification/0.9/standard_catalog_definition.json",title:"A2UI Component Catalog",description:"Definitions for the standard catalog of A2UI components.",$defs:{Theme:{type:"object",description:"Theming information for the UI.",properties:{font:{type:"string",description:"The primary font for the UI."},primaryColor:{type:"string",description:"The primary UI color as a hexadecimal code (e.g., '#00BFFF').",pattern:"^#[0-9a-fA-F]{6}$"}},additionalProperties:false},anyComponent:{oneOf:[{$ref:"#/$defs/Text"},{$ref:"#/$defs/Image"},{$ref:"#/$defs/Icon"},{$ref:"#/$defs/Video"},{$ref:"#/$defs/AudioPlayer"},{$ref:"#/$defs/Row"},{$ref:"#/$defs/Column"},{$ref:"#/$defs/List"},{$ref:"#/$defs/Card"},{$ref:"#/$defs/Tabs"},{$ref:"#/$defs/Divider"},{$ref:"#/$defs/Modal"},{$ref:"#/$defs/Button"},{$ref:"#/$defs/CheckBox"},{$ref:"#/$defs/TextField"},{$ref:"#/$defs/DateTimeInput"},{$ref:"#/$defs/ChoicePicker"},{$ref:"#/$defs/Slider"}],discriminator:{propertyName:"component"}},Text:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Text"},text:{$ref:"common_types.json#/$defs/stringOrPath",description:"The text content to display. While simple Markdown formatting is supported (i.e. without HTML, images, or links), utilizing dedicated UI components is generally preferred for a richer and more structured presentation."},usageHint:{type:"string",description:"A hint for the base text style.",enum:["h1","h2","h3","h4","h5","caption","body"]}},required:["component","text"]}],unevaluatedProperties:false},Image:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Image"},url:{$ref:"common_types.json#/$defs/stringOrPath",description:"The URL of the image to display."},fit:{type:"string",description:"Specifies how the image should be resized to fit its container. This corresponds to the CSS 'object-fit' property.",enum:["contain","cover","fill","none","scale-down"]},usageHint:{type:"string",description:"A hint for the image size and style.",enum:["icon","avatar","smallFeature","mediumFeature","largeFeature","header"]}},required:["component","url"]}],unevaluatedProperties:false},Icon:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Icon"},name:{description:"The name of the icon to display.",oneOf:[{type:"string",enum:["accountCircle","add","arrowBack","arrowForward","attachFile","calendarToday","call","camera","check","close","delete","download","edit","event","error","fastForward","favorite","favoriteOff","folder","help","home","info","locationOn","lock","lockOpen","mail","menu","moreVert","moreHoriz","notificationsOff","notifications","pause","payment","person","phone","photo","play","print","refresh","rewind","search","send","settings","share","shoppingCart","skipNext","skipPrevious","star","starHalf","starOff","stop","upload","visibility","visibilityOff","volumeDown","volumeMute","volumeOff","volumeUp","warning"]},{type:"object",properties:{path:{type:"string"}},required:["path"],additionalProperties:false}]}},required:["component","name"]}],unevaluatedProperties:false},Video:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Video"},url:{$ref:"common_types.json#/$defs/stringOrPath",description:"The URL of the video to display."}},required:["component","url"]}],unevaluatedProperties:false},AudioPlayer:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"AudioPlayer"},url:{$ref:"common_types.json#/$defs/stringOrPath",description:"The URL of the audio to be played."},description:{description:"A description of the audio, such as a title or summary.",$ref:"common_types.json#/$defs/stringOrPath"}},required:["component","url"]}],unevaluatedProperties:false},Row:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",description:"A layout component that arranges its children horizontally. To create a grid layout, nest Columns within this Row.",properties:{component:{const:"Row"},children:{description:"Defines the children. Use an array of strings for a fixed set of children, or a template object to generate children from a data list. Children cannot be defined inline, they must be referred to by ID.",$ref:"common_types.json#/$defs/childrenProperty"},distribution:{type:"string",description:"Defines the arrangement of children along the main axis (horizontally). Use 'spaceBetween' to push items to the edges, or 'start'/'end'/'center' to pack them together.",enum:["center","end","spaceAround","spaceBetween","spaceEvenly","start","stretch"]},alignment:{type:"string",description:"Defines the alignment of children along the cross axis (vertically). This is similar to the CSS 'align-items' property, but uses camelCase values (e.g., 'start').",enum:["start","center","end","stretch"]}},required:["component","children"]}],unevaluatedProperties:false},Column:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",description:"A layout component that arranges its children vertically. To create a grid layout, nest Rows within this Column.",properties:{component:{const:"Column"},children:{description:"Defines the children. Use an array of strings for a fixed set of children, or a template object to generate children from a data list. Children cannot be defined inline, they must be referred to by ID.",$ref:"common_types.json#/$defs/childrenProperty"},distribution:{type:"string",description:"Defines the arrangement of children along the main axis (vertically). Use 'spaceBetween' to push items to the edges (e.g. header at top, footer at bottom), or 'start'/'end'/'center' to pack them together.",enum:["start","center","end","spaceBetween","spaceAround","spaceEvenly","stretch"]},alignment:{type:"string",description:"Defines the alignment of children along the cross axis (horizontally). This is similar to the CSS 'align-items' property.",enum:["center","end","start","stretch"]}},required:["component","children"]}],unevaluatedProperties:false},List:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"List"},children:{description:"Defines the children. Use an array of strings for a fixed set of children, or a template object to generate children from a data list.",$ref:"common_types.json#/$defs/childrenProperty"},direction:{type:"string",description:"The direction in which the list items are laid out.",enum:["vertical","horizontal"]},alignment:{type:"string",description:"Defines the alignment of children along the cross axis.",enum:["start","center","end","stretch"]}},required:["component","children"]}],unevaluatedProperties:false},Card:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Card"},child:{type:"string",description:"The ID of the single child component to be rendered inside the card. To display multiple elements, you MUST wrap them in a layout component (like Column or Row) and pass that container's ID here. Do NOT pass multiple IDs or a non-existent ID. Do NOT define the child component inline."}},required:["component","child"]}],unevaluatedProperties:false},Tabs:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Tabs"},tabItems:{type:"array",description:"An array of objects, where each object defines a tab with a title and a child component.",items:{type:"object",properties:{title:{description:"The tab title.",$ref:"common_types.json#/$defs/stringOrPath"},child:{type:"string",description:"The ID of the child component. Do NOT define the component inline."}},required:["title","child"],additionalProperties:false}}},required:["component","tabItems"]}],unevaluatedProperties:false},Divider:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Divider"},axis:{type:"string",description:"The orientation of the divider.",enum:["horizontal","vertical"]}},required:["component"]}],unevaluatedProperties:false},Modal:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Modal"},entryPointChild:{type:"string",description:"The ID of the component that opens the modal when interacted with (e.g., a button). Do NOT define the component inline."},contentChild:{type:"string",description:"The ID of the component to be displayed inside the modal. Do NOT define the component inline."}},required:["component","entryPointChild","contentChild"]}],unevaluatedProperties:false},Button:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Button"},child:{type:"string",description:"The ID of the child component. Use a 'Text' component for a labeled button. Only use an 'Icon' if the requirements explicitly ask for an icon-only button. Do NOT define the child component inline."},primary:{type:"boolean",description:"Indicates if this button should be styled as the primary action."},action:{type:"object",description:"The client-side action to be dispatched when the button is clicked. It includes the action's name and an optional context payload.",properties:{name:{type:"string"},context:{type:"object",description:"A JSON object containing the key-value pairs for the action context. Values can be literals or paths. Use literal values unless the value must be dynamically bound to the data model. Do NOT use paths for static IDs.",additionalProperties:{$ref:"common_types.json#/$defs/contextValue"}}},required:["name"],additionalProperties:false}},required:["component","child","action"]}],unevaluatedProperties:false},CheckBox:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"CheckBox"},label:{$ref:"common_types.json#/$defs/stringOrPath",description:"The text to display next to the checkbox."},value:{$ref:"common_types.json#/$defs/booleanOrPath",description:"The current state of the checkbox (true for checked, false for unchecked)."}},required:["component","label","value"]}],unevaluatedProperties:false},TextField:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"TextField"},label:{$ref:"common_types.json#/$defs/stringOrPath",description:"The text label for the input field."},text:{$ref:"common_types.json#/$defs/stringOrPath",description:"The value of the text field."},usageHint:{type:"string",description:"The type of input field to display.",enum:["longText","number","shortText","obscured"]},validationRegexp:{type:"string",description:"A regular expression used for client-side validation of the input."}},required:["component","label"]}],unevaluatedProperties:false},DateTimeInput:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"DateTimeInput"},value:{$ref:"common_types.json#/$defs/stringOrPath",description:"The selected date and/or time value in ISO 8601 format. If not yet set, initialize with an empty string."},enableDate:{type:"boolean",description:"If true, allows the user to select a date."},enableTime:{type:"boolean",description:"If true, allows the user to select a time."},outputFormat:{type:"string",description:"The desired format for the output string after a date or time is selected."},label:{$ref:"common_types.json#/$defs/stringOrPath",description:"The text label for the input field."}},required:["component","value"]}],unevaluatedProperties:false},ChoicePicker:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",description:"A component that allows selecting one or more options from a list.",properties:{component:{const:"ChoicePicker"},label:{$ref:"common_types.json#/$defs/stringOrPath",description:"The label for the group of options."},usageHint:{type:"string",description:"A hint for how the choice picker should be displayed and behave.",enum:["multipleSelection","mutuallyExclusive"]},options:{type:"array",description:"The list of available options to choose from.",items:{type:"object",properties:{label:{description:"The text to display for this option.",$ref:"common_types.json#/$defs/stringOrPath"},value:{type:"string",description:"The stable value associated with this option."}},required:["label","value"],additionalProperties:false}},value:{$ref:"common_types.json#/$defs/stringArrayOrPath",description:"The list of currently selected values. This should be bound to a string array in the data model."}},required:["component","options","value","usageHint"]}],unevaluatedProperties:false},Slider:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Slider"},label:{$ref:"common_types.json#/$defs/stringOrPath",description:"The label for the slider."},min:{type:"number",description:"The minimum value of the slider."},max:{type:"number",description:"The maximum value of the slider."},value:{$ref:"common_types.json#/$defs/numberOrPath",description:"The current value of the slider."}},required:["component","value"]}],unevaluatedProperties:false}}};var y=class{constructor(){S(this,"ajv");S(this,"serverToClientValidator");S(this,"clientToServerValidator");this.ajv=new ke__default.default({allErrors:true,strict:false}),qe__default.default(this.ajv),this.ajv.addSchema(ge,"common_types.json"),this.ajv.addSchema(Ce,"standard_catalog_definition.json"),this.serverToClientValidator=this.ajv.compile(ye),this.clientToServerValidator=this.ajv.compile(he);}validateServerToClientMessage(t){return this.serverToClientValidator(t)?{valid:true,errors:[]}:{valid:false,errors:this.formatErrors(this.serverToClientValidator.errors||[])}}validateClientToServerMessage(t){return this.clientToServerValidator(t)?{valid:true,errors:[]}:{valid:false,errors:this.formatErrors(this.clientToServerValidator.errors||[])}}validateMessages(t){let n=[];for(let r=0;r<t.length;r++){let o=this.validateServerToClientMessage(t[r]);o.valid||n.push(...o.errors.map(a=>({...a,path:`/messages/${r}${a.path}`})));}return {valid:n.length===0,errors:n}}formatErrors(t){return t.map(n=>({path:n.instancePath||"/",message:n.message||"Validation failed",keyword:n.keyword,expected:n.params,actual:void 0}))}},V=null;function C(){return V||(V=new y),V}function Ie(e){return C().validateServerToClientMessage(e)}function xe(e){return C().validateClientToServerMessage(e)}function Se(e){return C().validateMessages(e)}function A(e){return typeof e=="object"&&e!==null&&"path"in e}function Fe(e){if(!A(e))return e}function Be(e){if(A(e))return e.path}function Le(e){return {path:e}}function Oe(e,t){let n={...e};for(let r of Object.keys(t)){let o=t[r],a=n[r];o!==void 0&&typeof o=="object"&&o!==null&&!Array.isArray(o)&&typeof a=="object"&&a!==null&&!Array.isArray(a)?n[r]=Oe(a,o):o!==void 0&&(n[r]=o);}return n}function He(){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"},w=0;function I(e="surface"){return w++,`${e}-${Date.now()}-${w}`}function Te(){w=0;}function u(e,t,n){let r=n??I();return t.find(i=>i.id===e)||console.warn(`[A2UI] Root component "${e}" not found in components list`),{messages:[m(r),f(r,t)],surfaceId:r}}function be(e,t,n,r){let o=r??I();return {messages:[m(o),f(o,t),g(o,n)],surfaceId:o}}function ve(e){return O(e)}function Me(e,t){return u(e,t,d.CHAT)}function Pe(e,t){return u(e,t,d.RECOMMENDATION)}function De(e,t){return u(e,t,d.INPUT_FORM)}function je(e,t){return u(e,t,d.ORCHESTRATION)}function $e(e,t){return u(e,t,d.STATUS)}
4
+ exports.A2UISchemaValidator=y;exports.A2UI_EXTENSION_URI=U;exports.A2UI_MIME_TYPE=E;exports.DEFAULT_PATH_MAPPINGS=M;exports.STANDARD_CATALOG_ID=h;exports.SURFACE_IDS=d;exports.audioPlayer=B;exports.body=pe;exports.button=v;exports.caption=se;exports.card=W;exports.checkbox=X;exports.choicePicker=Z;exports.column=H;exports.createA2UISurface=u;exports.createA2UISurfaceWithData=be;exports.createChatSurface=Me;exports.createDeleteSurfaceMessage=ve;exports.createInputFormSurface=De;exports.createOrchestrationSurface=je;exports.createRecommendationSurface=Pe;exports.createStatusSurface=$e;exports.createSurface=m;exports.createV09Messages=ce;exports.dateTimeInput=Q;exports.deepMerge=Oe;exports.deleteSurface=O;exports.divider=J;exports.flattenObjectToValueMap=T;exports.generateId=s;exports.generateSurfaceId=I;exports.getIdCounter=N;exports.getLiteralValue=Fe;exports.getPathValue=Be;exports.getSchemaValidator=C;exports.h1=ne;exports.h2=oe;exports.h3=re;exports.h4=ae;exports.h5=ie;exports.icon=q;exports.image=k;exports.isPathBinding=A;exports.isV09Message=_;exports.jsonlToMessages=le;exports.list=G;exports.messagesToJsonl=de;exports.modal=Y;exports.normalizePath=P;exports.objectToValueMap=ue;exports.path=Le;exports.resetIdCounter=R;exports.resetSurfaceIdCounter=Te;exports.row=L;exports.slider=ee;exports.tabs=z;exports.text=c;exports.textButton=te;exports.textField=K;exports.updateComponents=f;exports.updateDataModel=g;exports.updatesToValueMap=me;exports.uuid=He;exports.validateClientMessage=xe;exports.validateMessage=$;exports.validateMessages=fe;exports.validateMessagesWithSchema=Se;exports.validateV09Message=j;exports.validateWithSchema=Ie;exports.valueMapToObject=D;exports.valueToValueMap=l;exports.video=F;
package/dist/index.d.cts CHANGED
@@ -1,5 +1,6 @@
1
- export { B as BooleanOrPath, d as BooleanValue, C as ContextValue, N as NumberOrPath, c as NumberValue, a as StringArrayOrPath, e as StringArrayValue, S as StringOrPath, b as StringValue } from './primitives-nmkVz-tB.cjs';
2
- export { A2UI_EXTENSION_URI, A2UI_EXTENSION_URI_V08, A2UI_MIME_TYPE, Action, ActionContextItem, ActionV08, AnyComponent, AudioPlayerComponent, BeginRenderingMessage, ButtonComponent, CardComponent, CheckBoxComponent, ChildrenProperty, ChoicePickerComponent, ClientToServerMessage, ColumnComponent, ComponentCommon, ComponentInstance, ComponentInstanceV08, ComponentType, CreateSurfaceMessage, DataArray, DataChangeEvent, DataModelUpdateMessage, DataObject, DataValue, DateTimeInputComponent, DeleteSurfaceMessage, DeleteSurfaceMessageV08, DividerComponent, IconComponent, ImageComponent, ListComponent, ModalComponent, RowComponent, STANDARD_CATALOG_ID, ServerToClientMessage, ServerToClientMessageV08, ServerToClientMessageV09, SliderComponent, StandardIconName, SurfaceUpdateMessage, TabsComponent, TextComponent, TextFieldComponent, Theme, UpdateComponentsMessage, UpdateDataModelMessage, UserActionEvent, ValueMap, VideoComponent, isV08Message, isV09Message } from './types/index.cjs';
3
- export { AudioPlayerOptions, ButtonOptions, CardOptions, CheckBoxOptions, ChoicePickerOptions, ComponentOptions, DEFAULT_PATH_MAPPINGS, DateTimeInputOptions, DividerOptions, IconOptions, ImageOptions, LayoutOptions, ListOptions, ModalOptions, PathMappings, SliderOptions, TabItem, TabsOptions, TextFieldOptions, TextOptions, UpdateDataItem, VideoOptions, audioPlayer, beginRendering, body, button, caption, card, checkbox, choicePicker, column, createSurface, createV08Messages, createV09Messages, dataModelInit, dataModelUpdate, dateTimeInput, deleteSurface, deleteSurfaceV08, divider, flattenObjectToValueMap, generateId, getIdCounter, h1, h2, h3, h4, h5, icon, image, jsonlToMessages, list, messagesToJsonl, modal, normalizePath, objectToValueMap, pathUpdate, resetIdCounter, row, slider, surfaceUpdate, tabs, text, textButton, textField, updateComponents, updateDataModel, updatesToValueMap, valueMapToObject, valueToValueMap, video } from './builders/index.cjs';
4
- export { ValidationError, ValidationOptions, ValidationResult, ValidationWarning, validateMessage, validateMessages, validateV08Message, validateV09Message } from './validators/index.cjs';
1
+ export { B as BooleanOrPath, C as ContextValue, N as NumberOrPath, a as StringArrayOrPath, S as StringOrPath } from './primitives-DLbBDhLq.cjs';
2
+ export { A2UI_EXTENSION_URI, A2UI_MIME_TYPE, Action, AnyComponent, AudioPlayerComponent, ButtonComponent, CardComponent, CheckBoxComponent, ChildrenProperty, ChoicePickerComponent, ClientErrorMessage, ClientToServerMessage, ColumnComponent, ComponentCommon, ComponentInstance, ComponentType, CreateSurfaceMessage, DataArray, DataChangeEvent, DataObject, DataValue, DateTimeInputComponent, DeleteSurfaceMessage, DividerComponent, GenericError, IconComponent, ImageComponent, ListComponent, ModalComponent, RowComponent, STANDARD_CATALOG_ID, ServerToClientMessageV09 as ServerToClientMessage, ServerToClientMessageV09, SliderComponent, StandardIconName, TabsComponent, TextComponent, TextFieldComponent, Theme, UpdateComponentsMessage, UpdateDataModelMessage, UserActionEvent, ValidationFailedError, VideoComponent, isV09Message } from './types/index.cjs';
3
+ export { AudioPlayerOptions, ButtonOptions, CardOptions, CheckBoxOptions, ChoicePickerOptions, ComponentOptions, DEFAULT_PATH_MAPPINGS, DateTimeInputOptions, DividerOptions, IconOptions, ImageOptions, LayoutOptions, ListOptions, ModalOptions, PathMappings, SliderOptions, TabItem, TabsOptions, TextFieldOptions, TextOptions, UpdateDataItem, VideoOptions, audioPlayer, body, button, caption, card, checkbox, choicePicker, column, createSurface, createV09Messages, dateTimeInput, deleteSurface, divider, flattenObjectToValueMap, generateId, getIdCounter, h1, h2, h3, h4, h5, icon, image, jsonlToMessages, list, messagesToJsonl, modal, normalizePath, objectToValueMap, resetIdCounter, row, slider, tabs, text, textButton, textField, updateComponents, updateDataModel, updatesToValueMap, valueMapToObject, valueToValueMap, video } from './builders/index.cjs';
4
+ export { A2UISchemaValidator, SchemaValidationError, SchemaValidationResult, ValidationError, ValidationOptions, ValidationResult, ValidationWarning, getSchemaValidator, validateClientMessage, validateMessage, validateMessages, validateMessagesWithSchema, validateV09Message, validateWithSchema } from './validators/index.cjs';
5
5
  export { deepMerge, getLiteralValue, getPathValue, isPathBinding, path, uuid } from './utils/index.cjs';
6
+ export { SURFACE_IDS, SurfaceConfig, SurfaceIdType, SurfaceResult, createA2UISurface, createA2UISurfaceWithData, createChatSurface, createDeleteSurfaceMessage, createInputFormSurface, createOrchestrationSurface, createRecommendationSurface, createStatusSurface, generateSurfaceId, resetSurfaceIdCounter } from './surface/index.cjs';
package/dist/index.d.ts CHANGED
@@ -1,5 +1,6 @@
1
- export { B as BooleanOrPath, d as BooleanValue, C as ContextValue, N as NumberOrPath, c as NumberValue, a as StringArrayOrPath, e as StringArrayValue, S as StringOrPath, b as StringValue } from './primitives-nmkVz-tB.js';
2
- export { A2UI_EXTENSION_URI, A2UI_EXTENSION_URI_V08, A2UI_MIME_TYPE, Action, ActionContextItem, ActionV08, AnyComponent, AudioPlayerComponent, BeginRenderingMessage, ButtonComponent, CardComponent, CheckBoxComponent, ChildrenProperty, ChoicePickerComponent, ClientToServerMessage, ColumnComponent, ComponentCommon, ComponentInstance, ComponentInstanceV08, ComponentType, CreateSurfaceMessage, DataArray, DataChangeEvent, DataModelUpdateMessage, DataObject, DataValue, DateTimeInputComponent, DeleteSurfaceMessage, DeleteSurfaceMessageV08, DividerComponent, IconComponent, ImageComponent, ListComponent, ModalComponent, RowComponent, STANDARD_CATALOG_ID, ServerToClientMessage, ServerToClientMessageV08, ServerToClientMessageV09, SliderComponent, StandardIconName, SurfaceUpdateMessage, TabsComponent, TextComponent, TextFieldComponent, Theme, UpdateComponentsMessage, UpdateDataModelMessage, UserActionEvent, ValueMap, VideoComponent, isV08Message, isV09Message } from './types/index.js';
3
- export { AudioPlayerOptions, ButtonOptions, CardOptions, CheckBoxOptions, ChoicePickerOptions, ComponentOptions, DEFAULT_PATH_MAPPINGS, DateTimeInputOptions, DividerOptions, IconOptions, ImageOptions, LayoutOptions, ListOptions, ModalOptions, PathMappings, SliderOptions, TabItem, TabsOptions, TextFieldOptions, TextOptions, UpdateDataItem, VideoOptions, audioPlayer, beginRendering, body, button, caption, card, checkbox, choicePicker, column, createSurface, createV08Messages, createV09Messages, dataModelInit, dataModelUpdate, dateTimeInput, deleteSurface, deleteSurfaceV08, divider, flattenObjectToValueMap, generateId, getIdCounter, h1, h2, h3, h4, h5, icon, image, jsonlToMessages, list, messagesToJsonl, modal, normalizePath, objectToValueMap, pathUpdate, resetIdCounter, row, slider, surfaceUpdate, tabs, text, textButton, textField, updateComponents, updateDataModel, updatesToValueMap, valueMapToObject, valueToValueMap, video } from './builders/index.js';
4
- export { ValidationError, ValidationOptions, ValidationResult, ValidationWarning, validateMessage, validateMessages, validateV08Message, validateV09Message } from './validators/index.js';
1
+ export { B as BooleanOrPath, C as ContextValue, N as NumberOrPath, a as StringArrayOrPath, S as StringOrPath } from './primitives-DLbBDhLq.js';
2
+ export { A2UI_EXTENSION_URI, A2UI_MIME_TYPE, Action, AnyComponent, AudioPlayerComponent, ButtonComponent, CardComponent, CheckBoxComponent, ChildrenProperty, ChoicePickerComponent, ClientErrorMessage, ClientToServerMessage, ColumnComponent, ComponentCommon, ComponentInstance, ComponentType, CreateSurfaceMessage, DataArray, DataChangeEvent, DataObject, DataValue, DateTimeInputComponent, DeleteSurfaceMessage, DividerComponent, GenericError, IconComponent, ImageComponent, ListComponent, ModalComponent, RowComponent, STANDARD_CATALOG_ID, ServerToClientMessageV09 as ServerToClientMessage, ServerToClientMessageV09, SliderComponent, StandardIconName, TabsComponent, TextComponent, TextFieldComponent, Theme, UpdateComponentsMessage, UpdateDataModelMessage, UserActionEvent, ValidationFailedError, VideoComponent, isV09Message } from './types/index.js';
3
+ export { AudioPlayerOptions, ButtonOptions, CardOptions, CheckBoxOptions, ChoicePickerOptions, ComponentOptions, DEFAULT_PATH_MAPPINGS, DateTimeInputOptions, DividerOptions, IconOptions, ImageOptions, LayoutOptions, ListOptions, ModalOptions, PathMappings, SliderOptions, TabItem, TabsOptions, TextFieldOptions, TextOptions, UpdateDataItem, VideoOptions, audioPlayer, body, button, caption, card, checkbox, choicePicker, column, createSurface, createV09Messages, dateTimeInput, deleteSurface, divider, flattenObjectToValueMap, generateId, getIdCounter, h1, h2, h3, h4, h5, icon, image, jsonlToMessages, list, messagesToJsonl, modal, normalizePath, objectToValueMap, resetIdCounter, row, slider, tabs, text, textButton, textField, updateComponents, updateDataModel, updatesToValueMap, valueMapToObject, valueToValueMap, video } from './builders/index.js';
4
+ export { A2UISchemaValidator, SchemaValidationError, SchemaValidationResult, ValidationError, ValidationOptions, ValidationResult, ValidationWarning, getSchemaValidator, validateClientMessage, validateMessage, validateMessages, validateMessagesWithSchema, validateV09Message, validateWithSchema } from './validators/index.js';
5
5
  export { deepMerge, getLiteralValue, getPathValue, isPathBinding, path, uuid } from './utils/index.js';
6
+ export { SURFACE_IDS, SurfaceConfig, SurfaceIdType, SurfaceResult, createA2UISurface, createA2UISurfaceWithData, createChatSurface, createDeleteSurfaceMessage, createInputFormSurface, createOrchestrationSurface, createRecommendationSurface, createStatusSurface, generateSurfaceId, resetSurfaceIdCounter } from './surface/index.js';
package/dist/index.js CHANGED
@@ -1,3 +1,4 @@
1
- function U(e){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e}function N(e){return "beginRendering"in e||"surfaceUpdate"in e||"dataModelUpdate"in e}var l="https://a2ui.dev/specification/0.9/standard_catalog_definition.json",_="https://a2ui.org/a2a-extension/a2ui/v0.8",E="https://a2ui.dev/specification/0.9",R="application/json+a2ui";var f=0;function p(e="comp"){return `${e}_${Date.now()}_${f++}`}function w(){f=0;}function k(){return f}function d(e,t={}){let{id:n=p("text"),weight:a,usageHint:o}=t;return {id:n,component:"Text",text:e,...a!==void 0&&{weight:a},...o&&{usageHint:o}}}function j(e,t={}){let{id:n=p("image"),weight:a,fit:o,usageHint:r}=t;return {id:n,component:"Image",url:e,...a!==void 0&&{weight:a},...o&&{fit:o},...r&&{usageHint:r}}}function B(e,t={}){let{id:n=p("icon"),weight:a}=t;return {id:n,component:"Icon",name:e,...a!==void 0&&{weight:a}}}function L(e,t={}){let{id:n=p("video"),weight:a}=t;return {id:n,component:"Video",url:e,...a!==void 0&&{weight:a}}}function $(e,t={}){let{id:n=p("audio"),weight:a,description:o}=t;return {id:n,component:"AudioPlayer",url:e,...a!==void 0&&{weight:a},...o&&{description:o}}}function F(e,t={}){let{id:n=p("row"),weight:a,alignment:o,distribution:r}=t;return {id:n,component:"Row",children:e,...a!==void 0&&{weight:a},...o&&{alignment:o},...r&&{distribution:r}}}function G(e,t={}){let{id:n=p("column"),weight:a,alignment:o,distribution:r}=t;return {id:n,component:"Column",children:e,...a!==void 0&&{weight:a},...o&&{alignment:o},...r&&{distribution:r}}}function H(e,t={}){let{id:n=p("list"),weight:a,direction:o,alignment:r}=t;return {id:n,component:"List",children:e,...a!==void 0&&{weight:a},...o&&{direction:o},...r&&{alignment:r}}}function q(e,t={}){let{id:n=p("card"),weight:a}=t;return {id:n,component:"Card",child:e,...a!==void 0&&{weight:a}}}function W(e,t={}){let{id:n=p("tabs"),weight:a}=t;return {id:n,component:"Tabs",tabItems:e.map(o=>({title:o.title,child:o.childId})),...a!==void 0&&{weight:a}}}function Y(e={}){let{id:t=p("divider"),weight:n,axis:a}=e;return {id:t,component:"Divider",...n!==void 0&&{weight:n},...a&&{axis:a}}}function X(e,t,n={}){let{id:a=p("modal"),weight:o}=n;return {id:a,component:"Modal",entryPointChild:e,contentChild:t,...o!==void 0&&{weight:o}}}function C(e,t,n={}){let{id:a=p("button"),weight:o,primary:r}=n;return {id:a,component:"Button",child:e,action:t,...o!==void 0&&{weight:o},...r!==void 0&&{primary:r}}}function z(e,t,n={}){let{id:a=p("checkbox"),weight:o}=n;return {id:a,component:"CheckBox",label:e,value:t,...o!==void 0&&{weight:o}}}function J(e,t,n={}){let{id:a=p("textfield"),weight:o,usageHint:r,validationRegexp:i}=n;return {id:a,component:"TextField",label:e,...t!==void 0&&{text:t},...o!==void 0&&{weight:o},...r&&{usageHint:r},...i&&{validationRegexp:i}}}function K(e,t={}){let{id:n=p("datetime"),weight:a,enableDate:o,enableTime:r,outputFormat:i,label:s}=t;return {id:n,component:"DateTimeInput",value:e,...a!==void 0&&{weight:a},...o!==void 0&&{enableDate:o},...r!==void 0&&{enableTime:r},...i&&{outputFormat:i},...s&&{label:s}}}function Q(e,t,n,a={}){let{id:o=p("choice"),weight:r,label:i}=a;return {id:o,component:"ChoicePicker",options:e,value:t,usageHint:n,...r!==void 0&&{weight:r},...i&&{label:i}}}function Z(e,t={}){let{id:n=p("slider"),weight:a,label:o,min:r,max:i}=t;return {id:n,component:"Slider",value:e,...a!==void 0&&{weight:a},...o&&{label:o},...r!==void 0&&{min:r},...i!==void 0&&{max:i}}}function ee(e,t,n={}){let a=n.textId??p("btn_text"),o=d(e,{id:a}),r=C(a,t,n);return [o,r]}function te(e,t={}){return d(e,{...t,usageHint:"h1"})}function ne(e,t={}){return d(e,{...t,usageHint:"h2"})}function oe(e,t={}){return d(e,{...t,usageHint:"h3"})}function ae(e,t={}){return d(e,{...t,usageHint:"h4"})}function re(e,t={}){return d(e,{...t,usageHint:"h5"})}function ie(e,t={}){return d(e,{...t,usageHint:"caption"})}function se(e,t={}){return d(e,{...t,usageHint:"body"})}var M={};function g(e,t=""){let n=[];for(let[a,o]of Object.entries(e)){let r=t?`${t}/${a}`:`/${a}`;n.push(c(r,o));}return n}function c(e,t){if(t==null)return {key:e,valueString:""};if(typeof t=="string")return {key:e,valueString:t};if(typeof t=="number")return {key:e,valueNumber:t};if(typeof t=="boolean")return {key:e,valueBoolean:t};if(Array.isArray(t))return {key:e,valueMap:t.map((n,a)=>c(String(a),n))};if(typeof t=="object"){let n=[];for(let[a,o]of Object.entries(t))n.push(c(a,o));return {key:e,valueMap:n}}return {key:e,valueString:String(t)}}function I(e,t={}){let n=e.replace(/\./g,"/");n.startsWith("/")||(n=`/${n}`);for(let[a,o]of Object.entries(t)){let r=new RegExp(`^/${a}(/|$)`);r.test(n)&&(n=n.replace(r,`/${o}$1`));}return n}function pe(e,t="",n=M){let a=[];for(let o of e){let r=o.path.startsWith("/")?o.path:`${t}/${o.path}`,i=I(r,n);if(o.value!==null&&typeof o.value=="object"&&!Array.isArray(o.value)){let s=m(o.value,i);a.push(...s);}else a.push(c(i,o.value));}return a}function m(e,t){let n=[];for(let[a,o]of Object.entries(e)){let r=`${t}/${a}`;if(o!==null&&typeof o=="object"&&!Array.isArray(o)){let i=m(o,r);n.push(...i);}else n.push(c(r,o));}return n}function h(e){let t={};for(let n of e){let a=n.key.startsWith("/")?n.key.slice(1):n.key;n.valueString!==void 0?t[a]=n.valueString:n.valueNumber!==void 0?t[a]=n.valueNumber:n.valueBoolean!==void 0?t[a]=n.valueBoolean:n.valueMap!==void 0&&(t[a]=h(n.valueMap));}return t}function x(e,t=l){return {createSurface:{surfaceId:e,catalogId:t}}}function O(e,t){return {updateComponents:{surfaceId:e,components:t}}}function S(e,t,n,a="replace"){return {updateDataModel:{surfaceId:e,...n&&{path:n},op:a,...a!=="remove"&&{value:t}}}}function de(e){return {deleteSurface:{surfaceId:e}}}function ce(e){let{surfaceId:t,catalogId:n=l,components:a,dataModel:o}=e,r=[x(t,n),O(t,a)];return o&&r.push(S(t,o)),r}function T(e,t="@default",n){return {beginRendering:{surfaceId:t,root:e,...n&&{styles:n}}}}function y(e,t="@default"){return {surfaceUpdate:{surfaceId:t,components:e}}}function V(e,t="@default",n){return {dataModelUpdate:{surfaceId:t,contents:e,...n&&{path:n}}}}function D(e,t="@default"){return V(g(e),t)}function ue(e,t,n="@default"){return {dataModelUpdate:{surfaceId:n,path:e,contents:[c("",t)]}}}function le(e){return {deleteSurface:{surfaceId:e}}}function ge(e){let{rootId:t,components:n,dataModel:a,surfaceId:o="@default",styles:r}=e,i=[y(n,o)];return a&&i.push(D(a,o)),i.push(T(t,o,r)),i}function me(e){return e.map(t=>JSON.stringify(t)).join(`
2
- `)}function fe(e){return e.split(`
3
- `).filter(t=>t.trim()).map(t=>JSON.parse(t))}var Ie=["Text","Image","Icon","Video","AudioPlayer","Row","Column","List","Card","Tabs","Divider","Modal","Button","CheckBox","TextField","DateTimeInput","ChoicePicker","Slider"];function b(e,t={}){let n=[],a=[];if("createSurface"in e){let{createSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"createSurface.surfaceId is required",path:"createSurface.surfaceId"}),o.catalogId||n.push({code:"MISSING_CATALOG_ID",message:"createSurface.catalogId is required",path:"createSurface.catalogId"});}else if("updateComponents"in e){let{updateComponents:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"updateComponents.surfaceId is required",path:"updateComponents.surfaceId"}),!o.components||!Array.isArray(o.components)?n.push({code:"INVALID_COMPONENTS",message:"updateComponents.components must be an array",path:"updateComponents.components"}):he(o.components,n,a,t);}else if("updateDataModel"in e){let{updateDataModel:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"updateDataModel.surfaceId is required",path:"updateDataModel.surfaceId"});}else if("deleteSurface"in e){let{deleteSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"});}else n.push({code:"INVALID_MESSAGE_TYPE",message:"Message must contain one of: createSurface, updateComponents, updateDataModel, deleteSurface"});return {valid:n.length===0,errors:n,warnings:a}}function P(e,t={}){let n=[],a=[];if("beginRendering"in e){let{beginRendering:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"beginRendering.surfaceId is required",path:"beginRendering.surfaceId"}),o.root||n.push({code:"MISSING_ROOT",message:"beginRendering.root is required",path:"beginRendering.root"});}else if("surfaceUpdate"in e){let{surfaceUpdate:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"surfaceUpdate.surfaceId is required",path:"surfaceUpdate.surfaceId"}),!o.components||!Array.isArray(o.components)?n.push({code:"INVALID_COMPONENTS",message:"surfaceUpdate.components must be an array",path:"surfaceUpdate.components"}):xe(o.components,n,a,t);}else if("dataModelUpdate"in e){let{dataModelUpdate:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"dataModelUpdate.surfaceId is required",path:"dataModelUpdate.surfaceId"}),(!o.contents||!Array.isArray(o.contents))&&n.push({code:"INVALID_CONTENTS",message:"dataModelUpdate.contents must be an array",path:"dataModelUpdate.contents"});}else if("deleteSurface"in e){let{deleteSurface:o}=e;o.surfaceId||n.push({code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"});}else n.push({code:"INVALID_MESSAGE_TYPE",message:"Message must contain one of: beginRendering, surfaceUpdate, dataModelUpdate, deleteSurface"});return {valid:n.length===0,errors:n,warnings:a}}function v(e,t={}){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e?b(e,t):"beginRendering"in e||"surfaceUpdate"in e||"dataModelUpdate"in e?P(e,t):"deleteSurface"in e?e.deleteSurface.surfaceId?{valid:true,errors:[],warnings:[]}:{valid:false,errors:[{code:"MISSING_SURFACE_ID",message:"deleteSurface.surfaceId is required",path:"deleteSurface.surfaceId"}],warnings:[]}:{valid:false,errors:[{code:"UNKNOWN_MESSAGE_TYPE",message:"Unknown message type"}],warnings:[]}}function Ce(e,t={}){let n=[],a=[];for(let o=0;o<e.length;o++){let r=e[o];if(!r)continue;let i=v(r,t);for(let s of i.errors)n.push({...s,path:`messages[${o}].${s.path??""}`});for(let s of i.warnings)a.push({...s,path:`messages[${o}].${s.path??""}`});}return {valid:n.length===0,errors:n,warnings:a}}function he(e,t,n,a){let o=new Set,r=false;for(let i=0;i<e.length;i++){let s=e[i];if(!s)continue;let u=`updateComponents.components[${i}]`;s.id?(o.has(s.id)&&t.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${s.id}`,path:`${u}.id`}),o.add(s.id),s.id==="root"&&(r=true)):t.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${u}.id`}),s.component?a.strict&&a.allowedComponents&&(a.allowedComponents.includes(s.component)||n.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${s.component}`,path:`${u}.component`})):t.push({code:"MISSING_COMPONENT_TYPE",message:"Component type is required",path:`${u}.component`});}!r&&a.strict&&n.push({code:"MISSING_ROOT_COMPONENT",message:'No component with id "root" found',path:"updateComponents.components"});}function xe(e,t,n,a){let o=new Set;for(let r=0;r<e.length;r++){let i=e[r];if(!i)continue;let s=`surfaceUpdate.components[${r}]`;if(i.id?(o.has(i.id)&&t.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${i.id}`,path:`${s}.id`}),o.add(i.id)):t.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${s}.id`}),!i.component||typeof i.component!="object")t.push({code:"MISSING_COMPONENT",message:"Component definition is required",path:`${s}.component`});else {let u=Object.keys(i.component)[0];u&&a.strict&&!Ie.includes(u)&&n.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${u}`,path:`${s}.component`});}}}function A(e){return typeof e=="object"&&e!==null&&"path"in e}function Oe(e){if(!A(e))return e}function Se(e){if(A(e))return e.path}function Te(e){return {path:e}}function Me(e,t){let n={...e};for(let a of Object.keys(t)){let o=t[a],r=n[a];o!==void 0&&typeof o=="object"&&o!==null&&!Array.isArray(o)&&typeof r=="object"&&r!==null&&!Array.isArray(r)?n[a]=Me(r,o):o!==void 0&&(n[a]=o);}return n}function ye(){return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{let t=Math.random()*16|0;return (e==="x"?t:t&3|8).toString(16)})}export{E as A2UI_EXTENSION_URI,_ as A2UI_EXTENSION_URI_V08,R as A2UI_MIME_TYPE,M as DEFAULT_PATH_MAPPINGS,l as STANDARD_CATALOG_ID,$ as audioPlayer,T as beginRendering,se as body,C as button,ie as caption,q as card,z as checkbox,Q as choicePicker,G as column,x as createSurface,ge as createV08Messages,ce as createV09Messages,D as dataModelInit,V as dataModelUpdate,K as dateTimeInput,Me as deepMerge,de as deleteSurface,le as deleteSurfaceV08,Y as divider,m as flattenObjectToValueMap,p as generateId,k as getIdCounter,Oe as getLiteralValue,Se as getPathValue,te as h1,ne as h2,oe as h3,ae as h4,re as h5,B as icon,j as image,A as isPathBinding,N as isV08Message,U as isV09Message,fe as jsonlToMessages,H as list,me as messagesToJsonl,X as modal,I as normalizePath,g as objectToValueMap,Te as path,ue as pathUpdate,w as resetIdCounter,F as row,Z as slider,y as surfaceUpdate,W as tabs,d as text,ee as textButton,J as textField,O as updateComponents,S as updateDataModel,pe as updatesToValueMap,ye as uuid,v as validateMessage,Ce as validateMessages,P as validateV08Message,b as validateV09Message,h as valueMapToObject,c as valueToValueMap,L as video};
1
+ import ke from'ajv/dist/2020';import qe from'ajv-formats';var Ve=Object.defineProperty;var Ae=(e,t,n)=>t in e?Ve(e,t,{enumerable:true,configurable:true,writable:true,value:n}):e[t]=n;var S=(e,t,n)=>Ae(e,typeof t!="symbol"?t+"":t,n);function _(e){return "createSurface"in e||"updateComponents"in e||"updateDataModel"in e}var h="https://a2ui.dev/specification/0.9/standard_catalog_definition.json";var U="https://a2ui.dev/specification/0.9",E="application/json+a2ui";var b=0;function s(e="comp"){return `${e}_${Date.now()}_${b++}`}function R(){b=0;}function N(){return b}function c(e,t={}){let{id:n=s("text"),weight:r,usageHint:o}=t;return {id:n,component:"Text",text:e,...r!==void 0&&{weight:r},...o&&{usageHint:o}}}function k(e,t={}){let{id:n=s("image"),weight:r,fit:o,usageHint:a}=t;return {id:n,component:"Image",url:e,...r!==void 0&&{weight:r},...o&&{fit:o},...a&&{usageHint:a}}}function q(e,t={}){let{id:n=s("icon"),weight:r}=t;return {id:n,component:"Icon",name:e,...r!==void 0&&{weight:r}}}function F(e,t={}){let{id:n=s("video"),weight:r}=t;return {id:n,component:"Video",url:e,...r!==void 0&&{weight:r}}}function B(e,t={}){let{id:n=s("audio"),weight:r,description:o}=t;return {id:n,component:"AudioPlayer",url:e,...r!==void 0&&{weight:r},...o&&{description:o}}}function L(e,t={}){let{id:n=s("row"),weight:r,alignment:o,distribution:a}=t;return {id:n,component:"Row",children:e,...r!==void 0&&{weight:r},...o&&{alignment:o},...a&&{distribution:a}}}function H(e,t={}){let{id:n=s("column"),weight:r,alignment:o,distribution:a}=t;return {id:n,component:"Column",children:e,...r!==void 0&&{weight:r},...o&&{alignment:o},...a&&{distribution:a}}}function G(e,t={}){let{id:n=s("list"),weight:r,direction:o,alignment:a}=t;return {id:n,component:"List",children:e,...r!==void 0&&{weight:r},...o&&{direction:o},...a&&{alignment:a}}}function W(e,t={}){let{id:n=s("card"),weight:r}=t;return {id:n,component:"Card",child:e,...r!==void 0&&{weight:r}}}function z(e,t={}){let{id:n=s("tabs"),weight:r}=t;return {id:n,component:"Tabs",tabItems:e.map(o=>({title:o.title,child:o.childId})),...r!==void 0&&{weight:r}}}function J(e={}){let{id:t=s("divider"),weight:n,axis:r}=e;return {id:t,component:"Divider",...n!==void 0&&{weight:n},...r&&{axis:r}}}function Y(e,t,n={}){let{id:r=s("modal"),weight:o}=n;return {id:r,component:"Modal",entryPointChild:e,contentChild:t,...o!==void 0&&{weight:o}}}function v(e,t,n={}){let{id:r=s("button"),weight:o,primary:a}=n;return {id:r,component:"Button",child:e,action:t,...o!==void 0&&{weight:o},...a!==void 0&&{primary:a}}}function X(e,t,n={}){let{id:r=s("checkbox"),weight:o}=n;return {id:r,component:"CheckBox",label:e,value:t,...o!==void 0&&{weight:o}}}function K(e,t,n={}){let{id:r=s("textfield"),weight:o,usageHint:a,validationRegexp:i}=n;return {id:r,component:"TextField",label:e,...t!==void 0&&{text:t},...o!==void 0&&{weight:o},...a&&{usageHint:a},...i&&{validationRegexp:i}}}function Q(e,t={}){let{id:n=s("datetime"),weight:r,enableDate:o,enableTime:a,outputFormat:i,label:p}=t;return {id:n,component:"DateTimeInput",value:e,...r!==void 0&&{weight:r},...o!==void 0&&{enableDate:o},...a!==void 0&&{enableTime:a},...i&&{outputFormat:i},...p&&{label:p}}}function Z(e,t,n,r={}){let{id:o=s("choice"),weight:a,label:i}=r;return {id:o,component:"ChoicePicker",options:e,value:t,usageHint:n,...a!==void 0&&{weight:a},...i&&{label:i}}}function ee(e,t={}){let{id:n=s("slider"),weight:r,label:o,min:a,max:i}=t;return {id:n,component:"Slider",value:e,...r!==void 0&&{weight:r},...o&&{label:o},...a!==void 0&&{min:a},...i!==void 0&&{max:i}}}function te(e,t,n={}){let r=n.textId??s("btn_text"),o=c(e,{id:r}),a=v(r,t,n);return [o,a]}function ne(e,t={}){return c(e,{...t,usageHint:"h1"})}function oe(e,t={}){return c(e,{...t,usageHint:"h2"})}function re(e,t={}){return c(e,{...t,usageHint:"h3"})}function ae(e,t={}){return c(e,{...t,usageHint:"h4"})}function ie(e,t={}){return c(e,{...t,usageHint:"h5"})}function se(e,t={}){return c(e,{...t,usageHint:"caption"})}function pe(e,t={}){return c(e,{...t,usageHint:"body"})}function m(e,t=h){return {createSurface:{surfaceId:e,catalogId:t}}}function f(e,t){return {updateComponents:{surfaceId:e,components:t}}}function g(e,t,n,r="replace"){return {updateDataModel:{surfaceId:e,...n&&{path:n},op:r,...r!=="remove"&&{value:t}}}}function O(e){return {deleteSurface:{surfaceId:e}}}function ce(e){let{surfaceId:t,catalogId:n=h,components:r,dataModel:o}=e,a=[m(t,n),f(t,r)];return o&&a.push(g(t,o)),a}function de(e){return e.map(t=>JSON.stringify(t)).join(`
2
+ `)}function le(e){return e.split(`
3
+ `).filter(t=>t.trim()).map(t=>JSON.parse(t))}var M={};function ue(e,t=""){let n=[];for(let[r,o]of Object.entries(e)){let a=t?`${t}/${r}`:`/${r}`;n.push(l(a,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,r)=>l(String(r),n))};if(typeof t=="object"){let n=[];for(let[r,o]of Object.entries(t))n.push(l(r,o));return {key:e,valueMap:n}}return {key:e,valueString:String(t)}}function P(e,t={}){let n=e.replace(/\./g,"/");n.startsWith("/")||(n=`/${n}`);for(let[r,o]of Object.entries(t)){let a=new RegExp(`^/${r}(/|$)`);a.test(n)&&(n=n.replace(a,`/${o}$1`));}return n}function me(e,t="",n=M){let r=[];for(let o of e){let a=o.path.startsWith("/")?o.path:`${t}/${o.path}`,i=P(a,n);if(o.value!==null&&typeof o.value=="object"&&!Array.isArray(o.value)){let p=T(o.value,i);r.push(...p);}else r.push(l(i,o.value));}return r}function T(e,t){let n=[];for(let[r,o]of Object.entries(e)){let a=`${t}/${r}`;if(o!==null&&typeof o=="object"&&!Array.isArray(o)){let i=T(o,a);n.push(...i);}else n.push(l(a,o));}return n}function D(e){let t={};for(let n of e){let r=n.key.startsWith("/")?n.key.slice(1):n.key;n.valueString!==void 0?t[r]=n.valueString:n.valueNumber!==void 0?t[r]=n.valueNumber:n.valueBoolean!==void 0?t[r]=n.valueBoolean:n.valueMap!==void 0&&(t[r]=D(n.valueMap));}return t}var we=["Text","Image","Icon","Video","AudioPlayer","Row","Column","List","Card","Tabs","Divider","Modal","Button","CheckBox","TextField","DateTimeInput","ChoicePicker","Slider"];function j(e,t={}){let n=[],r=[];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"}):_e(o.components,n,r,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"}),o.op&&!["add","replace","remove"].includes(o.op)&&n.push({code:"INVALID_OP",message:"updateDataModel.op must be one of: add, replace, remove",path:"updateDataModel.op"}),o.op==="remove"&&o.value!==void 0&&r.push({code:"UNNECESSARY_VALUE",message:"updateDataModel.value should not be provided for remove operation",path:"updateDataModel.value"}),o.op!=="remove"&&o.value===void 0&&o.op==="add"&&n.push({code:"MISSING_VALUE",message:"updateDataModel.value is required for add operation",path:"updateDataModel.value"});}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:r}}function $(e,t={}){return j(e,t)}function fe(e,t={}){let n=[],r=[];for(let o=0;o<e.length;o++){let a=e[o];if(!a)continue;let i=$(a,t);for(let p of i.errors)n.push({...p,path:`messages[${o}].${p.path??""}`});for(let p of i.warnings)r.push({...p,path:`messages[${o}].${p.path??""}`});}return {valid:n.length===0,errors:n,warnings:r}}function _e(e,t,n,r){let o=new Set,a=false;for(let i=0;i<e.length;i++){let p=e[i];if(!p)continue;let x=`updateComponents.components[${i}]`;p.id?(o.has(p.id)&&t.push({code:"DUPLICATE_COMPONENT_ID",message:`Duplicate component id: ${p.id}`,path:`${x}.id`}),o.add(p.id),p.id==="root"&&(a=true)):t.push({code:"MISSING_COMPONENT_ID",message:"Component id is required",path:`${x}.id`}),p.component?r.strict&&!we.includes(p.component)&&r.allowedComponents&&!r.allowedComponents.includes(p.component)&&n.push({code:"UNKNOWN_COMPONENT_TYPE",message:`Unknown component type: ${p.component}`,path:`${x}.component`}):t.push({code:"MISSING_COMPONENT_TYPE",message:"Component type is required",path:`${x}.component`});}!a&&r.strict&&n.push({code:"MISSING_ROOT_COMPONENT",message:'No component with id "root" found',path:"updateComponents.components"});}var he={title:"A2UI (Agent to UI) Client-to-Server Event Schema",description:"Describes a JSON payload for a client-to-server event message.",type:"object",minProperties:1,maxProperties:1,properties:{userAction:{type:"object",description:"Reports a user-initiated action from a component.",properties:{name:{type:"string",description:"The name of the action, taken from the component's action.name property."},surfaceId:{type:"string",description:"The id of the surface where the event originated."},sourceComponentId:{type:"string",description:"The id of the component that triggered the event."},timestamp:{type:"string",format:"date-time",description:"An ISO 8601 timestamp of when the event occurred."},context:{type:"object",description:"A JSON object containing the key-value pairs from the component's action.context, after resolving all data bindings.",additionalProperties:true}},required:["name","surfaceId","sourceComponentId","timestamp","context"]},error:{description:"Reports a client-side error.",oneOf:[{type:"object",title:"Validation Failed Error",properties:{code:{const:"VALIDATION_FAILED"},surfaceId:{type:"string",description:"The id of the surface where the error occurred."},path:{type:"string",description:"The JSON pointer to the field that failed validation (e.g. '/components/0/text')."},message:{type:"string",description:"A short one-sentence description of why validation failed."}},required:["code","path","message","surfaceId"]},{type:"object",title:"Generic Error",properties:{code:{not:{const:"VALIDATION_FAILED"}},message:{type:"string",description:"A short one-sentence description of why the error occurred."},surfaceId:{type:"string",description:"The id of the surface where the error occurred."}},required:["code","surfaceId","message"],additionalProperties:true}]}},oneOf:[{required:["userAction"]},{required:["clientUiCapabilities"]},{required:["error"]}]};var ge={$schema:"https://json-schema.org/draft/2020-12/schema",$id:"https://a2ui.dev/specification/0.9/common_types.json",title:"A2UI Common Types",description:"Common type definitions used across A2UI schemas.",$defs:{stringOrPath:{description:"Represents a value that can be either a literal string or a path to a value in the data model.",oneOf:[{type:"string"},{type:"object",properties:{path:{type:"string"}},required:["path"],additionalProperties:false}]},numberOrPath:{description:"Represents a value that can be either a literal number or a path to a value in the data model.",oneOf:[{type:"number"},{type:"object",properties:{path:{type:"string"}},required:["path"],additionalProperties:false}]},booleanOrPath:{description:"Represents a value that can be either a literal boolean or a path to a value in the data model.",oneOf:[{type:"boolean"},{type:"object",properties:{path:{type:"string"}},required:["path"],additionalProperties:false}]},stringArrayOrPath:{description:"Represents a value that can be either a literal array of strings or a path to a value in the data model.",oneOf:[{type:"array",items:{type:"string"}},{type:"object",properties:{path:{type:"string"}},required:["path"],additionalProperties:false}]},id:{type:"string",description:"The unique identifier for this component."},ComponentCommon:{type:"object",properties:{id:{$ref:"#/$defs/id"},weight:{type:"number",description:"The relative weight of this component within a Row or Column. This is similar to the CSS 'flex-grow' property."}},required:["id"]},contextValue:{description:"A value that can be a string, number, boolean, or a path to a value.",oneOf:[{type:"string"},{type:"number"},{type:"boolean"},{type:"object",properties:{path:{type:"string"}},required:["path"],additionalProperties:false}]},childrenProperty:{oneOf:[{type:"array",items:{type:"string"},description:"A static list of child component IDs."},{type:"object",description:"A template for generating a dynamic list of children from a data model list. The `componentId` is the component to use as a template.",properties:{componentId:{$ref:"#/$defs/id"},path:{type:"string",description:"The path to the list of component property objects in the data model."}},required:["componentId","path"],additionalProperties:false}]}}};var ye={$schema:"https://json-schema.org/draft/2020-12/schema",$id:"https://a2ui.dev/specification/0.9/server_to_client.json",title:"A2UI Message Schema",description:"Describes a JSON payload for an A2UI (Agent to UI) message, which is used to dynamically construct and update user interfaces.",type:"object",oneOf:[{$ref:"#/$defs/CreateSurfaceMessage"},{$ref:"#/$defs/UpdateComponentsMessage"},{$ref:"#/$defs/UpdateDataModelMessage"},{$ref:"#/$defs/DeleteSurfaceMessage"}],$defs:{CreateSurfaceMessage:{properties:{createSurface:{type:"object",description:"Signals the client to create a new surface and begin rendering it. When this message is sent, the client will expect 'updateComponents' and/or 'updateDataModel' messages for the same surfaceId that define the component tree.",properties:{surfaceId:{type:"string",description:"The unique identifier for the UI surface to be rendered."},catalogId:{title:"Catalog ID",description:"A string that uniquely identifies this catalog. It is recommended to prefix this with an internet domain that you own, to avoid conflicts e.g. mycompany.com:somecatalog'.",type:"string"}},required:["surfaceId","catalogId"],additionalProperties:false}},required:["createSurface"],additionalProperties:false},UpdateComponentsMessage:{properties:{updateComponents:{type:"object",description:"Updates a surface with a new set of components. This message can be sent multiple times to update the component tree of an existing surface. One of the components in one of the components lists MUST have an 'id' of 'root' to serve as the root of the component tree. The createSurface message MUST have been previously sent with the 'catalogId' that is in this message.",properties:{surfaceId:{type:"string",description:"The unique identifier for the UI surface to be updated."},components:{type:"array",description:"A list containing all UI components for the surface.",minItems:1,items:{$ref:"standard_catalog_definition.json#/$defs/anyComponent"}}},required:["surfaceId","components"],additionalProperties:false}},required:["updateComponents"],additionalProperties:false},UpdateDataModelMessage:{properties:{updateDataModel:{type:"object",description:"Updates the data model for an existing surface. This message can be sent multiple times to update the data model. The createSurface message MUST have been previously sent with the 'catalogId' that is in this message.",properties:{surfaceId:{type:"string",description:"The unique identifier for the UI surface this data model update applies to."},path:{type:"string",description:"An optional path to a location within the data model (e.g., '/user/name'). If omitted, or set to '/', refers to the entire data model."},op:{type:"string",description:"The operation to perform on the data model. Defaults to 'replace' if omitted.",enum:["add","replace","remove"]},value:{description:"The data to be updated in the data model. Required for 'add' and 'replace' operations. Not allowed for 'remove' operation.",additionalProperties:true}},required:["surfaceId"],additionalProperties:false}},required:["updateDataModel"],additionalProperties:false},DeleteSurfaceMessage:{properties:{deleteSurface:{type:"object",description:"Signals the client to delete the surface identified by 'surfaceId'. The createSurface message MUST have been previously sent with the 'catalogId' that is in this message.",properties:{surfaceId:{type:"string",description:"The unique identifier for the UI surface to be deleted."}},required:["surfaceId"],additionalProperties:false}},required:["deleteSurface"],additionalProperties:false}}};var Ce={$schema:"https://json-schema.org/draft/2020-12/schema",$id:"https://a2ui.dev/specification/0.9/standard_catalog_definition.json",title:"A2UI Component Catalog",description:"Definitions for the standard catalog of A2UI components.",$defs:{Theme:{type:"object",description:"Theming information for the UI.",properties:{font:{type:"string",description:"The primary font for the UI."},primaryColor:{type:"string",description:"The primary UI color as a hexadecimal code (e.g., '#00BFFF').",pattern:"^#[0-9a-fA-F]{6}$"}},additionalProperties:false},anyComponent:{oneOf:[{$ref:"#/$defs/Text"},{$ref:"#/$defs/Image"},{$ref:"#/$defs/Icon"},{$ref:"#/$defs/Video"},{$ref:"#/$defs/AudioPlayer"},{$ref:"#/$defs/Row"},{$ref:"#/$defs/Column"},{$ref:"#/$defs/List"},{$ref:"#/$defs/Card"},{$ref:"#/$defs/Tabs"},{$ref:"#/$defs/Divider"},{$ref:"#/$defs/Modal"},{$ref:"#/$defs/Button"},{$ref:"#/$defs/CheckBox"},{$ref:"#/$defs/TextField"},{$ref:"#/$defs/DateTimeInput"},{$ref:"#/$defs/ChoicePicker"},{$ref:"#/$defs/Slider"}],discriminator:{propertyName:"component"}},Text:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Text"},text:{$ref:"common_types.json#/$defs/stringOrPath",description:"The text content to display. While simple Markdown formatting is supported (i.e. without HTML, images, or links), utilizing dedicated UI components is generally preferred for a richer and more structured presentation."},usageHint:{type:"string",description:"A hint for the base text style.",enum:["h1","h2","h3","h4","h5","caption","body"]}},required:["component","text"]}],unevaluatedProperties:false},Image:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Image"},url:{$ref:"common_types.json#/$defs/stringOrPath",description:"The URL of the image to display."},fit:{type:"string",description:"Specifies how the image should be resized to fit its container. This corresponds to the CSS 'object-fit' property.",enum:["contain","cover","fill","none","scale-down"]},usageHint:{type:"string",description:"A hint for the image size and style.",enum:["icon","avatar","smallFeature","mediumFeature","largeFeature","header"]}},required:["component","url"]}],unevaluatedProperties:false},Icon:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Icon"},name:{description:"The name of the icon to display.",oneOf:[{type:"string",enum:["accountCircle","add","arrowBack","arrowForward","attachFile","calendarToday","call","camera","check","close","delete","download","edit","event","error","fastForward","favorite","favoriteOff","folder","help","home","info","locationOn","lock","lockOpen","mail","menu","moreVert","moreHoriz","notificationsOff","notifications","pause","payment","person","phone","photo","play","print","refresh","rewind","search","send","settings","share","shoppingCart","skipNext","skipPrevious","star","starHalf","starOff","stop","upload","visibility","visibilityOff","volumeDown","volumeMute","volumeOff","volumeUp","warning"]},{type:"object",properties:{path:{type:"string"}},required:["path"],additionalProperties:false}]}},required:["component","name"]}],unevaluatedProperties:false},Video:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Video"},url:{$ref:"common_types.json#/$defs/stringOrPath",description:"The URL of the video to display."}},required:["component","url"]}],unevaluatedProperties:false},AudioPlayer:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"AudioPlayer"},url:{$ref:"common_types.json#/$defs/stringOrPath",description:"The URL of the audio to be played."},description:{description:"A description of the audio, such as a title or summary.",$ref:"common_types.json#/$defs/stringOrPath"}},required:["component","url"]}],unevaluatedProperties:false},Row:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",description:"A layout component that arranges its children horizontally. To create a grid layout, nest Columns within this Row.",properties:{component:{const:"Row"},children:{description:"Defines the children. Use an array of strings for a fixed set of children, or a template object to generate children from a data list. Children cannot be defined inline, they must be referred to by ID.",$ref:"common_types.json#/$defs/childrenProperty"},distribution:{type:"string",description:"Defines the arrangement of children along the main axis (horizontally). Use 'spaceBetween' to push items to the edges, or 'start'/'end'/'center' to pack them together.",enum:["center","end","spaceAround","spaceBetween","spaceEvenly","start","stretch"]},alignment:{type:"string",description:"Defines the alignment of children along the cross axis (vertically). This is similar to the CSS 'align-items' property, but uses camelCase values (e.g., 'start').",enum:["start","center","end","stretch"]}},required:["component","children"]}],unevaluatedProperties:false},Column:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",description:"A layout component that arranges its children vertically. To create a grid layout, nest Rows within this Column.",properties:{component:{const:"Column"},children:{description:"Defines the children. Use an array of strings for a fixed set of children, or a template object to generate children from a data list. Children cannot be defined inline, they must be referred to by ID.",$ref:"common_types.json#/$defs/childrenProperty"},distribution:{type:"string",description:"Defines the arrangement of children along the main axis (vertically). Use 'spaceBetween' to push items to the edges (e.g. header at top, footer at bottom), or 'start'/'end'/'center' to pack them together.",enum:["start","center","end","spaceBetween","spaceAround","spaceEvenly","stretch"]},alignment:{type:"string",description:"Defines the alignment of children along the cross axis (horizontally). This is similar to the CSS 'align-items' property.",enum:["center","end","start","stretch"]}},required:["component","children"]}],unevaluatedProperties:false},List:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"List"},children:{description:"Defines the children. Use an array of strings for a fixed set of children, or a template object to generate children from a data list.",$ref:"common_types.json#/$defs/childrenProperty"},direction:{type:"string",description:"The direction in which the list items are laid out.",enum:["vertical","horizontal"]},alignment:{type:"string",description:"Defines the alignment of children along the cross axis.",enum:["start","center","end","stretch"]}},required:["component","children"]}],unevaluatedProperties:false},Card:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Card"},child:{type:"string",description:"The ID of the single child component to be rendered inside the card. To display multiple elements, you MUST wrap them in a layout component (like Column or Row) and pass that container's ID here. Do NOT pass multiple IDs or a non-existent ID. Do NOT define the child component inline."}},required:["component","child"]}],unevaluatedProperties:false},Tabs:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Tabs"},tabItems:{type:"array",description:"An array of objects, where each object defines a tab with a title and a child component.",items:{type:"object",properties:{title:{description:"The tab title.",$ref:"common_types.json#/$defs/stringOrPath"},child:{type:"string",description:"The ID of the child component. Do NOT define the component inline."}},required:["title","child"],additionalProperties:false}}},required:["component","tabItems"]}],unevaluatedProperties:false},Divider:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Divider"},axis:{type:"string",description:"The orientation of the divider.",enum:["horizontal","vertical"]}},required:["component"]}],unevaluatedProperties:false},Modal:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Modal"},entryPointChild:{type:"string",description:"The ID of the component that opens the modal when interacted with (e.g., a button). Do NOT define the component inline."},contentChild:{type:"string",description:"The ID of the component to be displayed inside the modal. Do NOT define the component inline."}},required:["component","entryPointChild","contentChild"]}],unevaluatedProperties:false},Button:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Button"},child:{type:"string",description:"The ID of the child component. Use a 'Text' component for a labeled button. Only use an 'Icon' if the requirements explicitly ask for an icon-only button. Do NOT define the child component inline."},primary:{type:"boolean",description:"Indicates if this button should be styled as the primary action."},action:{type:"object",description:"The client-side action to be dispatched when the button is clicked. It includes the action's name and an optional context payload.",properties:{name:{type:"string"},context:{type:"object",description:"A JSON object containing the key-value pairs for the action context. Values can be literals or paths. Use literal values unless the value must be dynamically bound to the data model. Do NOT use paths for static IDs.",additionalProperties:{$ref:"common_types.json#/$defs/contextValue"}}},required:["name"],additionalProperties:false}},required:["component","child","action"]}],unevaluatedProperties:false},CheckBox:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"CheckBox"},label:{$ref:"common_types.json#/$defs/stringOrPath",description:"The text to display next to the checkbox."},value:{$ref:"common_types.json#/$defs/booleanOrPath",description:"The current state of the checkbox (true for checked, false for unchecked)."}},required:["component","label","value"]}],unevaluatedProperties:false},TextField:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"TextField"},label:{$ref:"common_types.json#/$defs/stringOrPath",description:"The text label for the input field."},text:{$ref:"common_types.json#/$defs/stringOrPath",description:"The value of the text field."},usageHint:{type:"string",description:"The type of input field to display.",enum:["longText","number","shortText","obscured"]},validationRegexp:{type:"string",description:"A regular expression used for client-side validation of the input."}},required:["component","label"]}],unevaluatedProperties:false},DateTimeInput:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"DateTimeInput"},value:{$ref:"common_types.json#/$defs/stringOrPath",description:"The selected date and/or time value in ISO 8601 format. If not yet set, initialize with an empty string."},enableDate:{type:"boolean",description:"If true, allows the user to select a date."},enableTime:{type:"boolean",description:"If true, allows the user to select a time."},outputFormat:{type:"string",description:"The desired format for the output string after a date or time is selected."},label:{$ref:"common_types.json#/$defs/stringOrPath",description:"The text label for the input field."}},required:["component","value"]}],unevaluatedProperties:false},ChoicePicker:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",description:"A component that allows selecting one or more options from a list.",properties:{component:{const:"ChoicePicker"},label:{$ref:"common_types.json#/$defs/stringOrPath",description:"The label for the group of options."},usageHint:{type:"string",description:"A hint for how the choice picker should be displayed and behave.",enum:["multipleSelection","mutuallyExclusive"]},options:{type:"array",description:"The list of available options to choose from.",items:{type:"object",properties:{label:{description:"The text to display for this option.",$ref:"common_types.json#/$defs/stringOrPath"},value:{type:"string",description:"The stable value associated with this option."}},required:["label","value"],additionalProperties:false}},value:{$ref:"common_types.json#/$defs/stringArrayOrPath",description:"The list of currently selected values. This should be bound to a string array in the data model."}},required:["component","options","value","usageHint"]}],unevaluatedProperties:false},Slider:{type:"object",allOf:[{$ref:"common_types.json#/$defs/ComponentCommon"},{type:"object",properties:{component:{const:"Slider"},label:{$ref:"common_types.json#/$defs/stringOrPath",description:"The label for the slider."},min:{type:"number",description:"The minimum value of the slider."},max:{type:"number",description:"The maximum value of the slider."},value:{$ref:"common_types.json#/$defs/numberOrPath",description:"The current value of the slider."}},required:["component","value"]}],unevaluatedProperties:false}}};var y=class{constructor(){S(this,"ajv");S(this,"serverToClientValidator");S(this,"clientToServerValidator");this.ajv=new ke({allErrors:true,strict:false}),qe(this.ajv),this.ajv.addSchema(ge,"common_types.json"),this.ajv.addSchema(Ce,"standard_catalog_definition.json"),this.serverToClientValidator=this.ajv.compile(ye),this.clientToServerValidator=this.ajv.compile(he);}validateServerToClientMessage(t){return this.serverToClientValidator(t)?{valid:true,errors:[]}:{valid:false,errors:this.formatErrors(this.serverToClientValidator.errors||[])}}validateClientToServerMessage(t){return this.clientToServerValidator(t)?{valid:true,errors:[]}:{valid:false,errors:this.formatErrors(this.clientToServerValidator.errors||[])}}validateMessages(t){let n=[];for(let r=0;r<t.length;r++){let o=this.validateServerToClientMessage(t[r]);o.valid||n.push(...o.errors.map(a=>({...a,path:`/messages/${r}${a.path}`})));}return {valid:n.length===0,errors:n}}formatErrors(t){return t.map(n=>({path:n.instancePath||"/",message:n.message||"Validation failed",keyword:n.keyword,expected:n.params,actual:void 0}))}},V=null;function C(){return V||(V=new y),V}function Ie(e){return C().validateServerToClientMessage(e)}function xe(e){return C().validateClientToServerMessage(e)}function Se(e){return C().validateMessages(e)}function A(e){return typeof e=="object"&&e!==null&&"path"in e}function Fe(e){if(!A(e))return e}function Be(e){if(A(e))return e.path}function Le(e){return {path:e}}function Oe(e,t){let n={...e};for(let r of Object.keys(t)){let o=t[r],a=n[r];o!==void 0&&typeof o=="object"&&o!==null&&!Array.isArray(o)&&typeof a=="object"&&a!==null&&!Array.isArray(a)?n[r]=Oe(a,o):o!==void 0&&(n[r]=o);}return n}function He(){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"},w=0;function I(e="surface"){return w++,`${e}-${Date.now()}-${w}`}function Te(){w=0;}function u(e,t,n){let r=n??I();return t.find(i=>i.id===e)||console.warn(`[A2UI] Root component "${e}" not found in components list`),{messages:[m(r),f(r,t)],surfaceId:r}}function be(e,t,n,r){let o=r??I();return {messages:[m(o),f(o,t),g(o,n)],surfaceId:o}}function ve(e){return O(e)}function Me(e,t){return u(e,t,d.CHAT)}function Pe(e,t){return u(e,t,d.RECOMMENDATION)}function De(e,t){return u(e,t,d.INPUT_FORM)}function je(e,t){return u(e,t,d.ORCHESTRATION)}function $e(e,t){return u(e,t,d.STATUS)}
4
+ export{y as A2UISchemaValidator,U as A2UI_EXTENSION_URI,E as A2UI_MIME_TYPE,M as DEFAULT_PATH_MAPPINGS,h as STANDARD_CATALOG_ID,d as SURFACE_IDS,B as audioPlayer,pe as body,v as button,se as caption,W as card,X as checkbox,Z as choicePicker,H as column,u as createA2UISurface,be as createA2UISurfaceWithData,Me as createChatSurface,ve as createDeleteSurfaceMessage,De as createInputFormSurface,je as createOrchestrationSurface,Pe as createRecommendationSurface,$e as createStatusSurface,m as createSurface,ce as createV09Messages,Q as dateTimeInput,Oe as deepMerge,O as deleteSurface,J as divider,T as flattenObjectToValueMap,s as generateId,I as generateSurfaceId,N as getIdCounter,Fe as getLiteralValue,Be as getPathValue,C as getSchemaValidator,ne as h1,oe as h2,re as h3,ae as h4,ie as h5,q as icon,k as image,A as isPathBinding,_ as isV09Message,le as jsonlToMessages,G as list,de as messagesToJsonl,Y as modal,P as normalizePath,ue as objectToValueMap,Le as path,R as resetIdCounter,Te as resetSurfaceIdCounter,L as row,ee as slider,z as tabs,c as text,te as textButton,K as textField,f as updateComponents,g as updateDataModel,me as updatesToValueMap,He as uuid,xe as validateClientMessage,$ as validateMessage,fe as validateMessages,Se as validateMessagesWithSchema,j as validateV09Message,Ie as validateWithSchema,D as valueMapToObject,l as valueToValueMap,F as video};