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

package/dist/trinity/eve/spaceObject/IEveSpaceObject2ParentData.js

@@ -1,70 +1,62 @@
-import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
-import { CjsModel } from '#model';
 import { mat4 } from '#math/mat4';
-import { type } from '#schema';
 import { vec3 } from '#math/vec3';
 import { vec4 } from '#math/vec4';
 
-let _initClass, _init_transform, _init_extra_transform, _init_killCount, _init_extra_killCount, _init_shipData, _init_extra_shipData, _init_clipSphereCenter, _init_extra_clipSphereCenter, _init_clipRadiusSq, _init_extra_clipRadiusSq, _init_clipRadius2Sq, _init_extra_clipRadius2Sq, _init_clipFactor, _init_extra_clipFactor, _init_clipFactor2, _init_extra_clipFactor2, _init_customData, _init_extra_customData;
+// Source: trinity/trinity/Eve/IEveSpaceObject2.h (IEveSpaceObject2::ParentData)
+// Hand-maintained. Carbon nests this struct inside the IEveSpaceObject2
+// interface; the JS identity concatenates owner and inner name
+// (IEveSpaceObject2 + ParentData) because a bare inner name is not unique
+// across the corpus - fifteen inner names are claimed by several owners and
+// thirteen collide with a top-level class.
+//
+// A plain class, not a model: it is internal per-frame data, filled by the
+// owner's update pass (GetParentData) and copied member by member by the
+// consumer, exactly as Carbon passes and copies the struct. Nothing hydrates
+// it or edits it from a UI; if something ever needs to, compose values onto
+// it rather than giving it the model base.
 
 /** The per-frame parent state a space object hands to its attachments. */
-let _IEveSpaceObject2Pare;
-new class extends _identity {
-  static [class IEveSpaceObject2ParentData extends CjsModel {
-    static {
-      ({
-        e: [_init_transform, _init_extra_transform, _init_killCount, _init_extra_killCount, _init_shipData, _init_extra_shipData, _init_clipSphereCenter, _init_extra_clipSphereCenter, _init_clipRadiusSq, _init_extra_clipRadiusSq, _init_clipRadius2Sq, _init_extra_clipRadius2Sq, _init_clipFactor, _init_extra_clipFactor, _init_clipFactor2, _init_extra_clipFactor2, _init_customData, _init_extra_customData],
-        c: [_IEveSpaceObject2Pare, _initClass]
-      } = _applyDecs2311(this, [type.define({
-        className: "IEveSpaceObject2ParentData",
-        family: "eve/spaceObject"
-      })], [[[type, type.mat4], 16, "transform"], [[type, type.uint32], 16, "killCount"], [[type, type.vec4], 16, "shipData"], [[type, type.vec3], 16, "clipSphereCenter"], [[type, type.float32], 16, "clipRadiusSq"], [[type, type.float32], 16, "clipRadius2Sq"], [[type, type.float32], 16, "clipFactor"], [[type, type.float32], 16, "clipFactor2"], [[type, type.vec4], 16, "customData"]], 0, void 0, CjsModel));
-    }
-    /** transform (Matrix) - the parent's world transform. */
-    transform = _init_transform(this, mat4.create());
+class IEveSpaceObject2ParentData {
+  /** transform (Matrix) - the parent's world transform. */
+  transform = mat4.create();
 
-    /** killCount (uint32_t) - EveSpaceObject2::GetParentData never assigns it,
-     * so it stays zero through that path (EveSpaceObject2.cpp:1874). */
-    killCount = (_init_extra_transform(this), _init_killCount(this, 0));
+  /** killCount (uint32_t) - EveSpaceObject2::GetParentData never assigns it,
+   * so it stays zero through that path (EveSpaceObject2.cpp:1874). */
+  killCount = 0;
 
-    /** shipData (Vector4) - m_spaceObjectShipData. */
-    shipData = (_init_extra_killCount(this), _init_shipData(this, vec4.create()));
+  /** shipData (Vector4) - m_spaceObjectShipData. */
+  shipData = vec4.create();
 
-    /** clipSphereCenter (Vector3). */
-    clipSphereCenter = (_init_extra_shipData(this), _init_clipSphereCenter(this, vec3.create()));
+  /** clipSphereCenter (Vector3). */
+  clipSphereCenter = vec3.create();
 
-    /** clipRadiusSq (float). */
-    clipRadiusSq = (_init_extra_clipSphereCenter(this), _init_clipRadiusSq(this, 0));
+  /** clipRadiusSq (float). */
+  clipRadiusSq = 0;
 
-    /** clipRadius2Sq (float). */
-    clipRadius2Sq = (_init_extra_clipRadiusSq(this), _init_clipRadius2Sq(this, 0));
+  /** clipRadius2Sq (float). */
+  clipRadius2Sq = 0;
 
-    /** clipFactor (float) - the parent's clipSphereFactor. */
-    clipFactor = (_init_extra_clipRadius2Sq(this), _init_clipFactor(this, 0));
+  /** clipFactor (float) - the parent's clipSphereFactor. */
+  clipFactor = 0;
 
-    /** clipFactor2 (float) - the parent's clipSphereFactor2. */
-    clipFactor2 = (_init_extra_clipFactor(this), _init_clipFactor2(this, 0));
+  /** clipFactor2 (float) - the parent's clipSphereFactor2. */
+  clipFactor2 = 0;
 
-    /** customData (Vector4). */
-    customData = (_init_extra_clipFactor2(this), _init_customData(this, vec4.create()));
+  /** customData (Vector4). */
+  customData = vec4.create();
 
-    /**
-     * shLighting (const Vector4*) - Carbon borrows a pointer to the parent's
-     * seven packed spherical-harmonic coefficients and copies them at fill time,
-     * zeroing when the pointer is null (EveSpaceObjectDecal.cpp:376-383). The
-     * port holds the parent's array by reference with the same null contract; it
-     * is runtime state, so it carries no persistence.
-     */
-    shLighting = (_init_extra_customData(this), null);
+  /**
+   * shLighting (const Vector4*) - Carbon borrows a pointer to the parent's
+   * seven packed spherical-harmonic coefficients and copies them at fill time,
+   * zeroing when the pointer is null (EveSpaceObjectDecal.cpp:376-383). The
+   * port holds the parent's array by reference with the same null contract.
+   */
+  shLighting = null;
 
-    /** Carbon's packed spherical-harmonic coefficient count
-     * (Tr2ShLightingManager::PACKED_COEFFICIENT_COUNT). */
-  }];
-  SH_COEFFICIENT_COUNT = 7;
-  constructor() {
-    super(_IEveSpaceObject2Pare), _initClass();
-  }
-}();
+  /** Carbon's packed spherical-harmonic coefficient count
+   * (Tr2ShLightingManager::PACKED_COEFFICIENT_COUNT). */
+  static SH_COEFFICIENT_COUNT = 7;
+}
 
