@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/sceneImport/archive.d.ts

@@ -0,0 +1,30 @@
+export type ArchiveInventoryEntry = {
+    path: string;
+    compressedSize: number;
+    uncompressedSize: number;
+    directory: boolean;
+};
+export type ArchiveLimits = {
+    maxEntries: number;
+    maxEntryBytes: number;
+    maxTotalBytes: number;
+    maxCompressionRatio: number;
+};
+export declare const DEFAULT_ARCHIVE_LIMITS: ArchiveLimits;
+export type ArchiveInventory = {
+    sha256: string;
+    entries: ArchiveInventoryEntry[];
+    compressedBytes: number;
+    uncompressedBytes: number;
+};
+export declare function assertSafeArchiveEntries(entries: readonly ArchiveInventoryEntry[], limits?: ArchiveLimits): void;
+export declare function sha256File(path: string): Promise<string>;
+export declare function inventorySourceArchive(path: string, expectedSha256: string, limits?: ArchiveLimits): Promise<ArchiveInventory>;
+export declare function extractArchiveMembers(input: {
+    archivePath: string;
+    expectedSha256: string;
+    members: readonly string[];
+    outputDir: string;
+    limits?: ArchiveLimits;
+}): Promise<Map<string, string>>;
+export declare function prepareSafeExtractionOutput(outputDir: string): Promise<string>;

package/dist/sceneImport/archive.js

