stable for multiple modules from a specific directory from development (#1)

* logger with meaningful status color

* common utilities

* get tsconfig as js object

* new functions for check path Directory and paths join

* get-config.ts throw error when TSConfig parsing time occurs issue

* created function which resolve the task by looping

* new packages added babel-parser and babel-generator

* created transformer utility for create code ATS

* ccreate new checkModuleType utilities for module type detect from AST

* JSDocs type added for JS code

* transform and createAST and  function new params created and JSDocs

* new function for throw error

* module-type-detector utility throw error

* !*important*! create more function which modify the path alis to relative

* invoke getRelativePath function

* created terminal-loader for animation in terminal

* modified code rewrite

* common-utilities.ts pretty indent

* path-converter.ts debuging friendly error handled

* main.ts invoke function by startExecute as a arg

* gitignore & tsconfig.json little bit update

* remove all type extension from ts config path alias value

* entry point for tsconf-paths-resolver

* dev mode starting entry changed

* resolving baseUrl based on cli source argument

* simple cli created with -s and -ds flags

* invoke startExecution with cli srcArg

* fixed tsConfigAliasVal extension not removing and isTSPathAlias

* prevented unnessary loop and print task status

Author: DevSA-009

.gitignore

@@ -1,3 +1,2 @@
 node_modules
-dist
-sample
+dist

package-lock.json

@@ -4,9 +4,12 @@
 	"version": "1.0.0",
 	"main": "dist/index.js",
 	"scripts": {
-		"dev": "tsnd --respawn --clear ./src/main.ts",
+		"dev": "tsnd --respawn --clear ./src/index.ts",
 		"build": "tsc src/index.ts"
 	},
+	"bin": {
+		"tsr":"./dist/index.js"
+	},
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/Safin-Ali/tsconfig-paths-resolver.git"
@@ -19,10 +22,13 @@
 	"homepage": "https://github.com/Safin-Ali/tsconfig-paths-resolver#readme",
 	"description": "",
 	"dependencies": {
+		"@babel/generator": "^7.23.0",
+		"@babel/parser": "^7.23.0",
 		"json-to-js-obj": "^1.0.5",
 		"typescript": "^5.2.2"
 	},
 	"devDependencies": {
+		"@types/babel__generator": "^7.6.5",
 		"@types/node": "^20.8.6"
 	}
 }

package.json

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+import run from './main';
+
+/**
+ * This script starts the directory loop from the specified entry path.
+ * @function
+ * @returns {void}
+ */
+run();

src/index.ts

@@ -0,0 +1,63 @@
+import { extname } from 'path';
+import { isDir, pathJoin, readDir, readFile, resolveWithRoot, thorwError,} from './utilities/common-utilities';
+import transform from './utilities/transformer';
+import startExecute from './utilities/terminal-loader';
+import argObj from './utilities/command-handler';
+import logger from './utilities/color-logger';
+
+
+/**
+ * this function wrapped for terminal can show loading animation sync
+ * start path resolving
+ */
+
+const run = () => startExecute(()=>{
+
+	let status:boolean = false;
+
+/**
+ * Recursively loops through a directory and performs an action on each file.
+ * @param {string} loopPath - The path of the directory to loop through.
+ * @returns {void}
+ */
+const loopDir = (loopPath: string): void => {
+
+	// store loopPath directory elements
+	const allDir = readDir(loopPath);
+
+	// after checking loopPath has not any js file print warning message
+	if(!allDir.filter(elm => elm.endsWith('.mjs') || elm.endsWith('.js')  || elm.endsWith('.cjs')).length) return;
+
+	try{
+
+		allDir.forEach((elm) => {
+			const currElmPath = pathJoin(loopPath, elm);
+
+			if (!isDir(currElmPath)) {
+				/**
+				 * Check if the file extension is .js, .cjs, or .mjs.
+				 * If true, invoke the transformer function.
+				 */
+				if (extname(elm) === '.js' || extname(elm) === '.cjs' || extname(elm) === '.mjs') {
+					transform(readFile(currElmPath),currElmPath)
+				}
+			} else {
+				// If 'currElmPath' is a directory, recursively call 'loopDir' on that directory.
+				loopDir(pathJoin(loopPath, elm));
+			}
+		});
+
+		status = true
+	} catch (err:any) {
+		thorwError(err.message);
+	}
+};
+
+// Start the directory loop from the specified entry path.
+loopDir(resolveWithRoot(argObj.srcArg));
+// print status
+	status ? logger.success(`\nTS alias to relative path convert successfull 😊`) : logger.warn(`\nnot founded any JS file in ${resolveWithRoot(argObj.srcArg)} 🥹 😥`)
+
+});
+
+export default run;

src/main.ts

@@ -0,0 +1,13 @@
+export type ModuleLiteral = 'ESM' | 'CommonJS' | 'CESM';
+
+export type CMDArgFlag = '-s' | '-ds'
+
+export interface CMDArgShape {
+	srcArg: string,
+	destination: string
+}
+
+export interface PathExistStatusShape {
+	executeBool: boolean,
+	TSPathAls: string
+}

src/types/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Formats a given message with ANSI escape codes to apply color.
+ *
+ * @param {string} message - The message to be colorized.
+ * @param {number} colorCode - The ANSI color code to apply to the message.
+ * @returns {string} The colorized message.
+ */
+const colorize = (message: string, colorCode: number) => `\x1b[${colorCode}m${message}\x1b[0m`;
+
+/**
+ * A logger utility that provides methods for logging messages with different colors.
+ */
+const logger = (function () {
+	return {
+		/**
+		 * Logs an error message in red.
+		 *
+		 * @param {string} message - The error message to log.
+		 */
+		error: (message: string) => console.error(colorize(message, 31)),
+
+		/**
+		 * Logs a process message in blue.
+		 *
+		 * @param {string} message - The process message to log.
+		 */
+		process: (message: string) => console.log(colorize(message, 34)),
+
+		/**
+		 * Logs a warning message in yellow.
+		 *
+		 * @param {string} message - The warning message to log.
+		 */
+		warn: (message: string) => console.warn(colorize(message, 33)),
+
+		/**
+		 * Logs a success message in green.
+		 *
+		 * @param {string} message - The success message to log.
+		 */
+		success: (message: string) => console.log(colorize(message, 32))
+	};
+})();
+
+// Export the 'logger' object as the default export of this module.
+export default logger;

src/utilities/color-logger.ts

@@ -0,0 +1,39 @@
+import { CMDArgFlag, CMDArgShape } from '../types/types';
+
+/**
+ * The default argument object.
+ * @type {CMDArgShape}
+ */
+let argObj: CMDArgShape = {
+	destination: '',
+	srcArg: 'dist'
+}
+
+// get argument from cli
+const processArg = process.argv;
+
+processArg.forEach((arg, idx) => {
+	const cmdArg = arg as CMDArgFlag
+	switch (cmdArg) {
+		case '-s':
+			/**
+			 * Set the source argument.
+			 * @type {CMDArgShape}
+			 */
+			argObj = { ...argObj, srcArg: processArg[idx + 1] }
+			break;
+		case '-ds':
+			/**
+			 * Set the destination path.
+			 * @type {CMDArgShape}
+			 */
+			argObj = { ...argObj, destination: processArg[idx + 1] }
+			break;
+	}
+})
+
+/**
+ * The final argument object.
+ * @type {CMDArgShape}
+ */
+export default argObj;