@clr/angular 18.0.0-beta.1 → 18.0.0-beta.2

package/package.json

@@ -21,7 +21,7 @@
     "@angular/cdk": "^21",
     "@angular/common": "^21",
     "@angular/core": "^21",
-    "@clr/ui": "18.0.0-beta.1"
+    "@clr/ui": "18.0.0-beta.2"
   },
   "module": "fesm2022/clr-angular.mjs",
   "typings": "types/clr-angular.d.ts",
@@ -226,5 +226,5 @@
   "dependencies": {
     "tslib": "^2.3.0"
   },
-  "version": "18.0.0-beta.1"
+  "version": "18.0.0-beta.2"
 }

package/popover/common/README.md

@@ -25,10 +25,12 @@ The service is responsible for:
   - **`toggleWithEvent(event: any)`**: A helper method used by triggers. It toggles the `open` state, stores the triggering event (to prevent conflicts like "click outside" closing immediately), and prevents default scrolling behavior for arrow keys.
   - **`openEvent`**: Stores the specific browser event that triggered the opening of the popover.
 
-- **Focus & Anchor Management**:
-  - **`anchorElementRef`**: Holds the `ElementRef` of the anchor/trigger element. This is used by the CDK to calculate where the overlay should appear.
+- **Focus & Origin Management**:
+  - **`origin`**: Holds the `FlexibleConnectedPositionStrategyOrigin` — either an `ElementRef` (trigger element) or a `ClrPopoverPoint` (`{ x, y }` coordinate). This is used by the CDK to calculate where the overlay should appear.
+  - **`originElement`**: Convenience getter that returns the origin as `ElementRef<HTMLElement>` when element-based, or `null` when point-based.
+  - **`originPoint`**: Convenience getter that returns the origin as `ClrPopoverPoint` when point-based, or `null` when element-based.
   - **`closeButtonRef`**: Holds the `ElementRef` of the internal close button (if applicable).
-  - **`focusAnchor()`**: A utility method to return focus to the anchor element (e.g., when the menu closes), ensuring accessibility compliance.
+  - **`focusOrigin()`**: A utility method to return focus to the origin element (e.g., when the menu closes), ensuring accessibility compliance. No-op for point-based origins.
   - **`focusCloseButton()`**: Moves focus to the close button inside the content when appropriate.
 
 - **Reactive Streams**:
@@ -38,10 +40,10 @@ The service is responsible for:
 
 ### Directives
 
-1.  **`[clrPopoverAnchor]`**:
+1.  **`[clrPopoverOrigin]`**:
 
-- Used on the element that serves as the reference point for positioning (the anchor).
-- Passes an `ElementRef` to the service, which is used for focus management and positioning calculations.
+- Used on the element that serves as the reference point for positioning.
+- Passes an `ElementRef` to the service as the `origin`, which is used for focus management and positioning calculations.
 
 2.  **`*clrPopoverContent`**:
 
@@ -52,7 +54,7 @@ The service is responsible for:
 3.  **`[clrPopoverCloseButton]`**:
 
 - Should only be used inside popover content containers.
-- Calls the toggle method on the service and restores focus to the anchor element.
+- Calls the toggle method on the service and restores focus to the origin element.
 
 4.  **`[clrPopoverOpenCloseButton]`**:
 
@@ -66,7 +68,7 @@ The `*clrPopoverContent` directive is the "workhorse" of the utility. It accepts
 - **`clrPopoverContent`** (boolean):
   - Controls the open/closed state of the popover. When true, the overlay is created and attached; when false, it is detached.
 - **`clrPopoverContentAt`** (`ClrPopoverPosition | ConnectedPosition`):
-  - Defines the preferred position of the content relative to the anchor (e.g., `top-right`, `bottom-left`). It sets the `preferredPosition` for the CDK overlay.
+  - Defines the preferred position of the content relative to the origin (e.g., `top-right`, `bottom-left`). It sets the `preferredPosition` for the CDK overlay.
 - **`clrPopoverContentAvailablePositions`** (`ConnectedPosition[]`):
   - A prioritized list of fallback positions the overlay can attempt to use if the preferred position does not fit within the viewport.
 - **`clrPopoverContentType`** (`ClrPopoverType`):
@@ -79,8 +81,8 @@ The `*clrPopoverContent` directive is the "workhorse" of the utility. It accepts
 ## Enums
 
 1.  **`ClrPopoverType`**: Describes the popover variation: `SIGNPOST`, `TOOLTIP`, `DROPDOWN`, and `DEFAULT`.
-2.  **`ClrPopoverPosition`**: Describes the popover position relative to the anchor (e.g., `top-left`, `bottom-right`).
-3.  **`ClrPosition`**: Describes the specific point of contact on both the anchor and content elements.
+2.  **`ClrPopoverPosition`**: Describes the popover position relative to the origin (e.g., `top-left`, `bottom-right`).
+3.  **`ClrPosition`**: Describes the specific point of contact on both the origin and content elements.
 
 ---
 
