tiny-essentials 1.21.6 → 1.21.7

package/dist/v1/libs/TinyHtml.cjs

@@ -4053,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.
@@ -4074,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

@@ -1535,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.
@@ -1544,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
@@ -2729,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.
@@ -2736,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

@@ -3636,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.
@@ -3655,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

@@ -1409,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.6",
+  "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",