@dereekb/dbx-web 12.6.16 → 12.6.18

package/lib/extension/help/help.view.list.component.d.ts

@@ -2,7 +2,8 @@ import { DbxHelpContextString } from './help';
 import { ObservableOrValue } from '@dereekb/rxjs';
 import { Observable } from 'rxjs';
 import { DbxHelpWidgetService } from './help.widget.service';
-import { ArrayOrValue } from '@dereekb/util';
+import { ArrayOrValue, Maybe } from '@dereekb/util';
+import { DbxInjectionComponentConfig } from '@dereekb/dbx-core';
 import * as i0 from "@angular/core";
 export declare class DbxHelpViewListComponent {
     readonly helpWidgetService: DbxHelpWidgetService;
@@ -10,11 +11,22 @@ export declare class DbxHelpViewListComponent {
      * Whether the accordion should allow multiple expanded panels.
      */
     readonly multi: import("@angular/core").InputSignal<boolean>;
+    /**
+     * Whether or not to show the empty list content.
+     */
+    readonly allowEmptyListContent: import("@angular/core").InputSignal<boolean>;
+    /**
+     * Optional footer component config to inject after the list.
+     *
+     * If set null, then will not show any footer.
+     */
+    readonly helpListFooterComponentConfig: import("@angular/core").InputSignal<Maybe<DbxInjectionComponentConfig<unknown>>>;
     readonly helpContextStrings: import("@angular/core").InputSignal<ObservableOrValue<ArrayOrValue<string>>>;
     readonly helpContextStrings$: Observable<DbxHelpContextString[]>;
     readonly helpContextStringsSignal: import("@angular/core").Signal<string[]>;
     readonly helpWidgetEntriesSignal: import("@angular/core").Signal<import("@dereekb/dbx-web").DbxHelpWidgetServiceEntry[]>;
     readonly hasNoHelpWidgetEntriesSignal: import("@angular/core").Signal<boolean>;
+    readonly helpListFooterComponentConfigSignal: import("@angular/core").Signal<Maybe<DbxInjectionComponentConfig<unknown>>>;
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxHelpViewListComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DbxHelpViewListComponent, "dbx-help-view-list", never, { "multi": { "alias": "multi"; "required": false; "isSignal": true; }; "helpContextStrings": { "alias": "helpContextStrings"; "required": true; "isSignal": true; }; }, {}, never, ["[empty]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DbxHelpViewListComponent, "dbx-help-view-list", never, { "multi": { "alias": "multi"; "required": false; "isSignal": true; }; "allowEmptyListContent": { "alias": "allowEmptyListContent"; "required": false; "isSignal": true; }; "helpListFooterComponentConfig": { "alias": "helpListFooterComponentConfig"; "required": false; "isSignal": true; }; "helpContextStrings": { "alias": "helpContextStrings"; "required": true; "isSignal": true; }; }, {}, never, ["[empty]"], true, never>;
 }

package/lib/extension/help/help.view.popover.component.d.ts

@@ -2,7 +2,7 @@ import { ElementRef } from '@angular/core';
 import { ArrayOrValue, Maybe } from '@dereekb/util';
 import { AbstractPopoverDirective } from '../../interaction/popover/abstract.popover.directive';
 import { DbxPopoverKey } from '../../interaction/popover/popover';
-import { DbxPopoverService } from '../../interaction/popover/popover.service';
+import { DbxPopoverConfigSizing, DbxPopoverService } from '../../interaction/popover/popover.service';
 import { DbxHelpContextString } from './help';
 import { NgPopoverRef } from 'ng-overlay-container';
 import { ObservableOrValue } from '@dereekb/rxjs';
@@ -34,12 +34,26 @@ export interface DbxHelpViewPopoverConfig {
      * Specific contexts to display. If not provided, shows all active contexts from the DbxHelpContextService.
      */
     readonly helpContextStrings?: Maybe<ObservableOrValue<ArrayOrValue<DbxHelpContextString>>>;
+    /**
+     * Optional footer component config to inject after the list.
+     */
+    readonly helpListFooterComponentConfig?: Maybe<DbxInjectionComponentConfig>;
+    /**
+     * Whether to show the empty list content.
+     *
+     * Defaults to true.
+     */
+    readonly allowEmptyListContent?: Maybe<boolean>;
     /**
      * Overrides the default popover header config.
      *
      * If not provided, the default popover header config will be used from DbxHelpWidgetService.
      */
     readonly popoverHeaderConfig?: Maybe<DbxInjectionComponentConfig>;
+    /**
+     * Additional popover configuration.
+     */
+    readonly popoverSizingConfig?: Maybe<DbxPopoverConfigSizing>;
 }
 export type DbxHelpViewPopoverConfigWithoutOrigin = Omit<DbxHelpViewPopoverConfig, 'origin'>;
 /**
@@ -54,6 +68,8 @@ export declare class DbxHelpViewPopoverComponent extends AbstractPopoverDirectiv
     readonly icon: string;
     readonly header: string;
     readonly emptyText: string;
+    readonly allowEmptyListContent: boolean;
+    readonly helpListFooterComponentConfig: Maybe<DbxInjectionComponentConfig<unknown>>;
     readonly popoverHeaderConfig: Maybe<DbxInjectionComponentConfig>;
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxHelpViewPopoverComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DbxHelpViewPopoverComponent, "ng-component", never, {}, {}, never, never, true, never>;

package/lib/extension/help/help.widget.d.ts

@@ -17,6 +17,12 @@ export interface DbxHelpWidgetServiceEntry {
      * Icon for the help topic, if applicable.
      */
     readonly icon?: Maybe<string>;
+    /**
+     * The priority to use when sorting the entities.
+     *
+     * Higher values are displayed first in the list.
+     */
+    readonly sortPriority?: Maybe<number>;
     /**
      * Custom help widget component class to use.
      *

package/lib/extension/help/help.widget.service.d.ts

@@ -5,6 +5,9 @@ import { DbxHelpWidgetServiceEntry } from './help.widget';
 import { DbxInjectionComponentConfig } from '@dereekb/dbx-core';
 import * as i0 from "@angular/core";
 export declare abstract class DbxHelpWidgetServiceConfig {
+    /**
+     * All help widget service entries.
+     */
     abstract readonly entries?: Maybe<DbxHelpWidgetServiceEntry[]>;
     /**
      * Default icon to use for unknown help topics.
@@ -14,6 +17,10 @@ export declare abstract class DbxHelpWidgetServiceConfig {
      * Default/Unknown help topic component class.
      */
     abstract readonly defaultWidgetComponentClass?: Maybe<Type<unknown>>;
+    /**
+     * Optional component class that shows up under the help content in the list view.
+     */
+    abstract readonly helpListFooterComponentConfig?: Maybe<DbxInjectionComponentConfig>;
     /**
      * Optional header component class to use for the list view.
      */
@@ -27,7 +34,9 @@ export declare abstract class DbxHelpWidgetServiceConfig {
  */
 export declare class DbxHelpWidgetService {
     private readonly _entries;
+    private readonly _sortPriorityMap;
     private _defaultWidgetComponentClass;
+    private _helpListFooterComponentConfig;
     private _defaultIcon?;
     private _popoverHeaderComponentConfig;
     constructor(initialConfig?: DbxHelpWidgetServiceConfig);
@@ -37,6 +46,8 @@ export declare class DbxHelpWidgetService {
     setDefaultIcon(icon: Maybe<string>): void;
     getPopoverHeaderComponentConfig(): Maybe<DbxInjectionComponentConfig>;
     setPopoverHeaderComponentConfig(componentConfig: Maybe<DbxInjectionComponentConfig>): void;
+    getHelpListFooterComponentConfig(): Maybe<DbxInjectionComponentConfig>;
+    setHelpListFooterComponentConfig(componentConfig: Maybe<DbxInjectionComponentConfig>): void;
     /**
      * Used to register one or more entries.
      *
@@ -50,6 +61,7 @@ export declare class DbxHelpWidgetService {
     getHelpWidgetEntry(helpContextString: DbxHelpContextString): Maybe<DbxHelpWidgetServiceEntry>;
     getHelpWidgetEntriesForHelpContextStrings(helpContextStrings: DbxHelpContextString[]): DbxHelpWidgetServiceEntry[];
     hasHelpWidgetEntry(context: DbxHelpContextString): boolean;
+    getSortPriorityMap(): Map<string, number>;
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxHelpWidgetService, [{ optional: true; }]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<DbxHelpWidgetService>;
 }

package/lib/interaction/popover/popover.service.d.ts

@@ -4,7 +4,7 @@ import { NgOverlayContainerConfiguration, NgPopoverRef } from 'ng-overlay-contai
 import * as i0 from "@angular/core";
 export type DbxPopoverConfigSizing = Pick<NgOverlayContainerConfiguration, 'originX' | 'originY' | 'height' | 'width' | 'minHeight' | 'minWidth' | 'isResizable'>;
 export interface DbxPopoverConfig<O, I, T> extends DbxPopoverComponentConfig<O, I, T>, DbxPopoverConfigSizing {
-    injector?: Injector;
+    readonly injector?: Injector;
 }
 /**
  * Used for displaying a popover.

package/lib/router/provider/uirouter/anchor.component.d.ts

@@ -1,14 +1,31 @@
+import { ElementRef, OnDestroy } from '@angular/core';
 import { AbstractDbxSegueAnchorDirective } from '../../layout/anchor/anchor.segue.directive';
 import { Obj, StateOrName, TransitionOptions } from '@uirouter/angular';
 import * as i0 from "@angular/core";
 /**
  * SegueAnchor implementation for UIRouter.
  */
-export declare class DbxUIRouterSegueAnchorComponent extends AbstractDbxSegueAnchorDirective {
+export declare class DbxUIRouterSegueAnchorComponent extends AbstractDbxSegueAnchorDirective implements OnDestroy {
+    private _cleanupClickOverride;
     private readonly _parentAnchorSignal;
+    readonly anchorElement: import("@angular/core").Signal<ElementRef<HTMLElement>>;
+    readonly injectionElement: import("@angular/core").Signal<ElementRef<HTMLElement>>;
+    readonly anchorDisabledSignal: import("@angular/core").Signal<boolean>;
+    /**
+     * This effect exists to solve the issue of an injected element that utilizes event.stopPropogation() and doesn't also call event.preventDefault().
+     *
+     * We didn't want to use css's pointer-events: none as that would disable the Angular Material button effects.
+     *
+     * For example, dbx-button would call event.stopPropagation() on click, which would prevent the uiSref from being triggered, but the default behavior
+     * of the anchor element would still be triggered, causing the browser to load/reload the page at the given href instead of navigating to the new state using uiSref.
+     *
+     * NOTE: Those nested event listeners are still ultimately triggered.
+     */
+    protected readonly _overrideClickElementEffect: import("@angular/core").EffectRef;
     readonly uiSrefSignal: import("@angular/core").Signal<StateOrName>;
     readonly uiParamsSignal: import("@angular/core").Signal<Obj | undefined>;
     readonly uiOptionsSignal: import("@angular/core").Signal<TransitionOptions>;
+    ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxUIRouterSegueAnchorComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DbxUIRouterSegueAnchorComponent, "ng-component", never, {}, {}, never, never, true, never>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-web",
-  "version": "12.6.16",
+  "version": "12.6.18",
   "peerDependencies": {
     "@angular/common": "^18.0.0",
     "@angular/core": "^18.0.0",