@carbonenginejs/runtime 0.1.0-alpha.0 → 0.1.0-alpha.1

package/dist/trinityal/Tr2HalHelperStructures/Tr2SamplerDescription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2SamplerDescription.js","sources":["../../../../src/trinityal/Tr2HalHelperStructures/Tr2SamplerDescription.js"],"sourcesContent":["// Source: trinity/trinityal/Tr2HalHelperStructures.h:137-254 (struct Tr2SamplerDescription)\n//   trinity/trinityal/Tr2HalHelperStructures.h:255-277 (struct hash<Tr2SamplerDescription>)\n//   trinity/trinityal/include/Tr2SamplerStateAL.h (forward declaration, and the factory)\n//\n// ONE FOLDER PER DONOR HEADER - see the sibling files for why.\n//\n// THE CLASS WAS MISSING AND THIS FILE HELD ONLY FUNCTIONS. Carbon declares a\n// struct with a documented default constructor; we had a normaliser returning an\n// anonymous object, and the previous provenance header named `Tr2SamplerAL.h`,\n// which does not declare it. A struct with defaults reduced to a literal with\n// `?? 0` is how those defaults drifted - see below.\n//\n// THREE DEFAULTS WERE WRONG, and two were not even members of their enum. Carbon's\n// default constructor sets TF_POINT (1), TA_WRAP (1) and CMP_ALWAYS (8); the\n// normaliser defaulted all three to 0. `TextureFilter` does have a zero\n// (`TF_NONE`), so an omitted filter silently meant NO filtering rather than point\n// sampling. `TextureAddressMode` and `CompareFunc` are 1-based and have no zero at\n// all, so an omitted address mode or comparison produced a value outside the enum,\n// which no backend can map and nothing reported.\n//\n// THE FACTORY KEY IS CARBON'S TOO. `Tr2SamplerStateAL::Create` is a lookup in a\n// `Tr2ObjectFactory<..., Tr2SamplerDescription>` owned by the primary context\n// (`Tr2SamplerStateAL.cpp:25-28`), so two equal descriptions yield one state and\n// `operator==` on states is identity. Carbon reaches that through\n// `std::hash<Tr2SamplerDescription>`; JavaScript has no hash specialisation to\n// install, so `SamplerDescriptionKey` is the equivalent and the Map it feeds is\n// the factory.\nimport { CompareFunc, TextureAddressMode, TextureFilter } from \"../../global/consts/renderContext/index.js\";\n\nconst rawView = new DataView(new ArrayBuffer(4));\n\n/** A float from its raw IEEE-754 bits, or the float itself. */\nfunction floatOf(value, raw, fallback)\n{\n  if (Number.isFinite(value)) return value;\n\n  if (Number.isInteger(raw))\n  {\n    rawView.setUint32(0, raw >>> 0, true);\n\n    return rawView.getFloat32(0, true);\n  }\n\n  return fallback;\n}\n\n/**\n * Carbon's `std::numeric_limits<float>::max()`, the open upper LOD bound an author\n * leaves unbounded.\n */\nexport const SAMPLER_LOD_UNBOUNDED = 3.4028234663852886e38;\n\n\n/**\n * The authored sampler state a `Tr2SamplerStateAL` is created from, and the key\n * its factory dedupes on.\n */\nexport class Tr2SamplerDescription\n{\n  m_minFilter = TextureFilter.TF_POINT;\n\n  m_magFilter = TextureFilter.TF_POINT;\n\n  m_mipFilter = TextureFilter.TF_POINT;\n\n  m_isComparisonFilter = false;\n\n  m_addressU = TextureAddressMode.TA_WRAP;\n\n  m_addressV = TextureAddressMode.TA_WRAP;\n\n  m_addressW = TextureAddressMode.TA_WRAP;\n\n  m_mipLODBias = 0;\n\n  m_maxAnisotropy = 1;\n\n  m_comparisonFunc = CompareFunc.CMP_ALWAYS;\n\n  /** Four floats, RGBA. Carbon's constructor zeroes all four. */\n  m_borderColor = [ 0, 0, 0, 0 ];\n\n  m_minLOD = 0;\n\n  m_maxLOD = SAMPLER_LOD_UNBOUNDED;\n\n  /**\n   * Carbon's second constructor, which takes every field.\n   *\n   * Its first form is the default constructor, which is the field initialisers\n   * above. Passing nothing here is that form.\n   *\n   * @param {object} [values] Field values in the normal form, as\n   *   {@link NormalizeSamplerDescription} produces.\n   */\n  constructor(values = undefined)\n  {\n    if (!values) return;\n\n    Object.assign(this, {\n      m_minFilter: values.minFilter,\n      m_magFilter: values.magFilter,\n      m_mipFilter: values.mipFilter,\n      m_isComparisonFilter: values.isComparisonFilter,\n      m_addressU: values.addressU,\n      m_addressV: values.addressV,\n      m_addressW: values.addressW,\n      m_mipLODBias: values.mipLODBias,\n      m_maxAnisotropy: values.maxAnisotropy,\n      m_comparisonFunc: values.comparisonFunc,\n      m_borderColor: [ ...values.borderColor ],\n      m_minLOD: values.minLOD,\n      m_maxLOD: values.maxLOD\n    });\n  }\n}\n\n\n/**\n * The normal form of a sampler description.\n *\n * TWO SPELLINGS ARRIVE HERE. The effect reader keeps floats as their raw bits\n * (`Tr2SamplerSetup.fromCarbonBinary`: `minLODRaw`, `maxLODRaw`, `mipLODBiasRaw`,\n * `borderColorRaw`) so a round trip is byte-exact; an override built at runtime\n * carries plain floats. The normal form is the floats, and both spellings\n * normalise to it, so the factory key is the same whichever road a description\n * took.\n *\n * @param {object|null} description Authored state in either spelling.\n * @returns {object|null} The normalised description, or null for nothing.\n */\nexport function NormalizeSamplerDescription(description)\n{\n  if (!description || typeof description !== \"object\") return null;\n\n  const border = description.borderColor ?? description.borderColorRaw ?? [];\n  const rawBorder = description.borderColor ? null : description.borderColorRaw ?? null;\n\n  // Defaults are Carbon's default constructor, NOT zero. `isComparisonFilter` is\n  // also Carbon's field name; it was `comparison` here, which reads as the\n  // comparison FUNCTION rather than the flag selecting a comparison sampler.\n  return {\n    minFilter: description.minFilter ?? TextureFilter.TF_POINT,\n    magFilter: description.magFilter ?? TextureFilter.TF_POINT,\n    mipFilter: description.mipFilter ?? TextureFilter.TF_POINT,\n    isComparisonFilter: Boolean(description.isComparisonFilter ?? description.comparison),\n    addressU: description.addressU ?? TextureAddressMode.TA_WRAP,\n    addressV: description.addressV ?? TextureAddressMode.TA_WRAP,\n    addressW: description.addressW ?? TextureAddressMode.TA_WRAP,\n    mipLODBias: floatOf(description.mipLODBias, description.mipLODBiasRaw, 0),\n    maxAnisotropy: description.maxAnisotropy ?? 1,\n    comparisonFunc: description.comparisonFunc ?? CompareFunc.CMP_ALWAYS,\n    borderColor: [ 0, 1, 2, 3 ].map(index => floatOf(rawBorder ? undefined : border[index], rawBorder?.[index], 0)),\n    minLOD: floatOf(description.minLOD, description.minLODRaw, 0),\n    maxLOD: floatOf(description.maxLOD, description.maxLODRaw, SAMPLER_LOD_UNBOUNDED)\n  };\n}\n\n\n/**\n * The factory key for a description: two descriptions with equal keys are one\n * sampler state.\n *\n * This is what Carbon reaches through `std::hash<Tr2SamplerDescription>`\n * (`Tr2HalHelperStructures.h:255-277`), which JavaScript cannot install.\n *\n * @param {object} description A description in either spelling.\n * @returns {string|null} The key, or null for nothing.\n */\nexport function SamplerDescriptionKey(description)\n{\n  const normalized = NormalizeSamplerDescription(description);\n\n  return normalized ? JSON.stringify(normalized) : null;\n}\n"],"names":["rawView","DataView","ArrayBuffer","floatOf","value","raw","fallback","Number","isFinite","isInteger","setUint32","getFloat32","SAMPLER_LOD_UNBOUNDED","Tr2SamplerDescription","m_minFilter","TextureFilter","TF_POINT","m_magFilter","m_mipFilter","m_isComparisonFilter","m_addressU","TextureAddressMode","TA_WRAP","m_addressV","m_addressW","m_mipLODBias","m_maxAnisotropy","m_comparisonFunc","CompareFunc","CMP_ALWAYS","m_borderColor","m_minLOD","m_maxLOD","constructor","values","undefined","Object","assign","minFilter","magFilter","mipFilter","isComparisonFilter","addressU","addressV","addressW","mipLODBias","maxAnisotropy","comparisonFunc","borderColor","minLOD","maxLOD","NormalizeSamplerDescription","description","border","borderColorRaw","rawBorder","Boolean","comparison","mipLODBiasRaw","map","index","minLODRaw","maxLODRaw","SamplerDescriptionKey","normalized","JSON","stringify"],"mappings":"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"}

package/dist/trinityal/Tr2HalHelperStructures/Tr2SubresourceData.js

