@carbonenginejs/runtime-resource 0.1.0 → 0.7.0

package/dist/resources/texturePipelineBehavior.js

@@ -0,0 +1,320 @@
+import { validateRgbaPayload } from '../format/payloadContract.js';
+import { PixelFormat as PixelFormat$1 } from '@carbonenginejs/runtime-const/graphics';
+import { PixelFormat } from '@carbonenginejs/runtime-const/render-context';
+
+// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipeline.cpp
+// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepLoad.cpp
+// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepLimitSize.cpp
+// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepCompress.cpp
+// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepPack.cpp
+const STEP_LOAD = "Tr2TexturePipelineStepLoad";
+const STEP_LIMIT_SIZE = "Tr2TexturePipelineStepLimitSize";
+const STEP_COMPRESS = "Tr2TexturePipelineStepCompress";
+const STEP_PACK = "Tr2TexturePipelineStepPack";
+const PACK_FORMATS = new Set([PixelFormat.PIXEL_FORMAT_R8_UNORM, PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM, PixelFormat.PIXEL_FORMAT_B8G8R8X8_UNORM]);
+
+/**
+ * Collect Carbon texture-pipeline dependencies in std::set-equivalent order.
+ *
+ * @param {object[]} steps Pipeline steps.
+ * @returns {string[]} Sorted unique resource paths.
+ */
+function GetTexturePipelineDependencies(steps) {
+  const dependencies = new Set();
+  for (const step of AssertSteps(steps)) {
+    const name = StepName(step);
+    if (name === STEP_LOAD) {
+      AddDependency(dependencies, step.path);
+    } else if (name === STEP_PACK) {
+      AddDependency(dependencies, step.r?.path);
+      AddDependency(dependencies, step.g?.path);
+      AddDependency(dependencies, step.b?.path);
+      AddDependency(dependencies, step.a?.path);
+    }
+  }
+  return [...dependencies].sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
+}
+
+/**
+ * Execute the maintained JavaScript form of Carbon's CPU bitmap pipeline.
+ *
+ * @param {object[]} steps Pipeline steps.
+ * @param {{maxWidth:number,maxHeight:number}} params Caller size limits.
+ * @param {object|null} options Input resolution options.
+ * @returns {Promise<object>} Canonical RGBA payload.
+ */
+async function ExecuteTexturePipeline(steps, params, options = null) {
+  const list = AssertSteps(steps);
+  if (!list.length) {
+    throw PipelineError("CJS_TEXTURE_PIPELINE_NO_STEPS", "Tr2TexturePipeline has no steps.");
+  }
+  const limits = {
+    maxWidth: AssertLimit(params?.maxWidth, "maxWidth"),
+    maxHeight: AssertLimit(params?.maxHeight, "maxHeight")
+  };
+  const settings = NormalizeOptions(options);
+  const inputs = new Map();
+  for (const path of GetTexturePipelineDependencies(list)) {
+    inputs.set(path, await ResolveInput(path, settings));
+  }
+  let bitmap = null;
+  for (const step of list) {
+    const name = StepName(step);
+    if (name === STEP_LOAD) {
+      bitmap = CloneBitmap(RequireInput(inputs, step.path));
+    } else if (name === STEP_LIMIT_SIZE) {
+      bitmap = LimitBitmap(RequireBitmap(bitmap), CombineLimits(step, limits));
+    } else if (name === STEP_COMPRESS) {
+      // Carbon's current implementation validates the bitmap and otherwise
+      // performs no compression work.
+      RequireBitmap(bitmap);
+    } else if (name === STEP_PACK) {
+      bitmap = PackBitmap(step, inputs);
+    } else {
+      throw PipelineError("CJS_TEXTURE_PIPELINE_STEP_UNSUPPORTED", `Unsupported texture pipeline step: ${name || "unknown"}.`);
+    }
+  }
+  bitmap = LimitBitmap(RequireBitmap(bitmap), limits);
+  return ToPayload(bitmap);
+}
+function AssertSteps(steps) {
+  if (!Array.isArray(steps)) {
+    throw new TypeError("Tr2TexturePipeline.steps must be an array.");
+  }
+  return steps;
+}
+function AssertLimit(value, name) {
+  if (!Number.isSafeInteger(value) || value < 0) {
+    throw new TypeError(`Tr2TexturePipeline ${name} must be a non-negative safe integer.`);
+  }
+  return value;
+}
+function NormalizeOptions(options) {
+  if (options === null || options === undefined) {
+    return {};
+  }
+  if (!options || typeof options !== "object" || Array.isArray(options)) {
+    throw new TypeError("Tr2TexturePipeline options must be an object or null.");
+  }
+  if (options.load !== undefined && typeof options.load !== "function") {
+    throw new TypeError("Tr2TexturePipeline options.load must be a function.");
+  }
+  if (options.resMan !== undefined && typeof options.resMan?.GetObject !== "function") {
+    throw new TypeError("Tr2TexturePipeline options.resMan must provide GetObject().");
+  }
+  return options;
+}
+async function ResolveInput(path, options) {
+  let value;
+  if (options.inputs instanceof Map) {
+    value = options.inputs.get(path);
+  } else if (options.inputs && typeof options.inputs === "object") {
+    value = options.inputs[path];
+  }
+  if (value === undefined && options.load) {
+    value = await options.load(path);
+  }
+  if (value === undefined && options.resMan) {
+    value = await options.resMan.GetObject(path, {
+      ...(options.resourceOptions || {}),
+      requirement: "image",
+      emit: "rgba"
+    });
+  }
+  if (value === undefined) {
+    throw PipelineError("CJS_TEXTURE_PIPELINE_INPUT_MISSING", `No texture pipeline input was provided for ${path}.`);
+  }
+  const payload = typeof value?.GetPayload === "function" ? value.GetPayload() : value;
+  validateRgbaPayload(payload);
+  if (payload.pixelFormat !== PixelFormat$1.RGBA8_UNORM) {
+    throw PipelineError("CJS_TEXTURE_PIPELINE_FORMAT_UNSUPPORTED", `Texture pipeline input ${path} must use rgba8unorm.`);
+  }
+  return FromPayload(payload);
+}
+function FromPayload(payload) {
+  const data = new Uint8Array(payload.width * payload.height * 4);
+  for (let y = 0; y < payload.height; y++) {
+    const sourceOffset = y * payload.strideBytes;
+    const targetOffset = y * payload.width * 4;
+    data.set(payload.data.subarray(sourceOffset, sourceOffset + payload.width * 4), targetOffset);
+  }
+  return {
+    width: payload.width,
+    height: payload.height,
+    data,
+    sourceFormat: payload.sourceFormat || "rgba",
+    colorSpace: payload.colorSpace,
+    alphaMode: payload.alphaMode,
+    metadata: payload.metadata || null
+  };
+}
+function ToPayload(bitmap) {
+  return {
+    payloadType: "rgba",
+    sourceFormat: bitmap.sourceFormat || "texture-pipeline",
+    width: bitmap.width,
+    height: bitmap.height,
+    pixelFormat: PixelFormat$1.RGBA8_UNORM,
+    data: bitmap.data,
+    strideBytes: bitmap.width * 4,
+    origin: "top-left",
+    colorSpace: bitmap.colorSpace || "unknown",
+    alphaMode: bitmap.alphaMode || "unknown",
+    ...(bitmap.metadata ? {
+      metadata: bitmap.metadata
+    } : {})
+  };
+}
+function CloneBitmap(bitmap) {
+  return {
+    ...bitmap,
+    data: new Uint8Array(bitmap.data),
+    metadata: bitmap.metadata && typeof bitmap.metadata === "object" ? {
+      ...bitmap.metadata
+    } : bitmap.metadata
+  };
+}
+function CombineLimits(step, params) {
+  return {
+    maxWidth: TightestLimit(AssertLimit(step.maxWidth ?? 0, "step.maxWidth"), params.maxWidth),
+    maxHeight: TightestLimit(AssertLimit(step.maxHeight ?? 0, "step.maxHeight"), params.maxHeight)
+  };
+}
+function TightestLimit(first, second) {
+  if (!first) return second;
+  if (!second) return first;
+  return Math.min(first, second);
+}
+function LimitBitmap(bitmap, limits) {
+  let result = bitmap;
+  while (limits.maxWidth && result.width > limits.maxWidth || limits.maxHeight && result.height > limits.maxHeight) {
+    result = Downsample2x2(result);
+  }
+  return result;
+}
+function Downsample2x2(bitmap) {
+  const width = Math.max(1, Math.floor(bitmap.width / 2));
+  const height = Math.max(1, Math.floor(bitmap.height / 2));
+  const data = new Uint8Array(width * height * 4);
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      const counts = [0, 0, 0, 0];
+      let samples = 0;
+      for (let oy = 0; oy < 2; oy++) {
+        for (let ox = 0; ox < 2; ox++) {
+          const sourceX = Math.min(bitmap.width - 1, x * 2 + ox);
+          const sourceY = Math.min(bitmap.height - 1, y * 2 + oy);
+          const source = (sourceY * bitmap.width + sourceX) * 4;
+          for (let channel = 0; channel < 4; channel++) {
+            counts[channel] += bitmap.data[source + channel];
+          }
+          samples++;
+        }
+      }
+      const target = (y * width + x) * 4;
+      for (let channel = 0; channel < 4; channel++) {
+        data[target + channel] = Math.round(counts[channel] / samples);
+      }
+    }
+  }
+  return {
+    ...bitmap,
+    width,
+    height,
+    data
+  };
+}
+function PackBitmap(step, inputs) {
+  // The generated schema records the enum's zero value, while Carbon's
+  // constructor initializes this step to B8G8R8A8_UNORM.
+  const format = step.format === PixelFormat.PIXEL_FORMAT_UNKNOWN ? PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM : step.format;
+  if (!PACK_FORMATS.has(format)) {
+    throw PipelineError("CJS_TEXTURE_PIPELINE_FORMAT_UNSUPPORTED", `Unsupported Carbon pack pixel format: ${String(format)}.`);
+  }
+  const descriptors = [step.r, step.g, step.b, step.a];
+  const sources = descriptors.map(channel => channel?.path ? RequireInput(inputs, channel.path) : null);
+  const first = sources.find(Boolean);
+  const width = first?.width || 4;
+  const height = first?.height || 4;
+  for (const source of sources) {
+    if (source && (source.width !== width || source.height !== height)) {
+      throw PipelineError("CJS_TEXTURE_PIPELINE_SIZE_MISMATCH", "Texture pipeline pack inputs must have identical dimensions.");
+    }
+  }
+  const data = new Uint8Array(width * height * 4);
+  const isR8 = format === PixelFormat.PIXEL_FORMAT_R8_UNORM;
+  const isX8 = format === PixelFormat.PIXEL_FORMAT_B8G8R8X8_UNORM;
+  for (let pixel = 0; pixel < width * height; pixel++) {
+    const values = descriptors.map((channel, index) => ReadPackChannel(sources[index], channel, pixel));
+    const target = pixel * 4;
+    if (isR8) {
+      data[target] = values[0];
+      data[target + 3] = 255;
+    } else {
+      data[target] = values[0];
+      data[target + 1] = values[1];
+      data[target + 2] = values[2];
+      data[target + 3] = isX8 ? 255 : values[3];
+    }
+  }
+  return {
+    width,
+    height,
+    data,
+    sourceFormat: "texture-pipeline",
+    colorSpace: first?.colorSpace || "unknown",
+    alphaMode: isX8 || isR8 ? "opaque" : "unknown",
+    metadata: {
+      carbonPixelFormat: format
+    }
+  };
+}
+function ReadPackChannel(source, descriptor, pixel) {
+  if (!source) {
+    return AssertByte(descriptor?.fill ?? 0, "fill");
+  }
+  const channel = AssertByte(descriptor?.channel ?? 0, "channel");
+  if (channel > 3) {
+    throw new RangeError("Tr2TexturePackChannel.channel must be between 0 and 3.");
+  }
+  // Carbon's exposed chooser encodes RED=2 and BLUE=0 for BGRA host
+  // bitmaps. Translate those values to this package's canonical RGBA input.
+  const rgbaChannel = channel === 0 ? 2 : channel === 2 ? 0 : channel;
+  return source.data[pixel * 4 + rgbaChannel];
+}
+function AssertByte(value, name) {
+  if (!Number.isInteger(value) || value < 0 || value > 255) {
+    throw new RangeError(`Tr2TexturePackChannel.${name} must be an integer from 0 to 255.`);
+  }
+  return value;
+}
+function RequireInput(inputs, path) {
+  const value = inputs.get(String(path || ""));
+  if (!value) {
+    throw PipelineError("CJS_TEXTURE_PIPELINE_INPUT_MISSING", `Texture pipeline input is unavailable: ${String(path || "")}.`);
+  }
+  return value;
+}
+function RequireBitmap(bitmap) {
+  if (!bitmap) {
+    throw PipelineError("CJS_TEXTURE_PIPELINE_BITMAP_INVALID", "Texture pipeline step requires a valid input bitmap.");
+  }
+  return bitmap;
+}
+function AddDependency(dependencies, value) {
+  const path = String(value || "");
+  if (path) {
+    dependencies.add(path);
+  }
+}
+function StepName(step) {
+  return step?.constructor?.name || step?.className || "";
+}
+function PipelineError(code, message) {
+  const error = new Error(message);
+  error.code = code;
+  return error;
+}
+
+export { ExecuteTexturePipeline, GetTexturePipelineDependencies };
+//# sourceMappingURL=texturePipelineBehavior.js.map

