tiny-essentials 1.29.1 → 1.29.2

package/dist/v1/libs/html/loader/utils/TinyIsoBox.cjs

@@ -0,0 +1,128 @@
+'use strict';
+
+var TinyBufferReader = require('./TinyBufferReader.cjs');
+
+/**
+ * @fileoverview ISO base media file format (ISO/IEC 14496-12) box utilities.
+ * Shared by the image and video probes, since HEIC, AVIF, MP4 and MOV all
+ * use the same box tree.
+ */
+
+/**
+ * Represents a parsed ISO BMFF box header.
+ * @typedef {Object} IsoBox
+ * @property {string} type - The 4-character box type.
+ * @property {number} start - The offset of the first header byte.
+ * @property {number} dataStart - The offset of the first payload byte.
+ * @property {number} dataEnd - The offset after the last payload byte.
+ * @property {number} end - The offset after the box.
+ */
+
+/**
+ * The boxes whose payload is a plain list of child boxes.
+ * @type {ReadonlySet<string>}
+ */
+const CONTAINERS = new Set([
+  'moov',
+  'trak',
+  'mdia',
+  'minf',
+  'stbl',
+  'edts',
+  'dinf',
+  'udta',
+  'mvex',
+  'moof',
+  'traf',
+  'iprp',
+  'ipco',
+  'mfra',
+  'skip',
+  'jxl ',
+]);
+
+/**
+ * The boxes that start with a 4-byte version/flag field before their children.
+ * @type {ReadonlySet<string>}
+ */
+const FULL_BOX_CONTAINERS = new Set(['meta']);
+
+/**
+ * Reads the header of the box starting at the current reader offset.
+ * @param {import('./TinyBufferReader.mjs').default} reader - The binary cursor used for reading.
+ * @param {number} end - The absolute offset marking the end of the readable buffer.
+ * @returns {IsoBox} The parsed box header containing metadata about the box.
+ * @throws {TinyNeedMoreData} If the buffer is truncated and cannot provide the full header or payload size.
+ */
+function readBox(reader, end) {
+  const start = reader.offset;
+  const size = reader.uint32();
+  const type = reader.ascii(4);
+  let headerSize = 8;
+  let total = size;
+  if (size === 1) {
+    total = reader.uint64();
+    headerSize = 16;
+  } else if (size === 0) {
+    total = end - start;
+  }
+  if (total < headerSize || start + total > end) {
+    throw new TinyBufferReader.TinyNeedMoreData();
+  }
+  return {
+    type,
+    start,
+    dataStart: start + headerSize,
+    dataEnd: start + total,
+    end: start + total,
+  };
+}
+
+/**
+ * A generator that iterates over all sibling boxes within the specified byte range.
+ * @param {import('./TinyBufferReader.mjs').default} reader - The binary cursor used for reading.
+ * @param {number} start - The absolute offset where the sequence of boxes begins.
+ * @param {number} end - The absolute offset marking the end of the range.
+ * @yields {IsoBox} Every complete ISO box found in the specified range.
+ */
+function* boxes(reader, start, end) {
+  let cursor = start;
+  while (cursor + 8 <= end) {
+    reader.seek(cursor);
+    const box = readBox(reader, end);
+    yield box;
+    cursor = box.end;
+  }
+}
+
+/**
+ * Recursively searches through the box tree for the first box that matches one of the specified types.
+ * @param {import('./TinyBufferReader.mjs').default} reader - The binary cursor used for reading.
+ * @param {number} start - The absolute offset where the search begins.
+ * @param {number} end - The absolute offset marking the end of the search range.
+ * @param {ReadonlySet<string>} types - A set of 4-character box types to match against.
+ * @param {number} [depth] - The current recursion depth, used to prevent infinite loops or stack overflows.
+ * @returns {IsoBox|null} The first matching box header found, or null if no match exists within the range.
+ */
+function findBox(reader, start, end, types, depth = 0) {
+  if (depth > 8) {
+    return null;
+  }
+  for (const box of boxes(reader, start, end)) {
+    if (types.has(box.type)) {
+      return box;
+    }
+    if (CONTAINERS.has(box.type) || FULL_BOX_CONTAINERS.has(box.type)) {
+      const skip = FULL_BOX_CONTAINERS.has(box.type) ? 4 : 0;
+      const found = findBox(reader, box.dataStart + skip, box.dataEnd, types, depth + 1);
+      if (found) {
+        return found;
+      }
+    }
+  }
+  return null;
+}
+
+exports.boxes = boxes;
+exports.findBox = findBox;
+exports.readBox = readBox;

