@nubjs/nub 0.0.41 → 0.0.44

package/LICENSE

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

@@ -0,0 +1,60 @@
+# Nub
+
+TypeScript-first developer supertool for Node.js. Run `.ts`/`.tsx` files directly on your installed Node, a faster `npm run`, a pnpm-compatible package manager, and a built-in Node version manager — no config, no lock-in, no nub-specific public APIs.
+
+**Documentation:** https://nubjs.com/docs
+
+## Install
+
+```sh
+# macOS / Linux
+curl -fsSL https://nubjs.com/install.sh | bash
+
+# Windows (PowerShell)
+irm https://nubjs.com/install.ps1 | iex
+
+# Or via npm
+npm install -g @nubjs/nub
+```
+
+## Quickstart
+
+```sh
+# Run TypeScript directly — no tsconfig, no build step
+nub server.ts
+
+# Run package.json scripts (faster than npm/pnpm run)
+nub run dev
+nub run build
+
+# Execute a local or remote binary
+nubx vitest --run
+
+# Watch mode — restart on change
+nub watch server.ts
+```
+
+## What Nub does
+
+- **TypeScript just works.** Files ending in `.ts`, `.tsx`, `.mts`, `.cts`, `.jsx` execute directly. Enums, decorators, parameter properties, and namespaces are handled. Source maps work in error traces.
+- **The `.env` loading is built in.** Workspace-aware, with `${VAR}` expansion and `.env.local` / `.env.production` layering.
+- **The script runner is faster.** Running `nub run` resolves scripts, adds `node_modules/.bin` to PATH, and runs lifecycle hooks — without the per-invocation Node bootstrap that `npm run` / `pnpm run` pay.
+- **Auto-flag injection.** Experimental Node features are unflagged based on your Node version; opt out with `--no-experimental-*`.
+- **The tsconfig paths resolve.** A path like `@lib/utils` resolves via `compilerOptions.paths` with no build step. Extensionless and data-format imports (`.jsonc`, `.json5`, `.toml`, `.yaml`) work too.
+- **Polyfills.** `Temporal`, `URLPattern`, `RegExp.escape`, `Error.isError`, `Promise.try`, `navigator` — feature-detected, native wins.
+- **Package management.** Commands such as `nub install` / `add` / `remove` are pnpm-compatible on the CLI and lockfile-compatible with whatever the project already uses (npm / pnpm / bun round-trip, yarn read-only) — Nub does not impose its own lockfile format.
+- **Node version management.** Nub provisions and pins the project's Node version, so `nvm` / `corepack` are not needed.
+
+## How it works
+
+Nub is not a Node fork. It is a Rust CLI that orchestrates your installed Node via Node's own extension surfaces — `module.registerHooks()`, `--import` preloads, V8 flag injection, an N-API addon for fast transpilation, and a per-invocation PATH shim. Code targeting Node runs on Nub byte-for-byte. For orchestration without augmentation, use `nub run --node`.
+
+There are no nub-specific public APIs to import, no `nub:*` module namespace, and no config field you author named after the tool. Adopting Nub is reversible — the project keeps running under plain Node and your existing package manager.
+
+## Requirements
+
+Nub runs on your installed Node, version **18.19.0 or newer**. The fast tier (sync `module.registerHooks()`) engages on Node **22.15+**; versions 18.19–22.14 run in a compatibility tier via async `module.register()`. Supported platforms: macOS (arm64, x64), Linux (x64, arm64), Windows (x64).
+
+## License
+
+MIT — see [LICENSE](./LICENSE). Full docs at https://nubjs.com/docs.

package/package.json

@@ -1,10 +1,26 @@
 {
   "name": "@nubjs/nub",
-  "version": "0.0.41",
+  "version": "0.0.44",
   "description": "TypeScript-first developer supertool — a fast script runner and TS runtime powered by Node.js",
   "license": "MIT",
   "repository": "https://github.com/nubjs/nub",
-  "homepage": "https://github.com/nubjs/nub",
+  "homepage": "https://nubjs.com",
+  "bugs": {
+    "url": "https://github.com/nubjs/nub/issues"
+  },
+  "keywords": [
+    "typescript",
+    "nodejs",
+    "runtime",
+    "ts-node",
+    "tsx",
+    "script-runner",
+    "package-manager",
+    "node-version-manager"
+  ],
+  "engines": {
+    "node": ">=18.19.0"
+  },
   "bin": {
     "nub": "bin/nub",
     "nubx": "bin/nubx"
@@ -15,16 +31,18 @@
   "files": [
     "bin",
     "platform.js",
-    "postinstall.js"
+    "postinstall.js",
+    "README.md",
+    "LICENSE"
   ],
   "optionalDependencies": {
-    "@nubjs/nub-darwin-arm64": "0.0.41",
-    "@nubjs/nub-darwin-x64": "0.0.41",
-    "@nubjs/nub-linux-x64": "0.0.41",
-    "@nubjs/nub-linux-x64-musl": "0.0.41",
-    "@nubjs/nub-linux-arm64": "0.0.41",
-    "@nubjs/nub-linux-arm64-musl": "0.0.41",
-    "@nubjs/nub-win32-x64": "0.0.41",
-    "@nubjs/nub-win32-arm64": "0.0.41"
+    "@nubjs/nub-darwin-arm64": "0.0.44",
+    "@nubjs/nub-darwin-x64": "0.0.44",
+    "@nubjs/nub-linux-x64": "0.0.44",
+    "@nubjs/nub-linux-x64-musl": "0.0.44",
+    "@nubjs/nub-linux-arm64": "0.0.44",
+    "@nubjs/nub-linux-arm64-musl": "0.0.44",
+    "@nubjs/nub-win32-x64": "0.0.44",
+    "@nubjs/nub-win32-arm64": "0.0.44"
   }
 }