@zntc/vite-plugin 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ohah
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+# @zntc/vite-plugin
+
+Vite 의 esbuild transform 을 ZNTC 로 교체하는 플러그인. TypeScript / JSX / Flow / decorators 변환을 ZNTC (Zig 기반) 가 담당하면서 Vite 의 dev server / HMR / plugin 생태계는 그대로 유지.
+
+## 설치
+
+```bash
+bun add -D @zntc/vite-plugin @zntc/core
+# 또는
+npm i -D @zntc/vite-plugin @zntc/core
+```
+
+`@zntc/core` 가 dependency 로 함께 따라옴 (NAPI binary 포함).
+
+## 사용
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+import { zntc } from '@zntc/vite-plugin';
+
+export default defineConfig({
+  plugins: [zntc()],
+  // esbuild 자동 비활성화 (zntc 가 .ts/.tsx/.jsx 변환 담당)
+  esbuild: false,
+});
+```
+
+## 옵션
+
+```ts
+zntc({
+  include: /\.(tsx?|jsx)$/, // 변환할 파일 패턴 (default)
+  exclude: /node_modules/, // 제외 패턴 (default)
+  tsconfigCache: true, // tsconfig autodiscover 결과 캐시 (default: true)
+  transpileOptions: {
+    // ZNTC transpile 옵션 (target / jsx / decorators 등)
+    target: 'es2020',
+    jsx: 'automatic',
+  },
+});
+```
+
+## Framework plugin 과 함께 쓰기
+
+대부분의 framework plugin (`@vitejs/plugin-react`, `@vitejs/plugin-vue`,
+`@sveltejs/vite-plugin-svelte`, `vite-plugin-solid`) 은 ZNTC 와 충돌 없이 같이
+쓸 수 있습니다. 다만 **babel 기반으로 `.tsx` 를 자체적으로 다시 변환하는 plugin**
+— 대표적으로 `@preact/preset-vite` — 와 함께 쓰면 `.tsx` 가 둘 다 처리되면서
+결과가 깨질 수 있습니다 (component body 의 JSX return 이 비어버림).
+
+이 경우 `jsx: 'preserve'` 옵션을 사용합니다 — ZNTC 는 `.tsx`/`.jsx` 처리를
+건너뛰고 framework plugin 이 JSX + TS 까지 모두 담당합니다. `.ts` 는 그대로
+ZNTC 가 처리.
+
+```ts
+// preact + vite
+import { defineConfig } from 'vite';
+import preact from '@preact/preset-vite';
+import { zntc } from '@zntc/vite-plugin';
+
+export default defineConfig({
+  plugins: [zntc({ transpileOptions: { jsx: 'preserve' } }), preact()],
+});
+```
+
+`jsx: 'preserve'` 는 tsc `"jsx": "preserve"` 와 동등한 의미 — JSX 변환을
+downstream tool 에 위임합니다.
+
+## peer
+
+- `vite >= 5.0.0` (8.x 권장)
+
+## 라이센스
+
+MIT.

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @zntc/vite-plugin — Vite plugin that replaces Vite's esbuild transform with ZNTC.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from "vite";
+ * import { zntc } from "@zntc/vite-plugin";
+ *
+ * export default defineConfig({
+ *   plugins: [zntc()],
+ * });
+ * ```
+ */
+import type { Plugin } from 'vite';
+import type { TranspileOptions } from '@zntc/core';
+export interface ZntcPluginOptions {
+    /**
+     * File extension pattern to transform (default: /\.(tsx?|jsx)$/).
+     */
+    include?: RegExp;
+    /**
+     * File pattern to exclude (default: /node_modules/).
+     */
+    exclude?: RegExp;
+    /**
+     * ZNTC transpile options (target, jsx, etc.).
+     */
+    transpileOptions?: Omit<TranspileOptions, 'filename'>;
+    /**
+     * Enable caching of tsconfig autodiscovery results (default: true). For the
+     * lifetime of the plugin instance, files in the same workspace are walked only
+     * once → saves 5–10 fs syscalls per file (#2367).
+     * The cache is automatically bypassed when `transpileOptions.tsconfigPath` /
+     * `tsconfigRaw` is set explicitly.
+     * Set to false to disable if a very long Vite dev session raises memory concerns.
+     */
+    tsconfigCache?: boolean;
+}
+export declare function zntc(options?: ZntcPluginOptions): Plugin;
+export default zntc;

package/dist/index.js

@@ -0,0 +1,34 @@
+import { TsconfigCache, init, transpile } from "@zntc/core";
+//#region index.ts
+const DEFAULT_INCLUDE = /\.(tsx?|jsx)$/,DEFAULT_EXCLUDE = /node_modules/,JSX_EXT_PATTERN = /\.[jt]sx$/;
+function zntc(options={}) {
+	const include = options.include ?? DEFAULT_INCLUDE,exclude = options.exclude ?? DEFAULT_EXCLUDE,transpileOpts = options.transpileOptions ?? {},useTsconfigCache = options.tsconfigCache ?? true;
+	let initialized = false,cache;
+	return { name: "@zntc/vite-plugin", config(_,_env) {
+		try {
+			const viteVersion = parseInt(require("vite/package.json").version);
+			if (viteVersion < 6)return { esbuild: false };
+		} catch {
+		}
+		return {};
+	}, buildStart() {
+		if (!initialized) {
+			init();
+			initialized = true;
+		}
+		if (useTsconfigCache && !cache) {
+			cache = new TsconfigCache();
+		}
+	}, transform(code,id) {
+		if (!include.test(id))return null;
+		if (exclude.test(id))return null;
+		if (transpileOpts.jsx === "preserve" && JSX_EXT_PATTERN.test(id)) {
+			return null;
+		}
+		const result = transpile(code, { ...transpileOpts, filename: id, cache });
+		return { code: result.code, map: result.map ? JSON.parse(result.map) : null };
+	} };
+}
+
+export { zntc, zntc as default };
+//#endregion

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@zntc/vite-plugin",
+  "version": "0.1.0",
+  "description": "Use ZNTC as the TypeScript/JSX transformer in Vite (replaces esbuild)",
+  "keywords": [
+    "esbuild",
+    "jsx",
+    "swc",
+    "transpiler",
+    "typescript",
+    "vite",
+    "vite-plugin",
+    "zntc"
+  ],
+  "homepage": "https://ohah.github.io/zntc",
+  "bugs": {
+    "url": "https://github.com/ohah/zntc/issues"
+  },
+  "license": "MIT",
+  "author": "ohah",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ohah/zntc.git",
+    "directory": "packages/vite-plugin"
+  },
+  "source": "./src/index.ts",
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "source": "./src/index.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build:bundle": "node ../core/bin/zntc.mjs --bundle src/index.ts --outfile dist/index.js --format=esm --target=node --conditions=source --external @zntc/core --external vite",
+    "build:dts": "bun x tsc -b",
+    "build": "bun run build:bundle && bun run build:dts",
+    "prepublishOnly": "bun run build && bunx publint --strict --level error ."
+  },
+  "dependencies": {
+    "@zntc/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "vite": "^8.0.8"
+  },
+  "peerDependencies": {
+    "vite": ">=5.0.0"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}