npm - tiny-essentials - Versions diffs - 1.11.0 → 1.12.0 - Mend

tiny-essentials 1.11.0 → 1.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (72) hide show

package/README.md +12 -3
package/dist/node_modules/firebase-functions/lib/common/trace.cjs +82 -0
package/dist/node_modules/firebase-functions/lib/logger/common.cjs +57 -0
package/dist/node_modules/firebase-functions/lib/logger/index.cjs +158 -0
package/dist/v1/TinyBasicsEs.js +1653 -1
package/dist/v1/TinyBasicsEs.min.js +1 -1
package/dist/v1/TinyDragDropDetector.js +307 -0
package/dist/v1/TinyDragDropDetector.min.js +1 -0
package/dist/v1/TinyDragger.js +3563 -0
package/dist/v1/TinyDragger.min.js +2 -0
package/dist/v1/TinyDragger.min.js.LICENSE.txt +8 -0
package/dist/v1/TinyEssentials.js +2783 -2
package/dist/v1/TinyEssentials.min.js +1 -1
package/dist/v1/TinyNotifyCenter.js +32 -0
package/dist/v1/TinyNotifyCenter.min.js +1 -1
package/dist/v1/TinyToastNotify.js +24 -0
package/dist/v1/TinyToastNotify.min.js +1 -1
package/dist/v1/TinyUploadClicker.js +5235 -0
package/dist/v1/TinyUploadClicker.min.js +2 -0
package/dist/v1/TinyUploadClicker.min.js.LICENSE.txt +8 -0
package/dist/v1/basics/fileManager.cjs +524 -0
package/dist/v1/basics/fileManager.d.mts +209 -0
package/dist/v1/basics/fileManager.mjs +443 -0
package/dist/v1/basics/fullScreen.cjs +134 -0
package/dist/v1/basics/fullScreen.d.mts +8 -0
package/dist/v1/basics/fullScreen.mjs +121 -0
package/dist/v1/basics/html.cjs +262 -0
package/dist/v1/basics/html.d.mts +63 -0
package/dist/v1/basics/html.mjs +208 -0
package/dist/v1/basics/index.cjs +40 -0
package/dist/v1/basics/index.d.mts +38 -1
package/dist/v1/basics/index.mjs +4 -1
package/dist/v1/build/TinyDragDropDetector.cjs +7 -0
package/dist/v1/build/TinyDragDropDetector.d.mts +3 -0
package/dist/v1/build/TinyDragDropDetector.mjs +2 -0
package/dist/v1/build/TinyDragger.cjs +7 -0
package/dist/v1/build/TinyDragger.d.mts +3 -0
package/dist/v1/build/TinyDragger.mjs +2 -0
package/dist/v1/build/TinyUploadClicker.cjs +7 -0
package/dist/v1/build/TinyUploadClicker.d.mts +3 -0
package/dist/v1/build/TinyUploadClicker.mjs +2 -0
package/dist/v1/css/TinyDraggerExample.css +21 -0
package/dist/v1/css/TinyDraggerExample.min.css +1 -0
package/dist/v1/index.cjs +44 -0
package/dist/v1/index.d.mts +40 -1
package/dist/v1/index.mjs +6 -1
package/dist/v1/libs/TinyDragDropDetector.cjs +268 -0
package/dist/v1/libs/TinyDragDropDetector.d.mts +123 -0
package/dist/v1/libs/TinyDragDropDetector.mjs +228 -0
package/dist/v1/libs/TinyDragger.cjs +801 -0
package/dist/v1/libs/TinyDragger.d.mts +300 -0
package/dist/v1/libs/TinyDragger.mjs +689 -0
package/dist/v1/libs/TinyNotifyCenter.cjs +32 -0
package/dist/v1/libs/TinyNotifyCenter.d.mts +9 -0
package/dist/v1/libs/TinyNotifyCenter.mjs +28 -0
package/dist/v1/libs/TinyToastNotify.cjs +24 -0
package/dist/v1/libs/TinyToastNotify.d.mts +8 -0
package/dist/v1/libs/TinyToastNotify.mjs +20 -0
package/dist/v1/libs/TinyUploadClicker.cjs +223 -0
package/dist/v1/libs/TinyUploadClicker.d.mts +80 -0
package/dist/v1/libs/TinyUploadClicker.mjs +182 -0
package/docs/v1/README.md +8 -2
package/docs/v1/basics/fileManager.md +222 -0
package/docs/v1/basics/fullScreen.md +183 -0
package/docs/v1/basics/html.md +243 -0
package/docs/v1/libs/TinyDragDropDetector.md +143 -0
package/docs/v1/libs/TinyDragger.md +415 -0
package/docs/v1/libs/TinyLevelUp.md +1 -1
package/docs/v1/libs/TinyNotifyCenter.md +20 -0
package/docs/v1/libs/TinyToastNotify.md +19 -0
package/docs/v1/libs/TinyUploadClicker.md +108 -0
package/package.json +12 -2

