primeng 20.2.0 → 20.3.0-rc.1

package/types/fileupload/index.d.ts

@@ -0,0 +1,576 @@
+import { HttpEvent } from '@angular/common/http';
+import { TemplateRef } from '@angular/core';
+import { PassThroughOption, PassThrough } from 'primeng/api';
+import { BadgePassThrough } from 'primeng/types/badge';
+import { ButtonPassThrough } from 'primeng/types/button';
+import { MessagePassThrough } from 'primeng/types/message';
+import { ProgressBarPassThrough } from 'primeng/types/progressbar';
+
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link FileUpload.pt}
+ * @group Interface
+ */
+interface FileUploadPassThroughOptions<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 input's DOM element.
+     */
+    input?: PassThroughOption<HTMLInputElement, I>;
+    /**
+     * Used to pass attributes to the header's DOM element.
+     */
+    header?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the choose button component.
+     */
+    pcChooseButton?: ButtonPassThrough;
+    /**
+     * Used to pass attributes to the upload button component.
+     */
+    pcUploadButton?: ButtonPassThrough;
+    /**
+     * Used to pass attributes to the cancel button component.
+     */
+    pcCancelButton?: ButtonPassThrough;
+    /**
+     * Used to pass attributes to the content's DOM element.
+     */
+    content?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the progress bar component.
+     */
+    pcProgressBar?: ProgressBarPassThrough;
+    /**
+     * Used to pass attributes to the message component.
+     */
+    pcMessage?: MessagePassThrough;
+    /**
+     * Used to pass attributes to the file list's DOM element.
+     */
+    fileList?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the file's DOM element.
+     */
+    file?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the file thumbnail's DOM element.
+     */
+    fileThumbnail?: PassThroughOption<HTMLImageElement, I>;
+    /**
+     * Used to pass attributes to the file info's DOM element.
+     */
+    fileInfo?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the file name's DOM element.
+     */
+    fileName?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the file size's DOM element.
+     */
+    fileSize?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the file badge component.
+     */
+    pcFileBadge?: BadgePassThrough;
+    /**
+     * Used to pass attributes to the file actions's DOM element.
+     */
+    fileActions?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the file remove button component.
+     */
+    pcFileRemoveButton?: ButtonPassThrough;
+    /**
+     * Used to pass attributes to the basic content's DOM element.
+     */
+    basicContent?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the empty's DOM element.
+     */
+    empty?: PassThroughOption<HTMLElement, I>;
+}
+/**
+ * Defines valid pass-through options in FileUpload.
+ * @see {@link FileUploadPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type FileUploadPassThrough<I = unknown> = PassThrough<I, FileUploadPassThroughOptions<I>>;
+/**
+ * Upload event.
+ * @group Events
+ */
+interface UploadEvent {
+    /**
+     * HTTP event.
+     */
+    originalEvent: HttpEvent<any>;
+}
+/**
+ * Upload event.
+ * @group Events
+ */
+interface UploadEvent {
+    /**
+     * HTTP event.
+     */
+    originalEvent: HttpEvent<any>;
+}
+/**
+ * Remove uploaded file event.
+ * @group Events
+ */
+interface RemoveUploadedFileEvent {
+    /**
+     * Removed file.
+     */
+    file: any;
+    /**
+     * Uploaded files.
+     */
+    files: any[];
+}
+/**
+ * Remove uploaded file event.
+ * @group Events
+ */
+interface RemoveUploadedFileEvent {
+    /**
+     * Removed file.
+     */
+    file: any;
+    /**
+     * Uploaded files.
+     */
+    files: any[];
+}
+/**
+ * Form data event.
+ * @group Events
+ */
+interface FormDataEvent {
+    /**
+     * FormData object.
+     */
+    formData: FormData;
+}
+/**
+ * Form data event.
+ * @group Events
+ */
+interface FormDataEvent {
+    /**
+     * FormData object.
+     */
+    formData: FormData;
+}
+/**
+ * An event indicating that the request was sent to the server. Useful when a request may be retried multiple times, to distinguish between retries on the final event stream.
+ * @see {@link FileUpload.onSend}
+ * @group Events
+ */
+interface FileSendEvent extends UploadEvent, FormDataEvent {
+}
+/**
+ * An event indicating that the request was sent to the server. Useful when a request may be retried multiple times, to distinguish between retries on the final event stream.
+ * @see {@link FileUpload.onSend}
+ * @group Events
+ */
+interface FileSendEvent extends UploadEvent, FormDataEvent {
+}
+/**
+ * Callback to invoke before file upload is initialized.
+ * @see {@link FileUpload.onBeforeUpload}
+ * @group Events
+ */
+interface FileBeforeUploadEvent extends FormDataEvent {
+}
+/**
+ * Callback to invoke before file upload is initialized.
+ * @see {@link FileUpload.onBeforeUpload}
+ * @group Events
+ */
+interface FileBeforeUploadEvent extends FormDataEvent {
+}
+/**
+ * Callback to invoke when file upload is complete.
+ * @see {@link FileUpload.onUpload}
+ * @group Events
+ */
+interface FileUploadEvent extends UploadEvent {
+    /**
+     * Uploaded files.
+     */
+    files: File[];
+}
+/**
+ * Callback to invoke when file upload is complete.
+ * @see {@link FileUpload.onUpload}
+ * @group Events
+ */
+interface FileUploadEvent extends UploadEvent {
+    /**
+     * Uploaded files.
+     */
+    files: File[];
+}
+/**
+ * Callback to invoke when a file is removed without uploading using clear button of a file.
+ * @see {@link FileUpload.onRemove}
+ * @group Events
+ */
+interface FileRemoveEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent: Event;
+    /**
+     * Selected file
+     */
+    file: File;
+}
+/**
+ * Callback to invoke when a file is removed without uploading using clear button of a file.
+ * @see {@link FileUpload.onRemove}
+ * @group Events
+ */
+interface FileRemoveEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent: Event;
+    /**
+     * Selected file
+     */
+    file: File;
+}
+/**
+ * Callback to invoke when files are selected.
+ * @see {@link FileUpload.onSelect}
+ * @group Events
+ */
+interface FileSelectEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent: Event;
+    /**
+     * Uploaded files.
+     */
+    files: File[];
+    /**
+     * All files to be uploaded.
+     */
+    currentFiles: File[];
+}
+/**
+ * Callback to invoke when files are selected.
+ * @see {@link FileUpload.onSelect}
+ * @group Events
+ */
+interface FileSelectEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent: Event;
+    /**
+     * Uploaded files.
+     */
+    files: File[];
+    /**
+     * All files to be uploaded.
+     */
+    currentFiles: File[];
+}
+/**
+ * Callback to invoke when files are being uploaded.
+ * @see {@link FileUpload.onProgress}
+ * @extends {UploadEvent}
+ * @group Events
+ */
+interface FileProgressEvent extends UploadEvent {
+    /**
+     * Calculated progress value.
+     */
+    progress: number;
+}
+/**
+ * Callback to invoke when files are being uploaded.
+ * @see {@link FileUpload.onProgress}
+ * @extends {UploadEvent}
+ * @group Events
+ */
+interface FileProgressEvent extends UploadEvent {
+    /**
+     * Calculated progress value.
+     */
+    progress: number;
+}
+/**
+ * Callback to invoke in custom upload mode to upload the files manually.
+ * @see {@link FileUpload.uploadHandler}
+ * @group Events
+ */
+interface FileUploadHandlerEvent {
+    /**
+     * List of selected files.
+     */
+    files: File[];
+}
+/**
+ * Callback to invoke in custom upload mode to upload the files manually.
+ * @see {@link FileUpload.uploadHandler}
+ * @group Events
+ */
+interface FileUploadHandlerEvent {
+    /**
+     * List of selected files.
+     */
+    files: File[];
+}
+/**
+ * Callback to invoke on upload error.
+ * @see {@link FileUpload.onError}
+ * @group Events
+ */
+interface FileUploadErrorEvent {
+    /**
+     * List of selected files.
+     */
+    error?: ErrorEvent;
+    /**
+     * List of selected files.
+     */
+    files: File[];
+}
+/**
+ * Callback to invoke on upload error.
+ * @see {@link FileUpload.onError}
+ * @group Events
+ */
+interface FileUploadErrorEvent {
+    /**
+     * List of selected files.
+     */
+    error?: ErrorEvent;
+    /**
+     * List of selected files.
+     */
+    files: File[];
+}
+/**
+ * Defines valid templates in FileUpload.
+ * @group Templates
+ */
+interface FileUploadTemplates {
+    /**
+     * Custom template of file.
+     */
+    file(): TemplateRef<any>;
+    /**
+     * Custom file label template.
+     */
+    filelabel(context: {
+        /**
+         * File list.
+         */
+        $implicit: any;
+    }): TemplateRef<any>;
+    /**
+     * Custom template of file.
+     */
+    header(context: {
+        /**
+         * File list.
+         */
+        $implicit: any;
+        /**
+         * Uploaded files list.
+         */
+        uploadedFiles: any;
+        /**
+         * Callback to invoke on choose button click.
+         */
+        chooseCallback: VoidFunction;
+        /**
+         * Callback to invoke on clear button click.
+         */
+        clearCallback: VoidFunction;
+        /**
+         * Callback to invoke on upload.
+         */
+        uploadCallback: VoidFunction;
+    }): TemplateRef<any>;
+    /**
+     * Custom template of content.
+     */
+    content(context: {
+        /**
+         * File list.
+         */
+        $implicit: any;
+        /**
+         * Uploaded files list.
+         */
+        uploadedFiles: any;
+        /**
+         * Upload progress.
+         */
+        progress: any;
+        /**
+         * Status messages about upload process.
+         */
+        messages: any;
+        /**
+         * Callback to invoke on choose button click.
+         */
+        chooseCallback: VoidFunction;
+        /**
+         * Callback to invoke on clear button click.
+         */
+        removeFileCallback: VoidFunction;
+        /**
+         * Callback to invoke on clear button click.
+         */
+        clearCallback: VoidFunction;
+        /**
+         * Callback to invoke on upload.
+         */
+        uploadCallback: VoidFunction;
+        /**
+         * Callback to invoke on remove uploaded file, accepts index as a parameter.
+         * @param index Index of the file to remove.
+         */
+        removeUploadedFileCallback: VoidFunction;
+    }): TemplateRef<any>;
+    /**
+     * Custom template of toolbar.
+     */
+    toolbar(): TemplateRef<any>;
+    /**
+     * Custom template of chooseicon.
+     */
+    chooseicon(): TemplateRef<any>;
+    /**
+     * Custom template of uploadicon.
+     */
+    uploadicon(): TemplateRef<any>;
+    /**
+     * Custom template of cancelicon.
+     */
+    cancelicon(): TemplateRef<any>;
+}
+/**
+ * Defines valid templates in FileUpload.
+ * @group Templates
+ */
+interface FileUploadTemplates {
+    /**
+     * Custom template of file.
+     */
+    file(): TemplateRef<any>;
+    /**
+     * Custom file label template.
+     */
+    filelabel(context: {
+        /**
+         * File list.
+         */
+        $implicit: any;
+    }): TemplateRef<any>;
+    /**
+     * Custom template of file.
+     */
+    header(context: {
+        /**
+         * File list.
+         */
+        $implicit: any;
+        /**
+         * Uploaded files list.
+         */
+        uploadedFiles: any;
+        /**
+         * Callback to invoke on choose button click.
+         */
+        chooseCallback: VoidFunction;
+        /**
+         * Callback to invoke on clear button click.
+         */
+        clearCallback: VoidFunction;
+        /**
+         * Callback to invoke on upload.
+         */
+        uploadCallback: VoidFunction;
+    }): TemplateRef<any>;
+    /**
+     * Custom template of content.
+     */
+    content(context: {
+        /**
+         * File list.
+         */
+        $implicit: any;
+        /**
+         * Uploaded files list.
+         */
+        uploadedFiles: any;
+        /**
+         * Upload progress.
+         */
+        progress: any;
+        /**
+         * Status messages about upload process.
+         */
+        messages: any;
+        /**
+         * Callback to invoke on choose button click.
+         */
+        chooseCallback: VoidFunction;
+        /**
+         * Callback to invoke on clear button click.
+         */
+        removeFileCallback: VoidFunction;
+        /**
+         * Callback to invoke on clear button click.
+         */
+        clearCallback: VoidFunction;
+        /**
+         * Callback to invoke on upload.
+         */
+        uploadCallback: VoidFunction;
+        /**
+         * Callback to invoke on remove uploaded file, accepts index as a parameter.
+         * @param index Index of the file to remove.
+         */
+        removeUploadedFileCallback: VoidFunction;
+    }): TemplateRef<any>;
+    /**
+     * Custom template of toolbar.
+     */
+    toolbar(): TemplateRef<any>;
+    /**
+     * Custom template of chooseicon.
+     */
+    chooseicon(): TemplateRef<any>;
+    /**
+     * Custom template of uploadicon.
+     */
+    uploadicon(): TemplateRef<any>;
+    /**
+     * Custom template of cancelicon.
+     */
+    cancelicon(): TemplateRef<any>;
+}
+
+export type { FileBeforeUploadEvent, FileProgressEvent, FileRemoveEvent, FileSelectEvent, FileSendEvent, FileUploadErrorEvent, FileUploadEvent, FileUploadHandlerEvent, FileUploadPassThrough, FileUploadPassThroughOptions, FileUploadTemplates, FormDataEvent, RemoveUploadedFileEvent, UploadEvent };

package/types/floatlabel/index.d.ts

@@ -0,0 +1,26 @@
+import { PassThroughOption, PassThrough } from 'primeng/api';
+
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link FloatLabel.pt}
+ * @group Interface
+ */
+interface FloatLabelPassThroughOptions<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<HTMLSpanElement, I>;
+}
+/**
+ * Custom passthrough attributes for each DOM elements
+ * @group Interface
+ */
+type FloatLabelPassThrough<I = unknown> = PassThrough<I, FloatLabelPassThroughOptions<I>>;
+
+export type { FloatLabelPassThrough, FloatLabelPassThroughOptions };

package/types/fluid/index.d.ts

@@ -0,0 +1,28 @@
+import { PassThroughOption, PassThrough } from 'primeng/api';
+
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link Fluid.pt}
+ * @group Interface
+ */
+interface FluidPassThroughOptions<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>;
+}
+/**
+ * Defines valid pass-through options in Fluid component.
+ * @see {@link FluidPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type FluidPassThrough<I = unknown> = PassThrough<I, FluidPassThroughOptions<I>>;
+
+export type { FluidPassThrough, FluidPassThroughOptions };