@carbonenginejs/runtime 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/resource/texture/CjsTexturePackConstructor.js

@@ -0,0 +1,160 @@
+import { IBlueDynamicResourceConstructor } from '#blue';
+import { PixelFormat } from '#consts/render-context';
+import { TriTextureRes } from './TriTextureRes.js';
+import { Tr2TexturePipeline } from './Tr2TexturePipeline.js';
+import { CjsTexturePipelineStepPack } from './CjsTexturePipelineStepPack.js';
+import { Tr2TexturePackChannel } from './Tr2TexturePackChannel.js';
+import { Tr2TexturePipelineStepGenerateMips } from './Tr2TexturePipelineStepGenerateMips.js';
+import { CjsTexturePipelineStepConvert } from './CjsTexturePipelineStepConvert.js';
+import { CjsTexturePipelineStepResize } from './CjsTexturePipelineStepResize.js';
+
+// Not Carbon: `dynamic:/texturepack` is ours, registered in
+// /docs/architecture/non-carbon-extensions.md. Carbon's dynamic constructors
+// (SolidColorTexture.cpp, GradientTexture.cpp) rasterize from values in the
+// query; this one composes other resources.
+
+/** The prefix a pack path starts with. */
+const TexturePackPrefix = "dynamic:/texturepack/";
+
+/** Authored channel letters, in Carbon's RGBA authoring order. */
+const CHANNEL_INDEX = {
+  r: 0,
+  g: 1,
+  b: 2,
+  a: 3
+};
+
+/**
+ * `dynamic:/texturepack/<source>;<source>...` - up to four channels packed
+ * from separate images into one texture.
+ *
+ * Each source is a resource path, optionally followed by the channels to take
+ * from it: `res:/a.dds:rg;res:/b.dds:rg` puts a's red and green into red and
+ * green, and b's into blue and alpha. Without a suffix a source gives its red
+ * channel, as the scalar maps this exists for store their value there. The
+ * query becomes a Carbon texture-pipeline recipe - Convert, Resize, Pack,
+ * GenerateMips - which the texture runs through Carbon's `.ctr` route.
+ *
+ * Kept in the cache after release: rebuilding means downloading and decoding
+ * every source again.
+ */
+class CjsTexturePackConstructor extends IBlueDynamicResourceConstructor {
+  /**
+   * @param {object} resourceManager The `CjsResMan` that loads the sources.
+   */
+  constructor(resourceManager) {
+    super();
+    this._resourceManager = resourceManager;
+  }
+
+  /**
+   * A generated pack costs downloads and decodes to rebuild, so it is kept.
+   *
+   * @returns {boolean} Always true.
+   */
+  IsCacheable() {
+    return true;
+  }
+
+  /**
+   * Build the texture a pack query describes. The recipe starts running at
+   * once; the texture is prepared when it finishes.
+   *
+   * @param {string} query Text after `dynamic:/texturepack/`.
+   * @returns {TriTextureRes} The texture resource.
+   */
+  GetResource(query) {
+    const texture = new TriTextureRes();
+    texture.Initialize(TexturePackPrefix + query, "");
+    const pipeline = CjsTexturePackConstructor.buildRecipe(query);
+    if (!pipeline) {
+      const error = new Error(`Failed to parse ${TexturePackPrefix}${query} texture path`);
+      error.code = "CJS_TEXTURE_PROCEDURAL_PATH_INVALID";
+      texture.SetError(error);
+      return texture;
+    }
+    texture.LoadPipeline(pipeline, this._resourceManager);
+    return texture;
+  }
+
+  /**
+   * The recipe for a pack query, or null when it is malformed.
+   *
+   * @param {string} query `source[:channels];source[:channels]...`
+   * @returns {Tr2TexturePipeline|null} The recipe.
+   */
+  static buildRecipe(query) {
+    const sources = CjsTexturePackConstructor.parseQuery(query);
+    if (!sources) return null;
+    const channelCount = sources.reduce((sum, source) => sum + source.channels.length, 0);
+    const pack = new CjsTexturePipelineStepPack();
+
+    // The narrowest output that holds the channels: one byte a texel for one,
+    // two for two, BGRA for three or four.
+    pack.format = channelCount === 1 ? PixelFormat.PIXEL_FORMAT_R8_UNORM : channelCount === 2 ? PixelFormat.PIXEL_FORMAT_R8G8_UNORM : PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM;
+
+    // Output channels fill red, green, blue, alpha in order; alpha defaults opaque.
+    const outputs = ["r", "g", "b", "a"];
+    let slot = 0;
+    for (const {
+      path,
+      channels
+    } of sources) {
+      for (const letter of channels) {
+        pack[outputs[slot++]] = Object.assign(new Tr2TexturePackChannel(), {
+          path,
+          channel: CHANNEL_INDEX[letter]
+        });
+      }
+    }
+    for (; slot < 4; slot++) {
+      pack[outputs[slot]] = Object.assign(new Tr2TexturePackChannel(), {
+        fill: outputs[slot] === "a" ? 255 : 0
+      });
+    }
+    const pipeline = new Tr2TexturePipeline();
+    pipeline.steps = [new CjsTexturePipelineStepConvert(), new CjsTexturePipelineStepResize(), pack, new Tr2TexturePipelineStepGenerateMips()];
+    return pipeline;
+  }
+
+  /**
+   * Split a pack query into sources and the channels each gives.
+   *
+   * A path contains `:` itself (`res:/...`), so only a trailing `:` followed by
+   * one to four channel letters is read as a channel selection.
+   *
+   * @param {string} query The query.
+   * @returns {{path: string, channels: string[]}[]|null} Sources, or null when
+   *   malformed or when they add up to more than four channels.
+   */
+  static parseQuery(query) {
+    const sources = String(query).split(";").map(part => part.trim()).filter(part => part);
+    if (sources.length === 0) return null;
+    const parsed = sources.map(part => {
+      const match = /^(.*):([rgba]{1,4})$/i.exec(part);
+      return match ? {
+        path: match[1],
+        channels: [...match[2].toLowerCase()]
+      } : {
+        path: part,
+        channels: ["r"]
+      };
+    });
+    const total = parsed.reduce((sum, source) => sum + source.channels.length, 0);
+    return total >= 1 && total <= 4 && parsed.every(source => source.path) ? parsed : null;
+  }
+}
+
+/**
+ * Registers `dynamic:/texturepack` on a manager.
+ *
+ * @param {object} resourceManager Manager to register on.
+ * @returns {object} The same manager, for chaining.
+ */
+function RegisterTexturePack(resourceManager) {
+  resourceManager.RegisterResourceConstructor("texturepack", new CjsTexturePackConstructor(resourceManager));
+  return resourceManager;
+}
+
+export { CjsTexturePackConstructor, RegisterTexturePack, TexturePackPrefix };
+//# sourceMappingURL=CjsTexturePackConstructor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CjsTexturePackConstructor.js","sources":["../../../../src/resource/texture/CjsTexturePackConstructor.js"],"sourcesContent":["// Not Carbon: `dynamic:/texturepack` is ours, registered in\n// /docs/architecture/non-carbon-extensions.md. Carbon's dynamic constructors\n// (SolidColorTexture.cpp, GradientTexture.cpp) rasterize from values in the\n// query; this one composes other resources.\nimport { IBlueDynamicResourceConstructor } from \"#blue\";\nimport { PixelFormat } from \"#consts/render-context\";\nimport { TriTextureRes } from \"./TriTextureRes.js\";\nimport { Tr2TexturePipeline } from \"./Tr2TexturePipeline.js\";\nimport { CjsTexturePipelineStepPack } from \"./CjsTexturePipelineStepPack.js\";\nimport { Tr2TexturePackChannel } from \"./Tr2TexturePackChannel.js\";\nimport { Tr2TexturePipelineStepGenerateMips } from \"./Tr2TexturePipelineStepGenerateMips.js\";\nimport { CjsTexturePipelineStepConvert } from \"./CjsTexturePipelineStepConvert.js\";\nimport { CjsTexturePipelineStepResize } from \"./CjsTexturePipelineStepResize.js\";\n\n/** The prefix a pack path starts with. */\nexport const TexturePackPrefix = \"dynamic:/texturepack/\";\n\n/** Authored channel letters, in Carbon's RGBA authoring order. */\nconst CHANNEL_INDEX = { r: 0, g: 1, b: 2, a: 3 };\n\n/**\n * `dynamic:/texturepack/<source>;<source>...` - up to four channels packed\n * from separate images into one texture.\n *\n * Each source is a resource path, optionally followed by the channels to take\n * from it: `res:/a.dds:rg;res:/b.dds:rg` puts a's red and green into red and\n * green, and b's into blue and alpha. Without a suffix a source gives its red\n * channel, as the scalar maps this exists for store their value there. The\n * query becomes a Carbon texture-pipeline recipe - Convert, Resize, Pack,\n * GenerateMips - which the texture runs through Carbon's `.ctr` route.\n *\n * Kept in the cache after release: rebuilding means downloading and decoding\n * every source again.\n */\nexport class CjsTexturePackConstructor extends IBlueDynamicResourceConstructor\n{\n\n  /**\n   * @param {object} resourceManager The `CjsResMan` that loads the sources.\n   */\n  constructor(resourceManager)\n  {\n    super();\n    this._resourceManager = resourceManager;\n  }\n\n  /**\n   * A generated pack costs downloads and decodes to rebuild, so it is kept.\n   *\n   * @returns {boolean} Always true.\n   */\n  IsCacheable()\n  {\n    return true;\n  }\n\n  /**\n   * Build the texture a pack query describes. The recipe starts running at\n   * once; the texture is prepared when it finishes.\n   *\n   * @param {string} query Text after `dynamic:/texturepack/`.\n   * @returns {TriTextureRes} The texture resource.\n   */\n  GetResource(query)\n  {\n    const texture = new TriTextureRes();\n    texture.Initialize(TexturePackPrefix + query, \"\");\n\n    const pipeline = CjsTexturePackConstructor.buildRecipe(query);\n\n    if (!pipeline)\n    {\n      const error = new Error(`Failed to parse ${TexturePackPrefix}${query} texture path`);\n      error.code = \"CJS_TEXTURE_PROCEDURAL_PATH_INVALID\";\n      texture.SetError(error);\n      return texture;\n    }\n\n    texture.LoadPipeline(pipeline, this._resourceManager);\n    return texture;\n  }\n\n  /**\n   * The recipe for a pack query, or null when it is malformed.\n   *\n   * @param {string} query `source[:channels];source[:channels]...`\n   * @returns {Tr2TexturePipeline|null} The recipe.\n   */\n  static buildRecipe(query)\n  {\n    const sources = CjsTexturePackConstructor.parseQuery(query);\n\n    if (!sources) return null;\n\n    const channelCount = sources.reduce((sum, source) => sum + source.channels.length, 0);\n    const pack = new CjsTexturePipelineStepPack();\n\n    // The narrowest output that holds the channels: one byte a texel for one,\n    // two for two, BGRA for three or four.\n    pack.format = channelCount === 1 ? PixelFormat.PIXEL_FORMAT_R8_UNORM\n      : channelCount === 2 ? PixelFormat.PIXEL_FORMAT_R8G8_UNORM\n        : PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM;\n\n    // Output channels fill red, green, blue, alpha in order; alpha defaults opaque.\n    const outputs = [ \"r\", \"g\", \"b\", \"a\" ];\n    let slot = 0;\n\n    for (const { path, channels } of sources)\n    {\n      for (const letter of channels)\n      {\n        pack[outputs[slot++]] = Object.assign(new Tr2TexturePackChannel(), { path, channel: CHANNEL_INDEX[letter] });\n      }\n    }\n\n    for (; slot < 4; slot++)\n    {\n      pack[outputs[slot]] = Object.assign(new Tr2TexturePackChannel(), { fill: outputs[slot] === \"a\" ? 255 : 0 });\n    }\n\n    const pipeline = new Tr2TexturePipeline();\n    pipeline.steps = [\n      new CjsTexturePipelineStepConvert(),\n      new CjsTexturePipelineStepResize(),\n      pack,\n      new Tr2TexturePipelineStepGenerateMips()\n    ];\n    return pipeline;\n  }\n\n  /**\n   * Split a pack query into sources and the channels each gives.\n   *\n   * A path contains `:` itself (`res:/...`), so only a trailing `:` followed by\n   * one to four channel letters is read as a channel selection.\n   *\n   * @param {string} query The query.\n   * @returns {{path: string, channels: string[]}[]|null} Sources, or null when\n   *   malformed or when they add up to more than four channels.\n   */\n  static parseQuery(query)\n  {\n    const sources = String(query).split(\";\").map(part => part.trim()).filter(part => part);\n\n    if (sources.length === 0) return null;\n\n    const parsed = sources.map(part =>\n    {\n      const match = /^(.*):([rgba]{1,4})$/i.exec(part);\n      return match\n        ? { path: match[1], channels: [ ...match[2].toLowerCase() ] }\n        : { path: part, channels: [ \"r\" ] };\n    });\n\n    const total = parsed.reduce((sum, source) => sum + source.channels.length, 0);\n    return total >= 1 && total <= 4 && parsed.every(source => source.path) ? parsed : null;\n  }\n\n}\n\n/**\n * Registers `dynamic:/texturepack` on a manager.\n *\n * @param {object} resourceManager Manager to register on.\n * @returns {object} The same manager, for chaining.\n */\nexport function RegisterTexturePack(resourceManager)\n{\n  resourceManager.RegisterResourceConstructor(\"texturepack\", new CjsTexturePackConstructor(resourceManager));\n  return resourceManager;\n}\n"],"names":["TexturePackPrefix","CHANNEL_INDEX","r","g","b","a","CjsTexturePackConstructor","IBlueDynamicResourceConstructor","constructor","resourceManager","_resourceManager","IsCacheable","GetResource","query","texture","TriTextureRes","Initialize","pipeline","buildRecipe","error","Error","code","SetError","LoadPipeline","sources","parseQuery","channelCount","reduce","sum","source","channels","length","pack","CjsTexturePipelineStepPack","format","PixelFormat","PIXEL_FORMAT_R8_UNORM","PIXEL_FORMAT_R8G8_UNORM","PIXEL_FORMAT_B8G8R8A8_UNORM","outputs","slot","path","letter","Object","assign","Tr2TexturePackChannel","channel","fill","Tr2TexturePipeline","steps","CjsTexturePipelineStepConvert","CjsTexturePipelineStepResize","Tr2TexturePipelineStepGenerateMips","String","split","map","part","trim","filter","parsed","match","exec","toLowerCase","total","every","RegisterTexturePack","RegisterResourceConstructor"],"mappings":"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"}

