@perryts/perry 0.0.1-bootstrap → 0.5.107

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Perry Contributors
+
+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

@@ -1,9 +1,49 @@
 # @perryts/perry
 
-Namespace-reservation placeholder.
+Native TypeScript compiler. Compiles TypeScript source code directly to native executables via LLVM — no VM, no JIT warmup, no Node at runtime.
 
-The first functional release will be published automatically by CI via
-[Trusted Publishers / OIDC](https://docs.npmjs.com/trusted-publishers).
-For the real entry point, install [`@perryts/perry`](https://www.npmjs.com/package/@perryts/perry).
+## Install
 
-Source: https://github.com/PerryTS/perry
+```bash
+npm install -g @perryts/perry
+# or one-shot
+npx @perryts/perry compile hello.ts -o hello && ./hello
+```
+
+Installing picks the right prebuilt binary for your platform automatically — `@perryts/perry` declares per-platform packages as `optionalDependencies` and npm (≥8.12) selects the matching one based on `os` / `cpu` / `libc`.
+
+## Supported platforms
+
+| Platform | Package |
+|---|---|
+| macOS arm64 (Apple Silicon) | `@perryts/perry-darwin-arm64` |
+| macOS x64 (Intel) | `@perryts/perry-darwin-x64` |
+| Linux x64 (glibc) | `@perryts/perry-linux-x64` |
+| Linux arm64 (glibc) | `@perryts/perry-linux-arm64` |
+| Linux x64 (musl / Alpine) | `@perryts/perry-linux-x64-musl` |
+| Linux arm64 (musl / Alpine) | `@perryts/perry-linux-arm64-musl` |
+| Windows x64 | `@perryts/perry-win32-x64` |
+
+## Host requirements
+
+Perry produces native binaries by linking its runtime and stdlib (shipped as static archives in the platform package) into your code. That link step uses your system C toolchain, so you need:
+
+- **macOS** — Xcode Command Line Tools (`xcode-select --install`)
+- **Linux** — `gcc` or `clang` (e.g. `apt install build-essential` on Debian/Ubuntu, `apk add build-base` on Alpine)
+- **Windows** — MSVC / Visual Studio Build Tools with the C++ workload
+
+Node.js 16 or later is required for the wrapper itself.
+
+## Usage
+
+```bash
+perry compile file.ts -o out      # compile to native binary
+perry --version                   # print version
+perry --help                      # full CLI reference
+```
+
+## Links
+
+- Repository: https://github.com/PerryTS/perry
+- Issues: https://github.com/PerryTS/perry/issues
+- Changelog: https://github.com/PerryTS/perry/blob/main/CHANGELOG.md

package/bin/perry.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+// Wrapper that resolves the platform-specific @perryts/perry-* binary and
+// execs it with stdio inherited + argv passed through. Keeps the installed
+// @perryts/perry package tiny (this script) while the native bits live in
+// optional-dependency packages that npm picks by os/cpu/libc.
+
+const { spawn } = require("child_process");
+
+const PLATFORM_PACKAGES = {
+  "darwin-arm64": "@perryts/perry-darwin-arm64",
+  "darwin-x64": "@perryts/perry-darwin-x64",
+  "linux-arm64": "@perryts/perry-linux-arm64",
+  "linux-arm64-musl": "@perryts/perry-linux-arm64-musl",
+  "linux-x64": "@perryts/perry-linux-x64",
+  "linux-x64-musl": "@perryts/perry-linux-x64-musl",
+  "win32-x64": "@perryts/perry-win32-x64",
+};
+
+function isMusl() {
+  if (process.platform !== "linux") return false;
+  try {
+    const header = process.report && process.report.getReport().header;
+    if (header && "glibcVersionRuntime" in header) {
+      return !header.glibcVersionRuntime;
+    }
+  } catch (_) {}
+  try {
+    const release = require("fs").readFileSync("/etc/os-release", "utf8");
+    return /\bID=alpine\b|\bmusl\b/i.test(release);
+  } catch (_) {}
+  return false;
+}
+
+function detectKey() {
+  let key = `${process.platform}-${process.arch}`;
+  if (process.platform === "linux" && isMusl()) key += "-musl";
+  return key;
+}
+
+const key = detectKey();
+const pkg = PLATFORM_PACKAGES[key];
+if (!pkg) {
+  console.error(
+    `[perry] No prebuilt binary for ${key}.\n` +
+      `Supported: ${Object.keys(PLATFORM_PACKAGES).join(", ")}\n` +
+      `File an issue: https://github.com/PerryTS/perry/issues`
+  );
+  process.exit(1);
+}
+
+const binName = process.platform === "win32" ? "perry.exe" : "perry";
+let binPath;
+try {
+  binPath = require.resolve(`${pkg}/bin/${binName}`);
+} catch (err) {
+  console.error(
+    `[perry] The ${pkg} package is not installed.\n` +
+      `This usually means npm skipped the optional dependency for ${key}.\n` +
+      `Try: npm install --force ${pkg}\n` +
+      `Or reinstall @perryts/perry with a matching npm (\u22658.12) so os/cpu/libc selectors apply.\n` +
+      `Underlying error: ${err.message}`
+  );
+  process.exit(1);
+}
+
+const child = spawn(binPath, process.argv.slice(2), { stdio: "inherit" });
+
+// Forward termination signals so Ctrl-C / supervisor kills propagate to perry.
+for (const sig of ["SIGINT", "SIGTERM", "SIGHUP", "SIGQUIT"]) {
+  process.on(sig, () => {
+    try {
+      child.kill(sig);
+    } catch (_) {}
+  });
+}
+
+child.on("close", (code, signal) => {
+  if (signal) {
+    // Re-raise so the parent shell sees the signal exit, not a plain 1.
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code == null ? 0 : code);
+  }
+});
+
+child.on("error", (err) => {
+  console.error(`[perry] Failed to spawn ${binPath}: ${err.message}`);
+  process.exit(1);
+});

package/package.json

@@ -1,13 +1,47 @@
 {
   "name": "@perryts/perry",
-  "version": "0.0.1-bootstrap",
-  "description": "Namespace-reservation placeholder for @perryts/perry. Real releases are published automatically via CI (Trusted Publishers / OIDC). Install @perryts/perry@latest instead.",
+  "version": "0.5.107",
+  "description": "Native TypeScript compiler. Compiles TypeScript source directly to native executables via LLVM.",
+  "bin": {
+    "perry": "bin/perry.js"
+  },
+  "files": [
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "optionalDependencies": {
+    "@perryts/perry-darwin-arm64":     "0.5.107",
+    "@perryts/perry-darwin-x64":       "0.5.107",
+    "@perryts/perry-linux-x64":        "0.5.107",
+    "@perryts/perry-linux-arm64":      "0.5.107",
+    "@perryts/perry-linux-x64-musl":   "0.5.107",
+    "@perryts/perry-linux-arm64-musl": "0.5.107",
+    "@perryts/perry-win32-x64":        "0.5.107"
+  },
+  "keywords": [
+    "typescript",
+    "compiler",
+    "native",
+    "llvm",
+    "aot",
+    "perry"
+  ],
+  "author": "Perry Contributors",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/PerryTS/perry.git"
+    "url": "git+https://github.com/PerryTS/perry.git",
+    "directory": "npm/perry"
   },
   "homepage": "https://github.com/PerryTS/perry#readme",
-  "bugs": { "url": "https://github.com/PerryTS/perry/issues" },
-  "publishConfig": { "access": "public" }
+  "bugs": {
+    "url": "https://github.com/PerryTS/perry/issues"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }