tiny-essentials 1.21.5 → 1.21.7

package/dist/v1/libs/TinyHtml.cjs

@@ -3906,7 +3906,8 @@ class TinyHtml {
    */
   static setBigInt(el, value) {
     if (typeof value !== 'bigint') throw new Error('Value is not a valid BigInt.');
-    TinyHtml._preElems(el, 'setBigInt').forEach((el) => (el.textContent = value.toString()));
+    const data = value.toString();
+    TinyHtml._preElems(el, 'setBigInt').forEach((el) => (el.textContent = data));
     return el;
   }
 
@@ -3949,7 +3950,8 @@ class TinyHtml {
   static setDate(el, value) {
     if (!(value instanceof Date) || Number.isNaN(value.getTime()))
       throw new Error('Value is not a valid Date.');
-    TinyHtml._preElems(el, 'setDate').forEach((el) => (el.textContent = value.toISOString()));
+    const data = value.toISOString();
+    TinyHtml._preElems(el, 'setDate').forEach((el) => (el.textContent = data));
     return el;
   }
 
@@ -3989,25 +3991,26 @@ class TinyHtml {
   /**
    * Set JSON content of elements.
    * @param {TinyElement|TinyElement[]} el
-   * @param {any} value
+   * @param {any} value - A JavaScript value, usually an object or array, to be converted.
+   * @param {(this: any, key: string, value: any) => any} [replacer] - A function that transforms the results.
    * @param {number|string} [space] - Indentation level or string for formatting.
    * @returns {TinyElement|TinyElement[]}
    */
-  static setJson(el, value, space) {
-    TinyHtml._preElems(el, 'setJson').forEach(
-      (el) => (el.textContent = JSON.stringify(value, null, space)),
-    );
+  static setJson(el, value, replacer, space) {
+    const data = JSON.stringify(value, replacer, space);
+    TinyHtml._preElems(el, 'setJson').forEach((el) => (el.textContent = data));
     return el;
   }
 
   /**
    * Set JSON content of the element.
-   * @param {any} value
+   * @param {any} value - A JavaScript value, usually an object or array, to be converted.
+   * @param {(this: any, key: string, value: any) => any} [replacer] - A function that transforms the results.
    * @param {number|string} [space] - Indentation level or string for formatting.
    * @returns {TinyElement|TinyElement[]}
    */
-  setJson(value, space) {
-    return TinyHtml.setJson(this, value, space);
+  setJson(value, replacer, space) {
+    return TinyHtml.setJson(this, value, replacer, space);
   }
 
   /**
@@ -4036,7 +4039,8 @@ class TinyHtml {
    */
   static setNumber(el, value) {
     if (typeof value !== 'number') throw new Error('Value is not a valid number.');
-    TinyHtml._preElems(el, 'setNumber').forEach((el) => (el.textContent = value.toString()));
+    const data = value.toString();
+    TinyHtml._preElems(el, 'setNumber').forEach((el) => (el.textContent = data));
     return el;
   }
 
@@ -4049,6 +4053,87 @@ class TinyHtml {
     return TinyHtml.setNumber(this, value);
   }
 
+  /**
+   * Returns the boolean content of the element.
+   * @param {TinyElement} el - Target element.
+   * @returns {boolean|null} The boolean value or null if empty.
+   */
+  static toBoolean(el) {
+    const elem = TinyHtml._preElem(el, 'toBoolean');
+    const txt = elem.textContent?.trim();
+    if (txt === undefined || txt === null || (txt !== 'true' && txt !== 'false')) return null;
+    return /^true$/i.test(txt);
+  }
+
+  /**
+   * Returns the boolean content of the element.
+   * @returns {boolean|null}
+   */
+  toBoolean() {
+    return TinyHtml.toBoolean(this);
+  }
+
+  /**
+   * Set boolean content of elements.
+   * @param {TinyElement|TinyElement[]} el
+   * @param {boolean} value
+   * @returns {TinyElement|TinyElement[]}
+   */
+  static setBoolean(el, value) {
+    if (typeof value !== 'boolean') throw new Error('Value is not a valid boolean.');
+    const data = value.toString();
+    TinyHtml._preElems(el, 'setBoolean').forEach((el) => (el.textContent = data));
+    return el;
+  }
+
+  /**
+   * Set boolean content of the element.
+   * @param {boolean} value
+   * @returns {TinyElement|TinyElement[]}
+   */
+  setBoolean(value) {
+    return TinyHtml.setBoolean(this, value);
+  }
+
+  /**
+   * Returns the string content of the element.
+   * @param {TinyElement} el - Target element.
+   * @returns {string|null} The string content or null if none.
+   */
+  static toString(el) {
+    const elem = TinyHtml._preElem(el, 'toString');
+    return typeof elem.textContent === 'string' ? elem.textContent : null;
+  }
+
+  /**
+   * Returns the string content of the element.
+   * @returns {string|null} The string content or null if none.
+   */
+  toString() {
+    return TinyHtml.toString(this);
+  }
+
+  /**
+   * Set string content of elements.
+   * @param {TinyElement|TinyElement[]} el
+   * @param {string} value
+   * @returns {TinyElement|TinyElement[]}
+   */
+  static setString(el, value) {
+    if (typeof value !== 'string') throw new Error('Value is not a valid string.');
+    TinyHtml._preElems(el, 'setString').forEach((el) => (el.textContent = value));
+    return el;
+  }
+
+  /**
+   * Set string content of the element.
+   * @param {string} value
+   * @returns {TinyElement|TinyElement[]}
+   */
+  setString(value) {
+    return TinyHtml.setString(this, value);
+  }
+
   /**
    * Returns the text content of the element.
    * @param {TinyElement} el - Target element.
@@ -4070,18 +4155,18 @@ class TinyHtml {
   /**
    * Set text content of elements.
    * @param {TinyElement|TinyElement[]} el
-   * @param {string} value
+   * @param {*} value
    * @returns {TinyElement|TinyElement[]}
    */
   static setText(el, value) {
-    if (typeof value !== 'string') throw new Error('Value is not a valid string.');
-    TinyHtml._preElems(el, 'setText').forEach((el) => (el.textContent = value));
+    const data = String(value);
+    TinyHtml._preElems(el, 'setText').forEach((el) => (el.textContent = data));
     return el;
   }
 
   /**
    * Set text content of the element.
-   * @param {string} value
+   * @param {*} value
    * @returns {TinyElement|TinyElement[]}
    */
   setText(value) {

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

@@ -1516,11 +1516,12 @@ declare class TinyHtml {
     /**
      * Set JSON content of elements.
      * @param {TinyElement|TinyElement[]} el
-     * @param {any} value
+     * @param {any} value - A JavaScript value, usually an object or array, to be converted.
+     * @param {(this: any, key: string, value: any) => any} [replacer] - A function that transforms the results.
      * @param {number|string} [space] - Indentation level or string for formatting.
      * @returns {TinyElement|TinyElement[]}
      */
-    static setJson(el: TinyElement | TinyElement[], value: any, space?: number | string): TinyElement | TinyElement[];
+    static setJson(el: TinyElement | TinyElement[], value: any, replacer?: (this: any, key: string, value: any) => any, space?: number | string): TinyElement | TinyElement[];
     /**
      * Returns the number content of the element.
      * @param {TinyElement} el - Target element.
@@ -1534,6 +1535,32 @@ declare class TinyHtml {
      * @returns {TinyElement|TinyElement[]}
      */
     static setNumber(el: TinyElement | TinyElement[], value: number): TinyElement | TinyElement[];
+    /**
+     * Returns the boolean content of the element.
+     * @param {TinyElement} el - Target element.
+     * @returns {boolean|null} The boolean value or null if empty.
+     */
+    static toBoolean(el: TinyElement): boolean | null;
+    /**
+     * Set boolean content of elements.
+     * @param {TinyElement|TinyElement[]} el
+     * @param {boolean} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    static setBoolean(el: TinyElement | TinyElement[], value: boolean): TinyElement | TinyElement[];
+    /**
+     * Returns the string content of the element.
+     * @param {TinyElement} el - Target element.
+     * @returns {string|null} The string content or null if none.
+     */
+    static toString(el: TinyElement): string | null;
+    /**
+     * Set string content of elements.
+     * @param {TinyElement|TinyElement[]} el
+     * @param {string} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    static setString(el: TinyElement | TinyElement[], value: string): TinyElement | TinyElement[];
     /**
      * Returns the text content of the element.
      * @param {TinyElement} el - Target element.
@@ -1543,10 +1570,10 @@ declare class TinyHtml {
     /**
      * Set text content of elements.
      * @param {TinyElement|TinyElement[]} el
-     * @param {string} value
+     * @param {*} value
      * @returns {TinyElement|TinyElement[]}
      */
-    static setText(el: TinyElement | TinyElement[], value: string): TinyElement | TinyElement[];
+    static setText(el: TinyElement | TinyElement[], value: any): TinyElement | TinyElement[];
     /**
      * Remove all child nodes from each element.
      * @param {TinyElement|TinyElement[]} el
@@ -2711,11 +2738,12 @@ declare class TinyHtml {
     toJson(): any | null;
     /**
      * Set JSON content of the element.
-     * @param {any} value
+     * @param {any} value - A JavaScript value, usually an object or array, to be converted.
+     * @param {(this: any, key: string, value: any) => any} [replacer] - A function that transforms the results.
      * @param {number|string} [space] - Indentation level or string for formatting.
      * @returns {TinyElement|TinyElement[]}
      */
-    setJson(value: any, space?: number | string): TinyElement | TinyElement[];
+    setJson(value: any, replacer?: (this: any, key: string, value: any) => any, space?: number | string): TinyElement | TinyElement[];
     /**
      * Returns the number content of the element.
      * @returns {number|null} The text content or null if none.
@@ -2727,6 +2755,28 @@ declare class TinyHtml {
      * @returns {TinyElement|TinyElement[]}
      */
     setNumber(value: number): TinyElement | TinyElement[];
+    /**
+     * Returns the boolean content of the element.
+     * @returns {boolean|null}
+     */
+    toBoolean(): boolean | null;
+    /**
+     * Set boolean content of the element.
+     * @param {boolean} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    setBoolean(value: boolean): TinyElement | TinyElement[];
+    /**
+     * Returns the string content of the element.
+     * @returns {string|null} The string content or null if none.
+     */
+    toString(): string | null;
+    /**
+     * Set string content of the element.
+     * @param {string} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    setString(value: string): TinyElement | TinyElement[];
     /**
      * Returns the text content of the element.
      * @returns {string|null} The text content or null if none.
@@ -2734,10 +2784,10 @@ declare class TinyHtml {
     text(): string | null;
     /**
      * Set text content of the element.
-     * @param {string} value
+     * @param {*} value
      * @returns {TinyElement|TinyElement[]}
      */
-    setText(value: string): TinyElement | TinyElement[];
+    setText(value: any): TinyElement | TinyElement[];
     /**
      * Remove all child nodes of the element.
      * @returns {TinyElement|TinyElement[]}

package/dist/v1/libs/TinyHtml.mjs

@@ -3499,7 +3499,8 @@ class TinyHtml {
     static setBigInt(el, value) {
         if (typeof value !== 'bigint')
             throw new Error('Value is not a valid BigInt.');
-        TinyHtml._preElems(el, 'setBigInt').forEach((el) => (el.textContent = value.toString()));
+        const data = value.toString();
+        TinyHtml._preElems(el, 'setBigInt').forEach((el) => (el.textContent = data));
         return el;
     }
     /**
@@ -3539,7 +3540,8 @@ class TinyHtml {
     static setDate(el, value) {
         if (!(value instanceof Date) || Number.isNaN(value.getTime()))
             throw new Error('Value is not a valid Date.');
-        TinyHtml._preElems(el, 'setDate').forEach((el) => (el.textContent = value.toISOString()));
+        const data = value.toISOString();
+        TinyHtml._preElems(el, 'setDate').forEach((el) => (el.textContent = data));
         return el;
     }
     /**
@@ -3577,22 +3579,25 @@ class TinyHtml {
     /**
      * Set JSON content of elements.
      * @param {TinyElement|TinyElement[]} el
-     * @param {any} value
+     * @param {any} value - A JavaScript value, usually an object or array, to be converted.
+     * @param {(this: any, key: string, value: any) => any} [replacer] - A function that transforms the results.
      * @param {number|string} [space] - Indentation level or string for formatting.
      * @returns {TinyElement|TinyElement[]}
      */
-    static setJson(el, value, space) {
-        TinyHtml._preElems(el, 'setJson').forEach((el) => (el.textContent = JSON.stringify(value, null, space)));
+    static setJson(el, value, replacer, space) {
+        const data = JSON.stringify(value, replacer, space);
+        TinyHtml._preElems(el, 'setJson').forEach((el) => (el.textContent = data));
         return el;
     }
     /**
      * Set JSON content of the element.
-     * @param {any} value
+     * @param {any} value - A JavaScript value, usually an object or array, to be converted.
+     * @param {(this: any, key: string, value: any) => any} [replacer] - A function that transforms the results.
      * @param {number|string} [space] - Indentation level or string for formatting.
      * @returns {TinyElement|TinyElement[]}
      */
-    setJson(value, space) {
-        return TinyHtml.setJson(this, value, space);
+    setJson(value, replacer, space) {
+        return TinyHtml.setJson(this, value, replacer, space);
     }
     /**
      * Returns the number content of the element.
@@ -3619,7 +3624,8 @@ class TinyHtml {
     static setNumber(el, value) {
         if (typeof value !== 'number')
             throw new Error('Value is not a valid number.');
-        TinyHtml._preElems(el, 'setNumber').forEach((el) => (el.textContent = value.toString()));
+        const data = value.toString();
+        TinyHtml._preElems(el, 'setNumber').forEach((el) => (el.textContent = data));
         return el;
     }
     /**
@@ -3630,6 +3636,82 @@ class TinyHtml {
     setNumber(value) {
         return TinyHtml.setNumber(this, value);
     }
+    /**
+     * Returns the boolean content of the element.
+     * @param {TinyElement} el - Target element.
+     * @returns {boolean|null} The boolean value or null if empty.
+     */
+    static toBoolean(el) {
+        const elem = TinyHtml._preElem(el, 'toBoolean');
+        const txt = elem.textContent?.trim();
+        if (txt === undefined || txt === null || (txt !== 'true' && txt !== 'false'))
+            return null;
+        return /^true$/i.test(txt);
+    }
+    /**
+     * Returns the boolean content of the element.
+     * @returns {boolean|null}
+     */
+    toBoolean() {
+        return TinyHtml.toBoolean(this);
+    }
+    /**
+     * Set boolean content of elements.
+     * @param {TinyElement|TinyElement[]} el
+     * @param {boolean} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    static setBoolean(el, value) {
+        if (typeof value !== 'boolean')
+            throw new Error('Value is not a valid boolean.');
+        const data = value.toString();
+        TinyHtml._preElems(el, 'setBoolean').forEach((el) => (el.textContent = data));
+        return el;
+    }
+    /**
+     * Set boolean content of the element.
+     * @param {boolean} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    setBoolean(value) {
+        return TinyHtml.setBoolean(this, value);
+    }
+    /**
+     * Returns the string content of the element.
+     * @param {TinyElement} el - Target element.
+     * @returns {string|null} The string content or null if none.
+     */
+    static toString(el) {
+        const elem = TinyHtml._preElem(el, 'toString');
+        return typeof elem.textContent === 'string' ? elem.textContent : null;
+    }
+    /**
+     * Returns the string content of the element.
+     * @returns {string|null} The string content or null if none.
+     */
+    toString() {
+        return TinyHtml.toString(this);
+    }
+    /**
+     * Set string content of elements.
+     * @param {TinyElement|TinyElement[]} el
+     * @param {string} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    static setString(el, value) {
+        if (typeof value !== 'string')
+            throw new Error('Value is not a valid string.');
+        TinyHtml._preElems(el, 'setString').forEach((el) => (el.textContent = value));
+        return el;
+    }
+    /**
+     * Set string content of the element.
+     * @param {string} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    setString(value) {
+        return TinyHtml.setString(this, value);
+    }
     /**
      * Returns the text content of the element.
      * @param {TinyElement} el - Target element.
@@ -3649,18 +3731,17 @@ class TinyHtml {
     /**
      * Set text content of elements.
      * @param {TinyElement|TinyElement[]} el
-     * @param {string} value
+     * @param {*} value
      * @returns {TinyElement|TinyElement[]}
      */
     static setText(el, value) {
-        if (typeof value !== 'string')
-            throw new Error('Value is not a valid string.');
-        TinyHtml._preElems(el, 'setText').forEach((el) => (el.textContent = value));
+        const data = String(value);
+        TinyHtml._preElems(el, 'setText').forEach((el) => (el.textContent = data));
         return el;
     }
     /**
      * Set text content of the element.
-     * @param {string} value
+     * @param {*} value
      * @returns {TinyElement|TinyElement[]}
      */
     setText(value) {

package/docs/v1/libs/TinyHtml.md

@@ -1378,15 +1378,13 @@ element.toJson(); // → { a: 1, b: 2 }
 
 ---
 
-### ✍️ `.setJson(value, space)` / `TinyHtml.setJson(el, value, space)`
+### ✍️ `.setJson(value, replacer, space)` / `TinyHtml.setJson(el, value, replacer, space)`
 
 Sets the **JSON** content of one or more elements.
-`space` is optional and can be a number or string for indentation.
 
 ```js
 element.setJson({ a: 1, b: 2 });          // minified
-element.setJson({ a: 1, b: 2 }, 2);       // 2-space indentation
-element.setJson({ a: 1, b: 2 }, "\t");    // tab indentation
+element.setJson({ a: 1, b: 2 }, null, 2);       // 2-space indentation
 ```
 
 ---
@@ -1411,6 +1409,50 @@ element.setNumber(99);
 
 ---
 
+### 📝 `.toBoolean()` / `TinyHtml.toBoolean(el)`
+
+Gets the **boolean** content of the element.
+Returns `true` if the text is `"true"`, `false` if `"false"`, and `null` if empty or invalid.
+
+```js
+element.toBoolean(); // → true | false | null
+```
+
+---
+
+### ✍️ `.setBoolean(value)` / `TinyHtml.setBoolean(el, value)`
+
+Sets the **boolean** content of one or more elements.
+Throws if `value` is not a boolean.
+
+```js
+element.setBoolean(true);  // sets content to "true"
+element.setBoolean(false); // sets content to "false"
+```
+
+---
+
+### 📝 `.toString()` / `TinyHtml.toString(el)`
+
+Gets the **string** content of the element (returns `null` if none).
+
+```js
+element.toString(); // → "Hello world"
+```
+
+---
+
+### ✍️ `.setString(value)` / `TinyHtml.setString(el, value)`
+
+Sets the **string** content of one or more elements.
+Throws if `value` is not a string.
+
+```js
+element.setString("New text content");
+```
+
+---
+
 ### 📝 `.text()` / `TinyHtml.text(el)`
 
 Gets the text content of the element (returns `null` if none).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-essentials",
-  "version": "1.21.5",
+  "version": "1.21.7",
   "description": "Collection of small, essential scripts designed to be used across various projects. These simple utilities are crafted for speed, ease of use, and versatility.",
   "scripts": {
     "test": "npm run test:mjs && npm run test:cjs && npm run test:js",