@needle-tools/gltf-build-pipeline 2.15.10 → 2.15.12

package/CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to this package will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [2.15.12] - 2026-04-04
+- add: Support for material-only GLB processing
+- fix: PMREM processing for EXRs using DWAB compression (e.g. Blender forest.exr)
+
 ## [2.15.0] - 2026-03-20
 - add: EXR environment map compression (PMREM / FASTHDR) for Needle Engine, supporting both Unity and Blender exports
 - fix: cache hashing stability (circular reference handling)

package/dist/cli/index.js

@@ -52,6 +52,7 @@ Caches are limited to ${cacheSizeLimit} MB disc space by default.
     }
     logger.info("Writing stats to: " + output);
     writeFileStatsToFile(filestats, output);
+    process.exit(0);
 })
     .command("transform", "Transform (progressive loading) and compress glTF, GLB or VRM files")
     .help(`

package/dist/scripts/pack-gltf.js

@@ -7,7 +7,7 @@ import { MeshoptDecoder, MeshoptEncoder } from 'meshoptimizer';
 import { dedup, metalRough, prune, resample } from '@gltf-transform/functions';
 import { ALL_EXTENSIONS as NEEDLE_EXTENSIONS, NEEDLE_compression_texture, NEEDLE_mesh_compression, NEEDLE_pmrem, NEEDLE_lightmaps_ext, setExtensionInputFile } from '../extensions/index.js';
 import { isLOD, isMeshLOD, needle_animation_transform, needle_asset, needle_mesh_transform, needle_texture_transform, } from '../transforms/index.js';
-import { copyExternalResources, getOutputPath, getVersion, ioTryReadWithMissingResources, writeNodeIO } from "../utils/index.js";
+import { copyExternalResources, getOutputPath, getVersion, isMaterialOnlyGLB, ioTryReadWithMissingResources, writeNodeIO } from "../utils/index.js";
 import { addToCache, getHash, tryGetFromCache, } from "../cache/index.js";
 import { TestAssertionError } from '../utils/test-assert.js';
 /** Compress a glTF file
@@ -105,8 +105,11 @@ export async function packGLTF(inputFile, outputFile, options) {
             dedup({ propertyTypes: [PropertyType.MESH, PropertyType.MATERIAL] }),
         ];
         const isProgressiveAsset = isLOD(inputFile);
-        // TODO: progressive mesh LODs should not be pruned right now because it will remove e.g. UVs from meshes (and probably blend shapes too) (so we just not do it for any progressive asset) 
-        if (!isProgressiveAsset) {
+        const materialOnly = isMaterialOnlyGLB(document);
+        // TODO: progressive mesh LODs should not be pruned right now because it will remove e.g. UVs from meshes (and probably blend shapes too) (so we just not do it for any progressive asset)
+        // Material-only GLBs should not be pruned at all — they have no meshes so
+        // prune would strip materials, textures, and buffers, producing an empty file.
+        if (!isProgressiveAsset && !materialOnly) {
             transforms.push(prune({
                 // Pruning animations is not supported yet (e.g. if the animation is only referenced by a component)
                 propertyTypes: [

package/dist/transforms/needle_progressive.js

@@ -413,11 +413,11 @@ async function createTextureLod(args, opts) {
     // Pass compression settings to the new texture
     const compressionSettingsExt = texture.getExtension(NEEDLE_compression_texture.EXTENSION_NAME);
     if (compressionSettingsExt !== undefined && compressionSettingsExt !== null && compressionSettingsExt.getExtensionDefinition) {
-        logger.info("> Pass compression extension to new texture");
+        logger.debug("> Pass compression extension to new texture");
         const newExt = newDoc.createExtension(NEEDLE_compression_texture);
         const compressionSettings = compressionSettingsExt.getExtensionDefinition();
-        if (compressionSettings?.mode === "none") {
-            // if the mode is set to None then we keep that setting for the new texture
+        if (compressionSettings?.mode === "none" || compressionSettings?.mode === "webp" || compressionSettings?.mode === "UASTC" || compressionSettings?.mode === "ETC1S") {
+            // explicit compression mode set by the user — keep it for LOD textures
         }
         else {
             switch (opts.config.usecase) {

package/dist/utils/validate.d.ts

@@ -1,4 +1,7 @@
-import { ILogger } from "@gltf-transform/core";
+import { Document, ILogger } from "@gltf-transform/core";
+/** Returns true when the document contains materials/textures but no meshes, nodes, or scenes.
+ * These are standalone material assets that should not be pruned. */
+export declare function isMaterialOnlyGLB(document: Document): boolean;
 export declare function validateImageMimeType(mimetype: string, image: Uint8Array, logger: ILogger): {
     error: boolean;
     message: string;

package/dist/utils/validate.js

@@ -1,4 +1,11 @@
 import { ImageUtils } from "@gltf-transform/core";
+/** Returns true when the document contains materials/textures but no meshes, nodes, or scenes.
+ * These are standalone material assets that should not be pruned. */
+export function isMaterialOnlyGLB(document) {
+    const root = document.getRoot();
+    return root.listMeshes().length === 0
+        && root.listMaterials().length > 0;
+}
 export function validateImageMimeType(mimetype, image, logger) {
     const actualMimeType = ImageUtils.getMimeType(image);
     if (actualMimeType != null && actualMimeType != mimetype) {

package/dist/utils/version.gen.d.ts

@@ -1 +1 @@
-export declare const version = "2.15.10";
+export declare const version = "2.15.12";

package/dist/utils/version.gen.js

@@ -1 +1 @@
-export const version = "2.15.10";
+export const version = "2.15.12";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@needle-tools/gltf-build-pipeline",
-  "version": "2.15.10",
+  "version": "2.15.12",
   "description": "Pipeline and tools for optimizing gltf files using gltf-transform and compression settings within glTF extensions",
   "main": "dist/index.js",
   "type": "module",