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

package/dist/trinity/core/mesh/Tr2RuntimeInstanceData.js

@@ -1,23 +1,22 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
 import { vec3 } from '#math/vec3';
 import { CjsModel } from '#model';
-import { io, type, carbon, impl } from '#schema';
+import { edit, type, carbon, impl } from '#schema';
 import { Tr2ParticleElementDeclaration as _Tr2ParticleElementDe } from '../../particle/element/Tr2ParticleElementDeclaration.js';
 import { Tr2VertexUsageCode } from '../vertex/usageCode.js';
 import { ITr2InstanceDataInstanceData as _ITr2InstanceDataInst } from './ITr2InstanceData/ITr2InstanceDataInstanceData.js';
-import { withITr2InstanceData } from './ITr2InstanceData/ITr2InstanceData.js';
+import { ITr2InstanceData } from './ITr2InstanceData/ITr2InstanceData.js';
 
-var _withITr2InstanceData;
 let _initProto, _initClass, _init_name, _init_extra_name, _init_particleSystem, _init_extra_particleSystem, _init_layout, _init_extra_layout, _init_rows, _init_extra_rows, _init_explicitBoundingBox, _init_extra_explicitBoundingBox, _init_count, _init_extra_count, _init_aabbMin, _init_extra_aabbMin, _init_aabbMax, _init_extra_aabbMax;
 
