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

package/dist/sof/EveSOF.js

@@ -1,7 +1,7 @@
 import { applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelHelpers.js';
 import { normalizeResourcePath } from '#utils/path';
 import { CjsModel } from '#model';
-import { io, type, carbon, impl, CjsSchema } from '#schema';
+import { edit, type, carbon, impl, CjsSchema } from '#schema';
 import { mat4 } from '#math/mat4';
 import { quat } from '#math/quat';
 import { vec3 } from '#math/vec3';
@@ -125,7 +125,7 @@ class EveSOF extends CjsModel {
     } = _applyDecs2311(this, [type.define({
       className: "EveSOF",
       family: "eve"
-    })], [[[io, io.readwrite, type, type.boolean], 16, "allowFileCaching"], [[io, io.readwrite, type, type.boolean], 16, "alphaCutoutShadowsEnabled"], [[io, io.readwrite, type, type.string], 16, "volumetricTrailPath"], [[io, io.readwrite, type, type.float64], 16, "buildTime"], [[io, io.read, void 0, type.objectRef("EveSOFDataMgr")], 16, "dataMgr"], [[io, io.readwrite, type, type.boolean], 16, "editorMode"], [[carbon, carbon.method, impl, impl.implemented], 18, "LoadData"], [[carbon, carbon.method, impl, impl.implemented], 18, "CreateDna"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetDnaVisibilityGroups"], [[carbon, carbon.method, impl, impl.implemented], 18, "ValidateDNA"], [[carbon, carbon.method, impl, impl.implemented], 18, "Build"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Runtime SOF remains Trinity-free, so Carbon's live EveSpaceObject2 mutation is performed through the caller-supplied model-values contract.")], 18, "BuildChild"], [[impl, impl.custom, void 0, impl.reason("Provides the immutable values form needed to compose a modular graph before optional Trinity hydration.")], 18, "BuildChildValues"], [[carbon, carbon.method, impl, impl.adapted], 18, "PlanLayoutFromDNA"], [[carbon, carbon.method, impl, impl.implemented], 18, "BuildFromDNA"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupExtensionBuild"], [[carbon, carbon.method, impl, impl.implemented], 18, "CreateMesh"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetupShaders"], [[carbon, carbon.method, impl, impl.implemented], 18, "FillMeshAreaVector"], [[carbon, carbon.method, impl, impl.implemented], 18, "GenerateDepthFromAreaVector"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupCustomMask"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupDecalSets"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupImpactEffects"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupEffects"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupChildrenAndAnimations"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupEffectChildren"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupAudio"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupControllers"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupModelCurves"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupInstancedMeshes"], [[carbon, carbon.method, impl, impl.adapted], 18, "CreateInstancedMesh"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupLayout"], [[carbon, carbon.method, impl, impl.adapted], 18, "CreateSharedLayoutAreas"], [[carbon, carbon.method, impl, impl.adapted], 18, "CreateLayoutInstancedMesh"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupBoosters"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupChildBoosters"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupAttachments"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupSpriteSets"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupSpotlightSets"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupPlaneSets"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupSpriteLineSets"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupHazeSets"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupBanners"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupBannerSets"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupLights"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetupLocators"], [[carbon, carbon.method, impl, impl.adapted], 18, "CreateArmorDamageEffect"], [[carbon, carbon.method, impl, impl.adapted], 18, "BuildHullLocalLocatorSets"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetupLocatorSets"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetupTurretMaterialFromFaction"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetupTurretMaterialFromDNA"]], 0, void 0, CjsModel));
+    })], [[[edit, edit.readwrite, type, type.boolean], 16, "allowFileCaching"], [[edit, edit.readwrite, type, type.boolean], 16, "alphaCutoutShadowsEnabled"], [[edit, edit.readwrite, type, type.string], 16, "volumetricTrailPath"], [[edit, edit.readwrite, type, type.float64], 16, "buildTime"], [[edit, edit.read, void 0, type.objectRef("EveSOFDataMgr")], 16, "dataMgr"], [[edit, edit.readwrite, type, type.boolean], 16, "editorMode"], [[carbon, carbon.method, impl, impl.implemented], 18, "LoadData"], [[carbon, carbon.method, impl, impl.implemented], 18, "CreateDna"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetDnaVisibilityGroups"], [[carbon, carbon.method, impl, impl.implemented], 18, "ValidateDNA"], [[carbon, carbon.method, impl, impl.implemented], 18, "Build"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Runtime SOF remains Trinity-free, so Carbon's live EveSpaceObject2 mutation is performed through the caller-supplied model-values contract.")], 18, "BuildChild"], [[impl, impl.custom, void 0, impl.reason("Provides the immutable values form needed to compose a modular graph before optional Trinity hydration.")], 18, "BuildChildValues"], [[carbon, carbon.method, impl, impl.adapted], 18, "PlanLayoutFromDNA"], [[carbon, carbon.method, impl, impl.implemented], 18, "BuildFromDNA"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupExtensionBuild"], [[carbon, carbon.method, impl, impl.implemented], 18, "CreateMesh"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetupShaders"], [[carbon, carbon.method, impl, impl.implemented], 18, "FillMeshAreaVector"], [[carbon, carbon.method, impl, impl.implemented], 18, "GenerateDepthFromAreaVector"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupCustomMask"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupDecalSets"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupImpactEffects"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupEffects"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupChildrenAndAnimations"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupEffectChildren"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupAudio"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupControllers"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupModelCurves"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupInstancedMeshes"], [[carbon, carbon.method, impl, impl.adapted], 18, "CreateInstancedMesh"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupLayout"], [[carbon, carbon.method, impl, impl.adapted], 18, "CreateSharedLayoutAreas"], [[carbon, carbon.method, impl, impl.adapted], 18, "CreateLayoutInstancedMesh"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupBoosters"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupChildBoosters"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupAttachments"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupSpriteSets"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupSpotlightSets"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupPlaneSets"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupSpriteLineSets"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupHazeSets"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupBanners"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupBannerSets"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupLights"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetupLocators"], [[carbon, carbon.method, impl, impl.adapted], 18, "CreateArmorDamageEffect"], [[carbon, carbon.method, impl, impl.adapted], 18, "BuildHullLocalLocatorSets"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetupLocatorSets"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetupTurretMaterialFromFaction"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetupTurretMaterialFromDNA"]], 0, void 0, CjsModel));
   }
   allowFileCaching = (_initProto(this), _init_allowFileCaching(this, true));
 
