@praxisui/settings-panel 9.0.5-rc.37 → 9.0.5-rc.38

package/README.md

@@ -49,6 +49,9 @@ export class SettingsContentComponent implements SettingsValueProvider {
 
 Open this standalone content with `SettingsPanelService.open(...)`; the host
 observes `SettingsPanelRef.applied$` and `saved$` to apply or persist changes.
+When that content needs to open a subordinate authoring editor, use
+`SettingsPanelService.openChild(...)`. The child receives its own lifecycle
+while the parent panel and its unsaved draft remain mounted.
 
 Peer dependencies (Angular v21):
 
@@ -80,6 +83,7 @@ Peer dependencies (Angular v21):
 - `expanded: true` abre o painel ja expandido de forma efetiva, respeitando `maxWidth`.
 - Expandir temporariamente o painel nao substitui a preferencia persistida do usuario; apenas o resize manual continua sendo persistido.
 - Quando um editor autoral tentar abrir outro painel sobre o atual, o shell passa pela mesma mediacao de fechamento do proprio painel. Se `onBeforeClose` vetar o fechamento, a substituicao nao acontece.
+- Para composicao intencional de editores, use `openChild(...)`: o painel filho fica acima do pai e, ao fechar, devolve o controle ao draft pai sem emitir fechamento ou descarte nele.
 
 ### 2. Drawer runtime
 

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-19T01:49:06.767Z",
+  "generatedAt": "2026-08-19T02:54:26.311Z",
   "packageName": "@praxisui/settings-panel",
-  "packageVersion": "9.0.5-rc.37",
+  "packageVersion": "9.0.5-rc.38",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,

package/fesm2022/praxisui-settings-panel.mjs

@@ -1696,6 +1696,8 @@ class SettingsPanelService {
     injector;
     currentRef;
     currentPanelInstance;
+    currentScope;
+    childSequence = 0;
     i18n = inject(PraxisI18nService);
     layerScale = inject(PraxisLayerScaleStyleService);
     constructor(baseSidePanelService, injector) {
@@ -1727,13 +1729,29 @@ class SettingsPanelService {
         }
         return this.openFresh(config);
     }
-    openFresh(config) {
+    /**
+     * Opens an authoring editor above the current settings panel without
+     * destroying the parent editor and its draft state.
+     */
+    openChild(config) {
+        if (!this.currentRef || !this.currentPanelInstance) {
+            return this.openFresh(config);
+        }
+        const parent = {
+            ref: this.currentRef,
+            panel: this.currentPanelInstance,
+            scope: this.currentScope ?? 'settings-panel',
+        };
+        const scope = `settings-panel-child-${++this.childSequence}`;
+        return this.openFresh(config, scope, parent);
+    }
+    openFresh(config, scope = 'settings-panel', parent) {
         this.layerScale.ensureInstalled();
         const ref = this.baseSidePanelService.openHost({
             component: SettingsPanelComponent,
             config: {
                 id: config.id,
-                scope: 'settings-panel',
+                scope,
                 title: config.title,
                 titleIcon: config.titleIcon,
                 width: '720px',
@@ -1774,6 +1792,7 @@ class SettingsPanelService {
                 });
                 panelRef.instance.configureDiagnostics(config.diagnostics);
                 this.currentPanelInstance = panelRef.instance;
+                this.currentScope = scope;
                 const inputs = config.content.inputs;
                 const injector = Injector.create({
                     providers: [
@@ -1791,17 +1810,16 @@ class SettingsPanelService {
         });
         ref.closed$.subscribe(() => {
             if (this.currentRef === ref) {
-                this.currentRef = undefined;
-                this.currentPanelInstance = undefined;
+                this.currentRef = parent?.ref;
+                this.currentPanelInstance = parent?.panel;
+                this.currentScope = parent?.scope;
             }
         });
         this.currentRef = ref;
         return ref;
     }
     close(reason = 'cancel') {
-        this.baseSidePanelService.closeScope('settings-panel', reason);
-        this.currentRef = undefined;
-        this.currentPanelInstance = undefined;
+        this.currentRef?.close(reason);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: SettingsPanelService, deps: [{ token: BaseSidePanelService }, { token: i0.Injector }], target: i0.ɵɵFactoryTarget.Injectable });
     static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: SettingsPanelService, providedIn: 'root' });

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@praxisui/settings-panel",
-  "version": "9.0.5-rc.37",
+  "version": "9.0.5-rc.38",
   "description": "Settings panel for Praxis UI libraries: open editors for configuration at runtime and persist settings.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
     "@angular/cdk": "^21.0.0",
     "@angular/material": "^21.0.0",
-    "@praxisui/ai": "^9.0.5-rc.37",
-    "@praxisui/core": "^9.0.5-rc.37",
-    "@praxisui/dynamic-fields": "^9.0.5-rc.37",
+    "@praxisui/ai": "^9.0.5-rc.38",
+    "@praxisui/core": "^9.0.5-rc.38",
+    "@praxisui/dynamic-fields": "^9.0.5-rc.38",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-settings-panel.d.ts

@@ -334,6 +334,8 @@ declare class SettingsPanelService {
     private injector;
     private currentRef?;
     private currentPanelInstance?;
+    private currentScope?;
+    private childSequence;
     private readonly i18n;
     private readonly layerScale;
     constructor(baseSidePanelService: BaseSidePanelService, injector: Injector);
@@ -343,6 +345,11 @@ declare class SettingsPanelService {
      * same overlay when the provided id matches.
      */
     open(config: SettingsPanelConfig): SettingsPanelRef;
+    /**
+     * Opens an authoring editor above the current settings panel without
+     * destroying the parent editor and its draft state.
+     */
+    openChild(config: SettingsPanelConfig): SettingsPanelRef;
     private openFresh;
     close(reason?: SettingsPanelCloseReason): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SettingsPanelService, never>;