translatex 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,42 @@
-# Temporary Holding Version
+# translatex
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Free translation for your agent — no API key, no signup, no config.**
+
+`npm install -g translatex` puts a 6 MB static binary on `PATH`. 26 translation
+providers raced in parallel, structured JSON out, one skill file for 24 coding
+agents. The package itself is a shim: the binary is downloaded once from the
+matching GitHub release.
+
+```bash
+npm install -g translatex
+translatex translate "Hello world" -t zh
+```
+
+## Agent setup
+
+The integration is the CLI plus a skill. Give your agent the skill from
+[`integrations/skill/translatex/SKILL.md`](https://github.com/w21180239/translatex/blob/main/integrations/skill/translatex/SKILL.md),
+or the short block in
+[`integrations/guidance/AGENTS.md`](https://github.com/w21180239/translatex/blob/main/integrations/guidance/AGENTS.md)
+for harnesses that read a project instructions file.
+
+```bash
+translatex translate "Hello world" -t zh --format json
+translatex roundtrip "In today's landscape, …" --from en --format json
+```
+
+Full harness matrix: https://github.com/w21180239/translatex/tree/main/integrations
+
+## Offline install
+
+```bash
+TRANSLATEX_BINARY_PATH=/path/to/translatex npm install -g translatex
+```
+
+Or skip npm entirely:
+
+```bash
+cargo install translatex --locked
+```
+
+Full documentation: https://github.com/w21180239/translatex

package/bin/translatex.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+'use strict';
+
+// Thin shim: the native binary is fetched by scripts/install.js at install
+// time, so this package stays platform-neutral and a few kilobytes.
+
+const { spawn } = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const exe = path.join(
+  __dirname,
+  process.platform === 'win32' ? 'translatex.exe' : 'translatex'
+);
+
+if (!fs.existsSync(exe)) {
+  process.stderr.write(
+    [
+      'translatex: the native binary is missing from this install.',
+      '',
+      'Reinstall it:',
+      '  npm install -g translatex --force',
+      '',
+      'Or build from source:',
+      '  cargo install translatex --locked',
+      '',
+      'If your platform has no prebuilt binary yet, use cargo.',
+      '',
+    ].join('\n')
+  );
+  process.exit(1);
+}
+
+const child = spawn(exe, process.argv.slice(2), { stdio: 'inherit' });
+
+child.on('error', (err) => {
+  process.stderr.write(`translatex: failed to start ${exe}: ${err.message}\n`);
+  process.exit(1);
+});
+
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code === null ? 1 : code);
+});

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "translatex",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Free translation CLI for AI agents: no API key, no signup, no config. 26 providers, JSON output, one 6 MB binary.",
+  "license": "MIT OR Apache-2.0",
+  "author": "w21180239",
+  "homepage": "https://github.com/w21180239/translatex",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/w21180239/translatex.git"
+  },
+  "bugs": {
+    "url": "https://github.com/w21180239/translatex/issues"
+  },
+  "keywords": [
+    "translation",
+    "translator",
+    "translate",
+    "cli",
+    "agent",
+    "agent-native",
+    "ai",
+    "llm",
+    "i18n",
+    "localization",
+    "free",
+    "no-api-key",
+    "humanizer",
+    "deai",
+    "mcp-alternative"
+  ],
+  "bin": {
+    "translatex": "bin/translatex.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install.js"
+  },
+  "files": [
+    "bin/translatex.js",
+    "scripts/install.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/install.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+'use strict';
+
+// Downloads the prebuilt binary for this platform from the matching GitHub
+// release. Falls back with a clear message when no asset exists, so the package
+// never installs a broken shim silently.
+
+const fs = require('node:fs');
+const path = require('node:path');
+const https = require('node:https');
+
+const pkg = require('../package.json');
+const REPO = 'w21180239/translatex';
+
+const TARGETS = {
+  'darwin-x64': 'translatex-x86_64-apple-darwin',
+  'darwin-arm64': 'translatex-aarch64-apple-darwin',
+  'linux-x64': 'translatex-x86_64-unknown-linux-gnu',
+  'linux-arm64': 'translatex-aarch64-unknown-linux-gnu',
+  'win32-x64': 'translatex-x86_64-pc-windows-msvc',
+};
+
+function target() {
+  const key = `${process.platform}-${process.arch}`;
+  const name = TARGETS[key];
+  if (!name) {
+    return null;
+  }
+  return name;
+}
+
+function download(url, destination, redirects = 0) {
+  return new Promise((resolve, reject) => {
+    if (redirects > 5) {
+      reject(new Error(`too many redirects for ${url}`));
+      return;
+    }
+    https
+      .get(url, { headers: { 'user-agent': `translatex-npm/${pkg.version}` } }, (res) => {
+        const { statusCode, headers } = res;
+        if (statusCode >= 300 && statusCode < 400 && headers.location) {
+          res.resume();
+          download(headers.location, destination, redirects + 1).then(resolve, reject);
+          return;
+        }
+        if (statusCode !== 200) {
+          res.resume();
+          reject(new Error(`HTTP ${statusCode} for ${url}`));
+          return;
+        }
+        const out = fs.createWriteStream(destination);
+        res.pipe(out);
+        out.on('finish', () => out.close(resolve));
+        out.on('error', reject);
+      })
+      .on('error', reject);
+  });
+}
+
+async function main() {
+  // Escape hatch for air-gapped installs and for trying a local build.
+  if (process.env.TRANSLATEX_BINARY_PATH) {
+    const from = process.env.TRANSLATEX_BINARY_PATH;
+    const to = path.join(__dirname, '..', 'bin', path.basename(from));
+    fs.copyFileSync(from, to);
+    process.stderr.write(`translatex: using ${from}\n`);
+    return;
+  }
+
+  const name = target();
+  if (!name) {
+    process.stderr.write(
+      [
+        `translatex: no prebuilt binary for ${process.platform}/${process.arch}.`,
+        '',
+        'Install from source instead:',
+        '  cargo install translatex --locked',
+        '',
+      ].join('\n')
+    );
+    process.exit(1);
+  }
+
+  const exe = process.platform === 'win32' ? 'translatex.exe' : 'translatex';
+  const destination = path.join(__dirname, '..', 'bin', exe);
+
+  if (fs.existsSync(destination)) {
+    fs.chmodSync(destination, 0o755);
+    return;
+  }
+
+  const base = process.env.TRANSLATEX_RELEASE_BASE
+    || `https://github.com/${REPO}/releases/download/v${pkg.version}`;
+  const url = `${base}/${name}.tar.gz`;
+  const tmp = `${destination}.tar.gz`;
+
+  try {
+    process.stderr.write(`translatex: downloading ${url}\n`);
+    await download(url, tmp);
+    // The release asset is a .tar.gz holding the binary at its root.
+    await new Promise((resolve, reject) => {
+      const { execFile } = require('node:child_process');
+      execFile('tar', ['-xzf', tmp, '-C', path.dirname(destination)], (err) => {
+        if (err) reject(err);
+        else resolve();
+      });
+    });
+    fs.rmSync(tmp, { force: true });
+    fs.chmodSync(destination, 0o755);
+    process.stderr.write(`translatex: installed ${destination}\n`);
+  } catch (err) {
+    fs.rmSync(tmp, { force: true });
+    process.stderr.write(
+      [
+        `translatex: could not download the prebuilt binary (${err.message}).`,
+        '',
+        'Install from source instead:',
+        '  cargo install translatex --locked',
+        '',
+      ].join('\n')
+    );
+    process.exit(1);
+  }
+}
+
+main();