package/dist/v1/libs/html/loader/utils/TinyIsoBox.d.mts

@@ -0,0 +1,49 @@
+export type IsoBox = {
+    /**
+     * - The 4-character box type.
+     */
+    type: string;
+    /**
+     * - The offset of the first header byte.
+     */
+    start: number;
+    /**
+     * - The offset of the first payload byte.
+     */
+    dataStart: number;
+    /**
+     * - The offset after the last payload byte.
+     */
+    dataEnd: number;
+    /**
+     * - The offset after the box.
+     */
+    end: number;
+};
+/**
+ * Reads the header of the box starting at the current reader offset.
+ * @param {import('./TinyBufferReader.mjs').default} reader - The binary cursor used for reading.
+ * @param {number} end - The absolute offset marking the end of the readable buffer.
+ * @returns {IsoBox} The parsed box header containing metadata about the box.
+ * @throws {TinyNeedMoreData} If the buffer is truncated and cannot provide the full header or payload size.
+ */
+export declare function readBox(reader: import('./TinyBufferReader.mjs').default, end: number): IsoBox;
+/**
+ * A generator that iterates over all sibling boxes within the specified byte range.
+ * @param {import('./TinyBufferReader.mjs').default} reader - The binary cursor used for reading.
+ * @param {number} start - The absolute offset where the sequence of boxes begins.
+ * @param {number} end - The absolute offset marking the end of the range.
+ * @yields {IsoBox} Every complete ISO box found in the specified range.
+ */
+export declare function boxes(reader: import('./TinyBufferReader.mjs').default, start: number, end: number): Generator<IsoBox, void, unknown>;
+/**
+ * Recursively searches through the box tree for the first box that matches one of the specified types.
+ * @param {import('./TinyBufferReader.mjs').default} reader - The binary cursor used for reading.
+ * @param {number} start - The absolute offset where the search begins.
+ * @param {number} end - The absolute offset marking the end of the search range.
+ * @param {ReadonlySet<string>} types - A set of 4-character box types to match against.
+ * @param {number} [depth] - The current recursion depth, used to prevent infinite loops or stack overflows.
+ * @returns {IsoBox|null} The first matching box header found, or null if no match exists within the range.
+ */
+export declare function findBox(reader: import('./TinyBufferReader.mjs').default, start: number, end: number, types: ReadonlySet<string>, depth?: number): IsoBox | null;
+//# sourceMappingURL=TinyIsoBox.d.mts.map

package/dist/v1/libs/html/loader/utils/TinyIsoBox.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TinyIsoBox.d.mts","sourceRoot":"","sources":["../../../../../../src/v1/libs/html/loader/utils/TinyIsoBox.mjs"],"names":[],"mappings":"AASG,YAAkB,MAAM,GACxB;;;;IAAmB,IAAI,EAAZ,MAAM,CACjB;;;;IAAmB,KAAK,EAAb,MAAM,CACjB;;;;IAAmB,SAAS,EAAjB,MAAM,CACjB;;;;IAAmB,OAAO,EAAf,MAAM,CACjB;;;;IAAmB,GAAG,EAAX,MAAM,CACnB;CAAA,CAAA;AA+BD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,MAAM,EALnB,OAAO,wBAAwB,EAAE,OAKd,EAAE,GAAG,EAJxB,MAIwB,GAHtB,MAAM,CAyBlB;AAED;;;;;;GAMG;AACH,wBAAiB,KAAK,CAAC,MAAM,EALlB,OAAO,wBAAwB,EAAE,OAKf,EAAE,KAAK,EAJzB,MAIyB,EAAE,GAAG,EAH9B,MAG8B,oCAQxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAPnB,OAAO,wBAAwB,EAAE,OAOd,EAAE,KAAK,EAN1B,MAM0B,EAAE,GAAG,EAL/B,MAK+B,EAAE,KAAK,EAJtC,WAAW,CAAC,MAAM,CAIoB,EAAE,KAAK,AAHrD,CACA,EADQ,MAGiD,GAF/C,MAAM,GAAC,IAAI,CAmBvB"}

