tiny-essentials 1.24.0 → 1.24.1

package/dist/v1/libs/TinyHtml/input/text/TinyHtmlEmailInput.d.mts

@@ -0,0 +1,87 @@
+export default TinyHtmlEmailInput;
+/**
+ * TinyHtmlEmailInput is a helper class for managing <input type="email"> elements.
+ * It provides strongly typed getters and setters for common attributes such as
+ * minlength, maxlength, pattern, autocomplete, multiple, and more.
+ *
+ * @example
+ * const emailInput = new TinyHtmlEmailInput({
+ *   placeholder: 'Enter your email',
+ *   required: true,
+ *   maxlength: 100,
+ *   autocomplete: 'email'
+ * });
+ */
+declare class TinyHtmlEmailInput extends TinyHtmlInput {
+    /**
+     * Creates a new TinyHtmlEmailInput instance.
+     * @param {Object} config - Configuration object.
+     * @param {string} [config.value] - Initial value.
+     * @param {number} [config.minLength] - Minimum number of characters allowed.
+     * @param {number} [config.maxLength] - Maximum number of characters allowed.
+     * @param {string} [config.pattern] - Regex pattern for validation.
+     * @param {string} [config.autocomplete] - Autocomplete hint (e.g., "on", "off", "email").
+     * @param {string} [config.dirname] - Name of the directionality field (text-based inputs).
+     * @param {string} [config.list] - ID of a <datalist> element.
+     * @param {boolean} [config.multiple=false] - Whether multiple values are allowed.
+     * @param {number} [config.size] - Size of the input box in characters.
+     * @param {boolean} [config.readonly=false] - Whether the input is readonly.
+     * @param {boolean} [config.required=false] - Whether the input is required.
+     * @param {string} [config.placeholder] - Placeholder text.
+     * @param {string} [config.name] - Name of the control.
+     * @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, list, placeholder, readonly, required, multiple, minLength, autocomplete, size, pattern, maxLength, dirname, name, tags, mainClass, }?: {
+        value?: string | undefined;
+        minLength?: number | undefined;
+        maxLength?: number | undefined;
+        pattern?: string | undefined;
+        autocomplete?: string | undefined;
+        dirname?: string | undefined;
+        list?: string | undefined;
+        multiple?: boolean | undefined;
+        size?: number | undefined;
+        readonly?: boolean | undefined;
+        required?: boolean | undefined;
+        placeholder?: string | undefined;
+        name?: string | undefined;
+        tags?: string | string[] | Set<string> | undefined;
+        mainClass?: string | undefined;
+    });
+    /** @param {number} minLength */
+    set minLength(minLength: number);
+    /** @returns {number|null} */
+    get minLength(): number | null;
+    /** @param {number} maxLength */
+    set maxLength(maxLength: number);
+    /** @returns {number|null} */
+    get maxLength(): number | null;
+    /** @param {string} pattern */
+    set pattern(pattern: string);
+    /** @returns {string|null} */
+    get pattern(): string | null;
+    /** @param {boolean} multiple */
+    set multiple(multiple: boolean);
+    /** @returns {boolean} */
+    get multiple(): boolean;
+    /** @param {string} list */
+    set list(list: string);
+    /** @returns {string|null} */
+    get list(): string | null;
+    /** @param {string} autocomplete */
+    set autocomplete(autocomplete: string);
+    /** @returns {string|null} */
+    get autocomplete(): string | null;
+    /** @param {string} dirname */
+    set dirname(dirname: string);
+    /** @returns {string|null} */
+    get dirname(): string | null;
+    /** @param {string} value */
+    set value(value: string);
+    /** @returns {string} */
+    get value(): string;
+}
+import TinyHtmlInput from '../../TinyHtmlInput.mjs';
+//# sourceMappingURL=TinyHtmlEmailInput.d.mts.map

package/dist/v1/libs/TinyHtml/input/text/TinyHtmlEmailInput.mjs

