@zntc/react-native 0.1.0

package/dist/metro-hmr-adapter.d.ts

@@ -0,0 +1,29 @@
+import { type BunHmrClient, type HmrChannel, type HmrRnErrorBody, type HmrRnUpdateModule } from '@zntc/server';
+/**
+ * ZNTC build error → Metro 호환 `BuildError` body 로 변환. file:line:col 추출
+ * 실패해도 단일 entry 의 description 만으로 fallback. bungae 의 formatHmrError
+ * (zntc-bundler/server/index.ts L824) 와 동일 로직 (#2605 audit).
+ */
+export declare function formatBuildError(message: string): HmrRnErrorBody;
+export interface MetroHmrAdapter {
+    /**
+     * 내부 HmrChannel — caller 가 직접 `accept(req, socket)` (Node http upgrade)
+     * 또는 `addBunClient(ws)` (Bun.serve websocket) 로 lifecycle 등록. adapter
+     * 는 send 만 wrapping 하므로 channel 자체에 직접 접근 가능.
+     */
+    readonly channel: HmrChannel;
+    /**
+     * Initial connection 직후 송출 — `update-start{isInitialUpdate:true}` →
+     * `update-done` sequence. RN runtime 의 'Refreshing...' 배너 회피용. caller
+     * 가 새 client connection 후 한 번 호출.
+     */
+    sendInitialGreeting(): void;
+    /** Module delta 송출. caller 가 revisionId 따라 modules 배열 구성. */
+    sendUpdate(modules: readonly HmrRnUpdateModule[]): void;
+    /** RN runtime 의 `__zntc_reload()` 또는 `location.reload()` 호출. */
+    sendReload(): void;
+    /** RN runtime 의 `console.error('[ZNTC HMR]', message)` 호출. */
+    sendError(message: string): void;
+}
+export declare function createMetroHmrAdapter(): MetroHmrAdapter;
+export type { BunHmrClient, HmrChannel, HmrRnUpdateModule };

package/dist/metro-resolver-types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Metro RN runtime platform 식별자. core 의 `Platform` (build target —
+ * "browser" / "node" / "neutral" / "react-native") 와 namespace 충돌 회피
+ * 위해 `Metro` prefix. `web` 은 caller 가 RN-on-web 시나리오에서 사용 가능.
+ */
+export type MetroPlatform = 'ios' | 'android' | 'web';
+/** Metro `resolveRequest` 의 반환 타입 — Metro 표준 호환. */
+export type Resolution = {
+    type: 'sourceFile';
+    filePath: string;
+} | {
+    type: 'assetFiles';
+    filePaths: readonly string[];
+} | {
+    type: 'empty';
+};
+/**
+ * Metro `resolveRequest` 의 첫 번째 인자 (context). Metro 의 ResolutionContext
+ * 를 단순화 — `originModulePath`, `platform`, default resolver fallback 만.
+ *
+ * `context.resolveRequest(context, moduleName, platform)` 호출하면 default
+ * resolver 로 위임 (Metro 동작과 동일). 무한 재귀 방지를 위해 호출 시 자기
+ * 자신은 제외됨.
+ */
+export interface ResolutionContext {
+    /** 요청한 모듈의 absolute path. */
+    originModulePath: string;
+    /** 현재 빌드 플랫폼. ios/android 또는 null (default). */
+    platform: string | null;
+    /** Default resolver — 무한 재귀 방지 시 자기 자신 제외 후 호출. */
+    resolveRequest: CustomResolver;
+}
+/**
+ * 사용자 resolveRequest 함수 시그니처 (Metro 호환).
+ * - `context.resolveRequest(context, moduleName, platform)` 로 default 위임 가능.
+ * - 결과로 Resolution 반환 또는 throw — throw 시 caller (createMetroResolveRequestPlugin)
+ *   가 sentinel `__ZNTC_RN_DELEGATE_TO_DEFAULT__` 를 잡아 default resolver fallthrough.
+ */
+export type CustomResolver = (context: ResolutionContext, moduleName: string, platform: string | null) => Resolution;

