wj-elements 0.1.199 → 0.1.200

package/dist/packages/wje-file-upload/file-upload.element.d.ts

@@ -0,0 +1,191 @@
+import { default as WJElement } from '../wje-element/element.js';
+import { Localizer } from '../utils/localize.js';
+/**
+ * @summary FileUpload is a custom web component for uploading files.
+ * It extends from WJElement and provides functionalities for file upload.
+ * @documentation https://elements.webjet.sk/components/file-upload
+ * @status stable
+ * @augments WJElement
+ * @slot - This is a default/unnamed slot.
+ * @csspart native - The native file upload part.
+ * @csspart file-list - The file list part.
+ * @csspart upload-button - The label part.
+ * @event change - Fires when the file input changes.
+ * @event drop - Fires when a file is dropped into the component.
+ * @attribute {string} accepted-types - The accepted file types for upload.
+ * @attribute {number} chunk-size - The chunk size for file upload.
+ * @attribute {number} max-file-size - The maximum file size for upload.
+ * @attribute {string} upload-url - The URL to set as the upload URL.
+ * @attribute {boolean} auto-process-files - The auto process files attribute.
+ * @attribute {boolean} no-upload-button - The no upload button attribute.
+ * @tag wje-file-upload
+ */
+export default class FileUpload extends WJElement {
+    /**
+     * Getter for cssStyleSheet.
+     * @returns {string} The CSS styles for the component.
+     */
+    static get cssStyleSheet(): string;
+    /**
+     * Getter for observedAttributes.
+     * @returns {Array} An empty array as no attributes are observed.
+     */
+    static get observedAttributes(): any[];
+    localizer: Localizer;
+    _uploadedFiles: any[];
+    _queuedFiles: any[];
+    /**
+     * Dependencies for the FileUpload component.
+     * @type {object}
+     */
+    dependencies: object;
+    /**
+     * Setter for acceptedTypes attribute.
+     * @param {string} value The accepted file types for upload.
+     */
+    set acceptedTypes(value: string);
+    /**
+     * Getter for acceptedTypes attribute.
+     * @returns {string} The accepted file types for upload.
+     */
+    get acceptedTypes(): string;
+    /**
+     * Setter for chunkSize attribute.
+     * @param {number} value The chunk size for file upload.
+     */
+    set chunkSize(value: number);
+    /**
+     * Getter for chunkSize attribute.
+     * @returns {number} The chunk size for file upload.
+     */
+    get chunkSize(): number;
+    /**
+     * Setter for maxFileSize attribute.
+     * @param {number} value The maximum file size for upload.
+     */
+    set maxFileSize(value: number);
+    /**
+     * Getter for maxFileSize attribute.
+     * @returns {number} The maximum file size for upload.
+     */
+    get maxFileSize(): number;
+    /**
+     * Setter for label attribute.
+     * @param {string} value The URL to set as the upload URL.
+     */
+    set uploadUrl(value: string);
+    /**
+     * Gets the upload URL for the file upload element.
+     * @returns {string} The upload URL for the file upload element.
+     */
+    get uploadUrl(): string;
+    /**
+     * Sets the autoProcessFiles attribute.
+     * @param value
+     */
+    set autoProcessFiles(value: any | boolean);
+    /**
+     * Gets the autoProcessFiles attribute.
+     * @returns {any|boolean}
+     */
+    get autoProcessFiles(): any | boolean;
+    /**
+     * Sets the noUploadButton attribute.
+     * @param value
+     */
+    set noUploadButton(value: boolean);
+    /**
+     * Gets the noUploadButton attribute.
+     * @returns {boolean}
+     */
+    get noUploadButton(): boolean;
+    /**
+     * Sets the uploaded files.
+     * @param value
+     */
+    set uploadedFiles(value: []);
+    /**
+     * Return the uploaded files.
+     * @returns {[]}
+     */
+    get uploadedFiles(): [];
+    /**
+     * Sets the to-chunk attribute.
+     * @param value
+     */
+    set toChunk(value: boolean);
+    /**
+     * Gets the to-chunk attribute.
+     * @returns {boolean}
+     */
+    get toChunk(): boolean;
+    beforeDraw(): void;
+    uploadFunction: Function;
+    /**
+     * Method to draw the component on the screen.
+     * @returns {DocumentFragment} The fragment containing the component.
+     */
+    draw(): DocumentFragment;
+    button: HTMLElement;
+    native: HTMLDivElement;
+    fileList: HTMLSlotElement;
+    fileInput: HTMLInputElement;
+    /**
+     * Method to perform actions after the component is drawn.
+     */
+    afterDraw(): void;
+    /**
+     * Method to handle form submission.
+     * @param {Event} event The form submission event.
+     */
+    handleSubmit(event: Event): void;
+    /**
+     * Method to handle file drop event.
+     * @param {Event} event The file drop event object.
+     */
+    handleDrop: (event: Event) => void;
+    /**
+     * Method to handle file input change event.
+     * @param {Event} event The file input change event object.
+     */
+    handleInputChange: (event: Event) => void;
+    /**
+     * Method to add files to the queue.
+     * @param files
+     */
+    addFilesToQueue(files: any): void;
+    /**
+     * Method to upload files.
+     */
+    uploadFiles(): void;
+    /**
+     * Method to create an upload promise.
+     * @param file
+     * @returns {Promise<unknown>}
+     */
+    createUploadPromise: (file: any) => Promise<unknown>;
+    /**
+     * Method to create a preview for the file.
+     * @param {File} file The file for which the preview is to be created.
+     * @param {FileReader} reader The FileReader instance to read the file.
+     * @returns {HTMLElement} The created preview.
+     */
+    createPreview(file: File, reader: FileReader): HTMLElement;
+    /**
+     * Method to create a thumbnail for the file.
+     * @param {File} file The file for which the thumbnail is to be created.
+     * @param {FileReader} reader The FileReader instance to read the file.
+     * @returns {HTMLElement} The created thumbnail.
+     */
+    createThumbnail(file: File, reader: FileReader): HTMLElement;
+    /**
+     * Method to validate the files.
+     * @param {File} file The file to be validated.
+     * TODO: alowed types a size limit by malo byt cez attributy
+     */
+    assertFilesValid(file: File): void;
+    /**
+     * Method to reset the form state.
+     */
+    resetFormState(): void;
+}

