gtx-cli 2.5.6 → 2.5.8

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # gtx-cli
 
+## 2.5.8
+
+### Patch Changes
+
+- [#821](https://github.com/generaltranslation/gt/pull/821) [`321854a`](https://github.com/generaltranslation/gt/commit/321854ad881ca07b6a0207b3b0cbc004c6c0f5a4) Thanks [@brian-lou](https://github.com/brian-lou)! - Refactor CLI Logging behavior
+
+## 2.5.7
+
+### Patch Changes
+
+- [#819](https://github.com/generaltranslation/gt/pull/819) [`50338d2`](https://github.com/generaltranslation/gt/commit/50338d2192e2882a4192273a7bbf12d39939c209) Thanks [@fernando-aviles](https://github.com/fernando-aviles)! - Adding sorting by locale order
+
 ## 2.5.6
 
 ### Patch Changes

package/dist/api/downloadFileBatch.js

@@ -1,6 +1,6 @@
 import * as fs from 'fs';
 import * as path from 'path';
-import { logError, logWarning } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import { gt } from '../utils/gt.js';
 import { validateJsonSchema } from '../formats/json/utils.js';
 import { validateYamlSchema } from '../formats/yaml/utils.js';
@@ -55,7 +55,7 @@ export async function downloadFileBatch(fileTracker, files, options, forceDownlo
                 const outputPath = outputPathMap.get(fileKey);
                 const fileProperties = fileTracker.completed.get(fileKey);
                 if (!outputPath || !fileProperties) {
-                    logWarning(`No input/output path found for file: ${fileKey}`);
+                    logger.warn(`No input/output path found for file: ${fileKey}`);
                     result.failed.push(requestedFile);
                     continue;
                 }
@@ -83,7 +83,7 @@ export async function downloadFileBatch(fileTracker, files, options, forceDownlo
                                     translatedContent: file.data,
                                     targetLocale: locale,
                                 },
-                            ], options.defaultLocale)[0];
+                            ], options.defaultLocale, options.locales)[0];
                         }
                     }
                 }
@@ -110,7 +110,7 @@ export async function downloadFileBatch(fileTracker, files, options, forceDownlo
                         data = JSON.stringify(sortedJsonData, null, 2); // format the data
                     }
                     catch (error) {
-                        logWarning(`Failed to sort GTJson file: ${file.id}: ` + error);
+                        logger.warn(`Failed to sort GTJson file: ${file.id}: ` + error);
                     }
                 }
                 // Write the file to disk
@@ -132,7 +132,7 @@ export async function downloadFileBatch(fileTracker, files, options, forceDownlo
                 }
             }
             catch (error) {
-                logError(`Error saving file ${fileKey}: ` + error);
+                logger.error(`Error saving file ${fileKey}: ` + error);
                 result.failed.push(requestedFile);
             }
         }
@@ -151,7 +151,7 @@ export async function downloadFileBatch(fileTracker, files, options, forceDownlo
         return result;
     }
     catch (error) {
-        logError(`An unexpected error occurred while downloading files: ` + error);
+        logger.error(`An unexpected error occurred while downloading files: ` + error);
     }
     // Mark all files as failed if we get here
     result.failed = [...requestedFileMap.values()];

package/dist/api/saveLocalEdits.js

@@ -2,7 +2,8 @@ import { aggregateFiles } from '../formats/files/translate.js';
 import { collectAndSendUserEditDiffs } from './collectUserEditDiffs.js';
 import { gt } from '../utils/gt.js';
 import { BranchStep } from '../workflow/BranchStep.js';
