@carbonenginejs/runtime-resource 0.1.0 → 0.8.0

package/dist/format/CjsFormat.js

@@ -1,178 +1,192 @@
-import { CjsResourceProbe as _CjsResourceProbe } from './CjsResourceProbe.js';
-
-class CjsFormat {
-  options = {};
-
-  /**
-   * Convenience factory for simple format helpers.
-   * Keep this lightweight so format classes can stay pure-reader implementations.
-   *
-   * @param {*} input
-   * @param {object} options
-   * @returns {Promise<*>|*}
-   */
-  static read(input, options = null) {
-    const reader = new this(options || {});
-    return reader.Read(input, options || {});
-  }
-
-  /**
-   * Async convenience factory for format readers.
-   *
-   * @param {*} input
-   * @param {object} options
-   * @returns {Promise<*>}
-   */
-  static async readAsync(input, options = null) {
-    const reader = new this(options || {});
-    return reader.ReadAsync(input, options || {});
-  }
-
-  /**
-   * Canonical support probe entrypoint.
-   * Returns a probe report including compressed/raw capability variants when implemented.
-   *
-   * @param {*} input
-   * @param {object} options
-   * @returns {CjsResourceProbe}
-   */
-  static isSupported(input, options = null) {
-    const source = typeof input === "string" ? "path" : "buffer";
-    const formatName = this.name ? this.name.replace(/^Cjs/u, "").replace(/Format$/u, "").toLowerCase() : "format";
-    return _CjsResourceProbe.createUnsupported(formatName, "No probe implementation.", {
-      source,
-      ...options
-    });
-  }
-
-  /**
-   * Alias for canonical naming.
-   *
-   * @param {*} input
-   * @param {object} options
-   * @returns {CjsResourceProbe}
-   */
-  static inspect(input, options = null) {
-    return this.isSupported(input, options);
-  }
-  constructor(options = null) {
-    this.options = {
-      ...(options || {})
-    };
-  }
-  SetValues(values = null) {
-    if (!values || typeof values !== "object") {
-      return this;
-    }
-    if (Object.prototype.hasOwnProperty.call(values, "options")) {
-      this.options = {
-        ...(values.options || {})
-      };
-    } else {
-      this.options = {
-        ...this.options,
-        ...values
-      };
-    }
-    return this;
-  }
-  GetValues() {
-    return {
-      options: {
-        ...this.options
-      }
-    };
-  }
-  Initialize(values = null) {
-    return this.SetValues(values || {});
-  }
-
-  /**
-   * Primary instance read entrypoint for synchronous readers.
-   * Implementations may override with async handling in readAsync only if needed.
-   */
-  Read(input, options = null) {
-    throw new Error(`${this.constructor.name}.Read must be implemented by a format package.`);
-  }
-
-  /**
-   * Primary async read entrypoint for asynchronous readers.
-   * Defaults to sync Read for compatibility.
-   */
-  async ReadAsync(input, options = null) {
-    return this.Read(input, options);
-  }
-
-  /**
-   * Canonical package-family group names.
-   */
-  static Type = Object.freeze({
-    AUDIO: "audio",
-    DATA: "data",
-    GEOMETRY: "geometry",
-    IMAGE: "image",
-    SCHEMA: "schema",
-    SHADER: "shader",
-    TEXTURE: "texture",
-    VIDEO: "video"
-  });
-
-  /**
-   * Canonical media-type groups used by format registration.
-   */
-  static MediaType = Object.freeze({
-    AUDIO: "audio",
-    DATA: "data",
-    GEOMETRY: "geometry",
-    IMAGE: "image",
-    SHADER: "shader",
-    SCHEMA: "schema",
-    TEXTURE: "texture",
-    VIDEO: "video"
-  });
-
-  /**
-   * Canonical output-type tokens used by format emit contracts.
-   */
-  static OutputType = Object.freeze({
-    AUDIO: "audio",
-    CMF: "cmf",
-    GR2: "gr2",
-    IMAGE: "image",
-    JSON: "json",
-    PCM: "pcm",
-    RAW: "raw",
-    RGBA: "rgba",
-    SCHEMA: "schema",
-    SHADER: "shader",
-    SHARED: "shared",
-    TEXTURE: "texture",
-    VIDEO: "video",
-    OBJ_JSON: "objJson"
-  });
-  static type = Object.freeze([]);
-  static mediaTypes = Object.freeze([]);
-  static inputTypes = Object.freeze([]);
-  static outputTypes = Object.freeze([]);
-  static debugOutputTypes = Object.freeze(["json", "raw"]);
-}
-
-/**
- * Shared utility for asserting required format metadata exists.
- */
-function ValidateFormatContract(Constructor) {
-  if (!Constructor) {
-    throw new TypeError("ValidateFormatContract requires a format class.");
-  }
-  const hasOutput = Array.isArray(Constructor.outputTypes) && Constructor.outputTypes.length > 0;
-  const hasInput = Array.isArray(Constructor.inputTypes) && Constructor.inputTypes.length > 0;
-  const hasMedia = Array.isArray(Constructor.mediaTypes) && Constructor.mediaTypes.length > 0;
-  const hasType = Array.isArray(Constructor.type) && Constructor.type.length > 0;
-  const hasDebug = Array.isArray(Constructor.debugOutputTypes) && Constructor.debugOutputTypes.length > 0;
-  if (!hasType || !hasMedia || !hasInput || !hasOutput || !hasDebug) {
-    throw new TypeError(`Format contract missing metadata: type:${hasType} mediaTypes:${hasMedia} inputTypes:${hasInput} outputTypes:${hasOutput} debugOutputTypes:${hasDebug}`);
-  }
-}
-
-export { CjsFormat, ValidateFormatContract };
-//# sourceMappingURL=CjsFormat.js.map
+import { MediaType, PayloadType } from '@carbonenginejs/runtime-const/media';
+import { CjsResourceProbe as _CjsResourceProbe } from './CjsResourceProbe.js';
+
+class CjsFormat {
+  options = {};
+
+  /**
+   * Convenience factory for simple format helpers.
+   * Keep this lightweight so format classes can stay pure-reader implementations.
+   *
+   * @param {*} input
+   * @param {object} options
+   * @returns {Promise<*>|*}
+   */
+  static read(input, options = null) {
+    const reader = new this(options || {});
+    return reader.Read(input, options || {});
+  }
+
+  /**
+   * Async convenience factory for format readers.
+   *
+   * @param {*} input
+   * @param {object} options
+   * @returns {Promise<*>}
+   */
+  static async readAsync(input, options = null) {
+    const reader = new this(options || {});
+    return reader.ReadAsync(input, options || {});
+  }
+
+  /**
+   * Canonical support probe entrypoint.
+   * Returns a probe report including compressed/raw capability variants when implemented.
+   *
+   * @param {*} input
+   * @param {object} options
+   * @returns {CjsResourceProbe}
+   */
+  static isSupported(input, options = null) {
+    const source = typeof input === "string" ? "path" : "buffer";
+    const formatName = this.name ? this.name.replace(/^Cjs/u, "").replace(/Format$/u, "").toLowerCase() : "format";
+    return _CjsResourceProbe.createUnsupported(formatName, "No probe implementation.", {
+      source,
+      ...options
+    });
+  }
+
+  /**
+   * Alias for canonical naming.
+   *
+   * @param {*} input
+   * @param {object} options
+   * @returns {CjsResourceProbe}
+   */
+  static inspect(input, options = null) {
+    return this.isSupported(input, options);
+  }
+
+  /**
+   * Content-verified type/route resolution (kb §5, optional per format).
+   *
+   * Where inspect()/isSupported() report what the container CLAIMS,
+   * resolveType() performs one bounded asynchronous content check (magic, a
+   * first frame/block, a setup header) and reports what the reader has
+   * evidence it can actually decode. Overrides return a CjsResourceProbe
+   * with `verified: true` and declared/resolved/mismatch evidence in
+   * `metadata`; `preferred` names the resolved decode route. A caller-forced
+   * emit always wins over a resolution, and this base implementation - the
+   * zero-extra-work path for formats without an override - delegates to
+   * isSupported() with `verified` false so an unverified result never
+   * changes a route.
+   *
+   * @param {*} input Bytes (or path where the format supports it).
+   * @param {object|null} options Format options.
+   * @returns {Promise<CjsResourceProbe>} Probe report; content-verified only when overridden.
+   */
+  static async resolveType(input, options = null) {
+    const report = _CjsResourceProbe.from(this.isSupported(input, options));
+    report.verified = false;
+    return report;
+  }
+  constructor(options = null) {
+    this.options = {
+      ...(options || {})
+    };
+  }
+  SetValues(values = null) {
+    if (!values || typeof values !== "object") {
+      return this;
+    }
+    if (Object.prototype.hasOwnProperty.call(values, "options")) {
+      this.options = {
+        ...(values.options || {})
+      };
+    } else {
+      this.options = {
+        ...this.options,
+        ...values
+      };
+    }
+    return this;
+  }
+  GetValues() {
+    return {
+      options: {
+        ...this.options
+      }
+    };
+  }
+  Initialize(values = null) {
+    return this.SetValues(values || {});
+  }
+
+  /**
+   * Primary instance read entrypoint for synchronous readers.
+   * Implementations may override with async handling in readAsync only if needed.
+   */
+  Read(input, options = null) {
+    throw new Error(`${this.constructor.name}.Read must be implemented by a format package.`);
+  }
+
+  /**
+   * Primary async read entrypoint for asynchronous readers.
+   * Defaults to sync Read for compatibility.
+   */
+  async ReadAsync(input, options = null) {
+    return this.Read(input, options);
+  }
+
+  /**
+   * Canonical package-family group names - the shared vocabulary object from
+   * runtime-const (kb: runtime-const owns cross-package media vocabulary).
+   * Same object identity as `@carbonenginejs/runtime-const/media` MediaType,
+   * so tokens can never drift between packages.
+   */
+  static Type = MediaType;
+
+  /**
+   * Canonical media-type groups used by format registration - the shared
+   * runtime-const MediaType object (see Type above).
+   */
+  static MediaType = MediaType;
+
+  /**
+   * Canonical output-type tokens used by format emit contracts. Shared
+   * payload ROLES come from runtime-const PayloadType; the remaining tokens
+   * (cmf/gr2/json/pcm/rgba/shared/objJson) are format-emit names owned by
+   * their formats and enumerated here for discoverability only.
+   */
+  static OutputType = Object.freeze({
+    AUDIO: PayloadType.AUDIO,
+    CMF: "cmf",
+    GR2: "gr2",
+    IMAGE: PayloadType.IMAGE,
+    JSON: "json",
+    PCM: "pcm",
+    RAW: PayloadType.RAW,
+    RGBA: "rgba",
+    SCHEMA: PayloadType.SCHEMA,
+    SHADER: PayloadType.SHADER,
+    SHARED: "shared",
+    TEXTURE: PayloadType.TEXTURE,
+    VIDEO: PayloadType.VIDEO,
+    OBJ_JSON: "objJson"
+  });
+  static type = Object.freeze([]);
+  static mediaTypes = Object.freeze([]);
+  static inputTypes = Object.freeze([]);
+  static outputTypes = Object.freeze([]);
+  static debugOutputTypes = Object.freeze(["json", "raw"]);
+}
+
+/**
+ * Shared utility for asserting required format metadata exists.
+ */
+function ValidateFormatContract(Constructor) {
+  if (!Constructor) {
+    throw new TypeError("ValidateFormatContract requires a format class.");
+  }
+  const hasOutput = Array.isArray(Constructor.outputTypes) && Constructor.outputTypes.length > 0;
+  const hasInput = Array.isArray(Constructor.inputTypes) && Constructor.inputTypes.length > 0;
+  const hasMedia = Array.isArray(Constructor.mediaTypes) && Constructor.mediaTypes.length > 0;
+  const hasType = Array.isArray(Constructor.type) && Constructor.type.length > 0;
+  const hasDebug = Array.isArray(Constructor.debugOutputTypes) && Constructor.debugOutputTypes.length > 0;
+  if (!hasType || !hasMedia || !hasInput || !hasOutput || !hasDebug) {
+    throw new TypeError(`Format contract missing metadata: type:${hasType} mediaTypes:${hasMedia} inputTypes:${hasInput} outputTypes:${hasOutput} debugOutputTypes:${hasDebug}`);
+  }
+}
+
+export { CjsFormat, ValidateFormatContract };
+//# sourceMappingURL=CjsFormat.js.map

