@carbonenginejs/runtime-resource 0.16.0 → 0.17.0

package/dist/format/CjsFormat.js

@@ -1,46 +1,46 @@
 import { MediaType, PayloadType } from '@carbonenginejs/runtime-utils/media';
 import { CjsResourceProbe as _CjsResourceProbe } from './CjsResourceProbe.js';
 
-/**
- * Base class for format readers that defines the static
- * `read`/`readAsync`/`isSupported`/`resolveType` contract and instance
- * option handling that concrete format packages implement.
+/**
+ * Base class for format readers that defines the static
+ * `read`/`readAsync`/`isSupported`/`resolveType` contract and instance
+ * option handling that concrete format packages implement.
  */
 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<*>|*}
+  /**
+   * 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<*>}
+  /**
+   * 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}
+  /**
+   * 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";
@@ -51,34 +51,35 @@ class CjsFormat {
     });
   }
 
-  /**
-   * Alias for canonical naming.
-   *
-   * @param {*} input
-   * @param {object} options
-   * @returns {CjsResourceProbe}
+  /**
+   * 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.
+  /**
+   * Content-verified type/route resolution (optional per format).
+   * Contract: docs/concepts/format-type-resolution.md.
+   *
+   * 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));
@@ -111,9 +112,9 @@ class CjsFormat {
     return this;
   }
 
-  /**
-   * Returns a copy of the current format options for the resource format
-   * configuration.
+  /**
+   * Returns a copy of the current format options for the resource format
+   * configuration.
    */
   GetValues() {
     return {
@@ -123,49 +124,49 @@ class CjsFormat {
     };
   }
 
-  /**
-   * Initializes the format with the supplied values and context for the resource
-   * format configuration.
+  /**
+   * Initializes the format with the supplied values and context for the resource
+   * format configuration.
    */
   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.
+  /**
+   * 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.
+  /**
+   * 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-utils (kb: runtime-utils owns cross-package media vocabulary).
-   * Same object identity as `@carbonenginejs/runtime-utils/media` MediaType,
-   * so tokens can never drift between packages.
+  /**
+   * Canonical package-family group names - the shared vocabulary object from
+   * runtime-utils (kb: runtime-utils owns cross-package media vocabulary).
+   * Same object identity as `@carbonenginejs/runtime-utils/media` MediaType,
+   * so tokens can never drift between packages.
    */
   static Type = MediaType;
 
-  /**
-   * Canonical media-type groups used by format registration - the shared
-   * runtime-utils MediaType object (see Type above).
+  /**
+   * Canonical media-type groups used by format registration - the shared
+   * runtime-utils MediaType object (see Type above).
    */
   static MediaType = MediaType;
 
-  /**
-   * Canonical output-type tokens used by format emit contracts. Shared
-   * payload ROLES come from runtime-utils 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.
+  /**
+   * Canonical output-type tokens used by format emit contracts. Shared
+   * payload ROLES come from runtime-utils 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,
@@ -189,20 +190,20 @@ class CjsFormat {
   static outputTypes = Object.freeze([]);
   static debugOutputTypes = Object.freeze(["json", "raw"]);
 
-  /**
-   * Optional browser-worker module declaration.
-   *
-   * Concrete formats opt in with their exact `import.meta.url`, export name,
-   * and optional clone-safe output restrictions.
+  /**
+   * Optional browser-worker module declaration.
+   *
+   * Concrete formats opt in with their exact `import.meta.url`, export name,
+   * and optional clone-safe output restrictions.
    */
   static worker = null;
 
-  /**
-   * Asserts that a format class declares the metadata required for
-   * registration and routing.
-   *
-   * @param {typeof CjsFormat} Constructor
-   * @returns {void}
+  /**
+   * Asserts that a format class declares the metadata required for
+   * registration and routing.
+   *
+   * @param {typeof CjsFormat} Constructor
+   * @returns {void}
    */
   static validateContract(Constructor) {
     if (!Constructor) {

package/dist/format/CjsFormat.js.map

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

package/dist/format/CjsResourceProbe.js

@@ -4,16 +4,16 @@ import { io, type } from '@carbonenginejs/runtime-utils/schema';
 
 let _initClass, _init_format, _init_extra_format, _init_source, _init_extra_source, _init_supported, _init_extra_supported, _init_verified, _init_extra_verified, _init_confidence, _init_extra_confidence, _init_preferred, _init_extra_preferred, _init_reason, _init_extra_reason, _init_metadata, _init_extra_metadata, _init_variant, _init_extra_variant, _init_variants, _init_extra_variants, _init_warnings, _init_extra_warnings, _init_errors, _init_extra_errors;
 
-/**
- * Standard probe report for resource formats and a reusable base for format-specific probes.
- *
- * Instances can be built by:
- * - returning plain object JSON payloads from format packages, then converted with CjsResourceProbe.from(...)
- * - returning CjsResourceProbe instances directly
- *
- * A format can report multiple usable variants in one payload, such as a
- * native compressed texture and a decoded RGBA fallback, without deciding
- * which engine-gpu or media backend should use.
+/**
+ * Standard probe report for resource formats and a reusable base for format-specific probes.
+ *
+ * Instances can be built by:
+ * - returning plain object JSON payloads from format packages, then converted with CjsResourceProbe.from(...)
+ * - returning CjsResourceProbe instances directly
+ *
+ * A format can report multiple usable variants in one payload, such as a
+ * native compressed texture and a decoded RGBA fallback, without deciding
+ * which engine-gpu or media backend should use.
  */
 let _CjsResourceProbe;
 class CjsResourceProbe extends CjsModel {
@@ -30,11 +30,12 @@ class CjsResourceProbe extends CjsModel {
   source = (_init_extra_format(this), _init_source(this, ""));
   supported = (_init_extra_source(this), _init_supported(this, "none"));
 
-  /**
-   * True when the report's variant flags are CONTENT-verified (a bounded
-   * resolveType() check ran), false when they are declaration-derived
-   * (inspect/isSupported). Declared/resolved/mismatch evidence rides in
-   * `metadata` per the kb §5 content-verified type resolution contract.
+  /**
+   * True when the report's variant flags are CONTENT-verified (a bounded
+   * resolveType() check ran), false when they are declaration-derived
+   * (inspect/isSupported). Declared/resolved/mismatch evidence rides in
+   * `metadata` per the content-verified type resolution contract
+  // (docs/concepts/format-type-resolution.md).
    */
   verified = (_init_extra_supported(this), _init_verified(this, false));
   confidence = (_init_extra_verified(this), _init_confidence(this, 0));
@@ -56,11 +57,11 @@ class CjsResourceProbe extends CjsModel {
     });
   }
 
-  /**
-   * Initialize probe fields from a plain object payload.
-   *
-   * @param {object|null} values
-   * @returns {CjsResourceProbe}
+  /**
+   * Initialize probe fields from a plain object payload.
+   *
+   * @param {object|null} values
+   * @returns {CjsResourceProbe}
    */
   Initialize(values = null) {
     this.SetValues(values || {}, {
@@ -69,15 +70,15 @@ class CjsResourceProbe extends CjsModel {
     return this;
   }
 
-  /**
-   * Lightweight probe entrypoint.
-   * Format packages should override this or provide their own probe implementation.
-   *
-   * @param {*} src
-   *   Raw source path or source payload passed by caller.
-   * @param {object|null} options
-   *   Optional metadata/control overrides.
-   * @returns {CjsResourceProbe}
+  /**
+   * Lightweight probe entrypoint.
+   * Format packages should override this or provide their own probe implementation.
+   *
+   * @param {*} src
+   *   Raw source path or source payload passed by caller.
+   * @param {object|null} options
+   *   Optional metadata/control overrides.
+   * @returns {CjsResourceProbe}
    */
   static isSupported(src, options = null) {
     return new _CjsResourceProbe({
@@ -96,24 +97,24 @@ class CjsResourceProbe extends CjsModel {
     });
   }
 
-  /**
-   * Detailed probe with report-style metadata. Aliases isSupported() in this minimal base.
-   *
-   * @param {*} src
-   * @param {object|null} options
-   * @returns {CjsResourceProbe}
+  /**
+   * Detailed probe with report-style metadata. Aliases isSupported() in this minimal base.
+   *
+   * @param {*} src
+   * @param {object|null} options
+   * @returns {CjsResourceProbe}
    */
   static inspect(src, options = null) {
     return _CjsResourceProbe.isSupported(src, options);
   }
 
-  /**
-   * Build a probe report representing explicit failure.
-   *
-   * @param {string} format
-   * @param {string} reason
-   * @param {object|null} options
-   * @returns {CjsResourceProbe}
+  /**
+   * Build a probe report representing explicit failure.
+   *
+   * @param {string} format
+   * @param {string} reason
+   * @param {object|null} options
+   * @returns {CjsResourceProbe}
    */
   static createUnsupported(format, reason, options = null) {
     return new _CjsResourceProbe({
@@ -130,13 +131,13 @@ class CjsResourceProbe extends CjsModel {
     });
   }
 
-  /**
-   * Build a probe report representing one or more variants.
-   *
-   * @param {string} format
-   * @param {Array<Object>} variants
-   * @param {object|null} options
-   * @returns {CjsResourceProbe}
+  /**
+   * Build a probe report representing one or more variants.
+   *
+   * @param {string} format
+   * @param {Array<Object>} variants
+   * @param {object|null} options
+   * @returns {CjsResourceProbe}
    */
   static createSupported(format, variants, options = null) {
     const normalizedVariants = Array.isArray(variants) ? variants : [];
@@ -159,11 +160,11 @@ class CjsResourceProbe extends CjsModel {
     });
   }
 
-  /**
-   * Normalize incoming report payloads into a standard CjsResourceProbe instance.
-   *
-   * @param {CjsResourceProbe|object|null} input
-   * @returns {CjsResourceProbe}
+  /**
+   * Normalize incoming report payloads into a standard CjsResourceProbe instance.
+   *
+   * @param {CjsResourceProbe|object|null} input
+   * @returns {CjsResourceProbe}
    */
   static from(input) {
     if (input instanceof _CjsResourceProbe) return input;
@@ -175,11 +176,11 @@ class CjsResourceProbe extends CjsModel {
     return _CjsResourceProbe.createUnsupported("", "Invalid probe payload.");
   }
 
-  /**
-   * Normalize a plain probe report while preserving format-specific metadata.
-   *
-   * @param {object} input
-   * @returns {object}
+  /**
+   * Normalize a plain probe report while preserving format-specific metadata.
+   *
+   * @param {object} input
+   * @returns {object}
    */
   static normalizeReport(input) {
     const variants = Array.isArray(input.variants) ? input.variants.map(entry => _CjsResourceProbe.normalizeVariant(entry)) : [];
@@ -190,11 +191,11 @@ class CjsResourceProbe extends CjsModel {
     };
   }
 
-  /**
-   * Normalize variant objects so runtimes can evaluate capability uniformly.
-   *
-   * @param {object|any} input
-   * @returns {{kind: string, payloadType: string, codec: string, format: string, supported: boolean, reason: string, meta: *}}
+  /**
+   * Normalize variant objects so runtimes can evaluate capability uniformly.
+   *
+   * @param {object|any} input
+   * @returns {{kind: string, payloadType: string, codec: string, format: string, supported: boolean, reason: string, meta: *}}
    */
   static normalizeVariant(input) {
     if (!input || typeof input !== "object") {
@@ -221,11 +222,11 @@ class CjsResourceProbe extends CjsModel {
     };
   }
 
-  /**
-   * Select best preferred variant from normalized variant list.
-   *
-   * @param {Array<Object>} variants
-   * @returns {string}
+  /**
+   * Select best preferred variant from normalized variant list.
+   *
+   * @param {Array<Object>} variants
+   * @returns {string}
    */
   static selectPreferred(variants) {
     if (!Array.isArray(variants) || variants.length < 1) return "";
@@ -234,38 +235,38 @@ class CjsResourceProbe extends CjsModel {
     return preferred ? preferred.codec || preferred.payloadType || preferred.kind || "" : "";
   }
 
-  /**
-   * Returns true if any supported variant is available.
-   *
-   * @returns {boolean}
+  /**
+   * Returns true if any supported variant is available.
+   *
+   * @returns {boolean}
    */
   isSupported() {
     return this.supported === "full" || this.supported === "partial";
   }
 
-  /**
-   * Returns true if raw fallback variant is supported.
-   *
-   * @returns {boolean}
+  /**
+   * Returns true if raw fallback variant is supported.
+   *
+   * @returns {boolean}
    */
   canUseRaw() {
     return this.variants.some(entry => entry && ["raw", "rgba"].includes(entry.kind) && entry.supported);
   }
 
-  /**
-   * Returns true if compressed variant is supported.
-   *
-   * @returns {boolean}
+  /**
+   * Returns true if compressed variant is supported.
+   *
+   * @returns {boolean}
    */
   canUseCompressed() {
     return this.variants.some(entry => entry && entry.kind === "compressed" && entry.supported);
   }
 
-  /**
-   * Return true when a supported variant of the requested kind exists.
-   *
-   * @param {string} kind
-   * @returns {boolean}
+  /**
+   * Return true when a supported variant of the requested kind exists.
+   *
+   * @param {string} kind
+   * @returns {boolean}
    */
   canUse(kind) {
     return this.variants.some(entry => entry && entry.kind === kind && entry.supported);