one/src/vite/one.ts

One is a new React Framework that makes Vite serve both native and web.

import { configureVXRNCompilerPlugin } from '@vxrn/compiler'
import { resolvePath } from '@vxrn/resolve'
import {
  type ExpoManifestRequestHandlerPluginPluginOptions,
  type MetroPluginOptions,
  getPlatformEnvDefine,
} from '@vxrn/vite-plugin-metro'
import events from 'node:events'
import { existsSync, readFileSync } from 'node:fs'
import path from 'node:path'
import { type Plugin, type PluginOption } from 'vite'
import { autoDepOptimizePlugin, getOptionsFilled, loadEnv } from 'vxrn'
import vxrnVitePlugin from 'vxrn/vite-plugin'
import { CACHE_KEY } from '../constants'
import { getViteMetroPluginOptions } from '../metro-config/getViteMetroPluginOptions'
import '../polyfills-server'
import { setServerGlobals } from '../server/setServerGlobals'
import { getRouterRootFromOneOptions } from '../utils/getRouterRootFromOneOptions'
import { ensureTSConfig } from './ensureTsConfig'
import { setOneOptions } from './loadConfig'
import { clientTreeShakePlugin } from './plugins/clientTreeShakePlugin'
import { createDevtoolsPlugin } from './plugins/devtoolsPlugin'
import { createFileSystemRouterPlugin } from './plugins/fileSystemRouterPlugin'
import { fixDependenciesPlugin } from './plugins/fixDependenciesPlugin'
import { generateFileSystemRouteTypesPlugin } from './plugins/generateFileSystemRouteTypesPlugin'
import { criticalCSSPlugin } from './plugins/criticalCSSPlugin'
import { imageDataPlugin } from './plugins/imageDataPlugin'
import { sourceInspectorPlugin } from './plugins/sourceInspectorPlugin'
import { SSRCSSPlugin } from './plugins/SSRCSSPlugin'
import { virtualEntryId } from './plugins/virtualEntryConstants'
import { createVirtualEntry } from './plugins/virtualEntryPlugin'
import { environmentGuardPlugin } from './plugins/environmentGuardPlugin'
import type { One } from './types'

type MetroOptions = MetroPluginOptions

/**
 * This needs a big refactor!
 * I guess these plugins are all being loaded by native??
 * At least the react compiler plugin is applying to native, so the entire premise of some things
 * here are wrong. we can probably refactor and merge all the stuff
 */

events.setMaxListeners(1_000)

// temporary for tamagui plugin compat
globalThis.__vxrnEnableNativeEnv = true

// temporary until we fix double-load issue, which means we'd have to somehow
// not control the port/host from our config, but still pass it into ENV
// until then we want to avoid double loading everything on first start

