kazuya

Runtime Typescript and ESM support for Node.js.

Why Kazuya? Why not jiti?

Kazuya is forked from jiti. It uses sucrase instaed of babel.

Sucrase is an alternative to Babel that allows super-fast development builds. It has better performance and smaller size, and supports only a subset of features to help you avoid unnecessary transforms.

Pros:

• Faster loading time
• Smaller bundle size

Cons:

• Less features (Does not support import.meta and decorators)
• No support for older node versions
• No sourcemap support
• No custom transform support

Features

• Seamless typescript and ESM syntax support
• Seamless interoperability between ESM and CommonJS
• Synchronous API to replace require
• Super slim and zero dependency
• Smart syntax detection to avoid extra transforms
• CommonJS cache integration
• Filesystem transpile hard cache
• V8 compile cache
• Custom resolve alias

Usage

Programmatic

const kazuya = require("kazuya")(__filename);

kazuya("./path/to/file.ts");

You can also pass options as second argument:

const kazuya = require("kazuya")(__filename, { debug: true });

CLI

kazuya index.ts
# or npx kazuya index.ts

Register require hook

node -r kazuya/register index.ts

Alternatively, you can register kazuya as a require hook programmatically:

const kazuya = require("kazuya")();
const unregister = kazuya.register();

Options

debug

• Type: Boolean
• Default: false
• Environment Variable: KAZUYA_DEBUG

Enable debug to see which files are transpiled.

cache

• Type: Boolean | String
• Default: true
• Environment Variable: KAZUYA_CACHE

Use transpile cache

If set to true will use node_modules/.cache/kazuya (if exists) or {TMP_DIR}/node-kazuya.

esmResolve

• Type: Boolean | String
• Default: false
• Environment Variable: KAZUYA_ESM_RESOLVE

Using esm resolution algorithm to support import condition.

interopDefault

• Type: Boolean
• Default: false

Return the .default export of a module at the top-level.

alias

• Type: Object
• Default: -
• Environment Variable: KAZUYA_ALIAS

Custom alias map used to resolve ids.

nativeModules

• Type: Array
• Default: ["typescript"]
• Environment Variable: KAZUYA_NATIVE_MODULES

List of modules (within node_modules) to always use native require for them.

transformModules

• Type: Array
• Default: []
• Environment Variable: KAZUYA_TRANSFORM_MODULES

List of modules (within node_modules) to transform them regardless of syntax.

Development

• Clone this repository
• Enable Corepack using corepack enable
• Install dependencies using pnpm install
• Run pnpm watch
• Run pnpm kazuya ./test/path/to/file.ts

About the name

Credits

Forked from jiti.

📝 License

MIT. Made with ❤️ by Ray