tiny-essentials 1.24.0 → 1.24.1

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

@@ -0,0 +1,100 @@
+'use strict';
+
+var TinyHtmlTemplate = require('../TinyHtmlTemplate.cjs');
+
+/**
+ * TinyHtmlObject is a lightweight helper class for managing <object> elements.
+ * It allows configuring attributes such as `data`, `type`, `form`, `height`, `width`, and `name`
+ * with built-in validation.
+ *
+ * @example
+ * const object = new TinyHtmlObject({
+ *   data: 'document.pdf',
+ *   type: 'application/pdf',
+ *   width: 800,
+ *   height: 600
+ * });
+ *
+ * @extends TinyHtmlTemplate<HTMLObjectElement>
+ */
+class TinyHtmlObject extends TinyHtmlTemplate {
+  /**
+   * Creates a new TinyHtmlObject instance.
+   *
+   * @param {Object} config - Configuration object.
+   * @param {string} [config.data=""] - The URL of the resource to embed.
+   * @param {string} [config.type=""] - The MIME type of the resource.
+   * @param {string} [config.form] - The ID of a <form> element in the same document.
+   * @param {number} [config.height] - Height of the displayed resource, in CSS pixels (positive integer).
+   * @param {number} [config.width] - Width of the displayed resource, in CSS pixels (positive integer).
+   * @param {string} [config.name] - Name of the browsing context or control.
+   * @param {string|string[]|Set<string>} [config.tags=[]] - Initial CSS classes.
+   * @param {string} [config.mainClass=""] - Main CSS class.
+   *
+   * @throws {Error} If neither `data` nor `type` is provided.
+   * @throws {TypeError} If any attribute is of the wrong type.
+   */
+  constructor({ data = '', type = '', form, height, width, name, tags = [], mainClass = '' } = {}) {
+    super(document.createElement('object'), tags, mainClass);
+
+    // At least one of "data" or "type" must be provided
+    if (!data && !type)
+      throw new Error('TinyHtmlObject: At least one of "data" or "type" must be provided.');
+
+    // --- Apply attributes if defined ---
+    if (data) this.elData = data;
+    if (type) this.type = type;
+    if (form !== undefined) this.form = form;
+    if (height !== undefined) this.height = height;
+    if (width !== undefined) this.width = width;
+    if (name !== undefined) this.name = name;
+  }
+
+  /** @param {string} data */
+  set elData(data) {
+    if (typeof data !== 'string') throw new TypeError('TinyHtmlObject: "data" must be a string.');
+    this.setAttr('data', data);
+  }
+
+  /** @returns {string|null} */
+  get elData() {
+    return this.attrString('data');
+  }
+
+  /** @param {string} type */
+  set type(type) {
+    if (typeof type !== 'string') throw new TypeError('TinyHtmlObject: "type" must be a string.');
+    this.setAttr('type', type);
+  }
+
+  /** @returns {string|null} */
+  get type() {
+    return this.attrString('type');
+  }
+
+  /** @param {string} form */
+  set form(form) {
+    if (typeof form !== 'string' || !form.trim())
+      throw new TypeError('TinyHtmlObject: "form" must be a non-empty string.');
+    this.setAttr('form', form);
+  }
+
+  /** @returns {string|null} */
+  get form() {
+    return this.attrString('form');
+  }
+
+  /** @param {string} name */
+  set name(name) {
+    if (typeof name !== 'string' || !name.trim())
+      throw new TypeError('TinyHtmlObject: "name" must be a non-empty string.');
+    this.setAttr('name', name);
+  }
+
+  /** @returns {string|null} */
+  get name() {
+    return this.attrString('name');
+  }
+}
+
+module.exports = TinyHtmlObject;

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

