Typia

TypeScript-Go (`ttsc`)

This setup targets TypeScript-Go — the Go rewrite of the TypeScript compiler that ships under @typescript/native-preview. typia@next ships a Go-rewritten transform that plugs into it through the ttsc toolchain.

You need three commands:

ttsc — build, check, and watch a TypeScript project
ttsx — execute a TypeScript file directly, with type checking
@ttsc/unplugin — connect ttsc to a bundler (Vite, Next.js, Webpack, …)

Note

@typescript/native-preview is not yet a stable TypeScript release, and typia@next is the matching experimental release of typia. For production today, use the Legacy (TS v6) setup.

The stock tsc, ts-node, and tsx cannot apply the typia transform — you must use ttsc and ttsx.

Install

npm

Terminal


npm i typia@next
npm i -D ttsc @typescript/native-preview

pnpm

Terminal


pnpm i typia@next
pnpm i -D ttsc @typescript/native-preview

yarn

Terminal


yarn add typia@next
yarn add -D ttsc @typescript/native-preview

bun

Terminal


bun add typia@next
bun add -d ttsc @typescript/native-preview

Then keep your TypeScript project strict:

tsconfig.json


{
  "compilerOptions": {
    "strict": true
  }
}

That’s it. Unlike the legacy setup, you do not add compilerOptions.plugins for typia — ttsc discovers the transform from the ttsc field in typia/package.json automatically.

Build

Use ttsc exactly the way you would use tsc:

npm

Terminal


npx ttsc            # build
npx ttsc --noEmit   # type-check only
npx ttsc --watch    # rebuild on change

pnpm

Terminal


pnpm ttsc
pnpm ttsc --noEmit
pnpm ttsc --watch

yarn

Terminal


yarn ttsc
yarn ttsc --noEmit
yarn ttsc --watch

bun

Terminal


bun ttsc
bun ttsc --noEmit
bun ttsc --watch

Execute without building

Use ttsx instead of ts-node or tsx:

npm

Terminal


npx ttsx src/index.ts

pnpm

Terminal


pnpm ttsx src/index.ts

yarn

Terminal


yarn ttsx src/index.ts

bun

Terminal


bun ttsx src/index.ts

Bundlers

Bundlers (Vite, Next.js, Webpack, …) run their own TypeScript pipeline that bypasses ttsc. To plug typia in, install @ttsc/unplugin and add its plugin to your bundler config.

Install

npm

Terminal


npm i -D @ttsc/unplugin

pnpm

Terminal


pnpm i -D @ttsc/unplugin

yarn

Terminal


yarn add -D @ttsc/unplugin

bun

Terminal


bun add -d @ttsc/unplugin

Configure

@ttsc/unplugin exposes one entry per bundler — import the matching path:

Vite

vite.config.ts


import ttsc from "@ttsc/unplugin/vite";
import { defineConfig } from "vite";
 
export default defineConfig({
  plugins: [ttsc()],
});

Next.js

next.config.mjs


import withTtsc from "@ttsc/unplugin/next";
 
/** @type {import("next").NextConfig} */
const nextConfig = {
  reactStrictMode: true,
};
 
export default withTtsc(nextConfig);

Rollup

rollup.config.ts


import ttsc from "@ttsc/unplugin/rollup";
 
export default {
  input: "src/index.ts",
  output: {
    dir: "dist",
    format: "esm",
  },
  plugins: [ttsc()],
};

Rolldown

rolldown.config.ts


import ttsc from "@ttsc/unplugin/rolldown";
import { defineConfig } from "rolldown";
 
export default defineConfig({
  input: "src/index.ts",
  output: {
    dir: "dist",
    format: "esm",
  },
  plugins: [ttsc()],
});

esbuild

esbuild.config.ts


import ttsc from "@ttsc/unplugin/esbuild";
import { build } from "esbuild";
 
await build({
  entryPoints: ["src/index.ts"],
  outdir: "dist",
  bundle: true,
  plugins: [ttsc()],
});

Webpack

webpack.config.mjs


import ttsc from "@ttsc/unplugin/webpack";
 
export default {
  entry: "./src/index.ts",
  output: {
    path: new URL("./dist", import.meta.url).pathname,
  },
  plugins: [ttsc()],
};

Rspack

rspack.config.mjs


import ttsc from "@ttsc/unplugin/rspack";
 
export default {
  entry: "./src/index.ts",
  plugins: [ttsc()],
};

Farm

farm.config.ts


import ttsc from "@ttsc/unplugin/farm";
import { defineConfig } from "@farmfe/core";
 
export default defineConfig({
  plugins: [ttsc()],
});

Bun

build.ts


import ttsc from "@ttsc/unplugin/bun";
 
