@koobiq/components 20.4.2 → 21.0.1

package/{accordion/index.d.ts → types/koobiq-components-accordion.d.ts}

@@ -1,55 +1,12 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, AfterViewInit, OnDestroy, OnInit, ChangeDetectorRef, AfterContentInit, ElementRef, Signal, DoCheck } from '@angular/core';
+import { AfterViewInit, OnDestroy, OnChanges, OnInit, SimpleChanges, AfterContentInit, AfterContentChecked, ElementRef, Signal, DoCheck } from '@angular/core';
 import { FocusMonitor, FocusKeyManager } from '@angular/cdk/a11y';
 import { Directionality } from '@angular/cdk/bidi';
 import { UniqueSelectionDispatcher } from '@angular/cdk/collections';
 import { Subject } from 'rxjs';
-import * as i1 from '@koobiq/components/icon';
+import * as i1$1 from '@koobiq/components/icon';
 import { KbqIcon } from '@koobiq/components/icon';
-
-/** A snapshot of a single accordion item's persisted state. */
-interface KbqAccordionItemSnapshot {
-    /** Whether the item is expanded. */
-    expanded: boolean;
-    /** The item's value. */
-    value: string;
-}
-/** The persisted state of an accordion, keyed by accordion item id. */
-interface KbqAccordionState {
-    [itemId: string]: KbqAccordionItemSnapshot;
-}
-/**
- * Strategy used by `KbqAccordion` to persist and restore the expanded state of its items
- * while `useStateSaving` is enabled.
- *
- * Provide a custom implementation through the `KBQ_ACCORDION_STATE_STORE` token to change
- * where the state is stored (e.g. `sessionStorage`, a backend, or an in-memory map).
- */
-interface KbqAccordionStateStore {
-    /** Returns the previously saved state for the given key, or `null` when nothing is stored/available. */
-    getState(key: string): KbqAccordionState | null;
-    /** Persists the state for the given key. */
-    setState(key: string, state: KbqAccordionState): void;
-}
-/**
- * Default `KbqAccordionStateStore` implementation backed by `localStorage`.
- *
- * All access is guarded so it is safe on the server (SSR) and in environments where storage
- * throws on access (private mode, sandboxed iframes) or contains corrupt JSON.
- */
-declare class KbqAccordionLocalStorageStateStore implements KbqAccordionStateStore {
-    private readonly isBrowser;
-    private readonly window;
-    getState(key: string): KbqAccordionState | null;
-    setState(key: string, state: KbqAccordionState): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqAccordionLocalStorageStateStore, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<KbqAccordionLocalStorageStateStore>;
-}
-/**
- * Injection token for the store used to persist accordion state while `useStateSaving` is enabled.
- * Defaults to a `localStorage`-backed implementation (`KbqAccordionLocalStorageStateStore`).
- */
-declare const KBQ_ACCORDION_STATE_STORE: InjectionToken<KbqAccordionStateStore>;
+import * as i1 from '@koobiq/components/core';
 
 declare class KbqAccordionTriggerDirective {
     /** @docs-private */
@@ -67,6 +24,7 @@ declare class KbqAccordionTriggerDirective {
     /**
      * Keeps the accordion's key manager in sync with native focus so that arrow-key navigation
      * continues from the header the user has just tabbed/focused into.
+     *
      * @docs-private
      */
     onFocus(): void;
@@ -88,11 +46,15 @@ declare class KbqAccordionTriggerDirective {
 declare class KbqAccordionTrigger implements AfterViewInit, OnDestroy {
     private readonly platform;
     /** @docs-private */
-    protected readonly nativeElement: HTMLElement;
-    /** @docs-private */
     protected readonly accordion: KbqAccordion;
     /** @docs-private */
     readonly icon: _angular_core.Signal<KbqIcon>;
+    /**
+     * Whether the icon turns without motion.
+     *
+     * @docs-private
+     */
+    protected readonly animationsDisabled: boolean;
     private savedTransition;
     private readonly afterRenderRef?;
     private animationTimerId?;
@@ -109,15 +71,13 @@ declare class KbqAccordionTrigger implements AfterViewInit, OnDestroy {
 }
 
 type KbqAccordionItemState = 'open' | 'closed';
-declare class KbqAccordionItem implements OnInit, OnDestroy {
+declare class KbqAccordionItem implements OnChanges, OnInit, OnDestroy {
     /**
      * The accordion this item belongs to — always the nearest one, because it is injected.
      * The accordion reads it back to tell its own items apart from a nested accordion's.
      */
     readonly accordion: KbqAccordion;
     /** @docs-private */
-    protected readonly changeDetectorRef: ChangeDetectorRef;
-    /** @docs-private */
     protected readonly expansionDispatcher: UniqueSelectionDispatcher;
     /** @docs-private */
     readonly trigger: _angular_core.Signal<KbqAccordionTriggerDirective | undefined>;
@@ -138,15 +98,32 @@ declare class KbqAccordionItem implements OnInit, OnDestroy {
      */
     get expanded(): boolean;
     set expanded(expanded: boolean);
-    private _expanded;
+    /** Body of the `expanded` setter. */
+    private setExpanded;
+    /**
+     * Follows the binding at once, a static `expanded` included, while the view is created: every item of a
+     * single-mode accordion holds its bound state before the first of them reports in `ngOnInit` and collapses
+     * the others.
+     */
+    private readonly expandedState;
+    /** The state the item last reported, so a binding change that the state already follows is reported once. */
+    private reportedExpanded;
     private initialized;
     /**
      * The item's own `value` input. Must stay `public`: a `protected` input cannot be bound from a
      * consumer template (TS2445 under full AOT template type-checking).
+     *
      * @docs-private
      */
     readonly valueInput: _angular_core.InputSignal<string>;
-    /** The item's effective value — its own value, or the item id when none is provided. */
+    /**
+     * The item's effective value — its own `value`, or its position inside the accordion when none is
+     * provided.
+     *
+     * The position, rather than the id: the value is what the accordion persists, and the id carries a
+     * global instantiation counter that shifts as soon as anything else on the page is created ahead of
+     * this accordion. The prefix keeps a generated value from colliding with an author-written one.
+     */
     readonly value: _angular_core.Signal<string>;
     /** Whether the AccordionItem is disabled. */
     get disabled(): boolean;
@@ -159,6 +136,7 @@ declare class KbqAccordionItem implements OnInit, OnDestroy {
     /**
      * Emits whenever the expanded state of the accordion item changes.
      * Primarily used to facilitate two-way binding.
+     *
      * @docs-private
      */
     readonly expandedChange: _angular_core.OutputEmitterRef<boolean>;
@@ -166,6 +144,11 @@ declare class KbqAccordionItem implements OnInit, OnDestroy {
     private removeUniqueSelectionListener;
     /** Subscription to openAll/closeAll events. */
     private openCloseAllSubscription;
+    /** @docs-private */
+    readonly expandedInput: _angular_core.InputSignalWithTransform<boolean | undefined, string | boolean | null | undefined>;
+    /** @docs-private */
+    readonly disabledInput: _angular_core.InputSignalWithTransform<boolean | undefined, string | boolean | null | undefined>;
+    ngOnChanges(changes: SimpleChanges): void;
     constructor();
     ngOnInit(): void;
     ngOnDestroy(): void;
@@ -177,8 +160,6 @@ declare class KbqAccordionItem implements OnInit, OnDestroy {
     close(): void;
     /** Sets the expanded state of the accordion item to true. */
     open(): void;
-    /** Returns a snapshot of the item's current persisted state. @docs-private */
-    getState(): KbqAccordionItemSnapshot;
     /** Disables the open/close animation of the item's content and chevron. @docs-private */
     disableAnimation(): void;
     /** Restores the open/close animation of the item's content and chevron. @docs-private */
@@ -187,9 +168,7 @@ declare class KbqAccordionItem implements OnInit, OnDestroy {
     private reportExpanded;
     private subscribeToOpenCloseAllActions;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqAccordionItem, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqAccordionItem, "kbq-accordion-item, [kbq-accordion-item]", never, { "expanded": { "alias": "expanded"; "required": false; }; "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "closed": "closed"; "opened": "opened"; "expandedChange": "expandedChange"; }, ["trigger", "triggerComponent", "content"], never, true, never>;
-    static ngAcceptInputType_expanded: unknown;
-    static ngAcceptInputType_disabled: unknown;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqAccordionItem, "kbq-accordion-item, [kbq-accordion-item]", never, { "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; "expandedInput": { "alias": "expanded"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "closed": "closed"; "opened": "opened"; "expandedChange": "expandedChange"; }, ["trigger", "triggerComponent", "content"], never, true, never>;
 }
 
 /** Available visual variants of the accordion. */
@@ -198,19 +177,21 @@ type KbqAccordionVariant = 'fill' | 'hug' | 'hugSpaceBetween';
 type KbqAccordionType = 'single' | 'multiple';
 /** The layout orientation of the accordion. */
 type KbqAccordionOrientation = 'horizontal' | 'vertical';
-declare class KbqAccordion implements OnDestroy, AfterViewInit, AfterContentInit {
+/**
+ * The persisted state of an accordion — the values of the items that were expanded.
+ * Mirrors `KbqAccordion.value` normalized to an array.
+ */
+type KbqAccordionState = string[];
+declare class KbqAccordion implements OnDestroy, AfterViewInit, AfterContentInit, AfterContentChecked {
     /** @docs-private */
     protected readonly focusMonitor: FocusMonitor;
     /** @docs-private */
     protected readonly elementRef: ElementRef<any>;
     /** @docs-private */
-    protected readonly changeDetectorRef: ChangeDetectorRef;
-    /** @docs-private */
     protected readonly selectionDispatcher: UniqueSelectionDispatcher;
     /** @docs-private */
     protected readonly dir: Directionality | null;
     private readonly injector;
-    private readonly stateStore;
     /** @docs-private */
     protected keyManager: FocusKeyManager<KbqAccordionItem>;
     /** Emits every time `openAll()` or `closeAll()` is called. @docs-private */
@@ -218,6 +199,7 @@ declare class KbqAccordion implements OnDestroy, AfterViewInit, AfterContentInit
     /**
      * Every item the content query matches, including those of a nested accordion.
      * Use `items` instead — this one is the raw, unfiltered query.
+     *
      * @docs-private
      */
     protected readonly allItems: Signal<readonly KbqAccordionItem[]>;
@@ -230,17 +212,15 @@ declare class KbqAccordion implements OnDestroy, AfterViewInit, AfterContentInit
      * injected and therefore always its nearest one, which makes ownership the reliable filter.
      * Without it the key manager would move focus into the nested accordion's headers, `valueChange`
      * would report a nested item's value and state saving would persist it under the outer key.
+     *
      * @docs-private
      */
     readonly items: Signal<readonly KbqAccordionItem[]>;
-    /** Whether the accordion persists the expanded state of its items across reloads. Defaults to `false`. */
-    readonly useStateSaving: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
-     * A stable, consumer-provided key used to persist state when `useStateSaving` is enabled.
-     * Strongly recommended: without it the accordion falls back to an auto-generated,
-     * instantiation-order-dependent id that is unreliable under lazy/conditional/reordered rendering.
+     * Persistence of the expanded state, applied as a host directive. `useStateSaving` and
+     * `stateSavingKey` are its inputs, forwarded onto the accordion.
      */
-    readonly stateSavingKey: _angular_core.InputSignal<string>;
+    private readonly stateSaving;
     /** The visual variant of the accordion. Defaults to `fill`. */
     readonly variant: _angular_core.InputSignal<KbqAccordionVariant>;
     /** Whether the whole accordion is disabled. */
@@ -264,6 +244,7 @@ declare class KbqAccordion implements OnDestroy, AfterViewInit, AfterContentInit
     /**
      * The raw controlled `value` input. Must stay `public`: a `protected` input cannot be bound from
      * a consumer template (TS2445 under full AOT template type-checking).
+     *
      * @docs-private
      */
     readonly valueInput: _angular_core.InputSignal<string | string[] | undefined>;
@@ -281,19 +262,22 @@ declare class KbqAccordion implements OnDestroy, AfterViewInit, AfterContentInit
     get id(): string;
     /** Whether multiple items can be expanded at the same time. */
     get isMultiple(): boolean;
-    /** Whether a persisted state exists for this accordion. */
+    /**
+     * Whether state is currently persisted for this accordion — restored on init, or written since.
+     * Always `false` while `useStateSaving` is unset, and `false` again after `clearSavedState()`.
+     */
     get hasSavedState(): boolean;
-    /** `defaultValue` normalized to an array for internal coordination. */
-    private readonly defaultValueArray;
-    private _id;
-    private state;
     /**
-     * Whether the saved state has been read. An item reports a static `[expanded]` from its own `ngOnInit`,
-     * which runs before `ngAfterContentInit`, and writing then would replace the saved state before it is read.
+     * `value()` as an array, reshaped by mode — the shape the selection dispatcher is notified with.
+     * Falls back to `defaultValue` while `value` is unbound, so it doubles as the uncontrolled default.
      */
-    private stateRestored;
+    private readonly valueArray;
+    private _id;
+    /** Whether the state saving key changed and the state under the new key is still to be restored. */
+    private keyChanged;
     constructor();
     ngAfterContentInit(): void;
+    ngAfterContentChecked(): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     /**
@@ -303,6 +287,7 @@ declare class KbqAccordion implements OnDestroy, AfterViewInit, AfterContentInit
      * also receives keys bubbling from the section content and from controls placed next to the
      * trigger, and would swallow their Enter/Space and hijack their arrow keys. It would also
      * activate the first item — stealing focus — the first time any key was pressed anywhere inside.
+     *
      * @docs-private
      */
     keydownHandler(event: KeyboardEvent): void;
@@ -312,17 +297,43 @@ declare class KbqAccordion implements OnDestroy, AfterViewInit, AfterContentInit
     closeAll(): void;
     /** @docs-private */
     setActiveItem(item: KbqAccordionItem): void;
+    /** Reads the persisted state and applies it. Runs while initializing, and again after the key changes. */
+    private restoreState;
     /**
-     * Persists the current state of the given item when `useStateSaving` is enabled.
+     * Persists the values of the currently expanded items when `useStateSaving` is enabled.
+     *
      * @docs-private
      */
-    saveItemState(item: KbqAccordionItem, force?: boolean): void;
+    saveState(): void;
+    /**
+     * Removes the state persisted for this accordion.
+     *
+     * Persistence itself stays on — the next change is written again. Unset `useStateSaving` to stop it.
+     */
+    clearSavedState(): void;
+    /**
+     * The values to expand when restoring: a controlled `value` wins, then the persisted state, then — only
+     * while initializing — `defaultValue`. An array, because only the array payload can also *close* the items
+     * that are not part of it — a scalar cannot express an empty selection at all.
+     *
+     * `null` when there is nothing to apply, so the items keep their current `expanded`: their own while
+     * initializing, whatever the previous key left after a key change.
+     */
+    private initialValue;
+    /** The values of the items that are currently expanded. */
+    private expandedValues;
     /** The current expanded value(s) derived from the live item state. */
     private getCurrentValue;
-    /** The key used to persist/restore state. */
-    private get stateStorageKey();
+    /**
+     * Notifies the items of the whole expanded set.
+     *
+     * `UniqueSelectionDispatcher` types its payload as a `string`, which only an individual item toggle
+     * ever is — the accordion always sends the full set, the only shape that also closes the items
+     * outside it. The cast lives here alone so the rest of the component keeps working with the real type.
+     */
+    private notifySelection;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqAccordion, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqAccordion, "kbq-accordion, [kbq-accordion]", never, { "useStateSaving": { "alias": "useStateSaving"; "required": false; "isSignal": true; }; "stateSavingKey": { "alias": "stateSavingKey"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "level": { "alias": "level"; "required": false; "isSignal": true; }; "defaultValue": { "alias": "defaultValue"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, ["allItems"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqAccordion, "kbq-accordion, [kbq-accordion]", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "level": { "alias": "level"; "required": false; "isSignal": true; }; "defaultValue": { "alias": "defaultValue"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, ["allItems"], ["*"], true, [{ directive: typeof i1.KbqStateSaving; inputs: { "useStateSaving": "useStateSaving"; "stateSavingKey": "stateSavingKey"; }; outputs: {}; }]>;
 }
 
 declare class KbqAccordionContentDirective implements OnInit, DoCheck, AfterViewInit {
@@ -371,6 +382,12 @@ declare class KbqAccordionContentDirective implements OnInit, DoCheck, AfterView
 }
 
 declare class KbqAccordionContent {
+    /**
+     * Whether the content expands and collapses without motion.
+     *
+     * @docs-private
+     */
+    protected readonly animationsDisabled: boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqAccordionContent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqAccordionContent, "kbq-accordion-content, [kbq-accordion-content]", never, {}, {}, never, ["*"], true, [{ directive: typeof KbqAccordionContentDirective; inputs: {}; outputs: {}; }]>;
 }
@@ -388,6 +405,7 @@ declare class KbqAccordionHeader {
      * announced as "Profile Run More" when navigating by heading. Pointing at the trigger yields the
      * announcement the WAI-ARIA APG gets by keeping the button the only element in the heading,
      * which this component cannot do because the header is also the row that lays the actions out.
+     *
      * @docs-private
      */
     protected get labelledBy(): string | null;
@@ -397,9 +415,9 @@ declare class KbqAccordionHeader {
 
 declare class KbqAccordionModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqAccordionModule, never>;
-    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<KbqAccordionModule, never, [typeof i1.KbqIcon, typeof KbqAccordion, typeof KbqAccordionContent, typeof KbqAccordionHeader, typeof KbqAccordionItem, typeof KbqAccordionTrigger], [typeof KbqAccordion, typeof KbqAccordionContent, typeof KbqAccordionHeader, typeof KbqAccordionItem, typeof KbqAccordionTrigger]>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<KbqAccordionModule, never, [typeof i1$1.KbqIcon, typeof KbqAccordion, typeof KbqAccordionContent, typeof KbqAccordionHeader, typeof KbqAccordionItem, typeof KbqAccordionTrigger], [typeof KbqAccordion, typeof KbqAccordionContent, typeof KbqAccordionHeader, typeof KbqAccordionItem, typeof KbqAccordionTrigger]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<KbqAccordionModule>;
 }
 
-export { KBQ_ACCORDION_STATE_STORE, KbqAccordion, KbqAccordionContent, KbqAccordionContentDirective, KbqAccordionHeader, KbqAccordionItem, KbqAccordionLocalStorageStateStore, KbqAccordionModule, KbqAccordionTrigger, KbqAccordionTriggerDirective };
-export type { KbqAccordionItemSnapshot, KbqAccordionItemState, KbqAccordionOrientation, KbqAccordionState, KbqAccordionStateStore, KbqAccordionType, KbqAccordionVariant };
+export { KbqAccordion, KbqAccordionContent, KbqAccordionContentDirective, KbqAccordionHeader, KbqAccordionItem, KbqAccordionModule, KbqAccordionTrigger, KbqAccordionTriggerDirective };
+export type { KbqAccordionItemState, KbqAccordionOrientation, KbqAccordionState, KbqAccordionType, KbqAccordionVariant };

package/{actions-panel/index.d.ts → types/koobiq-components-actions-panel.d.ts}

@@ -1,26 +1,21 @@
 import { Overlay, ScrollStrategy, OverlayRef, ComponentType } from '@angular/cdk/overlay';
 import * as i0 from '@angular/core';
-import { InjectionToken, Injector, ElementRef, Provider, OnDestroy, EventEmitter, TemplateRef } from '@angular/core';
+import { InjectionToken, Injector, ElementRef, Provider, OnDestroy, TemplateRef } from '@angular/core';
 import { Direction } from '@angular/cdk/bidi';
 import { CdkDialogContainer, DialogRef } from '@angular/cdk/dialog';
-import { Observable } from 'rxjs';
-import { AnimationEvent } from '@angular/animations';
-import { KbqActionsPanelLocaleConfiguration } from '@koobiq/components/core';
+import { Subject, Observable } from 'rxjs';
+import * as i1 from '@koobiq/components/core';
+import { KbqActionsPanelLocaleConfiguration, KbqDeepPartial } from '@koobiq/components/core';
 
 /** Injection token that can be used to specify default actions panel config. */
 declare const KBQ_ACTIONS_PANEL_DEFAULT_CONFIG: InjectionToken<KbqActionsPanelConfig<unknown>>;
 /**
- * Utility for providing default actions panel config.
- *
- * @see `KBQ_ACTIONS_PANEL_DEFAULT_CONFIG`
+ * Utility for providing default actions panel config through {@link KBQ_ACTIONS_PANEL_DEFAULT_CONFIG}.
  */
 declare const kbqActionsPanelDefaultConfigProvider: <D>(config: KbqActionsPanelConfig<D>) => Provider;
 /**
  * Configuration for opened actions panel.
  * Based on cdk `DialogConfig`.
- *
- * @see `DialogConfig`
- *
  */
 declare class KbqActionsPanelConfig<D = unknown> {
     /**
@@ -28,22 +23,26 @@ declare class KbqActionsPanelConfig<D = unknown> {
      */
     injector?: Injector;
     /**
-     * Data being injected into the child component.
-     *
-     * @see `KBQ_ACTIONS_PANEL_DATA`
+     * Data being injected into the child component with {@link KBQ_ACTIONS_PANEL_DATA}.
      */
     data?: D | null;
     /** Extra CSS classes to be added to the actions panel container. */
     containerClass?: string | string[];
     /**
      * Whether the actions panel should be closed of when the user goes backwards/forwards in history.
+     * Defaults to `true`.
      * NOTE! This does not apply to router navigation.
-     *
-     * @default true
      */
     closeOnNavigation?: boolean;
     /**
-     * Element in which the actions panel overlay will be connected to.
+     * Element the actions panel overlay is rendered into, instead of the application-wide overlay container. The panel
+     * is pinned to the bottom center of that element and resizes with it. An element that sets `overflow: hidden`
+     * clips it; at the default `overflow: visible` the entrance animation renders it below the element.
+     *
+     * The element is mutated for as long as the panel is open: it gains one child node holding the overlay, and a
+     * `static` element is promoted to `position: relative`, since the overlay is positioned against it.
+     *
+     * NOTE: the panel bypasses a globally provided `OverlayContainer` while this is set.
      */
     overlayContainer?: ElementRef<HTMLElement>;
     /**
@@ -63,34 +62,30 @@ declare class KbqActionsPanelConfig<D = unknown> {
      * Max-width of the actions panel.
      * If a number is provided, assumes pixel units.
      *
-     * NOTE: this property is ignored if the `overlayContainer` property is provided, and will be calculated based on
-     * the width of the `overlayContainer`.
+     * When omitted, the panel is capped by the width of the overlay container it is rendered into.
      */
     maxWidth?: number | string;
     /**
-     * Direction of the text in the actions panel.
-     *
-     * @default 'ltr'
+     * Direction of the text in the actions panel. Defaults to `'ltr'`.
      */
     direction?: Direction;
     /**
-     * Scroll strategy to be used for the actions panel.
-     *
-     * @default `RepositionScrollStrategy`
+     * Scroll strategy to be used for the actions panel. Defaults to `RepositionScrollStrategy`.
      */
     scrollStrategy?: (overlay: Overlay) => ScrollStrategy;
     /**
-     * Whether the user can use ESC or click on close button to close the actions panel.
-     *
-     * @default false
+     * Whether the user can use ESC or click on close button to close the actions panel. Defaults to `false`.
      */
     disableClose?: boolean;
 }
 
 /** Localization configuration provider. */
 declare const KBQ_ACTIONS_PANEL_LOCALE_CONFIGURATION: InjectionToken<KbqActionsPanelLocaleConfiguration>;
-/** Utility provider for `KBQ_ACTIONS_PANEL_LOCALE_CONFIGURATION`. */
-declare const kbqActionsPanelLocaleConfigurationProvider: (configuration: KbqActionsPanelLocaleConfiguration) => Provider;
+/**
+ * Utility provider for `KBQ_ACTIONS_PANEL_LOCALE_CONFIGURATION`. Only the strings you pass are
+ * overridden; the rest keep following the active locale.
+ */
+declare const kbqActionsPanelLocaleConfigurationProvider: (configuration: KbqDeepPartial<KbqActionsPanelLocaleConfiguration>) => Provider;
 /**
  * Internal component that wraps user-provided actions panel content.
  *
@@ -102,13 +97,22 @@ declare class KbqActionsPanelContainer extends CdkDialogContainer implements OnD
      *
      * @docs-private
      */
-    protected animationState: 'void' | 'visible' | 'hidden';
+    protected readonly animationState: i0.WritableSignal<"void" | "visible" | "hidden">;
     /**
-     * Emits whenever the state of the animation changes.
+     * Emits the state the actions panel has finished moving to.
      *
      * @docs-private
      */
-    readonly animationStateChanged: EventEmitter<AnimationEvent>;
+    readonly animationDone: Subject<"visible" | "hidden">;
+    /**
+     * Whether the actions panel moves without motion.
+     *
+     * @docs-private
+     */
+    protected readonly animationsDisabled: boolean;
+    private readonly injector;
+    /** The transition in progress, ended early by the next one. */
+    private pendingTransition?;
     /** Whether the actions panel container has been destroyed. */
     private destroyed;
     /**
@@ -119,13 +123,12 @@ declare class KbqActionsPanelContainer extends CdkDialogContainer implements OnD
     protected readonly config: KbqActionsPanelConfig<any>;
     private readonly actionsPanel;
     private readonly renderer;
-    private readonly localeService;
     /**
      * Actions panel locale configuration.
      *
      * @docs-private
      */
-    protected readonly localeConfiguration: i0.Signal<KbqActionsPanelLocaleConfiguration | undefined>;
+    protected readonly localeConfiguration: i0.Signal<KbqActionsPanelLocaleConfiguration>;
     ngOnDestroy(): void;
     /**
      * Close the actions panel.
@@ -145,18 +148,6 @@ declare class KbqActionsPanelContainer extends CdkDialogContainer implements OnD
      * @docs-private
      */
     startCloseAnimation(): void;
-    /**
-     * Handles animation done events.
-     *
-     * @docs-private
-     */
-    protected onAnimationDone(event: AnimationEvent): void;
-    /**
-     * Handles animation start events.
-     *
-     * @docs-private
-     */
-    protected onAnimationStart(event: AnimationEvent): void;
     /**
      * Handles escape key events.
      *
@@ -167,9 +158,10 @@ declare class KbqActionsPanelContainer extends CdkDialogContainer implements OnD
      * @docs-private
      */
     protected _contentAttached(): void;
+    private waitForAnimation;
     private applyContainerClass;
     static ɵfac: i0.ɵɵFactoryDeclaration<KbqActionsPanelContainer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<KbqActionsPanelContainer, "kbq-actions-panel-container", never, {}, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<KbqActionsPanelContainer, "kbq-actions-panel-container", never, {}, {}, never, never, true, [{ directive: typeof i1.KbqLocaleOverridesDirective; inputs: {}; outputs: {}; }]>;
 }
 
 /**
@@ -190,7 +182,7 @@ declare class KbqActionsPanelRef<I = unknown, R = unknown> {
     readonly keydownEvents: Observable<KeyboardEvent>;
     /** Emits when the actions panel starts opening, before its entrance animation plays. */
     readonly beforeOpened: Observable<void>;
-    /** Emits when the actions panel has opened and appeared. */
+    /** Emits when the actions panel has opened and appeared, or once closing cuts its entrance short. */
     readonly afterOpened: Observable<void>;
     /** Emits when the actions panel starts closing, before its exit animation plays. */
     readonly beforeClosed: Observable<R | undefined>;
@@ -210,8 +202,6 @@ declare class KbqActionsPanelRef<I = unknown, R = unknown> {
     readonly id: string;
     /** Result to be passed down to the `afterClosed` stream. */
     private result;
-    /** Handle to the timeout that's running as a fallback in case the close animation doesn't fire. */
-    private closeAnimationFallbackTimeout?;
     constructor(dialogRef: DialogRef<R, I>, containerInstance: KbqActionsPanelContainer);
     /**
      * Opens the actions panel, playing its entrance animation.
@@ -264,21 +254,15 @@ type KbqActionsPanelTemplateContext<T = unknown, D = unknown, R = unknown> = {
      */
     actionsPanelRef: KbqActionsPanelRef<T, R>;
 };
-/**
- * Selector for actions panel overlay.
- *
- * @docs-private
- */
-declare const KBQ_ACTIONS_PANEL_OVERLAY_SELECTOR = "kbq-actions-panel-overlay";
 /**
  * Service for opening actions panel.
  */
 declare class KbqActionsPanel implements OnDestroy {
     private readonly injector;
+    private readonly environmentInjector;
     private readonly overlay;
     private readonly dialog;
     private readonly defaultConfig;
-    private readonly resizeObserver;
     /** The reference to the currently opened actions panel. */
     private openedActionsPanelRef;
     ngOnDestroy(): void;
@@ -301,7 +285,8 @@ declare class KbqActionsPanel implements OnDestroy {
     /** Closes the currently opened actions panel. */
     close<R>(result?: R): void;
     private openDialog;
-    private syncOverlayMaxWidth;
+    /** Injector that makes CDK render the panel's overlay inside `host` instead of `document.body`. */
+    private createScopedInjector;
     static ɵfac: i0.ɵɵFactoryDeclaration<KbqActionsPanel, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<KbqActionsPanel>;
 }
@@ -312,5 +297,5 @@ declare class KbqActionsPanelModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<KbqActionsPanelModule>;
 }
 
-export { KBQ_ACTIONS_PANEL_DATA, KBQ_ACTIONS_PANEL_DEFAULT_CONFIG, KBQ_ACTIONS_PANEL_LOCALE_CONFIGURATION, KBQ_ACTIONS_PANEL_OVERLAY_SELECTOR, KbqActionsPanel, KbqActionsPanelConfig, KbqActionsPanelContainer, KbqActionsPanelModule, KbqActionsPanelRef, kbqActionsPanelDefaultConfigProvider, kbqActionsPanelLocaleConfigurationProvider };
+export { KBQ_ACTIONS_PANEL_DATA, KBQ_ACTIONS_PANEL_DEFAULT_CONFIG, KBQ_ACTIONS_PANEL_LOCALE_CONFIGURATION, KbqActionsPanel, KbqActionsPanelConfig, KbqActionsPanelContainer, KbqActionsPanelModule, KbqActionsPanelRef, kbqActionsPanelDefaultConfigProvider, kbqActionsPanelLocaleConfigurationProvider };
 export type { KbqActionsPanelTemplateContext };

package/{alert/index.d.ts → types/koobiq-components-alert.d.ts}

@@ -47,7 +47,13 @@ declare class KbqAlert {
     protected readonly iconItem: _angular_core.Signal<KbqIconItem | undefined>;
     /** @docs-private */
     protected readonly icon: _angular_core.Signal<KbqIcon | undefined>;
-    /** @docs-private */
+    /**
+     * Must keep the default `descendants: true`: it does not gate a projection slot, it reports whether the
+     * already-projected `[kbq-alert-control]` slot contains a button (which can sit inside a wrapper element),
+     * and drives the `_has-button` button-stack padding.
+     *
+     * @docs-private
+     */
     protected readonly button: _angular_core.Signal<KbqButton | undefined>;
     /** @docs-private */
     protected readonly title: _angular_core.Signal<KbqAlertTitle | undefined>;
@@ -61,8 +67,7 @@ declare class KbqAlert {
     readonly alertStyle: _angular_core.InputSignal<"default" | "colored">;
     /**
      * Status of the alert. Drives the background in the `colored` style and auto-tints an uncolored
-     * projected status icon to the matching color (`info` icons become `contrast`).
-     * @default 'info'
+     * projected status icon to the matching color (`info` icons become `contrast`). Defaults to `'info'`.
      */
     readonly alertColor: _angular_core.InputSignalWithTransform<"error" | "warning" | "success" | "info", "error" | "warning" | "success" | "info" | null | undefined>;
     /** Emitted when the projected close control is activated. The consumer is responsible for hiding the alert. */