tiny-essentials 1.15.0 → 1.16.1

package/dist/v1/index.d.mts

@@ -1,3 +1,5 @@
+import TinyAfterScrollWatcher from './libs/TinyAfterScrollWatcher.mjs';
+import TinyHtml from './libs/TinyHtml.mjs';
 import TinyNotifications from './libs/TinyNotifications.mjs';
 import TinyDomReadyManager from './libs/TinyDomReadyManager.mjs';
 import TinyDragger from './libs/TinyDragger.mjs';
@@ -26,8 +28,8 @@ import { getRectCenter } from './basics/collision.mjs';
 import { getElsRelativeCenterOffset } from './basics/collision.mjs';
 import { getElsCollDirDepth } from './basics/collision.mjs';
 import { getElsCollDetails } from './basics/collision.mjs';
-import { isInViewport } from './basics/html.mjs';
-import { isScrolledIntoView } from './basics/html.mjs';
+import { isInViewport } from './basics/html_deprecated.mjs';
+import { isScrolledIntoView } from './basics/html_deprecated.mjs';
 import { safeTextTrim } from './basics/text.mjs';
 import { installWindowHiddenScript } from './basics/html.mjs';
 import { genFibonacciSeq } from './basics/simpleMath.mjs';
@@ -36,10 +38,10 @@ import { fileSizeAsync } from './fileManager/asyncFuncs.mjs';
 import { dirSizeAsync } from './fileManager/asyncFuncs.mjs';
 import { listFilesAsync } from './fileManager/asyncFuncs.mjs';
 import { listDirsAsync } from './fileManager/asyncFuncs.mjs';
-import { getHtmlElBorders } from './basics/html.mjs';
-import { getHtmlElBordersWidth } from './basics/html.mjs';
-import { getHtmlElMargin } from './basics/html.mjs';
-import { getHtmlElPadding } from './basics/html.mjs';
+import { getHtmlElBorders } from './basics/html_deprecated.mjs';
+import { getHtmlElBordersWidth } from './basics/html_deprecated.mjs';
+import { getHtmlElMargin } from './basics/html_deprecated.mjs';
+import { getHtmlElPadding } from './basics/html_deprecated.mjs';
 import { getLatestBackupPath } from './fileManager/normalFuncs.mjs';
 import { fetchJson } from './basics/html.mjs';
 import { readJsonBlob } from './basics/html.mjs';
@@ -75,7 +77,7 @@ import { exitFullScreen } from './basics/fullScreen.mjs';
 import { isFullScreenMode } from './basics/fullScreen.mjs';
 import { onFullScreenChange } from './basics/fullScreen.mjs';
 import { offFullScreenChange } from './basics/fullScreen.mjs';
-import { areHtmlElsColliding } from './basics/html.mjs';
+import { areHtmlElsColliding } from './basics/html_deprecated.mjs';
 import { isJsonObject } from './basics/objFilter.mjs';
 import arraySortPositions from '../legacy/libs/arraySortPositions.mjs';
 import { formatBytes } from './basics/simpleMath.mjs';
