@praxisui/editorial-forms 9.0.0-beta.71 → 9.0.0-beta.73

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schemaVersion": "1.0.0",
3
- "generatedAt": "2026-07-11T00:12:06.404Z",
3
+ "generatedAt": "2026-07-12T01:34:40.567Z",
4
4
  "packageName": "@praxisui/editorial-forms",
5
- "packageVersion": "9.0.0-beta.71",
5
+ "packageVersion": "9.0.0-beta.73",
6
6
  "sourceRegistry": "praxis-component-registry-ingestion",
7
7
  "sourceRegistryVersion": "1.0.0",
8
8
  "componentCount": 2,
@@ -15,39 +15,46 @@
15
15
  {
16
16
  "name": "solution",
17
17
  "type": "EditorialSolutionDefinition | null",
18
- "required": false
18
+ "required": false,
19
+ "description": "Canonical editorial solution definition."
19
20
  },
20
21
  {
21
22
  "name": "instance",
22
23
  "type": "EditorialTemplateInstance | null",
23
- "required": false
24
+ "required": false,
25
+ "description": "Editorial instance with context and overrides."
24
26
  },
25
27
  {
26
28
  "name": "runtimeContext",
27
29
  "type": "Record<string, unknown> | null",
28
- "required": false
30
+ "required": false,
31
+ "description": "Host context merged into the resolved runtime context."
29
32
  },
30
33
  {
31
34
  "name": "hostConfig",
32
35
  "type": "EditorialRuntimeHostConfig | null",
33
- "required": false
36
+ "required": false,
37
+ "description": "Host controls for operational event forwarding."
34
38
  }
35
39
  ],
36
40
  "outputs": [
37
41
  {
38
42
  "name": "snapshotChange",
39
43
  "type": "EditorialRuntimeSnapshot",
40
- "required": false
44
+ "required": false,
45
+ "description": "Resolved snapshot emitted by the editorial runtime."
41
46
  },
42
47
  {
43
48
  "name": "fallbackChange",
44
49
  "type": "EditorialRuntimeFallbackState",
45
- "required": false
50
+ "required": false,
51
+ "description": "Fallback state emitted when diagnostics affect runtime health."
46
52
  },
47
53
  {
48
54
  "name": "operationalEvent",
49
55
  "type": "EditorialRuntimeOperationalEvent",
50
- "required": false
56
+ "required": false,
57
+ "description": "Operational diagnostics event stream."
51
58
  }
52
59
  ],
53
60
  "configSchemaId": null,
@@ -68,6 +75,108 @@
68
75
  "minCols": 4,
69
76
  "minRows": 4
70
77
  },
78
+ "ports": [
79
+ {
80
+ "id": "solution",
81
+ "label": "Editorial solution",
82
+ "direction": "input",
83
+ "semanticKind": "config-fragment",
84
+ "schema": {
85
+ "id": "EditorialSolutionDefinition",
86
+ "kind": "ts-type",
87
+ "ref": "EditorialSolutionDefinition"
88
+ },
89
+ "description": "Canonical editorial solution definition consumed by the runtime.",
90
+ "exposure": {
91
+ "public": true,
92
+ "group": "config"
93
+ }
94
+ },
95
+ {
96
+ "id": "instance",
97
+ "label": "Editorial instance",
98
+ "direction": "input",
99
+ "semanticKind": "config-fragment",
100
+ "schema": {
101
+ "id": "EditorialTemplateInstance",
102
+ "kind": "ts-type",
103
+ "ref": "EditorialTemplateInstance"
104
+ },
105
+ "description": "Runtime instance with persisted context, overrides and selected template reference.",
106
+ "exposure": {
107
+ "public": true,
108
+ "group": "config"
109
+ }
110
+ },
111
+ {
112
+ "id": "runtimeContext",
113
+ "label": "Runtime context",
114
+ "direction": "input",
115
+ "semanticKind": "view-context",
116
+ "schema": {
117
+ "id": "Record<string, unknown>",
118
+ "kind": "ts-type",
119
+ "ref": "Record<string, unknown>"
120
+ },
121
+ "description": "Host-provided context merged with the editorial instance context.",
122
+ "exposure": {
123
+ "public": true,
124
+ "group": "context"
125
+ }
126
+ },
127
+ {
128
+ "id": "snapshotChange",
129
+ "label": "Snapshot change",
130
+ "direction": "output",
131
+ "semanticKind": "event",
132
+ "cardinality": "stream",
133
+ "schema": {
134
+ "id": "EditorialRuntimeSnapshot",
135
+ "kind": "ts-type",
136
+ "ref": "EditorialRuntimeSnapshot"
137
+ },
138
+ "description": "Resolved editorial runtime snapshot emitted when solution, instance or context changes.",
139
+ "exposure": {
140
+ "public": true,
141
+ "group": "events"
142
+ }
143
+ },
144
+ {
145
+ "id": "fallbackChange",
146
+ "label": "Fallback change",
147
+ "direction": "output",
148
+ "semanticKind": "status",
149
+ "cardinality": "stream",
150
+ "schema": {
151
+ "id": "EditorialRuntimeFallbackState",
152
+ "kind": "ts-type",
153
+ "ref": "EditorialRuntimeFallbackState"
154
+ },
155
+ "description": "Operational fallback state emitted when diagnostics affect runtime health.",
156
+ "exposure": {
157
+ "public": true,
158
+ "group": "status"
159
+ }
160
+ },
161
+ {
162
+ "id": "operationalEvent",
163
+ "label": "Operational event",
164
+ "direction": "output",
165
+ "semanticKind": "diagnostic",
166
+ "cardinality": "stream",
167
+ "schema": {
168
+ "id": "EditorialRuntimeOperationalEvent",
169
+ "kind": "ts-type",
170
+ "ref": "EditorialRuntimeOperationalEvent"
171
+ },
172
+ "description": "Technical event stream for diagnostics, blocking errors and adapter state.",
173
+ "exposure": {
174
+ "public": true,
175
+ "advanced": true,
176
+ "group": "diagnostics"
177
+ }
178
+ }
179
+ ],
71
180
  "source": "projects/praxis-editorial-forms/src/lib/editorial-form-runtime.metadata.ts",
