@dereekb/dbx-web 13.4.1 → 13.4.2

package/fesm2022/dereekb-dbx-web.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { Injectable, input, inject, effect, Directive, NgModule, ChangeDetectionStrategy, Component, output, computed, HostListener, InjectionToken, signal, ElementRef, Injector, DestroyRef, viewChild, makeEnvironmentProviders, TemplateRef, model, SecurityContext, forwardRef, ViewContainerRef, Optional, Inject, Renderer2 } from '@angular/core';
+import { Injectable, input, inject, effect, Directive, NgModule, ChangeDetectionStrategy, Component, output, computed, HostListener, InjectionToken, signal, ElementRef, Injector, DestroyRef, viewChild, makeEnvironmentProviders, TemplateRef, model, SecurityContext, forwardRef, ViewContainerRef, Renderer2 } from '@angular/core';
 import { DASH_CHARACTER_PREFIX_INSTANCE, asPromise, cssClassesSet, isDefinedAndNotFalse, spaceSeparatedCssClasses, objectHasNoKeys, getValueFromGetter, firstValue, filterUndefinedValues, separateValues, splitFront, asDecisionFunction, SLASH_PATH_FILE_TYPE_SEPARATOR, filterMaybeArrayValues, mapIterable, toReadableError, isDefaultReadableError, MS_IN_SECOND, mergeObjects, build, ServerErrorResponse, UnauthorizedServerErrorResponse, makeTimer, MS_IN_MINUTE, toggleTimerRunning, unixDateTimeSecondsNumberForNow, ModelRelationUtility, encodeModelKeyTypePair, useIterableOrValue, safeCompareEquality, addMilliseconds, isPast, asArray, slashPathDetails, mimeTypeForFileExtension, slashPathDirectoryTree, isMaybeNot, isNotFalse, modifier, combineMaps, addModifiers, removeModifiers, applyBestFit, findNext, maybeModifierMapToFunction, makeValuesGroupMap, compareWithMappedValuesFunction, invertMaybeBoolean, splitCommaSeparatedStringToSet, ZIP_FILE_MIME_TYPE, cachedGetter, sortByNumberFunction } from '@dereekb/util';
 import * as i1$2 from '@dereekb/dbx-core';
 import { completeOnDestroy, clean, cleanSubscription, AbstractTransitionWatcherDirective, DbxInjectionComponent, AbstractDbxActionValueGetterDirective, AbstractDbxButtonDirective, provideDbxButton, dbxActionWorkProgress, DbxCoreButtonModule, AbstractDbxActionHandlerDirective, FilterSourceDirective, provideActionStoreSource, isClickableFilterPreset, AbstractDbxAnchorDirective, expandClickableAnchorLinkTrees, DbxCoreFilterModule, DbxButton, DbxActionContextStoreSourceInstance, cleanSubscriptionWithLockSet, DBX_INJECTION_COMPONENT_DATA, checkNgContentWrapperHasContent, cleanLoadingContext, DbxActionSourceDirective, DbxActionSuccessHandlerDirective, DbxActionDirective, transformEmptyStringInputToUndefined, isIdleActionState, canTriggerAction, DbxCoreActionModule, DbxActionButtonDirective, onDbxAppAuth, SimpleStorageAccessorFactory, mergeStaticProviders, asSegueRef, AbstractTransitionDirective, DbxRouterService, AbstractIfDirective, isSegueRefActive, anchorTypeForAnchor } from '@dereekb/dbx-core';
@@ -137,6 +137,9 @@ var CompactMode;
  * compactModeFromInput(true);  // CompactMode.COMPACT
  * compactModeFromInput(CompactMode.FULL);  // CompactMode.FULL
  * ```
+ *
+ * @param input - a boolean or CompactMode value to normalize
+ * @returns the normalized CompactMode enum value
  */
 function compactModeFromInput(input) {
     if (typeof input === 'boolean') {
@@ -156,6 +159,10 @@ function compactModeFromInput(input) {
  *   defaultMode: CompactMode.FULL
  * });
  * ```
