tiny-essentials 1.24.0 → 1.24.1

package/dist/v1/libs/TinyHtml/input/check/TinyHtmlRadioInput.mjs

@@ -0,0 +1,94 @@
+import TinyHtmlInput from '../../TinyHtmlInput.mjs';
+/**
+ * TinyHtmlRadioInput is a helper class for managing `<input type="radio">` elements.
+ * It provides strict validation for attributes like `name`, `value`, `checked`, `readonly`,
+ * and `required`, with convenient getters and setters.
+ *
+ * @example
+ * const radio = new TinyHtmlRadioInput({
+ *   name: 'gender',
+ *   value: 'female',
+ *   checked: true,
+ *   required: true
+ * });
+ *
+ * // Check state
+ * radio.checked = false;
+ * console.log(radio.checked); // false
+ */
+class TinyHtmlRadioInput extends TinyHtmlInput {
+    /**
+     * Creates a new TinyHtmlRadioInput instance.
+     * @param {Object} config - Configuration object.
+     * @param {string} config.name - Radio group name (required).
+     * @param {string|number} [config.value] - Value for this radio option.
+     * @param {boolean} [config.checked=false] - Whether this radio is selected.
+     * @param {boolean} [config.readonly=false] - Whether the input is readonly.
+     * @param {boolean} [config.required=false] - Whether the input is required.
+     * @param {string|string[]|Set<string>} [config.tags=[]] - Initial CSS classes.
+     * @param {string} [config.mainClass=''] - Main CSS class.
+     * @throws {TypeError} If an attribute is of the wrong type.
+     */
+    constructor({ name, value, checked = false, readonly = false, required = false, tags = [], mainClass = '', }) {
+        super({ tags, mainClass, type: 'radio' });
+        // --- name (required) ---
+        if (typeof name !== 'string') {
+            throw new TypeError('TinyHtmlRadioInput: "name" is required and must be a string.');
+        }
+        this.name = name;
+        // --- value ---
+        if (value !== undefined)
+            this.value = value;
+        // --- checked ---
+        this.checked = checked;
+        // --- readonly ---
+        this.readonly = readonly;
+        // --- required ---
+        this.required = required;
+    }
+    /** @param {string|number} value */
+    set value(value) {
+        if (typeof value !== 'string' && typeof value !== 'number') {
+            throw new TypeError('TinyHtmlRadioInput: "value" must be a string or number.');
+        }
+        this.setAttr('value', value);
+    }
+    /** @returns {string|null} */
+    get value() {
+        return this.attrString('value');
+    }
+    /** @param {string} name */
+    set name(name) {
+        if (typeof name !== 'string') {
+            throw new TypeError('TinyHtmlRadioInput: "name" must be a string.');
+        }
+        this.setAttr('name', name);
+    }
+    /** @returns {string|null} */
+    get name() {
+        return this.attrString('name');
+    }
+    /** @param {boolean} checked */
+    set checked(checked) {
+        if (typeof checked !== 'boolean') {
+            throw new TypeError('TinyHtmlRadioInput: "checked" must be a boolean.');
+        }
+        if (checked)
+            this.addProp('checked');
+        else
+            this.removeProp('checked');
+    }
+    /** @returns {boolean} */
+    get checked() {
+        return this.hasProp('checked');
+    }
+    /**
+     * Toggles the checked state of the radio.
+     * @returns {this}
+     */
+    toggle() {
+        this.checked = !this.checked;
+        return this;
+    }
+}
+export default TinyHtmlRadioInput;

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