@@ -0,0 +1,336 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ARCHIVE_LIMITS = void 0;
+exports.assertSafeArchiveEntries = assertSafeArchiveEntries;
+exports.sha256File = sha256File;
+exports.inventorySourceArchive = inventorySourceArchive;
+exports.extractArchiveMembers = extractArchiveMembers;
+exports.prepareSafeExtractionOutput = prepareSafeExtractionOutput;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const promises_2 = require("node:stream/promises");
+const yauzl_1 = __importDefault(require("yauzl"));
+exports.DEFAULT_ARCHIVE_LIMITS = {
+    maxEntries: 100_000,
+    maxEntryBytes: 1_073_741_824,
+    maxTotalBytes: 8 * 1_073_741_824,
+    // Already-compressed GPU textures can legitimately contain very large flat
+    // blocks (the Bistro archive has a ~592:1 DirectX normal). The independent
+    // per-entry and total byte ceilings remain the primary bomb defense.
+    maxCompressionRatio: 1_000,
+};
+function assertSafeArchiveEntries(entries, limits = exports.DEFAULT_ARCHIVE_LIMITS) {
+    if (entries.length > limits.maxEntries) {
+        throw new Error(`archive has ${entries.length} entries; limit is ${limits.maxEntries}`);
+    }
+    const seen = new Set();
+    let compressed = 0;
+    let uncompressed = 0;
+    for (const entry of entries) {
+        const path = entry.path;
+        const normalized = node_path_1.posix.normalize(path);
+        if (!path ||
+            path.includes('\0') ||
+            path.includes('\\') ||
+            (0, node_path_1.isAbsolute)(path) ||
+            path.startsWith('/') ||
+            path === '..' ||
+            path.startsWith('../') ||
+            normalized !== path.replace(/\/$/, '') + (path.endsWith('/') ? '/' : '') ||
+            path.split('/').includes('..')) {
+            throw new Error(`unsafe archive path: ${JSON.stringify(path)}`);
+        }
+        if (seen.has(path))
+            throw new Error(`duplicate archive path: ${path}`);
+        seen.add(path);
+        if (!Number.isSafeInteger(entry.compressedSize) ||
+            !Number.isSafeInteger(entry.uncompressedSize) ||
+            entry.compressedSize < 0 ||
+            entry.uncompressedSize < 0) {
+            throw new Error(`invalid archive sizes for ${path}`);
+        }
+        if (entry.uncompressedSize > limits.maxEntryBytes) {
+            throw new Error(`decompression limit exceeded by ${path}`);
+        }
+        const ratio = entry.uncompressedSize / Math.max(1, entry.compressedSize);
+        if (ratio > limits.maxCompressionRatio) {
+            throw new Error(`decompression ratio limit exceeded by ${path}`);
+        }
+        compressed += entry.compressedSize;
+        uncompressed += entry.uncompressedSize;
+        if (uncompressed > limits.maxTotalBytes) {
+            throw new Error('archive decompression total exceeds the configured limit');
+        }
+    }
+    if (uncompressed / Math.max(1, compressed) > limits.maxCompressionRatio) {
+        throw new Error('archive decompression ratio exceeds the configured limit');
+    }
+}
+async function sha256File(path) {
+    const hash = (0, node_crypto_1.createHash)('sha256');
+    for await (const chunk of (0, node_fs_1.createReadStream)(path))
+        hash.update(chunk);
+    return hash.digest('hex');
+}
+async function inventorySourceArchive(path, expectedSha256, limits = exports.DEFAULT_ARCHIVE_LIMITS) {
+    if (!/^[a-f0-9]{64}$/.test(expectedSha256)) {
+        throw new Error('expected source SHA-256 must be 64 lowercase hexadecimal characters');
+    }
+    const sha256 = await sha256File(path);
+    if (sha256 !== expectedSha256) {
+        throw new Error(`unexpected source SHA-256: expected ${expectedSha256}, received ${sha256}`);
+    }
+    const entries = await listZipEntries(path, limits);
+    assertSafeArchiveEntries(entries, limits);
+    return {
+        sha256,
+        entries,
+        compressedBytes: entries.reduce((sum, entry) => sum + entry.compressedSize, 0),
+        uncompressedBytes: entries.reduce((sum, entry) => sum + entry.uncompressedSize, 0),
+    };
+}
+async function extractArchiveMembers(input) {
+    const inventory = await inventorySourceArchive(input.archivePath, input.expectedSha256, input.limits);
+    const available = new Set(inventory.entries.filter((entry) => !entry.directory).map((entry) => entry.path));
+    const requested = new Set(input.members);
+    for (const member of requested) {
+        assertSafeArchiveEntries([{ path: member, compressedSize: 1, uncompressedSize: 1, directory: false }]);
+        if (!available.has(member))
+            throw new Error(`archive is missing required member: ${member}`);
+    }
+    const outputRoot = await prepareSafeExtractionOutput(input.outputDir);
+    const extracted = new Map();
+    const archive = await (0, promises_1.open)(input.archivePath, 'r');
+    const before = await archive.stat().catch(async (error) => {
+        await archive.close();
+        throw error;
+    });
+    let zip;
+    try {
+        const openedSha256 = await sha256FileHandle(archive);
+        if (openedSha256 !== input.expectedSha256) {
+            throw new Error(`unexpected source SHA-256: expected ${input.expectedSha256}, received ${openedSha256}`);
+        }
+        // Pin yauzl to a second descriptor whose identity and bytes we verify. Reopening by
+        // pathname after hashing would let a path swap feed different bytes to extraction.
+        zip = await openVerifiedZip(input.archivePath, input.expectedSha256, before);
+    }
+    catch (error) {
+        await archive.close();
+        throw error;
+    }
+    try {
+        await new Promise((resolvePromise, reject) => {
+            const fail = (error) => {
+                zip.close();
+                reject(error);
+            };
+            zip.on('error', fail);
+            zip.on('end', resolvePromise);
+            zip.on('entry', (entry) => {
+                if (!requested.has(entry.fileName)) {
+                    zip.readEntry();
+                    return;
+                }
+                const destination = (0, node_path_1.resolve)(outputRoot, ...entry.fileName.split('/'));
+                if (destination !== outputRoot && !destination.startsWith(`${outputRoot}${node_path_1.sep}`)) {
+                    fail(new Error(`unsafe archive extraction path: ${entry.fileName}`));
+                    return;
+                }
+                void (0, promises_1.mkdir)((0, node_path_1.dirname)(destination), { recursive: true })
+                    .then(() => openEntryStream(zip, entry))
+                    .then((stream) => (0, promises_2.pipeline)(stream, (0, node_fs_1.createWriteStream)(destination, { flags: 'wx' })))
+                    .then(() => {
+                    extracted.set(entry.fileName, destination);
+                    zip.readEntry();
+                })
+                    .catch(fail);
+            });
+            zip.readEntry();
+        });
+    }
+    finally {
+        zip.close();
+        const after = await archive.stat();
+        await archive.close();
+        if (before.dev !== after.dev ||
+            before.ino !== after.ino ||
+            before.size !== after.size ||
+            before.mtimeMs !== after.mtimeMs ||
+            before.ctimeMs !== after.ctimeMs) {
+            throw new Error('source archive changed during extraction');
+        }
+    }
+    if (extracted.size !== requested.size)
+        throw new Error('not all requested archive members were extracted');
+    return extracted;
+}
+async function prepareSafeExtractionOutput(outputDir) {
+    const outputRoot = (0, node_path_1.resolve)(outputDir);
+    await assertNearestExistingRealDirectory(outputRoot);
+    await (0, promises_1.mkdir)(outputRoot, { recursive: true });
+    const outputStat = await (0, promises_1.lstat)(outputRoot);
+    if (!outputStat.isDirectory() || outputStat.isSymbolicLink()) {
+        throw new Error('archive extraction output must be a real directory');
+    }
+    if ((await (0, promises_1.readdir)(outputRoot)).length > 0) {
+        throw new Error('archive extraction output directory must be empty');
+    }
+    return outputRoot;
+}
+async function assertNearestExistingRealDirectory(path) {
+    for (let component = path;; component = (0, node_path_1.dirname)(component)) {
+        try {
+            const stat = await (0, promises_1.lstat)(component);
+            if (!stat.isDirectory() || stat.isSymbolicLink()) {
+                throw new Error('archive extraction output must have only real directory components');
+            }
+            return;
+        }
+        catch (error) {
+            if (isMissingPathError(error) && (0, node_path_1.dirname)(component) !== component)
+                continue;
+            throw error;
+        }
+    }
+}
+function isMissingPathError(error) {
+    return typeof error === 'object' && error !== null && 'code' in error && error.code === 'ENOENT';
+}
+async function sha256FileHandle(file) {
+    const hash = (0, node_crypto_1.createHash)('sha256');
+    const stream = file.createReadStream({ start: 0, autoClose: false });
+    for await (const chunk of stream)
+        hash.update(chunk);
+    return hash.digest('hex');
+}
+async function listZipEntries(path, limits) {
+    const zip = await openZip(path);
+    const entries = [];
+    const seen = new Set();
+    let compressedBytes = 0;
+    let uncompressedBytes = 0;
+    try {
+        return await new Promise((resolvePromise, reject) => {
+            const fail = (error) => {
+                zip.close();
+                reject(error);
+            };
+            zip.on('error', fail);
+            zip.on('end', () => resolvePromise(entries));
+            zip.on('entry', (entry) => {
+                const inventoryEntry = {
+                    path: entry.fileName,
+                    compressedSize: entry.compressedSize,
+                    uncompressedSize: entry.uncompressedSize,
+                    directory: entry.fileName.endsWith('/'),
+                };
+                try {
+                    assertSafeArchiveEntries([inventoryEntry], { ...limits, maxEntries: 1 });
+                    if (seen.has(inventoryEntry.path))
+                        throw new Error(`duplicate archive path: ${inventoryEntry.path}`);
+                    seen.add(inventoryEntry.path);
+                    entries.push(inventoryEntry);
+                    if (entries.length > limits.maxEntries) {
+                        throw new Error(`archive has more than ${limits.maxEntries} entries`);
+                    }
+                    compressedBytes += inventoryEntry.compressedSize;
+                    uncompressedBytes += inventoryEntry.uncompressedSize;
+                    if (uncompressedBytes > limits.maxTotalBytes) {
+                        throw new Error('archive decompression total exceeds the configured limit');
+                    }
+                    if (uncompressedBytes / Math.max(1, compressedBytes) > limits.maxCompressionRatio) {
+                        throw new Error('archive decompression ratio exceeds the configured limit');
+                    }
+                }
+                catch (error) {
+                    fail(error instanceof Error ? error : new Error(String(error)));
+                    return;
+                }
+                zip.readEntry();
+            });
+            zip.readEntry();
+        });
+    }
+    finally {
+        zip.close();
+    }
+}
+function openZip(path) {
+    return new Promise((resolvePromise, reject) => {
+        yauzl_1.default.open(path, { lazyEntries: true, decodeStrings: true, validateEntrySizes: true }, (error, zip) => {
+            if (error || !zip)
+                reject(error ?? new Error('unable to open ZIP archive'));
+            else
+                resolvePromise(zip);
+        });
+    });
+}
+async function openVerifiedZip(path, expectedSha256, expectedStat) {
+    const fd = await rawOpen(path);
+    let transferred = false;
+    try {
+        const [actualSha256, actualStat] = await Promise.all([sha256RawFd(path, fd), rawFstat(fd)]);
+        if (actualSha256 !== expectedSha256) {
+            throw new Error(`unexpected source SHA-256: expected ${expectedSha256}, received ${actualSha256}`);
+        }
+        if (actualStat.dev !== expectedStat.dev || actualStat.ino !== expectedStat.ino) {
+            throw new Error('source archive changed before extraction');
+        }
+        const zip = await openZipFd(fd);
+        transferred = true;
+        return zip;
+    }
+    finally {
+        if (!transferred)
+            await rawClose(fd);
+    }
+}
+function rawOpen(path) {
+    return new Promise((resolvePromise, reject) => {
+        (0, node_fs_1.open)(path, 'r', (error, fd) => error ? reject(error) : resolvePromise(fd));
+    });
+}
+function rawFstat(fd) {
+    return new Promise((resolvePromise, reject) => {
+        (0, node_fs_1.fstat)(fd, (error, stats) => error ? reject(error) : resolvePromise(stats));
+    });
+}
+function rawClose(fd) {
+    return new Promise((resolvePromise, reject) => {
+        (0, node_fs_1.close)(fd, (error) => error ? reject(error) : resolvePromise());
+    });
+}
+async function sha256RawFd(path, fd) {
+    const hash = (0, node_crypto_1.createHash)('sha256');
+    const stream = (0, node_fs_1.createReadStream)(path, { fd, start: 0, autoClose: false });
+    for await (const chunk of stream)
+        hash.update(chunk);
+    return hash.digest('hex');
+}
+function openZipFd(fd) {
+    return new Promise((resolvePromise, reject) => {
+        yauzl_1.default.fromFd(fd, { lazyEntries: true, decodeStrings: true, validateEntrySizes: true, autoClose: true }, (error, zip) => {
+            if (error || !zip)
+                reject(error ?? new Error('unable to open ZIP archive'));
+            else
+                resolvePromise(zip);
+        });
+    });
+}
+function openEntryStream(zip, entry) {
+    return new Promise((resolvePromise, reject) => {
+        zip.openReadStream(entry, (error, stream) => {
+            if (error || !stream)
+                reject(error ?? new Error(`unable to read ${entry.fileName}`));
+            else
+                resolvePromise(stream);
+        });
+    });
+}
+//# sourceMappingURL=archive.js.map

