tnp-core 19.0.48 → 19.0.50

package/README.md

@@ -1,20 +1,20 @@
-# taon-core ( tnp-core )
-
-- Part of [taon.dev](https://github.com/darekf77/taon)
-- JavasScript/Typescript most essential helpers
-- Basic taon releated helpers
-- Purpose:
-  + lightweight most essential helpers library
-  + crossplatform helpers for NodeJs/Browser
-
-
-## Usage
-- in taon isomorphic libs/apps or any NodeJS apps/libs:
-```ts
-import { Helpers } from 'tnp-core';
-```
-
-- in any frontend browser apps (except taon libs/apps)
-```ts
-import { Helpers } from 'tnp-core/browser';
-```
+# taon-core ( tnp-core )
+
+- Part of [taon.dev](https://github.com/darekf77/taon)
+- JavasScript/Typescript most essential helpers
+- Basic taon releated helpers
+- Purpose:
+  + lightweight most essential helpers library
+  + crossplatform helpers for NodeJs/Browser
+
+
+## Usage
+- in taon isomorphic libs/apps or any NodeJS apps/libs:
+```ts
+import { Helpers } from 'tnp-core';
+```
+
+- in any frontend browser apps (except taon libs/apps)
+```ts
+import { Helpers } from 'tnp-core/browser';
+```

package/browser/README.md

@@ -1,24 +1,24 @@
-# MyLib
-
-This library was generated with [Angular CLI](https://github.com/angular/angular-cli) version 13.2.0.
-
-## Code scaffolding
-
-Run `ng generate component component-name --project my-lib` to generate a new component. You can also use `ng generate directive|pipe|service|class|guard|interface|enum|module --project my-lib`.
-> Note: Don't forget to add `--project my-lib` or else it will be added to the default project in your `angular.json` file. 
-
-## Build
-
-Run `ng build my-lib` to build the project. The build artifacts will be stored in the `dist/` directory.
-
-## Publishing
-
-After building your library with `ng build my-lib`, go to the dist folder `cd dist/my-lib` and run `npm publish`.
-
-## Running unit tests
-
-Run `ng test my-lib` to execute the unit tests via [Karma](https://karma-runner.github.io).
-
-## Further help
-
-To get more help on the Angular CLI use `ng help` or go check out the [Angular CLI Overview and Command Reference](https://angular.io/cli) page.
+# MyLib
+
+This library was generated with [Angular CLI](https://github.com/angular/angular-cli) version 13.2.0.
+
+## Code scaffolding
+
+Run `ng generate component component-name --project my-lib` to generate a new component. You can also use `ng generate directive|pipe|service|class|guard|interface|enum|module --project my-lib`.
+> Note: Don't forget to add `--project my-lib` or else it will be added to the default project in your `angular.json` file. 
+
+## Build
+
+Run `ng build my-lib` to build the project. The build artifacts will be stored in the `dist/` directory.
+
+## Publishing
+
+After building your library with `ng build my-lib`, go to the dist folder `cd dist/my-lib` and run `npm publish`.
+
+## Running unit tests
+
+Run `ng test my-lib` to execute the unit tests via [Karma](https://karma-runner.github.io).
+
+## Further help
+
+To get more help on the Angular CLI use `ng help` or go check out the [Angular CLI Overview and Command Reference](https://angular.io/cli) page.

package/browser/fesm2022/tnp-core.mjs

@@ -729,7 +729,8 @@ const crossPlatformPath = (pathStringOrPathParts) => {
     }
     if (hasNonAscii) {
         const allNonAscii = pathStringOrPathParts.match(/[^\u0000-\u0080]+/g) || '';
-        Helpers.logWarn(`[taon-core][crossPlatformPath]: Path contains non-ascii characters: ${allNonAscii}`);
+        Helpers.logWarn(`[taon-core][crossPlatformPath]: path below contains non-ascii characters (${allNonAscii}):
+"${pathStringOrPathParts}"`);
         Helpers.logWarn(pathStringOrPathParts);
     }
     pathStringOrPathParts = (pathStringOrPathParts || '')
@@ -2132,6 +2133,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.
      */
@@ -2159,6 +2161,8 @@ 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.
@@ -2181,6 +2185,8 @@ 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.
@@ -2204,6 +2210,8 @@ 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`.
@@ -2218,6 +2226,8 @@ var UtilsProcess;
         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.
@@ -2250,6 +2260,72 @@ var UtilsProcess;
         /* */
         return (void 0);
     };
+    //#endregion
+    //#region kill process on port
+    UtilsProcess.killProcessOnPort = async (port) => {
+        if (!port || isNaN(port) || UtilsOs.isBrowser) {
+            Helpers.warn(`[UtilsProcess.killProcessOnPort]: Invalid port number: ${port}`);
+            return false;
+        }
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
 })(UtilsProcess || (UtilsProcess = {}));
 //#endregion
 //#region utils os
@@ -2447,6 +2523,44 @@ var UtilsOs;
         /* */
         /* */
         /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
         return (void 0);
     };
     //#endregion
@@ -2540,6 +2654,27 @@ var UtilsOs;
         return (void 0);
     };
     //#endregion
+    //#region utils os / is docker available
+    UtilsOs.isDockerAvailable = async () => {
+        if (UtilsOs.isBrowser) {
+            return false;
+        }
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
     UtilsOs.openFolderInVSCode = (folderPath) => {
         /* */
         /* */
@@ -2665,6 +2800,17 @@ var UtilsTerminal;
         });
     };
     //#endregion
+    //#region wait
+    UtilsTerminal.waitMiliseconds = (miliseconds) => {
+        // Helpers.taskStarted(`Waiting ${miliseconds} miliseconds...`);
+        return new Promise((resolve, reject) => {
+            setTimeout(() => {
+                // Helpers.taskDone(`Done waiting ${miliseconds} miliseconds`);
+                resolve(void 0);
+            }, miliseconds);
+        });
+    };
+    //#endregion
     //#region clear
     UtilsTerminal.clearConsole = () => {
         /* */
@@ -3211,6 +3357,103 @@ var UtilsTerminal;
     //#endregion
 })(UtilsTerminal || (UtilsTerminal = {}));
 //#endregion
+//#region utils json
+var UtilsJson;
+(function (UtilsJson) {
+    //#region read json
+    /**
+     * read json from absolute path
+     * @returns json object
+     */
+    UtilsJson.readJson = (absoluteFilePath, defaultValue = {}, useJson5 = false) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region read json with comments
+    UtilsJson.readJsonWithComments = (absoluteFilePath, defaultValue = {}) => {
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+})(UtilsJson || (UtilsJson = {}));
+//#endregion
+var UtilsYaml;
+(function (UtilsYaml) {
+    UtilsYaml.yamlToJson = (yamlString) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    UtilsYaml.jsonToYaml = (json) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#region read yaml as json
+    UtilsYaml.readYamlAsJson = (absFilePathToYamlOrYmlFile, options) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+    //#region write json to yaml
+    UtilsYaml.writeJsonToYaml = (destinationYamlfileAbsPath, json) => {
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        return (void 0);
+    };
+    //#endregion
+})(UtilsYaml || (UtilsYaml = {}));
 
 class HelpersIsomorphic {
     /**
@@ -4978,6 +5221,9 @@ class HelpersCore extends HelpersMessages {
     /* */
     //#endregion
     //#region methods / kill process by port
+    /**
+     * @deprecated use UtilsProcess.killProcessOnPort
+     */
     async killProcessByPort(portOrPortsToKill, options) {
         /* */
         /* */
@@ -5832,42 +6078,22 @@ class HelpersCore extends HelpersMessages {
     //#endregion
     //#region methods / read json
     /**
-     * read json from absolute path
-     * @returns json object
+     * @deprecated use UtilsJson.readJson or UtilsJson.readJson5
      */
     readJson(absoluteFilePath, defaultValue = {}, useJson5 = false) {
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        /* */
-        return (void 0);
+        return UtilsJson.readJson(absoluteFilePath, defaultValue, useJson5);
     }
+    /**
+     * @deprecated use UtilsJson.readJsonWithComments
+     */
     readJson5(absoluteFilePath, defaultValue = {}) {
-        /* */
-        /* */
-        return (void 0);
+        return UtilsJson.readJsonWithComments(absoluteFilePath, defaultValue);
     }
+    /**
+     * @deprecated use UtilsJson.readJsonWithComments
+     */
     readJsonC(absoluteFilePath, defaultValue = {}) {
-        /* */
-        /* */
-        return (void 0);
+        return UtilsJson.readJsonWithComments(absoluteFilePath, defaultValue);
     }
     //#endregion
     //#region methods / parse
@@ -6135,6 +6361,25 @@ class HelpersCore extends HelpersMessages {
     /* */
     /* */
     /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
+    /* */
     //#endregion
     //#region methods / links from
     /* */
@@ -6472,5 +6717,5 @@ let Helpers = HelpersCore.InstanceCore;
  * Generated bundle index. Do not edit.
  */
 
-export { $, CLI, CoreConfig, HelpersCore as CoreHelpers, CoreModels, Helpers, PROGRESS_DATA, Utils, UtilsMigrations, UtilsOs, UtilsProcess, UtilsString, UtilsTerminal, chalk, child_process, chokidar, crossPlatformPath, fg, fkill, frameworkName, frameworkNameBe, fse, glob, http, https, isElevated, mkdirp, ncp, net, os, path, ps, psList, requiredForDev, rimraf, spawn, win32Path };
+export { $, CLI, CoreConfig, HelpersCore as CoreHelpers, CoreModels, Helpers, PROGRESS_DATA, Utils, UtilsJson, UtilsMigrations, UtilsOs, UtilsProcess, UtilsString, UtilsTerminal, UtilsYaml, chalk, child_process, chokidar, crossPlatformPath, fg, fkill, frameworkName, frameworkNameBe, fse, glob, http, https, isElevated, mkdirp, ncp, net, os, path, ps, psList, requiredForDev, rimraf, spawn, win32Path };
 //# sourceMappingURL=tnp-core.mjs.map