package/dist/resource/texture/CjsTexturePipelineStepArray.js

@@ -0,0 +1,72 @@
+import { CjsSchema, impl, edit, type } from '#schema';
+import { CjsModel } from '#model';
+
+// Not Carbon. A texture-pipeline step of our own, registered in
+// /docs/architecture/non-carbon-extensions.md.
+
+/**
+ * Stacks the named inputs, in order, into one 2D texture array: layer 0 is the
+ * first path.
+ *
+ * Carbon's pipeline has no array step - Carbon's arrays arrive as authored
+ * files or are grown element by element (`Tr2TextureArray`). We assemble one
+ * from separate images for `dynamic:/texturearray`, so a family of maps (the
+ * Detail1Map..Detail3Map kind) binds as one sampler on WebGL2's 16-unit budget
+ * while the effect keeps its named parameters.
+ *
+ * The layers must already match in format, size and mip count - run
+ * `CjsTexturePipelineStepConvert` and `CjsTexturePipelineStepResize` first.
+ */
+class CjsTexturePipelineStepArray extends CjsModel {
+  /** Layer paths, layer 0 first. */
+  paths = [];
+
+  /**
+   * Every layer is a resource this step reads.
+   *
+   * @param {Set<string>} [resources] Caller-owned; allocated when omitted.
+   * @returns {Set<string>} The set.
+   */
+  GetResourceDependencies(resources = new Set()) {
+    for (const path of this.paths) resources.add(String(path));
+    return resources;
+  }
+
+  /**
+   * Build the array into the pipeline's bitmap.
+   *
+   * @param {import("#imageio").HostBitmap} bitmap The pipeline's bitmap.
+   * @param {Map<string, import("#imageio").HostBitmap>} inputs Loaded inputs by path.
+   * @returns {boolean} False when a layer is missing or the layers do not match.
+   */
+  Execute(bitmap, inputs) {
+    const layers = this.paths.map(path => inputs.get(String(path)));
+    if (!layers.length || layers.some(layer => !layer)) return false;
+    const [first] = layers;
+    const mips = first.GetTrueMipCount();
+    for (const layer of layers) {
+      if (layer.GetFormat() !== first.GetFormat() || layer.GetWidth() !== first.GetWidth() || layer.GetHeight() !== first.GetHeight() || layer.GetTrueMipCount() !== mips || layer.GetArraySize() > 1) return false;
+    }
+    if (!bitmap.Create2DArray(first.GetWidth(), first.GetHeight(), mips, layers.length, first.GetFormat())) return false;
+    for (let index = 0; index < layers.length; index++) {
+      for (let mip = 0; mip < mips; mip++) {
+        bitmap.GetMipRawData(mip, index).set(layers[index].GetMipRawData(mip).subarray(0, layers[index].GetMipSize(mip)));
+      }
+    }
+    return true;
+  }
+}
+CjsSchema.define(CjsTexturePipelineStepArray, {
+  className: "CjsTexturePipelineStepArray",
+  family: "resources",
+  fields: {
+    paths: [edit.persist, type.list("string")]
+  },
+  methods: {
+    GetResourceDependencies: impl.custom,
+    Execute: impl.custom
+  }
+});
+
+export { CjsTexturePipelineStepArray };
+//# sourceMappingURL=CjsTexturePipelineStepArray.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CjsTexturePipelineStepArray.js","sources":["../../../../src/resource/texture/CjsTexturePipelineStepArray.js"],"sourcesContent":["// Not Carbon. A texture-pipeline step of our own, registered in\n// /docs/architecture/non-carbon-extensions.md.\nimport { CjsSchema, edit, impl, type } from \"#schema\";\nimport { CjsModel } from \"#model\";\n\n/**\n * Stacks the named inputs, in order, into one 2D texture array: layer 0 is the\n * first path.\n *\n * Carbon's pipeline has no array step - Carbon's arrays arrive as authored\n * files or are grown element by element (`Tr2TextureArray`). We assemble one\n * from separate images for `dynamic:/texturearray`, so a family of maps (the\n * Detail1Map..Detail3Map kind) binds as one sampler on WebGL2's 16-unit budget\n * while the effect keeps its named parameters.\n *\n * The layers must already match in format, size and mip count - run\n * `CjsTexturePipelineStepConvert` and `CjsTexturePipelineStepResize` first.\n */\nexport class CjsTexturePipelineStepArray extends CjsModel\n{\n\n  /** Layer paths, layer 0 first. */\n  paths = [];\n\n  /**\n   * Every layer is a resource this step reads.\n   *\n   * @param {Set<string>} [resources] Caller-owned; allocated when omitted.\n   * @returns {Set<string>} The set.\n   */\n  GetResourceDependencies(resources = new Set())\n  {\n    for (const path of this.paths) resources.add(String(path));\n    return resources;\n  }\n\n  /**\n   * Build the array into the pipeline's bitmap.\n   *\n   * @param {import(\"#imageio\").HostBitmap} bitmap The pipeline's bitmap.\n   * @param {Map<string, import(\"#imageio\").HostBitmap>} inputs Loaded inputs by path.\n   * @returns {boolean} False when a layer is missing or the layers do not match.\n   */\n  Execute(bitmap, inputs)\n  {\n    const layers = this.paths.map(path => inputs.get(String(path)));\n\n    if (!layers.length || layers.some(layer => !layer)) return false;\n\n    const [ first ] = layers;\n    const mips = first.GetTrueMipCount();\n\n    for (const layer of layers)\n    {\n      if (layer.GetFormat() !== first.GetFormat()\n        || layer.GetWidth() !== first.GetWidth()\n        || layer.GetHeight() !== first.GetHeight()\n        || layer.GetTrueMipCount() !== mips\n        || layer.GetArraySize() > 1) return false;\n    }\n\n    if (!bitmap.Create2DArray(first.GetWidth(), first.GetHeight(), mips, layers.length, first.GetFormat())) return false;\n\n    for (let index = 0; index < layers.length; index++)\n    {\n      for (let mip = 0; mip < mips; mip++)\n      {\n        bitmap.GetMipRawData(mip, index).set(layers[index].GetMipRawData(mip).subarray(0, layers[index].GetMipSize(mip)));\n      }\n    }\n    return true;\n  }\n\n}\n\nCjsSchema.define(CjsTexturePipelineStepArray, {\n  className: \"CjsTexturePipelineStepArray\", family: \"resources\",\n  fields: {\n    paths: [ edit.persist, type.list(\"string\") ]\n  },\n  methods: {\n    GetResourceDependencies: impl.custom,\n    Execute: impl.custom\n  }\n});\n"],"names":["CjsTexturePipelineStepArray","CjsModel","paths","GetResourceDependencies","resources","Set","path","add","String","Execute","bitmap","inputs","layers","map","get","length","some","layer","first","mips","GetTrueMipCount","GetFormat","GetWidth","GetHeight","GetArraySize","Create2DArray","index","mip","GetMipRawData","set","subarray","GetMipSize","CjsSchema","define","className","family","fields","edit","persist","type","list","methods","impl","custom"],"mappings":"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"}

