tiny-essentials 1.13.1 → 1.14.0

package/dist/v1/basics/html.cjs

@@ -22,34 +22,105 @@ function areHtmlElsColliding(elem1, elem2) {
 }
 
 /**
- * Reads and parses a JSON data using FileReader.
- * Throws an error if the content is not valid JSON.
- * @param {File} file
- * @returns {Promise<any>}
+ * Reads the contents of a file using the specified FileReader method.
+ *
+ * @param {File} file - The file to be read.
+ * @param {'readAsArrayBuffer'|'readAsDataURL'|'readAsText'|'readAsBinaryString'} method -
+ *   The FileReader method to use for reading the file.
+ * @returns {Promise<any>} - A promise that resolves with the file content, according to the chosen method.
+ * @throws {Error} - If an unexpected error occurs while handling the result.
+ * @throws {DOMException} - If the FileReader encounters an error while reading the file.
  */
-function readJsonBlob(file) {
+function readFileBlob(file, method) {
   return new Promise((resolve, reject) => {
     const reader = new FileReader();
-
     reader.onload = () => {
       try {
-        // @ts-ignore
-        const result = JSON.parse(reader.result);
-        resolve(result);
+        resolve(reader.result);
       } catch (error) {
-        // @ts-ignore
-        reject(new Error(`Invalid JSON in file: ${file.name}\n${error.message}`));
+        reject(error);
       }
     };
-
     reader.onerror = () => {
-      reject(new Error(`Error reading file: ${file.name}`));
+      reject(reader.error);
     };
+    reader[method](file);
+  });
+}
 
-    reader.readAsText(file);
+/**
+ * Reads a file as a Base64 string using FileReader, and optionally formats it as a full data URL.
+ *
+ * Performs strict validation to ensure the result is a valid Base64 string or a proper data URL.
+ *
+ * @param {File} file - The file to be read.
+ * @param {boolean|string} [isDataUrl=false] - If true, returns a full data URL; if false, returns only the Base64 string;
+ *   if a string is passed, it is used as the MIME type in the data URL.
+ * @returns {Promise<string>} - A promise that resolves with the Base64 string or data URL.
+ *
+ * @throws {TypeError} - If the result is not a string or if `isDataUrl` is not a valid type.
+ * @throws {Error} - If the result does not match the expected data URL format or Base64 structure.
+ * @throws {DOMException} - If the FileReader fails to read the file.
+ */
+function readBase64Blob(file, isDataUrl = false) {
+  return new Promise((resolve, reject) => {
+    if (typeof isDataUrl !== 'string' && typeof isDataUrl !== 'boolean')
+      reject(new TypeError('The isDataUrl parameter must be a boolean or a string.'));
+    readFileBlob(file, 'readAsDataURL')
+      .then(
+        /**
+         * Ensure that the URL format is correct in the required pattern
+         * @param {string} base64Data
+         */ (base64Data) => {
+          if (typeof base64Data !== 'string')
+            throw new TypeError('Expected file content to be a string.');
+
+          const match = base64Data.match(/^data:(.+);base64,(.*)$/);
+          if (!match || !match[2])
+            throw new Error('Invalid data URL format or missing Base64 content.');
+          const [, mimeType, base64] = match;
+          if (!/^[\w/+]+=*$/.test(base64)) throw new Error('Base64 content is malformed.');
+
+          if (typeof isDataUrl === 'boolean') return resolve(isDataUrl ? base64Data : base64);
+          if (!/^[\w-]+\/[\w.+-]+$/.test(isDataUrl))
+            throw new Error(`Invalid MIME type string: ${isDataUrl}`);
+
+          return resolve(`data:${isDataUrl};base64,${base64}`);
+        },
+      )
+      .catch(reject);
   });
 }
 
+/**
+ * Reads a file and strictly validates its content as proper JSON using FileReader.
+ *
+ * Performs several checks to ensure the file contains valid, parsable JSON data.
+ *
+ * @param {File} file - The file to be read. It must contain valid JSON as plain text.
+ * @returns {Promise<Record<string|number|symbol, any>|any[]>} - A promise that resolves with the parsed JSON object.
+ *
+ * @throws {SyntaxError} - If the file content is not valid JSON syntax.
+ * @throws {TypeError} - If the result is not a string or does not represent a JSON value.
+ * @throws {Error} - If the result is empty or structurally invalid as JSON.
+ * @throws {DOMException} - If the FileReader fails to read the file.
+ */
+function readJsonBlob(file) {
+  return new Promise((resolve, reject) =>
+    readFileBlob(file, 'readAsText')
+      .then((data) => {
+        if (typeof data !== 'string') throw new TypeError('Expected file content to be a string.');
+        const trimmed = data.trim();
+        if (trimmed.length === 0) throw new Error('File is empty or contains only whitespace.');
+        const parsed = JSON.parse(trimmed);
+        if (typeof parsed !== 'object' || parsed === null)
+          throw new Error('Parsed content is not a valid JSON object or array.');
+        resolve(parsed);
+      })
+      .catch(reject),
+  );
+}
+
 /**
  * Saves a JSON object as a downloadable file.
  * @param {string} filename
@@ -152,7 +223,8 @@ async function fetchJson(
 
       const data = await response.json();
 
-      if (!objFilter.isJsonObject(data)) throw new Error('Received invalid data instead of valid JSON.');
+      if (!Array.isArray(data) && !objFilter.isJsonObject(data))
+        throw new Error('Received invalid data instead of valid JSON.');
 
       return data;
     } catch (err) {
@@ -252,11 +324,137 @@ const getHtmlElPadding = (el) => {
   return { x, y, left, right, top, bottom };
 };
 
+/**
+ * Installs a script that toggles CSS classes on a given element
+ * based on the page's visibility or focus state, and optionally
+ * triggers callbacks on visibility changes.
+ *
+ * @param {Object} [settings={}]
+ * @param {HTMLElement} [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.
+ * @returns {() => void} Function that removes all installed event listeners.
+ * @throws {TypeError} If any provided setting is invalid.
+ */
+function installWindowHiddenScript({
+  element = document.body,
+  hiddenClass = 'windowHidden',
+  visibleClass = 'windowVisible',
+  onVisible,
+  onHidden,
+} = {}) {
+  if (!(element instanceof HTMLElement))
+    throw new TypeError(`"element" must be an instance of HTMLElement.`);
+  if (typeof hiddenClass !== 'string') throw new TypeError(`"hiddenClass" must be a string.`);
+  if (typeof visibleClass !== 'string') throw new TypeError(`"visibleClass" must be a string.`);
+  if (onVisible !== undefined && typeof onVisible !== 'function')
+    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.`);
+
+  const removeClass = () => {
+    element.classList.remove(hiddenClass);
+    element.classList.remove(visibleClass);
+  };
+
+  /** @type {string|null} */
+  let hiddenProp = null;
+
+  const visibilityEvents = [
+    'visibilitychange',
+    'mozvisibilitychange',
+    'webkitvisibilitychange',
+    'msvisibilitychange',
+  ];
+
+  const visibilityProps = ['hidden', 'mozHidden', 'webkitHidden', 'msHidden'];
+
+  for (let i = 0; i < visibilityProps.length; i++) {
+    if (visibilityProps[i] in document) {
+      hiddenProp = visibilityProps[i];
+      break;
+    }
+  }
+
+  /** @type {(this: any, evt: Event) => void} */
+  const handler = function (evt) {
+    removeClass();
+
+    const type = evt?.type;
+    // @ts-ignore
+    const isHidden = hiddenProp && document[hiddenProp];
+
+    const visibleEvents = ['focus', 'focusin', 'pageshow'];
+    const hiddenEvents = ['blur', 'focusout', 'pagehide'];
+
+    if (visibleEvents.includes(type)) {
+      element.classList.add(visibleClass);
+      onVisible?.();
+    } else if (hiddenEvents.includes(type)) {
+      element.classList.add(hiddenClass);
+      onHidden?.();
+    } else {
+      if (isHidden) {
+        element.classList.add(hiddenClass);
+        onHidden?.();
+      } else {
+        element.classList.add(visibleClass);
+        onVisible?.();
+      }
+    }
+  };
+
+  /** @type {() => void} */
+  let uninstall = () => {};
+
+  if (hiddenProp) {
+    const eventType = visibilityEvents[visibilityProps.indexOf(hiddenProp)];
+    document.addEventListener(eventType, handler);
+    window.addEventListener('focus', handler);
+    window.addEventListener('blur', handler);
+
+    uninstall = () => {
+      document.removeEventListener(eventType, handler);
+      window.removeEventListener('focus', handler);
+      window.removeEventListener('blur', handler);
+      removeClass();
+    };
+  } else if ('onfocusin' in document) {
+    // Fallback for IE9 and older
+    // @ts-ignore
+    document.onfocusin = document.onfocusout = handler;
+    uninstall = () => {
+      // @ts-ignore
+      document.onfocusin = document.onfocusout = null;
+      removeClass();
+    };
+  } else {
+    // Last resort fallback
+    window.onpageshow = window.onpagehide = window.onfocus = window.onblur = handler;
+    uninstall = () => {
+      window.onpageshow = window.onpagehide = window.onfocus = window.onblur = null;
+      removeClass();
+    };
+  }
+
+  // Trigger initial state
+  // @ts-ignore
+  const simulatedEvent = new Event(hiddenProp && document[hiddenProp] ? 'blur' : 'focus');
+  handler(simulatedEvent);
+
+  return uninstall;
+}
+
 exports.areHtmlElsColliding = areHtmlElsColliding;
 exports.fetchJson = fetchJson;
 exports.getHtmlElBorders = getHtmlElBorders;
 exports.getHtmlElBordersWidth = getHtmlElBordersWidth;
 exports.getHtmlElMargin = getHtmlElMargin;
 exports.getHtmlElPadding = getHtmlElPadding;
+exports.installWindowHiddenScript = installWindowHiddenScript;
+exports.readBase64Blob = readBase64Blob;
+exports.readFileBlob = readFileBlob;
 exports.readJsonBlob = readJsonBlob;
 exports.saveJsonFile = saveJsonFile;

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

@@ -7,12 +7,45 @@
  */
 export function areHtmlElsColliding(elem1: Element, elem2: Element): boolean;
 /**
- * Reads and parses a JSON data using FileReader.
- * Throws an error if the content is not valid JSON.
- * @param {File} file
- * @returns {Promise<any>}
+ * Reads the contents of a file using the specified FileReader method.
+ *
+ * @param {File} file - The file to be read.
+ * @param {'readAsArrayBuffer'|'readAsDataURL'|'readAsText'|'readAsBinaryString'} method -
+ *   The FileReader method to use for reading the file.
+ * @returns {Promise<any>} - A promise that resolves with the file content, according to the chosen method.
+ * @throws {Error} - If an unexpected error occurs while handling the result.
+ * @throws {DOMException} - If the FileReader encounters an error while reading the file.
+ */
+export function readFileBlob(file: File, method: "readAsArrayBuffer" | "readAsDataURL" | "readAsText" | "readAsBinaryString"): Promise<any>;
+/**
+ * Reads a file as a Base64 string using FileReader, and optionally formats it as a full data URL.
+ *
+ * Performs strict validation to ensure the result is a valid Base64 string or a proper data URL.
+ *
+ * @param {File} file - The file to be read.
+ * @param {boolean|string} [isDataUrl=false] - If true, returns a full data URL; if false, returns only the Base64 string;
+ *   if a string is passed, it is used as the MIME type in the data URL.
+ * @returns {Promise<string>} - A promise that resolves with the Base64 string or data URL.
+ *
+ * @throws {TypeError} - If the result is not a string or if `isDataUrl` is not a valid type.
+ * @throws {Error} - If the result does not match the expected data URL format or Base64 structure.
+ * @throws {DOMException} - If the FileReader fails to read the file.
+ */
+export function readBase64Blob(file: File, isDataUrl?: boolean | string): Promise<string>;
+/**
+ * Reads a file and strictly validates its content as proper JSON using FileReader.
+ *
+ * Performs several checks to ensure the file contains valid, parsable JSON data.
+ *
+ * @param {File} file - The file to be read. It must contain valid JSON as plain text.
+ * @returns {Promise<Record<string|number|symbol, any>|any[]>} - A promise that resolves with the parsed JSON object.
+ *
+ * @throws {SyntaxError} - If the file content is not valid JSON syntax.
+ * @throws {TypeError} - If the result is not a string or does not represent a JSON value.
+ * @throws {Error} - If the result is empty or structurally invalid as JSON.
+ * @throws {DOMException} - If the FileReader fails to read the file.
  */
-export function readJsonBlob(file: File): Promise<any>;
+export function readJsonBlob(file: File): Promise<Record<string | number | symbol, any> | any[]>;
 /**
  * Saves a JSON object as a downloadable file.
  * @param {string} filename
@@ -42,6 +75,27 @@ export function fetchJson(url: string, { method, body, timeout, retries, headers
     headers?: Headers | Record<string, any> | undefined;
     signal?: AbortSignal | null | undefined;
 }): Promise<any>;
+/**
+ * Installs a script that toggles CSS classes on a given element
+ * based on the page's visibility or focus state, and optionally
+ * triggers callbacks on visibility changes.
+ *
+ * @param {Object} [settings={}]
+ * @param {HTMLElement} [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.
+ * @returns {() => void} Function that removes all installed event listeners.
+ * @throws {TypeError} If any provided setting is invalid.
+ */
+export function installWindowHiddenScript({ element, hiddenClass, visibleClass, onVisible, onHidden, }?: {
+    element?: HTMLElement | undefined;
+    hiddenClass?: string | undefined;
+    visibleClass?: string | undefined;
+    onVisible?: (() => void) | undefined;
+    onHidden?: (() => void) | undefined;
+}): () => void;
 export function getHtmlElBordersWidth(el: Element): HtmlElBoxSides;
 export function getHtmlElBorders(el: Element): HtmlElBoxSides;
 export function getHtmlElMargin(el: Element): HtmlElBoxSides;

package/dist/v1/basics/html.mjs

@@ -15,31 +15,101 @@ export function areHtmlElsColliding(elem1, elem2) {
         rect1.top > rect2.bottom);
 }
 /**
- * Reads and parses a JSON data using FileReader.
- * Throws an error if the content is not valid JSON.
- * @param {File} file
- * @returns {Promise<any>}
+ * Reads the contents of a file using the specified FileReader method.
+ *
+ * @param {File} file - The file to be read.
+ * @param {'readAsArrayBuffer'|'readAsDataURL'|'readAsText'|'readAsBinaryString'} method -
+ *   The FileReader method to use for reading the file.
+ * @returns {Promise<any>} - A promise that resolves with the file content, according to the chosen method.
+ * @throws {Error} - If an unexpected error occurs while handling the result.
+ * @throws {DOMException} - If the FileReader encounters an error while reading the file.
  */
-export function readJsonBlob(file) {
+export function readFileBlob(file, method) {
     return new Promise((resolve, reject) => {
         const reader = new FileReader();
         reader.onload = () => {
             try {
-                // @ts-ignore
-                const result = JSON.parse(reader.result);
-                resolve(result);
+                resolve(reader.result);
             }
             catch (error) {
-                // @ts-ignore
-                reject(new Error(`Invalid JSON in file: ${file.name}\n${error.message}`));
+                reject(error);
             }
         };
         reader.onerror = () => {
-            reject(new Error(`Error reading file: ${file.name}`));
+            reject(reader.error);
         };
-        reader.readAsText(file);
+        reader[method](file);
     });
 }
+/**
+ * Reads a file as a Base64 string using FileReader, and optionally formats it as a full data URL.
+ *
+ * Performs strict validation to ensure the result is a valid Base64 string or a proper data URL.
+ *
+ * @param {File} file - The file to be read.
+ * @param {boolean|string} [isDataUrl=false] - If true, returns a full data URL; if false, returns only the Base64 string;
+ *   if a string is passed, it is used as the MIME type in the data URL.
+ * @returns {Promise<string>} - A promise that resolves with the Base64 string or data URL.
+ *
+ * @throws {TypeError} - If the result is not a string or if `isDataUrl` is not a valid type.
+ * @throws {Error} - If the result does not match the expected data URL format or Base64 structure.
+ * @throws {DOMException} - If the FileReader fails to read the file.
+ */
+export function readBase64Blob(file, isDataUrl = false) {
+    return new Promise((resolve, reject) => {
+        if (typeof isDataUrl !== 'string' && typeof isDataUrl !== 'boolean')
+            reject(new TypeError('The isDataUrl parameter must be a boolean or a string.'));
+        readFileBlob(file, 'readAsDataURL')
+            .then(
+        /**
+         * Ensure that the URL format is correct in the required pattern
+         * @param {string} base64Data
+         */ (base64Data) => {
+            if (typeof base64Data !== 'string')
+                throw new TypeError('Expected file content to be a string.');
+            const match = base64Data.match(/^data:(.+);base64,(.*)$/);
+            if (!match || !match[2])
+                throw new Error('Invalid data URL format or missing Base64 content.');
+            const [, mimeType, base64] = match;
+            if (!/^[\w/+]+=*$/.test(base64))
+                throw new Error('Base64 content is malformed.');
+            if (typeof isDataUrl === 'boolean')
+                return resolve(isDataUrl ? base64Data : base64);
+            if (!/^[\w-]+\/[\w.+-]+$/.test(isDataUrl))
+                throw new Error(`Invalid MIME type string: ${isDataUrl}`);
+            return resolve(`data:${isDataUrl};base64,${base64}`);
+        })
+            .catch(reject);
+    });
+}
+/**
+ * Reads a file and strictly validates its content as proper JSON using FileReader.
+ *
+ * Performs several checks to ensure the file contains valid, parsable JSON data.
+ *
+ * @param {File} file - The file to be read. It must contain valid JSON as plain text.
+ * @returns {Promise<Record<string|number|symbol, any>|any[]>} - A promise that resolves with the parsed JSON object.
+ *
+ * @throws {SyntaxError} - If the file content is not valid JSON syntax.
+ * @throws {TypeError} - If the result is not a string or does not represent a JSON value.
+ * @throws {Error} - If the result is empty or structurally invalid as JSON.
+ * @throws {DOMException} - If the FileReader fails to read the file.
+ */
+export function readJsonBlob(file) {
+    return new Promise((resolve, reject) => readFileBlob(file, 'readAsText')
+        .then((data) => {
+        if (typeof data !== 'string')
+            throw new TypeError('Expected file content to be a string.');
+        const trimmed = data.trim();
+        if (trimmed.length === 0)
+            throw new Error('File is empty or contains only whitespace.');
+        const parsed = JSON.parse(trimmed);
+        if (typeof parsed !== 'object' || parsed === null)
+            throw new Error('Parsed content is not a valid JSON object or array.');
+        resolve(parsed);
+    })
+        .catch(reject));
+}
 /**
  * Saves a JSON object as a downloadable file.
  * @param {string} filename
@@ -119,7 +189,7 @@ export async function fetchJson(url, { method = 'GET', body, timeout = 0, retrie
             if (!contentType.includes('application/json'))
                 throw new Error(`Unexpected content-type: ${contentType}`);
             const data = await response.json();
-            if (!isJsonObject(data))
+            if (!Array.isArray(data) && !isJsonObject(data))
                 throw new Error('Received invalid data instead of valid JSON.');
             return data;
         }
@@ -206,3 +276,112 @@ export const getHtmlElPadding = (el) => {
     const y = top + bottom;
     return { x, y, left, right, top, bottom };
 };
+/**
+ * Installs a script that toggles CSS classes on a given element
+ * based on the page's visibility or focus state, and optionally
+ * triggers callbacks on visibility changes.
+ *
+ * @param {Object} [settings={}]
+ * @param {HTMLElement} [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.
+ * @returns {() => void} Function that removes all installed event listeners.
+ * @throws {TypeError} If any provided setting is invalid.
+ */
+export function installWindowHiddenScript({ element = document.body, hiddenClass = 'windowHidden', visibleClass = 'windowVisible', onVisible, onHidden, } = {}) {
+    if (!(element instanceof HTMLElement))
+        throw new TypeError(`"element" must be an instance of HTMLElement.`);
+    if (typeof hiddenClass !== 'string')
+        throw new TypeError(`"hiddenClass" must be a string.`);
+    if (typeof visibleClass !== 'string')
+        throw new TypeError(`"visibleClass" must be a string.`);
+    if (onVisible !== undefined && typeof onVisible !== 'function')
+        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.`);
+    const removeClass = () => {
+        element.classList.remove(hiddenClass);
+        element.classList.remove(visibleClass);
+    };
+    /** @type {string|null} */
+    let hiddenProp = null;
+    const visibilityEvents = [
+        'visibilitychange',
+        'mozvisibilitychange',
+        'webkitvisibilitychange',
+        'msvisibilitychange',
+    ];
+    const visibilityProps = ['hidden', 'mozHidden', 'webkitHidden', 'msHidden'];
+    for (let i = 0; i < visibilityProps.length; i++) {
+        if (visibilityProps[i] in document) {
+            hiddenProp = visibilityProps[i];
+            break;
+        }
+    }
+    /** @type {(this: any, evt: Event) => void} */
+    const handler = function (evt) {
+        removeClass();
+        const type = evt?.type;
+        // @ts-ignore
+        const isHidden = hiddenProp && document[hiddenProp];
+        const visibleEvents = ['focus', 'focusin', 'pageshow'];
+        const hiddenEvents = ['blur', 'focusout', 'pagehide'];
+        if (visibleEvents.includes(type)) {
+            element.classList.add(visibleClass);
+            onVisible?.();
+        }
+        else if (hiddenEvents.includes(type)) {
+            element.classList.add(hiddenClass);
+            onHidden?.();
+        }
+        else {
+            if (isHidden) {
+                element.classList.add(hiddenClass);
+                onHidden?.();
+            }
+            else {
+                element.classList.add(visibleClass);
+                onVisible?.();
+            }
+        }
+    };
+    /** @type {() => void} */
+    let uninstall = () => { };
+    if (hiddenProp) {
+        const eventType = visibilityEvents[visibilityProps.indexOf(hiddenProp)];
+        document.addEventListener(eventType, handler);
+        window.addEventListener('focus', handler);
+        window.addEventListener('blur', handler);
+        uninstall = () => {
+            document.removeEventListener(eventType, handler);
+            window.removeEventListener('focus', handler);
+            window.removeEventListener('blur', handler);
+            removeClass();
+        };
+    }
+    else if ('onfocusin' in document) {
+        // Fallback for IE9 and older
+        // @ts-ignore
+        document.onfocusin = document.onfocusout = handler;
+        uninstall = () => {
+            // @ts-ignore
+            document.onfocusin = document.onfocusout = null;
+            removeClass();
+        };
+    }
+    else {
+        // Last resort fallback
+        window.onpageshow = window.onpagehide = window.onfocus = window.onblur = handler;
+        uninstall = () => {
+            window.onpageshow = window.onpagehide = window.onfocus = window.onblur = null;
+            removeClass();
+        };
+    }
+    // Trigger initial state
+    // @ts-ignore
+    const simulatedEvent = new Event(hiddenProp && document[hiddenProp] ? 'blur' : 'focus');
+    handler(simulatedEvent);
+    return uninstall;
+}

