@koobiq/components 20.4.1 → 21.0.0

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. */

package/types/koobiq-components-app-switcher.d.ts

@@ -0,0 +1,406 @@
+import * as rxjs from 'rxjs';
+import * as _angular_core from '@angular/core';
+import { InjectionToken, AfterViewChecked, OnChanges, AfterViewInit, OnDestroy, AfterContentInit, OnInit, TemplateRef, EventEmitter, SimpleChanges, Type, QueryList, Provider } from '@angular/core';
+import { ScrollStrategy, Overlay, OverlayConfig, CdkScrollable } from '@angular/cdk/overlay';
+import { FormControl } from '@angular/forms';
+import * as i1 from '@koobiq/components/core';
+import { KbqAppSwitcherLocaleConfiguration, KbqPopUp, KbqPopUpTrigger, KbqPopUpPlacementValues, FocusKeyManager, KbqPopUpSizeValues, KbqDeepPartial } from '@koobiq/components/core';
+import { KbqDropdown, KbqDropdownItem } from '@koobiq/components/dropdown';
+import { KbqInput } from '@koobiq/components/input';
+import * as _angular_platform_browser from '@angular/platform-browser';
+import { SafeHtml } from '@angular/platform-browser';
+
+interface KbqAppSwitcherApp {
+    name: string;
+    id: string | number;
+    type?: string | number;
+    /**
+     * Inline SVG markup for the application icon. Use this for SVG icons that should be rendered directly in
+     * the DOM.
+     *
+     * The markup is sanitized against a strict SVG allow-list before it is rendered
+     * (see `KbqAppSwitcherIconSanitizer`): scripts, event handlers, `foreignObject`, `style` and external
+     * references are removed. Prefer `iconSrc` when the icon comes from a URL.
+     */
+    icon?: string;
+    /** Path to the icon file (URL or relative path). */
+    iconSrc?: string;
+    caption?: string;
+    aliases?: KbqAppSwitcherApp[];
+    link?: string;
+}
+interface KbqAppSwitcherSite {
+    name: string;
+    id: string | number;
+    status?: string;
+    /**
+     * Inline SVG markup for the site icon. Use this for SVG icons that should be rendered directly in the DOM.
+     * Sanitized the same way as `KbqAppSwitcherApp.icon`.
+     */
+    icon?: string;
+    /** Path to the icon file (URL or relative path). */
+    iconSrc?: string;
+    apps: KbqAppSwitcherApp[];
+}
+/**
+ * Reducer that assigns an application to a group. Called once per application; implementations either push the
+ * app into `untyped` (rendered as a plain row) or add it to a synthetic group in `groups`.
+ */
+type KbqAppSwitcherGroupBy = (app: KbqAppSwitcherApp, groups: Record<string, KbqAppSwitcherApp>, untyped: KbqAppSwitcherApp[]) => void;
+/** @docs-private */
+declare function defaultGroupBy(app: KbqAppSwitcherApp, groups: Record<string, KbqAppSwitcherApp>, untyped: KbqAppSwitcherApp[]): void;
+/**
+ * Runs `groupBy` over `apps` and returns the rendered order: synthetic groups big enough to be collapsible
+ * first, then every remaining application as a plain row.
+ *
+ * A group is kept only when it holds strictly more than `minAppsForGrouping` applications; smaller groups are
+ * flattened back into plain rows.
+ */
+declare function makeGroupsForApps(apps: KbqAppSwitcherApp[], minAppsForGrouping: number, groupBy?: KbqAppSwitcherGroupBy): KbqAppSwitcherApp[];
+declare const KBQ_MIN_NUMBER_OF_APPS_TO_ENABLE_SEARCH: number;
+declare const KBQ_MIN_NUMBER_OF_APPS_TO_ENABLE_GROUPING: number;
+/** @docs-private */
+declare const KBQ_APP_SWITCHER_SCROLL_STRATEGY: InjectionToken<() => ScrollStrategy>;
+/** @docs-private */
+declare function kbqAppSwitcherScrollStrategyFactory(overlay: Overlay): () => ScrollStrategy;
+/** @docs-private */
+declare const KBQ_APP_SWITCHER_SCROLL_STRATEGY_FACTORY_PROVIDER: {
+    provide: InjectionToken<() => ScrollStrategy>;
+    deps: (typeof Overlay)[];
+    useFactory: typeof kbqAppSwitcherScrollStrategyFactory;
+};
+/** default configuration of app-switcher */
+/** @docs-private */
+declare const KBQ_APP_SWITCHER_DEFAULT_LOCALE_CONFIGURATION: KbqAppSwitcherLocaleConfiguration;
+/** Injection Token for providing the default configuration of app-switcher */
+/** @docs-private */
+declare const KBQ_APP_SWITCHER_LOCALE_CONFIGURATION: InjectionToken<KbqAppSwitcherLocaleConfiguration>;
+/**
+ * Utility provider for `KBQ_APP_SWITCHER_LOCALE_CONFIGURATION`. Only the strings you pass are overridden; the rest
+ * keep following the active locale.
+ */
+declare const kbqAppSwitcherLocaleConfigurationProvider: (configuration: KbqDeepPartial<KbqAppSwitcherLocaleConfiguration>) => Provider;
+/** @deprecated Use {@link KBQ_APP_SWITCHER_DEFAULT_LOCALE_CONFIGURATION}. Will be removed in 22.0.0. */
+declare const KBQ_APP_SWITCHER_DEFAULT_CONFIGURATION: KbqAppSwitcherLocaleConfiguration;
+/** @deprecated Use {@link KBQ_APP_SWITCHER_LOCALE_CONFIGURATION}. Will be removed in 22.0.0. */
+declare const KBQ_APP_SWITCHER_CONFIGURATION: InjectionToken<KbqAppSwitcherLocaleConfiguration>;
+/**
+ * Providers used by the app-switcher. `KbqAppSwitcherModule` applies them for `NgModule` consumers;
+ * standalone consumers that import `KbqAppSwitcherTrigger` directly may add them to their application (or
+ * route) providers.
+ *
+ * Providing them is optional: the only entry is the scroll strategy, and the directive falls back to the
+ * default repositioning strategy when the token is absent. The app-switcher renders no focus trap, so - unlike
+ * `KbqPopoverModule` and `KbqNotificationCenterModule`, whose templates bind `[cdkTrapFocus]` - it must not
+ * swap `FOCUS_TRAP_INERT_STRATEGY`/`FocusTrapFactory`: those are injector-wide and would disable the CDK
+ * inert strategy for every other focus trap in the same scope.
+ */
+declare function kbqAppSwitcherProvider(): Provider[];
+/**
+ * Popup rendered by `KbqAppSwitcherTrigger`. The trigger attaches it to a CDK overlay itself (see
+ * `getOverlayHandleComponentType`) and assigns `trigger` on the created instance, so consumers never place
+ * `<kbq-app-switcher>` in a template - `[kbqAppSwitcher]` on the trigger element is the whole public surface.
+ */
+declare class KbqAppSwitcherComponent extends KbqPopUp implements AfterViewChecked, OnChanges, AfterViewInit, OnDestroy {
+    /** Strings currently rendered by the popup. */
+    readonly localeConfiguration: _angular_core.Signal<KbqAppSwitcherLocaleConfiguration>;
+    /** @docs-private */
+    readonly searchControl: FormControl<string | null>;
+    /** @docs-private */
+    filteredSites: KbqAppSwitcherSite[];
+    /** @docs-private */
+    prefix: string;
+    /** @docs-private */
+    trigger: KbqAppSwitcherTrigger;
+    /** @docs-private */
+    readonly input: _angular_core.Signal<KbqInput | undefined>;
+    /**
+     * The other-sites flyout, closed whenever the pointer moves back over the main list.
+     *
+     * Not `required`: it only exists in multi-site mode, and reading a required query with no match throws -
+     * which a single-site switcher with a search field would do on the first `mouseenter`.
+     *
+     * @docs-private
+     */
+    readonly otherSites: _angular_core.Signal<KbqDropdown | undefined>;
+    private readonly allItemsQuery;
+    private readonly allItemsList;
+    /** @docs-private */
+    protected get allItems(): QueryList<KbqDropdownItem>;
+    /** Roving-focus manager over the inline menu items (flat app rows and other-site rows). */
+    protected keyManager: FocusKeyManager<KbqDropdownItem>;
+    private readonly menuItems;
+    private readonly dir;
+    /**
+     * CSS class marking a nested alias row, bound in the template (see app-switcher.html). Kept as a
+     * single named constant, rather than a literal repeated in both places, so handleGroupHorizontal's
+     * classList check can't silently drift from the template's class binding if the class is renamed.
+     */
+    protected readonly nestedAliasClass = "kbq-app-switcher-site_nested";
+    /** @docs-private */
+    readonly triggerInput: _angular_core.InputSignal<KbqAppSwitcherTrigger | undefined>;
+    ngOnChanges(changes: SimpleChanges): void;
+    constructor();
+    ngAfterViewInit(): void;
+    ngAfterViewChecked(): void;
+    /** Releases the internal roving-focus menu QueryList. */
+    ngOnDestroy(): void;
+    /** @docs-private */
+    updateClassMap(placement: string, customClass: string, size: KbqPopUpSizeValues): void;
+    /** @docs-private */
+    escapeHandler(): void;
+    /**
+     * Handles keyboard navigation across the app-switcher menu items.
+     *
+     * @docs-private
+     */
+    protected keydownHandler(event: KeyboardEvent): void;
+    /**
+     * Expands/collapses an app group (or steps from an alias back to its header) on Left/Right,
+     * honouring the current text direction. Returns whether the key was consumed.
+     */
+    private handleGroupHorizontal;
+    /** Whether the keyboard event originated from the search input. */
+    private eventFromInput;
+    /**
+     * Syncs the key manager's active item with focus that arrives via Tab, click or a closing flyout.
+     * Clears the active item (index -1) when focus lands on a focusable element that isn't one of
+     * `menuItems` (e.g. the search field's clear button) - otherwise a stale `activeItem` from before
+     * the focus move would keep receiving Enter/Space/arrow-key actions meant for the new target.
+     *
+     * @docs-private
+     */
+    protected focusinHandler(event: FocusEvent): void;
+    /**
+     * Closes the popup once focus leaves the menu and its site flyouts, mirroring the dropdown.
+     *
+     * @docs-private
+     */
+    protected focusoutHandler(event: FocusEvent): void;
+    /**
+     * Selects an application belonging to one of the other sites.
+     *
+     * @docs-private
+     */
+    selectAppInSite(site: KbqAppSwitcherSite | undefined, app: KbqAppSwitcherApp): void;
+    private filterSites;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqAppSwitcherComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqAppSwitcherComponent, "kbq-app-switcher", never, { "triggerInput": { "alias": "trigger"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.KbqLocaleOverridesDirective; inputs: {}; outputs: {}; }]>;
+}
+declare class KbqAppSwitcherTrigger extends KbqPopUpTrigger<KbqAppSwitcherComponent> implements OnChanges, AfterContentInit, OnInit {
+    /**
+     * Optional so a standalone consumer works without `kbqAppSwitcherProvider()`; an application-level
+     * provider for `KBQ_APP_SWITCHER_SCROLL_STRATEGY` still wins over this fallback.
+     *
+     * @docs-private
+     */
+    protected scrollStrategy: () => ScrollStrategy;
+    /** @docs-private */
+    arrow: boolean;
+    /** @docs-private */
+    customClass: string;
+    private hasBackdrop;
+    private size;
+    /** @docs-private */
+    content: string | TemplateRef<any>;
+    /** Whether search is used or not */
+    get withSearch(): boolean;
+    /**
+     * Number of applications to choose from
+     *
+     * @docs-private
+     */
+    get appsCount(): number;
+    /**
+     * Whether the sites are used or not
+     *
+     * @docs-private
+     */
+    get sitesMode(): boolean;
+    /**
+     * Applications of the currently selected site, grouped for rendering.
+     *
+     * @docs-private
+     */
+    get currentApps(): KbqAppSwitcherApp[];
+    /** Selected application */
+    readonly selectedApp: _angular_core.ModelSignal<KbqAppSwitcherApp | undefined>;
+    /** Placement of popUp */
+    placement: KbqPopUpPlacementValues;
+    /** Class that will be used in the background */
+    backdropClass: string;
+    /** Offset of popUp */
+    offset: number | null;
+    /** Array of sites, with the applications of each site grouped for rendering. */
+    get sites(): KbqAppSwitcherSite[];
+    set sites(value: KbqAppSwitcherSite[]);
+    /**
+     * Function to group the apps by type. The first argument is an app object with type.
+     * The second is a groups object and third is an array for untyped apps
+     */
+    get groupBy(): KbqAppSwitcherGroupBy;
+    set groupBy(fn: KbqAppSwitcherGroupBy);
+    /** Selected site */
+    readonly selectedSite: _angular_core.ModelSignal<KbqAppSwitcherSite | undefined>;
+    /**
+     * `selectedSite` with its applications grouped for rendering.
+     *
+     * Looked up by id among the parsed sites, so re-selecting a site never regroups it again. Falls back to
+     * the raw value when the id is unknown (a stale id, or `selectedSite` set before `sites`) instead of
+     * throwing.
+     *
+     * @docs-private
+     */
+    readonly parsedSelectedSite: _angular_core.Signal<KbqAppSwitcherSite | undefined>;
+    /** Whether the trigger is disabled. */
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    /** @docs-private */
+    get hasClickTrigger(): boolean;
+    /** Emits a change event whenever the placement state changes. */
+    readonly placementChange: EventEmitter<"top" | "right" | "left" | "bottom" | "topLeft" | "topRight" | "rightTop" | "rightBottom" | "leftTop" | "leftBottom" | "bottomLeft" | "bottomRight">;
+    /** @docs-private */
+    readonly placementChangeOutput: _angular_core.OutputRef<"top" | "right" | "left" | "bottom" | "topLeft" | "topRight" | "rightTop" | "rightBottom" | "leftTop" | "leftBottom" | "bottomLeft" | "bottomRight">;
+    /** Emits a change event whenever the visible state changes. */
+    readonly visibleChange: EventEmitter<boolean>;
+    /** @docs-private */
+    readonly visibleChangeOutput: _angular_core.OutputRef<boolean>;
+    /**
+     * Space-separated list of DOM events that open the popup (`KbqPopUpTrigger.trigger`).
+     *
+     * Not to be confused with `KbqAppSwitcherComponent.trigger`, which is the back-reference from the popup to
+     * this directive.
+     *
+     * @docs-private
+     */
+    trigger: string;
+    /**
+     * Sites exactly as supplied through `sites`, without grouping.
+     *
+     * @docs-private
+     */
+    get originalSites(): KbqAppSwitcherSite[];
+    set originalSites(value: KbqAppSwitcherSite[]);
+    /** @docs-private */
+    protected originSelector: string;
+    /** @docs-private */
+    protected get overlayConfig(): OverlayConfig;
+    private readonly originalSitesSignal;
+    private readonly groupBySignal;
+    /**
+     * Sites with their applications grouped, keyed by site id.
+     *
+     * Grouping runs once per `sites`/`groupBy` change instead of once per `selectedSite` assignment, and the
+     * parsed objects keep their identity so `@for` can reuse the rendered rows.
+     */
+    private readonly parsedSitesById;
+    private readonly parsedSites;
+    private readonly appsCountComputed;
+    private readonly sitesModeComputed;
+    private readonly currentAppsComputed;
+    /** @docs-private */
+    readonly placementInput: _angular_core.InputSignal<"top" | "right" | "left" | "bottom" | "topLeft" | "topRight" | "rightTop" | "rightBottom" | "leftTop" | "leftBottom" | "bottomLeft" | "bottomRight" | undefined>;
+    /** @docs-private */
+    readonly backdropClassInput: _angular_core.InputSignal<string | undefined>;
+    /** @docs-private */
+    readonly offsetInput: _angular_core.InputSignalWithTransform<number | null | undefined, string | number | null | undefined>;
+    /** @docs-private */
+    readonly sitesInput: _angular_core.InputSignal<KbqAppSwitcherSite[] | undefined>;
+    /** @docs-private */
+    readonly groupByInput: _angular_core.InputSignal<KbqAppSwitcherGroupBy | undefined>;
+    /** @docs-private */
+    readonly disabledInput: _angular_core.InputSignalWithTransform<boolean | undefined, string | boolean | null | undefined>;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnInit(): void;
+    ngAfterContentInit(): void;
+    /** @docs-private */
+    updateData(): void;
+    /** @docs-private */
+    getOverlayHandleComponentType(): Type<KbqAppSwitcherComponent>;
+    /** @docs-private */
+    updateClassMap(newPlacement?: string): void;
+    /** @docs-private */
+    closingActions(): rxjs.Observable<void | MouseEvent | CdkScrollable>;
+    /** Whether a `ScrollDispatcher` emission originates from inside this popup's own scrollable content. */
+    private isInnerScroll;
+    private hideIfNotInViewPort;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqAppSwitcherTrigger, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqAppSwitcherTrigger, "[kbqAppSwitcher]", ["kbqAppSwitcher"], { "selectedApp": { "alias": "selectedApp"; "required": false; "isSignal": true; }; "selectedSite": { "alias": "selectedSite"; "required": false; "isSignal": true; }; "placementInput": { "alias": "kbqAppSwitcherPlacement"; "required": false; "isSignal": true; }; "backdropClassInput": { "alias": "backdropClass"; "required": false; "isSignal": true; }; "offsetInput": { "alias": "offset"; "required": false; "isSignal": true; }; "sitesInput": { "alias": "sites"; "required": false; "isSignal": true; }; "groupByInput": { "alias": "groupBy"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "selectedApp": "selectedAppChange"; "selectedSite": "selectedSiteChange"; "placementChangeOutput": "kbqPlacementChange"; "visibleChangeOutput": "kbqVisibleChange"; }, never, never, true, never>;
+}
+
+/** @docs-private */
+declare class KbqAppSwitcherDropdownApp extends KbqDropdownItem {
+    private readonly iconSanitizer;
+    /** Application (or synthetic app group) rendered by this flyout row. */
+    readonly app: _angular_core.InputSignal<KbqAppSwitcherApp>;
+    /** Inline SVG of the app icon, sanitized against an SVG allow-list. See `KbqAppSwitcherListItem.safeIcon`. */
+    protected readonly safeIcon: _angular_core.Signal<_angular_platform_browser.SafeHtml | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqAppSwitcherDropdownApp, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqAppSwitcherDropdownApp, "[kbq-app-switcher-dropdown-app]", ["kbqAppSwitcherDropdownApp"], { "app": { "alias": "kbq-app-switcher-dropdown-app"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/** @docs-private */
+declare class KbqAppSwitcherDropdownSite extends KbqDropdownItem {
+    /** Site rendered by this row. */
+    readonly site: _angular_core.InputSignal<KbqAppSwitcherSite>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqAppSwitcherDropdownSite, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqAppSwitcherDropdownSite, "[kbq-app-switcher-dropdown-site]", ["kbqAppSwitcherDropdownSite"], { "site": { "alias": "kbq-app-switcher-dropdown-site"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Turns the caller-supplied inline SVG of an app-switcher icon into markup that is safe to hand to
+ * `[innerHtml]`.
+ *
+ * Angular's own HTML sanitizer cannot be used here: its allow-list contains no SVG elements at all, so it
+ * would strip every icon. Instead the markup is parsed inert (inside a `<template>`, where no request is
+ * issued and no script runs), filtered against a strict SVG allow-list, and only then marked as trusted.
+ */
+declare class KbqAppSwitcherIconSanitizer {
+    private readonly document;
+    private readonly domSanitizer;
+    /**
+     * Sanitizes inline SVG markup and wraps it as `SafeHtml`. Returns `null` for empty input, so callers can
+     * use the result directly as the `@if` condition of the icon element.
+     */
+    sanitize(icon: string | null | undefined): SafeHtml | null;
+    /** Parses the markup inertly, strips everything outside the allow-lists and serializes it back. */
+    private filter;
+    private sanitizeChildren;
+    private sanitizeAttributes;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqAppSwitcherIconSanitizer, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<KbqAppSwitcherIconSanitizer>;
+}
+
+/** @docs-private */
+declare class KbqAppSwitcherListItem extends KbqDropdownItem {
+    private readonly iconSanitizer;
+    /** Application (or synthetic app group) rendered by this row. */
+    readonly app: _angular_core.InputSignal<KbqAppSwitcherApp>;
+    /** Whether the row is a group header carrying the expand/collapse toggle. */
+    readonly toggle: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Search query to highlight within the app name. */
+    readonly highlightText: _angular_core.InputSignal<string>;
+    /** Whether the group's aliases are hidden. */
+    readonly collapsed: _angular_core.ModelSignal<boolean>;
+    /**
+     * Inline SVG of the app icon, sanitized against an SVG allow-list.
+     *
+     * Computed from the `app` input instead of being called from the template, so the `SafeHtml` is produced
+     * once per app rather than on every change-detection pass — a fresh object would make `[innerHtml]`
+     * re-parse the SVG each time.
+     */
+    protected readonly safeIcon: _angular_core.Signal<_angular_platform_browser.SafeHtml | null>;
+    /** Toggles the group when this row is a group header; plain rows keep their link behaviour. */
+    clickHandler(event: MouseEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqAppSwitcherListItem, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqAppSwitcherListItem, "[kbq-app-switcher-list-item]", ["kbqAppSwitcherApp"], { "app": { "alias": "app"; "required": true; "isSignal": true; }; "toggle": { "alias": "toggle"; "required": false; "isSignal": true; }; "highlightText": { "alias": "highlightText"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; }, { "collapsed": "collapsedChange"; }, never, never, true, never>;
+}
+
+declare class KbqAppSwitcherModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqAppSwitcherModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<KbqAppSwitcherModule, never, [typeof KbqAppSwitcherComponent, typeof KbqAppSwitcherTrigger, typeof KbqAppSwitcherListItem, typeof KbqAppSwitcherDropdownApp, typeof KbqAppSwitcherDropdownSite], [typeof KbqAppSwitcherTrigger]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<KbqAppSwitcherModule>;
+}
+
+export { KBQ_APP_SWITCHER_CONFIGURATION, KBQ_APP_SWITCHER_DEFAULT_CONFIGURATION, KBQ_APP_SWITCHER_DEFAULT_LOCALE_CONFIGURATION, KBQ_APP_SWITCHER_LOCALE_CONFIGURATION, KBQ_APP_SWITCHER_SCROLL_STRATEGY, KBQ_APP_SWITCHER_SCROLL_STRATEGY_FACTORY_PROVIDER, KBQ_MIN_NUMBER_OF_APPS_TO_ENABLE_GROUPING, KBQ_MIN_NUMBER_OF_APPS_TO_ENABLE_SEARCH, KbqAppSwitcherComponent, KbqAppSwitcherDropdownApp, KbqAppSwitcherDropdownSite, KbqAppSwitcherIconSanitizer, KbqAppSwitcherListItem, KbqAppSwitcherModule, KbqAppSwitcherTrigger, defaultGroupBy, kbqAppSwitcherLocaleConfigurationProvider, kbqAppSwitcherProvider, kbqAppSwitcherScrollStrategyFactory, makeGroupsForApps };
+export type { KbqAppSwitcherApp, KbqAppSwitcherGroupBy, KbqAppSwitcherSite };