@dereekb/dbx-web 13.4.1 → 13.4.2

package/types/dereekb-dbx-web.d.ts

@@ -311,9 +311,13 @@ declare class DbxActionSnackbarComponent implements AfterViewInit {
  * action event and optional undo configuration.
  */
 interface DbxActionSnackbarGeneratorInput<T = unknown, O = unknown> {
-    /** The action snackbar event that triggered the generator. */
+    /**
+     * The action snackbar event that triggered the generator.
+     */
     readonly event: DbxActionSnackbarEvent<O>;
-    /** Optional undo action configuration, only applied on success events. */
+    /**
+     * Optional undo action configuration, only applied on success events.
+     */
     readonly undo?: Maybe<DbxActionSnackbarGeneratorUndoInput<T, O>>;
 }
 /**
@@ -326,9 +330,13 @@ type DbxActionSnackbarGeneratorUndoInput<T = unknown, O = unknown> = Getter<DbxA
  * and how to obtain the undo action source reference.
  */
 interface DbxActionSnackbarGeneratorUndoInputConfig<T = unknown, O = unknown> {
-    /** How long the undo button remains visible in the snackbar. */
+    /**
+     * How long the undo button remains visible in the snackbar.
+     */
     readonly duration?: Milliseconds;
-    /** Factory that returns the action context source reference to trigger for undo. */
+    /**
+     * Factory that returns the action context source reference to trigger for undo.
+     */
     readonly getUndoAction: Getter<DbxActionContextSourceReference<T, O>>;
 }
 /**
@@ -341,13 +349,21 @@ type DbxActionSnackbarDisplayConfigGeneratorFunction = <T = unknown, O = unknown
  * Each property maps a loading state (idle, loading, success, error) to its message configuration.
  */
 interface DbxMakeActionSnackbarGeneratorConfiguration {
-    /** Configuration shown when the action is idle. */
+    /**
+     * Configuration shown when the action is idle.
+     */
     readonly idle?: GetterOrValue<DbxMakeActionSnackbarGeneratorEventConfiguration>;
-    /** Configuration shown while the action is loading. */
+    /**
+     * Configuration shown while the action is loading.
+     */
     readonly loading?: GetterOrValue<DbxMakeActionSnackbarGeneratorEventConfiguration>;
-    /** Configuration shown when the action succeeds. */
+    /**
+     * Configuration shown when the action succeeds.
+     */
     readonly success?: GetterOrValue<DbxMakeActionSnackbarGeneratorEventConfiguration>;
-    /** Configuration shown when the action fails. */
+    /**
+     * Configuration shown when the action fails.
+     */
     readonly error?: GetterOrValue<DbxMakeActionSnackbarGeneratorEventConfiguration>;
 }
 /**
@@ -400,15 +416,25 @@ interface DbxActionSnackbarEventMakeConfig {
  * positioning, default durations, and per-type message configurations.
  */
 interface DbxActionSnackbarServiceConfig<C = unknown> {
-    /** Component class to render inside the snackbar. Defaults to {@link DbxActionSnackbarComponent}. */
+    /**
+     * Component class to render inside the snackbar. Defaults to {@link DbxActionSnackbarComponent}.
+     */
     readonly componentClass: Type<C>;
-    /** Snackbar positioning overrides. */
+    /**
+     * Snackbar positioning overrides.
+     */
     readonly snackbar?: Pick<MatSnackBarConfig, 'horizontalPosition' | 'verticalPosition'>;
-    /** Default duration for snackbars without an action. */
+    /**
+     * Default duration for snackbars without an action.
+     */
     readonly defaultDuration?: Milliseconds;
-    /** Default duration for snackbars that include an undo action. */
+    /**
+     * Default duration for snackbars that include an undo action.
+     */
     readonly defaultUndoDuration?: Milliseconds;
-    /** Per-type message configurations (e.g. "save", "create", "delete"). */
+    /**
+     * Per-type message configurations (e.g. "save", "create", "delete").
+     */
     readonly eventTypeConfigs: DbxActionSnackbarEventMakeConfig;
 }
 /**
@@ -439,6 +465,7 @@ declare class DbxActionSnackbarService<C = DbxActionSnackbarComponent> {
      *
      * @param type - The snackbar type key (e.g. "save", "delete"), or undefined to use "none".
      * @param input - The generator input containing the event and optional undo configuration.
+     * @returns The generated display configuration, or `undefined` if no config is registered for the given type.
      */
     generateDisplayConfig<T = unknown, O = unknown>(type: Maybe<DbxActionSnackbarType>, input: DbxActionSnackbarGeneratorInput<T, O>): Maybe<DbxActionSnackbarDisplayConfig<T, O>>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DbxActionSnackbarService<any>, never>;
@@ -480,7 +507,7 @@ declare class DbxActionSnackbarDirective<T = unknown, O = unknown> implements On
     protected readonly _sub: _dereekb_rxjs.SubscriptionObject<rxjs.Unsubscribable>;
     ngOnInit(): void;
     protected buildConfigurationForEvent(event: DbxActionSnackbarEvent<O>): Maybe<DbxActionSnackbarDisplayConfig<T, O>>;
-    protected showSnackbarForConfiguration(config: DbxActionSnackbarDisplayConfig<T, O>, event: DbxActionSnackbarEvent<O>): void;
+    protected showSnackbarForConfiguration(config: DbxActionSnackbarDisplayConfig<T, O>, _event: DbxActionSnackbarEvent<O>): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DbxActionSnackbarDirective<any, any>, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DbxActionSnackbarDirective<any, any>, "[dbxActionSnackbar]", never, { "dbxActionSnackbarDefault": { "alias": "dbxActionSnackbarDefault"; "required": false; "isSignal": true; }; "dbxActionSnackbarUndo": { "alias": "dbxActionSnackbarUndo"; "required": false; "isSignal": true; }; "dbxActionSnackbar": { "alias": "dbxActionSnackbar"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -623,6 +650,9 @@ declare abstract class DbxPromptConfirm {
 /**
  * Provides a {@link DbxPromptConfirm} implementation for dependency injection.
  *
+ * @param sourceType - The concrete class that implements {@link DbxPromptConfirm}
+ * @returns An array of providers that register the given type as the {@link DbxPromptConfirm} implementation
+ *
  * @example
  * ```ts
  * @Directive({ providers: provideDbxPromptConfirm(MyConfirmDirective) })
@@ -847,6 +877,9 @@ declare const DBX_THEME_COLORS: DbxThemeColor[];
  * dbxColorBackground('primary'); // 'dbx-primary-bg'
  * dbxColorBackground(undefined); // 'dbx-default'
  * ```
+ *
+ * @param color - the theme color to convert, or nullish/empty for the default class
+ * @returns the CSS class name for the themed background (e.g., `'dbx-primary-bg'` or `'dbx-default'`)
  */
 declare function dbxColorBackground(color: Maybe<DbxThemeColor | ''>): CssClass;
 
@@ -1028,18 +1061,37 @@ declare class DbxAvatarViewService {
      * Resolves the injection component configuration for the given avatar context.
      *
      * Falls back to the default component config if no custom resolver is configured or if it returns null.
+     *
+     * @param context - the avatar context used to resolve the appropriate component configuration
+     * @returns the resolved injection component config, or the default if no custom resolver matches
      */
     avatarComponentForContext(context: DbxAvatarContext): DbxAvatarInjectionComponentConfig;
     get defaultAvatarUrl(): Maybe<string>;
     get defaultAvatarIcon(): Maybe<string>;
     get defaultAvatarErrorIcon(): Maybe<string>;
-    /** Sets the default avatar image URL used when no context-specific URL is provided. */
+    /**
+     * Sets the default avatar image URL used when no context-specific URL is provided.
+     *
+     * @param url - the URL to use as the default avatar image, or nullish to clear
+     */
     setDefaultAvatarUrl(url: Maybe<WebsitePath | WebsiteUrlWithPrefix>): void;
-    /** Sets the default Material icon name used as a fallback when no avatar image is available. */
+    /**
+     * Sets the default Material icon name used as a fallback when no avatar image is available.
+     *
+     * @param icon - the Material icon name to use, or nullish to clear
+     */
     setDefaultAvatarIcon(icon: Maybe<string>): void;
-    /** Sets the Material icon name displayed when the avatar image fails to load. */
+    /**
+     * Sets the Material icon name displayed when the avatar image fails to load.
+     *
+     * @param icon - the Material icon name to display on image load error, or nullish to clear
+     */
     setDefaultAvatarErrorIcon(icon: Maybe<string>): void;
-    /** Overrides the default component used to render avatars when no context-specific component is resolved. */
+    /**
+     * Overrides the default component used to render avatars when no context-specific component is resolved.
+     *
+     * @param config - the injection component config to use as the new default
+     */
     setDefaultAvatarComponentConfig(config: DbxAvatarInjectionComponentConfig): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DbxAvatarViewService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<DbxAvatarViewService>;
@@ -1400,6 +1452,8 @@ declare class TwoColumnsContextStore extends ComponentStore<TwoColumnsState> {
  * })
  * export class MyColumnLayoutComponent { }
  * ```
+ *
+ * @returns an array of Angular providers that supply a new {@link TwoColumnsContextStore}
  */
 declare function provideTwoColumnsContext(): Provider[];
 
@@ -1532,7 +1586,7 @@ declare class DbxTwoColumnComponent {
     } | undefined>;
     protected readonly _reverseSizingEffect: _angular_core.EffectRef;
     protected readonly _hasRightContentEffect: _angular_core.EffectRef;
-    viewResized(event: ResizedEvent): void;
+    viewResized(_event: ResizedEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DbxTwoColumnComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DbxTwoColumnComponent, "dbx-two-column", ["columns"], { "reverseSizing": { "alias": "reverseSizing"; "required": false; "isSignal": true; }; "inSectionPage": { "alias": "inSectionPage"; "required": false; "isSignal": true; }; "hasRightContent": { "alias": "hasRightContent"; "required": false; "isSignal": true; }; }, {}, never, ["[left]", "[right]"], true, never>;
 }
@@ -1761,6 +1815,9 @@ type CompactModeOption = CompactMode | boolean;
  * compactModeFromInput(true);  // CompactMode.COMPACT
  * compactModeFromInput(CompactMode.FULL);  // CompactMode.FULL
  * ```
+ *
+ * @param input - a boolean or CompactMode value to normalize
+ * @returns the normalized CompactMode enum value
  */
 declare function compactModeFromInput(input: CompactMode | boolean): CompactMode;
 /**
@@ -1775,6 +1832,10 @@ declare function compactModeFromInput(input: CompactMode | boolean): CompactMode
  *   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
  */
 declare function mapCompactModeObs<T>(mode$: Maybe<Observable<CompactMode>>, config: CompactModeDefaultOptions<T>): Observable<Maybe<T>>;
 
@@ -2097,10 +2158,17 @@ type ScreenMediaHeightType = 'tiny' | 'normal';
  * screenMediaWidthTypeIsActive('tablet', 'small'); // true
  * screenMediaWidthTypeIsActive('micro', 'tablet'); // false
  * ```
+ *
+ * @returns `true` if the current width type meets or exceeds the breakpoint
  */
 declare function screenMediaWidthTypeIsActive(current: ScreenMediaWidthType, breakpoint: ScreenMediaWidthType): boolean;
 /**
  * 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
  */
 declare function compareScreenMediaWidthTypes(a: ScreenMediaWidthType, b: ScreenMediaWidthType, compare: (a: number, b: number) => boolean): boolean;
 
@@ -2258,6 +2326,7 @@ interface DbxValueListItem<T, M = unknown> {
 type DbxValueListItemDecisionFunction<T> = DecisionFunction<DbxValueListItem<T>>;
 /**
  * Convenience function for mapping a DecisionFunction for a value to a DecisionFunction for a DbxValueListItem with the same value type.
+ *
  * @param decisionFunction
  * @returns
  */
@@ -2278,6 +2347,9 @@ interface AbstractDbxValueListViewConfig<T, I extends DbxValueListItem<T> = DbxV
 }
 /**
  * Default mapping function that wraps each raw value into a {@link DbxValueListItem} with only the `itemValue` property set.
+ *
+ * @param itemValues The raw values to wrap as list items
+ * @returns An observable emitting the values wrapped in {@link DbxValueListItem} objects
  */
 declare const DEFAULT_DBX_VALUE_LIST_CONFIG_MAP_VALUES: <T, I extends DbxValueListItem<T>>(itemValues: T[]) => Observable<I[]>;
 /**
@@ -2290,6 +2362,10 @@ type DbxValueListItemConfig<T, I extends DbxValueListItem<T> = DbxValueListItem<
 /**
  * Maps raw values into an observable of {@link DbxValueListItemConfig} items, applying the list view config's mapping function and attaching injection configuration.
  *
+ * @param listViewConfig The list view configuration containing the component and optional mapping function
+ * @param itemValues The raw values to map into configured list items
+ * @returns An observable emitting the mapped and configured list item configs
+ *
  * @example
  * ```ts
  * const items$ = mapValuesToValuesListItemConfigObs(listViewConfig, rawValues);
@@ -2297,11 +2373,11 @@ type DbxValueListItemConfig<T, I extends DbxValueListItem<T> = DbxValueListItem<
  */
 declare function mapValuesToValuesListItemConfigObs<T, I extends DbxValueListItem<T>, V = unknown>(listViewConfig: AbstractDbxValueListViewConfig<T, I, V>, itemValues: T[]): Observable<DbxValueListItemConfig<T, I, V>[]>;
 /**
- * Adds config to the input value list items.
+ * Adds injection component configuration and meta configuration to each list item, producing fully configured {@link DbxValueListItemConfig} entries ready for rendering.
  *
- * @param listViewConfig
- * @param listItems
- * @returns
+ * @param listViewConfig The list view configuration providing injection component config and optional meta config
+ * @param listItems The list items to augment with configuration
+ * @returns The list items extended with injection component configuration attached
  */
 declare function addConfigToValueListItems<T, I extends DbxValueListItem<T>, V = unknown>(listViewConfig: AbstractDbxValueListViewConfig<T, I, V>, listItems: I[]): DbxValueListItemConfig<T, I, V>[];
 /**
@@ -2314,6 +2390,9 @@ declare abstract class DbxValueListView<T, I extends DbxValueListItem<T> = DbxVa
 /**
  * Registers a component as a {@link DbxValueListView} provider for dependency injection.
  *
+ * @param sourceType The component class type to register as the list view provider
+ * @returns An array of Angular providers that bind the given component to {@link DbxValueListView}
+ *
  * @example
  * ```ts
  * @Component({
@@ -2398,6 +2477,9 @@ declare abstract class DbxListView<T, S extends ListLoadingState<T> = ListLoadin
  * })
  * 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
  */
 declare function provideDbxListView<V extends DbxListView<any>>(sourceType: Type<V>): Provider[];
 
@@ -2420,6 +2502,9 @@ declare abstract class DbxValueListItemModifier<T = unknown, I extends DbxValueL
  * })
  * 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
  */
 declare function provideDbxValueListViewModifier<V extends DbxValueListItemModifier>(sourceType: Type<V>): Provider[];
 /**
@@ -2435,6 +2520,10 @@ type ListItemModifier<T, I extends DbxValueListItem<T> = DbxValueListItem<T>> =
  *   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
  */
 declare function listItemModifier<T, I extends DbxValueListItem<T> = DbxValueListItem<T>>(key: string, modify: ModifierFunction<I>): ListItemModifier<T, I>;
 
@@ -2458,7 +2547,7 @@ declare abstract class AbstractDbxValueListViewDirective<T, I extends DbxValueLi
 /**
  * A group of DbxValueListItem values, grouped by common data, name, and id.
  */
-interface DbxValueListItemGroup<G, T, I extends DbxValueListItem<T>, H = unknown, F = unknown> extends Omit<DbxValueListItem<any>, 'itemValue' | 'icon'>, Readonly<Required<UniqueModel>> {
+interface DbxValueListItemGroup<G, T, I extends DbxValueListItem<T>, H = unknown, F = unknown> extends Omit<DbxValueListItem<unknown>, 'itemValue' | 'icon'>, Readonly<Required<UniqueModel>> {
     readonly data: G;
     readonly items: DbxValueListItemConfig<T, I>[];
     /**
@@ -2484,6 +2573,9 @@ interface DbxValueListItemGroup<G, T, I extends DbxValueListItem<T>, H = unknown
 type DbxValueListViewGroupValuesFunction<G, T, I extends DbxValueListItem<T>, H = unknown, F = unknown> = (items: DbxValueListItemConfig<T, I>[]) => ObservableOrValue<DbxValueListItemGroup<G, T, I, H, F>[]>;
 /**
  * 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
  */
 declare const defaultDbxValueListViewGroupValuesFunction: <T, I extends DbxValueListItem<T>>(items: DbxValueListItemConfig<T, I>[]) => DbxValueListItemGroup<unknown, T, I, unknown, unknown>[];
 /**
@@ -2499,15 +2591,20 @@ declare abstract class DbxValueListViewGroupDelegate<G, T, I extends DbxValueLis
 /**
  * Creates a default {@link DbxValueListViewGroupDelegate} that places all items into a single ungrouped list.
  *
+ * @returns A group delegate that places all items into one unnamed group
+ *
  * @example
  * ```ts
  * const delegate = defaultDbxValueListViewGroupDelegate<MyItem>();
  * ```
  */
-declare function defaultDbxValueListViewGroupDelegate<T, I extends DbxValueListItem<T>>(): DbxValueListViewGroupDelegate<any, T, I>;
+declare function defaultDbxValueListViewGroupDelegate<T, I extends DbxValueListItem<T>>(): DbxValueListViewGroupDelegate<unknown, T, I>;
 /**
  * Registers a class as a {@link DbxValueListViewGroupDelegate} provider for dependency injection.
  *
+ * @param sourceType The class type to register as the group delegate provider
+ * @returns An array of Angular providers that bind the given class to {@link DbxValueListViewGroupDelegate}
+ *
  * @example
  * ```ts
  * @Directive({
@@ -2555,6 +2652,10 @@ declare class DbxValueListViewContentGroupComponent<G, T, I extends DbxValueList
  *
  * 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
  */
 declare const DEFAULT_VALUE_LIST_VIEW_CONTENT_COMPONENT_TRACK_BY_FUNCTION: TrackByFunction<DbxValueListItem<unknown>>;
 /**
@@ -2992,6 +3093,9 @@ declare const DBX_LIST_ITEM_DISABLE_RIPPLE_LIST_ITEM_MODIFIER_KEY = "disable_rip
 /**
  * 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
  */
 declare const DBX_LIST_ITEM_DEFAULT_DISABLE_FUNCTION: DbxValueListItemDecisionFunction<unknown>;
 /**
@@ -3017,6 +3121,9 @@ declare class DbxListItemDisableRippleModifierDirective<T> extends AbstractDbxVa
 declare 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
  */
 declare const DEFAULT_DBX_LIST_ITEM_IS_SELECTED_FUNCTION: DbxValueListItemDecisionFunction<unknown>;
 /**
@@ -3234,6 +3341,9 @@ declare abstract class DbxListViewWrapper<T = unknown, S extends ListLoadingStat
  * })
  * 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
  */
 declare function provideDbxListViewWrapper<V extends DbxListViewWrapper>(sourceType: Type<V>): Provider[];
 
@@ -3306,6 +3416,10 @@ declare class DbxListModule {
 
 /**
  * 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
  */
 declare const TRACK_BY_MODEL_ID: TrackByFunction<UniqueModel>;
 /**
@@ -3315,10 +3429,16 @@ declare const TRACK_BY_MODEL_ID: TrackByFunction<UniqueModel>;
  * ```ts
  * readonly trackBy = trackByUniqueIdentifier<MyModel>();
  * ```
+ *
+ * @returns a TrackByFunction that uses the item's `id` for identity tracking
  */
 declare function trackByUniqueIdentifier<T extends UniqueModel>(): TrackByFunction<T>;
 /**
  * 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
  */
 declare const TRACK_BY_MODEL_KEY: TrackByFunction<ModelKeyRef>;
 /**
@@ -3328,6 +3448,8 @@ declare const TRACK_BY_MODEL_KEY: TrackByFunction<ModelKeyRef>;
  * ```ts
  * readonly trackBy = trackByModelKeyRef<MyModelRef>();
  * ```
+ *
+ * @returns a TrackByFunction that uses the item's `key` for identity tracking
  */
 declare function trackByModelKeyRef<T extends ModelKeyRef>(): TrackByFunction<T>;
 
@@ -3813,22 +3935,32 @@ declare class DbxStyleService implements Destroyable {
     toggleSuffix(suffix: DbxStyleClassSuffix, toggle?: Maybe<boolean>): void;
     /**
      * Returns the current style class suffix, if one is set.
+     *
+     * @returns the currently active style class suffix, or undefined if none is set
      */
     get currentStyleClassSuffix(): Maybe<DbxStyleClassCleanSuffix>;
     /**
      * Directly sets the active style class suffix, or clears it if null/undefined.
+     *
+     * @param suffix - the suffix to activate, or nullish to clear the current suffix
      */
     setStyleClassSuffix(suffix: Maybe<DbxStyleClassSuffix>): void;
     /**
      * Updates the default style configuration used when no override config is set.
+     *
+     * @param defaultConfig - the style configuration to use as the new default
      */
     setDefaultConfig(defaultConfig: DbxStyleConfig): void;
     /**
      * Overrides the active style configuration with the given value or observable.
+     *
+     * @param config - a style configuration value or observable to set as the active override
      */
     setConfig(config: ObservableOrValue<DbxStyleConfig>): void;
     /**
      * Clears the active config override if it matches the given reference, reverting to the default config.
+     *
+     * @param config - the config reference to compare against the current override
      */
     unsetConfig(config: ObservableOrValue<DbxStyleConfig>): void;
     destroy(): void;
@@ -3854,6 +3986,9 @@ interface ProvideDbxStyleServiceConfig {
  * ```ts
  * provideDbxStyleService({ dbxStyleConfig: { style: 'my-app', suffixes: new Set(['dark']) } });
  * ```
+ *
+ * @param config - configuration specifying the default style and its allowed suffixes
+ * @returns environment providers for the DbxStyleService and its default config token
  */
 declare function provideDbxStyleService(config: ProvideDbxStyleServiceConfig): EnvironmentProviders;
 
@@ -4047,14 +4182,22 @@ declare class DbxLinkifyService {
     register(entries: ArrayOrValue<DbxLinkifyServiceEntry>, override?: boolean): void;
     /**
      * Returns the default entry.
+     *
+     * @returns the default linkify service entry, or undefined if none is registered
      */
     getDefaultEntry(): Maybe<DbxLinkifyServiceEntry>;
     /**
      * Returns the entry for the given type.
+     *
+     * @param type - the linkify string type to look up
+     * @returns the registered entry for the given type, or undefined if not found
      */
     getEntryRegisteredForType(type: DbxLinkifyStringType): Maybe<DbxLinkifyServiceEntry>;
     /**
      * Returns the entry for the given type, or the default type if there is no entry registered or the input type is null/undefined.
+     *
+     * @param type - the linkify string type to look up, or nullish to retrieve the default entry
+     * @returns the matching entry, or the default entry if the type is not provided
      */
     getEntry(type?: Maybe<DbxLinkifyStringType>): Maybe<DbxLinkifyServiceEntry>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DbxLinkifyService, never>;
@@ -4086,6 +4229,9 @@ interface ProvideDbxLinkifyConfig {
  *   })
  * });
  * ```
+ *
+ * @param config - configuration containing the factory function for creating the linkify service config
+ * @returns environment providers that register the DbxLinkifyServiceConfig
  */
 declare function provideDbxLinkify(config: ProvideDbxLinkifyConfig): EnvironmentProviders;
 
@@ -4110,15 +4256,25 @@ declare class DbxChipDirective {
  * Configuration for a single chip displayed by {@link DbxTextChipsComponent}.
  */
 interface TextChip<T = unknown> {
-    /** Display label for the chip. */
+    /**
+     * Display label for the chip.
+     */
     text: string;
-    /** Optional tooltip shown on hover. */
+    /**
+     * Optional tooltip shown on hover.
+     */
     tooltip?: string;
-    /** Whether the chip appears selected. */
+    /**
+     * Whether the chip appears selected.
+     */
     selected?: boolean;
-    /** Theme color applied to the chip. */
+    /**
+     * Theme color applied to the chip.
+     */
     color?: 'primary' | 'accent' | 'warn' | undefined;
-    /** Arbitrary data payload associated with the chip. */
+    /**
+     * Arbitrary data payload associated with the chip.
+     */
     data?: T;
 }
 /**
@@ -4392,6 +4548,9 @@ interface OverrideClickElementEffectConfig {
  *   childClickTarget: this.buttonElementRef
  * });
  * ```
+ *
+ * @param config - configuration specifying the click target, child element to intercept, and optional disabled signal
+ * @returns the created Angular effect reference
  */
 declare function overrideClickElementEffect(config: OverrideClickElementEffectConfig): _angular_core.EffectRef;
 
@@ -4432,7 +4591,7 @@ declare class DbxTextModule {
 
 declare class DbxLayoutModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DbxLayoutModule, never>;
-    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<DbxLayoutModule, never, never, [typeof DbxBarLayoutModule, typeof DbxCardBoxLayoutModule, typeof DbxColumnLayoutModule, typeof DbxCompactLayoutModule, typeof DbxContentLayoutModule, typeof DbxFlagLayoutModule, typeof DbxFlexLayoutModule, typeof DbxSectionLayoutModule, typeof DbxStyleLayoutModule, typeof DbxTextModule]>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<DbxLayoutModule, never, [typeof DbxCompactDirective, typeof DbxFlexGroupDirective, typeof DbxFlexSizeDirective], [typeof DbxBarLayoutModule, typeof DbxCardBoxLayoutModule, typeof DbxColumnLayoutModule, typeof DbxCompactDirective, typeof DbxContentLayoutModule, typeof DbxFlagLayoutModule, typeof DbxFlexGroupDirective, typeof DbxFlexSizeDirective, typeof DbxSectionLayoutModule, typeof DbxStyleLayoutModule, typeof DbxTextModule]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<DbxLayoutModule>;
 }
 
@@ -4445,21 +4604,37 @@ type DbxButtonType = 'basic' | 'raised' | 'stroked' | 'flat' | 'tonal' | 'icon';
  * over button type, colors, spinner appearance, and floating action button mode.
  */
 interface DbxButtonStyle {
-    /** Material button variant. */
+    /**
+     * Material button variant.
+     */
     readonly type?: DbxButtonType;
-    /** Progress spinner mode (determinate or indeterminate). */
+    /**
+     * Progress spinner mode (determinate or indeterminate).
+     */
     readonly mode?: ProgressSpinnerMode;
-    /** Material theme palette or custom theme color for the button. */
+    /**
+     * Material theme palette or custom theme color for the button.
+     */
     readonly color?: ThemePalette | DbxThemeColor;
-    /** Material theme palette or custom theme color for the loading spinner. */
+    /**
+     * Material theme palette or custom theme color for the loading spinner.
+     */
     readonly spinnerColor?: ThemePalette | DbxThemeColor;
-    /** Custom CSS background color for the button. */
+    /**
+     * Custom CSS background color for the button.
+     */
     readonly customButtonColor?: string;
-    /** Custom CSS text color for the button label. */
+    /**
+     * Custom CSS text color for the button label.
+     */
     readonly customTextColor?: string;
-    /** Custom CSS color for the spinner stroke. */
+    /**
+     * Custom CSS color for the spinner stroke.
+     */
     readonly customSpinnerColor?: string;
-    /** Whether to render as a floating action button (FAB). */
+    /**
+     * Whether to render as a floating action button (FAB).
+     */
     readonly fab?: boolean;
 }
 
@@ -4468,64 +4643,116 @@ interface DbxButtonStyle {
  * colors, spinner behavior, and button type.
  */
 interface DbxProgressButtonConfig {
-    /** Current working state. A boolean enables indeterminate mode; a number (0-100) enables determinate mode. */
+    /**
+     * Current working state. A boolean enables indeterminate mode; a number (0-100) enables determinate mode.
+     */
     readonly working?: Maybe<DbxButtonWorking>;
-    /** Button label text. */
+    /**
+     * Button label text.
+     */
     readonly text?: Maybe<string>;
-    /** Text displayed alongside the spinner while working. */
+    /**
+     * Text displayed alongside the spinner while working.
+     */
     readonly spinnerText?: Maybe<string>;
-    /** Theme color for the button itself. */
+    /**
+     * Theme color for the button itself.
+     */
     readonly buttonColor?: Maybe<ThemePalette | DbxThemeColor>;
-    /** Theme color for the progress spinner. */
+    /**
+     * Theme color for the progress spinner.
+     */
     readonly spinnerColor?: Maybe<ThemePalette | DbxThemeColor>;
-    /** Theme color for the progress bar (bar mode only). */
+    /**
+     * Theme color for the progress bar (bar mode only).
+     */
     readonly barColor?: Maybe<ThemePalette | DbxThemeColor>;
-    /** When true, renders only the icon button without text. */
+    /**
+     * When true, renders only the icon button without text.
+     */
     readonly iconOnly?: Maybe<boolean>;
-    /** Explicit spinner diameter in pixels. */
+    /**
+     * Explicit spinner diameter in pixels.
+     */
     readonly spinnerSize?: Maybe<number>;
-    /** Ratio of spinner size relative to button height (0-1). */
+    /**
+     * Ratio of spinner size relative to button height (0-1).
+     */
     readonly spinnerRatio?: Maybe<number>;
-    /** Spinner mode: determinate or indeterminate. */
+    /**
+     * Spinner mode: determinate or indeterminate.
+     */
     readonly mode?: Maybe<ProgressSpinnerMode>;
-    /** Whether the button stretches to full container width. */
+    /**
+     * Whether the button stretches to full container width.
+     */
     readonly fullWidth?: Maybe<boolean>;
-    /** Whether the button is disabled. */
+    /**
+     * Whether the button is disabled.
+     */
     readonly disabled?: Maybe<boolean>;
-    /** Custom inline styles applied to the button element. */
+    /**
+     * Custom inline styles applied to the button element.
+     */
     readonly customStyle?: Maybe<{
         [key: string]: string;
     }>;
-    /** Custom CSS class applied to the button element. */
+    /**
+     * Custom CSS class applied to the button element.
+     */
     readonly customClass?: Maybe<string>;
-    /** Custom CSS color for the spinner stroke. Overrides `spinnerColor` when provided. */
+    /**
+     * Custom CSS color for the spinner stroke. Overrides `spinnerColor` when provided.
+     */
     readonly customSpinnerColor?: Maybe<string>;
-    /** Icon configuration for the button. */
+    /**
+     * Icon configuration for the button.
+     */
     readonly buttonIcon?: Maybe<DbxProgressButtonIcon>;
-    /** Identifier used for matching against global configuration. */
+    /**
+     * Identifier used for matching against global configuration.
+     */
     readonly id?: Maybe<string>;
-    /** Material button variant to render. */
+    /**
+     * Material button variant to render.
+     */
     readonly buttonType?: Maybe<DbxButtonType>;
-    /** HTML `type` attribute for the underlying button element (e.g. "submit", "button"). */
+    /**
+     * HTML `type` attribute for the underlying button element (e.g. "submit", "button").
+     */
     readonly buttonTypeAttribute?: Maybe<string>;
-    /** Whether to render as a floating action button (FAB). */
+    /**
+     * Whether to render as a floating action button (FAB).
+     */
     readonly fab?: Maybe<boolean>;
 }
 /**
  * Configuration for the icon displayed inside a progress button.
  */
 interface DbxProgressButtonIcon {
-    /** Theme color for the icon. */
+    /**
+     * Theme color for the icon.
+     */
     readonly color?: Maybe<ThemePalette | DbxThemeColor>;
-    /** Material icon font ligature name (e.g. "save", "delete"). */
+    /**
+     * Material icon font ligature name (e.g. "save", "delete").
+     */
     readonly fontIcon?: Maybe<string>;
-    /** Icon font set to use (e.g. for extended icon libraries). */
+    /**
+     * Icon font set to use (e.g. for extended icon libraries).
+     */
     readonly fontSet?: Maybe<string>;
-    /** Whether to render the icon inline with text. */
+    /**
+     * Whether to render the icon inline with text.
+     */
     readonly inline?: Maybe<boolean>;
-    /** SVG icon name registered with MatIconRegistry. */
+    /**
+     * SVG icon name registered with MatIconRegistry.
+     */
     readonly svgIcon?: Maybe<string>;
-    /** Custom CSS class applied to the icon element. */
+    /**
+     * Custom CSS class applied to the icon element.
+     */
     readonly customClass?: Maybe<string>;
 }
 /**
@@ -4610,7 +4837,7 @@ declare class DbxProgressSpinnerButtonComponent extends AbstractProgressButtonDi
     readonly buttonCssSignal: _angular_core.Signal<string | undefined>;
     readonly showTextContentSignal: _angular_core.Signal<boolean>;
     readonly showTextButtonIconSignal: _angular_core.Signal<false | Maybe<_dereekb_dbx_web.DbxProgressButtonIcon>>;
-    readonly showIconSignal: _angular_core.Signal<boolean | null | undefined>;
+    readonly showIconSignal: _angular_core.Signal<boolean | _dereekb_util.MaybeNot>;
     readonly customSpinnerStyleSignal: _angular_core.Signal<{
         stroke: string;
     } | undefined>;
@@ -4765,7 +4992,9 @@ declare class DbxErrorDefaultErrorWidgetComponent extends AbstractDbxErrorWidget
  * Event emitted when the error icon button is clicked, containing the button's element reference for popover anchoring.
  */
 interface DbxErrorViewButtonEvent {
-    /** The element reference of the clicked button, used as the popover origin. */
+    /**
+     * The element reference of the clicked button, used as the popover origin.
+     */
     readonly origin: ElementRef;
 }
 /**
@@ -4876,6 +5105,9 @@ declare class DbxActionErrorDirective {
  * 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.
  */
 declare function convertToPOJOServerErrorResponse(httpError: HttpErrorResponse | object): ServerError;
 /**
@@ -4891,6 +5123,9 @@ declare function convertToPOJOServerErrorResponse(httpError: HttpErrorResponse |
  *   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.
  */
 declare function convertToServerErrorResponse(error: HttpErrorResponse | object): ServerErrorResponse | undefined;
 
@@ -4938,14 +5173,18 @@ declare class DbxLoadingErrorDirective {
 /**
  * Configuration for error snackbar display, extending Material snackbar config but excluding `data` and `viewContainerRef`.
  */
-type DbxErrorSnackbarConfig = Omit<MatSnackBarConfig<any>, 'data' | 'viewContainerRef'>;
+type DbxErrorSnackbarConfig = Omit<MatSnackBarConfig<unknown>, 'data' | 'viewContainerRef'>;
 /**
  * Data passed to the error snackbar component via `MAT_SNACK_BAR_DATA`.
  */
 interface DbxErrorSnackbarData<T extends ErrorInput = ErrorInput> {
-    /** The error to display in the snackbar. */
+    /**
+     * The error to display in the snackbar.
+     */
     readonly error: T;
-    /** Optional auto-dismiss duration in milliseconds. If omitted, the snackbar persists until manually dismissed. */
+    /**
+     * Optional auto-dismiss duration in milliseconds. If omitted, the snackbar persists until manually dismissed.
+     */
     readonly duration?: number;
 }
 /**
@@ -5186,9 +5425,13 @@ declare const DEFAULT_ERROR_POPOVER_KEY = "error";
  * Configuration for opening an error popover via {@link DbxErrorPopoverComponent.openPopover}.
  */
 interface DbxErrorPopoverConfig {
-    /** The element that the popover should be anchored to. */
+    /**
+     * The element that the popover should be anchored to.
+     */
     readonly origin: ElementRef;
-    /** The error to display in the popover. */
+    /**
+     * The error to display in the popover.
+     */
     readonly error: ReadableError;
 }
 /**
@@ -5336,6 +5579,9 @@ interface ServerErrorParams {
  * 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.
  */
 declare function convertServerErrorParams(httpError: HttpErrorResponse | object): ServerErrorParams;
 /**
@@ -5350,6 +5596,10 @@ declare function convertServerErrorParams(httpError: HttpErrorResponse | object)
  *   ))
  * );
  * ```
+ *
+ * @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.
  */
 declare function catchErrorServerParams<E extends ServerErrorParams, T extends string>(action: ActionCreator<T, (props: E) => E & Action<T>>, mapError?: (error: ServerErrorParams) => E): MonoTypeOperatorFunction<E & Action<T>>;
 
@@ -5370,6 +5620,13 @@ interface DbxModelState {
 interface State {
     [FEATURE_KEY]: DbxModelState;
 }
+/**
+ * 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
+ */
 declare function reducers(state: DbxModelState | undefined, action: Action): {
     "model.module.config": DbxModelModuleStateConfiguration;
 };
@@ -5484,6 +5741,9 @@ interface DbxModelViewTrackerEventSet {
  * ```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
  */
 declare function allDbxModelViewTrackerEventSetModelKeys(eventSet: DbxModelViewTrackerEventSet): ModelKey[];
 /**
@@ -5493,6 +5753,9 @@ declare function allDbxModelViewTrackerEventSetModelKeys(eventSet: DbxModelViewT
  * ```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
  */
 declare function allDbxModelViewTrackerEventModelKeys(events: DbxModelViewTrackerEvent[]): ModelKey[];
 
@@ -5503,6 +5766,9 @@ declare function allDbxModelViewTrackerEventModelKeys(events: DbxModelViewTracke
  * ```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
  */
 declare function defaultDbxModelViewTrackerStorageAccessorFactory(storageAccessorFactory: SimpleStorageAccessorFactory): StorageAccessor<DbxModelViewTrackerEventSet>;
 /**
@@ -5519,6 +5785,10 @@ declare class DbxModelObjectStateService {
     readonly store: Store<any>;
     /**
      * Emit a model viewed event.
+     *
+     * @param params - The model viewed event parameters
+     * @param params.modelKeyTypeNamePair - Identifies the model that was viewed
+     * @param params.context - Optional context describing how the model was viewed
      */
     emitModelViewEvent({ modelKeyTypeNamePair, context }: DbxModelObjectViewedParams): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DbxModelObjectStateService, never>;
@@ -5537,6 +5807,8 @@ declare class DbxModelTrackerService {
     readonly newEvent$: Observable<DbxModelViewTrackerEvent>;
     /**
      * The default storage folder used when no folder is specified in tracking calls.
+     *
+     * @returns The current default folder name, or undefined if not set
      */
     get defaultFolder(): Maybe<string>;
     set defaultFolder(folder: Maybe<string>);
@@ -5552,12 +5824,14 @@ declare class DbxModelTrackerService {
      * Returns all recorded view events for the given folder, sorted by most recent first.
      *
      * @param folder - Storage folder; defaults to {@link defaultFolder}
+     * @returns Observable of view events sorted by most recent first
      */
     getAllViewEvents(folder?: Maybe<string>): Observable<DbxModelViewTrackerEvent[]>;
     /**
      * Returns the complete event set (events and last-update timestamp) for the given folder.
      *
      * @param folder - Storage folder; defaults to {@link defaultFolder}
+     * @returns Observable of the complete event set including events and last-update timestamp
      */
     getViewEventSet(folder?: Maybe<string>): Observable<DbxModelViewTrackerEventSet>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DbxModelTrackerService, never>;
@@ -5590,12 +5864,14 @@ declare class DbxModelViewTrackerStorage {
      * Returns all stored view events for the given folder.
      *
      * @param folder - Optional folder name; defaults to `'default'`
+     * @returns Observable of all view tracker events in the folder
      */
     getAllEvents(folder?: Maybe<string>): Observable<DbxModelViewTrackerEvent[]>;
     /**
      * Returns the complete event set for the given folder.
      *
      * @param folder - Optional folder name; defaults to `'default'`
+     * @returns Observable of the event set containing events and the last-update timestamp
      */
     getEventSet(folder?: Maybe<string>): Observable<DbxModelViewTrackerEventSet>;
     private _getEventSetForStorageKey;
@@ -5603,6 +5879,7 @@ declare class DbxModelViewTrackerStorage {
      * Computes the storage key for a given folder name.
      *
      * @param folder - Optional folder name; defaults to `'default'`
+     * @returns The computed storage key string combining the base key and folder name
      */
     getStorageKeyForFolder(folder?: Maybe<string>): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DbxModelViewTrackerStorage, never>;
@@ -5711,6 +5988,7 @@ declare class DbxModelTypesService<I extends DbxModelTypeInfo = DbxModelTypeInfo
      * Returns an observable of the Material icon name for the given model type.
      *
      * @param type - The model type string to look up
+     * @returns Observable emitting the icon name for the given model type
      */
     iconForType(type: ModelTypeString): Observable<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DbxModelTypesService<any>, never>;
@@ -5871,7 +6149,7 @@ interface DbxWebFilePreviewServicePreviewDialogFunctionInputWithMatDialog extend
 /**
  * Used for previewing a src url and embedMimeType in a dialog.
  */
-type DbxWebFilePreviewServicePreviewDialogFunction = (input: DbxWebFilePreviewServicePreviewDialogFunctionInputWithMatDialog) => MatDialogRef<any, any>;
+type DbxWebFilePreviewServicePreviewDialogFunction = (input: DbxWebFilePreviewServicePreviewDialogFunctionInputWithMatDialog) => MatDialogRef<unknown, unknown>;
 /**
  * Configuration for a preview entry.
  */
@@ -5903,7 +6181,7 @@ interface DbxWebFilePreviewServicePreviewDialogWithComponentFunctionInput extend
 /**
  * Used for previewing a src url and embedMimeType in a dialog.
  */
-type DbxWebFilePreviewServicePreviewDialogWithComponentFunction = (input: DbxWebFilePreviewServicePreviewDialogWithComponentFunctionInput) => MatDialogRef<any, any>;
+type DbxWebFilePreviewServicePreviewDialogWithComponentFunction = (input: DbxWebFilePreviewServicePreviewDialogWithComponentFunctionInput) => MatDialogRef<unknown, unknown>;
 /**
  * @deprecated use DbxWebFilePreviewServicePreviewDialogFunction instead.
  */
@@ -5916,6 +6194,9 @@ declare const DBX_WEB_FILE_PREVIEW_SERVICE_ENTRIES_TOKEN: InjectionToken<DbxWebF
 /**
  * Creates a provider that registers the given entries with the {@link DbxWebFilePreviewService} via the {@link DBX_WEB_FILE_PREVIEW_SERVICE_ENTRIES_TOKEN}.
  *
+ * @param entries - Array of preview service entries to register, each mapping a MIME type to its preview component
+ * @returns A provider configuration that supplies the entries via the injection token
+ *
  * @example
  * ```typescript
  * provideDbxWebFilePreviewServiceEntries([DBX_WEB_FILE_PREVIEW_SERVICE_ZIP_PRESET_ENTRY]);
@@ -5925,15 +6206,18 @@ declare function provideDbxWebFilePreviewServiceEntries(entries: DbxWebFilePrevi
     provide: InjectionToken<DbxWebFilePreviewServiceEntry[]>;
     useValue: DbxWebFilePreviewServiceEntry[];
 };
-/**
- * Default preset for previewing a file using a DbxEmbedDialogComponent.
- */
 /**
  * Default preview component function that embeds files using {@link DbxEmbedComponent}. Images are rendered with an `img` element; all other types use `embed`.
+ *
+ * @param input - The preview input containing blob data, source URL, and MIME type information
+ * @returns An injection component config that initializes a {@link DbxEmbedComponent} with the appropriate embed element and content
  */
 declare const DBX_WEB_FILE_PREVIEW_SERVICE_DEFAULT_PREVIEW_COMPONENT_FUNCTION: DbxWebFilePreviewServicePreviewComponentFunction;
 /**
  * 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
  */
 declare const DBX_WEB_FILE_PREVIEW_SERVICE_DEFAULT_DIALOG_WITH_COMPONENT_FUNCTION: DbxWebFilePreviewServicePreviewDialogWithComponentFunction;
 /**
@@ -5942,7 +6226,7 @@ declare const DBX_WEB_FILE_PREVIEW_SERVICE_DEFAULT_DIALOG_WITH_COMPONENT_FUNCTIO
 declare class DbxWebFilePreviewService {
     readonly matDialog: MatDialog;
     private readonly _entries;
-    constructor(entries: DbxWebFilePreviewServiceEntry[]);
+    constructor();
     private _defaultPreviewComponentFunction;
     private _defaultPreviewDialogWithComponentFunction;
     /**
@@ -5959,16 +6243,21 @@ declare class DbxWebFilePreviewService {
     registerPreviewEntry(entry: DbxWebFilePreviewServiceEntry): void;
     /**
      * Overrides the default preview component function used when no MIME-specific entry is registered.
+     *
+     * @param previewFunction - The preview component function to use as the new default
      */
     setDefaultPreviewComponentFunction(previewFunction: DbxWebFilePreviewServicePreviewComponentFunction): void;
     /**
      * Overrides the default dialog-with-component function used when no MIME-specific dialog handler is registered.
+     *
+     * @param previewDialogWithComponentFunction - The dialog-with-component function to use as the new default
      */
     setDefaultPreviewDialogWithComponentFunction(previewDialogWithComponentFunction: DbxWebFilePreviewServicePreviewDialogWithComponentFunction): void;
     /**
      * Creates an injection component config for previewing a file. Uses a MIME-specific preview function if registered, otherwise falls back to the default.
      *
      * @param input - The preview input containing blob, URL, and MIME type information
+     * @returns An injection component config suitable for rendering the file preview
      */
     createPreviewConfig(input: DbxWebFilePreviewServicePreviewComponentFunctionInput): dist_packages_dbx_core_types_dereekb_dbx_core.DbxInjectionComponentConfig<any>;
     /**
@@ -5977,8 +6266,8 @@ declare class DbxWebFilePreviewService {
      * @param input - The dialog input containing file data and MIME type
      * @returns Reference to the opened dialog
      */
-    openPreviewDialog(input: DbxWebFilePreviewServicePreviewDialogFunctionInput): MatDialogRef<any, any>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DbxWebFilePreviewService, [{ optional: true; }]>;
+    openPreviewDialog(input: DbxWebFilePreviewServicePreviewDialogFunctionInput): MatDialogRef<unknown, unknown>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DbxWebFilePreviewService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<DbxWebFilePreviewService>;
 }
 
@@ -6004,6 +6293,9 @@ declare class DbxWebFilePreviewComponent {
 
 /**
  * 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
  */
 declare const DBX_WEB_FILE_PREVIEW_SERVICE_ZIP_COMPONENT_PRESET: DbxWebFilePreviewServicePreviewComponentFunction;
 /**
@@ -6100,8 +6392,9 @@ declare class DbxWidgetService {
     /**
      * Used to register an entry. If an entry with the same type is already registered, this will override it by default.
      *
-     * @param entry
-     * @param override
+     * @param entry - The widget entry mapping a type identifier to its component class
+     * @param override - Whether to replace an existing entry with the same type. Defaults to true.
+     * @returns True if the entry was registered, false if an entry with the same type already exists and override is false
      */
     register(entry: DbxWidgetEntry, override?: boolean): boolean;
     getWidgetIdentifiers(): DbxWidgetType[];
@@ -6197,6 +6490,9 @@ type DbxZipBlobPreviewEntryTreeRoot = SlashPathDirectoryTreeRoot<Entry, DbxZipBl
 /**
  * Builds a directory tree from an array of zip archive entries, enriching each node with MIME type detection and blob retrieval capability.
  *
+ * @param entries - Array of zip archive entries to build the tree from, or null/undefined for an empty tree
+ * @returns The root node of the constructed directory tree with MIME types and blob getters attached
+ *
  * @example
  * ```typescript
  * const root = dbxZipBlobPreviewEntryTreeFromEntries(zipEntries);
@@ -6647,6 +6943,8 @@ declare class DbxAngularRouterSegueAnchorComponent extends AbstractDbxSegueAncho
  *   providers: [provideDbxRouterWebAngularRouterProviderConfig()]
  * });
  * ```
+ *
+ * @returns environment providers that configure the Angular Router-based segue anchor component
  */
 declare function provideDbxRouterWebAngularRouterProviderConfig(): EnvironmentProviders;
 
@@ -6677,6 +6975,8 @@ declare class DbxUIRouterSegueAnchorComponent extends AbstractDbxSegueAnchorDire
  *   providers: [provideDbxRouterWebUiRouterProviderConfig()]
  * });
  * ```
+ *
+ * @returns environment providers that configure the UIRouter-based segue anchor component
  */
 declare function provideDbxRouterWebUiRouterProviderConfig(): EnvironmentProviders;
 
@@ -6912,6 +7212,9 @@ type DbxDialogContentConfig = Omit<MatDialogConfig, 'viewContainerRef' | 'inject
 /**
  * Sanitizes a {@link DbxDialogContentConfig} by normalizing the panelClass into an array.
  *
+ * @param input - The dialog content config to sanitize, or null/undefined
+ * @returns A new config with panelClass normalized to an array of CSS class strings
+ *
  * @example
  * ```ts
  * const config = sanitizeDbxDialogContentConfig({ panelClass: 'my-panel my-other-panel' });
@@ -7029,6 +7332,9 @@ declare class DbxHelpContextService {
  * // 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
  */
 declare function registerHelpContextKeysWithDbxHelpContextService(helpContextKeys: ObservableOrValue<DbxHelpContextKey[]>): DestroyFunction;
 
@@ -7128,29 +7434,39 @@ declare class DbxHelpWidgetService {
     private _helpListFooterComponentConfig;
     private _defaultIcon;
     private _popoverHeaderComponentConfig;
-    constructor(initialConfig?: DbxHelpWidgetServiceConfig);
+    constructor();
     /**
      * Returns the component class used for unrecognized help context keys.
+     *
+     * @returns The default widget component class, or undefined if not set
      */
     getDefaultWidgetComponentClass(): Maybe<Type<unknown>>;
     setDefaultWidgetComponentClass(componentClass: Maybe<Type<unknown>>): void;
     /**
      * Returns the default icon used for help entries without a specific icon.
+     *
+     * @returns The default icon string, or undefined if not set
      */
     getDefaultIcon(): Maybe<string>;
     setDefaultIcon(icon: Maybe<string>): void;
     /**
      * Returns the component config displayed in the popover header, if set.
+     *
+     * @returns The popover header component config, or undefined if not set
      */
     getPopoverHeaderComponentConfig(): Maybe<DbxInjectionComponentConfig>;
     setPopoverHeaderComponentConfig(componentConfig: Maybe<DbxInjectionComponentConfig>): void;
     /**
      * Returns the component config displayed at the top of the help list view, if set.
+     *
+     * @returns The help list header component config, or undefined if not set
      */
     getHelpListHeaderComponentConfig(): Maybe<DbxInjectionComponentConfig>;
     setHelpListHeaderComponentConfig(componentConfig: Maybe<DbxInjectionComponentConfig>): void;
     /**
      * Returns the component config displayed at the bottom of the help list view, if set.
+     *
+     * @returns The help list footer component config, or undefined if not set
      */
     getHelpListFooterComponentConfig(): Maybe<DbxInjectionComponentConfig>;
     setHelpListFooterComponentConfig(componentConfig: Maybe<DbxInjectionComponentConfig>): void;
@@ -7161,33 +7477,43 @@ declare class DbxHelpWidgetService {
      *
      * @param entries The entries to register
      * @param override Whether to override existing entries (default: true)
+     * @returns Always returns true after registration completes
      */
     register(entries: ArrayOrValue<DbxHelpWidgetServiceEntry>, override?: boolean): boolean;
     /**
      * Returns all currently registered help context keys.
+     *
+     * @returns Array of all registered help context keys
      */
     getAllRegisteredHelpContextKeys(): DbxHelpContextKey[];
     /**
      * Retrieves the widget entry for a given help context key. Falls back to a default entry if a default widget component class is configured.
      *
      * @param helpContextKey - The help context key to look up
+     * @returns The matching widget entry, a default entry if a default component class is configured, or undefined
      */
     getHelpWidgetEntry(helpContextKey: DbxHelpContextKey): Maybe<DbxHelpWidgetServiceEntry>;
     /**
      * Retrieves widget entries for multiple help context keys, filtering out any unresolvable keys.
      *
      * @param helpContextKeys - Array of help context keys to look up
+     * @returns Array of resolved widget entries, excluding any keys that could not be resolved
      */
     getHelpWidgetEntriesForHelpContextKeys(helpContextKeys: DbxHelpContextKey[]): DbxHelpWidgetServiceEntry[];
     /**
      * Checks whether a widget entry is registered for the given help context key.
+     *
+     * @param context - The help context key to check
+     * @returns True if a widget entry exists for the given key
      */
     hasHelpWidgetEntry(context: DbxHelpContextKey): boolean;
     /**
      * Returns a cached map of help context keys to their sort priority values.
+     *
+     * @returns Map of help context keys to their numeric sort priorities
      */
     getSortPriorityMap(): Map<string, number>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DbxHelpWidgetService, [{ optional: true; }]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DbxHelpWidgetService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<DbxHelpWidgetService>;
 }
 
@@ -7390,8 +7716,8 @@ declare abstract class AbstractPopoverRefDirective<T = unknown, R = unknown> {
     showPopover(origin?: ElementRef): void;
     private _showPopoverRef;
     protected abstract _makePopoverRef(origin?: ElementRef): NgPopoverRef<T, R>;
-    protected _afterOpened(popoverRef: NgPopoverRef<T, R>): void;
-    protected _afterClosed(value: NgPopoverCloseEvent<R>): void;
+    protected _afterOpened(_popoverRef: NgPopoverRef<T, R>): void;
+    protected _afterClosed(_value: NgPopoverCloseEvent<R>): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AbstractPopoverRefDirective<any, any>, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AbstractPopoverRefDirective<any, any>, never, never, {}, {}, never, never, true, never>;
 }
@@ -7552,6 +7878,11 @@ interface DbxPresetFilterMenuConfig {
 /**
  * Creates an observable that emits the button text for a preset filter menu based on the current selection.
  *
+ * @param config$ - Observable of the preset filter menu configuration
+ * @param selection$ - Observable of the currently selected preset, used to derive the display title
+ * @param defaultText - Fallback text when no selection or unknownSelectionText is configured. Defaults to 'Filter'.
+ * @returns An observable emitting the resolved button text string
+ *
  * @example
  * ```ts
  * const text$ = dbxPresetFilterMenuButtonTextObservable(config$, selectedPreset$);
@@ -7561,6 +7892,11 @@ declare function dbxPresetFilterMenuButtonTextObservable(config$: Observable<Dbx
 /**
  * Creates an observable that emits the button icon for a preset filter menu based on the current selection and config.
  *
+ * @param config$ - Observable of the preset filter menu configuration controlling icon behavior
+ * @param selection$ - Observable of the currently selected preset, used to derive the display icon
+ * @param defaultIcon - Fallback icon when no filterIcon is configured. Defaults to 'arrow_drop_down'.
+ * @returns An observable emitting the resolved icon string, or undefined when no icon should be shown
+ *
  * @example
  * ```ts
  * const icon$ = dbxPresetFilterMenuButtonIconObservable(config$, selectedPreset$);
@@ -7796,6 +8132,10 @@ interface DbxIframeDialogConfig extends Omit<MatDialogConfig, 'data'> {
 /**
  * Opens a dialog containing a {@link DbxIframeComponent} to display a URL in an iframe.
  *
+ * @param matDialog - The Angular Material dialog service used to open the dialog
+ * @param config - Configuration specifying the content URL and dialog options
+ * @returns A reference to the opened dialog for controlling or subscribing to its lifecycle
+ *
  * @example
  * ```ts
  * const ref = openIframeDialog(matDialog, { contentUrl: 'https://example.com' });
@@ -7864,6 +8204,10 @@ interface DbxEmbedDialogConfig extends Omit<MatDialogConfig, 'data'> {
 /**
  * Opens a dialog containing a {@link DbxEmbedComponent} to display embedded content from a URL or Blob.
  *
+ * @param matDialog - The Angular Material dialog service used to open the dialog
+ * @param config - Configuration specifying the content source (URL or Blob), MIME type, and dialog options
+ * @returns A reference to the opened dialog for controlling or subscribing to its lifecycle
+ *
  * @example
  * ```ts
  * const ref = openEmbedDialog(matDialog, { srcUrl: 'https://example.com/doc.pdf', embedMimeType: 'application/pdf' });
@@ -8472,8 +8816,8 @@ type FileAcceptString = string;
 /**
  * Returns a string that can be used as the "accept" attribute of a file input element.
  *
- * @param accept
- * @returns
+ * @param accept - A file accept string or array of filter type strings to convert
+ * @returns A comma-separated string suitable for the HTML accept attribute
  */
 declare function fileAcceptString(accept: FileAcceptString | FileAcceptFilterTypeStringArray): FileAcceptString;
 /**
@@ -8489,6 +8833,9 @@ type FileAcceptFilterTypeStringArray = FileAcceptFilterTypeString[];
 /**
  * Converts a comma-separated accept string or array into a {@link FileAcceptFilterTypeStringArray}.
  *
+ * @param accept - A file accept string or array of filter type strings to normalize
+ * @returns An array of individual filter type strings
+ *
  * @example
  * ```ts
  * const types = fileAcceptFilterTypeStringArray('image/png, .pdf');
@@ -8548,6 +8895,9 @@ type FileArrayAcceptMatchFunction = (input: File[]) => FileArrayAcceptMatchResul
 /**
  * Creates a {@link FileArrayAcceptMatchFunction} that filters and separates files based on accept criteria and multiple file support.
  *
+ * @param config - Configuration specifying the accept criteria and whether multiple files are allowed
+ * @returns A function that accepts an array of files and returns the categorized match result
+ *
  * @example
  * ```ts
  * const matchFn = fileArrayAcceptMatchFunction({ accept: 'image/*', multiple: false });
@@ -8569,6 +8919,9 @@ type FileAcceptFunction = DecisionFunction<FileAcceptFunctionInput>;
 /**
  * Creates a {@link FileAcceptFunction} that checks individual files against accept criteria (MIME types, wildcards, or file extensions).
  *
+ * @param accept - A file accept string or array specifying which MIME types, wildcards, or file extensions to allow
+ * @returns A decision function that returns true if a file matches any of the accept criteria
+ *
  * @example
  * ```ts
  * const isAccepted = fileAcceptFunction(['image/*', '.pdf']);
@@ -8590,6 +8943,9 @@ declare abstract class DbxFileUploadActionCompatable {
 /**
  * Provides a {@link DbxFileUploadActionCompatable} for dependency injection from the given component type.
  *
+ * @param sourceType - The concrete component class that implements {@link DbxFileUploadActionCompatable}
+ * @returns An array of providers that register the given type as the {@link DbxFileUploadActionCompatable} implementation
+ *
  * @example
  * ```ts
  * @Component({ providers: provideDbxFileUploadActionCompatable(MyUploadComponent) })
@@ -8905,7 +9261,7 @@ declare class DbxScreenMediaService implements Destroyable {
     private readonly _updateHeight;
     readonly widthType$: Observable<ScreenMediaWidthType>;
     readonly heightType$: Observable<ScreenMediaHeightType>;
-    constructor(config: DbxScreenMediaServiceConfig);
+    constructor();
     destroy(): void;
     /**
      * Returns an observable that emits `true` when the current screen width is at least as wide as the given breakpoint.