await Bun.build({
  entrypoints: ["src/index.ts"],
  outdir: "dist",
  plugins: [ttsc()],
});

Drop the plugin into the same config file that already builds your app (vite.config.ts, next.config.mjs, webpack.config.mjs, …). After that, run your normal build command — no other change.

Pointing at a different `tsconfig.json`

If your bundler should use a config other than the default tsconfig.json, pass project:

Vite

vite.config.ts


import ttsc from "@ttsc/unplugin/vite";
import { defineConfig } from "vite";
 
export default defineConfig({
  plugins: [
    ttsc({
      project: "tsconfig.bundle.json",
    }),
  ],
});

Next.js

next.config.mjs


import withTtsc from "@ttsc/unplugin/next";
 
/** @type {import("next").NextConfig} */
const nextConfig = {
  reactStrictMode: true,
};
 
export default withTtsc(nextConfig, {
  project: "tsconfig.bundle.json",
});

Rollup

rollup.config.ts


import ttsc from "@ttsc/unplugin/rollup";
 
export default {
  input: "src/index.ts",
  output: {
    dir: "dist",
    format: "esm",
  },
  plugins: [
    ttsc({
      project: "tsconfig.bundle.json",
    }),
  ],
};

Rolldown

rolldown.config.ts


import ttsc from "@ttsc/unplugin/rolldown";
import { defineConfig } from "rolldown";
 
export default defineConfig({
  input: "src/index.ts",
  output: {
    dir: "dist",
    format: "esm",
  },
  plugins: [
    ttsc({
      project: "tsconfig.bundle.json",
    }),
  ],
});

esbuild

esbuild.config.ts


import ttsc from "@ttsc/unplugin/esbuild";
import { build } from "esbuild";
 
await build({
  entryPoints: ["src/index.ts"],
  outdir: "dist",
  bundle: true,
  plugins: [
    ttsc({
      project: "tsconfig.bundle.json",
    }),
  ],
});

Webpack

webpack.config.mjs


import ttsc from "@ttsc/unplugin/webpack";
 
export default {
  entry: "./src/index.ts",
  output: {
    path: new URL("./dist", import.meta.url).pathname,
  },
  plugins: [
    ttsc({
      project: "tsconfig.bundle.json",
    }),
  ],
};

Rspack

rspack.config.mjs


import ttsc from "@ttsc/unplugin/rspack";
 
export default {
  entry: "./src/index.ts",
  plugins: [
    ttsc({
      project: "tsconfig.bundle.json",
    }),
  ],
};

Farm

farm.config.ts


import ttsc from "@ttsc/unplugin/farm";
import { defineConfig } from "@farmfe/core";
 
export default defineConfig({
  plugins: [
    ttsc({
      project: "tsconfig.bundle.json",
    }),
  ],
});

Bun

build.ts


import ttsc from "@ttsc/unplugin/bun";
 
await Bun.build({
  entrypoints: ["src/index.ts"],
  outdir: "dist",
  plugins: [
    ttsc({
      project: "tsconfig.bundle.json",
    }),
  ],
});

The project path is resolved from the current working directory.

Tuning the transform

Most projects don’t need to touch this. Add compilerOptions.plugins only when you want to flip one of the optional transform flags:

tsconfig.json


{
  "compilerOptions": {
    "strict": true,
    "strictNullChecks": true,
    "plugins": [
      {
        "transform": "typia/lib/transform",
        "functional": true, // default: false
        "numeric": true,    // default: false
        "finite": true      // default: false
      }
    ]
  }
}

Flag	Default	What it does
`functional`	`false`	Validate `function`-typed properties as well as data properties
`numeric`	`false`	Reject `NaN` when a property is typed as `number`
`finite`	`false`	Reject `NaN` and `±Infinity` when a property is typed as `number`

Note

With the default flags you do not need compilerOptions.plugins. ttsc will pick up the transform from typia/package.json on its own.

Where to go next

Stable production alternative → Legacy setup
First validator after setup → is · assert · validate
Why typia needs a transform at all → Pure TypeScript

TypeScript-Go (ttsc)

Install

npm

pnpm

yarn

bun

Build

npm

pnpm

yarn

bun

Execute without building

npm

pnpm

yarn

bun

Bundlers

Install

npm

pnpm

yarn

bun

Configure

Vite

Next.js

Rollup

Rolldown

esbuild

Webpack

Rspack

Farm

Bun

Pointing at a different tsconfig.json

Vite

Next.js

Rollup

Rolldown

esbuild

Webpack

Rspack

Farm

Bun

Tuning the transform

Where to go next

TypeScript-Go (`ttsc`)

Pointing at a different `tsconfig.json`