-/**
- * Owns a CPU-side instance stream - a vertex element layout, the packed
- * per-instance rows and their bounding box - and can spawn the same rows into a
- * particle system on demand.
+/**
+ * Owns a CPU-side instance stream - a vertex element layout, the packed
+ * per-instance rows and their bounding box - and can spawn the same rows into a
+ * particle system on demand.
  */
 let _Tr2RuntimeInstanceDa;
 new class extends _identity {
-  static [class Tr2RuntimeInstanceData extends (_withITr2InstanceData = withITr2InstanceData(CjsModel)) {
+  static [class Tr2RuntimeInstanceData extends CjsModel {
     static {
       ({
         e: [_init_name, _init_extra_name, _init_particleSystem, _init_extra_particleSystem, _init_layout, _init_extra_layout, _init_rows, _init_extra_rows, _init_explicitBoundingBox, _init_extra_explicitBoundingBox, _init_count, _init_extra_count, _init_aabbMin, _init_extra_aabbMin, _init_aabbMax, _init_extra_aabbMax, _initProto],
@@ -25,7 +24,7 @@ new class extends _identity {
       } = _applyDecs2311(this, [type.define({
         className: "Tr2RuntimeInstanceData",
         family: "trinityCore"
-      })], [[[io, io.persist, type, type.string], 16, "name"], [[io, io.persist, void 0, type.objectRef("Tr2ParticleSystem")], 16, "particleSystem"], [[void 0, io.flag("cpuData"), void 0, io.rebuild("instanceBuffer"), io, io.notify, io, io.persist, void 0, type.array("unknown")], 16, "layout"], [[void 0, io.flag("cpuData"), void 0, io.rebuild("instanceBuffer"), io, io.notify, io, io.persist, void 0, type.array("unknown")], 16, "rows"], [[io, io.persist, type, type.boolean], 16, "explicitBoundingBox"], [[io, io.read, type, type.uint32], 16, "count"], [[io, io.persist, type, type.vec3], 16, "aabbMin"], [[io, io.persist, type, type.vec3], 16, "aabbMax"], [[carbon, carbon.method, impl, impl.adapted], 18, "Initialize"], [[carbon, carbon.method, impl, impl.adapted], 18, "OnModified"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetElementLayout"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetItem"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetItem"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetItemElement"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetItemElement"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateData"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateBoundingBox"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetBoundingBox"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingBox"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetInstanceBufferBoundingBox"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetCount"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetStride"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLayout"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetData"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Physical vertex-declaration and buffer readiness belongs to the engine; Trinity reports published CPU layout/bytes.")], 18, "IsInstanceDataReady"], [[impl, impl.adapted, void 0, impl.reason("The CPU ArrayBuffer replaces Carbon's realized Tr2BufferAL; the selected engine uploads or aliases it.")], 18, "GetInstanceData"], [[impl, impl.adapted, void 0, impl.reason("The normalized layout replaces Carbon's engine-owned numeric vertex-declaration handle.")], 18, "GetInstanceBufferVertexDeclaration"], [[carbon, carbon.method, impl, impl.adapted], 18, "DestroyData"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Maps Carbon vertex semantics into the maintained CPU particle-system declaration without GPU buffers.")], 18, "Spawn"], [[carbon, carbon.method, impl, impl.implemented], 18, "Update"], [[carbon, carbon.method, impl, impl.implemented], 18, "SpawnParticles"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetThreadSafeFlag"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "SaveToCMF"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "SaveToGranny"]], 0, void 0, _withITr2InstanceData));
+      }), carbon.inherit(ITr2InstanceData)], [[[edit, edit.persist, type, type.string], 16, "name"], [[edit, edit.persist, void 0, type.objectRef("Tr2ParticleSystem")], 16, "particleSystem"], [[edit, edit.notify, edit, edit.persist, void 0, type.array("unknown")], 16, "layout"], [[edit, edit.notify, edit, edit.persist, void 0, type.array("unknown")], 16, "rows"], [[edit, edit.persist, type, type.boolean], 16, "explicitBoundingBox"], [[edit, edit.read, type, type.uint32], 16, "count"], [[edit, edit.persist, type, type.vec3], 16, "aabbMin"], [[edit, edit.persist, type, type.vec3], 16, "aabbMax"], [[carbon, carbon.method, impl, impl.adapted], 18, "Initialize"], [[impl, impl.custom, void 0, impl.reason("JS persists layout and rows, unlike Carbon; edits repack CPU data while UpdateData owns GPU publication."), void 0, impl.invalidates("#dirty")], 18, "OnModified"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.invalidates("#dirty")], 18, "SetElementLayout"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.invalidates("#dirty")], 18, "SetData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetItem"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.invalidates("#dirty")], 18, "SetItem"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetItemElement"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.invalidates("#dirty")], 18, "SetItemElement"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateData"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateBoundingBox"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetBoundingBox"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingBox"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetInstanceBufferBoundingBox"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetCount"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetStride"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLayout"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetData"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Physical vertex-declaration and buffer readiness belongs to the engine; Trinity reports published CPU layout/bytes.")], 18, "IsInstanceDataReady"], [[impl, impl.adapted, void 0, impl.reason("The CPU ArrayBuffer replaces Carbon's realized Tr2BufferAL; the selected engine uploads or aliases it.")], 18, "GetInstanceData"], [[impl, impl.adapted, void 0, impl.reason("The normalized layout replaces Carbon's engine-owned numeric vertex-declaration handle.")], 18, "GetInstanceBufferVertexDeclaration"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.invalidates("#dirty")], 18, "DestroyData"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Maps Carbon vertex semantics into the maintained CPU particle-system declaration without GPU buffers.")], 18, "Spawn"], [[carbon, carbon.method, impl, impl.implemented], 18, "Update"], [[carbon, carbon.method, impl, impl.implemented], 18, "SpawnParticles"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetThreadSafeFlag"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "SaveToCMF"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "SaveToGranny"]], 0, void 0, CjsModel));
     }
     name = (_initProto(this), _init_name(this, ""));
     particleSystem = (_init_extra_name(this), _init_particleSystem(this, null));
@@ -36,6 +35,7 @@ new class extends _identity {
     // The JS port persists the whole quintet so instance data authored in JS can
     // round-trip without Carbon's Python/CMF side channels. Carbon-authored
     // .black files never populate these fields.
+
     layout = (_init_extra_particleSystem(this), _init_layout(this, []));
     rows = (_init_extra_layout(this), _init_rows(this, []));
     explicitBoundingBox = (_init_extra_rows(this), _init_explicitBoundingBox(this, false));
@@ -54,17 +54,17 @@ new class extends _identity {
       return this.#dirty;
     }
 
-    /**
-     * Counter bumped by every UpdateData that publishes a dirty change; consumers
-     * compare it to detect that the packed bytes were republished.
+    /**
+     * Counter bumped by every UpdateData that publishes a dirty change; consumers
+     * compare it to detect that the packed bytes were republished.
      */
     get dataRevision() {
       return this.#dataRevision;
     }
 
-    /**
-     * Repacks the CPU buffer from the persisted layout and rows, then publishes
-     * it.
+    /**
+     * Repacks the CPU buffer from the persisted layout and rows, then publishes
+     * it.
      */
     Initialize() {
       this.#rebuildCpuData();
@@ -72,46 +72,45 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Repacks the CPU buffer only when the cpuData flag was scheduled, i.e. layout
-     * or rows actually changed.
+    /**
+     * Repacks persisted JS layout/rows; GPU publication remains explicit.
      */
-    OnModified(_options = {}) {
-      if (this.__state.flags.delete("cpuData")) {
+    OnModified(propertyName) {
+      if (propertyName === "layout" || propertyName === "rows") {
         this.#rebuildCpuData();
       }
       return true;
     }
 
-    /**
-     * Replaces the element layout and discards every existing row - a layout must
-     * be set before any SetData.
+    /**
+     * Replaces the element layout and discards every existing row - a layout must
+     * be set before any SetData.
      */
     SetElementLayout(layout) {
       this.#setElementLayout(layout);
       this.DestroyData();
     }
 
-    /**
-     * Replaces all instance rows and repacks the byte buffer; throws when no
-     * layout has been set.
+    /**
+     * Replaces all instance rows and repacks the byte buffer; throws when no
+     * layout has been set.
      */
     SetData(rows) {
       this.#setData(rows);
     }
 
-    /**
-     * A detached copy of one instance row, with its component arrays cloned so the
-     * caller cannot alias stored data.
+    /**
+     * A detached copy of one instance row, with its component arrays cloned so the
+     * caller cannot alias stored data.
      */
     GetItem(index) {
       this.#assertItemIndex(index);
       return this.rows[index].map(_Tr2RuntimeInstanceDa.#cloneValue);
     }
 
-    /**
-     * Validates one instance row against the layout, stores it and rewrites its
-     * bytes in place, marking the data dirty.
+    /**
+     * Validates one instance row against the layout, stores it and rewrites its
+     * bytes in place, marking the data dirty.
      */
     SetItem(index, row) {
       this.#assertItemIndex(index);
@@ -128,9 +127,9 @@ new class extends _identity {
       return _Tr2RuntimeInstanceDa.#cloneValue(this.rows[index][elementIndex]);
     }
 
-    /**
-     * Validates and stores a single element of one row, patching only that
-     * element's bytes in the packed buffer.
+    /**
+     * Validates and stores a single element of one row, patching only that
+     * element's bytes in the packed buffer.
      */
     SetItemElement(index, elementIndex, value) {
       this.#assertItemIndex(index);
@@ -141,9 +140,9 @@ new class extends _identity {
       this.#dirty = true;
     }
 
-    /**
-     * Publishes pending changes by clearing the dirty flag and bumping the data
-     * revision; returns false when nothing was dirty.
+    /**
+     * Publishes pending changes by clearing the dirty flag and bumping the data
+     * revision; returns false when nothing was dirty.
      */
     UpdateData() {
       if (!this.#dirty) {
@@ -154,11 +153,11 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Recomputes the box from the first POSITION element with at least three
-     * components; returns false without touching it when the box was set
-     * explicitly, and zeroes the box when there is no such element or no
-     * instances.
+    /**
+     * Recomputes the box from the first POSITION element with at least three
+     * components; returns false without touching it when the box was set
+     * explicitly, and zeroes the box when there is no such element or no
+     * instances.
      */
     UpdateBoundingBox() {
       if (this.explicitBoundingBox) {
@@ -183,9 +182,9 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Sets the box explicitly from either a { min, max } object or two vectors,
-     * and latches explicitBoundingBox so UpdateBoundingBox stops recomputing it.
+    /**
+     * Sets the box explicitly from either a { min, max } object or two vectors,
+     * and latches explicitBoundingBox so UpdateBoundingBox stops recomputing it.
      */
     SetBoundingBox(bounds, maxBounds) {
       const min = maxBounds === undefined ? bounds?.min ?? bounds?.minBounds : bounds;
@@ -198,11 +197,11 @@ new class extends _identity {
       this.explicitBoundingBox = true;
     }
 
-    /**
-     * Reads the bounding box; the values are copied into the caller's vectors when both are supplied, otherwise a freshly cloned pair is returned.
-     * @param {vec3} [minBounds] Caller-owned destination for the minimum.
-     * @param {vec3} [maxBounds] Caller-owned destination for the maximum.
-     * @returns {boolean|{min: vec3, max: vec3}} True when written into the out vectors, otherwise a new { min, max } pair.
+    /**
+     * Reads the bounding box; the values are copied into the caller's vectors when both are supplied, otherwise a freshly cloned pair is returned.
+     * @param {vec3} [minBounds] Caller-owned destination for the minimum.
+     * @param {vec3} [maxBounds] Caller-owned destination for the maximum.
+     * @returns {boolean|{min: vec3, max: vec3}} True when written into the out vectors, otherwise a new { min, max } pair.
      */
     GetBoundingBox(minBounds, maxBounds) {
       if (minBounds && maxBounds) {
@@ -216,9 +215,9 @@ new class extends _identity {
       };
     }
 
-    /**
-     * The bounding box of the single CPU instance buffer; the buffer index is
-     * ignored because only one stream exists.
+    /**
+     * The bounding box of the single CPU instance buffer; the buffer index is
+     * ignored because only one stream exists.
      */
     GetInstanceBufferBoundingBox(_bufferIndex = 0) {
       return this.GetBoundingBox();
@@ -234,35 +233,35 @@ new class extends _identity {
       return this.#stride;
     }
 
-    /**
-     * The frozen normalized element descriptors, each carrying usage, type,
-     * component count, byte size and byte offset.
+    /**
+     * The frozen normalized element descriptors, each carrying usage, type,
+     * component count, byte size and byte offset.
      */
     GetLayout() {
       return this.#layout;
     }
 
-    /**
-     * A copy of the packed instance bytes, or null when no rows are set; the
-     * caller owns the returned array.
+    /**
+     * A copy of the packed instance bytes, or null when no rows are set; the
+     * caller owns the returned array.
      */
     GetData() {
       return this.#data ? new Uint8Array(this.#data) : null;
     }
 
-    /**
-     * CPU readiness for the nominal ITr2InstanceData contract. Carbon also tests
-     * the realized vertex declaration and GPU buffer; those are engine-owned in
-     * CarbonEngineJS, so Trinity reports whether a published layout and byte
-     * payload are available for realization.
+    /**
+     * CPU readiness for the nominal ITr2InstanceData contract. Carbon also tests
+     * the realized vertex declaration and GPU buffer; those are not ported yet in
+     * CarbonEngineJS, so Trinity reports whether a published layout and byte
+     * payload are available for realization.
      */
     IsInstanceDataReady() {
       return this.#layout.length > 0 && this.#data !== null && !this.#dirty;
     }
 
-    /**
-     * Returns the published CPU byte buffer and its row geometry. The buffer is
-     * borrowed, matching Carbon's borrowed AL buffer reference.
+    /**
+     * Returns the published CPU byte buffer and its row geometry. The buffer is
+     * borrowed, matching Carbon's borrowed AL buffer reference.
      */
     GetInstanceData(_bufferIndex = 0, _screenSize = 0) {
       this.#instanceData.buffer = this.#data;
@@ -277,9 +276,9 @@ new class extends _identity {
       return this.#layout;
     }
 
-    /**
-     * Drops every row and the packed buffer while keeping the layout, and marks
-     * the data dirty.
+    /**
+     * Drops every row and the packed buffer while keeping the layout, and marks
+     * the data dirty.
      */
     DestroyData() {
       this.rows = [];
@@ -288,9 +287,9 @@ new class extends _identity {
       this.#dirty = true;
     }
 
-    /**
-     * Replaces the target particle system with particles decoded from the CPU
-     * instance rows.
+    /**
+     * Replaces the target particle system with particles decoded from the CPU
+     * instance rows.
      */
     Spawn() {
       const particleSystem = this.particleSystem;
@@ -331,21 +330,21 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Implements ITr2GenericEmitter. Does nothing as this emitter only emits
-     * particles on demand (Spawn).
+    /**
+     * Implements ITr2GenericEmitter. Does nothing as this emitter only emits
+     * particles on demand (Spawn).
      */
     Update(_arguments) {}
 
-    /**
-     * Implements ITr2GenericEmitter. Does nothing as this emitter only emits
-     * particles on demand (Spawn); both Carbon overloads are deliberate no-ops.
+    /**
+     * Implements ITr2GenericEmitter. Does nothing as this emitter only emits
+     * particles on demand (Spawn); both Carbon overloads are deliberate no-ops.
      */
     SpawnParticles(..._args) {}
 
-    /**
-     * Implements ITr2GenericEmitter. Nothing to prepare - this emitter never
-     * spawns from the threaded particle update.
+    /**
+     * Implements ITr2GenericEmitter. Nothing to prepare - this emitter never
+     * spawns from the threaded particle update.
      */
     SetThreadSafeFlag() {}
 
@@ -359,12 +358,12 @@ new class extends _identity {
       throw new Error("Tr2RuntimeInstanceData.SaveToGranny is not implemented in CarbonEngineJS.");
     }
 
-    /**
-     * Builds Carbon's common current/previous-transform instance stream without
-     * creating renderer or GPU resources.
-     *
-     * @param {Array<object|ArrayLike<number>>} instances
-     * @returns {number} Maximum instance scale.
+    /**
+     * Builds Carbon's common current/previous-transform instance stream without
+     * creating renderer or GPU resources.
+     *
+     * @param {Array<object|ArrayLike<number>>} instances
+     * @returns {number} Maximum instance scale.
      */
     SetTransformInstances(instances) {
       if (!Array.isArray(instances)) {
@@ -402,9 +401,9 @@ new class extends _identity {
       return maxScale;
     }
 
-    /**
-     * Re-normalizes the persisted layout and repacks the persisted rows; throws
-     * when rows exist but the layout is empty.
+    /**
+     * Re-normalizes the persisted layout and repacks the persisted rows; throws
+     * when rows exist but the layout is empty.
      */
     #rebuildCpuData() {
       const rows = this.rows;
@@ -422,9 +421,9 @@ new class extends _identity {
       this.#setData(rows);
     }
 
-    /**
-     * Normalizes each element descriptor, assigns sequential byte offsets,
-     * computes the row stride and republishes the persisted layout summary.
+    /**
+     * Normalizes each element descriptor, assigns sequential byte offsets,
+     * computes the row stride and republishes the persisted layout summary.
      */
     #setElementLayout(layout) {
       if (!Array.isArray(layout)) {
@@ -441,9 +440,9 @@ new class extends _identity {
       this.#stride = offset;
     }
 
-    /**
-     * Normalizes every row against the layout and packs them into one freshly
-     * allocated little-endian buffer.
+    /**
+     * Normalizes every row against the layout and packs them into one freshly
+     * allocated little-endian buffer.
      */
     #setData(rows) {
       if (!this.#layout.length) {
@@ -464,9 +463,9 @@ new class extends _identity {
       this.#dirty = true;
     }
 
-    /**
-     * Coerces a row given either as an array or as a name-keyed object into layout
-     * order and validates each element.
+    /**
+     * Coerces a row given either as an array or as a name-keyed object into layout
+     * order and validates each element.
      */
     #normalizeRow(row, rowIndex) {
       const values = Array.isArray(row) ? row : this.#layout.map(element => row?.[element.name]);
@@ -483,10 +482,10 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Writes one element at its row and layout offset; a scalar supplied for a
-     * four-component INT8/UINT8 element is written as a single packed 32-bit word
-     * (the bone-index case).
+    /**
+     * Writes one element at its row and layout offset; a scalar supplied for a
+     * four-component INT8/UINT8 element is written as a single packed 32-bit word
+     * (the bone-index case).
      */
     #writeElement(view, rowIndex, elementIndex, value) {
       const element = this.#layout[elementIndex];
@@ -507,9 +506,9 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Throws RangeError unless the index is an integer inside the current instance
-     * count.
+    /**
+     * Throws RangeError unless the index is an integer inside the current instance
+     * count.
      */
     #assertItemIndex(index) {
       if (!Number.isInteger(index) || index < 0 || index >= this.count) {
@@ -524,58 +523,58 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Builds a full element descriptor at the given byte offset from either a {
-     * usage, usageIndex, type, name } object or Carbon's legacy [particleUsage,
-     * usageIndex, componentCount] triple.
+    /**
+     * Builds a full element descriptor at the given byte offset from either a {
+     * usage, usageIndex, type, name } object or Carbon's legacy [particleUsage,
+     * usageIndex, componentCount] triple.
      */
 
-    /**
-     * The frozen persistable summary of an element descriptor: usage, usage index,
-     * type and name.
+    /**
+     * The frozen persistable summary of an element descriptor: usage, usage index,
+     * type and name.
      */
 
-    /**
-     * Transposes a column-major 4x4 into the three float4 rows the transform
-     * instance stream stores.
+    /**
+     * Transposes a column-major 4x4 into the three float4 rows the transform
+     * instance stream stores.
      */
 
-    /**
-     * Maps a legacy particle element type index onto its vertex usage name; throws
-     * for an out-of-range index.
+    /**
+     * Maps a legacy particle element type index onto its vertex usage name; throws
+     * for an out-of-range index.
      */
 
-    /**
-     * Resolves a usage given as a name or as a UsageCode number to its canonical
-     * name; throws when it matches neither.
+    /**
+     * Resolves a usage given as a name or as a UsageCode number to its canonical
+     * name; throws when it matches neither.
      */
 
-    /**
-     * Decodes a data type name or code into base type, component count and
-     * component byte size by unpacking Carbon's type bit-field (low three bits the
-     * type, bit 3 unsigned, bits 5-6 the component count minus one).
+    /**
+     * Decodes a data type name or code into base type, component count and
+     * component byte size by unpacking Carbon's type bit-field (low three bits the
+     * type, bit 3 unsigned, bits 5-6 the component count minus one).
      */
 
-    /**
-     * Validates and coerces one element value against its descriptor; a bare
-     * number is accepted for a single-component element and for a packed four-byte
-     * integer element, anything else must supply exactly componentCount finite
-     * numbers.
+    /**
+     * Validates and coerces one element value against its descriptor; a bare
+     * number is accepted for a single-component element and for a packed four-byte
+     * integer element, anything else must supply exactly componentCount finite
+     * numbers.
      */
 
-    /**
-     * Writes one little-endian component of the given base type; FLOAT16 has no
-     * packer and throws.
+    /**
+     * Writes one little-endian component of the given base type; FLOAT16 has no
+     * packer and throws.
      */
 
     /** Copies array-valued elements so returned rows never alias stored data. */
 
-    /**
-     * Shared instanced-transform shader contract. Carbon's
-     * EveChildInstanceMeshRenderer declares TEXCOORD0..6, but that collides with
-     * geometry UVs and disagrees with every other instanced producer and the
-     * measured ubershader inputs. The organization contract therefore uses the
-     * working TEXCOORD8..14 range on stream 1.
+    /**
+     * Shared instanced-transform shader contract. Carbon's
+     * EveChildInstanceMeshRenderer declares TEXCOORD0..6, but that collides with
+     * geometry UVs and disagrees with every other instanced producer and the
+     * measured ubershader inputs. The organization contract therefore uses the
+     * working TEXCOORD8..14 range on stream 1.
      */
   }];
   #normalizeElement(value, index, offset) {