+ *
+ * @param mode$ - an observable of the current compact mode, or nullish to use the default
+ * @param config - the mapping configuration containing values for each mode and an optional default
+ * @returns an observable emitting the mapped value corresponding to the current compact mode
  */
 function mapCompactModeObs(mode$, config) {
     const modeObs = mode$ ?? of(config.defaultMode ?? CompactMode.FULL);
@@ -364,10 +371,8 @@ class DbxWindowKeyDownListenerDirective {
     handleKeyboardEvent(event) {
         const keysFilter = this.keysFilterSignal();
         const enabled = this.isEnabledSignal();
-        if (enabled !== false) {
-            if (!keysFilter || keysFilter.has(event.key)) {
-                this.dbxWindowKeyDownListener.emit(event);
-            }
+        if (enabled !== false && (!keysFilter || keysFilter.has(event.key))) {
+            this.dbxWindowKeyDownListener.emit(event);
         }
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxWindowKeyDownListenerDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
@@ -404,6 +409,9 @@ const DBX_THEME_COLORS = [...DBX_THEME_COLORS_MAIN, ...DBX_THEME_COLORS_EXTRA, .
  * dbxColorBackground('primary'); // 'dbx-primary-bg'
  * dbxColorBackground(undefined); // 'dbx-default'
  * ```
+ *
+ * @param color - the theme color to convert, or nullish/empty for the default class
+ * @returns the CSS class name for the themed background (e.g., `'dbx-primary-bg'` or `'dbx-default'`)
  */
 function dbxColorBackground(color) {
     let cssClass = 'dbx-default'; // background by default
@@ -419,6 +427,8 @@ function dbxColorBackground(color) {
         case 'default':
             cssClass = `dbx-${color}-bg`;
             break;
+        default:
+            break;
     }
     return cssClass;
 }
@@ -456,10 +466,8 @@ class DbxStyleService {
     getStyleClassWithConfig(configObs) {
         return combineLatest([configObs, this.styleClassSuffix$]).pipe(map(([config, suffix]) => {
             let styleClass = config.style;
-            if (suffix != null && config.suffixes) {
-                if (config.suffixes.has(suffix)) {
-                    styleClass = `${styleClass}${DASH_CHARACTER_PREFIX_INSTANCE.prefixSuffixString(suffix)}`;
-                }
+            if (suffix != null && config.suffixes?.has(suffix)) {
+                styleClass = `${styleClass}${DASH_CHARACTER_PREFIX_INSTANCE.prefixSuffixString(suffix)}`;
             }
             return styleClass;
         }), distinctUntilChanged(), shareReplay(1));
@@ -493,30 +501,40 @@ class DbxStyleService {
     }
     /**
      * Returns the current style class suffix, if one is set.
+     *
+     * @returns the currently active style class suffix, or undefined if none is set
      */
     get currentStyleClassSuffix() {
         return this._styleClassSuffix.value;
     }
     /**
      * Directly sets the active style class suffix, or clears it if null/undefined.
+     *
+     * @param suffix - the suffix to activate, or nullish to clear the current suffix
      */
     setStyleClassSuffix(suffix) {
         this._styleClassSuffix.next(suffix ? dbxStyleClassCleanSuffix(suffix) : undefined);
     }
     /**
      * Updates the default style configuration used when no override config is set.
+     *
+     * @param defaultConfig - the style configuration to use as the new default
      */
     setDefaultConfig(defaultConfig) {
         this._defaultConfig.next(defaultConfig);
     }
     /**
      * Overrides the active style configuration with the given value or observable.
+     *
+     * @param config - a style configuration value or observable to set as the active override
      */
     setConfig(config) {
         this._config.next(asObservable(config));
     }
     /**
      * Clears the active config override if it matches the given reference, reverting to the default config.
+     *
+     * @param config - the config reference to compare against the current override
      */
     unsetConfig(config) {
         if (this._config.value === config) {
@@ -605,7 +623,9 @@ class DbxPopoverComponent extends AbstractTransitionWatcherDirective {
             }
         };
         // Also intercept the _close function to capture backdropClose, etc.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- accessing private member _close
         const original_close = this.popoverRef._close;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- accessing private member _close
         this.popoverRef._close = (closeType, inputValue) => {
             const closeWithValue = (value) => {
                 original_close.call(this.popoverRef, closeType, value);
@@ -618,7 +638,7 @@ class DbxPopoverComponent extends AbstractTransitionWatcherDirective {
                 this._useClosingValue(closeType, (x) => closeWithValue(x));
             }
         };
-        // eslint-disable-next-line
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- accessing private member _overlay
         const overlay = this.popoverRef._overlay; // overlay is not publically accessible
         const elementRef = this.config.origin;
         const configuration = this.config.configuration;
@@ -778,6 +798,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
  */
 class DbxDialogContentCloseComponent {
     padded = input(true, ...(ngDevMode ? [{ debugName: "padded" }] : []));
+    // eslint-disable-next-line @angular-eslint/no-output-native
     close = output();
     closeClicked() {
         this.close.emit(undefined);
@@ -822,6 +843,7 @@ class DbxDialogContentFooterComponent {
     buttonColor = input(...(ngDevMode ? [undefined, { debugName: "buttonColor" }] : []));
     closeTextSignal = computed(() => this.closeText() ?? this.config()?.closeText ?? 'Close', ...(ngDevMode ? [{ debugName: "closeTextSignal" }] : []));
     buttonColorSignal = computed(() => this.buttonColor() ?? this.config()?.buttonColor ?? undefined, ...(ngDevMode ? [{ debugName: "buttonColorSignal" }] : []));
+    // eslint-disable-next-line @angular-eslint/no-output-native
     close = output();
     closeClicked() {
         this.close.emit();
@@ -943,13 +965,12 @@ class DbxInjectionDialogComponent extends AbstractDialogDirective {
         return this.data.componentConfig;
     }
     static openDialog(matDialog, config) {
-        const dialogRef = matDialog.open((DbxInjectionDialogComponent), {
+        return matDialog.open((DbxInjectionDialogComponent), {
             width: '80vw',
             height: '80vh',
             ...config,
             data: config
         });
-        return dialogRef;
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxInjectionDialogComponent, deps: null, target: i0.ɵɵFactoryTarget.Component });
     static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.0", type: DbxInjectionDialogComponent, isStandalone: true, selector: "ng-component", usesInheritance: true, ngImport: i0, template: `
@@ -981,6 +1002,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
 /**
  * Sanitizes a {@link DbxDialogContentConfig} by normalizing the panelClass into an array.
  *
+ * @param input - The dialog content config to sanitize, or null/undefined
+ * @returns A new config with panelClass normalized to an array of CSS class strings
+ *
  * @example
  * ```ts
  * const config = sanitizeDbxDialogContentConfig({ panelClass: 'my-panel my-other-panel' });
@@ -990,7 +1014,7 @@ function sanitizeDbxDialogContentConfig(input) {
     const panelClass = input?.panelClass;
     return {
         ...input,
-        panelClass: panelClass ? Array.from(cssClassesSet(input?.panelClass)) : undefined
+        panelClass: panelClass ? [...cssClassesSet(input?.panelClass)] : undefined
     };
 }
 
@@ -1089,17 +1113,18 @@ class AbstractPopoverRefDirective {
         }
     }
     _showPopoverRef(origin) {
-        this._popoverRef = this._makePopoverRef(origin);
-        this._afterOpened(this._popoverRef);
-        this._popoverSub.setSub(this._popoverRef.afterClosed$.subscribe((x) => {
+        const popoverRef = this._makePopoverRef(origin);
+        this._popoverRef = popoverRef;
+        this._afterOpened(popoverRef);
+        this._popoverSub.setSub(popoverRef.afterClosed$.subscribe((x) => {
             this._afterClosed(x);
             this._popoverRef = undefined;
         }));
     }
-    _afterOpened(popoverRef) {
+    _afterOpened(_popoverRef) {
         // Do nothing. Override in parent type
     }
-    _afterClosed(value) {
+    _afterClosed(_value) {
         // Do nothing. Override in parent type
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: AbstractPopoverRefDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
@@ -1658,6 +1683,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
  */
 class AbstractFilterPopoverButtonDirective extends AbstractPopoverRefDirective {
     popupService = inject(DbxPopoverService);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     config = input(undefined, ...(ngDevMode ? [{ debugName: "config" }] : []));
     _makePopoverRef(origin) {
         const config = this.config();
@@ -1871,8 +1897,7 @@ class AbstractProgressButtonDirective {
         const working = this.working();
         const config = this.configSignal();
         const configWorking = config?.working;
-        const workingProgress = dbxActionWorkProgress([working, configWorking]);
-        return workingProgress;
+        return dbxActionWorkProgress([working, configWorking]);
     }, ...(ngDevMode ? [{ debugName: "workingProgressSignal" }] : []));
     isWorkingSignal = computed(() => isDefinedAndNotFalse(this.workingProgressSignal()), ...(ngDevMode ? [{ debugName: "isWorkingSignal" }] : []));
     workingValueSignal = computed(() => {
@@ -2049,9 +2074,8 @@ class DbxProgressSpinnerButtonComponent extends AbstractProgressButtonDirective
     }, ...(ngDevMode ? [{ debugName: "showTextButtonIconSignal" }] : []));
     showIconSignal = computed(() => {
         const config = this.configSignal();
-        return (config &&
-            config.buttonIcon && // button icon must be defined
-            !this.showTextContentSignal()); // show icon if either fab or iconOnly is true
+        return (config?.buttonIcon && !this.showTextContentSignal() // button icon must be defined
+        ); // show icon if either fab or iconOnly is true
     }, ...(ngDevMode ? [{ debugName: "showIconSignal" }] : []));
     customSpinnerStyleSignal = computed(() => {
         const customSpinnerColor = this.configSignal()?.customSpinnerColor;
@@ -2475,6 +2499,9 @@ class DbxRouterWebProviderConfig {
  *   childClickTarget: this.buttonElementRef
  * });
  * ```
+ *
+ * @param config - configuration specifying the click target, child element to intercept, and optional disabled signal
+ * @returns the created Angular effect reference
  */
 function overrideClickElementEffect(config) {
     const { clickTarget, childClickTarget, disabledSignal } = config;
@@ -2491,30 +2518,28 @@ function overrideClickElementEffect(config) {
         if (_cleanupClickOverride) {
             _cleanupClickOverride();
         }
-        if (childClickElement) {
-            if (!anchorDisabled) {
-                const clickOverride = (event) => {
-                    // Allow ctrl+click, cmd+click, shift+click, and middle-click for new tab/window
-                    // Don't preventDefault or stopPropagation - let browser handle it naturally
-                    if (event.ctrlKey || event.metaKey || event.shiftKey || event.button === 1) {
-                        return; // Browser will open in new tab/window
-                    }
-                    else {
-                        // otherwise, also trigger a click on the uiSref anchor element
-                        clickTargetElement?.nativeElement.click();
-                        // Prevents the default behavior of the anchor element's href from being triggered
-                        event.preventDefault();
-                        event.stopPropagation();
-                    }
-                };
-                _cleanupClickOverride = () => {
-                    childClickElement.nativeElement.removeEventListener('click', clickOverride);
-                    _cleanupClickOverride = null;
-                };
-                childClickElement.nativeElement.addEventListener('click', clickOverride, {
-                    capture: true // Use capture to ensure this event listener is called before any nested child's event listeners
-                });
-            }
+        if (childClickElement && !anchorDisabled) {
+            const clickOverride = (event) => {
+                // Allow ctrl+click, cmd+click, shift+click, and middle-click for new tab/window
+                // Don't preventDefault or stopPropagation - let browser handle it naturally
+                if (event.ctrlKey || event.metaKey || event.shiftKey || event.button === 1) {
+                    return; // Browser will open in new tab/window
+                }
+                else {
+                    // otherwise, also trigger a click on the uiSref anchor element
+                    clickTargetElement?.nativeElement.click();
+                    // Prevents the default behavior of the anchor element's href from being triggered
+                    event.preventDefault();
+                    event.stopPropagation();
+                }
+            };
+            _cleanupClickOverride = () => {
+                childClickElement.nativeElement.removeEventListener('click', clickOverride);
+                _cleanupClickOverride = null;
+            };
+            childClickElement.nativeElement.addEventListener('click', clickOverride, {
+                capture: true // Use capture to ensure this event listener is called before any nested child's event listeners
+            });
         }
     });
 }
@@ -2561,7 +2586,7 @@ class DbxAnchorComponent extends AbstractDbxAnchorDirective {
         <ng-container *ngTemplateOutlet="content"></ng-container>
       }
       @case ('clickable') {
-        <a #clickable class="dbx-anchor-a dbx-anchor-click" [ngClass]="selectedClassSignal()" (click)="clickAnchor()">
+        <a #clickable class="dbx-anchor-a dbx-anchor-click" [ngClass]="selectedClassSignal()" tabindex="0" (click)="clickAnchor()" (keydown.enter)="clickAnchor()">
           <span #childClickTarget>
             <ng-container *ngTemplateOutlet="content"></ng-container>
           </span>
@@ -2599,7 +2624,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
         <ng-container *ngTemplateOutlet="content"></ng-container>
       }
       @case ('clickable') {
-        <a #clickable class="dbx-anchor-a dbx-anchor-click" [ngClass]="selectedClassSignal()" (click)="clickAnchor()">
+        <a #clickable class="dbx-anchor-a dbx-anchor-click" [ngClass]="selectedClassSignal()" tabindex="0" (click)="clickAnchor()" (keydown.enter)="clickAnchor()">
           <span #childClickTarget>
             <ng-container *ngTemplateOutlet="content"></ng-container>
           </span>
@@ -2699,6 +2724,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
 /**
  * Creates an observable that emits the button text for a preset filter menu based on the current selection.
  *
+ * @param config$ - Observable of the preset filter menu configuration
+ * @param selection$ - Observable of the currently selected preset, used to derive the display title
+ * @param defaultText - Fallback text when no selection or unknownSelectionText is configured. Defaults to 'Filter'.
+ * @returns An observable emitting the resolved button text string
+ *
  * @example
  * ```ts
  * const text$ = dbxPresetFilterMenuButtonTextObservable(config$, selectedPreset$);
@@ -2710,6 +2740,11 @@ function dbxPresetFilterMenuButtonTextObservable(config$, selection$, defaultTex
 /**
  * Creates an observable that emits the button icon for a preset filter menu based on the current selection and config.
  *
+ * @param config$ - Observable of the preset filter menu configuration controlling icon behavior
+ * @param selection$ - Observable of the currently selected preset, used to derive the display icon
+ * @param defaultIcon - Fallback icon when no filterIcon is configured. Defaults to 'arrow_drop_down'.
+ * @returns An observable emitting the resolved icon string, or undefined when no icon should be shown
+ *
  * @example
  * ```ts
  * const icon$ = dbxPresetFilterMenuButtonIconObservable(config$, selectedPreset$);
@@ -2937,6 +2972,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
 /**
  * Opens a dialog containing a {@link DbxIframeComponent} to display a URL in an iframe.
  *
+ * @param matDialog - The Angular Material dialog service used to open the dialog
+ * @param config - Configuration specifying the content URL and dialog options
+ * @returns A reference to the opened dialog for controlling or subscribing to its lifecycle
+ *
  * @example
  * ```ts
  * const ref = openIframeDialog(matDialog, { contentUrl: 'https://example.com' });
@@ -3054,6 +3093,8 @@ class DbxEmbedComponent {
                                 embed.setAttribute('type', type);
                             }
                             break;
+                        default:
+                            break;
                     }
                     element.appendChild(embed);
                 }
@@ -3080,6 +3121,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
 /**
  * Opens a dialog containing a {@link DbxEmbedComponent} to display embedded content from a URL or Blob.
  *
+ * @param matDialog - The Angular Material dialog service used to open the dialog
+ * @param config - Configuration specifying the content source (URL or Blob), MIME type, and dialog options
+ * @returns A reference to the opened dialog for controlling or subscribing to its lifecycle
+ *
  * @example
  * ```ts
  * const ref = openEmbedDialog(matDialog, { srcUrl: 'https://example.com/doc.pdf', embedMimeType: 'application/pdf' });
@@ -3647,6 +3692,9 @@ class DbxPromptConfirm {
 /**
  * Provides a {@link DbxPromptConfirm} implementation for dependency injection.
  *
+ * @param sourceType - The concrete class that implements {@link DbxPromptConfirm}
+ * @returns An array of providers that register the given type as the {@link DbxPromptConfirm} implementation
+ *
  * @example
  * ```ts
  * @Directive({ providers: provideDbxPromptConfirm(MyConfirmDirective) })
@@ -4006,6 +4054,7 @@ class DbxPromptConfirmComponent {
     confirmTextSignal = computed(() => this.config()?.confirmText || 'Confirm', ...(ngDevMode ? [{ debugName: "confirmTextSignal" }] : []));
     cancelTextSignal = computed(() => this.config()?.cancelText || 'Cancel', ...(ngDevMode ? [{ debugName: "cancelTextSignal" }] : []));
     confirm = output();
+    // eslint-disable-next-line @angular-eslint/no-output-native
     cancel = output();
     onConfirm() {
         this.confirm.emit();
@@ -4074,10 +4123,9 @@ class DbxPromptConfirmDialogComponent extends AbstractDialogDirective {
         return this.data.component;
     }
     static openDialog(matDialog, config) {
-        const dialogRef = matDialog.open(DbxPromptConfirmDialogComponent, {
+        return matDialog.open(DbxPromptConfirmDialogComponent, {
             data: config ?? DEFAULT_DBX_PROMPT_CONFIRM_DIALOG_CONFIG
         });
-        return dialogRef;
     }
     confirm() {
         this.close(true);
@@ -4191,8 +4239,7 @@ class DbxContentContainerDirective {
     padding = input('normal', ...(ngDevMode ? [{ debugName: "padding" }] : []));
     topPadding = input('none', ...(ngDevMode ? [{ debugName: "topPadding" }] : []));
     classConfig = computed(() => {
-        const classConfig = 'container-' + this.grow() + ' container-padding-' + this.padding() + ' container-top-padding-' + this.topPadding();
-        return classConfig;
+        return 'container-' + this.grow() + ' container-padding-' + this.padding() + ' container-top-padding-' + this.topPadding();
     }, ...(ngDevMode ? [{ debugName: "classConfig" }] : []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxContentContainerDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
     static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "21.2.0", type: DbxContentContainerDirective, isStandalone: true, selector: "dbx-content-container,[dbxContentContainer],.dbx-content-container", inputs: { grow: { classPropertyName: "grow", publicName: "grow", isSignal: true, isRequired: false, transformFunction: null }, padding: { classPropertyName: "padding", publicName: "padding", isSignal: true, isRequired: false, transformFunction: null }, topPadding: { classPropertyName: "topPadding", publicName: "topPadding", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "class": "classConfig()" }, classAttribute: "d-block dbx-content-container" }, ngImport: i0 });
@@ -4376,8 +4423,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
 /**
  * Returns a string that can be used as the "accept" attribute of a file input element.
  *
- * @param accept
- * @returns
+ * @param accept - A file accept string or array of filter type strings to convert
+ * @returns A comma-separated string suitable for the HTML accept attribute
  */
 function fileAcceptString(accept) {
     return typeof accept === 'string' ? accept : accept.join(',');
@@ -4385,6 +4432,9 @@ function fileAcceptString(accept) {
 /**
  * Converts a comma-separated accept string or array into a {@link FileAcceptFilterTypeStringArray}.
  *
+ * @param accept - A file accept string or array of filter type strings to normalize
+ * @returns An array of individual filter type strings
+ *
  * @example
  * ```ts
  * const types = fileAcceptFilterTypeStringArray('image/png, .pdf');
@@ -4397,6 +4447,9 @@ function fileAcceptFilterTypeStringArray(accept) {
 /**
  * Creates a {@link FileArrayAcceptMatchFunction} that filters and separates files based on accept criteria and multiple file support.
  *
+ * @param config - Configuration specifying the accept criteria and whether multiple files are allowed
+ * @returns A function that accepts an array of files and returns the categorized match result
+ *
  * @example
  * ```ts
  * const matchFn = fileArrayAcceptMatchFunction({ accept: 'image/*', multiple: false });
@@ -4422,6 +4475,9 @@ function fileArrayAcceptMatchFunction(config) {
 /**
  * Creates a {@link FileAcceptFunction} that checks individual files against accept criteria (MIME types, wildcards, or file extensions).
  *
+ * @param accept - A file accept string or array specifying which MIME types, wildcards, or file extensions to allow
+ * @returns A decision function that returns true if a file matches any of the accept criteria
+ *
  * @example
  * ```ts
  * const isAccepted = fileAcceptFunction(['image/*', '.pdf']);
@@ -4436,7 +4492,7 @@ function fileAcceptFunction(accept) {
         fileAcceptFunction = asDecisionFunction(true);
     }
     else {
-        const hasWildcard = acceptList.some((x) => x === '*');
+        const hasWildcard = acceptList.includes('*');
         if (hasWildcard) {
             fileAcceptFunction = asDecisionFunction(true);
         }
@@ -4457,7 +4513,7 @@ function fileAcceptFunction(accept) {
                 }
             });
             fileAcceptFunction = (input) => {
-                return isAcceptedFunctions.findIndex((x) => x(input)) !== -1;
+                return isAcceptedFunctions.some((x) => x(input));
             };
         }
     }
@@ -4472,6 +4528,9 @@ class DbxFileUploadActionCompatable {
 /**
  * Provides a {@link DbxFileUploadActionCompatable} for dependency injection from the given component type.
  *
+ * @param sourceType - The concrete component class that implements {@link DbxFileUploadActionCompatable}
+ * @returns An array of providers that register the given type as the {@link DbxFileUploadActionCompatable} implementation
+ *
  * @example
  * ```ts
  * @Component({ providers: provideDbxFileUploadActionCompatable(MyUploadComponent) })
@@ -4545,10 +4604,10 @@ class DbxFileUploadAreaComponent extends AbstractDbxFileUploadComponent {
     @if (show()) {
       <div class="dbx-file-upload-area-content">
         <div class="dbx-file-upload-area-content-text">
-          @if (icon() != null) {
+          @if (icon()) {
             <mat-icon>{{ icon() }}</mat-icon>
           }
-          @if (text() != null) {
+          @if (text()) {
             <span>{{ text() }}</span>
           }
         </div>
@@ -4577,10 +4636,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
     @if (show()) {
       <div class="dbx-file-upload-area-content">
         <div class="dbx-file-upload-area-content-text">
-          @if (icon() != null) {
+          @if (icon()) {
             <mat-icon>{{ icon() }}</mat-icon>
           }
-          @if (text() != null) {
+          @if (text()) {
             <span>{{ text() }}</span>
           }
         </div>
@@ -5012,6 +5071,7 @@ class DbxErrorWidgetService {
         if (override || !this._entries.has(entry.code)) {
             this._entries.set(entry.code, {
                 ...entry,
+                // eslint-disable-next-line @typescript-eslint/no-deprecated
                 widgetComponentClass: entry.widgetComponentClass ?? entry.componentClass
             });
             return true;
@@ -5022,7 +5082,7 @@ class DbxErrorWidgetService {
     }
     // MARK: Get
     getErrorWidgetIdentifiers() {
-        return Array.from(this._entries.keys());
+        return [...this._entries.keys()];
     }
     getDefaultErrorWidgetEntry() {
         return this.getErrorWidgetEntry(DEFAULT_ERROR_WIDGET_CODE);
@@ -5062,7 +5122,7 @@ class DbxErrorWidgetViewComponent {
     error = input(...(ngDevMode ? [undefined, { debugName: "error" }] : []));
     errorWithCodeSignal = computed(() => {
         const currentError = this.error();
-        const error = currentError && currentError.code ? currentError : undefined;
+        const error = currentError?.code ? currentError : undefined;
         let config;
         if (error != null) {
             const entry = this.dbxErrorWidgetService.getErrorWidgetEntry(error.code);
@@ -6018,6 +6078,7 @@ class DbxActionSnackbarService {
      *
      * @param type - The snackbar type key (e.g. "save", "delete"), or undefined to use "none".
      * @param input - The generator input containing the event and optional undo configuration.
+     * @returns The generated display configuration, or `undefined` if no config is registered for the given type.
      */
     generateDisplayConfig(type, input) {
         const configForType = this.eventTypeConfigs[type ?? 'none'];
@@ -6082,7 +6143,7 @@ class DbxActionSnackbarDirective {
         const snackbarFunction = this.dbxActionSnackbar();
         return snackbarFunction ? snackbarFunction(input) : this.dbxActionSnackbarService.generateDisplayConfig(this.dbxActionSnackbarDefault(), input);
     }
-    showSnackbarForConfiguration(config, event) {
+    showSnackbarForConfiguration(config, _event) {
         this.dbxActionSnackbarService.openSnackbar(config);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxActionSnackbarDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
@@ -6280,18 +6341,16 @@ class DbxActionTransitionSafetyDirective {
     _autoTrigger(transition) {
         return this.source.pipeStore((store) => store.state$.pipe(delay(20), // Prevent racing with auto-trigger.
         first(), mergeMap((state) => {
-            if (isIdleActionState(state.actionState)) {
-                // If we're in an idle state, get ready to trigger it.
-                if (canTriggerAction(state)) {
-                    store.trigger(); // Try and trigger it.
-                }
+            if (isIdleActionState(state.actionState) && // If we're in an idle state, get ready to trigger it.
+                canTriggerAction(state)) {
+                store.trigger(); // Try and trigger it.
             }
             // Watch for errors. If an error occurs, show the dialog.
             // Success will cause the race in _handleOnBeforeTransition() to trigger and close everything.
             return store.rejected$.pipe(first(), mergeMap(() => this._showDialog(transition)));
         })));
     }
-    _showDialog(transition) {
+    _showDialog(_transition) {
         if (this.checkIsDestroyed()) {
             return of(true);
         }
@@ -6401,7 +6460,7 @@ class DbxActionKeyTriggerDirective {
     source = inject((DbxActionContextStoreSourceInstance), { host: true });
     key = input(DEFAULT_ACTION_KEY_TRIGGER, { ...(ngDevMode ? { debugName: "key" } : {}), alias: 'dbxActionKeyTrigger', transform: (x) => (x ?? DEFAULT_ACTION_KEY_TRIGGER).toLowerCase() });
     onKeyupHandler(event) {
-        if (event.key && event.key.toLowerCase() === this.key()) {
+        if (event.key?.toLowerCase() === this.key()) {
             this.source.trigger();
         }
     }
@@ -6448,6 +6507,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
  * const pojoError = convertToPOJOServerErrorResponse(httpErrorResponse);
  * console.log(pojoError.message);
  * ```
+ *
+ * @param httpError - The HTTP error response or generic error object to convert.
+ * @returns A plain JSON-serializable {@link ServerError} object.
  */
 function convertToPOJOServerErrorResponse(httpError) {
     const result = convertToServerErrorResponse(httpError);
@@ -6459,7 +6521,7 @@ function convertToPOJOServerErrorResponse(httpError) {
                     const stringy = JSON.stringify(pojo.data);
                     x.data = JSON.parse(stringy);
                 }
-                catch (e) {
+                catch {
                     console.warn('convertToPOJOServerErrorResponse(): Non-serializable Error Data Detected. It is being removed.: ', pojo.data);
                     x.data = undefined;
                 }
@@ -6481,12 +6543,17 @@ function convertToPOJOServerErrorResponse(httpError) {
  *   console.log(serverError.status, serverError.message);
  * }
  * ```
+ *
+ * @param error - The HTTP error response or generic error object to convert.
+ * @returns A {@link ServerErrorResponse} derived from the error, or `undefined` if the input is falsy.
  */
 function convertToServerErrorResponse(error) {
     let result;
     if (error instanceof HttpErrorResponse) {
         const { status, error: data } = error;
         const code = data.code;
+        // statusText is deprecated with HTTP/2+ but still needed as a fallback for error messages
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
         const message = data.message ?? error.statusText;
         switch (status) {
             case 401:
@@ -6783,6 +6850,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
  * const params = convertServerErrorParams(httpErrorResponse);
  * store.dispatch(myErrorAction(params));
  * ```
+ *
+ * @param httpError - The HTTP error response or generic error object to convert.
+ * @returns A {@link ServerErrorParams} object wrapping the converted server error.
  */
 function convertServerErrorParams(httpError) {
     const error = convertToPOJOServerErrorResponse(httpError);
@@ -6800,6 +6870,10 @@ function convertServerErrorParams(httpError) {
  *   ))
  * );
  * ```
+ *
+ * @param action - The NgRx action creator to dispatch with the converted error params.
+ * @param mapError - Optional function to transform the {@link ServerErrorParams} before dispatching. Defaults to identity.
+ * @returns An RxJS operator that catches errors and emits the corresponding error action.
  */
 function catchErrorServerParams(action, mapError = (error) => error) {
     return catchError((error) => {
@@ -6854,6 +6928,7 @@ const reducer = createReducer(INITIAL_STATE$1, on(dbxModelResetState, () => INIT
 /**
  * @deprecated use STATE_FEATURE_KEY instead.
  */
+// eslint-disable-next-line @typescript-eslint/naming-convention
 const stateFeatureKey = STATE_FEATURE_KEY;
 /**
  * @deprecated use INITIAL_STATE instead.
@@ -6861,12 +6936,20 @@ const stateFeatureKey = STATE_FEATURE_KEY;
 const initialState = INITIAL_STATE$1;
 
 const FEATURE_KEY = 'app.model';
+/**
+ * Combined reducer for the DbxModel NgRx feature state, delegating to sub-reducers for each state slice.
+ *
+ * @param state The current DbxModel feature state, or undefined for initial state
+ * @param action The NgRx action to process
+ * @returns The new DbxModelState produced by the combined sub-reducers
+ */
 function reducers(state, action) {
     return combineReducers({
         [STATE_FEATURE_KEY]: reducer
     })(state, action);
 }
 // MARK: Context
+// eslint-disable-next-line @typescript-eslint/no-deprecated
 const selectDbxModelFeature = createFeatureSelector(FEATURE_KEY);
 // MARK: Module Config
 const selectDbxModelFeatureObjectModuleConfig = createSelector(selectDbxModelFeature, (state) => state[STATE_FEATURE_KEY]);
@@ -6874,6 +6957,7 @@ const selectDbxModelFeatureObjectModuleConfig = createSelector(selectDbxModelFea
 /**
  * @deprecated use FEATURE_KEY instead.
  */
+// eslint-disable-next-line @typescript-eslint/naming-convention
 const featureKey = FEATURE_KEY;
 
 var index = /*#__PURE__*/Object.freeze({
@@ -6933,6 +7017,7 @@ class DbxModelViewTrackerStorage {
      * Returns all stored view events for the given folder.
      *
      * @param folder - Optional folder name; defaults to `'default'`
+     * @returns Observable of all view tracker events in the folder
      */
     getAllEvents(folder) {
         return this.getEventSet(folder).pipe(map((x) => x.e));
@@ -6941,13 +7026,14 @@ class DbxModelViewTrackerStorage {
      * Returns the complete event set for the given folder.
      *
      * @param folder - Optional folder name; defaults to `'default'`
+     * @returns Observable of the event set containing events and the last-update timestamp
      */
     getEventSet(folder) {
         const storageKey = this.getStorageKeyForFolder(folder);
         return this._getEventSetForStorageKey(storageKey);
     }
     _getEventSetForStorageKey(storageKey) {
-        return this.storageAccessor.get(storageKey).pipe(catchError((e) => {
+        return this.storageAccessor.get(storageKey).pipe(catchError(() => {
             return of(undefined);
         }), map((result) => result ?? { e: [], l: 0 }));
     }
@@ -6955,10 +7041,10 @@ class DbxModelViewTrackerStorage {
      * Computes the storage key for a given folder name.
      *
      * @param folder - Optional folder name; defaults to `'default'`
+     * @returns The computed storage key string combining the base key and folder name
      */
     getStorageKeyForFolder(folder) {
-        const storageKey = `${this.storageKey}_${folder ?? 'default'}`;
-        return storageKey;
+        return `${this.storageKey}_${folder ?? 'default'}`;
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxModelViewTrackerStorage, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
     static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxModelViewTrackerStorage });
@@ -6979,6 +7065,8 @@ class DbxModelTrackerService {
     newEvent$ = this._viewTrackerStorage.newEvent$;
     /**
      * The default storage folder used when no folder is specified in tracking calls.
+     *
+     * @returns The current default folder name, or undefined if not set
      */
     get defaultFolder() {
         return this._defaultFolder;
@@ -7008,6 +7096,7 @@ class DbxModelTrackerService {
      * Returns all recorded view events for the given folder, sorted by most recent first.
      *
      * @param folder - Storage folder; defaults to {@link defaultFolder}
+     * @returns Observable of view events sorted by most recent first
      */
     getAllViewEvents(folder = this._defaultFolder) {
         return this._viewTrackerStorage.getAllEvents(folder);
@@ -7016,6 +7105,7 @@ class DbxModelTrackerService {
      * Returns the complete event set (events and last-update timestamp) for the given folder.
      *
      * @param folder - Storage folder; defaults to {@link defaultFolder}
+     * @returns Observable of the complete event set including events and last-update timestamp
      */
     getViewEventSet(folder = this._defaultFolder) {
         return this._viewTrackerStorage.getEventSet(folder);
@@ -7053,6 +7143,10 @@ class DbxModelObjectStateService {
     store = inject((Store));
     /**
      * Emit a model viewed event.
+     *
+     * @param params - The model viewed event parameters
+     * @param params.modelKeyTypeNamePair - Identifies the model that was viewed
+     * @param params.context - Optional context describing how the model was viewed
      */
     emitModelViewEvent({ modelKeyTypeNamePair, context }) {
         this.store.dispatch(emitObjectViewEvent({ modelKeyTypeNamePair, context }));
@@ -7071,12 +7165,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
  * ```typescript
  * const accessor = defaultDbxModelViewTrackerStorageAccessorFactory(storageAccessorFactory);
  * ```
+ *
+ * @param storageAccessorFactory - The factory used to create typed storage accessors
+ * @returns A storage accessor configured with the `mtvs` prefix for model view tracker events
  */
 function defaultDbxModelViewTrackerStorageAccessorFactory(storageAccessorFactory) {
-    const accessor = storageAccessorFactory.createStorageAccessor({
+    return storageAccessorFactory.createStorageAccessor({
         prefix: 'mtvs'
     });
-    return accessor;
 }
 /**
  * Creates EnvironmentProviders for providing DbxModelTrackerService, DbxModelObjectStateService and sets up the NgRx store for DbxModelTrackerEffects.
@@ -7097,7 +7193,7 @@ function provideDbxModelService() {
         DbxModelObjectStateService,
         // NgRx
         provideEffects([DbxModelTrackerEffects]),
-        provideState(featureKey, reducers)
+        provideState(FEATURE_KEY, reducers)
     ];
     return makeEnvironmentProviders(providers);
 }
@@ -7109,6 +7205,9 @@ function provideDbxModelService() {
  * ```typescript
  * const keys = allDbxModelViewTrackerEventSetModelKeys(eventSet);
  * ```
+ *
+ * @param eventSet - The event set from which to extract model keys
+ * @returns Array of model keys from all events in the set
  */
 function allDbxModelViewTrackerEventSetModelKeys(eventSet) {
     return allDbxModelViewTrackerEventModelKeys(eventSet.e);
@@ -7120,6 +7219,9 @@ function allDbxModelViewTrackerEventSetModelKeys(eventSet) {
  * ```typescript
  * const keys = allDbxModelViewTrackerEventModelKeys(events);
  * ```
+ *
+ * @param events - Array of view tracker events from which to extract model keys
+ * @returns Array of model keys, one per event
  */
 function allDbxModelViewTrackerEventModelKeys(events) {
     return events.map((y) => y.m.key);
@@ -7200,6 +7302,7 @@ class DbxModelTypesService {
      * Returns an observable of the Material icon name for the given model type.
      *
      * @param type - The model type string to look up
+     * @returns Observable emitting the icon name for the given model type
      */
     iconForType(type) {
         return this.iconMap$.pipe(map((x) => x[type]));
@@ -7578,6 +7681,9 @@ const DBX_WEB_FILE_PREVIEW_SERVICE_ENTRIES_TOKEN = new InjectionToken('DefaultDb
 /**
  * Creates a provider that registers the given entries with the {@link DbxWebFilePreviewService} via the {@link DBX_WEB_FILE_PREVIEW_SERVICE_ENTRIES_TOKEN}.
  *
+ * @param entries - Array of preview service entries to register, each mapping a MIME type to its preview component
+ * @returns A provider configuration that supplies the entries via the injection token
+ *
  * @example
  * ```typescript
  * provideDbxWebFilePreviewServiceEntries([DBX_WEB_FILE_PREVIEW_SERVICE_ZIP_PRESET_ENTRY]);
@@ -7590,11 +7696,11 @@ function provideDbxWebFilePreviewServiceEntries(entries) {
     };
 }
 // MARK: Default Functions
-/**
- * Default preset for previewing a file using a DbxEmbedDialogComponent.
- */
 /**
  * Default preview component function that embeds files using {@link DbxEmbedComponent}. Images are rendered with an `img` element; all other types use `embed`.
+ *
+ * @param input - The preview input containing blob data, source URL, and MIME type information
+ * @returns An injection component config that initializes a {@link DbxEmbedComponent} with the appropriate embed element and content
  */
 const DBX_WEB_FILE_PREVIEW_SERVICE_DEFAULT_PREVIEW_COMPONENT_FUNCTION = (input) => {
     const { blob, srcUrl, embedMimeType, sanitizeSrcUrl } = input;
@@ -7622,6 +7728,9 @@ const DBX_WEB_FILE_PREVIEW_SERVICE_DEFAULT_PREVIEW_COMPONENT_FUNCTION = (input)
 };
 /**
  * Default dialog-with-component function that opens the preview component inside a {@link DbxInjectionDialogComponent} with a close button.
+ *
+ * @param input - The dialog input containing the MatDialog instance and the component config to display
+ * @returns A MatDialogRef for the opened injection dialog
  */
 const DBX_WEB_FILE_PREVIEW_SERVICE_DEFAULT_DIALOG_WITH_COMPONENT_FUNCTION = (input) => {
     const { matDialog, componentConfig } = input;
@@ -7637,7 +7746,8 @@ const DBX_WEB_FILE_PREVIEW_SERVICE_DEFAULT_DIALOG_WITH_COMPONENT_FUNCTION = (inp
 class DbxWebFilePreviewService {
     matDialog = inject(MatDialog);
     _entries = new Map();
-    constructor(entries) {
+    constructor() {
+        const entries = inject(DBX_WEB_FILE_PREVIEW_SERVICE_ENTRIES_TOKEN, { optional: true });
         if (entries) {
             entries.forEach((x) => this.registerPreviewEntry(x));
         }
@@ -7663,12 +7773,16 @@ class DbxWebFilePreviewService {
     }
     /**
      * Overrides the default preview component function used when no MIME-specific entry is registered.
+     *
+     * @param previewFunction - The preview component function to use as the new default
      */
     setDefaultPreviewComponentFunction(previewFunction) {
         this._defaultPreviewComponentFunction = previewFunction;
     }
     /**
      * Overrides the default dialog-with-component function used when no MIME-specific dialog handler is registered.
+     *
+     * @param previewDialogWithComponentFunction - The dialog-with-component function to use as the new default
      */
     setDefaultPreviewDialogWithComponentFunction(previewDialogWithComponentFunction) {
         this._defaultPreviewDialogWithComponentFunction = previewDialogWithComponentFunction;
@@ -7678,6 +7792,7 @@ class DbxWebFilePreviewService {
      * Creates an injection component config for previewing a file. Uses a MIME-specific preview function if registered, otherwise falls back to the default.
      *
      * @param input - The preview input containing blob, URL, and MIME type information
+     * @returns An injection component config suitable for rendering the file preview
      */
     createPreviewConfig(input) {
         const { embedMimeType } = input;
@@ -7710,7 +7825,7 @@ class DbxWebFilePreviewService {
         }
         return matDialogRef;
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxWebFilePreviewService, deps: [{ token: DBX_WEB_FILE_PREVIEW_SERVICE_ENTRIES_TOKEN, optional: true }], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxWebFilePreviewService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
     static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxWebFilePreviewService, providedIn: 'root' });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxWebFilePreviewService, decorators: [{
@@ -7718,12 +7833,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
             args: [{
                     providedIn: 'root'
                 }]
-        }], ctorParameters: () => [{ type: undefined, decorators: [{
-                    type: Optional
-                }, {
-                    type: Inject,
-                    args: [DBX_WEB_FILE_PREVIEW_SERVICE_ENTRIES_TOKEN]
-                }] }] });
+        }], ctorParameters: () => [] });
 
 /**
  * Previews a file by delegating to the {@link DbxWebFilePreviewService} to resolve the appropriate preview component for the given MIME type.
@@ -7738,6 +7848,7 @@ class DbxWebFilePreviewComponent {
     config = input(...(ngDevMode ? [undefined, { debugName: "config" }] : []));
     componentConfigSignal = computed(() => {
         const config = this.config();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- any required for contravariant init callback compatibility
         let componentConfig;
         if (config) {
             componentConfig = this.webFilePreviewService.createPreviewConfig(config);
@@ -7765,6 +7876,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
 /**
  * Builds a directory tree from an array of zip archive entries, enriching each node with MIME type detection and blob retrieval capability.
  *
+ * @param entries - Array of zip archive entries to build the tree from, or null/undefined for an empty tree
+ * @returns The root node of the constructed directory tree with MIME types and blob getters attached
+ *
  * @example
  * ```typescript
  * const root = dbxZipBlobPreviewEntryTreeFromEntries(zipEntries);
@@ -7806,12 +7920,19 @@ const SCREEN_MEDIA_WIDTH_TYPE_SIZE_MAP = {
  * screenMediaWidthTypeIsActive('tablet', 'small'); // true
  * screenMediaWidthTypeIsActive('micro', 'tablet'); // false
  * ```
+ *
+ * @returns `true` if the current width type meets or exceeds the breakpoint
  */
 function screenMediaWidthTypeIsActive(current, breakpoint) {
     return compareScreenMediaWidthTypes(current, breakpoint, (a, b) => a >= b);
 }
 /**
  * Compares two {@link ScreenMediaWidthType} values using a custom comparator on their numeric sizes.
+ *
+ * @param a - the first screen width type
+ * @param b - the second screen width type
+ * @param compare - a comparator function applied to the numeric size values of `a` and `b`
+ * @returns the result of applying the comparator to the mapped numeric sizes
  */
 function compareScreenMediaWidthTypes(a, b, compare) {
     return compare(SCREEN_MEDIA_WIDTH_TYPE_SIZE_MAP[a], SCREEN_MEDIA_WIDTH_TYPE_SIZE_MAP[b]);
@@ -7858,8 +7979,8 @@ class DbxScreenMediaService {
     _updateHeight = new Subject();
     widthType$ = this._updateWidth.pipe(initialize(() => this._updateWidth.next()), throttleTime(100, undefined, { leading: true, trailing: true }), map(() => this._readWidthType()), distinctUntilChanged(), shareReplay(1));
     heightType$ = this._updateWidth.pipe(initialize(() => this._updateHeight.next()), throttleTime(100, undefined, { leading: true, trailing: true }), map(() => this._readHeightType()), distinctUntilChanged(), shareReplay(1));
-    constructor(config) {
-        const { microScreenWidthMax, smallScreenWidthMax, tabletScreenWidthMax, largeScreenWidthMax } = config;
+    constructor() {
+        const { microScreenWidthMax, smallScreenWidthMax, tabletScreenWidthMax, largeScreenWidthMax } = inject(DbxScreenMediaServiceConfig);
         this._microQuery = this._media.matchMedia(`screen and (max-width:${microScreenWidthMax}px)`);
         this._smallQuery = this._media.matchMedia(`screen and (max-width:${smallScreenWidthMax}px)`);
         this._tabletQuery = this._media.matchMedia(`screen and (max-width:${tabletScreenWidthMax}px)`);
@@ -7917,15 +8038,12 @@ class DbxScreenMediaService {
             return 'normal';
         }
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxScreenMediaService, deps: [{ token: DbxScreenMediaServiceConfig }], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxScreenMediaService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
     static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxScreenMediaService });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxScreenMediaService, decorators: [{
             type: Injectable
-        }], ctorParameters: () => [{ type: DbxScreenMediaServiceConfig, decorators: [{
-                    type: Inject,
-                    args: [DbxScreenMediaServiceConfig]
-                }] }] });
+        }], ctorParameters: () => [] });
 
 /**
  * Calculates and applies a dynamic height to a Material expansion panel header based on text content.
@@ -8069,8 +8187,7 @@ class DbxAvatarViewComponent {
     avatarIcon = input(...(ngDevMode ? [undefined, { debugName: "avatarIcon" }] : []));
     avatarHideOnError = input(...(ngDevMode ? [undefined, { debugName: "avatarHideOnError" }] : []));
     avatarHideOnErrorSignal = computed(() => {
-        const hideOnError = this.avatarHideOnError() ?? this.defaultContext?.hideOnError ?? false;
-        return hideOnError;
+        return this.avatarHideOnError() ?? this.defaultContext?.hideOnError ?? false;
     }, ...(ngDevMode ? [{ debugName: "avatarHideOnErrorSignal" }] : []));
     currentAvatarUrlSignal = computed(() => {
         const directUrl = this.avatarUrl();
@@ -8206,6 +8323,9 @@ class DbxAvatarViewService {
      * Resolves the injection component configuration for the given avatar context.
      *
      * Falls back to the default component config if no custom resolver is configured or if it returns null.
+     *
+     * @param context - the avatar context used to resolve the appropriate component configuration
+     * @returns the resolved injection component config, or the default if no custom resolver matches
      */
     avatarComponentForContext(context) {
         let config = this._defaultAvatarComponentConfig;
@@ -8223,19 +8343,35 @@ class DbxAvatarViewService {
     get defaultAvatarErrorIcon() {
         return this._defaultAvatarErrorIcon;
     }
-    /** Sets the default avatar image URL used when no context-specific URL is provided. */
+    /**
+     * Sets the default avatar image URL used when no context-specific URL is provided.
+     *
+     * @param url - the URL to use as the default avatar image, or nullish to clear
+     */
     setDefaultAvatarUrl(url) {
         this._defaultAvatarUrl = url;
     }
-    /** Sets the default Material icon name used as a fallback when no avatar image is available. */
+    /**
+     * Sets the default Material icon name used as a fallback when no avatar image is available.
+     *
+     * @param icon - the Material icon name to use, or nullish to clear
+     */
     setDefaultAvatarIcon(icon) {
         this._defaultAvatarIcon = icon;
     }
-    /** Sets the Material icon name displayed when the avatar image fails to load. */
+    /**
+     * Sets the Material icon name displayed when the avatar image fails to load.
+     *
+     * @param icon - the Material icon name to display on image load error, or nullish to clear
+     */
     setDefaultAvatarErrorIcon(icon) {
         this._defaultAvatarErrorIcon = icon;
     }
-    /** Overrides the default component used to render avatars when no context-specific component is resolved. */
+    /**
+     * Overrides the default component used to render avatars when no context-specific component is resolved.
+     *
+     * @param config - the injection component config to use as the new default
+     */
     setDefaultAvatarComponentConfig(config) {
         this._defaultAvatarComponentConfig = config;
     }
@@ -8286,7 +8422,7 @@ class DbxAvatarComponent {
         const icon = this.avatarIcon() ?? inputContext?.icon;
         const style = this.avatarStyle() ?? inputContext?.style;
         const hideOnError = this.avatarHideOnError() ?? inputContext?.hideOnError;
-        const context = {
+        return {
             selector,
             uid,
             url,
@@ -8295,7 +8431,6 @@ class DbxAvatarComponent {
             style,
             hideOnError
         };
-        return context;
     }, ...(ngDevMode ? [{ debugName: "contextSignal" }] : []));
     configSignal = computed(() => {
         const context = this.contextSignal();
@@ -8689,8 +8824,7 @@ class TwoColumnsContextStore extends ComponentStore {
          * The right side is less-than or equal to half the total width when resizing, so we can use the total width to guess the best case current scenario.
          */
         const expectedRightWidth = (x.totalWidth ?? 0) / 2;
-        const hideLeft = x.showRight && expectedRightWidth < x.minRightWidth;
-        return hideLeft;
+        return x.showRight && expectedRightWidth < x.minRightWidth;
     }));
     /**
      * Pipes the current state of reverseSizing.
@@ -8787,6 +8921,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
  * })
  * export class MyColumnLayoutComponent { }
  * ```
+ *
+ * @returns an array of Angular providers that supply a new {@link TwoColumnsContextStore}
  */
 function provideTwoColumnsContext() {
     return [
@@ -8848,7 +8984,7 @@ class DbxTwoColumnComponent {
             this.twoColumnsContextStore.setHasRight(true);
         }
     }, ...(ngDevMode ? [{ debugName: "_hasRightContentEffect" }] : []));
-    viewResized(event) {
+    viewResized(_event) {
         const totalWidth = this._elementRef.nativeElement.clientWidth;
         this.twoColumnsContextStore.setTotalWidth(totalWidth);
     }
@@ -9263,6 +9399,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
  */
 class DbxAnchorContentComponent {
     parent = inject(DbxAnchorComponent, { optional: true });
+    // eslint-disable-next-line @angular-eslint/no-input-rename
     inputAnchor = input(undefined, { ...(ngDevMode ? { debugName: "inputAnchor" } : {}), alias: 'anchor' });
     _inputAnchor = toObservable(this.inputAnchor);
     _parentAnchor = this.parent ? this.parent.anchor$ : of(undefined);
@@ -9362,6 +9499,9 @@ class DbxValueListItemModifier {
  * })
  * export class MyModifierDirective extends DbxValueListItemModifier<MyItem> { ... }
  * ```
+ *
+ * @param sourceType - the directive class to register as the DbxValueListItemModifier provider
+ * @returns an array of Angular providers that wire up the directive as a DbxValueListItemModifier
  */
 function provideDbxValueListViewModifier(sourceType) {
     return [
@@ -9380,6 +9520,10 @@ function provideDbxValueListViewModifier(sourceType) {
  *   item.selected = item.itemValue.isImportant;
  * });
  * ```
+ *
+ * @param key - a unique string identifier for this modifier in the modifier map
+ * @param modify - the function that mutates list item properties during rendering
+ * @returns a new ListItemModifier with the given key and modification function
  */
 function listItemModifier(key, modify) {
     return modifier(key, modify);
@@ -9633,6 +9777,8 @@ class DbxSidenavComponent extends AbstractTransitionWatcherDirective {
             case 'full':
                 mode = SideNavDisplayMode.FULL;
                 break;
+            default:
+                break;
         }
         return mode;
     }), distinctUntilChanged(), shareReplay(1));
@@ -9652,6 +9798,8 @@ class DbxSidenavComponent extends AbstractTransitionWatcherDirective {
                 drawer = 'side';
                 open = true; // always show
                 break;
+            default:
+                break;
         }
         return {
             mode,
@@ -9691,6 +9839,8 @@ class DbxSidenavComponent extends AbstractTransitionWatcherDirective {
                 case SideNavDisplayMode.FULL:
                     // Do nothing. Should be always open.
                     break;
+                default:
+                    break;
             }
         }
         else {
@@ -9698,10 +9848,10 @@ class DbxSidenavComponent extends AbstractTransitionWatcherDirective {
         }
         if (open != null) {
             if (open) {
-                this.sidenav().open();
+                void this.sidenav().open();
             }
             else {
-                this.sidenav().close();
+                void this.sidenav().close();
             }
         }
     }
@@ -10001,6 +10151,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
  *   providers: [provideDbxRouterWebAngularRouterProviderConfig()]
  * });
  * ```
+ *
+ * @returns environment providers that configure the Angular Router-based segue anchor component
  */
 function provideDbxRouterWebAngularRouterProviderConfig() {
     const config = {
@@ -10052,6 +10204,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
  *   providers: [provideDbxRouterWebUiRouterProviderConfig()]
  * });
  * ```
+ *
+ * @returns environment providers that configure the UIRouter-based segue anchor component
  */
 function provideDbxRouterWebUiRouterProviderConfig() {
     const config = {
@@ -10736,6 +10890,9 @@ class DbxListView {
  * })
  * export class MyCustomListViewComponent extends DbxListView<MyItem> { ... }
  * ```
+ *
+ * @param sourceType - the component class to register as the DbxListView provider
+ * @returns an array of Angular providers that wire up the component as a DbxListView
  */
 // eslint-disable-next-line
 function provideDbxListView(sourceType) {
@@ -10754,6 +10911,7 @@ function provideDbxListView(sourceType) {
 const DBX_VALUE_LIST_VIEW_ITEM = new InjectionToken('DbxValueListViewItem');
 /**
  * Convenience function for mapping a DecisionFunction for a value to a DecisionFunction for a DbxValueListItem with the same value type.
+ *
  * @param decisionFunction
  * @returns
  */
@@ -10762,11 +10920,18 @@ function dbxValueListItemDecisionFunction(decisionFunction) {
 }
 /**
  * Default mapping function that wraps each raw value into a {@link DbxValueListItem} with only the `itemValue` property set.
+ *
+ * @param itemValues The raw values to wrap as list items
+ * @returns An observable emitting the values wrapped in {@link DbxValueListItem} objects
  */
 const DEFAULT_DBX_VALUE_LIST_CONFIG_MAP_VALUES = (itemValues) => of(itemValues.map((itemValue) => ({ itemValue })));
 /**
  * Maps raw values into an observable of {@link DbxValueListItemConfig} items, applying the list view config's mapping function and attaching injection configuration.
  *
+ * @param listViewConfig The list view configuration containing the component and optional mapping function
+ * @param itemValues The raw values to map into configured list items
+ * @returns An observable emitting the mapped and configured list item configs
+ *
  * @example
  * ```ts
  * const items$ = mapValuesToValuesListItemConfigObs(listViewConfig, rawValues);
@@ -10780,11 +10945,11 @@ function mapValuesToValuesListItemConfigObs(listViewConfig, itemValues) {
     }));
 }
 /**
- * Adds config to the input value list items.
+ * Adds injection component configuration and meta configuration to each list item, producing fully configured {@link DbxValueListItemConfig} entries ready for rendering.
  *
- * @param listViewConfig
- * @param listItems
- * @returns
+ * @param listViewConfig The list view configuration providing injection component config and optional meta config
+ * @param listItems The list items to augment with configuration
+ * @returns The list items extended with injection component configuration attached
  */
 function addConfigToValueListItems(listViewConfig, listItems) {
     const itemConfigs = listItems.map((listItem) => {
@@ -10825,6 +10990,9 @@ class DbxValueListView {
 /**
  * Registers a component as a {@link DbxValueListView} provider for dependency injection.
  *
+ * @param sourceType The component class type to register as the list view provider
+ * @returns An array of Angular providers that bind the given component to {@link DbxValueListView}
+ *
  * @example
  * ```ts
  * @Component({
@@ -10866,6 +11034,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
 
 /**
  * Default grouping function that places all items into a single unnamed group.
+ *
+ * @param items The flat list of configured list items to group
+ * @returns An array containing a single group with all input items
  */
 const defaultDbxValueListViewGroupValuesFunction = (items) => {
     const data = {};
@@ -10885,20 +11056,24 @@ class DbxValueListViewGroupDelegate {
 /**
  * Creates a default {@link DbxValueListViewGroupDelegate} that places all items into a single ungrouped list.
  *
+ * @returns A group delegate that places all items into one unnamed group
+ *
  * @example
  * ```ts
  * const delegate = defaultDbxValueListViewGroupDelegate<MyItem>();
  * ```
  */
 function defaultDbxValueListViewGroupDelegate() {
-    const result = {
+    return {
         groupValues: defaultDbxValueListViewGroupValuesFunction
     };
-    return result;
 }
 /**
  * Registers a class as a {@link DbxValueListViewGroupDelegate} provider for dependency injection.
  *
+ * @param sourceType The class type to register as the group delegate provider
+ * @returns An array of Angular providers that bind the given class to {@link DbxValueListViewGroupDelegate}
+ *
  * @example
  * ```ts
  * @Directive({
@@ -10907,7 +11082,7 @@ function defaultDbxValueListViewGroupDelegate() {
  * export class MyGroupDelegate extends DbxValueListViewGroupDelegate<MyGroup, MyItem> { ... }
  * ```
  */
-// eslint-disable-next-line
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- generic provider factory requires any for type compatibility
 function provideDbxValueListViewGroupDelegate(sourceType) {
     // use of any here is allowed as typings are not relevant for providers
     return [
@@ -10954,7 +11129,7 @@ class DbxValueListViewContentGroupComponent {
       }
       @for (item of itemsSignal(); track trackByFunctionSignal()($index, item)) {
         <dbx-anchor [anchor]="item.anchor" [disabled]="item.disabled">
-          <a mat-list-item class="dbx-list-view-item" [disabled]="item.disabled" [disableRipple]="rippleDisabledOnItem(item)" (click)="onClickItem(item)">
+          <a mat-list-item class="dbx-list-view-item" [disabled]="item.disabled" [disableRipple]="rippleDisabledOnItem(item)" (click)="onClickItem(item)" (keydown.enter)="onClickItem(item)">
             @if (item.icon) {
               <mat-icon matListItemIcon>{{ item.icon }}</mat-icon>
             }
@@ -10988,7 +11163,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
       }
       @for (item of itemsSignal(); track trackByFunctionSignal()($index, item)) {
         <dbx-anchor [anchor]="item.anchor" [disabled]="item.disabled">
-          <a mat-list-item class="dbx-list-view-item" [disabled]="item.disabled" [disableRipple]="rippleDisabledOnItem(item)" (click)="onClickItem(item)">
+          <a mat-list-item class="dbx-list-view-item" [disabled]="item.disabled" [disableRipple]="rippleDisabledOnItem(item)" (click)="onClickItem(item)" (keydown.enter)="onClickItem(item)">
             @if (item.icon) {
               <mat-icon matListItemIcon>{{ item.icon }}</mat-icon>
             }
@@ -11023,6 +11198,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
  *
  * Uses the item's {@link DbxValueListItem.key} when available for stable identity across
  * data updates, falling back to a prefixed index string to avoid collisions with key values.
+ *
+ * @param index - the item's position index in the list
+ * @param item - the list item whose identity key is resolved
+ * @returns the item's key, itemValue key/id, or a prefixed index string as a fallback
  */
 const DEFAULT_VALUE_LIST_VIEW_CONTENT_COMPONENT_TRACK_BY_FUNCTION = (index, item) => item?.key ?? item?.itemValue?.key ?? item?.itemValue?.id ?? `__list__${index}__`;
 /**
@@ -11036,21 +11215,21 @@ const DEFAULT_VALUE_LIST_VIEW_CONTENT_COMPONENT_TRACK_BY_FUNCTION = (index, item
  */
 class DbxValueListViewContentComponent {
     dbxListView = inject((DbxListView));
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- any required for generic group delegate compatibility
     _dbxListGroupDelegate = inject(DbxValueListViewGroupDelegate, { optional: true }) ?? defaultDbxValueListViewGroupDelegate();
     _trackBy$ = this.dbxListView.trackBy$ ?? of(undefined);
     trackBy$ = this._trackBy$.pipe(map((trackBy) => (trackBy ? (index, item) => trackBy(index, item.itemValue) : DEFAULT_VALUE_LIST_VIEW_CONTENT_COMPONENT_TRACK_BY_FUNCTION)));
     items = input(...(ngDevMode ? [undefined, { debugName: "items" }] : []));
     emitAllClicks = input(...(ngDevMode ? [undefined, { debugName: "emitAllClicks" }] : []));
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- any required for generic group type compatibility
     groups$ = toObservable(this.items).pipe(switchMap((items) => asObservable(this._dbxListGroupDelegate.groupValues(items ?? []))), shareReplay(1));
     groupsSignal = toSignal(this.groups$);
     disabledSignal = toSignal(this.dbxListView.disabled$);
     onClickItem(item) {
         // do not emit clicks for disabled items.
-        if (!item.disabled) {
-            if (this.emitAllClicks() || !item.anchor || anchorTypeForAnchor(item.anchor) === 'plain') {
-                // only emit clicks for items with no anchor, or plain anchors.
-                this.onClickValue(item.itemValue);
-            }
+        if (!item.disabled && (this.emitAllClicks() || !item.anchor || anchorTypeForAnchor(item.anchor) === 'plain')) {
+            // only emit clicks for items with no anchor, or plain anchors.
+            this.onClickValue(item.itemValue);
         }
     }
     onClickValue(value) {
@@ -11361,6 +11540,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
 /**
  * @deprecated use DBX_LIST_ACCORDION_VIEW_COMPONENT_IMPORTS_AND_EXPORTS instead.
  */
+// eslint-disable-next-line @typescript-eslint/naming-convention
 const dbxListAccordionViewComponentImportsAndExports = DBX_LIST_ACCORDION_VIEW_COMPONENT_IMPORTS_AND_EXPORTS;
 
 /**
@@ -11486,6 +11666,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
  */
 class DbxValueListGridViewContentComponent extends DbxValueListViewContentComponent {
     _gridSizeOverride = inject(DbxValueListGridSizeDirective, { optional: true });
+    // eslint-disable-next-line @angular-eslint/no-input-rename
     inputGridConfig = input(undefined, { ...(ngDevMode ? { debugName: "inputGridConfig" } : {}), alias: 'grid' });
     gridConfigFromGridSizeSignal = toSignal(this._gridSizeOverride?.gridSize$ ?? of(undefined));
     gridConfigSignal = computed(() => {
@@ -11578,6 +11759,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
 /**
  * @deprecated use DBX_LIST_GRID_VIEW_COMPONENT_IMPORTS_AND_EXPORTS instead.
  */
+// eslint-disable-next-line @typescript-eslint/naming-convention
 const dbxListGridViewComponentImportsAndExports = DBX_LIST_GRID_VIEW_COMPONENT_IMPORTS_AND_EXPORTS;
 
 /**
@@ -11714,7 +11896,7 @@ class DbxListTitleGroupDirective {
                 const cssClassesForAllGroups = inputCssClasses ?? [];
                 const componentClass = delegate.headerComponentClass ?? DbxListTitleGroupHeaderComponent;
                 const { dataForGroupValue, footerComponentClass } = delegate;
-                groups = Array.from(groupsValuesMap.entries()).map(([value, items]) => {
+                groups = [...groupsValuesMap.entries()].map(([value, items]) => {
                     const data = dataForGroupValue(value, items);
                     data.value = value;
                     const cssClasses = data.cssClasses ? [...cssClassesForAllGroups, ...data.cssClasses] : cssClassesForAllGroups;
@@ -11769,6 +11951,9 @@ const DBX_LIST_ITEM_DISABLE_RIPPLE_LIST_ITEM_MODIFIER_KEY = 'disable_ripple_anch
 /**
  * Default decision function that disables ripple on items that already have ripple disabled,
  * lack an anchor, or have an anchor with no navigation target.
+ *
+ * @param item - the list item to evaluate for ripple disabling
+ * @returns `true` if the ripple should be disabled for this item
  */
 const DBX_LIST_ITEM_DEFAULT_DISABLE_FUNCTION = (item) => {
     return item.rippleDisabled || !item.anchor || (!item.anchor.ref && !item.anchor.url && !item.anchor.onClick);
@@ -11816,6 +12001,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
 const DBX_LIST_ITEM_IS_SELECTED_ITEM_MODIFIER_KEY = 'is_selected_item_modifier';
 /**
  * Default decision function that returns the item's current `selected` state (defaulting to false).
+ *
+ * @param item - the list item to check for selection
+ * @returns `true` if the item is currently selected, `false` otherwise
  */
 const DEFAULT_DBX_LIST_ITEM_IS_SELECTED_FUNCTION = (item) => {
     return item.selected ?? false;
@@ -12089,7 +12277,9 @@ class DbxListComponent {
                 const { scrollTop, scrollHeight, clientHeight } = element;
                 return scrollHeight - (scrollTop + clientHeight);
             }
-            catch (e) { }
+            catch {
+                /* ignored */
+            }
         }
         return 0;
     }
@@ -12099,7 +12289,7 @@ class DbxListComponent {
             try {
                 element.scrollTop = element.scrollHeight;
             }
-            catch (err) {
+            catch {
                 // do nothing.
             }
         }
@@ -12111,7 +12301,7 @@ class DbxListComponent {
                 const { scrollHeight, clientHeight } = element;
                 element.scrollTop = scrollHeight - (clientHeight + pos);
             }
-            catch (err) {
+            catch {
                 // do nothing.
             }
         }
@@ -12194,6 +12384,7 @@ class AbstractDbxListWrapperDirective {
     currentState$ = combineLatest([this._stateOverride, toObservable(this.state)]).pipe(map(([stateOverride, state]) => stateOverride ?? state), maybeValueFromObservableOrValue(), shareReplay(1));
     config$ = this._config.pipe(maybeValueFromObservableOrValue(), map((x) => (x ? this._buildListConfig(x) : undefined)), shareReplay(1));
     configSignal = toSignal(this.config$);
+    // eslint-disable-next-line @angular-eslint/prefer-inject
     constructor(initConfig) {
         this._config.next(initConfig);
     }
@@ -12275,6 +12466,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
 
 /**
  * Angular {@link TrackByFunction} that tracks {@link UniqueModel} items by their `id` property.
+ *
+ * @param index - the item's index in the iterable
+ * @param model - the model whose `id` is used as the tracking identity
+ * @returns the model's unique `id` value
  */
 const TRACK_BY_MODEL_ID = (index, model) => model.id;
 /**
@@ -12284,12 +12479,18 @@ const TRACK_BY_MODEL_ID = (index, model) => model.id;
  * ```ts
  * readonly trackBy = trackByUniqueIdentifier<MyModel>();
  * ```
+ *
+ * @returns a TrackByFunction that uses the item's `id` for identity tracking
  */
 function trackByUniqueIdentifier() {
     return TRACK_BY_MODEL_ID;
 }
 /**
  * Angular {@link TrackByFunction} that tracks {@link ModelKeyRef} items by their `key` property.
+ *
+ * @param index - the item's index in the iterable
+ * @param model - the model whose `key` is used as the tracking identity
+ * @returns the model's `key` value
  */
 const TRACK_BY_MODEL_KEY = (index, model) => model.key;
 /**
@@ -12299,6 +12500,8 @@ const TRACK_BY_MODEL_KEY = (index, model) => model.key;
  * ```ts
  * readonly trackBy = trackByModelKeyRef<MyModelRef>();
  * ```
+ *
+ * @returns a TrackByFunction that uses the item's `key` for identity tracking
  */
 function trackByModelKeyRef() {
     return TRACK_BY_MODEL_KEY;
@@ -12509,6 +12712,9 @@ class DbxListViewWrapper {
  * })
  * export class MyListWrapperComponent extends DbxListViewWrapper<MyItem> { ... }
  * ```
+ *
+ * @param sourceType - the component class to register as the DbxListViewWrapper provider
+ * @returns an array of Angular providers that wire up the component as a DbxListViewWrapper
  */
 function provideDbxListViewWrapper(sourceType) {
     return [
@@ -12908,6 +13114,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
  * ```ts
  * provideDbxStyleService({ dbxStyleConfig: { style: 'my-app', suffixes: new Set(['dark']) } });
  * ```
+ *
+ * @param config - configuration specifying the default style and its allowed suffixes
+ * @returns environment providers for the DbxStyleService and its default config token
  */
 function provideDbxStyleService(config) {
     const { dbxStyleConfig } = config;
@@ -13201,18 +13410,26 @@ class DbxLinkifyService {
     // MARK: Get
     /**
      * Returns the default entry.
+     *
+     * @returns the default linkify service entry, or undefined if none is registered
      */
     getDefaultEntry() {
         return this._entries.get(DEFAULT_DBX_LINKIFY_STRING_TYPE);
     }
     /**
      * Returns the entry for the given type.
+     *
+     * @param type - the linkify string type to look up
+     * @returns the registered entry for the given type, or undefined if not found
      */
     getEntryRegisteredForType(type) {
         return this._entries.get(type);
     }
     /**
      * Returns the entry for the given type, or the default type if there is no entry registered or the input type is null/undefined.
+     *
+     * @param type - the linkify string type to look up, or nullish to retrieve the default entry
+     * @returns the matching entry, or the default entry if the type is not provided
      */
     getEntry(type) {
         return type ? this._entries.get(type) : this.getDefaultEntry();
@@ -13292,6 +13509,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
  *   })
  * });
  * ```
+ *
+ * @param config - configuration containing the factory function for creating the linkify service config
+ * @returns environment providers that register the DbxLinkifyServiceConfig
  */
 function provideDbxLinkify(config) {
     const { dbxLinkifyServiceConfigFactory } = config;
@@ -13329,6 +13549,7 @@ class DbxChipDirective {
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxChipDirective, decorators: [{
             type: Directive,
             args: [{
+                    // eslint-disable-next-line @angular-eslint/directive-selector
                     selector: 'dbx-chip',
                     host: {
                         class: 'dbx-chip mat-standard-chip',
@@ -13515,7 +13736,7 @@ class DbxClickToCopyTextDirective extends AbstractDbxClipboardDirective {
             copyText = (element ?? eventElement)?.textContent ?? undefined;
         }
         if (copyText) {
-            this._copyToClipboard(copyText);
+            void this._copyToClipboard(copyText);
         }
         return copyText;
     }
@@ -13609,19 +13830,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
 
 class DbxLayoutModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxLayoutModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
-    static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "21.2.0", ngImport: i0, type: DbxLayoutModule, exports: [DbxBarLayoutModule, DbxCardBoxLayoutModule, DbxColumnLayoutModule, DbxCompactLayoutModule, DbxContentLayoutModule, DbxFlagLayoutModule, DbxFlexLayoutModule, DbxSectionLayoutModule, DbxStyleLayoutModule, DbxTextModule] });
-    static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxLayoutModule, imports: [DbxBarLayoutModule, DbxCardBoxLayoutModule, DbxColumnLayoutModule, DbxCompactLayoutModule, DbxContentLayoutModule, DbxFlagLayoutModule, DbxFlexLayoutModule, DbxSectionLayoutModule, DbxStyleLayoutModule, DbxTextModule] });
+    static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "21.2.0", ngImport: i0, type: DbxLayoutModule, imports: [DbxCompactDirective, DbxFlexGroupDirective, DbxFlexSizeDirective], exports: [DbxBarLayoutModule, DbxCardBoxLayoutModule, DbxColumnLayoutModule, DbxCompactDirective, DbxContentLayoutModule, DbxFlagLayoutModule, DbxFlexGroupDirective, DbxFlexSizeDirective, DbxSectionLayoutModule, DbxStyleLayoutModule, DbxTextModule] });
+    static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxLayoutModule, imports: [DbxBarLayoutModule, DbxCardBoxLayoutModule, DbxColumnLayoutModule, DbxContentLayoutModule, DbxFlagLayoutModule, DbxSectionLayoutModule, DbxStyleLayoutModule, DbxTextModule] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxLayoutModule, decorators: [{
             type: NgModule,
             args: [{
-                    exports: [DbxBarLayoutModule, DbxCardBoxLayoutModule, DbxColumnLayoutModule, DbxCompactLayoutModule, DbxContentLayoutModule, DbxFlagLayoutModule, DbxFlexLayoutModule, DbxSectionLayoutModule, DbxStyleLayoutModule, DbxTextModule]
+                    imports: [DbxCompactDirective, DbxFlexGroupDirective, DbxFlexSizeDirective],
+                    exports: [DbxBarLayoutModule, DbxCardBoxLayoutModule, DbxColumnLayoutModule, DbxCompactDirective, DbxContentLayoutModule, DbxFlagLayoutModule, DbxFlexGroupDirective, DbxFlexSizeDirective, DbxSectionLayoutModule, DbxStyleLayoutModule, DbxTextModule]
                 }]
         }] });
 
 /**
  * Returns the appropriate Material icon name for a zip entry tree node: "folder" for directories, "note" for files with a known MIME type, or "question_mark" for unknown files.
  *
+ * @param entry - The zip entry tree node to determine the icon for
+ * @returns The Material icon name: "folder", "note", or "question_mark"
+ *
  * @example
  * ```typescript
  * const icon = iconForDbxZipPreviewEntryWithSelection(treeNode); // 'folder', 'note', or 'question_mark'
@@ -13869,7 +14094,7 @@ class DbxZipBlobPreviewComponent {
         return selectedNode?.value.value.directory ? undefined : selectedNode;
     }, ...(ngDevMode ? [{ debugName: "selectedFileNodeSignal" }] : []));
     selectedFileEntry$ = toObservable(this.selectedFileNodeSignal);
-    selectedFileEntryBlob$ = this.selectedFileEntry$.pipe(switchMap((x) => (x && x.value.getBlob ? x.value.getBlob() : of(undefined))), shareReplay(1));
+    selectedFileEntryBlob$ = this.selectedFileEntry$.pipe(switchMap((x) => (x?.value.getBlob ? x.value.getBlob() : of(undefined))), shareReplay(1));
     selectedFileEntryBlobSignal = toSignal(this.selectedFileEntryBlob$);
     context = cleanLoadingContext({ obs: this.allEntriesLoadingState$ });
     makeEntryAnchor = (itemValue) => {
@@ -13990,6 +14215,9 @@ function openZipPreviewDialog(matDialog, config) {
 // MARK: Zip
 /**
  * Preview component function preset that renders zip files using {@link DbxZipPreviewComponent}.
+ *
+ * @param input - The preview input containing the source URL and MIME type of the zip file
+ * @returns An injection component config that initializes a {@link DbxZipPreviewComponent} with the given source URL
  */
 const DBX_WEB_FILE_PREVIEW_SERVICE_ZIP_COMPONENT_PRESET = (input) => {
     const { srcUrl } = input;
@@ -14096,8 +14324,9 @@ class DbxWidgetService {
     /**
      * Used to register an entry. If an entry with the same type is already registered, this will override it by default.
      *
-     * @param entry
-     * @param override
+     * @param entry - The widget entry mapping a type identifier to its component class
+     * @param override - Whether to replace an existing entry with the same type. Defaults to true.
+     * @returns True if the entry was registered, false if an entry with the same type already exists and override is false
      */
     register(entry, override = true) {
         if (override || !this._entries.has(entry.type)) {
@@ -14110,7 +14339,7 @@ class DbxWidgetService {
     }
     // MARK: Get
     getWidgetIdentifiers() {
-        return Array.from(this._entries.keys());
+        return [...this._entries.keys()];
     }
     getWidgetEntry(type) {
         return this._entries.get(type);
@@ -14313,11 +14542,11 @@ class DbxHelpContextService {
     /**
      * Observable of all currently active help context strings.
      */
-    activeHelpContextKeys$ = this._contextReferences.pipe(switchMap((allReferences) => combineLatest(Array.from(allReferences).map((ref) => ref.helpContextKeys$)).pipe(map((x) => x.flat()), defaultIfEmpty([]), map((x) => new Set(x)))), distinctUntilHasDifferentValues(), shareReplay(1));
+    activeHelpContextKeys$ = this._contextReferences.pipe(switchMap((allReferences) => combineLatest([...allReferences].map((ref) => ref.helpContextKeys$)).pipe(map((x) => x.flat()), defaultIfEmpty([]), map((x) => new Set(x)))), distinctUntilHasDifferentValues(), shareReplay(1));
     /**
      * Observable array of all currently active help context key strings.
      */
-    activeHelpContextKeysArray$ = this.activeHelpContextKeys$.pipe(map((x) => Array.from(x)), shareReplay(1));
+    activeHelpContextKeysArray$ = this.activeHelpContextKeys$.pipe(map((x) => [...x]), shareReplay(1));
     /**
      * Registers a help context reference, adding its keys to the active set.
      *
@@ -14354,6 +14583,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
  * // In a component or directive constructor
  * const destroy = registerHelpContextKeysWithDbxHelpContextService(of(['feature-help', 'general-help']));
  * ```
+ *
+ * @param helpContextKeys - Observable or static array of help context keys to register with the service
+ * @returns A destroy function that unregisters the help context keys when called
  */
 function registerHelpContextKeysWithDbxHelpContextService(helpContextKeys) {
     const helpContextService = inject(DbxHelpContextService);
@@ -14424,7 +14656,8 @@ class DbxHelpWidgetService {
     _helpListFooterComponentConfig;
     _defaultIcon;
     _popoverHeaderComponentConfig;
-    constructor(initialConfig) {
+    constructor() {
+        const initialConfig = inject(DbxHelpWidgetServiceConfig, { optional: true });
         this.setDefaultWidgetComponentClass(initialConfig?.defaultWidgetComponentClass);
         this.setDefaultIcon(initialConfig?.defaultIcon);
         this.setPopoverHeaderComponentConfig(initialConfig?.popoverHeaderComponentConfig);
@@ -14436,6 +14669,8 @@ class DbxHelpWidgetService {
     }
     /**
      * Returns the component class used for unrecognized help context keys.
+     *
+     * @returns The default widget component class, or undefined if not set
      */
     getDefaultWidgetComponentClass() {
         return this._defaultWidgetComponentClass;
@@ -14445,6 +14680,8 @@ class DbxHelpWidgetService {
     }
     /**
      * Returns the default icon used for help entries without a specific icon.
+     *
+     * @returns The default icon string, or undefined if not set
      */
     getDefaultIcon() {
         return this._defaultIcon;
@@ -14454,6 +14691,8 @@ class DbxHelpWidgetService {
     }
     /**
      * Returns the component config displayed in the popover header, if set.
+     *
+     * @returns The popover header component config, or undefined if not set
      */
     getPopoverHeaderComponentConfig() {
         return this._popoverHeaderComponentConfig;
@@ -14463,6 +14702,8 @@ class DbxHelpWidgetService {
     }
     /**
      * Returns the component config displayed at the top of the help list view, if set.
+     *
+     * @returns The help list header component config, or undefined if not set
      */
     getHelpListHeaderComponentConfig() {
         return this._helpListHeaderComponentConfig;
@@ -14472,6 +14713,8 @@ class DbxHelpWidgetService {
     }
     /**
      * Returns the component config displayed at the bottom of the help list view, if set.
+     *
+     * @returns The help list footer component config, or undefined if not set
      */
     getHelpListFooterComponentConfig() {
         return this._helpListFooterComponentConfig;
@@ -14486,6 +14729,7 @@ class DbxHelpWidgetService {
      *
      * @param entries The entries to register
      * @param override Whether to override existing entries (default: true)
+     * @returns Always returns true after registration completes
      */
     register(entries, override = true) {
         const entriesArray = asArray(entries);
@@ -14499,14 +14743,17 @@ class DbxHelpWidgetService {
     // MARK: Get
     /**
      * Returns all currently registered help context keys.
+     *
+     * @returns Array of all registered help context keys
      */
     getAllRegisteredHelpContextKeys() {
-        return Array.from(this._entries.keys());
+        return [...this._entries.keys()];
     }
     /**
      * Retrieves the widget entry for a given help context key. Falls back to a default entry if a default widget component class is configured.
      *
      * @param helpContextKey - The help context key to look up
+     * @returns The matching widget entry, a default entry if a default component class is configured, or undefined
      */
     getHelpWidgetEntry(helpContextKey) {
         return this._entries.get(helpContextKey) ?? (this._defaultWidgetComponentClass ? { helpContextKey, title: '<Missing Help Topic>', widgetComponentClass: this._defaultWidgetComponentClass } : undefined);
@@ -14515,33 +14762,34 @@ class DbxHelpWidgetService {
      * Retrieves widget entries for multiple help context keys, filtering out any unresolvable keys.
      *
      * @param helpContextKeys - Array of help context keys to look up
+     * @returns Array of resolved widget entries, excluding any keys that could not be resolved
      */
     getHelpWidgetEntriesForHelpContextKeys(helpContextKeys) {
         return helpContextKeys.map((context) => this.getHelpWidgetEntry(context)).filter((entry) => !!entry);
     }
     /**
      * Checks whether a widget entry is registered for the given help context key.
+     *
+     * @param context - The help context key to check
+     * @returns True if a widget entry exists for the given key
      */
     hasHelpWidgetEntry(context) {
         return this._entries.has(context);
     }
     /**
      * Returns a cached map of help context keys to their sort priority values.
+     *
+     * @returns Map of help context keys to their numeric sort priorities
      */
     getSortPriorityMap() {
         return this._sortPriorityMap();
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxHelpWidgetService, deps: [{ token: DbxHelpWidgetServiceConfig, optional: true }], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxHelpWidgetService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
     static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxHelpWidgetService });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxHelpWidgetService, decorators: [{
             type: Injectable
-        }], ctorParameters: () => [{ type: DbxHelpWidgetServiceConfig, decorators: [{
-                    type: Optional
-                }, {
-                    type: Inject,
-                    args: [DbxHelpWidgetServiceConfig]
-                }] }] });
+        }], ctorParameters: () => [] });
 
 /**
  * Creates EnvironmentProviders for the help context system.
@@ -14684,8 +14932,7 @@ class DbxHelpViewListComponent {
     helpContextKeys = input.required(...(ngDevMode ? [{ debugName: "helpContextKeys" }] : []));
     helpContextKeys$ = toObservable(this.helpContextKeys).pipe(switchMap((x) => asObservable(x) ?? of([])), map(asArray), distinctUntilHasDifferentValues(), map((x) => {
         const sortPriorityMap = this.helpWidgetService.getSortPriorityMap();
-        const sorted = [...x].sort(sortByNumberFunction((x) => sortPriorityMap.get(x) ?? -2));
-        return sorted;
+        return [...x].sort(sortByNumberFunction((x) => sortPriorityMap.get(x) ?? -2));
     }), shareReplay(1));
     helpContextKeysSignal = toSignal(this.helpContextKeys$, { initialValue: [] });
     helpWidgetEntriesSignal = computed(() => this.helpWidgetService.getHelpWidgetEntriesForHelpContextKeys(this.helpContextKeysSignal()), ...(ngDevMode ? [{ debugName: "helpWidgetEntriesSignal" }] : []));
@@ -14914,7 +15161,9 @@ function disableRightClickInCdkBackdrop(classes = 'cdk-overlay-container', onEve
         return () => target.removeEventListener('contextmenu', eventListener);
     }
     else {
-        return () => { };
+        return () => {
+            /* noop */
+        };
     }
 }