trans-spec 1.0.0

package/cli/src/auth.js

@@ -0,0 +1,98 @@
+import { execSync, spawn } from "child_process";
+import ora from "ora";
+import chalk from "chalk";
+
+const MAX_RETRIES = 2;
+
+function wait(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function isAuthenticated() {
+  try {
+    const output = execSync("npx lingo.dev@latest auth 2>&1", {
+      encoding: "utf-8",
+      stdio: "pipe",
+    });
+    console.log("Auth output:", output);
+    return output.includes("Authenticated as");
+  } catch (err) {
+    console.log("Auth error:", err.stderr || err.stdout || err.message);
+    return false;
+  }
+}
+
+async function triggerLogin() {
+  return new Promise((resolve, reject) => {
+    const spinner = ora("Opening browser for authentication...").start();
+
+    const login = spawn("npx", ["lingo.dev@latest", "login"], {
+      stdio: "inherit",
+      shell: true,
+      windowsHide: false,
+    });
+
+    login.on("close", (code) => {
+      if (code === 0) {
+        spinner.succeed("Login complete");
+        resolve();
+      } else {
+        spinner.fail("Login failed");
+        reject(new Error("Login process exited with code " + code));
+      }
+    });
+
+    login.on("error", (err) => {
+      spinner.fail("Login failed");
+      reject(err);
+    });
+  });
+}
+
+export async function checkAuth() {
+  const spinner = ora(
+    "Checking authentication (downloading dependencies on first run, this may take a minute)...",
+  ).start();
+
+  // Already authenticated, no need to login
+  if (isAuthenticated()) {
+    spinner.succeed(chalk.green("Authenticated"));
+    return;
+  }
+
+  spinner.stop();
+
+  // Not authenticated, trigger login once
+  try {
+    await triggerLogin();
+  } catch (err) {
+    console.log(chalk.red("✖ Login failed: " + err.message));
+    process.exit(1);
+  }
+
+  // After login, wait and retry auth check up to MAX_RETRIES times
+  for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+    await wait(2000); // wait 2 seconds before checking
+
+    if (isAuthenticated()) {
+      console.log(chalk.green("✔ Successfully authenticated"));
+      return;
+    }
+
+    if (attempt < MAX_RETRIES) {
+      console.log(
+        chalk.yellow(
+          `Auth check failed. Retrying (${attempt}/${MAX_RETRIES})...`,
+        ),
+      );
+    }
+  }
+
+  console.log(chalk.red("✖ Authentication failed after login."));
+  console.log(
+    chalk.white(
+      "Please run: npx lingo.dev@latest login manually and try again.",
+    ),
+  );
+  process.exit(1);
+}

package/cli/src/config.js

@@ -0,0 +1,70 @@
+import fs from "fs";
+import path from "path";
+import chalk from "chalk";
+import ora from "ora";
+
+const TRANSSPEC_DIR = ".trans-spec";
+const CONFIG_PATH = path.join(TRANSSPEC_DIR, "i18n.json");
+
+export async function generateConfig(languages, source = "en") {
+  const spinner = ora("Generating config...").start();
+
+  try {
+    // Handles both comma and space separated: "es,fr,de" or "es fr de"
+    // Parse new languages if provided
+    let newTargets = [];
+    if (languages) {
+      newTargets = languages
+        .split(/[\s,]+/)
+        .map((lang) => lang.trim())
+        .filter(Boolean);
+    }
+
+    // Check if config already exists
+    let existingTargets = [];
+    if (fs.existsSync(CONFIG_PATH)) {
+      const existingConfig = JSON.parse(fs.readFileSync(CONFIG_PATH, "utf-8"));
+      existingTargets = existingConfig.locale?.targets || [];
+    }
+
+    // Merge: existing + new, remove duplicates
+    const allTargets = [...new Set([...existingTargets, ...newTargets])];
+
+    if (allTargets.length === 0) {
+      spinner.fail(chalk.red("No target languages provided"));
+      process.exit(1);
+    }
+
+    const config = {
+      $schema: "https://lingo.dev/schema/i18n.json",
+      version: "1.12",
+      locale: {
+        source: source,
+        targets: allTargets,
+      },
+      buckets: {
+        yaml: {
+          include: ["i18n/[locale]/*.yaml"],
+        },
+      },
+    };
+
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
+
+    if (newTargets.length > 0) {
+      spinner.succeed(
+        chalk.green(`Config updated: ${source} → ${allTargets.join(", ")}`),
+      );
+    } else {
+      spinner.succeed(
+        chalk.green(
+          `Using existing config: ${source} → ${allTargets.join(", ")}`,
+        ),
+      );
+    }
+    return allTargets;
+  } catch (err) {
+    spinner.fail(chalk.red("Config generation failed: " + err.message));
+    process.exit(1);
+  }
+}

package/cli/src/setup.js