@@ -0,0 +1,172 @@
+'use strict';
+
+var TinyHtmlInput = require('../../TinyHtmlInput.cjs');
+
+/**
+ * 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`,
+ * as well as common attributes like `name`, `placeholder`, `readonly`, `required`, etc.
+ *
+ * @example
+ * const dateInput = new TinyHtmlDateInput({
+ *   value: '2025-09-25',
+ *   min: '2025-01-01',
+ *   max: '2025-12-31',
+ *   step: 1,
+ *   required: true
+ * });
+ */
+class TinyHtmlDateInput extends TinyHtmlInput {
+  /**
+   * 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 {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").
+   * @param {string} [config.list] - ID of a `<datalist>` element for suggestions.
+   * @param {boolean} [config.readonly=false] - Whether the input is read-only.
+   * @param {boolean} [config.required=false] - Whether the input is required.
+   * @param {string|string[]|Set<string>} [config.tags=[]] - Initial CSS classes.
+   * @param {string} [config.mainClass=''] - Main CSS class.
+   * @throws {TypeError} If any attribute is of the wrong type.
+   */
+  constructor({
+    value,
+    min,
+    max,
+    step,
+    name,
+    placeholder,
+    autocomplete,
+    list,
+    readonly = false,
+    required = false,
+    tags = [],
+    mainClass = '',
+  } = {}) {
+    super({ type: 'date', name, placeholder, tags, mainClass });
+
+    if (value !== undefined) this.value = value;
+    if (min !== undefined) this.min = min;
+    if (max !== undefined) this.max = max;
+    if (step !== undefined) this.step = step;
+    if (autocomplete !== undefined) this.autocomplete = autocomplete;
+    if (list !== undefined) this.list = list;
+
+    this.readonly = readonly;
+    this.required = required;
+  }
+
+  /** @param {string|Date} 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;
+    }
+    this.setVal(value);
+  }
+
+  /** @returns {string|null} */
+  get value() {
+    return this.attrString('value');
+  }
+
+  /** @param {string} min */
+  set min(min) {
+    if (typeof min !== 'string')
+      throw new TypeError('TinyHtmlDateInput: "min" must be a string in YYYY-MM-DD format.');
+    this.setAttr('min', min);
+  }
+
+  /** @returns {string|null} */
+  get min() {
+    return this.attrString('min');
+  }
+
+  /** @param {string} max */
+  set max(max) {
+    if (typeof max !== 'string')
+      throw new TypeError('TinyHtmlDateInput: "max" must be a string in YYYY-MM-DD format.');
+    this.setAttr('max', max);
+  }
+
+  /** @returns {string|null} */
+  get max() {
+    return this.attrString('max');
+  }
+
+  /** @param {number|string} 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} */
+  get step() {
+    return this.attrString('step');
+  }
+
+  /** @param {string} name */
+  set name(name) {
+    if (typeof name !== 'string')
+      throw new TypeError('TinyHtmlDateInput: "name" must be a string.');
+    this.setAttr('name', name);
+  }
+
+  /** @returns {string|null} */
+  get name() {
+    return this.attrString('name');
+  }
+
+  /** @param {string} placeholder */
+  set placeholder(placeholder) {
+    if (typeof placeholder !== 'string')
+      throw new TypeError('TinyHtmlDateInput: "placeholder" must be a string.');
+    this.setAttr('placeholder', placeholder);
+  }
+
+  /** @returns {string|null} */
+  get placeholder() {
+    return this.attrString('placeholder');
+  }
+
+  /** @param {string} autocomplete */
+  set autocomplete(autocomplete) {
+    if (typeof autocomplete !== 'string')
+      throw new TypeError('TinyHtmlDateInput: "autocomplete" must be a string.');
+    this.setAttr('autocomplete', autocomplete);
+  }
+
+  /** @returns {string|null} */
+  get autocomplete() {
+    return this.attrString('autocomplete');
+  }
+
+  /** @param {string} list */
+  set list(list) {
+    if (typeof list !== 'string')
+      throw new TypeError('TinyHtmlDateInput: "list" must be a string (datalist id).');
+    this.setAttr('list', list);
+  }
+
+  /** @returns {string|null} */
+  get list() {
+    return this.attrString('list');
+  }
+}
+
+module.exports = TinyHtmlDateInput;

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

@@ -0,0 +1,74 @@
+export default TinyHtmlDateInput;
+/**
+ * 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`,
+ * as well as common attributes like `name`, `placeholder`, `readonly`, `required`, etc.
+ *
+ * @example
+ * const dateInput = new TinyHtmlDateInput({
+ *   value: '2025-09-25',
+ *   min: '2025-01-01',
+ *   max: '2025-12-31',
+ *   step: 1,
+ *   required: true
+ * });
+ */
+declare class TinyHtmlDateInput extends TinyHtmlInput {
+    /**
+     * 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 {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").
+     * @param {string} [config.list] - ID of a `<datalist>` element for suggestions.
+     * @param {boolean} [config.readonly=false] - Whether the input is read-only.
+     * @param {boolean} [config.required=false] - Whether the input is required.
+     * @param {string|string[]|Set<string>} [config.tags=[]] - Initial CSS classes.
+     * @param {string} [config.mainClass=''] - Main CSS class.
+     * @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;
+    });
+    /** @param {string|Date} value */
+    set value(value: string | Date);
+    /** @returns {string|null} */
+    get value(): string | null;
+    /** @param {string} min */
+    set min(min: string);
+    /** @returns {string|null} */
+    get min(): string | null;
+    /** @param {string} max */
+    set max(max: string);
+    /** @returns {string|null} */
+    get max(): string | null;
+    /** @param {number|string} step */
+    set step(step: number | string);
+    /** @returns {string|null} */
+    get step(): string | null;
+    /** @param {string} autocomplete */
+    set autocomplete(autocomplete: string);
+    /** @returns {string|null} */
+    get autocomplete(): string | null;
+    /** @param {string} list */
+    set list(list: string);
+    /** @returns {string|null} */
+    get list(): string | null;
+}
+import TinyHtmlInput from '../../TinyHtmlInput.mjs';
+//# sourceMappingURL=TinyHtmlDateInput.d.mts.map

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

