tnp-core 19.0.68 → 19.0.69

package/browser/fesm2022/tnp-core.mjs

@@ -1020,7 +1020,11 @@ var Utils;
      * Example:
      * new RegExp(escapeStringForRegEx('a.b.c'),'g') => /a\.b\.c/g
      */
-    Utils.escapeStringForRegEx = (stringForRegExp) => {
+    Utils.escapeStringForRegEx = (stringForRegExp, options) => {
+        options = options || {};
+        if (options?.skipEscapeSlashAndDash) {
+            return stringForRegExp.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        }
         return stringForRegExp.replace(/[-\/\\^$*+?.()|[\]{}]/g, '\\$&');
     };
     //#endregion
@@ -2324,6 +2328,78 @@ var UtilsProcess;
         return (void 0);
     };
     //#endregion
+    //#region utils process / kill all other node processes except itself
+    /**
+     * Kills all Node.js processes except the current process.
+     * Works on Windows, macOS, and Linux.
+     * @returns {number} Number of processes killed
+     */
+    UtilsProcess.killAllOtherNodeProcesses = async () => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils process / is node version ok
     UtilsProcess.isNodeVersionOk = (options) => {
         if (!globalThis || !globalThis.process || !globalThis.process.version) {
             return false;
@@ -2349,8 +2425,221 @@ var UtilsProcess;
         }
         return ok;
     };
+    //#endregion
 })(UtilsProcess || (UtilsProcess = {}));
 //#endregion
