tsnite 0.1.4 → 0.2.0

package/README.md

@@ -1,11 +1,19 @@
-# tsnite
-
-[![npm version](https://img.shields.io/npm/v/tsnite.svg)](https://www.npmjs.com/package/tsnite)
-[![Eslint](https://img.shields.io/badge/ESLint-3A33D1?logo=eslint)](https://img.shields.io/badge/ESLint-3A33D1?logo=eslint)
-[![prettier](https://img.shields.io/badge/Prettier-de9954?logo=prettier&logoColor=ffffff)](https://img.shields.io/badge/Prettier-de9954?logo=prettier&logoColor=ffffff)
-[![github license](https://img.shields.io/github/license/luas10c/tsnite)](https://img.shields.io/github/license/luas10c/tsnite)
-
-TypeScript runner for Node.js with watch mode, `tsconfig` path alias support, and extensionless TypeScript import resolution.
+<h1 align="center">
+<br>
+<img alt="tsnite" src="https://github.com/luas10c/tsnite/blob/main/tsnite.png?raw=true">
+<br><br>
+<a href="https://npm.im/tsnite"><img src="https://badgen.net/npm/v/tsnite"></a>
+<a href="https://npm.im/tsnite"><img src="https://badgen.net/npm/dm/tsnite"></a>
+<a href="https://npm.im/tsnite"><img src="https://img.shields.io/badge/ESLint-3A33D1?logo=eslint" alt="eslint"></a>
+<a href="https://npm.im/tsnite"><img src="https://img.shields.io/badge/Prettier-21323b?logo=prettier&logoColor=ffffff" alt="prettier"></a>
+<a href="https://npm.im/tsnite"><img src="https://img.shields.io/github/license/luas10c/tsnite" alt="github license"></a>
+</h1>
+
+<p align="center">
+TypeScript at full throttle—fast, safe, unstoppable. 🚀
+<br><br>
+<a href="https://github.com/luas10c/tsnite">Documentation</a>&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;<a href="https://github.com/luas10c/tsnite">Getting started →</a>
+</p>
 
 ## Install
 
@@ -13,7 +21,15 @@ TypeScript runner for Node.js with watch mode, `tsconfig` path alias support, an
 npm install --save-dev tsnite
 ```
 
-## Usage
+## Features
+
+- ESM-friendly runtime
+- Watch mode with automatic restart
+- Supports `compilerOptions.paths`
+- Resolves extensionless TypeScript imports
+- Decorator support
+
+## Quick Start
 
 Run a TypeScript entry file:
 
@@ -44,16 +60,6 @@ Use in `package.json`:
 }
 ```
 
-## Features
-
-- Run `.ts`, `.tsx`, `.mts`, and `.cts` files directly in Node.js
-- Watch mode with automatic restart
-- Reads the current project's `tsconfig.json`
-- Resolves `compilerOptions.paths`
-- Resolves extensionless TypeScript imports
-- ESM-friendly runtime
-- Decorator support in transpilation
-
 ## Import Resolution
 
 `tsnite` resolves TypeScript files without requiring explicit extensions.
@@ -78,29 +84,6 @@ It will try these TypeScript candidates:
 
 Explicit JavaScript imports such as `.js`, `.mjs`, and `.cjs` are delegated to Node.js.
 
-## `tsconfig` Paths
-
-`tsnite` supports `compilerOptions.paths` aliases.
-
-```json
-{
-  "compilerOptions": {
-    "baseUrl": ".",
-    "paths": {
-      "#/*": ["src/*"]
-    }
-  }
-}
-```
-
-Then this works without an extension:
-
-```ts
-import { getMetadata } from '#/common/metadata'
-```
-
-If `baseUrl` is not defined, `tsnite` uses the project root by default.
-
 ## Watch Mode
 
 Customize watched paths and extensions:
@@ -123,45 +106,14 @@ Defaults:
 - ext: `ts,tsx,js,jsx,json`
 - source root: `.`
 
-## Example
-
-`tsconfig.json`
-
-```json
-{
-  "compilerOptions": {
-    "target": "es2024",
-    "module": "es2022",
-    "moduleResolution": "bundler",
-    "baseUrl": ".",
-    "paths": {
-      "#/*": ["src/*"]
-    }
-  }
-}
-```
-
-`src/index.ts`
-
-```ts
-import { startServer } from '#/server/start'
-
-await startServer()
-```
-
-Run it:
-
-```bash
-npx tsnite src/index.ts
-```
+## Support
 
-## Notes
+Enjoying this tool? Consider supporting the project.
 
-- `tsnite` is focused on development-time execution
-- the current project's `tsconfig.json` is used
-- watch mode clears cached resolution and transpilation state before restart
+<p>
+  <a href="https://buymeacoffee.com/luas10c" target="_blank" rel="noopener noreferrer"><img src="https://github.com/luas10c/tsnite/blob/main/buymeacoffe.png?raw=true" alt="Buy me a coffee" width="180" /></a>
+</p>
 
-## Links
+## License
 
-- npm: <https://www.npmjs.com/package/tsnite>
-- repository: <https://github.com/luas10c/tsnite>
+[MIT](LICENSE)

package/dist/cli.js

@@ -6,7 +6,7 @@ import { fork } from 'node:child_process';
 import { watch } from 'chokidar';
 import { name, description, version } from './metadata.js';
 import { clearResolveCache, invalidateFileCaches } from './cache.js';
-import { debounce, yellow } from './util.js';
+import { debounce, cyan, gray, red, yellow } from './util.js';
 const DEFAULT_INCLUDE_PATHS = ['.'];
 const DEFAULT_EXCLUDE_PATHS = ['dist', 'build', 'coverage'];
 const DEFAULT_WATCH_EXTENSIONS = ['ts', 'tsx', 'js', 'jsx', 'json'];
@@ -20,7 +20,7 @@ program
     .version(version, '-v, --version', 'Output the current version')
     .showSuggestionAfterError();
 function cleanup(signal) {
-    process.stdout.write(`${yellow(`Received ${signal}. Stopping watcher and child processes...`)}\n`);
+    process.stdout.write(`${yellow(`Received`)} ${cyan(signal)}${yellow('. Stopping watcher and child processes...')}\n`);
     for (const child of children.values()) {
         try {
             child.kill('SIGTERM');
@@ -37,9 +37,14 @@ process.on('SIGINT', function () {
 process.on('SIGTERM', function () {
     cleanup('SIGTERM');
 });
-function spawn(entry, nodeArgs) {
-    const child = fork(join(import.meta.dirname, '..', entry), {
+function spawn(entry, nodeArgs, shouldLogTranspile) {
+    const entryPath = isAbsolute(entry) ? entry : resolve(process.cwd(), entry);
+    const child = fork(entryPath, {
         stdio: 'inherit',
+        env: {
+            ...process.env,
+            TSNITE_LOG_TRANSPILE: shouldLogTranspile ? '1' : '0'
+        },
         execArgv: [
             '--enable-source-maps',
             '--no-experimental-strip-types',
@@ -130,10 +135,11 @@ function createWatchConfig(options) {
     };
 }
 async function handler(entry, options, nodeArgs, isWatch) {
+    const runtimeEntry = isAbsolute(entry) ? entry : resolve(process.cwd(), entry);
     async function restart(reason) {
         process.stdout.write('\x1Bc');
         if (reason) {
-            console.log(yellow(reason));
+            console.log(gray(reason));
         }
         for (const child of children.values()) {
             try {
@@ -145,7 +151,7 @@ async function handler(entry, options, nodeArgs, isWatch) {
             const exited = await waitForChildExit(child);
             if (exited)
                 continue;
-            console.log(yellow(`${reason ?? 'Restart requested.'} Process hasn't exited. Killing process...`));
+            console.log(`${yellow('restart')} ${gray('process unresponsive, sending')} ${red('SIGKILL')}`);
             try {
                 child.kill('SIGKILL');
             }
@@ -154,14 +160,14 @@ async function handler(entry, options, nodeArgs, isWatch) {
             }
         }
         clearResolveCache();
-        spawn(entry, nodeArgs);
+        spawn(runtimeEntry, nodeArgs, isWatch);
     }
     const restartDebounced = debounce(restart, WATCH_DEBOUNCE_MS);
     process.stdout.write('\x1Bc');
     if (isWatch) {
         console.log(yellow('Watching for changes...'));
     }
-    spawn(entry, nodeArgs);
+    spawn(runtimeEntry, nodeArgs, isWatch);
     if (!isWatch)
         return;
     const { ignored, paths } = createWatchConfig(options);
@@ -176,8 +182,9 @@ async function handler(entry, options, nodeArgs, isWatch) {
             eventName !== 'unlink') {
             return;
         }
-        await invalidateFileCaches(isAbsolute(changedPath) ? changedPath : (resolve(import.meta.dirname, '..', changedPath)));
-        restartDebounced(`Change detected (${eventName}): ${changedPath}`);
+        const absoluteChangedPath = isAbsolute(changedPath) ? changedPath : (resolve(process.cwd(), changedPath));
+        await invalidateFileCaches(absoluteChangedPath);
+        restartDebounced();
     });
 }
 function parseCsv(value) {

package/dist/loader.js

@@ -1,14 +1,17 @@
-import { transformFile } from '@swc/core';
+import { transform } from 'oxc-transform';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { readFile, stat, writeFile } from 'node:fs/promises';
-import { extname, join, dirname } from 'node:path';
+import { writeSync } from 'node:fs';
+import { extname, join, dirname, relative } from 'node:path';
 import { createHash } from 'node:crypto';
 import { parse } from './parse.js';
 import { ensureTranspileCacheDir, existsWithCache, getTranspileCacheFile, resolveCache } from './cache.js';
+import { gray, green, yellow } from './util.js';
 const tsconfigCache = { paths: null, baseUrl: null };
 const transpileCache = new Map();
 const MAX_TRANSPILE_CACHE_ENTRIES = 256;
 const TS_EXTENSIONS = ['.cts', '.mts', '.tsx', '.ts'];
+const SHOULD_LOG_TRANSPILE = process.env.TSNITE_LOG_TRANSPILE === '1';
 function hasTypeScriptExtension(value) {
     return TS_EXTENSIONS.some((extension) => value.endsWith(extension));
 }
@@ -221,38 +224,26 @@ export async function load(url, ctx, next) {
     if (cachedCode !== null) {
         return { format: 'module', source: cachedCode, shortCircuit: true };
     }
-    const { code } = await transformFile(filename, {
-        filename,
-        jsc: {
-            baseUrl: baseUrl || process.cwd(),
-            parser: {
-                syntax: 'typescript',
-                tsx: url.endsWith('.tsx'),
-                decorators: true
-            },
-            target: 'es2022',
-            keepClassNames: true,
-            experimental: {
-                emitAssertForImportAttributes: true
-            },
-            transform: {
-                decoratorMetadata: true,
-                legacyDecorator: true,
-                react: {
-                    runtime: 'automatic',
-                    development: true
-                }
-            },
-            paths: paths ?? {}
+    const source = await readFile(filename, 'utf8');
+    const transpileStart = Date.now();
+    const { code } = await transform(filename, source, {
+        jsx: {
+            runtime: 'automatic',
+            development: true
         },
-        module: {
-            type: 'es6',
-            strict: true,
-            outFileExtension: 'ts',
-            resolveFully: true
-        },
-        sourceMaps: 'inline'
+        sourcemap: true,
+        sourceType: 'module',
+        target: 'es2024',
+        decorator: {
+            emitDecoratorMetadata: true,
+            legacy: true
+        }
     });
+    if (SHOULD_LOG_TRANSPILE) {
+        const transpileTimeMs = Date.now() - transpileStart;
+        const displayPath = relative(process.cwd(), filename);
+        writeSync(1, `${gray('Transpiled')} ${yellow(displayPath)} ${gray('in')} ${green(`${transpileTimeMs}ms`)}\n`);
+    }
     await writeCachedTranspile(filename, {
         code,
         mtimeMs: fileStats.mtimeMs,

package/dist/util.js

@@ -9,6 +9,39 @@ export function debounce(callback, waitMs) {
 function color(code, value) {
     return `\u001B[${code}m${value}\u001B[0m`;
 }
+function style(codes, value) {
+    return `\u001B[${codes.join(';')}m${value}\u001B[0m`;
+}
 export function yellow(value) {
     return color(33, value);
 }
+export function purple(value) {
+    return color(95, value);
+}
+export function red(value) {
+    return color(31, value);
+}
+export function blue(value) {
+    return color(34, value);
+}
+export function white(value) {
+    return color(97, value);
+}
+export function pink(value) {
+    return color(95, value);
+}
+export function cyan(value) {
+    return color(96, value);
+}
+export function green(value) {
+    return color(32, value);
+}
+export function gray(value) {
+    return color(90, value);
+}
+export function bold(value) {
+    return style([1], value);
+}
+export function accent(value) {
+    return style([1, 36], value);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tsnite",
   "description": "TypeScript at full throttle—fast, safe, unstoppable. 🚀",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "keywords": [
     "cli",
     "esm",
@@ -20,7 +20,6 @@
   },
   "type": "module",
   "scripts": {
-    "prebuild": "rimraf dist",
     "build": "tsc -p tsconfig.build.json",
     "postbuild": "tsc-alias -f -p tsconfig.build.json",
     "lint": "eslint . --cache",
@@ -32,9 +31,9 @@
     "prepare": "husky"
   },
   "dependencies": {
-    "@swc/core": "^1.15.24",
     "chokidar": "^5.0.0",
-    "commander": "^14.0.3"
+    "commander": "^14.0.3",
+    "oxc-transform": "^0.127.0"
   },
   "devDependencies": {
     "@commitlint/cli": "^20.5.0",
@@ -42,7 +41,7 @@
     "@eslint/js": "^10.0.1",
     "@jest/globals": "^30.3.0",
     "@swc/jest": "^0.2.39",
-    "eslint": "^10.2.0",
+    "eslint": "^10.2.1",
     "eslint-plugin-jest": "^29.15.2",
     "eslint-plugin-prettier": "^5.5.5",
     "globals": "^17.5.0",
@@ -50,11 +49,10 @@
     "jest": "^30.3.0",
     "jest-environment-node": "^30.3.0",
     "lint-staged": "^16.4.0",
-    "prettier": "^3.8.2",
-    "rimraf": "^6.1.3",
+    "prettier": "^3.8.3",
     "tsc-alias": "^1.8.16",
-    "typescript": "^6.0.2",
-    "typescript-eslint": "^8.58.1"
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.0"
   },
   "engines": {
     "node": "^20.9.0 || ^22.11.0 || ^24.11.0"