@needle-tools/gltf-build-pipeline 2.15.6 → 2.15.7

package/dist/extensions/NEEDLE_lightmaps/index.d.ts

@@ -17,8 +17,6 @@ export declare class NEEDLE_lightmaps_ext extends Extension {
     readonly extensionName = "NEEDLE_lightmaps";
     readonly prereadTypes: PropertyType[];
     readonly prewriteTypes: PropertyType[];
-    /** Set before io.read() to allow resolving external file paths in preread */
-    static inputFile: string;
     /** The raw extension JSON from the input (mutated in-place during write) */
     private extensionData;
     /** Entries with resolved Texture references */

package/dist/extensions/NEEDLE_lightmaps/index.js

@@ -2,6 +2,7 @@ import { Extension, ExtensionProperty, PropertyType } from '@gltf-transform/core
 import { existsSync, readFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { isLightmap } from '../../utils/texture.js';
+import { getExtensionInputFile } from '../index.js';
 const EXTENSION_NAME = 'NEEDLE_lightmaps';
 /**
  * Opaque-like ExtensionProperty that holds NEEDLE_lightmaps data on the Root.
@@ -40,8 +41,6 @@ export class NEEDLE_lightmaps_ext extends Extension {
     extensionName = EXTENSION_NAME;
     prereadTypes = [PropertyType.TEXTURE];
     prewriteTypes = [PropertyType.MATERIAL];
-    /** Set before io.read() to allow resolving external file paths in preread */
-    static inputFile = '';
     /** The raw extension JSON from the input (mutated in-place during write) */
     extensionData = null;
     /** Entries with resolved Texture references */
@@ -56,7 +55,7 @@ export class NEEDLE_lightmaps_ext extends Extension {
         const ext = json.extensions?.[EXTENSION_NAME];
         if (!ext?.textures)
             return this;
-        const inputFile = NEEDLE_lightmaps_ext.inputFile;
+        const inputFile = getExtensionInputFile();
         const inputDir = inputFile ? dirname(inputFile) : '';
         for (const entry of ext.textures) {
             // Skip embedded pointers — handled in read()

package/dist/extensions/NEEDLE_opaque/NEEDLE_opaque.d.ts

@@ -23,6 +23,5 @@ export interface IExtensionWriter {
     write(context: WriterContext, prop: IExtensibleProperty): void;
 }
 export declare let currentGenerator: string;
-export declare function setOpaqueInputFile(path: string): void;
 export declare function createOpaqueExtension(name: string, types: PropertyType | PropertyType[], opts?: Options): IOpaqueExtension;
 export {};

package/dist/extensions/NEEDLE_opaque/NEEDLE_opaque.js

@@ -10,9 +10,7 @@ for (const key in PropertyType) {
     ALL_PROPERTY_TYPES.push(PropertyType[key]);
 }
 export let currentGenerator = "";
-/** Set before io.read() to allow resolving external file paths (e.g. .exr) in component data */
-let _opaqueInputFile = "";
-export function setOpaqueInputFile(path) { _opaqueInputFile = path; }
+import { getExtensionInputFile } from '../index.js';
 // an opaque extension can be used to pass data through the gltf transform process
 // it should also be able to re-write/fix json pointers after the transformation which might have shuffled them around 
 export function createOpaqueExtension(name, types, opts) {
@@ -632,7 +630,7 @@ class JsonPointerHandler {
                     // External EXR file reference (e.g. "StudioHDRI_ferndale_studio_04_1k.exr" in a ReflectionProbe)
                     // Inject the file into the document as a Texture so PMREM can process it
                     if (!isTexturePointer && value.match(/\.exr$/i)) {
-                        const inputDir = _opaqueInputFile ? dirname(_opaqueInputFile) : '';
+                        const inputDir = getExtensionInputFile() ? dirname(getExtensionInputFile()) : '';
                         const exrPath = inputDir ? join(inputDir, value) : '';
                         if (exrPath && existsSync(exrPath)) {
                             // Check if we already injected this file

package/dist/extensions/index.d.ts

@@ -6,4 +6,10 @@ export * from "./NEEDLE_progressive_texture_settings/index.js";
 export * from "./NEEDLE_progressive_mesh_settings/index.js";
 export * from "./NEEDLE_pmrem/index.js";
 export * from "./NEEDLE_lightmaps/index.js";
+/** Central place to set the input file path for all extensions that need to resolve
+ *  external assets (e.g. .exr files) relative to the source GLB.
+ *  Call this before io.read(). */
+export declare function setExtensionInputFile(filePath: string): void;
+/** Returns the current input file path set via {@link setExtensionInputFile}. */
+export declare function getExtensionInputFile(): string;
 export declare function registerExtensions(node: any): void;

package/dist/extensions/index.js

@@ -12,6 +12,17 @@ import { ALL_EXTENSIONS as NEEDLE_EXTENSIONS } from "./NEEDLE_opaque/index.js";
 import { NEEDLE_progressive } from './NEEDLE_progressive/index.js';
 import { NEEDLE_pmrem } from './NEEDLE_pmrem/index.js';
 import { NEEDLE_lightmaps_ext } from './NEEDLE_lightmaps/index.js';
+let _extensionInputFile = '';
+/** Central place to set the input file path for all extensions that need to resolve
+ *  external assets (e.g. .exr files) relative to the source GLB.
+ *  Call this before io.read(). */
+export function setExtensionInputFile(filePath) {
+    _extensionInputFile = filePath;
+}
+/** Returns the current input file path set via {@link setExtensionInputFile}. */
+export function getExtensionInputFile() {
+    return _extensionInputFile;
+}
 export function registerExtensions(node) {
     node.registerExtensions(ALL_EXTENSIONS);
     node.registerExtensions(NEEDLE_EXTENSIONS);

package/dist/scripts/pack-gltf.js

@@ -5,7 +5,7 @@ import draco3d from 'draco3dgltf';
 import { existsSync, readFileSync, statSync, writeFileSync } from 'fs';
 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, setOpaqueInputFile, } from '../extensions/index.js';
+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 { getOutputPath, getVersion, ioTryReadWithMissingResources, writeNodeIO } from "../utils/index.js";
 import { addToCache, getHash, tryGetFromCache, } from "../cache/index.js";
@@ -69,8 +69,7 @@ export async function packGLTF(inputFile, outputFile, options) {
         // Set input file path so extensions can resolve external EXR files
         // Use sourceFile when available (e.g. when inputFile is a progressive output copy)
         const assetSourceFile = options.sourceFile ?? inputFile;
-        NEEDLE_lightmaps_ext.inputFile = assetSourceFile;
-        setOpaqueInputFile(assetSourceFile);
+        setExtensionInputFile(assetSourceFile);
         const document = await ioTryReadWithMissingResources(io, inputFile);
         if (options.logger) {
             document.setLogger(options.logger);

package/dist/transforms/needle_pmrem.js

@@ -1,5 +1,6 @@
 import { NEEDLE_pmrem } from '../extensions/index.js';
 import { existsSync, readFileSync, writeFileSync, mkdirSync, rmSync, chmodSync } from 'fs';
+import { safeRmDir } from '../utils/fileutils.js';
 import { join, dirname } from 'path';
 import { fileURLToPath, pathToFileURL } from 'url';
 import { execFile } from 'child_process';
@@ -212,11 +213,8 @@ export class NeedlePmremContext {
             }
         }
         // Clean up temp directory
-        if (this.tmpDir && existsSync(this.tmpDir)) {
-            try {
-                rmSync(this.tmpDir, { recursive: true });
-            }
-            catch { /* ignore */ }
+        if (this.tmpDir) {
+            await safeRmDir(this.tmpDir);
         }
     }
 }

package/dist/transforms/needle_progressive.js

@@ -3,7 +3,7 @@ import { SIMPLIFY_DEFAULTS, WELD_DEFAULTS, listTextureChannels, listTextureSlots
 import { KHRMaterialsSpecular } from '@gltf-transform/extensions';
 import draco3d from 'draco3dgltf';
 import { NEEDLE_PROGRESSIVE_EXTENSION_NAME, NEEDLE_progressive } from "../extensions/NEEDLE_progressive/index.js";
-import { createOpaqueExtension, currentGenerator, NEEDLE_compression_texture, NEEDLE_mesh_compression, NEEDLE_progressive_mesh_settings, NEEDLE_progressive_texture_settings, registerExtensions as registerDefaultExtensions } from '../extensions/index.js';
+import { createOpaqueExtension, currentGenerator, NEEDLE_compression_texture, NEEDLE_mesh_compression, NEEDLE_progressive_mesh_settings, NEEDLE_progressive_texture_settings, registerExtensions as registerDefaultExtensions, setExtensionInputFile } from '../extensions/index.js';
 import path, { basename, resolve } from 'path';
 import { existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'fs';
 import { addMetaToCache, addToCache, getHash, getKey, tryGetFromCache, tryGetMetaFromCache } from '../cache/index.js';
@@ -77,6 +77,7 @@ async function onProcess(file, opts) {
             'draco3d.decoder': await draco3d.createDecoderModule(),
             'draco3d.encoder': await draco3d.createEncoderModule(),
         });
+        setExtensionInputFile(file);
         let document = await ioTryReadWithMissingResources(io, file); // await io.read(file);
         if (document) {
             if (opts.logger) {

package/dist/transforms/needle_toktx.js

@@ -2,7 +2,8 @@ import { BufferUtils, FileUtils, ImageUtils, uuid } from "@gltf-transform/core";
 import { listTextureSlots, getTextureChannelMask, fitPowerOfTwo, TextureResizeFilter } from "@gltf-transform/functions";
 import { KHRTextureBasisu } from "@gltf-transform/extensions";
 import { checkKTXSoftware, createParams, KTX_SOFTWARE_VERSION_MIN, Mode } from "./toktx.js";
-import { existsSync, mkdirSync, rmSync } from "fs";
+import { existsSync, mkdirSync } from "fs";
+import { safeRmDir } from "../utils/fileutils.js";
 import { formatBytes, spawn, waitExit } from './util.js';
 import { ETC1S_DEFAULTS, UASTC_DEFAULTS } from "./toktx_types.js";
 import fs from 'fs/promises';
@@ -235,8 +236,8 @@ export class NeedleToktxContext {
         if (!usesKTX2) {
             this.basisuExtension?.dispose();
         }
-        if (this.cacheDirectory && existsSync(this.cacheDirectory)) {
-            rmSync(this.cacheDirectory, { recursive: true });
+        if (this.cacheDirectory) {
+            await safeRmDir(this.cacheDirectory);
         }
     }
 }

package/dist/utils/fileutils.d.ts

@@ -17,3 +17,6 @@ export declare function isDirectory(path: string): boolean;
  * If the directory does not exist, it will be created.
  */
 export declare function ensureIsDirectory(path: string): string;
+/** Recursively delete a directory, retrying on EBUSY/EPERM (Windows file handle delays).
+ *  Silently gives up after all retries fail — temp dirs will be cleaned up by the OS. */
+export declare function safeRmDir(dirPath: string, retries?: number, delayMs?: number): Promise<void>;

package/dist/utils/fileutils.js

@@ -1,4 +1,5 @@
-import { existsSync, statSync, readdirSync, readFileSync, mkdirSync } from 'fs';
+import { existsSync, statSync, readdirSync, readFileSync, mkdirSync, rmSync } from 'fs';
+import { setTimeout } from 'timers/promises';
 import { dirname, isAbsolute, join } from 'path';
 /**
  * Get the output path for a file based on the output directory or file.
@@ -175,3 +176,20 @@ export function ensureIsDirectory(path) {
     }
     return path;
 }
+/** Recursively delete a directory, retrying on EBUSY/EPERM (Windows file handle delays).
+ *  Silently gives up after all retries fail — temp dirs will be cleaned up by the OS. */
+export async function safeRmDir(dirPath, retries = 3, delayMs = 150) {
+    for (let i = 0; i <= retries; i++) {
+        try {
+            if (existsSync(dirPath))
+                rmSync(dirPath, { recursive: true });
+            return;
+        }
+        catch (err) {
+            const retryable = err?.code === 'EBUSY' || err?.code === 'EPERM';
+            if (!retryable || i === retries)
+                return;
+            await setTimeout(delayMs);
+        }
+    }
+}

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

@@ -1 +1 @@
-export declare const version = "2.15.6";
+export declare const version = "2.15.7";

package/dist/utils/version.gen.js

@@ -1 +1 @@
-export const version = "2.15.6";
+export const version = "2.15.7";

package/package.json

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