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

package/README.md

@@ -254,6 +254,12 @@ com `content`, `widgets` ou `actionButtons` exige confirmacao explicita. Quando
 `accordion.multi` estiver desabilitado, somente um painel pode ficar expandido por
 padrao; o authoring deve colapsar os demais ou falhar validacao.
 
+Cada operacao declara `target.resolver`, `preconditions`, `validators`,
+`affectedPaths`, `effects` e `submissionImpact` tipado. Edicoes de conteudo de
+painel podem afetar dados schema-backed porque `panels[].content` hospeda
+`FieldMetadata[]`; widgets filhos continuam governados pelos contratos dos
+respectivos componentes.
+
 ## Tokens de Estilo por instância
 
 Os tokens opcionais em `appearance.tokens` permitem customizações rápidas por instância; por exemplo:

package/fesm2022/praxisui-expansion.mjs

@@ -1801,9 +1801,11 @@ const PRAXIS_EXPANSION_AUTHORING_MANIFEST = {
             target: { kind: 'panel', resolver: 'panels-array', ambiguityPolicy: 'fail', required: false },
             inputSchema: panelItemSchema,
             effects: [{ kind: 'append-unique', path: 'panels[]', key: 'id' }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['panel-id-unique', 'panel-order-deterministic', 'panel-content-valid'],
             affectedPaths: ['panels[]'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized'],
         },
         {
@@ -1818,12 +1820,28 @@ const PRAXIS_EXPANSION_AUTHORING_MANIFEST = {
                     replacementExpandedPanelId: { type: 'string' },
                 },
             },
-            effects: [{ kind: 'remove-by-key', path: 'panels[]', key: 'id' }],
+            effects: [{
+                    kind: 'compile-domain-patch',
+                    handler: 'expansion-panel-remove',
+                    handlerContract: {
+                        reads: ['accordion.multi', 'panels[]', 'panels[].id', 'panels[].expanded'],
+                        writes: ['panels[]', 'panels[].expanded'],
+                        identityKeys: ['panels[].id'],
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                replacementExpandedPanelId: { type: 'string' },
+                            },
+                        },
+                        failureModes: ['panel-not-found', 'replacement-panel-not-found', 'content-removal-not-confirmed', 'single-expand-conflict'],
+                        description: 'Removes the target panel by stable id and applies replacement expanded state when the removed panel was expanded.',
+                    },
+                }],
             destructive: true,
             requiresConfirmation: true,
             validators: ['panel-exists', 'default-expanded-removal-safe', 'panel-content-removal-confirmed'],
