tnp-core 21.0.159 → 21.0.161

package/browser/fesm2022/tnp-core-browser.mjs

@@ -308,8 +308,8 @@ import { format } from 'date-fns';
 import * as json5 from 'json5';
 export { json5 };
 export { Injectable, inject, signal } from '@angular/core';
-import { Subject, BehaviorSubject } from 'rxjs';
 import 'reflect-metadata';
+import { Subject, BehaviorSubject } from 'rxjs';
 import { parse, printParseErrorCode, modify, applyEdits } from 'jsonc-parser';
 
 let isBrowser = false;
@@ -1372,9 +1372,9 @@ const crossPlatformPath = (pathStringOrPathParts) => {
     }
     if (hasNonAscii) {
         const allNonAscii = pathStringOrPathParts.match(/[^\u0000-\u0080]+/g) || '';
-        Helpers.logWarn(`[taon-core][crossPlatformPath]: path below contains non-ascii characters (${allNonAscii}):
+        console.warn(`[taon-core][crossPlatformPath]: path below contains non-ascii characters (${allNonAscii}):
 "${pathStringOrPathParts}"`);
-        Helpers.logWarn(pathStringOrPathParts);
+        console.warn(pathStringOrPathParts);
     }
     pathStringOrPathParts = (pathStringOrPathParts || '')
         .replace(/\\/g, '/')
@@ -1403,133 +1403,9 @@ const crossPlatformPath = (pathStringOrPathParts) => {
 };
 //#endregion
 
-var CoreModels;
-(function (CoreModels) {
-    CoreModels.InstalationTypeArr = ['-g', '--save', '--save-dev'];
-    let ReleaseVersionTypeEnum;
-    (function (ReleaseVersionTypeEnum) {
-        ReleaseVersionTypeEnum["MAJOR"] = "major";
-        ReleaseVersionTypeEnum["MINOR"] = "minor";
-        ReleaseVersionTypeEnum["PATCH"] = "patch";
-    })(ReleaseVersionTypeEnum = CoreModels.ReleaseVersionTypeEnum || (CoreModels.ReleaseVersionTypeEnum = {}));
-    CoreModels.NpmSpecialVersions = [
-        'latest',
-        'next',
-        'beta',
-        'alpha',
-        'rc',
-        'lts',
-    ];
-    //#endregion
-    //#region environment name
-    let EnvironmentName;
-    (function (EnvironmentName) {
-        /**
-         * Default environment, typically for artifact without application
-         * or for storing common data
-         */
-        EnvironmentName["__"] = "__";
-        /**
-         * Local development environment, typically the developer's machine.
-         */
-        EnvironmentName["LOCALHOST"] = "localhost";
-        /**
-         * Development environment used by engineers to deploy and test new features.
-         */
-        EnvironmentName["DEV"] = "dev";
-        /**
-         * Staging environment used for final validations before production.
-         */
-        EnvironmentName["STAGE"] = "stage";
-        /**
-         * Production environment serving live users.
-         */
-        EnvironmentName["PROD"] = "prod";
-        /**
-         * Cloudflare full backend/frontend deployment
-         */
-        EnvironmentName["CLOUDFLARE"] = "cloudflare";
-        /**
-         * Taon cloud full backend/frontend deployment
-         */
-        EnvironmentName["CLOUD"] = "cloud";
-        /**
-         *  Automated test environment for running unit, integration, or automated tests.
-         */
-        EnvironmentName["TEST"] = "test";
-        /**
-         * Quality assurance environment designated for manual and exploratory testing.
-         */
-        EnvironmentName["QA"] = "qa";
-        /**
-         * Sandbox environment for experimenting and integration without affecting other environments.
-         */
-        EnvironmentName["SANDBOX"] = "sandbox";
-        /**
-         * User Acceptance Testing environment where clients or stakeholders validate the release candidate.
-         */
-        EnvironmentName["UAT"] = "uat";
-        /**
-         * Pre-production environment, closely mirroring production for final testing and validation.
-         */
-        EnvironmentName["PREPROD"] = "preprod";
-        /**
-         * Demonstration environment specifically configured for client presentations and demos.
-         */
-        EnvironmentName["DEMO"] = "demo";
-        /**
-         * Documentation environment for hosting and managing project documentation.
-         */
-        EnvironmentName["DOCS"] = "docs";
-        /**
-         * Demonstration environment ONLY html files, typically used for static pages or documentation.
-         * This environment is not intended for dynamic content or server-side processing.
-         * Perfect to github pages or similar.
-         * It is not intended for production use and should not be used for any critical applications or services.
-         */
-        EnvironmentName["STATIC_PAGES"] = "static-pages";
-        /**
-         * Continuous Integration environment used by CI/CD pipelines for automated builds and deployments.
-         */
-        EnvironmentName["CI"] = "ci";
-        /**
-         * Training environment dedicated to internal team onboarding and training activities.
-         */
-        EnvironmentName["TRAINING"] = "training";
-        /**
-         * Staging environment used for final validations before production.
-         */
-        EnvironmentName["STAGING"] = "staging";
-    })(EnvironmentName = CoreModels.EnvironmentName || (CoreModels.EnvironmentName = {}));
-    CoreModels.EnvironmentNameArr = Object.values(EnvironmentName);
-    function splitEnv(value) {
-        if (!value) {
-            return {
-                envName: value,
-                envNumber: undefined,
-            };
-        }
-        const match = value.match(/^(.+?)(\d+)?$/);
-        if (!match) {
-            return {
-                envName: value,
-                envNumber: undefined,
-            };
-        }
-        return {
-            envName: match[1],
-            envNumber: match[2] !== undefined ? Number(match[2]) : undefined,
-        };
-    }
-    CoreModels.splitEnv = splitEnv;
-    CoreModels.GitConnectionArr = ['https', 'ssh'];
-    CoreModels.ImageFileExtensionArr = [
-        'jpg',
-        'jpeg',
-        'png',
-        'svg',
-    ];
-    CoreModels.HttpMethodArr = [
+var UtilsHttp;
+(function (UtilsHttp) {
+    UtilsHttp.HttpMethodArr = [
         'get',
         'post',
         'put',
@@ -1539,18 +1415,54 @@ var CoreModels;
         'jsonp',
     ];
     //#endregion
-    //#region base project type arr
-    CoreModels.BaseProjectTypeArr = [
-        'typescript',
-        'angular',
-        'angular-lib',
-        'unknown',
-        'unknown-npm-project',
-    ];
+    //#region get status text
+    function getStatusText(code) {
+        const map = {
+            200: 'OK',
+            201: 'Created',
+            202: 'Accepted',
+            204: 'No Content',
+            301: 'Moved Permanently',
+            302: 'Found',
+            304: 'Not Modified',
+            400: 'Bad Request',
+            401: 'Unauthorized',
+            403: 'Forbidden',
+            404: 'Not Found',
+            409: 'Conflict',
+            422: 'Unprocessable Entity',
+            500: 'Internal Server Error',
+            502: 'Bad Gateway',
+            503: 'Service Unavailable',
+        };
+        return map[code] || String(code);
+    }
+    UtilsHttp.getStatusText = getStatusText;
+    //#endregion
+    //#region get mimie type
+    function mimeType(type) {
+        if (type.includes('/')) {
+            return type;
+        }
+        const map = {
+            json: 'application/json',
+            html: 'text/html; charset=utf-8',
+            text: 'text/plain; charset=utf-8',
+            txt: 'text/plain; charset=utf-8',
+            xml: 'application/xml',
+            js: 'application/javascript',
+            css: 'text/css',
+            pdf: 'application/pdf',
+        };
+        return map[type.toLowerCase()] || type;
+    }
+    UtilsHttp.mimeType = mimeType;
     //#endregion
-    //#region mime types / content type
-    // https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types
-    CoreModels.mimeTypes = {
+    //#region mime types
+    /**
+     * https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types
+     */
+    UtilsHttp.mimeTypes = {
         '.aac': 'audio/aac',
         '.abw': 'application/x-abiword',
         '.arc': 'application/x-freearc',
@@ -1628,7 +1540,8 @@ var CoreModels;
         '.3g2': 'video/3gpp2',
         '.7z': 'application/x-7z-compressed',
     };
-    CoreModels.MediaTypeAllArr = [
+    UtilsHttp.MimeTypesObj = UtilsHttp.mimeTypes;
+    UtilsHttp.MediaTypeAllArr = [
         'text',
         'image',
         'audio',
@@ -1639,7 +1552,56 @@ var CoreModels;
         'message',
         'model',
     ];
-    CoreModels.MimeTypesObj = CoreModels.mimeTypes;
+    //#endregion
+})(UtilsHttp || (UtilsHttp = {}));
+
+var CoreModels;
+(function (CoreModels) {
+    CoreModels.InstalationTypeArr = ['-g', '--save', '--save-dev'];
+    let ReleaseVersionTypeEnum;
+    (function (ReleaseVersionTypeEnum) {
+        ReleaseVersionTypeEnum["MAJOR"] = "major";
+        ReleaseVersionTypeEnum["MINOR"] = "minor";
+        ReleaseVersionTypeEnum["PATCH"] = "patch";
+    })(ReleaseVersionTypeEnum = CoreModels.ReleaseVersionTypeEnum || (CoreModels.ReleaseVersionTypeEnum = {}));
+    CoreModels.NpmSpecialVersions = [
+        'latest',
+        'next',
+        'beta',
+        'alpha',
+        'rc',
+        'lts',
+    ];
+    CoreModels.GitConnectionArr = ['https', 'ssh'];
+    CoreModels.ImageFileExtensionArr = [
+        'jpg',
+        'jpeg',
+        'png',
+        'svg',
+    ];
+    /**
+     * @deprecated use tilsHttp.HttpMethodArr
+     */
+    CoreModels.HttpMethodArr = UtilsHttp.HttpMethodArr;
+    //#endregion
+    //#region base project type arr
+    CoreModels.BaseProjectTypeArr = [
+        'typescript',
+        'angular',
+        'angular-lib',
+        'unknown',
+        'unknown-npm-project',
+    ];
+    //#endregion
+    //#region mime types / content type
+    /**
+     * @deprecated use UtilsHttp.mimeTypes
+     */
+    CoreModels.mimeTypes = UtilsHttp.mimeTypes;
+    /**
+     * @deprecated use  UtilsHttp.MediaTypeAllArr
+     */
+    CoreModels.MediaTypeAllArr = UtilsHttp.MediaTypeAllArr;
     CoreModels.BuildWatcherTypeArr = [
         'browser-watcher',
         'websql-watcher',
@@ -2330,32 +2292,15 @@ const taonActionFromParent = 'taon-action-from-parent';
 
 //#region imports
 //#endregion
-var UtilsFilesFoldersSync;
-(function (UtilsFilesFoldersSync) {
-    //#region utils files folders sync / ignore folder files patterns
-    UtilsFilesFoldersSync.IGNORE_FOLDERS_FILES_PATTERNS = [
-        // '**/node_modules/**/*.*',
-        '**/node_modules/**',
-        // '**/node_modules',
-        // '**/git/**/*.*',
-        '**/.git/**/**',
-        // '**/.git',
-        // `**/${dotTaonFolder}/**/*.*`,
-        `**/${dotTaonFolder}/**`,
-        // `**/${dotTaonFolder}`,
-        // `**/${dotTnpFolder}/**/*.*`,
-        `**/${dotTnpFolder}/**`,
-        // `**/${dotTnpFolder}`,
-        '**/tmp-*',
-        // `**/tmp-*/**/*.*`,
-        '**/tmp-*/**',
-    ];
-    //#endregion
-    //#region utils files folders sync / read file
-    UtilsFilesFoldersSync.readFile = (absoluteFilePath, // @ts-ignore
-    options) => {
-        /* */
-        /* */
+var UtilsProcess;
+(function (UtilsProcess) {
+    //#region utils process  / start async child process command until
+    /**
+     * This let you start child process and resolve promise when some
+     * condition is met. It is useful for example when you want to start
+     * process and wait until some output is in stdout or stderr.
+     */
+    UtilsProcess.startAsyncChildProcessCommandUntil = async (command, options) => {
         /* */
         /* */
         /* */
@@ -2396,11 +2341,6 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils files folders sync / write file
-    UtilsFilesFoldersSync.writeFile = (absoluteFilePath, input, options) => {
         /* */
         /* */
         /* */
@@ -2430,6 +2370,11 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils process  / get git bash path
+    UtilsProcess.getGitBashPath = () => {
         /* */
         /* */
         /* */
@@ -2448,6 +2393,15 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils process  / start process in new graphical terminal window
+    /**
+     * TODO IMPLEMENT
+     * start async node process
+     */
+    UtilsProcess.startInNewTerminalWindow = (command, options) => {
         /* */
         /* */
         /* */
@@ -2508,12 +2462,6 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
-        /* */
-        /* */
-        return (void 0);
-    };
-    //#region utils files folders sync / walk fs tree
-    const walkFsTree = (root, options) => {
         /* */
         /* */
         /* */
@@ -2565,6 +2513,14 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils process / get bash or shell name
+    UtilsProcess.getBashOrShellName = () => {
+        //#region @browser
+        return 'browser';
+        //#endregion
         /* */
         /* */
         /* */
@@ -2597,6 +2553,14 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils process / get current process and child processes usage
+    /**
+     * Get CPU and memory usage for a single PID.
+     */
+    UtilsProcess.getUsageForPid = async (pid) => {
         /* */
         /* */
         /* */
@@ -2621,11 +2585,14 @@ var UtilsFilesFoldersSync;
         return (void 0);
     };
     //#endregion
-    //#region utils files folders sync / get files from
+    //#region utils process / get child PIDs
     /**
-     * return absolute paths for files inside folder or link to folder
+     * Return a list of direct child PIDs for the given PID on a Unix-like system.
+     * Uses `ps -o pid= --ppid <pid>` to find child processes.
      */
-    UtilsFilesFoldersSync.getFilesFrom = (folderOrLinkToFolder, options) => {
+    async function getChildPidsUnix(pid) {
+        /* */
+        /* */
         /* */
         /* */
         /* */
@@ -2641,13 +2608,15 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         return (void 0);
-    };
+    }
     //#endregion
-    //#region utils files and folder sync / get folders from
+    //#region utils process / get child PIDs on Windows
     /**
-     * return absolute paths for folders inside folder or link to folder
+     * Return a list of direct child PIDs for the given PID on Windows.
+     * Uses `wmic process where (ParentProcessId=<pid>) get ProcessId` to find child processes.
      */
-    UtilsFilesFoldersSync.getFoldersFrom = (folderOrLinkToFolder, options) => {
+    async function getChildPidsWindows(pid) {
+        /* */
         /* */
         /* */
         /* */
@@ -2662,19 +2631,33 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#endregion
-    UtilsFilesFoldersSync.copyFolder = (sourceDir, destinationDir, options) => {
         /* */
         /* */
+        return (void 0);
+    }
+    //#endregion
+    //#region utils process / get child PIDs once
+    /**
+     * Cross-platform function to list *direct* child PIDs of a given PID.
+     * Uses the appropriate command depending on `process.platform`.
+     */
+    async function getChildPidsOnce(pid) {
         /* */
         /* */
         /* */
         /* */
         /* */
         /* */
+        return (void 0);
+    }
+    UtilsProcess.getChildPidsOnce = getChildPidsOnce;
+    //#endregion
+    //#region utils process / get current process and child usage
+    /**
+     * Get CPU and memory usage for the current process (the Node.js process itself),
+     * plus any child processes spawned by it.
+     */
+    UtilsProcess.getCurrentProcessAndChildUsage = async () => {
         /* */
         /* */
         /* */
@@ -2688,10 +2671,6 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#region utils files folders sync / copy
-    UtilsFilesFoldersSync.copy = (sourceDir, destinationDir, options) => {
         /* */
         /* */
         /* */
@@ -2704,6 +2683,15 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils process / kill all java processes
+    /**
+     * Kills all running Java processes cross‑platform.
+     * @returns Promise<boolean> true if processes were killed, false if none found
+     */
+    UtilsProcess.killAllJava = async () => {
         /* */
         /* */
         /* */
@@ -2731,6 +2719,11 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils process / kill process by pid or child process
+    UtilsProcess.killProcess = async (pidOrProcess) => {
         /* */
         /* */
         /* */
@@ -2757,6 +2750,15 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils process / kill process on port
+    UtilsProcess.killProcessOnPort = async (port) => {
+        if (!port || isNaN(port) || UtilsOs.isBrowser) {
+            Helpers.warn(`[UtilsProcess.killProcessOnPort]: Invalid port number: ${port}`);
+            return false;
+        }
         /* */
         /* */
         /* */
@@ -2813,6 +2815,16 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        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 () => {
         /* */
         /* */
         /* */
@@ -2875,6 +2887,37 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils process / is node version ok
+    UtilsProcess.isNodeVersionOk = (options) => {
+        if (!globalThis || !globalThis.process || !globalThis.process.version) {
+            return false;
+        }
+        options = options || {};
+        options.required = options.required || '18.0.0';
+        const current = globalThis.process.version.replace(/^v/, '');
+        const [curMajor, curMinor, curPatch] = current.split('.').map(Number);
+        const [reqMajor, reqMinor, reqPatch] = options.required
+            .replace(/^v/, '')
+            .split('.')
+            .map(Number);
+        const ok = curMajor > reqMajor ||
+            (curMajor === reqMajor && curMinor > reqMinor) ||
+            (curMajor === reqMajor && curMinor === reqMinor && curPatch >= reqPatch);
+        if (options?.log) {
+            console.log(ok
+                ? `✅ Node.js version OK (required ≥ ${options.required}, current ${current})`
+                : `❌ Node.js version too low (required ≥ ${options.required}, current ${current})`);
+        }
+        if (options?.throwErrorIfNotOk && !ok) {
+            throw new Error(`Node.js version too low (required ≥ ${options.required}, current ${current})`);
+        }
+        return ok;
+    };
+    //#endregion
+    UtilsProcess.getPathOfExecutable = async (command) => {
         /* */
         /* */
         /* */
@@ -2893,14 +2936,95 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+})(UtilsProcess || (UtilsProcess = {}));
+
+//#region imports
+//#endregion
+var UtilsOs;
+(function (UtilsOs) {
+    //#region utils os / is running in browser
+    /**
+     * check if script is running in client browser
+     * (websql model -> is also considered as browser
+     * because it is running in browser)
+     */
+    UtilsOs.isRunningInBrowser = () => {
         /* */
         /* */
+        return true;
+    };
+    //#endregion
+    //#region utils os / is running in node
+    /**
+     * check if script is running in nodejs
+     * (backend script or electron script)
+     */
+    UtilsOs.isRunningInNode = () => {
         /* */
         /* */
+        return false;
+    };
+    //#endregion
+    //#region utils os / is running in websql
+    /**
+     * check if script is running special
+     * browser mode that has sql.js backend
+     * and executes sql queries in browser
+     */
+    UtilsOs.isRunningInWebSQL = () => {
         /* */
         /* */
         /* */
         /* */
+        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
+     * Cloudflare worker
+     */
+    UtilsOs.isRunningInCloudflareWorker = () => {
+        return isCloudflareWorker;
+    };
+    //#endregion
+    //#region utils os / is running in electron
+    /**
+     * check whether the current process is running inside
+     * Electron backend or browser.
+     */
+    UtilsOs.isRunningInElectron = () => {
+        // Electron main or renderer (most reliable)
+        if (typeof process !== 'undefined' && process?.versions?.electron) {
+            return true;
+        }
+        // Renderer with nodeIntegration
+        if (typeof globalThis !== 'undefined' &&
+            globalThis?.process?.type === 'renderer') {
+            return true;
+        }
+        // Renderer with nodeIntegration disabled
+        if (typeof navigator === 'object' &&
+            typeof navigator.userAgent === 'string' &&
+            /Electron/i.test(navigator.userAgent)) {
+            return true;
+        }
+        return false;
+    };
+    //#endregion
+    //#region utils os / is running in vscode extension
+    /**
+     * Check whether the current process is running inside
+     * a Visual Studio Code extension.
+     */
+    UtilsOs.isRunningInVscodeExtension = () => {
         /* */
         /* */
         /* */
@@ -2910,10 +3034,20 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         return (void 0);
+        return false;
     };
     //#endregion
-    //#region utils files folders sync / filter dont copy
-    UtilsFilesFoldersSync.filterDontCopy = (basePathFoldersTosSkip, projectOrBasepath) => {
+    //#region utils os / is running in wsl
+    /**
+     * Check wether the current process is running inside
+     * windows subsystem for linux (WSL).
+     */
+    UtilsOs.isRunningInWsl = () => {
+        //#region @browser
+        return false;
+        //#endregion
+        /* */
+        /* */
         /* */
         /* */
         /* */
@@ -2928,6 +3062,12 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils os / is running in windows / powershell / cmd / gitbash
+    UtilsOs.isRunningInWindowsPowerShell = () => {
         /* */
         /* */
         /* */
@@ -2938,11 +3078,6 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils files folders sync / filter only copy
-    UtilsFilesFoldersSync.filterOnlyCopy = (basePathFoldersOnlyToInclude, projectOrBasepath) => {
         /* */
         /* */
         /* */
@@ -2964,11 +3099,6 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils files folders sync / copy file
-    UtilsFilesFoldersSync.copyFile = (sourcePath, destinationPath, options) => {
         /* */
         /* */
         /* */
@@ -2979,12 +3109,19 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        /* */
+        return (void 0);
+    };
+    UtilsOs.isRunningInWindowsCmd = () => {
         /* */
         /* */
         /* */
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    UtilsOs.isRunningInWindowsGitBash = () => {
         /* */
         /* */
         /* */
@@ -2993,6 +3130,14 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils os / is running in docker
+    UtilsOs.isRunningInDocker = () => {
+        //#region @browser
+        return false;
+        //#endregion
         /* */
         /* */
         /* */
@@ -3038,6 +3183,14 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils os / is running in linux distro
+    /**
+     * check what linux you are running
+     */
+    UtilsOs.isRunningInLinuxDistro = (linuxType) => {
         /* */
         /* */
         /* */
@@ -3064,6 +3217,13 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        //#region @browser
+        return false;
+        //#endregion
+    };
+    //#endregion
+    //#region utils os / is running in linux graphics capable environment
+    UtilsOs.isRunningInLinuxGraphicsCapableEnvironment = () => {
         /* */
         /* */
         /* */
@@ -3074,22 +3234,48 @@ var UtilsFilesFoldersSync;
         return (void 0);
     };
     //#endregion
-    //#region utils files folders sync / move
-    /**
-     * @deprecated use .copy and then .remove on
-     * source folder..
-     *
-     * This method is messing with parcel watcher
-     * (moved files are not detected)
-     */
-    UtilsFilesFoldersSync.move = (from, to, options) => {
+    //#region utils os / is running in os with graphics capable environment
+    UtilsOs.isRunningInOsWithGraphicsCapableEnvironment = () => {
+        /* */
+        /* */
         /* */
         /* */
         /* */
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils os / is running in cli mode
+    /**
+     * Check whether the current process is running in CLI mode.
+     */
+    UtilsOs.isRunningInCliMode = () => {
+        //#region @browser
+        return false;
+        //#endregion
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils os / is running in mocha test
+    /**
+     * Check whether the current process is running in mocha test.
+     */
+    UtilsOs.isRunningInMochaTest = () => {
+        //#region @browser
+        return false;
+        //#endregion
+        /* */
+        /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils os / is port in use
+    const isPortInUseOnHost = (port, host) => {
         /* */
         /* */
         /* */
@@ -3115,6 +3301,16 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    /**
+     * Checks if a given port is already in use (bound by another process).
+     *
+     * @param port - The port number to check.
+     * @param host - The hostname or IP address to bind to (default: '127.0.0.1').
+     * @returns Promise<boolean> - Resolves to `true` if the port is in use, otherwise `false`.
+     */
+    UtilsOs.isPortInUse = async (port, options) => {
         /* */
         /* */
         /* */
@@ -3128,6 +3324,18 @@ var UtilsFilesFoldersSync;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils os / is docker available
+    /**
+     * Check if docker is available on this system
+     * and it is running (daemon active)
+     */
+    UtilsOs.isDockerAvailable = async () => {
+        if (UtilsOs.isBrowser) {
+            return false;
+        }
         /* */
         /* */
         /* */
@@ -3160,39 +3368,96 @@ var UtilsFilesFoldersSync;
         return (void 0);
     };
     //#endregion
-})(UtilsFilesFoldersSync || (UtilsFilesFoldersSync = {}));
-/**
- * TODO @LAST @IN_PROGRESS
- * - utils for files and folders operations
- * - export when ready
- * - should be ready for everything async refactor
- */
-var UtilsFilesFolders;
-(function (UtilsFilesFolders) {
-    //#region utils files folders / ignore folder files patterns
-    /**
-     * Patterns that should be always ignored
-     */
-    UtilsFilesFolders.IGNORE_FOLDERS_FILES_PATTERNS = UtilsFilesFoldersSync.IGNORE_FOLDERS_FILES_PATTERNS;
-    //#endregion
-    //#region utils files folders operations / remove file or folder or link
-    /**
-     * remove file or folder or link
-     */
-    const remove = async (absolutePath, options) => {
+    //#region utils os / open folder in file explorer
+    UtilsOs.openFolderInFileExplorer = (folderPath) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
         /* */
         /* */
         /* */
         /* */
         /* */
         return (void 0);
+        //#region @browser
+        console.warn(`UtilsOs.openFolderInFileExplorer is not supported in browser mode`);
+        //#endregion
     };
     //#endregion
-    //#region utils files folders operations / remove file or folder or link
-    /**
-     * remove file or folder or link
-     */
-    const removeByPattern = async (globPattern, options) => {
+    //#region utils os / get real home directory
+    UtilsOs.getRealHomeDir = () => {
+        //#region @browser
+        return '';
+        //#endregion
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
         /* */
         /* */
         /* */
@@ -3200,10 +3465,38 @@ var UtilsFilesFolders;
         /* */
         return (void 0);
     };
-    //#endregion
-    //#region utils files folders operations / get files from
-    async function getFilesFromAsync(folderOrLinkToFolder, options = {}) {
-        return null;
+    const MANAGED_TEMP_FOLDER_NAME = '__temp__folders__with__exp__date';
+    const TEMP_METADATA_FILE_NAME = '__temp_folder_metadata__.json';
+    UtilsOs.getTempFolder = (options = {}) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
         /* */
         /* */
         /* */
@@ -3261,167 +3554,8 @@ var UtilsFilesFolders;
         /* */
         /* */
         return (void 0);
-    }
-    //#endregion
-    //#region utils files folders operations / read file
-    /**
-     * TODO @IN_PROGRESS
-     */
-    const readFileAsync = async (absoluteFilePath, options) => {
-        return void 0;
-    };
-    /* */
-    /* */
-    /**
-     * TODO @IN_PROGRESS
-     */
-    const writeFileAsync = async (absoluteFilePath, input, options) => {
-        return void 0;
-    };
-    //#endregion
-    //#region utils files folders operations / is existed symlink
-    /**
-     * TODO @IN_PROGRESS
-     */
-    const isExistedSymlink = async (absoluteFilePath) => {
-        return void 0;
-    };
-    //#endregion
-    //#region utils files folders operations / is un existed link
-    /**
-     * TODO @IN_PROGRESS
-     */
-    const isUnExistedLink = async (absoluteFilePath) => {
-        return void 0;
     };
-    //#endregion
-})(UtilsFilesFolders || (UtilsFilesFolders = {}));
-
-var UtilsJson;
-(function (UtilsJson) {
-    //#region get attributes from jsonc or json5 file
-    /**
-     * ! TODO handle packages like zone.js with dot
-     * Get attributes from jsonc or json5 file
-     * @param jsonDeepPath lodash path to property in json ex. deep.path.to.prop
-     * @param fileContent jsonc or json5 - json with comments
-     * @returns array of attributes
-     */
-    UtilsJson.getAtrributiesFromJsonWithComments = (jsonDeepPath, // lodash path to property in json ex. deep.path.to.prop
-    fileContent) => {
-        const lines = fileContent.split('\n');
-        // split path to parts but keep part if is for example 'sql.js
-        const pathParts = jsonDeepPath.split('.').reduce((a, b) => {
-            if (a.length === 0) {
-                return [b];
-            }
-            const last = a[a.length - 1];
-            if ((last.startsWith(`['`) && b.endsWith(`']`)) ||
-                (last.startsWith(`["`) && b.endsWith(`"]`))) {
-                a[a.length - 1] = [last, b].join('.');
-            }
-            else {
-                a.push(b);
-            }
-            return a;
-        }, []);
-        // console.log({ pathParts });
-        // const pathParts = jsonDeepPath.split('.');
-        // const keyName = pathParts.pop()!.replace(/^\["(.+)"\]$/, '$1');
-        const keyName = pathParts.pop().replace(/^\["(.+)"\]$/, '$1');
-        let currentPath = '';
-        let attributes = [];
-        let collectedComments = [];
-        for (const line of lines) {
-            const trimmedLine = line.trim();
-            if (trimmedLine.startsWith('//')) {
-                // Collect comments
-                collectedComments.push(trimmedLine);
-                // trimmedLine.startsWith('//pizda') &&
-                //   console.log('pushlin line', { trimmedLine });
-            }
-            else if (trimmedLine.startsWith('"') || trimmedLine.startsWith("'")) {
-                // Extract the key from the line
-                const match = trimmedLine.match(/["']([^"']+)["']\s*:/);
-                // console.log({ match0: match && match[0], match1: match && match[1] });
-                if (match) {
-                    const key = match[1];
-                    currentPath = currentPath
-                        ? `${currentPath}.${key.includes('.') ? `['${key}']` : key}`
-                        : key;
-                    // console.log({ key });
-                    // Check if the current path matches the jsonDeepPath
-                    if ((currentPath.endsWith(keyName) &&
-                        !currentPath.endsWith('/' + keyName)) ||
-                        currentPath.endsWith(`['${keyName}']`)) {
-                        // console.log('extract attributes', {
-                        //   keyName,
-                        //   collectedCommentsLength: collectedComments.length,
-                        // });
-                        // Process the collected comments to extract attributes
-                        attributes = extractAttributesFromComments(collectedComments);
-                        break;
-                    }
-                    // Reset collected comments as they only relate to the next key
-                    collectedComments = [];
-                }
-            }
-        }
-        return attributes;
-    };
-    //#endregion
-    //#region get attributes from comment
-    UtilsJson.getAttributiesFromComment = (comment, attributes = []) => {
-        // Match @name=value OR @name
-        // Values can be "..." or '...' or unquoted token without @
-        const attrRegex = /@(\w+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s@]+)))?/g;
-        let match;
-        while ((match = attrRegex.exec(comment)) !== null) {
-            const [, name, doubleQuoted, singleQuoted, unquoted] = match;
-            const value = doubleQuoted ?? singleQuoted ?? unquoted;
-            const existingAttribute = attributes.find(attr => attr.name === `@${name}`);
-            if (existingAttribute) {
-                if (value !== undefined) {
-                    if (Array.isArray(existingAttribute.value)) {
-                        existingAttribute.value.push(value);
-                    }
-                    else {
-                        existingAttribute.value = [existingAttribute.value, value];
-                    }
-                }
-            }
-            else {
-                attributes.push({
-                    name: `@${name}`,
-                    value: value !== undefined ? value : true,
-                });
-            }
-        }
-        // Normalize single values not to be arrays
-        attributes.forEach(attr => {
-            if (Array.isArray(attr.value) && attr.value.length === 1) {
-                attr.value = attr.value[0];
-            }
-        });
-        return attributes;
-    };
-    //#endregion
-    //#region extract attributes from comments
-    const extractAttributesFromComments = (comments) => {
-        const attributes = [];
-        // console.log({ comments });
-        for (const comment of comments) {
-            UtilsJson.getAttributiesFromComment(comment, attributes);
-        }
-        return attributes;
-    };
-    //#endregion
-    //#region read json
-    /**
-     * read json from absolute path
-     * @returns json object
-     */
-    UtilsJson.readJson = (absoluteFilePath, defaultValue = {}, useJson5 = false) => {
+    function getSystemTempFolder() {
         /* */
         /* */
         /* */
@@ -3442,55 +3576,98 @@ var UtilsJson;
         /* */
         /* */
         return (void 0);
-    };
-    //#endregion
-    //#region read json with comments
-    UtilsJson.readJsonWithComments = (absoluteFilePath, defaultValue = {}) => {
+    }
+    function cleanupExpiredTempFolders(managedTempRoot) {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
         /* */
         /* */
         return (void 0);
-    };
+    }
+    function sanitizeTempFolderPrefix(prefix) {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    }
+    UtilsOs.EditorArr = [
+        'code',
+        'codium',
+        'cursor',
+        'theia',
+        'idea',
+        'idea64',
+    ];
     //#endregion
-    //#region lodash path validation
-    UtilsJson.validateLodashPath = (lodashGetPath) => {
-        if (_.isArray(lodashGetPath)) {
-            lodashGetPath = lodashGetPath.join('.');
-        }
-        if (!_.isString(lodashGetPath)) {
-            throw new Error(`Invalid lodash path: path cannot be empty.`);
-        }
-        const path = lodashGetPath.trim();
-        /**
-         * Allowed:
-         * foo
-         * foo.bar
-         * foo.bar.baz
-         * foo[0].bar
-         * foo.bar[123].baz
-         *
-         * Rejected:
-         * foo..bar
-         * .foo
-         * foo.
-         * foo[]
-         * foo[abc]
-         * foo[asd].bar
-         */
-        const validPathRegex = /^[a-zA-Z_$][a-zA-Z0-9_$]*(?:\[\d+\])*(?:\.[a-zA-Z_$][a-zA-Z0-9_$]*(?:\[\d+\])*)*$/;
-        if (!validPathRegex.test(path)) {
-            throw new Error(`Invalid lodash path: "${path}"`);
-        }
-        const forbiddenKeys = ['__proto__', 'prototype', 'constructor'];
-        const parts = path.replace(/\[(\d+)\]/g, '.$1').split('.');
-        const forbiddenKey = parts.find(part => forbiddenKeys.includes(part));
-        if (forbiddenKey) {
-            throw new Error(`Invalid lodash path: forbidden key "${forbiddenKey}" in "${path}"`);
-        }
-        return path;
+    //#region utils os / editor processes
+    UtilsOs.EDITOR_PROCESSES = {
+        code: ['code', 'Code'],
+        codium: ['codium', 'VSCodium'],
+        cursor: ['cursor', 'Cursor'],
+        theia: ['theia', 'TheiaIDE'],
+        'code-oss': [
+            'code',
+            'Code',
+            'codium',
+            'VSCodium',
+            'cursor',
+            'Cursor',
+            'theia',
+            'TheiaIDE',
+        ],
+        idea: ['idea', 'idea64', 'IntelliJ IDEA'],
+        idea64: ['idea64', 'idea', 'IntelliJ IDEA'],
     };
     //#endregion
-    //#region get value
-    UtilsJson.getValue = (filepath, lodashGetPath, options) => {
+    //#region utils os / kill procesesses
+    const killProcesses = (names) => {
+        /* */
         /* */
         /* */
         /* */
@@ -3504,6 +3681,12 @@ var UtilsJson;
         /* */
         /* */
         /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils os / kill all editors
+    UtilsOs.killAllEditor = (editor) => {
         /* */
         /* */
         /* */
@@ -3513,8 +3696,8 @@ var UtilsJson;
         return (void 0);
     };
     //#endregion
-    //#region set value
-    UtilsJson.setValue = (filepath, lodashGetPath, value, options) => {
+    //#region utils os / detect editor
+    UtilsOs.detectEditor = (options) => {
         /* */
         /* */
         /* */
@@ -3537,595 +3720,165 @@ var UtilsJson;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-})(UtilsJson || (UtilsJson = {}));
-
-//#region utils process  / start async
-//#endregion
-/**
- * TODO IMPLEMENT
- * start async node process
- */
-const startAsync = async (command, cwd, options) => {
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils os / get editor keybinding path
+    UtilsOs.getEditorKeybindingPath = (editor) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils os / get editor settings json path
+    UtilsOs.getEditorSettingsJsonPath = (editor, platform = process.platform, env = process.env) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils os / is running in node debugger
+    UtilsOs.isRunningNodeDebugger = () => {
+        //#region @browser
+        return false;
+        //#endregion
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils os / is [...]
+    // console.log('kurwa')
+    UtilsOs.isNodeVersionOk = (options) => UtilsProcess.isNodeVersionOk(options);
+    UtilsOs.isElectron = UtilsOs.isRunningInElectron();
+    UtilsOs.isBrowser = UtilsOs.isRunningInBrowser();
+    UtilsOs.isNode = UtilsOs.isRunningInNode();
+    UtilsOs.isWebSQL = UtilsOs.isRunningInWebSQL();
+    UtilsOs.isVscodeExtension = UtilsOs.isRunningInVscodeExtension();
+    UtilsOs.isSSRMode = UtilsOs.isRunningInSSRMode();
+    let isRunningInWindowsTmp = false;
     /* */
     /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    /* */
-    return (void 0);
-};
-//#endregion
-
-//#region imports
-//#endregion
-var UtilsProcess;
-(function (UtilsProcess) {
-    //#region utils process  / start async child process command until
-    /**
-     * This let you start child process and resolve promise when some
-     * condition is met. It is useful for example when you want to start
-     * process and wait until some output is in stdout or stderr.
-     */
-    UtilsProcess.startAsyncChildProcessCommandUntil = async (command, options) => {
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils process  / get git bash path
-    UtilsProcess.getGitBashPath = () => {
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils process  / start process in new graphical terminal window
-    /**
-     * TODO IMPLEMENT
-     * start async node process
-     */
-    UtilsProcess.startInNewTerminalWindow = (command, options) => {
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
+    UtilsOs.isRunningInWindows = isRunningInWindowsTmp;
+    //#endregion
+    //#region utils os / command exists
+    //#region helpers
+    const fileNotExists = async (commandName) => {
         /* */
         /* */
         /* */
@@ -4133,6 +3886,9 @@ var UtilsProcess;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    const fileNotExistsSync = (commandName) => {
         /* */
         /* */
         /* */
@@ -4140,6 +3896,9 @@ var UtilsProcess;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    const localExecutable = async (commandName) => {
         /* */
         /* */
         /* */
@@ -4147,6 +3906,9 @@ var UtilsProcess;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    const localExecutableSync = (commandName) => {
         /* */
         /* */
         /* */
@@ -4157,19 +3919,8 @@ var UtilsProcess;
         return (void 0);
     };
     //#endregion
-    //#region utils process / get bash or shell name
-    UtilsProcess.getBashOrShellName = () => {
-        //#region @browser
-        return 'browser';
-        //#endregion
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
+    //#region command exists (Unix / Windows)
+    const commandExistsUnix = async (commandName) => {
         /* */
         /* */
         /* */
@@ -4185,6 +3936,9 @@ var UtilsProcess;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    const commandExistsWindows = async (commandName) => {
         /* */
         /* */
         /* */
@@ -4196,20 +3950,7 @@ var UtilsProcess;
         /* */
         return (void 0);
     };
-    //#endregion
-    //#region utils process / get current process and child processes usage
-    /**
-     * Get CPU and memory usage for a single PID.
-     */
-    UtilsProcess.getUsageForPid = async (pid) => {
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
+    const commandExistsUnixSync = (commandName) => {
         /* */
         /* */
         /* */
@@ -4225,22 +3966,7 @@ var UtilsProcess;
         /* */
         return (void 0);
     };
-    //#endregion
-    //#region utils process / get child PIDs
-    /**
-     * Return a list of direct child PIDs for the given PID on a Unix-like system.
-     * Uses `ps -o pid= --ppid <pid>` to find child processes.
-     */
-    async function getChildPidsUnix(pid) {
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
+    const commandExistsWindowsSync = (commandName) => {
         /* */
         /* */
         /* */
@@ -4249,20 +3975,10 @@ var UtilsProcess;
         /* */
         /* */
         return (void 0);
-    }
+    };
     //#endregion
-    //#region utils process / get child PIDs on Windows
-    /**
-     * Return a list of direct child PIDs for the given PID on Windows.
-     * Uses `wmic process where (ParentProcessId=<pid>) get ProcessId` to find child processes.
-     */
-    async function getChildPidsWindows(pid) {
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
+    //#region exported API
+    UtilsOs.commandExistsAsync = async (commandName) => {
         /* */
         /* */
         /* */
@@ -4275,35 +3991,19 @@ var UtilsProcess;
         /* */
         /* */
         return (void 0);
-    }
-    //#endregion
-    //#region utils process / get child PIDs once
+    };
     /**
-     * Cross-platform function to list *direct* child PIDs of a given PID.
-     * Uses the appropriate command depending on `process.platform`.
+     * @deprecated use commandExistsAsync
      */
-    async function getChildPidsOnce(pid) {
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        return (void 0);
-    }
-    UtilsProcess.getChildPidsOnce = getChildPidsOnce;
+    UtilsOs.commandExistsSync = (commandName) => {
+        return UtilsOs.isRunningInWindows
+            ? commandExistsWindowsSync(commandName)
+            : commandExistsUnixSync(commandName);
+    };
     //#endregion
-    //#region utils process / get current process and child usage
-    /**
-     * Get CPU and memory usage for the current process (the Node.js process itself),
-     * plus any child processes spawned by it.
-     */
-    UtilsProcess.getCurrentProcessAndChildUsage = async () => {
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
+    //#endregion
+    //#region utils os / python module exists
+    UtilsOs.pipxPackageExists = (packageName) => {
         /* */
         /* */
         /* */
@@ -4311,6 +4011,9 @@ var UtilsProcess;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    UtilsOs.pipxNestedPackageExists = (mainPackageName, targetNestedFromMainPackage) => {
         /* */
         /* */
         /* */
@@ -4326,22 +4029,12 @@ var UtilsProcess;
         /* */
         return (void 0);
     };
-    //#endregion
-    //#region utils process / kill all java processes
-    /**
-     * Kills all running Java processes cross‑platform.
-     * @returns Promise<boolean> true if processes were killed, false if none found
-     */
-    UtilsProcess.killAllJava = async () => {
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
+    const normalizeModuleName = (name) => {
+        return name.replace(/-/g, '_');
+    };
+    UtilsOs.pythonModuleExists = async (moduleName, 
+    // pythonPath = process.platform === 'win32' ? 'python' : 'python3',
+    pythonPath = 'python3') => {
         /* */
         /* */
         /* */
@@ -4363,43 +4056,27 @@ var UtilsProcess;
         return (void 0);
     };
     //#endregion
-    //#region utils process / kill process by pid or child process
-    UtilsProcess.killProcess = async (pidOrProcess) => {
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
+    //#region utils terminal / draw horizontal line
+    UtilsOs.drawHorizontalLine = (row = 0) => {
+        //#region @browser
+        const widthBrowserConsole = row || 80;
+        console.log('-'.repeat(widthBrowserConsole));
+        //#endregion
         /* */
         /* */
         /* */
         /* */
-        return (void 0);
     };
     //#endregion
-    //#region utils process / kill process on port
-    UtilsProcess.killProcessOnPort = async (port) => {
-        if (!port || isNaN(port) || UtilsOs.isBrowser) {
-            Helpers.warn(`[UtilsProcess.killProcessOnPort]: Invalid port number: ${port}`);
-            return false;
-        }
+    //#region utils terminal / draw vertical line
+    UtilsOs.drawVerticalLine = (col = 0) => {
+        //#region @browser
+        const heightBrowserConsole = 20;
+        const line = Array.from({ length: heightBrowserConsole })
+            .map(() => '|')
+            .join('\n');
+        console.log(line);
+        //#endregion
         /* */
         /* */
         /* */
@@ -4409,6 +4086,10 @@ var UtilsProcess;
         /* */
         /* */
         /* */
+    };
+    //#endregion
+    //#region utils os / get inotify watch count (linux)
+    async function getInotifyWatchCount() {
         /* */
         /* */
         /* */
@@ -4453,19 +4134,32 @@ var UtilsProcess;
         /* */
         /* */
         /* */
+        return (void 0);
+    }
+    UtilsOs.getInotifyWatchCount = getInotifyWatchCount;
+    //#endregion
+    //#region utils os / send notification
+    UtilsOs.sendNotification = async (opt) => {
+        //#region prepare  variables
+        const platform = os.platform();
+        const defaultTimeoutMs = 3000;
+        opt = _.cloneDeep(opt);
+        const consoleNotification = `
+
+> NOTIFICATION
+${opt.appName ?? 'App'} / ${opt.title}
+${opt.subtitle ? opt.subtitle + '\n' : ''}${opt.body ?? ''}
+
+`;
+        //#endregion
+        //#region @browser
+        UtilsOs.drawVerticalLine();
+        console.log(consoleNotification);
+        UtilsOs.drawVerticalLine();
+        //#endregion
         /* */
         /* */
         /* */
-        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 () => {
         /* */
         /* */
         /* */
@@ -4528,37 +4222,6 @@ var UtilsProcess;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils process / is node version ok
-    UtilsProcess.isNodeVersionOk = (options) => {
-        if (!globalThis || !globalThis.process || !globalThis.process.version) {
-            return false;
-        }
-        options = options || {};
-        options.required = options.required || '18.0.0';
-        const current = globalThis.process.version.replace(/^v/, '');
-        const [curMajor, curMinor, curPatch] = current.split('.').map(Number);
-        const [reqMajor, reqMinor, reqPatch] = options.required
-            .replace(/^v/, '')
-            .split('.')
-            .map(Number);
-        const ok = curMajor > reqMajor ||
-            (curMajor === reqMajor && curMinor > reqMinor) ||
-            (curMajor === reqMajor && curMinor === reqMinor && curPatch >= reqPatch);
-        if (options?.log) {
-            console.log(ok
-                ? `✅ Node.js version OK (required ≥ ${options.required}, current ${current})`
-                : `❌ Node.js version too low (required ≥ ${options.required}, current ${current})`);
-        }
-        if (options?.throwErrorIfNotOk && !ok) {
-            throw new Error(`Node.js version too low (required ≥ ${options.required}, current ${current})`);
-        }
-        return ok;
-    };
-    //#endregion
-    UtilsProcess.getPathOfExecutable = async (command) => {
         /* */
         /* */
         /* */
@@ -4577,95 +4240,14 @@ var UtilsProcess;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-})(UtilsProcess || (UtilsProcess = {}));
-
-//#region imports
-//#endregion
-var UtilsOs;
-(function (UtilsOs) {
-    //#region utils os / is running in browser
-    /**
-     * check if script is running in client browser
-     * (websql model -> is also considered as browser
-     * because it is running in browser)
-     */
-    UtilsOs.isRunningInBrowser = () => {
         /* */
         /* */
-        return true;
-    };
-    //#endregion
-    //#region utils os / is running in node
-    /**
-     * check if script is running in nodejs
-     * (backend script or electron script)
-     */
-    UtilsOs.isRunningInNode = () => {
         /* */
         /* */
-        return false;
-    };
-    //#endregion
-    //#region utils os / is running in websql
-    /**
-     * check if script is running special
-     * browser mode that has sql.js backend
-     * and executes sql queries in browser
-     */
-    UtilsOs.isRunningInWebSQL = () => {
         /* */
         /* */
         /* */
         /* */
-        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
-     * Cloudflare worker
-     */
-    UtilsOs.isRunningInCloudflareWorker = () => {
-        return isCloudflareWorker;
-    };
-    //#endregion
-    //#region utils os / is running in electron
-    /**
-     * check whether the current process is running inside
-     * Electron backend or browser.
-     */
-    UtilsOs.isRunningInElectron = () => {
-        // Electron main or renderer (most reliable)
-        if (typeof process !== 'undefined' && process?.versions?.electron) {
-            return true;
-        }
-        // Renderer with nodeIntegration
-        if (typeof globalThis !== 'undefined' &&
-            globalThis?.process?.type === 'renderer') {
-            return true;
-        }
-        // Renderer with nodeIntegration disabled
-        if (typeof navigator === 'object' &&
-            typeof navigator.userAgent === 'string' &&
-            /Electron/i.test(navigator.userAgent)) {
-            return true;
-        }
-        return false;
-    };
-    //#endregion
-    //#region utils os / is running in vscode extension
-    /**
-     * Check whether the current process is running inside
-     * a Visual Studio Code extension.
-     */
-    UtilsOs.isRunningInVscodeExtension = () => {
         /* */
         /* */
         /* */
@@ -4674,19 +4256,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-        return false;
-    };
-    //#endregion
-    //#region utils os / is running in wsl
-    /**
-     * Check wether the current process is running inside
-     * windows subsystem for linux (WSL).
-     */
-    UtilsOs.isRunningInWsl = () => {
-        //#region @browser
-        return false;
-        //#endregion
         /* */
         /* */
         /* */
@@ -4695,6 +4264,12 @@ var UtilsOs;
         /* */
         /* */
         /* */
+    };
+    //#endregion
+    //#region utils os / safe exit program clean up fn
+    let isCleaning = false;
+    function safeExitProgramCleanUp(cleanFn) {
+        /* */
         /* */
         /* */
         /* */
@@ -4704,11 +4279,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils os / is running in windows / powershell / cmd / gitbash
-    UtilsOs.isRunningInWindowsPowerShell = () => {
         /* */
         /* */
         /* */
@@ -4752,17 +4322,18 @@ var UtilsOs;
         /* */
         /* */
         return (void 0);
-    };
-    UtilsOs.isRunningInWindowsCmd = () => {
+    }
+    UtilsOs.safeExitProgramCleanUp = safeExitProgramCleanUp;
+    //#endregion
+    //#region utils os / where package locationd
+    UtilsOs.whichOrWherePackageLocated = (packageName) => {
+        /* */
         /* */
         /* */
         /* */
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    UtilsOs.isRunningInWindowsGitBash = () => {
         /* */
         /* */
         /* */
@@ -4771,14 +4342,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils os / is running in docker
-    UtilsOs.isRunningInDocker = () => {
-        //#region @browser
-        return false;
-        //#endregion
         /* */
         /* */
         /* */
@@ -4802,6 +4365,63 @@ var UtilsOs;
         /* */
         /* */
         /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+})(UtilsOs || (UtilsOs = {}));
+//#region taon repo path in user dir fn
+const taonRepoPathUserInUserDirFn = () => {
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    return (void 0);
+    return '';
+};
+//#endregion
+//#region taon repo path for global template fn
+const taonBasePathToGlobalDockerTemplatesFn = () => {
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    return (void 0);
+    return '';
+};
+//#endregion
+
+//#region imports
+//#endregion
+var UtilsFilesFoldersSync;
+(function (UtilsFilesFoldersSync) {
+    //#region utils files folders sync / ignore folder files patterns
+    UtilsFilesFoldersSync.IGNORE_FOLDERS_FILES_PATTERNS = [
+        // '**/node_modules/**/*.*',
+        '**/node_modules/**',
+        // '**/node_modules',
+        // '**/git/**/*.*',
+        '**/.git/**/**',
+        // '**/.git',
+        // `**/${dotTaonFolder}/**/*.*`,
+        `**/${dotTaonFolder}/**`,
+        // `**/${dotTaonFolder}`,
+        // `**/${dotTnpFolder}/**/*.*`,
+        `**/${dotTnpFolder}/**`,
+        // `**/${dotTnpFolder}`,
+        '**/tmp-*',
+        // `**/tmp-*/**/*.*`,
+        '**/tmp-*/**',
+    ];
+    //#endregion
+    //#region utils files folders sync / read file
+    UtilsFilesFoldersSync.readFile = (absoluteFilePath, // @ts-ignore
+    options) => {
         /* */
         /* */
         /* */
@@ -4824,11 +4444,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils os / is running in linux graphics capable environment
-    UtilsOs.isRunningInLinuxGraphicsCapableEnvironment = () => {
         /* */
         /* */
         /* */
@@ -4836,11 +4451,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils os / is running in os with graphics capable environment
-    UtilsOs.isRunningInOsWithGraphicsCapableEnvironment = () => {
         /* */
         /* */
         /* */
@@ -4849,38 +4459,16 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils os / is running in cli mode
-    /**
-     * Check whether the current process is running in CLI mode.
-     */
-    UtilsOs.isRunningInCliMode = () => {
-        //#region @browser
-        return false;
-        //#endregion
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils os / is running in mocha test
-    /**
-     * Check whether the current process is running in mocha test.
-     */
-    UtilsOs.isRunningInMochaTest = () => {
-        //#region @browser
-        return false;
-        //#endregion
         /* */
         /* */
         /* */
         return (void 0);
     };
     //#endregion
-    //#region utils os / is port in use
-    const isPortInUseOnHost = (port, host) => {
+    //#region utils files folders sync / write file
+    UtilsFilesFoldersSync.writeFile = (absoluteFilePath, input, options) => {
         /* */
         /* */
         /* */
@@ -4906,16 +4494,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    /**
-     * Checks if a given port is already in use (bound by another process).
-     *
-     * @param port - The port number to check.
-     * @param host - The hostname or IP address to bind to (default: '127.0.0.1').
-     * @returns Promise<boolean> - Resolves to `true` if the port is in use, otherwise `false`.
-     */
-    UtilsOs.isPortInUse = async (port, options) => {
         /* */
         /* */
         /* */
@@ -4929,18 +4507,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils os / is docker available
-    /**
-     * Check if docker is available on this system
-     * and it is running (daemon active)
-     */
-    UtilsOs.isDockerAvailable = async () => {
-        if (UtilsOs.isBrowser) {
-            return false;
-        }
         /* */
         /* */
         /* */
@@ -4970,11 +4536,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils os / open folder in file explorer
-    UtilsOs.openFolderInFileExplorer = (folderPath) => {
         /* */
         /* */
         /* */
@@ -5005,17 +4566,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-        //#region @browser
-        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
         /* */
         /* */
         /* */
@@ -5028,6 +4578,10 @@ var UtilsOs;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#region utils files folders sync / walk fs tree
+    const walkFsTree = (root, options) => {
         /* */
         /* */
         /* */
@@ -5068,11 +4622,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    const MANAGED_TEMP_FOLDER_NAME = '__temp__folders__with__exp__date';
-    const TEMP_METADATA_FILE_NAME = '__temp_folder_metadata__.json';
-    UtilsOs.getTempFolder = (options = {}) => {
         /* */
         /* */
         /* */
@@ -5139,7 +4688,12 @@ var UtilsOs;
         /* */
         return (void 0);
     };
-    function getSystemTempFolder() {
+    //#endregion
+    //#region utils files folders sync / get files from
+    /**
+     * return absolute paths for files inside folder or link to folder
+     */
+    UtilsFilesFoldersSync.getFilesFrom = (folderOrLinkToFolder, options) => {
         /* */
         /* */
         /* */
@@ -5154,14 +4708,19 @@ var UtilsOs;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils files and folder sync / get folders from
+    /**
+     * return absolute paths for folders inside folder or link to folder
+     */
+    UtilsFilesFoldersSync.getFoldersFrom = (folderOrLinkToFolder, options) => {
         /* */
         /* */
         /* */
         /* */
         /* */
-        return (void 0);
-    }
-    function cleanupExpiredTempFolders(managedTempRoot) {
         /* */
         /* */
         /* */
@@ -5171,6 +4730,11 @@ var UtilsOs;
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#endregion
+    UtilsFilesFoldersSync.copyFolder = (sourceDir, destinationDir, options) => {
         /* */
         /* */
         /* */
@@ -5190,6 +4754,12 @@ var UtilsOs;
         /* */
         /* */
         /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#region utils files folders sync / copy
+    UtilsFilesFoldersSync.copy = (sourceDir, destinationDir, options) => {
         /* */
         /* */
         /* */
@@ -5208,9 +4778,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    }
-    function sanitizeTempFolderPrefix(prefix) {
         /* */
         /* */
         /* */
@@ -5218,39 +4785,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    }
-    UtilsOs.EditorArr = [
-        'code',
-        'codium',
-        'cursor',
-        'theia',
-        'idea',
-        'idea64',
-    ];
-    //#endregion
-    //#region utils os / editor processes
-    UtilsOs.EDITOR_PROCESSES = {
-        code: ['code', 'Code'],
-        codium: ['codium', 'VSCodium'],
-        cursor: ['cursor', 'Cursor'],
-        theia: ['theia', 'TheiaIDE'],
-        'code-oss': [
-            'code',
-            'Code',
-            'codium',
-            'VSCodium',
-            'cursor',
-            'Cursor',
-            'theia',
-            'TheiaIDE',
-        ],
-        idea: ['idea', 'idea64', 'IntelliJ IDEA'],
-        idea64: ['idea64', 'idea', 'IntelliJ IDEA'],
-    };
-    //#endregion
-    //#region utils os / kill procesesses
-    const killProcesses = (names) => {
         /* */
         /* */
         /* */
@@ -5266,22 +4800,12 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils os / kill all editors
-    UtilsOs.killAllEditor = (editor) => {
         /* */
         /* */
         /* */
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils os / detect editor
-    UtilsOs.detectEditor = (options) => {
         /* */
         /* */
         /* */
@@ -5332,11 +4856,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils os / get editor keybinding path
-    UtilsOs.getEditorKeybindingPath = (editor) => {
         /* */
         /* */
         /* */
@@ -5380,11 +4899,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils os / get editor settings json path
-    UtilsOs.getEditorSettingsJsonPath = (editor, platform = process.platform, env = process.env) => {
         /* */
         /* */
         /* */
@@ -5433,36 +4947,8 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils os / is running in node debugger
-    UtilsOs.isRunningNodeDebugger = () => {
-        //#region @browser
-        return false;
-        //#endregion
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils os / is [...]
-    // console.log('kurwa')
-    UtilsOs.isNodeVersionOk = (options) => UtilsProcess.isNodeVersionOk(options);
-    UtilsOs.isElectron = UtilsOs.isRunningInElectron();
-    UtilsOs.isBrowser = UtilsOs.isRunningInBrowser();
-    UtilsOs.isNode = UtilsOs.isRunningInNode();
-    UtilsOs.isWebSQL = UtilsOs.isRunningInWebSQL();
-    UtilsOs.isVscodeExtension = UtilsOs.isRunningInVscodeExtension();
-    UtilsOs.isSSRMode = UtilsOs.isRunningInSSRMode();
-    let isRunningInWindowsTmp = false;
-    /* */
-    /* */
-    UtilsOs.isRunningInWindows = isRunningInWindowsTmp;
-    //#endregion
-    //#region utils os / command exists
-    //#region helpers
-    const fileNotExists = async (commandName) => {
         /* */
         /* */
         /* */
@@ -5470,9 +4956,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    const fileNotExistsSync = (commandName) => {
         /* */
         /* */
         /* */
@@ -5480,9 +4963,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    const localExecutable = async (commandName) => {
         /* */
         /* */
         /* */
@@ -5490,9 +4970,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    const localExecutableSync = (commandName) => {
         /* */
         /* */
         /* */
@@ -5503,8 +4980,8 @@ var UtilsOs;
         return (void 0);
     };
     //#endregion
-    //#region command exists (Unix / Windows)
-    const commandExistsUnix = async (commandName) => {
+    //#region utils files folders sync / filter dont copy
+    UtilsFilesFoldersSync.filterDontCopy = (basePathFoldersTosSkip, projectOrBasepath) => {
         /* */
         /* */
         /* */
@@ -5520,9 +4997,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    const commandExistsWindows = async (commandName) => {
         /* */
         /* */
         /* */
@@ -5534,7 +5008,10 @@ var UtilsOs;
         /* */
         return (void 0);
     };
-    const commandExistsUnixSync = (commandName) => {
+    //#endregion
+    //#region utils files folders sync / filter only copy
+    UtilsFilesFoldersSync.filterOnlyCopy = (basePathFoldersOnlyToInclude, projectOrBasepath) => {
+        /* */
         /* */
         /* */
         /* */
@@ -5548,9 +5025,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    const commandExistsWindowsSync = (commandName) => {
         /* */
         /* */
         /* */
@@ -5561,12 +5035,8 @@ var UtilsOs;
         return (void 0);
     };
     //#endregion
-    //#region exported API
-    UtilsOs.commandExistsAsync = async (commandName) => {
-        /* */
-        /* */
-        /* */
-        /* */
+    //#region utils files folders sync / copy file
+    UtilsFilesFoldersSync.copyFile = (sourcePath, destinationPath, options) => {
         /* */
         /* */
         /* */
@@ -5574,20 +5044,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    /**
-     * @deprecated use commandExistsAsync
-     */
-    UtilsOs.commandExistsSync = (commandName) => {
-        return UtilsOs.isRunningInWindows
-            ? commandExistsWindowsSync(commandName)
-            : commandExistsUnixSync(commandName);
-    };
-    //#endregion
-    //#endregion
-    //#region utils os / python module exists
-    UtilsOs.pipxPackageExists = (packageName) => {
         /* */
         /* */
         /* */
@@ -5595,9 +5051,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    UtilsOs.pipxNestedPackageExists = (mainPackageName, targetNestedFromMainPackage) => {
         /* */
         /* */
         /* */
@@ -5611,14 +5064,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    const normalizeModuleName = (name) => {
-        return name.replace(/-/g, '_');
-    };
-    UtilsOs.pythonModuleExists = async (moduleName, 
-    // pythonPath = process.platform === 'win32' ? 'python' : 'python3',
-    pythonPath = 'python3') => {
         /* */
         /* */
         /* */
@@ -5637,30 +5082,10 @@ var UtilsOs;
         /* */
         /* */
         /* */
-        return (void 0);
-    };
-    //#endregion
-    //#region utils terminal / draw horizontal line
-    UtilsOs.drawHorizontalLine = (row = 0) => {
-        //#region @browser
-        const widthBrowserConsole = row || 80;
-        console.log('-'.repeat(widthBrowserConsole));
-        //#endregion
         /* */
         /* */
         /* */
         /* */
-    };
-    //#endregion
-    //#region utils terminal / draw vertical line
-    UtilsOs.drawVerticalLine = (col = 0) => {
-        //#region @browser
-        const heightBrowserConsole = 20;
-        const line = Array.from({ length: heightBrowserConsole })
-            .map(() => '|')
-            .join('\n');
-        console.log(line);
-        //#endregion
         /* */
         /* */
         /* */
@@ -5670,10 +5095,6 @@ var UtilsOs;
         /* */
         /* */
         /* */
-    };
-    //#endregion
-    //#region utils os / get inotify watch count (linux)
-    async function getInotifyWatchCount() {
         /* */
         /* */
         /* */
@@ -5719,28 +5140,18 @@ var UtilsOs;
         /* */
         /* */
         return (void 0);
-    }
-    UtilsOs.getInotifyWatchCount = getInotifyWatchCount;
+    };
     //#endregion
-    //#region utils os / send notification
-    UtilsOs.sendNotification = async (opt) => {
-        //#region prepare  variables
-        const platform = os.platform();
-        const defaultTimeoutMs = 3000;
-        opt = _.cloneDeep(opt);
-        const consoleNotification = `
-
-> NOTIFICATION
-${opt.appName ?? 'App'} / ${opt.title}
-${opt.subtitle ? opt.subtitle + '\n' : ''}${opt.body ?? ''}
-
-`;
-        //#endregion
-        //#region @browser
-        UtilsOs.drawVerticalLine();
-        console.log(consoleNotification);
-        UtilsOs.drawVerticalLine();
-        //#endregion
+    //#region utils files folders sync / move
+    /**
+     * @deprecated use .copy and then .remove on
+     * source folder..
+     *
+     * This method is messing with parcel watcher
+     * (moved files are not detected)
+     */
+    UtilsFilesFoldersSync.move = (from, to, options) => {
+        /* */
         /* */
         /* */
         /* */
@@ -5813,16 +5224,54 @@ ${opt.subtitle ? opt.subtitle + '\n' : ''}${opt.body ?? ''}
         /* */
         /* */
         /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+})(UtilsFilesFoldersSync || (UtilsFilesFoldersSync = {}));
+/**
+ * TODO @LAST @IN_PROGRESS
+ * - utils for files and folders operations
+ * - export when ready
+ * - should be ready for everything async refactor
+ */
+var UtilsFilesFolders;
+(function (UtilsFilesFolders) {
+    //#region utils files folders / ignore folder files patterns
+    /**
+     * Patterns that should be always ignored
+     */
+    UtilsFilesFolders.IGNORE_FOLDERS_FILES_PATTERNS = UtilsFilesFoldersSync.IGNORE_FOLDERS_FILES_PATTERNS;
+    //#endregion
+    //#region utils files folders operations / remove file or folder or link
+    /**
+     * remove file or folder or link
+     */
+    const 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
+     */
+    const removeByPattern = async (globPattern, options) => {
         /* */
         /* */
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region utils files folders operations / get files from
+    async function getFilesFromAsync(folderOrLinkToFolder, options = {}) {
+        return null;
         /* */
         /* */
         /* */
@@ -5848,11 +5297,6 @@ ${opt.subtitle ? opt.subtitle + '\n' : ''}${opt.body ?? ''}
         /* */
         /* */
         /* */
-    };
-    //#endregion
-    //#region utils os / safe exit program clean up fn
-    let isCleaning = false;
-    function safeExitProgramCleanUp(cleanFn) {
         /* */
         /* */
         /* */
@@ -5884,6 +5328,168 @@ ${opt.subtitle ? opt.subtitle + '\n' : ''}${opt.body ?? ''}
         /* */
         /* */
         /* */
+        return (void 0);
+    }
+    //#endregion
+    //#region utils files folders operations / read file
+    /**
+     * TODO @IN_PROGRESS
+     */
+    const readFileAsync = async (absoluteFilePath, options) => {
+        return void 0;
+    };
+    /* */
+    /* */
+    /**
+     * TODO @IN_PROGRESS
+     */
+    const writeFileAsync = async (absoluteFilePath, input, options) => {
+        return void 0;
+    };
+    //#endregion
+    //#region utils files folders operations / is existed symlink
+    /**
+     * TODO @IN_PROGRESS
+     */
+    const isExistedSymlink = async (absoluteFilePath) => {
+        return void 0;
+    };
+    //#endregion
+    //#region utils files folders operations / is un existed link
+    /**
+     * TODO @IN_PROGRESS
+     */
+    const isUnExistedLink = async (absoluteFilePath) => {
+        return void 0;
+    };
+    //#endregion
+})(UtilsFilesFolders || (UtilsFilesFolders = {}));
+
+var UtilsJson;
+(function (UtilsJson) {
+    //#region get attributes from jsonc or json5 file
+    /**
+     * ! TODO handle packages like zone.js with dot
+     * Get attributes from jsonc or json5 file
+     * @param jsonDeepPath lodash path to property in json ex. deep.path.to.prop
+     * @param fileContent jsonc or json5 - json with comments
+     * @returns array of attributes
+     */
+    UtilsJson.getAtrributiesFromJsonWithComments = (jsonDeepPath, // lodash path to property in json ex. deep.path.to.prop
+    fileContent) => {
+        const lines = fileContent.split('\n');
+        // split path to parts but keep part if is for example 'sql.js
+        const pathParts = jsonDeepPath.split('.').reduce((a, b) => {
+            if (a.length === 0) {
+                return [b];
+            }
+            const last = a[a.length - 1];
+            if ((last.startsWith(`['`) && b.endsWith(`']`)) ||
+                (last.startsWith(`["`) && b.endsWith(`"]`))) {
+                a[a.length - 1] = [last, b].join('.');
+            }
+            else {
+                a.push(b);
+            }
+            return a;
+        }, []);
+        // console.log({ pathParts });
+        // const pathParts = jsonDeepPath.split('.');
+        // const keyName = pathParts.pop()!.replace(/^\["(.+)"\]$/, '$1');
+        const keyName = pathParts.pop().replace(/^\["(.+)"\]$/, '$1');
+        let currentPath = '';
+        let attributes = [];
+        let collectedComments = [];
+        for (const line of lines) {
+            const trimmedLine = line.trim();
+            if (trimmedLine.startsWith('//')) {
+                // Collect comments
+                collectedComments.push(trimmedLine);
+                // trimmedLine.startsWith('//pizda') &&
+                //   console.log('pushlin line', { trimmedLine });
+            }
+            else if (trimmedLine.startsWith('"') || trimmedLine.startsWith("'")) {
+                // Extract the key from the line
+                const match = trimmedLine.match(/["']([^"']+)["']\s*:/);
+                // console.log({ match0: match && match[0], match1: match && match[1] });
+                if (match) {
+                    const key = match[1];
+                    currentPath = currentPath
+                        ? `${currentPath}.${key.includes('.') ? `['${key}']` : key}`
+                        : key;
+                    // console.log({ key });
+                    // Check if the current path matches the jsonDeepPath
+                    if ((currentPath.endsWith(keyName) &&
+                        !currentPath.endsWith('/' + keyName)) ||
+                        currentPath.endsWith(`['${keyName}']`)) {
+                        // console.log('extract attributes', {
+                        //   keyName,
+                        //   collectedCommentsLength: collectedComments.length,
+                        // });
+                        // Process the collected comments to extract attributes
+                        attributes = extractAttributesFromComments(collectedComments);
+                        break;
+                    }
+                    // Reset collected comments as they only relate to the next key
+                    collectedComments = [];
+                }
+            }
+        }
+        return attributes;
+    };
+    //#endregion
+    //#region get attributes from comment
+    UtilsJson.getAttributiesFromComment = (comment, attributes = []) => {
+        // Match @name=value OR @name
+        // Values can be "..." or '...' or unquoted token without @
+        const attrRegex = /@(\w+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s@]+)))?/g;
+        let match;
+        while ((match = attrRegex.exec(comment)) !== null) {
+            const [, name, doubleQuoted, singleQuoted, unquoted] = match;
+            const value = doubleQuoted ?? singleQuoted ?? unquoted;
+            const existingAttribute = attributes.find(attr => attr.name === `@${name}`);
+            if (existingAttribute) {
+                if (value !== undefined) {
+                    if (Array.isArray(existingAttribute.value)) {
+                        existingAttribute.value.push(value);
+                    }
+                    else {
+                        existingAttribute.value = [existingAttribute.value, value];
+                    }
+                }
+            }
+            else {
+                attributes.push({
+                    name: `@${name}`,
+                    value: value !== undefined ? value : true,
+                });
+            }
+        }
+        // Normalize single values not to be arrays
+        attributes.forEach(attr => {
+            if (Array.isArray(attr.value) && attr.value.length === 1) {
+                attr.value = attr.value[0];
+            }
+        });
+        return attributes;
+    };
+    //#endregion
+    //#region extract attributes from comments
+    const extractAttributesFromComments = (comments) => {
+        const attributes = [];
+        // console.log({ comments });
+        for (const comment of comments) {
+            UtilsJson.getAttributiesFromComment(comment, attributes);
+        }
+        return attributes;
+    };
+    //#endregion
+    //#region read json
+    /**
+     * read json from absolute path
+     * @returns json object
+     */
+    UtilsJson.readJson = (absoluteFilePath, defaultValue = {}, useJson5 = false) => {
         /* */
         /* */
         /* */
@@ -5903,14 +5509,57 @@ ${opt.subtitle ? opt.subtitle + '\n' : ''}${opt.body ?? ''}
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region read json with comments
+    UtilsJson.readJsonWithComments = (absoluteFilePath, defaultValue = {}) => {
         /* */
         /* */
         return (void 0);
-    }
-    UtilsOs.safeExitProgramCleanUp = safeExitProgramCleanUp;
+    };
     //#endregion
-    //#region utils os / where package locationd
-    UtilsOs.whichOrWherePackageLocated = (packageName) => {
+    //#region lodash path validation
+    UtilsJson.validateLodashPath = (lodashGetPath) => {
+        if (_.isArray(lodashGetPath)) {
+            lodashGetPath = lodashGetPath.join('.');
+        }
+        if (!_.isString(lodashGetPath)) {
+            throw new Error(`Invalid lodash path: path cannot be empty.`);
+        }
+        const path = lodashGetPath.trim();
+        /**
+         * Allowed:
+         * foo
+         * foo.bar
+         * foo.bar.baz
+         * foo[0].bar
+         * foo.bar[123].baz
+         *
+         * Rejected:
+         * foo..bar
+         * .foo
+         * foo.
+         * foo[]
+         * foo[abc]
+         * foo[asd].bar
+         */
+        const validPathRegex = /^[a-zA-Z_$][a-zA-Z0-9_$]*(?:\[\d+\])*(?:\.[a-zA-Z_$][a-zA-Z0-9_$]*(?:\[\d+\])*)*$/;
+        if (!validPathRegex.test(path)) {
+            throw new Error(`Invalid lodash path: "${path}"`);
+        }
+        const forbiddenKeys = ['__proto__', 'prototype', 'constructor'];
+        const parts = path.replace(/\[(\d+)\]/g, '.$1').split('.');
+        const forbiddenKey = parts.find(part => forbiddenKeys.includes(part));
+        if (forbiddenKey) {
+            throw new Error(`Invalid lodash path: forbidden key "${forbiddenKey}" in "${path}"`);
+        }
+        return path;
+    };
+    //#endregion
+    //#region get value
+    UtilsJson.getValue = (filepath, lodashGetPath, options) => {
+        /* */
         /* */
         /* */
         /* */
@@ -5929,6 +5578,11 @@ ${opt.subtitle ? opt.subtitle + '\n' : ''}${opt.body ?? ''}
         /* */
         /* */
         /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region set value
+    UtilsJson.setValue = (filepath, lodashGetPath, value, options) => {
         /* */
         /* */
         /* */
@@ -5954,20 +5608,389 @@ ${opt.subtitle ? opt.subtitle + '\n' : ''}${opt.body ?? ''}
         return (void 0);
     };
     //#endregion
-})(UtilsOs || (UtilsOs = {}));
+})(UtilsJson || (UtilsJson = {}));
+
+//#region utils process  / start async
 //#endregion
-const taonRepoPathUserInUserDirFn = () => {
+/**
+ * TODO IMPLEMENT
+ * start async node process
+ */
+const startAsync = async (command, cwd, options) => {
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
     /* */
     /* */
     /* */
     /* */
     /* */
     /* */
-    return (void 0);
-    return '';
-};
-//#endregion
-const taonBasePathToGlobalDockerTemplatesFn = () => {
     /* */
     /* */
     /* */
@@ -5975,8 +5998,8 @@ const taonBasePathToGlobalDockerTemplatesFn = () => {
     /* */
     /* */
     return (void 0);
-    return '';
 };
+//#endregion
 
 //#region imports
 //#endregion
@@ -7105,7 +7128,7 @@ var UtilsTerminal;
     UtilsTerminal.fetchAndDisplay = fetchAndDisplay;
 })(UtilsTerminal || (UtilsTerminal = {}));
 
-/* */
+//#region imports
 const WEBSQL_PROC_MOCK_PROCESSES_PID = {};
 const WEBSQL_PROC_MOCK_PROCESSES_PPID = {};
 const KEY = {
@@ -13544,7 +13567,10 @@ class TaonStateMachine {
     constructor(config) {
         this.config = config;
         this._currentValue = config.defaultValue;
-        this.currentStateSubject = new BehaviorSubject(config.defaultValue);
+        this.currentStateSubject = new BehaviorSubject({
+            previousState: config.defaultValue,
+            currentState: config.defaultValue,
+        });
         this.currentState$ = this.currentStateSubject.asObservable();
     }
     get debugMode() {
@@ -13578,12 +13604,282 @@ class TaonStateMachine {
         }
         this._currentValue = nextState;
         // Notify observers only after successful transition.
-        this.currentStateSubject.next(nextState);
+        this.currentStateSubject.next({ previousState, currentState: nextState });
         void this.config.effect?.(nextState, previousState, this.debugMode);
         return true;
     }
 }
 
+var UtilsEnv;
+(function (UtilsEnv) {
+    let EnvironmentName;
+    (function (EnvironmentName) {
+        /**
+         * Default environment, typically for artifact without application
+         * or for storing common data
+         */
+        EnvironmentName["__"] = "__";
+        /**
+         * Local development environment, typically the developer's machine.
+         */
+        EnvironmentName["LOCALHOST"] = "localhost";
+        /**
+         * Development environment used by engineers to deploy and test new features.
+         */
+        EnvironmentName["DEV"] = "dev";
+        /**
+         * Staging environment used for final validations before production.
+         */
+        EnvironmentName["STAGE"] = "stage";
+        /**
+         * Production environment serving live users.
+         */
+        EnvironmentName["PROD"] = "prod";
+        /**
+         * Cloudflare full backend/frontend deployment
+         */
+        EnvironmentName["CLOUDFLARE"] = "cloudflare";
+        /**
+         * Taon cloud full backend/frontend deployment
+         */
+        EnvironmentName["CLOUD"] = "cloud";
+        /**
+         *  Automated test environment for running unit, integration, or automated tests.
+         */
+        EnvironmentName["TEST"] = "test";
+        /**
+         * Quality assurance environment designated for manual and exploratory testing.
+         */
+        EnvironmentName["QA"] = "qa";
+        /**
+         * Sandbox environment for experimenting and integration without affecting other environments.
+         */
+        EnvironmentName["SANDBOX"] = "sandbox";
+        /**
+         * User Acceptance Testing environment where clients or stakeholders validate the release candidate.
+         */
+        EnvironmentName["UAT"] = "uat";
+        /**
+         * Pre-production environment, closely mirroring production for final testing and validation.
+         */
+        EnvironmentName["PREPROD"] = "preprod";
+        /**
+         * Demonstration environment specifically configured for client presentations and demos.
+         */
+        EnvironmentName["DEMO"] = "demo";
+        /**
+         * Documentation environment for hosting and managing project documentation.
+         */
+        EnvironmentName["DOCS"] = "docs";
+        /**
+         * Demonstration environment ONLY html files, typically used for static pages or documentation.
+         * This environment is not intended for dynamic content or server-side processing.
+         * Perfect to github pages or similar.
+         * It is not intended for production use and should not be used for any critical applications or services.
+         */
+        EnvironmentName["STATIC_PAGES"] = "static-pages";
+        /**
+         * Continuous Integration environment used by CI/CD pipelines for automated builds and deployments.
+         */
+        EnvironmentName["CI"] = "ci";
+        /**
+         * Training environment dedicated to internal team onboarding and training activities.
+         */
+        EnvironmentName["TRAINING"] = "training";
+        /**
+         * Staging environment used for final validations before production.
+         */
+        EnvironmentName["STAGING"] = "staging";
+    })(EnvironmentName = UtilsEnv.EnvironmentName || (UtilsEnv.EnvironmentName = {}));
+    UtilsEnv.EnvironmentNameArr = Object.values(EnvironmentName);
+    function getTsFileName({ artifactName, envName, envNumber, }) {
+        return `env.${artifactName}.${envName}${envNumber ?? ''}.ts`;
+    }
+    UtilsEnv.getTsFileName = getTsFileName;
+    /**
+     * @returns envName, envNumber from string that is container
+     * environment. Examples:
+     * - env.angular-node-app.dev.ts > envName: 'dev' , envNumber: undefined
+     * - env.angular-node-app.dev0.ts > envName: 'dev' , envNumber: 0
+     * - env.angular-node-app.dev3.ts > envName: 'dev' , envNumber: 3
+     * - env.prod.ts > envName: 'prod' , envNumber: undefined
+     * - env.prod2.tsx > envName: 'prod' , envNumber: 2
+     * - prod4 > envName: 'prod' , envNumber: 4
+     */
+    function splitEnv(value) {
+        if (!value) {
+            return {
+                envName: value,
+                envNumber: undefined,
+            };
+        }
+        value = value.replace(/\.tsx?$/, '');
+        if (value.startsWith('env.')) {
+            value = value.split('.').pop();
+        }
+        const match = value.match(/^(.+?)(\d+)?$/);
+        if (!match) {
+            return {
+                envName: value,
+                envNumber: undefined,
+            };
+        }
+        return {
+            envName: match[1],
+            envNumber: match[2] !== undefined ? Number(match[2]) : undefined,
+        };
+    }
+    UtilsEnv.splitEnv = splitEnv;
+    //#endregion
+})(UtilsEnv || (UtilsEnv = {}));
+
+var UtilsJwt;
+(function (UtilsJwt) {
+    const encoder = new TextEncoder();
+    const decoder = new TextDecoder();
+    //#region base64 url encode
+    function base64UrlEncode(input) {
+        const bytes = typeof input === 'string' ? encoder.encode(input) : input;
+        let binary = '';
+        for (const byte of bytes) {
+            binary += String.fromCharCode(byte);
+        }
+        return btoa(binary)
+            .replace(/\+/g, '-')
+            .replace(/\//g, '_')
+            .replace(/=+$/g, '');
+    }
+    //#endregion
+    //#region base64 url decode
+    function base64UrlDecode(input) {
+        const base64 = input.replace(/-/g, '+').replace(/_/g, '/');
+        const padded = base64 + '='.repeat((4 - (base64.length % 4)) % 4);
+        const binary = atob(padded);
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++) {
+            bytes[i] = binary.charCodeAt(i);
+        }
+        return bytes;
+    }
+    //#endregion
+    //#region parse expires in
+    function parseExpiresIn(expiresIn) {
+        if (typeof expiresIn === 'number') {
+            return expiresIn;
+        }
+        const match = expiresIn.match(/^(\d+)(s|m|h|d)$/);
+        if (!match) {
+            throw new Error(`Invalid expiresIn: ${expiresIn}`);
+        }
+        const value = Number(match[1]);
+        switch (match[2]) {
+            case 's':
+                return value;
+            case 'm':
+                return value * 60;
+            case 'h':
+                return value * 60 * 60;
+            case 'd':
+                return value * 60 * 60 * 24;
+            default:
+                throw new Error(`Invalid expiresIn: ${expiresIn}`);
+        }
+    }
+    //#endregion
+    //#region create hmac key
+    async function createHmacKey(secret, usage) {
+        return crypto.subtle.importKey('raw', encoder.encode(secret), {
+            name: 'HMAC',
+            hash: 'SHA-256',
+        }, false, [usage]);
+    }
+    //#endregion
+    //#region sign
+    async function sign(payload, secret, options) {
+        const now = Math.floor(Date.now() / 1000);
+        const header = {
+            alg: 'HS256',
+            typ: 'JWT',
+        };
+        const finalPayload = {
+            ...payload,
+            iat: now,
+            exp: now + parseExpiresIn(options.expiresIn),
+        };
+        const encodedHeader = base64UrlEncode(JSON.stringify(header));
+        const encodedPayload = base64UrlEncode(JSON.stringify(finalPayload));
+        const unsignedToken = `${encodedHeader}.${encodedPayload}`;
+        const key = await createHmacKey(secret, 'sign');
+        const signature = await crypto.subtle.sign('HMAC', key, encoder.encode(unsignedToken));
+        return `${unsignedToken}.` + base64UrlEncode(new Uint8Array(signature));
+    }
+    UtilsJwt.sign = sign;
+    //#endregion
+    //#region decode
+    function decode(token) {
+        const parts = token.split('.');
+        if (parts.length !== 3) {
+            throw new Error('Invalid JWT');
+        }
+        try {
+            const payloadBytes = base64UrlDecode(parts[1]);
+            return JSON.parse(decoder.decode(payloadBytes));
+        }
+        catch {
+            throw new Error('Invalid JWT payload');
+        }
+    }
+    UtilsJwt.decode = decode;
+    //#endregion
+    //#region verify
+    async function verify(token, secret) {
+        const parts = token.split('.');
+        if (parts.length !== 3) {
+            throw new Error('Invalid JWT');
+        }
+        const [encodedHeader, encodedPayload, encodedSignature] = parts;
+        //#region validate header
+        let header;
+        try {
+            header = JSON.parse(decoder.decode(base64UrlDecode(encodedHeader)));
+        }
+        catch {
+            throw new Error('Invalid JWT header');
+        }
+        if (header.alg !== 'HS256') {
+            throw new Error(`Unsupported JWT algorithm: ${header.alg}`);
+        }
+        //#endregion
+        //#region verify signature
+        const unsignedToken = `${encodedHeader}.${encodedPayload}`;
+        const signature = base64UrlDecode(encodedSignature);
+        const key = await createHmacKey(secret, 'verify');
+        const valid = await crypto.subtle.verify('HMAC', key, signature, encoder.encode(unsignedToken));
+        if (!valid) {
+            throw new Error('Invalid JWT signature');
+        }
+        //#endregion
+        //#region decode payload
+        let payload;
+        try {
+            payload = JSON.parse(decoder.decode(base64UrlDecode(encodedPayload)));
+        }
+        catch {
+            throw new Error('Invalid JWT payload');
+        }
+        //#endregion
+        //#region validate expiration
+        if (typeof payload.exp === 'number' &&
+            Math.floor(Date.now() / 1000) >= payload.exp) {
+            throw new Error('JWT expired');
+        }
+        //#endregion
+        return payload;
+    }
+    UtilsJwt.verify = verify;
+    //#endregion
+})(UtilsJwt || (UtilsJwt = {}));
+
 const jsoncFormattingOptions = {
     insertSpaces: true,
     tabSize: 2,
@@ -13728,7 +14024,6 @@ const requiredForDev = {
     ],
 };
 
-//#region imports
 //#endregion
 class CLI {
     static { this.chalk = chalk; }
@@ -14115,5 +14410,5 @@ var index = {};
  * Generated bundle index. Do not edit.
  */
 
-export { $, BaselineSiteJoinprefix, CLI, CoreConfig, CoreModels, DbBinaryFormatEnum, ExecAsyncVscodeError, FilePathMetaData, FilesNames, GlobalLibTypeName, GlobalStorage, GlobalTaskManager, GlobalTaskManagerClass, Helpers, LibTypeArr, LibTypeEnum, PREFIXES, REGEX_REGION, TAGS, TaonStateMachine, Utils, UtilsBinary, UtilsCli, UtilsCliClassMethod, UtilsDotFile, UtilsEtcHosts, UtilsExecProc, UtilsFilesFolders, UtilsFilesFoldersSync, UtilsI18n, UtilsJson, UtilsMdDocs, UtilsMessages, UtilsMigrations, UtilsNetwork, UtilsOs, UtilsProcess, UtilsProcessLogger, UtilsProgress, UtilsProjects, UtilsStdinStdoutLogger, UtilsString, UtilsStringRegex, UtilsSudo, UtilsTerminal, UtilsTime, UtilsWaitNotifier, UtilsYaml, _, appRelatedFiles, areTrustedForPatchUpdate, axios, backendNodejsOnlyFiles, backendWebsqlNodejsFiles, baseTaonDevProjectsNames, chalk, child_process, chokidar, config, crossPlatformPath, dateformat, dockerTemplates, dotTaonFolder, dotTnpFolder, encoding, execAsyncVscode, extAllowedToExportAndReplaceTSJSCodeFiles, extAllowedToReplace, extForSassLikeFiles, extForStyles, extTemplatesFiles, fg, fileName, filesNotAllowedToClean, folderName, frameworkName, frameworkNameBe, frontEndOnly, frontendFiles, fse, glob, globalSpinner, http, https, isCloudflareWorker, isElevated, micromatch, mkdirp, ncp, notAllowedNames, notAllowedProjectNames, notNeededForExportFiles, os, path, ps, psList, requireDefault, requiredForDev, rimraf, spawn, startAsync, stateServiceSuffix, taonActionFromParent, taonBasePathToGlobalDockerTemplatesFn, taonContainers, taonCutNextLineCut, taonPackageName, taonProjects, taonRepoPathUserInUserDirFn, taonSkipCut, tempFoldersName, tnpPackageName, updateJsoncContent, urlRepoTaon, urlRepoTaonContainers, win32Path };
+export { $, BaselineSiteJoinprefix, CLI, CoreConfig, CoreModels, DbBinaryFormatEnum, ExecAsyncVscodeError, FilePathMetaData, FilesNames, GlobalLibTypeName, GlobalStorage, GlobalTaskManager, GlobalTaskManagerClass, Helpers, LibTypeArr, LibTypeEnum, PREFIXES, REGEX_REGION, TAGS, TaonStateMachine, Utils, UtilsBinary, UtilsCli, UtilsCliClassMethod, UtilsDotFile, UtilsEnv, UtilsEtcHosts, UtilsExecProc, UtilsFilesFolders, UtilsFilesFoldersSync, UtilsHttp, UtilsI18n, UtilsJson, UtilsJwt, UtilsMdDocs, UtilsMessages, UtilsMigrations, UtilsNetwork, UtilsOs, UtilsProcess, UtilsProcessLogger, UtilsProgress, UtilsProjects, UtilsStdinStdoutLogger, UtilsString, UtilsStringRegex, UtilsSudo, UtilsTerminal, UtilsTime, UtilsWaitNotifier, UtilsYaml, _, appRelatedFiles, areTrustedForPatchUpdate, axios, backendNodejsOnlyFiles, backendWebsqlNodejsFiles, baseTaonDevProjectsNames, chalk, child_process, chokidar, config, crossPlatformPath, dateformat, dockerTemplates, dotTaonFolder, dotTnpFolder, encoding, execAsyncVscode, extAllowedToExportAndReplaceTSJSCodeFiles, extAllowedToReplace, extForSassLikeFiles, extForStyles, extTemplatesFiles, fg, fileName, filesNotAllowedToClean, folderName, frameworkName, frameworkNameBe, frontEndOnly, frontendFiles, fse, glob, globalSpinner, http, https, isCloudflareWorker, isElevated, micromatch, mkdirp, ncp, notAllowedNames, notAllowedProjectNames, notNeededForExportFiles, os, path, ps, psList, requireDefault, requiredForDev, rimraf, spawn, startAsync, stateServiceSuffix, taonActionFromParent, taonBasePathToGlobalDockerTemplatesFn, taonContainers, taonCutNextLineCut, taonPackageName, taonProjects, taonRepoPathUserInUserDirFn, taonSkipCut, tempFoldersName, tnpPackageName, updateJsoncContent, urlRepoTaon, urlRepoTaonContainers, win32Path };
 //# sourceMappingURL=tnp-core-browser.mjs.map