tiny-essentials 1.12.2 → 1.13.1

package/dist/v1/build/TinyDomReadyManager.d.mts

@@ -0,0 +1,3 @@
+export { TinyDomReadyManager };
+import TinyDomReadyManager from '../libs/TinyDomReadyManager.mjs';
+//# sourceMappingURL=TinyDomReadyManager.d.mts.map

package/dist/v1/build/TinyDomReadyManager.mjs

@@ -0,0 +1,2 @@
+import TinyDomReadyManager from '../libs/TinyDomReadyManager.mjs';
+export { TinyDomReadyManager };

package/dist/v1/index.cjs

@@ -19,6 +19,7 @@ var TinyDragDropDetector = require('./libs/TinyDragDropDetector.cjs');
 var normalFuncs = require('./fileManager/normalFuncs.cjs');
 var asyncFuncs = require('./fileManager/asyncFuncs.cjs');
 var TinyDragger = require('./libs/TinyDragger.cjs');
+var TinyDomReadyManager = require('./libs/TinyDomReadyManager.cjs');
 
 
 
@@ -45,6 +46,7 @@ exports.offFullScreenChange = fullScreen.offFullScreenChange;
 exports.onFullScreenChange = fullScreen.onFullScreenChange;
 exports.requestFullScreen = fullScreen.requestFullScreen;
 exports.formatBytes = simpleMath.formatBytes;
+exports.genFibonacciSeq = simpleMath.genFibonacciSeq;
 exports.getAge = simpleMath.getAge;
 exports.getSimplePerc = simpleMath.getSimplePerc;
 exports.ruleOfThree = simpleMath.ruleOfThree;
@@ -94,3 +96,4 @@ exports.isDirEmptyAsync = asyncFuncs.isDirEmptyAsync;
 exports.listDirsAsync = asyncFuncs.listDirsAsync;
 exports.listFilesAsync = asyncFuncs.listFilesAsync;
 exports.TinyDragger = TinyDragger;
+exports.TinyDomReadyManager = TinyDomReadyManager;

package/dist/v1/index.d.mts

@@ -1,3 +1,4 @@
+import TinyDomReadyManager from './libs/TinyDomReadyManager.mjs';
 import TinyDragger from './libs/TinyDragger.mjs';
 import TinyDragDropDetector from './libs/TinyDragDropDetector.mjs';
 import TinyToastNotify from './libs/TinyToastNotify.mjs';
@@ -6,6 +7,7 @@ import TinyRateLimiter from './libs/TinyRateLimiter.mjs';
 import ColorSafeStringify from './libs/ColorSafeStringify.mjs';
 import TinyPromiseQueue from './libs/TinyPromiseQueue.mjs';
 import TinyLevelUp from '../legacy/libs/userLevel.mjs';
+import { genFibonacciSeq } from './basics/simpleMath.mjs';
 import { isDirEmptyAsync } from './fileManager/asyncFuncs.mjs';
 import { fileSizeAsync } from './fileManager/asyncFuncs.mjs';
 import { dirSizeAsync } from './fileManager/asyncFuncs.mjs';
@@ -70,5 +72,5 @@ import { getTimeDuration } from './basics/clock.mjs';
 import { shuffleArray } from './basics/array.mjs';
 import { toTitleCase } from './basics/text.mjs';
 import { toTitleCaseLowerFirst } from './basics/text.mjs';
