tnp-core 18.0.43 → 18.0.44

package/websql/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/websql/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 {};
 }