npm - @carbonenginejs/runtime-resource - Versions diffs - 0.12.2 → 0.14.0 - Mend

@carbonenginejs/runtime-resource 0.12.2 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (238) hide show

package/dist/resource/shader/Tr2Shader.js CHANGED Viewed

@@ -1,6 +1,5 @@
 import { impl, CjsSchema, carbon, type } from '@carbonenginejs/runtime-utils/schema';
 import { CjsModel } from '@carbonenginejs/runtime-utils/model';
-import { validateEffectBodyReflection, isEffectBodyReflection } from '../../formats/hlsl/core/portableReflection.js';
 import { Tr2EffectDescription } from './reflection/Tr2EffectDescription.js';
 // Source: trinity/trinity/Shader/Tr2Shader.h
@@ -142,31 +141,54 @@ class Tr2Shader extends CjsModel {
   }
   /**
-   * Build one canonical GPU-free shader from complete portable reflection.
-   * Each child reflection class owns conversion of its own portable record.
+   * Build one GPU-free shader from one body of a Carbon effect container.
    *
-   * @param {object} portable Portable effect-body reflection.
+   * `reader` is the container reader the resource opened and retains; this method
+   * never opens anything of its own. A body is not independently readable — its
+   * strings are offsets into the container's shared arena, and its layout depends
+   * on the container's version — so handing each body its own reader would mean
+   * re-parsing the header per permutation and losing the arena.
+   *
+   * Carbon passes exactly that bundle, as loose arguments
+   * (`Tr2EffectRes.cpp:126-134`):
+   *
+   * ```cpp
+   * auto offset = m_offsets[index];
+   * auto buffer = ...m_data.get() + offset.offset;
+   * shader->GetEffect().Read( buffer, offset.size, m_version,
+   *                           m_stringTable, m_stringTableSize, path );
+   * shader->ProcessEffect();
+   * ```
+   *
+   * The resource owns `m_data`, `m_offsets`, `m_version` and the string table,
+   * and hands the body a pointer plus the version and arena. Here that same state
+   * is held by the reader the resource retains, so passing the reader passes the
+   * whole bundle and the resource itself adds nothing a body needs.
+   *
+   * Reading is backend-agnostic. A dx11 body reads exactly as a webgl one does;
+   * they differ only in what the optional per-pass block carries, and this method
+   * retains that block without interpreting it. What can be *realized* from the
+   * result is the engine's question, not the reader's.
+   *
+   * @param {object} reader Container reader owned by the resource.
+   * @param {number} index Permutation index within the container.
    * @returns {Tr2Shader} Canonical selected shader.
    */