72
181
  "exportName": "EDITORIAL_FORM_RUNTIME_COMPONENT_METADATA",
73
182
  "chunks": [
@@ -75,7 +184,7 @@
75
184
  "chunkIndex": 0,
76
185
  "chunkKind": "summary",
77
186
  "content": "Component ID: praxis-editorial-form-runtime\nSelector: praxis-editorial-form-runtime\nFriendly Name: Praxis Editorial Form Runtime\nDescription: Guided editorial runtime for solution and instance driven form experiences.\nCategory: form\nLib/Package: @praxisui/editorial-forms\nTags: widget, editorial, forms, runtime, guided-flow\nInputs:\n - solution (EditorialSolutionDefinition | null)\n - instance (EditorialTemplateInstance | null)\n - runtimeContext (Record<string, unknown> | null)\n - hostConfig (EditorialRuntimeHostConfig | null)\nOutputs:\n - snapshotChange (EditorialRuntimeSnapshot)\n - fallbackChange (EditorialRuntimeFallbackState)\n - operationalEvent (EditorialRuntimeOperationalEvent)\n",
78
- "sourcePointer": "praxis-ui-angular/projects/praxis-editorial-forms/src/lib/editorial-form-runtime.metadata.ts",
187
+ "sourcePointer": "projects/praxis-editorial-forms/src/lib/editorial-form-runtime.metadata.ts",
79
188
  "contentHash": "ef27596ae30d7f55b97546b3268a607c3f1989183b67cfa00e415624f1e058a6",
80
189
  "sourceKind": "component_definition",
81
190
  "sourceId": "praxis-editorial-form-runtime",
@@ -91,37 +200,44 @@
91
200
  {
92
201
  "name": "solution",
93
202
  "type": "EditorialSolutionDefinition | null",
94
- "required": false
203
+ "required": false,
204
+ "description": "Canonical editorial solution definition with journeys, steps, blocks and presentation."
95
205
  },
96
206
  {
97
207
  "name": "instance",
98
208
  "type": "EditorialTemplateInstance | null",
99
- "required": false
209
+ "required": false,
210
+ "description": "Runtime instance with selected journey, context, overrides and compatibility form configs."
100
211
  },
101
212
  {
102
213
  "name": "runtimeContext",
103
214
  "type": "Record<string, unknown> | null",
104
- "required": false
215
+ "required": false,
216
+ "description": "Host-provided immutable context merged into the resolved editorial snapshot."
105
217
  },
106
218
  {
107
219
  "name": "hostConfig",
108
220
  "type": "EditorialRuntimeHostConfig | null",
109
- "required": false
221
+ "required": false,
222
+ "description": "Host controls for operational event and adapter event forwarding."
110
223
  },
111
224
  {
112
225
  "name": "snapshotChange",
113
226
  "type": "EditorialRuntimeSnapshot",
114
- "required": false
227
+ "required": false,
228
+ "description": "Resolved runtime snapshot emitted to hosts for product UX and audit derivation."
115
229
  },
116
230
  {
117
231
  "name": "fallbackChange",
118
232
  "type": "EditorialRuntimeFallbackState",
119
- "required": false
233
+ "required": false,
234
+ "description": "Operational fallback state emitted when diagnostics affect runtime health."
120
235
  },
121
236
  {
122
237
  "name": "operationalEvent",
123
238
  "type": "EditorialRuntimeOperationalEvent",
124
- "required": false
239
+ "required": false,
240
+ "description": "Technical diagnostics event stream for logs, monitoring and runbooks."
125
241
  }
126
242
  ],
127
243
  "outputs": [],
@@ -1211,7 +1327,7 @@
1211
1327
  "chunkIndex": 0,
1212
1328
  "chunkKind": "summary",
