tiny-essentials 1.21.4 → 1.21.5

package/dist/v1/libs/TinyHtml.cjs

@@ -3873,6 +3873,182 @@ class TinyHtml {
     return TinyHtml.id(this);
   }
 
+  /**
+   * Returns the BigInt content of the element.
+   * @param {TinyElement} el - Target element.
+   * @returns {bigint|null} The BigInt content or null if none.
+   */
+  static toBigInt(el) {
+    const elem = TinyHtml._preElem(el, 'toBigInt');
+    const txt = elem.textContent?.trim();
+    let value = null;
+    try {
+      value = BigInt(txt ?? '');
+    } catch {
+      value = null;
+    }
+    return value;
+  }
+
+  /**
+   * Returns the BigInt content of the element.
+   * @returns {bigint|null}
+   */
+  toBigInt() {
+    return TinyHtml.toBigInt(this);
+  }
+
+  /**
+   * Set BigInt content of elements.
+   * @param {TinyElement|TinyElement[]} el
+   * @param {bigint} value
+   * @returns {TinyElement|TinyElement[]}
+   */
+  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()));
+    return el;
+  }
+
+  /**
+   * Set BigInt content of the element.
+   * @param {bigint} value
+   * @returns {TinyElement|TinyElement[]}
+   */
+  setBigInt(value) {
+    return TinyHtml.setBigInt(this, value);
+  }
+
+  /**
+   * Returns the Date content of the element.
+   * @param {TinyElement} el - Target element.
+   * @returns {Date|null} The Date content or null if invalid.
+   */
+  static toDate(el) {
+    const elem = TinyHtml._preElem(el, 'toDate');
+    const txt = elem.textContent?.trim();
+    if (!txt) return null;
+    const d = new Date(txt);
+    return Number.isNaN(d.getTime()) ? null : d;
+  }
+
+  /**
+   * Returns the Date content of the element.
+   * @returns {Date|null}
+   */
+  toDate() {
+    return TinyHtml.toDate(this);
+  }
+
+  /**
+   * Set Date content of elements.
+   * @param {TinyElement|TinyElement[]} el
+   * @param {Date} value
+   * @returns {TinyElement|TinyElement[]}
+   */
+  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()));
+    return el;
+  }
+
+  /**
+   * Set Date content of the element.
+   * @param {Date} value
+   * @returns {TinyElement|TinyElement[]}
+   */
+  setDate(value) {
+    return TinyHtml.setDate(this, value);
+  }
+
+  /**
+   * Returns the JSON content of the element.
+   * @param {TinyElement} el - Target element.
+   * @returns {any|null} The parsed JSON content or null if invalid.
+   */
+  static toJson(el) {
+    const elem = TinyHtml._preElem(el, 'toJson');
+    const txt = elem.textContent?.trim();
+    if (!txt) return null;
+    try {
+      return JSON.parse(txt);
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * Returns the JSON content of the element.
+   * @returns {any|null}
+   */
+  toJson() {
+    return TinyHtml.toJson(this);
+  }
+
+  /**
+   * Set JSON content of elements.
+   * @param {TinyElement|TinyElement[]} el
+   * @param {any} value
+   * @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)),
+    );
+    return el;
+  }
+
+  /**
+   * Set JSON content of the element.
+   * @param {any} value
+   * @param {number|string} [space] - Indentation level or string for formatting.
+   * @returns {TinyElement|TinyElement[]}
+   */
+  setJson(value, space) {
+    return TinyHtml.setJson(this, value, space);
+  }
+
+  /**
+   * Returns the number content of the element.
+   * @param {TinyElement} el - Target element.
+   * @returns {number|null} The text content or null if none.
+   */
+  static toNumber(el) {
+    const elem = TinyHtml._preElem(el, 'toNumber');
+    return typeof elem.textContent === 'string' ? parseFloat(elem.textContent.trim()) : null;
+  }
+
+  /**
+   * Returns the number content of the element.
+   * @returns {number|null} The text content or null if none.
+   */
+  toNumber() {
+    return TinyHtml.toNumber(this);
+  }
+
+  /**
+   * Set number content of elements.
+   * @param {TinyElement|TinyElement[]} el
+   * @param {number} value
+   * @returns {TinyElement|TinyElement[]}
+   */
+  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()));
+    return el;
+  }
+
+  /**
+   * Set number content of the element.
+   * @param {number} value
+   * @returns {TinyElement|TinyElement[]}
+   */
+  setNumber(value) {
+    return TinyHtml.setNumber(this, value);
+  }
+
   /**
    * Returns the text content of the element.
    * @param {TinyElement} el - Target element.

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

@@ -1481,6 +1481,59 @@ declare class TinyHtml {
      * @returns {string} The element's ID.
      */
     static id(el: TinyElement): string;