-import { createSpinner, logErrorAndExit } from '../console/logging.js';
+import { logErrorAndExit } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import chalk from 'chalk';
 /**
  * Uploads current source files to obtain file references, then collects and sends
@@ -21,7 +22,7 @@ export async function saveLocalEdits(settings) {
     const branchResult = await branchStep.run();
     await branchStep.wait();
     if (!branchResult) {
-        logErrorAndExit('Failed to resolve git branch information.');
+        return logErrorAndExit('Failed to resolve git branch information.');
     }
     const uploads = files.map((file) => ({
         fileName: file.fileName,
@@ -30,7 +31,7 @@ export async function saveLocalEdits(settings) {
         fileId: file.fileId,
         versionId: file.versionId,
     }));
-    const spinner = createSpinner('dots');
+    const spinner = logger.createSpinner('dots');
     spinner.start('Saving local edits...');
     await collectAndSendUserEditDiffs(uploads, settings);
     spinner.stop(chalk.green('Local edits saved successfully'));

package/dist/api/uploadFiles.d.ts

@@ -24,4 +24,4 @@ export type UploadData = {
 export declare function uploadFiles(files: {
     source: FileUpload;
     translations: FileUpload[];
-}[], options: Settings): Promise<void>;
+}[], options: Settings): Promise<undefined>;

package/dist/api/uploadFiles.js

@@ -1,5 +1,6 @@
 import chalk from 'chalk';
-import { createSpinner, exit, logMessage } from '../console/logging.js';
+import { logger } from '../console/logger.js';
+import { exitSync } from '../console/logging.js';
 import { gt } from '../utils/gt.js';
 /**
  * Uploads multiple files to the API
@@ -8,14 +9,14 @@ import { gt } from '../utils/gt.js';
  * @returns The uploaded content or version ID
  */
 export async function uploadFiles(files, options) {
-    logMessage(chalk.cyan('Files to upload:') +
+    logger.message(chalk.cyan('Files to upload:') +
         '\n' +
         files
             .map((file) => `  - ${chalk.bold(file.source.fileName)} -> ${file.translations
             .map((t) => t.locale)
             .join(', ')}`)
             .join('\n'));
-    const spinner = createSpinner('dots');
+    const spinner = logger.createSpinner('dots');
     spinner.start(`Uploading ${files.length} file${files.length !== 1 ? 's' : ''} to General Translation...`);
     try {
         // Upload sources
@@ -35,6 +36,6 @@ export async function uploadFiles(files, options) {
     }
     catch {
         spinner.stop(chalk.red('An unexpected error occurred while uploading files'));
-        exit(1);
+        return exitSync(1);
     }
 }

package/dist/cli/base.js

@@ -1,6 +1,7 @@
 import { createOrUpdateConfig } from '../fs/config/setupConfig.js';
 import findFilepath from '../fs/findFilepath.js';
-import { displayHeader, promptText, logErrorAndExit, endCommand, promptConfirm, promptMultiSelect, logSuccess, logInfo, startCommand, createSpinner, logMessage, } from '../console/logging.js';
+import { displayHeader, promptText, logErrorAndExit, promptConfirm, promptMultiSelect, } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import path from 'node:path';
 import fs from 'node:fs';
 import { generateSettings } from '../config/generateSettings.js';
@@ -55,7 +56,7 @@ export class BaseCLI {
             .description('Submits the project to the General Translation API for translation. Translations created using this command will require human approval.')).action(async (initOptions) => {
             displayHeader('Staging project for translation with approval required...');
             await this.handleStage(initOptions);
-            endCommand('Done!');
+            logger.endCommand('Done!');
         });
     }
     setupTranslateCommand() {
@@ -64,7 +65,7 @@ export class BaseCLI {
             .description('Translate your project using General Translation')).action(async (initOptions) => {
             displayHeader('Starting translation...');
             await this.handleTranslate(initOptions);
-            endCommand('Done!');
+            logger.endCommand('Done!');
         });
     }
     setupSendDiffsCommand() {
@@ -76,7 +77,7 @@ export class BaseCLI {
             const config = findFilepath(['gt.config.json']);
             const settings = await generateSettings({ config });
             await saveLocalEdits(settings);
-            endCommand('Saved local edits');
+            logger.endCommand('Saved local edits');
         });
     }
     async handleStage(initOptions) {
@@ -126,7 +127,7 @@ export class BaseCLI {
             const settings = await generateSettings(initOptions);
             const options = { ...initOptions, ...settings };
             await this.handleUploadCommand(options);
-            endCommand('Done!');
+            logger.endCommand('Done!');
         });
     }
     setupLoginCommand() {
@@ -159,7 +160,7 @@ export class BaseCLI {
                 }
             }
             await this.handleLoginCommand(options);