@@ -0,0 +1,62 @@
+export default TinyHtmlObject;
+/**
+ * TinyHtmlObject is a lightweight helper class for managing <object> elements.
+ * It allows configuring attributes such as `data`, `type`, `form`, `height`, `width`, and `name`
+ * with built-in validation.
+ *
+ * @example
+ * const object = new TinyHtmlObject({
+ *   data: 'document.pdf',
+ *   type: 'application/pdf',
+ *   width: 800,
+ *   height: 600
+ * });
+ *
+ * @extends TinyHtmlTemplate<HTMLObjectElement>
+ */
+declare class TinyHtmlObject extends TinyHtmlTemplate<HTMLObjectElement> {
+    /**
+     * Creates a new TinyHtmlObject instance.
+     *
+     * @param {Object} config - Configuration object.
+     * @param {string} [config.data=""] - The URL of the resource to embed.
+     * @param {string} [config.type=""] - The MIME type of the resource.
+     * @param {string} [config.form] - The ID of a <form> element in the same document.
+     * @param {number} [config.height] - Height of the displayed resource, in CSS pixels (positive integer).
+     * @param {number} [config.width] - Width of the displayed resource, in CSS pixels (positive integer).
+     * @param {string} [config.name] - Name of the browsing context or control.
+     * @param {string|string[]|Set<string>} [config.tags=[]] - Initial CSS classes.
+     * @param {string} [config.mainClass=""] - Main CSS class.
+     *
+     * @throws {Error} If neither `data` nor `type` is provided.
+     * @throws {TypeError} If any attribute is of the wrong type.
+     */
+    constructor({ data, type, form, height, width, name, tags, mainClass }?: {
+        data?: string | undefined;
+        type?: string | undefined;
+        form?: string | undefined;
+        height?: number | undefined;
+        width?: number | undefined;
+        name?: string | undefined;
+        tags?: string | string[] | Set<string> | undefined;
+        mainClass?: string | undefined;
+    });
+    /** @param {string} data */
+    set elData(data: string);
+    /** @returns {string|null} */
+    get elData(): string | null;
+    /** @param {string} type */
+    set type(type: string);
+    /** @returns {string|null} */
+    get type(): string | null;
+    /** @param {string} form */
+    set form(form: string);
+    /** @returns {string|null} */
+    get form(): string | null;
+    /** @param {string} name */
+    set name(name: string);
+    /** @returns {string|null} */
+    get name(): string | null;
+}
+import TinyHtmlTemplate from '../TinyHtmlTemplate.mjs';
+//# sourceMappingURL=TinyHtmlObject.d.mts.map

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

@@ -0,0 +1,94 @@
+import TinyHtmlTemplate from '../TinyHtmlTemplate.mjs';
+/**
+ * TinyHtmlObject is a lightweight helper class for managing <object> elements.
+ * It allows configuring attributes such as `data`, `type`, `form`, `height`, `width`, and `name`
+ * with built-in validation.
+ *
+ * @example
+ * const object = new TinyHtmlObject({
+ *   data: 'document.pdf',
+ *   type: 'application/pdf',
+ *   width: 800,
+ *   height: 600
+ * });
+ *
+ * @extends TinyHtmlTemplate<HTMLObjectElement>
+ */
+class TinyHtmlObject extends TinyHtmlTemplate {
+    /**
+     * Creates a new TinyHtmlObject instance.
+     *
+     * @param {Object} config - Configuration object.
+     * @param {string} [config.data=""] - The URL of the resource to embed.
+     * @param {string} [config.type=""] - The MIME type of the resource.
+     * @param {string} [config.form] - The ID of a <form> element in the same document.
+     * @param {number} [config.height] - Height of the displayed resource, in CSS pixels (positive integer).
+     * @param {number} [config.width] - Width of the displayed resource, in CSS pixels (positive integer).
+     * @param {string} [config.name] - Name of the browsing context or control.
+     * @param {string|string[]|Set<string>} [config.tags=[]] - Initial CSS classes.
+     * @param {string} [config.mainClass=""] - Main CSS class.
+     *
+     * @throws {Error} If neither `data` nor `type` is provided.
+     * @throws {TypeError} If any attribute is of the wrong type.
+     */
+    constructor({ data = '', type = '', form, height, width, name, tags = [], mainClass = '' } = {}) {
+        super(document.createElement('object'), tags, mainClass);
+        // At least one of "data" or "type" must be provided
+        if (!data && !type)
+            throw new Error('TinyHtmlObject: At least one of "data" or "type" must be provided.');
+        // --- Apply attributes if defined ---
+        if (data)
+            this.elData = data;
+        if (type)
+            this.type = type;
+        if (form !== undefined)
+            this.form = form;
+        if (height !== undefined)
+            this.height = height;
+        if (width !== undefined)
+            this.width = width;
+        if (name !== undefined)
+            this.name = name;
+    }
+    /** @param {string} data */
+    set elData(data) {
+        if (typeof data !== 'string')
+            throw new TypeError('TinyHtmlObject: "data" must be a string.');
+        this.setAttr('data', data);
+    }
+    /** @returns {string|null} */
+    get elData() {
+        return this.attrString('data');
+    }
+    /** @param {string} type */
+    set type(type) {
+        if (typeof type !== 'string')
+            throw new TypeError('TinyHtmlObject: "type" must be a string.');
+        this.setAttr('type', type);
+    }
+    /** @returns {string|null} */
+    get type() {
+        return this.attrString('type');
+    }
+    /** @param {string} form */
+    set form(form) {
+        if (typeof form !== 'string' || !form.trim())
+            throw new TypeError('TinyHtmlObject: "form" must be a non-empty string.');
+        this.setAttr('form', form);
+    }
+    /** @returns {string|null} */
+    get form() {
+        return this.attrString('form');
+    }
+    /** @param {string} name */
+    set name(name) {
+        if (typeof name !== 'string' || !name.trim())
+            throw new TypeError('TinyHtmlObject: "name" must be a non-empty string.');
+        this.setAttr('name', name);
+    }
+    /** @returns {string|null} */
+    get name() {
+        return this.attrString('name');
+    }
+}
+export default TinyHtmlObject;

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

