@carbonenginejs/runtime-resource 0.13.0 → 0.15.0

package/dist/format/effect/sha256.js

@@ -1,114 +1,114 @@
-const SHA256_CONSTANTS = Object.freeze([0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5, 0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174, 0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da, 0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967, 0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85, 0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070, 0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3, 0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2]);
-
-/**
- * Rotate one unsigned 32-bit word right.
- *
- * @param {number} value Unsigned word.
- * @param {number} shift Bit count.
- * @returns {number} Rotated word.
- */
-function rotateRight(value, shift) {
-  return value >>> shift | value << 32 - shift;
-}
-
-/**
- * Normalize an exact byte range without copying it.
- *
- * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Candidate byte range.
- * @returns {Uint8Array} Exact byte view.
- */
-function normalizeBytes(input) {
-  if (input instanceof Uint8Array) {
-    return input;
-  }
-  if (input instanceof ArrayBuffer) {
-    return new Uint8Array(input);
-  }
-  if (ArrayBuffer.isView(input)) {
-    return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
-  }
-  throw new TypeError("SHA-256 input must be Uint8Array, ArrayBuffer, or ArrayBufferView bytes");
-}
-
-/**
- * Browser-safe synchronous SHA-256 over an exact byte view.
- *
- * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Bytes to hash.
- * @returns {string} Lower-case hexadecimal digest.
- */
-function sha256Bytes(input) {
-  const inputBytes = normalizeBytes(input);
-  const paddedLength = Math.ceil((inputBytes.length + 9) / 64) * 64;
-  const bytes = new Uint8Array(paddedLength);
-  bytes.set(inputBytes);
-  bytes[inputBytes.length] = 0x80;
-  let bitLength = BigInt(inputBytes.length) * 8n;
-  for (let index = 0; index < 8; index += 1) {
-    bytes[paddedLength - 1 - index] = Number(bitLength & 0xffn);
-    bitLength >>= 8n;
-  }
-  const hash = new Uint32Array([0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a, 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19]);
-  const schedule = new Uint32Array(64);
-  for (let offset = 0; offset < bytes.length; offset += 64) {
-    for (let index = 0; index < 16; index += 1) {
-      const word = offset + index * 4;
-      schedule[index] = bytes[word] * 0x1000000 + bytes[word + 1] * 0x10000 + bytes[word + 2] * 0x100 + bytes[word + 3] >>> 0;
-    }
-    for (let index = 16; index < 64; index += 1) {
-      const left = schedule[index - 15];
-      const right = schedule[index - 2];
-      const sigma0 = rotateRight(left, 7) ^ rotateRight(left, 18) ^ left >>> 3;
-      const sigma1 = rotateRight(right, 17) ^ rotateRight(right, 19) ^ right >>> 10;
-      schedule[index] = schedule[index - 16] + sigma0 + schedule[index - 7] + sigma1 >>> 0;
-    }
-    let a = hash[0];
-    let b = hash[1];
-    let c = hash[2];
-    let d = hash[3];
-    let e = hash[4];
-    let f = hash[5];
-    let g = hash[6];
-    let h = hash[7];
-    for (let index = 0; index < 64; index += 1) {
-      const sum1 = rotateRight(e, 6) ^ rotateRight(e, 11) ^ rotateRight(e, 25);
-      const choose = e & f ^ ~e & g;
-      const temporary1 = h + sum1 + choose + SHA256_CONSTANTS[index] + schedule[index] >>> 0;
-      const sum0 = rotateRight(a, 2) ^ rotateRight(a, 13) ^ rotateRight(a, 22);
-      const majority = a & b ^ a & c ^ b & c;
-      const temporary2 = sum0 + majority >>> 0;
-      h = g;
-      g = f;
-      f = e;
-      e = d + temporary1 >>> 0;
-      d = c;
-      c = b;
-      b = a;
-      a = temporary1 + temporary2 >>> 0;
-    }
-    hash[0] = hash[0] + a >>> 0;
-    hash[1] = hash[1] + b >>> 0;
-    hash[2] = hash[2] + c >>> 0;
-    hash[3] = hash[3] + d >>> 0;
-    hash[4] = hash[4] + e >>> 0;
-    hash[5] = hash[5] + f >>> 0;
-    hash[6] = hash[6] + g >>> 0;
-    hash[7] = hash[7] + h >>> 0;
-  }
-  return Array.from(hash, word => word.toString(16).padStart(8, "0")).join("");
-}
-
-/**
- * Browser-safe synchronous SHA-256 for a UTF-8 string.
- *
- * @param {string} text UTF-16 JavaScript string encoded as UTF-8.
- * @returns {string} Lower-case hexadecimal digest.
- */
-function sha256Utf8(text) {
-  if (typeof text !== "string") {
-    throw new TypeError("SHA-256 input must be a string");
-  }
-  return sha256Bytes(new TextEncoder().encode(text));
-}
-
-export { sha256Bytes, sha256Utf8 };
-//# sourceMappingURL=sha256.js.map
+const SHA256_CONSTANTS = Object.freeze([0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5, 0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174, 0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da, 0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967, 0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85, 0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070, 0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3, 0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2]);
+
+/**
+ * Rotate one unsigned 32-bit word right.
+ *
+ * @param {number} value Unsigned word.
+ * @param {number} shift Bit count.
+ * @returns {number} Rotated word.
+ */
+function rotateRight(value, shift) {
+  return value >>> shift | value << 32 - shift;
+}
+
+/**
+ * Normalize an exact byte range without copying it.
+ *
+ * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Candidate byte range.
+ * @returns {Uint8Array} Exact byte view.
+ */
+function normalizeBytes(input) {
+  if (input instanceof Uint8Array) {
+    return input;
+  }
+  if (input instanceof ArrayBuffer) {
+    return new Uint8Array(input);
+  }
+  if (ArrayBuffer.isView(input)) {
+    return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
+  }
+  throw new TypeError("SHA-256 input must be Uint8Array, ArrayBuffer, or ArrayBufferView bytes");
+}
+
+/**
+ * Browser-safe synchronous SHA-256 over an exact byte view.
+ *
+ * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Bytes to hash.
+ * @returns {string} Lower-case hexadecimal digest.
+ */
+function sha256Bytes(input) {
+  const inputBytes = normalizeBytes(input);
+  const paddedLength = Math.ceil((inputBytes.length + 9) / 64) * 64;
+  const bytes = new Uint8Array(paddedLength);
+  bytes.set(inputBytes);
+  bytes[inputBytes.length] = 0x80;
+  let bitLength = BigInt(inputBytes.length) * 8n;
+  for (let index = 0; index < 8; index += 1) {
+    bytes[paddedLength - 1 - index] = Number(bitLength & 0xffn);
+    bitLength >>= 8n;
+  }
+  const hash = new Uint32Array([0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a, 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19]);
+  const schedule = new Uint32Array(64);
+  for (let offset = 0; offset < bytes.length; offset += 64) {
+    for (let index = 0; index < 16; index += 1) {
+      const word = offset + index * 4;
+      schedule[index] = bytes[word] * 0x1000000 + bytes[word + 1] * 0x10000 + bytes[word + 2] * 0x100 + bytes[word + 3] >>> 0;
+    }
+    for (let index = 16; index < 64; index += 1) {
+      const left = schedule[index - 15];
+      const right = schedule[index - 2];
+      const sigma0 = rotateRight(left, 7) ^ rotateRight(left, 18) ^ left >>> 3;
+      const sigma1 = rotateRight(right, 17) ^ rotateRight(right, 19) ^ right >>> 10;
+      schedule[index] = schedule[index - 16] + sigma0 + schedule[index - 7] + sigma1 >>> 0;
+    }
+    let a = hash[0];
+    let b = hash[1];
+    let c = hash[2];
+    let d = hash[3];
+    let e = hash[4];
+    let f = hash[5];
+    let g = hash[6];
+    let h = hash[7];
+    for (let index = 0; index < 64; index += 1) {
+      const sum1 = rotateRight(e, 6) ^ rotateRight(e, 11) ^ rotateRight(e, 25);
+      const choose = e & f ^ ~e & g;
+      const temporary1 = h + sum1 + choose + SHA256_CONSTANTS[index] + schedule[index] >>> 0;
+      const sum0 = rotateRight(a, 2) ^ rotateRight(a, 13) ^ rotateRight(a, 22);
+      const majority = a & b ^ a & c ^ b & c;
+      const temporary2 = sum0 + majority >>> 0;
+      h = g;
+      g = f;
+      f = e;
+      e = d + temporary1 >>> 0;
+      d = c;
+      c = b;
+      b = a;
+      a = temporary1 + temporary2 >>> 0;
+    }
+    hash[0] = hash[0] + a >>> 0;
+    hash[1] = hash[1] + b >>> 0;
+    hash[2] = hash[2] + c >>> 0;
+    hash[3] = hash[3] + d >>> 0;
+    hash[4] = hash[4] + e >>> 0;
+    hash[5] = hash[5] + f >>> 0;
+    hash[6] = hash[6] + g >>> 0;
+    hash[7] = hash[7] + h >>> 0;
+  }
+  return Array.from(hash, word => word.toString(16).padStart(8, "0")).join("");
+}
+
+/**
+ * Browser-safe synchronous SHA-256 for a UTF-8 string.
+ *
+ * @param {string} text UTF-16 JavaScript string encoded as UTF-8.
+ * @returns {string} Lower-case hexadecimal digest.
+ */
+function sha256Utf8(text) {
+  if (typeof text !== "string") {
+    throw new TypeError("SHA-256 input must be a string");
+  }
+  return sha256Bytes(new TextEncoder().encode(text));
+}
+
+export { sha256Bytes, sha256Utf8 };
+//# sourceMappingURL=sha256.js.map

