@carbonenginejs/runtime-resource 0.1.0

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

@@ -0,0 +1,182 @@
+import { classes } from './blackDefinitions.js';
+
+const OUTPUT_JSON = "json";
+const OUTPUT_RAW = "raw";
+const OUTPUT_DOCUMENT = "document";
+const OUTPUT_PAYLOAD = "payload";
+const OUTPUT_RUNTIME = "runtime";
+const DEFAULT_VALUES = Object.freeze({
+  emit: OUTPUT_JSON,
+  schema: classes,
+  registry: null,
+  sourceShapes: null,
+  rootName: "default",
+  firstId: 1,
+  metadata: null,
+  includeMetadata: false,
+  includeClassMetadata: false,
+  includeFieldTrace: false,
+  includeRefIndex: false,
+  trace: false,
+  debug: false,
+  decodeBinaryBlocks: false,
+  captureUnknownBlackFields: false,
+  captureUnknownResourceFields: false,
+  captureUnknownWhenNoBlackFields: false,
+  allowUnknownStringFallback: false,
+  rootFields: null,
+  payloadRootFields: null,
+  payloadTypeField: "_type",
+  payloadIdField: "_id",
+  payloadReferenceField: "_reference",
+  pathHandler: null,
+  adapter: null,
+  adapters: null,
+  classes: Object.freeze({})
+});
+const OPTION_KEYS = new Set(Object.keys(DEFAULT_VALUES));
+function hasOwn(value, key) {
+  return Object.prototype.hasOwnProperty.call(value, key);
+}
+function normalizeEmit(emit, readerName) {
+  if (emit === undefined || emit === OUTPUT_JSON) return OUTPUT_JSON;
+  if (emit === OUTPUT_RAW) return OUTPUT_RAW;
+  if (emit === OUTPUT_DOCUMENT) return OUTPUT_DOCUMENT;
+  if (emit === OUTPUT_PAYLOAD) return OUTPUT_PAYLOAD;
+  if (emit === OUTPUT_RUNTIME) return OUTPUT_RUNTIME;
+  throw new Error(`${readerName} unknown emit value "${emit}"`);
+}
+function assertKnownOptions(options, readerName) {
+  for (const key of Object.keys(options)) {
+    if (!OPTION_KEYS.has(key)) {
+      throw new TypeError(`${readerName} unknown option "${key}"`);
+    }
+  }
+}
+function classMap(values) {
+  return values && values.classes ? values.classes : {};
+}
+function cloneValues(values) {
+  return {
+    emit: values.emit,
+    schema: values.schema ?? null,
+    registry: values.registry ?? null,
+    sourceShapes: values.sourceShapes ?? null,
+    rootName: values.rootName ?? "default",
+    firstId: values.firstId ?? 1,
+    metadata: values.metadata ?? null,
+    includeMetadata: Boolean(values.includeMetadata),
+    includeClassMetadata: Boolean(values.includeClassMetadata),
+    includeFieldTrace: Boolean(values.includeFieldTrace),
+    includeRefIndex: Boolean(values.includeRefIndex),
+    trace: Boolean(values.trace),
+    debug: Boolean(values.debug),
+    decodeBinaryBlocks: Boolean(values.decodeBinaryBlocks),
+    captureUnknownBlackFields: Boolean(values.captureUnknownBlackFields),
+    captureUnknownResourceFields: Boolean(values.captureUnknownResourceFields),
+    captureUnknownWhenNoBlackFields: Boolean(values.captureUnknownWhenNoBlackFields),
+    allowUnknownStringFallback: Boolean(values.allowUnknownStringFallback),
+    rootFields: cloneListOrValue(values.rootFields),
+    payloadRootFields: cloneListOrValue(values.payloadRootFields),
+    payloadTypeField: values.payloadTypeField,
+    payloadIdField: values.payloadIdField,
+    payloadReferenceField: values.payloadReferenceField,
+    pathHandler: values.pathHandler ?? null,
+    adapter: values.adapter ?? null,
+    adapters: values.adapters ?? null,
+    classes: {
+      ...classMap(values)
+    }
+  };
+}
+function cloneListOrValue(value) {
+  return Array.isArray(value) ? value.slice() : value ?? null;
+}
+function validateClassKey(classKeys, key, readerName) {
+  if (typeof key !== "string" || !key) {
+    throw new Error(`${readerName} class type must be a non-empty string`);
+  }
+}
+function validateClass(classKeys, type, Class, readerName) {
+  validateClassKey(classKeys, type, readerName);
+  if (typeof Class !== "function") {
+    throw new TypeError(`${readerName} class "${type}" must be a constructor`);
+  }
+}
+function mergeClasses(values, classes, classKeys, readerName) {
+  if (!classes || typeof classes !== "object") {
+    throw new TypeError(`${readerName} classes option must be an object`);
+  }
+  const next = {
+    ...values.classes
+  };
+  for (const [type, Class] of Object.entries(classes)) {
+    validateClass(classKeys, type, Class, readerName);
+    next[type] = Class;
+  }
+  values.classes = next;
+}
+function normalizeValues(base, options, classKeys, readerName) {
+  if (!options || typeof options !== "object") {
+    throw new TypeError(`${readerName} options must be an object`);
+  }
+  assertKnownOptions(options, readerName);
+  const values = cloneValues(base);
+  if (hasOwn(options, "emit")) values.emit = normalizeEmit(options.emit, readerName);
+  if (hasOwn(options, "schema")) values.schema = options.schema ?? null;
+  if (hasOwn(options, "registry")) values.registry = options.registry ?? null;
+  if (hasOwn(options, "sourceShapes")) values.sourceShapes = options.sourceShapes ?? null;
+  if (hasOwn(options, "rootName")) values.rootName = options.rootName ?? "default";
+  if (hasOwn(options, "firstId")) values.firstId = options.firstId ?? 1;
+  if (hasOwn(options, "metadata")) values.metadata = options.metadata ?? null;
+  if (hasOwn(options, "includeMetadata")) values.includeMetadata = Boolean(options.includeMetadata);
+  if (hasOwn(options, "includeClassMetadata")) values.includeClassMetadata = Boolean(options.includeClassMetadata);
+  if (hasOwn(options, "includeFieldTrace")) values.includeFieldTrace = Boolean(options.includeFieldTrace);
+  if (hasOwn(options, "includeRefIndex")) values.includeRefIndex = Boolean(options.includeRefIndex);
+  if (hasOwn(options, "trace")) values.trace = Boolean(options.trace);
+  if (hasOwn(options, "debug")) values.debug = Boolean(options.debug);
+  if (hasOwn(options, "decodeBinaryBlocks")) values.decodeBinaryBlocks = Boolean(options.decodeBinaryBlocks);
+  if (hasOwn(options, "captureUnknownBlackFields")) values.captureUnknownBlackFields = Boolean(options.captureUnknownBlackFields);
+  if (hasOwn(options, "captureUnknownResourceFields")) values.captureUnknownResourceFields = Boolean(options.captureUnknownResourceFields);
+  if (hasOwn(options, "captureUnknownWhenNoBlackFields")) values.captureUnknownWhenNoBlackFields = Boolean(options.captureUnknownWhenNoBlackFields);
+  if (hasOwn(options, "allowUnknownStringFallback")) values.allowUnknownStringFallback = Boolean(options.allowUnknownStringFallback);
+  if (hasOwn(options, "rootFields")) values.rootFields = cloneListOrValue(options.rootFields);
+  if (hasOwn(options, "payloadRootFields")) values.payloadRootFields = cloneListOrValue(options.payloadRootFields);
+  if (hasOwn(options, "payloadTypeField")) values.payloadTypeField = options.payloadTypeField;
+  if (hasOwn(options, "payloadIdField")) values.payloadIdField = options.payloadIdField;
+  if (hasOwn(options, "payloadReferenceField")) values.payloadReferenceField = options.payloadReferenceField;
+  if (hasOwn(options, "adapter")) values.adapter = options.adapter ?? null;
+  if (hasOwn(options, "adapters")) values.adapters = options.adapters ?? null;
+  if (hasOwn(options, "pathHandler")) {
+    if (options.pathHandler !== null && options.pathHandler !== undefined && typeof options.pathHandler !== "function") {
+      throw new TypeError(`${readerName} pathHandler option must be a function`);
+    }
+    values.pathHandler = options.pathHandler ?? null;
+  }
+  if (hasOwn(options, "classes")) mergeClasses(values, options.classes, classKeys, readerName);
+  return values;
+}
+function toJsonValue(value, seen = new WeakSet()) {
+  if (value === null || typeof value !== "object") return value;
+  if (ArrayBuffer.isView(value)) return Array.from(value, item => toJsonValue(item, seen));
+  if (Array.isArray(value)) return value.map(item => toJsonValue(item, seen));
+  if (seen.has(value)) {
+    throw new TypeError("Reader.toJSON cannot convert circular data");
+  }
+  if (typeof value.toJSON === "function") {
+    seen.add(value);
+    const json = toJsonValue(value.toJSON(), seen);
+    seen.delete(value);
+    return json;
+  }
+  seen.add(value);
+  const out = {};
+  for (const key of Object.keys(value)) {
+    out[key] = toJsonValue(value[key], seen);
+  }
+  seen.delete(value);
+  return out;
+}
+
+export { DEFAULT_VALUES, OUTPUT_DOCUMENT, OUTPUT_JSON, OUTPUT_PAYLOAD, OUTPUT_RAW, OUTPUT_RUNTIME, normalizeValues, toJsonValue, validateClass, validateClassKey };
+//# sourceMappingURL=helpers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sources":["../../../../../src/formats/black/core/helpers.js"],"sourcesContent":["import blackDefinitions from \"./blackSchema.js\";\n\nexport const OUTPUT_JSON = \"json\";\nexport const OUTPUT_RAW = \"raw\";\nexport const OUTPUT_DOCUMENT = \"document\";\nexport const OUTPUT_PAYLOAD = \"payload\";\nexport const OUTPUT_RUNTIME = \"runtime\";\n\nexport const DEFAULT_VALUES = Object.freeze({\n    emit: OUTPUT_JSON,\n    schema: blackDefinitions,\n    registry: null,\n    sourceShapes: null,\n    rootName: \"default\",\n    firstId: 1,\n    metadata: null,\n    includeMetadata: false,\n    includeClassMetadata: false,\n    includeFieldTrace: false,\n    includeRefIndex: false,\n    trace: false,\n    debug: false,\n    decodeBinaryBlocks: false,\n    captureUnknownBlackFields: false,\n    captureUnknownResourceFields: false,\n    captureUnknownWhenNoBlackFields: false,\n    allowUnknownStringFallback: false,\n    rootFields: null,\n    payloadRootFields: null,\n    payloadTypeField: \"_type\",\n    payloadIdField: \"_id\",\n    payloadReferenceField: \"_reference\",\n    pathHandler: null,\n    adapter: null,\n    adapters: null,\n    classes: Object.freeze({})\n});\n\nconst OPTION_KEYS = new Set(Object.keys(DEFAULT_VALUES));\n\nfunction hasOwn(value, key)\n{\n    return Object.prototype.hasOwnProperty.call(value, key);\n}\n\nfunction normalizeEmit(emit, readerName)\n{\n    if (emit === undefined || emit === OUTPUT_JSON) return OUTPUT_JSON;\n    if (emit === OUTPUT_RAW) return OUTPUT_RAW;\n    if (emit === OUTPUT_DOCUMENT) return OUTPUT_DOCUMENT;\n    if (emit === OUTPUT_PAYLOAD) return OUTPUT_PAYLOAD;\n    if (emit === OUTPUT_RUNTIME) return OUTPUT_RUNTIME;\n    throw new Error(`${readerName} unknown emit value \"${emit}\"`);\n}\n\nfunction assertKnownOptions(options, readerName)\n{\n    for (const key of Object.keys(options))\n    {\n        if (!OPTION_KEYS.has(key))\n        {\n            throw new TypeError(`${readerName} unknown option \"${key}\"`);\n        }\n    }\n}\n\nfunction classMap(values)\n{\n    return values && values.classes ? values.classes : {};\n}\n\nfunction cloneValues(values)\n{\n    return {\n        emit: values.emit,\n        schema: values.schema ?? null,\n        registry: values.registry ?? null,\n        sourceShapes: values.sourceShapes ?? null,\n        rootName: values.rootName ?? \"default\",\n        firstId: values.firstId ?? 1,\n        metadata: values.metadata ?? null,\n        includeMetadata: Boolean(values.includeMetadata),\n        includeClassMetadata: Boolean(values.includeClassMetadata),\n        includeFieldTrace: Boolean(values.includeFieldTrace),\n        includeRefIndex: Boolean(values.includeRefIndex),\n        trace: Boolean(values.trace),\n        debug: Boolean(values.debug),\n        decodeBinaryBlocks: Boolean(values.decodeBinaryBlocks),\n        captureUnknownBlackFields: Boolean(values.captureUnknownBlackFields),\n        captureUnknownResourceFields: Boolean(values.captureUnknownResourceFields),\n        captureUnknownWhenNoBlackFields: Boolean(values.captureUnknownWhenNoBlackFields),\n        allowUnknownStringFallback: Boolean(values.allowUnknownStringFallback),\n        rootFields: cloneListOrValue(values.rootFields),\n        payloadRootFields: cloneListOrValue(values.payloadRootFields),\n        payloadTypeField: values.payloadTypeField,\n        payloadIdField: values.payloadIdField,\n        payloadReferenceField: values.payloadReferenceField,\n        pathHandler: values.pathHandler ?? null,\n        adapter: values.adapter ?? null,\n        adapters: values.adapters ?? null,\n        classes: { ...classMap(values) }\n    };\n}\n\nfunction cloneListOrValue(value)\n{\n    return Array.isArray(value) ? value.slice() : value ?? null;\n}\n\nexport function validateClassKey(classKeys, key, readerName)\n{\n    if (typeof key !== \"string\" || !key)\n    {\n        throw new Error(`${readerName} class type must be a non-empty string`);\n    }\n}\n\nexport function validateClass(classKeys, type, Class, readerName)\n{\n    validateClassKey(classKeys, type, readerName);\n    if (typeof Class !== \"function\")\n    {\n        throw new TypeError(`${readerName} class \"${type}\" must be a constructor`);\n    }\n}\n\nfunction mergeClasses(values, classes, classKeys, readerName)\n{\n    if (!classes || typeof classes !== \"object\")\n    {\n        throw new TypeError(`${readerName} classes option must be an object`);\n    }\n\n    const next = { ...values.classes };\n    for (const [ type, Class ] of Object.entries(classes))\n    {\n        validateClass(classKeys, type, Class, readerName);\n        next[type] = Class;\n    }\n    values.classes = next;\n}\n\nexport function normalizeValues(base, options, classKeys, readerName)\n{\n    if (!options || typeof options !== \"object\")\n    {\n        throw new TypeError(`${readerName} options must be an object`);\n    }\n\n    assertKnownOptions(options, readerName);\n\n    const values = cloneValues(base);\n    if (hasOwn(options, \"emit\")) values.emit = normalizeEmit(options.emit, readerName);\n    if (hasOwn(options, \"schema\")) values.schema = options.schema ?? null;\n    if (hasOwn(options, \"registry\")) values.registry = options.registry ?? null;\n    if (hasOwn(options, \"sourceShapes\")) values.sourceShapes = options.sourceShapes ?? null;\n    if (hasOwn(options, \"rootName\")) values.rootName = options.rootName ?? \"default\";\n    if (hasOwn(options, \"firstId\")) values.firstId = options.firstId ?? 1;\n    if (hasOwn(options, \"metadata\")) values.metadata = options.metadata ?? null;\n    if (hasOwn(options, \"includeMetadata\")) values.includeMetadata = Boolean(options.includeMetadata);\n    if (hasOwn(options, \"includeClassMetadata\")) values.includeClassMetadata = Boolean(options.includeClassMetadata);\n    if (hasOwn(options, \"includeFieldTrace\")) values.includeFieldTrace = Boolean(options.includeFieldTrace);\n    if (hasOwn(options, \"includeRefIndex\")) values.includeRefIndex = Boolean(options.includeRefIndex);\n    if (hasOwn(options, \"trace\")) values.trace = Boolean(options.trace);\n    if (hasOwn(options, \"debug\")) values.debug = Boolean(options.debug);\n    if (hasOwn(options, \"decodeBinaryBlocks\")) values.decodeBinaryBlocks = Boolean(options.decodeBinaryBlocks);\n    if (hasOwn(options, \"captureUnknownBlackFields\")) values.captureUnknownBlackFields = Boolean(options.captureUnknownBlackFields);\n    if (hasOwn(options, \"captureUnknownResourceFields\")) values.captureUnknownResourceFields = Boolean(options.captureUnknownResourceFields);\n    if (hasOwn(options, \"captureUnknownWhenNoBlackFields\")) values.captureUnknownWhenNoBlackFields = Boolean(options.captureUnknownWhenNoBlackFields);\n    if (hasOwn(options, \"allowUnknownStringFallback\")) values.allowUnknownStringFallback = Boolean(options.allowUnknownStringFallback);\n    if (hasOwn(options, \"rootFields\")) values.rootFields = cloneListOrValue(options.rootFields);\n    if (hasOwn(options, \"payloadRootFields\")) values.payloadRootFields = cloneListOrValue(options.payloadRootFields);\n    if (hasOwn(options, \"payloadTypeField\")) values.payloadTypeField = options.payloadTypeField;\n    if (hasOwn(options, \"payloadIdField\")) values.payloadIdField = options.payloadIdField;\n    if (hasOwn(options, \"payloadReferenceField\")) values.payloadReferenceField = options.payloadReferenceField;\n    if (hasOwn(options, \"adapter\")) values.adapter = options.adapter ?? null;\n    if (hasOwn(options, \"adapters\")) values.adapters = options.adapters ?? null;\n    if (hasOwn(options, \"pathHandler\"))\n    {\n        if (options.pathHandler !== null && options.pathHandler !== undefined && typeof options.pathHandler !== \"function\")\n        {\n            throw new TypeError(`${readerName} pathHandler option must be a function`);\n        }\n        values.pathHandler = options.pathHandler ?? null;\n    }\n    if (hasOwn(options, \"classes\")) mergeClasses(values, options.classes, classKeys, readerName);\n    return values;\n}\n\nexport function notImplemented(readerName, methodName)\n{\n    return new Error(`${readerName}.${methodName} is not implemented yet`);\n}\n\nexport function toJsonValue(value, seen = new WeakSet())\n{\n    if (value === null || typeof value !== \"object\") return value;\n    if (ArrayBuffer.isView(value)) return Array.from(value, item => toJsonValue(item, seen));\n    if (Array.isArray(value)) return value.map(item => toJsonValue(item, seen));\n\n    if (seen.has(value))\n    {\n        throw new TypeError(\"Reader.toJSON cannot convert circular data\");\n    }\n\n    if (typeof value.toJSON === \"function\")\n    {\n        seen.add(value);\n        const json = toJsonValue(value.toJSON(), seen);\n        seen.delete(value);\n        return json;\n    }\n\n    seen.add(value);\n    const out = {};\n    for (const key of Object.keys(value))\n    {\n        out[key] = toJsonValue(value[key], seen);\n    }\n    seen.delete(value);\n    return out;\n}\n"],"names":["OUTPUT_JSON","OUTPUT_RAW","OUTPUT_DOCUMENT","OUTPUT_PAYLOAD","OUTPUT_RUNTIME","DEFAULT_VALUES","Object","freeze","emit","schema","blackDefinitions","registry","sourceShapes","rootName","firstId","metadata","includeMetadata","includeClassMetadata","includeFieldTrace","includeRefIndex","trace","debug","decodeBinaryBlocks","captureUnknownBlackFields","captureUnknownResourceFields","captureUnknownWhenNoBlackFields","allowUnknownStringFallback","rootFields","payloadRootFields","payloadTypeField","payloadIdField","payloadReferenceField","pathHandler","adapter","adapters","classes","OPTION_KEYS","Set","keys","hasOwn","value","key","prototype","hasOwnProperty","call","normalizeEmit","readerName","undefined","Error","assertKnownOptions","options","has","TypeError","classMap","values","cloneValues","Boolean","cloneListOrValue","Array","isArray","slice","validateClassKey","classKeys","validateClass","type","Class","mergeClasses","next","entries","normalizeValues","base","toJsonValue","seen","WeakSet","ArrayBuffer","isView","from","item","map","toJSON","add","json","delete","out"],"mappings":"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"}