-export { _IEveSpaceObject2Pare as IEveSpaceObject2ParentData };
+export { IEveSpaceObject2ParentData };
 //# sourceMappingURL=IEveSpaceObject2ParentData.js.map

package/dist/trinity/eve/spaceObject/IEveSpaceObject2ParentData.js.map

@@ -1 +1 @@
-{"version":3,"file":"IEveSpaceObject2ParentData.js","sources":["../../../../../src/trinity/eve/spaceObject/IEveSpaceObject2ParentData.js"],"sourcesContent":["// Source: trinity/trinity/Eve/IEveSpaceObject2.h (IEveSpaceObject2::ParentData)\r\n// Hand-maintained. Carbon nests this struct inside the IEveSpaceObject2\r\n// interface; the JS identity concatenates owner and inner name\r\n// (IEveSpaceObject2 + ParentData) because a bare inner name is not unique\r\n// across the corpus - fifteen inner names are claimed by several owners and\r\n// thirteen collide with a top-level class.\r\nimport { CjsModel } from \"#model\";\r\nimport { mat4 } from \"#math/mat4\";\r\nimport { type } from \"#schema\";\r\nimport { vec3 } from \"#math/vec3\";\r\nimport { vec4 } from \"#math/vec4\";\r\n\r\n\r\n/** The per-frame parent state a space object hands to its attachments. */\r\n@type.define({ className: \"IEveSpaceObject2ParentData\", family: \"eve/spaceObject\" })\r\nexport class IEveSpaceObject2ParentData extends CjsModel\r\n{\r\n\r\n  /** transform (Matrix) - the parent's world transform. */\r\n  @type.mat4\r\n  transform = mat4.create();\r\n\r\n  /** killCount (uint32_t) - EveSpaceObject2::GetParentData never assigns it,\r\n   * so it stays zero through that path (EveSpaceObject2.cpp:1874). */\r\n  @type.uint32\r\n  killCount = 0;\r\n\r\n  /** shipData (Vector4) - m_spaceObjectShipData. */\r\n  @type.vec4\r\n  shipData = vec4.create();\r\n\r\n  /** clipSphereCenter (Vector3). */\r\n  @type.vec3\r\n  clipSphereCenter = vec3.create();\r\n\r\n  /** clipRadiusSq (float). */\r\n  @type.float32\r\n  clipRadiusSq = 0;\r\n\r\n  /** clipRadius2Sq (float). */\r\n  @type.float32\r\n  clipRadius2Sq = 0;\r\n\r\n  /** clipFactor (float) - the parent's clipSphereFactor. */\r\n  @type.float32\r\n  clipFactor = 0;\r\n\r\n  /** clipFactor2 (float) - the parent's clipSphereFactor2. */\r\n  @type.float32\r\n  clipFactor2 = 0;\r\n\r\n  /** customData (Vector4). */\r\n  @type.vec4\r\n  customData = vec4.create();\r\n\r\n  /**\r\n   * shLighting (const Vector4*) - Carbon borrows a pointer to the parent's\r\n   * seven packed spherical-harmonic coefficients and copies them at fill time,\r\n   * zeroing when the pointer is null (EveSpaceObjectDecal.cpp:376-383). The\r\n   * port holds the parent's array by reference with the same null contract; it\r\n   * is runtime state, so it carries no persistence.\r\n   */\r\n  shLighting = null;\r\n\r\n  /** Carbon's packed spherical-harmonic coefficient count\r\n   * (Tr2ShLightingManager::PACKED_COEFFICIENT_COUNT). */\r\n  static SH_COEFFICIENT_COUNT = 7;\r\n\r\n}\r\n"],"names":["_IEveSpaceObject2Pare","_identity","IEveSpaceObject2ParentData","CjsModel","e","_init_transform","_init_extra_transform","_init_killCount","_init_extra_killCount","_init_shipData","_init_extra_shipData","_init_clipSphereCenter","_init_extra_clipSphereCenter","_init_clipRadiusSq","_init_extra_clipRadiusSq","_init_clipRadius2Sq","_init_extra_clipRadius2Sq","_init_clipFactor","_init_extra_clipFactor","_init_clipFactor2","_init_extra_clipFactor2","_init_customData","_init_extra_customData","c","_initClass","_applyDecs","type","define","className","family","mat4","uint32","vec4","vec3","float32","transform","create","killCount","shipData","clipSphereCenter","clipRadiusSq","clipRadius2Sq","clipFactor","clipFactor2","customData","shLighting","SH_COEFFICIENT_COUNT","constructor"],"mappings":"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"}
+{"version":3,"file":"IEveSpaceObject2ParentData.js","sources":["../../../../../src/trinity/eve/spaceObject/IEveSpaceObject2ParentData.js"],"sourcesContent":["// Source: trinity/trinity/Eve/IEveSpaceObject2.h (IEveSpaceObject2::ParentData)\n// Hand-maintained. Carbon nests this struct inside the IEveSpaceObject2\n// interface; the JS identity concatenates owner and inner name\n// (IEveSpaceObject2 + ParentData) because a bare inner name is not unique\n// across the corpus - fifteen inner names are claimed by several owners and\n// thirteen collide with a top-level class.\n//\n// A plain class, not a model: it is internal per-frame data, filled by the\n// owner's update pass (GetParentData) and copied member by member by the\n// consumer, exactly as Carbon passes and copies the struct. Nothing hydrates\n// it or edits it from a UI; if something ever needs to, compose values onto\n// it rather than giving it the model base.\nimport { mat4 } from \"#math/mat4\";\nimport { vec3 } from \"#math/vec3\";\nimport { vec4 } from \"#math/vec4\";\n\n\n/** The per-frame parent state a space object hands to its attachments. */\nexport class IEveSpaceObject2ParentData\n{\n\n  /** transform (Matrix) - the parent's world transform. */\n  transform = mat4.create();\n\n  /** killCount (uint32_t) - EveSpaceObject2::GetParentData never assigns it,\n   * so it stays zero through that path (EveSpaceObject2.cpp:1874). */\n  killCount = 0;\n\n  /** shipData (Vector4) - m_spaceObjectShipData. */\n  shipData = vec4.create();\n\n  /** clipSphereCenter (Vector3). */\n  clipSphereCenter = vec3.create();\n\n  /** clipRadiusSq (float). */\n  clipRadiusSq = 0;\n\n  /** clipRadius2Sq (float). */\n  clipRadius2Sq = 0;\n\n  /** clipFactor (float) - the parent's clipSphereFactor. */\n  clipFactor = 0;\n\n  /** clipFactor2 (float) - the parent's clipSphereFactor2. */\n  clipFactor2 = 0;\n\n  /** customData (Vector4). */\n  customData = vec4.create();\n\n  /**\n   * shLighting (const Vector4*) - Carbon borrows a pointer to the parent's\n   * seven packed spherical-harmonic coefficients and copies them at fill time,\n   * zeroing when the pointer is null (EveSpaceObjectDecal.cpp:376-383). The\n   * port holds the parent's array by reference with the same null contract.\n   */\n  shLighting = null;\n\n  /** Carbon's packed spherical-harmonic coefficient count\n   * (Tr2ShLightingManager::PACKED_COEFFICIENT_COUNT). */\n  static SH_COEFFICIENT_COUNT = 7;\n\n}\n"],"names":["IEveSpaceObject2ParentData","transform","mat4","create","killCount","shipData","vec4","clipSphereCenter","vec3","clipRadiusSq","clipRadius2Sq","clipFactor","clipFactor2","customData","shLighting","SH_COEFFICIENT_COUNT"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;AACO,MAAMA,0BAA0B,CACvC;AAEE;AACAC,EAAAA,SAAS,GAAGC,IAAI,CAACC,MAAM,EAAE;;AAEzB;AACF;AACEC,EAAAA,SAAS,GAAG,CAAC;;AAEb;AACAC,EAAAA,QAAQ,GAAGC,IAAI,CAACH,MAAM,EAAE;;AAExB;AACAI,EAAAA,gBAAgB,GAAGC,IAAI,CAACL,MAAM,EAAE;;AAEhC;AACAM,EAAAA,YAAY,GAAG,CAAC;;AAEhB;AACAC,EAAAA,aAAa,GAAG,CAAC;;AAEjB;AACAC,EAAAA,UAAU,GAAG,CAAC;;AAEd;AACAC,EAAAA,WAAW,GAAG,CAAC;;AAEf;AACAC,EAAAA,UAAU,GAAGP,IAAI,CAACH,MAAM,EAAE;;AAE1B;AACF;AACA;AACA;AACA;AACA;AACEW,EAAAA,UAAU,GAAG,IAAI;;AAEjB;AACF;EACE,OAAOC,oBAAoB,GAAG,CAAC;AAEjC;;;;"}

package/docs/resource/concepts/resource-lifecycle.md

@@ -1,7 +1,7 @@
 # Resource lifecycle
 
 Status: Evolving  
-Scope: `@carbonenginejs/runtime/resource`
+Scope: `@carbonenginejs/runtime/resource`
 Audience: Users and integrators  
 Summary: Explains resource states, the load/prepare split, and how a resource request flows from path to published CPU payload.
 
@@ -34,7 +34,7 @@ keeps; see [architecture](../architecture.md).
 ## CarbonEngineJS states
 
 ```text
-EMPTY -> REQUESTED/LOADING -> LOADED          (resource layer)
+EMPTY -> REQUESTED/LOADING -> LOADED          (resource layer)
 LOADED -> PREPARING -> PREPARED               (engine adapters)
 ```
 
@@ -56,8 +56,10 @@ LOADED -> PREPARING -> PREPARED               (engine adapters)
 per source/path and limits active source operations with
 `maxConcurrentLoads`. After bytes arrive, object construction is split into
 separate main-queue items (`reader/format conversion -> publish`). Publication
-moves the resource to `LOADED`, then stops. ResMan never performs backend
-realization or marks the resource `PREPARED`/`GOOD`. See
+moves the resource to `PREPARED`: the published value is already the reader or
+converter outcome, so no CPU preparation remains. ResMan never performs backend
+realization. A route that hydrates a `Target` builds a new object for each
+caller from the retained decoded values, as Carbon's `LoadObject` does. See
 [reference/queues.md](../reference/queues.md) for the queue contract and
 [reference/motherlode-cache.md](../reference/motherlode-cache.md) for
 identity, retention, and release behavior.
@@ -212,10 +214,10 @@ device memory are different budgets. Retention therefore distinguishes:
   typed arrays;
 - adapter payload: WebGL/WebGPU textures, buffers, shader modules, pipelines.
 
-Identity and lightweight metadata remain resident while CPU and adapter
-payloads release independently. Engine adapters own adapter-resource destruction;
-the resource layer supplies lifecycle hooks and opaque adapter slots. See
-[reference/motherlode-cache.md](../reference/motherlode-cache.md).
+Identity and lightweight metadata remain resident while CPU and adapter
+payloads release independently. Engine adapters own adapter-resource destruction;
+the resource layer supplies lifecycle hooks and opaque adapter slots. See
+[reference/motherlode-cache.md](../reference/motherlode-cache.md).
 
 ## Related documentation
 

package/docs/resource/formats/geometry-interchange.md

@@ -25,6 +25,51 @@ particular, it does not require normalized skin-weight sums or finite mesh
 bounds and UV densities. Destination writers may impose stricter requirements
 when their target format needs them.
 
+## glTF import contract
+
+`CjsGltfFormat` defaults to `emit: "shared"`; `emit: "cmf"` uses the same
+canonical CMF builder. JSON and `gltfJson` are explicit projections, not the
+conversion boundary.
+
+- **Vertex channels:** glTF `TANGENT` is XYZ plus handedness, not an EVE packed
+  tangent frame. Import produces separate tangent and binormal vectors from
+  the matching normal and handedness; a tangent without a matching normal channel is
+  rejected. Invalid direction vectors use the exporter's fixed fallbacks.
+  Indexed UV/color channels retain their usage indices and three/four-component
+  color width. Optional tangent packing is applied independently to every LOD.
+- **Skinning:** `JOINTS_0` stays relative to the mesh's palette. Positive-weight
+  indices must address that palette; zero-weight indices become zero. Skins
+  sharing `skin.skeleton` share the full skeleton, including unused bones;
+  skins without it remain separate. `inverseBindMatrices` must be FLOAT MAT4,
+  one per joint, and map by joint-node identity without transpose. Conflicting
+  matrices for a shared bone reject; an absent accessor means identity.
+- **Morphs:** CMF buffers are absolute. Deltas are added to each LOD's own base;
+  omitted components copy that base, and authored absolute targets stay
+  absolute. Non-empty morph declarations include Position and are subsets of
+  the base declaration. Displacement is measured against the base and aggregated
+  across LODs. Weight animations become scalar MorphTarget channels:
+  `FooShape` maps to `Foo`. Carbon's exporter omits original target names, so
+  unnamed exported targets become `target_n`, not reconstructed original names.
+- **Animation:** missing TRS channels stay absent. Explicit one-key identity
+  channels retain `preserveIdentity`, since they may override a non-identity
+  rest pose. Track groups follow shared skeleton identity rather than duplicating
+  channels per mesh. Matrix decomposition is checked by recomposition; rotation
+  and reflected scale survive, but shear is rejected.
+- **Scene and LOD:** when scenes exist, import uses mesh nodes reachable from
+  the default scene and reconstructs lower LODs through `MSFT_lod.ids`.
+  Coverage `[c0, c1, ..., sentinel]` becomes thresholds
+  `[0xffffffff, round(c0 * 2048), round(c1 * 2048), ...]`, strictly descending;
+  the sentinel creates no LOD. Export-clamped thresholds above 2048 are not
+  recoverable. LODs must agree on topology, declaration, material-area count,
+  joint palette, and morph declarations/names.
+- **Topology:** non-indexed POINTS become PointList without an index buffer;
+  strips and fans are triangulated. CMF construction fills UV densities through
+  the highest TexCoord usage index, leaving missing usage indices zero.
+
+Carbon's exporter loses source declarations, packed-frame storage, bounds,
+metadata, morph names and some LOD information. Round trips are comparisons of
+representable geometry/animation semantics, not byte-exact recovery.
+
 ## FBX compatibility modes
 
 FBX reads accept `compatibility: "source" | "carbon"`. The default is
@@ -94,6 +139,11 @@ subdivision limit, not silent reinterpretation of cubic controls.
 
 The following inputs remain hard errors rather than lossy conversions:
 
+- glTF `JOINTS_n`/`WEIGHTS_n` above zero, pending an explicit influence-reduction
+  policy;
+- indexed glTF POINTS, pending coordinated unindexing of base and morph channels;
+- non-identity glTF mesh-node transforms, pending a complete bake through
+  geometry, morphs, bounds, directions and skinning;
 - multiple or weighted FBX animation layers and FBX cubic tangent semantics;
   Carbon delegates these to `ufbx_bake_anim`, and the runtime has no equivalent
   evaluator;