tnp-core 19.0.16 → 19.0.18

package/browser/fesm2022/tnp-core.mjs

@@ -14,16 +14,18 @@ import { Blob as Blob$1 } from 'buffer';
 import axios from 'axios';
 
 let isBrowser = false;
+//#region @browser
 isBrowser = true;
+//#endregion
 const frameworkNameBeTmp = '';
 /* */
 /* */
 /* */
 const frameworkNameBe = frameworkNameBeTmp;
 const frameworkName = isBrowser ? 'taon' : frameworkNameBe;
-;
-({}); // @--end-of-file-for-module=tnp-core lib/framework-name.ts
 
+// TODO finish this MOCK @LAST
+// const c:Chalk = void 0;
 const allObj = {
     black(a) {
         console.log(a);
@@ -63,14 +65,15 @@ for (let i = 0; i < all.length; i++) {
     }
 }
 const chalk$1 = allObj;
-;
-({}); // @--end-of-file-for-module=tnp-core lib/node-chalk-mock.ts
+//#endregion
 
+//#region @browser
 function assertPath(path) {
     if (typeof path !== 'string') {
         throw new TypeError('[taon-core] Path must be a string. Received ' + JSON.stringify(path));
     }
 }
+// Resolves . and .. elements in a path with directory names
 function normalizeStringPosix(path, allowAboveRoot) {
     var res = '';
     var lastSegmentLength = 0;
@@ -86,6 +89,7 @@ function normalizeStringPosix(path, allowAboveRoot) {
             code = 47 /*/*/;
         if (code === 47 /*/*/) {
             if (lastSlash === i - 1 || dots === 1) {
+                // NOOP
             }
             else if (lastSlash !== i - 1 && dots === 2) {
                 if (res.length < 2 ||
@@ -155,6 +159,7 @@ function _format(sep, pathObject) {
     return dir + sep + base;
 }
 const path$1 = {
+    // path.resolve([from ...], to)
     resolve: function resolve(pathToResovle) {
         return pathToResovle;
     },
@@ -164,6 +169,7 @@ const path$1 = {
             return '.';
         var isAbsolute = pathArg.charCodeAt(0) === 47; /*/*/
         var trailingSeparator = pathArg.charCodeAt(pathArg.length - 1) === 47; /*/*/
+        // Normalize the path
         pathArg = normalizeStringPosix(pathArg, !isAbsolute);
         if (pathArg.length === 0 && !isAbsolute)
             pathArg = '.';
@@ -204,6 +210,7 @@ const path$1 = {
         to = path$1.resolve(to);
         if (from === to)
             return '';
+        // Trim any leading backslashes
         var fromStart = 1;
         for (; fromStart < from.length; ++fromStart) {
             if (from.charCodeAt(fromStart) !== 47 /*/*/)
@@ -211,6 +218,7 @@ const path$1 = {
         }
         var fromEnd = from.length;
         var fromLen = fromEnd - fromStart;
+        // Trim any leading backslashes
         var toStart = 1;
         for (; toStart < to.length; ++toStart) {
             if (to.charCodeAt(toStart) !== 47 /*/*/)
@@ -218,6 +226,7 @@ const path$1 = {
         }
         var toEnd = to.length;
         var toLen = toEnd - toStart;
+        // Compare paths to find the longest common path from root
         var length = fromLen < toLen ? fromLen : toLen;
         var lastCommonSep = -1;
         var i = 0;
@@ -225,17 +234,25 @@ const path$1 = {
             if (i === length) {
                 if (toLen > length) {
                     if (to.charCodeAt(toStart + i) === 47 /*/*/) {
+                        // We get here if `from` is the exact base path for `to`.
+                        // For example: from='/foo/bar'; to='/foo/bar/baz'
                         return to.slice(toStart + i + 1);
                     }
                     else if (i === 0) {
+                        // We get here if `from` is the root
+                        // For example: from='/'; to='/foo'
                         return to.slice(toStart + i);
                     }
                 }
                 else if (fromLen > length) {
                     if (from.charCodeAt(fromStart + i) === 47 /*/*/) {
+                        // We get here if `to` is the exact base path for `from`.
+                        // For example: from='/foo/bar/baz'; to='/foo/bar'
                         lastCommonSep = i;
                     }
                     else if (i === 0) {
+                        // We get here if `to` is the root.
+                        // For example: from='/foo'; to='/'
                         lastCommonSep = 0;
                     }
                 }
@@ -249,6 +266,8 @@ const path$1 = {
                 lastCommonSep = i;
         }
         var out = '';
+        // Generate the relative path based on the path difference between `to`
+        // and `from`
         for (i = fromStart + lastCommonSep + 1; i <= fromEnd; ++i) {
             if (i === fromEnd || from.charCodeAt(i) === 47 /*/*/) {
                 if (out.length === 0)
@@ -257,6 +276,8 @@ const path$1 = {
                     out += '/..';
             }
         }
+        // Lastly, append the rest of the destination (`to`) path that comes after
+        // the common path parts
         if (out.length > 0)
             return out + to.slice(toStart + lastCommonSep);
         else {
@@ -286,6 +307,7 @@ const path$1 = {
                 }
             }
             else {
+                // We saw the first non-path separator
                 matchedSlash = false;
             }
         }
@@ -311,6 +333,8 @@ const path$1 = {
             for (i = pathArg.length - 1; i >= 0; --i) {
                 var code = pathArg.charCodeAt(i);
                 if (code === 47 /*/*/) {
+                    // If we reached a path separator that was not part of a set of path
+                    // separators at the end of the string, stop now
                     if (!matchedSlash) {
                         start = i + 1;
                         break;
@@ -318,16 +342,23 @@ const path$1 = {
                 }
                 else {
                     if (firstNonSlashEnd === -1) {
+                        // We saw the first non-path separator, remember this index in case
+                        // we need it if the extension ends up not matching
                         matchedSlash = false;
                         firstNonSlashEnd = i + 1;
                     }
                     if (extIdx >= 0) {
+                        // Try to match the explicit extension
                         if (code === ext.charCodeAt(extIdx)) {
                             if (--extIdx === -1) {
+                                // We matched the extension, so mark this as the end of our path
+                                // component
                                 end = i;
                             }
                         }
                         else {
+                            // Extension does not match, so our result is the entire path
+                            // component
                             extIdx = -1;
                             end = firstNonSlashEnd;
                         }
@@ -343,12 +374,16 @@ const path$1 = {
         else {
             for (i = pathArg.length - 1; i >= 0; --i) {
                 if (pathArg.charCodeAt(i) === 47 /*/*/) {
+                    // If we reached a path separator that was not part of a set of path
+                    // separators at the end of the string, stop now
                     if (!matchedSlash) {
                         start = i + 1;
                         break;
                     }
                 }
                 else if (end === -1) {
+                    // We saw the first non-path separator, mark this as the end of our
+                    // path component
                     matchedSlash = false;
                     end = i + 1;
                 }
@@ -364,10 +399,14 @@ const path$1 = {
         var startPart = 0;
         var end = -1;
         var matchedSlash = true;
+        // Track the state of characters (if any) we see before our first dot and
+        // after any path separator we find
         var preDotState = 0;
         for (var i = pathArg.length - 1; i >= 0; --i) {
             var code = pathArg.charCodeAt(i);
             if (code === 47 /*/*/) {
+                // If we reached a path separator that was not part of a set of path
+                // separators at the end of the string, stop now
                 if (!matchedSlash) {
                     startPart = i + 1;
                     break;
@@ -375,22 +414,29 @@ const path$1 = {
                 continue;
             }
             if (end === -1) {
+                // We saw the first non-path separator, mark this as the end of our
+                // extension
                 matchedSlash = false;
                 end = i + 1;
             }
             if (code === 46 /*.*/) {
+                // If this is our first dot, mark it as the start of our extension
                 if (startDot === -1)
                     startDot = i;
                 else if (preDotState !== 1)
                     preDotState = 1;
             }
             else if (startDot !== -1) {
+                // We saw a non-dot and non-path separator before our dot, so we should
+                // have a good chance at having a non-empty extension
                 preDotState = -1;
             }
         }
         if (startDot === -1 ||
             end === -1 ||
+            // We saw a non-dot character immediately before the dot
             preDotState === 0 ||
+            // The (right-most) trimmed path component is exactly '..'
             (preDotState === 1 && startDot === end - 1 && startDot === startPart + 1)) {
             return '';
         }
@@ -423,10 +469,15 @@ const path$1 = {
         var end = -1;
         var matchedSlash = true;
         var i = pathArg.length - 1;
+        // Track the state of characters (if any) we see before our first dot and
+        // after any path separator we find
         var preDotState = 0;
+        // Get non-dir info
         for (; i >= start; --i) {
             code = pathArg.charCodeAt(i);
             if (code === 47 /*/*/) {
+                // If we reached a path separator that was not part of a set of path
+                // separators at the end of the string, stop now
                 if (!matchedSlash) {
                     startPart = i + 1;
                     break;
@@ -434,22 +485,29 @@ const path$1 = {
                 continue;
             }
             if (end === -1) {
+                // We saw the first non-path separator, mark this as the end of our
+                // extension
                 matchedSlash = false;
                 end = i + 1;
             }
             if (code === 46 /*.*/) {
+                // If this is our first dot, mark it as the start of our extension
                 if (startDot === -1)
                     startDot = i;
                 else if (preDotState !== 1)
                     preDotState = 1;
             }
             else if (startDot !== -1) {
+                // We saw a non-dot and non-path separator before our dot, so we should
+                // have a good chance at having a non-empty extension
                 preDotState = -1;
             }
         }
         if (startDot === -1 ||
             end === -1 ||
+            // We saw a non-dot character immediately before the dot
             preDotState === 0 ||
+            // The (right-most) trimmed path component is exactly '..'
             (preDotState === 1 && startDot === end - 1 && startDot === startPart + 1)) {
             if (end !== -1) {
                 if (startPart === 0 && isAbsolute)
@@ -485,50 +543,90 @@ const path$1 = {
     },
     posix: null,
 };
-;
-({}); // @--end-of-file-for-module=tnp-core lib/node-path-mock.ts
+//#endregion
 
 let forceTrace = false;
+//#region constants
 /* */
 /* */
+//#endregion
+//#region set up browser mocks
+//#region set up browser mocks / mock jquery
 let $;
+//#region @browser
 $ = jQuery;
+//#endregion
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock path
 let path = void 0;
 /* */
 /* */
+//#region @browser
 // @ts-ignore
 path = path$1;
+//#endregion
+//#endregion
+//#region set up browser mocks / mock chalk
 let chalk = void 0;
 /* */
 /* */
+//#region @browser
 // @ts-ignore
 chalk = chalk$1;
+//#endregion
+//#endregion
+//#region set up browser mocks / mock glob
 let glob = void 0;
 /* */
 /* */
+//#region @browser
+// TODO: implement browser glob
+//#endregion
+//#endregion
+//#region set up browser mocks / mock fse
 let fse = void 0;
 /* */
 /* */
+//#region @browser
+// TODO: implement browser fse
+//#endregion
+//#endregion
+//#region set up browser mocks / mock os
 let os = void 0;
 /* */
 /* */
+//#region @browser
+// TODO: implement browser os
+//#endregion
+//#endregion
+//#region set up browser mocks / mock child_process
 let child_process = void 0;
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock http
 let http = void 0;
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock https
 let https = void 0;
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock isRoot
 let isRoot = void 0;
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock isAdmin
 let isAdmin = void 0;
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock isElevated
 /**
  * check if the current process is elevated
  * - sudo in unix/macos
@@ -537,39 +635,65 @@ let isAdmin = void 0;
 let isElevated = void 0;
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock fkill
 let fkill = void 0;
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock psList
 let psList = void 0;
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock net
 let net = void 0;
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock spawn
 let spawn = void 0;
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock minimatch
 let minimatch = void 0;
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock rimraf
 let rimraf = void 0;
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock chokidar
 let chokidar = void 0;
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock mkdirp
 let mkdirp = void 0;
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock ncp
 let ncp = void 0;
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock ps
 let ps = void 0;
 /* */
 /* */
+//#endregion
+//#region set up browser mocks / mock fg
 let fg = void 0;
 /* */
 /* */
+//#endregion
+//#endregion
+//#region crossPlatformPath
+//#region transform unix path to win32 path
 /**
  * transform unix path to win32 path
  */
@@ -583,6 +707,7 @@ const win32Path = (p) => {
     }
     return path.win32.normalize(p);
 };
+//#endregion
 /**
  * This funciton will replace // to /
  */
@@ -593,6 +718,7 @@ const crossPlatformPath = (pathStringOrPathParts) => {
     if (typeof pathStringOrPathParts !== 'string') {
         return pathStringOrPathParts;
     }
+    // debugger;
     if (typeof pathStringOrPathParts === 'string' &&
         /^[A-Z]\:/.test(pathStringOrPathParts)) {
         pathStringOrPathParts = _.lowerFirst(pathStringOrPathParts);
@@ -621,41 +747,22 @@ const crossPlatformPath = (pathStringOrPathParts) => {
     /* */
     /* */
     const regexWinPath1 = /^(\/)[a-zA-Z]\:/;
+    // handle supported gitbash path
+    // (nodejs require need to use /c/ instead of c:/)
     if (isWindows && regexWinPath1.test(pathStringOrPathParts)) {
         pathStringOrPathParts = pathStringOrPathParts.slice(1);
     }
+    // let isUnixLike = !isWindows;
+    // const regexWinPath2 = /^(\\)[a-zA-Z]\:/;
+    // if (isUnixLike && regexWinPath2.test(pathStringOrPathParts)) {
+    //   console.warn(
+    //     `[taon-core][crossPlatformPath]: Path starts with \\ and not from /`,
+    //   );
+    //   console.trace(`path: "${pathStringOrPathParts}"`);
+    // }
     return pathStringOrPathParts;
 };
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-/* */
-;
-({}); // @--end-of-file-for-module=tnp-core lib/core-imports.ts
+//#endregion
 
 var CoreModels;
 (function (CoreModels) {
@@ -668,6 +775,8 @@ var CoreModels;
         'rc',
         'lts',
     ];
+    //#endregion
+    //#region environment name
     /**
      * Available application environments.
      */
@@ -743,6 +852,8 @@ var CoreModels;
         'png',
         'svg',
     ];
+    //#endregion
+    //#region base project type arr
     CoreModels.BaseProjectTypeArr = [
         'typescript',
         'angular',
@@ -750,6 +861,9 @@ var CoreModels;
         'unknown',
         'unknown-npm-project',
     ];
+    //#endregion
+    //#region mime types / content type
+    // https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types
     CoreModels.mimeTypes = {
         '.aac': 'audio/aac',
         '.abw': 'application/x-abiword',
@@ -840,13 +954,16 @@ var CoreModels;
         'model',
     ];
     CoreModels.MimeTypesObj = CoreModels.mimeTypes;
+    //#endregion
 })(CoreModels || (CoreModels = {}));
-;
-({}); // @--end-of-file-for-module=tnp-core lib/core-models.ts
 
+//#region imports
+//#endregion
 const BLOB_SUPPORTED_IN_SQLJS = false;
+//#region utils
 var Utils;
 (function (Utils) {
+    //#region utils / uniq array
     Utils.uniqArray = (array, uniqueProperty) => {
         var seen = {};
         return array
@@ -857,6 +974,8 @@ var Utils;
                 : (seen[uniqueProperty ? item[uniqueProperty] : item] = true);
         });
     };
+    //#endregion
+    //#region utils / recursive sort keys in object
     /**
      * @param anyObject
      * @returns object with sorted keys
@@ -872,6 +991,8 @@ var Utils;
         }
         return anyObject;
     };
+    //#endregion
+    //#region utils / escape string for reg exp
     /**
      * Example:
      * new RegExp(escapeStringForRegEx('a.b.c'),'g') => /a\.b\.c/g
@@ -879,21 +1000,31 @@ var Utils;
     Utils.escapeStringForRegEx = (stringForRegExp) => {
         return stringForRegExp.replace(/[-\/\\^$*+?.()|[\]{}]/g, '\\$&');
     };
+    //#endregion
+    //#region utils / remove chalk special chars
     function removeChalkSpecialChars(str) {
+        // Regex to match ANSI escape sequences used by Chalk
         const ansiRegex = /\u001b\[[0-9;]*m/g;
+        // Replace all ANSI escape sequences with an empty string
         return str.replace(ansiRegex, '');
     }
     Utils.removeChalkSpecialChars = removeChalkSpecialChars;
+    //#endregion
+    //#region utils / full date time
     Utils.fullDateTime = () => {
         /* */
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region utils / full date
     Utils.fullDate = () => {
         /* */
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region utils / get free port
     const takenPorts = [];
     Utils.getFreePort = async (options) => {
         /* */
@@ -928,6 +1059,8 @@ var Utils;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region utils / required uncached
     /**
      * Traverses the cache to search for all the cached
      * files of the specified module name
@@ -982,6 +1115,8 @@ var Utils;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region utils / camelize
     /**
      * similar to camelCase but remove
      * all non word / repeated characters
@@ -999,6 +1134,7 @@ var Utils;
         json.getAtrributies = (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];
@@ -1013,6 +1149,8 @@ var Utils;
                 }
                 return a;
             }, []);
+            // console.log({ pathParts });
+            // const pathParts = jsonDeepPath.split('.');
             const keyName = pathParts.pop().replace(/^\["(.+)"\]$/, '$1');
             let currentPath = '';
             let attributes = [];
@@ -1020,21 +1158,34 @@ var Utils;
             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 = [];
                     }
                 }
@@ -1044,6 +1195,7 @@ var Utils;
         const extractAttributesFromComments = (comments) => {
             const attributes = [];
             const attrRegex = /@(\w+)(?:\s*=\s*([^\s@]+))?/g;
+            // console.log({ comments });
             for (const comment of comments) {
                 let match;
                 while ((match = attrRegex.exec(comment)) !== null) {
@@ -1067,6 +1219,7 @@ var Utils;
                     }
                 }
             }
+            // Normalize single values not to be arrays
             attributes.forEach(attr => {
                 if (Array.isArray(attr.value) && attr.value.length === 1) {
                     attr.value = attr.value[0];
@@ -1075,6 +1228,9 @@ var Utils;
             return attributes;
         };
     })(json = Utils.json || (Utils.json = {}));
+    //#endregion
+    //#region binary
+    //#region db binary format type
     let DbBinaryFormatEnum;
     (function (DbBinaryFormatEnum) {
         DbBinaryFormatEnum["Blob"] = "Blob";
@@ -1085,8 +1241,11 @@ var Utils;
     })(DbBinaryFormatEnum = Utils.DbBinaryFormatEnum || (Utils.DbBinaryFormatEnum = {}));
     /* */
     /* */
+    //#endregion
     let binary;
     (function (binary) {
+        //#region binay utils / array buffer to blob
+        //#region @browser
         /**
          * This is for BROWSER ONLY
          *
@@ -1099,6 +1258,9 @@ var Utils;
             return new Blob$1([buffer], { type: contentType });
         }
         binary.arrayBufferToBlob = arrayBufferToBlob;
+        //#endregion
+        //#endregion
+        //#region binay utils / blob to array buffer
         /**
          * This is for BROWSER ONLY
          * @param blob
@@ -1115,6 +1277,8 @@ var Utils;
             });
         }
         binary.blobToArrayBuffer = blobToArrayBuffer;
+        //#endregion
+        //#region binay utils / blob to base64 string
         /**
          * it is revers to base64toBlob
          * @param blob
@@ -1128,6 +1292,8 @@ var Utils;
             });
         }
         binary.blobToBase64 = blobToBase64;
+        //#endregion
+        //#region binay utils / base64 string to blob
         /**
          * it is revers to blobToBase64()
          * @param base64Data
@@ -1141,6 +1307,7 @@ var Utils;
                 if (!m) {
                     throw new Error(`[taon-framework][base64toBlob] Not a base64 blob [${base64Data}]`);
                 }
+                // tslint:disable-next-line:prefer-const
                 var [__, contenttype, filebase64] = m;
                 content_type = contenttype;
                 file_base64 = filebase64;
@@ -1156,6 +1323,7 @@ var Utils;
                 const begin = sliceIndex * sliceSize;
                 const end = Math.min(begin + sliceSize, bytesLength);
                 const bytes = new Array(end - begin);
+                // tslint:disable-next-line:one-variable-per-declaration
                 for (let offset = begin, i = 0; offset < end; ++i, ++offset) {
                     bytes[i] = byteCharacters[offset].charCodeAt(0);
                 }
@@ -1164,8 +1332,11 @@ var Utils;
             return new Blob$1(byteArrays, { type: content_type });
         }
         binary.base64toBlob = base64toBlob;
+        //#endregion
+        //#region binay utils / base64 string to db binary format
         async function base64toDbBinaryFormat(text) {
             let result;
+            //#region @browser
             result = await (async () => {
                 if (BLOB_SUPPORTED_IN_SQLJS) {
                     const blob = await base64toBlob(text);
@@ -1173,6 +1344,7 @@ var Utils;
                 }
                 return text;
             })();
+            //#endregion
             /* */
             /* */
             /* */
@@ -1181,8 +1353,11 @@ var Utils;
             return result;
         }
         binary.base64toDbBinaryFormat = base64toDbBinaryFormat;
+        //#endregion
+        //#region binay utils / db binary format to base64 string
         async function dbBinaryFormatToBase64(binaryFormat) {
             let result;
+            //#region @browser
             result = await (async () => {
                 if (BLOB_SUPPORTED_IN_SQLJS) {
                     const text = await blobToBase64(binaryFormat);
@@ -1190,6 +1365,7 @@ var Utils;
                 }
                 return binaryFormat;
             })();
+            //#endregion
             /* */
             /* */
             /* */
@@ -1198,8 +1374,11 @@ var Utils;
             return result;
         }
         binary.dbBinaryFormatToBase64 = dbBinaryFormatToBase64;
+        //#endregion
+        //#region binay utils / base64 string to db binary format
         async function textToDbBinaryFormat(text) {
             let result;
+            //#region @browser
             result = await (async () => {
                 if (BLOB_SUPPORTED_IN_SQLJS) {
                     const blob = await textToBlob(text);
@@ -1207,6 +1386,7 @@ var Utils;
                 }
                 return text;
             })();
+            //#endregion
             /* */
             /* */
             /* */
@@ -1215,8 +1395,11 @@ var Utils;
             return result;
         }
         binary.textToDbBinaryFormat = textToDbBinaryFormat;
+        //#endregion
+        //#region binay utils / db binary format to base64 string
         async function dbBinaryFormatToText(binaryFormat) {
             let result;
+            //#region @browser
             result = await (async () => {
                 if (BLOB_SUPPORTED_IN_SQLJS) {
                     const text = await blobToText(binaryFormat);
@@ -1224,6 +1407,7 @@ var Utils;
                 }
                 return binaryFormat;
             })();
+            //#endregion
             /* */
             /* */
             /* */
@@ -1232,6 +1416,8 @@ var Utils;
             return result;
         }
         binary.dbBinaryFormatToText = dbBinaryFormatToText;
+        //#endregion
+        //#region binay utils / base64 string to nodejs buffer
         /* */
         /* */
         /* */
@@ -1241,18 +1427,24 @@ var Utils;
         /* */
         /* */
         /* */
+        //#endregion
+        //#region binay utils / nodejs buffer to base64 string
         /* */
         /* */
         /* */
         /* */
         /* */
         /* */
+        //#endregion
+        //#region binay utils / file to blob
         async function fileToBlob(file) {
             return new Blob$1([new Uint8Array(await file.arrayBuffer())], {
                 type: file.type,
             });
         }
         binary.fileToBlob = fileToBlob;
+        //#endregion
+        //#region binay utils / blob to file
         async function blobToFile(blob, nameForFile = 'my-file-name') {
             if (!nameForFile) {
                 nameForFile = 'nonamefile' + new Date().getTime();
@@ -1261,17 +1453,23 @@ var Utils;
             return new File([blob], nameForFile);
         }
         binary.blobToFile = blobToFile;
+        //#endregion
+        //#region binay utils / nodejs blob to nodejs buffer
         /* */
         /* */
         /* */
         /* */
         /* */
         /* */
+        //#endregion
+        //#region binay utils / nodejs buffer to nodejs blob
         /* */
         /* */
         /* */
         /* */
         /* */
+        //#endregion
+        //#region binay utils / text to nodejs buffer
         /* */
         /* */
         /* */
@@ -1281,33 +1479,51 @@ var Utils;
         /* */
         /* */
         /* */
+        //#endregion
+        //#region binay utils / nodejs buffer to text
         /* */
         /* */
         /* */
         /* */
         /* */
         /* */
+        //#endregion
+        //#region binay utils / text to blob
         async function textToBlob(text, type = 'text/plain') {
             const blob = new Blob$1([text], { type });
             return blob;
         }
         binary.textToBlob = textToBlob;
+        //#endregion
+        //#region binay utils / blob to text
         async function blobToText(blob) {
             return await blob.text();
         }
         binary.blobToText = blobToText;
+        //#endregion
+        //#region binay utils / text to file
         async function textToFile(text, fileRelativePathOrName) {
+            // console.log({ path })
             const ext = path.extname(fileRelativePathOrName);
             const type = CoreModels.mimeTypes[ext];
             const blob = new Blob$1([text], { type });
             const file = await blobToFile(blob, fileRelativePathOrName);
+            // console.log({
+            //   ext,
+            //   blob, file
+            // });
+            // debugger
             return file;
         }
         binary.textToFile = textToFile;
+        //#endregion
+        //#region binay utils / file to text
         async function fileToText(file) {
             return await file.text();
         }
         binary.fileToText = fileToText;
+        //#endregion
+        //#region binay utils / json to blob
         async function jsonToBlob(jsonObj) {
             const blob = new Blob$1([JSON.stringify(jsonObj, null, 2)], {
                 type: 'application/json',
@@ -1315,6 +1531,8 @@ var Utils;
             return blob;
         }
         binary.jsonToBlob = jsonToBlob;
+        //#endregion
+        //#region binay utils / blob to json
         /**
          * TODO NOT TESTED
          */
@@ -1322,6 +1540,8 @@ var Utils;
             return JSON.parse(await blob.text());
         }
         binary.blobToJson = blobToJson;
+        //#endregion
+        //#region binay utils / get blob from url
         async function getBlobFrom(url) {
             const response = await axios({
                 url,
@@ -1331,27 +1551,40 @@ var Utils;
             return response.data;
         }
         binary.getBlobFrom = getBlobFrom;
+        //#endregion
     })(binary = Utils.binary || (Utils.binary = {}));
+    //#endregion
+    //#region css
     let css;
     (function (css) {
+        //#region css utils / numeric value of pixels
         /**
          *
          * @param pixelsCss pixels ex. 100px
          * @returns
          */
         function numValue(pixelsCss) {
+            // tslint:disable-next-line:radix
             return parseInt(pixelsCss?.toString()?.replace('px', ''));
         }
         css.numValue = numValue;
+        //#endregion
     })(css = Utils.css || (Utils.css = {}));
+    //#endregion
 })(Utils || (Utils = {}));
+//#endregion
+//#region utils process
 var UtilsProcess;
 (function (UtilsProcess) {
+    //#endregion
+    //#region utils process  / TODO start async
     /**
      * TODO IMPLEMENT
      * start async node process
      */
-    UtilsProcess.startAsync = async (command, cwd, options) => {
+    UtilsProcess.startAsync = async (command, cwd, 
+    // options?: ProcessStartOptions, // TODO change to this
+    options) => {
         /* */
         /* */
         /* */
@@ -1639,6 +1872,16 @@ var UtilsProcess;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region utils process  / TODO start sync
+    // /**
+    //  * TODO IMPLEMENT
+    //  */
+    // export function startSync(command: string, options?: ProcessStartOptions) {
+    // TODO @LAST
+    // }
+    //#endregion
+    //#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
@@ -1712,6 +1955,8 @@ var UtilsProcess;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region utils process  / get git bash path
     UtilsProcess.getGitBashPath = () => {
         /* */
         /* */
@@ -1733,6 +1978,8 @@ var UtilsProcess;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region utils process  / start process in new graphical terminal window
     /**
      * TODO IMPLEMENT
      * start async node process
@@ -1849,8 +2096,12 @@ var UtilsProcess;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region utils process / get bash or shell name
     UtilsProcess.getBashOrShellName = () => {
+        //#region @browser
         return 'browser';
+        //#endregion
         /* */
         /* */
         /* */
@@ -1885,6 +2136,7 @@ var UtilsProcess;
         /* */
         return (void 0);
     };
+    //#endregion
     /**
      * Get CPU and memory usage for a single PID.
      */
@@ -2004,8 +2256,11 @@ var UtilsProcess;
         return (void 0);
     };
 })(UtilsProcess || (UtilsProcess = {}));
+//#endregion
+//#region utils os
 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
@@ -2016,6 +2271,8 @@ var UtilsOs;
         /* */
         return true;
     };
+    //#endregion
+    //#region utils os / is running in node
     /**
      * check if script is running in nodejs
      * (backend script or electron script)
@@ -2025,6 +2282,8 @@ var UtilsOs;
         /* */
         return false;
     };
+    //#endregion
+    //#region utils os / is running in websql
     /**
      * check if script is running special
      * browser mode that has sql.js backend
@@ -2037,11 +2296,14 @@ var UtilsOs;
         /* */
         return false;
     };
+    //#endregion
+    //#region utils os / is running in electron
     /**
      * check whether the current process is running inside
      * Electron backend or browser.
      */
     UtilsOs.isRunningInElectron = () => {
+        // Renderer process
         // @ts-ignore
         if (typeof window !== 'undefined' &&
             typeof window.process === 'object' &&
@@ -2049,12 +2311,14 @@ var UtilsOs;
             window.process.type === 'renderer') {
             return true;
         }
+        // Main process
         // @ts-ignore
         if (typeof process !== 'undefined' &&
             typeof process.versions === 'object' &&
             !!process.versions.electron) {
             return true;
         }
+        // Detect the user agent when the `nodeIntegration` option is set to false
         if (typeof navigator === 'object' &&
             typeof navigator.userAgent === 'string' &&
             navigator.userAgent.indexOf('Electron') >= 0) {
@@ -2062,6 +2326,8 @@ var UtilsOs;
         }
         return false;
     };
+    //#endregion
+    //#region utils os / is running in vscode extension
     /**
      * Check whether the current process is running inside
      * a Visual Studio Code extension.
@@ -2077,12 +2343,16 @@ var UtilsOs;
         /* */
         return (void 0);
     };
+    //#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
         /* */
         /* */
         /* */
@@ -2102,6 +2372,8 @@ var UtilsOs;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region utils os / is running in windows / powershell / cmd
     const getProcessTree = () => {
         /* */
         /* */
@@ -2160,8 +2432,12 @@ var UtilsOs;
     UtilsOs.isRunningInWindowsCmd = () => {
         return findAncestorProcessName(['cmd.exe']) !== undefined;
     };
+    //#endregion
+    //#region utils os / is running in docker
     UtilsOs.isRunningInDocker = () => {
+        //#region @browser
         return false;
+        //#endregion
         /* */
         /* */
         /* */
@@ -2171,6 +2447,8 @@ var UtilsOs;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region utils os / is running in linux graphics capable environment
     UtilsOs.isRunningInLinuxGraphicsCapableEnvironment = () => {
         /* */
         /* */
@@ -2181,24 +2459,34 @@ 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) => {
         /* */
         /* */
@@ -2249,16 +2537,26 @@ var UtilsOs;
         /* */
         return (void 0);
     };
+    //#endregion
 })(UtilsOs || (UtilsOs = {}));
+//#endregion
+//#region utils string
 var UtilsString;
 (function (UtilsString) {
+    //#region utils string / kebab case no split numbers
     UtilsString.kebabCaseNoSplitNumbers = (input) => {
         return (input
+            // Match spaces or any kind of whitespace and replace with a hyphen
             .replace(/\s+/g, '-')
+            // Match uppercase letters and replace them with a hyphen and the lowercase version of the letter
             .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+            // Convert everything to lowercase
             .toLowerCase());
     };
+    //#endregion
 })(UtilsString || (UtilsString = {}));
+//#endregion
+//#region utils migrations
 /**
  * Taon migration utilities
  */
@@ -2266,6 +2564,7 @@ var UtilsMigrations;
 (function (UtilsMigrations) {
     UtilsMigrations.getTimestampFromClassName = (className) => {
         const [maybeTimestamp1, maybeTimestamp2] = className.split('_') || [];
+        // console.log({ maybeTimestamp1, maybeTimestamp2 });
         const timestamp1 = parseInt(maybeTimestamp1);
         const timestamp2 = parseInt(maybeTimestamp2);
         const timestamp = !_.isNaN(timestamp1) ? timestamp1 : timestamp2;
@@ -2291,8 +2590,12 @@ var UtilsMigrations;
         return value >= minTimestamp && value <= maxTimestamp;
     };
 })(UtilsMigrations || (UtilsMigrations = {}));
+//#endregion
+//#region utils terminal
 var UtilsTerminal;
 (function (UtilsTerminal) {
+    //#endregion
+    //#region wait
     UtilsTerminal.wait = (second) => {
         return new Promise((resolve, reject) => {
             setTimeout(() => {
@@ -2300,6 +2603,8 @@ var UtilsTerminal;
             }, second * 1000);
         });
     };
+    //#endregion
+    //#region clear
     UtilsTerminal.clearConsole = () => {
         /* */
         /* */
@@ -2314,6 +2619,8 @@ var UtilsTerminal;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region transform choices
     const transformChoices = (choices) => {
         /* */
         /* */
@@ -2334,6 +2641,8 @@ var UtilsTerminal;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region multiselect
     UtilsTerminal.multiselect = async (options) => {
         /* */
         /* */
@@ -2419,6 +2728,8 @@ var UtilsTerminal;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region select and execute
     /**
      * Similar to select but executes action if provided
      * @returns selected and executed value
@@ -2466,6 +2777,8 @@ var UtilsTerminal;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region select and execute
     /**
      * Similar to select but executes action if provided
      * @returns selected and executed value
@@ -2508,6 +2821,8 @@ var UtilsTerminal;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region select
     UtilsTerminal.select = async (options) => {
         /* */
         /* */
@@ -2571,11 +2886,15 @@ var UtilsTerminal;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region pipe enter to stdin
     UtilsTerminal.pipeEnterToStdin = () => {
         /* */
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region input
     UtilsTerminal.input = async ({ defaultValue, question, required, // TODO something is werid with required
      }) => {
         /* */
@@ -2596,6 +2915,8 @@ var UtilsTerminal;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region confirm
     UtilsTerminal.confirm = async (options) => {
         /* */
         /* */
@@ -2678,6 +2999,8 @@ var UtilsTerminal;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region press any key to continue
     UtilsTerminal.pressAnyKeyToContinueAsync = (options) => {
         /* */
         /* */
@@ -2699,6 +3022,8 @@ var UtilsTerminal;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region press any key
     /**
      * @deprecated use UtilsTerminal.pressAnyKeyToContinueAsync()
      */
@@ -2732,6 +3057,8 @@ var UtilsTerminal;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region preview long list as select
     UtilsTerminal.previewLongList = async (list, listName = 'List') => {
         /* */
         /* */
@@ -2752,6 +3079,8 @@ var UtilsTerminal;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region preview long list with 'less' (git log like)
     /**
      * Displays a long list in the console using a pager like `less`.
      * Returns a Promise that resolves when the user exits the pager.
@@ -2786,9 +3115,9 @@ var UtilsTerminal;
         /* */
         return (void 0);
     };
+    //#endregion
 })(UtilsTerminal || (UtilsTerminal = {}));
-;
-({}); // @--end-of-file-for-module=tnp-core lib/utils.ts
+//#endregion
 
 class HelpersIsomorphic {
     /**
@@ -2838,9 +3167,8 @@ class HelpersIsomorphic {
         }).length > 0);
     }
 }
-;
-({}); // @--end-of-file-for-module=tnp-core lib/helpers-isomorphic.ts
 
+// TODO handle global.testMode ?
 const KEY = {
     LAST_ERROR: Symbol(),
     LAST_INFO: Symbol(),
@@ -2890,12 +3218,16 @@ const KEY_IMPORTANTCE = {
 /* */
 /* */
 const LIMIT = 10;
+//#region transformData
 /**
  * @param details any data to be transformed
  * @returns string ready to be displayed
  */
 const transformData = (details) => {
     if (typeof details === 'object') {
+        // if (Array.isArray(details)) {
+        //   return details.join('\n');
+        // }
         try {
             const json = JSON.stringify(details, null, 2);
             details = json;
@@ -2906,6 +3238,7 @@ const transformData = (details) => {
     }
     return details;
 };
+//#endregion
 class HelpersMessages extends HelpersIsomorphic {
     msgCacheClear() {
         /* */
@@ -2916,6 +3249,7 @@ class HelpersMessages extends HelpersIsomorphic {
     }
     renderError(err) {
         if (this.isBrowser) {
+            // TODO for FE
             console.error(err);
         }
         else {
@@ -2942,9 +3276,11 @@ class HelpersMessages extends HelpersIsomorphic {
      */
     stopApplication(details) {
         if (this.isBrowser) {
+            //#region @browser
             document.body.innerHTML =
                 '<h1>Application has encountered an error and stopped.</h1>';
             document.body.style.pointerEvents = 'none';
+            //#endregion
             /* */
             /* */
             /* */
@@ -2956,10 +3292,12 @@ class HelpersMessages extends HelpersIsomorphic {
         Helpers.error(error, true, true);
     }
     error(details, noExit = false, noTrace = false) {
+        //#region browser mode
         if (Helpers.isBrowser) {
             console.error(details);
             return;
         }
+        //#endregion
         /* */
         /* */
         /* */
@@ -3011,6 +3349,8 @@ class HelpersMessages extends HelpersIsomorphic {
         /* */
         /* */
     }
+    //#endregion
+    //#region info
     info(details, repeatable = false) {
         /* */
         /* */
@@ -3057,6 +3397,8 @@ class HelpersMessages extends HelpersIsomorphic {
         /* */
         /* */
     }
+    //#endregion
+    //#region info
     success(details) {
         if (Helpers.isBrowser) {
             console.info(details);
@@ -3100,6 +3442,7 @@ class HelpersMessages extends HelpersIsomorphic {
         /* */
         /* */
     }
+    //#endregion
     /**
      *
      * @param details
@@ -3159,6 +3502,7 @@ class HelpersMessages extends HelpersIsomorphic {
         /* */
         /* */
     }
+    //#endregion
     taskDone(details, isLessImportant = false) {
         if (Helpers.isBrowser) {
             console.info(details);
@@ -3217,11 +3561,15 @@ class HelpersMessages extends HelpersIsomorphic {
         /* */
         /* */
     }
+    //#endregion
     get isVerboseMode() {
+        //#region @browser
         return true; // TODO what it means in browser
+        //#endregion
         /* */
         /* */
     }
+    //#region log
     /**
      * log messages only available in verbose mode
      */
@@ -3281,6 +3629,7 @@ class HelpersMessages extends HelpersIsomorphic {
         /* */
         /* */
     }
+    //#endregion
     /**
      * Logs not visible in normal use of taon-cli
      */
@@ -3314,6 +3663,7 @@ class HelpersMessages extends HelpersIsomorphic {
         /* */
         return (void 0);
     }
+    //#endregion
     /**
      * Logs not visible in normal use of taon-cli
      */
@@ -3325,6 +3675,7 @@ class HelpersMessages extends HelpersIsomorphic {
         /* */
         return (void 0);
     }
+    //#region warn
     warn(details, trace = false) {
         if (Helpers.isBrowser) {
             console.warn(details);
@@ -3384,9 +3735,8 @@ class HelpersMessages extends HelpersIsomorphic {
         /* */
     }
 }
-;
-({}); // @--end-of-file-for-module=tnp-core lib/helpers-messages.ts
 
+//#region import
 /* */
 /* */
 /* */
@@ -3404,11 +3754,17 @@ class HelpersMessages extends HelpersIsomorphic {
 /* */
 /* */
 /* */
+//#region @browser
 const encoding = 'utf8';
 /* */
 /* */
 const WEBSQL_PROC_MOCK_PROCESSES_PID = {};
 const WEBSQL_PROC_MOCK_PROCESSES_PPID = {};
+//#endregion
+// TODO UNCOMMENT
+// const globalProcessStdout = {};
+// const globalProcessStder = {};
+// const maxProcessHistoryLinesChekc = 20;
 class HelpersCore extends HelpersMessages {
     static get InstanceCore() {
         if (!HelpersCore._instanceCore) {
@@ -3436,8 +3792,12 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region constructor
     constructor() {
         super();
+        //#endregion
+        //#region fields / getters
         /* */
         /* */
         this.bigMaxBuffer = 2024 * 500;
@@ -3445,30 +3805,40 @@ class HelpersCore extends HelpersMessages {
         /* */
         /* */
     }
+    //#endregion
+    //#region methods / is wsl
     /**
      * @deprecated use UtilsOs.isRunningInsideWsl()
      */
     get isWsl() {
         return UtilsOs.isRunningInWsl();
     }
+    //#endregion
+    //#region methods / is running in docker
     /**
      * @deprecated use UtilsOs.isRunningInDocker
      */
     isRunningInDocker() {
         return UtilsOs.isRunningInDocker();
     }
+    //#endregion
+    //#region methods / is running in docker
     /**
      * @deprecated use UtilsOs.isRunningInLinuxGraphicEnvironment
      */
     isRunningInLinuxGraphicsCapableEnvironment() {
         return UtilsOs.isRunningInLinuxGraphicsCapableEnvironment();
     }
+    //#endregion
+    //#region clear console
     /**
      * @deprecated use UtilsTerminal.clearConsole
      */
     clearConsole() {
         return UtilsTerminal.clearConsole();
     }
+    //#endregion
+    //#region methods / electron ipc renderer
     /**
      * @deprecated
      * get electron browser ipc renderer
@@ -3476,11 +3846,17 @@ class HelpersCore extends HelpersMessages {
     get ipcRenderer() {
         /* */
         /* */
+        //#region @browser
         if (!this.isElectron) {
             return;
         }
         return void 0;
+        // return (window as any).require('electron')
+        //   .ipcRenderer as typeof ipcRenderer;
+        //#endregion
     }
+    //#endregion
+    //#region methods / electron webframe
     /**
      * get electron web frame
      */
@@ -3488,11 +3864,16 @@ class HelpersCore extends HelpersMessages {
         //typeof webFrame
         /* */
         /* */
+        //#region @browser
         if (!this.isElectron) {
             return;
         }
         return void 0;
+        // return (window as any).require('electron').webFrame as typeof webFrame;
+        //#endregion
     }
+    //#endregion
+    //#region methods / electron ipc renderer
     /**
      * @deprecated
      * get electron backend ipc main proces
@@ -3505,6 +3886,8 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / get electron window
     getElectronWindow({ allowRunningInsecureContent = true, } = {}) {
         /* */
         /* */
@@ -3523,16 +3906,22 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / media from type
     mediaTypeFromSrc(src) {
         const ext = path.extname(src);
         const media = CoreModels.mimeTypes[ext];
         return _.first(media?.split('/'));
     }
+    //#endregion
+    //#region methods / sleep
     sleep(seconds = 1) {
         /* */
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / remove if exists
     removeIfExists(absoluteFileOrFolderPath) {
         /* */
         /* */
@@ -3554,12 +3943,16 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / relative
     /**
      * path.relative that return cross platform path
      */
     relative(cwd, to) {
         return crossPlatformPath(path.relative(cwd, to));
     }
+    //#endregion
+    //#region methods / remove file if exists
     removeFileIfExists(absoluteFilePath) {
         /* */
         /* */
@@ -3576,6 +3969,8 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / remove folder if exists
     removeFolderIfExists(absoluteFolderPath) {
         /* */
         /* */
@@ -3593,6 +3988,8 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / remove empty line from string
     /**
      * leave max 1 empty line
      */
@@ -3603,20 +4000,25 @@ class HelpersCore extends HelpersMessages {
             .filter(line => {
             if (line.trim() === '') {
                 if (previousWasEmpty) {
+                    // Skip this line because the previous line was also empty
                     return false;
                 }
                 else {
+                    // Allow this line, but set flag that next empty line should be skipped
                     previousWasEmpty = true;
                     return true;
                 }
             }
             else {
+                // Reset flag if the line is not empty
                 previousWasEmpty = false;
                 return true;
             }
         })
             .join('\n');
     }
+    //#endregion
+    //#region methods / try remove empty dir
     /**
      * @deprecated
      */
@@ -3659,6 +4061,8 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / remove file or folder
     remove(fileOrFolderPathOrPatter, exactFolder = false) {
         /* */
         /* */
@@ -3672,6 +4076,8 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / clean exit process
     /* */
     /* */
     /* */
@@ -3682,6 +4088,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / is running in git bash
     get isRunningInGitBash() {
         /* */
         /* */
@@ -3693,11 +4101,15 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / check if projects is running in supported terminal
     /**
      * Check if the current shell is supported by Taon framework.
      */
     get isSupportedTaonTerminal() {
+        //#region @browser
         return false;
+        //#endregion
         /* */
         /* */
         /* */
@@ -3710,18 +4122,25 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / check if function is class
     /**
      * check if function is class
      */
     isClass(funcOrClass) {
         let isClass = false;
         if (typeof funcOrClass === 'function') {
+            // Check if it has a prototype property
+            // console.log('Object.getOwnPropertyNames(funcOrClass.prototype)', Object.getOwnPropertyNames(funcOrClass.prototype).filter(f => f !== 'constructor'))
             isClass =
                 !!funcOrClass.prototype &&
                     Object.getOwnPropertyNames(funcOrClass.prototype).filter(f => f !== 'constructor').length > 0;
         }
+        // console.log('is class: ' + isClass, funcOrClass)
         return isClass;
     }
+    //#endregion
+    //#region methods / is blob
     /**
      * check if data is nodejs/browser blob
      *
@@ -3729,8 +4148,11 @@ class HelpersCore extends HelpersMessages {
      * @returns
      */
     isBlob(maybeBlob) {
+        // TODO is this needed hmmmm
         return maybeBlob instanceof Blob; // || toString.call(maybeBlob) === '[object Blob]';
     }
+    //#endregion
+    //#region methods / is buffer
     /**
      * Check if data is nodejs buffer
      *
@@ -3741,33 +4163,62 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / remove slash at the end of string
     removeSlashAtEnd(s) {
         s = s?.endsWith(`/`) ? s.slice(0, s.length - 1) : s;
         return s;
     }
+    //#endregion
+    //#region methods / remove slash at the begin of string
     removeSlashAtBegin(s) {
         s = s?.startsWith(`/`) ? s.slice(1) : s;
         return s;
     }
+    //#endregion
+    //#region methods / stringify object pretty format
     /**
      * stringify to pretty json string
      */
     stringify(inputObject) {
+        // if (_.isString(inputObject)) {
+        //   return inputObject;
+        // }
+        // if (_.isObject(inputObject)) {
+        //   config.log(inputObject)
+        //   Helpers.error(`[tnp-helpers] trying to stringify not a object`, false, true);
+        // }
         return JSON.stringify(inputObject, null, 2);
     }
+    //#endregion
+    //#region methods / run sync or async
     async runSyncOrAsync(fnOrOptions) {
         if (_.isUndefined(fnOrOptions)) {
             return void 0;
         }
         let promisOrValue;
+        // const optionsMode = _.isObject(fnOrOptions)
+        //   && !_.isArray(fnOrOptions)
+        //   && !_.isFunction(fnOrOptions)
+        //   && !_.isNil(fnOrOptions)
+        //   ;
+        // if (optionsMode) {
         const { functionFn, context, arrayOfParams } = fnOrOptions;
         promisOrValue = functionFn.apply(context, arrayOfParams);
+        // } else {
         //   // @ts-ignore
+        //   promisOrValue = _.isArray(fnOrOptions) ? fnOrOptions[1][fnOrOptions[0]](...firstArg) : fnOrOptions(...firstArg);
+        // }
+        // let wasPromise = false;
         if (promisOrValue instanceof Promise) {
+            // wasPromise = true;
             promisOrValue = Promise.resolve(promisOrValue);
         }
+        // console.log('was promis ', wasPromise)
         return promisOrValue;
     }
+    //#endregion
+    //#region methods / create symlink
     /* */
     /* */
     /* */
@@ -4006,6 +4457,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / mkdirp
     /* */
     /* */
     /* */
@@ -4056,6 +4509,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / is symlink that matches url
     /**
      * symlink may have existed or unexisted destiantion url
      * @param destUrl M
@@ -4096,6 +4551,8 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / is symlink file existed or unexisted
     isSymlinkFileExitedOrUnexisted(filePath) {
         /* */
         /* */
@@ -4109,6 +4566,8 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / is unexisted link
     /**
      * If symbolnk link that target file does not exits
      */
@@ -4135,6 +4594,8 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / is exited symlink
     /**
      * @param existedLink check if source of link exists
      */
@@ -4163,6 +4624,8 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / path contain link
     /* */
     /* */
     /* */
@@ -4181,6 +4644,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / exists
     exists(folderOrFilePath) {
         /* */
         /* */
@@ -4208,6 +4673,8 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / fix command
     /**
      * this is HACK for running procesess inside processes
      */
@@ -4223,7 +4690,10 @@ class HelpersCore extends HelpersMessages {
         }
         return command;
     }
+    //#endregion
+    //#region methods / command
     command(command) {
+        // console.log({ command })
         command = Helpers._fixCommand(command);
         return {
         /* */
@@ -4281,6 +4751,8 @@ class HelpersCore extends HelpersMessages {
         /* */
         };
     }
+    //#endregion
+    //#region methods / wait
     /**
      * @deprecated use UtilsTerminal.wait
      */
@@ -4290,6 +4762,8 @@ class HelpersCore extends HelpersMessages {
     async timeout(seconds) {
         return await Helpers.wait(seconds);
     }
+    //#endregion
+    //#region methods / command output as string async
     /* */
     /* */
     /* */
@@ -4325,6 +4799,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / command output as string
     /* */
     /* */
     /* */
@@ -4368,6 +4844,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / kill process by port
     async killProcessByPort(portOrPortsToKill, options) {
         /* */
         /* */
@@ -4415,9 +4893,13 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / kill on port
     async killOnPort(portOrPortsToKill, options) {
         return await Helpers.killProcessByPort(portOrPortsToKill, options);
     }
+    //#endregion
+    //#region methods / kill process
     killProcess(byPid) {
         /* */
         /* */
@@ -4447,8 +4929,11 @@ class HelpersCore extends HelpersMessages {
         /* */
         /* */
     }
+    //#endregion
+    //#region methods / run
     run(command, options) {
         command = Helpers._fixCommand(command);
+        // console.log({ command })
         /* */
         /* */
         /* */
@@ -4462,6 +4947,7 @@ class HelpersCore extends HelpersMessages {
              * start command as synchronous nodej proces
              */
             sync() {
+                // TODO buffer
                 /* */
                 /* */
                 /* */
@@ -4499,7 +4985,12 @@ class HelpersCore extends HelpersMessages {
              * start command as asynchronous nodej proces
              * @param detach (default: false) - if true process will be detached
              */
-            async(detach = false, mockFun) {
+            async(detach = false, 
+            //#region @browser
+            mockFun) {
+                //#region websqlFunc
+                //#region mock of process
+                //#region @browser
                 if (mockFun) {
                     const subStdoutSub = new Subject();
                     const subStderSub = new Subject();
@@ -4582,11 +5073,14 @@ class HelpersCore extends HelpersMessages {
                     });
                     return procDummy;
                 }
+                //#endregion
+                //#endregion
                 /* */
                 /* */
                 /* */
                 /* */
                 return (void 0);
+                //#endregion
             },
             /**
              * start command as asynchronous nodej proces inside promise
@@ -4799,6 +5293,8 @@ class HelpersCore extends HelpersMessages {
             },
         };
     }
+    //#endregion
+    //#region methods / question yest no
     /**
      * @deprecated use UtilsTerminal.confirm
      */
@@ -4812,6 +5308,8 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / get stdio
     /* */
     /* */
     /* */
@@ -4838,6 +5336,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / run sync in
     /* */
     /* */
     /* */
@@ -4847,6 +5347,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / run async in
     /* */
     /* */
     /* */
@@ -4916,6 +5418,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / log process
     /* */
     /* */
     /* */
@@ -5016,6 +5520,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / check process
     /* */
     /* */
     /* */
@@ -5031,6 +5537,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / modify line by line
     /* */
     /* */
     /* */
@@ -5084,6 +5592,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / is folder
     /* */
     /* */
     /* */
@@ -5092,6 +5602,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / values
     /**
      * Quick fix for object values
      * @deprecated
@@ -5109,6 +5621,8 @@ class HelpersCore extends HelpersMessages {
         }
         return [];
     }
+    //#endregion
+    //#region methods / is file
     /**
      * does not make sense
      * @deprecated
@@ -5122,6 +5636,8 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / read file
     async tryReadFile(absoluteFilePath, // @ts-ignore
     defaultValueWhenNotExists = void 0, notTrim = false) {
         /* */
@@ -5179,10 +5695,10 @@ class HelpersCore extends HelpersMessages {
         /* */
         /* */
         /* */
-        /* */
-        /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / read json
     /**
      * read json from absolute path
      * @returns json object
@@ -5221,6 +5737,8 @@ class HelpersCore extends HelpersMessages {
         /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / parse
     /* */
     /* */
     /* */
@@ -5236,6 +5754,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / compilation wrapper
     /* */
     /* */
     /* */
@@ -5260,6 +5780,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / replace in line
     replaceLinesInFile(absoluteFilePath, lineReplaceFn) {
         /* */
         /* */
@@ -5268,6 +5790,8 @@ class HelpersCore extends HelpersMessages {
         /* */
         /* */
     }
+    //#endregion
+    //#region methods / write file
     /* */
     /* */
     /* */
@@ -5357,6 +5881,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / write json
     /* */
     /* */
     /* */
@@ -5425,6 +5951,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / folders from
     /* */
     /* */
     /* */
@@ -5473,6 +6001,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / links from
     /* */
     /* */
     /* */
@@ -5508,6 +6038,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / links to folders from path
     /* */
     /* */
     /* */
@@ -5541,6 +6073,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / files from
     /* */
     /* */
     /* */
@@ -5590,6 +6124,8 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / open folder in file explorer
     /* */
     /* */
     /* */
@@ -5610,22 +6146,20 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    //#endregion
+    //#region methods / hide node warnings
     hideNodeWarnings() {
         /* */
         /* */
         /* */
     }
 }
-;
-({}); // @--end-of-file-for-module=tnp-core lib/helpers.ts
 
 const CoreConfig = {
     message: {
         globalSystemToolMode: 'globalSystemToolMode',
     },
 };
-;
-({}); // @--end-of-file-for-module=tnp-core lib/core-config.ts
 
 class PROGRESS_DATA {
     constructor() {
@@ -5650,6 +6184,7 @@ class PROGRESS_DATA {
         if (checkSplit) {
             const split = chunk.split(/\r\n|\n|\r/);
             if (split.length > 1) {
+                // console.log('split founded', split)
                 split.forEach(s => {
                     res = res.concat(this.resolveFrom(s, callbackOnFounded, false));
                 });
@@ -5677,8 +6212,6 @@ class PROGRESS_DATA {
         return res;
     }
 }
-;
-({}); // @--end-of-file-for-module=tnp-core lib/progress-data.ts
 
 /* */
 /* */
@@ -5697,8 +6230,6 @@ class CLI {
     /* */
     static { this.chalk = chalk; }
 }
-;
-({}); // @--end-of-file-for-module=tnp-core lib/core-cli.ts
 
 /**
  * TODO slowly refactor this.. only actually globally needed are:
@@ -5776,12 +6307,8 @@ const requiredForDev = {
         /* */
     ],
 };
-;
-({}); // @--end-of-file-for-module=tnp-core lib/required-global-npm-packages.ts
 
 let Helpers = HelpersCore.InstanceCore;
-;
-({}); // @--end-of-file-for-module=tnp-core lib/index.ts
 
 /**
  * Generated bundle index. Do not edit.