@@ -0,0 +1,48 @@
+// Source: trinity/trinityal/Tr2HalHelperStructures.h:20-25
+//
+// ONE FOLDER PER DONOR HEADER - see the sibling files for why.
+//
+// WAS NEVER PORTED, and nothing noticed. Carbon's texture creation takes an array
+// of these as its initial data, one per (mip, layer), indexed
+// `mip + layer * mipCount` (`Tr2ImageIOHelpers.cpp:104-128`). Our callers were
+// already passing objects of exactly this shape as anonymous literals -
+// `Tr2ImageIOHelpers.js` builds `{ sysMem, sysMemPitch, sysMemSlicePitch }` - so
+// the contract existed with no type to name it, which is precisely what made its
+// absence invisible.
+
+/**
+ * One mip of one layer: where its pixels are, and how they are laid out.
+ */
+class Tr2SubresourceData {
+  /**
+   * Carbon's `const void* m_sysMem`. A pointer there; the bytes themselves here,
+   * because JavaScript has no pointer to hand a backend instead.
+   */
+  m_sysMem = null;
+
+  /** Size in bytes of one line of pixels. */
+  m_sysMemPitch = 0;
+
+  /**
+   * Size in bytes of the entire mip level.
+   *
+   * CANNOT BE ZERO, says Carbon's own comment on the field. It is not defaulted
+   * away or validated here: the donor states the requirement and leaves the
+   * caller to meet it, and a zero reaching a backend is the caller's bug to see.
+   */
+  m_sysMemSlicePitch = 0;
+
+  /**
+   * @param {ArrayBufferView|null} [sysMem] The pixels for this mip.
+   * @param {number} [sysMemPitch] Bytes per line.
+   * @param {number} [sysMemSlicePitch] Bytes for the whole mip level.
+   */
+  constructor(sysMem = null, sysMemPitch = 0, sysMemSlicePitch = 0) {
+    this.m_sysMem = sysMem;
+    this.m_sysMemPitch = sysMemPitch;
+    this.m_sysMemSlicePitch = sysMemSlicePitch;
+  }
+}
+
+export { Tr2SubresourceData };
+//# sourceMappingURL=Tr2SubresourceData.js.map

package/dist/trinityal/Tr2HalHelperStructures/Tr2SubresourceData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2SubresourceData.js","sources":["../../../../src/trinityal/Tr2HalHelperStructures/Tr2SubresourceData.js"],"sourcesContent":["// Source: trinity/trinityal/Tr2HalHelperStructures.h:20-25\n//\n// ONE FOLDER PER DONOR HEADER - see the sibling files for why.\n//\n// WAS NEVER PORTED, and nothing noticed. Carbon's texture creation takes an array\n// of these as its initial data, one per (mip, layer), indexed\n// `mip + layer * mipCount` (`Tr2ImageIOHelpers.cpp:104-128`). Our callers were\n// already passing objects of exactly this shape as anonymous literals -\n// `Tr2ImageIOHelpers.js` builds `{ sysMem, sysMemPitch, sysMemSlicePitch }` - so\n// the contract existed with no type to name it, which is precisely what made its\n// absence invisible.\n\n\n/**\n * One mip of one layer: where its pixels are, and how they are laid out.\n */\nexport class Tr2SubresourceData\n{\n  /**\n   * Carbon's `const void* m_sysMem`. A pointer there; the bytes themselves here,\n   * because JavaScript has no pointer to hand a backend instead.\n   */\n  m_sysMem = null;\n\n  /** Size in bytes of one line of pixels. */\n  m_sysMemPitch = 0;\n\n  /**\n   * Size in bytes of the entire mip level.\n   *\n   * CANNOT BE ZERO, says Carbon's own comment on the field. It is not defaulted\n   * away or validated here: the donor states the requirement and leaves the\n   * caller to meet it, and a zero reaching a backend is the caller's bug to see.\n   */\n  m_sysMemSlicePitch = 0;\n\n  /**\n   * @param {ArrayBufferView|null} [sysMem] The pixels for this mip.\n   * @param {number} [sysMemPitch] Bytes per line.\n   * @param {number} [sysMemSlicePitch] Bytes for the whole mip level.\n   */\n  constructor(sysMem = null, sysMemPitch = 0, sysMemSlicePitch = 0)\n  {\n    this.m_sysMem = sysMem;\n    this.m_sysMemPitch = sysMemPitch;\n    this.m_sysMemSlicePitch = sysMemSlicePitch;\n  }\n}\n"],"names":["Tr2SubresourceData","m_sysMem","m_sysMemPitch","m_sysMemSlicePitch","constructor","sysMem","sysMemPitch","sysMemSlicePitch"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACO,MAAMA,kBAAkB,CAC/B;AACE;AACF;AACA;AACA;AACEC,EAAAA,QAAQ,GAAG,IAAI;;AAEf;AACAC,EAAAA,aAAa,GAAG,CAAC;;AAEjB;AACF;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,kBAAkB,GAAG,CAAC;;AAEtB;AACF;AACA;AACA;AACA;AACEC,EAAAA,WAAWA,CAACC,MAAM,GAAG,IAAI,EAAEC,WAAW,GAAG,CAAC,EAAEC,gBAAgB,GAAG,CAAC,EAChE;IACE,IAAI,CAACN,QAAQ,GAAGI,MAAM;IACtB,IAAI,CAACH,aAAa,GAAGI,WAAW;IAChC,IAAI,CAACH,kBAAkB,GAAGI,gBAAgB;AAC5C,EAAA;AACF;;;;"}

package/dist/trinityal/Tr2HalHelperStructures/Tr2TextureCoordBox.js

@@ -0,0 +1,75 @@
+// Source: trinity/trinityal/Tr2HalHelperStructures.h
+// Source: trinity/trinityal/Tr2HalHelperStructures.cpp
+//
+// ONE FOLDER PER DONOR HEADER. Carbon declares six types in this header, and a
+// C++ header is an include unit rather than a class container. Splitting them one
+// per file keeps every class findable by its own name without inventing anything:
+// the folder still names the donor, so each file has something to be diffed
+// against. It also makes an unported sibling visible as a missing FILE, which is
+// how two of these were found absent.
+
+/** Carbon's "not set" for every box coordinate: `0xffffffff`. */
+const UNSET = 0xffffffff;
+
+/**
+ * A box within a texture, in pixels.
+ */
+class Tr2TextureCoordBox {
+  /** @type {number} */
+  left = UNSET;
+
+  /** @type {number} */
+  top = UNSET;
+
+  /** @type {number} */
+  front = UNSET;
+
+  /** @type {number} */
+  right = UNSET;
+
+  /** @type {number} */
+  bottom = UNSET;
+
+  /** @type {number} */
+  back = UNSET;
+
+  /**
+   * Width of the box.
+   *
+   * @returns {number} Right minus left.
+   */
+  GetWidth() {
+    return this.right - this.left;
+  }
+
+  /**
+   * Height of the box.
+   *
+   * @returns {number} Bottom minus top.
+   */
+  GetHeight() {
+    return this.bottom - this.top;
+  }
+
+  /**
+   * Depth of the box.
+   *
+   * @returns {number} Back minus front.
+   */
+  GetDepth() {
+    return this.back - this.front;
+  }
+
+  /**
+   * Whether two boxes cover the same region.
+   *
+   * @param {Tr2TextureCoordBox} other The box to compare with.
+   * @returns {boolean} True when every coordinate matches.
+   */
+  Equals(other) {
+    return this.left === other.left && this.top === other.top && this.front === other.front && this.right === other.right && this.bottom === other.bottom && this.back === other.back;
+  }
+}
+
+export { Tr2TextureCoordBox };
+//# sourceMappingURL=Tr2TextureCoordBox.js.map

package/dist/trinityal/Tr2HalHelperStructures/Tr2TextureCoordBox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2TextureCoordBox.js","sources":["../../../../src/trinityal/Tr2HalHelperStructures/Tr2TextureCoordBox.js"],"sourcesContent":["// Source: trinity/trinityal/Tr2HalHelperStructures.h\n// Source: trinity/trinityal/Tr2HalHelperStructures.cpp\n//\n// ONE FOLDER PER DONOR HEADER. Carbon declares six types in this header, and a\n// C++ header is an include unit rather than a class container. Splitting them one\n// per file keeps every class findable by its own name without inventing anything:\n// the folder still names the donor, so each file has something to be diffed\n// against. It also makes an unported sibling visible as a missing FILE, which is\n// how two of these were found absent.\n\n/** Carbon's \"not set\" for every box coordinate: `0xffffffff`. */\nconst UNSET = 0xffffffff;\n\n/**\n * A box within a texture, in pixels.\n */\nexport class Tr2TextureCoordBox\n{\n  /** @type {number} */\n  left = UNSET;\n\n  /** @type {number} */\n  top = UNSET;\n\n  /** @type {number} */\n  front = UNSET;\n\n  /** @type {number} */\n  right = UNSET;\n\n  /** @type {number} */\n  bottom = UNSET;\n\n  /** @type {number} */\n  back = UNSET;\n\n  /**\n   * Width of the box.\n   *\n   * @returns {number} Right minus left.\n   */\n  GetWidth()\n  {\n    return this.right - this.left;\n  }\n\n  /**\n   * Height of the box.\n   *\n   * @returns {number} Bottom minus top.\n   */\n  GetHeight()\n  {\n    return this.bottom - this.top;\n  }\n\n  /**\n   * Depth of the box.\n   *\n   * @returns {number} Back minus front.\n   */\n  GetDepth()\n  {\n    return this.back - this.front;\n  }\n\n  /**\n   * Whether two boxes cover the same region.\n   *\n   * @param {Tr2TextureCoordBox} other The box to compare with.\n   * @returns {boolean} True when every coordinate matches.\n   */\n  Equals(other)\n  {\n    return this.left === other.left &&\n      this.top === other.top &&\n      this.front === other.front &&\n      this.right === other.right &&\n      this.bottom === other.bottom &&\n      this.back === other.back;\n  }\n}\n"],"names":["UNSET","Tr2TextureCoordBox","left","top","front","right","bottom","back","GetWidth","GetHeight","GetDepth","Equals","other"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,MAAMA,KAAK,GAAG,UAAU;;AAExB;AACA;AACA;AACO,MAAMC,kBAAkB,CAC/B;AACE;AACAC,EAAAA,IAAI,GAAGF,KAAK;;AAEZ;AACAG,EAAAA,GAAG,GAAGH,KAAK;;AAEX;AACAI,EAAAA,KAAK,GAAGJ,KAAK;;AAEb;AACAK,EAAAA,KAAK,GAAGL,KAAK;;AAEb;AACAM,EAAAA,MAAM,GAAGN,KAAK;;AAEd;AACAO,EAAAA,IAAI,GAAGP,KAAK;;AAEZ;AACF;AACA;AACA;AACA;AACEQ,EAAAA,QAAQA,GACR;AACE,IAAA,OAAO,IAAI,CAACH,KAAK,GAAG,IAAI,CAACH,IAAI;AAC/B,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEO,EAAAA,SAASA,GACT;AACE,IAAA,OAAO,IAAI,CAACH,MAAM,GAAG,IAAI,CAACH,GAAG;AAC/B,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEO,EAAAA,QAAQA,GACR;AACE,IAAA,OAAO,IAAI,CAACH,IAAI,GAAG,IAAI,CAACH,KAAK;AAC/B,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACEO,MAAMA,CAACC,KAAK,EACZ;IACE,OAAO,IAAI,CAACV,IAAI,KAAKU,KAAK,CAACV,IAAI,IAC7B,IAAI,CAACC,GAAG,KAAKS,KAAK,CAACT,GAAG,IACtB,IAAI,CAACC,KAAK,KAAKQ,KAAK,CAACR,KAAK,IAC1B,IAAI,CAACC,KAAK,KAAKO,KAAK,CAACP,KAAK,IAC1B,IAAI,CAACC,MAAM,KAAKM,KAAK,CAACN,MAAM,IAC5B,IAAI,CAACC,IAAI,KAAKK,KAAK,CAACL,IAAI;AAC5B,EAAA;AACF;;;;"}

