glchat-a2ui-react-renderer 0.2.7 → 0.2.8

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.
Files changed (110) hide show
  1. package/README.md +223 -178
  2. package/dist/index.d.ts +10 -4
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/index.js +13 -5
  5. package/dist/src/Provider.d.ts +21 -14
  6. package/dist/src/Provider.d.ts.map +1 -1
  7. package/dist/src/Provider.js +56 -42
  8. package/dist/src/SurfaceRenderer.d.ts +17 -0
  9. package/dist/src/SurfaceRenderer.d.ts.map +1 -0
  10. package/dist/src/SurfaceRenderer.js +28 -0
  11. package/dist/src/components/a2ui/Button/Button.d.ts +313 -3
  12. package/dist/src/components/a2ui/Button/Button.d.ts.map +1 -1
  13. package/dist/src/components/a2ui/Button/Button.js +29 -14
  14. package/dist/src/components/a2ui/{MultipleChoice → ChoicePicker}/CheckboxList.d.ts +1 -2
  15. package/dist/src/components/a2ui/ChoicePicker/CheckboxList.d.ts.map +1 -0
  16. package/dist/src/components/a2ui/{MultipleChoice → ChoicePicker}/CheckboxList.js +2 -13
  17. package/dist/src/components/a2ui/ChoicePicker/ChoicePicker.d.ts +9 -0
  18. package/dist/src/components/a2ui/ChoicePicker/ChoicePicker.d.ts.map +1 -0
  19. package/dist/src/components/a2ui/ChoicePicker/ChoicePicker.js +54 -0
  20. package/dist/src/components/a2ui/ChoicePicker/theme.d.ts +10 -0
  21. package/dist/src/components/a2ui/ChoicePicker/theme.d.ts.map +1 -0
  22. package/dist/src/components/a2ui/{MultipleChoice → ChoicePicker}/theme.js +12 -9
  23. package/dist/src/components/a2ui/TagInput/TagInput.d.ts +289 -3
  24. package/dist/src/components/a2ui/TagInput/TagInput.d.ts.map +1 -1
  25. package/dist/src/components/a2ui/TagInput/TagInput.js +44 -54
  26. package/dist/src/components/a2ui/TagInput/theme.d.ts +0 -9
  27. package/dist/src/components/a2ui/TagInput/theme.d.ts.map +1 -1
  28. package/dist/src/components/a2ui/TagInput/theme.js +1 -9
  29. package/dist/src/components/a2ui/Timeout/Timeout.d.ts +154 -3
  30. package/dist/src/components/a2ui/Timeout/Timeout.d.ts.map +1 -1
  31. package/dist/src/components/a2ui/Timeout/Timeout.js +40 -25
  32. package/dist/src/components/a2ui/common.d.ts +87 -0
  33. package/dist/src/components/a2ui/common.d.ts.map +1 -0
  34. package/dist/src/components/a2ui/common.js +23 -0
  35. package/dist/src/components/ui/Button/theme.d.ts +1 -1
  36. package/dist/src/components/ui/Button/theme.d.ts.map +1 -1
  37. package/dist/src/components/ui/Button/theme.js +11 -0
  38. package/dist/src/components/ui/MultiSelect/MultiSelect.d.ts +1 -1
  39. package/dist/src/components/ui/MultiSelect/MultiSelect.d.ts.map +1 -1
  40. package/dist/src/components/ui/Select/theme.d.ts.map +1 -1
  41. package/dist/src/components/ui/Select/theme.js +0 -1
  42. package/dist/src/utils/catalog.d.ts +16 -4
  43. package/dist/src/utils/catalog.d.ts.map +1 -1
  44. package/dist/src/utils/catalog.js +32 -23
  45. package/dist/src/utils/useSurfaces.d.ts +9 -0
  46. package/dist/src/utils/useSurfaces.d.ts.map +1 -0
  47. package/dist/src/utils/useSurfaces.js +28 -0
  48. package/json/README.md +36 -49
  49. package/json/a2ui-sample-messages.json +170 -315
  50. package/json/glchat_standard_catalog_definition.json +1236 -610
  51. package/package.json +11 -5
  52. package/styles/globals.css +196 -120
  53. package/dist/src/AllSurfacesRenderer.d.ts +0 -14
  54. package/dist/src/AllSurfacesRenderer.d.ts.map +0 -1
  55. package/dist/src/AllSurfacesRenderer.js +0 -18
  56. package/dist/src/SingleSurfaceRenderer.d.ts +0 -15
  57. package/dist/src/SingleSurfaceRenderer.d.ts.map +0 -1
  58. package/dist/src/SingleSurfaceRenderer.js +0 -9
  59. package/dist/src/components/a2ui/Button/theme.d.ts +0 -5
  60. package/dist/src/components/a2ui/Button/theme.d.ts.map +0 -1
  61. package/dist/src/components/a2ui/Button/theme.js +0 -5
  62. package/dist/src/components/a2ui/ButtonAsLink/ButtonAsLink.d.ts +0 -4
  63. package/dist/src/components/a2ui/ButtonAsLink/ButtonAsLink.d.ts.map +0 -1
  64. package/dist/src/components/a2ui/ButtonAsLink/ButtonAsLink.js +0 -42
  65. package/dist/src/components/a2ui/ButtonAsLink/theme.d.ts +0 -8
  66. package/dist/src/components/a2ui/ButtonAsLink/theme.d.ts.map +0 -1
  67. package/dist/src/components/a2ui/ButtonAsLink/theme.js +0 -8
  68. package/dist/src/components/a2ui/Card/theme.d.ts +0 -4
  69. package/dist/src/components/a2ui/Card/theme.d.ts.map +0 -1
  70. package/dist/src/components/a2ui/Card/theme.js +0 -15
  71. package/dist/src/components/a2ui/CheckBox/theme.d.ts +0 -4
  72. package/dist/src/components/a2ui/CheckBox/theme.d.ts.map +0 -1
  73. package/dist/src/components/a2ui/CheckBox/theme.js +0 -11
  74. package/dist/src/components/a2ui/DateTimeInput/theme.d.ts +0 -8
  75. package/dist/src/components/a2ui/DateTimeInput/theme.d.ts.map +0 -1
  76. package/dist/src/components/a2ui/DateTimeInput/theme.js +0 -11
  77. package/dist/src/components/a2ui/DestructiveButton/DestructiveButton.d.ts +0 -4
  78. package/dist/src/components/a2ui/DestructiveButton/DestructiveButton.d.ts.map +0 -1
  79. package/dist/src/components/a2ui/DestructiveButton/DestructiveButton.js +0 -22
  80. package/dist/src/components/a2ui/DestructiveButton/theme.d.ts +0 -8
  81. package/dist/src/components/a2ui/DestructiveButton/theme.d.ts.map +0 -1
  82. package/dist/src/components/a2ui/DestructiveButton/theme.js +0 -8
  83. package/dist/src/components/a2ui/MultipleChoice/CheckboxList.d.ts.map +0 -1
  84. package/dist/src/components/a2ui/MultipleChoice/MultipleChoice.d.ts +0 -4
  85. package/dist/src/components/a2ui/MultipleChoice/MultipleChoice.d.ts.map +0 -1
  86. package/dist/src/components/a2ui/MultipleChoice/MultipleChoice.js +0 -72
  87. package/dist/src/components/a2ui/MultipleChoice/theme.d.ts +0 -13
  88. package/dist/src/components/a2ui/MultipleChoice/theme.d.ts.map +0 -1
  89. package/dist/src/components/a2ui/TextField/theme.d.ts +0 -4
  90. package/dist/src/components/a2ui/TextField/theme.d.ts.map +0 -1
  91. package/dist/src/components/a2ui/TextField/theme.js +0 -9
  92. package/dist/src/components/a2ui/Timeout/theme.d.ts +0 -8
  93. package/dist/src/components/a2ui/Timeout/theme.d.ts.map +0 -1
  94. package/dist/src/components/a2ui/Timeout/theme.js +0 -12
  95. package/dist/src/components/a2ui/types.d.ts +0 -12
  96. package/dist/src/components/a2ui/types.d.ts.map +0 -1
  97. package/dist/src/components/a2ui/types.js +0 -1
  98. package/dist/src/components/ui/Button/ButtonAsLink.d.ts +0 -15
  99. package/dist/src/components/ui/Button/ButtonAsLink.d.ts.map +0 -1
  100. package/dist/src/components/ui/Button/ButtonAsLink.js +0 -17
  101. package/dist/src/components/ui/TextField/theme.d.ts +0 -4
  102. package/dist/src/components/ui/TextField/theme.d.ts.map +0 -1
  103. package/dist/src/components/ui/TextField/theme.js +0 -22
  104. package/dist/src/utils/href.d.ts +0 -11
  105. package/dist/src/utils/href.d.ts.map +0 -1
  106. package/dist/src/utils/href.js +0 -34
  107. package/dist/src/utils/theme.d.ts +0 -15
  108. package/dist/src/utils/theme.d.ts.map +0 -1
  109. package/dist/src/utils/theme.js +0 -93
  110. package/json/glchat_server_to_client_with_catalog.json +0 -1000
