peachsim 0.1.1620 → 0.1.1635

package/src/swift-compile.ts

@@ -16,7 +16,9 @@ import {
 import os from 'node:os'
 import path from 'node:path'
 import { admittedMacBuilderSlot } from './admitted-mac-build'
+import { rnxHomeDir, swiftPackageCacheOptions } from './home-paths'
 import { terminateProcessGroup } from './process-group'
+import { swiftCompilerSourceDigest } from './swift-compiler-digest'
 import { designTimeDiagnostic, designTimeSource } from './swift-design-time'
 import {
   parseSwiftDistributionManifest,
@@ -31,9 +33,9 @@ import {
   swiftTargetModuleName,
   type SwiftPackageTarget,
 } from './swift-package'
+import { swiftSdkOptions, type SwiftWasmSdk } from './swift-toolchain'
 import { isSwiftResourceBundles } from './swiftContract'
 import type { SwiftImageUpload } from './swift-submit'
-import type { SwiftWasmSdk } from './swift-toolchain'
 import type { SwiftResourceBundle } from './swiftContract'
 
 export { swiftIcuAsset, type SwiftIcuAsset }
@@ -377,7 +379,8 @@ export function withNativeSourceGlue(
 const OPTIONAL_FRAMEWORK_DEPENDENCIES: Record<string, string[]> = {
   GameplayKit: [],
   simd: [],
-  GLKit: [],
+  ModelIO: ['simd'],
+  GLKit: ['ModelIO'],
   Accelerate: [],
   CryptoKit: [],
   CommonCrypto: [],
@@ -391,7 +394,7 @@ const OPTIONAL_FRAMEWORK_DEPENDENCIES: Record<string, string[]> = {
   Statsig: [],
   TOCropViewController: [],
   RiveRuntime: ['MetalKit'],
-  MetalKit: [],
+  MetalKit: ['ModelIO'],
   DatadogCore: [],
   DatadogLogs: ['DatadogCore'],
   DatadogRUM: ['DatadogCore'],
@@ -553,12 +556,19 @@ export function swiftSdkPaths(
   toolchainBin: string,
 ): { sysroot: string; resources: string } {
   const sdk = swiftModuleSdk(moduleRoot).wasmSdkId
-  const key = `${toolchainBin}\0${sdk}`
+  const key = JSON.stringify([toolchainBin, sdk, swiftSdkOptions()])
   const cached = sdkPaths.get(key)
   if (cached) return cached
   const configuration = execFileSync(
     path.join(toolchainBin, 'swift'),
-    ['sdk', 'configure', '--show-configuration', sdk, 'wasm32-unknown-wasip1'],
+    [
+      'sdk',
+      'configure',
+      ...swiftSdkOptions(),
+      '--show-configuration',
+      sdk,
+      'wasm32-unknown-wasip1',
+    ],
     { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] },
   )
   const field = (name: string) => {
@@ -585,7 +595,7 @@ export function swiftAvailableModules(
   toolchainBin: string,
 ): Set<string> {
   const sdk = swiftModuleSdk(moduleRoot).wasmSdkId
-  const key = `${moduleRoot}\0${sdk}`
+  const key = JSON.stringify([moduleRoot, sdk, swiftSdkOptions()])
   const cached = availableModules.get(key)
   if (cached) return cached
   const modules = new Set(swiftPeachModules(moduleRoot))
@@ -711,7 +721,14 @@ const EXECUTABLE_LINK_FLAGS = `          "-Xclang-linker", "-O0",
 const REACTOR_FLAG = '"-Xclang-linker", "-mexec-model=reactor",\n'
 
 /** bump with any change to the emitted multi-target manifest text. */
-export const MULTI_MANIFEST_VERSION = 38
+export const MULTI_MANIFEST_VERSION = 39
+
+// build-cli replaces this in every bundle; source runs read the files directly.
+declare const __SWIFT_COMPILER_DIGEST__: string | undefined
+const compilerSourceDigest =
+  typeof __SWIFT_COMPILER_DIGEST__ === 'string'
+    ? __SWIFT_COMPILER_DIGEST__
+    : swiftCompilerSourceDigest(import.meta.dirname)
 
 export function swiftArtifactHash(
   input: SwiftCompileInput,
@@ -719,54 +736,8 @@ export function swiftArtifactHash(
   moduleRoot: string,
 ): string {
   const hash = createHash('sha256')
-  // v47: target ownership honors exclusions before lowering manifest-named files
-  // v46: view builder literals compile as design-time lookups
-  // v45: the link runs no wasm-opt pass, whatever the compiling machine has
-  // v44: fixed-signature optional type methods retain metatype dispatch
-  // v43: optional type-property witnesses preserve class getter dispatch
-  // v42: the source-checkout template route takes the same executable stack layout
-  // v41: executable stack size and layout match the native main-thread budget
-  // v40: generic classes expose fixed-signature optional SDK witnesses
-  // v39: target source files named Package.swift lower with their owning module
-  // v38: dependency manifests stay intact and backend threads match build jobs
-  // v37: optional requirement calls lower trailing closures without parentheses
-  // v36: javascript dialog witnesses preserve typed main actor completions
-  // v35: input-suggestion witnesses keep UIKit payload and optional results
-  // v34: typed async SDK witnesses keep imported names and completion results
-  // v33: Foundation-qualified authentication types use their networking owner
-  // v32: extension override slots resolve across each target's files
-  // v31: the text, table, scroll, collection and flow layout delegates'
-  // witnesses gain selector records, and their optional calls lower to
-  // selector sends
-  // v30: async methods answer their completion handler selector, async
-  // optional requirements get members, and non-escaping closures reach sends
-  // v29: the SDK's delegate protocols' witnesses gain selector records, and
-  // optional calls reach a requirement by its labels and witnesses by types
-  // v28: AnyClass method calls and IMP casts lower to selector sends
-  // v27: @objc protocols' optional requirements lower to selector sends
-  // v26: an @objc protocol is class-bound, #keyPath lowers to its string,
-  // and an override lifted from an extension keeps the extension's access
-  // v25: every Clang submodule import names its framework module
-  // v24: distribution objects use an ordered linker response file
-  // v22: Foundation sources see Darwin, which carries the libc and Mach
-  // v21: Foundation sources see the ObservableObject and Published aliases
-  // v20: supplied table editing and swipe methods preserve objective-c selectors
-  // v18: NSValue(time:) constructs NSStructBox through NSValue.boxedTime
-  // v17: AVAsset(url:) constructs AVURLAsset for the class cluster
-  // v16: overrides of @objc extension members rename to __peach_ovr_
-  // v15: Foundation-only sources see the platform libc (WASILibc, including
-  // math round) and its pthread mutexes (wasi_pthread)
-  // v14: AnyObject doubleValue lowers to the typed _objcNumber getter
-  // v13: implicit target resources synthesize Bundle.module
-  // v12: overrides in an extension of a same-file class lift into the class
-  // v10: Foundation-only sources see Dispatch queues
-  // v9: table cell and header footer view initializers compile required
-  // v8: optional framework products and distribution objects link on import
-  // v7: runtime class lookup uses the same objc class registry as messages
-  // v6: app and scene delegate classes compile final
-  // (v5: a target declaring resources gets SwiftPM's Bundle.module accessor;
-  // v4: sources compile through swiftSourceAsIOS)
-  hash.update(`swift-compile/v47\n${release}\n`)
+  hash.update(`swift-compile\n${release}\n`)
+  hash.update(compilerSourceDigest)
   if (input.oneModule) hash.update('one-module\n')
   hash.update(swiftModuleDigest(moduleRoot))
   for (const file of Object.keys(input.files).sort()) {
@@ -855,19 +826,18 @@ export function emitSwiftPackageManifest(args: {
   libraries?: Map<string, string>
 }): string {
   const { targets, siblings, moduleRoot, oneModule, spriteKit, distribution } = args
-  const reachedFrameworks = new Set(
-    [...siblings.values()]
-      .flat()
-      .filter(
-        (name) =>
-          OPTIONAL_FRAMEWORKS.has(name) &&
-          !targets.some((target) => target.name === name),
-      )
-      .flatMap((name) => [name, ...(OPTIONAL_FRAMEWORK_DEPENDENCIES[name] ?? [])]),
-  )
+  const reachedFrameworks = new Set<string>()
+  const reach = (name: string) => {
+    if (reachedFrameworks.has(name)) return
+    reachedFrameworks.add(name)
+    for (const dependency of OPTIONAL_FRAMEWORK_DEPENDENCIES[name] ?? [])
+      reach(dependency)
+  }
+  for (const name of [...siblings.values()].flat())
+    if (OPTIONAL_FRAMEWORKS.has(name) && !targets.some((target) => target.name === name))
+      reach(name)
   if (spriteKit) {
-    reachedFrameworks.add('SpriteKit')
-    reachedFrameworks.add('PeachBox2D')
+    for (const name of ['SpriteKit', 'PeachBox2D', 'simd', 'GLKit']) reach(name)
   }
   // the distribution builder names each object lib/<target>-<file>.o.
   // preserve link order while leaving unreached optional module objects out.
@@ -914,6 +884,10 @@ export function emitSwiftPackageManifest(args: {
   // each target compiles in the language mode and default isolation its
   // author declared, the way xcode builds the same package.
   const stanza = (target: SwiftPackageTarget): string => {
+    // system modules keep their upstream module map and resolve headers and
+    // libraries from the wasm SDK, never the build host's pkg-config paths.
+    if (target.systemLibrary)
+      return `    .systemLibrary(name: ${JSON.stringify(target.name)}, path: ${JSON.stringify(target.path)}),`
     const isolation = target.mainActorIsolation
       ? ' .defaultIsolation(MainActor.self),'
       : ''
@@ -977,17 +951,27 @@ export function emitSwiftPackageManifest(args: {
             .join('')
         : ''
     const kind = target.executable ? '.executableTarget' : '.target'
+    const linkedLibraries = (target.linkedLibraries ?? []).map(
+      (name) => `.linkedLibrary(${JSON.stringify(name)})`,
+    )
+    const librarySettings = [
+      ...linkedLibraries,
+      ...(args.libraries?.has(target.name)
+        ? [`.unsafeFlags([${JSON.stringify(args.libraries.get(target.name))}])`]
+        : []),
+    ]
     const link = target.executable
       ? `,
       linkerSettings: [
+        ${linkedLibraries.map((setting) => `${setting},`).join('\n        ')}
         .unsafeFlags([
           ${REACTOR_FLAG}${EXECUTABLE_LINK_FLAGS}          "-Xlinker", "--export-if-defined=__main_argc_argv"${library},
         ]),
         .unsafeFlags(["-Xlinker", "--strip-all"], .when(configuration: .release)),
       ]`
-      : args.libraries?.has(target.name)
+      : librarySettings.length > 0
         ? `,
-      linkerSettings: [.unsafeFlags([${JSON.stringify(args.libraries.get(target.name))}])]`
+      linkerSettings: [${librarySettings.join(', ')}]`
         : ''
     return [
       `    ${kind}(`,
@@ -1062,7 +1046,8 @@ export function syncSwiftTree(base: string, files: Map<string, string | Buffer>)
 }
 
 // the app runs as iOS, but it compiles for wasm, where `os(iOS)` is false and
-// every iOS branch of the app would compile out. a condition line names iOS
+// every iOS branch of the app would compile out. peach is the iOS simulator,
+// so `targetEnvironment(simulator)` holds too. a condition line names iOS
 // as `true` padded to the same length, so diagnostics keep their columns;
 // os(WASI) still holds for code written for wasm. only `#if` and `#elseif`
 // lines that begin in code change: a line inside a string literal or a block
@@ -1076,7 +1061,7 @@ export function syncSwiftTree(base: string, files: Map<string, string | Buffer>)
 // explicit `@objc(name:)` on a member, whose name becomes a string argument,
 // and a delegate class that becomes final (below).
 const DIRECTIVE = /^[ \t]*#(?:if|elseif)\b/
-const OS_IOS = /\bos\(\s*iOS\s*\)/g
+const OS_IOS = /\b(?:os\(\s*iOS\s*\)|targetEnvironment\(\s*simulator\s*\))/g
 const OBJC_ATTRIBUTE = /^@(?:objcMembers\b|objc\b(?:(\s*)\(([^()]*)\))?|IBAction\b)/
 const SELECTOR = /^#selector\b/
 const PROTOCOL_NAME = /^\s+[A-Za-z_]\w*(\s*:)?/
@@ -1606,12 +1591,73 @@ function compiledSwiftSources(
     const sources = lifted.map(([, contents]) => contents)
     const extensions = objcExtensionMemberIndex(sources)
     const objc = objcIndex(sources)
+    const rooted = objcRootedClasses(sources)
     for (const [file, contents] of lifted)
-      compiled.set(file, swiftSourceAsIOS(contents, extensions, objc))
+      compiled.set(
+        file,
+        hideObjCClassesFromCxx(swiftSourceAsIOS(contents, extensions, objc), rooted),
+      )
   }
   return compiled
 }
 
+// an Apple framework protocol a class may list first, which is no superclass
+const APPLE_PROTOCOL =
+  /^NS(?:Mutable)?Copying$|^NS(?:Secure)?Coding$|^NSLocking$|^NSFastEnumeration$|^NSObjectProtocol$|(?:Delegate|DataSource)$/
+
+// the module's classes whose superclass chain, through the classes `sources`
+// declare, reaches an Apple framework class: Objective-C classes on iOS
+function objcRootedClasses(sources: string[]): Set<string> {
+  const bases = new Map<string, string>()
+  for (const source of sources)
+    for (const match of swiftCodeMask(source).matchAll(
+      /\bclass\s+(?!(?:func|var|let|subscript)\b)([A-Za-z_]\w*)\s*(?:<[^>{]*>)?\s*:\s*(?:[A-Za-z_]\w*\.)*([A-Za-z_]\w*)/g,
+    ))
+      bases.set(match[1]!, match[2]!)
+  const rooted = new Set<string>()
+  for (const name of bases.keys()) {
+    const seen = new Set([name])
+    let base = bases.get(name)!
+    while (bases.has(base) && !seen.has(base)) {
+      seen.add(base)
+      base = bases.get(base)!
+    }
+    if (
+      !bases.has(base) &&
+      APPLE_CLASS.test(base) &&
+      !APPLE_PROTOCOL.test(base) &&
+      !(base in SDK_OBJC_OPTIONAL)
+    )
+      rooted.add(name)
+  }
+  return rooted
+}
+
+// the header swift emits on iOS keeps an Objective-C class out of its C++
+// section. here its root is a swift class from a module with no C++ header,
+// so C++ that includes the header fails on the undeclared base. a top-level
+// class in `rooted` gains @_expose(!Cxx) in front of its declaration,
+// shifting that one line's columns. swift rejects the attribute in a local
+// scope, so a nested class keeps its exposure.
+function hideObjCClassesFromCxx(source: string, rooted: Set<string>): string {
+  if (rooted.size === 0) return source
+  const code = swiftCodeMask(source)
+  const starts: number[] = []
+  let depth = 0
+  for (const match of code.matchAll(
+    /[{}]|\bclass\s+(?!(?:func|var|let|subscript)\b)([A-Za-z_]\w*)/g,
+  )) {
+    if (match[0] === '{') depth++
+    else if (match[0] === '}') depth--
+    else if (depth === 0 && rooted.has(match[1]!))
+      starts.push(declarationStart(code, match.index, 0))
+  }
+  let out = source
+  for (const at of starts.reverse())
+    out = `${out.slice(0, at)}@_expose(!Cxx) ${out.slice(at)}`
+  return out
+}
+
 // wasm Swift has no ObjC runtime, so a member read on AnyObject never
 // resolves: `value of type 'AnyObject' has no member 'doubleValue'`. native
 // code that bridges dictionary values through AnyObject to reach NSNumber's
@@ -3602,6 +3648,8 @@ export type ObjCIndex = {
   // each @objc type method's selector to its result type, null when two
   // declarations disagree
   typeMethods: Map<string, string | null>
+  // NSObject and protocols constrained to it without a Swift init requirement
+  nsObjectTypes: Set<string>
 }
 
 // the @objc type methods `source` declares, by selector, into `found`
@@ -3739,15 +3787,43 @@ export function objcIndex(sources: string[]): ObjCIndex {
         /\b(?:var|let)\s+([A-Za-z_]\w*)/g,
       ))
         variables.add(declared[1]!)
-  const parents = requirements.size
-    ? inheritedTypes(sources)
-    : new Map<string, Set<string>>()
+  const parents = inheritedTypes(sources)
   for (const [protocol, inherited] of sdkParents)
     parents.set(protocol, new Set([...(parents.get(protocol) ?? []), ...inherited]))
   const conformers = requirements.size
     ? conformingTypes(parents, new Set(requirements.keys()))
     : new Map<string, Set<string>>()
-  return { requirements, conformers, callable, variables, aliases, typeMethods }
+  const protocols = new Set<string>()
+  const initializers = new Set<string>()
+  for (const source of sources) {
+    if (!/\bprotocol\b/.test(source)) continue
+    const code = swiftCodeMask(source)
+    const braces = [...code.matchAll(/[{}]/g)].map((match) => match.index)
+    for (const protocol of code.matchAll(/\bprotocol\s+([A-Za-z_]\w*)[^{}]*\{/g)) {
+      const name = protocol[1]!
+      protocols.add(name)
+      const open = protocol.index + protocol[0].length - 1
+      if (
+        /\binit\s*[?!]?\s*\(/.test(code.slice(open + 1, closingBrace(code, braces, open)))
+      )
+        initializers.add(name)
+    }
+  }
+  const rooted = conformingTypes(parents, new Set(['NSObject']))
+  const initialized = conformingTypes(parents, initializers)
+  const nsObjectTypes = new Set([
+    'NSObject',
+    ...[...protocols].filter((name) => rooted.has(name) && !initialized.has(name)),
+  ])
+  return {
+    requirements,
+    conformers,
+    callable,
+    variables,
+    aliases,
+    typeMethods,
+    nsObjectTypes,
+  }
 }
 
 // the non-generic file-scope typealiases `sources` declare, each resolved
@@ -4117,7 +4193,7 @@ const IMP_CONVENTION = /@convention\(c\)(?=\s*\(\s*AnyObject\s*,\s*Selector\b)/g
 
 function lowerObjCRuntimeCalls(source: string, index: ObjCIndex): string {
   const casts = source.includes('@convention(c)')
-  const classes = /\b(?:AnyClass|AnyObject)\b/.test(source)
+  const classes = /\b(?:AnyClass|AnyObject)\b|\.\s*init\s*\(/.test(source)
   if (!casts && !classes) return source
   const code = swiftCodeMask(source)
   const edits: [number, number, string][] = []
@@ -4148,15 +4224,33 @@ function lowerObjCRuntimeCalls(source: string, index: ObjCIndex): string {
     }
   }
   if (classes) {
-    // every declaration of a name, typed or not; a receiver is an AnyClass
-    // or AnyObject only where its innermost declaration in scope says so
+    // every declaration of a name, typed or not; a receiver's innermost
+    // declaration in scope determines its runtime operation
     const declarations = new Map<string, { at: number; type: string }[]>()
     for (const declared of code.matchAll(
-      /(?:\b(?:let|var)\s+|[(,]\s*(?:[A-Za-z_]\w*\s+)?)([A-Za-z_]\w*)\s*:\s*(?:([A-Z]\w*(?:\.\w+)*)\s*([?!])?|[[(])|\b(?:let|var|for)\s+([A-Za-z_]\w*)\b(?!\s*:)|[{,]\s*([A-Za-z_]\w*)\s+in\b/g,
+      /(?:\b(?:let|var)\s+|[(,]\s*(?:[A-Za-z_]\w*\s+)?)([A-Za-z_]\w*)\s*:\s*(?:(?:any\s+)?([A-Z]\w*(?:\.\w+)*)\s*([?!])?|[[(])|\b(?:let|var|for)\s+([A-Za-z_]\w*)\b(?!\s*:)|[{,]\s*([A-Za-z_]\w*)\s+in\b/g,
     )) {
       const name = declared[1] ?? declared[4] ?? declared[5]!
       const list = declarations.get(name) ?? []
-      list.push({ at: declared.index, type: declared[3] ? '' : (declared[2] ?? '') })
+      let type = declared[3] ? '' : (declared[2] ?? '')
+      if (!type && declared[4]) {
+        // NSClassFromString's checked cast establishes the metatype of a
+        // successful conditional binding, including a guard's remaining body.
+        const lookup = /^\s*=\s*NSClassFromString\s*\(/.exec(
+          code.slice(declared.index + declared[0].length),
+        )
+        if (lookup) {
+          const open = declared.index + declared[0].length + lookup[0].length - 1
+          type =
+            /^\s*as\?\s*([A-Za-z_]\w*(?:\.\w+)*\.Type)\b/.exec(
+              code.slice(closingParen(code, open) + 1),
+            )?.[1] ?? ''
+        }
+      }
+      const resolved = type.endsWith('.Type')
+        ? `${resolveAliases(type.slice(0, -5), index.aliases)}.Type`
+        : resolveAliases(type, index.aliases)
+      list.push({ at: declared.index, type: resolved })
       declarations.set(name, list)
     }
     // a tuple or enum pattern (`let (a, b)`, `case let .some(a)`) binds
@@ -4174,7 +4268,7 @@ function lowerObjCRuntimeCalls(source: string, index: ObjCIndex): string {
     }
     for (const list of declarations.values()) list.sort((a, b) => a.at - b.at)
     const braces = [...code.matchAll(/[{}]/g)].map((match) => match.index)
-    const receives = (name: string, at: number, type: string): boolean => {
+    const receiverType = (name: string, at: number): string | undefined => {
       let innermost: { from: number; type: string } | undefined
       for (const declared of declarations.get(name) ?? []) {
         if (declared.at > at) break
@@ -4182,22 +4276,40 @@ function lowerObjCRuntimeCalls(source: string, index: ObjCIndex): string {
         if (at > from && at < to && (!innermost || from >= innermost.from))
           innermost = { from, type: declared.type }
       }
-      return innermost?.type === type
+      return innermost?.type
     }
     let reached = -1
     for (const call of code.matchAll(
       /(?<![\w.])((?:type\s*\(\s*of\s*:\s*([A-Za-z_]\w*)\s*\))|[A-Za-z_]\w*)\s*\.\s*([A-Za-z_]\w*)\s*\(/g,
     )) {
-      if (
-        call.index < reached ||
-        !(call[2]
-          ? receives(call[2], call.index, 'AnyObject')
-          : receives(call[1]!, call.index, 'AnyClass'))
-      )
-        continue
+      if (call.index < reached) continue
+      const type = receiverType(call[2] ?? call[1]!, call.index)
+      const constructed = call[2] ? type : type?.replace(/\.Type$/, '')
+      const constructs =
+        call[3] === 'init' &&
+        constructed &&
+        (call[2] || type?.endsWith('.Type')) &&
+        index.nsObjectTypes.has(constructed.replace(/^Foundation\./, ''))
+      if (!constructs && type !== (call[2] ? 'AnyObject' : 'AnyClass')) continue
       const open = call.index + call[0].length - 1
       const shut = closingParen(code, open)
       const passed = callArguments(source, code, open, shut)
+      if (constructs && passed.length === 0) {
+        // a class-constrained protocol metatype otherwise erases a generic
+        // initializer result to NSObject, losing its protocol requirements.
+        const result =
+          constructed.replace(/^Foundation\./, '') === 'NSObject'
+            ? constructed
+            : `any ${constructed}`
+        edits.push([
+          call.index,
+          shut + 1 - call.index,
+          `_objcNSObjectDefaultInit(${call[1]}, returning: (${result}).self)`,
+        ])
+        reached = shut + 1
+        continue
+      }
+      if (type !== (call[2] ? 'AnyObject' : 'AnyClass')) continue
       const selector = objcSelectorName(
         call[3]!,
         passed.map(({ label }) => label),
@@ -4229,7 +4341,7 @@ function lowerObjCRuntimeCalls(source: string, index: ObjCIndex): string {
 // char outside code (comments, strings, regex literals) reads as a space,
 // so an identifier that survives is code. newlines stay, keeping every
 // offset valid in both views.
-function swiftCodeMask(source: string): string {
+export function swiftCodeMask(source: string): string {
   const chars = source.split('')
   const blank = (from: number, to: number): void => {
     for (let i = Math.max(0, from); i < Math.min(to, chars.length); i++)
@@ -4344,6 +4456,710 @@ function swiftCodeMask(source: string): string {
   return chars.join('')
 }
 
+// darwin declares these in Foundation; the guest networking module owns them.
+const FOUNDATION_NETWORKING_TYPES = new Set([
+  'CachedURLResponse',
+  'HTTPCookieStorage',
+  'HTTPURLResponse',
+  'NSMutableURLRequest',
+  'NSURLConnection',
+  'NSURLConnectionDataDelegate',
+  'NSURLConnectionDelegate',
+  'NSURLConnectionDownloadDelegate',
+  'URLAuthenticationChallenge',
+  'URLAuthenticationChallengeSender',
+  'URLCache',
+  'URLCredential',
+  'URLCredentialStorage',
+  'URLProtectionSpace',
+  'URLProtocol',
+  'URLProtocolClient',
+  'URLRequest',
+  'URLResponse',
+  'URLSession',
+  'URLSessionConfiguration',
+  'URLSessionDataDelegate',
+  'URLSessionDataTask',
+  'URLSessionDelegate',
+  'URLSessionDownloadDelegate',
+  'URLSessionDownloadTask',
+  'URLSessionStreamDelegate',
+  'URLSessionStreamTask',
+  'URLSessionTask',
+  'URLSessionTaskDelegate',
+  'URLSessionTaskMetrics',
+  'URLSessionTaskTransactionMetrics',
+  'URLSessionUploadTask',
+  'URLSessionWebSocketDelegate',
+  'URLSessionWebSocketTask',
+])
+
+// Foundation overlay declarations live in the shared guest overlay module.
+const FOUNDATION_OVERLAY_TYPES = new Set([
+  'AsyncCharacterSequence',
+  'AsyncLineSequence',
+  'AsyncUnicodeScalarSequence',
+  'BlockOperation',
+  'DateComponentsFormatter',
+  'ErrorUserInfoKey',
+  'FileWrapper',
+  'HTTPCookie',
+  'HTTPCookiePropertyKey',
+  'HTTPCookieStringPolicy',
+  'InlinePresentationIntent',
+  'ListFormatter',
+  'LocalizedStringResource',
+  'MachError',
+  'MeasurementFormatUnitUsage',
+  'MeasurementFormatter',
+  'MessagePort',
+  'NSAssertionHandler',
+  'NSAttributedStringFormattingContextKey',
+  'NSBundleResourceRequest',
+  'NSCollectionChangeType',
+  'NSConditionLock',
+  'NSDataDetector',
+  'NSException',
+  'NSExtensionContext',
+  'NSExtensionItem',
+  'NSExtensionRequestHandling',
+  'NSFastEnumerationIterator',
+  'NSFastEnumerationState',
+  'NSFileAccessIntent',
+  'NSFileCoordinator',
+  'NSFileManagerResumeSyncBehavior',
+  'NSFileManagerSupportedSyncControls',
+  'NSFileManagerUploadLocalVersionConflictPolicy',
+  'NSFileProviderService',
+  'NSFileProviderServiceName',
+  'NSFileSecurity',
+  'NSFileVersion',
+  'NSGrammaticalCase',
+  'NSGrammaticalDefiniteness',
+  'NSGrammaticalDetermination',
+  'NSGrammaticalGender',
+  'NSGrammaticalNumber',
+  'NSGrammaticalPartOfSpeech',
+  'NSGrammaticalPerson',
+  'NSGrammaticalPronounType',
+  'NSHashEnumerator',
+  'NSHashTable',
+  'NSHashTableCallBacks',
+  'NSItemProvider',
+  'NSItemProviderFileOptions',
+  'NSItemProviderRepresentationVisibility',
+  'NSKeyValueOperator',
+  'NSKeyValueSetMutationKind',
+  'NSKeyValueSharedObservers',
+  'NSLinguisticTag',
+  'NSLinguisticTagScheme',
+  'NSLinguisticTagger',
+  'NSLinguisticTaggerUnit',
+  'NSMachPort',
+  'NSMapEnumerator',
+  'NSMapTable',
+  'NSMapTableKeyCallBacks',
+  'NSMapTableValueCallBacks',
+  'NSMetadataItem',
+  'NSMetadataQuery',
+  'NSMetadataQueryAttributeValueTuple',
+  'NSMetadataQueryDelegate',
+  'NSMetadataQueryResultGroup',
+  'NSOrderedCollectionChange',
+  'NSOrderedCollectionDifference',
+  'NSOrderedCollectionDifferenceCalculationOptions',
+  'NSPointerArray',
+  'NSPointerFunctions',
+  'NSPredicateValidating',
+  'NSProxy',
+  'NSPurgeableData',
+  'NSSecureUnarchiveFromDataTransformer',
+  'NSSwappedDouble',
+  'NSSwappedFloat',
+  'NSURLRequest',
+  'NSUbiquitousKeyValueStore',
+  'NSUserActivity',
+  'NSUserActivityDelegate',
+  'NSValueTransformerName',
+  'NSXPCCoder',
+  'NSXPCConnection',
+  'NSXPCInterface',
+  'NSXPCListener',
+  'NSXPCListenerDelegate',
+  'NSXPCListenerEndpoint',
+  'NetService',
+  'NetServiceBrowser',
+  'NetServiceBrowserDelegate',
+  'NetServiceDelegate',
+  'NotificationQueue',
+  'Operation',
+  'OperationQueue',
+  'PredicateCodableConfiguration',
+  'PresentationIntent',
+  'Progress',
+  'ProgressKind',
+  'ProgressUserInfoKey',
+  'RelativeDateTimeFormatter',
+  'SocketPort',
+  'StringEncodingDetectionOptionsKey',
+  'TermOfAddress',
+  'URLFileProtection',
+  'URLResource',
+  'URLThumbnailDictionaryItem',
+  'URLUbiquitousItemDownloadingStatus',
+  'URLUbiquitousSharedItemPermissions',
+  'URLUbiquitousSharedItemRole',
+  'UndoManager',
+  'ValueTransformer',
+  'XMLParser',
+  'XMLParserDelegate',
+])
+
+// existing overlay globals retain their declaration and runtime owner.
+const FOUNDATION_OVERLAY_GLOBALS = new Set([
+  'CFBridgingRetain',
+  'NSASCIIStringEncoding',
+  'NSAllHashTableObjects',
+  'NSAllMapTableKeys',
+  'NSAllMapTableValues',
+  'NSAllocateMemoryPages',
+  'NSAssertionHandlerKey',
+  'NSBuddhistCalendar',
+  'NSBundleErrorMaximum',
+  'NSBundleErrorMinimum',
+  'NSBundleExecutableArchitectureARM64',
+  'NSBundleExecutableArchitectureI386',
+  'NSBundleExecutableArchitecturePPC',
+  'NSBundleExecutableArchitecturePPC64',
+  'NSBundleExecutableArchitectureX86_64',
+  'NSBundleOnDemandResourceExceededMaximumSizeError',
+  'NSBundleOnDemandResourceInvalidTagError',
+  'NSBundleOnDemandResourceOutOfSpaceError',
+  'NSBundleResourceRequestLoadingPriorityUrgent',
+  'NSChineseCalendar',
+  'NSCloudSharingConflictError',
+  'NSCloudSharingErrorMaximum',
+  'NSCloudSharingErrorMinimum',
+  'NSCloudSharingNetworkFailureError',
+  'NSCloudSharingNoPermissionError',
+  'NSCloudSharingOtherError',
+  'NSCloudSharingQuotaExceededError',
+  'NSCloudSharingTooManyParticipantsError',
+  'NSCoderErrorMaximum',
+  'NSCoderErrorMinimum',
+  'NSCoderInvalidValueError',
+  'NSCompareHashTables',
+  'NSCompareMapTables',
+  'NSCompressionErrorMaximum',
+  'NSCompressionErrorMinimum',
+  'NSCompressionFailedError',
+  'NSConvertHostDoubleToSwapped',
+  'NSConvertHostFloatToSwapped',
+  'NSConvertSwappedDoubleToHost',
+  'NSConvertSwappedFloatToHost',
+  'NSCopyMemoryPages',
+  'NSCountHashTable',
+  'NSCountMapTable',
+  'NSCreateHashTable',
+  'NSCreateMapTable',
+  'NSDeallocateMemoryPages',
+  'NSDecompressionFailedError',
+  'NSEndHashTableEnumeration',
+  'NSEndMapTableEnumeration',
+  'NSEnumerateHashTable',
+  'NSEnumerateMapTable',
+  'NSExecutableErrorMaximum',
+  'NSExecutableErrorMinimum',
+  'NSExtensionItemAttachmentsKey',
+  'NSExtensionItemAttributedContentTextKey',
+  'NSExtensionItemAttributedTitleKey',
+  'NSExtensionItemsAndErrorsKey',
+  'NSExtensionJavaScriptFinalizeArgumentKey',
+  'NSExtensionJavaScriptPreprocessingResultsKey',
+  'NSFileErrorMaximum',
+  'NSFileErrorMinimum',
+  'NSFormattingErrorMaximum',
+  'NSFormattingErrorMinimum',
+  'NSFoundationVersionNumber',
+  'NSFoundationVersionNumber10_0',
+  'NSFoundationVersionNumber10_1',
+  'NSFoundationVersionNumber10_10',
+  'NSFoundationVersionNumber10_10_1',
+  'NSFoundationVersionNumber10_10_2',
+  'NSFoundationVersionNumber10_10_3',
+  'NSFoundationVersionNumber10_10_4',
+  'NSFoundationVersionNumber10_10_5',
+  'NSFoundationVersionNumber10_10_Max',
+  'NSFoundationVersionNumber10_11',
+  'NSFoundationVersionNumber10_11_1',
+  'NSFoundationVersionNumber10_11_2',
+  'NSFoundationVersionNumber10_11_3',
+  'NSFoundationVersionNumber10_11_4',
+  'NSFoundationVersionNumber10_11_Max',
+  'NSFoundationVersionNumber10_1_1',
+  'NSFoundationVersionNumber10_1_2',
+  'NSFoundationVersionNumber10_1_3',
+  'NSFoundationVersionNumber10_1_4',
+  'NSFoundationVersionNumber10_2',
+  'NSFoundationVersionNumber10_2_1',
+  'NSFoundationVersionNumber10_2_2',
+  'NSFoundationVersionNumber10_2_3',
+  'NSFoundationVersionNumber10_2_4',
+  'NSFoundationVersionNumber10_2_5',
+  'NSFoundationVersionNumber10_2_6',
+  'NSFoundationVersionNumber10_2_7',
+  'NSFoundationVersionNumber10_2_8',
+  'NSFoundationVersionNumber10_3',
+  'NSFoundationVersionNumber10_3_1',
+  'NSFoundationVersionNumber10_3_2',
+  'NSFoundationVersionNumber10_3_3',
+  'NSFoundationVersionNumber10_3_4',
+  'NSFoundationVersionNumber10_3_5',
+  'NSFoundationVersionNumber10_3_6',
+  'NSFoundationVersionNumber10_3_7',
+  'NSFoundationVersionNumber10_3_8',
+  'NSFoundationVersionNumber10_3_9',
+  'NSFoundationVersionNumber10_4',
+  'NSFoundationVersionNumber10_4_1',
+  'NSFoundationVersionNumber10_4_10',
+  'NSFoundationVersionNumber10_4_11',
+  'NSFoundationVersionNumber10_4_2',
+  'NSFoundationVersionNumber10_4_3',
+  'NSFoundationVersionNumber10_4_4_Intel',
+  'NSFoundationVersionNumber10_4_4_PowerPC',
+  'NSFoundationVersionNumber10_4_5',
+  'NSFoundationVersionNumber10_4_6',
+  'NSFoundationVersionNumber10_4_7',
+  'NSFoundationVersionNumber10_4_8',
+  'NSFoundationVersionNumber10_4_9',
+  'NSFoundationVersionNumber10_5',
+  'NSFoundationVersionNumber10_5_1',
+  'NSFoundationVersionNumber10_5_2',
+  'NSFoundationVersionNumber10_5_3',
+  'NSFoundationVersionNumber10_5_4',
+  'NSFoundationVersionNumber10_5_5',
+  'NSFoundationVersionNumber10_5_6',
+  'NSFoundationVersionNumber10_5_7',
+  'NSFoundationVersionNumber10_5_8',
+  'NSFoundationVersionNumber10_6',
+  'NSFoundationVersionNumber10_6_1',
+  'NSFoundationVersionNumber10_6_2',
+  'NSFoundationVersionNumber10_6_3',
+  'NSFoundationVersionNumber10_6_4',
+  'NSFoundationVersionNumber10_6_5',
+  'NSFoundationVersionNumber10_6_6',
+  'NSFoundationVersionNumber10_6_7',
+  'NSFoundationVersionNumber10_6_8',
+  'NSFoundationVersionNumber10_7',
+  'NSFoundationVersionNumber10_7_1',
+  'NSFoundationVersionNumber10_7_2',
+  'NSFoundationVersionNumber10_7_3',
+  'NSFoundationVersionNumber10_7_4',
+  'NSFoundationVersionNumber10_8',
+  'NSFoundationVersionNumber10_8_1',
+  'NSFoundationVersionNumber10_8_2',
+  'NSFoundationVersionNumber10_8_3',
+  'NSFoundationVersionNumber10_8_4',
+  'NSFoundationVersionNumber10_9',
+  'NSFoundationVersionNumber10_9_1',
+  'NSFoundationVersionNumber10_9_2',
+  'NSFoundationVersionNumber_iOS_4_0',
+  'NSFoundationVersionNumber_iOS_4_1',
+  'NSFoundationVersionNumber_iOS_4_2',
+  'NSFoundationVersionNumber_iOS_4_3',
+  'NSFoundationVersionNumber_iOS_5_0',
+  'NSFoundationVersionNumber_iOS_5_1',
+  'NSFoundationVersionNumber_iOS_6_0',
+  'NSFoundationVersionNumber_iOS_6_1',
+  'NSFoundationVersionNumber_iOS_7_0',
+  'NSFoundationVersionNumber_iOS_7_1',
+  'NSFoundationVersionNumber_iOS_8_0',
+  'NSFoundationVersionNumber_iOS_8_1',
+  'NSFoundationVersionNumber_iOS_8_2',
+  'NSFoundationVersionNumber_iOS_8_3',
+  'NSFoundationVersionNumber_iOS_8_4',
+  'NSFoundationVersionNumber_iOS_8_x_Max',
+  'NSFoundationVersionNumber_iOS_9_0',
+  'NSFoundationVersionNumber_iOS_9_1',
+  'NSFoundationVersionNumber_iOS_9_2',
+  'NSFoundationVersionNumber_iOS_9_3',
+  'NSFoundationVersionNumber_iOS_9_4',
+  'NSFoundationVersionNumber_iOS_9_x_Max',
+  'NSFoundationVersionNumber_iPhoneOS_2_0',
+  'NSFoundationVersionNumber_iPhoneOS_2_1',
+  'NSFoundationVersionNumber_iPhoneOS_2_2',
+  'NSFoundationVersionNumber_iPhoneOS_3_0',
+  'NSFoundationVersionNumber_iPhoneOS_3_1',
+  'NSFoundationVersionNumber_iPhoneOS_3_2',
+  'NSFoundationVersionWithFileManagerResourceForkSupport',
+  'NSFreeHashTable',
+  'NSFreeMapTable',
+  'NSGetUncaughtExceptionHandler',
+  'NSGregorianCalendar',
+  'NSHPUXOperatingSystem',
+  'NSHashGet',
+  'NSHashInsert',
+  'NSHashInsertIfAbsent',
+  'NSHashInsertKnownAbsent',
+  'NSHashRemove',
+  'NSHashTableCopyIn',
+  'NSHashTableObjectPointerPersonality',
+  'NSHashTableStrongMemory',
+  'NSHashTableWeakMemory',
+  'NSHebrewCalendar',
+  'NSHostByteOrder',
+  'NSISO2022JPStringEncoding',
+  'NSISO8601Calendar',
+  'NSISOLatin1StringEncoding',
+  'NSISOLatin2StringEncoding',
+  'NSIndianCalendar',
+  'NSIslamicCalendar',
+  'NSIslamicCivilCalendar',
+  'NSItemProviderPreferredImageSizeKey',
+  'NSJapaneseCalendar',
+  'NSJapaneseEUCStringEncoding',
+  'NSLoadedClasses',
+  'NSLocalizedFailureErrorKey',
+  'NSLogPageSize',
+  'NSMACHOperatingSystem',
+  'NSMacOSRomanStringEncoding',
+  'NSMapGet',
+  'NSMapInsert',
+  'NSMapInsertIfAbsent',
+  'NSMapInsertKnownAbsent',
+  'NSMapMember',
+  'NSMapRemove',
+  'NSMapTableCopyIn',
+  'NSMapTableObjectPointerPersonality',
+  'NSMapTableStrongMemory',
+  'NSMapTableWeakMemory',
+  'NSMetadataItemContentTypeKey',
+  'NSMetadataItemContentTypeTreeKey',
+  'NSMetadataItemDisplayNameKey',
+  'NSMetadataItemFSContentChangeDateKey',
+  'NSMetadataItemFSCreationDateKey',
+  'NSMetadataItemFSNameKey',
+  'NSMetadataItemFSSizeKey',
+  'NSMetadataItemIsUbiquitousKey',
+  'NSMetadataItemPathKey',
+  'NSMetadataItemURLKey',
+  'NSMetadataQueryAccessibleUbiquitousExternalDocumentsScope',
+  'NSMetadataQueryResultContentRelevanceAttribute',
+  'NSMetadataQueryUbiquitousDataScope',
+  'NSMetadataQueryUbiquitousDocumentsScope',
+  'NSMetadataQueryUpdateAddedItemsKey',
+  'NSMetadataQueryUpdateChangedItemsKey',
+  'NSMetadataQueryUpdateRemovedItemsKey',
+  'NSMetadataUbiquitousItemContainerDisplayNameKey',
+  'NSMetadataUbiquitousItemDownloadRequestedKey',
+  'NSMetadataUbiquitousItemDownloadingErrorKey',
+  'NSMetadataUbiquitousItemDownloadingStatusCurrent',
+  'NSMetadataUbiquitousItemDownloadingStatusDownloaded',
+  'NSMetadataUbiquitousItemDownloadingStatusKey',
+  'NSMetadataUbiquitousItemDownloadingStatusNotDownloaded',
+  'NSMetadataUbiquitousItemHasUnresolvedConflictsKey',
+  'NSMetadataUbiquitousItemIsDownloadingKey',
+  'NSMetadataUbiquitousItemIsExternalDocumentKey',
+  'NSMetadataUbiquitousItemIsSharedKey',
+  'NSMetadataUbiquitousItemIsUploadedKey',
+  'NSMetadataUbiquitousItemIsUploadingKey',
+  'NSMetadataUbiquitousItemPercentDownloadedKey',
+  'NSMetadataUbiquitousItemPercentUploadedKey',
+  'NSMetadataUbiquitousItemURLInLocalContainerKey',
+  'NSMetadataUbiquitousItemUploadingErrorKey',
+  'NSMetadataUbiquitousSharedItemCurrentUserPermissionsKey',
+  'NSMetadataUbiquitousSharedItemCurrentUserRoleKey',
+  'NSMetadataUbiquitousSharedItemMostRecentEditorNameComponentsKey',
+  'NSMetadataUbiquitousSharedItemOwnerNameComponentsKey',
+  'NSMetadataUbiquitousSharedItemPermissionsReadOnly',
+  'NSMetadataUbiquitousSharedItemPermissionsReadWrite',
+  'NSMetadataUbiquitousSharedItemRoleOwner',
+  'NSMetadataUbiquitousSharedItemRoleParticipant',
+  'NSMultipleUnderlyingErrorsKey',
+  'NSNEXTSTEPStringEncoding',
+  'NSNextHashEnumeratorItem',
+  'NSNextMapEnumeratorPair',
+  'NSNonLossyASCIIStringEncoding',
+  'NSNonOwnedPointerHashCallBacks',
+  'NSNonOwnedPointerMapKeyCallBacks',
+  'NSNonOwnedPointerMapValueCallBacks',
+  'NSNonOwnedPointerOrNullMapKeyCallBacks',
+  'NSNonRetainedObjectHashCallBacks',
+  'NSNonRetainedObjectMapKeyCallBacks',
+  'NSNonRetainedObjectMapValueCallBacks',
+  'NSOSF1OperatingSystem',
+  'NSObjectHashCallBacks',
+  'NSObjectMapKeyCallBacks',
+  'NSObjectMapValueCallBacks',
+  'NSOpenStepRootDirectory',
+  'NSOpenStepUnicodeReservedBase',
+  'NSOwnedObjectIdentityHashCallBacks',
+  'NSOwnedPointerHashCallBacks',
+  'NSOwnedPointerMapKeyCallBacks',
+  'NSOwnedPointerMapValueCallBacks',
+  'NSPersianCalendar',
+  'NSPointerToStructHashCallBacks',
+  'NSPropertyListErrorMaximum',
+  'NSPropertyListErrorMinimum',
+  'NSProprietaryStringEncoding',
+  'NSProtocolFromString',
+  'NSRepublicOfChinaCalendar',
+  'NSResetHashTable',
+  'NSResetMapTable',
+  'NSShiftJISStringEncoding',
+  'NSSolarisOperatingSystem',
+  'NSStringFromHashTable',
+  'NSStringFromMapTable',
+  'NSStringFromProtocol',
+  'NSSunOSOperatingSystem',
+  'NSSwapBigDoubleToHost',
+  'NSSwapBigFloatToHost',
+  'NSSwapBigIntToHost',
+  'NSSwapBigLongLongToHost',
+  'NSSwapBigLongToHost',
+  'NSSwapBigShortToHost',
+  'NSSwapDouble',
+  'NSSwapFloat',
+  'NSSwapHostDoubleToBig',
+  'NSSwapHostDoubleToLittle',
+  'NSSwapHostFloatToBig',
+  'NSSwapHostFloatToLittle',
+  'NSSwapHostIntToBig',
+  'NSSwapHostIntToLittle',
+  'NSSwapHostLongLongToBig',
+  'NSSwapHostLongLongToLittle',
+  'NSSwapHostLongToBig',
+  'NSSwapHostLongToLittle',
+  'NSSwapHostShortToBig',
+  'NSSwapHostShortToLittle',
+  'NSSwapInt',
+  'NSSwapLittleDoubleToHost',
+  'NSSwapLittleFloatToHost',
+  'NSSwapLittleIntToHost',
+  'NSSwapLittleLongLongToHost',
+  'NSSwapLittleLongToHost',
+  'NSSwapLittleShortToHost',
+  'NSSwapLong',
+  'NSSwapLongLong',
+  'NSSwapShort',
+  'NSSymbolStringEncoding',
+  'NSTextCheckingAllCustomTypes',
+  'NSTextCheckingAllSystemTypes',
+  'NSTextCheckingAllTypes',
+  'NSURLAuthenticationMethodHTMLForm',
+  'NSURLAuthenticationMethodNTLM',
+  'NSURLAuthenticationMethodNegotiate',
+  'NSURLCredentialStorageRemoveSynchronizableCredentials',
+  'NSURLErrorFileOutsideSafeArea',
+  'NSURLFileScheme',
+  'NSURLProtectionSpaceFTP',
+  'NSURLProtectionSpaceFTPProxy',
+  'NSURLProtectionSpaceHTTP',
+  'NSURLProtectionSpaceHTTPProxy',
+  'NSURLProtectionSpaceHTTPS',
+  'NSURLProtectionSpaceHTTPSProxy',
+  'NSURLProtectionSpaceSOCKSProxy',
+  'NSURLSessionDownloadTaskResumeData',
+  'NSURLSessionTransferSizeUnknown',
+  'NSURLSessionUploadTaskResumeData',
+  'NSUTF16BigEndianStringEncoding',
+  'NSUTF16LittleEndianStringEncoding',
+  'NSUTF16StringEncoding',
+  'NSUTF32BigEndianStringEncoding',
+  'NSUTF32LittleEndianStringEncoding',
+  'NSUTF32StringEncoding',
+  'NSUTF8StringEncoding',
+  'NSUbiquitousFileErrorMaximum',
+  'NSUbiquitousFileErrorMinimum',
+  'NSUbiquitousKeyValueStoreAccountChange',
+  'NSUbiquitousKeyValueStoreChangeReasonKey',
+  'NSUbiquitousKeyValueStoreChangedKeysKey',
+  'NSUbiquitousKeyValueStoreInitialSyncChange',
+  'NSUbiquitousKeyValueStoreQuotaViolationChange',
+  'NSUbiquitousKeyValueStoreServerChange',
+  'NSUndefinedDateComponent',
+  'NSUndoCloseGroupingRunLoopOrdering',
+  'NSUndoManagerGroupIsDiscardableKey',
+  'NSUnicodeStringEncoding',
+  'NSUserActivityErrorMaximum',
+  'NSUserActivityErrorMinimum',
+  'NSUserActivityTypeBrowsingWeb',
+  'NSValidationErrorMaximum',
+  'NSValidationErrorMinimum',
+  'NSWindows95OperatingSystem',
+  'NSWindowsCP1250StringEncoding',
+  'NSWindowsCP1251StringEncoding',
+  'NSWindowsCP1252StringEncoding',
+  'NSWindowsCP1253StringEncoding',
+  'NSWindowsCP1254StringEncoding',
+  'NSWindowsNTOperatingSystem',
+  'NSWrapCalendarComponents',
+  'NSXPCConnectionCodeSigningRequirementFailure',
+  'NSXPCConnectionErrorMaximum',
+  'NSXPCConnectionErrorMinimum',
+  'NS_BigEndian',
+  'NS_LittleEndian',
+  'NS_UnknownByteOrder',
+  'kCFStringEncodingASCII',
+])
+
+const CORE_FOUNDATION_OVERLAY_GLOBALS = new Set([
+  'kCFCoreFoundationVersionNumber10_0',
+  'kCFCoreFoundationVersionNumber10_0_3',
+  'kCFCoreFoundationVersionNumber10_1',
+  'kCFCoreFoundationVersionNumber10_10',
+  'kCFCoreFoundationVersionNumber10_10_1',
+  'kCFCoreFoundationVersionNumber10_10_2',
+  'kCFCoreFoundationVersionNumber10_10_3',
+  'kCFCoreFoundationVersionNumber10_10_4',
+  'kCFCoreFoundationVersionNumber10_10_5',
+  'kCFCoreFoundationVersionNumber10_10_Max',
+  'kCFCoreFoundationVersionNumber10_11',
+  'kCFCoreFoundationVersionNumber10_11_1',
+  'kCFCoreFoundationVersionNumber10_11_2',
+  'kCFCoreFoundationVersionNumber10_11_3',
+  'kCFCoreFoundationVersionNumber10_11_4',
+  'kCFCoreFoundationVersionNumber10_11_Max',
+  'kCFCoreFoundationVersionNumber10_1_1',
+  'kCFCoreFoundationVersionNumber10_1_2',
+  'kCFCoreFoundationVersionNumber10_1_3',
+  'kCFCoreFoundationVersionNumber10_1_4',
+  'kCFCoreFoundationVersionNumber10_2',
+  'kCFCoreFoundationVersionNumber10_2_1',
+  'kCFCoreFoundationVersionNumber10_2_2',
+  'kCFCoreFoundationVersionNumber10_2_3',
+  'kCFCoreFoundationVersionNumber10_2_4',
+  'kCFCoreFoundationVersionNumber10_2_5',
+  'kCFCoreFoundationVersionNumber10_2_6',
+  'kCFCoreFoundationVersionNumber10_2_7',
+  'kCFCoreFoundationVersionNumber10_2_8',
+  'kCFCoreFoundationVersionNumber10_3',
+  'kCFCoreFoundationVersionNumber10_3_1',
+  'kCFCoreFoundationVersionNumber10_3_2',
+  'kCFCoreFoundationVersionNumber10_3_3',
+  'kCFCoreFoundationVersionNumber10_3_4',
+  'kCFCoreFoundationVersionNumber10_3_5',
+  'kCFCoreFoundationVersionNumber10_3_6',
+  'kCFCoreFoundationVersionNumber10_3_7',
+  'kCFCoreFoundationVersionNumber10_3_8',
+  'kCFCoreFoundationVersionNumber10_3_9',
+  'kCFCoreFoundationVersionNumber10_4',
+  'kCFCoreFoundationVersionNumber10_4_1',
+  'kCFCoreFoundationVersionNumber10_4_10',
+  'kCFCoreFoundationVersionNumber10_4_11',
+  'kCFCoreFoundationVersionNumber10_4_2',
+  'kCFCoreFoundationVersionNumber10_4_3',
+  'kCFCoreFoundationVersionNumber10_4_4_Intel',
+  'kCFCoreFoundationVersionNumber10_4_4_PowerPC',
+  'kCFCoreFoundationVersionNumber10_4_5_Intel',
+  'kCFCoreFoundationVersionNumber10_4_5_PowerPC',
+  'kCFCoreFoundationVersionNumber10_4_6_Intel',
+  'kCFCoreFoundationVersionNumber10_4_6_PowerPC',
+  'kCFCoreFoundationVersionNumber10_4_7',
+  'kCFCoreFoundationVersionNumber10_4_8',
+  'kCFCoreFoundationVersionNumber10_4_9',
+  'kCFCoreFoundationVersionNumber10_5',
+  'kCFCoreFoundationVersionNumber10_5_1',
+  'kCFCoreFoundationVersionNumber10_5_2',
+  'kCFCoreFoundationVersionNumber10_5_3',
+  'kCFCoreFoundationVersionNumber10_5_4',
+  'kCFCoreFoundationVersionNumber10_5_5',
+  'kCFCoreFoundationVersionNumber10_5_6',
+  'kCFCoreFoundationVersionNumber10_5_7',
+  'kCFCoreFoundationVersionNumber10_5_8',
+  'kCFCoreFoundationVersionNumber10_6',
+  'kCFCoreFoundationVersionNumber10_6_1',
+  'kCFCoreFoundationVersionNumber10_6_2',
+  'kCFCoreFoundationVersionNumber10_6_3',
+  'kCFCoreFoundationVersionNumber10_6_4',
+  'kCFCoreFoundationVersionNumber10_6_5',
+  'kCFCoreFoundationVersionNumber10_6_6',
+  'kCFCoreFoundationVersionNumber10_6_7',
+  'kCFCoreFoundationVersionNumber10_6_8',
+  'kCFCoreFoundationVersionNumber10_7',
+  'kCFCoreFoundationVersionNumber10_7_1',
+  'kCFCoreFoundationVersionNumber10_7_2',
+  'kCFCoreFoundationVersionNumber10_7_3',
+  'kCFCoreFoundationVersionNumber10_7_4',
+  'kCFCoreFoundationVersionNumber10_7_5',
+  'kCFCoreFoundationVersionNumber10_8',
+  'kCFCoreFoundationVersionNumber10_8_1',
+  'kCFCoreFoundationVersionNumber10_8_2',
+  'kCFCoreFoundationVersionNumber10_8_3',
+  'kCFCoreFoundationVersionNumber10_8_4',
+  'kCFCoreFoundationVersionNumber10_9',
+  'kCFCoreFoundationVersionNumber10_9_1',
+  'kCFCoreFoundationVersionNumber10_9_2',
+  'kCFCoreFoundationVersionNumber_iOS_4_0',
+  'kCFCoreFoundationVersionNumber_iOS_4_1',
+  'kCFCoreFoundationVersionNumber_iOS_4_2',
+  'kCFCoreFoundationVersionNumber_iOS_4_3',
+  'kCFCoreFoundationVersionNumber_iOS_5_0',
+  'kCFCoreFoundationVersionNumber_iOS_5_1',
+  'kCFCoreFoundationVersionNumber_iOS_6_0',
+  'kCFCoreFoundationVersionNumber_iOS_6_1',
+  'kCFCoreFoundationVersionNumber_iOS_7_0',
+  'kCFCoreFoundationVersionNumber_iOS_7_1',
+  'kCFCoreFoundationVersionNumber_iOS_8_0',
+  'kCFCoreFoundationVersionNumber_iOS_8_1',
+  'kCFCoreFoundationVersionNumber_iOS_8_2',
+  'kCFCoreFoundationVersionNumber_iOS_8_3',
+  'kCFCoreFoundationVersionNumber_iOS_8_4',
+  'kCFCoreFoundationVersionNumber_iOS_8_x_Max',
+  'kCFCoreFoundationVersionNumber_iOS_9_0',
+  'kCFCoreFoundationVersionNumber_iOS_9_1',
+  'kCFCoreFoundationVersionNumber_iOS_9_2',
+  'kCFCoreFoundationVersionNumber_iOS_9_3',
+  'kCFCoreFoundationVersionNumber_iOS_9_4',
+  'kCFCoreFoundationVersionNumber_iOS_9_x_Max',
+  'kCFCoreFoundationVersionNumber_iPhoneOS_2_0',
+  'kCFCoreFoundationVersionNumber_iPhoneOS_2_1',
+  'kCFCoreFoundationVersionNumber_iPhoneOS_2_2',
+  'kCFCoreFoundationVersionNumber_iPhoneOS_3_0',
+  'kCFCoreFoundationVersionNumber_iPhoneOS_3_1',
+  'kCFCoreFoundationVersionNumber_iPhoneOS_3_2',
+])
+
+// the Darwin CoreFoundation overlay exposes Foundation's geometry identities.
+const CORE_FOUNDATION_GEOMETRY_TYPES = new Set([
+  'CGFloat',
+  'CGPoint',
+  'CGSize',
+  'CGRect',
+  'CGRectEdge',
+])
+
+const CORE_FOUNDATION_GRAPHICS_TYPES = new Set([
+  'CGAffineTransform',
+  'CGAffineTransformComponents',
+  'CGVector',
+])
+
+// scoped imports select native CF handles over overlay bridge aliases without
+// rewriting references or changing the overlay's measured storage contracts.
+const CORE_FOUNDATION_HANDLE_IMPORTS = [
+  'CFAllocator',
+  'CFArray',
+  'CFAttributedString',
+  'CFBoolean',
+  'CFData',
+  'CFDate',
+  'CFDictionary',
+  'CFError',
+  'CFMutableData',
+  'CFNumber',
+  'CFSet',
+  'CFString',
+  'CFURL',
+]
+  .map((name) => `import class CoreFoundation.${name}`)
+  .concat([
+    'import typealias CoreFoundation.CFPropertyList',
+    'import typealias CoreFoundation.CFTypeRef',
+    'import CoreGraphics',
+  ])
+  .join('; ')
+
 export function swiftSourceAsIOS(
   original: string,
   extraObjCExtensions?: Map<string, Set<string>>,
@@ -4409,25 +5225,80 @@ export function swiftSourceAsIOS(
     if (imported) {
       out +=
         conditioned.slice(copied, at) + `import ${imported[1]}`.padEnd(imported[0].length)
+      if (imported[1] === 'CoreFoundation') out += `; ${CORE_FOUNDATION_HANDLE_IMPORTS}`
       copied = at + imported[0].length
       continue
     }
+    const coreFoundationImport = /^import\s+CoreFoundation\b/.exec(rest)
+    if (coreFoundationImport) {
+      out +=
+        conditioned.slice(copied, at) +
+        coreFoundationImport[0] +
+        `; ${CORE_FOUNDATION_HANDLE_IMPORTS}`
+      copied = at + coreFoundationImport[0].length
+      continue
+    }
     if (/^NSClassFromString\b/.test(rest)) {
       out += conditioned.slice(copied, at) + '_peachClassFromString'
       copied = at + 'NSClassFromString'.length
       continue
     }
-    // darwin exports these types from Foundation; wasm leaves unavailable
-    // aliases there and their implementation lives in networking.
-    if (
-      /^Foundation\s*\.\s*(?:HTTPURLResponse|URLAuthenticationChallenge|URLAuthenticationChallengeSender|URLCredential|URLProtectionSpace|URLRequest|URLResponse|URLSession)\b/.test(
-        rest,
+    // darwin exposes these names through Foundation; the guest keeps networking
+    // and overlay declarations in their owning modules.
+    const foundationMember =
+      /^Foundation\s*\.\s*(?:`([A-Za-z_]\w*)`|([A-Za-z_]\w*)\b)/.exec(rest)
+    const foundationName = foundationMember?.[1] ?? foundationMember?.[2]
+    let foundationOwner: string | undefined
+    if (foundationName !== undefined) {
+      if (
+        foundationName === 'NSClassFromString' ||
+        foundationName === 'NSKeyValueChange' ||
+        foundationName === 'NSKeyValueObservedChange' ||
+        foundationName === 'NSKeyValueObservation'
       )
-    ) {
-      out += conditioned.slice(copied, at) + 'FoundationNetworking'
+        foundationOwner = 'PeachObjC'
+      else if (foundationName === 'DispatchData') foundationOwner = 'Dispatch'
+      else if (FOUNDATION_NETWORKING_TYPES.has(foundationName))
+        foundationOwner = 'FoundationNetworking'
+      else if (
+        FOUNDATION_OVERLAY_TYPES.has(foundationName) ||
+        FOUNDATION_OVERLAY_GLOBALS.has(foundationName) ||
+        CORE_FOUNDATION_OVERLAY_GLOBALS.has(foundationName)
+      )
+        foundationOwner = 'PeachFoundation'
+    }
+    if (foundationOwner !== undefined) {
+      out += conditioned.slice(copied, at) + foundationOwner
       copied = at + 'Foundation'.length
       continue
     }
+    const coreFoundationMember =
+      /^CoreFoundation\s*\.\s*(?:`([A-Za-z_]\w*)`|([A-Za-z_]\w*)\b)/.exec(rest)
+    const coreFoundationName = coreFoundationMember?.[1] ?? coreFoundationMember?.[2]
+    if (
+      coreFoundationName !== undefined &&
+      CORE_FOUNDATION_OVERLAY_GLOBALS.has(coreFoundationName)
+    ) {
+      out += conditioned.slice(copied, at) + 'PeachFoundation'
+      copied = at + 'CoreFoundation'.length
+      continue
+    }
+    if (
+      coreFoundationName !== undefined &&
+      CORE_FOUNDATION_GEOMETRY_TYPES.has(coreFoundationName)
+    ) {
+      out += conditioned.slice(copied, at) + 'Foundation'
+      copied = at + 'CoreFoundation'.length
+      continue
+    }
+    if (
+      coreFoundationName !== undefined &&
+      CORE_FOUNDATION_GRAPHICS_TYPES.has(coreFoundationName)
+    ) {
+      out += conditioned.slice(copied, at) + 'CoreGraphics'
+      copied = at + 'CoreFoundation'.length
+      continue
+    }
     if (rest.startsWith('class')) {
       const declared = CLASS_BASE.exec(rest)
       if (declared && reusableViews.has(declared[2]!.split('.').pop()!)) {
@@ -4693,7 +5564,9 @@ function swiftCodeScan(source: string): {
                     ? 'NSClassFromString'
                     : source.startsWith('Foundation', i)
                       ? 'Foundation'
-                      : null
+                      : source.startsWith('CoreFoundation', i)
+                        ? 'CoreFoundation'
+                        : null
       if (
         keyword &&
         !/[\w$]/.test(source[i - 1] ?? '') &&
@@ -5219,18 +6092,29 @@ export function compileSwiftProjectUnit(
     multi: compileTargets(input).length > 0,
   }
   const hash = swiftArtifactHash(input, options.release, moduleRoot)
+  const sharedRoot = path.join(rnxHomeDir(), 'cache', 'swift-projects', hash)
+  const report = (message: string) =>
+    console.error(`[swift-project ${hash.slice(0, 16)}] ${message}`)
+  report('checking verified artifacts')
   return serialize(
     root,
     async () => {
       // reuse one verified result across server restarts before admission or
       // swiftpm. the address covers sources, framework inputs and toolchain.
       const retained = retainedArtifacts.get(root)?.find((old) => old.hash === hash)
-      if (retained) return retain(root, retained)
-      const cached = readCompiledArtifact(path.join(root, 'artifact'), hash)
-      if (cached) return retain(root, cached)
-      // an admitted mac slot already holds the build lock and the pinned
-      // toolchain, so it compiles here. a bare CONTRAST_REMOTE_BUILD value is
-      // only an inherited marker and still dispatches through admission.
+      if (retained) {
+        report('reusing memory artifact')
+        return retain(root, retained)
+      }
+      const cached = readCompiledArtifact(path.join(sharedRoot, 'artifact'), hash)
+      const previous = cached ?? readCompiledArtifact(path.join(root, 'artifact'), hash)
+      if (previous) {
+        if (!cached) saveCompiledArtifact(sharedRoot, previous)
+        report('reusing verified disk artifact')
+        return retain(root, previous)
+      }
+      // a mac builder with a live destination grant compiles here. inherited
+      // transport markers alone still dispatch through admission.
       if (
         process.platform === 'darwin' &&
         process.env.TM_SESSION &&
@@ -5249,11 +6133,18 @@ export function compileSwiftProjectUnit(
             hash,
             release: options.release,
             timeoutMs: options.timeoutMs,
-            buildKey: createHash('sha256').update(root).digest('hex').slice(0, 32),
+            // the builder's swiftpm tree holds the sootsim-swift objects, which
+            // depend on the toolchain and sdk and not on the caller's checkout
+            // path, so every caller shares one warm tree per toolchain.
+            buildKey: createHash('sha256')
+              .update(`${options.release}\0${swiftModuleSdk(moduleRoot).wasmSdkId}`)
+              .digest('hex')
+              .slice(0, 32),
           }),
         )
         try {
           const repo = path.resolve(moduleRoot, '../..')
+          report('requesting builder admission or cached result')
           await runCompiler(
             'bun',
             [
@@ -5282,6 +6173,8 @@ export function compileSwiftProjectUnit(
             )
           }
           saveCompiledArtifact(root, artifact)
+          saveCompiledArtifact(sharedRoot, artifact)
+          report('builder artifact verified')
           return retain(root, artifact)
         } finally {
           rmSync(requestRoot, { recursive: true, force: true })
@@ -5294,6 +6187,7 @@ export function compileSwiftProjectUnit(
           `swift-compile: no swift.org toolchain at ${options.toolchainBin}; install ${options.release} and its matching wasm sdk`,
         )
       }
+      report('preparing compiler plugins')
       const macroPlugins = await ensureMacroPlugins(
         moduleRoot,
         options.toolchainBin,
@@ -5306,12 +6200,14 @@ export function compileSwiftProjectUnit(
       const icu = swiftIcuAsset(options.toolchainBin, sdk)
       const buildArgs = [
         'build',
+        ...swiftPackageCacheOptions(),
         '--build-system',
         'native',
         '-j',
         BUILD_JOBS,
         '--package-path',
         root,
+        ...swiftSdkOptions(),
         '--swift-sdk',
         sdk,
         '-c',
@@ -5349,8 +6245,9 @@ export function compileSwiftProjectUnit(
         timeout: options.timeoutMs,
         signal: options.signal,
       }
+      report('compiling and linking Swift modules')
       try {
-        await runCompiler(swift, buildArgs, buildOptions)
+        await runCompiler(swift, buildArgs, buildOptions, true)
       } catch (error) {
         const output = outputOf(error)
         const moduleCache = path.join(
@@ -5366,7 +6263,7 @@ export function compileSwiftProjectUnit(
         ) {
           rmSync(moduleCache, { recursive: true, force: true })
           try {
-            await runCompiler(swift, buildArgs, buildOptions)
+            await runCompiler(swift, buildArgs, buildOptions, true)
           } catch (retryError) {
             throw new Error(
               projectDiagnostic(outputOf(retryError), layout, input.files),
@@ -5387,6 +6284,8 @@ export function compileSwiftProjectUnit(
         icu: await icu,
       }
       saveCompiledArtifact(root, artifact)
+      saveCompiledArtifact(sharedRoot, artifact)
+      report('compiled artifact verified')
       return retain(root, artifact)
     },
     options.signal,