package/dist/trinityal/{Tr2HalHelperStructures.js → Tr2HalHelperStructures/Tr2TextureSubresource.js}

@@ -1,125 +1,21 @@
-import { TextureType } from '../global/consts/renderContext/formats.js';
-import '../global/consts/renderContext/pipeline.js';
+import { TextureType } from '../../global/consts/renderContext/formats.js';
+import '../../global/consts/renderContext/pipeline.js';
+import { Tr2TextureCoordBox } from './Tr2TextureCoordBox.js';
 
 // Source: trinity/trinityal/Tr2HalHelperStructures.h
 // Source: trinity/trinityal/Tr2HalHelperStructures.cpp
 //
-// The small value types the abstraction layer passes around: a multisample
-// description, and the region of a texture that a map, an update or a copy
-// applies to.
-//
-// `Tr2TextureSubresource` LOOKS like a plain rectangle and is not. Its default
-// is "all of it", spelled as an all-ones box rather than as a flag, and
-// `HasBox` is what distinguishes "the caller named a region" from "the caller
-// named the whole texture". Half the validation in the texture stub turns on
-// that distinction, so it is transcribed here rather than simplified into a
-// nullable box.
-//
-// TWO LANGUAGE DIFFERENCES. Carbon's three constructor overloads become the
-// default constructor plus two named factories, and `operator==` becomes
-// `Equals`.
-//
-// Carbon's `AdvanceMip` is NOT ported: nothing in this runtime walks a copy
-// down a mip chain yet, and its depth branch shrinks the vertical box rather
-// than the depth one, which is a bug worth reading again before relying on.
+// ONE FOLDER PER DONOR HEADER. Carbon declares six types in this header, and a
+// C++ header is an include unit rather than a class container. Splitting them one
+// per file keeps every class findable by its own name without inventing anything:
+// the folder still names the donor, so each file has something to be diffed
+// against. It also makes an unported sibling visible as a missing FILE, which is
+// how two of these were found absent.
 
 
 /** Carbon's "not set" for every box coordinate: `0xffffffff`. */
 const UNSET = 0xffffffff;
 
