@carbonenginejs/runtime-resource 0.1.0 → 0.8.0

package/dist/formats/wem/CjsWemFormat.js

@@ -1,197 +1,241 @@
-import { DEFAULT_VALUES, normalizeValues, readWithValues, inspectWithValues, isSupportedWithValues, toJsonValue, isWEM, toBytes, OUTPUT_OGG, OUTPUT_RAW, OUTPUT_JSON, OUTPUT_WEM_JSON, WEM_CODEC_NAMES } from './core/helpers.js';
-
-const FORMAT_NAME = "CjsWemFormat";
-
-/**
- * Reader for Audiokinetic Wwise media (.wem) containers.
- *
- * Inspection identifies the codec, channel/rate layout, and Vorbis duration
- * without decoding audio data. Read emits the container bytes untouched;
- * decode/transcode targets are deliberately out of scope for this reader.
- */
-class CjsWemFormat {
-  #values = DEFAULT_VALUES;
-
-  /**
-   * Create a reusable wem format profile.
-   *
-   * @param {object} [options] Default read/inspect options.
-   */
-  constructor(options = {}) {
-    this.SetValues(options);
-  }
-
-  /**
-   * Merge options into this profile.
-   *
-   * @param {object} [options] Values to merge.
-   * @returns {CjsWemFormat} This format profile.
-   */
-  SetValues(options = {}) {
-    this.#values = normalizeValues(this.#values, options, FORMAT_NAME);
-    return this;
-  }
-
-  /**
-   * Get normalized profile values with optional per-call overrides.
-   *
-   * @param {object} [options] Per-call values.
-   * @returns {object} Normalized read values.
-   */
-  GetValues(options = {}) {
-    return normalizeValues(this.#values, options, FORMAT_NAME);
-  }
-
-  /**
-   * Read wem bytes with this profile.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
-   * @param {object} [options] Per-call values.
-   * @returns {object} GPU-free raw/debug payload for the selected emit target.
-   */
-  Read(input, options = {}) {
-    return readWithValues(input, this.GetValues(options));
-  }
-
-  /**
-   * Read wem bytes asynchronously with this profile.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
-   * @param {object} [options] Per-call values.
-   * @returns {Promise<object>} GPU-free raw/debug payload for the selected emit target.
-   */
-  async ReadAsync(input, options = {}) {
-    return this.Read(input, options);
-  }
-
-  /**
-   * Inspect wem bytes without decoding audio data.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
-   * @param {object} [options] Per-call values.
-   * @returns {object} Wwise container metadata.
-   */
-  Inspect(input, options = {}) {
-    return inspectWithValues(input, this.GetValues(options));
-  }
-
-  /**
-   * Report whether wem input and requested output variants are supported.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
-   * @param {object} [options] Per-call values.
-   * @returns {object} Support/probe report.
-   */
-  IsSupported(input, options = {}) {
-    return isSupportedWithValues(input, this.GetValues(options));
-  }
-
-  /**
-   * Convert format output into JSON-compatible debug data.
-   *
-   * @param {any} value Format output.
-   * @returns {any} JSON-compatible value.
-   */
-  ToJSON(value) {
-    return toJsonValue(value);
-  }
-
-  /**
-   * One-shot wem read.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
-   * @param {object} [options] Read options.
-   * @returns {object} GPU-free raw/debug payload for the selected emit target.
-   */
-  static read(input, options = {}) {
-    return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
-  }
-
-  /**
-   * One-shot asynchronous wem read.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
-   * @param {object} [options] Read options.
-   * @returns {Promise<object>} GPU-free raw/debug payload for the selected emit target.
-   */
-  static async readAsync(input, options = {}) {
-    return CjsWemFormat.read(input, options);
-  }
-
-  /**
-   * One-shot wem inspection.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
-   * @param {object} [options] Inspect options.
-   * @returns {object} Wwise container metadata.
-   */
-  static inspect(input, options = {}) {
-    return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
-  }
-
-  /**
-   * One-shot wem support probe.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
-   * @param {object} [options] Probe options.
-   * @returns {object} Support/probe report.
-   */
-  static isSupported(input, options = {}) {
-    return isSupportedWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
-  }
-
-  /**
-   * Convert format output into JSON-compatible debug data.
-   *
-   * @param {any} value Format output.
-   * @returns {any} JSON-compatible value.
-   */
-  static toJSON(value) {
-    return toJsonValue(value);
-  }
-
-  /**
-   * Test whether bytes look like a Wwise media container.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Candidate wem bytes.
-   * @returns {boolean} True when RIFF/RIFX WAVE signatures are present.
-   */
-  static isWEM(input) {
-    try {
-      return isWEM(toBytes(input));
-    } catch {
-      return false;
-    }
-  }
-
-  /**
-   * Repack Wwise Vorbis wem bytes into a standard Ogg Vorbis stream.
-   *
-   * Lossless container transform (no audio decode/re-encode); output plays
-   * natively where Ogg Vorbis is supported. Equivalent to
-   * `read(input, { emit: "ogg" })`.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
-   * @param {object} [options] Options, including a `codebooks` override.
-   * @returns {object} Ogg payload with bytes, timing, and loop metadata.
-   */
-  static toOgg(input, options = {}) {
-    return CjsWemFormat.read(input, {
-      ...options,
-      emit: OUTPUT_OGG
-    });
-  }
-  static OUTPUT_RAW = OUTPUT_RAW;
-  static OUTPUT_JSON = OUTPUT_JSON;
-  static OUTPUT_WEM_JSON = OUTPUT_WEM_JSON;
-  static OUTPUT_OGG = OUTPUT_OGG;
-  static CODEC_NAMES = WEM_CODEC_NAMES;
-  static type = Object.freeze(["audio"]);
-  static mediaTypes = Object.freeze(["audio"]);
-  static inputTypes = Object.freeze(["wem"]);
-  static outputTypes = Object.freeze([OUTPUT_RAW, OUTPUT_OGG]);
-  static debugOutputTypes = Object.freeze([OUTPUT_WEM_JSON, OUTPUT_RAW]);
-}
-
-export { CjsWemFormat };
-//# sourceMappingURL=CjsWemFormat.js.map
+import { DEFAULT_VALUES, normalizeValues, readWithValues, inspectWithValues, isSupportedWithValues, toJsonValue, isWEM, toBytes, OUTPUT_OGG, OUTPUT_PCM, OUTPUT_WEM_JSON, OUTPUT_JSON, OUTPUT_RAW, WEM_CODEC_NAMES } from './core/helpers.js';
+import { resolveTypeWithValues } from './core/resolve.js';
+
+const FORMAT_NAME = "CjsWemFormat";
+
+/**
+ * Reader for Audiokinetic Wwise media (.wem) containers.
+ *
+ * Inspection identifies the codec, channel/rate layout, and Vorbis duration
+ * without decoding audio data. Read emits the container bytes untouched;
+ * decode/transcode targets are deliberately out of scope for this reader.
+ */
+class CjsWemFormat {
+  #values = DEFAULT_VALUES;
+
+  /**
+   * Create a reusable wem format profile.
+   *
+   * @param {object} [options] Default read/inspect options.
+   */
+  constructor(options = {}) {
+    this.SetValues(options);
+  }
+
+  /**
+   * Merge options into this profile.
+   *
+   * @param {object} [options] Values to merge.
+   * @returns {CjsWemFormat} This format profile.
+   */
+  SetValues(options = {}) {
+    this.#values = normalizeValues(this.#values, options, FORMAT_NAME);
+    return this;
+  }
+
+  /**
+   * Get normalized profile values with optional per-call overrides.
+   *
+   * @param {object} [options] Per-call values.
+   * @returns {object} Normalized read values.
+   */
+  GetValues(options = {}) {
+    return normalizeValues(this.#values, options, FORMAT_NAME);
+  }
+
+  /**
+   * Read wem bytes with this profile.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
+   * @param {object} [options] Per-call values.
+   * @returns {object} GPU-free raw/debug payload for the selected emit target.
+   */
+  Read(input, options = {}) {
+    return readWithValues(input, this.GetValues(options));
+  }
+
+  /**
+   * Read wem bytes asynchronously with this profile.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
+   * @param {object} [options] Per-call values.
+   * @returns {Promise<object>} GPU-free raw/debug payload for the selected emit target.
+   */
+  async ReadAsync(input, options = {}) {
+    return this.Read(input, options);
+  }
+
+  /**
+   * Inspect wem bytes without decoding audio data.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
+   * @param {object} [options] Per-call values.
+   * @returns {object} Wwise container metadata.
+   */
+  Inspect(input, options = {}) {
+    return inspectWithValues(input, this.GetValues(options));
+  }
+
+  /**
+   * Report whether wem input and requested output variants are supported.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
+   * @param {object} [options] Per-call values.
+   * @returns {object} Support/probe report.
+   */
+  IsSupported(input, options = {}) {
+    return isSupportedWithValues(input, this.GetValues(options));
+  }
+
+  /**
+   * Convert format output into JSON-compatible debug data.
+   *
+   * @param {any} value Format output.
+   * @returns {any} JSON-compatible value.
+   */
+  ToJSON(value) {
+    return toJsonValue(value);
+  }
+
+  /**
+   * One-shot wem read.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
+   * @param {object} [options] Read options.
+   * @returns {object} GPU-free raw/debug payload for the selected emit target.
+   */
+  static read(input, options = {}) {
+    return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  }
+
+  /**
+   * One-shot asynchronous wem read.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
+   * @param {object} [options] Read options.
+   * @returns {Promise<object>} GPU-free raw/debug payload for the selected emit target.
+   */
+  static async readAsync(input, options = {}) {
+    return CjsWemFormat.read(input, options);
+  }
+
+  /**
+   * One-shot wem inspection.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
+   * @param {object} [options] Inspect options.
+   * @returns {object} Wwise container metadata.
+   */
+  static inspect(input, options = {}) {
+    return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  }
+
+  /**
+   * One-shot wem support probe.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
+   * @param {object} [options] Probe options.
+   * @returns {object} Support/probe report.
+   */
+  static isSupported(input, options = {}) {
+    return isSupportedWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  }
+
+  /**
+   * Content-verified codec/route resolution (kb §5 resolveType seam).
+   *
+   * Where `isSupported` trusts the fmt tag, this validates the declared
+   * codec against the container's actual structure (Vorbis sidecar,
+   * PTADPCM frame layout, PCM size consistency - bounded, no audio
+   * decode) and tries the other codecs when the declaration fails.
+   * The report carries `verified: true`, `preferred` = `ogg`/`pcm`/`raw`,
+   * and declared/resolved/mismatch evidence in `metadata`.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
+   * @param {object} [options] Probe options.
+   * @returns {Promise<object>} Content-verified probe report.
+   */
+  static async resolveType(input, options = {}) {
+    return resolveTypeWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  }
+
+  /**
+   * Convert format output into JSON-compatible debug data.
+   *
+   * @param {any} value Format output.
+   * @returns {any} JSON-compatible value.
+   */
+  static toJSON(value) {
+    return toJsonValue(value);
+  }
+
+  /**
+   * Test whether bytes look like a Wwise media container.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Candidate wem bytes.
+   * @returns {boolean} True when RIFF/RIFX WAVE signatures are present.
+   */
+  static isWEM(input) {
+    try {
+      return isWEM(toBytes(input));
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Repack Wwise Vorbis wem bytes into a standard Ogg Vorbis stream.
+   *
+   * Lossless container transform (no audio decode/re-encode); output plays
+   * natively where Ogg Vorbis is supported. Equivalent to
+   * `read(input, { emit: "ogg" })`.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
+   * @param {object} [options] Options, including a `codebooks` override.
+   * @returns {object} Ogg payload with bytes, timing, and loop metadata.
+   */
+  static toOgg(input, options = {}) {
+    return CjsWemFormat.read(input, {
+      ...options,
+      emit: OUTPUT_OGG
+    });
+  }
+
+  /**
+   * Decode wem audio data to per-channel float32 PCM (AudioBuffer-ready).
+   *
+   * Covers Wwise PTADPCM (0x8311) and uncompressed 16-bit PCM. Wwise Vorbis
+   * is not decoded here - repack it with `toOgg()` instead. Equivalent to
+   * `read(input, { emit: "pcm" })`.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.
+   * @param {object} [options] Read options.
+   * @returns {object} PCM payload with channelData, sample rate, and timing.
+   */
+  static toPcm(input, options = {}) {
+    return CjsWemFormat.read(input, {
+      ...options,
+      emit: OUTPUT_PCM
+    });
+  }
+
+  /**
+   * Emit targets for this format (canonical frozen enum).
+   */
+  static Output = Object.freeze({
+    RAW: OUTPUT_RAW,
+    JSON: OUTPUT_JSON,
+    WEM_JSON: OUTPUT_WEM_JSON,
+    OGG: OUTPUT_OGG,
+    PCM: OUTPUT_PCM
+  });
+  static CODEC_NAMES = WEM_CODEC_NAMES;
+  static type = Object.freeze(["audio"]);
+  static mediaTypes = Object.freeze(["audio"]);
+  static inputTypes = Object.freeze(["wem"]);
+  static outputTypes = Object.freeze([OUTPUT_RAW, OUTPUT_OGG, OUTPUT_PCM]);
+  static debugOutputTypes = Object.freeze([OUTPUT_WEM_JSON, OUTPUT_RAW]);
+}
+
+export { CjsWemFormat };
+//# sourceMappingURL=CjsWemFormat.js.map

package/dist/formats/wem/CjsWemFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsWemFormat.js","sources":["../../../../src/formats/wem/CjsWemFormat.js"],"sourcesContent":["import {\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    OUTPUT_OGG,\n    OUTPUT_RAW,\n    OUTPUT_WEM_JSON,\n    WEM_CODEC_NAMES,\n    inspectWithValues,\n    isSupportedWithValues,\n    isWEM,\n    normalizeValues,\n    readWithValues,\n    toBytes,\n    toJsonValue\n} from \"./core/helpers.js\";\n\nconst FORMAT_NAME = \"CjsWemFormat\";\n\n/**\n * Reader for Audiokinetic Wwise media (.wem) containers.\n *\n * Inspection identifies the codec, channel/rate layout, and Vorbis duration\n * without decoding audio data. Read emits the container bytes untouched;\n * decode/transcode targets are deliberately out of scope for this reader.\n */\nexport class CjsWemFormat\n{\n    #values = DEFAULT_VALUES;\n\n    /**\n     * Create a reusable wem format profile.\n     *\n     * @param {object} [options] Default read/inspect options.\n     */\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    /**\n     * Merge options into this profile.\n     *\n     * @param {object} [options] Values to merge.\n     * @returns {CjsWemFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        this.#values = normalizeValues(this.#values, options, FORMAT_NAME);\n        return this;\n    }\n\n    /**\n     * Get normalized profile values with optional per-call overrides.\n     *\n     * @param {object} [options] Per-call values.\n     * @returns {object} Normalized read values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues(this.#values, options, FORMAT_NAME);\n    }\n\n    /**\n     * Read wem bytes with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} GPU-free raw/debug payload for the selected emit target.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Read wem bytes asynchronously with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {Promise<object>} GPU-free raw/debug payload for the selected emit target.\n     */\n    async ReadAsync(input, options = {})\n    {\n        return this.Read(input, options);\n    }\n\n    /**\n     * Inspect wem bytes without decoding audio data.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} Wwise container metadata.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Report whether wem input and requested output variants are supported.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} Support/probe report.\n     */\n    IsSupported(input, options = {})\n    {\n        return isSupportedWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * One-shot wem read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Read options.\n     * @returns {object} GPU-free raw/debug payload for the selected emit target.\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * One-shot asynchronous wem read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Read options.\n     * @returns {Promise<object>} GPU-free raw/debug payload for the selected emit target.\n     */\n    static async readAsync(input, options = {})\n    {\n        return CjsWemFormat.read(input, options);\n    }\n\n    /**\n     * One-shot wem inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Inspect options.\n     * @returns {object} Wwise container metadata.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * One-shot wem support probe.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Probe options.\n     * @returns {object} Support/probe report.\n     */\n    static isSupported(input, options = {})\n    {\n        return isSupportedWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Test whether bytes look like a Wwise media container.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Candidate wem bytes.\n     * @returns {boolean} True when RIFF/RIFX WAVE signatures are present.\n     */\n    static isWEM(input)\n    {\n        try\n        {\n            return isWEM(toBytes(input));\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Repack Wwise Vorbis wem bytes into a standard Ogg Vorbis stream.\n     *\n     * Lossless container transform (no audio decode/re-encode); output plays\n     * natively where Ogg Vorbis is supported. Equivalent to\n     * `read(input, { emit: \"ogg\" })`.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Options, including a `codebooks` override.\n     * @returns {object} Ogg payload with bytes, timing, and loop metadata.\n     */\n    static toOgg(input, options = {})\n    {\n        return CjsWemFormat.read(input, { ...options, emit: OUTPUT_OGG });\n    }\n\n    static OUTPUT_RAW = OUTPUT_RAW;\n    static OUTPUT_JSON = OUTPUT_JSON;\n    static OUTPUT_WEM_JSON = OUTPUT_WEM_JSON;\n    static OUTPUT_OGG = OUTPUT_OGG;\n    static CODEC_NAMES = WEM_CODEC_NAMES;\n    static type = Object.freeze([ \"audio\" ]);\n    static mediaTypes = Object.freeze([ \"audio\" ]);\n    static inputTypes = Object.freeze([ \"wem\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_RAW, OUTPUT_OGG ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_WEM_JSON, OUTPUT_RAW ]);\n}\n\nexport default CjsWemFormat;\n"],"names":["FORMAT_NAME","CjsWemFormat","DEFAULT_VALUES","constructor","options","SetValues","normalizeValues","GetValues","Read","input","readWithValues","ReadAsync","Inspect","inspectWithValues","IsSupported","isSupportedWithValues","ToJSON","value","toJsonValue","read","readAsync","inspect","isSupported","toJSON","isWEM","toBytes","toOgg","emit","OUTPUT_OGG","OUTPUT_RAW","OUTPUT_JSON","OUTPUT_WEM_JSON","CODEC_NAMES","WEM_CODEC_NAMES","type","Object","freeze","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":"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"}
+{"version":3,"file":"CjsWemFormat.js","sources":["../../../../src/formats/wem/CjsWemFormat.js"],"sourcesContent":["import {\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    OUTPUT_OGG,\n    OUTPUT_PCM,\n    OUTPUT_RAW,\n    OUTPUT_WEM_JSON,\n    WEM_CODEC_NAMES,\n    inspectWithValues,\n    isSupportedWithValues,\n    isWEM,\n    normalizeValues,\n    readWithValues,\n    toBytes,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { resolveTypeWithValues } from \"./core/resolve.js\";\n\nconst FORMAT_NAME = \"CjsWemFormat\";\n\n/**\n * Reader for Audiokinetic Wwise media (.wem) containers.\n *\n * Inspection identifies the codec, channel/rate layout, and Vorbis duration\n * without decoding audio data. Read emits the container bytes untouched;\n * decode/transcode targets are deliberately out of scope for this reader.\n */\nexport class CjsWemFormat\n{\n    #values = DEFAULT_VALUES;\n\n    /**\n     * Create a reusable wem format profile.\n     *\n     * @param {object} [options] Default read/inspect options.\n     */\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    /**\n     * Merge options into this profile.\n     *\n     * @param {object} [options] Values to merge.\n     * @returns {CjsWemFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        this.#values = normalizeValues(this.#values, options, FORMAT_NAME);\n        return this;\n    }\n\n    /**\n     * Get normalized profile values with optional per-call overrides.\n     *\n     * @param {object} [options] Per-call values.\n     * @returns {object} Normalized read values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues(this.#values, options, FORMAT_NAME);\n    }\n\n    /**\n     * Read wem bytes with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} GPU-free raw/debug payload for the selected emit target.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Read wem bytes asynchronously with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {Promise<object>} GPU-free raw/debug payload for the selected emit target.\n     */\n    async ReadAsync(input, options = {})\n    {\n        return this.Read(input, options);\n    }\n\n    /**\n     * Inspect wem bytes without decoding audio data.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} Wwise container metadata.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Report whether wem input and requested output variants are supported.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} Support/probe report.\n     */\n    IsSupported(input, options = {})\n    {\n        return isSupportedWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * One-shot wem read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Read options.\n     * @returns {object} GPU-free raw/debug payload for the selected emit target.\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * One-shot asynchronous wem read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Read options.\n     * @returns {Promise<object>} GPU-free raw/debug payload for the selected emit target.\n     */\n    static async readAsync(input, options = {})\n    {\n        return CjsWemFormat.read(input, options);\n    }\n\n    /**\n     * One-shot wem inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Inspect options.\n     * @returns {object} Wwise container metadata.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * One-shot wem support probe.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Probe options.\n     * @returns {object} Support/probe report.\n     */\n    static isSupported(input, options = {})\n    {\n        return isSupportedWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Content-verified codec/route resolution (kb §5 resolveType seam).\n     *\n     * Where `isSupported` trusts the fmt tag, this validates the declared\n     * codec against the container's actual structure (Vorbis sidecar,\n     * PTADPCM frame layout, PCM size consistency - bounded, no audio\n     * decode) and tries the other codecs when the declaration fails.\n     * The report carries `verified: true`, `preferred` = `ogg`/`pcm`/`raw`,\n     * and declared/resolved/mismatch evidence in `metadata`.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Probe options.\n     * @returns {Promise<object>} Content-verified probe report.\n     */\n    static async resolveType(input, options = {})\n    {\n        return resolveTypeWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Test whether bytes look like a Wwise media container.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Candidate wem bytes.\n     * @returns {boolean} True when RIFF/RIFX WAVE signatures are present.\n     */\n    static isWEM(input)\n    {\n        try\n        {\n            return isWEM(toBytes(input));\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Repack Wwise Vorbis wem bytes into a standard Ogg Vorbis stream.\n     *\n     * Lossless container transform (no audio decode/re-encode); output plays\n     * natively where Ogg Vorbis is supported. Equivalent to\n     * `read(input, { emit: \"ogg\" })`.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Options, including a `codebooks` override.\n     * @returns {object} Ogg payload with bytes, timing, and loop metadata.\n     */\n    static toOgg(input, options = {})\n    {\n        return CjsWemFormat.read(input, { ...options, emit: OUTPUT_OGG });\n    }\n\n    /**\n     * Decode wem audio data to per-channel float32 PCM (AudioBuffer-ready).\n     *\n     * Covers Wwise PTADPCM (0x8311) and uncompressed 16-bit PCM. Wwise Vorbis\n     * is not decoded here - repack it with `toOgg()` instead. Equivalent to\n     * `read(input, { emit: \"pcm\" })`.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Read options.\n     * @returns {object} PCM payload with channelData, sample rate, and timing.\n     */\n    static toPcm(input, options = {})\n    {\n        return CjsWemFormat.read(input, { ...options, emit: OUTPUT_PCM });\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        RAW: OUTPUT_RAW,\n        JSON: OUTPUT_JSON,\n        WEM_JSON: OUTPUT_WEM_JSON,\n        OGG: OUTPUT_OGG,\n        PCM: OUTPUT_PCM\n    });\n    static CODEC_NAMES = WEM_CODEC_NAMES;\n    static type = Object.freeze([ \"audio\" ]);\n    static mediaTypes = Object.freeze([ \"audio\" ]);\n    static inputTypes = Object.freeze([ \"wem\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_RAW, OUTPUT_OGG, OUTPUT_PCM ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_WEM_JSON, OUTPUT_RAW ]);\n}\n\nexport default CjsWemFormat;\n"],"names":["FORMAT_NAME","CjsWemFormat","DEFAULT_VALUES","constructor","options","SetValues","normalizeValues","GetValues","Read","input","readWithValues","ReadAsync","Inspect","inspectWithValues","IsSupported","isSupportedWithValues","ToJSON","value","toJsonValue","read","readAsync","inspect","isSupported","resolveType","resolveTypeWithValues","toJSON","isWEM","toBytes","toOgg","emit","OUTPUT_OGG","toPcm","OUTPUT_PCM","Output","Object","freeze","RAW","OUTPUT_RAW","JSON","OUTPUT_JSON","WEM_JSON","OUTPUT_WEM_JSON","OGG","PCM","CODEC_NAMES","WEM_CODEC_NAMES","type","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":";;;AAkBA,MAAMA,WAAW,GAAG,cAAc;;AAElC;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,YAAY,CACzB;EACI,OAAO,GAAGC,cAAc;;AAExB;AACJ;AACA;AACA;AACA;AACIC,EAAAA,WAAWA,CAACC,OAAO,GAAG,EAAE,EACxB;AACI,IAAA,IAAI,CAACC,SAAS,CAACD,OAAO,CAAC;AAC3B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIC,EAAAA,SAASA,CAACD,OAAO,GAAG,EAAE,EACtB;AACI,IAAA,IAAI,CAAC,OAAO,GAAGE,eAAe,CAAC,IAAI,CAAC,OAAO,EAAEF,OAAO,EAAEJ,WAAW,CAAC;AAClE,IAAA,OAAO,IAAI;AACf,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIO,EAAAA,SAASA,CAACH,OAAO,GAAG,EAAE,EACtB;IACI,OAAOE,eAAe,CAAC,IAAI,CAAC,OAAO,EAAEF,OAAO,EAAEJ,WAAW,CAAC;AAC9D,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIQ,EAAAA,IAAIA,CAACC,KAAK,EAAEL,OAAO,GAAG,EAAE,EACxB;IACI,OAAOM,cAAc,CAACD,KAAK,EAAE,IAAI,CAACF,SAAS,CAACH,OAAO,CAAC,CAAC;AACzD,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,MAAMO,SAASA,CAACF,KAAK,EAAEL,OAAO,GAAG,EAAE,EACnC;AACI,IAAA,OAAO,IAAI,CAACI,IAAI,CAACC,KAAK,EAAEL,OAAO,CAAC;AACpC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIQ,EAAAA,OAAOA,CAACH,KAAK,EAAEL,OAAO,GAAG,EAAE,EAC3B;IACI,OAAOS,iBAAiB,CAACJ,KAAK,EAAE,IAAI,CAACF,SAAS,CAACH,OAAO,CAAC,CAAC;AAC5D,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIU,EAAAA,WAAWA,CAACL,KAAK,EAAEL,OAAO,GAAG,EAAE,EAC/B;IACI,OAAOW,qBAAqB,CAACN,KAAK,EAAE,IAAI,CAACF,SAAS,CAACH,OAAO,CAAC,CAAC;AAChE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACIY,MAAMA,CAACC,KAAK,EACZ;IACI,OAAOC,WAAW,CAACD,KAAK,CAAC;AAC7B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOE,IAAIA,CAACV,KAAK,EAAEL,OAAO,GAAG,EAAE,EAC/B;AACI,IAAA,OAAOM,cAAc,CAACD,KAAK,EAAEH,eAAe,CAACJ,cAAc,EAAEE,OAAO,EAAEJ,WAAW,CAAC,CAAC;AACvF,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,aAAaoB,SAASA,CAACX,KAAK,EAAEL,OAAO,GAAG,EAAE,EAC1C;AACI,IAAA,OAAOH,YAAY,CAACkB,IAAI,CAACV,KAAK,EAAEL,OAAO,CAAC;AAC5C,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOiB,OAAOA,CAACZ,KAAK,EAAEL,OAAO,GAAG,EAAE,EAClC;AACI,IAAA,OAAOS,iBAAiB,CAACJ,KAAK,EAAEH,eAAe,CAACJ,cAAc,EAAEE,OAAO,EAAEJ,WAAW,CAAC,CAAC;AAC1F,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOsB,WAAWA,CAACb,KAAK,EAAEL,OAAO,GAAG,EAAE,EACtC;AACI,IAAA,OAAOW,qBAAqB,CAACN,KAAK,EAAEH,eAAe,CAACJ,cAAc,EAAEE,OAAO,EAAEJ,WAAW,CAAC,CAAC;AAC9F,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACI,aAAauB,WAAWA,CAACd,KAAK,EAAEL,OAAO,GAAG,EAAE,EAC5C;AACI,IAAA,OAAOoB,qBAAqB,CAACf,KAAK,EAAEH,eAAe,CAACJ,cAAc,EAAEE,OAAO,EAAEJ,WAAW,CAAC,CAAC;AAC9F,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI,OAAOyB,MAAMA,CAACR,KAAK,EACnB;IACI,OAAOC,WAAW,CAACD,KAAK,CAAC;AAC7B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI,OAAOS,KAAKA,CAACjB,KAAK,EAClB;IACI,IACA;AACI,MAAA,OAAOiB,KAAK,CAACC,OAAO,CAAClB,KAAK,CAAC,CAAC;AAChC,IAAA,CAAC,CACD,MACA;AACI,MAAA,OAAO,KAAK;AAChB,IAAA;AACJ,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACI,OAAOmB,KAAKA,CAACnB,KAAK,EAAEL,OAAO,GAAG,EAAE,EAChC;AACI,IAAA,OAAOH,YAAY,CAACkB,IAAI,CAACV,KAAK,EAAE;AAAE,MAAA,GAAGL,OAAO;AAAEyB,MAAAA,IAAI,EAAEC;AAAW,KAAC,CAAC;AACrE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACI,OAAOC,KAAKA,CAACtB,KAAK,EAAEL,OAAO,GAAG,EAAE,EAChC;AACI,IAAA,OAAOH,YAAY,CAACkB,IAAI,CAACV,KAAK,EAAE;AAAE,MAAA,GAAGL,OAAO;AAAEyB,MAAAA,IAAI,EAAEG;AAAW,KAAC,CAAC;AACrE,EAAA;;AAEA;AACJ;AACA;AACI,EAAA,OAAOC,MAAM,GAAGC,MAAM,CAACC,MAAM,CAAC;AAC1BC,IAAAA,GAAG,EAAEC,UAAU;AACfC,IAAAA,IAAI,EAAEC,WAAW;AACjBC,IAAAA,QAAQ,EAAEC,eAAe;AACzBC,IAAAA,GAAG,EAAEZ,UAAU;AACfa,IAAAA,GAAG,EAAEX;AACT,GAAC,CAAC;EACF,OAAOY,WAAW,GAAGC,eAAe;EACpC,OAAOC,IAAI,GAAGZ,MAAM,CAACC,MAAM,CAAC,CAAE,OAAO,CAAE,CAAC;EACxC,OAAOY,UAAU,GAAGb,MAAM,CAACC,MAAM,CAAC,CAAE,OAAO,CAAE,CAAC;EAC9C,OAAOa,UAAU,GAAGd,MAAM,CAACC,MAAM,CAAC,CAAE,KAAK,CAAE,CAAC;AAC5C,EAAA,OAAOc,WAAW,GAAGf,MAAM,CAACC,MAAM,CAAC,CAAEE,UAAU,EAAEP,UAAU,EAAEE,UAAU,CAAE,CAAC;EAC1E,OAAOkB,gBAAgB,GAAGhB,MAAM,CAACC,MAAM,CAAC,CAAEM,eAAe,EAAEJ,UAAU,CAAE,CAAC;AAC5E;;;;"}