@carbonenginejs/runtime-resource 0.7.0 → 0.9.0

package/dist/resources/Tr2TexturePipelineStepGenerateMips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2TexturePipelineStepGenerateMips.js","sources":["../../../src/resources/Tr2TexturePipelineStepGenerateMips.js"],"sourcesContent":["// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepGenerateMips.h\n// Marker step: Carbon registers the class with zero attributes; the mip\n// generation itself happens where the pipeline is executed.\nimport { type } from \"@carbonenginejs/core-types/schema\";\nimport { CjsModel } from \"@carbonenginejs/core-types/model\";\n\n/** Tr2TexturePipelineStepGenerateMips (resources) - attribute-free Blue marker class. */\n@type.define({ className: \"Tr2TexturePipelineStepGenerateMips\", family: \"resources\" })\nexport class Tr2TexturePipelineStepGenerateMips extends CjsModel\n{\n}\n"],"names":["_Tr2TexturePipelineSt","Tr2TexturePipelineStepGenerateMips","CjsModel","_initClass","_applyDecs","type","define","className","family","c"],"mappings":";;;;;;AAMA;AAAA,IAAAA;AACA,MAAAC,kCAAA,SACwDC,QAAQ,CAChE;AAAA,EAAA;IAAA,CAAAF,qBAAA,EAAAG,UAAA,CAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,oCAAoC;AAAEC,MAAAA,MAAM,EAAE;AAAY,KAAC,CAAC,CAAA,EAAA,EAAA,EAAA,CAAA,EAAA,MAAA,EAC9BN,QAAQ,CAAA,CAAAO,CAAA;AAAA;AAAA,EAAA;IAAAN,UAAA,EAAA;AAAA;AAEhE;;;;"}

package/dist/resources/TriGeometryRes.js

