@forgeax/engine-gltf 0.1.4 → 0.1.7

package/dist/__tests__/extension-admission.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extension-admission.unit.test.d.ts.map

package/dist/__tests__/extension-admission.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-admission.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/extension-admission.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/source-key-diagnostics.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=source-key-diagnostics.integration.test.d.ts.map

package/dist/__tests__/source-key-diagnostics.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-key-diagnostics.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/source-key-diagnostics.integration.test.ts"],"names":[],"mappings":""}

package/dist/bridge.d.ts

@@ -41,17 +41,16 @@ export interface GltfBridgeContext {
     /**
      * glTF skin index -> SkeletonAsset GUID (string form). When a GltfNodeIr carries
      * a skin reference, the bridge emits `Skin: { skeleton: <guid-string> }` on
-     * that node's entity; the World scene owner resolves the GUID to a shared ref
-     * at `world.instantiateScene` time (same protocol as MeshFilter and
+     * that node's entity; AssetRegistry._resolveSceneGuids resolves the GUID to
+     * a runtime Handle at instantiate time (same protocol as MeshFilter and
      * MeshRenderer.materials[]). Optional — skinless glTFs pass an empty Map
      * (or omit the field) and the bridge does not emit Skin.
      *
      * tweak-20260611 M6 / D-7: emitting Skin from the bridge means the standard
-     * typed `assets.load(sceneGuid, sceneAssetKind)` + `world.instantiateScene`
-     * path Just Works for skinned glTF;
+     * loadByGuid<SceneAsset> + instantiate path Just Works for skinned glTF;
      * demos no longer need to runtime-parseGlb + post-load patch the SceneAsset.
-     * postSpawnResolveJoints walks the matching SkinAsset.jointPaths against the
-     * spawn subtree to fill Skin.joints[].
+     * postSpawnResolveJoints (called from AssetRegistry.instantiate) walks the
+     * matching SkinAsset.jointPaths against the spawn subtree to fill Skin.joints[].
      */
     readonly skeletonGuidBySkinIndex?: ReadonlyMap<number, string>;
 }

package/dist/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EACV,SAAS,EACT,MAAM,EAEN,aAAa,EACb,aAAa,EAEb,SAAS,EAIT,MAAM,EACN,UAAU,EAIX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAA4B,KAAK,SAAS,EAAe,MAAM,aAAa,CAAC;AACpF,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,UAAU,EACV,UAAU,EAGX,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,SAAS,GAAE;IACT,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpD,GACL,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CA0U9B;AAED,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,4DAA4D;IAC5D,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjF;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChE;AA+DD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,iBAAiB,GAAG,UAAU,CA8NpF;AAED,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC;AAEtC,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChF,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChF,8EAA8E;IAC9E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAC;IACtC;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAqDD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CA0B7B;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,qBAAqB,GAAG,aAAa,CA0E/F"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EACV,SAAS,EACT,MAAM,EAEN,aAAa,EACb,aAAa,EAEb,SAAS,EAIT,MAAM,EACN,UAAU,EAIX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAA4B,KAAK,SAAS,EAAe,MAAM,aAAa,CAAC;AACpF,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,UAAU,EACV,UAAU,EAGX,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,SAAS,GAAE;IACT,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpD,GACL,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CA0U9B;AAED,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,4DAA4D;IAC5D,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjF;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChE;AA+DD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,iBAAiB,GAAG,UAAU,CA8NpF;AAED,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC;AAEtC,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChF,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChF,8EAA8E;IAC9E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAC;IACtC;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAqDD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CA0B7B;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,qBAAqB,GAAG,aAAa,CA0E/F"}