@@ -89,8 +91,8 @@ The `*clrPopoverContent` directive is the "workhorse" of the utility. It accepts
 To use the popover utility, a host component must provide the `ClrPopoverService`. Components generally provide a `ClrPopoverPosition` via the `at` input to describe the preferred content position.
 
 ```html
-<button class="btn" clrPopoverOpenCloseButton clrPopoverAnchor [attr.aria-owns]="popoverId">
-  <cds-icon shape="home"></cds-icon> Popover Anchor
+<button class="btn" clrPopoverOpenCloseButton clrPopoverOrigin [attr.aria-owns]="popoverId">
+  <cds-icon shape="home"></cds-icon> Popover Origin
 </button>
 <div
   [id]="popoverId"

package/types/clr-angular-data-datagrid.d.ts

@@ -1751,16 +1751,6 @@ declare class DatagridMainRenderer implements AfterContentInit, AfterViewInit, A
     toggleDetailPane(state: boolean): void;
     private setupColumns;
     private shouldComputeHeight;
-    /**
-     * Computes the height of the datagrid.
-     *
-     * NOTE: We had to choose to set the height instead of the min-height because
-     * IE 11 requires the height on the parent for the children flex grow/shrink properties to work.
-     * When we used min-height, 1 1 auto doesn't used to work in IE11 :-(
-     * But this doesn't affect the fix. It works in both fixed & variable height datagrids.
-     *
-     * Refer: http://stackoverflow.com/questions/24396205/flex-grow-not-working-in-internet-explorer-11-0
-     */
     private computeDatagridHeight;
     private resetDatagridHeight;
     /**

package/types/clr-angular-data.d.ts

@@ -1760,16 +1760,6 @@ declare class DatagridMainRenderer implements AfterContentInit, AfterViewInit, A
     toggleDetailPane(state: boolean): void;
     private setupColumns;
     private shouldComputeHeight;
-    /**
-     * Computes the height of the datagrid.
-     *
-     * NOTE: We had to choose to set the height instead of the min-height because
-     * IE 11 requires the height on the parent for the children flex grow/shrink properties to work.
-     * When we used min-height, 1 1 auto doesn't used to work in IE11 :-(
-     * But this doesn't affect the fix. It works in both fixed & variable height datagrids.
-     *
-     * Refer: http://stackoverflow.com/questions/24396205/flex-grow-not-working-in-internet-explorer-11-0
-     */
     private computeDatagridHeight;
     private resetDatagridHeight;
     /**

package/types/clr-angular-forms-combobox.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { AfterContentInit, AfterViewInit, ElementRef, TemplateRef, ChangeDetectorRef, RendererFactory2, Renderer2, EventEmitter, ViewContainerRef, Injector, OnInit, OnDestroy, QueryList, DoCheck, IterableDiffers, TrackByFunction } from '@angular/core';
+import { AfterContentInit, AfterViewInit, ElementRef, TemplateRef, RendererFactory2, Renderer2, EventEmitter, ViewContainerRef, Injector, ChangeDetectorRef, OnInit, OnDestroy, QueryList, DoCheck, IterableDiffers, TrackByFunction } from '@angular/core';
 import * as rxjs from 'rxjs';
 import { Observable } from 'rxjs';
 import * as i9 from '@angular/forms';
@@ -33,9 +33,11 @@ declare class ClrComboboxContainer extends ClrAbstractContainer implements After
     static ɵcmp: i0.ɵɵComponentDeclaration<ClrComboboxContainer, "clr-combobox-container", never, {}, {}, never, ["label", "clr-combobox", "clr-control-helper", "clr-control-error", "clr-control-success"], false, never>;
 }
 
+type ClrComboboxIdentityFunction<T> = (item: T) => any;
 declare abstract class ComboboxModel<T> {
     model: T | T[];
     displayField?: string;
+    identityFn: ClrComboboxIdentityFunction<T>;
     abstract containsItem(item: T): boolean;
     abstract select(item: T): void;
     abstract unselect(item: T): void;
@@ -74,16 +76,20 @@ declare class OptionSelectionService<T> {
     set currentInput(input: string);
     get selectionChanged(): Observable<ComboboxModel<T>>;
     get multiselectable(): boolean;
+    get identityFn(): ClrComboboxIdentityFunction<T>;
+    set identityFn(value: ClrComboboxIdentityFunction<T>);
     select(item: T): void;
     toggle(item: T): void;
     unselect(item: T): void;
     setSelectionValue(value: T | T[]): void;
     parseStringToModel(value: string): T;
+    private _identityFn;
+    private valuesEqualByIdentity;
     static ɵfac: i0.ɵɵFactoryDeclaration<OptionSelectionService<any>, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<OptionSelectionService<any>>;
 }
 
-declare class SingleSelectComboboxModel<T> implements ComboboxModel<T> {
+declare class SingleSelectComboboxModel<T> extends ComboboxModel<T> {
     model: T;
     containsItem(item: T): boolean;
     select(item: T): void;
@@ -103,7 +109,6 @@ declare class ComboboxFocusHandler<T> {
     private popoverService;
     private selectionService;
     private platformId;
-    componentCdRef: ChangeDetectorRef;
     pseudoFocus: PseudoFocusModel<OptionData<T>>;
     private renderer;
     private _trigger;
@@ -171,6 +176,7 @@ declare class ClrCombobox<T> extends WrappedFormControl<ClrComboboxContainer> im
     constructor(vcr: ViewContainerRef, injector: Injector, control: NgControl, renderer: Renderer2, el: ElementRef<HTMLElement>, optionSelectionService: OptionSelectionService<T>, commonStrings: ClrCommonStringsService, popoverService: ClrPopoverService, containerService: ComboboxContainerService, platformId: any, focusHandler: ComboboxFocusHandler<T>, cdr: ChangeDetectorRef);
     get editable(): boolean;
     set editable(value: boolean);
+    set identityFn(value: ClrComboboxIdentityFunction<T>);
     get multiSelect(): boolean | string;
     set multiSelect(value: boolean | string);
     get id(): string;
@@ -206,7 +212,7 @@ declare class ClrCombobox<T> extends WrappedFormControl<ClrComboboxContainer> im
     private updateControlValue;
     private getDisplayNames;
     static ɵfac: i0.ɵɵFactoryDeclaration<ClrCombobox<any>, [null, null, { optional: true; self: true; }, null, null, null, null, null, { optional: true; }, null, null, null]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ClrCombobox<any>, "clr-combobox", never, { "placeholder": { "alias": "placeholder"; "required": false; }; "editable": { "alias": "clrEditable"; "required": false; }; "multiSelect": { "alias": "clrMulti"; "required": false; }; }, { "clrInputChange": "clrInputChange"; "clrOpenChange": "clrOpenChange"; "clrSelectionChange": "clrSelectionChange"; }, ["optionSelected", "options"], ["*"], false, [{ directive: typeof i1.ClrPopoverHostDirective; inputs: {}; outputs: {}; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ClrCombobox<any>, "clr-combobox", never, { "placeholder": { "alias": "placeholder"; "required": false; }; "editable": { "alias": "clrEditable"; "required": false; }; "identityFn": { "alias": "clrComboboxIdentityFn"; "required": false; }; "multiSelect": { "alias": "clrMulti"; "required": false; }; }, { "clrInputChange": "clrInputChange"; "clrOpenChange": "clrOpenChange"; "clrSelectionChange": "clrSelectionChange"; }, ["optionSelected", "options"], ["*"], false, [{ directive: typeof i1.ClrPopoverHostDirective; inputs: {}; outputs: {}; }]>;
 }
 
 declare class ClrOption<T> implements OnInit {
@@ -298,3 +304,4 @@ declare class ClrComboboxModule {
 }
 
 export { ClrCombobox, ClrComboboxContainer, ClrComboboxModule, ClrOption, ClrOptionGroup, ClrOptionItems, ClrOptionSelected, ClrOptions };
+export type { ClrComboboxIdentityFunction };

package/types/clr-angular-forms-common.d.ts

@@ -63,6 +63,15 @@ declare class ClrControlHelper extends ClrAbstractControl {
     static ɵcmp: i0.ɵɵComponentDeclaration<ClrControlHelper, "clr-control-helper", never, {}, {}, never, ["*"], false, never>;
 }
 
+declare class ClrControlSuccess extends ClrAbstractControl {
+    protected controlIdService: ControlIdService;
+    protected containerIdService: ContainerIdService;
+    controlIdSuffix: string;
+    constructor(controlIdService: ControlIdService, containerIdService: ContainerIdService);
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClrControlSuccess, [{ optional: true; }, { optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ClrControlSuccess, "clr-control-success", never, {}, {}, never, ["*"], false, never>;
+}
+
 declare enum ClrFormLayout {
     VERTICAL = "vertical",
     HORIZONTAL = "horizontal",
@@ -143,15 +152,6 @@ declare class ControlClassService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ControlClassService>;
 }
 
-declare class ClrControlSuccess extends ClrAbstractControl {
-    protected controlIdService: ControlIdService;
-    protected containerIdService: ContainerIdService;
-    controlIdSuffix: string;
-    constructor(controlIdService: ControlIdService, containerIdService: ContainerIdService);
-    static ɵfac: i0.ɵɵFactoryDeclaration<ClrControlSuccess, [{ optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ClrControlSuccess, "clr-control-success", never, {}, {}, never, ["*"], false, never>;
-}
-
 declare abstract class ClrAbstractContainer implements OnDestroy {
     protected layoutService: LayoutService;
     protected controlClassService: ControlClassService;

package/types/clr-angular-forms-datepicker.d.ts

@@ -121,6 +121,13 @@ interface DateRangeOption {
 }
 
 declare class DateIOService {
+    /**
+     * This is the default range. It approximates the beginning of time to the end of time.
+     * The disabled dates are the dates that are not allowed to be selected.
+     * The min date is the earliest date that can be selected.
+     * The max date is the latest date that can be selected.
+     * Unless a minDate or maxDate is set with the native HTML5 api the range is all dates
+     */
     disabledDates: DateRange;
     cldrLocaleDateFormat: string;
     minDateChange: Subject<DayModel>;

package/types/clr-angular-forms-file-input.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { TemplateRef, ElementRef, Injector, Renderer2, ViewContainerRef, InjectionToken } from '@angular/core';
+import { TemplateRef, Injector, ElementRef, Renderer2, ViewContainerRef, InjectionToken } from '@angular/core';
 import { NgControl, Validator, AbstractControl, ValidationErrors, ControlValueAccessor } from '@angular/forms';
 import * as i10 from '@clr/angular/forms/common';
 import { ClrAbstractContainer, WrappedFormControl } from '@clr/angular/forms/common';
@@ -79,6 +79,8 @@ declare class ClrFileMessagesTemplate {
 
 declare class ClrFileList {
     protected readonly fileMessagesTemplate: ClrFileMessagesTemplate;
+    protected injectorCache: Map<File, Injector>;
+    private contextCache;
     private readonly injector;
     private readonly commonStrings;
     private readonly ngControlService;
@@ -88,7 +90,8 @@ declare class ClrFileList {
     protected getClearFileLabel(filename: string): string;
     protected clearFile(fileToRemove: File): void;
     protected createFileMessagesTemplateContext(file: File): ClrFileMessagesTemplateContext;
-    protected createFileMessagesTemplateInjector(fileMessagesTemplateContext: ClrFileMessagesTemplateContext): i0.DestroyableInjector;
+    private createFileMessagesTemplateInjector;
+    private errorsEqual;
     static ɵfac: i0.ɵɵFactoryDeclaration<ClrFileList, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ClrFileList, "clr-file-list", never, {}, {}, ["fileMessagesTemplate"], never, false, never>;
 }

package/types/clr-angular-forms.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { OnInit, OnDestroy, Renderer2, ElementRef, TemplateRef, ViewContainerRef, QueryList, DoCheck, Type, Injector, InjectionToken, AfterContentInit, AfterViewInit, ChangeDetectorRef, RendererFactory2, EventEmitter, IterableDiffers, TrackByFunction, NgZone } from '@angular/core';
+import { OnInit, OnDestroy, Renderer2, ElementRef, TemplateRef, ViewContainerRef, QueryList, DoCheck, Type, Injector, InjectionToken, AfterContentInit, AfterViewInit, RendererFactory2, EventEmitter, ChangeDetectorRef, IterableDiffers, TrackByFunction, NgZone } from '@angular/core';
 import * as i4 from '@angular/forms';
 import { NgControl, ControlValueAccessor, Validator, AbstractControl, ValidationErrors, SelectMultipleControlValueAccessor } from '@angular/forms';
 import * as rxjs from 'rxjs';
@@ -86,6 +86,15 @@ declare class ClrControlHelper extends ClrAbstractControl {
     static ɵcmp: i0.ɵɵComponentDeclaration<ClrControlHelper, "clr-control-helper", never, {}, {}, never, ["*"], false, never>;
 }
 
+declare class ClrControlSuccess extends ClrAbstractControl {
+    protected controlIdService: ControlIdService;
+    protected containerIdService: ContainerIdService;
+    controlIdSuffix: string;
+    constructor(controlIdService: ControlIdService, containerIdService: ContainerIdService);
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClrControlSuccess, [{ optional: true; }, { optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ClrControlSuccess, "clr-control-success", never, {}, {}, never, ["*"], false, never>;
+}
+
 declare enum ClrFormLayout {
     VERTICAL = "vertical",
     HORIZONTAL = "horizontal",
@@ -166,15 +175,6 @@ declare class ControlClassService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ControlClassService>;
 }
 
-declare class ClrControlSuccess extends ClrAbstractControl {
-    protected controlIdService: ControlIdService;
-    protected containerIdService: ContainerIdService;
-    controlIdSuffix: string;
-    constructor(controlIdService: ControlIdService, containerIdService: ContainerIdService);
-    static ɵfac: i0.ɵɵFactoryDeclaration<ClrControlSuccess, [{ optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ClrControlSuccess, "clr-control-success", never, {}, {}, never, ["*"], false, never>;
-}
-
 declare abstract class ClrAbstractContainer implements OnDestroy {
     protected layoutService: LayoutService;
     protected controlClassService: ControlClassService;
@@ -431,9 +431,11 @@ declare class ClrComboboxContainer extends ClrAbstractContainer$1 implements Aft
     static ɵcmp: i0.ɵɵComponentDeclaration<ClrComboboxContainer, "clr-combobox-container", never, {}, {}, never, ["label", "clr-combobox", "clr-control-helper", "clr-control-error", "clr-control-success"], false, never>;
 }
 
+type ClrComboboxIdentityFunction<T> = (item: T) => any;
 declare abstract class ComboboxModel<T> {
     model: T | T[];
     displayField?: string;
+    identityFn: ClrComboboxIdentityFunction<T>;
     abstract containsItem(item: T): boolean;
     abstract select(item: T): void;
     abstract unselect(item: T): void;
@@ -472,16 +474,20 @@ declare class OptionSelectionService<T> {
     set currentInput(input: string);
     get selectionChanged(): Observable<ComboboxModel<T>>;
     get multiselectable(): boolean;
+    get identityFn(): ClrComboboxIdentityFunction<T>;
+    set identityFn(value: ClrComboboxIdentityFunction<T>);
     select(item: T): void;
     toggle(item: T): void;
     unselect(item: T): void;
     setSelectionValue(value: T | T[]): void;
     parseStringToModel(value: string): T;
+    private _identityFn;
+    private valuesEqualByIdentity;
     static ɵfac: i0.ɵɵFactoryDeclaration<OptionSelectionService<any>, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<OptionSelectionService<any>>;
 }
 
-declare class SingleSelectComboboxModel<T> implements ComboboxModel<T> {
+declare class SingleSelectComboboxModel<T> extends ComboboxModel<T> {
     model: T;
     containsItem(item: T): boolean;
     select(item: T): void;
@@ -501,7 +507,6 @@ declare class ComboboxFocusHandler<T> {
     private popoverService;
     private selectionService;
     private platformId;
-    componentCdRef: ChangeDetectorRef;
     pseudoFocus: PseudoFocusModel<OptionData<T>>;
     private renderer;
     private _trigger;
@@ -569,6 +574,7 @@ declare class ClrCombobox<T> extends WrappedFormControl$1<ClrComboboxContainer>
     constructor(vcr: ViewContainerRef, injector: Injector, control: NgControl, renderer: Renderer2, el: ElementRef<HTMLElement>, optionSelectionService: OptionSelectionService<T>, commonStrings: ClrCommonStringsService, popoverService: ClrPopoverService, containerService: ComboboxContainerService, platformId: any, focusHandler: ComboboxFocusHandler<T>, cdr: ChangeDetectorRef);
     get editable(): boolean;
     set editable(value: boolean);
+    set identityFn(value: ClrComboboxIdentityFunction<T>);
     get multiSelect(): boolean | string;
     set multiSelect(value: boolean | string);
     get id(): string;
@@ -604,7 +610,7 @@ declare class ClrCombobox<T> extends WrappedFormControl$1<ClrComboboxContainer>
     private updateControlValue;
     private getDisplayNames;
     static ɵfac: i0.ɵɵFactoryDeclaration<ClrCombobox<any>, [null, null, { optional: true; self: true; }, null, null, null, null, null, { optional: true; }, null, null, null]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ClrCombobox<any>, "clr-combobox", never, { "placeholder": { "alias": "placeholder"; "required": false; }; "editable": { "alias": "clrEditable"; "required": false; }; "multiSelect": { "alias": "clrMulti"; "required": false; }; }, { "clrInputChange": "clrInputChange"; "clrOpenChange": "clrOpenChange"; "clrSelectionChange": "clrSelectionChange"; }, ["optionSelected", "options"], ["*"], false, [{ directive: typeof i1.ClrPopoverHostDirective; inputs: {}; outputs: {}; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ClrCombobox<any>, "clr-combobox", never, { "placeholder": { "alias": "placeholder"; "required": false; }; "editable": { "alias": "clrEditable"; "required": false; }; "identityFn": { "alias": "clrComboboxIdentityFn"; "required": false; }; "multiSelect": { "alias": "clrMulti"; "required": false; }; }, { "clrInputChange": "clrInputChange"; "clrOpenChange": "clrOpenChange"; "clrSelectionChange": "clrSelectionChange"; }, ["optionSelected", "options"], ["*"], false, [{ directive: typeof i1.ClrPopoverHostDirective; inputs: {}; outputs: {}; }]>;
 }
 
 declare class ClrOption<T> implements OnInit {
@@ -852,6 +858,13 @@ interface DateRangeOption {
 }
 
 declare class DateIOService {
+    /**
+     * This is the default range. It approximates the beginning of time to the end of time.
+     * The disabled dates are the dates that are not allowed to be selected.
+     * The min date is the earliest date that can be selected.
+     * The max date is the latest date that can be selected.
+     * Unless a minDate or maxDate is set with the native HTML5 api the range is all dates
+     */
     disabledDates: DateRange;
     cldrLocaleDateFormat: string;
     minDateChange: Subject<DayModel>;
@@ -1751,6 +1764,8 @@ declare class ClrFileMessagesTemplate {
 
 declare class ClrFileList {
     protected readonly fileMessagesTemplate: ClrFileMessagesTemplate;
+    protected injectorCache: Map<File, Injector>;
+    private contextCache;
     private readonly injector;
     private readonly commonStrings;
     private readonly ngControlService;
@@ -1760,7 +1775,8 @@ declare class ClrFileList {
     protected getClearFileLabel(filename: string): string;
     protected clearFile(fileToRemove: File): void;
     protected createFileMessagesTemplateContext(file: File): ClrFileMessagesTemplateContext;
-    protected createFileMessagesTemplateInjector(fileMessagesTemplateContext: ClrFileMessagesTemplateContext): i0.DestroyableInjector;
+    private createFileMessagesTemplateInjector;
+    private errorsEqual;
     static ɵfac: i0.ɵɵFactoryDeclaration<ClrFileList, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ClrFileList, "clr-file-list", never, {}, {}, ["fileMessagesTemplate"], never, false, never>;
 }
@@ -2069,4 +2085,4 @@ declare class ClrFormsModule {
 }
 
 export { AbstractIfState, CHANGE_KEYS, CLR_DATEPICKER_DIRECTIVES, CLR_FILE_MESSAGES_TEMPLATE_CONTEXT, ClrAbstractContainer, ClrCalendar, ClrCheckbox, ClrCheckboxContainer, ClrCheckboxModule, ClrCheckboxWrapper, ClrCombobox, ClrComboboxContainer, ClrComboboxModule, ClrCommonFormsModule, ClrControl, ClrControlContainer, ClrControlError, ClrControlHelper, ClrControlLabel, ClrControlSuccess, ClrDatalist, ClrDatalistContainer, ClrDatalistInput, ClrDatalistModule, ClrDateContainer, ClrDateInput, ClrDateInputBase, ClrDateInputValidator, ClrDatepickerActions, ClrDatepickerModule, ClrDatepickerViewManager, ClrDay, ClrDaypicker, ClrEndDateInput, ClrEndDateInputValidator, ClrFileError, ClrFileInfo, ClrFileInput, ClrFileInputContainer, ClrFileInputModule, ClrFileInputValidator, ClrFileInputValueAccessor, ClrFileList, ClrFileMessagesTemplate, ClrFileSuccess, ClrForm, ClrFormLayout, ClrFormsModule, ClrIfError, ClrIfSuccess, ClrInput, ClrInputContainer, ClrInputModule, ClrLayout, ClrMonthpicker, ClrNumberInput, ClrNumberInputContainer, ClrNumberInputModule, ClrOption, ClrOptionGroup, ClrOptionItems, ClrOptionSelected, ClrOptions, ClrPassword, ClrPasswordContainer, ClrPasswordModule, ClrRadio, ClrRadioContainer, ClrRadioModule, ClrRadioWrapper, ClrRange, ClrRangeContainer, ClrRangeModule, ClrSelect, ClrSelectContainer, ClrSelectModule, ClrStartDateInput, ClrStartDateInputValidator, ClrTextarea, ClrTextareaContainer, ClrTextareaModule, ClrYearpicker, ContainerIdService, ControlClassService, ControlIdService, DatalistIdService, FormsFocusService, IS_TOGGLE, IS_TOGGLE_PROVIDER, LayoutService, MarkControlService, NgControlService, TOGGLE_SERVICE, TOGGLE_SERVICE_PROVIDER, ToggleServiceFactory, WrappedFormControl, buildFileList, clearFiles, isToggleFactory, selectFiles };
-export type { ClrFileAcceptError, ClrFileInputSelection, ClrFileListValidationErrors, ClrFileMaxFileSizeError, ClrFileMessagesTemplateContext, ClrFileMinFileSizeError, ClrSingleFileValidationErrors, Helpers };
+export type { ClrComboboxIdentityFunction, ClrFileAcceptError, ClrFileInputSelection, ClrFileListValidationErrors, ClrFileMaxFileSizeError, ClrFileMessagesTemplateContext, ClrFileMinFileSizeError, ClrSingleFileValidationErrors, Helpers };

package/types/clr-angular-popover-common.d.ts

@@ -1,4 +1,4 @@
-import { ConnectedPosition, OverlayContainer, Overlay } from '@angular/cdk/overlay';
+import { ConnectedPosition, FlexibleConnectedPositionStrategyOrigin, OverlayContainer, Overlay } from '@angular/cdk/overlay';
 import * as i0 from '@angular/core';
 import { ElementRef, OnDestroy, AfterViewInit, ViewContainerRef, TemplateRef, NgZone, OnInit, InjectionToken, EventEmitter } from '@angular/core';
 import { Observable } from 'rxjs';
@@ -32,11 +32,15 @@ declare const SIGNPOST_POSITIONS: ClrPopoverPosition[];
 declare function getPositionsArray(type: ClrPopoverType): ClrPopoverPosition[];
 declare function getConnectedPositions(type: ClrPopoverType): ConnectedPosition[];
 declare function mapPopoverKeyToPosition(key: ClrPopoverPosition, type: ClrPopoverType): ConnectedPosition;
-declare function getAnchorPosition(key: ClrPosition): Partial<ConnectedPosition>;
+declare function getOriginPosition(key: ClrPosition): Partial<ConnectedPosition>;
 declare function getContentPosition(key: ClrPosition): Partial<ConnectedPosition>;
 
+interface ClrPopoverPoint {
+    x: number;
+    y: number;
+}
 declare class ClrPopoverService {
-    anchorElementRef: ElementRef<HTMLElement>;
+    origin: FlexibleConnectedPositionStrategyOrigin;
     closeButtonRef: ElementRef;
     panelClass: string[];
     private _open;
@@ -47,6 +51,8 @@ declare class ClrPopoverService {
     private _resetPositions;
     private _updatePosition;
     private _popoverVisible;
+    get originElement(): ElementRef<HTMLElement> | null;
+    get originPoint(): ClrPopoverPoint | null;
     get openChange(): Observable<boolean>;
     get popoverVisible(): Observable<boolean>;
     get openEvent(): Event;
@@ -63,11 +69,16 @@ declare class ClrPopoverService {
      * This is for instance the case of components that open on a click, but close on a click outside.
      */
     toggleWithEvent(event: any): void;
+    /**
+     * Opens the popover at a specific screen coordinate.
+     * Useful for context menus where the popover should appear at the cursor position.
+     */
+    openAtPoint(point: ClrPopoverPoint): void;
     popoverVisibleEmit(visible: boolean): void;
     resetPositions(): void;
     updatePosition(): void;
     focusCloseButton(): void;
-    focusAnchor(): void;
+    focusOrigin(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ClrPopoverService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ClrPopoverService>;
 }
@@ -107,31 +118,44 @@ declare class ClrPopoverContent implements OnDestroy, AfterViewInit {
     set outsideClickClose(clickToClose: boolean);
     get scrollToClose(): boolean;
     set scrollToClose(scrollToClose: boolean);
+    set contentOrigin(origin: FlexibleConnectedPositionStrategyOrigin);
     private get positionStrategy();
     private get preferredPosition();
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     private _createOverlayRef;
+    /**
+     * Point-based origins (context menus) delay the subscription to avoid the
+     * mouseup from the same right-click that opened the popover.
+     */
+    private createPointBasedOutsideClickSubscription;
+    /**
+     * Element-based origins close on outside clicks and suppress toggle-button
+     * re-clicks so the popover doesn't immediately reopen.
+     */
+    private createElementBasedOutsideClickSubscription;
     private resetPosition;
     private closePopover;
     private showOverlay;
     private removeOverlay;
     private getScrollableParents;
     /**
-     * Uses IntersectionObserver to detect when the anchor leaves the screen.
+     * Uses IntersectionObserver to detect when the origin element leaves the screen.
      * This handles the "Close on Scroll" logic much cheaper than getBoundingClientRect.
      */
     private setupIntersectionObserver;
-    private listenToMouseEvents;
+    private listenToScrollEvents;
+    private listenToScrollForPointOrigin;
+    private listenToScrollForElementOrigin;
     private getRootPopover;
     static ɵfac: i0.ɵɵFactoryDeclaration<ClrPopoverContent, [null, null, { optional: true; }, null, { optional: true; skipSelf: true; }, null, null, null, null]>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<ClrPopoverContent, "[clrPopoverContent]", never, { "open": { "alias": "clrPopoverContent"; "required": false; }; "contentAt": { "alias": "clrPopoverContentAt"; "required": false; }; "availablePositions": { "alias": "clrPopoverContentAvailablePositions"; "required": false; }; "contentType": { "alias": "clrPopoverContentType"; "required": false; }; "outsideClickClose": { "alias": "clrPopoverContentOutsideClickToClose"; "required": false; }; "scrollToClose": { "alias": "clrPopoverContentScrollToClose"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<ClrPopoverContent, "[clrPopoverContent]", never, { "open": { "alias": "clrPopoverContent"; "required": false; }; "contentAt": { "alias": "clrPopoverContentAt"; "required": false; }; "availablePositions": { "alias": "clrPopoverContentAvailablePositions"; "required": false; }; "contentType": { "alias": "clrPopoverContentType"; "required": false; }; "outsideClickClose": { "alias": "clrPopoverContentOutsideClickToClose"; "required": false; }; "scrollToClose": { "alias": "clrPopoverContentScrollToClose"; "required": false; }; "contentOrigin": { "alias": "clrPopoverContentOrigin"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-declare class ClrPopoverAnchor {
+declare class ClrPopoverOrigin {
     constructor(popoverService: ClrPopoverService, element: ElementRef<HTMLButtonElement>);
-    static ɵfac: i0.ɵɵFactoryDeclaration<ClrPopoverAnchor, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<ClrPopoverAnchor, "[clrPopoverAnchor]", never, {}, {}, never, never, false, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClrPopoverOrigin, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<ClrPopoverOrigin, "[clrPopoverOrigin]", never, {}, {}, never, never, false, never>;
 }
 
 declare class ClrStopEscapePropagationDirective implements OnInit, OnDestroy {
@@ -151,7 +175,7 @@ declare class ClrPopoverHostDirective {
     static ɵdir: i0.ɵɵDirectiveDeclaration<ClrPopoverHostDirective, never, never, {}, {}, never, never, true, [{ directive: typeof ClrStopEscapePropagationDirective; inputs: {}; outputs: {}; }]>;
 }
 
-declare const POPOVER_HOST_ANCHOR: InjectionToken<ElementRef<any>>;
+declare const POPOVER_HOST_ORIGIN: InjectionToken<ElementRef<any>>;
 
 /**********
  *
@@ -223,8 +247,9 @@ declare class ClrPopoverOpenCloseButton implements OnDestroy {
 
 declare class ClrPopoverModuleNext {
     static ɵfac: i0.ɵɵFactoryDeclaration<ClrPopoverModuleNext, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<ClrPopoverModuleNext, [typeof ClrPopoverAnchor, typeof ClrPopoverCloseButton, typeof ClrPopoverOpenCloseButton], [typeof ClrPopoverContent, typeof ClrIfOpen], [typeof ClrPopoverAnchor, typeof ClrPopoverCloseButton, typeof ClrPopoverOpenCloseButton, typeof ClrPopoverContent, typeof ClrIfOpen]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<ClrPopoverModuleNext, [typeof ClrPopoverOrigin, typeof ClrPopoverCloseButton, typeof ClrPopoverOpenCloseButton], [typeof ClrPopoverContent, typeof ClrIfOpen], [typeof ClrPopoverOrigin, typeof ClrPopoverCloseButton, typeof ClrPopoverOpenCloseButton, typeof ClrPopoverContent, typeof ClrIfOpen]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<ClrPopoverModuleNext>;
 }
 
-export { ClrIfOpen, ClrPopoverAnchor, ClrPopoverContent, ClrPopoverHostDirective, ClrPopoverPosition, ClrPopoverService, ClrPopoverType, ClrStopEscapePropagationDirective, DROPDOWN_POSITIONS, POPOVER_HOST_ANCHOR, SIGNPOST_POSITIONS, TOOLTIP_POSITIONS, getAnchorPosition, getConnectedPositions, getContentPosition, getPositionsArray, mapPopoverKeyToPosition, ClrPopoverCloseButton as ÇlrClrPopoverCloseButton, ClrPopoverModuleNext as ÇlrClrPopoverModuleNext, ClrPopoverOpenCloseButton as ÇlrClrPopoverOpenCloseButton };
+export { ClrIfOpen, ClrPopoverContent, ClrPopoverHostDirective, ClrPopoverOrigin, ClrPopoverPosition, ClrPopoverService, ClrPopoverType, ClrStopEscapePropagationDirective, DROPDOWN_POSITIONS, POPOVER_HOST_ORIGIN, SIGNPOST_POSITIONS, TOOLTIP_POSITIONS, getConnectedPositions, getContentPosition, getOriginPosition, getPositionsArray, mapPopoverKeyToPosition, ClrPopoverCloseButton as ÇlrClrPopoverCloseButton, ClrPopoverModuleNext as ÇlrClrPopoverModuleNext, ClrPopoverOpenCloseButton as ÇlrClrPopoverOpenCloseButton };
+export type { ClrPopoverPoint };

package/types/clr-angular-popover-dropdown.d.ts

@@ -1,7 +1,7 @@
 import * as i0 from '@angular/core';
 import { OnDestroy, Renderer2, ChangeDetectorRef, AfterContentInit, QueryList, ElementRef, Type } from '@angular/core';
 import * as i1 from '@clr/angular/popover/common';
-import { ClrPopoverService, ClrPopoverContent, ClrPopoverPosition } from '@clr/angular/popover/common';
+import { ClrPopoverService, ClrPopoverPoint, ClrPopoverContent, ClrPopoverPosition } from '@clr/angular/popover/common';
 import { FocusableItem, FocusService } from '@clr/angular/utils';
 import { Observable } from 'rxjs';
 import * as i5 from '@angular/common';
@@ -57,6 +57,7 @@ declare class ClrDropdown implements OnDestroy {
     isMenuClosable: boolean;
     private subscriptions;
     constructor(parent: ClrDropdown, popoverService: ClrPopoverService, focusHandler: DropdownFocusHandler, cdr: ChangeDetectorRef, dropdownService: RootDropdownService);
+    openAtPoint(point: ClrPopoverPoint): void;
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ClrDropdown, [{ optional: true; skipSelf: true; }, null, null, null, null]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ClrDropdown, "clr-dropdown", never, { "isMenuClosable": { "alias": "clrCloseMenuOnItemClick"; "required": false; }; }, {}, never, ["*"], false, [{ directive: typeof i1.ClrPopoverHostDirective; inputs: {}; outputs: {}; }]>;

package/types/clr-angular-popover-signpost.d.ts

@@ -1,9 +1,9 @@
+import * as i8 from '@clr/angular/popover/common';
+import { ClrPopoverService, ClrPopoverPoint, ClrPopoverContent, ClrPopoverPosition } from '@clr/angular/popover/common';
 import * as i7 from '@clr/angular/utils';
 import { ClrCommonStringsService } from '@clr/angular/utils';
 import * as i0 from '@angular/core';
 import { OnDestroy, ElementRef, AfterViewInit, Type } from '@angular/core';
-import * as i8 from '@clr/angular/popover/common';
-import { ClrPopoverService, ClrPopoverContent, ClrPopoverPosition } from '@clr/angular/popover/common';
 import { Observable } from 'rxjs';
 import * as i5 from '@angular/common';
 import * as i6 from '@clr/angular/icon';
@@ -51,6 +51,7 @@ declare class ClrSignpostTrigger implements OnDestroy {
 
 declare class ClrSignpost {
     commonStrings: ClrCommonStringsService;
+    private popoverService;
     /**********
      * @property useCustomTrigger
      *
@@ -60,7 +61,12 @@ declare class ClrSignpost {
      */
     useCustomTrigger: boolean;
     signpostTriggerAriaLabel: string;
-    constructor(commonStrings: ClrCommonStringsService);
+    /**
+     * Hides the default trigger button. Use when the signpost is opened
+     * programmatically via `openAtPoint()` and no trigger icon is needed.
+     */
+    hideTrigger: boolean;
+    constructor(commonStrings: ClrCommonStringsService, popoverService: ClrPopoverService);
     /**********
      * @property signPostTrigger
      *
@@ -69,8 +75,10 @@ declare class ClrSignpost {
      *
      */
     set customTrigger(trigger: ClrSignpostTrigger);
+    get showDefaultTrigger(): boolean;
+    openAtPoint(point: ClrPopoverPoint): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ClrSignpost, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ClrSignpost, "clr-signpost", never, { "signpostTriggerAriaLabel": { "alias": "clrSignpostTriggerAriaLabel"; "required": false; }; }, {}, ["customTrigger"], ["*"], false, [{ directive: typeof i8.ClrPopoverHostDirective; inputs: {}; outputs: {}; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ClrSignpost, "clr-signpost", never, { "signpostTriggerAriaLabel": { "alias": "clrSignpostTriggerAriaLabel"; "required": false; }; "hideTrigger": { "alias": "clrSignpostHideTrigger"; "required": false; }; }, {}, ["customTrigger"], ["*"], false, [{ directive: typeof i8.ClrPopoverHostDirective; inputs: {}; outputs: {}; }]>;
 }
 
 declare class ClrSignpostContent implements OnDestroy, AfterViewInit {
@@ -90,8 +98,8 @@ declare class ClrSignpostContent implements OnDestroy, AfterViewInit {
      *
      * @description
      * A setter for the position of the ClrSignpostContent popover. This is a combination of the following:
-     * - anchorPoint - where on the trigger to anchor the ClrSignpostContent
-     * - popoverPoint - where on the ClrSignpostContent container to align with the anchorPoint
+     * - originPoint - where on the trigger to position the content
+     * - popoverPoint - where on the content container to align with the origin
      * - offsetY - where on the Y axis to align the ClrSignpostContent so it meets specs
      * - offsetX - where on the X axis to align the ClrSignpostContent so it meets specs
      * There are 12 possible positions to place a ClrSignpostContent container: