@carbonenginejs/runtime-resource 0.19.2 → 0.22.0

package/dist/formats/black/CjsBlackFormat.js

@@ -1,3 +1,4 @@
+import { CjsFormat } from '../../format/CjsFormat.js';
 import { CLASS_KEYS } from './core/schema.js';
 import { DEFAULT_VALUES, OUTPUT_JSON, OUTPUT_PAYLOAD, normalizeValues, validateClassKey, validateClass, toJsonValue, OUTPUT_DOCUMENT, OUTPUT_RAW, OUTPUT_RUNTIME } from './core/helpers.js';
 import { CJS_BLACK_FOURCC, CJS_BLACK_FORMAT_ID, CJS_BLACK_EXTENSION, CJS_BLACK_VERSION } from './core/blackConstants.js';
@@ -11,7 +12,7 @@ const FORMAT_NAME = "CjsBlackFormat";
  * This package reads public-facing `.black` payload data using CarbonEngineJS
  * canonical schemas or source-shape registries.
  */
-class CjsBlackFormat {
+class CjsBlackFormat extends CjsFormat {
   #emit = DEFAULT_VALUES.emit;
   #schema = DEFAULT_VALUES.schema;
   #readerOptions = {};
@@ -35,6 +36,7 @@ class CjsBlackFormat {
    * @param {object} [options] Default format values.
    */
   constructor(options = {}) {
+    super();
     this.SetValues(options);
   }
 
@@ -263,7 +265,7 @@ class CjsBlackFormat {
    * @param {ArrayBuffer|ArrayBufferView} input Candidate source bytes.
    * @returns {boolean} True when the little-endian Black magic is present.
    */
-  static isSupported(input) {
+  static probeSupport(input) {
     const view = getBlackProbeView(input);
     return Boolean(view && view.byteLength >= 4 && view.getUint32(0, true) === CJS_BLACK_FOURCC);
   }
@@ -283,11 +285,26 @@ class CjsBlackFormat {
   static extensions = Object.freeze([CJS_BLACK_EXTENSION]);
   static fourCC = CJS_BLACK_FOURCC;
   static version = CJS_BLACK_VERSION;
-  static type = Object.freeze(["data"]);
   static mediaTypes = Object.freeze(["data"]);
-  static inputTypes = Object.freeze(["black"]);
-  static outputTypes = Object.freeze([OUTPUT_JSON, OUTPUT_DOCUMENT, OUTPUT_PAYLOAD, OUTPUT_RUNTIME]);
-  static debugOutputTypes = Object.freeze([OUTPUT_RAW]);
+  static outputs = CjsFormat.defineOutputs({
+    json: {
+      default: true,
+      decoded: true
+    },
+    document: {
+      decoded: true
+    },
+    payload: {
+      decoded: true
+    },
+    runtime: {
+      decoded: true
+    },
+    raw: {
+      role: "debug",
+      decoded: true
+    }
+  });
 
   /** Provides the one-shot Black copy reader options helper entry point. */
   static copyReaderOptions(values) {

package/dist/formats/black/CjsBlackFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsBlackFormat.js","sources":["../../../../src/formats/black/CjsBlackFormat.js"],"sourcesContent":["import { CLASS_KEYS } from \"./core/schema.js\";\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_DOCUMENT,\n    OUTPUT_JSON,\n    OUTPUT_PAYLOAD,\n    OUTPUT_RAW,\n    OUTPUT_RUNTIME,\n    normalizeValues,\n    toJsonValue,\n    validateClass,\n    validateClassKey\n} from \"./core/helpers.js\";\nimport {\n    CJS_BLACK_EXTENSION,\n    CJS_BLACK_FORMAT_ID,\n    CJS_BLACK_FOURCC,\n    CJS_BLACK_VERSION\n} from \"./core/blackConstants.js\";\nimport { CjsBlackReader } from \"./core/CjsBlackReader.js\";\n\nconst FORMAT_NAME = \"CjsBlackFormat\";\n\n/**\n * CarbonEngineJS-facing Black format profile.\n *\n * This package reads public-facing `.black` payload data using CarbonEngineJS\n * canonical schemas or source-shape registries.\n */\nexport class CjsBlackFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #schema = DEFAULT_VALUES.schema;\n    #readerOptions = {};\n    #classes = {};\n\n    /**\n     * Plain payload outputs can be decoded in a browser worker. Document and\n     * runtime outputs retain class identity and therefore stay on the caller\n     * thread.\n     */\n    static worker = Object.freeze({\n        module: import.meta.url,\n        exportName: \"CjsBlackFormat\",\n        outputTypes: Object.freeze([ OUTPUT_JSON, OUTPUT_PAYLOAD ]),\n        defaultOutput: OUTPUT_JSON\n    });\n\n    /**\n     * Create a reusable format profile.\n     *\n     * @param {object} [options] Default format values.\n     */\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    /**\n     * Set format values for this reusable profile.\n     *\n     * @param {object} [options] Values to merge into the profile.\n     * @returns {CjsBlackFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        const values = normalizeValues(this.GetValues(), options, CLASS_KEYS, FORMAT_NAME);\n        this.#emit = values.emit;\n        this.#schema = values.schema;\n        this.#classes = values.classes;\n        this.#readerOptions = CjsBlackFormat.copyReaderOptions(values);\n        return this;\n    }\n\n    /**\n     * Get this profile's current values, optionally with per-call overrides.\n     *\n     * @param {object} [options] Optional values to merge into a copy.\n     * @returns {object} A copy of the effective values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues({\n            emit: this.#emit,\n            schema: this.#schema,\n            ...this.#readerOptions,\n            classes: this.#classes\n        }, options, CLASS_KEYS, FORMAT_NAME);\n    }\n\n    /**\n     * Set multiple runtime class constructors for this profile.\n     *\n     * @param {object} [classes] Map of Black class names to constructors.\n     * @returns {CjsBlackFormat} This format profile.\n     */\n    SetClasses(classes = {})\n    {\n        return this.SetValues({ classes });\n    }\n\n    /**\n     * Set one node-class constructor for this profile.\n     *\n     * @param {string} type Black class name.\n     * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.\n     * @returns {CjsBlackFormat} This format profile.\n     */\n    SetClass(type, Class)\n    {\n        validateClassKey(CLASS_KEYS, type, FORMAT_NAME);\n        if (Class === null || Class === undefined)\n        {\n            delete this.#classes[type];\n            return this;\n        }\n\n        validateClass(CLASS_KEYS, type, Class, FORMAT_NAME);\n        this.#classes = { ...this.#classes, [type]: Class };\n        return this;\n    }\n\n    /**\n     * Get a configured runtime class constructor.\n     *\n     * @param {string} type Black class name.\n     * @returns {Function|undefined} The registered constructor, if any.\n     */\n    GetClass(type)\n    {\n        validateClassKey(CLASS_KEYS, type, FORMAT_NAME);\n        return this.#classes[type];\n    }\n\n    /**\n     * Whether this format profile has a constructor registered for a node key.\n     *\n     * @param {string} type Node class key.\n     * @returns {boolean} True when a constructor is registered.\n     */\n    HasClass(type)\n    {\n        return !!this.GetClass(type);\n    }\n\n    /**\n     * Read Black data with this profile's values.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Public payload output by default.\n     */\n    Read(input, options = {})\n    {\n        return CjsBlackFormat.read(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as a neutral document graph for diagnostics.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} CarbonEngineJS document graph.\n     */\n    ReadDocument(input, options = {})\n    {\n        return CjsBlackFormat.readDocument(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as runtime objects or plain source-shaped objects.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Runtime read result.\n     */\n    ReadRuntime(input, options = {})\n    {\n        return CjsBlackFormat.readRuntime(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as compact public payload JSON.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Public payload output.\n     */\n    ReadPayload(input, options = {})\n    {\n        return CjsBlackFormat.readPayload(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect Black data with this profile's values.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return CjsBlackFormat.inspect(input, this.GetValues(options));\n    }\n\n    /**\n     * Convert format output to JSON-compatible data.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Static one-shot read. Static methods use camelCase by convention.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Format output.\n     */\n    static read(input, options = {})\n    {\n        const values = normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME);\n        if (values.emit === OUTPUT_DOCUMENT || values.emit === OUTPUT_RAW) return CjsBlackFormat.readDocument(input, values);\n        if (values.emit === OUTPUT_RUNTIME) return CjsBlackFormat.readRuntime(input, values);\n        return CjsBlackFormat.readPayload(input, values);\n    }\n\n    /**\n     * Static one-shot document read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} CarbonEngineJS document graph.\n     */\n    static readDocument(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadDocument();\n    }\n\n    /**\n     * Static one-shot runtime read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Runtime read result.\n     */\n    static readRuntime(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadRuntime();\n    }\n\n    /**\n     * Static one-shot public payload read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Public payload output.\n     */\n    static readPayload(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadPayload();\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).Inspect();\n    }\n\n    /**\n     * Static JSON-compatible conversion.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Performs the bounded Black content discriminator used by ordered object\n     * routes. Magic selects the Black reader; version and body failures remain\n     * that reader's errors and are never reinterpreted as Red/YAML.\n     *\n     * @param {ArrayBuffer|ArrayBufferView} input Candidate source bytes.\n     * @returns {boolean} True when the little-endian Black magic is present.\n     */\n    static isSupported(input)\n    {\n        const view = getBlackProbeView(input);\n        return Boolean(\n            view\n            && view.byteLength >= 4\n            && view.getUint32(0, true) === CJS_BLACK_FOURCC\n        );\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        JSON: OUTPUT_JSON,\n        RAW: OUTPUT_RAW,\n        DOCUMENT: OUTPUT_DOCUMENT,\n        PAYLOAD: OUTPUT_PAYLOAD,\n        RUNTIME: OUTPUT_RUNTIME\n    });\n    static CLASS_KEYS = CLASS_KEYS;\n    static id = CJS_BLACK_FORMAT_ID;\n    static extensions = Object.freeze([CJS_BLACK_EXTENSION]);\n    static fourCC = CJS_BLACK_FOURCC;\n    static version = CJS_BLACK_VERSION;\n    static type = Object.freeze([ \"data\" ]);\n    static mediaTypes = Object.freeze([ \"data\" ]);\n    static inputTypes = Object.freeze([ \"black\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON, OUTPUT_DOCUMENT, OUTPUT_PAYLOAD, OUTPUT_RUNTIME ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW ]);\n\n    /** Provides the one-shot Black copy reader options helper entry point. */\n    static copyReaderOptions(values)\n    {\n        const {\n            emit: _emit,\n            schema: _schema,\n            classes: _classes,\n            ...readerOptions\n        } = values;\n        return readerOptions;\n    }\n\n}\n\nfunction getBlackProbeView(input)\n{\n    if (input instanceof ArrayBuffer) return new DataView(input);\n    if (!ArrayBuffer.isView(input)) return null;\n    return new DataView(input.buffer, input.byteOffset, input.byteLength);\n}\n\nexport default CjsBlackFormat;\n"],"names":["FORMAT_NAME","CjsBlackFormat","DEFAULT_VALUES","emit","schema","worker","Object","freeze","module","import","meta","url","exportName","outputTypes","OUTPUT_JSON","OUTPUT_PAYLOAD","defaultOutput","constructor","options","SetValues","values","normalizeValues","GetValues","CLASS_KEYS","classes","copyReaderOptions","SetClasses","SetClass","type","Class","validateClassKey","undefined","validateClass","GetClass","HasClass","Read","input","read","ReadDocument","readDocument","ReadRuntime","readRuntime","ReadPayload","readPayload","Inspect","inspect","ToJSON","value","toJsonValue","OUTPUT_DOCUMENT","OUTPUT_RAW","OUTPUT_RUNTIME","CjsBlackReader","toJSON","isSupported","view","getBlackProbeView","Boolean","byteLength","getUint32","CJS_BLACK_FOURCC","Output","JSON","RAW","DOCUMENT","PAYLOAD","RUNTIME","id","CJS_BLACK_FORMAT_ID","extensions","CJS_BLACK_EXTENSION","fourCC","version","CJS_BLACK_VERSION","mediaTypes","inputTypes","debugOutputTypes","_emit","_schema","_classes","readerOptions","ArrayBuffer","DataView","isView","buffer","byteOffset"],"mappings":"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"}
+{"version":3,"file":"CjsBlackFormat.js","sources":["../../../../src/formats/black/CjsBlackFormat.js"],"sourcesContent":["import { CjsFormat } from \"../../format/CjsFormat.js\";\nimport { CLASS_KEYS } from \"./core/schema.js\";\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_DOCUMENT,\n    OUTPUT_JSON,\n    OUTPUT_PAYLOAD,\n    OUTPUT_RAW,\n    OUTPUT_RUNTIME,\n    normalizeValues,\n    toJsonValue,\n    validateClass,\n    validateClassKey\n} from \"./core/helpers.js\";\nimport {\n    CJS_BLACK_EXTENSION,\n    CJS_BLACK_FORMAT_ID,\n    CJS_BLACK_FOURCC,\n    CJS_BLACK_VERSION\n} from \"./core/blackConstants.js\";\nimport { CjsBlackReader } from \"./core/CjsBlackReader.js\";\n\nconst FORMAT_NAME = \"CjsBlackFormat\";\n\n/**\n * CarbonEngineJS-facing Black format profile.\n *\n * This package reads public-facing `.black` payload data using CarbonEngineJS\n * canonical schemas or source-shape registries.\n */\nexport class CjsBlackFormat extends CjsFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #schema = DEFAULT_VALUES.schema;\n    #readerOptions = {};\n    #classes = {};\n\n    /**\n     * Plain payload outputs can be decoded in a browser worker. Document and\n     * runtime outputs retain class identity and therefore stay on the caller\n     * thread.\n     */\n    static worker = Object.freeze({\n        module: import.meta.url,\n        exportName: \"CjsBlackFormat\",\n        outputTypes: Object.freeze([ OUTPUT_JSON, OUTPUT_PAYLOAD ]),\n        defaultOutput: OUTPUT_JSON\n    });\n\n    /**\n     * Create a reusable format profile.\n     *\n     * @param {object} [options] Default format values.\n     */\n    constructor(options = {})\n    {\n        super();\n        this.SetValues(options);\n    }\n\n    /**\n     * Set format values for this reusable profile.\n     *\n     * @param {object} [options] Values to merge into the profile.\n     * @returns {CjsBlackFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        const values = normalizeValues(this.GetValues(), options, CLASS_KEYS, FORMAT_NAME);\n        this.#emit = values.emit;\n        this.#schema = values.schema;\n        this.#classes = values.classes;\n        this.#readerOptions = CjsBlackFormat.copyReaderOptions(values);\n        return this;\n    }\n\n    /**\n     * Get this profile's current values, optionally with per-call overrides.\n     *\n     * @param {object} [options] Optional values to merge into a copy.\n     * @returns {object} A copy of the effective values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues({\n            emit: this.#emit,\n            schema: this.#schema,\n            ...this.#readerOptions,\n            classes: this.#classes\n        }, options, CLASS_KEYS, FORMAT_NAME);\n    }\n\n    /**\n     * Set multiple runtime class constructors for this profile.\n     *\n     * @param {object} [classes] Map of Black class names to constructors.\n     * @returns {CjsBlackFormat} This format profile.\n     */\n    SetClasses(classes = {})\n    {\n        return this.SetValues({ classes });\n    }\n\n    /**\n     * Set one node-class constructor for this profile.\n     *\n     * @param {string} type Black class name.\n     * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.\n     * @returns {CjsBlackFormat} This format profile.\n     */\n    SetClass(type, Class)\n    {\n        validateClassKey(CLASS_KEYS, type, FORMAT_NAME);\n        if (Class === null || Class === undefined)\n        {\n            delete this.#classes[type];\n            return this;\n        }\n\n        validateClass(CLASS_KEYS, type, Class, FORMAT_NAME);\n        this.#classes = { ...this.#classes, [type]: Class };\n        return this;\n    }\n\n    /**\n     * Get a configured runtime class constructor.\n     *\n     * @param {string} type Black class name.\n     * @returns {Function|undefined} The registered constructor, if any.\n     */\n    GetClass(type)\n    {\n        validateClassKey(CLASS_KEYS, type, FORMAT_NAME);\n        return this.#classes[type];\n    }\n\n    /**\n     * Whether this format profile has a constructor registered for a node key.\n     *\n     * @param {string} type Node class key.\n     * @returns {boolean} True when a constructor is registered.\n     */\n    HasClass(type)\n    {\n        return !!this.GetClass(type);\n    }\n\n    /**\n     * Read Black data with this profile's values.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Public payload output by default.\n     */\n    Read(input, options = {})\n    {\n        return CjsBlackFormat.read(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as a neutral document graph for diagnostics.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} CarbonEngineJS document graph.\n     */\n    ReadDocument(input, options = {})\n    {\n        return CjsBlackFormat.readDocument(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as runtime objects or plain source-shaped objects.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Runtime read result.\n     */\n    ReadRuntime(input, options = {})\n    {\n        return CjsBlackFormat.readRuntime(input, this.GetValues(options));\n    }\n\n    /**\n     * Read Black data as compact public payload JSON.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Public payload output.\n     */\n    ReadPayload(input, options = {})\n    {\n        return CjsBlackFormat.readPayload(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect Black data with this profile's values.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return CjsBlackFormat.inspect(input, this.GetValues(options));\n    }\n\n    /**\n     * Convert format output to JSON-compatible data.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Static one-shot read. Static methods use camelCase by convention.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Format output.\n     */\n    static read(input, options = {})\n    {\n        const values = normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME);\n        if (values.emit === OUTPUT_DOCUMENT || values.emit === OUTPUT_RAW) return CjsBlackFormat.readDocument(input, values);\n        if (values.emit === OUTPUT_RUNTIME) return CjsBlackFormat.readRuntime(input, values);\n        return CjsBlackFormat.readPayload(input, values);\n    }\n\n    /**\n     * Static one-shot document read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} CarbonEngineJS document graph.\n     */\n    static readDocument(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadDocument();\n    }\n\n    /**\n     * Static one-shot runtime read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Runtime read result.\n     */\n    static readRuntime(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadRuntime();\n    }\n\n    /**\n     * Static one-shot public payload read.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Public payload output.\n     */\n    static readPayload(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadPayload();\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {unknown} input Black format input.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).Inspect();\n    }\n\n    /**\n     * Static JSON-compatible conversion.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Performs the bounded Black content discriminator used by ordered object\n     * routes. Magic selects the Black reader; version and body failures remain\n     * that reader's errors and are never reinterpreted as Red/YAML.\n     *\n     * @param {ArrayBuffer|ArrayBufferView} input Candidate source bytes.\n     * @returns {boolean} True when the little-endian Black magic is present.\n     */\n    static probeSupport(input)\n    {\n        const view = getBlackProbeView(input);\n        return Boolean(\n            view\n            && view.byteLength >= 4\n            && view.getUint32(0, true) === CJS_BLACK_FOURCC\n        );\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        JSON: OUTPUT_JSON,\n        RAW: OUTPUT_RAW,\n        DOCUMENT: OUTPUT_DOCUMENT,\n        PAYLOAD: OUTPUT_PAYLOAD,\n        RUNTIME: OUTPUT_RUNTIME\n    });\n    static CLASS_KEYS = CLASS_KEYS;\n    static id = CJS_BLACK_FORMAT_ID;\n    static extensions = Object.freeze([CJS_BLACK_EXTENSION]);\n    static fourCC = CJS_BLACK_FOURCC;\n    static version = CJS_BLACK_VERSION;\n    static mediaTypes = Object.freeze([ \"data\" ]);\n    static outputs = CjsFormat.defineOutputs({\n        json: { default: true, decoded: true },\n        document: { decoded: true },\n        payload: { decoded: true },\n        runtime: { decoded: true },\n        raw: { role: \"debug\", decoded: true }\n    });\n\n    /** Provides the one-shot Black copy reader options helper entry point. */\n    static copyReaderOptions(values)\n    {\n        const {\n            emit: _emit,\n            schema: _schema,\n            classes: _classes,\n            ...readerOptions\n        } = values;\n        return readerOptions;\n    }\n\n}\n\nfunction getBlackProbeView(input)\n{\n    if (input instanceof ArrayBuffer) return new DataView(input);\n    if (!ArrayBuffer.isView(input)) return null;\n    return new DataView(input.buffer, input.byteOffset, input.byteLength);\n}\n\nexport default CjsBlackFormat;\n"],"names":["FORMAT_NAME","CjsBlackFormat","CjsFormat","DEFAULT_VALUES","emit","schema","worker","Object","freeze","module","import","meta","url","exportName","outputTypes","OUTPUT_JSON","OUTPUT_PAYLOAD","defaultOutput","constructor","options","SetValues","values","normalizeValues","GetValues","CLASS_KEYS","classes","copyReaderOptions","SetClasses","SetClass","type","Class","validateClassKey","undefined","validateClass","GetClass","HasClass","Read","input","read","ReadDocument","readDocument","ReadRuntime","readRuntime","ReadPayload","readPayload","Inspect","inspect","ToJSON","value","toJsonValue","OUTPUT_DOCUMENT","OUTPUT_RAW","OUTPUT_RUNTIME","CjsBlackReader","toJSON","probeSupport","view","getBlackProbeView","Boolean","byteLength","getUint32","CJS_BLACK_FOURCC","Output","JSON","RAW","DOCUMENT","PAYLOAD","RUNTIME","id","CJS_BLACK_FORMAT_ID","extensions","CJS_BLACK_EXTENSION","fourCC","version","CJS_BLACK_VERSION","mediaTypes","outputs","defineOutputs","json","default","decoded","document","payload","runtime","raw","role","_emit","_schema","_classes","readerOptions","ArrayBuffer","DataView","isView","buffer","byteOffset"],"mappings":"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"}

package/dist/formats/bnk/CjsBnkFormat.js

@@ -1,5 +1,6 @@
+import { CjsFormat } from '../../format/CjsFormat.js';
 import { wwiseIdFromName, joinSoundbanksInfo, buildSoundbanksCatalog, parseSoundbanksInfo, isSoundbanksInfo } from './core/soundbanksInfo.js';
-import { DEFAULT_VALUES, normalizeValues, readWithValues, inspectWithValues, isSupportedWithValues, toJsonValue, toBytes, extractMedia, isBNK, OUTPUT_MEDIA, OUTPUT_BNK_JSON, OUTPUT_JSON, OUTPUT_RAW, HIRC_TYPE_NAMES, HIRC_V150_TYPE_NAMES } from './core/helpers.js';
+import { DEFAULT_VALUES, OUTPUT_RAW, OUTPUT_MEDIA, OUTPUT_BNK_JSON, normalizeValues, readWithValues, inspectWithValues, toJsonValue, probeSupportWithValues, toBytes, extractMedia, isBNK, OUTPUT_JSON, HIRC_TYPE_NAMES, HIRC_V150_TYPE_NAMES } from './core/helpers.js';
 import { eventMediaFromBanks } from './core/graph.js';
 import { parseEventAction } from './core/eventAction.js';
 import { parseGlobalSettings } from './core/globalSettings.js';
@@ -10,9 +11,9 @@ import { parseSfxLayer, parseSfxSwitch, parseSfxRandomSequence, parseSfxAttenuat
 
 const FORMAT_NAME = "CjsBnkFormat";
 
-/**
- * Reader for Audiokinetic Wwise soundbank (.bnk) containers.
- *
+/**
+ * Reader for Audiokinetic Wwise soundbank (.bnk) containers.
+ *
  * Inspection decodes the bank header, embedded media index, exact v150 global
  * settings, object hierarchy listing (with version-stable typed fields), and
  * referenced bank names without copying payloads. Read can emit the raw bank,
@@ -21,7 +22,7 @@ const FORMAT_NAME = "CjsBnkFormat";
  * helpers, id hash, event -> media graph resolution) is grouped under the
  * `wwise` static.
  */
-class CjsBnkFormat {
+class CjsBnkFormat extends CjsFormat {
   #values = DEFAULT_VALUES;
 
   /**
@@ -29,143 +30,135 @@ class CjsBnkFormat {
    */
   static worker = Object.freeze({
     module: import.meta.url,
-    exportName: "CjsBnkFormat"
+    exportName: "CjsBnkFormat",
+    outputTypes: Object.freeze([OUTPUT_RAW, OUTPUT_MEDIA, OUTPUT_BNK_JSON]),
+    defaultOutput: OUTPUT_RAW
   });
 
-  /**
-   * Create a reusable bnk format profile.
-   *
-   * @param {object} [options] Default read/inspect options.
+  /**
+   * Create a reusable bnk format profile.
+   *
+   * @param {object} [options] Default read/inspect options.
    */
   constructor(options = {}) {
+    super();
     this.SetValues(options);
   }
 
-  /**
-   * Merge options into this profile.
-   *
-   * @param {object} [options] Values to merge.
-   * @returns {CjsBnkFormat} This format profile.
+  /**
+   * Merge options into this profile.
+   *
+   * @param {object} [options] Values to merge.
+   * @returns {CjsBnkFormat} 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.
+  /**
+   * 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 soundbank bytes with this profile.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.
-   * @param {object} [options] Per-call values.
-   * @returns {object} GPU-free raw/debug/media payload for the selected emit target.
+  /**
+   * Read soundbank bytes with this profile.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.
+   * @param {object} [options] Per-call values.
+   * @returns {object} GPU-free raw/debug/media payload for the selected emit target.
    */
   Read(input, options = {}) {
     return readWithValues(input, this.GetValues(options));
   }
 
-  /**
-   * Read soundbank bytes asynchronously with this profile.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.
-   * @param {object} [options] Per-call values.
-   * @returns {Promise<object>} GPU-free raw/debug/media payload for the selected emit target.
+  /**
+   * Read soundbank bytes asynchronously with this profile.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.
+   * @param {object} [options] Per-call values.
+   * @returns {Promise<object>} GPU-free raw/debug/media payload for the selected emit target.
    */
   async ReadAsync(input, options = {}) {
     return this.Read(input, options);
   }
 
-  /**
-   * Inspect soundbank bytes without copying media payloads.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.
-   * @param {object} [options] Per-call values.
-   * @returns {object} Soundbank metadata.
+  /**
+   * Inspect soundbank bytes without copying media payloads.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.
+   * @param {object} [options] Per-call values.
+   * @returns {object} Soundbank metadata.
    */
   Inspect(input, options = {}) {
     return inspectWithValues(input, this.GetValues(options));
   }
 
-  /**
-   * Report whether soundbank input and requested output variants are supported.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank 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.
+  /**
+   * 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 soundbank read.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.
-   * @param {object} [options] Read options.
-   * @returns {object} GPU-free raw/debug/media payload for the selected emit target.
+  /**
+   * One-shot soundbank read.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.
+   * @param {object} [options] Read options.
+   * @returns {object} GPU-free raw/debug/media payload for the selected emit target.
    */
   static read(input, options = {}) {
     return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
   }
 
-  /**
-   * One-shot asynchronous soundbank read.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.
-   * @param {object} [options] Read options.
-   * @returns {Promise<object>} GPU-free raw/debug/media payload for the selected emit target.
+  /**
+   * One-shot asynchronous soundbank read.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.
+   * @param {object} [options] Read options.
+   * @returns {Promise<object>} GPU-free raw/debug/media payload for the selected emit target.
    */
   static async readAsync(input, options = {}) {
     return CjsBnkFormat.read(input, options);
   }
 
-  /**
-   * One-shot soundbank inspection.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.
-   * @param {object} [options] Inspect options.
-   * @returns {object} Soundbank metadata.
+  /**
+   * One-shot soundbank inspection.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.
+   * @param {object} [options] Inspect options.
+   * @returns {object} Soundbank metadata.
    */
   static inspect(input, options = {}) {
     return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
   }
 
-  /**
-   * One-shot soundbank support probe.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.
-   * @param {object} [options] Probe options.
-   * @returns {object} Support/probe report.
+  /**
+   * One-shot soundbank support probe.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.
+   * @param {object} [options] Probe options.
+   * @returns {object} Support/probe report.
    */
-  static isSupported(input, options = {}) {
-    return isSupportedWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  static probeSupport(input, options = {}) {
+    return probeSupportWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
   }
 
-  /**
-   * Extract embedded media payloads as views over the soundbank bytes.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.
-   * @param {number} [mediaId] Optional single media id filter.
-   * @returns {Array<object>} Extracted media items with undecoded bytes.
+  /**
+   * Extract embedded media payloads as views over the soundbank bytes.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.
+   * @param {number} [mediaId] Optional single media id filter.
+   * @returns {Array<object>} Extracted media items with undecoded bytes.
    */
   static extractMedia(input, mediaId) {
     const bytes = toBytes(input);
@@ -173,21 +166,21 @@ class CjsBnkFormat {
     return extractMedia(bytes, metadata, mediaId);
   }
 
-  /**
-   * Convert format output into JSON-compatible debug data.
-   *
-   * @param {any} value Format output.
-   * @returns {any} JSON-compatible value.
+  /**
+   * 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 soundbank.
-   *
-   * @param {Uint8Array|ArrayBuffer|DataView} input Candidate soundbank bytes.
-   * @returns {boolean} True when the BKHD header chunk is present.
+  /**
+   * Test whether bytes look like a Wwise soundbank.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView} input Candidate soundbank bytes.
+   * @returns {boolean} True when the BKHD header chunk is present.
    */
   static isBNK(input) {
     try {
@@ -197,24 +190,24 @@ class CjsBnkFormat {
     }
   }
 
-  /**
-   * Wwise-domain toolkit, grouped apart from the container-reading statics -
-   * the single home for the SoundbanksInfo catalog helpers
-   * (`isSoundbanksInfo`, `parseSoundbanksInfo`, `buildSoundbanksCatalog`,
-   * `joinSoundbanksInfo`), the id hash (`wwiseIdFromName`, FNV-1 of the
-   * lowercased name), and event-graph resolution.
-   *
-   * `eventMediaFromBanks(inspections, options)` is graph interpretation over
-   * `inspect()` results, not a read path: banks may split events from their
-   * target objects (EVE keeps all events in one bank and their sounds in
-   * others), so always pass every related bank to one call. Returns
-   * `{ eventMedia: Map<eventObjectId, Set<wemId>>, diagnostics }`. See
-   * core/graph.js for the walk policy.
-   *
-   * The interactive-music decoders (`musicNodesFromBanks` and the per-type
-   * `parseMusicSegment/Track/Playlist/Switch`) turn the music-hierarchy
-   * entries (HIRC 10-13) into typed nodes - children, meter, cue markers,
-   * clips, playlist trees, decision trees, and transition rules. See
+  /**
+   * Wwise-domain toolkit, grouped apart from the container-reading statics -
+   * the single home for the SoundbanksInfo catalog helpers
+   * (`isSoundbanksInfo`, `parseSoundbanksInfo`, `buildSoundbanksCatalog`,
+   * `joinSoundbanksInfo`), the id hash (`wwiseIdFromName`, FNV-1 of the
+   * lowercased name), and event-graph resolution.
+   *
+   * `eventMediaFromBanks(inspections, options)` is graph interpretation over
+   * `inspect()` results, not a read path: banks may split events from their
+   * target objects (EVE keeps all events in one bank and their sounds in
+   * others), so always pass every related bank to one call. Returns
+   * `{ eventMedia: Map<eventObjectId, Set<wemId>>, diagnostics }`. See
+   * core/graph.js for the walk policy.
+   *
+   * The interactive-music decoders (`musicNodesFromBanks` and the per-type
+   * `parseMusicSegment/Track/Playlist/Switch`) turn the music-hierarchy
+   * entries (HIRC 10-13) into typed nodes - children, meter, cue markers,
+   * clips, playlist trees, decision trees, and transition rules. See
    * core/musicNodes.js for the anchored, exact-end-validated parse.
    *
    * The v150 authored-SFX decoders (`sfxNodesFromBanks` and the per-type
@@ -259,8 +252,8 @@ class CjsBnkFormat {
     parseSfxLayer
   });
 
-  /**
-   * Emit targets for this format (canonical frozen enum).
+  /**
+   * Emit targets for this format (canonical frozen enum).
    */
   static Output = Object.freeze({
     RAW: OUTPUT_RAW,
@@ -270,11 +263,20 @@ class CjsBnkFormat {
   });
   static HIRC_TYPE_NAMES = HIRC_TYPE_NAMES;
   static HIRC_V150_TYPE_NAMES = HIRC_V150_TYPE_NAMES;
-  static type = Object.freeze(["audio"]);
+  static id = "bnk";
   static mediaTypes = Object.freeze(["audio"]);
-  static inputTypes = Object.freeze(["bnk"]);
-  static outputTypes = Object.freeze([OUTPUT_RAW, OUTPUT_MEDIA]);
-  static debugOutputTypes = Object.freeze([OUTPUT_BNK_JSON, OUTPUT_RAW]);
+  static outputs = CjsFormat.defineOutputs({
+    raw: {
+      default: true,
+      passthrough: true
+    },
+    media: {},
+    bnkJson: {
+      role: "debug",
+      probes: ["bnkJson", "raw"]
+    }
+  });
+  static extensions = Object.freeze([".bnk"]);
 }
 
 export { CjsBnkFormat };

package/dist/formats/bnk/CjsBnkFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsBnkFormat.js","sources":["../../../../src/formats/bnk/CjsBnkFormat.js"],"sourcesContent":["import {\n    buildSoundbanksCatalog,\r\n    isSoundbanksInfo,\r\n    joinSoundbanksInfo,\r\n    parseSoundbanksInfo,\r\n    wwiseIdFromName\r\n} from \"./core/soundbanksInfo.js\";\r\nimport {\r\n    DEFAULT_VALUES,\n    HIRC_TYPE_NAMES,\n    HIRC_V150_TYPE_NAMES,\n    OUTPUT_BNK_JSON,\r\n    OUTPUT_JSON,\r\n    OUTPUT_MEDIA,\r\n    OUTPUT_RAW,\r\n    extractMedia,\r\n    inspectWithValues,\r\n    isBNK,\r\n    isSupportedWithValues,\r\n    normalizeValues,\r\n    readWithValues,\r\n    toBytes,\r\n    toJsonValue\r\n} from \"./core/helpers.js\";\r\nimport { eventMediaFromBanks } from \"./core/graph.js\";\nimport { parseEventAction } from \"./core/eventAction.js\";\nimport { parseGlobalSettings } from \"./core/globalSettings.js\";\nimport {\n    busNodesFromBanks,\n    parseBusNode\n} from \"./core/busNodes.js\";\nimport {\n    effectNodesFromBanks,\n    parseEffectNode\n} from \"./core/effectNodes.js\";\nimport {\r\n    musicNodesFromBanks,\r\n    parseMusicPlaylist,\r\n    parseMusicSegment,\r\n    parseMusicSwitch,\r\n    parseMusicTrack\r\n} from \"./core/musicNodes.js\";\nimport {\n    parseSfxActorMixer,\n    parseSfxAttenuation,\n    parseSfxLayer,\n    parseSfxRandomSequence,\n    parseSfxSwitch,\n    sfxNodesFromBanks\n} from \"./core/sfxNodes.js\";\n\r\nconst FORMAT_NAME = \"CjsBnkFormat\";\r\n\r\n/**\r\n * Reader for Audiokinetic Wwise soundbank (.bnk) containers.\r\n *\r\n * Inspection decodes the bank header, embedded media index, exact v150 global\n * settings, object hierarchy listing (with version-stable typed fields), and\n * referenced bank names without copying payloads. Read can emit the raw bank,\n * debug JSON, or the embedded media items undecoded. The read path stays a\n * pure container reader; the Wwise-domain toolkit (SoundbanksInfo catalog\n * helpers, id hash, event -> media graph resolution) is grouped under the\n * `wwise` static.\n */\r\nexport class CjsBnkFormat\n{\n    #values = DEFAULT_VALUES;\n\n    /**\n     * Browser-worker module declaration consumed by CjsResManWorkerLoader.\n     */\n    static worker = Object.freeze({\n        module: import.meta.url,\n        exportName: \"CjsBnkFormat\"\n    });\n\r\n    /**\r\n     * Create a reusable bnk format profile.\r\n     *\r\n     * @param {object} [options] Default read/inspect options.\r\n     */\r\n    constructor(options = {})\r\n    {\r\n        this.SetValues(options);\r\n    }\r\n\r\n    /**\r\n     * Merge options into this profile.\r\n     *\r\n     * @param {object} [options] Values to merge.\r\n     * @returns {CjsBnkFormat} This format profile.\r\n     */\r\n    SetValues(options = {})\r\n    {\r\n        this.#values = normalizeValues(this.#values, options, FORMAT_NAME);\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Get normalized profile values with optional per-call overrides.\r\n     *\r\n     * @param {object} [options] Per-call values.\r\n     * @returns {object} Normalized read values.\r\n     */\r\n    GetValues(options = {})\r\n    {\r\n        return normalizeValues(this.#values, options, FORMAT_NAME);\r\n    }\r\n\r\n    /**\r\n     * Read soundbank bytes with this profile.\r\n     *\r\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\r\n     * @param {object} [options] Per-call values.\r\n     * @returns {object} GPU-free raw/debug/media payload for the selected emit target.\r\n     */\r\n    Read(input, options = {})\r\n    {\r\n        return readWithValues(input, this.GetValues(options));\r\n    }\r\n\r\n    /**\r\n     * Read soundbank bytes asynchronously with this profile.\r\n     *\r\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\r\n     * @param {object} [options] Per-call values.\r\n     * @returns {Promise<object>} GPU-free raw/debug/media payload for the selected emit target.\r\n     */\r\n    async ReadAsync(input, options = {})\r\n    {\r\n        return this.Read(input, options);\r\n    }\r\n\r\n    /**\r\n     * Inspect soundbank bytes without copying media payloads.\r\n     *\r\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\r\n     * @param {object} [options] Per-call values.\r\n     * @returns {object} Soundbank metadata.\r\n     */\r\n    Inspect(input, options = {})\r\n    {\r\n        return inspectWithValues(input, this.GetValues(options));\r\n    }\r\n\r\n    /**\r\n     * Report whether soundbank input and requested output variants are supported.\r\n     *\r\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\r\n     * @param {object} [options] Per-call values.\r\n     * @returns {object} Support/probe report.\r\n     */\r\n    IsSupported(input, options = {})\r\n    {\r\n        return isSupportedWithValues(input, this.GetValues(options));\r\n    }\r\n\r\n    /**\r\n     * Convert format output into JSON-compatible debug data.\r\n     *\r\n     * @param {any} value Format output.\r\n     * @returns {any} JSON-compatible value.\r\n     */\r\n    ToJSON(value)\r\n    {\r\n        return toJsonValue(value);\r\n    }\r\n\r\n    /**\r\n     * One-shot soundbank read.\r\n     *\r\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\r\n     * @param {object} [options] Read options.\r\n     * @returns {object} GPU-free raw/debug/media payload for the selected emit target.\r\n     */\r\n    static read(input, options = {})\r\n    {\r\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\r\n    }\r\n\r\n    /**\r\n     * One-shot asynchronous soundbank read.\r\n     *\r\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\r\n     * @param {object} [options] Read options.\r\n     * @returns {Promise<object>} GPU-free raw/debug/media payload for the selected emit target.\r\n     */\r\n    static async readAsync(input, options = {})\r\n    {\r\n        return CjsBnkFormat.read(input, options);\r\n    }\r\n\r\n    /**\r\n     * One-shot soundbank inspection.\r\n     *\r\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\r\n     * @param {object} [options] Inspect options.\r\n     * @returns {object} Soundbank metadata.\r\n     */\r\n    static inspect(input, options = {})\r\n    {\r\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\r\n    }\r\n\r\n    /**\r\n     * One-shot soundbank support probe.\r\n     *\r\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\r\n     * @param {object} [options] Probe options.\r\n     * @returns {object} Support/probe report.\r\n     */\r\n    static isSupported(input, options = {})\r\n    {\r\n        return isSupportedWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\r\n    }\r\n\r\n    /**\r\n     * Extract embedded media payloads as views over the soundbank bytes.\r\n     *\r\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\r\n     * @param {number} [mediaId] Optional single media id filter.\r\n     * @returns {Array<object>} Extracted media items with undecoded bytes.\r\n     */\r\n    static extractMedia(input, mediaId)\r\n    {\r\n        const bytes = toBytes(input);\r\n        const metadata = inspectWithValues(bytes, DEFAULT_VALUES);\r\n        return extractMedia(bytes, metadata, mediaId);\r\n    }\r\n\r\n    /**\r\n     * Convert format output into JSON-compatible debug data.\r\n     *\r\n     * @param {any} value Format output.\r\n     * @returns {any} JSON-compatible value.\r\n     */\r\n    static toJSON(value)\r\n    {\r\n        return toJsonValue(value);\r\n    }\r\n\r\n    /**\r\n     * Test whether bytes look like a Wwise soundbank.\r\n     *\r\n     * @param {Uint8Array|ArrayBuffer|DataView} input Candidate soundbank bytes.\r\n     * @returns {boolean} True when the BKHD header chunk is present.\r\n     */\r\n    static isBNK(input)\r\n    {\r\n        try\r\n        {\r\n            return isBNK(toBytes(input));\r\n        }\r\n        catch\r\n        {\r\n            return false;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Wwise-domain toolkit, grouped apart from the container-reading statics -\r\n     * the single home for the SoundbanksInfo catalog helpers\r\n     * (`isSoundbanksInfo`, `parseSoundbanksInfo`, `buildSoundbanksCatalog`,\r\n     * `joinSoundbanksInfo`), the id hash (`wwiseIdFromName`, FNV-1 of the\r\n     * lowercased name), and event-graph resolution.\r\n     *\r\n     * `eventMediaFromBanks(inspections, options)` is graph interpretation over\r\n     * `inspect()` results, not a read path: banks may split events from their\r\n     * target objects (EVE keeps all events in one bank and their sounds in\r\n     * others), so always pass every related bank to one call. Returns\r\n     * `{ eventMedia: Map<eventObjectId, Set<wemId>>, diagnostics }`. See\r\n     * core/graph.js for the walk policy.\r\n     *\r\n     * The interactive-music decoders (`musicNodesFromBanks` and the per-type\r\n     * `parseMusicSegment/Track/Playlist/Switch`) turn the music-hierarchy\r\n     * entries (HIRC 10-13) into typed nodes - children, meter, cue markers,\r\n     * clips, playlist trees, decision trees, and transition rules. See\r\n     * core/musicNodes.js for the anchored, exact-end-validated parse.\n     *\n     * The v150 authored-SFX decoders (`sfxNodesFromBanks` and the per-type\n     * Global Settings, Event Action, Random/Sequence, Switch, Layer,\n     * Actor-Mixer, and Attenuation parsers)\n     * preserve raw Wwise semantics for runtime-audio's optional builder.\n     * NodeBase facts, hierarchy-only Actor-Mixers, and attenuation objects\n     * remain distinct from playable container behavior.\n     *\n     * `busNodesFromBanks` and `parseBusNode` expose qualified complete v150\n     * Audio Bus and Auxiliary Bus bodies: ancestry, root output device,\n     * properties, aux topology, policy, ducking, effect/metadata references,\n     * RTPCs, and state values.\n     *\n     * `effectNodesFromBanks` and `parseEffectNode` expose complete generic\n     * v150 Fx ShareSet and Fx Custom bodies while leaving plug-in parameter\n     * blocks opaque for separately qualified DSP adapters.\n     */\r\n    static wwise = Object.freeze({\r\n        isSoundbanksInfo,\r\n        parseSoundbanksInfo,\r\n        buildSoundbanksCatalog,\r\n        joinSoundbanksInfo,\r\n        wwiseIdFromName,\n        eventMediaFromBanks,\n        parseGlobalSettings,\n        parseEventAction,\n        musicNodesFromBanks,\r\n        parseMusicSegment,\r\n        parseMusicTrack,\n        parseMusicPlaylist,\n        parseMusicSwitch,\n        busNodesFromBanks,\n        parseBusNode,\n        effectNodesFromBanks,\n        parseEffectNode,\n        sfxNodesFromBanks,\n        parseSfxActorMixer,\n        parseSfxAttenuation,\n        parseSfxRandomSequence,\n        parseSfxSwitch,\n        parseSfxLayer\n    });\n\r\n    /**\r\n     * Emit targets for this format (canonical frozen enum).\r\n     */\r\n    static Output = Object.freeze({\r\n        RAW: OUTPUT_RAW,\r\n        JSON: OUTPUT_JSON,\r\n        BNK_JSON: OUTPUT_BNK_JSON,\r\n        MEDIA: OUTPUT_MEDIA\r\n    });\r\n\r\n    static HIRC_TYPE_NAMES = HIRC_TYPE_NAMES;\n\n    static HIRC_V150_TYPE_NAMES = HIRC_V150_TYPE_NAMES;\n\r\n    static type = Object.freeze([ \"audio\" ]);\r\n\r\n    static mediaTypes = Object.freeze([ \"audio\" ]);\r\n\r\n    static inputTypes = Object.freeze([ \"bnk\" ]);\r\n\r\n    static outputTypes = Object.freeze([ OUTPUT_RAW, OUTPUT_MEDIA ]);\r\n\r\n    static debugOutputTypes = Object.freeze([ OUTPUT_BNK_JSON, OUTPUT_RAW ]);\r\n}\r\n\r\nexport default CjsBnkFormat;\r\n"],"names":["FORMAT_NAME","CjsBnkFormat","DEFAULT_VALUES","worker","Object","freeze","module","import","meta","url","exportName","constructor","options","SetValues","normalizeValues","GetValues","Read","input","readWithValues","ReadAsync","Inspect","inspectWithValues","IsSupported","isSupportedWithValues","ToJSON","value","toJsonValue","read","readAsync","inspect","isSupported","extractMedia","mediaId","bytes","toBytes","metadata","toJSON","isBNK","wwise","isSoundbanksInfo","parseSoundbanksInfo","buildSoundbanksCatalog","joinSoundbanksInfo","wwiseIdFromName","eventMediaFromBanks","parseGlobalSettings","parseEventAction","musicNodesFromBanks","parseMusicSegment","parseMusicTrack","parseMusicPlaylist","parseMusicSwitch","busNodesFromBanks","parseBusNode","effectNodesFromBanks","parseEffectNode","sfxNodesFromBanks","parseSfxActorMixer","parseSfxAttenuation","parseSfxRandomSequence","parseSfxSwitch","parseSfxLayer","Output","RAW","OUTPUT_RAW","JSON","OUTPUT_JSON","BNK_JSON","OUTPUT_BNK_JSON","MEDIA","OUTPUT_MEDIA","HIRC_TYPE_NAMES","HIRC_V150_TYPE_NAMES","type","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":"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"}
+{"version":3,"file":"CjsBnkFormat.js","sources":["../../../../src/formats/bnk/CjsBnkFormat.js"],"sourcesContent":["import { CjsFormat } from \"../../format/CjsFormat.js\";\nimport {\n    buildSoundbanksCatalog,\n    isSoundbanksInfo,\n    joinSoundbanksInfo,\n    parseSoundbanksInfo,\n    wwiseIdFromName\n} from \"./core/soundbanksInfo.js\";\nimport {\n    DEFAULT_VALUES,\n    HIRC_TYPE_NAMES,\n    HIRC_V150_TYPE_NAMES,\n    OUTPUT_BNK_JSON,\n    OUTPUT_JSON,\n    OUTPUT_MEDIA,\n    OUTPUT_RAW,\n    extractMedia,\n    inspectWithValues,\n    isBNK,\n    probeSupportWithValues,\n    normalizeValues,\n    readWithValues,\n    toBytes,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { eventMediaFromBanks } from \"./core/graph.js\";\nimport { parseEventAction } from \"./core/eventAction.js\";\nimport { parseGlobalSettings } from \"./core/globalSettings.js\";\nimport {\n    busNodesFromBanks,\n    parseBusNode\n} from \"./core/busNodes.js\";\nimport {\n    effectNodesFromBanks,\n    parseEffectNode\n} from \"./core/effectNodes.js\";\nimport {\n    musicNodesFromBanks,\n    parseMusicPlaylist,\n    parseMusicSegment,\n    parseMusicSwitch,\n    parseMusicTrack\n} from \"./core/musicNodes.js\";\nimport {\n    parseSfxActorMixer,\n    parseSfxAttenuation,\n    parseSfxLayer,\n    parseSfxRandomSequence,\n    parseSfxSwitch,\n    sfxNodesFromBanks\n} from \"./core/sfxNodes.js\";\n\nconst FORMAT_NAME = \"CjsBnkFormat\";\n\n/**\n * Reader for Audiokinetic Wwise soundbank (.bnk) containers.\n *\n * Inspection decodes the bank header, embedded media index, exact v150 global\n * settings, object hierarchy listing (with version-stable typed fields), and\n * referenced bank names without copying payloads. Read can emit the raw bank,\n * debug JSON, or the embedded media items undecoded. The read path stays a\n * pure container reader; the Wwise-domain toolkit (SoundbanksInfo catalog\n * helpers, id hash, event -> media graph resolution) is grouped under the\n * `wwise` static.\n */\nexport class CjsBnkFormat extends CjsFormat\n{\n    #values = DEFAULT_VALUES;\n\n    /**\n     * Browser-worker module declaration consumed by CjsResManWorkerLoader.\n     */\n    static worker = Object.freeze({\n        module: import.meta.url,\n        exportName: \"CjsBnkFormat\",\n        outputTypes: Object.freeze([ OUTPUT_RAW, OUTPUT_MEDIA, OUTPUT_BNK_JSON ]),\n        defaultOutput: OUTPUT_RAW\n    });\n\n    /**\n     * Create a reusable bnk format profile.\n     *\n     * @param {object} [options] Default read/inspect options.\n     */\n    constructor(options = {})\n    {\n        super();\n        this.SetValues(options);\n    }\n\n    /**\n     * Merge options into this profile.\n     *\n     * @param {object} [options] Values to merge.\n     * @returns {CjsBnkFormat} 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 soundbank bytes with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} GPU-free raw/debug/media payload for the selected emit target.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Read soundbank bytes asynchronously with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {Promise<object>} GPU-free raw/debug/media payload for the selected emit target.\n     */\n    async ReadAsync(input, options = {})\n    {\n        return this.Read(input, options);\n    }\n\n    /**\n     * Inspect soundbank bytes without copying media payloads.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} Soundbank metadata.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(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 soundbank read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Read options.\n     * @returns {object} GPU-free raw/debug/media 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 soundbank read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Read options.\n     * @returns {Promise<object>} GPU-free raw/debug/media payload for the selected emit target.\n     */\n    static async readAsync(input, options = {})\n    {\n        return CjsBnkFormat.read(input, options);\n    }\n\n    /**\n     * One-shot soundbank inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Inspect options.\n     * @returns {object} Soundbank metadata.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * One-shot soundbank support probe.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Probe options.\n     * @returns {object} Support/probe report.\n     */\n    static probeSupport(input, options = {})\n    {\n        return probeSupportWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Extract embedded media payloads as views over the soundbank bytes.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {number} [mediaId] Optional single media id filter.\n     * @returns {Array<object>} Extracted media items with undecoded bytes.\n     */\n    static extractMedia(input, mediaId)\n    {\n        const bytes = toBytes(input);\n        const metadata = inspectWithValues(bytes, DEFAULT_VALUES);\n        return extractMedia(bytes, metadata, mediaId);\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 soundbank.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Candidate soundbank bytes.\n     * @returns {boolean} True when the BKHD header chunk is present.\n     */\n    static isBNK(input)\n    {\n        try\n        {\n            return isBNK(toBytes(input));\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Wwise-domain toolkit, grouped apart from the container-reading statics -\n     * the single home for the SoundbanksInfo catalog helpers\n     * (`isSoundbanksInfo`, `parseSoundbanksInfo`, `buildSoundbanksCatalog`,\n     * `joinSoundbanksInfo`), the id hash (`wwiseIdFromName`, FNV-1 of the\n     * lowercased name), and event-graph resolution.\n     *\n     * `eventMediaFromBanks(inspections, options)` is graph interpretation over\n     * `inspect()` results, not a read path: banks may split events from their\n     * target objects (EVE keeps all events in one bank and their sounds in\n     * others), so always pass every related bank to one call. Returns\n     * `{ eventMedia: Map<eventObjectId, Set<wemId>>, diagnostics }`. See\n     * core/graph.js for the walk policy.\n     *\n     * The interactive-music decoders (`musicNodesFromBanks` and the per-type\n     * `parseMusicSegment/Track/Playlist/Switch`) turn the music-hierarchy\n     * entries (HIRC 10-13) into typed nodes - children, meter, cue markers,\n     * clips, playlist trees, decision trees, and transition rules. See\n     * core/musicNodes.js for the anchored, exact-end-validated parse.\n     *\n     * The v150 authored-SFX decoders (`sfxNodesFromBanks` and the per-type\n     * Global Settings, Event Action, Random/Sequence, Switch, Layer,\n     * Actor-Mixer, and Attenuation parsers)\n     * preserve raw Wwise semantics for runtime-audio's optional builder.\n     * NodeBase facts, hierarchy-only Actor-Mixers, and attenuation objects\n     * remain distinct from playable container behavior.\n     *\n     * `busNodesFromBanks` and `parseBusNode` expose qualified complete v150\n     * Audio Bus and Auxiliary Bus bodies: ancestry, root output device,\n     * properties, aux topology, policy, ducking, effect/metadata references,\n     * RTPCs, and state values.\n     *\n     * `effectNodesFromBanks` and `parseEffectNode` expose complete generic\n     * v150 Fx ShareSet and Fx Custom bodies while leaving plug-in parameter\n     * blocks opaque for separately qualified DSP adapters.\n     */\n    static wwise = Object.freeze({\n        isSoundbanksInfo,\n        parseSoundbanksInfo,\n        buildSoundbanksCatalog,\n        joinSoundbanksInfo,\n        wwiseIdFromName,\n        eventMediaFromBanks,\n        parseGlobalSettings,\n        parseEventAction,\n        musicNodesFromBanks,\n        parseMusicSegment,\n        parseMusicTrack,\n        parseMusicPlaylist,\n        parseMusicSwitch,\n        busNodesFromBanks,\n        parseBusNode,\n        effectNodesFromBanks,\n        parseEffectNode,\n        sfxNodesFromBanks,\n        parseSfxActorMixer,\n        parseSfxAttenuation,\n        parseSfxRandomSequence,\n        parseSfxSwitch,\n        parseSfxLayer\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        BNK_JSON: OUTPUT_BNK_JSON,\n        MEDIA: OUTPUT_MEDIA\n    });\n\n    static HIRC_TYPE_NAMES = HIRC_TYPE_NAMES;\n\n    static HIRC_V150_TYPE_NAMES = HIRC_V150_TYPE_NAMES;\n\n    static id = \"bnk\";\n\n    static mediaTypes = Object.freeze([ \"audio\" ]);\n\n    static outputs = CjsFormat.defineOutputs({\n\n        raw: { default: true, passthrough: true },\n\n        media: {  },\n\n        bnkJson: { role: \"debug\", probes: [ \"bnkJson\", \"raw\" ] }\n\n    });\n\n    static extensions = Object.freeze([ \".bnk\" ]);\n}\n\nexport default CjsBnkFormat;\n"],"names":["FORMAT_NAME","CjsBnkFormat","CjsFormat","DEFAULT_VALUES","worker","Object","freeze","module","import","meta","url","exportName","outputTypes","OUTPUT_RAW","OUTPUT_MEDIA","OUTPUT_BNK_JSON","defaultOutput","constructor","options","SetValues","normalizeValues","GetValues","Read","input","readWithValues","ReadAsync","Inspect","inspectWithValues","ToJSON","value","toJsonValue","read","readAsync","inspect","probeSupport","probeSupportWithValues","extractMedia","mediaId","bytes","toBytes","metadata","toJSON","isBNK","wwise","isSoundbanksInfo","parseSoundbanksInfo","buildSoundbanksCatalog","joinSoundbanksInfo","wwiseIdFromName","eventMediaFromBanks","parseGlobalSettings","parseEventAction","musicNodesFromBanks","parseMusicSegment","parseMusicTrack","parseMusicPlaylist","parseMusicSwitch","busNodesFromBanks","parseBusNode","effectNodesFromBanks","parseEffectNode","sfxNodesFromBanks","parseSfxActorMixer","parseSfxAttenuation","parseSfxRandomSequence","parseSfxSwitch","parseSfxLayer","Output","RAW","JSON","OUTPUT_JSON","BNK_JSON","MEDIA","HIRC_TYPE_NAMES","HIRC_V150_TYPE_NAMES","id","mediaTypes","outputs","defineOutputs","raw","default","passthrough","media","bnkJson","role","probes","extensions"],"mappings":"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"}