@praxisui/stepper 8.0.0-beta.11 → 8.0.0-beta.12

package/README.md

@@ -219,6 +219,12 @@ etapa com formulario, rich content ou widgets exige confirmacao explicita. Regra
 de validacao devem ser projetadas em `steps[].form.config` ou delegadas ao
 `serverValidate` do host; o stepper nao define uma DSL paralela de validacao.
 
+Cada operacao declara `target.resolver`, `preconditions`, `validators`,
+`affectedPaths`, `effects` e `submissionImpact` tipado. Edicoes de conteudo de
+etapa podem afetar dados schema-backed porque `steps[].form.config` hospeda o
+`FormConfig` do `praxis-dynamic-form`; widgets filhos continuam governados pelos
+contratos dos respectivos componentes.
+
 ## Conteudo Editorial por Etapa
 
 O conteudo editorial do stepper usa a mesma base de rich content da plataforma:

package/fesm2022/praxisui-stepper.mjs

@@ -4719,9 +4719,11 @@ const PRAXIS_STEPPER_AUTHORING_MANIFEST = {
             target: { kind: 'step', resolver: 'steps-array', ambiguityPolicy: 'fail', required: false },
             inputSchema: stepItemSchema,
             effects: [{ kind: 'append-unique', path: 'steps[]', key: 'id' }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['step-id-unique', 'step-order-deterministic', 'step-content-valid'],
-            affectedPaths: ['steps[]', 'selectedIndex'],
-            submissionImpact: false,
+            affectedPaths: ['steps[]'],
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized'],
         },
         {
@@ -4736,12 +4738,28 @@ const PRAXIS_STEPPER_AUTHORING_MANIFEST = {
                     replacementStepId: { type: 'string' },
                 },
             },
-            effects: [{ kind: 'remove-by-key', path: 'steps[]', key: 'id' }],
+            effects: [{
+                    kind: 'compile-domain-patch',
+                    handler: 'stepper-step-remove',
+                    handlerContract: {
+                        reads: ['steps[]', 'selectedIndex'],
+                        writes: ['steps[]', 'selectedIndex'],
+                        identityKeys: ['steps[].id'],
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                replacementStepId: { type: 'string' },
+                            },
+                        },
+                        failureModes: ['step-not-found', 'replacement-step-not-found', 'content-removal-not-confirmed'],
+                        description: 'Removes the target step by stable id and recomputes selectedIndex to preserve deterministic navigation state.',
+                    },
+                }],
             destructive: true,
             requiresConfirmation: true,
             validators: ['step-exists', 'selected-step-removal-safe', 'step-content-removal-confirmed'],
             affectedPaths: ['steps[]', 'selectedIndex'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized', 'target-step-exists', 'confirmation-collected'],
         },
         {
@@ -4752,9 +4770,11 @@ const PRAXIS_STEPPER_AUTHORING_MANIFEST = {
             target: { kind: 'stepLabel', resolver: 'step-by-id-or-label', ambiguityPolicy: 'fail', required: true },
             inputSchema: { type: 'object', required: ['label'], properties: { label: { type: 'string' } } },
             effects: [{ kind: 'merge-by-key', path: 'steps[]', key: 'id' }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['step-exists', 'step-label-valid'],
             affectedPaths: ['steps[].label'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized', 'target-step-exists'],
         },
         {
@@ -4764,10 +4784,23 @@ const PRAXIS_STEPPER_AUTHORING_MANIFEST = {
             targetKind: 'step',
             target: { kind: 'step', resolver: 'step-by-id-or-label', ambiguityPolicy: 'fail', required: true },
             inputSchema: { type: 'object', required: ['beforeStepId'], properties: { beforeStepId: { type: 'string' } } },
-            effects: [{ kind: 'reorder-by-key', path: 'steps[]', key: 'id' }],
+            effects: [{
+                    kind: 'compile-domain-patch',
+                    handler: 'stepper-step-reorder',
+                    handlerContract: {
+                        reads: ['steps[]', 'selectedIndex'],
+                        writes: ['steps[]', 'selectedIndex'],
+                        identityKeys: ['steps[].id'],
+                        inputSchema: { type: 'object', required: ['beforeStepId'], properties: { beforeStepId: { type: 'string' } } },
+                        failureModes: ['step-not-found', 'before-step-not-found', 'ambiguous-step-target'],
+                        description: 'Moves the target step before another stable step id and recomputes selectedIndex by preserving selected step identity.',
+                    },
+                }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['step-exists', 'step-order-deterministic', 'selected-index-preserved'],
             affectedPaths: ['steps[]', 'selectedIndex'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized', 'target-step-exists'],
         },
         {
@@ -4778,9 +4811,11 @@ const PRAXIS_STEPPER_AUTHORING_MANIFEST = {
             target: { kind: 'completionRule', resolver: 'step-by-id-or-label', ambiguityPolicy: 'fail', required: true },
             inputSchema: { type: 'object', required: ['optional'], properties: { optional: { type: 'boolean' } } },
             effects: [{ kind: 'merge-by-key', path: 'steps[]', key: 'id' }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['step-exists', 'completion-rule-compatible'],
             affectedPaths: ['steps[].optional'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized', 'target-step-exists'],
         },
         {
@@ -4791,9 +4826,11 @@ const PRAXIS_STEPPER_AUTHORING_MANIFEST = {
             target: { kind: 'completionRule', resolver: 'step-by-id-or-label', ambiguityPolicy: 'fail', required: true },
             inputSchema: { type: 'object', required: ['completed'], properties: { completed: { type: 'boolean' }, hasError: { type: 'boolean' }, errorMessage: { type: 'string' } } },
             effects: [{ kind: 'merge-by-key', path: 'steps[]', key: 'id' }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['step-exists', 'completion-rule-compatible', 'linear-completion-safe'],
             affectedPaths: ['steps[].completed', 'steps[].hasError', 'steps[].errorMessage'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized', 'target-step-exists'],
         },
         {
@@ -4817,9 +4854,11 @@ const PRAXIS_STEPPER_AUTHORING_MANIFEST = {
                 },
             },
             effects: [{ kind: 'merge-object', path: 'navigation' }, { kind: 'set-value', path: 'linear' }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['navigation-values-valid', 'linear-navigation-valid', 'editor-runtime-round-trip'],
             affectedPaths: ['navigation.visible', 'navigation.prevLabel', 'navigation.nextLabel', 'navigation.prevIcon', 'navigation.nextIcon', 'navigation.variant', 'navigation.color', 'navigation.align', 'linear'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized'],
         },
         {
@@ -4839,9 +4878,11 @@ const PRAXIS_STEPPER_AUTHORING_MANIFEST = {
                 },
             },
             effects: [{ kind: 'set-value', path: 'orientation' }, { kind: 'set-value', path: 'headerPosition' }, { kind: 'set-value', path: 'labelPosition' }, { kind: 'set-value', path: 'density' }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['orientation-values-valid', 'label-position-compatible', 'editor-runtime-round-trip'],
             affectedPaths: ['orientation', 'headerPosition', 'labelPosition', 'density'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized'],
         },
         {
@@ -4891,8 +4932,10 @@ const PRAXIS_STEPPER_AUTHORING_MANIFEST = {
                     },
                 }],
             validators: ['step-exists', 'validation-rule-target-exists', 'validation-rule-compatible', 'server-validation-delegated'],
-            affectedPaths: ['steps[].form.config', 'steps[].hasError', 'steps[].errorMessage', 'linear'],
-            submissionImpact: true,
+            destructive: false,
+            requiresConfirmation: false,
+            affectedPaths: ['steps[].form.config', 'steps[].form.config.sections', 'steps[].form.config.fieldMetadata', 'steps[].hasError', 'steps[].errorMessage'],
+            submissionImpact: 'affects-schema-backed-data',
             preconditions: ['config-initialized', 'target-step-exists'],
         },
         {
@@ -4903,9 +4946,11 @@ const PRAXIS_STEPPER_AUTHORING_MANIFEST = {
             target: { kind: 'stepContent', resolver: 'step-content-by-id', ambiguityPolicy: 'fail', required: true },
             inputSchema: stepPatchSchema,
             effects: [{ kind: 'merge-by-key', path: 'steps[]', key: 'id' }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['step-exists', 'step-content-valid', 'nested-widget-contract-delegated'],
             affectedPaths: ['steps[].form', 'steps[].stepBlocksBeforeForm', 'steps[].stepBlocksAfterForm', 'steps[].widgets'],
-            submissionImpact: false,
+            submissionImpact: 'affects-schema-backed-data',
             preconditions: ['config-initialized', 'target-step-exists'],
         },
     ],

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@praxisui/stepper",
-  "version": "8.0.0-beta.11",
+  "version": "8.0.0-beta.12",
   "description": "Stepper workflows for Praxis UI with integrated forms, lists, uploads and page builder support.",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0",
     "@angular/material": "^20.0.0",
     "@angular/cdk": "^20.0.0",
-    "@praxisui/core": "^8.0.0-beta.11",
-    "@praxisui/dynamic-form": "^8.0.0-beta.11",
-    "@praxisui/rich-content": "^8.0.0-beta.11",
-    "@praxisui/settings-panel": "^8.0.0-beta.11",
-    "@praxisui/list": "^8.0.0-beta.11",
-    "@praxisui/files-upload": "^8.0.0-beta.11",
-    "@praxisui/page-builder": "^8.0.0-beta.11"
+    "@praxisui/core": "^8.0.0-beta.12",
+    "@praxisui/dynamic-form": "^8.0.0-beta.12",
+    "@praxisui/rich-content": "^8.0.0-beta.12",
+    "@praxisui/settings-panel": "^8.0.0-beta.12",
+    "@praxisui/list": "^8.0.0-beta.12",
+    "@praxisui/files-upload": "^8.0.0-beta.12",
+    "@praxisui/page-builder": "^8.0.0-beta.12"
   },
   "dependencies": {
     "tslib": "^2.3.0"