@dereekb/dbx-web 13.2.2 → 13.3.0

package/fesm2022/dereekb-dbx-web.mjs

@@ -4016,9 +4016,11 @@ class DbxPromptConfirmComponent {
     static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.2.0", type: DbxPromptConfirmComponent, isStandalone: true, selector: "dbx-prompt-confirm", inputs: { config: { classPropertyName: "config", publicName: "config", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { confirm: "confirm", cancel: "cancel" }, ngImport: i0, template: `
     <dbx-prompt [header]="config()?.title" [prompt]="config()?.prompt">
       <ng-content></ng-content>
-      <button mat-stroked-button (click)="onConfirm()">{{ confirmTextSignal() }}</button>
-      <dbx-button-spacer></dbx-button-spacer>
-      <button mat-stroked-button color="warn" (click)="onCancel()">{{ cancelTextSignal() }}</button>
+      <div class="dbx-pt3">
+        <button mat-stroked-button (click)="onConfirm()">{{ confirmTextSignal() }}</button>
+        <dbx-button-spacer></dbx-button-spacer>
+        <button mat-stroked-button color="warn" (click)="onCancel()">{{ cancelTextSignal() }}</button>
+      </div>
     </dbx-prompt>
   `, isInline: true, dependencies: [{ kind: "component", type: DbxPromptComponent, selector: "dbx-prompt", inputs: ["header", "prompt"] }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i1$1.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "directive", type: DbxButtonSpacerDirective, selector: "dbx-button-spacer,[dbxButtonSpacer]" }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
@@ -4029,9 +4031,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
                     template: `
     <dbx-prompt [header]="config()?.title" [prompt]="config()?.prompt">
       <ng-content></ng-content>
-      <button mat-stroked-button (click)="onConfirm()">{{ confirmTextSignal() }}</button>
-      <dbx-button-spacer></dbx-button-spacer>
-      <button mat-stroked-button color="warn" (click)="onCancel()">{{ cancelTextSignal() }}</button>
+      <div class="dbx-pt3">
+        <button mat-stroked-button (click)="onConfirm()">{{ confirmTextSignal() }}</button>
+        <dbx-button-spacer></dbx-button-spacer>
+        <button mat-stroked-button color="warn" (click)="onCancel()">{{ cancelTextSignal() }}</button>
+      </div>
     </dbx-prompt>
   `,
                     standalone: true,
@@ -5394,15 +5398,17 @@ class DbxLoadingProgressComponent {
     diameterSignal = computed(() => this.diameter() || this.defaultDiameter, ...(ngDevMode ? [{ debugName: "diameterSignal" }] : []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxLoadingProgressComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
     static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.0", type: DbxLoadingProgressComponent, isStandalone: true, selector: "dbx-loading-progress", inputs: { diameter: { classPropertyName: "diameter", publicName: "diameter", isSignal: true, isRequired: false, transformFunction: null }, text: { classPropertyName: "text", publicName: "text", isSignal: true, isRequired: false, transformFunction: null }, linear: { classPropertyName: "linear", publicName: "linear", isSignal: true, isRequired: false, transformFunction: null }, mode: { classPropertyName: "mode", publicName: "mode", isSignal: true, isRequired: false, transformFunction: null }, color: { classPropertyName: "color", publicName: "color", isSignal: true, isRequired: false, transformFunction: null }, value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, bufferValue: { classPropertyName: "bufferValue", publicName: "bufferValue", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: `
-    <div [dbxColor]="color()" class="loading-progress-view">
-      @switch (linear()) {
-        @case (true) {
-          <mat-progress-bar [mode]="bmode()" [bufferValue]="bufferValue()" [value]="value()" style="margin: auto;"></mat-progress-bar>
-        }
-        @default {
-          <mat-progress-spinner [diameter]="diameterSignal()" [mode]="smode()" [value]="value()" style="margin: auto;"></mat-progress-spinner>
+    <div class="loading-progress-view">
+      <span class="loading-progress-view-indicator" [dbxColor]="color()">
+        @switch (linear()) {
+          @case (true) {
+            <mat-progress-bar [mode]="bmode()" [bufferValue]="bufferValue()" [value]="value()" style="margin: auto;"></mat-progress-bar>
+          }
+          @default {
+            <mat-progress-spinner [diameter]="diameterSignal()" [mode]="smode()" [value]="value()" style="margin: auto;"></mat-progress-spinner>
+          }
         }
-      }
+      </span>
       @if (text()) {
         <div class="dbx-loading-progress-hint dbx-hint dbx-small" [ngClass]="{ 'text-center': !linear() }">{{ text() }}</div>
       }
@@ -5414,15 +5420,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
             args: [{
                     selector: 'dbx-loading-progress',
                     template: `
-    <div [dbxColor]="color()" class="loading-progress-view">
-      @switch (linear()) {
-        @case (true) {
-          <mat-progress-bar [mode]="bmode()" [bufferValue]="bufferValue()" [value]="value()" style="margin: auto;"></mat-progress-bar>
-        }
-        @default {
-          <mat-progress-spinner [diameter]="diameterSignal()" [mode]="smode()" [value]="value()" style="margin: auto;"></mat-progress-spinner>
+    <div class="loading-progress-view">
+      <span class="loading-progress-view-indicator" [dbxColor]="color()">
+        @switch (linear()) {
+          @case (true) {
+            <mat-progress-bar [mode]="bmode()" [bufferValue]="bufferValue()" [value]="value()" style="margin: auto;"></mat-progress-bar>
+          }
+          @default {
+            <mat-progress-spinner [diameter]="diameterSignal()" [mode]="smode()" [value]="value()" style="margin: auto;"></mat-progress-spinner>
+          }
         }
-      }
+      </span>
       @if (text()) {
         <div class="dbx-loading-progress-hint dbx-hint dbx-small" [ngClass]="{ 'text-center': !linear() }">{{ text() }}</div>
       }
@@ -6822,10 +6830,19 @@ var index$1 = /*#__PURE__*/Object.freeze({
     DbxModelStateModelActions: model_actions
 });
 
+/**
+ * NgRx feature key for the model module configuration state slice.
+ */
 const stateFeatureKey = 'model.module.config';
+/**
+ * Initial state for the model module configuration reducer.
+ */
 const initialState = {
     types: {}
 };
+/**
+ * NgRx reducer for model module configuration. Resets to initial state on {@link DbxModelStateActions.dbxModelResetState}.
+ */
 const reducer = createReducer(initialState, on(dbxModelResetState, () => initialState));
 
 const featureKey = 'app.model';
@@ -6866,6 +6883,12 @@ class DbxModelViewTrackerStorage {
     get maxEventsToKeep() {
         return DbxModelViewTrackerStorage.DEFAULT_MAX_EVENTS;
     }
+    /**
+     * Persists a view tracker event to storage. Deduplicates by model key, sorts by date, and trims to the max event limit.
+     *
+     * @param event - The event to record
+     * @returns Observable that completes when the event has been persisted
+     */
     addTrackerEvent(event) {
         const storageKey = this.getStorageKeyForFolder(event.folder);
         return this._getEventSetForStorageKey(storageKey).pipe(mergeMap((set) => {
@@ -6885,9 +6908,19 @@ class DbxModelViewTrackerStorage {
                 .pipe(tap(() => this._newEvent.next(nextEvent)));
         }));
     }
+    /**
+     * Returns all stored view events for the given folder.
+     *
+     * @param folder - Optional folder name; defaults to `'default'`
+     */
     getAllEvents(folder) {
         return this.getEventSet(folder).pipe(map((x) => x.e));
     }
+    /**
+     * Returns the complete event set for the given folder.
+     *
+     * @param folder - Optional folder name; defaults to `'default'`
+     */
     getEventSet(folder) {
         const storageKey = this.getStorageKeyForFolder(folder);
         return this._getEventSetForStorageKey(storageKey);
@@ -6897,6 +6930,11 @@ class DbxModelViewTrackerStorage {
             return of(undefined);
         }), map((result) => result ?? { e: [], l: 0 }));
     }
+    /**
+     * Computes the storage key for a given folder name.
+     *
+     * @param folder - Optional folder name; defaults to `'default'`
+     */
     getStorageKeyForFolder(folder) {
         const storageKey = `${this.storageKey}_${folder ?? 'default'}`;
         return storageKey;
@@ -6914,7 +6952,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
 class DbxModelTrackerService {
     _viewTrackerStorage = inject(DbxModelViewTrackerStorage);
     _defaultFolder;
+    /**
+     * Emits whenever a new view tracker event is recorded.
+     */
     newEvent$ = this._viewTrackerStorage.newEvent$;
+    /**
+     * The default storage folder used when no folder is specified in tracking calls.
+     */
     get defaultFolder() {
         return this._defaultFolder;
     }
@@ -6922,6 +6966,13 @@ class DbxModelTrackerService {
         this._defaultFolder = folder ?? undefined;
     }
     // MARK: View
+    /**
+     * Records a view event for the given model, optionally in a specific context and folder.
+     *
+     * @param modelKeyTypeNamePair - The model identity to track
+     * @param context - Optional view context metadata
+     * @param folder - Storage folder; defaults to {@link defaultFolder}
+     */
     trackViewedObject(modelKeyTypeNamePair, context, folder = this._defaultFolder) {
         this._viewTrackerStorage
             .addTrackerEvent({
@@ -6932,9 +6983,19 @@ class DbxModelTrackerService {
             .pipe(first())
             .subscribe();
     }
+    /**
+     * Returns all recorded view events for the given folder, sorted by most recent first.
+     *
+     * @param folder - Storage folder; defaults to {@link defaultFolder}
+     */
     getAllViewEvents(folder = this._defaultFolder) {
         return this._viewTrackerStorage.getAllEvents(folder);
     }
+    /**
+     * Returns the complete event set (events and last-update timestamp) for the given folder.
+     *
+     * @param folder - Storage folder; defaults to {@link defaultFolder}
+     */
     getViewEventSet(folder = this._defaultFolder) {
         return this._viewTrackerStorage.getEventSet(folder);
     }
@@ -7056,6 +7117,11 @@ class DbxModelTypesService {
     injector = inject(Injector);
     _configs = new BehaviorSubject({});
     // MARK: Configuration
+    /**
+     * Registers one or more model type configurations. Merges with any previously registered configs.
+     *
+     * @param configs - Single or array of model type configurations to register
+     */
     addTypeConfigs(configs) {
         const types = {
             ...this._configs.value
@@ -7065,6 +7131,11 @@ class DbxModelTypesService {
         });
         this._configs.next(types);
     }
+    /**
+     * Registers model type configurations from a map, merging with existing configs.
+     *
+     * @param configs - Map of model type strings to their configurations
+     */
     addTypeConfigsMap(configs) {
         const newConfig = {
             ...this._configs.value,
@@ -7073,6 +7144,9 @@ class DbxModelTypesService {
         this._configs.next(newConfig);
     }
     // MARK: Accessors
+    /**
+     * Observable map of all registered model types to their resolved {@link DbxModelTypeInfo} entries.
+     */
     typesMap$ = this._configs.pipe(map((types) => {
         const typesMap = {};
         Object.keys(types).forEach((type) => {
@@ -7091,6 +7165,9 @@ class DbxModelTypesService {
         });
         return typesMap;
     }), shareReplay(1));
+    /**
+     * Observable map of model type strings to their Material icon names.
+     */
     iconMap$ = this.typesMap$.pipe(map((types) => {
         const iconsMap = {};
         Object.keys(types).forEach((type) => {
@@ -7098,6 +7175,11 @@ class DbxModelTypesService {
         });
         return iconsMap;
     }), shareReplay(1));
+    /**
+     * Returns an observable of the Material icon name for the given model type.
+     *
+     * @param type - The model type string to look up
+     */
     iconForType(type) {
         return this.iconMap$.pipe(map((x) => x[type]));
     }
@@ -7542,24 +7624,51 @@ class DbxWebFilePreviewService {
     _defaultPreviewComponentFunction = DBX_WEB_FILE_PREVIEW_SERVICE_DEFAULT_PREVIEW_COMPONENT_FUNCTION;
     _defaultPreviewDialogWithComponentFunction = DBX_WEB_FILE_PREVIEW_SERVICE_DEFAULT_DIALOG_WITH_COMPONENT_FUNCTION;
     // Configuration
+    /**
+     * Registers one or more file preview entries, mapping MIME types to their preview components.
+     *
+     * @param entries - Single or array of preview entries to register
+     */
     registerPreviewEntries(entries) {
         asArray(entries).forEach((entry) => this.registerPreviewEntry(entry));
     }
+    /**
+     * Registers a single file preview entry for its MIME type(s).
+     *
+     * @param entry - The preview entry to register
+     */
     registerPreviewEntry(entry) {
         asArray(entry.mimeType).forEach((mimeType) => this._entries.set(mimeType, entry));
     }
+    /**
+     * Overrides the default preview component function used when no MIME-specific entry is registered.
+     */
     setDefaultPreviewComponentFunction(previewFunction) {
         this._defaultPreviewComponentFunction = previewFunction;
     }
+    /**
+     * Overrides the default dialog-with-component function used when no MIME-specific dialog handler is registered.
+     */
     setDefaultPreviewDialogWithComponentFunction(previewDialogWithComponentFunction) {
         this._defaultPreviewDialogWithComponentFunction = previewDialogWithComponentFunction;
     }
     // Service
+    /**
+     * 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
+     */
     createPreviewConfig(input) {
         const { embedMimeType } = input;
         const previewFunction = (embedMimeType ? this._entries.get(embedMimeType)?.previewComponentFunction : undefined) ?? this._defaultPreviewComponentFunction;
         return previewFunction(input);
     }
+    /**
+     * Opens a Material dialog to preview a file. Uses a MIME-specific dialog function if registered, otherwise creates a preview component and wraps it in the default dialog.
+     *
+     * @param input - The dialog input containing file data and MIME type
+     * @returns Reference to the opened dialog
+     */
     openPreviewDialog(input) {
         const { embedMimeType } = input;
         const previewDialogFunction = embedMimeType ? this._entries.get(embedMimeType)?.previewDialogFunction : undefined;
@@ -13406,17 +13515,20 @@ class DbxClickToCopyTextComponent {
     contentElementRef = viewChild('content', ...(ngDevMode ? [{ debugName: "contentElementRef" }] : []));
     dbxClickToCopyText = viewChild(DbxClickToCopyTextDirective, ...(ngDevMode ? [{ debugName: "dbxClickToCopyText" }] : []));
     copyText = input(undefined, ...(ngDevMode ? [{ debugName: "copyText" }] : []));
+    showIcon = input(true, ...(ngDevMode ? [{ debugName: "showIcon" }] : []));
     highlighted = input(false, ...(ngDevMode ? [{ debugName: "highlighted" }] : []));
     clipboardSnackbarMessagesConfig = input(undefined, ...(ngDevMode ? [{ debugName: "clipboardSnackbarMessagesConfig" }] : []));
     clipboardSnackbarMessagesEnabled = input(true, ...(ngDevMode ? [{ debugName: "clipboardSnackbarMessagesEnabled" }] : []));
     clickToCopyIcon = input('content_copy', ...(ngDevMode ? [{ debugName: "clickToCopyIcon" }] : []));
     clickIconToCopyOnly = input(false, ...(ngDevMode ? [{ debugName: "clickIconToCopyOnly" }] : []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxClickToCopyTextComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.2.0", version: "21.2.0", type: DbxClickToCopyTextComponent, isStandalone: true, selector: "dbx-click-to-copy-text", inputs: { copyText: { classPropertyName: "copyText", publicName: "copyText", isSignal: true, isRequired: false, transformFunction: null }, highlighted: { classPropertyName: "highlighted", publicName: "highlighted", isSignal: true, isRequired: false, transformFunction: null }, clipboardSnackbarMessagesConfig: { classPropertyName: "clipboardSnackbarMessagesConfig", publicName: "clipboardSnackbarMessagesConfig", isSignal: true, isRequired: false, transformFunction: null }, clipboardSnackbarMessagesEnabled: { classPropertyName: "clipboardSnackbarMessagesEnabled", publicName: "clipboardSnackbarMessagesEnabled", isSignal: true, isRequired: false, transformFunction: null }, clickToCopyIcon: { classPropertyName: "clickToCopyIcon", publicName: "clickToCopyIcon", isSignal: true, isRequired: false, transformFunction: null }, clickIconToCopyOnly: { classPropertyName: "clickIconToCopyOnly", publicName: "clickIconToCopyOnly", isSignal: true, isRequired: false, transformFunction: null } }, host: { classAttribute: "dbx-click-to-copy-text-component" }, viewQueries: [{ propertyName: "contentElementRef", first: true, predicate: ["content"], descendants: true, isSignal: true }, { propertyName: "dbxClickToCopyText", first: true, predicate: DbxClickToCopyTextDirective, descendants: true, isSignal: true }], ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.0", type: DbxClickToCopyTextComponent, isStandalone: true, selector: "dbx-click-to-copy-text", inputs: { copyText: { classPropertyName: "copyText", publicName: "copyText", isSignal: true, isRequired: false, transformFunction: null }, showIcon: { classPropertyName: "showIcon", publicName: "showIcon", isSignal: true, isRequired: false, transformFunction: null }, highlighted: { classPropertyName: "highlighted", publicName: "highlighted", isSignal: true, isRequired: false, transformFunction: null }, clipboardSnackbarMessagesConfig: { classPropertyName: "clipboardSnackbarMessagesConfig", publicName: "clipboardSnackbarMessagesConfig", isSignal: true, isRequired: false, transformFunction: null }, clipboardSnackbarMessagesEnabled: { classPropertyName: "clipboardSnackbarMessagesEnabled", publicName: "clipboardSnackbarMessagesEnabled", isSignal: true, isRequired: false, transformFunction: null }, clickToCopyIcon: { classPropertyName: "clickToCopyIcon", publicName: "clickToCopyIcon", isSignal: true, isRequired: false, transformFunction: null }, clickIconToCopyOnly: { classPropertyName: "clickIconToCopyOnly", publicName: "clickIconToCopyOnly", isSignal: true, isRequired: false, transformFunction: null } }, host: { classAttribute: "dbx-click-to-copy-text-component" }, viewQueries: [{ propertyName: "contentElementRef", first: true, predicate: ["content"], descendants: true, isSignal: true }, { propertyName: "dbxClickToCopyText", first: true, predicate: DbxClickToCopyTextDirective, descendants: true, isSignal: true }], ngImport: i0, template: `
     <span #content [dbxClickToCopyText]="copyText()" [disableCopy]="clickIconToCopyOnly()" [highlighted]="highlighted()" [clipboardSnackbarMessagesEnabled]="clipboardSnackbarMessagesEnabled()" [clipboardSnackbarMessagesConfig]="clipboardSnackbarMessagesConfig()" [copyTextFromElement]="contentElementRef()">
       <ng-content></ng-content>
     </span>
-    <mat-icon class="dbx-click-to-copy-text-icon" (click)="dbxClickToCopyText()?._copyText()">{{ clickToCopyIcon() }}</mat-icon>
+    @if (showIcon()) {
+      <mat-icon class="dbx-click-to-copy-text-icon" (click)="dbxClickToCopyText()?._copyText()">{{ clickToCopyIcon() }}</mat-icon>
+    }
   `, isInline: true, dependencies: [{ kind: "directive", type: DbxClickToCopyTextDirective, selector: "[dbxClickToCopyText]", inputs: ["copyTextFromElement", "dbxClickToCopyText", "disableCopy", "highlighted"], outputs: ["copyTextFromElementChange"] }, { kind: "component", type: MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxClickToCopyTextComponent, decorators: [{
@@ -13427,7 +13539,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
     <span #content [dbxClickToCopyText]="copyText()" [disableCopy]="clickIconToCopyOnly()" [highlighted]="highlighted()" [clipboardSnackbarMessagesEnabled]="clipboardSnackbarMessagesEnabled()" [clipboardSnackbarMessagesConfig]="clipboardSnackbarMessagesConfig()" [copyTextFromElement]="contentElementRef()">
       <ng-content></ng-content>
     </span>
-    <mat-icon class="dbx-click-to-copy-text-icon" (click)="dbxClickToCopyText()?._copyText()">{{ clickToCopyIcon() }}</mat-icon>
+    @if (showIcon()) {
+      <mat-icon class="dbx-click-to-copy-text-icon" (click)="dbxClickToCopyText()?._copyText()">{{ clickToCopyIcon() }}</mat-icon>
+    }
   `,
                     host: {
                         class: 'dbx-click-to-copy-text-component'
@@ -13435,7 +13549,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
                     imports: [DbxClickToCopyTextDirective, MatIcon],
                     standalone: true
                 }]
-        }], propDecorators: { contentElementRef: [{ type: i0.ViewChild, args: ['content', { isSignal: true }] }], dbxClickToCopyText: [{ type: i0.ViewChild, args: [i0.forwardRef(() => DbxClickToCopyTextDirective), { isSignal: true }] }], copyText: [{ type: i0.Input, args: [{ isSignal: true, alias: "copyText", required: false }] }], highlighted: [{ type: i0.Input, args: [{ isSignal: true, alias: "highlighted", required: false }] }], clipboardSnackbarMessagesConfig: [{ type: i0.Input, args: [{ isSignal: true, alias: "clipboardSnackbarMessagesConfig", required: false }] }], clipboardSnackbarMessagesEnabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "clipboardSnackbarMessagesEnabled", required: false }] }], clickToCopyIcon: [{ type: i0.Input, args: [{ isSignal: true, alias: "clickToCopyIcon", required: false }] }], clickIconToCopyOnly: [{ type: i0.Input, args: [{ isSignal: true, alias: "clickIconToCopyOnly", required: false }] }] } });
+        }], propDecorators: { contentElementRef: [{ type: i0.ViewChild, args: ['content', { isSignal: true }] }], dbxClickToCopyText: [{ type: i0.ViewChild, args: [i0.forwardRef(() => DbxClickToCopyTextDirective), { isSignal: true }] }], copyText: [{ type: i0.Input, args: [{ isSignal: true, alias: "copyText", required: false }] }], showIcon: [{ type: i0.Input, args: [{ isSignal: true, alias: "showIcon", required: false }] }], highlighted: [{ type: i0.Input, args: [{ isSignal: true, alias: "highlighted", required: false }] }], clipboardSnackbarMessagesConfig: [{ type: i0.Input, args: [{ isSignal: true, alias: "clipboardSnackbarMessagesConfig", required: false }] }], clipboardSnackbarMessagesEnabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "clipboardSnackbarMessagesEnabled", required: false }] }], clickToCopyIcon: [{ type: i0.Input, args: [{ isSignal: true, alias: "clickToCopyIcon", required: false }] }], clickIconToCopyOnly: [{ type: i0.Input, args: [{ isSignal: true, alias: "clickIconToCopyOnly", required: false }] }] } });
 
 const importsAndExports$1 = [DbxUnitedStatesAddressComponent, DbxNumberWithLimitComponent, DbxClickToCopyTextDirective, DbxClickToCopyTextComponent, DbxChipDirective, DbxDetailBlockComponent, DbxDetailBlockHeaderComponent, DbxLabelBlockComponent, DbxLinkifyComponent, DbxTextChipsComponent, DbxIconSpacerDirective];
 /**
@@ -14162,12 +14276,25 @@ class DbxHelpContextService {
      * Observable of all currently active help context strings.
      */
     activeHelpContextKeys$ = this._contextReferences.pipe(switchMap((allReferences) => combineLatest(Array.from(allReferences).map((ref) => ref.helpContextKeys$)).pipe(map((x) => x.flat()), defaultIfEmpty([]), map((x) => new Set(x)))), distinctUntilHasDifferentValues(), shareReplay(1));
