@forgeax/engine-gltf 0.1.20 → 0.1.23

package/dist/lod/parse-lod.d.ts

@@ -0,0 +1,15 @@
+import { gltfErr, type Result } from '../errors.js';
+export interface GltfLodRelation {
+    readonly rootNode: number;
+    readonly lodNodeIds: readonly number[];
+    readonly screenCoverages: readonly number[];
+    /** All node-level MSFT_lod groups, retained for multi-root scenes. */
+    readonly groups: readonly GltfLodGroup[];
+}
+export interface GltfLodGroup {
+    readonly rootNode: number;
+    readonly lodNodeIds: readonly number[];
+    readonly screenCoverages: readonly number[];
+}
+export declare function parseGltfLodExtension(json: unknown): Result<GltfLodRelation, ReturnType<typeof gltfErr<'gltf-lod-invalid'>>>;
+//# sourceMappingURL=parse-lod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse-lod.d.ts","sourceRoot":"","sources":["../../src/lod/parse-lod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAmBD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,eAAe,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAgEzE"}

package/dist/lod/project-meta.d.ts

@@ -0,0 +1,23 @@
+import { type Result } from '@forgeax/engine-types';
+export interface GltfLodMetaLevel {
+    readonly sourceKey: string;
+    readonly guid: string;
+    readonly screenCoverage?: number;
+}
+export interface GltfLodMetaCandidate {
+    readonly rootSourceKey: string;
+    readonly levels: readonly GltfLodMetaLevel[];
+    readonly previous?: readonly GltfLodMetaLevel[] | undefined;
+}
+export interface GltfLodMetaOutput {
+    readonly sourceKey: string;
+    readonly meshGuid: string;
+    readonly screenCoverage: number;
+}
+export declare function projectGltfLodMeta(input: GltfLodMetaCandidate): Result<{
+    readonly lods: readonly GltfLodMetaOutput[];
+}, {
+    readonly code: string;
+    readonly reason: string;
+}>;
+//# sourceMappingURL=project-meta.d.ts.map

package/dist/lod/project-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-meta.d.ts","sourceRoot":"","sources":["../../src/lod/project-meta.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,CAAC;CAC7D;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,oBAAoB,GAC1B,MAAM,CACP;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAAE,EAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CACnD,CAqBA"}

package/dist/node-file-entry.mjs

@@ -22,6 +22,10 @@ var gltfErrorPolicy = {
     expected: "extension listed in v1 allowlist (see EXTENSION_ALLOWLIST in @forgeax/engine-gltf)",
     hint: "see feat-future-gltf-extensions-allowlist; remove this extension or wait for the allowlist to expand"
   },