package/dist/packages/wje-file-upload/service/service.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Retrieves the icon name for a given file type.
+ * @param {string} type The file type or category (e.g., "pdf", "image", "folder").
+ * @returns {string} The name of the icon associated with the file type.
+ * @example
+ * getFileTypeIcon('pdf'); // Returns the icon name for PDF files.
+ * getFileTypeIcon('folder'); // Returns 'folder'.
+ */
+export function getFileTypeIcon(type: string): string;
+/**
+ * Checks if a given file matches any of the accepted file types.
+ * @param {File} file The file to validate.
+ * @param {string|string[]} acceptedFileTypes A comma-separated string or an array of accepted MIME types or file extensions.
+ * @returns {boolean} Returns `true` if the file type is valid, otherwise `false`.
+ * @throws {Error} Throws an error if `acceptedFileTypes` is empty.
+ * @example
+ * const file = new File([""], "example.png", { type: "image/png" });
+ * const isValid = isValidFileType(file, "image/*,application/pdf");
+ * console.log(isValid); // true
+ * @example
+ * const file = new File([""], "example.txt", { type: "text/plain" });
+ * const isValid = isValidFileType(file, ["text/plain", "application/json"]);
+ * console.log(isValid); // true
+ */
+export function isValidFileType(file: File, acceptedFileTypes: string | string[]): boolean;
+/**
+ * Uploads a file in chunks using `XMLHttpRequest`, allowing for progress tracking.
+ * @param {File} file The file to be uploaded.
+ * @param {number} chunkSize The size of each chunk in bytes.
+ * @param {HTMLElement} preview The element used to display upload progress.
+ */
+export function uploadFile(file: File, chunkSize: number, preview: HTMLElement): void;
+/**
+ * Returns a function for uploading files either in chunks or as a whole file, based on the provided options.
+ * @param {string} url The URL to which the file will be uploaded.
+ * @param {number} [chunkSize] The size of each chunk in bytes when uploading in chunks (default is 1MB).
+ * @param {boolean} [wholeFile] Whether to upload the file as a whole. If `true`, the entire file is uploaded at once.
+ * @returns {Function} A function that takes a file and a preview element as arguments and uploads the file.
+ * @example
+ * // Upload a file in chunks
+ * const uploadInChunks = upload('/upload', 1024 * 512); // 512KB chunks
+ * uploadInChunks(file, previewElement);
+ * @example
+ * // Upload a whole file
+ * const uploadWhole = upload('/upload', undefined, true);
+ * uploadWhole(file, previewElement);
+ */
+export function upload(url: string, chunkSize?: number, wholeFile?: boolean): Function;
+/**
+ * Uploads a file in chunks to a specified URL, allowing for progress tracking and resuming in case of errors.
+ * @param {string} url The URL to which the file chunks will be uploaded.
+ * @param {File} file The file to be uploaded in chunks.
+ * @param {HTMLElement} preview The element used to display upload progress.
+ * @param {number} [chunkSize] The size of each chunk in bytes (default is 1MB).
+ * @returns {Promise<object>} Resolves with the response of the last chunk uploaded, parsed as JSON.
+ * @throws {Error} - Throws an error if a chunk fails to upload.
+ */
+export function uploadFileInChunks(url: string, file: File, preview: HTMLElement, chunkSize?: number): Promise<object>;
+/**
+ * Uploads a file to a specified URL using a `POST` request and updates the preview element with the uploaded file size.
+ * @param {string} url The URL to which the file will be uploaded.
+ * @param {File} file The file to be uploaded.
+ * @param {HTMLElement} preview The element that displays the upload preview. It will be updated with the file size.
+ * @returns {Promise<{data: object, file: File}>} - A promise that resolves with the server response and the uploaded file.
+ * @throws {Error} - Logs an error to the console if the request fails.
+ */
+export function uploadWholeFile(url: string, file: File, preview: HTMLElement): Promise<{
+    data: object;
+    file: File;
+}>;

