tiny-essentials 1.24.0 → 1.24.1

package/dist/v1/basics/array.cjs

@@ -59,6 +59,34 @@ function diffArrayList(oldItems, newItems) {
   return { added, removed };
 }
 
+/**
+ * Generates a comparator function to sort an array of objects by a given key.
+ *
+ * @param {string} item - The object key to sort by.
+ * @param {boolean} [isReverse=false] - If `true`, the sorting will be in descending order.
+ * @returns {(a: Object<string|number, *>, b: Object<string|number, *>) => number} Comparator function compatible with Array.prototype.sort().
+ *
+ * @example
+ * const arr = [{ pos: 2 }, { pos: 1 }, { pos: 3 }];
+ * arr.sort(arraySortPositions('pos')); // Ascending: [{pos: 1}, {pos: 2}, {pos: 3}]
+ *
+ * @example
+ * const arr = [{ pos: 2 }, { pos: 1 }, { pos: 3 }];
+ * arr.sort(arraySortPositions('pos', true)); // Descending: [{pos: 3}, {pos: 2}, {pos: 1}]
+ */
+function arraySortPositions(item, isReverse = false) {
+  if (!isReverse) {
+    return function (a, b) {
+      return a[item] < b[item] ? -1 : a[item] > b[item] ? 1 : 0;
+    };
+  } else {
+    return function (a, b) {
+      return a[item] > b[item] ? -1 : a[item] < b[item] ? 1 : 0;
+    };
+  }
+}
+
+exports.arraySortPositions = arraySortPositions;
 exports.diffArrayList = diffArrayList;
 exports.multiplyArrayBlocks = multiplyArrayBlocks;
 exports.shuffleArray = shuffleArray;

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

@@ -25,4 +25,20 @@ export function diffArrayList(oldItems: any[], newItems: any[]): {
     added: any[];
     removed: any[];
 };
+/**
+ * Generates a comparator function to sort an array of objects by a given key.
+ *
+ * @param {string} item - The object key to sort by.
+ * @param {boolean} [isReverse=false] - If `true`, the sorting will be in descending order.
+ * @returns {(a: Object<string|number, *>, b: Object<string|number, *>) => number} Comparator function compatible with Array.prototype.sort().
+ *
+ * @example
+ * const arr = [{ pos: 2 }, { pos: 1 }, { pos: 3 }];
+ * arr.sort(arraySortPositions('pos')); // Ascending: [{pos: 1}, {pos: 2}, {pos: 3}]
+ *
+ * @example
+ * const arr = [{ pos: 2 }, { pos: 1 }, { pos: 3 }];
+ * arr.sort(arraySortPositions('pos', true)); // Descending: [{pos: 3}, {pos: 2}, {pos: 1}]
+ */
+export function arraySortPositions(item: string, isReverse?: boolean): (a: any, b: any) => number;
 //# sourceMappingURL=array.d.mts.map

package/dist/v1/basics/array.mjs

@@ -48,3 +48,30 @@ export function diffArrayList(oldItems, newItems) {
     const added = newItems.filter((c) => !oldItems.includes(c));
     return { added, removed };
 }
+/**
+ * Generates a comparator function to sort an array of objects by a given key.
+ *
+ * @param {string} item - The object key to sort by.
+ * @param {boolean} [isReverse=false] - If `true`, the sorting will be in descending order.
+ * @returns {(a: Object<string|number, *>, b: Object<string|number, *>) => number} Comparator function compatible with Array.prototype.sort().
+ *
+ * @example
+ * const arr = [{ pos: 2 }, { pos: 1 }, { pos: 3 }];
+ * arr.sort(arraySortPositions('pos')); // Ascending: [{pos: 1}, {pos: 2}, {pos: 3}]
+ *
+ * @example
+ * const arr = [{ pos: 2 }, { pos: 1 }, { pos: 3 }];
+ * arr.sort(arraySortPositions('pos', true)); // Descending: [{pos: 3}, {pos: 2}, {pos: 1}]
+ */
+export function arraySortPositions(item, isReverse = false) {
+    if (!isReverse) {
+        return function (a, b) {
+            return a[item] < b[item] ? -1 : a[item] > b[item] ? 1 : 0;
+        };
+    }
+    else {
+        return function (a, b) {
+            return a[item] > b[item] ? -1 : a[item] < b[item] ? 1 : 0;
+        };
+    }
+}

