vxrn 2.7.6 → 2.8.0

package/src/utils/createNativeDevEngine.test.ts

@@ -1,5 +1,5 @@
 import { existsSync, realpathSync } from 'node:fs'
-import { mkdir, mkdtemp, readFile, rm, symlink, writeFile } from 'node:fs/promises'
+import { mkdir, mkdtemp, readFile, rename, rm, symlink, writeFile } from 'node:fs/promises'
 import { tmpdir } from 'node:os'
 import { join } from 'node:path'
 import { createContext, runInContext, runInNewContext } from 'node:vm'
@@ -28,6 +28,14 @@ import {
   type NativePluginContext,
 } from './createNativeDevEngine'
 
+// an edit made while the engine watches, landing the way an editor's safe save
+// does. writeFile truncates first, and a loaded runner can deliver that empty
+// file to the watcher as an edit of its own before the content arrives
+const saveFile = async (path: string, data: string) => {
+  await writeFile(`${path}.tmp`, data)
+  await rename(`${path}.tmp`, path)
+}
+
 it.each(['edit', 'create', 'delete'] as const)(
   'loads routes and applies %s HMR through symlinked node_modules',
   async (change) => {
@@ -295,6 +303,132 @@ it.each(['react-native-nitro-modules', 'react-native-worklets'])(
   }
 )
 
+async function writeStubReactNative(
+  directory: string,
+  owner: string,
+  files: Record<string, string> = {}
+) {
+  await mkdir(join(directory, 'src/private/assets'), { recursive: true })
+  await mkdir(join(directory, 'Libraries/Core'), { recursive: true })
+  await writeFile(
+    join(directory, 'package.json'),
+    JSON.stringify({
+      name: 'react-native',
+      main: './index.js',
+      exports: {
+        '.': './index.js',
+        './Libraries/*': './Libraries/*.js',
+        './asset-registry': './src/asset-registry.js',
+        './setup-env': { default: './src/setup-env.js' },
+        './package.json': './package.json',
+      },
+    })
+  )
+  await writeFile(
+    join(directory, 'index.js'),
+    `import './src/private/assets/AssetRegistry.js'\nexport const owner = '${owner}'\nexport const AppRegistry = { registerComponent() {} }\n`
+  )
+  await writeFile(
+    join(directory, 'src/private/assets/AssetRegistry.js'),
+    `globalThis.__owners = globalThis.__owners || []\nglobalThis.__owners.push('${owner}:AssetRegistry')\nexport const registryOwner = '${owner}'\n`
+  )
+  await writeFile(
+    join(directory, 'src/asset-registry.js'),
+    `export * from './private/assets/AssetRegistry.js'\n`
+  )
+  await writeFile(
+    join(directory, 'src/setup-env.js'),
+    `import './private/assets/AssetRegistry.js'\nglobalThis.__owners.push('${owner}:SetupEnv')\n`
+  )
+  await writeFile(
+    join(directory, 'Libraries/Core/InitializeCore.js'),
+    `globalThis.__owners.push('${owner}:InitializeCore')\nexport const core = '${owner}'\n`
+  )
+  for (const [name, code] of Object.entries(files)) {
+    await mkdir(join(directory, ...name.split('/').slice(0, -1)), { recursive: true })
+    await writeFile(join(directory, name), code)
+  }
+}
+
+async function writeStubExpo(directory: string, launchCode: string) {
+  await mkdir(join(directory, 'build/launch'), { recursive: true })
+  await writeFile(
+    join(directory, 'package.json'),
+    JSON.stringify({
+      name: 'expo',
+      main: './build/Expo.js',
+      exports: {
+        '.': './build/Expo.js',
+        './launch/registerRootComponent': './build/launch/registerRootComponent.js',
+        './package.json': './package.json',
+      },
+    })
+  )
+  await writeFile(join(directory, 'build/Expo.js'), `export const expo = true\n`)
+  await writeFile(join(directory, 'build/launch/registerRootComponent.js'), launchCode)
+}
+
+it('shares the app react-native singleton for bare and deep imports across nested installs', async () => {
+  const root = await mkdtemp(join(tmpdir(), 'vxrn-native-rn-singleton-'))
+  try {
+    await writeStubReactNative(join(root, 'node_modules/react-native'), 'app')
+    const expoDir = join(root, 'node_modules/expo')
+    await writeStubExpo(
+      expoDir,
+      `import { AppRegistry } from 'react-native'\nimport 'react-native/Libraries/Core/InitializeCore'\nimport 'react-native/setup-env'\nexport default function registerRootComponent(c) { return [c, AppRegistry] }\n`
+    )
+    await writeStubReactNative(join(expoDir, 'node_modules/react-native'), 'nested')
+    await writeFile(join(root, 'package.json'), '{}')
+    await writeFile(
+      join(root, 'entry.js'),
+      `import 'react-native'\nimport registerRootComponent from 'expo/launch/registerRootComponent'\nglobalThis.__register = typeof registerRootComponent\n`
+    )
+    const { code } = await buildNativeBundle({
+      root,
+      platform: 'ios',
+      dev: true,
+      entryFile: 'entry.js',
+    })
+    const context = { console, setTimeout, clearTimeout }
+    runInNewContext(code, context)
+    expect(Reflect.get(context, '__register')).toBe('function')
+    expect([...Reflect.get(context, '__owners')].sort()).toEqual([
+      'app:AssetRegistry',
+      'app:InitializeCore',
+      'app:SetupEnv',
+    ])
+  } finally {
+    await rm(root, { recursive: true, force: true })
+  }
+})
+
+it('refuses the nested react-native copy when the app copy lacks the file', async () => {
+  const root = await mkdtemp(join(tmpdir(), 'vxrn-native-rn-skew-'))
+  try {
+    await writeStubReactNative(join(root, 'node_modules/react-native'), 'app')
+    const expoDir = join(root, 'node_modules/expo')
+    await writeStubExpo(
+      expoDir,
+      `import { AppRegistry } from 'react-native'\nimport 'react-native/Libraries/Skew/OnlyFile'\nexport default function registerRootComponent(c) { return [c, AppRegistry] }\n`
+    )
+    // the nested copy still ships a file the app copy removed. resolving it
+    // from the nested copy would initialize the native runtime twice.
+    await writeStubReactNative(join(expoDir, 'node_modules/react-native'), 'nested', {
+      'Libraries/Skew/OnlyFile.js': `import '../../src/private/assets/AssetRegistry.js'\nexport const skew = 'nested'\n`,
+    })
+    await writeFile(join(root, 'package.json'), '{}')
+    await writeFile(
+      join(root, 'entry.js'),
+      `import 'react-native'\nimport registerRootComponent from 'expo/launch/registerRootComponent'\nglobalThis.__register = typeof registerRootComponent\n`
+    )
+    await expect(
+      buildNativeBundle({ root, platform: 'ios', dev: true, entryFile: 'entry.js' })
+    ).rejects.toThrow("missing from the app's react-native")
+  } finally {
+    await rm(root, { recursive: true, force: true })
+  }
+})
+
 const nativeTransformProbe = `
 export const transformProbe = () => {
   'worklet'
@@ -676,11 +810,8 @@ if (import.meta.hot) import.meta.hot.accept(() => {})
           fn = runInContext(`(${worklet.__initData.code})`, ui)
           compiled.set(worklet.__workletHash, fn!)
         }
-        const closure = Object.fromEntries(
-          Object.entries(worklet.__closure).map(([name, value]) => [
-            name,
-            typeof value === 'function' ? reconstruct(value) : value,
-          ])
+        const closure = worklet.__closure.map((value: unknown) =>
+          typeof value === 'function' ? reconstruct(value) : value
         )
         return fn!.bind({ __closure: closure })
       }
@@ -1025,7 +1156,7 @@ if (import.meta.hot) import.meta.hot.accept(() => {})
             // and the test immediately restores the file to component-v1 upon
             // seeing hmr-session-ready.
             sourceMapPromise = native.getSourceMap()
-            void writeFile(childPath, childSource('component-v1'))
+            void saveFile(childPath, childSource('component-v1'))
           } else if (updates.length === 2) {
             resolveSecondUpdate(update)
           }
@@ -1056,7 +1187,7 @@ if (import.meta.hot) import.meta.hot.accept(() => {})
         runtime = context.__rolldown_runtime__
         await native.engine.registerClient(runtime.clientId)
 
-        await writeFile(childPath, childSource('hmr-session-ready'))
+        await saveFile(childPath, childSource('hmr-session-ready'))
         const secondUpdate = await secondUpdateReceived
         expect(await sourceMapPromise).toBe(initial.map)
         expect(updates).toHaveLength(2)
@@ -2796,6 +2927,74 @@ globalThis.__vxrnConditionalExportProbe = helper()
     }
   )
 
+  it.each([false, true])(
+    'preserves external native defaults and raw namespaces (minify=%s)',
+    async (minify) => {
+      const root = await mkdtemp(join(tmpdir(), 'vxrn-external-default-'))
+      await writeFile(join(root, 'package.json'), JSON.stringify({ type: 'module' }))
+      await writeFile(
+        join(root, 'entry.js'),
+        `
+import Component, { marker } from 'external-helper'
+import Scoped from '@external/helper/deep'
+import Plain from 'plain-helper'
+globalThis.externalDefaults = [Component, marker, Scoped, Plain, require('external-helper')]
+`
+      )
+      const component = () => 42
+      const namespace = { default: component, marker: 42, __esModule: true }
+      try {
+        const result = await buildNativeBundle({
+          root,
+          platform: 'ios',
+          entryFile: 'entry.js',
+          minify,
+          plugins: [
+            {
+              name: 'external-default-probe',
+              resolveId(id) {
+                if (
+                  ['external-helper', '@external/helper/deep', 'plain-helper'].includes(
+                    id
+                  )
+                ) {
+                  return { id, external: true }
+                }
+              },
+              outputOptions(options) {
+                return { ...options, format: 'cjs', intro: '' }
+              },
+            },
+          ],
+        })
+        const context = {
+          module: { exports: {} },
+          exports: {},
+          console,
+          require(id: string) {
+            if (id === 'plain-helper') return component
+            if (id === 'external-helper' || id === '@external/helper/deep')
+              return namespace
+            throw new Error(`unexpected external: ${id}`)
+          },
+        }
+        runInNewContext(result.code, context)
+        expect(Reflect.get(context, 'externalDefaults')).toEqual([
+          component,
+          42,
+          component,
+          component,
+          namespace,
+        ])
+        const values = Reflect.get(context, 'externalDefaults')
+        if (!Array.isArray(values)) throw new Error('external probe did not execute')
+        expect(values[4]).toBe(namespace)
+      } finally {
+        await rm(root, { recursive: true, force: true })
+      }
+    }
+  )
+
   it('unwraps the default export of Babel CommonJS modules in production output', async () => {
     const testRoot = await mkdtemp(join(tmpdir(), 'vxrn-native-prod-cjs-default-'))
     const packageRoot = join(testRoot, 'node_modules/default-export-helper')
@@ -2834,6 +3033,106 @@ globalThis.__vxrnConditionalExportProbe = helper()
 })
 
 describe('native Flow sources', () => {
+  it.each([true, false])(
+    'preserves codegen, worklets and maps with dev=%s',
+    async (dev) => {
+      const compiler = await import('@vxrn/compiler')
+      const root = await createWorkletsProject(false)
+      const id = join(root, 'ProbeNativeComponent.js')
+      const source = `/* library license */
+// @flow
+import type { ViewProps, HostComponent } from 'react-native';
+import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNativeComponent';
+import codegenNativeCommands from 'react-native/Libraries/Utilities/codegenNativeCommands';
+export type Value = number;
+type Props = $ReadOnly<{...ViewProps, enabled?: boolean}>;
+interface NativeCommands {
+  reload: (ref: React.ElementRef<HostComponent<Props>>, value: number) => void;
+}
+export const Commands = codegenNativeCommands<NativeCommands>({supportedCommands: ['reload']});
+export function twice(x: Value): Value { 'worklet'; return x * 2; }
+export const marker = 'flow-map-marker';
+export default codegenNativeComponent<Props>('FlowProbe');
+`
+      const rn = join(root, 'node_modules/react-native')
+      await mkdir(join(rn, 'Libraries/NativeComponent'), { recursive: true })
+      await mkdir(join(rn, 'Libraries/ReactNative'), { recursive: true })
+      await mkdir(join(rn, 'Libraries/Utilities'), { recursive: true })
+      await writeFile(
+        join(rn, 'package.json'),
+        JSON.stringify({ name: 'react-native', main: 'index.js' })
+      )
+      await writeFile(
+        join(rn, 'Libraries/NativeComponent/NativeComponentRegistry.js'),
+        'exports.get = (name, config) => ({name, config: config()})'
+      )
+      await writeFile(
+        join(rn, 'Libraries/ReactNative/RendererProxy.js'),
+        'exports.dispatchCommand = (ref, name, args) => { globalThis.command = [ref, name, args] }'
+      )
+      for (const name of ['codegenNativeComponent', 'codegenNativeCommands']) {
+        await writeFile(
+          join(rn, `Libraries/Utilities/${name}.js`),
+          `module.exports = () => { throw new Error('codegen was not run') }`
+        )
+      }
+      await writeFile(id, source)
+      // ordinary published Flow without a pragma must also reach native lowering.
+      await writeFile(
+        join(root, 'fetch.js'),
+        'export default function fetch(value: number) { return value + 1 }'
+      )
+      await writeFile(
+        join(root, 'entry.js'),
+        `import component, { Commands, twice, marker } from './ProbeNativeComponent';
+import fetch from './fetch';
+globalThis.flowProbe = { component, twice, marker, fetched: fetch(8) };
+Commands.reload('ref', 9);`
+      )
+      compiler.configureVXRNCompilerPlugin({
+        enableReanimated: true,
+        enableNativeWorklets: true,
+        enableCompiler: false,
+      })
+      try {
+        const output = await buildNativeBundle({
+          root,
+          platform: 'ios',
+          entryFile: 'entry.js',
+          dev,
+          sourcemap: true,
+          minify: false,
+        })
+        const context: any = { console }
+        runInNewContext(output.code, context)
+        expect(context.flowProbe.component.name).toBe('FlowProbe')
+        expect(context.flowProbe.component.config.validAttributes.enabled).toBe(true)
+        expect(context.command).toEqual(['ref', 'reload', [9]])
+        expect(context.flowProbe.fetched).toBe(9)
+        expect(context.flowProbe.twice(4)).toBe(8)
+        expect(context.flowProbe.twice.__workletHash).toBeTypeOf('number')
+        const ui = runInNewContext(`(${context.flowProbe.twice.__initData.code})`)
+        expect(ui.call({ __closure: context.flowProbe.twice.__closure }, 5)).toBe(10)
+        const lines = output.code.split('\n')
+        const line = lines.findIndex((line) => line.includes('flow-map-marker'))
+        expect(line).toBeGreaterThanOrEqual(0)
+        const position = originalPositionFor(new TraceMap(output.map!), {
+          line: line + 1,
+          column: lines[line].indexOf('flow-map-marker'),
+        })
+        expect(position.source).toContain('ProbeNativeComponent.js')
+        expect(position.line).toBe(
+          source.split('\n').findIndex((line) => line.includes('flow-map-marker')) + 1
+        )
+      } finally {
+        compiler.configureVXRNCompilerPlugin({
+          enableReanimated: false,
+          enableNativeWorklets: false,
+        })
+        await rm(root, { recursive: true, force: true })
+      }
+    }
+  )
   it('strips typed arrows and class fields without a Flow pragma or type import', async () => {
     const root = await mkdtemp(join(tmpdir(), 'vxrn-native-unmarked-flow-'))
     await writeFile(
@@ -3148,7 +3447,7 @@ describe('native zero-client edit recoverability', () => {
         expect(fullBuildCount).toBe(1)
 
         // no client is registered here: this is the app that never connected.
-        await writeFile(childPath, childSource('component-v2'))
+        await saveFile(childPath, childSource('component-v2'))
         const staleDeadline = Date.now() + 10_000
         let stale = false
         while (Date.now() < staleDeadline) {

package/src/utils/createNativeDevEngine.ts

@@ -292,18 +292,11 @@ function getNativePlugins(
     cssStubPlugin(),
     // handle import.meta.glob (used by One's route system)
     viteImportGlobPlugin({ root }),
-    // @vxrn/compiler babel transforms: reanimated worklets, async generators,
-    // react-native codegen, react compiler, same pipeline as metro. runs before
-    // flowStripPlugin so react-native's Flow `.js` specs reach codegen with their
-    // type argument intact. stripping Flow first would erase it (which is why the
-    // codegen "didn't run for <Component>" warning fired).
-    vxrnCompilerPlugin(platform, dev, root, sourceMaps),
-    // react-native codegen: transforms TurboModule / Fabric specs before Flow stripping
+    // native codegen needs the original type declarations.
     rnCodegenPlugin({ projectRoot: root }),
-    // strip Flow from any react-native / @react-native `.js` the compiler didn't
-    // handle, the guaranteed safety net before rolldown's oxc core parse (which
-    // can't parse Flow). now downstream of the compiler, so codegen sees the types.
+    // lower Flow before worklets and react compiler parse the source with oxc.
     flowStripPlugin(),
+    vxrnCompilerPlugin(platform, dev, root, sourceMaps),
     // guard undefined native methods in NativeAnimatedHelper
     nativeAnimatedGuardPlugin(),
     // handle asset imports (.png, .jpg, .ttf, etc.)
@@ -351,9 +344,9 @@ function getNativeOutputOptions(
  */
 export function normalizeNativeCommonJSInterop(code: string): string {
   // native packages expose Babel defaults through exports.default. apply the
-  // same interop to bundled require helpers and HMR's runtime export lookups.
+  // same interop to external bindings, bundled helpers and HMR export lookups.
   return code.replace(
-    /(\b__toESM(?:\$\d+)?\(\s*(?:require[\w$]*\(\)|__rolldown_runtime__\.loadExports\("(?:\\.|[^"\\])*"\))\s*),\s*1(\s*\))/g,
+    /(\b__toESM(?:\$\d+)?\(\s*(?:require[\w$]*\(\)|[\w$]+|__rolldown_runtime__\.loadExports\("(?:\\.|[^"\\])*"\))\s*),\s*1(\s*\))/g,
     '$1$2'
   )
 }
@@ -637,7 +630,7 @@ export async function createNativeDevEngine(
     // is never minified.
     ...getNativeOutputOptions(prelude, true, false),
     // open the HMR socket with RN's WebSocket module (not the global, which is
-    // only polyfilled once InitializeCore has run) and hand it to the runtime,
+    // only polyfilled once setup-env has run) and hand it to the runtime,
     // which owns every message it carries. handed over immediately rather than
     // from an open handler: a host that does not honor `socket.onopen = fn`
     // would otherwise silently never get Fast Refresh. the socket goes to the
@@ -706,17 +699,38 @@ try {
       // triggered by the HMR message cannot land while the watcher is stopped.
       await engine?.ensureCurrentBuildFinish()
 
+      // adding or deleting a route changes a route map that was expanded when
+      // the entry transformed. only a full build re-expands it, and rolldown
+      // tells no client that happened, so the reload is sent from here. this
+      // comes first: a deleted route fails its own patch while the registry
+      // still imports it, and the registry update supersedes that failure.
+      if (await rebuildIfRouteGraphChanged()) return
+
       if (result instanceof Error) {
+        // an import of a route that an earlier registry listed and the current
+        // one dropped is a deleted route the registry was already rewritten for,
+        // and that rewrite builds and reports again.
+        const { removedFiles, registryId } = virtualEntry.routes
+        const errors: Array<{ code?: string; id?: string; exporter?: string }> =
+          (result as any).errors ?? []
+        if (
+          registryId &&
+          errors.length &&
+          errors.every((e) => {
+            if (e.code !== 'UNRESOLVED_IMPORT' || e.id !== registryId || !e.exporter) {
+              return false
+            }
+            const file = normalizePath(resolve(dirname(e.id), e.exporter))
+            return removedFiles.has(file)
+          })
+        ) {
+          return
+        }
         console.error('[vxrn] HMR error:', result.message)
         onHmrUpdate?.({ type: 'hmr:error' })
         return
       }
 
-      // adding or deleting a route changes a route map that was expanded when
-      // the entry transformed. only a full build re-expands it, and rolldown
-      // tells no client that happened, so the reload is sent from here.
-      if (await rebuildIfRouteGraphChanged()) return
-
       for (const { clientId, update } of result.updates) {
         if (update.type === 'Patch' && update.code) {
           await engine.notifyPayloadDelivered(update.filename)
@@ -1009,6 +1023,10 @@ interface NativeRouteRegistry {
   isRouteFile: (file: string) => boolean
   scanFiles: () => Set<string>
   updateFiles: (files: Set<string>) => void
+  // the registry module's resolved id, as rolldown reports it in errors
+  registryId?: string
+  // routes an earlier registry listed that the current one does not
+  removedFiles: Set<string>
 }
 
 function nativeVirtualEntryPlugin(
@@ -1075,14 +1093,16 @@ globalThis.$RefreshSig$ = RefreshRuntime.createSignatureFunctionForTransform;
 
   const entryCode = () => `
 ${refreshSetup}
-import * as ReactNativeInitializeCore from 'react-native/Libraries/Core/InitializeCore';
+// retain the namespace so rolldown dev eagerly initializes the RN environment
+// before app modules, even when the renderer also requires this entry.
+import * as ReactNativeEnvironment from 'react-native/setup-env';
 import NativeWebSocket from 'react-native/Libraries/WebSocket/WebSocket';
 import DevSettings from 'react-native/Libraries/Utilities/DevSettings';
 ${setupFileImport}
 ${routeImports}
 import { createApp } from 'one';
 
-void ReactNativeInitializeCore;
+void ReactNativeEnvironment;
 globalThis.WebSocket = NativeWebSocket;
 globalThis.__VXRN_RELOAD_NATIVE_DEV_BUNDLE__ = function(reason) {
   DevSettings.reload(reason);
@@ -1139,15 +1159,19 @@ ${routeHmr}
   const routes: NativeRouteRegistry = {
     routeRoot,
     files: new Set(),
+    removedFiles: new Set(),
     isRouteFile,
     scanFiles,
     updateFiles(files) {
+      for (const file of routes.files) if (!files.has(file)) routes.removedFiles.add(file)
+      for (const file of files) routes.removedFiles.delete(file)
       routes.files = files
       if (!useDynamicRouteRegistry) return
 
       mkdirSync(dirname(registryPath), { recursive: true })
       // rolldown resolves the registry through symlinked node_modules before its imports.
       const registryDir = realpathSync(dirname(registryPath))
+      routes.registryId = join(registryDir, basename(registryPath))
       const source = `export const routes = {\n${[...files]
         .sort()
         .map((file) => {
@@ -1560,7 +1584,7 @@ function nativePackageDedupePlugin(root: string): Plugin {
 function reactNativeDedupePlugin(root: string): Plugin {
   // package managers can install the same react native version at multiple
   // physical paths. rolldown assigns each path a module identity, so resolving
-  // every entry through the app's instance prevents initializeCore from running twice.
+  // every entry through the app's instance prevents setup-env from running twice.
   //
   // resolving through the filesystem also keeps react native 0.87's narrow
   // package.json `exports` (it dropped `./*` and `./src/*`) from rejecting deep
@@ -1570,7 +1594,7 @@ function reactNativeDedupePlugin(root: string): Plugin {
 
   return {
     name: 'vxrn:react-native-dedupe',
-    async resolveId(source, importer) {
+    async resolveId(source, importer, options) {
       if (source !== 'react-native' && !source.startsWith('react-native/')) return
 
       if (reactNativeRoot === undefined) {
@@ -1587,11 +1611,30 @@ function reactNativeDedupePlugin(root: string): Plugin {
       }
       if (!reactNativeRoot) return
 
-      const subpath =
-        source === 'react-native' ? 'index.js' : source.slice('react-native/'.length)
-      return this.resolve(normalizePath(resolve(reactNativeRoot, subpath)), importer, {
+      // public subpaths can map to different filenames through package exports.
+      // resolve them from the app before handling private filesystem imports.
+      const exported = await this.resolve(source, join(root, 'package.json'), {
         skipSelf: true,
+        kind: options.kind,
       })
+      if (exported) return exported
+
+      const subpath =
+        source === 'react-native' ? 'index.js' : source.slice('react-native/'.length)
+      const unified = await this.resolve(
+        normalizePath(resolve(reactNativeRoot, subpath)),
+        importer,
+        { skipSelf: true, kind: options.kind }
+      )
+      if (unified) return unified
+      // never fall through to importer-relative resolution: a nested copy
+      // would load beside the app copy and initialize the runtime twice. a
+      // file missing from the app copy is version skew, and skew must fail
+      // loudly instead of forking the singleton.
+      this.error(
+        `[vxrn] '${source}' is missing from the app's react-native (${reactNativeRoot}), ` +
+          `imported by '${importer}'. refusing the nested copy so the native runtime stays a singleton.`
+      )
     },
   }
 }
@@ -1615,10 +1658,9 @@ function cssStubPlugin(): Plugin {
 }
 
 /**
- * Pipe files through @vxrn/compiler's babel transforms.
- * Handles reanimated worklet compilation, async generator downleveling,
- * react-native codegen, react compiler, and react-refresh (dev only) —
- * same pipeline as metro, single babel pass per file.
+ * pipe files through @vxrn/compiler's babel transforms.
+ * handles reanimated worklet compilation, async generator downleveling,
+ * react compiler, and react-refresh (dev only).
  */
 export function vxrnCompilerPlugin(
   platform: string,

package/types/config/getOptimizeDeps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getOptimizeDeps.d.ts","sourceRoot":"","sources":["../../src/config/getOptimizeDeps.ts"],"names":[],"mappings":"AAKA,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;;;;;;;;;;gBAwI7C,UAAU;;;gBAaV,MAAM;oBACJ,qBAAqB;;;;;;;;;;;EAiBhC"}
+{"version":3,"file":"getOptimizeDeps.d.ts","sourceRoot":"","sources":["../../src/config/getOptimizeDeps.ts"],"names":[],"mappings":"AAKA,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;;;;;;;;;;gBA0I7C,UAAU;;;gBAaV,MAAM;oBACJ,qBAAqB;;;;;;;;;;;EAiBhC"}

package/types/config/getReactNativePlugins.d.ts

@@ -1,7 +1,8 @@
-import { type MetroPluginOptions } from '@vxrn/vite-plugin-metro';
+import type { MetroPluginOptions } from '@vxrn/vite-plugin-metro';
+import type { PluginOption } from 'vite';
 import type { VXRNOptionsFilled } from './getOptionsFilled';
 export declare function getReactNativePlugins(config?: Partial<Pick<VXRNOptionsFilled, 'cacheDir' | 'debugBundle' | 'debugBundlePaths' | 'entries'>>, { metro, }?: {
     /** Passing a non-null value will enable metro mode */
     metro?: MetroPluginOptions | null;
-}): import("vite").PluginOption[];
+}): PluginOption[];
 //# sourceMappingURL=getReactNativePlugins.d.ts.map

package/types/config/getReactNativePlugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getReactNativePlugins.d.ts","sourceRoot":"","sources":["../../src/config/getReactNativePlugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAE9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAO3D,wBAAgB,qBAAqB,CACnC,MAAM,CAAC,EAAE,OAAO,CACd,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,aAAa,GAAG,kBAAkB,GAAG,SAAS,CAAC,CACrF,EACD,EACE,KAAK,GACN,GAAE;IACD,sDAAsD;IACtD,KAAK,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAA;CAC7B,iCA0BP"}
+{"version":3,"file":"getReactNativePlugins.d.ts","sourceRoot":"","sources":["../../src/config/getReactNativePlugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAExC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAO3D,wBAAgB,qBAAqB,CACnC,MAAM,CAAC,EAAE,OAAO,CACd,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,aAAa,GAAG,kBAAkB,GAAG,SAAS,CAAC,CACrF,EACD,EACE,KAAK,GACN,GAAE;IACD,sDAAsD;IACtD,KAAK,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAA;CAC7B,GACL,YAAY,EAAE,CA4BhB"}

package/types/exports/prebuildWithoutExpo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prebuildWithoutExpo.d.ts","sourceRoot":"","sources":["../../src/exports/prebuildWithoutExpo.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,iBAAiB,EACjB,KAAK,iBAAiB,EAEvB,MAAM,+BAA+B,CAAA;AAsEtC,YAAY,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAE3F,eAAO,MAAM,mBAAmB,0BAAoB,CAAA;AAkFpD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA6DhE;AA+MD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,MAAM,CA8CrI;AAg8BD,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAyfD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAA;IAC3B,GAAG,EAAE,iBAAiB,CAAA;IACtB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,GAAG,oBAAoB,CA+7BvB;AAED,eAAO,MAAM,mBAAmB,SACxB,MAAM,YACF,KAAK,GAAG,SAAS,OACtB,iBAAiB,WACd,MAAM,kBAqEf,CAAA;AAgCD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,QA6EvD;AAID,wBAAsB,qBAAqB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,iBAsDzF;AAyFD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,iBAAiB,CAAA;IACtB,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAA;CAChD,GAAG,IAAI,CA8BP;AAID,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,yBAAyB,EAAE,CAAC,CA+BtC;AAKD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAA;CACtC,GAAG,IAAI,CAaP"}
+{"version":3,"file":"prebuildWithoutExpo.d.ts","sourceRoot":"","sources":["../../src/exports/prebuildWithoutExpo.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,iBAAiB,EACjB,KAAK,iBAAiB,EAEvB,MAAM,+BAA+B,CAAA;AAsEtC,YAAY,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAE3F,eAAO,MAAM,mBAAmB,0BAAoB,CAAA;AA6EpD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAwChE;AA0ID,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,MAAM,CA8CrI;AAg8BD,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAyfD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAA;IAC3B,GAAG,EAAE,iBAAiB,CAAA;IACtB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,GAAG,oBAAoB,CAg8BvB;AAED,eAAO,MAAM,mBAAmB,SACxB,MAAM,YACF,KAAK,GAAG,SAAS,OACtB,iBAAiB,WACd,MAAM,kBAqEf,CAAA;AAgCD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,QA6EvD;AAID,wBAAsB,qBAAqB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,iBAsDzF;AAyFD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,iBAAiB,CAAA;IACtB,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAA;CAChD,GAAG,IAAI,CA8BP;AAID,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,yBAAyB,EAAE,CAAC,CA+BtC;AAKD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAA;CACtC,GAAG,IAAI,CAaP"}

package/types/plugins/autoDepOptimizePlugin.d.ts

@@ -9,6 +9,7 @@ export declare function autoDepOptimizePlugin(props: FindDepsOptions): Plugin;
 export declare const getSSRExternalsCachePath: (root: string) => string;
 type FindDepsOptionsByMode = FindDepsOptions & {
     mode: string;
+    external?: string[] | true;
 };
 export declare function getScannedOptimizeDepsConfig(props: FindDepsOptionsByMode): Promise<{
     ssr: {

package/types/plugins/autoDepOptimizePlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autoDepOptimizePlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/autoDepOptimizePlugin.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,MAAM,CAAA;AAChD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAA;AAC1D,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,6BAA6B,CAAA;AAQpC,KAAK,eAAe,GAAG,0BAA0B,GAAG;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAA;CACjD,CAAA;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CA0CpE;AAED,eAAO,MAAM,wBAAwB,SAAU,MAAM,WAEpD,CAAA;AAED,KAAK,qBAAqB,GAAG,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/D,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,qBAAqB;;QAezE,YAAY;YACV,OAAO;YACP,OAAO;;QAET,UAAU;;GAMf;AAID,wBAAsB,kBAAkB,CAAC,EACvC,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,OAAO,GACR,EAAE,qBAAqB,2BA6EvB"}
+{"version":3,"file":"autoDepOptimizePlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/autoDepOptimizePlugin.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,MAAM,CAAA;AAChD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAA;AAC1D,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,6BAA6B,CAAA;AAQpC,KAAK,eAAe,GAAG,0BAA0B,GAAG;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAA;CACjD,CAAA;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CA2CpE;AAED,eAAO,MAAM,wBAAwB,SAAU,MAAM,WAEpD,CAAA;AAED,KAAK,qBAAqB,GAAG,eAAe,GAAG;IAC7C,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;CAC3B,CAAA;AAED,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,qBAAqB;;QAoBzE,YAAY;YACV,OAAO;YACP,OAAO;;QAET,UAAU;;GAGf;AAID,wBAAsB,kBAAkB,CAAC,EACvC,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,OAAO,GACR,EAAE,qBAAqB,2BA6EvB"}

package/types/plugins/rnCodegenPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rnCodegenPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/rnCodegenPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAMlC,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAA;AAE5D,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAW1E"}
+{"version":3,"file":"rnCodegenPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/rnCodegenPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAKlC,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAA;AAE5D,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAW1E"}

package/types/rn-commands/bundle/buildBundle.d.ts

@@ -1,4 +1,4 @@
-import { type BundleCommandArgs } from '@vxrn/vite-plugin-metro/rn-commands';
+import type { BundleCommandArgs } from '@vxrn/vite-plugin-metro/rn-commands';
 export type { BundleCommandArgs };
 export declare function buildBundle(_argv: Array<string>, ctx: any, args: BundleCommandArgs, bundleImpl?: any): Promise<void>;
 //# sourceMappingURL=buildBundle.d.ts.map

package/types/rn-commands/bundle/buildBundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildBundle.d.ts","sourceRoot":"","sources":["../../../src/rn-commands/bundle/buildBundle.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,qCAAqC,CAAA;AAI5C,YAAY,EAAE,iBAAiB,EAAE,CAAA;AAEjC,wBAAsB,WAAW,CAC/B,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EACpB,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,iBAAiB,EACvB,UAAU,GAAE,GAAU,GACrB,OAAO,CAAC,IAAI,CAAC,CA8Ff"}
+{"version":3,"file":"buildBundle.d.ts","sourceRoot":"","sources":["../../../src/rn-commands/bundle/buildBundle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAA;AAK5E,YAAY,EAAE,iBAAiB,EAAE,CAAA;AAEjC,wBAAsB,WAAW,CAC/B,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EACpB,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,iBAAiB,EACvB,UAAU,GAAE,GAAU,GACrB,OAAO,CAAC,IAAI,CAAC,CAiGf"}

package/types/utils/createNativeDevEngine.d.ts

@@ -127,10 +127,9 @@ export declare function nativeAnimatedGuardPlugin(): Plugin;
  */
 export declare function hmrClientNoopPlugin(): Plugin;
 /**
- * Pipe files through @vxrn/compiler's babel transforms.
- * Handles reanimated worklet compilation, async generator downleveling,
- * react-native codegen, react compiler, and react-refresh (dev only) —
- * same pipeline as metro, single babel pass per file.
+ * pipe files through @vxrn/compiler's babel transforms.
+ * handles reanimated worklet compilation, async generator downleveling,
+ * react compiler, and react-refresh (dev only).
  */
 export declare function vxrnCompilerPlugin(platform: string, dev: boolean, projectRoot?: string, sourceMaps?: boolean): Plugin;
 type NativeAssetData = {