-            endCommand(`Done! A ${options.keyType} key has been generated and saved to your .env.local file.`);
+            logger.endCommand(`Done! A ${options.keyType} key has been generated and saved to your .env.local file.`);
         });
     }
     setupInitCommand() {
@@ -179,20 +180,20 @@ export class BaseCLI {
                     defaultValue: true,
                 });
                 if (wrap) {
-                    logInfo(`${chalk.yellow('[EXPERIMENTAL]')} Running React setup wizard...`);
+                    logger.info(`${chalk.yellow('[EXPERIMENTAL]')} Running React setup wizard...`);
                     await this.handleSetupReactCommand(options);
-                    endCommand(`Done! Since this wizard is experimental, please review the changes and make modifications as needed.
+                    logger.endCommand(`Done! Since this wizard is experimental, please review the changes and make modifications as needed.
 Certain aspects of your app may still need manual setup.
 See the docs for more information: https://generaltranslation.com/docs/react/tutorials/quickstart`);
                     ranReactSetup = true;
                 }
             }
             if (ranReactSetup) {
-                startCommand('Setting up project config...');
+                logger.startCommand('Setting up project config...');
             }
             // Configure gt.config.json
             await this.handleInitCommand(ranReactSetup);
-            endCommand('Done! Check out our docs for more information on how to use General Translation: https://generaltranslation.com/docs');
+            logger.endCommand('Done! Check out our docs for more information on how to use General Translation: https://generaltranslation.com/docs');
         });
     }
     setupConfigureCommand() {
@@ -201,10 +202,10 @@ See the docs for more information: https://generaltranslation.com/docs/react/tut
             .description('Configure your project for General Translation. This will create a gt.config.json file in your codebase.')
             .action(async () => {
             displayHeader('Configuring project...');
-            logInfo('Welcome! This tool will help you configure your gt.config.json file. See the docs: https://generaltranslation.com/docs/cli/reference/config for more information.');
+            logger.info('Welcome! This tool will help you configure your gt.config.json file. See the docs: https://generaltranslation.com/docs/cli/reference/config for more information.');
             // Configure gt.config.json
             await this.handleInitCommand(false);
-            endCommand('Done! Make sure you have an API key and project ID to use General Translation. Get them on the dashboard: https://generaltranslation.com/dashboard');
+            logger.endCommand('Done! Make sure you have an API key and project ID to use General Translation. Get them on the dashboard: https://generaltranslation.com/dashboard');
         });
     }
     setupSetupCommand() {
@@ -216,7 +217,7 @@ See the docs for more information: https://generaltranslation.com/docs/react/tut
             .action(async (options) => {
             displayHeader('Running React setup wizard...');
             await this.handleSetupReactCommand(options);
-            endCommand("Done! Take advantage of all of General Translation's features by signing up for a free account! https://generaltranslation.com/signup");
+            logger.endCommand("Done! Take advantage of all of General Translation's features by signing up for a free account! https://generaltranslation.com/signup");
         });
     }
     async handleUploadCommand(settings) {
@@ -279,7 +280,7 @@ See the docs for more information: https://generaltranslation.com/docs/react/tut
         if (isUsingGT && !usingCDN) {
             // Create loadTranslations.js file for local translations
             await createLoadTranslationsFile(process.cwd(), finalTranslationsDir);
-            logMessage(`Created ${chalk.cyan('loadTranslations.js')} file for local translations.
+            logger.message(`Created ${chalk.cyan('loadTranslations.js')} file for local translations.
 Make sure to add this function to your app configuration.
 See https://generaltranslation.com/en/docs/next/guides/local-tx`);
         }
@@ -325,14 +326,14 @@ See https://generaltranslation.com/en/docs/next/guides/local-tx`);
             files: Object.keys(files).length > 0 ? files : undefined,
             publish: isUsingGT && usingCDN,
         });
