npm - tiny-essentials - Versions diffs - 1.20.0 → 1.20.1 - Mend

tiny-essentials 1.20.0 → 1.20.1

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 (40) hide show

package/dist/v1/TinyBasicsEs.min.js +1 -1
package/dist/v1/TinyDragger.min.js +1 -1
package/dist/v1/TinyEssentials.min.js +1 -1
package/dist/v1/TinyHtml.min.js +1 -1
package/dist/v1/TinySmartScroller.min.js +1 -1
package/dist/v1/TinyUploadClicker.min.js +1 -1
package/dist/v1/libs/TinyDragger.cjs +1 -1
package/dist/v1/libs/TinyDragger.mjs +1 -1
package/dist/v1/libs/TinyHtml.cjs +292 -103
package/dist/v1/libs/TinyHtml.d.mts +142 -39
package/dist/v1/libs/TinyHtml.mjs +266 -94
package/dist/v1/libs/TinyIframeEvents.cjs +2 -1
package/dist/v1/libs/TinyNewWinEvents.cjs +4 -2
package/docs/v1/libs/TinyHtml.md +128 -6
package/package.json +1 -1
package/dist/v1/ColorSafeStringify.js +0 -235
package/dist/v1/TinyAfterScrollWatcher.js +0 -219
package/dist/v1/TinyBasicsEs.js +0 -9334
package/dist/v1/TinyClipboard.js +0 -459
package/dist/v1/TinyColorConverter.js +0 -617
package/dist/v1/TinyDomReadyManager.js +0 -213
package/dist/v1/TinyDragDropDetector.js +0 -307
package/dist/v1/TinyDragger.js +0 -6569
package/dist/v1/TinyEssentials.js +0 -20792
package/dist/v1/TinyEvents.js +0 -402
package/dist/v1/TinyHtml.js +0 -5545
package/dist/v1/TinyIframeEvents.js +0 -854
package/dist/v1/TinyLevelUp.js +0 -291
package/dist/v1/TinyLocalStorage.js +0 -1440
package/dist/v1/TinyNewWinEvents.js +0 -888
package/dist/v1/TinyNotifications.js +0 -408
package/dist/v1/TinyNotifyCenter.js +0 -493
package/dist/v1/TinyPromiseQueue.js +0 -299
package/dist/v1/TinyRateLimiter.js +0 -611
package/dist/v1/TinySmartScroller.js +0 -7039
package/dist/v1/TinyTextRangeEditor.js +0 -497
package/dist/v1/TinyTimeout.js +0 -233
package/dist/v1/TinyToastNotify.js +0 -441
package/dist/v1/TinyUploadClicker.js +0 -14353
package/dist/v1/UltraRandomMsgGen.js +0 -995

package/dist/v1/TinyNotifications.js DELETED Viewed

