primeng 18.0.5-lts → 18.0.7-lts

package/LICENSE.md

@@ -35,7 +35,7 @@ The term “Software” includes all source and object code, in whole and/or par
 - Can be used on unlimited sites and servers
 - Source-code cannot be resold or distributed
 - Commercial use allowed
-- Can modify source-code but cannot distribute modifications (derivative works)
+- Can modify source-code but can only distribute the source-code or modifications thereto when integrated with a larger work
 
 ## Terms and Conditions
 
@@ -50,8 +50,8 @@ The term “Software” includes all source and object code, in whole and/or par
         5. Modify Software to suit Licensee’s needs and specifications.
 
     2. **Non Assignable and Non-Transferable:** Licensee may not assign or transfer his rights and duties under this license.
-    3. **Commercial, Royalty Free:** Licensee may use Software for any purpose, including paid-services, without any royalties
-    4. **Including the Right to Create Derivative Works:** Licensee may create derivative works based on Software, including amending Software’s source code, modifying it, integrating it into a larger work or removing portions of Software, as long as no distribution of the derivative works is made
+    3. **Commercial, Royalty Free:** Licensee may use Software for any purpose, including paid-services, without any royalties.
+    4. **Including the Right to Create Derivative Works:** Licensee may create derivative works based on Software, including amending Software’s source code, modifying it, integrating it into a larger work or removing portions of Software, provided that there shall be no distribution of Software or modifications thereto unless integrated into a larger work.
 
 2. **Term & Termination:** The Term of this license shall be until terminated. Licensor may terminate this Agreement, including Licensee’s license in the case where Licensee :
     1. became insolvent or otherwise entered into any liquidation process; or

package/api/translation.d.ts

@@ -134,4 +134,5 @@ export interface Aria {
     removeLabel?: string;
     browseFiles?: string;
     maximizeLabel?: string;
+    minimizeLabel?: string;
 }

package/autocomplete/autocomplete.d.ts

@@ -341,7 +341,7 @@ export declare class AutoComplete extends BaseComponent implements AfterViewChec
      * Property name or getter function to use as the disabled flag of an option, defaults to false when not defined.
      * @group Props
      */