package/dist/resource/texture/CjsTexturePipelineStepConvert.js

@@ -0,0 +1,73 @@
+import { CjsSchema, impl, edit, type } from '#schema';
+import { CjsModel } from '#model';
+import { HostBitmap } from '#imageio';
+import { PixelFormat } from '#consts/render-context';
+import { CjsImageFormat } from '../format/CjsImageFormat.js';
+
+// Not Carbon. A texture-pipeline step of our own, registered in
+// /docs/architecture/non-carbon-extensions.md.
+
+/**
+ * Converts the pipeline's INPUTS to one pixel format before a later step reads
+ * them - block formats decoded - so a `Pack` over EVE's compressed maps works.
+ *
+ * Carbon's `Tr2TexturePipelineStepPack` reads raw bytes and refuses block
+ * formats, so in Carbon a pack of DXT1/BC4 sources fails. We decode on the CPU
+ * because a browser cannot read a compressed texture back from the GPU.
+ *
+ * Each converted input is a COPY that replaces its entry in the pipeline's
+ * `inputs` map, so the cached source bitmap is never changed.
+ */
+class CjsTexturePipelineStepConvert extends CjsModel {
+  /** The pixel format every named input is converted to. */
+  format = PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM;
+
+  /** Input paths to convert; empty converts every input. */
+  paths = [];
+
+  /**
+   * Names no resources: it works on inputs other steps name.
+   *
+   * @param {Set<string>} [resources] Caller-owned; allocated when omitted.
+   * @returns {Set<string>} The set, unchanged.
+   */
+  GetResourceDependencies(resources = new Set()) {
+    return resources;
+  }
+
+  /**
+   * Replace each named input with a converted copy.
+   *
+   * @param {HostBitmap} _bitmap The pipeline's bitmap (unused).
+   * @param {Map<string, HostBitmap>} inputs Loaded inputs by path; entries are replaced.
+   * @returns {boolean} False when an input is missing or cannot be converted.
+   */
+  Execute(_bitmap, inputs) {
+    for (const path of this.paths.length ? this.paths : [...inputs.keys()]) {
+      const source = inputs.get(path);
+      if (!source) return false;
+      if (source.GetFormat() === this.format) continue;
+      const copy = new HostBitmap();
+      if (!copy.CreateFromBitmapDimensions(source)) return false;
+      copy.GetRawData().set(source.GetRawData());
+      if (!CjsImageFormat.convertImage(copy, this.format)) return false;
+      inputs.set(path, copy);
+    }
+    return true;
+  }
+}
+CjsSchema.define(CjsTexturePipelineStepConvert, {
+  className: "CjsTexturePipelineStepConvert",
+  family: "resources",
+  fields: {
+    format: [edit.persist, type.int32, type.enum("PixelFormat")],
+    paths: [edit.persist, type.list("string")]
+  },
+  methods: {
+    GetResourceDependencies: impl.custom,
+    Execute: impl.custom
+  }
+});
+
+export { CjsTexturePipelineStepConvert };
+//# sourceMappingURL=CjsTexturePipelineStepConvert.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CjsTexturePipelineStepConvert.js","sources":["../../../../src/resource/texture/CjsTexturePipelineStepConvert.js"],"sourcesContent":["// Not Carbon. A texture-pipeline step of our own, registered in\n// /docs/architecture/non-carbon-extensions.md.\nimport { CjsSchema, edit, impl, type } from \"#schema\";\nimport { CjsModel } from \"#model\";\nimport { HostBitmap } from \"#imageio\";\nimport { PixelFormat } from \"#consts/render-context\";\nimport { CjsImageFormat } from \"../format/CjsImageFormat.js\";\n\n/**\n * Converts the pipeline's INPUTS to one pixel format before a later step reads\n * them - block formats decoded - so a `Pack` over EVE's compressed maps works.\n *\n * Carbon's `Tr2TexturePipelineStepPack` reads raw bytes and refuses block\n * formats, so in Carbon a pack of DXT1/BC4 sources fails. We decode on the CPU\n * because a browser cannot read a compressed texture back from the GPU.\n *\n * Each converted input is a COPY that replaces its entry in the pipeline's\n * `inputs` map, so the cached source bitmap is never changed.\n */\nexport class CjsTexturePipelineStepConvert extends CjsModel\n{\n\n  /** The pixel format every named input is converted to. */\n  format = PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM;\n\n  /** Input paths to convert; empty converts every input. */\n  paths = [];\n\n  /**\n   * Names no resources: it works on inputs other steps name.\n   *\n   * @param {Set<string>} [resources] Caller-owned; allocated when omitted.\n   * @returns {Set<string>} The set, unchanged.\n   */\n  GetResourceDependencies(resources = new Set())\n  {\n    return resources;\n  }\n\n  /**\n   * Replace each named input with a converted copy.\n   *\n   * @param {HostBitmap} _bitmap The pipeline's bitmap (unused).\n   * @param {Map<string, HostBitmap>} inputs Loaded inputs by path; entries are replaced.\n   * @returns {boolean} False when an input is missing or cannot be converted.\n   */\n  Execute(_bitmap, inputs)\n  {\n    for (const path of this.paths.length ? this.paths : [ ...inputs.keys() ])\n    {\n      const source = inputs.get(path);\n\n      if (!source) return false;\n      if (source.GetFormat() === this.format) continue;\n\n      const copy = new HostBitmap();\n      if (!copy.CreateFromBitmapDimensions(source)) return false;\n      copy.GetRawData().set(source.GetRawData());\n\n      if (!CjsImageFormat.convertImage(copy, this.format)) return false;\n\n      inputs.set(path, copy);\n    }\n    return true;\n  }\n\n}\n\nCjsSchema.define(CjsTexturePipelineStepConvert, {\n  className: \"CjsTexturePipelineStepConvert\", family: \"resources\",\n  fields: {\n    format: [ edit.persist, type.int32, type.enum(\"PixelFormat\") ],\n    paths: [ edit.persist, type.list(\"string\") ]\n  },\n  methods: {\n    GetResourceDependencies: impl.custom,\n    Execute: impl.custom\n  }\n});\n"],"names":["CjsTexturePipelineStepConvert","CjsModel","format","PixelFormat","PIXEL_FORMAT_B8G8R8A8_UNORM","paths","GetResourceDependencies","resources","Set","Execute","_bitmap","inputs","path","length","keys","source","get","GetFormat","copy","HostBitmap","CreateFromBitmapDimensions","GetRawData","set","CjsImageFormat","convertImage","CjsSchema","define","className","family","fields","edit","persist","type","int32","enum","list","methods","impl","custom"],"mappings":";;;;;;AAAA;AACA;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,6BAA6B,SAASC,QAAQ,CAC3D;AAEE;EACAC,MAAM,GAAGC,WAAW,CAACC,2BAA2B;;AAEhD;AACAC,EAAAA,KAAK,GAAG,EAAE;;AAEV;AACF;AACA;AACA;AACA;AACA;AACEC,EAAAA,uBAAuBA,CAACC,SAAS,GAAG,IAAIC,GAAG,EAAE,EAC7C;AACE,IAAA,OAAOD,SAAS;AAClB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACEE,EAAAA,OAAOA,CAACC,OAAO,EAAEC,MAAM,EACvB;IACE,KAAK,MAAMC,IAAI,IAAI,IAAI,CAACP,KAAK,CAACQ,MAAM,GAAG,IAAI,CAACR,KAAK,GAAG,CAAE,GAAGM,MAAM,CAACG,IAAI,EAAE,CAAE,EACxE;AACE,MAAA,MAAMC,MAAM,GAAGJ,MAAM,CAACK,GAAG,CAACJ,IAAI,CAAC;AAE/B,MAAA,IAAI,CAACG,MAAM,EAAE,OAAO,KAAK;MACzB,IAAIA,MAAM,CAACE,SAAS,EAAE,KAAK,IAAI,CAACf,MAAM,EAAE;AAExC,MAAA,MAAMgB,IAAI,GAAG,IAAIC,UAAU,EAAE;MAC7B,IAAI,CAACD,IAAI,CAACE,0BAA0B,CAACL,MAAM,CAAC,EAAE,OAAO,KAAK;AAC1DG,MAAAA,IAAI,CAACG,UAAU,EAAE,CAACC,GAAG,CAACP,MAAM,CAACM,UAAU,EAAE,CAAC;AAE1C,MAAA,IAAI,CAACE,cAAc,CAACC,YAAY,CAACN,IAAI,EAAE,IAAI,CAAChB,MAAM,CAAC,EAAE,OAAO,KAAK;AAEjES,MAAAA,MAAM,CAACW,GAAG,CAACV,IAAI,EAAEM,IAAI,CAAC;AACxB,IAAA;AACA,IAAA,OAAO,IAAI;AACb,EAAA;AAEF;AAEAO,SAAS,CAACC,MAAM,CAAC1B,6BAA6B,EAAE;AAC9C2B,EAAAA,SAAS,EAAE,+BAA+B;AAAEC,EAAAA,MAAM,EAAE,WAAW;AAC/DC,EAAAA,MAAM,EAAE;AACN3B,IAAAA,MAAM,EAAE,CAAE4B,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACC,KAAK,EAAED,IAAI,CAACE,IAAI,CAAC,aAAa,CAAC,CAAE;IAC9D7B,KAAK,EAAE,CAAEyB,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACG,IAAI,CAAC,QAAQ,CAAC;GAC3C;AACDC,EAAAA,OAAO,EAAE;IACP9B,uBAAuB,EAAE+B,IAAI,CAACC,MAAM;IACpC7B,OAAO,EAAE4B,IAAI,CAACC;AAChB;AACF,CAAC,CAAC;;;;"}

