@dereekb/dbx-web 13.11.13 → 13.11.15

package/fesm2022/dereekb-dbx-web.mjs

@@ -135,14 +135,14 @@ var CompactMode;
  * Converts a boolean or `CompactMode` value into a normalized `CompactMode`.
  * `true` maps to `CompactMode.COMPACT`, `false` maps to `CompactMode.FULL`.
  *
+ * @param input - Boolean or CompactMode value to normalize.
+ * @returns The normalized CompactMode enum value.
+ *
  * @example
  * ```ts
  * 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') {
@@ -154,6 +154,10 @@ function compactModeFromInput(input) {
  * Maps an observable compact mode stream to the corresponding value from the config.
  * Falls back to the config's `defaultMode` (or `FULL`) when the observable is nullish.
  *
+ * @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.
+ *
  * @example
  * ```ts
  * const value$ = mapCompactModeObs(mode$, {
@@ -162,10 +166,6 @@ 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);
@@ -503,16 +503,16 @@ class DbxPopoverComponent extends AbstractTransitionWatcherDirective {
         this.popoverRef.close(value);
     }
     _useClosingValue(closeType, useValue) {
-        if (this.getClosingValueFn != null) {
+        if (this.getClosingValueFn == null) {
+            useValue();
+        }
+        else {
             asPromise(this.getClosingValueFn(this.data, closeType)).then((x) => {
                 useValue(x);
             }, () => {
                 useValue();
             });
         }
-        else {
-            useValue();
-        }
     }
     // Keypresses
     handleKeydown() {
@@ -580,7 +580,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Default key used when no key is specified.
  */
-const DBX_DETACH_DEFAULT_KEY = 'default';
+const DEFAULT_DBX_DETACH_KEY = 'default';
 /**
  * Possible display states for a detach instance.
  */
@@ -608,15 +608,16 @@ class DbxDetachController {
  * Creates Angular providers that register a {@link DbxDetachController} implementation for DI.
  *
  * @param sourceType - The concrete class to provide as the controller.
- * @returns An array of Angular providers that bind the source type to {@link DbxDetachController}.
+ * @returns Array of Angular providers that bind the source type to {@link DbxDetachController}.
  *
- * @example
- * ```typescript
- * @Component({
+ * @Component ({
  *   providers: provideDbxDetachController(MyDetachController),
  * })
  * export class MyComponent {}
  * ```
+ *
+ * @example
+ * ```typescript
  */
 function provideDbxDetachController(sourceType) {
     return [
@@ -690,6 +691,9 @@ const DBX_THEME_COLORS = [...DBX_THEME_COLORS_MAIN, ...DBX_THEME_COLORS_EXTRA, .
  * Any non-null object is treated as a config so template-only configs (i.e. `{ template: 'foo' }`)
  * are detected before the service expands them.
  *
+ * @param value - The value to test.
+ * @returns `true` when the value is a {@link DbxColorConfig}
+ *
  * @example
  * ```ts
  * isDbxColorConfig('primary'); // false
@@ -697,9 +701,6 @@ const DBX_THEME_COLORS = [...DBX_THEME_COLORS_MAIN, ...DBX_THEME_COLORS_EXTRA, .
  * isDbxColorConfig({ template: 'brand-positive' }); // true
  * isDbxColorConfig(undefined); // false
  * ```
- *
- * @param value - the value to test
- * @returns `true` when the value is a {@link DbxColorConfig}
  */
 function isDbxColorConfig(value) {
     return typeof value === 'object' && value !== null;
@@ -719,15 +720,15 @@ const DBX_COLOR_CUSTOM_TEXT_CSS_CLASS = 'dbx-color-text';
 /**
  * Returns the CSS class name for a themed background color.
  *
+ * @param color - The theme color, color config, or nullish/empty for the default class.
+ * @returns The CSS class name for the themed background (e.g., `'dbx-primary-bg'`, `'dbx-color-bg'`, or `'dbx-default'`)
+ *
  * @example
  * ```ts
  * dbxColorBackground('primary'); // 'dbx-primary-bg'
  * dbxColorBackground({ color: '#ff0066' }); // 'dbx-color-bg'
  * dbxColorBackground(undefined); // 'dbx-default'
  * ```
- *
- * @param color - the theme color, color config, or nullish/empty for the default class
- * @returns the CSS class name for the themed background (e.g., `'dbx-primary-bg'`, `'dbx-color-bg'`, or `'dbx-default'`)
  */
 function dbxColorBackground(color) {
     let cssClass = 'dbx-default'; // default text color class (not -bg) to avoid setting --dbx-bg-color-current which interferes with button label color tokens
@@ -790,6 +791,7 @@ function dbxThemeColorCssTokenVar(color, returnDefault) {
     return result;
 }
 // MARK: Compat
+// COMPAT: Deprecated aliases
 /**
  * @deprecated Use {@link dbxThemeColorCssToken} instead.
  */
@@ -898,16 +900,14 @@ class AbstractProgressButtonDirective {
         const workingValue = this.workingValueSignal();
         const mode = config?.mode;
         let result;
-        if (!mode) {
-            if (workingValue != null) {
-                result = 'determinate';
-            }
-            else {
-                result = 'indeterminate';
-            }
+        if (mode) {
+            result = mode;
+        }
+        else if (workingValue == null) {
+            result = 'indeterminate';
         }
         else {
-            result = mode;
+            result = 'determinate';
         }
         return result;
     }, ...(ngDevMode ? [{ debugName: "modeSignal" }] : /* istanbul ignore next */ []));
@@ -940,7 +940,8 @@ class AbstractProgressButtonDirective {
      * Whether button content should be hidden via opacity (working spinner or echo overlay active).
      */
     hideContentSignal = computed(() => {
-        return this.showProgressSignal() || this.echoActiveSignal();
+        const echoActive = this.echoActiveSignal();
+        return this.showProgressSignal() || echoActive;
     }, ...(ngDevMode ? [{ debugName: "hideContentSignal" }] : /* istanbul ignore next */ []));
     /**
      * When true, the click handler will not call `stopImmediatePropagation()`,
@@ -992,8 +993,8 @@ class DbxColorService {
     /**
      * Registers one or more {@link DbxColorConfigTemplate} entries.
      *
-     * @param templates - the template(s) to register
-     * @param override - whether existing entries with the same key should be replaced (default true)
+     * @param templates - The template(s) to register.
+     * @param override - Whether existing entries with the same key should be replaced (default true)
      */
     register(templates, override = true) {
         useIterableOrValue(templates, (template) => {
@@ -1005,8 +1006,8 @@ class DbxColorService {
     /**
      * Returns whether a template with the given key has been registered.
      *
-     * @param key - the template key to check
-     * @returns true when a template is registered under the given key
+     * @param key - The template key to check.
+     * @returns True when a template is registered under the given key.
      */
     hasTemplate(key) {
         return this._templates.has(key);
@@ -1014,8 +1015,8 @@ class DbxColorService {
     /**
      * Returns the {@link DbxColorConfigTemplate} registered under the given key, or undefined if none.
      *
-     * @param key - the template key to look up
-     * @returns the registered template, or undefined when no template matches
+     * @param key - The template key to look up.
+     * @returns The registered template, or undefined when no template matches.
      */
     getTemplate(key) {
         return this._templates.get(key);
@@ -1023,7 +1024,7 @@ class DbxColorService {
     /**
      * Returns all currently registered template keys.
      *
-     * @returns array of all registered template keys
+     * @returns Array of all registered template keys.
      */
     getAllRegisteredTemplateKeys() {
         return [...this._templates.keys()];
@@ -1034,6 +1035,9 @@ class DbxColorService {
      *
      * Returns the input unchanged when no template is set or when the template key is unknown.
      *
+     * @param config - The input config to expand.
+     * @returns An expanded config, or the input unchanged when no expansion applies.
+     *
      * @example
      * ```ts
      * service.register({ key: 'brand-positive', config: { color: '#1f9b59', contrast: 'white', tone: 18 } });
@@ -1042,9 +1046,6 @@ class DbxColorService {
      * service.expandColorConfig({ template: 'brand-positive', tone: 60 });
      * // -> { template: 'brand-positive', color: '#1f9b59', contrast: 'white', tone: 60 }
      * ```
-     *
-     * @param config - the input config to expand
-     * @returns an expanded config, or the input unchanged when no expansion applies
      */
     expandColorConfig(config) {
         let result = config;
@@ -1109,8 +1110,9 @@ class DbxColorDirective {
      * Effective tone used for opacity. The standalone `[dbxColorTone]` input wins when set; otherwise `config.tone` applies.
      */
     effectiveToneSignal = computed(() => {
+        const _config = this._configSignal();
         const inputTone = this.dbxColorTone();
-        return inputTone ?? this._configSignal()?.tone;
+        return inputTone ?? _config?.tone;
     }, ...(ngDevMode ? [{ debugName: "effectiveToneSignal" }] : /* istanbul ignore next */ []));
     /**
      * Whether tonal mode is active. Adds the `dbx-color-tonal` CSS class which
@@ -1122,10 +1124,11 @@ class DbxColorDirective {
      * from `config.tone`.
      */
     isTonalSignal = computed(() => {
+        const _config = this._configSignal();
         const inputTone = this.dbxColorTone();
         let tonal = false;
         if (inputTone == null) {
-            const config = this._configSignal();
+            const config = _config;
             if (config?.tonal != null) {
                 tonal = config.tonal;
             }
@@ -1264,8 +1267,9 @@ class DbxProgressSpinnerButtonComponent extends AbstractProgressButtonDirective
         return showText && config?.buttonIcon; // shows the button icon with showing the text.
     }, ...(ngDevMode ? [{ debugName: "showTextButtonIconSignal" }] : /* istanbul ignore next */ []));
     showIconSignal = computed(() => {
+        const showTextContent = this.showTextContentSignal();
         const config = this.configSignal();
-        return (config?.buttonIcon && !this.showTextContentSignal() // button icon must be defined
+        return (config?.buttonIcon && !showTextContent // button icon must be defined
         ); // show icon if either fab or iconOnly is true
     }, ...(ngDevMode ? [{ debugName: "showIconSignal" }] : /* istanbul ignore next */ []));
     customSpinnerStyleSignal = computed(() => {
@@ -1395,22 +1399,27 @@ class DbxButtonComponent extends AbstractDbxButtonDirective {
     allowClickPropagation = input(false, { ...(ngDevMode ? { debugName: "allowClickPropagation" } : /* istanbul ignore next */ {}), transform: isDefinedAndNotFalse });
     mode = input(...(ngDevMode ? [undefined, { debugName: "mode" }] : /* istanbul ignore next */ []));
     styleTypeSignal = computed(() => {
+        const iconOnly = this.iconOnly();
+        const raised = this.raised();
+        const stroked = this.stroked();
+        const flat = this.flat();
+        const tonal = this.tonal();
         const style = this.buttonStyle();
         let type = this.type() ?? style?.type;
         if (!type) {
-            if (this.iconOnly()) {
+            if (iconOnly) {
                 type = 'icon';
             }
-            else if (this.raised()) {
+            else if (raised) {
                 type = 'raised';
             }
-            else if (this.stroked()) {
+            else if (stroked) {
                 type = 'stroked';
             }
-            else if (this.flat()) {
+            else if (flat) {
                 type = 'flat';
             }
-            else if (this.tonal()) {
+            else if (tonal) {
                 type = 'tonal';
             }
         }
@@ -1418,8 +1427,10 @@ class DbxButtonComponent extends AbstractDbxButtonDirective {
     }, ...(ngDevMode ? [{ debugName: "styleTypeSignal" }] : /* istanbul ignore next */ []));
     configSignal = computed(() => {
         // configure custom style
+        const customContent = this.customContent();
         const customStyle = {};
         const buttonStyle = this.buttonStyle();
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- reads the deprecated customButtonColor input/style for backward compatibility until removed
         const customButtonColorValue = this.customButtonColor() ?? buttonStyle?.customButtonColor;
         if (customButtonColorValue) {
             customStyle['background'] = customButtonColorValue;
@@ -1439,7 +1450,7 @@ class DbxButtonComponent extends AbstractDbxButtonDirective {
         const iconValue = this.iconSignal();
         const buttonIcon = iconValue ? { fontIcon: iconValue } : undefined;
         const textValue = this.textSignal();
-        const hasTextContent = !!textValue || this._hasProjectedContent || this.customContent();
+        const hasTextContent = !!textValue || this._hasProjectedContent || customContent;
         const isIconOnlyButton = buttonIcon && !hasTextContent;
         const fab = this.fab() || buttonStyle?.fab;
         const mode = this.mode() ?? buttonStyle?.mode;
@@ -2038,58 +2049,62 @@ class DbxDetachService {
      * @returns The new or existing {@link DbxDetachInstance} for the given key.
      */
     init(config) {
-        const key = config.key ?? DBX_DETACH_DEFAULT_KEY;
+        const key = config.key ?? DEFAULT_DBX_DETACH_KEY;
         const existing = this._entries.get(key);
+        let instance;
         if (existing) {
-            return new DbxDetachInstanceImpl(existing);
+            instance = new DbxDetachInstanceImpl(existing);
         }
-        const controller = new DbxDetachEntryController(key, config.data, this);
-        // Build injector using shared utility, adding DbxDetachController provider
-        const elementInjector = createInjectorForInjectionComponentConfig({
-            config: {
-                ...config,
-                providers: [{ provide: DbxDetachController, useValue: controller }, ...(config.providers ?? [])]
-            },
-            parentInjector: this._injector
-        });
-        // Create component imperatively (not in any VCR)
-        const componentRef = createComponent(config.componentClass, {
-            environmentInjector: this._envInjector,
-            elementInjector
-        });
-        // Run init callback
-        initInjectionComponent(componentRef, config);
-        // Attach view to ApplicationRef for change detection
-        this._appRef.attachView(componentRef.hostView);
-        const overlayConfig = config.overlay ?? {};
-        const entry = {
-            key,
-            componentRef,
-            controller,
-            overlayConfig
-        };
-        this._entries.set(key, entry);
-        this._entries$.next(this._entries);
-        return new DbxDetachInstanceImpl(entry);
+        else {
+            const controller = new DbxDetachEntryController(key, config.data, this);
+            // Build injector using shared utility, adding DbxDetachController provider
+            const elementInjector = createInjectorForInjectionComponentConfig({
+                config: {
+                    ...config,
+                    providers: [{ provide: DbxDetachController, useValue: controller }, ...(config.providers ?? [])]
+                },
+                parentInjector: this._injector
+            });
+            // Create component imperatively (not in any VCR)
+            const componentRef = createComponent(config.componentClass, {
+                environmentInjector: this._envInjector,
+                elementInjector
+            });
+            // Run init callback
+            initInjectionComponent(componentRef, config);
+            // Attach view to ApplicationRef for change detection
+            this._appRef.attachView(componentRef.hostView);
+            const overlayConfig = config.overlay ?? {};
+            const entry = {
+                key,
+                componentRef,
+                controller,
+                overlayConfig
+            };
+            this._entries.set(key, entry);
+            this._entries$.next(this._entries);
+            instance = new DbxDetachInstanceImpl(entry);
+        }
+        return instance;
     }
     /**
      * Gets the instance for the given key, if it exists.
      *
-     * @param key - The detach key to look up. Defaults to {@link DBX_DETACH_DEFAULT_KEY}.
+     * @param key - The detach key to look up. Defaults to {@link DEFAULT_DBX_DETACH_KEY}.
      * @returns The instance if found, otherwise `undefined`.
      */
     get(key) {
-        const entry = this._entries.get(key ?? DBX_DETACH_DEFAULT_KEY);
+        const entry = this._entries.get(key ?? DEFAULT_DBX_DETACH_KEY);
         return entry ? new DbxDetachInstanceImpl(entry) : undefined;
     }
     /**
      * Observable of whether an entry exists for the given key.
      *
-     * @param key - The detach key to observe. Defaults to {@link DBX_DETACH_DEFAULT_KEY}.
+     * @param key - The detach key to observe. Defaults to {@link DEFAULT_DBX_DETACH_KEY}.
      * @returns An observable that emits `true` when an entry exists for the key.
      */
     has$(key) {
-        const k = key ?? DBX_DETACH_DEFAULT_KEY;
+        const k = key ?? DEFAULT_DBX_DETACH_KEY;
         return this._entries$.pipe(map((entries) => entries.has(k)), distinctUntilChanged());
     }
     /**
@@ -2103,19 +2118,17 @@ class DbxDetachService {
      */
     attachToOutlet(key, outletElement) {
         const entry = this._entries.get(key);
-        if (!entry) {
-            return;
-        }
-        const target = outletElement ?? entry.lastOutlet;
-        if (!target?.isConnected) {
-            // No outlet available or it's been removed from the DOM
-            return;
+        if (entry) {
+            const target = outletElement ?? entry.lastOutlet;
+            // No outlet available or it's been removed from the DOM → skip
+            if (target?.isConnected) {
+                this._closeOverlay(entry);
+                this._moveDomTo(entry, target);
+                entry.currentOutlet = target;
+                entry.lastOutlet = target;
+                entry.controller.setWindowState(DbxDetachWindowState.ATTACHED);
+            }
         }
-        this._closeOverlay(entry);
-        this._moveDomTo(entry, target);
-        entry.currentOutlet = target;
-        entry.lastOutlet = target;
-        entry.controller.setWindowState(DbxDetachWindowState.ATTACHED);
     }
     /**
      * Moves the component to the floating overlay.
@@ -2295,7 +2308,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 class DbxDetachInitDirective {
     _detachService = inject(DbxDetachService);
     config = input.required({ ...(ngDevMode ? { debugName: "config" } : /* istanbul ignore next */ {}), alias: 'dbxDetachInit' });
-    key = input(DBX_DETACH_DEFAULT_KEY, { ...(ngDevMode ? { debugName: "key" } : /* istanbul ignore next */ {}), alias: 'dbxDetachInitKey' });
+    key = input(DEFAULT_DBX_DETACH_KEY, { ...(ngDevMode ? { debugName: "key" } : /* istanbul ignore next */ {}), alias: 'dbxDetachInitKey' });
     ngOnInit() {
         this._detachService.init({
             ...this.config(),
@@ -2335,7 +2348,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 class DbxDetachOutletComponent {
     _detachService = inject(DbxDetachService);
     _elementRef = inject(ElementRef);
-    key = input(DBX_DETACH_DEFAULT_KEY, ...(ngDevMode ? [{ debugName: "key" }] : /* istanbul ignore next */ []));
+    key = input(DEFAULT_DBX_DETACH_KEY, ...(ngDevMode ? [{ debugName: "key" }] : /* istanbul ignore next */ []));
     /**
      * When true, the component automatically moves to the floating overlay
      * when this outlet is destroyed (e.g. page navigation). Defaults to false.
@@ -2483,8 +2496,14 @@ class DbxDialogContentFooterComponent {
     config = input(...(ngDevMode ? [undefined, { debugName: "config" }] : /* istanbul ignore next */ []));
     closeText = input(...(ngDevMode ? [undefined, { debugName: "closeText" }] : /* istanbul ignore next */ []));
     buttonColor = input(...(ngDevMode ? [undefined, { debugName: "buttonColor" }] : /* istanbul ignore next */ []));
-    closeTextSignal = computed(() => this.closeText() ?? this.config()?.closeText ?? 'Close', ...(ngDevMode ? [{ debugName: "closeTextSignal" }] : /* istanbul ignore next */ []));
-    buttonColorSignal = computed(() => this.buttonColor() ?? this.config()?.buttonColor ?? undefined, ...(ngDevMode ? [{ debugName: "buttonColorSignal" }] : /* istanbul ignore next */ []));
+    closeTextSignal = computed(() => {
+        const config = this.config();
+        return this.closeText() ?? config?.closeText ?? 'Close';
+    }, ...(ngDevMode ? [{ debugName: "closeTextSignal" }] : /* istanbul ignore next */ []));
+    buttonColorSignal = computed(() => {
+        const config = this.config();
+        return this.buttonColor() ?? config?.buttonColor ?? undefined;
+    }, ...(ngDevMode ? [{ debugName: "buttonColorSignal" }] : /* istanbul ignore next */ []));
     // eslint-disable-next-line @angular-eslint/no-output-native
     close = output();
     closeClicked() {
@@ -2535,9 +2554,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
  */
 class DbxDialogContentDirective {
     width = input('normal', { ...(ngDevMode ? { debugName: "width" } : /* istanbul ignore next */ {}), transform: (x) => x ?? 'normal' });
-    classConfig = computed(() => `${this.width()}-dialog-content`, ...(ngDevMode ? [{ debugName: "classConfig" }] : /* istanbul ignore next */ []));
+    classConfigSignal = computed(() => `${this.width()}-dialog-content`, ...(ngDevMode ? [{ debugName: "classConfigSignal" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: DbxDialogContentDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
-    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "21.2.11", type: DbxDialogContentDirective, isStandalone: true, selector: "dbx-dialog-content,[dbxDialogContent],.dbx-dialog-content", inputs: { width: { classPropertyName: "width", publicName: "width", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "class": "classConfig()" }, classAttribute: "dbx-dialog-content" }, ngImport: i0 });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "21.2.11", type: DbxDialogContentDirective, isStandalone: true, selector: "dbx-dialog-content,[dbxDialogContent],.dbx-dialog-content", inputs: { width: { classPropertyName: "width", publicName: "width", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "class": "classConfigSignal()" }, classAttribute: "dbx-dialog-content" }, ngImport: i0 });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: DbxDialogContentDirective, decorators: [{
             type: Directive,
@@ -2545,7 +2564,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
                     selector: 'dbx-dialog-content,[dbxDialogContent],.dbx-dialog-content',
                     host: {
                         class: 'dbx-dialog-content',
-                        '[class]': `classConfig()`
+                        '[class]': `classConfigSignal()`
                     },
                     standalone: true
                 }]
@@ -2654,8 +2673,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * 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
+ * @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
@@ -2884,8 +2903,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
  *
  * Must be called in an Angular injection context. Automatically disconnects the ResizeObserver on destroy.
  *
- * @param inputElement - the element to observe; if omitted, the host element is injected via `ElementRef`
- * @returns a read-only signal of resize events
+ * @param inputElement - The element to observe; if omitted, the host element is injected via `ElementRef`
+ * @returns A read-only signal of resize events.
  *
  * @example
  * ```ts
@@ -3349,11 +3368,9 @@ class DbxFilterPopoverButtonComponent extends AbstractFilterPopoverButtonDirecti
     buttonDisplayStyle = input(...(ngDevMode ? [undefined, { debugName: "buttonDisplayStyle" }] : /* istanbul ignore next */ []));
     buttonDisplaySignal = computed(() => {
         const pairDisplay = this.buttonDisplayStyle()?.display;
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- reads the deprecated buttonDisplay input for backward compatibility until removed
         const directDisplay = this.buttonDisplay();
-        if (!pairDisplay && !directDisplay) {
-            return undefined;
-        }
-        return { ...pairDisplay, ...directDisplay };
+        return !pairDisplay && !directDisplay ? undefined : { ...pairDisplay, ...directDisplay };
     }, ...(ngDevMode ? [{ debugName: "buttonDisplaySignal" }] : /* istanbul ignore next */ []));
     buttonStyleSignal = computed(() => this.buttonDisplayStyle()?.style, ...(ngDevMode ? [{ debugName: "buttonStyleSignal" }] : /* istanbul ignore next */ []));
     showFilterPopover() {
@@ -3476,7 +3493,7 @@ class AbstractDbxPresetFilterMenuDirective {
         this.presetSelected.emit(preset);
         if (presetValue == null || (typeof presetValue !== 'function' && objectHasNoKeys(presetValue))) {
             // set and then reset if the value is null or empty
-            this.filterSourceDirective.setFilter((presetValue ?? {}));
+            this.filterSourceDirective.setFilter(presetValue ?? {});
             this.filterSourceDirective.resetFilter();
         }
         else {
@@ -3518,6 +3535,9 @@ class DbxRouterWebProviderConfig {
  *
  * Must be called in an Angular injection context.
  *
+ * @param config - Configuration specifying the click target, child element to intercept, and optional disabled signal.
+ * @returns The created Angular effect reference.
+ *
  * @example
  * ```ts
  * overrideClickElementEffect({
@@ -3525,9 +3545,6 @@ 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;
@@ -3721,19 +3738,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
  */
 class DbxAnchorListComponent {
     anchors = input.required({ ...(ngDevMode ? { debugName: "anchors" } : /* istanbul ignore next */ {}), transform: (x) => x ?? [] });
-    expandedAnchors = computed(() => {
+    expandedAnchorsSignal = computed(() => {
         const anchors = this.anchors();
         return expandClickableAnchorLinkTrees(anchors).map((y) => {
             y.classes = `${y.depth > 0 ? 'dbx-anchor-list-child' : 'dbx-anchor-list-root'} dbx-anchor-list-depth-${y.depth}`;
             return y;
         });
-    }, ...(ngDevMode ? [{ debugName: "expandedAnchors" }] : /* istanbul ignore next */ []));
+    }, ...(ngDevMode ? [{ debugName: "expandedAnchorsSignal" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: DbxAnchorListComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.11", type: DbxAnchorListComponent, isStandalone: true, selector: "dbx-anchor-list", inputs: { anchors: { classPropertyName: "anchors", publicName: "anchors", isSignal: true, isRequired: true, transformFunction: null } }, ngImport: i0, template: "<mat-nav-list class=\"dbx-anchor-list\">\n  @for (expanded of expandedAnchors(); track $index; let last = $last) {\n    <dbx-anchor [anchor]=\"expanded.value\" [ngClass]=\"expanded.classes\">\n      <a mat-list-item [disabled]=\"expanded.value.disabled\">\n        @if (expanded.value.icon) {\n          <mat-icon matListItemIcon>{{ expanded.value.icon }}</mat-icon>\n        }\n        <!-- TODO: Add an icon from a letter if anchor.icon is unavailable. -->\n        <div matListItemTitle>{{ expanded.value.title }}</div>\n        @if (expanded.value.hint) {\n          <div matListItemLine class=\"dbx-small\">{{ expanded.value.hint }}</div>\n        }\n        @if (expanded.value.content) {\n          <dbx-injection [config]=\"expanded.value.content\"></dbx-injection>\n        }\n      </a>\n      @if (!last) {\n        <mat-divider></mat-divider>\n      }\n    </dbx-anchor>\n  }\n</mat-nav-list>\n", dependencies: [{ kind: "directive", type: NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "component", type: MatNavList, selector: "mat-nav-list", exportAs: ["matNavList"] }, { kind: "component", type: MatListItem, selector: "mat-list-item, a[mat-list-item], button[mat-list-item]", inputs: ["activated"], exportAs: ["matListItem"] }, { kind: "directive", type: MatListItemIcon, selector: "[matListItemIcon]" }, { kind: "directive", type: MatListItemLine, selector: "[matListItemLine]" }, { kind: "directive", type: MatListItemTitle, selector: "[matListItemTitle]" }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i1$1.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "component", type: MatDivider, selector: "mat-divider", inputs: ["vertical", "inset"] }, { kind: "component", type: DbxAnchorComponent, selector: "dbx-anchor, [dbx-anchor]", inputs: ["block"] }, { kind: "component", type: DbxInjectionComponent, selector: "dbx-injection, [dbxInjection], [dbx-injection]", inputs: ["config", "template"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.11", type: DbxAnchorListComponent, isStandalone: true, selector: "dbx-anchor-list", inputs: { anchors: { classPropertyName: "anchors", publicName: "anchors", isSignal: true, isRequired: true, transformFunction: null } }, ngImport: i0, template: "<mat-nav-list class=\"dbx-anchor-list\">\n  @for (expanded of expandedAnchorsSignal(); track $index; let last = $last) {\n    <dbx-anchor [anchor]=\"expanded.value\" [ngClass]=\"expanded.classes\">\n      <a mat-list-item [disabled]=\"expanded.value.disabled\">\n        @if (expanded.value.icon) {\n          <mat-icon matListItemIcon>{{ expanded.value.icon }}</mat-icon>\n        }\n        <!-- TODO: Add an icon from a letter if anchor.icon is unavailable. -->\n        <div matListItemTitle>{{ expanded.value.title }}</div>\n        @if (expanded.value.hint) {\n          <div matListItemLine class=\"dbx-small\">{{ expanded.value.hint }}</div>\n        }\n        @if (expanded.value.content) {\n          <dbx-injection [config]=\"expanded.value.content\"></dbx-injection>\n        }\n      </a>\n      @if (!last) {\n        <mat-divider></mat-divider>\n      }\n    </dbx-anchor>\n  }\n</mat-nav-list>\n", dependencies: [{ kind: "directive", type: NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "component", type: MatNavList, selector: "mat-nav-list", exportAs: ["matNavList"] }, { kind: "component", type: MatListItem, selector: "mat-list-item, a[mat-list-item], button[mat-list-item]", inputs: ["activated"], exportAs: ["matListItem"] }, { kind: "directive", type: MatListItemIcon, selector: "[matListItemIcon]" }, { kind: "directive", type: MatListItemLine, selector: "[matListItemLine]" }, { kind: "directive", type: MatListItemTitle, selector: "[matListItemTitle]" }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i1$1.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "component", type: MatDivider, selector: "mat-divider", inputs: ["vertical", "inset"] }, { kind: "component", type: DbxAnchorComponent, selector: "dbx-anchor, [dbx-anchor]", inputs: ["block"] }, { kind: "component", type: DbxInjectionComponent, selector: "dbx-injection, [dbxInjection], [dbx-injection]", inputs: ["config", "template"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: DbxAnchorListComponent, decorators: [{
             type: Component,
-            args: [{ selector: 'dbx-anchor-list', imports: [NgClass, MatNavList, MatListItem, MatListItemIcon, MatListItemLine, MatListItemTitle, MatIconModule, MatDivider, DbxAnchorComponent, DbxInjectionComponent], changeDetection: ChangeDetectionStrategy.OnPush, standalone: true, template: "<mat-nav-list class=\"dbx-anchor-list\">\n  @for (expanded of expandedAnchors(); track $index; let last = $last) {\n    <dbx-anchor [anchor]=\"expanded.value\" [ngClass]=\"expanded.classes\">\n      <a mat-list-item [disabled]=\"expanded.value.disabled\">\n        @if (expanded.value.icon) {\n          <mat-icon matListItemIcon>{{ expanded.value.icon }}</mat-icon>\n        }\n        <!-- TODO: Add an icon from a letter if anchor.icon is unavailable. -->\n        <div matListItemTitle>{{ expanded.value.title }}</div>\n        @if (expanded.value.hint) {\n          <div matListItemLine class=\"dbx-small\">{{ expanded.value.hint }}</div>\n        }\n        @if (expanded.value.content) {\n          <dbx-injection [config]=\"expanded.value.content\"></dbx-injection>\n        }\n      </a>\n      @if (!last) {\n        <mat-divider></mat-divider>\n      }\n    </dbx-anchor>\n  }\n</mat-nav-list>\n" }]
+            args: [{ selector: 'dbx-anchor-list', imports: [NgClass, MatNavList, MatListItem, MatListItemIcon, MatListItemLine, MatListItemTitle, MatIconModule, MatDivider, DbxAnchorComponent, DbxInjectionComponent], changeDetection: ChangeDetectionStrategy.OnPush, standalone: true, template: "<mat-nav-list class=\"dbx-anchor-list\">\n  @for (expanded of expandedAnchorsSignal(); track $index; let last = $last) {\n    <dbx-anchor [anchor]=\"expanded.value\" [ngClass]=\"expanded.classes\">\n      <a mat-list-item [disabled]=\"expanded.value.disabled\">\n        @if (expanded.value.icon) {\n          <mat-icon matListItemIcon>{{ expanded.value.icon }}</mat-icon>\n        }\n        <!-- TODO: Add an icon from a letter if anchor.icon is unavailable. -->\n        <div matListItemTitle>{{ expanded.value.title }}</div>\n        @if (expanded.value.hint) {\n          <div matListItemLine class=\"dbx-small\">{{ expanded.value.hint }}</div>\n        }\n        @if (expanded.value.content) {\n          <dbx-injection [config]=\"expanded.value.content\"></dbx-injection>\n        }\n      </a>\n      @if (!last) {\n        <mat-divider></mat-divider>\n      }\n    </dbx-anchor>\n  }\n</mat-nav-list>\n" }]
         }], propDecorators: { anchors: [{ type: i0.Input, args: [{ isSignal: true, alias: "anchors", required: true }] }] } });
 
 /**
@@ -3766,10 +3783,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * 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 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
+ * @returns An observable emitting the resolved button text string.
  *
  * @example
  * ```ts
@@ -3782,10 +3799,10 @@ 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 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
+ * @returns An observable emitting the resolved icon string, or undefined when no icon should be shown.
  *
  * @example
  * ```ts
@@ -3864,7 +3881,7 @@ class AbstractDbxPartialPresetFilterMenuDirective {
         const presetValue = preset.partialPresetValue;
         if (presetValue == null || (typeof presetValue !== 'function' && objectHasNoKeys(presetValue))) {
             // set and then reset if the value is null or empty
-            this.filterSourceDirective.setFilter((presetValue ?? {}));
+            this.filterSourceDirective.setFilter(presetValue ?? {});
             this.filterSourceDirective.resetFilter();
         }
         else {
@@ -4014,9 +4031,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * 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
+ * @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
@@ -4163,9 +4180,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * 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
+ * @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
@@ -4700,12 +4717,13 @@ 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
+ * @returns The providers that register the given type as the {@link DbxPromptConfirm} implementation.
+ *
+ * @Directive ({ providers: provideDbxPromptConfirm(MyConfirmDirective) })
+ * ```
  *
  * @example
  * ```ts
- * @Directive({ providers: provideDbxPromptConfirm(MyConfirmDirective) })
- * ```
  */
 function provideDbxPromptConfirm(sourceType) {
     return [
@@ -4776,6 +4794,7 @@ class DbxSectionHeaderComponent {
     hintInline = input(...(ngDevMode ? [undefined, { debugName: "hintInline" }] : /* istanbul ignore next */ []));
     hintInlineDefault = signal(undefined, ...(ngDevMode ? [{ debugName: "hintInlineDefault" }] : /* istanbul ignore next */ []));
     headerConfigSignal = computed(() => {
+        const hintInlineDefault = this.hintInlineDefault();
         const headerConfig = this.headerConfig();
         const config = {
             h: this.h() ?? headerConfig?.h,
@@ -4784,7 +4803,7 @@ class DbxSectionHeaderComponent {
             onlyHeader: this.onlyHeader() ?? headerConfig?.onlyHeader,
             icon: this.icon() ?? headerConfig?.icon,
             hint: this.hint() ?? headerConfig?.hint,
-            hintInline: this.hintInline() ?? headerConfig?.hintInline ?? this.hintInlineDefault()
+            hintInline: this.hintInline() ?? headerConfig?.hintInline ?? hintInlineDefault
         };
         return config;
     }, ...(ngDevMode ? [{ debugName: "headerConfigSignal" }] : /* istanbul ignore next */ []));
@@ -4940,11 +4959,11 @@ class DbxSectionComponent extends DbxSectionHeaderComponent {
      * Apply elevated card styling.
      */
     elevate = input(false, ...(ngDevMode ? [{ debugName: "elevate" }] : /* istanbul ignore next */ []));
-    classConfig = computed(() => {
+    classConfigSignal = computed(() => {
         return this.elevate() ? 'dbx-section-elevate dbx-content-elevate' : '';
-    }, ...(ngDevMode ? [{ debugName: "classConfig" }] : /* istanbul ignore next */ []));
+    }, ...(ngDevMode ? [{ debugName: "classConfigSignal" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: DbxSectionComponent, deps: null, target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.2.11", type: DbxSectionComponent, isStandalone: true, selector: "dbx-section", inputs: { elevate: { classPropertyName: "elevate", publicName: "elevate", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "role": "region" }, properties: { "class": "classConfig()", "attr.aria-label": "headerConfigSignal().header" }, classAttribute: "d-block dbx-section" }, usesInheritance: true, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.2.11", type: DbxSectionComponent, isStandalone: true, selector: "dbx-section", inputs: { elevate: { classPropertyName: "elevate", publicName: "elevate", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "role": "region" }, properties: { "class": "classConfigSignal()", "attr.aria-label": "headerConfigSignal().header" }, classAttribute: "d-block dbx-section" }, usesInheritance: true, ngImport: i0, template: `
     <div class="dbx-section-header" [h]="headerConfigSignal().h ?? 3" [header]="headerConfigSignal().header" [onlyHeader]="headerConfigSignal().onlyHeader" [icon]="headerConfigSignal().icon" [hint]="headerConfigSignal().hint" [hintInline]="headerConfigSignal().hintInline">
       <ng-content select="[sectionHeader]"></ng-content>
     </div>
@@ -4968,7 +4987,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
                     host: {
                         class: 'd-block dbx-section',
                         role: 'region',
-                        '[class]': 'classConfig()',
+                        '[class]': 'classConfigSignal()',
                         '[attr.aria-label]': 'headerConfigSignal().header'
                     },
                     imports: [DbxSectionHeaderComponent],
@@ -5292,11 +5311,11 @@ class DbxContentContainerDirective {
     grow = input('wide', ...(ngDevMode ? [{ debugName: "grow" }] : /* istanbul ignore next */ []));
     padding = input('normal', ...(ngDevMode ? [{ debugName: "padding" }] : /* istanbul ignore next */ []));
     topPadding = input('none', ...(ngDevMode ? [{ debugName: "topPadding" }] : /* istanbul ignore next */ []));
-    classConfig = computed(() => {
+    classConfigSignal = computed(() => {
         return 'container-' + this.grow() + ' container-padding-' + this.padding() + ' container-top-padding-' + this.topPadding();
-    }, ...(ngDevMode ? [{ debugName: "classConfig" }] : /* istanbul ignore next */ []));
+    }, ...(ngDevMode ? [{ debugName: "classConfigSignal" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: DbxContentContainerDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
-    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "21.2.11", 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 });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "21.2.11", 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": "classConfigSignal()" }, classAttribute: "d-block dbx-content-container" }, ngImport: i0 });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: DbxContentContainerDirective, decorators: [{
             type: Directive,
@@ -5304,7 +5323,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
                     selector: 'dbx-content-container,[dbxContentContainer],.dbx-content-container',
                     host: {
                         class: 'd-block dbx-content-container',
-                        '[class]': `classConfig()`
+                        '[class]': `classConfigSignal()`
                     },
                     standalone: true
                 }]
@@ -5478,8 +5497,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Returns a string that can be used as the "accept" attribute of a file input element.
  *
- * @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
+ * @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(',');
@@ -5487,8 +5506,8 @@ 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
+ * @param accept - A file accept string or array of filter type strings to normalize.
+ * @returns The individual filter type strings.
  *
  * @example
  * ```ts
@@ -5502,8 +5521,8 @@ 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
+ * @param config - Configuration specifying the accept criteria and whether multiple files are allowed.
+ * @returns Accepts an array of files and returns the categorized match result.
  *
  * @example
  * ```ts
@@ -5511,6 +5530,7 @@ function fileAcceptFilterTypeStringArray(accept) {
  * const result = matchFn(fileList);
  * console.log(result.accepted, result.rejected);
  * ```
+ *
  * @__NO_SIDE_EFFECTS__
  */
 function fileArrayAcceptMatchFunction(config) {
@@ -5531,8 +5551,8 @@ 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
+ * @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
@@ -5540,6 +5560,7 @@ function fileArrayAcceptMatchFunction(config) {
  * isAccepted({ name: 'photo.png', type: 'image/png' }); // true
  * isAccepted({ name: 'doc.txt', type: 'text/plain' }); // false
  * ```
+ *
  * @__NO_SIDE_EFFECTS__
  */
 function fileAcceptFunction(accept) {
@@ -5588,12 +5609,13 @@ 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
+ * @returns The providers that register the given type as the {@link DbxFileUploadActionCompatable} implementation.
+ *
+ * @Component ({ providers: provideDbxFileUploadActionCompatable(MyUploadComponent) })
+ * ```
  *
  * @example
  * ```ts
- * @Component({ providers: provideDbxFileUploadActionCompatable(MyUploadComponent) })
- * ```
  */
 function provideDbxFileUploadActionCompatable(sourceType) {
     return [
@@ -6141,15 +6163,16 @@ class DbxErrorWidgetService {
         });
     }
     register(entry, override = true) {
+        let registered = false;
         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;
+            registered = true;
         }
-        return false;
+        return registered;
     }
     // MARK: Get
     getErrorWidgetIdentifiers() {
@@ -6197,21 +6220,21 @@ class DbxErrorWidgetViewComponent {
         let config;
         if (error != null) {
             const entry = this.dbxErrorWidgetService.getErrorWidgetEntry(error.code);
-            if (entry != null) {
-                const defaultEntry = this.dbxErrorWidgetService.getDefaultErrorWidgetEntry();
-                const componentClass = entry.widgetComponentClass ?? defaultEntry?.widgetComponentClass;
-                if (componentClass != null) {
+            if (entry == null) {
+                const unknownEntry = this.dbxErrorWidgetService.getUnknownErrorWidgetEntry();
+                if (unknownEntry?.widgetComponentClass != null) {
                     config = {
-                        componentClass,
+                        componentClass: unknownEntry?.widgetComponentClass,
                         data: error
                     };
                 }
             }
             else {
-                const unknownEntry = this.dbxErrorWidgetService.getUnknownErrorWidgetEntry();
-                if (unknownEntry?.widgetComponentClass != null) {
+                const defaultEntry = this.dbxErrorWidgetService.getDefaultErrorWidgetEntry();
+                const componentClass = entry.widgetComponentClass ?? defaultEntry?.widgetComponentClass;
+                if (componentClass != null) {
                     config = {
-                        componentClass: unknownEntry?.widgetComponentClass,
+                        componentClass,
                         data: error
                     };
                 }
@@ -6479,11 +6502,18 @@ class DbxErrorComponent {
     error = input(...(ngDevMode ? [undefined, { debugName: "error" }] : /* istanbul ignore next */ []));
     iconOnly = input(false, ...(ngDevMode ? [{ debugName: "iconOnly" }] : /* istanbul ignore next */ []));
     _errorOverrideSignal = signal(undefined, ...(ngDevMode ? [{ debugName: "_errorOverrideSignal" }] : /* istanbul ignore next */ []));
-    errorSignal = computed(() => this._errorOverrideSignal() ?? this.error(), ...(ngDevMode ? [{ debugName: "errorSignal" }] : /* istanbul ignore next */ []));
-    state = computed(() => {
+    errorSignal = computed(() => {
+        const error = this.error();
+        return this._errorOverrideSignal() ?? error;
+    }, ...(ngDevMode ? [{ debugName: "errorSignal" }] : /* istanbul ignore next */ []));
+    stateSignal = computed(() => {
         const rawError = this.errorSignal();
         const iconOnly = this.iconOnly();
-        if (rawError != null) {
+        let result;
+        if (rawError == null) {
+            result = { viewType: 'none' };
+        }
+        else {
             const error = toReadableError(rawError);
             const isDefaultError = iconOnly ? false : isDefaultReadableError(error);
             let state = {
@@ -6510,19 +6540,19 @@ class DbxErrorComponent {
                     };
                 }
             }
-            return state;
-        }
-        return { viewType: 'none' };
-    }, ...(ngDevMode ? [{ debugName: "state" }] : /* istanbul ignore next */ []));
-    viewTypeSignal = computed(() => this.state().viewType, ...(ngDevMode ? [{ debugName: "viewTypeSignal" }] : /* istanbul ignore next */ []));
-    isDefaultErrorSignal = computed(() => this.state().isDefaultError, ...(ngDevMode ? [{ debugName: "isDefaultErrorSignal" }] : /* istanbul ignore next */ []));
-    messageSignal = computed(() => this.state().message, ...(ngDevMode ? [{ debugName: "messageSignal" }] : /* istanbul ignore next */ []));
-    customViewSignal = computed(() => this.state().customView, ...(ngDevMode ? [{ debugName: "customViewSignal" }] : /* istanbul ignore next */ []));
+            result = state;
+        }
+        return result;
+    }, ...(ngDevMode ? [{ debugName: "stateSignal" }] : /* istanbul ignore next */ []));
+    viewTypeSignal = computed(() => this.stateSignal().viewType, ...(ngDevMode ? [{ debugName: "viewTypeSignal" }] : /* istanbul ignore next */ []));
+    isDefaultErrorSignal = computed(() => this.stateSignal().isDefaultError, ...(ngDevMode ? [{ debugName: "isDefaultErrorSignal" }] : /* istanbul ignore next */ []));
+    messageSignal = computed(() => this.stateSignal().message, ...(ngDevMode ? [{ debugName: "messageSignal" }] : /* istanbul ignore next */ []));
+    customViewSignal = computed(() => this.stateSignal().customView, ...(ngDevMode ? [{ debugName: "customViewSignal" }] : /* istanbul ignore next */ []));
     setError(error) {
         this._errorOverrideSignal.set(error);
     }
     openErrorPopover(event) {
-        const error = this.state().error;
+        const error = this.stateSignal().error;
         if (error != null) {
             const popoverRef = DbxErrorPopoverComponent.openPopover(this.popoverService, {
                 origin: event.origin,
@@ -6596,8 +6626,8 @@ class DbxLoadingProgressComponent {
     color = input('primary', ...(ngDevMode ? [{ debugName: "color" }] : /* istanbul ignore next */ []));
     value = input(...(ngDevMode ? [undefined, { debugName: "value" }] : /* istanbul ignore next */ []));
     bufferValue = input(...(ngDevMode ? [undefined, { debugName: "bufferValue" }] : /* istanbul ignore next */ []));
-    bmode = computed(() => this.mode(), ...(ngDevMode ? [{ debugName: "bmode" }] : /* istanbul ignore next */ []));
-    smode = computed(() => this.mode(), ...(ngDevMode ? [{ debugName: "smode" }] : /* istanbul ignore next */ []));
+    bmodeSignal = computed(() => this.mode(), ...(ngDevMode ? [{ debugName: "bmodeSignal" }] : /* istanbul ignore next */ []));
+    smodeSignal = computed(() => this.mode(), ...(ngDevMode ? [{ debugName: "smodeSignal" }] : /* istanbul ignore next */ []));
     diameterSignal = computed(() => this.diameter() || this.defaultDiameter, ...(ngDevMode ? [{ debugName: "diameterSignal" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: DbxLoadingProgressComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
     static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.11", type: DbxLoadingProgressComponent, isStandalone: true, selector: "dbx-loading-progress", inputs: { diameter: { classPropertyName: "diameter", publicName: "diameter", isSignal: true, isRequired: false, transformFunction: null }, text: { classPropertyName: "text", publicName: "text", isSignal: true, isRequired: false, transformFunction: null }, linear: { classPropertyName: "linear", publicName: "linear", isSignal: true, isRequired: false, transformFunction: null }, mode: { classPropertyName: "mode", publicName: "mode", isSignal: true, isRequired: false, transformFunction: null }, color: { classPropertyName: "color", publicName: "color", isSignal: true, isRequired: false, transformFunction: null }, value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, bufferValue: { classPropertyName: "bufferValue", publicName: "bufferValue", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: `
@@ -6605,10 +6635,10 @@ class DbxLoadingProgressComponent {
       <span class="loading-progress-view-indicator" [dbxColor]="color()">
         @switch (linear()) {
           @case (true) {
-            <mat-progress-bar [mode]="bmode()" [bufferValue]="bufferValue()" [value]="value()" style="margin: auto;"></mat-progress-bar>
+            <mat-progress-bar [mode]="bmodeSignal()" [bufferValue]="bufferValue()" [value]="value()" style="margin: auto;"></mat-progress-bar>
           }
           @default {
-            <mat-progress-spinner [diameter]="diameterSignal()" [mode]="smode()" [value]="value()" style="margin: auto;"></mat-progress-spinner>
+            <mat-progress-spinner [diameter]="diameterSignal()" [mode]="smodeSignal()" [value]="value()" style="margin: auto;"></mat-progress-spinner>
           }
         }
       </span>
@@ -6627,10 +6657,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
       <span class="loading-progress-view-indicator" [dbxColor]="color()">
         @switch (linear()) {
           @case (true) {
-            <mat-progress-bar [mode]="bmode()" [bufferValue]="bufferValue()" [value]="value()" style="margin: auto;"></mat-progress-bar>
+            <mat-progress-bar [mode]="bmodeSignal()" [bufferValue]="bufferValue()" [value]="value()" style="margin: auto;"></mat-progress-bar>
           }
           @default {
-            <mat-progress-spinner [diameter]="diameterSignal()" [mode]="smode()" [value]="value()" style="margin: auto;"></mat-progress-spinner>
+            <mat-progress-spinner [diameter]="diameterSignal()" [mode]="smodeSignal()" [value]="value()" style="margin: auto;"></mat-progress-spinner>
           }
         }
       </span>
@@ -6690,16 +6720,14 @@ class DbxBasicLoadingComponent {
         const mode = this.mode();
         const loadingProgress = this.loadingProgressSignal();
         let result;
-        if (!mode) {
-            if (loadingProgress != null) {
-                result = 'determinate';
-            }
-            else {
-                result = 'indeterminate';
-            }
+        if (mode) {
+            result = mode;
+        }
+        else if (loadingProgress == null) {
+            result = 'indeterminate';
         }
         else {
-            result = mode;
+            result = 'determinate';
         }
         return result;
     }, ...(ngDevMode ? [{ debugName: "modeSignal" }] : /* istanbul ignore next */ []));
@@ -6773,7 +6801,10 @@ class DbxLoadingComponent {
     loading = input(...(ngDevMode ? [undefined, { debugName: "loading" }] : /* istanbul ignore next */ []));
     error = input(...(ngDevMode ? [undefined, { debugName: "error" }] : /* istanbul ignore next */ []));
     context = input(...(ngDevMode ? [undefined, { debugName: "context" }] : /* istanbul ignore next */ []));
-    contextSignal = computed(() => this._contextOverrideSignal() ?? this.context(), ...(ngDevMode ? [{ debugName: "contextSignal" }] : /* istanbul ignore next */ []));
+    contextSignal = computed(() => {
+        const context = this.context();
+        return this._contextOverrideSignal() ?? context;
+    }, ...(ngDevMode ? [{ debugName: "contextSignal" }] : /* istanbul ignore next */ []));
     contextStream$ = toObservable(this.contextSignal).pipe(maybeValueFromObservableOrValue(), switchMapMaybeLoadingContextStream(), shareReplay(1));
     contextStreamSignal = toSignal(this.contextStream$);
     stateSignal = computed(() => {
@@ -6804,7 +6835,7 @@ class DbxLoadingComponent {
     /**
      * Sets/overrides the context directly.
      *
-     * @param context Context source to use as an override.
+     * @param context - Context source to use as an override.
      */
     setContext(context) {
         this._contextOverrideSignal.set(context);
@@ -7126,7 +7157,7 @@ const DBX_ACTION_SNACKBAR_DEFAULTS = {
  * is included in the generated config.
  *
  * @param config - Per-state message configurations (idle, loading, success, error).
- * @returns A function that maps generator input to a snackbar display configuration.
+ * @returns Maps generator input to a snackbar display configuration.
  *
  * @example
  * ```typescript
@@ -7160,15 +7191,15 @@ function makeDbxActionSnackbarDisplayConfigGeneratorFunction(config) {
                 else {
                     reference = getValueFromGetter(undoInput);
                 }
-                if (!reference) {
-                    console.error('Expected action source reference was not provided to undo...');
-                }
-                else {
+                if (reference) {
                     building.action = {
                         button: undoButtonText ?? 'Undo',
                         reference
                     };
                 }
+                else {
+                    console.error('Expected action source reference was not provided to undo...');
+                }
             }
             result = building;
         }
@@ -7470,8 +7501,8 @@ class DbxActionTransitionSafetyDirective {
     }
     _handleOnBeforeTransition(transition) {
         return firstValueFrom(combineLatest([this.source.isModified$, this.safetyType$]).pipe(first(), mergeMap(([isModified, safetyType]) => {
-            if (isModified) {
-                return race([
+            return isModified
+                ? race([
                     // Watch for success to occur. At that point, close everything.
                     this.source.success$.pipe(first(), map(() => [true, undefined])),
                     this._handleIsModifiedState(transition, safetyType).pipe(first(), map((x) => [undefined, x]))
@@ -7479,9 +7510,8 @@ class DbxActionTransitionSafetyDirective {
                     return saveSuccess ? true : handleResult;
                 }), tap(() => this._closeDialog()), // Close dialog if it is still open.
                 delay(10) // Delay to allow dialog to close before transition.
-                );
-            }
-            return of(true);
+                )
+                : of(true);
         }))).then((x) => x); // Resolve/Flatten potential promise result.
     }
     _handleIsModifiedState(transition, safetyType) {
@@ -7514,25 +7544,33 @@ class DbxActionTransitionSafetyDirective {
         })));
     }
     _showDialog(_transition) {
+        let result;
         if (this.checkIsDestroyed()) {
-            return of(true);
-        }
-        if (!this._currentDialogRef) {
-            this._currentDialogRef = this.dialog.open(DbxActionUIRouterTransitionSafetyDialogComponent, {
-                viewContainerRef: this.viewContainerRef
-            });
+            result = of(true);
         }
-        return this._currentDialogRef.afterClosed().pipe(first(), map((result = 'stay') => {
-            // Default to Stay if the user clicks outside.
-            switch (result) {
-                case 'discard':
-                case 'success':
-                case 'none':
-                    return true;
-                case 'stay':
-                    return false;
+        else {
+            if (!this._currentDialogRef) {
+                this._currentDialogRef = this.dialog.open(DbxActionUIRouterTransitionSafetyDialogComponent, {
+                    viewContainerRef: this.viewContainerRef
+                });
             }
-        }));
+            result = this._currentDialogRef.afterClosed().pipe(first(), map((dialogResult = 'stay') => {
+                // Default to Stay if the user clicks outside.
+                let outcome;
+                switch (dialogResult) {
+                    case 'discard':
+                    case 'success':
+                    case 'none':
+                        outcome = true;
+                        break;
+                    case 'stay':
+                        outcome = false;
+                        break;
+                }
+                return outcome;
+            }));
+        }
+        return result;
     }
     _closeDialog() {
         if (this._currentDialogRef) {
@@ -7682,14 +7720,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
  * Ensures that the error data is safe for serialization by running it through `JSON.stringify`/`JSON.parse`.
  * Non-serializable data is stripped with a console warning.
  *
+ * @param httpError - The HTTP error response or generic error object to convert.
+ * @returns A plain JSON-serializable {@link ServerError} object.
+ *
  * @example
  * ```typescript
  * 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);
@@ -7716,6 +7754,9 @@ function convertToPOJOServerErrorResponse(httpError) {
  * Handles HTTP 401 responses specially by returning an {@link UnauthorizedServerErrorResponse}.
  * Returns `undefined` if the input is falsy.
  *
+ * @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.
+ *
  * @example
  * ```typescript
  * const serverError = convertToServerErrorResponse(httpErrorResponse);
@@ -7723,9 +7764,6 @@ 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;
@@ -8039,14 +8077,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Converts an HTTP error response into {@link ServerErrorParams} suitable for dispatching as an NgRx action prop.
  *
+ * @param httpError - The HTTP error response or generic error object to convert.
+ * @returns A {@link ServerErrorParams} object wrapping the converted server error.
+ *
  * @example
  * ```typescript
  * 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);
@@ -8055,6 +8093,10 @@ function convertServerErrorParams(httpError) {
 /**
  * RxJS operator that catches HTTP errors, converts them to {@link ServerErrorParams}, and dispatches the given NgRx action.
  *
+ * @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.
+ *
  * @example
  * ```typescript
  * return this.actions$.pipe(
@@ -8064,10 +8106,6 @@ 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) => {
@@ -8133,9 +8171,9 @@ 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
+ * @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({
@@ -8185,8 +8223,8 @@ class DbxModelViewTrackerStorage {
     /**
      * Persists a view tracker event to storage. Deduplicates by model key, sorts by date, and trims to the max event limit.
      *
-     * @param event - The event to record
-     * @returns Observable that completes when the event has been persisted
+     * @param event - The event to record.
+     * @returns Observable that completes when the event has been persisted.
      */
     addTrackerEvent(event) {
         const storageKey = this.getStorageKeyForFolder(event.folder);
@@ -8211,7 +8249,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
+     * @returns Observable of all view tracker events in the folder.
      */
     getAllEvents(folder) {
         return this.getEventSet(folder).pipe(map((x) => x.e));
@@ -8220,7 +8258,7 @@ 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
+     * @returns Observable of the event set containing events and the last-update timestamp.
      */
     getEventSet(folder) {
         const storageKey = this.getStorageKeyForFolder(folder);
@@ -8235,7 +8273,7 @@ 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
+     * @returns The computed storage key string combining the base key and folder name.
      */
     getStorageKeyForFolder(folder) {
         return `${this.storageKey}_${folder ?? 'default'}`;
@@ -8260,7 +8298,7 @@ class DbxModelTrackerService {
     /**
      * The default storage folder used when no folder is specified in tracking calls.
      *
-     * @returns The current default folder name, or undefined if not set
+     * @returns The current default folder name, or undefined if not set.
      */
     get defaultFolder() {
         return this._defaultFolder;
@@ -8272,8 +8310,8 @@ class DbxModelTrackerService {
     /**
      * Records a view event for the given model, optionally in a specific context and folder.
      *
-     * @param modelKeyTypeNamePair - The model identity to track
-     * @param context - Optional view context metadata
+     * @param modelKeyTypeNamePair - The model identity to track.
+     * @param context - Optional view context metadata.
      * @param folder - Storage folder; defaults to {@link defaultFolder}
      */
     trackViewedObject(modelKeyTypeNamePair, context, folder = this._defaultFolder) {
@@ -8290,7 +8328,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
+     * @returns Observable of view events sorted by most recent first.
      */
     getAllViewEvents(folder = this._defaultFolder) {
         return this._viewTrackerStorage.getAllEvents(folder);
@@ -8299,7 +8337,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
+     * @returns Observable of the complete event set including events and last-update timestamp.
      */
     getViewEventSet(folder = this._defaultFolder) {
         return this._viewTrackerStorage.getEventSet(folder);
@@ -8338,9 +8376,9 @@ class DbxModelObjectStateService {
     /**
      * 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
+     * @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 }));
@@ -8355,13 +8393,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Creates a {@link StorageAccessor} for persisting model view tracker events using the `mtvs` storage prefix.
  *
+ * @param storageAccessorFactory - The factory used to create typed storage accessors.
+ * @returns A storage accessor configured with the `mtvs` prefix for model view tracker events.
+ *
  * @example
  * ```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
  * @__NO_SIDE_EFFECTS__
  */
 function defaultDbxModelViewTrackerStorageAccessorFactory(storageAccessorFactory) {
@@ -8372,7 +8411,8 @@ function defaultDbxModelViewTrackerStorageAccessorFactory(storageAccessorFactory
 /**
  * Creates EnvironmentProviders for providing DbxModelTrackerService, DbxModelObjectStateService and sets up the NgRx store for DbxModelTrackerEffects.
  *
- * @returns EnvironmentProviders
+ * @returns EnvironmentProviders.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 function provideDbxModelService() {
@@ -8397,13 +8437,13 @@ function provideDbxModelService() {
 /**
  * Extracts all model keys from a {@link DbxModelViewTrackerEventSet}.
  *
+ * @param eventSet - The event set from which to extract model keys.
+ * @returns Array of model keys from all events in the set.
+ *
  * @example
  * ```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);
@@ -8411,13 +8451,13 @@ function allDbxModelViewTrackerEventSetModelKeys(eventSet) {
 /**
  * Extracts all model keys from an array of {@link DbxModelViewTrackerEvent}.
  *
+ * @param events - Array of view tracker events from which to extract model keys.
+ * @returns Array of model keys, one per event.
+ *
  * @example
  * ```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);
@@ -8439,7 +8479,7 @@ class DbxModelTypesService {
     /**
      * Registers one or more model type configurations. Merges with any previously registered configs.
      *
-     * @param configs - Single or array of model type configurations to register
+     * @param configs - Single or array of model type configurations to register.
      */
     addTypeConfigs(configs) {
         const types = {
@@ -8453,7 +8493,7 @@ class DbxModelTypesService {
     /**
      * Registers model type configurations from a map, merging with existing configs.
      *
-     * @param configs - Map of model type strings to their configurations
+     * @param configs - Map of model type strings to their configurations.
      */
     addTypeConfigsMap(configs) {
         const newConfig = {
@@ -8497,8 +8537,8 @@ 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
+     * @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]));
@@ -8594,15 +8634,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Creates a {@link CopyToClipboardFunction} that retries the copy operation until success or timeout.
  *
- * @param clipboard - the Angular CDK Clipboard instance
- * @param config - optional timeout and retry settings
- * @returns a function that copies text to the clipboard
+ * @param clipboard - The Angular CDK Clipboard instance.
+ * @param config - Optional timeout and retry settings.
+ * @returns Copies text to the clipboard.
  *
  * @example
  * ```ts
  * const copy = copyToClipboardFunction(clipboard, { copyTimeoutSeconds: 10 });
  * const success = await copy('some text');
  * ```
+ *
  * @__NO_SIDE_EFFECTS__
  */
 function copyToClipboardFunction(clipboard, config) {
@@ -8642,14 +8683,15 @@ function copyToClipboardFunction(clipboard, config) {
  *
  * Must be called in an Angular injection context.
  *
- * @param config - optional timeout and retry settings
- * @returns the clipboard copy function
+ * @param config - Optional timeout and retry settings.
+ * @returns The clipboard copy function.
  *
  * @example
  * ```ts
  * const copy = injectCopyToClipboardFunction();
  * await copy('copied text');
  * ```
+ *
  * @__NO_SIDE_EFFECTS__
  */
 function injectCopyToClipboardFunction(config) {
@@ -8661,8 +8703,8 @@ function injectCopyToClipboardFunction(config) {
  *
  * Must be called in an Angular injection context.
  *
- * @param config - optional configuration for copy behavior and snackbar messages
- * @returns clipboard copy function with snackbar notification support
+ * @param config - Optional configuration for copy behavior and snackbar messages.
+ * @returns Clipboard copy function with snackbar notification support.
  *
  * @example
  * ```ts
@@ -8686,9 +8728,9 @@ function injectCopyToClipboardFunctionWithSnackbarMessage(config) {
     const _setSnackbarMessagesConfig = (config) => {
         if (config != null) {
             const { successMessage: inputSuccessMessage, failureMessage: inputFailureMessage, snackbarDuration: inputSnackbarDuration } = config;
-            successMessage = (inputSuccessMessage !== undefined ? inputSuccessMessage : successMessage) ?? DEFAULT_SUCCESS_MESSAGE;
-            failureMessage = (inputFailureMessage !== undefined ? inputFailureMessage : failureMessage) ?? DEFAULT_FAILURE_MESSAGE;
-            snackbarDuration = (inputSnackbarDuration !== undefined ? inputSnackbarDuration : snackbarDuration) ?? DEFAULT_SNACKBAR_DURATION;
+            successMessage = (inputSuccessMessage === undefined ? successMessage : inputSuccessMessage) ?? DEFAULT_SUCCESS_MESSAGE;
+            failureMessage = (inputFailureMessage === undefined ? failureMessage : inputFailureMessage) ?? DEFAULT_FAILURE_MESSAGE;
+            snackbarDuration = (inputSnackbarDuration === undefined ? snackbarDuration : inputSnackbarDuration) ?? DEFAULT_SNACKBAR_DURATION;
         }
     };
     if (config) {
@@ -8834,10 +8876,7 @@ class DbxDownloadTextViewComponent extends AbstractDbxClipboardDirective {
     }, ...(ngDevMode ? [{ debugName: "contentLoadingStateSignal" }] : /* istanbul ignore next */ []));
     contentLoadingState$ = toObservable(this.contentLoadingStateSignal);
     content$ = this.contentLoadingState$.pipe(switchMap((x) => {
-        if (x) {
-            return of(x).pipe(valueFromFinishedLoadingState());
-        }
-        return of(undefined);
+        return x ? of(x).pipe(valueFromFinishedLoadingState()) : of(undefined);
     }));
     contentSignal = toSignal(this.content$);
     contentDataSignal = computed(() => this.contentSignal()?.content, ...(ngDevMode ? [{ debugName: "contentDataSignal" }] : /* istanbul ignore next */ []));
@@ -8857,10 +8896,7 @@ class DbxDownloadTextViewComponent extends AbstractDbxClipboardDirective {
     context = loadingStateContext({ obs: this.contentLoadingState$ });
     handleCopyToClipboard = () => {
         return this.content$.pipe(first(), switchMap((downloadTextContent) => {
-            if (downloadTextContent) {
-                return this._copyToClipboard(downloadTextContent.content);
-            }
-            return of(false);
+            return downloadTextContent ? this._copyToClipboard(downloadTextContent.content) : of(false);
         }));
     };
     toggleExpandPreview() {
@@ -8881,8 +8917,8 @@ 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
+ * @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
@@ -8899,10 +8935,10 @@ function provideDbxWebFilePreviewServiceEntries(entries) {
 /**
  * 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
+ * @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 DEFAULT_DBX_WEB_FILE_PREVIEW_SERVICE_PREVIEW_COMPONENT_FUNCTION = (input) => {
     const { blob, srcUrl, embedMimeType, sanitizeSrcUrl } = input;
     let embedElement = 'embed';
     if (embedMimeType) {
@@ -8929,10 +8965,10 @@ 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
+ * @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 DEFAULT_DBX_WEB_FILE_PREVIEW_SERVICE_DIALOG_WITH_COMPONENT_FUNCTION = (input) => {
     const { matDialog, componentConfig } = input;
     return DbxInjectionDialogComponent.openDialog(matDialog, {
         componentConfig,
@@ -8952,13 +8988,13 @@ class DbxWebFilePreviewService {
             entries.forEach((x) => this.registerPreviewEntry(x));
         }
     }
-    _defaultPreviewComponentFunction = DBX_WEB_FILE_PREVIEW_SERVICE_DEFAULT_PREVIEW_COMPONENT_FUNCTION;
-    _defaultPreviewDialogWithComponentFunction = DBX_WEB_FILE_PREVIEW_SERVICE_DEFAULT_DIALOG_WITH_COMPONENT_FUNCTION;
+    _defaultPreviewComponentFunction = DEFAULT_DBX_WEB_FILE_PREVIEW_SERVICE_PREVIEW_COMPONENT_FUNCTION;
+    _defaultPreviewDialogWithComponentFunction = DEFAULT_DBX_WEB_FILE_PREVIEW_SERVICE_DIALOG_WITH_COMPONENT_FUNCTION;
     // Configuration
     /**
      * Registers one or more file preview entries, mapping MIME types to their preview components.
      *
-     * @param entries - Single or array of preview entries to register
+     * @param entries - Single or array of preview entries to register.
      */
     registerPreviewEntries(entries) {
         asArray(entries).forEach((entry) => this.registerPreviewEntry(entry));
@@ -8966,7 +9002,7 @@ class DbxWebFilePreviewService {
     /**
      * Registers a single file preview entry for its MIME type(s).
      *
-     * @param entry - The preview entry to register
+     * @param entry - The preview entry to register.
      */
     registerPreviewEntry(entry) {
         asArray(entry.mimeType).forEach((mimeType) => this._entries.set(mimeType, entry));
@@ -8974,7 +9010,7 @@ 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
+     * @param previewFunction - The preview component function to use as the new default.
      */
     setDefaultPreviewComponentFunction(previewFunction) {
         this._defaultPreviewComponentFunction = previewFunction;
@@ -8982,7 +9018,7 @@ class DbxWebFilePreviewService {
     /**
      * 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
+     * @param previewDialogWithComponentFunction - The dialog-with-component function to use as the new default.
      */
     setDefaultPreviewDialogWithComponentFunction(previewDialogWithComponentFunction) {
         this._defaultPreviewDialogWithComponentFunction = previewDialogWithComponentFunction;
@@ -8991,8 +9027,8 @@ 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
+     * @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;
@@ -9002,8 +9038,8 @@ class DbxWebFilePreviewService {
     /**
      * Opens a Material dialog to preview a file. Uses a MIME-specific dialog function if registered, otherwise creates a preview component and wraps it in the default dialog.
      *
-     * @param input - The dialog input containing file data and MIME type
-     * @returns Reference to the opened dialog
+     * @param input - The dialog input containing file data and MIME type.
+     * @returns Reference to the opened dialog.
      */
     openPreviewDialog(input) {
         const { embedMimeType } = input;
@@ -9075,8 +9111,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * 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
+ * @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
@@ -9111,16 +9147,15 @@ const SCREEN_MEDIA_WIDTH_TYPE_SIZE_MAP = {
 /**
  * Returns `true` if the current screen width type is at least as wide as the given breakpoint.
  *
- * @param current - the current screen width type
- * @param breakpoint - the minimum width type to check against
+ * @param current - The current screen width type.
+ * @param breakpoint - The minimum width type to check against.
+ * @returns `true` if the current width type meets or exceeds the breakpoint.
  *
  * @example
  * ```ts
  * 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);
@@ -9128,10 +9163,10 @@ function screenMediaWidthTypeIsActive(current, breakpoint) {
 /**
  * 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
+ * @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]);
@@ -9204,8 +9239,8 @@ class DbxScreenMediaService {
     /**
      * Returns an observable that emits `true` when the current screen width is at least as wide as the given breakpoint.
      *
-     * @param inputBreakpoint - the minimum width type or an observable of it
-     * @returns observable of whether the breakpoint is currently active
+     * @param inputBreakpoint - The minimum width type or an observable of it.
+     * @returns Observable of whether the breakpoint is currently active.
      */
     isBreakpointActive(inputBreakpoint) {
         return combineLatest([this.widthType$, asObservable(inputBreakpoint)]).pipe(map(([current, breakpoint]) => screenMediaWidthTypeIsActive(current, breakpoint)), distinctUntilChanged(), shareReplay(1));
@@ -9296,6 +9331,7 @@ class DbxAccordionHeaderHeightDirective {
     heightTextSmallScreenMultiplier = input(1.6, ...(ngDevMode ? [{ debugName: "heightTextSmallScreenMultiplier" }] : /* istanbul ignore next */ []));
     widthTypeSignal = toSignal(this._screenMediaService.widthType$);
     expansionPanelHeightSignal = computed(() => {
+        const heightTextSmallScreenMultiplier = this.heightTextSmallScreenMultiplier();
         const baseHeight = this.dbxAccordionHeaderHeight();
         const text = this.heightText();
         const textLines = this.heightTextLines();
@@ -9315,7 +9351,7 @@ class DbxAccordionHeaderHeightDirective {
             const lineHeight = textLineHeight;
             // on small screens text wraps more, so scale up estimated lines
             if (isSmallScreen) {
-                const multiplier = this.heightTextSmallScreenMultiplier() ?? 1.6;
+                const multiplier = heightTextSmallScreenMultiplier ?? 1.6;
                 lines = Math.ceil(lines * multiplier);
             }
             height = (baseHeight ?? 60) + lines * lineHeight;
@@ -9413,8 +9449,9 @@ class DbxAvatarViewComponent {
         return hideOnError && hasError;
     }, ...(ngDevMode ? [{ debugName: "hideAvatarSignal" }] : /* istanbul ignore next */ []));
     avatarIconSignal = computed(() => {
+        const hasAvatarError = this.hasAvatarErrorSignal();
         let icon = this.avatarIcon() ?? this.defaultContext?.icon;
-        if (!icon && this.hasAvatarErrorSignal()) {
+        if (!icon && hasAvatarError) {
             icon = this.avatarService.defaultAvatarErrorIcon;
         }
         else {
@@ -9518,8 +9555,8 @@ class DbxAvatarViewService {
      *
      * 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
+     * @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;
@@ -9540,7 +9577,7 @@ class DbxAvatarViewService {
     /**
      * 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
+     * @param url - The URL to use as the default avatar image, or nullish to clear.
      */
     setDefaultAvatarUrl(url) {
         this._defaultAvatarUrl = url;
@@ -9548,7 +9585,7 @@ class DbxAvatarViewService {
     /**
      * 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
+     * @param icon - The Material icon name to use, or nullish to clear.
      */
     setDefaultAvatarIcon(icon) {
         this._defaultAvatarIcon = icon;
@@ -9556,7 +9593,7 @@ class DbxAvatarViewService {
     /**
      * 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
+     * @param icon - The Material icon name to display on image load error, or nullish to clear.
      */
     setDefaultAvatarErrorIcon(icon) {
         this._defaultAvatarErrorIcon = icon;
@@ -9564,7 +9601,7 @@ class DbxAvatarViewService {
     /**
      * 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
+     * @param config - The injection component config to use as the new default.
      */
     setDefaultAvatarComponentConfig(config) {
         this._defaultAvatarComponentConfig = config;
@@ -10167,15 +10204,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Creates Angular providers for a new {@link TwoColumnsContextStore} instance.
  *
- * @example
- * ```typescript
- * @Component({
+ * @returns Array of Angular providers that supply a new {@link TwoColumnsContextStore}
+ *
+ * @Component ({
  *   providers: provideTwoColumnsContext(),
  * })
  * export class MyColumnLayoutComponent { }
  * ```
  *
- * @returns an array of Angular providers that supply a new {@link TwoColumnsContextStore}
+ * @example
+ * ```typescript
  */
 function provideTwoColumnsContext() {
     return [
@@ -10759,16 +10797,17 @@ class DbxValueListItemModifier {
 /**
  * Registers a directive as a {@link DbxValueListItemModifier} provider for dependency injection.
  *
- * @example
- * ```ts
- * @Directive({
+ * @param sourceType - The directive class to register as the DbxValueListItemModifier provider.
+ * @returns Array of Angular providers that wire up the directive as a DbxValueListItemModifier.
+ *
+ * @Directive ({
  *   providers: provideDbxValueListViewModifier(MyModifierDirective)
  * })
  * 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
+ * @example
+ * ```ts
  */
 function provideDbxValueListViewModifier(sourceType) {
     return [
@@ -10781,16 +10820,16 @@ function provideDbxValueListViewModifier(sourceType) {
 /**
  * Creates a {@link ListItemModifier} with the given key and modification function.
  *
+ * @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.
+ *
  * @example
  * ```ts
  * const highlightModifier = listItemModifier<MyItem>('highlight', (item) => {
  *   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);
@@ -11031,16 +11070,16 @@ const SIDE_NAV_DISPLAY_MODE_ORDER = [SideNavDisplayMode.NONE, SideNavDisplayMode
  * Falls back to the lowest allowed mode if no lower mode is available, or {@link SideNavDisplayMode.NONE}
  * if the allowed set is empty or undefined.
  *
+ * @param mode - The requested display mode to resolve.
+ * @param allowedModes - Set of modes that are permitted; if null/undefined, all modes are allowed.
+ * @returns The resolved display mode, falling back to the nearest lower allowed mode or NONE.
+ *
  * @example
  * ```ts
  * // ICON not allowed, rounds down to MOBILE
  * resolveSideNavDisplayMode(SideNavDisplayMode.ICON, new Set([SideNavDisplayMode.MOBILE, SideNavDisplayMode.FULL]));
  * // => SideNavDisplayMode.MOBILE
  * ```
- *
- * @param mode - The requested display mode to resolve.
- * @param allowedModes - Set of modes that are permitted; if null/undefined, all modes are allowed.
- * @returns The resolved display mode, falling back to the nearest lower allowed mode or NONE.
  */
 function resolveSideNavDisplayMode(mode, allowedModes) {
     let result;
@@ -11192,7 +11231,10 @@ class DbxSidenavComponent extends AbstractTransitionWatcherDirective {
         toggleOpen = toggleOpen ?? !this.sidenav().opened;
         const mode = this.stateSignal()?.mode;
         let open;
-        if (!forced) {
+        if (forced) {
+            open = toggleOpen;
+        }
+        else {
             switch (mode) {
                 case SideNavDisplayMode.MOBILE:
                     open = toggleOpen;
@@ -11205,9 +11247,6 @@ class DbxSidenavComponent extends AbstractTransitionWatcherDirective {
                     break;
             }
         }
-        else {
-            open = toggleOpen;
-        }
         if (open != null) {
             if (open) {
                 void this.sidenav().open();
@@ -11512,14 +11551,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Provides a {@link DbxRouterWebProviderConfig} that configures the application to use Angular Router for rendering segue-ref anchor links.
  *
+ * @returns Environment providers that configure the Angular Router-based segue anchor component.
+ *
  * @example
  * ```typescript
  * bootstrapApplication(AppComponent, {
  *   providers: [provideDbxRouterWebAngularRouterProviderConfig()]
  * });
  * ```
- *
- * @returns environment providers that configure the Angular Router-based segue anchor component
  */
 function provideDbxRouterWebAngularRouterProviderConfig() {
     const config = {
@@ -11565,14 +11604,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Provides a {@link DbxRouterWebProviderConfig} that configures the application to use UIRouter for rendering segue-ref anchor links.
  *
+ * @returns Environment providers that configure the UIRouter-based segue anchor component.
+ *
  * @example
  * ```typescript
  * bootstrapApplication(AppComponent, {
  *   providers: [provideDbxRouterWebUiRouterProviderConfig()]
  * });
  * ```
- *
- * @returns environment providers that configure the UIRouter-based segue anchor component
  */
 function provideDbxRouterWebUiRouterProviderConfig() {
     const config = {
@@ -11814,8 +11853,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 class DbxContentBorderDirective {
     color = input('default', ...(ngDevMode ? [{ debugName: "color" }] : /* istanbul ignore next */ []));
     borderOpacity = input('lite', ...(ngDevMode ? [{ debugName: "borderOpacity" }] : /* istanbul ignore next */ []));
-    borderColorVar = computed(() => dbxThemeColorCssTokenVar(this.color(), true), ...(ngDevMode ? [{ debugName: "borderColorVar" }] : /* istanbul ignore next */ []));
-    borderOpacityValue = computed(() => {
+    borderColorVarSignal = computed(() => dbxThemeColorCssTokenVar(this.color(), true), ...(ngDevMode ? [{ debugName: "borderColorVarSignal" }] : /* istanbul ignore next */ []));
+    borderOpacityValueSignal = computed(() => {
         const color = this.color();
         const opacity = this.borderOpacity();
         let result;
@@ -11833,9 +11872,9 @@ class DbxContentBorderDirective {
                 break;
         }
         return result;
-    }, ...(ngDevMode ? [{ debugName: "borderOpacityValue" }] : /* istanbul ignore next */ []));
+    }, ...(ngDevMode ? [{ debugName: "borderOpacityValueSignal" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: DbxContentBorderDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
-    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "21.2.11", type: DbxContentBorderDirective, isStandalone: true, selector: "dbx-content-border,[dbxContentBorder]", inputs: { color: { classPropertyName: "color", publicName: "color", isSignal: true, isRequired: false, transformFunction: null }, borderOpacity: { classPropertyName: "borderOpacity", publicName: "borderOpacity", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "style.--dbx-border-color": "borderColorVar()", "style.--dbx-border-opacity": "borderOpacityValue()" }, classAttribute: "d-block dbx-content-border" }, ngImport: i0 });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "21.2.11", type: DbxContentBorderDirective, isStandalone: true, selector: "dbx-content-border,[dbxContentBorder]", inputs: { color: { classPropertyName: "color", publicName: "color", isSignal: true, isRequired: false, transformFunction: null }, borderOpacity: { classPropertyName: "borderOpacity", publicName: "borderOpacity", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "style.--dbx-border-color": "borderColorVarSignal()", "style.--dbx-border-opacity": "borderOpacityValueSignal()" }, classAttribute: "d-block dbx-content-border" }, ngImport: i0 });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: DbxContentBorderDirective, decorators: [{
             type: Directive,
@@ -11843,8 +11882,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
                     selector: 'dbx-content-border,[dbxContentBorder]',
                     host: {
                         class: 'd-block dbx-content-border',
-                        '[style.--dbx-border-color]': 'borderColorVar()',
-                        '[style.--dbx-border-opacity]': 'borderOpacityValue()'
+                        '[style.--dbx-border-color]': 'borderColorVarSignal()',
+                        '[style.--dbx-border-opacity]': 'borderOpacityValueSignal()'
                     },
                     standalone: true
                 }]
@@ -12322,16 +12361,17 @@ class DbxListView {
 /**
  * Registers a component as a {@link DbxListView} provider so it can be injected by parent list components.
  *
- * @example
- * ```ts
- * @Component({
+ * @param sourceType - The component class to register as the DbxListView provider.
+ * @returns Array of Angular providers that wire up the component as a DbxListView.
+ *
+ * @Component ({
  *   providers: provideDbxListView(MyCustomListViewComponent)
  * })
  * 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
+ * @example
+ * ```ts
  */
 function provideDbxListView(sourceType) {
     // use of any here is allowed as typings are not relevant for providers
@@ -12361,9 +12401,9 @@ function dbxValueListItemDecisionFunction(decisionFunction) {
  * Extracts a stable tracking key from an item value by checking for `key` ({@link ModelKeyRef}),
  * `id` ({@link UniqueModel}), or falling back to a prefixed index string.
  *
- * @param itemValue - The raw value to extract a key from
- * @param index - The item's position index, used as fallback
- * @returns A string key for tracking the item
+ * @param itemValue - The raw value to extract a key from.
+ * @param index - The item's position index, used as fallback.
+ * @returns Key for tracking the item. (string)
  *
  * @example
  * ```ts
@@ -12378,9 +12418,9 @@ function dbxValueListItemKeyForItemValue(itemValue, index) {
 /**
  * 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
+ * @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
@@ -12396,9 +12436,9 @@ function mapValuesToValuesListItemConfigObs(listViewConfig, itemValues) {
 /**
  * Adds injection component configuration and meta configuration to each list item, producing fully configured {@link DbxValueListItemConfig} entries ready for rendering.
  *
- * @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
+ * @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) => {
@@ -12439,16 +12479,17 @@ 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}
+ * @param sourceType - The component class type to register as the list view provider.
+ * @returns Array of Angular providers that bind the given component to {@link DbxValueListView}
  *
- * @example
- * ```ts
- * @Component({
+ * @Component ({
  *   providers: provideDbxValueListView(MyValueListViewComponent)
  * })
  * export class MyValueListViewComponent extends DbxValueListView<MyItem> { ... }
  * ```
+ *
+ * @example
+ * ```ts
  */
 function provideDbxValueListView(sourceType) {
     return [
@@ -12484,8 +12525,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * 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
+ * @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 = {};
@@ -12505,7 +12546,7 @@ 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
+ * @returns A group delegate that places all items into one unnamed group.
  *
  * @example
  * ```ts
@@ -12520,16 +12561,17 @@ function defaultDbxValueListViewGroupDelegate() {
 /**
  * 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}
+ * @param sourceType - The class type to register as the group delegate provider.
+ * @returns Array of Angular providers that bind the given class to {@link DbxValueListViewGroupDelegate}
  *
- * @example
- * ```ts
- * @Directive({
+ * @Directive ({
  *   providers: provideDbxValueListViewGroupDelegate(MyGroupDelegate)
  * })
  * export class MyGroupDelegate extends DbxValueListViewGroupDelegate<MyGroup, MyItem> { ... }
  * ```
+ *
+ * @example
+ * ```ts
  */
 function provideDbxValueListViewGroupDelegate(sourceType) {
     // use of any here is allowed as typings are not relevant for providers
@@ -12647,9 +12689,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
  * 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
+ * @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;
 /**
@@ -12756,14 +12798,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Flattens grouped accordion items into a single array of render entries with stable track IDs.
  *
+ * @param groups - The grouped items to flatten.
+ * @param trackByFn - The track-by function used to derive stable item identity.
+ * @returns A flat array of render entries for use in a single `@for` loop.
+ *
  * @example
  * ```ts
  * const entries = flattenAccordionGroups(groups, trackByFn);
  * ```
- *
- * @param groups - the grouped items to flatten
- * @param trackByFn - the track-by function used to derive stable item identity
- * @returns a flat array of render entries for use in a single `@for` loop
  */
 function flattenAccordionGroups(groups, trackByFn) {
     const entries = [];
@@ -13023,7 +13065,7 @@ class AbstractDbxListViewDirective {
             valuesObs = asObservable(x);
         }
         else {
-            valuesObs = combineLatest([this._inputValues$, this._inputValuesArray$]).pipe(switchMap(([x, y]) => (y != null ? of(y) : asObservable(x))));
+            valuesObs = combineLatest([this._inputValues$, this._inputValuesArray$]).pipe(switchMap(([x, y]) => (y == null ? asObservable(x) : of(y))));
         }
         return valuesObs;
     }));
@@ -13322,10 +13364,10 @@ const dbxListGridViewComponentImportsAndExports = DBX_LIST_GRID_VIEW_COMPONENT_I
 /**
  * Injection token for providing a default meta icon string to {@link DbxListViewMetaIconComponent} instances.
  */
-const DBX_LIST_VIEW_DEFAULT_META_ICON = new InjectionToken('DBX_LIST_VIEW_DEFAULT_META_ICON');
+const DEFAULT_DBX_LIST_VIEW_META_ICON = new InjectionToken('DEFAULT_DBX_LIST_VIEW_META_ICON');
 /**
  * Displays a Material icon in the meta (trailing) area of a list item. Reads its icon from the item's meta
- * configuration or falls back to a default provided via {@link DBX_LIST_VIEW_DEFAULT_META_ICON}.
+ * configuration or falls back to a default provided via {@link DEFAULT_DBX_LIST_VIEW_META_ICON}.
  *
  * Use the static `metaConfig()` method to create the injection component config for use in list view configurations.
  *
@@ -13336,14 +13378,14 @@ const DBX_LIST_VIEW_DEFAULT_META_ICON = new InjectionToken('DBX_LIST_VIEW_DEFAUL
  */
 class DbxListViewMetaIconComponent {
     item = inject(DBX_VALUE_LIST_VIEW_ITEM, { optional: true });
-    defaultIcon = inject(DBX_LIST_VIEW_DEFAULT_META_ICON, { optional: true });
+    defaultIcon = inject(DEFAULT_DBX_LIST_VIEW_META_ICON, { optional: true });
     icon = this.item?.meta?.icon ?? this.defaultIcon;
     static metaConfig(defaultIcon) {
         return {
             componentClass: DbxListViewMetaIconComponent,
             providers: [
                 {
-                    provide: DBX_LIST_VIEW_DEFAULT_META_ICON,
+                    provide: DEFAULT_DBX_LIST_VIEW_META_ICON,
                     useValue: defaultIcon
                 }
             ]
@@ -13456,7 +13498,16 @@ class DbxListTitleGroupDirective {
     groupValues = (items) => {
         return this._delegate$.pipe(map((delegate) => {
             let groups;
-            if (delegate != null) {
+            if (delegate == null) {
+                groups = [
+                    {
+                        id: '_',
+                        data: { value: null, title: '' },
+                        items
+                    }
+                ];
+            }
+            else {
                 const groupsValuesMap = makeValuesGroupMap(items, delegate.groupValueForItem);
                 const { sortGroupsByData, cssClasses: inputCssClasses } = delegate;
                 const cssClassesForAllGroups = inputCssClasses ?? [];
@@ -13486,15 +13537,6 @@ class DbxListTitleGroupDirective {
                     groups.sort(compareWithMappedValuesFunction((x) => x.data, sortGroupsByData));
                 }
             }
-            else {
-                groups = [
-                    {
-                        id: '_',
-                        data: { value: null, title: '' },
-                        items
-                    }
-                ];
-            }
             return groups;
         }));
     };
@@ -13518,10 +13560,10 @@ 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
+ * @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) => {
+const DEFAULT_DBX_LIST_ITEM_DISABLE_FUNCTION = (item) => {
     return item.rippleDisabled || !item.anchor || (!item.anchor.ref && !item.anchor.url && !item.anchor.onClick);
 };
 /**
@@ -13535,7 +13577,7 @@ const DBX_LIST_ITEM_DEFAULT_DISABLE_FUNCTION = (item) => {
  */
 class DbxListItemDisableRippleModifierDirective extends AbstractDbxValueListItemModifierDirective {
     disableRippleForItem = input(undefined, { ...(ngDevMode ? { debugName: "disableRippleForItem" } : /* istanbul ignore next */ {}), alias: 'dbxListItemDisableRippleModifier', transform: transformEmptyStringInputToUndefined });
-    disableRippleForItemModifiers$ = toObservable(this.disableRippleForItem).pipe(map((x) => x ?? DBX_LIST_ITEM_DEFAULT_DISABLE_FUNCTION), map((disableRippleForItem) => {
+    disableRippleForItemModifiers$ = toObservable(this.disableRippleForItem).pipe(map((x) => x ?? DEFAULT_DBX_LIST_ITEM_DISABLE_FUNCTION), map((disableRippleForItem) => {
         const modifiers = {
             key: DBX_LIST_ITEM_DISABLE_RIPPLE_LIST_ITEM_MODIFIER_KEY,
             modify: (x) => {
@@ -13568,8 +13610,8 @@ 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
+ * @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;
@@ -13709,11 +13751,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Default infinite scroll distance multiplier for triggering load-more events.
  */
-const DBX_LIST_DEFAULT_SCROLL_DISTANCE = 1.5;
+const DEFAULT_DBX_LIST_SCROLL_DISTANCE = 1.5;
 /**
  * Default throttle duration in milliseconds for scroll events.
  */
-const DBX_LIST_DEFAULT_THROTTLE_SCROLL = 50;
+const DEFAULT_DBX_LIST_THROTTLE_SCROLL = 50;
 /**
  * Displays a potentially infinitely scrollable list of content. Supports load-more triggers, selection modes, and empty/loading states.
  *
@@ -13769,8 +13811,8 @@ class DbxListComponent {
     selectionMode$ = toObservable(this.selectionMode).pipe(distinctUntilChanged(), shareReplay(1));
     hideOnEmpty$ = this.config$.pipe(filterMaybe(), map((x) => Boolean(x.hideOnEmpty)), distinctUntilChanged(), shareReplay(1));
     invertedList$ = this.config$.pipe(filterMaybe(), map((x) => Boolean(x?.throttle)), distinctUntilChanged(), shareReplay(1));
-    throttleScroll$ = this.config$.pipe(map((x) => x?.throttle ?? DBX_LIST_DEFAULT_THROTTLE_SCROLL), distinctUntilChanged(), shareReplay(1));
-    scrollDistance$ = this.config$.pipe(map((x) => x?.scrollDistance ?? DBX_LIST_DEFAULT_SCROLL_DISTANCE), distinctUntilChanged(), shareReplay(1));
+    throttleScroll$ = this.config$.pipe(map((x) => x?.throttle ?? DEFAULT_DBX_LIST_THROTTLE_SCROLL), distinctUntilChanged(), shareReplay(1));
+    scrollDistance$ = this.config$.pipe(map((x) => x?.scrollDistance ?? DEFAULT_DBX_LIST_SCROLL_DISTANCE), distinctUntilChanged(), shareReplay(1));
     scrollLoadMoreTrigger$ = this.config$.pipe(switchMap((config) => {
         const loadNextDirection = config?.invertedList ? 'up' : 'down';
         return this._scrollTrigger.pipe(filter((x) => x === loadNextDirection));
@@ -13835,8 +13877,8 @@ class DbxListComponent {
         }
         return this.hideOnEmpty$.pipe(switchMap((hide) => (hide === false ? of(false) : this.isEmpty$)), distinctUntilChanged(), shareReplay(1));
     }), distinctUntilChanged(), shareReplay(1));
-    infiniteScrollDistanceSignal = toSignal(this.scrollDistance$, { initialValue: DBX_LIST_DEFAULT_SCROLL_DISTANCE });
-    infiniteScrollThrottleSignal = toSignal(this.throttleScroll$, { initialValue: DBX_LIST_DEFAULT_THROTTLE_SCROLL });
+    infiniteScrollDistanceSignal = toSignal(this.scrollDistance$, { initialValue: DEFAULT_DBX_LIST_SCROLL_DISTANCE });
+    infiniteScrollThrottleSignal = toSignal(this.throttleScroll$, { initialValue: DEFAULT_DBX_LIST_THROTTLE_SCROLL });
     hideContentSignal = toSignal(this.hideContent$);
     injectedComponentConfigSignal = toSignal(this.injectedComponentConfig$);
     isEmptyAndNotLoadingSignal = toSignal(this.isEmptyAndNotLoading$);
@@ -13847,17 +13889,18 @@ class DbxListComponent {
     }
     getScrollPositionRelativeToBottom() {
         const element = this.nativeElementSignal();
+        let result = 0;
         if (element) {
             try {
                 // At max scroll, scrollHeight = scrollTop + clientHeight;
                 const { scrollTop, scrollHeight, clientHeight } = element;
-                return scrollHeight - (scrollTop + clientHeight);
+                result = scrollHeight - (scrollTop + clientHeight);
             }
             catch {
                 /* ignored */
             }
         }
-        return 0;
+        return result;
     }
     jumpToBottom() {
         const element = this.nativeElementSignal();
@@ -13958,10 +14001,12 @@ class AbstractDbxListWrapperDirective {
     selectionMode = input(...(ngDevMode ? [undefined, { debugName: "selectionMode" }] : /* istanbul ignore next */ []));
     state = input(...(ngDevMode ? [undefined, { debugName: "state" }] : /* istanbul ignore next */ []));
     selectionModeSignal = computed(() => {
-        return this._selectionModeOverrideSignal() ?? this.selectionMode();
+        const selectionMode = this.selectionMode();
+        return this._selectionModeOverrideSignal() ?? selectionMode;
     }, ...(ngDevMode ? [{ debugName: "selectionModeSignal" }] : /* istanbul ignore next */ []));
     disabledSignal = computed(() => {
-        return this._disabledOverrideSignal() ?? this.disabled();
+        const disabled = this.disabled();
+        return this._disabledOverrideSignal() ?? disabled;
     }, ...(ngDevMode ? [{ debugName: "disabledSignal" }] : /* istanbul ignore next */ []));
     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));
@@ -14047,20 +14092,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * 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
+ * @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;
 /**
  * Returns a {@link TrackByFunction} that tracks items by their unique `id` property.
  *
+ * @returns A TrackByFunction that uses the item's `id` for identity tracking.
+ *
  * @example
  * ```ts
  * readonly trackBy = trackByUniqueIdentifier<MyModel>();
  * ```
- *
- * @returns a TrackByFunction that uses the item's `id` for identity tracking
  */
 function trackByUniqueIdentifier() {
     return TRACK_BY_MODEL_ID;
@@ -14068,20 +14113,20 @@ function trackByUniqueIdentifier() {
 /**
  * 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
+ * @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;
 /**
  * Returns a {@link TrackByFunction} that tracks items by their model `key` property.
  *
+ * @returns A TrackByFunction that uses the item's `key` for identity tracking.
+ *
  * @example
  * ```ts
  * readonly trackBy = trackByModelKeyRef<MyModelRef>();
  * ```
- *
- * @returns a TrackByFunction that uses the item's `key` for identity tracking
  */
 function trackByModelKeyRef() {
     return TRACK_BY_MODEL_KEY;
@@ -14295,16 +14340,17 @@ class DbxListViewWrapper {
 /**
  * Registers a component as a {@link DbxListViewWrapper} provider for dependency injection.
  *
- * @example
- * ```ts
- * @Component({
+ * @param sourceType - The component class to register as the DbxListViewWrapper provider.
+ * @returns Array of Angular providers that wire up the component as a DbxListViewWrapper.
+ *
+ * @Component ({
  *   providers: provideDbxListViewWrapper(MyListWrapperComponent)
  * })
  * 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
+ * @example
+ * ```ts
  */
 function provideDbxListViewWrapper(sourceType) {
     return [
@@ -14422,15 +14468,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
  */
 class DbxSectionPageComponent extends DbxSectionHeaderComponent {
     scroll = input('all', ...(ngDevMode ? [{ debugName: "scroll" }] : /* istanbul ignore next */ []));
-    classConfig = computed(() => {
+    classConfigSignal = computed(() => {
         return `dbx-section-page-scroll-${this.scroll()}`;
-    }, ...(ngDevMode ? [{ debugName: "classConfig" }] : /* istanbul ignore next */ []));
+    }, ...(ngDevMode ? [{ debugName: "classConfigSignal" }] : /* istanbul ignore next */ []));
     constructor() {
         super();
         this.hintInlineDefault.set(true);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: DbxSectionPageComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.2.11", type: DbxSectionPageComponent, isStandalone: true, selector: "dbx-section-page", inputs: { scroll: { classPropertyName: "scroll", publicName: "scroll", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "class": "classConfig()" }, classAttribute: "d-block dbx-content-page dbx-section-page" }, usesInheritance: true, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.2.11", type: DbxSectionPageComponent, isStandalone: true, selector: "dbx-section-page", inputs: { scroll: { classPropertyName: "scroll", publicName: "scroll", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "class": "classConfigSignal()" }, classAttribute: "d-block dbx-content-page dbx-section-page" }, usesInheritance: true, ngImport: i0, template: `
     <div class="dbx-section-header" [h]="headerConfigSignal().h ?? 2" [header]="headerConfigSignal().header" [onlyHeader]="headerConfigSignal().onlyHeader" [icon]="headerConfigSignal().icon" [hint]="headerConfigSignal().hint" [hintInline]="headerConfigSignal().hintInline">
       <ng-content select="[sectionHeader]"></ng-content>
     </div>
@@ -14453,7 +14499,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
   `,
                     host: {
                         class: 'd-block dbx-content-page dbx-section-page',
-                        '[class]': 'classConfig()'
+                        '[class]': 'classConfigSignal()'
                     },
                     standalone: true,
                     imports: [DbxSectionHeaderComponent],
@@ -14482,7 +14528,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Injection token for providing the default {@link DbxStyleConfig} to {@link DbxStyleService}.
  */
-const DBX_STYLE_DEFAULT_CONFIG_TOKEN = new InjectionToken('DbxStyleServiceDefaultConfig');
+const DEFAULT_DBX_STYLE_CONFIG_TOKEN = new InjectionToken('DbxStyleServiceDefaultConfig');
 /**
  * Manages application-wide style classes and suffix modes (e.g., dark mode).
  *
@@ -14490,7 +14536,7 @@ const DBX_STYLE_DEFAULT_CONFIG_TOKEN = new InjectionToken('DbxStyleServiceDefaul
  * and toggle style suffixes to switch between style variants at runtime.
  */
 class DbxStyleService {
-    _defaultConfig = new BehaviorSubject(inject(DBX_STYLE_DEFAULT_CONFIG_TOKEN));
+    _defaultConfig = new BehaviorSubject(inject(DEFAULT_DBX_STYLE_CONFIG_TOKEN));
     _config = new BehaviorSubject(undefined);
     _styleClassSuffix = new BehaviorSubject(undefined);
     config$ = this._config.pipe(switchMap((x) => x ?? this._defaultConfig), filterMaybe(), distinctUntilChanged(), shareReplay(1));
@@ -14499,8 +14545,8 @@ class DbxStyleService {
     /**
      * Returns the style class given the input configuration.
      *
-     * @param configObs Observable containing the configuration to use.
-     * @returns DbxStyleClass
+     * @param configObs - Observable containing the configuration to use.
+     * @returns DbxStyleClass.
      */
     getStyleClassWithConfig(configObs) {
         return combineLatest([configObs, this.styleClassSuffix$]).pipe(map(([config, suffix]) => {
@@ -14514,7 +14560,7 @@ class DbxStyleService {
     /**
      * Toggles the dark suffix on/off for the service.
      *
-     * @param toggle Whether to toggle the suffix on or off
+     * @param toggle - Whether to toggle the suffix on or off.
      */
     toggleDarkSuffix(toggle) {
         this.toggleSuffix(DBX_DARK_STYLE_CLASS_SUFFIX, toggle);
@@ -14522,13 +14568,13 @@ class DbxStyleService {
     /**
      * Toggles the arbitrary suffix on/off for the service.
      *
-     * @param suffix The suffix to toggle
-     * @param toggle Whether to toggle the suffix on or off
+     * @param suffix - The suffix to toggle.
+     * @param toggle - Whether to toggle the suffix on or off.
      */
     toggleSuffix(suffix, toggle) {
         // clean the suffix
         suffix = dbxStyleClassCleanSuffix(suffix);
-        const toggleValue = toggle != null ? toggle : this.currentStyleClassSuffix !== suffix;
+        const toggleValue = toggle == null ? this.currentStyleClassSuffix !== suffix : toggle;
         let suffixValue = undefined;
         if (toggleValue) {
             suffixValue = suffix;
@@ -14541,7 +14587,7 @@ 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
+     * @returns The currently active style class suffix, or undefined if none is set.
      */
     get currentStyleClassSuffix() {
         return this._styleClassSuffix.value;
@@ -14549,7 +14595,7 @@ class DbxStyleService {
     /**
      * 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
+     * @param suffix - The suffix to activate, or nullish to clear the current suffix.
      */
     setStyleClassSuffix(suffix) {
         this._styleClassSuffix.next(suffix ? dbxStyleClassCleanSuffix(suffix) : undefined);
@@ -14557,7 +14603,7 @@ class DbxStyleService {
     /**
      * Updates the default style configuration used when no override config is set.
      *
-     * @param defaultConfig - the style configuration to use as the new default
+     * @param defaultConfig - The style configuration to use as the new default.
      */
     setDefaultConfig(defaultConfig) {
         this._defaultConfig.next(defaultConfig);
@@ -14565,7 +14611,7 @@ class DbxStyleService {
     /**
      * 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
+     * @param config - A style configuration value or observable to set as the active override.
      */
     setConfig(config) {
         this._config.next(asObservable(config));
@@ -14573,7 +14619,7 @@ class DbxStyleService {
     /**
      * 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
+     * @param config - The config reference to compare against the current override.
      */
     unsetConfig(config) {
         if (this._config.value === config) {
@@ -14756,6 +14802,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Provides environment-level providers for {@link DbxStyleService}, {@link DbxColorService}, and their default configurations.
  *
+ * @param config - Configuration specifying the default style and optional color templates.
+ * @returns Environment providers for the style and color services and their default config tokens.
+ *
  * @example
  * ```ts
  * provideDbxStyleService({
@@ -14766,8 +14815,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
  * });
  * ```
  *
- * @param config - configuration specifying the default style and optional color templates
- * @returns environment providers for the style and color services and their default config tokens
  * @__NO_SIDE_EFFECTS__
  */
 function provideDbxStyleService(config) {
@@ -14775,7 +14822,7 @@ function provideDbxStyleService(config) {
     const providers = [
         // config
         {
-            provide: DBX_STYLE_DEFAULT_CONFIG_TOKEN,
+            provide: DEFAULT_DBX_STYLE_CONFIG_TOKEN,
             useValue: dbxStyleConfig
         },
         // services
@@ -15170,12 +15217,30 @@ class DbxStepBlockComponent {
     hint = input(...(ngDevMode ? [undefined, { debugName: "hint" }] : /* istanbul ignore next */ []));
     color = input(...(ngDevMode ? [undefined, { debugName: "color" }] : /* istanbul ignore next */ []));
     center = input(...(ngDevMode ? [undefined, { debugName: "center" }] : /* istanbul ignore next */ []));
-    stepSignal = computed(() => this.step() ?? this.config()?.step ?? 1, ...(ngDevMode ? [{ debugName: "stepSignal" }] : /* istanbul ignore next */ []));
-    iconSignal = computed(() => this.icon() ?? this.config()?.icon, ...(ngDevMode ? [{ debugName: "iconSignal" }] : /* istanbul ignore next */ []));
-    headerSignal = computed(() => this.header() ?? this.config()?.header, ...(ngDevMode ? [{ debugName: "headerSignal" }] : /* istanbul ignore next */ []));
-    hintSignal = computed(() => this.hint() ?? this.config()?.hint, ...(ngDevMode ? [{ debugName: "hintSignal" }] : /* istanbul ignore next */ []));
-    colorSignal = computed(() => this.color() ?? this.config()?.color ?? 'primary', ...(ngDevMode ? [{ debugName: "colorSignal" }] : /* istanbul ignore next */ []));
-    centerSignal = computed(() => this.center() ?? this.config()?.center ?? false, ...(ngDevMode ? [{ debugName: "centerSignal" }] : /* istanbul ignore next */ []));
+    stepSignal = computed(() => {
+        const config = this.config();
+        return this.step() ?? config?.step ?? 1;
+    }, ...(ngDevMode ? [{ debugName: "stepSignal" }] : /* istanbul ignore next */ []));
+    iconSignal = computed(() => {
+        const config = this.config();
+        return this.icon() ?? config?.icon;
+    }, ...(ngDevMode ? [{ debugName: "iconSignal" }] : /* istanbul ignore next */ []));
+    headerSignal = computed(() => {
+        const config = this.config();
+        return this.header() ?? config?.header;
+    }, ...(ngDevMode ? [{ debugName: "headerSignal" }] : /* istanbul ignore next */ []));
+    hintSignal = computed(() => {
+        const config = this.config();
+        return this.hint() ?? config?.hint;
+    }, ...(ngDevMode ? [{ debugName: "hintSignal" }] : /* istanbul ignore next */ []));
+    colorSignal = computed(() => {
+        const config = this.config();
+        return this.color() ?? config?.color ?? 'primary';
+    }, ...(ngDevMode ? [{ debugName: "colorSignal" }] : /* istanbul ignore next */ []));
+    centerSignal = computed(() => {
+        const config = this.config();
+        return this.center() ?? config?.center ?? false;
+    }, ...(ngDevMode ? [{ debugName: "centerSignal" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: DbxStepBlockComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
     static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.11", type: DbxStepBlockComponent, isStandalone: true, selector: "dbx-step-block", inputs: { config: { classPropertyName: "config", publicName: "config", isSignal: true, isRequired: false, transformFunction: null }, step: { classPropertyName: "step", publicName: "step", isSignal: true, isRequired: false, transformFunction: null }, icon: { classPropertyName: "icon", publicName: "icon", isSignal: true, isRequired: false, transformFunction: null }, header: { classPropertyName: "header", publicName: "header", isSignal: true, isRequired: false, transformFunction: null }, hint: { classPropertyName: "hint", publicName: "hint", isSignal: true, isRequired: false, transformFunction: null }, color: { classPropertyName: "color", publicName: "color", isSignal: true, isRequired: false, transformFunction: null }, center: { classPropertyName: "center", publicName: "center", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "class.dbx-step-block-center": "centerSignal()" }, classAttribute: "dbx-step-block d-block" }, ngImport: i0, template: `
     <dbx-icon-tile class="dbx-step-block-badge" [icon]="iconSignal()" [dbxColor]="colorSignal()">
@@ -15291,7 +15356,7 @@ class DbxLinkifyService {
     /**
      * Registers the default entry.
      *
-     * @param entry Entry without the type field
+     * @param entry - Entry without the type field.
      */
     registerDefaultEntry(entry) {
         this._entries.set(DEFAULT_DBX_LINKIFY_STRING_TYPE, {
@@ -15302,8 +15367,8 @@ class DbxLinkifyService {
     /**
      * Registers one or more entries by type.
      *
-     * @param entries One or more entries to register
-     * @param override Whether to override existing entries (default: true)
+     * @param entries - One or more entries to register.
+     * @param override - Whether to override existing entries (default: true)
      */
     register(entries, override = true) {
         useIterableOrValue(entries, (entry) => {
@@ -15316,7 +15381,7 @@ class DbxLinkifyService {
     /**
      * Returns the default entry.
      *
-     * @returns the default linkify service entry, or undefined if none is registered
+     * @returns The default linkify service entry, or undefined if none is registered.
      */
     getDefaultEntry() {
         return this._entries.get(DEFAULT_DBX_LINKIFY_STRING_TYPE);
@@ -15324,8 +15389,8 @@ class DbxLinkifyService {
     /**
      * 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
+     * @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);
@@ -15333,8 +15398,8 @@ class DbxLinkifyService {
     /**
      * 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
+     * @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();
@@ -15405,6 +15470,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Creates environment-level providers for configuring {@link DbxLinkifyService} with a custom factory.
  *
+ * @param config - Configuration containing the factory function for creating the linkify service config.
+ * @returns Environment providers that register the DbxLinkifyServiceConfig.
+ *
  * @example
  * ```ts
  * provideDbxLinkify({
@@ -15414,9 +15482,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
  *   })
  * });
  * ```
- *
- * @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;
@@ -15432,7 +15497,7 @@ function provideDbxLinkify(config) {
 /**
  * Default background tone percentage for tonal chip coloring.
  */
-const DBX_CHIP_DEFAULT_TONE = 18;
+const DEFAULT_DBX_CHIP_TONE = 18;
 /**
  * Renders a styled chip element with optional small, block, and color modes.
  *
@@ -15467,12 +15532,15 @@ class DbxChipDirective {
      */
     display = input(...(ngDevMode ? [undefined, { debugName: "display" }] : /* istanbul ignore next */ []));
     /**
-     * Background tone level for tonal appearance. Defaults to {@link DBX_CHIP_DEFAULT_TONE}.
+     * Background tone level for tonal appearance. Defaults to {@link DEFAULT_DBX_CHIP_TONE}.
      *
      * Set to `100` for fully opaque background.
      */
     tone = input(...(ngDevMode ? [undefined, { debugName: "tone" }] : /* istanbul ignore next */ []));
-    colorSignal = computed(() => this.color() ?? this.display()?.color, ...(ngDevMode ? [{ debugName: "colorSignal" }] : /* istanbul ignore next */ []));
+    colorSignal = computed(() => {
+        const display = this.display();
+        return this.color() ?? display?.color;
+    }, ...(ngDevMode ? [{ debugName: "colorSignal" }] : /* istanbul ignore next */ []));
     _configSignal = computed(() => {
         const value = this.colorSignal();
         return isDbxColorConfig(value) ? (this._colorService?.expandColorConfig(value) ?? value) : undefined;
@@ -15485,7 +15553,11 @@ class DbxChipDirective {
      * Inline `--dbx-color-current` value applied when a {@link DbxColorConfig} is bound. Resolves to `null` for named-color strings.
      */
     colorStyleSignal = computed(() => this._configSignal()?.contrast ?? null, ...(ngDevMode ? [{ debugName: "colorStyleSignal" }] : /* istanbul ignore next */ []));
-    toneSignal = computed(() => this.tone() ?? this.display()?.tone ?? this._configSignal()?.tone ?? DBX_CHIP_DEFAULT_TONE, ...(ngDevMode ? [{ debugName: "toneSignal" }] : /* istanbul ignore next */ []));
+    toneSignal = computed(() => {
+        const display = this.display();
+        const _config = this._configSignal();
+        return this.tone() ?? display?.tone ?? _config?.tone ?? DEFAULT_DBX_CHIP_TONE;
+    }, ...(ngDevMode ? [{ debugName: "toneSignal" }] : /* istanbul ignore next */ []));
     styleSignal = computed(() => {
         const display = this.display();
         const small = this.small() ?? display?.small;
@@ -15505,9 +15577,10 @@ class DbxChipDirective {
      * Only applied when a color is set.
      */
     bgToneStyleSignal = computed(() => {
+        const tone = this.toneSignal();
         const color = this.colorSignal();
         if (color) {
-            return `${this.toneSignal()}%`;
+            return `${tone}%`;
         }
         return null;
     }, ...(ngDevMode ? [{ debugName: "bgToneStyleSignal" }] : /* istanbul ignore next */ []));
@@ -15517,8 +15590,9 @@ class DbxChipDirective {
      * an inline style binding (which would conflict with `[ngStyle]`).
      */
     isTonalSignal = computed(() => {
+        const tone = this.toneSignal();
         const color = this.colorSignal();
-        return Boolean(color) && this.toneSignal() < 100;
+        return Boolean(color) && tone < 100;
     }, ...(ngDevMode ? [{ debugName: "isTonalSignal" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: DbxChipDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
     static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "21.2.11", type: DbxChipDirective, isStandalone: true, selector: "dbx-chip", inputs: { small: { classPropertyName: "small", publicName: "small", isSignal: true, isRequired: false, transformFunction: null }, block: { classPropertyName: "block", publicName: "block", isSignal: true, isRequired: false, transformFunction: null }, color: { classPropertyName: "color", publicName: "color", isSignal: true, isRequired: false, transformFunction: null }, display: { classPropertyName: "display", publicName: "display", isSignal: true, isRequired: false, transformFunction: null }, tone: { classPropertyName: "tone", publicName: "tone", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "class": "styleSignal()", "class.dbx-color-tonal": "isTonalSignal()", "style.--dbx-color-bg-tone": "bgToneStyleSignal()", "style.--dbx-bg-color-current": "bgColorStyleSignal()", "style.--dbx-color-current": "colorStyleSignal()" }, classAttribute: "dbx-chip mat-standard-chip" }, ngImport: i0 });
@@ -15606,8 +15680,8 @@ class DbxTextChipsComponent {
     /**
      * Returns the themed background CSS class for a chip's color.
      *
-     * @param chip - the chip to get the color class for
-     * @returns the CSS class name for the chip's background color, or empty string if no color
+     * @param chip - The chip to get the color class for.
+     * @returns The CSS class name for the chip's background color, or empty string if no color.
      */
     chipColorClass(chip) {
         return chip.color ? dbxColorBackground(chip.color) : '';
@@ -15615,8 +15689,8 @@ class DbxTextChipsComponent {
     /**
      * Returns the inline `--dbx-bg-color-current` value for a chip when its color is a {@link DbxColorConfig}; otherwise null.
      *
-     * @param chip - the chip
-     * @returns the background color CSS value, or null for named-color strings
+     * @param chip - The chip.
+     * @returns The background color CSS value, or null for named-color strings.
      */
     chipBgColorStyle(chip) {
         return this._expandedChipConfig(chip)?.color ?? null;
@@ -15624,8 +15698,8 @@ class DbxTextChipsComponent {
     /**
      * Returns the inline `--dbx-color-current` value for a chip when its color is a {@link DbxColorConfig}; otherwise null.
      *
-     * @param chip - the chip
-     * @returns the contrast color CSS value, or null for named-color strings
+     * @param chip - The chip.
+     * @returns The contrast color CSS value, or null for named-color strings.
      */
     chipColorStyle(chip) {
         return this._expandedChipConfig(chip)?.contrast ?? null;
@@ -15687,7 +15761,7 @@ class DbxNumberWithLimitComponent {
     }, ...(ngDevMode ? [{ debugName: "valueSignal" }] : /* istanbul ignore next */ []));
     limitSignal = computed(() => {
         const number = this.number();
-        return number?.limit != null ? (number?.formatNumber ? number.formatNumber(number.limit) : number?.limit) : undefined;
+        return number?.limit == null ? undefined : number?.formatNumber ? number.formatNumber(number.limit) : number?.limit;
     }, ...(ngDevMode ? [{ debugName: "limitSignal" }] : /* istanbul ignore next */ []));
     hasLimitSignal = computed(() => {
         return this.number()?.limit != null;
@@ -15916,8 +15990,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * 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"
+ * @param entry - The zip entry tree node to determine the icon for.
+ * @returns The Material icon name: "folder", "note", or "question_mark".
  *
  * @example
  * ```typescript
@@ -16068,11 +16142,11 @@ class DbxZipBlobPreviewComponent {
      * If not defined, then the file cannot be downloaded directly.
      */
     downloadFileName = input(...(ngDevMode ? [undefined, { debugName: "downloadFileName" }] : /* istanbul ignore next */ []));
-    hasBlob = computed(() => !!this.blob(), ...(ngDevMode ? [{ debugName: "hasBlob" }] : /* istanbul ignore next */ []));
-    zipReader = computed(() => {
+    hasBlobSignal = computed(() => !!this.blob(), ...(ngDevMode ? [{ debugName: "hasBlobSignal" }] : /* istanbul ignore next */ []));
+    zipReaderSignal = computed(() => {
         const blob = this.blob();
         return blob ? new ZipReader(new BlobReader(blob)) : undefined;
-    }, ...(ngDevMode ? [{ debugName: "zipReader" }] : /* istanbul ignore next */ []));
+    }, ...(ngDevMode ? [{ debugName: "zipReaderSignal" }] : /* istanbul ignore next */ []));
     downloadZipFileBlobButtonConfigSignal = computed(() => {
         const blob = this.blob();
         const fileName = this.downloadFileName();
@@ -16094,7 +16168,7 @@ class DbxZipBlobPreviewComponent {
         }
         return result;
     }, ...(ngDevMode ? [{ debugName: "downloadZipFileBlobButtonConfigSignal" }] : /* istanbul ignore next */ []));
-    zipReader$ = toObservable(this.zipReader);
+    zipReader$ = toObservable(this.zipReaderSignal);
     allEntriesLoadingState$ = loadingStateFromObs(this.zipReader$.pipe(switchMap((x) => (x ? x.getEntries() : of([])))));
     allEntries$ = this.allEntriesLoadingState$.pipe(valueFromFinishedLoadingState(), distinctUntilChanged(), shareReplay(1));
     allEntriesRoot$ = this.allEntries$.pipe(map((x) => dbxZipBlobPreviewEntryTreeFromEntries(x)), shareReplay(1));
@@ -16118,15 +16192,15 @@ class DbxZipBlobPreviewComponent {
             return a.sort - b.sort;
         }
     };
-    mode = computed(() => {
+    modeSignal = computed(() => {
         const selectedNode = this.selectedNodeSignal();
         let mode = 'view_directory';
         if (selectedNode && !selectedNode.value.value.directory) {
             mode = 'view_entry';
         }
         return mode;
-    }, ...(ngDevMode ? [{ debugName: "mode" }] : /* istanbul ignore next */ []));
-    listEntries = computed(() => {
+    }, ...(ngDevMode ? [{ debugName: "modeSignal" }] : /* istanbul ignore next */ []));
+    listEntriesSignal = computed(() => {
         const allEntries = this.allEntriesRootSignal();
         const selectedNode = this.selectedNodeSignal();
         let entries;
@@ -16142,8 +16216,8 @@ class DbxZipBlobPreviewComponent {
             entries = allEntries?.children;
         }
         return entries ?? [];
-    }, ...(ngDevMode ? [{ debugName: "listEntries" }] : /* istanbul ignore next */ []));
-    listEntries$ = toObservable(this.listEntries);
+    }, ...(ngDevMode ? [{ debugName: "listEntriesSignal" }] : /* istanbul ignore next */ []));
+    listEntries$ = toObservable(this.listEntriesSignal);
     listEntriesState$ = loadingStateFromObs(this.listEntries$);
     selectedNodeIconSignal = computed(() => {
         const selectedNode = this.selectedNodeSignal();
@@ -16188,11 +16262,11 @@ class DbxZipBlobPreviewComponent {
         this.selectedNodeSignal.set(selectedNode?.parent);
     };
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: DbxZipBlobPreviewComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.11", type: DbxZipBlobPreviewComponent, isStandalone: true, selector: "dbx-zip-blob-preview", inputs: { blob: { classPropertyName: "blob", publicName: "blob", isSignal: true, isRequired: false, transformFunction: null }, downloadFileName: { classPropertyName: "downloadFileName", publicName: "downloadFileName", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: "<dbx-loading [context]=\"context\">\n  <div class=\"dbx-flex-bar dbx-zip-blob-preview-toolbar\">\n    <dbx-button [disabled]=\"!selectedNodeSignal()\" icon=\"arrow_upward\" text=\"Back\" (buttonClick)=\"backClicked()\"></dbx-button>\n    <dbx-button-spacer></dbx-button-spacer>\n    <dbx-button [disabled]=\"!selectedNodeSignal()\" icon=\"home\" text=\"Home\" (buttonClick)=\"homeClicked()\"></dbx-button>\n    <dbx-spacer></dbx-spacer>\n    @if (downloadZipFileBlobButtonConfigSignal()) {\n      <dbx-download-blob-button [config]=\"downloadZipFileBlobButtonConfigSignal()\"></dbx-download-blob-button>\n    }\n  </div>\n  <dbx-bar-header class=\"dbx-zip-blob-preview-header\" [icon]=\"selectedNodeIconSignal()\" [text]=\"selectedNodePathSignal()\"></dbx-bar-header>\n  <div class=\"dbx-zip-blob-preview-content\">\n    @switch (mode()) {\n      @case ('view_directory') {\n        <dbx-zip-preview-file-entry-list [state]=\"listEntriesState$\" [dbxListTitleGroup]=\"listTitleGroupDelegate\" [dbxListItemModifier] [dbxListItemAnchorModifier]=\"makeEntryAnchor\"></dbx-zip-preview-file-entry-list>\n      }\n      @case ('view_entry') {\n        <dbx-embed class=\"dbx-zip-blob-preview-content-embed\" [blob]=\"selectedFileEntryBlobSignal()\"></dbx-embed>\n      }\n    }\n  </div>\n</dbx-loading>\n", dependencies: [{ kind: "ngmodule", type: MatToolbarModule }, { kind: "directive", type: DbxButtonSpacerDirective, selector: "dbx-button-spacer,[dbxButtonSpacer]" }, { kind: "component", type: DbxButtonComponent, selector: "dbx-button", inputs: ["bar", "type", "buttonStyle", "color", "spinnerColor", "customButtonColor", "customTextColor", "customSpinnerColor", "basic", "tonal", "raised", "stroked", "flat", "iconOnly", "fab", "customContent", "allowClickPropagation", "mode"] }, { kind: "component", type: DbxBarHeaderComponent, selector: "dbx-bar-header", inputs: ["text", "icon", "color"] }, { kind: "directive", type: DbxListTitleGroupDirective, selector: "[dbxListTitleGroup]", inputs: ["dbxListTitleGroup"] }, { kind: "component", type: DbxZipPreviewEntryListComponent, selector: "dbx-zip-preview-file-entry-list" }, { kind: "component", type: DbxEmbedComponent, selector: "dbx-embed", inputs: ["embedElement", "sanitizeUrl", "srcUrl", "type", "blob"], outputs: ["embedElementChange", "sanitizeUrlChange", "srcUrlChange", "typeChange", "blobChange"] }, { kind: "component", type: DbxLoadingComponent, selector: "dbx-loading", inputs: ["padding", "show", "text", "mode", "color", "diameter", "linear", "loading", "error", "context"] }, { kind: "directive", type: DbxValueListItemModifierDirective, selector: "dbxListItemModifier,[dbxListItemModifier]", inputs: ["dbxListItemModifier"] }, { kind: "directive", type: DbxListItemAnchorModifierDirective, selector: "[dbxListItemAnchorModifier]", inputs: ["dbxListItemAnchorModifier"] }, { kind: "component", type: DbxDownloadBlobButtonComponent, selector: "dbx-download-blob-button", inputs: ["config"] }, { kind: "directive", type: DbxSpacerDirective, selector: "dbx-spacer, [dbxSpacer]" }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.11", type: DbxZipBlobPreviewComponent, isStandalone: true, selector: "dbx-zip-blob-preview", inputs: { blob: { classPropertyName: "blob", publicName: "blob", isSignal: true, isRequired: false, transformFunction: null }, downloadFileName: { classPropertyName: "downloadFileName", publicName: "downloadFileName", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: "<dbx-loading [context]=\"context\">\n  <div class=\"dbx-flex-bar dbx-zip-blob-preview-toolbar\">\n    <dbx-button [disabled]=\"!selectedNodeSignal()\" icon=\"arrow_upward\" text=\"Back\" (buttonClick)=\"backClicked()\"></dbx-button>\n    <dbx-button-spacer></dbx-button-spacer>\n    <dbx-button [disabled]=\"!selectedNodeSignal()\" icon=\"home\" text=\"Home\" (buttonClick)=\"homeClicked()\"></dbx-button>\n    <dbx-spacer></dbx-spacer>\n    @if (downloadZipFileBlobButtonConfigSignal()) {\n      <dbx-download-blob-button [config]=\"downloadZipFileBlobButtonConfigSignal()\"></dbx-download-blob-button>\n    }\n  </div>\n  <dbx-bar-header class=\"dbx-zip-blob-preview-header\" [icon]=\"selectedNodeIconSignal()\" [text]=\"selectedNodePathSignal()\"></dbx-bar-header>\n  <div class=\"dbx-zip-blob-preview-content\">\n    @switch (modeSignal()) {\n      @case ('view_directory') {\n        <dbx-zip-preview-file-entry-list [state]=\"listEntriesState$\" [dbxListTitleGroup]=\"listTitleGroupDelegate\" [dbxListItemModifier] [dbxListItemAnchorModifier]=\"makeEntryAnchor\"></dbx-zip-preview-file-entry-list>\n      }\n      @case ('view_entry') {\n        <dbx-embed class=\"dbx-zip-blob-preview-content-embed\" [blob]=\"selectedFileEntryBlobSignal()\"></dbx-embed>\n      }\n    }\n  </div>\n</dbx-loading>\n", dependencies: [{ kind: "ngmodule", type: MatToolbarModule }, { kind: "directive", type: DbxButtonSpacerDirective, selector: "dbx-button-spacer,[dbxButtonSpacer]" }, { kind: "component", type: DbxButtonComponent, selector: "dbx-button", inputs: ["bar", "type", "buttonStyle", "color", "spinnerColor", "customButtonColor", "customTextColor", "customSpinnerColor", "basic", "tonal", "raised", "stroked", "flat", "iconOnly", "fab", "customContent", "allowClickPropagation", "mode"] }, { kind: "component", type: DbxBarHeaderComponent, selector: "dbx-bar-header", inputs: ["text", "icon", "color"] }, { kind: "directive", type: DbxListTitleGroupDirective, selector: "[dbxListTitleGroup]", inputs: ["dbxListTitleGroup"] }, { kind: "component", type: DbxZipPreviewEntryListComponent, selector: "dbx-zip-preview-file-entry-list" }, { kind: "component", type: DbxEmbedComponent, selector: "dbx-embed", inputs: ["embedElement", "sanitizeUrl", "srcUrl", "type", "blob"], outputs: ["embedElementChange", "sanitizeUrlChange", "srcUrlChange", "typeChange", "blobChange"] }, { kind: "component", type: DbxLoadingComponent, selector: "dbx-loading", inputs: ["padding", "show", "text", "mode", "color", "diameter", "linear", "loading", "error", "context"] }, { kind: "directive", type: DbxValueListItemModifierDirective, selector: "dbxListItemModifier,[dbxListItemModifier]", inputs: ["dbxListItemModifier"] }, { kind: "directive", type: DbxListItemAnchorModifierDirective, selector: "[dbxListItemAnchorModifier]", inputs: ["dbxListItemAnchorModifier"] }, { kind: "component", type: DbxDownloadBlobButtonComponent, selector: "dbx-download-blob-button", inputs: ["config"] }, { kind: "directive", type: DbxSpacerDirective, selector: "dbx-spacer, [dbxSpacer]" }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImport: i0, type: DbxZipBlobPreviewComponent, decorators: [{
             type: Component,
-            args: [{ selector: 'dbx-zip-blob-preview', standalone: true, imports: [MatToolbarModule, DbxButtonSpacerDirective, DbxButtonComponent, DbxBarHeaderComponent, DbxListTitleGroupDirective, DbxZipPreviewEntryListComponent, DbxEmbedComponent, DbxLoadingComponent, DbxValueListItemModifierDirective, DbxListItemAnchorModifierDirective, DbxListTitleGroupDirective, DbxDownloadBlobButtonComponent, DbxSpacerDirective], changeDetection: ChangeDetectionStrategy.OnPush, template: "<dbx-loading [context]=\"context\">\n  <div class=\"dbx-flex-bar dbx-zip-blob-preview-toolbar\">\n    <dbx-button [disabled]=\"!selectedNodeSignal()\" icon=\"arrow_upward\" text=\"Back\" (buttonClick)=\"backClicked()\"></dbx-button>\n    <dbx-button-spacer></dbx-button-spacer>\n    <dbx-button [disabled]=\"!selectedNodeSignal()\" icon=\"home\" text=\"Home\" (buttonClick)=\"homeClicked()\"></dbx-button>\n    <dbx-spacer></dbx-spacer>\n    @if (downloadZipFileBlobButtonConfigSignal()) {\n      <dbx-download-blob-button [config]=\"downloadZipFileBlobButtonConfigSignal()\"></dbx-download-blob-button>\n    }\n  </div>\n  <dbx-bar-header class=\"dbx-zip-blob-preview-header\" [icon]=\"selectedNodeIconSignal()\" [text]=\"selectedNodePathSignal()\"></dbx-bar-header>\n  <div class=\"dbx-zip-blob-preview-content\">\n    @switch (mode()) {\n      @case ('view_directory') {\n        <dbx-zip-preview-file-entry-list [state]=\"listEntriesState$\" [dbxListTitleGroup]=\"listTitleGroupDelegate\" [dbxListItemModifier] [dbxListItemAnchorModifier]=\"makeEntryAnchor\"></dbx-zip-preview-file-entry-list>\n      }\n      @case ('view_entry') {\n        <dbx-embed class=\"dbx-zip-blob-preview-content-embed\" [blob]=\"selectedFileEntryBlobSignal()\"></dbx-embed>\n      }\n    }\n  </div>\n</dbx-loading>\n" }]
+            args: [{ selector: 'dbx-zip-blob-preview', standalone: true, imports: [MatToolbarModule, DbxButtonSpacerDirective, DbxButtonComponent, DbxBarHeaderComponent, DbxListTitleGroupDirective, DbxZipPreviewEntryListComponent, DbxEmbedComponent, DbxLoadingComponent, DbxValueListItemModifierDirective, DbxListItemAnchorModifierDirective, DbxListTitleGroupDirective, DbxDownloadBlobButtonComponent, DbxSpacerDirective], changeDetection: ChangeDetectionStrategy.OnPush, template: "<dbx-loading [context]=\"context\">\n  <div class=\"dbx-flex-bar dbx-zip-blob-preview-toolbar\">\n    <dbx-button [disabled]=\"!selectedNodeSignal()\" icon=\"arrow_upward\" text=\"Back\" (buttonClick)=\"backClicked()\"></dbx-button>\n    <dbx-button-spacer></dbx-button-spacer>\n    <dbx-button [disabled]=\"!selectedNodeSignal()\" icon=\"home\" text=\"Home\" (buttonClick)=\"homeClicked()\"></dbx-button>\n    <dbx-spacer></dbx-spacer>\n    @if (downloadZipFileBlobButtonConfigSignal()) {\n      <dbx-download-blob-button [config]=\"downloadZipFileBlobButtonConfigSignal()\"></dbx-download-blob-button>\n    }\n  </div>\n  <dbx-bar-header class=\"dbx-zip-blob-preview-header\" [icon]=\"selectedNodeIconSignal()\" [text]=\"selectedNodePathSignal()\"></dbx-bar-header>\n  <div class=\"dbx-zip-blob-preview-content\">\n    @switch (modeSignal()) {\n      @case ('view_directory') {\n        <dbx-zip-preview-file-entry-list [state]=\"listEntriesState$\" [dbxListTitleGroup]=\"listTitleGroupDelegate\" [dbxListItemModifier] [dbxListItemAnchorModifier]=\"makeEntryAnchor\"></dbx-zip-preview-file-entry-list>\n      }\n      @case ('view_entry') {\n        <dbx-embed class=\"dbx-zip-blob-preview-content-embed\" [blob]=\"selectedFileEntryBlobSignal()\"></dbx-embed>\n      }\n    }\n  </div>\n</dbx-loading>\n" }]
         }], propDecorators: { blob: [{ type: i0.Input, args: [{ isSignal: true, alias: "blob", required: false }] }], downloadFileName: [{ type: i0.Input, args: [{ isSignal: true, alias: "downloadFileName", required: false }] }] } });
 
 /**
@@ -16262,8 +16336,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Opens a dialog with DbxZipPreviewComponent.
  *
- * @param matDialog The MatDialog instance to use.
- * @param config The configuration for the dialog.
+ * @param matDialog - The MatDialog instance to use.
+ * @param config - The configuration for the dialog.
  * @returns The MatDialogRef for the dialog.
  */
 function openZipPreviewDialog(matDialog, config) {
@@ -16292,8 +16366,8 @@ function openZipPreviewDialog(matDialog, config) {
 /**
  * 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
+ * @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;
@@ -16470,12 +16544,13 @@ class DbxWebPageTitleService {
      */
     leafReference$ = this._references.pipe(switchMap((set) => {
         const refs = [...set];
-        if (refs.length === 0)
-            return of(undefined);
-        return combineLatest(refs.map((ref) => ref.isLeaf$.pipe(map((isLeaf) => ({ ref, isLeaf }))))).pipe(map((items) => items
-            .filter((x) => x.isLeaf)
-            .map((x) => x.ref)
-            .at(-1)));
+        const obs = refs.length === 0
+            ? of(undefined)
+            : combineLatest(refs.map((ref) => ref.isLeaf$.pipe(map((isLeaf) => ({ ref, isLeaf }))))).pipe(map((items) => items
+                .filter((x) => x.isLeaf)
+                .map((x) => x.ref)
+                .at(-1)));
+        return obs;
     }), distinctUntilChanged(), shareReplay(1));
     /**
      * The directive-supplied chain (root → leaf) for the active leaf. Empty when there is no active leaf. Excludes the service-level rootConfig (delivered separately to the delegate).
@@ -16590,9 +16665,9 @@ class DbxWebPageTitleInfoDirective {
         });
     }
     /**
-     * @internal Maintained by descendant directives to keep `isLeaf$` accurate.
-     *
      * @param child - The descendant directive to register as a child.
+     *
+     * @internal Maintained by descendant directives to keep `isLeaf$` accurate.
      */
     _addChild(child) {
         const next = new Set(this._children.value);
@@ -16600,9 +16675,9 @@ class DbxWebPageTitleInfoDirective {
         this._children.next(next);
     }
     /**
-     * @internal
-     *
      * @param child - The descendant directive to unregister.
+     *
+     * @internal
      */
     _removeChild(child) {
         const next = new Set(this._children.value);
@@ -16655,16 +16730,17 @@ 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 - The widget entry mapping a type identifier to its component class
+     * @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
+     * @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) {
+        let registered = false;
         if (override || !this._entries.has(entry.type)) {
             this._entries.set(entry.type, entry);
-            return true;
+            registered = true;
         }
-        return false;
+        return registered;
     }
     // MARK: Get
     getWidgetIdentifiers() {
@@ -16879,7 +16955,7 @@ class DbxHelpContextService {
     /**
      * Registers a help context reference, adding its keys to the active set.
      *
-     * @param reference - The help context reference to register
+     * @param reference - The help context reference to register.
      */
     register(reference) {
         const referenceSet = this._contextReferences.value;
@@ -16889,7 +16965,7 @@ class DbxHelpContextService {
     /**
      * Unregisters a help context reference, removing its keys from the active set.
      *
-     * @param reference - The help context reference to unregister
+     * @param reference - The help context reference to unregister.
      */
     unregister(reference) {
         const referenceSet = this._contextReferences.value;
@@ -16907,14 +16983,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
  * Registers the given help context keys observable with the {@link DbxHelpContextService}. Must be called within an Angular injection context.
  * Automatically unregisters on destroy, but also returns a destroy function for manual cleanup.
  *
+ * @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.
+ *
  * @example
  * ```typescript
  * // 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
  * @__NO_SIDE_EFFECTS__
  */
 function registerHelpContextKeysWithDbxHelpContextService(helpContextKeys) {
@@ -17000,7 +17077,7 @@ class DbxHelpWidgetService {
     /**
      * Returns the component class used for unrecognized help context keys.
      *
-     * @returns The default widget component class, or undefined if not set
+     * @returns The default widget component class, or undefined if not set.
      */
     getDefaultWidgetComponentClass() {
         return this._defaultWidgetComponentClass;
@@ -17011,7 +17088,7 @@ class DbxHelpWidgetService {
     /**
      * Returns the default icon used for help entries without a specific icon.
      *
-     * @returns The default icon string, or undefined if not set
+     * @returns The default icon string, or undefined if not set.
      */
     getDefaultIcon() {
         return this._defaultIcon;
@@ -17022,7 +17099,7 @@ class DbxHelpWidgetService {
     /**
      * Returns the component config displayed in the popover header, if set.
      *
-     * @returns The popover header component config, or undefined if not set
+     * @returns The popover header component config, or undefined if not set.
      */
     getPopoverHeaderComponentConfig() {
         return this._popoverHeaderComponentConfig;
@@ -17033,7 +17110,7 @@ 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
+     * @returns The help list header component config, or undefined if not set.
      */
     getHelpListHeaderComponentConfig() {
         return this._helpListHeaderComponentConfig;
@@ -17044,7 +17121,7 @@ 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
+     * @returns The help list footer component config, or undefined if not set.
      */
     getHelpListFooterComponentConfig() {
         return this._helpListFooterComponentConfig;
@@ -17057,9 +17134,9 @@ class DbxHelpWidgetService {
      *
      * If an entry with the same identity is already registered, this will override it by default.
      *
-     * @param entries The entries to register
-     * @param override Whether to override existing entries (default: true)
-     * @returns Always returns true after registration completes
+     * @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);
@@ -17074,7 +17151,7 @@ class DbxHelpWidgetService {
     /**
      * Returns all currently registered help context keys.
      *
-     * @returns Array of all registered help context keys
+     * @returns Array of all registered help context keys.
      */
     getAllRegisteredHelpContextKeys() {
         return [...this._entries.keys()];
@@ -17082,8 +17159,8 @@ class DbxHelpWidgetService {
     /**
      * 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
+     * @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);
@@ -17091,8 +17168,8 @@ 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
+     * @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);
@@ -17100,8 +17177,8 @@ class DbxHelpWidgetService {
     /**
      * 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
+     * @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);
@@ -17109,7 +17186,7 @@ class DbxHelpWidgetService {
     /**
      * Returns a cached map of help context keys to their sort priority values.
      *
-     * @returns Map of help context keys to their numeric sort priorities
+     * @returns Map of help context keys to their numeric sort priorities.
      */
     getSortPriorityMap() {
         return this._sortPriorityMap();
@@ -17124,8 +17201,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Creates EnvironmentProviders for the help context system.
  *
- * @param config Optional configuration
- * @returns EnvironmentProviders
+ * @param config - Optional configuration.
+ * @returns EnvironmentProviders.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 function provideDbxHelpServices(config) {
@@ -17437,7 +17515,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * MIME types accepted by the PDF merge editor by default: PDF documents and PNG/JPEG images.
  */
-const PDF_MERGE_DEFAULT_ACCEPT = [PDF_MIME_TYPE, PNG_MIME_TYPE, JPEG_MIME_TYPE];
+const DEFAULT_PDF_MERGE_ACCEPT = [PDF_MIME_TYPE, PNG_MIME_TYPE, JPEG_MIME_TYPE];
 /**
  * MIME type emitted by the merged result blob.
  */
@@ -17696,12 +17774,16 @@ class DbxPdfMergeEditorStore extends ComponentStore {
      */
     removeEntriesBySlotId = this.updater((state, slotId) => ({ ...state, rawEntries: state.rawEntries.filter((entry) => entry.slotId !== slotId) }));
     moveEntry = this.updater((state, move) => {
+        let nextState;
         if (move.previousIndex === move.currentIndex) {
-            return state;
+            nextState = state;
         }
-        const next = [...state.rawEntries];
-        moveItemInArray(next, move.previousIndex, move.currentIndex);
-        return { ...state, rawEntries: next };
+        else {
+            const next = [...state.rawEntries];
+            moveItemInArray(next, move.previousIndex, move.currentIndex);
+            nextState = { ...state, rawEntries: next };
+        }
+        return nextState;
     });
     /**
      * Reorders entries inside a single slot. The `previousIndex`/`currentIndex` are slot-local — the indices a {@link DbxPdfMergeEditorFileUploadComponent} sees in its filtered view of {@link entries$}. The updater translates them to global `rawEntries` positions and applies an in-place {@link moveItemInArray}, leaving entries from other slots untouched.
@@ -17952,8 +18034,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Opens a dialog containing a {@link DbxPdfPreviewComponent} for previewing a PDF blob or URL.
  *
- * @param matDialog The {@link MatDialog} instance to use.
- * @param config Source (blob or URL) and Material dialog options.
+ * @param matDialog - The {@link MatDialog} instance to use.
+ * @param config - Source (blob or URL) and Material dialog options.
  * @returns The {@link MatDialogRef} for the opened dialog.
  */
 function openPdfPreviewDialog(matDialog, config) {
@@ -18000,7 +18082,7 @@ class DbxPdfMergeEditorComponent {
      * Single-slot subscription tracker for the deferred Preview path. Replacing the slot cancels any earlier in-flight wait so rapid clicks (or repeated programmatic calls) cannot stack pending dialogs.
      */
     _pendingPreview = cleanSubscription();
-    accept = input(PDF_MERGE_DEFAULT_ACCEPT, ...(ngDevMode ? [{ debugName: "accept" }] : /* istanbul ignore next */ []));
+    accept = input(DEFAULT_PDF_MERGE_ACCEPT, ...(ngDevMode ? [{ debugName: "accept" }] : /* istanbul ignore next */ []));
     multiple = input(true, ...(ngDevMode ? [{ debugName: "multiple" }] : /* istanbul ignore next */ []));
     fileName = input(DEFAULT_MERGED_FILE_NAME, ...(ngDevMode ? [{ debugName: "fileName" }] : /* istanbul ignore next */ []));
     showDownloadButton = input(false, ...(ngDevMode ? [{ debugName: "showDownloadButton" }] : /* istanbul ignore next */ []));
@@ -18024,7 +18106,10 @@ class DbxPdfMergeEditorComponent {
     /**
      * Computed gate for the Preview and Download affordances. Disabled while no entry is `ready` or while the registered validator delegate reports invalid.
      */
-    canMergeSignal = computed(() => this.hasReadyEntriesSignal() && this.isValidSignal(), ...(ngDevMode ? [{ debugName: "canMergeSignal" }] : /* istanbul ignore next */ []));
+    canMergeSignal = computed(() => {
+        const isValid = this.isValidSignal();
+        return this.hasReadyEntriesSignal() && isValid;
+    }, ...(ngDevMode ? [{ debugName: "canMergeSignal" }] : /* istanbul ignore next */ []));
     /**
      * Latest merged blob (or `undefined` while validation/merge is in flight or no entries are ready). Sourced from {@link DbxPdfMergeEditorStore.currentMergeOutput$} so the download button always reflects the current merge without needing the user to click Preview first.
      */
@@ -18168,7 +18253,7 @@ class DbxPdfMergeEditorFileUploadComponent {
     _validator = inject(DbxPdfMergeEditorFileUploadValidatorDirective, { optional: true });
     slotId = input.required(...(ngDevMode ? [{ debugName: "slotId" }] : /* istanbul ignore next */ []));
     config = input(...(ngDevMode ? [undefined, { debugName: "config" }] : /* istanbul ignore next */ []));
-    acceptSignal = computed(() => this.config()?.accept ?? PDF_MERGE_DEFAULT_ACCEPT, ...(ngDevMode ? [{ debugName: "acceptSignal" }] : /* istanbul ignore next */ []));
+    acceptSignal = computed(() => this.config()?.accept ?? DEFAULT_PDF_MERGE_ACCEPT, ...(ngDevMode ? [{ debugName: "acceptSignal" }] : /* istanbul ignore next */ []));
     multipleSignal = computed(() => this.config()?.multiple ?? false, ...(ngDevMode ? [{ debugName: "multipleSignal" }] : /* istanbul ignore next */ []));
     modeSignal = computed(() => this.config()?.mode ?? 'default', ...(ngDevMode ? [{ debugName: "modeSignal" }] : /* istanbul ignore next */ []));
     labelSignal = computed(() => this.config()?.label, ...(ngDevMode ? [{ debugName: "labelSignal" }] : /* istanbul ignore next */ []));
@@ -18381,8 +18466,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
 /**
  * Creates Angular environment providers for {@link DbxScreenMediaService} and its configuration.
  *
- * @param config - optional service configuration; uses default breakpoints if omitted
- * @returns environment providers to register in the application bootstrap
+ * @param config - Optional service configuration; uses default breakpoints if omitted.
+ * @returns Environment providers to register in the application bootstrap.
  *
  * @example
  * ```ts
@@ -18390,6 +18475,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
  *   providers: [provideDbxScreenMediaService()]
  * });
  * ```
+ *
  * @__NO_SIDE_EFFECTS__
  */
 function provideDbxScreenMediaService(config = {}) {
@@ -18412,8 +18498,8 @@ function provideDbxScreenMediaService(config = {}) {
  * Useful for preventing the default context menu from appearing over dialogs or popups.
  *
  * @param classes - CSS class name of the overlay container element to target. Defaults to `'cdk-overlay-container'`.
- * @param onEvent - optional callback invoked on each suppressed right-click event
- * @returns a cleanup function that removes the event listener
+ * @param onEvent - Optional callback invoked on each suppressed right-click event.
+ * @returns A cleanup function that removes the event listener.
  *
  * @example
  * ```ts
@@ -18453,5 +18539,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.11", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-export { APP_POPUP_MINIMIZED_WIDTH, APP_POPUP_NORMAL_HEIGHT, APP_POPUP_NORMAL_WIDTH, AbstractDbxClipboardDirective, AbstractDbxErrorWidgetComponent, AbstractDbxFileUploadComponent, AbstractDbxHelpWidgetDirective, AbstractDbxListAccordionViewDirective, AbstractDbxListGridViewDirective, AbstractDbxListViewDirective, AbstractDbxListWrapperDirective, AbstractDbxPartialPresetFilterMenuDirective, AbstractDbxSegueAnchorDirective, AbstractDbxSelectionListViewDirective, AbstractDbxSelectionListWrapperDirective, AbstractDbxValueListItemModifierDirective, AbstractDbxValueListViewDirective, AbstractDbxValueListViewItemComponent, AbstractDbxWidgetComponent, AbstractDialogDirective, AbstractFilterPopoverButtonDirective, AbstractPopoverDirective, AbstractPopoverRefDirective, AbstractPopoverRefWithEventsDirective, AbstractPopupDirective, AbstractPromptConfirmDirective, CompactContextStore, CompactMode, DBX_ACTION_SNACKBAR_DEFAULTS, DBX_ACTION_SNACKBAR_SERVICE_CONFIG, DBX_AVATAR_CONTEXT_DATA_TOKEN, DBX_CHIP_DEFAULT_TONE, DBX_COLOR_CUSTOM_BG_CSS_CLASS, DBX_COLOR_CUSTOM_TEXT_CSS_CLASS, DBX_DARK_STYLE_CLASS_SUFFIX, DBX_DETACH_DEFAULT_KEY, DBX_HELP_WIDGET_ENTRY_DATA_TOKEN, DBX_LIST_ACCORDION_VIEW_COMPONENT_IMPORTS_AND_EXPORTS, DBX_LIST_DEFAULT_SCROLL_DISTANCE, DBX_LIST_DEFAULT_THROTTLE_SCROLL, DBX_LIST_GRID_VIEW_COMPONENT_IMPORTS_AND_EXPORTS, DBX_LIST_ITEM_DEFAULT_DISABLE_FUNCTION, DBX_LIST_ITEM_DISABLE_RIPPLE_LIST_ITEM_MODIFIER_KEY, DBX_LIST_ITEM_IS_SELECTED_ITEM_MODIFIER_KEY, DBX_LIST_VIEW_DEFAULT_META_ICON, DBX_MODEL_VIEW_TRACKER_STORAGE_ACCESSOR_TOKEN, DBX_PDF_MERGE_EDITOR_INITIAL_STATE, DBX_PROGRESS_BUTTON_GLOBAL_CONFIG, DBX_ROUTER_ANCHOR_COMPONENTS, DBX_ROUTER_VALUE_LIST_ITEM_MODIFIER_KEY, DBX_STYLE_DEFAULT_CONFIG_TOKEN, DBX_THEME_COLORS, DBX_THEME_COLORS_EXTRA, DBX_THEME_COLORS_EXTRA_SECONDARY, DBX_THEME_COLORS_MAIN, DBX_VALUE_LIST_VIEW_ITEM, DBX_WEB_FILE_PREVIEW_SERVICE_DEFAULT_DIALOG_WITH_COMPONENT_FUNCTION, DBX_WEB_FILE_PREVIEW_SERVICE_DEFAULT_PREVIEW_COMPONENT_FUNCTION, DBX_WEB_FILE_PREVIEW_SERVICE_ENTRIES_TOKEN, DBX_WEB_FILE_PREVIEW_SERVICE_ZIP_COMPONENT_PRESET, DBX_WEB_FILE_PREVIEW_SERVICE_ZIP_PRESET_ENTRY, DBX_WEB_PAGE_TITLE_SERVICE_CONFIG, DEFAULT_DBX_ERROR_SNACKBAR_CONFIG, DEFAULT_DBX_HELP_VIEW_POPOVER_KEY, DEFAULT_DBX_LINKIFY_STRING_TYPE, DEFAULT_DBX_LIST_ACCORDION_VIEW_COMPONENT_CONFIGURATION_TEMPLATE, DEFAULT_DBX_LIST_GRID_VIEW_COMPONENT_CONFIGURATION_TEMPLATE, DEFAULT_DBX_LIST_ITEM_IS_SELECTED_FUNCTION, DEFAULT_DBX_PROMPT_CONFIRM_DIALOG_CONFIG, DEFAULT_DBX_SELECTION_VALUE_LIST_COMPONENT_CONFIGURATION_TEMPLATE, DEFAULT_DBX_SIDENAV_MENU_ICON, DEFAULT_DBX_VALUE_LIST_COMPONENT_CONFIGURATION_TEMPLATE, DEFAULT_ERROR_POPOVER_KEY, DEFAULT_ERROR_WIDGET_CODE, DEFAULT_FILTER_POPOVER_KEY, DEFAULT_LIST_GRID_SIZE_CONFIG, DEFAULT_LIST_WRAPPER_COMPONENT_CONFIGURATION_TEMPLATE, DEFAULT_LOADING_PROGRESS_DIAMETER, DEFAULT_SCREEN_MEDIA_SERVICE_CONFIG, DEFAULT_SNACKBAR_DIRECTIVE_DURATION, DEFAULT_TWO_COLUMNS_MIN_RIGHT_WIDTH, DEFAULT_VALUE_LIST_VIEW_CONTENT_COMPONENT_TRACK_BY_FUNCTION, DbxAccordionHeaderHeightDirective, DbxActionConfirmDirective, DbxActionDialogDirective, DbxActionErrorDirective, DbxActionKeyTriggerDirective, DbxActionLoadingContextDirective, DbxActionModule, DbxActionPopoverDirective, DbxActionSnackbarComponent, DbxActionSnackbarDirective, DbxActionSnackbarErrorDirective, DbxActionSnackbarModule, DbxActionSnackbarService, DbxActionTransitionSafetyDirective, DbxActionUIRouterTransitionSafetyDialogComponent, DbxAnchorComponent, DbxAnchorContentComponent, DbxAnchorIconComponent, DbxAnchorListComponent, DbxAngularRouterSegueAnchorComponent, DbxAvatarComponent, DbxAvatarViewService, DbxAvatarViewServiceConfig, DbxBarDirective, DbxBarHeaderComponent, DbxBarLayoutModule, DbxBasicLoadingComponent, DbxBodyDirective, DbxButtonComponent, DbxButtonModule, DbxButtonSpacerDirective, DbxCardBoxComponent, DbxCardBoxContainerDirective, DbxCardBoxLayoutModule, DbxChipDirective, DbxChipListComponent, DbxClickToCopyTextComponent, DbxClickToCopyTextDirective, DbxColorDirective, DbxColorService, DbxColorServiceConfig, DbxColumnLayoutModule, DbxCompactDirective, DbxCompactLayoutModule, DbxContentBorderDirective, DbxContentBoxDirective, DbxContentContainerDirective, DbxContentDirective, DbxContentElevateDirective, DbxContentLayoutModule, DbxContentPageDirective, DbxContentPitDirective, DbxDetachContentComponent, DbxDetachControlButtonsComponent, DbxDetachController, DbxDetachControlsComponent, DbxDetachInitDirective, DbxDetachInteractionModule, DbxDetachOutletComponent, DbxDetachOverlayComponent, DbxDetachService, DbxDetachWindowState, DbxDetailBlockComponent, DbxDetailBlockHeaderComponent, DbxDialogContentCloseComponent, DbxDialogContentDirective, DbxDialogContentFooterComponent, DbxDialogInteractionModule, DbxDialogModule, DbxDownloadBlobButtonComponent, DbxDownloadTextViewComponent, DbxEmbedComponent, DbxErrorComponent, DbxErrorDefaultErrorWidgetComponent, DbxErrorDetailsComponent, DbxErrorPopoverComponent, DbxErrorSnackbarComponent, DbxErrorSnackbarService, DbxErrorViewComponent, DbxErrorWidgetService, DbxErrorWidgetViewComponent, DbxFileUploadActionCompatable, DbxFileUploadActionSyncDirective, DbxFileUploadAreaComponent, DbxFileUploadButtonComponent, DbxFileUploadComponent, DbxFilterInteractionModule, DbxFilterPopoverButtonComponent, DbxFilterPopoverComponent, DbxFilterWrapperComponent, DbxFlagComponent, DbxFlagLayoutModule, DbxFlagPromptComponent, DbxFlexGroupDirective, DbxFlexLayoutModule, DbxFlexSizeDirective, DbxHelpContextDirective, DbxHelpContextService, DbxHelpViewListComponent, DbxHelpViewListEntryComponent, DbxHelpViewPopoverButtonComponent, DbxHelpViewPopoverComponent, DbxHelpWidgetService, DbxHelpWidgetServiceConfig, DbxIconButtonComponent, DbxIconButtonModule, DbxIconItemComponent, DbxIconSpacerDirective, DbxIconTileComponent, DbxIconTileDirective, DbxIfSidenavDisplayModeDirective, DbxIframeComponent, DbxInjectionDialogComponent, DbxInteractionModule, DbxIntroActionSectionComponent, DbxLabelBlockComponent, DbxLayoutModule, DbxLinkComponent, DbxLinkifyComponent, DbxLinkifyService, DbxLinkifyServiceConfig, DbxListAccordionViewComponentImportsModule, DbxListComponent, DbxListEmptyContentComponent, DbxListGridViewComponentImportsModule, DbxListInternalContentDirective, DbxListItemAnchorModifierDirective, DbxListItemDisableRippleModifierDirective, DbxListItemIsSelectedModifierDirective, DbxListModifierModule, DbxListModule, DbxListTitleGroupDirective, DbxListView, DbxListViewMetaIconComponent, DbxListViewWrapper, DbxListWrapperComponentImportsModule, DbxLoadingComponent, DbxLoadingErrorDirective, DbxLoadingModule, DbxLoadingProgressComponent, DbxModelObjectStateService, actions as DbxModelStateActions, model_actions as DbxModelStateModelActions, DbxModelTrackerService, DbxModelTypesService, DbxModelViewTrackerStorage, DbxNavbarComponent, DbxNumberWithLimitComponent, DbxOneColumnComponent, DbxOneColumnLayoutModule, DbxPagebarComponent, DbxPartialPresetFilterListComponent, DbxPartialPresetFilterMenuComponent, DbxPdfMergeEditorComponent, DbxPdfMergeEditorFileUploadComponent, DbxPdfMergeEditorFileUploadHasStateDirective, DbxPdfMergeEditorFileUploadValidatorDirective, DbxPdfMergeEditorStore, DbxPdfMergeEntryComponent, DbxPdfMergeListComponent, DbxPdfPreviewComponent, DbxPopoverCloseButtonComponent, DbxPopoverComponent, DbxPopoverComponentController, DbxPopoverContentComponent, DbxPopoverController, DbxPopoverControlsDirective, DbxPopoverCoordinatorComponent, DbxPopoverCoordinatorService, DbxPopoverHeaderComponent, DbxPopoverInteractionContentModule, DbxPopoverInteractionModule, DbxPopoverScrollContentDirective, DbxPopoverService, DbxPopupComponent, DbxPopupComponentController, DbxPopupContentComponent, DbxPopupControlButtonsComponent, DbxPopupController, DbxPopupControlsComponent, DbxPopupCoordinatorComponent, DbxPopupCoordinatorService, DbxPopupInteractionModule, DbxPopupService, DbxPopupWindowState, DbxPresetFilterListComponent, DbxPresetFilterMenuComponent, DbxProgressBarButtonComponent, DbxProgressButtonsModule, DbxProgressSpinnerButtonComponent, DbxPromptBoxDirective, DbxPromptComponent, DbxPromptConfirm, DbxPromptConfirmButtonDirective, DbxPromptConfirmComponent, DbxPromptConfirmDialogComponent, DbxPromptConfirmDirective, DbxPromptModule, DbxPromptPageComponent, DbxReadableErrorModule, DbxResizedDirective, DbxRouterAnchorModule, DbxRouterLayoutModule, DbxRouterSidenavModule, DbxRouterWebProviderConfig, DbxScreenMediaService, DbxScreenMediaServiceConfig, DbxSectionComponent, DbxSectionHeaderComponent, DbxSectionLayoutModule, DbxSectionPageComponent, DbxSelectionValueListViewComponent, DbxSelectionValueListViewComponentImportsModule, DbxSelectionValueListViewContentComponent, DbxSetStyleDirective, DbxSidenavButtonComponent, DbxSidenavComponent, DbxSidenavPageComponent, DbxSidenavPagebarComponent, DbxSpacerDirective, DbxStepBlockComponent, DbxStructureDirective, DbxStructureModule, DbxStyleBodyDirective, DbxStyleDirective, DbxStyleLayoutModule, DbxStyleService, DbxSubSectionComponent, DbxTextChipsComponent, DbxTextColorDirective, DbxTextModule, DbxTwoBlockComponent, DbxTwoColumnBackDirective, DbxTwoColumnColumnHeadDirective, DbxTwoColumnComponent, DbxTwoColumnContextDirective, DbxTwoColumnFullLeftDirective, DbxTwoColumnLayoutModule, DbxTwoColumnRightComponent, DbxTwoColumnSrefDirective, DbxTwoColumnSrefShowRightDirective, DbxUIRouterSegueAnchorComponent, DbxUnitedStatesAddressComponent, DbxValueListAccordionViewComponent, DbxValueListAccordionViewContentComponent, DbxValueListAccordionViewContentGroupComponent, DbxValueListGridSizeDirective, DbxValueListGridViewComponent, DbxValueListGridViewContentComponent, DbxValueListGridViewContentGroupComponent, DbxValueListItemModifier, DbxValueListItemModifierDirective, DbxValueListView, DbxValueListViewComponent, DbxValueListViewComponentImportsModule, DbxValueListViewContentComponent, DbxValueListViewContentGroupComponent, DbxValueListViewGroupDelegate, DbxWebFilePreviewComponent, DbxWebFilePreviewService, DbxWebModule, DbxWebPageTitleInfoDirective, DbxWebPageTitleService, DbxWidgetListGridComponent, DbxWidgetListGridViewComponent, DbxWidgetListGridViewItemComponent, DbxWidgetService, DbxWidgetViewComponent, DbxWindowKeyDownListenerDirective, DbxZipBlobPreviewComponent, DbxZipPreviewComponent, PDF_MERGE_DEFAULT_ACCEPT, PDF_MERGE_RESULT_MIME_TYPE, PopoverPositionStrategy, PopupGlobalPositionStrategy, SCREEN_MEDIA_WIDTH_TYPE_SIZE_MAP, SIDE_NAV_DISPLAY_MODE_ORDER, SideNavDisplayMode, TRACK_BY_MODEL_ID, TRACK_BY_MODEL_KEY, TwoColumnsContextStore, UNKNOWN_ERROR_WIDGET_CODE, addConfigToValueListItems, allDbxModelViewTrackerEventModelKeys, allDbxModelViewTrackerEventSetModelKeys, buildPdfMergeEntry, catchErrorServerParams, classifyPdfMergeFile, compactModeFromInput, compareScreenMediaWidthTypes, convertServerErrorParams, convertToPOJOServerErrorResponse, convertToServerErrorResponse, copyToClipboardFunction, dbxColorBackground, dbxListAccordionViewComponentImportsAndExports, dbxListGridViewComponentImportsAndExports, dbxPresetFilterMenuButtonIconObservable, dbxPresetFilterMenuButtonTextObservable, dbxStyleClassCleanSuffix, dbxThemeColorCssToken, dbxThemeColorCssTokenVar, dbxThemeColorCssVariable, dbxThemeColorCssVariableVar, dbxValueListItemDecisionFunction, dbxValueListItemKeyForItemValue, dbxWebDefaultPageTitleDelegate, dbxZipBlobPreviewEntryTreeFromEntries, defaultDbxModelViewTrackerStorageAccessorFactory, defaultDbxValueListViewGroupDelegate, defaultDbxValueListViewGroupValuesFunction, disableRightClickInCdkBackdrop, fileAcceptFilterTypeStringArray, fileAcceptFunction, fileAcceptString, fileArrayAcceptMatchFunction, flattenAccordionGroups, index as fromDbxModel, injectCopyToClipboardFunction, injectCopyToClipboardFunctionWithSnackbarMessage, isDbxColorConfig, listItemModifier, makeDbxActionSnackbarDisplayConfigGeneratorFunction, mapCompactModeObs, mapValuesToValuesListItemConfigObs, mergePdfMergeEntries, index$1 as onDbxModel, openEmbedDialog, openIframeDialog, openPdfPreviewDialog, openZipPreviewDialog, overrideClickElementEffect, provideDbxDetachController, provideDbxFileUploadActionCompatable, provideDbxHelpServices, provideDbxLinkify, provideDbxListView, provideDbxListViewWrapper, provideDbxModelService, provideDbxProgressButtonGlobalConfig, provideDbxPromptConfirm, provideDbxRouterWebAngularRouterProviderConfig, provideDbxRouterWebUiRouterProviderConfig, provideDbxScreenMediaService, provideDbxStyleService, provideDbxValueListView, provideDbxValueListViewGroupDelegate, provideDbxValueListViewModifier, provideDbxWebFilePreviewServiceEntries, provideDbxWebPageTitleService, provideTwoColumnsContext, registerHelpContextKeysWithDbxHelpContextService, resizeSignal, resolveSideNavDisplayMode, sanitizeDbxDialogContentConfig, screenMediaWidthTypeIsActive, trackByModelKeyRef, trackByUniqueIdentifier, validatePdfMergeEntry };
+export { APP_POPUP_MINIMIZED_WIDTH, APP_POPUP_NORMAL_HEIGHT, APP_POPUP_NORMAL_WIDTH, AbstractDbxClipboardDirective, AbstractDbxErrorWidgetComponent, AbstractDbxFileUploadComponent, AbstractDbxHelpWidgetDirective, AbstractDbxListAccordionViewDirective, AbstractDbxListGridViewDirective, AbstractDbxListViewDirective, AbstractDbxListWrapperDirective, AbstractDbxPartialPresetFilterMenuDirective, AbstractDbxSegueAnchorDirective, AbstractDbxSelectionListViewDirective, AbstractDbxSelectionListWrapperDirective, AbstractDbxValueListItemModifierDirective, AbstractDbxValueListViewDirective, AbstractDbxValueListViewItemComponent, AbstractDbxWidgetComponent, AbstractDialogDirective, AbstractFilterPopoverButtonDirective, AbstractPopoverDirective, AbstractPopoverRefDirective, AbstractPopoverRefWithEventsDirective, AbstractPopupDirective, AbstractPromptConfirmDirective, CompactContextStore, CompactMode, DBX_ACTION_SNACKBAR_DEFAULTS, DBX_ACTION_SNACKBAR_SERVICE_CONFIG, DBX_AVATAR_CONTEXT_DATA_TOKEN, DBX_COLOR_CUSTOM_BG_CSS_CLASS, DBX_COLOR_CUSTOM_TEXT_CSS_CLASS, DBX_DARK_STYLE_CLASS_SUFFIX, DBX_HELP_WIDGET_ENTRY_DATA_TOKEN, DBX_LIST_ACCORDION_VIEW_COMPONENT_IMPORTS_AND_EXPORTS, DBX_LIST_GRID_VIEW_COMPONENT_IMPORTS_AND_EXPORTS, DBX_LIST_ITEM_DISABLE_RIPPLE_LIST_ITEM_MODIFIER_KEY, DBX_LIST_ITEM_IS_SELECTED_ITEM_MODIFIER_KEY, DBX_MODEL_VIEW_TRACKER_STORAGE_ACCESSOR_TOKEN, DBX_PDF_MERGE_EDITOR_INITIAL_STATE, DBX_PROGRESS_BUTTON_GLOBAL_CONFIG, DBX_ROUTER_ANCHOR_COMPONENTS, DBX_ROUTER_VALUE_LIST_ITEM_MODIFIER_KEY, DBX_THEME_COLORS, DBX_THEME_COLORS_EXTRA, DBX_THEME_COLORS_EXTRA_SECONDARY, DBX_THEME_COLORS_MAIN, DBX_VALUE_LIST_VIEW_ITEM, DBX_WEB_FILE_PREVIEW_SERVICE_ENTRIES_TOKEN, DBX_WEB_FILE_PREVIEW_SERVICE_ZIP_COMPONENT_PRESET, DBX_WEB_FILE_PREVIEW_SERVICE_ZIP_PRESET_ENTRY, DBX_WEB_PAGE_TITLE_SERVICE_CONFIG, DEFAULT_DBX_CHIP_TONE, DEFAULT_DBX_DETACH_KEY, DEFAULT_DBX_ERROR_SNACKBAR_CONFIG, DEFAULT_DBX_HELP_VIEW_POPOVER_KEY, DEFAULT_DBX_LINKIFY_STRING_TYPE, DEFAULT_DBX_LIST_ACCORDION_VIEW_COMPONENT_CONFIGURATION_TEMPLATE, DEFAULT_DBX_LIST_GRID_VIEW_COMPONENT_CONFIGURATION_TEMPLATE, DEFAULT_DBX_LIST_ITEM_DISABLE_FUNCTION, DEFAULT_DBX_LIST_ITEM_IS_SELECTED_FUNCTION, DEFAULT_DBX_LIST_SCROLL_DISTANCE, DEFAULT_DBX_LIST_THROTTLE_SCROLL, DEFAULT_DBX_LIST_VIEW_META_ICON, DEFAULT_DBX_PROMPT_CONFIRM_DIALOG_CONFIG, DEFAULT_DBX_SELECTION_VALUE_LIST_COMPONENT_CONFIGURATION_TEMPLATE, DEFAULT_DBX_SIDENAV_MENU_ICON, DEFAULT_DBX_STYLE_CONFIG_TOKEN, DEFAULT_DBX_VALUE_LIST_COMPONENT_CONFIGURATION_TEMPLATE, DEFAULT_DBX_WEB_FILE_PREVIEW_SERVICE_DIALOG_WITH_COMPONENT_FUNCTION, DEFAULT_DBX_WEB_FILE_PREVIEW_SERVICE_PREVIEW_COMPONENT_FUNCTION, DEFAULT_ERROR_POPOVER_KEY, DEFAULT_ERROR_WIDGET_CODE, DEFAULT_FILTER_POPOVER_KEY, DEFAULT_LIST_GRID_SIZE_CONFIG, DEFAULT_LIST_WRAPPER_COMPONENT_CONFIGURATION_TEMPLATE, DEFAULT_LOADING_PROGRESS_DIAMETER, DEFAULT_PDF_MERGE_ACCEPT, DEFAULT_SCREEN_MEDIA_SERVICE_CONFIG, DEFAULT_SNACKBAR_DIRECTIVE_DURATION, DEFAULT_TWO_COLUMNS_MIN_RIGHT_WIDTH, DEFAULT_VALUE_LIST_VIEW_CONTENT_COMPONENT_TRACK_BY_FUNCTION, DbxAccordionHeaderHeightDirective, DbxActionConfirmDirective, DbxActionDialogDirective, DbxActionErrorDirective, DbxActionKeyTriggerDirective, DbxActionLoadingContextDirective, DbxActionModule, DbxActionPopoverDirective, DbxActionSnackbarComponent, DbxActionSnackbarDirective, DbxActionSnackbarErrorDirective, DbxActionSnackbarModule, DbxActionSnackbarService, DbxActionTransitionSafetyDirective, DbxActionUIRouterTransitionSafetyDialogComponent, DbxAnchorComponent, DbxAnchorContentComponent, DbxAnchorIconComponent, DbxAnchorListComponent, DbxAngularRouterSegueAnchorComponent, DbxAvatarComponent, DbxAvatarViewService, DbxAvatarViewServiceConfig, DbxBarDirective, DbxBarHeaderComponent, DbxBarLayoutModule, DbxBasicLoadingComponent, DbxBodyDirective, DbxButtonComponent, DbxButtonModule, DbxButtonSpacerDirective, DbxCardBoxComponent, DbxCardBoxContainerDirective, DbxCardBoxLayoutModule, DbxChipDirective, DbxChipListComponent, DbxClickToCopyTextComponent, DbxClickToCopyTextDirective, DbxColorDirective, DbxColorService, DbxColorServiceConfig, DbxColumnLayoutModule, DbxCompactDirective, DbxCompactLayoutModule, DbxContentBorderDirective, DbxContentBoxDirective, DbxContentContainerDirective, DbxContentDirective, DbxContentElevateDirective, DbxContentLayoutModule, DbxContentPageDirective, DbxContentPitDirective, DbxDetachContentComponent, DbxDetachControlButtonsComponent, DbxDetachController, DbxDetachControlsComponent, DbxDetachInitDirective, DbxDetachInteractionModule, DbxDetachOutletComponent, DbxDetachOverlayComponent, DbxDetachService, DbxDetachWindowState, DbxDetailBlockComponent, DbxDetailBlockHeaderComponent, DbxDialogContentCloseComponent, DbxDialogContentDirective, DbxDialogContentFooterComponent, DbxDialogInteractionModule, DbxDialogModule, DbxDownloadBlobButtonComponent, DbxDownloadTextViewComponent, DbxEmbedComponent, DbxErrorComponent, DbxErrorDefaultErrorWidgetComponent, DbxErrorDetailsComponent, DbxErrorPopoverComponent, DbxErrorSnackbarComponent, DbxErrorSnackbarService, DbxErrorViewComponent, DbxErrorWidgetService, DbxErrorWidgetViewComponent, DbxFileUploadActionCompatable, DbxFileUploadActionSyncDirective, DbxFileUploadAreaComponent, DbxFileUploadButtonComponent, DbxFileUploadComponent, DbxFilterInteractionModule, DbxFilterPopoverButtonComponent, DbxFilterPopoverComponent, DbxFilterWrapperComponent, DbxFlagComponent, DbxFlagLayoutModule, DbxFlagPromptComponent, DbxFlexGroupDirective, DbxFlexLayoutModule, DbxFlexSizeDirective, DbxHelpContextDirective, DbxHelpContextService, DbxHelpViewListComponent, DbxHelpViewListEntryComponent, DbxHelpViewPopoverButtonComponent, DbxHelpViewPopoverComponent, DbxHelpWidgetService, DbxHelpWidgetServiceConfig, DbxIconButtonComponent, DbxIconButtonModule, DbxIconItemComponent, DbxIconSpacerDirective, DbxIconTileComponent, DbxIconTileDirective, DbxIfSidenavDisplayModeDirective, DbxIframeComponent, DbxInjectionDialogComponent, DbxInteractionModule, DbxIntroActionSectionComponent, DbxLabelBlockComponent, DbxLayoutModule, DbxLinkComponent, DbxLinkifyComponent, DbxLinkifyService, DbxLinkifyServiceConfig, DbxListAccordionViewComponentImportsModule, DbxListComponent, DbxListEmptyContentComponent, DbxListGridViewComponentImportsModule, DbxListInternalContentDirective, DbxListItemAnchorModifierDirective, DbxListItemDisableRippleModifierDirective, DbxListItemIsSelectedModifierDirective, DbxListModifierModule, DbxListModule, DbxListTitleGroupDirective, DbxListView, DbxListViewMetaIconComponent, DbxListViewWrapper, DbxListWrapperComponentImportsModule, DbxLoadingComponent, DbxLoadingErrorDirective, DbxLoadingModule, DbxLoadingProgressComponent, DbxModelObjectStateService, actions as DbxModelStateActions, model_actions as DbxModelStateModelActions, DbxModelTrackerService, DbxModelTypesService, DbxModelViewTrackerStorage, DbxNavbarComponent, DbxNumberWithLimitComponent, DbxOneColumnComponent, DbxOneColumnLayoutModule, DbxPagebarComponent, DbxPartialPresetFilterListComponent, DbxPartialPresetFilterMenuComponent, DbxPdfMergeEditorComponent, DbxPdfMergeEditorFileUploadComponent, DbxPdfMergeEditorFileUploadHasStateDirective, DbxPdfMergeEditorFileUploadValidatorDirective, DbxPdfMergeEditorStore, DbxPdfMergeEntryComponent, DbxPdfMergeListComponent, DbxPdfPreviewComponent, DbxPopoverCloseButtonComponent, DbxPopoverComponent, DbxPopoverComponentController, DbxPopoverContentComponent, DbxPopoverController, DbxPopoverControlsDirective, DbxPopoverCoordinatorComponent, DbxPopoverCoordinatorService, DbxPopoverHeaderComponent, DbxPopoverInteractionContentModule, DbxPopoverInteractionModule, DbxPopoverScrollContentDirective, DbxPopoverService, DbxPopupComponent, DbxPopupComponentController, DbxPopupContentComponent, DbxPopupControlButtonsComponent, DbxPopupController, DbxPopupControlsComponent, DbxPopupCoordinatorComponent, DbxPopupCoordinatorService, DbxPopupInteractionModule, DbxPopupService, DbxPopupWindowState, DbxPresetFilterListComponent, DbxPresetFilterMenuComponent, DbxProgressBarButtonComponent, DbxProgressButtonsModule, DbxProgressSpinnerButtonComponent, DbxPromptBoxDirective, DbxPromptComponent, DbxPromptConfirm, DbxPromptConfirmButtonDirective, DbxPromptConfirmComponent, DbxPromptConfirmDialogComponent, DbxPromptConfirmDirective, DbxPromptModule, DbxPromptPageComponent, DbxReadableErrorModule, DbxResizedDirective, DbxRouterAnchorModule, DbxRouterLayoutModule, DbxRouterSidenavModule, DbxRouterWebProviderConfig, DbxScreenMediaService, DbxScreenMediaServiceConfig, DbxSectionComponent, DbxSectionHeaderComponent, DbxSectionLayoutModule, DbxSectionPageComponent, DbxSelectionValueListViewComponent, DbxSelectionValueListViewComponentImportsModule, DbxSelectionValueListViewContentComponent, DbxSetStyleDirective, DbxSidenavButtonComponent, DbxSidenavComponent, DbxSidenavPageComponent, DbxSidenavPagebarComponent, DbxSpacerDirective, DbxStepBlockComponent, DbxStructureDirective, DbxStructureModule, DbxStyleBodyDirective, DbxStyleDirective, DbxStyleLayoutModule, DbxStyleService, DbxSubSectionComponent, DbxTextChipsComponent, DbxTextColorDirective, DbxTextModule, DbxTwoBlockComponent, DbxTwoColumnBackDirective, DbxTwoColumnColumnHeadDirective, DbxTwoColumnComponent, DbxTwoColumnContextDirective, DbxTwoColumnFullLeftDirective, DbxTwoColumnLayoutModule, DbxTwoColumnRightComponent, DbxTwoColumnSrefDirective, DbxTwoColumnSrefShowRightDirective, DbxUIRouterSegueAnchorComponent, DbxUnitedStatesAddressComponent, DbxValueListAccordionViewComponent, DbxValueListAccordionViewContentComponent, DbxValueListAccordionViewContentGroupComponent, DbxValueListGridSizeDirective, DbxValueListGridViewComponent, DbxValueListGridViewContentComponent, DbxValueListGridViewContentGroupComponent, DbxValueListItemModifier, DbxValueListItemModifierDirective, DbxValueListView, DbxValueListViewComponent, DbxValueListViewComponentImportsModule, DbxValueListViewContentComponent, DbxValueListViewContentGroupComponent, DbxValueListViewGroupDelegate, DbxWebFilePreviewComponent, DbxWebFilePreviewService, DbxWebModule, DbxWebPageTitleInfoDirective, DbxWebPageTitleService, DbxWidgetListGridComponent, DbxWidgetListGridViewComponent, DbxWidgetListGridViewItemComponent, DbxWidgetService, DbxWidgetViewComponent, DbxWindowKeyDownListenerDirective, DbxZipBlobPreviewComponent, DbxZipPreviewComponent, PDF_MERGE_RESULT_MIME_TYPE, PopoverPositionStrategy, PopupGlobalPositionStrategy, SCREEN_MEDIA_WIDTH_TYPE_SIZE_MAP, SIDE_NAV_DISPLAY_MODE_ORDER, SideNavDisplayMode, TRACK_BY_MODEL_ID, TRACK_BY_MODEL_KEY, TwoColumnsContextStore, UNKNOWN_ERROR_WIDGET_CODE, addConfigToValueListItems, allDbxModelViewTrackerEventModelKeys, allDbxModelViewTrackerEventSetModelKeys, buildPdfMergeEntry, catchErrorServerParams, classifyPdfMergeFile, compactModeFromInput, compareScreenMediaWidthTypes, convertServerErrorParams, convertToPOJOServerErrorResponse, convertToServerErrorResponse, copyToClipboardFunction, dbxColorBackground, dbxListAccordionViewComponentImportsAndExports, dbxListGridViewComponentImportsAndExports, dbxPresetFilterMenuButtonIconObservable, dbxPresetFilterMenuButtonTextObservable, dbxStyleClassCleanSuffix, dbxThemeColorCssToken, dbxThemeColorCssTokenVar, dbxThemeColorCssVariable, dbxThemeColorCssVariableVar, dbxValueListItemDecisionFunction, dbxValueListItemKeyForItemValue, dbxWebDefaultPageTitleDelegate, dbxZipBlobPreviewEntryTreeFromEntries, defaultDbxModelViewTrackerStorageAccessorFactory, defaultDbxValueListViewGroupDelegate, defaultDbxValueListViewGroupValuesFunction, disableRightClickInCdkBackdrop, fileAcceptFilterTypeStringArray, fileAcceptFunction, fileAcceptString, fileArrayAcceptMatchFunction, flattenAccordionGroups, index as fromDbxModel, injectCopyToClipboardFunction, injectCopyToClipboardFunctionWithSnackbarMessage, isDbxColorConfig, listItemModifier, makeDbxActionSnackbarDisplayConfigGeneratorFunction, mapCompactModeObs, mapValuesToValuesListItemConfigObs, mergePdfMergeEntries, index$1 as onDbxModel, openEmbedDialog, openIframeDialog, openPdfPreviewDialog, openZipPreviewDialog, overrideClickElementEffect, provideDbxDetachController, provideDbxFileUploadActionCompatable, provideDbxHelpServices, provideDbxLinkify, provideDbxListView, provideDbxListViewWrapper, provideDbxModelService, provideDbxProgressButtonGlobalConfig, provideDbxPromptConfirm, provideDbxRouterWebAngularRouterProviderConfig, provideDbxRouterWebUiRouterProviderConfig, provideDbxScreenMediaService, provideDbxStyleService, provideDbxValueListView, provideDbxValueListViewGroupDelegate, provideDbxValueListViewModifier, provideDbxWebFilePreviewServiceEntries, provideDbxWebPageTitleService, provideTwoColumnsContext, registerHelpContextKeysWithDbxHelpContextService, resizeSignal, resolveSideNavDisplayMode, sanitizeDbxDialogContentConfig, screenMediaWidthTypeIsActive, trackByModelKeyRef, trackByUniqueIdentifier, validatePdfMergeEntry };
 //# sourceMappingURL=dereekb-dbx-web.mjs.map