package/dist/format/CjsFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsFormat.js","sources":["../../../src/format/CjsFormat.js"],"sourcesContent":["import { CjsResourceProbe } from \"./CjsResourceProbe.js\";\n\nexport class CjsFormat\n{\n  options = {};\n\n  /**\n   * Convenience factory for simple format helpers.\n   * Keep this lightweight so format classes can stay pure-reader implementations.\n   *\n   * @param {*} input\n   * @param {object} options\n   * @returns {Promise<*>|*}\n   */\n  static read(input, options = null) {\n    const reader = new this(options || {});\n    return reader.Read(input, options || {});\n  }\n\n  /**\n   * Async convenience factory for format readers.\n   *\n   * @param {*} input\n   * @param {object} options\n   * @returns {Promise<*>}\n   */\n  static async readAsync(input, options = null) {\n    const reader = new this(options || {});\n    return reader.ReadAsync(input, options || {});\n  }\n\n  /**\n   * Canonical support probe entrypoint.\n   * Returns a probe report including compressed/raw capability variants when implemented.\n   *\n   * @param {*} input\n   * @param {object} options\n   * @returns {CjsResourceProbe}\n   */\n  static isSupported(input, options = null) {\n    const source = typeof input === \"string\" ? \"path\" : \"buffer\";\n    const formatName = this.name\n      ? this.name.replace(/^Cjs/u, \"\").replace(/Format$/u, \"\").toLowerCase()\n      : \"format\";\n    return CjsResourceProbe.createUnsupported(formatName, \"No probe implementation.\", { source, ...options });\n  }\n\n  /**\n   * Alias for canonical naming.\n   *\n   * @param {*} input\n   * @param {object} options\n   * @returns {CjsResourceProbe}\n   */\n  static inspect(input, options = null) {\n    return this.isSupported(input, options);\n  }\n\n  constructor(options = null) {\n    this.options = { ...(options || {}) };\n  }\n\n  SetValues(values = null) {\n    if (!values || typeof values !== \"object\") {\n      return this;\n    }\n    if (Object.prototype.hasOwnProperty.call(values, \"options\")) {\n      this.options = { ...(values.options || {}) };\n    } else {\n      this.options = { ...this.options, ...values };\n    }\n    return this;\n  }\n\n  GetValues() {\n    return { options: { ...this.options } };\n  }\n\n  Initialize(values = null) {\n    return this.SetValues(values || {});\n  }\n\n  /**\n   * Primary instance read entrypoint for synchronous readers.\n   * Implementations may override with async handling in readAsync only if needed.\n   */\n  Read(input, options = null) {\n    throw new Error(`${this.constructor.name}.Read must be implemented by a format package.`);\n  }\n\n  /**\n   * Primary async read entrypoint for asynchronous readers.\n   * Defaults to sync Read for compatibility.\n   */\n  async ReadAsync(input, options = null) {\n    return this.Read(input, options);\n  }\n\n  /**\n   * Canonical package-family group names.\n   */\n  static Type = Object.freeze({\n    AUDIO: \"audio\",\n    DATA: \"data\",\n    GEOMETRY: \"geometry\",\n    IMAGE: \"image\",\n    SCHEMA: \"schema\",\n    SHADER: \"shader\",\n    TEXTURE: \"texture\",\n    VIDEO: \"video\"\n  });\n\n  /**\n   * Canonical media-type groups used by format registration.\n   */\n  static MediaType = Object.freeze({\n    AUDIO: \"audio\",\n    DATA: \"data\",\n    GEOMETRY: \"geometry\",\n    IMAGE: \"image\",\n    SHADER: \"shader\",\n    SCHEMA: \"schema\",\n    TEXTURE: \"texture\",\n    VIDEO: \"video\"\n  });\n\n  /**\n   * Canonical output-type tokens used by format emit contracts.\n   */\n  static OutputType = Object.freeze({\n    AUDIO: \"audio\",\n    CMF: \"cmf\",\n    GR2: \"gr2\",\n    IMAGE: \"image\",\n    JSON: \"json\",\n    PCM: \"pcm\",\n    RAW: \"raw\",\n    RGBA: \"rgba\",\n    SCHEMA: \"schema\",\n    SHADER: \"shader\",\n    SHARED: \"shared\",\n    TEXTURE: \"texture\",\n    VIDEO: \"video\",\n    OBJ_JSON: \"objJson\"\n  });\n\n  static type = Object.freeze([]);\n  static mediaTypes = Object.freeze([]);\n  static inputTypes = Object.freeze([]);\n  static outputTypes = Object.freeze([]);\n  static debugOutputTypes = Object.freeze([\"json\", \"raw\"]);\n}\n\n/**\n * Shared utility for asserting required format metadata exists.\n */\nexport function ValidateFormatContract(Constructor) {\n  if (!Constructor) {\n    throw new TypeError(\"ValidateFormatContract requires a format class.\");\n  }\n  const hasOutput = Array.isArray(Constructor.outputTypes) && Constructor.outputTypes.length > 0;\n  const hasInput = Array.isArray(Constructor.inputTypes) && Constructor.inputTypes.length > 0;\n  const hasMedia = Array.isArray(Constructor.mediaTypes) && Constructor.mediaTypes.length > 0;\n  const hasType = Array.isArray(Constructor.type) && Constructor.type.length > 0;\n  const hasDebug = Array.isArray(Constructor.debugOutputTypes) && Constructor.debugOutputTypes.length > 0;\n  if (!hasType || !hasMedia || !hasInput || !hasOutput || !hasDebug) {\n    throw new TypeError(`Format contract missing metadata: type:${hasType} mediaTypes:${hasMedia} inputTypes:${hasInput} outputTypes:${hasOutput} debugOutputTypes:${hasDebug}`);\n  }\n}\n"],"names":["CjsFormat","options","read","input","reader","Read","readAsync","ReadAsync","isSupported","source","formatName","name","replace","toLowerCase","CjsResourceProbe","createUnsupported","inspect","constructor","SetValues","values","Object","prototype","hasOwnProperty","call","GetValues","Initialize","Error","Type","freeze","AUDIO","DATA","GEOMETRY","IMAGE","SCHEMA","SHADER","TEXTURE","VIDEO","MediaType","OutputType","CMF","GR2","JSON","PCM","RAW","RGBA","SHARED","OBJ_JSON","type","mediaTypes","inputTypes","outputTypes","debugOutputTypes","ValidateFormatContract","Constructor","TypeError","hasOutput","Array","isArray","length","hasInput","hasMedia","hasType","hasDebug"],"mappings":"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"}
+{"version":3,"file":"CjsFormat.js","sources":["../../../src/format/CjsFormat.js"],"sourcesContent":["import { MediaType, PayloadType } from \"@carbonenginejs/runtime-const/media\";\nimport { CjsResourceProbe } from \"./CjsResourceProbe.js\";\n\nexport class CjsFormat\n{\n  options = {};\n\n  /**\n   * Convenience factory for simple format helpers.\n   * Keep this lightweight so format classes can stay pure-reader implementations.\n   *\n   * @param {*} input\n   * @param {object} options\n   * @returns {Promise<*>|*}\n   */\n  static read(input, options = null) {\n    const reader = new this(options || {});\n    return reader.Read(input, options || {});\n  }\n\n  /**\n   * Async convenience factory for format readers.\n   *\n   * @param {*} input\n   * @param {object} options\n   * @returns {Promise<*>}\n   */\n  static async readAsync(input, options = null) {\n    const reader = new this(options || {});\n    return reader.ReadAsync(input, options || {});\n  }\n\n  /**\n   * Canonical support probe entrypoint.\n   * Returns a probe report including compressed/raw capability variants when implemented.\n   *\n   * @param {*} input\n   * @param {object} options\n   * @returns {CjsResourceProbe}\n   */\n  static isSupported(input, options = null) {\n    const source = typeof input === \"string\" ? \"path\" : \"buffer\";\n    const formatName = this.name\n      ? this.name.replace(/^Cjs/u, \"\").replace(/Format$/u, \"\").toLowerCase()\n      : \"format\";\n    return CjsResourceProbe.createUnsupported(formatName, \"No probe implementation.\", { source, ...options });\n  }\n\n  /**\n   * Alias for canonical naming.\n   *\n   * @param {*} input\n   * @param {object} options\n   * @returns {CjsResourceProbe}\n   */\n  static inspect(input, options = null) {\n    return this.isSupported(input, options);\n  }\n\n  /**\n   * Content-verified type/route resolution (kb §5, optional per format).\n   *\n   * Where inspect()/isSupported() report what the container CLAIMS,\n   * resolveType() performs one bounded asynchronous content check (magic, a\n   * first frame/block, a setup header) and reports what the reader has\n   * evidence it can actually decode. Overrides return a CjsResourceProbe\n   * with `verified: true` and declared/resolved/mismatch evidence in\n   * `metadata`; `preferred` names the resolved decode route. A caller-forced\n   * emit always wins over a resolution, and this base implementation - the\n   * zero-extra-work path for formats without an override - delegates to\n   * isSupported() with `verified` false so an unverified result never\n   * changes a route.\n   *\n   * @param {*} input Bytes (or path where the format supports it).\n   * @param {object|null} options Format options.\n   * @returns {Promise<CjsResourceProbe>} Probe report; content-verified only when overridden.\n   */\n  static async resolveType(input, options = null) {\n    const report = CjsResourceProbe.from(this.isSupported(input, options));\n    report.verified = false;\n    return report;\n  }\n\n  constructor(options = null) {\n    this.options = { ...(options || {}) };\n  }\n\n  SetValues(values = null) {\n    if (!values || typeof values !== \"object\") {\n      return this;\n    }\n    if (Object.prototype.hasOwnProperty.call(values, \"options\")) {\n      this.options = { ...(values.options || {}) };\n    } else {\n      this.options = { ...this.options, ...values };\n    }\n    return this;\n  }\n\n  GetValues() {\n    return { options: { ...this.options } };\n  }\n\n  Initialize(values = null) {\n    return this.SetValues(values || {});\n  }\n\n  /**\n   * Primary instance read entrypoint for synchronous readers.\n   * Implementations may override with async handling in readAsync only if needed.\n   */\n  Read(input, options = null) {\n    throw new Error(`${this.constructor.name}.Read must be implemented by a format package.`);\n  }\n\n  /**\n   * Primary async read entrypoint for asynchronous readers.\n   * Defaults to sync Read for compatibility.\n   */\n  async ReadAsync(input, options = null) {\n    return this.Read(input, options);\n  }\n\n  /**\n   * Canonical package-family group names - the shared vocabulary object from\n   * runtime-const (kb: runtime-const owns cross-package media vocabulary).\n   * Same object identity as `@carbonenginejs/runtime-const/media` MediaType,\n   * so tokens can never drift between packages.\n   */\n  static Type = MediaType;\n\n  /**\n   * Canonical media-type groups used by format registration - the shared\n   * runtime-const MediaType object (see Type above).\n   */\n  static MediaType = MediaType;\n\n  /**\n   * Canonical output-type tokens used by format emit contracts. Shared\n   * payload ROLES come from runtime-const PayloadType; the remaining tokens\n   * (cmf/gr2/json/pcm/rgba/shared/objJson) are format-emit names owned by\n   * their formats and enumerated here for discoverability only.\n   */\n  static OutputType = Object.freeze({\n    AUDIO: PayloadType.AUDIO,\n    CMF: \"cmf\",\n    GR2: \"gr2\",\n    IMAGE: PayloadType.IMAGE,\n    JSON: \"json\",\n    PCM: \"pcm\",\n    RAW: PayloadType.RAW,\n    RGBA: \"rgba\",\n    SCHEMA: PayloadType.SCHEMA,\n    SHADER: PayloadType.SHADER,\n    SHARED: \"shared\",\n    TEXTURE: PayloadType.TEXTURE,\n    VIDEO: PayloadType.VIDEO,\n    OBJ_JSON: \"objJson\"\n  });\n\n  static type = Object.freeze([]);\n  static mediaTypes = Object.freeze([]);\n  static inputTypes = Object.freeze([]);\n  static outputTypes = Object.freeze([]);\n  static debugOutputTypes = Object.freeze([\"json\", \"raw\"]);\n}\n\n/**\n * Shared utility for asserting required format metadata exists.\n */\nexport function ValidateFormatContract(Constructor) {\n  if (!Constructor) {\n    throw new TypeError(\"ValidateFormatContract requires a format class.\");\n  }\n  const hasOutput = Array.isArray(Constructor.outputTypes) && Constructor.outputTypes.length > 0;\n  const hasInput = Array.isArray(Constructor.inputTypes) && Constructor.inputTypes.length > 0;\n  const hasMedia = Array.isArray(Constructor.mediaTypes) && Constructor.mediaTypes.length > 0;\n  const hasType = Array.isArray(Constructor.type) && Constructor.type.length > 0;\n  const hasDebug = Array.isArray(Constructor.debugOutputTypes) && Constructor.debugOutputTypes.length > 0;\n  if (!hasType || !hasMedia || !hasInput || !hasOutput || !hasDebug) {\n    throw new TypeError(`Format contract missing metadata: type:${hasType} mediaTypes:${hasMedia} inputTypes:${hasInput} outputTypes:${hasOutput} debugOutputTypes:${hasDebug}`);\n  }\n}\n"],"names":["CjsFormat","options","read","input","reader","Read","readAsync","ReadAsync","isSupported","source","formatName","name","replace","toLowerCase","CjsResourceProbe","createUnsupported","inspect","resolveType","report","from","verified","constructor","SetValues","values","Object","prototype","hasOwnProperty","call","GetValues","Initialize","Error","Type","MediaType","OutputType","freeze","AUDIO","PayloadType","CMF","GR2","IMAGE","JSON","PCM","RAW","RGBA","SCHEMA","SHADER","SHARED","TEXTURE","VIDEO","OBJ_JSON","type","mediaTypes","inputTypes","outputTypes","debugOutputTypes","ValidateFormatContract","Constructor","TypeError","hasOutput","Array","isArray","length","hasInput","hasMedia","hasType","hasDebug"],"mappings":"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"}