package/dist/resource/texture/CjsTexturePipelineStepPack.js

@@ -0,0 +1,71 @@
+import { CjsSchema, impl, edit, type } from '#schema';
+import { HostBitmap } from '#imageio';
+import { PixelFormat } from '#consts/render-context';
+import { Tr2TexturePipelineStepPack } from './Tr2TexturePipelineStepPack.js';
+
+// Not Carbon. A texture-pipeline step of our own, registered in
+// /docs/architecture/non-carbon-extensions.md.
+
+/**
+ * Our packer: Carbon's `Tr2TexturePipelineStepPack`, plus output formats
+ * Carbon's does not write.
+ *
+ * Carbon's Pack writes BGRA, BGRX or R8. A pair of channels packed into BGRA
+ * costs four bytes a texel to carry two; this writes `PIXEL_FORMAT_R8G8_UNORM`
+ * at two (operator ruling, 2026-09-24). Carbon's formats pass straight through
+ * to Carbon's step, which is left exactly as Carbon has it.
+ *
+ * Same records as Carbon's: r, g, b and a are `Tr2TexturePackChannel`s. For RG8
+ * only r and g are written.
+ */
+class CjsTexturePipelineStepPack extends Tr2TexturePipelineStepPack {
+  /**
+   * Pack the channels; RG8 here, every other format by Carbon's step.
+   *
+   * RG8 is built from Carbon's own BGRA pack - whose red and green bytes are
+   * the r and g channels - so input lookup, size checks and mips are Carbon's.
+   *
+   * @param {HostBitmap} bitmap The pipeline's bitmap.
+   * @param {Map<string, HostBitmap>} inputs Loaded inputs by path.
+   * @param {object} [params] Pipeline parameters.
+   * @returns {boolean} Whether the step succeeded.
+   */
+  Execute(bitmap, inputs, params) {
+    if (this.format !== PixelFormat.PIXEL_FORMAT_R8G8_UNORM) return super.Execute(bitmap, inputs, params);
+    const bgra = new HostBitmap();
+    const format = this.format;
+    this.format = PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM;
+    const packed = super.Execute(bgra, inputs, params);
+    this.format = format;
+    if (!packed) return false;
+    const mips = bgra.GetTrueMipCount();
+    if (!bitmap.Create(bgra.GetWidth(), bgra.GetHeight(), mips, format)) return false;
+    for (let mip = 0; mip < mips; mip++) {
+      const from = bgra.GetMipRawData(mip);
+      const fromPitch = bgra.GetMipPitch(mip);
+      const to = bitmap.GetMipRawData(mip);
+      const toPitch = bitmap.GetMipPitch(mip);
+      for (let y = 0; y < bgra.GetMipHeight(mip); y++) {
+        for (let x = 0; x < bgra.GetMipWidth(mip); x++) {
+          // BGRA memory: red is byte 2, green byte 1.
+          to[y * toPitch + x * 2] = from[y * fromPitch + x * 4 + 2];
+          to[y * toPitch + x * 2 + 1] = from[y * fromPitch + x * 4 + 1];
+        }
+      }
+    }
+    return true;
+  }
+}
+CjsSchema.define(CjsTexturePipelineStepPack, {
+  className: "CjsTexturePipelineStepPack",
+  family: "resources",
+  fields: {
+    format: [edit.persist, type.int32, type.enum("PixelFormat")]
+  },
+  methods: {
+    Execute: impl.custom
+  }
+});
+
+export { CjsTexturePipelineStepPack };
+//# sourceMappingURL=CjsTexturePipelineStepPack.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CjsTexturePipelineStepPack.js","sources":["../../../../src/resource/texture/CjsTexturePipelineStepPack.js"],"sourcesContent":["// Not Carbon. A texture-pipeline step of our own, registered in\n// /docs/architecture/non-carbon-extensions.md.\nimport { CjsSchema, edit, impl, type } from \"#schema\";\nimport { HostBitmap } from \"#imageio\";\nimport { PixelFormat } from \"#consts/render-context\";\nimport { Tr2TexturePipelineStepPack } from \"./Tr2TexturePipelineStepPack.js\";\n\n/**\n * Our packer: Carbon's `Tr2TexturePipelineStepPack`, plus output formats\n * Carbon's does not write.\n *\n * Carbon's Pack writes BGRA, BGRX or R8. A pair of channels packed into BGRA\n * costs four bytes a texel to carry two; this writes `PIXEL_FORMAT_R8G8_UNORM`\n * at two (operator ruling, 2026-09-24). Carbon's formats pass straight through\n * to Carbon's step, which is left exactly as Carbon has it.\n *\n * Same records as Carbon's: r, g, b and a are `Tr2TexturePackChannel`s. For RG8\n * only r and g are written.\n */\nexport class CjsTexturePipelineStepPack extends Tr2TexturePipelineStepPack\n{\n\n  /**\n   * Pack the channels; RG8 here, every other format by Carbon's step.\n   *\n   * RG8 is built from Carbon's own BGRA pack - whose red and green bytes are\n   * the r and g channels - so input lookup, size checks and mips are Carbon's.\n   *\n   * @param {HostBitmap} bitmap The pipeline's bitmap.\n   * @param {Map<string, HostBitmap>} inputs Loaded inputs by path.\n   * @param {object} [params] Pipeline parameters.\n   * @returns {boolean} Whether the step succeeded.\n   */\n  Execute(bitmap, inputs, params)\n  {\n    if (this.format !== PixelFormat.PIXEL_FORMAT_R8G8_UNORM) return super.Execute(bitmap, inputs, params);\n\n    const bgra = new HostBitmap();\n    const format = this.format;\n\n    this.format = PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM;\n    const packed = super.Execute(bgra, inputs, params);\n    this.format = format;\n\n    if (!packed) return false;\n\n    const mips = bgra.GetTrueMipCount();\n\n    if (!bitmap.Create(bgra.GetWidth(), bgra.GetHeight(), mips, format)) return false;\n\n    for (let mip = 0; mip < mips; mip++)\n    {\n      const from = bgra.GetMipRawData(mip);\n      const fromPitch = bgra.GetMipPitch(mip);\n      const to = bitmap.GetMipRawData(mip);\n      const toPitch = bitmap.GetMipPitch(mip);\n\n      for (let y = 0; y < bgra.GetMipHeight(mip); y++)\n      {\n        for (let x = 0; x < bgra.GetMipWidth(mip); x++)\n        {\n          // BGRA memory: red is byte 2, green byte 1.\n          to[y * toPitch + x * 2] = from[y * fromPitch + x * 4 + 2];\n          to[y * toPitch + x * 2 + 1] = from[y * fromPitch + x * 4 + 1];\n        }\n      }\n    }\n    return true;\n  }\n\n}\n\nCjsSchema.define(CjsTexturePipelineStepPack, {\n  className: \"CjsTexturePipelineStepPack\", family: \"resources\",\n  fields: {\n    format: [ edit.persist, type.int32, type.enum(\"PixelFormat\") ]\n  },\n  methods: {\n    Execute: impl.custom\n  }\n});\n"],"names":["CjsTexturePipelineStepPack","Tr2TexturePipelineStepPack","Execute","bitmap","inputs","params","format","PixelFormat","PIXEL_FORMAT_R8G8_UNORM","bgra","HostBitmap","PIXEL_FORMAT_B8G8R8A8_UNORM","packed","mips","GetTrueMipCount","Create","GetWidth","GetHeight","mip","from","GetMipRawData","fromPitch","GetMipPitch","to","toPitch","y","GetMipHeight","x","GetMipWidth","CjsSchema","define","className","family","fields","edit","persist","type","int32","enum","methods","impl","custom"],"mappings":";;;;;AAAA;AACA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,0BAA0B,SAASC,0BAA0B,CAC1E;AAEE;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,OAAOA,CAACC,MAAM,EAAEC,MAAM,EAAEC,MAAM,EAC9B;AACE,IAAA,IAAI,IAAI,CAACC,MAAM,KAAKC,WAAW,CAACC,uBAAuB,EAAE,OAAO,KAAK,CAACN,OAAO,CAACC,MAAM,EAAEC,MAAM,EAAEC,MAAM,CAAC;AAErG,IAAA,MAAMI,IAAI,GAAG,IAAIC,UAAU,EAAE;AAC7B,IAAA,MAAMJ,MAAM,GAAG,IAAI,CAACA,MAAM;AAE1B,IAAA,IAAI,CAACA,MAAM,GAAGC,WAAW,CAACI,2BAA2B;IACrD,MAAMC,MAAM,GAAG,KAAK,CAACV,OAAO,CAACO,IAAI,EAAEL,MAAM,EAAEC,MAAM,CAAC;IAClD,IAAI,CAACC,MAAM,GAAGA,MAAM;AAEpB,IAAA,IAAI,CAACM,MAAM,EAAE,OAAO,KAAK;AAEzB,IAAA,MAAMC,IAAI,GAAGJ,IAAI,CAACK,eAAe,EAAE;IAEnC,IAAI,CAACX,MAAM,CAACY,MAAM,CAACN,IAAI,CAACO,QAAQ,EAAE,EAAEP,IAAI,CAACQ,SAAS,EAAE,EAAEJ,IAAI,EAAEP,MAAM,CAAC,EAAE,OAAO,KAAK;IAEjF,KAAK,IAAIY,GAAG,GAAG,CAAC,EAAEA,GAAG,GAAGL,IAAI,EAAEK,GAAG,EAAE,EACnC;AACE,MAAA,MAAMC,IAAI,GAAGV,IAAI,CAACW,aAAa,CAACF,GAAG,CAAC;AACpC,MAAA,MAAMG,SAAS,GAAGZ,IAAI,CAACa,WAAW,CAACJ,GAAG,CAAC;AACvC,MAAA,MAAMK,EAAE,GAAGpB,MAAM,CAACiB,aAAa,CAACF,GAAG,CAAC;AACpC,MAAA,MAAMM,OAAO,GAAGrB,MAAM,CAACmB,WAAW,CAACJ,GAAG,CAAC;AAEvC,MAAA,KAAK,IAAIO,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGhB,IAAI,CAACiB,YAAY,CAACR,GAAG,CAAC,EAAEO,CAAC,EAAE,EAC/C;AACE,QAAA,KAAK,IAAIE,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGlB,IAAI,CAACmB,WAAW,CAACV,GAAG,CAAC,EAAES,CAAC,EAAE,EAC9C;AACE;UACAJ,EAAE,CAACE,CAAC,GAAGD,OAAO,GAAGG,CAAC,GAAG,CAAC,CAAC,GAAGR,IAAI,CAACM,CAAC,GAAGJ,SAAS,GAAGM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;UACzDJ,EAAE,CAACE,CAAC,GAAGD,OAAO,GAAGG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAGR,IAAI,CAACM,CAAC,GAAGJ,SAAS,GAAGM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC/D,QAAA;AACF,MAAA;AACF,IAAA;AACA,IAAA,OAAO,IAAI;AACb,EAAA;AAEF;AAEAE,SAAS,CAACC,MAAM,CAAC9B,0BAA0B,EAAE;AAC3C+B,EAAAA,SAAS,EAAE,4BAA4B;AAAEC,EAAAA,MAAM,EAAE,WAAW;AAC5DC,EAAAA,MAAM,EAAE;AACN3B,IAAAA,MAAM,EAAE,CAAE4B,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACC,KAAK,EAAED,IAAI,CAACE,IAAI,CAAC,aAAa,CAAC;GAC7D;AACDC,EAAAA,OAAO,EAAE;IACPrC,OAAO,EAAEsC,IAAI,CAACC;AAChB;AACF,CAAC,CAAC;;;;"}