@@ -21,7 +21,7 @@ new class extends _identity {
       } = _applyDecs2311(this, [type.define({
         className: "TriGeometryRes",
         family: "resources"
-      })], [[[io, io.readwrite, type, type.boolean], 16, "forceLod"], [[io, io.readwrite, type, type.int32], 16, "forcedLodIndex"], [[io, io.readwrite, type, type.string], 16, "name"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetMeshCount"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetAnimationCount"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetMeshAreaCount"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetMeshName"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetMeshAreaName"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetAreaBoundingBox"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetBoundingBox"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetBoundingSphere"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "CalculateBoundingBoxFromTransform"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "RecalculateBoundingSphere"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "Reload"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "GetIntersectionPointNormalBone"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "GetAreaIntersectionPointNormalBone"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetMeshVertexElements"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "SaveMesh"]], 0, void 0, _CjsResource));
+      })], [[[io, io.readwrite, type, type.boolean], 16, "forceLod"], [[io, io.readwrite, type, type.int32], 16, "forcedLodIndex"], [[io, io.readwrite, type, type.string], 16, "name"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetMeshCount"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetAnimationCount"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetSkeletonCount"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetSkeletonData"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetMeshAreaCount"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetMeshName"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetMeshAreaName"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetAreaBoundingBox"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetBoundingBox"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetBoundingSphere"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "CalculateBoundingBoxFromTransform"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "RecalculateBoundingSphere"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "Reload"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "GetIntersectionPointNormalBone"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "GetAreaIntersectionPointNormalBone"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetMeshVertexElements"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "SaveMesh"]], 0, void 0, _CjsResource));
     }
     forceLod = (_initProto(this), _init_forceLod(this, false));
     forcedLodIndex = (_init_extra_forceLod(this), _init_forcedLodIndex(this, -1));
@@ -77,6 +77,29 @@ new class extends _identity {
       return this.GetPayload()?.animations?.length || 0;
     }
 
+    /**
+     * Get skeleton count from the CPU geometry payload.
+     *
+     * @returns {number}
+     */
+    GetSkeletonCount() {
+      return this.GetPayload()?.skeletons?.length || 0;
+    }
+
+    /**
+     * Get one resource-owned skeleton from the CPU geometry payload.
+     *
+     * @param {number} skeletonIndex
+     * @returns {*}
+     */
+    GetSkeletonData(skeletonIndex = 0) {
+      const index = Number(skeletonIndex);
+      if (!Number.isInteger(index) || index < 0) {
+        return null;
+      }
+      return this.GetPayload()?.skeletons?.[index] || null;
+    }
+
     /**
      * Get mesh area count from a CPU geometry payload mesh.
      *

package/dist/resources/TriGeometryRes.js.map

@@ -1 +1 @@
-{"version":3,"file":"TriGeometryRes.js","sources":["../../../src/resources/TriGeometryRes.js"],"sourcesContent":["// Source: trinity/trinity/Resources/TriGeometryRes.h\n// Source: trinity/trinity/Resources/TriGeometryRes.cpp\n// Source: trinity/trinity/Resources/TriGeometryRes_Blue.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\nimport { CjsResource } from \"../CjsResource.js\";\nimport {\n  AssertResourcePayloadArray,\n  AssertResourcePayloadObject,\n  CarbonStubError,\n  ResourcePayloadError\n} from \"./resourceBoundary.js\";\n\n/**\n * TriGeometryRes resource record.\n *\n * Geometry payload facts live here. Engine-gpu decides if and how they become\n * device buffers, vertex declarations, or draw-time state.\n */\n@type.define({ className: \"TriGeometryRes\", family: \"resources\" })\nexport class TriGeometryRes extends CjsResource\n{\n\n  @io.readwrite\n  @type.boolean\n  forceLod = false;\n\n  @io.readwrite\n  @type.int32\n  forcedLodIndex = -1;\n\n  @io.readwrite\n  @type.string\n  name = \"\";\n\n  constructor(values = null)\n  {\n    super();\n    this.SetValues(values || {}, {\n      markDirty: false,\n      skipUpdate: true,\n      skipEvents: true\n    });\n  }\n\n  /**\n   * Attach a plain geometry payload.\n   *\n   * @param {object|null} payload\n   * @param {object|null} options\n   * @returns {TriGeometryRes}\n   */\n  SetPayload(payload = null, options = null)\n  {\n    if (payload === null)\n    {\n      super.SetPayload(null);\n      return this;\n    }\n    AssertResourcePayloadObject(\"TriGeometryRes\", payload);\n    AssertResourcePayloadArray(\"TriGeometryRes\", payload, \"meshes\");\n    for (const field of [ \"skeletons\", \"animations\" ])\n    {\n      if (payload[field] !== undefined && !Array.isArray(payload[field]))\n      {\n        throw ResourcePayloadError(\"TriGeometryRes\", \"Expected an array when provided.\", field);\n      }\n    }\n    super.SetPayload(payload);\n    this.SetValues(options || {});\n    return this;\n  }\n\n  /**\n   * Get mesh count from the CPU geometry payload.\n   *\n   * @returns {number}\n   */\n  @carbon.method\n  @impl.adapted\n  GetMeshCount()\n  {\n    return this.GetPayload()?.meshes?.length || 0;\n  }\n\n  /**\n   * Get animation count from the CPU geometry payload.\n   *\n   * @returns {number}\n   */\n  @carbon.method\n  @impl.adapted\n  GetAnimationCount()\n  {\n    return this.GetPayload()?.animations?.length || 0;\n  }\n\n  /**\n   * Get mesh area count from a CPU geometry payload mesh.\n   *\n   * @param {number} meshIndex\n   * @returns {number}\n   */\n  @carbon.method\n  @impl.adapted\n  GetMeshAreaCount(meshIndex = 0)\n  {\n    const mesh = this.GetPayload()?.meshes?.[meshIndex];\n    return mesh?.areas?.length || 0;\n  }\n\n  /**\n   * Get mesh name from a CPU geometry payload.\n   *\n   * @param {number} meshIndex\n   * @returns {string}\n   */\n  @carbon.method\n  @impl.adapted\n  GetMeshName(meshIndex = 0)\n  {\n    return this.GetPayload()?.meshes?.[meshIndex]?.name || \"\";\n  }\n\n  /**\n   * Get mesh area name from a CPU geometry payload.\n   *\n   * @param {number} meshIndex\n   * @param {number} areaIndex\n   * @returns {string}\n   */\n  @carbon.method\n  @impl.adapted\n  GetMeshAreaName(meshIndex = 0, areaIndex = 0)\n  {\n    return this.GetPayload()?.meshes?.[meshIndex]?.areas?.[areaIndex]?.name || \"\";\n  }\n\n  /**\n   * Get area bounding box from geometry payload data.\n   *\n   * @param {number} meshIndex\n   * @param {number} areaIndex\n   * @returns {*}\n   */\n  @carbon.method\n  @impl.adapted\n  GetAreaBoundingBox(meshIndex = 0, areaIndex = 0)\n  {\n    return this.GetPayload()?.meshes?.[meshIndex]?.areas?.[areaIndex]?.bounds || null;\n  }\n\n  /**\n   * Get mesh bounding box from geometry payload data.\n   * TODO: Should have a box3 as an argument, and write the result to that box3\n   *\n   * @param {number} meshIndex\n   * @returns {*}\n   */\n  @carbon.method\n  @impl.adapted\n  GetBoundingBox(meshIndex = 0)\n  {\n    return this.GetPayload()?.meshes?.[meshIndex]?.bounds || this.GetPayload()?.bounds || null;\n  }\n\n  /**\n   * Get mesh bounding sphere from geometry payload data.\n   * TODO: Should have a sph4 as an argument, and write the result to that sph4\n   *\n   * @param {number} meshIndex\n   * @returns {*}\n   */\n  @carbon.method\n  @impl.adapted\n  GetBoundingSphere(meshIndex = 0)\n  {\n    return this.GetPayload()?.meshes?.[meshIndex]?.sphere || this.GetPayload()?.sphere || null;\n  }\n\n  /**\n   * Calculate a transformed bounding box for a mesh.\n   *\n   * @throws {Error}\n   */\n  @carbon.method\n  @impl.notImplemented\n  CalculateBoundingBoxFromTransform()\n  {\n    throw CarbonStubError(\"TriGeometryRes\", \"CalculateBoundingBoxFromTransform\");\n  }\n\n  /**\n   * Recalculate bounding sphere data.\n   *\n   * @throws {Error}\n   */\n  @carbon.method\n  @impl.notImplemented\n  RecalculateBoundingSphere()\n  {\n    throw CarbonStubError(\"TriGeometryRes\", \"RecalculateBoundingSphere\");\n  }\n\n  /**\n   * Reload this geometry resource.\n   *\n   * @throws {Error}\n   */\n  @carbon.method\n  @impl.notImplemented\n  Reload() {\n    throw CarbonStubError(\"TriGeometryRes\", \"Reload\");\n  }\n\n  /**\n   * Intersect a ray with this geometry resource.\n   *\n   * @throws {Error}\n   */\n  @carbon.method\n  @impl.notImplemented\n  GetIntersectionPointNormalBone()\n  {\n    throw CarbonStubError(\"TriGeometryRes\", \"GetIntersectionPointNormalBone\");\n  }\n\n  /**\n   * Intersect a ray with a single mesh area.\n   *\n   * @throws {Error}\n   */\n  @carbon.method\n  @impl.notImplemented\n  GetAreaIntersectionPointNormalBone()\n  {\n    throw CarbonStubError(\"TriGeometryRes\", \"GetAreaIntersectionPointNormalBone\");\n  }\n\n  /**\n   * Get vertex element descriptors for a mesh.\n   *\n   * @param {number} meshIndex\n   * @returns {Array<*>}\n   */\n  @carbon.method\n  @impl.adapted\n  GetMeshVertexElements(meshIndex = 0)\n  {\n    return this.GetPayload()?.meshes?.[meshIndex]?.vertexElements || [];\n  }\n\n  /**\n   * Save a mesh to a Granny file.\n   *\n   * @throws {Error}\n   */\n  @carbon.method\n  @impl.notImplemented\n  SaveMesh()\n  {\n    throw CarbonStubError(\"TriGeometryRes\", \"SaveMesh\");\n  }\n\n  static payload = \"geometry\";\n\n}\n"],"names":["_TriGeometryRes","_identity","TriGeometryRes","CjsResource","e","_init_forceLod","_init_extra_forceLod","_init_forcedLodIndex","_init_extra_forcedLodIndex","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","readwrite","boolean","int32","string","carbon","method","impl","adapted","notImplemented","forceLod","forcedLodIndex","name","constructor","values","SetValues","markDirty","skipUpdate","skipEvents","SetPayload","payload","options","AssertResourcePayloadObject","AssertResourcePayloadArray","field","undefined","Array","isArray","ResourcePayloadError","GetMeshCount","GetPayload","meshes","length","GetAnimationCount","animations","GetMeshAreaCount","meshIndex","mesh","areas","GetMeshName","GetMeshAreaName","areaIndex","GetAreaBoundingBox","bounds","GetBoundingBox","GetBoundingSphere","sphere","CalculateBoundingBoxFromTransform","CarbonStubError","RecalculateBoundingSphere","Reload","GetIntersectionPointNormalBone","GetAreaIntersectionPointNormalBone","GetMeshVertexElements","vertexElements","SaveMesh"],"mappings":"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"}
+{"version":3,"file":"TriGeometryRes.js","sources":["../../../src/resources/TriGeometryRes.js"],"sourcesContent":["// Source: trinity/trinity/Resources/TriGeometryRes.h\n// Source: trinity/trinity/Resources/TriGeometryRes.cpp\n// Source: trinity/trinity/Resources/TriGeometryRes_Blue.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\nimport { CjsResource } from \"../CjsResource.js\";\nimport {\n  AssertResourcePayloadArray,\n  AssertResourcePayloadObject,\n  CarbonStubError,\n  ResourcePayloadError\n} from \"./resourceBoundary.js\";\n\n/**\n * TriGeometryRes resource record.\n *\n * Geometry payload facts live here. Engine-gpu decides if and how they become\n * device buffers, vertex declarations, or draw-time state.\n */\n@type.define({ className: \"TriGeometryRes\", family: \"resources\" })\nexport class TriGeometryRes extends CjsResource\n{\n\n  @io.readwrite\n  @type.boolean\n  forceLod = false;\n\n  @io.readwrite\n  @type.int32\n  forcedLodIndex = -1;\n\n  @io.readwrite\n  @type.string\n  name = \"\";\n\n  constructor(values = null)\n  {\n    super();\n    this.SetValues(values || {}, {\n      markDirty: false,\n      skipUpdate: true,\n      skipEvents: true\n    });\n  }\n\n  /**\n   * Attach a plain geometry payload.\n   *\n   * @param {object|null} payload\n   * @param {object|null} options\n   * @returns {TriGeometryRes}\n   */\n  SetPayload(payload = null, options = null)\n  {\n    if (payload === null)\n    {\n      super.SetPayload(null);\n      return this;\n    }\n    AssertResourcePayloadObject(\"TriGeometryRes\", payload);\n    AssertResourcePayloadArray(\"TriGeometryRes\", payload, \"meshes\");\n    for (const field of [ \"skeletons\", \"animations\" ])\n    {\n      if (payload[field] !== undefined && !Array.isArray(payload[field]))\n      {\n        throw ResourcePayloadError(\"TriGeometryRes\", \"Expected an array when provided.\", field);\n      }\n    }\n    super.SetPayload(payload);\n    this.SetValues(options || {});\n    return this;\n  }\n\n  /**\n   * Get mesh count from the CPU geometry payload.\n   *\n   * @returns {number}\n   */\n  @carbon.method\n  @impl.adapted\n  GetMeshCount()\n  {\n    return this.GetPayload()?.meshes?.length || 0;\n  }\n\n  /**\n   * Get animation count from the CPU geometry payload.\n   *\n   * @returns {number}\n   */\n  @carbon.method\n  @impl.adapted\n  GetAnimationCount()\n  {\n    return this.GetPayload()?.animations?.length || 0;\n  }\n\n  /**\n   * Get skeleton count from the CPU geometry payload.\n   *\n   * @returns {number}\n   */\n  @carbon.method\n  @impl.adapted\n  GetSkeletonCount()\n  {\n    return this.GetPayload()?.skeletons?.length || 0;\n  }\n\n  /**\n   * Get one resource-owned skeleton from the CPU geometry payload.\n   *\n   * @param {number} skeletonIndex\n   * @returns {*}\n   */\n  @carbon.method\n  @impl.adapted\n  GetSkeletonData(skeletonIndex = 0)\n  {\n    const index = Number(skeletonIndex);\n\n    if (!Number.isInteger(index) || index < 0)\n    {\n      return null;\n    }\n\n    return this.GetPayload()?.skeletons?.[index] || null;\n  }\n\n  /**\n   * Get mesh area count from a CPU geometry payload mesh.\n   *\n   * @param {number} meshIndex\n   * @returns {number}\n   */\n  @carbon.method\n  @impl.adapted\n  GetMeshAreaCount(meshIndex = 0)\n  {\n    const mesh = this.GetPayload()?.meshes?.[meshIndex];\n    return mesh?.areas?.length || 0;\n  }\n\n  /**\n   * Get mesh name from a CPU geometry payload.\n   *\n   * @param {number} meshIndex\n   * @returns {string}\n   */\n  @carbon.method\n  @impl.adapted\n  GetMeshName(meshIndex = 0)\n  {\n    return this.GetPayload()?.meshes?.[meshIndex]?.name || \"\";\n  }\n\n  /**\n   * Get mesh area name from a CPU geometry payload.\n   *\n   * @param {number} meshIndex\n   * @param {number} areaIndex\n   * @returns {string}\n   */\n  @carbon.method\n  @impl.adapted\n  GetMeshAreaName(meshIndex = 0, areaIndex = 0)\n  {\n    return this.GetPayload()?.meshes?.[meshIndex]?.areas?.[areaIndex]?.name || \"\";\n  }\n\n  /**\n   * Get area bounding box from geometry payload data.\n   *\n   * @param {number} meshIndex\n   * @param {number} areaIndex\n   * @returns {*}\n   */\n  @carbon.method\n  @impl.adapted\n  GetAreaBoundingBox(meshIndex = 0, areaIndex = 0)\n  {\n    return this.GetPayload()?.meshes?.[meshIndex]?.areas?.[areaIndex]?.bounds || null;\n  }\n\n  /**\n   * Get mesh bounding box from geometry payload data.\n   * TODO: Should have a box3 as an argument, and write the result to that box3\n   *\n   * @param {number} meshIndex\n   * @returns {*}\n   */\n  @carbon.method\n  @impl.adapted\n  GetBoundingBox(meshIndex = 0)\n  {\n    return this.GetPayload()?.meshes?.[meshIndex]?.bounds || this.GetPayload()?.bounds || null;\n  }\n\n  /**\n   * Get mesh bounding sphere from geometry payload data.\n   * TODO: Should have a sph4 as an argument, and write the result to that sph4\n   *\n   * @param {number} meshIndex\n   * @returns {*}\n   */\n  @carbon.method\n  @impl.adapted\n  GetBoundingSphere(meshIndex = 0)\n  {\n    return this.GetPayload()?.meshes?.[meshIndex]?.sphere || this.GetPayload()?.sphere || null;\n  }\n\n  /**\n   * Calculate a transformed bounding box for a mesh.\n   *\n   * @throws {Error}\n   */\n  @carbon.method\n  @impl.notImplemented\n  CalculateBoundingBoxFromTransform()\n  {\n    throw CarbonStubError(\"TriGeometryRes\", \"CalculateBoundingBoxFromTransform\");\n  }\n\n  /**\n   * Recalculate bounding sphere data.\n   *\n   * @throws {Error}\n   */\n  @carbon.method\n  @impl.notImplemented\n  RecalculateBoundingSphere()\n  {\n    throw CarbonStubError(\"TriGeometryRes\", \"RecalculateBoundingSphere\");\n  }\n\n  /**\n   * Reload this geometry resource.\n   *\n   * @throws {Error}\n   */\n  @carbon.method\n  @impl.notImplemented\n  Reload() {\n    throw CarbonStubError(\"TriGeometryRes\", \"Reload\");\n  }\n\n  /**\n   * Intersect a ray with this geometry resource.\n   *\n   * @throws {Error}\n   */\n  @carbon.method\n  @impl.notImplemented\n  GetIntersectionPointNormalBone()\n  {\n    throw CarbonStubError(\"TriGeometryRes\", \"GetIntersectionPointNormalBone\");\n  }\n\n  /**\n   * Intersect a ray with a single mesh area.\n   *\n   * @throws {Error}\n   */\n  @carbon.method\n  @impl.notImplemented\n  GetAreaIntersectionPointNormalBone()\n  {\n    throw CarbonStubError(\"TriGeometryRes\", \"GetAreaIntersectionPointNormalBone\");\n  }\n\n  /**\n   * Get vertex element descriptors for a mesh.\n   *\n   * @param {number} meshIndex\n   * @returns {Array<*>}\n   */\n  @carbon.method\n  @impl.adapted\n  GetMeshVertexElements(meshIndex = 0)\n  {\n    return this.GetPayload()?.meshes?.[meshIndex]?.vertexElements || [];\n  }\n\n  /**\n   * Save a mesh to a Granny file.\n   *\n   * @throws {Error}\n   */\n  @carbon.method\n  @impl.notImplemented\n  SaveMesh()\n  {\n    throw CarbonStubError(\"TriGeometryRes\", \"SaveMesh\");\n  }\n\n  static payload = \"geometry\";\n\n}\n"],"names":["_TriGeometryRes","_identity","TriGeometryRes","CjsResource","e","_init_forceLod","_init_extra_forceLod","_init_forcedLodIndex","_init_extra_forcedLodIndex","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","readwrite","boolean","int32","string","carbon","method","impl","adapted","notImplemented","forceLod","forcedLodIndex","name","constructor","values","SetValues","markDirty","skipUpdate","skipEvents","SetPayload","payload","options","AssertResourcePayloadObject","AssertResourcePayloadArray","field","undefined","Array","isArray","ResourcePayloadError","GetMeshCount","GetPayload","meshes","length","GetAnimationCount","animations","GetSkeletonCount","skeletons","GetSkeletonData","skeletonIndex","index","Number","isInteger","GetMeshAreaCount","meshIndex","mesh","areas","GetMeshName","GetMeshAreaName","areaIndex","GetAreaBoundingBox","bounds","GetBoundingBox","GetBoundingSphere","sphere","CalculateBoundingBoxFromTransform","CarbonStubError","RecalculateBoundingSphere","Reload","GetIntersectionPointNormalBone","GetAreaIntersectionPointNormalBone","GetMeshVertexElements","vertexElements","SaveMesh"],"mappings":"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"}

package/docs/README.md

@@ -0,0 +1,69 @@
+# Package documentation
+
+Status: Evolving  
+Scope: `@carbonenginejs/runtime-resource`  
+Audience: Users and integrators  
+Summary: Documentation home for the GPU-free resource lifecycle, cache, format, and object-loading package.
+
+## Purpose
+
+`@carbonenginejs/runtime-resource` owns the GPU-free resource layer of
+CarbonEngineJS: resource identity and state, the MotherLode cache, semantic
+resource classes, registered format readers, source adapters, and the queued
+CPU load/publication pipeline. It stops at a published CPU payload; engine
+packages realize that payload into backend objects.
+
+## Use this package when
+
+- you need Carbon-shaped resource loading (`res:/` paths, requirement/emit
+  selection, `Ready()`/`GetObject()`) without choosing a GPU backend;
+- you need one of the non-shader format readers as a tree-shakeable subpath
+  (`@carbonenginejs/runtime-resource/formats/<name>`);
+- you are writing an engine adapter that consumes published CPU payloads and
+  needs the documented retention, reload, and texture-array contracts.
+
+## Where it fits
+
+- Foundations consumed: `@carbonenginejs/core-types` (event emitter, model
+  contracts) and `@carbonenginejs/core-math` where formats need math values.
+- Normal consumers: `runtime-core` (configures and exposes a `CjsResMan`),
+  `runtime-trinity` and `runtime-sof` (request GPU-free objects), and engine
+  packages (`engine-webgpu`, future WebGL engines) that realize prepared
+  resources.
+- Owned responsibility: resource identity, cache, CPU payload lifecycle,
+  format selection and conversion, and load/publication queues.
+- Owned elsewhere: WebGL/WebGPU realization, device budgets, and device-loss
+  recovery belong to engine packages; shader formats belong to the dedicated
+  shader format packages.
+
+## Start here
+
+- [Architecture and boundaries](architecture.md)
+- [Resource lifecycle concepts](concepts/resource-lifecycle.md)
+- [Format subpaths](formats/README.md)
+
+## Documentation map
+
+- [architecture.md](architecture.md): package boundary, relationships, and the
+  GPU-free split.
+- [concepts/resource-lifecycle.md](concepts/resource-lifecycle.md): states,
+  the load/prepare split, and the request workflow.
+- [reference/motherlode-cache.md](reference/motherlode-cache.md): canonical
+  identity, byte-budget cache, payload retention, and purge contracts.
+- [reference/reload.md](reference/reload.md): the candidate-first atomic
+  reload contract.
+- [reference/queues.md](reference/queues.md): queued CPU load, publication,
+  registration, and the `Wait()` fence.
+- [reference/texture-arrays.md](reference/texture-arrays.md): texture-array
+  proxies, update generations, and adapter commits.
+- [reference/texture-pipeline.md](reference/texture-pipeline.md):
+  `Tr2TexturePipeline` CPU steps and `Tr2TextureLodManager` membership.
+- [reference/events.md](reference/events.md): the `CjsEventEmitter` contract
+  and event memory rules.
+- [formats/README.md](formats/README.md): format import map and per-format
+  output notes.
+- [formats/wwise.md](formats/wwise.md): Wwise soundbank and media readers.
+- [formats/stl.md](formats/stl.md): STL geometry export.
+- [formats/provenance.md](formats/provenance.md): format ownership, fork
+  provenance, and retained snapshots.
+- [roadmap.md](roadmap.md): approved future direction that is not implemented.

package/docs/architecture.md

@@ -0,0 +1,86 @@
+# Architecture and boundaries
+
+Status: Evolving  
+Scope: `@carbonenginejs/runtime-resource`  
+Audience: Users and integrators  
+Summary: Defines the GPU-free boundary this package owns and how engine and runtime packages relate to it.
+
+## The GPU-free split
+
+`runtime-resource` owns the GPU-free half of the Carbon resource lifecycle:
+
+```text
+EMPTY -> REQUESTED/LOADING -> LOADED
+```
+
+Engine adapters own device realization:
+
+```text
+LOADED -> PREPARING -> PREPARED
+```
+
+The package selects and runs registered non-shader readers, hydrates or
+returns the promised CPU outcome, and stores lifecycle state, cache entries,
+and loaded payloads. It never creates WebGL/WebGPU textures, buffers, shader
+modules, pipelines, or bind groups, and it never inspects backend capability.
+A realization failure destroys its candidate and returns the resource to
+`LOADED` without discarding the valid CPU payload.
+
+This deliberately differs from Carbon and ccpwgl, whose resource classes live
+inside an engine that can prepare GPU objects directly. Keeping the
+format/resource layer reusable means stopping before GPU work; see
+[resource lifecycle concepts](concepts/resource-lifecycle.md) for the
+historical mapping.
+
+## What the package owns
+
+- `CjsResource` state and Carbon-style resource methods.
+- `CjsMotherLode` canonical identity, explicit replacement results, activity
+  and lock metadata, deterministic payload/adapter cleanup, and cache stats.
+- `CjsResMan` semantic resource construction, registered-format selection,
+  concurrency-limited source loading, staged prepare queues, layered
+  source/read/resource deduplication, object loader dispatch, and prefetch.
+- `CjsTextureArrayRes` and `CjsTextureParameterProxy` for material-facing,
+  frame-coalesced texture-array inputs.
+- Raw `CjsEventEmitter` (from `core-types/model`) for manager/runtime events
+  without requiring `CjsModel` inheritance.
+- Path normalization, extension helpers, and source adapters for memory and
+  `fetch`.
+- Plain reader/converter payload objects with focused shared validators.
+- Canonical Carbon resource classes that validate and hold CPU payloads
+  privately: `TriTextureRes`, `TriGeometryRes`, `Tr2EffectRes`, `Tr2ImageRes`,
+  `TriGrannyRes`, `Tr2GrannyStateRes`, and `Tr2LightProfileRes`.
+- `Tr2TexturePipeline` CPU-only texture steps and `Tr2TextureLodManager`
+  membership.
+- Opaque engine-owned subobject slots for backend adapters.
+- Non-shader format implementations as explicit tree-shakeable subpaths under
+  `@carbonenginejs/runtime-resource/formats/<name>`.
+
+## What the package does not own
+
+- WebGL/WebGPU realization, allocations, upload accounting, device budgets,
+  capability limits, and device-loss recovery (engine packages).
+- Shader formats (`format-dxbc`, `format-hlsl`, `format-webgl`,
+  `format-webgpu` remain separate packages).
+- AudioBuffer construction, playback, or audio manager behavior.
+
+## Package relationships
+
+- `runtime-core` may configure and expose a `CjsResMan`, but does not own its
+  implementation.
+- `runtime-trinity` and `runtime-sof` may request GPU-free objects and
+  resources without selecting an engine.
+- `engine-webgpu` and future WebGL engines consume loaded resources and own
+  all backend allocations, preparation, replacement, and destruction.
+
+Concrete formats are not imported or registered by the package root; see
+[formats/README.md](formats/README.md) for the import rule and map.
+
+## Source layout
+
+Authoring source is decorated JavaScript; published output is built ESM in
+`npm/dist`. Completed Carbon data classes live with maintained source under
+`src/resources`; `src/generated` is reserved for unresolved active ports and
+is currently absent. Native shapes that JavaScript replaces or does not use
+are retained only under `src/dropped`, with their disposition documented
+there, and are never exported or bundled.

package/docs/concepts/resource-lifecycle.md

@@ -0,0 +1,217 @@
+# Resource lifecycle
+
+Status: Evolving  
+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.
+
+## Carbon and ccpwgl background
+
+Carbon's resource model separates load from prepare. The source schemas expose
+resource classes through `BlueAsyncRes`, and Carbon notes distinguish
+background load work from main-thread/device prepare work.
+
+ccpwgl makes that split visible in `Tw2Resource`:
+
+```text
+NO_INIT -> REQUESTED -> LOADED -> PREPARED
+```
+
+Additional terminal or cleanup states include `ERROR`, `UNLOADED`, and
+`PURGED`. The important behavior is:
+
+- `Tw2ResMan.LoadResource()` requests a resource.
+- The raw fetch resolves.
+- `Tw2Resource.OnLoaded()` marks bytes or source data as loaded.
+- The resource is queued for prepare.
+- The manager tick later calls `res.Prepare(data)`.
+- The concrete resource calls `OnPrepared()` after prepare work succeeds.
+
+Some ccpwgl concrete `Prepare()` implementations also create WebGL objects.
+That is a historical engine/runtime coupling, not the boundary CarbonEngineJS
+keeps; see [architecture](../architecture.md).
+
+## CarbonEngineJS states
+
+```text
+EMPTY -> REQUESTED/LOADING -> LOADED          (runtime-resource)
+LOADED -> PREPARING -> PREPARED               (engine adapters)
+```
+
+- `EMPTY`: resource identity exists, but no payload has been read.
+- `REQUESTED`: the resource is waiting on a queued or shared source load.
+- `LOADING`: source bytes are available and CPU reader/format work is active.
+- `LOADED`: CPU payload or hydrated object graph exists.
+- `PREPARING`: an engine adapter is realizing backend-owned resources.
+- `PREPARED`: preparation completed successfully and the resource is usable.
+- `FAILED`: CPU loading, conversion, validation, or publication failed before
+  a valid payload was published.
+- `UNLOADED`: resource payload was released.
+- `PURGED`: an inactivity or recorded-byte cache policy evicted the resource
+  from active ownership. Ordinary replacement, `Delete()`, `Clear()`,
+  `ClearCached()`, and shutdown clean owned payloads/adapters but preserve the
+  detached handle's last valid state.
+
+`CjsResMan.LoadObject()` queues one deduplicated background source operation
+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
+[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.
+
+## Request workflow
+
+The normal direct resource-path flow is:
+
+```text
+Application / runtime object
+        |
+        | requests "res:/model/ship.gr2"
+        | with optional per-request overrides
+        v
++-----------------------------------------------+
+| CjsLibrary                                    |
+|                                               |
+| - starts from registered default behavior     |
+| - considers registered capability reports     |
+| - chooses requirement / emit / format         |
+| - applies explicit request overrides          |
++-----------------------------------------------+
+        |
+        | path + resolved request options
+        v
++-----------------------------------------------+
+| CjsResMan.GetResource(path, options)          |
+|                                               |
+| - normalize source path and extension         |
+| - resolve the promised output tag             |
++-----------------------------------------------+
+        |
+        v
++-----------------------------------------------+
+| CjsMotherLode.Lookup(resolved key)             |
++-----------------------------------------------+
+        |
+        +--- cache hit ------------------------------+
+        |                                             |
+        |    reuse the CjsResource and any active     |
+        |    load/build operation                     |
+        |                                             |
+        `--- cache miss -----------------------------+
+              |                                       |
+              | resolve class from requirement        |
+              | construct + Initialize()              |
+              | insert into CjsMotherLode              |
+              v                                       |
+        new CjsResource -------------------------------+
+        |
+        | Ready() / GetObject()
+        v
++===============================================+
+| BACKGROUND LOAD QUEUE                         |
+|                                               |
+| - mark resource REQUESTED                     |
+| - share one source operation per source/path  |
+| - obey maxConcurrentLoads                     |
+| - source.Read(path)                           |
++===============================================+
+        |
+        | source bytes
+        v
++===============================================+
+| MAIN PREPARE QUEUE                            |
+|                                               |
+| every box below is a separately budgeted item |
++===============================================+
+        |
+        v
++-----------------------------------------------+
+| Read stage                                    |
+|                                               |
+| current object loader for extension?          |
+|   yes -> call it                              |
+|   no  -> resolve registered formats by        |
+|          bytes + request options               |
++-----------------------------------------------+
+        |
+        | plain payload / hydrated object
+        v
++-----------------------------------------------+
+| Publish stage                                 |
+|                                               |
+| semantic resource -> SetPayload(payload)      |
+| generic resource  -> SetPayload(value)        |
+|                      object aliases payload   |
++-----------------------------------------------+
+        |
+        +--- validation failure --------------------+
+        |                                            |
+        |    resource -> FAILED                      |
+        |    Ready() rejects                         |
+        |                                            |
+        `--- publication succeeds -----------------+
+                    |
+                    | resource -> LOADED
+                    v
+             CjsLibrary returns
+             the built CjsResource/object
+```
+
+Device realization is a separate continuation selected outside ResMan. It can
+run again after adapter eviction or device loss while the CPU payload remains
+resident:
+
+```text
+CjsResource LOADED
+        |
+        | selected engine adapter
+        v
+PREPARING
+        |
+        | create candidate -> verify current target -> synchronous attach
+        v
+PREPARED
+
+failure: destroy candidate -> LOADED (CPU payload retained)
+```
+
+## Retention model
+
+ccpwgl keeps every resource in `Tw2MotherLode` until it is explicitly cleared
+or auto-purged, and its `IsGood()` implicitly calls `KeepAlive()`, so many
+read/check paths keep resources resident. CarbonEngineJS is deliberately more
+explicit:
+
+- `IsGood()`, `IsPrepared()`, and `HasLoaded()` remain pure state checks.
+- `KeepAlive()` and `KeepPayloadAlive()` are the explicit liveness operations.
+- `Lock()` / `Unlock()` maintain a non-underflowing count and prevent identity
+  and payload eviction during a sweep.
+- MotherLode tracks separate identity and CPU-payload frame/time observations.
+- `CjsMotherLode.PurgeInactive()` scans only when explicitly requested and
+  never infers JavaScript reachability. `CjsResMan.Update()` may request it
+  only under an explicitly configured automatic policy.
+
+The CPU/GPU split adds an axis that ccpwgl blurs: CPU payload memory and
+device memory are different budgets. Retention therefore distinguishes:
+
+- resource identity: path, extension, state, error summary, lightweight
+  metadata;
+- CPU payload: plain reader/converter objects, hydrated object graphs, decoded
+  typed arrays;
+- adapter payload: WebGL/WebGPU textures, buffers, shader modules, pipelines.
+
+Identity and lightweight metadata stay resident while CPU payloads and adapter
+payloads release independently. Engine adapters own adapter-resource
+destruction; runtime-resource provides lifecycle hooks and opaque adapter
+slots so cleanup has a consistent place to run. The exact contracts live in
+[reference/motherlode-cache.md](../reference/motherlode-cache.md).
+
+## Related documentation
+
+- [Architecture and boundaries](../architecture.md)
+- [MotherLode identity, cache, and retention](../reference/motherlode-cache.md)
+- [Candidate-first atomic reload](../reference/reload.md)
+- [Queues and the Wait fence](../reference/queues.md)

package/docs/formats/README.md

@@ -0,0 +1,104 @@
+# Format subpaths
+
+Status: Evolving  
+Scope: `@carbonenginejs/runtime-resource/formats`  
+Audience: Users and integrators  
+Summary: Maps every non-shader format subpath and records cross-format output conventions.
+
+## Import rule
+
+Concrete formats are never imported or registered by the package root. Each
+format is an explicit tree-shakeable subpath, registered by the caller:
+
+```js
+import { CjsResMan } from "@carbonenginejs/runtime-resource";
+import { CjsMp4Format } from "@carbonenginejs/runtime-resource/formats/mp4";
+
+const resMan = new CjsResMan().Register({
+  source,
+  formats: [ CjsMp4Format ]
+});
+
+const resource = resMan.GetResource("res:/video/intro.mp4");
+const video = await resource.Ready();
+```
+
+Formats return plain payload objects. Semantic resource classes apply them
+through `SetPayload()`, validate their own required fields, and throw
+`CJS_RESOURCE_PAYLOAD_INVALID` before replacing a previously valid payload.
+`GetPayload()`, `HasPayload()`, and `ReleasePayload()` manage transient CPU
+retention without introducing a parallel DTO class hierarchy.
+
+## Format map
+
+| Format | Class | Import |
+|---|---|---|
+| Black (`.black`) | `CjsBlackFormat` | `@carbonenginejs/runtime-resource/formats/black` |
+| Wwise soundbank (`.bnk`) | `CjsBnkFormat` | `@carbonenginejs/runtime-resource/formats/bnk` |
+| CMF (`.cmf`) | `CjsCmfFormat` | `@carbonenginejs/runtime-resource/formats/cmf` |
+| DDS (`.dds`) | `CjsDdsFormat` | `@carbonenginejs/runtime-resource/formats/dds` |
+| FBX (`.fbx`) | `CjsFbxFormat` | `@carbonenginejs/runtime-resource/formats/fbx` |
+| FLAC (`.flac`) | `CjsFlacFormat` | `@carbonenginejs/runtime-resource/formats/flac` |
+| GIF (`.gif`) | `CjsGifFormat` | `@carbonenginejs/runtime-resource/formats/gif` |
+| glTF (`.gltf`/`.glb`) | `CjsGltfFormat` | `@carbonenginejs/runtime-resource/formats/gltf` |
+| Granny GR2/GSF (`.gr2`/`.gsf`) | `CjsGr2Format` | `@carbonenginejs/runtime-resource/formats/gr2` |
+| JPEG (`.jpg`/`.jpeg`) | `CjsJpegFormat` | `@carbonenginejs/runtime-resource/formats/jpeg` |
+| MP3 (`.mp3`) | `CjsMp3Format` | `@carbonenginejs/runtime-resource/formats/mp3` |
+| MP4 (`.mp4`) | `CjsMp4Format` | `@carbonenginejs/runtime-resource/formats/mp4` |
+| OBJ (`.obj`) | `CjsObjFormat` | `@carbonenginejs/runtime-resource/formats/obj` |
+| Ogg (`.ogg`) | `CjsOggFormat` | `@carbonenginejs/runtime-resource/formats/ogg` |
+| PNG (`.png`) | `CjsPngFormat` | `@carbonenginejs/runtime-resource/formats/png` |
+| Red (`.red`) | `CjsRedFormat` | `@carbonenginejs/runtime-resource/formats/red` |
+| STL (`.stl`) | `CjsStlFormat` | `@carbonenginejs/runtime-resource/formats/stl` |
+| TGA (`.tga`) | `CjsTgaFormat` | `@carbonenginejs/runtime-resource/formats/tga` |
+| WAV (`.wav`) | `CjsWavFormat` | `@carbonenginejs/runtime-resource/formats/wav` |
+| WebM (`.webm`) | `CjsWebmFormat` | `@carbonenginejs/runtime-resource/formats/webm` |
+| WebP (`.webp`) | `CjsWebpFormat` | `@carbonenginejs/runtime-resource/formats/webp` |
+| Wwise media (`.wem`) | `CjsWemFormat` | `@carbonenginejs/runtime-resource/formats/wem` |
+| YAML (`.yaml`/`.yml`) | `CjsYamlFormat` | `@carbonenginejs/runtime-resource/formats/yaml` |
+
+Detailed pages: [Wwise soundbanks and media](wwise.md),
+[STL export](stl.md). Ownership history, retained snapshots, and donor
+licensing are recorded in [provenance.md](provenance.md).
+
+## Granny GR2/GSF
+
+`CjsGr2Format` reads `.gr2` geometry/skeleton/animation graphs and `.gsf`
+(GState) profiles with no native tooling: section decompression (None,
+Oodle1, and the clean-room BitKnit2 decoder), reflected type-tree walking,
+GR2 JSON emission, optional curve decompression, CCP packed tangent-frame
+unpacking, and caller-class hydration (`emit: "gr2"`/`"cmf"` with a
+`classes` map). It was migrated from `@carbonenginejs/format-gr2` after that
+package's 2026-07-24 MIT relicense; the frozen donor repository documents
+the reader API and JSON graph in detail, and this copy preserves its
+behavior and test surface.
+
+## Red output markers
+
+Red payload output reserves configurable type, ID, reference, and sequence
+values markers (`_type`, `_id`, `_reference`, and `_values` by default).
+Repeated or cyclic sequences use an ID-bearing values envelope; unique
+sequences remain arrays. Authored fields may not collide with active markers,
+so remap the marker options when those names are real data. Disabling the
+reference marker preserves actual JavaScript identity; cyclic output in that
+mode is intentionally not JSON-serializable.
+
+## DDS decoded fallback
+
+Decoded DDS fallback currently has a narrower contract than native DDS
+texture output. `emit: "rgba"` returns one canonical 2D surface decoded from
+the first DDS subresource; it does not preserve stored mip levels, cube
+faces, array layers, or volume slices. Consumers may use it for ordinary 2D
+fallback when the engine owns any required mip generation, but must not infer
+decoded multi-subresource support from a successful RGBA probe. A future
+richer decoded-texture contract must be introduced explicitly rather than
+overloading the current RGBA fields.
+
+The software path includes BC1-BC5 and BC7 as RGBA8, plus signed and unsigned
+BC6H as linear `Float32Array` RGBA without clamping HDR values. These block
+decoders are implemented in-project with no codec package.
+
+## Related documentation
+
+- [Queues, publication, and registration](../reference/queues.md)
+- [Format ownership and fork provenance](provenance.md)