@dereekb/dbx-core 13.4.1 → 13.4.2

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

@@ -750,6 +750,7 @@ declare abstract class DbxActionContextBaseSource<T = unknown, O = unknown> impl
     readyValue(value: T | Observable<T>): void;
     /**
      * Triggers the context and then readies the value.
+     *
      * @param value
      */
     triggerWithValue(value: T | Observable<T>): void;
@@ -882,12 +883,14 @@ declare abstract class ActionContextStoreSourceMap<T = unknown, O = unknown> imp
     abstract sourceForKey(key: ActionKey): ActionContextStoreSource<T, O>;
     /**
      * Adds the store source for the input key.
+     *
      * @param key Action key to add the source for.
      * @param source Store source to add.
      */
     abstract addStoreSource(key: ActionKey, source: ActionContextStoreSource<T, O>): void;
     /**
      * Removes the store source for the input key.
+     *
      * @param key Action key to remove the source for.
      */
     abstract removeStoreSource(key: ActionKey): void;
@@ -2210,11 +2213,17 @@ type AuthTransitionDecision = true | false | SegueRefOrSegueRefRouterLink;
  * for making authorization decisions.
  */
 interface AuthTransitionDecisionGetterInput {
-    /** The UIRouter transition that triggered the auth check. */
+    /**
+     * The UIRouter transition that triggered the auth check.
+     */
     readonly transition: Transition;
-    /** The Angular injector for resolving additional dependencies. */
+    /**
+     * The Angular injector for resolving additional dependencies.
+     */
     readonly injector: Injector;
-    /** The auth service for querying the current authentication state. */
+    /**
+     * The auth service for querying the current authentication state.
+     */
     readonly authService: DbxAuthService;
 }
 /**
@@ -2624,7 +2633,7 @@ declare const DBX_KNOWN_APP_CONTEXT_STATES: DbxKnownAppContextState[];
 /**
  * The feature key for these items/reducers.
  */
-declare const dbxAppContextStateFeatureKey = "data";
+declare const DBX_APP_CONTEXT_STATE_FEATURE_KEY = "data";
 /**
  * The typings for this feature.
  */