package/dist/plugins/asset.d.ts

@@ -0,0 +1,11 @@
+import type { ZntcPlugin } from '@zntc/core';
+import type { PluginConfig } from './types.ts';
+export declare function createSvgComponentModule(svg: string, filePath: string): string;
+/**
+ * RN runtime 통합 plugin:
+ * - Metro HMRClient.js path → ZNTC HMR runtime (`runtime/zntc-hmr-client.js`) 교체
+ * - `.svg` sourceExt 는 ZNTC 내장 transformer 로 직접 JS module 생성
+ * - 사용자 babelTransformerPath 는 ZNTC 내장 transformer 가 처리하지 않는 custom
+ *   sourceExt 에만 적용한다. Babel AST 반환은 처리하지 않는다.
+ */
+export declare function createAssetPlugin(config: PluginConfig): ZntcPlugin;

package/dist/plugins/babel.d.ts

@@ -0,0 +1,42 @@
+import type { ZntcPlugin } from '@zntc/core';
+import type { InlineBabelConfig, PluginConfig } from './types.ts';
+/**
+ * ZNTC native 처리 plugin patterns — Babel pass-through 시 제외 (이 list 에 매칭
+ * 되면 ZNTC 가 이미 처리). 사용자 babel.config.js 의 plugin 중 *이 list 외* 만
+ * Babel 로 forward.
+ */
+export declare const ZNTC_NATIVE_PLUGIN_PATTERNS: string[];
+/** Plugin name 이 ZNTC 가 native 처리하는 list 에 매칭되는가. substring 매칭. */
+export declare function isZntcNativePlugin(name: string): boolean;
+/**
+ * Babel plugin 이름 컨벤션을 적용 (`@babel/core` 의 `standardizeName` 와 동등).
+ *
+ *  - `'lodash'`         → `'babel-plugin-lodash'`
+ *  - `'@babel/foo'`     → `'@babel/plugin-foo'`
+ *  - `'@scope/foo'`     → `'@scope/babel-plugin-foo'`
+ *  - 절대/상대 경로, `module:` prefix, 이미 prefix 를 가진 이름은 그대로.
+ *
+ * babel CLI 는 이 prefix 를 자동 적용하지만 ZNTC 는 plugin 을 사전 절대경로로 resolve
+ * 해 babel 에 넘기므로 직접 적용해야 한다. 안 그러면 `'lodash'` 가 lodash 라이브러리
+ * 자체로 풀려 babel 이 `.__wrapped__ is not a valid Plugin property` 로 reject.
+ */
+export declare function applyBabelPluginPrefix(name: string): string;
+/**
+ * Babel pass 가 필요한지 판정. (a) babel.config.js 의 plugins 또는 (b) inline
+ * config (zntc.config.ts `transformer.babel`) 중 하나라도 ZNTC native list 외
+ * plugin/preset 이 있으면 true. 둘 다 0 → false (Babel pass skip).
+ */
+export declare function detectCustomPlugins(projectRoot: string, inline?: InlineBabelConfig): boolean;
+/**
+ * Lazy Babel transformer factory. 첫 transform 호출 시점에 require('@babel/core')
+ * + babel.config.js 평가 + inline config (zntc.config.ts `transformer.babel`)
+ * concat. Babel options 한 번 빌드 후 캐시. plugin require.resolve 는 user 의
+ * node_modules 우선 (Bun deep-link symlink 미생성 케이스 대비 fallback 명시).
+ */
+export declare function createBabelTransformer(projectRoot: string, inline?: InlineBabelConfig): (code: string, filename: string) => string | null;
+/**
+ * Babel transform plugin — 사용자 babel.config.js 의 custom plugin (Reanimated
+ * / NativeWind / 사용자 worklet) 을 source file 마다 적용. caller (preset.ts)
+ * 가 `detectCustomPlugins` 으로 게이트하므로 setup 시점엔 custom plugin 보장.
+ */
+export declare function createBabelPlugin(config: PluginConfig): ZntcPlugin;