package/dist/formats/black/core/schema.js

@@ -0,0 +1,4 @@
+const CLASS_KEYS = Object.freeze(["Root", "Object", "Field", "Array", "Value", "Reference"]);
+
+export { CLASS_KEYS };
+//# sourceMappingURL=schema.js.map

package/dist/formats/black/core/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sources":["../../../../../src/formats/black/core/schema.js"],"sourcesContent":["export const CLASS_KEYS = Object.freeze([\n    \"Root\",\n    \"Object\",\n    \"Field\",\n    \"Array\",\n    \"Value\",\n    \"Reference\"\n]);\n"],"names":["CLASS_KEYS","Object","freeze"],"mappings":"AAAO,MAAMA,UAAU,GAAGC,MAAM,CAACC,MAAM,CAAC,CACpC,MAAM,EACN,QAAQ,EACR,OAAO,EACP,OAAO,EACP,OAAO,EACP,WAAW,CACd;;;;"}

package/dist/formats/black/index.js

@@ -0,0 +1,2 @@
+export { CjsBlackFormat, CjsBlackFormat as default } from './CjsBlackFormat.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/formats/bnk/CjsBnkFormat.js

@@ -0,0 +1,245 @@
+import { isSoundbanksInfo, parseSoundbanksInfo, buildSoundbanksCatalog, joinSoundbanksInfo, wwiseIdFromName } from './core/soundbanksInfo.js';
+import { DEFAULT_VALUES, normalizeValues, readWithValues, inspectWithValues, isSupportedWithValues, toJsonValue, toBytes, extractMedia, isBNK, OUTPUT_RAW, OUTPUT_JSON, OUTPUT_BNK_JSON, OUTPUT_MEDIA, HIRC_TYPE_NAMES } from './core/helpers.js';
+
+const FORMAT_NAME = "CjsBnkFormat";
+
+/**
+ * Reader for Audiokinetic Wwise soundbank (.bnk) containers.
+ *
+ * Inspection decodes the bank header, embedded media index, object hierarchy
+ * listing, and referenced bank names without copying payloads. Read can emit
+ * the raw bank, debug JSON, or the embedded media items undecoded; Wwise
+ * event/graph semantics are deliberately out of scope for this reader.
+ */
+class CjsBnkFormat {
+  #values = DEFAULT_VALUES;
+
+  /**
+   * Create a reusable bnk 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 {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.
+   */
+  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(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.
+   */
+  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(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.
+   */
+  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.
+   */
+  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.
+   */
+  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.
+   */
+  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.
+   */
+  static isSupported(input, options = {}) {
+    return isSupportedWithValues(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.
+   */
+  static extractMedia(input, mediaId) {
+    const bytes = toBytes(input);
+    const metadata = inspectWithValues(bytes, DEFAULT_VALUES);
+    return extractMedia(bytes, metadata, mediaId);
+  }
+
+  /**
+   * 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 input looks like a Wwise SoundbanksInfo document.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView|string|object} input Candidate document.
+   * @returns {boolean} True when a SoundBanksInfo bank list is present.
+   */
+  static isSoundbanksInfo(input) {
+    return isSoundbanksInfo(input);
+  }
+
+  /**
+   * Parse a SoundbanksInfo document into a normalized summary.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView|string|object} input SoundbanksInfo JSON bytes, text, or object.
+   * @returns {object} Normalized document summary with per-bank details.
+   */
+  static parseSoundbanksInfo(input) {
+    return parseSoundbanksInfo(input);
+  }
+
+  /**
+   * Build id-keyed lookup tables from a SoundbanksInfo document.
+   *
+   * @param {Uint8Array|ArrayBuffer|DataView|string|object} input SoundbanksInfo JSON bytes, text, or object.
+   * @returns {object} Catalog with banksById, mediaById, eventsById, and eventsByName.
+   */
+  static buildSoundbanksCatalog(input) {
+    return buildSoundbanksCatalog(input);
+  }
+
+  /**
+   * Join a bank inspection result with a SoundbanksInfo catalog.
+   *
+   * @param {object} bankInfo Inspect output for a soundbank.
+   * @param {object} catalog `buildSoundbanksCatalog` output.
+   * @returns {object} Bank/media/event annotations for the inspected bank.
+   */
+  static joinSoundbanksInfo(bankInfo, catalog) {
+    return joinSoundbanksInfo(bankInfo, catalog);
+  }
+
+  /**
+   * Compute the Wwise 32-bit id for a bank, event, switch, or language name.
+   *
+   * @param {string} name Wwise object name.
+   * @returns {number} Unsigned 32-bit Wwise id (FNV-1 of the lowercased name).
+   */
+  static wwiseIdFromName(name) {
+    return wwiseIdFromName(name);
+  }
+
+  /**
+   * 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 {
+      return isBNK(toBytes(input));
+    } catch {
+      return false;
+    }
+  }
+  static OUTPUT_RAW = OUTPUT_RAW;
+  static OUTPUT_JSON = OUTPUT_JSON;
+  static OUTPUT_BNK_JSON = OUTPUT_BNK_JSON;
+  static OUTPUT_MEDIA = OUTPUT_MEDIA;
+  static HIRC_TYPE_NAMES = HIRC_TYPE_NAMES;
+  static type = Object.freeze(["audio"]);
+  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]);
+}
+
+export { CjsBnkFormat };
+//# sourceMappingURL=CjsBnkFormat.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CjsBnkFormat.js","sources":["../../../../src/formats/bnk/CjsBnkFormat.js"],"sourcesContent":["import {\n    buildSoundbanksCatalog,\n    isSoundbanksInfo,\n    joinSoundbanksInfo,\n    parseSoundbanksInfo,\n    wwiseIdFromName\n} from \"./core/soundbanksInfo.js\";\nimport {\n    DEFAULT_VALUES,\n    HIRC_TYPE_NAMES,\n    OUTPUT_BNK_JSON,\n    OUTPUT_JSON,\n    OUTPUT_MEDIA,\n    OUTPUT_RAW,\n    extractMedia,\n    inspectWithValues,\n    isBNK,\n    isSupportedWithValues,\n    normalizeValues,\n    readWithValues,\n    toBytes,\n    toJsonValue\n} from \"./core/helpers.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, object hierarchy\n * listing, and referenced bank names without copying payloads. Read can emit\n * the raw bank, debug JSON, or the embedded media items undecoded; Wwise\n * event/graph semantics are deliberately out of scope for this reader.\n */\nexport class CjsBnkFormat\n{\n    #values = DEFAULT_VALUES;\n\n    /**\n     * Create a reusable bnk 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 {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     * Report whether soundbank input and requested output variants are supported.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank 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 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 isSupported(input, options = {})\n    {\n        return isSupportedWithValues(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 input looks like a Wwise SoundbanksInfo document.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView|string|object} input Candidate document.\n     * @returns {boolean} True when a SoundBanksInfo bank list is present.\n     */\n    static isSoundbanksInfo(input)\n    {\n        return isSoundbanksInfo(input);\n    }\n\n    /**\n     * Parse a SoundbanksInfo document into a normalized summary.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView|string|object} input SoundbanksInfo JSON bytes, text, or object.\n     * @returns {object} Normalized document summary with per-bank details.\n     */\n    static parseSoundbanksInfo(input)\n    {\n        return parseSoundbanksInfo(input);\n    }\n\n    /**\n     * Build id-keyed lookup tables from a SoundbanksInfo document.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView|string|object} input SoundbanksInfo JSON bytes, text, or object.\n     * @returns {object} Catalog with banksById, mediaById, eventsById, and eventsByName.\n     */\n    static buildSoundbanksCatalog(input)\n    {\n        return buildSoundbanksCatalog(input);\n    }\n\n    /**\n     * Join a bank inspection result with a SoundbanksInfo catalog.\n     *\n     * @param {object} bankInfo Inspect output for a soundbank.\n     * @param {object} catalog `buildSoundbanksCatalog` output.\n     * @returns {object} Bank/media/event annotations for the inspected bank.\n     */\n    static joinSoundbanksInfo(bankInfo, catalog)\n    {\n        return joinSoundbanksInfo(bankInfo, catalog);\n    }\n\n    /**\n     * Compute the Wwise 32-bit id for a bank, event, switch, or language name.\n     *\n     * @param {string} name Wwise object name.\n     * @returns {number} Unsigned 32-bit Wwise id (FNV-1 of the lowercased name).\n     */\n    static wwiseIdFromName(name)\n    {\n        return wwiseIdFromName(name);\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    static OUTPUT_RAW = OUTPUT_RAW;\n    static OUTPUT_JSON = OUTPUT_JSON;\n    static OUTPUT_BNK_JSON = OUTPUT_BNK_JSON;\n    static OUTPUT_MEDIA = OUTPUT_MEDIA;\n    static HIRC_TYPE_NAMES = HIRC_TYPE_NAMES;\n    static type = Object.freeze([ \"audio\" ]);\n    static mediaTypes = Object.freeze([ \"audio\" ]);\n    static inputTypes = Object.freeze([ \"bnk\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_RAW, OUTPUT_MEDIA ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_BNK_JSON, OUTPUT_RAW ]);\n}\n\nexport default CjsBnkFormat;\n"],"names":["FORMAT_NAME","CjsBnkFormat","DEFAULT_VALUES","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","isSoundbanksInfo","parseSoundbanksInfo","buildSoundbanksCatalog","joinSoundbanksInfo","bankInfo","catalog","wwiseIdFromName","name","isBNK","OUTPUT_RAW","OUTPUT_JSON","OUTPUT_BNK_JSON","OUTPUT_MEDIA","HIRC_TYPE_NAMES","type","Object","freeze","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":"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"}