package/dist/v1/basics/index.cjs

@@ -25,6 +25,9 @@ exports.getHtmlElBorders = html.getHtmlElBorders;
 exports.getHtmlElBordersWidth = html.getHtmlElBordersWidth;
 exports.getHtmlElMargin = html.getHtmlElMargin;
 exports.getHtmlElPadding = html.getHtmlElPadding;
+exports.installWindowHiddenScript = html.installWindowHiddenScript;
+exports.readBase64Blob = html.readBase64Blob;
+exports.readFileBlob = html.readFileBlob;
 exports.readJsonBlob = html.readJsonBlob;
 exports.saveJsonFile = html.saveJsonFile;
 exports.cloneObjTypeOrder = objFilter.cloneObjTypeOrder;
@@ -46,5 +49,6 @@ exports.getAge = simpleMath.getAge;
 exports.getSimplePerc = simpleMath.getSimplePerc;
 exports.ruleOfThree = simpleMath.ruleOfThree;
 exports.addAiMarkerShortcut = text.addAiMarkerShortcut;
+exports.safeTextTrim = text.safeTextTrim;
 exports.toTitleCase = text.toTitleCase;
 exports.toTitleCaseLowerFirst = text.toTitleCaseLowerFirst;

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

@@ -1,3 +1,5 @@
+import { safeTextTrim } from './text.mjs';
+import { installWindowHiddenScript } from './html.mjs';
 import { genFibonacciSeq } from './simpleMath.mjs';
 import { getHtmlElBorders } from './html.mjs';
 import { getHtmlElBordersWidth } from './html.mjs';
