@better-translate/cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jorge Alvarenga
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @better-translate/cli
+
+`@better-translate/cli` generates translated message files and localized markdown from one source locale. Use it when you want Better Translate to create or update locale files for you.
+
+Full docs: [better-translate-placeholder.com/en/docs/cli](https://better-translate-placeholder.com/en/docs/cli)

package/dist/ai-sdk-generator-WPQCTPGA.js

@@ -0,0 +1,37 @@
+// src/ai-sdk-generator.ts
+async function generateWithAiSdk(model, request) {
+  const { Output, generateText, jsonSchema } = await import("ai");
+  const result = await generateText({
+    experimental_output: Output.object({
+      schema: jsonSchema(request.schema, {
+        validate(value) {
+          if (!request.validate) {
+            return {
+              success: true,
+              value
+            };
+          }
+          try {
+            return {
+              success: true,
+              value: request.validate(value)
+            };
+          } catch (error) {
+            return {
+              error: error instanceof Error ? error : new Error(String(error)),
+              success: false
+            };
+          }
+        }
+      })
+    }),
+    model,
+    prompt: request.prompt,
+    system: request.system,
+    temperature: 0
+  });
+  return result.experimental_output;
+}
+export {
+  generateWithAiSdk
+};

package/dist/ai-sdk-generator.d.ts

@@ -0,0 +1,3 @@
+import type { StructuredGenerationRequest } from "./types.js";
+export declare function generateWithAiSdk<TOutput>(model: unknown, request: StructuredGenerationRequest<TOutput>): Promise<TOutput>;
+//# sourceMappingURL=ai-sdk-generator.d.ts.map

package/dist/ai-sdk-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk-generator.d.ts","sourceRoot":"","sources":["../src/ai-sdk-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAE9D,wBAAsB,iBAAiB,CAAC,OAAO,EAC7C,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,2BAA2B,CAAC,OAAO,CAAC,GAC5C,OAAO,CAAC,OAAO,CAAC,CAkClB"}

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+import {
+  generateProject
+} from "./chunk-JFSWNLL6.js";
+
+// src/cli.ts
+import pc2 from "picocolors";
+
+// src/logger.ts
+import ora from "ora";
+import pc from "picocolors";
+function createSpinnerLogger() {
+  const spinner = ora({ color: "cyan" });
+  return {
+    info(message) {
+      if (message.startsWith("Prepared ") || message.startsWith("Finished locale ")) {
+        return;
+      }
+      const localeMatch = message.match(/^Starting locale "(.+)"\.\.\./);
+      if (localeMatch) {
+        spinner.stop();
+        console.log(`
+${pc.magenta("\u25C6")} locale: ${pc.bold(localeMatch[1])}`);
+        return;
+      }
+      if (message === "Loading Better Translate config...") {
+        spinner.start(message);
+        return;
+      }
+      if (message.startsWith("Loading source messages from ")) {
+        spinner.start(message);
+        return;
+      }
+      const msgTranslateMatch = message.match(
+        /^Requesting message translation for "(.+)"\.\.\./
+      );
+      if (msgTranslateMatch) {
+        spinner.start(`Translating messages \u2192 ${msgTranslateMatch[1]}`);
+        return;
+      }
+      const mdTranslateMatch = message.match(
+        /^Requesting markdown translation for ".+": (.+)/
+      );
+      if (mdTranslateMatch) {
+        spinner.start(`Translating ${mdTranslateMatch[1]}`);
+        return;
+      }
+      if (message.startsWith("Using config: ")) {
+        spinner.succeed(message);
+        return;
+      }
+      if (message.match(/^Loaded \d+ translation key/)) {
+        spinner.succeed(message);
+        return;
+      }
+      const writeMsgMatch = message.match(/^wrote messages:(\S+) (.+)/);
+      if (writeMsgMatch) {
+        const shortPath = (writeMsgMatch[2] ?? "").split("/").slice(-3).join("/");
+        spinner.succeed(`${pc.green("\u2713")} ${shortPath}`);
+        return;
+      }
+      const writeMdMatch = message.match(/^wrote markdown:(\S+) (.+)/);
+      if (writeMdMatch) {
+        const shortPath = (writeMdMatch[2] ?? "").split("/").slice(-3).join("/");
+        spinner.succeed(`${pc.green("\u2713")} ${shortPath}`);
+        return;
+      }
+      if (message.startsWith("[dry-run] ")) {
+        spinner.stopAndPersist({ symbol: "\u25CC", text: pc.dim(message) });
+        return;
+      }
+      if (message.startsWith("Using AI Gateway model:") || message.startsWith("Using built-in OpenAI provider model:") || message.startsWith("Source locale:") || message.startsWith("Target locales:")) {
+        spinner.stop();
+        console.log(pc.dim(message));
+        return;
+      }
+      if (message.match(/^Found \d+ markdown file/) || message === "Markdown generation disabled.") {
+        console.log(message);
+        return;
+      }
+      const summaryMatch = message.match(/^(generated|planned) \d+ file/);
+      if (summaryMatch) {
+        spinner.stop();
+        console.log(
+          pc.bold(
+            pc.green(
+              `
+\u2713 ${message.charAt(0).toUpperCase()}${message.slice(1)}`
+            )
+          )
+        );
+        return;
+      }
+      if (message.startsWith("Dry run enabled")) {
+        spinner.stop();
+        console.log(pc.dim(message));
+        return;
+      }
+      console.log(message);
+    },
+    error(message) {
+      spinner.fail(pc.red(message));
+    }
+  };
+}
+
+// src/cli.ts
+function usage() {
+  return [
+    "Usage:",
+    "  bt generate [--config ./better-translate.config.ts] [--dry-run]"
+  ].join("\n");
+}
+function parseArgs(argv) {
+  let configPath;
+  let dryRun = false;
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === "--dry-run") {
+      dryRun = true;
+      continue;
+    }
+    if (arg === "--config" || arg === "-c") {
+      const value = argv[index + 1];
+      if (!value) {
+        throw new Error("--config requires a file path.");
+      }
+      configPath = value;
+      index += 1;
+      continue;
+    }
+    throw new Error(`Unknown argument "${arg}".`);
+  }
+  return {
+    configPath,
+    dryRun
+  };
+}
+async function runCli(argv = process.argv.slice(2), options = {}) {
+  const stderr = options.stderr ?? console.error;
+  const stdout = options.stdout ?? console.log;
+  const [command, ...args] = argv;
+  if (!command || command === "--help" || command === "-h") {
+    stdout(usage());
+    return command ? 0 : 1;
+  }
+  if (command !== "generate") {
+    stderr(`Unknown command "${command}".
+${usage()}`);
+    return 1;
+  }
+  try {
+    const parsed = parseArgs(args);
+    console.log(pc2.bold("\n  better-translate\n"));
+    await generateProject({
+      configPath: parsed.configPath,
+      cwd: options.cwd,
+      dryRun: parsed.dryRun,
+      logger: createSpinnerLogger()
+    });
+    return 0;
+  } catch (error) {
+    stderr(
+      `Better Translate generation failed: ${error instanceof Error ? error.message : String(error)}`
+    );
+    return 1;
+  }
+}
+
+// src/bin.ts
+var exitCode = await runCli();
+if (exitCode !== 0) {
+  process.exit(exitCode);
+}