@needle-tools/engine 4.15.0-next.f391a30 → 4.15.0

package/plugins/vite/local-files-internals.js

@@ -1,28 +0,0 @@
-export {
-    getActiveHandlers,
-    getFeatureBasePath,
-    handleWebXRProfiles,
-    makeLocal,
-    makeLocalHtml,
-} from './local-files-core.js';
-
-export {
-    analyzeProjectGlbs,
-    buildAutoPolicy,
-    collectAssetGlbs,
-    collectIndexHtmlSkyboxUrls,
-    collectNeedleComponentExtensionBlobs,
-    detectAutoPolicy,
-    getWebXRProfilesForMode,
-    hasAutoFeatureSelection,
-    readGlbJsonChunk,
-    resolveSkyboxSelectionUrls,
-    resolveSkyboxValueToUrl,
-    shouldHandleUrlInAutoMode,
-} from './local-files-analysis.js';
-
-export {
-    fixDracoRangeQueryProbe,
-    fixRelativeNewURL,
-    getRelativeToBasePath,
-} from './local-files-utils.js';

package/plugins/vite/local-files-types.d.ts

@@ -1,111 +0,0 @@
-/**
- * Shared type declarations for the local-files plugin family.
- * Referenced from local-files-utils.js, local-files-analysis.js, local-files-core.js, etc.
- */
-
-export interface UrlHandler {
-    name: string;
-    /** RegExp with the /g flag — match group 1 must capture the URL. */
-    pattern: RegExp;
-    type: "binary" | "css" | "decoder-dir" | "webxr-profiles";
-    feature: string;
-    decoderFiles?: string[];
-    localDirName?: string;
-}
-
-export interface LocalizationStats {
-    fileCount: number;
-    totalBytes: number;
-    mimeCounts: Map<string, number>;
-}
-
-export interface LocalizationOptions {
-    features?: string | string[];
-    excludeFeatures?: string[];
-    /** URL substrings or RegExps to skip. */
-    exclude?: (string | RegExp)[];
-    /** @deprecated use `exclude` */
-    excludeUrls?: string[];
-    /** e.g. "facebook-instant", "discord" */
-    platform?: string;
-    /** Only process files inside these npm packages. */
-    packages?: string[];
-    /** Skybox selection: URL, magic keyword, array of those, or "all". */
-    skybox?: string | string[];
-    /** WebXR controller profile mode: "minimal" | "quest" | "pico" | "all" */
-    webxr?: string;
-    templateExpansions?: Array<{
-        cdnPrefix: string;
-        variables: Record<string, string[]>;
-        localPrefix?: string;
-    }>;
-    /** Used when makeFilesLocal is an object — set to false to disable. */
-    enabled?: boolean;
-}
-
-export interface AutoPolicy {
-    features: Set<string>;
-    hasWebXR: boolean;
-    hasVideoPlayer: boolean;
-    allowedSkyboxUrls: Set<string> | null;
-    selectedWebXRProfiles: string[];
-}
-
-export interface VitePluginContext {
-    emitFile(asset: {
-        type: "asset" | "chunk";
-        fileName?: string;
-        name?: string;
-        source?: string | Uint8Array;
-    }): string;
-    getFileName(referenceId: string): string;
-}
-
-export interface LocalizationContext {
-    pluginContext: VitePluginContext | null;
-    cache: {
-        addToCache(key: string, value: Buffer | string): void;
-        getFromCache(key: string): Buffer | string | null;
-        readonly map: Map<string, Buffer | string>;
-    };
-    command: "build" | "serve";
-    viteConfig: { build?: { assetsDir?: string } } | null;
-    options: LocalizationOptions;
-    autoPolicy: AutoPolicy | null;
-    failedDownloads: Map<string, string>;
-    localizationStats: LocalizationStats;
-}
-
-export interface SceneAnalysisReport {
-    hasWebXRComponent: boolean;
-    hasVideoPlayerComponent: boolean;
-    extensions: Set<string>;
-    componentTypes: Set<string>;
-    componentCounts: Map<string, number>;
-    glbFileCount: number;
-    gltfFileCount: number;
-    totalSceneFileCount: number;
-    totalNodeCount: number;
-    totalVertexCount: number;
-    totalTextureCount: number;
-    totalMeshCount: number;
-    totalPrimitiveCount: number;
-    dracoPrimitiveCount: number;
-    meshoptBufferViewCount: number;
-}
-
-export interface SceneFile {
-    path: string;
-    type: "glb" | "gltf";
-}
-
-export interface NeedleComponentEntry {
-    name?: string;
-    type?: string;
-    guid?: string;
-}
-
-export interface NeedleComponentExtension {
-    components?: NeedleComponentEntry[];
-    builtin_components?: NeedleComponentEntry[];
-}

