@zntc/core 0.1.2 → 0.1.4

package/README.md

@@ -1,54 +1,61 @@
 # @zntc/core
 
-ZNTC (Zig Native Transpiler & Compiler) 의 코어 — Zig 로 작성된 JS/TS/Flow 트랜스파일러 + 번들러의 Node.js NAPI 바인딩 + JS API + CLI.
+English · **[한국어](./README_KO.md)**
 
-SWC / oxc 와 동급 성능을 목표로, in-process 호출 (NAPI) + Vite/Rollup 어댑터 / 단독 CLI 모두 제공.
+> The core of ZNTC (Zig Native Transpiler & Compiler) — a NAPI binding + JS API + `zntc` CLI for a JS / TS / Flow transpiler and bundler written in Zig.
 
-## 설치
+[![npm](https://img.shields.io/npm/v/@zntc/core.svg)](https://www.npmjs.com/package/@zntc/core)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/ohah/zntc/blob/main/LICENSE)
+
+`@zntc/core` ships the native `.node` NAPI binding plus the `zntc` CLI for Node.js and Bun. It targets SWC / oxc-class performance and provides in-process (NAPI) calls, Vite / Rollup adapters, and a standalone CLI — covering transpile, bundle, and lightningcss-based CSS handling.
+
+## Installation
 
 ```bash
 bun add -D @zntc/core
-# 또는
+# or
 npm i -D @zntc/core
 ```
 
-플랫폼별 prebuilt binary 가 함께 install 됨 (linux/darwin/windows × x64/arm64).
+Platform-specific prebuilt binaries are installed automatically (linux / darwin / windows × x64 / arm64).
 
-### Optional (필요 시)
+### Optional (as needed)
 
 ```bash
 bun add -D browserslist core-js core-js-compat lightningcss
 ```
 
-- `browserslist` / `core-js-compat` — `runtimePolyfills` 옵션 사용 시
-- `lightningcss` — CSS minify / nesting 사용 시
+- `browserslist` / `core-js-compat` — required for the `runtimePolyfills` option
+- `lightningcss` — required for CSS minify / nesting
+
+## Usage
 
-## CLI
+### CLI
 
 ```bash
-# transpile single file
+# Transpile a single file
 bunx zntc src/index.ts --outfile out.js
 
-# bundle (multi-entry)
+# Bundle (multi-entry)
 bunx zntc --bundle src/index.ts --outfile dist/bundle.js --format=esm --target=node
 ```
 
-전체 옵션: `bunx zntc --help`
+See `bunx zntc --help` for the full list of options.
 
-App-mode (`bunx zntc dev / build / preview`) 는 `@zntc/web` 또는 `@zntc/react-native` 가 함께 install 되어야 동작 — 각 패키지 README 참조.
+App mode (`bunx zntc dev / build / preview`) requires `@zntc/web` or `@zntc/react-native` to also be installed — see each package's README.
 
-## JS API
+### JS / NAPI API
 
 ```ts
 import { init, transpile, build } from '@zntc/core';
 
 await init();
 
-// 단일 파일 transpile
+// Transpile a single file
 const r = transpile('const x: number = 1;', { filename: 'input.ts' });
 console.log(r.code); // "const x = 1;"
 
-// bundle (multi-file)
+// Bundle (multi-file)
 const out = await build({
   entryPoints: ['src/index.ts'],
   outdir: 'dist',
@@ -57,16 +64,19 @@ const out = await build({
 });
 ```
 
-자세한 옵션: [docs/CONFIG.md](https://github.com/ohah/zts/blob/main/docs/CONFIG.md) · [docs/USAGE.md](https://github.com/ohah/zts/blob/main/docs/USAGE.md)
+## Related packages
 
-## 관련 패키지
-
-- [@zntc/web](https://npmjs.com/package/@zntc/web) — dev server + HMR overlay + postcss/sass
+- [@zntc/web](https://npmjs.com/package/@zntc/web) — dev server + HMR overlay + postcss / sass
 - [@zntc/react-native](https://npmjs.com/package/@zntc/react-native) — RN preset + Metro HMR adapter
-- [@zntc/wasm](https://npmjs.com/package/@zntc/wasm) — browser-side WASM 빌드 (NAPI 대신)
-- [@zntc/init](https://npmjs.com/package/@zntc/init) — 기존 RN 프로젝트에 ZNTC 도입
-- [@zntc/vite-plugin](https://npmjs.com/package/@zntc/vite-plugin) — Vite 의 esbuild transform 을 ZNTC 로 교체
+- [@zntc/wasm](https://npmjs.com/package/@zntc/wasm) — browser-side WASM build (instead of NAPI)
+- [@zntc/init](https://npmjs.com/package/@zntc/init) — add ZNTC to an existing RN project
+- [@zntc/vite-plugin](https://npmjs.com/package/@zntc/vite-plugin) — replace Vite's esbuild transform with ZNTC
+
+## Documentation
+
+- Repository: <https://github.com/ohah/zntc>
+- Docs: <https://ohah.github.io/zntc>
 
-## 라이센스
+## License
 
-MIT.
+MIT

package/bin/cli-flags.mjs

@@ -131,8 +131,14 @@ export const FLAG_REGISTRY = [
     forms: ['equal'],
   },
   { kind: 'string', flag: '--rn-platform', target: 'rnPlatform', forms: ['equal', 'pair'] },
+  // RN 버전 타겟 — platform=react-native 함의 + RN 문서 기준 버전별 정밀 다운레벨.
+  // 예: --rn-version=0.80 / --rn-version ">=0.74" / "<=0.84" / "==0.76"
+  { kind: 'string', flag: '--rn-version', target: 'rnVersion', forms: ['equal', 'pair'] },
   // #2540 PR #7 — RN preset 의 projectRoot. 기본 cwd, 사용자 monorepo root 지정 시 사용.
   { kind: 'string', flag: '--rn-project-root', target: 'rnProjectRoot', forms: ['equal', 'pair'] },
+  // #4438 디스크 캐시 opt-in: --disk-cache(활성, 기본 node_modules/.cache/zntc) / --cache-dir <path>.
+  { kind: 'bool', flag: '--disk-cache', target: 'diskCache' },
+  { kind: 'string', flag: '--cache-dir', target: 'cacheDir', forms: ['equal', 'pair'] },
   // ─── RN CLI 호환 flag 매트릭스 (#2605 audit P0) ───
   // `react-native bundle` / Metro CLI 의 standard flag 들 — `zntc bundle --platform=react-native`
   // 가 dropin 으로 동작하기 위한 호환 layer. zntc 내부 옵션 (outfile 등) 과 별개로 받아 매핑.
@@ -188,6 +194,8 @@ export const FLAG_REGISTRY = [
   { kind: 'int', flag: '--line-limit', target: 'lineLimit', forms: ['equal'] },
   // Rollup output.experimentalMinChunkSize 류 — 작은 common 청크 자동 병합 (bytes).
   { kind: 'int', flag: '--min-chunk-size', target: 'minChunkSize', forms: ['equal'] },
+  // #4466 — 이 byte 수 이하 asset 을 data URL 로 인라인 (0 = 끔). 기본 4096.
+  { kind: 'int', flag: '--asset-inline-limit', target: 'assetInlineLimit', forms: ['equal'] },
   // RN CLI 호환 — `--max-workers N` (Metro). zntc `--jobs` 와 의미 동일이므로 alias.
   { kind: 'int', flag: '--max-workers', target: 'jobs', forms: ['equal'] },
 

package/bin/rn-dev-input.mjs

@@ -121,6 +121,11 @@ function assignRnBuildOptionOverrides(out, config, opts = {}) {
   } else if (opts.inlineDynamicImports === false || cfg.inlineDynamicImports === false) {
     out.inlineDynamicImports = false;
   }
+  // --rn-version: RN preset 경로(runRnBundle/runRnDev)에서도 버전별 정밀 매트릭스를 적용하도록
+  // override 로 forward. 없으면 preset 의 blunt fromHermesPreset 이 그대로 쓰인다.
+  if (typeof opts.rnVersion === 'string' || typeof cfg.rnVersion === 'string') {
+    out.rnVersion = opts.rnVersion ?? cfg.rnVersion;
+  }
 }
 
 /**

package/bin/zntc.mjs

@@ -258,7 +258,11 @@ function parseArgs(argv) {
     bundle: false,
     watch: false,
     watchJson: false,
-    watchDelay: 16,
+    // SCALAR_KEYS 머지 키 — config.watchDelay 가 적용되려면 default 가 `undefined`
+    // 여야 한다(머지 조건 `opts[key] === undefined`). 16ms 디바운스 default 는
+    // 소비처(setTimeout)에서 `?? 16` 으로 보정(#4223 — 이전 `16` default 라 config
+    // watchDelay 가 silent 무시되던 schema-drift 가드 발동).
+    watchDelay: undefined,
     serve: false,
     serveDir: '.',
     port: undefined,
@@ -299,6 +303,8 @@ function parseArgs(argv) {
     entryNames: undefined,
     chunkNames: undefined,
     assetNames: undefined,
+    // #4466 — undefined 여야 native default(4096)를 덮지 않는다. 명시 0 = 인라인 끔.
+    assetInlineLimit: undefined,
     cssNames: undefined,
     jsx: undefined,
     jsxDev: false,
@@ -344,6 +350,9 @@ function parseArgs(argv) {
     resolveExtensions: [],
     mainFields: [],
     rnPlatform: undefined,
+    rnVersion: undefined,
+    diskCache: false, // #4438 디스크 캐시 활성 (--disk-cache)
+    cacheDir: undefined, // #4438 디스크 캐시 경로 (--cache-dir)
     jsxInJs: false,
     outExtensionJs: undefined,
     sourceRoot: undefined,
@@ -1320,6 +1329,8 @@ function mergeConfigIntoOpts(opts, config) {
     'format',
     'platform',
     'target',
+    'rnVersion',
+    'cacheDir', // #4438 디스크 캐시 경로 (NAPI 가 disk_cache_dir 로 해석)
     'banner',
     'footer',
     'globalName',
@@ -1327,6 +1338,7 @@ function mergeConfigIntoOpts(opts, config) {
     'entryNames',
     'chunkNames',
     'assetNames',
+    'assetInlineLimit', // #4466 asset data URL 인라인 임계값 (숫자 scalar)
     'cssNames',
     'jsx',
     'jsxFactory',
@@ -1359,6 +1371,8 @@ function mergeConfigIntoOpts(opts, config) {
     'runtimePolyfills',
     'coreJs',
     'tokenizeFormat',
+    // #4223 — config.watchDelay 가 머지되도록(opts default=undefined, 소비처 `?? 16`).
+    'watchDelay',
   ];
   for (const key of SCALAR_KEYS) {
     if (opts[key] === undefined && config[key] !== undefined) {
@@ -1398,6 +1412,7 @@ function mergeConfigIntoOpts(opts, config) {
     // 머지 안 되던 실 BuildOption bool.
     'analyze',
     'devMode',
+    'diskCache', // #4438 디스크 캐시 활성 (NAPI 가 disk_cache_dir 로 해석)
   ];
   for (const key of BOOL_KEYS) {
     if ((opts[key] === false || opts[key] === undefined) && config[key] === true) {
@@ -1421,7 +1436,10 @@ function mergeConfigIntoOpts(opts, config) {
   // tristate bool: false 가 명시적 의미를 가져서 default 를 undefined 로 두는 키.
   // CLI 가 미지정(undefined)일 때만 config 값(true/false)을 채택한다 (CLI flag 우선).
   // inlineDynamicImports=false 의 single-file 보정은 applySingleFileDynamicImportDefault.
-  for (const key of ['inlineDynamicImports']) {
+  // reactRefresh(#4223): `zntc dev` 는 default on(parseArgs 가 opts.reactRefresh=true) →
+  //   그 경우 머지 skip(opts defined). build/transpile 은 opts undefined 라 config(true/
+  //   false) 채택 — 이전 머지 리스트 누락으로 silent 무시되던 schema-drift 해소.
+  for (const key of ['inlineDynamicImports', 'reactRefresh']) {
     if (opts[key] === undefined && config[key] !== undefined) {
       opts[key] = config[key];
     }
@@ -1533,6 +1551,11 @@ async function buildBundleOptions(opts, config, { filterCallerPreWarmCss = false
     format: opts.format,
     platform: opts.platform,
     target: opts.target,
+    // --rn-version: platform=react-native 함의 + RN 문서 기준 버전별 다운레벨 (NAPI 가 해석).
+    rnVersion: opts.rnVersion,
+    // #4438 디스크 캐시 opt-in: --disk-cache(활성) / --cache-dir <path>. NAPI 가 disk_cache_dir 로 해석.
+    diskCache: opts.diskCache,
+    cacheDir: opts.cacheDir,
     browserslist: opts.browserslist,
     external: opts.external,
     packagesExternal: opts.packagesExternal,
@@ -1610,6 +1633,7 @@ async function buildBundleOptions(opts, config, { filterCallerPreWarmCss = false
     entryNames: opts.entryNames,
     chunkNames: opts.chunkNames,
     assetNames: opts.assetNames,
+    assetInlineLimit: opts.assetInlineLimit,
     cssNames: opts.cssNames,
     jsx: opts.jsx,
     jsxDev: opts.jsxDev,
@@ -1772,7 +1796,7 @@ async function runWatch(opts, config) {
       }
 
       clearTimeout(debounceTimer);
-      debounceTimer = setTimeout(rebuild, opts.watchDelay);
+      debounceTimer = setTimeout(rebuild, opts.watchDelay ?? 16);
     });
     attachWatcherErrorHandler(watcher, dir, opts.logLevel);
   }
@@ -2734,7 +2758,7 @@ async function runServe(opts, config, { appDev = null } = {}) {
         }
         dirty.add(absPath);
         clearTimeout(debounceTimer);
-        debounceTimer = setTimeout(drain, opts.watchDelay);
+        debounceTimer = setTimeout(drain, opts.watchDelay ?? 16);
       });
       attachWatcherErrorHandler(watcher, dir, opts.logLevel);
     }

package/dist/core/index.d.cts

@@ -447,6 +447,23 @@ interface BuildOptionsCommon {
     entryPoints: string[];
     format?: 'esm' | 'cjs' | 'iife' | 'umd' | 'amd';
     external?: string[];
+    /**
+     * React Native version target — e.g. `'0.80'`, `'>=0.74'`, `'<=0.84'`, `'==0.76'`.
+     * Implies `platform: 'react-native'` and applies a per-version downlevel matrix
+     * derived from the RN javascript-environment docs (syntax the docs list as supported
+     * stays native; everything else is downleveled) instead of the blunt Hermes preset.
+     * `>=`/bare/`==` target that version; `<=`/`<` use the most conservative matrix.
+     * Conflicts with `platform: 'node' | 'neutral'`.
+     */
+    rnVersion?: string;
+    /**
+     * #4438 Disk cache: persist parse/semantic across builds for faster cold rebuilds.
+     * `true` enables it at the default dir `node_modules/.cache/zntc`; pass `cacheDir`
+     * for a custom path. Opt-in (off by default). Mirrors CLI `--disk-cache`.
+     */
+    diskCache?: boolean;
+    /** #4438 Disk cache directory (implies `diskCache`). Mirrors CLI `--cache-dir`. */
+    cacheDir?: string;
     minify?: boolean;
     minifyWhitespace?: boolean;
     minifyIdentifiers?: boolean;
@@ -550,6 +567,15 @@ interface BuildOptionsCommon {
     entryNames?: string;
     chunkNames?: string;
     assetNames?: string;
+    /** 이 byte 수 **이하**의 asset 은 별도 파일로 emit 하지 않고 data URL 로 인라인한다
+     * (#4466). Vite 의 `assetsInlineLimit` 상당.
+     *
+     * - 기본값: `4096` (4KB)
+     * - `0`: 인라인 끔 — 크기와 무관하게 항상 파일로 emit
+     *
+     * 인라인된 asset 은 `assetNames` 패턴을 타지 않고, CSS `url()` / import 값이
+     * `data:` URI 로 치환된다. */
+    assetInlineLimit?: number;
     /** CSS chunk path pattern. Default: `[dir]/[name]` (PR B-4b sub-2; esbuild parity).
      * Supports `[name]`, `[hash]` (content), and `[dir]` (entry-relative). */
     cssNames?: string;
@@ -1362,6 +1388,20 @@ export interface AppDevPrepareResult {
     /** Number of files emitted while preparing the dev app, when available. */
     outputCount?: number;
 }
+/**
+ * 단일 출력 파일의 디스크 경로를 결정한다(순수 함수 — 단위 테스트용 분리).
+ *
+ * outfile 모드에선 메인 번들(`bundle.js`)을 outfile 로, 그 짝 sourcemap(`bundle.js.map`)을
+ * `outfile.map` 으로 보낸다. **메인 map 에만 특정**(`=== 'bundle.js.map'`) — 과거 `endsWith('.map')`
+ * 광범위 매칭은 메인이 아닌 map(다중 청크 등)도 같은 `outfile.map` 으로 보내 덮어썼다. 그 외
+ * 파일은 outdir 가 있으면 그 아래로, 없으면 cwd 기준으로 해석.
+ *
+ * @internal
+ */
+export declare function resolveOutputPath(filePath: string, opts: {
+    outfileResolved: string | null;
+    outdir?: string;
+}): string;
 /**
  * Runs bundling asynchronously. Does not block the event loop.
  * Promise/async hooks of JS plugins are supported in this function.

package/dist/core/index.d.ts

@@ -447,6 +447,23 @@ interface BuildOptionsCommon {
     entryPoints: string[];
     format?: 'esm' | 'cjs' | 'iife' | 'umd' | 'amd';
     external?: string[];
+    /**
+     * React Native version target — e.g. `'0.80'`, `'>=0.74'`, `'<=0.84'`, `'==0.76'`.
+     * Implies `platform: 'react-native'` and applies a per-version downlevel matrix
+     * derived from the RN javascript-environment docs (syntax the docs list as supported
+     * stays native; everything else is downleveled) instead of the blunt Hermes preset.
+     * `>=`/bare/`==` target that version; `<=`/`<` use the most conservative matrix.
+     * Conflicts with `platform: 'node' | 'neutral'`.
+     */
+    rnVersion?: string;
+    /**
+     * #4438 Disk cache: persist parse/semantic across builds for faster cold rebuilds.
+     * `true` enables it at the default dir `node_modules/.cache/zntc`; pass `cacheDir`
+     * for a custom path. Opt-in (off by default). Mirrors CLI `--disk-cache`.
+     */
+    diskCache?: boolean;
+    /** #4438 Disk cache directory (implies `diskCache`). Mirrors CLI `--cache-dir`. */
+    cacheDir?: string;
     minify?: boolean;
     minifyWhitespace?: boolean;
     minifyIdentifiers?: boolean;
@@ -550,6 +567,15 @@ interface BuildOptionsCommon {
     entryNames?: string;
     chunkNames?: string;
     assetNames?: string;
+    /** 이 byte 수 **이하**의 asset 은 별도 파일로 emit 하지 않고 data URL 로 인라인한다
+     * (#4466). Vite 의 `assetsInlineLimit` 상당.
+     *
+     * - 기본값: `4096` (4KB)
+     * - `0`: 인라인 끔 — 크기와 무관하게 항상 파일로 emit
+     *
+     * 인라인된 asset 은 `assetNames` 패턴을 타지 않고, CSS `url()` / import 값이
+     * `data:` URI 로 치환된다. */
+    assetInlineLimit?: number;
     /** CSS chunk path pattern. Default: `[dir]/[name]` (PR B-4b sub-2; esbuild parity).
      * Supports `[name]`, `[hash]` (content), and `[dir]` (entry-relative). */
     cssNames?: string;
@@ -1362,6 +1388,20 @@ export interface AppDevPrepareResult {
     /** Number of files emitted while preparing the dev app, when available. */
     outputCount?: number;
 }
+/**
+ * 단일 출력 파일의 디스크 경로를 결정한다(순수 함수 — 단위 테스트용 분리).
+ *
+ * outfile 모드에선 메인 번들(`bundle.js`)을 outfile 로, 그 짝 sourcemap(`bundle.js.map`)을
+ * `outfile.map` 으로 보낸다. **메인 map 에만 특정**(`=== 'bundle.js.map'`) — 과거 `endsWith('.map')`
+ * 광범위 매칭은 메인이 아닌 map(다중 청크 등)도 같은 `outfile.map` 으로 보내 덮어썼다. 그 외
+ * 파일은 outdir 가 있으면 그 아래로, 없으면 cwd 기준으로 해석.
+ *
+ * @internal
+ */
+export declare function resolveOutputPath(filePath: string, opts: {
+    outfileResolved: string | null;
+    outdir?: string;
+}): string;
 /**
  * Runs bundling asynchronously. Does not block the event loop.
  * Promise/async hooks of JS plugins are supported in this function.

package/dist/core/src/config-loader.d.ts

@@ -132,7 +132,7 @@ export declare function readFileIfExists(absPath: string): string | null;
  * 동기 stat (`existsSync`) 사용 — CLI 시작 시 한 번만 호출되므로 비용 무시 가능.
  * parent 디렉토리 traversal 은 모노레포 워크스페이스 (#2111 / Phase 3-4) 에서 처리.
  *
- * Note: Zig CLI (`src/main.zig:293` `applyZntcConfigJson`) 은 현재 `.json` 만
+ * Note: Zig CLI (`src/cli/options.zig` `applyZntcConfigJson`) 은 현재 `.json` 만
  * 직접 처리한다. 다른 확장자는 JS CLI (`zntc.mjs`) 만 자동 탐색하므로 두 경로의
  * 동작이 의도적으로 갈린다. 통합은 #2105 (Phase 2-3 bundler 옵션 매핑) 에서.
  */

package/dist/core/src/schema-allowlists.d.ts

@@ -7,11 +7,11 @@
  *    `zntc.config.*` 에 적을 일 없으므로 typo 검출 대상 아님)
  *  - `packages/core/bin/zntc-cli-schema-sync.test.ts`: CLI flag 미노출 정당화
  *
- * Zig DTO sync (`src/transpile_options_dto_test.zig:ts_buildoptions_only_allowlist`) 는 별
+ * Zig DTO sync (`src/config_options_dto_test.zig:ts_buildoptions_only_allowlist`) 는 별
  * 언어라 별도 유지 — 새 internal 키 추가 시 양쪽 모두 갱신 필요. (TypeScript Compiler API
  * 도입 + codegen 으로 single source 화는 ROI 낮아 보류, future work.)
  *
  * 새 internal 키 추가 시 여기 1곳에만 등록 → 두 TS 테스트 모두 자동 통과. 각 테스트의 추가
  * allowlist (테스트만의 특수 케이스) 는 그대로 유지.
  */
-export declare const NAPI_INTERNAL_ONLY_KEYS: readonly ["allowOverwrite", "assetRegistry", "blockList", "collectModuleCodes", "configurableExports", "devMode", "emitDiskSourcemap", "entryErrorGuard", "experimentalCodeCache", "fallback", "globalIdentifiers", "onReady", "onRebuild", "polyfills", "reactRefresh", "rootDir", "runBeforeMain", "scopeHoist", "silentConsoleErrorPatterns", "skipInitialOutput", "strictExecutionOrder", "watchExclude", "watchFolders", "watchInclude", "workletPluginVersion", "workletTransform", "write"];
+export declare const NAPI_INTERNAL_ONLY_KEYS: readonly ["allowOverwrite", "assetRegistry", "blockList", "collectModuleCodes", "configurableExports", "devMode", "emitDiskSourcemap", "entryErrorGuard", "fallback", "globalIdentifiers", "onReady", "onRebuild", "polyfills", "reactRefresh", "rootDir", "runBeforeMain", "scopeHoist", "silentConsoleErrorPatterns", "skipInitialOutput", "strictExecutionOrder", "watchExclude", "watchFolders", "watchInclude", "workletPluginVersion", "workletTransform", "write"];

package/dist/index.cjs

@@ -15,7 +15,7 @@ function formatSupportedPlatforms() {
 }
 //#endregion
 //#region compat-engines.ts
-const FEATURES = ["arrow", "class", "template_literal", "destructuring", "for_of", "spread", "object_extensions", "default_params", "block_scoping", "generator", "new_target", "exponentiation", "async_await", "object_spread", "optional_catch_binding", "nullish_coalescing", "optional_chaining", "logical_assignment", "class_static_block", "class_private_method", "class_private_field", "top_level_await", "hashbang", "using", "regex_sticky", "regex_dotall", "regex_named_groups", "unicode_brace_escape"],SUPPORT = { arrow: { chrome: [45, 0], firefox: [22, 0], safari: [10, 0], edge: [12, 0], node: [4, 0], deno: [1, 0], ios: [10, 0] }, class: { chrome: [49, 0], firefox: [45, 0], safari: [10, 1], edge: [13, 0], node: [6, 0], deno: [1, 0], ios: [10, 3] }, template_literal: { chrome: [41, 0], firefox: [34, 0], safari: [9, 0], edge: [12, 0], node: [4, 0], deno: [1, 0], ios: [9, 0] }, destructuring: { chrome: [49, 0], firefox: [41, 0], safari: [8, 0], edge: [14, 0], node: [6, 0], deno: [1, 0], ios: [8, 0] }, for_of: { chrome: [38, 0], firefox: [13, 0], safari: [7, 0], edge: [12, 0], node: [0, 12], deno: [1, 0], ios: [7, 0], hermes: [0, 7] }, spread: { chrome: [46, 0], firefox: [27, 0], safari: [10, 0], edge: [13, 0], node: [5, 0], deno: [1, 0], ios: [10, 0], hermes: [0, 7] }, object_extensions: { chrome: [43, 0], firefox: [34, 0], safari: [9, 0], edge: [12, 0], node: [4, 0], deno: [1, 0], ios: [9, 0], hermes: [0, 7] }, default_params: { chrome: [49, 0], firefox: [15, 0], safari: [10, 0], edge: [14, 0], node: [6, 0], deno: [1, 0], ios: [10, 0] }, block_scoping: { chrome: [49, 0], firefox: [51, 0], safari: [11, 0], edge: [14, 0], node: [6, 0], deno: [1, 0], ios: [11, 0] }, generator: { chrome: [50, 0], firefox: [53, 0], safari: [10, 0], edge: [13, 0], node: [6, 0], deno: [1, 0], ios: [10, 0] }, new_target: { chrome: [46, 0], firefox: [41, 0], safari: [10, 0], edge: [14, 0], node: [5, 0], deno: [1, 0], ios: [10, 0] }, exponentiation: { chrome: [52, 0], firefox: [52, 0], safari: [10, 1], edge: [14, 0], node: [7, 0], deno: [1, 0], ios: [10, 3], hermes: [0, 7] }, async_await: { chrome: [55, 0], firefox: [52, 0], safari: [11, 0], edge: [15, 0], node: [7, 6], deno: [1, 0], ios: [11, 0] }, object_spread: { chrome: [60, 0], firefox: [55, 0], safari: [11, 1], edge: [79, 0], node: [8, 3], deno: [1, 0], ios: [11, 3], hermes: [0, 7] }, optional_catch_binding: { chrome: [66, 0], firefox: [58, 0], safari: [11, 1], edge: [79, 0], node: [10, 0], deno: [1, 0], ios: [11, 3], hermes: [0, 12] }, nullish_coalescing: { chrome: [80, 0], firefox: [72, 0], safari: [13, 1], edge: [80, 0], node: [14, 0], deno: [1, 0], ios: [13, 4], hermes: [0, 7] }, optional_chaining: { chrome: [91, 0], firefox: [74, 0], safari: [13, 1], edge: [91, 0], node: [16, 9], deno: [1, 9], ios: [13, 4], hermes: [0, 12] }, logical_assignment: { chrome: [85, 0], firefox: [79, 0], safari: [14, 0], edge: [85, 0], node: [15, 0], deno: [1, 2], ios: [14, 0], hermes: [0, 7] }, class_static_block: { chrome: [94, 0], firefox: [93, 0], safari: [16, 4], edge: [94, 0], node: [16, 11], deno: [1, 14], ios: [16, 4] }, class_private_method: { chrome: [84, 0], firefox: [90, 0], safari: [15, 0], edge: [84, 0], node: [14, 6], deno: [1, 0], ios: [15, 0] }, class_private_field: { chrome: [74, 0], firefox: [90, 0], safari: [14, 1], edge: [79, 0], node: [12, 0], deno: [1, 0], ios: [14, 5] }, hashbang: { chrome: [74, 0], firefox: [67, 0], safari: [13, 1], edge: [79, 0], node: [12, 0], deno: [1, 0], ios: [13, 4], hermes: [0, 7] }, using: {} };
+const FEATURES = ["arrow", "class", "template_literal", "destructuring", "for_of", "spread", "object_extensions", "default_params", "block_scoping", "generator", "new_target", "exponentiation", "async_await", "object_spread", "optional_catch_binding", "nullish_coalescing", "optional_chaining", "logical_assignment", "class_static_block", "class_private_method", "class_private_field", "top_level_await", "hashbang", "using", "regex_sticky", "regex_dotall", "regex_named_groups", "unicode_brace_escape", "regex_duplicate_named_groups", "regex_modifiers", "regex_lookbehind"],SUPPORT = { arrow: { chrome: [45, 0], firefox: [22, 0], safari: [10, 0], edge: [12, 0], node: [4, 0], deno: [1, 0], ios: [10, 0] }, class: { chrome: [49, 0], firefox: [45, 0], safari: [10, 1], edge: [13, 0], node: [6, 0], deno: [1, 0], ios: [10, 3] }, template_literal: { chrome: [41, 0], firefox: [34, 0], safari: [9, 0], edge: [12, 0], node: [4, 0], deno: [1, 0], ios: [9, 0] }, destructuring: { chrome: [49, 0], firefox: [41, 0], safari: [8, 0], edge: [14, 0], node: [6, 0], deno: [1, 0], ios: [8, 0] }, for_of: { chrome: [38, 0], firefox: [13, 0], safari: [7, 0], edge: [12, 0], node: [0, 12], deno: [1, 0], ios: [7, 0], hermes: [0, 7] }, spread: { chrome: [46, 0], firefox: [27, 0], safari: [10, 0], edge: [13, 0], node: [5, 0], deno: [1, 0], ios: [10, 0], hermes: [0, 7] }, object_extensions: { chrome: [43, 0], firefox: [34, 0], safari: [9, 0], edge: [12, 0], node: [4, 0], deno: [1, 0], ios: [9, 0], hermes: [0, 7] }, default_params: { chrome: [49, 0], firefox: [15, 0], safari: [10, 0], edge: [14, 0], node: [6, 0], deno: [1, 0], ios: [10, 0] }, block_scoping: { chrome: [49, 0], firefox: [51, 0], safari: [11, 0], edge: [14, 0], node: [6, 0], deno: [1, 0], ios: [11, 0] }, generator: { chrome: [50, 0], firefox: [53, 0], safari: [10, 0], edge: [13, 0], node: [6, 0], deno: [1, 0], ios: [10, 0] }, new_target: { chrome: [46, 0], firefox: [41, 0], safari: [10, 0], edge: [14, 0], node: [5, 0], deno: [1, 0], ios: [10, 0] }, exponentiation: { chrome: [52, 0], firefox: [52, 0], safari: [10, 1], edge: [14, 0], node: [7, 0], deno: [1, 0], ios: [10, 3], hermes: [0, 7] }, async_await: { chrome: [55, 0], firefox: [52, 0], safari: [11, 0], edge: [15, 0], node: [7, 6], deno: [1, 0], ios: [11, 0] }, object_spread: { chrome: [60, 0], firefox: [55, 0], safari: [11, 1], edge: [79, 0], node: [8, 3], deno: [1, 0], ios: [11, 3], hermes: [0, 7] }, optional_catch_binding: { chrome: [66, 0], firefox: [58, 0], safari: [11, 1], edge: [79, 0], node: [10, 0], deno: [1, 0], ios: [11, 3], hermes: [0, 12] }, nullish_coalescing: { chrome: [80, 0], firefox: [72, 0], safari: [13, 1], edge: [80, 0], node: [14, 0], deno: [1, 0], ios: [13, 4], hermes: [0, 7] }, optional_chaining: { chrome: [91, 0], firefox: [74, 0], safari: [13, 1], edge: [91, 0], node: [16, 9], deno: [1, 9], ios: [13, 4], hermes: [0, 12] }, logical_assignment: { chrome: [85, 0], firefox: [79, 0], safari: [14, 0], edge: [85, 0], node: [15, 0], deno: [1, 2], ios: [14, 0], hermes: [0, 7] }, class_static_block: { chrome: [94, 0], firefox: [93, 0], safari: [16, 4], edge: [94, 0], node: [16, 11], deno: [1, 14], ios: [16, 4] }, class_private_method: { chrome: [84, 0], firefox: [90, 0], safari: [15, 0], edge: [84, 0], node: [14, 6], deno: [1, 0], ios: [15, 0] }, class_private_field: { chrome: [74, 0], firefox: [90, 0], safari: [14, 1], edge: [79, 0], node: [12, 0], deno: [1, 0], ios: [14, 5] }, hashbang: { chrome: [74, 0], firefox: [67, 0], safari: [13, 1], edge: [79, 0], node: [12, 0], deno: [1, 0], ios: [13, 4], hermes: [0, 7] }, using: {}, regex_duplicate_named_groups: { chrome: [125, 0], edge: [125, 0], firefox: [129, 0], safari: [17, 4], ios: [17, 4], node: [23, 0], deno: [1, 44] }, regex_modifiers: { chrome: [125, 0], edge: [125, 0], firefox: [132, 0], safari: [26, 0], ios: [26, 0], node: [23, 0], deno: [1, 44] }, regex_lookbehind: { chrome: [62, 0], edge: [79, 0], firefox: [78, 0], safari: [16, 4], ios: [16, 4], node: [8, 10], deno: [1, 0] } };
 function verGte(a,b) {
 	if (a[0] !== b[0])return a[0] > b[0];
 	return a[1] >= b[1];
@@ -42,7 +42,7 @@ function computeUnsupportedFromEngines(engines) {
 }
 //#endregion
 //#region index.ts
-const ES_TARGET_BITS = { es5: 0x0fffffff, es2015: 0x06fff800, es2016: 0x06fff000, es2017: 0x06ffe000, es2018: 0x00ffc000, es2019: 0x00ff8000, es2020: 0x00fe0000, es2021: 0x00fc0000, es2022: 0x00c00000, es2023: 0x00800000, es2024: 0x00800000, es2025: 0x0, esnext: 0x0 };
+const ES_TARGET_BITS = { es5: 0x7fffffff, es2015: 0x76fff800, es2016: 0x76fff000, es2017: 0x76ffe000, es2018: 0x30ffc000, es2019: 0x30ff8000, es2020: 0x30fe0000, es2021: 0x30fc0000, es2022: 0x30c00000, es2023: 0x30800000, es2024: 0x30800000, es2025: 0x0, esnext: 0x0 };
 function isPlainObject(value) {
 	return value !== null && typeof value == "object" && !Array.isArray(value);
 }
@@ -343,7 +343,7 @@ async function resolveConfigValue(raw,env,absPath) {
 async function loadModuleDefault(absPath,kind,options) {
 	const allowArray = options?.allowArray === true,ext = extname(absPath).toLowerCase();
 	if (ext === ".json") {
-		const raw = readFileOrThrowNotFound(absPath);
+		const raw = readFileOrThrowNotFound(absPath, kind);
 		try {
 			return JSON.parse(raw);
 		} catch (err) {
@@ -368,7 +368,7 @@ async function loadModuleDefault(absPath,kind,options) {
 }
 async function loadTsModule(absPath,kind,allowArray) {
 	init();
-	const source = readFileOrThrowNotFound(absPath),parseFilename = absPath.endsWith(".cts") ? absPath.slice(0, -4) + ".ts" : absPath,result = transpile(source, { filename: parseFilename, format: "esm" });
+	const source = readFileOrThrowNotFound(absPath, kind),parseFilename = absPath.endsWith(".cts") ? absPath.slice(0, -4) + ".ts" : absPath,result = transpile(source, { filename: parseFilename, format: "esm" });
 	if (result.errors) {
 		throw new Error(`@zntc/core: ${kind} compile failed in ${absPath}\n${result.errors}`);
 	}
@@ -406,12 +406,12 @@ async function importAndResolveDefault(absPath,options) {
 	}
 	return value;
 }
-function readFileOrThrowNotFound(absPath) {
+function readFileOrThrowNotFound(absPath,kind) {
 	try {
 		return readFileSync$1(absPath, "utf8");
 	} catch (err) {
 		if (err.code === "ENOENT") {
-			throw new Error(`@zntc/core: config file not found: ${absPath}`);
+			throw new Error(`@zntc/core: ${kind} file not found: ${absPath}`);
 		}
 		throw err;
 	}
@@ -460,6 +460,7 @@ function mergeUserConfigs(base,mode) {
 }
 //#endregion
 //#region load-env.ts
+var join$1 = require("node:path").join;
 var pathResolve$1 = require("node:path").resolve;
 function parseDotenvLine(line) {
 	const trimmed = line.trim();
@@ -490,7 +491,7 @@ function parseDotenvFile(filePath) {
 function loadEnv(mode,envDir,prefixes=["VITE_", "ZNTC_"]) {
 	const prefixList = Array.isArray(prefixes) ? prefixes : [prefixes],dir = pathResolve$1(envDir),files = [`.env`, `.env.local`, `.env.${mode}`, `.env.${mode}.local`],merged = {};
 	for (const file of files) {
-		Object.assign(merged, parseDotenvFile(`${dir}/${file}`));
+		Object.assign(merged, parseDotenvFile(join$1(dir, file)));
 	}
 	const filtered = {};
 	for (const [key, value] of Object.entries(merged)) {
@@ -554,14 +555,14 @@ function warnUnknownKeys(config,known,options={}) {
 	}
 	return result;
 }
-const KNOWN_CONFIG_KEYS = ["entryPoints", "output", "outdir", "outfile", "outbase", "format", "platform", "target", "browserslist", "runtimePolyfills", "coreJs", "jsx", "jsxDev", "jsxFactory", "jsxFragment", "jsxImportSource", "jsxInJs", "jsxSideEffects", "minify", "minifyWhitespace", "minifyIdentifiers", "minifySyntax", "sourcemap", "sourcemapMode", "sourcemapDebugIds", "sourcesContent", "sourceRoot", "external", "alias", "define", "server", "loader", "conditions", "nodePaths", "moduleSpecifierMap", "resolveExtensions", "mainFields", "packagesExternal", "preserveSymlinks", "resolveSymlinkSiblings", "disableHierarchicalLookup", "splitting", "outputExports", "preserveModules", "preserveModulesRoot", "inlineDynamicImports", "manualChunks", "minChunkSize", "metafile", "treeShaking", "shimMissingExports", "keepNames", "drop", "dropConsole", "dropDebugger", "dropLabels", "banner", "footer", "intro", "outro", "inject", "pure", "legalComments", "entryNames", "chunkNames", "assetNames", "cssNames", "experimentalDecorators", "emitDecoratorMetadata", "useDefineForClassFields", "verbatimModuleSyntax", "tsconfigPath", "tsconfigRaw", "globalName", "globals", "publicPath", "charsetUtf8", "asciiOnly", "quotes", "compiler", "mf", "flow", "plugins", "logLevel", "logLimit", "lineLimit", "profile", "profileFormat", "profileLevel", "tokenizeFormat", "stopAfter", "ignoreAnnotations", "watchDelay", "jobs", "codegenTransform", "extends", "root", "projectRoot", "entry", "dev", "outDir", "bundler", "resolver", "transformer", "serializer", "symbolicator", "watchFolders"];
+const KNOWN_CONFIG_KEYS = ["entryPoints", "output", "outdir", "outfile", "outbase", "format", "platform", "target", "rnVersion", "diskCache", "cacheDir", "browserslist", "runtimePolyfills", "coreJs", "jsx", "jsxDev", "jsxFactory", "jsxFragment", "jsxImportSource", "jsxInJs", "jsxSideEffects", "minify", "minifyWhitespace", "minifyIdentifiers", "minifySyntax", "sourcemap", "sourcemapMode", "sourcemapDebugIds", "sourcesContent", "sourceRoot", "external", "alias", "aliasExact", "define", "server", "loader", "conditions", "nodePaths", "moduleSpecifierMap", "resolveExtensions", "mainFields", "packagesExternal", "preserveSymlinks", "resolveSymlinkSiblings", "disableHierarchicalLookup", "splitting", "outputExports", "preserveModules", "preserveModulesRoot", "inlineDynamicImports", "manualChunks", "minChunkSize", "metafile", "treeShaking", "shimMissingExports", "keepNames", "drop", "dropConsole", "dropDebugger", "dropLabels", "banner", "footer", "intro", "outro", "inject", "pure", "legalComments", "entryNames", "chunkNames", "assetNames", "assetInlineLimit", "cssNames", "experimentalDecorators", "emitDecoratorMetadata", "useDefineForClassFields", "verbatimModuleSyntax", "tsconfigPath", "tsconfigRaw", "globalName", "globals", "publicPath", "charsetUtf8", "asciiOnly", "quotes", "compiler", "mf", "flow", "plugins", "logLevel", "logLimit", "lineLimit", "profile", "profileFormat", "profileLevel", "tokenizeFormat", "stopAfter", "ignoreAnnotations", "watchDelay", "jobs", "codegenTransform", "lazyCompilation", "lazyForceParse", "preserveSafePlugins", "extends", "root", "projectRoot", "entry", "dev", "outDir", "bundler", "resolver", "transformer", "serializer", "symbolicator", "watchFolders"];
 //#endregion
 //#region workspace.ts
 var existsSync$1 = require("node:fs").existsSync;
 var readdirSync = require("node:fs").readdirSync;
 var readFileSync$2 = require("node:fs").readFileSync;
 var basename = require("node:path").basename;
-var join$1 = require("node:path").join;
+var join$2 = require("node:path").join;
 var pathResolve$2 = require("node:path").resolve;
 var CONFIG_EXT_PRIORITY_LOCAL = [".ts", ".mts", ".cts", ".mjs", ".js", ".cjs", ".json"];
 function defineWorkspace(input) {
@@ -570,7 +571,7 @@ function defineWorkspace(input) {
 var WORKSPACE_EXT_PRIORITY = CONFIG_EXT_PRIORITY_LOCAL;
 function findWorkspacePath(cwd) {
 	for (const ext of WORKSPACE_EXT_PRIORITY) {
-		const p = join$1(cwd, `zntc.workspace${ext}`);
+		const p = join$2(cwd, `zntc.workspace${ext}`);
 		if (existsSync$1(p))return p;
 	}
 	return null;
@@ -601,8 +602,9 @@ async function loadWorkspace(filePath,env) {
 }
 function identifyWorkspaceEntries(entries,rootDir) {
 	const seen = new Set(),out = [],push = (w) => {
-		if (seen.has(w.cwd))return;
-		seen.add(w.cwd);
+		const key = w.source === "inline" ? `inline:${w.name}` : w.cwd;
+		if (seen.has(key))return;
+		seen.add(key);
 		out.push(w);
 	};
 	for (const entry of entries) {
@@ -652,7 +654,7 @@ function enumerateDirs(baseDir,namePattern) {
 		if (!d.isDirectory())continue;
 		if (d.name.startsWith("."))continue;
 		if (d.name === "node_modules")continue;
-		if (matcher(d.name))out.push(join$1(baseDir, d.name));
+		if (matcher(d.name))out.push(join$2(baseDir, d.name));
 	}
 	out.sort();
 	return out;
@@ -663,7 +665,7 @@ function makeStarMatcher(pattern) {
 	return (s) => re.test(s);
 }
 function detectPackageName(absDir) {
-	const pkgPath = join$1(absDir, "package.json");
+	const pkgPath = join$2(absDir, "package.json");
 	if (existsSync$1(pkgPath)) {
 		try {
 			const pkg = JSON.parse(readFileSync$2(pkgPath, "utf8"));
@@ -688,7 +690,7 @@ var createRequire$1 = require("module").createRequire;
 var existsSync$2 = require("fs").existsSync;
 var mkdirSync = require("fs").mkdirSync;
 var writeFileSync$1 = require("fs").writeFileSync;
-var join$2 = require("path").join;
+var join$3 = require("path").join;
 var dirname$2 = require("path").dirname;
 var resolve$1 = require("path").resolve;
 var fileURLToPath = require("url").fileURLToPath;
@@ -723,9 +725,9 @@ function getPlatformPackage() {
 	return match ? subPackageName(match) : null;
 }
 function findAddon() {
-	const __dirname = dirname$2(fileURLToPath(require("url").pathToFileURL(__filename).href)),platformPkg = getPlatformPackage(),zigOut = join$2(__dirname, "../../zig-out/lib/zntc.node");
+	const __dirname = dirname$2(fileURLToPath(require("url").pathToFileURL(__filename).href)),platformPkg = getPlatformPackage(),zigOut = join$3(__dirname, "../../zig-out/lib/zntc.node");
 	if (existsSync$2(zigOut))return zigOut;
-	const zigOut2 = join$2(__dirname, "../../../zig-out/lib/zntc.node");
+	const zigOut2 = join$3(__dirname, "../../../zig-out/lib/zntc.node");
 	if (existsSync$2(zigOut2))return zigOut2;
 	if (platformPkg) {
 		try {
@@ -734,9 +736,9 @@ function findAddon() {
 		} catch {
 		}
 	}
-	const local = join$2(__dirname, "zntc.node");
+	const local = join$3(__dirname, "zntc.node");
 	if (existsSync$2(local))return local;
-	const parent = join$2(__dirname, "../zntc.node");
+	const parent = join$3(__dirname, "../zntc.node");
 	if (existsSync$2(parent))return parent;
 	const expected = platformPkg ? ` (expected sub-package: ${platformPkg})` : "";
 	throw new Error(`@zntc/core: native binary not found for ${process.platform}-${process.arch}${expected}. ` + `Supported: ${formatSupportedPlatforms()}. ` + "For development run `zig build napi`. " + "If your platform should be supported, please open an issue.");
@@ -795,13 +797,13 @@ var TsconfigCache = class {
 	}
 };
 function transpile(source,options={}) {
-	if (!source)throw new Error("@zntc/core: empty source");
+	if (typeof source != "string")throw new Error("@zntc/core: source must be a string");
 	validateTsConfigRaw(options.tsconfigRaw);
 	const optionsJson = buildOptionsJson(options, resolveUnsupported(options));
 	return ensureNative().transpile(source, options.filename ?? "input.js", optionsJson, options.cache ? TsconfigCache._unwrap(options.cache) : undefined);
 }
 function tokenize(source,options={}) {
-	if (!source)throw new Error("@zntc/core: empty source");
+	if (typeof source != "string")throw new Error("@zntc/core: source must be a string");
 	return ensureNative().tokenize(source, options.filename ?? "input.js");
 }
 function configureProfile(profile,level) {
@@ -903,13 +905,13 @@ function collectPluginRegistry(plugins) {
 	const registry = { hooks: { resolveId: [], load: [], transform: [], renderChunk: [], resolveContext: [] }, generateBundleCallbacks: [], buildStartCallbacks: [], buildEndCallbacks: [], closeBundleCallbacks: [], astFunctionHooks: [], lifecycleFailures: [], pluginWarnings: [], contexts: new Map() };
 	for (const plugin of plugins) {
 		const build = { onResolve(opts,cb) {
-			registry.hooks.resolveId.push({ pluginName: plugin.name, filter: opts.filter, callback: cb });
+			registry.hooks.resolveId.push({ pluginName: plugin.name, filter: stripStatefulFilterFlags(opts.filter), callback: cb });
 		}, onLoad(opts,cb) {
-			registry.hooks.load.push({ pluginName: plugin.name, filter: opts.filter, callback: cb });
+			registry.hooks.load.push({ pluginName: plugin.name, filter: stripStatefulFilterFlags(opts.filter), callback: cb });
 		}, onTransform(opts,cb) {
-			registry.hooks.transform.push({ pluginName: plugin.name, filter: opts.filter, callback: cb });
+			registry.hooks.transform.push({ pluginName: plugin.name, filter: stripStatefulFilterFlags(opts.filter), callback: cb });
 		}, onRenderChunk(opts,cb) {
-			registry.hooks.renderChunk.push({ pluginName: plugin.name, filter: opts.filter, callback: cb });
+			registry.hooks.renderChunk.push({ pluginName: plugin.name, filter: stripStatefulFilterFlags(opts.filter), callback: cb });
 		}, onGenerateBundle(cb) {
 			registry.generateBundleCallbacks.push({ pluginName: plugin.name, callback: cb });
 		}, onBuildStart(cb) {
@@ -919,9 +921,9 @@ function collectPluginRegistry(plugins) {
 		}, onCloseBundle(cb) {
 			registry.closeBundleCallbacks.push({ pluginName: plugin.name, callback: cb });
 		}, onAstFunction(opts,cb) {
-			registry.astFunctionHooks.push({ pluginName: plugin.name, filter: opts.filter, callback: cb });
+			registry.astFunctionHooks.push({ pluginName: plugin.name, filter: stripStatefulFilterFlags(opts.filter), callback: cb });
 		}, onResolveContext(opts,cb) {
-			registry.hooks.resolveContext.push({ pluginName: plugin.name, filter: opts.filter, callback: cb });
+			registry.hooks.resolveContext.push({ pluginName: plugin.name, filter: stripStatefulFilterFlags(opts.filter), callback: cb });
 		} };
 		plugin.setup(build);
 	}
@@ -962,6 +964,10 @@ function getPluginContext(reg,pluginName,getModuleInfo,resolve,emitFile,getFileN
 	slot.__getFileName = getFileName;
 	return ctx;
 }
+function stripStatefulFilterFlags(re) {
+	if (!re.global && !re.sticky)return re;
+	return new RegExp(re.source, re.flags.replace(/[gy]/g, ""));
+}
 function* dispatchHook(reg,hookName,arg1,arg2,getModuleInfo,resolve,emitFile,getFileName) {
 	if (hookName === "astFunction") {
 		if (reg.astFunctionHooks.length === 0)return null;
@@ -1177,7 +1183,17 @@ function withDefaultAppBuildDefines(options) {
 	return define;
 }
 function prepareNapiOptions(options) {
-	const napiOptions = { ...options },define = withDefaultBuildDefines(options);
+	const napiOptions = { ...options };
+	if (typeof options.rnVersion == "string") {
+		const m = /^[ \t]*(?:>=|<=|==|>|<)?[ \t]*(\d+)\.(\d+)(?:\.\d+)*[ \t]*$/.exec(options.rnVersion);
+		if (!m || Number(m[1]) > 65535 || Number(m[2]) > 65535) {
+			throw new Error(`Invalid rnVersion '${options.rnVersion}' (expected e.g. '0.74', '>=0.74', '<=0.84', '==0.76')`);
+		}
+		if (options.platform === "node" || options.platform === "neutral") {
+			throw new Error(`rnVersion conflicts with platform: '${options.platform}' (rnVersion implies react-native)`);
+		}
+	}
+	const define = withDefaultBuildDefines(options);
 	if (define)napiOptions.define = define;
 	delete napiOptions.write;
 	delete napiOptions.outdir;
@@ -1283,6 +1299,13 @@ function postProcessCssOutputs(result,options) {
 		}
 	}
 }
+function resolveOutputPath(filePath,opts) {
+	const { outfileResolved:outfileResolved, outdir:outdir } = opts;
+	if (outfileResolved && filePath === "bundle.js")return outfileResolved;
+	if (outfileResolved && filePath === "bundle.js.map")return `${outfileResolved}.map`;
+	if (outdir)return join$3(resolve$1(outdir), filePath);
+	return resolve$1(filePath);
+}
 function writeOutputFiles(result,options) {
 	const shouldWrite = options.write ?? (options.outdir != null || options.outfile != null);
 	if (!shouldWrite)return;
@@ -1296,17 +1319,7 @@ function writeOutputFiles(result,options) {
 	}
 	const createdDirs = new Set(),outfileResolved = options.outfile ? resolve$1(options.outfile) : null;
 	for (const file of result.outputFiles) {
-		let outPath;
-		if (outfileResolved && file.path === "bundle.js") {
-			outPath = outfileResolved;
-		} else if (outfileResolved && file.path.endsWith(".map")) {
-			outPath = outfileResolved + ".map";
-		} else if (options.outdir) {
-			outPath = join$2(resolve$1(options.outdir), file.path);
-		} else {
-			outPath = resolve$1(file.path);
-		}
-		const dir = dirname$2(outPath);
+		const outPath = resolveOutputPath(file.path, { outfileResolved, outdir: options.outdir }),dir = dirname$2(outPath);
 		if (!createdDirs.has(dir)) {
 			mkdirSync(dir, { recursive: true });
 			createdDirs.add(dir);
@@ -1435,7 +1448,7 @@ async function buildMultiFormat(options) {
 }
 function buildAppSync(options={}) {
 	const n = ensureNative(),{ publicDir:publicDir, compiler:compiler, plugins:_plugins, ...rest } = options;
-	;
+	void _plugins;
 	const dispatcher = resolveDispatcher(options, "sync"),napiOptions = { ...rest, define: withDefaultAppBuildDefines(options), ...publicDir === false ? { disablePublicDir: true } : publicDir !== undefined ? { publicDir } : {}, ...buildCompilerNapiFields(compiler) };
 	if (dispatcher)napiOptions._pluginDispatcherSync = dispatcher;
 	const result = wrapOutputFiles(n.buildAppSync(napiOptions));
@@ -1782,6 +1795,7 @@ exports.tlsSelfCheck = tlsSelfCheck;
 exports.startDevServer = startDevServer;
 exports.stopDevServer = stopDevServer;
 exports.getDevServerPort = getDevServerPort;
+exports.resolveOutputPath = resolveOutputPath;
 exports.build = build;
 exports.buildSync = buildSync;
 exports.BuildInstance = BuildInstance;

package/dist/index.js

@@ -818,7 +818,7 @@ var require_node = __commonJS((exports, module) => {
 // index.ts
 import { createRequire as createRequire3 } from "module";
 import { existsSync as existsSync3, mkdirSync, writeFileSync as writeFileSync2 } from "fs";
-import { join as join3, dirname as dirname3, resolve as resolve2 } from "path";
+import { join as join4, dirname as dirname3, resolve as resolve2 } from "path";
 import { fileURLToPath } from "url";
 
 // src/platforms.ts
@@ -935,7 +935,10 @@ var FEATURES = [
   "regex_sticky",
   "regex_dotall",
   "regex_named_groups",
-  "unicode_brace_escape"
+  "unicode_brace_escape",
+  "regex_duplicate_named_groups",
+  "regex_modifiers",
+  "regex_lookbehind"
 ];
 var SUPPORT = {
   arrow: {
@@ -1146,7 +1149,34 @@ var SUPPORT = {
     ios: [13, 4],
     hermes: [0, 7]
   },
-  using: {}
+  using: {},
+  regex_duplicate_named_groups: {
+    chrome: [125, 0],
+    edge: [125, 0],
+    firefox: [129, 0],
+    safari: [17, 4],
+    ios: [17, 4],
+    node: [23, 0],
+    deno: [1, 44]
+  },
+  regex_modifiers: {
+    chrome: [125, 0],
+    edge: [125, 0],
+    firefox: [132, 0],
+    safari: [26, 0],
+    ios: [26, 0],
+    node: [23, 0],
+    deno: [1, 44]
+  },
+  regex_lookbehind: {
+    chrome: [62, 0],
+    edge: [79, 0],
+    firefox: [78, 0],
+    safari: [16, 4],
+    ios: [16, 4],
+    node: [8, 10],
+    deno: [1, 0]
+  }
 };
 function verGte(a, b) {
   if (a[0] !== b[0])
@@ -1177,17 +1207,17 @@ function computeUnsupportedFromEngines(engines) {
 }
 // ../shared/index.ts
 var ES_TARGET_BITS = {
-  es5: 268435455,
-  es2015: 117438464,
-  es2016: 117436416,
-  es2017: 117432320,
-  es2018: 16760832,
-  es2019: 16744448,
-  es2020: 16646144,
-  es2021: 16515072,
-  es2022: 12582912,
-  es2023: 8388608,
-  es2024: 8388608,
+  es5: 2147483647,
+  es2015: 1996486656,
+  es2016: 1996484608,
+  es2017: 1996480512,
+  es2018: 822067200,
+  es2019: 822050816,
+  es2020: 821952512,
+  es2021: 821821440,
+  es2022: 817889280,
+  es2023: 813694976,
+  es2024: 813694976,
   es2025: 0,
   esnext: 0
 };
@@ -1928,7 +1958,7 @@ async function loadModuleDefault(absPath, kind, options) {
   const allowArray = options?.allowArray === true;
   const ext = extname(absPath).toLowerCase();
   if (ext === ".json") {
-    const raw = readFileOrThrowNotFound(absPath);
+    const raw = readFileOrThrowNotFound(absPath, kind);
     try {
       return JSON.parse(raw);
     } catch (err) {
@@ -1953,7 +1983,7 @@ async function loadModuleDefault(absPath, kind, options) {
 }
 async function loadTsModule(absPath, kind, allowArray) {
   init();
-  const source = readFileOrThrowNotFound(absPath);
+  const source = readFileOrThrowNotFound(absPath, kind);
   const parseFilename = absPath.endsWith(".cts") ? absPath.slice(0, -4) + ".ts" : absPath;
   const result = transpile(source, {
     filename: parseFilename,
@@ -2000,12 +2030,12 @@ async function importAndResolveDefault(absPath, options) {
   }
   return value;
 }
-function readFileOrThrowNotFound(absPath) {
+function readFileOrThrowNotFound(absPath, kind) {
   try {
     return readFileSync2(absPath, "utf8");
   } catch (err) {
     if (err.code === "ENOENT") {
-      throw new Error(`@zntc/core: config file not found: ${absPath}`);
+      throw new Error(`@zntc/core: ${kind} file not found: ${absPath}`);
     }
     throw err;
   }
@@ -2061,7 +2091,7 @@ function mergeUserConfigs(base, mode) {
   return merged;
 }
 // src/load-env.ts
-import { resolve as pathResolve2 } from "node:path";
+import { join as join2, resolve as pathResolve2 } from "node:path";
 function parseDotenvLine(line) {
   const trimmed = line.trim();
   if (!trimmed || trimmed.startsWith("#"))
@@ -2099,7 +2129,7 @@ function loadEnv(mode, envDir, prefixes = ["VITE_", "ZNTC_"]) {
   const files = [`.env`, `.env.local`, `.env.${mode}`, `.env.${mode}.local`];
   const merged = {};
   for (const file of files) {
-    Object.assign(merged, parseDotenvFile(`${dir}/${file}`));
+    Object.assign(merged, parseDotenvFile(join2(dir, file)));
   }
   const filtered = {};
   for (const [key, value] of Object.entries(merged)) {
@@ -2190,6 +2220,9 @@ var KNOWN_CONFIG_KEYS = [
   "format",
   "platform",
   "target",
+  "rnVersion",
+  "diskCache",
+  "cacheDir",
   "browserslist",
   "runtimePolyfills",
   "coreJs",
@@ -2211,6 +2244,7 @@ var KNOWN_CONFIG_KEYS = [
   "sourceRoot",
   "external",
   "alias",
+  "aliasExact",
   "define",
   "server",
   "loader",
@@ -2248,6 +2282,7 @@ var KNOWN_CONFIG_KEYS = [
   "entryNames",
   "chunkNames",
   "assetNames",
+  "assetInlineLimit",
   "cssNames",
   "experimentalDecorators",
   "emitDecoratorMetadata",
@@ -2277,6 +2312,9 @@ var KNOWN_CONFIG_KEYS = [
   "watchDelay",
   "jobs",
   "codegenTransform",
+  "lazyCompilation",
+  "lazyForceParse",
+  "preserveSafePlugins",
   "extends",
   "root",
   "projectRoot",
@@ -2292,7 +2330,7 @@ var KNOWN_CONFIG_KEYS = [
 ];
 // src/workspace.ts
 import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync3 } from "node:fs";
-import { basename, join as join2, resolve as pathResolve3 } from "node:path";
+import { basename, join as join3, resolve as pathResolve3 } from "node:path";
 var CONFIG_EXT_PRIORITY_LOCAL = [".ts", ".mts", ".cts", ".mjs", ".js", ".cjs", ".json"];
 function defineWorkspace(input) {
   return input;
@@ -2300,7 +2338,7 @@ function defineWorkspace(input) {
 var WORKSPACE_EXT_PRIORITY = CONFIG_EXT_PRIORITY_LOCAL;
 function findWorkspacePath(cwd) {
   for (const ext of WORKSPACE_EXT_PRIORITY) {
-    const p = join2(cwd, `zntc.workspace${ext}`);
+    const p = join3(cwd, `zntc.workspace${ext}`);
     if (existsSync2(p))
       return p;
   }
@@ -2336,9 +2374,10 @@ function identifyWorkspaceEntries(entries, rootDir) {
   const seen = new Set;
   const out = [];
   const push = (w) => {
-    if (seen.has(w.cwd))
+    const key = w.source === "inline" ? `inline:${w.name}` : w.cwd;
+    if (seen.has(key))
       return;
-    seen.add(w.cwd);
+    seen.add(key);
     out.push(w);
   };
   for (const entry of entries) {
@@ -2401,7 +2440,7 @@ function enumerateDirs(baseDir, namePattern) {
     if (d.name === "node_modules")
       continue;
     if (matcher(d.name))
-      out.push(join2(baseDir, d.name));
+      out.push(join3(baseDir, d.name));
   }
   out.sort();
   return out;
@@ -2414,7 +2453,7 @@ function makeStarMatcher(pattern) {
   return (s) => re.test(s);
 }
 function detectPackageName(absDir) {
-  const pkgPath = join2(absDir, "package.json");
+  const pkgPath = join3(absDir, "package.json");
   if (existsSync2(pkgPath)) {
     try {
       const pkg = JSON.parse(readFileSync3(pkgPath, "utf8"));
@@ -2477,10 +2516,10 @@ function getPlatformPackage() {
 function findAddon() {
   const __dirname2 = dirname3(fileURLToPath(import.meta.url));
   const platformPkg = getPlatformPackage();
-  const zigOut = join3(__dirname2, "../../zig-out/lib/zntc.node");
+  const zigOut = join4(__dirname2, "../../zig-out/lib/zntc.node");
   if (existsSync3(zigOut))
     return zigOut;
-  const zigOut2 = join3(__dirname2, "../../../zig-out/lib/zntc.node");
+  const zigOut2 = join4(__dirname2, "../../../zig-out/lib/zntc.node");
   if (existsSync3(zigOut2))
     return zigOut2;
   if (platformPkg) {
@@ -2489,10 +2528,10 @@ function findAddon() {
       return nodeRequire.resolve(platformPkg);
     } catch {}
   }
-  const local = join3(__dirname2, "zntc.node");
+  const local = join4(__dirname2, "zntc.node");
   if (existsSync3(local))
     return local;
-  const parent = join3(__dirname2, "../zntc.node");
+  const parent = join4(__dirname2, "../zntc.node");
   if (existsSync3(parent))
     return parent;
   const expected = platformPkg ? ` (expected sub-package: ${platformPkg})` : "";
@@ -2557,15 +2596,15 @@ class TsconfigCache {
   }
 }
 function transpile(source, options = {}) {
-  if (!source)
-    throw new Error("@zntc/core: empty source");
+  if (typeof source !== "string")
+    throw new Error("@zntc/core: source must be a string");
   validateTsConfigRaw(options.tsconfigRaw);
   const optionsJson = buildOptionsJson(options, resolveUnsupported(options));
   return ensureNative().transpile(source, options.filename ?? "input.js", optionsJson, options.cache ? TsconfigCache._unwrap(options.cache) : undefined);
 }
 function tokenize(source, options = {}) {
-  if (!source)
-    throw new Error("@zntc/core: empty source");
+  if (typeof source !== "string")
+    throw new Error("@zntc/core: source must be a string");
   return ensureNative().tokenize(source, options.filename ?? "input.js");
 }
 function configureProfile(profile, level) {
@@ -2718,24 +2757,28 @@ function collectPluginRegistry(plugins) {
       onResolve(opts, cb) {
         registry.hooks.resolveId.push({
           pluginName: plugin.name,
-          filter: opts.filter,
+          filter: stripStatefulFilterFlags(opts.filter),
           callback: cb
         });
       },
       onLoad(opts, cb) {
-        registry.hooks.load.push({ pluginName: plugin.name, filter: opts.filter, callback: cb });
+        registry.hooks.load.push({
+          pluginName: plugin.name,
+          filter: stripStatefulFilterFlags(opts.filter),
+          callback: cb
+        });
       },
       onTransform(opts, cb) {
         registry.hooks.transform.push({
           pluginName: plugin.name,
-          filter: opts.filter,
+          filter: stripStatefulFilterFlags(opts.filter),
           callback: cb
         });
       },
       onRenderChunk(opts, cb) {
         registry.hooks.renderChunk.push({
           pluginName: plugin.name,
-          filter: opts.filter,
+          filter: stripStatefulFilterFlags(opts.filter),
           callback: cb
         });
       },
@@ -2754,14 +2797,14 @@ function collectPluginRegistry(plugins) {
       onAstFunction(opts, cb) {
         registry.astFunctionHooks.push({
           pluginName: plugin.name,
-          filter: opts.filter,
+          filter: stripStatefulFilterFlags(opts.filter),
           callback: cb
         });
       },
       onResolveContext(opts, cb) {
         registry.hooks.resolveContext.push({
           pluginName: plugin.name,
-          filter: opts.filter,
+          filter: stripStatefulFilterFlags(opts.filter),
           callback: cb
         });
       }
@@ -2816,6 +2859,11 @@ function getPluginContext(reg, pluginName, getModuleInfo, resolve3, emitFile, ge
   slot.__getFileName = getFileName;
   return ctx;
 }
+function stripStatefulFilterFlags(re) {
+  if (!re.global && !re.sticky)
+    return re;
+  return new RegExp(re.source, re.flags.replace(/[gy]/g, ""));
+}
 function* dispatchHook(reg, hookName, arg1, arg2, getModuleInfo, resolve3, emitFile, getFileName) {
   if (hookName === "astFunction") {
     if (reg.astFunctionHooks.length === 0)
@@ -3095,6 +3143,15 @@ function withDefaultAppBuildDefines(options) {
 }
 function prepareNapiOptions(options) {
   const napiOptions = { ...options };
+  if (typeof options.rnVersion === "string") {
+    const m = /^[ \t]*(?:>=|<=|==|>|<)?[ \t]*(\d+)\.(\d+)(?:\.\d+)*[ \t]*$/.exec(options.rnVersion);
+    if (!m || Number(m[1]) > 65535 || Number(m[2]) > 65535) {
+      throw new Error(`Invalid rnVersion '${options.rnVersion}' (expected e.g. '0.74', '>=0.74', '<=0.84', '==0.76')`);
+    }
+    if (options.platform === "node" || options.platform === "neutral") {
+      throw new Error(`rnVersion conflicts with platform: '${options.platform}' (rnVersion implies react-native)`);
+    }
+  }
   const define = withDefaultBuildDefines(options);
   if (define)
     napiOptions.define = define;
@@ -3236,6 +3293,16 @@ function postProcessCssOutputs(result, options) {
     } catch {}
   }
 }
+function resolveOutputPath(filePath, opts) {
+  const { outfileResolved, outdir } = opts;
+  if (outfileResolved && filePath === "bundle.js")
+    return outfileResolved;
+  if (outfileResolved && filePath === "bundle.js.map")
+    return `${outfileResolved}.map`;
+  if (outdir)
+    return join4(resolve2(outdir), filePath);
+  return resolve2(filePath);
+}
 function writeOutputFiles(result, options) {
   const shouldWrite = options.write ?? (options.outdir != null || options.outfile != null);
   if (!shouldWrite)
@@ -3251,16 +3318,7 @@ function writeOutputFiles(result, options) {
   const createdDirs = new Set;
   const outfileResolved = options.outfile ? resolve2(options.outfile) : null;
   for (const file of result.outputFiles) {
-    let outPath;
-    if (outfileResolved && file.path === "bundle.js") {
-      outPath = outfileResolved;
-    } else if (outfileResolved && file.path.endsWith(".map")) {
-      outPath = outfileResolved + ".map";
-    } else if (options.outdir) {
-      outPath = join3(resolve2(options.outdir), file.path);
-    } else {
-      outPath = resolve2(file.path);
-    }
+    const outPath = resolveOutputPath(file.path, { outfileResolved, outdir: options.outdir });
     const dir = dirname3(outPath);
     if (!createdDirs.has(dir)) {
       mkdirSync(dir, { recursive: true });
@@ -3822,6 +3880,7 @@ export {
   suggestKey,
   stopDevServer,
   startDevServer,
+  resolveOutputPath,
   profileReport,
   prepareAppDevSync,
   mergeUserConfigs,

package/dist/shared/compat-engines.d.ts

@@ -11,7 +11,7 @@
  */
 export type Engine = 'chrome' | 'firefox' | 'safari' | 'edge' | 'node' | 'deno' | 'ios' | 'opera' | 'hermes';
 /** compat.zig의 Feature enum과 동일 순서. bit 위치 = 배열 인덱스. */
-export declare const FEATURES: readonly ["arrow", "class", "template_literal", "destructuring", "for_of", "spread", "object_extensions", "default_params", "block_scoping", "generator", "new_target", "exponentiation", "async_await", "object_spread", "optional_catch_binding", "nullish_coalescing", "optional_chaining", "logical_assignment", "class_static_block", "class_private_method", "class_private_field", "top_level_await", "hashbang", "using", "regex_sticky", "regex_dotall", "regex_named_groups", "unicode_brace_escape"];
+export declare const FEATURES: readonly ["arrow", "class", "template_literal", "destructuring", "for_of", "spread", "object_extensions", "default_params", "block_scoping", "generator", "new_target", "exponentiation", "async_await", "object_spread", "optional_catch_binding", "nullish_coalescing", "optional_chaining", "logical_assignment", "class_static_block", "class_private_method", "class_private_field", "top_level_await", "hashbang", "using", "regex_sticky", "regex_dotall", "regex_named_groups", "unicode_brace_escape", "regex_duplicate_named_groups", "regex_modifiers", "regex_lookbehind"];
 export type Feature = (typeof FEATURES)[number];
 /**
  * feature × engine → 최소 지원 버전 [major, minor].

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zntc/core",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "ZNTC native transpiler & compiler binding",
   "keywords": [
     "bundler",
@@ -76,15 +76,15 @@
     "@zntc/test-helpers": "0.0.0"
   },
   "optionalDependencies": {
-    "@zntc/core-darwin-arm64": "0.1.2",
-    "@zntc/core-darwin-x64": "0.1.2",
-    "@zntc/core-linux-arm64-gnu": "0.1.2",
-    "@zntc/core-linux-arm64-musl": "0.1.2",
-    "@zntc/core-linux-x64-gnu": "0.1.2",
-    "@zntc/core-linux-x64-musl": "0.1.2",
-    "@zntc/core-win32-arm64-msvc": "0.1.2",
-    "@zntc/core-win32-ia32-msvc": "0.1.2",
-    "@zntc/core-win32-x64-msvc": "0.1.2",
+    "@zntc/core-darwin-arm64": "0.1.4",
+    "@zntc/core-darwin-x64": "0.1.4",
+    "@zntc/core-linux-arm64-gnu": "0.1.4",
+    "@zntc/core-linux-arm64-musl": "0.1.4",
+    "@zntc/core-linux-x64-gnu": "0.1.4",
+    "@zntc/core-linux-x64-musl": "0.1.4",
+    "@zntc/core-win32-arm64-msvc": "0.1.4",
+    "@zntc/core-win32-ia32-msvc": "0.1.4",
+    "@zntc/core-win32-x64-msvc": "0.1.4",
     "browserslist": "^4.24.0",
     "core-js": "^3.49.0",
     "core-js-compat": "^3.49.0",