@l10nmonster/cli 3.1.0 → 3.1.1

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+## @l10nmonster/cli [3.1.1](https://public-github/l10nmonster/l10nmonster/compare/@l10nmonster/cli@3.1.0...@l10nmonster/cli@3.1.1) (2025-12-23)
+
+
+### Bug Fixes
+
+* Improve type definitions and checks ([826b412](https://public-github/l10nmonster/l10nmonster/commit/826b412f0f7e761d404165a243b0c2b26c416ac1))
+
+## @l10nmonster/cli [3.1.1](https://public-github/l10nmonster/l10nmonster/compare/@l10nmonster/cli@3.1.0...@l10nmonster/cli@3.1.1) (2025-12-23)
+
+
+### Bug Fixes
+
+* Improve type definitions and checks ([826b412](https://public-github/l10nmonster/l10nmonster/commit/826b412f0f7e761d404165a243b0c2b26c416ac1))
+
+
+
+
+
+### Dependencies
+
+* **@l10nmonster/core:** upgraded to 3.1.1
+
 # @l10nmonster/cli [3.1.0](https://public-github/l10nmonster/l10nmonster/compare/@l10nmonster/cli@3.0.0...@l10nmonster/cli@3.1.0) (2025-12-20)
 
 

package/index.js

@@ -1,10 +1,96 @@
 /* eslint-disable no-underscore-dangle */
 
 import { Command, Argument, Option, InvalidArgumentError } from 'commander';
-
+import { existsSync } from 'fs';
 import path from 'path';
-import { readFileSync } from 'fs';
-const cliVersion = JSON.parse(readFileSync(path.join(import.meta.dirname, 'package.json'), 'utf-8')).version;
+import { l10nMonsterVersion } from '@l10nmonster/core';
+
+/**
+ * Find l10nmonster.config.mjs by walking up the directory tree.
+ * @param {string} [startDir] - Directory to start searching from (defaults to cwd)
+ * @returns {string|null} - Path to config file or null if not found
+ */
+export function findConfigFile(startDir = process.cwd()) {
+    let currentDir = path.resolve(startDir);
+    const configFileName = 'l10nmonster.config.mjs';
+
+    while (true) {
+        const configPath = path.join(currentDir, configFileName);
+        if (existsSync(configPath)) {
+            return configPath;
+        }
+
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            break;
+        }
+        currentDir = parentDir;
+    }
+
+    return null;
+}
+
+/**
+ * Run the CLI with automatic config discovery.
+ * @param {Object} [options] - Options for running the CLI
+ * @param {Array} [options.extraActions] - Additional actions to register
+ * @returns {Promise<void>}
+ */
+export async function runCLI({ extraActions = [] } = {}) {
+    // Global unhandled promise rejection handler
+    process.on('unhandledRejection', (reason, promise) => {
+        console.error('Unhandled Promise Rejection detected:');
+        console.error('Promise:', promise);
+        console.error('Reason:', reason);
+        if (reason instanceof Error && reason.stack) {
+            console.error('Stack trace:', reason.stack);
+        }
+        console.error('Exiting due to unhandled promise rejection...');
+        process.exit(1);
+    });
+
+    // Global uncaught exception handler
+    process.on('uncaughtException', (error) => {
+        console.error('Uncaught Exception:', error);
+        process.exit(1);
+    });
+
+    // Handle --help and --version before requiring config
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args.includes('--help') || args.includes('-h') || args.includes('--version')) {
+        const helpCLI = new Command();
+        helpCLI
+            .name('l10n')
+            .version(l10nMonsterVersion, '--version', 'output the current version number')
+            .description('Continuous localization for the rest of us.\n\nRun from a directory containing l10nmonster.config.mjs to see available commands.');
+        helpCLI.parse();
+        return;
+    }
+
+    try {
+        const configPath = findConfigFile();
+        if (!configPath) {
+            console.error('Error: Could not find l10nmonster.config.mjs in current directory or any parent directory.');
+            console.error('Please ensure the config file exists in your project root or current working directory.');
+            process.exit(1);
+        }
+
+        const config = await import(configPath);
+        let monsterConfig = config.default;
+
+        // Add any extra actions
+        for (const action of extraActions) {
+            monsterConfig = monsterConfig.action(action);
+        }
+
+        // eslint-disable-next-line no-use-before-define
+        await runMonsterCLI(monsterConfig);
+    } catch (error) {
+        console.error('Error running l10nmonster CLI:');
+        console.error(error.stack || error);
+        process.exit(1);
+    }
+}
 
 function intOptionParser(value) {
     const parsedValue = parseInt(value, 10);
@@ -49,11 +135,12 @@ function configureCommand(cmd, Action, l10nRunner) {
     });
 }
 
+/** @type {import('./interfaces.js').RunMonsterCLI} */
 export default async function runMonsterCLI(monsterConfig, cliCommand) {
     const monsterCLI = new Command();
     monsterCLI
         .name('l10n')
-        .version(cliVersion, '--version', 'output the current version number')
+        .version(l10nMonsterVersion, '--version', 'output the current version number')
         .description('Continuous localization for the rest of us.')
         .option('-v, --verbose [level]', '0=error, 1=warning, 2=info, 3=verbose', intOptionParser)
         .option('--regression', 'keep variables constant during regression testing');

package/interfaces.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Central type definitions for @l10nmonster/cli
+ * Re-exports L10nAction as CLIAction for CLI-specific use.
+ */
+
+// Re-export L10nAction from core as CLIAction for backwards compatibility
+export { ActionHelp, L10nAction as CLIAction } from '@l10nmonster/core';
+
+/**
+ * Function signature for running the L10n Monster CLI.
+ */
+export type RunMonsterCLI = (
+    monsterConfig: any,
+    cliCommand?: string | string[]
+) => Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@l10nmonster/cli",
-    "version": "3.1.0",
+    "version": "3.1.1",
     "description": "Continuous localization for the rest of us",
     "bin": {
         "l10n": "l10n.mjs"
@@ -15,7 +15,8 @@
         "translation-files"
     ],
     "scripts": {
-        "test": "node --test"
+        "test": "node --test",
+        "typecheck": "tsc --noEmit"
     },
     "author": "Diego Lagunas",
     "license": "MIT",
@@ -28,6 +29,6 @@
     },
     "dependencies": {
         "commander": "^14",
-        "@l10nmonster/core": "3.1.0"
+        "@l10nmonster/core": "3.1.1"
     }
 }

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "extends": "../tsconfig.base.json",
+  "include": [
+    "*.js",
+    "**/*.js"
+  ],
+  "exclude": [
+    "node_modules",
+    "**/node_modules",
+    "test/**",
+    "tests/**",
+    "**/*.test.js",
+    "**/*.spec.js",
+    "dist/**",
+    "ui/**",
+    "types/**"
+  ]
+}

package/.releaserc.json

@@ -1,31 +0,0 @@
-{
-  "branches": [
-    "main",
-    {
-      "name": "next",
-      "prerelease": "alpha"
-    },
-    {
-      "name": "beta",
-      "prerelease": "beta"
-    }
-  ],
-  "tagFormat": "@l10nmonster/cli@${version}",
-  "plugins": [
-    "@semantic-release/commit-analyzer",
-    "@semantic-release/release-notes-generator",
-    {
-      "path": "@semantic-release/changelog",
-      "changelogFile": "CHANGELOG.md"
-    },
-    {
-      "path": "@semantic-release/npm",
-      "npmPublish": false
-    },
-    {
-      "path": "@semantic-release/git",
-      "assets": ["CHANGELOG.md", "package.json"],
-      "message": "chore(release): @l10nmonster/cli@${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
-    }
-  ]
-}