@@ -1,844 +1,1470 @@
1
1
  {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://github.com/GDP-ADMIN/glchat-sdk/blob/main/js/glchat-a2ui-react-renderer/json/glchat_standard_catalog_definition.json",
4
+ "title": "GLChat A2UI Catalog",
5
+ "description": "A2UI v0.9 basic catalog extended with GLChat-specific component overrides and extensions.",
2
6
  "catalogId": "https://github.com/GDP-ADMIN/glchat-sdk/blob/main/js/glchat-a2ui-react-renderer/json/glchat_standard_catalog_definition.json",
3
7
  "components": {
4
8
  "Text": {
5
9
  "type": "object",
6
- "additionalProperties": false,
7
- "properties": {
8
- "text": {
10
+ "allOf": [
11
+ {
12
+ "$ref": "common_types.json#/$defs/ComponentCommon"
13
+ },
14
+ {
15
+ "$ref": "#/$defs/CatalogComponentCommon"
16
+ },
17
+ {
9
18
  "type": "object",
10
- "description": "The text content to display. This can be a literal string or a reference to a value in the data model ('path', e.g., '/doc/title'). 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.",
11
- "additionalProperties": false,
12
19
  "properties": {
13
- "literalString": {
14
- "type": "string"
20
+ "component": {
21
+ "const": "Text"
22
+ },
23
+ "text": {
24
+ "$ref": "common_types.json#/$defs/DynamicString",
25
+ "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."
15
26
  },
16
- "path": {
17
- "type": "string"
27
+ "variant": {
28
+ "type": "string",
29
+ "description": "A hint for the base text style.",
30
+ "enum": ["h1", "h2", "h3", "h4", "h5", "caption", "body"],
31
+ "default": "body"
18
32
  }
19
- }
20
- },
21
- "usageHint": {
22
- "type": "string",
23
- "description": "A hint for the base text style. One of:\n- `h1`: Largest heading.\n- `h2`: Second largest heading.\n- `h3`: Third largest heading.\n- `h4`: Fourth largest heading.\n- `h5`: Fifth largest heading.\n- `caption`: Small text for captions.\n- `body`: Standard body text.",
24
- "enum": ["h1", "h2", "h3", "h4", "h5", "caption", "body"]
33
+ },
34
+ "required": ["component", "text"]
25
35
  }
26
- },
27
- "required": ["text"]
36
+ ],
37
+ "unevaluatedProperties": false
28
38
  },
29
39
  "Image": {
30
40
  "type": "object",
31
- "additionalProperties": false,
32
- "properties": {
33
- "url": {
41
+ "allOf": [
42
+ {
43
+ "$ref": "common_types.json#/$defs/ComponentCommon"
44
+ },
45
+ {
46
+ "$ref": "#/$defs/CatalogComponentCommon"
47
+ },
48
+ {
34
49
  "type": "object",
35
- "description": "The URL of the image to display. This can be a literal string ('literal') or a reference to a value in the data model ('path', e.g. '/thumbnail/url').",
36
- "additionalProperties": false,
37
50
  "properties": {
38
- "literalString": {
39
- "type": "string"
51
+ "component": {
52
+ "const": "Image"
53
+ },
54
+ "url": {
55
+ "$ref": "common_types.json#/$defs/DynamicString",
56
+ "description": "The URL of the image to display."
57
+ },
58
+ "description": {
59
+ "$ref": "common_types.json#/$defs/DynamicString",
60
+ "description": "Accessibility text for the image."
61
+ },
62
+ "fit": {
63
+ "type": "string",
64
+ "description": "Specifies how the image should be resized to fit its container. This corresponds to the CSS 'object-fit' property.",
65
+ "enum": ["contain", "cover", "fill", "none", "scaleDown"],
66
+ "default": "fill"
40
67
  },
41
- "path": {
42
- "type": "string"
68
+ "variant": {
69
+ "type": "string",
70
+ "description": "A hint for the image size and style.",
71
+ "enum": ["icon", "avatar", "smallFeature", "mediumFeature", "largeFeature", "header"],
72
+ "default": "mediumFeature"
43
73
  }
44
- }
45
- },
46
- "fit": {
47
- "type": "string",
48
- "description": "Specifies how the image should be resized to fit its container. This corresponds to the CSS 'object-fit' property.",
49
- "enum": ["contain", "cover", "fill", "none", "scale-down"]
50
- },
51
- "usageHint": {
52
- "type": "string",
53
- "description": "A hint for the image size and style. One of:\n- `icon`: Small square icon.\n- `avatar`: Circular avatar image.\n- `smallFeature`: Small feature image.\n- `mediumFeature`: Medium feature image.\n- `largeFeature`: Large feature image.\n- `header`: Full-width, full bleed, header image.",
54
- "enum": ["icon", "avatar", "smallFeature", "mediumFeature", "largeFeature", "header"]
74
+ },
75
+ "required": ["component", "url"]
55
76
  }
56
- },
57
- "required": ["url"]
77
+ ],
78
+ "unevaluatedProperties": false
58
79
  },
59
80
  "Icon": {
60
81
  "type": "object",
61
- "additionalProperties": false,
62
- "properties": {
63
- "name": {
82
+ "allOf": [
83
+ {
84
+ "$ref": "common_types.json#/$defs/ComponentCommon"
85
+ },
86
+ {
87
+ "$ref": "#/$defs/CatalogComponentCommon"
88
+ },
89
+ {
64
90
  "type": "object",
65
- "description": "The name of the icon to display. This can be a literal string or a reference to a value in the data model ('path', e.g. '/form/submit').",
66
- "additionalProperties": false,
67
91
  "properties": {
68
- "literalString": {
69
- "type": "string",
70
- "enum": [
71
- "accountCircle",
72
- "add",
73
- "arrowBack",
74
- "arrowForward",
75
- "attachFile",
76
- "calendarToday",
77
- "call",
78
- "camera",
79
- "check",
80
- "close",
81
- "delete",
82
- "download",
83
- "edit",
84
- "event",
85
- "error",
86
- "favorite",
87
- "favoriteOff",
88
- "folder",
89
- "help",
90
- "home",
91
- "info",
92
- "locationOn",
93
- "lock",
94
- "lockOpen",
95
- "mail",
96
- "menu",
97
- "moreVert",
98
- "moreHoriz",
99
- "notificationsOff",
100
- "notifications",
101
- "payment",
102
- "person",
103
- "phone",
104
- "photo",
105
- "print",
106
- "refresh",
107
- "search",
108
- "send",
109
- "settings",
110
- "share",
111
- "shoppingCart",
112
- "star",
113
- "starHalf",
114
- "starOff",
115
- "upload",
116
- "visibility",
117
- "visibilityOff",
118
- "warning"
119
- ]
92
+ "component": {
93
+ "const": "Icon"
120
94
  },
121
- "path": {
122
- "type": "string"
95
+ "name": {
96
+ "description": "The name of the icon to display.",
97
+ "oneOf": [
98
+ {
99
+ "type": "string",
100
+ "enum": [
101
+ "accountCircle",
102
+ "add",
103
+ "arrowBack",
104
+ "arrowForward",
105
+ "attachFile",
106
+ "calendarToday",
107
+ "call",
108
+ "camera",
109
+ "check",
110
+ "close",
111
+ "delete",
112
+ "download",
113
+ "edit",
114
+ "event",
115
+ "error",
116
+ "fastForward",
117
+ "favorite",
118
+ "favoriteOff",
119
+ "folder",
120
+ "help",
121
+ "home",
122
+ "info",
123
+ "locationOn",
124
+ "lock",
125
+ "lockOpen",
126
+ "mail",
127
+ "menu",
128
+ "moreVert",
129
+ "moreHoriz",
130
+ "notificationsOff",
131
+ "notifications",
132
+ "pause",
133
+ "payment",
134
+ "person",
135
+ "phone",
136
+ "photo",
137
+ "play",
138
+ "print",
139
+ "refresh",
140
+ "rewind",
141
+ "search",
142
+ "send",
143
+ "settings",
144
+ "share",
145
+ "shoppingCart",
146
+ "skipNext",
147
+ "skipPrevious",
148
+ "star",
149
+ "starHalf",
150
+ "starOff",
151
+ "stop",
152
+ "upload",
153
+ "visibility",
154
+ "visibilityOff",
155
+ "volumeDown",
156
+ "volumeMute",
157
+ "volumeOff",
158
+ "volumeUp",
159
+ "warning"
160
+ ]
161
+ },
162
+ {
163
+ "type": "object",
164
+ "properties": {
165
+ "svgPath": {
166
+ "type": "string"
167
+ }
168
+ },
169
+ "required": ["svgPath"],
170
+ "additionalProperties": false
171
+ },
172
+ {
173
+ "$ref": "common_types.json#/$defs/DataBinding"
174
+ }
175
+ ]
123
176
  }
124
- }
177
+ },
178
+ "required": ["component", "name"]
125
179
  }
126
- },
127
- "required": ["name"]
180
+ ],
181
+ "unevaluatedProperties": false
128
182
  },
129
183
  "Video": {
130
184
  "type": "object",
131
- "additionalProperties": false,
132
- "properties": {
133
- "url": {
185
+ "allOf": [
186
+ {
187
+ "$ref": "common_types.json#/$defs/ComponentCommon"
188
+ },
189
+ {
190
+ "$ref": "#/$defs/CatalogComponentCommon"
191
+ },
192
+ {
134
193
  "type": "object",
135
- "description": "The URL of the video to display. This can be a literal string or a reference to a value in the data model ('path', e.g. '/video/url').",
136
- "additionalProperties": false,
137
194
  "properties": {
138
- "literalString": {
139
- "type": "string"
195
+ "component": {
196
+ "const": "Video"
140
197
  },
141
- "path": {
142
- "type": "string"
198
+ "url": {
199
+ "$ref": "common_types.json#/$defs/DynamicString",
200
+ "description": "The URL of the video to display."
143
201
  }
144
- }
202
+ },
203
+ "required": ["component", "url"]
145
204
  }
146
- },
147
- "required": ["url"]
205
+ ],
206
+ "unevaluatedProperties": false
148
207
  },
149
208
  "AudioPlayer": {
150
209
  "type": "object",
151
- "additionalProperties": false,
152
- "properties": {
153
- "url": {
154
- "type": "object",
155
- "description": "The URL of the audio to be played. This can be a literal string ('literal') or a reference to a value in the data model ('path', e.g. '/song/url').",
156
- "additionalProperties": false,
157
- "properties": {
158
- "literalString": {
159
- "type": "string"
160
- },
161
- "path": {
162
- "type": "string"
163
- }
164
- }
210
+ "allOf": [
211
+ {
212
+ "$ref": "common_types.json#/$defs/ComponentCommon"
213
+ },
214
+ {
215
+ "$ref": "#/$defs/CatalogComponentCommon"
165
216
  },
166
- "description": {
217
+ {
167
218
  "type": "object",
168
- "description": "A description of the audio, such as a title or summary. This can be a literal string or a reference to a value in the data model ('path', e.g. '/song/title').",
169
- "additionalProperties": false,
170
219
  "properties": {
171
- "literalString": {
172
- "type": "string"
220
+ "component": {
221
+ "const": "AudioPlayer"
173
222
  },
174
- "path": {
175
- "type": "string"
223
+ "url": {
224
+ "$ref": "common_types.json#/$defs/DynamicString",
225
+ "description": "The URL of the audio to be played."
226
+ },
227
+ "description": {
228
+ "description": "A description of the audio, such as a title or summary.",
229
+ "$ref": "common_types.json#/$defs/DynamicString"
176
230
  }
177
- }
231
+ },
232
+ "required": ["component", "url"]
178
233
  }
179
- },
180
- "required": ["url"]
234
+ ],
235
+ "unevaluatedProperties": false
181
236
  },
182
237
  "Row": {
183
238
  "type": "object",
184
- "additionalProperties": false,
185
- "properties": {
186
- "children": {
239
+ "allOf": [
240
+ {
241
+ "$ref": "common_types.json#/$defs/ComponentCommon"
242
+ },
243
+ {
244
+ "$ref": "#/$defs/CatalogComponentCommon"
245
+ },
246
+ {
187
247
  "type": "object",
188
- "description": "Defines the children. Use 'explicitList' for a fixed set of children, or 'template' to generate children from a data list.",
189
- "additionalProperties": false,
248
+ "description": "A layout component that arranges its children horizontally. To create a grid layout, nest Columns within this Row.",
190
249
  "properties": {
191
- "explicitList": {
192
- "type": "array",
193
- "items": {
194
- "type": "string"
195
- }
250
+ "component": {
251
+ "const": "Row"
196
252
  },
197
- "template": {
198
- "type": "object",
199
- "description": "A template for generating a dynamic list of children from a data model list. `componentId` is the component to use as a template, and `dataBinding` is the path to the map of components in the data model. Values in the map will define the list of children.",
200
- "additionalProperties": false,
201
- "properties": {
202
- "componentId": {
203
- "type": "string"
204
- },
205
- "dataBinding": {
206
- "type": "string"
207
- }
208
- },
209
- "required": ["componentId", "dataBinding"]
253
+ "children": {
254
+ "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.",
255
+ "$ref": "common_types.json#/$defs/ChildList"
256
+ },
257
+ "justify": {
258
+ "type": "string",
259
+ "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.",
260
+ "enum": [
261
+ "center",
262
+ "end",
263
+ "spaceAround",
264
+ "spaceBetween",
265
+ "spaceEvenly",
266
+ "start",
267
+ "stretch"
268
+ ],
269
+ "default": "start"
270
+ },
271
+ "align": {
272
+ "type": "string",
273
+ "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').",
274
+ "enum": ["start", "center", "end", "stretch"],
275
+ "default": "stretch"
210
276
  }
211
- }
212
- },
213
- "distribution": {
214
- "type": "string",
215
- "description": "Defines the arrangement of children along the main axis (horizontally). This corresponds to the CSS 'justify-content' property.",
216
- "enum": ["center", "end", "spaceAround", "spaceBetween", "spaceEvenly", "start"]
217
- },
218
- "alignment": {
219
- "type": "string",
220
- "description": "Defines the alignment of children along the cross axis (vertically). This corresponds to the CSS 'align-items' property.",
221
- "enum": ["start", "center", "end", "stretch"]
277
+ },
278
+ "required": ["component", "children"]
222
279
  }
223
- },
224
- "required": ["children"]
280
+ ],
281
+ "unevaluatedProperties": false
225
282
  },
226
283
  "Column": {
227
284
  "type": "object",
228
- "additionalProperties": false,
229
- "properties": {
230
- "children": {
285
+ "allOf": [
286
+ {
287
+ "$ref": "common_types.json#/$defs/ComponentCommon"
288
+ },
289
+ {
290
+ "$ref": "#/$defs/CatalogComponentCommon"
291
+ },
292
+ {
231
293
  "type": "object",
232
- "description": "Defines the children. Use 'explicitList' for a fixed set of children, or 'template' to generate children from a data list.",
233
- "additionalProperties": false,
294
+ "description": "A layout component that arranges its children vertically. To create a grid layout, nest Rows within this Column.",
234
295
  "properties": {
235
- "explicitList": {
236
- "type": "array",
237
- "items": {
238
- "type": "string"
239
- }
296
+ "component": {
297
+ "const": "Column"
240
298
  },
241
- "template": {
242
- "type": "object",
243
- "description": "A template for generating a dynamic list of children from a data model list. `componentId` is the component to use as a template, and `dataBinding` is the path to the map of components in the data model. Values in the map will define the list of children.",
244
- "additionalProperties": false,
245
- "properties": {
246
- "componentId": {
247
- "type": "string"
248
- },
249
- "dataBinding": {
250
- "type": "string"
251
- }
252
- },
253
- "required": ["componentId", "dataBinding"]
299
+ "children": {
300
+ "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.",
301
+ "$ref": "common_types.json#/$defs/ChildList"
302
+ },
303
+ "justify": {
304
+ "type": "string",
305
+ "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.",
306
+ "enum": [
307
+ "start",
308
+ "center",
309
+ "end",
310
+ "spaceBetween",
311
+ "spaceAround",
312
+ "spaceEvenly",
313
+ "stretch"
314
+ ],
315
+ "default": "start"
316
+ },
317
+ "align": {
318
+ "type": "string",
319
+ "description": "Defines the alignment of children along the cross axis (horizontally). This is similar to the CSS 'align-items' property.",
320
+ "enum": ["center", "end", "start", "stretch"],
321
+ "default": "stretch"
254
322
  }
255
- }
256
- },
257
- "distribution": {
258
- "type": "string",
259
- "description": "Defines the arrangement of children along the main axis (vertically). This corresponds to the CSS 'justify-content' property.",
260
- "enum": ["start", "center", "end", "spaceBetween", "spaceAround", "spaceEvenly"]
261
- },
262
- "alignment": {
263
- "type": "string",
264
- "description": "Defines the alignment of children along the cross axis (horizontally). This corresponds to the CSS 'align-items' property.",
265
- "enum": ["center", "end", "start", "stretch"]
323
+ },
324
+ "required": ["component", "children"]
266
325
  }
267
- },
268
- "required": ["children"]
326
+ ],
327
+ "unevaluatedProperties": false
269
328
  },
270
329
  "List": {
271
330
  "type": "object",
272
- "additionalProperties": false,
273
- "properties": {
274
- "children": {
331
+ "allOf": [
332
+ {
333
+ "$ref": "common_types.json#/$defs/ComponentCommon"
334
+ },
335
+ {
336
+ "$ref": "#/$defs/CatalogComponentCommon"
337
+ },
338
+ {
275
339
  "type": "object",
276
- "description": "Defines the children. Use 'explicitList' for a fixed set of children, or 'template' to generate children from a data list.",
277
- "additionalProperties": false,
278
340
  "properties": {
279
- "explicitList": {
280
- "type": "array",
281
- "items": {
282
- "type": "string"
283
- }
341
+ "component": {
342
+ "const": "List"
284
343
  },
285
- "template": {
286
- "type": "object",
287
- "description": "A template for generating a dynamic list of children from a data model list. `componentId` is the component to use as a template, and `dataBinding` is the path to the map of components in the data model. Values in the map will define the list of children.",
288
- "additionalProperties": false,
289
- "properties": {
290
- "componentId": {
291
- "type": "string"
292
- },
293
- "dataBinding": {
294
- "type": "string"
295
- }
296
- },
297
- "required": ["componentId", "dataBinding"]
344
+ "children": {
345
+ "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.",
346
+ "$ref": "common_types.json#/$defs/ChildList"
347
+ },
348
+ "direction": {
349
+ "type": "string",
350
+ "description": "The direction in which the list items are laid out.",
351
+ "enum": ["vertical", "horizontal"],
352
+ "default": "vertical"
353
+ },
354
+ "align": {
355
+ "type": "string",
356
+ "description": "Defines the alignment of children along the cross axis.",
357
+ "enum": ["start", "center", "end", "stretch"],
358
+ "default": "stretch"
298
359
  }
299
- }
300
- },
301
- "direction": {
302
- "type": "string",
303
- "description": "The direction in which the list items are laid out.",
304
- "enum": ["vertical", "horizontal"]
305
- },
306
- "alignment": {
307
- "type": "string",
308
- "description": "Defines the alignment of children along the cross axis.",
309
- "enum": ["start", "center", "end", "stretch"]
360
+ },
361
+ "required": ["component", "children"]
310
362
  }
311
- },
312
- "required": ["children"]
363
+ ],
364
+ "unevaluatedProperties": false
313
365
  },
314
366
  "Card": {
315
367
  "type": "object",
316
- "additionalProperties": false,
317
- "properties": {
318
- "child": {
319
- "type": "string",
320
- "description": "The ID of the component to be rendered inside the card."
368
+ "allOf": [
369
+ {
370
+ "$ref": "common_types.json#/$defs/ComponentCommon"
371
+ },
372
+ {
373
+ "$ref": "#/$defs/CatalogComponentCommon"
374
+ },
375
+ {
376
+ "type": "object",
377
+ "properties": {
378
+ "component": {
379
+ "const": "Card"
380
+ },
381
+ "child": {
382
+ "$ref": "common_types.json#/$defs/ComponentId",
383
+ "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."
384
+ }
385
+ },
386
+ "required": ["component", "child"]
321
387
  }
322
- },
323
- "required": ["child"]
388
+ ],
389
+ "unevaluatedProperties": false
324
390
  },
325
391
  "Tabs": {
326
392
  "type": "object",
327
- "additionalProperties": false,
328
- "properties": {
329
- "tabItems": {
330
- "type": "array",
331
- "description": "An array of objects, where each object defines a tab with a title and a child component.",
332
- "items": {
333
- "type": "object",
334
- "additionalProperties": false,
335
- "properties": {
336
- "title": {
393
+ "allOf": [
394
+ {
395
+ "$ref": "common_types.json#/$defs/ComponentCommon"
396
+ },
397
+ {
398
+ "$ref": "#/$defs/CatalogComponentCommon"
399
+ },
400
+ {
401
+ "type": "object",
402
+ "properties": {
403
+ "component": {
404
+ "const": "Tabs"
405
+ },
406
+ "tabs": {
407
+ "type": "array",
408
+ "description": "An array of objects, where each object defines a tab with a title and a child component.",
409
+ "minItems": 1,
410
+ "items": {
337
411
  "type": "object",
338
- "description": "The tab title. Defines the value as either a literal value or a path to data model value (e.g. '/options/title').",
339
- "additionalProperties": false,
340
412
  "properties": {
341
- "literalString": {
342
- "type": "string"
413
+ "title": {
414
+ "description": "The tab title.",
415
+ "$ref": "common_types.json#/$defs/DynamicString"
343
416
  },
344
- "path": {
345
- "type": "string"
417
+ "child": {
418
+ "$ref": "common_types.json#/$defs/ComponentId",
419
+ "description": "The ID of the child component. Do NOT define the component inline."
346
420
  }
347
- }
348
- },
349
- "child": {
350
- "type": "string"
421
+ },
422
+ "required": ["title", "child"],
423
+ "additionalProperties": false
351
424
  }
425
+ }
426
+ },
427
+ "required": ["component", "tabs"]
428
+ }
429
+ ],
430
+ "unevaluatedProperties": false
431
+ },
432
+ "Modal": {
433
+ "type": "object",
434
+ "allOf": [
435
+ {
436
+ "$ref": "common_types.json#/$defs/ComponentCommon"
437
+ },
438
+ {
439
+ "$ref": "#/$defs/CatalogComponentCommon"
440
+ },
441
+ {
442
+ "type": "object",
443
+ "properties": {
444
+ "component": {
445
+ "const": "Modal"
352
446
  },
353
- "required": ["title", "child"]
354
- }
447
+ "trigger": {
448
+ "$ref": "common_types.json#/$defs/ComponentId",
449
+ "description": "The ID of the component that opens the modal when interacted with (e.g., a button). Do NOT define the component inline."
450
+ },
451
+ "content": {
452
+ "$ref": "common_types.json#/$defs/ComponentId",
453
+ "description": "The ID of the component to be displayed inside the modal. Do NOT define the component inline."
454
+ }
455
+ },
456
+ "required": ["component", "trigger", "content"]
355
457
  }
356
- },
357
- "required": ["tabItems"]
458
+ ],
459
+ "unevaluatedProperties": false
358
460
  },
359
461
  "Divider": {
360
462
  "type": "object",
361
- "additionalProperties": false,
362
- "properties": {
363
- "axis": {
364
- "type": "string",
365
- "description": "The orientation of the divider.",
366
- "enum": ["horizontal", "vertical"]
463
+ "allOf": [
464
+ {
465
+ "$ref": "common_types.json#/$defs/ComponentCommon"
466
+ },
467
+ {
468
+ "$ref": "#/$defs/CatalogComponentCommon"
469
+ },
470
+ {
471
+ "type": "object",
472
+ "properties": {
473
+ "component": {
474
+ "const": "Divider"
475
+ },
476
+ "axis": {
477
+ "type": "string",
478
+ "description": "The orientation of the divider.",
479
+ "enum": ["horizontal", "vertical"],
480
+ "default": "horizontal"
481
+ }
482
+ },
483
+ "required": ["component"]
367
484
  }
368
- }
485
+ ],
486
+ "unevaluatedProperties": false
369
487
  },
370
- "Modal": {
488
+ "Button": {
371
489
  "type": "object",
372
- "additionalProperties": false,
373
- "properties": {
374
- "entryPointChild": {
375
- "type": "string",
376
- "description": "The ID of the component that opens the modal when interacted with (e.g., a button)."
490
+ "allOf": [
491
+ {
492
+ "$ref": "common_types.json#/$defs/ComponentCommon"
377
493
  },
378
- "contentChild": {
379
- "type": "string",
380
- "description": "The ID of the component to be displayed inside the modal."
494
+ {
495
+ "$ref": "#/$defs/CatalogComponentCommon"
496
+ },
497
+ {
498
+ "$ref": "common_types.json#/$defs/Checkable"
499
+ },
500
+ {
501
+ "type": "object",
502
+ "properties": {
503
+ "component": {
504
+ "const": "Button"
505
+ },
506
+ "child": {
507
+ "$ref": "common_types.json#/$defs/ComponentId",
508
+ "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."
509
+ },
510
+ "variant": {
511
+ "type": "string",
512
+ "enum": ["default", "primary", "borderless", "destructive"],
513
+ "default": "default",
514
+ "description": "A hint for the button style. If omitted, a default button style is used. 'primary' indicates this is the main call-to-action button. 'borderless' means the button has no visual border or background, making its child content appear like a clickable link. 'destructive' indicates a dangerous or irreversible action."
515
+ },
516
+ "action": {
517
+ "$ref": "common_types.json#/$defs/Action"
518
+ }
519
+ },
520
+ "required": ["component", "child", "action"]
381
521
  }
382
- },
383
- "required": ["entryPointChild", "contentChild"]
522
+ ],
523
+ "unevaluatedProperties": false
384
524
  },
385
- "Button": {
525
+ "TextField": {
386
526
  "type": "object",
387
- "additionalProperties": false,
388
- "properties": {
389
- "child": {
390
- "type": "string",
391
- "description": "The ID of the component to display in the button, typically a Text component."
527
+ "allOf": [
528
+ {
529
+ "$ref": "common_types.json#/$defs/ComponentCommon"
392
530
  },
393
- "primary": {
394
- "type": "boolean",
395
- "description": "Indicates if this button should be styled as the primary action."
531
+ {
532
+ "$ref": "#/$defs/CatalogComponentCommon"
396
533
  },
397
- "action": {
534
+ {
535
+ "$ref": "common_types.json#/$defs/Checkable"
536
+ },
537
+ {
398
538
  "type": "object",
399
- "description": "The client-side action to be dispatched when the button is clicked. It includes the action's name and an optional context payload.",
400
- "additionalProperties": false,
401
539
  "properties": {
402
- "name": {
403
- "type": "string"
540
+ "component": {
541
+ "const": "TextField"
542
+ },
543
+ "label": {
544
+ "$ref": "common_types.json#/$defs/DynamicString",
545
+ "description": "The text label for the input field."
546
+ },
547
+ "value": {
548
+ "$ref": "common_types.json#/$defs/DynamicString",
549
+ "description": "The value of the text field."
550
+ },
551
+ "variant": {
552
+ "type": "string",
553
+ "description": "The type of input field to display.",
554
+ "enum": ["longText", "number", "shortText", "obscured"],
555
+ "default": "shortText"
556
+ },
557
+ "validationRegexp": {
558
+ "type": "string",
559
+ "description": "A regular expression used for client-side validation of the input."
560
+ }
561
+ },
562
+ "required": ["component", "label"]
563
+ }
564
+ ],
565
+ "unevaluatedProperties": false
566
+ },
567
+ "CheckBox": {
568
+ "type": "object",
569
+ "allOf": [
570
+ {
571
+ "$ref": "common_types.json#/$defs/ComponentCommon"
572
+ },
573
+ {
574
+ "$ref": "#/$defs/CatalogComponentCommon"
575
+ },
576
+ {
577
+ "$ref": "common_types.json#/$defs/Checkable"
578
+ },
579
+ {
580
+ "type": "object",
581
+ "properties": {
582
+ "component": {
583
+ "const": "CheckBox"
404
584
  },
405
- "context": {
585
+ "label": {
586
+ "$ref": "common_types.json#/$defs/DynamicString",
587
+ "description": "The text to display next to the checkbox."
588
+ },
589
+ "value": {
590
+ "$ref": "common_types.json#/$defs/DynamicBoolean",
591
+ "description": "The current state of the checkbox (true for checked, false for unchecked)."
592
+ }
593
+ },
594
+ "required": ["component", "label", "value"]
595
+ }
596
+ ],
597
+ "unevaluatedProperties": false
598
+ },
599
+ "ChoicePicker": {
600
+ "type": "object",
601
+ "allOf": [
602
+ {
603
+ "$ref": "common_types.json#/$defs/ComponentCommon"
604
+ },
605
+ {
606
+ "$ref": "#/$defs/CatalogComponentCommon"
607
+ },
608
+ {
609
+ "$ref": "common_types.json#/$defs/Checkable"
610
+ },
611
+ {
612
+ "type": "object",
613
+ "description": "A component that allows selecting one or more options from a list.",
614
+ "properties": {
615
+ "component": {
616
+ "const": "ChoicePicker"
617
+ },
618
+ "label": {
619
+ "$ref": "common_types.json#/$defs/DynamicString",
620
+ "description": "The label for the group of options."
621
+ },
622
+ "variant": {
623
+ "type": "string",
624
+ "description": "A hint for how the choice picker should be displayed and behave.",
625
+ "enum": ["multipleSelection", "mutuallyExclusive"],
626
+ "default": "mutuallyExclusive"
627
+ },
628
+ "options": {
406
629
  "type": "array",
630
+ "description": "The list of available options to choose from.",
407
631
  "items": {
408
632
  "type": "object",
409
- "additionalProperties": false,
410
633
  "properties": {
411
- "key": {
412
- "type": "string"
634
+ "label": {
635
+ "description": "The text to display for this option.",
636
+ "$ref": "common_types.json#/$defs/DynamicString"
413
637
  },
414
638
  "value": {
415
- "type": "object",
416
- "description": "Defines the value to be included in the context as either a literal value or a path to a data model value (e.g. '/user/name').",
417
- "additionalProperties": false,
418
- "properties": {
419
- "path": {
420
- "type": "string"
421
- },
422
- "literalString": {
423
- "type": "string"
424
- },
425
- "literalNumber": {
426
- "type": "number"
427
- },
428
- "literalBoolean": {
429
- "type": "boolean"
430
- }
431
- }
639
+ "type": "string",
640
+ "description": "The stable value associated with this option."
432
641
  }
433
642
  },
434
- "required": ["key", "value"]
643
+ "required": ["label", "value"],
644
+ "additionalProperties": false
435
645
  }
646
+ },
647
+ "value": {
648
+ "$ref": "common_types.json#/$defs/DynamicStringList",
649
+ "description": "The list of currently selected values. This should be bound to a string array in the data model."
650
+ },
651
+ "displayStyle": {
652
+ "type": "string",
653
+ "description": "The display style of the component.",
654
+ "enum": ["checkbox", "chips"],
655
+ "default": "checkbox"
656
+ },
657
+ "filterable": {
658
+ "type": "boolean",
659
+ "description": "If true, displays a search input to filter the options.",
660
+ "default": false
436
661
  }
437
662
  },
438
- "required": ["name"]
663
+ "required": ["component", "options", "value"]
439
664
  }
440
- },
441
- "required": ["child", "action"]
665
+ ],
666
+ "unevaluatedProperties": false
442
667
  },
443
- "DestructiveButton": {
668
+ "Slider": {
444
669
  "type": "object",
445
- "additionalProperties": false,
446
- "properties": {
447
- "child": {
448
- "type": "string",
449
- "description": "The ID of the component to display in the button, typically a Text component."
670
+ "allOf": [
671
+ {
672
+ "$ref": "common_types.json#/$defs/ComponentCommon"
673
+ },
674
+ {
675
+ "$ref": "#/$defs/CatalogComponentCommon"
450
676
  },
451
- "action": {
677
+ {
678
+ "$ref": "common_types.json#/$defs/Checkable"
679
+ },
680
+ {
452
681
  "type": "object",
453
- "description": "The client-side action to be dispatched when the button is clicked. It includes the action's name and an optional context payload.",
454
- "additionalProperties": false,
455
682
  "properties": {
456
- "name": {
457
- "type": "string"
683
+ "component": {
684
+ "const": "Slider"
458
685
  },
459
- "context": {
460
- "type": "array",
461
- "items": {
462
- "type": "object",
463
- "additionalProperties": false,
464
- "properties": {
465
- "key": {
686
+ "label": {
687
+ "$ref": "common_types.json#/$defs/DynamicString",
688
+ "description": "The label for the slider."
689
+ },
690
+ "min": {
691
+ "type": "number",
692
+ "description": "The minimum value of the slider.",
693
+ "default": 0
694
+ },
695
+ "max": {
696
+ "type": "number",
697
+ "description": "The maximum value of the slider."
698
+ },
699
+ "value": {
700
+ "$ref": "common_types.json#/$defs/DynamicNumber",
701
+ "description": "The current value of the slider."
702
+ }
703
+ },
704
+ "required": ["component", "value", "max"]
705
+ }
706
+ ],
707
+ "unevaluatedProperties": false
708
+ },
709
+ "DateTimeInput": {
710
+ "type": "object",
711
+ "allOf": [
712
+ {
713
+ "$ref": "common_types.json#/$defs/ComponentCommon"
714
+ },
715
+ {
716
+ "$ref": "#/$defs/CatalogComponentCommon"
717
+ },
718
+ {
719
+ "$ref": "common_types.json#/$defs/Checkable"
720
+ },
721
+ {
722
+ "type": "object",
723
+ "properties": {
724
+ "component": {
725
+ "const": "DateTimeInput"
726
+ },
727
+ "value": {
728
+ "$ref": "common_types.json#/$defs/DynamicString",
729
+ "description": "The selected date and/or time value in ISO 8601 format. If not yet set, initialize with an empty string."
730
+ },
731
+ "enableDate": {
732
+ "type": "boolean",
733
+ "description": "If true, allows the user to select a date.",
734
+ "default": false
735
+ },
736
+ "enableTime": {
737
+ "type": "boolean",
738
+ "description": "If true, allows the user to select a time.",
739
+ "default": false
740
+ },
741
+ "min": {
742
+ "allOf": [
743
+ {
744
+ "$ref": "common_types.json#/$defs/DynamicString"
745
+ },
746
+ {
747
+ "if": {
466
748
  "type": "string"
467
749
  },
468
- "value": {
469
- "type": "object",
470
- "description": "Defines the value to be included in the context as either a literal value or a path to a data model value (e.g. '/user/name').",
471
- "additionalProperties": false,
472
- "properties": {
473
- "path": {
474
- "type": "string"
475
- },
476
- "literalString": {
477
- "type": "string"
750
+ "then": {
751
+ "oneOf": [
752
+ {
753
+ "format": "date"
478
754
  },
479
- "literalNumber": {
480
- "type": "number"
755
+ {
756
+ "format": "time"
481
757
  },
482
- "literalBoolean": {
483
- "type": "boolean"
758
+ {
759
+ "format": "date-time"
484
760
  }
485
- }
761
+ ]
486
762
  }
763
+ }
764
+ ],
765
+ "description": "The minimum allowed date/time in ISO 8601 format."
766
+ },
767
+ "max": {
768
+ "allOf": [
769
+ {
770
+ "$ref": "common_types.json#/$defs/DynamicString"
487
771
  },
488
- "required": ["key", "value"]
489
- }
772
+ {
773
+ "if": {
774
+ "type": "string"
775
+ },
776
+ "then": {
777
+ "oneOf": [
778
+ {
779
+ "format": "date"
780
+ },
781
+ {
782
+ "format": "time"
783
+ },
784
+ {
785
+ "format": "date-time"
786
+ }
787
+ ]
788
+ }
789
+ }
790
+ ],
791
+ "description": "The maximum allowed date/time in ISO 8601 format."
792
+ },
793
+ "label": {
794
+ "$ref": "common_types.json#/$defs/DynamicString",
795
+ "description": "The text label for the input field."
490
796
  }
491
797
  },
492
- "required": ["name"]
798
+ "required": ["component", "value"]
493
799
  }
494
- },
495
- "required": ["child", "action"]
800
+ ],
801
+ "unevaluatedProperties": false
496
802
  },
497
- "ButtonAsLink": {
803
+ "TagInput": {
498
804
  "type": "object",
499
- "additionalProperties": false,
500
- "properties": {
501
- "child": {
502
- "type": "string",
503
- "description": "The ID of the component to display in the link, typically a Text component."
805
+ "allOf": [
806
+ {
807
+ "$ref": "common_types.json#/$defs/ComponentCommon"
808
+ },
809
+ {
810
+ "$ref": "#/$defs/CatalogComponentCommon"
504
811
  },
505
- "href": {
812
+ {
506
813
  "type": "object",
507
- "description": "The URL the link navigates to. This can be a literal string or a reference to a value in the data model ('path', e.g. '/form/documentationUrl').",
508
- "additionalProperties": false,
814
+ "description": "A tag input field for adding and removing string tags.",
509
815
  "properties": {
510
- "literalString": {
511
- "type": "string"
816
+ "component": {
817
+ "const": "TagInput"
818
+ },
819
+ "label": {
820
+ "$ref": "common_types.json#/$defs/DynamicString",
821
+ "description": "The text label for the field."
822
+ },
823
+ "value": {
824
+ "$ref": "common_types.json#/$defs/DynamicStringList",
825
+ "description": "The list of current tags. Should be bound to a string array in the data model."
826
+ },
827
+ "placeholder": {
828
+ "$ref": "common_types.json#/$defs/DynamicString",
829
+ "description": "Placeholder text shown when there are no tags."
830
+ },
831
+ "disabled": {
832
+ "$ref": "common_types.json#/$defs/DynamicBoolean",
833
+ "description": "If true, the input is disabled."
512
834
  },
513
- "path": {
514
- "type": "string"
835
+ "disableTextInput": {
836
+ "type": "boolean",
837
+ "description": "If true, hides the text input and only displays existing tags."
838
+ },
839
+ "validationRegexp": {
840
+ "type": "string",
841
+ "description": "A regular expression used to validate each tag before it is added."
842
+ },
843
+ "validationErrorMessage": {
844
+ "$ref": "common_types.json#/$defs/DynamicString",
845
+ "description": "The error message shown when a tag fails validation."
515
846
  }
516
- }
847
+ },
848
+ "required": ["component", "value"]
849
+ }
850
+ ],
851
+ "unevaluatedProperties": false
852
+ },
853
+ "Timeout": {
854
+ "type": "object",
855
+ "allOf": [
856
+ {
857
+ "$ref": "common_types.json#/$defs/ComponentCommon"
858
+ },
859
+ {
860
+ "$ref": "#/$defs/CatalogComponentCommon"
517
861
  },
518
- "target": {
862
+ {
519
863
  "type": "object",
520
- "description": "Where to open the linked URL. Use '_blank' to open in a new tab. When omitted, the link opens in the same tab.",
521
- "additionalProperties": false,
864
+ "description": "A countdown timer to a target UTC time.",
522
865
  "properties": {
523
- "literalString": {
524
- "type": "string",
525
- "enum": ["_self", "_blank", "_parent", "_top"]
866
+ "component": {
867
+ "const": "Timeout"
868
+ },
869
+ "targetTimeUtc": {
870
+ "$ref": "common_types.json#/$defs/DynamicString",
871
+ "description": "The target time as a UTC ISO 8601 string to count down to."
526
872
  },
527
- "path": {
528
- "type": "string"
873
+ "variant": {
874
+ "type": "string",
875
+ "enum": ["body", "caption", "h3", "h4", "h5"],
876
+ "description": "A hint for the base text style."
529
877
  }
530
- }
878
+ },
879
+ "required": ["component", "targetTimeUtc"]
880
+ }
881
+ ],
882
+ "unevaluatedProperties": false
883
+ }
884
+ },
885
+ "functions": {
886
+ "required": {
887
+ "type": "object",
888
+ "description": "Checks that the value is not null, undefined, or empty.",
889
+ "properties": {
890
+ "call": {
891
+ "const": "required"
892
+ },
893
+ "args": {
894
+ "type": "object",
895
+ "properties": {
896
+ "value": {
897
+ "description": "The value to check."
898
+ }
899
+ },
900
+ "required": ["value"],
901
+ "additionalProperties": false
902
+ },
903
+ "returnType": {
904
+ "const": "boolean"
531
905
  }
532
906
  },
533
- "required": ["child", "href"]
907
+ "required": ["call", "args"],
908
+ "unevaluatedProperties": false
534
909
  },
535
- "CheckBox": {
910
+ "regex": {
536
911
  "type": "object",
537
- "additionalProperties": false,
912
+ "description": "Checks that the value matches a regular expression string.",
538
913
  "properties": {
539
- "label": {
914
+ "call": {
915
+ "const": "regex"
916
+ },
917
+ "args": {
540
918
  "type": "object",
541
- "description": "The text to display next to the checkbox. Defines the value as either a literal value or a path to data model ('path', e.g. '/option/label').",
542
- "additionalProperties": false,
543
919
  "properties": {
544
- "literalString": {
545
- "type": "string"
920
+ "value": {
921
+ "$ref": "common_types.json#/$defs/DynamicString"
546
922
  },
547
- "path": {
548
- "type": "string"
923
+ "pattern": {
924
+ "type": "string",
925
+ "description": "The regex pattern to match against."
549
926
  }
550
- }
927
+ },
928
+ "required": ["value", "pattern"],
929
+ "unevaluatedProperties": false
551
930
  },
552
- "value": {
931
+ "returnType": {
932
+ "const": "boolean"
933
+ }
934
+ },
935
+ "required": ["call", "args"],
936
+ "unevaluatedProperties": false
937
+ },
938
+ "length": {
939
+ "type": "object",
940
+ "description": "Checks string length constraints.",
941
+ "properties": {
942
+ "call": {
943
+ "const": "length"
944
+ },
945
+ "args": {
553
946
  "type": "object",
554
- "description": "The current state of the checkbox (true for checked, false for unchecked). This can be a literal boolean ('literalBoolean') or a reference to a value in the data model ('path', e.g. '/filter/open').",
555
- "additionalProperties": false,
556
947
  "properties": {
557
- "literalBoolean": {
558
- "type": "boolean"
948
+ "value": {
949
+ "$ref": "common_types.json#/$defs/DynamicString"
950
+ },
951
+ "min": {
952
+ "type": "integer",
953
+ "minimum": 0,
954
+ "description": "The minimum allowed length."
955
+ },
956
+ "max": {
957
+ "type": "integer",
958
+ "minimum": 0,
959
+ "description": "The maximum allowed length."
960
+ }
961
+ },
962
+ "required": ["value"],
963
+ "anyOf": [
964
+ {
965
+ "required": ["min"]
559
966
  },
560
- "path": {
561
- "type": "string"
967
+ {
968
+ "required": ["max"]
562
969
  }
563
- }
970
+ ],
971
+ "unevaluatedProperties": false
972
+ },
973
+ "returnType": {
974
+ "const": "boolean"
564
975
  }
565
976
  },
566
- "required": ["label", "value"]
977
+ "required": ["call", "args"],
978
+ "unevaluatedProperties": false
567
979
  },
568
- "TextField": {
980
+ "numeric": {
569
981
  "type": "object",
570
- "additionalProperties": false,
982
+ "description": "Checks numeric range constraints.",
571
983
  "properties": {
572
- "label": {
984
+ "call": {
985
+ "const": "numeric"
986
+ },
987
+ "args": {
573
988
  "type": "object",
574
- "description": "The text label for the input field. This can be a literal string or a reference to a value in the data model ('path, e.g. '/user/name').",
575
- "additionalProperties": false,
576
989
  "properties": {
577
- "literalString": {
578
- "type": "string"
990
+ "value": {
991
+ "$ref": "common_types.json#/$defs/DynamicNumber"
992
+ },
993
+ "min": {
994
+ "type": "number",
995
+ "description": "The minimum allowed value."
996
+ },
997
+ "max": {
998
+ "type": "number",
999
+ "description": "The maximum allowed value."
1000
+ }
1001
+ },
1002
+ "required": ["value"],
1003
+ "anyOf": [
1004
+ {
1005
+ "required": ["min"]
579
1006
  },
580
- "path": {
581
- "type": "string"
1007
+ {
1008
+ "required": ["max"]
582
1009
  }
583
- }
1010
+ ],
1011
+ "unevaluatedProperties": false
584
1012
  },
585
- "text": {
1013
+ "returnType": {
1014
+ "const": "boolean"
1015
+ }
1016
+ },
1017
+ "required": ["call", "args"],
1018
+ "unevaluatedProperties": false
1019
+ },
1020
+ "email": {
1021
+ "type": "object",
1022
+ "description": "Checks that the value is a valid email address.",
1023
+ "properties": {
1024
+ "call": {
1025
+ "const": "email"
1026
+ },
1027
+ "args": {
586
1028
  "type": "object",
587
- "description": "The value of the text field. This can be a literal string or a reference to a value in the data model ('path', e.g. '/user/name').",
588
- "additionalProperties": false,
589
1029
  "properties": {
590
- "literalString": {
591
- "type": "string"
592
- },
593
- "path": {
594
- "type": "string"
1030
+ "value": {
1031
+ "$ref": "common_types.json#/$defs/DynamicString"
595
1032
  }
596
- }
597
- },
598
- "textFieldType": {
599
- "type": "string",
600
- "description": "The type of input field to display.",
601
- "enum": ["date", "longText", "number", "shortText", "obscured"]
1033
+ },
1034
+ "required": ["value"],
1035
+ "unevaluatedProperties": false
602
1036
  },
603
- "validationRegexp": {
604
- "type": "string",
605
- "description": "A regular expression used for client-side validation of the input."
1037
+ "returnType": {
1038
+ "const": "boolean"
606
1039
  }
607
1040
  },
608
- "required": ["label"]
1041
+ "required": ["call", "args"],
1042
+ "unevaluatedProperties": false
609
1043
  },
610
- "DateTimeInput": {
1044
+ "formatString": {
611
1045
  "type": "object",
612
- "additionalProperties": false,
1046
+ "description": "Performs string interpolation of data model values and other functions in the catalog functions list and returns the resulting string. The value string can contain interpolated expressions in the `${expression}` format. Supported expression types include: JSON Pointer paths to the data model (e.g., `${/absolute/path}` or `${relative/path}`), and client-side function calls (e.g., `${now()}`). Function arguments must be named (e.g., `${formatDate(value:${/currentDate}, format:'MM-dd')}`). To include a literal `${` sequence, escape it as `\\${`.",
613
1047
  "properties": {
614
- "value": {
1048
+ "call": {
1049
+ "const": "formatString"
1050
+ },
1051
+ "args": {
615
1052
  "type": "object",
616
- "description": "The selected date and/or time value in ISO 8601 format. This can be a literal string ('literalString') or a reference to a value in the data model ('path', e.g. '/user/dob').",
617
- "additionalProperties": false,
618
1053
  "properties": {
619
- "literalString": {
620
- "type": "string"
621
- },
622
- "path": {
623
- "type": "string"
1054
+ "value": {
1055
+ "$ref": "common_types.json#/$defs/DynamicString"
624
1056
  }
625
- }
626
- },
627
- "enableDate": {
628
- "type": "boolean",
629
- "description": "If true, allows the user to select a date."
1057
+ },
1058
+ "required": ["value"],
1059
+ "unevaluatedProperties": false
630
1060
  },
631
- "enableTime": {
632
- "type": "boolean",
633
- "description": "If true, allows the user to select a time."
1061
+ "returnType": {
1062
+ "const": "string"
634
1063
  }
635
1064
  },
636
- "required": ["value"]
1065
+ "required": ["call", "args"],
1066
+ "unevaluatedProperties": false
637
1067
  },
638
- "MultipleChoice": {
1068
+ "formatNumber": {
639
1069
  "type": "object",
640
- "additionalProperties": false,
641
- "required": ["selections", "options"],
1070
+ "description": "Formats a number with the specified grouping and decimal precision.",
642
1071
  "properties": {
643
- "selections": {
1072
+ "call": {
1073
+ "const": "formatNumber"
1074
+ },
1075
+ "args": {
644
1076
  "type": "object",
645
- "description": "The currently selected values for the component. This can be a literal array of strings or a path to an array in the data model('path', e.g. '/hotel/options').",
646
- "additionalProperties": false,
647
1077
  "properties": {
648
- "literalArray": {
649
- "type": "array",
650
- "items": {
651
- "type": "string"
652
- }
1078
+ "value": {
1079
+ "$ref": "common_types.json#/$defs/DynamicNumber",
1080
+ "description": "The number to format."
653
1081
  },
654
- "path": {
655
- "type": "string"
656
- }
657
- }
658
- },
659
- "options": {
660
- "type": "array",
661
- "description": "An array of available options for the user to choose from.",
662
- "items": {
663
- "type": "object",
664
- "additionalProperties": false,
665
- "properties": {
666
- "label": {
667
- "type": "object",
668
- "description": "The text to display for this option. This can be a literal string or a reference to a value in the data model (e.g. '/option/label').",
669
- "additionalProperties": false,
670
- "properties": {
671
- "literalString": {
672
- "type": "string"
673
- },
674
- "path": {
675
- "type": "string"
676
- }
677
- }
678
- },
679
- "value": {
680
- "type": "string",
681
- "description": "The value to be associated with this option when selected."
682
- }
1082
+ "decimals": {
1083
+ "$ref": "common_types.json#/$defs/DynamicNumber",
1084
+ "description": "Optional. The number of decimal places to show. Defaults to 0 or 2 depending on locale."
683
1085
  },
684
- "required": ["label", "value"]
685
- }
686
- },
687
- "maxAllowedSelections": {
688
- "type": "integer",
689
- "description": "The maximum number of options that the user is allowed to select."
690
- },
691
- "variant": {
692
- "type": "string",
693
- "description": "The display style of the component.",
694
- "enum": ["checkbox", "chips"]
1086
+ "grouping": {
1087
+ "$ref": "common_types.json#/$defs/DynamicBoolean",
1088
+ "description": "Optional. If true, uses locale-specific grouping separators (e.g. '1,000'). If false, returns raw digits (e.g. '1000'). Defaults to true."
1089
+ }
1090
+ },
1091
+ "required": ["value"],
1092
+ "unevaluatedProperties": false
695
1093
  },
696
- "filterable": {
697
- "type": "boolean",
698
- "description": "If true, displays a search input to filter the options."
1094
+ "returnType": {
1095
+ "const": "string"
699
1096
  }
700
- }
1097
+ },
1098
+ "required": ["call", "args"],
1099
+ "unevaluatedProperties": false
701
1100
  },
702
- "Slider": {
1101
+ "formatCurrency": {
703
1102
  "type": "object",
704
- "additionalProperties": false,
1103
+ "description": "Formats a number as a currency string.",
705
1104
  "properties": {
706
- "value": {
1105
+ "call": {
1106
+ "const": "formatCurrency"
1107
+ },
1108
+ "args": {
707
1109
  "type": "object",
708
- "description": "The current value of the slider. This can be a literal number ('literalNumber') or a reference to a value in the data model ('path', e.g. '/restaurant/cost').",
709
- "additionalProperties": false,
710
1110
  "properties": {
711
- "literalNumber": {
712
- "type": "number"
1111
+ "value": {
1112
+ "$ref": "common_types.json#/$defs/DynamicNumber",
1113
+ "description": "The monetary amount."
713
1114
  },
714
- "path": {
715
- "type": "string"
1115
+ "currency": {
1116
+ "$ref": "common_types.json#/$defs/DynamicString",
1117
+ "description": "The ISO 4217 currency code (e.g., 'USD', 'EUR')."
1118
+ },
1119
+ "decimals": {
1120
+ "$ref": "common_types.json#/$defs/DynamicNumber",
1121
+ "description": "Optional. The number of decimal places to show. Defaults to 0 or 2 depending on locale."
1122
+ },
1123
+ "grouping": {
1124
+ "$ref": "common_types.json#/$defs/DynamicBoolean",
1125
+ "description": "Optional. If true, uses locale-specific grouping separators (e.g. '1,000'). If false, returns raw digits (e.g. '1000'). Defaults to true."
716
1126
  }
717
- }
718
- },
719
- "minValue": {
720
- "type": "number",
721
- "description": "The minimum value of the slider."
1127
+ },
1128
+ "required": ["currency", "value"],
1129
+ "unevaluatedProperties": false
722
1130
  },
723
- "maxValue": {
724
- "type": "number",
725
- "description": "The maximum value of the slider."
1131
+ "returnType": {
1132
+ "const": "string"
726
1133
  }
727
1134
  },
728
- "required": ["value"]
1135
+ "required": ["call", "args"],
1136
+ "unevaluatedProperties": false
729
1137
  },
730
- "TagInput": {
1138
+ "formatDate": {
731
1139
  "type": "object",
732
- "additionalProperties": false,
1140
+ "description": "Formats a timestamp into a string using a pattern.",
733
1141
  "properties": {
734
- "label": {
1142
+ "call": {
1143
+ "const": "formatDate"
1144
+ },
1145
+ "args": {
735
1146
  "type": "object",
736
- "description": "The text label for the tag input field. This can be a literal string or a reference to a value in the data model ('path', e.g. '/form/tagsLabel').",
737
- "additionalProperties": false,
738
1147
  "properties": {
739
- "literalString": {
740
- "type": "string"
1148
+ "value": {
1149
+ "$ref": "common_types.json#/$defs/DynamicValue",
1150
+ "description": "The date to format."
741
1151
  },
742
- "path": {
743
- "type": "string"
1152
+ "format": {
1153
+ "$ref": "common_types.json#/$defs/DynamicString",
1154
+ "description": "A Unicode TR35 date pattern string.\n\nToken Reference:\n- Year: 'yy' (26), 'yyyy' (2026)\n- Month: 'M' (1), 'MM' (01), 'MMM' (Jan), 'MMMM' (January)\n- Day: 'd' (1), 'dd' (01), 'E' (Tue), 'EEEE' (Tuesday)\n- Hour (12h): 'h' (1-12), 'hh' (01-12) - requires 'a' for AM/PM\n- Hour (24h): 'H' (0-23), 'HH' (00-23) - Military Time\n- Minute: 'mm' (00-59)\n- Second: 'ss' (00-59)\n- Period: 'a' (AM/PM)\n\nExamples:\n- 'MMM dd, yyyy' -> 'Jan 16, 2026'\n- 'HH:mm' -> '14:30' (Military)\n- 'h:mm a' -> '2:30 PM'\n- 'EEEE, d MMMM' -> 'Friday, 16 January'"
744
1155
  }
745
- }
1156
+ },
1157
+ "required": ["format", "value"],
1158
+ "unevaluatedProperties": false
1159
+ },
1160
+ "returnType": {
1161
+ "const": "string"
1162
+ }
1163
+ },
1164
+ "required": ["call", "args"],
1165
+ "unevaluatedProperties": false
1166
+ },
1167
+ "pluralize": {
1168
+ "type": "object",
1169
+ "description": "Returns a localized string based on the Common Locale Data Repository (CLDR) plural category of the count (zero, one, two, few, many, other). Requires an 'other' fallback. For English, just use 'one' and 'other'.",
1170
+ "properties": {
1171
+ "call": {
1172
+ "const": "pluralize"
746
1173
  },
747
- "values": {
1174
+ "args": {
748
1175
  "type": "object",
749
- "description": "The array of tag values. This can be a literal array of strings or a path to an array in the data model ('path', e.g. '/form/tags').",
750
- "additionalProperties": false,
751
1176
  "properties": {
752
- "literalArray": {
753
- "type": "array",
754
- "items": {
755
- "type": "string"
756
- }
1177
+ "value": {
1178
+ "$ref": "common_types.json#/$defs/DynamicNumber",
1179
+ "description": "The numeric value used to determine the plural category."
1180
+ },
1181
+ "zero": {
1182
+ "$ref": "common_types.json#/$defs/DynamicString",
1183
+ "description": "String for the 'zero' category (e.g., 0 items)."
757
1184
  },
758
- "path": {
759
- "type": "string"
1185
+ "one": {
1186
+ "$ref": "common_types.json#/$defs/DynamicString",
1187
+ "description": "String for the 'one' category (e.g., 1 item)."
1188
+ },
1189
+ "two": {
1190
+ "$ref": "common_types.json#/$defs/DynamicString",
1191
+ "description": "String for the 'two' category (used in Arabic, Welsh, etc.)."
1192
+ },
1193
+ "few": {
1194
+ "$ref": "common_types.json#/$defs/DynamicString",
1195
+ "description": "String for the 'few' category (e.g., small groups in Slavic languages)."
1196
+ },
1197
+ "many": {
1198
+ "$ref": "common_types.json#/$defs/DynamicString",
1199
+ "description": "String for the 'many' category (e.g., large groups in various languages)."
1200
+ },
1201
+ "other": {
1202
+ "$ref": "common_types.json#/$defs/DynamicString",
1203
+ "description": "The default/fallback string (used for general plural cases)."
760
1204
  }
761
- }
1205
+ },
1206
+ "required": ["value", "other"],
1207
+ "unevaluatedProperties": false
762
1208
  },
763
- "placeholder": {
1209
+ "returnType": {
1210
+ "const": "string"
1211
+ }
1212
+ },
1213
+ "required": ["call", "args"],
1214
+ "unevaluatedProperties": false
1215
+ },
1216
+ "openUrl": {
1217
+ "type": "object",
1218
+ "description": "Opens the specified URL in a browser or handler. This function has no return value.",
1219
+ "properties": {
1220
+ "call": {
1221
+ "const": "openUrl"
1222
+ },
1223
+ "args": {
764
1224
  "type": "object",
765
- "description": "Placeholder text shown when no tags are entered. This can be a literal string or a reference to a value in the data model ('path', e.g. '/form/tagsPlaceholder').",
766
- "additionalProperties": false,
767
1225
  "properties": {
768
- "literalString": {
769
- "type": "string"
770
- },
771
- "path": {
772
- "type": "string"
1226
+ "url": {
1227
+ "type": "string",
1228
+ "format": "uri",
1229
+ "description": "The URL to open."
773
1230
  }
774
- }
1231
+ },
1232
+ "required": ["url"],
1233
+ "additionalProperties": false
775
1234
  },
776
- "disabled": {
1235
+ "returnType": {
1236
+ "const": "void"
1237
+ }
1238
+ },
1239
+ "required": ["call", "args"],
1240
+ "unevaluatedProperties": false
1241
+ },
1242
+ "and": {
1243
+ "type": "object",
1244
+ "description": "Performs a logical AND operation on a list of boolean values.",
1245
+ "properties": {
1246
+ "call": {
1247
+ "const": "and"
1248
+ },
1249
+ "args": {
777
1250
  "type": "object",
778
- "description": "Whether the tag input is disabled. This can be a literal boolean or a reference to a value in the data model ('path', e.g. '/form/tagsDisabled').",
779
- "additionalProperties": false,
780
1251
  "properties": {
781
- "literalBoolean": {
782
- "type": "boolean"
783
- },
784
- "path": {
785
- "type": "string"
1252
+ "values": {
1253
+ "type": "array",
1254
+ "description": "The list of boolean values to evaluate.",
1255
+ "items": {
1256
+ "$ref": "common_types.json#/$defs/DynamicBoolean"
1257
+ },
1258
+ "minItems": 2
786
1259
  }
787
- }
788
- },
789
- "disableTextInput": {
790
- "type": "boolean",
791
- "description": "If true, hides the text input and only displays the current tags."
1260
+ },
1261
+ "required": ["values"],
1262
+ "unevaluatedProperties": false
792
1263
  },
793
- "validationRegexp": {
794
- "type": "string",
795
- "description": "A regular expression used for client-side validation of each tag before it is added. For example, use '^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$' for email tags."
1264
+ "returnType": {
1265
+ "const": "boolean"
1266
+ }
1267
+ },
1268
+ "required": ["call", "args"],
1269
+ "unevaluatedProperties": false
1270
+ },
1271
+ "or": {
1272
+ "type": "object",
1273
+ "description": "Performs a logical OR operation on a list of boolean values.",
1274
+ "properties": {
1275
+ "call": {
1276
+ "const": "or"
796
1277
  },
797
- "validationErrorMessage": {
1278
+ "args": {
798
1279
  "type": "object",
799
- "description": "Error message shown below the field when a tag fails validationRegexp. This can be a literal string or a reference to a value in the data model ('path', e.g. '/form/emailError').",
800
- "additionalProperties": false,
801
1280
  "properties": {
802
- "literalString": {
803
- "type": "string"
804
- },
805
- "path": {
806
- "type": "string"
1281
+ "values": {
1282
+ "type": "array",
1283
+ "description": "The list of boolean values to evaluate.",
1284
+ "items": {
1285
+ "$ref": "common_types.json#/$defs/DynamicBoolean"
1286
+ },
1287
+ "minItems": 2
807
1288
  }
808
- }
1289
+ },
1290
+ "required": ["values"],
1291
+ "unevaluatedProperties": false
1292
+ },
1293
+ "returnType": {
1294
+ "const": "boolean"
809
1295
  }
810
1296
  },
811
- "required": ["values"]
1297
+ "required": ["call", "args"],
1298
+ "unevaluatedProperties": false
812
1299
  },
813
- "Timeout": {
1300
+ "not": {
814
1301
  "type": "object",
1302
+ "description": "Performs a logical NOT operation on a boolean value.",
815
1303
  "properties": {
816
- "targetTimeUtc": {
1304
+ "call": {
1305
+ "const": "not"
1306
+ },
1307
+ "args": {
817
1308
  "type": "object",
818
- "description": "The target time in UTC to count down to. Use an ISO 8601 string (e.g. '2025-02-11T15:30:00.000Z'). This can be a literal string ('literalString') or a reference to a value in the data model ('path', e.g. '/session/expiresAt'). The frontend computes and displays the remaining time until this moment.",
819
- "additionalProperties": false,
820
1309
  "properties": {
821
- "literalString": {
822
- "type": "string"
823
- },
824
- "path": {
825
- "type": "string"
1310
+ "value": {
1311
+ "$ref": "common_types.json#/$defs/DynamicBoolean",
1312
+ "description": "The boolean value to negate."
826
1313
  }
827
- }
1314
+ },
1315
+ "required": ["value"],
1316
+ "unevaluatedProperties": false
1317
+ },
1318
+ "returnType": {
1319
+ "const": "boolean"
828
1320
  }
829
1321
  },
830
- "required": ["targetTimeUtc"]
1322
+ "required": ["call", "args"],
1323
+ "unevaluatedProperties": false
831
1324
  }
832
1325
  },
833
- "styles": {
834
- "font": {
835
- "type": "string",
836
- "description": "The primary font for the UI."
837
- },
838
- "primaryColor": {
839
- "type": "string",
840
- "description": "The primary UI color as a hexadecimal code (e.g., '#00BFFF').",
841
- "pattern": "^#[0-9a-fA-F]{6}$"
1326
+ "$defs": {
1327
+ "CatalogComponentCommon": {
1328
+ "type": "object",
1329
+ "properties": {
1330
+ "weight": {
1331
+ "type": "number",
1332
+ "description": "The relative weight of this component within a Row or Column. This is similar to the CSS 'flex-grow' property. Note: this may ONLY be set when the component is a direct descendant of a Row or Column."
1333
+ }
1334
+ }
1335
+ },
1336
+ "theme": {
1337
+ "type": "object",
1338
+ "properties": {
1339
+ "primaryColor": {
1340
+ "type": "string",
1341
+ "description": "The primary brand color used for highlights (e.g., primary buttons, active borders). Renderers may generate variants of this color for different contexts. Format: Hexadecimal code (e.g., '#00BFFF').",
1342
+ "pattern": "^#[0-9a-fA-F]{6}$"
1343
+ },
1344
+ "iconUrl": {
1345
+ "type": "string",
1346
+ "format": "uri",
1347
+ "description": "A URL for an image that identifies the agent or tool associated with the surface."
1348
+ },
1349
+ "agentDisplayName": {
1350
+ "type": "string",
1351
+ "description": "Text to be displayed next to the surface to identify the agent or tool that created it."
1352
+ }
1353
+ },
1354
+ "additionalProperties": true
1355
+ },
1356
+ "anyComponent": {
1357
+ "oneOf": [
1358
+ {
1359
+ "$ref": "#/components/AudioPlayer"
1360
+ },
1361
+ {
1362
+ "$ref": "#/components/Button"
1363
+ },
1364
+ {
1365
+ "$ref": "#/components/Card"
1366
+ },
1367
+ {
1368
+ "$ref": "#/components/CheckBox"
1369
+ },
1370
+ {
1371
+ "$ref": "#/components/ChoicePicker"
1372
+ },
1373
+ {
1374
+ "$ref": "#/components/Column"
1375
+ },
1376
+ {
1377
+ "$ref": "#/components/DateTimeInput"
1378
+ },
1379
+ {
1380
+ "$ref": "#/components/Divider"
1381
+ },
1382
+ {
1383
+ "$ref": "#/components/Icon"
1384
+ },
1385
+ {
1386
+ "$ref": "#/components/Image"
1387
+ },
1388
+ {
1389
+ "$ref": "#/components/List"
1390
+ },
1391
+ {
1392
+ "$ref": "#/components/Modal"
1393
+ },
1394
+ {
1395
+ "$ref": "#/components/Row"
1396
+ },
1397
+ {
1398
+ "$ref": "#/components/Slider"
1399
+ },
1400
+ {
1401
+ "$ref": "#/components/Tabs"
1402
+ },
1403
+ {
1404
+ "$ref": "#/components/TagInput"
1405
+ },
1406
+ {
1407
+ "$ref": "#/components/Text"
1408
+ },
1409
+ {
1410
+ "$ref": "#/components/TextField"
1411
+ },
1412
+ {
1413
+ "$ref": "#/components/Timeout"
1414
+ },
1415
+ {
1416
+ "$ref": "#/components/Video"
1417
+ }
1418
+ ],
1419
+ "discriminator": {
1420
+ "propertyName": "component"
1421
+ }
1422
+ },
1423
+ "anyFunction": {
1424
+ "oneOf": [
1425
+ {
1426
+ "$ref": "#/functions/required"
1427
+ },
1428
+ {
1429
+ "$ref": "#/functions/regex"
1430
+ },
1431
+ {
1432
+ "$ref": "#/functions/length"
1433
+ },
1434
+ {
1435
+ "$ref": "#/functions/numeric"
1436
+ },
1437
+ {
1438
+ "$ref": "#/functions/email"
1439
+ },
1440
+ {
1441
+ "$ref": "#/functions/formatString"
1442
+ },
1443
+ {
1444
+ "$ref": "#/functions/formatNumber"
1445
+ },
1446
+ {
1447
+ "$ref": "#/functions/formatCurrency"
1448
+ },
1449
+ {
1450
+ "$ref": "#/functions/formatDate"
1451
+ },
1452
+ {
1453
+ "$ref": "#/functions/pluralize"
1454
+ },
1455
+ {
1456
+ "$ref": "#/functions/openUrl"
1457
+ },
1458
+ {
1459
+ "$ref": "#/functions/and"
1460
+ },
1461
+ {
1462
+ "$ref": "#/functions/or"
1463
+ },
1464
+ {
1465
+ "$ref": "#/functions/not"
1466
+ }
1467
+ ]
842
1468
  }
843
1469
  }
844
1470
  }