package/plugins/vite/local-files-utils.js

@@ -1,359 +0,0 @@
-// @ts-check
-import https from 'https';
-import http from 'http';
-import { createHash } from 'crypto';
-import { needleLog, setTransientLogLineCleaner } from './logging.js';
-
-/** @typedef {import('./local-files-types.js').LocalizationContext} LocalizationContext */
-
-const debug = false;
-const DOWNLOAD_TIMEOUT_MS = 30_000;
-const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
-let spinnerIndex = 0;
-let spinnerActive = false;
-
-setTransientLogLineCleaner(() => clearSpinnerLine());
-
-function clearSpinnerLine() {
-    if (!process.stdout.isTTY || !spinnerActive) return;
-    process.stdout.write("\r\x1b[2K");
-    spinnerActive = false;
-}
-
-/** @param {string} url */
-function updateMakeLocalProgress(url) {
-    if (!process.stdout.isTTY) {
-        needleLog("needle:local-files", "Make local: " + url, "log", { dimBody: true, showHeader: false });
-        return;
-    }
-    const frame = SPINNER_FRAMES[spinnerIndex++ % SPINNER_FRAMES.length];
-    const maxLength = Math.max(24, (process.stdout.columns || 120) - 4);
-    const message = `Make local: ${url}`;
-    const text = message.length > maxLength ? `${message.slice(0, Math.max(0, maxLength - 1))}…` : message;
-    process.stdout.write(`\r\x1b[2K${frame} ${text}\x1b[0K`);
-    spinnerActive = true;
-}
-
-export function finishMakeLocalProgress() {
-    clearSpinnerLine();
-}
-
-/**
- * @param {string} src
- * @param {string} search
- * @param {string} replacement
- * @returns {string}
- */
-export function replaceAll(src, search, replacement) {
-    return src.split(search).join(replacement);
-}
-
-export class Cache {
-    /** @type {Map<string, Buffer|string>} */
-    __cache = new Map();
-    /**
-     * @param {string} key
-     * @param {Buffer|string} value
-     */
-    addToCache(key, value) {
-        if (debug && this.__cache.has(key)) {
-            console.warn("Key " + key + " already exists in cache, overwriting.");
-        }
-        this.__cache.set(key, value);
-    }
-    /**
-     * @param {string} key
-     * @returns {Buffer|string|null}
-     */
-    getFromCache(key) {
-        return this.__cache.get(key) ?? null;
-    }
-    get map() {
-        return this.__cache;
-    }
-}
-
-/**
- * @param {string} path
- * @param {string} basePath
- * @returns {string}
- */
-export function getRelativeToBasePath(path, basePath) {
-    const normalizedPath = normalizeWebPath(path);
-    const normalizedBasePath = normalizeWebPath(basePath);
-
-    if (!normalizedBasePath) return normalizedPath;
-
-    if (normalizedPath.startsWith(normalizedBasePath)) {
-        return "./" + normalizedPath.substring(normalizedBasePath.length);
-    }
-
-    const baseSegments = normalizedBasePath.replace(/\/+$/g, "").split("/").filter(Boolean);
-    const backtrack = baseSegments.map(() => "..").join("/");
-    return (backtrack ? backtrack + "/" : "") + normalizedPath;
-}
-
-/**
- * @param {string} path
- * @returns {string}
- */
-export function normalizeWebPath(path) {
-    if (!path) return "";
-    return path.replace(/\\/g, "/");
-}
-
-/**
- * @param {string} path
- * @returns {string}
- */
-export function ensureTrailingSlash(path) {
-    if (!path) return "";
-    return path.endsWith("/") ? path : path + "/";
-}
-
-/**
- * @param {string} src
- * @returns {string}
- */
-export function fixRelativeNewURL(src) {
-    src = src.replace(
-        /(?<==\s*)(["'])((?:(?:\.{1,2}\/)|\/)?ext\/[^"']*\/)\1/g,
-        (/** @type {string} */ match, /** @type {string} */ quote, /** @type {string} */ path) => {
-            const runtimePath = path.startsWith("/ext/") ? path.substring(1) : path;
-            return `new URL(${quote}${runtimePath}${quote}, self.location?.href || ${quote}${quote}).href`;
-        }
-    );
-
-    src = src.replace(
-        /new\s+URL\s*\(\s*(["'`])((?:(?:\.{1,2}\/)|\/)?ext\/[^"'`]+)\1\s*\)/g,
-        (/** @type {string} */ match, /** @type {string} */ quote, /** @type {string} */ path) => {
-            const runtimePath = path.startsWith("/ext/") ? path.substring(1) : path;
-            return `new URL(${quote}${runtimePath}${quote}, self.location?.href)`;
-        }
-    );
-
-    return src;
-}
-
-/**
- * @param {string} src
- * @returns {string}
- */
-export function fixDracoRangeQueryProbe(src) {
-    return src;
-}
-
-/**
- * @param {string} path
- * @param {string|Buffer} content
- * @returns {string}
- */
-export function getValidFilename(path, content) {
-    if (path.startsWith("http:") || path.startsWith("https:")) {
-        const url = new URL(path);
-        const pathParts = url.pathname.split('/');
-        const filename = pathParts.pop() || 'file';
-        const nameParts = filename.split('.');
-        const nameWithoutExt = nameParts.slice(0, -1).join('.');
-        path = nameWithoutExt + "-" + createContentMd5(url.host + pathParts.join('/')) + "." + (nameParts.pop() || 'unknown');
-    }
-
-    let name = path.replace(/[^a-z0-9_\-\.\+]/gi, '-');
-
-    const maxLength = 200;
-    if (path.length > maxLength) {
-        const hash = createContentMd5(content);
-        let ext = "";
-        const extIndex = name.lastIndexOf('.');
-        if (extIndex !== -1) {
-            ext = name.substring(extIndex + 1);
-            name = name.substring(0, extIndex);
-        }
-        name = name.substring(0, maxLength) + "-" + hash + (ext ? "." + ext : '');
-    }
-    return name;
-}
-
-/**
- * @param {string} str
- * @returns {string}
- */
-function createContentMd5(str) {
-    return createHash('md5')
-        .update(str)
-        .digest('hex');
-}
-
-/**
- * @param {string} url
- * @returns {Promise<string>}
- */
-export function downloadText(url) {
-    return new Promise((res, rej) => {
-        const timer = setTimeout(() => {
-            rej(new Error("Download timed out after " + DOWNLOAD_TIMEOUT_MS + "ms: " + url));
-        }, DOWNLOAD_TIMEOUT_MS);
-
-        const req = (url.startsWith("http://") ? http.get(url, (response) => {
-            if (response.statusCode && response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
-                clearTimeout(timer);
-                return downloadText(response.headers.location).then(res).catch(rej);
-            }
-
-            if (response.statusCode !== 200) {
-                clearTimeout(timer);
-                clearSpinnerLine();
-                rej(new Error("Failed to download (" + response.statusCode + "): " + url));
-                return;
-            }
-
-            updateMakeLocalProgress(url);
-
-            let data = '';
-            response.on('data', (/** @type {Buffer|string} */ chunk) => {
-                data += chunk;
-            });
-            response.on('end', () => {
-                clearTimeout(timer);
-                res(data);
-            });
-            response.on('error', (err) => {
-                clearTimeout(timer);
-                rej(err);
-            });
-        }) : https.get(url, (response) => {
-            if (response.statusCode && response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
-                clearTimeout(timer);
-                return downloadText(response.headers.location).then(res).catch(rej);
-            }
-
-            if (response.statusCode !== 200) {
-                clearTimeout(timer);
-                clearSpinnerLine();
-                rej(new Error("Failed to download (" + response.statusCode + "): " + url));
-                return;
-            }
-
-            updateMakeLocalProgress(url);
-
-            let data = '';
-            response.on('data', (/** @type {Buffer|string} */ chunk) => {
-                data += chunk;
-            });
-            response.on('end', () => {
-                clearTimeout(timer);
-                res(data);
-            });
-            response.on('error', (err) => {
-                clearTimeout(timer);
-                rej(err);
-            });
-        }));
-        req.on('error', (err) => {
-            clearTimeout(timer);
-            clearSpinnerLine();
-            rej(err);
-        });
-    });
-}
-
-/**
- * @param {string} url
- * @returns {Promise<Buffer>}
- */
-export function downloadBinary(url) {
-    return new Promise((res, rej) => {
-        const timer = setTimeout(() => {
-            rej(new Error("Download timed out after " + DOWNLOAD_TIMEOUT_MS + "ms: " + url));
-        }, DOWNLOAD_TIMEOUT_MS);
-
-        const req = (url.startsWith("http://") ? http.get(url, (response) => {
-            if (response.statusCode && response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
-                clearTimeout(timer);
-                return downloadBinary(response.headers.location).then(res).catch(rej);
-            }
-
-            if (response.statusCode !== 200) {
-                clearTimeout(timer);
-                clearSpinnerLine();
-                rej(new Error("Failed to download (" + response.statusCode + "): " + url));
-                return;
-            }
-
-            updateMakeLocalProgress(url);
-
-            const chunks = /** @type {Buffer[]} */ ([]);
-            response.on('data', (/** @type {Buffer|string} */ chunk) => {
-                chunks.push(chunk);
-            });
-            response.on('end', () => {
-                clearTimeout(timer);
-                res(Buffer.concat(chunks));
-            });
-            response.on('error', (err) => {
-                clearTimeout(timer);
-                rej(err);
-            });
-        }) : https.get(url, (response) => {
-            if (response.statusCode && response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
-                clearTimeout(timer);
-                return downloadBinary(response.headers.location).then(res).catch(rej);
-            }
-
-            if (response.statusCode !== 200) {
-                clearTimeout(timer);
-                clearSpinnerLine();
-                rej(new Error("Failed to download (" + response.statusCode + "): " + url));
-                return;
-            }
-
-            updateMakeLocalProgress(url);
-
-            const chunks = /** @type {Buffer[]} */ ([]);
-            response.on('data', (/** @type {Buffer|string} */ chunk) => {
-                chunks.push(chunk);
-            });
-            response.on('end', () => {
-                clearTimeout(timer);
-                res(Buffer.concat(chunks));
-            });
-            response.on('error', (err) => {
-                clearTimeout(timer);
-                rej(err);
-            });
-        }));
-        req.on('error', (err) => {
-            clearTimeout(timer);
-            clearSpinnerLine();
-            rej(err);
-        });
-    });
-}
-
-/**
- * @param {LocalizationContext} context
- * @param {string} url
- * @param {unknown} err
- */
-export function recordFailedDownload(context, url, err) {
-    if (!url || !context?.failedDownloads) return;
-    const message = err?.message ? String(err.message) : "";
-    if (!context.failedDownloads.has(url)) {
-        context.failedDownloads.set(url, message);
-    }
-}
-
-/**
- * @param {string} url
- * @returns {string}
- */
-export function getShortUrlName(url) {
-    try {
-        const parsed = new URL(url);
-        const parts = parsed.pathname.split("/").filter(Boolean);
-        return parts[parts.length - 1] || parsed.host;
-    }
-    catch {
-        return url;
-    }
-}

package/plugins/vite/logging.js

@@ -1,129 +0,0 @@
-import picocolors from 'picocolors';
-
-const { createColors, isColorSupported } = picocolors;
-
-const colors = createColors(isColorSupported);
-/** @type {null | (() => void)} */
-let transientLogLineCleaner = null;
-
-function getConsoleMethod(level) {
-    if (level === 'error') return console.error;
-    if (level === 'warn') return console.warn;
-    return console.log;
-}
-
-function colorBodyByLevel(level, text) {
-    if (!isColorSupported) return text;
-    if (level === 'error') return colors.red(text);
-    if (level === 'warn') return colors.yellow(text);
-    return text;
-}
-
-function normalizeMessage(message) {
-    if (Array.isArray(message)) return message.join("\n");
-    if (message === undefined || message === null) return "";
-    return String(message);
-}
-
-function formatHeader(pluginName) {
-    if (!isColorSupported) return `[${pluginName}]`;
-
-    const name = String(pluginName ?? "");
-    let prefix = "";
-    let suffix = name;
-    if (name.startsWith("needle-")) {
-        prefix = "needle-";
-        suffix = name.substring("needle-".length);
-    }
-    else if (name.startsWith("needle:")) {
-        prefix = "needle:";
-        suffix = name.substring("needle:".length);
-    }
-
-    const open = colors.green("[");
-    const close = colors.green("]");
-    if (!prefix.length) {
-        return `${open}${colors.bold(colors.green(name))}${close}`;
-    }
-    const prefixStyled = colors.green(prefix);
-    const suffixStyled = colors.bold(colors.green(suffix));
-    return `${open}${prefixStyled}${suffixStyled}${close}`;
-}
-
-/**
- * @param {string} pluginName
- * @param {string | string[]} message
- * @param {'log' | 'warn' | 'error'} [level='log']
- * @param {{ dimBody?: boolean, leadingNewline?: boolean, showHeader?: boolean }} [options]
- */
-export function needleLog(pluginName, message, level = 'log', options = undefined) {
-    if (typeof transientLogLineCleaner === "function") {
-        transientLogLineCleaner();
-    }
-    const log = getConsoleMethod(level);
-    const headerText = formatHeader(pluginName);
-    const bodyText = normalizeMessage(message);
-    const dimBody = options?.dimBody ?? (level === 'log');
-    const leadingNewline = options?.leadingNewline === true;
-    const showHeader = options?.showHeader !== false;
-
-    if (isColorSupported) {
-        const header = `\x1b[0m${headerText}`;
-        const leveledBody = colorBodyByLevel(level, bodyText);
-        const body = bodyText.length > 0
-            ? (dimBody ? leveledBody.split('\n').map(l => colors.dim(l)).join('\n') : leveledBody)
-            : "";
-        const payloadCore = showHeader
-            ? (body.length > 0 ? `${header}\n${body}\n` : `${header}\n`)
-            : (body.length > 0 ? `${body}\n` : "");
-        const payload = leadingNewline ? `\n${payloadCore}` : payloadCore;
-        log(payload);
-        return;
-    }
-
-    if (bodyText.length > 0) {
-        const out = showHeader ? `${headerText} ${bodyText}` : bodyText;
-        log(leadingNewline ? `\n${out}` : out);
-    }
-    else {
-        const out = showHeader ? headerText : "";
-        if (out.length > 0) {
-            log(leadingNewline ? `\n${out}` : out);
-        }
-    }
-}
-
-/**
- * @param {string} pluginName
- * @param {string[]} lines
- * @param {'log' | 'warn' | 'error'} [level='log']
- */
-export function needleLogLines(pluginName, lines, level = 'log') {
-    needleLog(pluginName, lines.join("\n"), level);
-}
-
-export function needleSupportsColor() {
-    return isColorSupported;
-}
-
-export function needleBlue(text) {
-    const value = String(text ?? "");
-    return isColorSupported ? colors.blue(value) : value;
-}
-
-export function needleDim(text) {
-    const value = String(text ?? "");
-    return isColorSupported ? colors.dim(value) : value;
-}
-
-export function needleGreenBold(text) {
-    const value = String(text ?? "");
-    return isColorSupported ? colors.bold(colors.green(value)) : value;
-}
-
-/**
- * @param {(() => void) | null} cleaner
- */
-export function setTransientLogLineCleaner(cleaner) {
-    transientLogLineCleaner = typeof cleaner === "function" ? cleaner : null;
-}