package/dist/format/index.js

@@ -1,11 +1,11 @@
-export { CjsReader } from './CjsReader.js';
-export { CjsFormatReadError, CjsFormatWriteError } from './CjsFormatError.js';
-export { CjsByteReader } from './CjsByteReader.js';
-export { CjsByteWriter } from './CjsByteWriter.js';
-export { CJS_STRING_TABLE_NULL_REFERENCE, CjsStringTable, compareTableBlobs } from './CjsStringTable.js';
-export { CARBON_ANNOTATION_TYPE, CARBON_EFFECT_COUNT_CAPS, CARBON_EFFECT_DATA_VERSION, CARBON_EFFECT_MIN_DATA_VERSION, CARBON_SHADER_CONSTANTS_MAX, collectArena, compareAnnotationNames, internArena, passthroughArena, readEffectDescription, writeEffectDescription } from './carbonEffect/carbonEffectRecords.js';
-export { CARBON_BACKEND_RESOURCE_KIND, CARBON_BACKEND_VISIBILITY, CARBON_EFFECT_BACKEND_BLOCK_VERSION, readBackendBlock, writeBackendBlock } from './carbonEffect/carbonEffectBackendBlock.js';
-export { CARBON_EFFECT_RECORD_BYTES, CARBON_EFFECT_SOURCE_HASH_BYTES, CjsCarbonEffectBodyReader, CjsCarbonEffectReader, looksLikeCarbonEffectContainer } from './carbonEffect/CjsCarbonEffectReader.js';
-export { CjsCarbonEffectWriter, writeCarbonEffectFile } from './carbonEffect/CjsCarbonEffectWriter.js';
-export { CARBON_BACKEND_TRANSFORM_FAMILY, DETAIL_MAP_ARRAY_DEFAULTS } from './carbonEffect/carbonEffectResourceTransform.js';
-//# sourceMappingURL=index.js.map
+export { CjsReader } from './CjsReader.js';
+export { CjsFormatReadError, CjsFormatWriteError } from './CjsFormatError.js';
+export { CjsByteReader } from './CjsByteReader.js';
+export { CjsByteWriter } from './CjsByteWriter.js';
+export { CJS_STRING_TABLE_NULL_REFERENCE, CjsStringTable, compareTableBlobs } from './CjsStringTable.js';
+export { CARBON_ANNOTATION_TYPE, CARBON_EFFECT_COUNT_CAPS, CARBON_EFFECT_DATA_VERSION, CARBON_EFFECT_MIN_DATA_VERSION, CARBON_SHADER_CONSTANTS_MAX, collectArena, compareAnnotationNames, internArena, passthroughArena, readEffectDescription, writeEffectDescription } from './carbonEffect/carbonEffectRecords.js';
+export { CARBON_BACKEND_RESOURCE_KIND, CARBON_BACKEND_VISIBILITY, CARBON_EFFECT_BACKEND_BLOCK_VERSION, readBackendBlock, writeBackendBlock } from './carbonEffect/carbonEffectBackendBlock.js';
+export { CARBON_EFFECT_RECORD_BYTES, CARBON_EFFECT_SOURCE_HASH_BYTES, CjsCarbonEffectBodyReader, CjsCarbonEffectReader, looksLikeCarbonEffectContainer } from './carbonEffect/CjsCarbonEffectReader.js';
+export { CjsCarbonEffectWriter, writeCarbonEffectFile } from './carbonEffect/CjsCarbonEffectWriter.js';
+export { CARBON_BACKEND_TRANSFORM_FAMILY, DETAIL_MAP_ARRAY_DEFAULTS } from './carbonEffect/carbonEffectResourceTransform.js';
+//# sourceMappingURL=index.js.map

package/dist/format/payloadContract.js

@@ -1,193 +1,193 @@
-/**
- * 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"])
-});
-
-/**
- * Validates dimensions, stride, and byte storage for a decoded RGBA payload for
- * the resource payload contract.
- */
-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;
-}
-
-/**
- * Validates the discriminated fields required by a texture payload for the
- * resource payload contract.
- */
-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;
-}
-
-/**
- * Validates the discriminated fields required by an audio payload for the
- * resource payload contract.
- */
-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;
-}
-
-/**
- * Validates the discriminated fields required by a video payload for the
- * resource payload contract.
- */
-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"])
+});
+
+/**
+ * Validates dimensions, stride, and byte storage for a decoded RGBA payload for
+ * the resource payload contract.
+ */
+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;
+}
+
+/**
+ * Validates the discriminated fields required by a texture payload for the
+ * resource payload contract.
+ */
+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;
+}
+
+/**
+ * Validates the discriminated fields required by an audio payload for the
+ * resource payload contract.
+ */
+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;
+}
+
+/**
+ * Validates the discriminated fields required by a video payload for the
+ * resource payload contract.
+ */
+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