@@ -97,5 +99,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 { TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, isInViewport, isScrolledIntoView, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, readFileBlob, readBase64Blob, 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 { TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, isInViewport, isScrolledIntoView, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, readFileBlob, readBase64Blob, 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

@@ -12,7 +12,8 @@ import TinyPromiseQueue from './libs/TinyPromiseQueue.mjs';
 import TinyRateLimiter from './libs/TinyRateLimiter.mjs';
 import TinyNotifyCenter from './libs/TinyNotifyCenter.mjs';
 import TinyToastNotify from './libs/TinyToastNotify.mjs';
-import { areHtmlElsColliding, readJsonBlob, saveJsonFile, fetchJson, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, installWindowHiddenScript, readFileBlob, readBase64Blob, isInViewport, isScrolledIntoView, } from './basics/html.mjs';
+import { readJsonBlob, saveJsonFile, fetchJson, installWindowHiddenScript, readFileBlob, readBase64Blob, } from './basics/html.mjs';
+import { getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, areHtmlElsColliding, isInViewport, isScrolledIntoView, } from './basics/html_deprecated.mjs';
 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';
@@ -20,4 +21,6 @@ import TinyDragger from './libs/TinyDragger.mjs';
 import TinyDomReadyManager from './libs/TinyDomReadyManager.mjs';
 import TinyNotifications from './libs/TinyNotifications.mjs';
 import { areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, } from './basics/collision.mjs';
-export { TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, isInViewport, isScrolledIntoView, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, readFileBlob, readBase64Blob, 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 TinyHtml from './libs/TinyHtml.mjs';
+import TinyAfterScrollWatcher from './libs/TinyAfterScrollWatcher.mjs';
+export { TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, isInViewport, isScrolledIntoView, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, readFileBlob, readBase64Blob, 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/TinyAfterScrollWatcher.cjs

@@ -0,0 +1,157 @@
+'use strict';
+
+/**
+ * @typedef {(() => void)} FnData - Function with no arguments and no return value
+ */
+
+/**
+ * A function that handles a scroll event.
+ * It receives a standard `Event` object when a scroll occurs.
+ *
+ * @typedef {(ev: Event) => void} OnScrollFunc
+ */
+
+/**
+ * A scroll tracker that queues functions to be executed
+ * after the user stops scrolling a specific element or the window.
+ */
+class TinyAfterScrollWatcher {
+  /** @type {Element|Window} */
+  #scrollTarget;
+
+  /** @type {number} */
+  lastScrollTime = 0;
+
+  /** @type {FnData[]} */
+  #afterScrollQueue = [];
+
+  /** @type {number} */
+  #inactivityTime = 100;
+
+  /** @type {Set<OnScrollFunc>} */
+  #externalScrollListeners = new Set();
+
+  /** @type {boolean} */
+  #destroyed = false;
+
+  /**
+   * @param {Element|Window} scrollTarget - The element or window to track scrolling on
+   * @param {number} [inactivityTime=100] - Time in milliseconds to wait after scroll ends before executing the queue
+   * @throws {TypeError} If scrollTarget is not a valid Element or Window
+   * @throws {TypeError} If inactivityTime is not a positive number
+   */
+  constructor(scrollTarget = window, inactivityTime = 100) {
+    if (!(scrollTarget instanceof Element) && !(scrollTarget instanceof Window))
+      throw new TypeError('scrollTarget must be an Element or the Window object.');
+    this.#scrollTarget = scrollTarget;
+
+    this._onScroll = this._onScroll.bind(this);
+    this._checkQueue = this._checkQueue.bind(this);
+
+    this.#scrollTarget.addEventListener('scroll', this._onScroll);
+    this.#inactivityTime = inactivityTime;
+
+    requestAnimationFrame(this._checkQueue);
+  }
+
+  /**
+   * Gets the current inactivity time in milliseconds.
+   * @returns {number}
+   */
+  get inactivityTime() {
+    return this.#inactivityTime;
+  }
+
+  /**
+   * Sets a new inactivity time.
+   * Must be a positive number (in milliseconds).
+   * @param {number} value
+   * @throws {Error} If value is not a positive number
+   */
+  set inactivityTime(value) {
+    if (typeof value !== 'number' || value <= 0 || !Number.isFinite(value))
+      throw new Error('inactivityTime must be a positive number in milliseconds.');
+    this.#inactivityTime = value;
+  }
+
+  /**
+   * Internal handler for scroll events.
+   * Updates the last scroll timestamp.
+   * @private
+   */
+  _onScroll() {
+    this.lastScrollTime = Date.now();
+  }
+
+  /**
+   * Continuously checks whether the user has stopped scrolling,
+   * and if so, runs all queued functions.
+   * @private
+   */
+  _checkQueue() {
+    if (this.#destroyed) return;
+    requestAnimationFrame(this._checkQueue);
+
+    if (Date.now() - this.lastScrollTime > this.#inactivityTime) {
+      while (this.#afterScrollQueue.length) {
+        const fn = this.#afterScrollQueue.pop();
+        if (typeof fn === 'function') fn();
+      }
+    }
+  }
+
+  /**
+   * Adds a function to be executed after scroll has stopped.
+   * The scroll is considered "stopped" after the configured inactivity time.
+   *
+   * @param {() => void} fn - A function to execute once scrolling has stopped.
+   * @throws {TypeError} If the argument is not a function.
+   */
+  doAfterScroll(fn) {
+    if (typeof fn !== 'function') throw new TypeError('Argument must be a function.');
+    this.lastScrollTime = Date.now();
+    this.#afterScrollQueue.push(fn);
+  }
+
+  /**
+   * Registers an external scroll listener on the tracked element.
+   *
+   * @param {OnScrollFunc} fn - The scroll listener to add
+   * @throws {TypeError} If the argument is not a function.
+   */
+  onScroll(fn) {
+    if (typeof fn !== 'function') throw new TypeError('Argument must be a function.');
+    this.#scrollTarget.addEventListener('scroll', fn);
+    this.#externalScrollListeners.add(fn);
+  }
+
+  /**
+   * Removes a previously registered scroll listener from the tracked element.
+   *
+   * @param {OnScrollFunc} fn - The scroll listener to remove
+   * @throws {TypeError} If the argument is not a function.
+   */
+  offScroll(fn) {
+    if (typeof fn !== 'function') throw new TypeError('Argument must be a function.');
+    if (this.#externalScrollListeners.has(fn)) {
+      this.#scrollTarget.removeEventListener('scroll', fn);
+      this.#externalScrollListeners.delete(fn);
+    }
+  }
+
+  /**
+   * Destroys the watcher by removing internal listeners and clearing data.
+   */
+  destroy() {
+    if (this.#destroyed) return;
+    this.#destroyed = true;
+
+    this.#scrollTarget.removeEventListener('scroll', this._onScroll);
+    for (const fn of this.#externalScrollListeners)
+      this.#scrollTarget.removeEventListener('scroll', fn);
+
+    this.#externalScrollListeners.clear();
+  }
+}
+
+module.exports = TinyAfterScrollWatcher;

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

@@ -0,0 +1,86 @@
+export default TinyAfterScrollWatcher;
+/**
+ * - Function with no arguments and no return value
+ */
+export type FnData = (() => void);
+/**
+ * A function that handles a scroll event.
+ * It receives a standard `Event` object when a scroll occurs.
+ */
+export type OnScrollFunc = (ev: Event) => void;
+/**
+ * @typedef {(() => void)} FnData - Function with no arguments and no return value
+ */
+/**
+ * A function that handles a scroll event.
+ * It receives a standard `Event` object when a scroll occurs.
+ *
+ * @typedef {(ev: Event) => void} OnScrollFunc
+ */
+/**
+ * A scroll tracker that queues functions to be executed
+ * after the user stops scrolling a specific element or the window.
+ */
+declare class TinyAfterScrollWatcher {
+    /**
+     * @param {Element|Window} scrollTarget - The element or window to track scrolling on
+     * @param {number} [inactivityTime=100] - Time in milliseconds to wait after scroll ends before executing the queue
+     * @throws {TypeError} If scrollTarget is not a valid Element or Window
+     * @throws {TypeError} If inactivityTime is not a positive number
+     */
+    constructor(scrollTarget?: Element | Window, inactivityTime?: number);
+    /** @type {number} */
+    lastScrollTime: number;
+    /**
+     * Internal handler for scroll events.
+     * Updates the last scroll timestamp.
+     * @private
+     */
+    private _onScroll;
+    /**
+     * Continuously checks whether the user has stopped scrolling,
+     * and if so, runs all queued functions.
+     * @private
+     */
+    private _checkQueue;
+    /**
+     * Sets a new inactivity time.
+     * Must be a positive number (in milliseconds).
+     * @param {number} value
+     * @throws {Error} If value is not a positive number
+     */
+    set inactivityTime(value: number);
+    /**
+     * Gets the current inactivity time in milliseconds.
+     * @returns {number}
+     */
+    get inactivityTime(): number;
+    /**
+     * Adds a function to be executed after scroll has stopped.
+     * The scroll is considered "stopped" after the configured inactivity time.
+     *
+     * @param {() => void} fn - A function to execute once scrolling has stopped.
+     * @throws {TypeError} If the argument is not a function.
+     */
+    doAfterScroll(fn: () => void): void;
+    /**
+     * Registers an external scroll listener on the tracked element.
+     *
+     * @param {OnScrollFunc} fn - The scroll listener to add
+     * @throws {TypeError} If the argument is not a function.
+     */
+    onScroll(fn: OnScrollFunc): void;
+    /**
+     * Removes a previously registered scroll listener from the tracked element.
+     *
+     * @param {OnScrollFunc} fn - The scroll listener to remove
+     * @throws {TypeError} If the argument is not a function.
+     */
+    offScroll(fn: OnScrollFunc): void;
+    /**
+     * Destroys the watcher by removing internal listeners and clearing data.
+     */
+    destroy(): void;
+    #private;
+}
+//# sourceMappingURL=TinyAfterScrollWatcher.d.mts.map

package/dist/v1/libs/TinyAfterScrollWatcher.mjs

@@ -0,0 +1,138 @@
+/**
+ * @typedef {(() => void)} FnData - Function with no arguments and no return value
+ */
+/**
+ * A function that handles a scroll event.
+ * It receives a standard `Event` object when a scroll occurs.
+ *
+ * @typedef {(ev: Event) => void} OnScrollFunc
+ */
+/**
+ * A scroll tracker that queues functions to be executed
+ * after the user stops scrolling a specific element or the window.
+ */
+class TinyAfterScrollWatcher {
+    /** @type {Element|Window} */
+    #scrollTarget;
+    /** @type {number} */
+    lastScrollTime = 0;
+    /** @type {FnData[]} */
+    #afterScrollQueue = [];
+    /** @type {number} */
+    #inactivityTime = 100;
+    /** @type {Set<OnScrollFunc>} */
+    #externalScrollListeners = new Set();
+    /** @type {boolean} */
+    #destroyed = false;
+    /**
+     * @param {Element|Window} scrollTarget - The element or window to track scrolling on
+     * @param {number} [inactivityTime=100] - Time in milliseconds to wait after scroll ends before executing the queue
+     * @throws {TypeError} If scrollTarget is not a valid Element or Window
+     * @throws {TypeError} If inactivityTime is not a positive number
+     */
+    constructor(scrollTarget = window, inactivityTime = 100) {
+        if (!(scrollTarget instanceof Element) && !(scrollTarget instanceof Window))
+            throw new TypeError('scrollTarget must be an Element or the Window object.');
+        this.#scrollTarget = scrollTarget;
+        this._onScroll = this._onScroll.bind(this);
+        this._checkQueue = this._checkQueue.bind(this);
+        this.#scrollTarget.addEventListener('scroll', this._onScroll);
+        this.#inactivityTime = inactivityTime;
+        requestAnimationFrame(this._checkQueue);
+    }
+    /**
+     * Gets the current inactivity time in milliseconds.
+     * @returns {number}
+     */
+    get inactivityTime() {
+        return this.#inactivityTime;
+    }
+    /**
+     * Sets a new inactivity time.
+     * Must be a positive number (in milliseconds).
+     * @param {number} value
+     * @throws {Error} If value is not a positive number
+     */
+    set inactivityTime(value) {
+        if (typeof value !== 'number' || value <= 0 || !Number.isFinite(value))
+            throw new Error('inactivityTime must be a positive number in milliseconds.');
+        this.#inactivityTime = value;
+    }
+    /**
+     * Internal handler for scroll events.
+     * Updates the last scroll timestamp.
+     * @private
+     */
+    _onScroll() {
+        this.lastScrollTime = Date.now();
+    }
+    /**
+     * Continuously checks whether the user has stopped scrolling,
+     * and if so, runs all queued functions.
+     * @private
+     */
+    _checkQueue() {
+        if (this.#destroyed)
+            return;
+        requestAnimationFrame(this._checkQueue);
+        if (Date.now() - this.lastScrollTime > this.#inactivityTime) {
+            while (this.#afterScrollQueue.length) {
+                const fn = this.#afterScrollQueue.pop();
+                if (typeof fn === 'function')
+                    fn();
+            }
+        }
+    }
+    /**
+     * Adds a function to be executed after scroll has stopped.
+     * The scroll is considered "stopped" after the configured inactivity time.
+     *
+     * @param {() => void} fn - A function to execute once scrolling has stopped.
+     * @throws {TypeError} If the argument is not a function.
+     */
+    doAfterScroll(fn) {
+        if (typeof fn !== 'function')
+            throw new TypeError('Argument must be a function.');
+        this.lastScrollTime = Date.now();
+        this.#afterScrollQueue.push(fn);
+    }
+    /**
+     * Registers an external scroll listener on the tracked element.
+     *
+     * @param {OnScrollFunc} fn - The scroll listener to add
+     * @throws {TypeError} If the argument is not a function.
+     */
+    onScroll(fn) {
+        if (typeof fn !== 'function')
+            throw new TypeError('Argument must be a function.');
+        this.#scrollTarget.addEventListener('scroll', fn);
+        this.#externalScrollListeners.add(fn);
+    }
+    /**
+     * Removes a previously registered scroll listener from the tracked element.
+     *
+     * @param {OnScrollFunc} fn - The scroll listener to remove
+     * @throws {TypeError} If the argument is not a function.
+     */
+    offScroll(fn) {
+        if (typeof fn !== 'function')
+            throw new TypeError('Argument must be a function.');
+        if (this.#externalScrollListeners.has(fn)) {
+            this.#scrollTarget.removeEventListener('scroll', fn);
+            this.#externalScrollListeners.delete(fn);
+        }
+    }
+    /**
+     * Destroys the watcher by removing internal listeners and clearing data.
+     */
+    destroy() {
+        if (this.#destroyed)
+            return;
+        this.#destroyed = true;
+        this.#scrollTarget.removeEventListener('scroll', this._onScroll);
+        for (const fn of this.#externalScrollListeners)
+            this.#scrollTarget.removeEventListener('scroll', fn);
+        this.#externalScrollListeners.clear();
+    }
+}
+export default TinyAfterScrollWatcher;