@@ -2635,21 +2644,25 @@ interface DbxAppContextStateData {
 /**
  * Global feature key for our app.
  */
-declare const featureKey$1 = "app.context";
+declare const FEATURE_KEY$1 = "app.context";
 /**
  * This is a "feature state", which in this case is a single feature (our app state), but could include keys/states within this feature.
  */
 interface DbxAppContextFeatureState {
-    [dbxAppContextStateFeatureKey]: DbxAppContextStateData;
+    [DBX_APP_CONTEXT_STATE_FEATURE_KEY]: DbxAppContextStateData;
 }
 /**
  * Interface typing extension for the DbxAppContextFeatureState, and the typing information for how this feature extends the base state.
  */
 interface State$1 {
-    [featureKey$1]: DbxAppContextFeatureState;
+    [FEATURE_KEY$1]: DbxAppContextFeatureState;
 }
 /**
  * Reducers mapping for the DbxAppContextFeatureState
+ *
+ * @param state - The current feature state, or undefined for initialization.
+ * @param action - The dispatched action to reduce.
+ * @returns The updated feature state.
  */
 declare function reducers$1(state: DbxAppContextFeatureState | undefined, action: Action): {
     data: DbxAppContextStateData;
@@ -2669,7 +2682,7 @@ type index_d$3_DbxAppContextFeatureState = DbxAppContextFeatureState;
 declare const index_d$3_selectAppContextFeature: typeof selectAppContextFeature;
 declare const index_d$3_selectDbxAppContextState: typeof selectDbxAppContextState;
 declare namespace index_d$3 {
-  export { featureKey$1 as featureKey, reducers$1 as reducers, index_d$3_selectAppContextFeature as selectAppContextFeature, index_d$3_selectDbxAppContextState as selectDbxAppContextState };
+  export { FEATURE_KEY$1 as FEATURE_KEY, reducers$1 as reducers, index_d$3_selectAppContextFeature as selectAppContextFeature, index_d$3_selectDbxAppContextState as selectDbxAppContextState };
   export type { index_d$3_DbxAppContextFeatureState as DbxAppContextFeatureState, State$1 as State };
 }
 
@@ -2829,7 +2842,7 @@ declare abstract class AbstractOnDbxAppContextStateEffects<S = unknown> implemen
 /**
  * NgRx feature key for the auth user sub-state within the auth feature.
  */
-declare const dbxAppAuthUserFeatureKey = "user";
+declare const DBX_APP_AUTH_USER_FEATURE_KEY = "user";
 /**
  * Shape of the authenticated user's state stored in the NgRx store.
  *
@@ -2850,13 +2863,21 @@ declare const dbxAppAuthUserFeatureKey = "user";
  * @see {@link AuthUserState} for possible values of `userState`.
  */
 interface DbxAppAuthStateUser {
-    /** Unique identifier for the authenticated user. Defaults to {@link NO_AUTH_USER_IDENTIFIER} when no user is logged in. */
+    /**
+     * Unique identifier for the authenticated user. Defaults to {@link NO_AUTH_USER_IDENTIFIER} when no user is logged in.
+     */
     userId: AuthUserIdentifier;
-    /** Whether the user has completed the onboarding/setup flow. */
+    /**
+     * Whether the user has completed the onboarding/setup flow.
+     */
     isOnboarded: boolean;
-    /** Current authentication lifecycle state of the user. */
+    /**
+     * Current authentication lifecycle state of the user.
+     */
     userState: AuthUserState;
-    /** Array of authorization roles assigned to the current user. */
+    /**
+     * Array of authorization roles assigned to the current user.
+     */
     userRoles: AuthRole[];
 }
 
@@ -2865,7 +2886,7 @@ interface DbxAppAuthStateUser {
  *
  * The auth state is registered under `'app.auth'` in the root NgRx state tree.
  */
-declare const featureKey = "app.auth";
+declare const FEATURE_KEY = "app.auth";
 /**
  * Shape of the auth feature state slice, containing all auth-related sub-states.
  *
@@ -2875,7 +2896,7 @@ declare const featureKey = "app.auth";
  * @see {@link DbxAppAuthStateUser} for the user sub-state shape.
  */
 interface DbxAppAuthFeatureState {
-    [dbxAppAuthUserFeatureKey]: DbxAppAuthStateUser;
+    [DBX_APP_AUTH_USER_FEATURE_KEY]: DbxAppAuthStateUser;
 }
 /**
  * Root state interface extension that declares how the auth feature integrates into the global NgRx store.
@@ -2886,7 +2907,7 @@ interface DbxAppAuthFeatureState {
  * @see {@link DbxAppAuthFullState} for the public alias of this type.
  */
 interface State {
-    [featureKey]: DbxAppAuthFeatureState;
+    [FEATURE_KEY]: DbxAppAuthFeatureState;
 }
 /**
  * Combined reducer function for the auth feature state.
@@ -2915,13 +2936,13 @@ declare const selectAppAuthFeature: _ngrx_store.MemoizedSelector<object, DbxAppA
 declare const selectDbxAppAuthUser: _ngrx_store.MemoizedSelector<object, DbxAppAuthStateUser, (s1: DbxAppAuthFeatureState) => DbxAppAuthStateUser>;
 
 type index_d$1_DbxAppAuthFeatureState = DbxAppAuthFeatureState;
+declare const index_d$1_FEATURE_KEY: typeof FEATURE_KEY;
 type index_d$1_State = State;
-declare const index_d$1_featureKey: typeof featureKey;
 declare const index_d$1_reducers: typeof reducers;
 declare const index_d$1_selectAppAuthFeature: typeof selectAppAuthFeature;
 declare const index_d$1_selectDbxAppAuthUser: typeof selectDbxAppAuthUser;
 declare namespace index_d$1 {
-  export { index_d$1_featureKey as featureKey, index_d$1_reducers as reducers, index_d$1_selectAppAuthFeature as selectAppAuthFeature, index_d$1_selectDbxAppAuthUser as selectDbxAppAuthUser };
+  export { index_d$1_FEATURE_KEY as FEATURE_KEY, index_d$1_reducers as reducers, index_d$1_selectAppAuthFeature as selectAppAuthFeature, index_d$1_selectDbxAppAuthUser as selectDbxAppAuthUser };
   export type { index_d$1_DbxAppAuthFeatureState as DbxAppAuthFeatureState, index_d$1_State as State };
 }
 
@@ -3091,7 +3112,9 @@ declare enum DbxRouterTransitionEventType {
  * @see {@link DbxRouterTransitionService}
  */
 interface DbxRouterTransitionEvent {
-    /** The type of transition event (start or success). */
+    /**
+     * The type of transition event (start or success).
+     */
     type: DbxRouterTransitionEventType;
 }
 
@@ -3219,13 +3242,21 @@ declare abstract class DbxRouterService extends DbxRouterTransitionService {
  * @see {@link provideDbxAppAuthRouter} for registering this configuration.
  */
 declare abstract class DbxAppAuthRoutes {
-    /** Route reference for the login page. Users are redirected here when authentication is required. */
+    /**
+     * Route reference for the login page. Users are redirected here when authentication is required.
+     */
     abstract readonly loginRef: SegueRefOrSegueRefRouterLink;
-    /** Optional route reference for the logged-out page. Falls back to {@link loginRef} if not provided. */
+    /**
+     * Optional route reference for the logged-out page. Falls back to {@link loginRef} if not provided.
+     */
     abstract readonly loggedOutRef?: SegueRefOrSegueRefRouterLink;
-    /** Optional route reference for the onboarding/setup page. Falls back to {@link appRef} if not provided. */
+    /**
+     * Optional route reference for the onboarding/setup page. Falls back to {@link appRef} if not provided.
+     */
     abstract readonly onboardRef?: SegueRefOrSegueRefRouterLink;
-    /** Route reference for the main application page. Users are redirected here after successful authentication. */
+    /**
+     * Route reference for the main application page. Users are redirected here after successful authentication.
+     */
     abstract readonly appRef: SegueRefOrSegueRefRouterLink;
 }
 
@@ -3260,9 +3291,13 @@ declare class DbxAppAuthRouterService implements OnDestroy {
     readonly dbxAppAuthRoutes: DbxAppAuthRoutes;
     private readonly _isAuthRouterEffectsEnabled;
     private readonly _ignoredRoutes;
-    /** Observable of whether auth router effects are currently enabled. */
+    /**
+     * Observable of whether auth router effects are currently enabled.
+     */
     readonly isAuthRouterEffectsEnabled$: Observable<boolean>;
-    /** Observable of the set of route refs that are excluded from auth redirect effects. */
+    /**
+     * Observable of the set of route refs that are excluded from auth redirect effects.
+     */
     readonly ignoredRoutes$: Observable<Set<SegueRefOrSegueRefRouterLink>>;
     /**
      * Observable that emits `true` when the current route is in the ignored set.
@@ -3281,6 +3316,8 @@ declare class DbxAppAuthRouterService implements OnDestroy {
     get hasOnboardingState(): boolean;
     /**
      * Whether or not DbxAppAuthRouterEffects are enabled.
+     *
+     * @returns Whether auth router effects are currently enabled.
      */
     get isAuthRouterEffectsEnabled(): boolean;
     set isAuthRouterEffectsEnabled(enabled: boolean);
@@ -3290,14 +3327,20 @@ declare class DbxAppAuthRouterService implements OnDestroy {
      *
      * Uses hierarchical matching — adding a parent route (e.g., `'/app/oauth'`)
      * will also ignore all child routes (e.g., `'/app/oauth/login'`).
+     *
+     * @param ref - The route ref to add to the ignored set.
      */
     addIgnoredRoute(ref: SegueRefOrSegueRefRouterLink): void;
     /**
      * Removes a route from the ignored set.
+     *
+     * @param ref - The route ref to remove from the ignored set.
      */
     removeIgnoredRoute(ref: SegueRefOrSegueRefRouterLink): void;
     /**
      * Returns `true` if the current route matches any of the ignored routes.
+     *
+     * @returns Whether the current route is in the ignored set.
      */
     get isCurrentRouteIgnoredByAuthEffects(): boolean;
     private _checkCurrentRouteIgnored;
@@ -3641,9 +3684,13 @@ declare function provideDbxAppAuthState(): EnvironmentProviders;
  * @see {@link fromDbxAppAuth.selectDbxAppAuthUser}
  */
 declare class DbxAppAuthStateService {
-    /** NgRx store instance typed to the full auth state. */
+    /**
+     * NgRx store instance typed to the full auth state.
+     */
     readonly store: Store<any>;
-    /** Observable of the current {@link DbxAppAuthStateUser} from the NgRx store. */
+    /**
+     * Observable of the current {@link DbxAppAuthStateUser} from the NgRx store.
+     */
     readonly authStateUser$: rxjs.Observable<DbxAppAuthStateUser>;
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxAppAuthStateService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<DbxAppAuthStateService>;
@@ -3760,6 +3807,7 @@ declare abstract class DbxButton {
  * Creates Angular providers that register a {@link DbxButton} implementation for DI.
  *
  * @param sourceType - The concrete button directive or component class to provide.
+ * @returns An array of Angular providers for the button.
  *
  * @example
  * ```typescript
@@ -3920,6 +3968,8 @@ declare abstract class AbstractDbxButtonDirective implements DbxButton {
     setDisplayContent(content: DbxButtonDisplay): void;
     /**
      * Sets the button interceptor. If any interceptor is already set, it is replaced.
+     *
+     * @param interceptor - The interceptor to set on the button.
      */
     setButtonInterceptor(interceptor: DbxButtonInterceptor): void;
     /**
@@ -4059,6 +4109,8 @@ declare class DbxAppEnviromentService {
     get isTesting(): boolean;
     /**
      * Returns the environment, typed as a specific type.
+     *
+     * @returns The environment cast to the specified type.
      */
     getEnvironment<T extends DbxAppEnviroment>(): T;
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxAppEnviromentService, never>;
@@ -4069,6 +4121,7 @@ declare class DbxAppEnviromentService {
  * Registers {@link DbxAppEnviroment} and {@link DbxAppEnviromentService} as environment-level providers.
  *
  * @param environment - The concrete environment configuration to provide.
+ * @returns The environment providers for the application environment.
  *
  * @example
  * ```typescript
@@ -4097,9 +4150,13 @@ type MouseEventType = 'enter' | 'leave';
  * ```
  */
 interface MouseEventPair<T> {
-    /** The type of mouse event that occurred. */
+    /**
+     * The type of mouse event that occurred.
+     */
     readonly type: MouseEventType;
-    /** Data associated with this mouse event. */
+    /**
+     * Data associated with this mouse event.
+     */
     readonly data: T;
 }
 /**
@@ -4113,7 +4170,9 @@ interface MouseEventPair<T> {
  * ```
  */
 interface MousableFunction {
-    /** Optional handler invoked on mouse enter and leave events. */
+    /**
+     * Optional handler invoked on mouse enter and leave events.
+     */
     onMouse?: (type: MouseEventType, event?: Maybe<MouseEvent>) => void;
 }
 
@@ -4128,7 +4187,9 @@ interface MousableFunction {
  * ```
  */
 interface ClickableFunction {
-    /** Optional click handler invoked when the element is clicked. */
+    /**
+     * Optional click handler invoked when the element is clicked.
+     */
     readonly onClick?: (event?: Maybe<MouseEvent>) => void;
 }
 /**
@@ -4280,16 +4341,6 @@ interface DbxInjectionTemplateConfig<T = unknown> {
      */
     readonly viewRef?: Maybe<ViewRef>;
 }
-/**
- * Merges multiple partial {@link DbxInjectionComponentConfig} objects into a single configuration.
- *
- * Provider arrays are concatenated (not overwritten) so that all providers from all configs
- * are preserved. All other properties are merged with later values taking precedence.
- *
- * @typeParam T - The component type for the configuration.
- * @param configs - An array of partial configs (may contain `undefined`/`null` entries which are filtered out).
- * @returns A single merged partial configuration.
- */
 /**
  * Compares two {@link DbxInjectionComponentConfig} values for structural equality, safely handling nullish values.
  *
@@ -4301,6 +4352,15 @@ interface DbxInjectionTemplateConfig<T = unknown> {
  * `null === undefined` is `false`). The comparator is only invoked when both are non-nullish.
  */
 declare const dbxInjectionComponentConfigIsEqual: EqualityComparatorFunction<Maybe<DbxInjectionComponentConfig<any>>>;
+/**
+ * Merges multiple partial {@link DbxInjectionComponentConfig} objects into a single configuration.
+ *
+ * Provider arrays are concatenated so that all providers from all configs are preserved.
+ * All other properties are merged with later values taking precedence.
+ *
+ * @param configs - An array of partial configs to merge. May contain `undefined`/`null` entries which are filtered out.
+ * @returns A single merged partial configuration.
+ */
 declare function mergeDbxInjectionComponentConfigs<T = unknown>(configs: Maybe<Partial<DbxInjectionComponentConfig<T>>>[]): Partial<DbxInjectionComponentConfig<T>>;
 
 /**
@@ -4324,9 +4384,13 @@ declare function mergeDbxInjectionComponentConfigs<T = unknown>(configs: Maybe<P
  * @see {@link SegueRef} for router navigation references
  */
 interface ClickableAnchor extends ClickableFunction, MousableFunction, ClickableUrl, Partial<SegueRef> {
-    /** Whether this anchor is disabled and should not be interactive. */
+    /**
+     * Whether this anchor is disabled and should not be interactive.
+     */
     readonly disabled?: boolean;
-    /** Whether this anchor is currently in a selected/active state. */
+    /**
+     * Whether this anchor is currently in a selected/active state.
+     */
     readonly selected?: boolean;
 }
 /**
@@ -4382,7 +4446,9 @@ type ClickableAnchorLinkSegueRef = ClickableAnchorLink & SegueRef;
  * @see {@link ClickableAnchorLink}
  */
 interface ClickableIconAnchorLink extends Omit<ClickableAnchorLink, 'title'> {
-    /** The icon identifier (e.g., Material icon name). */
+    /**
+     * The icon identifier (e.g., Material icon name).
+     */
     readonly icon: string;
 }
 /**
@@ -4407,7 +4473,9 @@ interface ClickableIconAnchorLink extends Omit<ClickableAnchorLink, 'title'> {
  * @see {@link expandClickableAnchorLinkTree} for flattening trees
  */
 interface ClickableAnchorLinkTree extends ClickableAnchorLink {
-    /** Optional child links forming a nested navigation tree. */
+    /**
+     * Optional child links forming a nested navigation tree.
+     */
     readonly children?: ClickableAnchorLinkTree[];
 }
 /**
@@ -4534,37 +4602,73 @@ declare function provideDbxAnchor<S extends DbxAnchor>(sourceType: Type<S>): Pro
  * @see {@link anchorTypeForAnchor} for anchor type resolution logic
  */
 declare class AbstractDbxAnchorDirective<T extends ClickableAnchor = ClickableAnchor> implements DbxAnchor {
-    /** Model input for the segue ref or router link to navigate to. */
+    /**
+     * Model input for the segue ref or router link to navigate to.
+     */
     readonly ref: i0.ModelSignal<Maybe<SegueRefOrSegueRefRouterLink>>;
-    /** Model input for the full anchor configuration object. */
+    /**
+     * Model input for the full anchor configuration object.
+     */
     readonly anchor: i0.ModelSignal<Maybe<T>>;
-    /** Model input for externally controlling the disabled state. */
+    /**
+     * Model input for externally controlling the disabled state.
+     */
     readonly disabled: i0.ModelSignal<Maybe<boolean>>;
-    /** Model input for externally controlling the selected state. */
+    /**
+     * Model input for externally controlling the selected state.
+     */
     readonly selected: i0.ModelSignal<Maybe<boolean>>;
-    /** Computed anchor that merges the `ref` input with the `anchor` input, preferring `ref` when set. */
+    /**
+     * Computed anchor that merges the `ref` input with the `anchor` input, preferring `ref` when set.
+     */
     readonly anchorSignal: i0.Signal<Maybe<T>>;
-    /** Computed selected state that combines the `selected` input with the anchor's own `selected` property. */
+    /**
+     * Computed selected state that combines the `selected` input with the anchor's own `selected` property.
+     */
     readonly selectedSignal: i0.Signal<boolean | undefined>;
-    /** Computed {@link ClickableAnchorType} derived from the current anchor and disabled state. */
+    /**
+     * Computed {@link ClickableAnchorType} derived from the current anchor and disabled state.
+     */
     readonly typeSignal: i0.Signal<ClickableAnchorType>;
-    /** Computed disabled state that combines the `disabled` input with the anchor's own `disabled` property. */
+    /**
+     * Computed disabled state that combines the `disabled` input with the anchor's own `disabled` property.
+     */
     readonly disabledSignal: i0.Signal<boolean | undefined>;
-    /** Computed URL extracted from the current anchor's `url` property. */
+    /**
+     * Computed URL extracted from the current anchor's `url` property.
+     */
     readonly urlSignal: i0.Signal<string | undefined>;
-    /** Computed target (e.g., `_blank`) extracted from the current anchor's `target` property. */
+    /**
+     * Computed target (e.g., `_blank`) extracted from the current anchor's `target` property.
+     */
     readonly targetSignal: i0.Signal<string | undefined>;
     readonly anchor$: Observable<Maybe<T>>;
     readonly disabled$: Observable<Maybe<boolean>>;
     readonly selected$: Observable<Maybe<boolean>>;
     readonly type$: Observable<ClickableAnchorType>;
-    /** Sets the segue ref or router link for this anchor. */
+    /**
+     * Sets the segue ref or router link for this anchor.
+     *
+     * @param ref - The segue ref or router link to set.
+     */
     setRef(ref: Maybe<SegueRefOrSegueRefRouterLink>): void;
-    /** Sets the full anchor configuration object. */
+    /**
+     * Sets the full anchor configuration object.
+     *
+     * @param anchor - The anchor configuration to set.
+     */
     setAnchor(anchor: Maybe<T>): void;
-    /** Sets the external disabled state override. */
+    /**
+     * Sets the external disabled state override.
+     *
+     * @param disabled - Whether the anchor should be disabled.
+     */
     setDisabled(disabled: Maybe<boolean>): void;
-    /** Sets the external selected state override. */
+    /**
+     * Sets the external selected state override.
+     *
+     * @param selected - Whether the anchor should be selected.
+     */
     setSelected(selected: Maybe<boolean>): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AbstractDbxAnchorDirective<any>, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<AbstractDbxAnchorDirective<any>, never, never, { "ref": { "alias": "ref"; "required": false; "isSignal": true; }; "anchor": { "alias": "anchor"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; }, { "ref": "refChange"; "anchor": "anchorChange"; "disabled": "disabledChange"; "selected": "selectedChange"; }, never, never, true, never>;
@@ -4709,6 +4813,7 @@ interface RedirectForUserIdentifierParamHookInput {
  * missing or matches the placeholder value.
  *
  * @param input - Configuration specifying the route criteria, access control logic, and optional parameter overrides.
+ * @returns The result of registering the transition hook.
  *
  * @see {@link RedirectForUserIdentifierParamHookInput}
  * @see {@link redirectForIdentifierParamHook}
@@ -4742,9 +4847,9 @@ declare class DbxAngularRouterService implements DbxRouterService, DbxRouterTran
     readonly transitions$: Observable<DbxRouterTransitionEvent>;
     go(input: ObservableOrValue<SegueRefOrSegueRefRouterLink<NavigationExtras | NavigationBehaviorOptions>>): Promise<boolean>;
     updateParams(inputParams: ObservableOrValue<SegueRefRawSegueParams>): Promise<boolean>;
-    isActive(segueRef: SegueRefOrSegueRefRouterLink): boolean;
-    isActiveExactly(segueRef: SegueRefOrSegueRefRouterLink): boolean;
-    comparePrecision(a: SegueRefOrSegueRefRouterLink, b: SegueRefOrSegueRefRouterLink): number;
+    isActive(_segueRef: SegueRefOrSegueRefRouterLink): boolean;
+    isActiveExactly(_segueRef: SegueRefOrSegueRefRouterLink): boolean;
+    comparePrecision(_a: SegueRefOrSegueRefRouterLink, _b: SegueRefOrSegueRefRouterLink): number;
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxAngularRouterService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<DbxAngularRouterService>;
 }
@@ -4961,9 +5066,13 @@ declare function isLatestSuccessfulRoute(config: IsLatestSuccessfulRouteConfig):
  */
 declare abstract class AbstractTransitionDirective {
     protected readonly dbxRouterTransitionService: DbxRouterTransitionService;
-    /** Observable that emits on each successful router transition. */
+    /**
+     * Observable that emits on each successful router transition.
+     */
     readonly transitionSuccess$: Observable<_dereekb_dbx_core.DbxRouterTransitionEvent>;
-    /** Observable that emits immediately on initialization and on each subsequent successful transition. */
+    /**
+     * Observable that emits immediately on initialization and on each subsequent successful transition.
+     */
     readonly initAndUpdateOnTransitionSuccess$: Observable<void>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AbstractTransitionDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<AbstractTransitionDirective, never, never, {}, {}, never, never, true, never>;
@@ -5057,8 +5166,8 @@ declare function onRouterTransitionSuccessEvent(events$: Observable<DbxRouterTra
 /**
  * Creates an observable that returns true when the route for the input segueRef is active.
  *
- * @param dbxRouterService
- * @param segueRef
+ * @param config - Configuration specifying the router service, segue ref, and matching options.
+ * @returns An observable that emits `true` when the segue ref's route is active.
  */
 declare function isSegueRefActiveOnTransitionSuccess(config: IsSegueRefActiveFunctionConfig): Observable<boolean>;
 /**
@@ -5075,8 +5184,8 @@ interface IsSegueRefActiveConfig extends Pick<IsSegueRefActiveFunctionConfig, 'd
 /**
  * Operator function that maps the input segueRef to a boolean depending on the current route state.
  *
- * @param dbxRouterService
- * @param segueRef
+ * @param config - Configuration specifying the router service and default behavior for null refs.
+ * @returns An RxJS operator that maps a segue ref to whether it is currently active.
  */
 declare function isSegueRefActive(config: IsSegueRefActiveConfig): OperatorFunction<Maybe<SegueRefOrSegueRefRouterLink>, boolean>;
 
@@ -6034,6 +6143,7 @@ type ProvideFilterSourceDirectiveDefaultFilterFactoryFunction<F = unknown> = (in
  *
  * @param sourceType - The concrete directive class.
  * @param defaultFilterFactory - Optional factory to provide an initial filter value via DI.
+ * @returns An array of Angular providers for the filter source directive.
  *
  * @example
  * ```typescript
@@ -6109,6 +6219,7 @@ declare class DbxFilterSourceConnectorDirective<F = unknown> extends AbstractFil
  * Creates Angular providers that register a {@link FilterSource} implementation for DI.
  *
  * @param sourceType - The concrete filter source class to provide.
+ * @returns An array of Angular providers for the filter source.
  *
  * @example
  * ```typescript
@@ -6124,6 +6235,7 @@ declare function provideFilterSource<S extends FilterSource>(sourceType: Type<S>
  * Creates Angular providers that register both a {@link FilterSourceConnector} and {@link FilterSource} for DI.
  *
  * @param sourceType - The concrete connector class to provide.
+ * @returns An array of Angular providers for the filter source connector.
  */
 declare function provideFilterSourceConnector<S extends FilterSourceConnector>(sourceType: Type<S>): Provider[];
 
@@ -6247,6 +6359,9 @@ interface ClickableFilterPreset<F extends FilterWithPreset<P>, P extends string
 }
 /**
  * Type guard that checks if an object is a {@link ClickableFilterPreset}.
+ *
+ * @param preset - The object to check.
+ * @returns `true` if the object has a `presetValue` property.
  */
 declare function isClickableFilterPreset<F extends FilterWithPreset<P>, P extends string = string>(preset: object): preset is ClickableFilterPreset<F, P>;
 /**
@@ -6271,6 +6386,9 @@ interface ClickablePartialFilterPreset<F> extends Pick<ClickableAnchorLink, 'tit
 }
 /**
  * Type guard that checks if an object is a {@link ClickablePartialFilterPreset}.
+ *
+ * @param preset - The object to check.
+ * @returns `true` if the object has `partialPresetValue` and `isActive` properties.
  */
 declare function isClickablePartialFilterPreset<F>(preset: object): preset is ClickablePartialFilterPreset<F>;
 /**
@@ -6574,10 +6692,15 @@ declare class DbxInjectionContextDirective<O = unknown> implements DbxInjectionC
     ngOnDestroy(): void;
     /**
      * {@inheritDoc DbxInjectionContext.showContext}
+     *
+     * @param config - The injection context configuration describing the component and its usage.
+     * @returns A promise that resolves with the output of the injected component's usage.
      */
     showContext<T, O>(config: DbxInjectionContextConfig<T>): Promise<O>;
     /**
      * {@inheritDoc DbxInjectionContext.resetContext}
+     *
+     * @returns `true` if an active context was cleared, `false` otherwise.
      */
     resetContext(): boolean;
     /**
@@ -6617,10 +6740,15 @@ declare abstract class AbstractForwardDbxInjectionContextDirective implements Db
     readonly dbxInjectionContext: DbxInjectionContext;
     /**
      * {@inheritDoc DbxInjectionContext.showContext}
+     *
+     * @param config - The injection context configuration to forward to the host context.
+     * @returns A promise that resolves with the output of the injected component's usage.
      */
     showContext<T = unknown, O = unknown>(config: DbxInjectionContextConfig<T, unknown>): Promise<O>;
     /**
      * {@inheritDoc DbxInjectionContext.resetContext}
+     *
+     * @returns `true` if an active context was cleared, `false` otherwise.
      */
     resetContext(): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<AbstractForwardDbxInjectionContextDirective, never>;
@@ -6933,11 +7061,17 @@ interface ConfiguredSimpleStorageAccessorConfig extends SimpleStorageAccessorCon
 /**
  * Validates that a storage key prefix is non-empty and does not contain the prefix splitter character.
  *
+ * @param prefix - The prefix string to validate.
+ * @param prefixSplitter - The splitter string that separates the prefix from the key.
  * @throws {Error} If the prefix is invalid or the splitter is empty.
  */
 declare function assertValidStorageKeyPrefix(prefix: string, prefixSplitter: string): void;
 /**
  * Checks whether a storage key prefix is valid (non-empty and does not contain the splitter).
+ *
+ * @param prefix - The prefix string to validate.
+ * @param prefixSpltter - The splitter string that separates the prefix from the key.
+ * @returns `true` if the prefix is valid.
  */
 declare function isValidStorageKeyPrefix(prefix: string, prefixSpltter: string): boolean;
 /**
@@ -7103,6 +7237,8 @@ declare class MemoryStorageObject extends FullLocalStorageObject {
  * Creates the default {@link FullStorageObject}, preferring `localStorage` and
  * falling back to an in-memory store if `localStorage` is unavailable.
  *
+ * @returns A FullStorageObject backed by localStorage or an in-memory fallback.
+ *
  * @example
  * ```typescript
  * const storage = defaultStorageObjectFactory();
@@ -7115,6 +7251,8 @@ declare function defaultStorageObjectFactory(): FullStorageObject;
  *
  * Call in your application config to enable storage-based services throughout the app.
  *
+ * @returns The environment providers for storage services.
+ *
  * @example
  * ```typescript
  * export const appConfig: ApplicationConfig = {
@@ -7138,6 +7276,9 @@ declare function provideDbxStorage(): EnvironmentProviders;
  * @example
  * // Clean up a destroy function directly:
  * clean(() => resource.release());
+ *
+ * @param input - The Destroyable object or destroy function to register for cleanup.
+ * @returns The same input, for chaining.
  */
 declare function clean<T extends Destroyable | DestroyFunction>(input: T): T;
 /**
@@ -7153,8 +7294,11 @@ declare function clean<T extends Destroyable | DestroyFunction>(input: T): T;
  * @example
  * // Complete a ReplaySubject when the component is destroyed:
  * readonly events$ = completeOnDestroy(new ReplaySubject<Event>(1));
+ *
+ * @param input - The Subject to register for completion on destroy.
+ * @returns The same input, for chaining.
  */
-declare function completeOnDestroy<T extends Pick<Subject<any>, 'complete' | 'error'>>(input: T): T;
+declare function completeOnDestroy<T extends Pick<Subject<unknown>, 'complete' | 'error'>>(input: T): T;
 
 /**
  * Configuration for {@link cleanLockSet}, controlling destruction timing and lifecycle callbacks.
@@ -7185,7 +7329,8 @@ type CleanLockSet = LockSet & {
  *
  * Must be run within an Angular injection context.
  *
- * @param config Optional configuration for destruction behavior and callbacks.
+ * @param config - Optional configuration for destruction behavior and callbacks.
+ * @returns A CleanLockSet that is automatically destroyed when the context is destroyed.
  *
  * @example
  * // Create a simple lockset:
@@ -7236,6 +7381,9 @@ interface CleanSubscriptionWithLockSetConfig<T extends Unsubscribable = Unsubscr
  * // Create first, then set the subscription later:
  * readonly _sub = cleanSubscriptionWithLockSet({ lockSet: this.lockSet });
  * this._sub.subscription = obs$.subscribe(handler);
+ *
+ * @param input - Configuration specifying the lock set and optional initial subscription.
+ * @returns A SubscriptionObject that is destroyed when the context is destroyed and the lock set unlocks.
  */
 declare function cleanSubscriptionWithLockSet<T extends Unsubscribable = Unsubscribable>(input: CleanSubscriptionWithLockSetConfig<T>): SubscriptionObject<T>;
 
@@ -7251,6 +7399,9 @@ declare function cleanSubscriptionWithLockSet<T extends Unsubscribable = Unsubsc
  * // Or create first, then set the subscription later:
  * readonly _sub = cleanSubscription();
  * this._sub.subscription = obs$.subscribe(handler);
+ *
+ * @param sub - Optional subscription or getter to wrap.
+ * @returns A SubscriptionObject that is automatically destroyed when the context is destroyed.
  */
 declare function cleanSubscription<T extends Unsubscribable = Unsubscribable>(sub?: Maybe<GetterOrValue<T>>): SubscriptionObject<T>;
 
@@ -7267,6 +7418,9 @@ declare function cleanSubscription<T extends Unsubscribable = Unsubscribable>(su
  * // Create empty, then set the observable source later:
  * readonly context = cleanLoadingContext<MyData>();
  * this.context.obs = this.data$;
+ *
+ * @param input - Optional loading state context input configuration.
+ * @returns A mutable loading state context that is automatically destroyed on cleanup.
  */
 declare function cleanLoadingContext<T = unknown, S extends LoadingState<T> = LoadingState<T>, E extends LoadingContextEvent = LoadingContextEvent & S>(input?: LoadingStateContextInput<T, S, E>): MutableLoadingStateContext<T, S, E>;
 /**
@@ -7282,6 +7436,9 @@ declare function cleanLoadingContext<T = unknown, S extends LoadingState<T> = Lo
  * // Create empty, then set the observable source later:
  * readonly listContext = cleanListLoadingContext<MyItem>();
  * this.listContext.obs = this.items$;
+ *
+ * @param input - Optional list loading state context input configuration.
+ * @returns A mutable list loading state context that is automatically destroyed on cleanup.
  */
 declare function cleanListLoadingContext<L = unknown, S extends ListLoadingState<L> = ListLoadingState<L>>(input?: ListLoadingStateContextInput<L, S>): MutableListLoadingStateContext<L, S>;
 
@@ -7298,6 +7455,9 @@ declare function cleanListLoadingContext<L = unknown, S extends ListLoadingState
  * // Create first, then set the destroy function later:
  * readonly _destroy = cleanDestroy();
  * this._destroy.setDestroyFunction(() => resource.release());
+ *
+ * @param input - Optional destroy function to wrap.
+ * @returns A DestroyFunctionObject that will be automatically destroyed when the context is destroyed.
  */
 declare function cleanDestroy(input?: Maybe<DestroyFunction>): DestroyFunctionObject;
 
@@ -7310,6 +7470,7 @@ declare function cleanDestroy(input?: Maybe<DestroyFunction>): DestroyFunctionOb
  *
  * @param cdRef - The change detector to trigger. If `null`/`undefined`, the operator is a no-op.
  * @param timeout - Delay in milliseconds before calling `detectChanges`.
+ * @returns An RxJS operator that triggers change detection on each emission.
  *
  * @example
  * ```typescript
@@ -7335,6 +7496,7 @@ declare function safeDetectChanges(cdRef: ChangeDetectorRef): void;
  *
  * @param cdRef - The change detector to mark. If `null`/`undefined`, the operator is a no-op.
  * @param timeout - Delay in milliseconds before calling `markForCheck`.
+ * @returns An RxJS operator that marks the view for check on each emission.
  *
  * @example
  * ```typescript
@@ -7366,6 +7528,7 @@ declare function safeUseCdRef(cdRef: ChangeDetectorRef, use: (cdRef: ChangeDetec
  * Useful for conditionally showing fallback content when no projection is provided.
  *
  * @param ref - Reference to the wrapper element around `ng-content`.
+ * @returns `true` if the wrapper element has any child nodes.
  *
  * @example
  * ```typescript
@@ -7394,6 +7557,9 @@ declare function checkNgContentWrapperHasContent(ref: Maybe<ElementRef<Element>>
  * Useful for Angular directive inputs where the attribute can be applied without a value
  * (e.g., `<div myDirective>` passes `''`), and you want to treat that as "not provided".
  *
+ * @param value - The input value to transform.
+ * @returns The original value, or `undefined` if the value is an empty string.
+ *
  * @example
  * ```typescript
  * @Directive({ selector: '[appHighlight]' })