tiny-essentials 1.20.0 → 1.20.2

package/dist/v1/TinyTimeout.js

@@ -1,233 +0,0 @@
-/******/ (() => { // webpackBootstrap
-/******/ 	"use strict";
-/******/ 	// The require scope
-/******/ 	var __webpack_require__ = {};
-/******/ 	
-/************************************************************************/
-/******/ 	/* webpack/runtime/define property getters */
-/******/ 	(() => {
-/******/ 		// define getter functions for harmony exports
-/******/ 		__webpack_require__.d = (exports, definition) => {
-/******/ 			for(var key in definition) {
-/******/ 				if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {
-/******/ 					Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });
-/******/ 				}
-/******/ 			}
-/******/ 		};
-/******/ 	})();
-/******/ 	
-/******/ 	/* webpack/runtime/hasOwnProperty shorthand */
-/******/ 	(() => {
-/******/ 		__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))
-/******/ 	})();
-/******/ 	
-/************************************************************************/
-var __webpack_exports__ = {};
-
-// EXPORTS
-__webpack_require__.d(__webpack_exports__, {
-  TinyTimeout: () => (/* reexport */ libs_TinyTimeout)
-});
-
-;// ./src/v1/libs/TinyTimeout.mjs
-/**
- * A utility class to manage dynamically adjusted timeouts based on how often
- * each unique ID is triggered. Also provides polling support for asynchronous conditions.
- */
-class TinyTimeout {
-  /** @type {boolean} Whether this instance has been destroyed. */
-  #isDestroyed = false;
-
-  /** @type {boolean} Whether to allow auto-updating an ID's timeout config if `value` changes. */
-  #allowAutoConfigChange;
-
-  /** @type {number} The interval time (ms) used to decrement cooldown counters. */
-  #cooldownWatcherTime;
-
-  /** @type {NodeJS.Timeout|null} Reference to the internal cooldown interval. */
-  #cooldownWatcher = null;
-
-  /**
-   * Internal map that keeps track of how many times each ID has been triggered,
-   * along with the base multiplier used to calculate delays.
-   *
-   * @type {Map<string, { value: number, now: number }>}
-   */
-  #timeoutFixer = new Map();
-
-  /**
-   * Creates a new instance of TinyTimeout.
-   *
-   * @param {Object} [options={}] Optional configuration object.
-   * @param {number} [options.cooldownWatcherTime=5000] Interval in milliseconds for reducing `now` counters.
-   * @param {boolean} [options.allowAutoConfigChange=false] Whether to allow auto value changes for existing IDs.
-   */
-  constructor({ cooldownWatcherTime = 5000, allowAutoConfigChange = false } = {}) {
-    if (!Number.isFinite(cooldownWatcherTime) || cooldownWatcherTime <= 0)
-      throw new TypeError(`Expected 'cooldownWatcherTime' to be a positive number.`);
-    if (typeof allowAutoConfigChange !== 'boolean')
-      throw new TypeError(`Expected 'allowAutoConfigChange' to be a boolean.`);
-    this.#cooldownWatcherTime = cooldownWatcherTime;
-    this.#allowAutoConfigChange = allowAutoConfigChange;
-    this.setCooldownWatcherTime(cooldownWatcherTime);
-  }
-
-  /**
-   * Whether this instance has been destroyed and is no longer usable.
-   *
-   * @returns {boolean}
-   */
-  isDestroyed() {
-    return this.#isDestroyed;
-  }
-
-  /**
-   * Whether auto config change is enabled.
-   *
-   * @returns {boolean}
-   */
-  getAllowAutoConfigChange() {
-    return this.#allowAutoConfigChange;
-  }
-
-  /**
-   * Gets the interval time used for cooldown decrementing.
-   *
-   * @returns {number}
-   */
-  getCooldownWatcherTime() {
-    return this.#cooldownWatcherTime;
-  }
-
-  /**
-   * Sets whether to allow auto-updating an ID's timeout config if `value` changes.
-   *
-   * @param {boolean} value
-   */
-  setAllowAutoConfigChange(value) {
-    if (typeof value !== 'boolean') throw new TypeError(`Expected 'value' to be a boolean.`);
-    this.#allowAutoConfigChange = value;
-  }
-
-  /**
-   * Sets the cooldown watcher interval time.
-   * Automatically resets the interval if it was already running.
-   *
-   * @param {number} value
-   */
-  setCooldownWatcherTime(value) {
-    if (this.#isDestroyed) throw new Error('TinyTimeout has been destroyed.');
-    if (!Number.isFinite(value) || value <= 0)
-      throw new TypeError(`Expected 'value' to be a positive number.`);
-
-    this.#cooldownWatcherTime = value;
-
-    if (this.#cooldownWatcher) clearInterval(this.#cooldownWatcher);
-    this.#cooldownWatcher = setInterval(() => {
-      this.#timeoutFixer.forEach((data) => {
-        if (data.now > 0) data.now--;
-      });
-    }, this.#cooldownWatcherTime);
-  }
-
-  /**
-   * Schedules a callback using a dynamically adjusted timeout based on usage frequency.
-   * The more often an ID is triggered, the longer the timeout becomes,
-   * scaled by the provided `value`. Optionally, the delay can be limited by `limit`.
-   *
-   * @param {string} id - A unique identifier to track timeout usage.
-   * @param {Function} callback - The function to execute after the delay.
-   * @param {number} value - Base delay multiplier in milliseconds.
-   * @param {number|null} [limit=null] - Optional maximum delay cap.
-   * @returns {number} Handle to the scheduled timeout.
-   * @throws {Error} Throws if the instance has been destroyed or arguments are invalid.
-   */
-  set(id, callback, value, limit = null) {
-    if (this.#isDestroyed) throw new Error('TinyTimeout has been destroyed.');
-    if (typeof id !== 'string' || id.trim() === '')
-      throw new TypeError(`Expected 'id' to be a non-empty string.`);
-    if (typeof callback !== 'function')
-      throw new TypeError(`Expected 'callback' to be a function.`);
-    if (!Number.isFinite(value) || value < 0)
-      throw new TypeError(`Expected 'value' to be a non-negative number.`);
-    if (limit !== null && (!Number.isFinite(limit) || limit < 0))
-      throw new TypeError(`Expected 'limit' to be null or a non-negative number.`);
-
-    let entry = this.#timeoutFixer.get(id);
-    if (!entry || (this.#allowAutoConfigChange && value !== entry.value)) {
-      entry = { value, now: 0 };
-      this.#timeoutFixer.set(id, entry);
-    }
-
-    const delay = entry.value * entry.now;
-    entry.now++;
-
-    return setTimeout(callback, typeof limit === 'number' ? Math.min(delay, limit) : delay);
-  }
-
-  /**
-   * Waits until a provided function returns `true`, checking repeatedly at the defined interval.
-   * Useful for polling asynchronous conditions.
-   *
-   * @param {() => boolean} getValue - A function that returns `true` when the condition is met.
-   * @param {number} [checkInterval=100] - How often (in ms) to check the condition.
-   * @returns {Promise<void>} Resolves when the condition is met.
-   * @throws {TypeError} If arguments are invalid.
-   */
-  static waitForTrue(getValue, checkInterval = 100) {
-    if (typeof getValue !== 'function')
-      throw new TypeError(`Expected 'getValue' to be a function.`);
-    if (!Number.isFinite(checkInterval) || checkInterval <= 0)
-      throw new TypeError(`Expected 'checkInterval' to be a positive number.`);
-
-    return new Promise((resolve) => {
-      const interval = setInterval(() => {
-        if (getValue()) {
-          clearInterval(interval);
-          resolve();
-        }
-      }, checkInterval);
-    });
-  }
-
-  /**
-   * Instance version of `waitForTrue`, which defaults to using the instance's
-   * cooldownWatcherTime if not explicitly provided.
-   *
-   * @param {() => boolean} getValue - A function that returns `true` when the condition is met.
-   * @param {number|null} [checkInterval=100] - How often (in ms) to check the condition.
-   * @returns {Promise<void>} Resolves when the condition is met.
-   * @throws {Error} If the instance is destroyed or arguments are invalid.
-   */
-  waitForTrue(getValue, checkInterval = 100) {
-    if (this.#isDestroyed) throw new Error('TinyTimeout has been destroyed.');
-    if (typeof getValue !== 'function')
-      throw new TypeError(`Expected 'getValue' to be a function.`);
-    if (checkInterval !== null && (!Number.isFinite(checkInterval) || checkInterval <= 0))
-      throw new TypeError(`Expected 'checkInterval' to be null or a positive number.`);
-    return TinyTimeout.waitForTrue(getValue, checkInterval ?? this.#cooldownWatcherTime);
-  }
-
-  /**
-   * Cleans up all internal references and stops the cooldown watcher.
-   * After calling this, the instance becomes unusable.
-   */
-  destroy() {
-    if (this.#isDestroyed) return;
-    this.#isDestroyed = true;
-    if (this.#cooldownWatcher) clearInterval(this.#cooldownWatcher);
-    this.#cooldownWatcher = null;
-    this.#timeoutFixer.clear();
-  }
-}
-
-/* harmony default export */ const libs_TinyTimeout = (TinyTimeout);
-
-;// ./src/v1/build/TinyTimeout.mjs
-
-
-
-
-window.TinyTimeout = __webpack_exports__.TinyTimeout;
-/******/ })()
-;

package/dist/v1/TinyToastNotify.js

@@ -1,441 +0,0 @@
-/******/ (() => { // webpackBootstrap
-/******/ 	"use strict";
-/******/ 	// The require scope
-/******/ 	var __webpack_require__ = {};
-/******/ 	
-/************************************************************************/
-/******/ 	/* webpack/runtime/define property getters */
-/******/ 	(() => {
-/******/ 		// define getter functions for harmony exports
-/******/ 		__webpack_require__.d = (exports, definition) => {
-/******/ 			for(var key in definition) {
-/******/ 				if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {
-/******/ 					Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });
-/******/ 				}
-/******/ 			}
-/******/ 		};
-/******/ 	})();
-/******/ 	
-/******/ 	/* webpack/runtime/hasOwnProperty shorthand */
-/******/ 	(() => {
-/******/ 		__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))
-/******/ 	})();
-/******/ 	
-/************************************************************************/
-var __webpack_exports__ = {};
-
-// EXPORTS
-__webpack_require__.d(__webpack_exports__, {
-  TinyToastNotify: () => (/* reexport */ libs_TinyToastNotify)
-});
-
-;// ./src/v1/libs/TinyToastNotify.mjs
-/**
- * A callback function used to manually close a notification.
- * Passed as a second argument to `onClick` handlers, allowing programmatic dismissal of the toast.
- *
- * @typedef {() => void} CloseToastFunc
- */
-
-/**
- * Represents the data used to display a notification.
- * Can be a plain string (used as the message), or an object with more customization options.
- *
- * @typedef {string | {
- *   message: string, // The main message to display
- *   title?: string,  // Optional title to appear above the message
- *   onClick?: function(MouseEvent, CloseToastFunc): void, // Optional click handler for the notification
- *   html?: boolean,  // Whether the message should be interpreted as raw HTML
- *   avatar?: string  // Optional URL to an avatar image shown on the left
- * }} NotifyData
- */
-
-/**
- * A lightweight notification system designed to display timed messages inside a container.
- * Supports positioning, timing customization, click actions, HTML content, and optional avatars.
- *
- * ## Features:
- * - Positioning via `x` (`left`, `center`, `right`) and `y` (`top`, `bottom`).
- * - Dynamic display time based on message length.
- * - Optional `title`, `avatar`, `onClick`, and `html` message rendering.
- * - Fade-out animation with customizable duration.
- * - Rigid validation of inputs and internal state.
- *
- * ## Customization via setters:
- * - `setX(position)` — horizontal alignment.
- * - `setY(position)` — vertical alignment.
- * - `setBaseDuration(ms)` — base visible time in milliseconds.
- * - `setExtraPerChar(ms)` — extra time added per character.
- * - `setFadeOutDuration(ms)` — fade-out animation duration in milliseconds.
- *
- * @class
- */
-class TinyToastNotify {
-  #y;
-  #x;
-  #baseDuration;
-  #extraPerChar;
-  #fadeOutDuration;
-
-  /** @type {HTMLElement|null} */
-  #container;
-
-  /**
-   * @param {'top'|'bottom'} y - 'top' or 'bottom'
-   * @param {'right'|'left'|'center'} x - 'right', 'left', or 'center'
-   * @param {number} baseDuration - Base display time in ms
-   * @param {number} extraPerChar - Extra ms per character
-   * @param {number} fadeOutDuration - Time in ms for fade-out effect
-   * @param {string} [selector='.notify-container'] - Base selector for container
-   */
-  constructor(
-    y = 'top',
-    x = 'right',
-    baseDuration = 3000,
-    extraPerChar = 50,
-    fadeOutDuration = 300,
-    selector = '.notify-container',
-  ) {
-    this.#validateY(y);
-    this.#validateX(x);
-    this.#validateTiming(baseDuration, 'baseDuration');
-    this.#validateTiming(extraPerChar, 'extraPerChar');
-    this.#validateTiming(fadeOutDuration, 'fadeOutDuration');
-
-    this.#y = y;
-    this.#x = x;
-    this.#baseDuration = baseDuration;
-    this.#extraPerChar = extraPerChar;
-    this.#fadeOutDuration = fadeOutDuration;
-    const container = document.querySelector(`${selector}.${y}.${x}`);
-
-    if (!(container instanceof HTMLElement)) {
-      this.#container = document.createElement('div');
-      this.#container.className = `notify-container ${y} ${x}`;
-      document.body.appendChild(this.#container);
-    } else this.#container = container;
-  }
-
-  /**
-   * Returns the notification container element.
-   * Ensures that the container is a valid HTMLElement.
-   *
-   * @returns {HTMLElement} The notification container.
-   * @throws {Error} If the container is not a valid HTMLElement.
-   */
-  getContainer() {
-    if (!(this.#container instanceof HTMLElement))
-      throw new Error('Container is not a valid HTMLElement.');
-    return this.#container;
-  }
-
-  /**
-   * Validates the vertical position value.
-   * Must be either 'top' or 'bottom'.
-   *
-   * @param {string} value - The vertical position to validate.
-   * @throws {Error} If the value is not 'top' or 'bottom'.
-   */
-  #validateY(value) {
-    if (!['top', 'bottom'].includes(value)) {
-      throw new Error(`Invalid vertical direction "${value}". Expected "top" or "bottom".`);
-    }
-  }
-
-  /**
-   * Validates the horizontal position value.
-   * Must be 'left', 'right', or 'center'.
-   *
-   * @param {string} value - The horizontal position to validate.
-   * @throws {Error} If the value is not one of the accepted directions.
-   */
-  #validateX(value) {
-    if (!['left', 'right', 'center'].includes(value)) {
-      throw new Error(
-        `Invalid horizontal position "${value}". Expected "left", "right" or "center".`,
-      );
-    }
-  }
-
-  /**
-   * Validates a numeric timing value.
-   * Must be a non-negative finite number.
-   *
-   * @param {number} value - The number to validate.
-   * @param {string} name - The name of the parameter (used for error messaging).
-   * @throws {Error} If the number is invalid.
-   */
-  #validateTiming(value, name) {
-    if (typeof value !== 'number' || value < 0 || !Number.isFinite(value)) {
-      throw new Error(
-        `Invalid value for "${name}": ${value}. Must be a non-negative finite number.`,
-      );
-    }
-  }
-
-  /**
-   * Returns the current vertical position.
-   *
-   * @returns {'top'|'bottom'} The vertical direction of the notification container.
-   */
-  getY() {
-    return this.#y;
-  }
-
-  /**
-   * Sets the vertical position of the notification container.
-   * Updates the container's class to reflect the new position.
-   *
-   * @param {'top'|'bottom'} value - The vertical direction to set.
-   * @throws {Error} If the value is invalid.
-   */
-  setY(value) {
-    this.#validateY(value);
-    const container = this.getContainer();
-    container.classList.remove(this.#y);
-    container.classList.add(value);
-
-    this.#y = value;
-  }
-
-  /**
-   * Returns the current horizontal position.
-   *
-   * @returns {'left'|'right'|'center'} The horizontal direction of the notification container.
-   */
-  getX() {
-    return this.#x;
-  }
-
-  /**
-   * Sets the horizontal position of the notification container.
-   * Updates the container's class to reflect the new position.
-   *
-   * @param {'left'|'right'|'center'} value - The horizontal direction to set.
-   * @throws {Error} If the value is invalid.
-   */
-  setX(value) {
-    this.#validateX(value);
-    const container = this.getContainer();
-    container.classList.remove(this.#x);
-    container.classList.add(value);
-
-    this.#x = value;
-  }
-
-  /**
-   * Returns the base duration for displaying the notification.
-   *
-   * @returns {number} Base time (in milliseconds) that a notification stays on screen.
-   */
-  getBaseDuration() {
-    return this.#baseDuration;
-  }
-
-  /**
-   * Sets the base duration for the notification display time.
-   *
-   * @param {number} value - Base display time in milliseconds.
-   * @throws {Error} If the value is not a valid non-negative finite number.
-   */
-  setBaseDuration(value) {
-    this.#validateTiming(value, 'baseDuration');
-    this.#baseDuration = value;
-  }
-
-  /**
-   * Returns the extra display time added per character.
-   *
-   * @returns {number} Extra time (in milliseconds) per character in the notification.
-   */
-  getExtraPerChar() {
-    return this.#extraPerChar;
-  }
-
-  /**
-   * Sets the additional display time per character.
-   *
-   * @param {number} value - Extra time in milliseconds per character.
-   * @throws {Error} If the value is not a valid non-negative finite number.
-   */
-  setExtraPerChar(value) {
-    this.#validateTiming(value, 'extraPerChar');
-    this.#extraPerChar = value;
-  }
-
-  /**
-   * Returns the fade-out duration.
-   *
-   * @returns {number} Time (in milliseconds) used for fade-out transition.
-   */
-  getFadeOutDuration() {
-    return this.#fadeOutDuration;
-  }
-
-  /**
-   * Sets the fade-out transition time for notifications.
-   *
-   * @param {number} value - Fade-out duration in milliseconds.
-   * @throws {Error} If the value is not a valid non-negative finite number.
-   */
-  setFadeOutDuration(value) {
-    this.#validateTiming(value, 'fadeOutDuration');
-    this.#fadeOutDuration = value;
-  }
-
-  /**
-   * Displays a notification for a time based on message length.
-   * Accepts a string or an object with:
-   * {
-   *   message: string,
-   *   title?: string,
-   *   onClick?: function(MouseEvent, CloseToastFunc): void,
-   *   html?: boolean,
-   *   avatar?: string // Optional avatar image URL
-   * }
-   *
-   * @param {NotifyData} data
-   */
-  show(data) {
-    let message = '';
-    let title = '';
-    let onClick = null;
-    let useHTML = false;
-    let avatarUrl = null;
-
-    const notify = document.createElement('div');
-    notify.className = 'notify enter';
-
-    if (typeof data === 'string') {
-      message = data;
-    } else if (typeof data === 'object' && data !== null && typeof data.message === 'string') {
-      message = data.message;
-      title = typeof data.title === 'string' ? data.title : '';
-      useHTML = data.html === true;
-      avatarUrl = typeof data.avatar === 'string' ? data.avatar : null;
-
-      if (data.onClick !== undefined) {
-        if (typeof data.onClick !== 'function') {
-          throw new Error('onClick must be a function if defined');
-        }
-        onClick = data.onClick;
-        notify.classList.add('clickable');
-      }
-    } else {
-      throw new Error(
-        `Invalid argument for show(): expected string or { message: string, title?: string, onClick?: function, html?: boolean, avatar?: string }`,
-      );
-    }
-
-    // Add close button
-    const closeBtn = document.createElement('button');
-    closeBtn.innerHTML = '&times;';
-    closeBtn.className = 'close';
-    closeBtn.setAttribute('aria-label', 'Close');
-
-    // Optional hover effect
-    closeBtn.addEventListener('mouseenter', () => {
-      closeBtn.style.color = 'var(--notif-close-color-hover)';
-    });
-    closeBtn.addEventListener('mouseleave', () => {
-      closeBtn.style.color = 'var(--notif-close-color)';
-    });
-
-    // Avatar
-    if (avatarUrl) {
-      const avatar = document.createElement('img');
-      avatar.src = avatarUrl;
-      avatar.alt = 'avatar';
-      avatar.className = 'avatar';
-      notify.appendChild(avatar);
-    }
-
-    // Title
-    if (title) {
-      const titleElem = document.createElement('strong');
-      titleElem.textContent = title;
-      titleElem.style.display = 'block';
-      notify.appendChild(titleElem);
-    }
-
-    // Message
-    if (useHTML) {
-      const msgWrapper = document.createElement('div');
-      msgWrapper.innerHTML = message;
-      notify.appendChild(msgWrapper);
-    } else {
-      notify.appendChild(document.createTextNode(message));
-    }
-
-    notify.appendChild(closeBtn);
-    this.getContainer().appendChild(notify);
-
-    const visibleTime = this.#baseDuration + message.length * this.#extraPerChar;
-    const totalTime = visibleTime + this.#fadeOutDuration;
-
-    // Close logic
-    let removed = false;
-    const close = () => {
-      if (removed) return;
-      removed = true;
-      notify.classList.remove('enter', 'show');
-      notify.classList.add('exit');
-      setTimeout(() => notify.remove(), this.#fadeOutDuration);
-    };
-
-    // Click handler
-    if (typeof onClick === 'function') {
-      notify.addEventListener('click', (e) => {
-        if (e.target === closeBtn) return;
-        onClick(e, close);
-      });
-    }
-
-    // Close button click
-    closeBtn.addEventListener('click', (e) => {
-      e.stopPropagation();
-      close();
-    });
-
-    // Transition activation force soon after the element is added
-    setTimeout(() => {
-      notify.classList.remove('enter');
-      notify.classList.add('show');
-    }, 1);
-
-    setTimeout(() => close(), totalTime);
-  }
-
-  /**
-   * Destroys the notification container and removes all active notifications.
-   * This should be called when the notification system is no longer needed,
-   * such as when unloading a page or switching views in a single-page app.
-   *
-   * @returns {void}
-   */
-  destroy() {
-    if (!(this.#container instanceof HTMLElement)) return;
-
-    // Remove all child notifications
-    this.#container.querySelectorAll('.notify').forEach((el) => el.remove());
-
-    // Remove the container itself from the DOM
-    if (this.#container.parentNode) {
-      this.#container.parentNode.removeChild(this.#container);
-    }
-
-    // Optional: Clean internal references (safe practice)
-    this.#container = null;
-  }
-}
-
-/* harmony default export */ const libs_TinyToastNotify = (TinyToastNotify);
-
-;// ./src/v1/build/TinyToastNotify.mjs
-
-
-
-
-window.TinyToastNotify = __webpack_exports__.TinyToastNotify;
-/******/ })()
-;