+    /**
+     * Observable array of all currently active help context key strings.
+     */
     activeHelpContextKeysArray$ = this.activeHelpContextKeys$.pipe(map((x) => Array.from(x)), shareReplay(1));
+    /**
+     * Registers a help context reference, adding its keys to the active set.
+     *
+     * @param reference - The help context reference to register
+     */
     register(reference) {
         const referenceSet = this._contextReferences.value;
         referenceSet.add(reference);
         this._contextReferences.next(referenceSet);
     }
+    /**
+     * Unregisters a help context reference, removing its keys from the active set.
+     *
+     * @param reference - The help context reference to unregister
+     */
     unregister(reference) {
         const referenceSet = this._contextReferences.value;
         referenceSet.delete(reference);
@@ -14269,30 +14396,45 @@ class DbxHelpWidgetService {
             this.register(initialConfig.entries);
         }
     }
+    /**
+     * Returns the component class used for unrecognized help context keys.
+     */
     getDefaultWidgetComponentClass() {
         return this._defaultWidgetComponentClass;
     }
     setDefaultWidgetComponentClass(componentClass) {
         this._defaultWidgetComponentClass = componentClass;
     }
+    /**
+     * Returns the default icon used for help entries without a specific icon.
+     */
     getDefaultIcon() {
         return this._defaultIcon;
     }
     setDefaultIcon(icon) {
         this._defaultIcon = icon;
     }
