igniteui-angular 19.0.6 → 19.1.0-beta.0

package/lib/query-builder/public_api.d.ts

@@ -1,5 +1,7 @@
 import { IgxQueryBuilderHeaderComponent } from './query-builder-header.component';
 import { IgxQueryBuilderComponent } from './query-builder.component';
+import { IgxQueryBuilderSearchValueTemplateDirective } from './query-builder.directives';
 export { IgxQueryBuilderComponent } from './query-builder.component';
 export * from './query-builder-header.component';
-export declare const IGX_QUERY_BUILDER_DIRECTIVES: readonly [typeof IgxQueryBuilderComponent, typeof IgxQueryBuilderHeaderComponent];
+export * from './query-builder.directives';
+export declare const IGX_QUERY_BUILDER_DIRECTIVES: readonly [typeof IgxQueryBuilderComponent, typeof IgxQueryBuilderHeaderComponent, typeof IgxQueryBuilderSearchValueTemplateDirective];

package/lib/query-builder/query-builder-header.component.d.ts

@@ -11,15 +11,6 @@ export declare class IgxQueryBuilderHeaderComponent {
      * ```
      */
     title: string;
-    /**
-     * Show/hide the legend.
-     *
-     * @example
-     * ```html
-     * <igx-query-builder-header [showLegend]="false"></igx-query-builder-header>
-     * ```
-     */
-    showLegend: boolean;
     /**
      * Sets the resource strings.
      * By default it uses EN resources.
@@ -30,6 +21,5 @@ export declare class IgxQueryBuilderHeaderComponent {
      */
     get resourceStrings(): IQueryBuilderResourceStrings;
     static ɵfac: i0.ɵɵFactoryDeclaration<IgxQueryBuilderHeaderComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<IgxQueryBuilderHeaderComponent, "igx-query-builder-header", never, { "title": { "alias": "title"; "required": false; }; "showLegend": { "alias": "showLegend"; "required": false; }; "resourceStrings": { "alias": "resourceStrings"; "required": false; }; }, {}, never, ["*"], true, never>;
-    static ngAcceptInputType_showLegend: unknown;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IgxQueryBuilderHeaderComponent, "igx-query-builder-header", never, { "title": { "alias": "title"; "required": false; }; "resourceStrings": { "alias": "resourceStrings"; "required": false; }; }, {}, never, ["*"], true, never>;
 }

package/lib/query-builder/query-builder-tree.component.d.ts

@@ -0,0 +1,565 @@
+import { AfterViewInit, EventEmitter, PipeTransform, TemplateRef } from '@angular/core';
+import { ChangeDetectorRef, ElementRef, OnDestroy } from '@angular/core';
+import { IgxChipComponent } from '../chips/chip.component';
+import { IQueryBuilderResourceStrings } from '../core/i18n/query-builder-resources';
+import { PlatformUtil } from '../core/utils';
+import { FilteringLogic, IFilteringExpression } from '../data-operations/filtering-expression.interface';
+import { IExpressionTree, IFilteringExpressionsTree } from '../data-operations/filtering-expressions-tree';
+import { IgxOverlayOutletDirective } from '../directives/toggle/toggle.directive';
+import { FieldType, EntityType } from '../grids/common/grid.interface';
+import { IgxSelectComponent } from '../select/select.component';
+import { OverlaySettings } from '../services/overlay/utilities';
+import { IgxQueryBuilderHeaderComponent } from './query-builder-header.component';
+import { IComboSelectionChangingEventArgs } from "../combo/combo.component";
+import { IChangeCheckboxEventArgs } from "../checkbox/checkbox.component";
+import { ISelectionEventArgs } from '../drop-down/drop-down.common';
+import { IgxQueryBuilderSearchValueTemplateDirective } from './query-builder.directives';
+import { IgxQueryBuilderComponent } from './query-builder.component';
+import * as i0 from "@angular/core";
+export declare class IgxFieldFormatterPipe implements PipeTransform {
+    transform(value: any, formatter: (v: any, data: any, fieldData?: any) => any, rowData: any, fieldData?: any): any;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IgxFieldFormatterPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<IgxFieldFormatterPipe, "fieldFormatter", true>;
+}
+/**
+ * @hidden @internal
+ *
+ * Internal class usage
+ */
+declare class ExpressionItem {
+    parent: ExpressionGroupItem;
+    expanded: boolean;
+    constructor(parent?: ExpressionGroupItem);
+}
+/**
+ * @hidden @internal
+ *
+ * Internal class usage
+ */
+declare class ExpressionGroupItem extends ExpressionItem {
+    operator: FilteringLogic;
+    children: ExpressionItem[];
+    constructor(operator: FilteringLogic, parent?: ExpressionGroupItem);
+}
+/**
+ * @hidden @internal
+ *
+ * Internal class usage
+ */
+declare class ExpressionOperandItem extends ExpressionItem {
+    expression: IFilteringExpression;
+    inEditMode: boolean;
+    inAddMode: boolean;
+    hovered: boolean;
+    focused: boolean;
+    fieldLabel: string;
+    constructor(expression: IFilteringExpression, parent: ExpressionGroupItem);
+}
+/** @hidden */
+export declare class IgxQueryBuilderTreeComponent implements AfterViewInit, OnDestroy {
+    cdr: ChangeDetectorRef;
+    protected platform: PlatformUtil;
+    protected el: ElementRef;
+    private elRef;
+    protected _localeId: string;
+    /**
+     * @hidden @internal
+     */
+    get getClass(): string;
+    /**
+     * Sets/gets the entities.
+     */
+    entities: EntityType[];
+    /**
+     * Sets/gets the parent query builder component.
+     */
+    queryBuilder: IgxQueryBuilderComponent;
+    /**
+     * Sets/gets the search value template.
+     */
+    searchValueTemplate: TemplateRef<IgxQueryBuilderSearchValueTemplateDirective>;
+    /**
+    * Returns the parent expression operand.
+    */
+    get parentExpression(): ExpressionOperandItem;
+    /**
+     * Sets the parent expression operand.
+     */
+    set parentExpression(value: ExpressionOperandItem);
+    /**
+    * Returns the fields.
+    */
+    get fields(): FieldType[];
+    /**
+     * Sets the fields.
+     */
+    set fields(fields: FieldType[]);
+    /**
+    * Returns the expression tree.
+    */
+    get expressionTree(): IExpressionTree;
+    /**
+     * Sets the expression tree.
+     */
+    set expressionTree(expressionTree: IExpressionTree);
+    /**
+     * Gets the `locale` of the query builder.
+     * If not set, defaults to application's locale.
+     */
+    get locale(): string;
+    /**
+     * Sets the `locale` of the query builder.
+     * Expects a valid BCP 47 language tag.
+     */
+    set locale(value: string);
+    /**
+     * Sets the resource strings.
+     * By default it uses EN resources.
+     */
+    set resourceStrings(value: IQueryBuilderResourceStrings);
+    /**
+     * Returns the resource strings.
+     */
+    get resourceStrings(): IQueryBuilderResourceStrings;
+    /**
+     * Event fired as the expression tree is changed.
+     */
+    expressionTreeChange: EventEmitter<IExpressionTree>;
+    /**
+     * Event fired if a nested query builder tree is being edited.
+     */
+    inEditModeChange: EventEmitter<ExpressionOperandItem>;
+    protected entitySelect: IgxSelectComponent;
+    private returnFieldsCombo;
+    protected returnFieldSelect: IgxSelectComponent;
+    private fieldSelect;
+    private conditionSelect;
+    private searchValueInput;
+    private picker;
+    private addRootAndGroupButton;
+    private addConditionButton;
+    private entityChangeDialog;
+    private addExpressionItemDropDown;
+    private groupContextMenuDropDown;
+    private expressionsChips;
+    /**
+     * @hidden @internal
+     */
+    headerContent: IgxQueryBuilderHeaderComponent;
+    protected set editingInputsContainer(value: ElementRef);
+    /** @hidden */
+    protected get editingInputsContainer(): ElementRef;
+    protected set currentGroupButtonsContainer(value: ElementRef);
+    /** @hidden */
+    protected get currentGroupButtonsContainer(): ElementRef;
+    private expressionsContainer;
+    private overlayOutlet;
+    private innerQueries;
+    /**
+     * @hidden @internal
+     */
+    innerQueryNewExpressionTree: IExpressionTree;
+    /**
+     * @hidden @internal
+     */
+    rootGroup: ExpressionGroupItem;
+    /**
+     * @hidden @internal
+     */
+    selectedExpressions: ExpressionOperandItem[];
+    /**
+     * @hidden @internal
+     */
+    currentGroup: ExpressionGroupItem;
+    /**
+     * @hidden @internal
+     */
+    contextualGroup: ExpressionGroupItem;
+    /**
+     * @hidden @internal
+     */
+    filteringLogics: any;
+    /**
+     * @hidden @internal
+     */
+    selectedCondition: string;
+    /**
+     * @hidden @internal
+     */
+    searchValue: {
+        value: any;
+    };
+    /**
+     * @hidden @internal
+     */
+    pickerOutlet: IgxOverlayOutletDirective | ElementRef;
+    /**
+     * @hidden @internal
+     */
+    prevFocusedExpression: ExpressionOperandItem;
+    /**
+     * @hidden @internal
+     */
+    initialOperator: number;
+    /**
+     * @hidden @internal
+     */
+    returnFieldSelectOverlaySettings: OverlaySettings;
+    /**
+     * @hidden @internal
+     */
+    entitySelectOverlaySettings: OverlaySettings;
+    /**
+     * @hidden @internal
+     */
+    fieldSelectOverlaySettings: OverlaySettings;
+    /**
+     * @hidden @internal
+     */
+    conditionSelectOverlaySettings: OverlaySettings;
+    /**
+     * @hidden @internal
+     */
+    addExpressionDropDownOverlaySettings: OverlaySettings;
+    /**
+     * @hidden @internal
+     */
+    groupContextMenuDropDownOverlaySettings: OverlaySettings;
+    private destroy$;
+    private _timeoutId;
+    private _lastFocusedChipIndex;
+    private _focusDelay;
+    private _parentExpression;
+    private _selectedEntity;
+    private _selectedReturnFields;
+    private _selectedField;
+    private _editingInputsContainer;
+    private _currentGroupButtonsContainer;
+    private _addModeExpression;
+    private _editedExpression;
+    private _preventInit;
+    private _prevFocusedContainer;
+    private _expandedExpressions;
+    private _fields;
+    private _expressionTree;
+    private _locale;
+    private _entityNewValue;
+    private _resourceStrings;
+    /**
+     * Disables the select entity dropdown at the root level after the initial selection.
+     */
+    get disableEntityChange(): boolean;
+    get level(): number;
+    private _positionSettings;
+    private _overlaySettings;
+    /** @hidden */
+    protected isAdvancedFiltering(): boolean;
+    /** @hidden */
+    protected isSearchValueInputDisabled(): boolean;
+    constructor(cdr: ChangeDetectorRef, platform: PlatformUtil, el: ElementRef, elRef: ElementRef, _localeId: string);
+    /**
+     * @hidden @internal
+     */
+    ngAfterViewInit(): void;
+    /**
+     * @hidden @internal
+     */
+    ngOnDestroy(): void;
+    /**
+     * @hidden @internal
+     */
+    set selectedEntity(value: string);
+    /**
+     * @hidden @internal
+     */
+    get selectedEntity(): EntityType;
+    /**
+     * @hidden @internal
+     */
+    onEntitySelectChanging(event: ISelectionEventArgs): void;
+    /**
+     * @hidden
+     */
+    onShowEntityChangeDialogChange(eventArgs: IChangeCheckboxEventArgs): void;
+    /**
+     * @hidden
+     */
+    onEntityChangeCancel(): void;
+    /**
+     * @hidden
+     */
+    onEntityChangeConfirm(): void;
+    /**
+     * @hidden @internal
+     */
+    set selectedReturnFields(value: string[]);
+    /**
+     * @hidden @internal
+     */
+    get selectedReturnFields(): string[];
+    /**
+     * @hidden @internal
+     */
+    set selectedField(value: FieldType);
+    /**
+     * @hidden @internal
+     */
+    get selectedField(): FieldType;
+    /**
+     * @hidden @internal
+     *
+     * used by the grid
+     */
+    setPickerOutlet(outlet?: IgxOverlayOutletDirective | ElementRef): void;
+    /**
+     * @hidden @internal
+     *
+     * used by the grid
+     */
+    get isContextMenuVisible(): boolean;
+    /**
+     * @hidden @internal
+     */
+    get hasEditedExpression(): boolean;
+    /**
+     * @hidden @internal
+     */
+    addCondition(parent: ExpressionGroupItem, afterExpression?: ExpressionOperandItem, isUIInteraction?: boolean): void;
+    /**
+     * @hidden @internal
+     */
+    addReverseGroup(parent?: ExpressionGroupItem, afterExpression?: ExpressionItem): void;
+    /**
+     * @hidden @internal
+     */
+    endGroup(groupItem: ExpressionGroupItem): void;
+    /**
+     * @hidden @internal
+     */
+    commitExpression(): void;
+    /**
+     * @hidden @internal
+     */
+    discardExpression(expressionItem?: ExpressionOperandItem): void;
+    /**
+     * @hidden @internal
+     */
+    commitOperandEdit(): void;
+    /**
+     * @hidden @internal
+     */
+    cancelOperandAdd(): void;
+    /**
+     * @hidden @internal
+     */
+    cancelOperandEdit(): void;
+    /**
+     * @hidden @internal
+     */
+    operandCanBeCommitted(): boolean;
+    /**
+     * @hidden @internal
+     */
+    canCommitCurrentState(): boolean;
+    /**
+     * @hidden @internal
+     */
+    commitCurrentState(): void;
+    /**
+     * @hidden @internal
+     */
+    exitEditAddMode(shouldPreventInit?: boolean): void;
+    /**
+     * @hidden @internal
+     *
+     * used by the grid
+     */
+    exitOperandEdit(): void;
+    /**
+     * @hidden @internal
+     */
+    isExpressionGroup(expression: ExpressionItem): boolean;
+    /**
+     * @hidden @internal
+     */
+    onExpressionFocus(expressionItem: ExpressionOperandItem): void;
+    /**
+     * @hidden @internal
+     */
+    onExpressionBlur(event: any, expressionItem: ExpressionOperandItem): void;
+    /**
+     * @hidden @internal
+     */
+    onChipRemove(expressionItem: ExpressionItem): void;
+    sourceExpressionItem: ExpressionItem;
+    sourceElement: HTMLElement;
+    targetExpressionItem: ExpressionItem;
+    targetElement: HTMLElement;
+    dropUnder: boolean;
+    dropGhostChipNode: Node;
+    private ghostChipMousemoveSubscription$;
+    private keyboardSubscription$;
+    private keyDragOffsetIndex;
+    private keyDragFirstMove;
+    private isKeyboardDrag;
+    private dropZonesList;
+    private expressionsList;
+    private dropGhostClass;
+    private get dragGhostElement();
+    private get dropGhostElement();
+    private get mainExpressionTree();
+    canBeDragged(): boolean;
+    onMoveStart(sourceDragElement: HTMLElement, sourceExpressionItem: ExpressionItem, isKeyboardDrag: boolean): void;
+    onMoveEnd(): void;
+    onDivEnter(targetDragElement: HTMLElement, targetExpressionItem: ExpressionItem): void;
+    onChipEnter(targetDragElement: HTMLElement, targetExpressionItem: ExpressionItem, fromDiv: boolean): void;
+    onDivOver(targetDragElement: HTMLElement, targetExpressionItem: ExpressionItem): void;
+    onChipOver(targetDragElement: HTMLElement, fromDiv: boolean): void;
+    onChipLeave(): void;
+    onDivDropped(targetExpressionItem: ExpressionItem): void;
+    onChipDropped(): void;
+    onGroupRootOver(targetDragElement: HTMLElement, targetExpressionItem: ExpressionGroupItem): void;
+    onAddConditionEnter(addConditionElement: HTMLElement, rootGroup: ExpressionGroupItem): void;
+    onAddConditionLeave(): void;
+    private dragGhostIsOnDropGhostRow;
+    private ghostInLowerPart;
+    private createDropGhost;
+    private renderDropGhostChip;
+    private setDragCursor;
+    private moveDraggedChipToNewLocation;
+    private resetDragAndDrop;
+    private listenToKeyboard;
+    private arrowDrag;
+    private getPreviousChip;
+    private getNextChip;
+    private getListedExpressions;
+    private getListedDropZones;
+    onChipDragIndicatorFocus(sourceDragElement: HTMLElement, sourceExpressionItem: ExpressionItem): void;
+    onChipDragIndicatorFocusOut(): void;
+    onDragFocusOut(): void;
+    /**
+     * @hidden @internal
+     */
+    addExpressionBlur(): void;
+    /**
+     * @hidden @internal
+     */
+    onChipClick(expressionItem: ExpressionOperandItem, chip: IgxChipComponent): void;
+    /**
+     * @hidden @internal
+     */
+    enterExpressionEdit(expressionItem: ExpressionOperandItem, chip?: IgxChipComponent): void;
+    /**
+     * @hidden @internal
+     */
+    clickExpressionAdd(targetButton: HTMLElement, chip: IgxChipComponent): void;
+    /**
+     * @hidden @internal
+     */
+    openExpressionAddDialog(targetButton: HTMLElement): void;
+    /**
+     * @hidden @internal
+     */
+    enterExpressionAdd(event: ISelectionEventArgs, expressionItem: ExpressionOperandItem): void;
+    /**
+     * @hidden @internal
+     */
+    enterEditMode(expressionItem: ExpressionOperandItem): void;
+    /**
+     * @hidden @internal
+     */
+    onConditionSelectChanging(event: ISelectionEventArgs): void;
+    /**
+     * @hidden @internal
+     */
+    onKeyDown(eventArgs: KeyboardEvent): void;
+    /**
+     * @hidden @internal
+     */
+    onGroupClick(groupContextMenuDropDown: any, targetButton: HTMLButtonElement, groupItem: ExpressionGroupItem): void;
+    /**
+     * @hidden @internal
+     */
+    getOperator(expressionItem: any): any;
+    /**
+     * @hidden @internal
+     */
+    getSwitchGroupText(expressionItem: any): string;
+    /**
+     * @hidden @internal
+     */
+    onGroupContextMenuDropDownSelectionChanging(event: ISelectionEventArgs): void;
+    /**
+     * @hidden @internal
+     */
+    ungroup(): void;
+    /**
+     * @hidden @internal
+     */
+    selectFilteringLogic(index: number): void;
+    /**
+     * @hidden @internal
+     */
+    getConditionFriendlyName(name: string): string;
+    /**
+     * @hidden @internal
+     */
+    isDate(value: any): value is Date;
+    /**
+     * @hidden @internal
+     */
+    invokeClick(eventArgs: KeyboardEvent): void;
+    /**
+     * @hidden @internal
+     */
+    openPicker(args: KeyboardEvent): void;
+    /**
+     * @hidden @internal
+     */
+    onOutletPointerDown(event: any): void;
+    /**
+     * @hidden @internal
+     */
+    getConditionList(): string[];
+    /**
+     * @hidden @internal
+     */
+    getFormatter(field: string): (value: any, rowData?: any) => any;
+    /**
+     * @hidden @internal
+     */
+    getFormat(field: string): string;
+    /**
+     * @hidden @internal
+     *
+     * used by the grid
+     */
+    setAddButtonFocus(): void;
+    /**
+     * @hidden @internal
+     */
+    context(expression: ExpressionItem, afterExpression?: ExpressionItem): {
+        $implicit: ExpressionItem;
+        afterExpression: ExpressionItem;
+    };
+    formatReturnFields(innerTree: IFilteringExpressionsTree): string;
+    isInEditMode(): boolean;
+    onInEditModeChanged(expressionItem: ExpressionOperandItem): void;
+    getExpressionTreeCopy(expressionTree: IExpressionTree, shouldAssignInnerQueryExprTree?: boolean): IExpressionTree;
+    onSelectAllClicked(_event: any): void;
+    onReturnFieldSelectChanging(event: IComboSelectionChangingEventArgs | ISelectionEventArgs): void;
+    initExpressionTree(selectedEntityName: string, selectedReturnFields: string[]): void;
+    getSearchValueTemplateContext(defaultSearchValueTemplate: any): any;
+    private setFormat;
+    private setFilters;
+    private addGroup;
+    private createExpressionGroupItem;
+    private createExpressionTreeFromGroupItem;
+    private deleteItem;
+    private scrollElementIntoView;
+    private focusEditedExpressionChip;
+    private init;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IgxQueryBuilderTreeComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IgxQueryBuilderTreeComponent, "igx-query-builder-tree", never, { "entities": { "alias": "entities"; "required": false; }; "queryBuilder": { "alias": "queryBuilder"; "required": false; }; "searchValueTemplate": { "alias": "searchValueTemplate"; "required": false; }; "parentExpression": { "alias": "parentExpression"; "required": false; }; "fields": { "alias": "fields"; "required": false; }; "expressionTree": { "alias": "expressionTree"; "required": false; }; "locale": { "alias": "locale"; "required": false; }; "resourceStrings": { "alias": "resourceStrings"; "required": false; }; }, { "expressionTreeChange": "expressionTreeChange"; "inEditModeChange": "inEditModeChange"; }, ["headerContent"], never, true, never>;
+}
+export {};