package/dist/resources/texturePipelineBehavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"texturePipelineBehavior.js","sources":["../../../src/resources/texturePipelineBehavior.js"],"sourcesContent":["// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipeline.cpp\r\n// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepLoad.cpp\r\n// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepLimitSize.cpp\r\n// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepCompress.cpp\r\n// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepPack.cpp\r\nimport { validateRgbaPayload } from \"../format/payloadContract.js\";\r\nimport { PixelFormat as PayloadPixelFormat } from \"@carbonenginejs/runtime-const/graphics\";\r\nimport { PixelFormat as CarbonPixelFormat } from \"@carbonenginejs/runtime-const/render-context\";\r\n\r\nconst STEP_LOAD = \"Tr2TexturePipelineStepLoad\";\r\nconst STEP_LIMIT_SIZE = \"Tr2TexturePipelineStepLimitSize\";\r\nconst STEP_COMPRESS = \"Tr2TexturePipelineStepCompress\";\r\nconst STEP_PACK = \"Tr2TexturePipelineStepPack\";\r\nconst PACK_FORMATS = new Set([\r\n  CarbonPixelFormat.PIXEL_FORMAT_R8_UNORM,\r\n  CarbonPixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM,\r\n  CarbonPixelFormat.PIXEL_FORMAT_B8G8R8X8_UNORM\r\n]);\r\n\r\n/**\r\n * Collect Carbon texture-pipeline dependencies in std::set-equivalent order.\r\n *\r\n * @param {object[]} steps Pipeline steps.\r\n * @returns {string[]} Sorted unique resource paths.\r\n */\r\nexport function GetTexturePipelineDependencies(steps)\r\n{\r\n  const dependencies = new Set();\r\n  for (const step of AssertSteps(steps))\r\n  {\r\n    const name = StepName(step);\r\n    if (name === STEP_LOAD)\r\n    {\r\n      AddDependency(dependencies, step.path);\r\n    }\r\n    else if (name === STEP_PACK)\r\n    {\r\n      AddDependency(dependencies, step.r?.path);\r\n      AddDependency(dependencies, step.g?.path);\r\n      AddDependency(dependencies, step.b?.path);\r\n      AddDependency(dependencies, step.a?.path);\r\n    }\r\n  }\r\n  return [ ...dependencies ].sort((a, b) => a < b ? -1 : a > b ? 1 : 0);\r\n}\r\n\r\n/**\r\n * Execute the maintained JavaScript form of Carbon's CPU bitmap pipeline.\r\n *\r\n * @param {object[]} steps Pipeline steps.\r\n * @param {{maxWidth:number,maxHeight:number}} params Caller size limits.\r\n * @param {object|null} options Input resolution options.\r\n * @returns {Promise<object>} Canonical RGBA payload.\r\n */\r\nexport async function ExecuteTexturePipeline(steps, params, options = null)\r\n{\r\n  const list = AssertSteps(steps);\r\n  if (!list.length)\r\n  {\r\n    throw PipelineError(\"CJS_TEXTURE_PIPELINE_NO_STEPS\", \"Tr2TexturePipeline has no steps.\");\r\n  }\r\n  const limits = {\r\n    maxWidth: AssertLimit(params?.maxWidth, \"maxWidth\"),\r\n    maxHeight: AssertLimit(params?.maxHeight, \"maxHeight\")\r\n  };\r\n  const settings = NormalizeOptions(options);\r\n  const inputs = new Map();\r\n  for (const path of GetTexturePipelineDependencies(list))\r\n  {\r\n    inputs.set(path, await ResolveInput(path, settings));\r\n  }\r\n\r\n  let bitmap = null;\r\n  for (const step of list)\r\n  {\r\n    const name = StepName(step);\r\n    if (name === STEP_LOAD)\r\n    {\r\n      bitmap = CloneBitmap(RequireInput(inputs, step.path));\r\n    }\r\n    else if (name === STEP_LIMIT_SIZE)\r\n    {\r\n      bitmap = LimitBitmap(RequireBitmap(bitmap), CombineLimits(step, limits));\r\n    }\r\n    else if (name === STEP_COMPRESS)\r\n    {\r\n      // Carbon's current implementation validates the bitmap and otherwise\r\n      // performs no compression work.\r\n      RequireBitmap(bitmap);\r\n    }\r\n    else if (name === STEP_PACK)\r\n    {\r\n      bitmap = PackBitmap(step, inputs);\r\n    }\r\n    else\r\n    {\r\n      throw PipelineError(\r\n        \"CJS_TEXTURE_PIPELINE_STEP_UNSUPPORTED\",\r\n        `Unsupported texture pipeline step: ${name || \"unknown\"}.`\r\n      );\r\n    }\r\n  }\r\n\r\n  bitmap = LimitBitmap(RequireBitmap(bitmap), limits);\r\n  return ToPayload(bitmap);\r\n}\r\n\r\nfunction AssertSteps(steps)\r\n{\r\n  if (!Array.isArray(steps))\r\n  {\r\n    throw new TypeError(\"Tr2TexturePipeline.steps must be an array.\");\r\n  }\r\n  return steps;\r\n}\r\n\r\nfunction AssertLimit(value, name)\r\n{\r\n  if (!Number.isSafeInteger(value) || value < 0)\r\n  {\r\n    throw new TypeError(`Tr2TexturePipeline ${name} must be a non-negative safe integer.`);\r\n  }\r\n  return value;\r\n}\r\n\r\nfunction NormalizeOptions(options)\r\n{\r\n  if (options === null || options === undefined)\r\n  {\r\n    return {};\r\n  }\r\n  if (!options || typeof options !== \"object\" || Array.isArray(options))\r\n  {\r\n    throw new TypeError(\"Tr2TexturePipeline options must be an object or null.\");\r\n  }\r\n  if (options.load !== undefined && typeof options.load !== \"function\")\r\n  {\r\n    throw new TypeError(\"Tr2TexturePipeline options.load must be a function.\");\r\n  }\r\n  if (options.resMan !== undefined && typeof options.resMan?.GetObject !== \"function\")\r\n  {\r\n    throw new TypeError(\"Tr2TexturePipeline options.resMan must provide GetObject().\");\r\n  }\r\n  return options;\r\n}\r\n\r\nasync function ResolveInput(path, options)\r\n{\r\n  let value;\r\n  if (options.inputs instanceof Map)\r\n  {\r\n    value = options.inputs.get(path);\r\n  }\r\n  else if (options.inputs && typeof options.inputs === \"object\")\r\n  {\r\n    value = options.inputs[path];\r\n  }\r\n  if (value === undefined && options.load)\r\n  {\r\n    value = await options.load(path);\r\n  }\r\n  if (value === undefined && options.resMan)\r\n  {\r\n    value = await options.resMan.GetObject(path, {\r\n      ...(options.resourceOptions || {}),\r\n      requirement: \"image\",\r\n      emit: \"rgba\"\r\n    });\r\n  }\r\n  if (value === undefined)\r\n  {\r\n    throw PipelineError(\r\n      \"CJS_TEXTURE_PIPELINE_INPUT_MISSING\",\r\n      `No texture pipeline input was provided for ${path}.`\r\n    );\r\n  }\r\n  const payload = typeof value?.GetPayload === \"function\" ? value.GetPayload() : value;\r\n  validateRgbaPayload(payload);\r\n  if (payload.pixelFormat !== PayloadPixelFormat.RGBA8_UNORM)\r\n  {\r\n    throw PipelineError(\r\n      \"CJS_TEXTURE_PIPELINE_FORMAT_UNSUPPORTED\",\r\n      `Texture pipeline input ${path} must use rgba8unorm.`\r\n    );\r\n  }\r\n  return FromPayload(payload);\r\n}\r\n\r\nfunction FromPayload(payload)\r\n{\r\n  const data = new Uint8Array(payload.width * payload.height * 4);\r\n  for (let y = 0; y < payload.height; y++)\r\n  {\r\n    const sourceOffset = y * payload.strideBytes;\r\n    const targetOffset = y * payload.width * 4;\r\n    data.set(payload.data.subarray(sourceOffset, sourceOffset + payload.width * 4), targetOffset);\r\n  }\r\n  return {\r\n    width: payload.width,\r\n    height: payload.height,\r\n    data,\r\n    sourceFormat: payload.sourceFormat || \"rgba\",\r\n    colorSpace: payload.colorSpace,\r\n    alphaMode: payload.alphaMode,\r\n    metadata: payload.metadata || null\r\n  };\r\n}\r\n\r\nfunction ToPayload(bitmap)\r\n{\r\n  return {\r\n    payloadType: \"rgba\",\r\n    sourceFormat: bitmap.sourceFormat || \"texture-pipeline\",\r\n    width: bitmap.width,\r\n    height: bitmap.height,\r\n    pixelFormat: PayloadPixelFormat.RGBA8_UNORM,\r\n    data: bitmap.data,\r\n    strideBytes: bitmap.width * 4,\r\n    origin: \"top-left\",\r\n    colorSpace: bitmap.colorSpace || \"unknown\",\r\n    alphaMode: bitmap.alphaMode || \"unknown\",\r\n    ...(bitmap.metadata ? { metadata: bitmap.metadata } : {})\r\n  };\r\n}\r\n\r\nfunction CloneBitmap(bitmap)\r\n{\r\n  return {\r\n    ...bitmap,\r\n    data: new Uint8Array(bitmap.data),\r\n    metadata: bitmap.metadata && typeof bitmap.metadata === \"object\"\r\n      ? { ...bitmap.metadata }\r\n      : bitmap.metadata\r\n  };\r\n}\r\n\r\nfunction CombineLimits(step, params)\r\n{\r\n  return {\r\n    maxWidth: TightestLimit(AssertLimit(step.maxWidth ?? 0, \"step.maxWidth\"), params.maxWidth),\r\n    maxHeight: TightestLimit(AssertLimit(step.maxHeight ?? 0, \"step.maxHeight\"), params.maxHeight)\r\n  };\r\n}\r\n\r\nfunction TightestLimit(first, second)\r\n{\r\n  if (!first) return second;\r\n  if (!second) return first;\r\n  return Math.min(first, second);\r\n}\r\n\r\nfunction LimitBitmap(bitmap, limits)\r\n{\r\n  let result = bitmap;\r\n  while ((limits.maxWidth && result.width > limits.maxWidth)\r\n    || (limits.maxHeight && result.height > limits.maxHeight))\r\n  {\r\n    result = Downsample2x2(result);\r\n  }\r\n  return result;\r\n}\r\n\r\nfunction Downsample2x2(bitmap)\r\n{\r\n  const width = Math.max(1, Math.floor(bitmap.width / 2));\r\n  const height = Math.max(1, Math.floor(bitmap.height / 2));\r\n  const data = new Uint8Array(width * height * 4);\r\n  for (let y = 0; y < height; y++)\r\n  {\r\n    for (let x = 0; x < width; x++)\r\n    {\r\n      const counts = [ 0, 0, 0, 0 ];\r\n      let samples = 0;\r\n      for (let oy = 0; oy < 2; oy++)\r\n      {\r\n        for (let ox = 0; ox < 2; ox++)\r\n        {\r\n          const sourceX = Math.min(bitmap.width - 1, x * 2 + ox);\r\n          const sourceY = Math.min(bitmap.height - 1, y * 2 + oy);\r\n          const source = (sourceY * bitmap.width + sourceX) * 4;\r\n          for (let channel = 0; channel < 4; channel++)\r\n          {\r\n            counts[channel] += bitmap.data[source + channel];\r\n          }\r\n          samples++;\r\n        }\r\n      }\r\n      const target = (y * width + x) * 4;\r\n      for (let channel = 0; channel < 4; channel++)\r\n      {\r\n        data[target + channel] = Math.round(counts[channel] / samples);\r\n      }\r\n    }\r\n  }\r\n  return { ...bitmap, width, height, data };\r\n}\r\n\r\nfunction PackBitmap(step, inputs)\r\n{\r\n  // The generated schema records the enum's zero value, while Carbon's\r\n  // constructor initializes this step to B8G8R8A8_UNORM.\r\n  const format = step.format === CarbonPixelFormat.PIXEL_FORMAT_UNKNOWN\r\n    ? CarbonPixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM\r\n    : step.format;\r\n  if (!PACK_FORMATS.has(format))\r\n  {\r\n    throw PipelineError(\r\n      \"CJS_TEXTURE_PIPELINE_FORMAT_UNSUPPORTED\",\r\n      `Unsupported Carbon pack pixel format: ${String(format)}.`\r\n    );\r\n  }\r\n  const descriptors = [ step.r, step.g, step.b, step.a ];\r\n  const sources = descriptors.map(channel => channel?.path\r\n    ? RequireInput(inputs, channel.path)\r\n    : null);\r\n  const first = sources.find(Boolean);\r\n  const width = first?.width || 4;\r\n  const height = first?.height || 4;\r\n  for (const source of sources)\r\n  {\r\n    if (source && (source.width !== width || source.height !== height))\r\n    {\r\n      throw PipelineError(\r\n        \"CJS_TEXTURE_PIPELINE_SIZE_MISMATCH\",\r\n        \"Texture pipeline pack inputs must have identical dimensions.\"\r\n      );\r\n    }\r\n  }\r\n\r\n  const data = new Uint8Array(width * height * 4);\r\n  const isR8 = format === CarbonPixelFormat.PIXEL_FORMAT_R8_UNORM;\r\n  const isX8 = format === CarbonPixelFormat.PIXEL_FORMAT_B8G8R8X8_UNORM;\r\n  for (let pixel = 0; pixel < width * height; pixel++)\r\n  {\r\n    const values = descriptors.map((channel, index) => ReadPackChannel(\r\n      sources[index],\r\n      channel,\r\n      pixel\r\n    ));\r\n    const target = pixel * 4;\r\n    if (isR8)\r\n    {\r\n      data[target] = values[0];\r\n      data[target + 3] = 255;\r\n    }\r\n    else\r\n    {\r\n      data[target] = values[0];\r\n      data[target + 1] = values[1];\r\n      data[target + 2] = values[2];\r\n      data[target + 3] = isX8 ? 255 : values[3];\r\n    }\r\n  }\r\n  return {\r\n    width,\r\n    height,\r\n    data,\r\n    sourceFormat: \"texture-pipeline\",\r\n    colorSpace: first?.colorSpace || \"unknown\",\r\n    alphaMode: isX8 || isR8 ? \"opaque\" : \"unknown\",\r\n    metadata: { carbonPixelFormat: format }\r\n  };\r\n}\r\n\r\nfunction ReadPackChannel(source, descriptor, pixel)\r\n{\r\n  if (!source)\r\n  {\r\n    return AssertByte(descriptor?.fill ?? 0, \"fill\");\r\n  }\r\n  const channel = AssertByte(descriptor?.channel ?? 0, \"channel\");\r\n  if (channel > 3)\r\n  {\r\n    throw new RangeError(\"Tr2TexturePackChannel.channel must be between 0 and 3.\");\r\n  }\r\n  // Carbon's exposed chooser encodes RED=2 and BLUE=0 for BGRA host\r\n  // bitmaps. Translate those values to this package's canonical RGBA input.\r\n  const rgbaChannel = channel === 0 ? 2 : channel === 2 ? 0 : channel;\r\n  return source.data[pixel * 4 + rgbaChannel];\r\n}\r\n\r\nfunction AssertByte(value, name)\r\n{\r\n  if (!Number.isInteger(value) || value < 0 || value > 255)\r\n  {\r\n    throw new RangeError(`Tr2TexturePackChannel.${name} must be an integer from 0 to 255.`);\r\n  }\r\n  return value;\r\n}\r\n\r\nfunction RequireInput(inputs, path)\r\n{\r\n  const value = inputs.get(String(path || \"\"));\r\n  if (!value)\r\n  {\r\n    throw PipelineError(\r\n      \"CJS_TEXTURE_PIPELINE_INPUT_MISSING\",\r\n      `Texture pipeline input is unavailable: ${String(path || \"\")}.`\r\n    );\r\n  }\r\n  return value;\r\n}\r\n\r\nfunction RequireBitmap(bitmap)\r\n{\r\n  if (!bitmap)\r\n  {\r\n    throw PipelineError(\r\n      \"CJS_TEXTURE_PIPELINE_BITMAP_INVALID\",\r\n      \"Texture pipeline step requires a valid input bitmap.\"\r\n    );\r\n  }\r\n  return bitmap;\r\n}\r\n\r\nfunction AddDependency(dependencies, value)\r\n{\r\n  const path = String(value || \"\");\r\n  if (path)\r\n  {\r\n    dependencies.add(path);\r\n  }\r\n}\r\n\r\nfunction StepName(step)\r\n{\r\n  return step?.constructor?.name || step?.className || \"\";\r\n}\r\n\r\nfunction PipelineError(code, message)\r\n{\r\n  const error = new Error(message);\r\n  error.code = code;\r\n  return error;\r\n}\r\n"],"names":["STEP_LOAD","STEP_LIMIT_SIZE","STEP_COMPRESS","STEP_PACK","PACK_FORMATS","Set","CarbonPixelFormat","PIXEL_FORMAT_R8_UNORM","PIXEL_FORMAT_B8G8R8A8_UNORM","PIXEL_FORMAT_B8G8R8X8_UNORM","GetTexturePipelineDependencies","steps","dependencies","step","AssertSteps","name","StepName","AddDependency","path","r","g","b","a","sort","ExecuteTexturePipeline","params","options","list","length","PipelineError","limits","maxWidth","AssertLimit","maxHeight","settings","NormalizeOptions","inputs","Map","set","ResolveInput","bitmap","CloneBitmap","RequireInput","LimitBitmap","RequireBitmap","CombineLimits","PackBitmap","ToPayload","Array","isArray","TypeError","value","Number","isSafeInteger","undefined","load","resMan","GetObject","get","resourceOptions","requirement","emit","payload","GetPayload","validateRgbaPayload","pixelFormat","PayloadPixelFormat","RGBA8_UNORM","FromPayload","data","Uint8Array","width","height","y","sourceOffset","strideBytes","targetOffset","subarray","sourceFormat","colorSpace","alphaMode","metadata","payloadType","origin","TightestLimit","first","second","Math","min","result","Downsample2x2","max","floor","x","counts","samples","oy","ox","sourceX","sourceY","source","channel","target","round","format","PIXEL_FORMAT_UNKNOWN","has","String","descriptors","sources","map","find","Boolean","isR8","isX8","pixel","values","index","ReadPackChannel","carbonPixelFormat","descriptor","AssertByte","fill","RangeError","rgbaChannel","isInteger","add","constructor","className","code","message","error","Error"],"mappings":"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"}