+  "gltf-lod-invalid": {
+    expected: "MSFT_lod ids to reference unique existing node indices with valid coverage",
+    hint: "repair the MSFT_lod node relation or remove it from extensionsRequired before re-importing"
+  },
   "gltf-material-transmission-invalid": {
     expected: "KHR transmission, IOR, and volume values are finite and within their glTF ranges",
     hint: "repair the named glTF material extension value and re-import the source"
@@ -389,7 +393,9 @@ function decodeColorAccessor(input, flags = {}) {
 // src/check-extensions.ts
 var EXTENSION_ALLOWLIST = [
   "EXT_mesh_gpu_instancing",
-  "EXT_meshopt_compression"
+  "EXT_meshopt_compression",
+  "MSFT_lod",
+  "MSFT_screencoverage"
 ];
 var SUPPORTED_EXTENSIONS = [
   ...EXTENSION_ALLOWLIST,
@@ -449,6 +455,81 @@ function decodeBase64(b64) {
   return out;
 }
 
+// src/lod/parse-lod.ts
+function parseGltfLodExtension(json) {
+  const doc = json;
+  const nodes = doc.nodes ?? [];
+  const rawCoverage = doc.extensions?.MSFT_screencoverage?.scales;
+  const groups = [];
+  for (let rootNode = 0; rootNode < nodes.length; rootNode += 1) {
+    if (nodes[rootNode]?.extensions?.MSFT_lod === void 0) continue;
+    const idsRaw = nodes[rootNode]?.extensions?.MSFT_lod?.ids;
+    if (!Array.isArray(idsRaw)) {
+      return err(gltfErr("gltf-lod-invalid", { rootNode, ids: [], reason: "not-integer" }));
+    }
+    const ids = idsRaw.filter((value) => typeof value === "number");
+    if (ids.length !== idsRaw.length || ids.some((id) => !Number.isInteger(id) || id < 0 || id >= nodes.length)) {
+      return err(gltfErr("gltf-lod-invalid", { rootNode, ids, reason: "missing-node" }));
+    }
+    if (new Set(ids).size !== ids.length || ids.includes(rootNode)) {
+      return err(gltfErr("gltf-lod-invalid", { rootNode, ids, reason: "duplicate-node" }));
+    }
+    const hasMesh = (node) => {
+      if (typeof node?.mesh !== "number" || !Number.isInteger(node.mesh) || node.mesh < 0) {
+        return false;
+      }
+      const mesh = doc.meshes?.[node.mesh];
+      return mesh !== void 0 && Array.isArray(mesh.primitives) && mesh.primitives.length > 0;
+    };
+    if (!hasMesh(nodes[rootNode]) || ids.some((id) => !hasMesh(nodes[id]))) {
+      return err(gltfErr("gltf-lod-invalid", { rootNode, ids, reason: "missing-node" }));
+    }
+    const nodeCoverage = nodes[rootNode]?.extras?.MSFT_screencoverage;
+    const coverage = normalizeScreenCoverages(
+      nodeCoverage === void 0 ? rawCoverage : nodeCoverage,
+      ids.length,
+      nodeCoverage !== void 0
+    );
+    if (coverage === "invalid") {
+      return err(gltfErr("gltf-lod-invalid", { rootNode, ids, reason: "coverage" }));
+    }
+    groups.push({
+      rootNode,
+      lodNodeIds: ids,
+      screenCoverages: coverage ?? []
+    });
+  }
+  const first = groups[0];
+  if (first === void 0) {
+    if (doc.extensionsRequired?.some((extension) => extension === "MSFT_lod")) {
+      return err(gltfErr("gltf-lod-invalid", { rootNode: 0, ids: [], reason: "missing-node" }));
+    }
+    return ok({ rootNode: 0, lodNodeIds: [], screenCoverages: [], groups: [] });
+  }
+  return ok({
+    rootNode: first.rootNode,
+    lodNodeIds: first.lodNodeIds,
+    screenCoverages: first.screenCoverages,
+    groups
+  });
+}
+function normalizeScreenCoverages(raw, lodCount, officialNodeForm) {
+  if (raw === void 0) return void 0;
+  if (!Array.isArray(raw)) return "invalid";
+  if (raw.some(
+    (value) => typeof value !== "number" || !Number.isFinite(value) || value <= 0 || value > 1
+  )) {
+    return "invalid";
+  }
+  const expectedLengths = officialNodeForm ? [lodCount + 1] : [lodCount, lodCount + 1];
+  if (!expectedLengths.includes(raw.length)) return "invalid";
+  const values = raw.slice(0, lodCount);
+  for (let index = 1; index < values.length; index += 1) {
+    if (values[index] >= values[index - 1]) return "invalid";
+  }
+  return values;
+}
+
 // src/material/parse-material.ts
 function tuple2(values) {
   if (values === void 0 || values.length < 2) return void 0;
@@ -1374,6 +1455,8 @@ async function parseGltfWithBin(json, ctx) {
   const extResult = checkExtensions(json);
   if (!extResult.ok) return err(extResult.error);
   const unsupportedExtensions = extResult.value.unsupportedUsed;
+  const lodResult = parseGltfLodExtension(json);
+  if (!lodResult.ok) return err(lodResult.error);
   const lightsResult = parsePunctualLights(json, ctx.filePath);
   if (!lightsResult.ok) return err(lightsResult.error);
   const meshesJson = json.meshes ?? [];
@@ -1914,7 +1997,8 @@ async function parseGltfWithBin(json, ctx) {
       matrixTrsCoexistNodes: diagnostics.matrixTrsCoexistNodes
     },
     meshPrimitiveCount,
-    lights: lightsResult.value
+    lights: lightsResult.value,
+    ...lodResult.value.lodNodeIds.length === 0 ? {} : { lod: lodResult.value }
   });
 }
 async function parseGltfForImporter(json, externalLoader, filePath, options = {}) {