@carbonenginejs/runtime-resource 0.9.2 → 0.11.0

package/dist/formats/flac/CjsFlacFormat.js

@@ -9,9 +9,16 @@ const FORMAT_NAME = "CjsFlacFormat";
  */
 class CjsFlacFormat {
   #values = DEFAULT_VALUES;
+
+  /** Creates a CjsFlacFormat with caller-provided reader configuration. */
   constructor(options = {}) {
     this.SetValues(options);
   }
+
+  /**
+   * Applies caller-provided options after normalizing supported fields for the
+   * FLAC format configuration.
+   */
   SetValues(options = {}) {
     this.#values = normalizeValues(this.#values, {
       inputType: "flac",
@@ -19,51 +26,93 @@ class CjsFlacFormat {
     }, FORMAT_NAME);
     return this;
   }
+
+  /**
+   * Returns a snapshot of the normalized reader options for the FLAC format
+   * configuration.
+   */
   GetValues(options = {}) {
     return normalizeValues(this.#values, {
       inputType: "flac",
       ...options
     }, FORMAT_NAME);
   }
+
+  /**
+   * Reads the primary public payload representation from the supplied input
+   * for the FLAC format configuration.
+   */
   Read(input, options = {}) {
     return readWithValues(input, this.GetValues(options));
   }
+
+  /**
+   * Reads the primary public payload representation asynchronously for the
+   * FLAC format configuration.
+   */
   async ReadAsync(input, options = {}) {
     return this.Read(input, options);
   }
+
+  /**
+   * Returns structural metadata without materializing the decoded payload for
+   * the FLAC format configuration.
+   */
   Inspect(input, options = {}) {
     return inspectWithValues(input, this.GetValues(options));
   }
+
+  /**
+   * Reports whether input meets the active decoder capability constraints for
+   * the FLAC format configuration.
+   */
   IsSupported(input, options = {}) {
     return isSupportedWithValues(input, this.GetValues(options));
   }
+
+  /**
+   * Converts the current decoded payload into a JSON-safe representation for
+   * the FLAC format configuration.
+   */
   ToJSON(value) {
     return toJsonValue(value);
   }
+
+  /** Provides the one-shot FLAC payload reader entry point. */
   static read(input, options = {}) {
     return readWithValues(input, normalizeValues(DEFAULT_VALUES, {
       inputType: "flac",
       ...options
     }, FORMAT_NAME));
   }
+
+  /** Provides the asynchronous one-shot FLAC payload reader entry point. */
   static async readAsync(input, options = {}) {
     return CjsFlacFormat.read(input, options);
   }
+
+  /** Provides the one-shot FLAC metadata inspection entry point. */
   static inspect(input, options = {}) {
     return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, {
       inputType: "flac",
       ...options
     }, FORMAT_NAME));
   }
+
+  /** Checks one input against the FLAC decoder capability contract. */
   static isSupported(input, options = {}) {
     return isSupportedWithValues(input, normalizeValues(DEFAULT_VALUES, {
       inputType: "flac",
       ...options
     }, FORMAT_NAME));
   }
+
+  /** Provides the one-shot FLAC JSON conversion entry point. */
   static toJSON(value) {
     return toJsonValue(value);
   }
+
+  /** Checks whether caller-provided bytes carry the expected FLAC signature. */
   static isFLAC(input) {
     try {
       return isFLAC(toBytes(input));

package/dist/formats/flac/CjsFlacFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsFlacFormat.js","sources":["../../../../src/formats/flac/CjsFlacFormat.js"],"sourcesContent":["import {\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    OUTPUT_PCM,\n    OUTPUT_RAW,\n    inspectWithValues,\n    isFLAC,\n    isSupportedWithValues,\n    normalizeValues,\n    readWithValues,\n    toBytes,\n    toJsonValue\n} from \"./core/helpers.js\";\n\nconst FORMAT_NAME = \"CjsFlacFormat\";\n\n/**\n * Metadata-only FLAC format profile that validates the stream signature,\n * inspects stream metadata, and emits raw container bytes or debug JSON\n * without decoding PCM.\n */\nexport class CjsFlacFormat\n{\n    #values = DEFAULT_VALUES;\n\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    SetValues(options = {})\n    {\n        this.#values = normalizeValues(this.#values, { inputType: \"flac\", ...options }, FORMAT_NAME);\n        return this;\n    }\n\n    GetValues(options = {})\n    {\n        return normalizeValues(this.#values, { inputType: \"flac\", ...options }, FORMAT_NAME);\n    }\n\n    Read(input, options = {}) { return readWithValues(input, this.GetValues(options)); }\n    async ReadAsync(input, options = {}) { return this.Read(input, options); }\n    Inspect(input, options = {}) { return inspectWithValues(input, this.GetValues(options)); }\n    IsSupported(input, options = {}) { return isSupportedWithValues(input, this.GetValues(options)); }\n    ToJSON(value) { return toJsonValue(value); }\n\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"flac\", ...options }, FORMAT_NAME));\n    }\n\n    static async readAsync(input, options = {}) { return CjsFlacFormat.read(input, options); }\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"flac\", ...options }, FORMAT_NAME));\n    }\n\n    static isSupported(input, options = {})\n    {\n        return isSupportedWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"flac\", ...options }, FORMAT_NAME));\n    }\n\n    static toJSON(value) { return toJsonValue(value); }\n    static isFLAC(input)\n    {\n        try { return isFLAC(toBytes(input)); }\n        catch { return false; }\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        RAW: OUTPUT_RAW,\n        PCM: OUTPUT_PCM,\n        JSON: OUTPUT_JSON\n    });\n    static OUTPUT_FLAC_JSON = \"flacJson\";\n    static type = Object.freeze([ \"audio\" ]);\n    static mediaTypes = Object.freeze([ \"audio\" ]);\n    static inputTypes = Object.freeze([ \"flac\" ]);\n    static outputTypes = Object.freeze([]);\n    static debugOutputTypes = Object.freeze([ \"flacJson\", OUTPUT_RAW ]);\n    static implementationStatus = \"metadata-only\";\n}\n\nexport default CjsFlacFormat;\n"],"names":["FORMAT_NAME","CjsFlacFormat","DEFAULT_VALUES","constructor","options","SetValues","normalizeValues","inputType","GetValues","Read","input","readWithValues","ReadAsync","Inspect","inspectWithValues","IsSupported","isSupportedWithValues","ToJSON","value","toJsonValue","read","readAsync","inspect","isSupported","toJSON","isFLAC","toBytes","Output","Object","freeze","RAW","OUTPUT_RAW","PCM","OUTPUT_PCM","JSON","OUTPUT_JSON","OUTPUT_FLAC_JSON","type","mediaTypes","inputTypes","outputTypes","debugOutputTypes","implementationStatus"],"mappings":"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"}
+{"version":3,"file":"CjsFlacFormat.js","sources":["../../../../src/formats/flac/CjsFlacFormat.js"],"sourcesContent":["import {\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    OUTPUT_PCM,\n    OUTPUT_RAW,\n    inspectWithValues,\n    isFLAC,\n    isSupportedWithValues,\n    normalizeValues,\n    readWithValues,\n    toBytes,\n    toJsonValue\n} from \"./core/helpers.js\";\n\nconst FORMAT_NAME = \"CjsFlacFormat\";\n\n/**\n * Metadata-only FLAC format profile that validates the stream signature,\n * inspects stream metadata, and emits raw container bytes or debug JSON\n * without decoding PCM.\n */\nexport class CjsFlacFormat\n{\n    #values = DEFAULT_VALUES;\n\n    /** Creates a CjsFlacFormat with caller-provided reader configuration. */\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    /**\n     * Applies caller-provided options after normalizing supported fields for the\n     * FLAC format configuration.\n     */\n    SetValues(options = {})\n    {\n        this.#values = normalizeValues(this.#values, { inputType: \"flac\", ...options }, FORMAT_NAME);\n        return this;\n    }\n\n    /**\n     * Returns a snapshot of the normalized reader options for the FLAC format\n     * configuration.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues(this.#values, { inputType: \"flac\", ...options }, FORMAT_NAME);\n    }\n\n    /**\n     * Reads the primary public payload representation from the supplied input\n     * for the FLAC format configuration.\n     */\n    Read(input, options = {}) { return readWithValues(input, this.GetValues(options)); }\n\n    /**\n     * Reads the primary public payload representation asynchronously for the\n     * FLAC format configuration.\n     */\n    async ReadAsync(input, options = {}) { return this.Read(input, options); }\n\n    /**\n     * Returns structural metadata without materializing the decoded payload for\n     * the FLAC format configuration.\n     */\n    Inspect(input, options = {}) { return inspectWithValues(input, this.GetValues(options)); }\n\n    /**\n     * Reports whether input meets the active decoder capability constraints for\n     * the FLAC format configuration.\n     */\n    IsSupported(input, options = {}) { return isSupportedWithValues(input, this.GetValues(options)); }\n\n    /**\n     * Converts the current decoded payload into a JSON-safe representation for\n     * the FLAC format configuration.\n     */\n    ToJSON(value) { return toJsonValue(value); }\n\n    /** Provides the one-shot FLAC payload reader entry point. */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"flac\", ...options }, FORMAT_NAME));\n    }\n\n    /** Provides the asynchronous one-shot FLAC payload reader entry point. */\n    static async readAsync(input, options = {}) { return CjsFlacFormat.read(input, options); }\n\n    /** Provides the one-shot FLAC metadata inspection entry point. */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"flac\", ...options }, FORMAT_NAME));\n    }\n\n    /** Checks one input against the FLAC decoder capability contract. */\n    static isSupported(input, options = {})\n    {\n        return isSupportedWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"flac\", ...options }, FORMAT_NAME));\n    }\n\n    /** Provides the one-shot FLAC JSON conversion entry point. */\n    static toJSON(value) { return toJsonValue(value); }\n\n    /** Checks whether caller-provided bytes carry the expected FLAC signature. */\n    static isFLAC(input)\n    {\n        try { return isFLAC(toBytes(input)); }\n        catch { return false; }\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        RAW: OUTPUT_RAW,\n        PCM: OUTPUT_PCM,\n        JSON: OUTPUT_JSON\n    });\n    static OUTPUT_FLAC_JSON = \"flacJson\";\n    static type = Object.freeze([ \"audio\" ]);\n    static mediaTypes = Object.freeze([ \"audio\" ]);\n    static inputTypes = Object.freeze([ \"flac\" ]);\n    static outputTypes = Object.freeze([]);\n    static debugOutputTypes = Object.freeze([ \"flacJson\", OUTPUT_RAW ]);\n    static implementationStatus = \"metadata-only\";\n}\n\nexport default CjsFlacFormat;\n"],"names":["FORMAT_NAME","CjsFlacFormat","DEFAULT_VALUES","constructor","options","SetValues","normalizeValues","inputType","GetValues","Read","input","readWithValues","ReadAsync","Inspect","inspectWithValues","IsSupported","isSupportedWithValues","ToJSON","value","toJsonValue","read","readAsync","inspect","isSupported","toJSON","isFLAC","toBytes","Output","Object","freeze","RAW","OUTPUT_RAW","PCM","OUTPUT_PCM","JSON","OUTPUT_JSON","OUTPUT_FLAC_JSON","type","mediaTypes","inputTypes","outputTypes","debugOutputTypes","implementationStatus"],"mappings":"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"}

