@zntc/core 0.1.1 → 0.1.3

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

@@ -52,6 +52,9 @@ export const FLAG_REGISTRY = [
   { kind: 'bool', flag: '--watch', target: 'watch', aliases: ['-w'] },
   { kind: 'bool', flag: '--watch-json', target: 'watchJson', extra: { watch: true } },
   { kind: 'bool', flag: '--open', target: 'open' },
+  // #4062 PR-C-3 — `zntc dev --lazy`: 동적 import 타겟을 on-demand 로 컴파일(미사용 라우트
+  // 미파싱·미emit). dev 서버가 브라우저 요청 시점에 그 청크만 빌드한다. env ZNTC_LAZY=1 와 동치.
+  { kind: 'bool', flag: '--lazy', target: 'lazy' },
   // RN CLI 호환 (#2605 audit P0)
   { kind: 'bool', flag: '--reset-cache', target: 'resetCache' },
   { kind: 'bool', flag: '--sourcemap-use-absolute-path', target: 'sourcemapUseAbsolutePath' },
@@ -81,6 +84,7 @@ export const FLAG_REGISTRY = [
   { kind: 'bool', flag: '--no-tree-shaking', target: 'treeShaking', value: false },
   { kind: 'bool', flag: '--no-scope-hoist', target: 'scopeHoist', value: false },
   { kind: 'bool', flag: '--no-emit-disk-sourcemap', target: 'emitDiskSourcemap', value: false },
+  { kind: 'bool', flag: '--no-react-refresh', target: 'reactRefresh', value: false },
   { kind: 'bool', flag: '--analyze', target: 'analyze', extra: { metafile: 'meta.json' } },
   { kind: 'bool', flag: '--flow', target: 'flow' },
   { kind: 'bool', flag: '--experimental-decorators', target: 'experimentalDecorators' },
@@ -116,6 +120,7 @@ export const FLAG_REGISTRY = [
   { kind: 'string', flag: '--entry-names', target: 'entryNames', forms: ['equal'] },
   { kind: 'string', flag: '--chunk-names', target: 'chunkNames', forms: ['equal'] },
   { kind: 'string', flag: '--asset-names', target: 'assetNames', forms: ['equal'] },
+  { kind: 'string', flag: '--css-names', target: 'cssNames', forms: ['equal'] },
   { kind: 'string', flag: '--quotes', target: 'quotes', forms: ['equal'] },
   { kind: 'string', flag: '--log-level', target: 'logLevel', forms: ['equal'] },
   { kind: 'string', flag: '--legal-comments', target: 'legalComments', forms: ['equal'] },
@@ -126,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 등) 과 별개로 받아 매핑.
@@ -183,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'] },
 
@@ -266,6 +279,9 @@ export const FLAG_REGISTRY = [
   { kind: 'string-bool', flag: '--emit-disk-sourcemap', target: 'emitDiskSourcemap' },
   { kind: 'string-bool', flag: '--use-define-for-class-fields', target: 'useDefineForClassFields' },
   { kind: 'string-bool', flag: '--tokenize', target: 'tokenize' },
+  // React Fast Refresh. `zntc dev` 는 기본 on(아래 dev 블록) — `--react-refresh=false`
+  // / `--no-react-refresh` 로 opt-out. NAPI BuildOptions.reactRefresh 와 동일 target.
+  { kind: 'string-bool', flag: '--react-refresh', target: 'reactRefresh' },
 
   // ─── `zntc verify` 전용. 다른 모드와 silent 충돌 방지를 위해 prefix 강제 ───
   { kind: 'int', flag: '--verify-timeout', target: 'verifyTimeout' },

package/bin/rn-dev-input.mjs

@@ -91,6 +91,9 @@ export function buildRnBundleExtra(config, opts = {}) {
     fallback: resolver.extraNodeModules ?? undefined,
     metroResolveRequest: resolver.resolveRequest ?? undefined,
     babelTransformerPath: transformer.babelTransformerPath ?? undefined,
+    // HMR 위상 보존 게이트 명시 override (config top-level). 사용자가 "내 resolveRequest/
+    // transformer 는 결정적"임을 보장하면 true 로 보존 강제 — preset 의 보수적 자동판정을 덮어쓴다.
+    preserveSafePlugins: cfg.preserveSafePlugins ?? undefined,
     polyfills: getSerializerPolyfills(serializer, opts),
     extraVars: serializer.extraVars ?? undefined,
     prelude: serializer.prelude ?? undefined,
@@ -118,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;
+  }
 }
 
 /**
@@ -208,6 +216,9 @@ export function buildRnDevServerInput(opts, config) {
         opts.minifySyntax ||
         cfg.minify ||
         false,
+      // watch 디바운스(ms) — CLI `--watch-delay`. native NAPI watch 의 debounce_ms 로 전달
+      // (buildRnBundleOptions → watch → getObjectUint32("watchDelay")). 기본 16.
+      watchDelay: opts.watchDelay,
       extra: buildRnBundleExtra(cfg, opts),
       override: buildRnBundleOverride({ config: cfg, opts }),
     },