package/dist/v1/libs/html/loader/utils/TinyIsoBox.mjs

@@ -0,0 +1,116 @@
+/**
+ * @fileoverview ISO base media file format (ISO/IEC 14496-12) box utilities.
+ * Shared by the image and video probes, since HEIC, AVIF, MP4 and MOV all
+ * use the same box tree.
+ */
+import { TinyNeedMoreData } from './TinyBufferReader.mjs';
+/**
+ * Represents a parsed ISO BMFF box header.
+ * @typedef {Object} IsoBox
+ * @property {string} type - The 4-character box type.
+ * @property {number} start - The offset of the first header byte.
+ * @property {number} dataStart - The offset of the first payload byte.
+ * @property {number} dataEnd - The offset after the last payload byte.
+ * @property {number} end - The offset after the box.
+ */
+/**
+ * The boxes whose payload is a plain list of child boxes.
+ * @type {ReadonlySet<string>}
+ */
+const CONTAINERS = new Set([
+    'moov',
+    'trak',
+    'mdia',
+    'minf',
+    'stbl',
+    'edts',
+    'dinf',
+    'udta',
+    'mvex',
+    'moof',
+    'traf',
+    'iprp',
+    'ipco',
+    'mfra',
+    'skip',
+    'jxl ',
+]);
+/**
+ * The boxes that start with a 4-byte version/flag field before their children.
+ * @type {ReadonlySet<string>}
+ */
+const FULL_BOX_CONTAINERS = new Set(['meta']);
+/**
+ * Reads the header of the box starting at the current reader offset.
+ * @param {import('./TinyBufferReader.mjs').default} reader - The binary cursor used for reading.
+ * @param {number} end - The absolute offset marking the end of the readable buffer.
+ * @returns {IsoBox} The parsed box header containing metadata about the box.
+ * @throws {TinyNeedMoreData} If the buffer is truncated and cannot provide the full header or payload size.
+ */
+export function readBox(reader, end) {
+    const start = reader.offset;
+    const size = reader.uint32();
+    const type = reader.ascii(4);
+    let headerSize = 8;
+    let total = size;
+    if (size === 1) {
+        total = reader.uint64();
+        headerSize = 16;
+    }
+    else if (size === 0) {
+        total = end - start;
+    }
+    if (total < headerSize || start + total > end) {
+        throw new TinyNeedMoreData();
+    }
+    return {
+        type,
+        start,
+        dataStart: start + headerSize,
+        dataEnd: start + total,
+        end: start + total,
+    };
+}
+/**
+ * A generator that iterates over all sibling boxes within the specified byte range.
+ * @param {import('./TinyBufferReader.mjs').default} reader - The binary cursor used for reading.
+ * @param {number} start - The absolute offset where the sequence of boxes begins.
+ * @param {number} end - The absolute offset marking the end of the range.
+ * @yields {IsoBox} Every complete ISO box found in the specified range.
+ */
+export function* boxes(reader, start, end) {
+    let cursor = start;
+    while (cursor + 8 <= end) {
+        reader.seek(cursor);
+        const box = readBox(reader, end);
+        yield box;
+        cursor = box.end;
+    }
+}
+/**
+ * Recursively searches through the box tree for the first box that matches one of the specified types.
+ * @param {import('./TinyBufferReader.mjs').default} reader - The binary cursor used for reading.
+ * @param {number} start - The absolute offset where the search begins.
+ * @param {number} end - The absolute offset marking the end of the search range.
+ * @param {ReadonlySet<string>} types - A set of 4-character box types to match against.
+ * @param {number} [depth] - The current recursion depth, used to prevent infinite loops or stack overflows.
+ * @returns {IsoBox|null} The first matching box header found, or null if no match exists within the range.
+ */
+export function findBox(reader, start, end, types, depth = 0) {
+    if (depth > 8) {
+        return null;
+    }
+    for (const box of boxes(reader, start, end)) {
+        if (types.has(box.type)) {
+            return box;
+        }
+        if (CONTAINERS.has(box.type) || FULL_BOX_CONTAINERS.has(box.type)) {
+            const skip = FULL_BOX_CONTAINERS.has(box.type) ? 4 : 0;
+            const found = findBox(reader, box.dataStart + skip, box.dataEnd, types, depth + 1);
+            if (found) {
+                return found;
+            }
+        }
+    }
+    return null;
+}