@@ -0,0 +1,159 @@
+'use strict';
+
+var TinyHtmlTemplate = require('../TinyHtmlTemplate.cjs');
+
+/**
+ * TinyHtmlSource is a helper class for creating and validating <source> elements.
+ * The <source> tag has contextual rules depending on its parent:
+ *
+ * - If inside <audio> or <video>, `src` is required, and `srcset`, `sizes`, `height`, `width` are forbidden.
+ * - If inside <picture>, `srcset` is required, `sizes` is allowed, and `src` is forbidden.
+ *
+ * @example
+ * // For <video>
+ * const sourceVideo = new TinyHtmlSource({
+ *   src: 'movie.mp4',
+ *   type: 'video/mp4',
+ *   context: 'video'
+ * });
+ *
+ * // For <picture>
+ * const sourcePicture = new TinyHtmlSource({
+ *   srcset: 'image-200.jpg 200w, image-400.jpg 400w',
+ *   sizes: '(max-width: 600px) 200px, 400px',
+ *   type: 'image/jpeg',
+ *   context: 'picture'
+ * });
+ *
+ * @extends TinyHtmlTemplate<HTMLSourceElement>
+ */
+class TinyHtmlSource extends TinyHtmlTemplate {
+  /**
+   * Creates a new TinyHtmlSource instance.
+   * @param {Object} config - Configuration object.
+   * @param {string} [config.type] - MIME type (optionally with codecs).
+   * @param {string} [config.src] - Resource URL (required in audio/video, forbidden in picture).
+   * @param {string} [config.srcset] - Comma-separated list of image candidates (required in picture).
+   * @param {string} [config.sizes] - List of source sizes (only valid in picture with srcset).
+   * @param {string} [config.media] - Media query for conditional loading.
+   * @param {number} [config.height] - Intrinsic image height (only valid in picture).
+   * @param {number} [config.width] - Intrinsic image width (only valid in picture).
+   * @param {string|string[]|Set<string>} [config.tags=[]] - Initial CSS classes.
+   * @param {string} [config.mainClass=""] - Main CSS class.
+   * @param {"audio"|"video"|"picture"} [config.context] - Parent context type (used for validation).
+   * @throws {TypeError|Error} If attributes are invalid or violate context rules.
+   */
+  constructor({
+    type,
+    src,
+    srcset,
+    sizes,
+    media,
+    height,
+    width,
+    tags = [],
+    mainClass = '',
+    context,
+  } = {}) {
+    super(document.createElement('source'), tags, mainClass);
+
+    // Validate context
+    if (context !== undefined && !['audio', 'video', 'picture'].includes(context)) {
+      throw new Error(
+        `TinyHtmlSource: "context" must be "audio", "video", or "picture". Got: ${context}`,
+      );
+    }
+
+    // Context rules
+    if (context === 'audio' || context === 'video') {
+      if (!src) {
+        throw new Error(`TinyHtmlSource: "src" is required for <${context}> context.`);
+      }
+      if (
+        srcset !== undefined ||
+        sizes !== undefined ||
+        height !== undefined ||
+        width !== undefined
+      ) {
+        throw new Error(
+          `TinyHtmlSource: "srcset", "sizes", "height", and "width" are not allowed in <${context}> context.`,
+        );
+      }
+    }
+    if (context === 'picture') {
+      if (!srcset) {
+        throw new Error('TinyHtmlSource: "srcset" is required for <picture> context.');
+      }
+      if (src !== undefined) {
+        throw new Error('TinyHtmlSource: "src" is not allowed in <picture> context.');
+      }
+    }
+
+    // Assign attributes
+    if (type !== undefined) this.type = type;
+    if (src !== undefined) this.src = src;
+    if (srcset !== undefined) this.srcset = srcset;
+    if (sizes !== undefined) this.sizes = sizes;
+    if (media !== undefined) this.media = media;
+    if (height !== undefined) this.height = height;
+    if (width !== undefined) this.width = width;
+  }
+
+  /** @param {string} type */
+  set type(type) {
+    if (typeof type !== 'string') throw new TypeError('TinyHtmlSource: "type" must be a string.');
+    this.setAttr('type', type);
+  }
+
+  /** @returns {string|null} */
+  get type() {
+    return this.attrString('type');
+  }
+
+  /** @param {string} src */
+  set src(src) {
+    if (typeof src !== 'string') throw new TypeError('TinyHtmlSource: "src" must be a string.');
+    this.setAttr('src', src);
+  }
+
+  /** @returns {string|null} */
+  get src() {
+    return this.attrString('src');
+  }
+
+  /** @param {string} srcset */
+  set srcset(srcset) {
+    if (typeof srcset !== 'string')
+      throw new TypeError('TinyHtmlSource: "srcset" must be a string.');
+    this.setAttr('srcset', srcset);
+  }
+
+  /** @returns {string|null} */
+  get srcset() {
+    return this.attrString('srcset');
+  }
+
+  /** @param {string} sizes */
+  set sizes(sizes) {
+    if (typeof sizes !== 'string') throw new TypeError('TinyHtmlSource: "sizes" must be a string.');
+    this.setAttr('sizes', sizes);
+  }
+
+  /** @returns {string|null} */
+  get sizes() {
+    return this.attrString('sizes');
+  }
+
+  /** @param {string} media */
+  set media(media) {
+    if (typeof media !== 'string') throw new TypeError('TinyHtmlSource: "media" must be a string.');
+    this.setAttr('media', media);
+  }
+
+  /** @returns {string|null} */
+  get media() {
+    return this.attrString('media');
+  }
+}
+
+module.exports = TinyHtmlSource;

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

