@cognitap/radiant 0.0.91 → 0.0.92
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.
- package/CHANGELOG.md +11 -0
- package/dist/library/a2ui/A2uiPlaceholder.d.ts +14 -0
- package/dist/library/a2ui/A2uiPlaceholder.d.ts.map +1 -0
- package/dist/library/a2ui/A2uiPlaceholder.js +44 -0
- package/dist/library/a2ui/A2uiPlaceholder.js.map +1 -0
- package/dist/library/a2ui/A2uiSurface.d.ts +33 -0
- package/dist/library/a2ui/A2uiSurface.d.ts.map +1 -0
- package/dist/library/a2ui/A2uiSurface.js +542 -0
- package/dist/library/a2ui/A2uiSurface.js.map +1 -0
- package/dist/library/a2ui/accessibility.d.ts +31 -0
- package/dist/library/a2ui/accessibility.d.ts.map +1 -0
- package/dist/library/a2ui/accessibility.js +108 -0
- package/dist/library/a2ui/accessibility.js.map +1 -0
- package/dist/library/a2ui/accessibilityRules.d.ts +28 -0
- package/dist/library/a2ui/accessibilityRules.d.ts.map +1 -0
- package/dist/library/a2ui/accessibilityRules.js +73 -0
- package/dist/library/a2ui/accessibilityRules.js.map +1 -0
- package/dist/library/a2ui/catalogGenerator.d.ts +29 -0
- package/dist/library/a2ui/catalogGenerator.d.ts.map +1 -0
- package/dist/library/a2ui/catalogGenerator.js +578 -0
- package/dist/library/a2ui/catalogGenerator.js.map +1 -0
- package/dist/library/a2ui/coerce.d.ts +16 -0
- package/dist/library/a2ui/coerce.d.ts.map +1 -0
- package/dist/library/a2ui/coerce.js +254 -0
- package/dist/library/a2ui/coerce.js.map +1 -0
- package/dist/library/a2ui/entries.d.ts +6 -0
- package/dist/library/a2ui/entries.d.ts.map +1 -0
- package/dist/library/a2ui/entries.js +277 -0
- package/dist/library/a2ui/entries.js.map +1 -0
- package/dist/library/a2ui/fixtures.d.ts +38 -0
- package/dist/library/a2ui/fixtures.d.ts.map +1 -0
- package/dist/library/a2ui/fixtures.js +389 -0
- package/dist/library/a2ui/fixtures.js.map +1 -0
- package/dist/library/a2ui/index.d.ts +17 -0
- package/dist/library/a2ui/index.d.ts.map +1 -0
- package/dist/library/a2ui/index.js +9 -0
- package/dist/library/a2ui/index.js.map +1 -0
- package/dist/library/a2ui/protocolErrors.d.ts +13 -0
- package/dist/library/a2ui/protocolErrors.d.ts.map +1 -0
- package/dist/library/a2ui/protocolErrors.js +48 -0
- package/dist/library/a2ui/protocolErrors.js.map +1 -0
- package/dist/library/a2ui/registry.d.ts +58 -0
- package/dist/library/a2ui/registry.d.ts.map +1 -0
- package/dist/library/a2ui/registry.js +128 -0
- package/dist/library/a2ui/registry.js.map +1 -0
- package/dist/library/a2ui/sanitize.d.ts +7 -0
- package/dist/library/a2ui/sanitize.d.ts.map +1 -0
- package/dist/library/a2ui/sanitize.js +54 -0
- package/dist/library/a2ui/sanitize.js.map +1 -0
- package/dist/library/a2ui/surfaceRuntime.d.ts +34 -0
- package/dist/library/a2ui/surfaceRuntime.d.ts.map +1 -0
- package/dist/library/a2ui/surfaceRuntime.js +284 -0
- package/dist/library/a2ui/surfaceRuntime.js.map +1 -0
- package/dist/library/catalog/actions.d.ts +40 -0
- package/dist/library/catalog/actions.d.ts.map +1 -0
- package/dist/library/catalog/actions.js +70 -0
- package/dist/library/catalog/actions.js.map +1 -0
- package/dist/library/catalog/coerce.d.ts +70 -0
- package/dist/library/catalog/coerce.d.ts.map +1 -0
- package/dist/library/catalog/coerce.js +332 -0
- package/dist/library/catalog/coerce.js.map +1 -0
- package/dist/library/catalog/index.d.ts +9 -0
- package/dist/library/catalog/index.d.ts.map +1 -0
- package/dist/library/catalog/index.js +6 -0
- package/dist/library/catalog/index.js.map +1 -0
- package/dist/library/catalog/radiantCatalog.d.ts +9 -0
- package/dist/library/catalog/radiantCatalog.d.ts.map +1 -0
- package/dist/library/catalog/radiantCatalog.js +902 -0
- package/dist/library/catalog/radiantCatalog.js.map +1 -0
- package/dist/library/catalog/types.d.ts +113 -0
- package/dist/library/catalog/types.d.ts.map +1 -0
- package/dist/library/catalog/types.js +27 -0
- package/dist/library/catalog/types.js.map +1 -0
- package/dist/library/catalog/validate.d.ts +31 -0
- package/dist/library/catalog/validate.d.ts.map +1 -0
- package/dist/library/catalog/validate.js +420 -0
- package/dist/library/catalog/validate.js.map +1 -0
- package/dist/library/components/Card/Card.d.ts +6 -2
- package/dist/library/components/Card/Card.d.ts.map +1 -1
- package/dist/library/components/Card/Card.js +12 -4
- package/dist/library/components/Card/Card.js.map +1 -1
- package/dist/library/components/Table/Table.d.ts +6 -2
- package/dist/library/components/Table/Table.d.ts.map +1 -1
- package/dist/library/components/Table/Table.js +10 -4
- package/dist/library/components/Table/Table.js.map +1 -1
- package/dist/library/index.d.ts +1 -1
- package/dist/library/index.d.ts.map +1 -1
- package/dist/library/presentation.d.ts +3 -0
- package/dist/library/presentation.d.ts.map +1 -1
- package/dist/library/styles.css +1 -1
- package/dist/library/themes/components.d.ts +6 -0
- package/dist/library/themes/components.d.ts.map +1 -1
- package/dist/library/themes/components.js +6 -0
- package/dist/library/themes/components.js.map +1 -1
- package/dist/library/themes/tokens.d.ts +4 -0
- package/dist/library/themes/tokens.d.ts.map +1 -1
- package/dist/library/themes/tokens.js +3 -0
- package/dist/library/themes/tokens.js.map +1 -1
- package/docs/accessibility.md +6 -0
- package/docs/architecture.md +13 -1
- package/docs/theming.md +13 -0
- package/package.json +17 -5
- package/src/a2ui/A2uiPlaceholder.tsx +64 -0
- package/src/a2ui/A2uiSurface.tsx +790 -0
- package/src/a2ui/accessibility.ts +145 -0
- package/src/a2ui/accessibilityRules.ts +106 -0
- package/src/a2ui/catalog.json +317 -0
- package/src/a2ui/catalogGenerator.ts +717 -0
- package/src/a2ui/coerce.ts +379 -0
- package/src/a2ui/entries.tsx +519 -0
- package/src/a2ui/fixtures.ts +402 -0
- package/src/a2ui/index.ts +50 -0
- package/src/a2ui/protocolErrors.ts +63 -0
- package/src/a2ui/registry.ts +221 -0
- package/src/a2ui/sanitize.ts +51 -0
- package/src/a2ui/surfaceRuntime.ts +317 -0
- package/src/catalog/actions.ts +108 -0
- package/src/catalog/coerce.ts +447 -0
- package/src/catalog/index.ts +67 -0
- package/src/catalog/radiantCatalog.ts +949 -0
- package/src/catalog/types.ts +159 -0
- package/src/catalog/validate.ts +454 -0
- package/src/components/Card/Card.tsx +35 -19
- package/src/components/Table/Table.tsx +16 -3
- package/src/index.ts +1 -1
- package/src/presentation.ts +3 -0
- package/src/themes/baseline.css +3 -0
- package/src/themes/components.ts +6 -0
- package/src/themes/tokens.ts +7 -0
|
@@ -0,0 +1,949 @@
|
|
|
1
|
+
import {
|
|
2
|
+
CATALOG_ALIGNMENTS,
|
|
3
|
+
CATALOG_ANNOUNCEMENTS,
|
|
4
|
+
CATALOG_CONTROL_SIZES,
|
|
5
|
+
CATALOG_JUSTIFY,
|
|
6
|
+
CATALOG_ORIENTATIONS,
|
|
7
|
+
CATALOG_SPACING,
|
|
8
|
+
CATALOG_TONES,
|
|
9
|
+
CATALOG_VARIANTS,
|
|
10
|
+
CHOICE_PRESENTATIONS,
|
|
11
|
+
type Catalog,
|
|
12
|
+
type CatalogJsonSchema
|
|
13
|
+
} from './types.js'
|
|
14
|
+
import { defineCatalog } from './validate.js'
|
|
15
|
+
|
|
16
|
+
const spacingSchema: CatalogJsonSchema = {
|
|
17
|
+
type: 'string',
|
|
18
|
+
enum: CATALOG_SPACING,
|
|
19
|
+
default: 'normal',
|
|
20
|
+
description: 'Semantic spacing scale owned by Radiant.'
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
const toneSchema = (defaultTone: (typeof CATALOG_TONES)[number]): CatalogJsonSchema => ({
|
|
24
|
+
type: 'string',
|
|
25
|
+
enum: CATALOG_TONES,
|
|
26
|
+
default: defaultTone,
|
|
27
|
+
description: 'Semantic palette intent.'
|
|
28
|
+
})
|
|
29
|
+
|
|
30
|
+
const controlSizeSchema: CatalogJsonSchema = {
|
|
31
|
+
type: 'string',
|
|
32
|
+
enum: CATALOG_CONTROL_SIZES,
|
|
33
|
+
default: 'medium',
|
|
34
|
+
description: 'Shared interactive control size.'
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
const childWeightSchema: CatalogJsonSchema = {
|
|
38
|
+
type: 'number',
|
|
39
|
+
exclusiveMinimum: 0,
|
|
40
|
+
description: 'Relative flex growth weight along the parent main axis.'
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
const choiceOptionSchema: CatalogJsonSchema = {
|
|
44
|
+
type: 'object',
|
|
45
|
+
additionalProperties: false,
|
|
46
|
+
required: ['value', 'label'],
|
|
47
|
+
properties: {
|
|
48
|
+
value: { type: 'string', minLength: 1, description: 'Stable option value.' },
|
|
49
|
+
label: { type: 'string', minLength: 1, description: 'Visible option label.' },
|
|
50
|
+
description: { type: 'string', description: 'Optional supporting detail for the option.' },
|
|
51
|
+
disabled: { type: 'boolean', default: false, description: 'Prevents selecting this option.' }
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
export const RADIANT_CATALOG_ID = 'radiant/canonical'
|
|
56
|
+
export const RADIANT_CATALOG_VERSION = '1.0.0'
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* Radiant's canonical, protocol-independent model-facing catalog.
|
|
60
|
+
* Protocol adapters translate these intent-oriented entries rather than defining their own.
|
|
61
|
+
*/
|
|
62
|
+
export const radiantCatalog: Catalog = defineCatalog({
|
|
63
|
+
id: RADIANT_CATALOG_ID,
|
|
64
|
+
version: RADIANT_CATALOG_VERSION,
|
|
65
|
+
description:
|
|
66
|
+
'Canonical model-facing contract for Radiant UI surfaces. Independent of wire protocol and host implementation.',
|
|
67
|
+
entries: {
|
|
68
|
+
Text: {
|
|
69
|
+
name: 'Text',
|
|
70
|
+
category: 'content',
|
|
71
|
+
description: 'Displays formatted text with semantic typographic hierarchy.',
|
|
72
|
+
propsSchema: {
|
|
73
|
+
type: 'object',
|
|
74
|
+
additionalProperties: false,
|
|
75
|
+
required: ['text'],
|
|
76
|
+
properties: {
|
|
77
|
+
text: { type: 'string', description: 'Text content to display.' },
|
|
78
|
+
variant: {
|
|
79
|
+
type: 'string',
|
|
80
|
+
enum: ['h1', 'h2', 'h3', 'h4', 'h5', 'body', 'caption', 'code'],
|
|
81
|
+
default: 'body',
|
|
82
|
+
description: 'Semantic typographic hierarchy.'
|
|
83
|
+
},
|
|
84
|
+
tone: toneSchema('neutral')
|
|
85
|
+
}
|
|
86
|
+
},
|
|
87
|
+
slots: {},
|
|
88
|
+
bindings: {
|
|
89
|
+
text: {
|
|
90
|
+
description: 'Optional dynamic text value read from surface state.',
|
|
91
|
+
valueType: 'string',
|
|
92
|
+
direction: 'read'
|
|
93
|
+
}
|
|
94
|
+
},
|
|
95
|
+
actions: {}
|
|
96
|
+
},
|
|
97
|
+
|
|
98
|
+
Icon: {
|
|
99
|
+
name: 'Icon',
|
|
100
|
+
category: 'media',
|
|
101
|
+
description: 'Displays a named vector icon from the host icon registry.',
|
|
102
|
+
propsSchema: {
|
|
103
|
+
type: 'object',
|
|
104
|
+
additionalProperties: false,
|
|
105
|
+
required: ['name'],
|
|
106
|
+
properties: {
|
|
107
|
+
name: { type: 'string', minLength: 1, description: 'Registered icon identifier.' },
|
|
108
|
+
label: {
|
|
109
|
+
type: 'string',
|
|
110
|
+
description:
|
|
111
|
+
'Accessible name when the icon conveys standalone meaning. Omit for decorative icons.'
|
|
112
|
+
},
|
|
113
|
+
tone: toneSchema('neutral'),
|
|
114
|
+
controlSize: controlSizeSchema
|
|
115
|
+
}
|
|
116
|
+
},
|
|
117
|
+
slots: {},
|
|
118
|
+
bindings: {},
|
|
119
|
+
actions: {}
|
|
120
|
+
},
|
|
121
|
+
|
|
122
|
+
Image: {
|
|
123
|
+
name: 'Image',
|
|
124
|
+
category: 'media',
|
|
125
|
+
description: 'Displays an image with explicit alternative text and aspect behavior.',
|
|
126
|
+
propsSchema: {
|
|
127
|
+
type: 'object',
|
|
128
|
+
additionalProperties: false,
|
|
129
|
+
required: ['url', 'alt'],
|
|
130
|
+
properties: {
|
|
131
|
+
url: { type: 'string', format: 'uri', description: 'Image source URL.' },
|
|
132
|
+
alt: {
|
|
133
|
+
type: 'string',
|
|
134
|
+
description: 'Alternative text describing the image, or empty string if decorative.'
|
|
135
|
+
},
|
|
136
|
+
fit: {
|
|
137
|
+
type: 'string',
|
|
138
|
+
enum: ['contain', 'cover', 'fill', 'none', 'scale-down'],
|
|
139
|
+
default: 'cover',
|
|
140
|
+
description: 'How the image fits inside its frame.'
|
|
141
|
+
},
|
|
142
|
+
usage: {
|
|
143
|
+
type: 'string',
|
|
144
|
+
enum: ['icon', 'avatar', 'smallFeature', 'mediumFeature', 'largeFeature', 'header'],
|
|
145
|
+
default: 'mediumFeature',
|
|
146
|
+
description: 'Semantic presentation size hint.'
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
},
|
|
150
|
+
slots: {},
|
|
151
|
+
bindings: {
|
|
152
|
+
url: {
|
|
153
|
+
description: 'Optional reactive image URL from surface state.',
|
|
154
|
+
valueType: 'string',
|
|
155
|
+
direction: 'read'
|
|
156
|
+
}
|
|
157
|
+
},
|
|
158
|
+
actions: {}
|
|
159
|
+
},
|
|
160
|
+
|
|
161
|
+
Video: {
|
|
162
|
+
name: 'Video',
|
|
163
|
+
category: 'media',
|
|
164
|
+
description: 'Plays a video clip with native browser controls.',
|
|
165
|
+
propsSchema: {
|
|
166
|
+
type: 'object',
|
|
167
|
+
additionalProperties: false,
|
|
168
|
+
required: ['url', 'title'],
|
|
169
|
+
properties: {
|
|
170
|
+
url: { type: 'string', format: 'uri', description: 'Video media source URL.' },
|
|
171
|
+
title: { type: 'string', minLength: 1, description: 'Accessible title for the video.' },
|
|
172
|
+
poster: { type: 'string', format: 'uri', description: 'Optional poster frame image URL.' }
|
|
173
|
+
}
|
|
174
|
+
},
|
|
175
|
+
slots: {},
|
|
176
|
+
bindings: {
|
|
177
|
+
url: {
|
|
178
|
+
description: 'Optional reactive video URL from surface state.',
|
|
179
|
+
valueType: 'string',
|
|
180
|
+
direction: 'read'
|
|
181
|
+
}
|
|
182
|
+
},
|
|
183
|
+
actions: {}
|
|
184
|
+
},
|
|
185
|
+
|
|
186
|
+
AudioPlayer: {
|
|
187
|
+
name: 'AudioPlayer',
|
|
188
|
+
category: 'media',
|
|
189
|
+
description: 'Plays an audio track with native browser controls.',
|
|
190
|
+
propsSchema: {
|
|
191
|
+
type: 'object',
|
|
192
|
+
additionalProperties: false,
|
|
193
|
+
required: ['url', 'title'],
|
|
194
|
+
properties: {
|
|
195
|
+
url: { type: 'string', format: 'uri', description: 'Audio media source URL.' },
|
|
196
|
+
title: {
|
|
197
|
+
type: 'string',
|
|
198
|
+
minLength: 1,
|
|
199
|
+
description: 'Visible and accessible title for the audio track.'
|
|
200
|
+
},
|
|
201
|
+
description: { type: 'string', description: 'Optional description of the audio.' }
|
|
202
|
+
}
|
|
203
|
+
},
|
|
204
|
+
slots: {},
|
|
205
|
+
bindings: {
|
|
206
|
+
url: {
|
|
207
|
+
description: 'Optional reactive audio URL from surface state.',
|
|
208
|
+
valueType: 'string',
|
|
209
|
+
direction: 'read'
|
|
210
|
+
}
|
|
211
|
+
},
|
|
212
|
+
actions: {}
|
|
213
|
+
},
|
|
214
|
+
|
|
215
|
+
Row: {
|
|
216
|
+
name: 'Row',
|
|
217
|
+
category: 'layout',
|
|
218
|
+
description: 'Arranges child elements horizontally with semantic spacing and alignment.',
|
|
219
|
+
propsSchema: {
|
|
220
|
+
type: 'object',
|
|
221
|
+
additionalProperties: false,
|
|
222
|
+
properties: {
|
|
223
|
+
gap: spacingSchema,
|
|
224
|
+
justify: {
|
|
225
|
+
type: 'string',
|
|
226
|
+
enum: CATALOG_JUSTIFY,
|
|
227
|
+
default: 'start',
|
|
228
|
+
description: 'Main-axis distribution of children.'
|
|
229
|
+
},
|
|
230
|
+
align: {
|
|
231
|
+
type: 'string',
|
|
232
|
+
enum: CATALOG_ALIGNMENTS,
|
|
233
|
+
default: 'stretch',
|
|
234
|
+
description: 'Cross-axis alignment of children.'
|
|
235
|
+
},
|
|
236
|
+
wrap: {
|
|
237
|
+
type: 'boolean',
|
|
238
|
+
default: false,
|
|
239
|
+
description: 'Allows children to wrap onto multiple lines when space is narrow.'
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
},
|
|
243
|
+
slots: {
|
|
244
|
+
children: {
|
|
245
|
+
description: 'Ordered horizontal children.',
|
|
246
|
+
cardinality: 'many',
|
|
247
|
+
required: true,
|
|
248
|
+
templated: true,
|
|
249
|
+
childProps: {
|
|
250
|
+
weight: childWeightSchema
|
|
251
|
+
}
|
|
252
|
+
}
|
|
253
|
+
},
|
|
254
|
+
bindings: {},
|
|
255
|
+
actions: {}
|
|
256
|
+
},
|
|
257
|
+
|
|
258
|
+
Column: {
|
|
259
|
+
name: 'Column',
|
|
260
|
+
category: 'layout',
|
|
261
|
+
description: 'Arranges child elements vertically with semantic spacing and alignment.',
|
|
262
|
+
propsSchema: {
|
|
263
|
+
type: 'object',
|
|
264
|
+
additionalProperties: false,
|
|
265
|
+
properties: {
|
|
266
|
+
gap: spacingSchema,
|
|
267
|
+
justify: {
|
|
268
|
+
type: 'string',
|
|
269
|
+
enum: CATALOG_JUSTIFY,
|
|
270
|
+
default: 'start',
|
|
271
|
+
description: 'Main-axis distribution of children.'
|
|
272
|
+
},
|
|
273
|
+
align: {
|
|
274
|
+
type: 'string',
|
|
275
|
+
enum: CATALOG_ALIGNMENTS,
|
|
276
|
+
default: 'stretch',
|
|
277
|
+
description: 'Cross-axis alignment of children.'
|
|
278
|
+
}
|
|
279
|
+
}
|
|
280
|
+
},
|
|
281
|
+
slots: {
|
|
282
|
+
children: {
|
|
283
|
+
description: 'Ordered vertical children.',
|
|
284
|
+
cardinality: 'many',
|
|
285
|
+
required: true,
|
|
286
|
+
templated: true,
|
|
287
|
+
childProps: {
|
|
288
|
+
weight: childWeightSchema
|
|
289
|
+
}
|
|
290
|
+
}
|
|
291
|
+
},
|
|
292
|
+
bindings: {},
|
|
293
|
+
actions: {}
|
|
294
|
+
},
|
|
295
|
+
|
|
296
|
+
List: {
|
|
297
|
+
name: 'List',
|
|
298
|
+
category: 'layout',
|
|
299
|
+
description: 'Renders a static or data-templated sequence of repeated items.',
|
|
300
|
+
propsSchema: {
|
|
301
|
+
type: 'object',
|
|
302
|
+
additionalProperties: false,
|
|
303
|
+
properties: {
|
|
304
|
+
direction: {
|
|
305
|
+
type: 'string',
|
|
306
|
+
enum: CATALOG_ORIENTATIONS,
|
|
307
|
+
default: 'vertical',
|
|
308
|
+
description: 'Primary flow direction of list items.'
|
|
309
|
+
},
|
|
310
|
+
gap: spacingSchema,
|
|
311
|
+
align: {
|
|
312
|
+
type: 'string',
|
|
313
|
+
enum: CATALOG_ALIGNMENTS,
|
|
314
|
+
default: 'stretch',
|
|
315
|
+
description: 'Cross-axis alignment of list items.'
|
|
316
|
+
}
|
|
317
|
+
}
|
|
318
|
+
},
|
|
319
|
+
slots: {
|
|
320
|
+
children: {
|
|
321
|
+
description: 'Static item list or templated item prototype bound to collection data.',
|
|
322
|
+
cardinality: 'many',
|
|
323
|
+
required: true,
|
|
324
|
+
templated: true
|
|
325
|
+
}
|
|
326
|
+
},
|
|
327
|
+
bindings: {},
|
|
328
|
+
actions: {}
|
|
329
|
+
},
|
|
330
|
+
|
|
331
|
+
Card: {
|
|
332
|
+
name: 'Card',
|
|
333
|
+
category: 'layout',
|
|
334
|
+
description: 'Groups related content and actions inside a bounded surface container.',
|
|
335
|
+
propsSchema: {
|
|
336
|
+
type: 'object',
|
|
337
|
+
additionalProperties: false,
|
|
338
|
+
properties: {
|
|
339
|
+
title: { type: 'string', description: 'Optional card heading.' },
|
|
340
|
+
description: { type: 'string', description: 'Optional supporting summary.' },
|
|
341
|
+
padding: spacingSchema
|
|
342
|
+
}
|
|
343
|
+
},
|
|
344
|
+
slots: {
|
|
345
|
+
child: {
|
|
346
|
+
description: 'Primary body content inside the card.',
|
|
347
|
+
cardinality: 'single',
|
|
348
|
+
required: true
|
|
349
|
+
},
|
|
350
|
+
footer: {
|
|
351
|
+
description: 'Optional trailing actions or metadata.',
|
|
352
|
+
cardinality: 'single'
|
|
353
|
+
}
|
|
354
|
+
},
|
|
355
|
+
bindings: {},
|
|
356
|
+
actions: {}
|
|
357
|
+
},
|
|
358
|
+
|
|
359
|
+
Divider: {
|
|
360
|
+
name: 'Divider',
|
|
361
|
+
category: 'layout',
|
|
362
|
+
description: 'Separates adjacent sections visually and semantically.',
|
|
363
|
+
propsSchema: {
|
|
364
|
+
type: 'object',
|
|
365
|
+
additionalProperties: false,
|
|
366
|
+
properties: {
|
|
367
|
+
orientation: {
|
|
368
|
+
type: 'string',
|
|
369
|
+
enum: CATALOG_ORIENTATIONS,
|
|
370
|
+
default: 'horizontal',
|
|
371
|
+
description: 'Axis along which the divider runs.'
|
|
372
|
+
}
|
|
373
|
+
}
|
|
374
|
+
},
|
|
375
|
+
slots: {},
|
|
376
|
+
bindings: {},
|
|
377
|
+
actions: {}
|
|
378
|
+
},
|
|
379
|
+
|
|
380
|
+
Tabs: {
|
|
381
|
+
name: 'Tabs',
|
|
382
|
+
category: 'layout',
|
|
383
|
+
description: 'Switches between peer content views in place without leaving the surface.',
|
|
384
|
+
propsSchema: {
|
|
385
|
+
type: 'object',
|
|
386
|
+
additionalProperties: false,
|
|
387
|
+
required: ['tabs'],
|
|
388
|
+
properties: {
|
|
389
|
+
label: { type: 'string', description: 'Accessible label for the tab list.' },
|
|
390
|
+
tabs: {
|
|
391
|
+
type: 'array',
|
|
392
|
+
minItems: 1,
|
|
393
|
+
description: 'Ordered tab definitions paired with panel slots.',
|
|
394
|
+
items: {
|
|
395
|
+
type: 'object',
|
|
396
|
+
additionalProperties: false,
|
|
397
|
+
required: ['value', 'title'],
|
|
398
|
+
properties: {
|
|
399
|
+
value: { type: 'string', minLength: 1, description: 'Stable tab identifier.' },
|
|
400
|
+
title: { type: 'string', minLength: 1, description: 'Visible tab label.' }
|
|
401
|
+
}
|
|
402
|
+
}
|
|
403
|
+
}
|
|
404
|
+
}
|
|
405
|
+
},
|
|
406
|
+
slots: {
|
|
407
|
+
panels: {
|
|
408
|
+
description: 'Content node rendered for each tab entry.',
|
|
409
|
+
cardinality: 'many',
|
|
410
|
+
required: true
|
|
411
|
+
}
|
|
412
|
+
},
|
|
413
|
+
bindings: {
|
|
414
|
+
value: {
|
|
415
|
+
description: 'Currently active tab value stored in local surface state.',
|
|
416
|
+
valueType: 'string',
|
|
417
|
+
direction: 'two-way'
|
|
418
|
+
}
|
|
419
|
+
},
|
|
420
|
+
actions: {}
|
|
421
|
+
},
|
|
422
|
+
|
|
423
|
+
Modal: {
|
|
424
|
+
name: 'Modal',
|
|
425
|
+
category: 'layout',
|
|
426
|
+
description: 'Presents focused secondary content in a native modal dialog.',
|
|
427
|
+
propsSchema: {
|
|
428
|
+
type: 'object',
|
|
429
|
+
additionalProperties: false,
|
|
430
|
+
required: ['title'],
|
|
431
|
+
properties: {
|
|
432
|
+
title: { type: 'string', minLength: 1, description: 'Dialog heading.' },
|
|
433
|
+
description: { type: 'string', description: 'Optional supporting dialog explanation.' }
|
|
434
|
+
}
|
|
435
|
+
},
|
|
436
|
+
slots: {
|
|
437
|
+
trigger: {
|
|
438
|
+
description: 'Interactive trigger element that opens the dialog.',
|
|
439
|
+
cardinality: 'single',
|
|
440
|
+
required: true,
|
|
441
|
+
allowedCategories: ['action']
|
|
442
|
+
},
|
|
443
|
+
content: {
|
|
444
|
+
description: 'Body content rendered inside the modal dialog.',
|
|
445
|
+
cardinality: 'single',
|
|
446
|
+
required: true
|
|
447
|
+
}
|
|
448
|
+
},
|
|
449
|
+
bindings: {
|
|
450
|
+
open: {
|
|
451
|
+
description: 'Open state of the modal dialog in local surface state.',
|
|
452
|
+
valueType: 'boolean',
|
|
453
|
+
direction: 'two-way'
|
|
454
|
+
}
|
|
455
|
+
},
|
|
456
|
+
actions: {}
|
|
457
|
+
},
|
|
458
|
+
|
|
459
|
+
Button: {
|
|
460
|
+
name: 'Button',
|
|
461
|
+
category: 'action',
|
|
462
|
+
description: 'Triggers a client-local update or emits a named outbound action.',
|
|
463
|
+
propsSchema: {
|
|
464
|
+
type: 'object',
|
|
465
|
+
additionalProperties: false,
|
|
466
|
+
properties: {
|
|
467
|
+
label: {
|
|
468
|
+
type: 'string',
|
|
469
|
+
description: 'Visible button label when no child content slot is supplied.'
|
|
470
|
+
},
|
|
471
|
+
variant: {
|
|
472
|
+
type: 'string',
|
|
473
|
+
enum: CATALOG_VARIANTS,
|
|
474
|
+
default: 'solid',
|
|
475
|
+
description: 'Visual treatment of the button.'
|
|
476
|
+
},
|
|
477
|
+
tone: toneSchema('accent'),
|
|
478
|
+
controlSize: controlSizeSchema,
|
|
479
|
+
disabled: { type: 'boolean', default: false, description: 'Disables activation.' },
|
|
480
|
+
pending: {
|
|
481
|
+
type: 'boolean',
|
|
482
|
+
default: false,
|
|
483
|
+
description: 'Indicates an in-flight action while preserving focus.'
|
|
484
|
+
}
|
|
485
|
+
}
|
|
486
|
+
},
|
|
487
|
+
slots: {
|
|
488
|
+
child: {
|
|
489
|
+
description: 'Optional rich content inside the button.',
|
|
490
|
+
cardinality: 'single'
|
|
491
|
+
}
|
|
492
|
+
},
|
|
493
|
+
bindings: {},
|
|
494
|
+
actions: {
|
|
495
|
+
action: {
|
|
496
|
+
description: 'Action dispatched when the user activates the button.',
|
|
497
|
+
scope: 'outbound'
|
|
498
|
+
}
|
|
499
|
+
}
|
|
500
|
+
},
|
|
501
|
+
|
|
502
|
+
TextField: {
|
|
503
|
+
name: 'TextField',
|
|
504
|
+
category: 'input',
|
|
505
|
+
description:
|
|
506
|
+
'Collects single-line or multi-line text input with label, description, and validation.',
|
|
507
|
+
propsSchema: {
|
|
508
|
+
type: 'object',
|
|
509
|
+
additionalProperties: false,
|
|
510
|
+
required: ['label'],
|
|
511
|
+
properties: {
|
|
512
|
+
label: { type: 'string', minLength: 1, description: 'Visible field label.' },
|
|
513
|
+
description: { type: 'string', description: 'Optional helper text.' },
|
|
514
|
+
placeholder: { type: 'string', description: 'Example value shown when empty.' },
|
|
515
|
+
kind: {
|
|
516
|
+
type: 'string',
|
|
517
|
+
enum: ['short', 'long', 'number', 'email', 'password', 'url'],
|
|
518
|
+
default: 'short',
|
|
519
|
+
description: 'Input intent controlling native input type or multiline textarea.'
|
|
520
|
+
},
|
|
521
|
+
rows: {
|
|
522
|
+
type: 'integer',
|
|
523
|
+
minimum: 2,
|
|
524
|
+
maximum: 20,
|
|
525
|
+
description: 'Visible row count when kind is "long".'
|
|
526
|
+
},
|
|
527
|
+
required: { type: 'boolean', default: false, description: 'Marks the field required.' },
|
|
528
|
+
disabled: { type: 'boolean', default: false, description: 'Disables editing.' },
|
|
529
|
+
controlSize: controlSizeSchema
|
|
530
|
+
}
|
|
531
|
+
},
|
|
532
|
+
slots: {},
|
|
533
|
+
bindings: {
|
|
534
|
+
value: {
|
|
535
|
+
description: 'Current text value bound to surface state.',
|
|
536
|
+
valueType: 'string',
|
|
537
|
+
direction: 'two-way',
|
|
538
|
+
validatable: true
|
|
539
|
+
}
|
|
540
|
+
},
|
|
541
|
+
actions: {}
|
|
542
|
+
},
|
|
543
|
+
|
|
544
|
+
Checkbox: {
|
|
545
|
+
name: 'Checkbox',
|
|
546
|
+
category: 'input',
|
|
547
|
+
description: 'Collects an explicit boolean consent or selection state.',
|
|
548
|
+
propsSchema: {
|
|
549
|
+
type: 'object',
|
|
550
|
+
additionalProperties: false,
|
|
551
|
+
required: ['label'],
|
|
552
|
+
properties: {
|
|
553
|
+
label: { type: 'string', minLength: 1, description: 'Visible checkbox label.' },
|
|
554
|
+
description: { type: 'string', description: 'Optional supporting helper text.' },
|
|
555
|
+
required: { type: 'boolean', default: false, description: 'Requires checked state.' },
|
|
556
|
+
disabled: { type: 'boolean', default: false, description: 'Disables toggling.' }
|
|
557
|
+
}
|
|
558
|
+
},
|
|
559
|
+
slots: {},
|
|
560
|
+
bindings: {
|
|
561
|
+
checked: {
|
|
562
|
+
description: 'Checked state bound to surface state.',
|
|
563
|
+
valueType: 'boolean',
|
|
564
|
+
direction: 'two-way',
|
|
565
|
+
validatable: true
|
|
566
|
+
}
|
|
567
|
+
},
|
|
568
|
+
actions: {}
|
|
569
|
+
},
|
|
570
|
+
|
|
571
|
+
Choice: {
|
|
572
|
+
name: 'Choice',
|
|
573
|
+
category: 'input',
|
|
574
|
+
description:
|
|
575
|
+
'Selects one or multiple values from curated options using an intent-based presentation.',
|
|
576
|
+
propsSchema: {
|
|
577
|
+
type: 'object',
|
|
578
|
+
additionalProperties: false,
|
|
579
|
+
required: ['label', 'options'],
|
|
580
|
+
properties: {
|
|
581
|
+
label: { type: 'string', minLength: 1, description: 'Visible field or group label.' },
|
|
582
|
+
description: { type: 'string', description: 'Optional helper text.' },
|
|
583
|
+
options: {
|
|
584
|
+
type: 'array',
|
|
585
|
+
minItems: 1,
|
|
586
|
+
description: 'Selectable choices presented to the user.',
|
|
587
|
+
items: choiceOptionSchema
|
|
588
|
+
},
|
|
589
|
+
selection: {
|
|
590
|
+
type: 'string',
|
|
591
|
+
enum: ['single', 'multiple'],
|
|
592
|
+
default: 'single',
|
|
593
|
+
description: 'Whether one or multiple options can be selected.'
|
|
594
|
+
},
|
|
595
|
+
presentation: {
|
|
596
|
+
type: 'string',
|
|
597
|
+
enum: CHOICE_PRESENTATIONS,
|
|
598
|
+
default: 'dropdown',
|
|
599
|
+
description: 'Visual presentation intent for the choice control.'
|
|
600
|
+
},
|
|
601
|
+
searchable: {
|
|
602
|
+
type: 'boolean',
|
|
603
|
+
default: false,
|
|
604
|
+
description: 'Enables filtering options by typing when presented as a dropdown.'
|
|
605
|
+
},
|
|
606
|
+
placeholder: { type: 'string', description: 'Placeholder shown when nothing is chosen.' },
|
|
607
|
+
required: { type: 'boolean', default: false, description: 'Requires a selection.' },
|
|
608
|
+
disabled: { type: 'boolean', default: false, description: 'Disables selection.' },
|
|
609
|
+
controlSize: controlSizeSchema
|
|
610
|
+
}
|
|
611
|
+
},
|
|
612
|
+
slots: {},
|
|
613
|
+
bindings: {
|
|
614
|
+
value: {
|
|
615
|
+
description: 'Selected option value or values bound to surface state.',
|
|
616
|
+
valueType: 'string[]',
|
|
617
|
+
direction: 'two-way',
|
|
618
|
+
validatable: true
|
|
619
|
+
}
|
|
620
|
+
},
|
|
621
|
+
actions: {}
|
|
622
|
+
},
|
|
623
|
+
|
|
624
|
+
Slider: {
|
|
625
|
+
name: 'Slider',
|
|
626
|
+
category: 'input',
|
|
627
|
+
description: 'Selects a numeric value within a bounded range.',
|
|
628
|
+
propsSchema: {
|
|
629
|
+
type: 'object',
|
|
630
|
+
additionalProperties: false,
|
|
631
|
+
required: ['label', 'min', 'max'],
|
|
632
|
+
properties: {
|
|
633
|
+
label: { type: 'string', minLength: 1, description: 'Visible slider label.' },
|
|
634
|
+
description: { type: 'string', description: 'Optional helper text.' },
|
|
635
|
+
min: { type: 'number', description: 'Minimum allowed value.' },
|
|
636
|
+
max: { type: 'number', description: 'Maximum allowed value.' },
|
|
637
|
+
step: { type: 'number', exclusiveMinimum: 0, default: 1, description: 'Step increment.' },
|
|
638
|
+
disabled: { type: 'boolean', default: false, description: 'Disables scrubbing.' }
|
|
639
|
+
}
|
|
640
|
+
},
|
|
641
|
+
slots: {},
|
|
642
|
+
bindings: {
|
|
643
|
+
value: {
|
|
644
|
+
description: 'Current numeric value bound to surface state.',
|
|
645
|
+
valueType: 'number',
|
|
646
|
+
direction: 'two-way',
|
|
647
|
+
validatable: true
|
|
648
|
+
}
|
|
649
|
+
},
|
|
650
|
+
actions: {}
|
|
651
|
+
},
|
|
652
|
+
|
|
653
|
+
DateTimeInput: {
|
|
654
|
+
name: 'DateTimeInput',
|
|
655
|
+
category: 'input',
|
|
656
|
+
description: 'Collects a calendar date, wall-clock time, or combined date and time.',
|
|
657
|
+
propsSchema: {
|
|
658
|
+
type: 'object',
|
|
659
|
+
additionalProperties: false,
|
|
660
|
+
required: ['label'],
|
|
661
|
+
properties: {
|
|
662
|
+
label: { type: 'string', minLength: 1, description: 'Visible field label.' },
|
|
663
|
+
description: { type: 'string', description: 'Optional helper text.' },
|
|
664
|
+
enableDate: { type: 'boolean', default: true, description: 'Includes a date component.' },
|
|
665
|
+
enableTime: {
|
|
666
|
+
type: 'boolean',
|
|
667
|
+
default: false,
|
|
668
|
+
description: 'Includes a time component.'
|
|
669
|
+
},
|
|
670
|
+
min: { type: 'string', description: 'Optional ISO minimum bound.' },
|
|
671
|
+
max: { type: 'string', description: 'Optional ISO maximum bound.' },
|
|
672
|
+
required: { type: 'boolean', default: false, description: 'Marks the field required.' },
|
|
673
|
+
disabled: { type: 'boolean', default: false, description: 'Disables editing.' },
|
|
674
|
+
controlSize: controlSizeSchema
|
|
675
|
+
}
|
|
676
|
+
},
|
|
677
|
+
slots: {},
|
|
678
|
+
bindings: {
|
|
679
|
+
value: {
|
|
680
|
+
description: 'ISO 8601 date or date-time string bound to surface state.',
|
|
681
|
+
valueType: 'string',
|
|
682
|
+
direction: 'two-way',
|
|
683
|
+
validatable: true
|
|
684
|
+
}
|
|
685
|
+
},
|
|
686
|
+
actions: {}
|
|
687
|
+
},
|
|
688
|
+
|
|
689
|
+
Switch: {
|
|
690
|
+
name: 'Switch',
|
|
691
|
+
category: 'input',
|
|
692
|
+
description: 'Toggles an immediate on or off setting.',
|
|
693
|
+
propsSchema: {
|
|
694
|
+
type: 'object',
|
|
695
|
+
additionalProperties: false,
|
|
696
|
+
required: ['label'],
|
|
697
|
+
properties: {
|
|
698
|
+
label: { type: 'string', minLength: 1, description: 'Visible setting label.' },
|
|
699
|
+
description: { type: 'string', description: 'Optional explanation of the setting.' },
|
|
700
|
+
disabled: { type: 'boolean', default: false, description: 'Disables toggling.' }
|
|
701
|
+
}
|
|
702
|
+
},
|
|
703
|
+
slots: {},
|
|
704
|
+
bindings: {
|
|
705
|
+
checked: {
|
|
706
|
+
description: 'Current on/off state bound to surface state.',
|
|
707
|
+
valueType: 'boolean',
|
|
708
|
+
direction: 'two-way',
|
|
709
|
+
validatable: true
|
|
710
|
+
}
|
|
711
|
+
},
|
|
712
|
+
actions: {}
|
|
713
|
+
},
|
|
714
|
+
|
|
715
|
+
Alert: {
|
|
716
|
+
name: 'Alert',
|
|
717
|
+
category: 'feedback',
|
|
718
|
+
description: 'Displays inline status or contextual feedback with optional live announcement.',
|
|
719
|
+
propsSchema: {
|
|
720
|
+
type: 'object',
|
|
721
|
+
additionalProperties: false,
|
|
722
|
+
required: ['title'],
|
|
723
|
+
properties: {
|
|
724
|
+
title: { type: 'string', minLength: 1, description: 'Primary alert heading.' },
|
|
725
|
+
description: { type: 'string', description: 'Optional supporting detail.' },
|
|
726
|
+
tone: toneSchema('neutral'),
|
|
727
|
+
announce: {
|
|
728
|
+
type: 'string',
|
|
729
|
+
enum: CATALOG_ANNOUNCEMENTS,
|
|
730
|
+
default: 'off',
|
|
731
|
+
description: 'Live-region urgency independent of visual tone.'
|
|
732
|
+
}
|
|
733
|
+
}
|
|
734
|
+
},
|
|
735
|
+
slots: {
|
|
736
|
+
actions: {
|
|
737
|
+
description: 'Optional follow-up actions inside the alert.',
|
|
738
|
+
cardinality: 'many',
|
|
739
|
+
allowedCategories: ['action']
|
|
740
|
+
}
|
|
741
|
+
},
|
|
742
|
+
bindings: {},
|
|
743
|
+
actions: {}
|
|
744
|
+
},
|
|
745
|
+
|
|
746
|
+
Badge: {
|
|
747
|
+
name: 'Badge',
|
|
748
|
+
category: 'feedback',
|
|
749
|
+
description: 'Shows compact passive status or category text.',
|
|
750
|
+
propsSchema: {
|
|
751
|
+
type: 'object',
|
|
752
|
+
additionalProperties: false,
|
|
753
|
+
required: ['text'],
|
|
754
|
+
properties: {
|
|
755
|
+
text: { type: 'string', minLength: 1, description: 'Short badge label.' },
|
|
756
|
+
tone: toneSchema('neutral'),
|
|
757
|
+
decorative: {
|
|
758
|
+
type: 'boolean',
|
|
759
|
+
default: false,
|
|
760
|
+
description: 'Hides redundant badges when adjacent text already states the value.'
|
|
761
|
+
}
|
|
762
|
+
}
|
|
763
|
+
},
|
|
764
|
+
slots: {},
|
|
765
|
+
bindings: {},
|
|
766
|
+
actions: {}
|
|
767
|
+
},
|
|
768
|
+
|
|
769
|
+
Progress: {
|
|
770
|
+
name: 'Progress',
|
|
771
|
+
category: 'feedback',
|
|
772
|
+
description: 'Shows determinate or indeterminate task completion progress.',
|
|
773
|
+
propsSchema: {
|
|
774
|
+
type: 'object',
|
|
775
|
+
additionalProperties: false,
|
|
776
|
+
required: ['label'],
|
|
777
|
+
properties: {
|
|
778
|
+
label: { type: 'string', minLength: 1, description: 'Visible or accessible task label.' },
|
|
779
|
+
value: {
|
|
780
|
+
type: ['number', 'null'],
|
|
781
|
+
minimum: 0,
|
|
782
|
+
description: 'Completed amount, or null when progress is indeterminate.'
|
|
783
|
+
},
|
|
784
|
+
max: {
|
|
785
|
+
type: 'number',
|
|
786
|
+
exclusiveMinimum: 0,
|
|
787
|
+
default: 100,
|
|
788
|
+
description: 'Total completion target.'
|
|
789
|
+
}
|
|
790
|
+
}
|
|
791
|
+
},
|
|
792
|
+
slots: {},
|
|
793
|
+
bindings: {
|
|
794
|
+
value: {
|
|
795
|
+
description: 'Optional reactive progress value from surface state.',
|
|
796
|
+
valueType: 'number',
|
|
797
|
+
direction: 'read'
|
|
798
|
+
}
|
|
799
|
+
},
|
|
800
|
+
actions: {}
|
|
801
|
+
},
|
|
802
|
+
|
|
803
|
+
Accordion: {
|
|
804
|
+
name: 'Accordion',
|
|
805
|
+
category: 'data',
|
|
806
|
+
description: 'Organizes collapsible sections that disclose details on demand.',
|
|
807
|
+
propsSchema: {
|
|
808
|
+
type: 'object',
|
|
809
|
+
additionalProperties: false,
|
|
810
|
+
required: ['items'],
|
|
811
|
+
properties: {
|
|
812
|
+
selection: {
|
|
813
|
+
type: 'string',
|
|
814
|
+
enum: ['single', 'multiple'],
|
|
815
|
+
default: 'single',
|
|
816
|
+
description: 'Whether one or multiple sections may stay open simultaneously.'
|
|
817
|
+
},
|
|
818
|
+
items: {
|
|
819
|
+
type: 'array',
|
|
820
|
+
minItems: 1,
|
|
821
|
+
description: 'Ordered collapsible section headers.',
|
|
822
|
+
items: {
|
|
823
|
+
type: 'object',
|
|
824
|
+
additionalProperties: false,
|
|
825
|
+
required: ['value', 'title'],
|
|
826
|
+
properties: {
|
|
827
|
+
value: { type: 'string', minLength: 1, description: 'Stable section identifier.' },
|
|
828
|
+
title: { type: 'string', minLength: 1, description: 'Section trigger heading.' },
|
|
829
|
+
disabled: {
|
|
830
|
+
type: 'boolean',
|
|
831
|
+
default: false,
|
|
832
|
+
description: 'Prevents expanding or collapsing this section.'
|
|
833
|
+
}
|
|
834
|
+
}
|
|
835
|
+
}
|
|
836
|
+
}
|
|
837
|
+
}
|
|
838
|
+
},
|
|
839
|
+
slots: {
|
|
840
|
+
panels: {
|
|
841
|
+
description: 'Content node rendered for each accordion section.',
|
|
842
|
+
cardinality: 'many',
|
|
843
|
+
required: true
|
|
844
|
+
}
|
|
845
|
+
},
|
|
846
|
+
bindings: {
|
|
847
|
+
value: {
|
|
848
|
+
description: 'Open section value or values stored in local surface state.',
|
|
849
|
+
valueType: 'string[]',
|
|
850
|
+
direction: 'two-way'
|
|
851
|
+
}
|
|
852
|
+
},
|
|
853
|
+
actions: {}
|
|
854
|
+
},
|
|
855
|
+
|
|
856
|
+
Table: {
|
|
857
|
+
name: 'Table',
|
|
858
|
+
category: 'data',
|
|
859
|
+
description: 'Displays structured tabular data with typed columns and templated rows.',
|
|
860
|
+
propsSchema: {
|
|
861
|
+
type: 'object',
|
|
862
|
+
additionalProperties: false,
|
|
863
|
+
required: ['caption', 'columns'],
|
|
864
|
+
properties: {
|
|
865
|
+
caption: { type: 'string', minLength: 1, description: 'Accessible table caption.' },
|
|
866
|
+
density: spacingSchema,
|
|
867
|
+
columns: {
|
|
868
|
+
type: 'array',
|
|
869
|
+
minItems: 1,
|
|
870
|
+
description: 'Ordered table column headers.',
|
|
871
|
+
items: {
|
|
872
|
+
type: 'object',
|
|
873
|
+
additionalProperties: false,
|
|
874
|
+
required: ['field', 'label'],
|
|
875
|
+
properties: {
|
|
876
|
+
field: { type: 'string', minLength: 1, description: 'Row data field name.' },
|
|
877
|
+
label: { type: 'string', minLength: 1, description: 'Column header label.' },
|
|
878
|
+
align: {
|
|
879
|
+
type: 'string',
|
|
880
|
+
enum: ['start', 'center', 'end'],
|
|
881
|
+
default: 'start',
|
|
882
|
+
description: 'Logical horizontal alignment for column cells.'
|
|
883
|
+
}
|
|
884
|
+
}
|
|
885
|
+
}
|
|
886
|
+
}
|
|
887
|
+
}
|
|
888
|
+
},
|
|
889
|
+
slots: {
|
|
890
|
+
rows: {
|
|
891
|
+
description: 'Row template or explicit row entries rendered per data record.',
|
|
892
|
+
cardinality: 'many',
|
|
893
|
+
required: true,
|
|
894
|
+
templated: true
|
|
895
|
+
}
|
|
896
|
+
},
|
|
897
|
+
bindings: {
|
|
898
|
+
data: {
|
|
899
|
+
description: 'Collection of row records bound from surface state.',
|
|
900
|
+
valueType: 'object[]',
|
|
901
|
+
direction: 'read'
|
|
902
|
+
}
|
|
903
|
+
},
|
|
904
|
+
actions: {}
|
|
905
|
+
},
|
|
906
|
+
|
|
907
|
+
Toast: {
|
|
908
|
+
name: 'Toast',
|
|
909
|
+
category: 'feedback',
|
|
910
|
+
invocation: 'action',
|
|
911
|
+
description:
|
|
912
|
+
'Displays a transient notification triggered by an action rather than static layout.',
|
|
913
|
+
propsSchema: {
|
|
914
|
+
type: 'object',
|
|
915
|
+
additionalProperties: false,
|
|
916
|
+
required: ['title'],
|
|
917
|
+
properties: {
|
|
918
|
+
title: { type: 'string', minLength: 1, description: 'Primary notification heading.' },
|
|
919
|
+
description: { type: 'string', description: 'Optional supporting detail.' },
|
|
920
|
+
tone: toneSchema('neutral'),
|
|
921
|
+
announce: {
|
|
922
|
+
type: 'string',
|
|
923
|
+
enum: CATALOG_ANNOUNCEMENTS,
|
|
924
|
+
default: 'polite',
|
|
925
|
+
description: 'Live-region urgency for screen readers.'
|
|
926
|
+
},
|
|
927
|
+
duration: {
|
|
928
|
+
type: 'integer',
|
|
929
|
+
minimum: 1000,
|
|
930
|
+
maximum: 30000,
|
|
931
|
+
description: 'Auto-dismiss timeout in milliseconds.'
|
|
932
|
+
},
|
|
933
|
+
actionLabel: {
|
|
934
|
+
type: 'string',
|
|
935
|
+
description: 'Optional label for a single follow-up button inside the toast.'
|
|
936
|
+
}
|
|
937
|
+
}
|
|
938
|
+
},
|
|
939
|
+
slots: {},
|
|
940
|
+
bindings: {},
|
|
941
|
+
actions: {
|
|
942
|
+
action: {
|
|
943
|
+
description: 'Optional outbound action triggered by the toast follow-up button.',
|
|
944
|
+
scope: 'outbound'
|
|
945
|
+
}
|
|
946
|
+
}
|
|
947
|
+
}
|
|
948
|
+
}
|
|
949
|
+
})
|