@carbonenginejs/runtime-resource 0.9.1 → 0.10.0

package/dist/{resources → resource/texture}/texturePipelineBehavior.js

@@ -1,6 +1,6 @@
-import { validateRgbaPayload } from '../format/payloadContract.js';
-import { PixelFormat as PixelFormat$1 } from '@carbonenginejs/runtime-const/graphics';
-import { PixelFormat } from '@carbonenginejs/runtime-const/render-context';
+import { validateRgbaPayload } from '../../format/payloadContract.js';
+import { PixelFormat as PixelFormat$1 } from '@carbonenginejs/runtime-utils/graphics';
+import { PixelFormat } from '@carbonenginejs/runtime-utils/render-context';
 
 // Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipeline.cpp
 // Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepLoad.cpp
@@ -19,17 +19,17 @@ const PACK_FORMATS = new Set([PixelFormat.PIXEL_FORMAT_R8_UNORM, PixelFormat.PIX
  * @param {object[]} steps Pipeline steps.
  * @returns {string[]} Sorted unique resource paths.
  */
-function GetTexturePipelineDependencies(steps) {
+function getTexturePipelineDependencies(steps) {
   const dependencies = new Set();
-  for (const step of AssertSteps(steps)) {
-    const name = StepName(step);
+  for (const step of assertSteps(steps)) {
+    const name = stepName(step);
     if (name === STEP_LOAD) {
-      AddDependency(dependencies, step.path);
+      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);
+      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);
@@ -43,53 +43,53 @@ function GetTexturePipelineDependencies(steps) {
  * @param {object|null} options Input resolution options.
  * @returns {Promise<object>} Canonical RGBA payload.
  */
-async function ExecuteTexturePipeline(steps, params, options = null) {
-  const list = AssertSteps(steps);
+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.");
+    throw pipelineError("CJS_TEXTURE_PIPELINE_NO_STEPS", "Tr2TexturePipeline has no steps.");
   }
   const limits = {
-    maxWidth: AssertLimit(params?.maxWidth, "maxWidth"),
-    maxHeight: AssertLimit(params?.maxHeight, "maxHeight")
+    maxWidth: assertLimit(params?.maxWidth, "maxWidth"),
+    maxHeight: assertLimit(params?.maxHeight, "maxHeight")
   };
-  const settings = NormalizeOptions(options);
+  const settings = normalizeOptions(options);
   const inputs = new Map();
-  for (const path of GetTexturePipelineDependencies(list)) {
-    inputs.set(path, await ResolveInput(path, settings));
+  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);
+    const name = stepName(step);
     if (name === STEP_LOAD) {
-      bitmap = CloneBitmap(RequireInput(inputs, step.path));
+      bitmap = cloneBitmap(requireInput(inputs, step.path));
     } else if (name === STEP_LIMIT_SIZE) {
-      bitmap = LimitBitmap(RequireBitmap(bitmap), CombineLimits(step, limits));
+      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);
+      requireBitmap(bitmap);
     } else if (name === STEP_PACK) {
-      bitmap = PackBitmap(step, inputs);
+      bitmap = packBitmap(step, inputs);
     } else {
-      throw PipelineError("CJS_TEXTURE_PIPELINE_STEP_UNSUPPORTED", `Unsupported texture pipeline step: ${name || "unknown"}.`);
+      throw pipelineError("CJS_TEXTURE_PIPELINE_STEP_UNSUPPORTED", `Unsupported texture pipeline step: ${name || "unknown"}.`);
     }
   }
-  bitmap = LimitBitmap(RequireBitmap(bitmap), limits);
-  return ToPayload(bitmap);
+  bitmap = limitBitmap(requireBitmap(bitmap), limits);
+  return toPayload(bitmap);
 }
-function AssertSteps(steps) {
+function assertSteps(steps) {
   if (!Array.isArray(steps)) {
     throw new TypeError("Tr2TexturePipeline.steps must be an array.");
   }
   return steps;
 }
-function AssertLimit(value, name) {
+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) {
+function normalizeOptions(options) {
   if (options === null || options === undefined) {
     return {};
   }
@@ -104,7 +104,7 @@ function NormalizeOptions(options) {
   }
   return options;
 }
-async function ResolveInput(path, options) {
+async function resolveInput(path, options) {
   let value;
   if (options.inputs instanceof Map) {
     value = options.inputs.get(path);
@@ -122,16 +122,16 @@ async function ResolveInput(path, options) {
     });
   }
   if (value === undefined) {
-    throw PipelineError("CJS_TEXTURE_PIPELINE_INPUT_MISSING", `No texture pipeline input was provided for ${path}.`);
+    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.`);
+    throw pipelineError("CJS_TEXTURE_PIPELINE_FORMAT_UNSUPPORTED", `Texture pipeline input ${path} must use rgba8unorm.`);
   }
-  return FromPayload(payload);
+  return fromPayload(payload);
 }
-function 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;
@@ -148,7 +148,7 @@ function FromPayload(payload) {
     metadata: payload.metadata || null
   };
 }
-function ToPayload(bitmap) {
+function toPayload(bitmap) {
   return {
     payloadType: "rgba",
     sourceFormat: bitmap.sourceFormat || "texture-pipeline",
@@ -165,7 +165,7 @@ function ToPayload(bitmap) {
     } : {})
   };
 }
-function CloneBitmap(bitmap) {
+function cloneBitmap(bitmap) {
   return {
     ...bitmap,
     data: new Uint8Array(bitmap.data),
@@ -174,25 +174,25 @@ function CloneBitmap(bitmap) {
     } : bitmap.metadata
   };
 }
-function CombineLimits(step, params) {
+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)
+    maxWidth: tightestLimit(assertLimit(step.maxWidth ?? 0, "step.maxWidth"), params.maxWidth),
+    maxHeight: tightestLimit(assertLimit(step.maxHeight ?? 0, "step.maxHeight"), params.maxHeight)
   };
 }
-function TightestLimit(first, second) {
+function tightestLimit(first, second) {
   if (!first) return second;
   if (!second) return first;
   return Math.min(first, second);
 }
-function LimitBitmap(bitmap, limits) {
+function limitBitmap(bitmap, limits) {
   let result = bitmap;
   while (limits.maxWidth && result.width > limits.maxWidth || limits.maxHeight && result.height > limits.maxHeight) {
-    result = Downsample2x2(result);
+    result = downsample2x2(result);
   }
   return result;
 }
-function Downsample2x2(bitmap) {
+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);
@@ -224,28 +224,28 @@ function Downsample2x2(bitmap) {
     data
   };
 }
-function PackBitmap(step, inputs) {
+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)}.`);
+    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 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.");
+      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 values = descriptors.map((channel, index) => readPackChannel(sources[index], channel, pixel));
     const target = pixel * 4;
     if (isR8) {
       data[target] = values[0];
@@ -269,11 +269,11 @@ function PackBitmap(step, inputs) {
     }
   };
 }
-function ReadPackChannel(source, descriptor, pixel) {
+function readPackChannel(source, descriptor, pixel) {
   if (!source) {
-    return AssertByte(descriptor?.fill ?? 0, "fill");
+    return assertByte(descriptor?.fill ?? 0, "fill");
   }
-  const channel = AssertByte(descriptor?.channel ?? 0, "channel");
+  const channel = assertByte(descriptor?.channel ?? 0, "channel");
   if (channel > 3) {
     throw new RangeError("Tr2TexturePackChannel.channel must be between 0 and 3.");
   }
@@ -282,39 +282,39 @@ function ReadPackChannel(source, descriptor, pixel) {
   const rgbaChannel = channel === 0 ? 2 : channel === 2 ? 0 : channel;
   return source.data[pixel * 4 + rgbaChannel];
 }
-function AssertByte(value, name) {
+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) {
+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 || "")}.`);
+    throw pipelineError("CJS_TEXTURE_PIPELINE_INPUT_MISSING", `Texture pipeline input is unavailable: ${String(path || "")}.`);
   }
   return value;
 }
-function RequireBitmap(bitmap) {
+function requireBitmap(bitmap) {
   if (!bitmap) {
-    throw PipelineError("CJS_TEXTURE_PIPELINE_BITMAP_INVALID", "Texture pipeline step requires a valid input bitmap.");
+    throw pipelineError("CJS_TEXTURE_PIPELINE_BITMAP_INVALID", "Texture pipeline step requires a valid input bitmap.");
   }
   return bitmap;
 }
-function AddDependency(dependencies, value) {
+function addDependency(dependencies, value) {
   const path = String(value || "");
   if (path) {
     dependencies.add(path);
   }
 }
-function StepName(step) {
+function stepName(step) {
   return step?.constructor?.name || step?.className || "";
 }
-function PipelineError(code, message) {
+function pipelineError(code, message) {
   const error = new Error(message);
   error.code = code;
   return error;
 }
 
-export { ExecuteTexturePipeline, GetTexturePipelineDependencies };
+export { executeTexturePipeline, getTexturePipelineDependencies };
 //# sourceMappingURL=texturePipelineBehavior.js.map

package/dist/resource/texture/texturePipelineBehavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"texturePipelineBehavior.js","sources":["../../../../src/resource/texture/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\";\nimport { PixelFormat as PayloadPixelFormat } from \"@carbonenginejs/runtime-utils/graphics\";\r\nimport { PixelFormat as CarbonPixelFormat } from \"@carbonenginejs/runtime-utils/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/dist/worker/CjsResManMainThreadLoader.js

@@ -0,0 +1,87 @@
+/**
+ * Direct execution strategy that reads through a structural source and invokes registered format facades on the caller thread.
+ *
+ * It is used when no browser worker is selected or when a source or format
+ * does not declare a worker-safe operation.
+ */
+class CjsResManMainThreadLoader {
+  /**
+   * Read through an injected resource source.
+   *
+   * @param {object|Function} source Source exposing `Read(path, options)`.
+   * @param {string} path Normalized resource path.
+   * @param {object} [options={}] Source read options.
+   * @returns {*} Source result or promise.
+   */
+  Read(source, path, options = {}) {
+    assertResourceSource(source);
+    return source.Read(path, options);
+  }
+
+  /**
+   * Main-thread loaders never claim worker execution.
+   *
+   * @returns {false}
+   */
+  CanReadFormat() {
+    return false;
+  }
+
+  /**
+   * Execute one normalized format read on the current thread.
+   *
+   * @param {object} descriptor Registered format descriptor.
+   * @param {*} input Reader input.
+   * @param {object} [formatOptions={}] Normalized format options.
+   * @returns {Promise<*>} Format result.
+   */
+  ReadFormat(descriptor, input, formatOptions = {}) {
+    return readFormatOnCurrentThread(descriptor, input, formatOptions);
+  }
+
+  /**
+   * Main-thread execution owns no pending worker requests.
+   *
+   * @returns {0}
+   */
+  GetPendingCount() {
+    return 0;
+  }
+}
+
+/**
+ * Invoke a format facade without crossing a worker boundary.
+ *
+ * @param {object} descriptor Registered format descriptor.
+ * @param {*} input Reader input.
+ * @param {object} formatOptions Normalized format options.
+ * @returns {Promise<*>} Reader result.
+ */
+function readFormatOnCurrentThread(descriptor, input, formatOptions = {}) {
+  const Format = descriptor?.Format;
+  if (typeof Format !== "function") {
+    throw new TypeError("Resource format descriptor requires a Format class.");
+  }
+  if (typeof Format.readAsync === "function") {
+    return Format.readAsync(input, formatOptions);
+  }
+  if (typeof Format.read === "function") {
+    return Format.read(input, formatOptions);
+  }
+  const reader = new Format(formatOptions);
+  if (typeof reader.ReadAsync === "function") {
+    return reader.ReadAsync(input, formatOptions);
+  }
+  if (typeof reader.Read === "function") {
+    return reader.Read(input, formatOptions);
+  }
+  throw new TypeError(`${Format.name} does not expose a read operation.`);
+}
+function assertResourceSource(source) {
+  if (!source || typeof source !== "object" && typeof source !== "function" || typeof source.Read !== "function") {
+    throw new TypeError("Resource source must provide Read(path, options).");
+  }
+}
+
+export { CjsResManMainThreadLoader };
+//# sourceMappingURL=CjsResManMainThreadLoader.js.map

package/dist/worker/CjsResManMainThreadLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsResManMainThreadLoader.js","sources":["../../../src/worker/CjsResManMainThreadLoader.js"],"sourcesContent":["/**\n * Direct execution strategy that reads through a structural source and invokes registered format facades on the caller thread.\n *\n * It is used when no browser worker is selected or when a source or format\n * does not declare a worker-safe operation.\n */\nexport class CjsResManMainThreadLoader\n{\n  /**\n   * Read through an injected resource source.\n   *\n   * @param {object|Function} source Source exposing `Read(path, options)`.\n   * @param {string} path Normalized resource path.\n   * @param {object} [options={}] Source read options.\n   * @returns {*} Source result or promise.\n   */\n  Read(source, path, options = {})\n  {\n    assertResourceSource(source);\n    return source.Read(path, options);\n  }\n\n  /**\n   * Main-thread loaders never claim worker execution.\n   *\n   * @returns {false}\n   */\n  CanReadFormat()\n  {\n    return false;\n  }\n\n  /**\n   * Execute one normalized format read on the current thread.\n   *\n   * @param {object} descriptor Registered format descriptor.\n   * @param {*} input Reader input.\n   * @param {object} [formatOptions={}] Normalized format options.\n   * @returns {Promise<*>} Format result.\n   */\n  ReadFormat(descriptor, input, formatOptions = {})\n  {\n    return readFormatOnCurrentThread(descriptor, input, formatOptions);\n  }\n\n  /**\n   * Main-thread execution owns no pending worker requests.\n   *\n   * @returns {0}\n   */\n  GetPendingCount()\n  {\n    return 0;\n  }\n}\n\n/**\n * Invoke a format facade without crossing a worker boundary.\n *\n * @param {object} descriptor Registered format descriptor.\n * @param {*} input Reader input.\n * @param {object} formatOptions Normalized format options.\n * @returns {Promise<*>} Reader result.\n */\nfunction readFormatOnCurrentThread(\n  descriptor,\n  input,\n  formatOptions = {}\n)\n{\n  const Format = descriptor?.Format;\n\n  if (typeof Format !== \"function\")\n  {\n    throw new TypeError(\"Resource format descriptor requires a Format class.\");\n  }\n  if (typeof Format.readAsync === \"function\")\n  {\n    return Format.readAsync(input, formatOptions);\n  }\n  if (typeof Format.read === \"function\")\n  {\n    return Format.read(input, formatOptions);\n  }\n\n  const reader = new Format(formatOptions);\n\n  if (typeof reader.ReadAsync === \"function\")\n  {\n    return reader.ReadAsync(input, formatOptions);\n  }\n  if (typeof reader.Read === \"function\")\n  {\n    return reader.Read(input, formatOptions);\n  }\n\n  throw new TypeError(`${Format.name} does not expose a read operation.`);\n}\n\nfunction assertResourceSource(source)\n{\n  if (!source || (typeof source !== \"object\" && typeof source !== \"function\")\n    || typeof source.Read !== \"function\")\n  {\n    throw new TypeError(\"Resource source must provide Read(path, options).\");\n  }\n}\n"],"names":["CjsResManMainThreadLoader","Read","source","path","options","assertResourceSource","CanReadFormat","ReadFormat","descriptor","input","formatOptions","readFormatOnCurrentThread","GetPendingCount","Format","TypeError","readAsync","read","reader","ReadAsync","name"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,yBAAyB,CACtC;AACE;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,IAAIA,CAACC,MAAM,EAAEC,IAAI,EAAEC,OAAO,GAAG,EAAE,EAC/B;IACEC,oBAAoB,CAACH,MAAM,CAAC;AAC5B,IAAA,OAAOA,MAAM,CAACD,IAAI,CAACE,IAAI,EAAEC,OAAO,CAAC;AACnC,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEE,EAAAA,aAAaA,GACb;AACE,IAAA,OAAO,KAAK;AACd,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,UAAUA,CAACC,UAAU,EAAEC,KAAK,EAAEC,aAAa,GAAG,EAAE,EAChD;AACE,IAAA,OAAOC,yBAAyB,CAACH,UAAU,EAAEC,KAAK,EAAEC,aAAa,CAAC;AACpE,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEE,EAAAA,eAAeA,GACf;AACE,IAAA,OAAO,CAAC;AACV,EAAA;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASD,yBAAyBA,CAChCH,UAAU,EACVC,KAAK,EACLC,aAAa,GAAG,EAAE,EAEpB;AACE,EAAA,MAAMG,MAAM,GAAGL,UAAU,EAAEK,MAAM;AAEjC,EAAA,IAAI,OAAOA,MAAM,KAAK,UAAU,EAChC;AACE,IAAA,MAAM,IAAIC,SAAS,CAAC,qDAAqD,CAAC;AAC5E,EAAA;AACA,EAAA,IAAI,OAAOD,MAAM,CAACE,SAAS,KAAK,UAAU,EAC1C;AACE,IAAA,OAAOF,MAAM,CAACE,SAAS,CAACN,KAAK,EAAEC,aAAa,CAAC;AAC/C,EAAA;AACA,EAAA,IAAI,OAAOG,MAAM,CAACG,IAAI,KAAK,UAAU,EACrC;AACE,IAAA,OAAOH,MAAM,CAACG,IAAI,CAACP,KAAK,EAAEC,aAAa,CAAC;AAC1C,EAAA;AAEA,EAAA,MAAMO,MAAM,GAAG,IAAIJ,MAAM,CAACH,aAAa,CAAC;AAExC,EAAA,IAAI,OAAOO,MAAM,CAACC,SAAS,KAAK,UAAU,EAC1C;AACE,IAAA,OAAOD,MAAM,CAACC,SAAS,CAACT,KAAK,EAAEC,aAAa,CAAC;AAC/C,EAAA;AACA,EAAA,IAAI,OAAOO,MAAM,CAAChB,IAAI,KAAK,UAAU,EACrC;AACE,IAAA,OAAOgB,MAAM,CAAChB,IAAI,CAACQ,KAAK,EAAEC,aAAa,CAAC;AAC1C,EAAA;EAEA,MAAM,IAAII,SAAS,CAAC,CAAA,EAAGD,MAAM,CAACM,IAAI,oCAAoC,CAAC;AACzE;AAEA,SAASd,oBAAoBA,CAACH,MAAM,EACpC;AACE,EAAA,IAAI,CAACA,MAAM,IAAK,OAAOA,MAAM,KAAK,QAAQ,IAAI,OAAOA,MAAM,KAAK,UAAW,IACtE,OAAOA,MAAM,CAACD,IAAI,KAAK,UAAU,EACtC;AACE,IAAA,MAAM,IAAIa,SAAS,CAAC,mDAAmD,CAAC;AAC1E,EAAA;AACF;;;;"}