export function one(options: One.PluginOptions = {}): PluginOption {
  // ensure server globals are set before any plugin code runs
  // (the side-effect import in vite.ts gets tree-shaken by the build)
  setServerGlobals()

  const routerRoot = getRouterRootFromOneOptions(options)

  // when native is explicitly disabled, skip metro, the vxrn RN plugin set,
  // and all native-only globals — One runs as a pure web framework.
  const nativeDisabled = options.native === false
  const nativeOptions = options.native === false ? undefined : options.native

  if (nativeDisabled) {
    // tamagui compiler reads this to decide whether to process the native env
    globalThis.__vxrnEnableNativeEnv = false
  }

  /**
   * A non-null value means that we are going to use Metro.
   */
  const metroOptions:
    | (MetroOptions & ExpoManifestRequestHandlerPluginPluginOptions)
    | null = (() => {
    if (nativeDisabled) return null
    if (nativeOptions?.bundler !== 'metro' && !process.env.ONE_METRO_MODE) return null

    if (process.env.ONE_METRO_MODE) {
      console.info('ONE_METRO_MODE environment variable is set, enabling Metro mode')
    }

    const routerRoot = getRouterRootFromOneOptions(options)

    const defaultMetroOptions = getViteMetroPluginOptions({
      projectRoot:
        (nativeOptions?.bundlerOptions as any)?.argv?.projectRoot || process.cwd(),
      relativeRouterRoot: routerRoot,
      ignoredRouteFiles: options.router?.ignoredRouteFiles,
      userDefaultConfigOverrides: (nativeOptions?.bundlerOptions as any)
        ?.defaultConfigOverrides,
      setupFile: options.setupFile,
    })

    const userMetroOptions = nativeOptions?.bundlerOptions as typeof defaultMetroOptions

    const babelConfig = {
      ...defaultMetroOptions?.babelConfig,
      ...userMetroOptions?.babelConfig,
    }

    // TODO: [METRO-OPTIONS-MERGING] We only do shallow merge here.
    return {
      ...defaultMetroOptions,
      ...userMetroOptions,
      defaultConfigOverrides: defaultMetroOptions?.defaultConfigOverrides, // defaultConfigOverrides is merged by getViteMetroPluginOptions, so we need to set it here again.
      argv: {
        ...defaultMetroOptions?.argv,
        ...userMetroOptions?.argv,
      },
      babelConfig: {
        ...babelConfig,
        plugins: [
          ...(babelConfig.plugins || []),
          ...(options.react?.compiler === true || options.react?.compiler === 'native'
            ? ['babel-plugin-react-compiler']
            : []),
        ],
      },
      mainModuleName: 'one/metro-entry', // So users won't need to write `"main": "one/metro-entry"` in their `package.json` like ordinary Expo apps.
      // allow env var to enable lazy startup
      startup: process.env.ONE_METRO_LAZY ? 'lazy' : userMetroOptions?.startup,
    }
  })()

  const vxrnPlugins: PluginOption[] = []

  if (!process.env.IS_VXRN_CLI) {
    console.warn('Experimental: running VxRN as a Vite plugin. This is not yet stable.')
    vxrnPlugins.push(
      vxrnVitePlugin({
        metro: metroOptions,
        disableNative: nativeDisabled,
      })
    )
  } else {
    if (!globalThis.__oneOptions) {
      // first load we are just loading it ourselves to get the user options
      // so we can just set here and return nothing
      setOneOptions(options)
      globalThis['__vxrnPluginConfig__'] = options
      globalThis['__vxrnMetroOptions__'] = metroOptions
      return []
    }
  }

  // ensure tsconfig
  if (options.config?.ensureTSConfig !== false) {
    void ensureTSConfig()
  }

  const vxrnOptions = getOptionsFilled()
  const root = vxrnOptions?.root || process.cwd()

  const compiler = options.react?.compiler
  if (compiler) {
    configureVXRNCompilerPlugin({
      enableCompiler:
        // pass through object config, regex, or function directly
        typeof compiler === 'object' || typeof compiler === 'function'
          ? compiler
          : compiler === 'native'
            ? ['ios', 'android']
            : compiler === 'web'
              ? ['ssr', 'client']
              : true,
    })
  }

  const autoDepsOptions = options.ssr?.autoDepsOptimization
  const dedupeSymlinks = options.ssr?.dedupeSymlinkedModules ?? false

  // closure state for ssr-symlink-dedup plugin
  let ssrDedup_optimizedPackages: Set<string> | null = null
  let ssrDedup_projectRoot = ''

  const ssrSymlinkDedupPlugin: Plugin = {
    name: 'one:ssr-symlink-dedup',
    enforce: 'pre',

    configResolved(config) {
      if (!dedupeSymlinks) return
      ssrDedup_projectRoot = config.root || process.cwd()
      const ssrInclude = config.ssr?.optimizeDeps?.include
      if (!ssrInclude?.length) return

      ssrDedup_optimizedPackages = new Set<string>()
      for (const entry of ssrInclude) {
        if (entry.startsWith('@')) {
          const parts = entry.split('/')
          ssrDedup_optimizedPackages.add(`${parts[0]}/${parts[1]}`)
        } else {
          ssrDedup_optimizedPackages.add(entry.split('/')[0])
        }
      }
    },

    async resolveId(source, importer, options) {
      if (!dedupeSymlinks) return
      // skip relative/absolute imports
      if (source[0] === '.' || source[0] === '/') return

      // extract package name and check for subpath
      let pkgName: string
      let subpath: string | null = null
      if (source.startsWith('@')) {
        const parts = source.split('/')
        pkgName = parts.length >= 2 ? `${parts[0]}/${parts[1]}` : source
        if (parts.length > 2) subpath = `./${parts.slice(2).join('/')}`
      } else {
        const parts = source.split('/')
        pkgName = parts[0]
        if (parts.length > 1) subpath = `./${parts.slice(1).join('/')}`
      }

      // resolve normally
      const resolved = await this.resolve(source, importer, {
        ...options,
        skipSelf: true,
      })
      if (!resolved?.id) return

      // if it already goes through node_modules, no fixup needed
      if (resolved.id.includes('/node_modules/')) return

      // resolved to a real (source) path — find the node_modules equivalent
      const path = await import('node:path')
      const fs = await import('node:fs')
      const { join, dirname } = path
      const { realpathSync, existsSync, readFileSync } = fs
      let dir = ssrDedup_projectRoot
      while (dir !== dirname(dir)) {
        const nmPkgDir = join(dir, 'node_modules', pkgName)
        if (existsSync(nmPkgDir)) {
          // for subpath imports, use package.json exports to resolve correctly
          // (filesystem resolution hits CJS metro-compat shims)
          if (subpath) {
            try {
              const pkg = JSON.parse(readFileSync(join(nmPkgDir, 'package.json'), 'utf8'))
              const exportEntry = pkg.exports?.[subpath]
              if (exportEntry && typeof exportEntry === 'object') {
                const target =
                  exportEntry.import || exportEntry.module || exportEntry.default
                if (target) {
                  const fullPath = join(nmPkgDir, target)
                  if (existsSync(fullPath))
                    return { id: fullPath, external: resolved.external }
                }
              }
            } catch {}
          }

          // for bare imports, map real path → node_modules path
          const realPkgDir = realpathSync(nmPkgDir)
          if (resolved.id.startsWith(realPkgDir)) {
            const relativePart = resolved.id.slice(realPkgDir.length)
            return { id: nmPkgDir + relativePart, external: resolved.external }
          }
          break
        }
        dir = dirname(dir)
      }
    },
  }

  const devAndProdPlugins: Plugin[] = [
    {
      name: 'one:config',
      __get: options,
    } as any,

    {
      name: 'one:env-prefix',
      config(userConfig) {
        // only set default if user hasn't configured envPrefix
        if (userConfig.envPrefix) return
        return {
          envPrefix: ['VITE_', 'EXPO_PUBLIC_'],
        }
      },
    },

    environmentGuardPlugin(options.environmentGuards),

    criticalCSSPlugin(),

    imageDataPlugin(),

    {
      name: 'one-define-client-env',
      async config(userConfig) {
        const clientEnvDefine = options.skipEnv
          ? {}
          : (
              await loadEnv(
                vxrnOptions?.mode ?? userConfig?.mode ?? 'development',
                process.cwd(),
                userConfig?.envPrefix
              )
            ).clientEnvDefine
        return {
          define: {
            ...clientEnvDefine,
            ...(process.env.ONE_DEBUG_ROUTER && {
              'process.env.ONE_DEBUG_ROUTER': JSON.stringify(
                process.env.ONE_DEBUG_ROUTER
              ),
            }),
          },
        }
      },
    },

    ...(autoDepsOptions === false
      ? []
      : [
          autoDepOptimizePlugin({
            onScannedDeps({ hasReanimated, hasNativewind }) {
              configureVXRNCompilerPlugin({
                enableReanimated: hasReanimated,
                enableNativeCSS: nativeOptions?.css ?? hasNativewind,
                enableNativewind: hasNativewind,
              })
            },
            root,
            include: /node_modules/,
            ...(autoDepsOptions === true ? {} : autoDepsOptions),
          }),
        ]),

    ...(options.config?.tsConfigPaths === false
      ? []
      : [
          (() => {
            // vite 8's native resolve.tsconfigPaths works for client but fetchModule
            // hardcodes tsconfigPaths: false for SSR, so we also resolve via resolveId
            type PathMapping = { prefix: string; replacement: string; wildcard: boolean }
            let mappings: PathMapping[] = []

            function loadMappings(resolvedRoot: string) {
              try {
                const configPath = path.resolve(resolvedRoot, 'tsconfig.json')
                if (!existsSync(configPath)) return
                const raw = readFileSync(configPath, 'utf-8')
                // strip single-line and multi-line comments for JSON.parse
                const stripped = raw.replace(
                  /\\"|"(?:\\"|[^"])*"|(\/\/.*|\/\*[\s\S]*?\*\/)/g,
                  (m, g) => (g ? '' : m)
                )
                const config = JSON.parse(stripped)
                const paths = config?.compilerOptions?.paths
                const baseUrl = config?.compilerOptions?.baseUrl || '.'
                if (!paths) return
                for (const [pattern, targets] of Object.entries(
                  paths as Record<string, string[]>
                )) {
                  const target = targets[0]
                  if (!target) continue
                  if (pattern.endsWith('/*')) {
                    const resolved = path.resolve(
                      resolvedRoot,
                      baseUrl,
                      target.slice(0, -1)
                    )
                    mappings.push({
                      prefix: pattern.slice(0, -1),
                      replacement: resolved.endsWith('/') ? resolved : resolved + '/',
                      wildcard: true,
                    })
                  } else {
                    mappings.push({
                      prefix: pattern,
                      replacement: path.resolve(resolvedRoot, baseUrl, target),
                      wildcard: false,
                    })
                  }
                }
              } catch {}
            }

            return {
              name: 'one:tsconfig-paths',
              enforce: 'pre',

              config() {
                return {
                  resolve: { tsconfigPaths: true },
                }
              },

              configResolved(config) {
                if (mappings.length === 0) {
                  loadMappings(config.root)
                }
              },

              resolveId(source: string) {
                const jsExts = [
                  '.ts',
                  '.tsx',
                  '.js',
                  '.jsx',
                  '.mts',
                  '.mjs',
                  '.cjs',
                  '.cts',
                ]
                for (const m of mappings) {
                  let candidate: string | undefined
                  if (m.wildcard) {
                    if (source.startsWith(m.prefix)) {
                      candidate = m.replacement + source.slice(m.prefix.length)
                    }
                  } else if (source === m.prefix) {
                    candidate = m.replacement
                  }
                  if (!candidate) continue
                  // already has a js/ts extension
                  if (jsExts.includes(path.extname(candidate))) return candidate
                  // try appending extensions
                  for (const e of jsExts) {
                    if (existsSync(candidate + e)) return candidate + e
                  }
                  // try /index
                  for (const e of jsExts) {
                    if (existsSync(candidate + '/index' + e))
                      return candidate + '/index' + e
                  }
                  return candidate
                }
              },
            } satisfies Plugin
          })(),
        ]),

    // resolveId-based aliases that work during both vite transforms AND
    // rolldown dep pre-bundling (where resolve.alias is not applied)
    ...(options.alias
      ? [
          (() => {
            const resolveMap = (map?: Record<string, string>) => {
              if (!map) return null
              const out: Record<string, string> = {}
              for (const [key, value] of Object.entries(map)) {
                try {
                  out[key] = path.isAbsolute(value) ? value : resolvePath(value)
                } catch {
                  out[key] = value
                }
              }
              return out
            }

            const a = options.alias!
            const resolved = {
              web: resolveMap(a.web),
              native: resolveMap(a.native),
              client: resolveMap(a.client),
              ssr: resolveMap(a.ssr),
              ios: resolveMap(a.ios),
              android: resolveMap(a.android),
            }

            return {
              name: 'one:alias',
              enforce: 'pre',
              resolveId(source) {
                const env = this.environment?.name

                // specific env wins over general
                const specific = env ? resolved[env as keyof typeof resolved] : null
                if (specific && source in specific) {
                  return { id: specific[source], external: false }
                }

                // fall back to general (web/native)
                const isWeb = !env || env === 'client' || env === 'ssr'
                const general = isWeb ? resolved.web : resolved.native
                if (general && source in general) {
                  return { id: general[source], external: false }
                }
              },
            } satisfies Plugin
          })(),
        ]
      : []),

    {
      // rolldown fails on deep react-native/Libraries/* imports during dep pre-bundling.
      // these are native-only paths that don't exist in react-native-web.
      name: 'one:redirect-rn-deep-imports',
      enforce: 'pre',

      resolveId(source) {
        if (this.environment?.name === 'client' || this.environment?.name === 'ssr') {
          if (
            source.startsWith('react-native/Libraries/') ||
            /react-native-web(-lite)?\/.*\/Libraries\//.test(source)
          ) {
            return '\0rn-empty-module'
          }
        }
      },

      load(id) {
        if (id === '\0rn-empty-module') {
          return 'export default {}; export {};'
        }
      },
    } satisfies Plugin,

    {
      name: 'one-aliases',
      enforce: 'pre',

      config() {
        let tslibLitePath = ''

        try {
          // temp fix for seeing
          // Could not read from file: modules/@vxrn/resolve/dist/esm/@vxrn/tslib-lite
          tslibLitePath = resolvePath('@vxrn/tslib-lite', process.cwd())
        } catch (err) {
          console.info(`Can't find tslib-lite, falling back to tslib`)
          if (process.env.DEBUG) {
            console.error(err)
          }
        }

        return {
          resolve: {
            alias: {
              // testing getting transition between routes working
              // 'use-sync-external-store/with-selector': resolvePath(
              //   'use-sync-external-store/shim/with-selector'
              // ),

              ...(tslibLitePath && {
                tslib: tslibLitePath,
              }),
            },
          },
        }
      },
    },

    {
      name: 'one:init-config',

      config() {
        const setupFileDefines = (() => {
          if (!options.setupFile) return {}

          let setupFiles: {
            client?: string
            server?: string
            ios?: string
            android?: string
          }

          if (typeof options.setupFile === 'string') {
            setupFiles = {
              client: options.setupFile,
              server: options.setupFile,
              ios: options.setupFile,
              android: options.setupFile,
            }
          } else if ('native' in options.setupFile) {
            setupFiles = {
              client: options.setupFile.client,
              server: options.setupFile.server,
              ios: options.setupFile.native,
              android: options.setupFile.native,
            }
          } else {
            setupFiles = options.setupFile
          }

          return {
            ...(setupFiles.client && {
              'process.env.ONE_SETUP_FILE_CLIENT': JSON.stringify(setupFiles.client),
            }),
            ...(setupFiles.server && {
              'process.env.ONE_SETUP_FILE_SERVER': JSON.stringify(setupFiles.server),
            }),
            ...(setupFiles.ios && {
              'process.env.ONE_SETUP_FILE_IOS': JSON.stringify(setupFiles.ios),
            }),
            ...(setupFiles.android && {
              'process.env.ONE_SETUP_FILE_ANDROID': JSON.stringify(setupFiles.android),
            }),
          }
        })()

        // if user overrides it use theirs
        const serverURL = process.env.ONE_SERVER_URL || vxrnOptions?.server.url

        return {
          // Platform env defined at root level for client (workaround for Vite bug with environment.client.define)
          define: {
            ...getPlatformEnvDefine('client'),
            ...setupFileDefines,

            ...(options.web?.defaultRenderMode && {
              'process.env.ONE_DEFAULT_RENDER_MODE': JSON.stringify(
                options.web.defaultRenderMode
              ),
              'import.meta.env.ONE_DEFAULT_RENDER_MODE': JSON.stringify(
                options.web.defaultRenderMode
              ),
            }),

            ...(process.env.NODE_ENV !== 'production' &&
              serverURL && {
                'process.env.ONE_SERVER_URL': JSON.stringify(serverURL),
                'import.meta.env.ONE_SERVER_URL': JSON.stringify(serverURL),
              }),

            ...(options.web?.linkPrefetch && {
              'process.env.ONE_LINK_PREFETCH': JSON.stringify(options.web.linkPrefetch),
            }),

            ...(options.web?.skewProtection !== undefined && {
              'process.env.ONE_SKEW_PROTECTION': JSON.stringify(
                options.web.skewProtection === true
                  ? 'true'
                  : options.web.skewProtection === false
                    ? 'false'
                    : options.web.skewProtection // 'proactive'
              ),
            }),

            ...(options.web?.suspendRoutes !== undefined && {
              'process.env.ONE_SUSPEND_ROUTES': JSON.stringify(
                options.web.suspendRoutes ? '1' : '0'
              ),
            }),
          },

          environments: {
            ssr: {
              define: getPlatformEnvDefine('ssr'),
            },
            ios: {
              define: {
                ...getPlatformEnvDefine('ios'),
                ...(nativeOptions?.suspendRoutes !== undefined && {
                  'process.env.ONE_SUSPEND_ROUTES_NATIVE': JSON.stringify(
                    nativeOptions.suspendRoutes ? '1' : '0'
                  ),
                }),
              },
            },
            android: {
              define: {
                ...getPlatformEnvDefine('android'),
                ...(nativeOptions?.suspendRoutes !== undefined && {
                  'process.env.ONE_SUSPEND_ROUTES_NATIVE': JSON.stringify(
                    nativeOptions.suspendRoutes ? '1' : '0'
                  ),
                }),
              },
            },
          },

          ssr: {
            // ensure server-only/client-only go through vite so our environmentGuardPlugin can handle them
            noExternal: ['server-only', 'client-only'],
          },
        }
      },
    } satisfies Plugin,

    {
      name: 'one:tamagui',
      config() {
        return {
          define: {
            // safe to set because it only affects web in tamagui, and one is always react 19
            'process.env.TAMAGUI_REACT_19': '"1"',
          },

          environments: {
            ssr: {
              define: {
                'process.env.TAMAGUI_IS_SERVER': '"1"',
                'process.env.TAMAGUI_KEEP_THEMES': '"1"',
              },
            },
            ios: {
              define: {
                'process.env.TAMAGUI_KEEP_THEMES': '"1"',
              },
            },
            android: {
              define: {
                'process.env.TAMAGUI_KEEP_THEMES': '"1"',
              },
            },
          },
        }
      },
    } satisfies Plugin,

    {
      name: 'route-module-hmr-fix',
      hotUpdate({ server, modules, file }) {
        const envName = this.environment?.name

        // Check if this is an app file
        const fileRelativePath = path.relative(server.config.root, file)
        const fileRootDir = fileRelativePath.split(path.sep)[0]
        const isAppFile = fileRootDir === 'app'

        // For SSR environment, prevent full page reload for app files by returning empty array
        // The SSR module runner will still pick up changes on next request
        if (envName === 'ssr' && isAppFile) {
          return []
        }

        let hasRouteUpdate = false

        const result = modules.map((m) => {
          const { id } = m
          if (!id) return m

          const relativePath = path.relative(server.config.root, id)
          // Get the root dir from relativePath
          const rootDir = relativePath.split(path.sep)[0]
          if (rootDir === 'app') {
            // If the file is a route, Vite might force a full-reload due to that file not being imported by any other modules (`!node.importers.size`) (see https://github.com/vitejs/vite/blob/v6.0.0-alpha.18/packages/vite/src/node/server/hmr.ts#L440-L443, https://github.com/vitejs/vite/blob/v6.0.0-alpha.18/packages/vite/src/node/server/hmr.ts#L427 and https://github.com/vitejs/vite/blob/v6.0.0-alpha.18/packages/vite/src/node/server/hmr.ts#L557-L566)
            // Here we trick Vite to skip that check.
            m.acceptedHmrExports = new Set()

            // Check if this is a ROOT layout file - only root layouts need special handling
            // because they're called as functions (not rendered as JSX) to support HTML elements
            // Root layout patterns: app/_layout.tsx or app/(group)/_layout.tsx
            const isRootLayout =
              relativePath === path.join('app', '_layout.tsx') ||
              /^app[\\/]\([^)]+\)[\\/]_layout\.tsx$/.test(relativePath)
            if (isRootLayout) {
              hasRouteUpdate = true
            }
          }

          return m
        })

        // For root layout files, send a custom event to trigger re-render
        // Root layouts are called as functions (not JSX) to support HTML elements, bypassing React's HMR
        if (hasRouteUpdate) {
          server.hot.send({
            type: 'custom',
            event: 'one:route-update',
            data: { file: fileRelativePath },
          })
        }

        return result
      },
    } satisfies Plugin,

    // Plugins may transform the source code and add imports of `react/jsx-dev-runtime`, which won't be discovered by Vite's initial `scanImports` since the implementation is using ESbuild where such plugins are not executed.
    // Thus, if the project has a valid `react/jsx-dev-runtime` import, we tell Vite to optimize it, so Vite won't only discover it on the next page load and trigger a full reload.
    {
      name: 'one:optimize-dev-deps',

      config(_, env) {
        if (env.mode === 'development') {
          return {
            optimizeDeps: {
              include: ['react/jsx-dev-runtime', 'react/compiler-runtime'],
            },
          }
        }
      },
    } satisfies Plugin,

    {
      name: 'one:remove-server-from-client',
      enforce: 'pre',

      transform(code, id) {
        if (this.environment.name === 'client') {
          if (id.includes(`one-server-only`)) {
            return code.replace(
              `import { AsyncLocalStorage } from "node:async_hooks"`,
              `class AsyncLocalStorage {}`
            )
          }
        }
      },
    },

    // packages in resolve.dedupe must also be pre-bundled for SSR to prevent
    // duplicate module instances (e.g. symlinked monorepo packages resolving
    // to different paths)
    {
      name: 'one:ssr-dedupe-prebundle',

      config(config) {
        if (!dedupeSymlinks) return
        const dedupeList = config.resolve?.dedupe
        if (!Array.isArray(dedupeList) || dedupeList.length === 0) return

        return {
          ssr: {
            optimizeDeps: {
              include: [...dedupeList],
            },
            noExternal: [...dedupeList],
          },
        }
      },
    },

    // fix: vite's ssr dep optimizer registers pre-bundled deps by their
    // node_modules path, but symlinks cause imports to resolve to the real
    // (source) path. the optimizer doesn't recognize the real path, so it
    // loads from source — creating a duplicate instance.
    // this plugin forces optimized SSR deps to resolve via node_modules.
    ssrSymlinkDedupPlugin,
  ] satisfies Plugin[]

  // TODO move to single config and through environments
  const nativeWebDevAndProdPlugsin: Plugin[] = [clientTreeShakePlugin()]

  // TODO make this passed into vxrn through real API
  if (!nativeDisabled) {
    globalThis.__vxrnAddNativePlugins = [clientTreeShakePlugin({ runtime: 'rolldown' })]
  }
  globalThis.__vxrnAddWebPluginsProd = devAndProdPlugins

  const flags: One.Flags = {}

  // pass config to the rolldown native entry (createNativeDevEngine reads this)
  if (!nativeDisabled) {
    globalThis.__vxrnNativeEntryConfig = {
      routerRoot: routerRoot,
      ignoredRouteFiles: options.router?.ignoredRouteFiles,
      setupFile: options.setupFile,
      flags,
    }
  }

  // source inspector must come before clientTreeShakePlugin so line numbers
  // are computed from original source (tree-shaking removes loader code, shifting lines)
  const inspectorPlugins = (() => {
    const devtools = options.devtools ?? true
    const inspector =
      devtools === true || (devtools !== false && (devtools.inspector ?? true))
    const editor = devtools !== true && devtools !== false ? devtools.editor : undefined
    return inspector ? sourceInspectorPlugin({ editor }) : []
  })()

  return [
    ...vxrnPlugins,
    ...devAndProdPlugins,
    ...inspectorPlugins,
    ...nativeWebDevAndProdPlugsin,

    /**
     * This is really the meat of one, where it handles requests:
     */
    createFileSystemRouterPlugin(options),

    generateFileSystemRouteTypesPlugin(options),

    fixDependenciesPlugin(options.patches),

    createVirtualEntry({
      ...options,
      flags,
      root: routerRoot,
    }),

    {
      name: 'one-define-environment',
      config() {
        return {
          define: {
            ...(nativeOptions?.key && {
              'process.env.ONE_APP_NAME': JSON.stringify(nativeOptions.key),
              'import.meta.env.ONE_APP_NAME': JSON.stringify(nativeOptions.key),
            }),

            'process.env.ONE_CACHE_KEY': JSON.stringify(CACHE_KEY),
            'import.meta.env.ONE_CACHE_KEY': JSON.stringify(CACHE_KEY),
          },
        }
      },
    } satisfies Plugin,

    SSRCSSPlugin({
      entries: [virtualEntryId],
    }),

    // devtools (always includes refresh preamble for HMR, optionally includes UI)
    ...(() => {
      const devtools = options.devtools ?? true
      const includeUI = devtools !== false
      return [
        // always include devtools plugin for refresh preamble (required for HMR)
        createDevtoolsPlugin({ includeUI }),
      ]
    })(),
  ]
}
// vite 8