package/dist/formats/flac/core/helpers.js

@@ -7,6 +7,11 @@ const DEFAULT_VALUES = Object.freeze({
   source: ""
 });
 const DEBUG_OUTPUT = "flacJson";
+
+/**
+ * Normalizes reader options against their supported defaults for the FLAC format
+ * reader.
+ */
 function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsFlacFormat") {
   const values = {
     ...DEFAULT_VALUES,
@@ -19,15 +24,21 @@ function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsF
   }
   return values;
 }
+
+/** Returns a byte view over the supplied binary input for the FLAC format reader. */
 function toBytes(input) {
   if (input instanceof Uint8Array) return input;
   if (input instanceof ArrayBuffer) return new Uint8Array(input);
   if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
   throw new TypeError("FLAC input must be Uint8Array, ArrayBuffer, or DataView");
 }
+
+/** Reports whether the current FLAC format reader satisfies FLAC. */
 function isFLAC(bytes) {
   return bytes.byteLength >= 4 && bytes[0] === 0x66 && bytes[1] === 0x4c && bytes[2] === 0x61 && bytes[3] === 0x43;
 }
+
+/** Inspects input using normalized format options for the FLAC format reader. */
 function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
   const bytes = toBytes(input);
   if (!isFLAC(bytes)) throw new TypeError("CjsFlacFormat: input is not a FLAC stream");
@@ -40,6 +51,11 @@ function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
     ...inspectBytes(bytes)
   };
 }
+
+/**
+ * Reports whether input is supported under normalized format options for the
+ * FLAC format reader.
+ */
 function isSupportedWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
   try {
     const metadata = inspectWithValues(input, values, expectedType);
@@ -85,6 +101,8 @@ function isSupportedWithValues(input, values = DEFAULT_VALUES, expectedType = ""
     };
   }
 }
+
+/** Reads input using normalized format options for the FLAC format reader. */
 function readWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
   const bytes = toBytes(input);
   const metadata = inspectWithValues(bytes, values, expectedType);
@@ -107,6 +125,8 @@ function readWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
     bytes
   };
 }
