@goxjs/goxjs 0.1.0

package/README.md

@@ -0,0 +1,48 @@
+# @goxjs/goxjs
+
+> Gox JavaScript Runtime — 用 Go 从零实现的 JavaScript 运行时：词法分析 → 语法分析 → 字节码编译 → 栈式虚拟机执行。单二进制、零外部依赖。
+
+本包把 Gox 的各平台二进制分发到 npm，安装后直接获得 `goxjs` 命令。
+
+## 安装
+
+```bash
+npm i -g @goxjs/goxjs
+```
+
+## 使用
+
+**REPL：**
+
+```bash
+goxjs
+```
+
+```
+Gox REPL (ES6 subset, no var)
+Type :exit to quit, :help for help
+
+> let x = 10
+> [1, 2, 3].map(v => v * 2)
+  [2, 4, 6]
+```
+
+**运行脚本：**
+
+```bash
+goxjs app.js
+```
+
+**免安装直接跑：**
+
+```bash
+npx goxjs app.js
+```
+
+支持 ES6+ 语言子集（`let`/`const`、class、`async`/`await`、解构、模板字符串、ES 模块），内置 `Array` / `Map` / `Set` / `Promise` / `BigInt` / `Temporal` 等标准对象，以及 `fs` / `http` / `fetch` / `path` / `process` 等 Node 风格宿主 API。
+
+完整文档与语言示例见 [GitHub 仓库](https://github.com/14752222/Gox)。
+
+## License
+
+[Apache License 2.0](https://github.com/14752222/Gox/blob/main/LICENSE)

package/bin/gox.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+// goxjs 命令入口: 检测平台后把参数原样转发给对应架构的 Gox 二进制。
+var spawn = require('child_process').spawn;
+var path = require('path');
+
+// 二进制路径: 若未来拆出平台分包 (goxjs-darwin-arm64 等, 其 index.js 导出二进制路径)
+// 则优先从分包取; 否则用本包自带的 binaries/ 目录。
+var osName = process.platform === 'win32' ? 'windows' : process.platform;
+var bin;
+try {
+  bin = require('goxjs-' + process.platform + '-' + process.arch);
+} catch (_) {
+  bin = path.join(__dirname, '..', 'binaries',
+    osName + '-' + process.arch,
+    process.platform === 'win32' ? 'gox.exe' : 'gox');
+}
+
+var child = spawn(bin, process.argv.slice(2), { stdio: 'inherit' });
+child.on('error', function (err) {
+  console.error('goxjs: 无法启动平台二进制 (' + err.message + ')');
+  console.error('请尝试重新安装: npm i -g @goxjs/goxjs');
+  process.exit(1);
+});
+child.on('close', function (code, signal) {
+  if (signal) process.kill(process.pid, signal);
+  else process.exit(code == null ? 0 : code);
+});

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@goxjs/goxjs",
+  "version": "0.1.0",
+  "description": "Gox — 用 Go 从零实现的 JavaScript 运行时（lexer → parser → 字节码 VM），单二进制零外部依赖",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/14752222/Gox.git"
+  },
+  "bin": {
+    "goxjs": "bin/gox.js"
+  },
+  "files": [
+    "bin/gox.js",
+    "binaries/"
+  ],
+  "engines": {
+    "node": ">=14"
+  },
+  "keywords": [
+    "javascript",
+    "runtime",
+    "interpreter",
+    "bytecode-vm",
+    "go"
+  ]
+}