package/dist/packages/wje-file-upload-item/file-upload-item.d.ts

@@ -0,0 +1,2 @@
+import { default as FileUploadItem } from './file-upload-item.element.js';
+export default FileUploadItem;

package/dist/packages/wje-file-upload-item/file-upload-item.element.d.ts

@@ -0,0 +1,68 @@
+import { default as WJElement } from '../wje-element/element.js';
+import { Localizer } from '../utils/localize.js';
+/**
+ * @summary This element allows users to upload files.
+ * `FileUploadItem` is a custom web component that represents a file upload item.
+ * It extends from `WJElement` and uses the `Localizer` utility for localization.
+ * @documentation https://elements.webjet.sk/components/file-upload
+ * @status stable
+ * @augments WJElement
+ * @csspart button - The delete button part
+ * @csspart image - The image part
+ * @csspart name - The name part
+ * @csspart size - The size part
+ * @slot img - Slot for the image
+ * @slot action - Slot for the action buttons
+ * @cssproperty --primary-color - The primary color of the file upload item.
+ * //@fires wje-button:click - Dispatches when the delete button is clicked
+ * @tag wje-file-upload
+ */
+export default class FileUploadItem extends WJElement {
+    /**
+     * Returns the CSS styles for the component.
+     * @static
+     * @returns {CSSStyleSheet}
+     */
+    static get cssStyleSheet(): CSSStyleSheet;
+    /**
+     * Returns the list of attributes to observe for changes.
+     * @static
+     * @returns {Array<string>}
+     */
+    static get observedAttributes(): Array<string>;
+    localizer: Localizer;
+    set isUploaded(value: boolean);
+    get isUploaded(): boolean;
+    set size(value: string);
+    get size(): string;
+    /**
+     * Dependencies for the component.
+     * @type {object}
+     */
+    dependencies: object;
+    /**
+     * Handles updates to the attributes of a custom element whenever one of the observed attributes is changed.
+     * Updates the related elements based on the changed attribute and its new value.
+     * @param {string} name The name of the attribute being changed.
+     * @param {string | null} oldValue The previous value of the attribute before the change, or null if the attribute was not previously set.
+     * @param {string | null} newValue The new value of the attribute after the change, or null if the attribute is being removed.
+     * @returns {void} Does not return a value.
+     */
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /**
+     * Method to draw the component on the screen.
+     * @returns {DocumentFragment} The fragment containing the component.
+     */
+    draw(): DocumentFragment;
+    button: HTMLElement;
+    uploadedEl: HTMLElement;
+    sliderEl: HTMLElement;
+    /**
+     * Called after the component has been drawn.
+     */
+    afterDraw(): void;
+    /**
+     * Handles the delete action.
+     */
+    onDelete: () => void;
+}

