wj-elements 0.2.0-alpha.5 → 0.2.0-alpha.7

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

@@ -1,341 +0,0 @@
-import { UniversalService } from '../utils/universal-service.js';
-import { defaultStoreActions } from '../wje-store/store.js';
-import { Permissions } from '../utils/permissions.js';
-import { WjElementUtils } from '../utils/element-utils.js';
-import { event } from '../utils/event.js';
-export default class WJElement extends HTMLElement {
-    /**
-     * Processes and combines two templates into one.
-     * @param pTemplate The primary template.
-     * @param inputTemplate The secondary template.
-     * @returns The combined template.
-     */
-    static processTemplates: (pTemplate: any, inputTemplate: any) => HTMLTemplateElement;
-    /**
-     * Defines a custom element if not already defined.
-     * @param name The name of the custom element.
-     * @param [elementConstructor] The constructor for the custom element.
-     * @param [options] Additional options for defining the element.
-     */
-    static define(name: any, elementConstructor?: typeof WJElement, options?: {}): void;
-    service: UniversalService;
-    _dependencies: {};
-    /**
-     * @typedef {object} DrawingStatuses
-     * @property {number} CREATED - The component has been created.
-     * @property {number} ATTACHED - The component has been attached to the DOM.
-     * @property {number} BEGINING - The component is beginning to draw.
-     * @property {number} START - The component has started drawing.
-     * @property {number} DRAWING - The component is drawing.
-     * @property {number} DONE - The component has finished drawing.
-     * @property {number} DISCONNECTED - The component has been disconnected from the DOM.
-     */
-    /**
-     * WJElement is a base class for custom web components with managed lifecycle, attribute/property sync,
-     * permission-based visibility, and extensibility hooks.
-     * @property {boolean} isAttached - True if the component is currently attached to the DOM.
-     * @property {DrawingStatuses} drawingStatuses - Enum of possible drawing states.
-     * @property {number} drawingStatus - Current drawing status (see drawingStatuses).
-     * @property {boolean} _pristine - True if the component has not been updated since last render.
-     * @property {boolean} isRendering - True if a render is currently in progress.
-     * @property {number|null} rafId - ID of the scheduled animation frame for rendering, or null.
-     * @property {string|null} originalVisibility - Stores the original CSS visibility before rendering.
-     * @property {object} params - Stores the current attributes/properties for rendering.
-     * @property {Promise<void>} updateComplete - Promise resolved when the current update/render is complete.
-     * @property {string[]} permission - List of required permissions (from 'permission' attribute).
-     * @property {boolean} isPermissionCheck - Whether permission checking is enabled (from 'permission-check' attribute).
-     * @property {boolean} noShow - Whether the element should be hidden (from 'no-show' attribute).
-     * @property {string|undefined} isShadowRoot - Value of the 'shadow' attribute, if present.
-     * @property {boolean} hasShadowRoot - True if the 'shadow' attribute is present.
-     * @property {string} shadowType - Type of shadow root ('open' by default).
-     * @property {object} store - Reference to the global store instance.
-     * @property {object} defaultStoreActions - Default store actions for arrays and objects.
-     * @property {string[]|undefined} removeClassAfterConnect - Classes to remove after connect (from 'remove-class-after-connect' attribute).
-     * @property {object} dependencies - Registered component dependencies.
-     * @property {HTMLElement|ShadowRoot} context - The rendering context (shadow root or element itself).
-     */
-    drawingStatuses: {
-        CREATED: number;
-        ATTACHED: number;
-        BEGINING: number;
-        START: number;
-        DRAWING: number;
-        DONE: number;
-        DISCONNECTED: number;
-    };
-    rafId: number;
-    params: {};
-    updateComplete: Promise<any>;
-    finisPromise: (value: any) => void;
-    rejectPromise: (reason?: any) => void;
-    get drawingStatus(): number;
-    /**
-     * Sets the value of the 'permission' attribute.
-     * @param {string[]} value The value to set for the 'permission' attribute.
-     */
-    set permission(value: string[]);
-    /**
-     * Gets the value of the 'permission-check' attribute.
-     * @returns {string[]} The value of the 'permission' attribute.
-     */
-    get permission(): string[];
-    /**
-     * Sets the 'permission-check' attribute.
-     * @param {boolean} value The value to set for the 'permission-check' attribute.
-     */
-    set isPermissionCheck(value: boolean);
-    /**
-     * Checks if the 'permission-check' attribute is present.
-     * @returns {boolean} True if the 'permission-check' attribute is present.
-     */
-    get isPermissionCheck(): boolean;
-    set noShow(value: boolean);
-    /**
-     * Checks if the 'show' attribute is present.
-     * @returns {boolean} True if the 'show' attribute is present.
-     */
-    get noShow(): boolean;
-    /**
-     * Sets the 'shadow' attribute.
-     * @param {string} value The value to set for the 'shadow' attribute.
-     */
-    set isShadowRoot(value: string);
-    get isShadowRoot(): string;
-    /**
-     * Checks if the 'shadow' attribute is present.
-     * @returns {boolean} True if the 'shadow' attribute is present.
-     */
-    get hasShadowRoot(): boolean;
-    /**
-     * Gets the value of the 'shadow' attribute or 'open' if not set.
-     * @returns {string} The value of the 'shadow' attribute or 'open'.
-     */
-    get shadowType(): string;
-    /**
-     * Gets the rendering context, either the shadow root or the component itself.
-     * @returns The rendering context.
-     */
-    get context(): any;
-    /**
-     * Gets the store instance.
-     * @returns {object} The store instance.
-     */
-    get store(): object;
-    /**
-     * @typedef {object} ArrayActions
-     * @property {Function} addAction - Adds an item to the array.
-     * @property {Function} deleteAction - Deletes an item from the array.
-     * @property {Function} loadAction - Loads an array.
-     * @property {Function} updateAction - Updates an item in the array.
-     * @property {Function} addManyAction - Adds many items to the array.
-     */
-    /**
-     * @typedef {object} ObjectActions
-     * @property {Function} addAction - Replace old object with new object
-     * @property {Function} deleteAction - Delete item based on key
-     * @property {Function} updateAction - Update item based on key
-     */
-    /**
-     * Gets the default store actions.
-     * @returns The default store actions for arrays and objects.
-     */
-    get defaultStoreActions(): typeof defaultStoreActions;
-    /**
-     * Gets the classes to be removed after the component is connected.
-     * @returns An array of class names to remove.
-     */
-    get removeClassAfterConnect(): string[];
-    /**
-     * Sets the component dependencies.
-     * @param value The dependencies to set.
-     */
-    set dependencies(value: {});
-    /**
-     * Gets the component dependencies.
-     * @returns The component dependencies.
-     */
-    get dependencies(): {};
-    /**
-     * Defines component dependencies by registering custom elements.
-     */
-    defineDependencies(): void;
-    /**
-     * Hook for extending behavior before drawing the component.
-     * @param context The rendering context, usually the element's shadow root or main DOM element.
-     * @param appStoreObj The global application store for managing state.
-     * @param params Additional parameters or attributes for rendering the component.
-     */
-    beforeDraw(context: any, appStoreObj: any, params: any): void;
-    /**
-     * Renders the component within the provided context.
-     * @param context The rendering context, usually the element's shadow root or main DOM element.
-     * @param appStoreObj
-     * @param params Additional parameters or attributes for rendering the component.
-     * @returns This implementation does not render anything and returns `null`.
-     * @description
-     * The `draw` method is responsible for rendering the component's content.
-     * Override this method in subclasses to define custom rendering logic.
-     * @example
-     * class MyComponent extends WJElement {
-     *   draw(context, appStoreObj, params) {
-     *     const div = document.createElement('div');
-     *     div.textContent = 'Hello, world!';
-     *     context.appendChild(div);
-     *   }
-     * }
-     */
-    draw(context: any, appStoreObj: any, params: any): any;
-    /**
-     * Renders the component within the provided context.
-     * @param context The rendering context, usually the element's shadow root or main DOM element.
-     * @param appStore The global application store for managing state.
-     * @param params Additional parameters or attributes for rendering the component.
-     * @returns This implementation does not render anything and returns `null`.
-     * @description
-     * The `draw` method is responsible for rendering the component's content.
-     * Override this method in subclasses to define custom rendering logic.
-     * @example
-     * class MyComponent extends WJElement {
-     *   draw(context, appStore, params) {
-     *     const div = document.createElement('div');
-     *     div.textContent = 'Hello, world!';
-     *     context.appendChild(div);
-     *   }
-     * }
-     */
-    draw(context: any, appStore: any, params: any): any;
-    /**
-     * Hook for extending behavior after drawing the component.
-     * @param context The rendering context, usually the element's shadow root or main DOM element.
-     * @param appStoreObj The global application store for managing state.
-     * @param params Additional parameters or attributes for rendering the component.
-     */
-    afterDraw(context: any, appStoreObj: any, params: any): void;
-    /**
-     * Optional hook: return skeleton markup used while async draw is in progress.
-     * Prefer declarative skeleton via `<div slot="skeleton">...</div>`.
-     * Return: string | Node | DocumentFragment | null | Promise of those.
-     */
-    renderSkeleton(params: any): any;
-    set skeletonDelay(value: number);
-    /**
-     * Retrieves the delay duration for the skeleton display, determining the value based on a hierarchy of overrides and defaults.
-     * The method prioritizes in the following order:
-     * 1. A finite number set as the `_wjSkeletonSlotClone` property.
-     * 2. A valid numeric value from the `skeleton-delay` attribute.
-     * 3. The `skeletonDelayMs` property, if defined with a finite number.
-     * 4. A default value of 150 if none of the above are set.
-     * @returns {number} The delay in milliseconds before the skeleton is displayed.
-     */
-    get skeletonDelay(): number;
-    set skeletonMinDuration(value: number);
-    /**
-     * Retrieves the minimum duration for the skeleton animation.
-     * The method checks for an internally stored finite value. If unavailable,
-     * it retrieves the value from the 'skeleton-min-duration' attribute,
-     * converts it to a number if possible, and uses it. If neither is valid,
-     * a default duration of 300 is returned.
-     * @returns {number} The minimum duration for the skeleton animation in milliseconds.
-     */
-    get skeletonMinDuration(): number;
-    _wjSkeletonSlotClone: number | Node;
-    set skeleton(value: boolean);
-    get skeleton(): boolean;
-    get skeletonDelayValue(): number;
-    /**
-     * Lifecycle method invoked when the component is connected to the DOM.
-     */
-    connectedCallback(): void;
-    /**
-     * Initializes the component, setting up attributes and rendering.
-     * @param [force] Whether to force initialization.
-     * @returns A promise that resolves when initialization is complete.
-     */
-    initWjElement: (force?: boolean) => Promise<any>;
-    /**
-     * Sets up attributes and event listeners for the component.
-     * This method retrieves all custom events defined for the component
-     * and adds event listeners for each of them. When an event is triggered,
-     * it calls the corresponding method on the host element.
-     */
-    setupAttributes(): void;
-    /**
-     * Hook for extending behavior before disconnecting the component.
-     */
-    beforeDisconnect(): void;
-    /**
-     * Hook for extending behavior after disconnecting the component.
-     */
-    afterDisconnect(): void;
-    /**
-     * Hook for extending behavior before redrawing the component.
-     */
-    beforeRedraw(): void;
-    /**
-     * Cleans up resources and event listeners for the component.
-     */
-    componentCleanup(): void;
-    /**
-     * Lifecycle method invoked when the component is disconnected from the DOM.
-     */
-    disconnectedCallback(): void;
-    /**
-     * Lifecycle method invoked when an observed attribute changes.
-     * @param name The name of the attribute that changed.
-     * @param old The old value of the attribute.
-     * @param newName The new value of the attribute.
-     */
-    attributeChangedCallback(name: any, old: any, newName: any): void;
-    refresh(): void;
-    stopRenderLoop(): void;
-    /**
-     * Displays the component's content, optionally forcing a re-render.
-     * @param [force] Whether to force a re-render.
-     * @returns A promise that resolves when the display is complete.
-     */
-    display(force?: boolean): Promise<void>;
-    template: any;
-    /**
-     * Renders the content into the provided target context.
-     * This method handles asynchronous rendering, processes the output from the `draw` method,
-     * and appends the resulting content to the specified target context.
-     * @returns {Promise<void>} A promise that resolves once the render operation is complete and the content is appended to the target context.
-     * @param targetContext
-     */
-    render(targetContext?: any): Promise<void>;
-    /**
-     * Sanitizes a given name by converting it from kebab-case to camelCase.
-     * @param {string} name The name in kebab-case format (e.g., "example-name").
-     * @returns {string} The sanitized name in camelCase format (e.g., "exampleName").
-     * @example
-     * sanitizeName('example-name');
-     * @example
-     * sanitizeName('my-custom-component');
-     */
-    sanitizeName(name: string): string;
-    /**
-     * Checks if a property on an object has a getter or setter method defined.
-     * @param {object} obj The object on which the property is defined.
-     * @param {string} property The name of the property to check.
-     * @returns {object} An object indicating the presence of getter and setter methods.
-     * @property {Function|null} hasGetter The getter function if it exists, otherwise `null`.
-     * @property {Function|null} hasSetter The setter function if it exists, otherwise `null`.
-     * @example
-     * const obj = {
-     *   get name() { return 'value'; },
-     *   set name(val) { console.log(val); }
-     * };
-     * checkGetterSetter(obj, 'name');
-     * @example
-     * const obj = { prop: 42 };
-     * checkGetterSetter(obj, 'prop');
-     */
-    checkGetterSetter(obj: object, property: string): object;
-    /**
-     * Sets up property accessors for the component's attributes.
-     */
-    setUpAccessors(): void;
-    #private;
-}
-export let __esModule: string;
-export { Permissions, WjElementUtils, event };

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

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

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

@@ -1,203 +0,0 @@
-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;
-    /**
-     * Sets the maximum number of files that can be uploaded or managed.
-     * Assigns the specified value to the 'max-files' attribute.
-     * @param {number} value The maximum allowable number of files.
-     */
-    set maxFiles(value: number);
-    /**
-     * Retrieves the maximum number of files allowed from the `max-files` attribute.
-     * If the attribute is not set or is invalid, defaults to 0.
-     * @returns {number} The maximum number of files allowed.
-     */
-    get maxFiles(): number;
-    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/file-upload.test.d.ts

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

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

@@ -1,70 +0,0 @@
-/**
- * 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

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