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

package/dist/resource/shader/reflection/Tr2RenderStateSetup.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2RenderStateSetup.js","sources":["../../../../../src/resource/shader/reflection/Tr2RenderStateSetup.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectStateManager.h:104\n//   `typedef std::map<Tr2RenderContextEnum::RenderState, uint32_t> Tr2RenderStateSetup`\n//   registered by Tr2EffectStateManager::RegisterRenderStateSetup (:118), whose\n//   returned handle is what Tr2Pass stores in `renderStates`.\n//\n// Carbon keeps a setup raw and replays it onto a D3D device. Neither of our\n// backends is D3D, so the setup is interpreted here instead - once, so two\n// backends cannot disagree about what a Carbon render-state id means.\n//\n// Every Carbon vocabulary it reads comes from #consts/render-context rather\n// than being re-declared here. One object, however many names: a second frozen\n// copy of the same members drifts silently. The ids in particular are a trap -\n// RS_SCISSORTESTENABLE (174) exists in D3D9 and in ccpwgl but NOT in Carbon,\n// whose enum jumps 173 straight to 175.\n//\n// Generic members are named generically; anything true of only one backend is\n// named for that backend. `GetWebgpuRecipe` is a projection, not an override of\n// anything: no polymorphism dispatches on it, and a WebGL sibling returns a\n// different shape because WebGPU folds state into a pipeline at creation while\n// WebGL mutates it per draw.\nimport {\n  BlendMode,\n  BlendOperation,\n  ColorWriteEnable,\n  CompareFunc,\n  CullMode,\n  FillMode,\n  RenderState\n} from \"#consts/render-context\";\nimport { float32FromBits } from \"#utils/bytes\";\n\n/**\n * The render states this class interprets, by Carbon id.\n *\n * A subset with intent, taken from the shared table rather than hand-typed:\n * these are the states a draw needs. Everything else Carbon declares is\n * retained uninterpreted under `unhandled`.\n */\nconst RS = Object.freeze({\n  ZENABLE: RenderState.RS_ZENABLE,\n  FILLMODE: RenderState.RS_FILLMODE,\n  ZWRITEENABLE: RenderState.RS_ZWRITEENABLE,\n  ALPHATESTENABLE: RenderState.RS_ALPHATESTENABLE,\n  SRCBLEND: RenderState.RS_SRCBLEND,\n  DESTBLEND: RenderState.RS_DESTBLEND,\n  CULLMODE: RenderState.RS_CULLMODE,\n  ZFUNC: RenderState.RS_ZFUNC,\n  ALPHAREF: RenderState.RS_ALPHAREF,\n  ALPHAFUNC: RenderState.RS_ALPHAFUNC,\n  ALPHABLENDENABLE: RenderState.RS_ALPHABLENDENABLE,\n  COLORWRITEENABLE: RenderState.RS_COLORWRITEENABLE,\n  BLENDOP: RenderState.RS_BLENDOP,\n  SLOPESCALEDEPTHBIAS: RenderState.RS_SLOPESCALEDEPTHBIAS,\n  BLENDFACTOR: RenderState.RS_BLENDFACTOR,\n  SRGBWRITEENABLE: RenderState.RS_SRGBWRITEENABLE,\n  DEPTHBIAS: RenderState.RS_DEPTHBIAS,\n  SEPARATEALPHABLENDENABLE: RenderState.RS_SEPARATEALPHABLENDENABLE,\n  SRCBLENDALPHA: RenderState.RS_SRCBLENDALPHA,\n  DESTBLENDALPHA: RenderState.RS_DESTBLENDALPHA,\n  BLENDOPALPHA: RenderState.RS_BLENDOPALPHA\n});\n\nconst INTERPRETED = new Set(Object.values(RS));\n\n/**\n * Carbon comparison values to neutral spellings.\n *\n * The spelling is backend-neutral on purpose. WebGPU wants `less-equal` and\n * WebGL wants `LEQUAL`; deciding either here would bake a backend into a shared\n * property.\n */\nconst COMPARE = Object.freeze({\n  [CompareFunc.CMP_NEVER]: \"never\",\n  [CompareFunc.CMP_LESS]: \"less\",\n  [CompareFunc.CMP_EQUAL]: \"equal\",\n  [CompareFunc.CMP_LESSEQUAL]: \"lessEqual\",\n  [CompareFunc.CMP_GREATER]: \"greater\",\n  [CompareFunc.CMP_NOTEQUAL]: \"notEqual\",\n  [CompareFunc.CMP_GREATEREQUAL]: \"greaterEqual\",\n  [CompareFunc.CMP_ALWAYS]: \"always\"\n});\n\n/** Carbon blend modes to neutral spellings. */\nconst BLEND_FACTOR = Object.freeze({\n  [BlendMode.BM_ZERO]: \"zero\",\n  [BlendMode.BM_ONE]: \"one\",\n  [BlendMode.BM_SRCCOLOR]: \"srcColor\",\n  [BlendMode.BM_INVSRCCOLOR]: \"invSrcColor\",\n  [BlendMode.BM_SRCALPHA]: \"srcAlpha\",\n  [BlendMode.BM_INVSRCALPHA]: \"invSrcAlpha\",\n  [BlendMode.BM_DESTALPHA]: \"destAlpha\",\n  [BlendMode.BM_INVDESTALPHA]: \"invDestAlpha\",\n  [BlendMode.BM_DESTCOLOR]: \"destColor\",\n  [BlendMode.BM_INVDESTCOLOR]: \"invDestColor\",\n  [BlendMode.BM_SRCALPHASAT]: \"srcAlphaSat\",\n  [BlendMode.BM_BOTHSRCALPHA]: \"bothSrcAlpha\",\n  [BlendMode.BM_BOTHINVSRCALPHA]: \"bothInvSrcAlpha\",\n  [BlendMode.BM_BLENDFACTOR]: \"blendFactor\",\n  [BlendMode.BM_INVBLENDFACTOR]: \"invBlendFactor\"\n});\n\n/**\n * Carbon blend operations to neutral spellings.\n *\n * `BO_DISABLE` is a real Carbon member, not enum-width padding, so it maps\n * rather than throwing. A setup that authors it is not blending, whatever\n * ALPHABLENDENABLE says.\n */\nconst BLEND_OP = Object.freeze({\n  [BlendOperation.BO_DISABLE]: \"disable\",\n  [BlendOperation.BO_ADD]: \"add\",\n  [BlendOperation.BO_SUBTRACT]: \"subtract\",\n  [BlendOperation.BO_REVSUBTRACT]: \"revSubtract\",\n  [BlendOperation.BO_MIN]: \"min\",\n  [BlendOperation.BO_MAX]: \"max\"\n});\n\n/**\n * Carbon cull modes to neutral spellings, named by the winding DISCARDED.\n *\n * D3D names the winding to cull; a modern API names the face. The two agree\n * only once a front-face winding is chosen, and that belongs to the backend\n * projection rather than to the authored setup.\n */\nconst CULL = Object.freeze({\n  [CullMode.CULLMODE_NONE]: \"none\",\n  [CullMode.CULLMODE_CW]: \"cw\",\n  [CullMode.CULLMODE_CCW]: \"ccw\"\n});\n\n/** Carbon fill modes to neutral spellings. */\nconst FILL = Object.freeze({\n  [FillMode.FM_POINT]: \"point\",\n  [FillMode.FM_WIREFRAME]: \"wireframe\",\n  [FillMode.FM_SOLID]: \"solid\"\n});\n\n/**\n * Carbon's inverted-depth-test override, as a neutral mapping.\n *\n * `Tr2EffectStateManager::SetInvertedDepthTest` (Tr2EffectStateManager.cpp:834)\n * installs an RS_ZFUNC override table that swaps the ordered comparisons and\n * leaves the order-free ones alone. This is the same table in our spelling.\n */\nconst INVERTED_COMPARE = Object.freeze({\n  never: \"never\",\n  less: \"greater\",\n  equal: \"equal\",\n  lessEqual: \"greaterEqual\",\n  greater: \"less\",\n  notEqual: \"notEqual\",\n  greaterEqual: \"lessEqual\",\n  always: \"always\"\n});\n\n/**\n * Carbon's inverted-cull override, as a neutral mapping.\n *\n * `Tr2EffectStateManager::SetInvertedCullMode` (Tr2EffectStateManager.cpp:815)\n * installs an RS_CULLMODE override that swaps the two windings and leaves\n * `none` alone.\n */\nconst INVERTED_CULL = Object.freeze({ none: \"none\", cw: \"ccw\", ccw: \"cw\" });\n\n/** Neutral comparison spellings to WebGPU's. */\nconst WEBGPU_COMPARE = Object.freeze({\n  never: \"never\",\n  less: \"less\",\n  equal: \"equal\",\n  lessEqual: \"less-equal\",\n  greater: \"greater\",\n  notEqual: \"not-equal\",\n  greaterEqual: \"greater-equal\",\n  always: \"always\"\n});\n\n/**\n * Neutral blend factors to WebGPU's.\n *\n * `bothSrcAlpha` and `bothInvSrcAlpha` are absent: they are D3D9 fixed-function\n * modes that set the source and destination factors together, and WebGPU has no\n * equivalent. They fail rather than being approximated.\n */\nconst WEBGPU_BLEND_FACTOR = Object.freeze({\n  zero: \"zero\",\n  one: \"one\",\n  srcColor: \"src\",\n  invSrcColor: \"one-minus-src\",\n  srcAlpha: \"src-alpha\",\n  invSrcAlpha: \"one-minus-src-alpha\",\n  destAlpha: \"dst-alpha\",\n  invDestAlpha: \"one-minus-dst-alpha\",\n  destColor: \"dst\",\n  invDestColor: \"one-minus-dst\",\n  srcAlphaSat: \"src-alpha-saturated\",\n  blendFactor: \"constant\",\n  invBlendFactor: \"one-minus-constant\"\n});\n\n/**\n * Neutral blend equations to WebGPU's.\n *\n * `disable` is absent: WebGPU expresses \"not blending\" by omitting the blend\n * member, so a disabled operation is resolved before this table is consulted.\n */\nconst WEBGPU_BLEND_OP = Object.freeze({\n  add: \"add\",\n  subtract: \"subtract\",\n  revSubtract: \"reverse-subtract\",\n  min: \"min\",\n  max: \"max\"\n});\n\n/**\n * Depth-format mantissa widths, for the WebGPU bias conversion.\n *\n * A UNORM depth buffer's smallest increment is `1 / (2^bits - 1)`, so a float\n * bias multiplies by that many units. `depth32float` has no fixed increment -\n * WebGPU defines the unit as format-dependent and implementation-chosen there -\n * so a float bias cannot be converted exactly and is refused.\n */\nconst WEBGPU_DEPTH_UNORM_BITS = Object.freeze({\n  depth16unorm: 16,\n  depth24plus: 24,\n  \"depth24plus-stencil8\": 24\n});\n\n/**\n * WebGPU front-face winding, stated once.\n *\n * Carbon runs D3D's default rasterizer state, in which a clockwise winding is\n * the front face. Every WebGPU cull decision is relative to this.\n */\nconst WEBGPU_FRONT_FACE = \"cw\";\n\n/**\n * Authored values a setup inherits when it sets nothing.\n *\n * These are the D3D defaults Carbon inherits, named through the shared\n * vocabulary rather than repeated as numbers.\n */\nconst DEFAULT_DEPTH_COMPARE = CompareFunc.CMP_LESSEQUAL;\nconst DEFAULT_CULL = CullMode.CULLMODE_CCW;\nconst DEFAULT_FILL = FillMode.FM_SOLID;\nconst DEFAULT_SRC_BLEND = BlendMode.BM_ONE;\nconst DEFAULT_DEST_BLEND = BlendMode.BM_ZERO;\nconst DEFAULT_BLEND_OP = BlendOperation.BO_ADD;\nconst DEFAULT_ALPHA_FUNC = CompareFunc.CMP_ALWAYS;\nconst DEFAULT_COLOR_WRITE = ColorWriteEnable.COLORWRITEENABLE_RED\n  | ColorWriteEnable.COLORWRITEENABLE_GREEN\n  | ColorWriteEnable.COLORWRITEENABLE_BLUE\n  | ColorWriteEnable.COLORWRITEENABLE_ALPHA;\n\n/**\n * Looks a value up in a mapping table, failing on an unmapped one.\n *\n * A silently substituted default here is a wrong draw with no error, which is\n * the expensive failure mode.\n *\n * @param {object} table Mapping table.\n * @param {string|number} value Value to map.\n * @param {string} message Failure message, already naming what was being mapped.\n * @returns {string} Mapped value.\n */\nfunction mapOrFail(table, value, message)\n{\n  const mapped = table[value];\n  if (mapped === undefined) throw new RangeError(message);\n  return mapped;\n}\n\n/**\n * Splits a Carbon colour-write mask into channel flags.\n *\n * @param {number} value Raw mask.\n * @returns {object} Per-channel flags.\n */\nfunction colorWriteMask(value)\n{\n  return {\n    red: (value & ColorWriteEnable.COLORWRITEENABLE_RED) !== 0,\n    green: (value & ColorWriteEnable.COLORWRITEENABLE_GREEN) !== 0,\n    blue: (value & ColorWriteEnable.COLORWRITEENABLE_BLUE) !== 0,\n    alpha: (value & ColorWriteEnable.COLORWRITEENABLE_ALPHA) !== 0\n  };\n}\n\n/**\n * Splits a D3DCOLOR blend constant into normalised channels.\n *\n * @param {number} value Raw ARGB colour.\n * @returns {object} Normalised channels.\n */\nfunction blendConstant(value)\n{\n  const unsigned = value >>> 0;\n  return {\n    r: ((unsigned >>> 16) & 0xff) / 255,\n    g: ((unsigned >>> 8) & 0xff) / 255,\n    b: (unsigned & 0xff) / 255,\n    a: ((unsigned >>> 24) & 0xff) / 255\n  };\n}\n\n/**\n * Translates one blend component into WebGPU's vocabulary.\n *\n * @param {{src:string,dst:string,op:string}} component Neutral factors.\n * @returns {object} WebGPU blend component.\n */\nfunction webgpuBlendComponent(component)\n{\n  return {\n    srcFactor: mapOrFail(\n      WEBGPU_BLEND_FACTOR,\n      component.src,\n      `WebGPU has no blend factor equivalent for Carbon's \"${component.src}\"`\n    ),\n    dstFactor: mapOrFail(\n      WEBGPU_BLEND_FACTOR,\n      component.dst,\n      `WebGPU has no blend factor equivalent for Carbon's \"${component.dst}\"`\n    ),\n    operation: mapOrFail(\n      WEBGPU_BLEND_OP,\n      component.op,\n      `WebGPU has no blend operation equivalent for Carbon's \"${component.op}\"`\n    )\n  };\n}\n\n/** One pass's registered set of render states, interpreted. */\nexport class Tr2RenderStateSetup\n{\n\n  /**\n   * The raw `[state, value]` pairs this setup actually AUTHORED.\n   *\n   * RETAINED BECAUSE UNAUTHORED IS NOT THE SAME AS DEFAULT, and losing that\n   * distinction cost a hull. Every field below resolves to a default when the\n   * pass is silent about it, which reads correctly for one setup and is wrong\n   * the moment two are applied in sequence. Carbon sets render states one at a\n   * time through D3D, where they are STICKY: `ApplyStandardStates` puts the\n   * rendering mode's block down - for RM_OPAQUE that includes `CULLMODE_CW` -\n   * and a pass setup that never mentions cull leaves it standing.\n   *\n   * Ours replaced the whole block, so the pass's silence became the default\n   * `CULLMODE_CCW`, which culls the BACK faces where the mode asked to cull the\n   * FRONT ones. Every EVE hull then drew its interior: the silhouette is right\n   * and the surfaces are the wrong ones, which is a hard thing to see.\n   * `Overlay` below is what lets a setup be applied without erasing what it did\n   * not speak about.\n   */\n  authoredStates = [];\n\n  /** Depth test, write, comparison, and the two bias terms. */\n  depth = {\n    test: true,\n    write: true,\n    compare: \"lessEqual\",\n    bias: 0,\n    slopeScaledBias: 0\n  };\n\n  /** Winding that is discarded: `none`, `cw` or `ccw`. */\n  cull = \"ccw\";\n\n  /** Rasterizer fill: `solid`, `wireframe` or `point`. */\n  fill = \"solid\";\n\n  /** Blend factors and equation, or null when the setup does not blend. */\n  blend = null;\n\n  /** Per-channel colour write flags. */\n  colorWrite = { red: true, green: true, blue: true, alpha: true };\n\n  /** Comparison and reference, or null when the setup does not alpha test. */\n  alphaTest = null;\n\n  /** Whether the setup writes sRGB-encoded colour. */\n  srgbWrite = false;\n\n  /**\n   * Authored states this class does not interpret, retained verbatim.\n   *\n   * Stencil, fog, the fixed-function lighting states and point sprites land\n   * here rather than being dropped, so a consumer that meets one can assert on\n   * it instead of silently rendering without it. Nothing in the current draw\n   * path authors them.\n   */\n  unhandled = [];\n\n  // The shared vocabularies, aliased rather than re-declared: one object with a\n  // class-scoped name, which is what enum placement requires.\n\n  /** @see CompareFunc */\n  static CompareFunc = CompareFunc;\n\n  /** @see BlendMode */\n  static BlendMode = BlendMode;\n\n  /** @see BlendOperation */\n  static BlendOperation = BlendOperation;\n\n  /** @see CullMode */\n  static CullMode = CullMode;\n\n  /** @see FillMode */\n  static FillMode = FillMode;\n\n  /** @see ColorWriteEnable */\n  static ColorWriteEnable = ColorWriteEnable;\n\n  /**\n   * Interprets a flat `[state, value, state, value, ...]` list, which is how\n   * Carbon stores its built-in rendering-mode setups.\n   *\n   * MERGING IS CONCATENATION. Carbon re-applies a rendering mode's standard\n   * states immediately before a pass's own every time it applies them\n   * (Tr2EffectStateManager.cpp:716), so the effective state is the mode's list\n   * with the pass's overlaid. Passing `[...standard, ...pass]` yields exactly\n   * that, because a repeated state id overwrites the earlier one.\n   *\n   * @param {Array<number>} keyValues Flat state/value pairs.\n   * @returns {Tr2RenderStateSetup} Interpreted setup.\n   * @throws {RangeError} When the list has an odd length.\n   */\n  static fromKeyValues(keyValues)\n  {\n    const pairs = keyValues ?? [];\n\n    if (pairs.length % 2 !== 0)\n    {\n      throw new RangeError(\"a render-state key/value list must have an even length\");\n    }\n\n    const renderStateValues = [];\n\n    for (let i = 0; i < pairs.length; i += 2)\n    {\n      renderStateValues.push({ state: pairs[i], value: pairs[i + 1] });\n    }\n\n    return this.fromPass({ renderStateValues });\n  }\n\n\n  /**\n   * Interprets one reflected pass's authored render states.\n   *\n   * `depth.test` folds D3D's ZENABLE, including `D3DZB_USEW` (2), which enables\n   * the test; the W-buffer distinction has no modern equivalent and no\n   * consumer.\n   *\n   * The two bias values are reinterpreted float bits, not integers. Carbon\n   * stores them as raw uint32 patterns like every other float-valued render\n   * state.\n   *\n   * @param {{renderStateValues?: Array<{state:number,value:number}>}} pass Reflected pass.\n   * @returns {Tr2RenderStateSetup} Interpreted setup.\n   */\n  static fromPass(pass)\n  {\n    const authored = new Map();\n    for (const entry of pass?.renderStateValues ?? [])\n    {\n      authored.set(Number(entry.state), Number(entry.value));\n    }\n\n    const read = (id, fallback) => (authored.has(id) ? authored.get(id) : fallback);\n    const mapState = (table, id, fallback, name) =>\n    {\n      const value = read(id, fallback);\n      return mapOrFail(\n        table,\n        value,\n        `Carbon render state ${name} has no mapping for value ${value}`\n      );\n    };\n\n    const setup = new this();\n\n    setup.depth = {\n      test: read(RS.ZENABLE, 1) !== 0,\n      write: read(RS.ZWRITEENABLE, 1) !== 0,\n      compare: mapState(COMPARE, RS.ZFUNC, DEFAULT_DEPTH_COMPARE, \"RS_ZFUNC\"),\n      bias: float32FromBits(read(RS.DEPTHBIAS, 0)),\n      slopeScaledBias: float32FromBits(read(RS.SLOPESCALEDEPTHBIAS, 0))\n    };\n    setup.cull = mapState(CULL, RS.CULLMODE, DEFAULT_CULL, \"RS_CULLMODE\");\n    setup.fill = mapState(FILL, RS.FILLMODE, DEFAULT_FILL, \"RS_FILLMODE\");\n    setup.colorWrite = colorWriteMask(read(RS.COLORWRITEENABLE, DEFAULT_COLOR_WRITE));\n    setup.srgbWrite = read(RS.SRGBWRITEENABLE, 0) !== 0;\n\n    if (read(RS.ALPHABLENDENABLE, 0) !== 0)\n    {\n      const srcBlend = read(RS.SRCBLEND, DEFAULT_SRC_BLEND);\n      const destBlend = read(RS.DESTBLEND, DEFAULT_DEST_BLEND);\n      const blendOp = read(RS.BLENDOP, DEFAULT_BLEND_OP);\n      const color = {\n        src: mapState(BLEND_FACTOR, RS.SRCBLEND, DEFAULT_SRC_BLEND, \"RS_SRCBLEND\"),\n        dst: mapState(BLEND_FACTOR, RS.DESTBLEND, DEFAULT_DEST_BLEND, \"RS_DESTBLEND\"),\n        op: mapState(BLEND_OP, RS.BLENDOP, DEFAULT_BLEND_OP, \"RS_BLENDOP\")\n      };\n      // BO_DISABLE means the setup is not blending, however ALPHABLENDENABLE reads.\n      if (color.op !== \"disable\")\n      {\n        setup.blend = {\n          color,\n          alpha: read(RS.SEPARATEALPHABLENDENABLE, 0) !== 0\n            ? {\n              src: mapState(BLEND_FACTOR, RS.SRCBLENDALPHA, srcBlend, \"RS_SRCBLENDALPHA\"),\n              dst: mapState(BLEND_FACTOR, RS.DESTBLENDALPHA, destBlend, \"RS_DESTBLENDALPHA\"),\n              op: mapState(BLEND_OP, RS.BLENDOPALPHA, blendOp, \"RS_BLENDOPALPHA\")\n            }\n            : { ...color },\n          constant: authored.has(RS.BLENDFACTOR)\n            ? blendConstant(authored.get(RS.BLENDFACTOR))\n            : null\n        };\n      }\n    }\n\n    if (read(RS.ALPHATESTENABLE, 0) !== 0)\n    {\n      setup.alphaTest = {\n        compare: mapState(COMPARE, RS.ALPHAFUNC, DEFAULT_ALPHA_FUNC, \"RS_ALPHAFUNC\"),\n        ref: read(RS.ALPHAREF, 0)\n      };\n    }\n\n    for (const [ state, value ] of authored)\n    {\n      if (!INTERPRETED.has(state)) setup.unhandled.push({ state, value });\n    }\n    setup.unhandled.sort((left, right) => left.state - right.state);\n\n    setup.authoredStates = [ ...authored ].sort((left, right) => left[0] - right[0]);\n\n    return setup;\n  }\n\n\n  /**\n   * A setup carrying `base`'s states with `over`'s authored ones on top.\n   *\n   * This is what makes a sequence of applies behave the way D3D's do, where a\n   * state nobody set this draw keeps the value the last one gave it. Carbon\n   * relies on that: `ApplyStandardStates` lays down the rendering mode's block\n   * and a pass setup then speaks only for what it changes.\n   *\n   * Returns `over` unchanged when it authors everything `base` did, so the\n   * common case allocates nothing and the interned setup is preserved.\n   *\n   * @param {Tr2RenderStateSetup|null} base The states already in effect.\n   * @param {Tr2RenderStateSetup|null} over The setup being applied.\n   * @returns {Tr2RenderStateSetup|null} The combined setup.\n   */\n  static Overlay(base, over)\n  {\n    if (!base) return over;\n    if (!over) return base;\n\n    const combined = new Map(base.authoredStates);\n\n    for (const [ state, value ] of over.authoredStates) combined.set(state, value);\n\n    // Nothing of the base survived, so the applied setup already says it all.\n    if (combined.size === over.authoredStates.length) return over;\n\n    return Tr2RenderStateSetup.fromPass({\n      renderStateValues: [ ...combined ].map(([ state, value ]) => ({ state, value }))\n    });\n  }\n\n  /**\n   * A canonical string identifying this exact set of states.\n   *\n   * Carbon gives a registered setup a handle through\n   * `RegisterRenderStateSetup` and reuses it across passes; this is that\n   * handle's portable equivalent. It is the canonical serialization rather than\n   * a hash, so two different setups cannot collide - a setup is small enough to\n   * make that affordable, for the same reason the WebGPU pipeline cache\n   * serializes its recipes exactly.\n   *\n   * Uninterpreted states take part, so two passes that differ only in a state\n   * nothing reads are not treated as one.\n   *\n   * @returns {string} Canonical identity.\n   */\n  Key()\n  {\n    return JSON.stringify([\n      this.depth.test,\n      this.depth.write,\n      this.depth.compare,\n      this.depth.bias,\n      this.depth.slopeScaledBias,\n      this.cull,\n      this.fill,\n      this.blend && [\n        this.blend.color.src, this.blend.color.dst, this.blend.color.op,\n        this.blend.alpha.src, this.blend.alpha.dst, this.blend.alpha.op,\n        this.blend.constant && [\n          this.blend.constant.r,\n          this.blend.constant.g,\n          this.blend.constant.b,\n          this.blend.constant.a\n        ]\n      ],\n      [ this.colorWrite.red, this.colorWrite.green, this.colorWrite.blue, this.colorWrite.alpha ],\n      this.alphaTest && [ this.alphaTest.compare, this.alphaTest.ref ],\n      this.srgbWrite,\n      this.unhandled.map(entry => [ entry.state, entry.value ])\n    ]);\n  }\n\n  /**\n   * Projects this setup into WebGPU pipeline state.\n   *\n   * The return is the state half of a pipeline recipe, not a whole recipe: the\n   * caller owns topology, vertex buffer layouts and target formats, and merges\n   * `primitive` and `depthStencil` into its recipe and `target` into the entry\n   * of `fragment.targets` this pass writes.\n   *\n   * `depthStencil` is null when there is no depth attachment, because a WebGPU\n   * pipeline may not declare depth state without one. Pass `depthFormat` as\n   * null to say so; a setup that authored a depth bias then fails rather than\n   * losing it silently.\n   *\n   * `invertedDepthTest` and `invertedCullMode` are Carbon's two render-state\n   * overrides, which it installs on the state manager rather than authoring per\n   * pass - reversed depth and mirrored rendering respectively. They belong here\n   * rather than on the setup because the same registered setup is drawn both\n   * ways. Applying one changes the projection, and therefore the caller's\n   * pipeline cache key, which is what keeps the two variants distinct.\n   *\n   * Alpha test is returned untranslated. It is not pipeline state in WebGPU -\n   * the compiled shader already discards - so the caller is handed the authored\n   * intent instead of having it dropped here.\n   *\n   * @param {object} [options] Properties the authored setup cannot know.\n   * @param {string|null} [options.depthFormat] Depth attachment format, or null when there is none.\n   * @param {boolean} [options.invertedDepthTest] Apply Carbon's RS_ZFUNC override.\n   * @param {boolean} [options.invertedCullMode] Apply Carbon's RS_CULLMODE override.\n   * @returns {object} WebGPU pipeline state plus the untranslated authored intent.\n   */\n  GetWebgpuRecipe(options = {})\n  {\n    const depthFormat = options.depthFormat === undefined ? \"depth24plus\" : options.depthFormat;\n\n    if (this.fill !== \"solid\")\n    {\n      throw new RangeError(`WebGPU cannot rasterize Carbon fill mode \"${this.fill}\"`);\n    }\n\n    const cull = options.invertedCullMode ? INVERTED_CULL[this.cull] : this.cull;\n    const compare = options.invertedDepthTest\n      ? INVERTED_COMPARE[this.depth.compare]\n      : this.depth.compare;\n\n    const hasBias = this.depth.bias !== 0 || this.depth.slopeScaledBias !== 0;\n    if (depthFormat === null && (this.depth.test || this.depth.write || hasBias))\n    {\n      throw new Error(\"pass authors depth state but no depth attachment was supplied\");\n    }\n\n    let depthBias = 0;\n    if (this.depth.bias !== 0)\n    {\n      const bits = WEBGPU_DEPTH_UNORM_BITS[depthFormat];\n      if (bits === undefined)\n      {\n        throw new RangeError(\n          `Carbon's fractional depth bias cannot be converted for depth format \"${depthFormat}\"`\n        );\n      }\n      depthBias = Math.round(this.depth.bias * (2 ** bits - 1));\n    }\n\n    // The channel bits are the same in both vocabularies, so the mask is rebuilt\n    // through the shared flags rather than through literals.\n    const writeMask = (this.colorWrite.red ? ColorWriteEnable.COLORWRITEENABLE_RED : 0)\n      | (this.colorWrite.green ? ColorWriteEnable.COLORWRITEENABLE_GREEN : 0)\n      | (this.colorWrite.blue ? ColorWriteEnable.COLORWRITEENABLE_BLUE : 0)\n      | (this.colorWrite.alpha ? ColorWriteEnable.COLORWRITEENABLE_ALPHA : 0);\n\n    return {\n      primitive: {\n        cullMode: cull === \"none\" ? \"none\" : (cull === WEBGPU_FRONT_FACE ? \"front\" : \"back\"),\n        frontFace: WEBGPU_FRONT_FACE\n      },\n      depthStencil: depthFormat === null\n        ? null\n        : {\n          format: depthFormat,\n          depthWriteEnabled: this.depth.write,\n          // A disabled depth test is expressed as an always-passing compare,\n          // which is what WebGPU offers; there is no separate enable.\n          depthCompare: this.depth.test\n            ? mapOrFail(\n              WEBGPU_COMPARE,\n              compare,\n              `WebGPU has no depth comparison equivalent for Carbon's \"${compare}\"`\n            )\n            : \"always\",\n          ...(hasBias\n            ? { depthBias, depthBiasSlopeScale: this.depth.slopeScaledBias, depthBiasClamp: 0 }\n            : {})\n        },\n      target: {\n        writeMask,\n        ...(this.blend\n          ? {\n            blend: {\n              color: webgpuBlendComponent(this.blend.color),\n              alpha: webgpuBlendComponent(this.blend.alpha)\n            }\n          }\n          : {})\n      },\n      // Set only when the setup authored one; the caller applies it per render pass.\n      blendConstant: this.blend?.constant ?? null,\n      alphaTest: this.alphaTest,\n      unhandled: this.unhandled\n    };\n  }\n\n}\n"],"names":["RS","Object","freeze","ZENABLE","RenderState","RS_ZENABLE","FILLMODE","RS_FILLMODE","ZWRITEENABLE","RS_ZWRITEENABLE","ALPHATESTENABLE","RS_ALPHATESTENABLE","SRCBLEND","RS_SRCBLEND","DESTBLEND","RS_DESTBLEND","CULLMODE","RS_CULLMODE","ZFUNC","RS_ZFUNC","ALPHAREF","RS_ALPHAREF","ALPHAFUNC","RS_ALPHAFUNC","ALPHABLENDENABLE","RS_ALPHABLENDENABLE","COLORWRITEENABLE","RS_COLORWRITEENABLE","BLENDOP","RS_BLENDOP","SLOPESCALEDEPTHBIAS","RS_SLOPESCALEDEPTHBIAS","BLENDFACTOR","RS_BLENDFACTOR","SRGBWRITEENABLE","RS_SRGBWRITEENABLE","DEPTHBIAS","RS_DEPTHBIAS","SEPARATEALPHABLENDENABLE","RS_SEPARATEALPHABLENDENABLE","SRCBLENDALPHA","RS_SRCBLENDALPHA","DESTBLENDALPHA","RS_DESTBLENDALPHA","BLENDOPALPHA","RS_BLENDOPALPHA","INTERPRETED","Set","values","COMPARE","CompareFunc","CMP_NEVER","CMP_LESS","CMP_EQUAL","CMP_LESSEQUAL","CMP_GREATER","CMP_NOTEQUAL","CMP_GREATEREQUAL","CMP_ALWAYS","BLEND_FACTOR","BlendMode","BM_ZERO","BM_ONE","BM_SRCCOLOR","BM_INVSRCCOLOR","BM_SRCALPHA","BM_INVSRCALPHA","BM_DESTALPHA","BM_INVDESTALPHA","BM_DESTCOLOR","BM_INVDESTCOLOR","BM_SRCALPHASAT","BM_BOTHSRCALPHA","BM_BOTHINVSRCALPHA","BM_BLENDFACTOR","BM_INVBLENDFACTOR","BLEND_OP","BlendOperation","BO_DISABLE","BO_ADD","BO_SUBTRACT","BO_REVSUBTRACT","BO_MIN","BO_MAX","CULL","CullMode","CULLMODE_NONE","CULLMODE_CW","CULLMODE_CCW","FILL","FillMode","FM_POINT","FM_WIREFRAME","FM_SOLID","INVERTED_COMPARE","never","less","equal","lessEqual","greater","notEqual","greaterEqual","always","INVERTED_CULL","none","cw","ccw","WEBGPU_COMPARE","WEBGPU_BLEND_FACTOR","zero","one","srcColor","invSrcColor","srcAlpha","invSrcAlpha","destAlpha","invDestAlpha","destColor","invDestColor","srcAlphaSat","blendFactor","invBlendFactor","WEBGPU_BLEND_OP","add","subtract","revSubtract","min","max","WEBGPU_DEPTH_UNORM_BITS","depth16unorm","depth24plus","WEBGPU_FRONT_FACE","DEFAULT_DEPTH_COMPARE","DEFAULT_CULL","DEFAULT_FILL","DEFAULT_SRC_BLEND","DEFAULT_DEST_BLEND","DEFAULT_BLEND_OP","DEFAULT_ALPHA_FUNC","DEFAULT_COLOR_WRITE","ColorWriteEnable","COLORWRITEENABLE_RED","COLORWRITEENABLE_GREEN","COLORWRITEENABLE_BLUE","COLORWRITEENABLE_ALPHA","mapOrFail","table","value","message","mapped","undefined","RangeError","colorWriteMask","red","green","blue","alpha","blendConstant","unsigned","r","g","b","a","webgpuBlendComponent","component","srcFactor","src","dstFactor","dst","operation","op","Tr2RenderStateSetup","authoredStates","depth","test","write","compare","bias","slopeScaledBias","cull","fill","blend","colorWrite","alphaTest","srgbWrite","unhandled","fromKeyValues","keyValues","pairs","length","renderStateValues","i","push","state","fromPass","pass","authored","Map","entry","set","Number","read","id","fallback","has","get","mapState","name","setup","float32FromBits","srcBlend","destBlend","blendOp","color","constant","ref","sort","left","right","Overlay","base","over","combined","size","map","Key","JSON","stringify","GetWebgpuRecipe","options","depthFormat","invertedCullMode","invertedDepthTest","hasBias","Error","depthBias","bits","Math","round","writeMask","primitive","cullMode","frontFace","depthStencil","format","depthWriteEnabled","depthCompare","depthBiasSlopeScale","depthBiasClamp","target"],"mappings":"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"}
+{"version":3,"file":"Tr2RenderStateSetup.js","sources":["../../../../../src/resource/shader/reflection/Tr2RenderStateSetup.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectStateManager.h:104\n//   `typedef std::map<Tr2RenderContextEnum::RenderState, uint32_t> Tr2RenderStateSetup`\n//   registered by Tr2EffectStateManager::RegisterRenderStateSetup (:118), whose\n//   returned handle is what Tr2Pass stores in `renderStates`.\n//\n// Carbon keeps a setup raw and replays it onto a D3D device. Neither of our\n// backends is D3D, so the setup is interpreted here instead - once, so two\n// backends cannot disagree about what a Carbon render-state id means.\n//\n// Every Carbon vocabulary it reads comes from #consts/render-context rather\n// than being re-declared here. One object, however many names: a second frozen\n// copy of the same members drifts silently. The ids in particular are a trap -\n// RS_SCISSORTESTENABLE (174) exists in D3D9 and in ccpwgl but NOT in Carbon,\n// whose enum jumps 173 straight to 175.\n//\n// Generic members are named generically; anything true of only one backend is\n// named for that backend. `GetWebgpuRecipe` is a projection, not an override of\n// anything: no polymorphism dispatches on it, and a WebGL sibling returns a\n// different shape because WebGPU folds state into a pipeline at creation while\n// WebGL mutates it per draw.\nimport { color } from \"#math/color\";\nimport {\n  BlendMode,\n  BlendOperation,\n  ColorWriteEnable,\n  CompareFunc,\n  CullMode,\n  FillMode,\n  RenderState\n} from \"#consts/render-context\";\nimport { float32FromBits } from \"#utils/bytes\";\n\n/**\n * The render states this class interprets, by Carbon id.\n *\n * A subset with intent, taken from the shared table rather than hand-typed:\n * these are the states a draw needs. Everything else Carbon declares is\n * retained uninterpreted under `unhandled`.\n */\nconst RS = Object.freeze({\n  ZENABLE: RenderState.RS_ZENABLE,\n  FILLMODE: RenderState.RS_FILLMODE,\n  ZWRITEENABLE: RenderState.RS_ZWRITEENABLE,\n  ALPHATESTENABLE: RenderState.RS_ALPHATESTENABLE,\n  SRCBLEND: RenderState.RS_SRCBLEND,\n  DESTBLEND: RenderState.RS_DESTBLEND,\n  CULLMODE: RenderState.RS_CULLMODE,\n  ZFUNC: RenderState.RS_ZFUNC,\n  ALPHAREF: RenderState.RS_ALPHAREF,\n  ALPHAFUNC: RenderState.RS_ALPHAFUNC,\n  ALPHABLENDENABLE: RenderState.RS_ALPHABLENDENABLE,\n  COLORWRITEENABLE: RenderState.RS_COLORWRITEENABLE,\n  BLENDOP: RenderState.RS_BLENDOP,\n  SLOPESCALEDEPTHBIAS: RenderState.RS_SLOPESCALEDEPTHBIAS,\n  BLENDFACTOR: RenderState.RS_BLENDFACTOR,\n  SRGBWRITEENABLE: RenderState.RS_SRGBWRITEENABLE,\n  DEPTHBIAS: RenderState.RS_DEPTHBIAS,\n  SEPARATEALPHABLENDENABLE: RenderState.RS_SEPARATEALPHABLENDENABLE,\n  SRCBLENDALPHA: RenderState.RS_SRCBLENDALPHA,\n  DESTBLENDALPHA: RenderState.RS_DESTBLENDALPHA,\n  BLENDOPALPHA: RenderState.RS_BLENDOPALPHA\n});\n\nconst INTERPRETED = new Set(Object.values(RS));\n\n/**\n * Carbon comparison values to neutral spellings.\n *\n * The spelling is backend-neutral on purpose. WebGPU wants `less-equal` and\n * WebGL wants `LEQUAL`; deciding either here would bake a backend into a shared\n * property.\n */\nconst COMPARE = Object.freeze({\n  [CompareFunc.CMP_NEVER]: \"never\",\n  [CompareFunc.CMP_LESS]: \"less\",\n  [CompareFunc.CMP_EQUAL]: \"equal\",\n  [CompareFunc.CMP_LESSEQUAL]: \"lessEqual\",\n  [CompareFunc.CMP_GREATER]: \"greater\",\n  [CompareFunc.CMP_NOTEQUAL]: \"notEqual\",\n  [CompareFunc.CMP_GREATEREQUAL]: \"greaterEqual\",\n  [CompareFunc.CMP_ALWAYS]: \"always\"\n});\n\n/** Carbon blend modes to neutral spellings. */\nconst BLEND_FACTOR = Object.freeze({\n  [BlendMode.BM_ZERO]: \"zero\",\n  [BlendMode.BM_ONE]: \"one\",\n  [BlendMode.BM_SRCCOLOR]: \"srcColor\",\n  [BlendMode.BM_INVSRCCOLOR]: \"invSrcColor\",\n  [BlendMode.BM_SRCALPHA]: \"srcAlpha\",\n  [BlendMode.BM_INVSRCALPHA]: \"invSrcAlpha\",\n  [BlendMode.BM_DESTALPHA]: \"destAlpha\",\n  [BlendMode.BM_INVDESTALPHA]: \"invDestAlpha\",\n  [BlendMode.BM_DESTCOLOR]: \"destColor\",\n  [BlendMode.BM_INVDESTCOLOR]: \"invDestColor\",\n  [BlendMode.BM_SRCALPHASAT]: \"srcAlphaSat\",\n  [BlendMode.BM_BOTHSRCALPHA]: \"bothSrcAlpha\",\n  [BlendMode.BM_BOTHINVSRCALPHA]: \"bothInvSrcAlpha\",\n  [BlendMode.BM_BLENDFACTOR]: \"blendFactor\",\n  [BlendMode.BM_INVBLENDFACTOR]: \"invBlendFactor\"\n});\n\n/**\n * Carbon blend operations to neutral spellings.\n *\n * `BO_DISABLE` is a real Carbon member, not enum-width padding, so it maps\n * rather than throwing. A setup that authors it is not blending, whatever\n * ALPHABLENDENABLE says.\n */\nconst BLEND_OP = Object.freeze({\n  [BlendOperation.BO_DISABLE]: \"disable\",\n  [BlendOperation.BO_ADD]: \"add\",\n  [BlendOperation.BO_SUBTRACT]: \"subtract\",\n  [BlendOperation.BO_REVSUBTRACT]: \"revSubtract\",\n  [BlendOperation.BO_MIN]: \"min\",\n  [BlendOperation.BO_MAX]: \"max\"\n});\n\n/**\n * Carbon cull modes to neutral spellings, named by the winding DISCARDED.\n *\n * D3D names the winding to cull; a modern API names the face. The two agree\n * only once a front-face winding is chosen, and that belongs to the backend\n * projection rather than to the authored setup.\n */\nconst CULL = Object.freeze({\n  [CullMode.CULLMODE_NONE]: \"none\",\n  [CullMode.CULLMODE_CW]: \"cw\",\n  [CullMode.CULLMODE_CCW]: \"ccw\"\n});\n\n/** Carbon fill modes to neutral spellings. */\nconst FILL = Object.freeze({\n  [FillMode.FM_POINT]: \"point\",\n  [FillMode.FM_WIREFRAME]: \"wireframe\",\n  [FillMode.FM_SOLID]: \"solid\"\n});\n\n/**\n * Carbon's inverted-depth-test override, as a neutral mapping.\n *\n * `Tr2EffectStateManager::SetInvertedDepthTest` (Tr2EffectStateManager.cpp:834)\n * installs an RS_ZFUNC override table that swaps the ordered comparisons and\n * leaves the order-free ones alone. This is the same table in our spelling.\n */\nconst INVERTED_COMPARE = Object.freeze({\n  never: \"never\",\n  less: \"greater\",\n  equal: \"equal\",\n  lessEqual: \"greaterEqual\",\n  greater: \"less\",\n  notEqual: \"notEqual\",\n  greaterEqual: \"lessEqual\",\n  always: \"always\"\n});\n\n/**\n * Carbon's inverted-cull override, as a neutral mapping.\n *\n * `Tr2EffectStateManager::SetInvertedCullMode` (Tr2EffectStateManager.cpp:815)\n * installs an RS_CULLMODE override that swaps the two windings and leaves\n * `none` alone.\n */\nconst INVERTED_CULL = Object.freeze({ none: \"none\", cw: \"ccw\", ccw: \"cw\" });\n\n/** Neutral comparison spellings to WebGPU's. */\nconst WEBGPU_COMPARE = Object.freeze({\n  never: \"never\",\n  less: \"less\",\n  equal: \"equal\",\n  lessEqual: \"less-equal\",\n  greater: \"greater\",\n  notEqual: \"not-equal\",\n  greaterEqual: \"greater-equal\",\n  always: \"always\"\n});\n\n/**\n * Neutral blend factors to WebGPU's.\n *\n * `bothSrcAlpha` and `bothInvSrcAlpha` are absent: they are D3D9 fixed-function\n * modes that set the source and destination factors together, and WebGPU has no\n * equivalent. They fail rather than being approximated.\n */\nconst WEBGPU_BLEND_FACTOR = Object.freeze({\n  zero: \"zero\",\n  one: \"one\",\n  srcColor: \"src\",\n  invSrcColor: \"one-minus-src\",\n  srcAlpha: \"src-alpha\",\n  invSrcAlpha: \"one-minus-src-alpha\",\n  destAlpha: \"dst-alpha\",\n  invDestAlpha: \"one-minus-dst-alpha\",\n  destColor: \"dst\",\n  invDestColor: \"one-minus-dst\",\n  srcAlphaSat: \"src-alpha-saturated\",\n  blendFactor: \"constant\",\n  invBlendFactor: \"one-minus-constant\"\n});\n\n/**\n * Neutral blend equations to WebGPU's.\n *\n * `disable` is absent: WebGPU expresses \"not blending\" by omitting the blend\n * member, so a disabled operation is resolved before this table is consulted.\n */\nconst WEBGPU_BLEND_OP = Object.freeze({\n  add: \"add\",\n  subtract: \"subtract\",\n  revSubtract: \"reverse-subtract\",\n  min: \"min\",\n  max: \"max\"\n});\n\n/**\n * Depth-format mantissa widths, for the WebGPU bias conversion.\n *\n * A UNORM depth buffer's smallest increment is `1 / (2^bits - 1)`, so a float\n * bias multiplies by that many units. `depth32float` has no fixed increment -\n * WebGPU defines the unit as format-dependent and implementation-chosen there -\n * so a float bias cannot be converted exactly and is refused.\n */\nconst WEBGPU_DEPTH_UNORM_BITS = Object.freeze({\n  depth16unorm: 16,\n  depth24plus: 24,\n  \"depth24plus-stencil8\": 24\n});\n\n/**\n * WebGPU front-face winding, stated once.\n *\n * Carbon runs D3D's default rasterizer state, in which a clockwise winding is\n * the front face. Every WebGPU cull decision is relative to this.\n */\nconst WEBGPU_FRONT_FACE = \"cw\";\n\n/**\n * Authored values a setup inherits when it sets nothing.\n *\n * These are the D3D defaults Carbon inherits, named through the shared\n * vocabulary rather than repeated as numbers.\n */\nconst DEFAULT_DEPTH_COMPARE = CompareFunc.CMP_LESSEQUAL;\nconst DEFAULT_CULL = CullMode.CULLMODE_CCW;\nconst DEFAULT_FILL = FillMode.FM_SOLID;\nconst DEFAULT_SRC_BLEND = BlendMode.BM_ONE;\nconst DEFAULT_DEST_BLEND = BlendMode.BM_ZERO;\nconst DEFAULT_BLEND_OP = BlendOperation.BO_ADD;\nconst DEFAULT_ALPHA_FUNC = CompareFunc.CMP_ALWAYS;\nconst DEFAULT_COLOR_WRITE = ColorWriteEnable.COLORWRITEENABLE_RED\n  | ColorWriteEnable.COLORWRITEENABLE_GREEN\n  | ColorWriteEnable.COLORWRITEENABLE_BLUE\n  | ColorWriteEnable.COLORWRITEENABLE_ALPHA;\n\n/**\n * Looks a value up in a mapping table, failing on an unmapped one.\n *\n * A silently substituted default here is a wrong draw with no error, which is\n * the expensive failure mode.\n *\n * @param {object} table Mapping table.\n * @param {string|number} value Value to map.\n * @param {string} message Failure message, already naming what was being mapped.\n * @returns {string} Mapped value.\n */\nfunction mapOrFail(table, value, message)\n{\n  const mapped = table[value];\n  if (mapped === undefined) throw new RangeError(message);\n  return mapped;\n}\n\n/**\n * Splits a Carbon colour-write mask into channel flags.\n *\n * @param {number} value Raw mask.\n * @returns {object} Per-channel flags.\n */\nfunction colorWriteMask(value)\n{\n  return {\n    red: (value & ColorWriteEnable.COLORWRITEENABLE_RED) !== 0,\n    green: (value & ColorWriteEnable.COLORWRITEENABLE_GREEN) !== 0,\n    blue: (value & ColorWriteEnable.COLORWRITEENABLE_BLUE) !== 0,\n    alpha: (value & ColorWriteEnable.COLORWRITEENABLE_ALPHA) !== 0\n  };\n}\n\n/**\n * Splits a D3DCOLOR blend constant into normalised channels.\n *\n * @param {number} value Raw ARGB colour.\n * @returns {object} Normalised channels.\n */\n// One decode of the packed ARGB word, reused rather than restated. `color`\n// already owns the layout - Carbon's `Color(uint32_t)`, alpha in bits 24-31 then\n// r, g, b - and having the same four shifts written twice is how the two stop\n// agreeing. The scratch is module-scope because this runs per render state and\n// the result is copied out immediately.\n// A PLAIN array, deliberately, and NOT a math-library one.\n//\n// The render state carries doubles: 0x80 normalises to 0.5019607843137255, and\n// a single-precision round trip returns 0.501960813999176 instead. A test pins\n// the exact value, and it caught this.\n//\n// The rule is about the CONTRACT, not about today's element type. A math array's\n// element type is not ours to assume - gl-matrix exposes `setMatrixArrayType`,\n// and this repository declares array types deliberately through the schema's\n// per-type decorators rather than inferring them. So a value whose precision is\n// part of its meaning must not be routed through a math array at all, whatever\n// that array happens to be built from right now.\nconst blendScratch = [ 0, 0, 0, 0 ];\n\nfunction blendConstant(value)\n{\n  color.fromARGB(blendScratch, value >>> 0);\n\n  // The object shape is what the recipe consumes; only the bit layout is shared.\n  return { r: blendScratch[0], g: blendScratch[1], b: blendScratch[2], a: blendScratch[3] };\n}\n\n/**\n * Translates one blend component into WebGPU's vocabulary.\n *\n * @param {{src:string,dst:string,op:string}} component Neutral factors.\n * @returns {object} WebGPU blend component.\n */\nfunction webgpuBlendComponent(component)\n{\n  return {\n    srcFactor: mapOrFail(\n      WEBGPU_BLEND_FACTOR,\n      component.src,\n      `WebGPU has no blend factor equivalent for Carbon's \"${component.src}\"`\n    ),\n    dstFactor: mapOrFail(\n      WEBGPU_BLEND_FACTOR,\n      component.dst,\n      `WebGPU has no blend factor equivalent for Carbon's \"${component.dst}\"`\n    ),\n    operation: mapOrFail(\n      WEBGPU_BLEND_OP,\n      component.op,\n      `WebGPU has no blend operation equivalent for Carbon's \"${component.op}\"`\n    )\n  };\n}\n\n/** One pass's registered set of render states, interpreted. */\nexport class Tr2RenderStateSetup\n{\n\n  /**\n   * The raw `[state, value]` pairs this setup actually AUTHORED.\n   *\n   * RETAINED BECAUSE UNAUTHORED IS NOT THE SAME AS DEFAULT, and losing that\n   * distinction cost a hull. Every field below resolves to a default when the\n   * pass is silent about it, which reads correctly for one setup and is wrong\n   * the moment two are applied in sequence. Carbon sets render states one at a\n   * time through D3D, where they are STICKY: `ApplyStandardStates` puts the\n   * rendering mode's block down - for RM_OPAQUE that includes `CULLMODE_CW` -\n   * and a pass setup that never mentions cull leaves it standing.\n   *\n   * Ours replaced the whole block, so the pass's silence became the default\n   * `CULLMODE_CCW`, which culls the BACK faces where the mode asked to cull the\n   * FRONT ones. Every EVE hull then drew its interior: the silhouette is right\n   * and the surfaces are the wrong ones, which is a hard thing to see.\n   * `Overlay` below is what lets a setup be applied without erasing what it did\n   * not speak about.\n   */\n  authoredStates = [];\n\n  /** Depth test, write, comparison, and the two bias terms. */\n  depth = {\n    test: true,\n    write: true,\n    compare: \"lessEqual\",\n    bias: 0,\n    slopeScaledBias: 0\n  };\n\n  /** Winding that is discarded: `none`, `cw` or `ccw`. */\n  cull = \"ccw\";\n\n  /** Rasterizer fill: `solid`, `wireframe` or `point`. */\n  fill = \"solid\";\n\n  /** Blend factors and equation, or null when the setup does not blend. */\n  blend = null;\n\n  /** Per-channel colour write flags. */\n  colorWrite = { red: true, green: true, blue: true, alpha: true };\n\n  /** Comparison and reference, or null when the setup does not alpha test. */\n  alphaTest = null;\n\n  /** Whether the setup writes sRGB-encoded colour. */\n  srgbWrite = false;\n\n  /**\n   * Authored states this class does not interpret, retained verbatim.\n   *\n   * Stencil, fog, the fixed-function lighting states and point sprites land\n   * here rather than being dropped, so a consumer that meets one can assert on\n   * it instead of silently rendering without it. Nothing in the current draw\n   * path authors them.\n   */\n  unhandled = [];\n\n  // The shared vocabularies, aliased rather than re-declared: one object with a\n  // class-scoped name, which is what enum placement requires.\n\n  /** @see CompareFunc */\n  static CompareFunc = CompareFunc;\n\n  /** @see BlendMode */\n  static BlendMode = BlendMode;\n\n  /** @see BlendOperation */\n  static BlendOperation = BlendOperation;\n\n  /** @see CullMode */\n  static CullMode = CullMode;\n\n  /** @see FillMode */\n  static FillMode = FillMode;\n\n  /** @see ColorWriteEnable */\n  static ColorWriteEnable = ColorWriteEnable;\n\n  /**\n   * Interprets a flat `[state, value, state, value, ...]` list, which is how\n   * Carbon stores its built-in rendering-mode setups.\n   *\n   * MERGING IS CONCATENATION. Carbon re-applies a rendering mode's standard\n   * states immediately before a pass's own every time it applies them\n   * (Tr2EffectStateManager.cpp:716), so the effective state is the mode's list\n   * with the pass's overlaid. Passing `[...standard, ...pass]` yields exactly\n   * that, because a repeated state id overwrites the earlier one.\n   *\n   * @param {Array<number>} keyValues Flat state/value pairs.\n   * @returns {Tr2RenderStateSetup} Interpreted setup.\n   * @throws {RangeError} When the list has an odd length.\n   */\n  static fromKeyValues(keyValues)\n  {\n    const pairs = keyValues ?? [];\n\n    if (pairs.length % 2 !== 0)\n    {\n      throw new RangeError(\"a render-state key/value list must have an even length\");\n    }\n\n    const renderStateValues = [];\n\n    for (let i = 0; i < pairs.length; i += 2)\n    {\n      renderStateValues.push({ state: pairs[i], value: pairs[i + 1] });\n    }\n\n    return this.fromPass({ renderStateValues });\n  }\n\n\n  /**\n   * Interprets one reflected pass's authored render states.\n   *\n   * `depth.test` folds D3D's ZENABLE, including `D3DZB_USEW` (2), which enables\n   * the test; the W-buffer distinction has no modern equivalent and no\n   * consumer.\n   *\n   * The two bias values are reinterpreted float bits, not integers. Carbon\n   * stores them as raw uint32 patterns like every other float-valued render\n   * state.\n   *\n   * @param {{renderStateValues?: Array<{state:number,value:number}>}} pass Reflected pass.\n   * @returns {Tr2RenderStateSetup} Interpreted setup.\n   */\n  static fromPass(pass)\n  {\n    const authored = new Map();\n    for (const entry of pass?.renderStateValues ?? [])\n    {\n      authored.set(Number(entry.state), Number(entry.value));\n    }\n\n    const read = (id, fallback) => (authored.has(id) ? authored.get(id) : fallback);\n    const mapState = (table, id, fallback, name) =>\n    {\n      const value = read(id, fallback);\n      return mapOrFail(\n        table,\n        value,\n        `Carbon render state ${name} has no mapping for value ${value}`\n      );\n    };\n\n    const setup = new this();\n\n    setup.depth = {\n      test: read(RS.ZENABLE, 1) !== 0,\n      write: read(RS.ZWRITEENABLE, 1) !== 0,\n      compare: mapState(COMPARE, RS.ZFUNC, DEFAULT_DEPTH_COMPARE, \"RS_ZFUNC\"),\n      bias: float32FromBits(read(RS.DEPTHBIAS, 0)),\n      slopeScaledBias: float32FromBits(read(RS.SLOPESCALEDEPTHBIAS, 0))\n    };\n    setup.cull = mapState(CULL, RS.CULLMODE, DEFAULT_CULL, \"RS_CULLMODE\");\n    setup.fill = mapState(FILL, RS.FILLMODE, DEFAULT_FILL, \"RS_FILLMODE\");\n    setup.colorWrite = colorWriteMask(read(RS.COLORWRITEENABLE, DEFAULT_COLOR_WRITE));\n    setup.srgbWrite = read(RS.SRGBWRITEENABLE, 0) !== 0;\n\n    if (read(RS.ALPHABLENDENABLE, 0) !== 0)\n    {\n      const srcBlend = read(RS.SRCBLEND, DEFAULT_SRC_BLEND);\n      const destBlend = read(RS.DESTBLEND, DEFAULT_DEST_BLEND);\n      const blendOp = read(RS.BLENDOP, DEFAULT_BLEND_OP);\n      const color = {\n        src: mapState(BLEND_FACTOR, RS.SRCBLEND, DEFAULT_SRC_BLEND, \"RS_SRCBLEND\"),\n        dst: mapState(BLEND_FACTOR, RS.DESTBLEND, DEFAULT_DEST_BLEND, \"RS_DESTBLEND\"),\n        op: mapState(BLEND_OP, RS.BLENDOP, DEFAULT_BLEND_OP, \"RS_BLENDOP\")\n      };\n      // BO_DISABLE means the setup is not blending, however ALPHABLENDENABLE reads.\n      if (color.op !== \"disable\")\n      {\n        setup.blend = {\n          color,\n          alpha: read(RS.SEPARATEALPHABLENDENABLE, 0) !== 0\n            ? {\n              src: mapState(BLEND_FACTOR, RS.SRCBLENDALPHA, srcBlend, \"RS_SRCBLENDALPHA\"),\n              dst: mapState(BLEND_FACTOR, RS.DESTBLENDALPHA, destBlend, \"RS_DESTBLENDALPHA\"),\n              op: mapState(BLEND_OP, RS.BLENDOPALPHA, blendOp, \"RS_BLENDOPALPHA\")\n            }\n            : { ...color },\n          constant: authored.has(RS.BLENDFACTOR)\n            ? blendConstant(authored.get(RS.BLENDFACTOR))\n            : null\n        };\n      }\n    }\n\n    if (read(RS.ALPHATESTENABLE, 0) !== 0)\n    {\n      setup.alphaTest = {\n        compare: mapState(COMPARE, RS.ALPHAFUNC, DEFAULT_ALPHA_FUNC, \"RS_ALPHAFUNC\"),\n        ref: read(RS.ALPHAREF, 0)\n      };\n    }\n\n    for (const [ state, value ] of authored)\n    {\n      if (!INTERPRETED.has(state)) setup.unhandled.push({ state, value });\n    }\n    setup.unhandled.sort((left, right) => left.state - right.state);\n\n    setup.authoredStates = [ ...authored ].sort((left, right) => left[0] - right[0]);\n\n    return setup;\n  }\n\n\n  /**\n   * A setup carrying `base`'s states with `over`'s authored ones on top.\n   *\n   * This is what makes a sequence of applies behave the way D3D's do, where a\n   * state nobody set this draw keeps the value the last one gave it. Carbon\n   * relies on that: `ApplyStandardStates` lays down the rendering mode's block\n   * and a pass setup then speaks only for what it changes.\n   *\n   * Returns `over` unchanged when it authors everything `base` did, so the\n   * common case allocates nothing and the interned setup is preserved.\n   *\n   * @param {Tr2RenderStateSetup|null} base The states already in effect.\n   * @param {Tr2RenderStateSetup|null} over The setup being applied.\n   * @returns {Tr2RenderStateSetup|null} The combined setup.\n   */\n  static Overlay(base, over)\n  {\n    if (!base) return over;\n    if (!over) return base;\n\n    const combined = new Map(base.authoredStates);\n\n    for (const [ state, value ] of over.authoredStates) combined.set(state, value);\n\n    // Nothing of the base survived, so the applied setup already says it all.\n    if (combined.size === over.authoredStates.length) return over;\n\n    return Tr2RenderStateSetup.fromPass({\n      renderStateValues: [ ...combined ].map(([ state, value ]) => ({ state, value }))\n    });\n  }\n\n  /**\n   * A canonical string identifying this exact set of states.\n   *\n   * Carbon gives a registered setup a handle through\n   * `RegisterRenderStateSetup` and reuses it across passes; this is that\n   * handle's portable equivalent. It is the canonical serialization rather than\n   * a hash, so two different setups cannot collide - a setup is small enough to\n   * make that affordable, for the same reason the WebGPU pipeline cache\n   * serializes its recipes exactly.\n   *\n   * Uninterpreted states take part, so two passes that differ only in a state\n   * nothing reads are not treated as one.\n   *\n   * @returns {string} Canonical identity.\n   */\n  Key()\n  {\n    return JSON.stringify([\n      this.depth.test,\n      this.depth.write,\n      this.depth.compare,\n      this.depth.bias,\n      this.depth.slopeScaledBias,\n      this.cull,\n      this.fill,\n      this.blend && [\n        this.blend.color.src, this.blend.color.dst, this.blend.color.op,\n        this.blend.alpha.src, this.blend.alpha.dst, this.blend.alpha.op,\n        this.blend.constant && [\n          this.blend.constant.r,\n          this.blend.constant.g,\n          this.blend.constant.b,\n          this.blend.constant.a\n        ]\n      ],\n      [ this.colorWrite.red, this.colorWrite.green, this.colorWrite.blue, this.colorWrite.alpha ],\n      this.alphaTest && [ this.alphaTest.compare, this.alphaTest.ref ],\n      this.srgbWrite,\n      this.unhandled.map(entry => [ entry.state, entry.value ])\n    ]);\n  }\n\n  /**\n   * Projects this setup into WebGPU pipeline state.\n   *\n   * The return is the state half of a pipeline recipe, not a whole recipe: the\n   * caller owns topology, vertex buffer layouts and target formats, and merges\n   * `primitive` and `depthStencil` into its recipe and `target` into the entry\n   * of `fragment.targets` this pass writes.\n   *\n   * `depthStencil` is null when there is no depth attachment, because a WebGPU\n   * pipeline may not declare depth state without one. Pass `depthFormat` as\n   * null to say so; a setup that authored a depth bias then fails rather than\n   * losing it silently.\n   *\n   * `invertedDepthTest` and `invertedCullMode` are Carbon's two render-state\n   * overrides, which it installs on the state manager rather than authoring per\n   * pass - reversed depth and mirrored rendering respectively. They belong here\n   * rather than on the setup because the same registered setup is drawn both\n   * ways. Applying one changes the projection, and therefore the caller's\n   * pipeline cache key, which is what keeps the two variants distinct.\n   *\n   * Alpha test is returned untranslated. It is not pipeline state in WebGPU -\n   * the compiled shader already discards - so the caller is handed the authored\n   * intent instead of having it dropped here.\n   *\n   * @param {object} [options] Properties the authored setup cannot know.\n   * @param {string|null} [options.depthFormat] Depth attachment format, or null when there is none.\n   * @param {boolean} [options.invertedDepthTest] Apply Carbon's RS_ZFUNC override.\n   * @param {boolean} [options.invertedCullMode] Apply Carbon's RS_CULLMODE override.\n   * @returns {object} WebGPU pipeline state plus the untranslated authored intent.\n   */\n  GetWebgpuRecipe(options = {})\n  {\n    const depthFormat = options.depthFormat === undefined ? \"depth24plus\" : options.depthFormat;\n\n    if (this.fill !== \"solid\")\n    {\n      throw new RangeError(`WebGPU cannot rasterize Carbon fill mode \"${this.fill}\"`);\n    }\n\n    const cull = options.invertedCullMode ? INVERTED_CULL[this.cull] : this.cull;\n    const compare = options.invertedDepthTest\n      ? INVERTED_COMPARE[this.depth.compare]\n      : this.depth.compare;\n\n    const hasBias = this.depth.bias !== 0 || this.depth.slopeScaledBias !== 0;\n    if (depthFormat === null && (this.depth.test || this.depth.write || hasBias))\n    {\n      throw new Error(\"pass authors depth state but no depth attachment was supplied\");\n    }\n\n    let depthBias = 0;\n    if (this.depth.bias !== 0)\n    {\n      const bits = WEBGPU_DEPTH_UNORM_BITS[depthFormat];\n      if (bits === undefined)\n      {\n        throw new RangeError(\n          `Carbon's fractional depth bias cannot be converted for depth format \"${depthFormat}\"`\n        );\n      }\n      depthBias = Math.round(this.depth.bias * (2 ** bits - 1));\n    }\n\n    // The channel bits are the same in both vocabularies, so the mask is rebuilt\n    // through the shared flags rather than through literals.\n    const writeMask = (this.colorWrite.red ? ColorWriteEnable.COLORWRITEENABLE_RED : 0)\n      | (this.colorWrite.green ? ColorWriteEnable.COLORWRITEENABLE_GREEN : 0)\n      | (this.colorWrite.blue ? ColorWriteEnable.COLORWRITEENABLE_BLUE : 0)\n      | (this.colorWrite.alpha ? ColorWriteEnable.COLORWRITEENABLE_ALPHA : 0);\n\n    return {\n      primitive: {\n        cullMode: cull === \"none\" ? \"none\" : (cull === WEBGPU_FRONT_FACE ? \"front\" : \"back\"),\n        frontFace: WEBGPU_FRONT_FACE\n      },\n      depthStencil: depthFormat === null\n        ? null\n        : {\n          format: depthFormat,\n          depthWriteEnabled: this.depth.write,\n          // A disabled depth test is expressed as an always-passing compare,\n          // which is what WebGPU offers; there is no separate enable.\n          depthCompare: this.depth.test\n            ? mapOrFail(\n              WEBGPU_COMPARE,\n              compare,\n              `WebGPU has no depth comparison equivalent for Carbon's \"${compare}\"`\n            )\n            : \"always\",\n          ...(hasBias\n            ? { depthBias, depthBiasSlopeScale: this.depth.slopeScaledBias, depthBiasClamp: 0 }\n            : {})\n        },\n      target: {\n        writeMask,\n        ...(this.blend\n          ? {\n            blend: {\n              color: webgpuBlendComponent(this.blend.color),\n              alpha: webgpuBlendComponent(this.blend.alpha)\n            }\n          }\n          : {})\n      },\n      // Set only when the setup authored one; the caller applies it per render pass.\n      blendConstant: this.blend?.constant ?? null,\n      alphaTest: this.alphaTest,\n      unhandled: this.unhandled\n    };\n  }\n\n}\n"],"names":["RS","Object","freeze","ZENABLE","RenderState","RS_ZENABLE","FILLMODE","RS_FILLMODE","ZWRITEENABLE","RS_ZWRITEENABLE","ALPHATESTENABLE","RS_ALPHATESTENABLE","SRCBLEND","RS_SRCBLEND","DESTBLEND","RS_DESTBLEND","CULLMODE","RS_CULLMODE","ZFUNC","RS_ZFUNC","ALPHAREF","RS_ALPHAREF","ALPHAFUNC","RS_ALPHAFUNC","ALPHABLENDENABLE","RS_ALPHABLENDENABLE","COLORWRITEENABLE","RS_COLORWRITEENABLE","BLENDOP","RS_BLENDOP","SLOPESCALEDEPTHBIAS","RS_SLOPESCALEDEPTHBIAS","BLENDFACTOR","RS_BLENDFACTOR","SRGBWRITEENABLE","RS_SRGBWRITEENABLE","DEPTHBIAS","RS_DEPTHBIAS","SEPARATEALPHABLENDENABLE","RS_SEPARATEALPHABLENDENABLE","SRCBLENDALPHA","RS_SRCBLENDALPHA","DESTBLENDALPHA","RS_DESTBLENDALPHA","BLENDOPALPHA","RS_BLENDOPALPHA","INTERPRETED","Set","values","COMPARE","CompareFunc","CMP_NEVER","CMP_LESS","CMP_EQUAL","CMP_LESSEQUAL","CMP_GREATER","CMP_NOTEQUAL","CMP_GREATEREQUAL","CMP_ALWAYS","BLEND_FACTOR","BlendMode","BM_ZERO","BM_ONE","BM_SRCCOLOR","BM_INVSRCCOLOR","BM_SRCALPHA","BM_INVSRCALPHA","BM_DESTALPHA","BM_INVDESTALPHA","BM_DESTCOLOR","BM_INVDESTCOLOR","BM_SRCALPHASAT","BM_BOTHSRCALPHA","BM_BOTHINVSRCALPHA","BM_BLENDFACTOR","BM_INVBLENDFACTOR","BLEND_OP","BlendOperation","BO_DISABLE","BO_ADD","BO_SUBTRACT","BO_REVSUBTRACT","BO_MIN","BO_MAX","CULL","CullMode","CULLMODE_NONE","CULLMODE_CW","CULLMODE_CCW","FILL","FillMode","FM_POINT","FM_WIREFRAME","FM_SOLID","INVERTED_COMPARE","never","less","equal","lessEqual","greater","notEqual","greaterEqual","always","INVERTED_CULL","none","cw","ccw","WEBGPU_COMPARE","WEBGPU_BLEND_FACTOR","zero","one","srcColor","invSrcColor","srcAlpha","invSrcAlpha","destAlpha","invDestAlpha","destColor","invDestColor","srcAlphaSat","blendFactor","invBlendFactor","WEBGPU_BLEND_OP","add","subtract","revSubtract","min","max","WEBGPU_DEPTH_UNORM_BITS","depth16unorm","depth24plus","WEBGPU_FRONT_FACE","DEFAULT_DEPTH_COMPARE","DEFAULT_CULL","DEFAULT_FILL","DEFAULT_SRC_BLEND","DEFAULT_DEST_BLEND","DEFAULT_BLEND_OP","DEFAULT_ALPHA_FUNC","DEFAULT_COLOR_WRITE","ColorWriteEnable","COLORWRITEENABLE_RED","COLORWRITEENABLE_GREEN","COLORWRITEENABLE_BLUE","COLORWRITEENABLE_ALPHA","mapOrFail","table","value","message","mapped","undefined","RangeError","colorWriteMask","red","green","blue","alpha","blendScratch","blendConstant","color","fromARGB","r","g","b","a","webgpuBlendComponent","component","srcFactor","src","dstFactor","dst","operation","op","Tr2RenderStateSetup","authoredStates","depth","test","write","compare","bias","slopeScaledBias","cull","fill","blend","colorWrite","alphaTest","srgbWrite","unhandled","fromKeyValues","keyValues","pairs","length","renderStateValues","i","push","state","fromPass","pass","authored","Map","entry","set","Number","read","id","fallback","has","get","mapState","name","setup","float32FromBits","srcBlend","destBlend","blendOp","constant","ref","sort","left","right","Overlay","base","over","combined","size","map","Key","JSON","stringify","GetWebgpuRecipe","options","depthFormat","invertedCullMode","invertedDepthTest","hasBias","Error","depthBias","bits","Math","round","writeMask","primitive","cullMode","frontFace","depthStencil","format","depthWriteEnabled","depthCompare","depthBiasSlopeScale","depthBiasClamp","target"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMA,EAAE,GAAGC,MAAM,CAACC,MAAM,CAAC;EACvBC,OAAO,EAAEC,WAAW,CAACC,UAAU;EAC/BC,QAAQ,EAAEF,WAAW,CAACG,WAAW;EACjCC,YAAY,EAAEJ,WAAW,CAACK,eAAe;EACzCC,eAAe,EAAEN,WAAW,CAACO,kBAAkB;EAC/CC,QAAQ,EAAER,WAAW,CAACS,WAAW;EACjCC,SAAS,EAAEV,WAAW,CAACW,YAAY;EACnCC,QAAQ,EAAEZ,WAAW,CAACa,WAAW;EACjCC,KAAK,EAAEd,WAAW,CAACe,QAAQ;EAC3BC,QAAQ,EAAEhB,WAAW,CAACiB,WAAW;EACjCC,SAAS,EAAElB,WAAW,CAACmB,YAAY;EACnCC,gBAAgB,EAAEpB,WAAW,CAACqB,mBAAmB;EACjDC,gBAAgB,EAAEtB,WAAW,CAACuB,mBAAmB;EACjDC,OAAO,EAAExB,WAAW,CAACyB,UAAU;EAC/BC,mBAAmB,EAAE1B,WAAW,CAAC2B,sBAAsB;EACvDC,WAAW,EAAE5B,WAAW,CAAC6B,cAAc;EACvCC,eAAe,EAAE9B,WAAW,CAAC+B,kBAAkB;EAC/CC,SAAS,EAAEhC,WAAW,CAACiC,YAAY;EACnCC,wBAAwB,EAAElC,WAAW,CAACmC,2BAA2B;EACjEC,aAAa,EAAEpC,WAAW,CAACqC,gBAAgB;EAC3CC,cAAc,EAAEtC,WAAW,CAACuC,iBAAiB;EAC7CC,YAAY,EAAExC,WAAW,CAACyC;AAC5B,CAAC,CAAC;AAEF,MAAMC,WAAW,GAAG,IAAIC,GAAG,CAAC9C,MAAM,CAAC+C,MAAM,CAAChD,EAAE,CAAC,CAAC;;AAE9C;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMiD,OAAO,GAAGhD,MAAM,CAACC,MAAM,CAAC;AAC5B,EAAA,CAACgD,WAAW,CAACC,SAAS,GAAG,OAAO;AAChC,EAAA,CAACD,WAAW,CAACE,QAAQ,GAAG,MAAM;AAC9B,EAAA,CAACF,WAAW,CAACG,SAAS,GAAG,OAAO;AAChC,EAAA,CAACH,WAAW,CAACI,aAAa,GAAG,WAAW;AACxC,EAAA,CAACJ,WAAW,CAACK,WAAW,GAAG,SAAS;AACpC,EAAA,CAACL,WAAW,CAACM,YAAY,GAAG,UAAU;AACtC,EAAA,CAACN,WAAW,CAACO,gBAAgB,GAAG,cAAc;EAC9C,CAACP,WAAW,CAACQ,UAAU,GAAG;AAC5B,CAAC,CAAC;;AAEF;AACA,MAAMC,YAAY,GAAG1D,MAAM,CAACC,MAAM,CAAC;AACjC,EAAA,CAAC0D,SAAS,CAACC,OAAO,GAAG,MAAM;AAC3B,EAAA,CAACD,SAAS,CAACE,MAAM,GAAG,KAAK;AACzB,EAAA,CAACF,SAAS,CAACG,WAAW,GAAG,UAAU;AACnC,EAAA,CAACH,SAAS,CAACI,cAAc,GAAG,aAAa;AACzC,EAAA,CAACJ,SAAS,CAACK,WAAW,GAAG,UAAU;AACnC,EAAA,CAACL,SAAS,CAACM,cAAc,GAAG,aAAa;AACzC,EAAA,CAACN,SAAS,CAACO,YAAY,GAAG,WAAW;AACrC,EAAA,CAACP,SAAS,CAACQ,eAAe,GAAG,cAAc;AAC3C,EAAA,CAACR,SAAS,CAACS,YAAY,GAAG,WAAW;AACrC,EAAA,CAACT,SAAS,CAACU,eAAe,GAAG,cAAc;AAC3C,EAAA,CAACV,SAAS,CAACW,cAAc,GAAG,aAAa;AACzC,EAAA,CAACX,SAAS,CAACY,eAAe,GAAG,cAAc;AAC3C,EAAA,CAACZ,SAAS,CAACa,kBAAkB,GAAG,iBAAiB;AACjD,EAAA,CAACb,SAAS,CAACc,cAAc,GAAG,aAAa;EACzC,CAACd,SAAS,CAACe,iBAAiB,GAAG;AACjC,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,QAAQ,GAAG3E,MAAM,CAACC,MAAM,CAAC;AAC7B,EAAA,CAAC2E,cAAc,CAACC,UAAU,GAAG,SAAS;AACtC,EAAA,CAACD,cAAc,CAACE,MAAM,GAAG,KAAK;AAC9B,EAAA,CAACF,cAAc,CAACG,WAAW,GAAG,UAAU;AACxC,EAAA,CAACH,cAAc,CAACI,cAAc,GAAG,aAAa;AAC9C,EAAA,CAACJ,cAAc,CAACK,MAAM,GAAG,KAAK;EAC9B,CAACL,cAAc,CAACM,MAAM,GAAG;AAC3B,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,IAAI,GAAGnF,MAAM,CAACC,MAAM,CAAC;AACzB,EAAA,CAACmF,QAAQ,CAACC,aAAa,GAAG,MAAM;AAChC,EAAA,CAACD,QAAQ,CAACE,WAAW,GAAG,IAAI;EAC5B,CAACF,QAAQ,CAACG,YAAY,GAAG;AAC3B,CAAC,CAAC;;AAEF;AACA,MAAMC,IAAI,GAAGxF,MAAM,CAACC,MAAM,CAAC;AACzB,EAAA,CAACwF,QAAQ,CAACC,QAAQ,GAAG,OAAO;AAC5B,EAAA,CAACD,QAAQ,CAACE,YAAY,GAAG,WAAW;EACpC,CAACF,QAAQ,CAACG,QAAQ,GAAG;AACvB,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,gBAAgB,GAAG7F,MAAM,CAACC,MAAM,CAAC;AACrC6F,EAAAA,KAAK,EAAE,OAAO;AACdC,EAAAA,IAAI,EAAE,SAAS;AACfC,EAAAA,KAAK,EAAE,OAAO;AACdC,EAAAA,SAAS,EAAE,cAAc;AACzBC,EAAAA,OAAO,EAAE,MAAM;AACfC,EAAAA,QAAQ,EAAE,UAAU;AACpBC,EAAAA,YAAY,EAAE,WAAW;AACzBC,EAAAA,MAAM,EAAE;AACV,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,aAAa,GAAGtG,MAAM,CAACC,MAAM,CAAC;AAAEsG,EAAAA,IAAI,EAAE,MAAM;AAAEC,EAAAA,EAAE,EAAE,KAAK;AAAEC,EAAAA,GAAG,EAAE;AAAK,CAAC,CAAC;;AAE3E;AACA,MAAMC,cAAc,GAAG1G,MAAM,CAACC,MAAM,CAAC;AACnC6F,EAAAA,KAAK,EAAE,OAAO;AACdC,EAAAA,IAAI,EAAE,MAAM;AACZC,EAAAA,KAAK,EAAE,OAAO;AACdC,EAAAA,SAAS,EAAE,YAAY;AACvBC,EAAAA,OAAO,EAAE,SAAS;AAClBC,EAAAA,QAAQ,EAAE,WAAW;AACrBC,EAAAA,YAAY,EAAE,eAAe;AAC7BC,EAAAA,MAAM,EAAE;AACV,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMM,mBAAmB,GAAG3G,MAAM,CAACC,MAAM,CAAC;AACxC2G,EAAAA,IAAI,EAAE,MAAM;AACZC,EAAAA,GAAG,EAAE,KAAK;AACVC,EAAAA,QAAQ,EAAE,KAAK;AACfC,EAAAA,WAAW,EAAE,eAAe;AAC5BC,EAAAA,QAAQ,EAAE,WAAW;AACrBC,EAAAA,WAAW,EAAE,qBAAqB;AAClCC,EAAAA,SAAS,EAAE,WAAW;AACtBC,EAAAA,YAAY,EAAE,qBAAqB;AACnCC,EAAAA,SAAS,EAAE,KAAK;AAChBC,EAAAA,YAAY,EAAE,eAAe;AAC7BC,EAAAA,WAAW,EAAE,qBAAqB;AAClCC,EAAAA,WAAW,EAAE,UAAU;AACvBC,EAAAA,cAAc,EAAE;AAClB,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,eAAe,GAAGzH,MAAM,CAACC,MAAM,CAAC;AACpCyH,EAAAA,GAAG,EAAE,KAAK;AACVC,EAAAA,QAAQ,EAAE,UAAU;AACpBC,EAAAA,WAAW,EAAE,kBAAkB;AAC/BC,EAAAA,GAAG,EAAE,KAAK;AACVC,EAAAA,GAAG,EAAE;AACP,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,uBAAuB,GAAG/H,MAAM,CAACC,MAAM,CAAC;AAC5C+H,EAAAA,YAAY,EAAE,EAAE;AAChBC,EAAAA,WAAW,EAAE,EAAE;AACf,EAAA,sBAAsB,EAAE;AAC1B,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,iBAAiB,GAAG,IAAI;;AAE9B;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,qBAAqB,GAAGlF,WAAW,CAACI,aAAa;AACvD,MAAM+E,YAAY,GAAGhD,QAAQ,CAACG,YAAY;AAC1C,MAAM8C,YAAY,GAAG5C,QAAQ,CAACG,QAAQ;AACtC,MAAM0C,iBAAiB,GAAG3E,SAAS,CAACE,MAAM;AAC1C,MAAM0E,kBAAkB,GAAG5E,SAAS,CAACC,OAAO;AAC5C,MAAM4E,gBAAgB,GAAG5D,cAAc,CAACE,MAAM;AAC9C,MAAM2D,kBAAkB,GAAGxF,WAAW,CAACQ,UAAU;AACjD,MAAMiF,mBAAmB,GAAGC,gBAAgB,CAACC,oBAAoB,GAC7DD,gBAAgB,CAACE,sBAAsB,GACvCF,gBAAgB,CAACG,qBAAqB,GACtCH,gBAAgB,CAACI,sBAAsB;;AAE3C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,SAASA,CAACC,KAAK,EAAEC,KAAK,EAAEC,OAAO,EACxC;AACE,EAAA,MAAMC,MAAM,GAAGH,KAAK,CAACC,KAAK,CAAC;EAC3B,IAAIE,MAAM,KAAKC,SAAS,EAAE,MAAM,IAAIC,UAAU,CAACH,OAAO,CAAC;AACvD,EAAA,OAAOC,MAAM;AACf;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,SAASG,cAAcA,CAACL,KAAK,EAC7B;EACE,OAAO;IACLM,GAAG,EAAE,CAACN,KAAK,GAAGP,gBAAgB,CAACC,oBAAoB,MAAM,CAAC;IAC1Da,KAAK,EAAE,CAACP,KAAK,GAAGP,gBAAgB,CAACE,sBAAsB,MAAM,CAAC;IAC9Da,IAAI,EAAE,CAACR,KAAK,GAAGP,gBAAgB,CAACG,qBAAqB,MAAM,CAAC;AAC5Da,IAAAA,KAAK,EAAE,CAACT,KAAK,GAAGP,gBAAgB,CAACI,sBAAsB,MAAM;GAC9D;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMa,YAAY,GAAG,CAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAE;AAEnC,SAASC,aAAaA,CAACX,KAAK,EAC5B;EACEY,KAAK,CAACC,QAAQ,CAACH,YAAY,EAAEV,KAAK,KAAK,CAAC,CAAC;;AAEzC;EACA,OAAO;AAAEc,IAAAA,CAAC,EAAEJ,YAAY,CAAC,CAAC,CAAC;AAAEK,IAAAA,CAAC,EAAEL,YAAY,CAAC,CAAC,CAAC;AAAEM,IAAAA,CAAC,EAAEN,YAAY,CAAC,CAAC,CAAC;IAAEO,CAAC,EAAEP,YAAY,CAAC,CAAC;GAAG;AAC3F;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,SAASQ,oBAAoBA,CAACC,SAAS,EACvC;EACE,OAAO;AACLC,IAAAA,SAAS,EAAEtB,SAAS,CAClBrC,mBAAmB,EACnB0D,SAAS,CAACE,GAAG,EACb,CAAA,oDAAA,EAAuDF,SAAS,CAACE,GAAG,GACtE,CAAC;AACDC,IAAAA,SAAS,EAAExB,SAAS,CAClBrC,mBAAmB,EACnB0D,SAAS,CAACI,GAAG,EACb,CAAA,oDAAA,EAAuDJ,SAAS,CAACI,GAAG,GACtE,CAAC;AACDC,IAAAA,SAAS,EAAE1B,SAAS,CAClBvB,eAAe,EACf4C,SAAS,CAACM,EAAE,EACZ,CAAA,uDAAA,EAA0DN,SAAS,CAACM,EAAE,CAAA,CAAA,CACxE;GACD;AACH;;AAEA;AACO,MAAMC,mBAAmB,CAChC;AAEE;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,cAAc,GAAG,EAAE;;AAEnB;AACAC,EAAAA,KAAK,GAAG;AACNC,IAAAA,IAAI,EAAE,IAAI;AACVC,IAAAA,KAAK,EAAE,IAAI;AACXC,IAAAA,OAAO,EAAE,WAAW;AACpBC,IAAAA,IAAI,EAAE,CAAC;AACPC,IAAAA,eAAe,EAAE;GAClB;;AAED;AACAC,EAAAA,IAAI,GAAG,KAAK;;AAEZ;AACAC,EAAAA,IAAI,GAAG,OAAO;;AAEd;AACAC,EAAAA,KAAK,GAAG,IAAI;;AAEZ;AACAC,EAAAA,UAAU,GAAG;AAAE/B,IAAAA,GAAG,EAAE,IAAI;AAAEC,IAAAA,KAAK,EAAE,IAAI;AAAEC,IAAAA,IAAI,EAAE,IAAI;AAAEC,IAAAA,KAAK,EAAE;GAAM;;AAEhE;AACA6B,EAAAA,SAAS,GAAG,IAAI;;AAEhB;AACAC,EAAAA,SAAS,GAAG,KAAK;;AAEjB;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,SAAS,GAAG,EAAE;;AAEd;AACA;;AAEA;EACA,OAAOzI,WAAW,GAAGA,WAAW;;AAEhC;EACA,OAAOU,SAAS,GAAGA,SAAS;;AAE5B;EACA,OAAOiB,cAAc,GAAGA,cAAc;;AAEtC;EACA,OAAOQ,QAAQ,GAAGA,QAAQ;;AAE1B;EACA,OAAOK,QAAQ,GAAGA,QAAQ;;AAE1B;EACA,OAAOkD,gBAAgB,GAAGA,gBAAgB;;AAE1C;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,OAAOgD,aAAaA,CAACC,SAAS,EAC9B;AACE,IAAA,MAAMC,KAAK,GAAGD,SAAS,IAAI,EAAE;AAE7B,IAAA,IAAIC,KAAK,CAACC,MAAM,GAAG,CAAC,KAAK,CAAC,EAC1B;AACE,MAAA,MAAM,IAAIxC,UAAU,CAAC,wDAAwD,CAAC;AAChF,IAAA;IAEA,MAAMyC,iBAAiB,GAAG,EAAE;AAE5B,IAAA,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGH,KAAK,CAACC,MAAM,EAAEE,CAAC,IAAI,CAAC,EACxC;MACED,iBAAiB,CAACE,IAAI,CAAC;AAAEC,QAAAA,KAAK,EAAEL,KAAK,CAACG,CAAC,CAAC;AAAE9C,QAAAA,KAAK,EAAE2C,KAAK,CAACG,CAAC,GAAG,CAAC;AAAE,OAAC,CAAC;AAClE,IAAA;IAEA,OAAO,IAAI,CAACG,QAAQ,CAAC;AAAEJ,MAAAA;AAAkB,KAAC,CAAC;AAC7C,EAAA;;AAGA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,OAAOI,QAAQA,CAACC,IAAI,EACpB;AACE,IAAA,MAAMC,QAAQ,GAAG,IAAIC,GAAG,EAAE;IAC1B,KAAK,MAAMC,KAAK,IAAIH,IAAI,EAAEL,iBAAiB,IAAI,EAAE,EACjD;AACEM,MAAAA,QAAQ,CAACG,GAAG,CAACC,MAAM,CAACF,KAAK,CAACL,KAAK,CAAC,EAAEO,MAAM,CAACF,KAAK,CAACrD,KAAK,CAAC,CAAC;AACxD,IAAA;IAEA,MAAMwD,IAAI,GAAGA,CAACC,EAAE,EAAEC,QAAQ,KAAMP,QAAQ,CAACQ,GAAG,CAACF,EAAE,CAAC,GAAGN,QAAQ,CAACS,GAAG,CAACH,EAAE,CAAC,GAAGC,QAAS;IAC/E,MAAMG,QAAQ,GAAGA,CAAC9D,KAAK,EAAE0D,EAAE,EAAEC,QAAQ,EAAEI,IAAI,KAC3C;AACE,MAAA,MAAM9D,KAAK,GAAGwD,IAAI,CAACC,EAAE,EAAEC,QAAQ,CAAC;MAChC,OAAO5D,SAAS,CACdC,KAAK,EACLC,KAAK,EACL,CAAA,oBAAA,EAAuB8D,IAAI,CAAA,0BAAA,EAA6B9D,KAAK,CAAA,CAC/D,CAAC;IACH,CAAC;AAED,IAAA,MAAM+D,KAAK,GAAG,IAAI,IAAI,EAAE;IAExBA,KAAK,CAACnC,KAAK,GAAG;MACZC,IAAI,EAAE2B,IAAI,CAAC3M,EAAE,CAACG,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC;MAC/B8K,KAAK,EAAE0B,IAAI,CAAC3M,EAAE,CAACQ,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC;AACrC0K,MAAAA,OAAO,EAAE8B,QAAQ,CAAC/J,OAAO,EAAEjD,EAAE,CAACkB,KAAK,EAAEkH,qBAAqB,EAAE,UAAU,CAAC;MACvE+C,IAAI,EAAEgC,eAAe,CAACR,IAAI,CAAC3M,EAAE,CAACoC,SAAS,EAAE,CAAC,CAAC,CAAC;MAC5CgJ,eAAe,EAAE+B,eAAe,CAACR,IAAI,CAAC3M,EAAE,CAAC8B,mBAAmB,EAAE,CAAC,CAAC;KACjE;AACDoL,IAAAA,KAAK,CAAC7B,IAAI,GAAG2B,QAAQ,CAAC5H,IAAI,EAAEpF,EAAE,CAACgB,QAAQ,EAAEqH,YAAY,EAAE,aAAa,CAAC;AACrE6E,IAAAA,KAAK,CAAC5B,IAAI,GAAG0B,QAAQ,CAACvH,IAAI,EAAEzF,EAAE,CAACM,QAAQ,EAAEgI,YAAY,EAAE,aAAa,CAAC;AACrE4E,IAAAA,KAAK,CAAC1B,UAAU,GAAGhC,cAAc,CAACmD,IAAI,CAAC3M,EAAE,CAAC0B,gBAAgB,EAAEiH,mBAAmB,CAAC,CAAC;AACjFuE,IAAAA,KAAK,CAACxB,SAAS,GAAGiB,IAAI,CAAC3M,EAAE,CAACkC,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC;IAEnD,IAAIyK,IAAI,CAAC3M,EAAE,CAACwB,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,EACtC;MACE,MAAM4L,QAAQ,GAAGT,IAAI,CAAC3M,EAAE,CAACY,QAAQ,EAAE2H,iBAAiB,CAAC;MACrD,MAAM8E,SAAS,GAAGV,IAAI,CAAC3M,EAAE,CAACc,SAAS,EAAE0H,kBAAkB,CAAC;MACxD,MAAM8E,OAAO,GAAGX,IAAI,CAAC3M,EAAE,CAAC4B,OAAO,EAAE6G,gBAAgB,CAAC;AAClD,MAAA,MAAMsB,KAAK,GAAG;AACZS,QAAAA,GAAG,EAAEwC,QAAQ,CAACrJ,YAAY,EAAE3D,EAAE,CAACY,QAAQ,EAAE2H,iBAAiB,EAAE,aAAa,CAAC;AAC1EmC,QAAAA,GAAG,EAAEsC,QAAQ,CAACrJ,YAAY,EAAE3D,EAAE,CAACc,SAAS,EAAE0H,kBAAkB,EAAE,cAAc,CAAC;QAC7EoC,EAAE,EAAEoC,QAAQ,CAACpI,QAAQ,EAAE5E,EAAE,CAAC4B,OAAO,EAAE6G,gBAAgB,EAAE,YAAY;OAClE;AACD;AACA,MAAA,IAAIsB,KAAK,CAACa,EAAE,KAAK,SAAS,EAC1B;QACEsC,KAAK,CAAC3B,KAAK,GAAG;UACZxB,KAAK;UACLH,KAAK,EAAE+C,IAAI,CAAC3M,EAAE,CAACsC,wBAAwB,EAAE,CAAC,CAAC,KAAK,CAAC,GAC7C;AACAkI,YAAAA,GAAG,EAAEwC,QAAQ,CAACrJ,YAAY,EAAE3D,EAAE,CAACwC,aAAa,EAAE4K,QAAQ,EAAE,kBAAkB,CAAC;AAC3E1C,YAAAA,GAAG,EAAEsC,QAAQ,CAACrJ,YAAY,EAAE3D,EAAE,CAAC0C,cAAc,EAAE2K,SAAS,EAAE,mBAAmB,CAAC;YAC9EzC,EAAE,EAAEoC,QAAQ,CAACpI,QAAQ,EAAE5E,EAAE,CAAC4C,YAAY,EAAE0K,OAAO,EAAE,iBAAiB;AACpE,WAAC,GACC;YAAE,GAAGvD;WAAO;UAChBwD,QAAQ,EAAEjB,QAAQ,CAACQ,GAAG,CAAC9M,EAAE,CAACgC,WAAW,CAAC,GAClC8H,aAAa,CAACwC,QAAQ,CAACS,GAAG,CAAC/M,EAAE,CAACgC,WAAW,CAAC,CAAC,GAC3C;SACL;AACH,MAAA;AACF,IAAA;IAEA,IAAI2K,IAAI,CAAC3M,EAAE,CAACU,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,EACrC;MACEwM,KAAK,CAACzB,SAAS,GAAG;AAChBP,QAAAA,OAAO,EAAE8B,QAAQ,CAAC/J,OAAO,EAAEjD,EAAE,CAACsB,SAAS,EAAEoH,kBAAkB,EAAE,cAAc,CAAC;AAC5E8E,QAAAA,GAAG,EAAEb,IAAI,CAAC3M,EAAE,CAACoB,QAAQ,EAAE,CAAC;OACzB;AACH,IAAA;IAEA,KAAK,MAAM,CAAE+K,KAAK,EAAEhD,KAAK,CAAE,IAAImD,QAAQ,EACvC;AACE,MAAA,IAAI,CAACxJ,WAAW,CAACgK,GAAG,CAACX,KAAK,CAAC,EAAEe,KAAK,CAACvB,SAAS,CAACO,IAAI,CAAC;QAAEC,KAAK;AAAEhD,QAAAA;AAAM,OAAC,CAAC;AACrE,IAAA;AACA+D,IAAAA,KAAK,CAACvB,SAAS,CAAC8B,IAAI,CAAC,CAACC,IAAI,EAAEC,KAAK,KAAKD,IAAI,CAACvB,KAAK,GAAGwB,KAAK,CAACxB,KAAK,CAAC;IAE/De,KAAK,CAACpC,cAAc,GAAG,CAAE,GAAGwB,QAAQ,CAAE,CAACmB,IAAI,CAAC,CAACC,IAAI,EAAEC,KAAK,KAAKD,IAAI,CAAC,CAAC,CAAC,GAAGC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEhF,IAAA,OAAOT,KAAK;AACd,EAAA;;AAGA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACE,EAAA,OAAOU,OAAOA,CAACC,IAAI,EAAEC,IAAI,EACzB;AACE,IAAA,IAAI,CAACD,IAAI,EAAE,OAAOC,IAAI;AACtB,IAAA,IAAI,CAACA,IAAI,EAAE,OAAOD,IAAI;IAEtB,MAAME,QAAQ,GAAG,IAAIxB,GAAG,CAACsB,IAAI,CAAC/C,cAAc,CAAC;AAE7C,IAAA,KAAK,MAAM,CAAEqB,KAAK,EAAEhD,KAAK,CAAE,IAAI2E,IAAI,CAAChD,cAAc,EAAEiD,QAAQ,CAACtB,GAAG,CAACN,KAAK,EAAEhD,KAAK,CAAC;;AAE9E;IACA,IAAI4E,QAAQ,CAACC,IAAI,KAAKF,IAAI,CAAChD,cAAc,CAACiB,MAAM,EAAE,OAAO+B,IAAI;IAE7D,OAAOjD,mBAAmB,CAACuB,QAAQ,CAAC;AAClCJ,MAAAA,iBAAiB,EAAE,CAAE,GAAG+B,QAAQ,CAAE,CAACE,GAAG,CAAC,CAAC,CAAE9B,KAAK,EAAEhD,KAAK,CAAE,MAAM;QAAEgD,KAAK;AAAEhD,QAAAA;AAAM,OAAC,CAAC;AACjF,KAAC,CAAC;AACJ,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACE+E,EAAAA,GAAGA,GACH;IACE,OAAOC,IAAI,CAACC,SAAS,CAAC,CACpB,IAAI,CAACrD,KAAK,CAACC,IAAI,EACf,IAAI,CAACD,KAAK,CAACE,KAAK,EAChB,IAAI,CAACF,KAAK,CAACG,OAAO,EAClB,IAAI,CAACH,KAAK,CAACI,IAAI,EACf,IAAI,CAACJ,KAAK,CAACK,eAAe,EAC1B,IAAI,CAACC,IAAI,EACT,IAAI,CAACC,IAAI,EACT,IAAI,CAACC,KAAK,IAAI,CACZ,IAAI,CAACA,KAAK,CAACxB,KAAK,CAACS,GAAG,EAAE,IAAI,CAACe,KAAK,CAACxB,KAAK,CAACW,GAAG,EAAE,IAAI,CAACa,KAAK,CAACxB,KAAK,CAACa,EAAE,EAC/D,IAAI,CAACW,KAAK,CAAC3B,KAAK,CAACY,GAAG,EAAE,IAAI,CAACe,KAAK,CAAC3B,KAAK,CAACc,GAAG,EAAE,IAAI,CAACa,KAAK,CAAC3B,KAAK,CAACgB,EAAE,EAC/D,IAAI,CAACW,KAAK,CAACgC,QAAQ,IAAI,CACrB,IAAI,CAAChC,KAAK,CAACgC,QAAQ,CAACtD,CAAC,EACrB,IAAI,CAACsB,KAAK,CAACgC,QAAQ,CAACrD,CAAC,EACrB,IAAI,CAACqB,KAAK,CAACgC,QAAQ,CAACpD,CAAC,EACrB,IAAI,CAACoB,KAAK,CAACgC,QAAQ,CAACnD,CAAC,CACtB,CACF,EACD,CAAE,IAAI,CAACoB,UAAU,CAAC/B,GAAG,EAAE,IAAI,CAAC+B,UAAU,CAAC9B,KAAK,EAAE,IAAI,CAAC8B,UAAU,CAAC7B,IAAI,EAAE,IAAI,CAAC6B,UAAU,CAAC5B,KAAK,CAAE,EAC3F,IAAI,CAAC6B,SAAS,IAAI,CAAE,IAAI,CAACA,SAAS,CAACP,OAAO,EAAE,IAAI,CAACO,SAAS,CAAC+B,GAAG,CAAE,EAChE,IAAI,CAAC9B,SAAS,EACd,IAAI,CAACC,SAAS,CAACsC,GAAG,CAACzB,KAAK,IAAI,CAAEA,KAAK,CAACL,KAAK,EAAEK,KAAK,CAACrD,KAAK,CAAE,CAAC,CAC1D,CAAC;AACJ,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACEkF,EAAAA,eAAeA,CAACC,OAAO,GAAG,EAAE,EAC5B;AACE,IAAA,MAAMC,WAAW,GAAGD,OAAO,CAACC,WAAW,KAAKjF,SAAS,GAAG,aAAa,GAAGgF,OAAO,CAACC,WAAW;AAE3F,IAAA,IAAI,IAAI,CAACjD,IAAI,KAAK,OAAO,EACzB;MACE,MAAM,IAAI/B,UAAU,CAAC,CAAA,0CAAA,EAA6C,IAAI,CAAC+B,IAAI,GAAG,CAAC;AACjF,IAAA;AAEA,IAAA,MAAMD,IAAI,GAAGiD,OAAO,CAACE,gBAAgB,GAAGjI,aAAa,CAAC,IAAI,CAAC8E,IAAI,CAAC,GAAG,IAAI,CAACA,IAAI;AAC5E,IAAA,MAAMH,OAAO,GAAGoD,OAAO,CAACG,iBAAiB,GACrC3I,gBAAgB,CAAC,IAAI,CAACiF,KAAK,CAACG,OAAO,CAAC,GACpC,IAAI,CAACH,KAAK,CAACG,OAAO;AAEtB,IAAA,MAAMwD,OAAO,GAAG,IAAI,CAAC3D,KAAK,CAACI,IAAI,KAAK,CAAC,IAAI,IAAI,CAACJ,KAAK,CAACK,eAAe,KAAK,CAAC;AACzE,IAAA,IAAImD,WAAW,KAAK,IAAI,KAAK,IAAI,CAACxD,KAAK,CAACC,IAAI,IAAI,IAAI,CAACD,KAAK,CAACE,KAAK,IAAIyD,OAAO,CAAC,EAC5E;AACE,MAAA,MAAM,IAAIC,KAAK,CAAC,+DAA+D,CAAC;AAClF,IAAA;IAEA,IAAIC,SAAS,GAAG,CAAC;AACjB,IAAA,IAAI,IAAI,CAAC7D,KAAK,CAACI,IAAI,KAAK,CAAC,EACzB;AACE,MAAA,MAAM0D,IAAI,GAAG7G,uBAAuB,CAACuG,WAAW,CAAC;MACjD,IAAIM,IAAI,KAAKvF,SAAS,EACtB;AACE,QAAA,MAAM,IAAIC,UAAU,CAClB,CAAA,qEAAA,EAAwEgF,WAAW,GACrF,CAAC;AACH,MAAA;AACAK,MAAAA,SAAS,GAAGE,IAAI,CAACC,KAAK,CAAC,IAAI,CAAChE,KAAK,CAACI,IAAI,IAAI,CAAC,IAAI0D,IAAI,GAAG,CAAC,CAAC,CAAC;AAC3D,IAAA;;AAEA;AACA;IACA,MAAMG,SAAS,GAAG,CAAC,IAAI,CAACxD,UAAU,CAAC/B,GAAG,GAAGb,gBAAgB,CAACC,oBAAoB,GAAG,CAAC,KAC7E,IAAI,CAAC2C,UAAU,CAAC9B,KAAK,GAAGd,gBAAgB,CAACE,sBAAsB,GAAG,CAAC,CAAC,IACpE,IAAI,CAAC0C,UAAU,CAAC7B,IAAI,GAAGf,gBAAgB,CAACG,qBAAqB,GAAG,CAAC,CAAC,IAClE,IAAI,CAACyC,UAAU,CAAC5B,KAAK,GAAGhB,gBAAgB,CAACI,sBAAsB,GAAG,CAAC,CAAC;IAEzE,OAAO;AACLiG,MAAAA,SAAS,EAAE;AACTC,QAAAA,QAAQ,EAAE7D,IAAI,KAAK,MAAM,GAAG,MAAM,GAAIA,IAAI,KAAKlD,iBAAiB,GAAG,OAAO,GAAG,MAAO;AACpFgH,QAAAA,SAAS,EAAEhH;OACZ;AACDiH,MAAAA,YAAY,EAAEb,WAAW,KAAK,IAAI,GAC9B,IAAI,GACJ;AACAc,QAAAA,MAAM,EAAEd,WAAW;AACnBe,QAAAA,iBAAiB,EAAE,IAAI,CAACvE,KAAK,CAACE,KAAK;AACnC;AACA;AACAsE,QAAAA,YAAY,EAAE,IAAI,CAACxE,KAAK,CAACC,IAAI,GACzB/B,SAAS,CACTtC,cAAc,EACduE,OAAO,EACP,CAAA,wDAAA,EAA2DA,OAAO,CAAA,CAAA,CACpE,CAAC,GACC,QAAQ;AACZ,QAAA,IAAIwD,OAAO,GACP;UAAEE,SAAS;AAAEY,UAAAA,mBAAmB,EAAE,IAAI,CAACzE,KAAK,CAACK,eAAe;AAAEqE,UAAAA,cAAc,EAAE;SAAG,GACjF,EAAE;OACP;AACHC,MAAAA,MAAM,EAAE;QACNV,SAAS;QACT,IAAI,IAAI,CAACzD,KAAK,GACV;AACAA,UAAAA,KAAK,EAAE;YACLxB,KAAK,EAAEM,oBAAoB,CAAC,IAAI,CAACkB,KAAK,CAACxB,KAAK,CAAC;AAC7CH,YAAAA,KAAK,EAAES,oBAAoB,CAAC,IAAI,CAACkB,KAAK,CAAC3B,KAAK;AAC9C;SACD,GACC,EAAE;OACP;AACD;AACAE,MAAAA,aAAa,EAAE,IAAI,CAACyB,KAAK,EAAEgC,QAAQ,IAAI,IAAI;MAC3C9B,SAAS,EAAE,IAAI,CAACA,SAAS;MACzBE,SAAS,EAAE,IAAI,CAACA;KACjB;AACH,EAAA;AAEF;;;;"}

package/dist/resource/shader/reflection/carbonRecordFields.js

@@ -1,3 +1,5 @@
+import { readU32LE, float32ToBits, float32FromBits } from '#utils/bytes';
+
 // Shared field accessors for Carbon v15 description records.
 //
 // The record tree is what the one Carbon effect reader emits
@@ -17,65 +19,60 @@
 // out, compared byte for byte over the shipped corpus, so a mistake that
 // satisfied both sides would have to be an exact inverse of itself.
 
-const rawValueBuffer = new DataView(new ArrayBuffer(4));
-
-/**
- * Reads the text out of an arena string reference.
- *
- * @param {{offset:number,value:string}|null|undefined} ref String reference.
- * @returns {string} The referenced text, or "" when unset.
+/**
+ * Reads the text out of an arena string reference.
+ *
+ * @param {{offset:number,value:string}|null|undefined} ref String reference.
+ * @returns {string} The referenced text, or "" when unset.
  */
 function recordText(ref) {
   return String(ref?.value ?? "");
 }
 
-/**
- * Decodes an annotation record's four raw bytes as the `u32` bit pattern the
- * reflection classes carry as `rawValue`.
- *
- * Carbon stores the value as a `{float,int32_t}` union and the type byte decides
- * which member is meaningful, so the bits travel untyped and each annotation type
- * reinterprets them itself. Decoding to a number here — rather than to a float —
- * is what keeps a value like `-FLT_MAX` exact.
- *
- * @param {Uint8Array|null|undefined} bytes Four little-endian bytes.
- * @returns {number} The unsigned 32-bit pattern those bytes carry.
+/**
+ * Decodes an annotation record's four raw bytes as the `u32` bit pattern the
+ * reflection classes carry as `rawValue`.
+ *
+ * Carbon stores the value as a `{float,int32_t}` union and the type byte decides
+ * which member is meaningful, so the bits travel untyped and each annotation type
+ * reinterprets them itself. Decoding to a number here — rather than to a float —
+ * is what keeps a value like `-FLT_MAX` exact.
+ *
+ * @param {Uint8Array|null|undefined} bytes Four little-endian bytes.
+ * @returns {number} The unsigned 32-bit pattern those bytes carry.
  */
 function recordRawValue(bytes) {
   if (!bytes || bytes.length < 4) return 0;
-  rawValueBuffer.setUint8(0, bytes[0]);
-  rawValueBuffer.setUint8(1, bytes[1]);
-  rawValueBuffer.setUint8(2, bytes[2]);
-  rawValueBuffer.setUint8(3, bytes[3]);
-  return rawValueBuffer.getUint32(0, true);
+  return readU32LE(bytes, 0);
 }
 
-/**
- * Re-encodes a record's `float` as the `u32` bit pattern the reflection classes
- * carry in their `*Raw` sampler fields.
- *
- * The container stores sampler LOD and border values as real floats, but the
- * class keeps the bits, so a value like `-FLT_MAX` survives serialization without
- * a decimal round trip. Reading the float and re-encoding it here is exact: the
- * record's value came from a `f32` read, so it is already representable.
- *
- * @param {number} value Float value from a sampler record.
- * @returns {number} The unsigned 32-bit pattern encoding that float.
+/**
+ * Re-encodes a record's `float` as the `u32` bit pattern the reflection classes
+ * carry in their `*Raw` sampler fields.
+ *
+ * The container stores sampler LOD and border values as real floats, but the
+ * class keeps the bits, so a value like `-FLT_MAX` survives serialization without
+ * a decimal round trip. Reading the float and re-encoding it here is exact: the
+ * record's value came from a `f32` read, so it is already representable.
+ *
+ * @param {number} value Float value from a sampler record.
+ * @returns {number} The unsigned 32-bit pattern encoding that float.
  */
 function recordRawBits(value) {
-  rawValueBuffer.setFloat32(0, Number.isFinite(value) ? value : 0, true);
-  return rawValueBuffer.getUint32(0, true);
+  // The non-finite substitution is the RECORD's rule, not the conversion's: a
+  // sampler record has no encoding for NaN, so it stores zero.
+  return float32ToBits(Number.isFinite(value) ? value : 0);
 }
 
-/**
- * Wraps text as the arena string reference the writer interns.
- *
- * The offset is always 0: the writer assigns real offsets while building the
- * arena, and any value here would be discarded. Carrying the text is the whole
- * job.
- *
- * @param {string} value Text value.
- * @returns {{offset:number,value:string}} String reference.
+/**
+ * Wraps text as the arena string reference the writer interns.
+ *
+ * The offset is always 0: the writer assigns real offsets while building the
+ * arena, and any value here would be discarded. Carrying the text is the whole
+ * job.
+ *
+ * @param {string} value Text value.
+ * @returns {{offset:number,value:string}} String reference.
  */
 function toRecordText(value) {
   return {
@@ -84,54 +81,54 @@ function toRecordText(value) {
   };
 }
 
-/**
- * Encodes a `u32` bit pattern as an annotation record's four raw bytes.
- *
- * The inverse of {@link recordRawValue}, and raw for the same reason: the value
- * is written through one union member and read through another, so no numeric
- * conversion may happen on the way out either.
- *
- * @param {number} rawValue Unsigned 32-bit pattern.
- * @returns {Uint8Array} Four little-endian bytes.
+/**
+ * Encodes a `u32` bit pattern as an annotation record's four raw bytes.
+ *
+ * The inverse of {@link recordRawValue}, and raw for the same reason: the value
+ * is written through one union member and read through another, so no numeric
+ * conversion may happen on the way out either.
+ *
+ * @param {number} rawValue Unsigned 32-bit pattern.
+ * @returns {Uint8Array} Four little-endian bytes.
  */
 function toRecordRawValue(rawValue) {
-  const bytes = new Uint8Array(4);
-  rawValueBuffer.setUint32(0, rawValue >>> 0, true);
-  for (let index = 0; index < 4; index += 1) {
-    bytes[index] = rawValueBuffer.getUint8(index);
-  }
+  const value = rawValue >>> 0,
+    bytes = new Uint8Array(4);
+  bytes[0] = value & 0xff;
+  bytes[1] = value >>> 8 & 0xff;
+  bytes[2] = value >>> 16 & 0xff;
+  bytes[3] = value >>> 24 & 0xff;
   return bytes;
 }
 
-/**
- * Decodes a `*Raw` sampler field back to the float the record stores.
- *
- * The inverse of {@link recordRawBits}. Assigning the raw `u32` straight across
- * would write `4286578687.0` where the file says `-3.4028235e38`, and every
- * structural check in the container would accept it.
- *
- * @param {number} bits Raw 32-bit pattern.
- * @returns {number} The float those bits encode.
+/**
+ * Decodes a `*Raw` sampler field back to the float the record stores.
+ *
+ * The inverse of {@link recordRawBits}. Assigning the raw `u32` straight across
+ * would write `4286578687.0` where the file says `-3.4028235e38`, and every
+ * structural check in the container would accept it.
+ *
+ * @param {number} bits Raw 32-bit pattern.
+ * @returns {number} The float those bits encode.
  */
 function toRecordFloat(bits) {
-  rawValueBuffer.setUint32(0, (bits ?? 0) >>> 0, true);
-  return rawValueBuffer.getFloat32(0, true);
+  return float32FromBits(bits ?? 0);
 }
 
-/**
- * Wraps bytes as the record codec's sized blob reference.
- *
- * A zero-length blob keeps the offset word the file carried, because the writer
- * passes it straight through rather than interning anything. That word is
- * usually `0xffffffff`, but not always — measured across the shipped corpus,
- * 150 of 4833 files carry a live-looking offset behind a zero size, and
- * normalizing it changes the bytes and can make two distinct bodies collapse
- * into one. An empty payload and an absent one are not the same thing.
- *
- * @param {Uint8Array} bytes Payload bytes.
- * @param {number} [declaredSize] Size to declare when tracked separately.
- * @param {number} [unsetOffset] Offset word to keep when the size is zero.
- * @returns {{size:number,offset:number,bytes:Uint8Array}} Blob reference.
+/**
+ * Wraps bytes as the record codec's sized blob reference.
+ *
+ * A zero-length blob keeps the offset word the file carried, because the writer
+ * passes it straight through rather than interning anything. That word is
+ * usually `0xffffffff`, but not always — measured across the shipped corpus,
+ * 150 of 4833 files carry a live-looking offset behind a zero size, and
+ * normalizing it changes the bytes and can make two distinct bodies collapse
+ * into one. An empty payload and an absent one are not the same thing.
+ *
+ * @param {Uint8Array} bytes Payload bytes.
+ * @param {number} [declaredSize] Size to declare when tracked separately.
+ * @param {number} [unsetOffset] Offset word to keep when the size is zero.
+ * @returns {{size:number,offset:number,bytes:Uint8Array}} Blob reference.
  */
 function toRecordBlob(bytes, declaredSize, unsetOffset = 0xffffffff) {
   const owned = bytes instanceof Uint8Array ? bytes : new Uint8Array(0);
@@ -143,12 +140,12 @@ function toRecordBlob(bytes, declaredSize, unsetOffset = 0xffffffff) {
   };
 }
 
-/**
- * Returns a blob reference's payload bytes, or an empty view when the reference
- * was never set.
- *
- * @param {{size:number,offset:number,bytes:Uint8Array}|null|undefined} ref Blob.
- * @returns {Uint8Array} Owned-by-the-container view over the payload.
+/**
+ * Returns a blob reference's payload bytes, or an empty view when the reference
+ * was never set.
+ *
+ * @param {{size:number,offset:number,bytes:Uint8Array}|null|undefined} ref Blob.
+ * @returns {Uint8Array} Owned-by-the-container view over the payload.
  */
 function recordBytes(ref) {
   const bytes = ref?.bytes;

package/dist/resource/shader/reflection/carbonRecordFields.js.map

@@ -1 +1 @@
-{"version":3,"file":"carbonRecordFields.js","sources":["../../../../../src/resource/shader/reflection/carbonRecordFields.js"],"sourcesContent":["// Shared field accessors for Carbon v15 description records.\r\n//\r\n// The record tree is what the one Carbon effect reader emits\r\n// (`format/carbonEffect/carbonEffectRecords.js`). Each reflection class maps its\r\n// own record, but three field encodings recur across all of them and are worth\r\n// naming once rather than open-coding at every call site:\r\n//\r\n//   - a string is an arena reference `{offset, value}`, not a string;\r\n//   - an annotation value is four raw little-endian bytes, because Carbon writes\r\n//     it through one union member and reads it through another, so the bytes are\r\n//     the only faithful carrier;\r\n//   - a blob is `{size, offset, bytes}` with `offset === 0xffffffff` meaning the\r\n//     reference was never set, which is not the same as an empty payload.\r\n//\r\n// Both directions live here, as `recordX` and `toRecordX` pairs. They are held\r\n// apart by the round trip rather than by separation: records in, classes, records\r\n// out, compared byte for byte over the shipped corpus, so a mistake that\r\n// satisfied both sides would have to be an exact inverse of itself.\r\n\r\nconst rawValueBuffer = new DataView(new ArrayBuffer(4));\r\n\r\n/**\r\n * Reads the text out of an arena string reference.\r\n *\r\n * @param {{offset:number,value:string}|null|undefined} ref String reference.\r\n * @returns {string} The referenced text, or \"\" when unset.\r\n */\r\nexport function recordText(ref)\r\n{\r\n  return String(ref?.value ?? \"\");\r\n}\r\n\r\n/**\r\n * Decodes an annotation record's four raw bytes as the `u32` bit pattern the\r\n * reflection classes carry as `rawValue`.\r\n *\r\n * Carbon stores the value as a `{float,int32_t}` union and the type byte decides\r\n * which member is meaningful, so the bits travel untyped and each annotation type\r\n * reinterprets them itself. Decoding to a number here — rather than to a float —\r\n * is what keeps a value like `-FLT_MAX` exact.\r\n *\r\n * @param {Uint8Array|null|undefined} bytes Four little-endian bytes.\r\n * @returns {number} The unsigned 32-bit pattern those bytes carry.\r\n */\r\nexport function recordRawValue(bytes)\r\n{\r\n  if (!bytes || bytes.length < 4) return 0;\r\n  rawValueBuffer.setUint8(0, bytes[0]);\r\n  rawValueBuffer.setUint8(1, bytes[1]);\r\n  rawValueBuffer.setUint8(2, bytes[2]);\r\n  rawValueBuffer.setUint8(3, bytes[3]);\r\n  return rawValueBuffer.getUint32(0, true);\r\n}\r\n\r\n/**\r\n * Re-encodes a record's `float` as the `u32` bit pattern the reflection classes\r\n * carry in their `*Raw` sampler fields.\r\n *\r\n * The container stores sampler LOD and border values as real floats, but the\r\n * class keeps the bits, so a value like `-FLT_MAX` survives serialization without\r\n * a decimal round trip. Reading the float and re-encoding it here is exact: the\r\n * record's value came from a `f32` read, so it is already representable.\r\n *\r\n * @param {number} value Float value from a sampler record.\r\n * @returns {number} The unsigned 32-bit pattern encoding that float.\r\n */\r\nexport function recordRawBits(value)\r\n{\r\n  rawValueBuffer.setFloat32(0, Number.isFinite(value) ? value : 0, true);\r\n  return rawValueBuffer.getUint32(0, true);\r\n}\r\n\r\n/**\r\n * Wraps text as the arena string reference the writer interns.\r\n *\r\n * The offset is always 0: the writer assigns real offsets while building the\r\n * arena, and any value here would be discarded. Carrying the text is the whole\r\n * job.\r\n *\r\n * @param {string} value Text value.\r\n * @returns {{offset:number,value:string}} String reference.\r\n */\r\nexport function toRecordText(value)\r\n{\r\n  return { offset: 0, value: String(value ?? \"\") };\r\n}\r\n\r\n/**\r\n * Encodes a `u32` bit pattern as an annotation record's four raw bytes.\r\n *\r\n * The inverse of {@link recordRawValue}, and raw for the same reason: the value\r\n * is written through one union member and read through another, so no numeric\r\n * conversion may happen on the way out either.\r\n *\r\n * @param {number} rawValue Unsigned 32-bit pattern.\r\n * @returns {Uint8Array} Four little-endian bytes.\r\n */\r\nexport function toRecordRawValue(rawValue)\r\n{\r\n  const bytes = new Uint8Array(4);\r\n  rawValueBuffer.setUint32(0, rawValue >>> 0, true);\r\n  for (let index = 0; index < 4; index += 1)\r\n  {\r\n    bytes[index] = rawValueBuffer.getUint8(index);\r\n  }\r\n  return bytes;\r\n}\r\n\r\n/**\r\n * Decodes a `*Raw` sampler field back to the float the record stores.\r\n *\r\n * The inverse of {@link recordRawBits}. Assigning the raw `u32` straight across\r\n * would write `4286578687.0` where the file says `-3.4028235e38`, and every\r\n * structural check in the container would accept it.\r\n *\r\n * @param {number} bits Raw 32-bit pattern.\r\n * @returns {number} The float those bits encode.\r\n */\r\nexport function toRecordFloat(bits)\r\n{\r\n  rawValueBuffer.setUint32(0, (bits ?? 0) >>> 0, true);\r\n  return rawValueBuffer.getFloat32(0, true);\r\n}\r\n\r\n/**\r\n * Wraps bytes as the record codec's sized blob reference.\r\n *\r\n * A zero-length blob keeps the offset word the file carried, because the writer\r\n * passes it straight through rather than interning anything. That word is\r\n * usually `0xffffffff`, but not always — measured across the shipped corpus,\r\n * 150 of 4833 files carry a live-looking offset behind a zero size, and\r\n * normalizing it changes the bytes and can make two distinct bodies collapse\r\n * into one. An empty payload and an absent one are not the same thing.\r\n *\r\n * @param {Uint8Array} bytes Payload bytes.\r\n * @param {number} [declaredSize] Size to declare when tracked separately.\r\n * @param {number} [unsetOffset] Offset word to keep when the size is zero.\r\n * @returns {{size:number,offset:number,bytes:Uint8Array}} Blob reference.\r\n */\r\nexport function toRecordBlob(bytes, declaredSize, unsetOffset = 0xffffffff)\r\n{\r\n  const owned = bytes instanceof Uint8Array ? bytes : new Uint8Array(0);\r\n  const size = declaredSize ?? owned.byteLength;\r\n  return { size, offset: size === 0 ? (unsetOffset >>> 0) : 0, bytes: owned };\r\n}\r\n\r\n/**\r\n * Returns a blob reference's payload bytes, or an empty view when the reference\r\n * was never set.\r\n *\r\n * @param {{size:number,offset:number,bytes:Uint8Array}|null|undefined} ref Blob.\r\n * @returns {Uint8Array} Owned-by-the-container view over the payload.\r\n */\r\nexport function recordBytes(ref)\r\n{\r\n  const bytes = ref?.bytes;\r\n  return bytes instanceof Uint8Array ? bytes : new Uint8Array(0);\r\n}\r\n"],"names":["rawValueBuffer","DataView","ArrayBuffer","recordText","ref","String","value","recordRawValue","bytes","length","setUint8","getUint32","recordRawBits","setFloat32","Number","isFinite","toRecordText","offset","toRecordRawValue","rawValue","Uint8Array","setUint32","index","getUint8","toRecordFloat","bits","getFloat32","toRecordBlob","declaredSize","unsetOffset","owned","size","byteLength","recordBytes"],"mappings":"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"}
+{"version":3,"file":"carbonRecordFields.js","sources":["../../../../../src/resource/shader/reflection/carbonRecordFields.js"],"sourcesContent":["import { float32FromBits, float32ToBits, readU32LE } from \"#utils/bytes\";\n\n// Shared field accessors for Carbon v15 description records.\n//\n// The record tree is what the one Carbon effect reader emits\n// (`format/carbonEffect/carbonEffectRecords.js`). Each reflection class maps its\n// own record, but three field encodings recur across all of them and are worth\n// naming once rather than open-coding at every call site:\n//\n//   - a string is an arena reference `{offset, value}`, not a string;\n//   - an annotation value is four raw little-endian bytes, because Carbon writes\n//     it through one union member and reads it through another, so the bytes are\n//     the only faithful carrier;\n//   - a blob is `{size, offset, bytes}` with `offset === 0xffffffff` meaning the\n//     reference was never set, which is not the same as an empty payload.\n//\n// Both directions live here, as `recordX` and `toRecordX` pairs. They are held\n// apart by the round trip rather than by separation: records in, classes, records\n// out, compared byte for byte over the shipped corpus, so a mistake that\n// satisfied both sides would have to be an exact inverse of itself.\n\n/**\n * Reads the text out of an arena string reference.\n *\n * @param {{offset:number,value:string}|null|undefined} ref String reference.\n * @returns {string} The referenced text, or \"\" when unset.\n */\nexport function recordText(ref)\n{\n  return String(ref?.value ?? \"\");\n}\n\n/**\n * Decodes an annotation record's four raw bytes as the `u32` bit pattern the\n * reflection classes carry as `rawValue`.\n *\n * Carbon stores the value as a `{float,int32_t}` union and the type byte decides\n * which member is meaningful, so the bits travel untyped and each annotation type\n * reinterprets them itself. Decoding to a number here — rather than to a float —\n * is what keeps a value like `-FLT_MAX` exact.\n *\n * @param {Uint8Array|null|undefined} bytes Four little-endian bytes.\n * @returns {number} The unsigned 32-bit pattern those bytes carry.\n */\nexport function recordRawValue(bytes)\n{\n  if (!bytes || bytes.length < 4) return 0;\n  return readU32LE(bytes, 0);\n}\n\n/**\n * Re-encodes a record's `float` as the `u32` bit pattern the reflection classes\n * carry in their `*Raw` sampler fields.\n *\n * The container stores sampler LOD and border values as real floats, but the\n * class keeps the bits, so a value like `-FLT_MAX` survives serialization without\n * a decimal round trip. Reading the float and re-encoding it here is exact: the\n * record's value came from a `f32` read, so it is already representable.\n *\n * @param {number} value Float value from a sampler record.\n * @returns {number} The unsigned 32-bit pattern encoding that float.\n */\nexport function recordRawBits(value)\n{\n  // The non-finite substitution is the RECORD's rule, not the conversion's: a\n  // sampler record has no encoding for NaN, so it stores zero.\n  return float32ToBits(Number.isFinite(value) ? value : 0);\n}\n\n/**\n * Wraps text as the arena string reference the writer interns.\n *\n * The offset is always 0: the writer assigns real offsets while building the\n * arena, and any value here would be discarded. Carrying the text is the whole\n * job.\n *\n * @param {string} value Text value.\n * @returns {{offset:number,value:string}} String reference.\n */\nexport function toRecordText(value)\n{\n  return { offset: 0, value: String(value ?? \"\") };\n}\n\n/**\n * Encodes a `u32` bit pattern as an annotation record's four raw bytes.\n *\n * The inverse of {@link recordRawValue}, and raw for the same reason: the value\n * is written through one union member and read through another, so no numeric\n * conversion may happen on the way out either.\n *\n * @param {number} rawValue Unsigned 32-bit pattern.\n * @returns {Uint8Array} Four little-endian bytes.\n */\nexport function toRecordRawValue(rawValue)\n{\n  const\n    value = rawValue >>> 0,\n    bytes = new Uint8Array(4);\n\n  bytes[0] = value & 0xff;\n  bytes[1] = (value >>> 8) & 0xff;\n  bytes[2] = (value >>> 16) & 0xff;\n  bytes[3] = (value >>> 24) & 0xff;\n  return bytes;\n}\n\n/**\n * Decodes a `*Raw` sampler field back to the float the record stores.\n *\n * The inverse of {@link recordRawBits}. Assigning the raw `u32` straight across\n * would write `4286578687.0` where the file says `-3.4028235e38`, and every\n * structural check in the container would accept it.\n *\n * @param {number} bits Raw 32-bit pattern.\n * @returns {number} The float those bits encode.\n */\nexport function toRecordFloat(bits)\n{\n  return float32FromBits(bits ?? 0);\n}\n\n/**\n * Wraps bytes as the record codec's sized blob reference.\n *\n * A zero-length blob keeps the offset word the file carried, because the writer\n * passes it straight through rather than interning anything. That word is\n * usually `0xffffffff`, but not always — measured across the shipped corpus,\n * 150 of 4833 files carry a live-looking offset behind a zero size, and\n * normalizing it changes the bytes and can make two distinct bodies collapse\n * into one. An empty payload and an absent one are not the same thing.\n *\n * @param {Uint8Array} bytes Payload bytes.\n * @param {number} [declaredSize] Size to declare when tracked separately.\n * @param {number} [unsetOffset] Offset word to keep when the size is zero.\n * @returns {{size:number,offset:number,bytes:Uint8Array}} Blob reference.\n */\nexport function toRecordBlob(bytes, declaredSize, unsetOffset = 0xffffffff)\n{\n  const owned = bytes instanceof Uint8Array ? bytes : new Uint8Array(0);\n  const size = declaredSize ?? owned.byteLength;\n  return { size, offset: size === 0 ? (unsetOffset >>> 0) : 0, bytes: owned };\n}\n\n/**\n * Returns a blob reference's payload bytes, or an empty view when the reference\n * was never set.\n *\n * @param {{size:number,offset:number,bytes:Uint8Array}|null|undefined} ref Blob.\n * @returns {Uint8Array} Owned-by-the-container view over the payload.\n */\nexport function recordBytes(ref)\n{\n  const bytes = ref?.bytes;\n  return bytes instanceof Uint8Array ? bytes : new Uint8Array(0);\n}\n"],"names":["recordText","ref","String","value","recordRawValue","bytes","length","readU32LE","recordRawBits","float32ToBits","Number","isFinite","toRecordText","offset","toRecordRawValue","rawValue","Uint8Array","toRecordFloat","bits","float32FromBits","toRecordBlob","declaredSize","unsetOffset","owned","size","byteLength","recordBytes"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,UAAUA,CAACC,GAAG,EAC9B;AACE,EAAA,OAAOC,MAAM,CAACD,GAAG,EAAEE,KAAK,IAAI,EAAE,CAAC;AACjC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,cAAcA,CAACC,KAAK,EACpC;EACE,IAAI,CAACA,KAAK,IAAIA,KAAK,CAACC,MAAM,GAAG,CAAC,EAAE,OAAO,CAAC;AACxC,EAAA,OAAOC,SAAS,CAACF,KAAK,EAAE,CAAC,CAAC;AAC5B;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,aAAaA,CAACL,KAAK,EACnC;AACE;AACA;AACA,EAAA,OAAOM,aAAa,CAACC,MAAM,CAACC,QAAQ,CAACR,KAAK,CAAC,GAAGA,KAAK,GAAG,CAAC,CAAC;AAC1D;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASS,YAAYA,CAACT,KAAK,EAClC;EACE,OAAO;AAAEU,IAAAA,MAAM,EAAE,CAAC;AAAEV,IAAAA,KAAK,EAAED,MAAM,CAACC,KAAK,IAAI,EAAE;GAAG;AAClD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASW,gBAAgBA,CAACC,QAAQ,EACzC;AACE,EAAA,MACEZ,KAAK,GAAGY,QAAQ,KAAK,CAAC;AACtBV,IAAAA,KAAK,GAAG,IAAIW,UAAU,CAAC,CAAC,CAAC;AAE3BX,EAAAA,KAAK,CAAC,CAAC,CAAC,GAAGF,KAAK,GAAG,IAAI;EACvBE,KAAK,CAAC,CAAC,CAAC,GAAIF,KAAK,KAAK,CAAC,GAAI,IAAI;EAC/BE,KAAK,CAAC,CAAC,CAAC,GAAIF,KAAK,KAAK,EAAE,GAAI,IAAI;EAChCE,KAAK,CAAC,CAAC,CAAC,GAAIF,KAAK,KAAK,EAAE,GAAI,IAAI;AAChC,EAAA,OAAOE,KAAK;AACd;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASY,aAAaA,CAACC,IAAI,EAClC;AACE,EAAA,OAAOC,eAAe,CAACD,IAAI,IAAI,CAAC,CAAC;AACnC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,YAAYA,CAACf,KAAK,EAAEgB,YAAY,EAAEC,WAAW,GAAG,UAAU,EAC1E;AACE,EAAA,MAAMC,KAAK,GAAGlB,KAAK,YAAYW,UAAU,GAAGX,KAAK,GAAG,IAAIW,UAAU,CAAC,CAAC,CAAC;AACrE,EAAA,MAAMQ,IAAI,GAAGH,YAAY,IAAIE,KAAK,CAACE,UAAU;EAC7C,OAAO;IAAED,IAAI;IAAEX,MAAM,EAAEW,IAAI,KAAK,CAAC,GAAIF,WAAW,KAAK,CAAC,GAAI,CAAC;AAAEjB,IAAAA,KAAK,EAAEkB;GAAO;AAC7E;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,WAAWA,CAACzB,GAAG,EAC/B;AACE,EAAA,MAAMI,KAAK,GAAGJ,GAAG,EAAEI,KAAK;EACxB,OAAOA,KAAK,YAAYW,UAAU,GAAGX,KAAK,GAAG,IAAIW,UAAU,CAAC,CAAC,CAAC;AAChE;;;;"}

package/dist/resource/shader/sampler/Tr2SamplerSetup.js

@@ -1,6 +1,6 @@
+import { assertCarbonRecord } from '../../format/carbonRecordGuard.js';
 import { CjsSchema, impl, type } from '#schema';
 import { CjsModel } from '#model';
-import { isPlainObject } from '#utils/is';
 import { recordText, recordRawBits, toRecordFloat, toRecordText } from '../reflection/carbonRecordFields.js';
 
 // Source: trinity/trinity/Shader/Tr2EffectDescription.h
@@ -19,12 +19,12 @@ class Tr2SamplerSetup extends CjsModel {
   /** Whether the sampler occupies a dynamic register rather than static signature state. */
   isDynamic = false;
 
-  /**
-   * Construct a canonical sampler record from JS/JSON model values.
-   *
-   * @param {object} values Canonical model values.
-   * @param {object} options CjsModel import options.
-   * @returns {Tr2SamplerSetup} Hydrated sampler.
+  /**
+   * Construct a canonical sampler record from JS/JSON model values.
+   *
+   * @param {object} values Canonical model values.
+   * @param {object} options CjsModel import options.
+   * @returns {Tr2SamplerSetup} Hydrated sampler.
    */
   static from(values = {}, options = {}) {
     let normalized = values;
@@ -38,26 +38,24 @@ class Tr2SamplerSetup extends CjsModel {
     return super.from(normalized, options);
   }
 
-  /**
-   * Build one dynamic sampler from its Carbon v15 description record.
-   *
-   * The name is kept whatever `isDynamic` says. Carbon nulls a non-dynamic
-   * sampler's name while reading (`Tr2EffectDescription.cpp:430-433`), but that
-   * is a runtime decision made on the way to a device — the file still carries
-   * the string, and this graph has to be able to re-emit the file it came from.
-   * Dropping it loses arena content: measured across the shipped corpus, this
-   * single rule accounted for every non-byte-identical re-emission.
-   *
-   * A consumer that wants Carbon's runtime view asks for it: the name is
-   * meaningful only when `isDynamic`.
-   *
-   * @param {object} record Carbon sampler record.
-   * @returns {Tr2SamplerSetup} Reflected sampler.
+  /**
+   * Build one dynamic sampler from its Carbon v15 description record.
+   *
+   * The name is kept whatever `isDynamic` says. Carbon nulls a non-dynamic
+   * sampler's name while reading (`Tr2EffectDescription.cpp:430-433`), but that
+   * is a runtime decision made on the way to a device — the file still carries
+   * the string, and this graph has to be able to re-emit the file it came from.
+   * Dropping it loses arena content: measured across the shipped corpus, this
+   * single rule accounted for every non-byte-identical re-emission.
+   *
+   * A consumer that wants Carbon's runtime view asks for it: the name is
+   * meaningful only when `isDynamic`.
+   *
+   * @param {object} record Carbon sampler record.
+   * @returns {Tr2SamplerSetup} Reflected sampler.
    */
   static fromCarbonBinary(record) {
-    if (!isPlainObject(record)) {
-      throw new TypeError("Carbon effect sampler record must be an object");
-    }
+    assertCarbonRecord(record, "sampler");
     const sampler = new this();
     sampler.isDynamic = !!record.isDynamic;
     sampler.name = recordText(record.name);
@@ -80,15 +78,15 @@ class Tr2SamplerSetup extends CjsModel {
     return sampler;
   }
 
-  /**
-   * Emit this sampler as a Carbon v15 record.
-   *
-   * The name is written whether or not it is meaningful: Carbon's writer always
-   * emits the field, and the string it emits is the one the compiler authored,
-   * not the one Carbon's reader keeps.
-   *
-   * @param {number} registerIndex Register this sampler is bound at.
-   * @returns {object} Carbon sampler record.
+  /**
+   * Emit this sampler as a Carbon v15 record.
+   *
+   * The name is written whether or not it is meaningful: Carbon's writer always
+   * emits the field, and the string it emits is the one the compiler authored,
+   * not the one Carbon's reader keeps.
+   *
+   * @param {number} registerIndex Register this sampler is bound at.
+   * @returns {object} Carbon sampler record.
    */
   toCarbonBinary(registerIndex) {
     const descriptor = this.sampler ?? {};