1213
1329
  "content": "Component ID: praxis-editorial-forms\nSelector: praxis-editorial-forms\nFriendly Name: Praxis Editorial Forms\nDescription: Authoring-only registry entry for praxis-editorial-forms.\nCategory: form\nLib/Package: @praxisui/editorial-forms\nTags: authoring, manifest, praxis-editorial-forms\nInputs:\n - solution (EditorialSolutionDefinition | null)\n - instance (EditorialTemplateInstance | null)\n - runtimeContext (Record<string, unknown> | null)\n - hostConfig (EditorialRuntimeHostConfig | null)\n - snapshotChange (EditorialRuntimeSnapshot)\n - fallbackChange (EditorialRuntimeFallbackState)\n - operationalEvent (EditorialRuntimeOperationalEvent)\n",
1214
- "sourcePointer": "praxis-ui-angular/projects/praxis-editorial-forms/src/lib/ai/praxis-editorial-forms-authoring-manifest.ts",
1330
+ "sourcePointer": "projects/praxis-editorial-forms/src/lib/ai/praxis-editorial-forms-authoring-manifest.ts",
1215
1331
  "contentHash": "ff168ef6a9d1887df1bd99d045b9eee5a6dd678868248d4d0be99e6f32923dcb",
1216
1332
  "sourceKind": "component_definition",
1217
1333
  "sourceId": "praxis-editorial-forms",
@@ -1221,7 +1337,7 @@
1221
1337
  "chunkIndex": 1,
1222
1338
  "chunkKind": "authoring_manifest",
