@zntc/rspack-loader 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,191 @@
+# @zntc/rspack-loader
+
+Rspack / Webpack 5 의 `swc-loader` / `esbuild-loader` / `babel-loader` 자리를 ZNTC (Zig 기반 트랜스파일러) 로 교체하는 loader. TypeScript / JSX / Flow / decorators 변환을 ZNTC 가 담당.
+
+## 설치
+
+```bash
+bun add -D @zntc/rspack-loader @zntc/core
+# 또는
+npm i -D @zntc/rspack-loader @zntc/core
+```
+
+`@zntc/core` 가 dependency 로 함께 따라옴 (NAPI binary 포함).
+
+## 사용 — Rspack
+
+```js
+// rspack.config.mjs
+export default {
+  module: {
+    rules: [
+      {
+        test: /\.(?:tsx?|jsx?)$/,
+        exclude: /node_modules/,
+        loader: '@zntc/rspack-loader',
+        options: {
+          transpileOptions: { target: 'es2020', jsx: 'automatic' },
+        },
+      },
+    ],
+  },
+};
+```
+
+`builtin:swc-loader` 를 쓰던 자리에 그대로 대체 가능.
+
+## 사용 — Webpack 5
+
+```js
+// webpack.config.mjs
+export default {
+  module: {
+    rules: [
+      {
+        test: /\.(?:tsx?|jsx?)$/,
+        exclude: /node_modules/,
+        use: {
+          loader: '@zntc/rspack-loader',
+          options: {
+            transpileOptions: { target: 'es2020', jsx: 'automatic' },
+          },
+        },
+      },
+    ],
+  },
+};
+```
+
+loader API 가 webpack/rspack 공통이라 동일 코드로 양쪽 동작.
+
+## 옵션
+
+```ts
+interface ZntcLoaderOptions {
+  transpileOptions?: Omit<TranspileOptions, 'filename'>;
+  tsconfigCache?: boolean;
+}
+```
+
+### `tsconfigCache` (default: `true`)
+
+tsconfig autodiscover walk 결과를 worker 별로 캐시. dev/watch 세션에서 같은 워크스페이스 안 파일은 한 번만 walk → file 당 5–10 fs syscall 절약. `transpileOptions.tsconfigPath` / `tsconfigRaw` 명시 시 자동 무시.
+
+### `transpileOptions`
+
+`@zntc/core` 의 `TranspileOptions` 와 동일 (`filename` 만 loader 가 `this.resourcePath` 로 자동 채움).
+
+#### Target / 모듈
+
+| 옵션           | 타입                                                 | 설명                                           |
+| -------------- | ---------------------------------------------------- | ---------------------------------------------- |
+| `target`       | `'es5' \| 'es2015' \| ... \| 'es2024' \| 'esnext'`   | ES 다운레벨 타겟                               |
+| `browserslist` | `string \| string[]`                                 | browserslist 쿼리 (지정 시 `target` 보다 우선) |
+| `platform`     | `'browser' \| 'node' \| 'neutral' \| 'react-native'` | 타겟 플랫폼                                    |
+| `format`       | `'esm' \| 'cjs'`                                     | 모듈 포맷                                      |
+
+#### JSX
+
+| 옵션              | 타입                                          | 설명                                            |
+| ----------------- | --------------------------------------------- | ----------------------------------------------- |
+| `jsx`             | `'classic' \| 'automatic' \| 'automatic-dev'` | JSX 런타임                                      |
+| `jsxFactory`      | `string`                                      | classic factory (default `React.createElement`) |
+| `jsxFragment`     | `string`                                      | classic Fragment (default `React.Fragment`)     |
+| `jsxImportSource` | `string`                                      | automatic import source (default `react`)       |
+| `jsxInJs`         | `boolean`                                     | `.js` 에서도 JSX 허용                           |
+
+#### TypeScript / Flow / Decorator
+
+| 옵션                      | 타입      | 설명                                                               |
+| ------------------------- | --------- | ------------------------------------------------------------------ |
+| `tsconfigPath`            | `string`  | tsconfig.json 경로 (파일 또는 디렉토리). compilerOptions 자동 머지 |
+| `tsconfigRaw`             | `string`  | inline tsconfig JSON 문자열 (esbuild 와 동일 의미)                 |
+| `verbatimModuleSyntax`    | `boolean` | TS 5.0+: 미사용 import elide 안 함                                 |
+| `useDefineForClassFields` | `boolean` | class field → constructor `this.x = v` 변환 (default: `true`)      |
+| `flow`                    | `boolean` | Flow 타입 스트리핑                                                 |
+| `experimentalDecorators`  | `boolean` | legacy decorator 변환                                              |
+| `emitDecoratorMetadata`   | `boolean` | decorator metadata emit                                            |
+
+#### 소스맵
+
+| 옵션                | 타입      | 설명                             |
+| ------------------- | --------- | -------------------------------- |
+| `sourcemap`         | `boolean` | 소스맵 생성                      |
+| `sourcemapDebugIds` | `boolean` | Sentry 호환 Debug ID             |
+| `sourcesContent`    | `boolean` | 원본 소스 포함 (default: `true`) |
+| `sourceRoot`        | `string`  | 소스맵 sourceRoot 필드           |
+
+#### Minify
+
+| 옵션                | 타입      | 설명                                   |
+| ------------------- | --------- | -------------------------------------- |
+| `minify`            | `boolean` | whitespace + identifiers + syntax 전체 |
+| `minifyWhitespace`  | `boolean` | 공백 축소만                            |
+| `minifyIdentifiers` | `boolean` | 식별자 축소만                          |
+| `minifySyntax`      | `boolean` | 구문 축소만                            |
+| `dropConsole`       | `boolean` | `console.*` 호출 제거                  |
+| `dropDebugger`      | `boolean` | `debugger` 문 제거                     |
+
+#### 기타
+
+| 옵션          | 타입                                                          | 설명                                   |
+| ------------- | ------------------------------------------------------------- | -------------------------------------- |
+| `define`      | `Array<{ key: string; value: string }>`                       | 식별자 치환 (`value` 는 raw JSON)      |
+| `quotes`      | `'double' \| 'single' \| 'preserve'`                          | 문자열 따옴표 스타일                   |
+| `asciiOnly`   | `boolean`                                                     | non-ASCII → `\uXXXX` 이스케이프        |
+| `charsetUtf8` | `boolean`                                                     | non-ASCII 이스케이프 안 함             |
+| `stopAfter`   | `'scan' \| 'parse' \| 'semantic' \| 'transform' \| 'codegen'` | 디버그/프로파일 — 해당 phase 이후 skip |
+
+전체 옵션 정의는 [`@zntc/core` TranspileOptions](https://github.com/ohah/zntc/blob/main/packages/shared/index.ts) 참고.
+
+## 예시 — `define` 으로 환경변수 치환
+
+```js
+{
+  loader: '@zntc/rspack-loader',
+  options: {
+    transpileOptions: {
+      define: [
+        { key: 'process.env.NODE_ENV', value: '"production"' },
+        { key: '__DEV__', value: 'false' },
+      ],
+    },
+  },
+}
+```
+
+## 예시 — Flow 코드
+
+```js
+{
+  test: /\.js$/,
+  loader: '@zntc/rspack-loader',
+  options: { transpileOptions: { flow: true, jsx: 'automatic' } },
+}
+```
+
+## 예시 — tsconfig 명시 + decorator
+
+```js
+{
+  loader: '@zntc/rspack-loader',
+  options: {
+    transpileOptions: {
+      tsconfigPath: './tsconfig.json',
+      experimentalDecorators: true,
+      emitDecoratorMetadata: true,
+    },
+  },
+}
+```
+
+## peer
+
+- `@rspack/core >= 1.0.0` (optional, rspack 1.x / 2.x 모두 지원)
+- `webpack >= 5.0.0` (optional)
+
+둘 중 하나만 설치돼있어도 됨.
+
+## 라이센스
+
+MIT.

package/dist/index.cjs

@@ -0,0 +1,27 @@
+"use strict";
+//#region index.ts
+var TsconfigCache = require("@zntc/core").TsconfigCache;
+var init = require("@zntc/core").init;
+var transpile = require("@zntc/core").transpile;
+let initialized = false,cache;
+function ensureInit(useCache) {
+	if (!initialized) {
+		init();
+		initialized = true;
+	}
+	if (useCache && !cache) {
+		cache = new TsconfigCache();
+	}
+}
+function zntcLoader(source) {
+	const callback = this.async(),options = (this.getOptions() ?? {}),transpileOpts = options.transpileOptions ?? {},useCache = options.tsconfigCache ?? true;
+	try {
+		ensureInit(useCache);
+		const result = transpile(source, { ...transpileOpts, filename: this.resourcePath, cache: useCache ? cache : undefined });
+		callback(null, result.code, result.map ? JSON.parse(result.map) : undefined);
+	} catch (err) {
+		callback(err instanceof Error ? err : new Error(String(err)));
+	}
+}
+module.exports = zntcLoader;
+//#endregion

package/dist/index.d.cts

@@ -0,0 +1,50 @@
+/**
+ * @zntc/rspack-loader — Rspack/Webpack loader that runs source through ZNTC
+ * (TS/JSX/Flow → JS) instead of swc-loader / esbuild-loader / babel-loader.
+ *
+ * @example
+ * ```js
+ * // rspack.config.mjs
+ * export default {
+ *   module: {
+ *     rules: [
+ *       {
+ *         test: /\.(?:tsx?|jsx?)$/,
+ *         exclude: /node_modules/,
+ *         loader: "@zntc/rspack-loader",
+ *         options: {
+ *           transpileOptions: { target: "es2020", jsx: "automatic" },
+ *         },
+ *       },
+ *     ],
+ *   },
+ * };
+ * ```
+ */
+import type { TranspileOptions } from '@zntc/core';
+/**
+ * webpack/rspack loader 의 최소 contract — 두 번들러가 공유하는 surface 만
+ * 정의해 사용자가 webpack 또는 @rspack/core 한쪽만 설치해도 타입이 깨지지
+ * 않도록 함 (esbuild-loader 와 동일 패턴).
+ */
+interface LoaderContext {
+    resourcePath: string;
+    async(): (err: Error | null, content?: string, sourceMap?: object | string) => void;
+    getOptions(): unknown;
+}
+export interface ZntcLoaderOptions {
+    /**
+     * ZNTC transpile 옵션 (target, jsx 등). `filename` 은 loader 가 자동으로
+     * `this.resourcePath` 에서 채워주므로 지정하지 않아도 됨.
+     */
+    transpileOptions?: Omit<TranspileOptions, 'filename'>;
+    /**
+     * tsconfig autodiscover walk 결과 캐시 (기본: true). Rspack/Webpack 의 watch
+     * 세션 동안 같은 워크스페이스 안 파일은 한 번만 walk → file 당 5–10 fs
+     * syscall 절약 (#2367). `transpileOptions.tsconfigPath` / `tsconfigRaw`
+     * 명시 시 캐시는 자동으로 무시됨.
+     */
+    tsconfigCache?: boolean;
+}
+export default function zntcLoader(this: LoaderContext, source: string): void;
+export {};

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @zntc/rspack-loader — Rspack/Webpack loader that runs source through ZNTC
+ * (TS/JSX/Flow → JS) instead of swc-loader / esbuild-loader / babel-loader.
+ *
+ * @example
+ * ```js
+ * // rspack.config.mjs
+ * export default {
+ *   module: {
+ *     rules: [
+ *       {
+ *         test: /\.(?:tsx?|jsx?)$/,
+ *         exclude: /node_modules/,
+ *         loader: "@zntc/rspack-loader",
+ *         options: {
+ *           transpileOptions: { target: "es2020", jsx: "automatic" },
+ *         },
+ *       },
+ *     ],
+ *   },
+ * };
+ * ```
+ */
+import type { TranspileOptions } from '@zntc/core';
+/**
+ * webpack/rspack loader 의 최소 contract — 두 번들러가 공유하는 surface 만
+ * 정의해 사용자가 webpack 또는 @rspack/core 한쪽만 설치해도 타입이 깨지지
+ * 않도록 함 (esbuild-loader 와 동일 패턴).
+ */
+interface LoaderContext {
+    resourcePath: string;
+    async(): (err: Error | null, content?: string, sourceMap?: object | string) => void;
+    getOptions(): unknown;
+}
+export interface ZntcLoaderOptions {
+    /**
+     * ZNTC transpile 옵션 (target, jsx 등). `filename` 은 loader 가 자동으로
+     * `this.resourcePath` 에서 채워주므로 지정하지 않아도 됨.
+     */
+    transpileOptions?: Omit<TranspileOptions, 'filename'>;
+    /**
+     * tsconfig autodiscover walk 결과 캐시 (기본: true). Rspack/Webpack 의 watch
+     * 세션 동안 같은 워크스페이스 안 파일은 한 번만 walk → file 당 5–10 fs
+     * syscall 절약 (#2367). `transpileOptions.tsconfigPath` / `tsconfigRaw`
+     * 명시 시 캐시는 자동으로 무시됨.
+     */
+    tsconfigCache?: boolean;
+}
+export default function zntcLoader(this: LoaderContext, source: string): void;
+export {};

package/dist/index.js

@@ -0,0 +1,24 @@
+import { TsconfigCache, init, transpile } from "@zntc/core";
+//#region index.ts
+let initialized = false,cache;
+function ensureInit(useCache) {
+	if (!initialized) {
+		init();
+		initialized = true;
+	}
+	if (useCache && !cache) {
+		cache = new TsconfigCache();
+	}
+}
+function zntcLoader(source) {
+	const callback = this.async(),options = (this.getOptions() ?? {}),transpileOpts = options.transpileOptions ?? {},useCache = options.tsconfigCache ?? true;
+	try {
+		ensureInit(useCache);
+		const result = transpile(source, { ...transpileOpts, filename: this.resourcePath, cache: useCache ? cache : undefined });
+		callback(null, result.code, result.map ? JSON.parse(result.map) : undefined);
+	} catch (err) {
+		callback(err instanceof Error ? err : new Error(String(err)));
+	}
+}
+export { zntcLoader as default };
+//#endregion

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@zntc/rspack-loader",
+  "version": "0.1.0",
+  "description": "Use ZNTC as the TypeScript/JSX/Flow transformer in Rspack and Webpack (drop-in alternative to swc-loader / esbuild-loader / babel-loader)",
+  "keywords": [
+    "babel-loader",
+    "esbuild-loader",
+    "flow",
+    "jsx",
+    "rspack",
+    "rspack-loader",
+    "swc-loader",
+    "transpiler",
+    "typescript",
+    "webpack",
+    "webpack-loader",
+    "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/rspack-loader"
+  },
+  "source": "./src/index.ts",
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "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 && node ../core/bin/zntc.mjs --bundle src/index.ts --outfile dist/index.cjs --format=cjs --target=node --conditions=source --external @zntc/core",
+    "build:dts": "bun x tsc -b && cp dist/index.d.ts dist/index.d.cts",
+    "build": "bun run build:bundle && bun run build:dts",
+    "test": "bun test",
+    "prepublishOnly": "bun run build && bunx publint --strict --level error ."
+  },
+  "dependencies": {
+    "@zntc/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@rspack/core": "^2.0.1",
+    "@types/node": "^25.5.2",
+    "webpack": "^5.94.0"
+  },
+  "peerDependencies": {
+    "@rspack/core": ">=1.0.0",
+    "webpack": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@rspack/core": {
+      "optional": true
+    },
+    "webpack": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}