@carbonenginejs/runtime-resource 0.1.0 → 0.8.0

package/dist/format/CjsResourceProbe.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsResourceProbe.js","sources":["../../../src/format/CjsResourceProbe.js"],"sourcesContent":["import { CjsModel } from \"@carbonenginejs/core-types/model\";\nimport { io, type } from \"@carbonenginejs/core-types/schema\";\n\n/**\n * Standard probe report for resource formats and a reusable base for format-specific probes.\n *\n * Instances can be built by:\n * - returning plain object JSON payloads from format packages, then converted with CjsResourceProbe.from(...)\n * - returning CjsResourceProbe instances directly\n *\n * A format can report multiple usable variants in one payload, such as a\n * native compressed texture and a decoded RGBA fallback, without deciding\n * which engine-gpu or media backend should use.\n */\n@type.define({ className: \"CjsResourceProbe\", family: \"resource\" })\nexport class CjsResourceProbe extends CjsModel\n{\n  @io.persist\n  @type.string\n  format = \"\";\n\n  @io.persist\n  @type.string\n  source = \"\";\n\n  @io.persist\n  @type.string\n  supported = \"none\";\n\n  @io.persist\n  @type.float64\n  confidence = 0;\n\n  @io.persist\n  @type.string\n  preferred = \"\";\n\n  @io.persist\n  @type.string\n  reason = \"\";\n\n  @io.persist\n  @type.unknown\n  metadata = null;\n\n  @io.persist\n  @type.unknown\n  variant = {};\n\n  @io.persist\n  @type.list(\"unknown\")\n  variants = [];\n\n  @io.persist\n  @type.list(\"string\")\n  warnings = [];\n\n  @io.persist\n  @type.list(\"string\")\n  errors = [];\n\n  constructor(values = null) {\n    super();\n    this.SetValues(values || {}, {\n      markDirty: false,\n      skipUpdate: true,\n      skipEvents: true\n    });\n  }\n\n  /**\n   * Initialize probe fields from a plain object payload.\n   *\n   * @param {object|null} values\n   * @returns {CjsResourceProbe}\n   */\n  Initialize(values = null) {\n    this.SetValues(values || {}, { skipEvents: true });\n    return this;\n  }\n\n  /**\n   * Lightweight probe entrypoint.\n   * Format packages should override this or provide their own probe implementation.\n   *\n   * @param {*} src\n   *   Raw source path or source payload passed by caller.\n   * @param {object|null} options\n   *   Optional metadata/control overrides.\n   * @returns {CjsResourceProbe}\n   */\n  static isSupported(src, options = null) {\n    return new CjsResourceProbe({\n      format: \"\",\n      source: typeof src === \"string\" ? src : \"buffer\",\n      supported: \"none\",\n      confidence: 0,\n      preferred: \"\",\n      reason: \"No probe provided.\",\n      metadata: null,\n      variant: {},\n      variants: [],\n      warnings: [],\n      errors: [\"CjsResourceProbe has no built-in format detection.\"],\n      ...options\n    });\n  }\n\n  /**\n   * Detailed probe with report-style metadata. Aliases isSupported() in this minimal base.\n   *\n   * @param {*} src\n   * @param {object|null} options\n   * @returns {CjsResourceProbe}\n   */\n  static inspect(src, options = null) {\n    return CjsResourceProbe.isSupported(src, options);\n  }\n\n  /**\n   * Build a probe report representing explicit failure.\n   *\n   * @param {string} format\n   * @param {string} reason\n   * @param {object|null} options\n   * @returns {CjsResourceProbe}\n   */\n  static createUnsupported(format, reason, options = null) {\n    return new CjsResourceProbe({\n      format,\n      supported: \"none\",\n      confidence: 0,\n      preferred: \"\",\n      reason: reason || \"Unsupported format.\",\n      variant: {},\n      variants: [],\n      warnings: [],\n      errors: [reason],\n      ...(options || {})\n    });\n  }\n\n  /**\n   * Build a probe report representing one or more variants.\n   *\n   * @param {string} format\n   * @param {Array<Object>} variants\n   * @param {object|null} options\n   * @returns {CjsResourceProbe}\n   */\n  static createSupported(format, variants, options = null) {\n    const normalizedVariants = Array.isArray(variants) ? variants : [];\n    const anySupported = normalizedVariants.some((entry) => entry && entry.supported === true);\n    const normalized = normalizedVariants.map((entry) => CjsResourceProbe.normalizeVariant(entry));\n    const preferred = options && options.preferred ? options.preferred : CjsResourceProbe.selectPreferred(normalized);\n\n    return new CjsResourceProbe({\n      format,\n      source: options?.source || \"\",\n      supported: anySupported ? \"full\" : normalizedVariants.length > 0 ? \"partial\" : \"none\",\n      confidence: normalized.length > 0 && anySupported ? 1 : (normalized.length > 0 ? 0.5 : 0),\n      preferred,\n      reason: options?.reason || (anySupported ? \"Supported variant found.\" : \"No variant supported.\"),\n      metadata: options?.metadata || null,\n      variant: normalized[0] || {},\n      variants: normalized,\n      warnings: Array.isArray(options?.warnings) ? options.warnings : [],\n      errors: Array.isArray(options?.errors) ? options.errors : [],\n      ...(options || {})\n    });\n  }\n\n  /**\n   * Normalize incoming report payloads into a standard CjsResourceProbe instance.\n   *\n   * @param {CjsResourceProbe|object|null} input\n   * @returns {CjsResourceProbe}\n   */\n  static from(input) {\n    if (input instanceof CjsResourceProbe) return input;\n    if (!input) return CjsResourceProbe.createUnsupported(\"\", \"No probe input.\");\n    if (typeof input === \"object\" && typeof input.toJSON === \"function\") {\n      return new CjsResourceProbe(CjsResourceProbe.normalizeReport(input.toJSON()));\n    }\n    if (typeof input === \"object\") return new CjsResourceProbe(CjsResourceProbe.normalizeReport(input));\n    return CjsResourceProbe.createUnsupported(\"\", \"Invalid probe payload.\");\n  }\n\n  /**\n   * Normalize a plain probe report while preserving format-specific metadata.\n   *\n   * @param {object} input\n   * @returns {object}\n   */\n  static normalizeReport(input) {\n    const variants = Array.isArray(input.variants)\n      ? input.variants.map((entry) => CjsResourceProbe.normalizeVariant(entry))\n      : [];\n    return {\n      ...input,\n      variant: input.variant ? CjsResourceProbe.normalizeVariant(input.variant) : variants[0] || {},\n      variants\n    };\n  }\n\n  /**\n   * Normalize variant objects so runtimes can evaluate capability uniformly.\n   *\n   * @param {object|any} input\n   * @returns {{kind: string, payloadType: string, codec: string, format: string, supported: boolean, reason: string, meta: *}}\n   */\n  static normalizeVariant(input) {\n    if (!input || typeof input !== \"object\") {\n      return {\n        kind: \"raw\",\n        payloadType: \"raw\",\n        codec: \"\",\n        format: \"\",\n        supported: false,\n        reason: \"Invalid variant payload.\",\n        meta: null\n      };\n    }\n\n    const kind = input.kind || input.payloadType || \"raw\";\n    return {\n      ...input,\n      kind,\n      payloadType: input.payloadType || kind,\n      codec: input.codec || \"\",\n      format: input.format || \"\",\n      supported: !!input.supported,\n      reason: input.reason || \"\",\n      meta: input.meta || null\n    };\n  }\n\n  /**\n   * Select best preferred variant from normalized variant list.\n   *\n   * @param {Array<Object>} variants\n   * @returns {string}\n   */\n  static selectPreferred(variants) {\n    if (!Array.isArray(variants) || variants.length < 1) return \"\";\n    const priority = [ \"compressed\", \"texture\", \"rgba\", \"pcm\", \"raw\", \"container\", \"video\", \"audio\" ];\n    const preferred = priority\n      .map((kind) => variants.find((variant) => variant.kind === kind && variant.supported))\n      .find(Boolean) || variants.find((variant) => variant.supported);\n    return preferred ? preferred.codec || preferred.payloadType || preferred.kind || \"\" : \"\";\n  }\n\n  /**\n   * Returns true if any supported variant is available.\n   *\n   * @returns {boolean}\n   */\n  isSupported() {\n    return this.supported === \"full\" || this.supported === \"partial\";\n  }\n\n  /**\n   * Returns true if raw fallback variant is supported.\n   *\n   * @returns {boolean}\n   */\n  canUseRaw() {\n    return this.variants.some((entry) => entry && [ \"raw\", \"rgba\" ].includes(entry.kind) && entry.supported);\n  }\n\n  /**\n   * Returns true if compressed variant is supported.\n   *\n   * @returns {boolean}\n   */\n  canUseCompressed() {\n    return this.variants.some((entry) => entry && entry.kind === \"compressed\" && entry.supported);\n  }\n\n  /**\n   * Return true when a supported variant of the requested kind exists.\n   *\n   * @param {string} kind\n   * @returns {boolean}\n   */\n  canUse(kind) {\n    return this.variants.some((entry) => entry && entry.kind === kind && entry.supported);\n  }\n}\n"],"names":["_CjsResourceProbe","CjsResourceProbe","CjsModel","e","_init_format","_init_extra_format","_init_source","_init_extra_source","_init_supported","_init_extra_supported","_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","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","float64","unknown","list","format","source","supported","confidence","preferred","reason","metadata","variant","variants","warnings","errors","constructor","values","SetValues","markDirty","skipUpdate","skipEvents","Initialize","isSupported","src","options","inspect","createUnsupported","createSupported","normalizedVariants","Array","isArray","anySupported","some","entry","normalized","map","normalizeVariant","selectPreferred","length","from","input","toJSON","normalizeReport","kind","payloadType","codec","meta","priority","find","Boolean","canUseRaw","includes","canUseCompressed","canUse"],"mappings":"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"}
+{"version":3,"file":"CjsResourceProbe.js","sources":["../../../src/format/CjsResourceProbe.js"],"sourcesContent":["import { CjsModel } from \"@carbonenginejs/core-types/model\";\nimport { io, type } from \"@carbonenginejs/core-types/schema\";\n\n/**\n * Standard probe report for resource formats and a reusable base for format-specific probes.\n *\n * Instances can be built by:\n * - returning plain object JSON payloads from format packages, then converted with CjsResourceProbe.from(...)\n * - returning CjsResourceProbe instances directly\n *\n * A format can report multiple usable variants in one payload, such as a\n * native compressed texture and a decoded RGBA fallback, without deciding\n * which engine-gpu or media backend should use.\n */\n@type.define({ className: \"CjsResourceProbe\", family: \"resource\" })\nexport class CjsResourceProbe extends CjsModel\n{\n  @io.persist\n  @type.string\n  format = \"\";\n\n  @io.persist\n  @type.string\n  source = \"\";\n\n  @io.persist\n  @type.string\n  supported = \"none\";\n\n  /**\n   * True when the report's variant flags are CONTENT-verified (a bounded\n   * resolveType() check ran), false when they are declaration-derived\n   * (inspect/isSupported). Declared/resolved/mismatch evidence rides in\n   * `metadata` per the kb §5 content-verified type resolution contract.\n   */\n  @io.persist\n  @type.boolean\n  verified = false;\n\n  @io.persist\n  @type.float64\n  confidence = 0;\n\n  @io.persist\n  @type.string\n  preferred = \"\";\n\n  @io.persist\n  @type.string\n  reason = \"\";\n\n  @io.persist\n  @type.unknown\n  metadata = null;\n\n  @io.persist\n  @type.unknown\n  variant = {};\n\n  @io.persist\n  @type.list(\"unknown\")\n  variants = [];\n\n  @io.persist\n  @type.list(\"string\")\n  warnings = [];\n\n  @io.persist\n  @type.list(\"string\")\n  errors = [];\n\n  constructor(values = null) {\n    super();\n    this.SetValues(values || {}, {\n      markDirty: false,\n      skipUpdate: true,\n      skipEvents: true\n    });\n  }\n\n  /**\n   * Initialize probe fields from a plain object payload.\n   *\n   * @param {object|null} values\n   * @returns {CjsResourceProbe}\n   */\n  Initialize(values = null) {\n    this.SetValues(values || {}, { skipEvents: true });\n    return this;\n  }\n\n  /**\n   * Lightweight probe entrypoint.\n   * Format packages should override this or provide their own probe implementation.\n   *\n   * @param {*} src\n   *   Raw source path or source payload passed by caller.\n   * @param {object|null} options\n   *   Optional metadata/control overrides.\n   * @returns {CjsResourceProbe}\n   */\n  static isSupported(src, options = null) {\n    return new CjsResourceProbe({\n      format: \"\",\n      source: typeof src === \"string\" ? src : \"buffer\",\n      supported: \"none\",\n      confidence: 0,\n      preferred: \"\",\n      reason: \"No probe provided.\",\n      metadata: null,\n      variant: {},\n      variants: [],\n      warnings: [],\n      errors: [\"CjsResourceProbe has no built-in format detection.\"],\n      ...options\n    });\n  }\n\n  /**\n   * Detailed probe with report-style metadata. Aliases isSupported() in this minimal base.\n   *\n   * @param {*} src\n   * @param {object|null} options\n   * @returns {CjsResourceProbe}\n   */\n  static inspect(src, options = null) {\n    return CjsResourceProbe.isSupported(src, options);\n  }\n\n  /**\n   * Build a probe report representing explicit failure.\n   *\n   * @param {string} format\n   * @param {string} reason\n   * @param {object|null} options\n   * @returns {CjsResourceProbe}\n   */\n  static createUnsupported(format, reason, options = null) {\n    return new CjsResourceProbe({\n      format,\n      supported: \"none\",\n      confidence: 0,\n      preferred: \"\",\n      reason: reason || \"Unsupported format.\",\n      variant: {},\n      variants: [],\n      warnings: [],\n      errors: [reason],\n      ...(options || {})\n    });\n  }\n\n  /**\n   * Build a probe report representing one or more variants.\n   *\n   * @param {string} format\n   * @param {Array<Object>} variants\n   * @param {object|null} options\n   * @returns {CjsResourceProbe}\n   */\n  static createSupported(format, variants, options = null) {\n    const normalizedVariants = Array.isArray(variants) ? variants : [];\n    const anySupported = normalizedVariants.some((entry) => entry && entry.supported === true);\n    const normalized = normalizedVariants.map((entry) => CjsResourceProbe.normalizeVariant(entry));\n    const preferred = options && options.preferred ? options.preferred : CjsResourceProbe.selectPreferred(normalized);\n\n    return new CjsResourceProbe({\n      format,\n      source: options?.source || \"\",\n      supported: anySupported ? \"full\" : normalizedVariants.length > 0 ? \"partial\" : \"none\",\n      confidence: normalized.length > 0 && anySupported ? 1 : (normalized.length > 0 ? 0.5 : 0),\n      preferred,\n      reason: options?.reason || (anySupported ? \"Supported variant found.\" : \"No variant supported.\"),\n      metadata: options?.metadata || null,\n      variant: normalized[0] || {},\n      variants: normalized,\n      warnings: Array.isArray(options?.warnings) ? options.warnings : [],\n      errors: Array.isArray(options?.errors) ? options.errors : [],\n      ...(options || {})\n    });\n  }\n\n  /**\n   * Normalize incoming report payloads into a standard CjsResourceProbe instance.\n   *\n   * @param {CjsResourceProbe|object|null} input\n   * @returns {CjsResourceProbe}\n   */\n  static from(input) {\n    if (input instanceof CjsResourceProbe) return input;\n    if (!input) return CjsResourceProbe.createUnsupported(\"\", \"No probe input.\");\n    if (typeof input === \"object\" && typeof input.toJSON === \"function\") {\n      return new CjsResourceProbe(CjsResourceProbe.normalizeReport(input.toJSON()));\n    }\n    if (typeof input === \"object\") return new CjsResourceProbe(CjsResourceProbe.normalizeReport(input));\n    return CjsResourceProbe.createUnsupported(\"\", \"Invalid probe payload.\");\n  }\n\n  /**\n   * Normalize a plain probe report while preserving format-specific metadata.\n   *\n   * @param {object} input\n   * @returns {object}\n   */\n  static normalizeReport(input) {\n    const variants = Array.isArray(input.variants)\n      ? input.variants.map((entry) => CjsResourceProbe.normalizeVariant(entry))\n      : [];\n    return {\n      ...input,\n      variant: input.variant ? CjsResourceProbe.normalizeVariant(input.variant) : variants[0] || {},\n      variants\n    };\n  }\n\n  /**\n   * Normalize variant objects so runtimes can evaluate capability uniformly.\n   *\n   * @param {object|any} input\n   * @returns {{kind: string, payloadType: string, codec: string, format: string, supported: boolean, reason: string, meta: *}}\n   */\n  static normalizeVariant(input) {\n    if (!input || typeof input !== \"object\") {\n      return {\n        kind: \"raw\",\n        payloadType: \"raw\",\n        codec: \"\",\n        format: \"\",\n        supported: false,\n        reason: \"Invalid variant payload.\",\n        meta: null\n      };\n    }\n\n    const kind = input.kind || input.payloadType || \"raw\";\n    return {\n      ...input,\n      kind,\n      payloadType: input.payloadType || kind,\n      codec: input.codec || \"\",\n      format: input.format || \"\",\n      supported: !!input.supported,\n      reason: input.reason || \"\",\n      meta: input.meta || null\n    };\n  }\n\n  /**\n   * Select best preferred variant from normalized variant list.\n   *\n   * @param {Array<Object>} variants\n   * @returns {string}\n   */\n  static selectPreferred(variants) {\n    if (!Array.isArray(variants) || variants.length < 1) return \"\";\n    const priority = [ \"compressed\", \"texture\", \"rgba\", \"pcm\", \"raw\", \"container\", \"video\", \"audio\" ];\n    const preferred = priority\n      .map((kind) => variants.find((variant) => variant.kind === kind && variant.supported))\n      .find(Boolean) || variants.find((variant) => variant.supported);\n    return preferred ? preferred.codec || preferred.payloadType || preferred.kind || \"\" : \"\";\n  }\n\n  /**\n   * Returns true if any supported variant is available.\n   *\n   * @returns {boolean}\n   */\n  isSupported() {\n    return this.supported === \"full\" || this.supported === \"partial\";\n  }\n\n  /**\n   * Returns true if raw fallback variant is supported.\n   *\n   * @returns {boolean}\n   */\n  canUseRaw() {\n    return this.variants.some((entry) => entry && [ \"raw\", \"rgba\" ].includes(entry.kind) && entry.supported);\n  }\n\n  /**\n   * Returns true if compressed variant is supported.\n   *\n   * @returns {boolean}\n   */\n  canUseCompressed() {\n    return this.variants.some((entry) => entry && entry.kind === \"compressed\" && entry.supported);\n  }\n\n  /**\n   * Return true when a supported variant of the requested kind exists.\n   *\n   * @param {string} kind\n   * @returns {boolean}\n   */\n  canUse(kind) {\n    return this.variants.some((entry) => entry && entry.kind === kind && entry.supported);\n  }\n}\n"],"names":["_CjsResourceProbe","CjsResourceProbe","CjsModel","e","_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","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","boolean","float64","unknown","list","format","source","supported","verified","confidence","preferred","reason","metadata","variant","variants","warnings","errors","constructor","values","SetValues","markDirty","skipUpdate","skipEvents","Initialize","isSupported","src","options","inspect","createUnsupported","createSupported","normalizedVariants","Array","isArray","anySupported","some","entry","normalized","map","normalizeVariant","selectPreferred","length","from","input","toJSON","normalizeReport","kind","payloadType","codec","meta","priority","find","Boolean","canUseRaw","includes","canUseCompressed","canUse"],"mappings":"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"}