package/dist/format/CjsReader.js

@@ -0,0 +1,18 @@
+/**
+ * Internal base for construction-bound readers.
+ *
+ * A reader instance is created for one source and normally used and dropped.
+ * JavaScript garbage collection reclaims its parser and graph state, so readers
+ * do not require `dispose()` or `clear()` for correctness. This differs from
+ * native Blue readers such as `BlackReader`, whose cleanup releases manually
+ * allocated buffers and refcounted maps. Subclasses retain ownership of their
+ * source-specific state and reset behavior.
+ */
+class CjsReader {
+  constructor(options = {}) {
+    this.options = options;
+  }
+}
+
+export { CjsReader };
+//# sourceMappingURL=CjsReader.js.map

package/dist/format/CjsReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsReader.js","sources":["../../../src/format/CjsReader.js"],"sourcesContent":["/**\n * Internal base for construction-bound readers.\n *\n * A reader instance is created for one source and normally used and dropped.\n * JavaScript garbage collection reclaims its parser and graph state, so readers\n * do not require `dispose()` or `clear()` for correctness. This differs from\n * native Blue readers such as `BlackReader`, whose cleanup releases manually\n * allocated buffers and refcounted maps. Subclasses retain ownership of their\n * source-specific state and reset behavior.\n */\nexport class CjsReader\n{\n    constructor(options = {})\n    {\n        this.options = options;\n    }\n}\n\nexport default CjsReader;\n"],"names":["CjsReader","constructor","options"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,SAAS,CACtB;AACIC,EAAAA,WAAWA,CAACC,OAAO,GAAG,EAAE,EACxB;IACI,IAAI,CAACA,OAAO,GAAGA,OAAO;AAC1B,EAAA;AACJ;;;;"}