+    /**
+     * Returns the component config displayed in the popover header, if set.
+     */
     getPopoverHeaderComponentConfig() {
         return this._popoverHeaderComponentConfig;
     }
     setPopoverHeaderComponentConfig(componentConfig) {
         this._popoverHeaderComponentConfig = componentConfig;
     }
+    /**
+     * Returns the component config displayed at the top of the help list view, if set.
+     */
     getHelpListHeaderComponentConfig() {
         return this._helpListHeaderComponentConfig;
     }
     setHelpListHeaderComponentConfig(componentConfig) {
         this._helpListHeaderComponentConfig = componentConfig;
     }
+    /**
+     * Returns the component config displayed at the bottom of the help list view, if set.
+     */
     getHelpListFooterComponentConfig() {
         return this._helpListFooterComponentConfig;
     }
@@ -14317,18 +14459,37 @@ class DbxHelpWidgetService {
         return true;
     }
     // MARK: Get
+    /**
+     * Returns all currently registered help context keys.
+     */
     getAllRegisteredHelpContextKeys() {
         return Array.from(this._entries.keys());
     }
+    /**
+     * Retrieves the widget entry for a given help context key. Falls back to a default entry if a default widget component class is configured.
+     *
+     * @param helpContextKey - The help context key to look up
+     */
     getHelpWidgetEntry(helpContextKey) {
         return this._entries.get(helpContextKey) ?? (this._defaultWidgetComponentClass ? { helpContextKey, title: '<Missing Help Topic>', widgetComponentClass: this._defaultWidgetComponentClass } : undefined);
     }
+    /**
+     * Retrieves widget entries for multiple help context keys, filtering out any unresolvable keys.
+     *
+     * @param helpContextKeys - Array of help context keys to look up
+     */
     getHelpWidgetEntriesForHelpContextKeys(helpContextKeys) {
         return helpContextKeys.map((context) => this.getHelpWidgetEntry(context)).filter((entry) => !!entry);
     }
+    /**
+     * Checks whether a widget entry is registered for the given help context key.
+     */
     hasHelpWidgetEntry(context) {
         return this._entries.has(context);
     }
+    /**
+     * Returns a cached map of help context keys to their sort priority values.
+     */
     getSortPriorityMap() {
         return this._sortPriorityMap();
     }