tiny-essentials 1.28.1 → 1.28.3

package/dist/v1/libs/TinyHtml/input/date/TinyHtmlDateInput.cjs

@@ -2,6 +2,22 @@
 
 var TinyHtmlInput = require('../../TinyHtmlInput.cjs');
 
+/**
+ * Validator to ensure the correct HTML5 date format (YYYY-MM-DD) and whether it is a real date.
+ * @param {string} str
+ * @returns {boolean}
+ */
+const isValidDateString = (str) => {
+  if (typeof str !== 'string') return false;
+  if (str.length < 1) return true;
+  const dateRegex = /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/;
+  if (!dateRegex.test(str)) return false;
+
+  // Checks if the date is real in the calendar (e.g. blocks 2025-02-30)
+  const date = new Date(str);
+  return !Number.isNaN(date.getTime()) && date.toISOString().slice(0, 10) === str;
+};
+
 /**
  * TinyHtmlDateInput is a helper class for managing `<input type="date">` elements.
  * It provides validation and safe access to standard attributes such as `value`, `min`, `max`, `step`,
@@ -17,13 +33,28 @@ var TinyHtmlInput = require('../../TinyHtmlInput.cjs');
  * });
  */
 class TinyHtmlDateInput extends TinyHtmlInput {
+  /**
+   * Convert a Date to Date String.
+   * @param {Date} value
+   * @returns {string}
+   */
+  static dateToString(value) {
+    if (!(value instanceof Date)) throw new TypeError('TinyHtmlDateInput: "value" must be a date.');
+
+    const year = value.getFullYear();
+    const month = String(value.getMonth() + 1).padStart(2, '0');
+    const day = String(value.getDate()).padStart(2, '0');
+
+    return `${year}-${month}-${day}`;
+  }
+
   /**
    * Creates a new TinyHtmlDateInput instance.
    * @param {Object} config - Configuration object.
    * @param {string} [config.value] - Initial date value in `YYYY-MM-DD` format.
    * @param {string} [config.min] - Minimum allowed date (in `YYYY-MM-DD` format).
    * @param {string} [config.max] - Maximum allowed date (in `YYYY-MM-DD` format).
-   * @param {number|string} [config.step] - Step value in days (number) or "any".
+   * @param {number|'any'} [config.step] - Step value in days (number) or "any".
    * @param {string} [config.name] - The name of the input.
    * @param {string} [config.placeholder] - Placeholder text.
    * @param {string} [config.autocomplete] - Autocomplete hint (e.g., "on", "off", "bday").
@@ -61,33 +92,26 @@ class TinyHtmlDateInput extends TinyHtmlInput {
     this.required = required;
   }
 
-  /** @param {string|Date} value */
+  /** @param {string} value */
   set value(value) {
-    if (typeof value !== 'string' && !(value instanceof Date))
+    if (!isValidDateString(value))
       throw new TypeError(
-        'TinyHtmlDateInput: "value" must be a string in YYYY-MM-DD format or date.',
+        'TinyHtmlDateInput: "value" must be a valid real date string in YYYY-MM-DD format.',
       );
-    if (value instanceof Date) {
-      const year = value.getFullYear();
-      const month = String(value.getMonth() + 1).padStart(2, '0');
-      const day = String(value.getDate()).padStart(2, '0');
-
-      const formatted = `${year}-${month}-${day}`;
-      this.setVal(formatted);
-      return;
-    }
     this.setVal(value);
   }
 
   /** @returns {string|null} */
   get value() {
-    return this.attrString('value');
+    return this.valTxt();
   }
 
   /** @param {string} min */
   set min(min) {
-    if (typeof min !== 'string')
-      throw new TypeError('TinyHtmlDateInput: "min" must be a string in YYYY-MM-DD format.');
+    if (!isValidDateString(min))
+      throw new TypeError(
+        'TinyHtmlDateInput: "min" must be a valid real date string in YYYY-MM-DD format.',
+      );
     this.setAttr('min', min);
   }
 
@@ -98,8 +122,10 @@ class TinyHtmlDateInput extends TinyHtmlInput {
 
   /** @param {string} max */
   set max(max) {
-    if (typeof max !== 'string')
-      throw new TypeError('TinyHtmlDateInput: "max" must be a string in YYYY-MM-DD format.');
+    if (!isValidDateString(max))
+      throw new TypeError(
+        'TinyHtmlDateInput: "max" must be a valid real date string in YYYY-MM-DD format.',
+      );
     this.setAttr('max', max);
   }
 
@@ -108,16 +134,18 @@ class TinyHtmlDateInput extends TinyHtmlInput {
     return this.attrString('max');
   }
 
-  /** @param {number|string} step */
+  /** @param {number|'any'} step */
   set step(step) {
     if (!(typeof step === 'number' && step > 0) && step !== 'any')
       throw new TypeError('TinyHtmlDateInput: "step" must be a positive number or "any".');
     this.setAttr('step', step);
   }
 
-  /** @returns {string|null} */
+  /** @returns {number|'any'|null} */
   get step() {
-    return this.attrString('step');
+    const value = this.attrString('step');
+    if (value === null || value === 'any') return value;
+    return parseFloat(value);
   }
 
   /** @param {string} name */

package/dist/v1/libs/TinyHtml/input/date/TinyHtmlDateInput.d.mts

@@ -1,4 +1,4 @@
-export default TinyHtmlDateInput;
+import TinyHtmlInput from '../../TinyHtmlInput.mjs';
 /**
  * TinyHtmlDateInput is a helper class for managing `<input type="date">` elements.
  * It provides validation and safe access to standard attributes such as `value`, `min`, `max`, `step`,
@@ -14,13 +14,19 @@ export default TinyHtmlDateInput;
  * });
  */
 declare class TinyHtmlDateInput extends TinyHtmlInput {
+    /**
+     * Convert a Date to Date String.
+     * @param {Date} value
+     * @returns {string}
+     */
+    static dateToString(value: Date): string;
     /**
      * Creates a new TinyHtmlDateInput instance.
      * @param {Object} config - Configuration object.
      * @param {string} [config.value] - Initial date value in `YYYY-MM-DD` format.
      * @param {string} [config.min] - Minimum allowed date (in `YYYY-MM-DD` format).
      * @param {string} [config.max] - Maximum allowed date (in `YYYY-MM-DD` format).
-     * @param {number|string} [config.step] - Step value in days (number) or "any".
+     * @param {number|'any'} [config.step] - Step value in days (number) or "any".
      * @param {string} [config.name] - The name of the input.
      * @param {string} [config.placeholder] - Placeholder text.
      * @param {string} [config.autocomplete] - Autocomplete hint (e.g., "on", "off", "bday").
@@ -32,21 +38,21 @@ declare class TinyHtmlDateInput extends TinyHtmlInput {
      * @throws {TypeError} If any attribute is of the wrong type.
      */
     constructor({ value, min, max, step, name, placeholder, autocomplete, list, readonly, required, tags, mainClass, }?: {
-        value?: string | undefined;
-        min?: string | undefined;
-        max?: string | undefined;
-        step?: string | number | undefined;
-        name?: string | undefined;
-        placeholder?: string | undefined;
-        autocomplete?: string | undefined;
-        list?: string | undefined;
-        readonly?: boolean | undefined;
-        required?: boolean | undefined;
-        tags?: string | string[] | Set<string> | undefined;
-        mainClass?: string | undefined;
+        value?: string;
+        min?: string;
+        max?: string;
+        step?: number | 'any';
+        name?: string;
+        placeholder?: string;
+        autocomplete?: string;
+        list?: string;
+        readonly?: boolean;
+        required?: boolean;
+        tags?: string | string[] | Set<string>;
+        mainClass?: string;
     });
-    /** @param {string|Date} value */
-    set value(value: string | Date);
+    /** @param {string} value */
+    set value(value: string);
     /** @returns {string|null} */
     get value(): string | null;
     /** @param {string} min */
@@ -57,10 +63,18 @@ declare class TinyHtmlDateInput extends TinyHtmlInput {
     set max(max: string);
     /** @returns {string|null} */
     get max(): string | null;
-    /** @param {number|string} step */
-    set step(step: number | string);
+    /** @param {number|'any'} step */
+    set step(step: number | 'any');
+    /** @returns {number|'any'|null} */
+    get step(): number | 'any' | null;
+    /** @param {string} name */
+    set name(name: string);
     /** @returns {string|null} */
-    get step(): string | null;
+    get name(): string | null;
+    /** @param {string} placeholder */
+    set placeholder(placeholder: string);
+    /** @returns {string|null} */
+    get placeholder(): string | null;
     /** @param {string} autocomplete */
     set autocomplete(autocomplete: string);
     /** @returns {string|null} */
@@ -70,5 +84,5 @@ declare class TinyHtmlDateInput extends TinyHtmlInput {
     /** @returns {string|null} */
     get list(): string | null;
 }
-import TinyHtmlInput from '../../TinyHtmlInput.mjs';
+export default TinyHtmlDateInput;
 //# sourceMappingURL=TinyHtmlDateInput.d.mts.map

package/dist/v1/libs/TinyHtml/input/date/TinyHtmlDateInput.mjs

@@ -1,4 +1,21 @@
 import TinyHtmlInput from '../../TinyHtmlInput.mjs';
+/**
+ * Validator to ensure the correct HTML5 date format (YYYY-MM-DD) and whether it is a real date.
+ * @param {string} str
+ * @returns {boolean}
+ */
+const isValidDateString = (str) => {
+    if (typeof str !== 'string')
+        return false;
+    if (str.length < 1)
+        return true;
+    const dateRegex = /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/;
+    if (!dateRegex.test(str))
+        return false;
+    // Checks if the date is real in the calendar (e.g. blocks 2025-02-30)
+    const date = new Date(str);
+    return !Number.isNaN(date.getTime()) && date.toISOString().slice(0, 10) === str;
+};
 /**
  * TinyHtmlDateInput is a helper class for managing `<input type="date">` elements.
  * It provides validation and safe access to standard attributes such as `value`, `min`, `max`, `step`,
@@ -14,13 +31,26 @@ import TinyHtmlInput from '../../TinyHtmlInput.mjs';
  * });
  */
 class TinyHtmlDateInput extends TinyHtmlInput {
+    /**
+     * Convert a Date to Date String.
+     * @param {Date} value
+     * @returns {string}
+     */
+    static dateToString(value) {
+        if (!(value instanceof Date))
+            throw new TypeError('TinyHtmlDateInput: "value" must be a date.');
+        const year = value.getFullYear();
+        const month = String(value.getMonth() + 1).padStart(2, '0');
+        const day = String(value.getDate()).padStart(2, '0');
+        return `${year}-${month}-${day}`;
+    }
     /**
      * Creates a new TinyHtmlDateInput instance.
      * @param {Object} config - Configuration object.
      * @param {string} [config.value] - Initial date value in `YYYY-MM-DD` format.
      * @param {string} [config.min] - Minimum allowed date (in `YYYY-MM-DD` format).
      * @param {string} [config.max] - Maximum allowed date (in `YYYY-MM-DD` format).
-     * @param {number|string} [config.step] - Step value in days (number) or "any".
+     * @param {number|'any'} [config.step] - Step value in days (number) or "any".
      * @param {string} [config.name] - The name of the input.
      * @param {string} [config.placeholder] - Placeholder text.
      * @param {string} [config.autocomplete] - Autocomplete hint (e.g., "on", "off", "bday").
@@ -48,28 +78,20 @@ class TinyHtmlDateInput extends TinyHtmlInput {
         this.readonly = readonly;
         this.required = required;
     }
-    /** @param {string|Date} value */
+    /** @param {string} value */
     set value(value) {
-        if (typeof value !== 'string' && !(value instanceof Date))
-            throw new TypeError('TinyHtmlDateInput: "value" must be a string in YYYY-MM-DD format or date.');
-        if (value instanceof Date) {
-            const year = value.getFullYear();
-            const month = String(value.getMonth() + 1).padStart(2, '0');
-            const day = String(value.getDate()).padStart(2, '0');
-            const formatted = `${year}-${month}-${day}`;
-            this.setVal(formatted);
-            return;
-        }
+        if (!isValidDateString(value))
+            throw new TypeError('TinyHtmlDateInput: "value" must be a valid real date string in YYYY-MM-DD format.');
         this.setVal(value);
     }
     /** @returns {string|null} */
     get value() {
-        return this.attrString('value');
+        return this.valTxt();
     }
     /** @param {string} min */
     set min(min) {
-        if (typeof min !== 'string')
-            throw new TypeError('TinyHtmlDateInput: "min" must be a string in YYYY-MM-DD format.');
+        if (!isValidDateString(min))
+            throw new TypeError('TinyHtmlDateInput: "min" must be a valid real date string in YYYY-MM-DD format.');
         this.setAttr('min', min);
     }
     /** @returns {string|null} */
@@ -78,23 +100,26 @@ class TinyHtmlDateInput extends TinyHtmlInput {
     }
     /** @param {string} max */
     set max(max) {
-        if (typeof max !== 'string')
-            throw new TypeError('TinyHtmlDateInput: "max" must be a string in YYYY-MM-DD format.');
+        if (!isValidDateString(max))
+            throw new TypeError('TinyHtmlDateInput: "max" must be a valid real date string in YYYY-MM-DD format.');
         this.setAttr('max', max);
     }
     /** @returns {string|null} */
     get max() {
         return this.attrString('max');
     }
-    /** @param {number|string} step */
+    /** @param {number|'any'} step */
     set step(step) {
         if (!(typeof step === 'number' && step > 0) && step !== 'any')
             throw new TypeError('TinyHtmlDateInput: "step" must be a positive number or "any".');
         this.setAttr('step', step);
     }
-    /** @returns {string|null} */
+    /** @returns {number|'any'|null} */
     get step() {
-        return this.attrString('step');
+        const value = this.attrString('step');
+        if (value === null || value === 'any')
+            return value;
+        return parseFloat(value);
     }
     /** @param {string} name */
     set name(name) {

package/dist/v1/libs/TinyHtml/input/date/TinyHtmlDateTimeInput.cjs

@@ -78,7 +78,7 @@ class TinyHtmlDateTimeInput extends TinyHtmlInput {
 
   /** @returns {string|null} */
   get value() {
-    return this.attrString('value');
+    return this.valTxt();
   }
 
   /** @param {string} min */

package/dist/v1/libs/TinyHtml/input/date/TinyHtmlDateTimeInput.d.mts

@@ -1,4 +1,4 @@
-export default TinyHtmlDateTimeInput;
+import TinyHtmlInput from '../../TinyHtmlInput.mjs';
 /**
  * TinyHtmlDateTimeInput is a helper class for managing
  * `<input type="datetime-local">` elements with validation.
@@ -35,18 +35,18 @@ declare class TinyHtmlDateTimeInput extends TinyHtmlInput {
      * @throws {TypeError} If any attribute is of the wrong type.
      */
     constructor({ value, min, max, step, name, placeholder, autocomplete, list, readonly, required, tags, mainClass, }?: {
-        value?: string | undefined;
-        min?: string | undefined;
-        max?: string | undefined;
-        step?: number | undefined;
-        name?: string | undefined;
-        placeholder?: string | undefined;
-        autocomplete?: string | undefined;
-        list?: string | undefined;
-        readonly?: boolean | undefined;
-        required?: boolean | undefined;
-        tags?: string | string[] | Set<string> | undefined;
-        mainClass?: string | undefined;
+        value?: string;
+        min?: string;
+        max?: string;
+        step?: number;
+        name?: string;
+        placeholder?: string;
+        autocomplete?: string;
+        list?: string;
+        readonly?: boolean;
+        required?: boolean;
+        tags?: string | string[] | Set<string>;
+        mainClass?: string;
     });
     /** @param {string|number|Date} value */
     set value(value: string | number | Date);
@@ -73,5 +73,5 @@ declare class TinyHtmlDateTimeInput extends TinyHtmlInput {
     /** @returns {string|null} */
     get autocomplete(): string | null;
 }
-import TinyHtmlInput from '../../TinyHtmlInput.mjs';
+export default TinyHtmlDateTimeInput;
 //# sourceMappingURL=TinyHtmlDateTimeInput.d.mts.map

package/dist/v1/libs/TinyHtml/input/date/TinyHtmlDateTimeInput.mjs

@@ -65,7 +65,7 @@ class TinyHtmlDateTimeInput extends TinyHtmlInput {
     }
     /** @returns {string|null} */
     get value() {
-        return this.attrString('value');
+        return this.valTxt();
     }
     /** @param {string} min */
     set min(min) {

package/dist/v1/libs/TinyHtml/input/date/TinyHtmlMonthInput.cjs

@@ -79,7 +79,7 @@ class TinyHtmlMonthInput extends TinyHtmlInput {
 
   /** @returns {string|null} */
   get value() {
-    return this.attrString('value');
+    return this.valTxt();
   }
 
   /** @param {string} min */

package/dist/v1/libs/TinyHtml/input/date/TinyHtmlMonthInput.d.mts

@@ -1,4 +1,4 @@
-export default TinyHtmlMonthInput;
+import TinyHtmlInput from '../../TinyHtmlInput.mjs';
 /**
  * TinyHtmlMonthInput is a helper class for managing `<input type="month">` elements.
  * It provides validation and convenient getters/setters for standard attributes.
@@ -32,18 +32,18 @@ declare class TinyHtmlMonthInput extends TinyHtmlInput {
      * @throws {TypeError} If any attribute is of the wrong type.
      */
     constructor({ value, list, min, max, step, name, readonly, required, placeholder, autocomplete, tags, mainClass, }?: {
-        value?: string | undefined;
-        min?: string | undefined;
-        max?: string | undefined;
-        step?: number | undefined;
-        name?: string | undefined;
-        placeholder?: string | undefined;
-        autocomplete?: string | undefined;
-        list?: string | undefined;
-        readonly?: boolean | undefined;
-        required?: boolean | undefined;
-        tags?: string | string[] | Set<string> | undefined;
-        mainClass?: string | undefined;
+        value?: string;
+        min?: string;
+        max?: string;
+        step?: number;
+        name?: string;
+        placeholder?: string;
+        autocomplete?: string;
+        list?: string;
+        readonly?: boolean;
+        required?: boolean;
+        tags?: string | string[] | Set<string>;
+        mainClass?: string;
     });
     /** @param {string|Date} value */
     set value(value: string | Date);
@@ -70,5 +70,5 @@ declare class TinyHtmlMonthInput extends TinyHtmlInput {
     /** @returns {string|null} */
     get autocomplete(): string | null;
 }
-import TinyHtmlInput from '../../TinyHtmlInput.mjs';
+export default TinyHtmlMonthInput;
 //# sourceMappingURL=TinyHtmlMonthInput.d.mts.map

package/dist/v1/libs/TinyHtml/input/date/TinyHtmlMonthInput.mjs

@@ -64,7 +64,7 @@ class TinyHtmlMonthInput extends TinyHtmlInput {
     }
     /** @returns {string|null} */
     get value() {
-        return this.attrString('value');
+        return this.valTxt();
     }
     /** @param {string} min */
     set min(min) {

package/dist/v1/libs/TinyHtml/input/date/TinyHtmlTimeInput.cjs

@@ -2,6 +2,16 @@
 
 var TinyHtmlInput = require('../../TinyHtmlInput.cjs');
 
+/**
+ * Validator to ensure the correct HTML5 time format (HH:MM or HH:MM:SS or HH:MM:SS.mmm)
+ * @param {string} str
+ * @returns {boolean}
+ */
+const isValidTimeString = (str) => {
+  const timeRegex = /^([01]\d|2[0-3]):[0-5]\d(:[0-5]\d(\.\d{1,3})?)?$/;
+  return typeof str === 'string' && (str.length < 1 || timeRegex.test(str));
+};
+
 /**
  * TinyHtmlTimeInput is a helper class for managing `<input type="time">` elements.
  * It provides validated getters and setters for all relevant attributes such as
@@ -18,13 +28,29 @@ var TinyHtmlInput = require('../../TinyHtmlInput.cjs');
  * });
  */
 class TinyHtmlTimeInput extends TinyHtmlInput {
+  /**
+   * Convert a Date to Time String.
+   * @param {Date} value
+   * @returns {string}
+   */
+  static dateToString(value) {
+    if (!(value instanceof Date)) throw new TypeError('TinyHtmlTimeInput: "value" must be a date.');
+
+    const hours = String(value.getHours()).padStart(2, '0');
+    const minutes = String(value.getMinutes()).padStart(2, '0');
+    const seconds = String(value.getSeconds()).padStart(2, '0');
+    const milliSecondss = String(value.getMilliseconds()).padStart(3, '0');
+
+    return `${hours}:${minutes}:${seconds}.${milliSecondss}`;
+  }
+
   /**
    * Creates a new TinyHtmlTimeInput instance.
    * @param {Object} config - Configuration object.
    * @param {string} [config.value] - Initial time value in "HH:MM" format.
    * @param {string} [config.min] - Minimum allowed time (e.g., "08:00").
    * @param {string} [config.max] - Maximum allowed time (e.g., "18:00").
-   * @param {number|string} [config.step] - Granularity in seconds (or "any").
+   * @param {number|'any'} [config.step] - Granularity in seconds (or "any").
    * @param {string} [config.name] - The name of the control.
    * @param {string} [config.placeholder] - Placeholder text.
    * @param {string} [config.autocomplete] - Autocomplete hint ("on", "off", or token list).
@@ -64,29 +90,26 @@ class TinyHtmlTimeInput extends TinyHtmlInput {
     this.required = required;
   }
 
-  /** @param {string|Date|number} value */
+  /** @param {string} value */
   set value(value) {
-    if (typeof value !== 'string' && typeof value !== 'number' && !(value instanceof Date))
-      throw new TypeError('TinyHtmlTimeInput: "value" must be a string or date.');
-    if (value instanceof Date) {
-      const hours = String(value.getHours()).padStart(2, '0');
-      const minutes = String(value.getMinutes()).padStart(2, '0');
-
-      const formatted = `${hours}:${minutes}`;
-      this.setVal(formatted);
-      return;
-    }
+    if (!isValidTimeString(value))
+      throw new TypeError(
+        'TinyHtmlTimeInput: "value" must be a valid time string (HH:MM or HH:MM:SS).',
+      );
     this.setVal(value);
   }
 
   /** @returns {string|null} */
   get value() {
-    return this.attrString('value');
+    return this.valTxt();
   }
 
   /** @param {string} min */
   set min(min) {
-    if (typeof min !== 'string') throw new TypeError('TinyHtmlTimeInput: "min" must be a string.');
+    if (!isValidTimeString(min))
+      throw new TypeError(
+        'TinyHtmlTimeInput: "min" must be a valid time string (HH:MM or HH:MM:SS).',
+      );
     this.setAttr('min', min);
   }
 
@@ -97,7 +120,10 @@ class TinyHtmlTimeInput extends TinyHtmlInput {
 
   /** @param {string} max */
   set max(max) {
-    if (typeof max !== 'string') throw new TypeError('TinyHtmlTimeInput: "max" must be a string.');
+    if (!isValidTimeString(max))
+      throw new TypeError(
+        'TinyHtmlTimeInput: "max" must be a valid time string (HH:MM or HH:MM:SS).',
+      );
     this.setAttr('max', max);
   }
 
@@ -106,21 +132,18 @@ class TinyHtmlTimeInput extends TinyHtmlInput {
     return this.attrString('max');
   }
 
-  /** @param {number|string} step */
+  /** @param {number|'any'} step */
   set step(step) {
-    if (typeof step === 'number') {
-      if (!Number.isFinite(step) || step <= 0)
-        throw new TypeError('TinyHtmlTimeInput: "step" must be a positive number or "any".');
-      this.setAttr('step', String(step));
-      return;
-    }
-    if (step !== 'any') throw new TypeError('TinyHtmlTimeInput: "step" must be a number or "any".');
+    if (!(typeof step === 'number' && step > 0) && step !== 'any')
+      throw new TypeError('TinyHtmlTimeInput: "step" must be a positive number or "any".');
     this.setAttr('step', step);
   }
 
-  /** @returns {string|null} */
+  /** @returns {number|'any'|null} */
   get step() {
-    return this.attrString('step');
+    const value = this.attrString('step');
+    if (value === null || value === 'any') return value;
+    return parseFloat(value);
   }
 
   /** @param {string} list */