@@ -0,0 +1,77 @@
+export default TinyHtmlSource;
+/**
+ * TinyHtmlSource is a helper class for creating and validating <source> elements.
+ * The <source> tag has contextual rules depending on its parent:
+ *
+ * - If inside <audio> or <video>, `src` is required, and `srcset`, `sizes`, `height`, `width` are forbidden.
+ * - If inside <picture>, `srcset` is required, `sizes` is allowed, and `src` is forbidden.
+ *
+ * @example
+ * // For <video>
+ * const sourceVideo = new TinyHtmlSource({
+ *   src: 'movie.mp4',
+ *   type: 'video/mp4',
+ *   context: 'video'
+ * });
+ *
+ * // For <picture>
+ * const sourcePicture = new TinyHtmlSource({
+ *   srcset: 'image-200.jpg 200w, image-400.jpg 400w',
+ *   sizes: '(max-width: 600px) 200px, 400px',
+ *   type: 'image/jpeg',
+ *   context: 'picture'
+ * });
+ *
+ * @extends TinyHtmlTemplate<HTMLSourceElement>
+ */
+declare class TinyHtmlSource extends TinyHtmlTemplate<HTMLSourceElement> {
+    /**
+     * Creates a new TinyHtmlSource instance.
+     * @param {Object} config - Configuration object.
+     * @param {string} [config.type] - MIME type (optionally with codecs).
+     * @param {string} [config.src] - Resource URL (required in audio/video, forbidden in picture).
+     * @param {string} [config.srcset] - Comma-separated list of image candidates (required in picture).
+     * @param {string} [config.sizes] - List of source sizes (only valid in picture with srcset).
+     * @param {string} [config.media] - Media query for conditional loading.
+     * @param {number} [config.height] - Intrinsic image height (only valid in picture).
+     * @param {number} [config.width] - Intrinsic image width (only valid in picture).
+     * @param {string|string[]|Set<string>} [config.tags=[]] - Initial CSS classes.
+     * @param {string} [config.mainClass=""] - Main CSS class.
+     * @param {"audio"|"video"|"picture"} [config.context] - Parent context type (used for validation).
+     * @throws {TypeError|Error} If attributes are invalid or violate context rules.
+     */
+    constructor({ type, src, srcset, sizes, media, height, width, tags, mainClass, context, }?: {
+        type?: string | undefined;
+        src?: string | undefined;
+        srcset?: string | undefined;
+        sizes?: string | undefined;
+        media?: string | undefined;
+        height?: number | undefined;
+        width?: number | undefined;
+        tags?: string | string[] | Set<string> | undefined;
+        mainClass?: string | undefined;
+        context?: "audio" | "picture" | "video" | undefined;
+    });
+    /** @param {string} type */
+    set type(type: string);
+    /** @returns {string|null} */
+    get type(): string | null;
+    /** @param {string} src */
+    set src(src: string);
+    /** @returns {string|null} */
+    get src(): string | null;
+    /** @param {string} srcset */
+    set srcset(srcset: string);
+    /** @returns {string|null} */
+    get srcset(): string | null;
+    /** @param {string} sizes */
+    set sizes(sizes: string);
+    /** @returns {string|null} */
+    get sizes(): string | null;
+    /** @param {string} media */
+    set media(media: string);
+    /** @returns {string|null} */
+    get media(): string | null;
+}
+import TinyHtmlTemplate from '../TinyHtmlTemplate.mjs';
+//# sourceMappingURL=TinyHtmlSource.d.mts.map

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