package/dist/format/payloadContract.js

@@ -1,173 +1,173 @@
-/**
- * Canonical semantic payload vocabulary shared by runtime-resource adapters
- * and pure format readers.
- *
- * Format packages may return plain objects matching these shapes without
- * importing runtime-resource. These validators are runtime-side guardrails;
- * they are not file decoders or GPU capability checks.
- */
-
-const ResourcePayloadType = Object.freeze({
-  RGBA: "rgba",
-  TEXTURE: "texture",
-  AUDIO: "audio",
-  PCM: "pcm",
-  VIDEO: "video"
-});
-const ResourcePayloadValues = Object.freeze({
-  imageOrigins: Object.freeze(["top-left"]),
-  colorSpaces: Object.freeze(["srgb", "linear", "unknown"]),
-  alphaModes: Object.freeze(["straight", "premultiplied", "opaque", "unknown"]),
-  textureDimensions: Object.freeze(["2d", "cube", "3d", "array"])
-});
-function validateRgbaPayload(payload, options = null) {
-  const value = assertObject(payload, "RGBA payload");
-  assertPayloadType(value, ResourcePayloadType.RGBA, "RGBA payload");
-  assertDimensions(value, "RGBA payload");
-  assertString(value.pixelFormat, "RGBA payload.pixelFormat");
-  const layout = {
-    rgba8unorm: {
-      bytesPerPixel: 4,
-      arrayType: Uint8Array
-    },
-    rgba32float: {
-      bytesPerPixel: 16,
-      arrayType: Float32Array
-    }
-  }[value.pixelFormat];
-  if (!layout) {
-    throw new TypeError("RGBA payload.pixelFormat must be \"rgba8unorm\" or \"rgba32float\".");
-  }
-  if (!(value.data instanceof layout.arrayType)) {
-    throw new TypeError(`RGBA payload.data must be a ${layout.arrayType.name}.`);
-  }
-  assertPositiveOrZeroInteger(value.strideBytes, "RGBA payload.strideBytes");
-  if (value.strideBytes < value.width * layout.bytesPerPixel) {
-    throw new RangeError("RGBA payload.strideBytes is smaller than one RGBA row.");
-  }
-  if (value.data.byteLength < value.strideBytes * value.height) {
-    throw new RangeError("RGBA payload.data is shorter than the declared image rows.");
-  }
-  if (value.strideBytes % value.data.BYTES_PER_ELEMENT !== 0) {
-    throw new RangeError("RGBA payload.strideBytes must align to its typed-array elements.");
-  }
-  assertEnum(value.origin, ResourcePayloadValues.imageOrigins, "RGBA payload.origin");
-  assertEnum(value.colorSpace, ResourcePayloadValues.colorSpaces, "RGBA payload.colorSpace");
-  assertEnum(value.alphaMode, ResourcePayloadValues.alphaModes, "RGBA payload.alphaMode");
-  if (options?.allowMetadata === false && value.metadata !== undefined) {
-    throw new TypeError("RGBA payload.metadata is not allowed for this validation mode.");
-  }
-  return value;
-}
-function validateTexturePayload(payload) {
-  const value = assertObject(payload, "Texture payload");
-  assertPayloadType(value, ResourcePayloadType.TEXTURE, "Texture payload");
-  assertDimensions(value, "Texture payload");
-  assertEnum(value.dimension, ResourcePayloadValues.textureDimensions, "Texture payload.dimension");
-  assertString(value.pixelFormat, "Texture payload.pixelFormat");
-  if (typeof value.isCompressed !== "boolean") {
-    throw new TypeError("Texture payload.isCompressed must be boolean.");
-  }
-  assertPositiveInteger(value.mipCount, "Texture payload.mipCount");
-  assertPositiveInteger(value.arraySize, "Texture payload.arraySize");
-  assertBytes(value.data, "Texture payload.data");
-  if (!Array.isArray(value.subresources) || value.subresources.length === 0) {
-    throw new TypeError("Texture payload.subresources must be a non-empty array.");
-  }
-  for (const [index, subresource] of value.subresources.entries()) {
-    validateTextureSubresource(subresource, index, value.data.byteLength);
-  }
-  return value;
-}
-function validateAudioPayload(payload) {
-  const value = assertObject(payload, "Audio payload");
-  if (![ResourcePayloadType.AUDIO, ResourcePayloadType.PCM].includes(value.payloadType)) {
-    throw new TypeError("Audio payload.payloadType must be \"audio\" or \"pcm\".");
-  }
-  assertPositiveInteger(value.sampleRate, "Audio payload.sampleRate");
-  assertPositiveInteger(value.channels, "Audio payload.channels");
-  assertPositiveOrZeroInteger(value.frameCount, "Audio payload.frameCount");
-  assertString(value.sampleFormat, "Audio payload.sampleFormat");
-  assertBytesOrTypedArray(value.data, "Audio payload.data");
-  assertPositiveOrZeroNumber(value.durationSeconds, "Audio payload.durationSeconds");
-  return value;
-}
-function validateVideoPayload(payload) {
-  const value = assertObject(payload, "Video payload");
-  assertPayloadType(value, ResourcePayloadType.VIDEO, "Video payload");
-  assertString(value.sourceFormat, "Video payload.sourceFormat");
-  assertPositiveInteger(value.durationTimescale, "Video payload.durationTimescale");
-  assertPositiveOrZeroInteger(value.duration, "Video payload.duration");
-  if (!Array.isArray(value.tracks)) {
-    throw new TypeError("Video payload.tracks must be an array.");
-  }
-  return value;
-}
-function validateTextureSubresource(value, index, dataByteLength) {
-  const prefix = `Texture payload.subresources[${index}]`;
-  assertObject(value, prefix);
-  assertPositiveOrZeroInteger(value.mip, `${prefix}.mip`);
-  assertPositiveOrZeroInteger(value.layer, `${prefix}.layer`);
-  assertPositiveOrZeroInteger(value.offset, `${prefix}.offset`);
-  assertPositiveInteger(value.byteLength, `${prefix}.byteLength`);
-  assertPositiveOrZeroInteger(value.width, `${prefix}.width`);
-  assertPositiveOrZeroInteger(value.height, `${prefix}.height`);
-  assertPositiveOrZeroInteger(value.rowPitch, `${prefix}.rowPitch`);
-  assertPositiveOrZeroInteger(value.slicePitch, `${prefix}.slicePitch`);
-  if (value.offset + value.byteLength > dataByteLength) {
-    throw new RangeError(`${prefix} exceeds Texture payload.data.`);
-  }
-}
-function assertObject(value, label) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    throw new TypeError(`${label} must be an object.`);
-  }
-  return value;
-}
-function assertPayloadType(value, expected, label) {
-  if (value.payloadType !== expected) {
-    throw new TypeError(`${label}.payloadType must be \"${expected}\".`);
-  }
-}
-function assertDimensions(value, label) {
-  assertPositiveInteger(value.width, `${label}.width`);
-  assertPositiveInteger(value.height, `${label}.height`);
-}
-function assertBytes(value, label) {
-  if (!(value instanceof Uint8Array)) {
-    throw new TypeError(`${label} must be a Uint8Array.`);
-  }
-}
-function assertBytesOrTypedArray(value, label) {
-  if (!ArrayBuffer.isView(value) || value instanceof DataView) {
-    throw new TypeError(`${label} must be a typed array.`);
-  }
-}
-function assertString(value, label) {
-  if (typeof value !== "string" || value.length === 0) {
-    throw new TypeError(`${label} must be a non-empty string.`);
-  }
-}
-function assertEnum(value, allowed, label) {
-  if (!allowed.includes(value)) {
-    throw new TypeError(`${label} must be one of: ${allowed.join(", ")}.`);
-  }
-}
-function assertPositiveInteger(value, label) {
-  if (!Number.isSafeInteger(value) || value <= 0) {
-    throw new TypeError(`${label} must be a positive safe integer.`);
-  }
-}
-function assertPositiveOrZeroInteger(value, label) {
-  if (!Number.isSafeInteger(value) || value < 0) {
-    throw new TypeError(`${label} must be a non-negative safe integer.`);
-  }
-}
-function assertPositiveOrZeroNumber(value, label) {
-  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
-    throw new TypeError(`${label} must be a non-negative finite number.`);
-  }
-}
-
-export { ResourcePayloadType, ResourcePayloadValues, validateAudioPayload, validateRgbaPayload, validateTexturePayload, validateVideoPayload };
-//# sourceMappingURL=payloadContract.js.map
+/**
+ * Canonical semantic payload vocabulary shared by runtime-resource adapters
+ * and pure format readers.
+ *
+ * Format packages may return plain objects matching these shapes without
+ * importing runtime-resource. These validators are runtime-side guardrails;
+ * they are not file decoders or GPU capability checks.
+ */
+
+const ResourcePayloadType = Object.freeze({
+  RGBA: "rgba",
+  TEXTURE: "texture",
+  AUDIO: "audio",
+  PCM: "pcm",
+  VIDEO: "video"
+});
+const ResourcePayloadValues = Object.freeze({
+  imageOrigins: Object.freeze(["top-left"]),
+  colorSpaces: Object.freeze(["srgb", "linear", "unknown"]),
+  alphaModes: Object.freeze(["straight", "premultiplied", "opaque", "unknown"]),
+  textureDimensions: Object.freeze(["2d", "cube", "3d", "array"])
+});
+function validateRgbaPayload(payload, options = null) {
+  const value = assertObject(payload, "RGBA payload");
+  assertPayloadType(value, ResourcePayloadType.RGBA, "RGBA payload");
+  assertDimensions(value, "RGBA payload");
+  assertString(value.pixelFormat, "RGBA payload.pixelFormat");
+  const layout = {
+    rgba8unorm: {
+      bytesPerPixel: 4,
+      arrayType: Uint8Array
+    },
+    rgba32float: {
+      bytesPerPixel: 16,
+      arrayType: Float32Array
+    }
+  }[value.pixelFormat];
+  if (!layout) {
+    throw new TypeError("RGBA payload.pixelFormat must be \"rgba8unorm\" or \"rgba32float\".");
+  }
+  if (!(value.data instanceof layout.arrayType)) {
+    throw new TypeError(`RGBA payload.data must be a ${layout.arrayType.name}.`);
+  }
+  assertPositiveOrZeroInteger(value.strideBytes, "RGBA payload.strideBytes");
+  if (value.strideBytes < value.width * layout.bytesPerPixel) {
+    throw new RangeError("RGBA payload.strideBytes is smaller than one RGBA row.");
+  }
+  if (value.data.byteLength < value.strideBytes * value.height) {
+    throw new RangeError("RGBA payload.data is shorter than the declared image rows.");
+  }
+  if (value.strideBytes % value.data.BYTES_PER_ELEMENT !== 0) {
+    throw new RangeError("RGBA payload.strideBytes must align to its typed-array elements.");
+  }
+  assertEnum(value.origin, ResourcePayloadValues.imageOrigins, "RGBA payload.origin");
+  assertEnum(value.colorSpace, ResourcePayloadValues.colorSpaces, "RGBA payload.colorSpace");
+  assertEnum(value.alphaMode, ResourcePayloadValues.alphaModes, "RGBA payload.alphaMode");
+  if (options?.allowMetadata === false && value.metadata !== undefined) {
+    throw new TypeError("RGBA payload.metadata is not allowed for this validation mode.");
+  }
+  return value;
+}
+function validateTexturePayload(payload) {
+  const value = assertObject(payload, "Texture payload");
+  assertPayloadType(value, ResourcePayloadType.TEXTURE, "Texture payload");
+  assertDimensions(value, "Texture payload");
+  assertEnum(value.dimension, ResourcePayloadValues.textureDimensions, "Texture payload.dimension");
+  assertString(value.pixelFormat, "Texture payload.pixelFormat");
+  if (typeof value.isCompressed !== "boolean") {
+    throw new TypeError("Texture payload.isCompressed must be boolean.");
+  }
+  assertPositiveInteger(value.mipCount, "Texture payload.mipCount");
+  assertPositiveInteger(value.arraySize, "Texture payload.arraySize");
+  assertBytes(value.data, "Texture payload.data");
+  if (!Array.isArray(value.subresources) || value.subresources.length === 0) {
+    throw new TypeError("Texture payload.subresources must be a non-empty array.");
+  }
+  for (const [index, subresource] of value.subresources.entries()) {
+    validateTextureSubresource(subresource, index, value.data.byteLength);
+  }
+  return value;
+}
+function validateAudioPayload(payload) {
+  const value = assertObject(payload, "Audio payload");
+  if (![ResourcePayloadType.AUDIO, ResourcePayloadType.PCM].includes(value.payloadType)) {
+    throw new TypeError("Audio payload.payloadType must be \"audio\" or \"pcm\".");
+  }
+  assertPositiveInteger(value.sampleRate, "Audio payload.sampleRate");
+  assertPositiveInteger(value.channels, "Audio payload.channels");
+  assertPositiveOrZeroInteger(value.frameCount, "Audio payload.frameCount");
+  assertString(value.sampleFormat, "Audio payload.sampleFormat");
+  assertBytesOrTypedArray(value.data, "Audio payload.data");
+  assertPositiveOrZeroNumber(value.durationSeconds, "Audio payload.durationSeconds");
+  return value;
+}
+function validateVideoPayload(payload) {
+  const value = assertObject(payload, "Video payload");
+  assertPayloadType(value, ResourcePayloadType.VIDEO, "Video payload");
+  assertString(value.sourceFormat, "Video payload.sourceFormat");
+  assertPositiveInteger(value.durationTimescale, "Video payload.durationTimescale");
+  assertPositiveOrZeroInteger(value.duration, "Video payload.duration");
+  if (!Array.isArray(value.tracks)) {
+    throw new TypeError("Video payload.tracks must be an array.");
+  }
+  return value;
+}
+function validateTextureSubresource(value, index, dataByteLength) {
+  const prefix = `Texture payload.subresources[${index}]`;
+  assertObject(value, prefix);
+  assertPositiveOrZeroInteger(value.mip, `${prefix}.mip`);
+  assertPositiveOrZeroInteger(value.layer, `${prefix}.layer`);
+  assertPositiveOrZeroInteger(value.offset, `${prefix}.offset`);
+  assertPositiveInteger(value.byteLength, `${prefix}.byteLength`);
+  assertPositiveOrZeroInteger(value.width, `${prefix}.width`);
+  assertPositiveOrZeroInteger(value.height, `${prefix}.height`);
+  assertPositiveOrZeroInteger(value.rowPitch, `${prefix}.rowPitch`);
+  assertPositiveOrZeroInteger(value.slicePitch, `${prefix}.slicePitch`);
+  if (value.offset + value.byteLength > dataByteLength) {
+    throw new RangeError(`${prefix} exceeds Texture payload.data.`);
+  }
+}
+function assertObject(value, label) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new TypeError(`${label} must be an object.`);
+  }
+  return value;
+}
+function assertPayloadType(value, expected, label) {
+  if (value.payloadType !== expected) {
+    throw new TypeError(`${label}.payloadType must be \"${expected}\".`);
+  }
+}
+function assertDimensions(value, label) {
+  assertPositiveInteger(value.width, `${label}.width`);
+  assertPositiveInteger(value.height, `${label}.height`);
+}
+function assertBytes(value, label) {
+  if (!(value instanceof Uint8Array)) {
+    throw new TypeError(`${label} must be a Uint8Array.`);
+  }
+}
+function assertBytesOrTypedArray(value, label) {
+  if (!ArrayBuffer.isView(value) || value instanceof DataView) {
+    throw new TypeError(`${label} must be a typed array.`);
+  }
+}
+function assertString(value, label) {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new TypeError(`${label} must be a non-empty string.`);
+  }
+}
+function assertEnum(value, allowed, label) {
+  if (!allowed.includes(value)) {
+    throw new TypeError(`${label} must be one of: ${allowed.join(", ")}.`);
+  }
+}
+function assertPositiveInteger(value, label) {
+  if (!Number.isSafeInteger(value) || value <= 0) {
+    throw new TypeError(`${label} must be a positive safe integer.`);
+  }
+}
+function assertPositiveOrZeroInteger(value, label) {
+  if (!Number.isSafeInteger(value) || value < 0) {
+    throw new TypeError(`${label} must be a non-negative safe integer.`);
+  }
+}
+function assertPositiveOrZeroNumber(value, label) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+    throw new TypeError(`${label} must be a non-negative finite number.`);
+  }
+}
+
+export { ResourcePayloadType, ResourcePayloadValues, validateAudioPayload, validateRgbaPayload, validateTexturePayload, validateVideoPayload };
+//# sourceMappingURL=payloadContract.js.map