package/dist/v1/libs/TinyDragger.d.mts ADDED Viewed

@@ -0,0 +1,300 @@
+export default TinyDragger;
+export type VibrationPatterns = {
+    /**
+     * - Pattern to vibrate on start
+     */
+    start: number[] | false;
+    /**
+     * - Pattern to vibrate on end
+     */
+    end: number[] | false;
+    /**
+     * - Pattern to vibrate on collision
+     */
+    collide: number[] | false;
+    /**
+     * - Pattern to vibrate while moving
+     */
+    move: number[] | false;
+};
+/**
+ * @typedef {Object} VibrationPatterns
+ * @property {number[]|false} start - Pattern to vibrate on start
+ * @property {number[]|false} end - Pattern to vibrate on end
+ * @property {number[]|false} collide - Pattern to vibrate on collision
+ * @property {number[]|false} move - Pattern to vibrate while moving
+ */
+/**
+ * TinyDragger enables drag-and-drop functionality for a DOM element.
+ * It supports jail boundaries, optional collision detection, vibration feedback,
+ * automatic reverting, proxy dragging, and event dispatching.
+ */
+declare class TinyDragger {
+    /** @typedef {(event: TouchEvent) => void} TouchDragEvent */
+    /**
+     * @param {HTMLElement} targetElement - The element to make draggable.
+     * @param {Object} [options={}] - Configuration options.
+     * @param {HTMLElement} [options.jail] - Optional container to restrict dragging within.
+     * @param {boolean} [options.collisionByMouse=false] - Use mouse position for collision instead of element rect.
+     * @param {string} [options.classDragging='dragging'] - CSS class applied to the clone during dragging.
+     * @param {string} [options.classBodyDragging='drag-active'] - CSS class applied to <body> during dragging.
+     * @param {string} [options.classJailDragging='jail-drag-active'] - CSS class applied to jail element during drag.
+     * @param {string} [options.classJailDragDisabled='jail-drag-disabled'] - CSS class applied to jail element disabled.
+     * @param {string} [options.classDragCollision='dragging-collision'] - CSS class applied to collision element.
+     * @param {boolean} [options.lockInsideJail=false] - Restrict movement within the jail container.
+     * @param {boolean} [options.dropInJailOnly=false] - Restrict drop within the jail container.
+     * @param {VibrationPatterns|false} [options.vibration=false] - Vibration feedback configuration.
+     * @param {boolean} [options.revertOnDrop=false] - Whether to return to original position on drop.
+     * @param {string} [options.classHidden='drag-hidden'] - CSS class to hide original element during dragging.
+     * @throws {Error} If any option has an invalid type.
+     */
+    constructor(targetElement: HTMLElement, options?: {
+        jail?: HTMLElement | undefined;
+        collisionByMouse?: boolean | undefined;
+        classDragging?: string | undefined;
+        classBodyDragging?: string | undefined;
+        classJailDragging?: string | undefined;
+        classJailDragDisabled?: string | undefined;
+        classDragCollision?: string | undefined;
+        lockInsideJail?: boolean | undefined;
+        dropInJailOnly?: boolean | undefined;
+        vibration?: false | VibrationPatterns | undefined;
+        revertOnDrop?: boolean | undefined;
+        classHidden?: string | undefined;
+    });
+    /** @private */
+    private _onMouseDown;
+    /** @private */
+    private _onMouseMove;
+    /** @private */
+    private _onMouseUp;
+    /**
+     * @type {TouchDragEvent}
+     * @private
+     */
+    private _onTouchStart;
+    /**
+     * @type {TouchDragEvent}
+     * @private
+     */
+    private _onTouchMove;
+    /**
+     * @type {TouchDragEvent}
+     * @private
+     */
+    private _onTouchEnd;
+    /**
+     * Enables the drag functionality.
+     */
+    enable(): void;
+    /**
+     * Disables the drag functionality.
+     */
+    disable(): void;
+    /**
+     * Adds an element to be considered for collision detection.
+     * @param {HTMLElement} element - The element to track collisions with.
+     * @throws {Error} If the element is not a valid HTMLElement.
+     */
+    addCollidable(element: HTMLElement): void;
+    /**
+     * Removes a collidable element from the tracking list.
+     * @param {HTMLElement} element - The element to remove.
+     * @throws {Error} If the element is not a valid HTMLElement.
+     */
+    removeCollidable(element: HTMLElement): void;
+    /**
+     * Sets vibration patterns for drag events.
+     * @param {Object} [param0={}] - Vibration pattern configuration.
+     * @param {number[]|false} [param0.startPattern=false] - Vibration on drag start.
+     * @param {number[]|false} [param0.endPattern=false] - Vibration on drag end.
+     * @param {number[]|false} [param0.collidePattern=false] - Vibration on collision.
+     * @param {number[]|false} [param0.movePattern=false] - Vibration during movement.
+     * @throws {Error} If any pattern is not false or an array of numbers.
+     */
+    setVibrationPattern({ startPattern, endPattern, collidePattern, movePattern, }?: {
+        startPattern?: false | number[] | undefined;
+        endPattern?: false | number[] | undefined;
+        collidePattern?: false | number[] | undefined;
+        movePattern?: false | number[] | undefined;
+    }): void;
+    /**
+     * Disables all vibration feedback.
+     */
+    disableVibration(): void;
+    /**
+     * Calculates the cursor offset relative to the top-left of the target element.
+     * @param {MouseEvent|Touch} event - The mouse or touch event.
+     * @returns {{x: number, y: number}} The offset in pixels.
+     * @throws {Error} If event is not a MouseEvent or Touch with clientX/clientY.
+     */
+    getOffset(event: MouseEvent | Touch): {
+        x: number;
+        y: number;
+    };
+    /**
+     * Handles dragging collision.
+     * @param {MouseEvent|Touch} event - The drag event.
+     */
+    checkDragCollision(event: MouseEvent | Touch): void;
+    /**
+     * Handles the collision of a drag.
+     * @param {MouseEvent|Touch} event - The release event.
+     * @returns {{ inJail: boolean; collidedElement: HTMLElement|null }}
+     */
+    execCollision(event: MouseEvent | Touch): {
+        inJail: boolean;
+        collidedElement: HTMLElement | null;
+    };
+    /**
+     * Detects collision based on rectangle intersection.
+     * @param {DOMRect} rect - Bounding rectangle of the dragged proxy.
+     * @returns {HTMLElement|null} The collided element or null.
+     * @throws {Error} If rect is not a DOMRect with valid numeric properties.
+     */
+    getCollidedElementByRect(rect: DOMRect): HTMLElement | null;
+    /**
+     * Detects collision with a point using element bounding rectangles.
+     * @param {number} x - Horizontal screen coordinate.
+     * @param {number} y - Vertical screen coordinate.
+     * @returns {HTMLElement|null} The collided element or null.
+     */
+    getCollidedElement(x: number, y: number): HTMLElement | null;
+    /**
+     * Gets whether dragging is currently active.
+     * @returns {boolean}
+     */
+    getDragging(): boolean;
+    /**
+     * Gets whether movement is restricted inside the jail container.
+     * @returns {boolean}
+     */
+    getLockInsideJail(): boolean;
+    /**
+     * Sets whether movement is restricted inside the jail container.
+     * @param {boolean} value
+     */
+    setLockInsideJail(value: boolean): void;
+    /**
+     * Gets whether the element should revert to original position on drop.
+     * @returns {boolean}
+     */
+    getRevertOnDrop(): boolean;
+    /**
+     * Sets whether the element should revert to original position on drop.
+     * @param {boolean} value
+     */
+    setRevertOnDrop(value: boolean): void;
+    /**
+     * Gets whether collision detection uses mouse position.
+     * @returns {boolean}
+     */
+    getCollisionByMouse(): boolean;
+    /**
+     * Sets whether collision detection uses mouse position.
+     * @param {boolean} value
+     */
+    setCollisionByMouse(value: boolean): void;
+    /**
+     * Gets whether dropping is restricted inside the jail container.
+     * @returns {boolean}
+     */
+    getDropInJailOnly(): boolean;
+    /**
+     * Sets whether dropping is restricted inside the jail container.
+     * @param {boolean} value
+     */
+    setDropInJailOnly(value: boolean): void;
+    /**
+     * Returns the original target element being dragged.
+     * @returns {HTMLElement}
+     */
+    getTarget(): HTMLElement;
+    /**
+     * Returns the current jail container (if any).
+     * @returns {HTMLElement|null}
+     */
+    getJail(): HTMLElement | null;
+    /**
+     * Returns the current proxy element being dragged (if any).
+     * @returns {HTMLElement|null}
+     */
+    getDragProxy(): HTMLElement | null;
+    /**
+     * Returns the last collided element (if any).
+     * @returns {HTMLElement|null}
+     */
+    getLastCollision(): HTMLElement | null;
+    /**
+     * Returns all registered collidable elements.
+     * @returns {HTMLElement[]}
+     */
+    getCollidables(): HTMLElement[];
+    /**
+     * Returns the CSS class used to hide the target during drag.
+     * @returns {string}
+     */
+    getDragHiddenClass(): string;
+    /**
+     * Returns the CSS class applied to the clone during dragging.
+     * @returns {string}
+     */
+    getClassDragging(): string;
+    /**
+     * Returns the CSS class applied to <body> during dragging.
+     * @returns {string}
+     */
+    getClassBodyDragging(): string;
+    /**
+     * Returns the CSS class applied to the jail during dragging.
+     * @returns {string}
+     */
+    getClassJailDragging(): string;
+    /**
+     * Returns the CSS class applied to the jail when dragging is disabled.
+     * @returns {string}
+     */
+    getClassJailDragDisabled(): string;
+    /**
+     * Returns the CSS class applied to a collided element.
+     * @returns {string}
+     */
+    getClassDragCollision(): string;
+    /**
+     * Returns the full vibration configuration.
+     * @returns {VibrationPatterns}
+     */
+    getVibrations(): VibrationPatterns;
+    /**
+     * Returns the vibration pattern for drag start.
+     * @returns {number[]|boolean}
+     */
+    getStartVibration(): number[] | boolean;
+    /**
+     * Returns the vibration pattern for drag end.
+     * @returns {number[]|boolean}
+     */
+    getEndVibration(): number[] | boolean;
+    /**
+     * Returns the vibration pattern for collisions.
+     * @returns {number[]|boolean}
+     */
+    getCollideVibration(): number[] | boolean;
+    /**
+     * Returns the vibration pattern during movement.
+     * @returns {number[]|boolean}
+     */
+    getMoveVibration(): number[] | boolean;
+    /**
+     * Returns whether the dragger is currently enabled.
+     * @returns {boolean}
+     */
+    isEnabled(): boolean;
+    /**
+     * Completely disables drag-and-drop and cleans up all event listeners.
+     * Does NOT remove the original HTML element.
+     */
+    destroy(): void;
+    #private;
+}
+//# sourceMappingURL=TinyDragger.d.mts.map