@praxisui/metadata-editor 9.0.0-beta.8 → 9.0.0-beta.80
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 +15 -0
- package/ai/component-registry.json +1629 -0
- package/fesm2022/praxisui-metadata-editor.mjs +1887 -186
- package/package.json +10 -6
- package/types/praxisui-metadata-editor.d.ts +22 -4
|
@@ -0,0 +1,1629 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": "1.0.0",
|
|
3
|
+
"generatedAt": "2026-07-19T22:17:32.055Z",
|
|
4
|
+
"packageName": "@praxisui/metadata-editor",
|
|
5
|
+
"packageVersion": "9.0.0-beta.80",
|
|
6
|
+
"sourceRegistry": "praxis-component-registry-ingestion",
|
|
7
|
+
"sourceRegistryVersion": "1.0.0",
|
|
8
|
+
"componentCount": 1,
|
|
9
|
+
"components": {
|
|
10
|
+
"praxis-metadata-editor": {
|
|
11
|
+
"id": "praxis-metadata-editor",
|
|
12
|
+
"description": "Editor for field metadata and schema helpers.",
|
|
13
|
+
"inputs": [
|
|
14
|
+
{
|
|
15
|
+
"name": "controlType",
|
|
16
|
+
"type": "FieldControlType",
|
|
17
|
+
"required": false,
|
|
18
|
+
"description": "Tipo de controle do campo alvo.",
|
|
19
|
+
"label": "Tipo de controle"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"name": "seed",
|
|
23
|
+
"type": "Partial<FieldDefinition>",
|
|
24
|
+
"required": false,
|
|
25
|
+
"description": "Valores iniciais do FieldDefinition para hidratar o editor.",
|
|
26
|
+
"label": "Seed"
|
|
27
|
+
}
|
|
28
|
+
],
|
|
29
|
+
"outputs": [
|
|
30
|
+
{
|
|
31
|
+
"name": "applied",
|
|
32
|
+
"type": "Partial<FieldDefinition>",
|
|
33
|
+
"required": false,
|
|
34
|
+
"description": "Disparado quando o patch de metadata e aplicado.",
|
|
35
|
+
"label": "Aplicado"
|
|
36
|
+
},
|
|
37
|
+
{
|
|
38
|
+
"name": "cancel",
|
|
39
|
+
"type": "void",
|
|
40
|
+
"required": false,
|
|
41
|
+
"description": "Disparado quando o usuario cancela a edicao.",
|
|
42
|
+
"label": "Cancelar"
|
|
43
|
+
}
|
|
44
|
+
],
|
|
45
|
+
"configSchemaId": null,
|
|
46
|
+
"selector": "praxis-field-metadata-editor",
|
|
47
|
+
"friendlyName": "Praxis Metadata Editor",
|
|
48
|
+
"tags": [
|
|
49
|
+
"widget",
|
|
50
|
+
"metadata",
|
|
51
|
+
"configurable"
|
|
52
|
+
],
|
|
53
|
+
"lib": "@praxisui/metadata-editor",
|
|
54
|
+
"source": "projects/praxis-metadata-editor/src/lib/praxis-metadata-editor.metadata.ts",
|
|
55
|
+
"exportName": "PRAXIS_METADATA_EDITOR_COMPONENT_METADATA",
|
|
56
|
+
"authoringManifest": {
|
|
57
|
+
"schemaVersion": "1.0.0",
|
|
58
|
+
"componentId": "praxis-metadata-editor",
|
|
59
|
+
"ownerPackage": "@praxisui/metadata-editor",
|
|
60
|
+
"configSchemaId": "FieldMetadata",
|
|
61
|
+
"manifestVersion": "1.0.0",
|
|
62
|
+
"runtimeInputs": [
|
|
63
|
+
{
|
|
64
|
+
"name": "controlType",
|
|
65
|
+
"type": "FieldControlType",
|
|
66
|
+
"description": "Canonical control type used to resolve editor property coverage."
|
|
67
|
+
},
|
|
68
|
+
{
|
|
69
|
+
"name": "seed",
|
|
70
|
+
"type": "Partial<FieldMetadata | FieldDefinition>",
|
|
71
|
+
"description": "Initial canonical field metadata used to hydrate the editor."
|
|
72
|
+
},
|
|
73
|
+
{
|
|
74
|
+
"name": "fields",
|
|
75
|
+
"type": "Array<FieldMetadata | FieldDefinition>",
|
|
76
|
+
"description": "Available fields used by cascade authoring and context validation."
|
|
77
|
+
},
|
|
78
|
+
{
|
|
79
|
+
"name": "properties",
|
|
80
|
+
"type": "EditorProperty[]",
|
|
81
|
+
"description": "Renderer property catalog resolved from ConfigRegistryService."
|
|
82
|
+
},
|
|
83
|
+
{
|
|
84
|
+
"name": "form",
|
|
85
|
+
"type": "FormGroup",
|
|
86
|
+
"description": "Dynamic form generated from canonical editor properties by DynamicFormFactoryService."
|
|
87
|
+
}
|
|
88
|
+
],
|
|
89
|
+
"editableTargets": [
|
|
90
|
+
{
|
|
91
|
+
"kind": "fieldMetadata",
|
|
92
|
+
"resolver": "field-metadata-json-path",
|
|
93
|
+
"description": "Canonical FieldMetadata root and property paths."
|
|
94
|
+
},
|
|
95
|
+
{
|
|
96
|
+
"kind": "controlType",
|
|
97
|
+
"resolver": "dynamic-fields-control-type-discovery",
|
|
98
|
+
"description": "Control type selected from dynamic-fields discovery and editor config registry."
|
|
99
|
+
},
|
|
100
|
+
{
|
|
101
|
+
"kind": "optionSource",
|
|
102
|
+
"resolver": "field-metadata-option-source",
|
|
103
|
+
"description": "Canonical option source including backend x-ui option source fields where applicable."
|
|
104
|
+
},
|
|
105
|
+
{
|
|
106
|
+
"kind": "cascade",
|
|
107
|
+
"resolver": "metadata-editor-cascade-rules",
|
|
108
|
+
"description": "Cascade dependencies and dependency filter mappings edited through CascadeManagerTab."
|
|
109
|
+
},
|
|
110
|
+
{
|
|
111
|
+
"kind": "renderer",
|
|
112
|
+
"resolver": "metadata-editor-renderer-property",
|
|
113
|
+
"description": "Dynamic editor renderer property coverage and editor component mapping."
|
|
114
|
+
},
|
|
115
|
+
{
|
|
116
|
+
"kind": "validation",
|
|
117
|
+
"resolver": "field-metadata-validation-rules",
|
|
118
|
+
"description": "Field validation rules and contextual validators."
|
|
119
|
+
},
|
|
120
|
+
{
|
|
121
|
+
"kind": "dateRangeShortcuts",
|
|
122
|
+
"resolver": "metadata-editor-date-range-shortcut-catalog",
|
|
123
|
+
"description": "Governed static date range shortcut catalog for dateRange and inlineDateRange metadata."
|
|
124
|
+
},
|
|
125
|
+
{
|
|
126
|
+
"kind": "contextHint",
|
|
127
|
+
"resolver": "metadata-editor-context-hints",
|
|
128
|
+
"description": "Authoring hints, help text and contextual guidance for metadata editors."
|
|
129
|
+
},
|
|
130
|
+
{
|
|
131
|
+
"kind": "normalization",
|
|
132
|
+
"resolver": "metadata-editor-schema-normalizer",
|
|
133
|
+
"description": "Schema normalization and seed hydration rules."
|
|
134
|
+
}
|
|
135
|
+
],
|
|
136
|
+
"operations": [
|
|
137
|
+
{
|
|
138
|
+
"operationId": "fieldMetadata.property.set",
|
|
139
|
+
"title": "Set FieldMetadata property",
|
|
140
|
+
"scope": "fieldMetadataPath",
|
|
141
|
+
"targetKind": "fieldMetadata",
|
|
142
|
+
"target": {
|
|
143
|
+
"kind": "fieldMetadata",
|
|
144
|
+
"resolver": "field-metadata-json-path",
|
|
145
|
+
"ambiguityPolicy": "fail",
|
|
146
|
+
"required": true
|
|
147
|
+
},
|
|
148
|
+
"inputSchema": {
|
|
149
|
+
"type": "object",
|
|
150
|
+
"required": [
|
|
151
|
+
"path",
|
|
152
|
+
"value"
|
|
153
|
+
],
|
|
154
|
+
"properties": {
|
|
155
|
+
"path": {
|
|
156
|
+
"enum": [
|
|
157
|
+
"name",
|
|
158
|
+
"label",
|
|
159
|
+
"description",
|
|
160
|
+
"controlType",
|
|
161
|
+
"placeholder",
|
|
162
|
+
"defaultValue",
|
|
163
|
+
"group",
|
|
164
|
+
"order",
|
|
165
|
+
"required",
|
|
166
|
+
"disabled",
|
|
167
|
+
"readOnly",
|
|
168
|
+
"hidden",
|
|
169
|
+
"source",
|
|
170
|
+
"transient",
|
|
171
|
+
"submitPolicy",
|
|
172
|
+
"hint",
|
|
173
|
+
"helpText",
|
|
174
|
+
"tooltip",
|
|
175
|
+
"valuePresentation",
|
|
176
|
+
"presentation",
|
|
177
|
+
"presentation.presenter",
|
|
178
|
+
"presentation.tone",
|
|
179
|
+
"presentation.appearance",
|
|
180
|
+
"presentation.icon",
|
|
181
|
+
"presentation.label",
|
|
182
|
+
"presentation.badge",
|
|
183
|
+
"presentation.tooltip",
|
|
184
|
+
"presentationRules",
|
|
185
|
+
"options",
|
|
186
|
+
"optionSource",
|
|
187
|
+
"validators",
|
|
188
|
+
"conditionalRequired",
|
|
189
|
+
"conditionalDisplay",
|
|
190
|
+
"visibleIn",
|
|
191
|
+
"ariaLabel",
|
|
192
|
+
"ariaDescribedBy"
|
|
193
|
+
]
|
|
194
|
+
},
|
|
195
|
+
"value": {},
|
|
196
|
+
"merge": {
|
|
197
|
+
"type": "boolean"
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
},
|
|
201
|
+
"effects": [
|
|
202
|
+
{
|
|
203
|
+
"kind": "compile-domain-patch",
|
|
204
|
+
"handler": "metadata-field-property-set",
|
|
205
|
+
"handlerContract": {
|
|
206
|
+
"reads": [
|
|
207
|
+
"fieldMetadata",
|
|
208
|
+
"fieldMetadataPath",
|
|
209
|
+
"SchemaNormalizerService"
|
|
210
|
+
],
|
|
211
|
+
"writes": [
|
|
212
|
+
"fieldMetadata"
|
|
213
|
+
],
|
|
214
|
+
"identityKeys": [
|
|
215
|
+
"field.name",
|
|
216
|
+
"path"
|
|
217
|
+
],
|
|
218
|
+
"failureModes": [
|
|
219
|
+
"unknown-field-metadata-path",
|
|
220
|
+
"non-canonical-shape",
|
|
221
|
+
"readonly-field",
|
|
222
|
+
"normalization-failed"
|
|
223
|
+
],
|
|
224
|
+
"description": "Sets a canonical FieldMetadata property through a governed metadata path and re-runs schema normalization."
|
|
225
|
+
}
|
|
226
|
+
}
|
|
227
|
+
],
|
|
228
|
+
"destructive": false,
|
|
229
|
+
"requiresConfirmation": false,
|
|
230
|
+
"validators": [
|
|
231
|
+
"field-metadata-shape-canonical",
|
|
232
|
+
"field-path-supported-by-editor",
|
|
233
|
+
"metadata-round-trip"
|
|
234
|
+
],
|
|
235
|
+
"affectedPaths": [
|
|
236
|
+
"fieldMetadata"
|
|
237
|
+
],
|
|
238
|
+
"submissionImpact": "affects-schema-backed-data",
|
|
239
|
+
"preconditions": [
|
|
240
|
+
"field-metadata-loaded"
|
|
241
|
+
]
|
|
242
|
+
},
|
|
243
|
+
{
|
|
244
|
+
"operationId": "controlType.set",
|
|
245
|
+
"title": "Set control type",
|
|
246
|
+
"scope": "controlType",
|
|
247
|
+
"targetKind": "controlType",
|
|
248
|
+
"target": {
|
|
249
|
+
"kind": "controlType",
|
|
250
|
+
"resolver": "dynamic-fields-control-type-discovery",
|
|
251
|
+
"ambiguityPolicy": "fail",
|
|
252
|
+
"required": true
|
|
253
|
+
},
|
|
254
|
+
"inputSchema": {
|
|
255
|
+
"type": "object",
|
|
256
|
+
"required": [
|
|
257
|
+
"controlType"
|
|
258
|
+
],
|
|
259
|
+
"properties": {
|
|
260
|
+
"controlType": {
|
|
261
|
+
"type": "string"
|
|
262
|
+
},
|
|
263
|
+
"preserveCompatibleProperties": {
|
|
264
|
+
"type": "boolean"
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
},
|
|
268
|
+
"effects": [
|
|
269
|
+
{
|
|
270
|
+
"kind": "compile-domain-patch",
|
|
271
|
+
"handler": "metadata-control-type-set",
|
|
272
|
+
"handlerContract": {
|
|
273
|
+
"reads": [
|
|
274
|
+
"FieldControlType",
|
|
275
|
+
"ConfigRegistryService",
|
|
276
|
+
"dynamic-fields-discovery",
|
|
277
|
+
"fieldMetadata"
|
|
278
|
+
],
|
|
279
|
+
"writes": [
|
|
280
|
+
"fieldMetadata.controlType",
|
|
281
|
+
"properties",
|
|
282
|
+
"normalizedSeed"
|
|
283
|
+
],
|
|
284
|
+
"identityKeys": [
|
|
285
|
+
"field.name",
|
|
286
|
+
"controlType"
|
|
287
|
+
],
|
|
288
|
+
"inputSchema": {
|
|
289
|
+
"type": "object",
|
|
290
|
+
"required": [
|
|
291
|
+
"controlType"
|
|
292
|
+
],
|
|
293
|
+
"properties": {
|
|
294
|
+
"controlType": {
|
|
295
|
+
"type": "string"
|
|
296
|
+
},
|
|
297
|
+
"preserveCompatibleProperties": {
|
|
298
|
+
"type": "boolean"
|
|
299
|
+
}
|
|
300
|
+
}
|
|
301
|
+
},
|
|
302
|
+
"failureModes": [
|
|
303
|
+
"control-type-not-discovered",
|
|
304
|
+
"editor-coverage-missing",
|
|
305
|
+
"incompatible-metadata-preservation"
|
|
306
|
+
],
|
|
307
|
+
"description": "Changes control type only when dynamic-fields discovery and metadata-editor config registry both expose renderer/editor coverage."
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
],
|
|
311
|
+
"destructive": false,
|
|
312
|
+
"requiresConfirmation": false,
|
|
313
|
+
"validators": [
|
|
314
|
+
"control-type-exists-in-discovery",
|
|
315
|
+
"editor-coverage-exists",
|
|
316
|
+
"metadata-round-trip"
|
|
317
|
+
],
|
|
318
|
+
"affectedPaths": [
|
|
319
|
+
"fieldMetadata.controlType",
|
|
320
|
+
"properties",
|
|
321
|
+
"normalizedSeed"
|
|
322
|
+
],
|
|
323
|
+
"submissionImpact": "affects-schema-backed-data",
|
|
324
|
+
"preconditions": [
|
|
325
|
+
"dynamic-fields-discovery-loaded"
|
|
326
|
+
]
|
|
327
|
+
},
|
|
328
|
+
{
|
|
329
|
+
"operationId": "optionSource.configure",
|
|
330
|
+
"title": "Configure option source",
|
|
331
|
+
"scope": "dataBinding",
|
|
332
|
+
"targetKind": "optionSource",
|
|
333
|
+
"target": {
|
|
334
|
+
"kind": "optionSource",
|
|
335
|
+
"resolver": "field-metadata-option-source",
|
|
336
|
+
"ambiguityPolicy": "fail",
|
|
337
|
+
"required": false
|
|
338
|
+
},
|
|
339
|
+
"inputSchema": {
|
|
340
|
+
"type": "object",
|
|
341
|
+
"minProperties": 1,
|
|
342
|
+
"properties": {
|
|
343
|
+
"kind": {
|
|
344
|
+
"enum": [
|
|
345
|
+
"static",
|
|
346
|
+
"remote",
|
|
347
|
+
"resource",
|
|
348
|
+
"lookup"
|
|
349
|
+
]
|
|
350
|
+
},
|
|
351
|
+
"resource": {
|
|
352
|
+
"type": "string"
|
|
353
|
+
},
|
|
354
|
+
"endpoint": {
|
|
355
|
+
"type": "string"
|
|
356
|
+
},
|
|
357
|
+
"valueField": {
|
|
358
|
+
"type": "string"
|
|
359
|
+
},
|
|
360
|
+
"labelField": {
|
|
361
|
+
"type": "string"
|
|
362
|
+
},
|
|
363
|
+
"dependsOn": {
|
|
364
|
+
"type": "string"
|
|
365
|
+
},
|
|
366
|
+
"dependencyFilterMap": {
|
|
367
|
+
"type": "object"
|
|
368
|
+
},
|
|
369
|
+
"display": {
|
|
370
|
+
"type": "object",
|
|
371
|
+
"properties": {
|
|
372
|
+
"preset": {
|
|
373
|
+
"enum": [
|
|
374
|
+
"compact",
|
|
375
|
+
"rich",
|
|
376
|
+
"directory",
|
|
377
|
+
"status",
|
|
378
|
+
"reference",
|
|
379
|
+
"hierarchical"
|
|
380
|
+
]
|
|
381
|
+
},
|
|
382
|
+
"usage": {
|
|
383
|
+
"enum": [
|
|
384
|
+
"form",
|
|
385
|
+
"filter",
|
|
386
|
+
"table-cell",
|
|
387
|
+
"dashboard",
|
|
388
|
+
"wizard",
|
|
389
|
+
"review"
|
|
390
|
+
]
|
|
391
|
+
},
|
|
392
|
+
"density": {
|
|
393
|
+
"enum": [
|
|
394
|
+
"compact",
|
|
395
|
+
"comfortable",
|
|
396
|
+
"rich"
|
|
397
|
+
]
|
|
398
|
+
},
|
|
399
|
+
"selectedLayout": {
|
|
400
|
+
"enum": [
|
|
401
|
+
"card",
|
|
402
|
+
"inline",
|
|
403
|
+
"compact",
|
|
404
|
+
"token"
|
|
405
|
+
]
|
|
406
|
+
},
|
|
407
|
+
"resultLayout": {
|
|
408
|
+
"enum": [
|
|
409
|
+
"list",
|
|
410
|
+
"denseList",
|
|
411
|
+
"table",
|
|
412
|
+
"card"
|
|
413
|
+
]
|
|
414
|
+
},
|
|
415
|
+
"primaryPropertyPath": {
|
|
416
|
+
"type": "string"
|
|
417
|
+
},
|
|
418
|
+
"fields": {
|
|
419
|
+
"type": "array"
|
|
420
|
+
},
|
|
421
|
+
"secondaryPropertyPaths": {
|
|
422
|
+
"type": "array"
|
|
423
|
+
},
|
|
424
|
+
"badgePropertyPaths": {
|
|
425
|
+
"type": "array"
|
|
426
|
+
},
|
|
427
|
+
"statusToneMap": {
|
|
428
|
+
"type": "object"
|
|
429
|
+
}
|
|
430
|
+
}
|
|
431
|
+
},
|
|
432
|
+
"detail": {
|
|
433
|
+
"type": "object",
|
|
434
|
+
"properties": {
|
|
435
|
+
"kind": {
|
|
436
|
+
"enum": [
|
|
437
|
+
"surface",
|
|
438
|
+
"route",
|
|
439
|
+
"href"
|
|
440
|
+
]
|
|
441
|
+
},
|
|
442
|
+
"surfaceId": {
|
|
443
|
+
"type": "string"
|
|
444
|
+
},
|
|
445
|
+
"presentation": {
|
|
446
|
+
"enum": [
|
|
447
|
+
"drawer",
|
|
448
|
+
"modal"
|
|
449
|
+
]
|
|
450
|
+
},
|
|
451
|
+
"preferredWidget": {
|
|
452
|
+
"type": "string"
|
|
453
|
+
},
|
|
454
|
+
"mode": {
|
|
455
|
+
"enum": [
|
|
456
|
+
"view",
|
|
457
|
+
"edit",
|
|
458
|
+
"create"
|
|
459
|
+
]
|
|
460
|
+
}
|
|
461
|
+
}
|
|
462
|
+
},
|
|
463
|
+
"options": {
|
|
464
|
+
"type": "array"
|
|
465
|
+
}
|
|
466
|
+
}
|
|
467
|
+
},
|
|
468
|
+
"effects": [
|
|
469
|
+
{
|
|
470
|
+
"kind": "compile-domain-patch",
|
|
471
|
+
"handler": "metadata-option-source-configure",
|
|
472
|
+
"handlerContract": {
|
|
473
|
+
"reads": [
|
|
474
|
+
"fieldMetadata.optionSource",
|
|
475
|
+
"backend.x-ui.optionSource",
|
|
476
|
+
"SchemaNormalizerService"
|
|
477
|
+
],
|
|
478
|
+
"writes": [
|
|
479
|
+
"fieldMetadata.optionSource"
|
|
480
|
+
],
|
|
481
|
+
"identityKeys": [
|
|
482
|
+
"field.name",
|
|
483
|
+
"optionSource.kind",
|
|
484
|
+
"optionSource.resource"
|
|
485
|
+
],
|
|
486
|
+
"failureModes": [
|
|
487
|
+
"invalid-option-source-kind",
|
|
488
|
+
"remote-source-missing-governed-resource",
|
|
489
|
+
"dependency-filter-map-invalid"
|
|
490
|
+
],
|
|
491
|
+
"description": "Configures canonical optionSource fields while preserving backend x-ui dependsOn and dependencyFilterMap semantics."
|
|
492
|
+
}
|
|
493
|
+
}
|
|
494
|
+
],
|
|
495
|
+
"destructive": false,
|
|
496
|
+
"requiresConfirmation": false,
|
|
497
|
+
"validators": [
|
|
498
|
+
"option-source-shape-canonical",
|
|
499
|
+
"remote-option-source-governed",
|
|
500
|
+
"cascade-backend-shape-preserved",
|
|
501
|
+
"metadata-round-trip"
|
|
502
|
+
],
|
|
503
|
+
"affectedPaths": [
|
|
504
|
+
"fieldMetadata.optionSource"
|
|
505
|
+
],
|
|
506
|
+
"submissionImpact": "affects-remote-binding",
|
|
507
|
+
"preconditions": [
|
|
508
|
+
"field-metadata-loaded"
|
|
509
|
+
]
|
|
510
|
+
},
|
|
511
|
+
{
|
|
512
|
+
"operationId": "cascade.configure",
|
|
513
|
+
"title": "Configure cascade rule",
|
|
514
|
+
"scope": "interaction",
|
|
515
|
+
"targetKind": "cascade",
|
|
516
|
+
"target": {
|
|
517
|
+
"kind": "cascade",
|
|
518
|
+
"resolver": "metadata-editor-cascade-rules",
|
|
519
|
+
"ambiguityPolicy": "fail",
|
|
520
|
+
"required": false
|
|
521
|
+
},
|
|
522
|
+
"inputSchema": {
|
|
523
|
+
"type": "object",
|
|
524
|
+
"required": [
|
|
525
|
+
"dependentField"
|
|
526
|
+
],
|
|
527
|
+
"properties": {
|
|
528
|
+
"dependentField": {
|
|
529
|
+
"type": "string"
|
|
530
|
+
},
|
|
531
|
+
"sourceField": {
|
|
532
|
+
"type": "string"
|
|
533
|
+
},
|
|
534
|
+
"strategy": {
|
|
535
|
+
"enum": [
|
|
536
|
+
"replace",
|
|
537
|
+
"merge"
|
|
538
|
+
]
|
|
539
|
+
},
|
|
540
|
+
"debounceMs": {
|
|
541
|
+
"type": "number"
|
|
542
|
+
},
|
|
543
|
+
"loadMode": {
|
|
544
|
+
"enum": [
|
|
545
|
+
"immediate",
|
|
546
|
+
"manual",
|
|
547
|
+
"respectLoadOn"
|
|
548
|
+
]
|
|
549
|
+
},
|
|
550
|
+
"dependencyFilterMap": {
|
|
551
|
+
"type": "object"
|
|
552
|
+
},
|
|
553
|
+
"optionSource": {
|
|
554
|
+
"type": "object",
|
|
555
|
+
"properties": {
|
|
556
|
+
"kind": {
|
|
557
|
+
"enum": [
|
|
558
|
+
"static",
|
|
559
|
+
"remote",
|
|
560
|
+
"resource",
|
|
561
|
+
"lookup"
|
|
562
|
+
]
|
|
563
|
+
},
|
|
564
|
+
"resource": {
|
|
565
|
+
"type": "string"
|
|
566
|
+
},
|
|
567
|
+
"endpoint": {
|
|
568
|
+
"type": "string"
|
|
569
|
+
},
|
|
570
|
+
"dependsOn": {
|
|
571
|
+
"type": "string"
|
|
572
|
+
},
|
|
573
|
+
"dependencyFilterMap": {
|
|
574
|
+
"type": "object"
|
|
575
|
+
}
|
|
576
|
+
}
|
|
577
|
+
}
|
|
578
|
+
}
|
|
579
|
+
},
|
|
580
|
+
"effects": [
|
|
581
|
+
{
|
|
582
|
+
"kind": "compile-domain-patch",
|
|
583
|
+
"handler": "metadata-cascade-configure",
|
|
584
|
+
"handlerContract": {
|
|
585
|
+
"reads": [
|
|
586
|
+
"CascadeManagerTabComponent",
|
|
587
|
+
"CascadeRulesService",
|
|
588
|
+
"fields",
|
|
589
|
+
"fieldMetadata.optionSource",
|
|
590
|
+
"fieldMetadata.dependencyFields",
|
|
591
|
+
"fieldMetadata.dependencyFilterMap"
|
|
592
|
+
],
|
|
593
|
+
"writes": [
|
|
594
|
+
"fieldMetadata.dependencyFields",
|
|
595
|
+
"fieldMetadata.enableDependencyCascade",
|
|
596
|
+
"fieldMetadata.resetOnDependentChange",
|
|
597
|
+
"fieldMetadata.dependencyFilterMap",
|
|
598
|
+
"fieldMetadata.dependencyValuePath",
|
|
599
|
+
"fieldMetadata.dependencyMergeStrategy",
|
|
600
|
+
"fieldMetadata.dependencyDebounceMs",
|
|
601
|
+
"fieldMetadata.dependencyLoadOnChange",
|
|
602
|
+
"fieldMetadata.optionSource.dependsOn",
|
|
603
|
+
"fieldMetadata.optionSource.dependencyFilterMap"
|
|
604
|
+
],
|
|
605
|
+
"identityKeys": [
|
|
606
|
+
"dependentField",
|
|
607
|
+
"sourceField"
|
|
608
|
+
],
|
|
609
|
+
"failureModes": [
|
|
610
|
+
"dependent-field-not-found",
|
|
611
|
+
"source-field-not-found",
|
|
612
|
+
"cascade-cycle-detected",
|
|
613
|
+
"dependency-filter-map-invalid"
|
|
614
|
+
],
|
|
615
|
+
"description": "Applies cascade dependencies through CascadeRulesService using the metadata-editor save contract while preserving backend x-ui optionSource dependency semantics during hydration."
|
|
616
|
+
}
|
|
617
|
+
}
|
|
618
|
+
],
|
|
619
|
+
"destructive": false,
|
|
620
|
+
"requiresConfirmation": false,
|
|
621
|
+
"validators": [
|
|
622
|
+
"cascade-fields-exist",
|
|
623
|
+
"cascade-cycle-free",
|
|
624
|
+
"cascade-backend-shape-preserved",
|
|
625
|
+
"option-source-shape-canonical",
|
|
626
|
+
"remote-option-source-governed",
|
|
627
|
+
"metadata-round-trip"
|
|
628
|
+
],
|
|
629
|
+
"affectedPaths": [
|
|
630
|
+
"fieldMetadata.dependencyFields",
|
|
631
|
+
"fieldMetadata.enableDependencyCascade",
|
|
632
|
+
"fieldMetadata.resetOnDependentChange",
|
|
633
|
+
"fieldMetadata.dependencyFilterMap",
|
|
634
|
+
"fieldMetadata.dependencyValuePath",
|
|
635
|
+
"fieldMetadata.dependencyMergeStrategy",
|
|
636
|
+
"fieldMetadata.dependencyDebounceMs",
|
|
637
|
+
"fieldMetadata.dependencyLoadOnChange",
|
|
638
|
+
"fieldMetadata.optionSource.dependsOn",
|
|
639
|
+
"fieldMetadata.optionSource.dependencyFilterMap"
|
|
640
|
+
],
|
|
641
|
+
"submissionImpact": "affects-remote-binding",
|
|
642
|
+
"preconditions": [
|
|
643
|
+
"field-list-loaded"
|
|
644
|
+
]
|
|
645
|
+
},
|
|
646
|
+
{
|
|
647
|
+
"operationId": "renderer.configure",
|
|
648
|
+
"title": "Configure renderer coverage",
|
|
649
|
+
"scope": "editorCoverage",
|
|
650
|
+
"targetKind": "renderer",
|
|
651
|
+
"target": {
|
|
652
|
+
"kind": "renderer",
|
|
653
|
+
"resolver": "metadata-editor-renderer-property",
|
|
654
|
+
"ambiguityPolicy": "fail",
|
|
655
|
+
"required": true
|
|
656
|
+
},
|
|
657
|
+
"inputSchema": {
|
|
658
|
+
"type": "object",
|
|
659
|
+
"required": [
|
|
660
|
+
"propertyName",
|
|
661
|
+
"editorType"
|
|
662
|
+
],
|
|
663
|
+
"properties": {
|
|
664
|
+
"propertyName": {
|
|
665
|
+
"type": "string"
|
|
666
|
+
},
|
|
667
|
+
"editorType": {
|
|
668
|
+
"type": "string"
|
|
669
|
+
},
|
|
670
|
+
"group": {
|
|
671
|
+
"type": "string"
|
|
672
|
+
},
|
|
673
|
+
"required": {
|
|
674
|
+
"type": "boolean"
|
|
675
|
+
},
|
|
676
|
+
"options": {
|
|
677
|
+
"type": "array"
|
|
678
|
+
}
|
|
679
|
+
}
|
|
680
|
+
},
|
|
681
|
+
"effects": [
|
|
682
|
+
{
|
|
683
|
+
"kind": "compile-domain-patch",
|
|
684
|
+
"handler": "metadata-renderer-configure",
|
|
685
|
+
"handlerContract": {
|
|
686
|
+
"reads": [
|
|
687
|
+
"DynamicEditorRendererComponent",
|
|
688
|
+
"EditorComponentRegistryService",
|
|
689
|
+
"ConfigRegistryService",
|
|
690
|
+
"EditorProperty"
|
|
691
|
+
],
|
|
692
|
+
"writes": [
|
|
693
|
+
"properties",
|
|
694
|
+
"editorCoverage"
|
|
695
|
+
],
|
|
696
|
+
"identityKeys": [
|
|
697
|
+
"controlType",
|
|
698
|
+
"propertyName"
|
|
699
|
+
],
|
|
700
|
+
"inputSchema": {
|
|
701
|
+
"type": "object",
|
|
702
|
+
"required": [
|
|
703
|
+
"propertyName",
|
|
704
|
+
"editorType"
|
|
705
|
+
],
|
|
706
|
+
"properties": {
|
|
707
|
+
"propertyName": {
|
|
708
|
+
"type": "string"
|
|
709
|
+
},
|
|
710
|
+
"editorType": {
|
|
711
|
+
"type": "string"
|
|
712
|
+
},
|
|
713
|
+
"group": {
|
|
714
|
+
"type": "string"
|
|
715
|
+
}
|
|
716
|
+
}
|
|
717
|
+
},
|
|
718
|
+
"failureModes": [
|
|
719
|
+
"editor-type-not-registered",
|
|
720
|
+
"property-not-covered",
|
|
721
|
+
"json-only-coverage-not-accepted"
|
|
722
|
+
],
|
|
723
|
+
"description": "Configures visual renderer coverage for a metadata property and rejects JSON-only support for required visual authoring."
|
|
724
|
+
}
|
|
725
|
+
}
|
|
726
|
+
],
|
|
727
|
+
"destructive": false,
|
|
728
|
+
"requiresConfirmation": false,
|
|
729
|
+
"validators": [
|
|
730
|
+
"renderer-editor-type-registered",
|
|
731
|
+
"visual-editor-coverage-required",
|
|
732
|
+
"editor-coverage-exists",
|
|
733
|
+
"metadata-round-trip"
|
|
734
|
+
],
|
|
735
|
+
"affectedPaths": [
|
|
736
|
+
"properties",
|
|
737
|
+
"editorCoverage"
|
|
738
|
+
],
|
|
739
|
+
"submissionImpact": "config-only",
|
|
740
|
+
"preconditions": [
|
|
741
|
+
"config-registry-loaded"
|
|
742
|
+
]
|
|
743
|
+
},
|
|
744
|
+
{
|
|
745
|
+
"operationId": "validationRule.add",
|
|
746
|
+
"title": "Add validation rule",
|
|
747
|
+
"scope": "fieldMetadataPath",
|
|
748
|
+
"targetKind": "validation",
|
|
749
|
+
"target": {
|
|
750
|
+
"kind": "validation",
|
|
751
|
+
"resolver": "field-metadata-validation-rules",
|
|
752
|
+
"ambiguityPolicy": "fail",
|
|
753
|
+
"required": false
|
|
754
|
+
},
|
|
755
|
+
"inputSchema": {
|
|
756
|
+
"type": "object",
|
|
757
|
+
"required": [
|
|
758
|
+
"rule"
|
|
759
|
+
],
|
|
760
|
+
"properties": {
|
|
761
|
+
"rule": {
|
|
762
|
+
"type": "object"
|
|
763
|
+
},
|
|
764
|
+
"message": {
|
|
765
|
+
"type": "string"
|
|
766
|
+
},
|
|
767
|
+
"contextValidatorId": {
|
|
768
|
+
"type": "string"
|
|
769
|
+
}
|
|
770
|
+
}
|
|
771
|
+
},
|
|
772
|
+
"effects": [
|
|
773
|
+
{
|
|
774
|
+
"kind": "compile-domain-patch",
|
|
775
|
+
"handler": "metadata-validation-rule-add",
|
|
776
|
+
"handlerContract": {
|
|
777
|
+
"reads": [
|
|
778
|
+
"fieldMetadata.validators",
|
|
779
|
+
"ContextValidatorRegistryService",
|
|
780
|
+
"DynamicFormFactoryService"
|
|
781
|
+
],
|
|
782
|
+
"writes": [
|
|
783
|
+
"fieldMetadata.validators"
|
|
784
|
+
],
|
|
785
|
+
"identityKeys": [
|
|
786
|
+
"field.name",
|
|
787
|
+
"rule.type",
|
|
788
|
+
"contextValidatorId"
|
|
789
|
+
],
|
|
790
|
+
"inputSchema": {
|
|
791
|
+
"type": "object",
|
|
792
|
+
"required": [
|
|
793
|
+
"rule"
|
|
794
|
+
],
|
|
795
|
+
"properties": {
|
|
796
|
+
"rule": {
|
|
797
|
+
"type": "object"
|
|
798
|
+
},
|
|
799
|
+
"message": {
|
|
800
|
+
"type": "string"
|
|
801
|
+
},
|
|
802
|
+
"contextValidatorId": {
|
|
803
|
+
"type": "string"
|
|
804
|
+
}
|
|
805
|
+
}
|
|
806
|
+
},
|
|
807
|
+
"failureModes": [
|
|
808
|
+
"validation-rule-invalid",
|
|
809
|
+
"context-validator-not-registered",
|
|
810
|
+
"duplicate-validation-rule"
|
|
811
|
+
],
|
|
812
|
+
"description": "Adds a canonical validation rule and verifies contextual validator availability before persistence."
|
|
813
|
+
}
|
|
814
|
+
}
|
|
815
|
+
],
|
|
816
|
+
"destructive": false,
|
|
817
|
+
"requiresConfirmation": false,
|
|
818
|
+
"validators": [
|
|
819
|
+
"validation-rule-canonical",
|
|
820
|
+
"context-validator-registered",
|
|
821
|
+
"metadata-round-trip"
|
|
822
|
+
],
|
|
823
|
+
"affectedPaths": [
|
|
824
|
+
"fieldMetadata.validators"
|
|
825
|
+
],
|
|
826
|
+
"submissionImpact": "affects-submission",
|
|
827
|
+
"preconditions": [
|
|
828
|
+
"field-metadata-loaded"
|
|
829
|
+
]
|
|
830
|
+
},
|
|
831
|
+
{
|
|
832
|
+
"operationId": "contextHint.set",
|
|
833
|
+
"title": "Set metadata context hint",
|
|
834
|
+
"scope": "meta",
|
|
835
|
+
"targetKind": "contextHint",
|
|
836
|
+
"target": {
|
|
837
|
+
"kind": "contextHint",
|
|
838
|
+
"resolver": "metadata-editor-context-hints",
|
|
839
|
+
"ambiguityPolicy": "fail",
|
|
840
|
+
"required": false
|
|
841
|
+
},
|
|
842
|
+
"inputSchema": {
|
|
843
|
+
"type": "object",
|
|
844
|
+
"required": [
|
|
845
|
+
"hintPath",
|
|
846
|
+
"value"
|
|
847
|
+
],
|
|
848
|
+
"properties": {
|
|
849
|
+
"hintPath": {
|
|
850
|
+
"enum": [
|
|
851
|
+
"hint",
|
|
852
|
+
"helpText",
|
|
853
|
+
"description",
|
|
854
|
+
"tooltip",
|
|
855
|
+
"ariaLabel",
|
|
856
|
+
"ariaDescribedBy"
|
|
857
|
+
]
|
|
858
|
+
},
|
|
859
|
+
"value": {},
|
|
860
|
+
"localeKey": {
|
|
861
|
+
"type": "string"
|
|
862
|
+
}
|
|
863
|
+
}
|
|
864
|
+
},
|
|
865
|
+
"effects": [
|
|
866
|
+
{
|
|
867
|
+
"kind": "compile-domain-patch",
|
|
868
|
+
"handler": "metadata-context-hint-set",
|
|
869
|
+
"handlerContract": {
|
|
870
|
+
"reads": [
|
|
871
|
+
"fieldMetadata.hint",
|
|
872
|
+
"fieldMetadata.helpText",
|
|
873
|
+
"fieldMetadata.description",
|
|
874
|
+
"fieldMetadata.tooltip",
|
|
875
|
+
"fieldMetadata.ariaLabel",
|
|
876
|
+
"fieldMetadata.ariaDescribedBy",
|
|
877
|
+
"metadata-editor-i18n"
|
|
878
|
+
],
|
|
879
|
+
"writes": [
|
|
880
|
+
"fieldMetadata.hint",
|
|
881
|
+
"fieldMetadata.helpText",
|
|
882
|
+
"fieldMetadata.description",
|
|
883
|
+
"fieldMetadata.tooltip",
|
|
884
|
+
"fieldMetadata.ariaLabel",
|
|
885
|
+
"fieldMetadata.ariaDescribedBy"
|
|
886
|
+
],
|
|
887
|
+
"identityKeys": [
|
|
888
|
+
"field.name",
|
|
889
|
+
"hintPath"
|
|
890
|
+
],
|
|
891
|
+
"inputSchema": {
|
|
892
|
+
"type": "object",
|
|
893
|
+
"required": [
|
|
894
|
+
"hintPath",
|
|
895
|
+
"value"
|
|
896
|
+
],
|
|
897
|
+
"properties": {
|
|
898
|
+
"hintPath": {
|
|
899
|
+
"enum": [
|
|
900
|
+
"hint",
|
|
901
|
+
"helpText",
|
|
902
|
+
"description",
|
|
903
|
+
"tooltip",
|
|
904
|
+
"ariaLabel",
|
|
905
|
+
"ariaDescribedBy"
|
|
906
|
+
]
|
|
907
|
+
},
|
|
908
|
+
"value": {},
|
|
909
|
+
"localeKey": {
|
|
910
|
+
"type": "string"
|
|
911
|
+
}
|
|
912
|
+
}
|
|
913
|
+
},
|
|
914
|
+
"failureModes": [
|
|
915
|
+
"hint-path-not-canonical",
|
|
916
|
+
"hint-value-not-serializable",
|
|
917
|
+
"i18n-key-missing"
|
|
918
|
+
],
|
|
919
|
+
"description": "Sets structured FieldMetadata hint/help/accessibility text through canonical metadata paths and metadata-editor i18n constraints."
|
|
920
|
+
}
|
|
921
|
+
}
|
|
922
|
+
],
|
|
923
|
+
"destructive": false,
|
|
924
|
+
"requiresConfirmation": false,
|
|
925
|
+
"validators": [
|
|
926
|
+
"context-hint-shape-canonical",
|
|
927
|
+
"context-hint-i18n-compatible",
|
|
928
|
+
"metadata-round-trip"
|
|
929
|
+
],
|
|
930
|
+
"affectedPaths": [
|
|
931
|
+
"fieldMetadata.hint",
|
|
932
|
+
"fieldMetadata.helpText",
|
|
933
|
+
"fieldMetadata.description",
|
|
934
|
+
"fieldMetadata.tooltip",
|
|
935
|
+
"fieldMetadata.ariaLabel",
|
|
936
|
+
"fieldMetadata.ariaDescribedBy"
|
|
937
|
+
],
|
|
938
|
+
"submissionImpact": "visual-only",
|
|
939
|
+
"preconditions": [
|
|
940
|
+
"field-metadata-loaded"
|
|
941
|
+
]
|
|
942
|
+
},
|
|
943
|
+
{
|
|
944
|
+
"operationId": "dateRangeShortcuts.configure",
|
|
945
|
+
"title": "Configure governed date range shortcuts",
|
|
946
|
+
"scope": "fieldMetadataPath",
|
|
947
|
+
"targetKind": "dateRangeShortcuts",
|
|
948
|
+
"target": {
|
|
949
|
+
"kind": "dateRangeShortcuts",
|
|
950
|
+
"resolver": "metadata-editor-date-range-shortcut-catalog",
|
|
951
|
+
"ambiguityPolicy": "fail",
|
|
952
|
+
"required": false
|
|
953
|
+
},
|
|
954
|
+
"inputSchema": {
|
|
955
|
+
"type": "object",
|
|
956
|
+
"required": [
|
|
957
|
+
"shortcuts"
|
|
958
|
+
],
|
|
959
|
+
"properties": {
|
|
960
|
+
"shortcuts": {
|
|
961
|
+
"type": "array",
|
|
962
|
+
"items": {
|
|
963
|
+
"anyOf": [
|
|
964
|
+
{
|
|
965
|
+
"enum": [
|
|
966
|
+
"today",
|
|
967
|
+
"yesterday",
|
|
968
|
+
"thisWeek",
|
|
969
|
+
"lastWeek",
|
|
970
|
+
"thisMonth",
|
|
971
|
+
"lastMonth",
|
|
972
|
+
"thisYear",
|
|
973
|
+
"lastYear"
|
|
974
|
+
]
|
|
975
|
+
},
|
|
976
|
+
{
|
|
977
|
+
"type": "object",
|
|
978
|
+
"required": [
|
|
979
|
+
"id",
|
|
980
|
+
"label",
|
|
981
|
+
"startDate",
|
|
982
|
+
"endDate"
|
|
983
|
+
],
|
|
984
|
+
"additionalProperties": false,
|
|
985
|
+
"properties": {
|
|
986
|
+
"id": {
|
|
987
|
+
"type": "string",
|
|
988
|
+
"minLength": 1
|
|
989
|
+
},
|
|
990
|
+
"label": {
|
|
991
|
+
"type": "string",
|
|
992
|
+
"minLength": 1
|
|
993
|
+
},
|
|
994
|
+
"startDate": {
|
|
995
|
+
"type": "string",
|
|
996
|
+
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
|
|
997
|
+
},
|
|
998
|
+
"endDate": {
|
|
999
|
+
"type": "string",
|
|
1000
|
+
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
|
|
1001
|
+
},
|
|
1002
|
+
"timeZone": {
|
|
1003
|
+
"type": "string"
|
|
1004
|
+
},
|
|
1005
|
+
"icon": {
|
|
1006
|
+
"type": "string"
|
|
1007
|
+
},
|
|
1008
|
+
"description": {
|
|
1009
|
+
"type": "string"
|
|
1010
|
+
},
|
|
1011
|
+
"tone": {
|
|
1012
|
+
"enum": [
|
|
1013
|
+
"neutral",
|
|
1014
|
+
"info",
|
|
1015
|
+
"success",
|
|
1016
|
+
"warning"
|
|
1017
|
+
]
|
|
1018
|
+
},
|
|
1019
|
+
"effectiveFrom": {
|
|
1020
|
+
"type": "string",
|
|
1021
|
+
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
|
|
1022
|
+
},
|
|
1023
|
+
"effectiveTo": {
|
|
1024
|
+
"type": "string",
|
|
1025
|
+
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
|
|
1026
|
+
},
|
|
1027
|
+
"order": {
|
|
1028
|
+
"type": "number"
|
|
1029
|
+
}
|
|
1030
|
+
}
|
|
1031
|
+
}
|
|
1032
|
+
]
|
|
1033
|
+
}
|
|
1034
|
+
},
|
|
1035
|
+
"inlineQuickPresets": {
|
|
1036
|
+
"type": "object",
|
|
1037
|
+
"properties": {
|
|
1038
|
+
"enabled": {
|
|
1039
|
+
"type": "boolean"
|
|
1040
|
+
},
|
|
1041
|
+
"maxVisible": {
|
|
1042
|
+
"type": "number"
|
|
1043
|
+
},
|
|
1044
|
+
"position": {
|
|
1045
|
+
"enum": [
|
|
1046
|
+
"auto",
|
|
1047
|
+
"footer",
|
|
1048
|
+
"start",
|
|
1049
|
+
"end"
|
|
1050
|
+
]
|
|
1051
|
+
}
|
|
1052
|
+
}
|
|
1053
|
+
},
|
|
1054
|
+
"applyMode": {
|
|
1055
|
+
"enum": [
|
|
1056
|
+
"auto",
|
|
1057
|
+
"explicit"
|
|
1058
|
+
]
|
|
1059
|
+
}
|
|
1060
|
+
}
|
|
1061
|
+
},
|
|
1062
|
+
"effects": [
|
|
1063
|
+
{
|
|
1064
|
+
"kind": "compile-domain-patch",
|
|
1065
|
+
"handler": "metadata-date-range-shortcuts-configure",
|
|
1066
|
+
"handlerContract": {
|
|
1067
|
+
"reads": [
|
|
1068
|
+
"fieldMetadata.controlType",
|
|
1069
|
+
"fieldMetadata.shortcuts",
|
|
1070
|
+
"fieldMetadata.inlineQuickPresets",
|
|
1071
|
+
"fieldMetadata.inlineOverlay",
|
|
1072
|
+
"ConfigRegistryService"
|
|
1073
|
+
],
|
|
1074
|
+
"writes": [
|
|
1075
|
+
"fieldMetadata.shortcuts",
|
|
1076
|
+
"fieldMetadata.inlineQuickPresets",
|
|
1077
|
+
"fieldMetadata.inlineOverlay.applyMode"
|
|
1078
|
+
],
|
|
1079
|
+
"identityKeys": [
|
|
1080
|
+
"field.name",
|
|
1081
|
+
"shortcuts[].id"
|
|
1082
|
+
],
|
|
1083
|
+
"failureModes": [
|
|
1084
|
+
"control-type-not-date-range",
|
|
1085
|
+
"duplicate-shortcut-id",
|
|
1086
|
+
"invalid-static-date-range-shortcut",
|
|
1087
|
+
"unsupported-shortcut-tone",
|
|
1088
|
+
"executable-shortcut-metadata"
|
|
1089
|
+
],
|
|
1090
|
+
"description": "Configures built-in and backend-resolved static date range shortcuts through the canonical shortcuts array; JSON metadata may not contain calculateRange or executable expressions."
|
|
1091
|
+
}
|
|
1092
|
+
}
|
|
1093
|
+
],
|
|
1094
|
+
"destructive": false,
|
|
1095
|
+
"requiresConfirmation": false,
|
|
1096
|
+
"validators": [
|
|
1097
|
+
"date-range-shortcuts-static-canonical",
|
|
1098
|
+
"date-range-shortcuts-no-executable-metadata",
|
|
1099
|
+
"date-range-shortcuts-unique-ids",
|
|
1100
|
+
"metadata-round-trip"
|
|
1101
|
+
],
|
|
1102
|
+
"affectedPaths": [
|
|
1103
|
+
"fieldMetadata.shortcuts",
|
|
1104
|
+
"fieldMetadata.inlineQuickPresets",
|
|
1105
|
+
"fieldMetadata.inlineOverlay.applyMode"
|
|
1106
|
+
],
|
|
1107
|
+
"submissionImpact": "affects-schema-backed-data",
|
|
1108
|
+
"preconditions": [
|
|
1109
|
+
"field-metadata-loaded",
|
|
1110
|
+
"editor-properties-loaded"
|
|
1111
|
+
]
|
|
1112
|
+
},
|
|
1113
|
+
{
|
|
1114
|
+
"operationId": "normalization.apply",
|
|
1115
|
+
"title": "Apply schema normalization",
|
|
1116
|
+
"scope": "runtimeCoverage",
|
|
1117
|
+
"targetKind": "normalization",
|
|
1118
|
+
"target": {
|
|
1119
|
+
"kind": "normalization",
|
|
1120
|
+
"resolver": "metadata-editor-schema-normalizer",
|
|
1121
|
+
"ambiguityPolicy": "fail",
|
|
1122
|
+
"required": false
|
|
1123
|
+
},
|
|
1124
|
+
"inputSchema": {
|
|
1125
|
+
"type": "object",
|
|
1126
|
+
"properties": {
|
|
1127
|
+
"mode": {
|
|
1128
|
+
"enum": [
|
|
1129
|
+
"hydrate-seed",
|
|
1130
|
+
"coerce-types",
|
|
1131
|
+
"apply-defaults",
|
|
1132
|
+
"preserve-advanced-properties"
|
|
1133
|
+
]
|
|
1134
|
+
},
|
|
1135
|
+
"preserveUnknownCanonicalFields": {
|
|
1136
|
+
"type": "boolean"
|
|
1137
|
+
}
|
|
1138
|
+
}
|
|
1139
|
+
},
|
|
1140
|
+
"effects": [
|
|
1141
|
+
{
|
|
1142
|
+
"kind": "compile-domain-patch",
|
|
1143
|
+
"handler": "metadata-normalization-apply",
|
|
1144
|
+
"handlerContract": {
|
|
1145
|
+
"reads": [
|
|
1146
|
+
"SchemaNormalizerService",
|
|
1147
|
+
"fieldMetadata",
|
|
1148
|
+
"properties",
|
|
1149
|
+
"DynamicFormFactoryService"
|
|
1150
|
+
],
|
|
1151
|
+
"writes": [
|
|
1152
|
+
"normalizedSeed",
|
|
1153
|
+
"form",
|
|
1154
|
+
"fieldMetadata"
|
|
1155
|
+
],
|
|
1156
|
+
"identityKeys": [
|
|
1157
|
+
"field.name",
|
|
1158
|
+
"controlType",
|
|
1159
|
+
"mode"
|
|
1160
|
+
],
|
|
1161
|
+
"inputSchema": {
|
|
1162
|
+
"type": "object",
|
|
1163
|
+
"properties": {
|
|
1164
|
+
"mode": {
|
|
1165
|
+
"enum": [
|
|
1166
|
+
"hydrate-seed",
|
|
1167
|
+
"coerce-types",
|
|
1168
|
+
"apply-defaults",
|
|
1169
|
+
"preserve-advanced-properties"
|
|
1170
|
+
]
|
|
1171
|
+
},
|
|
1172
|
+
"preserveUnknownCanonicalFields": {
|
|
1173
|
+
"type": "boolean"
|
|
1174
|
+
}
|
|
1175
|
+
}
|
|
1176
|
+
},
|
|
1177
|
+
"failureModes": [
|
|
1178
|
+
"normalizer-missing",
|
|
1179
|
+
"type-coercion-failed",
|
|
1180
|
+
"advanced-property-lost",
|
|
1181
|
+
"runtime-editor-drift"
|
|
1182
|
+
],
|
|
1183
|
+
"description": "Runs metadata-editor schema normalization while preserving canonical advanced FieldMetadata properties and editor/runtime round-trip."
|
|
1184
|
+
}
|
|
1185
|
+
}
|
|
1186
|
+
],
|
|
1187
|
+
"destructive": false,
|
|
1188
|
+
"requiresConfirmation": false,
|
|
1189
|
+
"validators": [
|
|
1190
|
+
"normalization-preserves-canonical-fields",
|
|
1191
|
+
"runtime-editor-round-trip",
|
|
1192
|
+
"metadata-round-trip"
|
|
1193
|
+
],
|
|
1194
|
+
"affectedPaths": [
|
|
1195
|
+
"normalizedSeed",
|
|
1196
|
+
"form",
|
|
1197
|
+
"fieldMetadata"
|
|
1198
|
+
],
|
|
1199
|
+
"submissionImpact": "config-only",
|
|
1200
|
+
"preconditions": [
|
|
1201
|
+
"field-metadata-loaded",
|
|
1202
|
+
"editor-properties-loaded"
|
|
1203
|
+
]
|
|
1204
|
+
}
|
|
1205
|
+
],
|
|
1206
|
+
"validators": [
|
|
1207
|
+
{
|
|
1208
|
+
"validatorId": "field-metadata-shape-canonical",
|
|
1209
|
+
"level": "error",
|
|
1210
|
+
"code": "METADATA_FIELD_SHAPE_CANONICAL",
|
|
1211
|
+
"description": "Edited metadata must remain compatible with canonical FieldMetadata."
|
|
1212
|
+
},
|
|
1213
|
+
{
|
|
1214
|
+
"validatorId": "field-path-supported-by-editor",
|
|
1215
|
+
"level": "error",
|
|
1216
|
+
"code": "METADATA_FIELD_PATH_SUPPORTED",
|
|
1217
|
+
"description": "Edited paths must be supported by visual editor coverage or explicitly delegated."
|
|
1218
|
+
},
|
|
1219
|
+
{
|
|
1220
|
+
"validatorId": "control-type-exists-in-discovery",
|
|
1221
|
+
"level": "error",
|
|
1222
|
+
"code": "METADATA_CONTROL_TYPE_DISCOVERED",
|
|
1223
|
+
"description": "Control type must exist in dynamic-fields discovery."
|
|
1224
|
+
},
|
|
1225
|
+
{
|
|
1226
|
+
"validatorId": "editor-coverage-exists",
|
|
1227
|
+
"level": "error",
|
|
1228
|
+
"code": "METADATA_EDITOR_COVERAGE_EXISTS",
|
|
1229
|
+
"description": "Control type and property must have metadata-editor coverage."
|
|
1230
|
+
},
|
|
1231
|
+
{
|
|
1232
|
+
"validatorId": "option-source-shape-canonical",
|
|
1233
|
+
"level": "error",
|
|
1234
|
+
"code": "METADATA_OPTION_SOURCE_CANONICAL",
|
|
1235
|
+
"description": "Option source must use canonical FieldMetadata/x-ui shape."
|
|
1236
|
+
},
|
|
1237
|
+
{
|
|
1238
|
+
"validatorId": "remote-option-source-governed",
|
|
1239
|
+
"level": "error",
|
|
1240
|
+
"code": "METADATA_REMOTE_OPTION_SOURCE_GOVERNED",
|
|
1241
|
+
"description": "Remote option sources must resolve through governed resource or endpoint metadata."
|
|
1242
|
+
},
|
|
1243
|
+
{
|
|
1244
|
+
"validatorId": "cascade-fields-exist",
|
|
1245
|
+
"level": "error",
|
|
1246
|
+
"code": "METADATA_CASCADE_FIELDS_EXIST",
|
|
1247
|
+
"description": "Cascade source and dependent fields must exist."
|
|
1248
|
+
},
|
|
1249
|
+
{
|
|
1250
|
+
"validatorId": "cascade-cycle-free",
|
|
1251
|
+
"level": "error",
|
|
1252
|
+
"code": "METADATA_CASCADE_CYCLE_FREE",
|
|
1253
|
+
"description": "Cascade dependencies must not create cycles."
|
|
1254
|
+
},
|
|
1255
|
+
{
|
|
1256
|
+
"validatorId": "cascade-backend-shape-preserved",
|
|
1257
|
+
"level": "error",
|
|
1258
|
+
"code": "METADATA_CASCADE_BACKEND_SHAPE_PRESERVED",
|
|
1259
|
+
"description": "Cascade config must preserve x-ui optionSource dependsOn and dependencyFilterMap semantics."
|
|
1260
|
+
},
|
|
1261
|
+
{
|
|
1262
|
+
"validatorId": "renderer-editor-type-registered",
|
|
1263
|
+
"level": "error",
|
|
1264
|
+
"code": "METADATA_RENDERER_TYPE_REGISTERED",
|
|
1265
|
+
"description": "Renderer editor type must be registered."
|
|
1266
|
+
},
|
|
1267
|
+
{
|
|
1268
|
+
"validatorId": "visual-editor-coverage-required",
|
|
1269
|
+
"level": "error",
|
|
1270
|
+
"code": "METADATA_VISUAL_COVERAGE_REQUIRED",
|
|
1271
|
+
"description": "JSON-only support is not accepted for required visual authoring coverage."
|
|
1272
|
+
},
|
|
1273
|
+
{
|
|
1274
|
+
"validatorId": "validation-rule-canonical",
|
|
1275
|
+
"level": "error",
|
|
1276
|
+
"code": "METADATA_VALIDATION_RULE_CANONICAL",
|
|
1277
|
+
"description": "Validation rule must use canonical metadata shape."
|
|
1278
|
+
},
|
|
1279
|
+
{
|
|
1280
|
+
"validatorId": "context-validator-registered",
|
|
1281
|
+
"level": "error",
|
|
1282
|
+
"code": "METADATA_CONTEXT_VALIDATOR_REGISTERED",
|
|
1283
|
+
"description": "Contextual validator must be registered before use."
|
|
1284
|
+
},
|
|
1285
|
+
{
|
|
1286
|
+
"validatorId": "context-hint-shape-canonical",
|
|
1287
|
+
"level": "error",
|
|
1288
|
+
"code": "METADATA_CONTEXT_HINT_CANONICAL",
|
|
1289
|
+
"description": "Context hints must remain structured metadata, not free-form host-only strings."
|
|
1290
|
+
},
|
|
1291
|
+
{
|
|
1292
|
+
"validatorId": "context-hint-i18n-compatible",
|
|
1293
|
+
"level": "warning",
|
|
1294
|
+
"code": "METADATA_CONTEXT_HINT_I18N_COMPATIBLE",
|
|
1295
|
+
"description": "Authoring hint text must remain compatible with metadata-editor i18n."
|
|
1296
|
+
},
|
|
1297
|
+
{
|
|
1298
|
+
"validatorId": "date-range-shortcuts-static-canonical",
|
|
1299
|
+
"level": "error",
|
|
1300
|
+
"code": "METADATA_DATE_RANGE_SHORTCUTS_STATIC_CANONICAL",
|
|
1301
|
+
"description": "Date range shortcuts must be built-in ids or static backend-resolved ranges with id, label, startDate and endDate."
|
|
1302
|
+
},
|
|
1303
|
+
{
|
|
1304
|
+
"validatorId": "date-range-shortcuts-no-executable-metadata",
|
|
1305
|
+
"level": "error",
|
|
1306
|
+
"code": "METADATA_DATE_RANGE_SHORTCUTS_NO_EXECUTABLE_METADATA",
|
|
1307
|
+
"description": "Metadata shortcuts must not contain calculateRange, executable expressions, local calendar-law rules, or frontend business-day logic."
|
|
1308
|
+
},
|
|
1309
|
+
{
|
|
1310
|
+
"validatorId": "date-range-shortcuts-unique-ids",
|
|
1311
|
+
"level": "error",
|
|
1312
|
+
"code": "METADATA_DATE_RANGE_SHORTCUTS_UNIQUE_IDS",
|
|
1313
|
+
"description": "Static business shortcuts must use unique ids inside the date range field."
|
|
1314
|
+
},
|
|
1315
|
+
{
|
|
1316
|
+
"validatorId": "normalization-preserves-canonical-fields",
|
|
1317
|
+
"level": "error",
|
|
1318
|
+
"code": "METADATA_NORMALIZATION_PRESERVES_FIELDS",
|
|
1319
|
+
"description": "Normalization must not drop canonical advanced FieldMetadata properties."
|
|
1320
|
+
},
|
|
1321
|
+
{
|
|
1322
|
+
"validatorId": "runtime-editor-round-trip",
|
|
1323
|
+
"level": "error",
|
|
1324
|
+
"code": "METADATA_RUNTIME_EDITOR_ROUND_TRIP",
|
|
1325
|
+
"description": "Runtime and editor must consume the same normalized metadata shape."
|
|
1326
|
+
},
|
|
1327
|
+
{
|
|
1328
|
+
"validatorId": "metadata-round-trip",
|
|
1329
|
+
"level": "error",
|
|
1330
|
+
"code": "METADATA_ROUND_TRIP",
|
|
1331
|
+
"description": "Open, edit, apply/save, reopen and runtime consume must preserve metadata."
|
|
1332
|
+
}
|
|
1333
|
+
],
|
|
1334
|
+
"roundTripRequirements": [
|
|
1335
|
+
"FieldMetadata is the canonical edited document shape; backend x-ui-derived metadata must not be rewritten into host-only aliases.",
|
|
1336
|
+
"Control type changes require both dynamic-fields discovery and metadata-editor visual coverage.",
|
|
1337
|
+
"Option source cascades preserve x-ui optionSource.dependsOn and optionSource.dependencyFilterMap semantics.",
|
|
1338
|
+
"Date range business shortcuts are authored as built-in ids or backend-resolved static ranges; browser metadata never carries calculateRange code or business calendar rules.",
|
|
1339
|
+
"JSON-only support is incomplete when visual editor coverage is required.",
|
|
1340
|
+
"Schema normalization must preserve advanced canonical properties through open, edit, apply/save, reopen and runtime consumption."
|
|
1341
|
+
],
|
|
1342
|
+
"examples": [
|
|
1343
|
+
{
|
|
1344
|
+
"id": "set-label",
|
|
1345
|
+
"request": "Set this field label to Customer name.",
|
|
1346
|
+
"operationId": "fieldMetadata.property.set",
|
|
1347
|
+
"params": {
|
|
1348
|
+
"path": "label",
|
|
1349
|
+
"value": "Customer name"
|
|
1350
|
+
},
|
|
1351
|
+
"isPositive": true
|
|
1352
|
+
},
|
|
1353
|
+
{
|
|
1354
|
+
"id": "set-control-type",
|
|
1355
|
+
"request": "Change this field to a select control.",
|
|
1356
|
+
"operationId": "controlType.set",
|
|
1357
|
+
"params": {
|
|
1358
|
+
"controlType": "select",
|
|
1359
|
+
"preserveCompatibleProperties": true
|
|
1360
|
+
},
|
|
1361
|
+
"isPositive": true
|
|
1362
|
+
},
|
|
1363
|
+
{
|
|
1364
|
+
"id": "configure-remote-options",
|
|
1365
|
+
"request": "Load options from the customers resource using id and name.",
|
|
1366
|
+
"operationId": "optionSource.configure",
|
|
1367
|
+
"params": {
|
|
1368
|
+
"kind": "resource",
|
|
1369
|
+
"resource": "customers",
|
|
1370
|
+
"valueField": "id",
|
|
1371
|
+
"labelField": "name"
|
|
1372
|
+
},
|
|
1373
|
+
"isPositive": true
|
|
1374
|
+
},
|
|
1375
|
+
{
|
|
1376
|
+
"id": "configure-cascade",
|
|
1377
|
+
"request": "Filter city options when state changes.",
|
|
1378
|
+
"operationId": "cascade.configure",
|
|
1379
|
+
"params": {
|
|
1380
|
+
"dependentField": "city",
|
|
1381
|
+
"sourceField": "state",
|
|
1382
|
+
"dependencyFilterMap": {
|
|
1383
|
+
"stateId": "state.id"
|
|
1384
|
+
}
|
|
1385
|
+
},
|
|
1386
|
+
"isPositive": true
|
|
1387
|
+
},
|
|
1388
|
+
{
|
|
1389
|
+
"id": "configure-renderer",
|
|
1390
|
+
"request": "Expose placeholder in the visual editor as a text field.",
|
|
1391
|
+
"operationId": "renderer.configure",
|
|
1392
|
+
"params": {
|
|
1393
|
+
"propertyName": "placeholder",
|
|
1394
|
+
"editorType": "text",
|
|
1395
|
+
"group": "Presentation"
|
|
1396
|
+
},
|
|
1397
|
+
"isPositive": true
|
|
1398
|
+
},
|
|
1399
|
+
{
|
|
1400
|
+
"id": "add-required-validation",
|
|
1401
|
+
"request": "Make this field required with a validation message.",
|
|
1402
|
+
"operationId": "validationRule.add",
|
|
1403
|
+
"params": {
|
|
1404
|
+
"rule": {
|
|
1405
|
+
"type": "required"
|
|
1406
|
+
},
|
|
1407
|
+
"message": "Required field"
|
|
1408
|
+
},
|
|
1409
|
+
"isPositive": true
|
|
1410
|
+
},
|
|
1411
|
+
{
|
|
1412
|
+
"id": "set-context-hint",
|
|
1413
|
+
"request": "Add a contextual hint for sales users.",
|
|
1414
|
+
"operationId": "contextHint.set",
|
|
1415
|
+
"params": {
|
|
1416
|
+
"hintPath": "helpText",
|
|
1417
|
+
"value": "Use the legal customer name."
|
|
1418
|
+
},
|
|
1419
|
+
"isPositive": true
|
|
1420
|
+
},
|
|
1421
|
+
{
|
|
1422
|
+
"id": "configure-date-range-business-shortcut",
|
|
1423
|
+
"request": "Add a fiscal competence period resolved by the backend to this inline date range.",
|
|
1424
|
+
"operationId": "dateRangeShortcuts.configure",
|
|
1425
|
+
"params": {
|
|
1426
|
+
"shortcuts": [
|
|
1427
|
+
"thisMonth",
|
|
1428
|
+
{
|
|
1429
|
+
"id": "competencia-fiscal-marco",
|
|
1430
|
+
"label": "Fiscal competence March",
|
|
1431
|
+
"startDate": "2026-03-01",
|
|
1432
|
+
"endDate": "2026-03-31",
|
|
1433
|
+
"timeZone": "America/Sao_Paulo",
|
|
1434
|
+
"tone": "success"
|
|
1435
|
+
}
|
|
1436
|
+
],
|
|
1437
|
+
"inlineQuickPresets": {
|
|
1438
|
+
"enabled": true,
|
|
1439
|
+
"position": "start",
|
|
1440
|
+
"maxVisible": 4
|
|
1441
|
+
},
|
|
1442
|
+
"applyMode": "explicit"
|
|
1443
|
+
},
|
|
1444
|
+
"isPositive": true
|
|
1445
|
+
},
|
|
1446
|
+
{
|
|
1447
|
+
"id": "reject-date-range-executable-shortcut",
|
|
1448
|
+
"request": "Add a date range shortcut that calculates fiscal holidays in calculateRange from JSON.",
|
|
1449
|
+
"operationId": "dateRangeShortcuts.configure",
|
|
1450
|
+
"params": {
|
|
1451
|
+
"shortcuts": [
|
|
1452
|
+
{
|
|
1453
|
+
"id": "legal-days",
|
|
1454
|
+
"label": "Legal days",
|
|
1455
|
+
"startDate": "2026-03-01",
|
|
1456
|
+
"endDate": "2026-03-31",
|
|
1457
|
+
"calculateRange": "() => legalCalendar()"
|
|
1458
|
+
}
|
|
1459
|
+
]
|
|
1460
|
+
},
|
|
1461
|
+
"isPositive": false
|
|
1462
|
+
},
|
|
1463
|
+
{
|
|
1464
|
+
"id": "normalize-seed",
|
|
1465
|
+
"request": "Normalize this imported field metadata while preserving advanced properties.",
|
|
1466
|
+
"operationId": "normalization.apply",
|
|
1467
|
+
"params": {
|
|
1468
|
+
"mode": "preserve-advanced-properties",
|
|
1469
|
+
"preserveUnknownCanonicalFields": true
|
|
1470
|
+
},
|
|
1471
|
+
"isPositive": true
|
|
1472
|
+
},
|
|
1473
|
+
{
|
|
1474
|
+
"id": "reject-unknown-control",
|
|
1475
|
+
"request": "Use an unknown control type named magic-picker.",
|
|
1476
|
+
"operationId": "controlType.set",
|
|
1477
|
+
"params": {
|
|
1478
|
+
"controlType": "magic-picker"
|
|
1479
|
+
},
|
|
1480
|
+
"isPositive": false
|
|
1481
|
+
},
|
|
1482
|
+
{
|
|
1483
|
+
"id": "reject-json-only-coverage",
|
|
1484
|
+
"request": "Support this field only by editing raw JSON.",
|
|
1485
|
+
"operationId": "renderer.configure",
|
|
1486
|
+
"params": {
|
|
1487
|
+
"propertyName": "optionSource",
|
|
1488
|
+
"editorType": "json"
|
|
1489
|
+
},
|
|
1490
|
+
"isPositive": false
|
|
1491
|
+
},
|
|
1492
|
+
{
|
|
1493
|
+
"id": "reject-cascade-cycle",
|
|
1494
|
+
"request": "Make field A depend on B and B depend on A.",
|
|
1495
|
+
"operationId": "cascade.configure",
|
|
1496
|
+
"params": {
|
|
1497
|
+
"dependentField": "a",
|
|
1498
|
+
"sourceField": "b"
|
|
1499
|
+
},
|
|
1500
|
+
"isPositive": false
|
|
1501
|
+
},
|
|
1502
|
+
{
|
|
1503
|
+
"id": "reject-host-only-option-source",
|
|
1504
|
+
"request": "Save a host-only URL string as the option source.",
|
|
1505
|
+
"operationId": "optionSource.configure",
|
|
1506
|
+
"params": {
|
|
1507
|
+
"kind": "remote",
|
|
1508
|
+
"endpoint": "local-only://options"
|
|
1509
|
+
},
|
|
1510
|
+
"isPositive": false
|
|
1511
|
+
}
|
|
1512
|
+
]
|
|
1513
|
+
},
|
|
1514
|
+
"chunks": [
|
|
1515
|
+
{
|
|
1516
|
+
"chunkIndex": 0,
|
|
1517
|
+
"chunkKind": "summary",
|
|
1518
|
+
"content": "Component ID: praxis-metadata-editor\nSelector: praxis-field-metadata-editor\nFriendly Name: Praxis Metadata Editor\nDescription: Editor for field metadata and schema helpers.\nLib/Package: @praxisui/metadata-editor\nTags: widget, metadata, configurable\nInputs:\n - controlType (FieldControlType)\n - seed (Partial<FieldDefinition>)\nOutputs:\n - applied (Partial<FieldDefinition>)\n - cancel (void)\n",
|
|
1519
|
+
"sourcePointer": "projects/praxis-metadata-editor/src/lib/praxis-metadata-editor.metadata.ts",
|
|
1520
|
+
"contentHash": "553cc0efd72287cd0ae4903ef352e67534fb20b5423f32e39526318f988697f4",
|
|
1521
|
+
"sourceKind": "component_definition",
|
|
1522
|
+
"sourceId": "praxis-metadata-editor",
|
|
1523
|
+
"corpusVersion": "1.0.0"
|
|
1524
|
+
},
|
|
1525
|
+
{
|
|
1526
|
+
"chunkIndex": 1,
|
|
1527
|
+
"chunkKind": "authoring_manifest",
|
|
1528
|
+
"content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-metadata-editor\",\"ownerPackage\":\"@praxisui/metadata-editor\",\"configSchemaId\":\"FieldMetadata\",\"chunkSection\":\"identity\"}",
|
|
1529
|
+
"sourcePointer": "projects/praxis-metadata-editor/src/lib/ai/praxis-metadata-editor-authoring-manifest.ts",
|
|
1530
|
+
"contentHash": "af432d637fb53cd5b75204ca11b5501fd679770d3d52d5def44896f4c2f5aab9",
|
|
1531
|
+
"sourceKind": "component_definition",
|
|
1532
|
+
"sourceId": "praxis-metadata-editor",
|
|
1533
|
+
"corpusVersion": "1.0.0"
|
|
1534
|
+
},
|
|
1535
|
+
{
|
|
1536
|
+
"chunkIndex": 2,
|
|
1537
|
+
"chunkKind": "authoring_manifest",
|
|
1538
|
+
"content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-metadata-editor\",\"ownerPackage\":\"@praxisui/metadata-editor\",\"configSchemaId\":\"FieldMetadata\",\"chunkSection\":\"runtimeInputs\",\"runtimeInputs\":[{\"name\":\"controlType\",\"type\":\"FieldControlType\",\"description\":\"Canonical control type used to resolve editor property coverage.\"},{\"name\":\"seed\",\"type\":\"Partial<FieldMetadata | FieldDefinition>\",\"description\":\"Initial canonical field metadata used to hydrate the editor.\"},{\"name\":\"fields\",\"type\":\"Array<FieldMetadata | FieldDefinition>\",\"description\":\"Available fields used by cascade authoring and context validation.\"},{\"name\":\"properties\",\"type\":\"EditorProperty[]\",\"description\":\"Renderer property catalog resolved from ConfigRegistryService.\"},{\"name\":\"form\",\"type\":\"FormGroup\",\"description\":\"Dynamic form generated from canonical editor properties by DynamicFormFactoryService.\"}]}",
|
|
1539
|
+
"sourcePointer": "projects/praxis-metadata-editor/src/lib/ai/praxis-metadata-editor-authoring-manifest.ts",
|
|
1540
|
+
"contentHash": "9172c06a0dad6eba9662ee2f0f64c17a2058471166d673e9cb3b60733dabf7d2",
|
|
1541
|
+
"sourceKind": "component_definition",
|
|
1542
|
+
"sourceId": "praxis-metadata-editor",
|
|
1543
|
+
"corpusVersion": "1.0.0"
|
|
1544
|
+
},
|
|
1545
|
+
{
|
|
1546
|
+
"chunkIndex": 3,
|
|
1547
|
+
"chunkKind": "authoring_manifest",
|
|
1548
|
+
"content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-metadata-editor\",\"ownerPackage\":\"@praxisui/metadata-editor\",\"configSchemaId\":\"FieldMetadata\",\"chunkSection\":\"editableTargets\",\"editableTargets\":[{\"kind\":\"fieldMetadata\",\"resolver\":\"field-metadata-json-path\",\"description\":\"Canonical FieldMetadata root and property paths.\"},{\"kind\":\"controlType\",\"resolver\":\"dynamic-fields-control-type-discovery\",\"description\":\"Control type selected from dynamic-fields discovery and editor config registry.\"},{\"kind\":\"optionSource\",\"resolver\":\"field-metadata-option-source\",\"description\":\"Canonical option source including backend x-ui option source fields where applicable.\"},{\"kind\":\"cascade\",\"resolver\":\"metadata-editor-cascade-rules\",\"description\":\"Cascade dependencies and dependency filter mappings edited through CascadeManagerTab.\"},{\"kind\":\"renderer\",\"resolver\":\"metadata-editor-renderer-property\",\"description\":\"Dynamic editor renderer property coverage and editor component mapping.\"},{\"kind\":\"validation\",\"resolver\":\"field-metadata-validation-rules\",\"description\":\"Field validation rules and contextual validators.\"},{\"kind\":\"dateRangeShortcuts\",\"resolver\":\"metadata-editor-date-range-shortcut-catalog\",\"description\":\"Governed static date range shortcut catalog for dateRange and inlineDateRange metadata.\"},{\"kind\":\"contextHint\",\"resolver\":\"metadata-editor-context-hints\",\"description\":\"Authoring hints, help text and contextual guidance for metadata editors.\"},{\"kind\":\"normalization\",\"resolver\":\"metadata-editor-schema-normalizer\",\"description\":\"Schema normalization and seed hydration rules.\"}]}",
|
|
1549
|
+
"sourcePointer": "projects/praxis-metadata-editor/src/lib/ai/praxis-metadata-editor-authoring-manifest.ts",
|
|
1550
|
+
"contentHash": "5364ad3da2fec36bd907ac5bd33ba45e34edc08767d9ec41d91aa6e66b55702c",
|
|
1551
|
+
"sourceKind": "component_definition",
|
|
1552
|
+
"sourceId": "praxis-metadata-editor",
|
|
1553
|
+
"corpusVersion": "1.0.0"
|
|
1554
|
+
},
|
|
1555
|
+
{
|
|
1556
|
+
"chunkIndex": 4,
|
|
1557
|
+
"chunkKind": "authoring_manifest",
|
|
1558
|
+
"content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-metadata-editor\",\"ownerPackage\":\"@praxisui/metadata-editor\",\"configSchemaId\":\"FieldMetadata\",\"chunkSection\":\"operations\",\"operations\":[{\"operationId\":\"fieldMetadata.property.set\",\"title\":\"Set FieldMetadata property\",\"scope\":\"fieldMetadataPath\",\"targetKind\":\"fieldMetadata\",\"target\":{\"kind\":\"fieldMetadata\",\"resolver\":\"field-metadata-json-path\",\"ambiguityPolicy\":\"fail\",\"required\":true},\"inputSchema\":{\"type\":\"object\",\"required\":[\"path\",\"value\"],\"properties\":{\"path\":{\"enum\":[\"name\",\"label\",\"description\",\"controlType\",\"placeholder\",\"defaultValue\",\"group\",\"order\",\"required\",\"disabled\",\"readOnly\",\"hidden\",\"source\",\"transient\",\"submitPolicy\",\"hint\",\"helpText\",\"tooltip\",\"valuePresentation\",\"presentation\",\"presentation.presenter\",\"presentation.tone\",\"presentation.appearance\",\"presentation.icon\",\"presentation.label\",\"presentation.badge\",\"presentation.tooltip\",\"presentationRules\",\"options\",\"optionSource\",\"validators\",\"conditionalRequired\",\"conditionalDisplay\",\"visibleIn\",\"ariaLabel\",\"ariaDescribedBy\"]},\"value\":{},\"merge\":{\"type\":\"boolean\"}}},\"effects\":[{\"kind\":\"compile-domain-patch\",\"handler\":\"metadata-field-property-set\",\"handlerContract\":{\"reads\":[\"fieldMetadata\",\"fieldMetadataPath\",\"SchemaNormalizerService\"],\"writes\":[\"fieldMetadata\"],\"identityKeys\":[\"field.name\",\"path\"],\"failureModes\":[\"unknown-field-metadata-path\",\"non-canonical-shape\",\"readonly-field\",\"normalization-failed\"],\"description\":\"Sets a canonical FieldMetadata property through a governed metadata path and re-runs schema normalization.\"}}],\"destructive\":false,\"requiresConfirmation\":false,\"validators\":[\"field-metadata-shape-canonical\",\"field-path-supported-by-editor\",\"metadata-round-trip\"],\"affectedPaths\":[\"fieldMetadata\"],\"submissionImpact\":\"affects-schema-backed-data\",\"preconditions\":[\"field-metadata-loaded\"]},{\"operationId\":\"controlType.set\",\"title\":\"Set control type\",\"scope\":\"controlType\",\"targetKind\":\"controlType\",\"target\":{\"kind\":\"controlType\",\"resolver\":\"dynamic-fields-control-type-discovery\",\"ambiguityPolicy\":\"fail\",\"required\":true},\"inputSchema\":{\"type\":\"object\",\"required\":[\"controlType\"],\"properties\":{\"controlType\":{\"type\":\"string\"},\"preserveCompatibleProperties\":{\"type\":\"boolean\"}}},\"effects\":[{\"kind\":\"compile-domain-patch\",\"handler\":\"metadata-control-type-set\",\"handlerContract\":{\"reads\":[\"FieldControlType\",\"ConfigRegistryService\",\"dynamic-fields-discovery\",\"fieldMetadata\"],\"writes\":[\"fieldMetadata.controlType\",\"properties\",\"normalizedSeed\"],\"identityKeys\":[\"field.name\",\"controlType\"],\"inputSchema\":{\"type\":\"object\",\"required\":[\"controlType\"],\"properties\":{\"controlType\":{\"type\":\"string\"},\"preserveCompatibleProperties\":{\"type\":\"boolean\"}}},\"failureModes\":[\"control-type-not-discovered\",\"editor-coverage-missing\",\"incompatible-metadata-preservation\"],\"description\":\"Changes control type only when dynamic-fields discovery and metadata-editor config registry both expose renderer/editor coverage.\"}}],\"destructive\":false,\"requiresConfirmation\":false,\"validators\":[\"control-type-exists-in-discovery\",\"editor-coverage-exists\",\"metadata-round-trip\"],\"affectedPaths\":[\"fieldMetadata.controlType\",\"properties\",\"normalizedSeed\"],\"submissionImpact\":\"affects-schema-backed-data\",\"preconditions\":[\"dynamic-fields-discovery-loaded\"]},{\"operationId\":\"optionSource.configure\",\"title\":\"Configure option source\",\"scope\":\"dataBinding\",\"targetKind\":\"optionSource\",\"target\":{\"kind\":\"optionSource\",\"resolver\":\"field-metadata-option-source\",\"ambiguityPolicy\":\"fail\",\"required\":false},\"inputSchema\":{\"type\":\"object\",\"minProperties\":1,\"properties\":{\"kind\":{\"enum\":[\"static\",\"remote\",\"resource\",\"lookup\"]},\"resource\":{\"type\":\"string\"},\"endpoint\":{\"type\":\"string\"},\"valueField\":{\"type\":\"string\"},\"labelField\":{\"type\":\"string\"},\"dependsOn\":{\"type\":\"string\"},\"dependencyFilterMap\":{\"type\":\"object\"},\"display\":{\"type\":\"object\",\"properties\":{\"preset\":{\"enum\":[\"compact\",\"rich\",\"directory\",\"status\",\"reference\",\"hierarchical\"]},\"usage\":{\"enum\":[\"form\",\"filter\",\"table-cell\",\"dashboard\",\"wizard\",\"review\"]},\"density\":{\"enum\":[\"compact\",\"comfortable\",\"rich\"]},\"selectedLayout\":{\"enum\":[\"card\",\"inline\",\"compact\",\"token\"]},\"resultLayout\":{\"enum\":[\"list\",\"denseList\",\"table\",\"card\"]},\"primaryPropertyPath\":{\"type\":\"string\"},\"fields\":{\"type\":\"array\"},\"secondaryPropertyPaths\":{\"type\":\"array\"},\"badgePropertyPaths\":{\"type\":\"array\"},\"statusToneMap\":{\"type\":\"object\"}}},\"detail\":{\"type\":\"object\",\"properties\":{\"kind\":{\"enum\":[\"surface\",\"route\",\"href\"]},\"surfaceId\":{\"type\":\"string\"},\"presentation\":{\"enum\":[\"drawer\",\"modal\"]},\"preferredWidget\":{\"type\":\"string\"},\"mode\":{\"enum\":[\"view\",\"edit\",\"create\"]}}},\"options\":{\"type\":\"array\"}}},\"effects\":[{\"kind\":\"compile-domain-patch\",\"handler\":\"metadata-option-source-configure\",\"handlerContract\":{\"reads\":[\"fieldMetadata.optionSource\",\"backend.x-ui.optionSource\",\"SchemaNormalizerService\"],\"writes\":[\"fieldMetadata.optionSource\"],\"identityKeys\":[\"field.name\",\"optionSource.kind\",\"optionSource.resource\"],\"failureModes\":[\"invalid-option-source-kind\",\"remote-source-missing-governed-resource\",\"dependency-filter-map-invalid\"],\"description\":\"Configures canonical optionSource fields while preserving backend x-ui dependsOn and dependencyFilterMap semantics.\"}}],\"destructive\":false,\"requiresConfirmation\":false,\"validators\":[\"option-source-shape-canonical\",\"remote-option-source-governed\",\"cascade-backend-shape-preserved\",\"metadata-round-trip\"],\"affectedPaths\":[\"fieldMetadata.optionSource\"],\"submissionImpact\":\"affects-remote-binding\",\"preconditions\":[\"field-metadata-loaded\"]}]}",
|
|
1559
|
+
"sourcePointer": "projects/praxis-metadata-editor/src/lib/ai/praxis-metadata-editor-authoring-manifest.ts",
|
|
1560
|
+
"contentHash": "598c633fd2be87883e5edcd517f43b74853e8db3a99dbb8e62223d531fc14852",
|
|
1561
|
+
"sourceKind": "component_definition",
|
|
1562
|
+
"sourceId": "praxis-metadata-editor",
|
|
1563
|
+
"corpusVersion": "1.0.0"
|
|
1564
|
+
},
|
|
1565
|
+
{
|
|
1566
|
+
"chunkIndex": 5,
|
|
1567
|
+
"chunkKind": "authoring_manifest",
|
|
1568
|
+
"content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-metadata-editor\",\"ownerPackage\":\"@praxisui/metadata-editor\",\"configSchemaId\":\"FieldMetadata\",\"chunkSection\":\"operations\",\"operations\":[{\"operationId\":\"cascade.configure\",\"title\":\"Configure cascade rule\",\"scope\":\"interaction\",\"targetKind\":\"cascade\",\"target\":{\"kind\":\"cascade\",\"resolver\":\"metadata-editor-cascade-rules\",\"ambiguityPolicy\":\"fail\",\"required\":false},\"inputSchema\":{\"type\":\"object\",\"required\":[\"dependentField\"],\"properties\":{\"dependentField\":{\"type\":\"string\"},\"sourceField\":{\"type\":\"string\"},\"strategy\":{\"enum\":[\"replace\",\"merge\"]},\"debounceMs\":{\"type\":\"number\"},\"loadMode\":{\"enum\":[\"immediate\",\"manual\",\"respectLoadOn\"]},\"dependencyFilterMap\":{\"type\":\"object\"},\"optionSource\":{\"type\":\"object\",\"properties\":{\"kind\":{\"enum\":[\"static\",\"remote\",\"resource\",\"lookup\"]},\"resource\":{\"type\":\"string\"},\"endpoint\":{\"type\":\"string\"},\"dependsOn\":{\"type\":\"string\"},\"dependencyFilterMap\":{\"type\":\"object\"}}}}},\"effects\":[{\"kind\":\"compile-domain-patch\",\"handler\":\"metadata-cascade-configure\",\"handlerContract\":{\"reads\":[\"CascadeManagerTabComponent\",\"CascadeRulesService\",\"fields\",\"fieldMetadata.optionSource\",\"fieldMetadata.dependencyFields\",\"fieldMetadata.dependencyFilterMap\"],\"writes\":[\"fieldMetadata.dependencyFields\",\"fieldMetadata.enableDependencyCascade\",\"fieldMetadata.resetOnDependentChange\",\"fieldMetadata.dependencyFilterMap\",\"fieldMetadata.dependencyValuePath\",\"fieldMetadata.dependencyMergeStrategy\",\"fieldMetadata.dependencyDebounceMs\",\"fieldMetadata.dependencyLoadOnChange\",\"fieldMetadata.optionSource.dependsOn\",\"fieldMetadata.optionSource.dependencyFilterMap\"],\"identityKeys\":[\"dependentField\",\"sourceField\"],\"failureModes\":[\"dependent-field-not-found\",\"source-field-not-found\",\"cascade-cycle-detected\",\"dependency-filter-map-invalid\"],\"description\":\"Applies cascade dependencies through CascadeRulesService using the metadata-editor save contract while preserving backend x-ui optionSource dependency semantics during hydration.\"}}],\"destructive\":false,\"requiresConfirmation\":false,\"validators\":[\"cascade-fields-exist\",\"cascade-cycle-free\",\"cascade-backend-shape-preserved\",\"option-source-shape-canonical\",\"remote-option-source-governed\",\"metadata-round-trip\"],\"affectedPaths\":[\"fieldMetadata.dependencyFields\",\"fieldMetadata.enableDependencyCascade\",\"fieldMetadata.resetOnDependentChange\",\"fieldMetadata.dependencyFilterMap\",\"fieldMetadata.dependencyValuePath\",\"fieldMetadata.dependencyMergeStrategy\",\"fieldMetadata.dependencyDebounceMs\",\"fieldMetadata.dependencyLoadOnChange\",\"fieldMetadata.optionSource.dependsOn\",\"fieldMetadata.optionSource.dependencyFilterMap\"],\"submissionImpact\":\"affects-remote-binding\",\"preconditions\":[\"field-list-loaded\"]},{\"operationId\":\"renderer.configure\",\"title\":\"Configure renderer coverage\",\"scope\":\"editorCoverage\",\"targetKind\":\"renderer\",\"target\":{\"kind\":\"renderer\",\"resolver\":\"metadata-editor-renderer-property\",\"ambiguityPolicy\":\"fail\",\"required\":true},\"inputSchema\":{\"type\":\"object\",\"required\":[\"propertyName\",\"editorType\"],\"properties\":{\"propertyName\":{\"type\":\"string\"},\"editorType\":{\"type\":\"string\"},\"group\":{\"type\":\"string\"},\"required\":{\"type\":\"boolean\"},\"options\":{\"type\":\"array\"}}},\"effects\":[{\"kind\":\"compile-domain-patch\",\"handler\":\"metadata-renderer-configure\",\"handlerContract\":{\"reads\":[\"DynamicEditorRendererComponent\",\"EditorComponentRegistryService\",\"ConfigRegistryService\",\"EditorProperty\"],\"writes\":[\"properties\",\"editorCoverage\"],\"identityKeys\":[\"controlType\",\"propertyName\"],\"inputSchema\":{\"type\":\"object\",\"required\":[\"propertyName\",\"editorType\"],\"properties\":{\"propertyName\":{\"type\":\"string\"},\"editorType\":{\"type\":\"string\"},\"group\":{\"type\":\"string\"}}},\"failureModes\":[\"editor-type-not-registered\",\"property-not-covered\",\"json-only-coverage-not-accepted\"],\"description\":\"Configures visual renderer coverage for a metadata property and rejects JSON-only support for required visual authoring.\"}}],\"destructive\":false,\"requiresConfirmation\":false,\"validators\":[\"renderer-editor-type-registered\",\"visual-editor-coverage-required\",\"editor-coverage-exists\",\"metadata-round-trip\"],\"affectedPaths\":[\"properties\",\"editorCoverage\"],\"submissionImpact\":\"config-only\",\"preconditions\":[\"config-registry-loaded\"]},{\"operationId\":\"validationRule.add\",\"title\":\"Add validation rule\",\"scope\":\"fieldMetadataPath\",\"targetKind\":\"validation\",\"target\":{\"kind\":\"validation\",\"resolver\":\"field-metadata-validation-rules\",\"ambiguityPolicy\":\"fail\",\"required\":false},\"inputSchema\":{\"type\":\"object\",\"required\":[\"rule\"],\"properties\":{\"rule\":{\"type\":\"object\"},\"message\":{\"type\":\"string\"},\"contextValidatorId\":{\"type\":\"string\"}}},\"effects\":[{\"kind\":\"compile-domain-patch\",\"handler\":\"metadata-validation-rule-add\",\"handlerContract\":{\"reads\":[\"fieldMetadata.validators\",\"ContextValidatorRegistryService\",\"DynamicFormFactoryService\"],\"writes\":[\"fieldMetadata.validators\"],\"identityKeys\":[\"field.name\",\"rule.type\",\"contextValidatorId\"],\"inputSchema\":{\"type\":\"object\",\"required\":[\"rule\"],\"properties\":{\"rule\":{\"type\":\"object\"},\"message\":{\"type\":\"string\"},\"contextValidatorId\":{\"type\":\"string\"}}},\"failureModes\":[\"validation-rule-invalid\",\"context-validator-not-registered\",\"duplicate-validation-rule\"],\"description\":\"Adds a canonical validation rule and verifies contextual validator availability before persistence.\"}}],\"destructive\":false,\"requiresConfirmation\":false,\"validators\":[\"validation-rule-canonical\",\"context-validator-registered\",\"metadata-round-trip\"],\"affectedPaths\":[\"fieldMetadata.validators\"],\"submissionImpact\":\"affects-submission\",\"preconditions\":[\"field-metadata-loaded\"]},{\"operationId\":\"contextHint.set\",\"title\":\"Set metadata context hint\",\"scope\":\"meta\",\"targetKind\":\"contextHint\",\"target\":{\"kind\":\"contextHint\",\"resolver\":\"metadata-editor-context-hints\",\"ambiguityPolicy\":\"fail\",\"required\":false},\"inputSchema\":{\"type\":\"object\",\"required\":[\"hintPath\",\"value\"],\"properties\":{\"hintPath\":{\"enum\":[\"hint\",\"helpText\",\"description\",\"tooltip\",\"ariaLabel\",\"ariaDescribedBy\"]},\"value\":{},\"localeKey\":{\"type\":\"string\"}}},\"effects\":[{\"kind\":\"compile-domain-patch\",\"handler\":\"metadata-context-hint-set\",\"handlerContract\":{\"reads\":[\"fieldMetadata.hint\",\"fieldMetadata.helpText\",\"fieldMetadata.description\",\"fieldMetadata.tooltip\",\"fieldMetadata.ariaLabel\",\"fieldMetadata.ariaDescribedBy\",\"metadata-editor-i18n\"],\"writes\":[\"fieldMetadata.hint\",\"fieldMetadata.helpText\",\"fieldMetadata.description\",\"fieldMetadata.tooltip\",\"fieldMetadata.ariaLabel\",\"fieldMetadata.ariaDescribedBy\"],\"identityKeys\":[\"field.name\",\"hintPath\"],\"inputSchema\":{\"type\":\"object\",\"required\":[\"hintPath\",\"value\"],\"properties\":{\"hintPath\":{\"enum\":[\"hint\",\"helpText\",\"description\",\"tooltip\",\"ariaLabel\",\"ariaDescribedBy\"]},\"value\":{},\"localeKey\":{\"type\":\"string\"}}},\"failureModes\":[\"hint-path-not-canonical\",\"hint-value-not-serializable\",\"i18n-key-missing\"],\"description\":\"Sets structured FieldMetadata hint/help/accessibility text through canonical metadata paths and metadata-editor i18n constraints.\"}}],\"destructive\":false,\"requiresConfirmation\":false,\"validators\":[\"context-hint-shape-canonical\",\"context-hint-i18n-compatible\",\"metadata-round-trip\"],\"affectedPaths\":[\"fieldMetadata.hint\",\"fieldMetadata.helpText\",\"fieldMetadata.description\",\"fieldMetadata.tooltip\",\"fieldMetadata.ariaLabel\",\"fieldMetadata.ariaDescribedBy\"],\"submissionImpact\":\"visual-only\",\"preconditions\":[\"field-metadata-loaded\"]}]}",
|
|
1569
|
+
"sourcePointer": "projects/praxis-metadata-editor/src/lib/ai/praxis-metadata-editor-authoring-manifest.ts",
|
|
1570
|
+
"contentHash": "687144fc1d20d921fe166a720bf19510be0acde0f3101e35e82821a234ad6edc",
|
|
1571
|
+
"sourceKind": "component_definition",
|
|
1572
|
+
"sourceId": "praxis-metadata-editor",
|
|
1573
|
+
"corpusVersion": "1.0.0"
|
|
1574
|
+
},
|
|
1575
|
+
{
|
|
1576
|
+
"chunkIndex": 6,
|
|
1577
|
+
"chunkKind": "authoring_manifest",
|
|
1578
|
+
"content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-metadata-editor\",\"ownerPackage\":\"@praxisui/metadata-editor\",\"configSchemaId\":\"FieldMetadata\",\"chunkSection\":\"operations\",\"operations\":[{\"operationId\":\"dateRangeShortcuts.configure\",\"title\":\"Configure governed date range shortcuts\",\"scope\":\"fieldMetadataPath\",\"targetKind\":\"dateRangeShortcuts\",\"target\":{\"kind\":\"dateRangeShortcuts\",\"resolver\":\"metadata-editor-date-range-shortcut-catalog\",\"ambiguityPolicy\":\"fail\",\"required\":false},\"inputSchema\":{\"type\":\"object\",\"required\":[\"shortcuts\"],\"properties\":{\"shortcuts\":{\"type\":\"array\",\"items\":{\"anyOf\":[{\"enum\":[\"today\",\"yesterday\",\"thisWeek\",\"lastWeek\",\"thisMonth\",\"lastMonth\",\"thisYear\",\"lastYear\"]},{\"type\":\"object\",\"required\":[\"id\",\"label\",\"startDate\",\"endDate\"],\"additionalProperties\":false,\"properties\":{\"id\":{\"type\":\"string\",\"minLength\":1},\"label\":{\"type\":\"string\",\"minLength\":1},\"startDate\":{\"type\":\"string\",\"pattern\":\"^\\\\d{4}-\\\\d{2}-\\\\d{2}$\"},\"endDate\":{\"type\":\"string\",\"pattern\":\"^\\\\d{4}-\\\\d{2}-\\\\d{2}$\"},\"timeZone\":{\"type\":\"string\"},\"icon\":{\"type\":\"string\"},\"description\":{\"type\":\"string\"},\"tone\":{\"enum\":[\"neutral\",\"info\",\"success\",\"warning\"]},\"effectiveFrom\":{\"type\":\"string\",\"pattern\":\"^\\\\d{4}-\\\\d{2}-\\\\d{2}$\"},\"effectiveTo\":{\"type\":\"string\",\"pattern\":\"^\\\\d{4}-\\\\d{2}-\\\\d{2}$\"},\"order\":{\"type\":\"number\"}}}]}},\"inlineQuickPresets\":{\"type\":\"object\",\"properties\":{\"enabled\":{\"type\":\"boolean\"},\"maxVisible\":{\"type\":\"number\"},\"position\":{\"enum\":[\"auto\",\"footer\",\"start\",\"end\"]}}},\"applyMode\":{\"enum\":[\"auto\",\"explicit\"]}}},\"effects\":[{\"kind\":\"compile-domain-patch\",\"handler\":\"metadata-date-range-shortcuts-configure\",\"handlerContract\":{\"reads\":[\"fieldMetadata.controlType\",\"fieldMetadata.shortcuts\",\"fieldMetadata.inlineQuickPresets\",\"fieldMetadata.inlineOverlay\",\"ConfigRegistryService\"],\"writes\":[\"fieldMetadata.shortcuts\",\"fieldMetadata.inlineQuickPresets\",\"fieldMetadata.inlineOverlay.applyMode\"],\"identityKeys\":[\"field.name\",\"shortcuts[].id\"],\"failureModes\":[\"control-type-not-date-range\",\"duplicate-shortcut-id\",\"invalid-static-date-range-shortcut\",\"unsupported-shortcut-tone\",\"executable-shortcut-metadata\"],\"description\":\"Configures built-in and backend-resolved static date range shortcuts through the canonical shortcuts array; JSON metadata may not contain calculateRange or executable expressions.\"}}],\"destructive\":false,\"requiresConfirmation\":false,\"validators\":[\"date-range-shortcuts-static-canonical\",\"date-range-shortcuts-no-executable-metadata\",\"date-range-shortcuts-unique-ids\",\"metadata-round-trip\"],\"affectedPaths\":[\"fieldMetadata.shortcuts\",\"fieldMetadata.inlineQuickPresets\",\"fieldMetadata.inlineOverlay.applyMode\"],\"submissionImpact\":\"affects-schema-backed-data\",\"preconditions\":[\"field-metadata-loaded\",\"editor-properties-loaded\"]},{\"operationId\":\"normalization.apply\",\"title\":\"Apply schema normalization\",\"scope\":\"runtimeCoverage\",\"targetKind\":\"normalization\",\"target\":{\"kind\":\"normalization\",\"resolver\":\"metadata-editor-schema-normalizer\",\"ambiguityPolicy\":\"fail\",\"required\":false},\"inputSchema\":{\"type\":\"object\",\"properties\":{\"mode\":{\"enum\":[\"hydrate-seed\",\"coerce-types\",\"apply-defaults\",\"preserve-advanced-properties\"]},\"preserveUnknownCanonicalFields\":{\"type\":\"boolean\"}}},\"effects\":[{\"kind\":\"compile-domain-patch\",\"handler\":\"metadata-normalization-apply\",\"handlerContract\":{\"reads\":[\"SchemaNormalizerService\",\"fieldMetadata\",\"properties\",\"DynamicFormFactoryService\"],\"writes\":[\"normalizedSeed\",\"form\",\"fieldMetadata\"],\"identityKeys\":[\"field.name\",\"controlType\",\"mode\"],\"inputSchema\":{\"type\":\"object\",\"properties\":{\"mode\":{\"enum\":[\"hydrate-seed\",\"coerce-types\",\"apply-defaults\",\"preserve-advanced-properties\"]},\"preserveUnknownCanonicalFields\":{\"type\":\"boolean\"}}},\"failureModes\":[\"normalizer-missing\",\"type-coercion-failed\",\"advanced-property-lost\",\"runtime-editor-drift\"],\"description\":\"Runs metadata-editor schema normalization while preserving canonical advanced FieldMetadata properties and editor/runtime round-trip.\"}}],\"destructive\":false,\"requiresConfirmation\":false,\"validators\":[\"normalization-preserves-canonical-fields\",\"runtime-editor-round-trip\",\"metadata-round-trip\"],\"affectedPaths\":[\"normalizedSeed\",\"form\",\"fieldMetadata\"],\"submissionImpact\":\"config-only\",\"preconditions\":[\"field-metadata-loaded\",\"editor-properties-loaded\"]}]}",
|
|
1579
|
+
"sourcePointer": "projects/praxis-metadata-editor/src/lib/ai/praxis-metadata-editor-authoring-manifest.ts",
|
|
1580
|
+
"contentHash": "29a42407e1ed710da781ff2bfc229692d8fdf227962f9f3617410fca6868a6fd",
|
|
1581
|
+
"sourceKind": "component_definition",
|
|
1582
|
+
"sourceId": "praxis-metadata-editor",
|
|
1583
|
+
"corpusVersion": "1.0.0"
|
|
1584
|
+
},
|
|
1585
|
+
{
|
|
1586
|
+
"chunkIndex": 7,
|
|
1587
|
+
"chunkKind": "authoring_manifest",
|
|
1588
|
+
"content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-metadata-editor\",\"ownerPackage\":\"@praxisui/metadata-editor\",\"configSchemaId\":\"FieldMetadata\",\"chunkSection\":\"validators\",\"validators\":[{\"validatorId\":\"field-metadata-shape-canonical\",\"level\":\"error\",\"code\":\"METADATA_FIELD_SHAPE_CANONICAL\",\"description\":\"Edited metadata must remain compatible with canonical FieldMetadata.\"},{\"validatorId\":\"field-path-supported-by-editor\",\"level\":\"error\",\"code\":\"METADATA_FIELD_PATH_SUPPORTED\",\"description\":\"Edited paths must be supported by visual editor coverage or explicitly delegated.\"},{\"validatorId\":\"control-type-exists-in-discovery\",\"level\":\"error\",\"code\":\"METADATA_CONTROL_TYPE_DISCOVERED\",\"description\":\"Control type must exist in dynamic-fields discovery.\"},{\"validatorId\":\"editor-coverage-exists\",\"level\":\"error\",\"code\":\"METADATA_EDITOR_COVERAGE_EXISTS\",\"description\":\"Control type and property must have metadata-editor coverage.\"},{\"validatorId\":\"option-source-shape-canonical\",\"level\":\"error\",\"code\":\"METADATA_OPTION_SOURCE_CANONICAL\",\"description\":\"Option source must use canonical FieldMetadata/x-ui shape.\"},{\"validatorId\":\"remote-option-source-governed\",\"level\":\"error\",\"code\":\"METADATA_REMOTE_OPTION_SOURCE_GOVERNED\",\"description\":\"Remote option sources must resolve through governed resource or endpoint metadata.\"},{\"validatorId\":\"cascade-fields-exist\",\"level\":\"error\",\"code\":\"METADATA_CASCADE_FIELDS_EXIST\",\"description\":\"Cascade source and dependent fields must exist.\"},{\"validatorId\":\"cascade-cycle-free\",\"level\":\"error\",\"code\":\"METADATA_CASCADE_CYCLE_FREE\",\"description\":\"Cascade dependencies must not create cycles.\"},{\"validatorId\":\"cascade-backend-shape-preserved\",\"level\":\"error\",\"code\":\"METADATA_CASCADE_BACKEND_SHAPE_PRESERVED\",\"description\":\"Cascade config must preserve x-ui optionSource dependsOn and dependencyFilterMap semantics.\"},{\"validatorId\":\"renderer-editor-type-registered\",\"level\":\"error\",\"code\":\"METADATA_RENDERER_TYPE_REGISTERED\",\"description\":\"Renderer editor type must be registered.\"},{\"validatorId\":\"visual-editor-coverage-required\",\"level\":\"error\",\"code\":\"METADATA_VISUAL_COVERAGE_REQUIRED\",\"description\":\"JSON-only support is not accepted for required visual authoring coverage.\"},{\"validatorId\":\"validation-rule-canonical\",\"level\":\"error\",\"code\":\"METADATA_VALIDATION_RULE_CANONICAL\",\"description\":\"Validation rule must use canonical metadata shape.\"},{\"validatorId\":\"context-validator-registered\",\"level\":\"error\",\"code\":\"METADATA_CONTEXT_VALIDATOR_REGISTERED\",\"description\":\"Contextual validator must be registered before use.\"},{\"validatorId\":\"context-hint-shape-canonical\",\"level\":\"error\",\"code\":\"METADATA_CONTEXT_HINT_CANONICAL\",\"description\":\"Context hints must remain structured metadata, not free-form host-only strings.\"},{\"validatorId\":\"context-hint-i18n-compatible\",\"level\":\"warning\",\"code\":\"METADATA_CONTEXT_HINT_I18N_COMPATIBLE\",\"description\":\"Authoring hint text must remain compatible with metadata-editor i18n.\"},{\"validatorId\":\"date-range-shortcuts-static-canonical\",\"level\":\"error\",\"code\":\"METADATA_DATE_RANGE_SHORTCUTS_STATIC_CANONICAL\",\"description\":\"Date range shortcuts must be built-in ids or static backend-resolved ranges with id, label, startDate and endDate.\"},{\"validatorId\":\"date-range-shortcuts-no-executable-metadata\",\"level\":\"error\",\"code\":\"METADATA_DATE_RANGE_SHORTCUTS_NO_EXECUTABLE_METADATA\",\"description\":\"Metadata shortcuts must not contain calculateRange, executable expressions, local calendar-law rules, or frontend business-day logic.\"},{\"validatorId\":\"date-range-shortcuts-unique-ids\",\"level\":\"error\",\"code\":\"METADATA_DATE_RANGE_SHORTCUTS_UNIQUE_IDS\",\"description\":\"Static business shortcuts must use unique ids inside the date range field.\"},{\"validatorId\":\"normalization-preserves-canonical-fields\",\"level\":\"error\",\"code\":\"METADATA_NORMALIZATION_PRESERVES_FIELDS\",\"description\":\"Normalization must not drop canonical advanced FieldMetadata properties.\"},{\"validatorId\":\"runtime-editor-round-trip\",\"level\":\"error\",\"code\":\"METADATA_RUNTIME_EDITOR_ROUND_TRIP\",\"description\":\"Runtime and editor must consume the same normalized metadata shape.\"},{\"validatorId\":\"metadata-round-trip\",\"level\":\"error\",\"code\":\"METADATA_ROUND_TRIP\",\"description\":\"Open, edit, apply/save, reopen and runtime consume must preserve metadata.\"}]}",
|
|
1589
|
+
"sourcePointer": "projects/praxis-metadata-editor/src/lib/ai/praxis-metadata-editor-authoring-manifest.ts",
|
|
1590
|
+
"contentHash": "3b9148ddb8fd1a255e5150ca321e11f2779fb480afac5ebe0cfb5bd128127896",
|
|
1591
|
+
"sourceKind": "component_definition",
|
|
1592
|
+
"sourceId": "praxis-metadata-editor",
|
|
1593
|
+
"corpusVersion": "1.0.0"
|
|
1594
|
+
},
|
|
1595
|
+
{
|
|
1596
|
+
"chunkIndex": 8,
|
|
1597
|
+
"chunkKind": "authoring_manifest",
|
|
1598
|
+
"content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-metadata-editor\",\"ownerPackage\":\"@praxisui/metadata-editor\",\"configSchemaId\":\"FieldMetadata\",\"chunkSection\":\"roundTripRequirements\",\"roundTripRequirements\":[\"FieldMetadata is the canonical edited document shape; backend x-ui-derived metadata must not be rewritten into host-only aliases.\",\"Control type changes require both dynamic-fields discovery and metadata-editor visual coverage.\",\"Option source cascades preserve x-ui optionSource.dependsOn and optionSource.dependencyFilterMap semantics.\",\"Date range business shortcuts are authored as built-in ids or backend-resolved static ranges; browser metadata never carries calculateRange code or business calendar rules.\",\"JSON-only support is incomplete when visual editor coverage is required.\",\"Schema normalization must preserve advanced canonical properties through open, edit, apply/save, reopen and runtime consumption.\"]}",
|
|
1599
|
+
"sourcePointer": "projects/praxis-metadata-editor/src/lib/ai/praxis-metadata-editor-authoring-manifest.ts",
|
|
1600
|
+
"contentHash": "a50f50bff84341366760569555738c538260cacc577e234be485d4502e5eebde",
|
|
1601
|
+
"sourceKind": "component_definition",
|
|
1602
|
+
"sourceId": "praxis-metadata-editor",
|
|
1603
|
+
"corpusVersion": "1.0.0"
|
|
1604
|
+
},
|
|
1605
|
+
{
|
|
1606
|
+
"chunkIndex": 9,
|
|
1607
|
+
"chunkKind": "authoring_manifest",
|
|
1608
|
+
"content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-metadata-editor\",\"ownerPackage\":\"@praxisui/metadata-editor\",\"configSchemaId\":\"FieldMetadata\",\"chunkSection\":\"examples\",\"examples\":[{\"id\":\"set-label\",\"request\":\"Set this field label to Customer name.\",\"operationId\":\"fieldMetadata.property.set\",\"params\":{\"path\":\"label\",\"value\":\"Customer name\"},\"isPositive\":true},{\"id\":\"set-control-type\",\"request\":\"Change this field to a select control.\",\"operationId\":\"controlType.set\",\"params\":{\"controlType\":\"select\",\"preserveCompatibleProperties\":true},\"isPositive\":true},{\"id\":\"configure-remote-options\",\"request\":\"Load options from the customers resource using id and name.\",\"operationId\":\"optionSource.configure\",\"params\":{\"kind\":\"resource\",\"resource\":\"customers\",\"valueField\":\"id\",\"labelField\":\"name\"},\"isPositive\":true},{\"id\":\"configure-cascade\",\"request\":\"Filter city options when state changes.\",\"operationId\":\"cascade.configure\",\"params\":{\"dependentField\":\"city\",\"sourceField\":\"state\",\"dependencyFilterMap\":{\"stateId\":\"state.id\"}},\"isPositive\":true},{\"id\":\"configure-renderer\",\"request\":\"Expose placeholder in the visual editor as a text field.\",\"operationId\":\"renderer.configure\",\"params\":{\"propertyName\":\"placeholder\",\"editorType\":\"text\",\"group\":\"Presentation\"},\"isPositive\":true},{\"id\":\"add-required-validation\",\"request\":\"Make this field required with a validation message.\",\"operationId\":\"validationRule.add\",\"params\":{\"rule\":{\"type\":\"required\"},\"message\":\"Required field\"},\"isPositive\":true},{\"id\":\"set-context-hint\",\"request\":\"Add a contextual hint for sales users.\",\"operationId\":\"contextHint.set\",\"params\":{\"hintPath\":\"helpText\",\"value\":\"Use the legal customer name.\"},\"isPositive\":true},{\"id\":\"configure-date-range-business-shortcut\",\"request\":\"Add a fiscal competence period resolved by the backend to this inline date range.\",\"operationId\":\"dateRangeShortcuts.configure\",\"params\":{\"shortcuts\":[\"thisMonth\",{\"id\":\"competencia-fiscal-marco\",\"label\":\"Fiscal competence March\",\"startDate\":\"2026-03-01\",\"endDate\":\"2026-03-31\",\"timeZone\":\"America/Sao_Paulo\",\"tone\":\"success\"}],\"inlineQuickPresets\":{\"enabled\":true,\"position\":\"start\",\"maxVisible\":4},\"applyMode\":\"explicit\"},\"isPositive\":true},{\"id\":\"reject-date-range-executable-shortcut\",\"request\":\"Add a date range shortcut that calculates fiscal holidays in calculateRange from JSON.\",\"operationId\":\"dateRangeShortcuts.configure\",\"params\":{\"shortcuts\":[{\"id\":\"legal-days\",\"label\":\"Legal days\",\"startDate\":\"2026-03-01\",\"endDate\":\"2026-03-31\",\"calculateRange\":\"() => legalCalendar()\"}]},\"isPositive\":false},{\"id\":\"normalize-seed\",\"request\":\"Normalize this imported field metadata while preserving advanced properties.\",\"operationId\":\"normalization.apply\",\"params\":{\"mode\":\"preserve-advanced-properties\",\"preserveUnknownCanonicalFields\":true},\"isPositive\":true},{\"id\":\"reject-unknown-control\",\"request\":\"Use an unknown control type named magic-picker.\",\"operationId\":\"controlType.set\",\"params\":{\"controlType\":\"magic-picker\"},\"isPositive\":false},{\"id\":\"reject-json-only-coverage\",\"request\":\"Support this field only by editing raw JSON.\",\"operationId\":\"renderer.configure\",\"params\":{\"propertyName\":\"optionSource\",\"editorType\":\"json\"},\"isPositive\":false},{\"id\":\"reject-cascade-cycle\",\"request\":\"Make field A depend on B and B depend on A.\",\"operationId\":\"cascade.configure\",\"params\":{\"dependentField\":\"a\",\"sourceField\":\"b\"},\"isPositive\":false},{\"id\":\"reject-host-only-option-source\",\"request\":\"Save a host-only URL string as the option source.\",\"operationId\":\"optionSource.configure\",\"params\":{\"kind\":\"remote\",\"endpoint\":\"local-only://options\"},\"isPositive\":false}]}",
|
|
1609
|
+
"sourcePointer": "projects/praxis-metadata-editor/src/lib/ai/praxis-metadata-editor-authoring-manifest.ts",
|
|
1610
|
+
"contentHash": "b9fcde426b6d20b1b60732085bb6753ac25ab86a84ed516edb1d4f5a73548dc2",
|
|
1611
|
+
"sourceKind": "component_definition",
|
|
1612
|
+
"sourceId": "praxis-metadata-editor",
|
|
1613
|
+
"corpusVersion": "1.0.0"
|
|
1614
|
+
},
|
|
1615
|
+
{
|
|
1616
|
+
"chunkIndex": 10,
|
|
1617
|
+
"chunkKind": "recipe",
|
|
1618
|
+
"content": "{\"_comment\":\"Receita para o Editor de Metadados (FieldMetadata).\",\"templateMeta\":{\"registryKey\":\"praxis-metadata-editor\",\"variantId\":\"base\",\"useWhen\":\"Base metadata editor configuration.\",\"examplePrompts\":[\"configure field metadata editor\",\"set up metadata editor preview and permissions\"]},\"metadata\":{\"schema\":{\"id\":\"product-schema\",\"version\":\"1.0\"},\"permissions\":{\"edit\":[\"admin\"],\"view\":[\"user\",\"guest\"]},\"preview\":{\"live\":true,\"mode\":\"form\"},\"fieldDefinitions\":[{\"name\":\"sku\",\"label\":\"SKU\",\"controlType\":\"input\",\"validationHelpers\":{\"mask\":\"AAA-9999\",\"regex\":\"^[A-Z]{3}-\\\\d{4}$\"}},{\"name\":\"category\",\"label\":\"Categoria\",\"controlType\":\"select\",\"options\":[\"Electronics\",\"Books\"]},{\"name\":\"subcategory\",\"label\":\"Subcategoria\",\"controlType\":\"select\",\"cascades\":[{\"triggerField\":\"category\",\"action\":\"filterOptions\",\"endpoint\":\"/api/subcategories?category={category}\"}]}]}}",
|
|
1619
|
+
"sourcePointer": "examples/ai-recipes/praxis-field-metadata-editor.json",
|
|
1620
|
+
"contentHash": "7465601d729f9dcebdd5eda822dfa201723bd101351db3ad5ff110faf5f951b5",
|
|
1621
|
+
"sourceKind": "component_definition",
|
|
1622
|
+
"sourceId": "praxis-metadata-editor",
|
|
1623
|
+
"corpusVersion": "1.0.0"
|
|
1624
|
+
}
|
|
1625
|
+
]
|
|
1626
|
+
}
|
|
1627
|
+
},
|
|
1628
|
+
"note": "Package-scoped Praxis component registry for source-free agent discovery. Use the canonical ingestion registry for cross-package aggregate analysis."
|
|
1629
|
+
}
|