-/**
- * A multisample description.
- */
-class Tr2MsaaDesc {
-  /** Samples per pixel; never below one. */
-  samples = 1;
-
-  /** Backend-defined quality level. */
-  quality = 0;
-
-  /**
-   * @param {number} [samples] Samples per pixel.
-   * @param {number} [quality] Quality level.
-   */
-  constructor(samples = 1, quality = 0) {
-    this.samples = Math.max(samples, 1);
-    this.quality = quality;
-  }
-
-  /**
-   * Whether two descriptions match.
-   *
-   * Carbon clamps both sample counts to at least one before comparing, so a
-   * zero and a one are the same description.
-   *
-   * @param {Tr2MsaaDesc} other The description to compare with.
-   * @returns {boolean} True when they match.
-   */
-  Equals(other) {
-    return Math.max(this.samples, 1) === Math.max(other.samples, 1) && this.quality === other.quality;
-  }
-}
-
-/**
- * A box within a texture, in pixels.
- */
-class Tr2TextureCoordBox {
-  /** @type {number} */
-  left = UNSET;
-
-  /** @type {number} */
-  top = UNSET;
-
-  /** @type {number} */
-  front = UNSET;
-
-  /** @type {number} */
-  right = UNSET;
-
-  /** @type {number} */
-  bottom = UNSET;
-
-  /** @type {number} */
-  back = UNSET;
-
-  /**
-   * Width of the box.
-   *
-   * @returns {number} Right minus left.
-   */
-  GetWidth() {
-    return this.right - this.left;
-  }
-
-  /**
-   * Height of the box.
-   *
-   * @returns {number} Bottom minus top.
-   */
-  GetHeight() {
-    return this.bottom - this.top;
-  }
-
-  /**
-   * Depth of the box.
-   *
-   * @returns {number} Back minus front.
-   */
-  GetDepth() {
-    return this.back - this.front;
-  }
-
-  /**
-   * Whether two boxes cover the same region.
-   *
-   * @param {Tr2TextureCoordBox} other The box to compare with.
-   * @returns {boolean} True when every coordinate matches.
-   */
-  Equals(other) {
-    return this.left === other.left && this.top === other.top && this.front === other.front && this.right === other.right && this.bottom === other.bottom && this.back === other.back;
-  }
-}
-
 /**
  * A range of faces, mip levels and pixels within a texture.
  *
@@ -400,5 +296,5 @@ function Crop(sourceSR, sourceBD, destSR, destBD) {
   return sourceSR.IsValid() && destSR.IsValid();
 }
 
-export { Crop, Tr2MsaaDesc, Tr2TextureCoordBox, Tr2TextureSubresource };
-//# sourceMappingURL=Tr2HalHelperStructures.js.map
+export { Crop, Tr2TextureSubresource };
+//# sourceMappingURL=Tr2TextureSubresource.js.map

package/dist/trinityal/Tr2HalHelperStructures/Tr2TextureSubresource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2TextureSubresource.js","sources":["../../../../src/trinityal/Tr2HalHelperStructures/Tr2TextureSubresource.js"],"sourcesContent":["// Source: trinity/trinityal/Tr2HalHelperStructures.h\n// Source: trinity/trinityal/Tr2HalHelperStructures.cpp\n//\n// ONE FOLDER PER DONOR HEADER. Carbon declares six types in this header, and a\n// C++ header is an include unit rather than a class container. Splitting them one\n// per file keeps every class findable by its own name without inventing anything:\n// the folder still names the donor, so each file has something to be diffed\n// against. It also makes an unported sibling visible as a missing FILE, which is\n// how two of these were found absent.\n\nimport { TextureType } from \"../../global/consts/renderContext/index.js\";\n// Implicit while both lived in one file: Carbon's subresource HOLDS a coord box.\nimport { Tr2TextureCoordBox } from \"./Tr2TextureCoordBox.js\";\n\n/** Carbon's \"not set\" for every box coordinate: `0xffffffff`. */\nconst UNSET = 0xffffffff;\n\n/**\n * A range of faces, mip levels and pixels within a texture.\n *\n * The default is the whole resource. `ForMipLevel` and `ForFace` are Carbon's\n * other two constructors.\n */\nexport class Tr2TextureSubresource\n{\n  /** First slice. */\n  m_startFace = 0;\n\n  /** One past the last slice. */\n  m_endFace = UNSET;\n\n  /** First mip level. */\n  m_startMipLevel = 0;\n\n  /** One past the last mip level. */\n  m_endMipLevel = UNSET;\n\n  /** @type {Tr2TextureCoordBox} */\n  m_box = new Tr2TextureCoordBox();\n\n  /**\n   * A single mip level of the first slice.\n   *\n   * @param {number} mipLevel The mip level.\n   * @returns {Tr2TextureSubresource} The region.\n   */\n  static ForMipLevel(mipLevel)\n  {\n    const region = new Tr2TextureSubresource();\n\n    region.m_startFace = 0;\n    region.m_endFace = 1;\n    region.m_startMipLevel = mipLevel;\n    region.m_endMipLevel = mipLevel + 1;\n\n    return region;\n  }\n\n  /**\n   * A single mip level of a single slice.\n   *\n   * @param {number} face The slice or cube face.\n   * @param {number} mipLevel The mip level.\n   * @returns {Tr2TextureSubresource} The region.\n   */\n  static ForFace(face, mipLevel)\n  {\n    const region = Tr2TextureSubresource.ForMipLevel(mipLevel);\n\n    region.m_startFace = face;\n    region.m_endFace = face + 1;\n\n    return region;\n  }\n\n  /**\n   * Width of the box.\n   *\n   * @returns {number} Width in pixels.\n   */\n  GetWidth()\n  {\n    return this.m_box.GetWidth();\n  }\n\n  /**\n   * Height of the box.\n   *\n   * @returns {number} Height in pixels.\n   */\n  GetHeight()\n  {\n    return this.m_box.GetHeight();\n  }\n\n  /**\n   * Depth of the box.\n   *\n   * @returns {number} Depth in slices.\n   */\n  GetDepth()\n  {\n    return this.m_box.GetDepth();\n  }\n\n  /**\n   * Mip levels in the range.\n   *\n   * @returns {number} Level count.\n   */\n  GetMipCount()\n  {\n    return this.m_endMipLevel - this.m_startMipLevel;\n  }\n\n  /**\n   * Slices in the range.\n   *\n   * @returns {number} Face count.\n   */\n  GetFaceCount()\n  {\n    return this.m_endFace - this.m_startFace;\n  }\n\n  /**\n   * Whether the caller named a box at all.\n   *\n   * An untouched box is all ones, which means \"the whole mip\". This is the\n   * test the rest of the type turns on.\n   *\n   * @returns {boolean} True when any coordinate was set.\n   */\n  HasBox()\n  {\n    const box = this.m_box;\n\n    return box.left !== UNSET ||\n      box.top !== UNSET ||\n      box.front !== UNSET ||\n      box.right !== UNSET ||\n      box.bottom !== UNSET ||\n      box.back !== UNSET;\n  }\n\n  /**\n   * Whether the range names exactly one face and one mip level.\n   *\n   * @returns {boolean} True for a single subresource.\n   */\n  IsSingleSubresource()\n  {\n    return this.m_endFace === this.m_startFace + 1 && this.m_endMipLevel === this.m_startMipLevel + 1;\n  }\n\n  /**\n   * Sets the box from six coordinates: left, top, front, right, bottom, back.\n   *\n   * @param {number[]} ltfrbb The six coordinates, in that order.\n   * @returns {Tr2TextureSubresource} This region, for chaining.\n   */\n  SetBox(ltfrbb)\n  {\n    const box = this.m_box;\n\n    box.left = ltfrbb[0];\n    box.top = ltfrbb[1];\n    box.front = ltfrbb[2];\n    box.right = ltfrbb[3];\n    box.bottom = ltfrbb[4];\n    box.back = ltfrbb[5];\n\n    return this;\n  }\n\n  /**\n   * Sets the box from a rectangle, spanning one slice in depth.\n   *\n   * @param {number} left Left edge.\n   * @param {number} top Top edge.\n   * @param {number} right One past the right edge.\n   * @param {number} bottom One past the bottom edge.\n   * @returns {Tr2TextureSubresource} This region, for chaining.\n   */\n  SetRect(left, top, right, bottom)\n  {\n    return this.SetBox([ left, top, 0, right, bottom, 1 ]);\n  }\n\n  /**\n   * Clamps the range to a texture, filling in a box if there was none.\n   *\n   * @param {import(\"./Tr2BitmapDimensions.js\").Tr2BitmapDimensions} texture The texture to clamp against.\n   */\n  ClampToTexture(texture)\n  {\n    const arraySize = Math.max(texture.GetArraySize(), 1);\n\n    this.m_startFace = Math.min(this.m_startFace, arraySize - 1);\n    this.m_endFace = Math.min(this.m_endFace, arraySize);\n\n    this.m_startMipLevel = Math.min(this.m_startMipLevel, texture.GetTrueMipCount() - 1);\n    this.m_endMipLevel = Math.min(this.m_endMipLevel, texture.GetTrueMipCount());\n\n    const mipWidth = texture.GetMipWidth(this.m_startMipLevel);\n    const mipHeight = texture.GetMipHeight(this.m_startMipLevel);\n    const mipDepth = Math.max(texture.GetDepth() >> this.m_startMipLevel, 1);\n    const box = this.m_box;\n\n    if (this.HasBox())\n    {\n      box.left = Math.min(box.left, mipWidth - 1);\n      box.right = Math.min(box.right, mipWidth);\n      box.top = Math.min(box.top, mipHeight - 1);\n      box.bottom = Math.min(box.bottom, mipHeight);\n\n      if (texture.GetType() === TextureType.TEX_TYPE_3D)\n      {\n        box.front = Math.min(box.front, mipDepth - 1);\n        box.back = Math.min(box.back, mipDepth);\n      }\n      else\n      {\n        box.front = 0;\n        box.back = 1;\n      }\n    }\n    else\n    {\n      box.left = 0;\n      box.top = 0;\n      box.front = 0;\n      box.right = mipWidth;\n      box.bottom = mipHeight;\n      box.back = mipDepth;\n    }\n  }\n\n  /**\n   * Whether the range covers the entire texture.\n   *\n   * @param {import(\"./Tr2BitmapDimensions.js\").Tr2BitmapDimensions} texture The texture to check against.\n   * @returns {boolean} True when nothing is left out.\n   */\n  IsSubresourceFull(texture)\n  {\n    if (this.m_startFace > 0 || this.m_endFace < texture.GetArraySize()) return false;\n\n    if (this.m_startMipLevel > 0) return false;\n\n    if (this.m_endMipLevel < texture.GetTrueMipCount()) return false;\n\n    if (this.HasBox())\n    {\n      const box = this.m_box;\n\n      if (box.left > 0 || box.top > 0 || box.front > 0) return false;\n\n      if (box.right < texture.GetWidth() || box.bottom < texture.GetHeight() || box.back < texture.GetDepth())\n      {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * Whether the range fits inside a texture.\n   *\n   * @param {import(\"./Tr2BitmapDimensions.js\").Tr2BitmapDimensions} bitmap The texture to check against.\n   * @returns {boolean} True when it fits.\n   */\n  IsValidForBitmap(bitmap)\n  {\n    if (this.m_endFace > bitmap.GetArraySize()) return false;\n\n    if (this.m_endMipLevel > bitmap.GetTrueMipCount()) return false;\n\n    if (this.HasBox())\n    {\n      const box = this.m_box;\n\n      if (box.right > bitmap.GetMipWidth(this.m_startMipLevel)) return false;\n\n      if (box.bottom > bitmap.GetMipHeight(this.m_startMipLevel)) return false;\n\n      if (bitmap.GetType() === TextureType.TEX_TYPE_3D && box.back > bitmap.GetMipDepth(this.m_startMipLevel)) return false;\n    }\n\n    return true;\n  }\n\n  /**\n   * Whether the range is self-consistent: non-empty in every dimension.\n   *\n   * @returns {boolean} True when valid.\n   */\n  IsValid()\n  {\n    if (this.HasBox())\n    {\n      const box = this.m_box;\n\n      if (box.left >= box.right || box.top >= box.bottom || box.front >= box.back) return false;\n    }\n\n    return this.m_startFace < this.m_endFace && this.m_startMipLevel < this.m_endMipLevel;\n  }\n\n  /**\n   * Whether two ranges name the same region.\n   *\n   * @param {Tr2TextureSubresource} other The region to compare with.\n   * @returns {boolean} True when they match.\n   */\n  Equals(other)\n  {\n    return this.m_startFace === other.m_startFace &&\n      this.m_endFace === other.m_endFace &&\n      this.m_startMipLevel === other.m_startMipLevel &&\n      this.m_endMipLevel === other.m_endMipLevel &&\n      this.m_box.Equals(other.m_box);\n  }\n}\n\n/**\n * Crops a source and destination region to their textures and to each other.\n *\n * Carbon runs the clamp TWICE on purpose: the first pass fits each region to\n * its own texture, the shrink then makes them the same size, and the second\n * pass catches a box the shrink pushed back out of range.\n *\n * @param {Tr2TextureSubresource} sourceSR Source region; mutated in place.\n * @param {import(\"./Tr2BitmapDimensions.js\").Tr2BitmapDimensions} sourceBD Source texture.\n * @param {Tr2TextureSubresource} destSR Destination region; mutated in place.\n * @param {import(\"./Tr2BitmapDimensions.js\").Tr2BitmapDimensions} destBD Destination texture.\n * @returns {boolean} True when a copy would make sense.\n */\nexport function Crop(sourceSR, sourceBD, destSR, destBD)\n{\n  if (destSR.GetFaceCount() !== sourceSR.GetFaceCount()) return false;\n\n  if (sourceSR.HasBox() && destSR.HasBox() && destSR.GetDepth() !== sourceSR.GetDepth()) return false;\n\n  sourceSR.ClampToTexture(sourceBD);\n  destSR.ClampToTexture(destBD);\n\n  if (sourceSR.GetWidth() < destSR.GetWidth())\n  {\n    destSR.m_box.right = destSR.m_box.left + sourceSR.GetWidth();\n  }\n  else\n  {\n    sourceSR.m_box.right = sourceSR.m_box.left + destSR.GetWidth();\n  }\n\n  if (sourceSR.GetHeight() < destSR.GetHeight())\n  {\n    destSR.m_box.bottom = destSR.m_box.top + sourceSR.GetHeight();\n  }\n  else\n  {\n    sourceSR.m_box.bottom = sourceSR.m_box.top + destSR.GetHeight();\n  }\n\n  sourceSR.ClampToTexture(sourceBD);\n  destSR.ClampToTexture(destBD);\n\n  return sourceSR.IsValid() && destSR.IsValid();\n}\n"],"names":["UNSET","Tr2TextureSubresource","m_startFace","m_endFace","m_startMipLevel","m_endMipLevel","m_box","Tr2TextureCoordBox","ForMipLevel","mipLevel","region","ForFace","face","GetWidth","GetHeight","GetDepth","GetMipCount","GetFaceCount","HasBox","box","left","top","front","right","bottom","back","IsSingleSubresource","SetBox","ltfrbb","SetRect","ClampToTexture","texture","arraySize","Math","max","GetArraySize","min","GetTrueMipCount","mipWidth","GetMipWidth","mipHeight","GetMipHeight","mipDepth","GetType","TextureType","TEX_TYPE_3D","IsSubresourceFull","IsValidForBitmap","bitmap","GetMipDepth","IsValid","Equals","other","Crop","sourceSR","sourceBD","destSR","destBD"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;AAMA;AACA,MAAMA,KAAK,GAAG,UAAU;;AAExB;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,qBAAqB,CAClC;AACE;AACAC,EAAAA,WAAW,GAAG,CAAC;;AAEf;AACAC,EAAAA,SAAS,GAAGH,KAAK;;AAEjB;AACAI,EAAAA,eAAe,GAAG,CAAC;;AAEnB;AACAC,EAAAA,aAAa,GAAGL,KAAK;;AAErB;AACAM,EAAAA,KAAK,GAAG,IAAIC,kBAAkB,EAAE;;AAEhC;AACF;AACA;AACA;AACA;AACA;EACE,OAAOC,WAAWA,CAACC,QAAQ,EAC3B;AACE,IAAA,MAAMC,MAAM,GAAG,IAAIT,qBAAqB,EAAE;IAE1CS,MAAM,CAACR,WAAW,GAAG,CAAC;IACtBQ,MAAM,CAACP,SAAS,GAAG,CAAC;IACpBO,MAAM,CAACN,eAAe,GAAGK,QAAQ;AACjCC,IAAAA,MAAM,CAACL,aAAa,GAAGI,QAAQ,GAAG,CAAC;AAEnC,IAAA,OAAOC,MAAM;AACf,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACE,EAAA,OAAOC,OAAOA,CAACC,IAAI,EAAEH,QAAQ,EAC7B;AACE,IAAA,MAAMC,MAAM,GAAGT,qBAAqB,CAACO,WAAW,CAACC,QAAQ,CAAC;IAE1DC,MAAM,CAACR,WAAW,GAAGU,IAAI;AACzBF,IAAAA,MAAM,CAACP,SAAS,GAAGS,IAAI,GAAG,CAAC;AAE3B,IAAA,OAAOF,MAAM;AACf,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEG,EAAAA,QAAQA,GACR;AACE,IAAA,OAAO,IAAI,CAACP,KAAK,CAACO,QAAQ,EAAE;AAC9B,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,SAASA,GACT;AACE,IAAA,OAAO,IAAI,CAACR,KAAK,CAACQ,SAAS,EAAE;AAC/B,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,QAAQA,GACR;AACE,IAAA,OAAO,IAAI,CAACT,KAAK,CAACS,QAAQ,EAAE;AAC9B,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,WAAWA,GACX;AACE,IAAA,OAAO,IAAI,CAACX,aAAa,GAAG,IAAI,CAACD,eAAe;AAClD,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEa,EAAAA,YAAYA,GACZ;AACE,IAAA,OAAO,IAAI,CAACd,SAAS,GAAG,IAAI,CAACD,WAAW;AAC1C,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACEgB,EAAAA,MAAMA,GACN;AACE,IAAA,MAAMC,GAAG,GAAG,IAAI,CAACb,KAAK;AAEtB,IAAA,OAAOa,GAAG,CAACC,IAAI,KAAKpB,KAAK,IACvBmB,GAAG,CAACE,GAAG,KAAKrB,KAAK,IACjBmB,GAAG,CAACG,KAAK,KAAKtB,KAAK,IACnBmB,GAAG,CAACI,KAAK,KAAKvB,KAAK,IACnBmB,GAAG,CAACK,MAAM,KAAKxB,KAAK,IACpBmB,GAAG,CAACM,IAAI,KAAKzB,KAAK;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACE0B,EAAAA,mBAAmBA,GACnB;AACE,IAAA,OAAO,IAAI,CAACvB,SAAS,KAAK,IAAI,CAACD,WAAW,GAAG,CAAC,IAAI,IAAI,CAACG,aAAa,KAAK,IAAI,CAACD,eAAe,GAAG,CAAC;AACnG,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACEuB,MAAMA,CAACC,MAAM,EACb;AACE,IAAA,MAAMT,GAAG,GAAG,IAAI,CAACb,KAAK;AAEtBa,IAAAA,GAAG,CAACC,IAAI,GAAGQ,MAAM,CAAC,CAAC,CAAC;AACpBT,IAAAA,GAAG,CAACE,GAAG,GAAGO,MAAM,CAAC,CAAC,CAAC;AACnBT,IAAAA,GAAG,CAACG,KAAK,GAAGM,MAAM,CAAC,CAAC,CAAC;AACrBT,IAAAA,GAAG,CAACI,KAAK,GAAGK,MAAM,CAAC,CAAC,CAAC;AACrBT,IAAAA,GAAG,CAACK,MAAM,GAAGI,MAAM,CAAC,CAAC,CAAC;AACtBT,IAAAA,GAAG,CAACM,IAAI,GAAGG,MAAM,CAAC,CAAC,CAAC;AAEpB,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,OAAOA,CAACT,IAAI,EAAEC,GAAG,EAAEE,KAAK,EAAEC,MAAM,EAChC;AACE,IAAA,OAAO,IAAI,CAACG,MAAM,CAAC,CAAEP,IAAI,EAAEC,GAAG,EAAE,CAAC,EAAEE,KAAK,EAAEC,MAAM,EAAE,CAAC,CAAE,CAAC;AACxD,EAAA;;AAEA;AACF;AACA;AACA;AACA;EACEM,cAAcA,CAACC,OAAO,EACtB;AACE,IAAA,MAAMC,SAAS,GAAGC,IAAI,CAACC,GAAG,CAACH,OAAO,CAACI,YAAY,EAAE,EAAE,CAAC,CAAC;AAErD,IAAA,IAAI,CAACjC,WAAW,GAAG+B,IAAI,CAACG,GAAG,CAAC,IAAI,CAAClC,WAAW,EAAE8B,SAAS,GAAG,CAAC,CAAC;AAC5D,IAAA,IAAI,CAAC7B,SAAS,GAAG8B,IAAI,CAACG,GAAG,CAAC,IAAI,CAACjC,SAAS,EAAE6B,SAAS,CAAC;AAEpD,IAAA,IAAI,CAAC5B,eAAe,GAAG6B,IAAI,CAACG,GAAG,CAAC,IAAI,CAAChC,eAAe,EAAE2B,OAAO,CAACM,eAAe,EAAE,GAAG,CAAC,CAAC;AACpF,IAAA,IAAI,CAAChC,aAAa,GAAG4B,IAAI,CAACG,GAAG,CAAC,IAAI,CAAC/B,aAAa,EAAE0B,OAAO,CAACM,eAAe,EAAE,CAAC;IAE5E,MAAMC,QAAQ,GAAGP,OAAO,CAACQ,WAAW,CAAC,IAAI,CAACnC,eAAe,CAAC;IAC1D,MAAMoC,SAAS,GAAGT,OAAO,CAACU,YAAY,CAAC,IAAI,CAACrC,eAAe,CAAC;AAC5D,IAAA,MAAMsC,QAAQ,GAAGT,IAAI,CAACC,GAAG,CAACH,OAAO,CAAChB,QAAQ,EAAE,IAAI,IAAI,CAACX,eAAe,EAAE,CAAC,CAAC;AACxE,IAAA,MAAMe,GAAG,GAAG,IAAI,CAACb,KAAK;AAEtB,IAAA,IAAI,IAAI,CAACY,MAAM,EAAE,EACjB;AACEC,MAAAA,GAAG,CAACC,IAAI,GAAGa,IAAI,CAACG,GAAG,CAACjB,GAAG,CAACC,IAAI,EAAEkB,QAAQ,GAAG,CAAC,CAAC;AAC3CnB,MAAAA,GAAG,CAACI,KAAK,GAAGU,IAAI,CAACG,GAAG,CAACjB,GAAG,CAACI,KAAK,EAAEe,QAAQ,CAAC;AACzCnB,MAAAA,GAAG,CAACE,GAAG,GAAGY,IAAI,CAACG,GAAG,CAACjB,GAAG,CAACE,GAAG,EAAEmB,SAAS,GAAG,CAAC,CAAC;AAC1CrB,MAAAA,GAAG,CAACK,MAAM,GAAGS,IAAI,CAACG,GAAG,CAACjB,GAAG,CAACK,MAAM,EAAEgB,SAAS,CAAC;MAE5C,IAAIT,OAAO,CAACY,OAAO,EAAE,KAAKC,WAAW,CAACC,WAAW,EACjD;AACE1B,QAAAA,GAAG,CAACG,KAAK,GAAGW,IAAI,CAACG,GAAG,CAACjB,GAAG,CAACG,KAAK,EAAEoB,QAAQ,GAAG,CAAC,CAAC;AAC7CvB,QAAAA,GAAG,CAACM,IAAI,GAAGQ,IAAI,CAACG,GAAG,CAACjB,GAAG,CAACM,IAAI,EAAEiB,QAAQ,CAAC;AACzC,MAAA,CAAC,MAED;QACEvB,GAAG,CAACG,KAAK,GAAG,CAAC;QACbH,GAAG,CAACM,IAAI,GAAG,CAAC;AACd,MAAA;AACF,IAAA,CAAC,MAED;MACEN,GAAG,CAACC,IAAI,GAAG,CAAC;MACZD,GAAG,CAACE,GAAG,GAAG,CAAC;MACXF,GAAG,CAACG,KAAK,GAAG,CAAC;MACbH,GAAG,CAACI,KAAK,GAAGe,QAAQ;MACpBnB,GAAG,CAACK,MAAM,GAAGgB,SAAS;MACtBrB,GAAG,CAACM,IAAI,GAAGiB,QAAQ;AACrB,IAAA;AACF,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACEI,iBAAiBA,CAACf,OAAO,EACzB;AACE,IAAA,IAAI,IAAI,CAAC7B,WAAW,GAAG,CAAC,IAAI,IAAI,CAACC,SAAS,GAAG4B,OAAO,CAACI,YAAY,EAAE,EAAE,OAAO,KAAK;AAEjF,IAAA,IAAI,IAAI,CAAC/B,eAAe,GAAG,CAAC,EAAE,OAAO,KAAK;IAE1C,IAAI,IAAI,CAACC,aAAa,GAAG0B,OAAO,CAACM,eAAe,EAAE,EAAE,OAAO,KAAK;AAEhE,IAAA,IAAI,IAAI,CAACnB,MAAM,EAAE,EACjB;AACE,MAAA,MAAMC,GAAG,GAAG,IAAI,CAACb,KAAK;AAEtB,MAAA,IAAIa,GAAG,CAACC,IAAI,GAAG,CAAC,IAAID,GAAG,CAACE,GAAG,GAAG,CAAC,IAAIF,GAAG,CAACG,KAAK,GAAG,CAAC,EAAE,OAAO,KAAK;AAE9D,MAAA,IAAIH,GAAG,CAACI,KAAK,GAAGQ,OAAO,CAAClB,QAAQ,EAAE,IAAIM,GAAG,CAACK,MAAM,GAAGO,OAAO,CAACjB,SAAS,EAAE,IAAIK,GAAG,CAACM,IAAI,GAAGM,OAAO,CAAChB,QAAQ,EAAE,EACvG;AACE,QAAA,OAAO,KAAK;AACd,MAAA;AACF,IAAA;AAEA,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACEgC,gBAAgBA,CAACC,MAAM,EACvB;IACE,IAAI,IAAI,CAAC7C,SAAS,GAAG6C,MAAM,CAACb,YAAY,EAAE,EAAE,OAAO,KAAK;IAExD,IAAI,IAAI,CAAC9B,aAAa,GAAG2C,MAAM,CAACX,eAAe,EAAE,EAAE,OAAO,KAAK;AAE/D,IAAA,IAAI,IAAI,CAACnB,MAAM,EAAE,EACjB;AACE,MAAA,MAAMC,GAAG,GAAG,IAAI,CAACb,KAAK;AAEtB,MAAA,IAAIa,GAAG,CAACI,KAAK,GAAGyB,MAAM,CAACT,WAAW,CAAC,IAAI,CAACnC,eAAe,CAAC,EAAE,OAAO,KAAK;AAEtE,MAAA,IAAIe,GAAG,CAACK,MAAM,GAAGwB,MAAM,CAACP,YAAY,CAAC,IAAI,CAACrC,eAAe,CAAC,EAAE,OAAO,KAAK;MAExE,IAAI4C,MAAM,CAACL,OAAO,EAAE,KAAKC,WAAW,CAACC,WAAW,IAAI1B,GAAG,CAACM,IAAI,GAAGuB,MAAM,CAACC,WAAW,CAAC,IAAI,CAAC7C,eAAe,CAAC,EAAE,OAAO,KAAK;AACvH,IAAA;AAEA,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACE8C,EAAAA,OAAOA,GACP;AACE,IAAA,IAAI,IAAI,CAAChC,MAAM,EAAE,EACjB;AACE,MAAA,MAAMC,GAAG,GAAG,IAAI,CAACb,KAAK;MAEtB,IAAIa,GAAG,CAACC,IAAI,IAAID,GAAG,CAACI,KAAK,IAAIJ,GAAG,CAACE,GAAG,IAAIF,GAAG,CAACK,MAAM,IAAIL,GAAG,CAACG,KAAK,IAAIH,GAAG,CAACM,IAAI,EAAE,OAAO,KAAK;AAC3F,IAAA;AAEA,IAAA,OAAO,IAAI,CAACvB,WAAW,GAAG,IAAI,CAACC,SAAS,IAAI,IAAI,CAACC,eAAe,GAAG,IAAI,CAACC,aAAa;AACvF,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACE8C,MAAMA,CAACC,KAAK,EACZ;AACE,IAAA,OAAO,IAAI,CAAClD,WAAW,KAAKkD,KAAK,CAAClD,WAAW,IAC3C,IAAI,CAACC,SAAS,KAAKiD,KAAK,CAACjD,SAAS,IAClC,IAAI,CAACC,eAAe,KAAKgD,KAAK,CAAChD,eAAe,IAC9C,IAAI,CAACC,aAAa,KAAK+C,KAAK,CAAC/C,aAAa,IAC1C,IAAI,CAACC,KAAK,CAAC6C,MAAM,CAACC,KAAK,CAAC9C,KAAK,CAAC;AAClC,EAAA;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS+C,IAAIA,CAACC,QAAQ,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,MAAM,EACvD;AACE,EAAA,IAAID,MAAM,CAACvC,YAAY,EAAE,KAAKqC,QAAQ,CAACrC,YAAY,EAAE,EAAE,OAAO,KAAK;EAEnE,IAAIqC,QAAQ,CAACpC,MAAM,EAAE,IAAIsC,MAAM,CAACtC,MAAM,EAAE,IAAIsC,MAAM,CAACzC,QAAQ,EAAE,KAAKuC,QAAQ,CAACvC,QAAQ,EAAE,EAAE,OAAO,KAAK;AAEnGuC,EAAAA,QAAQ,CAACxB,cAAc,CAACyB,QAAQ,CAAC;AACjCC,EAAAA,MAAM,CAAC1B,cAAc,CAAC2B,MAAM,CAAC;EAE7B,IAAIH,QAAQ,CAACzC,QAAQ,EAAE,GAAG2C,MAAM,CAAC3C,QAAQ,EAAE,EAC3C;AACE2C,IAAAA,MAAM,CAAClD,KAAK,CAACiB,KAAK,GAAGiC,MAAM,CAAClD,KAAK,CAACc,IAAI,GAAGkC,QAAQ,CAACzC,QAAQ,EAAE;AAC9D,EAAA,CAAC,MAED;AACEyC,IAAAA,QAAQ,CAAChD,KAAK,CAACiB,KAAK,GAAG+B,QAAQ,CAAChD,KAAK,CAACc,IAAI,GAAGoC,MAAM,CAAC3C,QAAQ,EAAE;AAChE,EAAA;EAEA,IAAIyC,QAAQ,CAACxC,SAAS,EAAE,GAAG0C,MAAM,CAAC1C,SAAS,EAAE,EAC7C;AACE0C,IAAAA,MAAM,CAAClD,KAAK,CAACkB,MAAM,GAAGgC,MAAM,CAAClD,KAAK,CAACe,GAAG,GAAGiC,QAAQ,CAACxC,SAAS,EAAE;AAC/D,EAAA,CAAC,MAED;AACEwC,IAAAA,QAAQ,CAAChD,KAAK,CAACkB,MAAM,GAAG8B,QAAQ,CAAChD,KAAK,CAACe,GAAG,GAAGmC,MAAM,CAAC1C,SAAS,EAAE;AACjE,EAAA;AAEAwC,EAAAA,QAAQ,CAACxB,cAAc,CAACyB,QAAQ,CAAC;AACjCC,EAAAA,MAAM,CAAC1B,cAAc,CAAC2B,MAAM,CAAC;EAE7B,OAAOH,QAAQ,CAACJ,OAAO,EAAE,IAAIM,MAAM,CAACN,OAAO,EAAE;AAC/C;;;;"}

package/dist/trinityal/Tr2HalHelperStructures/Tr2Viewport.js

@@ -0,0 +1,51 @@
+// Source: trinity/trinityal/Tr2HalHelperStructures.h:27-48
+//
+// ONE FOLDER PER DONOR HEADER - see the sibling files for why.
+//
+// WAS NEVER PORTED. Carbon's comment calls it "Viewport for use with
+// Tr2RenderContextAL", and the AL's viewport verbs were being passed loose
+// objects instead, so nothing named the type or its defaults.
+//
+// THE TWO CONSTRUCTORS DIFFER, and the difference is Carbon's. The default one
+// leaves EVERY field uninitialised - C++ gives a `float` member no value, so a
+// default-constructed viewport holds garbage until someone assigns it. The
+// `(width, height)` one sets all six. JavaScript cannot express "uninitialised",
+// so the fields read zero here; the depth range is therefore 0..0 rather than
+// Carbon's 0..1 until the sized constructor or an assignment runs, which is the
+// one behaviour a caller could tell apart.
+
+/**
+ * The viewport a render context draws through.
+ */
+class Tr2Viewport {
+  m_x = 0;
+  m_y = 0;
+  m_width = 0;
+  m_height = 0;
+
+  /**
+   * Near depth. Carbon's sized constructor sets 0; its default constructor leaves
+   * this uninitialised, which JavaScript cannot reproduce.
+   */
+  m_minZ = 0;
+
+  /** Far depth. Carbon's sized constructor sets 1. */
+  m_maxZ = 0;
+
+  /**
+   * @param {number} [width] Width in pixels; omit for Carbon's default constructor.
+   * @param {number} [height] Height in pixels.
+   */
+  constructor(width = undefined, height = undefined) {
+    if (width === undefined && height === undefined) return;
+    this.m_x = 0;
+    this.m_y = 0;
+    this.m_width = Number(width);
+    this.m_height = Number(height);
+    this.m_minZ = 0;
+    this.m_maxZ = 1;
+  }
+}
+
+export { Tr2Viewport };
+//# sourceMappingURL=Tr2Viewport.js.map

package/dist/trinityal/Tr2HalHelperStructures/Tr2Viewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2Viewport.js","sources":["../../../../src/trinityal/Tr2HalHelperStructures/Tr2Viewport.js"],"sourcesContent":["// Source: trinity/trinityal/Tr2HalHelperStructures.h:27-48\n//\n// ONE FOLDER PER DONOR HEADER - see the sibling files for why.\n//\n// WAS NEVER PORTED. Carbon's comment calls it \"Viewport for use with\n// Tr2RenderContextAL\", and the AL's viewport verbs were being passed loose\n// objects instead, so nothing named the type or its defaults.\n//\n// THE TWO CONSTRUCTORS DIFFER, and the difference is Carbon's. The default one\n// leaves EVERY field uninitialised - C++ gives a `float` member no value, so a\n// default-constructed viewport holds garbage until someone assigns it. The\n// `(width, height)` one sets all six. JavaScript cannot express \"uninitialised\",\n// so the fields read zero here; the depth range is therefore 0..0 rather than\n// Carbon's 0..1 until the sized constructor or an assignment runs, which is the\n// one behaviour a caller could tell apart.\n\n\n/**\n * The viewport a render context draws through.\n */\nexport class Tr2Viewport\n{\n  m_x = 0;\n\n  m_y = 0;\n\n  m_width = 0;\n\n  m_height = 0;\n\n  /**\n   * Near depth. Carbon's sized constructor sets 0; its default constructor leaves\n   * this uninitialised, which JavaScript cannot reproduce.\n   */\n  m_minZ = 0;\n\n  /** Far depth. Carbon's sized constructor sets 1. */\n  m_maxZ = 0;\n\n  /**\n   * @param {number} [width] Width in pixels; omit for Carbon's default constructor.\n   * @param {number} [height] Height in pixels.\n   */\n  constructor(width = undefined, height = undefined)\n  {\n    if (width === undefined && height === undefined) return;\n\n    this.m_x = 0;\n    this.m_y = 0;\n    this.m_width = Number(width);\n    this.m_height = Number(height);\n    this.m_minZ = 0;\n    this.m_maxZ = 1;\n  }\n}\n"],"names":["Tr2Viewport","m_x","m_y","m_width","m_height","m_minZ","m_maxZ","constructor","width","undefined","height","Number"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACO,MAAMA,WAAW,CACxB;AACEC,EAAAA,GAAG,GAAG,CAAC;AAEPC,EAAAA,GAAG,GAAG,CAAC;AAEPC,EAAAA,OAAO,GAAG,CAAC;AAEXC,EAAAA,QAAQ,GAAG,CAAC;;AAEZ;AACF;AACA;AACA;AACEC,EAAAA,MAAM,GAAG,CAAC;;AAEV;AACAC,EAAAA,MAAM,GAAG,CAAC;;AAEV;AACF;AACA;AACA;EACEC,WAAWA,CAACC,KAAK,GAAGC,SAAS,EAAEC,MAAM,GAAGD,SAAS,EACjD;AACE,IAAA,IAAID,KAAK,KAAKC,SAAS,IAAIC,MAAM,KAAKD,SAAS,EAAE;IAEjD,IAAI,CAACR,GAAG,GAAG,CAAC;IACZ,IAAI,CAACC,GAAG,GAAG,CAAC;AACZ,IAAA,IAAI,CAACC,OAAO,GAAGQ,MAAM,CAACH,KAAK,CAAC;AAC5B,IAAA,IAAI,CAACJ,QAAQ,GAAGO,MAAM,CAACD,MAAM,CAAC;IAC9B,IAAI,CAACL,MAAM,GAAG,CAAC;IACf,IAAI,CAACC,MAAM,GAAG,CAAC;AACjB,EAAA;AACF;;;;"}

package/dist/trinityal/{Tr2RenderPassAL.js → Tr2RenderPassAL/Tr2ColorAttachment.js}

@@ -1,6 +1,6 @@
-import '../global/consts/renderContext/formats.js';
-import '../global/consts/renderContext/pipeline.js';
-import { Tr2LoadAction, Tr2StoreAction } from '../global/consts/renderContext/renderPass.js';
+import '../../global/consts/renderContext/formats.js';
+import '../../global/consts/renderContext/pipeline.js';
+import { Tr2LoadAction, Tr2StoreAction } from '../../global/consts/renderContext/renderPass.js';
 
 // Source: trinity/trinityal/include/Tr2RenderPassAL.h
 //
@@ -11,29 +11,6 @@ import { Tr2LoadAction, Tr2StoreAction } from '../global/consts/renderContext/re
 // every call site in `EveSpaceScene.cpp`.
 
 
-/** How a pass treats its depth attachment. */
-class Tr2DepthAttachment {
-  /** What the pass does with the existing depth. */
-  load = Tr2LoadAction.DONT_CARE;
-
-  /** Whether the resulting depth is written back. */
-  store = Tr2StoreAction.DONT_CARE;
-
-  /** The depth a CLEAR load starts from. */
-  clearValue = 0;
-
-  /**
-   * @param {number} [load] A `Tr2LoadAction`.
-   * @param {number} [store] A `Tr2StoreAction`.
-   * @param {number} [clearValue] The depth a CLEAR starts from.
-   */
-  constructor(load = Tr2LoadAction.DONT_CARE, store = Tr2StoreAction.DONT_CARE, clearValue = 0) {
-    this.load = load;
-    this.store = store;
-    this.clearValue = clearValue;
-  }
-}
-
 /** How a pass treats one colour attachment. */
 class Tr2ColorAttachment {
   /** What the pass does with the existing colour. */
@@ -57,5 +34,5 @@ class Tr2ColorAttachment {
   }
 }
 
-export { Tr2ColorAttachment, Tr2DepthAttachment };
-//# sourceMappingURL=Tr2RenderPassAL.js.map
+export { Tr2ColorAttachment };
+//# sourceMappingURL=Tr2ColorAttachment.js.map

package/dist/trinityal/Tr2RenderPassAL/Tr2ColorAttachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2ColorAttachment.js","sources":["../../../../src/trinityal/Tr2RenderPassAL/Tr2ColorAttachment.js"],"sourcesContent":["// Source: trinity/trinityal/include/Tr2RenderPassAL.h\n//\n// The two attachment descriptions `RenderPassHint` takes.\n//\n// Both default to DONT_CARE/DONT_CARE, which is Carbon's default and is the\n// reason an empty `{}` reads as \"this attachment is not part of the hint\" at\n// every call site in `EveSpaceScene.cpp`.\n\nimport { Tr2LoadAction, Tr2StoreAction } from \"../../global/consts/renderContext/index.js\";\n\n/** How a pass treats one colour attachment. */\nexport class Tr2ColorAttachment\n{\n  /** What the pass does with the existing colour. */\n  load = Tr2LoadAction.DONT_CARE;\n\n  /** Whether the resulting colour is written back. */\n  store = Tr2StoreAction.DONT_CARE;\n\n  /** The packed colour a CLEAR load starts from. */\n  clearColor = 0;\n\n  /**\n   * @param {number} [load] A `Tr2LoadAction`.\n   * @param {number} [store] A `Tr2StoreAction`.\n   * @param {number} [clearColor] The packed colour a CLEAR starts from.\n   */\n  constructor(load = Tr2LoadAction.DONT_CARE, store = Tr2StoreAction.DONT_CARE, clearColor = 0)\n  {\n    this.load = load;\n    this.store = store;\n    this.clearColor = clearColor;\n  }\n}\n"],"names":["Tr2ColorAttachment","load","Tr2LoadAction","DONT_CARE","store","Tr2StoreAction","clearColor","constructor"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;;AAIA;AACO,MAAMA,kBAAkB,CAC/B;AACE;EACAC,IAAI,GAAGC,aAAa,CAACC,SAAS;;AAE9B;EACAC,KAAK,GAAGC,cAAc,CAACF,SAAS;;AAEhC;AACAG,EAAAA,UAAU,GAAG,CAAC;;AAEd;AACF;AACA;AACA;AACA;AACEC,EAAAA,WAAWA,CAACN,IAAI,GAAGC,aAAa,CAACC,SAAS,EAAEC,KAAK,GAAGC,cAAc,CAACF,SAAS,EAAEG,UAAU,GAAG,CAAC,EAC5F;IACE,IAAI,CAACL,IAAI,GAAGA,IAAI;IAChB,IAAI,CAACG,KAAK,GAAGA,KAAK;IAClB,IAAI,CAACE,UAAU,GAAGA,UAAU;AAC9B,EAAA;AACF;;;;"}

package/dist/trinityal/Tr2RenderPassAL/Tr2DepthAttachment.js

@@ -0,0 +1,38 @@
+import '../../global/consts/renderContext/formats.js';
+import '../../global/consts/renderContext/pipeline.js';
+import { Tr2LoadAction, Tr2StoreAction } from '../../global/consts/renderContext/renderPass.js';
+
+// Source: trinity/trinityal/include/Tr2RenderPassAL.h
+//
+// The two attachment descriptions `RenderPassHint` takes.
+//
+// Both default to DONT_CARE/DONT_CARE, which is Carbon's default and is the
+// reason an empty `{}` reads as "this attachment is not part of the hint" at
+// every call site in `EveSpaceScene.cpp`.
+
+
+/** How a pass treats its depth attachment. */
+class Tr2DepthAttachment {
+  /** What the pass does with the existing depth. */
+  load = Tr2LoadAction.DONT_CARE;
+
+  /** Whether the resulting depth is written back. */
+  store = Tr2StoreAction.DONT_CARE;
+
+  /** The depth a CLEAR load starts from. */
+  clearValue = 0;
+
+  /**
+   * @param {number} [load] A `Tr2LoadAction`.
+   * @param {number} [store] A `Tr2StoreAction`.
+   * @param {number} [clearValue] The depth a CLEAR starts from.
+   */
+  constructor(load = Tr2LoadAction.DONT_CARE, store = Tr2StoreAction.DONT_CARE, clearValue = 0) {
+    this.load = load;
+    this.store = store;
+    this.clearValue = clearValue;
+  }
+}
+
+export { Tr2DepthAttachment };
+//# sourceMappingURL=Tr2DepthAttachment.js.map

package/dist/trinityal/Tr2RenderPassAL/Tr2DepthAttachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2DepthAttachment.js","sources":["../../../../src/trinityal/Tr2RenderPassAL/Tr2DepthAttachment.js"],"sourcesContent":["// Source: trinity/trinityal/include/Tr2RenderPassAL.h\n//\n// The two attachment descriptions `RenderPassHint` takes.\n//\n// Both default to DONT_CARE/DONT_CARE, which is Carbon's default and is the\n// reason an empty `{}` reads as \"this attachment is not part of the hint\" at\n// every call site in `EveSpaceScene.cpp`.\n\nimport { Tr2LoadAction, Tr2StoreAction } from \"../../global/consts/renderContext/index.js\";\n\n/** How a pass treats its depth attachment. */\nexport class Tr2DepthAttachment\n{\n  /** What the pass does with the existing depth. */\n  load = Tr2LoadAction.DONT_CARE;\n\n  /** Whether the resulting depth is written back. */\n  store = Tr2StoreAction.DONT_CARE;\n\n  /** The depth a CLEAR load starts from. */\n  clearValue = 0;\n\n  /**\n   * @param {number} [load] A `Tr2LoadAction`.\n   * @param {number} [store] A `Tr2StoreAction`.\n   * @param {number} [clearValue] The depth a CLEAR starts from.\n   */\n  constructor(load = Tr2LoadAction.DONT_CARE, store = Tr2StoreAction.DONT_CARE, clearValue = 0)\n  {\n    this.load = load;\n    this.store = store;\n    this.clearValue = clearValue;\n  }\n}\n"],"names":["Tr2DepthAttachment","load","Tr2LoadAction","DONT_CARE","store","Tr2StoreAction","clearValue","constructor"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;;AAIA;AACO,MAAMA,kBAAkB,CAC/B;AACE;EACAC,IAAI,GAAGC,aAAa,CAACC,SAAS;;AAE9B;EACAC,KAAK,GAAGC,cAAc,CAACF,SAAS;;AAEhC;AACAG,EAAAA,UAAU,GAAG,CAAC;;AAEd;AACF;AACA;AACA;AACA;AACEC,EAAAA,WAAWA,CAACN,IAAI,GAAGC,aAAa,CAACC,SAAS,EAAEC,KAAK,GAAGC,cAAc,CAACF,SAAS,EAAEG,UAAU,GAAG,CAAC,EAC5F;IACE,IAAI,CAACL,IAAI,GAAGA,IAAI;IAChB,IAAI,CAACG,KAAK,GAAGA,KAAK;IAClB,IAAI,CAACE,UAAU,GAAGA,UAAU;AAC9B,EAAA;AACF;;;;"}

package/dist/trinityal/Tr2ResourceSetAL/Tr2RegisterMapAL.js

@@ -0,0 +1,80 @@
+import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { impl } from '#schema';
+import { ShaderType } from '#consts/render-context';
+
+let _initProto;
+const MAX_RESOURCES_IN_STAGE = 32;
+
+/** Stage/register to dense resource index, with counts spanning all stages. */
+class Tr2RegisterMapAL {
+  static {
+    [_initProto] = _applyDecs2311(this, [], [[[impl, impl.adapted, void 0, impl.reason("JavaScript spells the C++ equality operator as a method.")], 18, "equals"]]).e;
+  }
+  static MAX_RESOURCES_IN_STAGE = MAX_RESOURCES_IN_STAGE;
+  srvCount = (_initProto(this), 0);
+  uavCount = 0;
+  samplerCount = 0;
+  srvs = Array.from({
+    length: ShaderType.SHADER_TYPE_COUNT
+  }, () => new Uint8Array(MAX_RESOURCES_IN_STAGE).fill(255));
+  uavs = Array.from({
+    length: ShaderType.SHADER_TYPE_COUNT
+  }, () => new Uint8Array(MAX_RESOURCES_IN_STAGE).fill(255));
+  samplers = Array.from({
+    length: ShaderType.SHADER_TYPE_COUNT
+  }, () => new Uint8Array(MAX_RESOURCES_IN_STAGE).fill(255));
+
+  /** JS adaptation: named selectors replace C++ constructor overloads. */
+  constructor({
+    stage = null,
+    signature = null,
+    shaders = null,
+    stages = [],
+    signatures = [],
+    copy = null
+  } = {}) {
+    // Deterministic 255 replaces uninitialized default arrays. Carbon only
+    // reads a category's arrays when its count is nonzero.
+    if (copy) {
+      this.srvCount = copy.srvCount;
+      this.uavCount = copy.uavCount;
+      this.samplerCount = copy.samplerCount;
+      this.srvs = copy.srvs.map(row => row.slice());
+      this.uavs = copy.uavs.map(row => row.slice());
+      this.samplers = copy.samplers.map(row => row.slice());
+      return;
+    }
+    if (signature) {
+      stages = [stage];
+      signatures = [signature];
+    } else if (shaders) {
+      stages = shaders.map(shader => shader.GetType());
+      signatures = shaders.map(shader => shader.GetSignature());
+    }
+    for (let index = 0; index < signatures.length; index += 1) {
+      // Input order, including duplicate registers, is intentional (:34-119).
+      for (const register of signatures[index]?.registers ?? []) {
+        const shaderStage = stages[index];
+        const slot = register.registerIndex;
+        if (register.registerType & 32) this.srvs[shaderStage][slot] = this.srvCount++;else if (register.registerType & 64) this.uavs[shaderStage][slot] = this.uavCount++;else if (register.registerType === 1) this.samplers[shaderStage][slot] = this.samplerCount++;
+      }
+    }
+  }
+
+  /** Carbon's operator==; a struct method uses lower camel case. */
+  equals(other) {
+    for (const [count, slots] of [["srvCount", "srvs"], ["uavCount", "uavs"], ["samplerCount", "samplers"]]) {
+      if (this[count] !== other[count]) return false;
+      if (this[count] === 0) continue;
+      for (let stage = 0; stage < ShaderType.SHADER_TYPE_COUNT; stage += 1) {
+        for (let slot = 0; slot < MAX_RESOURCES_IN_STAGE; slot += 1) {
+          if (this[slots][stage][slot] !== other[slots][stage][slot]) return false;
+        }
+      }
+    }
+    return true;
+  }
+}
+
+export { MAX_RESOURCES_IN_STAGE, Tr2RegisterMapAL };
+//# sourceMappingURL=Tr2RegisterMapAL.js.map

package/dist/trinityal/Tr2ResourceSetAL/Tr2RegisterMapAL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2RegisterMapAL.js","sources":["../../../../src/trinityal/Tr2ResourceSetAL/Tr2RegisterMapAL.js"],"sourcesContent":["// Source: trinity/trinityal/include/Tr2ResourceSetAL.h:23\r\n// Source: trinity/trinityal/src/Tr2ResourceSetAL.cpp:27-144\r\nimport { impl } from \"#schema\";\r\nimport { ShaderType } from \"#consts/render-context\";\r\n\r\nexport const MAX_RESOURCES_IN_STAGE = 32;\r\n\r\n/** Stage/register to dense resource index, with counts spanning all stages. */\r\nexport class Tr2RegisterMapAL\r\n{\r\n  static MAX_RESOURCES_IN_STAGE = MAX_RESOURCES_IN_STAGE;\r\n\r\n  srvCount = 0;\r\n  uavCount = 0;\r\n  samplerCount = 0;\r\n  srvs = Array.from({ length: ShaderType.SHADER_TYPE_COUNT }, () => new Uint8Array(MAX_RESOURCES_IN_STAGE).fill(255));\r\n  uavs = Array.from({ length: ShaderType.SHADER_TYPE_COUNT }, () => new Uint8Array(MAX_RESOURCES_IN_STAGE).fill(255));\r\n  samplers = Array.from({ length: ShaderType.SHADER_TYPE_COUNT }, () => new Uint8Array(MAX_RESOURCES_IN_STAGE).fill(255));\r\n\r\n  /** JS adaptation: named selectors replace C++ constructor overloads. */\r\n  constructor({ stage = null, signature = null, shaders = null, stages = [], signatures = [], copy = null } = {})\r\n  {\r\n    // Deterministic 255 replaces uninitialized default arrays. Carbon only\r\n    // reads a category's arrays when its count is nonzero.\r\n    if (copy)\r\n    {\r\n      this.srvCount = copy.srvCount;\r\n      this.uavCount = copy.uavCount;\r\n      this.samplerCount = copy.samplerCount;\r\n      this.srvs = copy.srvs.map(row => row.slice());\r\n      this.uavs = copy.uavs.map(row => row.slice());\r\n      this.samplers = copy.samplers.map(row => row.slice());\r\n      return;\r\n    }\r\n    if (signature)\r\n    {\r\n      stages = [ stage ];\r\n      signatures = [ signature ];\r\n    }\r\n    else if (shaders)\r\n    {\r\n      stages = shaders.map(shader => shader.GetType());\r\n      signatures = shaders.map(shader => shader.GetSignature());\r\n    }\r\n    for (let index = 0; index < signatures.length; index += 1)\r\n    {\r\n      // Input order, including duplicate registers, is intentional (:34-119).\r\n      for (const register of (signatures[index]?.registers ?? []))\r\n      {\r\n        const shaderStage = stages[index];\r\n        const slot = register.registerIndex;\r\n        if (register.registerType & 32) this.srvs[shaderStage][slot] = this.srvCount++;\r\n        else if (register.registerType & 64) this.uavs[shaderStage][slot] = this.uavCount++;\r\n        else if (register.registerType === 1) this.samplers[shaderStage][slot] = this.samplerCount++;\r\n      }\r\n    }\r\n  }\r\n\r\n  /** Carbon's operator==; a struct method uses lower camel case. */\r\n  @impl.adapted\r\n  @impl.reason(\"JavaScript spells the C++ equality operator as a method.\")\r\n  equals(other)\r\n  {\r\n    for (const [ count, slots ] of [ [ \"srvCount\", \"srvs\" ], [ \"uavCount\", \"uavs\" ], [ \"samplerCount\", \"samplers\" ] ])\r\n    {\r\n      if (this[count] !== other[count]) return false;\r\n      if (this[count] === 0) continue;\r\n      for (let stage = 0; stage < ShaderType.SHADER_TYPE_COUNT; stage += 1)\r\n      {\r\n        for (let slot = 0; slot < MAX_RESOURCES_IN_STAGE; slot += 1)\r\n        {\r\n          if (this[slots][stage][slot] !== other[slots][stage][slot]) return false;\r\n        }\r\n      }\r\n    }\r\n    return true;\r\n  }\r\n}\r\n"],"names":["MAX_RESOURCES_IN_STAGE","Tr2RegisterMapAL","_initProto","_applyDecs","impl","adapted","reason","e","srvCount","uavCount","samplerCount","srvs","Array","from","length","ShaderType","SHADER_TYPE_COUNT","Uint8Array","fill","uavs","samplers","constructor","stage","signature","shaders","stages","signatures","copy","map","row","slice","shader","GetType","GetSignature","index","register","registers","shaderStage","slot","registerIndex","registerType","equals","other","count","slots"],"mappings":"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"}