tiny-essentials 1.18.1 → 1.19.0

package/dist/v1/basics/html.cjs

@@ -283,8 +283,8 @@ async function fetchBlob(url, allowedMimeTypes, options) {
  * @param {Element} [settings.element=document.body] - The element to receive visibility classes.
  * @param {string} [settings.hiddenClass='windowHidden'] - CSS class applied when the page is hidden.
  * @param {string} [settings.visibleClass='windowVisible'] - CSS class applied when the page is visible.
- * @param {() => void} [settings.onVisible] - Callback called when page becomes visible.
- * @param {() => void} [settings.onHidden] - Callback called when page becomes hidden.
+ * @param {(data: { type: string; oldType: string; oldClass: string; }) => void} [settings.onVisible] - Callback called when page becomes visible.
+ * @param {(data: { type: string; oldType: string; oldClass: string; }) => void} [settings.onHidden] - Callback called when page becomes hidden.
  * @returns {() => void} Function that removes all installed event listeners.
  * @throws {TypeError} If any provided setting is invalid.
  */
@@ -304,6 +304,8 @@ function installWindowHiddenScript({
   if (onHidden !== undefined && typeof onHidden !== 'function')
     throw new TypeError(`"onHidden" must be a function if provided.`);
 
+  let oldType = '';
+  let oldClass = '';
   const removeClass = () => {
     element.classList.remove(hiddenClass);
     element.classList.remove(visibleClass);
@@ -341,19 +343,24 @@ function installWindowHiddenScript({
 
     if (visibleEvents.includes(type)) {
       element.classList.add(visibleClass);
-      onVisible?.();
+      onVisible?.({ type, oldClass, oldType });
+      oldClass = visibleClass;
     } else if (hiddenEvents.includes(type)) {
       element.classList.add(hiddenClass);
-      onHidden?.();
+      onHidden?.({ type, oldClass, oldType });
+      oldClass = hiddenClass;
     } else {
       if (isHidden) {
         element.classList.add(hiddenClass);
-        onHidden?.();
+        onHidden?.({ type, oldClass, oldType });
+        oldClass = hiddenClass;
       } else {
         element.classList.add(visibleClass);
-        onVisible?.();
+        onVisible?.({ type, oldClass, oldType });
+        oldClass = visibleClass;
       }
     }
+    oldType = type;
   };
 
   /** @type {() => void} */

package/dist/v1/basics/html.d.mts

@@ -73,8 +73,8 @@ export function fetchBlob(url: string, allowedMimeTypes?: string[], options?: Ob
  * @param {Element} [settings.element=document.body] - The element to receive visibility classes.
  * @param {string} [settings.hiddenClass='windowHidden'] - CSS class applied when the page is hidden.
  * @param {string} [settings.visibleClass='windowVisible'] - CSS class applied when the page is visible.
- * @param {() => void} [settings.onVisible] - Callback called when page becomes visible.
- * @param {() => void} [settings.onHidden] - Callback called when page becomes hidden.
+ * @param {(data: { type: string; oldType: string; oldClass: string; }) => void} [settings.onVisible] - Callback called when page becomes visible.
+ * @param {(data: { type: string; oldType: string; oldClass: string; }) => void} [settings.onHidden] - Callback called when page becomes hidden.
  * @returns {() => void} Function that removes all installed event listeners.
  * @throws {TypeError} If any provided setting is invalid.
  */
@@ -82,8 +82,16 @@ export function installWindowHiddenScript({ element, hiddenClass, visibleClass,
     element?: Element | undefined;
     hiddenClass?: string | undefined;
     visibleClass?: string | undefined;
-    onVisible?: (() => void) | undefined;
-    onHidden?: (() => void) | undefined;
+    onVisible?: ((data: {
+        type: string;
+        oldType: string;
+        oldClass: string;
+    }) => void) | undefined;
+    onHidden?: ((data: {
+        type: string;
+        oldType: string;
+        oldClass: string;
+    }) => void) | undefined;
 }): () => void;
 export type FetchTemplateOptions = {
     /**

package/dist/v1/basics/html.mjs

@@ -242,8 +242,8 @@ export async function fetchBlob(url, allowedMimeTypes, options) {
  * @param {Element} [settings.element=document.body] - The element to receive visibility classes.
  * @param {string} [settings.hiddenClass='windowHidden'] - CSS class applied when the page is hidden.
  * @param {string} [settings.visibleClass='windowVisible'] - CSS class applied when the page is visible.
- * @param {() => void} [settings.onVisible] - Callback called when page becomes visible.
- * @param {() => void} [settings.onHidden] - Callback called when page becomes hidden.
+ * @param {(data: { type: string; oldType: string; oldClass: string; }) => void} [settings.onVisible] - Callback called when page becomes visible.
+ * @param {(data: { type: string; oldType: string; oldClass: string; }) => void} [settings.onHidden] - Callback called when page becomes hidden.
  * @returns {() => void} Function that removes all installed event listeners.
  * @throws {TypeError} If any provided setting is invalid.
  */
@@ -258,6 +258,8 @@ export function installWindowHiddenScript({ element = document.body, hiddenClass
         throw new TypeError(`"onVisible" must be a function if provided.`);
     if (onHidden !== undefined && typeof onHidden !== 'function')
         throw new TypeError(`"onHidden" must be a function if provided.`);
+    let oldType = '';
+    let oldClass = '';
     const removeClass = () => {
         element.classList.remove(hiddenClass);
         element.classList.remove(visibleClass);
@@ -287,22 +289,27 @@ export function installWindowHiddenScript({ element = document.body, hiddenClass
         const hiddenEvents = ['blur', 'focusout', 'pagehide'];
         if (visibleEvents.includes(type)) {
             element.classList.add(visibleClass);
-            onVisible?.();
+            onVisible?.({ type, oldClass, oldType });
+            oldClass = visibleClass;
         }
         else if (hiddenEvents.includes(type)) {
             element.classList.add(hiddenClass);
-            onHidden?.();
+            onHidden?.({ type, oldClass, oldType });
+            oldClass = hiddenClass;
         }
         else {
             if (isHidden) {
                 element.classList.add(hiddenClass);
-                onHidden?.();
+                onHidden?.({ type, oldClass, oldType });
+                oldClass = hiddenClass;
             }
             else {
                 element.classList.add(visibleClass);
-                onVisible?.();
+                onVisible?.({ type, oldClass, oldType });
+                oldClass = visibleClass;
             }
         }
+        oldType = type;
     };
     /** @type {() => void} */
     let uninstall = () => { };

package/dist/v1/build/TinyColorConverter.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var TinyColorConverter = require('../libs/TinyColorConverter.cjs');
+
+
+
+exports.TinyColorConverter = TinyColorConverter;

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

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

package/dist/v1/build/TinyColorConverter.mjs

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

package/dist/v1/build/TinyEvents.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var TinyEvents = require('../libs/TinyEvents.cjs');
+
+
+
+exports.TinyEvents = TinyEvents;

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

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

package/dist/v1/build/TinyEvents.mjs

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

package/dist/v1/build/TinyLocalStorage.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var TinyLocalStorage = require('../libs/TinyLocalStorage.cjs');
+
+
+
+exports.TinyLocalStorage = TinyLocalStorage;

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

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

package/dist/v1/build/TinyLocalStorage.mjs

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

package/dist/v1/build/TinyTimeout.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var TinyTimeout = require('../libs/TinyTimeout.cjs');
+
+
+
+exports.TinyTimeout = TinyTimeout;

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

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

package/dist/v1/build/TinyTimeout.mjs

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

package/dist/v1/index.cjs

@@ -30,6 +30,10 @@ var UltraRandomMsgGen = require('./libs/UltraRandomMsgGen.cjs');
 var TinySmartScroller = require('./libs/TinySmartScroller.cjs');
 var TinyTextRangeEditor = require('./libs/TinyTextRangeEditor.cjs');
 var TinyClipboard = require('./libs/TinyClipboard.cjs');
+var TinyColorConverter = require('./libs/TinyColorConverter.cjs');
+var TinyTimeout = require('./libs/TinyTimeout.cjs');
+var TinyEvents = require('./libs/TinyEvents.cjs');
+var TinyLocalStorage = require('./libs/TinyLocalStorage.cjs');
 
 
 
@@ -138,3 +142,7 @@ exports.UltraRandomMsgGen = UltraRandomMsgGen;
 exports.TinySmartScroller = TinySmartScroller;
 exports.TinyTextRangeEditor = TinyTextRangeEditor;
 exports.TinyClipboard = TinyClipboard;
+exports.TinyColorConverter = TinyColorConverter;
+exports.TinyTimeout = TinyTimeout;
+exports.TinyEvents = TinyEvents;
+exports.TinyLocalStorage = TinyLocalStorage;

package/dist/v1/index.d.mts

@@ -1,3 +1,7 @@
+import TinyLocalStorage from './libs/TinyLocalStorage.mjs';
+import TinyEvents from './libs/TinyEvents.mjs';
+import TinyTimeout from './libs/TinyTimeout.mjs';
+import TinyColorConverter from './libs/TinyColorConverter.mjs';
 import TinyClipboard from './libs/TinyClipboard.mjs';
 import TinyTextRangeEditor from './libs/TinyTextRangeEditor.mjs';
 import TinySmartScroller from './libs/TinySmartScroller.mjs';
@@ -103,5 +107,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 { TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, 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 };
+export { TinyLocalStorage, TinyEvents, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, 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

@@ -28,4 +28,8 @@ import UltraRandomMsgGen from './libs/UltraRandomMsgGen.mjs';
 import TinySmartScroller from './libs/TinySmartScroller.mjs';
 import TinyTextRangeEditor from './libs/TinyTextRangeEditor.mjs';
 import TinyClipboard from './libs/TinyClipboard.mjs';
-export { TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, 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, };
+import TinyColorConverter from './libs/TinyColorConverter.mjs';
+import TinyTimeout from './libs/TinyTimeout.mjs';
+import TinyEvents from './libs/TinyEvents.mjs';
+import TinyLocalStorage from './libs/TinyLocalStorage.mjs';
+export { TinyLocalStorage, TinyEvents, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, 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, };