tnp-core 18.0.43 → 18.0.44

package/client/lib/helpers.d.ts

@@ -32,6 +32,9 @@ export declare class HelpersCore extends HelpersMessages {
      * @deprecated use UtilsOs.isRunningInLinuxGraphicEnvironment
      */
     isRunningInLinuxGraphicsCapableEnvironment(): boolean;
+    /**
+     * @deprecated use UtilsTerminal.clearConsole
+     */
     clearConsole(): void;
     /**
      * get electron browser ipc renderer
@@ -152,11 +155,10 @@ export declare class HelpersCore extends HelpersMessages {
          */
         unitlOutputContains(stdoutMsg: string | string[], stderMsg?: string | string[], timeout?: number, stdoutOutputContainsCallback?: () => any): any;
     };
-    questionYesNo(message: string, callbackTrue?: () => any, callbackFalse?: () => any, defaultValue?: boolean, 
     /**
-     * in non interactive mode
+     * @deprecated use UtilsTerminal.confirm
      */
-    mustAnswerQuestion?: boolean): Promise<any>;
+    questionYesNo(message: string, callbackTrue?: () => any, callbackFalse?: () => any, defaultValue?: boolean): Promise<any>;
     /**
      * Quick fix for object values
      * @deprecated

package/client/lib/utils.d.ts

@@ -184,6 +184,27 @@ export declare namespace UtilsOs {
     const isRunningInWsl: () => boolean;
     const isRunningInDocker: () => boolean;
     const isRunningInLinuxGraphicsCapableEnvironment: () => boolean;
+    /**
+     * Check whether the current process is running in CLI mode.
+     */
+    const isRunningInCliMode: () => boolean;
+    /**
+     * Check whether the current process is running in mocha test.
+     */
+    const isRunningInMochaTest: () => boolean;
+    /**
+     * 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`.
+     */
+    const isPortInUse: (port: number, options?: {
+        /**
+         * '127.0.0.1' etc..
+         */
+        checkForSpecificOnlyHost?: string;
+    }) => Promise<boolean>;
 }
 export declare namespace UtilsString {
     const kebabCaseNoSplitNumbers: (input: string) => string;
@@ -196,4 +217,100 @@ export declare namespace UtilsMigrations {
     const getFormattedTimestampFromClassName: (className: string) => string | undefined;
     const formatTimestamp: (timestamp: number) => string;
     const isValidTimestamp: (value: any) => boolean;
+}
+export declare namespace UtilsTerminal {
+    export const clearConsole: () => void;
+    export const multiselect: <T = string>(options: {
+        question: string;
+        /**
+         * If true, then only one choice can be selected
+         */
+        onlyOneChoice?: boolean;
+        choices: {
+            name: string;
+            value: T;
+        }[] | {
+            [choice: string]: {
+                name: string;
+            };
+        };
+        autocomplete?: boolean;
+        defaultSelected?: string[];
+    }) => Promise<T[]>;
+    type SelectActionChoice = {
+        [choice: string]: {
+            /**
+             * Title of the choice
+             */
+            name: string;
+            /**
+             * Action to execute
+             */
+            action?: () => any;
+        };
+    };
+    /**
+     * Similar to select but executes action if provided
+     * @returns selected and executed value
+     */
+    export const selectActionAndExecute: <CHOICE extends SelectActionChoice = SelectActionChoice>(choices: CHOICE, options?: {
+        question?: string;
+        autocomplete?: boolean;
+        defaultSelected?: string;
+        hint?: string;
+        executeActionOnDefault?: boolean;
+    }) => Promise<any>;
+    export const select: <T = string>(options: {
+        question: string;
+        choices: {
+            name: string;
+            value: T;
+        }[] | {
+            [choice: string]: {
+                name: string;
+            };
+        };
+        autocomplete?: boolean;
+        defaultSelected?: string;
+        hint?: string;
+    }) => Promise<T>;
+    export const pipeEnterToStdin: () => void;
+    export const input: ({ defaultValue, question, required, }: {
+        defaultValue?: string;
+        question: string;
+        required?: boolean;
+        validate?: (value: string) => boolean;
+    }) => Promise<string>;
+    export const confirm: (options?: {
+        /**
+         * default: Are you sure?
+         */
+        message?: string;
+        callbackTrue?: () => any;
+        callbackFalse?: () => any;
+        /**
+         * default: true
+         */
+        defaultValue?: boolean;
+        engine?: "inquirer-toggle" | "prompts" | "enquirer" | "@inquirer/prompts";
+    }) => Promise<any>;
+    export const pressAnyKeyToContinueAsync: (options?: {
+        message?: string;
+    }) => Promise<void>;
+    /**
+     * @deprecated use UtilsTerminal.pressAnyKeyToContinueAsync()
+     */
+    export const pressAnyKey: (options?: {
+        message?: string;
+    }) => any;
+    export const previewLongList: (list: string | string[], listName?: string) => Promise<void>;
+    /**
+     * Displays a long list in the console using a pager like `less`.
+     * Returns a Promise that resolves when the user exits the pager.
+     *
+     * @param {string} list - The long string content to display.
+     * @returns {Promise<void>} A Promise that resolves when the pager exits.
+     */
+    export const previewLongListGitLogLike: (list: string | string[]) => Promise<void>;
+    export {};
 }

package/lib/helpers.d.ts

@@ -1,9 +1,9 @@
 import { child_process } from './core-imports';
+import { Blob } from 'buffer';
 import { HelpersMessages } from './helpers-messages';
 import { CoreModels } from './core-models';
 import { ipcRenderer, webFrame } from 'electron';
 import type { ChildProcess } from 'child_process';
-import { Blob } from 'buffer';
 export interface RunSyncOrAsyncOptions {
     functionFn: Function;
     context?: object;
@@ -21,8 +21,17 @@ export declare class HelpersCore extends HelpersMessages {
     static get InstanceCore(): HelpersCore;
     readonly processes: ChildProcess[];
     readonly bigMaxBuffer: number;
+    /**
+     * @deprecated use UtilsOs
+     */
     get isRunningIn(): {
+        /**
+         * @deprecated use UtilsOs.isRunningInMochaTest()
+         */
         mochaTest(): boolean;
+        /**
+         * @deprecated use UtilsOs.isRunningInCliMode()
+         */
         cliMode(): boolean;
     };
     constructor();
@@ -38,6 +47,9 @@ export declare class HelpersCore extends HelpersMessages {
      * @deprecated use UtilsOs.isRunningInLinuxGraphicEnvironment
      */
     isRunningInLinuxGraphicsCapableEnvironment(): boolean;
+    /**
+     * @deprecated use UtilsTerminal.clearConsole
+     */
     clearConsole(): void;
     /**
      * get electron browser ipc renderer
@@ -163,7 +175,7 @@ export declare class HelpersCore extends HelpersMessages {
          * start command as asynchronous nodej proces
          * @param detach (default: false) - if true process will be detached
          */
-        async(detach?: boolean, mockFun?: (stdoutCallback: (dataForStdout: any) => any, stdErrcCallback: (dataForStder: any) => any, shouldProcesBeDead?: () => boolean) => Promise<number> | number): ChildProcess;
+        async(detach?: boolean): ChildProcess;
         /**
          * start command as asynchronous nodej proces inside promise
          */
@@ -182,11 +194,10 @@ export declare class HelpersCore extends HelpersMessages {
          */
         unitlOutputContains(stdoutMsg: string | string[], stderMsg?: string | string[], timeout?: number, stdoutOutputContainsCallback?: () => any): Promise<any>;
     };
-    questionYesNo(message: string, callbackTrue?: () => any, callbackFalse?: () => any, defaultValue?: boolean, 
     /**
-     * in non interactive mode
+     * @deprecated use UtilsTerminal.confirm
      */
-    mustAnswerQuestion?: boolean): Promise<boolean>;
+    questionYesNo(message: string, callbackTrue?: () => any, callbackFalse?: () => any, defaultValue?: boolean): Promise<boolean>;
     getStdio(options?: CoreModels.RunOptions): any;
     runSyncIn(command: string, options?: CoreModels.RunOptions): string;
     runAsyncIn(command: string, options?: CoreModels.RunOptions): child_process.ChildProcess;
@@ -266,4 +277,4 @@ export declare class HelpersCore extends HelpersMessages {
     filesFrom(pathToFolder: string | string[], recrusive?: boolean, incudeUnexistedLinks?: boolean): string[];
     openFolderInFileExploer(folderPath: string): void;
     hideNodeWarnings(): void;
-}
+}