package/dist/sceneImport/archive.js.map

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

package/dist/sceneImport/bistroMaterialBake.d.ts

@@ -0,0 +1,20 @@
+import type { Document } from '@gltf-transform/core';
+import type { Object3D } from 'three';
+export type MaterialTextureRoles = {
+    map?: string;
+    normalMap?: string;
+    specularMap?: string;
+    emissiveMap?: string;
+};
+/** Records which basename a just-loaded Texture object came from, keyed by object identity. */
+export declare function recordTextureSource(texture: object, basename: string): void;
+/** Reads which basename each material's DiffuseColor/NormalMap/SpecularColor/EmissiveColor slot referenced. */
+export declare function collectMaterialTextureRoles(root: Object3D): Map<string, MaterialTextureRoles>;
+/** Resolves, decodes (DDS/TGA), converts (DirectX normal flip) and bounds-resizes only the textures materials actually reference. */
+export declare function decodeReferencedTextures(referencedBasenames: readonly string[], resolveTextures: (basenames: readonly string[]) => Promise<Map<string, Buffer>>, maxDimension: number, maxDecodedTextureBytes?: number): Promise<{
+    images: Map<string, Buffer>;
+    unsupported: string[];
+}>;
+/** Attaches decoded textures to the exported glTF materials by original FBX material name. */
+export declare function bakeMaterialTextures(document: Document, roles: Map<string, MaterialTextureRoles>, images: Map<string, Buffer>): void;
+export declare function installNodeDomShims(): void;