package/dist/v1/basics/index.cjs

@@ -1,7 +1,5 @@
 'use strict';
 
-var arraySortPositions = require('../../legacy/libs/arraySortPositions.cjs');
-var replaceAsync = require('../../legacy/libs/replaceAsync.cjs');
 var array = require('./array.cjs');
 var clock = require('./clock.cjs');
 var html = require('./html.cjs');
@@ -14,8 +12,7 @@ var collision = require('./collision.cjs');
 
 
 
-exports.arraySortPositions = arraySortPositions;
-exports.asyncReplace = replaceAsync;
+exports.arraySortPositions = array.arraySortPositions;
 exports.diffArrayList = array.diffArrayList;
 exports.shuffleArray = array.shuffleArray;
 exports.breakdownDuration = clock.breakdownDuration;
@@ -52,6 +49,7 @@ exports.getPercentage = simpleMath.getPercentage;
 exports.getSimplePerc = simpleMath.getSimplePerc;
 exports.ruleOfThree = simpleMath.ruleOfThree;
 exports.addAiMarkerShortcut = text.addAiMarkerShortcut;
+exports.asyncReplace = text.asyncReplace;
 exports.diffStrings = text.diffStrings;
 exports.safeTextTrim = text.safeTextTrim;
 exports.toTitleCase = text.toTitleCase;

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

@@ -39,7 +39,7 @@ import { isFullScreenMode } from './fullScreen.mjs';
 import { onFullScreenChange } from './fullScreen.mjs';
 import { offFullScreenChange } from './fullScreen.mjs';
 import { isJsonObject } from './objChecker.mjs';
-import arraySortPositions from '../../legacy/libs/arraySortPositions.mjs';
+import { arraySortPositions } from './array.mjs';
 import { formatBytes } from './simpleMath.mjs';
 import { addAiMarkerShortcut } from './text.mjs';
 import { extendObjType } from './objFilter.mjs';
@@ -49,7 +49,7 @@ import { countObj } from './objChecker.mjs';
 import { objType } from './objFilter.mjs';
 import { ruleOfThree } from './simpleMath.mjs';
 import { getSimplePerc } from './simpleMath.mjs';
-import asyncReplace from '../../legacy/libs/replaceAsync.mjs';
+import { asyncReplace } from './text.mjs';
 import { getAge } from './simpleMath.mjs';
 import { formatCustomTimer } from './clock.mjs';
 import { formatDayTimer } from './clock.mjs';

package/dist/v1/basics/index.mjs

@@ -1,12 +1,10 @@
-import arraySortPositions from '../../legacy/libs/arraySortPositions.mjs';
-import asyncReplace from '../../legacy/libs/replaceAsync.mjs';
-import { diffArrayList, shuffleArray } from './array.mjs';
+import { diffArrayList, shuffleArray, arraySortPositions } from './array.mjs';
 import { breakdownDuration, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, } from './clock.mjs';
 import { readJsonBlob, saveJsonFile, fetchJson, installWindowHiddenScript, readFileBlob, readBase64Blob, fetchText, } from './html.mjs';
 import { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType } from './objFilter.mjs';
 import { countObj, isJsonObject } from './objChecker.mjs';
 import { documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, } from './fullScreen.mjs';
 import { calculateMarketcap, compareMarketcap, formatBytes, genFibonacciSeq, getAge, getPercentage, getSimplePerc, ruleOfThree, } from './simpleMath.mjs';
