@testgorilla/tgo-ui 11.16.0 → 11.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testgorilla/tgo-ui",
-  "version": "11.16.0",
+  "version": "11.18.0",
   "license": "proprietary-license",
   "lint-staged": {
     "{projects,components}/**/*.ts": [
@@ -15,16 +15,16 @@
     "tslib": "~2.4.0"
   },
   "peerDependencies": {
-    "@angular/animations": "~21.2.18",
+    "@angular/animations": "~21.2.23",
     "@angular/cdk": "~21.2.14",
-    "@angular/common": "~21.2.18",
-    "@angular/compiler": "~21.2.18",
-    "@angular/core": "~21.2.18",
-    "@angular/forms": "~21.2.18",
+    "@angular/common": "~21.2.23",
+    "@angular/compiler": "~21.2.23",
+    "@angular/core": "~21.2.23",
+    "@angular/forms": "~21.2.23",
     "@angular/material": "~21.2.14",
-    "@angular/platform-browser": "~21.2.18",
-    "@angular/platform-browser-dynamic": "~21.2.18",
-    "@angular/router": "~21.2.18",
+    "@angular/platform-browser": "~21.2.23",
+    "@angular/platform-browser-dynamic": "~21.2.23",
+    "@angular/router": "~21.2.23",
     "chart.js": "^4.4.5",
     "chartjs-plugin-datalabels": "^2.2.0",
     "gaussian": "^1.3.0",

package/types/testgorilla-tgo-ui-components-side-panel.d.ts

@@ -1,6 +1,6 @@
 import * as _testgorilla_tgo_ui_components_core from '@testgorilla/tgo-ui/components/core';
 import * as _angular_core from '@angular/core';
-import { InjectionToken, ViewContainerRef, ElementRef, Type, TemplateRef, Injector } from '@angular/core';
+import { InjectionToken, Signal, TemplateRef, OutputEmitterRef, ViewContainerRef, ElementRef, Type, Injector } from '@angular/core';
 import { Observable } from 'rxjs';
 import * as _angular_animations from '@angular/animations';
 
@@ -12,6 +12,19 @@ declare enum SidePanelAnimationState {
     ClosedLeft = "closedLeft"
 }
 type SidePanelSize = 'small' | 'large' | 'x-large';
+/**
+ * What a `ui-side-panel-view` registers with the surrounding `SidePanelComponent`. The panel
+ * types its registration against this rather than importing the view component, which keeps
+ * the two files free of a runtime import cycle. `undefined` means "falls back to the config".
+ */
+interface SidePanelViewRef {
+    readonly title: Signal<string | undefined>;
+    readonly showBackButton: Signal<boolean | undefined>;
+    readonly footerTemplate: Signal<TemplateRef<unknown> | null>;
+    readonly footerDivider: Signal<boolean>;
+    readonly fillHeight: Signal<boolean>;
+    readonly back: OutputEmitterRef<void>;
+}
 declare class SidePanelConfig {
     title: string;
     position: SidePanelPosition;
@@ -51,6 +64,8 @@ declare class SidePanelRef<T = any, R = any> {
 }
 
 declare class SidePanelComponent {
+    private readonly sidePanelService;
+    sidePanelConfig: SidePanelConfig;
     sidePanelPosition: _angular_core.WritableSignal<SidePanelPosition>;
     sidePanelContainer: _angular_core.Signal<ViewContainerRef>;
     sidePanel: _angular_core.Signal<ElementRef<HTMLDivElement>>;
@@ -61,18 +76,67 @@ declare class SidePanelComponent {
     isSmall: _angular_core.Signal<boolean>;
     isLarge: _angular_core.Signal<boolean>;
     isXLarge: _angular_core.Signal<boolean>;
+    private readonly activeView;
+    protected readonly headerTitle: _angular_core.Signal<string>;
+    protected readonly showBackButton: _angular_core.Signal<boolean>;
+    protected readonly footerTemplate: _angular_core.Signal<_angular_core.TemplateRef<unknown> | null>;
+    /** A view owns the back button only when it asked for one; otherwise the config did. */
+    private readonly viewOwnsBackButton;
+    protected readonly footerDivider: _angular_core.Signal<boolean>;
+    protected readonly fillHeight: _angular_core.Signal<boolean>;
     animation: _angular_core.Signal<SidePanelAnimationState.Open | SidePanelAnimationState.ClosedRight | SidePanelAnimationState.ClosedLeft>;
-    private readonly sidePanelService;
-    sidePanelConfig: SidePanelConfig;
     protected readonly closeButtonTestId: string | null;
     protected readonly backButtonTestId: string | null;
     constructor();
+    /** The last view to register wins, so a control-flow swap in either order ends up correct. */
+    registerView(view: SidePanelViewRef): void;
+    /** Guarded by identity so a view destroyed after its successor was created cannot unseat it. */
+    unregisterView(view: SidePanelViewRef): void;
+    /**
+     * The action follows whoever asked for the button, so that a consumer who leaves the flag in the
+     * config and adopts a view for its footer gets the old close behaviour rather than a dead button.
+     */
+    protected onBack(): void;
     open(): void;
     close(result?: unknown): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidePanelComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidePanelComponent, "ui-side-panel", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * One view inside a side panel: its body, its header title and its footer. Render a different
+ * one per step to switch views without reopening the panel.
+ */
+declare class SidePanelViewComponent implements SidePanelViewRef {
+    /** Left unset, the panel keeps the title from `SidePanelConfig`. */
+    readonly title: _angular_core.InputSignal<string | undefined>;
+    /** Left unset, the panel falls back to `SidePanelConfig.showBackButton`. */
+    readonly showBackButton: _angular_core.InputSignalWithTransform<boolean | undefined, unknown>;
+    /** Draws a rule above the footer, separating it from content that scrolls underneath. */
+    readonly footerDivider: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Makes the view fill the panel body instead of growing with its content, and stops the panel
+     * scrolling. Content then owns its own overflow — give the element that should scroll
+     * `flex: 1; min-height: 0; overflow: auto`, or `height: 100%`.
+     */
+    readonly fillHeight: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** The panel does not close itself — move to the previous view, or close it yourself. */
+    readonly back: _angular_core.OutputEmitterRef<void>;
+    private readonly footer;
+    readonly footerTemplate: _angular_core.Signal<_angular_core.TemplateRef<unknown> | null>;
+    private readonly panel;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidePanelViewComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidePanelViewComponent, "ui-side-panel-view", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "showBackButton": { "alias": "showBackButton"; "required": false; "isSignal": true; }; "footerDivider": { "alias": "footerDivider"; "required": false; "isSignal": true; }; "fillHeight": { "alias": "fillHeight"; "required": false; "isSignal": true; }; }, { "back": "back"; }, ["footer"], ["*"], true, never>;
+}
+
+/** Marks the `ng-template` inside a `ui-side-panel-view` that holds the view's footer. */
+declare class SidePanelFooterDirective {
+    readonly templateRef: TemplateRef<unknown>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidePanelFooterDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SidePanelFooterDirective, "ng-template[uiSidePanelFooter]", never, {}, {}, never, never, true, never>;
+}
+
 declare class SidePanelService {
     private SidePanelComponentRef?;
     private contentComponentRef?;
@@ -99,5 +163,5 @@ declare const backdropAnimation: _angular_animations.AnimationTriggerMetadata[];
 
 declare const SIDE_PANEL_DATA: InjectionToken<unknown>;
 
-export { SIDE_PANEL_CONFIG, SIDE_PANEL_DATA, SidePanelAnimationState, SidePanelComponent, SidePanelConfig, SidePanelRef, SidePanelService, backdropAnimation, defaultSidePanelConfig, sidePanelAnimation, sidePanelAnimationDuration };
-export type { SidePanelPosition, SidePanelSize };
+export { SIDE_PANEL_CONFIG, SIDE_PANEL_DATA, SidePanelAnimationState, SidePanelComponent, SidePanelConfig, SidePanelFooterDirective, SidePanelRef, SidePanelService, SidePanelViewComponent, backdropAnimation, defaultSidePanelConfig, sidePanelAnimation, sidePanelAnimationDuration };
+export type { SidePanelPosition, SidePanelSize, SidePanelViewRef };