package/format-notices/bnk/NOTICE

@@ -8,10 +8,13 @@ and EVE-related data remain copyright their original holders.
 Wwise and the Wwise soundbank format are property of Audiokinetic Inc.
 
 This reader is original CarbonEngineJS code authored directly in
-runtime-resource; no legacy package was copied. The soundbank chunk layout was
-implemented from publicly documented community knowledge of the format
-(ww2ogg, vgmstream, wwiser documentation); no code was copied from those
-projects and no Audiokinetic SDK material was used.
+runtime-resource; no legacy package was copied. The soundbank chunk layout,
+HIRC object field layouts, and the event-graph resolution exposed as
+`eventMediaFromBanks` were implemented from publicly documented community
+knowledge of the format (ww2ogg, vgmstream, wwiser documentation) and
+independently verified by hexdump against EVE Online soundbanks (bank
+generator version 150); no code was copied from those projects and no
+Audiokinetic SDK material was used.
 Audiokinetic, CarbonEngine, and Fenris Creations (CCP Games) are mentioned for
 interoperability, provenance, and future migration context only. This package
 is not affiliated with or endorsed by Audiokinetic Inc. or CCP Games.

package/package.json

@@ -1,51 +1,51 @@
-{
-  "name": "@carbonenginejs/runtime-resource",
-  "version": "0.1.0",
-  "description": "CarbonEngineJS resource lifecycle, cache, source, and object loading contracts.",
-  "type": "module",
-  "exports": {
-    ".": "./dist/index.js",
-    "./generated/resources": "./dist/generated/resources/index.js",
-    "./formats": "./dist/formats/index.js",
-    "./formats/black": "./dist/formats/black/index.js",
-    "./formats/black/schema": "./dist/formats/black/core/blackSchema.js",
-    "./formats/black/enums": "./dist/formats/black/core/blackEnums.js",
-    "./formats/black/version": "./dist/formats/black/core/blackVersion.js",
-    "./formats/bnk": "./dist/formats/bnk/index.js",
-    "./formats/cmf": "./dist/formats/cmf/index.js",
-    "./formats/dds": "./dist/formats/dds/index.js",
-    "./formats/fbx": "./dist/formats/fbx/index.js",
-    "./formats/flac": "./dist/formats/flac/index.js",
-    "./formats/gif": "./dist/formats/gif/index.js",
-    "./formats/gltf": "./dist/formats/gltf/index.js",
-    "./formats/jpeg": "./dist/formats/jpeg/index.js",
-    "./formats/mp3": "./dist/formats/mp3/index.js",
-    "./formats/mp4": "./dist/formats/mp4/index.js",
-    "./formats/obj": "./dist/formats/obj/index.js",
-    "./formats/ogg": "./dist/formats/ogg/index.js",
-    "./formats/png": "./dist/formats/png/index.js",
-    "./formats/red": "./dist/formats/red/index.js",
-    "./formats/red/schema": "./dist/formats/red/core/blackDefinitions.js",
-    "./formats/stl": "./dist/formats/stl/index.js",
-    "./formats/tga": "./dist/formats/tga/index.js",
-    "./formats/wav": "./dist/formats/wav/index.js",
-    "./formats/webm": "./dist/formats/webm/index.js",
-    "./formats/webp": "./dist/formats/webp/index.js",
-    "./formats/wem": "./dist/formats/wem/index.js",
-    "./formats/yaml": "./dist/formats/yaml/index.js"
-  },
-  "sideEffects": false,
-  "engines": {
-    "node": ">=18"
-  },
-  "dependencies": {
-    "@carbonenginejs/core-math": "^0.1.3",
-    "@carbonenginejs/core-types": "^0.5.0",
-    "meshoptimizer": "^1.2.0",
-    "yaml": "^2.4.0"
-  },
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "@carbonenginejs/runtime-resource",
+  "version": "0.7.0",
+  "description": "CarbonEngineJS resource lifecycle, cache, source, and object loading contracts.",
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js",
+    "./formats": "./dist/formats/index.js",
+    "./formats/black": "./dist/formats/black/index.js",
+    "./formats/black/schema": "./dist/formats/black/core/blackSchema.js",
+    "./formats/black/enums": "./dist/formats/black/core/blackEnums.js",
+    "./formats/black/version": "./dist/formats/black/core/blackVersion.js",
+    "./formats/bnk": "./dist/formats/bnk/index.js",
+    "./formats/cmf": "./dist/formats/cmf/index.js",
+    "./formats/dds": "./dist/formats/dds/index.js",
+    "./formats/fbx": "./dist/formats/fbx/index.js",
+    "./formats/flac": "./dist/formats/flac/index.js",
+    "./formats/gif": "./dist/formats/gif/index.js",
+    "./formats/gltf": "./dist/formats/gltf/index.js",
+    "./formats/jpeg": "./dist/formats/jpeg/index.js",
+    "./formats/mp3": "./dist/formats/mp3/index.js",
+    "./formats/mp4": "./dist/formats/mp4/index.js",
+    "./formats/obj": "./dist/formats/obj/index.js",
+    "./formats/ogg": "./dist/formats/ogg/index.js",
+    "./formats/png": "./dist/formats/png/index.js",
+    "./formats/red": "./dist/formats/red/index.js",
+    "./formats/red/schema": "./dist/formats/red/core/blackDefinitions.js",
+    "./formats/stl": "./dist/formats/stl/index.js",
+    "./formats/tga": "./dist/formats/tga/index.js",
+    "./formats/wav": "./dist/formats/wav/index.js",
+    "./formats/webm": "./dist/formats/webm/index.js",
+    "./formats/webp": "./dist/formats/webp/index.js",
+    "./formats/wem": "./dist/formats/wem/index.js",
+    "./formats/yaml": "./dist/formats/yaml/index.js"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@carbonenginejs/core-math": "^0.1.3",
+    "@carbonenginejs/core-types": "^0.12.0",
+    "@carbonenginejs/runtime-const": "^0.1.0",
+    "meshoptimizer": "^1.2.0",
+    "yaml": "^2.4.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}