+
+/** Converts a parsed payload into a JSON-safe value for the FLAC format reader. */
 function toJsonValue(value) {
   if (value instanceof Uint8Array) return {
     byteLength: value.byteLength

package/dist/formats/flac/core/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sources":["../../../../../src/formats/flac/core/helpers.js"],"sourcesContent":["export const OUTPUT_RAW = \"raw\";\nexport const OUTPUT_PCM = \"pcm\";\nexport const OUTPUT_JSON = \"json\";\n\nexport const DEFAULT_VALUES = Object.freeze({\n    emit: OUTPUT_RAW,\n    inputType: \"\",\n    source: \"\"\n});\n\nconst DEBUG_OUTPUT = \"flacJson\";\n\nexport function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = \"CjsFlacFormat\")\n{\n    const values = { ...DEFAULT_VALUES, ...(base || {}), ...(options || {}) };\n    values.inputType = values.inputType ? String(values.inputType).replace(/^\\./u, \"\").toLowerCase() : \"\";\n    if (![ OUTPUT_RAW, OUTPUT_PCM, OUTPUT_JSON, DEBUG_OUTPUT ].includes(values.emit))\n    {\n        throw new TypeError(`${readerName}: unknown emit value ${JSON.stringify(values.emit)}`);\n    }\n    return values;\n}\n\nexport function toBytes(input)\n{\n    if (input instanceof Uint8Array) return input;\n    if (input instanceof ArrayBuffer) return new Uint8Array(input);\n    if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n    throw new TypeError(\"FLAC input must be Uint8Array, ArrayBuffer, or DataView\");\n}\n\nexport function isFLAC(bytes)\n{\n    return bytes.byteLength >= 4 && bytes[0] === 0x66 && bytes[1] === 0x4c && bytes[2] === 0x61 && bytes[3] === 0x43;\n}\n\nexport function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = \"\")\n{\n    const bytes = toBytes(input);\n    if (!isFLAC(bytes)) throw new TypeError(\"CjsFlacFormat: input is not a FLAC stream\");\n    const sourceFormat = expectedType || values.inputType || \"flac\";\n    if (sourceFormat !== \"flac\") throw new TypeError(`CjsFlacFormat: expected ${sourceFormat}, got flac`);\n    return { payloadType: \"audio\", mediaTypes: [ \"audio\" ], byteLength: bytes.byteLength, ...inspectBytes(bytes) };\n}\n\nexport function isSupportedWithValues(input, values = DEFAULT_VALUES, expectedType = \"\")\n{\n    try\n    {\n        const metadata = inspectWithValues(input, values, expectedType);\n        return {\n            format: \"flac\",\n            source: values.source || \"buffer\",\n            supported: \"partial\",\n            confidence: 1,\n            preferred: \"flac\",\n            reason: \"FLAC metadata and raw source are recognized; PCM decoding remains a backend/decoder task.\",\n            metadata,\n            variants: [\n                {\n                    kind: \"raw\",\n                    payloadType: \"raw\",\n                    codec: \"flac\",\n                    mimeType: \"audio/flac\",\n                    supported: true,\n                    containerOnly: true,\n                    isDecoded: false,\n                    pcmDecodeSupported: false\n                },\n                { kind: \"pcm\", payloadType: \"pcm\", codec: \"pcm\", supported: false, reason: \"FLAC PCM decode/output is not implemented in this package.\" }\n            ],\n            warnings: [],\n            errors: []\n        };\n    }\n    catch (error)\n    {\n        return {\n            format: expectedType || values.inputType || \"flac\",\n            source: values.source || \"buffer\",\n            supported: \"none\",\n            confidence: 0,\n            preferred: \"\",\n            reason: error.message,\n            metadata: null,\n            variants: [],\n            warnings: [],\n            errors: [ error.message ]\n        };\n    }\n}\n\nexport function readWithValues(input, values = DEFAULT_VALUES, expectedType = \"\")\n{\n    const bytes = toBytes(input);\n    const metadata = inspectWithValues(bytes, values, expectedType);\n    if (values.emit === OUTPUT_JSON || values.emit === DEBUG_OUTPUT) return metadata;\n    if (values.emit === OUTPUT_PCM)\n    {\n        const error = new Error(\"flac: PCM decode/output is not implemented in this package\");\n        error.code = \"CJS_FORMAT_OUTPUT_NOT_IMPLEMENTED\";\n        error.sourceFormat = \"flac\";\n        error.emit = values.emit;\n        throw error;\n    }\n    return {\n        payloadType: OUTPUT_RAW,\n        sourceFormat: \"flac\",\n        mimeType: \"audio/flac\",\n        containerOnly: true,\n        isDecoded: false,\n        pcmDecodeSupported: false,\n        metadata,\n        bytes\n    };\n}\n\nexport function toJsonValue(value)\n{\n    if (value instanceof Uint8Array) return { byteLength: value.byteLength };\n    if (Array.isArray(value)) return value.map(toJsonValue);\n    if (value && typeof value === \"object\")\n    {\n        const output = {};\n        for (const [ key, entry ] of Object.entries(value)) output[key] = toJsonValue(entry);\n        return output;\n    }\n    return value;\n}\n\nfunction inspectBytes(bytes)\n{\n    const blocks = [];\n    let offset = 4;\n    let streamInfo = null;\n    let comments = null;\n    let seekTable = [];\n    const pictures = [];\n    let hasLastMetadataBlock = false;\n    while (offset + 4 <= bytes.byteLength)\n    {\n        const header = bytes[offset];\n        const type = header & 0x7f;\n        const isLast = !!(header & 0x80);\n        const length = readU24BE(bytes, offset + 1);\n        const dataStart = offset + 4;\n        const end = dataStart + length;\n        if (end > bytes.byteLength) throw new Error(`FLAC metadata block ${type} is truncated`);\n        const block = { type, isLast, offset, byteLength: length };\n        if (type === 0)\n        {\n            if (length < 34) throw new Error(\"FLAC STREAMINFO block is truncated\");\n            streamInfo = readStreamInfo(bytes, dataStart);\n            Object.assign(block, streamInfo);\n        }\n        else if (type === 4)\n        {\n            comments = readVorbisComment(bytes, dataStart, end);\n            Object.assign(block, { vendor: comments.vendor, comments: comments.comments });\n        }\n        else if (type === 3)\n        {\n            seekTable = readSeekTable(bytes, dataStart, length);\n            block.points = seekTable;\n        }\n        else if (type === 6)\n        {\n            const picture = readPicture(bytes, dataStart, end);\n            pictures.push(picture);\n            Object.assign(block, picture);\n        }\n        blocks.push(block);\n        offset = end;\n        if (isLast)\n        {\n            hasLastMetadataBlock = true;\n            break;\n        }\n    }\n    if (!streamInfo) throw new Error(\"FLAC stream has no STREAMINFO block\");\n    return {\n        sourceFormat: \"flac\",\n        container: \"flac\",\n        audioFormat: \"flac\",\n        sampleRate: streamInfo.sampleRate,\n        channels: streamInfo.channels,\n        bitsPerSample: streamInfo.bitsPerSample,\n        totalSamples: streamInfo.totalSamples,\n        durationSamples: streamInfo.totalSamples,\n        durationSeconds: streamInfo.sampleRate ? streamInfo.totalSamples / streamInfo.sampleRate : 0,\n        streamInfo,\n        comments,\n        seekTable,\n        pictures,\n        metadataBlockCount: blocks.length,\n        hasLastMetadataBlock,\n        audioDataOffset: offset,\n        audioDataBytes: Math.max(0, bytes.byteLength - offset),\n        metadataBlocks: blocks\n    };\n}\n\nfunction readStreamInfo(bytes, offset)\n{\n    const sampleRate = bytes[offset + 10] * 4096 + bytes[offset + 11] * 16 + (bytes[offset + 12] >> 4);\n    const channels = ((bytes[offset + 12] >> 1) & 0x07) + 1;\n    const bitsPerSample = (((bytes[offset + 12] & 1) << 4) | (bytes[offset + 13] >> 4)) + 1;\n    const totalSamples = (bytes[offset + 13] & 0x0f) * 0x100000000 + readU32BE(bytes, offset + 14);\n    return {\n        minBlockSize: readU16BE(bytes, offset),\n        maxBlockSize: readU16BE(bytes, offset + 2),\n        minFrameSize: readU24BE(bytes, offset + 4),\n        maxFrameSize: readU24BE(bytes, offset + 7),\n        sampleRate,\n        channels,\n        bitsPerSample,\n        totalSamples,\n        md5: Array.from(bytes.subarray(offset + 18, offset + 34), (value) => value.toString(16).padStart(2, \"0\")).join(\"\")\n    };\n}\n\nfunction readVorbisComment(bytes, start, end)\n{\n    let offset = start;\n    if (offset + 8 > end) throw new Error(\"FLAC Vorbis comment block is truncated\");\n    const vendorLength = readU32LE(bytes, offset);\n    offset += 4;\n    if (offset + vendorLength + 4 > end) throw new Error(\"FLAC Vorbis vendor string is truncated\");\n    const vendor = new TextDecoder().decode(bytes.subarray(offset, offset + vendorLength));\n    offset += vendorLength;\n    const count = readU32LE(bytes, offset);\n    offset += 4;\n    const result = [];\n    for (let index = 0; index < count; index++)\n    {\n        if (offset + 4 > end) throw new Error(\"FLAC Vorbis comment list is truncated\");\n        const length = readU32LE(bytes, offset);\n        offset += 4;\n        if (offset + length > end) throw new Error(\"FLAC Vorbis comment is truncated\");\n        result.push(new TextDecoder().decode(bytes.subarray(offset, offset + length)));\n        offset += length;\n    }\n    return { vendor, comments: result };\n}\n\nfunction readSeekTable(bytes, start, length)\n{\n    if (length % 18 !== 0) throw new Error(\"FLAC SEEKTABLE block has an invalid length\");\n    const points = [];\n    for (let offset = start; offset < start + length; offset += 18)\n    {\n        points.push({\n            sampleNumber: readU64BE(bytes, offset),\n            offset: readU64BE(bytes, offset + 8),\n            numberSamples: readU16BE(bytes, offset + 16)\n        });\n    }\n    return points;\n}\n\nfunction readPicture(bytes, start, end)\n{\n    let offset = start;\n    if (offset + 4 > end) throw new Error(\"FLAC picture block is truncated\");\n    const pictureType = readU32BE(bytes, offset);\n    offset += 4;\n    const mimeLength = readU32BE(bytes, offset);\n    offset += 4;\n    if (offset + mimeLength + 4 > end) throw new Error(\"FLAC picture MIME type is truncated\");\n    const mimeType = new TextDecoder().decode(bytes.subarray(offset, offset + mimeLength));\n    offset += mimeLength;\n    const descriptionLength = readU32BE(bytes, offset);\n    offset += 4;\n    if (offset + descriptionLength + 20 > end) throw new Error(\"FLAC picture description is truncated\");\n    const description = new TextDecoder().decode(bytes.subarray(offset, offset + descriptionLength));\n    offset += descriptionLength;\n    const width = readU32BE(bytes, offset);\n    const height = readU32BE(bytes, offset + 4);\n    const colorDepth = readU32BE(bytes, offset + 8);\n    const colors = readU32BE(bytes, offset + 12);\n    const dataLength = readU32BE(bytes, offset + 16);\n    if (offset + 20 + dataLength > end) throw new Error(\"FLAC picture data is truncated\");\n    return { pictureType, mimeType, description, width, height, colorDepth, colors, dataByteLength: dataLength };\n}\n\nfunction readU16BE(bytes, offset) { return (bytes[offset] << 8) | bytes[offset + 1]; }\nfunction readU24BE(bytes, offset) { return bytes[offset] * 0x10000 + bytes[offset + 1] * 0x100 + bytes[offset + 2]; }\nfunction readU32BE(bytes, offset) { return bytes[offset] * 0x1000000 + bytes[offset + 1] * 0x10000 + bytes[offset + 2] * 0x100 + bytes[offset + 3]; }\nfunction readU32LE(bytes, offset) { return bytes[offset] + bytes[offset + 1] * 0x100 + bytes[offset + 2] * 0x10000 + bytes[offset + 3] * 0x1000000; }\nfunction readU64BE(bytes, offset)\n{\n    const high = readU32BE(bytes, offset);\n    const low = readU32BE(bytes, offset + 4);\n    return high > 0x1fffff ? null : high * 0x100000000 + low;\n}\n"],"names":["OUTPUT_RAW","OUTPUT_PCM","OUTPUT_JSON","DEFAULT_VALUES","Object","freeze","emit","inputType","source","DEBUG_OUTPUT","normalizeValues","base","options","readerName","values","String","replace","toLowerCase","includes","TypeError","JSON","stringify","toBytes","input","Uint8Array","ArrayBuffer","isView","buffer","byteOffset","byteLength","isFLAC","bytes","inspectWithValues","expectedType","sourceFormat","payloadType","mediaTypes","inspectBytes","isSupportedWithValues","metadata","format","supported","confidence","preferred","reason","variants","kind","codec","mimeType","containerOnly","isDecoded","pcmDecodeSupported","warnings","errors","error","message","readWithValues","Error","code","toJsonValue","value","Array","isArray","map","output","key","entry","entries","blocks","offset","streamInfo","comments","seekTable","pictures","hasLastMetadataBlock","header","type","isLast","length","readU24BE","dataStart","end","block","readStreamInfo","assign","readVorbisComment","vendor","readSeekTable","points","picture","readPicture","push","container","audioFormat","sampleRate","channels","bitsPerSample","totalSamples","durationSamples","durationSeconds","metadataBlockCount","audioDataOffset","audioDataBytes","Math","max","metadataBlocks","readU32BE","minBlockSize","readU16BE","maxBlockSize","minFrameSize","maxFrameSize","md5","from","subarray","toString","padStart","join","start","vendorLength","readU32LE","TextDecoder","decode","count","result","index","sampleNumber","readU64BE","numberSamples","pictureType","mimeLength","descriptionLength","description","width","height","colorDepth","colors","dataLength","dataByteLength","high","low"],"mappings":"AAAO,MAAMA,UAAU,GAAG;AACnB,MAAMC,UAAU,GAAG;AACnB,MAAMC,WAAW,GAAG;MAEdC,cAAc,GAAGC,MAAM,CAACC,MAAM,CAAC;AACxCC,EAAAA,IAAI,EAAEN,UAAU;AAChBO,EAAAA,SAAS,EAAE,EAAE;AACbC,EAAAA,MAAM,EAAE;AACZ,CAAC;AAED,MAAMC,YAAY,GAAG,UAAU;AAExB,SAASC,eAAeA,CAACC,IAAI,GAAGR,cAAc,EAAES,OAAO,GAAG,EAAE,EAAEC,UAAU,GAAG,eAAe,EACjG;AACI,EAAA,MAAMC,MAAM,GAAG;AAAE,IAAA,GAAGX,cAAc;AAAE,IAAA,IAAIQ,IAAI,IAAI,EAAE,CAAC;IAAE,IAAIC,OAAO,IAAI,EAAE;GAAG;EACzEE,MAAM,CAACP,SAAS,GAAGO,MAAM,CAACP,SAAS,GAAGQ,MAAM,CAACD,MAAM,CAACP,SAAS,CAAC,CAACS,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAACC,WAAW,EAAE,GAAG,EAAE;AACrG,EAAA,IAAI,CAAC,CAAEjB,UAAU,EAAEC,UAAU,EAAEC,WAAW,EAAEO,YAAY,CAAE,CAACS,QAAQ,CAACJ,MAAM,CAACR,IAAI,CAAC,EAChF;AACI,IAAA,MAAM,IAAIa,SAAS,CAAC,CAAA,EAAGN,UAAU,CAAA,qBAAA,EAAwBO,IAAI,CAACC,SAAS,CAACP,MAAM,CAACR,IAAI,CAAC,EAAE,CAAC;AAC3F,EAAA;AACA,EAAA,OAAOQ,MAAM;AACjB;AAEO,SAASQ,OAAOA,CAACC,KAAK,EAC7B;AACI,EAAA,IAAIA,KAAK,YAAYC,UAAU,EAAE,OAAOD,KAAK;EAC7C,IAAIA,KAAK,YAAYE,WAAW,EAAE,OAAO,IAAID,UAAU,CAACD,KAAK,CAAC;EAC9D,IAAIE,WAAW,CAACC,MAAM,CAACH,KAAK,CAAC,EAAE,OAAO,IAAIC,UAAU,CAACD,KAAK,CAACI,MAAM,EAAEJ,KAAK,CAACK,UAAU,EAAEL,KAAK,CAACM,UAAU,CAAC;AACtG,EAAA,MAAM,IAAIV,SAAS,CAAC,yDAAyD,CAAC;AAClF;AAEO,SAASW,MAAMA,CAACC,KAAK,EAC5B;AACI,EAAA,OAAOA,KAAK,CAACF,UAAU,IAAI,CAAC,IAAIE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAIA,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAIA,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAIA,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;AACpH;AAEO,SAASC,iBAAiBA,CAACT,KAAK,EAAET,MAAM,GAAGX,cAAc,EAAE8B,YAAY,GAAG,EAAE,EACnF;AACI,EAAA,MAAMF,KAAK,GAAGT,OAAO,CAACC,KAAK,CAAC;EAC5B,IAAI,CAACO,MAAM,CAACC,KAAK,CAAC,EAAE,MAAM,IAAIZ,SAAS,CAAC,2CAA2C,CAAC;EACpF,MAAMe,YAAY,GAAGD,YAAY,IAAInB,MAAM,CAACP,SAAS,IAAI,MAAM;EAC/D,IAAI2B,YAAY,KAAK,MAAM,EAAE,MAAM,IAAIf,SAAS,CAAC,CAAA,wBAAA,EAA2Be,YAAY,CAAA,UAAA,CAAY,CAAC;EACrG,OAAO;AAAEC,IAAAA,WAAW,EAAE,OAAO;IAAEC,UAAU,EAAE,CAAE,OAAO,CAAE;IAAEP,UAAU,EAAEE,KAAK,CAACF,UAAU;IAAE,GAAGQ,YAAY,CAACN,KAAK;GAAG;AAClH;AAEO,SAASO,qBAAqBA,CAACf,KAAK,EAAET,MAAM,GAAGX,cAAc,EAAE8B,YAAY,GAAG,EAAE,EACvF;EACI,IACA;IACI,MAAMM,QAAQ,GAAGP,iBAAiB,CAACT,KAAK,EAAET,MAAM,EAAEmB,YAAY,CAAC;IAC/D,OAAO;AACHO,MAAAA,MAAM,EAAE,MAAM;AACdhC,MAAAA,MAAM,EAAEM,MAAM,CAACN,MAAM,IAAI,QAAQ;AACjCiC,MAAAA,SAAS,EAAE,SAAS;AACpBC,MAAAA,UAAU,EAAE,CAAC;AACbC,MAAAA,SAAS,EAAE,MAAM;AACjBC,MAAAA,MAAM,EAAE,2FAA2F;MACnGL,QAAQ;AACRM,MAAAA,QAAQ,EAAE,CACN;AACIC,QAAAA,IAAI,EAAE,KAAK;AACXX,QAAAA,WAAW,EAAE,KAAK;AAClBY,QAAAA,KAAK,EAAE,MAAM;AACbC,QAAAA,QAAQ,EAAE,YAAY;AACtBP,QAAAA,SAAS,EAAE,IAAI;AACfQ,QAAAA,aAAa,EAAE,IAAI;AACnBC,QAAAA,SAAS,EAAE,KAAK;AAChBC,QAAAA,kBAAkB,EAAE;AACxB,OAAC,EACD;AAAEL,QAAAA,IAAI,EAAE,KAAK;AAAEX,QAAAA,WAAW,EAAE,KAAK;AAAEY,QAAAA,KAAK,EAAE,KAAK;AAAEN,QAAAA,SAAS,EAAE,KAAK;AAAEG,QAAAA,MAAM,EAAE;AAA6D,OAAC,CAC5I;AACDQ,MAAAA,QAAQ,EAAE,EAAE;AACZC,MAAAA,MAAM,EAAE;KACX;EACL,CAAC,CACD,OAAOC,KAAK,EACZ;IACI,OAAO;AACHd,MAAAA,MAAM,EAAEP,YAAY,IAAInB,MAAM,CAACP,SAAS,IAAI,MAAM;AAClDC,MAAAA,MAAM,EAAEM,MAAM,CAACN,MAAM,IAAI,QAAQ;AACjCiC,MAAAA,SAAS,EAAE,MAAM;AACjBC,MAAAA,UAAU,EAAE,CAAC;AACbC,MAAAA,SAAS,EAAE,EAAE;MACbC,MAAM,EAAEU,KAAK,CAACC,OAAO;AACrBhB,MAAAA,QAAQ,EAAE,IAAI;AACdM,MAAAA,QAAQ,EAAE,EAAE;AACZO,MAAAA,QAAQ,EAAE,EAAE;AACZC,MAAAA,MAAM,EAAE,CAAEC,KAAK,CAACC,OAAO;KAC1B;AACL,EAAA;AACJ;AAEO,SAASC,cAAcA,CAACjC,KAAK,EAAET,MAAM,GAAGX,cAAc,EAAE8B,YAAY,GAAG,EAAE,EAChF;AACI,EAAA,MAAMF,KAAK,GAAGT,OAAO,CAACC,KAAK,CAAC;EAC5B,MAAMgB,QAAQ,GAAGP,iBAAiB,CAACD,KAAK,EAAEjB,MAAM,EAAEmB,YAAY,CAAC;AAC/D,EAAA,IAAInB,MAAM,CAACR,IAAI,KAAKJ,WAAW,IAAIY,MAAM,CAACR,IAAI,KAAKG,YAAY,EAAE,OAAO8B,QAAQ;AAChF,EAAA,IAAIzB,MAAM,CAACR,IAAI,KAAKL,UAAU,EAC9B;AACI,IAAA,MAAMqD,KAAK,GAAG,IAAIG,KAAK,CAAC,4DAA4D,CAAC;IACrFH,KAAK,CAACI,IAAI,GAAG,mCAAmC;IAChDJ,KAAK,CAACpB,YAAY,GAAG,MAAM;AAC3BoB,IAAAA,KAAK,CAAChD,IAAI,GAAGQ,MAAM,CAACR,IAAI;AACxB,IAAA,MAAMgD,KAAK;AACf,EAAA;EACA,OAAO;AACHnB,IAAAA,WAAW,EAAEnC,UAAU;AACvBkC,IAAAA,YAAY,EAAE,MAAM;AACpBc,IAAAA,QAAQ,EAAE,YAAY;AACtBC,IAAAA,aAAa,EAAE,IAAI;AACnBC,IAAAA,SAAS,EAAE,KAAK;AAChBC,IAAAA,kBAAkB,EAAE,KAAK;IACzBZ,QAAQ;AACRR,IAAAA;GACH;AACL;AAEO,SAAS4B,WAAWA,CAACC,KAAK,EACjC;AACI,EAAA,IAAIA,KAAK,YAAYpC,UAAU,EAAE,OAAO;IAAEK,UAAU,EAAE+B,KAAK,CAAC/B;GAAY;AACxE,EAAA,IAAIgC,KAAK,CAACC,OAAO,CAACF,KAAK,CAAC,EAAE,OAAOA,KAAK,CAACG,GAAG,CAACJ,WAAW,CAAC;AACvD,EAAA,IAAIC,KAAK,IAAI,OAAOA,KAAK,KAAK,QAAQ,EACtC;IACI,MAAMI,MAAM,GAAG,EAAE;IACjB,KAAK,MAAM,CAAEC,GAAG,EAAEC,KAAK,CAAE,IAAI9D,MAAM,CAAC+D,OAAO,CAACP,KAAK,CAAC,EAAEI,MAAM,CAACC,GAAG,CAAC,GAAGN,WAAW,CAACO,KAAK,CAAC;AACpF,IAAA,OAAOF,MAAM;AACjB,EAAA;AACA,EAAA,OAAOJ,KAAK;AAChB;AAEA,SAASvB,YAAYA,CAACN,KAAK,EAC3B;EACI,MAAMqC,MAAM,GAAG,EAAE;EACjB,IAAIC,MAAM,GAAG,CAAC;EACd,IAAIC,UAAU,GAAG,IAAI;EACrB,IAAIC,QAAQ,GAAG,IAAI;EACnB,IAAIC,SAAS,GAAG,EAAE;EAClB,MAAMC,QAAQ,GAAG,EAAE;EACnB,IAAIC,oBAAoB,GAAG,KAAK;AAChC,EAAA,OAAOL,MAAM,GAAG,CAAC,IAAItC,KAAK,CAACF,UAAU,EACrC;AACI,IAAA,MAAM8C,MAAM,GAAG5C,KAAK,CAACsC,MAAM,CAAC;AAC5B,IAAA,MAAMO,IAAI,GAAGD,MAAM,GAAG,IAAI;AAC1B,IAAA,MAAME,MAAM,GAAG,CAAC,EAAEF,MAAM,GAAG,IAAI,CAAC;IAChC,MAAMG,MAAM,GAAGC,SAAS,CAAChD,KAAK,EAAEsC,MAAM,GAAG,CAAC,CAAC;AAC3C,IAAA,MAAMW,SAAS,GAAGX,MAAM,GAAG,CAAC;AAC5B,IAAA,MAAMY,GAAG,GAAGD,SAAS,GAAGF,MAAM;AAC9B,IAAA,IAAIG,GAAG,GAAGlD,KAAK,CAACF,UAAU,EAAE,MAAM,IAAI4B,KAAK,CAAC,CAAA,oBAAA,EAAuBmB,IAAI,eAAe,CAAC;AACvF,IAAA,MAAMM,KAAK,GAAG;MAAEN,IAAI;MAAEC,MAAM;MAAER,MAAM;AAAExC,MAAAA,UAAU,EAAEiD;KAAQ;IAC1D,IAAIF,IAAI,KAAK,CAAC,EACd;MACI,IAAIE,MAAM,GAAG,EAAE,EAAE,MAAM,IAAIrB,KAAK,CAAC,oCAAoC,CAAC;AACtEa,MAAAA,UAAU,GAAGa,cAAc,CAACpD,KAAK,EAAEiD,SAAS,CAAC;AAC7C5E,MAAAA,MAAM,CAACgF,MAAM,CAACF,KAAK,EAAEZ,UAAU,CAAC;AACpC,IAAA,CAAC,MACI,IAAIM,IAAI,KAAK,CAAC,EACnB;MACIL,QAAQ,GAAGc,iBAAiB,CAACtD,KAAK,EAAEiD,SAAS,EAAEC,GAAG,CAAC;AACnD7E,MAAAA,MAAM,CAACgF,MAAM,CAACF,KAAK,EAAE;QAAEI,MAAM,EAAEf,QAAQ,CAACe,MAAM;QAAEf,QAAQ,EAAEA,QAAQ,CAACA;AAAS,OAAC,CAAC;AAClF,IAAA,CAAC,MACI,IAAIK,IAAI,KAAK,CAAC,EACnB;MACIJ,SAAS,GAAGe,aAAa,CAACxD,KAAK,EAAEiD,SAAS,EAAEF,MAAM,CAAC;MACnDI,KAAK,CAACM,MAAM,GAAGhB,SAAS;AAC5B,IAAA,CAAC,MACI,IAAII,IAAI,KAAK,CAAC,EACnB;MACI,MAAMa,OAAO,GAAGC,WAAW,CAAC3D,KAAK,EAAEiD,SAAS,EAAEC,GAAG,CAAC;AAClDR,MAAAA,QAAQ,CAACkB,IAAI,CAACF,OAAO,CAAC;AACtBrF,MAAAA,MAAM,CAACgF,MAAM,CAACF,KAAK,EAAEO,OAAO,CAAC;AACjC,IAAA;AACArB,IAAAA,MAAM,CAACuB,IAAI,CAACT,KAAK,CAAC;AAClBb,IAAAA,MAAM,GAAGY,GAAG;AACZ,IAAA,IAAIJ,MAAM,EACV;AACIH,MAAAA,oBAAoB,GAAG,IAAI;AAC3B,MAAA;AACJ,IAAA;AACJ,EAAA;EACA,IAAI,CAACJ,UAAU,EAAE,MAAM,IAAIb,KAAK,CAAC,qCAAqC,CAAC;EACvE,OAAO;AACHvB,IAAAA,YAAY,EAAE,MAAM;AACpB0D,IAAAA,SAAS,EAAE,MAAM;AACjBC,IAAAA,WAAW,EAAE,MAAM;IACnBC,UAAU,EAAExB,UAAU,CAACwB,UAAU;IACjCC,QAAQ,EAAEzB,UAAU,CAACyB,QAAQ;IAC7BC,aAAa,EAAE1B,UAAU,CAAC0B,aAAa;IACvCC,YAAY,EAAE3B,UAAU,CAAC2B,YAAY;IACrCC,eAAe,EAAE5B,UAAU,CAAC2B,YAAY;AACxCE,IAAAA,eAAe,EAAE7B,UAAU,CAACwB,UAAU,GAAGxB,UAAU,CAAC2B,YAAY,GAAG3B,UAAU,CAACwB,UAAU,GAAG,CAAC;IAC5FxB,UAAU;IACVC,QAAQ;IACRC,SAAS;IACTC,QAAQ;IACR2B,kBAAkB,EAAEhC,MAAM,CAACU,MAAM;IACjCJ,oBAAoB;AACpB2B,IAAAA,eAAe,EAAEhC,MAAM;AACvBiC,IAAAA,cAAc,EAAEC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEzE,KAAK,CAACF,UAAU,GAAGwC,MAAM,CAAC;AACtDoC,IAAAA,cAAc,EAAErC;GACnB;AACL;AAEA,SAASe,cAAcA,CAACpD,KAAK,EAAEsC,MAAM,EACrC;AACI,EAAA,MAAMyB,UAAU,GAAG/D,KAAK,CAACsC,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,GAAGtC,KAAK,CAACsC,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,IAAItC,KAAK,CAACsC,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;AAClG,EAAA,MAAM0B,QAAQ,GAAG,CAAEhE,KAAK,CAACsC,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,GAAI,IAAI,IAAI,CAAC;EACvD,MAAM2B,aAAa,GAAG,CAAE,CAACjE,KAAK,CAACsC,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAKtC,KAAK,CAACsC,MAAM,GAAG,EAAE,CAAC,IAAI,CAAE,IAAI,CAAC;EACvF,MAAM4B,YAAY,GAAG,CAAClE,KAAK,CAACsC,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,IAAI,WAAW,GAAGqC,SAAS,CAAC3E,KAAK,EAAEsC,MAAM,GAAG,EAAE,CAAC;EAC9F,OAAO;AACHsC,IAAAA,YAAY,EAAEC,SAAS,CAAC7E,KAAK,EAAEsC,MAAM,CAAC;IACtCwC,YAAY,EAAED,SAAS,CAAC7E,KAAK,EAAEsC,MAAM,GAAG,CAAC,CAAC;IAC1CyC,YAAY,EAAE/B,SAAS,CAAChD,KAAK,EAAEsC,MAAM,GAAG,CAAC,CAAC;IAC1C0C,YAAY,EAAEhC,SAAS,CAAChD,KAAK,EAAEsC,MAAM,GAAG,CAAC,CAAC;IAC1CyB,UAAU;IACVC,QAAQ;IACRC,aAAa;IACbC,YAAY;AACZe,IAAAA,GAAG,EAAEnD,KAAK,CAACoD,IAAI,CAAClF,KAAK,CAACmF,QAAQ,CAAC7C,MAAM,GAAG,EAAE,EAAEA,MAAM,GAAG,EAAE,CAAC,EAAGT,KAAK,IAAKA,KAAK,CAACuD,QAAQ,CAAC,EAAE,CAAC,CAACC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAACC,IAAI,CAAC,EAAE;GACpH;AACL;AAEA,SAAShC,iBAAiBA,CAACtD,KAAK,EAAEuF,KAAK,EAAErC,GAAG,EAC5C;EACI,IAAIZ,MAAM,GAAGiD,KAAK;EAClB,IAAIjD,MAAM,GAAG,CAAC,GAAGY,GAAG,EAAE,MAAM,IAAIxB,KAAK,CAAC,wCAAwC,CAAC;AAC/E,EAAA,MAAM8D,YAAY,GAAGC,SAAS,CAACzF,KAAK,EAAEsC,MAAM,CAAC;AAC7CA,EAAAA,MAAM,IAAI,CAAC;AACX,EAAA,IAAIA,MAAM,GAAGkD,YAAY,GAAG,CAAC,GAAGtC,GAAG,EAAE,MAAM,IAAIxB,KAAK,CAAC,wCAAwC,CAAC;AAC9F,EAAA,MAAM6B,MAAM,GAAG,IAAImC,WAAW,EAAE,CAACC,MAAM,CAAC3F,KAAK,CAACmF,QAAQ,CAAC7C,MAAM,EAAEA,MAAM,GAAGkD,YAAY,CAAC,CAAC;AACtFlD,EAAAA,MAAM,IAAIkD,YAAY;AACtB,EAAA,MAAMI,KAAK,GAAGH,SAAS,CAACzF,KAAK,EAAEsC,MAAM,CAAC;AACtCA,EAAAA,MAAM,IAAI,CAAC;EACX,MAAMuD,MAAM,GAAG,EAAE;EACjB,KAAK,IAAIC,KAAK,GAAG,CAAC,EAAEA,KAAK,GAAGF,KAAK,EAAEE,KAAK,EAAE,EAC1C;IACI,IAAIxD,MAAM,GAAG,CAAC,GAAGY,GAAG,EAAE,MAAM,IAAIxB,KAAK,CAAC,uCAAuC,CAAC;AAC9E,IAAA,MAAMqB,MAAM,GAAG0C,SAAS,CAACzF,KAAK,EAAEsC,MAAM,CAAC;AACvCA,IAAAA,MAAM,IAAI,CAAC;IACX,IAAIA,MAAM,GAAGS,MAAM,GAAGG,GAAG,EAAE,MAAM,IAAIxB,KAAK,CAAC,kCAAkC,CAAC;IAC9EmE,MAAM,CAACjC,IAAI,CAAC,IAAI8B,WAAW,EAAE,CAACC,MAAM,CAAC3F,KAAK,CAACmF,QAAQ,CAAC7C,MAAM,EAAEA,MAAM,GAAGS,MAAM,CAAC,CAAC,CAAC;AAC9ET,IAAAA,MAAM,IAAIS,MAAM;AACpB,EAAA;EACA,OAAO;IAAEQ,MAAM;AAAEf,IAAAA,QAAQ,EAAEqD;GAAQ;AACvC;AAEA,SAASrC,aAAaA,CAACxD,KAAK,EAAEuF,KAAK,EAAExC,MAAM,EAC3C;EACI,IAAIA,MAAM,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,IAAIrB,KAAK,CAAC,4CAA4C,CAAC;EACpF,MAAM+B,MAAM,GAAG,EAAE;AACjB,EAAA,KAAK,IAAInB,MAAM,GAAGiD,KAAK,EAAEjD,MAAM,GAAGiD,KAAK,GAAGxC,MAAM,EAAET,MAAM,IAAI,EAAE,EAC9D;IACImB,MAAM,CAACG,IAAI,CAAC;AACRmC,MAAAA,YAAY,EAAEC,SAAS,CAAChG,KAAK,EAAEsC,MAAM,CAAC;MACtCA,MAAM,EAAE0D,SAAS,CAAChG,KAAK,EAAEsC,MAAM,GAAG,CAAC,CAAC;AACpC2D,MAAAA,aAAa,EAAEpB,SAAS,CAAC7E,KAAK,EAAEsC,MAAM,GAAG,EAAE;AAC/C,KAAC,CAAC;AACN,EAAA;AACA,EAAA,OAAOmB,MAAM;AACjB;AAEA,SAASE,WAAWA,CAAC3D,KAAK,EAAEuF,KAAK,EAAErC,GAAG,EACtC;EACI,IAAIZ,MAAM,GAAGiD,KAAK;EAClB,IAAIjD,MAAM,GAAG,CAAC,GAAGY,GAAG,EAAE,MAAM,IAAIxB,KAAK,CAAC,iCAAiC,CAAC;AACxE,EAAA,MAAMwE,WAAW,GAAGvB,SAAS,CAAC3E,KAAK,EAAEsC,MAAM,CAAC;AAC5CA,EAAAA,MAAM,IAAI,CAAC;AACX,EAAA,MAAM6D,UAAU,GAAGxB,SAAS,CAAC3E,KAAK,EAAEsC,MAAM,CAAC;AAC3CA,EAAAA,MAAM,IAAI,CAAC;AACX,EAAA,IAAIA,MAAM,GAAG6D,UAAU,GAAG,CAAC,GAAGjD,GAAG,EAAE,MAAM,IAAIxB,KAAK,CAAC,qCAAqC,CAAC;AACzF,EAAA,MAAMT,QAAQ,GAAG,IAAIyE,WAAW,EAAE,CAACC,MAAM,CAAC3F,KAAK,CAACmF,QAAQ,CAAC7C,MAAM,EAAEA,MAAM,GAAG6D,UAAU,CAAC,CAAC;AACtF7D,EAAAA,MAAM,IAAI6D,UAAU;AACpB,EAAA,MAAMC,iBAAiB,GAAGzB,SAAS,CAAC3E,KAAK,EAAEsC,MAAM,CAAC;AAClDA,EAAAA,MAAM,IAAI,CAAC;AACX,EAAA,IAAIA,MAAM,GAAG8D,iBAAiB,GAAG,EAAE,GAAGlD,GAAG,EAAE,MAAM,IAAIxB,KAAK,CAAC,uCAAuC,CAAC;AACnG,EAAA,MAAM2E,WAAW,GAAG,IAAIX,WAAW,EAAE,CAACC,MAAM,CAAC3F,KAAK,CAACmF,QAAQ,CAAC7C,MAAM,EAAEA,MAAM,GAAG8D,iBAAiB,CAAC,CAAC;AAChG9D,EAAAA,MAAM,IAAI8D,iBAAiB;AAC3B,EAAA,MAAME,KAAK,GAAG3B,SAAS,CAAC3E,KAAK,EAAEsC,MAAM,CAAC;EACtC,MAAMiE,MAAM,GAAG5B,SAAS,CAAC3E,KAAK,EAAEsC,MAAM,GAAG,CAAC,CAAC;EAC3C,MAAMkE,UAAU,GAAG7B,SAAS,CAAC3E,KAAK,EAAEsC,MAAM,GAAG,CAAC,CAAC;EAC/C,MAAMmE,MAAM,GAAG9B,SAAS,CAAC3E,KAAK,EAAEsC,MAAM,GAAG,EAAE,CAAC;EAC5C,MAAMoE,UAAU,GAAG/B,SAAS,CAAC3E,KAAK,EAAEsC,MAAM,GAAG,EAAE,CAAC;AAChD,EAAA,IAAIA,MAAM,GAAG,EAAE,GAAGoE,UAAU,GAAGxD,GAAG,EAAE,MAAM,IAAIxB,KAAK,CAAC,gCAAgC,CAAC;EACrF,OAAO;IAAEwE,WAAW;IAAEjF,QAAQ;IAAEoF,WAAW;IAAEC,KAAK;IAAEC,MAAM;IAAEC,UAAU;IAAEC,MAAM;AAAEE,IAAAA,cAAc,EAAED;GAAY;AAChH;AAEA,SAAS7B,SAASA,CAAC7E,KAAK,EAAEsC,MAAM,EAAE;AAAE,EAAA,OAAQtC,KAAK,CAACsC,MAAM,CAAC,IAAI,CAAC,GAAItC,KAAK,CAACsC,MAAM,GAAG,CAAC,CAAC;AAAE;AACrF,SAASU,SAASA,CAAChD,KAAK,EAAEsC,MAAM,EAAE;EAAE,OAAOtC,KAAK,CAACsC,MAAM,CAAC,GAAG,OAAO,GAAGtC,KAAK,CAACsC,MAAM,GAAG,CAAC,CAAC,GAAG,KAAK,GAAGtC,KAAK,CAACsC,MAAM,GAAG,CAAC,CAAC;AAAE;AACpH,SAASqC,SAASA,CAAC3E,KAAK,EAAEsC,MAAM,EAAE;AAAE,EAAA,OAAOtC,KAAK,CAACsC,MAAM,CAAC,GAAG,SAAS,GAAGtC,KAAK,CAACsC,MAAM,GAAG,CAAC,CAAC,GAAG,OAAO,GAAGtC,KAAK,CAACsC,MAAM,GAAG,CAAC,CAAC,GAAG,KAAK,GAAGtC,KAAK,CAACsC,MAAM,GAAG,CAAC,CAAC;AAAE;AACpJ,SAASmD,SAASA,CAACzF,KAAK,EAAEsC,MAAM,EAAE;AAAE,EAAA,OAAOtC,KAAK,CAACsC,MAAM,CAAC,GAAGtC,KAAK,CAACsC,MAAM,GAAG,CAAC,CAAC,GAAG,KAAK,GAAGtC,KAAK,CAACsC,MAAM,GAAG,CAAC,CAAC,GAAG,OAAO,GAAGtC,KAAK,CAACsC,MAAM,GAAG,CAAC,CAAC,GAAG,SAAS;AAAE;AACpJ,SAAS0D,SAASA,CAAChG,KAAK,EAAEsC,MAAM,EAChC;AACI,EAAA,MAAMsE,IAAI,GAAGjC,SAAS,CAAC3E,KAAK,EAAEsC,MAAM,CAAC;EACrC,MAAMuE,GAAG,GAAGlC,SAAS,CAAC3E,KAAK,EAAEsC,MAAM,GAAG,CAAC,CAAC;EACxC,OAAOsE,IAAI,GAAG,QAAQ,GAAG,IAAI,GAAGA,IAAI,GAAG,WAAW,GAAGC,GAAG;AAC5D;;;;"}
+{"version":3,"file":"helpers.js","sources":["../../../../../src/formats/flac/core/helpers.js"],"sourcesContent":["export const OUTPUT_RAW = \"raw\";\nexport const OUTPUT_PCM = \"pcm\";\nexport const OUTPUT_JSON = \"json\";\n\nexport const DEFAULT_VALUES = Object.freeze({\n    emit: OUTPUT_RAW,\n    inputType: \"\",\n    source: \"\"\n});\n\nconst DEBUG_OUTPUT = \"flacJson\";\n\n/**\n * Normalizes reader options against their supported defaults for the FLAC format\n * reader.\n */\nexport function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = \"CjsFlacFormat\")\n{\n    const values = { ...DEFAULT_VALUES, ...(base || {}), ...(options || {}) };\n    values.inputType = values.inputType ? String(values.inputType).replace(/^\\./u, \"\").toLowerCase() : \"\";\n    if (![ OUTPUT_RAW, OUTPUT_PCM, OUTPUT_JSON, DEBUG_OUTPUT ].includes(values.emit))\n    {\n        throw new TypeError(`${readerName}: unknown emit value ${JSON.stringify(values.emit)}`);\n    }\n    return values;\n}\n\n/** Returns a byte view over the supplied binary input for the FLAC format reader. */\nexport function toBytes(input)\n{\n    if (input instanceof Uint8Array) return input;\n    if (input instanceof ArrayBuffer) return new Uint8Array(input);\n    if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n    throw new TypeError(\"FLAC input must be Uint8Array, ArrayBuffer, or DataView\");\n}\n\n/** Reports whether the current FLAC format reader satisfies FLAC. */\nexport function isFLAC(bytes)\n{\n    return bytes.byteLength >= 4 && bytes[0] === 0x66 && bytes[1] === 0x4c && bytes[2] === 0x61 && bytes[3] === 0x43;\n}\n\n/** Inspects input using normalized format options for the FLAC format reader. */\nexport function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = \"\")\n{\n    const bytes = toBytes(input);\n    if (!isFLAC(bytes)) throw new TypeError(\"CjsFlacFormat: input is not a FLAC stream\");\n    const sourceFormat = expectedType || values.inputType || \"flac\";\n    if (sourceFormat !== \"flac\") throw new TypeError(`CjsFlacFormat: expected ${sourceFormat}, got flac`);\n    return { payloadType: \"audio\", mediaTypes: [ \"audio\" ], byteLength: bytes.byteLength, ...inspectBytes(bytes) };\n}\n\n/**\n * Reports whether input is supported under normalized format options for the\n * FLAC format reader.\n */\nexport function isSupportedWithValues(input, values = DEFAULT_VALUES, expectedType = \"\")\n{\n    try\n    {\n        const metadata = inspectWithValues(input, values, expectedType);\n        return {\n            format: \"flac\",\n            source: values.source || \"buffer\",\n            supported: \"partial\",\n            confidence: 1,\n            preferred: \"flac\",\n            reason: \"FLAC metadata and raw source are recognized; PCM decoding remains a backend/decoder task.\",\n            metadata,\n            variants: [\n                {\n                    kind: \"raw\",\n                    payloadType: \"raw\",\n                    codec: \"flac\",\n                    mimeType: \"audio/flac\",\n                    supported: true,\n                    containerOnly: true,\n                    isDecoded: false,\n                    pcmDecodeSupported: false\n                },\n                { kind: \"pcm\", payloadType: \"pcm\", codec: \"pcm\", supported: false, reason: \"FLAC PCM decode/output is not implemented in this package.\" }\n            ],\n            warnings: [],\n            errors: []\n        };\n    }\n    catch (error)\n    {\n        return {\n            format: expectedType || values.inputType || \"flac\",\n            source: values.source || \"buffer\",\n            supported: \"none\",\n            confidence: 0,\n            preferred: \"\",\n            reason: error.message,\n            metadata: null,\n            variants: [],\n            warnings: [],\n            errors: [ error.message ]\n        };\n    }\n}\n\n/** Reads input using normalized format options for the FLAC format reader. */\nexport function readWithValues(input, values = DEFAULT_VALUES, expectedType = \"\")\n{\n    const bytes = toBytes(input);\n    const metadata = inspectWithValues(bytes, values, expectedType);\n    if (values.emit === OUTPUT_JSON || values.emit === DEBUG_OUTPUT) return metadata;\n    if (values.emit === OUTPUT_PCM)\n    {\n        const error = new Error(\"flac: PCM decode/output is not implemented in this package\");\n        error.code = \"CJS_FORMAT_OUTPUT_NOT_IMPLEMENTED\";\n        error.sourceFormat = \"flac\";\n        error.emit = values.emit;\n        throw error;\n    }\n    return {\n        payloadType: OUTPUT_RAW,\n        sourceFormat: \"flac\",\n        mimeType: \"audio/flac\",\n        containerOnly: true,\n        isDecoded: false,\n        pcmDecodeSupported: false,\n        metadata,\n        bytes\n    };\n}\n\n/** Converts a parsed payload into a JSON-safe value for the FLAC format reader. */\nexport function toJsonValue(value)\n{\n    if (value instanceof Uint8Array) return { byteLength: value.byteLength };\n    if (Array.isArray(value)) return value.map(toJsonValue);\n    if (value && typeof value === \"object\")\n    {\n        const output = {};\n        for (const [ key, entry ] of Object.entries(value)) output[key] = toJsonValue(entry);\n        return output;\n    }\n    return value;\n}\n\nfunction inspectBytes(bytes)\n{\n    const blocks = [];\n    let offset = 4;\n    let streamInfo = null;\n    let comments = null;\n    let seekTable = [];\n    const pictures = [];\n    let hasLastMetadataBlock = false;\n    while (offset + 4 <= bytes.byteLength)\n    {\n        const header = bytes[offset];\n        const type = header & 0x7f;\n        const isLast = !!(header & 0x80);\n        const length = readU24BE(bytes, offset + 1);\n        const dataStart = offset + 4;\n        const end = dataStart + length;\n        if (end > bytes.byteLength) throw new Error(`FLAC metadata block ${type} is truncated`);\n        const block = { type, isLast, offset, byteLength: length };\n        if (type === 0)\n        {\n            if (length < 34) throw new Error(\"FLAC STREAMINFO block is truncated\");\n            streamInfo = readStreamInfo(bytes, dataStart);\n            Object.assign(block, streamInfo);\n        }\n        else if (type === 4)\n        {\n            comments = readVorbisComment(bytes, dataStart, end);\n            Object.assign(block, { vendor: comments.vendor, comments: comments.comments });\n        }\n        else if (type === 3)\n        {\n            seekTable = readSeekTable(bytes, dataStart, length);\n            block.points = seekTable;\n        }\n        else if (type === 6)\n        {\n            const picture = readPicture(bytes, dataStart, end);\n            pictures.push(picture);\n            Object.assign(block, picture);\n        }\n        blocks.push(block);\n        offset = end;\n        if (isLast)\n        {\n            hasLastMetadataBlock = true;\n            break;\n        }\n    }\n    if (!streamInfo) throw new Error(\"FLAC stream has no STREAMINFO block\");\n    return {\n        sourceFormat: \"flac\",\n        container: \"flac\",\n        audioFormat: \"flac\",\n        sampleRate: streamInfo.sampleRate,\n        channels: streamInfo.channels,\n        bitsPerSample: streamInfo.bitsPerSample,\n        totalSamples: streamInfo.totalSamples,\n        durationSamples: streamInfo.totalSamples,\n        durationSeconds: streamInfo.sampleRate ? streamInfo.totalSamples / streamInfo.sampleRate : 0,\n        streamInfo,\n        comments,\n        seekTable,\n        pictures,\n        metadataBlockCount: blocks.length,\n        hasLastMetadataBlock,\n        audioDataOffset: offset,\n        audioDataBytes: Math.max(0, bytes.byteLength - offset),\n        metadataBlocks: blocks\n    };\n}\n\nfunction readStreamInfo(bytes, offset)\n{\n    const sampleRate = bytes[offset + 10] * 4096 + bytes[offset + 11] * 16 + (bytes[offset + 12] >> 4);\n    const channels = ((bytes[offset + 12] >> 1) & 0x07) + 1;\n    const bitsPerSample = (((bytes[offset + 12] & 1) << 4) | (bytes[offset + 13] >> 4)) + 1;\n    const totalSamples = (bytes[offset + 13] & 0x0f) * 0x100000000 + readU32BE(bytes, offset + 14);\n    return {\n        minBlockSize: readU16BE(bytes, offset),\n        maxBlockSize: readU16BE(bytes, offset + 2),\n        minFrameSize: readU24BE(bytes, offset + 4),\n        maxFrameSize: readU24BE(bytes, offset + 7),\n        sampleRate,\n        channels,\n        bitsPerSample,\n        totalSamples,\n        md5: Array.from(bytes.subarray(offset + 18, offset + 34), (value) => value.toString(16).padStart(2, \"0\")).join(\"\")\n    };\n}\n\nfunction readVorbisComment(bytes, start, end)\n{\n    let offset = start;\n    if (offset + 8 > end) throw new Error(\"FLAC Vorbis comment block is truncated\");\n    const vendorLength = readU32LE(bytes, offset);\n    offset += 4;\n    if (offset + vendorLength + 4 > end) throw new Error(\"FLAC Vorbis vendor string is truncated\");\n    const vendor = new TextDecoder().decode(bytes.subarray(offset, offset + vendorLength));\n    offset += vendorLength;\n    const count = readU32LE(bytes, offset);\n    offset += 4;\n    const result = [];\n    for (let index = 0; index < count; index++)\n    {\n        if (offset + 4 > end) throw new Error(\"FLAC Vorbis comment list is truncated\");\n        const length = readU32LE(bytes, offset);\n        offset += 4;\n        if (offset + length > end) throw new Error(\"FLAC Vorbis comment is truncated\");\n        result.push(new TextDecoder().decode(bytes.subarray(offset, offset + length)));\n        offset += length;\n    }\n    return { vendor, comments: result };\n}\n\nfunction readSeekTable(bytes, start, length)\n{\n    if (length % 18 !== 0) throw new Error(\"FLAC SEEKTABLE block has an invalid length\");\n    const points = [];\n    for (let offset = start; offset < start + length; offset += 18)\n    {\n        points.push({\n            sampleNumber: readU64BE(bytes, offset),\n            offset: readU64BE(bytes, offset + 8),\n            numberSamples: readU16BE(bytes, offset + 16)\n        });\n    }\n    return points;\n}\n\nfunction readPicture(bytes, start, end)\n{\n    let offset = start;\n    if (offset + 4 > end) throw new Error(\"FLAC picture block is truncated\");\n    const pictureType = readU32BE(bytes, offset);\n    offset += 4;\n    const mimeLength = readU32BE(bytes, offset);\n    offset += 4;\n    if (offset + mimeLength + 4 > end) throw new Error(\"FLAC picture MIME type is truncated\");\n    const mimeType = new TextDecoder().decode(bytes.subarray(offset, offset + mimeLength));\n    offset += mimeLength;\n    const descriptionLength = readU32BE(bytes, offset);\n    offset += 4;\n    if (offset + descriptionLength + 20 > end) throw new Error(\"FLAC picture description is truncated\");\n    const description = new TextDecoder().decode(bytes.subarray(offset, offset + descriptionLength));\n    offset += descriptionLength;\n    const width = readU32BE(bytes, offset);\n    const height = readU32BE(bytes, offset + 4);\n    const colorDepth = readU32BE(bytes, offset + 8);\n    const colors = readU32BE(bytes, offset + 12);\n    const dataLength = readU32BE(bytes, offset + 16);\n    if (offset + 20 + dataLength > end) throw new Error(\"FLAC picture data is truncated\");\n    return { pictureType, mimeType, description, width, height, colorDepth, colors, dataByteLength: dataLength };\n}\n\nfunction readU16BE(bytes, offset) { return (bytes[offset] << 8) | bytes[offset + 1]; }\nfunction readU24BE(bytes, offset) { return bytes[offset] * 0x10000 + bytes[offset + 1] * 0x100 + bytes[offset + 2]; }\nfunction readU32BE(bytes, offset) { return bytes[offset] * 0x1000000 + bytes[offset + 1] * 0x10000 + bytes[offset + 2] * 0x100 + bytes[offset + 3]; }\nfunction readU32LE(bytes, offset) { return bytes[offset] + bytes[offset + 1] * 0x100 + bytes[offset + 2] * 0x10000 + bytes[offset + 3] * 0x1000000; }\nfunction readU64BE(bytes, offset)\n{\n    const high = readU32BE(bytes, offset);\n    const low = readU32BE(bytes, offset + 4);\n    return high > 0x1fffff ? null : high * 0x100000000 + low;\n}\n"],"names":["OUTPUT_RAW","OUTPUT_PCM","OUTPUT_JSON","DEFAULT_VALUES","Object","freeze","emit","inputType","source","DEBUG_OUTPUT","normalizeValues","base","options","readerName","values","String","replace","toLowerCase","includes","TypeError","JSON","stringify","toBytes","input","Uint8Array","ArrayBuffer","isView","buffer","byteOffset","byteLength","isFLAC","bytes","inspectWithValues","expectedType","sourceFormat","payloadType","mediaTypes","inspectBytes","isSupportedWithValues","metadata","format","supported","confidence","preferred","reason","variants","kind","codec","mimeType","containerOnly","isDecoded","pcmDecodeSupported","warnings","errors","error","message","readWithValues","Error","code","toJsonValue","value","Array","isArray","map","output","key","entry","entries","blocks","offset","streamInfo","comments","seekTable","pictures","hasLastMetadataBlock","header","type","isLast","length","readU24BE","dataStart","end","block","readStreamInfo","assign","readVorbisComment","vendor","readSeekTable","points","picture","readPicture","push","container","audioFormat","sampleRate","channels","bitsPerSample","totalSamples","durationSamples","durationSeconds","metadataBlockCount","audioDataOffset","audioDataBytes","Math","max","metadataBlocks","readU32BE","minBlockSize","readU16BE","maxBlockSize","minFrameSize","maxFrameSize","md5","from","subarray","toString","padStart","join","start","vendorLength","readU32LE","TextDecoder","decode","count","result","index","sampleNumber","readU64BE","numberSamples","pictureType","mimeLength","descriptionLength","description","width","height","colorDepth","colors","dataLength","dataByteLength","high","low"],"mappings":"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"}

