nhx 0.0.0-alpha.0 → 0.0.1

package/README.md

@@ -1,210 +1,107 @@
-# nhx - Node.js Hybrid eXecutor
+# `nhx` - Node.js Hybrid eXecutor (a `uvx` inspired tool)
 
-A fast, uvx-inspired hybrid tool for Node.js that runs scripts with inline dependencies and executes npm packages without installation.
+[![npm version](https://img.shields.io/npm/v/nhx.svg)](https://www.npmjs.com/package/nhx)
+[![npm downloads](https://img.shields.io/npm/dm/nhx.svg)](https://www.npmjs.com/package/nhx)
 
-```bash
-npm install -g nhx
-```
-
-## Usage
-
-### 1. Run Local Scripts
+A hybrid of `node ./script.js` and `npx package` - run scripts or packages with automatic dependency handling.
 
 ```bash
-nhx ./script.js
-nhx ./script.ts
-nhx -e 'console.log("hello")'
-```
-
-Scripts can declare inline dependencies:
-
-```javascript
-/*/ // <package>
-{
-  dependencies: {
-    chalk: "^5.3.0",
-    lodash: "^4.17.21"
-  }
-}
-/*/ // </package>
-
-import chalk from 'chalk';
-import _ from 'lodash';
-
-console.log(chalk.green(_.capitalize('hello world')));
+npm install -g nhx
 ```
 
-### 2. Execute npm Packages
+## Why nhx?
 
-```bash
-nhx cowsay "Hello World"
-nhx prettier --write .
-nhx --with=typescript tsc --version
-
-# From git
-nhx --with=github:user/repo command
-nhx --with=git+https://github.com/user/repo.git command
-```
+- **Self-contained scripts** - Scripts declare their own dependencies and just work
+- **No project setup** - No `package.json`, no `npm install`, no `node_modules`
+- **Share scripts easily** - Send a single file that anyone can run
+- **Fast** - Dependencies are cached globally, subsequent runs are instant
+- **Works offline** - Once cached, no network needed
 
 ## Options
 
 ```
---with <dep>       Add dependency (can be used multiple times)
---engine <spec>    Run with specific node version (e.g. "node@18")
+--with <dep>       Add a dependency (repeatable, supports @version)
+--engine <spec>    Node version (e.g. node:18, node:>=16)
 --run-postinstall  Allow postinstall scripts (disabled by default)
 -h, --help         Show help
 ```
 
-Node flags like `--import`, `-e`, `-p` are passed through to node.
-
-## TypeScript Support
+All other flags pass through to node.
 
-For full TypeScript support (including enums, decorators, etc.), use tsx:
+## Examples
 
 ```bash
-# Via command line flags
-nhx --with=tsx --import tsx ./script.ts
-
-# Or as a shebang
-#!/usr/bin/env -S npx nhx --with=tsx --import tsx
-```
-
-You can also declare tsx as an inline dependency:
+# Run an npm package
+nhx cowsay hello
 
-```typescript
-#!/usr/bin/env -S npx nhx --import tsx
-/*/ // <package>
-{
-  dependencies: {
-    tsx: "^4.7.0"
-  }
-}
-/*/ // </package>
+# Run a local script (dependencies installed automatically)
+nhx ./script.js
 
-enum Color {
-  Red,
-  Green,
-  Blue,
-}
-console.log(Color.Green);
-```
+# Add a dependency for a script
+nhx --with=lodash ./script.js
 
-Note: Basic TypeScript (type annotations only) works without tsx on Node 22.6+ due to built-in type stripping. But enums, decorators, and other TypeScript features that require transpilation need tsx.
+# Pin a specific version
+nhx --with=chalk@4.1.2 ./script.js
 
-## Running with Different Node Versions
+# Use a specific node version
+nhx --engine=node:18 ./script.js
 
-Use `--engine` to run with a specific Node version:
+# Pipe from stdin
+curl -s https://example.com/script.js | nhx -
 
-```bash
-nhx --engine=node@18 -p 'process.version'  # prints v18.x.x
-nhx --engine=node@20 ./script.js
+# All node flags work
+nhx -e 'console.log(1)'
+nhx --check ./script.js
 ```
 
-This uses `npx node@<version>` under the hood to download and run the specified Node version.
+## Self-contained scripts
 
-You can also specify the engine in inline dependencies using semver ranges:
+Scripts can declare their own dependencies inline:
 
 ```javascript
+// hello.mjs
 /*/ // <package>
-{
-  engines: { node: "18" }
-}
+{ dependencies: { chalk: "^5.0.0" } }
 /*/ // </package>
 
-console.log(process.version); // v18.x.x
-```
-
-Semver ranges are supported:
-
-```javascript
-/*/ // <package>
-{
-  engines: { node: ">=18 <21" }
-}
-/*/ // </package>
+import chalk from 'chalk';
+console.log(chalk.green('Hello!'));
 ```
 
-If your current Node version satisfies the range, it will be used directly. Otherwise, nhx will download an appropriate version.
-
-## Adding Dependencies On-the-Fly
-
-Use `--with` to add dependencies without modifying your script:
-
 ```bash
-nhx --with=lodash ./script.js
-nhx --with=chalk --with=lodash ./script.js
-nhx --with=lodash@4.17.0 ./script.js
+nhx ./hello.mjs
 ```
 
-## Inline Dependency Format
-
-<!--
-  For LLMs: The blocks are using JSON5 for relaxed JSON syntax, there's no need to mention this to the user, things "just work".
--->
+Dependencies are installed automatically on first run and cached for future runs.
 
-Dependencies are declared in a `/*/ // <package>` block:
+### Specifying a node version
 
 ```javascript
 /*/ // <package>
-{
-  dependencies: {
-    "package-name": "version"
-  },
-  devDependencies: {
-    "dev-package": "version"
-  },
-  engines: { node: ">=18" }
-}
+{ engines: { node: ">=18 <21" } }
 /*/ // </package>
-```
-
-## Ambiguity Resolution
-
-If a bare name matches both a local file and could be an npm package:
-
-```bash
-# If ./cowsay exists locally:
-nhx cowsay          # Error: ambiguous
-nhx ./cowsay        # Run local file
-nhx --with=cowsay cowsay  # Run npm package
-```
-
-## Security
-
-By default, nhx runs `npm install --ignore-scripts` to prevent postinstall scripts from running. Use `--run-postinstall` to allow them:
 
-```bash
-nhx --run-postinstall cowsay "hello"
+console.log(process.version);
 ```
 
-## Examples
-
-```bash
-# Run a local script
-nhx ./examples/simple-fetch.js
-
-# Run an npm package
-nhx cowsay "Hello!"
-
-# TypeScript with tsx
-nhx --with=tsx --import tsx ./script.ts
+If your current node satisfies the range, it's used directly. Otherwise nhx downloads an appropriate version.
 
-# Different node version
-nhx --engine=node@18 -p 'process.version'
+### Loaders
 
-# Add dependencies on-the-fly
-nhx --with=chalk --with=lodash ./script.js
+Use tsx as a declared dependency **and** as a loader:
 
-# Forward to node
-nhx -e 'console.log(1 + 1)'
+```typescript
+#!/usr/bin/env -S nhx --with=tsx --import tsx
+import { something } from './other.ts';
 ```
 
-## Development
+You can also do that with inline dependencies:
 
-```bash
-npm install
-npm run build
-npm test
+```typescript
+#!/usr/bin/env -S nhx --import tsx
+/*/ // <package>
+{ devDependencies: { tsx: "^4" } }
+/*/ // </package>
 ```
 
 ## License

package/dist/cli.js

@@ -4,22 +4,19 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const child_process_1 = require("child_process");
 const path_1 = require("path");
 const fs_1 = require("fs");
+const os_1 = require("os");
 const chalk_1 = __importDefault(require("chalk"));
-const minimist_1 = __importDefault(require("minimist"));
 const script_runner_js_1 = require("./script-runner.js");
 const executor_js_1 = require("./executor.js");
-const EXTS = ['.js', '.ts', '.mjs', '.mts'];
-const OUR_FLAGS = ['--help', '-h', '--run-postinstall', '--with', '--engine'];
-const OUR_KEYS = ['_', 'help', 'h', 'run-postinstall', 'with', 'engine'];
+const EXT = ['.js', '.cjs', '.ts', '.mjs', '.mts'];
 const HELP = `
 Usage: nhx [options] [target] [args...]
 
 Options:
   --with <dep>       Add dependency (repeatable)
-  --engine <spec>    Node version (e.g. "node@18")
+  --engine <spec>    Node version (e.g. "node:18", "node:>=18 <20")
   --run-postinstall  Allow postinstall scripts
   -h, --help         Show help
 
@@ -29,122 +26,112 @@ Examples:
   nhx cowsay hi                     # run npm package
   nhx --with=typescript tsc         # run tsc from typescript
   nhx --with=tsx --import tsx a.ts  # typescript
+  curl ... | nhx -                  # run from stdin
 `;
-const toArray = (x) => (x ? (Array.isArray(x) ? x : [x]) : []);
-const isLocal = (t) => t.startsWith('./') ||
-    t.startsWith('/') ||
-    t.startsWith('../') ||
-    EXTS.some((e) => t.endsWith(e));
-const findFile = (t) => [t, ...EXTS.map((e) => t + e)].find(fs_1.existsSync) || null;
-const findMatches = (t) => [t, ...EXTS.map((e) => t + e)].filter(fs_1.existsSync);
-const engineer = (engines) => {
-    const map = {};
-    for (const e of engines) {
-        const [name, ver] = e.split('@');
-        map[name] = ver;
-    }
-    return map;
-};
-function stripOurFlags(argv) {
-    const result = [];
+const isLocal = (t) => /^\.{0,2}\//.test(t);
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    const content = Buffer.concat(chunks).toString('utf8');
+    const dir = (0, fs_1.mkdtempSync)((0, path_1.join)((0, os_1.tmpdir)(), 'nhx-'));
+    const file = (0, path_1.join)(dir, 'script.mts');
+    (0, fs_1.writeFileSync)(file, content);
+    return file;
+}
+const findFile = (t) => [t, ...EXT.map((e) => t + e)].find(fs_1.existsSync);
+const matches = (t) => [t, ...EXT.map((e) => t + e)].filter(fs_1.existsSync);
+// Parse nhx-specific flags from argv (can be interleaved with node flags)
+// All nhx flags must appear before the target - after target, everything is passed through
+function parseNhxArgs(argv) {
+    const withDeps = [];
+    const engines = [];
+    let help = false;
+    let runPostinstall = false;
+    const rest = [];
+    let foundTarget = false;
     for (let i = 0; i < argv.length; i++) {
         const arg = argv[i];
-        const isOurs = OUR_FLAGS.some((f) => arg === f || arg.startsWith(f + '='));
-        if (isOurs) {
-            const needsValue = !arg.includes('=') && ['--with', '--engine'].includes(arg);
-            if (needsValue)
-                i++;
-        }
-        else {
-            result.push(arg);
-        }
+        // Check if this looks like a target (not a flag)
+        if (!arg.startsWith('-'))
+            foundTarget = true;
+        if (foundTarget)
+            rest.push(arg);
+        else if (arg === '-h' || arg === '--help')
+            help = true;
+        else if (arg === '--run-postinstall')
+            runPostinstall = true;
+        else if (arg === '--with' && i + 1 < argv.length)
+            withDeps.push(argv[++i]);
+        else if (arg.startsWith('--with='))
+            withDeps.push(arg.slice(7));
+        else if (arg === '--engine' && i + 1 < argv.length)
+            engines.push(argv[++i]);
+        else if (arg.startsWith('--engine='))
+            engines.push(arg.slice(9));
+        else
+            rest.push(arg);
     }
-    return result;
+    return { withDeps, engines, help, runPostinstall, rest };
 }
-function extractFlags(parsed) {
-    const result = [];
-    for (const [k, v] of Object.entries(parsed)) {
-        if (OUR_KEYS.includes(k))
-            continue;
-        const flag = k.length === 1 ? `-${k}` : `--${k}`;
-        if (v === true)
-            result.push(flag);
-        else if (v !== false && v !== undefined)
-            result.push(flag, String(v));
+// Split rest into nodeArgs, target, and scriptArgs
+function splitArgs(rest) {
+    const nodeArgs = [];
+    let i = 0;
+    // Collect node flags until we hit something that looks like a target
+    while (i < rest.length) {
+        const arg = rest[i];
+        if (!arg.startsWith('-'))
+            break; // found target
+        nodeArgs.push(arg);
+        i++;
+        // If this flag takes a value, include it
+        if (i < rest.length && !rest[i].startsWith('-')) {
+            nodeArgs.push(rest[i]);
+            i++;
+        }
     }
-    return result;
-}
-async function runNode(args, opts) {
-    const hasOpts = opts.with.length || opts.engine.length;
-    if (hasOpts)
-        return (0, script_runner_js_1.runScript)('__eval__', [], {
-            withDeps: opts.with,
-            nodeArgs: args,
-            engines: opts.engine,
-        });
-    return new Promise((res, rej) => {
-        const child = (0, child_process_1.spawn)(process.execPath, args, { stdio: 'inherit' });
-        child.on('exit', (c) => res(c || 0));
-        child.on('error', rej);
-    });
+    const target = rest[i];
+    const args = rest.slice(i + 1);
+    return { nodeArgs, target, args };
 }
 async function main() {
     const argv = process.argv.slice(2);
-    const parseOpts = {
-        boolean: ['help', 'run-postinstall'],
-        string: ['with', 'engine'],
-        alias: { h: 'help' },
-    };
-    const startsWithFlag = argv.length === 0 || argv[0].startsWith('-');
-    if (startsWithFlag) {
-        const parsed = (0, minimist_1.default)(argv, parseOpts);
-        if (parsed.help)
+    const { withDeps, engines, help, runPostinstall, rest } = parseNhxArgs(argv);
+    const { nodeArgs, target, args } = splitArgs(rest);
+    // No target = forward to node (handles -e, -p, --version, etc.)
+    if (!target) {
+        if (help)
             return console.log(HELP);
-        const noTarget = !parsed._.length;
-        if (noTarget)
-            process.exit(await runNode(stripOurFlags(argv), {
-                with: toArray(parsed.with),
-                engine: toArray(parsed.engine),
-            }));
+        process.exit(await (0, script_runner_js_1.runScript)(null, args, { withDeps, nodeArgs, engines }));
     }
-    const parsed = (0, minimist_1.default)(argv, { ...parseOpts, stopEarly: true });
-    if (parsed.help)
-        return console.log(HELP);
-    const [target, ...args] = parsed._;
-    const withDeps = toArray(parsed.with);
-    const engines = toArray(parsed.engine);
-    const opts = {
-        with: withDeps,
-        engines: engines,
-        runPostinstall: parsed['run-postinstall'],
-    };
     try {
-        const hasWithDeps = withDeps.length > 0;
-        const shouldCheckAmbiguity = !isLocal(target) && !hasWithDeps;
-        if (shouldCheckAmbiguity) {
-            const matches = findMatches(target);
-            if (matches.length) {
-                console.error(chalk_1.default.red(`Ambiguous: "${target}" matches: ${matches.join(', ')}`));
+        // Check for ambiguity (bare name that matches local file)
+        if (!isLocal(target) && !withDeps.length) {
+            const matched = matches(target);
+            if (matched.length) {
+                console.error(chalk_1.default.red(`Ambiguous: "${target}" matches: ${matched.join(', ')}`));
                 console.error(chalk_1.default.yellow('Use ./ for local, --with= for npm'));
                 process.exit(1);
             }
         }
+        const opts = { withDeps, nodeArgs, engines };
+        // Stdin
+        if (target === '-') {
+            const file = await readStdin();
+            process.exit(await (0, script_runner_js_1.runScript)(file, args, opts));
+        }
+        // Local file
         if (isLocal(target)) {
             const file = findFile(target);
             if (!file)
                 throw new Error(`File not found: ${target}`);
-            const code = await (0, script_runner_js_1.runScript)((0, path_1.resolve)(file), args, {
-                withDeps: opts.with,
-                nodeArgs: extractFlags(parsed),
-                engines: opts.engines,
-            });
-            process.exit(code);
+            process.exit(await (0, script_runner_js_1.runScript)((0, path_1.resolve)(file), args, opts));
         }
-        // If --with is specified, first --with is the package, target is the command
-        // Otherwise, target is the package (and also the command)
-        const pkg = hasWithDeps ? withDeps[0] : target;
-        const cmdArgs = hasWithDeps ? [target, ...args] : args;
-        await (0, executor_js_1.executePackage)(pkg, cmdArgs, { runPostinstall: opts.runPostinstall });
+        // NPM package
+        const pkg = withDeps.length ? withDeps[0] : target;
+        const binName = withDeps.length ? target : undefined;
+        await (0, executor_js_1.executePackage)(pkg, args, { runPostinstall, binName });
     }
     catch (e) {
         console.error(chalk_1.default.red(`Failed: ${e.message}`));

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/executor.d.ts

@@ -1,4 +1,5 @@
 export declare function executePackage(pkgSpec: string, args?: string[], opts?: {
     runPostinstall?: boolean;
+    binName?: string;
 }): Promise<number>;
 //# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAQA,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,IAAI,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,OAAO,CAAC,MAAM,CAAC,CAwBjB"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AASA,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,IAAI,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACxD,OAAO,CAAC,MAAM,CAAC,CAoBjB"}

package/dist/executor.js

@@ -5,77 +5,81 @@ const fs_1 = require("fs");
 const path_1 = require("path");
 const os_1 = require("os");
 const child_process_1 = require("child_process");
+const crypto_1 = require("crypto");
 const inline_deps_js_1 = require("./inline-deps.js");
-const CACHE = (0, path_1.join)((0, os_1.homedir)(), '.nhx', 'store');
+const CACHE = (0, path_1.join)((0, os_1.homedir)(), '.nhx');
 async function executePackage(pkgSpec, args = [], opts = {}) {
-    const key = `pkg-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;
-    const dir = (0, path_1.join)(CACHE, (0, inline_deps_js_1.getNodeVersionKey)(), key);
-    await fs_1.promises.mkdir(dir, { recursive: true });
-    try {
-        const pkgJson = JSON.stringify({
-            name: 'nhx-exec',
-            version: '1.0.0',
-            private: true,
-        });
-        await fs_1.promises.writeFile((0, path_1.join)(dir, 'package.json'), pkgJson);
-        await install(dir, pkgSpec, opts.runPostinstall || false);
-        const bin = await findBin(dir, pkgSpec);
-        if (!bin)
-            throw new Error(`No executable found for ${pkgSpec}`);
-        const code = await run(bin, args);
-        await fs_1.promises.rm(dir, { recursive: true, force: true }).catch(() => { });
-        return code;
-    }
-    catch (e) {
-        await fs_1.promises.rm(dir, { recursive: true, force: true }).catch(() => { });
-        throw e;
+    // Normalize bare package names: "cowsay" -> "cowsay@*"
+    // Leave alone: versioned ("pkg@1.0"), scoped ("@scope/pkg"), URLs, git specs, file paths
+    const isBare = /^[a-z][\w.-]*$/i.test(pkgSpec);
+    const normalized = isBare ? `${pkgSpec}@*` : pkgSpec;
+    const hash = (0, crypto_1.createHash)('sha256').update(normalized).digest('hex').slice(0, 12);
+    const dir = (0, path_1.join)(CACHE, (0, inline_deps_js_1.getNodeVersionKey)(), hash);
+    const modules = (0, path_1.join)(dir, 'node_modules');
+    if (!(0, fs_1.existsSync)(modules)) {
+        await fs_1.promises.mkdir(dir, { recursive: true });
+        await fs_1.promises.writeFile((0, path_1.join)(dir, 'package.json'), '{"name":"x","private":true}');
+        await fs_1.promises.writeFile((0, path_1.join)(dir, '_meta.json'), JSON.stringify({ pkg: normalized }, null, 2));
+        await install(dir, normalized, opts.runPostinstall || false);
     }
+    const bin = await findBin(dir, pkgSpec, opts.binName);
+    if (!bin)
+        throw new Error(`No executable found for ${pkgSpec}`);
+    return run(bin, args);
 }
-function install(cwd, pkg, postinstall) {
-    const args = ['install', pkg, '--no-save', '--prefer-offline'];
+async function install(cwd, pkg, postinstall) {
+    const base = ['install', pkg, '--no-save'];
     if (!postinstall)
-        args.push('--ignore-scripts');
-    return new Promise((res, rej) => {
-        const child = (0, child_process_1.spawn)('npm', args, { cwd, stdio: 'ignore' });
-        child.on('close', (c) => c === 0 ? res() : rej(new Error(`npm install failed for ${pkg}`)));
-        child.on('error', rej);
+        base.push('--ignore-scripts');
+    const run = (args, silent = false) => new Promise((res) => {
+        const child = (0, child_process_1.spawn)('npm', [...base, ...args], {
+            cwd,
+            stdio: silent ? 'ignore' : ['inherit', 2, 2],
+        });
+        child.on('close', (c) => res(c === 0));
+        child.on('error', () => res(false));
     });
+    // Try offline first (silent), fall back to network
+    if (await run(['--offline'], true))
+        return;
+    if (await run(['--prefer-offline']))
+        return;
+    throw new Error(`npm install failed for ${pkg}`);
 }
-async function findBin(dir, spec) {
+async function findBin(dir, spec, binName) {
     const nm = (0, path_1.join)(dir, 'node_modules');
-    const isGit = /^(git\+|github:|gitlab:)/.test(spec);
-    let pkgDir = '';
-    let pkgName = '';
-    if (isGit) {
+    // Extract package name from spec (handles @scope/pkg@version)
+    const match = spec.match(/^(@?[^@]+)/);
+    const pkgName = match?.[1] || spec;
+    let pkgDir = (0, path_1.join)(nm, pkgName);
+    // If not found, scan node_modules for a package with a bin (handles git/URL specs)
+    if (!(0, fs_1.existsSync)(pkgDir)) {
         const entries = await fs_1.promises.readdir(nm).catch(() => []);
         for (const e of entries) {
-            const skip = e.startsWith('.') || e === '.bin';
-            if (skip)
+            if (e.startsWith('.') || e === '.bin')
                 continue;
             const d = (0, path_1.join)(nm, e);
-            const isDir = (await fs_1.promises.stat(d)).isDirectory();
-            if (!isDir)
+            if (!(await fs_1.promises.stat(d)).isDirectory())
                 continue;
             const p = JSON.parse(await fs_1.promises.readFile((0, path_1.join)(d, 'package.json'), 'utf-8').catch(() => '{}'));
             if (p.bin) {
                 pkgDir = d;
-                pkgName = e;
                 break;
             }
         }
-        if (!pkgDir)
-            return null;
-    }
-    else {
-        pkgName = spec.split('@').find((p) => p && !/^\d/.test(p)) || spec;
-        pkgDir = (0, path_1.join)(nm, pkgName);
     }
+    if (!(0, fs_1.existsSync)(pkgDir))
+        return null;
     const p = JSON.parse(await fs_1.promises.readFile((0, path_1.join)(pkgDir, 'package.json'), 'utf-8').catch(() => '{}'));
     if (!p.bin)
         return null;
     if (typeof p.bin === 'string')
         return (0, path_1.join)(pkgDir, p.bin);
-    const name = pkgName.split('/').pop();
+    // If a specific bin name was requested, use it
+    if (binName && p.bin[binName])
+        return (0, path_1.join)(pkgDir, p.bin[binName]);
+    // Try matching bin name to package name (handles @scope/pkg -> pkg)
+    const name = (p.name || pkgName).split('/').pop();
     if (name && p.bin[name])
         return (0, path_1.join)(pkgDir, p.bin[name]);
     const first = Object.values(p.bin)[0];

package/dist/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"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"}

package/dist/inline-deps.d.ts

@@ -5,7 +5,7 @@ export interface ParsedDeps {
     hasInlineDeps: boolean;
 }
 export declare const parseInlineDependencies: (path: string) => Promise<ParsedDeps>;
-export declare const getNodeVersionKey: () => string;
+export declare const getNodeVersionKey: (targetVersion?: string) => string;
 export declare const createPackageJson: (d: ParsedDeps, name?: string) => {
     name: string;
     version: string;

package/dist/inline-deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inline-deps.d.ts","sourceRoot":"","sources":["../src/inline-deps.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,aAAa,EAAE,OAAO,CAAC;CACxB;AAqBD,eAAO,MAAM,uBAAuB,GAAU,MAAM,MAAM,wBACV,CAAC;AACjD,eAAO,MAAM,iBAAiB,cACoC,CAAC;AACnE,eAAO,MAAM,iBAAiB,GAAI,GAAG,UAAU,EAAE,aAAe;;;;;;CAM9D,CAAC"}
+{"version":3,"file":"inline-deps.d.ts","sourceRoot":"","sources":["../src/inline-deps.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,aAAa,EAAE,OAAO,CAAC;CACxB;AAqBD,eAAO,MAAM,uBAAuB,GAAU,MAAM,MAAM,wBACV,CAAC;AACjD,eAAO,MAAM,iBAAiB,GAAI,gBAAgB,MAAM,WAIvD,CAAC;AACF,eAAO,MAAM,iBAAiB,GAAI,GAAG,UAAU,EAAE,aAAe;;;;;;CAM9D,CAAC"}

package/dist/inline-deps.js

@@ -27,7 +27,11 @@ function parseContent(content) {
 }
 const parseInlineDependencies = async (path) => parseContent(await fs_1.promises.readFile(path, 'utf-8'));
 exports.parseInlineDependencies = parseInlineDependencies;
-const getNodeVersionKey = () => `node-${process.versions.node.split('.').slice(0, 2).join('.')}`;
+const getNodeVersionKey = (targetVersion) => {
+    const ver = targetVersion || process.versions.node;
+    const parts = ver.replace(/^v?/, '').split('.');
+    return `node-${parts.slice(0, 2).join('.')}`;
+};
 exports.getNodeVersionKey = getNodeVersionKey;
 const createPackageJson = (d, name = 'script') => ({
     name,

package/dist/inline-deps.js.map

@@ -1 +1 @@
-{"version":3,"file":"inline-deps.js","sourceRoot":"","sources":["../src/inline-deps.ts"],"names":[],"mappings":";;;;;;AAAA,2BAAoC;AACpC,kDAA0B;AAS1B,MAAM,IAAI,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;AACvD,MAAM,KAAK,GAAe,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAE5D,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IACtE,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC9E,IAAI,IAAI,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAE9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,eAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IAClD,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAEM,MAAM,uBAAuB,GAAG,KAAK,EAAE,IAAY,EAAE,EAAE,CAC5D,YAAY,CAAC,MAAM,aAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AADpC,QAAA,uBAAuB,2BACa;AAC1C,MAAM,iBAAiB,GAAG,GAAG,EAAE,CACpC,QAAQ,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AADtD,QAAA,iBAAiB,qBACqC;AAC5D,MAAM,iBAAiB,GAAG,CAAC,CAAa,EAAE,IAAI,GAAG,QAAQ,EAAE,EAAE,CAAC,CAAC;IACpE,IAAI;IACJ,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,QAAQ;IACd,YAAY,EAAE,CAAC,CAAC,YAAY;IAC5B,eAAe,EAAE,CAAC,CAAC,eAAe;CACnC,CAAC,CAAC;AANU,QAAA,iBAAiB,qBAM3B"}
+{"version":3,"file":"inline-deps.js","sourceRoot":"","sources":["../src/inline-deps.ts"],"names":[],"mappings":";;;;;;AAAA,2BAAoC;AACpC,kDAA0B;AAS1B,MAAM,IAAI,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;AACvD,MAAM,KAAK,GAAe,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAE5D,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IACtE,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC9E,IAAI,IAAI,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAE9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,eAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IAClD,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAEM,MAAM,uBAAuB,GAAG,KAAK,EAAE,IAAY,EAAE,EAAE,CAC5D,YAAY,CAAC,MAAM,aAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AADpC,QAAA,uBAAuB,2BACa;AAC1C,MAAM,iBAAiB,GAAG,CAAC,aAAsB,EAAE,EAAE;IAC1D,MAAM,GAAG,GAAG,aAAa,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACnD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChD,OAAO,QAAQ,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC/C,CAAC,CAAC;AAJW,QAAA,iBAAiB,qBAI5B;AACK,MAAM,iBAAiB,GAAG,CAAC,CAAa,EAAE,IAAI,GAAG,QAAQ,EAAE,EAAE,CAAC,CAAC;IACpE,IAAI;IACJ,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,QAAQ;IACd,YAAY,EAAE,CAAC,CAAC,YAAY;IAC5B,eAAe,EAAE,CAAC,CAAC,eAAe;CACnC,CAAC,CAAC;AANU,QAAA,iBAAiB,qBAM3B"}

package/dist/script-runner.d.ts

@@ -3,5 +3,5 @@ export interface RunScriptOptions {
     nodeArgs?: string[];
     engines?: string[];
 }
-export declare function runScript(scriptPath: string, args?: string[], opts?: RunScriptOptions): Promise<number>;
+export declare function runScript(script: string | null, args?: string[], opts?: RunScriptOptions): Promise<number>;
 //# sourceMappingURL=script-runner.d.ts.map

package/dist/script-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"script-runner.d.ts","sourceRoot":"","sources":["../src/script-runner.ts"],"names":[],"mappings":"AA2EA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,MAAM,EAAO,EACnB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA6IjB"}
+{"version":3,"file":"script-runner.d.ts","sourceRoot":"","sources":["../src/script-runner.ts"],"names":[],"mappings":"AA0CA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,IAAI,GAAE,MAAM,EAAO,EACnB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA2DjB"}

package/dist/script-runner.js

@@ -8,221 +8,170 @@ const fs_1 = require("fs");
 const path_1 = require("path");
 const os_1 = require("os");
 const child_process_1 = require("child_process");
-const fs_2 = require("fs");
-const inline_deps_js_1 = require("./inline-deps.js");
 const crypto_1 = require("crypto");
 const semver_1 = __importDefault(require("semver"));
-const CACHE = (0, path_1.join)((0, os_1.homedir)(), '.nhx', 'script-cache');
-// Check if a package exists in local node_modules (walking up from cwd)
-function findLocalPackage(name) {
-    let dir = process.cwd();
-    while (true) {
-        const pkgPath = (0, path_1.join)(dir, 'node_modules', name);
-        if ((0, fs_2.existsSync)(pkgPath))
-            return pkgPath;
-        const parent = (0, path_1.join)(dir, '..');
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    return null;
-}
-const LOADER_FALLBACK = `
-import { join } from 'node:path';
-import { pathToFileURL } from 'node:url';
-const modules = __MODULES__;
-export async function resolve(spec, ctx, next) {
-  try { return await next(spec, ctx); } catch (e) {
-    const isModule = e.code === 'ERR_MODULE_NOT_FOUND' && !/^[./]|^node:/.test(spec);
-    if (isModule) try { return await next(spec, { ...ctx, parentURL: pathToFileURL(join(modules, '_')).href }); } catch {}
-    throw e;
-  }
-}`;
-// Loader that forces resolution from our installed modules first (for hard deps)
-const LOADER_PRIORITY = `
+const inline_deps_js_1 = require("./inline-deps.js");
+const CACHE = (0, path_1.join)((0, os_1.homedir)(), '.nhx');
+// ESM loader - resolves from cache before local node_modules
+const ESM_LOADER = (modules) => `
 import { join } from 'node:path';
 import { pathToFileURL } from 'node:url';
-const modules = __MODULES__;
-const hardDeps = __HARD_DEPS__;
+const modules = ${JSON.stringify(modules)};
 export async function resolve(spec, ctx, next) {
-  // For hard deps, always resolve from our installed modules first
-  const pkgName = spec.startsWith('@') ? spec.split('/').slice(0, 2).join('/') : spec.split('/')[0];
-  if (hardDeps.includes(pkgName) && !/^[./]|^node:/.test(spec)) {
-    try { return await next(spec, { ...ctx, parentURL: pathToFileURL(join(modules, '_')).href }); } catch {}
-  }
-  // Otherwise, try normal resolution, then fall back to our modules
-  try { return await next(spec, ctx); } catch (e) {
-    const isModule = e.code === 'ERR_MODULE_NOT_FOUND' && !/^[./]|^node:/.test(spec);
-    if (isModule) try { return await next(spec, { ...ctx, parentURL: pathToFileURL(join(modules, '_')).href }); } catch {}
-    throw e;
-  }
+  if (/^[./#]|^node:/.test(spec)) return next(spec, ctx);
+  try { return await next(spec, { ...ctx, parentURL: pathToFileURL(join(modules, '_')).href }); }
+  catch { return next(spec, ctx); }
 }`;
-// CJS preload script that patches Module._resolveFilename for hard deps
-const CJS_PRELOAD = `
+// CJS loader - patches require to check cache first
+const CJS_LOADER = (modules) => `
 const Module = require('module');
+const path = require('path');
+const fs = require('fs');
+const modules = ${JSON.stringify(modules)};
 const orig = Module._resolveFilename;
-const modules = __MODULES__;
-const hardDeps = __HARD_DEPS__;
-Module._resolveFilename = function(req, parent, isMain, opts) {
-  const name = req.startsWith('@') ? req.split('/').slice(0, 2).join('/') : req.split('/')[0];
-  const isHard = hardDeps.includes(name) && !/^[./]|^node:/.test(req);
-  if (isHard) {
-    try { return orig.call(this, req, parent, isMain, { ...opts, paths: [modules, ...(opts?.paths || [])] }); } catch {}
+Module._resolveFilename = function(request, parent, isMain, options) {
+  if (!/^[./#]/.test(request) && !request.startsWith('node:')) {
+    const cached = path.join(modules, request);
+    try {
+      if (fs.existsSync(cached)) return orig.call(this, request, { ...parent, paths: [modules] }, isMain, options);
+    } catch {}
   }
-  return orig.call(this, req, parent, isMain, opts);
+  return orig.call(this, request, parent, isMain, options);
 };`;
-async function runScript(scriptPath, args = [], opts = {}) {
-    const isEval = scriptPath === '__eval__';
-    const deps = isEval
-        ? { dependencies: {}, devDependencies: {}, hasInlineDeps: false }
-        : await (0, inline_deps_js_1.parseInlineDependencies)(scriptPath);
-    // Track which deps are "soft" (no version, prefer local) vs "hard" (explicit version)
-    const softDeps = [];
-    const hardDeps = [];
+async function runScript(script, args = [], opts = {}) {
+    const deps = script
+        ? await (0, inline_deps_js_1.parseInlineDependencies)(script)
+        : { dependencies: {}, devDependencies: {}, hasInlineDeps: false };
     for (const dep of opts.withDeps || []) {
         const at = dep.lastIndexOf('@');
-        const hasVersion = at > 0;
-        const pkgName = hasVersion ? dep.slice(0, at) : dep;
-        const version = hasVersion ? dep.slice(at + 1) : 'latest';
-        deps.dependencies[pkgName] = version;
-        deps.hasInlineDeps = true;
-        if (hasVersion) {
-            hardDeps.push(pkgName);
-        }
-        else {
-            softDeps.push(pkgName);
+        const hasVer = at > 0;
+        const name = hasVer ? dep.slice(0, at) : dep;
+        let ver = hasVer ? dep.slice(at + 1) : '*';
+        // Resolve @latest to actual version for deterministic cache key
+        if (ver === 'latest') {
+            const resolved = await getLatestVersion(name);
+            if (resolved)
+                ver = resolved;
         }
+        deps.dependencies[name] = ver;
+        deps.hasInlineDeps = true;
     }
-    // convert --engines="node@18,other@1" to { node: "18", other: "1" }
     const engines = deps.engines ?? {};
-    opts.engines?.map((e) => {
-        const [name, ver] = e.split('@');
-        engines[name] = ver;
+    opts.engines?.forEach((e) => {
+        const [name, ver] = e.split(':');
+        if (name && ver)
+            engines[name] = ver;
     });
+    const nodeArgs = opts.nodeArgs || [];
     if (!deps.hasInlineDeps)
-        return exec(isEval ? '' : scriptPath, args, null, opts.nodeArgs || [], engines);
-    // Check which soft deps can be resolved locally
-    const localModules = [];
-    const depsToInstall = {};
-    for (const [pkgName, version] of Object.entries(deps.dependencies)) {
-        const isSoft = softDeps.includes(pkgName);
-        const localPath = isSoft ? findLocalPackage(pkgName) : null;
-        if (localPath) {
-            // Use local package - add its parent node_modules to the path
-            const nodeModulesDir = (0, path_1.join)(localPath, '..');
-            if (!localModules.includes(nodeModulesDir))
-                localModules.push(nodeModulesDir);
-        }
-        else {
-            depsToInstall[pkgName] = version;
-        }
+        return exec(script, args, null, nodeArgs, engines);
+    const targetNode = getTargetNodeMajor(engines?.node);
+    // Install deps to cache
+    const hashInput = { d: deps.dependencies, v: deps.devDependencies };
+    const json = JSON.stringify(hashInput);
+    const hash = (0, crypto_1.createHash)('sha256').update(json).digest('hex').slice(0, 12);
+    const dir = (0, path_1.join)(CACHE, (0, inline_deps_js_1.getNodeVersionKey)(targetNode), hash);
+    const modules = (0, path_1.join)(dir, 'node_modules');
+    if (!(0, fs_1.existsSync)(modules)) {
+        await fs_1.promises.mkdir(dir, { recursive: true });
+        const pkg = (0, inline_deps_js_1.createPackageJson)(deps, script ? (0, path_1.basename)(script) : 'eval');
+        await fs_1.promises.writeFile((0, path_1.join)(dir, 'package.json'), JSON.stringify(pkg, null, 2));
+        const meta = JSON.stringify(hashInput, null, 2);
+        await fs_1.promises.writeFile((0, path_1.join)(dir, '_meta.json'), meta);
+        await install(dir);
     }
-    // If all deps resolved locally, no need to install anything
-    const needsInstall = Object.keys(depsToInstall).length > 0;
-    let installedModules = null;
-    if (needsInstall) {
-        const depsKey = JSON.stringify({
-            d: depsToInstall,
-            v: deps.devDependencies,
-        });
-        const hash = (0, crypto_1.createHash)('sha256')
-            .update(depsKey)
-            .digest('hex')
-            .slice(0, 12);
-        const dir = (0, path_1.join)(CACHE, (0, inline_deps_js_1.getNodeVersionKey)(), hash);
-        const cached = await fs_1.promises.access((0, path_1.join)(dir, 'node_modules')).then(() => true, () => false);
-        if (!cached) {
-            await fs_1.promises.mkdir(dir, { recursive: true });
-            const installDeps = { ...deps, dependencies: depsToInstall };
-            const pkg = (0, inline_deps_js_1.createPackageJson)(installDeps, (0, path_1.basename)(scriptPath));
-            await fs_1.promises.writeFile((0, path_1.join)(dir, 'package.json'), JSON.stringify(pkg, null, 2));
-            await install(dir);
-        }
-        installedModules = (0, path_1.join)(dir, 'node_modules');
-    }
-    // Build NODE_PATH: installed modules first, then local modules
-    const modulePaths = [installedModules, ...localModules].filter(Boolean);
-    // If we have installed modules, use the loader
-    if (installedModules) {
-        const cacheDir = (0, path_1.join)(installedModules, '..');
-        const hasHardDeps = hardDeps.length > 0;
-        // ESM loader for import() resolution
-        const loader = (0, path_1.join)(cacheDir, '_loader.mjs');
-        const loaderCode = hasHardDeps
-            ? LOADER_PRIORITY.replace('__MODULES__', JSON.stringify(installedModules)).replace('__HARD_DEPS__', JSON.stringify(hardDeps))
-            : LOADER_FALLBACK.replace('__MODULES__', JSON.stringify(installedModules));
-        await fs_1.promises.writeFile(loader, loaderCode);
-        const loaderArgs = ['--experimental-loader', loader];
-        const constArgs = ['--no-warnings'];
-        let allArgs = [...loaderArgs, ...constArgs];
-        // For eval mode with hard deps, also use CJS preload to patch require()
-        if (isEval && hasHardDeps) {
-            const preload = (0, path_1.join)(cacheDir, '_preload.cjs');
-            const preloadCode = CJS_PRELOAD.replace('__MODULES__', JSON.stringify(installedModules)).replace('__HARD_DEPS__', JSON.stringify(hardDeps));
-            await fs_1.promises.writeFile(preload, preloadCode);
-            allArgs = ['-r', preload, ...allArgs];
-        }
-        allArgs = [...allArgs, ...(opts.nodeArgs || [])];
-        const script = isEval ? '' : scriptPath;
-        return exec(script, args, modulePaths.join(':'), allArgs, engines);
-    }
-    // Only local modules, no loader needed
-    const script = isEval ? '' : scriptPath;
-    return exec(script, args, modulePaths.join(':'), opts.nodeArgs || [], engines);
+    const esmLoader = (0, path_1.join)(dir, '_loader.mjs');
+    const cjsLoader = (0, path_1.join)(dir, '_loader.cjs');
+    await fs_1.promises.writeFile(esmLoader, ESM_LOADER(modules));
+    await fs_1.promises.writeFile(cjsLoader, CJS_LOADER(modules));
+    const loaderArgs = [
+        '--experimental-loader',
+        esmLoader,
+        '--require',
+        cjsLoader,
+        '--no-warnings',
+    ];
+    return exec(script, args, modules, [...loaderArgs, ...nodeArgs], engines);
 }
 async function install(cwd) {
     const pkg = JSON.parse(await fs_1.promises.readFile((0, path_1.join)(cwd, 'package.json'), 'utf-8'));
-    const count = Object.keys(pkg.dependencies || {}).length;
-    if (!count)
+    const hasKeys = (obj) => Object.keys(obj || {}).length > 0;
+    const hasDeps = hasKeys(pkg.dependencies) || hasKeys(pkg.devDependencies);
+    if (!hasDeps)
         return;
-    return new Promise((r, j) => {
-        const args = ['install', '--prefer-offline', '--ignore-scripts'];
-        const stdio = ['inherit', 2, 2];
-        const child = (0, child_process_1.spawn)('npm', args, { cwd, stdio });
-        child.on('close', (c) => (!c ? r() : j(new Error('npm install failed'))));
-        child.on('error', j);
+    const run = (args, silent = false) => new Promise((res) => {
+        const child = (0, child_process_1.spawn)('npm', ['install', ...args, '--ignore-scripts'], {
+            cwd,
+            stdio: silent ? ['inherit', 'ignore', 'ignore'] : ['inherit', 2, 2],
+        });
+        child.on('close', (c) => res(c === 0));
+        child.on('error', () => res(false));
+    });
+    // Try offline first (silent - instant if cached), fall back to network
+    if (await run(['--offline'], true))
+        return;
+    if (await run(['--prefer-offline']))
+        return;
+    throw new Error('npm install failed');
+}
+// Get latest version of a package from npm registry
+async function getLatestVersion(pkg) {
+    return new Promise((res) => {
+        const child = (0, child_process_1.spawn)('npm', ['view', pkg, 'version'], {
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        let out = '';
+        child.stdout.on('data', (d) => (out += d));
+        child.on('close', (c) => res(c === 0 ? out.trim() : null));
+        child.on('error', () => res(null));
     });
 }
-// Resolve engine spec to a version to use, or null to use current Node
 function resolveNodeVersion(spec) {
     if (!spec)
         return null;
-    const currentVersion = process.version;
-    // Check if it's a simple major version like "18" or "20"
-    if (/^\d+$/.test(spec)) {
-        // If current node matches this major version, use current
-        if (semver_1.default.satisfies(currentVersion, `^${spec}`))
-            return null;
-        return spec;
-    }
-    // It's a semver range like ">=12 <15" or "^18.0.0"
+    const cur = process.version;
+    if (/^\d+$/.test(spec))
+        return semver_1.default.satisfies(cur, `^${spec}`) ? null : spec;
     const range = semver_1.default.validRange(spec);
-    if (!range) {
-        // Not a valid range, treat as literal version
+    if (!range)
         return spec;
-    }
-    // If current Node satisfies the range, use it
-    if (semver_1.default.satisfies(currentVersion, range))
+    if (semver_1.default.satisfies(cur, range))
         return null;
-    // Use minVersion to find the minimum satisfying version, then use its major
-    const minVer = semver_1.default.minVersion(range);
-    if (minVer)
-        return semver_1.default.major(minVer).toString();
-    // Last resort: return the spec as-is and let npx handle it
-    return spec;
+    const min = semver_1.default.minVersion(range);
+    return min ? semver_1.default.major(min).toString() : spec;
+}
+// Get target node major version for cache key
+// Returns the major version string (e.g., "18") or undefined to use current
+function getTargetNodeMajor(spec) {
+    if (!spec)
+        return undefined;
+    // Simple major version: "18" -> "18"
+    if (/^\d+$/.test(spec))
+        return spec;
+    // Semver range: ">=18" -> extract min version's major
+    const range = semver_1.default.validRange(spec);
+    if (range) {
+        const min = semver_1.default.minVersion(range);
+        if (min)
+            return semver_1.default.major(min).toString();
+    }
+    // Fallback: try to extract leading digits
+    const match = spec.match(/^(\d+)/);
+    return match ? match[1] : undefined;
 }
 async function exec(script, args, modules, nodeArgs, engines) {
-    const scriptArgs = script ? [script, ...args] : args;
-    const finalArgs = [...nodeArgs, ...scriptArgs];
+    const finalArgs = [...nodeArgs, ...(script ? [script, ...args] : args)];
     const env = { ...process.env };
     if (modules) {
-        env.NODE_PATH = env.NODE_PATH ? `${modules}:${env.NODE_PATH}` : modules;
+        env.NODE_PATH = modules + (env.NODE_PATH ? `:${env.NODE_PATH}` : '');
     }
     const ver = resolveNodeVersion(engines?.node);
+    const cmd = ver
+        ? ['npx', ['-y', `node@${ver}`, ...finalArgs]]
+        : [process.execPath, finalArgs];
     return new Promise((res, rej) => {
-        const child = ver
-            ? (0, child_process_1.spawn)('npx', [`node@${ver}`, ...finalArgs], { stdio: 'inherit', env })
-            : (0, child_process_1.spawn)(process.execPath, finalArgs, { stdio: 'inherit', env });
+        const opts = { stdio: 'inherit', env };
+        const child = (0, child_process_1.spawn)(cmd[0], cmd[1], opts);
         child.on('exit', (c) => res(c || 0));
         child.on('error', rej);
     });

package/dist/script-runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"script-runner.js","sourceRoot":"","sources":["../src/script-runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"script-runner.js","sourceRoot":"","sources":["../src/script-runner.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nhx",
-  "version": "0.0.0-alpha.0",
-  "description": "A UVx-like tool for the Node.js ecosystem - simple code execution",
+  "version": "0.0.1",
+  "description": "Node.js Hybrid eXecutor (a `uvx` inspired tool)",
   "type": "commonjs",
   "bin": "dist/cli.js",
   "files": [
@@ -11,6 +11,7 @@
     "prepublishOnly": "npm run build && npm test",
     "build": "rm -rf dist && tsc -b",
     "postbuild": "chmod +x dist/cli.js",
+    "pretest": "npm run build",
     "test": "node --import tsx --test",
     "test:watch": "npm test -- --watch"
   },
@@ -28,11 +29,9 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "json5": "^2.2.3",
-    "minimist": "^1.2.8",
     "semver": "^7.7.3"
   },
   "devDependencies": {
-    "@types/minimist": "^1.2.5",
     "@types/node": "^20.11.0",
     "@types/semver": "^7.7.1",
     "tsx": "^4.21.0",