package/dist/resource/texture/CjsTexturePipelineStepResize.js

@@ -0,0 +1,123 @@
+import { CjsSchema, impl, edit, type } from '#schema';
+import { CjsModel } from '#model';
+import { HostBitmap } from '#imageio';
+import { IsCompressedFormat, GetBytesPerPixel } from '#consts/render-context';
+
+// Not Carbon. A texture-pipeline step of our own, registered in
+// /docs/architecture/non-carbon-extensions.md.
+
+/**
+ * Resamples the pipeline's INPUTS to one size before a later step reads them.
+ *
+ * Carbon's `Tr2TexturePipelineStepPack` refuses inputs of different sizes: CCP
+ * packs in a controlled pipeline over sources it authors. We join files we do
+ * not control, by our own choice, so matching their sizes is our job. With no
+ * size set, every input is resampled up to the largest one.
+ *
+ * Bilinear, on the top mip, for uncompressed byte formats - run
+ * `CjsTexturePipelineStepConvert` first for block formats. The result has one
+ * mip; add `Tr2TexturePipelineStepGenerateMips` after the pack for a chain.
+ * Each resized input is a COPY that replaces its entry in the pipeline's
+ * `inputs` map, so the cached source bitmap is never changed.
+ */
+class CjsTexturePipelineStepResize extends CjsModel {
+  /** Target width; 0 takes the widest input. */
+  width = 0;
+
+  /** Target height; 0 takes the tallest input. */
+  height = 0;
+
+  /** Input paths to resize; empty resizes every input. */
+  paths = [];
+
+  /**
+   * Names no resources: it works on inputs other steps name.
+   *
+   * @param {Set<string>} [resources] Caller-owned; allocated when omitted.
+   * @returns {Set<string>} The set, unchanged.
+   */
+  GetResourceDependencies(resources = new Set()) {
+    return resources;
+  }
+
+  /**
+   * Replace each named input with a copy at the target size.
+   *
+   * @param {HostBitmap} _bitmap The pipeline's bitmap (unused).
+   * @param {Map<string, HostBitmap>} inputs Loaded inputs by path; entries are replaced.
+   * @returns {boolean} False when an input is missing or cannot be resampled.
+   */
+  Execute(_bitmap, inputs) {
+    const paths = this.paths.length ? this.paths : [...inputs.keys()];
+    const sources = paths.map(path => inputs.get(path));
+    if (sources.some(source => !source)) return false;
+    const width = this.width || Math.max(...sources.map(source => source.GetWidth()));
+    const height = this.height || Math.max(...sources.map(source => source.GetHeight()));
+    for (let index = 0; index < paths.length; index++) {
+      const source = sources[index];
+      if (source.GetWidth() === width && source.GetHeight() === height && source.GetTrueMipCount() === 1) continue;
+      const resized = CjsTexturePipelineStepResize.resample(source, width, height);
+      if (!resized) return false;
+      inputs.set(paths[index], resized);
+    }
+    return true;
+  }
+
+  /**
+   * Bilinear resample of a bitmap's top mip into a new one-mip bitmap.
+   *
+   * @param {HostBitmap} source Uncompressed byte-per-channel bitmap.
+   * @param {number} width Target width.
+   * @param {number} height Target height.
+   * @returns {HostBitmap|null} The resampled copy, or null for an unsupported format.
+   */
+  static resample(source, width, height) {
+    const format = source.GetFormat();
+    if (IsCompressedFormat(format)) return null;
+    const channels = GetBytesPerPixel(format);
+    const result = new HostBitmap();
+    if (!result.Create(width, height, 1, format)) return null;
+    const sourceWidth = source.GetWidth();
+    const sourceHeight = source.GetHeight();
+    const from = source.GetMipRawData(0);
+    const fromPitch = source.GetMipPitch(0);
+    const to = result.GetMipRawData(0);
+    const toPitch = result.GetMipPitch(0);
+    for (let y = 0; y < height; y++) {
+      // Pixel centres map to pixel centres.
+      const sy = Math.min(Math.max((y + 0.5) * sourceHeight / height - 0.5, 0), sourceHeight - 1);
+      const y0 = Math.floor(sy);
+      const y1 = Math.min(y0 + 1, sourceHeight - 1);
+      const fy = sy - y0;
+      for (let x = 0; x < width; x++) {
+        const sx = Math.min(Math.max((x + 0.5) * sourceWidth / width - 0.5, 0), sourceWidth - 1);
+        const x0 = Math.floor(sx);
+        const x1 = Math.min(x0 + 1, sourceWidth - 1);
+        const fx = sx - x0;
+        for (let c = 0; c < channels; c++) {
+          const top = from[y0 * fromPitch + x0 * channels + c] * (1 - fx) + from[y0 * fromPitch + x1 * channels + c] * fx;
+          const bottom = from[y1 * fromPitch + x0 * channels + c] * (1 - fx) + from[y1 * fromPitch + x1 * channels + c] * fx;
+          to[y * toPitch + x * channels + c] = Math.round(top * (1 - fy) + bottom * fy);
+        }
+      }
+    }
+    return result;
+  }
+}
+CjsSchema.define(CjsTexturePipelineStepResize, {
+  className: "CjsTexturePipelineStepResize",
+  family: "resources",
+  fields: {
+    width: [edit.persist, type.uint32],
+    height: [edit.persist, type.uint32],
+    paths: [edit.persist, type.list("string")]
+  },
+  methods: {
+    GetResourceDependencies: impl.custom,
+    Execute: impl.custom,
+    resample: impl.custom
+  }
+});
+
+export { CjsTexturePipelineStepResize };
+//# sourceMappingURL=CjsTexturePipelineStepResize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CjsTexturePipelineStepResize.js","sources":["../../../../src/resource/texture/CjsTexturePipelineStepResize.js"],"sourcesContent":["// Not Carbon. A texture-pipeline step of our own, registered in\n// /docs/architecture/non-carbon-extensions.md.\nimport { CjsSchema, edit, impl, type } from \"#schema\";\nimport { CjsModel } from \"#model\";\nimport { HostBitmap } from \"#imageio\";\nimport { GetBytesPerPixel, IsCompressedFormat } from \"#consts/render-context\";\n\n/**\n * Resamples the pipeline's INPUTS to one size before a later step reads them.\n *\n * Carbon's `Tr2TexturePipelineStepPack` refuses inputs of different sizes: CCP\n * packs in a controlled pipeline over sources it authors. We join files we do\n * not control, by our own choice, so matching their sizes is our job. With no\n * size set, every input is resampled up to the largest one.\n *\n * Bilinear, on the top mip, for uncompressed byte formats - run\n * `CjsTexturePipelineStepConvert` first for block formats. The result has one\n * mip; add `Tr2TexturePipelineStepGenerateMips` after the pack for a chain.\n * Each resized input is a COPY that replaces its entry in the pipeline's\n * `inputs` map, so the cached source bitmap is never changed.\n */\nexport class CjsTexturePipelineStepResize extends CjsModel\n{\n\n  /** Target width; 0 takes the widest input. */\n  width = 0;\n\n  /** Target height; 0 takes the tallest input. */\n  height = 0;\n\n  /** Input paths to resize; empty resizes every input. */\n  paths = [];\n\n  /**\n   * Names no resources: it works on inputs other steps name.\n   *\n   * @param {Set<string>} [resources] Caller-owned; allocated when omitted.\n   * @returns {Set<string>} The set, unchanged.\n   */\n  GetResourceDependencies(resources = new Set())\n  {\n    return resources;\n  }\n\n  /**\n   * Replace each named input with a copy at the target size.\n   *\n   * @param {HostBitmap} _bitmap The pipeline's bitmap (unused).\n   * @param {Map<string, HostBitmap>} inputs Loaded inputs by path; entries are replaced.\n   * @returns {boolean} False when an input is missing or cannot be resampled.\n   */\n  Execute(_bitmap, inputs)\n  {\n    const paths = this.paths.length ? this.paths : [ ...inputs.keys() ];\n    const sources = paths.map(path => inputs.get(path));\n\n    if (sources.some(source => !source)) return false;\n\n    const width = this.width || Math.max(...sources.map(source => source.GetWidth()));\n    const height = this.height || Math.max(...sources.map(source => source.GetHeight()));\n\n    for (let index = 0; index < paths.length; index++)\n    {\n      const source = sources[index];\n\n      if (source.GetWidth() === width && source.GetHeight() === height && source.GetTrueMipCount() === 1) continue;\n\n      const resized = CjsTexturePipelineStepResize.resample(source, width, height);\n      if (!resized) return false;\n\n      inputs.set(paths[index], resized);\n    }\n    return true;\n  }\n\n  /**\n   * Bilinear resample of a bitmap's top mip into a new one-mip bitmap.\n   *\n   * @param {HostBitmap} source Uncompressed byte-per-channel bitmap.\n   * @param {number} width Target width.\n   * @param {number} height Target height.\n   * @returns {HostBitmap|null} The resampled copy, or null for an unsupported format.\n   */\n  static resample(source, width, height)\n  {\n    const format = source.GetFormat();\n\n    if (IsCompressedFormat(format)) return null;\n\n    const channels = GetBytesPerPixel(format);\n    const result = new HostBitmap();\n\n    if (!result.Create(width, height, 1, format)) return null;\n\n    const sourceWidth = source.GetWidth();\n    const sourceHeight = source.GetHeight();\n    const from = source.GetMipRawData(0);\n    const fromPitch = source.GetMipPitch(0);\n    const to = result.GetMipRawData(0);\n    const toPitch = result.GetMipPitch(0);\n\n    for (let y = 0; y < height; y++)\n    {\n      // Pixel centres map to pixel centres.\n      const sy = Math.min(Math.max((y + 0.5) * sourceHeight / height - 0.5, 0), sourceHeight - 1);\n      const y0 = Math.floor(sy);\n      const y1 = Math.min(y0 + 1, sourceHeight - 1);\n      const fy = sy - y0;\n\n      for (let x = 0; x < width; x++)\n      {\n        const sx = Math.min(Math.max((x + 0.5) * sourceWidth / width - 0.5, 0), sourceWidth - 1);\n        const x0 = Math.floor(sx);\n        const x1 = Math.min(x0 + 1, sourceWidth - 1);\n        const fx = sx - x0;\n\n        for (let c = 0; c < channels; c++)\n        {\n          const top = from[y0 * fromPitch + x0 * channels + c] * (1 - fx) + from[y0 * fromPitch + x1 * channels + c] * fx;\n          const bottom = from[y1 * fromPitch + x0 * channels + c] * (1 - fx) + from[y1 * fromPitch + x1 * channels + c] * fx;\n          to[y * toPitch + x * channels + c] = Math.round(top * (1 - fy) + bottom * fy);\n        }\n      }\n    }\n    return result;\n  }\n\n}\n\nCjsSchema.define(CjsTexturePipelineStepResize, {\n  className: \"CjsTexturePipelineStepResize\", family: \"resources\",\n  fields: {\n    width: [ edit.persist, type.uint32 ],\n    height: [ edit.persist, type.uint32 ],\n    paths: [ edit.persist, type.list(\"string\") ]\n  },\n  methods: {\n    GetResourceDependencies: impl.custom,\n    Execute: impl.custom,\n    resample: impl.custom\n  }\n});\n"],"names":["CjsTexturePipelineStepResize","CjsModel","width","height","paths","GetResourceDependencies","resources","Set","Execute","_bitmap","inputs","length","keys","sources","map","path","get","some","source","Math","max","GetWidth","GetHeight","index","GetTrueMipCount","resized","resample","set","format","GetFormat","IsCompressedFormat","channels","GetBytesPerPixel","result","HostBitmap","Create","sourceWidth","sourceHeight","from","GetMipRawData","fromPitch","GetMipPitch","to","toPitch","y","sy","min","y0","floor","y1","fy","x","sx","x0","x1","fx","c","top","bottom","round","CjsSchema","define","className","family","fields","edit","persist","type","uint32","list","methods","impl","custom"],"mappings":"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"}