@@ -1,408 +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__, {
-  TinyNotifications: () => (/* reexport */ libs_TinyNotifications)
-});
-;// ./src/v1/basics/text.mjs
-/**
- * Converts a string to title case where the first letter of each word is capitalized.
- * All other letters are converted to lowercase.
- *
- * Example: "hello world" -> "Hello World"
- *
- * @param {string} str - The string to be converted to title case.
- * @returns {string} The string converted to title case.
- */
-function toTitleCase(str) {
-  return str.replace(/\w\S*/g, (txt) => txt.charAt(0).toUpperCase() + txt.substr(1).toLowerCase());
-}
-/**
- * Converts a string to title case where the first letter of each word is capitalized,
- * but the first letter of the entire string is left lowercase.
- *
- * Example: "hello world" -> "hello World"
- *
- * @param {string} str - The string to be converted to title case with the first letter in lowercase.
- * @returns {string} The string converted to title case with the first letter in lowercase.
- */
-function toTitleCaseLowerFirst(str) {
-  const titleCased = str.replace(
-    /\w\S*/g,
-    (txt) => txt.charAt(0).toUpperCase() + txt.substr(1).toLowerCase(),
-  );
-  return titleCased.charAt(0).toLowerCase() + titleCased.slice(1);
-}
-/**
- * Enables a keyboard shortcut to toggle a CSS class on the document body.
- *
- * This function listens for a specific key combination: `Ctrl + Alt + [key]`.
- * When triggered, it prevents the default behavior and toggles the
- * `detect-made-by-ai` class on the `<body>`, which can be used to apply visual
- * indicators or filters on AI-generated content.
- *
- * If executed outside of a browser environment (e.g., in Node.js), the function logs an error and exits.
- * If the `<body>` is not available at the moment the shortcut is triggered, a warning is logged.
- *
- * @param {string} [key='a'] - The lowercase character key to be used in combination with Ctrl and Alt.
- */
-function addAiMarkerShortcut(key = 'a') {
-  if (typeof HTMLElement === 'undefined') {
-    console.error(
-      '[AiMarkerShortcut] Environment does not support the DOM. This function must be run in a browser.',
-    );
-    return;
-  }
-  document.addEventListener('keydown', function (event) {
-    if (event.ctrlKey && event.altKey && event.key.toLowerCase() === key) {
-      event.preventDefault(); // Prevent any default behavior
-      if (!document.body) {
-        console.warn(
-          '[AiMarkerShortcut] <body> element not found. Cannot toggle class. Ensure the DOM is fully loaded when using the shortcut.',
-        );
-        return;
-      }
-      document.body.classList.toggle('detect-made-by-ai');
-    }
-  });
-}
-/**
- * Trims a text string to a specified character limit, attempting to avoid cutting words in half.
- * If a space is found before the limit and it's not too far from the limit (at least 60%),
- * the cut is made at that space; otherwise, the text is hard-cut at the limit.
- * If the input is shorter than the limit, it is returned unchanged.
- *
- * @param {string} text - The input text to be trimmed.
- * @param {number} limit - The maximum number of characters allowed.
- * @param {number} [safeCutZone=0.6] - A decimal between 0 and 1 representing the minimal acceptable position
- *                                     (as a fraction of `limit`) to cut at a space. Defaults to 0.6.
- * @returns {string} - The trimmed text, possibly ending with an ellipsis ("...").
- * @throws {TypeError} - Throws if `text` is not a string.
- * @throws {TypeError} - Throws if `limit` is not a positive integer.
- * @throws {TypeError} - Throws if `safeCutZone` is not a number between 0 and 1 (inclusive).
- */
-function safeTextTrim(text, limit, safeCutZone = 0.6) {
-  if (typeof text !== 'string')
-    throw new TypeError(`Expected a string for 'text', but received ${typeof text}`);
-  if (!Number.isInteger(limit) || limit <= 0)
-    throw new TypeError(`Expected 'limit' to be a positive integer, but received ${limit}`);
-  if (typeof safeCutZone !== 'number' || safeCutZone < 0 || safeCutZone > 1)
-    throw new TypeError(
-      `Expected 'safeCutZone' to be a number between 0 and 1, but received ${safeCutZone}`,
-    );
-  let result = text.trim();
-  if (result.length > limit) {
-    // Try to cut the string into a space before the limit
-    const safeCut = result.lastIndexOf(' ', limit);
-    if (safeCut > 0 && safeCut >= limit * safeCutZone) {
-      // Only cuts where there is a space, and if the cut is not too early
-      return `${result.substring(0, safeCut).trim()}...`;
-    } else {
-      // Emergency: Cuts straight to the limit and adds "...".
-      return `${result.substring(0, limit).trim()}...`;
-    }
-  }
-  return result;
-}
-/*
-import { useEffect } from "react";
-function KeyPressHandler() {
-    useEffect(() => {
-        const handleKeyDown = (event) => {
-            if (event.ctrlKey && event.altKey && event.key.toLowerCase() === "a") {
-                event.preventDefault();
-                document.body.classList.toggle("detect-made-by-ai");
-            }
-        };
-        document.addEventListener("keydown", handleKeyDown);
-        return () => {
-            document.removeEventListener("keydown", handleKeyDown);
-        };
-    }, []);
-    return null;
-}
-export default KeyPressHandler;
-*/
-;// ./src/v1/libs/TinyNotifications.mjs
-/**
- * A utility class to manage browser notifications with sound and custom behavior.
- * Useful for triggering system notifications with optional sound, avatar icon, body truncation, and click actions.
- *
- * @class
- */
-class TinyNotifications {
-  /** @type {boolean} Whether notifications are currently allowed by the user. */
-  #allowed = false;
-  /** @type {boolean} Indicates whether the user has already requested permission at least once. */
-  #permissionRequested = false;
-  /** @type {HTMLAudioElement|null} Audio element to play when a notification is triggered. */
-  #audio = null;
-  /** @type {number} Maximum number of characters in the notification body. */
-  #bodyLimit = 100;
-  /** @type {string|null} Default avatar icon URL for notifications. */
-  #defaultIcon = null;
-  /** @type {(this: Notification, evt: Event) => any} Default handler when a notification is clicked. */
-  #defaultOnClick;
-  /**
-   * Constructs a new instance of TinyNotifications.
-   *
-   * @param {Object} [settings={}] - Optional settings to initialize the notification manager.
-   * @param {string|HTMLAudioElement|null} [settings.audio] - Path or URL to the audio file for notification sounds.
-   * @param {string|null} [settings.defaultIcon] - Default icon URL to be used in notifications.
-   * @param {number} [settings.bodyLimit=100] - Maximum number of characters allowed in the notification body.
-   * @param {(this: Notification, evt: Event) => any} [settings.defaultOnClick] - Default function to execute when a notification is clicked.
-   * @throws {TypeError} If any of the parameters are of an invalid type.
-   */
-  constructor({
-    audio = null,
-    defaultIcon = null,
-    bodyLimit = 100,
-    defaultOnClick = function (event) {
-      event.preventDefault();
-      if (window.focus) window.focus();
-      this.close();
-    },
-  } = {}) {
-    if (!(audio instanceof HTMLAudioElement) && typeof audio !== 'string' && audio !== null)
-      throw new TypeError('audio must be an instance of HTMLAudioElement or null.');
-    if (defaultIcon !== null && typeof defaultIcon !== 'string')
-      throw new TypeError('defaultIcon must be a string or null.');
-    if (!Number.isFinite(bodyLimit) || bodyLimit < 0)
-      throw new TypeError('bodyLimit must be a non-negative number.');
-    if (typeof defaultOnClick !== 'function')
-      throw new TypeError('defaultOnClick must be a function.');
-    this.#audio = typeof audio !== 'string' ? audio : new Audio(audio);
-    this.#defaultIcon = defaultIcon;
-    this.#bodyLimit = bodyLimit;
-    this.#defaultOnClick = defaultOnClick;
-  }
-  /**
-   * Requests permission from the user to show notifications.
-   * Updates the internal `#allowed` flag.
-   *
-   * @returns {Promise<boolean>} Resolves to `true` if permission is granted, otherwise `false`.
-   */
-  requestPerm() {
-    const tinyThis = this;
-    return new Promise((resolve, reject) => {
-      if (tinyThis.isCompatible()) {
-        if (Notification.permission === 'default') {
-          Notification.requestPermission()
-            .then((permission) => {
-              this.#permissionRequested = true;
-              tinyThis.#allowed = permission === 'granted';
-              resolve(tinyThis.#allowed);
-            })
-            .catch(reject);
-        } else {
-          this.#permissionRequested = true;
-          tinyThis.#allowed = Notification.permission === 'granted';
-          resolve(tinyThis.#allowed);
-        }
-      } else {
-        this.#permissionRequested = true;
-        tinyThis.#allowed = false;
-        resolve(false);
-      }
-    });
-  }
-  /**
-   * Checks if the Notification API is supported by the current browser.
-   *
-   * @returns {boolean} Returns `true` if notifications are supported, otherwise `false`.
-   */
-  isCompatible() {
-    return 'Notification' in window;
-  }
-  /**
-   * Sends a browser notification with the provided title and configuration.
-   * Truncates the body if necessary and plays a sound if configured.
-   *
-   * @param {string} title - The title of the notification.
-   * @param {NotificationOptions & { vibrate?: number[] }} [config={}] - Optional configuration for the notification.
-   * @returns {Notification|null} The created `Notification` instance, or `null` if permission is not granted.
-   * @throws {TypeError} If the title is not a string or config is not a valid object.
-   */
-  send(title, config = {}) {
-    if (!this.#permissionRequested)
-      throw new Error('You must call requestPerm() before sending a notification.');
-    if (typeof title !== 'string') throw new TypeError('title must be a string.');
-    if (typeof config !== 'object' || config === null)
-      throw new TypeError('config must be a non-null object.');
-    if (!this.#allowed) return null;
-    const { icon = this.#defaultIcon || undefined, vibrate = [200, 100, 200] } = config;
-    const options = { ...config };
-    if (typeof icon === 'string') options.icon = icon;
-    if (Array.isArray(vibrate)) options.vibrate = vibrate;
-    if (typeof options.body === 'string')
-      options.body = safeTextTrim(options.body, this.#bodyLimit);
-    const notification = new Notification(title, options);
-    notification.addEventListener('show', () => {
-      if (!(this.#audio instanceof HTMLAudioElement)) return;
-      this.#audio.currentTime = 0;
-      this.#audio.play().catch((err) => console.error(err));
-    });
-    if (typeof this.#defaultOnClick === 'function')
-      notification.addEventListener('click', this.#defaultOnClick);
-    return notification;
-  }
-  // === Getters and Setters ===
-  /**
-   * Whether the requestPerm() method was already called.
-   * @returns {boolean}
-   */
-  wasPermissionRequested() {
-    return this.#permissionRequested;
-  }
-  /**
-   * Returns the current permission status.
-   * @returns {boolean} `true` if permission was granted, otherwise `false`.
-   */
-  isAllowed() {
-    return this.#allowed;
-  }
-  /**
-   * Gets the current notification audio.
-   * @returns {HTMLAudioElement|null} The sound element, or `null` if not set.
-   */
-  getAudio() {
-    return this.#audio;
-  }
-  /**
-   * Sets the audio element used for notification sounds.
-   * @param {HTMLAudioElement|string|null} value - A valid `HTMLAudioElement` or `null` to disable sound.
-   * @throws {TypeError} If the value is not an `HTMLAudioElement` or `null`.
-   */
-  setAudio(value) {
-    if (!(value instanceof HTMLAudioElement) && typeof value !== 'string' && value !== null)
-      throw new TypeError('sound must be an instance of HTMLAudioElement or null.');
-    this.#audio = typeof value !== 'string' ? value : new Audio(value);
-  }
-  /**
-   * Gets the maximum length of the notification body text.
-   * @returns {number} Number of characters allowed.
-   */
-  getBodyLimit() {
-    return this.#bodyLimit;
-  }
-  /**
-   * Sets the maximum number of characters allowed in the notification body.
-   * @param {number} value - A non-negative integer.
-   * @throws {TypeError} If the value is not a valid non-negative number.
-   */
-  setBodyLimit(value) {
-    if (!Number.isFinite(value) || value < 0)
-      throw new TypeError('bodyLimit must be a non-negative number.');
-    this.#bodyLimit = value;
-  }
-  /**
-   * Gets the default avatar icon URL.
-   * @returns {string|null} The URL string or `null`.
-   */
-  getDefaultAvatar() {
-    return this.#defaultIcon;
-  }
-  /**
-   * Sets the default avatar icon URL.
-   * @param {string|null} value - A string URL or `null` to disable default icon.
-   * @throws {TypeError} If the value is not a string or `null`.
-   */
-  setDefaultAvatar(value) {
-    if (!(typeof value === 'string' || value === null))
-      throw new TypeError('defaultIcon must be a string or null.');
-    this.#defaultIcon = value;
-  }
-  /**
-   * Gets the default click event handler for notifications.
-   * @returns {(this: Notification, evt: Event) => any} The current click handler function.
-   */
-  getDefaultOnClick() {
-    return this.#defaultOnClick;
-  }
-  /**
-   * Sets the default click event handler for notifications.
-   * @param {(this: Notification, evt: Event) => any} value - A function to handle the notification click event.
-   * @throws {TypeError} If the value is not a function.
-   */
-  setDefaultOnClick(value) {
-    if (typeof value !== 'function') throw new TypeError('defaultOnClick must be a function.');
-    this.#defaultOnClick = value;
-  }
-}
-/* harmony default export */ const libs_TinyNotifications = (TinyNotifications);
-;// ./src/v1/build/TinyNotifications.mjs
-window.TinyNotifications = __webpack_exports__.TinyNotifications;
-/******/ })()
-;