unts

library0.0.0-prejsnpmunverified

A zero-config tool to run TypeScript files directly without a separate transpilation step. The package is currently at version 0.0.0-pre (unstable, likely pre-release). It differentiates from alternatives like ts-node or tsx by being minimal and dependency-light, with no configuration files or complex setups. Release cadence is unknown due to early stage. Use with caution in production.

devops

npm install unts

package ↗

INSTALL

IMPORT

SIG · UNTS

unts

devopsjavascriptv0.0.0-pre

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default (run)

✓ import unts from 'unts'

✗ const unts = require('unts')

Package is ESM-only; CommonJS require() will fail.

run (named export)

✓ import { run } from 'unts'

✗ const { run } = require('unts')

Named export run() is available in ESM.

type RunOptions

✓ import type { RunOptions } from 'unts'

✗ import { RunOptions } from 'unts'

RunOptions is a TypeScript type, import it as type to avoid runtime bundling.

Demonstrates using run() from unts to execute a TypeScript file with options and capture exit code.

import { run } from 'unts'; async function main() { const result = await run('script.ts', { cwd: process.cwd(), stdio: 'inherit' }); console.log('Exit code:', result.exitCode); } main().catch(console.error);

Debug

Known issues

breakingPackage is version 0.0.0-pre – no stable API; expect breaking changes in any update.

fix

Pin to exact version and test thoroughly before upgrading.

affects: all

gotchaCommonJS require() will throw ERR_REQUIRE_ESM – package is ESM-only.

fix

Use import syntax or switch to dynamic import() inside CJS.

affects: >=0.0.0

gotchaTypeScript types are not bundled; users must install @types/node separately.

fix

Run npm install --save-dev @types/node to get Node.js type definitions.

affects: >=0.0.0

Errors

Common errors & fixes

Error: Cannot find package 'unts' from ...

Package not installed or import path incorrect.

fix

Run 'npm install unts' and ensure the import statement matches the package name.

TypeError: unts.run is not a function

Using default import when named export is expected, or vice versa.

fix

Use 'import unts from "unts"' then 'unts.run()', or 'import { run } from "unts"'.

Upgrade

Version history

0.0.0-prelatest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

packagehttps://www.npmjs.com/package/unts ↗