package/dist/packages/wje-footer/footer.d.ts

@@ -0,0 +1,2 @@
+import { default as Footer } from './footer.element.js';
+export default Footer;

package/dist/packages/wje-footer/footer.element.d.ts

@@ -0,0 +1,28 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary This element represents a footer. `Footer` is a custom web component that represents a footer.
+ * @documentation https://elements.webjet.sk/components/footer
+ * @status stable
+ * @augments WJElement
+ * @slot default - Default slot for the footer content
+ * @cssproperty --primary-color - The primary color of the footer
+ */
+export default class Footer extends WJElement {
+    /**
+     * Returns the CSS styles for the component.
+     * @static
+     * @returns {CSSStyleSheet}
+     */
+    static get cssStyleSheet(): CSSStyleSheet;
+    /**
+     * Returns the list of attributes to observe for changes.
+     * @static
+     * @returns {Array<string>}
+     */
+    static get observedAttributes(): Array<string>;
+    /**
+     * Draws the component.
+     * @returns {DocumentFragment}
+     */
+    draw(): DocumentFragment;
+}

package/dist/packages/wje-form/form.d.ts

@@ -0,0 +1,2 @@
+import { default as Form } from './form.element.js';
+export default Form;

package/dist/packages/wje-form/form.element.d.ts

@@ -0,0 +1,28 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary The Form class is a custom
+ * web component that extends WJElement. It is a simple form that can hold other elements or components.
+ * It provides a slot for adding child elements or components.
+ * @documentation https://elements.webjet.sk/components/form
+ * @status stable
+ * @augments WJElement
+ * @slot - The slot for adding child elements or components.
+ * @tag wje-form
+ */
+export default class Form extends WJElement {
+    /**
+     * Getter for the CSS stylesheet.
+     * @returns {*}
+     */
+    static get cssStyleSheet(): any;
+    /**
+     * Getter for the observed attributes.
+     * @returns {*[]}
+     */
+    static get observedAttributes(): any[];
+    /**
+     * Draws the Form.
+     * @returns {DocumentFragment}
+     */
+    draw(): DocumentFragment;
+}

package/dist/packages/wje-format-digital/format-digital.d.ts

@@ -0,0 +1,2 @@
+import { default as FormatDigital } from './format-digital.element.js';
+export default FormatDigital;

package/dist/packages/wje-format-digital/format-digital.element.d.ts

