tiny-essentials 1.29.0 → 1.29.2

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

@@ -0,0 +1,138 @@
+/**
+ * @fileoverview Concrete loader for medias.
+ */
+import TinyMediaLoader from '../../TinyMediaLoader.mjs';
+export type VideoLoaderOptions<HTMLContentElement extends HTMLVideoElement | HTMLAudioElement> = {
+    /**
+     * - The media source URL.
+     */
+    src?: string;
+    /**
+     * - Maximum time in milliseconds before the load is aborted.
+     */
+    timeout?: number;
+    /**
+     * - The CORS mode applied to the media.
+     */
+    crossOrigin?: string | null;
+    /**
+     * - Whether the media should autoplay.
+     */
+    autoplay?: boolean;
+    /**
+     * - Whether the media should loop.
+     */
+    loop?: boolean;
+    /**
+     * - Whether the media should be muted.
+     */
+    muted?: boolean;
+    /**
+     * - Whether the media should display controls (default true).
+     */
+    controls?: boolean;
+    /**
+     * - The preload strategy.
+     */
+    preload?: 'none' | 'metadata' | 'auto';
+    /**
+     * - An existing DOM element to adopt.
+     */
+    element?: HTMLContentElement | 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 media through fetch for byte progress.
+     */
+    stream?: boolean;
+    /**
+     * - Whether to perform a HEAD request to fetch HTTP headers before downloading.
+     */
+    useHeadRequest?: boolean;
+    /**
+     * - The request body forwarded to the transport (ignored by `GET`/`HEAD`).
+     */
+    body?: BodyInit;
+    /**
+     * - An optional shared memory cache.
+     */
+    cache?: import('../../utils/TinyMediaCache.mjs').default | null;
+};
+export type MediaEarlyDecoder = import('../../TinyMediaLoader.mjs').MediaEarlyDecoder;
+export type TypesToTry = Record<string, string[]>;
+/**
+ * Base class for media loaders that support complex content types (audio and video)
+ * and optional Media Source Extensions (MSE) streaming.
+ * @extends {TinyMediaLoader<HTMLContentElement>}
+ * @template {HTMLVideoElement|HTMLAudioElement} HTMLContentElement
+ * @template {'video'|'audio'} Tag
+ * @beta
+ */
+declare class TinyContentLoader<HTMLContentElement extends HTMLVideoElement | HTMLAudioElement, Tag extends 'video' | 'audio'> extends TinyMediaLoader<HTMLContentElement> {
+    #private;
+    /**
+     * Initializes a content loader for a specific media tag and set of candidate MIME types.
+     * @param {Tag} tag - The HTML tag name (e.g., 'video' or 'audio').
+     * @param {TypesToTry} typesToTry - The mapping of format keys to candidate MIME types.
+     * @param {VideoLoaderOptions<HTMLContentElement>} [options] - The loader configuration.
+     * @throws {TypeError} If `crossOrigin` is not a string or null.
+     * @throws {TypeError} If `preload` is not a string.
+     */
+    constructor(tag: Tag, typesToTry: TypesToTry, options?: VideoLoaderOptions<HTMLContentElement>);
+    /**
+     * The underlying media element managed by the loader.
+     * @returns {HTMLContentElement|null} The element instance, or null before it is created.
+     */
+    get media(): HTMLContentElement | null;
+    /**
+     * Indicates whether the loader downloads the media through fetch for byte-level progress.
+     * @returns {boolean} `true` when streaming is enabled, otherwise `false`.
+     */
+    get stream(): boolean;
+    /**
+     * Orchestrates the initial load of the media, wiring up DOM events and initiating
+     * either a native load or a streamed fetch.
+     * @override
+     * @protected
+     * @returns {Promise<void>} A promise that resolves once the media is ready and playback can start.
+     */
+    protected _startLoad(): Promise<void>;
+    /**
+     * Extracts the metadata specific to content media (video/audio), such as
+     * dimensions and duration, to be merged into the final metadata object.
+     * @override
+     * @protected
+     * @returns {import('../../TinyMediaLoader.mjs').MediaMetadataDetails} The resolved metadata for the media.
+     */
+    protected _getMetadataDetails(): import('../../TinyMediaLoader.mjs').MediaMetadataDetails;
+    /**
+     * Creates the appropriate HTML media element based on the configured tag.
+     * @override
+     * @protected
+     * @returns {HTMLContentElement} A newly created HTMLAudioElement or HTMLVideoElement.
+     */
+    protected _createElement(): HTMLContentElement;
+    /**
+     * Aborts the media load and cleans up any active MSE object URLs to release memory.
+     * @override
+     * @protected
+     * @returns {void}
+     */
+    protected _abort(): void;
+    /**
+     * Releases MSE resources, revokes object URLs, and resets the media element
+     * to prevent memory leaks.
+     * @override
+     * @protected
+     * @returns {void} This method does not return a value.
+     */
+    protected _cleanup(): void;
+}
+export default TinyContentLoader;
+//# sourceMappingURL=TinyContentLoader.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TinyContentLoader.d.mts","sourceRoot":"","sources":["../../../../../../../src/v1/libs/html/loader/beta/formats/TinyContentLoader.mjs"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,eAAe,MAAM,2BAA2B,CAAC;AAMrD,YAAkB,kBAAkB,CADU,kBAAkB,SAArD,gBAAgB,GAAC,gBAAoC,IAEhE;;;;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;;;;IAAqC,OAAO,AAA5C,CACA,EADW,kBAAkB,GAAC,IAAI,CAClC;;;;IAAqB,WAAW,AAAhC,CACA,EADW,OAAO,CAClB;;;;IAAqB,UAAU,AAA/B,CACA,EADW,OAAO,CAClB;;;;IAAqB,MAAM,AAA3B,CACA,EADW,OAAO,CAClB;;;;IAAqB,cAAc,AAAnC,CACA,EADW,OAAO,CAClB;;;;IAAsB,IAAI,AAA1B,CACA,EADW,QAAQ,CACnB;;;;IAAmE,KAAK,AAAxE,CACF,EADa,OAAO,gCAAgC,EAAE,OAAO,GAAC,IAAI,CAClE;CAAA,CAAA;AAGE,YAAiE,iBAAiB,GAAxE,OAAO,2BAA2B,EAAE,iBAAiB,CAAmB;AAKlF,YAAoC,UAAU,GAApC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAY;AAmBjD;;;;;;;GAOG;AACH,cAAM,iBAAiB,CAJ0B,kBAAkB,SAArD,gBAAgB,GAAC,gBAAoC,EACpC,GAAG,SAApB,OAAO,GAAC,OAAY,CAGV,SAAQ,eAAe,CALlB,kBAAkB,CAKA;;IAwB7C;;;;;;;OAOG;IACH,YAAY,GAAG,EANJ,GAMI,EAAE,UAAU,EALhB,UAKgB,EAAE,OAAO,AAJjC,CACA,EADQ,kBAAkB,CAAC,kBAAkB,CAIP,EA2CxC;IAED;;;OAGG;IACH,IAAI,KAAK,IAFI,kBAAkB,GAAC,IAAI,CAInC;IAED;;;OAGG;IACH,IAAI,MAAM,IAFG,OAAO,CAInB;IAED;;;;;;OAMG;IACH,UAAM,UAAU,IAFH,OAAO,CAAC,IAAI,CAAC,CA6EzB;IAoUD;;;;;;OAMG;IACH,UAAA,mBAAmB,IAFN,OAAO,2BAA2B,EAAE,oBAAoB,CAapE;IAED;;;;;OAKG;IACH,UAAA,cAAc,IAFD,kBAAkB,CAK9B;IAED;;;;;OAKG;IACH,UAAA,MAAM,IAFO,IAAI,CAQhB;IAED;;;;;;OAMG;IACH,UAAA,QAAQ,IAFK,IAAI,CAchB;CACF;eAEc,iBAAiB"}