+    /**
+     * Returns the BigInt content of the element.
+     * @param {TinyElement} el - Target element.
+     * @returns {bigint|null} The BigInt content or null if none.
+     */
+    static toBigInt(el: TinyElement): bigint | null;
+    /**
+     * Set BigInt content of elements.
+     * @param {TinyElement|TinyElement[]} el
+     * @param {bigint} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    static setBigInt(el: TinyElement | TinyElement[], value: bigint): TinyElement | TinyElement[];
+    /**
+     * Returns the Date content of the element.
+     * @param {TinyElement} el - Target element.
+     * @returns {Date|null} The Date content or null if invalid.
+     */
+    static toDate(el: TinyElement): Date | null;
+    /**
+     * Set Date content of elements.
+     * @param {TinyElement|TinyElement[]} el
+     * @param {Date} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    static setDate(el: TinyElement | TinyElement[], value: Date): TinyElement | TinyElement[];
+    /**
+     * Returns the JSON content of the element.
+     * @param {TinyElement} el - Target element.
+     * @returns {any|null} The parsed JSON content or null if invalid.
+     */
+    static toJson(el: TinyElement): any | null;
+    /**
+     * Set JSON content of elements.
+     * @param {TinyElement|TinyElement[]} el
+     * @param {any} value
+     * @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[];
+    /**
+     * Returns the number content of the element.
+     * @param {TinyElement} el - Target element.
+     * @returns {number|null} The text content or null if none.
+     */
+    static toNumber(el: TinyElement): number | null;
+    /**
+     * Set number content of elements.
+     * @param {TinyElement|TinyElement[]} el
+     * @param {number} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    static setNumber(el: TinyElement | TinyElement[], value: number): TinyElement | TinyElement[];
     /**
      * Returns the text content of the element.
      * @param {TinyElement} el - Target element.
@@ -2629,6 +2682,51 @@ declare class TinyHtml {
      * @returns {string} The element's ID.
      */
     id(): string;