package/dist/plugins/codegen.d.ts

@@ -0,0 +1,16 @@
+import type { ZntcPlugin } from '@zntc/core';
+import type { PluginConfig } from './types.ts';
+/** `codegenNativeComponent` literal — code 에 이 marker 미포함 시 transform skip. */
+export declare const CODEGEN_NATIVE_COMPONENT_MARKER = "codegenNativeComponent";
+/**
+ * Lazy codegen transformer factory. 첫 transform 호출 시점에
+ * `@react-native/babel-plugin-codegen` resolve (projectRoot 우선, 미발견 시
+ * cli node_modules fallback). RN 0.85+ Fabric crash 회피 patch.
+ */
+export declare function createCodegenTransformer(projectRoot: string): (code: string, filename: string) => string | null;
+/**
+ * Codegen plugin — `codegenNativeComponent` marker 가진 .js/.ts 파일을 Babel
+ * 로 transform 해서 view config 인라인. node_modules 포함 모든 파일 적용 (RN
+ * core 의 NativeComponent.js 까지 — DebuggingOverlay 등).
+ */
+export declare function createCodegenPlugin(config: PluginConfig): ZntcPlugin;

package/dist/plugins/escape-regex.d.ts

@@ -0,0 +1 @@
+export declare function escapeRegex(s: string): string;

package/dist/plugins/internal.d.ts

@@ -0,0 +1,37 @@
+/** ZNTC CLI 의 createRequire — fallback / require 의 모든 plugin 공용. */
+export declare const requireFromCli: NodeRequire;
+/** Babel @babel/core 의 transformSync 표면. babel.ts / codegen.ts 가 lazy load 후 사용. */
+export interface BabelInstance {
+    transformSync(code: string, options: BabelTransformOptions): {
+        code?: string;
+    } | null;
+    transformFromAstSync?(ast: unknown, code: string | undefined, options: {
+        filename?: string;
+        babelrc?: boolean;
+        configFile?: boolean;
+    }): {
+        code?: string;
+    } | null;
+}
+export interface BabelTransformOptions {
+    cwd?: string;
+    root?: string;
+    filename?: string;
+    presets?: unknown[];
+    plugins?: unknown[];
+    babelrc?: boolean;
+    configFile?: boolean;
+    compact?: boolean;
+    retainLines?: boolean;
+    sourceMaps?: boolean;
+    parserOpts?: {
+        plugins?: string[];
+    };
+}
+/**
+ * `unknown` error 에서 message string 추출. 4 plugin 파일이 stderr write
+ * 시점에 사용 — 매번 `as { message?: string }` cast 의 boilerplate 회피.
+ */
+export declare function getErrorMessage(err: unknown, max?: number): string;
+/** `"ext"` / `".ext"` → `".ext"`. sourceExts/assetExts 정규화 공용. */
+export declare function normalizeExt(ext: string): string;

package/dist/plugins/metro-resolve-request.d.ts

@@ -0,0 +1,7 @@
+import type { ZntcPlugin } from '@zntc/core';
+import type { CustomResolver, MetroPlatform } from '../metro-resolver-types.ts';
+export interface MetroResolveRequestOptions {
+    resolveRequest: CustomResolver;
+    platform: MetroPlatform;
+}
+export declare function createMetroResolveRequestPlugin(opts: MetroResolveRequestOptions): ZntcPlugin;

package/dist/plugins/require-context.d.ts

@@ -0,0 +1,7 @@
+import type { ZntcPlugin } from '@zntc/core';
+/**
+ * `require.context(dir, recursive, filter, flags?)` 의 host-side 평가. 디렉토리
+ * 가 없으면 graph 가 invalid 처리하지 않도록 빈 배열 응답. 파일 path 는 항상
+ * `./` prefix + forward slash (Windows path separator 정규화).
+ */
+export declare function createRequireContextPlugin(): ZntcPlugin;