@@ -5,6 +7,8 @@ import { getHtmlElMargin } from './html.mjs';
 import { getHtmlElPadding } from './html.mjs';
 import { fetchJson } from './html.mjs';
 import { readJsonBlob } from './html.mjs';
+import { readFileBlob } from './html.mjs';
+import { readBase64Blob } from './html.mjs';
 import { saveJsonFile } from './html.mjs';
 import { documentIsFullScreen } from './fullScreen.mjs';
 import { isScreenFilled } from './fullScreen.mjs';
@@ -34,5 +38,5 @@ import { getTimeDuration } from './clock.mjs';
 import { shuffleArray } from './array.mjs';
 import { toTitleCase } from './text.mjs';
 import { toTitleCaseLowerFirst } from './text.mjs';
-export { genFibonacciSeq, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, fetchJson, readJsonBlob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
+export { safeTextTrim, installWindowHiddenScript, genFibonacciSeq, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, fetchJson, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
 //# sourceMappingURL=index.d.mts.map

package/dist/v1/basics/index.mjs

@@ -2,9 +2,9 @@ import arraySortPositions from '../../legacy/libs/arraySortPositions.mjs';
 import asyncReplace from '../../legacy/libs/replaceAsync.mjs';
 import { shuffleArray } from './array.mjs';
 import { formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration } from './clock.mjs';
-import { areHtmlElsColliding, readJsonBlob, saveJsonFile, fetchJson, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, } from './html.mjs';
+import { areHtmlElsColliding, readJsonBlob, saveJsonFile, fetchJson, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, installWindowHiddenScript, readFileBlob, readBase64Blob, } from './html.mjs';
 import { countObj, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, isJsonObject, } from './objFilter.mjs';
 import { documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, } from './fullScreen.mjs';
 import { formatBytes, genFibonacciSeq, getAge, getSimplePerc, ruleOfThree } from './simpleMath.mjs';
-import { addAiMarkerShortcut, toTitleCase, toTitleCaseLowerFirst } from './text.mjs';
-export { genFibonacciSeq, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, fetchJson, readJsonBlob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+import { addAiMarkerShortcut, safeTextTrim, toTitleCase, toTitleCaseLowerFirst } from './text.mjs';
+export { safeTextTrim, installWindowHiddenScript, genFibonacciSeq, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, fetchJson, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };