@zntc/react-native 0.1.1 → 0.1.3

package/README.md

@@ -1,48 +1,108 @@
 # @zntc/react-native
 
-ZNTC 의 React Native platform layer (#2540).
+English · **[한국어](./README_KO.md)**
 
-## 역할
+> ZNTC React Native platform layer — RN preset + Metro-compatible dev server + Reanimated worklets / Flow / Hermes.
 
-- **RN preset** — `buildRnBundleOptions(input)` / `bundleRn(input)` / `watchRn(input)`. RN-specific NAPI build 옵션 (target=es5, flow, jsx=automatic-dev, devMode, reactRefresh, polyfills, runBeforeMain, banner) 자동 적용.
-- **Metro HMR adapter** — `createMetroHmrAdapter()` (`@zntc/server.HmrChannel` 위 thin wrapper). RN runtime 의 HMRClient interface 호환 메시지 (`hmr:update-start` / `hmr:update` / `hmr:update-done` / `hmr:reload` / `hmr:error` / `log`) 송출.
-- **RN runtime** — `runtime/zntc-hmr-client.cjs` (Metro HMRClient 인터페이스 호환 RN runtime).
-- **Plugin factories** — `createAssetPlugin` / `createBabelPlugin` / `createCodegenPlugin` / `createRequireContextPlugin` / `createMetroResolveRequestPlugin`.
-- **RN 상수 / helpers** — `RN_GLOBAL_IDENTIFIERS` / `tryResolve` / `resolveRnPolyfills`.
+[![npm](https://img.shields.io/npm/v/@zntc/react-native.svg)](https://www.npmjs.com/package/@zntc/react-native)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/ohah/zntc/blob/main/LICENSE)
+
+`@zntc/react-native` adapts the [ZNTC](https://github.com/ohah/zntc) toolchain to React Native. It turns a small user input into Metro-compatible NAPI build options, ships a Metro-compatible HMR dev server, and wires in the RN-specific transforms (Flow, Reanimated worklets, Hermes target) — all built into the ZNTC core, **without Babel**.
 
-## 비범위 (이 패키지가 안 함)
+What it provides:
+
+- **RN preset** — `buildRnBundleOptions(input)` / `bundleRn(input)` / `watchRn(input)`. RN-specific build options (Hermes/ES5 target, Flow, automatic-dev JSX, worklets, dev mode, Fast Refresh, polyfills, RN prelude banner) are applied automatically.
+- **Metro-compatible dev server** — `serveRn(options)` / `buildRnDevServerOptions(input)`. Per-platform watch, HMR bridge over the `/hot` endpoint, and terminal actions, wired together for you.
+- **Metro HMR adapter** — `createMetroHmrAdapter()` emits messages compatible with the RN runtime's HMRClient interface (`hmr:update-start` / `hmr:update` / `hmr:update-done` / `hmr:reload` / `hmr:error` / `log`).
+- **RN runtime** — `runtime/zntc-hmr-client.cjs`, an HMRClient-compatible client for the RN runtime.
+- **Plugin factories** — `createAssetPlugin` / `createBabelPlugin` / `createCodegenPlugin` / `createRequireContextPlugin` / `createMetroResolveRequestPlugin`.
+- **RN constants / helpers** — `RN_GLOBAL_IDENTIFIERS` / `tryResolve` / `resolveRnPolyfills`.
 
-- HTTP server / dev-middleware / asset registry / Rozenite DevTools / open-stack-frame / symbolicate — RN-specific runtime 영역, 사용자 측 (예: bungae) 가 운영
-- iOS / Android native build orchestration (run-android / run-ios / autolinking) — `@react-native-community/cli` 영역
+Out of scope (handled elsewhere): iOS / Android native build orchestration (`run-android` / `run-ios` / autolinking) belongs to `@react-native-community/cli`.
 
-## 설치
+## Installation
 
 ```bash
 bun add -D @zntc/react-native @zntc/core
-# 사용 환경에 따라 optional:
-# bun add -D @babel/core @react-native/babel-preset metro-resolver react-native
+# npm i -D @zntc/react-native @zntc/core
+# pnpm add -D @zntc/react-native @zntc/core
+```
+
+Some features rely on optional peer packages — install the ones your setup needs:
+
+```bash
+bun add -D @babel/core @react-native/babel-preset metro-resolver react-native
 ```
 
-## 사용 예
+`@react-native-community/cli-server-api` is required for the dev server's reload / dev-menu broadcasts.
+
+## Usage
+
+### Attaching to an existing React Native CLI project
+
+The simplest path is the scaffolder, which rewrites the `start` / `bundle:*` scripts of an existing RN CLI app to use ZNTC (Metro fallback is preserved):
+
+```bash
+npx @zntc/init
+```
+
+See the [React Native guide](https://ohah.github.io/zntc/guides/react-native/) for details.
+
+### RN preset — `buildRnBundleOptions`
+
+Convert a small RN input into ZNTC NAPI build options, then run a build:
 
 ```ts
 import { init, build } from '@zntc/core';
 import { buildRnBundleOptions } from '@zntc/react-native';
 
 await init();
+
 const result = await build(
   buildRnBundleOptions({
     entry: '/abs/path/index.ts',
     projectRoot: '/abs/path',
-    rnPlatform: 'ios',
+    rnPlatform: 'ios', // 'ios' | 'android'
     dev: false,
     sourcemap: true,
   }),
 );
 ```
 
-## 관련 epic
+`bundleRn(input)` is a one-call shorthand for `build(buildRnBundleOptions(input))`, and `watchRn(input)` starts a watching build.
+
+The preset auto-enables the RN-compatible defaults (Hermes/ES5 target, Flow, worklets, polyfills, RN prelude banner, asset loaders, and so on). In dev mode it additionally enables automatic-dev JSX, Fast Refresh, and the dev-mode runtime. You can layer user overrides on top via `input.override` (dictionaries deep-merge, arrays/primitives replace).
+
+### Metro-compatible dev server — `serveRn`
+
+```ts
+import { buildRnDevServerOptions, serveRn } from '@zntc/react-native';
+
+const handle = await serveRn(
+  buildRnDevServerOptions({
+    bundle: {
+      entry: '/abs/path/index.ts',
+      projectRoot: '/abs/path',
+      rnPlatform: 'ios',
+      dev: true,
+    },
+    port: 8081,
+    host: 'localhost',
+  }),
+);
+
+// handle.url / handle.port — connect the RN app to this server
+// await handle.stop(); — graceful shutdown
+```
+
+`serveRn` lazily loads `@react-native-community/cli-server-api` and the RN dev middleware, runs a per-platform watching build, serves HMR over `/hot`, and sets up terminal actions (reload / dev menu). The HMR messages are Metro HMRClient-compatible, so the standard RN runtime connects without changes.
+
+## Documentation
+
+- Monorepo: <https://github.com/ohah/zntc>
+- Docs: <https://ohah.github.io/zntc>
+- React Native guide: <https://ohah.github.io/zntc/guides/react-native/>
+
+## License
 
-- #2539 — `@zntc/web` + `@zntc/server` 분리 (선행, 완료)
-- #2540 — 본 패키지 신설
-- #2538 — Zig 단일 dev server (후속)
+MIT

package/dist/dev-server/bun-http-adapter.d.ts

@@ -0,0 +1,10 @@
+import type { Middleware } from './types.ts';
+/**
+ * 미들웨어 체인(node req/res 기반)을 Bun `Request` 에 대해 실행하고 단일
+ * `Response` 로 변환. terminal next() / next(err) 도 node 경로(chainToHandler)와
+ * 동일하게 404 / 500 으로 매핑한다.
+ *
+ * route handler 가 비동기로 res.end() 를 호출하는 경우(.catch(next) 패턴)도
+ * Promise 가 end / next 둘 중 먼저 오는 쪽에서 resolve 되도록 한다.
+ */
+export declare function runMiddlewareForBun(middleware: Middleware, req: Request): Promise<Response>;

package/dist/dev-server/hmr-bridge.d.ts

@@ -1,5 +1,6 @@
 import type { IncomingMessage } from 'node:http';
 import type { Socket } from 'node:net';
+import type { BunHmrClient } from '@zntc/server';
 import { type MetroHmrAdapter } from '../metro-hmr-adapter.ts';
 import type { PlatformStateCallbacks } from './platform-state.ts';
 export interface HmrBridgeOptions {
@@ -14,8 +15,22 @@ export interface HmrBridge {
     readonly adapter: MetroHmrAdapter;
     readonly callbacks: PlatformStateCallbacks;
     readonly path: string;
-    /** http upgrade chain 안에서 호출 — channel.accept + initial greeting. */
+    /** http upgrade chain 안에서 호출 (Node) — channel.accept + initial greeting. */
     acceptUpgrade(req: IncomingMessage, socket: Socket): void;
+    /**
+     * Bun.serve websocket `open(ws)` 에서 호출 — Bun client 등록 + initial greeting.
+     * Node 의 `acceptUpgrade` 와 대칭이지만 raw socket 핸드셰이크가 없다 (Bun.serve
+     * 의 `server.upgrade(req)` 가 RFC6455 핸드셰이크를 native 로 처리하므로).
+     */
+    acceptBun(ws: BunHmrClient): void;
+    /** Bun.serve websocket `close(ws)` 에서 호출 — Bun client 정리. */
+    removeBun(ws: BunHmrClient): void;
+    /**
+     * Bun.serve websocket `message(ws, msg)` 에서 호출 — client → server text 를
+     * incoming 핸들러(register-entrypoints ACK / log forwarding)로 dispatch.
+     * Node 경로는 `channel.accept` 의 `socket.on('data')` 가 같은 역할.
+     */
+    handleBunMessage(ws: BunHmrClient, text: string): void;
     /** RN runtime console.log forwarding 출력 표시 toggle. 새 상태 반환. */
     toggleLogs(): boolean;
 }

package/dist/dev-server/http-server.d.ts

@@ -30,3 +30,4 @@ export interface DevHttpServerHandle {
  */
 export declare function createBaseMiddleware(options: RnDevServerOptions, deps: DevHttpServerDeps): Middleware;
 export declare function createDevHttpServer(options: RnDevServerOptions, deps: DevHttpServerDeps): Promise<DevHttpServerHandle>;
+export declare function createBunDevHttpServer(options: RnDevServerOptions, deps: DevHttpServerDeps): Promise<DevHttpServerHandle>;

package/dist/dev-server/index.d.ts

@@ -2,7 +2,7 @@ export { createHmrBridge, type HmrBridge, type HmrBridgeOptions } from './hmr-br
 export { type RnDevServerHandle, serveRn, type ServeRnExtras } from './serve.ts';
 export { type CliServerApi, type CliWebsocketEndpoint, loadCliServerApi, type LoadCliServerApiOptions, } from './middleware/cli-server-api.ts';
 export { type DevMiddleware, loadDevMiddleware, type LoadDevMiddlewareOptions, } from './middleware/dev-middleware.ts';
-export { createBaseMiddleware, createDevHttpServer, type DevHttpServerDeps, type DevHttpServerHandle, } from './http-server.ts';
+export { createBaseMiddleware, createBunDevHttpServer, createDevHttpServer, type DevHttpServerDeps, type DevHttpServerHandle, } from './http-server.ts';
 export { parseRequestUrl, readJsonBody, sendJson, sendText } from './http-utils.ts';
 export type { CustomizeFrame, RnDevServerOptions, RnDevServerOptionsInput } from './options.ts';
 export { buildRnDevServerOptions } from './options.ts';

package/dist/dev-server/platform-state.d.ts

@@ -20,6 +20,30 @@ export interface PlatformStateCallbacks {
     onReady?: (state: PlatformState, event: WatchReadyEvent) => void;
     onRebuild?: (state: PlatformState, event: WatchRebuildEvent) => void;
 }
+export interface BundleRefresher {
+    /** stale 신호 — generation 을 bump 해 in-flight build 가 이 변경을 마스킹하지 못하게 한다. */
+    markStale(): void;
+    /** stale 이면 build, in-flight 면 coalesce. */
+    refresh(): Promise<void>;
+}
+/**
+ * in-flight build coalescing + generation guard. `build` 는 시작 시점 소스를 빌드하므로,
+ * 진행 중 `markStale()` 이 또 불리면(파일 재변경) 그 build 완료가 stale 을 clear 하면 안 된다
+ * (더 새로운 변경을 마스킹 → stale bundle 제공). generation 으로 가드: build 시작 시 generation
+ * 을 캡처, 완료 시 generation 이 그대로일 때만 `clearStale`. 새 staleness 가 들어왔으면 stale 을
+ * 유지해 다음 `refresh()` 가 최신 소스로 rebuild 한다. `bundleRn`/state 의존을 콜백으로 주입해
+ * race-safety 로직만 결정적으로 유닛 테스트할 수 있게 분리.
+ */
+export declare function createBundleRefresher(deps: {
+    /** 이미 신선(!bundleStale && bundle≠null)하면 build 스킵. */
+    isFresh: () => boolean;
+    /** bundleRn + state.bundle/buildError 갱신. 내부 try/catch 라 reject 하지 않음. */
+    build: () => Promise<void>;
+    /** stale=true. */
+    setStale: () => void;
+    /** stale=false. */
+    clearStale: () => void;
+}): BundleRefresher;
 /**
  * platform 별 watch + state 생성. 첫 build 는 비동기 — caller 가
  * `waitForBuild(state)` 로 대기. RN runtime 이 ios+android 동시 요청 시

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { HMR_RN_MSG, type HmrRnErrorMessage, type HmrRnLogMessage, type HmrRnMessage, type HmrRnMessageType, type HmrRnReloadMessage, type HmrRnUpdateDoneMessage, type HmrRnUpdateMessage, type HmrRnUpdateModule, type HmrRnUpdateStartMessage, } from '@zntc/server';
-export { type AssetResolverOptions, type Broadcast, buildRnDevServerOptions, createBaseMiddleware, createDevHttpServer, createHmrBridge, createPlatformState, type CliServerApi, type CliWebsocketEndpoint, type DevMiddleware, loadCliServerApi, loadDevMiddleware, type LoadCliServerApiOptions, type LoadDevMiddlewareOptions, createPlatformStateRegistry, type CustomizeFrame, type DevHttpServerDeps, type DevHttpServerHandle, type FrameInfo, getCachedSourceMap, type HmrBridge, type HmrBridgeOptions, applyCustomizeFrame, createSourceMapConsumer, extractCodeFrame, handleAssetRequest, handleBundleRequest, handleHmrMapRequest, handleIndexPage, handleMapRequest, handleSymbolicateRequest, isIndexRoute, isAssetRoute, isBundleRoute, isHmrMapRoute, isMapRoute, isSymbolicateRoute, normalizeFrame, symbolicateFrame, type SymbolicateCodeFrame, type SymbolicateRequest, type SymbolicateResponse, type Middleware, type MiddlewareEnhanceContext, type PlatformState, type PlatformStateCallbacks, type PlatformStateRegistry, colors, formatLogBadge, logBundle, logError, logInfo, logWarn, postProcessSourceMap, type SourcemapPathOptions, printZntcRnBanner, resolveAssetPath, type ServeRnExtras, serveRn, setupTerminalActions, type TerminalActionsCallbacks, type TerminalActionsOptions, type RnDevServerHandle, type RnDevServerOptions, type RnDevServerOptionsInput, waitForBuild, } from './dev-server/index.ts';
+export { type AssetResolverOptions, type Broadcast, buildRnDevServerOptions, createBaseMiddleware, createBunDevHttpServer, createDevHttpServer, createHmrBridge, createPlatformState, type CliServerApi, type CliWebsocketEndpoint, type DevMiddleware, loadCliServerApi, loadDevMiddleware, type LoadCliServerApiOptions, type LoadDevMiddlewareOptions, createPlatformStateRegistry, type CustomizeFrame, type DevHttpServerDeps, type DevHttpServerHandle, type FrameInfo, getCachedSourceMap, type HmrBridge, type HmrBridgeOptions, applyCustomizeFrame, createSourceMapConsumer, extractCodeFrame, handleAssetRequest, handleBundleRequest, handleHmrMapRequest, handleIndexPage, handleMapRequest, handleSymbolicateRequest, isIndexRoute, isAssetRoute, isBundleRoute, isHmrMapRoute, isMapRoute, isSymbolicateRoute, normalizeFrame, symbolicateFrame, type SymbolicateCodeFrame, type SymbolicateRequest, type SymbolicateResponse, type Middleware, type MiddlewareEnhanceContext, type PlatformState, type PlatformStateCallbacks, type PlatformStateRegistry, colors, formatLogBadge, logBundle, logError, logInfo, logWarn, postProcessSourceMap, type SourcemapPathOptions, printZntcRnBanner, resolveAssetPath, type ServeRnExtras, serveRn, setupTerminalActions, type TerminalActionsCallbacks, type TerminalActionsOptions, type RnDevServerHandle, type RnDevServerOptions, type RnDevServerOptionsInput, waitForBuild, } from './dev-server/index.ts';
 export { createMetroHmrAdapter, type MetroHmrAdapter } from './metro-hmr-adapter.ts';
 export type { CustomResolver, MetroPlatform, Resolution, ResolutionContext, } from './metro-resolver-types.ts';
 export { createAssetPlugin } from './plugins/asset.ts';

package/dist/index.js

@@ -87,7 +87,7 @@ const URI_REGEX = /^(([^:/?#]+):)?(\/\/([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?/;
 		if (parsedUrl.path.indexOf("//&") === -1) {
 			return urlToNormalize;
 		}
-		return (parsedUrl.schemeAndAuthority + parsedUrl.path.replace("//&", "?") + (parsedUrl.queryWithoutQuestionMark.length > 0 ? "&" + parsedUrl.queryWithoutQuestionMark : "") + parsedUrl.fragmentWithHash);
+		return parsedUrl.schemeAndAuthority + parsedUrl.path.replace("//&", "?") + (parsedUrl.queryWithoutQuestionMark.length > 0 ? "&" + parsedUrl.queryWithoutQuestionMark : "") + parsedUrl.fragmentWithHash;
 	}
 	function toJscSafeUrl(urlToConvert) {
 		if (!_rfc3986Parse(urlToConvert).hasQueryPart) {
@@ -97,7 +97,7 @@ const URI_REGEX = /^(([^:/?#]+):)?(\/\/([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?/;
 		if (parsedUrl.queryWithoutQuestionMark.length > 0 && (parsedUrl.path === "" || parsedUrl.path === "/")) {
 			throw new Error(`The given URL "${urlToConvert}" has an empty path and cannot be converted to a JSC-safe format.`);
 		}
-		return (parsedUrl.schemeAndAuthority + parsedUrl.path + (parsedUrl.queryWithoutQuestionMark.length > 0 ? "//&" + parsedUrl.queryWithoutQuestionMark.replace(/\?/g, "%3F") : "") + parsedUrl.fragmentWithHash);
+		return parsedUrl.schemeAndAuthority + parsedUrl.path + (parsedUrl.queryWithoutQuestionMark.length > 0 ? "//&" + parsedUrl.queryWithoutQuestionMark.replace(/\?/g, "%3F") : "") + parsedUrl.fragmentWithHash;
 	}
 	module.exports = { isJscSafeUrl, toNormalUrl, toJscSafeUrl };
 	
@@ -110,15 +110,6 @@ var require__disabled__url = __commonJS({
 	}
 });
 //#endregion
-//#region (optional-missing):
-var require__optional_missing__ = __commonJS({
-	"(optional-missing):"(exports, module) {
-		var e = new Error("Cannot find module \"" + "" + "\"");
-		e.code = "MODULE_NOT_FOUND";
-		throw e;
-	}
-});
-//#endregion
 //#region array-set.js
 var require_source_map_lib_array_set = __commonJS({
 	"array-set.js"(exports, module) {
@@ -260,7 +251,7 @@ var require_source_map_lib_mapping_list = __commonJS({
 const util = require_source_map_lib_util();
 	function generatedPositionAfter(mappingA,mappingB) {
 		const lineA = mappingA.generatedLine,lineB = mappingB.generatedLine,columnA = mappingA.generatedColumn,columnB = mappingB.generatedColumn;
-		return (lineB > lineA || (lineB == lineA && columnB >= columnA) || util.compareByGeneratedPositionsInflated(mappingA, mappingB) <= 0);
+		return lineB > lineA || lineB == lineA && columnB >= columnA || util.compareByGeneratedPositionsInflated(mappingA, mappingB) <= 0;
 	}
 	class MappingList {
 		constructor() {
@@ -525,7 +516,7 @@ const util = require_source_map_lib_util(),binarySearch = require_source_map_lib
 				bias = SourceMapConsumer.GREATEST_LOWER_BOUND;
 			}
 			let mapping;
-			this._wasm.withMappingCallback((m) => (mapping = m), () => {
+			this._wasm.withMappingCallback((m) => mapping = m, () => {
 				this._wasm.exports.original_location_for(this._getMappingsPtr(), needle.generatedLine - 1, needle.generatedColumn, bias);
 			});
 			if (mapping) {
@@ -547,9 +538,9 @@ const util = require_source_map_lib_util(),binarySearch = require_source_map_lib
 			if (!this.sourcesContent) {
 				return false;
 			}
-			return (this.sourcesContent.length >= this._sources.size() && !this.sourcesContent.some(function(sc) {
+			return this.sourcesContent.length >= this._sources.size() && !this.sourcesContent.some(function(sc) {
 				return sc == null;
-			}));
+			});
 		}
 		sourceContentFor(aSource,nullOnMissing) {
 			if (!this.sourcesContent) {
@@ -582,7 +573,7 @@ const util = require_source_map_lib_util(),binarySearch = require_source_map_lib
 				bias = SourceMapConsumer.GREATEST_LOWER_BOUND;
 			}
 			let mapping;
-			this._wasm.withMappingCallback((m) => (mapping = m), () => {
+			this._wasm.withMappingCallback((m) => mapping = m, () => {
 				this._wasm.exports.generated_location_for(this._getMappingsPtr(), needle.source, needle.originalLine - 1, needle.originalColumn, bias);
 			});
 			if (mapping) {
@@ -616,7 +607,7 @@ const util = require_source_map_lib_util(),binarySearch = require_source_map_lib
 						throw new Error("Support for url field in sections not implemented.");
 					}
 					const offset = util.getArg(s, "offset"),offsetLine = util.getArg(offset, "line"),offsetColumn = util.getArg(offset, "column");
-					if (offsetLine < lastOffset.line || (offsetLine === lastOffset.line && offsetColumn < lastOffset.column)) {
+					if (offsetLine < lastOffset.line || offsetLine === lastOffset.line && offsetColumn < lastOffset.column) {
 						throw new Error("Section offsets must be ordered and non-overlapping.");
 					}
 					lastOffset = offset;
@@ -645,7 +636,7 @@ const util = require_source_map_lib_util(),binarySearch = require_source_map_lib
 				if (cmp) {
 					return cmp;
 				}
-				return (aNeedle.generatedColumn - (section.generatedOffset.generatedColumn - 1));
+				return aNeedle.generatedColumn - (section.generatedOffset.generatedColumn - 1);
 			}),section = this._sections[sectionIndex];
 			if (!section) {
 				return { source: null, line: null, column: null, name: null };
@@ -1511,13 +1502,13 @@ exports.SourceMapGenerator = require_source_map_lib_source_map_generator().Sourc
 });
 //#endregion
 //#region protocol.ts
-const HMR_MSG = Object.freeze({ Connected: "connected", CssUpdate: "css-update", ClearError: "clear-error", Error: "error", FullReload: "full-reload" }),HMR_WS_GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11";
+const HMR_MSG = Object.freeze({ Connected: "connected", CssUpdate: "css-update", ClearError: "clear-error", Error: "error", FullReload: "full-reload", UpdateStart: "update-start", Update: "update", UpdateDone: "update-done" }),HMR_WS_GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11";
 function normalizeHmrErrors(errors) {
 	if (!Array.isArray(errors) || errors.length === 0) {
 		return [{ file: "", message: "Unknown build error" }];
 	}
 	return errors.map((error) => {
-		const e = (error ?? {}),file = typeof e.location?.file == "string" ? e.location.file : "",message = String(e.text ?? e.message ?? error);
+		const e = error ?? {},file = typeof e.location?.file == "string" ? e.location.file : "",message = String(e.text ?? e.message ?? error);
 		return { file, message };
 	});
 }
@@ -1585,8 +1576,8 @@ function parseTextFrame(buffer) {
 //#endregion
 //#region hmr-channel.ts
 function extractErrorText(error) {
-	const e = (error ?? {});
-	return ((typeof e.stack == "string" && e.stack) || (typeof e.message == "string" && e.message) || String(error));
+	const e = error ?? {};
+	return typeof e.stack == "string" && e.stack || typeof e.message == "string" && e.message || String(error);
 }
 function createHmrChannel() {
 	const nodeSockets = new Set(),bunClients = new Set(),incomingHandlers = [],connectedText = JSON.stringify({ type: HMR_MSG.Connected });
@@ -1614,14 +1605,15 @@ function createHmrChannel() {
 		let recvBuffer = Buffer.alloc(0);
 		socket.on("data", (chunk) => {
 			if (incomingHandlers.length === 0)return;
-			recvBuffer = (recvBuffer.length === 0 ? chunk : Buffer.concat([recvBuffer, chunk]));
+			recvBuffer = recvBuffer.length === 0 ? chunk : Buffer.concat([recvBuffer, chunk]);
+			const reply = (text) => writeTextFrame(socket, text);
 			while (recvBuffer.length > 0) {
 				const parsed = parseTextFrame(recvBuffer);
 				if (!parsed)break;
 				recvBuffer = recvBuffer.subarray(parsed.consumed);
 				for (const handler of incomingHandlers) {
 					try {
-						handler(parsed.text, socket);
+						handler(parsed.text, reply);
 					} catch {
 					}
 				}
@@ -1635,6 +1627,15 @@ function createHmrChannel() {
 		greetBun(ws);
 	}, removeBunClient(ws) {
 		bunClients.delete(ws);
+	}, dispatchBunIncoming(ws,text) {
+		if (incomingHandlers.length === 0)return;
+		const reply = (out) => ws.send(out);
+		for (const handler of incomingHandlers) {
+			try {
+				handler(text, reply);
+			} catch {
+			}
+		}
 	}, onIncoming(handler) {
 		incomingHandlers.push(handler);
 	}, broadcast(message) {
@@ -1698,7 +1699,7 @@ const BANNER_WIDTH = 59;
 function bannerLine(content) {
 	const visibleLen = content.replace(/\x1b\[[0-9;]*m/g, "").length,padding = Math.max(0, BANNER_WIDTH - visibleLen),left = Math.floor(padding / 2);
 	;
-	return `${colors.cyan}    ║${colors.reset}${" ".repeat(left)}${content}${" ".repeat((padding - left))}${colors.cyan}║${colors.reset}`;
+	return `${colors.cyan}    ║${colors.reset}${" ".repeat(left)}${content}${" ".repeat(padding - left)}${colors.cyan}║${colors.reset}`;
 }
 const ZNTC_ASCII = ["▀▀▀▀▀▀▀▀", "▀▀▀▀▀▀▀▀▀▀▀▀", "▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀", "▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀", "▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀"],ZNTC_GRADIENT = [colors.brightYellow, colors.brightYellow, colors.yellow, colors.brightRed, colors.brightRed];
 if (ZNTC_ASCII.length !== ZNTC_GRADIENT.length) {
@@ -1736,7 +1737,8 @@ function buildOnRebuild(adapter,opts={}) {
 			const annotated = annotateUpdates(event.updates, state.platform);
 			adapter.sendUpdate(annotated);
 			if (!opts.silent) {
-				logInfo(`HMR update ${colors.dim}[${state.platform}] ${event.updates.length} module(s) (${ms}ms)${colors.reset}`);
+				const profileOn = process.env.ZNTC_PROFILE != null && process.env.ZNTC_PROFILE !== "",pd = profileOn ? event.phaseDurations : undefined,r = (n) => n == null ? "-" : n.toFixed(0),bd = pd ? ` ${colors.dim}[det=${r(pd.detect)} grph=${r(pd.graph)} lnk=${r(pd.link)} shk=${r(pd.shake)} emt=${r(pd.emit)} dlt=${r(pd.delta)} | gDisc=${r(pd.graphDiscover)} gBld=${r(pd.graphBuild)} eOut=${r(pd.emitOutput)} eMod=${r(pd.emitModulePass)} eCat=${r(pd.emitConcat)}]${colors.reset}` : "";
+				logInfo(`HMR update ${colors.dim}[${state.platform}] ${event.updates.length} module(s) (${ms}ms)${colors.reset}${bd}`);
 			}
 			return;
 		}
@@ -1746,7 +1748,7 @@ function buildOnRebuild(adapter,opts={}) {
 	};
 }
 function buildIncomingHandler(adapter,getLogsEnabled) {
-	return (text, socket) => {
+	return (text, reply) => {
 		let msg = null;
 		try {
 			msg = JSON.parse(text);
@@ -1755,7 +1757,7 @@ function buildIncomingHandler(adapter,getLogsEnabled) {
 		}
 		if (!msg || typeof msg.type != "string")return;
 		if (msg.type === "register-entrypoints") {
-			socket.write(buildAckFrame());
+			reply(ACK_TEXT);
 			return;
 		}
 		if (msg.type === "log") {
@@ -1776,10 +1778,6 @@ function buildIncomingHandler(adapter,getLogsEnabled) {
 	};
 }
 const ACK_TEXT = JSON.stringify({ type: "bundle-registered" });
-function buildAckFrame() {
-	const payload = Buffer.from(ACK_TEXT);
-	return Buffer.concat([Buffer.from([0x81, payload.length]), payload]);
-}
 function createHmrBridge(options) {
 	const adapter = createMetroHmrAdapter(),onRebuild = buildOnRebuild(adapter, { silent: options.silent });
 	let logsEnabled = options.forwardClientLogs !== false;
@@ -1787,12 +1785,118 @@ function createHmrBridge(options) {
 	return { adapter, callbacks: { onRebuild }, path: options.path, acceptUpgrade(req,socket) {
 		adapter.channel.accept(req, socket);
 		adapter.sendInitialGreeting();
+	}, acceptBun(ws) {
+		adapter.channel.addBunClient(ws);
+		adapter.sendInitialGreeting();
+	}, removeBun(ws) {
+		adapter.channel.removeBunClient(ws);
+	}, handleBunMessage(ws,text) {
+		adapter.channel.dispatchBunIncoming(ws, text);
 	}, toggleLogs() {
 		logsEnabled = !logsEnabled;
 		return logsEnabled;
 	} };
 }
 //#endregion
+//#region bun-http-adapter.ts
+function createResponseShim(done) {
+	const captured = { statusCode: 200, headers: {}, chunks: [] };
+	let ended = false,headersSent = false;
+	const applyHeaders = (headers) => {
+		if (!headers)return;
+		for (const [k, v] of Object.entries(headers)) {
+			captured.headers[k.toLowerCase()] = Array.isArray(v) ? v.join(", ") : String(v);
+		}
+	},shim = { get statusCode() {
+		return captured.statusCode;
+	}, set statusCode(code) {
+		captured.statusCode = code;
+	}, get headersSent() {
+		return headersSent;
+	}, get writableEnded() {
+		return ended;
+	}, setHeader(name,value) {
+		captured.headers[String(name).toLowerCase()] = Array.isArray(value) ? value.join(", ") : String(value);
+	}, getHeader(name) {
+		return captured.headers[String(name).toLowerCase()];
+	}, writeHead(statusCode,headersOrReason,maybeHeaders) {
+		captured.statusCode = statusCode;
+		const headers = headersOrReason && typeof headersOrReason == "object" ? headersOrReason : maybeHeaders ?? undefined;
+		applyHeaders(headers);
+		headersSent = true;
+		return shim;
+	}, write(chunk) {
+		if (chunk != null) {
+			captured.chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk)));
+		}
+		headersSent = true;
+		return true;
+	}, end(chunk) {
+		if (ended)return shim;
+		if (chunk != null) {
+			captured.chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk)));
+		}
+		ended = true;
+		headersSent = true;
+		done(captured);
+		return shim;
+	} };
+	return { res: shim, captured };
+}
+function createRequestShim(req,rawBody) {
+	const u = new URL(req.url),headers = {};
+	req.headers.forEach((value, key) => {
+		headers[key.toLowerCase()] = value;
+	});
+	const shim = { url: u.pathname + u.search, method: req.method, headers, complete: true, readable: false, rawBody, on() {
+		return shim;
+	} };
+	return shim;
+}
+async function runMiddlewareForBun(middleware,req) {
+	let rawBody = null;
+	if (req.method !== "GET" && req.method !== "HEAD") {
+		try {
+			rawBody = await req.text();
+		} catch {
+			rawBody = null;
+		}
+	}
+	const reqShim = createRequestShim(req, rawBody);
+	return new Promise((resolve) => {
+		let settled = false;
+		const toResponse = (c) => {
+			const body = c.chunks.length === 0 ? null : new Uint8Array(Buffer.concat(c.chunks));
+			return new Response(body, { status: c.statusCode, headers: c.headers });
+		},{ res:res } = createResponseShim((captured) => {
+			if (settled)return;
+			settled = true;
+			resolve(toResponse(captured));
+		});
+		try {
+			middleware(reqShim, res, (err) => {
+				if (settled)return;
+				settled = true;
+				if (err) {
+					const msg = err?.message ?? String(err);
+					resolve(new Response(`Internal Server Error: ${msg}`, { status: 500 }));
+					return;
+				}
+				if (!res.headersSent && !res.writableEnded) {
+					resolve(new Response("Not Found", { status: 404 }));
+					return;
+				}
+				resolve(new Response(null, { status: res.statusCode }));
+			});
+		} catch (err) {
+			if (settled)return;
+			settled = true;
+			const msg = err?.message ?? String(err);
+			resolve(new Response(`Internal Server Error: ${msg}`, { status: 500 }));
+		}
+	});
+}
+//#endregion
 //#region http-utils.ts
 function sendText(res,statusCode,text,contentType="text/plain") {
 	res.writeHead(statusCode, { "Content-Type": contentType, "Content-Length": Buffer.byteLength(text) });
@@ -1979,7 +2083,7 @@ function resolveAssetPath(urlPathname,opts) {
 	}
 	if (normalizedPath.startsWith("node_modules")) {
 		try {
-			const modulePath = normalizedPath.replace(/^node_modules[/\\]/, ""),packageName = modulePath.startsWith("@") ? (modulePath.match(/^(@[^/\\]+[/\\][^/\\]+)/)?.[1] ?? modulePath.split(sep)[0]) : modulePath.split(sep)[0];
+			const modulePath = normalizedPath.replace(/^node_modules[/\\]/, ""),packageName = modulePath.startsWith("@") ? modulePath.match(/^(@[^/\\]+[/\\][^/\\]+)/)?.[1] ?? modulePath.split(sep)[0] : modulePath.split(sep)[0];
 			if (!packageName)return null;
 			const packageRelativePath = modulePath.slice(packageName.length + 1);
 			let packageJsonPath;
@@ -2024,7 +2128,7 @@ async function handleAssetRequest(_req,res,url,opts) {
 		const ext = extname(resolved).toLowerCase();
 		;
 		const content = await readFile(resolved);
-		res.writeHead(200, { "Content-Type": (CONTENT_TYPE_MAP[ext] ?? "application/octet-stream"), "Cache-Control": "public, max-age=31536000", "Content-Length": content.length });
+		res.writeHead(200, { "Content-Type": CONTENT_TYPE_MAP[ext] ?? "application/octet-stream", "Cache-Control": "public, max-age=31536000", "Content-Length": content.length });
 		res.end(content);
 	} catch {
 		sendText(res, 500, "Internal Server Error");
@@ -2122,7 +2226,10 @@ function createMetroResolveRequestPlugin(opts) {
 			try {
 				const result = resolveRequest({ originModulePath: args.importer ?? "", platform: metroPlatform, resolveRequest: fallbackResolver }, args.path, metroPlatform);
 				if (result.type === "sourceFile")return { path: result.filePath };
-				if (result.type === "assetFiles")return { path: result.filePaths[0] ?? args.path };
+				if (result.type === "assetFiles") {
+					const assetPath = result.filePaths[0];
+					return assetPath ? { path: assetPath } : null;
+				}
 				if (result.type === "empty")return { disabled: true };
 			} catch (err) {
 				if (err.message === DELEGATE_TO_DEFAULT_SENTINEL)return null;
@@ -2276,7 +2383,7 @@ function deepMerge(base,override) {
 	return result;
 }
 function buildRnBundleOptions(input) {
-	const { entry:entry, projectRoot:projectRoot, rnPlatform:rnPlatform, dev:dev, sourcemap:sourcemap, minify:minify, dropConsole:dropConsole, dropDebugger:dropDebugger, extra:extra } = input;
+	const { entry:entry, projectRoot:projectRoot, rnPlatform:rnPlatform, dev:dev, sourcemap:sourcemap, minify:minify, watchDelay:watchDelay, dropConsole:dropConsole, dropDebugger:dropDebugger, extra:extra } = input;
 	if (extra?.platforms && !extra.platforms.includes(rnPlatform)) {
 		throw new Error(`extra.platforms (${JSON.stringify(extra.platforms)}) does not include the active rnPlatform '${rnPlatform}'`);
 	}
@@ -2299,7 +2406,7 @@ function buildRnBundleOptions(input) {
 	if (extra?.prelude && extra.prelude.length > 0) {
 		for (const p of extra.prelude)runBeforeMain.push(resolve$4(projectRoot, p));
 	}
-	const define = { global: "__ZNTC_RN_GLOBAL__", __DEV__: String(dev), "process.env.NODE_ENV": `"${dev ? "development" : "production"}"`, "process.env.EXPO_ROUTER_APP_ROOT": JSON.stringify(resolve$4(projectRoot, "app")), "process.env.EXPO_ROUTER_IMPORT_MODE": "\"sync\"", "process.env.EXPO_OS": `"${rnPlatform}"` },baseLoader = buildAssetLoaders(assetExts),preset = { entryPoints: [resolve$4(projectRoot, entry)], platform: "react-native", sourcemap: sourcemap ?? dev, minify: minify ?? false, dropConsole: dropConsole ?? false, dropDebugger: dropDebugger ?? false, plugins, emitDiskSourcemap: !dev, target: "es5", flow: true, jsxInJs: true, configurableExports: true, strictExecutionOrder: true, inlineDynamicImports: true, workletTransform: true, codegenTransform: true, resolveExtensions: buildResolveExtensions(rnPlatform, sourceExts), mainFields: ["react-native", "browser", "main"], loader: baseLoader, alias: buildRnSingletonAliases(projectRoot), preserveSymlinks: true, resolveSymlinkSiblings: true, define, banner: buildPrelude(input), globalIdentifiers: [...RN_GLOBAL_IDENTIFIERS] };
+	const define = { global: "__ZNTC_RN_GLOBAL__", __DEV__: String(dev), "process.env.NODE_ENV": `"${dev ? "development" : "production"}"`, "process.env.EXPO_ROUTER_APP_ROOT": JSON.stringify(resolve$4(projectRoot, "app")), "process.env.EXPO_ROUTER_IMPORT_MODE": "\"sync\"", "process.env.EXPO_OS": `"${rnPlatform}"` },baseLoader = buildAssetLoaders(assetExts),preset = { entryPoints: [resolve$4(projectRoot, entry)], platform: "react-native", sourcemap: sourcemap ?? dev, minify: minify ?? false, ...watchDelay !== undefined ? { watchDelay } : {}, dropConsole: dropConsole ?? false, dropDebugger: dropDebugger ?? false, plugins, emitDiskSourcemap: !dev, target: "es5", flow: true, jsxInJs: true, configurableExports: true, strictExecutionOrder: true, inlineDynamicImports: true, workletTransform: true, codegenTransform: true, preserveSafePlugins: extra?.preserveSafePlugins ?? !(extra?.additionalPlugins && extra.additionalPlugins.length > 0 || extra?.metroResolveRequest || extra?.babelTransformerPath), resolveExtensions: buildResolveExtensions(rnPlatform, sourceExts), mainFields: ["react-native", "browser", "main"], loader: baseLoader, alias: buildRnSingletonAliases(projectRoot), preserveSymlinks: true, resolveSymlinkSiblings: true, define, banner: buildPrelude(input), globalIdentifiers: [...RN_GLOBAL_IDENTIFIERS] };
 	if (polyfills.length > 0)preset.polyfills = polyfills;
 	if (runBeforeMain.length > 0)preset.runBeforeMain = runBeforeMain;
 	const workletVersion = resolveWorkletPluginVersion(projectRoot, input.workletPluginVersion);
@@ -2366,7 +2473,7 @@ function isVirtualSource(stripped) {
 function isFrameworkSource(src) {
 	if (typeof src != "string")return false;
 	const stripped = stripVirtualPrefix(src);
-	return (stripped === "__prelude__" || stripped.includes("?ctx=") || /(?:^|[/\\])node_modules[/\\]/.test(stripped) || stripped.startsWith("zntc:"));
+	return stripped === "__prelude__" || stripped.includes("?ctx=") || /(?:^|[/\\])node_modules[/\\]/.test(stripped) || stripped.startsWith("zntc:");
 }
 function postProcessSourceMap(rawJson,pathOpts) {
 	try {
@@ -2376,7 +2483,7 @@ function postProcessSourceMap(rawJson,pathOpts) {
 		if (pathOpts?.sourceRoot === undefined && map.sourceRoot === "") {
 			delete map.sourceRoot;
 		}
-		const existing = new Set([...(Array.isArray(map.x_google_ignoreList) ? map.x_google_ignoreList : []), ...(Array.isArray(map.ignoreList) ? map.ignoreList : [])].filter((v) => Number.isInteger(v) && v >= 0));
+		const existing = new Set([...Array.isArray(map.x_google_ignoreList) ? map.x_google_ignoreList : [], ...Array.isArray(map.ignoreList) ? map.ignoreList : []].filter((v) => Number.isInteger(v) && v >= 0));
 		for (let i = 0; i < map.sources.length; i++) {
 			if (isFrameworkSource(map.sources[i]))existing.add(i);
 		}
@@ -2427,28 +2534,42 @@ function getBundleText(result) {
 function getBundleSourceMapText(result) {
 	return result.outputFiles.find((file) => file.path.endsWith(".map"))?.text ?? null;
 }
-function createPlatformState(options,platform,callbacks) {
-	const outputDir = mkdtempSync(join$2(tmpdir(), `zntc-rn-${platform}-`)),outputPath = join$2(outputDir, "bundle.js"),platformBundle = { ...options.bundle, rnPlatform: platform };
-	let refreshPromise = null;
-	const state = { platform, outputDir, outputPath, handle: undefined, bundle: null, bundleStale: false, refreshBundle: () => refreshPlatformBundle(), sourceMapCache: null, buildError: null, fileCount: 1, lastRebuildTime: Date.now() };
-	function refreshPlatformBundle() {
-		if (!state.bundleStale && state.bundle !== null)return Promise.resolve();
-		if (refreshPromise)return refreshPromise;
-		refreshPromise = bundleRn(platformBundle).then((result) => {
-			state.bundle = getBundleText(result);
-			const sourceMap = getBundleSourceMapText(result);
-			state.sourceMapCache = sourceMap ? postProcessSourceMap(sourceMap) : null;
-			state.buildError = null;
-			state.bundleStale = false;
-		}).catch((err) => {
-			state.bundle = null;
-			state.buildError = err instanceof Error ? err.message : String(err);
-			state.bundleStale = false;
+function createBundleRefresher(deps) {
+	let inFlight = null,generation = 0;
+	function markStale() {
+		deps.setStale();
+		generation += 1;
+	}
+	function refresh() {
+		if (deps.isFresh())return Promise.resolve();
+		if (inFlight)return inFlight;
+		const startGen = generation;
+		inFlight = deps.build().then(() => {
+			if (generation === startGen)deps.clearStale();
 		}).finally(() => {
-			refreshPromise = null;
+			inFlight = null;
 		});
-		return refreshPromise;
+		return inFlight;
 	}
+	return { markStale, refresh };
+}
+function createPlatformState(options,platform,callbacks) {
+	const outputDir = mkdtempSync(join$2(tmpdir(), `zntc-rn-${platform}-`)),outputPath = join$2(outputDir, "bundle.js"),platformBundle = { ...options.bundle, rnPlatform: platform };
+	let refresher;
+	const state = { platform, outputDir, outputPath, handle: undefined, bundle: null, bundleStale: false, refreshBundle: () => refresher.refresh(), sourceMapCache: null, buildError: null, fileCount: 1, lastRebuildTime: Date.now() };
+	refresher = createBundleRefresher({ isFresh: () => !state.bundleStale && state.bundle !== null, build: () => bundleRn(platformBundle).then((result) => {
+		state.bundle = getBundleText(result);
+		const sourceMap = getBundleSourceMapText(result);
+		state.sourceMapCache = sourceMap ? postProcessSourceMap(sourceMap) : null;
+		state.buildError = null;
+	}).catch((err) => {
+		state.bundle = null;
+		state.buildError = err instanceof Error ? err.message : String(err);
+	}), setStale: () => {
+		state.bundleStale = true;
+	}, clearStale: () => {
+		state.bundleStale = false;
+	} });
 	if (process.env.ZNTC_DEBUG_TERMINAL === "1") {
 		process.stderr.write(`[zntc:rn-dev:debug] watchRn[${platform}] sourcemap=${platformBundle.sourcemap} dev=${platformBundle.dev} outfile=${outputPath}\n`);
 	}
@@ -2472,7 +2593,7 @@ function createPlatformState(options,platform,callbacks) {
 		state.sourceMapCache = null;
 		if (platformBundle.dev) {
 			if (event.graphChanged) {
-				state.bundleStale = true;
+				refresher.markStale();
 				return state.refreshBundle().then(() => {
 					if (state.buildError) {
 						callbacks?.onRebuild?.(state, { ...event, success: false, error: state.buildError });
@@ -2482,7 +2603,7 @@ function createPlatformState(options,platform,callbacks) {
 				});
 			}
 			if (event.updates && event.updates.length > 0) {
-				state.bundleStale = true;
+				refresher.markStale();
 			}
 			callbacks?.onRebuild?.(state, event);
 			return;
@@ -2527,7 +2648,7 @@ function createPlatformStateRegistry(options,callbacks) {
 function resolvePlatform(url,registry,defaultPlatform) {
 	const param = url.searchParams.get("platform");
 	;
-	return registry.getOrCreate((param === "ios" || param === "android" ? param : defaultPlatform));
+	return registry.getOrCreate(param === "ios" || param === "android" ? param : defaultPlatform);
 }
 //#endregion
 //#region bundle.ts
@@ -2653,9 +2774,23 @@ function isOpenUrlRoute(pathname,method) {
 }
 function resolveOpener(platform=process.platform) {
 	if (platform === "darwin")return { command: "open", args: (t) => [t] };
-	if (platform === "win32")return { command: "cmd", args: (t) => ["/c", "start", "", t] };
+	if (platform === "win32")return { command: "rundll32", args: (t) => ["url.dll,FileProtocolHandler", t] };
 	return { command: "xdg-open", args: (t) => [t] };
 }
+const ALLOWED_PROTOCOLS = new Set(["http:", "https:"]);
+function isSafeBrowserUrl(target) {
+	for (let i = 0; i < target.length; i += 1) {
+		const c = target.charCodeAt(i);
+		if (c <= 0x20 || c === 0x22 || c === 0x27 || c === 0x5c)return false;
+	}
+	let parsed;
+	try {
+		parsed = new URL(target);
+	} catch {
+		return false;
+	}
+	return ALLOWED_PROTOCOLS.has(parsed.protocol);
+}
 async function handleOpenUrl(req,res,spawner=spawn,platform=process.platform) {
 	let body = {};
 	try {
@@ -2669,6 +2804,10 @@ async function handleOpenUrl(req,res,spawner=spawn,platform=process.platform) {
 		sendJson(res, 400, { error: "Invalid URL" });
 		return;
 	}
+	if (!isSafeBrowserUrl(target)) {
+		sendJson(res, 400, { error: "URL must be an http(s) URL without control characters" });
+		return;
+	}
 	try {
 		const { command:command, args:args } = resolveOpener(platform),child = spawner(command, args(target), { detached: true, stdio: "ignore" });
 		child.unref();
@@ -2706,7 +2845,7 @@ async function createSourceMapConsumer(sourceMapJson) {
 		return null;
 	}
 	try {
-		const mod = (await Promise.resolve().then(()=>require_source_map_source_map()));
+		const mod = await Promise.resolve().then(()=>require_source_map_source_map());
 		return await new mod.SourceMapConsumer(parsed);
 	} catch {
 		return null;
@@ -2914,7 +3053,53 @@ async function createDevHttpServer(options,deps) {
 	return { server, url: `http://${options.host}:${options.port}`, port: options.port, stop: () => new Promise((resolve, reject) => {
 		server.removeListener("request", requestHandler);
 		if (upgradeHandler)server.removeListener("upgrade", upgradeHandler);
-		server.close((err) => (err ? reject(err) : resolve()));
+		server.close((err) => err ? reject(err) : resolve());
+	}) };
+}
+function createBunHttpServerShim() {
+	let warned = false;
+	const shim = { on(event) {
+		if (event === "upgrade" && !warned) {
+			warned = true;
+			process.stderr.write(`[zntc:rn-dev] Bun runtime: enhanceMiddleware 의 httpServer.on('upgrade') 는 ` + `Bun.serve 에서 지원되지 않습니다(raw socket 미노출). HMR(/hot)은 정상 동작하나 ` + `WebSocket upgrade 에 의존하는 enhanceMiddleware 기능(Rozenite 등)은 제한됩니다.\n`);
+		}
+		return shim;
+	}, once() {
+		return shim;
+	}, removeListener() {
+		return shim;
+	}, off() {
+		return shim;
+	}, address() {
+		return { port: 0 };
+	} };
+	return shim;
+}
+async function createBunDevHttpServer(options,deps) {
+	const Bun = globalThis.Bun;
+	if (!Bun)throw new Error("createBunDevHttpServer는 Bun runtime에서만 호출 가능합니다.");
+	const baseMiddleware = createBaseMiddleware(options, deps),enhanced = options.enhanceMiddleware ? options.enhanceMiddleware(baseMiddleware, { httpServer: createBunHttpServerShim() }) : baseMiddleware,hmr = deps.hmrBridge,serveOpts = { port: options.port, hostname: options.host, async fetch(req,server) {
+		const url = new URL(req.url);
+		if (hmr && (url.pathname === hmr.path || url.pathname.startsWith(`${hmr.path}?`))) {
+			if (server.upgrade(req))return undefined;
+			return new Response("Upgrade required", { status: 426 });
+		}
+		return runMiddlewareForBun(enhanced, req);
+	} };
+	if (hmr) {
+		serveOpts.websocket = { open(ws) {
+			hmr.acceptBun(ws);
+		}, message(ws,message) {
+			const text = typeof message == "string" ? message : message.toString("utf-8");
+			hmr.handleBunMessage(ws, text);
+		}, close(ws) {
+			hmr.removeBun(ws);
+		} };
+	}
+	const server = Bun.serve(serveOpts);
+	return { server: server, url: `http://${options.host}:${server.port}`, port: server.port, stop: () => new Promise((resolve) => {
+		server.stop(true);
+		resolve();
 	}) };
 }
 //#endregion
@@ -2937,7 +3122,7 @@ function resolveCliServerApiPath(projectRoot) {
 }
 async function loadCliServerApi(options) {
 	try {
-		const resolvedPath = resolveCliServerApiPath(options.projectRoot),mod = (await import(resolvedPath)),result = mod.createDevServerMiddleware({ port: options.port, host: options.host, watchFolders: [] });
+		const resolvedPath = resolveCliServerApiPath(options.projectRoot),mod = await import(resolvedPath),result = mod.createDevServerMiddleware({ port: options.port, host: options.host, watchFolders: [] });
 		return { websocketEndpoints: result.websocketEndpoints, broadcast: result.messageSocketEndpoint.broadcast };
 	} catch (err) {
 		if (process.env.ZNTC_DEBUG_TERMINAL === "1") {
@@ -3130,7 +3315,9 @@ async function serveRn(options,extras={}) {
 		process.stderr.write(`[zntc:rn-dev:debug] cli-server-api: ${cliServerApi ? "loaded" : "null (peer 미설치 또는 load 실패)"}\n`);
 		process.stderr.write(`[zntc:rn-dev:debug] dev-middleware: ${devMiddleware ? "loaded" : "null (peer 미설치)"}\n`);
 	}
-	const hmrBridge = options.hmr ? createHmrBridge({ path: HMR_PATH, silent: extras.silent, forwardClientLogs: options.bundle.extra?.forwardClientLogs }) : undefined,platforms = createPlatformStateRegistry(options, hmrBridge?.callbacks),httpHandle = await createDevHttpServer(options, { broadcast, platforms, hmrBridge, devMiddleware: devMiddleware ?? undefined, cliServerApi: cliServerApi ?? undefined }),buildStart = Date.now(),firstState = platforms.getOrCreate(options.bundle.rnPlatform);
+	const hmrBridge = options.hmr ? createHmrBridge({ path: HMR_PATH, silent: extras.silent, forwardClientLogs: options.bundle.extra?.forwardClientLogs }) : undefined,platforms = createPlatformStateRegistry(options, hmrBridge?.callbacks),isBun = typeof globalThis.Bun < "u";
+	;
+	const httpHandle = await (isBun ? createBunDevHttpServer : createDevHttpServer)(options, { broadcast, platforms, hmrBridge, devMiddleware: devMiddleware ?? undefined, cliServerApi: cliServerApi ?? undefined }),buildStart = Date.now(),firstState = platforms.getOrCreate(options.bundle.rnPlatform);
 	await waitForBuild(firstState);
 	if (!extras.silent) {
 		if (firstState.buildError) {
@@ -3238,7 +3425,7 @@ function parserPluginsFor(filename) {
 }
 function isRootImportPluginName(name) {
 	const normalized = name.replace(/\\/g, "/");
-	return (normalized === "root-import" || normalized === "babel-plugin-root-import" || normalized.endsWith("/babel-plugin-root-import") || normalized.includes("/babel-plugin-root-import/"));
+	return normalized === "root-import" || normalized === "babel-plugin-root-import" || normalized.endsWith("/babel-plugin-root-import") || normalized.includes("/babel-plugin-root-import/");
 }
 function injectRootImportRootOption(options,projectRoot) {
 	const next = options ? { ...options } : {},paths = next.paths;
@@ -3463,9 +3650,9 @@ function withExpo(config) {
 	if (winter)expoModules.push(winter);
 	if (metroRuntime)expoModules.push(metroRuntime);
 	const existingAssetExts = config.resolver?.assetExts ?? [],existingNormalized = new Set(existingAssetExts.map(normalizeExt));
-	return { ...config, resolver: { ...config.resolver, assetExts: [...existingAssetExts, ...EXPO_ASSET_EXTS.filter((ext) => !existingNormalized.has(ext))], blockList: [...(config.resolver?.blockList ?? []), ...EXPO_BLOCK_LIST] }, serializer: { ...config.serializer, prelude: [...(config.serializer?.prelude ?? []), ...expoModules] }, server: { ...config.server, silentConsoleErrorPatterns: [...(config.server?.silentConsoleErrorPatterns ?? []), WINTER_POLYFILL_WARNING_PATTERN] } };
+	return { ...config, resolver: { ...config.resolver, assetExts: [...existingAssetExts, ...EXPO_ASSET_EXTS.filter((ext) => !existingNormalized.has(ext))], blockList: [...config.resolver?.blockList ?? [], ...EXPO_BLOCK_LIST] }, serializer: { ...config.serializer, prelude: [...config.serializer?.prelude ?? [], ...expoModules] }, server: { ...config.server, silentConsoleErrorPatterns: [...config.server?.silentConsoleErrorPatterns ?? [], WINTER_POLYFILL_WARNING_PATTERN] } };
 }
 //#endregion
 //#region index.ts
-export { HMR_RN_MSG, buildRnDevServerOptions, createBaseMiddleware, createDevHttpServer, createHmrBridge, createPlatformState, loadCliServerApi, loadDevMiddleware, createPlatformStateRegistry, getCachedSourceMap, applyCustomizeFrame, createSourceMapConsumer, extractCodeFrame, handleAssetRequest, handleBundleRequest, handleHmrMapRequest, handleIndexPage, handleMapRequest, handleSymbolicateRequest, isIndexRoute, isAssetRoute, isBundleRoute, isHmrMapRoute, isMapRoute, isSymbolicateRoute, normalizeFrame, symbolicateFrame, colors, formatLogBadge, logBundle, logError, logInfo, logWarn, postProcessSourceMap, printZntcRnBanner, resolveAssetPath, serveRn, setupTerminalActions, waitForBuild, createMetroHmrAdapter, createAssetPlugin, createBabelPlugin, createBabelTransformer, detectCustomPlugins, isZntcNativePlugin, ZNTC_NATIVE_PLUGIN_PATTERNS, CODEGEN_NATIVE_COMPONENT_MARKER, createCodegenPlugin, createCodegenTransformer, escapeRegex, createMetroResolveRequestPlugin, createRequireContextPlugin, createStyledComponentsNativePlugin, disableStyledComponentsNativeDomProbe, STYLED_COMPONENTS_NATIVE_PATH_RE, buildRnBundleOptions, bundleRn, DEFAULT_ASSET_EXTS, watchRn, resolveRnPolyfills, RN_GLOBAL_IDENTIFIERS, tryResolve, HMR_CLIENT_SUFFIX, ZNTC_HMR_CLIENT_CODE, detectExpo, WINTER_POLYFILL_WARNING_PATTERN, withExpo };
+export { HMR_RN_MSG, buildRnDevServerOptions, createBaseMiddleware, createBunDevHttpServer, createDevHttpServer, createHmrBridge, createPlatformState, loadCliServerApi, loadDevMiddleware, createPlatformStateRegistry, getCachedSourceMap, applyCustomizeFrame, createSourceMapConsumer, extractCodeFrame, handleAssetRequest, handleBundleRequest, handleHmrMapRequest, handleIndexPage, handleMapRequest, handleSymbolicateRequest, isIndexRoute, isAssetRoute, isBundleRoute, isHmrMapRoute, isMapRoute, isSymbolicateRoute, normalizeFrame, symbolicateFrame, colors, formatLogBadge, logBundle, logError, logInfo, logWarn, postProcessSourceMap, printZntcRnBanner, resolveAssetPath, serveRn, setupTerminalActions, waitForBuild, createMetroHmrAdapter, createAssetPlugin, createBabelPlugin, createBabelTransformer, detectCustomPlugins, isZntcNativePlugin, ZNTC_NATIVE_PLUGIN_PATTERNS, CODEGEN_NATIVE_COMPONENT_MARKER, createCodegenPlugin, createCodegenTransformer, escapeRegex, createMetroResolveRequestPlugin, createRequireContextPlugin, createStyledComponentsNativePlugin, disableStyledComponentsNativeDomProbe, STYLED_COMPONENTS_NATIVE_PATH_RE, buildRnBundleOptions, bundleRn, DEFAULT_ASSET_EXTS, watchRn, resolveRnPolyfills, RN_GLOBAL_IDENTIFIERS, tryResolve, HMR_CLIENT_SUFFIX, ZNTC_HMR_CLIENT_CODE, detectExpo, WINTER_POLYFILL_WARNING_PATTERN, withExpo };
 //#endregion

package/dist/preset.d.ts

@@ -12,6 +12,8 @@ export interface RnBundleInput {
     dev: boolean;
     /** sourcemap emit. dev 시 inline 권장. */
     sourcemap?: boolean;
+    /** watch 디바운스(ms) — dev server watch 의 첫 이벤트 후 idle 병합 윈도우. 기본 16(native). */
+    watchDelay?: number;
     /** prod build 의 minify. */
     minify?: boolean;
     /** console.* 호출 제거. Metro production Babel plugin 과 같은 정책을 원하는 release 경로에서 사용. */
@@ -49,6 +51,15 @@ export interface RnBundleInput {
         metroResolveRequest?: CustomResolver;
         /** Metro 호환 babel transformer path (svg-transformer 등). */
         babelTransformerPath?: string;
+        /**
+         * HMR 위상 보존 plugin 게이트 명시 override. 미지정(undefined)이면 preset 이 보수적으로
+         * 판정한다 — 내장 plugin 만이면 true, additionalPlugins/metroResolveRequest/
+         * babelTransformerPath 중 하나라도 있으면 false. 사용자가 "내 resolver/transformer 가
+         * 결정적·모듈별 순수(같은 입력→같은 출력, 전역 상태 무의존)"임을 보장할 수 있으면 true 로
+         * 명시해 보존을 강제(=HMR rebuild 가속)할 수 있다. 비결정이면 stale 번들 위험은 사용자 책임.
+         * false 명시로 강제 비활성도 가능.
+         */
+        preserveSafePlugins?: boolean;
         /** RN sourceExts override (default RN preset). */
         sourceExts?: string[];
         /** RN assetExts override (default RN preset). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zntc/react-native",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "ZNTC React Native platform — Metro HMR adapter + RN preset (buildRnBundleOptions) + plugin factories + RN runtime",
   "keywords": [
     "bundler",
@@ -48,13 +48,13 @@
   },
   "dependencies": {
     "@react-native-community/cli-server-api": "^15.0.0",
-    "@zntc/core": "0.1.1",
+    "@zntc/core": "0.1.3",
     "jsc-safe-url": "^0.2.4",
     "source-map": "^0.7.4"
   },
   "devDependencies": {
     "@types/node": "^25.5.2",
-    "@zntc/server": "0.1.1"
+    "@zntc/server": "0.1.3"
   },
   "optionalDependencies": {
     "@babel/core": "^7.26.0",

package/runtime/zntc-hmr-client.cjs

@@ -5,8 +5,9 @@
  */
 'use strict';
 
-var REFRESH_TEXT_COLOR = -1; // #ffffff
-var REFRESH_BACKGROUND_COLOR = -14318360; // #2584e8
+// JSI 는 색상을 uint32 로 기대 — 음수(-1)는 HostFunction throw 위험. unsigned hex 사용.
+var REFRESH_TEXT_COLOR = 0xffffffff; // #ffffff
+var REFRESH_BACKGROUND_COLOR = 0xff2584e8; // #2584e8
 var BUFFER_LIMIT = 1024 * 1024;
 var prettyFormat = require('pretty-format');
 var prettyFormatImpl = prettyFormat && (prettyFormat.default || prettyFormat);
@@ -68,13 +69,10 @@ function getDirectNativeDevLoadingView() {
 
 function wrapNativeDevLoadingView(nativeDevLoadingView) {
   return {
-    showMessage: function (message, _type, options) {
-      nativeDevLoadingView.showMessage(
-        message,
-        REFRESH_TEXT_COLOR,
-        REFRESH_BACKGROUND_COLOR,
-        !!(options && options.dismissButton),
-      );
+    showMessage: function (message, _type, _options) {
+      // native DevLoadingView.showMessage 시그니처는 (message, color, backgroundColor) 3개.
+      // 4번째 인자를 넘기면 JSI HostFunction 이 arg-count mismatch 로 throw → 배너 미표시.
+      nativeDevLoadingView.showMessage(message, REFRESH_TEXT_COLOR, REFRESH_BACKGROUND_COLOR);
     },
     hide: function () {
       nativeDevLoadingView.hide();
@@ -136,11 +134,25 @@ var HMRClient = {
   },
 
   _showRefreshing: function () {
+    this._showTime = Date.now();
     this._safeCallDlv('showMessage', ['Refreshing...', 'refresh']);
   },
 
+  // ZNTC 의 HMR apply 는 동기라 update-start→update-done 이 거의 즉시 일어난다.
+  // 그대로 hide 하면 'Refreshing...' 배너가 한 프레임도 못 그려지고 사라진다.
+  // 최소 표시 시간(MIN_SHOW_MS)을 보장해 Metro 와 체감을 맞춘다. 그 사이 새 update 가
+  // 시작되면(_pendingUpdates>0) hide 를 건너뛰어 배너를 유지한다.
   _hideRefreshing: function () {
-    this._safeCallDlv('hide', []);
+    var self = this;
+    var MIN_SHOW_MS = 300;
+    var elapsed = Date.now() - (self._showTime || 0);
+    if (elapsed >= MIN_SHOW_MS) {
+      self._safeCallDlv('hide', []);
+      return;
+    }
+    setTimeout(function () {
+      if (self._pendingUpdates === 0) self._safeCallDlv('hide', []);
+    }, MIN_SHOW_MS - elapsed);
   },
 
   enable: function () {