tiny-essentials 1.24.0 → 1.24.1

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

@@ -0,0 +1,166 @@
+'use strict';
+
+var TinyHtmlInput = require('../../TinyHtmlInput.cjs');
+
+/**
+ * TinyHtmlUrlInput is a helper class for managing `<input type="url">` elements.
+ * It provides strongly-typed getters and setters for common attributes,
+ * with validation and error handling.
+ *
+ * @example
+ * const urlInput = new TinyHtmlUrlInput({
+ *   name: 'website',
+ *   placeholder: 'https://example.com',
+ *   required: true,
+ *   maxLength: 200,
+ * });
+ */
+class TinyHtmlUrlInput extends TinyHtmlInput {
+  /**
+   * Creates a new TinyHtmlUrlInput instance.
+   * @param {Object} config - Configuration object.
+   * @param {string} [config.value] - Initial value of the input.
+   * @param {number} [config.minLength] - Minimum number of characters.
+   * @param {number} [config.maxLength] - Maximum number of characters.
+   * @param {string} [config.name] - The name of the control.
+   * @param {string} [config.pattern] - Regex pattern for validation.
+   * @param {string} [config.autocomplete] - Autocomplete hint (e.g., "on", "off", "email").
+   * @param {string} [config.dirname] - Name for the directionality field (text-based inputs).
+   * @param {number} [config.size] - Width of the input in characters.
+   * @param {string} [config.list] - ID of an associated <datalist>.
+   * @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,
+    list,
+    placeholder,
+    autocomplete,
+    minLength,
+    maxLength,
+    readonly = false,
+    required = false,
+    dirname,
+    size,
+    pattern,
+    name,
+    tags = [],
+    mainClass = '',
+  } = {}) {
+    super({ name, placeholder, type: 'url', tags, mainClass });
+
+    // Assign attributes via setters for validation
+    if (value !== undefined) this.value = value;
+    if (list !== undefined) this.list = list;
+    if (placeholder !== undefined) this.placeholder = placeholder;
+    if (autocomplete !== undefined) this.autocomplete = autocomplete;
+    if (minLength !== undefined) this.minLength = minLength;
+    if (maxLength !== undefined) this.maxLength = maxLength;
+    if (readonly !== undefined) this.readonly = readonly;
+    if (required !== undefined) this.required = required;
+    if (dirname !== undefined) this.dirname = dirname;
+    if (size !== undefined) this.sizeEl = size;
+    if (pattern !== undefined) this.pattern = pattern;
+  }
+
+  /** @param {string} value */
+  set value(value) {
+    if (typeof value !== 'string')
+      throw new TypeError('TinyHtmlUrlInput: "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('TinyHtmlUrlInput: "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('TinyHtmlUrlInput: "maxLength" must be a positive integer.');
+    this.setAttr('maxlength', maxLength);
+  }
+
+  /** @returns {number|null} */
+  get maxLength() {
+    return this.attrNumber('maxlength');
+  }
+
+  /** @param {string} name */
+  set name(name) {
+    if (typeof name !== 'string') throw new TypeError('TinyHtmlUrlInput: "name" must be a string.');
+    this.setAttr('name', name);
+  }
+
+  /** @returns {string|null} */
+  get name() {
+    return this.attrString('name');
+  }
+
+  /** @param {string} pattern */
+  set pattern(pattern) {
+    if (typeof pattern !== 'string')
+      throw new TypeError('TinyHtmlUrlInput: "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('TinyHtmlUrlInput: "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('TinyHtmlUrlInput: "dirname" must be a string.');
+    this.setAttr('dirname', dirname);
+  }
+
+  /** @returns {string|null} */
+  get dirname() {
+    return this.attrString('dirname');
+  }
+
+  /** @param {string} list */
+  set list(list) {
+    if (typeof list !== 'string')
+      throw new TypeError('TinyHtmlUrlInput: "list" must be a string (datalist id).');
+    this.setAttr('list', list);
+  }
+
+  /** @returns {string|null} */
+  get list() {
+    return this.attrString('list');
+  }
+}
+
+module.exports = TinyHtmlUrlInput;

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

@@ -0,0 +1,81 @@
+export default TinyHtmlUrlInput;
+/**
+ * TinyHtmlUrlInput is a helper class for managing `<input type="url">` elements.
+ * It provides strongly-typed getters and setters for common attributes,
+ * with validation and error handling.
+ *
+ * @example
+ * const urlInput = new TinyHtmlUrlInput({
+ *   name: 'website',
+ *   placeholder: 'https://example.com',
+ *   required: true,
+ *   maxLength: 200,
+ * });
+ */
+declare class TinyHtmlUrlInput extends TinyHtmlInput {
+    /**
+     * Creates a new TinyHtmlUrlInput instance.
+     * @param {Object} config - Configuration object.
+     * @param {string} [config.value] - Initial value of the input.
+     * @param {number} [config.minLength] - Minimum number of characters.
+     * @param {number} [config.maxLength] - Maximum number of characters.
+     * @param {string} [config.name] - The name of the control.
+     * @param {string} [config.pattern] - Regex pattern for validation.
+     * @param {string} [config.autocomplete] - Autocomplete hint (e.g., "on", "off", "email").
+     * @param {string} [config.dirname] - Name for the directionality field (text-based inputs).
+     * @param {number} [config.size] - Width of the input in characters.
+     * @param {string} [config.list] - ID of an associated <datalist>.
+     * @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, list, placeholder, autocomplete, minLength, maxLength, readonly, required, dirname, size, pattern, name, tags, mainClass, }?: {
+        value?: string | undefined;
+        minLength?: number | undefined;
+        maxLength?: number | undefined;
+        name?: string | undefined;
+        pattern?: string | undefined;
+        autocomplete?: string | undefined;
+        dirname?: string | undefined;
+        size?: number | undefined;
+        list?: string | undefined;
+        readonly?: boolean | undefined;
+        required?: boolean | undefined;
+        placeholder?: string | undefined;
+        tags?: string | string[] | Set<string> | undefined;
+        mainClass?: string | undefined;
+    });
+    /** @param {string} value */
+    set value(value: string);
+    /** @returns {string} */
+    get value(): string;
+    /** @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 {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} dirname */
+    set dirname(dirname: string);
+    /** @returns {string|null} */
+    get dirname(): string | null;
+    /** @param {string} pattern */
+    set pattern(pattern: string);
+    /** @returns {string|null} */
+    get pattern(): string | null;
+}
+import TinyHtmlInput from '../../TinyHtmlInput.mjs';
+//# sourceMappingURL=TinyHtmlUrlInput.d.mts.map

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

@@ -0,0 +1,142 @@
+import TinyHtmlInput from '../../TinyHtmlInput.mjs';
+/**
+ * TinyHtmlUrlInput is a helper class for managing `<input type="url">` elements.
+ * It provides strongly-typed getters and setters for common attributes,
+ * with validation and error handling.
+ *
+ * @example
+ * const urlInput = new TinyHtmlUrlInput({
+ *   name: 'website',
+ *   placeholder: 'https://example.com',
+ *   required: true,
+ *   maxLength: 200,
+ * });
+ */
+class TinyHtmlUrlInput extends TinyHtmlInput {
+    /**
+     * Creates a new TinyHtmlUrlInput instance.
+     * @param {Object} config - Configuration object.
+     * @param {string} [config.value] - Initial value of the input.
+     * @param {number} [config.minLength] - Minimum number of characters.
+     * @param {number} [config.maxLength] - Maximum number of characters.
+     * @param {string} [config.name] - The name of the control.
+     * @param {string} [config.pattern] - Regex pattern for validation.
+     * @param {string} [config.autocomplete] - Autocomplete hint (e.g., "on", "off", "email").
+     * @param {string} [config.dirname] - Name for the directionality field (text-based inputs).
+     * @param {number} [config.size] - Width of the input in characters.
+     * @param {string} [config.list] - ID of an associated <datalist>.
+     * @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, list, placeholder, autocomplete, minLength, maxLength, readonly = false, required = false, dirname, size, pattern, name, tags = [], mainClass = '', } = {}) {
+        super({ name, placeholder, type: 'url', tags, mainClass });
+        // Assign attributes via setters for validation
+        if (value !== undefined)
+            this.value = value;
+        if (list !== undefined)
+            this.list = list;
+        if (placeholder !== undefined)
+            this.placeholder = placeholder;
+        if (autocomplete !== undefined)
+            this.autocomplete = autocomplete;
+        if (minLength !== undefined)
+            this.minLength = minLength;
+        if (maxLength !== undefined)
+            this.maxLength = maxLength;
+        if (readonly !== undefined)
+            this.readonly = readonly;
+        if (required !== undefined)
+            this.required = required;
+        if (dirname !== undefined)
+            this.dirname = dirname;
+        if (size !== undefined)
+            this.sizeEl = size;
+        if (pattern !== undefined)
+            this.pattern = pattern;
+    }
+    /** @param {string} value */
+    set value(value) {
+        if (typeof value !== 'string')
+            throw new TypeError('TinyHtmlUrlInput: "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('TinyHtmlUrlInput: "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('TinyHtmlUrlInput: "maxLength" must be a positive integer.');
+        this.setAttr('maxlength', maxLength);
+    }
+    /** @returns {number|null} */
+    get maxLength() {
+        return this.attrNumber('maxlength');
+    }
+    /** @param {string} name */
+    set name(name) {
+        if (typeof name !== 'string')
+            throw new TypeError('TinyHtmlUrlInput: "name" must be a string.');
+        this.setAttr('name', name);
+    }
+    /** @returns {string|null} */
+    get name() {
+        return this.attrString('name');
+    }
+    /** @param {string} pattern */
+    set pattern(pattern) {
+        if (typeof pattern !== 'string')
+            throw new TypeError('TinyHtmlUrlInput: "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('TinyHtmlUrlInput: "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('TinyHtmlUrlInput: "dirname" must be a string.');
+        this.setAttr('dirname', dirname);
+    }
+    /** @returns {string|null} */
+    get dirname() {
+        return this.attrString('dirname');
+    }
+    /** @param {string} list */
+    set list(list) {
+        if (typeof list !== 'string')
+            throw new TypeError('TinyHtmlUrlInput: "list" must be a string (datalist id).');
+        this.setAttr('list', list);
+    }
+    /** @returns {string|null} */
+    get list() {
+        return this.attrString('list');
+    }
+}
+export default TinyHtmlUrlInput;

package/dist/v1/libs/TinyHtml/media/TinyHtmlAudio.cjs

@@ -0,0 +1,135 @@
+'use strict';
+
+var TinyHtmlMedia = require('../TinyHtmlMedia.cjs');
+
+/**
+ * TinyHtmlAudio is a helper class for managing <audio> elements.
+ * It provides full support for standard audio attributes such as
+ * `src`, `preload`, `controls`, `autoplay`, `loop`, `muted`, and `volume`,
+ * using validated getters and setters for consistency.
+ *
+ * @example
+ * const audio = new TinyHtmlAudio({
+ *   src: 'music.mp3',
+ *   controls: true,
+ *   autoplay: false,
+ *   loop: true,
+ *   volume: 0.8
+ * });
+ *
+ * @extends TinyHtmlMedia<HTMLAudioElement>
+ */
+class TinyHtmlAudio extends TinyHtmlMedia {
+  /**
+   * Creates a new TinyHtmlAudio instance.
+   * @param {Object} config - Configuration object.
+   * @param {string} [config.src=""] - Audio source URL.
+   * @param {'auto'|'metadata'|'none'} [config.preload] - Preload behavior.
+   * @param {boolean} [config.controls=false] - Whether playback controls are displayed.
+   * @param {boolean} [config.autoplay=false] - Whether playback starts automatically.
+   * @param {boolean} [config.loop=false] - Whether playback should loop.
+   * @param {boolean} [config.muted=false] - Whether the audio starts muted.
+   * @param {number} [config.volume] - Initial playback volume (0.0 to 1.0).
+   * @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({
+    src = '',
+    preload,
+    controls = false,
+    autoplay = false,
+    loop = false,
+    muted = false,
+    volume,
+    tags = [],
+    mainClass = '',
+  } = {}) {
+    super(document.createElement('audio'), tags, mainClass);
+
+    this.src = src;
+    if (preload !== undefined) this.preload = preload;
+    this.controls = controls;
+    this.autoplay = autoplay;
+    this.loop = loop;
+    this.muted = muted;
+    if (volume !== undefined) this.volume = volume;
+  }
+
+  /** @param {string} src */
+  set src(src) {
+    if (typeof src !== 'string') throw new TypeError('TinyHtmlAudio: "src" must be a string.');
+    if (src) this.setAttr('src', src);
+    else this.removeAttr('src');
+  }
+
+  /** @returns {string|null} */
+  get src() {
+    return this.attrString('src');
+  }
+
+  /** @param {boolean} controls */
+  set controls(controls) {
+    if (typeof controls !== 'boolean')
+      throw new TypeError('TinyHtmlAudio: "controls" must be a boolean.');
+    if (controls) this.addProp('controls');
+    else this.removeProp('controls');
+  }
+
+  /** @returns {boolean} */
+  get controls() {
+    return this.hasProp('controls');
+  }
+
+  /** @param {boolean} autoplay */
+  set autoplay(autoplay) {
+    if (typeof autoplay !== 'boolean')
+      throw new TypeError('TinyHtmlAudio: "autoplay" must be a boolean.');
+    if (autoplay) this.addProp('autoplay');
+    else this.removeProp('autoplay');
+  }
+
+  /** @returns {boolean} */
+  get autoplay() {
+    return this.hasProp('autoplay');
+  }
+
+  /** @param {boolean} loop */
+  set loop(loop) {
+    if (typeof loop !== 'boolean') throw new TypeError('TinyHtmlAudio: "loop" must be a boolean.');
+    if (loop) this.addProp('loop');
+    else this.removeProp('loop');
+  }
+
+  /** @returns {boolean} */
+  get loop() {
+    return this.hasProp('loop');
+  }
+
+  /** @param {boolean} muted */
+  set muted(muted) {
+    if (typeof muted !== 'boolean')
+      throw new TypeError('TinyHtmlAudio: "muted" must be a boolean.');
+    if (muted) this.addProp('muted');
+    else this.removeProp('muted');
+  }
+
+  /** @returns {boolean} */
+  get muted() {
+    return this.hasProp('muted');
+  }
+
+  /** @param {number} volume */
+  set volume(volume) {
+    if (typeof volume !== 'number' || volume < 0 || volume > 1)
+      throw new TypeError('TinyHtmlAudio: "volume" must be a number between 0.0 and 1.0.');
+    this.el.volume = volume; // direct property on <audio>
+  }
+
+  /** @returns {number} */
+  get volume() {
+    return this.el.volume;
+  }
+}
+
+module.exports = TinyHtmlAudio;

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

@@ -0,0 +1,47 @@
+export default TinyHtmlAudio;
+/**
+ * TinyHtmlAudio is a helper class for managing <audio> elements.
+ * It provides full support for standard audio attributes such as
+ * `src`, `preload`, `controls`, `autoplay`, `loop`, `muted`, and `volume`,
+ * using validated getters and setters for consistency.
+ *
+ * @example
+ * const audio = new TinyHtmlAudio({
+ *   src: 'music.mp3',
+ *   controls: true,
+ *   autoplay: false,
+ *   loop: true,
+ *   volume: 0.8
+ * });
+ *
+ * @extends TinyHtmlMedia<HTMLAudioElement>
+ */
+declare class TinyHtmlAudio extends TinyHtmlMedia<HTMLAudioElement> {
+    /**
+     * Creates a new TinyHtmlAudio instance.
+     * @param {Object} config - Configuration object.
+     * @param {string} [config.src=""] - Audio source URL.
+     * @param {'auto'|'metadata'|'none'} [config.preload] - Preload behavior.
+     * @param {boolean} [config.controls=false] - Whether playback controls are displayed.
+     * @param {boolean} [config.autoplay=false] - Whether playback starts automatically.
+     * @param {boolean} [config.loop=false] - Whether playback should loop.
+     * @param {boolean} [config.muted=false] - Whether the audio starts muted.
+     * @param {number} [config.volume] - Initial playback volume (0.0 to 1.0).
+     * @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({ src, preload, controls, autoplay, loop, muted, volume, tags, mainClass, }?: {
+        src?: string | undefined;
+        preload?: "auto" | "none" | "metadata" | undefined;
+        controls?: boolean | undefined;
+        autoplay?: boolean | undefined;
+        loop?: boolean | undefined;
+        muted?: boolean | undefined;
+        volume?: number | undefined;
+        tags?: string | string[] | Set<string> | undefined;
+        mainClass?: string | undefined;
+    });
+}
+import TinyHtmlMedia from '../TinyHtmlMedia.mjs';
+//# sourceMappingURL=TinyHtmlAudio.d.mts.map

package/dist/v1/libs/TinyHtml/media/TinyHtmlAudio.mjs

@@ -0,0 +1,122 @@
+import TinyHtmlMedia from '../TinyHtmlMedia.mjs';
+/**
+ * TinyHtmlAudio is a helper class for managing <audio> elements.
+ * It provides full support for standard audio attributes such as
+ * `src`, `preload`, `controls`, `autoplay`, `loop`, `muted`, and `volume`,
+ * using validated getters and setters for consistency.
+ *
+ * @example
+ * const audio = new TinyHtmlAudio({
+ *   src: 'music.mp3',
+ *   controls: true,
+ *   autoplay: false,
+ *   loop: true,
+ *   volume: 0.8
+ * });
+ *
+ * @extends TinyHtmlMedia<HTMLAudioElement>
+ */
+class TinyHtmlAudio extends TinyHtmlMedia {
+    /**
+     * Creates a new TinyHtmlAudio instance.
+     * @param {Object} config - Configuration object.
+     * @param {string} [config.src=""] - Audio source URL.
+     * @param {'auto'|'metadata'|'none'} [config.preload] - Preload behavior.
+     * @param {boolean} [config.controls=false] - Whether playback controls are displayed.
+     * @param {boolean} [config.autoplay=false] - Whether playback starts automatically.
+     * @param {boolean} [config.loop=false] - Whether playback should loop.
+     * @param {boolean} [config.muted=false] - Whether the audio starts muted.
+     * @param {number} [config.volume] - Initial playback volume (0.0 to 1.0).
+     * @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({ src = '', preload, controls = false, autoplay = false, loop = false, muted = false, volume, tags = [], mainClass = '', } = {}) {
+        super(document.createElement('audio'), tags, mainClass);
+        this.src = src;
+        if (preload !== undefined)
+            this.preload = preload;
+        this.controls = controls;
+        this.autoplay = autoplay;
+        this.loop = loop;
+        this.muted = muted;
+        if (volume !== undefined)
+            this.volume = volume;
+    }
+    /** @param {string} src */
+    set src(src) {
+        if (typeof src !== 'string')
+            throw new TypeError('TinyHtmlAudio: "src" must be a string.');
+        if (src)
+            this.setAttr('src', src);
+        else
+            this.removeAttr('src');
+    }
+    /** @returns {string|null} */
+    get src() {
+        return this.attrString('src');
+    }
+    /** @param {boolean} controls */
+    set controls(controls) {
+        if (typeof controls !== 'boolean')
+            throw new TypeError('TinyHtmlAudio: "controls" must be a boolean.');
+        if (controls)
+            this.addProp('controls');
+        else
+            this.removeProp('controls');
+    }
+    /** @returns {boolean} */
+    get controls() {
+        return this.hasProp('controls');
+    }
+    /** @param {boolean} autoplay */
+    set autoplay(autoplay) {
+        if (typeof autoplay !== 'boolean')
+            throw new TypeError('TinyHtmlAudio: "autoplay" must be a boolean.');
+        if (autoplay)
+            this.addProp('autoplay');
+        else
+            this.removeProp('autoplay');
+    }
+    /** @returns {boolean} */
+    get autoplay() {
+        return this.hasProp('autoplay');
+    }
+    /** @param {boolean} loop */
+    set loop(loop) {
+        if (typeof loop !== 'boolean')
+            throw new TypeError('TinyHtmlAudio: "loop" must be a boolean.');
+        if (loop)
+            this.addProp('loop');
+        else
+            this.removeProp('loop');
+    }
+    /** @returns {boolean} */
+    get loop() {
+        return this.hasProp('loop');
+    }
+    /** @param {boolean} muted */
+    set muted(muted) {
+        if (typeof muted !== 'boolean')
+            throw new TypeError('TinyHtmlAudio: "muted" must be a boolean.');
+        if (muted)
+            this.addProp('muted');
+        else
+            this.removeProp('muted');
+    }
+    /** @returns {boolean} */
+    get muted() {
+        return this.hasProp('muted');
+    }
+    /** @param {number} volume */
+    set volume(volume) {
+        if (typeof volume !== 'number' || volume < 0 || volume > 1)
+            throw new TypeError('TinyHtmlAudio: "volume" must be a number between 0.0 and 1.0.');
+        this.el.volume = volume; // direct property on <audio>
+    }
+    /** @returns {number} */
+    get volume() {
+        return this.el.volume;
+    }
+}
+export default TinyHtmlAudio;