@@ -269,20 +269,20 @@ class EveSOF extends CjsModel {
     return this;
   }
 
-  /**
-   * Supplies Carbon's synchronous `.red` child-object compatibility boundary.
-   *
-   * The resolver receives `(redFilePath, context)` and returns either null, a
-   * self-describing model-values root, `{ values, target?, implements?, raw? }`,
-   * a local `{ kind, target, fields, raw }` descriptor, or
-   * `{ document, root?, target?, implements?, raw? }` for a legacy complete
-   * compatibility fragment consumed by the internal builder.
-   *
-   * Values fragments require `_type` on every model because the SOF layer does
-   * not import the class library needed to infer an untagged nested model's
-   * schema.
-   * Target is `children` for an EveTransform root or `effectChildren` for an
-   * IEveSpaceObjectChild root.
+  /**
+   * Supplies Carbon's synchronous `.red` child-object compatibility boundary.
+   *
+   * The resolver receives `(redFilePath, context)` and returns either null, a
+   * self-describing model-values root, `{ values, target?, implements?, raw? }`,
+   * a local `{ kind, target, fields, raw }` descriptor, or
+   * `{ document, root?, target?, implements?, raw? }` for a legacy complete
+   * compatibility fragment consumed by the internal builder.
+   *
+   * Values fragments require `_type` on every model because the SOF layer does
+   * not import the class library needed to infer an untagged nested model's
+   * schema.
+   * Target is `children` for an EveTransform root or `effectChildren` for an
+   * IEveSpaceObjectChild root.
    */
   SetChildResourceResolver(resolver) {
     if (resolver !== null && typeof resolver !== "function") {
@@ -362,14 +362,14 @@ class EveSOF extends CjsModel {
     return dna.IsValid() ? dna : null;
   }
 
-  /**
-   * Reports the visibility groups one DNA resolves, without building a graph.
-   *
-   * Visibility groups are how a faction turns hull attachment sets on and off,
-   * so this answers which groups the selected hulls author, which the faction
-   * declares, and therefore which sets a build emits. Carbon keeps only the
-   * FNV1 hashes at runtime (EveSOFDataMgr.cpp:1301-1310) and has no equivalent
-   * query; the names come from the catalog projection.
+  /**
+   * Reports the visibility groups one DNA resolves, without building a graph.
+   *
+   * Visibility groups are how a faction turns hull attachment sets on and off,
+   * so this answers which groups the selected hulls author, which the faction
+   * declares, and therefore which sets a build emits. Carbon keeps only the
+   * FNV1 hashes at runtime (EveSOFDataMgr.cpp:1301-1310) and has no equivalent
+   * query; the names come from the catalog projection.
    */
   GetDnaVisibilityGroups(dnaString) {
     const dna = this.CreateDna(dnaString);
@@ -434,17 +434,17 @@ class EveSOF extends CjsModel {
     return dna !== null && dna.ValidateContent();
   }
 
-  /**
-   * Builds the legacy `carbon.document` compatibility form.
-   * @deprecated Use BuildValues(...).
+  /**
+   * Builds the legacy `carbon.document` compatibility form.
+   * @deprecated Use BuildValues(...).
    */
   Build(hullName, factionName, raceName) {
     return this.BuildFromDNA(`${hullName}:${factionName}:${raceName}`);
   }
 
-  /**
-   * Promise-facing legacy `carbon.document` compatibility form.
-   * @deprecated Use BuildValuesAsync(...).
+  /**
+   * Promise-facing legacy `carbon.document` compatibility form.
+   * @deprecated Use BuildValuesAsync(...).
    */
   BuildAsync(hullName, factionName, raceName, options = {}) {
     return this.BuildFromDNAAsync(`${hullName}:${factionName}:${raceName}`, options);
@@ -467,45 +467,45 @@ class EveSOF extends CjsModel {
     return this.BuildValuesFromDNAAsync(`${hullName}:${factionName}:${raceName}`, options);
   }
 
-  /**
-   * Builds the supported public model-values graph for a DNA string.
-   *
-   * The result is one nested, JSON-serializable root value carrying `_type` on
-   * polymorphic nodes and `_id`/`_ref` only where topology demands shared
-   * identity. There is no node table, `kind`/`fields` record, or `raw` payload.
-   *
-   * **No class registry is required, and none should be passed.** The SOF layer
-   * must remain independent of Trinity classes, and JSON does not need the
-   * classes it names. Building this used to hydrate
-   * a document into live runtime objects and re-export them, which made a
-   * registry mandatory and relocated a Trinity-layer dependency onto every
-   * caller rather than removing it. Anything that takes a registry here is the
-   * round trip growing back.
-   *
-   * Constructing objects is the caller's option, performed on the result:
-   * `RootClass.from(values)` against whatever classes that caller has. The
-   * direction matters — objects are built *from* the values, never in order to
-   * produce them.
-   *
-   * The output is sparse by default: it carries what SOF set, and class
-   * defaults belong to whoever constructs. Pass `populateDefaults: true` to
-   * overlay defaults from the class families the caller has registered with
-   * `CjsSchema`; SOF still does not import those families. The audio emitter is
-   * ordinary declared data, an `AudEmitter` node in
-   * `TriObserverLocal.observer`, so either form is a complete rebuild source.
+  /**
+   * Builds the supported public model-values graph for a DNA string.
+   *
+   * The result is one nested, JSON-serializable root value carrying `_type` on
+   * polymorphic nodes and `_id`/`_ref` only where topology demands shared
+   * identity. There is no node table, `kind`/`fields` record, or `raw` payload.
+   *
+   * **No class registry is required, and none should be passed.** The SOF layer
+   * must remain independent of Trinity classes, and JSON does not need the
+   * classes it names. Building this used to hydrate
+   * a document into live runtime objects and re-export them, which made a
+   * registry mandatory and relocated a Trinity-layer dependency onto every
+   * caller rather than removing it. Anything that takes a registry here is the
+   * round trip growing back.
+   *
+   * Constructing objects is the caller's option, performed on the result:
+   * `RootClass.from(values)` against whatever classes that caller has. The
+   * direction matters — objects are built *from* the values, never in order to
+   * produce them.
+   *
+   * The output is sparse by default: it carries what SOF set, and class
+   * defaults belong to whoever constructs. Pass `populateDefaults: true` to
+   * overlay defaults from the class families the caller has registered with
+   * `CjsSchema`; SOF still does not import those families. The audio emitter is
+   * ordinary declared data, an `AudEmitter` node in
+   * `TriObserverLocal.observer`, so either form is a complete rebuild source.
    */
   BuildValuesFromDNA(dnaString, options = {}) {
     const document = this.BuildFromDNA(dnaString, options);
     return document ? _EveSOF.projectDocumentValues(document, options) : null;
   }
 
-  /**
-   * Builds one modular hull into an existing space-object values graph.
-   *
-   * Carbon mutates a live EveSpaceObject2. The device-free runtime keeps the
-   * same owner-first and boolean contract while composing through its canonical
-   * model-values boundary; a live CjsModel owner is exported, composed, then
-   * populated through SetValues without importing Trinity into SOF.
+  /**
+   * Builds one modular hull into an existing space-object values graph.
+   *
+   * Carbon mutates a live EveSpaceObject2. The device-free runtime keeps the
+   * same owner-first and boolean contract while composing through its canonical
+   * model-values boundary; a live CjsModel owner is exported, composed, then
+   * populated through SetValues without importing Trinity into SOF.
    */
   BuildChild(owner, dnaString, partTag, transform = identityMatrix(), options = {}) {
     const isModel = owner instanceof CjsModel;
@@ -527,9 +527,9 @@ class EveSOF extends CjsModel {
     return true;
   }
 
-  /**
-   * Returns a new space-object values graph with one Carbon modular hull
-   * contribution. Invalid DNA returns null without changing the input graph.
+  /**
+   * Returns a new space-object values graph with one Carbon modular hull
+   * contribution. Invalid DNA returns null without changing the input graph.
    */
   BuildChildValues(ownerValues, dnaString, partTag, transform = identityMatrix(), options = {}) {
     if (!ownerValues || typeof ownerValues !== "object" || Array.isArray(ownerValues)) {
@@ -559,20 +559,20 @@ class EveSOF extends CjsModel {
     return document ? _EveSOF.projectDocumentValues(document, options) : null;
   }
 
-  /**
-   * Canonical pure-data instantiation: the decoded (or raw black) sof catalog
-   * plus a plain list of res file names.
-   *
-   * The catalog is mandatory - a factory without its data is useless. The
-   * file list is the sole build-time resource dependency (resPathInsert
-   * existence); without it every insert lookup reports missing and texture
-   * paths fall back to their base values, with a one-time console warning.
-   * The factory never fetches, never parses index formats, and never touches
-   * the network: callers hand it bytes or data they acquired however they
-   * chose.
-   *
-   * (`Create`, not `from` - CjsModel.from is the schema hydration contract
-   * and keeps its signature.)
+  /**
+   * Canonical pure-data instantiation: the decoded (or raw black) sof catalog
+   * plus a plain list of res file names.
+   *
+   * The catalog is mandatory - a factory without its data is useless. The
+   * file list is the sole build-time resource dependency (resPathInsert
+   * existence); without it every insert lookup reports missing and texture
+   * paths fall back to their base values, with a one-time console warning.
+   * The factory never fetches, never parses index formats, and never touches
+   * the network: callers hand it bytes or data they acquired however they
+   * chose.
+   *
+   * (`Create`, not `from` - CjsModel.from is the schema hydration contract
+   * and keeps its signature.)
    */
   static Create({
     black,
@@ -596,32 +596,32 @@ class EveSOF extends CjsModel {
     return sof;
   }
 
-  /**
-   * Internal structural projection from the builder's `carbon.document`
-   * intermediate to supported plain model values.
-   *
-   * Both forms are JSON describing one graph, so this is a structural rewrite
-   * and nothing more: a node table becomes a tree, `kind` becomes `_type`, and
-   * `{ $ref }` becomes a `{ _ref }` back-reference paired with an `_id` on the
-   * first occurrence. `fields` and `raw` are envelopes, so their contents move
-   * onto the node itself.
-   *
-   * **No class library is imported, by requirement.** The SOF layer must remain
-   * independent of Trinity classes, and sparse JSON never needs the classes it
-   * names. The previous implementation
-   * hydrated the document into live runtime objects and called `GetValues` on
-   * the root, which made a class registry mandatory and pushed a Trinity-layer
-   * dependency onto every caller. Constructing objects to serialize a graph we
-   * already hold is a round trip; building objects from these values is a thing
-   * a caller may choose to do afterwards, with `RootClass.from(values)`.
-   *
-   * The output is therefore sparse unless `options.populateDefaults` is true.
-   * That opt-in runs `CjsSchema.applyDefaults` after the structural projection,
-   * using only class families the caller has already imported and registered.
-   * It does not construct or initialize the authored graph and does not add a
-   * SOF-to-Trinity dependency.
-   *
-   * @internal The document form is not a supported consumer boundary.
+  /**
+   * Internal structural projection from the builder's `carbon.document`
+   * intermediate to supported plain model values.
+   *
+   * Both forms are JSON describing one graph, so this is a structural rewrite
+   * and nothing more: a node table becomes a tree, `kind` becomes `_type`, and
+   * `{ $ref }` becomes a `{ _ref }` back-reference paired with an `_id` on the
+   * first occurrence. `fields` and `raw` are envelopes, so their contents move
+   * onto the node itself.
+   *
+   * **No class library is imported, by requirement.** The SOF layer must remain
+   * independent of Trinity classes, and sparse JSON never needs the classes it
+   * names. The previous implementation
+   * hydrated the document into live runtime objects and called `GetValues` on
+   * the root, which made a class registry mandatory and pushed a Trinity-layer
+   * dependency onto every caller. Constructing objects to serialize a graph we
+   * already hold is a round trip; building objects from these values is a thing
+   * a caller may choose to do afterwards, with `RootClass.from(values)`.
+   *
+   * The output is therefore sparse unless `options.populateDefaults` is true.
+   * That opt-in runs `CjsSchema.applyDefaults` after the structural projection,
+   * using only class families the caller has already imported and registered.
+   * It does not construct or initialize the authored graph and does not add a
+   * SOF-to-Trinity dependency.
+   *
+   * @internal The document form is not a supported consumer boundary.
    */
   static projectDocumentValues(document, options = {}) {
     const normalized = CjsCarbonDocument.normalize(document);
@@ -646,18 +646,18 @@ class EveSOF extends CjsModel {
     return populateDefaults ? CjsSchema.applyDefaults(values) : values;
   }
 
-  /**
-   * Deprecated async `carbon.document` assembly used internally by
-   * `BuildValuesFromDNAAsync`.
-   *
-   * Resolve selected child/object dependencies without converting the
-   * deterministic synchronous builder into an async state machine.
-   *
-   * A collection build records only dependencies selected by the normal SOF
-   * filters. They are fetched concurrently, then the unchanged builder runs a
-   * second time against synchronous per-call caches.
-   *
-   * @deprecated Use BuildValuesFromDNAAsync(...).
+  /**
+   * Deprecated async `carbon.document` assembly used internally by
+   * `BuildValuesFromDNAAsync`.
+   *
+   * Resolve selected child/object dependencies without converting the
+   * deterministic synchronous builder into an async state machine.
+   *
+   * A collection build records only dependencies selected by the normal SOF
+   * filters. They are fetched concurrently, then the unchanged builder runs a
+   * second time against synchronous per-call caches.
+   *
+   * @deprecated Use BuildValuesFromDNAAsync(...).
    */
   async BuildFromDNAAsync(dnaString, options = {}) {
     if (this.#sofLibraryBuilder) {
@@ -739,13 +739,13 @@ class EveSOF extends CjsModel {
     return dna ? planSofLayouts(dna, options ?? {}) : null;
   }
 
-  /**
-   * Emits the deprecated internal `carbon.document` assembly form, including
-   * deterministic layouts. `BuildValuesFromDNA` currently projects this
-   * intermediate to the supported output. Layout options may be passed
-   * directly or under an `options.layout` object.
-   *
-   * @deprecated Use BuildValuesFromDNA(...).
+  /**
+   * Emits the deprecated internal `carbon.document` assembly form, including
+   * deterministic layouts. `BuildValuesFromDNA` currently projects this
+   * intermediate to the supported output. Layout options may be passed
+   * directly or under an `options.layout` object.
+   *
+   * @deprecated Use BuildValuesFromDNA(...).
    */
   BuildFromDNA(dnaString, options = {}) {
     this.#buildDiagnostics = [];
@@ -1380,10 +1380,10 @@ class EveSOF extends CjsModel {
     }
   }
 
-  /**
-   * Normalizes a child resource into an embeddable descriptor, preserving
-   * resolver-free builds as EveChildRef nodes and rejecting roots outside
-   * Carbon's child interfaces.
+  /**
+   * Normalizes a child resource into an embeddable descriptor, preserving
+   * resolver-free builds as EveChildRef nodes and rejecting roots outside
+   * Carbon's child interfaces.
    */
   #resolveChildResource(redFilePath, child, sof6) {
     // Without a resolver the build stays complete AS DATA through Carbon's
@@ -1486,9 +1486,9 @@ class EveSOF extends CjsModel {
     };
   }
 
-  /**
-   * Composes child placement, imports or allocates the resolved node, and
-   * appends its reference to the selected owner list.
+  /**
+   * Composes child placement, imports or allocates the resolved node, and
+   * appends its reference to the selected owner list.
    */
   #addResolvedChild(document, objectFields, childOwnerFields, descriptor, child, offset) {
     const placement = composeChildPlacement(child, offset);
@@ -2035,14 +2035,14 @@ class EveSOF extends CjsModel {
     return rootFields.boosters;
   }
 
-  /**
-   * Emits the child-graph booster set into a placement container (Carbon
-   * EveSOF::SetupChildBoosters, EveSOF.cpp:3049-3132): per-hull
-   * driveName/effectPath/parameter/texture overrides with the
-   * EveChildBoosterSet defaults as fallback, the LOD effect pair, one glow
-   * sprite set, and every hull's items with the cumulative multi-hull
-   * offset. Quad-renderer registration and PrepareResources are engine
-   * realizations; the booster set node carries everything else.
+  /**
+   * Emits the child-graph booster set into a placement container (Carbon
+   * EveSOF::SetupChildBoosters, EveSOF.cpp:3049-3132): per-hull
+   * driveName/effectPath/parameter/texture overrides with the
+   * EveChildBoosterSet defaults as fallback, the LOD effect pair, one glow
+   * sprite set, and every hull's items with the cumulative multi-hull
+   * offset. Quad-renderer registration and PrepareResources are engine
+   * realizations; the booster set node carries everything else.
    */
   SetupChildBoosters(document, placementFields, dna) {
     if (dna.GetHullBoosterCount() === 0) return null;
@@ -2121,9 +2121,9 @@ class EveSOF extends CjsModel {
     return ref;
   }
 
-  /**
-   * Normalizes a controller or model-curve resource, retaining resolver-free
-   * references and enforcing the Carbon interface required by its role.
+  /**
+   * Normalizes a controller or model-curve resource, retaining resolver-free
+   * references and enforcing the Carbon interface required by its role.
    */
   #resolveObjectResource(path, role) {
     if (!this.#objectResourceResolver) {
@@ -2233,9 +2233,9 @@ class EveSOF extends CjsModel {
     };
   }
 
-  /**
-   * Imports a resolved values or document root into the builder, or allocates a
-   * standalone node, then overlays any raw fields.
+  /**
+   * Imports a resolved values or document root into the builder, or allocates a
+   * standalone node, then overlays any raw fields.
    */
   #addObjectResource(document, descriptor) {
     if (!descriptor.fragment && !descriptor.values) {
@@ -3008,10 +3008,10 @@ class EveSOF extends CjsModel {
     }
   }
 
-  /**
-   * Builds the armour-damage shader effect node, or null when the DNA lacks
-   * damage data (Carbon EveSOF.cpp:2579-2603 CreateArmorDamageEffect; the
-   * ArmorDamageEffectCache keyed on race+animated is a performance follow-up).
+  /**
+   * Builds the armour-damage shader effect node, or null when the DNA lacks
+   * damage data (Carbon EveSOF.cpp:2579-2603 CreateArmorDamageEffect; the
+   * ArmorDamageEffectCache keyed on race+animated is a performance follow-up).
    */
   CreateArmorDamageEffect(document, dna) {
     const damage = dna.GetGenericDamageData();
@@ -3025,13 +3025,13 @@ class EveSOF extends CjsModel {
     });
   }
 
-  /**
-   * Emits the hull's locator sets UNTRANSFORMED - only the multi-hull offset
-   * applied - for a placement child to own, so the object merges them at
-   * runtime through the child's live transform and skeleton (Carbon
-   * EveSOF.cpp:3384-3432 BuildHullLocalLocatorSets). Same-name sets across
-   * hulls merge into one node; bone indices stay authored because they
-   * address the CHILD's skeleton.
+  /**
+   * Emits the hull's locator sets UNTRANSFORMED - only the multi-hull offset
+   * applied - for a placement child to own, so the object merges them at
+   * runtime through the child's live transform and skeleton (Carbon
+   * EveSOF.cpp:3384-3432 BuildHullLocalLocatorSets). Same-name sets across
+   * hulls merge into one node; bone indices stay authored because they
+   * address the CHILD's skeleton.
    */
   BuildHullLocalLocatorSets(document, dna) {
     const bySetName = new Map();
@@ -3097,9 +3097,9 @@ class EveSOF extends CjsModel {
     }
   }
 
-  /**
-   * Overwrites turret shader constants or vector parameters with the
-   * primary-area material selected by a faction catalog entry.
+  /**
+   * Overwrites turret shader constants or vector parameters with the
+   * primary-area material selected by a faction catalog entry.
    */
   SetupTurretMaterialFromFaction(turretSet, factionName) {
     const factionData = this.dataMgr.GetFactionData(factionName);
@@ -3108,9 +3108,9 @@ class EveSOF extends CjsModel {
     turretSet.ApplySofTurretMaterial(parameterName => findTurretFactionParameter(this.dataMgr, genericData, factionData, parameterName));
   }
 
-  /**
-   * Parses the parent DNA and applies its faction turret values to matching
-   * shader constants or vector parameters.
+  /**
+   * Parses the parent DNA and applies its faction turret values to matching
+   * shader constants or vector parameters.
    */
   SetupTurretMaterialFromDNA(turretSet, dnaString) {
     const dna = this.CreateDna(dnaString);
@@ -4077,12 +4077,12 @@ function createImpactEmitter(document, values) {
   });
 }
 
-/**
- * Counts how many times each node is reached from a starting reference.
- *
- * Recursion stops at a node already seen, so a cycle terminates and every node
- * on it still records more than one visit — which is exactly the condition for
- * giving it an identity.
+/**
+ * Counts how many times each node is reached from a starting reference.
+ *
+ * Recursion stops at a node already seen, so a cycle terminates and every node
+ * on it still records more than one visit — which is exactly the condition for
+ * giving it an identity.
  */
 function CountDocumentVisits(value, nodeById, visits) {
   if (value?.[VALUES_LITERAL_DOLLAR_REF]) {
@@ -4109,13 +4109,13 @@ function CountDocumentVisits(value, nodeById, visits) {
   }
 }
 
-/**
- * Rewrites one document value into its plain-values form.
- *
- * `emitted` maps a node id to the `_id` it was given on first emission, so a
- * later occurrence becomes `{ _ref }`. Ids are allocated in emission order
- * rather than reusing document ids, so the output does not carry the node
- * table's numbering as a hidden dependency.
+/**
+ * Rewrites one document value into its plain-values form.
+ *
+ * `emitted` maps a node id to the `_id` it was given on first emission, so a
+ * later occurrence becomes `{ _ref }`. Ids are allocated in emission order
+ * rather than reusing document ids, so the output does not carry the node
+ * table's numbering as a hidden dependency.
  */
 function ProjectDocumentNode(value, nodeById, visits, emitted, state) {
   if (value?.[VALUES_LITERAL_DOLLAR_REF]) {