@praxisui/expansion 9.0.67 → 9.0.68-rc.1

package/README.md

@@ -10,6 +10,18 @@ The package owns the expansion shell and metadata shape. The host owns domain da
 - Avoid when: for a one-off static Material expansion panel that does not need Praxis metadata or authoring.
 - Pair with: @praxisui/core, @praxisui/settings-panel, and @praxisui/dynamic-fields for editable panel content.
 
+### Nested page headers and scrolling
+
+The panel clips content to its rounded boundary without creating a separate
+scroll container. Nested Dynamic Page Widget Shells can follow the enclosing
+page's scrollport when their existing `stickyHeader` option is enabled. Material
+continues to own expansion/collapse, lazy content and collapsed-content isolation.
+
+`panels[].widgets` loads components directly; it does not create child shells.
+For a nested page, register `providePraxisDynamicPageMetadata()` from
+`@praxisui/core`, load `praxis-dynamic-page`, and declare shells on that page's
+`WidgetPageDefinition`, not on the container's `WidgetDefinition`.
+
 ## Install
 
 ```bash
@@ -84,6 +96,7 @@ export class ExpansionHostComponent {
 - `config: ExpansionMetadata | null`: canonical accordion and panel configuration.
 - `expansionId: string`: required stable id used for local configuration persistence.
 - `componentInstanceId?: string`: disambiguates repeated instances on the same route.
+- `configPersistenceStrategy: 'storage-first' | 'input-first'`: defaults to `storage-first`; with `input-first` and a supplied `config`, the parent composition owns configuration and Expansion does not read or write component storage.
 - `context: Record<string, unknown>`: context passed to dynamic child widgets.
 - `strictValidation: boolean`: keeps runtime validation strict by default.
 - `enableCustomization: boolean`: opens runtime authoring affordances.
@@ -127,6 +140,22 @@ Panel `content` and `widgets` are rendered lazily with `matExpansionPanelContent
 
 When `expansionId` is provided, configuration is stored under a key derived from route, component type, `expansionId` and optional `componentInstanceId`. `enableCustomization` opens Settings Panel editing and the governed semantic assistant flow.
 
+For input-owned nested compositions, set `configPersistenceStrategy: 'input-first'`
+on the Expansion instance and supply `config`. This lifecycle policy is independent
+of customization: `enableCustomization:false` hides authoring controls, but does
+not disable storage in the default `storage-first` mode. A child Dynamic Page's
+`autoPersist:false` does not govern its parent container.
+
+Input-first prevents stored configuration from replacing incoming child context,
+including a storage request already in flight when ownership changes. Adapter and
+component-editor application also respect this policy. The widget config editor
+preserves the host's input envelope on apply/save; the composition owner remains
+responsible for persisting the authored document, never the runtime employee or
+record context. This is a host lifecycle input, not a panel-design setting.
+Without a supplied config, input-first falls back to the standalone storage path.
+Existing storage-first hosts keep their default behavior; no stored data is deleted
+or migrated automatically.
+
 `PRAXIS_EXPANSION_AUTHORING_MANIFEST` describes supported AI/tooling operations for panel add/remove/order, titles, descriptions, icons, disabled state, default expanded state, multi-expand behavior and panel content. Free JSON patches are not the public authoring contract.
 
 ## Table Detail Resource Resolver

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-09-07T00:54:55.301Z",
+  "generatedAt": "2026-09-09T11:40:45.048Z",
   "packageName": "@praxisui/expansion",
-  "packageVersion": "9.0.67",
+  "packageVersion": "9.0.68-rc.1",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,
@@ -32,6 +32,14 @@
           "description": "Identificador opcional para múltiplas instâncias na mesma rota",
           "label": "ID da instância"
         },
+        {
+          "name": "configPersistenceStrategy",
+          "type": "\"storage-first\" | \"input-first\"",
+          "required": false,
+          "description": "Em input-first com config fornecido, a composição governa a instância sem carregar ou gravar configuração própria.",
+          "label": "Estratégia de persistência",
+          "default": "storage-first"
+        },
         {
           "name": "enableCustomization",
           "type": "boolean",
@@ -794,6 +802,11 @@
             "type": "string",
             "description": "Optional instance discriminator for persistence scope."
           },
