@forgeax/engine-gltf 0.1.6 → 0.1.19

package/dist/parse-gltf.d.ts

@@ -1,12 +1,14 @@
 import { ImportError } from '@forgeax/engine-types';
 import { COMPONENT_TYPE } from './accessor/decode-accessor.js';
 import { type GltfError, type Result } from './errors.js';
+import { type GltfImageIr, type GltfMaterialIr, type GltfSamplerIr, type GltfTextureIr } from './material/parse-material.js';
 import { type GltfBufferViewDecodeCapability } from './meshopt-decode.js';
 import { type GltfAnimationClipRecord } from './parse-animation.js';
 import { type GltfSkeletonRecord } from './parse-skin.js';
 import { type GltfMetaJson, type GltfSubAssetEntry } from './reimport-reuse-meta.js';
 import type { GltfSourceKeyError } from './source-key.js';
 import { type DecomposedTransform } from './transform.js';
+export type { GltfImageIr, GltfMaterialIr, GltfMaterialJson, GltfNormalTextureInfoIr, GltfOcclusionTextureInfoIr, GltfSamplerIr, GltfTextureInfoIr, GltfTextureIr, GltfTextureTransformIr, NormalTextureInfoJson, OcclusionTextureInfoJson, TextureInfoJson, } from './material/parse-material.js';
 export interface MeshPrimitiveJson {
     readonly attributes?: Record<string, number>;
     readonly indices?: number;
@@ -24,26 +26,26 @@ export interface GltfMeshIr {
     readonly positions: Float32Array;
     readonly normals?: Float32Array;
     readonly texcoord0?: Float32Array;
-    /** TEXCOORD_1 per-vertex UV set 1 (Float32Array, 2 per vertex). feat-20260629-multi-uv-set-support m1-w2. */
+    /** TEXCOORD_1 per-vertex UV set 1. */
     readonly texcoord1?: Float32Array;
-    /** TEXCOORD_2 per-vertex UV set 2 (Float32Array, 2 per vertex). */
+    /** TEXCOORD_2 per-vertex UV set 2. */
     readonly texcoord2?: Float32Array;
-    /** TEXCOORD_3 per-vertex UV set 3 (Float32Array, 2 per vertex). */
+    /** TEXCOORD_3 per-vertex UV set 3. */
     readonly texcoord3?: Float32Array;
-    /** TEXCOORD_4 per-vertex UV set 4 (Float32Array, 2 per vertex). */
+    /** TEXCOORD_4 per-vertex UV set 4. */
     readonly texcoord4?: Float32Array;
-    /** TEXCOORD_5 per-vertex UV set 5 (Float32Array, 2 per vertex). */
+    /** TEXCOORD_5 per-vertex UV set 5. */
     readonly texcoord5?: Float32Array;
-    /** TEXCOORD_6 per-vertex UV set 6 (Float32Array, 2 per vertex). */
+    /** TEXCOORD_6 per-vertex UV set 6. */
     readonly texcoord6?: Float32Array;
-    /** TEXCOORD_7 per-vertex UV set 7 (Float32Array, 2 per vertex). */
+    /** TEXCOORD_7 per-vertex UV set 7. */
     readonly texcoord7?: Float32Array;
     readonly tangents?: Float32Array;
-    /** COLOR_0 importer carrier; bridge projects it to the canonical color attribute. */
+    /** COLOR_0 importer carrier. */
     readonly colors0?: Float32Array;
-    /** JOINTS_0 per-vertex joint indices (Uint16Array, 4 per vertex). UBYTE source is width-converted to U16 at parse time (D-3). */
+    /** JOINTS_0 per-vertex joint indices. */
     readonly joints0?: Uint16Array;
-    /** WEIGHTS_0 per-vertex skin weights (Float32Array, 4 per vertex). */
+    /** WEIGHTS_0 per-vertex skin weights. */
     readonly weights0?: Float32Array;
     readonly morphTargets?: readonly {
         readonly position?: Float32Array;
@@ -51,100 +53,16 @@ export interface GltfMeshIr {
         readonly tangent?: Float32Array;
     }[];
     readonly morphWeights?: Float32Array;
-    /**
-     * Optional per-glTF-spec: when omitted, primitive declares non-indexed
-     * geometry (vertex buffer is consumed in vertex order, every 3 verts =
-     * 1 triangle for triangle-list). bridge.ts handles undefined by routing
-     * MeshAsset.indices to undefined and submesh.indexCount=0 (vertexCount
-     * carries the draw count for `pass.draw(vertexCount)`).
-     * bug-20260612 hello-skin visual layered gate: prior shape coerced
-     * undefined into Uint16Array(0) and tripped MeshAsset.indices !==
-     * undefined branches downstream into drawIndexed(0).
-     * U16 (incl. widened U8) or U32 — width preserved from the source accessor;
-     * bridge.ts narrows U32 to U16 when the merged maxIndex fits.
-     */
+    /** Undefined means non-indexed; otherwise source width is preserved. */
     readonly indices?: Uint16Array | Uint32Array;
     readonly materialIndex: number | null;
-    /**
-     * Owning glTF mesh index in the original document (`gltf.meshes[meshIndex]`).
-     * After OOS-7 flattening, multiple GltfMeshIr entries may share the same
-     * meshIndex (one per primitive). Bridge layer uses this to filter material
-     * collection per node, fixing the verify-r1 charter-defect where multi
-     * glTF-mesh documents would silently misalign materials across nodes.
-     */
+    /** Owning glTF mesh index; multiple IR rows may share it after flattening. */
     readonly meshIndex: number;
 }
-export interface GltfTextureIr {
-    readonly sampler?: number;
-    readonly source: number;
-    readonly name?: string;
-}
-export interface GltfTextureTransformIr {
-    readonly offset?: readonly [number, number];
-    readonly rotation?: number;
-    readonly scale?: readonly [number, number];
-}
-export interface GltfTextureInfoIr {
-    readonly texture: number;
-    readonly sampler?: number;
-    readonly texCoord?: number;
-    readonly transform?: GltfTextureTransformIr;
-}
-export interface GltfNormalTextureInfoIr extends GltfTextureInfoIr {
-    readonly scale?: number;
-}
-export interface GltfOcclusionTextureInfoIr extends GltfTextureInfoIr {
-    readonly strength?: number;
-}
-export interface GltfImageIr {
-    readonly uri?: string;
-    readonly mimeType?: string;
-    readonly bufferView?: number;
-    readonly name?: string;
-}
-export interface GltfSamplerIr {
-    readonly magFilter?: number;
-    readonly minFilter?: number;
-    readonly wrapS: number;
-    readonly wrapT: number;
-    readonly name?: string;
-}
-export interface GltfMaterialIr {
-    readonly name?: string;
-    readonly baseColorFactor: readonly [number, number, number, number];
-    /** glTF emissiveFactor; omitted means the glTF default [0, 0, 0]. */
-    readonly emissiveFactor?: readonly [number, number, number];
-    readonly baseColorTexture?: GltfTextureInfoIr | number;
-    /** Texture binding for the emissive map. */
-    readonly emissiveTexture?: GltfTextureInfoIr | number;
-    readonly metallicFactor: number;
-    readonly roughnessFactor: number;
-    readonly metallicRoughnessTexture?: GltfTextureInfoIr | number;
-    readonly normalTexture?: GltfNormalTextureInfoIr | number;
-    readonly occlusionTexture?: GltfOcclusionTextureInfoIr | number;
-    /**
-     * glTF `alphaMode` (`'OPAQUE'` | `'MASK'` | `'BLEND'`). Absent -> `'OPAQUE'`
-     * (glTF spec default). Drives the bridge's transparent / alpha-test routing.
-     */
-    readonly alphaMode?: 'OPAQUE' | 'MASK' | 'BLEND';
-    /** glTF `alphaCutoff` (MASK-mode threshold; glTF spec default 0.5). */
-    readonly alphaCutoff?: number;
-    /**
-     * glTF `doubleSided`. Absent -> false (the glTF spec default). The bridge
-     * maps this to a no-cull material pass so reverse-facing glass and cards
-     * remain visible without changing their authored winding.
-     */
-    readonly doubleSided?: boolean;
-    /**
-     * baseColorTexture UV-set index (glTF `baseColorTexture.texCoord`). Absent
-     * -> 0. Selects which interleaved UV set the base-color sampler reads.
-     */
-    readonly baseColorTexCoord?: number;
-}
 export interface NodeInstancingIr {
-    /** Number of instances. All TRS attribute accessors share this count. */
+    /** Number of instances. */
     readonly count: number;
-    /** N column-major mat4 transforms packed into one Float32Array (length = N*16). */
+    /** Column-major transforms packed into one Float32Array. */
     readonly transforms: Float32Array;
 }
 export type GltfPunctualLightType = 'directional' | 'point' | 'spot';
@@ -162,16 +80,12 @@ export interface GltfNodeIr {
     readonly name?: string;
     readonly transform: DecomposedTransform;
     readonly meshIndex: number | null;
-    /** Node-authored morph weights override mesh defaults at instantiation. */
+    /** Node-authored morph weights override mesh defaults. */
     readonly morphWeights?: Float32Array;
-    /** Valid when node carries `skin` reference. Null when no skin. */
     readonly skinIndex: number | null;
     readonly children: readonly number[];
-    /** Present when node carries EXT_mesh_gpu_instancing (feat-20260518). */
     readonly instancing?: NodeInstancingIr;
-    /** glTF camera index. Null when the node does not reference a camera. */
     readonly camera: number | null;
-    /** KHR_lights_punctual light index. Null when the node has no light. */
     readonly lightIndex?: number | null;
 }
 export interface GltfSceneIr {

package/dist/parse-gltf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-gltf.d.ts","sourceRoot":"","sources":["../src/parse-gltf.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parse-gltf.d.ts","sourceRoot":"","sources":["../src/parse-gltf.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/engine-gltf",
-  "version": "0.1.6",
+  "version": "0.1.19",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -38,21 +38,21 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-animation": "0.1.6",
-    "@forgeax/engine-geometry": "0.1.6",
-    "@forgeax/engine-import": "0.1.6",
-    "@forgeax/engine-math": "0.1.6",
-    "@forgeax/engine-pack": "0.1.6",
-    "@forgeax/engine-scene": "0.1.6",
-    "@forgeax/engine-types": "0.1.6",
+    "@forgeax/engine-animation": "0.1.19",
+    "@forgeax/engine-geometry": "0.1.19",
+    "@forgeax/engine-import": "0.1.19",
+    "@forgeax/engine-math": "0.1.19",
+    "@forgeax/engine-pack": "0.1.19",
+    "@forgeax/engine-scene": "0.1.19",
+    "@forgeax/engine-types": "0.1.19",
     "@webgpu/types": "^0.1.71",
     "meshoptimizer": "^0.20.0"
   },
   "devDependencies": {
-    "@forgeax/engine-assets-runtime": "0.1.6",
-    "@forgeax/engine-picking": "0.1.6",
-    "@forgeax/engine-render": "0.1.6",
-    "@forgeax/engine-runtime": "0.1.6",
+    "@forgeax/engine-assets-runtime": "0.1.19",
+    "@forgeax/engine-picking": "0.1.19",
+    "@forgeax/engine-render": "0.1.19",
+    "@forgeax/engine-runtime": "0.1.19",
     "@types/node": "^20.14.0"
   },
   "forgeax": {

package/src/__tests__/bridge-material-values.unit.test.ts

@@ -103,4 +103,50 @@ describe('glTF material bridge values', () => {
     expect(material.values?.baseColorTexture).toEqual({ texture: 100 });
     expect(material.values?.baseColorTexture).not.toHaveProperty('coordinates');
   });
+
+  it('projects transmission and volume texture references without flattening coordinates', () => {
+    const material = toMaterialAsset(
+      {
+        baseColorFactor: [1, 1, 1, 1],
+        metallicFactor: 0,
+        roughnessFactor: 0.5,
+        transmissionFactor: 0.8,
+        transmissionTexture: { texture: 5, sampler: 15, texCoord: 2 },
+        ior: 1.45,
+        thicknessFactor: 0.2,
+        thicknessTexture: {
+          texture: 6,
+          sampler: 16,
+          texCoord: 3,
+          transform: { offset: [0.1, 0.2] },
+        },
+        attenuationColor: [0.5, 0.6, 0.7],
+        attenuationDistance: 2,
+      } as unknown as GltfMaterialIr,
+      {
+        textureHandles: new Map([
+          [5, 105],
+          [6, 106],
+        ]) as unknown as ReadonlyMap<number, Handle<'TextureAsset', 'shared'>>,
+        samplerHandles: new Map([
+          [15, 205],
+          [16, 206],
+        ]) as unknown as ReadonlyMap<number, Handle<'SamplerAsset', 'shared'>>,
+      },
+    );
+
+    expect(material.values).toMatchObject({
+      transmission: 0.8,
+      ior: 1.45,
+      thickness: 0.2,
+      attenuationColor: [0.5, 0.6, 0.7],
+      attenuationDistance: 2,
+      transmissionTexture: { texture: 105, sampler: 205, coordinates: { set: 2 } },
+      thicknessTexture: {
+        texture: 106,
+        sampler: 206,
+        coordinates: { set: 3, transform: { offset: [0.1, 0.2] } },
+      },
+    });
+  });
 });

package/src/__tests__/gltf-error-derived-views.test-d.ts

@@ -14,6 +14,7 @@ import {
   type GltfImageMimeUnsupportedDetail,
   type GltfInstancingCountMismatchDetail,
   type GltfMalformedHeaderDetail,
+  type GltfMaterialTransmissionInvalidDetail,
   type GltfMeshBridgeInvalidDetail,
   type GltfMeshoptDecodeFailedDetail,
   type GltfMeshoptDecoderRequiredDetail,
@@ -51,6 +52,7 @@ type ExpectedDetails = {
   readonly 'gltf-color-accessor-unsupported': GltfColorAccessorUnsupportedDetail;
   readonly 'gltf-color-accessor-malformed': GltfColorAccessorMalformedDetail;
   readonly 'gltf-mesh-bridge-invalid': GltfMeshBridgeInvalidDetail;
+  readonly 'gltf-material-transmission-invalid': GltfMaterialTransmissionInvalidDetail;
 };
 
 type ExpectedCodes = keyof ExpectedDetails;
@@ -109,6 +111,8 @@ function exhaustive(error: GltfError): string {
       return `${error.detail.semantic}:${error.detail.accessorIndex}:${error.detail.reason}`;
     case 'gltf-mesh-bridge-invalid':
       return error.detail.reason;
+    case 'gltf-material-transmission-invalid':
+      return `${error.detail.extension}:${error.detail.field}:${error.detail.reason}`;
   }
   return error;
 }

package/src/__tests__/gltf-error-policy-owner.unit.test.ts

@@ -1,185 +1,33 @@
-import { describe, expect, expectTypeOf, it } from 'vitest';
-import {
-  GLTF_ERROR_HINTS,
-  type GltfError,
-  type GltfErrorCode,
-  type GltfSkinAttrAsymmetricDetail,
-  type GltfVersionUnsupportedDetail,
-  gltfErr,
-} from '../errors.js';
-
-const EXPECTED_IN_POLICY_ORDER = [
-  'GLB 12-byte header (magic 0x46546C67 + version=2 + length) plus mandatory JSON chunk',
-  'asset.version === "2.0"',
-  'accessor byte range within bufferView.byteLength',
-  'extension listed in v1 allowlist (see EXTENSION_ALLOWLIST in @forgeax/engine-gltf)',
-  'dense fixed-stride accessor with supported componentType',
-  'externalLoader resolved the URI into an ArrayBuffer without throwing',
-  "sidecar <source>.meta.json (importer: 'gltf') present in same directory",
-  'all instance attribute accessors share the same count',
-  'image/mimeType is image/jpeg or image/png',
-  'skin.joints.length <= MAX_JOINTS (256)',
-  'animation sampler interpolation is LINEAR or STEP',
-  'animation channel target path is one of translation, rotation, scale, or weights',
-  'every joint node has a non-empty name and belongs to an acyclic hierarchy',
-  'image bytes extractable from bufferView / data-URI / external URI without corruption',
-  'mesh primitive declares JOINTS_0 and WEIGHTS_0 symmetrically (both present or both absent)',
-  'every animation channel resolves to one uniquely named scene node and stable target ID',
-  'a required or compressed-only EXT_meshopt_compression bufferView has a ready decoder capability',
-  'the EXT_meshopt_compression declaration and decoder output are structurally valid',
-  'morph target and default-weight arrays are dense, bounded, and match the base vertex count',
-  'COLOR_0 dense accessor uses VEC3/VEC4 FLOAT or normalized UBYTE/USHORT',
-  'COLOR_0 accessor is non-empty, finite, in range, and fully addressable',
-  'a non-empty merged mesh with consistent morph and COLOR_0 cardinality',
-] as const;
-
-const HINTS_IN_POLICY_ORDER = [
-  'verify .glb is not truncated; rerun: forgeax-engine-remote-gltf import <path>',
-  'asset.version must be "2.0"; v1 or v3 not supported',
-  'rebuild .gltf with valid bufferViews; check accessor index; ensure accessor.byteOffset + EFFECTIVE_STRIDE * (count - 1) + element_size <= bufferView.byteLength',
-  'see feat-future-gltf-extensions-allowlist; remove this extension or wait for the allowlist to expand',
-  'sparse: see feat-future-gltf-sparse-accessor; morph: see feat-future-gltf-morph; interleaved: see feat-future-gltf-mesh-multi-section',
-  'check sidecar meta.json + textures/ directory + vite-plugin-pack /__pack/lookup route',
-  'run: forgeax-engine-remote-gltf import <path>',
-  'EXT_mesh_gpu_instancing requires TRANSLATION/ROTATION/SCALE accessors to share count; see https://github.com/KhronosGroup/glTF/blob/main/extensions/2.0/Khronos/EXT_mesh_gpu_instancing/README.md#extending-nodes-with-instance-attributes',
-  'convert to JPG/PNG via external tool; only image/jpeg and image/png are supported',
-  'reduce joint count below MAX_JOINTS (256) or see OOS-skin-max-joints',
-  'see OOS-skin-cubicspline; convert CUBICSPLINE to LINEAR/STEP in DCC tool',
-  'animation target path must be translation, rotation, scale, or weights',
-  'ensure every joint node has a non-empty name and the node hierarchy is acyclic',
-  'verify the bufferView byte range / data: URI base64 / external URI sibling file is intact next to the .gltf source; rerun: forgeax-engine-remote-gltf import <path>',
-  'glTF spec requires JOINTS_0 and WEIGHTS_0 to appear together for each skinned primitive; add the missing attribute or remove the present one in the DCC tool',
-  'name every node in the animated hierarchy and ensure each animated full path is unique',
-  'provide the build-only EXT_meshopt_compression decoder or author a valid core fallback bufferView',
-  'the meshopt decoder accepts the declared compressed range and produces the declared byte count',
-  're-export dense morph targets with at most eight targets/attributes and matching vertex/default-weight lengths',
-  're-export COLOR_0 with a supported type/component/normalized combination; morph and sparse COLOR_0 remain deferred',
-  'repair the COLOR_0 accessor count, reference, range, or buffer bounds, then re-import the glTF source',
-  'repair the source primitive and re-import; inspect detail.reason and its typed facts',
-] as const;
-
-const policyErrors: readonly GltfError[] = [
-  gltfErr('gltf-malformed-header', { filePath: 'model.glb', byteOffset: 0 }),
-  gltfErr('gltf-version-unsupported', { filePath: 'model.gltf', actualVersion: '1.0' }),
-  gltfErr('gltf-buffer-out-of-bounds', {
-    accessor: 0,
-    byteOffset: 0,
-    byteLength: 4,
-    bufferIndex: 0,
-  }),
-  gltfErr('gltf-extension-unsupported', {
-    extension: 'KHR_x',
-    source: 'extensionsRequired',
-  }),
-  gltfErr('gltf-accessor-type-mismatch', { accessorIndex: 0, reason: 'sparse' }),
-  gltfErr('gltf-texture-load-failed', { uri: 'textures/test.png' }),
-  gltfErr('gltf-meta-missing', {
-    filePath: 'model.gltf',
-    expectedMetaPath: 'model.gltf.meta.json',
-  }),
-  gltfErr('gltf-instancing-count-mismatch', {
-    nodeIndex: 0,
-    accessor: 'TRANSLATION',
-    expectedCount: 2,
-    actualCount: 3,
-  }),
-  gltfErr('gltf-image-mime-unsupported', { mimeType: 'image/bmp' }),
-  gltfErr('gltf-skin-joint-count-exceeded', { skinIndex: 0, jointCount: 300, maxJoints: 256 }),
-  gltfErr('gltf-animation-cubicspline-unsupported', { animationIndex: 0, samplerIndex: 1 }),
-  gltfErr('gltf-morph-unsupported', { animationIndex: 0, channelIndex: 2, nodeIndex: 3 }),
-  gltfErr('gltf-skin-joint-name-missing', {
-    reason: 'name-missing',
-    skinIndex: 0,
-    jointPathIndex: 4,
-    nodeIndex: 5,
-  }),
-  gltfErr('gltf-image-extract-failed', { imageIndex: 0, source: 'bufferView', reason: 'sample' }),
-  gltfErr('gltf-skin-attr-asymmetric', {
-    meshIndex: 0,
-    primitiveIndex: 0,
-    hasJoints: true,
-    hasWeights: false,
-  }),
-  gltfErr('gltf-animation-target-invalid', {
-    reason: 'name-missing',
-    animationIndex: 0,
-    channelIndex: 0,
-    nodeIndex: 0,
-  }),
-  gltfErr('gltf-meshopt-decoder-required', {
-    bufferView: 0,
-    actual: 'required',
-    hasCoreFallback: false,
-  }),
-  gltfErr('gltf-meshopt-decode-failed', {
-    bufferView: 1,
-    actual: 'decoded byte count mismatch',
-    mode: 'ATTRIBUTES',
-    filter: 'NONE',
-  }),
-  gltfErr('gltf-morph-invalid', {
-    meshIndex: 0,
-    primitiveIndex: 0,
-    reason: 'target-count-exceeded',
-    targetCount: 9,
-    attributeCount: 1,
-    vertexCount: 3,
-  }),
-  gltfErr('gltf-color-accessor-unsupported', {
-    semantic: 'COLOR_0',
-    accessorIndex: 0,
-    reason: 'component',
-  }),
-  gltfErr('gltf-color-accessor-malformed', {
-    semantic: 'COLOR_0',
-    accessorIndex: 0,
-    reason: 'bounds',
-  }),
-  gltfErr('gltf-mesh-bridge-invalid', { reason: 'empty-input', primitiveCount: 0 }),
-];
-
-describe('glTF error policy owner', () => {
-  it('projects one exact twenty-two-code policy surface with stable own-key order', () => {
-    const codes = policyErrors.map(({ code }) => code);
-
-    expect(codes).toHaveLength(22);
-    expect(new Set(codes).size).toBe(22);
-    expect(Object.keys(GLTF_ERROR_HINTS)).toEqual(codes);
-    expect(Object.getOwnPropertyNames(GLTF_ERROR_HINTS)).toEqual(codes);
-    expect(Object.values(GLTF_ERROR_HINTS)).toEqual(HINTS_IN_POLICY_ORDER);
-
-    for (const code of codes) {
-      expect(Object.prototype.propertyIsEnumerable.call(GLTF_ERROR_HINTS, code)).toBe(true);
-    }
+import { describe, expect, it } from 'vitest';
+import { checkExtensions } from '../check-extensions.js';
+import { gltfErr } from '../errors.js';
+
+describe('glTF transmission error policy', () => {
+  it('keeps invalid material facts in a structured closed detail', () => {
+    const error = gltfErr('gltf-material-transmission-invalid', {
+      extension: 'KHR_materials_ior',
+      field: 'ior',
+      reason: 'range',
+      actual: 0,
+    });
+    expect(error).toMatchObject({
+      code: 'gltf-material-transmission-invalid',
+      detail: { extension: 'KHR_materials_ior', field: 'ior', reason: 'range', actual: 0 },
+      expected: expect.any(String),
+      hint: expect.any(String),
+    });
   });
 
-  it('keeps every expected and hint string byte-identical through gltfErr', () => {
-    for (const [index, error] of policyErrors.entries()) {
-      expect(error.expected).toBe(EXPECTED_IN_POLICY_ORDER[index]);
-      expect(error.hint).toBe(HINTS_IN_POLICY_ORDER[index]);
-      expect(GLTF_ERROR_HINTS[error.code]).toBe(HINTS_IN_POLICY_ORDER[index]);
-      expect(Object.keys(error)).toEqual(['code', 'expected', 'hint', 'detail']);
-    }
+  it('admits supported KHR transmission extensionsRequired declarations', () => {
+    const result = checkExtensions({ extensionsRequired: ['KHR_materials_transmission'] });
+    expect(result).toEqual({ ok: true, value: { unsupportedUsed: [] } });
   });
 
-  it('preserves the public hint type and representative detail narrowing', () => {
-    expectTypeOf(GLTF_ERROR_HINTS).toEqualTypeOf<Readonly<Record<GltfErrorCode, string>>>();
-
-    const versionError = gltfErr('gltf-version-unsupported', {
-      filePath: 'model.gltf',
-      actualVersion: '1.0',
-    });
-    expectTypeOf(versionError.detail).toEqualTypeOf<GltfVersionUnsupportedDetail>();
-    expect(versionError.detail.actualVersion).toBe('1.0');
-
-    const skinError = gltfErr('gltf-skin-attr-asymmetric', {
-      meshIndex: 2,
-      primitiveIndex: 1,
-      hasJoints: true,
-      hasWeights: false,
+  it('keeps unknown extensionsRequired declarations rejected', () => {
+    const result = checkExtensions({ extensionsRequired: ['KHR_materials_unlit'] });
+    expect(result).toMatchObject({
+      ok: false,
+      error: { code: 'gltf-extension-unsupported' },
     });
-    expectTypeOf(skinError.detail).toEqualTypeOf<GltfSkinAttrAsymmetricDetail>();
-    expect(skinError.detail.meshIndex).toBe(2);
-    expect(skinError.detail.hasWeights).toBe(false);
   });
 });

package/src/__tests__/gltf.unit.test.ts

@@ -278,6 +278,7 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
     'gltf-version-unsupported',
     'gltf-buffer-out-of-bounds',
     'gltf-extension-unsupported',
+    'gltf-material-transmission-invalid',
     'gltf-accessor-type-mismatch',
     'gltf-texture-load-failed',
     'gltf-meta-missing',
@@ -308,6 +309,8 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
         return 'oob';
       case 'gltf-extension-unsupported':
         return 'ext';
+      case 'gltf-material-transmission-invalid':
+        return 'material-transmission-invalid';
       case 'gltf-accessor-type-mismatch':
         return 'accessor';
       case 'gltf-texture-load-failed':
@@ -357,6 +360,13 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
         return gltfErr(code, { accessor: 0, byteOffset: 0, byteLength: 0, bufferIndex: 0 });
       case 'gltf-extension-unsupported':
         return gltfErr(code, { extension: 'KHR_x', source: 'extensionsRequired' });
+      case 'gltf-material-transmission-invalid':
+        return gltfErr(code, {
+          extension: 'KHR_materials_transmission',
+          field: 'transmissionFactor',
+          reason: 'range',
+          actual: 2,
+        });
       case 'gltf-accessor-type-mismatch':
         return gltfErr(code, { accessorIndex: 0, reason: 'sparse' });
       case 'gltf-texture-load-failed':
@@ -446,8 +456,8 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
     });
 
     describe('GltfErrorCode roster', () => {
-      it('GLTF_ERROR_HINTS exposes exactly 22 keys', () => {
-        expect(Object.keys(GLTF_ERROR_HINTS).length).toBe(22);
+      it('GLTF_ERROR_HINTS exposes exactly 23 keys', () => {
+        expect(Object.keys(GLTF_ERROR_HINTS).length).toBe(23);
       });
 
       it.each(ALL_CODES)('hint for %s is a non-empty string', (code) => {
@@ -2016,7 +2026,7 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
         expect(EXTENSION_ALLOWLIST).toEqual(['EXT_mesh_gpu_instancing', 'EXT_meshopt_compression']);
       });
 
-      it('(a) rejects extensionsRequired entries outside the allowlist', () => {
+      it('(a) rejects unsupported extensionsRequired entries', () => {
         const result = checkExtensions({
           extensionsRequired: ['KHR_materials_pbrSpecularGlossiness'],
         });
@@ -2029,7 +2039,9 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
       });
 
       it('(b) accepts extensionsUsed (not required) into diagnostics list with no stderr', () => {
-        const result = checkExtensions({ extensionsUsed: ['KHR_materials_pbrSpecularGlossiness'] });
+        const result = checkExtensions({
+          extensionsUsed: ['KHR_materials_pbrSpecularGlossiness', 'KHR_materials_transmission'],
+        });
         expect(result.ok).toBe(true);
         if (!result.ok) return;
         expect(result.value.unsupportedUsed).toEqual(['KHR_materials_pbrSpecularGlossiness']);
@@ -2073,6 +2085,18 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
         expect(stderrSpy).not.toHaveBeenCalled();
       });
 
+      it.each([
+        'KHR_materials_transmission',
+        'KHR_materials_ior',
+        'KHR_materials_volume',
+      ])('%s in extensionsRequired routes ok (supported)', (extension) => {
+        const result = checkExtensions({ extensionsRequired: [extension] });
+        expect(result.ok).toBe(true);
+        if (!result.ok) return;
+        expect(result.value.unsupportedUsed).toEqual([]);
+        expect(stderrSpy).not.toHaveBeenCalled();
+      });
+
       it('EXT_mesh_gpu_instancing in extensionsUsed (not required) routes ok with no warn', () => {
         const result = checkExtensions({ extensionsUsed: ['EXT_mesh_gpu_instancing'] });
         expect(result.ok).toBe(true);