@praxisui/settings-panel 9.0.66 → 9.0.68-rc.0

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@praxisui/settings-panel",
-  "version": "9.0.66",
+  "version": "9.0.68-rc.0",
   "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.66",
-    "@praxisui/core": "^9.0.66",
-    "@praxisui/dynamic-fields": "^9.0.66",
+    "@praxisui/ai": "^9.0.68-rc.0",
+    "@praxisui/core": "^9.0.68-rc.0",
+    "@praxisui/dynamic-fields": "^9.0.68-rc.0",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

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

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { Type, Injector, ComponentRef, Provider, OnDestroy, ChangeDetectorRef, ElementRef, InjectionToken, OnInit, AfterViewInit, ViewContainerRef } from '@angular/core';
+import { DestroyRef, Type, Injector, ComponentRef, Provider, OnDestroy, ChangeDetectorRef, ElementRef, InjectionToken, OnInit, AfterViewInit, ViewContainerRef } from '@angular/core';
 import * as rxjs from 'rxjs';
 import { Observable, BehaviorSubject } from 'rxjs';
 import { OverlayRef, Overlay, OverlayContainer } from '@angular/cdk/overlay';
@@ -9,10 +9,14 @@ import { MatSnackBar } from '@angular/material/snack-bar';
 import { AiProviderCatalogItem } from '@praxisui/ai';
 
 interface SettingsPanelConfig {
+    /** Transient owner lifetime; never persisted or forwarded to editor inputs. */
+    owner?: DestroyRef;
     id: string;
     title?: string;
     /** Optional Material icon name to display in header before the title */
     titleIcon?: string;
+    /** Ephemeral target for a read-only look at the live result; never persisted. */
+    previewTarget?: () => HTMLElement | null;
     /** Optional initial expanded state */
     expanded?: boolean;
     resizable?: boolean;
@@ -20,9 +24,10 @@ interface SettingsPanelConfig {
     minWidth?: string;
     maxWidth?: string;
     diagnostics?: SettingsPanelDiagnosticsConfig;
+    /** Lazy inputs run once after close mediation accepts this opening. */
     content: {
         component: Type<any>;
-        inputs?: Record<string, any>;
+        inputs?: Record<string, any> | (() => Record<string, any>);
     };
 }
 interface SettingsPanelDiagnosticsConfig {
@@ -45,9 +50,12 @@ interface SettingsValueProvider {
      * Reseta as configurações para o estado inicial
      */
     reset?(): void;
+    /** Acknowledge a value accepted by the document owner, not merely emitted by Apply. */
+    acceptAppliedValue?(value: unknown): void;
     /**
      * Observable que indica se há alterações não salvas.
-     * Controla a habilitação dos botões Salvar e Aplicar.
+     * Habilita Aplicar e Salvar. Após Aplicar, o painel também permite Salvar
+     * mesmo se o editor limpar o rascunho, respeitando validade e estado ocupado.
      */
     isDirty$: Observable<boolean>;
     /**
@@ -141,6 +149,8 @@ declare class SettingsPanelRef {
     updateSize(width: string | number, options?: {
         persist?: boolean;
     }): void;
+    /** Temporary presentation only: does not save or overwrite persisted panel width. */
+    setPreviewing(previewing: boolean): void;
     close(reason?: SettingsPanelCloseReason): void;
     private complete;
 }
@@ -164,6 +174,7 @@ declare class DeferredSettingsPanelRef {
     save(value: any): void;
     reset(): void;
     bindSizePersistor(_fn: (width: string) => void): void;
+    setPreviewing(previewing: boolean): void;
     updateSize(width: string | number, options?: {
         persist?: boolean;
     }): void;
@@ -337,13 +348,16 @@ declare class SettingsPanelService {
     private currentScope?;
     private currentContentParentInjector?;
     private childSequence;
+    private openingRevision;
+    private readonly closedPanels;
+    private readonly panelParents;
     private readonly i18n;
     private readonly layerScale;
     constructor(baseSidePanelService: BaseSidePanelService, injector: Injector);
     /**
      * Opens a new settings panel. If another panel is already open it will be
-     * closed before the new one is created. Future improvements may reuse the
-     * same overlay when the provided id matches.
+     * mediated before the new content is created. Replacing a child preserves
+     * its parent and overlay scope.
      */
     open(config: SettingsPanelConfig, contentParentInjector?: Injector): SettingsPanelRef;
     /**
@@ -352,6 +366,7 @@ declare class SettingsPanelService {
      */
     openChild(config: SettingsPanelConfig, contentParentInjector?: Injector): SettingsPanelRef;
     private openFresh;
+    private cancelledOpen;
     close(reason?: SettingsPanelCloseReason): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SettingsPanelService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SettingsPanelService>;
@@ -433,6 +448,15 @@ declare class SettingsPanelComponent {
     persistSizeKey?: string;
     expanded: boolean;
     interactionActive: boolean;
+    previewTarget?: () => HTMLElement | null;
+    previewing: boolean;
+    private previewElement;
+    private previewScroll;
+    private previewFocus;
+    private readonly renderer;
+    private suspendedFocus;
+    private readonly interactivityChecker;
+    private focusTrap?;
     ref: SettingsPanelRef;
     contentRef?: ComponentRef<any>;
     private static nextId;
@@ -442,6 +466,7 @@ declare class SettingsPanelComponent {
     isBusy: boolean;
     diagnostics: Required<SettingsPanelDiagnosticsConfig>;
     private lastSavedAt;
+    private hasAppliedChanges;
     private activePointerId;
     private dragStartX;
     private dragStartWidth;
@@ -452,6 +477,10 @@ declare class SettingsPanelComponent {
     readonly saveActionLabel: string;
     private contentHost;
     constructor(cdr: ChangeDetectorRef, dialog: MatDialog, elementRef: ElementRef<HTMLElement>, overlayContainer: OverlayContainer);
+    get canInspectPreview(): boolean;
+    showPreview(): void;
+    returnFromPreview(): void;
+    private restorePreviewPage;
     get canApply(): boolean;
     get panelInlineStyles(): Record<string, string | null>;
     get showResizeHandle(): boolean;
@@ -462,7 +491,7 @@ declare class SettingsPanelComponent {
     get applySaveDisabledReason(): string;
     get showStatusMessage(): boolean;
     get showBusyIndicator(): boolean;
-    get statusTone(): 'busy' | 'dirty' | 'invalid' | 'saved' | 'idle';
+    get statusTone(): 'busy' | 'dirty' | 'invalid' | 'applied' | 'saved' | 'idle';
     get statusMessage(): string;
     tx(text: string, params?: Record<string, string | number | boolean | null | undefined>): string;
     actionLabel(text: string): string;