tiny-essentials 1.29.0 → 1.29.2

package/dist/v1/libs/html/loader/probe/TinyImageProbe.d.mts

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview Probes the intrinsic dimensions of an image by parsing its
+ * container header. For animated formats, it retains the buffer to extract
+ * full animation data (frames, loops, and duration) upon finalization.
+ *
+ * Supported Web formats: PNG (incl. APNG), JPEG, GIF, WebP, BMP, ICO, CUR, AVIF, and SVG.
+ */
+import TinyBufferReader from '../utils/TinyBufferReader.mjs';
+export type AnimationProbeData = {
+    /**
+     * - Total number of frames.
+     */
+    frames: number;
+    /**
+     * - Number of times to loop (0 usually means infinite).
+     */
+    loopCount: number;
+    /**
+     * - Total duration of the animation in milliseconds.
+     */
+    duration: number;
+};
+export type ImageProbeSize = {
+    /**
+     * - The display width in pixels.
+     */
+    width: number;
+    /**
+     * - The display height in pixels.
+     */
+    height: number;
+    /**
+     * - The animation data.
+     */
+    animation?: AnimationProbeData;
+};
+export type ImageFormat = {
+    /**
+     * - The format identifier.
+     */
+    name: string;
+    /**
+     * - The canonical MIME type.
+     */
+    mime: string;
+    /**
+     * - A function that tests if the provided bytes match the format's signature.
+     */
+    sniff: (bytes: Uint8Array) => boolean;
+    /**
+     * - A function that parses the container to extract image dimensions.
+     */
+    parse: (reader: TinyBufferReader) => ImageProbeSize | null;
+};
+/**
+ * Reads the intrinsic dimensions and animation frames of a web image from its container header.
+ */
+declare class TinyImageProbe {
+    #private;
+    finalize(): {
+        animation: AnimationProbeData;
+    } | null;
+    /**
+     * @param {string} [type] - The MIME type from the response headers. Unused, kept for API compatibility.
+     * @param {number} [maxBytes] - The maximum number of header bytes to buffer.
+     * @throws {RangeError} If `maxBytes` is not a positive number.
+     */
+    constructor(type?: string, maxBytes?: number);
+    /**
+     * Appends a chunk and returns the dimensions once they are known.
+     * @param {Uint8Array} chunk - The bytes received so far.
+     * @returns {ImageProbeSize|null} The dimensions, or null when more data is needed.
+     * @throws {TypeError} If `chunk` is not a Uint8Array.
+     */
+    push(chunk: Uint8Array): ImageProbeSize | null;
+    /**
+     * Releases the buffered header.
+     * @returns {void}
+     */
+    close(): void;
+}
+export default TinyImageProbe;
+//# sourceMappingURL=TinyImageProbe.d.mts.map

package/dist/v1/libs/html/loader/probe/TinyImageProbe.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TinyImageProbe.d.mts","sourceRoot":"","sources":["../../../../../../src/v1/libs/html/loader/probe/TinyImageProbe.mjs"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,gBAAsC,MAAM,+BAA+B,CAAC;AAKhF,YAAkB,kBAAkB,GACpC;;;;IAAmB,MAAM,EAAd,MAAM,CACjB;;;;IAAmB,SAAS,EAAjB,MAAM,CACjB;;;;IAAmB,QAAQ,EAAhB,MAAM,CACnB;CAAA,CAAA;AAIE,YAAkB,cAAc,GAChC;;;;IAAmB,KAAK,EAAb,MAAM,CACjB;;;;IAAmB,MAAM,EAAd,MAAM,CACjB;;;;IAAgC,SAAS,AAAzC,CACF,EADa,kBAAkB,CAC/B;CAAA,CAAA;AAIE,YAAkB,WAAW,GAC7B;;;;IAAmB,IAAI,EAAZ,MAAM,CACjB;;;;IAAmB,IAAI,EAAZ,MAAM,CACjB;;;;IAA2C,KAAK,EAArC,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CACzC;;;;IAAgE,KAAK,EAA1D,CAAC,MAAM,EAAE,gBAAgB,KAAK,cAAc,GAAG,IAAI,CAChE;CAAA,CAAA;AA4dD;;GAEG;AACH,cAAM,cAAc;;IAoBlB,QAAQ;;aAOP;IAED;;;;OAIG;IACH,YAAY,IAAI,AAJb,CACA,EADQ,MAIU,EAAE,QAAQ,AAH5B,CACA,EADQ,MAGuC,EAKjD;IAcD;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAJC,UAID,GAHG,cAAc,GAAC,IAAI,CAsE/B;IAED;;;OAGG;IACH,KAAK,IAFQ,IAAI,CAKhB;CAeF;eAEc,cAAc"}