-            affectedPaths: ['panels[]'],
-            submissionImpact: false,
+            affectedPaths: ['panels[]', 'panels[].expanded'],
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized', 'target-panel-exists', 'confirmation-collected'],
         },
         {
@@ -1834,9 +1852,11 @@ const PRAXIS_EXPANSION_AUTHORING_MANIFEST = {
             target: { kind: 'panelHeader', resolver: 'panel-by-id-or-title', ambiguityPolicy: 'fail', required: true },
             inputSchema: { type: 'object', required: ['title'], properties: { title: { type: 'string' } } },
             effects: [{ kind: 'merge-by-key', path: 'panels[]', key: 'id' }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['panel-exists', 'panel-title-valid'],
             affectedPaths: ['panels[].title'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized', 'target-panel-exists'],
         },
         {
@@ -1847,9 +1867,11 @@ const PRAXIS_EXPANSION_AUTHORING_MANIFEST = {
             target: { kind: 'panelHeader', resolver: 'panel-by-id-or-title', ambiguityPolicy: 'fail', required: true },
             inputSchema: { type: 'object', required: ['description'], properties: { description: { type: 'string' } } },
             effects: [{ kind: 'merge-by-key', path: 'panels[]', key: 'id' }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['panel-exists', 'panel-description-valid'],
             affectedPaths: ['panels[].description'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized', 'target-panel-exists'],
         },
         {
@@ -1860,9 +1882,11 @@ const PRAXIS_EXPANSION_AUTHORING_MANIFEST = {
             target: { kind: 'panelHeader', resolver: 'panel-by-id-or-title', ambiguityPolicy: 'fail', required: true },
             inputSchema: { type: 'object', required: ['icon'], properties: { icon: { type: 'string' } } },
             effects: [{ kind: 'merge-by-key', path: 'panels[]', key: 'id' }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['panel-exists', 'panel-icon-valid', 'editor-runtime-round-trip'],
             affectedPaths: ['panels[].icon'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized', 'target-panel-exists'],
         },
         {
@@ -1873,9 +1897,11 @@ const PRAXIS_EXPANSION_AUTHORING_MANIFEST = {
             target: { kind: 'panel', resolver: 'panel-by-id-or-title', ambiguityPolicy: 'fail', required: true },
             inputSchema: { type: 'object', required: ['beforePanelId'], properties: { beforePanelId: { type: 'string' } } },
             effects: [{ kind: 'reorder-by-key', path: 'panels[]', key: 'id' }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['panel-exists', 'panel-order-deterministic'],
             affectedPaths: ['panels[]'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized', 'target-panel-exists'],
         },
         {
@@ -1886,9 +1912,11 @@ const PRAXIS_EXPANSION_AUTHORING_MANIFEST = {
             target: { kind: 'disabledState', resolver: 'panel-by-id-or-title', ambiguityPolicy: 'fail', required: true },
             inputSchema: { type: 'object', required: ['disabled'], properties: { disabled: { type: 'boolean' } } },
             effects: [{ kind: 'merge-by-key', path: 'panels[]', key: 'id' }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['panel-exists', 'disabled-expanded-compatible'],
             affectedPaths: ['panels[].disabled', 'panels[].expanded'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized', 'target-panel-exists'],
         },
         {
@@ -1898,10 +1926,23 @@ const PRAXIS_EXPANSION_AUTHORING_MANIFEST = {
             targetKind: 'behavior',
             target: { kind: 'behavior', resolver: 'expansion-behavior-config', ambiguityPolicy: 'fail', required: true },
             inputSchema: { type: 'object', required: ['multi'], properties: { multi: { type: 'boolean' } } },
-            effects: [{ kind: 'set-value', path: 'accordion.multi' }],
+            effects: [{
+                    kind: 'compile-domain-patch',
+                    handler: 'expansion-multi-expand-set',
+                    handlerContract: {
+                        reads: ['accordion.multi', 'panels[]', 'panels[].id', 'panels[].expanded'],
+                        writes: ['accordion.multi', 'panels[].expanded'],
+                        identityKeys: ['panels[].id'],
+                        inputSchema: { type: 'object', required: ['multi'], properties: { multi: { type: 'boolean' } } },
+                        failureModes: ['multiple-expanded-panels-conflict', 'panel-id-missing'],
+                        description: 'Sets accordion.multi and collapses competing expanded panels when switching to single-expand behavior.',
+                    },
+                }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['multi-expand-default-compatible', 'accordion-values-valid', 'editor-runtime-round-trip'],
             affectedPaths: ['accordion.multi', 'panels[].expanded'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized'],
         },
         {
@@ -1939,8 +1980,10 @@ const PRAXIS_EXPANSION_AUTHORING_MANIFEST = {
                     },
                 }],
             validators: ['panel-exists', 'default-expanded-panel-exists', 'multi-expand-default-compatible', 'disabled-expanded-compatible'],
+            destructive: false,
+            requiresConfirmation: false,
             affectedPaths: ['panels[].expanded', 'accordion.multi'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized', 'target-panel-exists'],
         },
         {
@@ -1951,9 +1994,11 @@ const PRAXIS_EXPANSION_AUTHORING_MANIFEST = {
             target: { kind: 'panelContent', resolver: 'panel-content-by-id', ambiguityPolicy: 'fail', required: true },
             inputSchema: panelPatchSchema,
             effects: [{ kind: 'merge-by-key', path: 'panels[]', key: 'id' }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['panel-exists', 'panel-content-valid', 'lazy-content-compatible', 'nested-widget-contract-delegated'],
             affectedPaths: ['panels[].content', 'panels[].widgets', 'panels[].actionButtons'],
-            submissionImpact: false,
+            submissionImpact: 'affects-schema-backed-data',
             preconditions: ['config-initialized', 'target-panel-exists'],
         },
     ],
@@ -1971,7 +2016,6 @@ const PRAXIS_EXPANSION_AUTHORING_MANIFEST = {
         { validatorId: 'multi-expand-default-compatible', level: 'error', code: 'PEXP011', description: 'When accordion.multi is false, at most one panel may be marked expanded by default.' },
         { validatorId: 'disabled-expanded-compatible', level: 'warning', code: 'PEXP012', description: 'A disabled panel should not be the only expanded/default focus target without explicit intent.' },
         { validatorId: 'accordion-values-valid', level: 'error', code: 'PEXP013', description: 'Accordion behavior values must match ExpansionMetadata and Angular Material expansion bindings.' },
-        { validatorId: 'layout-values-valid', level: 'error', code: 'PEXP014', description: 'Layout values must match ExpansionMetadata appearance, displayMode and togglePosition enums.' },
         { validatorId: 'lazy-content-compatible', level: 'info', code: 'PEXP015', description: 'Panel content remains lazy through matExpansionPanelContent and should not require eager child runtime state.' },
         { validatorId: 'nested-widget-contract-delegated', level: 'info', code: 'PEXP016', description: 'Nested widget content remains governed by child component contracts and component-port nestedPath semantics.' },
         { validatorId: 'editor-runtime-round-trip', level: 'error', code: 'PEXP017', description: 'Settings Panel editor, runtime persistence and registry projection must preserve panel ids, order, icons and expanded state.' },

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@praxisui/expansion",
-  "version": "8.0.0-beta.11",
+  "version": "8.0.0-beta.12",
   "description": "Expansion panel (accordion) components for Praxis UI with metadata configuration and editor integration.",
   "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-fields": "^8.0.0-beta.11",
-    "@praxisui/settings-panel": "^8.0.0-beta.11"
+    "@praxisui/core": "^8.0.0-beta.12",
+    "@praxisui/dynamic-fields": "^8.0.0-beta.12",
+    "@praxisui/settings-panel": "^8.0.0-beta.12"
   },
   "dependencies": {
     "tslib": "^2.3.0"