-export { TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
+export { TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
 //# sourceMappingURL=index.d.mts.map

package/dist/v1/index.mjs

@@ -5,7 +5,7 @@ import { shuffleArray } from './basics/array.mjs';
 import { formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, } from './basics/clock.mjs';
 import { countObj, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, checkObj, isJsonObject, } from './basics/objFilter.mjs';
 import { documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, } from './basics/fullScreen.mjs';
-import { formatBytes, getAge, getSimplePerc, ruleOfThree } from './basics/simpleMath.mjs';
+import { formatBytes, genFibonacciSeq, getAge, getSimplePerc, ruleOfThree, } from './basics/simpleMath.mjs';
 import { addAiMarkerShortcut, toTitleCase, toTitleCaseLowerFirst } from './basics/text.mjs';
 import ColorSafeStringify from './libs/ColorSafeStringify.mjs';
 import TinyPromiseQueue from './libs/TinyPromiseQueue.mjs';
@@ -17,4 +17,5 @@ import TinyDragDropDetector from './libs/TinyDragDropDetector.mjs';
 import { readJsonFile, writeJsonFile, ensureDirectory, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, getLatestBackupPath, } from './fileManager/normalFuncs.mjs';
 import { listFilesAsync, listDirsAsync, clearDirectoryAsync, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, } from './fileManager/asyncFuncs.mjs';
 import TinyDragger from './libs/TinyDragger.mjs';
-export { TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+import TinyDomReadyManager from './libs/TinyDomReadyManager.mjs';
+export { TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/dist/v1/libs/TinyDomReadyManager.cjs

@@ -0,0 +1,174 @@
+'use strict';
+
+/**
+ * A basic function that performs a task when the system is ready.
+ * Used for handlers in the readiness queue.
+ *
+ * @typedef {() => void} Fn
+ */
+
+/**
+ * A function that determines whether a specific handler should be executed.
+ * Should return `true` to allow execution, or `false` to skip the handler.
+ *
+ * @typedef {() => boolean} FnFilter
+ */
+
+/**
+ * @typedef {Object} Handler
+ * @property {Fn} fn - Function to execute when ready.
+ * @property {boolean} once - Whether to execute only once.
+ * @property {number} priority - Execution order (higher priority runs first).
+ * @property {FnFilter|null} filter - Optional filter function to determine execution.
+ * @property {boolean} domOnly - Whether to run as soon as DOM is ready (before full readiness).
+ */
+
+class TinyDomReadyManager {
+  /** @type {Handler[]} */
+  #handlers = [];
+
+  /** @type {boolean} */
+  #isDomReady = false;
+
+  /** @type {boolean} */
+  #isFullyReady = false;
+
+  /** @type {Promise<any>[]} */
+  #promises = [];
+
+  /**
+   * Checks if the DOM is ready and if all Promises have been resolved.
+   */
+  #checkAllReady() {
+    if (this.#isDomReady) {
+      Promise.all(this.#promises)
+        .then(() => {
+          this.#isFullyReady = true;
+          this.#runHandlers(false); // run non-domOnly
+        })
+        .catch((err) => {
+          console.error('[TinyDomReadyManager] Promise rejected:', err);
+        });
+    }
+  }
+
+  /**
+   * Executes handlers by filtering them by `domOnly` flag and sorting by priority.
+   * @param {boolean} domOnlyOnly - Whether to run only `domOnly` handlers.
+   */
+  #runHandlers(domOnlyOnly) {
+    this.#handlers
+      .filter((h) => h.domOnly === domOnlyOnly)
+      .sort((a, b) => b.priority - a.priority)
+      .forEach((handler) => this.#invokeHandler(handler));
+
+    this.#handlers = this.#handlers.filter((h) => !(h.once && (domOnlyOnly ? h.domOnly : true)));
+  }
+
+  /**
+   * Executes a handler if its filter passes.
+   * @param {Handler} handler
+   */
+  #invokeHandler(handler) {
+    if (typeof handler.filter === 'function') {
+      try {
+        if (!handler.filter()) return;
+      } catch (err) {
+        console.warn('[TinyDomReadyManager] Filter error:', err);
+        return;
+      }
+    }
+
+    try {
+      handler.fn();
+    } catch (err) {
+      console.error('[TinyDomReadyManager] Handler error:', err);
+    }
+  }
+
+  /**
+   * Marks the system as DOM-ready and runs DOM-only handlers.
+   * @private
+   */
+  _markDomReady() {
+    this.#isDomReady = true;
+    this.#runHandlers(true); // Run domOnly
+    this.#checkAllReady(); // Then check for full readiness
+  }
+
+  /**
+   * Initializes the manager using `DOMContentLoaded`.
+   */
+  init() {
+    if (this.#isDomReady) throw new Error('[TinyDomReadyManager] init() has already been called.');
+
+    if (document.readyState === 'interactive' || document.readyState === 'complete') {
+      this._markDomReady();
+    } else {
+      document.addEventListener('DOMContentLoaded', () => this._markDomReady());
+    }
+  }
+
+  /**
+   * Adds a Promise to delay full readiness.
+   * @param {Promise<any>} promise
+   * @throws {TypeError}
+   */
+  addPromise(promise) {
+    if (!(promise instanceof Promise))
+      throw new TypeError('[TinyDomReadyManager] promise must be a valid Promise.');
+
+    if (this.#isFullyReady) return;
+    this.#promises.push(promise);
+    if (this.#isDomReady) this.#checkAllReady();
+  }
+
+  /**
+   * Registers a handler to run either after DOM is ready or after full readiness.
+   *
+   * @param {Fn} fn - Function to execute.
+   * @param {Object} [options]
+   * @param {boolean} [options.once=true] - Execute only once.
+   * @param {number} [options.priority=0] - Higher priority runs first.
+   * @param {FnFilter|null} [options.filter=null] - Optional filter function.
+   * @param {boolean} [options.domOnly=false] - If true, executes after DOM ready only.
+   * @throws {TypeError} If fn is not a function.
+   */
+  onReady(fn, { once = true, priority = 0, filter = null, domOnly = false } = {}) {
+    if (typeof fn !== 'function')
+      throw new TypeError('[TinyDomReadyManager] fn must be a function.');
+
+    const handler = { fn, once, priority, filter, domOnly };
+
+    if (domOnly && this.#isDomReady) {
+      this.#invokeHandler(handler);
+      if (!once) this.#handlers.push(handler);
+      return;
+    }
+
+    if (!domOnly && this.#isFullyReady) {
+      this.#invokeHandler(handler);
+    } else {
+      this.#handlers.push(handler);
+    }
+  }
+
+  /**
+   * Returns whether the system is fully ready (DOM + Promises).
+   * @returns {boolean}
+   */
+  isReady() {
+    return this.#isFullyReady;
+  }
+
+  /**
+   * Returns whether the DOM is ready (DOMContentLoaded has fired).
+   * Does not wait for promises.
+   * @returns {boolean}
+   */
+  isDomReady() {
+    return this.#isDomReady;
+  }
+}
+
+module.exports = TinyDomReadyManager;

package/dist/v1/libs/TinyDomReadyManager.d.mts

@@ -0,0 +1,100 @@
+export default TinyDomReadyManager;
+/**
+ * A basic function that performs a task when the system is ready.
+ * Used for handlers in the readiness queue.
+ */
+export type Fn = () => void;
+/**
+ * A function that determines whether a specific handler should be executed.
+ * Should return `true` to allow execution, or `false` to skip the handler.
+ */
+export type FnFilter = () => boolean;
+export type Handler = {
+    /**
+     * - Function to execute when ready.
+     */
+    fn: Fn;
+    /**
+     * - Whether to execute only once.
+     */
+    once: boolean;
+    /**
+     * - Execution order (higher priority runs first).
+     */
+    priority: number;
+    /**
+     * - Optional filter function to determine execution.
+     */
+    filter: FnFilter | null;
+    /**
+     * - Whether to run as soon as DOM is ready (before full readiness).
+     */
+    domOnly: boolean;
+};
+/**
+ * A basic function that performs a task when the system is ready.
+ * Used for handlers in the readiness queue.
+ *
+ * @typedef {() => void} Fn
+ */
+/**
+ * A function that determines whether a specific handler should be executed.
+ * Should return `true` to allow execution, or `false` to skip the handler.
+ *
+ * @typedef {() => boolean} FnFilter
+ */
+/**
+ * @typedef {Object} Handler
+ * @property {Fn} fn - Function to execute when ready.
+ * @property {boolean} once - Whether to execute only once.
+ * @property {number} priority - Execution order (higher priority runs first).
+ * @property {FnFilter|null} filter - Optional filter function to determine execution.
+ * @property {boolean} domOnly - Whether to run as soon as DOM is ready (before full readiness).
+ */
+declare class TinyDomReadyManager {
+    /**
+     * Marks the system as DOM-ready and runs DOM-only handlers.
+     * @private
+     */
+    private _markDomReady;
+    /**
+     * Initializes the manager using `DOMContentLoaded`.
+     */
+    init(): void;
+    /**
+     * Adds a Promise to delay full readiness.
+     * @param {Promise<any>} promise
+     * @throws {TypeError}
+     */
+    addPromise(promise: Promise<any>): void;
+    /**
+     * Registers a handler to run either after DOM is ready or after full readiness.
+     *
+     * @param {Fn} fn - Function to execute.
+     * @param {Object} [options]
+     * @param {boolean} [options.once=true] - Execute only once.
+     * @param {number} [options.priority=0] - Higher priority runs first.
+     * @param {FnFilter|null} [options.filter=null] - Optional filter function.
+     * @param {boolean} [options.domOnly=false] - If true, executes after DOM ready only.
+     * @throws {TypeError} If fn is not a function.
+     */
+    onReady(fn: Fn, { once, priority, filter, domOnly }?: {
+        once?: boolean | undefined;
+        priority?: number | undefined;
+        filter?: FnFilter | null | undefined;
+        domOnly?: boolean | undefined;
+    }): void;
+    /**
+     * Returns whether the system is fully ready (DOM + Promises).
+     * @returns {boolean}
+     */
+    isReady(): boolean;
+    /**
+     * Returns whether the DOM is ready (DOMContentLoaded has fired).
+     * Does not wait for promises.
+     * @returns {boolean}
+     */
+    isDomReady(): boolean;
+    #private;
+}
+//# sourceMappingURL=TinyDomReadyManager.d.mts.map

package/dist/v1/libs/TinyDomReadyManager.mjs

@@ -0,0 +1,158 @@
+/**
+ * A basic function that performs a task when the system is ready.
+ * Used for handlers in the readiness queue.
+ *
+ * @typedef {() => void} Fn
+ */
+/**
+ * A function that determines whether a specific handler should be executed.
+ * Should return `true` to allow execution, or `false` to skip the handler.
+ *
+ * @typedef {() => boolean} FnFilter
+ */
+/**
+ * @typedef {Object} Handler
+ * @property {Fn} fn - Function to execute when ready.
+ * @property {boolean} once - Whether to execute only once.
+ * @property {number} priority - Execution order (higher priority runs first).
+ * @property {FnFilter|null} filter - Optional filter function to determine execution.
+ * @property {boolean} domOnly - Whether to run as soon as DOM is ready (before full readiness).
+ */
+class TinyDomReadyManager {
+    /** @type {Handler[]} */
+    #handlers = [];
+    /** @type {boolean} */
+    #isDomReady = false;
+    /** @type {boolean} */
+    #isFullyReady = false;
+    /** @type {Promise<any>[]} */
+    #promises = [];
+    /**
+     * Checks if the DOM is ready and if all Promises have been resolved.
+     */
+    #checkAllReady() {
+        if (this.#isDomReady) {
+            Promise.all(this.#promises)
+                .then(() => {
+                this.#isFullyReady = true;
+                this.#runHandlers(false); // run non-domOnly
+            })
+                .catch((err) => {
+                console.error('[TinyDomReadyManager] Promise rejected:', err);
+            });
+        }
+    }
+    /**
+     * Executes handlers by filtering them by `domOnly` flag and sorting by priority.
+     * @param {boolean} domOnlyOnly - Whether to run only `domOnly` handlers.
+     */
+    #runHandlers(domOnlyOnly) {
+        this.#handlers
+            .filter((h) => h.domOnly === domOnlyOnly)
+            .sort((a, b) => b.priority - a.priority)
+            .forEach((handler) => this.#invokeHandler(handler));
+        this.#handlers = this.#handlers.filter((h) => !(h.once && (domOnlyOnly ? h.domOnly : true)));
+    }
+    /**
+     * Executes a handler if its filter passes.
+     * @param {Handler} handler
+     */
+    #invokeHandler(handler) {
+        if (typeof handler.filter === 'function') {
+            try {
+                if (!handler.filter())
+                    return;
+            }
+            catch (err) {
+                console.warn('[TinyDomReadyManager] Filter error:', err);
+                return;
+            }
+        }
+        try {
+            handler.fn();
+        }
+        catch (err) {
+            console.error('[TinyDomReadyManager] Handler error:', err);
+        }
+    }
+    /**
+     * Marks the system as DOM-ready and runs DOM-only handlers.
+     * @private
+     */
+    _markDomReady() {
+        this.#isDomReady = true;
+        this.#runHandlers(true); // Run domOnly
+        this.#checkAllReady(); // Then check for full readiness
+    }
+    /**
+     * Initializes the manager using `DOMContentLoaded`.
+     */
+    init() {
+        if (this.#isDomReady)
+            throw new Error('[TinyDomReadyManager] init() has already been called.');
+        if (document.readyState === 'interactive' || document.readyState === 'complete') {
+            this._markDomReady();
+        }
+        else {
+            document.addEventListener('DOMContentLoaded', () => this._markDomReady());
+        }
+    }
+    /**
+     * Adds a Promise to delay full readiness.
+     * @param {Promise<any>} promise
+     * @throws {TypeError}
+     */
+    addPromise(promise) {
+        if (!(promise instanceof Promise))
+            throw new TypeError('[TinyDomReadyManager] promise must be a valid Promise.');
+        if (this.#isFullyReady)
+            return;
+        this.#promises.push(promise);
+        if (this.#isDomReady)
+            this.#checkAllReady();
+    }
+    /**
+     * Registers a handler to run either after DOM is ready or after full readiness.
+     *
+     * @param {Fn} fn - Function to execute.
+     * @param {Object} [options]
+     * @param {boolean} [options.once=true] - Execute only once.
+     * @param {number} [options.priority=0] - Higher priority runs first.
+     * @param {FnFilter|null} [options.filter=null] - Optional filter function.
+     * @param {boolean} [options.domOnly=false] - If true, executes after DOM ready only.
+     * @throws {TypeError} If fn is not a function.
+     */
+    onReady(fn, { once = true, priority = 0, filter = null, domOnly = false } = {}) {
+        if (typeof fn !== 'function')
+            throw new TypeError('[TinyDomReadyManager] fn must be a function.');
+        const handler = { fn, once, priority, filter, domOnly };
+        if (domOnly && this.#isDomReady) {
+            this.#invokeHandler(handler);
+            if (!once)
+                this.#handlers.push(handler);
+            return;
+        }
+        if (!domOnly && this.#isFullyReady) {
+            this.#invokeHandler(handler);
+        }
+        else {
+            this.#handlers.push(handler);
+        }
+    }
+    /**
+     * Returns whether the system is fully ready (DOM + Promises).
+     * @returns {boolean}
+     */
+    isReady() {
+        return this.#isFullyReady;
+    }
+    /**
+     * Returns whether the DOM is ready (DOMContentLoaded has fired).
+     * Does not wait for promises.
+     * @returns {boolean}
+     */
+    isDomReady() {
+        return this.#isDomReady;
+    }
+}
+export default TinyDomReadyManager;

package/docs/v1/README.md

@@ -31,6 +31,7 @@ This folder contains the core scripts we have worked on so far. Each file is a m
 - 📥 **[TinyDragDropDetector](./libs/TinyDragDropDetector.md)** — A lightweight drag-and-drop detector for files, handling the full drag lifecycle (`enter`, `over`, `leave`, `drop`) with CSS hover management and safe event handling on any DOM element or the full page.
 * 📂 **[TinyUploadClicker](./libs/TinyUploadClicker.md)** — A minimal utility to bind any clickable element to a hidden file input, offering full control over styling, behavior, and upload event hooks.
 * 🧲 **[TinyDragger](./libs/TinyDragger.md)** — A flexible drag-and-drop manager with collision detection, jail constraints, vibration feedback, visual proxies, revert-on-drop, and full custom event support.
+* 🕒 **[TinyDomReadyManager](./libs/TinyDomReadyManager.md)** — A readiness manager for DOM and async conditions, supporting prioritized callbacks, custom filters, and event-based or promise-based bootstrapping.
 
 ### 3. **`fileManager/`**
 * 📁 **[main](./fileManager/main.md)** — A Node.js file/directory utility module with support for JSON, backups, renaming, size analysis, and more.

package/docs/v1/basics/simpleMath.md

@@ -119,3 +119,31 @@ formatBytes(1073741824, 2, 'MB');
 * **Formatting:** Converts bytes to the most appropriate unit (from 'Bytes' to 'YB') based on the byte value.
 * **Max Unit:** The `maxUnit` parameter allows you to limit the highest unit for conversion. If not provided, it will convert all the way up to 'YB'.
 * **Decimals:** The result can be customized with a specified number of decimal places for precision. If `decimals` is `null`, no rounding is applied, and the full precision value is returned.
+
+---
+
+### 🔢 `genFibonacciSeq()` — Custom Fibonacci Sequence Generator
+
+📐 Flexible, combinable, and vector-friendly!
+
+Generates a customizable Fibonacci-like sequence. You can use simple numbers or even 2D/ND vectors by passing a custom `combiner` function.
+
+```js
+genFibonacciSeq({
+  baseValues: [[0, 1], [1, 1]],
+  length: 10,
+  combiner: ([x1, y1], [x2, y2]) => [x1 + x2, y1 + y2]
+});
+```
+
+#### ⚙️ Options
+
+* `baseValues` 🧬: Two starting values (default: `[0, 1]`)
+* `length` 📏: How many items to generate (default: `10`)
+* `combiner` 🧪: Custom function to generate next value from the last two (default: `(a, b) => a + b`)
+
+#### 🧠 Returns
+
+An array representing the generated sequence.
+
+> 🔖 **Beta** – Still experimental and fun to tweak!