@@ -0,0 +1,39 @@
+import fs from "fs";
+import path from "path";
+import chalk from "chalk";
+import ora from "ora";
+
+const TRANSSPEC_DIR = ".trans-spec";
+const I18N_DIR = path.join(TRANSSPEC_DIR, "i18n");
+
+export async function setup(specPath, sourceLanguage) {
+  const spinner = ora("Setting up project...").start();
+
+  try {
+    const resolvedSpecPath = path.resolve(specPath);
+
+    if (!fs.existsSync(resolvedSpecPath)) {
+      spinner.fail(chalk.red(`Spec file not found: ${specPath}`));
+      process.exit(1);
+    }
+
+    // Use source language folder
+    const sourceDir = path.join(I18N_DIR, sourceLanguage);
+
+    if (!fs.existsSync(TRANSSPEC_DIR)) {
+      fs.mkdirSync(sourceDir, { recursive: true });
+      spinner.text = "Created .trans-spec folder structure";
+    }
+
+    // Preserve the original filename
+    const originalFilename = path.basename(resolvedSpecPath);
+    const destPath = path.join(sourceDir, originalFilename);
+
+    fs.copyFileSync(resolvedSpecPath, destPath);
+
+    spinner.succeed(chalk.green("Project setup complete"));
+  } catch (err) {
+    spinner.fail(chalk.red("Setup failed: " + err.message));
+    process.exit(1);
+  }
+}

package/cli/src/translate.js

@@ -0,0 +1,71 @@
+import { spawn } from "child_process";
+import chalk from "chalk";
+import ora from "ora";
+import path from "path";
+
+const TRANSSPEC_DIR = ".trans-spec";
+const MAX_RETRIES = 2;
+
+async function runTranslation() {
+  return new Promise((resolve, reject) => {
+    let output = "";
+    let hasErrors = false;
+
+    const process = spawn("npx", ["lingo.dev@latest", "run"], {
+      cwd: path.resolve(TRANSSPEC_DIR),
+      shell: true,
+      stdio: "pipe",
+    });
+
+    // Capture stdout
+    process.stdout.on("data", (data) => {
+      const text = data.toString();
+      output += text;
+      console.log(text);
+      // Check for failure indicators
+      if (text.includes("❌") || text.includes("[Failed Files]")) {
+        hasErrors = true;
+      }
+    });
+
+    process.on("close", (code) => {
+      if (code !== 0 || hasErrors) {
+        reject(new Error("Translation had errors or failures"));
+      } else {
+        resolve();
+      }
+    });
+
+    process.on("error", (err) => {
+      reject(err);
+    });
+  });
+}
+
+export async function translate(targets) {
+  const spinner = ora("Translating...").start();
+  spinner.stop();
+
+  for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+    try {
+      await runTranslation();
+      console.log(chalk.green("\n✔ Translation complete"));
+      return;
+    } catch (err) {
+      if (attempt < MAX_RETRIES) {
+        console.log(
+          chalk.yellow(
+            `Translation failed. Retrying (${attempt}/${MAX_RETRIES})...`,
+          ),
+        );
+      }
+    }
+  }
+
+  console.log(chalk.red("Translation failed after 2 attempts."));
+  // console.log(chalk.red("Check the errors above for details."));
+  console.log(
+    chalk.white("Please try running manually: npx lingo.dev@latest run"),
+  );
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "trans-spec",
+  "version": "1.0.0",
+  "description": "Translate your OpenAPI specification into any language and generate a multilingual documentation site in seconds",
+  "main": "cli/index.js",
+  "scripts": {
+    "test": "echo \"No tests yet\" && exit 0"
+  },
+  "bin": {
+    "trans-spec": "./cli/index.js"
+  },
+  "type": "module",
+  "keywords": [
+    "api",
+    "documentation",
+    "openapi",
+    "swagger",
+    "translation",
+    "i18n",
+    "multilingual",
+    "ai"
+  ],
+  "author": "Ademola Thompson",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ade555/trans-spec.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ade555/trans-spec/issues"
+  },
+  "homepage": "https://github.com/ade555/trans-spec#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "cli",
+    "viewer",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "ora": "^9.3.0"
+  }
+}

package/viewer/README.md

@@ -0,0 +1,16 @@
+# React + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) (or [oxc](https://oxc.rs) when used in [rolldown-vite](https://vite.dev/guide/rolldown)) for Fast Refresh
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
+
+## React Compiler
+
+The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend using TypeScript with type-aware lint rules enabled. Check out the [TS template](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) for information on how to integrate TypeScript and [`typescript-eslint`](https://typescript-eslint.io) in your project.

package/viewer/eslint.config.js

@@ -0,0 +1,29 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import { defineConfig, globalIgnores } from 'eslint/config'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{js,jsx}'],
+    extends: [
+      js.configs.recommended,
+      reactHooks.configs.flat.recommended,
+      reactRefresh.configs.vite,
+    ],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        ecmaFeatures: { jsx: true },
+        sourceType: 'module',
+      },
+    },
+    rules: {
+      'no-unused-vars': ['error', { varsIgnorePattern: '^[A-Z_]' }],
+    },
+  },
+])

package/viewer/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Trans-Spec API Docs viewer</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
+</html>