package/dist/plugins/styled-components-native.d.ts

@@ -0,0 +1,11 @@
+import type { ZntcPlugin } from '@zntc/core';
+export declare const STYLED_COMPONENTS_NATIVE_PATH_RE: RegExp;
+export declare function disableStyledComponentsNativeDomProbe(code: string): string | null;
+/**
+ * RN 0.85 의 setUpDOM 은 `HTMLElement` 를 global/window 에 lazy polyfill 하지만,
+ * browser `document` 는 제공하지 않는다. styled-components/native v6 는
+ * `"HTMLElement" in window` 만으로 browser sheet 경로를 선택해 module 평가 중
+ * `document.querySelectorAll` 을 호출할 수 있으므로 native entry 에서는 DOM 감지를
+ * 명시적으로 꺼 둔다.
+ */
+export declare function createStyledComponentsNativePlugin(): ZntcPlugin;

package/dist/plugins/types.d.ts

@@ -0,0 +1,25 @@
+/** Inline babel config — Metro `transformer.babel` 호환. */
+export interface InlineBabelConfig {
+    presets?: (string | [string, Record<string, unknown>])[];
+    plugins?: (string | [string, Record<string, unknown>])[];
+}
+export interface PluginConfig {
+    /** RN 프로젝트 root — Babel/codegen plugin resolve 의 base. */
+    projectRoot: string;
+    /** RN asset 확장자 (`.png` / `.jpg` / `.svg` 등). */
+    assetExts: string[];
+    /** RN runtime platform — codegen / asset 의 platform 분기. */
+    rnPlatform: 'ios' | 'android';
+    /** Metro transformer dev flag. 미지정 시 기존 dev-server 기본값인 true. */
+    dev?: boolean;
+    /** Source 확장자 (`.ts` / `.tsx` / `.js` / `.jsx` / `.svg` 등). */
+    sourceExts: string[];
+    /** Metro 호환 custom file transformer path (예: react-native-svg-transformer). */
+    babelTransformerPath?: string;
+    /**
+     * Inline babel preset / plugin (zntc.config.ts 의 `transformer.babel`). 사용자
+     * babel.config.js 의 plugins 와 concat 되며 양쪽 모두 ZNTC native filter 통과
+     * 후 babel pass 에 등록. TS/Flow strip 은 ZNTC native transform 이 처리한다.
+     */
+    inlineBabel?: InlineBabelConfig;
+}

package/dist/preset.d.ts