+    /**
+     * Returns the BigInt content of the element.
+     * @returns {bigint|null}
+     */
+    toBigInt(): bigint | null;
+    /**
+     * Set BigInt content of the element.
+     * @param {bigint} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    setBigInt(value: bigint): TinyElement | TinyElement[];
+    /**
+     * Returns the Date content of the element.
+     * @returns {Date|null}
+     */
+    toDate(): Date | null;
+    /**
+     * Set Date content of the element.
+     * @param {Date} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    setDate(value: Date): TinyElement | TinyElement[];
+    /**
+     * Returns the JSON content of the element.
+     * @returns {any|null}
+     */
+    toJson(): any | null;
+    /**
+     * Set JSON content of the element.
+     * @param {any} value
+     * @param {number|string} [space] - Indentation level or string for formatting.
+     * @returns {TinyElement|TinyElement[]}
+     */
+    setJson(value: any, space?: number | string): TinyElement | TinyElement[];
+    /**
+     * Returns the number content of the element.
+     * @returns {number|null} The text content or null if none.
+     */
+    toNumber(): number | null;
+    /**
+     * Set number content of the element.
+     * @param {number} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    setNumber(value: number): TinyElement | TinyElement[];
     /**
      * Returns the text content of the element.
      * @returns {string|null} The text content or null if none.

package/dist/v1/libs/TinyHtml.mjs

@@ -3466,6 +3466,170 @@ class TinyHtml {
     id() {
         return TinyHtml.id(this);
     }
+    /**
+     * Returns the BigInt content of the element.
+     * @param {TinyElement} el - Target element.
+     * @returns {bigint|null} The BigInt content or null if none.
+     */
+    static toBigInt(el) {
+        const elem = TinyHtml._preElem(el, 'toBigInt');
+        const txt = elem.textContent?.trim();
+        let value = null;
+        try {
+            value = BigInt(txt ?? '');
+        }
+        catch {
+            value = null;
+        }
+        return value;
+    }
+    /**
+     * Returns the BigInt content of the element.
+     * @returns {bigint|null}
+     */
+    toBigInt() {
+        return TinyHtml.toBigInt(this);
+    }
+    /**
+     * Set BigInt content of elements.
+     * @param {TinyElement|TinyElement[]} el
+     * @param {bigint} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    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()));
+        return el;
+    }
+    /**
+     * Set BigInt content of the element.
+     * @param {bigint} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    setBigInt(value) {
+        return TinyHtml.setBigInt(this, value);
+    }
+    /**
+     * Returns the Date content of the element.
+     * @param {TinyElement} el - Target element.
+     * @returns {Date|null} The Date content or null if invalid.
+     */
+    static toDate(el) {
+        const elem = TinyHtml._preElem(el, 'toDate');
+        const txt = elem.textContent?.trim();
+        if (!txt)
+            return null;
+        const d = new Date(txt);
+        return Number.isNaN(d.getTime()) ? null : d;
+    }
+    /**
+     * Returns the Date content of the element.
+     * @returns {Date|null}
+     */
+    toDate() {
+        return TinyHtml.toDate(this);
+    }
+    /**
+     * Set Date content of elements.
+     * @param {TinyElement|TinyElement[]} el
+     * @param {Date} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    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()));
+        return el;
+    }
+    /**
+     * Set Date content of the element.
+     * @param {Date} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    setDate(value) {
+        return TinyHtml.setDate(this, value);
+    }
+    /**
+     * Returns the JSON content of the element.
+     * @param {TinyElement} el - Target element.
+     * @returns {any|null} The parsed JSON content or null if invalid.
+     */
+    static toJson(el) {
+        const elem = TinyHtml._preElem(el, 'toJson');
+        const txt = elem.textContent?.trim();
+        if (!txt)
+            return null;
+        try {
+            return JSON.parse(txt);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Returns the JSON content of the element.
+     * @returns {any|null}
+     */
+    toJson() {
+        return TinyHtml.toJson(this);
+    }
+    /**
+     * Set JSON content of elements.
+     * @param {TinyElement|TinyElement[]} el
+     * @param {any} value
+     * @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)));
+        return el;
+    }
+    /**
+     * Set JSON content of the element.
+     * @param {any} value
+     * @param {number|string} [space] - Indentation level or string for formatting.
+     * @returns {TinyElement|TinyElement[]}
+     */
+    setJson(value, space) {
+        return TinyHtml.setJson(this, value, space);
+    }
+    /**
+     * Returns the number content of the element.
+     * @param {TinyElement} el - Target element.
+     * @returns {number|null} The text content or null if none.
+     */
+    static toNumber(el) {
+        const elem = TinyHtml._preElem(el, 'toNumber');
+        return typeof elem.textContent === 'string' ? parseFloat(elem.textContent.trim()) : null;
+    }
+    /**
+     * Returns the number content of the element.
+     * @returns {number|null} The text content or null if none.
+     */
+    toNumber() {
+        return TinyHtml.toNumber(this);
+    }
+    /**
+     * Set number content of elements.
+     * @param {TinyElement|TinyElement[]} el
+     * @param {number} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    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()));
+        return el;
+    }
+    /**
+     * Set number content of the element.
+     * @param {number} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    setNumber(value) {
+        return TinyHtml.setNumber(this, value);
+    }
     /**
      * Returns the text content of the element.
      * @param {TinyElement} el - Target element.

package/docs/v1/libs/TinyHtml.md

@@ -1328,6 +1328,89 @@ element.id(); // → "my-element-id"
 
 ---
 
+### 📝 `.toBigInt()` / `TinyHtml.toBigInt(el)`
+
+Gets the **BigInt** content of the element (returns `null` if invalid or empty).
+
+```js
+element.toBigInt(); // → 123n
+```
+
+---
+
+### ✍️ `.setBigInt(value)` / `TinyHtml.setBigInt(el, value)`
+
+Sets the **BigInt** content of one or more elements. Throws if `value` is not a BigInt.
+
+```js
+element.setBigInt(456n);
+```
+
+---
+
+### 📝 `.toDate()` / `TinyHtml.toDate(el)`
+
+Gets the **Date** content of the element (returns `null` if invalid).
+
+```js
+element.toDate(); // → 2025-08-31T00:00:00.000Z
+```
+
+---
+
+### ✍️ `.setDate(value)` / `TinyHtml.setDate(el, value)`
+
+Sets the **Date** content of one or more elements. Throws if `value` is not a valid `Date`.
+
+```js
+element.setDate(new Date("2025-08-31T00:00:00Z"));
+```
+
+---
+
+### 📝 `.toJson()` / `TinyHtml.toJson(el)`
+
+Gets the **JSON** content of the element (returns `null` if invalid or empty).
+
+```js
+element.toJson(); // → { a: 1, b: 2 }
+```
+
+---
+
+### ✍️ `.setJson(value, space)` / `TinyHtml.setJson(el, value, 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
+```
+
+---
+
+### 📝 `.toNumber()` / `TinyHtml.toNumber(el)`
+
+Gets the **number** content of the element (returns `null` if invalid or empty).
+
+```js
+element.toNumber(); // → 42
+```
+
+---
+
+### ✍️ `.setNumber(value)` / `TinyHtml.setNumber(el, value)`
+
+Sets the **number** content of one or more elements. Throws if `value` is not a number.
+
+```js
+element.setNumber(99);
+```
+
+---
+
 ### 📝 `.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.4",
+  "version": "1.21.5",
   "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",