@use-voltra/ios-client 2.1.1 → 2.3.0

package/expo-plugin/src/ios-widget/xcode/mainAppSettings.ts

@@ -1,27 +1,55 @@
 import { XcodeProject } from '@expo/config-plugins'
 
-export interface MainAppTargetSettings {
-  deploymentTarget: string
+/** Code-signing settings read from one of the main app target's build configurations. */
+export interface MainAppSigningSettings {
   codeSignStyle?: string
   developmentTeam?: string
   provisioningProfileSpecifier?: string
 }
 
+export interface MainAppTargetSettings {
+  /**
+   * Signing settings keyed by build-configuration name (e.g. `Debug`, `Release`). Release
+   * provisioning often differs from Debug, so the widget must mirror the main app per
+   * configuration rather than copying one configuration's signing into both.
+   */
+  byConfigurationName: Record<string, MainAppSigningSettings>
+  /** The first configuration's settings, used for widget configurations with no name match. */
+  fallback: MainAppSigningSettings
+}
+
+/** Strips surrounding quotes from a raw build-setting value. */
+function unquote(value: unknown): string | undefined {
+  if (typeof value !== 'string') {
+    return undefined
+  }
+  return value.replace(/^"|"$/g, '')
+}
+
+/** Reads the signing-related build settings from a single XCBuildConfiguration. */
+function readSigningSettings(buildSettings: Record<string, unknown>): MainAppSigningSettings {
+  return {
+    codeSignStyle: unquote(buildSettings.CODE_SIGN_STYLE),
+    developmentTeam: unquote(buildSettings.DEVELOPMENT_TEAM),
+    provisioningProfileSpecifier: unquote(buildSettings.PROVISIONING_PROFILE_SPECIFIER),
+  }
+}
+
 /**
- * Reads build settings from the main app target to synchronize code signing with the widget extension.
+ * Reads code-signing build settings from every build configuration of the main app target, so the
+ * widget extension can synchronize signing per configuration (Debug→Debug, Release→Release).
  *
  * @param xcodeProject The Xcode project instance
- * @returns The main app target's build settings, or null if not found
+ * @returns Signing settings keyed by configuration name plus a first-configuration fallback, or
+ * null when the main app target or its configurations cannot be resolved
  */
 export function getMainAppTargetSettings(xcodeProject: XcodeProject): MainAppTargetSettings | null {
   try {
     const mainAppTarget = xcodeProject.getFirstTarget()?.firstTarget
-
     if (!mainAppTarget) {
       return null
     }
 
-    // Get the build configuration list for the main app target
     const buildConfigurationListId = mainAppTarget.buildConfigurationList
     if (!buildConfigurationListId) {
       return null
@@ -32,62 +60,39 @@ export function getMainAppTargetSettings(xcodeProject: XcodeProject): MainAppTar
 
     const buildConfigurationList =
       xcodeProject.hash.project.objects['XCConfigurationList']?.[buildConfigurationListUuid]
-    if (!buildConfigurationList || !buildConfigurationList.buildConfigurations) {
-      return null
-    }
-
-    // Get the first build configuration (usually Debug) to read settings
-    const firstConfigRef = buildConfigurationList.buildConfigurations[0]
-    if (!firstConfigRef) {
-      return null
-    }
-
-    // Extract UUID from config reference (it might include a comment)
-    const firstConfigUuid =
-      typeof firstConfigRef === 'string' ? firstConfigRef.split(' ')[0] : firstConfigRef.value?.split(' ')[0]
-    if (!firstConfigUuid) {
+    if (!buildConfigurationList?.buildConfigurations) {
       return null
     }
 
-    const buildConfiguration = xcodeProject.hash.project.objects['XCBuildConfiguration']?.[firstConfigUuid]
-    if (!buildConfiguration || !buildConfiguration.buildSettings) {
-      return null
+    const buildConfigurationSection = xcodeProject.hash.project.objects['XCBuildConfiguration'] ?? {}
+    const byConfigurationName: Record<string, MainAppSigningSettings> = {}
+    let fallback: MainAppSigningSettings | null = null
+
+    for (const configRef of buildConfigurationList.buildConfigurations) {
+      // Extract UUID from the config reference (it might include a comment)
+      const configUuid = typeof configRef === 'string' ? configRef.split(' ')[0] : configRef.value?.split(' ')[0]
+      if (!configUuid) {
+        continue
+      }
+
+      const buildConfiguration = buildConfigurationSection[configUuid]
+      if (!buildConfiguration?.buildSettings) {
+        continue
+      }
+
+      const settings = readSigningSettings(buildConfiguration.buildSettings)
+      const configName = unquote(buildConfiguration.name)
+      if (configName && !(configName in byConfigurationName)) {
+        byConfigurationName[configName] = settings
+      }
+      fallback = fallback ?? settings
     }
 
-    const buildSettings = buildConfiguration.buildSettings
-
-    // Extract deployment target (remove quotes if present)
-    const deploymentTarget =
-      buildSettings.IPHONEOS_DEPLOYMENT_TARGET?.replace(/^"|"$/g, '') ||
-      buildSettings['IPHONEOS_DEPLOYMENT_TARGET']?.replace(/^"|"$/g, '') ||
-      null
-
-    // Extract code signing settings
-    const codeSignStyle =
-      buildSettings.CODE_SIGN_STYLE?.replace(/^"|"$/g, '') ||
-      buildSettings['CODE_SIGN_STYLE']?.replace(/^"|"$/g, '') ||
-      null
-
-    const developmentTeam =
-      buildSettings.DEVELOPMENT_TEAM?.replace(/^"|"$/g, '') ||
-      buildSettings['DEVELOPMENT_TEAM']?.replace(/^"|"$/g, '') ||
-      null
-
-    const provisioningProfileSpecifier =
-      buildSettings.PROVISIONING_PROFILE_SPECIFIER?.replace(/^"|"$/g, '') ||
-      buildSettings['PROVISIONING_PROFILE_SPECIFIER']?.replace(/^"|"$/g, '') ||
-      null
-
-    if (!deploymentTarget) {
+    if (!fallback) {
       return null
     }
 
-    return {
-      deploymentTarget,
-      codeSignStyle: codeSignStyle || undefined,
-      developmentTeam: developmentTeam || undefined,
-      provisioningProfileSpecifier: provisioningProfileSpecifier || undefined,
-    }
+    return { byConfigurationName, fallback }
   } catch {
     // If we can't read the settings, return null and use fallback values
     return null

package/expo-plugin/src/ios-widget/xcode/productFile.ts

@@ -42,9 +42,10 @@ function findBuildFileForFileRef(xcodeProject: XcodeProject, fileRef: string): {
 }
 
 /**
- * Adds the product file (.appex) for the widget extension.
+ * Adds the product file (.appex) for the widget extension. Internal create-only fallback for
+ * {@link ensureProductFile}; not part of the public pipeline.
  */
-export function addProductFile(xcodeProject: XcodeProject, options: AddProductFileOptions) {
+function addProductFile(xcodeProject: XcodeProject, options: AddProductFileOptions) {
   const { targetName, groupName } = options
 
   const productFileOptions = {

package/expo-plugin/src/ios-widget/xcode/target.ts

@@ -6,18 +6,9 @@ import { IOS } from '../../constants'
 // Types
 // ============================================================================
 
-export interface ConfigureTargetOptions {
+export interface CreateTargetSkeletonOptions {
   targetName: string
   targetUuid: string
-  productFile: { fileRef: string }
-  xCConfigurationList: { uuid: string }
-}
-
-interface AddNativeTargetOptions {
-  targetName: string
-  targetUuid: string
-  productFile: { fileRef: string }
-  xCConfigurationList: { uuid: string }
 }
 
 // ============================================================================
@@ -25,19 +16,39 @@ interface AddNativeTargetOptions {
 // ============================================================================
 
 /**
- * Configures the widget extension target in the Xcode project.
+ * Creates the minimal widget-extension native target and registers it with the project.
+ *
+ * A target cannot be "ensured" into existence, so this is the one create-only step in
+ * {@link applyXcodeChanges}: it adds an empty `PBXNativeTarget` (no product reference, configuration
+ * list or build phases yet) to the `PBXNativeTarget` and `PBXProject` sections. The shared ensure
+ * pipeline then fills in the configuration list, product file, group, build phases, attributes and
+ * dependency — the same code that reconciles an already-existing target.
  *
- * This:
- * - Adds the target to PBXNativeTarget section
- * - Adds the target to PBXProject section
- * - Adds a dependency from the main app to the widget extension
+ * @returns The freshly created native-target object (the value stored in the `PBXNativeTarget`
+ * section under `targetUuid`).
  */
-export function configureTarget(xcodeProject: XcodeProject, options: ConfigureTargetOptions) {
-  const target = addToPbxNativeTargetSection(xcodeProject, options)
-  addToPbxProjectSection(xcodeProject, target)
-  addTargetDependency(xcodeProject, target)
+export function createTargetSkeleton(xcodeProject: XcodeProject, options: CreateTargetSkeletonOptions) {
+  const { targetName, targetUuid } = options
+
+  const target = {
+    uuid: targetUuid,
+    pbxNativeTarget: {
+      isa: 'PBXNativeTarget',
+      name: targetName,
+      productName: targetName,
+      productType: `"com.apple.product-type.app-extension"`,
+      buildConfigurationList: '',
+      productReference: '',
+      buildPhases: [],
+      buildRules: [],
+      dependencies: [],
+    },
+  }
 
-  return target
+  xcodeProject.addToPbxNativeTargetSection(target)
+  xcodeProject.addToPbxProjectSection(target)
+
+  return xcodeProject.pbxNativeTargetSection()[targetUuid]
 }
 
 /**
@@ -83,66 +94,3 @@ export function ensureTargetDependency(xcodeProject: XcodeProject, targetUuid: s
     xcodeProject.addTargetDependency(mainTargetUuid, [targetUuid])
   }
 }
-
-// ============================================================================
-// Helper Functions
-// ============================================================================
-
-/**
- * Adds the widget extension target to the PBXNativeTarget section.
- */
-function addToPbxNativeTargetSection(xcodeProject: XcodeProject, options: AddNativeTargetOptions) {
-  const { targetName, targetUuid, productFile, xCConfigurationList } = options
-
-  const target = {
-    uuid: targetUuid,
-    pbxNativeTarget: {
-      isa: 'PBXNativeTarget',
-      name: targetName,
-      productName: targetName,
-      productReference: productFile.fileRef,
-      productType: `"com.apple.product-type.app-extension"`,
-      buildConfigurationList: xCConfigurationList.uuid,
-      buildPhases: [],
-      buildRules: [],
-      dependencies: [],
-    },
-  }
-
-  xcodeProject.addToPbxNativeTargetSection(target)
-
-  return target
-}
-
-/**
- * Adds the target to the PBXProject section.
- */
-function addToPbxProjectSection(xcodeProject: XcodeProject, target: { uuid: string }): void {
-  xcodeProject.addToPbxProjectSection(target)
-
-  // Add target attributes to project section
-  const projectSection = xcodeProject.pbxProjectSection()
-  const firstProject = xcodeProject.getFirstProject()
-
-  if (!projectSection[firstProject.uuid].attributes.TargetAttributes) {
-    projectSection[firstProject.uuid].attributes.TargetAttributes = {}
-  }
-
-  projectSection[firstProject.uuid].attributes.TargetAttributes[target.uuid] = {
-    LastSwiftMigration: IOS.LAST_SWIFT_MIGRATION,
-  }
-}
-
-/**
- * Adds a target dependency so the main app depends on the widget extension.
- */
-function addTargetDependency(xcodeProject: XcodeProject, target: { uuid: string }): void {
-  if (!xcodeProject.hash.project.objects['PBXTargetDependency']) {
-    xcodeProject.hash.project.objects['PBXTargetDependency'] = {}
-  }
-  if (!xcodeProject.hash.project.objects['PBXContainerItemProxy']) {
-    xcodeProject.hash.project.objects['PBXContainerItemProxy'] = {}
-  }
-
-  xcodeProject.addTargetDependency(xcodeProject.getFirstTarget().uuid, [target.uuid])
-}

package/expo-plugin/src/types.ts

@@ -1,6 +1,11 @@
 import type { ConfigPlugin } from '@expo/config-plugins'
 
-import type { DynamicWidgetEntryConfig, WidgetInitialStatePath, WidgetLabel } from '@use-voltra/expo-plugin'
+import type {
+  DynamicLiveActivityEntryConfig,
+  DynamicWidgetEntryConfig,
+  WidgetInitialStatePath,
+  WidgetLabel,
+} from '@use-voltra/expo-plugin'
 
 /**
  * Supported iOS Home Screen widget size families.
@@ -42,9 +47,15 @@ export interface IOSWidgetAppIntentConfig {
  */
 export interface IOSWidgetConfig extends DynamicWidgetEntryConfig {
   /**
-   * Unique identifier for the widget (used as the widget kind and in JS API)
+   * Unique identifier for the widget (used in the JS API and, unless `kind` is set, as the widget kind)
    */
   id: string
+  /**
+   * WidgetKit `kind` of the generated widget. Defaults to `Voltra_Widget_<id>`.
+   * Pin it to the kind of a pre-Voltra widget so already placed instances survive the migration
+   * (WidgetKit identifies a placed widget by extension bundle id + kind).
+   */
+  kind?: string
   displayName: WidgetLabel
   description: WidgetLabel
   /** @default ['systemSmall', 'systemMedium', 'systemLarge'] */
@@ -60,12 +71,22 @@ export interface IOSWidgetConfig extends DynamicWidgetEntryConfig {
   appIntent?: IOSWidgetAppIntentConfig
 }
 
+/**
+ * A Dynamic Live Activity bundled with the app.
+ * @experimental
+ */
+export interface IOSDynamicLiveActivityConfig extends DynamicLiveActivityEntryConfig {}
+
 /**
  * Server-driven iOS widget updates (WidgetKit background refresh).
  */
 export interface IOSWidgetServerUpdateConfig {
-  url: string
-  /** @default 15 */
+  /**
+   * Server endpoint that returns widget state updates. Omit it to mark the widget
+   * server-driven and supply the URL at runtime with `setWidgetServerUpdate`.
+   */
+  url?: string
+  /** @default 15, or 15 when the widget has an `entry` */
   intervalMinutes?: number
   /** @default false */
   refresh?: boolean
@@ -91,6 +112,8 @@ export interface IOSConfigPluginProps {
   enablePushNotifications?: boolean
   groupIdentifier?: string
   widgets?: IOSWidgetConfig[]
+  /** @experimental Dynamic Live Activities rendered from bundled JavaScript entries. */
+  liveActivities?: IOSDynamicLiveActivityConfig[]
   deploymentTarget?: string
   targetName?: string
   fonts?: string[]
@@ -111,6 +134,7 @@ export interface IOSWidgetExtensionPluginProps {
   bundleIdentifier: string
   deploymentTarget: string
   widgets?: IOSWidgetConfig[]
+  liveActivities?: IOSDynamicLiveActivityConfig[]
   groupIdentifier?: string
   keychainGroup?: string
   fonts?: string[]

package/expo-plugin/src/utils/urlScheme.ts

@@ -1,5 +1,42 @@
 import type { ExpoConfig } from 'expo/config'
 
+type URLType = { CFBundleURLSchemes?: unknown }
+
+/**
+ * The URL schemes the app is configured with: every `scheme` and `ios.scheme` value (string or
+ * array), or the bundle identifier when neither is set.
+ */
+export function getAppURLSchemes(config: ExpoConfig): string[] {
+  const configured = [config.scheme, (config.ios as { scheme?: string | string[] } | undefined)?.scheme]
+    .flat()
+    .filter((scheme): scheme is string => typeof scheme === 'string' && scheme.length > 0)
+
+  if (configured.length > 0) {
+    return [...new Set(configured)]
+  }
+
+  return config.ios?.bundleIdentifier ? [config.ios.bundleIdentifier] : []
+}
+
+/**
+ * Appends a URL type for every scheme not already listed. Returns `types` itself when nothing is
+ * missing.
+ */
+export function appendMissingURLSchemes<T extends URLType>(
+  types: T[],
+  schemes: string[]
+): (T | { CFBundleURLSchemes: string[] })[] {
+  const missingSchemes = schemes.filter(
+    (scheme) => !types.some((t) => Array.isArray(t?.CFBundleURLSchemes) && t.CFBundleURLSchemes.includes(scheme))
+  )
+
+  if (missingSchemes.length === 0) {
+    return types
+  }
+
+  return [...types, ...missingSchemes.map((scheme) => ({ CFBundleURLSchemes: [scheme] }))]
+}
+
 /**
  * Ensures the main app has a URL scheme set so widgetURL can open it.
  * This is an optional feature for deep linking from widgets.
@@ -8,37 +45,30 @@ import type { ExpoConfig } from 'expo/config'
  * @returns The modified config with URL scheme ensured
  */
 export function ensureURLScheme(config: ExpoConfig): ExpoConfig {
-  const scheme = typeof (config as any).scheme === 'string' ? (config as any).scheme : config.ios?.bundleIdentifier
+  const existingInfoPlist = config.ios?.infoPlist
+  const existingTypes = existingInfoPlist?.CFBundleURLTypes as URLType[] | undefined
 
-  if (!scheme) {
+  // Expo's own withScheme fills CFBundleURLTypes from `scheme` / `ios.scheme` and always appends
+  // ios.bundleIdentifier, but it skips the app entirely once ios.infoPlist.CFBundleURLTypes is set
+  // (createInfoPlistPluginWithPropertyGuard). Writing the key here when the app hasn't set it
+  // therefore drops every configured scheme instead of adding one. Only top up a list the app owns.
+  if (!existingTypes) {
     return config
   }
 
-  const existingInfoPlist = config.ios?.infoPlist || {}
-  const existingTypes = (existingInfoPlist.CFBundleURLTypes as any[]) || []
-
-  // Check if scheme already exists
-  const hasScheme = existingTypes.some(
-    (t) => Array.isArray(t?.CFBundleURLSchemes) && t.CFBundleURLSchemes.includes(scheme)
-  )
+  const types = appendMissingURLSchemes(existingTypes, getAppURLSchemes(config))
 
-  if (hasScheme) {
+  if (types === existingTypes) {
     return config
   }
 
-  // Add the URL scheme
   return {
     ...config,
     ios: {
       ...config.ios,
       infoPlist: {
         ...existingInfoPlist,
-        CFBundleURLTypes: [
-          ...existingTypes,
-          {
-            CFBundleURLSchemes: [scheme],
-          },
-        ],
+        CFBundleURLTypes: types,
       },
     },
   }

package/expo-plugin/src/validation.ts

@@ -3,9 +3,14 @@ import {
   validateInitialStatePath,
   validateWidgetEntry,
   validateWidgetLabel,
+  validateWidgetServerUpdate,
 } from '@use-voltra/expo-plugin'
 
-import type { IOSConfigPluginProps, IOSWidgetConfig, IOSWidgetFamily } from './types'
+import { iosServerUpdateRules } from './ios/serverUpdate'
+import { getDynamicLiveActivityAttributesType } from '@use-voltra/expo-plugin'
+
+import { widgetKind } from './constants'
+import type { IOSConfigPluginProps, IOSDynamicLiveActivityConfig, IOSWidgetConfig, IOSWidgetFamily } from './types'
 
 const VALID_FAMILIES: Set<IOSWidgetFamily> = new Set([
   'systemSmall',
@@ -16,9 +21,31 @@ const VALID_FAMILIES: Set<IOSWidgetFamily> = new Set([
   'accessoryRectangular',
   'accessoryInline',
 ])
+const DYNAMIC_LIVE_ACTIVITY_ID_PATTERN = /^[a-zA-Z0-9_]+$/
+
+export function validateIOSDynamicLiveActivityConfig(
+  liveActivity: IOSDynamicLiveActivityConfig,
+  projectRoot?: string
+): void {
+  if (!liveActivity.id || typeof liveActivity.id !== 'string') {
+    throw new Error('Dynamic Live Activity ID is required and must be a string')
+  }
+
+  if (!DYNAMIC_LIVE_ACTIVITY_ID_PATTERN.test(liveActivity.id)) {
+    throw new Error(
+      `Dynamic Live Activity ID '${liveActivity.id}' is invalid. ` +
+        'It must be non-empty and contain only alphanumeric characters and underscores.'
+    )
+  }
+
+  validateWidgetEntry(liveActivity.entry, liveActivity.id, projectRoot)
+}
 
 export function validateIOSWidgetConfig(widget: IOSWidgetConfig, projectRoot?: string): void {
   validateHomeScreenWidgetId(widget.id)
+  if (widget.kind !== undefined && (typeof widget.kind !== 'string' || widget.kind.trim() === '')) {
+    throw new Error(`Widget '${widget.id}': kind must be a non-empty string`)
+  }
   validateWidgetLabel(widget.displayName, widget.id, 'displayName')
   validateWidgetLabel(widget.description, widget.id, 'description')
   validateInitialStatePath(widget.initialStatePath, widget.id, projectRoot)
@@ -27,6 +54,8 @@ export function validateIOSWidgetConfig(widget: IOSWidgetConfig, projectRoot?: s
     validateWidgetEntry(widget.entry, widget.id, projectRoot)
   }
 
+  validateWidgetServerUpdate(widget.serverUpdate, widget.id, iosServerUpdateRules(widget))
+
   if (widget.supportedFamilies) {
     if (!Array.isArray(widget.supportedFamilies)) {
       throw new Error(`Widget '${widget.id}': supportedFamilies must be an array`)
@@ -60,13 +89,59 @@ export function validateIOSConfigPluginProps(props: IOSConfigPluginProps, projec
     }
 
     const seenIds = new Set<string>()
+    const seenKinds = new Set<string>()
     for (const widget of props.widgets) {
       validateIOSWidgetConfig(widget, projectRoot)
 
+      // A server-driven Dynamic Widget commits fetched props to the App Group so the widget
+      // extension can read them. Without one it would fetch and have nowhere to put the result.
+      if (widget.entry !== undefined && widget.serverUpdate !== undefined && !props.groupIdentifier) {
+        throw new Error(
+          `Widget '${widget.id}' has both entry and serverUpdate, which requires groupIdentifier ` +
+            'so fetched props can be shared with the widget extension.'
+        )
+      }
+
       if (seenIds.has(widget.id)) {
         throw new Error(`Duplicate widget ID: '${widget.id}'`)
       }
       seenIds.add(widget.id)
+
+      const kind = widgetKind(widget)
+      if (seenKinds.has(kind)) {
+        throw new Error(`Duplicate widget kind: '${kind}'`)
+      }
+      seenKinds.add(kind)
+    }
+  }
+
+  if (props.liveActivities !== undefined) {
+    if (!Array.isArray(props.liveActivities)) {
+      throw new Error('liveActivities must be an array')
+    }
+
+    if (props.liveActivities.length > 0 && !props.groupIdentifier) {
+      throw new Error('groupIdentifier is required when liveActivities is non-empty')
+    }
+
+    const seenIds = new Set<string>()
+    const seenAttributesTypes = new Map<string, string>()
+    for (const liveActivity of props.liveActivities) {
+      validateIOSDynamicLiveActivityConfig(liveActivity, projectRoot)
+
+      if (seenIds.has(liveActivity.id)) {
+        throw new Error(`Duplicate Dynamic Live Activity ID: '${liveActivity.id}'`)
+      }
+      seenIds.add(liveActivity.id)
+
+      const attributesType = getDynamicLiveActivityAttributesType(liveActivity.id)
+      const conflictingId = seenAttributesTypes.get(attributesType)
+      if (conflictingId) {
+        throw new Error(
+          `Dynamic Live Activity IDs '${conflictingId}' and '${liveActivity.id}' generate the same ActivityKit attributes type '${attributesType}'`
+        )
+      }
+      seenAttributesTypes.set(attributesType, liveActivity.id)
     }
   }
 }

package/ios/Package.swift

@@ -25,23 +25,58 @@ let package = Package(
         "BrotliCompression.swift",
         "Data+hexString.swift",
         "Date+toTimerInterval.swift",
-        "ShortNames.swift",
         "VoltraAttributes.swift",
-        "VoltraConfig.swift",
-        "VoltraElement.swift",
         "VoltraEvent.swift",
         "VoltraEventBus.swift",
         "VoltraImageStore.swift",
         "VoltraInteractionIntent.swift",
         "VoltraLiveActivityPayload.swift",
-        "VoltraNode.swift",
         "VoltraPersistentEventQueue.swift",
       ],
       sources: [
+        "DynamicWidgetPropsCodec.swift",
+        "DynamicWidgetPropsStorage.swift",
+        "DynamicWidgetPropsStore.swift",
+        "DynamicWidgetRenderCoordinator.swift",
+        "DynamicWidgetUpdater.swift",
+        "ServerWidgetContentResolver.swift",
+        "ServerWidgetResponseStore.swift",
+        // The settings stack's pure half. The Keychain-, Bundle- and URLSession-backed files in
+        // this folder are compiled only by the podspec, which ships the whole tree.
+        "WidgetServer/WidgetScope.swift",
+        "WidgetServer/WidgetCanonicalConfiguration.swift",
+        "WidgetServer/WidgetServerUpdateSettings.swift",
+        "WidgetServer/WidgetServerSettingsResolver.swift",
+        "WidgetServer/WidgetServerSettingsCodec.swift",
+        "WidgetServer/WidgetServerSettingsValidator.swift",
+        "WidgetServer/WidgetServerRequestBuilder.swift",
+        "WidgetServer/WidgetServerFetcher.swift",
+        "WidgetServer/WidgetServerSettingsStore.swift",
+        "WidgetServer/WidgetServerEtagStore.swift",
+        "WidgetServer/VoltraKeychainHelper.swift",
+        "WidgetServer/VoltraWidgetServer.swift",
+        "WidgetServer/WidgetServerUpdateSettingsJson.swift",
+        "DynamicWidgetServerUpdate/DynamicWidgetServerProps.swift",
+        "DynamicWidgetServerUpdate/DynamicWidgetServerPropsStore.swift",
+        "DynamicWidgetServerUpdate/DynamicWidgetServerFetchResolver.swift",
+        "DynamicWidgetServerUpdate/DynamicWidgetServerUpdateRunner.swift",
+        "VoltraLogger.swift",
+        "dynamic-live-activity/VoltraDynamicLiveActivityTypes.swift",
+        "dynamic-live-activity/VoltraDynamicLiveActivityPayloadValidator.swift",
+        "dynamic-live-activity/VoltraDynamicLiveActivityRenderFailureQueue.swift",
+        "dynamic-live-activity/VoltraLiveActivityOrder.swift",
         "JSONValue.swift",
+        "VoltraConfig.swift",
+        "VoltraConstants.swift",
+        "VoltraWidgetKind.swift",
         "VoltraPayloadMigrator.swift",
         "VoltraRegion.swift",
         "ComponentTypeID.swift",
+        // The JSON -> AST types. They carry no SwiftUI dependency; rendering is attached
+        // by `ui/VoltraNode+View.swift`, which the podspecs compile alongside them.
+        "ShortNames.swift",
+        "VoltraElement.swift",
+        "VoltraNode.swift",
       ]
     ),
     .testTarget(

package/ios/VoltraWidget.podspec

@@ -14,6 +14,7 @@ Pod::Spec.new do |s|
     :ios => '16.4',
   }
   s.swift_version  = '5.9'
+  s.module_name    = 'VoltraRuntime'
   s.source         = { git: 'https://github.com/callstackincubator/voltra' }
   s.static_framework = true