@@ -0,0 +1,142 @@
+import { type BuildOptions, type BuildResult, type WatchHandle, type WatchReadyEvent, type WatchRebuildEvent, type ZntcPlugin } from '@zntc/core';
+import type { CustomResolver } from './metro-resolver-types.ts';
+import type { InlineBabelConfig } from './plugins/types.ts';
+export interface RnBundleInput {
+    /** 절대 경로 entry. */
+    entry: string;
+    /** 프로젝트 루트 — RN polyfill / InitializeCore / Reanimated worklets resolve 의 base. */
+    projectRoot: string;
+    /** RN platform — preset 의 default ext / mainFields / asset loaders 결정. */
+    rnPlatform: 'ios' | 'android';
+    /** dev mode — banner / jsx / devMode / reactRefresh / footer 분기. */
+    dev: boolean;
+    /** sourcemap emit. dev 시 inline 권장. */
+    sourcemap?: boolean;
+    /** prod build 의 minify. */
+    minify?: boolean;
+    /** console.* 호출 제거. Metro production Babel plugin 과 같은 정책을 원하는 release 경로에서 사용. */
+    dropConsole?: boolean;
+    /** debugger statement 제거. */
+    dropDebugger?: boolean;
+    /**
+     * preset 위에 user override. semantics:
+     * - **Object dict** (`define` / `loader` / `alias` / `fallback` 등) — preset
+     *   value 와 deep merge (key 단위 union, 충돌 시 override 우선)
+     * - **Array** (`plugins` / `resolveExtensions` / `mainFields` 등) — replace
+     *   (preset 의 array 무시)
+     * - **Primitive** (`target` / `minify` 등) — replace
+     *
+     * preset 의 default 가 ZNTC RN 호환 보장 — array override 는 RN 동작 깨질
+     * 위험 있음 (caller 가 의도적 변경 시만 사용).
+     */
+    override?: Partial<BuildOptions>;
+    /** Metro 호환 추가 옵션 (caller 의 ResolvedConfig 에서 추출). */
+    extra?: {
+        watchFolders?: string[];
+        /** Metro `resolver.nodeModulesPaths` 호환. bare import 추가 탐색 경로. */
+        nodeModulesPaths?: string[];
+        /**
+         * Metro `resolver.disableHierarchicalLookup` 호환. true 면 entry 디렉토리
+         * 외부의 `node_modules` walk-up 탐색을 차단 — monorepo 에서 dependency
+         * hoisting 강제 또는 워크스페이스 외부 모듈 누수 방지에 사용.
+         */
+        disableHierarchicalLookup?: boolean;
+        blockList?: (RegExp | string)[];
+        fallback?: Record<string, string | false>;
+        /** RN 외 사용자 plugin (asset/babel/codegen/require-context/metro-resolve-request 외 추가). */
+        additionalPlugins?: ZntcPlugin[];
+        /** Custom Metro resolveRequest — Metro 시그니처 그대로. */
+        metroResolveRequest?: CustomResolver;
+        /** Metro 호환 babel transformer path (svg-transformer 등). */
+        babelTransformerPath?: string;
+        /** RN sourceExts override (default RN preset). */
+        sourceExts?: string[];
+        /** RN assetExts override (default RN preset). */
+        assetExts?: string[];
+        /**
+         * Metro `resolver.platforms` 호환. caller 가 인식 가능한 platform 이름 set.
+         * `rnPlatform` 이 이 list 안에 있어야 하며, list 자체는 prefix 확장에는
+         * 영향 없음 (Metro 동작과 동일 — current platform suffix 만 expand). 이
+         * sugar 는 사용자가 자신의 platform list 를 명시했을 때 `rnPlatform`
+         * 누락을 빌드 직전에 잡는 validation 용. 미래의 platform typing 확장
+         * (e.g. `tvos`/`macos`) 의 placeholder.
+         */
+        platforms?: string[];
+        /** 사용자 추가 polyfill (preset 의 RN polyfill 와 concat — Metro `serializer.polyfills` 호환). */
+        polyfills?: string[];
+        /**
+         * 추가 global 변수 — banner 의 `var <key>=<JSON.stringify(value)>` 로 inject.
+         * Metro `serializer.extraVars` 호환. zntc 의 `define` 과 의도가 다름:
+         * `define` 은 source 의 식별자 substitution (compile-time), `extraVars` 는
+         * runtime-time prelude 의 globals declaration (RN 코드 도착 전에 평가).
+         */
+        extraVars?: Record<string, unknown>;
+        /**
+         * Entry 전 실행할 module path (Metro `serializer.prelude` 호환). 절대 경로 또는
+         * projectRoot 기준 상대 경로. preset 의 `runBeforeMain` (InitializeCore) 와 concat
+         * 되어 RN runtime 부팅 직후 / entry 전에 실행. babel.config.js 같은 transform 영역
+         * 이 아닌 **번들에 prepend 되는 module list**.
+         */
+        prelude?: string[];
+        /**
+         * 사용자 babel preset / plugin (Metro `transformer.babel` 호환). babel.config.js
+         * 외에 zntc.config.ts 안에서 inline 으로 babel 설정. ZNTC native 처리 plugin (TS
+         * strip / RN preset / Reanimated 등) 은 자동 제외 — 충돌 회피.
+         *
+         * 사용자 babel.config.js 의 plugins 와 concat 되며 양쪽 모두 ZNTC native filter
+         * 통과 후 babel pass 에 forward. TS/Flow strip 은 ZNTC native transform 이 처리하므로
+         * presets 는 사용자가 명시한 non-native 항목만 forward 됨.
+         */
+        babel?: InlineBabelConfig;
+        /**
+         * Sourcemap 을 bundle 에 inline 으로 embed (Metro `serializer.inlineSourceMap`
+         * 호환). zntc core 의 `sourcemapMode='inline'` 으로 forward.
+         */
+        inlineSourceMap?: boolean;
+        /**
+         * Sourcemap 의 `sourceRoot` field (Metro `sourcemapSourcesRoot` 호환). 절대
+         * 경로를 source 로 변환하는 base. zntc core 의 `sourceRoot` 으로 forward.
+         */
+        sourceRoot?: string;
+        /**
+         * `console.error` setter intercept 의 RegExp source string 배열 — match 시
+         * silent swallow. zntc core 의 `silentConsoleErrorPatterns` 로 forward
+         * (Metro `server.silentConsoleErrorPatterns` 호환). consumer (e.g.
+         * `withExpo()`) 가 환경 감지 후 패턴 주입.
+         */
+        silentConsoleErrorPatterns?: string[];
+        /**
+         * Metro `server.forwardClientLogs` 호환. RN core 의 HMRClient.log 경유 로그를
+         * dev server 터미널로 forwarding. 기본 true.
+         */
+        forwardClientLogs?: boolean;
+    };
+    /** RN prelude 끝에 append 할 사용자 banner string. */
+    bannerExtras?: string;
+    /** Reanimated worklets 의 jsVersion 검증용. 미지정 시 자동 resolve. */
+    workletPluginVersion?: string;
+}
+export declare const DEFAULT_ASSET_EXTS: string[];
+/**
+ * RN preset — RnBundleInput → BuildOptions. 번개 napi-build.ts L74-L268 의 RN
+ * 분기와 동등 동작.
+ */
+export declare function buildRnBundleOptions(input: RnBundleInput): BuildOptions;
+/**
+ * One-shot wrapper — `init()` + `build(buildRnBundleOptions(input))`. caller 가
+ * NAPI direct 호출이 아니라 단순 prod bundle 시나리오.
+ *
+ * `init()` 은 idempotent (core 의 module-cache `if (native) return`) — caller
+ * 가 별도로 `init(path)` 호출 후 `bundleRn` 호출해도 안전 (앞선 path 가 우선).
+ */
+export declare function bundleRn(input: RnBundleInput): Promise<BuildResult>;
+export interface RnWatchInput extends RnBundleInput {
+    outfile: string;
+    onReady?: (event: WatchReadyEvent) => void;
+    onRebuild?: (event: WatchRebuildEvent) => void | Promise<void>;
+}
+/**
+ * Watch wrapper — `init()` + `watch(buildRnBundleOptions(input))` + outfile +
+ * onReady/onRebuild wire-up. handle 반환 (caller 가 close). `init()` idempotent.
+ */
+export declare function watchRn(input: RnWatchInput): WatchHandle;

