tiny-essentials 1.29.1 → 1.29.2

package/dist/v1/libs/html/loader/beta/formats/TinyVideoLoader.d.mts

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview Concrete loader for videos.
+ */
+import TinyContentLoader from './TinyContentLoader.mjs';
+export type VideoLoaderOptions = {
+    /**
+     * - The video source URL.
+     */
+    src?: string;
+    /**
+     * - Maximum time in milliseconds before the load is aborted.
+     */
+    timeout?: number;
+    /**
+     * - The CORS mode applied to the video.
+     */
+    crossOrigin?: string | null;
+    /**
+     * - Whether the video should autoplay.
+     */
+    autoplay?: boolean;
+    /**
+     * - Whether the video should loop.
+     */
+    loop?: boolean;
+    /**
+     * - Whether the video should be muted.
+     */
+    muted?: boolean;
+    /**
+     * - Whether the video should display controls (default true).
+     */
+    controls?: boolean;
+    /**
+     * - The preload strategy.
+     */
+    preload?: 'none' | 'metadata' | 'auto';
+    /**
+     * - An existing DOM element to adopt.
+     */
+    element?: HTMLVideoElement | null;
+    /**
+     * - Whether to render progressively during fetch (default true).
+     */
+    progressive?: boolean;
+    /**
+     * - Whether an external `src` change triggers a reload.
+     */
+    autoReload?: boolean;
+    /**
+     * - Whether to download the video through fetch for byte progress.
+     */
+    stream?: boolean;
+    /**
+     * - An optional shared memory cache.
+     */
+    cache?: import('../../utils/TinyMediaCache.mjs').default | null;
+};
+/**
+ * @typedef {Object} VideoLoaderOptions
+ * @property {string} [src] - The video source URL.
+ * @property {number} [timeout] - Maximum time in milliseconds before the load is aborted.
+ * @property {string|null} [crossOrigin] - The CORS mode applied to the video.
+ * @property {boolean} [autoplay] - Whether the video should autoplay.
+ * @property {boolean} [loop] - Whether the video should loop.
+ * @property {boolean} [muted] - Whether the video should be muted.
+ * @property {boolean} [controls] - Whether the video should display controls (default true).
+ * @property {'none'|'metadata'|'auto'} [preload] - The preload strategy.
+ * @property {HTMLVideoElement|null} [element] - An existing DOM element to adopt.
+ * @property {boolean} [progressive] - Whether to render progressively during fetch (default true).
+ * @property {boolean} [autoReload] - Whether an external `src` change triggers a reload.
+ * @property {boolean} [stream] - Whether to download the video through fetch for byte progress.
+ * @property {import('../../utils/TinyMediaCache.mjs').default|null} [cache] - An optional shared memory cache.
+ */
+/**
+ * Loads a single video with full lifecycle control.
+ * @extends {TinyContentLoader<HTMLVideoElement, 'video'>}
+ * @beta
+ */
+declare class TinyVideoLoader extends TinyContentLoader<HTMLVideoElement, 'video'> {
+    /**
+     * Retrieves the uppercase tag name of the element this loader creates.
+     * @returns {string} The uppercase tag name of the underlying media element.
+     */
+    static get tagName(): string;
+    /**
+     * Creates a new video loader and validates the provided options.
+     * @param {VideoLoaderOptions} [options] - The loader configuration.
+     * @throws {TypeError} If `crossOrigin` is not a string or null.
+     * @throws {TypeError} If `preload` is not a string.
+     */
+    constructor(options?: VideoLoaderOptions);
+    /**
+     * The underlying `<video>` element managed by the loader.
+     * @returns {HTMLVideoElement|null} The underlying `<video>` element, or null before the load starts.
+     */
+    get video(): HTMLVideoElement | null;
+}
+export default TinyVideoLoader;
+//# sourceMappingURL=TinyVideoLoader.d.mts.map