-    optionDisabled: string | undefined;
+    optionDisabled: string | ((item: any) => string) | undefined;
     /**
      * When enabled, the hovered option will be focused.
      * @group Props

package/chips/chips.d.ts

@@ -0,0 +1,237 @@
+import { AfterContentInit, ChangeDetectorRef, ElementRef, EventEmitter, QueryList, TemplateRef } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+import { Nullable } from 'primeng/ts-helpers';
+import { ChipsAddEvent, ChipsClickEvent, ChipsContextMenuEvent, ChipsRemoveEvent } from './chips.interface';
+import { PrimeNG } from 'primeng/config';
+import { ChipsStyle } from './style/chipsstyle';
+import { BaseComponent } from 'primeng/basecomponent';
+import * as i0 from "@angular/core";
+import * as i1 from "primeng/api";
+export declare const CHIPS_VALUE_ACCESSOR: any;
+/**
+ * Chips groups a collection of contents in tabs.
+ * @group Components
+ */
+export declare class Chips extends BaseComponent implements AfterContentInit, ControlValueAccessor {
+    el: ElementRef;
+    cd: ChangeDetectorRef;
+    config: PrimeNG;
+    /**
+     * Inline style of the element.
+     * @group Props
+     */
+    style: {
+        [klass: string]: any;
+    } | null | undefined;
+    /**
+     * Style class of the element.
+     * @group Props
+     */
+    styleClass: string | undefined;
+    /**
+     * When present, it specifies that the element should be disabled.
+     * @group Props
+     */
+    disabled: boolean | undefined;
+    /**
+     * Name of the property to display on a chip.
+     * @group Props
+     */
+    field: string | undefined;
+    /**
+     * Advisory information to display on input.
+     * @group Props
+     */
+    placeholder: string | undefined;
+    /**
+     * Maximum number of entries allowed.
+     * @group Props
+     */
+    max: number | undefined;
+    /**
+     * Maximum length of a chip.
+     * @group Props
+     */
+    maxLength: number | undefined;
+    /**
+     * Defines a string that labels the input for accessibility.
+     * @group Props
+     */
+    ariaLabel: string | undefined;
+    /**
+     * Establishes relationships between the component and label(s) where its value should be one or more element IDs.
+     * @group Props
+     */
+    ariaLabelledBy: string | undefined;
+    /**
+     * Index of the element in tabbing order.
+     * @group Props
+     */
+    tabindex: number | undefined;
+    /**
+     * Identifier of the focus input to match a label defined for the component.
+     * @group Props
+     */
+    inputId: string | undefined;
+    /**
+     * Whether to allow duplicate values or not.
+     * @group Props
+     */
+    allowDuplicate: boolean;
+    /**
+     * Defines whether duplication check should be case-sensitive
+     * @group Props
+     */
+    caseSensitiveDuplication: boolean;
+    /**
+     * Inline style of the input field.
+     * @group Props
+     */
+    inputStyle: {
+        [klass: string]: any;
+    } | null | undefined;
+    /**
+     * Style class of the input field.
+     * @group Props
+     */
+    inputStyleClass: string | undefined;
+    /**
+     * Icon to display in chip remove action..
+     * @group Props
+     */
+    chipIcon: string | undefined;
+    /**
+     * Whether to add an item on tab key press.
+     * @group Props
+     */
+    addOnTab: boolean | undefined;
+    /**
+     * Whether to add an item when the input loses focus.
+     * @group Props
+     */
+    addOnBlur: boolean | undefined;
+    /**
+     * Separator char to add an item when pressed in addition to the enter key.
+     * @group Props
+     */
+    separator: string | RegExp | undefined;
+    /**
+     * When enabled, a clear icon is displayed to clear the value.
+     * @group Props
+     */
+    showClear: boolean;
+    /**
+     * When present, it specifies that the component should automatically get focus on load.
+     * @group Props
+     */
+    autofocus: boolean | undefined;
+    /**
+     * Specifies the input variant of the component.
+     * @group Props
+     */
+    variant: 'filled' | 'outlined';
+    /**
+     * Callback to invoke on chip add.
+     * @param {ChipsAddEvent} event - Custom chip add event.
+     * @group Emits
+     */
+    onAdd: EventEmitter<ChipsAddEvent>;
+    /**
+     * Callback to invoke on chip remove.
+     * @param {ChipsRemoveEvent} event - Custom chip remove event.
+     * @group Emits
+     */
+    onRemove: EventEmitter<ChipsRemoveEvent>;
+    /**
+     * Callback to invoke on focus of input field.
+     * @param {Event} event - Browser event.
+     * @group Emits
+     */
+    onFocus: EventEmitter<Event>;
+    /**
+     * Callback to invoke on blur of input field.
+     * @param {Event} event - Browser event.
+     * @group Emits
+     */
+    onBlur: EventEmitter<Event>;
+    /**
+     * Callback to invoke on chip clicked.
+     * @param {ChipsClickEvent} event - Custom chip click event.
+     * @group Emits
+     */
+    onChipClick: EventEmitter<ChipsClickEvent>;
+    /**
+     * Callback to invoke on chip contextmenu.
+     * @param {ChipsClickEvent} event - Custom chip contextmenu event.
+     * @group Emits
+     */
+    onChipContextMenu: EventEmitter<ChipsContextMenuEvent>;
+    /**
+     * Callback to invoke on clear token clicked.
+     * @group Emits
+     */
+    onClear: EventEmitter<any>;
+    inputViewChild: ElementRef;
+    containerViewChild: ElementRef;
+    templates: QueryList<any>;
+    itemTemplate: Nullable<TemplateRef<any>>;
+    removeTokenIconTemplate: Nullable<TemplateRef<any>>;
+    clearIconTemplate: Nullable<TemplateRef<any>>;
+    value: any;
+    onModelChange: Function;
+    onModelTouched: Function;
+    valueChanged: Nullable<boolean>;
+    id: string;
+    focused: Nullable<boolean>;
+    focusedIndex: Nullable<number>;
+    filled: Nullable<boolean>;
+    _componentStyle: ChipsStyle;
+    get focusedOptionId(): string;
+    get isMaxedOut(): boolean;
+    constructor(el: ElementRef, cd: ChangeDetectorRef, config: PrimeNG);
+    ngAfterContentInit(): void;
+    onWrapperClick(): void;
+    onContainerFocus(): void;
+    onContainerBlur(): void;
+    onContainerKeyDown(event: any): void;
+    onArrowLeftKeyOn(): void;
+    onArrowRightKeyOn(): void;
+    onBackspaceKeyOn(event: any): void;
+    onInput(): void;
+    onPaste(event: any): void;
+    updateFilledState(): void;
+    onItemClick(event: Event, item: any): void;
+    onItemContextMenu(event: Event, item: any): void;
+    writeValue(value: any): void;
+    registerOnChange(fn: Function): void;
+    registerOnTouched(fn: Function): void;
+    setDisabledState(val: boolean): void;
+    resolveFieldData(data: any, field: string): any;
+    onInputFocus(event: FocusEvent): void;
+    onInputBlur(event: FocusEvent): void;
+    removeItem(event: Event, index: number): void;
+    addItem(event: Event, item: string, preventDefault: boolean): void;
+    /**
+     * Callback to invoke on filter reset.
+     * @group Method
+     */
+    clear(): void;
+    onKeyDown(event: any): void;
+    updateMaxedOut(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<Chips, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<Chips, "p-chips", never, { "style": { "alias": "style"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "field": { "alias": "field"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "max": { "alias": "max"; "required": false; }; "maxLength": { "alias": "maxLength"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; }; "tabindex": { "alias": "tabindex"; "required": false; }; "inputId": { "alias": "inputId"; "required": false; }; "allowDuplicate": { "alias": "allowDuplicate"; "required": false; }; "caseSensitiveDuplication": { "alias": "caseSensitiveDuplication"; "required": false; }; "inputStyle": { "alias": "inputStyle"; "required": false; }; "inputStyleClass": { "alias": "inputStyleClass"; "required": false; }; "chipIcon": { "alias": "chipIcon"; "required": false; }; "addOnTab": { "alias": "addOnTab"; "required": false; }; "addOnBlur": { "alias": "addOnBlur"; "required": false; }; "separator": { "alias": "separator"; "required": false; }; "showClear": { "alias": "showClear"; "required": false; }; "autofocus": { "alias": "autofocus"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; }, { "onAdd": "onAdd"; "onRemove": "onRemove"; "onFocus": "onFocus"; "onBlur": "onBlur"; "onChipClick": "onChipClick"; "onChipContextMenu": "onChipContextMenu"; "onClear": "onClear"; }, ["templates"], never, true, never>;
+    static ngAcceptInputType_disabled: unknown;
+    static ngAcceptInputType_max: unknown;
+    static ngAcceptInputType_tabindex: unknown;
+    static ngAcceptInputType_allowDuplicate: unknown;
+    static ngAcceptInputType_caseSensitiveDuplication: unknown;
+    static ngAcceptInputType_addOnTab: unknown;
+    static ngAcceptInputType_addOnBlur: unknown;
+    static ngAcceptInputType_showClear: unknown;
+    static ngAcceptInputType_autofocus: unknown;
+}
+export declare class ChipsModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<ChipsModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<ChipsModule, never, [typeof Chips, typeof i1.SharedModule], [typeof Chips, typeof i1.SharedModule]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<ChipsModule>;
+}

package/chips/chips.interface.d.ts

@@ -0,0 +1,66 @@
+import { TemplateRef } from '@angular/core';
+/**
+ * Custom add event.
+ * @see {@link Chips.onAdd}
+ * @group Events
+ */
+export interface ChipsAddEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent: Event;
+    /**
+     * Added/Removed item value.
+     */
+    value: any;
+}
+/**
+ * Custom remove event.
+ * @see {@link Chips.onRemove}
+ * @extends {ChipsAddEvent}
+ * @group Events
+ */
+export interface ChipsRemoveEvent extends ChipsAddEvent {
+}
+/**
+ * Custom click event.
+ * @see {@link Chips.onChipClick}
+ * @extends {ChipsAddEvent}
+ * @group Events
+ */
+export interface ChipsClickEvent extends ChipsAddEvent {
+}
+/**
+ * Custom contextmenu event.
+ * @see {@link Chips.onChipContextMenu}
+ * @extends {ChipsAddEvent}
+ * @group Events
+ */
+export interface ChipsContextMenuEvent extends ChipsAddEvent {
+}
+/**
+ * Defines valid templates in Chips.
+ * @group Templates
+ */
+export interface ChipsTemplates {
+    /**
+     * Custom item template.
+     * @param {Object} context - item data.
+     */
+    item(context: {
+        /**
+         * Value of the chip element.
+         */
+        $implicit: any;
+    }): TemplateRef<{
+        $implicit: any;
+    }>;
+    /**
+     * Custom remove icon template.
+     */
+    removetokenicon(): TemplateRef<any>;
+    /**
+     * Custom clear icon template.
+     */
+    clearicon(): TemplateRef<any>;
+}

package/chips/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generated bundle index. Do not edit.
+ */
+/// <amd-module name="primeng/chips" />
+export * from './public_api';

package/chips/public_api.d.ts

@@ -0,0 +1,2 @@
+export * from './chips';
+export * from './chips.interface';

package/chips/style/chipsstyle.d.ts

@@ -0,0 +1,69 @@
+import { BaseStyle } from 'primeng/base';
+import * as i0 from "@angular/core";
+export declare class ChipsStyle extends BaseStyle {
+    name: string;
+    theme: ({ dt }: {
+        dt: any;
+    }) => string;
+    classes: {
+        root: ({ instance, props }: {
+            instance: any;
+            props: any;
+        }) => (string | {
+            'p-disabled': any;
+            'p-invalid': any;
+            'p-focus': any;
+            'p-inputwrapper-filled': any;
+            'p-inputwrapper-focus': any;
+        })[];
+        input: ({ props, instance }: {
+            props: any;
+            instance: any;
+        }) => (string | {
+            'p-variant-filled': boolean;
+        })[];
+        chipItem: ({ state, index }: {
+            state: any;
+            index: any;
+        }) => (string | {
+            'p-focus': boolean;
+        })[];
+        pcChip: string;
+        chipIcon: string;
+        inputItem: string;
+    };
+    static ɵfac: i0.ɵɵFactoryDeclaration<ChipsStyle, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ChipsStyle>;
+}
+/**
+ *
+ * Chips is used to enter multiple values on an input field.
+ *
+ *
+ * @module chipsstyle
+ *
+ */
+export declare enum ChipsClasses {
+    /**
+     * Class name of the root element
+     */
+    root = "p-chip",
+    /**
+     * Class name of the image element
+     */
+    image = "p-chip-image",
+    /**
+     * Class name of the icon element
+     */
+    icon = "p-chip-icon",
+    /**
+     * Class name of the label element
+     */
+    label = "p-chip-label",
+    /**
+     * Class name of the remove icon element
+     */
+    removeIcon = "p-chip-remove-icon"
+}
+export interface ChipsStyle extends BaseStyle {
+}

package/confirmdialog/confirmdialog.d.ts

@@ -233,12 +233,14 @@ export declare class ConfirmDialog extends BaseComponent implements OnInit, OnDe
     hide(type?: ConfirmEventType): void;
     destroyStyle(): void;
     ngOnDestroy(): void;
+    unsubscribeConfirmationEvents(): void;
     onAccept(): void;
     onReject(): void;
     get acceptButtonLabel(): string;
     get rejectButtonLabel(): string;
     getAcceptButtonProps(): any;
     getRejectButtonProps(): any;
+    resetConfirmationOptionsToDefault(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ConfirmDialog, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ConfirmDialog, "p-confirmDialog, p-confirmdialog, p-confirm-dialog", never, { "header": { "alias": "header"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "message": { "alias": "message"; "required": false; }; "style": { "alias": "style"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; "maskStyleClass": { "alias": "maskStyleClass"; "required": false; }; "acceptIcon": { "alias": "acceptIcon"; "required": false; }; "acceptLabel": { "alias": "acceptLabel"; "required": false; }; "closeAriaLabel": { "alias": "closeAriaLabel"; "required": false; }; "acceptAriaLabel": { "alias": "acceptAriaLabel"; "required": false; }; "acceptVisible": { "alias": "acceptVisible"; "required": false; }; "rejectIcon": { "alias": "rejectIcon"; "required": false; }; "rejectLabel": { "alias": "rejectLabel"; "required": false; }; "rejectAriaLabel": { "alias": "rejectAriaLabel"; "required": false; }; "rejectVisible": { "alias": "rejectVisible"; "required": false; }; "acceptButtonStyleClass": { "alias": "acceptButtonStyleClass"; "required": false; }; "rejectButtonStyleClass": { "alias": "rejectButtonStyleClass"; "required": false; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; }; "dismissableMask": { "alias": "dismissableMask"; "required": false; }; "blockScroll": { "alias": "blockScroll"; "required": false; }; "rtl": { "alias": "rtl"; "required": false; }; "closable": { "alias": "closable"; "required": false; }; "appendTo": { "alias": "appendTo"; "required": false; }; "key": { "alias": "key"; "required": false; }; "autoZIndex": { "alias": "autoZIndex"; "required": false; }; "baseZIndex": { "alias": "baseZIndex"; "required": false; }; "transitionOptions": { "alias": "transitionOptions"; "required": false; }; "focusTrap": { "alias": "focusTrap"; "required": false; }; "defaultFocus": { "alias": "defaultFocus"; "required": false; }; "breakpoints": { "alias": "breakpoints"; "required": false; }; "visible": { "alias": "visible"; "required": false; }; "position": { "alias": "position"; "required": false; }; }, { "onHide": "onHide"; }, ["footer", "headerTemplate", "footerTemplate", "rejectIconTemplate", "acceptIconTemplate", "messageTemplate", "iconTemplate", "headlessTemplate", "templates"], ["p-footer"], true, never>;
     static ngAcceptInputType_acceptVisible: unknown;

package/datepicker/datepicker.d.ts

@@ -82,7 +82,8 @@ export declare class DatePicker extends BaseComponent implements OnInit, AfterCo
      * Format of the date which can also be defined at locale settings.
      * @group Props
      */
-    dateFormat: string | undefined;
+    get dateFormat(): string | undefined;
+    set dateFormat(value: string | undefined);
     /**
      * Separator for multiple selection mode.
      * @group Props
@@ -154,7 +155,8 @@ export declare class DatePicker extends BaseComponent implements OnInit, AfterCo
      * Specifies 12 or 24 hour format.
      * @group Props
      */
-    hourFormat: string;
+    get hourFormat(): string;
+    set hourFormat(value: string);
     /**
      * Whether to display timepicker only.
      * @group Props
@@ -486,6 +488,8 @@ export declare class DatePicker extends BaseComponent implements OnInit, AfterCo
     inputFieldValue: Nullable<string>;
     _minDate?: Date | null;
     _maxDate?: Date | null;
+    _dateFormat: string | undefined;
+    _hourFormat: string;
     _showTime: boolean;
     _yearRange: string;
     preventDocumentListener: Nullable<boolean>;

package/dialog/dialog.d.ts

@@ -352,6 +352,7 @@ export declare class Dialog extends BaseComponent implements OnInit, AfterConten
     minimizeIconT: TemplateRef<any> | undefined;
     headlessT: TemplateRef<any> | undefined;
     get maximizeLabel(): string;
+    get minimizeLabel(): string;
     zone: NgZone;
     get maskClass(): {
         [x: string]: string | boolean;

package/dynamicdialog/dynamicdialog-config.d.ts

@@ -154,7 +154,7 @@ export declare class DynamicDialogConfig<T = any> {
      */
     minimizeIcon?: string;
     /**
-     * Position of the dialog, options are "center", "top", "bottom", "left", "right", "top-left", "top-right", "bottom-left" or "bottom-right".
+     * Position of the dialog, options are "center", "top", "bottom", "left", "right", "topleft", "topright", "bottomleft" or "bottomright".
      * @group Props
      */
     position?: string;

package/editor/editor.d.ts

@@ -1,9 +1,9 @@
-import { AfterContentInit, EventEmitter, QueryList, TemplateRef } from '@angular/core';
+import { AfterContentInit, EventEmitter, OnDestroy, QueryList, TemplateRef } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import { PrimeTemplate } from 'primeng/api';
 import { BaseComponent } from 'primeng/basecomponent';
 import { Nullable } from 'primeng/ts-helpers';
-import { EditorInitEvent, EditorSelectionChangeEvent, EditorTextChangeEvent } from './editor.interface';
+import { EditorBlurEvent, EditorChangeEvent, EditorFocusEvent, EditorInitEvent, EditorSelectionChangeEvent, EditorTextChangeEvent } from './editor.interface';
 import { EditorStyle } from './style/editorstyle';
 import * as i0 from "@angular/core";
 import * as i1 from "primeng/api";
@@ -12,7 +12,7 @@ export declare const EDITOR_VALUE_ACCESSOR: any;
  * Editor groups a collection of contents in tabs.
  * @group Components
  */
-export declare class Editor extends BaseComponent implements AfterContentInit, ControlValueAccessor {
+export declare class Editor extends BaseComponent implements AfterContentInit, ControlValueAccessor, OnDestroy {
     /**
      * Inline style of the container.
      * @group Props
@@ -79,6 +79,24 @@ export declare class Editor extends BaseComponent implements AfterContentInit, C
      * @group Emits
      */
     onSelectionChange: EventEmitter<EditorSelectionChangeEvent>;
+    /**
+     * Callback to invoke when editor content changes (combines both text and selection changes).
+     * @param {EditorChangeEvent} event - custom event.
+     * @group Emits
+     */
+    onEditorChange: EventEmitter<EditorChangeEvent>;
+    /**
+     * Callback to invoke when editor receives focus.
+     * @param {EditorFocusEvent} event - custom event.
+     * @group Emits
+     */
+    onFocus: EventEmitter<EditorFocusEvent>;
+    /**
+     * Callback to invoke when editor loses focus.
+     * @param {EditorBlurEvent} event - custom event.
+     * @group Emits
+     */
+    onBlur: EventEmitter<EditorBlurEvent>;
     toolbar: any;
     value: Nullable<string>;
     delayedCommand: Function | null;
@@ -96,6 +114,8 @@ export declare class Editor extends BaseComponent implements AfterContentInit, C
     _headerTemplate: TemplateRef<any> | undefined;
     private get isAttachedQuillEditorToDOM();
     private quillElements;
+    private focusListener;
+    private blurListener;
     _componentStyle: EditorStyle;
     constructor();
     ngAfterContentInit(): void;
@@ -105,9 +125,10 @@ export declare class Editor extends BaseComponent implements AfterContentInit, C
     getQuill(): any;
     private initQuillEditor;
     private createQuillEditor;
+    ngOnDestroy(): void;
     private initQuillElements;
     static ɵfac: i0.ɵɵFactoryDeclaration<Editor, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<Editor, "p-editor", never, { "style": { "alias": "style"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "formats": { "alias": "formats"; "required": false; }; "modules": { "alias": "modules"; "required": false; }; "bounds": { "alias": "bounds"; "required": false; }; "scrollingContainer": { "alias": "scrollingContainer"; "required": false; }; "debug": { "alias": "debug"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; }, { "onInit": "onInit"; "onTextChange": "onTextChange"; "onSelectionChange": "onSelectionChange"; }, ["toolbar", "headerTemplate", "templates"], ["p-header"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<Editor, "p-editor", never, { "style": { "alias": "style"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "formats": { "alias": "formats"; "required": false; }; "modules": { "alias": "modules"; "required": false; }; "bounds": { "alias": "bounds"; "required": false; }; "scrollingContainer": { "alias": "scrollingContainer"; "required": false; }; "debug": { "alias": "debug"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; }, { "onInit": "onInit"; "onTextChange": "onTextChange"; "onSelectionChange": "onSelectionChange"; "onEditorChange": "onEditorChange"; "onFocus": "onFocus"; "onBlur": "onBlur"; }, ["toolbar", "headerTemplate", "templates"], ["p-header"], true, never>;
 }
 export declare class EditorModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<EditorModule, never>;

package/editor/editor.interface.d.ts

@@ -1,4 +1,25 @@
 import { TemplateRef } from '@angular/core';
+/**
+ * Quill Delta object interface for text changes.
+ * @group Interfaces
+ */
+export interface QuillDelta {
+    ops?: any[];
+    retain?: number;
+    delete?: number;
+    insert?: string | object;
+    attributes?: {
+        [key: string]: any;
+    };
+}
+/**
+ * Quill Range object interface for selection changes.
+ * @group Interfaces
+ */
+export interface QuillRange {
+    index: number;
+    length: number;
+}
 /**
  * Custom text change event.
  * @see {@link Editor.onTextChange}
@@ -8,19 +29,19 @@ export interface EditorTextChangeEvent {
     /**
      * Current value as html.
      */
-    htmlValue: string;
+    htmlValue: string | null;
     /**
      * Current value as text.
      */
     textValue: string;
     /**
-     * Representation of the change.
+     * Representation of the change as Quill Delta.
      */
-    delta: string;
+    delta: QuillDelta;
     /**
-     * Source of change. Will be either 'user' or 'api'.
+     * Source of change. Will be 'user', 'api', or 'silent'.
      */
-    source: string;
+    source: 'user' | 'api' | 'silent';
 }
 /**
  * Custom selection change event.
@@ -31,15 +52,52 @@ export interface EditorSelectionChangeEvent {
     /**
      * Representation of the selection boundaries.
      */
-    range: string;
+    range: QuillRange | null;
     /**
      * Representation of the previous selection boundaries.
      */
-    oldRange: string;
+    oldRange: QuillRange | null;
+    /**
+     * Source of change. Will be 'user', 'api', or 'silent'.
+     */
+    source: 'user' | 'api' | 'silent';
+}
+/**
+ * Custom editor change event.
+ * @see {@link Editor.onEditorChange}
+ * @group Events
+ */
+export interface EditorChangeEvent {
+    /**
+     * Type of change ('text-change' or 'selection-change').
+     */
+    eventName: 'text-change' | 'selection-change';
+    /**
+     * Arguments passed to the change event.
+     */
+    args: any[];
+}
+/**
+ * Custom focus event.
+ * @see {@link Editor.onFocus}
+ * @group Events
+ */
+export interface EditorFocusEvent {
+    /**
+     * Source of the focus event.
+     */
+    source: 'user' | 'api' | 'silent';
+}
+/**
+ * Custom blur event.
+ * @see {@link Editor.onBlur}
+ * @group Events
+ */
+export interface EditorBlurEvent {
     /**
-     * Source of change. Will be either 'user' or 'api'.
+     * Source of the blur event.
      */
-    source: string;
+    source: 'user' | 'api' | 'silent';
 }
 /**
  * Custom load event.