@@ -0,0 +1,83 @@
+import { default as WJElement } from '../wje-element/element.js';
+import { Localizer } from '../utils/localize.js';
+/**
+ * @summary This element formats and displays digital values such as file sizes or data transfer rates.
+ * `FormatDigital` is a custom web component that represents a formatted digital value with units like
+ * bytes or bits. It extends from `WJElement` and utilizes the `Localizer` class for locale-aware formatting.
+ * @documentation https://elements.webjet.sk/components/format-digital
+ * @status stable
+ * @augments {WJElement}
+ * @attribute {number} value - The numeric value to format (e.g., 1024 for 1 KB).
+ * @attribute {string} unit - The unit of the value (`byte` or `bit`). Defaults to `byte`.
+ * @attribute {string} unitDisplay - The display style of the unit (`short`, `long`, or `narrow`). Defaults to `short`.
+ * @csspart native - The native part of the component.
+ * @csspart formatted - The part representing the formatted value.
+ * @csspart start - Slot for content before the formatted value.
+ * @csspart end - Slot for content after the formatted value.
+ * @tag wje-format-digital
+ */
+export default class FormatDigital extends WJElement {
+    /**
+     * Returns the CSS styles for the component.
+     * Encapsulated using shadow DOM.
+     * @static
+     * @returns {CSSStyleSheet} - The CSS styles for the component.
+     */
+    static get cssStyleSheet(): CSSStyleSheet;
+    /**
+     * Returns the list of attributes to observe for changes.
+     * Observes `value` and `unit-display` for re-rendering.
+     * @static
+     * @returns {Array<string>} - The attributes to observe.
+     */
+    static get observedAttributes(): Array<string>;
+    localizer: Localizer;
+    /**
+     * Sets the value of the digital format.
+     * This value determines the size in bytes or bits to be displayed.
+     * @param {number} value The value to set.
+     */
+    set value(value: number);
+    /**
+     * Returns the value of the digital format.
+     * @returns {number} The current value of the component.
+     */
+    get value(): number;
+    /**
+     * Sets the unit of the digital format.
+     * Valid values are `bit` or `byte`.
+     * @param {string} value The unit to set.
+     */
+    set unit(value: string);
+    /**
+     * Returns the unit of the digital format.
+     * Defaults to `byte` if no unit is set.
+     * @returns {string} The current unit (`bit` or `byte`).
+     */
+    get unit(): string;
+    /**
+     * Sets the unit display style for the digital format.
+     * Valid values are `short`, `long`, or `narrow`.
+     * @param {string} value The unit display style to set.
+     */
+    set unitDisplay(value: string);
+    /**
+     * Returns the unit display style for the digital format.
+     * Defaults to `short` if not set.
+     * @returns {string} - The current unit display style.
+     */
+    get unitDisplay(): string;
+    /**
+     * Prepares the component before rendering.
+     * Computes the formatted value based on the input value and unit.
+     */
+    beforeDraw(): void;
+    formattedValue: string;
+    /**
+     * Renders the component and returns a document fragment.
+     * The rendered structure includes a formatted value wrapped in a container
+     * with slots for additional customization.
+     * @returns {DocumentFragment} - The DOM structure for the component.
+     */
+    draw(): DocumentFragment;
+}

package/dist/packages/wje-format-digital/format-digital.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/packages/wje-grid/grid.d.ts

@@ -0,0 +1,2 @@
+import { default as Grid } from './grid.element.js';
+export default Grid;

package/dist/packages/wje-grid/grid.element.d.ts

@@ -0,0 +1,26 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary The Grid class is a custom web component that extends WJElement. It is a simple grid that can hold other elements or components.
+ * It provides a slot for adding child elements or components.
+ * @documentation https://elements.webjet.sk/components/grid
+ * @status stable
+ * @augments WJElement
+ * @slot - The slot for adding child elements or components.
+ */
+export default class Grid extends WJElement {
+    /**
+     * Getter for the CSS stylesheet.
+     * @returns {*}
+     */
+    static get cssStyleSheet(): any;
+    /**
+     * Getter for the observed attributes.
+     * @returns {*[]}
+     */
+    static get observedAttributes(): any[];
+    /**
+     * Draws the Grid element.
+     * @returns {DocumentFragment}
+     */
+    draw(): DocumentFragment;
+}

package/dist/packages/wje-header/header.d.ts

@@ -0,0 +1,2 @@
+import { default as Header } from './header.element.js';
+export default Header;

package/dist/packages/wje-header/header.element.d.ts

