peachsim 0.1.939 → 0.1.1399

package/src/swift-host.ts

@@ -8,7 +8,8 @@ import {
   enumerateBundleColors,
   enumerateBundleSymbols,
   enumerateBundleImages,
-  enumerateBundleJson,
+  enumerateBundleResources,
+  resolveSwiftImageResourceUrls,
 } from '../../sootsim-swift/src/bundleAssets'
 import { authHeaderValue, resolveCliAuth } from '../cli/auth'
 import { resolveContrastBackendOrigin } from './backend-origin'
@@ -25,7 +26,15 @@ import {
   swiftApplicationEntry,
 } from './swift-compile'
 import { swiftDistributionRoot, swiftModuleToolchain } from './swift-distribution'
-import { swiftImplicitResourcePaths, type SwiftPackageTarget } from './swift-package'
+import {
+  swiftImplicitResourcePaths,
+  swiftMetalSourceFiles,
+  swiftResourceBundles,
+  swiftResourceBundleForFile,
+  swiftResourceBundleInfoPlist,
+  type SwiftPackageTarget,
+} from './swift-package'
+import { swiftPackageManifest } from './swift-package-manifest'
 import {
   REMOTE_CHECKOUTS,
   resolveSwiftPackages,
@@ -36,6 +45,7 @@ import {
 import { readPackageFile } from './swift-source-file'
 import {
   standinGenerationInputs,
+  standinLibrary,
   swiftStandins,
   type SwiftStandin,
 } from './swift-standins'
@@ -45,6 +55,9 @@ import {
   MAX_SWIFT_COMPILE_RESOURCES,
   MAX_SWIFT_COMPILE_RESOURCE_BYTES,
   MAX_SWIFT_COMPILE_RESOURCE_TOTAL_BYTES,
+  MAX_SWIFT_COMPILE_METAL_FILES,
+  MAX_SWIFT_COMPILE_METAL_BYTES,
+  MAX_SWIFT_COMPILE_METAL_TOTAL_BYTES,
   MAX_SWIFT_COMPILE_IMAGES,
   MAX_SWIFT_COMPILE_IMAGE_BYTES,
   MAX_SWIFT_COMPILE_IMAGE_TOTAL_BYTES,
@@ -64,9 +77,10 @@ import type { SwiftEntryModuleArgs } from '../../sootsim-swift/src/entryModule'
 import type {
   AppCatalogColor,
   SfSymbolVector,
-  SwiftImageSource,
+  SwiftImageResources,
 } from './assetCatalogContract'
 import type { SwiftCompileInput, SwiftIcuAsset } from './swift-compile'
+import type { SwiftMetalLibrarySource, SwiftResourceBundle } from './swiftContract'
 import type { ServerResponse } from 'node:http'
 
 const ARTIFACT_PATH = '/__peach/swift/'
@@ -135,7 +149,7 @@ export interface SwiftArtifact {
   // rather than from whichever of them ran first.
   stamp: string
   package: {
-    resources: Omit<SwiftResourceTable, 'images'>
+    resources: Omit<SwiftResourceTable, 'images' | 'metalUploads'>
     bundleFiles: SwiftBundlePack
     native: SwiftNativeModules | null
   }
@@ -194,6 +208,8 @@ export function projectFor(
 interface XcodeProjectEntry {
   xcodeproj: string
   target?: string
+  /** the build configuration a selected scheme runs; xcode's default otherwise. */
+  configuration?: string
   /** peach's own modules: a remote product named one links it, never its source. */
   provided: ReadonlySet<string> | null
   /** the module root a local compile links, which builds binary stand-ins. */
@@ -220,12 +236,14 @@ export function openXcodeProject(
   xcodeproj: string,
   target: string | undefined,
   moduleRoot: string | undefined,
+  configuration?: string,
 ): string {
-  const app = readXcodeAppTarget(xcodeproj, target)
+  const app = readXcodeAppTarget(xcodeproj, target, configuration)
   const root = app.rootDir
   xcodeProjects.set(root, {
     xcodeproj,
     target: app.name,
+    configuration: app.configuration,
     provided: moduleRoot ? new Set(swiftPeachModules(moduleRoot)) : null,
     moduleRoot: moduleRoot ?? null,
   })
@@ -240,6 +258,7 @@ function swiftPackages(
   packages: SwiftPackages
   standins: SwiftStandin[]
   projectGaps: Map<string, string>
+  binaries: SwiftPackageBinary[]
 } {
   const stamp = (file: string | null) =>
     file && fs.existsSync(file) ? fs.statSync(file).mtimeMs : 0
@@ -328,7 +347,7 @@ function swiftPackages(
       cached.standinKey = generation
     }
   }
-  return cached
+  return { ...cached, binaries: reached }
 }
 
 // the app target's sources compile as one executable target under this
@@ -361,24 +380,50 @@ interface XcodeLayout {
   targets: (SwiftPackageTarget & { exclude: string[] })[]
   packages: SwiftPackages
   standins: SwiftStandin[]
+  /** the binary targets the stand-ins come from. */
+  binaries: SwiftPackageBinary[]
   /** why a framework the project vendors got no stand-in, by name. */
   projectGaps: Map<string, string>
   /** the input directory each app and framework source compiles under. */
   targetDirs: Map<string, string>
+  resourceBundles: SwiftResourceBundle[]
   files: string[]
 }
 
 function xcodeLayout(root: string): XcodeLayout | null {
   const registered = xcodeProjects.get(root)
   if (!registered) return null
-  const app = readXcodeAppTarget(registered.xcodeproj, registered.target)
-  const files = new Set([...app.projectFiles, ...app.sources, ...app.resources])
+  const app = readXcodeAppTarget(
+    registered.xcodeproj,
+    registered.target,
+    registered.configuration,
+  )
+  const appSources = app.allSources.filter(
+    (file) => file.endsWith('.swift') || file.endsWith('.metal'),
+  )
+  const files = new Set([...app.projectFiles, ...appSources, ...app.resources])
   if (app.infoPlistFile) files.add(app.infoPlistFile)
-  const targetDirs = new Map(app.sources.map((file) => [file, XCODE_APP_DIR]))
+  const targetDirs = new Map(
+    [...appSources, ...app.resources].map((file) => [file, XCODE_APP_DIR]),
+  )
+  const resourceBundles: SwiftResourceBundle[] = [
+    { target: app.moduleName, sourcePath: XCODE_APP_DIR, path: '.' },
+  ]
   const targets: XcodeLayout['targets'] = []
   for (const framework of app.frameworks) {
     const dir = path.posix.join(XCODE_FRAMEWORKS_DIR, framework.moduleName)
-    for (const file of framework.sources) {
+    resourceBundles.push({
+      target: framework.moduleName,
+      sourcePath: dir,
+      path: `Frameworks/${framework.moduleName}.framework`,
+    })
+    for (const file of framework.allSources) {
+      if (!file.endsWith('.swift') && !file.endsWith('.metal')) continue
+      if (targetDirs.has(file)) continue
+      targetDirs.set(file, dir)
+      files.add(file)
+    }
+    for (const file of framework.resources) {
       if (targetDirs.has(file)) continue
       targetDirs.set(file, dir)
       files.add(file)
@@ -391,9 +436,10 @@ function xcodeLayout(root: string): XcodeLayout | null {
       exclude: [],
       languageMode: framework.languageMode,
       mainActorIsolation: framework.mainActorIsolation,
+      defines: framework.defines,
     })
   }
-  const { packages, standins, projectGaps } = swiftPackages(registered, app)
+  const { packages, standins, projectGaps, binaries } = swiftPackages(registered, app)
   for (const standin of standins)
     targets.push({
       name: standin.module,
@@ -404,6 +450,9 @@ function xcodeLayout(root: string): XcodeLayout | null {
       languageMode: 5,
       mainActorIsolation: false,
     })
+  // xcode builds packages in swiftpm's debug configuration for Debug, which
+  // defines DEBUG, and in release for any other, as its package compiles show
+  const packageConfiguration = app.configuration === 'Debug' ? 'debug' : 'release'
   for (const target of packages.targets) {
     const relative = path.relative(
       target.remote ? path.join(root, REMOTE_CHECKOUTS) : root,
@@ -420,7 +469,24 @@ function xcodeLayout(root: string): XcodeLayout | null {
       ...target,
       path: target.remote ? path.posix.join(XCODE_PACKAGES_DIR, posix) : posix,
       exclude: [],
+      defines: [
+        ...(packageConfiguration === 'debug' ? ['DEBUG'] : []),
+        ...target.packageDefines
+          .filter(
+            (define) =>
+              define.configuration === null ||
+              define.configuration === packageConfiguration,
+          )
+          .map((define) => define.name),
+      ],
     })
+    if (target.resources) {
+      resourceBundles.push({
+        target: target.name,
+        sourcePath: target.remote ? path.posix.join(XCODE_PACKAGES_DIR, posix) : posix,
+        path: `${swiftPackageManifest(target.packageDir).name}_${target.name}.bundle`,
+      })
+    }
     if (!target.remote) files.add(path.join(target.packageDir, 'Package.swift'))
     for (const file of target.files) files.add(file)
   }
@@ -436,8 +502,10 @@ function xcodeLayout(root: string): XcodeLayout | null {
     targets,
     packages,
     standins,
+    binaries,
     projectGaps,
     targetDirs,
+    resourceBundles,
     files: [...files].sort(),
   }
 }
@@ -445,16 +513,24 @@ function xcodeLayout(root: string): XcodeLayout | null {
 // the manifest the compile reads for an xcode app: the app target and each
 // framework and package target, in the forms swiftManifestTargets scans.
 function xcodeManifest(layout: XcodeLayout): string {
-  const settings = (mode: number, mainActor: boolean) =>
-    `swiftSettings: [.swiftLanguageMode(.v${mode})${mainActor ? ', .defaultIsolation(MainActor.self)' : ''}]`
+  const settings = (target: {
+    languageMode: number
+    mainActorIsolation: boolean
+    defines?: string[]
+  }) =>
+    `swiftSettings: [${[
+      `.swiftLanguageMode(.v${target.languageMode})`,
+      ...(target.mainActorIsolation ? ['.defaultIsolation(MainActor.self)'] : []),
+      ...(target.defines ?? []).map((name) => `.define(${JSON.stringify(name)})`),
+    ].join(', ')}]`
   return [
     '// swift-tools-version: 6.2',
     'import PackageDescription',
     'let package = Package(name: "app", targets: [',
-    `  .executableTarget(name: "${layout.app.moduleName}", path: "${XCODE_APP_DIR}", ${settings(layout.app.languageMode, layout.app.mainActorIsolation)}),`,
+    `  .executableTarget(name: "${layout.app.moduleName}", path: "${XCODE_APP_DIR}", ${settings(layout.app)}),`,
     ...layout.targets.map(
       (target) =>
-        `  .target(name: "${target.name}", path: "${target.path}", ${target.exclude.length > 0 ? `exclude: ${JSON.stringify(target.exclude)}, ` : ''}${target.resources ? 'resources: [], ' : ''}${settings(target.languageMode, target.mainActorIsolation)}),`,
+        `  .target(name: "${target.name}", path: "${target.path}", ${target.exclude.length > 0 ? `exclude: ${JSON.stringify(target.exclude)}, ` : ''}${target.resources ? 'resources: [], ' : ''}${settings(target)}),`,
     ),
     '])',
     '',
@@ -511,10 +587,12 @@ export function sourceFiles(root: string): string[] {
   return packageFiles(root).filter((file) => file.endsWith('.swift'))
 }
 
+// project files and the xcconfigs their settings read are build inputs, never resources
 function resourceCandidateFiles(root: string): string[] {
   return packageFiles(root).filter(
     (file) =>
       !file.endsWith('.swift') &&
+      !file.endsWith('.xcconfig') &&
       !['project.pbxproj', 'project.xcproj'].includes(path.basename(file)),
   )
 }
@@ -526,7 +604,11 @@ export function swiftProjectAppInfo(packagePath: string): {
 } {
   const registered = xcodeProjects.get(packagePath)
   const app = registered
-    ? readXcodeAppTarget(registered.xcodeproj, registered.target)
+    ? readXcodeAppTarget(
+        registered.xcodeproj,
+        registered.target,
+        registered.configuration,
+      )
     : null
   const files = app?.resources ?? resourceCandidateFiles(packagePath)
   const catalogs = files.filter(
@@ -616,10 +698,12 @@ const RESOURCE_CONTENT_TYPES: Record<string, string> = {
 }
 
 export interface SwiftResourceTable {
-  /** bundle asset name to its absolute serving url and scale. */
-  table: Record<string, SwiftImageSource>
+  /** each bundle's asset names to their serving urls and scales. */
+  table: SwiftImageResources
   /** the same rasters as compile-address inputs. */
   images: Record<string, SwiftImageUpload>
+  metalSources: Record<string, SwiftMetalLibrarySource>
+  metalUploads: Record<string, string>
   /** asset-catalog color name to its value. */
   colors: Record<string, AppCatalogColor>
   symbols: Record<string, SfSymbolVector>
@@ -634,6 +718,7 @@ export interface SwiftResourceTable {
 export function buildSwiftResourceTable(
   project: SwiftProject,
   baseUrl: string,
+  inputs: Record<string, string>,
 ): SwiftResourceTable {
   const limits = inputLimits(Boolean(project.hosted))
   const absolute = resourceCandidateFiles(project.packagePath)
@@ -650,15 +735,77 @@ export function buildSwiftResourceTable(
       'utf8',
     )
   }
-  const found = enumerateBundleImages(relative, readContents)
-  const colors = enumerateBundleColors(relative, readContents)
-  const symbols = enumerateBundleSymbols(relative, readContents)
-  const table: Record<string, SwiftImageSource> = {}
+  const layout = xcodeLayout(project.packagePath)
+  const bundles = layout?.resourceBundles ?? swiftResourceBundles(inputs, relative)
+  const catalogFiles = relative.filter((file) => {
+    const disk = byRelative.get(file)
+    return !disk || !layout?.targetDirs.get(disk)?.startsWith(`${XCODE_FRAMEWORKS_DIR}/`)
+  })
+  const found = enumerateBundleImages(relative, readContents, (file) => {
+    const disk = byRelative.get(file)
+    if (!disk) throw new Error(`image source ${file} has no input file`)
+    const key = layout ? xcodeInputKey(layout, disk, file) : file
+    return swiftResourceBundleForFile(bundles, key)?.path ?? '.'
+  })
+  const colors = enumerateBundleColors(catalogFiles, readContents)
+  const symbols = enumerateBundleSymbols(catalogFiles, readContents, (file) => {
+    const disk = byRelative.get(file)
+    if (!disk) throw new Error(`symbol source ${file} has no input file`)
+    const key = layout ? xcodeInputKey(layout, disk, file) : file
+    return swiftResourceBundleForFile(bundles, key)?.path ?? '.'
+  })
+  const table: SwiftImageResources = Object.create(null)
   const images: Record<string, SwiftImageUpload> = {}
+  const metalSources: Record<string, SwiftMetalLibrarySource> = {}
+  const metalUploads: Record<string, string> = {}
   const watched: string[] = []
   const registered = new Map<string, { bytes: Buffer; contentType: string }>()
+  const shaderFiles = relative.filter((file) => file.endsWith('.metal'))
+  const metalCandidates: Record<string, string> = {}
+  if (inputs['Package.swift'] !== undefined)
+    metalCandidates['Package.swift'] = inputs['Package.swift']
+  const metalInputs = new Map<string, { file: string; disk: string }>()
+  for (const file of shaderFiles) {
+    const disk = byRelative.get(file)
+    if (!disk) throw new Error(`metal source ${file} has no input file`)
+    const key = layout ? xcodeInputKey(layout, disk, file) : file
+    metalCandidates[key] = ''
+    metalInputs.set(key, { file, disk })
+  }
+  const metalFiles = Object.keys(swiftMetalSourceFiles(metalCandidates))
+  if (metalFiles.length > MAX_SWIFT_COMPILE_METAL_FILES)
+    throw new Error('metal source pack exceeds the compile service file cap')
+  let metalBytes = 0
+  for (const key of metalFiles) {
+    const input = metalInputs.get(key)
+    if (!input) throw new Error(`metal source ${key} has no input file`)
+    const { file, disk } = input
+    const bytes = readPackageFile(
+      project.packagePath,
+      disk,
+      MAX_SWIFT_COMPILE_METAL_BYTES,
+    )
+    metalBytes += bytes.length
+    if (metalBytes > MAX_SWIFT_COMPILE_METAL_TOTAL_BYTES)
+      throw new Error('metal source pack exceeds the compile service caps')
+    const source = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true }).decode(
+      bytes,
+    )
+    const sha256 = createHash('sha256').update(bytes).digest('hex')
+    const bundle = swiftResourceBundleForFile(bundles, key)
+    if (!bundle && inputs['Package.swift'])
+      throw new Error(`metal source ${key} has no resource target bundle`)
+    metalSources[key] = {
+      sha256,
+      url: `${baseUrl}${RESOURCE_PATH}${sha256}.metal`,
+      bundlePath: bundle?.path ?? '.',
+    }
+    metalUploads[key] = source
+    watched.push(file)
+    registered.set(`${sha256}.metal`, { bytes, contentType: 'text/plain; charset=utf-8' })
+  }
   let imageBytes = 0
-  for (const { name, file, scale } of found) {
+  for (const { name, file, scale, bundlePath } of found) {
     const disk = byRelative.get(file)
     if (!disk) continue
     if (
@@ -671,8 +818,12 @@ export function buildSwiftResourceTable(
     imageBytes += bytes.length
     const hash = createHash('sha256').update(bytes).digest('hex').slice(0, 16)
     const ext = path.posix.extname(file).toLowerCase()
-    table[name] = { uri: `${baseUrl}${RESOURCE_PATH}${hash}${ext}`, scale }
-    images[name] = {
+    const bundle = table[bundlePath] ?? Object.create(null)
+    const variants = (bundle[name] ??= [])
+    variants.push({ uri: `${baseUrl}${RESOURCE_PATH}${hash}${ext}`, scale })
+    table[bundlePath] = bundle
+    const key = layout ? xcodeInputKey(layout, disk, file) : file
+    images[key] = {
       file: path.posix.basename(file),
       data: bytes.toString('base64'),
     }
@@ -700,19 +851,17 @@ export function buildSwiftResourceTable(
     project.resourcesPrevious = project.resourceFiles
     project.resourceFiles = registered
   }
-  return { table, images, colors, symbols, watched }
+  return { table, images, metalSources, metalUploads, colors, symbols, watched }
 }
 
-// the /res pack: every Resources/ json in the package, basename-keyed and
-// base64, riding the entry module so the mount serves it without a fetch.
-// the namespace is flat like the bundle the wasm side reads: shallower
-// paths pack first (the Resources root is the bundle root) with a lexical
-// tiebreak, and the first spelling of a basename wins a collision. data json
+// copied resources ride the entry module as base64 in their target bundle.
+// each bundle keeps the existing shallow-first basename collision rule.
 // bundle caps match the hosted compiler; oversized input refuses before reading.
 
 export interface SwiftBundlePack {
-  /** basename to base64 bytes for the mount's /res. */
+  /** bundle-relative path to base64 bytes for the mount's /res. */
   files: Record<string, string>
+  bundles: SwiftResourceBundle[]
   /** project-relative json files this load's pack covers (for watching). */
   watched: string[]
 }
@@ -720,6 +869,7 @@ export interface SwiftBundlePack {
 export function buildSwiftBundleFiles(
   packagePath: string,
   hosted: boolean,
+  inputs?: Record<string, string>,
 ): SwiftBundlePack {
   packagePath = fs.realpathSync(packagePath)
   const limits = inputLimits(hosted)
@@ -733,33 +883,57 @@ export function buildSwiftBundleFiles(
   const watched: string[] = []
   let total = 0
   const xcode = xcodeLayout(packagePath)
+  const bundles =
+    xcode?.resourceBundles ??
+    swiftResourceBundles(inputs ?? packageSources(packagePath), relative)
+  const addFile = (key: string, bytes: Buffer) => {
+    if (
+      Object.keys(files).length >= limits.resources ||
+      bytes.length > limits.resourceBytes ||
+      total + bytes.length > limits.resourceTotalBytes
+    )
+      throw new Error(
+        `swift bundle pack exceeds ${limits.resources} files / ${limits.resourceTotalBytes} bytes`,
+      )
+    files[key] = bytes.toString('base64')
+    total += bytes.length
+  }
   if (xcode) {
     const bytes = Buffer.from(xcode.app.infoPlist)
     if (bytes.length > limits.resourceBytes || bytes.length > limits.resourceTotalBytes)
       throw new Error('swift launch Info.plist exceeds bundle resource limits')
-    files['Info.plist'] = bytes.toString('base64')
-    total += bytes.length
+    addFile('Info.plist', bytes)
     if (xcode.app.infoPlistFile)
       watched.push(
         path.relative(packagePath, xcode.app.infoPlistFile).split(path.sep).join('/'),
       )
   }
-  for (const { base, file } of enumerateBundleJson(relative)) {
-    watched.push(file)
+  const groups = new Map<string, string[]>()
+  for (const file of relative) {
     const disk = path.join(packagePath, ...file.split('/'))
-    if (
-      Object.keys(files).length >= limits.resources ||
-      total + fs.statSync(disk).size > limits.resourceTotalBytes
-    ) {
-      throw new Error(
-        `swift bundle pack exceeds ${limits.resources} files / ${limits.resourceTotalBytes} bytes`,
-      )
+    const key = xcode ? xcodeInputKey(xcode, disk, file) : file
+    const bundle = swiftResourceBundleForFile(bundles, key)
+    const bundlePath = bundle?.path ?? '.'
+    const group = groups.get(bundlePath) ?? []
+    group.push(file)
+    groups.set(bundlePath, group)
+  }
+  for (const bundle of bundles) {
+    if (bundle.path === '.') continue
+    addFile(
+      `${bundle.path}/Info.plist`,
+      Buffer.from(swiftResourceBundleInfoPlist(bundle)),
+    )
+  }
+  for (const [bundlePath, paths] of groups) {
+    for (const { base, file } of enumerateBundleResources(paths)) {
+      watched.push(file)
+      const disk = path.join(packagePath, ...file.split('/'))
+      const bytes = readPackageFile(packagePath, disk, limits.resourceBytes)
+      addFile(bundlePath === '.' ? base : `${bundlePath}/${base}`, bytes)
     }
-    const bytes = readPackageFile(packagePath, disk, limits.resourceBytes)
-    files[base] = bytes.toString('base64')
-    total += bytes.length
   }
-  return { files, watched }
+  return { files, bundles, watched }
 }
 
 // the middleware's lookup, exported for the producer's own proof: a hit is
@@ -848,7 +1022,29 @@ export function icuUrl(origin: string, artifact: SwiftArtifact): string {
     : `${origin}${ICU_PATH}${artifact.icu.sha256}`
 }
 
-function packageSources(packagePath: string): Record<string, string> {
+// a c stand-in whose framework has a WebAssembly build links that library,
+// keyed by the stand-in target it links into; its own source then defines
+// nothing, so the library's functions run instead of the traps. one library
+// links once, through the first module its framework ships.
+function standinLibraries(layout: XcodeLayout): Map<string, SwiftStandin[]> {
+  const linked = new Map<string, SwiftStandin[]>()
+  for (const binary of layout.binaries) {
+    const modules = layout.standins.filter(
+      (standin) =>
+        standin.target === binary.target && `${standin.module}.c` in standin.files,
+    )
+    if (modules.length === 0) continue
+    const library = standinLibrary(binary, layout.app.rootDir)
+    if (!library) continue
+    linked.set(library, modules)
+  }
+  return linked
+}
+
+function packageSources(
+  packagePath: string,
+  linked: ReadonlySet<SwiftStandin> = new Set(),
+): Record<string, string> {
   const xcode = xcodeLayout(packagePath)
   const files: Record<string, string> = {}
   for (const file of sourceFiles(packagePath)) {
@@ -864,7 +1060,10 @@ function packageSources(packagePath: string): Record<string, string> {
     files['Package.swift'] = xcodeManifest(xcode)
     for (const standin of xcode.standins)
       for (const [file, text] of Object.entries(standin.files))
-        files[path.posix.join(XCODE_STANDINS_DIR, standin.module, file)] = text
+        files[path.posix.join(XCODE_STANDINS_DIR, standin.module, file)] =
+          linked.has(standin) && file === `${standin.module}.c`
+            ? `// ${standin.target}'s WebAssembly library defines ${standin.module}'s functions.\n`
+            : text
   }
   return files
 }
@@ -877,11 +1076,13 @@ interface SwiftPackageSnapshot {
   bundleFiles: SwiftBundlePack
   native: SwiftNativeModules | null
   glue?: string
+  libraries?: Record<string, string>
 }
 
 function packageSnapshot(project: SwiftProject, entry: string): SwiftPackageSnapshot {
-  const files = packageSources(project.packagePath)
   const layout = xcodeLayout(project.packagePath)
+  const linked = layout ? standinLibraries(layout) : new Map<string, SwiftStandin[]>()
+  const files = packageSources(project.packagePath, new Set([...linked.values()].flat()))
   const native = nativeSourceDescriptor(project.packagePath)
   return {
     files,
@@ -889,13 +1090,33 @@ function packageSnapshot(project: SwiftProject, entry: string): SwiftPackageSnap
       ? xcodeInputKey(layout, path.resolve(project.packagePath, entry), entry)
       : entry,
     resourcePaths: swiftImplicitResourcePaths(
-      resourceCandidateFiles(project.packagePath).map((file) =>
-        path.relative(project.packagePath, file).split(path.sep).join(path.posix.sep),
-      ),
+      resourceCandidateFiles(project.packagePath).map((file) => {
+        const relative = path
+          .relative(project.packagePath, file)
+          .split(path.sep)
+          .join(path.posix.sep)
+        return layout && file.endsWith('.metal')
+          ? xcodeInputKey(layout, file, relative)
+          : relative
+      }),
+    ),
+    resources: buildSwiftResourceTable(project, '', files),
+    bundleFiles: buildSwiftBundleFiles(
+      project.packagePath,
+      Boolean(project.hosted),
+      files,
     ),
-    resources: buildSwiftResourceTable(project, ''),
-    bundleFiles: buildSwiftBundleFiles(project.packagePath, Boolean(project.hosted)),
     native,
+    ...(linked.size > 0
+      ? {
+          libraries: Object.fromEntries(
+            [...linked].map(([library, [first]]) => [
+              first!.module,
+              fs.readFileSync(library).toString('base64'),
+            ]),
+          ),
+        }
+      : {}),
     ...(native
       ? {
           glue: readPackageFile(
@@ -911,11 +1132,14 @@ function packageSnapshot(project: SwiftProject, entry: string): SwiftPackageSnap
 function snapshotCompileInput(snapshot: SwiftPackageSnapshot): SwiftCompileInput {
   const input: SwiftCompileInput = {
     files: snapshot.files,
+    metalSources: snapshot.resources.metalUploads,
     resourcePaths: snapshot.resourcePaths,
+    resourceBundles: snapshot.bundleFiles.bundles,
     resources: snapshot.bundleFiles.files,
     images: snapshot.resources.images,
     entry: snapshot.entry,
     oneModule: true,
+    ...(snapshot.libraries ? { libraries: snapshot.libraries } : {}),
   }
   return snapshot.glue ? withNativeSourceGlue(input, snapshot.glue) : input
 }
@@ -935,6 +1159,7 @@ async function compile(
     table: snapshot.resources.table,
     colors: snapshot.resources.colors,
     symbols: snapshot.resources.symbols,
+    metalSources: snapshot.resources.metalSources,
     watched: snapshot.resources.watched,
   }
   const content = {
@@ -1066,15 +1291,6 @@ export function swiftApiGapReport(output: string): string | null {
   ].join('\n')
 }
 
-// the platform modules peach decided not to provide (plans/partners/triumph/
-// arcade-gaps.md, report 2): a shipped Darwin module would flip every
-// `canImport(Darwin)` branch in every dependency.
-const UNPROVIDED_PLATFORM_MODULES: Record<string, string> = {
-  Darwin:
-    'Peach compiles for WebAssembly, which has no Darwin; C library names come through Foundation',
-  MachO: 'Peach compiles for WebAssembly, which has no Mach-O images',
-}
-
 // the frameworks the iOS simulator SDK ships, so a report can say which
 // missing modules are Apple's on any host, linux included. regenerated by
 // scripts/ios-sdk-frameworks.ts.
@@ -1099,21 +1315,14 @@ async function missingModulesMessage(
       ] as const
     }),
     ...[...missing.keys()].flatMap((name) =>
-      UNPROVIDED_PLATFORM_MODULES[name]
+      IOS_SDK_FRAMEWORKS.has(name)
         ? [
             [
               name,
-              { source: 'the iOS SDK', reason: UNPROVIDED_PLATFORM_MODULES[name]! },
+              { source: 'the iOS SDK', reason: 'a framework Peach does not provide' },
             ] as const,
           ]
-        : IOS_SDK_FRAMEWORKS.has(name)
-          ? [
-              [
-                name,
-                { source: 'the iOS SDK', reason: 'a framework Peach does not provide' },
-              ] as const,
-            ]
-          : [],
+        : [],
     ),
     ...(layout?.packages.modules ?? []),
     ...(layout?.packages.unavailable ?? []),
@@ -1123,9 +1332,7 @@ async function missingModulesMessage(
   // such as FirebaseCore ships inside _FirebaseCore with no target of its
   // own. the archives are read only for a module the sdk does not explain.
   const packaged = new Set(
-    [...missing.keys()].filter(
-      (name) => !UNPROVIDED_PLATFORM_MODULES[name] && !IOS_SDK_FRAMEWORKS.has(name),
-    ),
+    [...missing.keys()].filter((name) => !IOS_SDK_FRAMEWORKS.has(name)),
   )
   if (packaged.size > 0)
     await Promise.all(
@@ -1209,7 +1416,9 @@ async function compileRemote(
     submit,
     {
       files: snapshot.files,
+      metalSources: snapshot.resources.metalUploads,
       resourcePaths: snapshot.resourcePaths,
+      resourceBundles: snapshot.bundleFiles.bundles,
       resources: snapshot.bundleFiles.files,
       images: snapshot.resources.images,
       entry: snapshot.entry,
@@ -1361,13 +1570,18 @@ export async function swiftPackageMetadata(
     hash: artifact.hash,
     icuUrl: icuUrl(origin, artifact),
     rootId: `${packageName}/${entry}`,
-    resources: Object.fromEntries(
-      Object.entries(resources.table).map(([name, image]) => [
-        name,
-        { ...image, uri: `${origin}${image.uri}` },
-      ]),
-    ),
+    resources: resolveSwiftImageResourceUrls(resources.table, origin),
     bundleFiles: bundleFiles.files,
+    ...(Object.keys(resources.metalSources).length === 0
+      ? {}
+      : {
+          metalSources: Object.fromEntries(
+            Object.entries(resources.metalSources).map(([file, source]) => [
+              file,
+              { ...source, url: `${origin}${source.url}` },
+            ]),
+          ),
+        }),
     colors: resources.colors,
     symbols: resources.symbols,
     native: artifact.package.native
@@ -1375,6 +1589,7 @@ export async function swiftPackageMetadata(
           packageId: artifact.package.native.packageId,
           contractHash: artifact.package.native.hash,
           modules: artifact.package.native.modules,
+          views: Object.keys(artifact.package.native.views),
           defaultView: mains.length === 1,
         }
       : undefined,