primeng 20.2.0 → 20.3.0-rc.1

package/types/drawer/index.d.ts

@@ -0,0 +1,77 @@
+import { PassThroughOption, PassThrough } from 'primeng/api';
+import { ButtonPassThrough } from 'primeng/types/button';
+import { TemplateRef } from '@angular/core';
+
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link Drawer.pt}
+ * @group Interface
+ */
+interface DrawerPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the host's DOM element.
+     */
+    host?: PassThroughOption<HTMLElement, I>;
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the header's DOM element.
+     */
+    header?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the title's DOM element.
+     */
+    title?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the close Button component.
+     * @see {@link ButtonPassThrough}
+     */
+    pcCloseButton?: ButtonPassThrough;
+    /**
+     * Used to pass attributes to the content's DOM element.
+     */
+    content?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the footer's DOM element.
+     */
+    footer?: PassThroughOption<HTMLDivElement, I>;
+}
+/**
+ * Defines valid pass-through options in Drawer.
+ * @see {@link DrawerPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type DrawerPassThrough<I = unknown> = PassThrough<I, DrawerPassThroughOptions<I>>;
+/**
+ * Defines valid templates in Drawer.
+ * @group Templates
+ */
+interface DrawerTemplates {
+    /**
+     * Custom template of header.
+     */
+    header(): TemplateRef<any>;
+    /**
+     * Custom template of content.
+     */
+    content(): TemplateRef<any>;
+    /**
+     * Custom template of footer.
+     */
+    footer(): TemplateRef<any>;
+    /**
+     * Custom template of closeicon.
+     */
+    closeicon(): TemplateRef<any>;
+    /**
+     * Headless template.
+     */
+    headless(): TemplateRef<any>;
+}
+
+export type { DrawerPassThrough, DrawerPassThroughOptions, DrawerTemplates };

package/types/editor/index.d.ts

