@forgeax/engine-gltf 0.1.3 → 0.1.6

package/dist/index.d.ts

@@ -18,7 +18,7 @@ export type { GltfHeaderJson } from './parse-gltf-header.js';
 export type { GltfDocItem, GltfMetaJson, GltfSubAssetEntry, ReimportReuseResult, ReimportReuseValue, SubAssetKey, } from './reimport-reuse-meta.js';
 export { reimportReuseMeta, subAssetKey, } from './reimport-reuse-meta.js';
 export { serializeMetaJson } from './serialize-meta.js';
-export type { GltfSourceKeyError, GltfSourceKeyErrorCode, GltfSourceKeyResult, } from './source-key.js';
+export type { GltfSourceKeyConflictEntry, GltfSourceKeyError, GltfSourceKeyErrorCode, GltfSourceKeyResult, } from './source-key.js';
 export { deriveGltfSourceKeys, sourceKeyForGltfOutput } from './source-key.js';
 export type { DecomposedTransform, NodeTransformJson, TransformDiagnostics, Vec3Tuple, Vec4Tuple, } from './transform.js';
 export { decomposeNodeTransform } from './transform.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,OAAO,EACP,cAAc,EACd,cAAc,EACd,QAAQ,EACR,WAAW,EACX,OAAO,EACP,sBAAsB,EACtB,UAAU,GACX,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,eAAe,GAChB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/E,YAAY,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAK5E,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACtF,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEvF,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,YAAY,EACV,8BAA8B,EAC9B,yCAAyC,EACzC,2BAA2B,EAC3B,gCAAgC,EAChC,kCAAkC,EAClC,SAAS,EACT,aAAa,EACb,eAAe,EACf,8BAA8B,EAC9B,4BAA4B,EAC5B,8BAA8B,EAC9B,iCAAiC,EACjC,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,4BAA4B,EAC5B,gCAAgC,EAChC,8BAA8B,EAC9B,2BAA2B,EAC3B,4BAA4B,EAC5B,MAAM,GACP,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAGjE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxE,YAAY,EACV,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,OAAO,EACP,WAAW,EACX,cAAc,EACd,UAAU,EACV,UAAU,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AASnE,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,iBAAiB,EACjB,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACT,SAAS,GACV,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,OAAO,EACP,cAAc,EACd,cAAc,EACd,QAAQ,EACR,WAAW,EACX,OAAO,EACP,sBAAsB,EACtB,UAAU,GACX,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,eAAe,GAChB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/E,YAAY,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAK5E,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACtF,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEvF,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,YAAY,EACV,8BAA8B,EAC9B,yCAAyC,EACzC,2BAA2B,EAC3B,gCAAgC,EAChC,kCAAkC,EAClC,SAAS,EACT,aAAa,EACb,eAAe,EACf,8BAA8B,EAC9B,4BAA4B,EAC5B,8BAA8B,EAC9B,iCAAiC,EACjC,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,4BAA4B,EAC5B,gCAAgC,EAChC,8BAA8B,EAC9B,2BAA2B,EAC3B,4BAA4B,EAC5B,MAAM,GACP,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAGjE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxE,YAAY,EACV,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,OAAO,EACP,WAAW,EACX,cAAc,EACd,UAAU,EACV,UAAU,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AASnE,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,iBAAiB,EACjB,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,0BAA0B,EAC1B,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACT,SAAS,GACV,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.mjs

@@ -3,7 +3,7 @@ export { err, ok } from '@forgeax/engine-types';
 import { packInterleavedVertexAttributes } from '@forgeax/engine-geometry';
 import { box3, mat4, vec3, quat } from '@forgeax/engine-math';
 import { AssetGuid } from '@forgeax/engine-pack/guid';
-import { packMeshBinV4 } from '@forgeax/engine-import';
+import { packMeshBinV4 } from '@forgeax/engine-import/mesh-bin';
 import { deriveAnimationTargetId } from '@forgeax/engine-animation/target-id';
 
 // src/errors.ts
@@ -955,7 +955,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) {
@@ -1812,9 +1816,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 }
       }
     };
   }
@@ -1822,19 +1826,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: [] };
 }
@@ -2931,10 +2950,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] = {
@@ -2972,6 +2993,9 @@ function toAssetPack(doc, existingMeta, source) {
 function isGlbBytes(source) {
   return source.toLowerCase().endsWith(".glb");
 }
+function publishesCatalogProduct(input) {
+  return input.importSettings.geometry !== "procedural";
+}
 function previousMaterialSlotTopology(ctx, meshSourceKey) {
   if (meshSourceKey === void 0) return void 0;
   const value = ctx.sourceOverrides?.[meshSourceKey]?.materialSlots;
@@ -3618,7 +3642,11 @@ async function importGltf(ctx, meshopt) {
   return { ok: true, value: { assets: out, sourceDependencies: [] } };
 }
 function createGltfImporter(meshopt) {
-  return { key: "gltf", import: (ctx) => importGltf(ctx) };
+  return {
+    key: "gltf",
+    import: (ctx) => importGltf(ctx),
+    capabilities: { catalog: { publish: publishesCatalogProduct } }
+  };
 }
 var gltfImporter = createGltfImporter();