@dereekb/dbx-web 13.7.0 → 13.8.0

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@dereekb/dbx-web",
-  "version": "13.7.0",
+  "version": "13.8.0",
   "peerDependencies": {
-    "@angular/cdk": "21.2.3",
-    "@angular/common": "21.2.3",
-    "@angular/core": "21.2.3",
-    "@angular/forms": "21.2.3",
-    "@angular/material": "21.2.3",
-    "@angular/platform-browser": "21.2.3",
-    "@dereekb/browser": "13.7.0",
-    "@dereekb/date": "13.7.0",
-    "@dereekb/dbx-core": "13.7.0",
-    "@dereekb/rxjs": "13.7.0",
-    "@dereekb/util": "13.7.0",
-    "@dereekb/vitest": "13.7.0",
+    "@angular/cdk": "^21.2.3",
+    "@angular/common": "21.2.4",
+    "@angular/core": "21.2.4",
+    "@angular/forms": "21.2.4",
+    "@angular/material": "^21.2.3",
+    "@angular/platform-browser": "21.2.4",
+    "@dereekb/browser": "13.8.0",
+    "@dereekb/date": "13.8.0",
+    "@dereekb/dbx-core": "13.8.0",
+    "@dereekb/rxjs": "13.8.0",
+    "@dereekb/util": "13.8.0",
+    "@dereekb/vitest": "13.8.0",
     "@ngbracket/ngx-layout": "^21.0.0",
     "@ngrx/component-store": "^21.0.0",
     "@ngrx/effects": "^21.0.0",

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

@@ -4,7 +4,7 @@ import * as _angular_core from '@angular/core';
 import { Signal, ElementRef, AfterViewInit, InjectionToken, Type, OnInit, OnDestroy, ViewContainerRef, Provider, Injector, TrackByFunction, OutputEmitterRef, OutputRef, EnvironmentProviders, TemplateRef, ComponentRef } from '@angular/core';
 import { ProgressBarMode } from '@angular/material/progress-bar';
 import * as _dereekb_util from '@dereekb/util';
-import { Maybe, ErrorInput, Milliseconds, GetterOrValue, Getter, CharacterPrefixSuffixCleanString, DashPrefixString, CssClass, CssToken, CssTokenVar, WebsiteUrlWithPrefix, WebsitePath, Pixels, PixelsString, DecisionFunction, ModifierMap, ArrayOrValue, Modifier, ModifierFunction, UniqueModel, CssClassesArray, PrimativeKey, SortCompareFunction, ModelKeyRef, Destroyable, UnitedStatesAddressWithContact, LabeledValue, GetterOrValueWithInput, Seconds, DestroyFunction, ReadableError, ReadableErrorWithCode, ServerError, ServerErrorResponseData, ServerErrorResponse, PromiseOrValue, SpaceSeparatedCssClasses, StringErrorCode, ModelKeyTypeNamePair, UnixDateTimeSecondsNumber, ModelKey, ModelTypeString, ContentTypeMimeType, MimeTypeWithoutParameters, ModelTypeDataPair, MapFunction, SlashPathDirectoryTreeNode, SlashPathDirectoryTreeNodeValue, SlashPathDirectoryTreeRoot, MimeTypeWildcard, MimeTypeWithSubtypeWildcardWithoutParameters, SlashPathTypedFileSuffix } from '@dereekb/util';
+import { Maybe, ErrorInput, Milliseconds, GetterOrValue, Getter, CharacterPrefixSuffixCleanString, DashPrefixString, CssClass, CssToken, CssTokenVar, WebsiteUrlWithPrefix, WebsitePath, Pixels, PixelsString, DecisionFunction, ModifierMap, ArrayOrValue, Modifier, ModifierFunction, UniqueModel, CssClassesArray, PrimativeKey, SortCompareFunction, ModelKeyRef, HtmlHeaderLevel, Destroyable, UnitedStatesAddressWithContact, LabeledValue, GetterOrValueWithInput, Seconds, DestroyFunction, ReadableError, ReadableErrorWithCode, ServerError, ServerErrorResponseData, ServerErrorResponse, PromiseOrValue, SpaceSeparatedCssClasses, StringErrorCode, ModelKeyTypeNamePair, UnixDateTimeSecondsNumber, ModelKey, ModelTypeString, ContentTypeMimeType, MimeTypeWithoutParameters, ModelTypeDataPair, MapFunction, SlashPathDirectoryTreeNode, SlashPathDirectoryTreeNodeValue, SlashPathDirectoryTreeRoot, MimeTypeWildcard, MimeTypeWithSubtypeWildcardWithoutParameters, SlashPathTypedFileSuffix } from '@dereekb/util';
 import { ProgressSpinnerMode } from '@angular/material/progress-spinner';
 import * as dist_packages_dbx_core_types_dereekb_dbx_core from 'dist/packages/dbx-core/types/dereekb-dbx-core';
 import * as rxjs from 'rxjs';
@@ -3693,7 +3693,7 @@ declare abstract class AbstractDbxValueListViewItemComponent<T, I extends DbxVal
 /**
  * Heading level for a section header, corresponding to HTML heading elements h1 through h5.
  */
-type DbxSectionHeaderHType = 1 | 2 | 3 | 4 | 5;
+type DbxSectionHeaderHType = Exclude<HtmlHeaderLevel, 6>;
 /**
  * Configuration object for a section header's display properties, including
  * heading level, text, icon, hint text, and padding options.
@@ -8262,6 +8262,7 @@ declare abstract class DbxDetachController<I = unknown> {
  * Creates Angular providers that register a {@link DbxDetachController} implementation for DI.
  *
  * @param sourceType - The concrete class to provide as the controller.
+ * @returns An array of Angular providers that bind the source type to {@link DbxDetachController}.
  *
  * @example
  * ```typescript
@@ -8438,14 +8439,23 @@ declare class DbxDetachService {
     private readonly _entries$;
     /**
      * Initializes a detached component for the given key. Returns the existing instance if one already exists.
+     *
+     * @param config - The detach configuration including component class, key, and overlay settings.
+     * @returns The new or existing {@link DbxDetachInstance} for the given key.
      */
     init<T>(config: DbxDetachConfig<T>): DbxDetachInstance<T>;
     /**
      * Gets the instance for the given key, if it exists.
+     *
+     * @param key - The detach key to look up. Defaults to {@link DBX_DETACH_DEFAULT_KEY}.
+     * @returns The instance if found, otherwise `undefined`.
      */
     get<T = unknown>(key?: DbxDetachKey): Maybe<DbxDetachInstance<T>>;
     /**
      * Observable of whether an entry exists for the given key.
+     *
+     * @param key - The detach key to observe. Defaults to {@link DBX_DETACH_DEFAULT_KEY}.
+     * @returns An observable that emits `true` when an entry exists for the key.
      */
     has$(key?: DbxDetachKey): Observable<boolean>;
     /**
@@ -8453,33 +8463,43 @@ declare class DbxDetachService {
      *
      * If no outlet element is provided, falls back to the last known outlet
      * (for reattaching from the overlay to the previous location).
+     *
+     * @param key - The detach key identifying the entry.
+     * @param outletElement - The DOM element to move the component into. Falls back to the last known outlet.
      */
     attachToOutlet(key: DbxDetachKey, outletElement?: Element): void;
     /**
      * Moves the component to the floating overlay.
+     *
+     * @param key - The detach key identifying the entry.
      */
     detachToOverlay(key: DbxDetachKey): void;
     /**
      * Moves the component to the floating overlay in minimized state.
+     *
+     * @param key - The detach key identifying the entry.
      */
     minimizeToOverlay(key: DbxDetachKey): void;
     /**
      * Called when an outlet is destroyed.
      *
+     * @param key - The detach key identifying the entry.
+     * @param outletElement - The outlet element being destroyed.
      * @param detachToOverlay - When true, the component moves to the floating overlay.
      *   When false, the component's DOM is removed but it stays alive in the service (hidden).
      */
     outletDestroyed(key: DbxDetachKey, outletElement: Element, detachToOverlay: boolean): void;
-    /**
-     * Destroys the component and removes it from the service.
-     */
     /**
      * If the last outlet is still in the DOM, reattaches the component there.
      * Otherwise destroys the component.
+     *
+     * @param key - The detach key identifying the entry.
      */
     closeOrReattach(key: DbxDetachKey): void;
     /**
      * Destroys the component and removes it from the service.
+     *
+     * @param key - The detach key identifying the entry to remove.
      */
     remove(key: DbxDetachKey): void;
     private _openOverlay;