-        logSuccess(`Feel free to edit ${chalk.cyan(configFilepath)} to customize your translation setup. Docs: https://generaltranslation.com/docs/cli/reference/config`);
+        logger.success(`Feel free to edit ${chalk.cyan(configFilepath)} to customize your translation setup. Docs: https://generaltranslation.com/docs/cli/reference/config`);
         // Install gtx-cli if not installed
         const isCLIInstalled = packageJson
             ? isPackageInstalled('gtx-cli', packageJson, true, true)
             : true; // if no package.json, we can't install it
         if (!isCLIInstalled) {
             const packageManager = await getPackageManager();
-            const spinner = createSpinner();
+            const spinner = logger.createSpinner();
             spinner.start(`Installing gtx-cli as a dev dependency with ${packageManager.name}...`);
             await installPackage('gtx-cli', packageManager, true);
             spinner.stop(chalk.green('Installed gtx-cli.'));

package/dist/cli/commands/stage.js

@@ -1,4 +1,5 @@
-import { logErrorAndExit, logSuccess } from '../../console/logging.js';
+import { logger } from '../../console/logger.js';
+import { logErrorAndExit } from '../../console/logging.js';
 import { noLocalesError, noDefaultLocaleError, noApiKeyError, noProjectIdError, devApiKeyError, invalidConfigurationError, } from '../../console/index.js';
 import { aggregateFiles } from '../../formats/files/translate.js';
 import { aggregateReactTranslations } from '../../translation/stage.js';
@@ -12,19 +13,19 @@ export async function handleStage(options, settings, library, stage) {
     // Validate required settings are present if not in dry run
     if (!options.dryRun) {
         if (!settings.locales) {
-            logErrorAndExit(noLocalesError);
+            return logErrorAndExit(noLocalesError);
         }
         if (!settings.defaultLocale) {
-            logErrorAndExit(noDefaultLocaleError);
+            return logErrorAndExit(noDefaultLocaleError);
         }
         if (!settings.apiKey) {
-            logErrorAndExit(noApiKeyError);
+            return logErrorAndExit(noApiKeyError);
         }
         if (settings.apiKey.startsWith('gtx-dev-')) {
-            logErrorAndExit(devApiKeyError);
+            return logErrorAndExit(devApiKeyError);
         }
         if (!settings.projectId) {
-            logErrorAndExit(noProjectIdError);
+            return logErrorAndExit(noProjectIdError);
         }
     }
     // Aggregate files
@@ -77,7 +78,7 @@ export async function handleStage(options, settings, library, stage) {
             return `- ${file.fileName}`;
         })
             .join('\n');
-        logSuccess(`Dry run: No files were sent to General Translation. Found files:\n${fileNames}`);
+        logger.success(`Dry run: No files were sent to General Translation. Found files:\n${fileNames}`);
         return null;
     }
     // Send translations to General Translation

package/dist/cli/commands/translate.js

@@ -1,6 +1,5 @@
 import { downloadTranslations, } from '../../workflow/download.js';
 import { createFileMapping } from '../../formats/files/fileMapping.js';
-import { logError } from '../../console/logging.js';
 import { getStagedVersions } from '../../fs/config/updateVersions.js';
 import copyFile from '../../fs/copyFile.js';
 import flattenJsonFiles from '../../utils/flattenJsonFiles.js';
@@ -8,6 +7,7 @@ import localizeStaticUrls from '../../utils/localizeStaticUrls.js';
 import processAnchorIds from '../../utils/processAnchorIds.js';
 import { noFilesError, noVersionIdError } from '../../console/index.js';
 import localizeStaticImports from '../../utils/localizeStaticImports.js';