package/dist/rn-constants.d.ts

@@ -0,0 +1,21 @@
+/** `require.resolve` with try/catch — 미해결 시 null. caller 가 fallback chain 구성. */
+export declare function tryResolve(specifier: string, fromDir: string): string | null;
+/**
+ * RN polyfill paths (console.js, error-guard.js 등) resolve.
+ * - 1순위: `react-native/rn-get-polyfills` (RN 0.73+)
+ * - 2순위: `@react-native/js-polyfills` (legacy)
+ * 둘 다 미설치 시 console.warn + 빈 배열 반환 — caller 는 graceful skip.
+ */
+export declare function resolveRnPolyfills(projectRoot: string): string[];
+/**
+ * RN core packages — Metro/RN 은 이 패키지들의 인스턴스가 번들에 단 하나만
+ * 존재한다고 가정한다 (InitializeCore / DevTools / Fabric singleton). pnpm 처럼
+ * `.pnpm/<dep>/node_modules/react-native` 같은 peer farm 이 노출되면 동일 패키지의
+ * 별도 module id 가 만들어져 InitializeCore 가 두 번 실행될 수 있다 → alias 로 강제.
+ */
+export declare const RN_SINGLETON_PACKAGES: readonly ["react", "react-native", "react-native-safe-area-context"];
+/**
+ * RN reserved global identifiers (RN 0.83 기준 — minor 마다 변할 수 있어 audit 필요).
+ * `polyfillGlobal()` 로 등록되는 native global — scope hoisting 시 shadowing 회피.
+ */
+export declare const RN_GLOBAL_IDENTIFIERS: readonly ["Promise", "regeneratorRuntime", "XMLHttpRequest", "FormData", "fetch", "Headers", "Request", "Response", "WebSocket", "Blob", "File", "FileReader", "URL", "URLSearchParams", "AbortController", "AbortSignal", "queueMicrotask", "setImmediate", "clearImmediate", "requestIdleCallback", "cancelIdleCallback", "setTimeout", "clearTimeout", "setInterval", "clearInterval", "requestAnimationFrame", "cancelAnimationFrame", "DOMRect", "DOMRectReadOnly", "DOMRectList", "HTMLCollection", "NodeList", "Node", "Document", "CharacterData", "Text", "Element", "HTMLElement", "IntersectionObserver", "MutationObserver", "MutationRecord", "EventCounts", "Performance", "PerformanceEntry", "PerformanceEventTiming", "PerformanceLongTaskTiming", "PerformanceMark", "PerformanceMeasure", "PerformanceObserver", "PerformanceObserverEntryList", "PerformanceResourceTiming", "TaskAttributionTiming"];