1223
1339
  "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-editorial-forms\",\n \"ownerPackage\": \"@praxisui/editorial-forms\",\n \"configSchemaId\": \"EditorialRuntimeInput\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"solution\",\n \"type\": \"EditorialSolutionDefinition | null\",\n \"description\": \"Canonical editorial solution definition with journeys, steps, blocks and presentation.\"\n },\n {\n \"name\": \"instance\",\n \"type\": \"EditorialTemplateInstance | null\",\n \"description\": \"Runtime instance with selected journey, context, overrides and compatibility form configs.\"\n },\n {\n \"name\": \"runtimeContext\",\n \"type\": \"Record<string, unknown> | null\",\n \"description\": \"Host-provided immutable context merged into the resolved editorial snapshot.\"\n },\n {\n \"name\": \"hostConfig\",\n \"type\": \"EditorialRuntimeHostConfig | null\",\n \"description\": \"Host controls for operational event and adapter event forwarding.\"\n },\n {\n \"name\": \"snapshotChange\",\n \"type\": \"EditorialRuntimeSnapshot\",\n \"description\": \"Resolved runtime snapshot emitted to hosts for product UX and audit derivation.\"\n },\n {\n \"name\": \"fallbackChange\",\n \"type\": \"EditorialRuntimeFallbackState\",\n \"description\": \"Operational fallback state emitted when diagnostics affect runtime health.\"\n },\n {\n \"name\": \"operationalEvent\",\n \"type\": \"EditorialRuntimeOperationalEvent\",\n \"description\": \"Technical diagnostics event stream for logs, monitoring and runbooks.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"snapshot\",\n \"resolver\": \"editorial-runtime-snapshot\",\n \"description\": \"Resolved editorial state from solution, instance and runtime context.\"\n },\n {\n \"kind\": \"fallback\",\n \"resolver\": \"editorial-runtime-fallback-state\",\n \"description\": \"Explicit operational fallback state derived from runtime diagnostics.\"\n },\n {\n \"kind\": \"presentation\",\n \"resolver\": \"editorial-solution-presentation\",\n \"description\": \"Editorial presentation contract under solution.presentation.\"\n },\n {\n \"kind\": \"adapter\",\n \"resolver\": \"editorial-data-block-adapter-registry\",\n \"description\": \"Optional dataCollection adapter binding and compatibility requirements.\"\n },\n {\n \"kind\": \"dataBlock\",\n \"resolver\": \"editorial-journey-step-block-by-id\",\n \"description\": \"Editorial blocks inside journey steps, including dataCollection and presentational blocks.\"\n },\n {\n \"kind\": \"fieldBinding\",\n \"resolver\": \"editorial-data-block-field-binding\",\n \"description\": \"Field-to-runtime-context binding for dataCollection blocks without redefining FieldMetadata.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"snapshot.set\",\n \"title\": \"Set editorial snapshot inputs\",\n \"scope\": \"global\",\n \"targetKind\": \"snapshot\",\n \"target\": {\n \"kind\": \"snapshot\",\n \"resolver\": \"editorial-runtime-snapshot\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"solutionId\"\n ],\n \"properties\": {\n \"solutionId\": {\n \"type\": \"string\"\n },\n \"instanceId\": {\n \"type\": \"string\"\n },\n \"journeyId\": {\n \"type\": \"string\"\n },\n \"stepId\": {\n \"type\": \"string\"\n },\n \"runtimeContextPatch\": {\n \"type\": \"object\"\n },\n \"instanceContextPatch\": {\n \"type\": \"object\"\n },\n \"preserveDiagnostics\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"editorial-snapshot-set\",\n \"handlerContract\": {\n \"reads\": [\n \"EditorialSolutionDefinition\",\n \"EditorialTemplateInstance\",\n \"runtimeContext\",\n \"resolveEditorialRuntimeSnapshot\"\n ],\n \"writes\": [\n \"solution.solutionId\",\n \"instance.instanceId\",\n \"instance.context\",\n \"runtimeContext\"\n ],\n \"identityKeys\": [\n \"solutionId\",\n \"instanceId\",\n \"journeyId\"\n ],\n \"failureModes\": [\n \"solution-not-found\",\n \"journey-not-found\",\n \"step-not-found\",\n \"snapshot-shape-invalid\",\n \"diagnostics-lost\"\n ],\n \"description\": \"Compiles a deterministic patch to editorial runtime inputs, validates the requested journey/step against the resolved snapshot and requires diagnostics to be preserved.\"\n }\n }\n ],\n \"validators\": [\n \"snapshot-shape-canonical\",\n \"journey-exists\",\n \"step-exists\",\n \"diagnostics-preserved\",\n \"editorial-round-trip\"\n ],\n \"affectedPaths\": [\n \"solution.solutionId\",\n \"instance.instanceId\",\n \"instance.context\",\n \"runtimeContext\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"editorial-runtime-inputs-loaded\"\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false\n },\n {\n \"operationId\": \"fallback.configure\",\n \"title\": \"Configure explicit fallback behavior\",\n \"scope\": \"meta\",\n \"targetKind\": \"fallback\",\n \"target\": {\n \"kind\": \"fallback\",\n \"resolver\": \"editorial-runtime-fallback-state\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"mode\"\n ],\n \"properties\": {\n \"mode\": {\n \"enum\": [\n \"normal\",\n \"warning\",\n \"degraded\",\n \"blocked\"\n ]\n },\n \"diagnosticCode\": {\n \"type\": \"string\"\n },\n \"progressionBlocked\": {\n \"type\": \"boolean\"\n },\n \"requiresEngineAttention\": {\n \"type\": \"boolean\"\n },\n \"scope\": {\n \"type\": \"object\",\n \"properties\": {\n \"journeyId\": {\n \"type\": \"string\"\n },\n \"stepId\": {\n \"type\": \"string\"\n },\n \"blockId\": {\n \"type\": \"string\"\n }\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"editorial-fallback-configure\",\n \"handlerContract\": {\n \"reads\": [\n \"EditorialRuntimeDiagnostics\",\n \"deriveRuntimeFallbackState\",\n \"EditorialRuntimeFallbackScope\"\n ],\n \"writes\": [\n \"hostConfig.emitOperationalEvents\",\n \"snapshot.diagnostics.items\"\n ],\n \"identityKeys\": [\n \"mode\",\n \"diagnosticCode\",\n \"scope.journeyId\",\n \"scope.stepId\"\n ],\n \"failureModes\": [\n \"fallback-mode-invalid\",\n \"blocking-diagnostic-missing\",\n \"scope-not-found\",\n \"implicit-degradation-not-allowed\"\n ],\n \"description\": \"Requires fallback policy to be explicit and tied to snapshot diagnostics, because fallback state is derived by deriveRuntimeFallbackState instead of persisted as domain data.\"\n }\n }\n ],\n \"validators\": [\n \"fallback-explicit\",\n \"fallback-diagnostic-backed\",\n \"fallback-scope-exists\",\n \"editorial-round-trip\"\n ],\n \"affectedPaths\": [\n \"hostConfig.emitOperationalEvents\",\n \"snapshot.diagnostics.items\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"snapshot-resolved\"\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false\n },\n {\n \"operationId\": \"presentation.configure\",\n \"title\": \"Configure editorial presentation\",\n \"scope\": \"skin\",\n \"targetKind\": \"presentation\",\n \"target\": {\n \"kind\": \"presentation\",\n \"resolver\": \"editorial-solution-presentation\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"layout\": {\n \"type\": \"object\",\n \"properties\": {\n \"orientation\": {\n \"enum\": [\n \"horizontal\",\n \"vertical\"\n ]\n },\n \"density\": {\n \"enum\": [\n \"compact\",\n \"comfortable\",\n \"relaxed\"\n ]\n },\n \"maxWidth\": {\n \"type\": \"string\"\n },\n \"shellVariant\": {\n \"type\": \"string\"\n },\n \"spacing\": {\n \"type\": \"object\"\n },\n \"responsive\": {\n \"type\": \"object\"\n }\n }\n },\n \"theme\": {\n \"type\": \"object\"\n },\n \"stepper\": {\n \"type\": \"object\",\n \"properties\": {\n \"visible\": {\n \"type\": \"boolean\"\n },\n \"orientation\": {\n \"enum\": [\n \"horizontal\",\n \"vertical\"\n ]\n },\n \"showLabels\": {\n \"type\": \"boolean\"\n },\n \"showDescriptions\": {\n \"type\": \"boolean\"\n },\n \"showConnectors\": {\n \"type\": \"boolean\"\n },\n \"connectorStyle\": {\n \"type\": \"string\"\n },\n \"allowStepJump\": {\n \"type\": \"boolean\"\n }\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"editorial-presentation-configure\",\n \"handlerContract\": {\n \"reads\": [\n \"solution.presentation\",\n \"buildRuntimeLayoutCss\",\n \"buildRuntimeCssVars\",\n \"resolveRuntimeOrientation\"\n ],\n \"writes\": [\n \"solution.presentation.layout\",\n \"solution.presentation.theme\",\n \"solution.presentation.stepper\"\n ],\n \"identityKeys\": [\n \"solutionId\",\n \"presentation.layout.orientation\",\n \"presentation.stepper.orientation\"\n ],\n \"failureModes\": [\n \"presentation-key-unsupported\",\n \"theme-token-invalid\",\n \"domain-data-mutation-detected\",\n \"renderer-coverage-missing\"\n ],\n \"description\": \"Applies presentation-only changes under solution.presentation and rejects changes that mutate editorial domain data.\"\n }\n }\n ],\n \"validators\": [\n \"presentation-supported-by-runtime\",\n \"presentation-does-not-mutate-domain-data\",\n \"theme-tokens-valid\",\n \"editorial-round-trip\"\n ],\n \"affectedPaths\": [\n \"solution.presentation.layout\",\n \"solution.presentation.theme\",\n \"solution.presentation.stepper\"\n ],\n \"submissionImpact\": \"visual-only\",\n \"preconditions\": [\n \"solution-loaded\"\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false\n },\n {\n \"operationId\": \"adapter.bind\",\n \"title\": \"Bind data block adapter\",\n \"scope\": \"dataBinding\",\n \"targetKind\": \"adapter\",\n \"target\": {\n \"kind\": \"adapter\",\n \"resolver\": \"editorial-data-block-adapter-registry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"adapterId\",\n \"dataBlockType\"\n ],\n \"properties\": {\n \"adapterId\": {\n \"type\": \"string\"\n },\n \"dataBlockType\": {\n \"enum\": [\n \"dataCollection\"\n ]\n },\n \"componentRef\": {\n \"type\": \"string\"\n },\n \"requiredInputs\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"forwardOperationalEvents\": {\n \"type\": \"boolean\"\n },\n \"fallbackModeWhenMissing\": {\n \"enum\": [\n \"warning\",\n \"degraded\",\n \"blocked\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"editorial-adapter-bind\",\n \"handlerContract\": {\n \"reads\": [\n \"EDITORIAL_DATA_BLOCK_ADAPTER\",\n \"EditorialDataBlockAdapterRegistry\",\n \"EditorialDataBlockContext\",\n \"ComponentDocMeta\"\n ],\n \"writes\": [\n \"hostConfig.forwardAdapterOperationalEvents\",\n \"snapshot.diagnostics.items\"\n ],\n \"identityKeys\": [\n \"adapterId\",\n \"dataBlockType\"\n ],\n \"failureModes\": [\n \"adapter-not-registered\",\n \"adapter-does-not-support-data-block\",\n \"adapter-component-invalid\",\n \"fallback-policy-missing\"\n ],\n \"description\": \"Validates the external provider binding for a dataCollection adapter and records the host operational-event policy required when the adapter is missing or incompatible.\"\n }\n }\n ],\n \"validators\": [\n \"adapter-exists\",\n \"adapter-supports-data-block\",\n \"adapter-component-valid\",\n \"fallback-explicit\",\n \"editorial-round-trip\"\n ],\n \"affectedPaths\": [\n \"hostConfig.forwardAdapterOperationalEvents\",\n \"snapshot.diagnostics.items\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"adapter-registry-loaded\"\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false\n },\n {\n \"operationId\": \"dataBlock.add\",\n \"title\": \"Add editorial data block\",\n \"scope\": \"section\",\n \"targetKind\": \"dataBlock\",\n \"target\": {\n \"kind\": \"dataBlock\",\n \"resolver\": \"editorial-journey-step-block-by-id\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"journeyId\",\n \"stepId\",\n \"block\"\n ],\n \"properties\": {\n \"journeyId\": {\n \"type\": \"string\"\n },\n \"stepId\": {\n \"type\": \"string\"\n },\n \"insert\": {\n \"type\": \"object\",\n \"properties\": {\n \"mode\": {\n \"enum\": [\n \"append\",\n \"insertBefore\",\n \"insertAfter\"\n ]\n },\n \"relativeToBlockId\": {\n \"type\": \"string\"\n }\n }\n },\n \"block\": {\n \"type\": \"object\",\n \"required\": [\n \"blockId\",\n \"kind\"\n ],\n \"properties\": {\n \"blockId\": {\n \"type\": \"string\"\n },\n \"kind\": {\n \"enum\": [\n \"dataCollection\",\n \"introHero\",\n \"selectionCards\",\n \"reviewSections\",\n \"successPanel\"\n ]\n },\n \"formBlockId\": {\n \"type\": \"string\"\n },\n \"formConfigRef\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"visibility\": {\n \"type\": \"array\"\n }\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"editorial-data-block-add\",\n \"handlerContract\": {\n \"reads\": [\n \"EditorialSolutionDefinition.journeys\",\n \"EditorialResolvedStep.blocks\",\n \"EditorialDataBlockAdapterRegistry\"\n ],\n \"writes\": [\n \"solution.journeys[].steps[].blocks\"\n ],\n \"identityKeys\": [\n \"journeyId\",\n \"stepId\",\n \"block.blockId\"\n ],\n \"failureModes\": [\n \"journey-not-found\",\n \"step-not-found\",\n \"duplicate-block-id\",\n \"data-collection-config-unresolved\",\n \"adapter-not-registered\"\n ],\n \"description\": \"Adds a canonical editorial block to a step and validates dataCollection readiness without redefining Dynamic Form config semantics.\"\n }\n }\n ],\n \"validators\": [\n \"data-block-id-unique\",\n \"journey-exists\",\n \"step-exists\",\n \"adapter-supports-data-block\",\n \"editorial-round-trip\"\n ],\n \"affectedPaths\": [\n \"solution.journeys[].steps[].blocks\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"solution-loaded\"\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false\n },\n {\n \"operationId\": \"dataBlock.remove\",\n \"title\": \"Remove editorial data block\",\n \"scope\": \"section\",\n \"targetKind\": \"dataBlock\",\n \"target\": {\n \"kind\": \"dataBlock\",\n \"resolver\": \"editorial-journey-step-block-by-id\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"journeyId\",\n \"stepId\",\n \"blockId\"\n ],\n \"properties\": {\n \"journeyId\": {\n \"type\": \"string\"\n },\n \"stepId\": {\n \"type\": \"string\"\n },\n \"blockId\": {\n \"type\": \"string\"\n },\n \"requireNoFieldBindings\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"editorial-data-block-remove\",\n \"handlerContract\": {\n \"reads\": [\n \"EditorialSolutionDefinition.journeys\",\n \"EditorialResolvedStep.blocks\",\n \"fieldBinding\"\n ],\n \"writes\": [\n \"solution.journeys[].steps[].blocks\"\n ],\n \"identityKeys\": [\n \"journeyId\",\n \"stepId\",\n \"blockId\"\n ],\n \"failureModes\": [\n \"journey-not-found\",\n \"step-not-found\",\n \"block-not-found\",\n \"field-bindings-still-reference-block\"\n ],\n \"description\": \"Removes a block by stable id and rejects removal when governed field bindings still reference the block.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"data-block-exists\",\n \"field-binding-target-exists\",\n \"editorial-round-trip\"\n ],\n \"affectedPaths\": [\n \"solution.journeys[].steps[].blocks\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"solution-loaded\",\n \"explicit-confirmation-provided\"\n ]\n },\n {\n \"operationId\": \"fieldBinding.set\",\n \"title\": \"Set editorial field binding\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldBinding\",\n \"target\": {\n \"kind\": \"fieldBinding\",\n \"resolver\": \"editorial-data-block-field-binding\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"blockId\",\n \"fieldName\",\n \"contextPath\"\n ],\n \"properties\": {\n \"blockId\": {\n \"type\": \"string\"\n },\n \"fieldName\": {\n \"type\": \"string\"\n },\n \"contextPath\": {\n \"type\": \"string\"\n },\n \"mode\": {\n \"enum\": [\n \"read\",\n \"write\",\n \"readWrite\"\n ]\n },\n \"valueMode\": {\n \"enum\": [\n \"merge\",\n \"replace\"\n ]\n },\n \"delegateFieldMetadataTo\": {\n \"enum\": [\n \"praxis-metadata-editor\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"editorial-field-binding-set\",\n \"handlerContract\": {\n \"reads\": [\n \"EditorialDataCollectionBlock\",\n \"resolvedFormConfig.fieldMetadata\",\n \"runtimeContext.formData\",\n \"PRAXIS_METADATA_EDITOR_AUTHORING_MANIFEST\"\n ],\n \"writes\": [\n \"runtimeContext.formData\"\n ],\n \"identityKeys\": [\n \"blockId\",\n \"fieldName\",\n \"contextPath\"\n ],\n \"failureModes\": [\n \"block-not-found\",\n \"field-not-found\",\n \"context-path-invalid\",\n \"field-metadata-delegation-required\",\n \"domain-data-mutation-detected\"\n ],\n \"description\": \"Sets the governed runtimeContext.formData path used by dataCollection adapters and delegates FieldMetadata shape changes to the metadata-editor manifest.\"\n }\n }\n ],\n \"validators\": [\n \"field-binding-target-exists\",\n \"field-binding-path-valid\",\n \"delegates-field-metadata\",\n \"editorial-round-trip\"\n ],\n \"affectedPaths\": [\n \"runtimeContext.formData\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"preconditions\": [\n \"data-block-resolved\",\n \"field-metadata-loaded\"\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"snapshot-shape-canonical\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_SNAPSHOT_SHAPE_CANONICAL\",\n \"description\": \"Resolved snapshot must remain compatible with EditorialRuntimeSnapshot.\"\n },\n {\n \"validatorId\": \"journey-exists\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_JOURNEY_EXISTS\",\n \"description\": \"Target journey must exist in the editorial solution.\"\n },\n {\n \"validatorId\": \"step-exists\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_STEP_EXISTS\",\n \"description\": \"Target step must exist in the selected journey.\"\n },\n {\n \"validatorId\": \"diagnostics-preserved\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_DIAGNOSTICS_PRESERVED\",\n \"description\": \"Patch compilation must not drop runtime diagnostics.\"\n },\n {\n \"validatorId\": \"fallback-explicit\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_FALLBACK_EXPLICIT\",\n \"description\": \"Fallback behavior must be explicit instead of implied by missing adapter or hidden diagnostics.\"\n },\n {\n \"validatorId\": \"fallback-diagnostic-backed\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_FALLBACK_DIAGNOSTIC_BACKED\",\n \"description\": \"Warning, degraded and blocked fallback states must be backed by diagnostics.\"\n },\n {\n \"validatorId\": \"fallback-scope-exists\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_FALLBACK_SCOPE_EXISTS\",\n \"description\": \"Fallback scope must resolve to an existing journey, step or block.\"\n },\n {\n \"validatorId\": \"presentation-supported-by-runtime\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_PRESENTATION_SUPPORTED\",\n \"description\": \"Presentation keys must be supported by the runtime or intentionally diagnosed as unsupported.\"\n },\n {\n \"validatorId\": \"presentation-does-not-mutate-domain-data\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_PRESENTATION_DOMAIN_SAFE\",\n \"description\": \"Presentation changes must not mutate solution journeys, blocks, field metadata or runtime context data.\"\n },\n {\n \"validatorId\": \"theme-tokens-valid\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_THEME_TOKENS_VALID\",\n \"description\": \"Theme tokens must be valid runtime CSS variable inputs.\"\n },\n {\n \"validatorId\": \"adapter-exists\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_ADAPTER_EXISTS\",\n \"description\": \"Requested adapter must exist in EditorialDataBlockAdapterRegistry.\"\n },\n {\n \"validatorId\": \"adapter-supports-data-block\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_ADAPTER_SUPPORTS_DATA_BLOCK\",\n \"description\": \"Requested adapter must support the target data block context.\"\n },\n {\n \"validatorId\": \"adapter-component-valid\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_ADAPTER_COMPONENT_VALID\",\n \"description\": \"Adapter component must expose the inputs required by the adapter contract.\"\n },\n {\n \"validatorId\": \"data-block-id-unique\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_DATA_BLOCK_ID_UNIQUE\",\n \"description\": \"Block ids must be unique within the resolved editorial step.\"\n },\n {\n \"validatorId\": \"data-block-exists\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_DATA_BLOCK_EXISTS\",\n \"description\": \"Target data block must exist before destructive or binding operations.\"\n },\n {\n \"validatorId\": \"field-binding-target-exists\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_FIELD_BINDING_TARGET_EXISTS\",\n \"description\": \"Field binding must target an existing dataCollection block and field.\"\n },\n {\n \"validatorId\": \"field-binding-path-valid\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_FIELD_BINDING_PATH_VALID\",\n \"description\": \"Field binding context path must be deterministic and inside governed runtime context data.\"\n },\n {\n \"validatorId\": \"delegates-field-metadata\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_DELEGATES_FIELD_METADATA\",\n \"description\": \"FieldMetadata shape changes must be delegated to the metadata-editor manifest instead of duplicated here.\"\n },\n {\n \"validatorId\": \"editorial-round-trip\",\n \"level\": \"error\",\n \"code\": \"EDITORIAL_ROUND_TRIP\",\n \"description\": \"Open, edit, apply/save, reopen and runtime consume must preserve the editorial document.\"\n }\n ],\n \"roundTripRequirements\": [\n \"EditorialRuntimeInput is the package-level authoring document; solution, instance and runtimeContext must resolve into EditorialRuntimeSnapshot without drift.\",\n \"Fallback behavior must be explicit and backed by diagnostics; missing adapters cannot be hidden as successful rendering.\",\n \"Presentation changes are constrained to solution.presentation and must not mutate journeys, blocks, FormConfig, FieldMetadata or runtimeContext domain data.\",\n \"dataCollection blocks require an adapter that exists and supports the requested context, while Dynamic Form config semantics remain owned by @praxisui/dynamic-form.\",\n \"FieldMetadata authoring is delegated to praxis-metadata-editor and dynamic-fields discovery; this manifest only governs editorial binding and orchestration.\",\n \"Destructive block removal requires confirmation and must reject references from existing field bindings.\"\n ],\n \"examples\": [\n {\n \"id\": \"select-journey\",\n \"request\": \"Set the onboarding journey as the active editorial path.\",\n \"operationId\": \"snapshot.set\",\n \"params\": {\n \"solutionId\": \"customer-onboarding\",\n \"journeyId\": \"onboarding\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"merge-runtime-context\",\n \"request\": \"Prefill the runtime context with the selected plan.\",\n \"operationId\": \"snapshot.set\",\n \"params\": {\n \"solutionId\": \"plan-signup\",\n \"runtimeContextPatch\": {\n \"selectedPlan\": \"pro\"\n }\n },\n \"isPositive\": true\n },\n {\n \"id\": \"configure-blocked-fallback\",\n \"request\": \"Block progression when the required dataCollection adapter is missing.\",\n \"operationId\": \"fallback.configure\",\n \"params\": {\n \"mode\": \"blocked\",\n \"diagnosticCode\": \"data-collection-adapter-missing\",\n \"progressionBlocked\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"configure-stepper\",\n \"request\": \"Use a vertical compact stepper with hidden descriptions.\",\n \"operationId\": \"presentation.configure\",\n \"params\": {\n \"layout\": {\n \"orientation\": \"vertical\",\n \"density\": \"compact\"\n },\n \"stepper\": {\n \"showDescriptions\": false\n }\n },\n \"isPositive\": true\n },\n {\n \"id\": \"bind-dynamic-form-adapter\",\n \"request\": \"Bind the dynamic-form adapter for dataCollection blocks.\",\n \"operationId\": \"adapter.bind\",\n \"params\": {\n \"adapterId\": \"dynamic-form\",\n \"dataBlockType\": \"dataCollection\",\n \"requiredInputs\": [\n \"config\",\n \"formId\",\n \"editorialContext\"\n ],\n \"fallbackModeWhenMissing\": \"blocked\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-data-block\",\n \"request\": \"Add a consent form block to the review step.\",\n \"operationId\": \"dataBlock.add\",\n \"params\": {\n \"journeyId\": \"privacy\",\n \"stepId\": \"review\",\n \"block\": {\n \"blockId\": \"consent-form\",\n \"kind\": \"dataCollection\",\n \"formBlockId\": \"consent-form\"\n }\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-block\",\n \"request\": \"Remove the unused legacy consent block.\",\n \"operationId\": \"dataBlock.remove\",\n \"params\": {\n \"journeyId\": \"privacy\",\n \"stepId\": \"review\",\n \"blockId\": \"legacy-consent\",\n \"requireNoFieldBindings\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-binding\",\n \"request\": \"Bind the email field into runtimeContext.formData.email.\",\n \"operationId\": \"fieldBinding.set\",\n \"params\": {\n \"blockId\": \"contact-form\",\n \"fieldName\": \"email\",\n \"contextPath\": \"formData.email\",\n \"mode\": \"readWrite\",\n \"delegateFieldMetadataTo\": \"praxis-metadata-editor\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-presentation-domain-mutation\",\n \"request\": \"Change presentation and also rewrite the collected email value.\",\n \"operationId\": \"presentation.configure\",\n \"params\": {\n \"layout\": {\n \"density\": \"relaxed\"\n },\n \"runtimeContextPatch\": {\n \"formData\": {\n \"email\": \"changed@example.com\"\n }\n }\n },\n \"isPositive\": false\n },\n {\n \"id\": \"reject-missing-adapter\",\n \"request\": \"Render a dataCollection block with an adapter that is not registered.\",\n \"operationId\": \"adapter.bind\",\n \"params\": {\n \"adapterId\": \"unknown-form-engine\",\n \"dataBlockType\": \"dataCollection\"\n },\n \"isPositive\": false\n },\n {\n \"id\": \"reject-duplicate-block\",\n \"request\": \"Add another block using the existing consent-form id.\",\n \"operationId\": \"dataBlock.add\",\n \"params\": {\n \"journeyId\": \"privacy\",\n \"stepId\": \"review\",\n \"block\": {\n \"blockId\": \"consent-form\",\n \"kind\": \"dataCollection\",\n \"formBlockId\": \"consent-form-copy\"\n }\n },\n \"isPositive\": false\n },\n {\n \"id\": \"reject-field-metadata-duplication\",\n \"request\": \"Change the control type inside editorial forms instead of metadata editor.\",\n \"operationId\": \"fieldBinding.set\",\n \"params\": {\n \"blockId\": \"contact-form\",\n \"fieldName\": \"email\",\n \"contextPath\": \"formData.email\",\n \"controlType\": \"select\"\n },\n \"isPositive\": false\n }\n ]\n}",
1224
- "sourcePointer": "praxis-ui-angular/projects/praxis-editorial-forms/src/lib/ai/praxis-editorial-forms-authoring-manifest.ts",
1340
+ "sourcePointer": "projects/praxis-editorial-forms/src/lib/ai/praxis-editorial-forms-authoring-manifest.ts",
1225
1341
  "contentHash": "3048bd002915a167939b90cf8c85c48c4e3c9e888a8af2353bb649ed25a493fe",
1226
1342
  "sourceKind": "component_definition",
1227
1343
  "sourceId": "praxis-editorial-forms",
package/package.json CHANGED
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "@praxisui/editorial-forms",
3
- "version": "9.0.0-beta.71",
3
+ "version": "9.0.0-beta.73",
4
4
  "description": "Editorial form runtime for Praxis UI: journeys, presets, semantic blocks, and specialist hosting for editorial experiences.",
5
5
  "peerDependencies": {
6
6
  "@angular/common": "^21.0.0",
7
7
  "@angular/core": "^21.0.0",
8
- "@praxisui/core": "^9.0.0-beta.71",
8
+ "@praxisui/core": "^9.0.0-beta.73",
9
9
  "@angular/material": "^21.0.0"
10
10
  },
11
11
  "dependencies": {