1// vite.config.ts
2import UnpluginTypia from '@ryoppippi/unplugin-typia/vite';
3
4export default defineConfig({
5	plugins: [
6		UnpluginTypia({ /* options */ }), // should be placed before other plugins like `react`, `svetle`, etc.
7	],
8});

When using typia with types imported from non-relative paths like tsconfig compilerOptions.paths or relative to tsconfig compilerOptions.baseUrl, they must be defined in vite.config.ts under resolve.alias in order to be resolved, according to vite's resolution mechanism.

Examples:

• examples/vite-react
• examples/vite-hono
• examples/sveltekit

1// esbuild.config.js
2import UnpluginTypia from '@ryoppippi/unplugin-typia/esbuild';
3
4export default {
5	plugins: [
6		UnpluginTypia({ /* options */ }),
7	],
8};

Examples:

• tests/rollup.spec.ts

1// next.config.mjs
2import unTypiaNext from 'unplugin-typia/next';
3
4/** @type {import('next').NextConfig} */
5const nextConfig = { /* your next.js config */};
6
7/** @type {import("unplugin-typia").Options} */
8const unpluginTypiaOptions = { /* your unplugin-typia options */ };
9
10export default unTypiaNext(nextConfig, unpluginTypiaOptions);
11
12// you can omit the unplugin-typia options when you don't need to customize it
13// export default unTypiaNext(nextConfig);

Examples:

• examples/nextjs

Example 1: Using for building script

1// build.ts
2import UnpluginTypia from '@ryoppippi/unplugin-typia/bun';
3
4await Bun.build({
5	entrypoints: ['./index.ts'],
6	outdir: './out',
7	plugins: [
8		UnpluginTypia({ /* your options */})
9	]
10});

For building the script:

1bun run ./build.ts
2node ./out/index.js

Check the Plugins – Bundler | Bun Docs for more details.

Example 2: Using for running script

1// preload.ts
2import { plugin } from 'bun';
3import UnpluginTypia from '@ryoppippi/unplugin-typia/bun';
4
5plugin(UnpluginTypia({ /* your options */}));

1# bun.toml
2preload = "preload.ts"
3
4[test]
5preload = "preload.ts"

For running the script:

1bun run ./index.ts

Check the Plugins – Runtime | Bun Docs for more details.

1// rollup.config.js
2import UnpluginTypia from '@ryoppippi/unplugin-typia/rollup';
3
4export default {
5	plugins: [
6		UnpluginTypia({ /* options */ }),
7	],
8};

Examples:

• tests/rollup.spec.ts

⚠️ Note: Currently, this plugin works only with 'esm' target.

If you want to use 'cjs' target on Node < 20.17.0 , please use with jiti. If you want to use 'cjs' target on Node >= 20.17.0, please use with require and enable --experimental-require-modules flag. If you want to use 'esm' target, don't worry! You can use this plugin without any additional setup.

1npm install jiti

1// webpack.config.js
2
3// if you use Node < 20.17.0
4const jiti = require('jiti')(__filename);
5const { default: UnpluginTypia } = jiti('@ryoppippi/unplugin-typia/webpack');
6
7// if you use Node >= 20.17.0
8// const { default: UnpluginTypia } = require("@ryoppippi/unplugin-typia/webpack");
9
10module.exports = {
11	plugins: [
12		UnpluginTypia({ /* options */ }),
13	],
14};