@praxisui/expansion 9.0.0-beta.3 → 9.0.0-beta.30
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/README.md +1 -41
- package/ai/component-registry.json +1602 -0
- package/package.json +10 -6
|
@@ -0,0 +1,1602 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": "1.0.0",
|
|
3
|
+
"generatedAt": "2026-07-02T00:13:30.173Z",
|
|
4
|
+
"packageName": "@praxisui/expansion",
|
|
5
|
+
"packageVersion": "9.0.0-beta.30",
|
|
6
|
+
"sourceRegistry": "praxis-component-registry-ingestion",
|
|
7
|
+
"sourceRegistryVersion": "1.0.0",
|
|
8
|
+
"componentCount": 1,
|
|
9
|
+
"components": {
|
|
10
|
+
"praxis-expansion": {
|
|
11
|
+
"id": "praxis-expansion",
|
|
12
|
+
"description": "Acordeão/Painéis de expansão configuráveis por metadata, com aparência e tokens M3.",
|
|
13
|
+
"inputs": [
|
|
14
|
+
{
|
|
15
|
+
"name": "config",
|
|
16
|
+
"type": "ExpansionMetadata",
|
|
17
|
+
"required": false
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
"name": "expansionId",
|
|
21
|
+
"type": "string",
|
|
22
|
+
"required": false
|
|
23
|
+
},
|
|
24
|
+
{
|
|
25
|
+
"name": "componentInstanceId",
|
|
26
|
+
"type": "string",
|
|
27
|
+
"required": false
|
|
28
|
+
},
|
|
29
|
+
{
|
|
30
|
+
"name": "enableCustomization",
|
|
31
|
+
"type": "boolean",
|
|
32
|
+
"required": false
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
"name": "context",
|
|
36
|
+
"type": "Record<string, any>",
|
|
37
|
+
"required": false
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
"name": "strictValidation",
|
|
41
|
+
"type": "boolean",
|
|
42
|
+
"required": false
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
"name": "defaultOptions",
|
|
46
|
+
"type": "MatExpansionPanelDefaultOptions",
|
|
47
|
+
"required": false
|
|
48
|
+
}
|
|
49
|
+
],
|
|
50
|
+
"outputs": [
|
|
51
|
+
{
|
|
52
|
+
"name": "opened",
|
|
53
|
+
"type": "{ panelId?: string; panelIndex: number }",
|
|
54
|
+
"required": false
|
|
55
|
+
},
|
|
56
|
+
{
|
|
57
|
+
"name": "closed",
|
|
58
|
+
"type": "{ panelId?: string; panelIndex: number }",
|
|
59
|
+
"required": false
|
|
60
|
+
},
|
|
61
|
+
{
|
|
62
|
+
"name": "expandedChange",
|
|
63
|
+
"type": "{ panelId?: string; panelIndex: number; expanded: boolean }",
|
|
64
|
+
"required": false
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
"name": "afterExpand",
|
|
68
|
+
"type": "{ panelId?: string; panelIndex: number }",
|
|
69
|
+
"required": false
|
|
70
|
+
},
|
|
71
|
+
{
|
|
72
|
+
"name": "afterCollapse",
|
|
73
|
+
"type": "{ panelId?: string; panelIndex: number }",
|
|
74
|
+
"required": false
|
|
75
|
+
},
|
|
76
|
+
{
|
|
77
|
+
"name": "destroyed",
|
|
78
|
+
"type": "{ panelId?: string; panelIndex: number }",
|
|
79
|
+
"required": false
|
|
80
|
+
},
|
|
81
|
+
{
|
|
82
|
+
"name": "widgetEvent",
|
|
83
|
+
"type": "WidgetEventEnvelope",
|
|
84
|
+
"required": false
|
|
85
|
+
}
|
|
86
|
+
],
|
|
87
|
+
"configSchemaId": null,
|
|
88
|
+
"selector": "praxis-expansion",
|
|
89
|
+
"friendlyName": "Praxis Expansion Panel",
|
|
90
|
+
"icon": "unfold_more",
|
|
91
|
+
"tags": [
|
|
92
|
+
"widget",
|
|
93
|
+
"expansion",
|
|
94
|
+
"accordion",
|
|
95
|
+
"configurable"
|
|
96
|
+
],
|
|
97
|
+
"lib": "@praxisui/expansion",
|
|
98
|
+
"source": "projects/praxis-expansion/src/lib/praxis-expansion.metadata.ts",
|
|
99
|
+
"exportName": "PRAXIS_EXPANSION_COMPONENT_METADATA",
|
|
100
|
+
"componentCapabilities": [
|
|
101
|
+
{
|
|
102
|
+
"path": "appearance",
|
|
103
|
+
"category": "appearance",
|
|
104
|
+
"valueKind": "object",
|
|
105
|
+
"description": "Appearance settings."
|
|
106
|
+
},
|
|
107
|
+
{
|
|
108
|
+
"path": "appearance.density",
|
|
109
|
+
"category": "appearance",
|
|
110
|
+
"valueKind": "enum",
|
|
111
|
+
"allowedValues": [
|
|
112
|
+
"compact",
|
|
113
|
+
"comfortable",
|
|
114
|
+
"spacious"
|
|
115
|
+
],
|
|
116
|
+
"description": "Density preset."
|
|
117
|
+
},
|
|
118
|
+
{
|
|
119
|
+
"path": "appearance.themeClass",
|
|
120
|
+
"category": "appearance",
|
|
121
|
+
"valueKind": "string",
|
|
122
|
+
"description": "Theme CSS class for root."
|
|
123
|
+
},
|
|
124
|
+
{
|
|
125
|
+
"path": "appearance.customCss",
|
|
126
|
+
"category": "appearance",
|
|
127
|
+
"valueKind": "string",
|
|
128
|
+
"description": "Custom CSS injected into component.",
|
|
129
|
+
"safetyNotes": "CSS is injected as raw string."
|
|
130
|
+
},
|
|
131
|
+
{
|
|
132
|
+
"path": "appearance.tokens",
|
|
133
|
+
"category": "appearance",
|
|
134
|
+
"valueKind": "object",
|
|
135
|
+
"description": "Token map for theme overrides."
|
|
136
|
+
},
|
|
137
|
+
{
|
|
138
|
+
"path": "appearance.tokens.[token]",
|
|
139
|
+
"category": "appearance",
|
|
140
|
+
"valueKind": "string",
|
|
141
|
+
"allowedValues": [
|
|
142
|
+
"header-background-color"
|
|
143
|
+
],
|
|
144
|
+
"description": "Token value (CSS or var).",
|
|
145
|
+
"safetyNotes": "Only keys supported by styleCss()."
|
|
146
|
+
},
|
|
147
|
+
{
|
|
148
|
+
"path": "accordion",
|
|
149
|
+
"category": "accordion",
|
|
150
|
+
"valueKind": "object",
|
|
151
|
+
"description": "Accordion behavior settings."
|
|
152
|
+
},
|
|
153
|
+
{
|
|
154
|
+
"path": "accordion.multi",
|
|
155
|
+
"category": "accordion",
|
|
156
|
+
"valueKind": "boolean",
|
|
157
|
+
"description": "Allow multiple panels open."
|
|
158
|
+
},
|
|
159
|
+
{
|
|
160
|
+
"path": "accordion.displayMode",
|
|
161
|
+
"category": "accordion",
|
|
162
|
+
"valueKind": "enum",
|
|
163
|
+
"allowedValues": [
|
|
164
|
+
"default",
|
|
165
|
+
"flat"
|
|
166
|
+
],
|
|
167
|
+
"description": "Accordion display mode."
|
|
168
|
+
},
|
|
169
|
+
{
|
|
170
|
+
"path": "accordion.togglePosition",
|
|
171
|
+
"category": "accordion",
|
|
172
|
+
"valueKind": "enum",
|
|
173
|
+
"allowedValues": [
|
|
174
|
+
"before",
|
|
175
|
+
"after"
|
|
176
|
+
],
|
|
177
|
+
"description": "Toggle icon position."
|
|
178
|
+
},
|
|
179
|
+
{
|
|
180
|
+
"path": "accordion.hideToggle",
|
|
181
|
+
"category": "accordion",
|
|
182
|
+
"valueKind": "boolean",
|
|
183
|
+
"description": "Hide toggle icon."
|
|
184
|
+
},
|
|
185
|
+
{
|
|
186
|
+
"path": "accordion.id",
|
|
187
|
+
"category": "accordion",
|
|
188
|
+
"valueKind": "string",
|
|
189
|
+
"description": "Accordion id."
|
|
190
|
+
},
|
|
191
|
+
{
|
|
192
|
+
"path": "panels",
|
|
193
|
+
"category": "panels",
|
|
194
|
+
"valueKind": "array",
|
|
195
|
+
"description": "Panel list."
|
|
196
|
+
},
|
|
197
|
+
{
|
|
198
|
+
"path": "panels[]",
|
|
199
|
+
"category": "panels",
|
|
200
|
+
"valueKind": "object",
|
|
201
|
+
"description": "Panel definition."
|
|
202
|
+
},
|
|
203
|
+
{
|
|
204
|
+
"path": "panels[].id",
|
|
205
|
+
"category": "panels",
|
|
206
|
+
"valueKind": "string",
|
|
207
|
+
"description": "Panel id."
|
|
208
|
+
},
|
|
209
|
+
{
|
|
210
|
+
"path": "panels[].title",
|
|
211
|
+
"category": "panels",
|
|
212
|
+
"valueKind": "string",
|
|
213
|
+
"description": "Panel title."
|
|
214
|
+
},
|
|
215
|
+
{
|
|
216
|
+
"path": "panels[].description",
|
|
217
|
+
"category": "panels",
|
|
218
|
+
"valueKind": "string",
|
|
219
|
+
"description": "Panel description."
|
|
220
|
+
},
|
|
221
|
+
{
|
|
222
|
+
"path": "panels[].icon",
|
|
223
|
+
"category": "panels",
|
|
224
|
+
"valueKind": "string",
|
|
225
|
+
"description": "Panel header icon rendered through PraxisIconDirective."
|
|
226
|
+
},
|
|
227
|
+
{
|
|
228
|
+
"path": "panels[].disabled",
|
|
229
|
+
"category": "panels",
|
|
230
|
+
"valueKind": "boolean",
|
|
231
|
+
"description": "Disable panel."
|
|
232
|
+
},
|
|
233
|
+
{
|
|
234
|
+
"path": "panels[].expanded",
|
|
235
|
+
"category": "panels",
|
|
236
|
+
"valueKind": "boolean",
|
|
237
|
+
"description": "Expanded state."
|
|
238
|
+
},
|
|
239
|
+
{
|
|
240
|
+
"path": "panels[].hideToggle",
|
|
241
|
+
"category": "panels",
|
|
242
|
+
"valueKind": "boolean",
|
|
243
|
+
"description": "Hide toggle icon for panel."
|
|
244
|
+
},
|
|
245
|
+
{
|
|
246
|
+
"path": "panels[].collapsedHeight",
|
|
247
|
+
"category": "panels",
|
|
248
|
+
"valueKind": "string",
|
|
249
|
+
"description": "Collapsed header height (e.g., 48px)."
|
|
250
|
+
},
|
|
251
|
+
{
|
|
252
|
+
"path": "panels[].expandedHeight",
|
|
253
|
+
"category": "panels",
|
|
254
|
+
"valueKind": "string",
|
|
255
|
+
"description": "Expanded header height (e.g., 64px)."
|
|
256
|
+
},
|
|
257
|
+
{
|
|
258
|
+
"path": "panels[].content",
|
|
259
|
+
"category": "panels",
|
|
260
|
+
"valueKind": "array",
|
|
261
|
+
"description": "Dynamic field metadata list (legacy)."
|
|
262
|
+
},
|
|
263
|
+
{
|
|
264
|
+
"path": "panels[].content[]",
|
|
265
|
+
"category": "panels",
|
|
266
|
+
"valueKind": "object",
|
|
267
|
+
"description": "Dynamic field metadata item.",
|
|
268
|
+
"safetyNotes": "Use FieldMetadata base when no controlType catalog exists."
|
|
269
|
+
},
|
|
270
|
+
{
|
|
271
|
+
"path": "panels[].widgets",
|
|
272
|
+
"category": "panels",
|
|
273
|
+
"valueKind": "array",
|
|
274
|
+
"description": "WidgetDefinition list for content."
|
|
275
|
+
},
|
|
276
|
+
{
|
|
277
|
+
"path": "panels[].widgets[]",
|
|
278
|
+
"category": "panels",
|
|
279
|
+
"valueKind": "object",
|
|
280
|
+
"description": "WidgetDefinition item."
|
|
281
|
+
},
|
|
282
|
+
{
|
|
283
|
+
"path": "panels[].widgets[].id",
|
|
284
|
+
"category": "panels",
|
|
285
|
+
"valueKind": "enum",
|
|
286
|
+
"allowedValues": [
|
|
287
|
+
"praxis-dynamic-form",
|
|
288
|
+
"praxis-list",
|
|
289
|
+
"pdx-material-searchable-select",
|
|
290
|
+
"praxis-files-upload"
|
|
291
|
+
],
|
|
292
|
+
"description": "Component registry id for widget."
|
|
293
|
+
},
|
|
294
|
+
{
|
|
295
|
+
"path": "panels[].widgets[].inputs",
|
|
296
|
+
"category": "panels",
|
|
297
|
+
"valueKind": "object",
|
|
298
|
+
"description": "Inputs bound into the widget instance."
|
|
299
|
+
},
|
|
300
|
+
{
|
|
301
|
+
"path": "panels[].widgets[].outputs",
|
|
302
|
+
"category": "panels",
|
|
303
|
+
"valueKind": "object",
|
|
304
|
+
"description": "Outputs mapped to actions."
|
|
305
|
+
},
|
|
306
|
+
{
|
|
307
|
+
"path": "panels[].widgets[].outputs.[outputName]",
|
|
308
|
+
"category": "panels",
|
|
309
|
+
"valueKind": "object",
|
|
310
|
+
"description": "Output action mapping (ActionDefinition or \"emit\")."
|
|
311
|
+
},
|
|
312
|
+
{
|
|
313
|
+
"path": "panels[].widgets[].bindingOrder",
|
|
314
|
+
"category": "panels",
|
|
315
|
+
"valueKind": "array",
|
|
316
|
+
"description": "Explicit input binding order."
|
|
317
|
+
},
|
|
318
|
+
{
|
|
319
|
+
"path": "panels[].widgets[].bindingOrder[]",
|
|
320
|
+
"category": "panels",
|
|
321
|
+
"valueKind": "string",
|
|
322
|
+
"description": "Input name applied first."
|
|
323
|
+
},
|
|
324
|
+
{
|
|
325
|
+
"path": "panels[].actionButtons",
|
|
326
|
+
"category": "actions",
|
|
327
|
+
"valueKind": "array",
|
|
328
|
+
"description": "Action buttons at panel footer."
|
|
329
|
+
},
|
|
330
|
+
{
|
|
331
|
+
"path": "panels[].actionButtons[]",
|
|
332
|
+
"category": "actions",
|
|
333
|
+
"valueKind": "object",
|
|
334
|
+
"description": "Action button definition."
|
|
335
|
+
},
|
|
336
|
+
{
|
|
337
|
+
"path": "panels[].actionButtons[].icon",
|
|
338
|
+
"category": "actions",
|
|
339
|
+
"valueKind": "string",
|
|
340
|
+
"description": "Action icon."
|
|
341
|
+
},
|
|
342
|
+
{
|
|
343
|
+
"path": "panels[].actionButtons[].label",
|
|
344
|
+
"category": "actions",
|
|
345
|
+
"valueKind": "string",
|
|
346
|
+
"description": "Action label."
|
|
347
|
+
},
|
|
348
|
+
{
|
|
349
|
+
"path": "panels[].actionButtons[].action",
|
|
350
|
+
"category": "actions",
|
|
351
|
+
"valueKind": "string",
|
|
352
|
+
"description": "Action identifier payload."
|
|
353
|
+
}
|
|
354
|
+
],
|
|
355
|
+
"componentCapabilityNotes": [
|
|
356
|
+
"panels[] should be merged by id or title to avoid replacing all panels.",
|
|
357
|
+
"appearance.customCss is injected into a <style> tag; avoid unsafe CSS from untrusted sources.",
|
|
358
|
+
"appearance.tokens supports limited keys used by styleCss().",
|
|
359
|
+
"panels[].widgets[].id must be a ComponentMetadataRegistry id.",
|
|
360
|
+
"If a field controlType lacks a dedicated catalog, treat it as FieldMetadata base."
|
|
361
|
+
],
|
|
362
|
+
"componentContext": {
|
|
363
|
+
"version": "v1",
|
|
364
|
+
"optionsByPath": {
|
|
365
|
+
"appearance.density": {
|
|
366
|
+
"mode": "enum",
|
|
367
|
+
"options": [
|
|
368
|
+
{
|
|
369
|
+
"value": "compact",
|
|
370
|
+
"label": "Compact"
|
|
371
|
+
},
|
|
372
|
+
{
|
|
373
|
+
"value": "comfortable",
|
|
374
|
+
"label": "Comfortable"
|
|
375
|
+
},
|
|
376
|
+
{
|
|
377
|
+
"value": "spacious",
|
|
378
|
+
"label": "Spacious"
|
|
379
|
+
}
|
|
380
|
+
]
|
|
381
|
+
},
|
|
382
|
+
"accordion.displayMode": {
|
|
383
|
+
"mode": "enum",
|
|
384
|
+
"options": [
|
|
385
|
+
{
|
|
386
|
+
"value": "default",
|
|
387
|
+
"label": "Default"
|
|
388
|
+
},
|
|
389
|
+
{
|
|
390
|
+
"value": "flat",
|
|
391
|
+
"label": "Flat"
|
|
392
|
+
}
|
|
393
|
+
]
|
|
394
|
+
},
|
|
395
|
+
"accordion.togglePosition": {
|
|
396
|
+
"mode": "enum",
|
|
397
|
+
"options": [
|
|
398
|
+
{
|
|
399
|
+
"value": "before",
|
|
400
|
+
"label": "Before"
|
|
401
|
+
},
|
|
402
|
+
{
|
|
403
|
+
"value": "after",
|
|
404
|
+
"label": "After"
|
|
405
|
+
}
|
|
406
|
+
]
|
|
407
|
+
}
|
|
408
|
+
},
|
|
409
|
+
"actionCatalog": [
|
|
410
|
+
{
|
|
411
|
+
"id": "appearance.density.set",
|
|
412
|
+
"intentExamples": [
|
|
413
|
+
"density",
|
|
414
|
+
"compact",
|
|
415
|
+
"spacious"
|
|
416
|
+
],
|
|
417
|
+
"patchTemplate": {
|
|
418
|
+
"appearance": {
|
|
419
|
+
"density": "{{value}}"
|
|
420
|
+
}
|
|
421
|
+
}
|
|
422
|
+
},
|
|
423
|
+
{
|
|
424
|
+
"id": "accordion.multi.enable",
|
|
425
|
+
"intentExamples": [
|
|
426
|
+
"multiple panels",
|
|
427
|
+
"multi expand",
|
|
428
|
+
"allow multiple"
|
|
429
|
+
],
|
|
430
|
+
"patchTemplate": {
|
|
431
|
+
"accordion": {
|
|
432
|
+
"multi": true
|
|
433
|
+
}
|
|
434
|
+
}
|
|
435
|
+
},
|
|
436
|
+
{
|
|
437
|
+
"id": "accordion.multi.disable",
|
|
438
|
+
"intentExamples": [
|
|
439
|
+
"single panel",
|
|
440
|
+
"only one open"
|
|
441
|
+
],
|
|
442
|
+
"patchTemplate": {
|
|
443
|
+
"accordion": {
|
|
444
|
+
"multi": false
|
|
445
|
+
}
|
|
446
|
+
}
|
|
447
|
+
},
|
|
448
|
+
{
|
|
449
|
+
"id": "accordion.hideToggle.enable",
|
|
450
|
+
"intentExamples": [
|
|
451
|
+
"hide toggle",
|
|
452
|
+
"no caret"
|
|
453
|
+
],
|
|
454
|
+
"patchTemplate": {
|
|
455
|
+
"accordion": {
|
|
456
|
+
"hideToggle": true
|
|
457
|
+
}
|
|
458
|
+
}
|
|
459
|
+
},
|
|
460
|
+
{
|
|
461
|
+
"id": "accordion.hideToggle.disable",
|
|
462
|
+
"intentExamples": [
|
|
463
|
+
"show toggle",
|
|
464
|
+
"show caret"
|
|
465
|
+
],
|
|
466
|
+
"patchTemplate": {
|
|
467
|
+
"accordion": {
|
|
468
|
+
"hideToggle": false
|
|
469
|
+
}
|
|
470
|
+
}
|
|
471
|
+
},
|
|
472
|
+
{
|
|
473
|
+
"id": "panel.add",
|
|
474
|
+
"intentExamples": [
|
|
475
|
+
"add panel",
|
|
476
|
+
"new panel",
|
|
477
|
+
"create panel"
|
|
478
|
+
],
|
|
479
|
+
"patchTemplate": {
|
|
480
|
+
"panels": [
|
|
481
|
+
{
|
|
482
|
+
"id": "{{target}}",
|
|
483
|
+
"title": "{{value}}"
|
|
484
|
+
}
|
|
485
|
+
]
|
|
486
|
+
}
|
|
487
|
+
},
|
|
488
|
+
{
|
|
489
|
+
"id": "panel.title.set",
|
|
490
|
+
"intentExamples": [
|
|
491
|
+
"rename panel",
|
|
492
|
+
"panel title"
|
|
493
|
+
],
|
|
494
|
+
"patchTemplate": {
|
|
495
|
+
"panels": [
|
|
496
|
+
{
|
|
497
|
+
"id": "{{target}}",
|
|
498
|
+
"title": "{{value}}"
|
|
499
|
+
}
|
|
500
|
+
]
|
|
501
|
+
}
|
|
502
|
+
},
|
|
503
|
+
{
|
|
504
|
+
"id": "panel.description.set",
|
|
505
|
+
"intentExamples": [
|
|
506
|
+
"panel description",
|
|
507
|
+
"subtitle"
|
|
508
|
+
],
|
|
509
|
+
"patchTemplate": {
|
|
510
|
+
"panels": [
|
|
511
|
+
{
|
|
512
|
+
"id": "{{target}}",
|
|
513
|
+
"description": "{{value}}"
|
|
514
|
+
}
|
|
515
|
+
]
|
|
516
|
+
}
|
|
517
|
+
},
|
|
518
|
+
{
|
|
519
|
+
"id": "panel.expand",
|
|
520
|
+
"intentExamples": [
|
|
521
|
+
"expand panel",
|
|
522
|
+
"open panel"
|
|
523
|
+
],
|
|
524
|
+
"patchTemplate": {
|
|
525
|
+
"panels": [
|
|
526
|
+
{
|
|
527
|
+
"id": "{{target}}",
|
|
528
|
+
"expanded": true
|
|
529
|
+
}
|
|
530
|
+
]
|
|
531
|
+
}
|
|
532
|
+
},
|
|
533
|
+
{
|
|
534
|
+
"id": "panel.collapse",
|
|
535
|
+
"intentExamples": [
|
|
536
|
+
"collapse panel",
|
|
537
|
+
"close panel"
|
|
538
|
+
],
|
|
539
|
+
"patchTemplate": {
|
|
540
|
+
"panels": [
|
|
541
|
+
{
|
|
542
|
+
"id": "{{target}}",
|
|
543
|
+
"expanded": false
|
|
544
|
+
}
|
|
545
|
+
]
|
|
546
|
+
}
|
|
547
|
+
},
|
|
548
|
+
{
|
|
549
|
+
"id": "panel.disable",
|
|
550
|
+
"intentExamples": [
|
|
551
|
+
"disable panel",
|
|
552
|
+
"lock panel"
|
|
553
|
+
],
|
|
554
|
+
"patchTemplate": {
|
|
555
|
+
"panels": [
|
|
556
|
+
{
|
|
557
|
+
"id": "{{target}}",
|
|
558
|
+
"disabled": true
|
|
559
|
+
}
|
|
560
|
+
]
|
|
561
|
+
}
|
|
562
|
+
},
|
|
563
|
+
{
|
|
564
|
+
"id": "panel.enable",
|
|
565
|
+
"intentExamples": [
|
|
566
|
+
"enable panel",
|
|
567
|
+
"unlock panel"
|
|
568
|
+
],
|
|
569
|
+
"patchTemplate": {
|
|
570
|
+
"panels": [
|
|
571
|
+
{
|
|
572
|
+
"id": "{{target}}",
|
|
573
|
+
"disabled": false
|
|
574
|
+
}
|
|
575
|
+
]
|
|
576
|
+
}
|
|
577
|
+
},
|
|
578
|
+
{
|
|
579
|
+
"id": "panel.hideToggle.enable",
|
|
580
|
+
"intentExamples": [
|
|
581
|
+
"hide panel toggle",
|
|
582
|
+
"no panel toggle"
|
|
583
|
+
],
|
|
584
|
+
"patchTemplate": {
|
|
585
|
+
"panels": [
|
|
586
|
+
{
|
|
587
|
+
"id": "{{target}}",
|
|
588
|
+
"hideToggle": true
|
|
589
|
+
}
|
|
590
|
+
]
|
|
591
|
+
}
|
|
592
|
+
},
|
|
593
|
+
{
|
|
594
|
+
"id": "panel.hideToggle.disable",
|
|
595
|
+
"intentExamples": [
|
|
596
|
+
"show panel toggle",
|
|
597
|
+
"panel caret"
|
|
598
|
+
],
|
|
599
|
+
"patchTemplate": {
|
|
600
|
+
"panels": [
|
|
601
|
+
{
|
|
602
|
+
"id": "{{target}}",
|
|
603
|
+
"hideToggle": false
|
|
604
|
+
}
|
|
605
|
+
]
|
|
606
|
+
}
|
|
607
|
+
}
|
|
608
|
+
],
|
|
609
|
+
"fieldResolvers": {
|
|
610
|
+
"panels[]": [
|
|
611
|
+
"id",
|
|
612
|
+
"title"
|
|
613
|
+
]
|
|
614
|
+
},
|
|
615
|
+
"hints": [
|
|
616
|
+
"Use panels[].id or panels[].title as merge keys; avoid array indexes.",
|
|
617
|
+
"Panels merge by id/title; prefer patching a single panel at a time.",
|
|
618
|
+
"DOC: Widget purpose: accordion/expansion panels with optional fields or widgets.",
|
|
619
|
+
"DOC: Host inputs: expansionId (required) and config (optional).",
|
|
620
|
+
"DOC: Minimal config: panels[] with title for each panel.",
|
|
621
|
+
"DOC: Panel content can be fields (content) or widgets (widgets)."
|
|
622
|
+
]
|
|
623
|
+
},
|
|
624
|
+
"authoringManifest": {
|
|
625
|
+
"schemaVersion": "1.0.0",
|
|
626
|
+
"componentId": "praxis-expansion",
|
|
627
|
+
"ownerPackage": "@praxisui/expansion",
|
|
628
|
+
"configSchemaId": "ExpansionMetadata",
|
|
629
|
+
"manifestVersion": "1.0.0",
|
|
630
|
+
"runtimeInputs": [
|
|
631
|
+
{
|
|
632
|
+
"name": "config",
|
|
633
|
+
"type": "ExpansionMetadata",
|
|
634
|
+
"description": "Canonical accordion and panel configuration."
|
|
635
|
+
},
|
|
636
|
+
{
|
|
637
|
+
"name": "expansionId",
|
|
638
|
+
"type": "string",
|
|
639
|
+
"description": "Stable id used to derive expansion config persistence scope."
|
|
640
|
+
},
|
|
641
|
+
{
|
|
642
|
+
"name": "componentInstanceId",
|
|
643
|
+
"type": "string",
|
|
644
|
+
"description": "Optional instance discriminator for persistence scope."
|
|
645
|
+
},
|
|
646
|
+
{
|
|
647
|
+
"name": "context",
|
|
648
|
+
"type": "Record<string, any>",
|
|
649
|
+
"description": "Context passed to nested widgets."
|
|
650
|
+
},
|
|
651
|
+
{
|
|
652
|
+
"name": "strictValidation",
|
|
653
|
+
"type": "boolean",
|
|
654
|
+
"description": "Controls nested widget validation strictness."
|
|
655
|
+
},
|
|
656
|
+
{
|
|
657
|
+
"name": "defaultOptions",
|
|
658
|
+
"type": "MatExpansionPanelDefaultOptions",
|
|
659
|
+
"description": "Instance-level Material expansion defaults."
|
|
660
|
+
},
|
|
661
|
+
{
|
|
662
|
+
"name": "enableCustomization",
|
|
663
|
+
"type": "boolean",
|
|
664
|
+
"description": "Enables Settings Panel authoring surfaces."
|
|
665
|
+
}
|
|
666
|
+
],
|
|
667
|
+
"editableTargets": [
|
|
668
|
+
{
|
|
669
|
+
"kind": "panel",
|
|
670
|
+
"resolver": "panel-by-id-or-title",
|
|
671
|
+
"description": "A panel in config.panels[]."
|
|
672
|
+
},
|
|
673
|
+
{
|
|
674
|
+
"kind": "panelHeader",
|
|
675
|
+
"resolver": "panel-by-id-or-title",
|
|
676
|
+
"description": "Header title, description, icon and heights for a panel."
|
|
677
|
+
},
|
|
678
|
+
{
|
|
679
|
+
"kind": "panelContent",
|
|
680
|
+
"resolver": "panel-content-by-id",
|
|
681
|
+
"description": "Lazy panel content hosted through fields, widgets or action buttons."
|
|
682
|
+
},
|
|
683
|
+
{
|
|
684
|
+
"kind": "expandedState",
|
|
685
|
+
"resolver": "panel-by-id-or-title",
|
|
686
|
+
"description": "Panel expanded state and default expanded selection."
|
|
687
|
+
},
|
|
688
|
+
{
|
|
689
|
+
"kind": "disabledState",
|
|
690
|
+
"resolver": "panel-by-id-or-title",
|
|
691
|
+
"description": "Panel disabled state."
|
|
692
|
+
},
|
|
693
|
+
{
|
|
694
|
+
"kind": "layout",
|
|
695
|
+
"resolver": "expansion-layout-config",
|
|
696
|
+
"description": "Accordion display mode, toggle position, density and visual layout."
|
|
697
|
+
},
|
|
698
|
+
{
|
|
699
|
+
"kind": "behavior",
|
|
700
|
+
"resolver": "expansion-behavior-config",
|
|
701
|
+
"description": "Accordion multi-expand and hide-toggle behavior."
|
|
702
|
+
}
|
|
703
|
+
],
|
|
704
|
+
"operations": [
|
|
705
|
+
{
|
|
706
|
+
"operationId": "panel.add",
|
|
707
|
+
"title": "Add panel",
|
|
708
|
+
"scope": "global",
|
|
709
|
+
"targetKind": "panel",
|
|
710
|
+
"target": {
|
|
711
|
+
"kind": "panel",
|
|
712
|
+
"resolver": "panels-array",
|
|
713
|
+
"ambiguityPolicy": "fail",
|
|
714
|
+
"required": false
|
|
715
|
+
},
|
|
716
|
+
"inputSchema": {
|
|
717
|
+
"type": "object",
|
|
718
|
+
"required": [
|
|
719
|
+
"id",
|
|
720
|
+
"title"
|
|
721
|
+
],
|
|
722
|
+
"properties": {
|
|
723
|
+
"id": {
|
|
724
|
+
"type": "string"
|
|
725
|
+
},
|
|
726
|
+
"title": {
|
|
727
|
+
"type": "string"
|
|
728
|
+
},
|
|
729
|
+
"description": {
|
|
730
|
+
"type": "string"
|
|
731
|
+
},
|
|
732
|
+
"icon": {
|
|
733
|
+
"type": "string"
|
|
734
|
+
},
|
|
735
|
+
"disabled": {
|
|
736
|
+
"type": "boolean"
|
|
737
|
+
},
|
|
738
|
+
"expanded": {
|
|
739
|
+
"type": "boolean"
|
|
740
|
+
},
|
|
741
|
+
"hideToggle": {
|
|
742
|
+
"type": "boolean"
|
|
743
|
+
},
|
|
744
|
+
"collapsedHeight": {
|
|
745
|
+
"type": "string"
|
|
746
|
+
},
|
|
747
|
+
"expandedHeight": {
|
|
748
|
+
"type": "string"
|
|
749
|
+
},
|
|
750
|
+
"content": {
|
|
751
|
+
"type": "array",
|
|
752
|
+
"items": {
|
|
753
|
+
"type": "object"
|
|
754
|
+
}
|
|
755
|
+
},
|
|
756
|
+
"widgets": {
|
|
757
|
+
"type": "array",
|
|
758
|
+
"items": {
|
|
759
|
+
"type": "object"
|
|
760
|
+
}
|
|
761
|
+
},
|
|
762
|
+
"actionButtons": {
|
|
763
|
+
"type": "array",
|
|
764
|
+
"items": {
|
|
765
|
+
"type": "object"
|
|
766
|
+
}
|
|
767
|
+
}
|
|
768
|
+
}
|
|
769
|
+
},
|
|
770
|
+
"effects": [
|
|
771
|
+
{
|
|
772
|
+
"kind": "append-unique",
|
|
773
|
+
"path": "panels[]",
|
|
774
|
+
"key": "id"
|
|
775
|
+
}
|
|
776
|
+
],
|
|
777
|
+
"destructive": false,
|
|
778
|
+
"requiresConfirmation": false,
|
|
779
|
+
"validators": [
|
|
780
|
+
"panel-id-unique",
|
|
781
|
+
"panel-order-deterministic",
|
|
782
|
+
"panel-content-valid"
|
|
783
|
+
],
|
|
784
|
+
"affectedPaths": [
|
|
785
|
+
"panels[]"
|
|
786
|
+
],
|
|
787
|
+
"submissionImpact": "config-only",
|
|
788
|
+
"preconditions": [
|
|
789
|
+
"config-initialized"
|
|
790
|
+
]
|
|
791
|
+
},
|
|
792
|
+
{
|
|
793
|
+
"operationId": "panel.remove",
|
|
794
|
+
"title": "Remove panel",
|
|
795
|
+
"scope": "layout",
|
|
796
|
+
"targetKind": "panel",
|
|
797
|
+
"target": {
|
|
798
|
+
"kind": "panel",
|
|
799
|
+
"resolver": "panel-by-id-or-title",
|
|
800
|
+
"ambiguityPolicy": "fail",
|
|
801
|
+
"required": true
|
|
802
|
+
},
|
|
803
|
+
"inputSchema": {
|
|
804
|
+
"type": "object",
|
|
805
|
+
"properties": {
|
|
806
|
+
"replacementExpandedPanelId": {
|
|
807
|
+
"type": "string"
|
|
808
|
+
}
|
|
809
|
+
}
|
|
810
|
+
},
|
|
811
|
+
"effects": [
|
|
812
|
+
{
|
|
813
|
+
"kind": "compile-domain-patch",
|
|
814
|
+
"handler": "expansion-panel-remove",
|
|
815
|
+
"handlerContract": {
|
|
816
|
+
"reads": [
|
|
817
|
+
"accordion.multi",
|
|
818
|
+
"panels[]",
|
|
819
|
+
"panels[].id",
|
|
820
|
+
"panels[].expanded"
|
|
821
|
+
],
|
|
822
|
+
"writes": [
|
|
823
|
+
"panels[]",
|
|
824
|
+
"panels[].expanded"
|
|
825
|
+
],
|
|
826
|
+
"identityKeys": [
|
|
827
|
+
"panels[].id"
|
|
828
|
+
],
|
|
829
|
+
"inputSchema": {
|
|
830
|
+
"type": "object",
|
|
831
|
+
"properties": {
|
|
832
|
+
"replacementExpandedPanelId": {
|
|
833
|
+
"type": "string"
|
|
834
|
+
}
|
|
835
|
+
}
|
|
836
|
+
},
|
|
837
|
+
"failureModes": [
|
|
838
|
+
"panel-not-found",
|
|
839
|
+
"replacement-panel-not-found",
|
|
840
|
+
"content-removal-not-confirmed",
|
|
841
|
+
"single-expand-conflict"
|
|
842
|
+
],
|
|
843
|
+
"description": "Removes the target panel by stable id and applies replacement expanded state when the removed panel was expanded."
|
|
844
|
+
}
|
|
845
|
+
}
|
|
846
|
+
],
|
|
847
|
+
"destructive": true,
|
|
848
|
+
"requiresConfirmation": true,
|
|
849
|
+
"validators": [
|
|
850
|
+
"panel-exists",
|
|
851
|
+
"default-expanded-removal-safe",
|
|
852
|
+
"panel-content-removal-confirmed"
|
|
853
|
+
],
|
|
854
|
+
"affectedPaths": [
|
|
855
|
+
"panels[]",
|
|
856
|
+
"panels[].expanded"
|
|
857
|
+
],
|
|
858
|
+
"submissionImpact": "config-only",
|
|
859
|
+
"preconditions": [
|
|
860
|
+
"config-initialized",
|
|
861
|
+
"target-panel-exists",
|
|
862
|
+
"confirmation-collected"
|
|
863
|
+
]
|
|
864
|
+
},
|
|
865
|
+
{
|
|
866
|
+
"operationId": "panel.title.set",
|
|
867
|
+
"title": "Set panel title",
|
|
868
|
+
"scope": "layout",
|
|
869
|
+
"targetKind": "panelHeader",
|
|
870
|
+
"target": {
|
|
871
|
+
"kind": "panelHeader",
|
|
872
|
+
"resolver": "panel-by-id-or-title",
|
|
873
|
+
"ambiguityPolicy": "fail",
|
|
874
|
+
"required": true
|
|
875
|
+
},
|
|
876
|
+
"inputSchema": {
|
|
877
|
+
"type": "object",
|
|
878
|
+
"required": [
|
|
879
|
+
"title"
|
|
880
|
+
],
|
|
881
|
+
"properties": {
|
|
882
|
+
"title": {
|
|
883
|
+
"type": "string"
|
|
884
|
+
}
|
|
885
|
+
}
|
|
886
|
+
},
|
|
887
|
+
"effects": [
|
|
888
|
+
{
|
|
889
|
+
"kind": "merge-by-key",
|
|
890
|
+
"path": "panels[]",
|
|
891
|
+
"key": "id"
|
|
892
|
+
}
|
|
893
|
+
],
|
|
894
|
+
"destructive": false,
|
|
895
|
+
"requiresConfirmation": false,
|
|
896
|
+
"validators": [
|
|
897
|
+
"panel-exists",
|
|
898
|
+
"panel-title-valid"
|
|
899
|
+
],
|
|
900
|
+
"affectedPaths": [
|
|
901
|
+
"panels[].title"
|
|
902
|
+
],
|
|
903
|
+
"submissionImpact": "config-only",
|
|
904
|
+
"preconditions": [
|
|
905
|
+
"config-initialized",
|
|
906
|
+
"target-panel-exists"
|
|
907
|
+
]
|
|
908
|
+
},
|
|
909
|
+
{
|
|
910
|
+
"operationId": "panel.description.set",
|
|
911
|
+
"title": "Set panel description",
|
|
912
|
+
"scope": "layout",
|
|
913
|
+
"targetKind": "panelHeader",
|
|
914
|
+
"target": {
|
|
915
|
+
"kind": "panelHeader",
|
|
916
|
+
"resolver": "panel-by-id-or-title",
|
|
917
|
+
"ambiguityPolicy": "fail",
|
|
918
|
+
"required": true
|
|
919
|
+
},
|
|
920
|
+
"inputSchema": {
|
|
921
|
+
"type": "object",
|
|
922
|
+
"required": [
|
|
923
|
+
"description"
|
|
924
|
+
],
|
|
925
|
+
"properties": {
|
|
926
|
+
"description": {
|
|
927
|
+
"type": "string"
|
|
928
|
+
}
|
|
929
|
+
}
|
|
930
|
+
},
|
|
931
|
+
"effects": [
|
|
932
|
+
{
|
|
933
|
+
"kind": "merge-by-key",
|
|
934
|
+
"path": "panels[]",
|
|
935
|
+
"key": "id"
|
|
936
|
+
}
|
|
937
|
+
],
|
|
938
|
+
"destructive": false,
|
|
939
|
+
"requiresConfirmation": false,
|
|
940
|
+
"validators": [
|
|
941
|
+
"panel-exists",
|
|
942
|
+
"panel-description-valid"
|
|
943
|
+
],
|
|
944
|
+
"affectedPaths": [
|
|
945
|
+
"panels[].description"
|
|
946
|
+
],
|
|
947
|
+
"submissionImpact": "config-only",
|
|
948
|
+
"preconditions": [
|
|
949
|
+
"config-initialized",
|
|
950
|
+
"target-panel-exists"
|
|
951
|
+
]
|
|
952
|
+
},
|
|
953
|
+
{
|
|
954
|
+
"operationId": "panel.icon.set",
|
|
955
|
+
"title": "Set panel icon",
|
|
956
|
+
"scope": "layout",
|
|
957
|
+
"targetKind": "panelHeader",
|
|
958
|
+
"target": {
|
|
959
|
+
"kind": "panelHeader",
|
|
960
|
+
"resolver": "panel-by-id-or-title",
|
|
961
|
+
"ambiguityPolicy": "fail",
|
|
962
|
+
"required": true
|
|
963
|
+
},
|
|
964
|
+
"inputSchema": {
|
|
965
|
+
"type": "object",
|
|
966
|
+
"required": [
|
|
967
|
+
"icon"
|
|
968
|
+
],
|
|
969
|
+
"properties": {
|
|
970
|
+
"icon": {
|
|
971
|
+
"type": "string"
|
|
972
|
+
}
|
|
973
|
+
}
|
|
974
|
+
},
|
|
975
|
+
"effects": [
|
|
976
|
+
{
|
|
977
|
+
"kind": "merge-by-key",
|
|
978
|
+
"path": "panels[]",
|
|
979
|
+
"key": "id"
|
|
980
|
+
}
|
|
981
|
+
],
|
|
982
|
+
"destructive": false,
|
|
983
|
+
"requiresConfirmation": false,
|
|
984
|
+
"validators": [
|
|
985
|
+
"panel-exists",
|
|
986
|
+
"panel-icon-valid",
|
|
987
|
+
"editor-runtime-round-trip"
|
|
988
|
+
],
|
|
989
|
+
"affectedPaths": [
|
|
990
|
+
"panels[].icon"
|
|
991
|
+
],
|
|
992
|
+
"submissionImpact": "config-only",
|
|
993
|
+
"preconditions": [
|
|
994
|
+
"config-initialized",
|
|
995
|
+
"target-panel-exists"
|
|
996
|
+
]
|
|
997
|
+
},
|
|
998
|
+
{
|
|
999
|
+
"operationId": "panel.order.set",
|
|
1000
|
+
"title": "Reorder panels",
|
|
1001
|
+
"scope": "layout",
|
|
1002
|
+
"targetKind": "panel",
|
|
1003
|
+
"target": {
|
|
1004
|
+
"kind": "panel",
|
|
1005
|
+
"resolver": "panel-by-id-or-title",
|
|
1006
|
+
"ambiguityPolicy": "fail",
|
|
1007
|
+
"required": true
|
|
1008
|
+
},
|
|
1009
|
+
"inputSchema": {
|
|
1010
|
+
"type": "object",
|
|
1011
|
+
"required": [
|
|
1012
|
+
"beforePanelId"
|
|
1013
|
+
],
|
|
1014
|
+
"properties": {
|
|
1015
|
+
"beforePanelId": {
|
|
1016
|
+
"type": "string"
|
|
1017
|
+
}
|
|
1018
|
+
}
|
|
1019
|
+
},
|
|
1020
|
+
"effects": [
|
|
1021
|
+
{
|
|
1022
|
+
"kind": "reorder-by-key",
|
|
1023
|
+
"path": "panels[]",
|
|
1024
|
+
"key": "id"
|
|
1025
|
+
}
|
|
1026
|
+
],
|
|
1027
|
+
"destructive": false,
|
|
1028
|
+
"requiresConfirmation": false,
|
|
1029
|
+
"validators": [
|
|
1030
|
+
"panel-exists",
|
|
1031
|
+
"panel-order-deterministic"
|
|
1032
|
+
],
|
|
1033
|
+
"affectedPaths": [
|
|
1034
|
+
"panels[]"
|
|
1035
|
+
],
|
|
1036
|
+
"submissionImpact": "config-only",
|
|
1037
|
+
"preconditions": [
|
|
1038
|
+
"config-initialized",
|
|
1039
|
+
"target-panel-exists"
|
|
1040
|
+
]
|
|
1041
|
+
},
|
|
1042
|
+
{
|
|
1043
|
+
"operationId": "panel.disabled.set",
|
|
1044
|
+
"title": "Set disabled state",
|
|
1045
|
+
"scope": "interaction",
|
|
1046
|
+
"targetKind": "disabledState",
|
|
1047
|
+
"target": {
|
|
1048
|
+
"kind": "disabledState",
|
|
1049
|
+
"resolver": "panel-by-id-or-title",
|
|
1050
|
+
"ambiguityPolicy": "fail",
|
|
1051
|
+
"required": true
|
|
1052
|
+
},
|
|
1053
|
+
"inputSchema": {
|
|
1054
|
+
"type": "object",
|
|
1055
|
+
"required": [
|
|
1056
|
+
"disabled"
|
|
1057
|
+
],
|
|
1058
|
+
"properties": {
|
|
1059
|
+
"disabled": {
|
|
1060
|
+
"type": "boolean"
|
|
1061
|
+
}
|
|
1062
|
+
}
|
|
1063
|
+
},
|
|
1064
|
+
"effects": [
|
|
1065
|
+
{
|
|
1066
|
+
"kind": "merge-by-key",
|
|
1067
|
+
"path": "panels[]",
|
|
1068
|
+
"key": "id"
|
|
1069
|
+
}
|
|
1070
|
+
],
|
|
1071
|
+
"destructive": false,
|
|
1072
|
+
"requiresConfirmation": false,
|
|
1073
|
+
"validators": [
|
|
1074
|
+
"panel-exists",
|
|
1075
|
+
"disabled-expanded-compatible"
|
|
1076
|
+
],
|
|
1077
|
+
"affectedPaths": [
|
|
1078
|
+
"panels[].disabled",
|
|
1079
|
+
"panels[].expanded"
|
|
1080
|
+
],
|
|
1081
|
+
"submissionImpact": "config-only",
|
|
1082
|
+
"preconditions": [
|
|
1083
|
+
"config-initialized",
|
|
1084
|
+
"target-panel-exists"
|
|
1085
|
+
]
|
|
1086
|
+
},
|
|
1087
|
+
{
|
|
1088
|
+
"operationId": "behavior.multiExpand.set",
|
|
1089
|
+
"title": "Set multi-expand behavior",
|
|
1090
|
+
"scope": "interaction",
|
|
1091
|
+
"targetKind": "behavior",
|
|
1092
|
+
"target": {
|
|
1093
|
+
"kind": "behavior",
|
|
1094
|
+
"resolver": "expansion-behavior-config",
|
|
1095
|
+
"ambiguityPolicy": "fail",
|
|
1096
|
+
"required": true
|
|
1097
|
+
},
|
|
1098
|
+
"inputSchema": {
|
|
1099
|
+
"type": "object",
|
|
1100
|
+
"required": [
|
|
1101
|
+
"multi"
|
|
1102
|
+
],
|
|
1103
|
+
"properties": {
|
|
1104
|
+
"multi": {
|
|
1105
|
+
"type": "boolean"
|
|
1106
|
+
}
|
|
1107
|
+
}
|
|
1108
|
+
},
|
|
1109
|
+
"effects": [
|
|
1110
|
+
{
|
|
1111
|
+
"kind": "compile-domain-patch",
|
|
1112
|
+
"handler": "expansion-multi-expand-set",
|
|
1113
|
+
"handlerContract": {
|
|
1114
|
+
"reads": [
|
|
1115
|
+
"accordion.multi",
|
|
1116
|
+
"panels[]",
|
|
1117
|
+
"panels[].id",
|
|
1118
|
+
"panels[].expanded"
|
|
1119
|
+
],
|
|
1120
|
+
"writes": [
|
|
1121
|
+
"accordion.multi",
|
|
1122
|
+
"panels[].expanded"
|
|
1123
|
+
],
|
|
1124
|
+
"identityKeys": [
|
|
1125
|
+
"panels[].id"
|
|
1126
|
+
],
|
|
1127
|
+
"inputSchema": {
|
|
1128
|
+
"type": "object",
|
|
1129
|
+
"required": [
|
|
1130
|
+
"multi"
|
|
1131
|
+
],
|
|
1132
|
+
"properties": {
|
|
1133
|
+
"multi": {
|
|
1134
|
+
"type": "boolean"
|
|
1135
|
+
}
|
|
1136
|
+
}
|
|
1137
|
+
},
|
|
1138
|
+
"failureModes": [
|
|
1139
|
+
"multiple-expanded-panels-conflict",
|
|
1140
|
+
"panel-id-missing"
|
|
1141
|
+
],
|
|
1142
|
+
"description": "Sets accordion.multi and collapses competing expanded panels when switching to single-expand behavior."
|
|
1143
|
+
}
|
|
1144
|
+
}
|
|
1145
|
+
],
|
|
1146
|
+
"destructive": false,
|
|
1147
|
+
"requiresConfirmation": false,
|
|
1148
|
+
"validators": [
|
|
1149
|
+
"multi-expand-default-compatible",
|
|
1150
|
+
"accordion-values-valid",
|
|
1151
|
+
"editor-runtime-round-trip"
|
|
1152
|
+
],
|
|
1153
|
+
"affectedPaths": [
|
|
1154
|
+
"accordion.multi",
|
|
1155
|
+
"panels[].expanded"
|
|
1156
|
+
],
|
|
1157
|
+
"submissionImpact": "config-only",
|
|
1158
|
+
"preconditions": [
|
|
1159
|
+
"config-initialized"
|
|
1160
|
+
]
|
|
1161
|
+
},
|
|
1162
|
+
{
|
|
1163
|
+
"operationId": "behavior.defaultExpanded.set",
|
|
1164
|
+
"title": "Set default expanded panel",
|
|
1165
|
+
"scope": "interaction",
|
|
1166
|
+
"targetKind": "expandedState",
|
|
1167
|
+
"target": {
|
|
1168
|
+
"kind": "expandedState",
|
|
1169
|
+
"resolver": "panel-by-id-or-title",
|
|
1170
|
+
"ambiguityPolicy": "fail",
|
|
1171
|
+
"required": true
|
|
1172
|
+
},
|
|
1173
|
+
"inputSchema": {
|
|
1174
|
+
"type": "object",
|
|
1175
|
+
"required": [
|
|
1176
|
+
"expanded"
|
|
1177
|
+
],
|
|
1178
|
+
"properties": {
|
|
1179
|
+
"expanded": {
|
|
1180
|
+
"type": "boolean"
|
|
1181
|
+
},
|
|
1182
|
+
"collapseOthers": {
|
|
1183
|
+
"type": "boolean"
|
|
1184
|
+
}
|
|
1185
|
+
}
|
|
1186
|
+
},
|
|
1187
|
+
"effects": [
|
|
1188
|
+
{
|
|
1189
|
+
"kind": "compile-domain-patch",
|
|
1190
|
+
"handler": "expansion-default-expanded-upsert",
|
|
1191
|
+
"handlerContract": {
|
|
1192
|
+
"reads": [
|
|
1193
|
+
"accordion.multi",
|
|
1194
|
+
"panels[]",
|
|
1195
|
+
"panels[].id",
|
|
1196
|
+
"panels[].expanded",
|
|
1197
|
+
"panels[].disabled"
|
|
1198
|
+
],
|
|
1199
|
+
"writes": [
|
|
1200
|
+
"panels[].expanded"
|
|
1201
|
+
],
|
|
1202
|
+
"identityKeys": [
|
|
1203
|
+
"panels[].id"
|
|
1204
|
+
],
|
|
1205
|
+
"inputSchema": {
|
|
1206
|
+
"type": "object",
|
|
1207
|
+
"required": [
|
|
1208
|
+
"panelId",
|
|
1209
|
+
"expanded"
|
|
1210
|
+
],
|
|
1211
|
+
"properties": {
|
|
1212
|
+
"panelId": {
|
|
1213
|
+
"type": "string"
|
|
1214
|
+
},
|
|
1215
|
+
"expanded": {
|
|
1216
|
+
"type": "boolean"
|
|
1217
|
+
},
|
|
1218
|
+
"collapseOthers": {
|
|
1219
|
+
"type": "boolean"
|
|
1220
|
+
}
|
|
1221
|
+
}
|
|
1222
|
+
},
|
|
1223
|
+
"failureModes": [
|
|
1224
|
+
"panel-not-found",
|
|
1225
|
+
"panel-disabled",
|
|
1226
|
+
"single-expand-conflict"
|
|
1227
|
+
],
|
|
1228
|
+
"description": "Sets a panel expanded state and collapses competing panels when accordion.multi is false."
|
|
1229
|
+
}
|
|
1230
|
+
}
|
|
1231
|
+
],
|
|
1232
|
+
"validators": [
|
|
1233
|
+
"panel-exists",
|
|
1234
|
+
"default-expanded-panel-exists",
|
|
1235
|
+
"multi-expand-default-compatible",
|
|
1236
|
+
"disabled-expanded-compatible"
|
|
1237
|
+
],
|
|
1238
|
+
"destructive": false,
|
|
1239
|
+
"requiresConfirmation": false,
|
|
1240
|
+
"affectedPaths": [
|
|
1241
|
+
"panels[].expanded",
|
|
1242
|
+
"accordion.multi"
|
|
1243
|
+
],
|
|
1244
|
+
"submissionImpact": "config-only",
|
|
1245
|
+
"preconditions": [
|
|
1246
|
+
"config-initialized",
|
|
1247
|
+
"target-panel-exists"
|
|
1248
|
+
]
|
|
1249
|
+
},
|
|
1250
|
+
{
|
|
1251
|
+
"operationId": "panel.content.set",
|
|
1252
|
+
"title": "Set panel content",
|
|
1253
|
+
"scope": "layout",
|
|
1254
|
+
"targetKind": "panelContent",
|
|
1255
|
+
"target": {
|
|
1256
|
+
"kind": "panelContent",
|
|
1257
|
+
"resolver": "panel-content-by-id",
|
|
1258
|
+
"ambiguityPolicy": "fail",
|
|
1259
|
+
"required": true
|
|
1260
|
+
},
|
|
1261
|
+
"inputSchema": {
|
|
1262
|
+
"type": "object",
|
|
1263
|
+
"minProperties": 1,
|
|
1264
|
+
"properties": {
|
|
1265
|
+
"id": {
|
|
1266
|
+
"type": "string"
|
|
1267
|
+
},
|
|
1268
|
+
"title": {
|
|
1269
|
+
"type": "string"
|
|
1270
|
+
},
|
|
1271
|
+
"description": {
|
|
1272
|
+
"type": "string"
|
|
1273
|
+
},
|
|
1274
|
+
"icon": {
|
|
1275
|
+
"type": "string"
|
|
1276
|
+
},
|
|
1277
|
+
"disabled": {
|
|
1278
|
+
"type": "boolean"
|
|
1279
|
+
},
|
|
1280
|
+
"expanded": {
|
|
1281
|
+
"type": "boolean"
|
|
1282
|
+
},
|
|
1283
|
+
"hideToggle": {
|
|
1284
|
+
"type": "boolean"
|
|
1285
|
+
},
|
|
1286
|
+
"collapsedHeight": {
|
|
1287
|
+
"type": "string"
|
|
1288
|
+
},
|
|
1289
|
+
"expandedHeight": {
|
|
1290
|
+
"type": "string"
|
|
1291
|
+
},
|
|
1292
|
+
"content": {
|
|
1293
|
+
"type": "array",
|
|
1294
|
+
"items": {
|
|
1295
|
+
"type": "object"
|
|
1296
|
+
}
|
|
1297
|
+
},
|
|
1298
|
+
"widgets": {
|
|
1299
|
+
"type": "array",
|
|
1300
|
+
"items": {
|
|
1301
|
+
"type": "object"
|
|
1302
|
+
}
|
|
1303
|
+
},
|
|
1304
|
+
"actionButtons": {
|
|
1305
|
+
"type": "array",
|
|
1306
|
+
"items": {
|
|
1307
|
+
"type": "object"
|
|
1308
|
+
}
|
|
1309
|
+
}
|
|
1310
|
+
}
|
|
1311
|
+
},
|
|
1312
|
+
"effects": [
|
|
1313
|
+
{
|
|
1314
|
+
"kind": "merge-by-key",
|
|
1315
|
+
"path": "panels[]",
|
|
1316
|
+
"key": "id"
|
|
1317
|
+
}
|
|
1318
|
+
],
|
|
1319
|
+
"destructive": false,
|
|
1320
|
+
"requiresConfirmation": false,
|
|
1321
|
+
"validators": [
|
|
1322
|
+
"panel-exists",
|
|
1323
|
+
"panel-content-valid",
|
|
1324
|
+
"lazy-content-compatible",
|
|
1325
|
+
"nested-widget-contract-delegated"
|
|
1326
|
+
],
|
|
1327
|
+
"affectedPaths": [
|
|
1328
|
+
"panels[].content",
|
|
1329
|
+
"panels[].widgets",
|
|
1330
|
+
"panels[].actionButtons"
|
|
1331
|
+
],
|
|
1332
|
+
"submissionImpact": "affects-schema-backed-data",
|
|
1333
|
+
"preconditions": [
|
|
1334
|
+
"config-initialized",
|
|
1335
|
+
"target-panel-exists"
|
|
1336
|
+
]
|
|
1337
|
+
}
|
|
1338
|
+
],
|
|
1339
|
+
"validators": [
|
|
1340
|
+
{
|
|
1341
|
+
"validatorId": "panel-id-unique",
|
|
1342
|
+
"level": "error",
|
|
1343
|
+
"code": "PEXP001",
|
|
1344
|
+
"description": "Panel ids must be unique and stable within config.panels[]."
|
|
1345
|
+
},
|
|
1346
|
+
{
|
|
1347
|
+
"validatorId": "panel-exists",
|
|
1348
|
+
"level": "error",
|
|
1349
|
+
"code": "PEXP002",
|
|
1350
|
+
"description": "Target panel must exist before applying the operation."
|
|
1351
|
+
},
|
|
1352
|
+
{
|
|
1353
|
+
"validatorId": "panel-order-deterministic",
|
|
1354
|
+
"level": "error",
|
|
1355
|
+
"code": "PEXP003",
|
|
1356
|
+
"description": "Panel ordering must use stable ids, not transient array index as identity."
|
|
1357
|
+
},
|
|
1358
|
+
{
|
|
1359
|
+
"validatorId": "panel-title-valid",
|
|
1360
|
+
"level": "error",
|
|
1361
|
+
"code": "PEXP004",
|
|
1362
|
+
"description": "Panel title must be a non-empty text value after localization/domain projection."
|
|
1363
|
+
},
|
|
1364
|
+
{
|
|
1365
|
+
"validatorId": "panel-description-valid",
|
|
1366
|
+
"level": "warning",
|
|
1367
|
+
"code": "PEXP005",
|
|
1368
|
+
"description": "Panel description should remain plain header-support text and not replace panel content."
|
|
1369
|
+
},
|
|
1370
|
+
{
|
|
1371
|
+
"validatorId": "panel-icon-valid",
|
|
1372
|
+
"level": "warning",
|
|
1373
|
+
"code": "PEXP006",
|
|
1374
|
+
"description": "Panel icon metadata must remain compatible with PraxisIconDirective and editor round-trip."
|
|
1375
|
+
},
|
|
1376
|
+
{
|
|
1377
|
+
"validatorId": "panel-content-valid",
|
|
1378
|
+
"level": "error",
|
|
1379
|
+
"code": "PEXP007",
|
|
1380
|
+
"description": "Panel content must remain valid FieldMetadata[], WidgetDefinition[] or action button metadata."
|
|
1381
|
+
},
|
|
1382
|
+
{
|
|
1383
|
+
"validatorId": "panel-content-removal-confirmed",
|
|
1384
|
+
"level": "error",
|
|
1385
|
+
"code": "PEXP008",
|
|
1386
|
+
"description": "Removing a panel with fields, widgets or action buttons is destructive and requires confirmation."
|
|
1387
|
+
},
|
|
1388
|
+
{
|
|
1389
|
+
"validatorId": "default-expanded-panel-exists",
|
|
1390
|
+
"level": "error",
|
|
1391
|
+
"code": "PEXP009",
|
|
1392
|
+
"description": "Default expanded state must reference an existing panel id."
|
|
1393
|
+
},
|
|
1394
|
+
{
|
|
1395
|
+
"validatorId": "default-expanded-removal-safe",
|
|
1396
|
+
"level": "error",
|
|
1397
|
+
"code": "PEXP010",
|
|
1398
|
+
"description": "Removing an expanded panel requires deterministic replacement state or explicit confirmation."
|
|
1399
|
+
},
|
|
1400
|
+
{
|
|
1401
|
+
"validatorId": "multi-expand-default-compatible",
|
|
1402
|
+
"level": "error",
|
|
1403
|
+
"code": "PEXP011",
|
|
1404
|
+
"description": "When accordion.multi is false, at most one panel may be marked expanded by default."
|
|
1405
|
+
},
|
|
1406
|
+
{
|
|
1407
|
+
"validatorId": "disabled-expanded-compatible",
|
|
1408
|
+
"level": "warning",
|
|
1409
|
+
"code": "PEXP012",
|
|
1410
|
+
"description": "A disabled panel should not be the only expanded/default focus target without explicit intent."
|
|
1411
|
+
},
|
|
1412
|
+
{
|
|
1413
|
+
"validatorId": "accordion-values-valid",
|
|
1414
|
+
"level": "error",
|
|
1415
|
+
"code": "PEXP013",
|
|
1416
|
+
"description": "Accordion behavior values must match ExpansionMetadata and Angular Material expansion bindings."
|
|
1417
|
+
},
|
|
1418
|
+
{
|
|
1419
|
+
"validatorId": "lazy-content-compatible",
|
|
1420
|
+
"level": "info",
|
|
1421
|
+
"code": "PEXP015",
|
|
1422
|
+
"description": "Panel content remains lazy through matExpansionPanelContent and should not require eager child runtime state."
|
|
1423
|
+
},
|
|
1424
|
+
{
|
|
1425
|
+
"validatorId": "nested-widget-contract-delegated",
|
|
1426
|
+
"level": "info",
|
|
1427
|
+
"code": "PEXP016",
|
|
1428
|
+
"description": "Nested widget content remains governed by child component contracts and component-port nestedPath semantics."
|
|
1429
|
+
},
|
|
1430
|
+
{
|
|
1431
|
+
"validatorId": "editor-runtime-round-trip",
|
|
1432
|
+
"level": "error",
|
|
1433
|
+
"code": "PEXP017",
|
|
1434
|
+
"description": "Settings Panel editor, runtime persistence and registry projection must preserve panel ids, order, icons and expanded state."
|
|
1435
|
+
}
|
|
1436
|
+
],
|
|
1437
|
+
"roundTripRequirements": [
|
|
1438
|
+
"Operations must preserve stable panel ids; array index may be used only as a resolver fallback, never as canonical identity.",
|
|
1439
|
+
"Settings Panel editor, runtime persistence and registry projection must round-trip ExpansionMetadata without losing panel ids, order, icons or expanded state.",
|
|
1440
|
+
"When accordion.multi is false, authoring must collapse competing panels or fail validation instead of producing multiple default-expanded panels.",
|
|
1441
|
+
"Lazy panel content remains represented by panels[].content, panels[].widgets and panels[].actionButtons; authoring cannot require eager child component instances.",
|
|
1442
|
+
"Nested widgets remain delegated through WidgetDefinition and component-port nestedPath semantics instead of being redefined by the expansion contract."
|
|
1443
|
+
],
|
|
1444
|
+
"examples": [
|
|
1445
|
+
{
|
|
1446
|
+
"id": "add-summary-panel",
|
|
1447
|
+
"request": "Add a summary panel before the audit panel.",
|
|
1448
|
+
"operationId": "panel.add",
|
|
1449
|
+
"params": {
|
|
1450
|
+
"id": "summary",
|
|
1451
|
+
"title": "Summary"
|
|
1452
|
+
},
|
|
1453
|
+
"isPositive": true
|
|
1454
|
+
},
|
|
1455
|
+
{
|
|
1456
|
+
"id": "rename-details-panel",
|
|
1457
|
+
"request": "Rename details to Account details.",
|
|
1458
|
+
"operationId": "panel.title.set",
|
|
1459
|
+
"target": "details",
|
|
1460
|
+
"params": {
|
|
1461
|
+
"title": "Account details"
|
|
1462
|
+
},
|
|
1463
|
+
"isPositive": true
|
|
1464
|
+
},
|
|
1465
|
+
{
|
|
1466
|
+
"id": "describe-audit-panel",
|
|
1467
|
+
"request": "Set audit panel description to Recent changes.",
|
|
1468
|
+
"operationId": "panel.description.set",
|
|
1469
|
+
"target": "audit",
|
|
1470
|
+
"params": {
|
|
1471
|
+
"description": "Recent changes"
|
|
1472
|
+
},
|
|
1473
|
+
"isPositive": true
|
|
1474
|
+
},
|
|
1475
|
+
{
|
|
1476
|
+
"id": "set-panel-icon",
|
|
1477
|
+
"request": "Use the info icon on the summary panel.",
|
|
1478
|
+
"operationId": "panel.icon.set",
|
|
1479
|
+
"target": "summary",
|
|
1480
|
+
"params": {
|
|
1481
|
+
"icon": "info"
|
|
1482
|
+
},
|
|
1483
|
+
"isPositive": true
|
|
1484
|
+
},
|
|
1485
|
+
{
|
|
1486
|
+
"id": "set-default-expanded-panel",
|
|
1487
|
+
"request": "Open the summary panel by default.",
|
|
1488
|
+
"operationId": "behavior.defaultExpanded.set",
|
|
1489
|
+
"target": "summary",
|
|
1490
|
+
"params": {
|
|
1491
|
+
"expanded": true,
|
|
1492
|
+
"collapseOthers": true
|
|
1493
|
+
},
|
|
1494
|
+
"isPositive": true
|
|
1495
|
+
},
|
|
1496
|
+
{
|
|
1497
|
+
"id": "enable-multi-expand",
|
|
1498
|
+
"request": "Allow multiple panels to stay open.",
|
|
1499
|
+
"operationId": "behavior.multiExpand.set",
|
|
1500
|
+
"params": {
|
|
1501
|
+
"multi": true
|
|
1502
|
+
},
|
|
1503
|
+
"isPositive": true
|
|
1504
|
+
},
|
|
1505
|
+
{
|
|
1506
|
+
"id": "disable-archive-panel",
|
|
1507
|
+
"request": "Disable the archive panel.",
|
|
1508
|
+
"operationId": "panel.disabled.set",
|
|
1509
|
+
"target": "archive",
|
|
1510
|
+
"params": {
|
|
1511
|
+
"disabled": true
|
|
1512
|
+
},
|
|
1513
|
+
"isPositive": true
|
|
1514
|
+
},
|
|
1515
|
+
{
|
|
1516
|
+
"id": "reject-missing-default-expanded",
|
|
1517
|
+
"request": "Open the missing panel by default.",
|
|
1518
|
+
"operationId": "behavior.defaultExpanded.set",
|
|
1519
|
+
"target": "missing",
|
|
1520
|
+
"params": {
|
|
1521
|
+
"expanded": true
|
|
1522
|
+
},
|
|
1523
|
+
"isPositive": false
|
|
1524
|
+
},
|
|
1525
|
+
{
|
|
1526
|
+
"id": "reject-duplicate-panel-id",
|
|
1527
|
+
"request": "Add another panel with id summary.",
|
|
1528
|
+
"operationId": "panel.add",
|
|
1529
|
+
"params": {
|
|
1530
|
+
"id": "summary",
|
|
1531
|
+
"title": "Duplicate summary"
|
|
1532
|
+
},
|
|
1533
|
+
"isPositive": false
|
|
1534
|
+
},
|
|
1535
|
+
{
|
|
1536
|
+
"id": "confirm-remove-content-panel",
|
|
1537
|
+
"request": "Remove the details panel that contains widgets.",
|
|
1538
|
+
"operationId": "panel.remove",
|
|
1539
|
+
"target": "details",
|
|
1540
|
+
"params": {
|
|
1541
|
+
"replacementExpandedPanelId": "summary"
|
|
1542
|
+
},
|
|
1543
|
+
"isPositive": true
|
|
1544
|
+
}
|
|
1545
|
+
]
|
|
1546
|
+
},
|
|
1547
|
+
"chunks": [
|
|
1548
|
+
{
|
|
1549
|
+
"chunkIndex": 0,
|
|
1550
|
+
"chunkKind": "summary",
|
|
1551
|
+
"content": "Component ID: praxis-expansion\nSelector: praxis-expansion\nFriendly Name: Praxis Expansion Panel\nDescription: Acordeão/Painéis de expansão configuráveis por metadata, com aparência e tokens M3.\nLib/Package: @praxisui/expansion\nTags: widget, expansion, accordion, configurable\nInputs:\n - config (ExpansionMetadata)\n - expansionId (string)\n - componentInstanceId (string)\n - enableCustomization (boolean)\n - context (Record<string, any>)\n - strictValidation (boolean)\n - defaultOptions (MatExpansionPanelDefaultOptions)\nOutputs:\n - opened ({ panelId?: string; panelIndex: number })\n - closed ({ panelId?: string; panelIndex: number })\n - expandedChange ({ panelId?: string; panelIndex: number; expanded: boolean })\n - afterExpand ({ panelId?: string; panelIndex: number })\n - afterCollapse ({ panelId?: string; panelIndex: number })\n - destroyed ({ panelId?: string; panelIndex: number })\n - widgetEvent (WidgetEventEnvelope)\n",
|
|
1552
|
+
"sourcePointer": "praxis-ui-angular/projects/praxis-expansion/src/lib/praxis-expansion.metadata.ts",
|
|
1553
|
+
"contentHash": "30ccb793a31c22baf57710e1c70b92fc952e40dcea38869a7f32ce91d1600ece",
|
|
1554
|
+
"sourceKind": "component_definition",
|
|
1555
|
+
"sourceId": "praxis-expansion",
|
|
1556
|
+
"corpusVersion": "1.0.0"
|
|
1557
|
+
},
|
|
1558
|
+
{
|
|
1559
|
+
"chunkIndex": 1,
|
|
1560
|
+
"chunkKind": "capabilities",
|
|
1561
|
+
"content": "Component Capabilities:\n - Path: appearance\n Category: appearance\n Kind: object\n Description: Appearance settings.\n - Path: appearance.density\n Category: appearance\n Kind: enum\n Description: Density preset.\n - Path: appearance.themeClass\n Category: appearance\n Kind: string\n Description: Theme CSS class for root.\n - Path: appearance.customCss\n Category: appearance\n Kind: string\n Description: Custom CSS injected into component.\n - Path: appearance.tokens\n Category: appearance\n Kind: object\n Description: Token map for theme overrides.\n - Path: appearance.tokens.[token]\n Category: appearance\n Kind: string\n Description: Token value (CSS or var).\n - Path: accordion\n Category: accordion\n Kind: object\n Description: Accordion behavior settings.\n - Path: accordion.multi\n Category: accordion\n Kind: boolean\n Description: Allow multiple panels open.\n - Path: accordion.displayMode\n Category: accordion\n Kind: enum\n Description: Accordion display mode.\n - Path: accordion.togglePosition\n Category: accordion\n Kind: enum\n Description: Toggle icon position.\n - Path: accordion.hideToggle\n Category: accordion\n Kind: boolean\n Description: Hide toggle icon.\n - Path: accordion.id\n Category: accordion\n Kind: string\n Description: Accordion id.\n - Path: panels\n Category: panels\n Kind: array\n Description: Panel list.\n - Path: panels[]\n Category: panels\n Kind: object\n Description: Panel definition.\n - Path: panels[].id\n Category: panels\n Kind: string\n Description: Panel id.\n - Path: panels[].title\n Category: panels\n Kind: string\n Description: Panel title.\n - Path: panels[].description\n Category: panels\n Kind: string\n Description: Panel description.\n - Path: panels[].icon\n Category: panels\n Kind: string\n Description: Panel header icon rendered through PraxisIconDirective.\n - Path: panels[].disabled\n Category: panels\n Kind: boolean\n Description: Disable panel.\n - Path: panels[].expanded\n Category: panels\n Kind: boolean\n Description: Expanded state.\n - Path: panels[].hideToggle\n Category: panels\n Kind: boolean\n Description: Hide toggle icon for panel.\n - Path: panels[].collapsedHeight\n Category: panels\n Kind: string\n Description: Collapsed header height (e.g., 48px).\n - Path: panels[].expandedHeight\n Category: panels\n Kind: string\n Description: Expanded header height (e.g., 64px).\n - Path: panels[].content\n Category: panels\n Kind: array\n Description: Dynamic field metadata list (legacy).\n - Path: panels[].content[]\n Category: panels\n Kind: object\n Description: Dynamic field metadata item.\n - Path: panels[].widgets\n Category: panels\n Kind: array\n Description: WidgetDefinition list for content.\n - Path: panels[].widgets[]\n Category: panels\n Kind: object\n Description: WidgetDefinition item.\n - Path: panels[].widgets[].id\n Category: panels\n Kind: enum\n Description: Component registry id for widget.\n - Path: panels[].widgets[].inputs\n Category: panels\n Kind: object\n Description: Inputs bound into the widget instance.\n - Path: panels[].widgets[].outputs\n Category: panels\n Kind: object\n Description: Outputs mapped to actions.\n - Path: panels[].widgets[].outputs.[outputName]\n Category: panels\n Kind: object\n Description: Output action mapping (ActionDefinition or \"emit\").\n - Path: panels[].widgets[].bindingOrder\n Category: panels\n Kind: array\n Description: Explicit input binding order.\n - Path: panels[].widgets[].bindingOrder[]\n Category: panels\n Kind: string\n Description: Input name applied first.\n - Path: panels[].actionButtons\n Category: actions\n Kind: array\n Description: Action buttons at panel footer.\n - Path: panels[].actionButtons[]\n Category: actions\n Kind: object\n Description: Action button definition.\n - Path: panels[].actionButtons[].icon\n Category: actions\n Kind: string\n Description: Action icon.\n - Path: panels[].actionButtons[].label\n Category: actions\n Kind: string\n Description: Action label.\n - Path: panels[].actionButtons[].action\n Category: actions\n Kind: string\n Description: Action identifier payload.\nCapability Notes:\n - panels[] should be merged by id or title to avoid replacing all panels.\n - appearance.customCss is injected into a <style> tag; avoid unsafe CSS from untrusted sources.\n - appearance.tokens supports limited keys used by styleCss().\n - panels[].widgets[].id must be a ComponentMetadataRegistry id.\n - If a field controlType lacks a dedicated catalog, treat it as FieldMetadata base.\n",
|
|
1562
|
+
"sourcePointer": "praxis-ui-angular/projects/praxis-expansion/src/lib/ai/expansion-ai-capabilities.ts",
|
|
1563
|
+
"contentHash": "2d3b36c05aabe4110cac4f3039fad084b74c85b8255dc525d0fd481546b0be43",
|
|
1564
|
+
"sourceKind": "component_definition",
|
|
1565
|
+
"sourceId": "praxis-expansion",
|
|
1566
|
+
"corpusVersion": "1.0.0"
|
|
1567
|
+
},
|
|
1568
|
+
{
|
|
1569
|
+
"chunkIndex": 2,
|
|
1570
|
+
"chunkKind": "authoring_manifest",
|
|
1571
|
+
"content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-expansion\",\n \"ownerPackage\": \"@praxisui/expansion\",\n \"configSchemaId\": \"ExpansionMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"config\",\n \"type\": \"ExpansionMetadata\",\n \"description\": \"Canonical accordion and panel configuration.\"\n },\n {\n \"name\": \"expansionId\",\n \"type\": \"string\",\n \"description\": \"Stable id used to derive expansion config persistence scope.\"\n },\n {\n \"name\": \"componentInstanceId\",\n \"type\": \"string\",\n \"description\": \"Optional instance discriminator for persistence scope.\"\n },\n {\n \"name\": \"context\",\n \"type\": \"Record<string, any>\",\n \"description\": \"Context passed to nested widgets.\"\n },\n {\n \"name\": \"strictValidation\",\n \"type\": \"boolean\",\n \"description\": \"Controls nested widget validation strictness.\"\n },\n {\n \"name\": \"defaultOptions\",\n \"type\": \"MatExpansionPanelDefaultOptions\",\n \"description\": \"Instance-level Material expansion defaults.\"\n },\n {\n \"name\": \"enableCustomization\",\n \"type\": \"boolean\",\n \"description\": \"Enables Settings Panel authoring surfaces.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"panel\",\n \"resolver\": \"panel-by-id-or-title\",\n \"description\": \"A panel in config.panels[].\"\n },\n {\n \"kind\": \"panelHeader\",\n \"resolver\": \"panel-by-id-or-title\",\n \"description\": \"Header title, description, icon and heights for a panel.\"\n },\n {\n \"kind\": \"panelContent\",\n \"resolver\": \"panel-content-by-id\",\n \"description\": \"Lazy panel content hosted through fields, widgets or action buttons.\"\n },\n {\n \"kind\": \"expandedState\",\n \"resolver\": \"panel-by-id-or-title\",\n \"description\": \"Panel expanded state and default expanded selection.\"\n },\n {\n \"kind\": \"disabledState\",\n \"resolver\": \"panel-by-id-or-title\",\n \"description\": \"Panel disabled state.\"\n },\n {\n \"kind\": \"layout\",\n \"resolver\": \"expansion-layout-config\",\n \"description\": \"Accordion display mode, toggle position, density and visual layout.\"\n },\n {\n \"kind\": \"behavior\",\n \"resolver\": \"expansion-behavior-config\",\n \"description\": \"Accordion multi-expand and hide-toggle behavior.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"panel.add\",\n \"title\": \"Add panel\",\n \"scope\": \"global\",\n \"targetKind\": \"panel\",\n \"target\": {\n \"kind\": \"panel\",\n \"resolver\": \"panels-array\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"id\",\n \"title\"\n ],\n \"properties\": {\n \"id\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"disabled\": {\n \"type\": \"boolean\"\n },\n \"expanded\": {\n \"type\": \"boolean\"\n },\n \"hideToggle\": {\n \"type\": \"boolean\"\n },\n \"collapsedHeight\": {\n \"type\": \"string\"\n },\n \"expandedHeight\": {\n \"type\": \"string\"\n },\n \"content\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\"\n }\n },\n \"widgets\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\"\n }\n },\n \"actionButtons\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"append-unique\",\n \"path\": \"panels[]\",\n \"key\": \"id\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"panel-id-unique\",\n \"panel-order-deterministic\",\n \"panel-content-valid\"\n ],\n \"affectedPaths\": [\n \"panels[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"panel.remove\",\n \"title\": \"Remove panel\",\n \"scope\": \"layout\",\n \"targetKind\": \"panel\",\n \"target\": {\n \"kind\": \"panel\",\n \"resolver\": \"panel-by-id-or-title\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"properties\": {\n \"replacementExpandedPanelId\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"expansion-panel-remove\",\n \"handlerContract\": {\n \"reads\": [\n \"accordion.multi\",\n \"panels[]\",\n \"panels[].id\",\n \"panels[].expanded\"\n ],\n \"writes\": [\n \"panels[]\",\n \"panels[].expanded\"\n ],\n \"identityKeys\": [\n \"panels[].id\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"properties\": {\n \"replacementExpandedPanelId\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"panel-not-found\",\n \"replacement-panel-not-found\",\n \"content-removal-not-confirmed\",\n \"single-expand-conflict\"\n ],\n \"description\": \"Removes the target panel by stable id and applies replacement expanded state when the removed panel was expanded.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"panel-exists\",\n \"default-expanded-removal-safe\",\n \"panel-content-removal-confirmed\"\n ],\n \"affectedPaths\": [\n \"panels[]\",\n \"panels[].expanded\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\",\n \"target-panel-exists\",\n \"confirmation-collected\"\n ]\n },\n {\n \"operationId\": \"panel.title.set\",\n \"title\": \"Set panel title\",\n \"scope\": \"layout\",\n \"targetKind\": \"panelHeader\",\n \"target\": {\n \"kind\": \"panelHeader\",\n \"resolver\": \"panel-by-id-or-title\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"title\"\n ],\n \"properties\": {\n \"title\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"panels[]\",\n \"key\": \"id\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"panel-exists\",\n \"panel-title-valid\"\n ],\n \"affectedPaths\": [\n \"panels[].title\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\",\n \"target-panel-exists\"\n ]\n },\n {\n \"operationId\": \"panel.description.set\",\n \"title\": \"Set panel description\",\n \"scope\": \"layout\",\n \"targetKind\": \"panelHeader\",\n \"target\": {\n \"kind\": \"panelHeader\",\n \"resolver\": \"panel-by-id-or-title\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"description\"\n ],\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"panels[]\",\n \"key\": \"id\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"panel-exists\",\n \"panel-description-valid\"\n ],\n \"affectedPaths\": [\n \"panels[].description\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\",\n \"target-panel-exists\"\n ]\n },\n {\n \"operationId\": \"panel.icon.set\",\n \"title\": \"Set panel icon\",\n \"scope\": \"layout\",\n \"targetKind\": \"panelHeader\",\n \"target\": {\n \"kind\": \"panelHeader\",\n \"resolver\": \"panel-by-id-or-title\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"icon\"\n ],\n \"properties\": {\n \"icon\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"panels[]\",\n \"key\": \"id\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"panel-exists\",\n \"panel-icon-valid\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"panels[].icon\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\",\n \"target-panel-exists\"\n ]\n },\n {\n \"operationId\": \"panel.order.set\",\n \"title\": \"Reorder panels\",\n \"scope\": \"layout\",\n \"targetKind\": \"panel\",\n \"target\": {\n \"kind\": \"panel\",\n \"resolver\": \"panel-by-id-or-title\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"beforePanelId\"\n ],\n \"properties\": {\n \"beforePanelId\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"reorder-by-key\",\n \"path\": \"panels[]\",\n \"key\": \"id\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"panel-exists\",\n \"panel-order-deterministic\"\n ],\n \"affectedPaths\": [\n \"panels[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\",\n \"target-panel-exists\"\n ]\n },\n {\n \"operationId\": \"panel.disabled.set\",\n \"title\": \"Set disabled state\",\n \"scope\": \"interaction\",\n \"targetKind\": \"disabledState\",\n \"target\": {\n \"kind\": \"disabledState\",\n \"resolver\": \"panel-by-id-or-title\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"disabled\"\n ],\n \"properties\": {\n \"disabled\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"panels[]\",\n \"key\": \"id\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"panel-exists\",\n \"disabled-expanded-compatible\"\n ],\n \"affectedPaths\": [\n \"panels[].disabled\",\n \"panels[].expanded\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\",\n \"target-panel-exists\"\n ]\n },\n {\n \"operationId\": \"behavior.multiExpand.set\",\n \"title\": \"Set multi-expand behavior\",\n \"scope\": \"interaction\",\n \"targetKind\": \"behavior\",\n \"target\": {\n \"kind\": \"behavior\",\n \"resolver\": \"expansion-behavior-config\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"multi\"\n ],\n \"properties\": {\n \"multi\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"expansion-multi-expand-set\",\n \"handlerContract\": {\n \"reads\": [\n \"accordion.multi\",\n \"panels[]\",\n \"panels[].id\",\n \"panels[].expanded\"\n ],\n \"writes\": [\n \"accordion.multi\",\n \"panels[].expanded\"\n ],\n \"identityKeys\": [\n \"panels[].id\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"multi\"\n ],\n \"properties\": {\n \"multi\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"multiple-expanded-panels-conflict\",\n \"panel-id-missing\"\n ],\n \"description\": \"Sets accordion.multi and collapses competing expanded panels when switching to single-expand behavior.\"\n }\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"multi-expand-default-compatible\",\n \"accordion-values-valid\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"accordion.multi\",\n \"panels[].expanded\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"behavior.defaultExpanded.set\",\n \"title\": \"Set default expanded panel\",\n \"scope\": \"interaction\",\n \"targetKind\": \"expandedState\",\n \"target\": {\n \"kind\": \"expandedState\",\n \"resolver\": \"panel-by-id-or-title\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"expanded\"\n ],\n \"properties\": {\n \"expanded\": {\n \"type\": \"boolean\"\n },\n \"collapseOthers\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"expansion-default-expanded-upsert\",\n \"handlerContract\": {\n \"reads\": [\n \"accordion.multi\",\n \"panels[]\",\n \"panels[].id\",\n \"panels[].expanded\",\n \"panels[].disabled\"\n ],\n \"writes\": [\n \"panels[].expanded\"\n ],\n \"identityKeys\": [\n \"panels[].id\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"panelId\",\n \"expanded\"\n ],\n \"properties\": {\n \"panelId\": {\n \"type\": \"string\"\n },\n \"expanded\": {\n \"type\": \"boolean\"\n },\n \"collapseOthers\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"panel-not-found\",\n \"panel-disabled\",\n \"single-expand-conflict\"\n ],\n \"description\": \"Sets a panel expanded state and collapses competing panels when accordion.multi is false.\"\n }\n }\n ],\n \"validators\": [\n \"panel-exists\",\n \"default-expanded-panel-exists\",\n \"multi-expand-default-compatible\",\n \"disabled-expanded-compatible\"\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"affectedPaths\": [\n \"panels[].expanded\",\n \"accordion.multi\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\",\n \"target-panel-exists\"\n ]\n },\n {\n \"operationId\": \"panel.content.set\",\n \"title\": \"Set panel content\",\n \"scope\": \"layout\",\n \"targetKind\": \"panelContent\",\n \"target\": {\n \"kind\": \"panelContent\",\n \"resolver\": \"panel-content-by-id\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"id\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"disabled\": {\n \"type\": \"boolean\"\n },\n \"expanded\": {\n \"type\": \"boolean\"\n },\n \"hideToggle\": {\n \"type\": \"boolean\"\n },\n \"collapsedHeight\": {\n \"type\": \"string\"\n },\n \"expandedHeight\": {\n \"type\": \"string\"\n },\n \"content\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\"\n }\n },\n \"widgets\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\"\n }\n },\n \"actionButtons\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"panels[]\",\n \"key\": \"id\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"panel-exists\",\n \"panel-content-valid\",\n \"lazy-content-compatible\",\n \"nested-widget-contract-delegated\"\n ],\n \"affectedPaths\": [\n \"panels[].content\",\n \"panels[].widgets\",\n \"panels[].actionButtons\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"preconditions\": [\n \"config-initialized\",\n \"target-panel-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"panel-id-unique\",\n \"level\": \"error\",\n \"code\": \"PEXP001\",\n \"description\": \"Panel ids must be unique and stable within config.panels[].\"\n },\n {\n \"validatorId\": \"panel-exists\",\n \"level\": \"error\",\n \"code\": \"PEXP002\",\n \"description\": \"Target panel must exist before applying the operation.\"\n },\n {\n \"validatorId\": \"panel-order-deterministic\",\n \"level\": \"error\",\n \"code\": \"PEXP003\",\n \"description\": \"Panel ordering must use stable ids, not transient array index as identity.\"\n },\n {\n \"validatorId\": \"panel-title-valid\",\n \"level\": \"error\",\n \"code\": \"PEXP004\",\n \"description\": \"Panel title must be a non-empty text value after localization/domain projection.\"\n },\n {\n \"validatorId\": \"panel-description-valid\",\n \"level\": \"warning\",\n \"code\": \"PEXP005\",\n \"description\": \"Panel description should remain plain header-support text and not replace panel content.\"\n },\n {\n \"validatorId\": \"panel-icon-valid\",\n \"level\": \"warning\",\n \"code\": \"PEXP006\",\n \"description\": \"Panel icon metadata must remain compatible with PraxisIconDirective and editor round-trip.\"\n },\n {\n \"validatorId\": \"panel-content-valid\",\n \"level\": \"error\",\n \"code\": \"PEXP007\",\n \"description\": \"Panel content must remain valid FieldMetadata[], WidgetDefinition[] or action button metadata.\"\n },\n {\n \"validatorId\": \"panel-content-removal-confirmed\",\n \"level\": \"error\",\n \"code\": \"PEXP008\",\n \"description\": \"Removing a panel with fields, widgets or action buttons is destructive and requires confirmation.\"\n },\n {\n \"validatorId\": \"default-expanded-panel-exists\",\n \"level\": \"error\",\n \"code\": \"PEXP009\",\n \"description\": \"Default expanded state must reference an existing panel id.\"\n },\n {\n \"validatorId\": \"default-expanded-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PEXP010\",\n \"description\": \"Removing an expanded panel requires deterministic replacement state or explicit confirmation.\"\n },\n {\n \"validatorId\": \"multi-expand-default-compatible\",\n \"level\": \"error\",\n \"code\": \"PEXP011\",\n \"description\": \"When accordion.multi is false, at most one panel may be marked expanded by default.\"\n },\n {\n \"validatorId\": \"disabled-expanded-compatible\",\n \"level\": \"warning\",\n \"code\": \"PEXP012\",\n \"description\": \"A disabled panel should not be the only expanded/default focus target without explicit intent.\"\n },\n {\n \"validatorId\": \"accordion-values-valid\",\n \"level\": \"error\",\n \"code\": \"PEXP013\",\n \"description\": \"Accordion behavior values must match ExpansionMetadata and Angular Material expansion bindings.\"\n },\n {\n \"validatorId\": \"lazy-content-compatible\",\n \"level\": \"info\",\n \"code\": \"PEXP015\",\n \"description\": \"Panel content remains lazy through matExpansionPanelContent and should not require eager child runtime state.\"\n },\n {\n \"validatorId\": \"nested-widget-contract-delegated\",\n \"level\": \"info\",\n \"code\": \"PEXP016\",\n \"description\": \"Nested widget content remains governed by child component contracts and component-port nestedPath semantics.\"\n },\n {\n \"validatorId\": \"editor-runtime-round-trip\",\n \"level\": \"error\",\n \"code\": \"PEXP017\",\n \"description\": \"Settings Panel editor, runtime persistence and registry projection must preserve panel ids, order, icons and expanded state.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Operations must preserve stable panel ids; array index may be used only as a resolver fallback, never as canonical identity.\",\n \"Settings Panel editor, runtime persistence and registry projection must round-trip ExpansionMetadata without losing panel ids, order, icons or expanded state.\",\n \"When accordion.multi is false, authoring must collapse competing panels or fail validation instead of producing multiple default-expanded panels.\",\n \"Lazy panel content remains represented by panels[].content, panels[].widgets and panels[].actionButtons; authoring cannot require eager child component instances.\",\n \"Nested widgets remain delegated through WidgetDefinition and component-port nestedPath semantics instead of being redefined by the expansion contract.\"\n ],\n \"examples\": [\n {\n \"id\": \"add-summary-panel\",\n \"request\": \"Add a summary panel before the audit panel.\",\n \"operationId\": \"panel.add\",\n \"params\": {\n \"id\": \"summary\",\n \"title\": \"Summary\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"rename-details-panel\",\n \"request\": \"Rename details to Account details.\",\n \"operationId\": \"panel.title.set\",\n \"target\": \"details\",\n \"params\": {\n \"title\": \"Account details\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"describe-audit-panel\",\n \"request\": \"Set audit panel description to Recent changes.\",\n \"operationId\": \"panel.description.set\",\n \"target\": \"audit\",\n \"params\": {\n \"description\": \"Recent changes\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-panel-icon\",\n \"request\": \"Use the info icon on the summary panel.\",\n \"operationId\": \"panel.icon.set\",\n \"target\": \"summary\",\n \"params\": {\n \"icon\": \"info\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-default-expanded-panel\",\n \"request\": \"Open the summary panel by default.\",\n \"operationId\": \"behavior.defaultExpanded.set\",\n \"target\": \"summary\",\n \"params\": {\n \"expanded\": true,\n \"collapseOthers\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"enable-multi-expand\",\n \"request\": \"Allow multiple panels to stay open.\",\n \"operationId\": \"behavior.multiExpand.set\",\n \"params\": {\n \"multi\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"disable-archive-panel\",\n \"request\": \"Disable the archive panel.\",\n \"operationId\": \"panel.disabled.set\",\n \"target\": \"archive\",\n \"params\": {\n \"disabled\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-missing-default-expanded\",\n \"request\": \"Open the missing panel by default.\",\n \"operationId\": \"behavior.defaultExpanded.set\",\n \"target\": \"missing\",\n \"params\": {\n \"expanded\": true\n },\n \"isPositive\": false\n },\n {\n \"id\": \"reject-duplicate-panel-id\",\n \"request\": \"Add another panel with id summary.\",\n \"operationId\": \"panel.add\",\n \"params\": {\n \"id\": \"summary\",\n \"title\": \"Duplicate summary\"\n },\n \"isPositive\": false\n },\n {\n \"id\": \"confirm-remove-content-panel\",\n \"request\": \"Remove the details panel that contains widgets.\",\n \"operationId\": \"panel.remove\",\n \"target\": \"details\",\n \"params\": {\n \"replacementExpandedPanelId\": \"summary\"\n },\n \"isPositive\": true\n }\n ]\n}",
|
|
1572
|
+
"sourcePointer": "praxis-ui-angular/projects/praxis-expansion/src/lib/ai/praxis-expansion-authoring-manifest.ts",
|
|
1573
|
+
"contentHash": "e6c84530c6f11f875816c5a4832d3e3e1f70884b37a1aee2cf89a6b722ab546c",
|
|
1574
|
+
"sourceKind": "component_definition",
|
|
1575
|
+
"sourceId": "praxis-expansion",
|
|
1576
|
+
"corpusVersion": "1.0.0"
|
|
1577
|
+
},
|
|
1578
|
+
{
|
|
1579
|
+
"chunkIndex": 3,
|
|
1580
|
+
"chunkKind": "context_pack",
|
|
1581
|
+
"content": "{\n \"componentContext\": {\n \"version\": \"v1\",\n \"optionsByPath\": {\n \"appearance.density\": {\n \"mode\": \"enum\",\n \"options\": [\n {\n \"value\": \"compact\",\n \"label\": \"Compact\"\n },\n {\n \"value\": \"comfortable\",\n \"label\": \"Comfortable\"\n },\n {\n \"value\": \"spacious\",\n \"label\": \"Spacious\"\n }\n ]\n },\n \"accordion.displayMode\": {\n \"mode\": \"enum\",\n \"options\": [\n {\n \"value\": \"default\",\n \"label\": \"Default\"\n },\n {\n \"value\": \"flat\",\n \"label\": \"Flat\"\n }\n ]\n },\n \"accordion.togglePosition\": {\n \"mode\": \"enum\",\n \"options\": [\n {\n \"value\": \"before\",\n \"label\": \"Before\"\n },\n {\n \"value\": \"after\",\n \"label\": \"After\"\n }\n ]\n }\n },\n \"actionCatalog\": [\n {\n \"id\": \"appearance.density.set\",\n \"intentExamples\": [\n \"density\",\n \"compact\",\n \"spacious\"\n ],\n \"patchTemplate\": {\n \"appearance\": {\n \"density\": \"{{value}}\"\n }\n }\n },\n {\n \"id\": \"accordion.multi.enable\",\n \"intentExamples\": [\n \"multiple panels\",\n \"multi expand\",\n \"allow multiple\"\n ],\n \"patchTemplate\": {\n \"accordion\": {\n \"multi\": true\n }\n }\n },\n {\n \"id\": \"accordion.multi.disable\",\n \"intentExamples\": [\n \"single panel\",\n \"only one open\"\n ],\n \"patchTemplate\": {\n \"accordion\": {\n \"multi\": false\n }\n }\n },\n {\n \"id\": \"accordion.hideToggle.enable\",\n \"intentExamples\": [\n \"hide toggle\",\n \"no caret\"\n ],\n \"patchTemplate\": {\n \"accordion\": {\n \"hideToggle\": true\n }\n }\n },\n {\n \"id\": \"accordion.hideToggle.disable\",\n \"intentExamples\": [\n \"show toggle\",\n \"show caret\"\n ],\n \"patchTemplate\": {\n \"accordion\": {\n \"hideToggle\": false\n }\n }\n },\n {\n \"id\": \"panel.add\",\n \"intentExamples\": [\n \"add panel\",\n \"new panel\",\n \"create panel\"\n ],\n \"patchTemplate\": {\n \"panels\": [\n {\n \"id\": \"{{target}}\",\n \"title\": \"{{value}}\"\n }\n ]\n }\n },\n {\n \"id\": \"panel.title.set\",\n \"intentExamples\": [\n \"rename panel\",\n \"panel title\"\n ],\n \"patchTemplate\": {\n \"panels\": [\n {\n \"id\": \"{{target}}\",\n \"title\": \"{{value}}\"\n }\n ]\n }\n },\n {\n \"id\": \"panel.description.set\",\n \"intentExamples\": [\n \"panel description\",\n \"subtitle\"\n ],\n \"patchTemplate\": {\n \"panels\": [\n {\n \"id\": \"{{target}}\",\n \"description\": \"{{value}}\"\n }\n ]\n }\n },\n {\n \"id\": \"panel.expand\",\n \"intentExamples\": [\n \"expand panel\",\n \"open panel\"\n ],\n \"patchTemplate\": {\n \"panels\": [\n {\n \"id\": \"{{target}}\",\n \"expanded\": true\n }\n ]\n }\n },\n {\n \"id\": \"panel.collapse\",\n \"intentExamples\": [\n \"collapse panel\",\n \"close panel\"\n ],\n \"patchTemplate\": {\n \"panels\": [\n {\n \"id\": \"{{target}}\",\n \"expanded\": false\n }\n ]\n }\n },\n {\n \"id\": \"panel.disable\",\n \"intentExamples\": [\n \"disable panel\",\n \"lock panel\"\n ],\n \"patchTemplate\": {\n \"panels\": [\n {\n \"id\": \"{{target}}\",\n \"disabled\": true\n }\n ]\n }\n },\n {\n \"id\": \"panel.enable\",\n \"intentExamples\": [\n \"enable panel\",\n \"unlock panel\"\n ],\n \"patchTemplate\": {\n \"panels\": [\n {\n \"id\": \"{{target}}\",\n \"disabled\": false\n }\n ]\n }\n },\n {\n \"id\": \"panel.hideToggle.enable\",\n \"intentExamples\": [\n \"hide panel toggle\",\n \"no panel toggle\"\n ],\n \"patchTemplate\": {\n \"panels\": [\n {\n \"id\": \"{{target}}\",\n \"hideToggle\": true\n }\n ]\n }\n },\n {\n \"id\": \"panel.hideToggle.disable\",\n \"intentExamples\": [\n \"show panel toggle\",\n \"panel caret\"\n ],\n \"patchTemplate\": {\n \"panels\": [\n {\n \"id\": \"{{target}}\",\n \"hideToggle\": false\n }\n ]\n }\n }\n ],\n \"fieldResolvers\": {\n \"panels[]\": [\n \"id\",\n \"title\"\n ]\n },\n \"hints\": [\n \"Use panels[].id or panels[].title as merge keys; avoid array indexes.\",\n \"Panels merge by id/title; prefer patching a single panel at a time.\",\n \"DOC: Widget purpose: accordion/expansion panels with optional fields or widgets.\",\n \"DOC: Host inputs: expansionId (required) and config (optional).\",\n \"DOC: Minimal config: panels[] with title for each panel.\",\n \"DOC: Panel content can be fields (content) or widgets (widgets).\"\n ]\n }\n}",
|
|
1582
|
+
"sourcePointer": "praxis-ui-angular/projects/praxis-expansion/src/lib/ai/expansion-context-pack.ts",
|
|
1583
|
+
"contentHash": "2ca3138a6b14f844047857420c7881393f25f13420b0d29b18c58de0d33485ea",
|
|
1584
|
+
"sourceKind": "component_definition",
|
|
1585
|
+
"sourceId": "praxis-expansion",
|
|
1586
|
+
"corpusVersion": "1.0.0"
|
|
1587
|
+
},
|
|
1588
|
+
{
|
|
1589
|
+
"chunkIndex": 4,
|
|
1590
|
+
"chunkKind": "recipe",
|
|
1591
|
+
"content": "{\n \"_comment\": \"Recipe for Praxis Expansion configuration with panels and form content.\",\n \"templateMeta\": {\n \"registryKey\": \"praxis-expansion\",\n \"variantId\": \"base\",\n \"useWhen\": \"Base expansion panel configuration.\",\n \"examplePrompts\": [\n \"create an expansion panel group\",\n \"add panels with icons and descriptions\"\n ]\n },\n \"config\": {\n \"appearance\": {\n \"density\": \"comfortable\",\n \"themeClass\": \"expansion-theme\",\n \"tokens\": {\n \"header-background-color\": \"#f5f7fb\"\n }\n },\n \"accordion\": {\n \"multi\": true,\n \"displayMode\": \"default\",\n \"togglePosition\": \"after\",\n \"hideToggle\": false,\n \"id\": \"profile-expansion\"\n },\n \"panels\": [\n {\n \"id\": \"panel-profile\",\n \"title\": \"Profile\",\n \"description\": \"Basic information\",\n \"expanded\": true,\n \"content\": [\n {\n \"name\": \"fullName\",\n \"label\": \"Full name\",\n \"controlType\": \"input\",\n \"inputType\": \"text\",\n \"required\": true\n },\n {\n \"name\": \"email\",\n \"label\": \"Email\",\n \"controlType\": \"input\",\n \"inputType\": \"email\"\n },\n {\n \"name\": \"status\",\n \"label\": \"Status\",\n \"controlType\": \"select\",\n \"options\": [\n { \"label\": \"Active\", \"value\": \"active\" },\n { \"label\": \"Inactive\", \"value\": \"inactive\" }\n ]\n }\n ],\n \"actionButtons\": [\n { \"label\": \"Save\", \"icon\": \"save\", \"action\": \"save-profile\" }\n ]\n },\n {\n \"id\": \"panel-preferences\",\n \"title\": \"Preferences\",\n \"description\": \"Notifications and defaults\",\n \"content\": [\n {\n \"name\": \"notifyEmail\",\n \"label\": \"Email notifications\",\n \"controlType\": \"checkbox\"\n },\n {\n \"name\": \"timezone\",\n \"label\": \"Timezone\",\n \"controlType\": \"select\",\n \"options\": [\n { \"label\": \"UTC-03\", \"value\": \"America/Sao_Paulo\" },\n { \"label\": \"UTC\", \"value\": \"UTC\" }\n ]\n }\n ]\n }\n ]\n }\n}\n",
|
|
1592
|
+
"sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-expansion.json",
|
|
1593
|
+
"contentHash": "ef04c982030a2e5fe5bdec22ad67625de1e2533aff3ec1b3909b740f12b9b990",
|
|
1594
|
+
"sourceKind": "component_definition",
|
|
1595
|
+
"sourceId": "praxis-expansion",
|
|
1596
|
+
"corpusVersion": "1.0.0"
|
|
1597
|
+
}
|
|
1598
|
+
]
|
|
1599
|
+
}
|
|
1600
|
+
},
|
|
1601
|
+
"note": "Package-scoped Praxis component registry for source-free agent discovery. Use the canonical ingestion registry for cross-package aggregate analysis."
|
|
1602
|
+
}
|