package/dist/runtime-loader.d.ts

@@ -0,0 +1,14 @@
+/**
+ * RN runtime 의 HMRClient interface 호환 코드 (string).
+ * runtime/zntc-hmr-client.cjs 가 dist 와 함께 publish 되어야 정상 로드.
+ *
+ * fallback dummy: build 직후 / 누락 환경에서 dynamic require 가 throw 안 하도록
+ * minimal no-op HMRClient 객체 export (RN 의 setUpBatchedBridge 가 default
+ * 접근 — `module.exports.default` 보존).
+ */
+export declare const ZNTC_HMR_CLIENT_CODE: string;
+/**
+ * RN runtime 의 `HMRClient.js` 의 path suffix (Metro 의 모듈 path 가 이 suffix
+ * 로 끝남). plugin factory 가 onLoad path 매칭 시 사용.
+ */
+export declare const HMR_CLIENT_SUFFIX = "/Libraries/Utilities/HMRClient.js";

package/dist/withExpo.d.ts

@@ -0,0 +1,60 @@
+/**
+ * withExpo — Apply Expo-specific options to a ZNTC RN config.
+ *
+ * Mirrors the runtime opt-in pattern of `@expo/metro-config`:
+ *   import { withExpo } from '@zntc/react-native';
+ *   export default withExpo({ root: __dirname, entry: 'index.js', ... });
+ *
+ * Adds:
+ *   - serializer.prelude:                 `expo/winter` + `@expo/metro-runtime`
+ *   - resolver.assetExts:                 `.heic`, `.avif`, `.db` (expo-image, expo-sqlite)
+ *   - resolver.blockList:                 `.expo/types/**` (generated d.ts)
+ *   - server.silentConsoleErrorPatterns:  winter polyfill warning
+ *
+ * Resolves all paths from `config.root`, so monorepo hoisting in unrelated
+ * workspace packages cannot leak Expo into a vanilla RN config.
+ *
+ * 번개 packages/bungae/src/bundler/zntc-bundler/withExpo.ts 의 ZNTC 포팅.
+ * BungaeConfig 대신 ZNTC 의 Metro-shape config (rn-dev-input.mjs 가 인식하는
+ * `resolver.assetExts` / `resolver.blockList` / `serializer.prelude` /
+ * `server.silentConsoleErrorPatterns` 영역) 를 변형.
+ */
+/**
+ * Detect whether a project's own `package.json` declares Expo as a direct
+ * dependency. Used by zero-config mode to decide whether to auto-apply
+ * `withExpo()`. Hoisted-monorepo dependencies in workspace root do NOT
+ * trigger detection — only the project's own deps do.
+ */
+export declare function detectExpo(projectRoot: string): {
+    name: 'expo' | 'expo-router';
+    version: string;
+} | undefined;
+/**
+ * expo `installGlobal.ts:96` 의 winter polyfill (TextEncoderStream/TextDecoderStream/
+ * Location) 이 Hermes 의 `configurable: false` spec global 위에 redefine 시도 →
+ * catch 후 무해 console.error. dev console 을 오염시키므로 silent swallow.
+ */
+export declare const WINTER_POLYFILL_WARNING_PATTERN = "^Failed to set polyfill\\.\\s+\\w+\\s+is not configurable\\.?$";
+/**
+ * ZNTC 의 Metro-shape config 가 가질 수 있는 영역 — withExpo 가 만지는 부분만
+ * 명시. caller 가 `defineConfig` 없이 plain object 로 export 하므로 `T extends`
+ * 형태로 generic 보존 — 추가 필드는 그대로 통과.
+ */
+export interface ZntcRnExpoConfig {
+    root?: string;
+    resolver?: {
+        assetExts?: string[];
+        blockList?: (RegExp | string)[];
+        [key: string]: unknown;
+    };
+    serializer?: {
+        prelude?: string[];
+        [key: string]: unknown;
+    };
+    server?: {
+        silentConsoleErrorPatterns?: string[];
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export declare function withExpo<T extends ZntcRnExpoConfig>(config: T): T;

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@zntc/react-native",
+  "version": "0.1.0",
+  "description": "ZNTC React Native platform — Metro HMR adapter + RN preset (buildRnBundleOptions) + plugin factories + RN runtime",
+  "keywords": [
+    "bundler",
+    "flow",
+    "hermes",
+    "metro",
+    "react-native",
+    "reanimated",
+    "transpiler",
+    "worklets",
+    "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/react-native"
+  },
+  "files": [
+    "dist/",
+    "runtime/",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./runtime/zntc-hmr-client.cjs": "./runtime/zntc-hmr-client.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 --external @babel/core --external @react-native/babel-plugin-codegen --external @react-native/babel-preset --external metro-resolver --external react-native --external @react-native/js-polyfills",
+    "build:dts": "bun x tsc -b",
+    "build": "bun run build:bundle && bun run build:dts",
+    "test": "bun test --timeout 10000",
+    "prepublishOnly": "bun run build && bunx publint --strict --level error ."
+  },
+  "dependencies": {
+    "@react-native-community/cli-server-api": "^15.0.0",
+    "@zntc/core": "workspace:*",
+    "jsc-safe-url": "^0.2.4",
+    "source-map": "^0.7.4"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "@zntc/server": "workspace:*"
+  },
+  "optionalDependencies": {
+    "@babel/core": "^7.26.0",
+    "@react-native/babel-plugin-codegen": "^0.83.0",
+    "@react-native/babel-preset": "^0.83.0",
+    "@react-native/js-polyfills": "^0.83.0",
+    "metro-resolver": "^0.83.0",
+    "react-native": "^0.83.0"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}