package/dist/check-extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-extensions.d.ts","sourceRoot":"","sources":["../src/check-extensions.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAO,KAAK,SAAS,EAAe,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE5E,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAGhD,CAAC;AAGF,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,kBAAkB,GACvB,MAAM,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAsB1C"}
+{"version":3,"file":"check-extensions.d.ts","sourceRoot":"","sources":["../src/check-extensions.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAO,KAAK,SAAS,EAAe,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE5E,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAGhD,CAAC;AAOF,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,kBAAkB,GACvB,MAAM,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAsB1C"}

package/dist/cli-gltf.mjs

@@ -392,7 +392,11 @@ var EXTENSION_ALLOWLIST = [
   "EXT_mesh_gpu_instancing",
   "EXT_meshopt_compression"
 ];
-var SUPPORTED_EXTENSIONS = [...EXTENSION_ALLOWLIST, "KHR_lights_punctual"];
+var SUPPORTED_EXTENSIONS = [
+  ...EXTENSION_ALLOWLIST,
+  "KHR_lights_punctual",
+  "KHR_texture_transform"
+];
 function checkExtensions(json) {
   const required = json.extensionsRequired ?? [];
   for (const ext of required) {
@@ -992,9 +996,9 @@ function deriveGltfSourceKeys(items) {
       ok: false,
       error: {
         code: "missing-source-key",
-        sourceIndices: missing,
         expected: "every glTF output needs a stable semantic kind or name",
-        hint: "publish a semantic kind/name key; do not use sourceIndex"
+        hint: "publish a semantic kind/name key; do not use sourceIndex",
+        detail: { sourceIndices: missing }
       }
     };
   }
@@ -1002,19 +1006,34 @@ function deriveGltfSourceKeys(items) {
   for (let index = 0; index < keys.length; index++) {
     const key = keys[index];
     if (key === void 0) continue;
+    const current = items[index];
+    if (current === void 0) continue;
     const prior = seen.get(key);
     if (prior !== void 0) {
+      const entry = (item) => {
+        const name = item.name?.trim();
+        return {
+          kind: item.kind.trim(),
+          name: name === void 0 || name.length === 0 ? null : name,
+          sourceIndex: item.sourceIndex
+        };
+      };
+      const ambiguous = key === current.kind.trim();
       return {
         ok: false,
         error: {
-          code: key === items[index]?.kind ? "ambiguous-source-key" : "duplicate-source-key",
-          sourceIndices: [prior, items[index]?.sourceIndex ?? 0],
+          code: ambiguous ? "ambiguous-source-key" : "duplicate-source-key",
           expected: "sourceKey values must be unique within one glTF package",
-          hint: key === items[index]?.kind ? "name each otherwise anonymous output; do not use sourceIndex" : "rename duplicate outputs before publishing topology facts"
+          hint: ambiguous ? "name each otherwise anonymous output; do not use sourceIndex" : "rename duplicate outputs before publishing topology facts",
+          detail: {
+            key,
+            sourceIndices: [prior.sourceIndex, current.sourceIndex],
+            entries: [entry(prior), entry(current)]
+          }
         }
       };
     }
-    seen.set(key, items[index]?.sourceIndex ?? 0);
+    seen.set(key, current);
   }
   return { ok: true, keys, conflicts: [] };
 }
@@ -2083,10 +2102,12 @@ function toAssetPack(doc, existingMeta, source) {
     if (!reconciled.ok) {
       return err({
         code: "mesh-material-slot-topology-change",
-        sourceIndices: reconciled.error.nextIndices,
-        previousIndices: reconciled.error.previousIndices,
         expected: `unambiguous material slot identity for mesh ${meshOutput.guid}`,
-        hint: reconciled.error.hint
+        hint: reconciled.error.hint,
+        detail: {
+          sourceIndices: reconciled.error.nextIndices,
+          previousIndices: reconciled.error.previousIndices
+        }
       });
     }
     sourceOverrides[meshOutput.sourceKey] = {
@@ -2385,12 +2406,7 @@ async function runWrite(target, ctx) {
     sourceRelative
   );
   if (!pack.ok) {
-    return emitError(ctx, {
-      code: pack.error.code,
-      expected: pack.error.expected,
-      hint: pack.error.hint,
-      detail: { source: sourceRelative, sourceIndices: pack.error.sourceIndices }
-    });
+    return emitError(ctx, pack.error);
   }
   await writeFile(metaPath, serializeMetaJson(pack.value.meta), "utf-8");
   return 0;