+import { logErrorAndExit } from '../../console/logging.js';
 // Downloads translations that were completed
 export async function handleTranslate(options, settings, fileVersionData, jobData, branchData) {
     if (fileVersionData) {
@@ -20,12 +20,10 @@ export async function handleTranslate(options, settings, fileVersionData, jobDat
 // Downloads translations that were originally staged
 export async function handleDownload(options, settings) {
     if (!settings._versionId) {
-        logError(noVersionIdError);
-        process.exit(1);
+        logErrorAndExit(noVersionIdError);
     }
     if (!settings.files) {
-        logError(noFilesError);
-        process.exit(1);
+        logErrorAndExit(noFilesError);
     }
     // Files
     const { resolvedPaths, placeholderPaths, transformPaths } = settings.files;

package/dist/cli/flags.js

@@ -1,5 +1,4 @@
 import findFilepath from '../fs/findFilepath.js';
-import { logErrorAndExit } from '../console/logging.js';
 const DEFAULT_TIMEOUT = 600;
 export function attachTranslateFlags(command) {
     command
@@ -13,10 +12,10 @@ export function attachTranslateFlags(command) {
         .option('--timeout <seconds>', 'Translation wait timeout in seconds', (value) => {
         const parsedValue = parseInt(value, 10);
         if (isNaN(parsedValue)) {
-            logErrorAndExit('Not a number.');
+            throw new Error('Invalid timeout: not a number.');
         }
         if (parsedValue < 0) {
-            logErrorAndExit('Timeout must be a positive number.');
+            throw new Error('Invalid timeout: must be a positive number.');
         }
         return parsedValue;
     }, DEFAULT_TIMEOUT)

package/dist/cli/react.js

@@ -1,4 +1,5 @@
-import { displayHeader, endCommand, logError, logStep, logSuccess, logWarning, promptConfirm, } from '../console/logging.js';
+import { displayHeader, exitSync, promptConfirm } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import loadJSON from '../fs/loadJSON.js';
 import findFilepath from '../fs/findFilepath.js';
 import chalk from 'chalk';
@@ -37,7 +38,7 @@ export class ReactCLI extends BaseCLI {
             .description('Submits the project to the General Translation API for translation. Translations created using this command will require human approval.'))).action(async (options) => {
             displayHeader('Staging project for translation with approval required...');
             await this.handleStage(options);
-            endCommand('Done!');
+            logger.endCommand('Done!');
         });
     }
     setupTranslateCommand() {
@@ -46,7 +47,7 @@ export class ReactCLI extends BaseCLI {
             .description('Scans the project for a dictionary and/or <T> tags, and sends the updates to the General Translation API for translation.'))).action(async (options) => {
             displayHeader('Translating project...');
             await this.handleTranslate(options);
-            endCommand('Done!');
+            logger.endCommand('Done!');
         });
     }
     setupValidateCommand() {
@@ -62,7 +63,7 @@ export class ReactCLI extends BaseCLI {
             // intro here since we don't want to show the ascii title
             intro(chalk.cyan('Validating project...'));
             await this.handleValidate(options, files);
-            endCommand('Done!');
+            logger.endCommand('Done!');
         });
     }
     setupGenerateSourceCommand() {
@@ -71,7 +72,7 @@ export class ReactCLI extends BaseCLI {
             .description('Generate a translation file for the source locale. This command should be used if you are handling your own translations.'))).action(async (initOptions) => {
             displayHeader('Generating source templates...');
             await this.handleGenerateSourceCommand(initOptions);
-            endCommand('Done!');
+            logger.endCommand('Done!');
         });
     }
     async handleGenerateSourceCommand(initOptions) {
@@ -93,11 +94,11 @@ export class ReactCLI extends BaseCLI {
         if (settings.files && settings.files.placeholderPaths.gt) {
             const translationFiles = resolveLocaleFiles(settings.files.placeholderPaths, settings.defaultLocale);
             if (!translationFiles.gt) {
-                logError(noFilesError);
-                process.exit(1);
+                logger.error(noFilesError);
+                exitSync(1);
             }
             await saveJSON(translationFiles.gt, newData);
-            logStep('Source file saved successfully!');
+            logger.step('Source file saved successfully!');
             // Also save translations (after merging with existing translations)
             for (const locale of settings.locales) {
                 const translationsFile = resolveLocaleFiles(settings.files.placeholderPaths, locale);
@@ -113,7 +114,7 @@ export class ReactCLI extends BaseCLI {
                 const filteredTranslations = Object.fromEntries(Object.entries(mergedTranslations).filter(([key]) => newData[key]));
                 await saveJSON(translationsFile.gt, filteredTranslations);
             }
-            logStep('Merged translations successfully!');
+            logger.step('Merged translations successfully!');
         }
     }
     async handleScanCommand(options) {
@@ -123,8 +124,8 @@ export class ReactCLI extends BaseCLI {
             defaultValue: true,
         });
         if (!answer) {
-            logError('Operation cancelled.');
-            process.exit(0);
+            logger.error('Operation cancelled.');
+            exitSync(0);
         }
         // ----- Create a starter gt.config.json file -----
         await generateSettings(options);
@@ -139,18 +140,18 @@ export class ReactCLI extends BaseCLI {
         // Wrap all JSX elements in the src directory with a <T> tag, with unique ids
         const { filesUpdated } = await this.wrapContent(options, 'react', errors, warnings);
         if (errors.length > 0) {
-            logError(chalk.red('Failed to write files:\n') + errors.join('\n'));
+            logger.error(chalk.red('Failed to write files:\n') + errors.join('\n'));
         }
         // Format updated files if formatters are available
         if (!options.disableFormatting)
             await formatFiles(filesUpdated);
-        logSuccess(`Success! Added <T> tags and updated ${chalk.bold.cyan(filesUpdated.length)} files:\n` +
+        logger.success(`Success! Added <T> tags and updated ${chalk.bold.cyan(filesUpdated.length)} files:\n` +
             filesUpdated.map((file) => `${chalk.green('-')} ${file}`).join('\n'));
         if (filesUpdated.length > 0) {
-            logStep(chalk.green('Please verify the changes before committing.'));
+            logger.step(chalk.green('Please verify the changes before committing.'));
         }
         if (warnings.length > 0) {
-            logWarning(chalk.yellow('Warnings encountered:') +
+            logger.warn(chalk.yellow('Warnings encountered:') +
                 '\n' +
                 warnings
                     .map((warning) => `${chalk.yellow('-')} ${warning}`)

package/dist/config/generateSettings.js

@@ -1,4 +1,4 @@
-import { displayProjectId, logErrorAndExit, warnApiKeyInConfig, } from '../console/logging.js';
+import { displayProjectId, exitSync, logErrorAndExit, warnApiKeyInConfig, } from '../console/logging.js';
 import { loadConfig } from '../fs/config/loadConfig.js';
 import { defaultBaseUrl, libraryDefaultLocale, } from 'generaltranslation/internal';
 import fs from 'node:fs';
@@ -46,7 +46,7 @@ export async function generateSettings(flags, cwd = process.cwd()) {
     // Warn if apiKey is present in gt.config.json
     if (gtConfig.apiKey) {
         warnApiKeyInConfig(flags.config);
-        process.exit(1);
+        exitSync(1);
     }
     const projectIdEnv = resolveProjectId();
     // Resolve mismatched projectIds

package/dist/config/validateSettings.d.ts

@@ -1,3 +1,3 @@
 import { Settings } from '../types/index.js';
-export declare function validateSettings(settings: Settings): void;
+export declare function validateSettings(settings: Settings): undefined;
 export declare function validateConfigExists(): string;

package/dist/config/validateSettings.js

@@ -6,19 +6,19 @@ export function validateSettings(settings) {
     // Validate locales
     for (const locale of settings.locales) {
         if (!isValidLocale(locale, settings.customMapping)) {
-            logErrorAndExit(`Provided locales: "${settings?.locales?.join()}", ${locale} is not a valid locale!`);
+            return logErrorAndExit(`Provided locales: "${settings?.locales?.join()}", ${locale} is not a valid locale!`);
         }
     }
     if (settings.defaultLocale &&
         !isValidLocale(settings.defaultLocale, settings.customMapping)) {
-        logErrorAndExit(`defaultLocale: ${settings.defaultLocale} is not a valid locale!`);
+        return logErrorAndExit(`defaultLocale: ${settings.defaultLocale} is not a valid locale!`);
     }
     // defaultLocale cannot be a superset of any other locale
     if (settings.defaultLocale &&
         settings.locales.some((locale) => isSupersetLocale(settings.defaultLocale, locale) &&
             !isSupersetLocale(locale, settings.defaultLocale))) {
         const locale = settings.locales.find((locale) => isSupersetLocale(settings.defaultLocale, locale));
-        logErrorAndExit(`defaultLocale: ${settings.defaultLocale} is a superset of another locale (${locale})! Please change the defaultLocale to a more specific locale.`);
+        return logErrorAndExit(`defaultLocale: ${settings.defaultLocale} is a superset of another locale (${locale})! Please change the defaultLocale to a more specific locale.`);
     }
 }
 export function validateConfigExists() {
@@ -28,5 +28,5 @@ export function validateConfigExists() {
             return possibleConfigPath;
         }
     }
-    logErrorAndExit('No gt.config.json file found. Are you in the correct directory?');
+    return logErrorAndExit('No gt.config.json file found. Are you in the correct directory?');
 }

package/dist/console/logger.d.ts

@@ -0,0 +1,27 @@
+import type { SpinnerResult, ProgressResult } from '@clack/prompts';
+export type LogFormat = 'default' | 'json';
+declare class Logger {
+    private static instance;
+    private pinoLogger;
+    private fileLogger;
+    private logFormat;
+    private constructor();
+    static getInstance(): Logger;
+    trace(message: string): void;
+    debug(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    fatal(message: string): void;
+    silent(message: string): void;
+    success(message: string): void;
+    step(message: string): void;
+    message(message: string, symbol?: string): void;
+    createSpinner(indicator?: 'dots' | 'timer'): SpinnerResult;
+    createProgressBar(total: number): ProgressResult;
+    startCommand(message: string): void;
+    endCommand(message: string): void;
+    flush(): void;
+}
+export declare const logger: Logger;
+export {};