translatex 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,43 @@
-# 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 binary ships in a per-platform package (`translatex-win32-x64`,
+`translatex-darwin-arm64`, …) pulled in as an optional dependency, so the
+install runs no scripts at all.
+
+```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,62 @@
+#!/usr/bin/env node
+'use strict';
+
+// The native binary ships in a per-platform package declared as an optional
+// dependency, so nothing runs at install time. That matters because npm 12
+// blocks dependency install scripts by default: a download-on-install shim
+// would silently install nothing.
+
+const { spawn } = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const exe = process.platform === 'win32' ? 'translatex.exe' : 'translatex';
+
+// npm blocks package names that look machine-generated, and "win32" trips its
+// spam filter, so the Windows package is published as translatex-windows-x64.
+const platformName = process.platform === 'win32' ? 'windows' : process.platform;
+const platformPackage = `translatex-${platformName}-${process.arch}`;
+
+function binaryFromPlatformPackage() {
+  let packageJson;
+  try {
+    packageJson = require.resolve(`${platformPackage}/package.json`);
+  } catch {
+    return null;
+  }
+  const candidate = path.join(path.dirname(packageJson), exe);
+  return fs.existsSync(candidate) ? candidate : null;
+}
+
+const binary = process.env.TRANSLATEX_BINARY_PATH || binaryFromPlatformPackage();
+
+if (!binary) {
+  process.stderr.write(
+    [
+      `translatex: no binary for ${process.platform}/${process.arch}.`,
+      '',
+      `The package ${platformPackage} is missing. Reinstall, or install from source:`,
+      '  npm install -g translatex --force',
+      '  cargo install translatex --locked',
+      '',
+      'If your platform has no prebuilt binary, cargo is the way.',
+      '',
+    ].join('\n')
+  );
+  process.exit(1);
+}
+
+const child = spawn(binary, process.argv.slice(2), { stdio: 'inherit' });
+
+child.on('error', (err) => {
+  process.stderr.write(`translatex: failed to start ${binary}: ${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,52 @@
 {
   "name": "translatex",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "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"
+  },
+  "files": [
+    "bin/translatex.js",
+    "README.md"
+  ],
+  "optionalDependencies": {
+    "translatex-darwin-arm64": "0.1.1",
+    "translatex-darwin-x64": "0.1.1",
+    "translatex-linux-arm64": "0.1.1",
+    "translatex-linux-x64": "0.1.1",
+    "translatex-windows-x64": "0.1.1"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}