# unrun

[![Open on npmx][npmx-version-src]][npmx-version-href]
[![Open on npmx][npmx-downloads-src]][npmx-downloads-href]
[![Open on npmx][npmx-vulnerabilities-src]][npmx-vulnerabilities-href]
[![Unit Test][unit-test-src]][unit-test-href]

unrun is a tool that enables running and loading any module at runtime (TypeScript, ESM, CJS, JSX, etc.) by bundling it with [Rolldown](https://rolldown.rs/).

Check the [documentation](https://gugustinette.github.io/unrun/) for more details.

## Install

```bash
npm i unrun
```

## Usage

### CLI

```bash
npx unrun ./path/to/file.ts
```

### Programmatic API

- Async

```ts
import { unrun } from 'unrun'

const { module } = await unrun({
  path: './path/to/file.ts', // Path to the module to load
})
```

- Sync

```ts
import { unrunSync } from 'unrun'

const { module } = unrunSync({
  path: './path/to/file.ts', // Path to the module to load
})
```

## Credits

`unrun` is highly inspired by tools like :

- [jiti](https://github.com/unjs/jiti)
- [bundle-require](https://github.com/egoist/bundle-require)
- [tsx](https://tsx.is/)

<!-- Badges -->

[npmx-version-src]: https://npmx.dev/api/registry/badge/version/unrun
[npmx-version-href]: https://npmx.dev/unrun
[npmx-downloads-src]: https://npmx.dev/api/registry/badge/downloads-month/unrun
[npmx-downloads-href]: https://npmx.dev/unrun
[npmx-vulnerabilities-src]: https://npmx.dev/api/registry/badge/vulnerabilities/unrun
[npmx-vulnerabilities-href]: https://npmx.dev/unrun
[unit-test-src]: https://github.com/gugustinette/unrun/actions/workflows/unit-test.yml/badge.svg
[unit-test-href]: https://github.com/gugustinette/unrun/actions/workflows/unit-test.yml