@@ -0,0 +1,136 @@
+import TinyHtmlTemplate from '../TinyHtmlTemplate.mjs';
+/**
+ * TinyHtmlSource is a helper class for creating and validating <source> elements.
+ * The <source> tag has contextual rules depending on its parent:
+ *
+ * - If inside <audio> or <video>, `src` is required, and `srcset`, `sizes`, `height`, `width` are forbidden.
+ * - If inside <picture>, `srcset` is required, `sizes` is allowed, and `src` is forbidden.
+ *
+ * @example
+ * // For <video>
+ * const sourceVideo = new TinyHtmlSource({
+ *   src: 'movie.mp4',
+ *   type: 'video/mp4',
+ *   context: 'video'
+ * });
+ *
+ * // For <picture>
+ * const sourcePicture = new TinyHtmlSource({
+ *   srcset: 'image-200.jpg 200w, image-400.jpg 400w',
+ *   sizes: '(max-width: 600px) 200px, 400px',
+ *   type: 'image/jpeg',
+ *   context: 'picture'
+ * });
+ *
+ * @extends TinyHtmlTemplate<HTMLSourceElement>
+ */
+class TinyHtmlSource extends TinyHtmlTemplate {
+    /**
+     * Creates a new TinyHtmlSource instance.
+     * @param {Object} config - Configuration object.
+     * @param {string} [config.type] - MIME type (optionally with codecs).
+     * @param {string} [config.src] - Resource URL (required in audio/video, forbidden in picture).
+     * @param {string} [config.srcset] - Comma-separated list of image candidates (required in picture).
+     * @param {string} [config.sizes] - List of source sizes (only valid in picture with srcset).
+     * @param {string} [config.media] - Media query for conditional loading.
+     * @param {number} [config.height] - Intrinsic image height (only valid in picture).
+     * @param {number} [config.width] - Intrinsic image width (only valid in picture).
+     * @param {string|string[]|Set<string>} [config.tags=[]] - Initial CSS classes.
+     * @param {string} [config.mainClass=""] - Main CSS class.
+     * @param {"audio"|"video"|"picture"} [config.context] - Parent context type (used for validation).
+     * @throws {TypeError|Error} If attributes are invalid or violate context rules.
+     */
+    constructor({ type, src, srcset, sizes, media, height, width, tags = [], mainClass = '', context, } = {}) {
+        super(document.createElement('source'), tags, mainClass);
+        // Validate context
+        if (context !== undefined && !['audio', 'video', 'picture'].includes(context)) {
+            throw new Error(`TinyHtmlSource: "context" must be "audio", "video", or "picture". Got: ${context}`);
+        }
+        // Context rules
+        if (context === 'audio' || context === 'video') {
+            if (!src) {
+                throw new Error(`TinyHtmlSource: "src" is required for <${context}> context.`);
+            }
+            if (srcset !== undefined ||
+                sizes !== undefined ||
+                height !== undefined ||
+                width !== undefined) {
+                throw new Error(`TinyHtmlSource: "srcset", "sizes", "height", and "width" are not allowed in <${context}> context.`);
+            }
+        }
+        if (context === 'picture') {
+            if (!srcset) {
+                throw new Error('TinyHtmlSource: "srcset" is required for <picture> context.');
+            }
+            if (src !== undefined) {
+                throw new Error('TinyHtmlSource: "src" is not allowed in <picture> context.');
+            }
+        }
+        // Assign attributes
+        if (type !== undefined)
+            this.type = type;
+        if (src !== undefined)
+            this.src = src;
+        if (srcset !== undefined)
+            this.srcset = srcset;
+        if (sizes !== undefined)
+            this.sizes = sizes;
+        if (media !== undefined)
+            this.media = media;
+        if (height !== undefined)
+            this.height = height;
+        if (width !== undefined)
+            this.width = width;
+    }
+    /** @param {string} type */
+    set type(type) {
+        if (typeof type !== 'string')
+            throw new TypeError('TinyHtmlSource: "type" must be a string.');
+        this.setAttr('type', type);
+    }
+    /** @returns {string|null} */
+    get type() {
+        return this.attrString('type');
+    }
+    /** @param {string} src */
+    set src(src) {
+        if (typeof src !== 'string')
+            throw new TypeError('TinyHtmlSource: "src" must be a string.');
+        this.setAttr('src', src);
+    }
+    /** @returns {string|null} */
+    get src() {
+        return this.attrString('src');
+    }
+    /** @param {string} srcset */
+    set srcset(srcset) {
+        if (typeof srcset !== 'string')
+            throw new TypeError('TinyHtmlSource: "srcset" must be a string.');
+        this.setAttr('srcset', srcset);
+    }
+    /** @returns {string|null} */
+    get srcset() {
+        return this.attrString('srcset');
+    }
+    /** @param {string} sizes */
+    set sizes(sizes) {
+        if (typeof sizes !== 'string')
+            throw new TypeError('TinyHtmlSource: "sizes" must be a string.');
+        this.setAttr('sizes', sizes);
+    }
+    /** @returns {string|null} */
+    get sizes() {
+        return this.attrString('sizes');
+    }
+    /** @param {string} media */
+    set media(media) {
+        if (typeof media !== 'string')
+            throw new TypeError('TinyHtmlSource: "media" must be a string.');
+        this.setAttr('media', media);
+    }
+    /** @returns {string|null} */
+    get media() {
+        return this.attrString('media');
+    }
+}
+export default TinyHtmlSource;