package/dist/formats/gif/CjsGifFormat.js

@@ -8,9 +8,16 @@ const FORMAT_NAME = "CjsGifFormat";
  */
 class CjsGifFormat {
   #values = DEFAULT_VALUES;
+
+  /** Creates a CjsGifFormat with caller-provided reader configuration. */
   constructor(options = {}) {
     this.SetValues(options);
   }
+
+  /**
+   * Applies caller-provided options after normalizing supported fields for the
+   * GIF format configuration.
+   */
   SetValues(options = {}) {
     this.#values = normalizeValues(this.#values, {
       inputType: "gif",
@@ -18,51 +25,93 @@ class CjsGifFormat {
     }, FORMAT_NAME);
     return this;
   }
+
+  /**
+   * Returns a snapshot of the normalized reader options for the GIF format
+   * configuration.
+   */
   GetValues(options = {}) {
     return normalizeValues(this.#values, {
       inputType: "gif",
       ...options
     }, FORMAT_NAME);
   }
+
+  /**
+   * Reads the primary public payload representation from the supplied input
+   * for the GIF format configuration.
+   */
   Read(input, options = {}) {
     return readWithValues(input, this.GetValues(options));
   }
+
+  /**
+   * Reads the primary public payload representation asynchronously for the GIF
+   * format configuration.
+   */
   async ReadAsync(input, options = {}) {
     return this.Read(input, options);
   }
