depflow 2.0.0-dev.1 → 2.0.0-dev.3

package/build/support/File.js

@@ -0,0 +1,123 @@
+import { promises as FS } from 'node:fs';
+import { Utilities } from 'vortez';
+export class File {
+    /**
+     * Checks if a given path exists in the file system.
+     * It uses fs.access to determine if the path is accessible, returning true if it exists and false if it does not.
+     * This method is useful for verifying the presence of files or directories before attempting to read, write, or perform other operations on them, helping to prevent errors related to non-existent paths.
+     * @param path The file system path to check for existence.
+     * @returns A promise that resolves to true if the path exists, or false if it does not.
+     */
+    static async exists(path) {
+        try {
+            await FS.access(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Checks if the given path is a file.
+     * It uses fs.stat to retrieve the file system statistics for the path and checks if it is a file using the isFile method.
+     * If the path does not exist or is not a file, it returns false.
+     * This method is useful for validating that a specific path points to a file before performing operations that require a file, such as reading or writing content.
+     * It helps to ensure that the expected file structure is in place and can prevent errors related to invalid paths or types.
+     * @param path The file system path to check.
+     * @returns A promise that resolves to true if the path is a file, or false if it is not.
+     * @throws Will throw an error if the path does not exist or is not a file.
+     */
+    static async isFile(path) {
+        try {
+            const stat = await FS.stat(path);
+            return stat.isFile();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Checks if the given path is a directory.
+     * It uses fs.stat to retrieve the file system statistics for the path and checks if it is a directory using the isDirectory method.
+     * If the path does not exist or is not a directory, it returns false.
+     * This method is useful for validating that a specific path points to a directory before performing operations that require a directory, such as creating files within it or listing its contents.
+     * It helps to ensure that the expected directory structure is in place and can prevent errors related to invalid paths or types.
+     * @param path The file system path to check.
+     * @returns A promise that resolves to true if the path is a directory, or false if it is not.
+     * @throws Will throw an error if the path does not exist or is not a directory.
+     */
+    static async isDirectory(path) {
+        try {
+            const stat = await FS.stat(path);
+            return stat.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Reads the content of a file at the specified path using the given encoding (defaulting to 'utf-8').
+     * It first checks if the path is a file using the isFile method, and if it is not, it throws an error indicating that the path is not a file.
+     * If the path is valid, it uses fs.readFile to read the content of the file and returns it as a string.
+     * This method is essential for safely reading files while ensuring that the provided path points to a valid file, preventing errors related to invalid paths or types.
+     * @param path The file system path of the file to read.
+     * @param encoding The character encoding to use when reading the file (default is 'utf-8').
+     * @returns A promise that resolves to the content of the file as a string.
+     * @throws Will throw an error if the path does not point to a valid file.
+     */
+    static async read(path, encoding = 'utf-8') {
+        if (!await this.isFile(path))
+            throw new Error(`Path ${path} is not a file.`);
+        return await FS.readFile(path, encoding);
+    }
+    /**
+     * Writes the specified content to a file at the given path using the provided encoding (defaulting to 'utf-8').
+     * It uses fs.writeFile to write the content to the file, creating the file if it does not exist or overwriting it if it does.
+     * This method is crucial for saving data to files while ensuring that the content is properly encoded and that any necessary directories are in place before writing.
+     * It can be used for a variety of purposes, such as saving configuration files, logs, or any other data that needs to be persisted in the file system.
+     * @param path The file system path where the content should be written.
+     * @param content The string content to write to the file.
+     * @param encoding The character encoding to use when writing the file (default is 'utf-8').
+     * @returns A promise that resolves when the write operation is complete.
+     */
+    static async write(path, content, encoding = 'utf-8') {
+        await FS.writeFile(path, content, encoding);
+    }
+    /**
+     * Creates a directory at the specified path with the given options (such as recursive creation). It first checks if the path already exists using the exists method, and if it does, it throws an error to prevent overwriting existing files or directories. If the path does not exist, it uses fs.mkdir to create the directory according to the provided options. This method is essential for safely creating directories while ensuring that existing paths are not unintentionally overwritten, and it can be used to set up necessary directory structures for applications or projects.
+     * @param path The file system path where the directory should be created.
+     * @param options Optional settings for directory creation, such as { recursive: true } to create parent directories if they do not exist.
+     * @returns A promise that resolves when the directory has been successfully created.
+     * @throws Will throw an error if the path already exists or if there is an issue during directory creation.
+     */
+    static async mkdir(path, options) {
+        if (await this.exists(path))
+            throw new Error(`Path ${path} already exists.`);
+        await FS.mkdir(path, options);
+    }
+    /**
+     * Recursively retrieves all files with specified extensions from a given directory.
+     * It uses fs.readdir with the "withFileTypes" option to efficiently determine if an entry is a file or a directory.
+     * For directories, it calls itself recursively to gather files from subdirectories. For files, it checks if their extensions match the provided list and includes them in the result.
+     * This method returns a flat array of file paths that can be processed by the path resolver.
+     * @param dir The directory to scan for files.
+     * @param extensions An array of file extensions to filter the results (e.g., ['.js', '.ts']).
+     * @returns A promise that resolves to an array of file paths matching the specified extensions.
+     */
+    static async getAllFiles(dir, extensions) {
+        const result = [];
+        const entries = await FS.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = Utilities.Path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                const files = await File.getAllFiles(fullPath, extensions);
+                result.push(...files);
+            }
+            else if (extensions.some(ext => fullPath.endsWith(ext)))
+                result.push(fullPath);
+        }
+        return result;
+    }
+}
+export default File;
+//# sourceMappingURL=File.js.map

package/build/support/File.js.map

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

package/build/support/Git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Git.js","sourceRoot":"","sources":["../../src/support/Git.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,YAAY,MAAM,eAAe,CAAC;AAEzC,MAAM,GAAG;IACL;;;;OAIG;IACK,MAAM,CAAC,IAAI,CAAC,OAAe;QAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnC,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAG,CAAC,CAAC;YAEhE,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,WAAW,GAAG,EAAE,CAAC;YAErB,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC/D,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1C,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACb,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;oBAC7C,OAAO,CAAC,MAAM,CAAC,CAAC;gBACpB,CAAC;qBAAM,CAAC;oBACJ,MAAM,YAAY,GAAG,4BAA4B,IAAI,KAAK,OAAO,KAAK,WAAW,IAAI,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;oBACrG,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;gBACpC,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;IACD;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,IAAY,EAAE,MAAe;QACjE,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,IAAI,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,MAAc;QACnD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,WAAW,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,MAAe;QAClD,MAAM,OAAO,GAAG,UAAU,IAAI,OAAO,CAAC;QACtC,IAAI,MAAM;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,aAAa,MAAM,EAAE,CAAC,CAAC;;YACzD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;CACJ;AAED,eAAe,GAAG,CAAC"}

package/build/support/PathFixer.d.ts

@@ -0,0 +1,36 @@
+import { schemas } from '../config/schemas.js';
+export declare class PathResolver {
+    readonly config: schemas.config['infer'];
+    readonly options: PathResolver.Options;
+    readonly projectRoot: string;
+    static readonly IMPORT_REGEX: RegExp;
+    static readonly PROJECT_ROOT: string;
+    static readonly EXTENSIONS: string[];
+    absoluteOutDir: string;
+    private _compiledAliases;
+    constructor(config: schemas.config['infer'], options?: PathResolver.Options, projectRoot?: string);
+    /**
+     * Compila todos los resolvers (normales y npm) en una lista plana para el procesador.
+     */
+    get aliases(): PathResolver.ResolvedAlias[];
+    run(): Promise<void>;
+    private processFile;
+    private replaceLogic;
+    /**
+     * Watcher optimizado con debounce
+     */
+    watch(): Promise<void>;
+    static getAllFiles(dir: string, extensions: string[]): Promise<string[]>;
+}
+export declare namespace PathResolver {
+    interface Options {
+        mode: 'local' | 'cdn';
+    }
+    interface ResolvedAlias {
+        alias: string;
+        target: string;
+        isWildcard: boolean;
+        isRemote: boolean;
+    }
+}
+export default PathResolver;

package/build/support/PathFixer.js

@@ -0,0 +1,161 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Utility for path resolution with Local/CDN support and dual path fixing.
+ * @license Apache-2.0
+ */
+import path from 'path';
+import syncFs, { promises as fs } from 'fs';
+import { Logger, Utilities } from 'vortez';
+import File from '../support/File.js';
+const logger = new Logger({ prefix: 'PathResolver' });
+export class PathResolver {
+    config;
+    options;
+    projectRoot;
+    static IMPORT_REGEX = /(from\s+['"])([^'"]+)(['"])/g;
+    static PROJECT_ROOT = process.cwd();
+    static EXTENSIONS = ['.js', '.d.ts', '.mjs', '.cjs'];
+    absoluteOutDir;
+    _compiledAliases = null;
+    constructor(config, options = { mode: 'local' }, projectRoot = PathResolver.PROJECT_ROOT) {
+        this.config = config;
+        this.options = options;
+        this.projectRoot = projectRoot;
+        // Determinamos el outDir basándonos en la configuración
+        // Si no se especifica, asumimos la raíz del proyecto
+        const outDir = config.outDir;
+        const fullPath = path.isAbsolute(outDir)
+            ? outDir
+            : path.join(projectRoot, outDir);
+        this.absoluteOutDir = path.resolve(fullPath);
+    }
+    /**
+     * Compila todos los resolvers (normales y npm) en una lista plana para el procesador.
+     */
+    get aliases() {
+        if (this._compiledAliases)
+            return this._compiledAliases;
+        const result = [];
+        const allDeps = [
+            ...(this.config.dependencies || []),
+            ...(this.config.npmDependencies || [])
+        ];
+        for (const dep of allDeps) {
+            if (!dep.resolver)
+                continue;
+            const { alias, target } = dep.resolver;
+            const isWildcard = alias.endsWith('/*');
+            const cleanAlias = alias.replace(/\/\*$/, '');
+            // Resolución del destino final
+            let finalTarget;
+            if (this.options.mode === 'cdn' && typeof target === 'object' && target.cdn) {
+                finalTarget = target.cdn;
+            }
+            else {
+                const localPath = typeof target === 'string' ? target : target.local;
+                // El target local se resuelve relativo a la raíz del proyecto
+                finalTarget = path.resolve(this.projectRoot, localPath.replace(/\/\*$/, ''));
+            }
+            result.push({
+                alias: cleanAlias,
+                target: finalTarget,
+                isWildcard,
+                isRemote: finalTarget.startsWith('http')
+            });
+        }
+        this._compiledAliases = result;
+        return result;
+    }
+    async run() {
+        logger.log(`&C2Starting path resolver in &C3${this.options.mode} &C2mode...`);
+        if (!await File.exists(this.absoluteOutDir)) {
+            return void logger.warn(`The output directory &C4${this.absoluteOutDir}&R does not exist.`);
+        }
+        const files = await PathResolver.getAllFiles(this.absoluteOutDir, PathResolver.EXTENSIONS);
+        logger.log(`&C2Found &C3${files.length} &C2files in &C4${this.absoluteOutDir}.`);
+        let rewrittenCount = 0;
+        for (const file of files) {
+            if (await this.processFile(file))
+                rewrittenCount++;
+        }
+        logger.log(`&C2Path aliases resolved in &C3${rewrittenCount} &C2files.`);
+    }
+    async processFile(file) {
+        const content = await fs.readFile(file, 'utf8');
+        const newContent = content.replace(PathResolver.IMPORT_REGEX, (match, prefix, modulePath, suffix) => {
+            return this.replaceLogic(file, match, prefix, modulePath, suffix);
+        });
+        if (content === newContent)
+            return false;
+        await fs.writeFile(file, newContent, 'utf8');
+        return true;
+    }
+    replaceLogic(file, match, prefix, modulePath, suffix) {
+        const aliasCfg = this.aliases.find(c => c.isWildcard ? modulePath.startsWith(`${c.alias}/`) : modulePath === c.alias);
+        if (!aliasCfg)
+            return match;
+        let resolvedPath;
+        // 1. Manejo de Wildcards
+        if (aliasCfg.isWildcard) {
+            const subPath = modulePath.substring(aliasCfg.alias.length + 1);
+            resolvedPath = aliasCfg.isRemote
+                ? `${aliasCfg.target}/${subPath}`
+                : path.join(aliasCfg.target, subPath);
+        }
+        else {
+            resolvedPath = aliasCfg.target;
+        }
+        // 2. Si es remoto (CDN), devolvemos la URL tal cual
+        if (aliasCfg.isRemote) {
+            return `${prefix}${resolvedPath}${suffix}`;
+        }
+        // 3. Si es local, calculamos la ruta relativa desde el archivo actual
+        const currentFileDir = path.dirname(file);
+        let relativeTarget = path.relative(currentFileDir, resolvedPath);
+        if (!relativeTarget.startsWith('.'))
+            relativeTarget = `./${relativeTarget}`;
+        // Normalizamos para asegurar compatibilidad con imports de JS (puntos y barras)
+        const finalTarget = Utilities.Path.normalize(relativeTarget);
+        return `${prefix}${finalTarget}${suffix}`;
+    }
+    /**
+     * Watcher optimizado con debounce
+     */
+    async watch() {
+        await this.run();
+        logger.log(`&C2Watching for changes in &C4${this.absoluteOutDir}...`);
+        const queue = new Map();
+        syncFs.watch(this.absoluteOutDir, { recursive: true }, (eventType, filename) => {
+            if (!filename || !PathResolver.EXTENSIONS.some(ext => filename.endsWith(ext)))
+                return;
+            const fullPath = path.join(this.absoluteOutDir, filename);
+            if (queue.has(fullPath))
+                clearTimeout(queue.get(fullPath));
+            queue.set(fullPath, setTimeout(async () => {
+                try {
+                    if (await this.processFile(fullPath)) {
+                        logger.log(`&C2File &C4${filename}&C2 updated.`);
+                    }
+                }
+                catch (e) { }
+                queue.delete(fullPath);
+            }, 300));
+        });
+    }
+    static async getAllFiles(dir, extensions) {
+        const result = [];
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                result.push(...(await PathResolver.getAllFiles(fullPath, extensions)));
+            }
+            else if (extensions.some(ext => fullPath.endsWith(ext))) {
+                result.push(fullPath);
+            }
+        }
+        return result;
+    }
+}
+export default PathResolver;
+//# sourceMappingURL=PathFixer.js.map

package/build/support/PathFixer.js.map

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

package/build/support/PathResolver/AliasCompiler.d.ts

@@ -0,0 +1,25 @@
+import schemas from '../../config/schemas.js';
+export declare class AliasCompiler {
+    private projectRoot;
+    constructor(projectRoot: string);
+    /**
+     * Compiles alias configurations from the provided config object into a structured format for path resolution.
+     * It processes both regular and wildcard aliases, resolving local paths to absolute paths based on the project root.
+     * The resulting compiled aliases include information about the alias name, whether it's a wildcard, and its target paths for local and CDN usage.
+     * @param config The configuration object containing dependencies with resolver entries to compile into aliases.
+     * @returns An array of compiled alias objects ready for use in path resolution.
+     */
+    compile(config: schemas.config['infer']): AliasCompiler.CompiledAlias[];
+}
+export declare namespace AliasCompiler {
+    interface Target {
+        local: string;
+        cdn?: string;
+    }
+    interface CompiledAlias {
+        alias: string;
+        targets: Target;
+        isWildcard: boolean;
+    }
+}
+export default AliasCompiler;

package/build/support/PathResolver/AliasCompiler.js

@@ -0,0 +1,39 @@
+import path from 'node:path';
+import Utils from './Utils.js';
+export class AliasCompiler {
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * Compiles alias configurations from the provided config object into a structured format for path resolution.
+     * It processes both regular and wildcard aliases, resolving local paths to absolute paths based on the project root.
+     * The resulting compiled aliases include information about the alias name, whether it's a wildcard, and its target paths for local and CDN usage.
+     * @param config The configuration object containing dependencies with resolver entries to compile into aliases.
+     * @returns An array of compiled alias objects ready for use in path resolution.
+     */
+    compile(config) {
+        const result = [];
+        const allDeps = [...(config.dependencies || []), ...(config.npmDependencies || [])];
+        for (const dep of allDeps) {
+            if (typeof dep !== 'object' || !dep.resolver)
+                continue;
+            for (const entry of dep.resolver) {
+                const isWildcard = Utils.isWildcard(entry.alias);
+                const alias = Utils.removeWildcardSuffix(entry.alias);
+                const rawLocal = typeof entry.target === 'string' ? entry.target : entry.target.local;
+                const localTarget = path.isAbsolute(rawLocal)
+                    ? Utils.removeWildcardSuffix(rawLocal)
+                    : path.resolve(this.projectRoot, Utils.removeWildcardSuffix(rawLocal));
+                let cdnTarget;
+                if (typeof entry.target === 'object' && entry.target.cdn) {
+                    cdnTarget = Utils.removeWildcardSuffix(entry.target.cdn);
+                }
+                result.push({ alias, isWildcard, targets: { local: localTarget, cdn: cdnTarget } });
+            }
+        }
+        return result;
+    }
+}
+export default AliasCompiler;
+//# sourceMappingURL=AliasCompiler.js.map

package/build/support/PathResolver/AliasCompiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AliasCompiler.js","sourceRoot":"","sources":["../../../src/support/PathResolver/AliasCompiler.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B,MAAM,OAAO,aAAa;IACF;IAApB,YAAoB,WAAmB;QAAnB,gBAAW,GAAX,WAAW,CAAQ;IAAG,CAAC;IAC3C;;;;;;OAMG;IACI,OAAO,CAAC,MAA+B;QAC1C,MAAM,MAAM,GAAkC,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC;QAEpF,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ;gBAAE,SAAS;YAEvD,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;gBAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACjD,MAAM,KAAK,GAAG,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAEtD,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;gBACtF,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;oBACzC,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,QAAQ,CAAC;oBACtC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAE3E,IAAI,SAA6B,CAAC;gBAClC,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;oBACvD,SAAS,GAAG,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;YACxF,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ;AAYD,eAAe,aAAa,CAAC"}

package/build/support/PathResolver/PathResolver.d.ts

@@ -0,0 +1,45 @@
+import { Logger } from "@netfeez/vterm";
+import schemas from '../../config/schemas.js';
+import PathRewriter from './PathRewriter.js';
+import AliasCompiler from './AliasCompiler.js';
+export declare class PathResolver {
+    readonly config: schemas.config['infer'];
+    readonly options: PathResolver.Options;
+    static readonly PROJECT_ROOT: string;
+    static readonly EXTENSIONS: string[];
+    protected readonly logger: Logger;
+    protected readonly rewriter: PathRewriter;
+    protected readonly absoluteOutDir: string;
+    readonly aliases: AliasCompiler.CompiledAlias[];
+    constructor(config: schemas.config['infer'], options?: PathResolver.Options);
+    /**
+     * Resolves and rewrites paths in built files based on the provided mode (local or CDN).
+     * It processes all files in the output directory, rewriting import paths according to the configured aliases.
+     * @param mode The resolution mode ('local' or 'cdn') to determine which target paths to use.
+     */
+    rewritePaths(mode: PathResolver.Mode): Promise<void>;
+    /**
+     * Processes a single file, rewriting import paths based on the configured aliases and the specified mode (local or CDN).
+     * It reads the file content, applies the path rewriting logic, and writes the updated content back to the file system if any changes were made.
+     * @param file The path of the file to process.
+     * @param mode The resolution mode ('local' or 'cdn') to determine which target paths to use for rewriting.
+     * @returns A boolean indicating whether the file was modified (true if rewritten, false if no changes were made).
+     */
+    protected processFile(file: string, mode: PathResolver.Mode): Promise<boolean>;
+    /**
+     * Watches the output directory for changes and automatically rewrites paths in modified files based on the configured aliases and specified mode (local or CDN).
+     * It sets up a file system watcher that listens for changes in the output directory, and when a relevant file is modified, it triggers the path rewriting process for that file.
+     * The method includes debouncing to prevent excessive processing during rapid file changes, ensuring efficient handling of updates while maintaining responsiveness.
+     * @param mode The resolution mode ('local' or 'cdn') to determine which target paths to use for rewriting when changes are detected.
+     * @returns A promise that resolves when the watcher is set up and running, allowing the application to continue monitoring for changes indefinitely until manually stopped.
+     * @throws Will throw an error if there is an issue setting up the file system watcher or processing files, which can be caught by the caller to handle it appropriately.
+     */
+    watch(mode: PathResolver.Mode): Promise<void>;
+}
+export declare namespace PathResolver {
+    type Mode = 'local' | 'cdn';
+    interface Options {
+        logger?: Logger;
+    }
+}
+export default PathResolver;

package/build/support/PathResolver/PathResolver.js

@@ -0,0 +1,99 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Utility for path resolution with Local/CDN support and dual path fixing.
+ * @license Apache-2.0
+ */
+import PATH from "node:path";
+import FS, { promises as FSP } from 'node:fs';
+import { File } from '@netfeez/common-node';
+import { Logger } from "@netfeez/vterm";
+import Utils from '../Utils.js';
+import PathRewriter from './PathRewriter.js';
+import AliasCompiler from './AliasCompiler.js';
+export class PathResolver {
+    config;
+    options;
+    static PROJECT_ROOT = process.cwd();
+    static EXTENSIONS = ['.js', '.ts', '.jsx', '.tsx'];
+    logger;
+    rewriter;
+    absoluteOutDir;
+    aliases;
+    constructor(config, options = {}) {
+        this.config = config;
+        this.options = options;
+        this.logger = options.logger || new Logger({ name: 'PATH-RW' });
+        const outDir = config.outDir || '.';
+        this.absoluteOutDir = !PATH.isAbsolute(outDir)
+            ? PATH.resolve(PathResolver.PROJECT_ROOT, outDir)
+            : outDir;
+        this.aliases = new AliasCompiler(PathResolver.PROJECT_ROOT).compile(config);
+        this.rewriter = new PathRewriter(this.aliases, PathResolver.PROJECT_ROOT);
+    }
+    /**
+     * Resolves and rewrites paths in built files based on the provided mode (local or CDN).
+     * It processes all files in the output directory, rewriting import paths according to the configured aliases.
+     * @param mode The resolution mode ('local' or 'cdn') to determine which target paths to use.
+     */
+    async rewritePaths(mode) {
+        this.logger.log(`&C2Starting path resolver in &C3${mode} &C2mode...`);
+        if (!await File.exists(this.absoluteOutDir))
+            return void this.logger.warn(`Directory &C4${this.absoluteOutDir}&R not found.`);
+        const files = await File.getAllFiles(this.absoluteOutDir, PathResolver.EXTENSIONS);
+        let rewrittenCount = 0;
+        for (const file of files) {
+            if (await this.processFile(file, mode))
+                rewrittenCount++;
+        }
+        this.logger.log(`&C2Path aliases resolved in &C3${rewrittenCount} &C2files.`);
+    }
+    /**
+     * Processes a single file, rewriting import paths based on the configured aliases and the specified mode (local or CDN).
+     * It reads the file content, applies the path rewriting logic, and writes the updated content back to the file system if any changes were made.
+     * @param file The path of the file to process.
+     * @param mode The resolution mode ('local' or 'cdn') to determine which target paths to use for rewriting.
+     * @returns A boolean indicating whether the file was modified (true if rewritten, false if no changes were made).
+     */
+    async processFile(file, mode) {
+        try {
+            const content = await FSP.readFile(file, 'utf8');
+            const newContent = this.rewriter.rewrite(content, file, mode);
+            if (content === newContent)
+                return false;
+            await FSP.writeFile(file, newContent, 'utf8');
+            return true;
+        }
+        catch (error) {
+            this.logger.error(`Failed to process file &C4${file}:`, error.message);
+            return false;
+        }
+    }
+    /**
+     * Watches the output directory for changes and automatically rewrites paths in modified files based on the configured aliases and specified mode (local or CDN).
+     * It sets up a file system watcher that listens for changes in the output directory, and when a relevant file is modified, it triggers the path rewriting process for that file.
+     * The method includes debouncing to prevent excessive processing during rapid file changes, ensuring efficient handling of updates while maintaining responsiveness.
+     * @param mode The resolution mode ('local' or 'cdn') to determine which target paths to use for rewriting when changes are detected.
+     * @returns A promise that resolves when the watcher is set up and running, allowing the application to continue monitoring for changes indefinitely until manually stopped.
+     * @throws Will throw an error if there is an issue setting up the file system watcher or processing files, which can be caught by the caller to handle it appropriately.
+     */
+    async watch(mode) {
+        await this.rewritePaths(mode);
+        this.logger.log(`&C2Watching for changes in &C4${this.absoluteOutDir}...`);
+        const debouncedProcessor = Utils.debounce(async (fullPath, filename) => {
+            if (await this.processFile(fullPath, mode)) {
+                this.logger.log(`&C2File &C4${filename}&C2 updated.`);
+            }
+        }, 300);
+        FS.watch(this.absoluteOutDir, { recursive: true }, (eventType, filename) => {
+            if (!filename)
+                return;
+            const isTargetExtension = PathResolver.EXTENSIONS.some(ext => filename.endsWith(ext));
+            if (!isTargetExtension)
+                return;
+            const fullPath = PATH.join(this.absoluteOutDir, filename);
+            debouncedProcessor(fullPath, filename);
+        });
+    }
+}
+export default PathResolver;
+//# sourceMappingURL=PathResolver.js.map

package/build/support/PathResolver/PathResolver.js.map

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

package/build/support/PathResolver/PathRewriter.d.ts

@@ -0,0 +1,18 @@
+import AliasCompiler from "./AliasCompiler.js";
+export declare class PathRewriter {
+    private readonly aliases;
+    private readonly projectRoot;
+    static readonly IMPORT_REGEX: RegExp;
+    constructor(aliases: AliasCompiler.CompiledAlias[], projectRoot: string);
+    /**
+     * Rewrites import paths in the given content based on the configured aliases.
+     * It detects import statements and replaces alias paths with their resolved targets.
+     * @param content The file content to rewrite.
+     * @param filePath The path of the file being processed (used for relative path calculations).
+     * @param mode The resolution mode ('local' or 'cdn') to determine which target to use.
+     * @returns The rewritten content with resolved import paths.
+     */
+    rewrite(content: string, filePath: string, mode: 'local' | 'cdn'): string;
+}
+export declare namespace PathRewriter { }
+export default PathRewriter;

package/build/support/PathResolver/PathRewriter.js

@@ -0,0 +1,47 @@
+import PATH from "node:path";
+import { Path } from "@netfeez/common-node";
+export class PathRewriter {
+    aliases;
+    projectRoot;
+    static IMPORT_REGEX = /(from\s+['"])([^'"]+)(['"])/g;
+    constructor(aliases, projectRoot) {
+        this.aliases = aliases;
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * Rewrites import paths in the given content based on the configured aliases.
+     * It detects import statements and replaces alias paths with their resolved targets.
+     * @param content The file content to rewrite.
+     * @param filePath The path of the file being processed (used for relative path calculations).
+     * @param mode The resolution mode ('local' or 'cdn') to determine which target to use.
+     * @returns The rewritten content with resolved import paths.
+     */
+    rewrite(content, filePath, mode) {
+        return content.replace(PathRewriter.IMPORT_REGEX, (match, prefix, modulePath, suffix) => {
+            const aliasCfg = this.aliases.find(c => c.isWildcard ? modulePath.startsWith(`${c.alias}/`) : modulePath === c.alias);
+            if (!aliasCfg)
+                return match;
+            const isCDN = mode === 'cdn' && aliasCfg.targets.cdn;
+            const baseTarget = isCDN ? aliasCfg.targets.cdn : aliasCfg.targets.local;
+            let resolvedPath;
+            if (aliasCfg.isWildcard) {
+                const subPath = modulePath.substring(aliasCfg.alias.length + 1);
+                resolvedPath = isCDN
+                    ? `${baseTarget.replace(/\/$/, '')}/${subPath}`
+                    : PATH.join(baseTarget, subPath);
+            }
+            else {
+                resolvedPath = baseTarget;
+            }
+            if (isCDN)
+                return `${prefix}${resolvedPath}${suffix}`;
+            const currentFileDir = PATH.dirname(filePath);
+            let relativeTarget = PATH.relative(currentFileDir, resolvedPath);
+            if (!relativeTarget.startsWith('.'))
+                relativeTarget = `./${relativeTarget}`;
+            return `${prefix}${Path.normalize(relativeTarget)}${suffix}`;
+        });
+    }
+}
+export default PathRewriter;
+//# sourceMappingURL=PathRewriter.js.map

package/build/support/PathResolver/PathRewriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathRewriter.js","sourceRoot":"","sources":["../../../src/support/PathResolver/PathRewriter.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAI5C,MAAM,OAAO,YAAY;IAGA;IACA;IAHd,MAAM,CAAU,YAAY,GAAG,8BAA8B,CAAC;IACrE,YACqB,OAAsC,EACtC,WAAmB;QADnB,YAAO,GAAP,OAAO,CAA+B;QACtC,gBAAW,GAAX,WAAW,CAAQ;IACrC,CAAC;IACJ;;;;;;;OAOG;IACI,OAAO,CAAC,OAAe,EAAE,QAAgB,EAAE,IAAqB;QACnE,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE;YACpF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;YAEtH,IAAI,CAAC,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAE5B,MAAM,KAAK,GAAG,IAAI,KAAK,KAAK,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC;YACrD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;YAE1E,IAAI,YAAoB,CAAC;YACzB,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAChE,YAAY,GAAG,KAAK;oBAChB,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,OAAO,EAAE;oBAC/C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACJ,YAAY,GAAG,UAAU,CAAC;YAC9B,CAAC;YAED,IAAI,KAAK;gBAAE,OAAO,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,EAAE,CAAC;YAEtD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC9C,IAAI,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;YACjE,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,cAAc,GAAG,KAAK,cAAc,EAAE,CAAC;YAE5E,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,GAAG,MAAM,EAAE,CAAC;QACjE,CAAC,CAAC,CAAC;IACP,CAAC;;AAGL,eAAe,YAAY,CAAC"}