@@ -0,0 +1,35 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary `Header` is a custom web component that represents a header. It extends from `WJElement`.
+ * @documentation https://elements.webjet.sk/components/header
+ * @status stable
+ * @augments {WJElement}
+ * @csspart native - The native part
+ * @slot default - Default slot for the header content
+ * @cssproperty [--wje-header-background=var(--wje-background)] - The background of the header element.
+ * @cssproperty [--wje-header-border-color=var(--wje-border-color)] - The border color of the header element.
+ * @cssproperty [--wje-header-border-width=0 0 1px 0] - The border width of the header element.
+ * @cssproperty [--wje-header-border-style=solid] - The border styles of the header
+ * @cssproperty [--wje-header-top=0] - The position top of the header
+ * @cssproperty [--wje-header-height=60px] - The height of the header element.
+ * @tag wje-header
+ */
+export default class Header extends WJElement {
+    /**
+     * Returns the CSS styles for the component.
+     * @static
+     * @returns {CSSStyleSheet}
+     */
+    static get cssStyleSheet(): CSSStyleSheet;
+    /**
+     * Returns the list of attributes to observe for changes.
+     * @static
+     * @returns {Array<string>}
+     */
+    static get observedAttributes(): Array<string>;
+    /**
+     * Draws the component.
+     * @returns {DocumentFragment}
+     */
+    draw(): DocumentFragment;
+}

package/dist/packages/wje-icon/icon.d.ts

@@ -0,0 +1,2 @@
+import { default as Icon } from './icon.element.js';
+export default Icon;

package/dist/packages/wje-icon/icon.element.d.ts

@@ -0,0 +1,40 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary This element represents an icon. `IconElement` is a custom web component that represents an icon.
+ * @documentation https://elements.webjet.sk/components/icon
+ * @status stable
+ * @augments WJElement
+ * @csspart svg - The SVG part of the icon
+ * @cssproperty [--wje-icon-size=1rem] - The size of the icon element
+ * @cssproperty [--wje-icon-width=var(--wje-icon-size, 100%)] - The width of the icon element
+ * @cssproperty [--wje-icon-height=var(--wje-icon-size, 100%)] - The height of the icon element
+ * @tag wje-icon
+ */
+export default class Icon extends WJElement {
+    /**
+     * Returns the CSS styles for the component.
+     * @static
+     * @returns {CSSStyleSheet}
+     */
+    static get cssStyleSheet(): CSSStyleSheet;
+    /**
+     * Returns the list of attributes to observe for changes.
+     * @static
+     * @returns {Array<string>}
+     */
+    static get observedAttributes(): Array<string>;
+    /**
+     * Draws the component.
+     * @param {object} context The context for drawing.
+     * @param {object} store The store for drawing.
+     * @param {object} params The parameters for drawing.
+     * @returns {DocumentFragment}
+     */
+    draw(context: object, store: object, params: object): DocumentFragment;
+    url: string;
+    native: HTMLDivElement;
+    /**
+     * Called after the component has been drawn.
+     */
+    afterDraw(): void;
+}

package/dist/packages/wje-icon/service/library.d.ts

@@ -0,0 +1,3 @@
+export function getIconLibrary(name: any): any;
+export function registerIconLibrary(name: any, options: any): void;
+export function unregisterIconLibrary(name: any): void;

package/dist/packages/wje-icon/service/service.d.ts

@@ -0,0 +1,11 @@
+export const iconContent: Map<any, any>;
+export function getSrc(src: string): string | null;
+export function isSrc(str: string): boolean;
+export function isSvgDataUrl(url: string): boolean;
+export function isEncodedDataUrl(url: string): boolean;
+export function isStr(val: any): boolean;
+export function validateContent(svgContent: string): string;
+export function isValid(elm: Element | Node): boolean;
+export function getSvgContent(url: string, sanitize?: boolean): Promise<void>;
+export function getUrl(i: HTMLElement): string | null;
+export function getName(iconName: string): string | null;

package/dist/packages/wje-icon-picker/icon-picker.d.ts

@@ -0,0 +1,2 @@
+import { default as IconPicker } from './icon-picker.element.js';
+export default IconPicker;