+
+  /**
+   * Returns structural metadata without materializing the decoded payload for
+   * the GIF format configuration.
+   */
   Inspect(input, options = {}) {
     return inspectWithValues(input, this.GetValues(options));
   }
+
+  /**
+   * Reports whether input meets the active decoder capability constraints for
+   * the GIF format configuration.
+   */
   IsSupported(input, options = {}) {
     return isSupportedWithValues(input, this.GetValues(options));
   }
+
+  /**
+   * Converts the current decoded payload into a JSON-safe representation for
+   * the GIF format configuration.
+   */
   ToJSON(value) {
     return toJsonValue(value);
   }
+
+  /** Provides the one-shot GIF payload reader entry point. */
   static read(input, options = {}) {
     return readWithValues(input, normalizeValues(DEFAULT_VALUES, {
       inputType: "gif",
       ...options
     }, FORMAT_NAME));
   }
+
+  /** Provides the asynchronous one-shot GIF payload reader entry point. */
   static async readAsync(input, options = {}) {
     return CjsGifFormat.read(input, options);
   }
+
+  /** Provides the one-shot GIF metadata inspection entry point. */
   static inspect(input, options = {}) {
     return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, {
       inputType: "gif",
       ...options
     }, FORMAT_NAME));
   }
+
+  /** Checks one input against the GIF decoder capability contract. */
   static isSupported(input, options = {}) {
     return isSupportedWithValues(input, normalizeValues(DEFAULT_VALUES, {
       inputType: "gif",
       ...options
     }, FORMAT_NAME));
   }