+//#region TODO IN_PROGRESS utils exec process
+/**
+ * ! TODO @LAST @IN_PROGRESS
+ * - async process execution utils
+ * - export when ready
+ * - should be ready for everything async refactor
+ */
+var UtilsExecProc;
+(function (UtilsExecProc) {
+    /**
+     * ! TODO @IN_PROGRESS implement all options and test
+     */
+    class ExecProcResult {
+        constructor(child, command) {
+            this.child = child;
+            this.command = command;
+        }
+        async waitUntilDoneOrThrow(options) {
+            /* */
+            /* */
+            /* */
+            /* */
+            /* */
+            /* */
+            /* */
+            /* */
+            /* */
+            /* */
+            /* */
+            /* */
+            /* */
+            /* */
+            /* */
+            /* */
+            /* */
+            /* */
+            /* */
+            return (void 0);
+        }
+    }
+    UtilsExecProc.ExecProcResult = ExecProcResult;
+    /**
+     * @TODO @IN_PROGRESS
+     */
+    UtilsExecProc.spawnAsync = (command, options) => {
+        options = options || {};
+        options.cwd = crossPlatformPath(options.cwd || process.cwd());
+        const [cmd, ...args] = command.split(' ');
+        const child = spawn(cmd, args, { stdio: 'inherit', ...options });
+        return new ExecProcResult(child, command);
+    };
+    /**
+     * @TODO @IN_PROGRESS
+     */
+    UtilsExecProc.spawnAdminSudo = async (command, options) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#region utils exec process / execute until end or throw
+    /**
+     * @TODO @IN_PROGRESS
+     */
+    UtilsExecProc.executeUntilEndOrThrow = async ({ command, cwd, }) => {
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+})(UtilsExecProc || (UtilsExecProc = {}));
+//#endregion
+//#region TODO IN_PROGRESS utils files folders operations
+/**
+ * TODO @LAST @IN_PROGRESS
+ * - utils for files and folders operations
+ * - export when ready
+ * - should be ready for everything async refactor
+ */
+var UtilsFilesFoldersOperations;
+(function (UtilsFilesFoldersOperations) {
+    //#endregion
+    //#region utils files folders operations / remove file or folder or link
+    /**
+     * remove file or folder or link
+     */
+    UtilsFilesFoldersOperations.remove = async (absolutePath, options) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils files folders operations / remove file or folder or link
+    /**
+     * remove file or folder or link
+     */
+    UtilsFilesFoldersOperations.removeByPattern = async (globPattern, options) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils files folders operations / get files from
+    async function getFilesFromAsync(folderOrLinkToFolder, options = {}) {
+        return null;
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    }
+    UtilsFilesFoldersOperations.getFilesFromAsync = getFilesFromAsync;
+    //#endregion
+    //#region utils files folders operations / read file
+    /**
+     * TODO @IN_PROGRESS
+     */
+    UtilsFilesFoldersOperations.readFileAsync = async (absoluteFilePath, options) => {
+        return void 0;
+    };
+    /* */
+    /* */
+    /**
+     * TODO @IN_PROGRESS
+     */
+    UtilsFilesFoldersOperations.writeFileAsync = async (absoluteFilePath, input, options) => {
+        return void 0;
+    };
+    //#endregion
+    //#region utils files folders operations / is existed symlink
+    /**
+     * TODO @IN_PROGRESS
+     */
+    UtilsFilesFoldersOperations.isExistedSymlink = async (absoluteFilePath) => {
+        return void 0;
+    };
+    //#endregion
+    //#region utils files folders operations / is un existed link
+    /**
+     * TODO @IN_PROGRESS
+     */
+    UtilsFilesFoldersOperations.isUnExistedLink = async (absoluteFilePath) => {
+        return void 0;
+    };
+    //#endregion
+})(UtilsFilesFoldersOperations || (UtilsFilesFoldersOperations = {}));
+//#endregion
 //#region utils os
 var UtilsOs;
 (function (UtilsOs) {
@@ -2391,9 +2680,11 @@ var UtilsOs;
         return false;
     };
     //#endregion
+    //#region utils os / is running in ssr mode
     UtilsOs.isRunningInSSRMode = () => {
         return typeof globalThis.window === 'undefined';
     };
+    //#endregion
     //#region utils os / is running in electron
     /**
      * check whether the current process is running inside
@@ -2590,6 +2881,7 @@ var UtilsOs;
         return (void 0);
     };
     //#endregion
+    //#region utils os / is running in os with graphics capable environment
     UtilsOs.isRunningInOsWithGraphicsCapableEnvironment = () => {
         /* */
         /* */
@@ -2601,6 +2893,7 @@ var UtilsOs;
         /* */
         return (void 0);
     };
+    //#endregion
     //#region utils os / is running in cli mode
     /**
      * Check whether the current process is running in CLI mode.
@@ -2719,6 +3012,7 @@ var UtilsOs;
         return (void 0);
     };
     //#endregion
+    //#region utils os / open folder in vscode
     UtilsOs.openFolderInVSCode = (folderPath) => {
         /* */
         /* */
@@ -2735,6 +3029,8 @@ var UtilsOs;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region utils os / open folder in file explorer
     UtilsOs.openFolderInFileExplorer = (folderPath) => {
         /* */
         /* */
@@ -2771,8 +3067,12 @@ var UtilsOs;
         console.warn(`UtilsOs.openFolderInFileExplorer is not supported in browser mode`);
         //#endregion
     };
+    //#endregion
     //#region utils os / get real home directory
     UtilsOs.getRealHomeDir = () => {
+        //#region @browser
+        return '';
+        //#endregion
         /* */
         /* */
         /* */
@@ -2835,30 +3135,141 @@ var UtilsOs;
     UtilsOs.isWebSQL = UtilsOs.isRunningInWebSQL();
     UtilsOs.isVscodeExtension = UtilsOs.isRunningInVscodeExtension();
     UtilsOs.isSSRMode = UtilsOs.isRunningInSSRMode();
-})(UtilsOs || (UtilsOs = {}));
-//#endregion
-//#region utils string
-var UtilsString;
-(function (UtilsString) {
-    //#region utils string / kebab case no split numbers
-    UtilsString.kebabCaseNoSplitNumbers = (input) => {
-        return (input
-            // Match spaces or any kind of whitespace and replace with a hyphen
-            .replace(/\s+/g, '-')
-            // Match uppercase letters and replace them with a hyphen and the lowercase version of the letter
-            .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
-            // Convert everything to lowercase
-            .toLowerCase());
+    UtilsOs.isRunningInWindows = process.platform == 'win32';
+    //#region utils os / command exists
+    //#region helpers
+    const fileNotExists = async (commandName) => {
+        try {
+            await fse.access(commandName, fse.constants.F_OK);
+            return false;
+        }
+        catch {
+            return true;
+        }
     };
-    //#endregion
-})(UtilsString || (UtilsString = {}));
-//#endregion
-//#region utils migrations
-/**
- * Taon migration utilities
- */
-var UtilsMigrations;
-(function (UtilsMigrations) {
+    const fileNotExistsSync = (commandName) => {
+        try {
+            fse.accessSync(commandName, fse.constants.F_OK);
+            return false;
+        }
+        catch {
+            return true;
+        }
+    };
+    const localExecutable = async (commandName) => {
+        try {
+            await fse.access(commandName, fse.constants.F_OK | fse.constants.X_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    const localExecutableSync = (commandName) => {
+        try {
+            fse.accessSync(commandName, fse.constants.F_OK | fse.constants.X_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    //#endregion
+    //#region command exists (Unix / Windows)
+    const commandExistsUnix = async (commandName) => {
+        const isFileMissing = await fileNotExists(commandName);
+        if (isFileMissing) {
+            try {
+                const stdout = child_process.execSync(`command -v ${commandName} 2>/dev/null && { echo >&1 '${commandName} found'; exit 0; }`, { encoding: 'utf-8' });
+                return !!stdout;
+            }
+            catch {
+                return false;
+            }
+        }
+        return await localExecutable(commandName);
+    };
+    const commandExistsWindows = async (commandName) => {
+        try {
+            const stdout = await Helpers.commandOutputAsStringAsync(`where ${commandName}`);
+            return !!stdout;
+        }
+        catch {
+            return false;
+        }
+    };
+    const commandExistsUnixSync = (commandName) => {
+        if (fileNotExistsSync(commandName)) {
+            try {
+                const stdout = child_process.execSync(`command -v ${commandName} 2>/dev/null && { echo >&1 '${commandName} found'; exit 0; }`, { encoding: 'utf-8' });
+                return !!stdout;
+            }
+            catch {
+                return false;
+            }
+        }
+        return localExecutableSync(commandName);
+    };
+    const commandExistsWindowsSync = (commandName) => {
+        try {
+            const stdout = Helpers.commandOutputAsString(`where ${commandName}`);
+            return !!stdout;
+        }
+        catch {
+            return false;
+        }
+    };
+    //#endregion
+    //#region exported API
+    UtilsOs.commandExistsAsync = async (commandName) => {
+        try {
+            if (UtilsOs.isRunningInWindows) {
+                return await commandExistsWindows(commandName);
+            }
+            else {
+                return await commandExistsUnix(commandName);
+            }
+        }
+        catch (error) {
+            if (frameworkName === 'tnp')
+                console.error(error);
+            return false;
+        }
+    };
+    /**
+     * @deprecated use commandExistsAsync
+     */
+    UtilsOs.commandExistsSync = (commandName) => {
+        return UtilsOs.isRunningInWindows
+            ? commandExistsWindowsSync(commandName)
+            : commandExistsUnixSync(commandName);
+    };
+    //#endregion
+    //#endregion
+})(UtilsOs || (UtilsOs = {}));
+//#endregion
+//#region utils string
+var UtilsString;
+(function (UtilsString) {
+    //#region utils string / kebab case no split numbers
+    UtilsString.kebabCaseNoSplitNumbers = (input) => {
+        return (input
+            // Match spaces or any kind of whitespace and replace with a hyphen
+            .replace(/\s+/g, '-')
+            // Match uppercase letters and replace them with a hyphen and the lowercase version of the letter
+            .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+            // Convert everything to lowercase
+            .toLowerCase());
+    };
+    //#endregion
+})(UtilsString || (UtilsString = {}));
+//#endregion
+//#region utils migrations
+/**
+ * Taon migration utilities
+ */
+var UtilsMigrations;
+(function (UtilsMigrations) {
     UtilsMigrations.getTimestampFromClassName = (className) => {
         const [maybeTimestamp1, maybeTimestamp2] = className.split('_') || [];
         // console.log({ maybeTimestamp1, maybeTimestamp2 });
@@ -2893,13 +3304,13 @@ var UtilsMigrations;
 var UtilsTerminal;
 (function (UtilsTerminal) {
     //#endregion
-    //#region wait
+    //#region utils terminal / wait
     UtilsTerminal.wait = Utils.wait;
     //#endregion
-    //#region wait milliseconds
+    //#region utils terminal / wait milliseconds
     UtilsTerminal.waitMilliseconds = Utils.waitMilliseconds;
     //#endregion
-    //#region is verbose mode
+    //#region utils terminal / is verbose mode
     /**
      * Check if cli is running in verbose mode
      * @returns true if cli is running with arugment -verbose
@@ -2910,6 +3321,7 @@ var UtilsTerminal;
         return (void 0);
     };
     //#endregion
+    //#region utils terminal / wait for user any key
     UtilsTerminal.waitForUserAnyKey = async (callback, options) => {
         /* */
         /* */
@@ -2956,7 +3368,8 @@ var UtilsTerminal;
         /* */
         return (void 0);
     };
-    //#region get terminal height
+    //#endregion
+    //#region utils terminal / get terminal height
     UtilsTerminal.getTerminalHeight = () => {
         /* */
         /* */
@@ -2983,7 +3396,7 @@ var UtilsTerminal;
         return (void 0);
     };
     //#endregion
-    //#region clear
+    //#region utils terminal / clear
     UtilsTerminal.clearConsole = () => {
         /* */
         /* */
@@ -3031,7 +3444,7 @@ var UtilsTerminal;
         // }
     };
     //#endregion
-    //#region transform choices
+    //#region utils terminal / transform choices
     const transformChoices = (choices) => {
         /* */
         /* */
@@ -3053,7 +3466,7 @@ var UtilsTerminal;
         return (void 0);
     };
     //#endregion
-    //#region multiselect
+    //#region utils terminal / multiselect
     UtilsTerminal.multiselect = async (options) => {
         /* */
         /* */
@@ -3137,10 +3550,34 @@ var UtilsTerminal;
         /* */
         /* */
         /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
         return (void 0);
     };
     //#endregion
-    //#region multiselect and execute
+    //#region utils terminal / multiselect and execute
     /**
      * Similar to select but executes action if provided
      * @returns selected and executed value
@@ -3197,7 +3634,7 @@ var UtilsTerminal;
         return (void 0);
     };
     //#endregion
-    //#region select and execute
+    //#region utils terminal / select and execute
     /**
      * Similar to select but executes action if provided
      * @returns selected and executed value
@@ -3241,7 +3678,7 @@ var UtilsTerminal;
         return (void 0);
     };
     //#endregion
-    //#region select
+    //#region utils terminal / select
     UtilsTerminal.select = async (options) => {
         /* */
         /* */
@@ -3319,17 +3756,18 @@ var UtilsTerminal;
         /* */
         /* */
         /* */
+        /* */
         return (void 0);
     };
     //#endregion
-    //#region pipe enter to stdin
+    //#region utils terminal / pipe enter to stdin
     UtilsTerminal.pipeEnterToStdin = () => {
         /* */
         /* */
         return (void 0);
     };
     //#endregion
-    //#region input
+    //#region utils terminal / input
     UtilsTerminal.input = async ({ defaultValue, question, required, validate, }) => {
         /* */
         /* */
@@ -3358,7 +3796,7 @@ var UtilsTerminal;
         return (void 0);
     };
     //#endregion
-    //#region confirm
+    //#region utils terminal / confirm
     UtilsTerminal.confirm = async (options) => {
         /* */
         /* */
@@ -3442,7 +3880,7 @@ var UtilsTerminal;
         return (void 0);
     };
     //#endregion
-    //#region press any key to continue
+    //#region utils terminal / press any key to continue
     UtilsTerminal.pressAnyKeyToContinueAsync = (options) => {
         /* */
         /* */
@@ -3465,7 +3903,19 @@ var UtilsTerminal;
         return (void 0);
     };
     //#endregion
-    //#region press any key
+    //#region utils terminal / press any key to try again error occurred
+    UtilsTerminal.pressAnyKeyToTryAgainErrorOccurred = async (error) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils terminal / press any key
     /**
      * @deprecated use UtilsTerminal.pressAnyKeyToContinueAsync()
      */
@@ -3500,7 +3950,7 @@ var UtilsTerminal;
         return (void 0);
     };
     //#endregion
-    //#region preview long list as select
+    //#region utils terminal / preview long list as select
     UtilsTerminal.previewLongList = async (list, listName = 'List') => {
         /* */
         /* */
@@ -3522,7 +3972,7 @@ var UtilsTerminal;
         return (void 0);
     };
     //#endregion
-    //#region preview long list with 'less' (git log like)
+    //#region utils terminal /  preview long list with 'less' (git log like)
     /**
      * Displays a long list in the console using a pager like `less`.
      * Returns a Promise that resolves when the user exits the pager.
@@ -3576,7 +4026,7 @@ var UtilsTerminal;
         return (void 0);
     };
     //#endregion
-    //#region draw big text
+    //#region utils terminal /  draw big text
     UtilsTerminal.drawBigText = async (text, options) => {
         /* */
         /* */
@@ -3600,6 +4050,125 @@ var UtilsTerminal;
         return (void 0);
     };
     //#endregion
+    //#region utils terminal / configure bash or shell
+    /**
+     * @TODO @IN_PROGRESS
+     * - export when done
+     * Configure bash or powershell prompt to show current folder and git branch
+     */
+    const configureBashOrShell = async () => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
 })(UtilsTerminal || (UtilsTerminal = {}));
 //#endregion
 //#region utils json
@@ -4176,100 +4745,145 @@ var UtilsDotFile;
     //#endregion
 })(UtilsDotFile || (UtilsDotFile = {}));
 //#endregion
-//#region utils network
-var UtilsNetwork;
-(function (UtilsNetwork) {
-    //#region utils network / isValidIp
-    UtilsNetwork.isValidIp = (ip) => {
-        if (!_.isString(ip)) {
-            return false;
-        }
-        ip = ip.trim();
-        if (ip === 'localhost') {
-            return true;
-        }
-        return /^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/.test(ip);
+//#region utils etc hosts
+var UtilsEtcHosts;
+(function (UtilsEtcHosts) {
+    UtilsEtcHosts.SIMULATE_DOMAIN_TAG = '@simulatedDomainByTaon';
+    //#endregion
+    //#region utils etc hosts / get etc hosts path
+    UtilsEtcHosts.getPath = () => {
+        let HOST_FILE_PATH = '';
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return crossPlatformPath(HOST_FILE_PATH);
     };
     //#endregion
-    //#region utils network / isValidDomain
-    UtilsNetwork.isValidDomain = (url, options) => {
-        if (!url || typeof url !== 'string')
-            return false;
-        const shouldIncludeProtocol = !!options?.shouldIncludeProtocol;
-        // Build regex depending on protocol requirement
-        const domainRegex = shouldIncludeProtocol
-            ? /^(https?:\/\/)([a-zA-Z0-9-]{1,63}\.)+[a-zA-Z]{2,}$/ // with protocol
-            : /^([a-zA-Z0-9-]{1,63}\.)+[a-zA-Z]{2,}$/; // without protocol
-        if (typeof options?.shouldIncludeProtocol === 'string' &&
-            options?.shouldIncludeProtocol === 'http' &&
-            !url.startsWith('http://')) {
-            return false; // if http is required, but url does not start with http://
-        }
-        if (typeof options?.shouldIncludeProtocol === 'string' &&
-            options?.shouldIncludeProtocol === 'https' &&
-            !url.startsWith('https://')) {
-            return false; // if https is required, but url does not start with https://
-        }
-        return domainRegex.test(url.trim());
+    //#region utils etc hosts / get lines from etc hosts
+    UtilsEtcHosts.getLines = () => {
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
     };
     //#endregion
-    //#region utils network / urlParse
-    UtilsNetwork.urlParse = (portOrHost, options) => {
-        options = options || {};
-        let url;
-        const defaultProtocol = options.httpsIfNotProvided ? 'https:' : 'http:';
-        if (portOrHost instanceof URL) {
-            url = portOrHost;
-        }
-        else if (_.isNumber(portOrHost)) {
-            url = new URL(`${defaultProtocol}//localhost:${portOrHost}`);
-        }
-        else if (!_.isNaN(Number(portOrHost))) {
-            url = new URL(`${defaultProtocol}//localhost:${Number(portOrHost)}`);
-        }
-        else if (_.isString(portOrHost)) {
-            try {
-                url = new URL(portOrHost);
-            }
-            catch (error) { }
-            if (UtilsNetwork.isValidIp(portOrHost)) {
-                try {
-                    url = new URL(`${defaultProtocol}//${portOrHost}`);
-                }
-                catch (error) {
-                    Helpers.warn(`Not able to get port from ${portOrHost}`);
-                }
-            }
-            if (options.forceDomain) {
-                const domain = portOrHost;
-                url = new URL(domain.startsWith('http') ? domain : `http://${portOrHost}`);
-            }
-        }
-        return url;
+    //#region utils etc hosts / get tokens from line
+    UtilsEtcHosts.getTokensData = (line) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
     };
     //#endregion
-    //#region utils network / get etc hosts path
-    UtilsNetwork.getEtcHostsPath = () => {
-        let HOST_FILE_PATH = '';
+    //#region utils etc hosts / specyfic entry exists
+    UtilsEtcHosts.specificEntryExists = (domain, ip) => {
         /* */
         /* */
         /* */
         /* */
         /* */
-        return crossPlatformPath(HOST_FILE_PATH);
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
     };
     //#endregion
-    //#region utils network / setEtcHost
+    //#region utils etc hosts / get Etc Host Entry By Domain
+    UtilsEtcHosts.getEntriesByDomain = (domain) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils etc hosts / get etc host entries by comment
+    UtilsEtcHosts.getEntryByComment = (commentOfEntry) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils etc hosts / get etc host entries by ip
     /**
-     * Add or update a hosts entry
+     * Returns all host entries for a given IP address.
      */
-    UtilsNetwork.setEtcHost = (domain, ip = '127.0.0.1', comment = '') => {
+    UtilsEtcHosts.getEntriesByIp = (ip) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
         /* */
         /* */
         /* */
         /* */
         /* */
         /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils etc hosts / remove entry by domain
+    UtilsEtcHosts.removeEntryByDomain = (domain) => {
         /* */
         /* */
         /* */
@@ -4286,8 +4900,8 @@ var UtilsNetwork;
         return (void 0);
     };
     //#endregion
-    //#region utils network / get Etc Host Entry By Domain
-    UtilsNetwork.getEtcHostEntryByDomain = (domain) => {
+    //#region utils etc hosts / simulate domain in etc hosts
+    UtilsEtcHosts.simulateDomain = async (domainOrDomains, options) => {
         /* */
         /* */
         /* */
@@ -4321,21 +4935,6 @@ var UtilsNetwork;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils network /  get etc host entries by ip
-    /**
-     * Returns all host entries for a given IP address.
-     *
-     * Example output:
-     *   getEtcHostEntryByIp("127.0.0.1")
-     *   => [
-     *        { domains: ["localhost"], comment: null },
-     *        { domains: ["myapp.local", "dev.local"], comment: "local testing" }
-     *      ]
-     */
-    UtilsNetwork.getEtcHostEntryByIp = (ip) => {
         /* */
         /* */
         /* */
@@ -4366,14 +4965,6 @@ var UtilsNetwork;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils network / removeEtcHost
-    /**
-     * Remove all lines containing the given domain
-     */
-    UtilsNetwork.removeEtcHost = (domain) => {
         /* */
         /* */
         /* */
@@ -4387,27 +4978,12 @@ var UtilsNetwork;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils network / etc host without localhost
-    UtilsNetwork.etcHostHasProperLocalhostIp4Entry = () => {
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    UtilsNetwork.etcHostHasProperLocalhostIp6Entry = () => {
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    // Utility to escape domain for RegExp
-    const escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-    //#region utils network / simulate domain in etc hosts
-    UtilsNetwork.simulateDomain = async (domainOrDomains, options) => {
         /* */
         /* */
         /* */
@@ -4419,6 +4995,16 @@ var UtilsNetwork;
         /* */
         /* */
         /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+})(UtilsEtcHosts || (UtilsEtcHosts = {}));
+//#endregion
+//#region utils network
+var UtilsNetwork;
+(function (UtilsNetwork) {
+    async function checkPing(host, timeoutMs = 3000) {
         /* */
         /* */
         /* */
@@ -4454,9 +5040,18 @@ var UtilsNetwork;
         /* */
         /* */
         /* */
+        /* */
+        /* */
+        return (void 0);
+    }
+    UtilsNetwork.checkPing = checkPing;
+    UtilsNetwork.checkIfServerPings = async (host, timeoutMs = 3000) => {
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    UtilsNetwork.checkIfServerOnline = async (host, port = 80, timeoutMs = 3000) => {
         /* */
         /* */
         /* */
@@ -4474,6 +5069,93 @@ var UtilsNetwork;
         /* */
         /* */
         /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils network / isValidIp
+    UtilsNetwork.isValidIp = (ip) => {
+        if (!_.isString(ip)) {
+            return false;
+        }
+        ip = ip.trim();
+        if (ip === 'localhost') {
+            return true;
+        }
+        return /^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/.test(ip);
+    };
+    //#endregion
+    //#region utils network / isValidDomain
+    UtilsNetwork.isValidDomain = (url, options) => {
+        if (!url || typeof url !== 'string')
+            return false;
+        const shouldIncludeProtocol = !!options?.shouldIncludeProtocol;
+        // Build regex depending on protocol requirement
+        const domainRegex = shouldIncludeProtocol
+            ? /^(https?:\/\/)([a-zA-Z0-9-]{1,63}\.)+[a-zA-Z]{2,}$/ // with protocol
+            : /^([a-zA-Z0-9-]{1,63}\.)+[a-zA-Z]{2,}$/; // without protocol
+        if (typeof options?.shouldIncludeProtocol === 'string' &&
+            options?.shouldIncludeProtocol === 'http' &&
+            !url.startsWith('http://')) {
+            return false; // if http is required, but url does not start with http://
+        }
+        if (typeof options?.shouldIncludeProtocol === 'string' &&
+            options?.shouldIncludeProtocol === 'https' &&
+            !url.startsWith('https://')) {
+            return false; // if https is required, but url does not start with https://
+        }
+        return domainRegex.test(url.trim());
+    };
+    //#endregion
+    //#region utils network / urlParse
+    UtilsNetwork.urlParse = (portOrHost, options) => {
+        options = options || {};
+        let url;
+        const defaultProtocol = options.httpsIfNotProvided ? 'https:' : 'http:';
+        if (portOrHost instanceof URL) {
+            url = portOrHost;
+        }
+        else if (_.isNumber(portOrHost)) {
+            url = new URL(`${defaultProtocol}//localhost:${portOrHost}`);
+        }
+        else if (!_.isNaN(Number(portOrHost))) {
+            url = new URL(`${defaultProtocol}//localhost:${Number(portOrHost)}`);
+        }
+        else if (_.isString(portOrHost)) {
+            try {
+                url = new URL(portOrHost);
+            }
+            catch (error) { }
+            if (UtilsNetwork.isValidIp(portOrHost)) {
+                try {
+                    url = new URL(`${defaultProtocol}//${portOrHost}`);
+                }
+                catch (error) {
+                    Helpers.warn(`Not able to get port from ${portOrHost}`);
+                }
+            }
+            if (options.forceDomain) {
+                const domain = portOrHost;
+                url = new URL(domain.startsWith('http') ? domain : `http://${portOrHost}`);
+            }
+        }
+        return url;
+    };
+    //#endregion
+    //#region utils network / get etc hosts path
+    UtilsNetwork.getEtcHostsPath = UtilsEtcHosts.getPath;
+    //#endregion
+    //#region utils network / simulate domain tag constant
+    /**
+     * @deprecated use UtilsEtcHosts.SIMULATE_DOMAIN_TAG instead
+     */
+    UtilsNetwork.SIMULATE_DOMAIN_TAG = UtilsEtcHosts.SIMULATE_DOMAIN_TAG;
+    //#endregion
+    //#region utils network / setEtcHost
+    /**
+     * Add or update a hosts entry
+     */
+    UtilsNetwork.setEtcHost = (domain, ip = '127.0.0.1', comment = '') => {
         /* */
         /* */
         /* */
@@ -4498,15 +5180,177 @@ var UtilsNetwork;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils network / get Etc Host Entry By Domain
+    /**
+     * @deprecated use UtilsEtcHosts.getEntriesByDomain instead
+     */
+    UtilsNetwork.getEtcHostEntriesByDomain = UtilsEtcHosts.getEntriesByDomain;
+    //#endregion
+    //#region utils network / get etc host entries by comment
+    /**
+     * @deprecated use UtilsEtcHosts.getEntryByComment instead
+     */
+    UtilsNetwork.getEtcHostEntryByComment = UtilsEtcHosts.getEntryByComment;
+    //#endregion
+    //#region utils network / get etc host entries by ip
+    /**
+     * @deprecated use UtilsEtcHosts.getEntriesByIp instead
+     */
+    UtilsNetwork.getEtcHostEntryByIp = UtilsEtcHosts.getEntriesByIp;
+    //#endregion
+    //#region utils network / removeEtcHost
+    /**
+     * Remove all lines containing the given domain
+     * @deprecated use UtilsEtcHosts.removeEntryByDomain instead
+     */
+    UtilsNetwork.removeEtcHost = UtilsEtcHosts.removeEntryByDomain;
+    //#endregion
+    //#region utils network / etc host without localhost
+    UtilsNetwork.etcHostHasProperLocalhostIp4Entry = () => {
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    UtilsNetwork.etcHostHasProperLocalhostIp6Entry = () => {
         /* */
         /* */
         /* */
         return (void 0);
     };
     //#endregion
+    //#region utils network / simulate domain in etc hosts
+    /**
+     * @deprecated use UtilsEtcHosts.simulateDomain instead
+     */
+    UtilsNetwork.simulateDomain = UtilsEtcHosts.simulateDomain;
+    //#endregion
+    //#region utils network / get local public ip addresses / get interface type from name
+    const isVirtualInterface = (name) => {
+        const lname = name.toLowerCase();
+        return (lname.includes('virtual') ||
+            lname.includes('vmware') ||
+            lname.includes('vbox') ||
+            lname.includes('hyper-v') ||
+            lname.includes('wsl') ||
+            lname.includes('docker') ||
+            lname.includes('veth') ||
+            lname.includes('default switch'));
+    };
+    const interfaceTypeFromName = (name) => {
+        const lname = name.toLowerCase();
+        if (isVirtualInterface(lname))
+            return 'virtual';
+        if (lname.includes('eth') || lname.includes('en') || lname.includes('lan'))
+            return 'lan';
+        if (lname.includes('wl') ||
+            lname.includes('wi-fi') ||
+            lname.includes('wifi'))
+            return 'wifi';
+        return 'other';
+    };
+    const sortByPriority = (a, b) => {
+        const typePriority = { lan: 1, wifi: 2, other: 3, virtual: 4 };
+        const pa = typePriority[a.type];
+        const pb = typePriority[b.type];
+        if (pa !== pb)
+            return pa - pb;
+        // Secondary heuristic for tie-breaking (e.g., Ethernet 5 before vEthernet)
+        const nameA = a.interfaceName.toLowerCase();
+        const nameB = b.interfaceName.toLowerCase();
+        // prefer physical-looking names
+        const physPriority = (name) => name.includes('ethernet') && !name.includes('vethernet') ? 0 : 1;
+        const diff = physPriority(nameA) - physPriority(nameB);
+        if (diff !== 0)
+            return diff;
+        return nameA.localeCompare(nameB);
+    };
+    //#endregion
+    //#region utils network / get local public ip addresses / get local ip addresses
+    /**
+     * Returns all local IP addresses in preferred order:
+     * LAN → Wi-Fi → Other → Virtual
+     */
+    UtilsNetwork.getLocalIpAddresses = async () => {
+        const interfaces = os.networkInterfaces();
+        const all = [];
+        for (const [name, addrs] of Object.entries(interfaces)) {
+            if (!addrs)
+                continue;
+            for (const addr of addrs) {
+                if (addr.internal)
+                    continue;
+                all.push({
+                    interfaceName: name,
+                    address: addr.address,
+                    family: addr.family,
+                    internal: addr.internal,
+                    type: interfaceTypeFromName(name),
+                });
+            }
+        }
+        all.sort(sortByPriority);
+        return all;
+    };
+    //#endregion
+    //#region utils network / get local public ip addresses / get first local active ip address
+    /**
+     * Returns first active local ipv4 IP (LAN preferred over Wi-Fi).
+     */
+    UtilsNetwork.getFirstIpV4LocalActiveIpAddress = async () => {
+        const all = await UtilsNetwork.getLocalIpAddresses().then(a => a.filter(f => f.family === 'IPv4'));
+        return all.length > 0 ? all[0].address : null;
+    };
+    //#endregion
+    //#region utils network / get local public ip addresses / get current public ip address
+    /**
+     * Returns current public IP address (or null if undetectable).
+     */
+    UtilsNetwork.getCurrentPublicIpAddress = async () => {
+        const urls = [
+            'https://api.ipify.org?format=json',
+            'https://ifconfig.me/ip',
+            'https://icanhazip.com',
+        ];
+        for (const url of urls) {
+            try {
+                const ip = await new Promise((resolve, reject) => {
+                    https
+                        .get(url, res => {
+                        let data = '';
+                        res.on('data', chunk => (data += chunk));
+                        res.on('end', () => {
+                            try {
+                                const match = data.match(/(\b\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\b)/);
+                                if (match)
+                                    resolve(match[1]);
+                                else if (data.trim().length > 0)
+                                    resolve(data.trim());
+                                else
+                                    reject(new Error('no ip found'));
+                            }
+                            catch (e) {
+                                reject(e);
+                            }
+                        });
+                    })
+                        .on('error', reject)
+                        .setTimeout(3000, () => reject(new Error('timeout')));
+                });
+                if (ip)
+                    return ip;
+            }
+            catch {
+                // try next
+            }
+        }
+        return null;
+    };
+    //#endregion
+    //#endregion
 })(UtilsNetwork || (UtilsNetwork = {}));
 //#endregion
 //#region utils process logger
@@ -5150,6 +5994,8 @@ class HelpersMessages extends HelpersIsomorphic {
         /* */
         /* */
         /* */
+        /* */
+        /* */
     }
     //#endregion
     //#region info
@@ -6745,6 +7591,9 @@ class HelpersCore extends HelpersMessages {
     }
     //#endregion
     //#region methods / kill process
+    /**
+     * @deprecated use UtilsProcess.killProcess
+     */
     killProcess(byPid) {
         /* */
         /* */
@@ -6776,6 +7625,10 @@ class HelpersCore extends HelpersMessages {
     }
     //#endregion
     //#region methods / run
+    /**
+     * @deprecated use UtilsProcess
+     * or native child_process exec, spawn
+     */
     run(command, options) {
         command = Helpers._fixCommand(command);
         // console.log({ command })
@@ -7924,6 +8777,10 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     //#endregion
+    /**
+     * return absolute paths for files inside folder or link to folder
+     * @returns absoulte pathes to files from path
+     */
     getFilesFrom(folderOrLinkToFolder, options = {}) {
         /* */
         /* */
@@ -8164,6 +9021,7 @@ const requiredForDev = {
     ],
 };
 
+//#region imports
 //#endregion
 class CLI {
     static { this.chalk = chalk; }
@@ -8254,5 +9112,5 @@ let Helpers = HelpersCore.InstanceCore;
  * Generated bundle index. Do not edit.
  */
 
-export { $, CLI, CoreConfig, HelpersCore as CoreHelpers, CoreModels, FilePathMetaData, Helpers, PROGRESS_DATA, Utils, UtilsCliClassMethod, UtilsDotFile, UtilsJson, UtilsMigrations, UtilsNetwork, UtilsOs, UtilsProcess, UtilsProcessLogger, UtilsString, UtilsTerminal, UtilsYaml, chalk, child_process, chokidar, crossPlatformPath, fg, fkill, frameworkName, frameworkNameBe, fse, glob, http, https, isElevated, mkdirp, ncp, net, os, path, ps, psList, requiredForDev, rimraf, spawn, win32Path };
+export { $, CLI, CoreConfig, HelpersCore as CoreHelpers, CoreModels, FilePathMetaData, Helpers, PROGRESS_DATA, Utils, UtilsCliClassMethod, UtilsDotFile, UtilsEtcHosts, UtilsJson, UtilsMigrations, UtilsNetwork, UtilsOs, UtilsProcess, UtilsProcessLogger, UtilsString, UtilsTerminal, UtilsYaml, chalk, child_process, chokidar, crossPlatformPath, fg, fkill, frameworkName, frameworkNameBe, fse, glob, http, https, isElevated, mkdirp, ncp, net, os, path, ps, psList, requiredForDev, rimraf, spawn, win32Path };
 //# sourceMappingURL=tnp-core.mjs.map