package/dist/v1/libs/html/loader/beta/formats/TinyVideoLoader.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TinyVideoLoader.d.mts","sourceRoot":"","sources":["../../../../../../../src/v1/libs/html/loader/beta/formats/TinyVideoLoader.mjs"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,iBAAiB,MAAM,yBAAyB,CAAC;AAGrD,YAAkB,kBAAkB,GACpC;;;;IAAoB,GAAG,AAAvB,CACA,EADW,MAAM,CACjB;;;;IAAoB,OAAO,AAA3B,CACA,EADW,MAAM,CACjB;;;;IAAyB,WAAW,AAApC,CACA,EADW,MAAM,GAAC,IAAI,CACtB;;;;IAAqB,QAAQ,AAA7B,CACA,EADW,OAAO,CAClB;;;;IAAqB,IAAI,AAAzB,CACA,EADW,OAAO,CAClB;;;;IAAqB,KAAK,AAA1B,CACA,EADW,OAAO,CAClB;;;;IAAqB,QAAQ,AAA7B,CACA,EADW,OAAO,CAClB;;;;IAAsC,OAAO,AAA7C,CACA,EADW,MAAM,GAAC,UAAU,GAAC,MAAM,CACnC;;;;IAAmC,OAAO,AAA1C,CACA,EADW,gBAAgB,GAAC,IAAI,CAChC;;;;IAAqB,WAAW,AAAhC,CACA,EADW,OAAO,CAClB;;;;IAAqB,UAAU,AAA/B,CACA,EADW,OAAO,CAClB;;;;IAAqB,MAAM,AAA3B,CACA,EADW,OAAO,CAClB;;;;IAAmE,KAAK,AAAxE,CACF,EADa,OAAO,gCAAgC,EAAE,OAAO,GAAC,IAAI,CAClE;CAAA,CAAA;AAfD;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AACH,cAAM,eAAgB,SAAQ,iBAAiB,CAHhB,gBAAgB,EAAE,OAAO,CAGT;IAC7C;;;OAGG;IACH,MAAM,KAAK,OAAO,IAFL,MAAM,CAIlB;IAED;;;;;OAKG;IACH,YAAY,OAAO,AAJhB,CACA,EADQ,kBAIa,EAavB;IAED;;;OAGG;IACH,IAAI,KAAK,IAFI,gBAAgB,GAAC,IAAI,CAIjC;CACF;eAEc,eAAe"}

package/dist/v1/libs/html/loader/beta/formats/TinyVideoLoader.mjs

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview Concrete loader for videos.
+ */
+import TinyContentLoader from './TinyContentLoader.mjs';
+/**
+ * @typedef {Object} VideoLoaderOptions
+ * @property {string} [src] - The video source URL.
+ * @property {number} [timeout] - Maximum time in milliseconds before the load is aborted.
+ * @property {string|null} [crossOrigin] - The CORS mode applied to the video.
+ * @property {boolean} [autoplay] - Whether the video should autoplay.
+ * @property {boolean} [loop] - Whether the video should loop.
+ * @property {boolean} [muted] - Whether the video should be muted.
+ * @property {boolean} [controls] - Whether the video should display controls (default true).
+ * @property {'none'|'metadata'|'auto'} [preload] - The preload strategy.
+ * @property {HTMLVideoElement|null} [element] - An existing DOM element to adopt.
+ * @property {boolean} [progressive] - Whether to render progressively during fetch (default true).
+ * @property {boolean} [autoReload] - Whether an external `src` change triggers a reload.
+ * @property {boolean} [stream] - Whether to download the video through fetch for byte progress.
+ * @property {import('../../utils/TinyMediaCache.mjs').default|null} [cache] - An optional shared memory cache.
+ */
+/**
+ * Loads a single video with full lifecycle control.
+ * @extends {TinyContentLoader<HTMLVideoElement, 'video'>}
+ * @beta
+ */
+class TinyVideoLoader extends TinyContentLoader {
+    /**
+     * Retrieves the uppercase tag name of the element this loader creates.
+     * @returns {string} The uppercase tag name of the underlying media element.
+     */
+    static get tagName() {
+        return 'VIDEO';
+    }
+    /**
+     * Creates a new video loader and validates the provided options.
+     * @param {VideoLoaderOptions} [options] - The loader configuration.
+     * @throws {TypeError} If `crossOrigin` is not a string or null.
+     * @throws {TypeError} If `preload` is not a string.
+     */
+    constructor(options = {}) {
+        if (options.element !== null &&
+            options.element !== undefined &&
+            !(options.element instanceof HTMLVideoElement)) {
+            throw new TypeError('The "element" option must be an HTMLVideoElement or null.');
+        }
+        const mimeType = {
+            mp4: ['{mime}; codecs="avc1.42E01E, mp4a.40.2"', '{mime}; codecs="avc1.640028, mp4a.40.2"'],
+            webm: ['{mime}; codecs="vp9, opus"', '{mime}; codecs="vp8, vorbis"'],
+        };
+        super('video', mimeType, options);
+    }
+    /**
+     * The underlying `<video>` element managed by the loader.
+     * @returns {HTMLVideoElement|null} The underlying `<video>` element, or null before the load starts.
+     */
+    get video() {
+        return this.media;
+    }
+}
+export default TinyVideoLoader;