+
+  /** Provides the one-shot GIF JSON conversion entry point. */
   static toJSON(value) {
     return toJsonValue(value);
   }
+
+  /** Checks whether caller-provided bytes carry the expected GIF signature. */
   static isGIF(input) {
     try {
       return isGIF(toBytes(input));

package/dist/formats/gif/CjsGifFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsGifFormat.js","sources":["../../../../src/formats/gif/CjsGifFormat.js"],"sourcesContent":["import {\n    DEFAULT_VALUES,\n    OUTPUT_IMAGE,\n    OUTPUT_JSON,\n    OUTPUT_RAW,\n    OUTPUT_RGBA,\n    inspectWithValues,\n    isGIF,\n    isSupportedWithValues,\n    normalizeValues,\n    readWithValues,\n    toBytes,\n    toJsonValue\n} from \"./core/helpers.js\";\n\nconst FORMAT_NAME = \"CjsGifFormat\";\n\n/**\n * GIF format profile that inspects header and frame metadata and reads GIF\n * bytes into raw, debug JSON, or LZW-decoded RGBA frame payloads.\n */\nexport class CjsGifFormat\n{\n    #values = DEFAULT_VALUES;\n\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    SetValues(options = {})\n    {\n        this.#values = normalizeValues(this.#values, { inputType: \"gif\", ...options }, FORMAT_NAME);\n        return this;\n    }\n\n    GetValues(options = {})\n    {\n        return normalizeValues(this.#values, { inputType: \"gif\", ...options }, FORMAT_NAME);\n    }\n\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    async ReadAsync(input, options = {})\n    {\n        return this.Read(input, options);\n    }\n\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options));\n    }\n\n    IsSupported(input, options = {})\n    {\n        return isSupportedWithValues(input, this.GetValues(options));\n    }\n\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"gif\", ...options }, FORMAT_NAME));\n    }\n\n    static async readAsync(input, options = {})\n    {\n        return CjsGifFormat.read(input, options);\n    }\n\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"gif\", ...options }, FORMAT_NAME));\n    }\n\n    static isSupported(input, options = {})\n    {\n        return isSupportedWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"gif\", ...options }, FORMAT_NAME));\n    }\n\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    static isGIF(input)\n    {\n        try\n        {\n            return isGIF(toBytes(input));\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        IMAGE: OUTPUT_IMAGE,\n        RGBA: OUTPUT_RGBA,\n        RAW: OUTPUT_RAW,\n        JSON: OUTPUT_JSON\n    });\n    static OUTPUT_GIF_JSON = \"gifJson\";\n    static type = Object.freeze([ \"image\" ]);\n    static mediaTypes = Object.freeze([ \"image\" ]);\n    static inputTypes = Object.freeze([ \"gif\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_IMAGE, OUTPUT_RGBA ]);\n    static debugOutputTypes = Object.freeze([ \"gifJson\", OUTPUT_RAW ]);\n}\n\nexport default CjsGifFormat;\n"],"names":["FORMAT_NAME","CjsGifFormat","DEFAULT_VALUES","constructor","options","SetValues","normalizeValues","inputType","GetValues","Read","input","readWithValues","ReadAsync","Inspect","inspectWithValues","IsSupported","isSupportedWithValues","ToJSON","value","toJsonValue","read","readAsync","inspect","isSupported","toJSON","isGIF","toBytes","Output","Object","freeze","IMAGE","OUTPUT_IMAGE","RGBA","OUTPUT_RGBA","RAW","OUTPUT_RAW","JSON","OUTPUT_JSON","OUTPUT_GIF_JSON","type","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":"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"}
+{"version":3,"file":"CjsGifFormat.js","sources":["../../../../src/formats/gif/CjsGifFormat.js"],"sourcesContent":["import {\n    DEFAULT_VALUES,\n    OUTPUT_IMAGE,\n    OUTPUT_JSON,\n    OUTPUT_RAW,\n    OUTPUT_RGBA,\n    inspectWithValues,\n    isGIF,\n    isSupportedWithValues,\n    normalizeValues,\n    readWithValues,\n    toBytes,\n    toJsonValue\n} from \"./core/helpers.js\";\n\nconst FORMAT_NAME = \"CjsGifFormat\";\n\n/**\n * GIF format profile that inspects header and frame metadata and reads GIF\n * bytes into raw, debug JSON, or LZW-decoded RGBA frame payloads.\n */\nexport class CjsGifFormat\n{\n    #values = DEFAULT_VALUES;\n\n    /** Creates a CjsGifFormat with caller-provided reader configuration. */\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    /**\n     * Applies caller-provided options after normalizing supported fields for the\n     * GIF format configuration.\n     */\n    SetValues(options = {})\n    {\n        this.#values = normalizeValues(this.#values, { inputType: \"gif\", ...options }, FORMAT_NAME);\n        return this;\n    }\n\n    /**\n     * Returns a snapshot of the normalized reader options for the GIF format\n     * configuration.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues(this.#values, { inputType: \"gif\", ...options }, FORMAT_NAME);\n    }\n\n    /**\n     * Reads the primary public payload representation from the supplied input\n     * for the GIF format configuration.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Reads the primary public payload representation asynchronously for the GIF\n     * format configuration.\n     */\n    async ReadAsync(input, options = {})\n    {\n        return this.Read(input, options);\n    }\n\n    /**\n     * Returns structural metadata without materializing the decoded payload for\n     * the GIF format configuration.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Reports whether input meets the active decoder capability constraints for\n     * the GIF format configuration.\n     */\n    IsSupported(input, options = {})\n    {\n        return isSupportedWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Converts the current decoded payload into a JSON-safe representation for\n     * the GIF format configuration.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /** Provides the one-shot GIF payload reader entry point. */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"gif\", ...options }, FORMAT_NAME));\n    }\n\n    /** Provides the asynchronous one-shot GIF payload reader entry point. */\n    static async readAsync(input, options = {})\n    {\n        return CjsGifFormat.read(input, options);\n    }\n\n    /** Provides the one-shot GIF metadata inspection entry point. */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"gif\", ...options }, FORMAT_NAME));\n    }\n\n    /** Checks one input against the GIF decoder capability contract. */\n    static isSupported(input, options = {})\n    {\n        return isSupportedWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"gif\", ...options }, FORMAT_NAME));\n    }\n\n    /** Provides the one-shot GIF JSON conversion entry point. */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /** Checks whether caller-provided bytes carry the expected GIF signature. */\n    static isGIF(input)\n    {\n        try\n        {\n            return isGIF(toBytes(input));\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        IMAGE: OUTPUT_IMAGE,\n        RGBA: OUTPUT_RGBA,\n        RAW: OUTPUT_RAW,\n        JSON: OUTPUT_JSON\n    });\n    static OUTPUT_GIF_JSON = \"gifJson\";\n    static type = Object.freeze([ \"image\" ]);\n    static mediaTypes = Object.freeze([ \"image\" ]);\n    static inputTypes = Object.freeze([ \"gif\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_IMAGE, OUTPUT_RGBA ]);\n    static debugOutputTypes = Object.freeze([ \"gifJson\", OUTPUT_RAW ]);\n}\n\nexport default CjsGifFormat;\n"],"names":["FORMAT_NAME","CjsGifFormat","DEFAULT_VALUES","constructor","options","SetValues","normalizeValues","inputType","GetValues","Read","input","readWithValues","ReadAsync","Inspect","inspectWithValues","IsSupported","isSupportedWithValues","ToJSON","value","toJsonValue","read","readAsync","inspect","isSupported","toJSON","isGIF","toBytes","Output","Object","freeze","IMAGE","OUTPUT_IMAGE","RGBA","OUTPUT_RGBA","RAW","OUTPUT_RAW","JSON","OUTPUT_JSON","OUTPUT_GIF_JSON","type","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":";;AAeA,MAAMA,WAAW,GAAG,cAAc;;AAElC;AACA;AACA;AACA;AACO,MAAMC,YAAY,CACzB;EACI,OAAO,GAAGC,cAAc;;AAExB;AACAC,EAAAA,WAAWA,CAACC,OAAO,GAAG,EAAE,EACxB;AACI,IAAA,IAAI,CAACC,SAAS,CAACD,OAAO,CAAC;AAC3B,EAAA;;AAEA;AACJ;AACA;AACA;AACIC,EAAAA,SAASA,CAACD,OAAO,GAAG,EAAE,EACtB;IACI,IAAI,CAAC,OAAO,GAAGE,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE;AAAEC,MAAAA,SAAS,EAAE,KAAK;MAAE,GAAGH;KAAS,EAAEJ,WAAW,CAAC;AAC3F,IAAA,OAAO,IAAI;AACf,EAAA;;AAEA;AACJ;AACA;AACA;AACIQ,EAAAA,SAASA,CAACJ,OAAO,GAAG,EAAE,EACtB;AACI,IAAA,OAAOE,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE;AAAEC,MAAAA,SAAS,EAAE,KAAK;MAAE,GAAGH;KAAS,EAAEJ,WAAW,CAAC;AACvF,EAAA;;AAEA;AACJ;AACA;AACA;AACIS,EAAAA,IAAIA,CAACC,KAAK,EAAEN,OAAO,GAAG,EAAE,EACxB;IACI,OAAOO,cAAc,CAACD,KAAK,EAAE,IAAI,CAACF,SAAS,CAACJ,OAAO,CAAC,CAAC;AACzD,EAAA;;AAEA;AACJ;AACA;AACA;EACI,MAAMQ,SAASA,CAACF,KAAK,EAAEN,OAAO,GAAG,EAAE,EACnC;AACI,IAAA,OAAO,IAAI,CAACK,IAAI,CAACC,KAAK,EAAEN,OAAO,CAAC;AACpC,EAAA;;AAEA;AACJ;AACA;AACA;AACIS,EAAAA,OAAOA,CAACH,KAAK,EAAEN,OAAO,GAAG,EAAE,EAC3B;IACI,OAAOU,iBAAiB,CAACJ,KAAK,EAAE,IAAI,CAACF,SAAS,CAACJ,OAAO,CAAC,CAAC;AAC5D,EAAA;;AAEA;AACJ;AACA;AACA;AACIW,EAAAA,WAAWA,CAACL,KAAK,EAAEN,OAAO,GAAG,EAAE,EAC/B;IACI,OAAOY,qBAAqB,CAACN,KAAK,EAAE,IAAI,CAACF,SAAS,CAACJ,OAAO,CAAC,CAAC;AAChE,EAAA;;AAEA;AACJ;AACA;AACA;EACIa,MAAMA,CAACC,KAAK,EACZ;IACI,OAAOC,WAAW,CAACD,KAAK,CAAC;AAC7B,EAAA;;AAEA;EACA,OAAOE,IAAIA,CAACV,KAAK,EAAEN,OAAO,GAAG,EAAE,EAC/B;AACI,IAAA,OAAOO,cAAc,CAACD,KAAK,EAAEJ,eAAe,CAACJ,cAAc,EAAE;AAAEK,MAAAA,SAAS,EAAE,KAAK;MAAE,GAAGH;KAAS,EAAEJ,WAAW,CAAC,CAAC;AAChH,EAAA;;AAEA;EACA,aAAaqB,SAASA,CAACX,KAAK,EAAEN,OAAO,GAAG,EAAE,EAC1C;AACI,IAAA,OAAOH,YAAY,CAACmB,IAAI,CAACV,KAAK,EAAEN,OAAO,CAAC;AAC5C,EAAA;;AAEA;EACA,OAAOkB,OAAOA,CAACZ,KAAK,EAAEN,OAAO,GAAG,EAAE,EAClC;AACI,IAAA,OAAOU,iBAAiB,CAACJ,KAAK,EAAEJ,eAAe,CAACJ,cAAc,EAAE;AAAEK,MAAAA,SAAS,EAAE,KAAK;MAAE,GAAGH;KAAS,EAAEJ,WAAW,CAAC,CAAC;AACnH,EAAA;;AAEA;EACA,OAAOuB,WAAWA,CAACb,KAAK,EAAEN,OAAO,GAAG,EAAE,EACtC;AACI,IAAA,OAAOY,qBAAqB,CAACN,KAAK,EAAEJ,eAAe,CAACJ,cAAc,EAAE;AAAEK,MAAAA,SAAS,EAAE,KAAK;MAAE,GAAGH;KAAS,EAAEJ,WAAW,CAAC,CAAC;AACvH,EAAA;;AAEA;EACA,OAAOwB,MAAMA,CAACN,KAAK,EACnB;IACI,OAAOC,WAAW,CAACD,KAAK,CAAC;AAC7B,EAAA;;AAEA;EACA,OAAOO,KAAKA,CAACf,KAAK,EAClB;IACI,IACA;AACI,MAAA,OAAOe,KAAK,CAACC,OAAO,CAAChB,KAAK,CAAC,CAAC;AAChC,IAAA,CAAC,CACD,MACA;AACI,MAAA,OAAO,KAAK;AAChB,IAAA;AACJ,EAAA;;AAEA;AACJ;AACA;AACI,EAAA,OAAOiB,MAAM,GAAGC,MAAM,CAACC,MAAM,CAAC;AAC1BC,IAAAA,KAAK,EAAEC,YAAY;AACnBC,IAAAA,IAAI,EAAEC,WAAW;AACjBC,IAAAA,GAAG,EAAEC,UAAU;AACfC,IAAAA,IAAI,EAAEC;AACV,GAAC,CAAC;EACF,OAAOC,eAAe,GAAG,SAAS;EAClC,OAAOC,IAAI,GAAGX,MAAM,CAACC,MAAM,CAAC,CAAE,OAAO,CAAE,CAAC;EACxC,OAAOW,UAAU,GAAGZ,MAAM,CAACC,MAAM,CAAC,CAAE,OAAO,CAAE,CAAC;EAC9C,OAAOY,UAAU,GAAGb,MAAM,CAACC,MAAM,CAAC,CAAE,KAAK,CAAE,CAAC;EAC5C,OAAOa,WAAW,GAAGd,MAAM,CAACC,MAAM,CAAC,CAAEE,YAAY,EAAEE,WAAW,CAAE,CAAC;EACjE,OAAOU,gBAAgB,GAAGf,MAAM,CAACC,MAAM,CAAC,CAAE,SAAS,EAAEM,UAAU,CAAE,CAAC;AACtE;;;;"}

package/dist/formats/gif/core/helpers.js

@@ -7,6 +7,11 @@ const DEFAULT_VALUES = Object.freeze({
   inputType: "gif",
   source: ""
 });
+
+/**
+ * Normalizes reader options against their supported defaults for the GIF format
+ * reader.
+ */
 function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsGifFormat") {
   if (!options || typeof options !== "object" || Array.isArray(options)) {
     throw new TypeError(`${readerName}: options must be an object`);
@@ -25,15 +30,21 @@ function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsG
   }
   return values;
 }
+
+/** Returns a byte view over the supplied binary input for the GIF format reader. */
 function toBytes(input) {
   if (input instanceof Uint8Array) return input;
   if (input instanceof ArrayBuffer) return new Uint8Array(input);
   if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
   throw new TypeError("GIF input must be Uint8Array, ArrayBuffer, or a view");
 }
+
+/** Reports whether the current GIF format reader satisfies GIF. */
 function isGIF(bytes) {
   return bytes.byteLength >= 13 && (ascii(bytes, 0, 6) === "GIF87a" || ascii(bytes, 0, 6) === "GIF89a");
 }
+
+/** Inspects input using normalized format options for the GIF format reader. */
 function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = "gif") {
   const bytes = toBytes(input);
   if (!isGIF(bytes)) throw new TypeError("CjsGifFormat: input is not a GIF87a/GIF89a image");
@@ -47,6 +58,11 @@ function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = "gif")
     source: values.source || "buffer"
   };
 }
+
+/**
+ * Reports whether input is supported under normalized format options for the GIF
+ * format reader.
+ */
 function isSupportedWithValues(input, values = DEFAULT_VALUES) {
   try {
     const metadata = inspectWithValues(input, values);
@@ -96,6 +112,8 @@ function isSupportedWithValues(input, values = DEFAULT_VALUES) {
     };
   }
 }
+
+/** Reads input using normalized format options for the GIF format reader. */
 function readWithValues(input, values = DEFAULT_VALUES) {
   const bytes = toBytes(input);
   const metadata = inspectWithValues(bytes, values);
@@ -119,6 +137,8 @@ function readWithValues(input, values = DEFAULT_VALUES) {
   error.code = "CJS_FORMAT_OUTPUT_NOT_IMPLEMENTED";
   throw error;
 }
+
+/** Converts a parsed payload into a JSON-safe value for the GIF format reader. */
 function toJsonValue(value) {
   if (value instanceof Uint8Array) return {
     byteLength: value.byteLength