@@ -0,0 +1,210 @@
+import { TemplateRef } from '@angular/core';
+import { PassThroughOption, PassThrough } from 'primeng/api';
+
+/**
+ * Custom passthrough(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link Editor.pt}
+ * @group Interface
+ */
+interface EditorPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the toolbar's DOM element.
+     */
+    toolbar?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the formats span's DOM element.
+     */
+    formats?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the header select's DOM element.
+     */
+    header?: PassThroughOption<HTMLSelectElement, I>;
+    /**
+     * Used to pass attributes to the option's DOM element.
+     */
+    option?: PassThroughOption<HTMLOptionElement, I>;
+    /**
+     * Used to pass attributes to the bold button's DOM element.
+     */
+    bold?: PassThroughOption<HTMLButtonElement, I>;
+    /**
+     * Used to pass attributes to the italic button's DOM element.
+     */
+    italic?: PassThroughOption<HTMLButtonElement, I>;
+    /**
+     * Used to pass attributes to the underline button's DOM element.
+     */
+    underline?: PassThroughOption<HTMLButtonElement, I>;
+    /**
+     * Used to pass attributes to the color select's DOM element.
+     */
+    color?: PassThroughOption<HTMLSelectElement, I>;
+    /**
+     * Used to pass attributes to the background select's DOM element.
+     */
+    background?: PassThroughOption<HTMLSelectElement, I>;
+    /**
+     * Used to pass attributes to the list button's DOM element.
+     */
+    list?: PassThroughOption<HTMLButtonElement, I>;
+    /**
+     * Used to pass attributes to the select's DOM element.
+     */
+    select?: PassThroughOption<HTMLSelectElement, I>;
+    /**
+     * Used to pass attributes to the link button's DOM element.
+     */
+    link?: PassThroughOption<HTMLButtonElement, I>;
+    /**
+     * Used to pass attributes to the image button's DOM element.
+     */
+    image?: PassThroughOption<HTMLButtonElement, I>;
+    /**
+     * Used to pass attributes to the code block button's DOM element.
+     */
+    codeBlock?: PassThroughOption<HTMLButtonElement, I>;
+    /**
+     * Used to pass attributes to the clean button's DOM element.
+     */
+    clean?: PassThroughOption<HTMLButtonElement, I>;
+    /**
+     * Used to pass attributes to the content's DOM element.
+     */
+    content?: PassThroughOption<HTMLDivElement, I>;
+}
+/**
+ * Defines valid pass-through options in Editor component.
+ * @see {@link EditorPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type EditorPassThrough<I = unknown> = PassThrough<I, EditorPassThroughOptions<I>>;
+/**
+ * Quill Delta object interface for text changes.
+ * @group Interfaces
+ */
+interface QuillDelta {
+    ops?: any[];
+    retain?: number;
+    delete?: number;
+    insert?: string | object;
+    attributes?: {
+        [key: string]: any;
+    };
+}
+/**
+ * Quill Range object interface for selection changes.
+ * @group Interfaces
+ */
+interface QuillRange {
+    index: number;
+    length: number;
+}
+/**
+ * Custom text change event.
+ * @see {@link Editor.onTextChange}
+ * @group Events
+ */
+interface EditorTextChangeEvent {
+    /**
+     * Current value as html.
+     */
+    htmlValue: string | null;
+    /**
+     * Current value as text.
+     */
+    textValue: string;
+    /**
+     * Representation of the change as Quill Delta.
+     */
+    delta: QuillDelta;
+    /**
+     * Source of change. Will be 'user', 'api', or 'silent'.
+     */
+    source: 'user' | 'api' | 'silent';
+}
+/**
+ * Custom selection change event.
+ * @see {@link Editor.onSelectionChange}
+ * @group Events
+ */
+interface EditorSelectionChangeEvent {
+    /**
+     * Representation of the selection boundaries.
+     */
+    range: QuillRange | null;
+    /**
+     * Representation of the previous selection boundaries.
+     */
+    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
+ */
+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
+ */
+interface EditorFocusEvent {
+    /**
+     * Source of the focus event.
+     */
+    source: 'user' | 'api' | 'silent';
+}
+/**
+ * Custom blur event.
+ * @see {@link Editor.onBlur}
+ * @group Events
+ */
+interface EditorBlurEvent {
+    /**
+     * Source of the blur event.
+     */
+    source: 'user' | 'api' | 'silent';
+}
+/**
+ * Custom load event.
+ * @see {@link Editor.onInit}
+ * @group Events
+ */
+interface EditorInitEvent {
+    /**
+     * Text editor instance.
+     */
+    editor: any;
+}
+/**
+ * Defines valid templates in Editor.
+ * @group Templates
+ */
+interface EditorTemplates {
+    /**
+     * Custom header template.
+     */
+    header(): TemplateRef<any>;
+}
+
+export type { EditorBlurEvent, EditorChangeEvent, EditorFocusEvent, EditorInitEvent, EditorPassThrough, EditorPassThroughOptions, EditorSelectionChangeEvent, EditorTemplates, EditorTextChangeEvent, QuillDelta, QuillRange };

package/types/fieldset/index.d.ts

@@ -0,0 +1,92 @@
+import { TemplateRef } from '@angular/core';
+import { PassThroughOption, PassThrough } from 'primeng/api';
+
+/**
+ * Custom passthrough(pt) options.
+ * @see {@link Fieldset.pt}
+ * @group Interface
+ */
+interface FieldsetPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLFieldSetElement, I>;
+    /**
+     * Used to pass attributes to the legend's DOM element.
+     */
+    legend?: PassThroughOption<HTMLLegendElement, I>;
+    /**
+     * Used to pass attributes to the toggle button's DOM element.
+     */
+    toggleButton?: PassThroughOption<HTMLButtonElement, I>;
+    /**
+     * Used to pass attributes to the toggle icon's DOM element.
+     */
+    toggleIcon?: PassThroughOption<SVGElement | HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the legend label's DOM element.
+     */
+    legendLabel?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the content container's DOM element.
+     */
+    contentContainer?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the content's DOM element.
+     */
+    content?: PassThroughOption<HTMLDivElement, I>;
+}
+/**
+ * Defines valid pass-through options in Fieldset component.
+ * @see {@link FieldsetPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type FieldsetPassThrough<I = unknown> = PassThrough<I, FieldsetPassThroughOptions<I>>;
+/**
+ * Custom panel toggle event, emits after toggle.
+ * @see {@link Fieldset.onAfterToggle}
+ * @group Events
+ */
+interface FieldsetAfterToggleEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent: Event;
+    /**
+     * Collapsed state of the panel.
+     */
+    collapsed: boolean | undefined;
+}
+/**
+ * Custom panel toggle event, emits before toggle.
+ * @see {@link Fieldset.onBeforeToggle}
+ * @extends {FieldsetAfterToggleEvent}
+ * @group Events
+ */
+interface FieldsetBeforeToggleEvent extends FieldsetAfterToggleEvent {
+}
+/**
+ * Defines valid templates in Fieldset.
+ * @group Templates
+ */
+interface FieldsetTemplates {
+    /**
+     * Custom header template.
+     */
+    header(): TemplateRef<any>;
+    /**
+     * Custom content template.
+     */
+    content(): TemplateRef<any>;
+    /**
+     * Custom footer template.
+     */
+    expandicon(): TemplateRef<any>;
+    /**
+     * Custom icons template of the panel toggler.
+     */
+    collapseicon(): TemplateRef<any>;
+}
+
+export type { FieldsetAfterToggleEvent, FieldsetBeforeToggleEvent, FieldsetPassThrough, FieldsetPassThroughOptions, FieldsetTemplates };