vxrn 2.0.0-beta.99.1 → 2.6.0

package/native-project-patches.cjs

@@ -5,8 +5,8 @@ const path = require('node:path')
 function hasNitroWebImage(root) {
   const projectRequire = createRequire(path.join(root, 'package.json'))
   try {
-    const nativeRoot = path.dirname(projectRequire.resolve('@vxrn/native/package.json'))
-    projectRequire.resolve('react-native-nitro-web-image/package.json', { paths: [nativeRoot] })
+    const oneRoot = path.dirname(projectRequire.resolve('one/package.json'))
+    projectRequire.resolve('react-native-nitro-web-image/package.json', { paths: [oneRoot] })
     return true
   } catch {
     return false
@@ -36,6 +36,30 @@ function injectNitroWebImageModularHeaderIntoPodfile(podfile) {
  */
 const FMT_CXX17_MARKER = '# [vxrn/one] fmt c++17 fix'
 
+const WEBGPU_HEADERS_MARKER = '# [vxrn/one] webgpu isolated package headers'
+
+function injectWebGPUHeaderPathsIntoPodfile(podfile) {
+  if (podfile.includes(WEBGPU_HEADERS_MARKER)) return podfile
+  const match = podfile.match(/post_install\s+do\s+\|installer\|/)
+  if (!match) throw new Error('[vxrn] Podfile lost its post_install anchor')
+  const patch = `
+    ${WEBGPU_HEADERS_MARKER}
+    installer.pods_project.targets.each do |target|
+      next unless target.name == 'react-native-webgpu'
+
+      target.build_configurations.each do |build_config|
+        paths = Array(build_config.build_settings['HEADER_SEARCH_PATHS'] || '$(inherited)')
+        paths |= %w[cpp/rnwgpu cpp/rnwgpu/api cpp/rnwgpu/api/descriptors cpp/jsi].map do |directory|
+          "$(PODS_TARGET_SRCROOT)/#{directory}"
+        end
+        build_config.build_settings['HEADER_SEARCH_PATHS'] = paths
+      end
+    end
+`
+  const insertAt = match.index + match[0].length
+  return podfile.slice(0, insertAt) + '\n' + patch + podfile.slice(insertAt)
+}
+
 function injectFmtCxx17FixIntoPodfile(podfile) {
   if (podfile.includes(FMT_CXX17_MARKER)) {
     return podfile
@@ -171,8 +195,14 @@ function replaceAppBuildGradleReactBlock(appBuildGradleContents) {
     return appBuildGradleContents
   }
 
+  // replace our resolver declarations together with the react block on re-prebuild.
+  const prefix = appBuildGradleContentLines
+    .slice(0, reactBlockStartIndex)
+    .join('\n')
+    .replaceAll(ANDROID_APP_BUILD_GRADLE_RESOLVERS, '')
+    .trimEnd()
   return [
-    ...appBuildGradleContentLines.slice(0, reactBlockStartIndex),
+    prefix,
     ANDROID_APP_BUILD_GRADLE_REACT_BLOCK,
     ...appBuildGradleContentLines.slice(reactBlockEndIndex + 1),
   ].join('\n')
@@ -180,8 +210,7 @@ function replaceAppBuildGradleReactBlock(appBuildGradleContents) {
 
 // TODO: Get the content of this block from @react-native-community/template (for example, get https://registry.npmjs.org/@react-native-community/template/0.76.6, find the tarball, download it into a tmp dir, extract it, read template/android/app/build.gradle, parse out the react block) to ensure it stays up to date.
 // Note that we need to add patches marked with [vxrn/one], not just copy the block from the template as is.
-const ANDROID_APP_BUILD_GRADLE_REACT_BLOCK = `
-def resolveNodePackage = { packageName ->
+const ANDROID_APP_BUILD_GRADLE_RESOLVERS = `def resolveNodePackage = { packageName ->
     providers.exec {
         workingDir(rootDir)
         commandLine("node", "--print", "require.resolve('" + packageName + "')")
@@ -193,7 +222,10 @@ def resolveReactNativeDependency = { packageName ->
         workingDir(rootDir)
         commandLine("node", "--print", "require('module').createRequire(require.resolve('react-native/package.json')).resolve('" + packageName + "')")
     }.standardOutput.asText.get().trim()
-}
+}`
+
+const ANDROID_APP_BUILD_GRADLE_REACT_BLOCK = `
+${ANDROID_APP_BUILD_GRADLE_RESOLVERS}
 
 react {
     // [vxrn/one] the bundle command should find the entry file automatically,
@@ -211,9 +243,11 @@ react {
     // the application has its own node_modules directory.
     reactNativeDir = file(resolveNodePackage("react-native/package.json")).parentFile
     codegenDir = file(resolveReactNativeDependency("@react-native/codegen/package.json")).parentFile
-    // [vxrn/one] cli.js is not in react-native's exports map since 0.87, so
-    // resolve the exported package.json and step to the sibling cli.js on disk
-    cliFile = new File(file(resolveNodePackage("react-native/package.json")).parentFile, "cli.js")
+    // [vxrn/one] vxrn owns the cli even when the app has no hoisted cli package
+    cliFile = file(providers.exec {
+        workingDir(rootDir)
+        commandLine("node", "--print", "require('module').createRequire(require.resolve('vxrn/package.json')).resolve('@react-native-community/cli/build/bin.js')")
+    }.standardOutput.asText.get().trim())
     // [vxrn/one] resolve hermesc from the same react-native installation
     hermesCommand = new File(file(resolveReactNativeDependency("hermes-compiler/package.json")).parentFile, "hermesc/%OS-BIN%/hermesc").absolutePath
 
@@ -292,6 +326,55 @@ function insertBeforeBundlePhaseRunner(input, codeToAdd) {
   return input
 }
 
+function insertAfterBundlePhaseRunner(input, codeToAdd) {
+  for (const anchor of BUNDLE_PHASE_RUNNER_ANCHORS) {
+    const match = anchor.exec(input)
+    if (!match) continue
+    const lineEnd = input.indexOf('\n', match.index + match[0].length)
+    const insertAt = lineEnd === -1 ? input.length : lineEnd + 1
+    return input.slice(0, insertAt) + codeToAdd + '\n' + input.slice(insertAt)
+  }
+
+  if (!warnedMissingBundlePhaseRunnerAnchor) {
+    warnedMissingBundlePhaseRunnerAnchor = true
+    console.warn(
+      '[vxrn] could not find the `"$NODE_BINARY" .../scripts/react-native-xcode.sh` line in the iOS bundle phase; the One.Updates embedded manifest was not applied. The React Native template may have changed shape.'
+    )
+  }
+  return input
+}
+
+/**
+ * Write the One.Updates embedded manifest beside the release bundle after
+ * React Native's bundling runs. The id and timestamp are generated at build
+ * time; the runtime version is baked in by prebuild.
+ */
+const EMBEDDED_UPDATES_MANIFEST_MARKER =
+  '# [vxrn/one] the embedded update manifest lands beside the release bundle'
+
+function addEmbeddedUpdatesManifestToBundleReactNativeShellScript(input, runtimeVersion) {
+  if (input.includes(EMBEDDED_UPDATES_MANIFEST_MARKER)) {
+    return input
+  }
+
+  const runtime = String(runtimeVersion).replace(/\\/g, '\\\\').replace(/"/g, '\\"')
+  const codeToAdd = [
+    '',
+    EMBEDDED_UPDATES_MANIFEST_MARKER,
+    'ONE_UPDATES_RESOURCES="$CONFIGURATION_BUILD_DIR/$UNLOCALIZED_RESOURCES_FOLDER_PATH"',
+    'if [ -f "$ONE_UPDATES_RESOURCES/main.jsbundle" ]; then',
+    `  "\${NODE_BINARY:-node}" -e 'const fs = require("fs"); const manifest = { id: require("crypto").randomUUID(), createdAt: new Date().toISOString(), runtimeVersion: "${runtime}" }; fs.writeFileSync(process.argv[1], JSON.stringify(manifest));' "$ONE_UPDATES_RESOURCES/one-updates-embedded.json"`,
+    // react-native-xcode.sh exits 0 when hermesc fails, so a release build
+    // would otherwise ship with no bundle and nothing for the launcher to run.
+    'elif [[ "$CONFIGURATION" != *Debug* && -z "$SKIP_BUNDLING" ]]; then',
+    '  echo "error: [one] release build has no main.jsbundle: the bundle phase failed" >&2',
+    '  exit 1',
+    'fi',
+  ].join('\n')
+
+  return insertAfterBundlePhaseRunner(input, codeToAdd)
+}
+
 /**
  * React Native v0.76 defaults the CLI_PATH to an internal scripts/bundle.js for iOS (see: https://github.com/facebook/react-native/blob/v0.76.0/packages/react-native/scripts/react-native-xcode.sh#L93), which loads the bundle command directly from `@react-native/community-cli-plugin`, and will ignore the override of the bundle command in `react-native.config.cjs`.
  * We need to set it back to the main CLI endpoint so the override of the bundle command in `react-native.config.cjs` can take effect.
@@ -305,7 +388,7 @@ function addSetCliPathToBundleReactNativeShellScript(input) {
 
   const codeToAdd = `
 ${SET_CLI_PATH_MARKER}
-export CLI_PATH="$("\${NODE_BINARY:-node}" --print "require('path').dirname(require.resolve('react-native/package.json')) + '/cli.js'")"
+export CLI_PATH="$("\${NODE_BINARY:-node}" --print "require('module').createRequire(require.resolve('vxrn/package.json')).resolve('@react-native-community/cli/build/bin.js')")"
 `.trim()
 
   return insertBeforeBundlePhaseRunner(input, codeToAdd)
@@ -572,13 +655,121 @@ function injectOneSwiftPackagesIntoPodfile(podfile) {
   return podfile.slice(0, insertAt) + '\n' + lines.join('\n') + podfile.slice(insertAt)
 }
 
+// one notifications host entries, written by both one prebuild and
+// vxrn/expo-plugin. the ios keys and android class names are read by one's
+// native code, so they change together with it.
+const ONE_NOTIFICATIONS = {
+  enabledInfoPlistKey: 'OneNativeNotificationsEnabled',
+  pushInfoPlistKey: 'OneNativeNotificationsPush',
+  apsEnvironment: 'development',
+  androidPermissions: [
+    'android.permission.POST_NOTIFICATIONS',
+    'android.permission.RECEIVE_BOOT_COMPLETED',
+  ],
+  receiver: 'dev.onejs.onenative.OneNativeNotificationsReceiver',
+  receiverAction: 'android.intent.action.BOOT_COMPLETED',
+  pushService: 'dev.onejs.onenative.OneNativePushService',
+  pushServiceAction: 'com.google.firebase.MESSAGING_EVENT',
+  pushGradleProperty: 'oneNativePush',
+}
+
+// One.Updates: the Info.plist keys the launcher reads, and the release
+// bundleURL both prebuilds point at it. the app target reaches the launcher's
+// c entry point through its bridging header: it cannot import One, whose c++
+// umbrella does not rebuild under the app's flags.
+const ONE_UPDATES = {
+  urlInfoPlistKey: 'OneUpdatesURL',
+  runtimeVersionInfoPlistKey: 'OneUpdatesRuntimeVersion',
+  bridgingHeaderImport: '#import "OneUpdatesLauncherBridge.h"',
+}
+
+const RELEASE_BUNDLE_URL =
+  /(#else\n\s*)(return )?Bundle\.main\.url\(forResource: "main", withExtension: "jsbundle"\)(\n#endif)/
+
+function pointReleaseBundleURLAtOneUpdates(appDelegate) {
+  if (appDelegate.includes('OneUpdatesBundleURL()')) {
+    return appDelegate
+  }
+  if (!RELEASE_BUNDLE_URL.test(appDelegate)) {
+    throw new Error(
+      '[vxrn] AppDelegate.swift changed shape: cannot point the release bundleURL at One.Updates'
+    )
+  }
+  return appDelegate.replace(RELEASE_BUNDLE_URL, '$1$2OneUpdatesBundleURL()$3')
+}
+
+// the launch screen hold: the app's react native delegate keeps the launch
+// storyboard over the root view until react native's first content, through
+// the OneHoldLaunchScreen c entry point in the bridging header.
+const ONE_LAUNCH_SCREEN = {
+  bridgingHeaderImport: '#import "OneLaunchScreen.h"',
+}
+
+const REACT_NATIVE_DELEGATE_CLASS =
+  /^class ReactNativeDelegate: (ExpoReactNativeFactoryDelegate|RCTDefaultReactNativeFactoryDelegate) \{\n/m
+
+function holdLaunchScreenOverRootView(appDelegate) {
+  if (appDelegate.includes('OneHoldLaunchScreen(')) {
+    return appDelegate
+  }
+  const match = appDelegate.match(REACT_NATIVE_DELEGATE_CLASS)
+  if (!match) {
+    throw new Error(
+      '[vxrn] AppDelegate.swift changed shape: cannot hold the launch screen over the react native root'
+    )
+  }
+  // expo's delegate re-declares the hook over UIView; react native's takes
+  // its RCTRootView.
+  const rootViewType = match[1] === 'ExpoReactNativeFactoryDelegate' ? 'UIView' : 'RCTRootView'
+  return appDelegate.replace(
+    match[0],
+    `${match[0]}  // [vxrn/one] the launch screen stays over the root until react native's first content
+  override func customize(_ rootView: ${rootViewType}) {
+    super.customize(rootView)
+    OneHoldLaunchScreen(rootView)
+  }
+
+`
+  )
+}
+
+// the android half of the launch screen hold: MainActivity hands its content
+// to OneLaunchScreen right after super.onCreate, which every prebuilt
+// activity has once addReactNativeScreensFix ran.
+const SUPER_ON_CREATE = /^([ \t]*)super\.onCreate\(null\)$/m
+
+function holdLaunchScreenInMainActivity(mainActivity) {
+  if (mainActivity.includes('OneLaunchScreen.hold(this)')) {
+    return mainActivity
+  }
+  if (!SUPER_ON_CREATE.test(mainActivity)) {
+    throw new Error(
+      '[vxrn] MainActivity.kt changed shape: cannot hold the launch screen after super.onCreate'
+    )
+  }
+  return mainActivity
+    .replace(/package\s+[\w.]+/, '$&\nimport com.margelo.nitro.one.OneLaunchScreen')
+    .replace(
+      SUPER_ON_CREATE,
+      "$1super.onCreate(null)\n$1// [vxrn/one] the launch screen stays until react native's first content\n$1OneLaunchScreen.hold(this)"
+    )
+}
+
 module.exports = {
+  injectWebGPUHeaderPathsIntoPodfile,
+  holdLaunchScreenInMainActivity,
+  ONE_NOTIFICATIONS,
+  ONE_UPDATES,
+  pointReleaseBundleURLAtOneUpdates,
+  ONE_LAUNCH_SCREEN,
+  holdLaunchScreenOverRootView,
   hasNitroWebImage,
   injectNitroWebImageModularHeaderIntoPodfile,
   injectOneSwiftPackagesIntoPodfile,
   addSetCliPathToBundleReactNativeShellScript,
   addPodHermescToBundleReactNativeShellScript,
   addDepsPatchToBundleReactNativeShellScript,
+  addEmbeddedUpdatesManifestToBundleReactNativeShellScript,
   injectFmtCxx17FixIntoPodfile,
   injectHermesMinificationPatchIntoPodfile,
   injectReactNativeScreensGammaIntoPodfile,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vxrn",
-  "version": "2.0.0-beta.99.1",
+  "version": "2.6.0",
   "sideEffects": false,
   "type": "module",
   "exports": {
@@ -30,6 +30,22 @@
     "./vite-plugin": {
       "types": "./types/vxrn-vite-plugin.d.ts",
       "default": "./dist/vxrn-vite-plugin.mjs"
+    },
+    "./native-source-contract": {
+      "types": "./types/native-source-contract.d.ts",
+      "default": "./dist/native-source-contract.mjs"
+    },
+    "./swift-package-id": {
+      "types": "./types/swift-package-id.d.ts",
+      "default": "./dist/swift-package-id.mjs"
+    },
+    "./background-computation": {
+      "types": "./types/backgroundComputation.d.ts",
+      "default": "./dist/backgroundComputation.mjs"
+    },
+    "./background-computation-native": {
+      "types": "./types/backgroundComputationNative.d.ts",
+      "default": "./dist/backgroundComputationNative.mjs"
     }
   },
   "module": "dist",
@@ -62,18 +78,18 @@
     "@jridgewell/remapping": "^2.3.0",
     "@jridgewell/trace-mapping": "^0.3.25",
     "@react-native/codegen": "^0.87.1",
+    "@react-native-community/cli": "^20.2.0",
     "@react-native-community/cli-config": "^20.2.0",
     "@react-native/dev-middleware": "^0.87.1",
-    "@vxrn/compiler": "2.0.0-beta.99.1",
-    "@vxrn/debug": "2.0.0-beta.99.1",
-    "@vxrn/query-string": "2.0.0-beta.99.1",
-    "@vxrn/resolve": "2.0.0-beta.99.1",
-    "@vxrn/safe-area": "2.0.0-beta.99.1",
-    "@vxrn/url-parse": "2.0.0-beta.99.1",
-    "@vxrn/utils": "2.0.0-beta.99.1",
-    "@vxrn/vendor": "2.0.0-beta.99.1",
-    "@vxrn/vite-flow": "2.0.0-beta.99.1",
-    "@vxrn/vite-plugin-metro": "2.0.0-beta.99.1",
+    "@vxrn/compiler": "2.6.0",
+    "@vxrn/debug": "2.6.0",
+    "@vxrn/query-string": "2.6.0",
+    "@vxrn/resolve": "2.6.0",
+    "@vxrn/url-parse": "2.6.0",
+    "@vxrn/utils": "2.6.0",
+    "@vxrn/vendor": "2.6.0",
+    "@vxrn/vite-flow": "2.6.0",
+    "@vxrn/vite-plugin-metro": "2.6.0",
     "citty": "^0.1.6",
     "dotenv": "^17.2.1",
     "dotenv-expand": "^12.0.2",
@@ -95,26 +111,29 @@
     "pkg-types": "^1.0.3",
     "rolldown": "^1.2.8",
     "semver": "^7.6.3",
-    "sharp": "^0.35.4",
+    "sharp": "^0.35.5",
     "vite": "^8.2.2",
-    "ws": "^8.21.0"
+    "ws": "^8.21.0",
+    "sucrase": "3.35.1"
   },
   "devDependencies": {
     "@biomejs/biome": "2.3.3",
     "@jridgewell/gen-mapping": "^0.3.5",
-    "@react-native-community/cli": "^20.2.0",
-    "@tamagui/build": "3.0.0-beta.1432.1",
+    "@tamagui/build": "3.0.3",
     "@types/find-node-modules": "^2.1.2",
     "@types/node": "^24.10.0",
     "@types/ws": "^8.18.1",
     "depcheck": "^1.4.7",
+    "hermes-compiler": "250829098.0.17",
     "metro-source-map": "0.84.4",
     "react-native": "0.87.1",
+    "typescript": "7.0.2",
     "vitest": "^4.1.0"
   },
   "publishConfig": {
     "access": "public"
   },
+  "releaseSourceCommit": "9822993504bd9422425d1d6ee9bfbe96f84c909c",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/onejs/one.git",

package/src/backgroundComputation.ts

@@ -0,0 +1,220 @@
+import MagicString from 'magic-string'
+import { parse } from 'sucrase/dist/parser/index.js'
+import { IdentifierRole } from 'sucrase/dist/parser/tokenizer/index.js'
+import { TokenType } from 'sucrase/dist/parser/tokenizer/types.js'
+
+export type BackgroundModule = {
+  id: string
+  source: string
+  calculate: string
+  name: string
+  platform: 'web' | 'native'
+}
+
+export type BackgroundTransformOptions = {
+  platform: 'web' | 'native'
+  resolve: (source: string, importer: string) => string
+  nativeModule?: (module: BackgroundModule) => string
+  workerFactory?: (module: BackgroundModule) => string
+}
+
+const marker = '.__one_background_worker_'
+const hex = (name: string) =>
+  [...new TextEncoder().encode(name)]
+    .map((byte) => byte.toString(16).padStart(2, '0'))
+    .join('')
+
+// file-shaped worker entries survive Vite's query stripping and package graphs.
+export function loadBackgroundComputationModule(
+  id: string
+): BackgroundModule | undefined {
+  const match = id.match(/^(.*?)\.__one_background_worker_([a-f0-9]+)\.js(?:\?.*)?$/)
+  if (!match) return
+  const [, calculate, encoded] = match
+  const name = new TextDecoder().decode(
+    Uint8Array.from(encoded.match(/../g)!, (byte) => Number.parseInt(byte, 16))
+  )
+  return {
+    id,
+    calculate,
+    name,
+    platform: 'web',
+    source: `import { ${name} as calculate } from ${JSON.stringify(calculate)};
+self.onmessage = ({ data: { revision, input } }) => {
+  try {
+    const value = calculate(input);
+    if (value instanceof Promise) throw new TypeError('background computations must be synchronous');
+    self.postMessage({ ok: true, result: { revision, value } });
+  } catch (error) {
+    self.postMessage({ ok: false, revision, error: String(error) });
+  }
+};`,
+  }
+}
+
+// hosts supply path resolution and worker transport; selection and protocol stay here.
+export function transformBackgroundComputations(
+  source: string,
+  id: string,
+  options: BackgroundTransformOptions
+) {
+  if (!source.includes('defineBackgroundComputation') || id.includes(marker)) return
+  const file = parse(
+    source,
+    !/\.[cm]?ts(?:\?|$)/.test(id),
+    /\.[cm]?tsx?(?:\?|$)/.test(id),
+    false
+  )
+  const { tokens } = file
+  const text = (index: number) =>
+    tokens[index] ? source.slice(tokens[index].start, tokens[index].end) : ''
+  const imports = new Map<string, { source: string; name: string }>()
+  const definitions = new Set<string>()
+  for (let index = 0; index < tokens.length; index++) {
+    if (text(index) !== 'import' || tokens[index].isType || text(index + 1) !== '{')
+      continue
+    const start = index + 2
+    let end = start
+    while (end < tokens.length && text(end) !== '}') end++
+    if (text(end + 1) !== 'from' || tokens[end + 2]?.type !== TokenType.string) continue
+    const specifier = text(end + 2).slice(1, -1)
+    for (let binding = start; binding < end; binding++) {
+      if (tokens[binding].isType || tokens[binding].type !== TokenType.name) continue
+      const name = text(binding)
+      const local = text(binding + 1) === 'as' ? text(binding + 2) : name
+      imports.set(local, { source: specifier, name })
+      if (specifier === 'one/background' && name === 'defineBackgroundComputation')
+        definitions.add(local)
+      if (local !== name) binding += 2
+    }
+    index = end + 2
+  }
+  if (!definitions.size) return
+  const code = new MagicString(source)
+  const modules: BackgroundModule[] = []
+  for (let index = 0; index < tokens.length; index++) {
+    const token = tokens[index]
+    if (token.identifierRole !== IdentifierRole.Access || !definitions.has(text(index)))
+      continue
+    let opening = index + 1
+    while (tokens[opening]?.isType) opening++
+    if (text(opening) !== '(') continue
+    let binding = index - 2
+    while (tokens[binding]?.isType) binding--
+    if (
+      token.scopeDepth !== 0 ||
+      text(index - 1) !== '=' ||
+      tokens[binding]?.identifierRole !== IdentifierRole.TopLevelDeclaration
+    )
+      throw new Error(
+        `[one background] ${id}: definitions must be module-scope variables`
+      )
+    const argument = tokens[opening + 1]
+    const calculate =
+      argument?.type === TokenType.name ? imports.get(text(opening + 1)) : undefined
+    if (!calculate || !calculate.source.startsWith('.') || text(opening + 2) !== ')')
+      throw new Error(
+        `[one background] ${id}: defineBackgroundComputation requires one named import from a relative pure module at module scope`
+      )
+    const resolved = options.resolve(calculate.source, id)
+    if (options.platform === 'native') {
+      const local = `__oneBackgroundCalculate${modules.length}`
+      const module: BackgroundModule = {
+        id: `${resolved}.__one_background_native_${hex(calculate.name)}.js`,
+        source: `export { ${calculate.name} } from ${JSON.stringify(resolved)};`,
+        calculate: resolved,
+        name: calculate.name,
+        platform: 'native',
+      }
+      const selected = options.nativeModule
+        ? options.nativeModule(module)
+        : `${calculate.source}?one-background=${encodeURIComponent(calculate.name)}`
+      code.prepend(
+        `import { ${calculate.name} as ${local} } from ${JSON.stringify(selected)};\n`
+      )
+      code.overwrite(argument.start, argument.end, local)
+      modules.push(module)
+    } else {
+      const module = loadBackgroundComputationModule(
+        `${resolved}${marker}${hex(calculate.name)}.js`
+      )!
+      const factory = options.workerFactory
+        ? options.workerFactory(module)
+        : `() => new Worker(new URL(${JSON.stringify(module.id)}, import.meta.url), { type: 'module' })`
+      code.appendLeft(tokens[opening + 2].start, `, ${factory}`)
+      modules.push(module)
+    }
+  }
+  if (!modules.length) return
+  return { code: code.toString(), map: code.generateMap({ hires: true }), modules }
+}
+
+// selected graphs expose __exportN; both native hosts use this runtime cache wrapper.
+export function createBackgroundWorkletModule(
+  bundle: string,
+  names: readonly string[],
+  key: string
+) {
+  const loader = `__oneLoadWorkletModule_${key}`
+  return `function ${loader}() {
+  'worklet';
+  const cache = globalThis.__oneWorkletImportCache || (globalThis.__oneWorkletImportCache = new WeakMap());
+  let namespace = cache.get(${loader});
+  if (namespace === undefined) {
+    ${bundle}
+    namespace = __oneWorkletBundle;
+    cache.set(${loader}, namespace);
+  }
+  return namespace;
+}\n${names
+    .map(
+      (name, index) => `function __oneExport${index}(...args) {
+  'worklet';
+  return (0, ${loader}().__export${index})(...args);
+}
+export { __oneExport${index} as ${name} };`
+    )
+    .join('\n')}`
+}
+
+export function assertBackgroundDependency(source: string) {
+  const name = source.replaceAll('\\', '/')
+  if (
+    name.startsWith('node:') ||
+    /(?:^|\/node_modules\/)(?:react|react-native|react-native-worklets|react-native-reanimated|@react-native)(?:\/|$)/.test(
+      name
+    )
+  )
+    throw new Error(
+      `[one background] runtime dependency ${source} is not pure JavaScript`
+    )
+}
+
+export type BackgroundGraphModule = {
+  id: number
+  code: string
+  dependencies: readonly (number | null)[]
+}
+
+// graph hosts supply compiled CommonJS factories; runtime loading is isolated from the app.
+export function bundleBackgroundGraph(
+  modules: readonly BackgroundGraphModule[],
+  entry: number,
+  names: readonly string[]
+) {
+  return `var __oneWorkletBundle = (function () {
+  const factories = { ${modules.map((module) => `${module.id}: function(global, _require, _importDefault, _importAll, module, exports, _dependencyMap) {\n${module.code}\n}`).join(',\n')} };
+  const dependencies = ${JSON.stringify(Object.fromEntries(modules.map((module) => [module.id, module.dependencies])))};
+  const cache = Object.create(null);
+  function require(id) {
+    if (cache[id]) return cache[id].exports;
+    const module = cache[id] = { exports: {} };
+    factories[id](globalThis, require, importDefault, importAll, module, module.exports, dependencies[id]);
+    return module.exports;
+  }
+  function importDefault(id) { const value = require(id); return value && value.__esModule ? value.default : value; }
+  function importAll(id) { const value = require(id); return value && value.__esModule ? value : Object.assign({ default: value }, value); }
+  const namespace = require(${entry});
+  return { ${names.map((name, index) => `__export${index}: namespace[${JSON.stringify(name)}]`).join(', ')} };
+})();`
+}

package/src/backgroundComputationNative.ts

@@ -0,0 +1,23 @@
+import {
+  getClosureVariables,
+  JS_GLOBALS,
+  transformHermesLoops,
+} from '@vxrn/compiler/worklet-utils'
+import { parseSync } from 'oxc-parser'
+
+// native compiler hosts validate the complete loader before worklet serialization.
+export function prepareBackgroundWorkletModule(source: string, id: string) {
+  const code = transformHermesLoops(source, id)?.code ?? source
+  const parsed = parseSync(id, code, { lang: 'js' })
+  if (parsed.errors.length) throw new Error(parsed.errors[0].message)
+  const captures = getClosureVariables(
+    parsed.program.body[0],
+    new Set([...JS_GLOBALS, 'arguments'])
+  )
+  if (captures.length) {
+    throw new Error(
+      `[worklet imports] ${id} requires unsupported runtime globals: ${captures.join(', ')}`
+    )
+  }
+  return code
+}

package/src/config/getBaseViteConfigOnly.ts

@@ -8,7 +8,6 @@ import type { VXRNOptionsFilled } from './getOptionsFilled'
 
 export const dedupe = [
   'one',
-  '@vxrn/safe-area',
   'react',
   'react-dom',
   'react-dom/client',
@@ -21,11 +20,11 @@ export const dedupe = [
   '@react-navigation/bottom-tabs',
   '@tamagui/core',
   '@tamagui/web',
+  '@tamagui/adapt',
   '@tamagui/react-native-web',
   '@tamagui/react-native-web-lite',
   'tamagui',
   'react-native-reanimated',
-  'escape-string-regexp',
 ]
 
 /**
@@ -65,6 +64,7 @@ export async function getBaseViteConfig(
 
   return {
     mode,
+    assetsInclude: ['**/*.glb'],
 
     // we load the config ourselves
     // if you disable this is disables auto-reloading config changes
@@ -103,19 +103,18 @@ export async function getBaseViteConfig(
           // react native 0.87 removed @react-native/assets-registry, but libraries
           // like react-native-svg still import its registry
           find: /^(react-native\/asset-registry|@react-native\/assets-registry\/registry)$/,
-          replacement: resolvePath('react-native-web/dist/modules/AssetRegistry', root),
+          replacement: 'react-native-web/dist/modules/AssetRegistry',
         },
         {
           find: 'react-native/package.json',
-          replacement: resolvePath('react-native-web/package.json', root),
+          replacement: 'react-native-web/package.json',
         },
+        // named by package so it resolves (from the root, through dedupe) only
+        // once something imports react-native: an app with no react-native
+        // imports needs no react-native-web.
         {
           find: 'react-native',
-          replacement: resolvePath('react-native-web', root),
-        },
-        {
-          find: 'react-native-safe-area-context',
-          replacement: resolvePath('@vxrn/safe-area', root),
+          replacement: 'react-native-web',
         },
         // bundle size optimizations
         {