@@ -0,0 +1,151 @@
+import TinyHtmlInput from '../../TinyHtmlInput.mjs';
+/**
+ * TinyHtmlEmailInput is a helper class for managing <input type="email"> elements.
+ * It provides strongly typed getters and setters for common attributes such as
+ * minlength, maxlength, pattern, autocomplete, multiple, and more.
+ *
+ * @example
+ * const emailInput = new TinyHtmlEmailInput({
+ *   placeholder: 'Enter your email',
+ *   required: true,
+ *   maxlength: 100,
+ *   autocomplete: 'email'
+ * });
+ */
+class TinyHtmlEmailInput extends TinyHtmlInput {
+    /**
+     * Creates a new TinyHtmlEmailInput instance.
+     * @param {Object} config - Configuration object.
+     * @param {string} [config.value] - Initial value.
+     * @param {number} [config.minLength] - Minimum number of characters allowed.
+     * @param {number} [config.maxLength] - Maximum number of characters allowed.
+     * @param {string} [config.pattern] - Regex pattern for validation.
+     * @param {string} [config.autocomplete] - Autocomplete hint (e.g., "on", "off", "email").
+     * @param {string} [config.dirname] - Name of the directionality field (text-based inputs).
+     * @param {string} [config.list] - ID of a <datalist> element.
+     * @param {boolean} [config.multiple=false] - Whether multiple values are allowed.
+     * @param {number} [config.size] - Size of the input box in characters.
+     * @param {boolean} [config.readonly=false] - Whether the input is readonly.
+     * @param {boolean} [config.required=false] - Whether the input is required.
+     * @param {string} [config.placeholder] - Placeholder text.
+     * @param {string} [config.name] - Name of the control.
+     * @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, list, placeholder, readonly = false, required = false, multiple = false, minLength, autocomplete, size, pattern, maxLength, dirname, name, tags = [], mainClass = '', } = {}) {
+        super({ type: 'email', name, placeholder, readonly, required, tags, mainClass });
+        if (minLength !== undefined)
+            this.minLength = minLength;
+        if (maxLength !== undefined)
+            this.maxLength = maxLength;
+        if (pattern !== undefined)
+            this.pattern = pattern;
+        if (multiple !== undefined)
+            this.multiple = multiple;
+        if (list !== undefined)
+            this.list = list;
+        if (autocomplete !== undefined)
+            this.autocomplete = autocomplete;
+        if (dirname !== undefined)
+            this.dirname = dirname;
+        if (size !== undefined)
+            this.sizeEl = size;
+        if (value !== undefined)
+            this.value = value;
+    }
+    /** @param {string} value */
+    set value(value) {
+        if (typeof value !== 'string')
+            throw new TypeError('TinyHtmlEmailInput: "value" must be a string.');
+        this.setVal(value);
+    }
+    /** @returns {string} */
+    get value() {
+        return this.valTxt();
+    }
+    /** @param {number} minLength */
+    set minLength(minLength) {
+        if (!Number.isInteger(minLength) || minLength < 0)
+            throw new TypeError('TinyHtmlEmailInput: "minLength" must be a non-negative integer.');
+        this.setAttr('minlength', minLength);
+    }
+    /** @returns {number|null} */
+    get minLength() {
+        return this.attrNumber('minlength');
+    }
+    /** @param {number} maxLength */
+    set maxLength(maxLength) {
+        if (!Number.isInteger(maxLength) || maxLength < 1)
+            throw new TypeError('TinyHtmlEmailInput: "maxLength" must be a positive integer.');
+        this.setAttr('maxlength', maxLength);
+    }
+    /** @returns {number|null} */
+    get maxLength() {
+        return this.attrNumber('maxlength');
+    }
+    /** @param {string} pattern */
+    set pattern(pattern) {
+        if (typeof pattern !== 'string')
+            throw new TypeError('TinyHtmlEmailInput: "pattern" must be a string.');
+        this.setAttr('pattern', pattern);
+    }
+    /** @returns {string|null} */
+    get pattern() {
+        return this.attrString('pattern');
+    }
+    /** @param {boolean} multiple */
+    set multiple(multiple) {
+        if (typeof multiple !== 'boolean')
+            throw new TypeError('TinyHtmlEmailInput: "multiple" must be a boolean.');
+        if (multiple)
+            this.addProp('multiple');
+        else
+            this.removeProp('multiple');
+    }
+    /** @returns {boolean} */
+    get multiple() {
+        return this.hasProp('multiple');
+    }
+    /** @param {string} list */
+    set list(list) {
+        if (typeof list !== 'string')
+            throw new TypeError('TinyHtmlEmailInput: "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('TinyHtmlEmailInput: "autocomplete" must be a string.');
+        this.setAttr('autocomplete', autocomplete);
+    }
+    /** @returns {string|null} */
+    get autocomplete() {
+        return this.attrString('autocomplete');
+    }
+    /** @param {string} dirname */
+    set dirname(dirname) {
+        if (typeof dirname !== 'string')
+            throw new TypeError('TinyHtmlEmailInput: "dirname" must be a string.');
+        this.setAttr('dirname', dirname);
+    }
+    /** @returns {string|null} */
+    get dirname() {
+        return this.attrString('dirname');
+    }
+    /** @param {number} size */
+    set sizeEl(size) {
+        if (!Number.isInteger(size) || size < 1)
+            throw new TypeError('TinyHtmlEmailInput: "size" must be a positive integer.');
+        this.setAttr('size', size);
+    }
+    /** @returns {number|null} */
+    get sizeEl() {
+        return this.attrNumber('size');
+    }
+}
+export default TinyHtmlEmailInput;

package/dist/v1/libs/TinyHtml/input/text/TinyHtmlPasswordInput.cjs

@@ -0,0 +1,126 @@
+'use strict';
+
+var TinyHtmlInput = require('../../TinyHtmlInput.cjs');
+
+/**
+ * TinyHtmlPasswordInput is a helper class for managing
+ * `<input type="password">` elements with validation and attribute control.
+ *
+ * @example
+ * const passwordInput = new TinyHtmlPasswordInput({
+ *   name: 'user-password',
+ *   required: true,
+ *   minlength: 8,
+ *   maxlength: 32,
+ *   pattern: '[A-Za-z0-9]+',
+ *   placeholder: 'Enter your password...'
+ * });
+ */
+class TinyHtmlPasswordInput extends TinyHtmlInput {
+  /**
+   * Creates a new TinyHtmlPasswordInput instance.
+   * @param {Object} config - Configuration object.
+   * @param {string} [config.value] - Initial value.
+   * @param {number} [config.minlength] - Minimum length in UTF-16 code units.
+   * @param {number} [config.maxlength] - Maximum length in UTF-16 code units.
+   * @param {string} [config.name] - Name of the input.
+   * @param {string} [config.pattern] - Regex pattern to validate against.
+   * @param {string} [config.autocomplete] - Autocomplete hint (e.g., "on", "off", "email").
+   * @param {number} [config.size] - Number of characters visible.
+   * @param {boolean} [config.readonly=false] - Whether the input is read-only.
+   * @param {boolean} [config.required=false] - Whether the input is required.
+   * @param {string} [config.placeholder] - Placeholder text.
+   * @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,
+    minlength,
+    maxlength,
+    name,
+    pattern,
+    autocomplete,
+    size,
+    readonly = false,
+    required = false,
+    placeholder,
+    tags = [],
+    mainClass = '',
+  } = {}) {
+    super({ type: 'password', name, placeholder, tags, mainClass });
+
+    // Apply attributes if provided
+    if (minlength !== undefined) this.minlength = minlength;
+    if (maxlength !== undefined) this.maxlength = maxlength;
+    if (pattern !== undefined) this.pattern = pattern;
+    if (autocomplete !== undefined) this.autocomplete = autocomplete;
+    if (size !== undefined) this.sizeEl = size;
+    if (value !== undefined) this.value = value;
+
+    // Boolean props
+    this.readonly = readonly;
+    this.required = required;
+  }
+
+  /** @param {string} value */
+  set value(value) {
+    if (typeof value !== 'string') throw new TypeError('"value" must be a string.');
+    this.setVal(value);
+  }
+
+  /** @returns {string} */
+  get value() {
+    return this.valTxt();
+  }
+
+  /** @param {number} minlength */
+  set minlength(minlength) {
+    if (!Number.isInteger(minlength) || minlength < 0)
+      throw new TypeError('TinyHtmlPasswordInput: "minlength" must be a non-negative integer.');
+    this.setAttr('minlength', minlength);
+  }
+
+  /** @returns {number|null} */
+  get minlength() {
+    return this.attrNumber('minlength');
+  }
+
+  /** @param {number} maxlength */
+  set maxlength(maxlength) {
+    if (!Number.isInteger(maxlength) || maxlength < 1)
+      throw new TypeError('TinyHtmlPasswordInput: "maxlength" must be a positive integer.');
+    this.setAttr('maxlength', maxlength);
+  }
+
+  /** @returns {number|null} */
+  get maxlength() {
+    return this.attrNumber('maxlength');
+  }
+
+  /** @param {string} pattern */
+  set pattern(pattern) {
+    if (typeof pattern !== 'string')
+      throw new TypeError('TinyHtmlPasswordInput: "pattern" must be a string.');
+    this.setAttr('pattern', pattern);
+  }
+
+  /** @returns {string|null} */
+  get pattern() {
+    return this.attrString('pattern');
+  }
+
+  /** @param {string} autocomplete */
+  set autocomplete(autocomplete) {
+    if (typeof autocomplete !== 'string')
+      throw new TypeError('TinyHtmlPasswordInput: "autocomplete" must be a string.');
+    this.setAttr('autocomplete', autocomplete);
+  }
+
+  /** @returns {string|null} */
+  get autocomplete() {
+    return this.attrString('autocomplete');
+  }
+}
+
+module.exports = TinyHtmlPasswordInput;

package/dist/v1/libs/TinyHtml/input/text/TinyHtmlPasswordInput.d.mts

@@ -0,0 +1,70 @@
+export default TinyHtmlPasswordInput;
+/**
+ * TinyHtmlPasswordInput is a helper class for managing
+ * `<input type="password">` elements with validation and attribute control.
+ *
+ * @example
+ * const passwordInput = new TinyHtmlPasswordInput({
+ *   name: 'user-password',
+ *   required: true,
+ *   minlength: 8,
+ *   maxlength: 32,
+ *   pattern: '[A-Za-z0-9]+',
+ *   placeholder: 'Enter your password...'
+ * });
+ */
+declare class TinyHtmlPasswordInput extends TinyHtmlInput {
+    /**
+     * Creates a new TinyHtmlPasswordInput instance.
+     * @param {Object} config - Configuration object.
+     * @param {string} [config.value] - Initial value.
+     * @param {number} [config.minlength] - Minimum length in UTF-16 code units.
+     * @param {number} [config.maxlength] - Maximum length in UTF-16 code units.
+     * @param {string} [config.name] - Name of the input.
+     * @param {string} [config.pattern] - Regex pattern to validate against.
+     * @param {string} [config.autocomplete] - Autocomplete hint (e.g., "on", "off", "email").
+     * @param {number} [config.size] - Number of characters visible.
+     * @param {boolean} [config.readonly=false] - Whether the input is read-only.
+     * @param {boolean} [config.required=false] - Whether the input is required.
+     * @param {string} [config.placeholder] - Placeholder text.
+     * @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, minlength, maxlength, name, pattern, autocomplete, size, readonly, required, placeholder, tags, mainClass, }?: {
+        value?: string | undefined;
+        minlength?: number | undefined;
+        maxlength?: number | undefined;
+        name?: string | undefined;
+        pattern?: string | undefined;
+        autocomplete?: string | undefined;
+        size?: number | undefined;
+        readonly?: boolean | undefined;
+        required?: boolean | undefined;
+        placeholder?: string | undefined;
+        tags?: string | string[] | Set<string> | undefined;
+        mainClass?: string | undefined;
+    });
+    /** @param {number} minlength */
+    set minlength(minlength: number);
+    /** @returns {number|null} */
+    get minlength(): number | null;
+    /** @param {number} maxlength */
+    set maxlength(maxlength: number);
+    /** @returns {number|null} */
+    get maxlength(): number | null;
+    /** @param {string} pattern */
+    set pattern(pattern: string);
+    /** @returns {string|null} */
+    get pattern(): string | null;
+    /** @param {string} autocomplete */
+    set autocomplete(autocomplete: string);
+    /** @returns {string|null} */
+    get autocomplete(): string | null;
+    /** @param {string} value */
+    set value(value: string);
+    /** @returns {string} */
+    get value(): string;
+}
+import TinyHtmlInput from '../../TinyHtmlInput.mjs';
+//# sourceMappingURL=TinyHtmlPasswordInput.d.mts.map

package/dist/v1/libs/TinyHtml/input/text/TinyHtmlPasswordInput.mjs

@@ -0,0 +1,104 @@
+import TinyHtmlInput from '../../TinyHtmlInput.mjs';
+/**
+ * TinyHtmlPasswordInput is a helper class for managing
+ * `<input type="password">` elements with validation and attribute control.
+ *
+ * @example
+ * const passwordInput = new TinyHtmlPasswordInput({
+ *   name: 'user-password',
+ *   required: true,
+ *   minlength: 8,
+ *   maxlength: 32,
+ *   pattern: '[A-Za-z0-9]+',
+ *   placeholder: 'Enter your password...'
+ * });
+ */
+class TinyHtmlPasswordInput extends TinyHtmlInput {
+    /**
+     * Creates a new TinyHtmlPasswordInput instance.
+     * @param {Object} config - Configuration object.
+     * @param {string} [config.value] - Initial value.
+     * @param {number} [config.minlength] - Minimum length in UTF-16 code units.
+     * @param {number} [config.maxlength] - Maximum length in UTF-16 code units.
+     * @param {string} [config.name] - Name of the input.
+     * @param {string} [config.pattern] - Regex pattern to validate against.
+     * @param {string} [config.autocomplete] - Autocomplete hint (e.g., "on", "off", "email").
+     * @param {number} [config.size] - Number of characters visible.
+     * @param {boolean} [config.readonly=false] - Whether the input is read-only.
+     * @param {boolean} [config.required=false] - Whether the input is required.
+     * @param {string} [config.placeholder] - Placeholder text.
+     * @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, minlength, maxlength, name, pattern, autocomplete, size, readonly = false, required = false, placeholder, tags = [], mainClass = '', } = {}) {
+        super({ type: 'password', name, placeholder, tags, mainClass });
+        // Apply attributes if provided
+        if (minlength !== undefined)
+            this.minlength = minlength;
+        if (maxlength !== undefined)
+            this.maxlength = maxlength;
+        if (pattern !== undefined)
+            this.pattern = pattern;
+        if (autocomplete !== undefined)
+            this.autocomplete = autocomplete;
+        if (size !== undefined)
+            this.sizeEl = size;
+        if (value !== undefined)
+            this.value = value;
+        // Boolean props
+        this.readonly = readonly;
+        this.required = required;
+    }
+    /** @param {string} value */
+    set value(value) {
+        if (typeof value !== 'string')
+            throw new TypeError('"value" must be a string.');
+        this.setVal(value);
+    }
+    /** @returns {string} */
+    get value() {
+        return this.valTxt();
+    }
+    /** @param {number} minlength */
+    set minlength(minlength) {
+        if (!Number.isInteger(minlength) || minlength < 0)
+            throw new TypeError('TinyHtmlPasswordInput: "minlength" must be a non-negative integer.');
+        this.setAttr('minlength', minlength);
+    }
+    /** @returns {number|null} */
+    get minlength() {
+        return this.attrNumber('minlength');
+    }
+    /** @param {number} maxlength */
+    set maxlength(maxlength) {
+        if (!Number.isInteger(maxlength) || maxlength < 1)
+            throw new TypeError('TinyHtmlPasswordInput: "maxlength" must be a positive integer.');
+        this.setAttr('maxlength', maxlength);
+    }
+    /** @returns {number|null} */
+    get maxlength() {
+        return this.attrNumber('maxlength');
+    }
+    /** @param {string} pattern */
+    set pattern(pattern) {
+        if (typeof pattern !== 'string')
+            throw new TypeError('TinyHtmlPasswordInput: "pattern" must be a string.');
+        this.setAttr('pattern', pattern);
+    }
+    /** @returns {string|null} */
+    get pattern() {
+        return this.attrString('pattern');
+    }
+    /** @param {string} autocomplete */
+    set autocomplete(autocomplete) {
+        if (typeof autocomplete !== 'string')
+            throw new TypeError('TinyHtmlPasswordInput: "autocomplete" must be a string.');
+        this.setAttr('autocomplete', autocomplete);
+    }
+    /** @returns {string|null} */
+    get autocomplete() {
+        return this.attrString('autocomplete');
+    }
+}
+export default TinyHtmlPasswordInput;