tiny-essentials/dist/v1/libs/TinyHtml/input/date/TinyHtmlDateInput.cjs

Collection of small, essential scripts designed to be used across various projects. These simple utilities are crafted for speed, ease of use, and versatility.

'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;