@@ -0,0 +1,140 @@
+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`,
+ * as well as common attributes like `name`, `placeholder`, `readonly`, `required`, etc.
+ *
+ * @example
+ * const dateInput = new TinyHtmlDateInput({
+ *   value: '2025-09-25',
+ *   min: '2025-01-01',
+ *   max: '2025-12-31',
+ *   step: 1,
+ *   required: true
+ * });
+ */
+class TinyHtmlDateInput extends TinyHtmlInput {
+    /**
+     * 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 {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").
+     * @param {string} [config.list] - ID of a `<datalist>` element for suggestions.
+     * @param {boolean} [config.readonly=false] - Whether the input is read-only.
+     * @param {boolean} [config.required=false] - Whether the input is required.
+     * @param {string|string[]|Set<string>} [config.tags=[]] - Initial CSS classes.
+     * @param {string} [config.mainClass=''] - Main CSS class.
+     * @throws {TypeError} If any attribute is of the wrong type.
+     */
+    constructor({ value, min, max, step, name, placeholder, autocomplete, list, readonly = false, required = false, tags = [], mainClass = '', } = {}) {
+        super({ type: 'date', name, placeholder, tags, mainClass });
+        if (value !== undefined)
+            this.value = value;
+        if (min !== undefined)
+            this.min = min;
+        if (max !== undefined)
+            this.max = max;
+        if (step !== undefined)
+            this.step = step;
+        if (autocomplete !== undefined)
+            this.autocomplete = autocomplete;
+        if (list !== undefined)
+            this.list = list;
+        this.readonly = readonly;
+        this.required = required;
+    }
+    /** @param {string|Date} 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;
+        }
+        this.setVal(value);
+    }
+    /** @returns {string|null} */
+    get value() {
+        return this.attrString('value');
+    }
+    /** @param {string} min */
+    set min(min) {
+        if (typeof min !== 'string')
+            throw new TypeError('TinyHtmlDateInput: "min" must be a string in YYYY-MM-DD format.');
+        this.setAttr('min', min);
+    }
+    /** @returns {string|null} */
+    get min() {
+        return this.attrString('min');
+    }
+    /** @param {string} max */
+    set max(max) {
+        if (typeof max !== 'string')
+            throw new TypeError('TinyHtmlDateInput: "max" must be a string in YYYY-MM-DD format.');
+        this.setAttr('max', max);
+    }
+    /** @returns {string|null} */
+    get max() {
+        return this.attrString('max');
+    }
+    /** @param {number|string} 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} */
+    get step() {
+        return this.attrString('step');
+    }
+    /** @param {string} name */
+    set name(name) {
+        if (typeof name !== 'string')
+            throw new TypeError('TinyHtmlDateInput: "name" must be a string.');
+        this.setAttr('name', name);
+    }
+    /** @returns {string|null} */
+    get name() {
+        return this.attrString('name');
+    }
+    /** @param {string} placeholder */
+    set placeholder(placeholder) {
+        if (typeof placeholder !== 'string')
+            throw new TypeError('TinyHtmlDateInput: "placeholder" must be a string.');
+        this.setAttr('placeholder', placeholder);
+    }
+    /** @returns {string|null} */
+    get placeholder() {
+        return this.attrString('placeholder');
+    }
+    /** @param {string} autocomplete */
+    set autocomplete(autocomplete) {
+        if (typeof autocomplete !== 'string')
+            throw new TypeError('TinyHtmlDateInput: "autocomplete" must be a string.');
+        this.setAttr('autocomplete', autocomplete);
+    }
+    /** @returns {string|null} */
+    get autocomplete() {
+        return this.attrString('autocomplete');
+    }
+    /** @param {string} list */
+    set list(list) {
+        if (typeof list !== 'string')
+            throw new TypeError('TinyHtmlDateInput: "list" must be a string (datalist id).');
+        this.setAttr('list', list);
+    }
+    /** @returns {string|null} */
+    get list() {
+        return this.attrString('list');
+    }
+}
+export default TinyHtmlDateInput;

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

@@ -0,0 +1,145 @@
+'use strict';
+
+var TinyHtmlInput = require('../../TinyHtmlInput.cjs');
+
+/**
+ * TinyHtmlDateTimeInput is a helper class for managing
+ * `<input type="datetime-local">` elements with validation.
+ *
+ * It supports attributes such as `value`, `min`, `max`, `step`,
+ * `placeholder`, `autocomplete`, and more.
+ *
+ * @example
+ * const dateTimeInput = new TinyHtmlDateTimeInput({
+ *   value: '2025-09-25T14:30',
+ *   min: '2025-01-01T00:00',
+ *   max: '2025-12-31T23:59',
+ *   step: 60,
+ *   required: true,
+ *   name: 'meetingTime'
+ * });
+ */
+class TinyHtmlDateTimeInput extends TinyHtmlInput {
+  /**
+   * Creates a new TinyHtmlDateTimeInput instance.
+   * @param {Object} config - Configuration object.
+   * @param {string} [config.value] - Initial datetime value (`YYYY-MM-DDTHH:MM`).
+   * @param {string} [config.min] - Minimum allowed datetime.
+   * @param {string} [config.max] - Maximum allowed datetime.
+   * @param {number} [config.step] - Granularity in seconds (or multiples).
+   * @param {string} [config.name] - The name of the control.
+   * @param {string} [config.placeholder] - Placeholder text.
+   * @param {string} [config.autocomplete] - Autocomplete hint (e.g., "on", "off").
+   * @param {string} [config.list] - The id of a <datalist> element.
+   * @param {boolean} [config.readonly=false] - Whether the input is read-only.
+   * @param {boolean} [config.required=false] - Whether the input is required.
+   * @param {string|string[]|Set<string>} [config.tags=[]] - Initial CSS classes.
+   * @param {string} [config.mainClass=''] - Main CSS class.
+   * @throws {TypeError} If any attribute is of the wrong type.
+   */
+  constructor({
+    value,
+    min,
+    max,
+    step,
+    name,
+    placeholder,
+    autocomplete,
+    list,
+    readonly = false,
+    required = false,
+    tags = [],
+    mainClass = '',
+  } = {}) {
+    super({
+      type: 'datetime-local',
+      name,
+      placeholder,
+      tags,
+      mainClass,
+      readonly,
+      required,
+    });
+
+    if (value !== undefined) this.value = value;
+    if (min !== undefined) this.min = min;
+    if (max !== undefined) this.max = max;
+    if (step !== undefined) this.step = step;
+    if (list !== undefined) this.list = list;
+    if (autocomplete !== undefined) this.autocomplete = autocomplete;
+  }
+
+  /** @param {string|number|Date} value */
+  set value(value) {
+    if (typeof value !== 'string' && typeof value !== 'number' && !(value instanceof Date))
+      throw new TypeError('TinyHtmlDateTimeInput: "value" must be a string or date.');
+    this.setVal(value);
+  }
+
+  /** @returns {string|null} */
+  get value() {
+    return this.attrString('value');
+  }
+
+  /** @param {string} min */
+  set min(min) {
+    if (typeof min !== 'string')
+      throw new TypeError('TinyHtmlDateTimeInput: "min" must be a string (YYYY-MM-DDTHH:MM).');
+    this.setAttr('min', min);
+  }
+
+  /** @returns {string|null} */
+  get min() {
+    return this.attrString('min');
+  }
+
+  /** @param {string} max */
+  set max(max) {
+    if (typeof max !== 'string')
+      throw new TypeError('TinyHtmlDateTimeInput: "max" must be a string (YYYY-MM-DDTHH:MM).');
+    this.setAttr('max', max);
+  }
+
+  /** @returns {string|null} */
+  get max() {
+    return this.attrString('max');
+  }
+
+  /** @param {number} step */
+  set step(step) {
+    if (!Number.isInteger(step) || step < 1)
+      throw new TypeError('TinyHtmlDateTimeInput: "step" must be a positive integer.');
+    this.setAttr('step', step);
+  }
+
+  /** @returns {number|null} */
+  get step() {
+    return this.attrNumber('step');
+  }
+
+  /** @param {string} list */
+  set list(list) {
+    if (typeof list !== 'string')
+      throw new TypeError('TinyHtmlDateTimeInput: "list" must be a string (datalist id).');
+    this.setAttr('list', list);
+  }
+
+  /** @returns {string|null} */
+  get list() {
+    return this.attrString('list');
+  }
+
+  /** @param {string} autocomplete */
+  set autocomplete(autocomplete) {
+    if (typeof autocomplete !== 'string')
+      throw new TypeError('TinyHtmlDateTimeInput: "autocomplete" must be a string.');
+    this.setAttr('autocomplete', autocomplete);
+  }
+
+  /** @returns {string|null} */
+  get autocomplete() {
+    return this.attrString('autocomplete');
+  }
+}
+
+module.exports = TinyHtmlDateTimeInput;