package/dist/sceneImport/bistroMaterialBake.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordTextureSource = recordTextureSource;
+exports.collectMaterialTextureRoles = collectMaterialTextureRoles;
+exports.decodeReferencedTextures = decodeReferencedTextures;
+exports.bakeMaterialTextures = bakeMaterialTextures;
+exports.installNodeDomShims = installNodeDomShims;
+const textureDecode_1 = require("./textureDecode");
+// Keyed by plain object identity, not by `instanceof Texture`: FBXLoader.js is loaded as
+// real ESM (three/examples/jsm has no CommonJS build), so under ts-jest/tsc's CommonJS
+// output its internal `import ... from 'three'` resolves the package's "import" condition
+// (three.module.js) while our own `import ... from 'three'` resolves "require" (three.cjs) —
+// two distinct classes for the same package. A `WeakMap<Texture, ...>` keyed via
+// `instanceof`-sensitive typing would silently never match; `object` sidesteps that entirely.
+const textureSourceNames = new WeakMap();
+/** Records which basename a just-loaded Texture object came from, keyed by object identity. */
+function recordTextureSource(texture, basename) {
+    textureSourceNames.set(texture, basename);
+}
+/** Reads which basename each material's DiffuseColor/NormalMap/SpecularColor/EmissiveColor slot referenced. */
+function collectMaterialTextureRoles(root) {
+    const roles = new Map();
+    const seen = new Set();
+    root.traverse((node) => {
+        const mesh = node;
+        if (!mesh.isMesh)
+            return;
+        const materials = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
+        for (const material of materials) {
+            if (seen.has(material))
+                continue;
+            seen.add(material);
+            const carrier = material;
+            const role = {};
+            const map = carrier.map ? textureSourceNames.get(carrier.map) : undefined;
+            const normalMap = carrier.normalMap ? textureSourceNames.get(carrier.normalMap) : undefined;
+            const specularMap = carrier.specularMap ? textureSourceNames.get(carrier.specularMap) : undefined;
+            const emissiveMap = carrier.emissiveMap ? textureSourceNames.get(carrier.emissiveMap) : undefined;
+            if (map)
+                role.map = map;
+            if (normalMap)
+                role.normalMap = normalMap;
+            if (specularMap)
+                role.specularMap = specularMap;
+            if (emissiveMap)
+                role.emissiveMap = emissiveMap;
+            if (Object.keys(role).length > 0)
+                roles.set(material.name || 'source-material', role);
+        }
+    });
+    return roles;
+}
+/** Resolves, decodes (DDS/TGA), converts (DirectX normal flip) and bounds-resizes only the textures materials actually reference. */
+async function decodeReferencedTextures(referencedBasenames, resolveTextures, maxDimension, maxDecodedTextureBytes = textureDecode_1.DEFAULT_MAX_DECODED_TEXTURE_BYTES) {
+    const images = new Map();
+    const unsupported = [];
+    if (referencedBasenames.length === 0)
+        return { images, unsupported };
+    const files = await resolveTextures(referencedBasenames);
+    for (const basename of referencedBasenames) {
+        const bytes = files.get(basename);
+        if (!bytes) {
+            unsupported.push(`${basename}: referenced by a material but not found in the source archive`);
+            continue;
+        }
+        try {
+            const extension = basename.toLowerCase().split('.').pop();
+            let decoded = extension === 'dds'
+                ? (0, textureDecode_1.decodeDds)(bytes, maxDecodedTextureBytes)
+                : extension === 'tga'
+                    ? (0, textureDecode_1.decodeTga)(bytes, maxDecodedTextureBytes)
+                    : undefined;
+            if (!decoded)
+                throw new Error(`unsupported texture extension ".${extension}"`);
+            if (/_normal\.(dds|tga)$/i.test(basename))
+                decoded = (0, textureDecode_1.directXNormalToGlNormal)(decoded);
+            images.set(basename, await (0, textureDecode_1.encodeBoundedPng)(decoded, maxDimension));
+        }
+        catch (error) {
+            unsupported.push(`${basename}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return { images, unsupported };
+}
+/** Attaches decoded textures to the exported glTF materials by original FBX material name. */
+function bakeMaterialTextures(document, roles, images) {
+    const textureCache = new Map();
+    const textureFor = (basename) => {
+        let texture = textureCache.get(basename);
+        if (texture)
+            return texture;
+        const bytes = images.get(basename);
+        if (!bytes)
+            return undefined;
+        texture = document.createTexture(basename).setImage(new Uint8Array(bytes)).setMimeType('image/png');
+        textureCache.set(basename, texture);
+        return texture;
+    };
+    for (const material of document.getRoot().listMaterials()) {
+        const role = roles.get(material.getName());
+        if (!role)
+            continue;
+        if (role.map) {
+            const texture = textureFor(role.map);
+            if (texture) {
+                material.setBaseColorTexture(texture);
+                const factor = material.getBaseColorFactor();
+                material.setBaseColorFactor([1, 1, 1, factor[3]]);
+            }
+        }
+        if (role.normalMap) {
+            const texture = textureFor(role.normalMap);
+            if (texture)
+                material.setNormalTexture(texture);
+        }
+        if (role.specularMap) {
+            const texture = textureFor(role.specularMap);
+            if (texture) {
+                material.setOcclusionTexture(texture);
+                material.setMetallicRoughnessTexture(texture);
+                material.setRoughnessFactor(1);
+                material.setMetallicFactor(1);
+            }
+        }
+        if (role.emissiveMap) {
+            const texture = textureFor(role.emissiveMap);
+            if (texture) {
+                material.setEmissiveTexture(texture);
+                material.setEmissiveFactor([1, 1, 1]);
+            }
+        }
+    }
+}
+class NodeFileReader {
+    result = null;
+    onloadend = null;
+    readAsArrayBuffer(blob) {
+        void blob.arrayBuffer().then((value) => { this.result = value; this.onloadend?.(); });
+    }
+    readAsDataURL(blob) {
+        void blob.arrayBuffer().then((value) => {
+            this.result = `data:${blob.type};base64,${Buffer.from(value).toString('base64')}`;
+            this.onloadend?.();
+        });
+    }
+}
+class NodeImage {
+    width = 1;
+    height = 1;
+    listeners = new Map();
+    addEventListener(type, listener) {
+        const listeners = this.listeners.get(type) ?? new Set();
+        listeners.add(listener);
+        this.listeners.set(type, listeners);
+    }
+    removeEventListener(type, listener) {
+        this.listeners.get(type)?.delete(listener);
+    }
+    set src(_value) {
+        queueMicrotask(() => this.listeners.get('load')?.forEach((listener) => listener({ target: this })));
+    }
+}
+function installNodeDomShims() {
+    const host = globalThis;
+    host.FileReader ??= NodeFileReader;
+    host.document ??= { createElementNS: () => new NodeImage() };
+    host.window ??= globalThis;
+}
+//# sourceMappingURL=bistroMaterialBake.js.map

package/dist/sceneImport/bistroMaterialBake.js.map

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

package/dist/sceneImport/bistroTexturePlan.d.ts

@@ -0,0 +1,6 @@
+export type BistroTexturePlanEntry = {
+    source: string;
+    role: 'base-color-opacity' | 'normal-directx' | 'packed-orm' | 'emissive' | 'unsupported';
+    conversion: string;
+};
+export declare function planBistroTextures(texturePaths: readonly string[]): BistroTexturePlanEntry[];

package/dist/sceneImport/bistroTexturePlan.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planBistroTextures = planBistroTextures;
+function planBistroTextures(texturePaths) {
+    return [...new Set(texturePaths)].sort().map((source) => classifyTexture(source));
+}
+function classifyTexture(source) {
+    const name = source.toLowerCase();
+    if (/_basecolor\.(dds|tga)$/.test(name)) {
+        return { source, role: 'base-color-opacity', conversion: 'decode DDS/TGA; map RGB to baseColor and alpha to opacity; embed converted texture' };
+    }
+    if (/_normal\.(dds|tga)$/.test(name)) {
+        return { source, role: 'normal-directx', conversion: 'decode DDS/TGA DirectX normal; invert green channel for glTF/OpenGL tangent space; embed converted texture' };
+    }
+    if (/_specular\.(dds|tga)$/.test(name)) {
+        return { source, role: 'packed-orm', conversion: 'decode without color-space conversion; preserve R=occlusion, G=roughness, B=metalness as packed glTF ORM' };
+    }
+    if (/_emissive\.(dds|tga)$/.test(name)) {
+        return { source, role: 'emissive', conversion: 'decode DDS/TGA RGB as emissive color and embed converted texture' };
+    }
+    return { source, role: 'unsupported', conversion: 'unrecognized Bistro texture role; add an explicit mapping before detail publication' };
+}
+//# sourceMappingURL=bistroTexturePlan.js.map

package/dist/sceneImport/bistroTexturePlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bistroTexturePlan.js","sourceRoot":"","sources":["../../src/sceneImport/bistroTexturePlan.ts"],"names":[],"mappings":";;AAMA,gDAEC;AAFD,SAAgB,kBAAkB,CAAC,YAA+B;IAChE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,SAAS,eAAe,CAAC,MAAc;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAClC,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,UAAU,EAAE,oFAAoF,EAAE,CAAC;IAClJ,CAAC;IACD,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,4GAA4G,EAAE,CAAC;IACtK,CAAC;IACD,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,0GAA0G,EAAE,CAAC;IAChK,CAAC;IACD,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,kEAAkE,EAAE,CAAC;IACtH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,qFAAqF,EAAE,CAAC;AAC5I,CAAC"}