+          {
+            "name": "configPersistenceStrategy",
+            "type": "\"storage-first\" | \"input-first\"",
+            "description": "Host-owned lifecycle policy. Input-first with supplied config skips component storage; authoring returns the widget input document to its composition owner."
+          },
           {
             "name": "context",
             "type": "Record<string, any>",
@@ -1699,9 +1712,9 @@
         {
           "chunkIndex": 0,
           "chunkKind": "summary",
-          "content": "Component ID: praxis-expansion\nSelector: praxis-expansion\nFriendly Name: Praxis Expansion Panel\nDescription: Acordeão/Painéis de expansão configuráveis por metadata, com aparência e tokens M3.\nLib/Package: @praxisui/expansion\nTags: widget, expansion, accordion, configurable\nInputs:\n  - config (ExpansionMetadata)\n  - expansionId (string)\n  - componentInstanceId (string)\n  - enableCustomization (boolean)\n  - context (Record<string, any>)\n  - strictValidation (boolean)\n  - defaultOptions (MatExpansionPanelDefaultOptions)\nOutputs:\n  - opened ({ panelId?: string; panelIndex: number })\n  - closed ({ panelId?: string; panelIndex: number })\n  - expandedChange ({ panelId?: string; panelIndex: number; expanded: boolean })\n  - afterExpand ({ panelId?: string; panelIndex: number })\n  - afterCollapse ({ panelId?: string; panelIndex: number })\n  - destroyed ({ panelId?: string; panelIndex: number })\n  - widgetEvent (WidgetEventEnvelope)\n",
+          "content": "Component ID: praxis-expansion\nSelector: praxis-expansion\nFriendly Name: Praxis Expansion Panel\nDescription: Acordeão/Painéis de expansão configuráveis por metadata, com aparência e tokens M3.\nLib/Package: @praxisui/expansion\nTags: widget, expansion, accordion, configurable\nInputs:\n  - config (ExpansionMetadata)\n  - expansionId (string)\n  - componentInstanceId (string)\n  - configPersistenceStrategy (\"storage-first\" | \"input-first\")\n  - enableCustomization (boolean)\n  - context (Record<string, any>)\n  - strictValidation (boolean)\n  - defaultOptions (MatExpansionPanelDefaultOptions)\nOutputs:\n  - opened ({ panelId?: string; panelIndex: number })\n  - closed ({ panelId?: string; panelIndex: number })\n  - expandedChange ({ panelId?: string; panelIndex: number; expanded: boolean })\n  - afterExpand ({ panelId?: string; panelIndex: number })\n  - afterCollapse ({ panelId?: string; panelIndex: number })\n  - destroyed ({ panelId?: string; panelIndex: number })\n  - widgetEvent (WidgetEventEnvelope)\n",
           "sourcePointer": "projects/praxis-expansion/src/lib/praxis-expansion.metadata.ts",
-          "contentHash": "30ccb793a31c22baf57710e1c70b92fc952e40dcea38869a7f32ce91d1600ece",
+          "contentHash": "11cbeea26795063d61451d06de8a4b040e38611191e5c8e5bad4065ce1e27095",
           "sourceKind": "component_definition",
           "sourceId": "praxis-expansion",
           "corpusVersion": "1.0.0"
@@ -1829,9 +1842,9 @@
         {
           "chunkIndex": 13,
           "chunkKind": "authoring_manifest",
-          "content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-expansion\",\"ownerPackage\":\"@praxisui/expansion\",\"configSchemaId\":\"ExpansionMetadata\",\"chunkSection\":\"runtimeInputs\",\"runtimeInputs\":[{\"name\":\"config\",\"type\":\"ExpansionMetadata\",\"description\":\"Canonical accordion and panel configuration.\"},{\"name\":\"expansionId\",\"type\":\"string\",\"description\":\"Stable id used to derive expansion config persistence scope.\"},{\"name\":\"componentInstanceId\",\"type\":\"string\",\"description\":\"Optional instance discriminator for persistence scope.\"},{\"name\":\"context\",\"type\":\"Record<string, any>\",\"description\":\"Context passed to nested widgets.\"},{\"name\":\"strictValidation\",\"type\":\"boolean\",\"description\":\"Controls nested widget validation strictness.\"},{\"name\":\"defaultOptions\",\"type\":\"MatExpansionPanelDefaultOptions\",\"description\":\"Instance-level Material expansion defaults.\"},{\"name\":\"enableCustomization\",\"type\":\"boolean\",\"description\":\"Enables Settings Panel authoring surfaces.\"}]}",
+          "content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-expansion\",\"ownerPackage\":\"@praxisui/expansion\",\"configSchemaId\":\"ExpansionMetadata\",\"chunkSection\":\"runtimeInputs\",\"runtimeInputs\":[{\"name\":\"config\",\"type\":\"ExpansionMetadata\",\"description\":\"Canonical accordion and panel configuration.\"},{\"name\":\"expansionId\",\"type\":\"string\",\"description\":\"Stable id used to derive expansion config persistence scope.\"},{\"name\":\"componentInstanceId\",\"type\":\"string\",\"description\":\"Optional instance discriminator for persistence scope.\"},{\"name\":\"configPersistenceStrategy\",\"type\":\"\\\"storage-first\\\" | \\\"input-first\\\"\",\"description\":\"Host-owned lifecycle policy. Input-first with supplied config skips component storage; authoring returns the widget input document to its composition owner.\"},{\"name\":\"context\",\"type\":\"Record<string, any>\",\"description\":\"Context passed to nested widgets.\"},{\"name\":\"strictValidation\",\"type\":\"boolean\",\"description\":\"Controls nested widget validation strictness.\"},{\"name\":\"defaultOptions\",\"type\":\"MatExpansionPanelDefaultOptions\",\"description\":\"Instance-level Material expansion defaults.\"},{\"name\":\"enableCustomization\",\"type\":\"boolean\",\"description\":\"Enables Settings Panel authoring surfaces.\"}]}",
           "sourcePointer": "projects/praxis-expansion/src/lib/ai/praxis-expansion-authoring-manifest.ts",
-          "contentHash": "087beeaa793a947e5c4de9b19068ef3bd5ba74a5d8503a08339c73f6e1c81bfd",
+          "contentHash": "14027b9ef389e9737fd06096fc21ef833098f73d63a2e1afdecccc7ae7315b75",
           "sourceKind": "component_definition",
           "sourceId": "praxis-expansion",
           "corpusVersion": "1.0.0"

package/fesm2022/praxisui-expansion.mjs

@@ -1,7 +1,7 @@
 import * as i1 from '@angular/common';
 import { CommonModule } from '@angular/common';
 import * as i0 from '@angular/core';
-import { EventEmitter, inject, ChangeDetectorRef, DestroyRef, effect, ViewChildren, ViewChild, Output, Input, ChangeDetectionStrategy, Component, Inject, ENVIRONMENT_INITIALIZER } from '@angular/core';
+import { input, EventEmitter, inject, ChangeDetectorRef, DestroyRef, effect, ViewChildren, ViewChild, Output, Input, ChangeDetectionStrategy, Component, Inject, ENVIRONMENT_INITIALIZER } from '@angular/core';
 import { ActivatedRoute } from '@angular/router';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import * as i2 from '@angular/material/expansion';
@@ -508,6 +508,8 @@ class PraxisExpansion {
     config;
     expansionId;
     componentInstanceId;
+    /** Input-owned compositions must not restore or persist materialized child inputs. */
+    configPersistenceStrategy = input('storage-first', ...(ngDevMode ? [{ debugName: "configPersistenceStrategy" }] : /* istanbul ignore next */ []));
     context = {};
     strictValidation = true;
     enableCustomization = false;
@@ -543,6 +545,8 @@ class PraxisExpansion {
         }
     }, ...(ngDevMode ? [{ debugName: "aiAssistantSessionEffect" }] : /* istanbul ignore next */ []));
     warnedMissingId = false;
+    storageInitialized = false;
+    storageLoad;
     panelForms = new Map();
     aiAdapter = new ExpansionAiAdapter(this);
     aiAssistantOpen = false;
@@ -566,24 +570,39 @@ class PraxisExpansion {
     hasMultiple = () => (this.config?.panels?.length || 0) > 1;
     single = () => (this.config?.panels && this.config.panels[0]) || null;
     ngOnInit() {
+        this.storageInitialized = true;
+        this.loadStoredConfig();
+    }
+    loadStoredConfig() {
+        this.storageLoad?.unsubscribe();
+        if (this.usesInputFirstConfig())
+            return;
         const key = this.storageKey();
         if (!key)
             return;
-        this.storage.loadConfig(key).pipe(take(1)).subscribe((stored) => {
-            if (!stored)
-                return;
-            this.config = stored;
-            this.buildPanelForms();
-            this.cdr.markForCheck();
+        this.storageLoad = this.storage.loadConfig(key).pipe(take(1)).subscribe({
+            next: (stored) => {
+                if (!stored || this.usesInputFirstConfig() || key !== this.storageKey())
+                    return;
+                this.config = stored;
+                this.buildPanelForms();
+                this.cdr.markForCheck();
+            },
+            error: () => { },
         });
     }
     ngOnChanges(changes) {
+        if (this.storageInitialized && (changes['expansionId'] || changes['componentInstanceId']
+            || changes['configPersistenceStrategy'])) {
+            this.loadStoredConfig();
+        }
         if ('config' in changes) {
             this.buildPanelForms();
             this.persistConfig(this.config);
         }
     }
     ngOnDestroy() {
+        this.storageLoad?.unsubscribe();
         this.assistantSessions.removeContextSession(this.buildAiAssistantContextSnapshot().identity);
         this.aiAssistantStateSubscription?.unsubscribe();
     }
@@ -820,10 +839,7 @@ class PraxisExpansion {
     applyConfigFromAdapter(next) {
         this.config = next;
         this.buildPanelForms();
-        const key = this.storageKey();
-        if (key) {
-            this.storage.saveConfig(key, this.config).pipe(take(1)).subscribe({ error: () => { } });
-        }
+        this.persistConfig(this.config);
         this.cdr.markForCheck();
     }
     openAiAssistant() {
@@ -1147,10 +1163,7 @@ class PraxisExpansion {
             if (nextCfg) {
                 this.config = { ...nextCfg };
                 this.buildPanelForms();
-                const storageKey = this.storageKey();
-                if (storageKey) {
-                    this.storage.saveConfig(storageKey, this.config).pipe(take(1)).subscribe({ error: () => { } });
-                }
+                this.persistConfig(this.config);
                 this.cdr.markForCheck();
             }
         };
@@ -1162,13 +1175,16 @@ class PraxisExpansion {
         return id ? `expansion:${id}` : null;
     }
     persistConfig(config) {
-        if (!config)
+        if (!config || this.usesInputFirstConfig())
             return;
         const key = this.storageKey();
         if (!key)
             return;
         this.storage.saveConfig(key, config).pipe(take(1)).subscribe({ error: () => { } });
     }
+    usesInputFirstConfig() {
+        return this.configPersistenceStrategy() === 'input-first' && !!this.config;
+    }
     emitAction(p, index, action) {
         this.widgetEvent.emit({
             sourceComponentId: 'praxis-expansion',
@@ -1218,7 +1234,7 @@ class PraxisExpansion {
         console.warn('[PraxisExpansion] expansionId is required for config persistence.');
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PraxisExpansion, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: PraxisExpansion, isStandalone: true, selector: "praxis-expansion", inputs: { config: "config", expansionId: "expansionId", componentInstanceId: "componentInstanceId", context: "context", strictValidation: "strictValidation", enableCustomization: "enableCustomization", defaultOptions: "defaultOptions" }, outputs: { opened: "opened", closed: "closed", expandedChange: "expandedChange", afterExpand: "afterExpand", afterCollapse: "afterCollapse", destroyed: "destroyed", widgetEvent: "widgetEvent" }, viewQueries: [{ propertyName: "accordionRef", first: true, predicate: ["accordion"], descendants: true }, { propertyName: "panels", predicate: ["panel"], descendants: true, read: MatExpansionPanel }], usesOnChanges: true, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: PraxisExpansion, isStandalone: true, selector: "praxis-expansion", inputs: { config: { classPropertyName: "config", publicName: "config", isSignal: false, isRequired: false, transformFunction: null }, expansionId: { classPropertyName: "expansionId", publicName: "expansionId", isSignal: false, isRequired: true, transformFunction: null }, componentInstanceId: { classPropertyName: "componentInstanceId", publicName: "componentInstanceId", isSignal: false, isRequired: false, transformFunction: null }, configPersistenceStrategy: { classPropertyName: "configPersistenceStrategy", publicName: "configPersistenceStrategy", isSignal: true, isRequired: false, transformFunction: null }, context: { classPropertyName: "context", publicName: "context", isSignal: false, isRequired: false, transformFunction: null }, strictValidation: { classPropertyName: "strictValidation", publicName: "strictValidation", isSignal: false, isRequired: false, transformFunction: null }, enableCustomization: { classPropertyName: "enableCustomization", publicName: "enableCustomization", isSignal: false, isRequired: false, transformFunction: null }, defaultOptions: { classPropertyName: "defaultOptions", publicName: "defaultOptions", isSignal: false, isRequired: false, transformFunction: null } }, outputs: { opened: "opened", closed: "closed", expandedChange: "expandedChange", afterExpand: "afterExpand", afterCollapse: "afterCollapse", destroyed: "destroyed", widgetEvent: "widgetEvent" }, viewQueries: [{ propertyName: "accordionRef", first: true, predicate: ["accordion"], descendants: true }, { propertyName: "panels", predicate: ["panel"], descendants: true, read: MatExpansionPanel }], usesOnChanges: true, ngImport: i0, template: `
     <div
       class="praxis-expansion-root"
       [class.density-compact]="config?.appearance?.density === 'compact'"
@@ -1437,7 +1453,7 @@ class PraxisExpansion {
         <mat-icon fontIcon="edit"></mat-icon>
       </button>
     }
-    `, isInline: true, styles: [":host{display:block;position:relative;color:var(--md-sys-color-on-surface)}.praxis-expansion-root{display:block;--p-exp-surface: var(--md-sys-color-surface);--p-exp-surface-container: var(--md-sys-color-surface-container);--p-exp-border: var(--md-sys-color-outline-variant);--p-exp-text: var(--md-sys-color-on-surface);--p-exp-text-muted: var(--md-sys-color-on-surface-variant);--p-exp-focus: var(--md-sys-color-primary);--p-exp-radius: 12px}.mat-expansion-panel{background:var(--p-exp-surface);border:1px solid var(--p-exp-border);border-radius:var(--p-exp-radius);overflow:hidden}.mat-expansion-panel:not(:last-child){margin-bottom:var(--p-exp-panel-gap, 12px)}.mat-expansion-panel-header{background:var(--p-exp-surface-container);color:var(--p-exp-text)}.mat-expansion-panel-header:focus-visible{outline:2px solid var(--p-exp-focus);outline-offset:-2px}.mat-expansion-panel-header-title{font-weight:600}.mat-expansion-panel-header-description{color:var(--p-exp-text-muted)}.mat-expansion-panel-body{padding:12px 16px 16px}.mat-action-row{border-top:1px solid var(--p-exp-border)}.density-compact .mat-expansion-panel-body{padding:8px 12px 12px}.density-compact .mat-expansion-panel-header{min-height:40px;padding:0 12px}.density-comfortable .mat-expansion-panel-body{padding:12px 16px 16px}.density-comfortable .mat-expansion-panel-header{min-height:48px;padding:0 16px}.density-spacious .mat-expansion-panel-body{padding:16px 20px 20px}.density-spacious .mat-expansion-panel-header{min-height:56px;padding:0 20px}.praxis-expansion-empty{display:flex;gap:8px;align-items:center;padding:8px 12px;color:var(--p-exp-text-muted)}.edit-fab{position:absolute;right:12px;bottom:12px;z-index:2}.expansion-ai-assistant{position:absolute;right:12px;bottom:72px;z-index:3}.expansion-ai-assistant-trigger{box-shadow:var(--md-sys-elevation-level2, 0 4px 12px rgba(0, 0, 0, .18))}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1.NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "ngmodule", type: MatExpansionModule }, { kind: "directive", type: i2.MatAccordion, selector: "mat-accordion", inputs: ["hideToggle", "displayMode", "togglePosition"], exportAs: ["matAccordion"] }, { kind: "component", type: i2.MatExpansionPanel, selector: "mat-expansion-panel", inputs: ["hideToggle", "togglePosition"], outputs: ["afterExpand", "afterCollapse"], exportAs: ["matExpansionPanel"] }, { kind: "directive", type: i2.MatExpansionPanelActionRow, selector: "mat-action-row" }, { kind: "component", type: i2.MatExpansionPanelHeader, selector: "mat-expansion-panel-header", inputs: ["expandedHeight", "collapsedHeight", "tabIndex"] }, { kind: "directive", type: i2.MatExpansionPanelTitle, selector: "mat-panel-title" }, { kind: "directive", type: i2.MatExpansionPanelDescription, selector: "mat-panel-description" }, { kind: "directive", type: i2.MatExpansionPanelContent, selector: "ng-template[matExpansionPanelContent]" }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i3.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i4.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "component", type: i4.MatMiniFabButton, selector: "button[mat-mini-fab], a[mat-mini-fab], button[matMiniFab], a[matMiniFab]", exportAs: ["matButton", "matAnchor"] }, { kind: "component", type: i4.MatFabButton, selector: "button[mat-fab], a[mat-fab], button[matFab], a[matFab]", inputs: ["extended"], exportAs: ["matButton", "matAnchor"] }, { kind: "directive", type: DynamicFieldLoaderDirective, selector: "[dynamicFieldLoader]", inputs: ["fields", "formGroup", "enableExternalControlBinding", "itemTemplate", "debugTrace", "debugTraceLabel", "readonlyMode", "disabledMode", "presentationMode", "visible", "canvasMode"], outputs: ["componentsCreated", "fieldCreated", "fieldDestroyed", "renderError", "canvasMouseEnter", "canvasMouseLeave", "canvasClick", "canvasFocus"] }, { kind: "directive", type: DynamicWidgetLoaderDirective, selector: "[dynamicWidgetLoader]", inputs: ["dynamicWidgetLoader", "ownerWidgetKey", "context", "strictValidation", "autoWireOutputs"], outputs: ["widgetEvent", "widgetDiagnostic"], exportAs: ["dynamicWidgetLoader"] }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }, { kind: "component", type: PraxisAiAssistantShellComponent, selector: "praxis-ai-assistant-shell", inputs: ["labels", "mode", "state", "contextItems", "attachments", "messages", "quickReplies", "recommendedIntents", "prompt", "statusText", "errorText", "testIdPrefix", "panelTestId", "submitTestId", "applyTestId", "primaryAction", "secondaryActions", "governanceActions", "busy", "canSubmit", "canApply", "submitOnEnter", "showAttachAction", "enablePastedAttachments", "enableFileAttachments", "attachmentAccept", "attachmentMultiple", "voiceInputMode", "voiceLanguage", "draggable", "resizable", "minWidth", "minHeight", "margin", "layout"], outputs: ["promptChange", "submitPrompt", "apply", "retryTurn", "cancelTurn", "shellAction", "close", "attach", "attachmentsPasted", "attachmentsSelected", "removeAttachment", "messageAction", "editMessage", "resendMessage", "quickReply", "recommendedIntent", "layoutChange"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+    `, isInline: true, styles: [":host{display:block;position:relative;color:var(--md-sys-color-on-surface)}.praxis-expansion-root{display:block;--p-exp-surface: var(--md-sys-color-surface);--p-exp-surface-container: var(--md-sys-color-surface-container);--p-exp-border: var(--md-sys-color-outline-variant);--p-exp-text: var(--md-sys-color-on-surface);--p-exp-text-muted: var(--md-sys-color-on-surface-variant);--p-exp-focus: var(--md-sys-color-primary);--p-exp-radius: 12px}.mat-expansion-panel{background:var(--p-exp-surface);border:1px solid var(--p-exp-border);border-radius:var(--p-exp-radius);overflow:clip}.mat-expansion-panel:not(:last-child){margin-bottom:var(--p-exp-panel-gap, 12px)}.mat-expansion-panel-header{background:var(--p-exp-surface-container);color:var(--p-exp-text)}.mat-expansion-panel-header:focus-visible{outline:2px solid var(--p-exp-focus);outline-offset:-2px}.mat-expansion-panel-header-title{font-weight:600}.mat-expansion-panel-header-description{color:var(--p-exp-text-muted)}.mat-expansion-panel-body{padding:12px 16px 16px}.mat-action-row{border-top:1px solid var(--p-exp-border)}.density-compact .mat-expansion-panel-body{padding:8px 12px 12px}.density-compact .mat-expansion-panel-header{min-height:40px;padding:0 12px}.density-comfortable .mat-expansion-panel-body{padding:12px 16px 16px}.density-comfortable .mat-expansion-panel-header{min-height:48px;padding:0 16px}.density-spacious .mat-expansion-panel-body{padding:16px 20px 20px}.density-spacious .mat-expansion-panel-header{min-height:56px;padding:0 20px}.praxis-expansion-empty{display:flex;gap:8px;align-items:center;padding:8px 12px;color:var(--p-exp-text-muted)}.edit-fab{position:absolute;right:12px;bottom:12px;z-index:2}.expansion-ai-assistant{position:absolute;right:12px;bottom:72px;z-index:3}.expansion-ai-assistant-trigger{box-shadow:var(--md-sys-elevation-level2, 0 4px 12px rgba(0, 0, 0, .18))}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1.NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "ngmodule", type: MatExpansionModule }, { kind: "directive", type: i2.MatAccordion, selector: "mat-accordion", inputs: ["hideToggle", "displayMode", "togglePosition"], exportAs: ["matAccordion"] }, { kind: "component", type: i2.MatExpansionPanel, selector: "mat-expansion-panel", inputs: ["hideToggle", "togglePosition"], outputs: ["afterExpand", "afterCollapse"], exportAs: ["matExpansionPanel"] }, { kind: "directive", type: i2.MatExpansionPanelActionRow, selector: "mat-action-row" }, { kind: "component", type: i2.MatExpansionPanelHeader, selector: "mat-expansion-panel-header", inputs: ["expandedHeight", "collapsedHeight", "tabIndex"] }, { kind: "directive", type: i2.MatExpansionPanelTitle, selector: "mat-panel-title" }, { kind: "directive", type: i2.MatExpansionPanelDescription, selector: "mat-panel-description" }, { kind: "directive", type: i2.MatExpansionPanelContent, selector: "ng-template[matExpansionPanelContent]" }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i3.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i4.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "component", type: i4.MatMiniFabButton, selector: "button[mat-mini-fab], a[mat-mini-fab], button[matMiniFab], a[matMiniFab]", exportAs: ["matButton", "matAnchor"] }, { kind: "component", type: i4.MatFabButton, selector: "button[mat-fab], a[mat-fab], button[matFab], a[matFab]", inputs: ["extended"], exportAs: ["matButton", "matAnchor"] }, { kind: "directive", type: DynamicFieldLoaderDirective, selector: "[dynamicFieldLoader]", inputs: ["fields", "formGroup", "enableExternalControlBinding", "itemTemplate", "debugTrace", "debugTraceLabel", "readonlyMode", "disabledMode", "presentationMode", "visible", "canvasMode"], outputs: ["componentsCreated", "fieldCreated", "fieldDestroyed", "renderError", "canvasMouseEnter", "canvasMouseLeave", "canvasClick", "canvasFocus"] }, { kind: "directive", type: DynamicWidgetLoaderDirective, selector: "[dynamicWidgetLoader]", inputs: ["dynamicWidgetLoader", "ownerWidgetKey", "context", "strictValidation", "autoWireOutputs"], outputs: ["widgetEvent", "widgetDiagnostic"], exportAs: ["dynamicWidgetLoader"] }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }, { kind: "component", type: PraxisAiAssistantShellComponent, selector: "praxis-ai-assistant-shell", inputs: ["labels", "mode", "state", "contextItems", "attachments", "messages", "quickReplies", "recommendedIntents", "prompt", "statusText", "errorText", "testIdPrefix", "panelTestId", "submitTestId", "applyTestId", "primaryAction", "secondaryActions", "governanceActions", "busy", "canSubmit", "canApply", "submitOnEnter", "showAttachAction", "enablePastedAttachments", "enableFileAttachments", "attachmentAccept", "attachmentMultiple", "voiceInputMode", "voiceLanguage", "draggable", "resizable", "minWidth", "minHeight", "margin", "layout"], outputs: ["promptChange", "submitPrompt", "apply", "retryTurn", "cancelTurn", "shellAction", "close", "attach", "attachmentsPasted", "attachmentsSelected", "removeAttachment", "messageAction", "editMessage", "resendMessage", "quickReply", "recommendedIntent", "layoutChange"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PraxisExpansion, decorators: [{
             type: Component,
@@ -1669,7 +1685,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
         <mat-icon fontIcon="edit"></mat-icon>
       </button>
     }
-    `, changeDetection: ChangeDetectionStrategy.OnPush, styles: [":host{display:block;position:relative;color:var(--md-sys-color-on-surface)}.praxis-expansion-root{display:block;--p-exp-surface: var(--md-sys-color-surface);--p-exp-surface-container: var(--md-sys-color-surface-container);--p-exp-border: var(--md-sys-color-outline-variant);--p-exp-text: var(--md-sys-color-on-surface);--p-exp-text-muted: var(--md-sys-color-on-surface-variant);--p-exp-focus: var(--md-sys-color-primary);--p-exp-radius: 12px}.mat-expansion-panel{background:var(--p-exp-surface);border:1px solid var(--p-exp-border);border-radius:var(--p-exp-radius);overflow:hidden}.mat-expansion-panel:not(:last-child){margin-bottom:var(--p-exp-panel-gap, 12px)}.mat-expansion-panel-header{background:var(--p-exp-surface-container);color:var(--p-exp-text)}.mat-expansion-panel-header:focus-visible{outline:2px solid var(--p-exp-focus);outline-offset:-2px}.mat-expansion-panel-header-title{font-weight:600}.mat-expansion-panel-header-description{color:var(--p-exp-text-muted)}.mat-expansion-panel-body{padding:12px 16px 16px}.mat-action-row{border-top:1px solid var(--p-exp-border)}.density-compact .mat-expansion-panel-body{padding:8px 12px 12px}.density-compact .mat-expansion-panel-header{min-height:40px;padding:0 12px}.density-comfortable .mat-expansion-panel-body{padding:12px 16px 16px}.density-comfortable .mat-expansion-panel-header{min-height:48px;padding:0 16px}.density-spacious .mat-expansion-panel-body{padding:16px 20px 20px}.density-spacious .mat-expansion-panel-header{min-height:56px;padding:0 20px}.praxis-expansion-empty{display:flex;gap:8px;align-items:center;padding:8px 12px;color:var(--p-exp-text-muted)}.edit-fab{position:absolute;right:12px;bottom:12px;z-index:2}.expansion-ai-assistant{position:absolute;right:12px;bottom:72px;z-index:3}.expansion-ai-assistant-trigger{box-shadow:var(--md-sys-elevation-level2, 0 4px 12px rgba(0, 0, 0, .18))}\n"] }]
+    `, changeDetection: ChangeDetectionStrategy.OnPush, styles: [":host{display:block;position:relative;color:var(--md-sys-color-on-surface)}.praxis-expansion-root{display:block;--p-exp-surface: var(--md-sys-color-surface);--p-exp-surface-container: var(--md-sys-color-surface-container);--p-exp-border: var(--md-sys-color-outline-variant);--p-exp-text: var(--md-sys-color-on-surface);--p-exp-text-muted: var(--md-sys-color-on-surface-variant);--p-exp-focus: var(--md-sys-color-primary);--p-exp-radius: 12px}.mat-expansion-panel{background:var(--p-exp-surface);border:1px solid var(--p-exp-border);border-radius:var(--p-exp-radius);overflow:clip}.mat-expansion-panel:not(:last-child){margin-bottom:var(--p-exp-panel-gap, 12px)}.mat-expansion-panel-header{background:var(--p-exp-surface-container);color:var(--p-exp-text)}.mat-expansion-panel-header:focus-visible{outline:2px solid var(--p-exp-focus);outline-offset:-2px}.mat-expansion-panel-header-title{font-weight:600}.mat-expansion-panel-header-description{color:var(--p-exp-text-muted)}.mat-expansion-panel-body{padding:12px 16px 16px}.mat-action-row{border-top:1px solid var(--p-exp-border)}.density-compact .mat-expansion-panel-body{padding:8px 12px 12px}.density-compact .mat-expansion-panel-header{min-height:40px;padding:0 12px}.density-comfortable .mat-expansion-panel-body{padding:12px 16px 16px}.density-comfortable .mat-expansion-panel-header{min-height:48px;padding:0 16px}.density-spacious .mat-expansion-panel-body{padding:16px 20px 20px}.density-spacious .mat-expansion-panel-header{min-height:56px;padding:0 20px}.praxis-expansion-empty{display:flex;gap:8px;align-items:center;padding:8px 12px;color:var(--p-exp-text-muted)}.edit-fab{position:absolute;right:12px;bottom:12px;z-index:2}.expansion-ai-assistant{position:absolute;right:12px;bottom:72px;z-index:3}.expansion-ai-assistant-trigger{box-shadow:var(--md-sys-elevation-level2, 0 4px 12px rgba(0, 0, 0, .18))}\n"] }]
         }], propDecorators: { config: [{
                 type: Input
             }], expansionId: [{
@@ -1677,7 +1693,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                 args: [{ required: true }]
             }], componentInstanceId: [{
                 type: Input
-            }], context: [{
+            }], configPersistenceStrategy: [{ type: i0.Input, args: [{ isSignal: true, alias: "configPersistenceStrategy", required: false }] }], context: [{
                 type: Input
             }], strictValidation: [{
                 type: Input
@@ -2516,6 +2532,7 @@ const PRAXIS_EXPANSION_COMPONENT_METADATA = {
         { name: 'config', type: 'ExpansionMetadata', label: 'Configuração', description: 'Configuração JSON (acordeão, aparência e painéis)' },
         { name: 'expansionId', type: 'string', label: 'ID', description: 'Identificador para persistência (obrigatório)' },
         { name: 'componentInstanceId', type: 'string', label: 'ID da instância', description: 'Identificador opcional para múltiplas instâncias na mesma rota' },
+        { name: 'configPersistenceStrategy', type: '"storage-first" | "input-first"', default: 'storage-first', label: 'Estratégia de persistência', description: 'Em input-first com config fornecido, a composição governa a instância sem carregar ou gravar configuração própria.' },
         { name: 'enableCustomization', type: 'boolean', default: false, label: 'Modo de customização' },
         { name: 'context', type: 'Record<string, any>', label: 'Contexto' },
         { name: 'strictValidation', type: 'boolean', default: true },
@@ -2648,6 +2665,7 @@ const PRAXIS_EXPANSION_AUTHORING_MANIFEST = {
         { name: 'config', type: 'ExpansionMetadata', description: 'Canonical accordion and panel configuration.' },
         { name: 'expansionId', type: 'string', description: 'Stable id used to derive expansion config persistence scope.' },
         { name: 'componentInstanceId', type: 'string', description: 'Optional instance discriminator for persistence scope.' },
+        { name: 'configPersistenceStrategy', type: '"storage-first" | "input-first"', description: 'Host-owned lifecycle policy. Input-first with supplied config skips component storage; authoring returns the widget input document to its composition owner.' },
         { name: 'context', type: 'Record<string, any>', description: 'Context passed to nested widgets.' },
         { name: 'strictValidation', type: 'boolean', description: 'Controls nested widget validation strictness.' },
         { name: 'defaultOptions', type: 'MatExpansionPanelDefaultOptions', description: 'Instance-level Material expansion defaults.' },

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@praxisui/expansion",
-  "version": "9.0.67",
+  "version": "9.0.68-rc.1",
   "description": "Expansion panel (accordion) components for Praxis UI with metadata configuration and editor integration.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/cdk": "^21.0.0",
-    "@praxisui/core": "^9.0.67",
-    "@praxisui/dynamic-fields": "^9.0.67",
-    "@praxisui/settings-panel": "^9.0.67",
+    "@praxisui/core": "^9.0.68-rc.1",
+    "@praxisui/dynamic-fields": "^9.0.68-rc.1",
+    "@praxisui/settings-panel": "^9.0.68-rc.1",
     "@angular/forms": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^9.0.67",
+    "@praxisui/ai": "^9.0.68-rc.1",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-expansion.d.ts

@@ -112,6 +112,8 @@ declare class PraxisExpansion implements OnChanges, OnDestroy, OnInit {
     config?: ExpansionMetadata | null;
     expansionId: string;
     componentInstanceId?: string;
+    /** Input-owned compositions must not restore or persist materialized child inputs. */
+    readonly configPersistenceStrategy: i0.InputSignal<"storage-first" | "input-first">;
     context: Record<string, any>;
     strictValidation: boolean;
     enableCustomization: boolean;
@@ -154,6 +156,8 @@ declare class PraxisExpansion implements OnChanges, OnDestroy, OnInit {
     private readonly aiTurnOrchestrator;
     private readonly aiAssistantSessionEffect;
     private warnedMissingId;
+    private storageInitialized;
+    private storageLoad?;
     private readonly panelForms;
     aiAdapter: ExpansionAiAdapter;
     aiAssistantOpen: boolean;
@@ -169,6 +173,7 @@ declare class PraxisExpansion implements OnChanges, OnDestroy, OnInit {
     hasMultiple: () => boolean;
     single: () => PanelMetadata | null;
     ngOnInit(): void;
+    private loadStoredConfig;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     styleCss(): string | null;
@@ -220,13 +225,14 @@ declare class PraxisExpansion implements OnChanges, OnDestroy, OnInit {
     openEditor(): void;
     private storageKey;
     private persistConfig;
+    private usesInputFirstConfig;
     emitAction(p: PanelMetadata, index: number, action?: string | undefined): void;
     private panelKey;
     private buildPanelForms;
     private componentKeyId;
     private warnMissingId;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisExpansion, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisExpansion, "praxis-expansion", never, { "config": { "alias": "config"; "required": false; }; "expansionId": { "alias": "expansionId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "defaultOptions": { "alias": "defaultOptions"; "required": false; }; }, { "opened": "opened"; "closed": "closed"; "expandedChange": "expandedChange"; "afterExpand": "afterExpand"; "afterCollapse": "afterCollapse"; "destroyed": "destroyed"; "widgetEvent": "widgetEvent"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisExpansion, "praxis-expansion", never, { "config": { "alias": "config"; "required": false; }; "expansionId": { "alias": "expansionId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "configPersistenceStrategy": { "alias": "configPersistenceStrategy"; "required": false; "isSignal": true; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "defaultOptions": { "alias": "defaultOptions"; "required": false; }; }, { "opened": "opened"; "closed": "closed"; "expandedChange": "expandedChange"; "afterExpand": "afterExpand"; "afterCollapse": "afterCollapse"; "destroyed": "destroyed"; "widgetEvent": "widgetEvent"; }, never, never, true, never>;
 }
 declare class PraxisExpansionConfigEditor implements SettingsValueProvider, OnChanges {
     config: ExpansionMetadata | null | undefined;