-import { addAiMarkerShortcut, diffStrings, safeTextTrim, toTitleCase, toTitleCaseLowerFirst, } from './text.mjs';
+import { addAiMarkerShortcut, diffStrings, safeTextTrim, toTitleCase, toTitleCaseLowerFirst, asyncReplace, } from './text.mjs';
 import { areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, } from './collision.mjs';
 export { diffStrings, diffArrayList, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/dist/v1/basics/text.cjs

@@ -1,5 +1,37 @@
 'use strict';
 
+/**
+ * Asynchronously replaces matches in a string using a regex and an async function.
+ *
+ * @param {string} str - The input string to perform replacements on.
+ * @param {RegExp} regex - The regular expression to match substrings for replacement.
+ * @param {Function} asyncFn - An asynchronous function that returns a replacement for each match.
+ *                             It receives the same arguments as a standard `replace` callback.
+ * @returns {Promise<string>} The resulting string with all async replacements applied.
+ *
+ * @example
+ * await asyncReplace("Hello @user1 and @user2!", /@\w+/g, async (mention) => {
+ *   return await getUserNameFromMention(mention);
+ * });
+ */
+async function asyncReplace(str, regex, asyncFn) {
+  /**
+   * @type {any[]}
+   */
+  const promises = [];
+
+  // Collect promises
+  str.replace(regex, (match, ...args) => {
+    promises.push(asyncFn(match, ...args));
+    return match;
+  });
+
+  const data = await Promise.all(promises);
+
+  // Replace using the resolved data
+  return str.replace(regex, () => data.shift());
+}
+
 /**
  * Converts a string to title case where the first letter of each word is capitalized.
  * All other letters are converted to lowercase.
@@ -165,6 +197,7 @@ export default KeyPressHandler;
 */
 
 exports.addAiMarkerShortcut = addAiMarkerShortcut;
+exports.asyncReplace = asyncReplace;
 exports.diffStrings = diffStrings;
 exports.safeTextTrim = safeTextTrim;
 exports.toTitleCase = toTitleCase;

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

@@ -1,3 +1,18 @@
+/**
+ * Asynchronously replaces matches in a string using a regex and an async function.
+ *
+ * @param {string} str - The input string to perform replacements on.
+ * @param {RegExp} regex - The regular expression to match substrings for replacement.
+ * @param {Function} asyncFn - An asynchronous function that returns a replacement for each match.
+ *                             It receives the same arguments as a standard `replace` callback.
+ * @returns {Promise<string>} The resulting string with all async replacements applied.
+ *
+ * @example
+ * await asyncReplace("Hello @user1 and @user2!", /@\w+/g, async (mention) => {
+ *   return await getUserNameFromMention(mention);
+ * });
+ */
+export function asyncReplace(str: string, regex: RegExp, asyncFn: Function): Promise<string>;
 /**
  * Converts a string to title case where the first letter of each word is capitalized.
  * All other letters are converted to lowercase.

package/dist/v1/basics/text.mjs

@@ -1,3 +1,31 @@
+/**
+ * Asynchronously replaces matches in a string using a regex and an async function.
+ *
+ * @param {string} str - The input string to perform replacements on.
+ * @param {RegExp} regex - The regular expression to match substrings for replacement.
+ * @param {Function} asyncFn - An asynchronous function that returns a replacement for each match.
+ *                             It receives the same arguments as a standard `replace` callback.
+ * @returns {Promise<string>} The resulting string with all async replacements applied.
+ *
+ * @example
+ * await asyncReplace("Hello @user1 and @user2!", /@\w+/g, async (mention) => {
+ *   return await getUserNameFromMention(mention);
+ * });
+ */
+export async function asyncReplace(str, regex, asyncFn) {
+    /**
+     * @type {any[]}
+     */
+    const promises = [];
+    // Collect promises
+    str.replace(regex, (match, ...args) => {
+        promises.push(asyncFn(match, ...args));
+        return match;
+    });
+    const data = await Promise.all(promises);
+    // Replace using the resolved data
+    return str.replace(regex, () => data.shift());
+}
 /**
  * Converts a string to title case where the first letter of each word is capitalized.
  * All other letters are converted to lowercase.

package/dist/v1/build/TinyLevelUp.cjs

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

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

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

package/dist/v1/build/TinyLevelUp.mjs

@@ -1,2 +1,2 @@
-import TinyLevelUp from '../../legacy/libs/userLevel.mjs';
+import TinyLevelUp from '../libs/TinyLevelUp.mjs';
 export { TinyLevelUp };

package/dist/v1/index.cjs

@@ -1,8 +1,6 @@
 'use strict';
 
-var replaceAsync = require('../legacy/libs/replaceAsync.cjs');
-var userLevel = require('../legacy/libs/userLevel.cjs');
-var arraySortPositions = require('../legacy/libs/arraySortPositions.cjs');
+var TinyLevelUp = require('./libs/TinyLevelUp.cjs');
 var array = require('./basics/array.cjs');
 var clock = require('./basics/clock.cjs');
 var objFilter = require('./basics/objFilter.cjs');
@@ -52,9 +50,8 @@ var TinyColorValidator = require('./libs/TinyColorValidator.cjs');
 
 
 
-exports.asyncReplace = replaceAsync;
-exports.TinyLevelUp = userLevel;
-exports.arraySortPositions = arraySortPositions;
+exports.TinyLevelUp = TinyLevelUp;
+exports.arraySortPositions = array.arraySortPositions;
 exports.diffArrayList = array.diffArrayList;
 exports.shuffleArray = array.shuffleArray;
 exports.breakdownDuration = clock.breakdownDuration;
@@ -85,6 +82,7 @@ exports.getPercentage = simpleMath.getPercentage;
 exports.getSimplePerc = simpleMath.getSimplePerc;
 exports.ruleOfThree = simpleMath.ruleOfThree;
 exports.addAiMarkerShortcut = text.addAiMarkerShortcut;
+exports.asyncReplace = text.asyncReplace;
 exports.diffStrings = text.diffStrings;
 exports.safeTextTrim = text.safeTextTrim;
 exports.toTitleCase = text.toTitleCase;

package/dist/v1/index.d.mts

@@ -33,7 +33,7 @@ import TinyNotifyCenter from './libs/TinyNotifyCenter.mjs';
 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 TinyLevelUp from './libs/TinyLevelUp.mjs';
 import { diffArrayList } from './basics/array.mjs';
 import { diffStrings } from './basics/text.mjs';
 import { breakdownDuration } from './basics/clock.mjs';
@@ -103,7 +103,7 @@ import { isFullScreenMode } from './basics/fullScreen.mjs';
 import { onFullScreenChange } from './basics/fullScreen.mjs';
 import { offFullScreenChange } from './basics/fullScreen.mjs';
 import { isJsonObject } from './basics/objChecker.mjs';
-import arraySortPositions from '../legacy/libs/arraySortPositions.mjs';
+import { arraySortPositions } from './basics/array.mjs';
 import { formatBytes } from './basics/simpleMath.mjs';
 import { addAiMarkerShortcut } from './basics/text.mjs';
 import { extendObjType } from './basics/objFilter.mjs';
@@ -114,7 +114,7 @@ import { checkObj } from './basics/objFilter.mjs';
 import { objType } from './basics/objFilter.mjs';
 import { ruleOfThree } from './basics/simpleMath.mjs';
 import { getSimplePerc } from './basics/simpleMath.mjs';
-import asyncReplace from '../legacy/libs/replaceAsync.mjs';
+import { asyncReplace } from './basics/text.mjs';
 import { getAge } from './basics/simpleMath.mjs';
 import { formatCustomTimer } from './basics/clock.mjs';
 import { formatDayTimer } from './basics/clock.mjs';

package/dist/v1/index.mjs

@@ -1,13 +1,11 @@
-import asyncReplace from '../legacy/libs/replaceAsync.mjs';
-import TinyLevelUp from '../legacy/libs/userLevel.mjs';
-import arraySortPositions from '../legacy/libs/arraySortPositions.mjs';
-import { diffArrayList, shuffleArray } from './basics/array.mjs';
+import TinyLevelUp from './libs/TinyLevelUp.mjs';
+import { diffArrayList, shuffleArray, arraySortPositions } from './basics/array.mjs';
 import { breakdownDuration, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, } from './basics/clock.mjs';
 import { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, checkObj, } from './basics/objFilter.mjs';
 import { countObj, isJsonObject } from './basics/objChecker.mjs';
 import { documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, } from './basics/fullScreen.mjs';
 import { calculateMarketcap, compareMarketcap, formatBytes, genFibonacciSeq, getAge, getPercentage, getSimplePerc, ruleOfThree, } from './basics/simpleMath.mjs';
-import { addAiMarkerShortcut, diffStrings, safeTextTrim, toTitleCase, toTitleCaseLowerFirst, } from './basics/text.mjs';
+import { addAiMarkerShortcut, diffStrings, safeTextTrim, toTitleCase, toTitleCaseLowerFirst, asyncReplace, } from './basics/text.mjs';
 import ColorSafeStringify from './libs/ColorSafeStringify.mjs';
 import TinyPromiseQueue from './libs/TinyPromiseQueue.mjs';
 import TinyRateLimiter from './libs/TinyRateLimiter.mjs';
@@ -47,4 +45,7 @@ import TinySimpleDice from './libs/TinySimpleDice.mjs';
 import TinyElementObserver from './libs/TinyElementObserver.mjs';
 import TinyLoadingScreen from './libs/TinyLoadingScreen.mjs';
 import TinyColorValidator from './libs/TinyColorValidator.mjs';
-export { TinyColorValidator, TinyLoadingScreen, TinyElementObserver, TinySimpleDice, TinyNeedBar, TinyI18, TinyCookieConsent, TinyInventory, TinyInventoryTrader, TinyArrayPaginator, TinyAdvancedRaffle, TinyDayNightCycle, TinyGamepad, TinyTextarea, TinyNewWinEvents, TinyIframeEvents, TinyLocalStorage, TinyEvents, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, diffArrayList, diffStrings, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getLatestBackupPath, fetchJson, fetchText, 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, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+// import TinyHtmlElems from './libs/TinyHtml/index.mjs';
+export { 
+// TinyHtmlElems,
+TinyColorValidator, TinyLoadingScreen, TinyElementObserver, TinySimpleDice, TinyNeedBar, TinyI18, TinyCookieConsent, TinyInventory, TinyInventoryTrader, TinyArrayPaginator, TinyAdvancedRaffle, TinyDayNightCycle, TinyGamepad, TinyTextarea, TinyNewWinEvents, TinyIframeEvents, TinyLocalStorage, TinyEvents, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, diffArrayList, diffStrings, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getLatestBackupPath, fetchJson, fetchText, 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, 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/TinyHtml/TinyHtmlAnchor.cjs

@@ -0,0 +1,220 @@
+'use strict';
+
+var TinyHtml = require('../TinyHtml.cjs');
+var TinyHtmlTemplate = require('./TinyHtmlTemplate.cjs');
+
+/**
+ * TinyHtmlAnchor is a helper class for managing <a> elements.
+ * It provides strongly-typed getters and setters for attributes like href,
+ * target, rel, hreflang, referrerpolicy, and more.
+ *
+ * @example
+ * const link = new TinyHtmlAnchor({
+ *   href: 'https://example.com',
+ *   label: 'Visit Example',
+ *   target: '_blank',
+ *   rel: 'noopener noreferrer'
+ * });
+ *
+ * @extends TinyHtmlTemplate<HTMLAnchorElement>
+ */
+class TinyHtmlAnchor extends TinyHtmlTemplate {
+  /**
+   * Creates a new TinyHtmlAnchor instance.
+   * @param {Object} config - Configuration object.
+   * @param {string} config.href - Link URL (required).
+   * @param {string|Element|TinyHtml<any>} [config.label] - Link text or HTML.
+   * @param {string} [config.target] - Target attribute.
+   * @param {string} [config.rel] - Relationship of the linked resource.
+   * @param {string} [config.hreflang] - Language of the linked resource.
+   * @param {string|string[]} [config.ping] - URLs to send pings to.
+   * @param {'no-referrer'|'no-referrer-when-downgrade'|'origin'|'origin-when-cross-origin'|'same-origin'|'strict-origin'|'strict-origin-when-cross-origin'|'unsafe-url'} [config.referrerpolicy] - Referrer policy.
+   * @param {string} [config.type] - MIME type of the linked resource.
+   * @param {boolean|string|string[]} [config.attributionsrc] - Enables Attribution Reporting.
+   * @param {string|boolean} [config.download] - Download filename (or boolean to enable).
+   * @param {boolean} [config.allowHtml=false] - Whether to allow HTML inside the link.
+   * @param {string|string[]|Set<string>} [config.tags=[]] - Initial CSS classes.
+   * @param {string} [config.mainClass=''] - Main CSS class.
+   * @throws {TypeError} If any attribute is invalid.
+   */
+  constructor({
+    href,
+    label,
+    target,
+    rel,
+    hreflang,
+    ping,
+    referrerpolicy,
+    type,
+    attributionsrc,
+    download,
+    allowHtml = false,
+    tags = [],
+    mainClass = '',
+  }) {
+    super(document.createElement('a'), tags, mainClass);
+
+    if (typeof href !== 'string' || !href.trim())
+      throw new TypeError('TinyHtmlAnchor: "href" must be a non-empty string.');
+    this.href = href;
+
+    if (target !== undefined) this.target = target;
+    if (rel !== undefined) this.rel = rel;
+    if (hreflang !== undefined) this.hreflang = hreflang;
+    if (ping !== undefined) this.ping = ping;
+    if (referrerpolicy !== undefined) this.referrerpolicy = referrerpolicy;
+    if (type !== undefined) this.type = type;
+    if (attributionsrc !== undefined) this.attributionsrc = attributionsrc;
+    if (download !== undefined) this.download = download;
+
+    if (typeof allowHtml !== 'boolean')
+      throw new TypeError('TinyHtmlAnchor: "allowHtml" must be a boolean.');
+
+    if (label !== undefined) this.setLabel(label, allowHtml);
+  }
+
+  /** @param {string} href */
+  set href(href) {
+    if (typeof href !== 'string' || !href.trim())
+      throw new TypeError('TinyHtmlAnchor: "href" must be a non-empty string.');
+    this.setAttr('href', href);
+  }
+  /** @returns {string|null} */
+  get href() {
+    return this.attrString('href');
+  }
+
+  /** @param {string} target */
+  set target(target) {
+    if (typeof target !== 'string')
+      throw new TypeError('TinyHtmlAnchor: "target" must be a string.');
+    this.setAttr('target', target);
+  }
+  /** @returns {string|null} */
+  get target() {
+    return this.attrString('target');
+  }
+
+  /** @param {string} rel */
+  set rel(rel) {
+    if (typeof rel !== 'string') throw new TypeError('TinyHtmlAnchor: "rel" must be a string.');
+    this.setAttr('rel', rel);
+  }
+  /** @returns {string|null} */
+  get rel() {
+    return this.attrString('rel');
+  }
+
+  /** @param {string} hreflang */
+  set hreflang(hreflang) {
+    if (typeof hreflang !== 'string')
+      throw new TypeError('TinyHtmlAnchor: "hreflang" must be a string.');
+    this.setAttr('hreflang', hreflang);
+  }
+  /** @returns {string|null} */
+  get hreflang() {
+    return this.attrString('hreflang');
+  }
+
+  /** @param {string|string[]} ping */
+  set ping(ping) {
+    if (Array.isArray(ping)) ping = ping.join(' ');
+    if (typeof ping !== 'string')
+      throw new TypeError('TinyHtmlAnchor: "ping" must be a string or string[].');
+    this.setAttr('ping', ping);
+  }
+  /** @returns {string|null} */
+  get ping() {
+    return this.attrString('ping');
+  }
+
+  /** @param {'no-referrer'|'no-referrer-when-downgrade'|'origin'|'origin-when-cross-origin'|'same-origin'|'strict-origin'|'strict-origin-when-cross-origin'|'unsafe-url'} referrerpolicy */
+  set referrerpolicy(referrerpolicy) {
+    const valid = [
+      'no-referrer',
+      'no-referrer-when-downgrade',
+      'origin',
+      'origin-when-cross-origin',
+      'same-origin',
+      'strict-origin',
+      'strict-origin-when-cross-origin',
+      'unsafe-url',
+    ];
+    if (!valid.includes(referrerpolicy))
+      throw new TypeError(`TinyHtmlAnchor: "referrerpolicy" must be one of: ${valid.join(', ')}`);
+    this.setAttr('referrerpolicy', referrerpolicy);
+  }
+  /** @returns {string|null} */
+  get referrerpolicy() {
+    return this.attrString('referrerpolicy');
+  }
+
+  /** @param {string} type */
+  set type(type) {
+    if (typeof type !== 'string')
+      throw new TypeError('TinyHtmlAnchor: "type" must be a string (MIME type).');
+    this.setAttr('type', type);
+  }
+  /** @returns {string|null} */
+  get type() {
+    return this.attrString('type');
+  }
+
+  /** @param {boolean|string|string[]} attributionsrc */
+  set attributionsrc(attributionsrc) {
+    if (attributionsrc === true) {
+      this.addProp('attributionsrc');
+    } else if (typeof attributionsrc === 'string') {
+      this.setAttr('attributionsrc', attributionsrc);
+    } else if (Array.isArray(attributionsrc)) {
+      this.setAttr('attributionsrc', attributionsrc.join(' '));
+    } else {
+      throw new TypeError(
+        'TinyHtmlAnchor: "attributionsrc" must be a boolean, string, or string[].',
+      );
+    }
+  }
+  /** @returns {string|null} */
+  get attributionsrc() {
+    return this.attrString('attributionsrc');
+  }
+
+  /** @param {string|boolean} download */
+  set download(download) {
+    if (typeof download !== 'string' && typeof download !== 'boolean')
+      throw new TypeError('TinyHtmlAnchor: "download" must be a string or boolean.');
+    if (typeof download === 'string') this.setAttr('download', download);
+    else if (download) this.addProp('download');
+    else this.removeProp('download');
+  }
+  /** @returns {string|boolean|null} */
+  get download() {
+    if (this.hasProp('download')) {
+      return true;
+    }
+    return this.attrString('download');
+  }
+
+  /**
+   * Updates the link label with text, HTML, or an element.
+   *
+   * @param {string|Element|TinyHtml<any>} label - The new label to set.
+   * @param {boolean} [allowHtml=false] - Whether to allow raw HTML or DOM elements instead of plain text.
+   * @returns {this}
+   */
+  setLabel(label, allowHtml = false) {
+    if (typeof label === 'string') {
+      if (!allowHtml) this.setText(label);
+      else this.setHtml(label);
+    } else if (label instanceof Element || label instanceof TinyHtml) {
+      if (!allowHtml)
+        throw new Error('setLabel: Passing an Element/TinyHtml requires allowHtml=true.');
+      this.empty().append(label);
+    } else {
+      throw new TypeError("setLabel: 'label' must be a string, Element, or TinyHtml instance.");
+    }
+    return this;
+  }
+}
+
+module.exports = TinyHtmlAnchor;