-  static fromPortable(portable) {
-    validateEffectBodyReflection(portable);
+  static fromCarbonBinary(reader, index) {
     const shader = new this();
-    shader.effect = Tr2EffectDescription.fromPortable(portable.effect);
+    shader.effect = Tr2EffectDescription.fromCarbonBinary(reader.readDescription(index));
     shader.ProcessEffect();
     return shader;
   }
   /**
-   * Whether a value has the supported complete portable-reflection envelope.
+   * Find a named value across stage collections in Carbon lookup order.
    *
-   * @param {*} value Candidate value.
-   * @returns {boolean} Whether the portable envelope is supported.
+   * @param {Tr2EffectDescription} effect Effect description to search.
+   * @param {string} name Entry name.
+   * @param {string} key Stage collection key.
+   * @returns {*|null} Matching value, or `null`.
    */
-  static isPortableReflection(value) {
-    return isEffectBodyReflection(value);
-  }
-  /** Find one named reflection entry across every stage. */
   static findStageValue(effect, name, key) {
     for (const stage of Tr2Shader.iterateStages(effect)) {
       const found = Tr2Shader.findNamedCollectionValue(stage?.[key], name);

package/dist/resource/shader/Tr2Shader.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Tr2Shader.js","sources":["../../../../src/resource/shader/Tr2Shader.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2Shader.h\n// Source: trinity/trinity/Shader/Tr2Shader.cpp\nimport { CjsSchema, carbon, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport {\n isEffectBodyReflection,\n validateEffectBodyReflection\n} from \"../../formats/hlsl/portable.js\";\nimport { Tr2EffectDescription } from \"./reflection/Tr2EffectDescription.js\";\n\n/** GPU-free selected shader and its complete source reflection graph. /\nexport class Tr2Shader extends CjsModel\n{\n\n /* m_sortValue (unsigned int) /\n sortValue = 0;\n\n /* m_effect (Tr2EffectDescription) /\n effect = new Tr2EffectDescription();\n\n /* m_hasVertexBufferAccessInRtShadow (bool) /\n hasVertexBufferAccessInRtShadow = false;\n\n /\n Index of the named technique; 0 for Carbon's empty-string any-technique\n * sentinel and -1 when the shader has no techniques or the name is unknown.\n /\n GetTechniqueIndex(name = \"Main\")\n {\n const techniques = this.effect?.techniques ?? [];\n if (!techniques.length)\n {\n return -1;\n }\n if (name === \"\")\n {\n return 0;\n }\n return techniques.findIndex(technique => technique?.name === name);\n }\n\n /* Number of passes in a technique; 0 for an unknown index. /\n GetPassCount(techniqueIndex = 0)\n {\n return this.effect?.techniques?.[techniqueIndex]?.passes?.length ?? 0;\n }\n\n /\n The reflected constant of this name from any stage of any pass, or null;\n * the description is metadata, not a bound GPU slot.\n /\n GetConstant(name)\n {\n return Tr2Shader.findStageValue(this.effect, name, \"constants\");\n }\n\n /\n The reflected resource of this name, searching stage resources before\n * UAVs; null when neither has it.\n /\n GetResource(name)\n {\n for (const stage of Tr2Shader.iterateStages(this.effect))\n {\n const resource = Tr2Shader.findNamedCollectionValue(\n stage?.resources,\n name\n );\n if (resource)\n {\n return resource;\n }\n const uav = Tr2Shader.findNamedCollectionValue(stage?.uavs, name);\n if (uav)\n {\n return uav;\n }\n }\n return null;\n }\n\n /\n The annotation set authored for a parameter name, or null; the shape\n * depends on the reflection source.\n /\n GetParameterAnnotations(parameterName)\n {\n return Tr2Shader.findAnnotationSet(\n this.effect?.annotations,\n parameterName\n );\n }\n\n /* The packed draw-sort key; 0 until ProcessEffect has run. /\n GetSortValue()\n {\n return this.sortValue;\n }\n\n /* The reflected effect description, by reference rather than copy. /\n GetEffectDescription()\n {\n return this.effect;\n }\n\n /* The same object GetEffectDescription returns. /\n GetEffect()\n {\n return this.effect;\n }\n\n /* The technique's bitmask of shader stages, or 0 for an unknown index. /\n GetShaderTypeMask(techniqueIndex = 0)\n {\n return Number(\n this.effect?.techniques?.[techniqueIndex]?.shaderTypeMask ?? 0\n );\n }\n\n /\n Pack the first technique/pass's renderer handles into Carbon's sort key.\n * A device-free source graph retains 0 while its handles remain invalid.\n /\n ProcessEffect()\n {\n this.sortValue = 0;\n const pass = this.effect?.techniques?.[0]?.passes?.[0];\n if (!pass)\n {\n return;\n }\n const stages = pass.stageInputs ?? [];\n const pixelHandle = Number(\n stages[1]?.shader ?? stages[1]?.m_shader ?? 0xffffffff\n );\n const vertexHandle = Number(\n stages[0]?.shader ?? stages[0]?.m_shader ?? 0xffffffff\n );\n if (pixelHandle === 0xffffffff \|\| vertexHandle === 0xffffffff)\n {\n return;\n }\n const pixelShader = pixelHandle & 0x3ff;\n const vertexShader = vertexHandle & 0x3ff;\n const renderStates = Number(pass.renderStates ?? 0) & 0x3ff;\n const passCount = Number(\n this.effect?.techniques?.[0]?.passes?.length ?? 0\n ) & 0x3;\n this.sortValue = (\n (passCount << 30)\n \| (pixelShader << 20)\n \| (vertexShader << 10)\n \| renderStates\n ) >>> 0;\n }\n\n /* Whether this shader accesses vertex buffers in RT shadow mode. /\n HasVertexBufferAccessInRtShadow()\n {\n return this.hasVertexBufferAccessInRtShadow;\n }\n\n /\n Construct a canonical shader graph from JS/JSON model values.\n \n @param {object} values Canonical model values.\n * @param {object} options CjsModel import options.\n * @returns {Tr2Shader} Hydrated shader graph.\n /\n static from(values = {}, options = {})\n {\n let normalized = values;\n if (values?.effect\n && !(values.effect instanceof Tr2EffectDescription))\n {\n normalized = {\n ...values,\n effect: Tr2EffectDescription.from(values.effect, options)\n };\n }\n const shader = super.from(normalized, options);\n if (!Object.hasOwn(values ?? {}, \"sortValue\"))\n {\n shader.ProcessEffect();\n }\n return shader;\n }\n\n /\n Build one canonical GPU-free shader from complete portable reflection.\n * Each child reflection class owns conversion of its own portable record.\n \n @param {object} portable Portable effect-body reflection.\n * @returns {Tr2Shader} Canonical selected shader.\n /\n static fromPortable(portable)\n {\n validateEffectBodyReflection(portable);\n\n const shader = new this();\n shader.effect = Tr2EffectDescription.fromPortable(portable.effect);\n shader.ProcessEffect();\n return shader;\n }\n\n /\n Whether a value has the supported complete portable-reflection envelope.\n \n @param {} value Candidate value.\n @returns {boolean} Whether the portable envelope is supported.\n /\n static isPortableReflection(value)\n {\n return isEffectBodyReflection(value);\n }\n\n /* Find one named reflection entry across every stage. /\n static findStageValue(effect, name, key)\n {\n for (const stage of Tr2Shader.iterateStages(effect))\n {\n const found = Tr2Shader.findNamedCollectionValue(stage?.[key], name);\n if (found)\n {\n return found;\n }\n }\n return null;\n }\n\n /* Flatten pass stage inputs in Carbon lookup order. /\n static iterateStages(effect)\n {\n const stages = [];\n for (const technique of effect?.techniques ?? [])\n {\n for (const pass of technique?.passes ?? [])\n {\n stages.push(...pass?.stageInputs ?? []);\n }\n }\n return stages;\n }\n\n /* Find a named entry in an array, Map, or plain object collection. /\n static findNamedCollectionValue(values, name)\n {\n if (!values)\n {\n return null;\n }\n if (Array.isArray(values))\n {\n return values.find(\n value => value?.name === name \|\| value?.[1]?.name === name\n ) ?? null;\n }\n if (values instanceof Map)\n {\n for (const value of values.values())\n {\n if (value?.name === name)\n {\n return value;\n }\n }\n return null;\n }\n for (const value of Object.values(values))\n {\n if (value?.name === name)\n {\n return value;\n }\n }\n return null;\n }\n\n /* Resolve a parameter's annotations from a Map, array, or plain object. */\n static findAnnotationSet(annotations, parameterName)\n {\n if (!annotations)\n {\n return null;\n }\n if (annotations instanceof Map)\n {\n return annotations.get(parameterName) ?? null;\n }\n if (Array.isArray(annotations))\n {\n const entry = annotations.find(\n item => item?.name === parameterName\n \|\| item?.[0] === parameterName\n );\n return entry?.annotations ?? entry?.value ?? entry?.[1] ?? null;\n }\n return annotations[parameterName] ?? null;\n }\n\n}\n\n// Declared as data rather than with decorators, so this module stays plain ESM\n// that loads from source without a transform. The decorator vocabulary is used\n// verbatim as values, so the registered metadata is identical to the decorated\n// form. Field order is key order, and it drives GetValues() export order.\n// Statics belong in `methods`: the prototype is what carries instance fields.\nconst UNVALIDATED_TECHNIQUE_INDEX = impl.reason(\n \"Carbon assumes an already-validated technique index; CarbonEngineJS safely returns zero for an unavailable index.\"\n);\n\nCjsSchema.define(Tr2Shader, {\n className: \"Tr2Shader\",\n family: \"shader\",\n fields: {\n sortValue: type.uint32,\n effect: type.rawStruct(\"Tr2EffectDescription\"),\n hasVertexBufferAccessInRtShadow: type.boolean\n },\n methods: {\n GetTechniqueIndex: [ carbon.method, impl.adapted, impl.reason(\"Carbon returns success through a bool plus output index; CarbonEngineJS returns the index directly or -1 while preserving exact name lookup.\") ],\n GetPassCount: [ carbon.method, impl.adapted, UNVALIDATED_TECHNIQUE_INDEX ],\n GetConstant: [ carbon.method, impl.implemented ],\n GetResource: [ carbon.method, impl.implemented ],\n GetParameterAnnotations: [ carbon.method, impl.implemented ],\n GetSortValue: [ carbon.method, impl.implemented ],\n GetEffectDescription: [ carbon.method, impl.implemented ],\n GetEffect: [ carbon.method, impl.implemented ],\n GetShaderTypeMask: [ carbon.method, impl.adapted, UNVALIDATED_TECHNIQUE_INDEX ],\n ProcessEffect: [ carbon.method, impl.adapted, impl.reason(\"Carbon packs renderer handles assigned while reading; the device-free graph leaves the sort key zero until an engine assigns valid handles.\") ],\n HasVertexBufferAccessInRtShadow: [ carbon.method, impl.implemented ]\n }\n});\n"],"names":["Tr2Shader","CjsModel","sortValue","effect","Tr2EffectDescription","hasVertexBufferAccessInRtShadow","GetTechniqueIndex","name","techniques","length","findIndex","technique","GetPassCount","techniqueIndex","passes","GetConstant","findStageValue","GetResource","stage","iterateStages","resource","findNamedCollectionValue","resources","uav","uavs","GetParameterAnnotations","parameterName","findAnnotationSet","annotations","GetSortValue","GetEffectDescription","GetEffect","GetShaderTypeMask","Number","shaderTypeMask","ProcessEffect","pass","stages","stageInputs","pixelHandle","shader","m_shader","vertexHandle","pixelShader","vertexShader","renderStates","passCount","HasVertexBufferAccessInRtShadow","from","values","options","normalized","Object","hasOwn","fromPortable","portable","validateEffectBodyReflection","isPortableReflection","value","isEffectBodyReflection","key","found","push","Array","isArray","find","Map","get","entry","item","UNVALIDATED_TECHNIQUE_INDEX","impl","reason","CjsSchema","define","className","family","fields","type","uint32","rawStruct","boolean","methods","carbon","method","adapted","implemented"],"mappings":"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"}
1	+ {"version":3,"file":"Tr2Shader.js","sources":["../../../../src/resource/shader/Tr2Shader.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2Shader.h\n// Source: trinity/trinity/Shader/Tr2Shader.cpp\nimport { CjsSchema, carbon, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { Tr2EffectDescription } from \"./reflection/Tr2EffectDescription.js\";\n\n/** GPU-free selected shader and its complete source reflection graph. /\nexport class Tr2Shader extends CjsModel\n{\n\n /* m_sortValue (unsigned int) /\n sortValue = 0;\n\n /* m_effect (Tr2EffectDescription) /\n effect = new Tr2EffectDescription();\n\n /* m_hasVertexBufferAccessInRtShadow (bool) /\n hasVertexBufferAccessInRtShadow = false;\n\n /\n Index of the named technique; 0 for Carbon's empty-string any-technique\n * sentinel and -1 when the shader has no techniques or the name is unknown.\n /\n GetTechniqueIndex(name = \"Main\")\n {\n const techniques = this.effect?.techniques ?? [];\n if (!techniques.length)\n {\n return -1;\n }\n if (name === \"\")\n {\n return 0;\n }\n return techniques.findIndex(technique => technique?.name === name);\n }\n\n /* Number of passes in a technique; 0 for an unknown index. /\n GetPassCount(techniqueIndex = 0)\n {\n return this.effect?.techniques?.[techniqueIndex]?.passes?.length ?? 0;\n }\n\n /\n The reflected constant of this name from any stage of any pass, or null;\n * the description is metadata, not a bound GPU slot.\n /\n GetConstant(name)\n {\n return Tr2Shader.findStageValue(this.effect, name, \"constants\");\n }\n\n /\n The reflected resource of this name, searching stage resources before\n * UAVs; null when neither has it.\n /\n GetResource(name)\n {\n for (const stage of Tr2Shader.iterateStages(this.effect))\n {\n const resource = Tr2Shader.findNamedCollectionValue(\n stage?.resources,\n name\n );\n if (resource)\n {\n return resource;\n }\n const uav = Tr2Shader.findNamedCollectionValue(stage?.uavs, name);\n if (uav)\n {\n return uav;\n }\n }\n return null;\n }\n\n /\n The annotation set authored for a parameter name, or null; the shape\n * depends on the reflection source.\n /\n GetParameterAnnotations(parameterName)\n {\n return Tr2Shader.findAnnotationSet(\n this.effect?.annotations,\n parameterName\n );\n }\n\n /* The packed draw-sort key; 0 until ProcessEffect has run. /\n GetSortValue()\n {\n return this.sortValue;\n }\n\n /* The reflected effect description, by reference rather than copy. /\n GetEffectDescription()\n {\n return this.effect;\n }\n\n /* The same object GetEffectDescription returns. /\n GetEffect()\n {\n return this.effect;\n }\n\n /* The technique's bitmask of shader stages, or 0 for an unknown index. /\n GetShaderTypeMask(techniqueIndex = 0)\n {\n return Number(\n this.effect?.techniques?.[techniqueIndex]?.shaderTypeMask ?? 0\n );\n }\n\n /\n Pack the first technique/pass's renderer handles into Carbon's sort key.\n * A device-free source graph retains 0 while its handles remain invalid.\n /\n ProcessEffect()\n {\n this.sortValue = 0;\n const pass = this.effect?.techniques?.[0]?.passes?.[0];\n if (!pass)\n {\n return;\n }\n const stages = pass.stageInputs ?? [];\n const pixelHandle = Number(\n stages[1]?.shader ?? stages[1]?.m_shader ?? 0xffffffff\n );\n const vertexHandle = Number(\n stages[0]?.shader ?? stages[0]?.m_shader ?? 0xffffffff\n );\n if (pixelHandle === 0xffffffff \|\| vertexHandle === 0xffffffff)\n {\n return;\n }\n const pixelShader = pixelHandle & 0x3ff;\n const vertexShader = vertexHandle & 0x3ff;\n const renderStates = Number(pass.renderStates ?? 0) & 0x3ff;\n const passCount = Number(\n this.effect?.techniques?.[0]?.passes?.length ?? 0\n ) & 0x3;\n this.sortValue = (\n (passCount << 30)\n \| (pixelShader << 20)\n \| (vertexShader << 10)\n \| renderStates\n ) >>> 0;\n }\n\n /* Whether this shader accesses vertex buffers in RT shadow mode. /\n HasVertexBufferAccessInRtShadow()\n {\n return this.hasVertexBufferAccessInRtShadow;\n }\n\n /\n Construct a canonical shader graph from JS/JSON model values.\n \n @param {object} values Canonical model values.\n * @param {object} options CjsModel import options.\n * @returns {Tr2Shader} Hydrated shader graph.\n /\n static from(values = {}, options = {})\n {\n let normalized = values;\n if (values?.effect\n && !(values.effect instanceof Tr2EffectDescription))\n {\n normalized = {\n ...values,\n effect: Tr2EffectDescription.from(values.effect, options)\n };\n }\n const shader = super.from(normalized, options);\n if (!Object.hasOwn(values ?? {}, \"sortValue\"))\n {\n shader.ProcessEffect();\n }\n return shader;\n }\n\n /\n Build one GPU-free shader from one body of a Carbon effect container.\n \n `reader` is the container reader the resource opened and retains; this method\n * never opens anything of its own. A body is not independently readable — its\n * strings are offsets into the container's shared arena, and its layout depends\n * on the container's version — so handing each body its own reader would mean\n * re-parsing the header per permutation and losing the arena.\n \n Carbon passes exactly that bundle, as loose arguments\n * (`Tr2EffectRes.cpp:126-134`):\n \n ```cpp\n * auto offset = m_offsets[index];\n * auto buffer = ...m_data.get() + offset.offset;\n * shader->GetEffect().Read( buffer, offset.size, m_version,\n * m_stringTable, m_stringTableSize, path );\n * shader->ProcessEffect();\n * ```\n \n The resource owns `m_data`, `m_offsets`, `m_version` and the string table,\n * and hands the body a pointer plus the version and arena. Here that same state\n * is held by the reader the resource retains, so passing the reader passes the\n * whole bundle and the resource itself adds nothing a body needs.\n \n Reading is backend-agnostic. A dx11 body reads exactly as a webgl one does;\n * they differ only in what the optional per-pass block carries, and this method\n * retains that block without interpreting it. What can be realized from the\n * result is the engine's question, not the reader's.\n \n @param {object} reader Container reader owned by the resource.\n * @param {number} index Permutation index within the container.\n * @returns {Tr2Shader} Canonical selected shader.\n /\n static fromCarbonBinary(reader, index)\n {\n const shader = new this();\n shader.effect = Tr2EffectDescription.fromCarbonBinary(\n reader.readDescription(index)\n );\n shader.ProcessEffect();\n return shader;\n }\n\n /\n Find a named value across stage collections in Carbon lookup order.\n \n @param {Tr2EffectDescription} effect Effect description to search.\n * @param {string} name Entry name.\n * @param {string} key Stage collection key.\n * @returns {\|null} Matching value, or `null`.\n /\n static findStageValue(effect, name, key)\n {\n for (const stage of Tr2Shader.iterateStages(effect))\n {\n const found = Tr2Shader.findNamedCollectionValue(stage?.[key], name);\n if (found)\n {\n return found;\n }\n }\n return null;\n }\n\n /** Flatten pass stage inputs in Carbon lookup order. /\n static iterateStages(effect)\n {\n const stages = [];\n for (const technique of effect?.techniques ?? [])\n {\n for (const pass of technique?.passes ?? [])\n {\n stages.push(...pass?.stageInputs ?? []);\n }\n }\n return stages;\n }\n\n /* Find a named entry in an array, Map, or plain object collection. /\n static findNamedCollectionValue(values, name)\n {\n if (!values)\n {\n return null;\n }\n if (Array.isArray(values))\n {\n return values.find(\n value => value?.name === name \|\| value?.[1]?.name === name\n ) ?? null;\n }\n if (values instanceof Map)\n {\n for (const value of values.values())\n {\n if (value?.name === name)\n {\n return value;\n }\n }\n return null;\n }\n for (const value of Object.values(values))\n {\n if (value?.name === name)\n {\n return value;\n }\n }\n return null;\n }\n\n /* Resolve a parameter's annotations from a Map, array, or plain object. */\n static findAnnotationSet(annotations, parameterName)\n {\n if (!annotations)\n {\n return null;\n }\n if (annotations instanceof Map)\n {\n return annotations.get(parameterName) ?? null;\n }\n if (Array.isArray(annotations))\n {\n const entry = annotations.find(\n item => item?.name === parameterName\n \|\| item?.[0] === parameterName\n );\n return entry?.annotations ?? entry?.value ?? entry?.[1] ?? null;\n }\n return annotations[parameterName] ?? null;\n }\n\n}\n\n// Declared as data rather than with decorators, so this module stays plain ESM\n// that loads from source without a transform. The decorator vocabulary is used\n// verbatim as values, so the registered metadata is identical to the decorated\n// form. Field order is key order, and it drives GetValues() export order.\n// Statics belong in `methods`: the prototype is what carries instance fields.\nconst UNVALIDATED_TECHNIQUE_INDEX = impl.reason(\n \"Carbon assumes an already-validated technique index; CarbonEngineJS safely returns zero for an unavailable index.\"\n);\n\nCjsSchema.define(Tr2Shader, {\n className: \"Tr2Shader\",\n family: \"shader\",\n fields: {\n sortValue: type.uint32,\n effect: type.rawStruct(\"Tr2EffectDescription\"),\n hasVertexBufferAccessInRtShadow: type.boolean\n },\n methods: {\n GetTechniqueIndex: [ carbon.method, impl.adapted, impl.reason(\"Carbon returns success through a bool plus output index; CarbonEngineJS returns the index directly or -1 while preserving exact name lookup.\") ],\n GetPassCount: [ carbon.method, impl.adapted, UNVALIDATED_TECHNIQUE_INDEX ],\n GetConstant: [ carbon.method, impl.implemented ],\n GetResource: [ carbon.method, impl.implemented ],\n GetParameterAnnotations: [ carbon.method, impl.implemented ],\n GetSortValue: [ carbon.method, impl.implemented ],\n GetEffectDescription: [ carbon.method, impl.implemented ],\n GetEffect: [ carbon.method, impl.implemented ],\n GetShaderTypeMask: [ carbon.method, impl.adapted, UNVALIDATED_TECHNIQUE_INDEX ],\n ProcessEffect: [ carbon.method, impl.adapted, impl.reason(\"Carbon packs renderer handles assigned while reading; the device-free graph leaves the sort key zero until an engine assigns valid handles.\") ],\n HasVertexBufferAccessInRtShadow: [ carbon.method, impl.implemented ]\n }\n});\n"],"names":["Tr2Shader","CjsModel","sortValue","effect","Tr2EffectDescription","hasVertexBufferAccessInRtShadow","GetTechniqueIndex","name","techniques","length","findIndex","technique","GetPassCount","techniqueIndex","passes","GetConstant","findStageValue","GetResource","stage","iterateStages","resource","findNamedCollectionValue","resources","uav","uavs","GetParameterAnnotations","parameterName","findAnnotationSet","annotations","GetSortValue","GetEffectDescription","GetEffect","GetShaderTypeMask","Number","shaderTypeMask","ProcessEffect","pass","stages","stageInputs","pixelHandle","shader","m_shader","vertexHandle","pixelShader","vertexShader","renderStates","passCount","HasVertexBufferAccessInRtShadow","from","values","options","normalized","Object","hasOwn","fromCarbonBinary","reader","index","readDescription","key","found","push","Array","isArray","find","value","Map","get","entry","item","UNVALIDATED_TECHNIQUE_INDEX","impl","reason","CjsSchema","define","className","family","fields","type","uint32","rawStruct","boolean","methods","carbon","method","adapted","implemented"],"mappings":"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"}

package/dist/resource/shader/reflection/Tr2EffectConstant.js CHANGED Viewed

@@ -1,6 +1,7 @@
 import { CjsSchema } from '@carbonenginejs/runtime-utils/schema';
 import { CjsModel } from '@carbonenginejs/runtime-utils/model';
-import { isPlainObject, isUint32 } from '@carbonenginejs/runtime-utils/is';
+import { isPlainObject } from '@carbonenginejs/runtime-utils/is';
+import { recordText, toRecordText } from './carbonRecordFields.js';
 // Source: trinity/trinity/Shader/Tr2EffectDescription.h
@@ -31,41 +32,48 @@ class Tr2EffectConstant extends CjsModel {
   isAutoregister = false;
   /**
-   * Build one constant from its portable JSON reflection record.
+   * Build one constant from its Carbon v15 description record.
    *
-   * @param {object} value Portable constant record.
+   * The record's numeric fields are already the widths Carbon declares, so this
+   * is a rename plus the two byte-to-bool conversions; only `name` needs
+   * dereferencing, because strings live in the container's arena.
+   *
+   * @param {object} record Carbon constant record.
    * @returns {Tr2EffectConstant} Reflected constant.
    */
-  static fromPortable(value) {
-    if (!isPlainObject(value)) {
-      throw new TypeError("Portable effect constant must be an object");
-    }
-    if (!isUint32(value.offset)) {
-      throw new RangeError("Portable constant offset must fit uint32");
-    }
-    if (!isUint32(value.size)) {
-      throw new RangeError("Portable constant size must fit uint32");
-    }
-    if (!isUint32(value.type)) {
-      throw new RangeError("Portable constant type must fit uint32");
-    }
-    if (!isUint32(value.dimension)) {
-      throw new RangeError("Portable constant dimension must fit uint32");
-    }
-    if (!isUint32(value.elements)) {
-      throw new RangeError("Portable constant element count must fit uint32");
+  static fromCarbonBinary(record) {
+    if (!isPlainObject(record)) {
+      throw new TypeError("Carbon effect constant record must be an object");
     }
     const constant = new this();
-    constant.name = String(value.name ?? "");
-    constant.offset = value.offset;
-    constant.size = value.size;
-    constant.type = value.type;
-    constant.dimension = value.dimension;
-    constant.elements = value.elements;
-    constant.isSRGB = !!value.isSRGB;
-    constant.isAutoregister = !!value.isAutoregister;
+    constant.name = recordText(record.name);
+    constant.offset = record.offset;
+    constant.size = record.size;
+    constant.type = record.type;
+    constant.dimension = record.dimension;
+    constant.elements = record.elements;
+    constant.isSRGB = !!record.isSRGB;
+    constant.isAutoregister = !!record.isAutoregister;
     return constant;
   }
+  /**
+   * Emit this constant as a Carbon v15 description record.
+   *
+   * @returns {object} Carbon constant record.
+   */
+  toCarbonBinary() {
+    return {
+      name: toRecordText(this.name),
+      offset: this.offset,
+      size: this.size,
+      type: this.type,
+      dimension: this.dimension,
+      elements: this.elements,
+      isSRGB: this.isSRGB ? 1 : 0,
+      isAutoregister: this.isAutoregister ? 1 : 0
+    };
+  }
   static Type = Object.freeze({
     FLOAT: 0,
     INT: 1,

package/dist/resource/shader/reflection/Tr2EffectConstant.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Tr2EffectConstant.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectConstant.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\nimport { CjsSchema } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport {\n isPlainObject~~,\n isUint32~~\n} from \"@carbonenginejs/runtime-utils/is\";\n\n/** Reflected shader constant metadata. /\nexport class Tr2EffectConstant extends CjsModel\n{\n\n /* name (BlueSharedString) /\n name = \"\";\n\n /* offset (unsigned) /\n offset = 0;\n\n /* size (unsigned) /\n size = 0;\n\n /* type (Type - enum Type) /\n type = 0;\n\n /* dimension (unsigned) /\n dimension = 0;\n\n /* elements (unsigned) /\n elements = 0;\n\n /* isSRGB (bool) /\n isSRGB = false;\n\n /* isAutoregister (bool) /\n isAutoregister = false;\n\n /\n Build one constant from its ~~portable~~ ~~JSON~~ ~~reflection~~ record.\n \n ~~@param~~ ~~{object}~~ ~~value~~ ~~Portable~~ ~~constant~~ record.\n * ~~@returns~~ ~~{Tr2EffectConstant}~~ ~~Reflected~~ ~~constant.\n */\n static~~ ~~fromPortable(value)\n {\n if~~ ~~(!isPlainObject(value))~~\n ~~{\n throw~~ ~~new~~ ~~TypeError(\"Portable~~ ~~effect~~ ~~constant~~ ~~must~~ be an ~~object\");\n }\n if~~ ~~(!isUint32(value.offset))~~\n ~~{\n throw~~ ~~new~~ ~~RangeError(\"Portable~~ ~~constant~~ ~~offset~~ ~~must~~ ~~fit~~ ~~uint32\");\~~n }\n if ~~(!isUint32(value.size))\n~~ {~~\n throw~~ ~~new~~ ~~RangeError(\"Portable~~ constant ~~size~~ ~~must~~ ~~fit uint32\");\n~~ }~~\n if~~ ~~(!isUint32(value.type))\n {\n throw~~ ~~new RangeError(\"Portable~~ constant ~~type must fit uint32\");\~~n }\n if (~~!isUint32(value.dimension~~))\n {\n ~~throw new RangeError(\"Portable constant dimension must fit uint32\");\n~~ ~~}\n~~ if (!~~isUint32~~(~~value.elements~~))\n {\n throw new ~~RangeError~~(\~~n \~~"~~Portable~~ constant ~~element~~ ~~count~~ must ~~fit~~ ~~uint32~~\"\n );\n }\n\n const constant = new this();\n constant.name = ~~String~~(~~value~~.name ~~?? \"\"~~);\n constant.offset = ~~value~~.offset;\n constant.size = ~~value~~.size;\n constant.type = ~~value~~.type;\n constant.dimension = ~~value~~.dimension;\n constant.elements = ~~value~~.elements;\n constant.isSRGB = !!~~value~~.isSRGB;\n constant.isAutoregister = !!~~value~~.isAutoregister;\n return constant;\n }\n\n static Type = Object.freeze({\n FLOAT: 0,\n INT: 1,\n UINT: 2,\n BOOL: 3,\n OTHER: 4\n });\n\n}\n\n// Declared imperatively rather than with decorators, so this module stays plain\n// ESM that loads from source without a transform, which lets its tests import\n// source instead of build output.\n//\n// Field order matters: it drives GetValues() export order. Statics belong in\n// `methods` here rather than in a decorateMethod() call, which targets the\n// prototype and would register a static as an instance field.\nCjsSchema.define(Tr2EffectConstant, {\n className: \"Tr2EffectConstant\",\n family: \"shader\",\n fields: [\n { name: \"name\", type: { kind: \"string\" } },\n { name: \"offset\", type: { kind: \"uint32\" } },\n { name: \"size\", type: { kind: \"uint32\" } },\n { name: \"type\", enum: { enumType: \"Type\" }, type: { kind: \"int32\" } },\n { name: \"dimension\", type: { kind: \"uint32\" } },\n { name: \"elements\", type: { kind: \"uint32\" } },\n { name: \"isSRGB\", type: { kind: \"boolean\" } },\n { name: \"isAutoregister\", type: { kind: \"boolean\" } }\n ]\n});\n"],"names":["Tr2EffectConstant","CjsModel","name","offset","size","type","dimension","elements","isSRGB","isAutoregister","~~fromPortable~~","~~value~~","isPlainObject","TypeError","~~isUint32~~","~~RangeError~~","~~constant~~","~~String~~","Type","Object","freeze","FLOAT","INT","UINT","BOOL","OTHER","CjsSchema","define","className","family","fields","kind","enum","enumType"],"mappings":"~~;;;;~~AAAA;;AAQA;AACO,MAAMA,iBAAiB,SAASC,QAAQ,CAC/C;AAEE;AACAC,EAAAA,IAAI,GAAG,EAAE;;AAET;AACAC,EAAAA,MAAM,GAAG,CAAC;;AAEV;AACAC,EAAAA,IAAI,GAAG,CAAC;;AAER;AACAC,EAAAA,IAAI,GAAG,CAAC;;AAER;AACAC,EAAAA,SAAS,GAAG,CAAC;;AAEb;AACAC,EAAAA,QAAQ,GAAG,CAAC;;AAEZ;AACAC,EAAAA,MAAM,GAAG,KAAK;;AAEd;AACAC,EAAAA,cAAc,GAAG,KAAK;;AAEtB;AACF;AACA;AACA;AACA;AACA;EACE,OAAOC,~~YAAYA~~,CAACC,~~KAAK~~,~~EACzB~~;AACE,IAAA,IAAI,CAACC,aAAa,CAACD,~~KAAK~~,CAAC,~~EACzB~~;AACE,MAAA,MAAM,IAAIE,SAAS,CAAC,~~4CAA4C~~,CAAC;~~AACnE~~,IAAA;~~AACA~~,IAAA,~~IAAI~~,~~CAACC,~~QAAQ,~~CAACH~~,~~KAAK~~,~~CAACR~~,~~MAAM~~,~~CAAC~~,~~EAC3B;AACE~~,~~MAAA~~,~~MAAM~~,~~IAAIY,~~UAAU,~~CAAC~~,~~0CAA0C~~,CAAC;~~AAClE~~,~~IAAA;AACA~~,~~IAAA,IAAI,CAACD,~~QAAQ,~~CAACH~~,~~KAAK~~,~~CAACP~~,~~IAAI~~,~~CAAC~~,~~EACzB~~;~~AACE~~,~~MAAA~~,~~MAAM~~,~~IAAIW~~,~~UAAU~~,~~CAAC~~,~~wCAAwC~~,~~CAAC;AAChE~~,~~IAAA~~;~~AACA~~,~~IAAA~~,~~IAAI~~,~~CAACD~~,~~QAAQ~~,~~CAACH~~,~~KAAK~~,CAACN,IAAI~~,CAAC,EACzB~~;~~AACE~~,~~MAAA~~,~~MAAM~~,~~IAAIU~~,~~UAAU~~,~~CAAC~~,~~wCAAwC~~,~~CAAC;AAChE~~,~~IAAA~~;~~AACA~~,~~IAAA~~,~~IAAI~~,~~CAACD~~,QAAQ,~~CAACH~~,~~KAAK~~,~~CAACL~~,~~SAAS~~,~~CAAC~~,~~EAC9B;AACE~~,~~MAAA~~,MAAM,~~IAAIS~~,~~UAAU,~~CAAC,~~6CAA6C~~,~~CAAC;AACrE~~,~~IAAA~~;~~AACA~~,~~IAAA~~,~~IAAI,CAACD,~~QAAQ,~~CAACH~~,~~KAAK~~,~~CAACJ~~,~~QAAQ,~~CAAC,~~EAC7B;AACE~~,~~MAAA,~~MAAM,~~IAAIQ~~,~~UAAU,CAClB,iDACF,CAAC~~;~~AACH~~,IAAA~~;AAEA~~,~~IAAA~~,~~MAAMC,~~QAAQ,~~GAAG~~,~~IAAI~~,~~IAAI~~,~~EAAE~~;~~IAC3BA~~,~~QAAQ~~,~~CAACd~~,IAAI,~~GAAGe~~,~~MAAM~~,~~CAACN~~,~~KAAK~~,~~CAACT~~,IAAI,~~IAAI,EAAE,~~CAAC;~~AACxCc~~,~~IAAAA,QAAQ,CAACb,~~MAAM,~~GAAGQ~~,~~KAAK~~,~~CAACR~~,MAAM;~~AAC9Ba~~,~~IAAAA~~,~~QAAQ~~,~~CAACZ,~~IAAI,~~GAAGO~~,~~KAAK,CAACP,~~IAAI;~~AAC1BY~~,~~IAAAA~~,~~QAAQ~~,~~CAACX,~~IAAI,~~GAAGM~~,~~KAAK,CAACN,~~IAAI;~~AAC1BW~~,~~IAAAA,QAAQ,CAACV,~~SAAS,~~GAAGK~~,~~KAAK~~,~~CAACL~~,SAAS;~~AACpCU~~,~~IAAAA,~~QAAQ,~~CAACT~~,~~QAAQ~~,~~GAAGI~~,~~KAAK,CAACJ,~~QAAQ;~~AAClCS~~,~~IAAAA~~,~~QAAQ~~,~~CAACR~~,MAAM,GAAG,CAAC,~~CAACG~~,~~KAAK~~,~~CAACH~~,~~MAAM;AAChCQ~~,~~IAAAA~~,~~QAAQ~~,~~CAACP~~,cAAc,GAAG,CAAC,~~CAACE,KAAK,CAACF,cAAc~~;~~AAChD,IAAA,OAAOO,QAAQ~~;~~AACjB~~,EAAA;AAEA,EAAA,~~OAAOE~~,IAAI,GAAGC,MAAM,CAACC,MAAM,CAAC;AAC1BC,IAAAA,KAAK,EAAE,CAAC;AACRC,IAAAA,GAAG,EAAE,CAAC;AACNC,IAAAA,IAAI,EAAE,CAAC;AACPC,IAAAA,IAAI,EAAE,CAAC;AACPC,IAAAA,KAAK,EAAE;AACT,GAAC,CAAC;AAEJ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACAC,SAAS,CAACC,MAAM,CAAC3B,iBAAiB,EAAE;AAClC4B,EAAAA,SAAS,EAAE,mBAAmB;AAC9BC,EAAAA,MAAM,EAAE,QAAQ;AAChBC,EAAAA,MAAM,EAAE,CACN;AAAE5B,IAAAA,IAAI,EAAE,MAAM;AAAEG,IAAAA,IAAI,EAAE;AAAE0B,MAAAA,IAAI,EAAE;AAAS;AAAE,GAAC,EAC1C;AAAE7B,IAAAA,IAAI,EAAE,QAAQ;AAAEG,IAAAA,IAAI,EAAE;AAAE0B,MAAAA,IAAI,EAAE;AAAS;AAAE,GAAC,EAC5C;AAAE7B,IAAAA,IAAI,EAAE,MAAM;AAAEG,IAAAA,IAAI,EAAE;AAAE0B,MAAAA,IAAI,EAAE;AAAS;AAAE,GAAC,EAC1C;AAAE7B,IAAAA,IAAI,EAAE,MAAM;AAAE8B,IAAAA,IAAI,EAAE;AAAEC,MAAAA,QAAQ,EAAE;KAAQ;AAAE5B,IAAAA,IAAI,EAAE;AAAE0B,MAAAA,IAAI,EAAE;AAAQ;AAAE,GAAC,EACrE;AAAE7B,IAAAA,IAAI,EAAE,WAAW;AAAEG,IAAAA,IAAI,EAAE;AAAE0B,MAAAA,IAAI,EAAE;AAAS;AAAE,GAAC,EAC/C;AAAE7B,IAAAA,IAAI,EAAE,UAAU;AAAEG,IAAAA,IAAI,EAAE;AAAE0B,MAAAA,IAAI,EAAE;AAAS;AAAE,GAAC,EAC9C;AAAE7B,IAAAA,IAAI,EAAE,QAAQ;AAAEG,IAAAA,IAAI,EAAE;AAAE0B,MAAAA,IAAI,EAAE;AAAU;AAAE,GAAC,EAC7C;AAAE7B,IAAAA,IAAI,EAAE,gBAAgB;AAAEG,IAAAA,IAAI,EAAE;AAAE0B,MAAAA,IAAI,EAAE;AAAU;GAAG;AAEzD,CAAC,CAAC;;;;"}
1	+ {"version":3,"file":"Tr2EffectConstant.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectConstant.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\nimport { CjsSchema } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport {\n isPlainObject\n} from \"@carbonenginejs/runtime-utils/is\";\nimport { recordText, toRecordText } from \"./carbonRecordFields.js\";\n\n/** Reflected shader constant metadata. /\nexport class Tr2EffectConstant extends CjsModel\n{\n\n /* name (BlueSharedString) /\n name = \"\";\n\n /* offset (unsigned) /\n offset = 0;\n\n /* size (unsigned) /\n size = 0;\n\n /* type (Type - enum Type) /\n type = 0;\n\n /* dimension (unsigned) /\n dimension = 0;\n\n /* elements (unsigned) /\n elements = 0;\n\n /* isSRGB (bool) /\n isSRGB = false;\n\n /* isAutoregister (bool) /\n isAutoregister = false;\n\n /\n Build one constant from its Carbon v15 description record.\n \n The record's numeric fields are already the widths Carbon declares, so this\n * is a rename plus the two byte-to-bool conversions; only `name` needs\n * dereferencing, because strings live in the container's arena.\n \n @param {object} record Carbon constant record.\n * @returns {Tr2EffectConstant} Reflected constant.\n /\n static fromCarbonBinary(record)\n {\n if (!isPlainObject(record))\n {\n throw new TypeError(\"Carbon effect constant record must be an object\");\n }\n\n const constant = new this();\n constant.name = recordText(record.name);\n constant.offset = record.offset;\n constant.size = record.size;\n constant.type = record.type;\n constant.dimension = record.dimension;\n constant.elements = record.elements;\n constant.isSRGB = !!record.isSRGB;\n constant.isAutoregister = !!record.isAutoregister;\n return constant;\n }\n\n /\n Emit this constant as a Carbon v15 description record.\n \n @returns {object} Carbon constant record.\n */\n toCarbonBinary()\n {\n return {\n name: toRecordText(this.name),\n offset: this.offset,\n size: this.size,\n type: this.type,\n dimension: this.dimension,\n elements: this.elements,\n isSRGB: this.isSRGB ? 1 : 0,\n isAutoregister: this.isAutoregister ? 1 : 0\n };\n }\n\n static Type = Object.freeze({\n FLOAT: 0,\n INT: 1,\n UINT: 2,\n BOOL: 3,\n OTHER: 4\n });\n\n}\n\n// Declared imperatively rather than with decorators, so this module stays plain\n// ESM that loads from source without a transform, which lets its tests import\n// source instead of build output.\n//\n// Field order matters: it drives GetValues() export order. Statics belong in\n// `methods` here rather than in a decorateMethod() call, which targets the\n// prototype and would register a static as an instance field.\nCjsSchema.define(Tr2EffectConstant, {\n className: \"Tr2EffectConstant\",\n family: \"shader\",\n fields: [\n { name: \"name\", type: { kind: \"string\" } },\n { name: \"offset\", type: { kind: \"uint32\" } },\n { name: \"size\", type: { kind: \"uint32\" } },\n { name: \"type\", enum: { enumType: \"Type\" }, type: { kind: \"int32\" } },\n { name: \"dimension\", type: { kind: \"uint32\" } },\n { name: \"elements\", type: { kind: \"uint32\" } },\n { name: \"isSRGB\", type: { kind: \"boolean\" } },\n { name: \"isAutoregister\", type: { kind: \"boolean\" } }\n ]\n});\n"],"names":["Tr2EffectConstant","CjsModel","name","offset","size","type","dimension","elements","isSRGB","isAutoregister","fromCarbonBinary","record","isPlainObject","TypeError","constant","recordText","toCarbonBinary","toRecordText","Type","Object","freeze","FLOAT","INT","UINT","BOOL","OTHER","CjsSchema","define","className","family","fields","kind","enum","enumType"],"mappings":"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"}

package/dist/resource/shader/reflection/Tr2EffectDescription.js CHANGED Viewed

@@ -1,8 +1,10 @@
 import { CjsSchema, type } from '@carbonenginejs/runtime-utils/schema';
 import { CjsModel } from '@carbonenginejs/runtime-utils/model';
-import { isPlainObject, isArray } from '@carbonenginejs/runtime-utils/is';
+import { isPlainObject } from '@carbonenginejs/runtime-utils/is';
 import { Tr2EffectParameterAnnotation } from './Tr2EffectParameterAnnotation.js';
 import { Tr2EffectTechnique } from './Tr2EffectTechnique.js';
+import { recordText, toRecordText } from './carbonRecordFields.js';
+import { compareUtf8 } from '../../../format/compareUtf8.js';
 // Source: trinity/trinity/Shader/Tr2EffectDescription.h
 // Source: trinity/trinity/Shader/Tr2EffectDescription.cpp
@@ -47,47 +49,50 @@ class Tr2EffectDescription extends CjsModel {
   }
   /**
-   * Build one complete effect description from its portable JSON record.
+   * Build one complete effect description from its Carbon v15 record tree.
    *
-   * @param {object} value Portable effect-description record.
+   * This is the whole body: every technique, and the effect-level annotation
+   * groups keyed by the parameter they annotate. Carbon sorts those keys by
+   * `strcmp` on the way out, and the map preserves whatever order the file used,
+   * so nothing here depends on the ordering being meaningful.
+   *
+   * @param {object} record Carbon effect description record.
    * @returns {Tr2EffectDescription} Reflected description.
    */
-  static fromPortable(value) {
-    if (!isPlainObject(value)) {
-      throw new TypeError("Portable effect description must be an object");
-    }
-    if (!isArray(value.annotations)) {
-      throw new TypeError("Portable effect annotation groups must be an array");
-    }
-    if (!isArray(value.techniques)) {
-      throw new TypeError("Portable effect techniques must be an array");
-    }
-    if (value.annotationGroupCount !== value.annotations.length || value.techniqueCount !== value.techniques.length) {
-      throw new Error("Portable effect description counts disagree with its collections");
+  static fromCarbonBinary(record) {
+    if (!isPlainObject(record)) {
+      throw new TypeError("Carbon effect description record must be an object");
     }
     const effect = new this();
-    effect.annotations = this.readPortableAnnotationGroups(value.annotations);
-    effect.techniques = value.techniques.map(entry => Tr2EffectTechnique.fromPortable(entry));
+    effect.annotations = new Map();
+    for (const group of record.annotations) {
+      const parameterName = recordText(group.name);
+      if (effect.annotations.has(parameterName)) {
+        throw new Error(`Carbon effect annotation group "${parameterName}" is duplicated`);
+      }
+      effect.annotations.set(parameterName, group.annotations.map(entry => Tr2EffectParameterAnnotation.fromCarbonBinary(entry)));
+    }
+    effect.techniques = record.techniques.map(entry => Tr2EffectTechnique.fromCarbonBinary(entry));
     return effect;
   }
-  /** Build parameter-name-indexed annotation groups. */
-  static readPortableAnnotationGroups(values) {
-    const result = new Map();
-    for (const value of values) {
-      if (!isPlainObject(value)) {
-        throw new TypeError("Portable effect annotation group must be an object");
-      }
-      const parameterName = String(value.parameterName ?? "");
-      if (!isArray(value.annotations)) {
-        throw new TypeError(`Portable annotations for parameter "${parameterName}" must be an array`);
-      }
-      if (result.has(parameterName)) {
-        throw new Error(`Portable effect annotation group "${parameterName}" is duplicated`);
-      }
-      result.set(parameterName, value.annotations.map(entry => Tr2EffectParameterAnnotation.fromPortable(entry)));
-    }
-    return result;
+  /**
+   * Emit this description as a Carbon v15 record tree.
+   *
+   * Effect-level annotation groups are sorted by parameter name, and each
+   * group's annotations by their own name, because Carbon sorts both by `strcmp`
+   * before writing.
+   *
+   * @returns {object} Carbon effect description record.
+   */
+  toCarbonBinary() {
+    return {
+      techniques: this.techniques.map(technique => technique.toCarbonBinary()),
+      annotations: Array.from(this.annotations, ([name, annotations]) => ({
+        name: toRecordText(name),
+        annotations: annotations.map(entry => entry.toCarbonBinary()).sort((left, right) => compareUtf8(left.name.value, right.name.value))
+      })).sort((left, right) => compareUtf8(left.name.value, right.name.value))
+    };
   }
 }

package/dist/resource/shader/reflection/Tr2EffectDescription.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Tr2EffectDescription.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectDescription.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\n// Source: trinity/trinity/Shader/Tr2EffectDescription.cpp\nimport { CjsSchema, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport {~~\n isArray,\n~~ isPlainObject\n} from \"@carbonenginejs/runtime-utils/is\";\nimport { Tr2EffectParameterAnnotation } from \"./Tr2EffectParameterAnnotation.js\";\nimport { Tr2EffectTechnique } from \"./Tr2EffectTechnique.js\";\n\n/** Complete device-free effect description for one selected shader body. /\nexport class Tr2EffectDescription extends CjsModel\n{\n\n /* techniques (TrackableStdVector<Tr2EffectTechnique>) /\n techniques = [];\n\n /* annotations (Tr2EffectAnnotationMap) /\n annotations = new Map();\n\n /\n Construct a canonical effect description from JS/JSON model values.\n \n @param {object} values Canonical model values.\n * @param {object} options CjsModel import options.\n * @returns {Tr2EffectDescription} Hydrated description.\n /\n static from(values = {}, options = {})\n {\n let normalized = values;\n let annotations = null;\n if (values && Object.hasOwn(values, \"annotations\"))\n {\n const entries = values.annotations instanceof Map\n ? values.annotations\n : Object.entries(values.annotations ?? {});\n annotations = new Map();\n for (const [ parameterName, records ] of entries)\n {\n if (!Array.isArray(records))\n {\n throw new TypeError(\n `Effect annotations for \"${parameterName}\" must be an array`\n );\n }\n annotations.set(\n String(parameterName),\n records.map(record => record instanceof Tr2EffectParameterAnnotation\n ? record\n : Tr2EffectParameterAnnotation.from(record, options))\n );\n }\n normalized = { ...values, annotations };\n }\n const effect = super.from(normalized, options);\n if (annotations)\n {\n effect.annotations = annotations;\n }\n return effect;\n }\n\n /\n Build one complete effect description from its ~~portable~~ ~~JSON~~ record.\n \n @param {object} ~~value~~ ~~Portable~~ effect-description record.\n * @returns {Tr2EffectDescription} Reflected description.\n /\n static ~~fromPortable~~(~~value~~)\n {\n if (!isPlainObject(~~value~~))\n {\n throw new TypeError(\"~~Portable~~ effect description must be an object\");\n }\n ~~if (!isArray(value.annotations))~~\n ~~{\n throw~~ new ~~TypeError~~(\n ~~\"Portable~~ effect ~~annotation~~ ~~groups~~ ~~must be an array\"\n~~ );\n ~~}\n if~~ (~~!isArray(value~~.~~techniques~~))\n {\n ~~throw~~ ~~new~~ ~~TypeError~~(~~\"Portable effect techniques must be an array\"~~);\n ~~}\n~~ if (~~value~~.~~annotationGroupCount !== value.~~annotations.~~length~~\n ~~\|\| value.techniqueCount !== value.techniques.length)\n~~ {\n throw new Error(\n ~~\"Portable~~ effect ~~description~~ ~~counts~~ ~~disagree with its collections~~\"\n );\n }\n~~\n const~~ effect ~~= new this~~(~~);\~~n ~~effect~~.annotations = ~~this~~.~~readPortableAnnotationGroups~~(\n ~~value.annotations~~\n );\n effect.techniques = ~~value~~.techniques.map(\n entry => Tr2EffectTechnique.~~fromPortable~~(entry)\n );\n return effect;\n }\n\n /* ~~Build~~ ~~parameter-name-indexed~~ ~~annotation~~ ~~groups.~~ */\n static ~~readPortableAnnotationGroups(values)\~~n {\n ~~const~~ ~~result~~ = ~~new~~ ~~Map();\n for~~ ~~(const~~ ~~value~~ of ~~values)\n {\n if~~ ~~(!isPlainObject(value))\n {\n throw~~ ~~new TypeError(~~\n ~~\"Portable~~ ~~effect~~ ~~annotation~~ ~~group~~ ~~must~~ be an ~~object\"\n );\n }\n const~~ ~~parameterName~~ = ~~String(value.parameterName~~ ?? ~~\"\");\~~n if ~~(!isArray(value.annotations))\~~n {\n ~~throw~~ ~~new~~ ~~TypeError(\n `Portable annotations for parameter \"$~~{~~parameterName~~}\" ~~must~~ be an ~~array`\~~n );\n }\n if (~~result~~.~~has~~(~~parameterName~~))\n ~~{\n throw~~ ~~new~~ ~~Error~~(~~\n `Portable~~ ~~effect~~ ~~annotation~~ ~~group~~ ~~\"$~~{~~parameterName}~~\~~" is duplicated`\~~n )~~;\n }\n result.set(\n parameterName~~,\n ~~value.~~annotations.map(\n entry => ~~Tr2EffectParameterAnnotation~~.~~fromPortable~~(~~entry~~)\n )\n );\n }~~\n return result~~;\n }\n\n}\n\n// Declared imperatively rather than with decorators, so this module stays\n// plain ESM that loads from source without a transform. The decorator\n// expressions are reused verbatim, so the registered metadata is identical.\n// Statics belong in `methods`: decorateMethod targets the prototype and\n// would register a static as an instance field.\nCjsSchema.define(Tr2EffectDescription, {\n className: \"Tr2EffectDescription\",\n family: \"shader\",\n fields: {\n techniques: type.list(\"Tr2EffectTechnique\"),\n annotations: type.map(\"Tr2EffectParameterAnnotationMap\")\n }\n});\n"],"names":["Tr2EffectDescription","CjsModel","techniques","annotations","Map","from","values","options","normalized","Object","hasOwn","entries","parameterName","records","Array","isArray","TypeError","set","String","map","record","Tr2EffectParameterAnnotation","effect","~~fromPortable~~","~~value~~","~~isPlainObject~~","~~annotationGroupCount~~","~~length~~","~~techniqueCount~~","Error","~~readPortableAnnotationGroups~~","~~entry~~","~~Tr2EffectTechnique~~","~~result~~","~~has~~","CjsSchema","define","className","family","fields","type","list"],"mappings":"~~;;;;;;~~AAAA;AACA;;~~AAUA~~;AACO,MAAMA,oBAAoB,SAASC,QAAQ,CAClD;AAEE;AACAC,EAAAA,UAAU,GAAG,EAAE;;AAEf;AACAC,EAAAA,WAAW,GAAG,IAAIC,GAAG,EAAE;;AAEvB;AACF;AACA;AACA;AACA;AACA;AACA;EACE,OAAOC,IAAIA,CAACC,MAAM,GAAG,EAAE,EAAEC,OAAO,GAAG,EAAE,EACrC;IACE,IAAIC,UAAU,GAAGF,MAAM;IACvB,IAAIH,WAAW,GAAG,IAAI;IACtB,IAAIG,MAAM,IAAIG,MAAM,CAACC,MAAM,CAACJ,MAAM,EAAE,aAAa,CAAC,EAClD;MACE,MAAMK,OAAO,GAAGL,MAAM,CAACH,WAAW,YAAYC,GAAG,GAC7CE,MAAM,CAACH,WAAW,GAClBM,MAAM,CAACE,OAAO,CAACL,MAAM,CAACH,WAAW,IAAI,EAAE,CAAC;AAC5CA,MAAAA,WAAW,GAAG,IAAIC,GAAG,EAAE;MACvB,KAAK,MAAM,CAAEQ,aAAa,EAAEC,OAAO,CAAE,IAAIF,OAAO,EAChD;AACE,QAAA,IAAI,CAACG,KAAK,CAACC,OAAO,CAACF,OAAO,CAAC,EAC3B;AACE,UAAA,MAAM,IAAIG,SAAS,CACjB,CAAA,wBAAA,EAA2BJ,aAAa,oBAC1C,CAAC;AACH,QAAA;AACAT,QAAAA,WAAW,CAACc,GAAG,CACbC,MAAM,CAACN,aAAa,CAAC,EACrBC,OAAO,CAACM,GAAG,CAACC,MAAM,IAAIA,MAAM,YAAYC,4BAA4B,GAChED,MAAM,GACNC,4BAA4B,CAAChB,IAAI,CAACe,MAAM,EAAEb,OAAO,CAAC,CACxD,CAAC;AACH,MAAA;AACAC,MAAAA,UAAU,GAAG;AAAE,QAAA,GAAGF,MAAM;AAAEH,QAAAA;OAAa;AACzC,IAAA;IACA,MAAMmB,MAAM,GAAG,KAAK,CAACjB,IAAI,CAACG,UAAU,EAAED,OAAO,CAAC;AAC9C,IAAA,IAAIJ,WAAW,EACf;MACEmB,MAAM,CAACnB,WAAW,GAAGA,WAAW;AAClC,IAAA;AACA,IAAA,OAAOmB,MAAM;AACf,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACE,OAAOC,~~YAAYA~~,~~CAACC~~,~~KAAK~~,~~EACzB~~;AACE,IAAA,IAAI,~~CAACC~~,aAAa,~~CAACD~~,~~KAAK~~,CAAC,~~EACzB~~;AACE,MAAA,MAAM,~~IAAIR~~,SAAS,CAAC~~,+CAA+C~~,CAAC;~~AACtE~~,IAAA;~~AACA~~,IAAA,~~IAAI~~,~~CAACD~~,~~OAAO~~,~~CAACS~~,~~KAAK~~,~~CAACrB,WAAW,CAAC,EAC/B~~;~~AACE~~,~~MAAA~~,MAAM,~~IAAIa~~,~~SAAS~~,~~CACjB~~,~~oDACF~~,~~CAAC;AACH~~,~~IAAA~~;~~AACA~~,IAAA,~~IAAI~~,~~CAACD~~,~~OAAO~~,~~CAACS~~,~~KAAK~~,~~CAACtB~~,~~UAAU~~,~~CAAC,EAC9B~~;AACE,MAAA,~~MAAM~~,~~IAAIc~~,~~SAAS~~,~~CAAC~~,~~6CAA6C~~,~~CAAC;AACpE,IAAA;AACA,IAAA,IAAIQ,~~KAAK,CAACE,~~oBAAoB~~,~~KAAKF~~,~~KAAK~~,~~CAACrB,WAAW,CAACwB,~~MAAM,~~IACtDH~~,~~KAAK~~,~~CAACI~~,~~cAAc~~,~~KAAKJ~~,~~KAAK~~,~~CAACtB~~,~~UAAU,CAACyB,MAAM,EACrD~~;AACE,~~MAAA~~,MAAM,~~IAAIE~~,KAAK,CACb,~~kEACF~~,CAAC;AACH,~~IAAA~~;~~AAEA~~,~~IAAA~~,~~MAAMP~~,~~MAAM~~,GAAG,~~IAAI~~,~~IAAI~~,~~EAAE;IACzBA~~,~~MAAM~~,~~CAACnB~~,WAAW,GAAG,~~IAAI~~,~~CAAC2B~~,4BAA4B,~~CACpDN~~,KAAK,~~CAACrB~~,~~WACR~~,CAAC;~~AACDmB~~,IAAAA,MAAM,CAACpB,UAAU,~~GAAGsB~~,~~KAAK~~,~~CAACtB~~,UAAU,CAACiB,GAAG,~~CACtCY~~,KAAK,IAAIC,kBAAkB,~~CAACT~~,~~YAAY~~,~~CAACQ~~,KAAK,~~CAChD~~,CAAC;AACD,IAAA,~~OAAOT~~,MAAM;AACf,EAAA;;~~AAEA~~;~~EACA~~,~~OAAOQ~~,~~4BAA4BA~~,~~CAACxB~~,~~MAAM,EAC1C~~;~~AACE~~,~~IAAA~~,~~MAAM2B~~,~~MAAM~~,~~GAAG~~,~~IAAI7B~~,GAAG,~~EAAE;AACxB~~,~~IAAA~~,~~KAAK~~,~~MAAMoB~~,~~KAAK~~,~~IAAIlB~~,~~MAAM~~,~~EAC1B~~;~~AACE~~,~~MAAA~~,~~IAAI~~,~~CAACmB~~,~~aAAa~~,~~CAACD~~,~~KAAK~~,CAAC,~~EACzB;AACE~~,~~QAAA~~,~~MAAM~~,~~IAAIR~~,~~SAAS~~,~~CACjB~~,~~oDACF~~,~~CAAC;AACH~~,~~MAAA;MACA~~,~~MAAMJ~~,~~aAAa~~,~~GAAGM~~,~~MAAM~~,~~CAACM~~,~~KAAK~~,~~CAACZ~~,~~aAAa,~~IAAI,~~EAAE,~~CAAC;~~AACvD~~,~~MAAA~~,~~IAAI~~,~~CAACG~~,~~OAAO,CAACS,KAAK,CAACrB,~~WAAW,~~CAAC~~,~~EAC/B;AACE~~,~~QAAA~~,~~MAAM~~,~~IAAIa~~,~~SAAS~~,~~CACjB~~,~~CAAA~~,~~oCAAA~~,~~EAAuCJ~~,~~aAAa~~,~~oBACtD~~,CAAC~~;AACH~~,~~MAAA;AACA~~,~~MAAA~~,~~IAAIqB~~,~~MAAM~~,~~CAACC~~,~~GAAG~~,~~CAACtB~~,~~aAAa~~,~~CAAC~~,~~EAC7B;AACE~~,~~QAAA~~,~~MAAM~~,~~IAAIiB~~,KAAK,~~CACb~~,~~CAAA~~,~~kCAAA~~,~~EAAqCjB~~,~~aAAa~~,~~iBACpD~~,CAAC~~;AACH~~,~~MAAA;MACAqB~~,~~MAAM~~,~~CAAChB~~,~~GAAG~~,~~CACRL~~,~~aAAa~~,~~EACbY,~~KAAK,~~CAACrB~~,WAAW,~~CAACgB~~,~~GAAG~~,~~CACnBY~~,KAAK,~~IAAIV~~,~~4BAA4B~~,~~CAACE~~,~~YAAY~~,~~CAACQ~~,KAAK,~~CAC1D,CACF,~~CAAC;AACH,~~IAAA;AACA,IAAA,OAAOE,MAAM;AACf,~~EAAA;~~AAEF~~;;AAEA;AACA;AACA;AACA;AACA;~~AACAE~~,SAAS,CAACC,MAAM,~~CAACpC~~,oBAAoB,EAAE;~~AACrCqC~~,EAAAA,SAAS,EAAE,sBAAsB;AACjCC,EAAAA,MAAM,EAAE,QAAQ;AAChBC,EAAAA,MAAM,EAAE;~~AACNrC~~,IAAAA,UAAU,~~EAAEsC~~,IAAI,CAACC,IAAI,CAAC,oBAAoB,CAAC;~~AAC3CtC~~,IAAAA,WAAW,~~EAAEqC~~,IAAI,~~CAACrB~~,GAAG,CAAC,iCAAiC;AACzD;AACF,CAAC,CAAC;;;;"}
1	+ {"version":3,"file":"Tr2EffectDescription.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectDescription.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\n// Source: trinity/trinity/Shader/Tr2EffectDescription.cpp\nimport { CjsSchema, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { isPlainObject } from \"@carbonenginejs/runtime-utils/is\";\nimport { Tr2EffectParameterAnnotation } from \"./Tr2EffectParameterAnnotation.js\";\nimport { Tr2EffectTechnique } from \"./Tr2EffectTechnique.js\";\nimport { recordText, toRecordText } from \"./carbonRecordFields.js\";\nimport { compareUtf8 } from \"../../../format/compareUtf8.js\";\n\n/** Complete device-free effect description for one selected shader body. /\nexport class Tr2EffectDescription extends CjsModel\n{\n\n /* techniques (TrackableStdVector<Tr2EffectTechnique>) /\n techniques = [];\n\n /* annotations (Tr2EffectAnnotationMap) /\n annotations = new Map();\n\n /\n Construct a canonical effect description from JS/JSON model values.\n \n @param {object} values Canonical model values.\n * @param {object} options CjsModel import options.\n * @returns {Tr2EffectDescription} Hydrated description.\n /\n static from(values = {}, options = {})\n {\n let normalized = values;\n let annotations = null;\n if (values && Object.hasOwn(values, \"annotations\"))\n {\n const entries = values.annotations instanceof Map\n ? values.annotations\n : Object.entries(values.annotations ?? {});\n annotations = new Map();\n for (const [ parameterName, records ] of entries)\n {\n if (!Array.isArray(records))\n {\n throw new TypeError(\n `Effect annotations for \"${parameterName}\" must be an array`\n );\n }\n annotations.set(\n String(parameterName),\n records.map(record => record instanceof Tr2EffectParameterAnnotation\n ? record\n : Tr2EffectParameterAnnotation.from(record, options))\n );\n }\n normalized = { ...values, annotations };\n }\n const effect = super.from(normalized, options);\n if (annotations)\n {\n effect.annotations = annotations;\n }\n return effect;\n }\n\n /\n Build one complete effect description from its Carbon v15 record tree.\n \n This is the whole body: every technique, and the effect-level annotation\n * groups keyed by the parameter they annotate. Carbon sorts those keys by\n * `strcmp` on the way out, and the map preserves whatever order the file used,\n * so nothing here depends on the ordering being meaningful.\n \n @param {object} record Carbon effect description record.\n * @returns {Tr2EffectDescription} Reflected description.\n /\n static fromCarbonBinary(record)\n {\n if (!isPlainObject(record))\n {\n throw new TypeError(\"Carbon effect description record must be an object\");\n }\n\n const effect = new this();\n effect.annotations = new Map();\n for (const group of record.annotations)\n {\n const parameterName = recordText(group.name);\n if (effect.annotations.has(parameterName))\n {\n throw new Error(\n `Carbon effect annotation group \"${parameterName}\" is duplicated`\n );\n }\n effect.annotations.set(\n parameterName,\n group.annotations.map(\n entry => Tr2EffectParameterAnnotation.fromCarbonBinary(entry)\n )\n );\n }\n effect.techniques = record.techniques.map(\n entry => Tr2EffectTechnique.fromCarbonBinary(entry)\n );\n return effect;\n }\n\n\n /\n Emit this description as a Carbon v15 record tree.\n \n Effect-level annotation groups are sorted by parameter name, and each\n * group's annotations by their own name, because Carbon sorts both by `strcmp`\n * before writing.\n \n @returns {object} Carbon effect description record.\n */\n toCarbonBinary()\n {\n return {\n techniques: this.techniques.map(technique => technique.toCarbonBinary()),\n annotations: Array.from(this.annotations, ([ name, annotations ]) => ({\n name: toRecordText(name),\n annotations: annotations\n .map(entry => entry.toCarbonBinary())\n .sort((left, right) => compareUtf8(left.name.value, right.name.value))\n })).sort((left, right) => compareUtf8(left.name.value, right.name.value))\n };\n }\n}\n\n// Declared imperatively rather than with decorators, so this module stays\n// plain ESM that loads from source without a transform. The decorator\n// expressions are reused verbatim, so the registered metadata is identical.\n// Statics belong in `methods`: decorateMethod targets the prototype and\n// would register a static as an instance field.\nCjsSchema.define(Tr2EffectDescription, {\n className: \"Tr2EffectDescription\",\n family: \"shader\",\n fields: {\n techniques: type.list(\"Tr2EffectTechnique\"),\n annotations: type.map(\"Tr2EffectParameterAnnotationMap\")\n }\n});\n"],"names":["Tr2EffectDescription","CjsModel","techniques","annotations","Map","from","values","options","normalized","Object","hasOwn","entries","parameterName","records","Array","isArray","TypeError","set","String","map","record","Tr2EffectParameterAnnotation","effect","fromCarbonBinary","isPlainObject","group","recordText","name","has","Error","entry","Tr2EffectTechnique","toCarbonBinary","technique","toRecordText","sort","left","right","compareUtf8","value","CjsSchema","define","className","family","fields","type","list"],"mappings":"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"}

package/dist/resource/shader/reflection/Tr2EffectLibrary.js CHANGED Viewed

@@ -1,8 +1,9 @@
 import { CjsSchema, impl, type } from '@carbonenginejs/runtime-utils/schema';
 import { CjsModel } from '@carbonenginejs/runtime-utils/model';
-import { isPlainObject, isArray, isUint32 } from '@carbonenginejs/runtime-utils/is';
-import { clonePortableSourceProgram } from '../portable.js';
+import { isPlainObject } from '@carbonenginejs/runtime-utils/is';
+import { copyBytes } from '@carbonenginejs/runtime-utils/bytes';
 import { Tr2EffectStageInput } from './Tr2EffectStageInput.js';
+import { recordText, recordBytes, toRecordText, toRecordBlob } from './carbonRecordFields.js';
 // Source: trinity/trinity/Shader/Tr2EffectDescription.h
@@ -74,36 +75,27 @@ class Tr2EffectLibrary extends CjsModel {
   }
   /**
-   * Build one shader library from its portable JSON reflection record.
+   * Build one raytracing library from its Carbon v15 description record.
    *
-   * @param {object} value Portable library record.
+   * A library carries two `StageData` blocks of its own — a global and a local
+   * input — which are the same block a stage carries, minus the stage wrapper.
+   *
+   * @param {object} record Carbon library record.
    * @returns {Tr2EffectLibrary} Reflected library.
    */
-  static fromPortable(value) {
-    if (!isPlainObject(value)) {
-      throw new TypeError("Portable effect library must be an object");
-    }
-    if (!isArray(value.exports)) {
-      throw new TypeError("Portable effect library exports must be an array");
-    }
-    if (value.exportCount !== value.exports.length) {
-      throw new Error("Portable effect library export count disagrees with its collection");
+  static fromCarbonBinary(record) {
+    if (!isPlainObject(record)) {
+      throw new TypeError("Carbon effect library record must be an object");
     }
     const library = new this();
-    if (!isUint32(value.payloadSize)) {
-      throw new RangeError("Portable effect library payload size must fit uint32");
-    }
-    library.payloadSize = value.payloadSize;
-    library.hitGroupName = String(value.hitGroupName ?? "");
-    library.exports = value.exports.map(entry => {
-      if (!isUint32(entry?.type)) {
-        throw new RangeError("Portable effect library export type must fit uint32");
-      }
-      return {
-        type: entry.type,
-        name: String(entry?.name ?? "")
-      };
-    });
+    library.payloadSize = record.payloadSize;
+    library.hitGroupName = recordText(record.hitGroupName);
+    library.exports = record.exports.map(entry => ({
+      type: entry.type,
+      name: recordText(entry.name)
+    }));
+    // The export type is the only thing that names an entry point; the record
+    // stores a flat list and the named fields are a view onto it.
     for (const entry of library.exports) {
       if (entry.type === 0) library.rayGenName = entry.name;
       if (entry.type === 1) library.missName = entry.name;
@@ -111,11 +103,40 @@ class Tr2EffectLibrary extends CjsModel {
       if (entry.type === 3) library.anyHitName = entry.name;
       if (entry.type === 4) library.intersectionName = entry.name;
     }
-    library.sourceProgram = clonePortableSourceProgram(value.sourceProgram, "library");
-    library.globalInput = Tr2EffectStageInput.fromPortableInput(value.globalInput);
-    library.localInput = Tr2EffectStageInput.fromPortableInput(value.localInput);
+    library.sourceProgram = {
+      kind: "library",
+      bytes: copyBytes(recordBytes(record.shaderData)),
+      shaderSize: record.shaderData.size,
+      // See Tr2EffectStageInput: only a zero-size blob's word is portable.
+      unsetOffset: record.shaderData.size === 0 ? record.shaderData.offset : 0xffffffff
+    };
+    library.globalInput = Tr2EffectStageInput.fromCarbonBinaryInput(record.globalInputs);
+    library.localInput = Tr2EffectStageInput.fromCarbonBinaryInput(record.localInputs);
     return library;
   }
+  /**
+   * Emit this library as a Carbon v15 record.
+   *
+   * `exports` is authoritative; the named entry-point fields are a view onto it
+   * and are not written separately.
+   *
+   * @returns {object} Carbon library record.
+   */
+  toCarbonBinary() {
+    const program = this.sourceProgram ?? {};
+    return {
+      payloadSize: this.payloadSize >>> 0,
+      shaderData: toRecordBlob(program.bytes, program.shaderSize, program.unsetOffset),
+      exports: this.exports.map(entry => ({
+        type: entry.type,
+        name: toRecordText(entry.name)
+      })),
+      hitGroupName: toRecordText(this.hitGroupName),
+      globalInputs: this.globalInput.toCarbonBinaryInput(),
+      localInputs: this.localInput.toCarbonBinaryInput()
+    };
+  }
 }
 // Declared imperatively rather than with decorators, so this module stays