depflow 2.0.0-dev.1 → 2.0.0-dev.2

package/build/{bin → cli}/DepFLowCLI.d.ts

@@ -1,6 +1,7 @@
-import { Utilities } from "vortez";
-export declare class DepFlowCLI extends Utilities.DebugUI {
+import { DebugUI } from "@netfeez/vterm";
+export declare class DepFlowCLI extends DebugUI {
     readonly configPath: string;
+    protected readonly projectRoot: string;
     constructor(configPath?: string);
     commandAdd(command: string, args: string[]): Promise<void>;
     commandRemove(command: string, args: string[]): Promise<void>;
@@ -8,6 +9,7 @@ export declare class DepFlowCLI extends Utilities.DebugUI {
     uninstall(command: string, args: string[]): Promise<void>;
     list(command: string, args: string[]): Promise<void>;
     rewritePaths(command: string, args: string[]): Promise<void>;
+    commandSync(command: string, args: string[]): Promise<void>;
 }
 export declare namespace DepFlowCLI { }
 export default DepFlowCLI;

package/build/{bin → cli}/DepFLowCLI.js

@@ -1,22 +1,28 @@
-import { Utilities } from "vortez";
-import Validator from "../Validator.js";
-import { Utils } from "../Utils.js";
-import Config from "../Config.js";
-import schemas from "../schemas.js";
-import Dependency from "../Dependency.js";
-import { Tsconfig } from "../Tsconfig.js";
-import { PathFixer } from "../PathFixer.js";
-export class DepFlowCLI extends Utilities.DebugUI {
+import { DebugUI } from "@netfeez/vterm";
+import Validator from "../support/Validator.js";
+import Utils from "../support/Utils.js";
+import Config from "../config/Config.js";
+import schemas from "../config/schemas.js";
+import Dependency from "../support/Dependency.js";
+import Tsconfig from "../config/Tsconfig.js";
+import pathResolver from "../support/PathResolver/PathResolver.js";
+import ImportMap from "../config/ImportMap.js";
+import path from "node:path";
+export class DepFlowCLI extends DebugUI {
     configPath;
+    projectRoot;
     constructor(configPath = 'depFlow.json') {
         super();
         this.configPath = configPath;
+        const absoluteConfigPath = path.resolve(process.cwd(), this.configPath);
+        this.projectRoot = path.dirname(absoluteConfigPath);
         this.addCommand('add', this.commandAdd, { usage: 'dep add <repo_url> [name]', description: 'Add a dependency to the configuration file.' });
         this.addCommand('remove', this.commandRemove, { usage: 'dep remove <name> | <repo_url>', description: 'Remove a dependency from the configuration file by name or repo URL.' });
         this.addCommand('install', this.commandInstall, { usage: 'dep install [name1 name2 ...]', description: 'Install dependencies. If names are provided, only those dependencies will be installed.' });
         this.addCommand('uninstall', this.uninstall, { usage: 'dep uninstall [name1 name2 ...]', description: 'Uninstall dependencies. If names are provided, only those dependencies will be uninstalled.' });
         this.addCommand('list', this.list, { usage: 'dep list', description: 'List all dependencies in the configuration file.' });
-        this.addCommand('rewrite-paths', this.rewritePaths, { usage: 'dep rewrite-paths [--watch] [-p <tsconfig_path>]', description: 'Rewrite paths in tsconfig.json based on the dependencies. Use --watch to keep watching for changes.' });
+        this.addCommand('rewrite-paths', this.rewritePaths, { usage: 'dep rewrite-paths [--watch] [--cdn]', description: 'Resolve and rewrite paths in built files based on depFlow configuration.' });
+        this.addCommand('sync', this.commandSync, { usage: 'dep sync', description: 'Syncs depFlow.json with tsconfig.json and generates the importmap.' });
     }
     async commandAdd(command, args) {
         this.out.info(`&C(255,180,220)╭──────────────────────────────────────────────────`);
@@ -68,7 +74,7 @@ export class DepFlowCLI extends Utilities.DebugUI {
                 throw new Error(args.length > 0 ? 'Specified dependencies not found.' : 'No dependencies to install.');
             for (const dep of toInstall) {
                 this.out.info(`&C(255,180,220)│ Installing "${dep.name}" from "${dep.repo}"...`);
-                const dependency = new Dependency(dep);
+                const dependency = new Dependency(config, dep);
                 const result = await dependency.install();
                 this.out.info(`&C(255,180,220)│ ${result.join('\n').replace(/\n/g, '\n&C(255,180,220)│ ')}`);
                 this.out.info(`&C(255,180,220)│ &C3Installed dependency: &C3${dep.name}`);
@@ -81,6 +87,7 @@ export class DepFlowCLI extends Utilities.DebugUI {
         finally {
             this.out.info(`&C(255,180,220)╰──────────────────────────────────────────────────`);
         }
+        this.commandSync('sync', []);
     }
     async uninstall(command, args) {
         this.out.info(`&C(255,180,220)╭──────────────────────────────────────────────────`);
@@ -93,7 +100,7 @@ export class DepFlowCLI extends Utilities.DebugUI {
                 throw new Error(args.length > 0 ? 'Specified dependencies not found.' : 'No dependencies to uninstall.');
             for (const dep of toUninstall) {
                 this.out.info(`&C(255,180,220)│ Uninstalling "${dep.name}" from "${dep.repo}"...`);
-                const dependency = new Dependency(dep);
+                const dependency = new Dependency(config, dep);
                 const result = await dependency.uninstall();
                 this.out.info(`&C(255,180,220)│ ${result.join('\n').replace(/\n/g, '\n&C(255,180,220)│ ')}`);
                 this.out.info(`&C(255,180,220)│ &C3Uninstalled dependency: &C3${dep.name}`);
@@ -129,33 +136,17 @@ export class DepFlowCLI extends Utilities.DebugUI {
         this.out.info(`&C(255,180,220)╭──────────────────────────────────────────────────`);
         try {
             const config = await Config.load(this.configPath);
-            const execPath = process.cwd();
             const watch = args.includes('--watch') || args.includes('-w');
-            const projectPath = (Utils.getFlagValue(args, '-p', false)[0] ||
-                Utils.getFlagValue(args, '--project', false)[0] ||
-                config.tsconfig || config.webTsconfig ||
-                Utilities.Path.join(execPath, 'tsconfig.json'));
-            const tsconfig = await Tsconfig.load(projectPath);
-            const options = tsconfig.compilerOptions;
-            if (!options)
-                throw new Error('tsconfig.json must have "compilerOptions" to rewrite paths.');
-            if (!options.paths)
-                throw new Error('tsconfig.json must have "paths" in compilerOptions to rewrite paths.');
-            if (!options.outDir)
-                throw new Error('tsconfig.json must have an "outDir" specified in compilerOptions to rewrite paths.');
-            if (!options.baseUrl && !options.rootDir) {
-                this.out.warn(`&C(255,180,220)│ &C3Warning: Neither "baseUrl" nor "rootDir" found. Resolving paths relative to project root.`);
-            }
-            const fixer = new PathFixer({
-                paths: options.paths,
-                baseUrl: options.baseUrl,
-                rootDir: options.rootDir,
-                outDir: options.outDir
-            });
+            const useCDN = args.includes('--cdn');
+            const mode = useCDN ? 'cdn' : 'local';
+            this.out.info(`&C(255,180,220)│ Mode: &C3${useCDN ? 'CDN' : 'Local'}`);
+            if (watch)
+                this.out.info(`&C(255,180,220)│ Watcher: &C2Enabled`);
+            const resolver = new pathResolver(config, { logger: this.out });
             if (watch)
-                await fixer.watch();
+                await resolver.watch(mode);
             else
-                await fixer.run();
+                await resolver.rewritePaths(mode);
         }
         catch (error) {
             this.out.error(`&C(255,180,220)│ &C1${error.message || error}`);
@@ -164,6 +155,39 @@ export class DepFlowCLI extends Utilities.DebugUI {
             this.out.info(`&C(255,180,220)╰──────────────────────────────────────────────────`);
         }
     }
+    async commandSync(command, args) {
+        this.out.info(`&C(255,180,220)╭──────────────────────────────────────────────────`);
+        this.out.info(`&C(255,180,220)│ Synchronizing configurations...`);
+        try {
+            const useCDN = args.includes('--cdn');
+            const mode = useCDN ? 'cdn' : 'local';
+            const config = await Config.load(this.configPath);
+            const resolver = new pathResolver(config, { logger: this.out });
+            const tsconfigFile = config.tsconfig;
+            const importMapFile = config.importmap;
+            if (tsconfigFile) {
+                const tsconfig = await Tsconfig.load(this.projectRoot, tsconfigFile, { logger: this.out });
+                tsconfig.updatePaths(resolver.aliases);
+                await tsconfig.save();
+            }
+            else
+                this.out.warn(`&C(255,180,220)│ No tsconfig file specified in configuration. Skipping tsconfig synchronization.`);
+            if (importMapFile) {
+                const importmap = await ImportMap.load(this.projectRoot, importMapFile, { logger: this.out });
+                importmap.updateImports(resolver.aliases, mode);
+                await importmap.save();
+            }
+            else
+                this.out.warn(`&C(255,180,220)│ No import map file specified in configuration. Skipping import map synchronization.`);
+            this.out.info(`&C(255,180,220)│ &C2Successfully synced all configurations.`);
+        }
+        catch (error) {
+            this.out.error(`&C(255,180,220)│ &C1Error during sync: ${error.message}`);
+        }
+        finally {
+            this.out.info(`&C(255,180,220)╰──────────────────────────────────────────────────`);
+        }
+    }
 }
 export default DepFlowCLI;
 //# sourceMappingURL=DepFLowCLI.js.map

package/build/cli/DepFLowCLI.js.map

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

package/build/{bin → cli}/bin.js

@@ -1,10 +1,21 @@
 #!/usr/bin/env node
 import DepFlowCLI from "./DepFLowCLI.js";
-const cli = new DepFlowCLI();
+import { Utils } from "../support/Utils.js";
+import schemas from "../config/schemas.js";
+function startupSchemaValidation(flowPath) {
+    const jsonSchema = schemas.config.jsonSchema;
+    Utils.addVscodeValidation(flowPath, jsonSchema);
+}
+const skip = 2;
+const [commandName, ...args] = process.argv.slice(skip);
+const flowTag = (Utils.getFlagValue(args, '--flow') ||
+    Utils.getFlagValue(args, '-f'));
+const flowPath = flowTag[0] || 'depflow.json';
+const cli = new DepFlowCLI(flowPath);
+startupSchemaValidation(flowPath);
+console.log(flowPath);
 try {
-    const skip = 2;
-    const [commandName, ...args] = process.argv.slice(skip);
-    if (commandName) {
+    if (commandName !== null) {
         const command = cli.getCommand(commandName);
         if (command) {
             await command.exec.call(cli, commandName, args);

package/build/cli/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";AAEA,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,OAAO,MAAM,sBAAsB,CAAC;AAE3C,SAAS,uBAAuB,CAAC,QAAgB;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;IAC7C,KAAK,CAAC,mBAAmB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,CAAC;AACf,MAAM,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAExD,MAAM,OAAO,GAAG,CACZ,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC;IAClC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CACjC,CAAC;AAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC;AAC9C,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;AAErC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;AAClC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACtB,IAAI,CAAC;IACD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC5C,IAAI,OAAO,EAAE,CAAC;YACV,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACJ,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,oBAAoB,WAAW,EAAE,CAAC,CAAC;YACjD,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QACvD,CAAC;IACL,CAAC;;QAAM,GAAG,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC;AAAC,OAAO,KAAU,EAAE,CAAC;IAClB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;IAC/E,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,uBAAuB,KAAK,EAAE,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC;IAC9D,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;IAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC"}

package/build/config/Config.d.ts

@@ -0,0 +1,28 @@
+import schemas from './schemas.js';
+export declare class Config {
+    /**
+     * Loads the configuration from a file at the specified path.
+     * If the file does not exist, it creates a new configuration file with default values and returns those defaults.
+     * If the file exists, it reads the content, parses it as JSON, and processes it using the defined schema to ensure it conforms to the expected structure.
+     * This method is essential for managing application settings or other relevant information in a structured format that can be easily read and modified as needed.
+     * @param path The file system path of the configuration file to load.
+     * @returns A promise that resolves to the loaded configuration object, which conforms to the expected structure defined in the Config.Config type.
+     * @throws Will throw an error if there is an issue during the file reading or writing process, such as insufficient permissions or invalid path.
+     */
+    static load(path: string): Promise<Config.Config>;
+    /**
+     * Saves the provided configuration object to a file at the specified path.
+     * It converts the configuration object into a JSON string with proper formatting and writes it to the file using the File.write method.
+     * This function is essential for persisting configuration data, allowing applications to store settings or other relevant information in a structured format that can be easily read and modified as needed.
+     * @param path The file system path where the configuration should be saved.
+     * @param config The configuration object to be saved, which should conform to the expected structure defined in the Config.ConfigToProcess type.
+     * @returns A promise that resolves when the save operation is complete.
+     * @throws Will throw an error if there is an issue during the file writing process, such as insufficient permissions or invalid path.
+     */
+    static save(path: string, config: Config.ConfigToProcess): Promise<void>;
+}
+export declare namespace Config {
+    type Config = typeof schemas.config.infer;
+    type ConfigToProcess = typeof schemas.config.inferToProcess;
+}
+export default Config;

package/build/config/Config.js

@@ -0,0 +1,46 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Utility to help with File operations.
+ * @license Apache-2.0
+ */
+import { File } from '@netfeez/common-node';
+import schemas from './schemas.js';
+export class Config {
+    /**
+     * Loads the configuration from a file at the specified path.
+     * If the file does not exist, it creates a new configuration file with default values and returns those defaults.
+     * If the file exists, it reads the content, parses it as JSON, and processes it using the defined schema to ensure it conforms to the expected structure.
+     * This method is essential for managing application settings or other relevant information in a structured format that can be easily read and modified as needed.
+     * @param path The file system path of the configuration file to load.
+     * @returns A promise that resolves to the loaded configuration object, which conforms to the expected structure defined in the Config.Config type.
+     * @throws Will throw an error if there is an issue during the file reading or writing process, such as insufficient permissions or invalid path.
+     */
+    static async load(path) {
+        if (!await File.exists(path)) {
+            const defaults = schemas.config.processData({});
+            await Config.save(path, defaults);
+            return defaults;
+        }
+        else {
+            const content = await File.read(path, 'utf-8');
+            const json = JSON.parse(content);
+            const config = schemas.config.processData(json);
+            return config;
+        }
+    }
+    /**
+     * Saves the provided configuration object to a file at the specified path.
+     * It converts the configuration object into a JSON string with proper formatting and writes it to the file using the File.write method.
+     * This function is essential for persisting configuration data, allowing applications to store settings or other relevant information in a structured format that can be easily read and modified as needed.
+     * @param path The file system path where the configuration should be saved.
+     * @param config The configuration object to be saved, which should conform to the expected structure defined in the Config.ConfigToProcess type.
+     * @returns A promise that resolves when the save operation is complete.
+     * @throws Will throw an error if there is an issue during the file writing process, such as insufficient permissions or invalid path.
+     */
+    static async save(path, config) {
+        const content = JSON.stringify(config, null, 2);
+        await File.write(path, content, 'utf-8');
+    }
+}
+export default Config;
+//# sourceMappingURL=Config.js.map

package/build/config/Config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.js","sourceRoot":"","sources":["../../src/config/Config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAE5C,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,MAAM,OAAO,MAAM;IACf;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY;QAC1B,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAChD,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAClC,OAAO,QAAQ,CAAC;QACpB,CAAC;aAAM,CAAC;YACJ,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAChD,OAAO,MAAM,CAAC;QAClB,CAAC;IACL,CAAC;IACD;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,MAA8B;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAChD,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CACJ;AAMD,eAAe,MAAM,CAAC"}

package/build/config/ImportMap.d.ts

@@ -0,0 +1,38 @@
+import { Logger } from '@netfeez/vterm';
+import AliasCompiler from '../support/PathResolver/AliasCompiler.js';
+export declare class ImportMap {
+    protected data: ImportMap.Data;
+    protected projectRoot: string;
+    protected filename: string;
+    protected logger: Logger;
+    constructor(data: ImportMap.Data, projectRoot: string, filename: string, options?: ImportMap.Options);
+    /**
+     * Updates the import map data based on the provided compiled aliases.
+     * It constructs an "imports" section where each alias is mapped to its target path.
+     * @param aliases An array of compiled aliases.
+     * @param mode The resolution mode ('local' or 'cdn').
+     */
+    updateImports(aliases: AliasCompiler.CompiledAlias[], mode: 'local' | 'cdn'): void;
+    save(filename?: string): Promise<void>;
+    static save(projectRoot: string, filename: string, data: ImportMap.Data, options?: ImportMap.Options): Promise<void>;
+    /**
+     * Factory method: Loads, validates (or creates default), and returns an instance of the ImportMap class.
+     * It checks if the specified import map file exists, and if it does, it attempts to read and parse its content as JSON.
+     * If the file does not exist or contains invalid JSON, it initializes the data with a default structure containing an empty "imports" object.
+     * Finally, it returns a new instance of ImportMap with the loaded or default data, allowing for further manipulation and saving of the import map configuration.
+     * @param projectRoot The root directory of the project where the import map file is located.
+     * @param filename The name of the import map file to load (e.g., 'import-map.json').
+     * @param options Additional options for loading, such as a logger for logging messages during the load process.
+     * @returns A promise that resolves to an instance of ImportMap initialized with the loaded or default data.
+     */
+    static load(projectRoot: string, filename: string, options?: ImportMap.Options): Promise<ImportMap>;
+}
+export declare namespace ImportMap {
+    interface Data {
+        imports: Record<string, string>;
+    }
+    interface Options {
+        logger?: Logger;
+    }
+}
+export default ImportMap;

package/build/config/ImportMap.js

@@ -0,0 +1,83 @@
+import PATH from 'node:path';
+import { Logger } from '@netfeez/vterm';
+import { File, Path } from '@netfeez/common-node';
+export class ImportMap {
+    data;
+    projectRoot;
+    filename;
+    logger;
+    constructor(data, projectRoot, filename, options = {}) {
+        this.data = data;
+        this.projectRoot = projectRoot;
+        this.filename = filename;
+        this.logger = options.logger || new Logger({ name: 'IMP-MAP' });
+    }
+    /**
+     * Updates the import map data based on the provided compiled aliases.
+     * It constructs an "imports" section where each alias is mapped to its target path.
+     * @param aliases An array of compiled aliases.
+     * @param mode The resolution mode ('local' or 'cdn').
+     */
+    updateImports(aliases, mode) {
+        if (!this.data.imports)
+            this.data.imports = {};
+        for (const aliasObj of aliases) {
+            const key = aliasObj.isWildcard ? `${aliasObj.alias}/` : aliasObj.alias;
+            let target = mode === 'cdn' && aliasObj.targets.cdn
+                ? aliasObj.targets.cdn
+                : aliasObj.targets.local;
+            if (target === aliasObj.targets.local) {
+                target = PATH.relative(this.projectRoot, target);
+                if (!target.startsWith('./'))
+                    target = `./${target}`;
+                target = Path.normalize(target);
+            }
+            if (aliasObj.isWildcard) {
+                if (!target.endsWith('/'))
+                    target += '/';
+            }
+            this.data.imports[key] = target;
+        }
+    }
+    async save(filename = this.filename) {
+        await ImportMap.save(this.projectRoot, filename, this.data, { logger: this.logger });
+    }
+    static async save(projectRoot, filename, data, options = {}) {
+        const logger = options.logger || new Logger({ name: 'IMP-MAP' });
+        const importMapPath = PATH.resolve(projectRoot, filename);
+        const folder = PATH.dirname(importMapPath);
+        if (!await File.exists(folder))
+            await File.mkdir(folder, { recursive: true });
+        const json = JSON.stringify(data, null, 4);
+        await File.write(importMapPath, json);
+        logger.log(`&C2Generated &C4${filename}`);
+    }
+    /**
+     * Factory method: Loads, validates (or creates default), and returns an instance of the ImportMap class.
+     * It checks if the specified import map file exists, and if it does, it attempts to read and parse its content as JSON.
+     * If the file does not exist or contains invalid JSON, it initializes the data with a default structure containing an empty "imports" object.
+     * Finally, it returns a new instance of ImportMap with the loaded or default data, allowing for further manipulation and saving of the import map configuration.
+     * @param projectRoot The root directory of the project where the import map file is located.
+     * @param filename The name of the import map file to load (e.g., 'import-map.json').
+     * @param options Additional options for loading, such as a logger for logging messages during the load process.
+     * @returns A promise that resolves to an instance of ImportMap initialized with the loaded or default data.
+     */
+    static async load(projectRoot, filename, options = {}) {
+        const logger = options.logger || new Logger({ name: 'IMP-MAP' });
+        const importMapPath = PATH.resolve(projectRoot, filename);
+        let data = { imports: {} };
+        if (!await File.exists(importMapPath)) {
+            logger.warn(`&C3${filename} not found. Creating defaults...`);
+            const data = { imports: {} };
+            await ImportMap.save(projectRoot, filename, data, { logger });
+        }
+        else {
+            const content = await File.read(importMapPath, 'utf-8');
+            const json = JSON.parse(content);
+            data = json;
+        }
+        return new ImportMap(data, projectRoot, filename, { logger });
+    }
+}
+export default ImportMap;
+//# sourceMappingURL=ImportMap.js.map

package/build/config/ImportMap.js.map

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

package/build/config/Tsconfig.d.ts

@@ -0,0 +1,57 @@
+import { Logger } from '@netfeez/vterm';
+import schemas from "./schemas.js";
+import AliasCompiler from '../support/PathResolver/AliasCompiler.js';
+export declare class Tsconfig {
+    protected data: Tsconfig.Data;
+    protected projectRoot: string;
+    protected filename: string;
+    protected logger: Logger;
+    constructor(data: Tsconfig.Data, projectRoot: string, filename: string, options?: Tsconfig.Options);
+    /**
+     * Updates the paths in the tsconfig data based on the provided compiled aliases.
+     * It ensures that the compilerOptions and paths properties exist in the tsconfig data, and then iterates through the compiled aliases to construct the appropriate path mappings.
+     * For each alias, it calculates the relative path from the project root to the local target and normalizes it. If the alias is a wildcard, it appends '/*' to the target path.
+     * Finally, it updates the paths in the tsconfig data with the new mappings, allowing TypeScript to resolve module paths according to the defined aliases.
+     * @param aliases An array of compiled aliases containing alias names, target paths, and wildcard information.
+     */
+    updatePaths(aliases: AliasCompiler.CompiledAlias[]): void;
+    /**
+     * Saves the current tsconfig data to a file.
+     * It constructs the path to the tsconfig file using the project root and filename, converts the data to a JSON string with proper formatting, and writes it to the file system using the File.write method.
+     * The method also includes error handling to log any issues that occur during the save process, ensuring that users are informed of any problems when attempting to save the tsconfig configuration.
+     * @param filename The name of the tsconfig file to save (default is the instance's filename property).
+     * @returns A promise that resolves when the save operation is complete, or rejects if an error occurs during the process.
+     */
+    save(filename?: string): Promise<void>;
+    /**
+     * Static method to save tsconfig data to a specified file. It takes the project root, filename, tsconfig data, and options (including a logger) as parameters.
+     * The method constructs the full path to the tsconfig file, converts the data to a formatted JSON string, and writes it to the file system.
+     * It also includes error handling to log any issues that arise during the save process, providing feedback on whether the operation was successful or if it encountered problems.
+      * @param projectRoot The root directory of the project where the tsconfig file should be saved.
+      * @param filename The name of the tsconfig file (default is 'tsconfig.json').
+      * @param data The tsconfig data to be saved, structured according to the defined schema.
+      * @param options Additional options for saving, such as a logger for logging messages during the save process.
+      * @returns A promise that resolves when the save operation is complete, or rejects if an error occurs during the process.
+      * @throws Will throw an error if there is an issue during the save process, which can be caught by the caller to handle it appropriately.
+     */
+    static save(projectRoot: string, filename: string | undefined, data: Tsconfig.Data, options?: Tsconfig.Options): Promise<void>;
+    /**
+     * Static method to load tsconfig data from a specified file.
+     * It takes the project root, filename, and options (including a logger) as parameters.
+     * The method checks if the tsconfig file exists, and if it does, it reads the content, parses it as JSON, and processes it using the defined schema to ensure it conforms to the expected structure.
+     * If the file does not exist, it creates a default tsconfig data object using the schema. Finally, it returns an instance of the Tsconfig class initialized with the loaded or default data.
+     * @param projectRoot The root directory of the project where the tsconfig file is located.
+     * @param filename The name of the tsconfig file to load (default is 'tsconfig.json').
+     * @param options Additional options for loading, such as a logger for logging messages during the load process.
+     * @returns A promise that resolves to an instance of the Tsconfig class containing the loaded data, or rejects if there is an error during the load process.
+      * @throws Will throw an error if there is an issue during the load process, which
+     */
+    static load(projectRoot: string, filename: string, options: Tsconfig.Options): Promise<Tsconfig>;
+}
+export declare namespace Tsconfig {
+    type Data = schemas.basicTsconfig['infer'];
+    interface Options {
+        logger?: Logger;
+    }
+}
+export default Tsconfig;

package/build/config/Tsconfig.js

@@ -0,0 +1,99 @@
+import PATH from 'node:path';
+import { Logger } from '@netfeez/vterm';
+import { File, Path } from '@netfeez/common-node';
+import schemas from "./schemas.js";
+export class Tsconfig {
+    data;
+    projectRoot;
+    filename;
+    logger;
+    constructor(data, projectRoot, filename, options = {}) {
+        this.data = data;
+        this.projectRoot = projectRoot;
+        this.filename = filename;
+        this.logger = options.logger || new Logger({ name: 'TS-CFG' });
+    }
+    /**
+     * Updates the paths in the tsconfig data based on the provided compiled aliases.
+     * It ensures that the compilerOptions and paths properties exist in the tsconfig data, and then iterates through the compiled aliases to construct the appropriate path mappings.
+     * For each alias, it calculates the relative path from the project root to the local target and normalizes it. If the alias is a wildcard, it appends '/*' to the target path.
+     * Finally, it updates the paths in the tsconfig data with the new mappings, allowing TypeScript to resolve module paths according to the defined aliases.
+     * @param aliases An array of compiled aliases containing alias names, target paths, and wildcard information.
+     */
+    updatePaths(aliases) {
+        if (!this.data.compilerOptions)
+            this.data.compilerOptions = {};
+        if (!this.data.compilerOptions.paths)
+            this.data.compilerOptions.paths = {};
+        for (const aliasObj of aliases) {
+            const key = aliasObj.isWildcard ? `${aliasObj.alias}/*` : aliasObj.alias;
+            let target = PATH.relative(this.projectRoot, aliasObj.targets.local);
+            target = Path.normalize(target);
+            if (aliasObj.isWildcard) {
+                const suffix = target.endsWith('/') ? '*' : '/*';
+                target = `${target}${suffix}`;
+            }
+            this.data.compilerOptions.paths[key] = [target];
+        }
+    }
+    /**
+     * Saves the current tsconfig data to a file.
+     * It constructs the path to the tsconfig file using the project root and filename, converts the data to a JSON string with proper formatting, and writes it to the file system using the File.write method.
+     * The method also includes error handling to log any issues that occur during the save process, ensuring that users are informed of any problems when attempting to save the tsconfig configuration.
+     * @param filename The name of the tsconfig file to save (default is the instance's filename property).
+     * @returns A promise that resolves when the save operation is complete, or rejects if an error occurs during the process.
+     */
+    async save(filename = this.filename) {
+        await Tsconfig.save(this.projectRoot, filename, this.data, { logger: this.logger });
+    }
+    /**
+     * Static method to save tsconfig data to a specified file. It takes the project root, filename, tsconfig data, and options (including a logger) as parameters.
+     * The method constructs the full path to the tsconfig file, converts the data to a formatted JSON string, and writes it to the file system.
+     * It also includes error handling to log any issues that arise during the save process, providing feedback on whether the operation was successful or if it encountered problems.
+      * @param projectRoot The root directory of the project where the tsconfig file should be saved.
+      * @param filename The name of the tsconfig file (default is 'tsconfig.json').
+      * @param data The tsconfig data to be saved, structured according to the defined schema.
+      * @param options Additional options for saving, such as a logger for logging messages during the save process.
+      * @returns A promise that resolves when the save operation is complete, or rejects if an error occurs during the process.
+      * @throws Will throw an error if there is an issue during the save process, which can be caught by the caller to handle it appropriately.
+     */
+    static async save(projectRoot, filename = 'tsconfig.json', data, options = {}) {
+        const logger = options.logger || new Logger({ name: 'TS-CFG' });
+        const tsconfigPath = PATH.resolve(projectRoot, filename);
+        const folder = PATH.dirname(tsconfigPath);
+        if (!await File.exists(folder))
+            await File.mkdir(folder, { recursive: true });
+        const json = JSON.stringify(data, null, 4);
+        await File.write(tsconfigPath, json);
+        logger.log(`&C2Updated &C4${filename}&C2 successfully.`);
+    }
+    /**
+     * Static method to load tsconfig data from a specified file.
+     * It takes the project root, filename, and options (including a logger) as parameters.
+     * The method checks if the tsconfig file exists, and if it does, it reads the content, parses it as JSON, and processes it using the defined schema to ensure it conforms to the expected structure.
+     * If the file does not exist, it creates a default tsconfig data object using the schema. Finally, it returns an instance of the Tsconfig class initialized with the loaded or default data.
+     * @param projectRoot The root directory of the project where the tsconfig file is located.
+     * @param filename The name of the tsconfig file to load (default is 'tsconfig.json').
+     * @param options Additional options for loading, such as a logger for logging messages during the load process.
+     * @returns A promise that resolves to an instance of the Tsconfig class containing the loaded data, or rejects if there is an error during the load process.
+      * @throws Will throw an error if there is an issue during the load process, which
+     */
+    static async load(projectRoot, filename, options) {
+        const logger = options.logger || new Logger({ name: 'TS-CFG' });
+        const tsconfigPath = PATH.resolve(projectRoot, filename);
+        let data;
+        if (!await File.exists(tsconfigPath)) {
+            logger.warn(`&C3${filename} not found. Creating defaults...`);
+            data = schemas.basicTsconfig.processData({});
+            this.save(projectRoot, filename, data, { logger }).catch(err => logger.error(`Failed to create default tsconfig:`, err.message));
+        }
+        else {
+            const content = await File.read(tsconfigPath, 'utf-8');
+            const json = JSON.parse(content);
+            data = schemas.basicTsconfig.processData(json);
+        }
+        return new Tsconfig(data, projectRoot, filename, { logger });
+    }
+}
+export default Tsconfig;
+//# sourceMappingURL=Tsconfig.js.map

package/build/config/Tsconfig.js.map

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