package/dist/resource/texture/SolidColorTextureConstructor.js

@@ -1,3 +1,4 @@
+import { IBlueDynamicResourceConstructor } from '#blue';
 import { TriTextureRes } from './TriTextureRes.js';
 import { ColorPrefix } from './solidColorTexture.js';
 
@@ -14,13 +15,22 @@ import { ColorPrefix } from './solidColorTexture.js';
  * `dynamic:/color/<query>` path names. TriTextureRes.Initialize recognises the
  * prefix and rasterizes the colour itself.
  */
-class SolidColorTextureConstructor {
+class SolidColorTextureConstructor extends IBlueDynamicResourceConstructor {
   /**
    * `IBlueDynamicResourceConstructor::GetResource` (SolidColorTexture.cpp:23-29).
    *
    * @param {string} query Text after `dynamic:/color/`.
    * @returns {TriTextureRes} The texture resource.
    */
+  /**
+   * A solid colour is four numbers in its own path; kept for good once built
+   * (operator, 2026-09-24).
+   *
+   * @returns {boolean} Always true.
+   */
+  IsCacheable() {
+    return true;
+  }
   GetResource(query) {
     const texture = new TriTextureRes();
     texture.Initialize(ColorPrefix + query, "");

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

@@ -1 +1 @@
-{"version":3,"file":"SolidColorTextureConstructor.js","sources":["../../../../src/resource/texture/SolidColorTextureConstructor.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Procedural/SolidColorTexture.cpp\n//\n// Carbon registers this constructor at static-initialisation time, inside its\n// own translation unit (SolidColorTexture.cpp:17-32). As with\n// RegisterShaderResources, we do not self-register at module scope: a module\n// side effect fires on import rather than on composition and cannot be tested in\n// isolation. Whoever composes a manager calls RegisterSolidColorTexture.\nimport { TriTextureRes } from \"./TriTextureRes.js\";\nimport { ColorPrefix } from \"./solidColorTexture.js\";\n\n/**\n * Carbon's `SolidColorTextureConstructor`: builds the texture a\n * `dynamic:/color/<query>` path names. TriTextureRes.Initialize recognises the\n * prefix and rasterizes the colour itself.\n */\nexport class SolidColorTextureConstructor\n{\n  /**\n   * `IBlueDynamicResourceConstructor::GetResource` (SolidColorTexture.cpp:23-29).\n   *\n   * @param {string} query Text after `dynamic:/color/`.\n   * @returns {TriTextureRes} The texture resource.\n   */\n  GetResource(query)\n  {\n    const texture = new TriTextureRes();\n    texture.Initialize(ColorPrefix + query, \"\");\n    return texture;\n  }\n}\n\n/**\n * Registers the `color` dynamic constructor on one manager.\n *\n * @param {object} resourceManager Manager to register on.\n * @returns {object} The same manager, for chaining.\n */\nexport function RegisterSolidColorTexture(resourceManager)\n{\n  if (typeof resourceManager?.RegisterResourceConstructor !== \"function\")\n  {\n    throw new TypeError(\"RegisterSolidColorTexture requires a CjsResMan.\");\n  }\n  resourceManager.RegisterResourceConstructor(\"color\", new SolidColorTextureConstructor());\n  return resourceManager;\n}\n"],"names":["SolidColorTextureConstructor","GetResource","query","texture","TriTextureRes","Initialize","ColorPrefix","RegisterSolidColorTexture","resourceManager","RegisterResourceConstructor","TypeError"],"mappings":";;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA;AACO,MAAMA,4BAA4B,CACzC;AACE;AACF;AACA;AACA;AACA;AACA;EACEC,WAAWA,CAACC,KAAK,EACjB;AACE,IAAA,MAAMC,OAAO,GAAG,IAAIC,aAAa,EAAE;IACnCD,OAAO,CAACE,UAAU,CAACC,WAAW,GAAGJ,KAAK,EAAE,EAAE,CAAC;AAC3C,IAAA,OAAOC,OAAO;AAChB,EAAA;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASI,yBAAyBA,CAACC,eAAe,EACzD;AACE,EAAA,IAAI,OAAOA,eAAe,EAAEC,2BAA2B,KAAK,UAAU,EACtE;AACE,IAAA,MAAM,IAAIC,SAAS,CAAC,iDAAiD,CAAC;AACxE,EAAA;EACAF,eAAe,CAACC,2BAA2B,CAAC,OAAO,EAAE,IAAIT,4BAA4B,EAAE,CAAC;AACxF,EAAA,OAAOQ,eAAe;AACxB;;;;"}
+{"version":3,"file":"SolidColorTextureConstructor.js","sources":["../../../../src/resource/texture/SolidColorTextureConstructor.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Procedural/SolidColorTexture.cpp\n//\n// Carbon registers this constructor at static-initialisation time, inside its\n// own translation unit (SolidColorTexture.cpp:17-32). As with\n// RegisterShaderResources, we do not self-register at module scope: a module\n// side effect fires on import rather than on composition and cannot be tested in\n// isolation. Whoever composes a manager calls RegisterSolidColorTexture.\nimport { IBlueDynamicResourceConstructor } from \"#blue\";\nimport { TriTextureRes } from \"./TriTextureRes.js\";\nimport { ColorPrefix } from \"./solidColorTexture.js\";\n\n/**\n * Carbon's `SolidColorTextureConstructor`: builds the texture a\n * `dynamic:/color/<query>` path names. TriTextureRes.Initialize recognises the\n * prefix and rasterizes the colour itself.\n */\nexport class SolidColorTextureConstructor extends IBlueDynamicResourceConstructor\n{\n  /**\n   * `IBlueDynamicResourceConstructor::GetResource` (SolidColorTexture.cpp:23-29).\n   *\n   * @param {string} query Text after `dynamic:/color/`.\n   * @returns {TriTextureRes} The texture resource.\n   */\n  /**\n   * A solid colour is four numbers in its own path; kept for good once built\n   * (operator, 2026-09-24).\n   *\n   * @returns {boolean} Always true.\n   */\n  IsCacheable()\n  {\n    return true;\n  }\n\n  GetResource(query)\n  {\n    const texture = new TriTextureRes();\n    texture.Initialize(ColorPrefix + query, \"\");\n    return texture;\n  }\n}\n\n/**\n * Registers the `color` dynamic constructor on one manager.\n *\n * @param {object} resourceManager Manager to register on.\n * @returns {object} The same manager, for chaining.\n */\nexport function RegisterSolidColorTexture(resourceManager)\n{\n  if (typeof resourceManager?.RegisterResourceConstructor !== \"function\")\n  {\n    throw new TypeError(\"RegisterSolidColorTexture requires a CjsResMan.\");\n  }\n  resourceManager.RegisterResourceConstructor(\"color\", new SolidColorTextureConstructor());\n  return resourceManager;\n}\n"],"names":["SolidColorTextureConstructor","IBlueDynamicResourceConstructor","IsCacheable","GetResource","query","texture","TriTextureRes","Initialize","ColorPrefix","RegisterSolidColorTexture","resourceManager","RegisterResourceConstructor","TypeError"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACO,MAAMA,4BAA4B,SAASC,+BAA+B,CACjF;AACE;AACF;AACA;AACA;AACA;AACA;AACE;AACF;AACA;AACA;AACA;AACA;AACEC,EAAAA,WAAWA,GACX;AACE,IAAA,OAAO,IAAI;AACb,EAAA;EAEAC,WAAWA,CAACC,KAAK,EACjB;AACE,IAAA,MAAMC,OAAO,GAAG,IAAIC,aAAa,EAAE;IACnCD,OAAO,CAACE,UAAU,CAACC,WAAW,GAAGJ,KAAK,EAAE,EAAE,CAAC;AAC3C,IAAA,OAAOC,OAAO;AAChB,EAAA;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASI,yBAAyBA,CAACC,eAAe,EACzD;AACE,EAAA,IAAI,OAAOA,eAAe,EAAEC,2BAA2B,KAAK,UAAU,EACtE;AACE,IAAA,MAAM,IAAIC,SAAS,CAAC,iDAAiD,CAAC;AACxE,EAAA;EACAF,eAAe,CAACC,2BAA2B,CAAC,OAAO,EAAE,IAAIX,4BAA4B,EAAE,CAAC;AACxF,EAAA,OAAOU,eAAe;AACxB;;;;"}