@use-voltra/ios-client 2.2.0 → 2.3.0

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

@@ -6,7 +6,8 @@ import { ensureWidgetFileReference, normalizeRef } from './fileReferences'
 
 const pbxFile = require('xcode/lib/pbxFile')
 
-const WIDGET_BUNDLE_PHASE_NAME = 'Bundle Voltra Dynamic Widgets'
+const WIDGET_BUNDLE_PHASE_NAME = 'Bundle Voltra Dynamic Content'
+const LEGACY_WIDGET_BUNDLE_PHASE_NAME = 'Bundle Voltra Dynamic Widgets'
 
 // Release-only build phase that bakes each Dynamic Widget's production JS bundle into the
 // extension's resources. Debug builds fetch from Metro (and hot-reload), so this no-ops there. Runs
@@ -14,7 +15,8 @@ const WIDGET_BUNDLE_PHASE_NAME = 'Bundle Voltra Dynamic Widgets'
 // voltra-widget-<id>.bundle lands in the .appex (Bundle.main) where the runtime's release loader
 // reads it. SRCROOT is the ios/ dir; the project root is one level up, matching how Expo's main
 // "Bundle React Native code and images" phase resolves things.
-const WIDGET_BUNDLE_SHELL_SCRIPT = `if [[ "$CONFIGURATION" == *Debug* ]]; then
+function bundleShellScript(content: 'all' | 'live-activities'): string {
+  return `if [[ "$CONFIGURATION" == *Debug* ]]; then
   echo "Voltra: Debug build — Dynamic Widgets load from Metro, skipping bundling"
   exit 0
 fi
@@ -48,6 +50,7 @@ try {
   console.error(error && error.message ? error.message : String(error))
   process.exit(1)
 }
+
 NODE
 )"
 if [[ -z "$BUNDLER" ]]; then
@@ -56,14 +59,23 @@ if [[ -z "$BUNDLER" ]]; then
 fi
 
 echo "Voltra: widget bundler resolved to $BUNDLER"
-"$NODE_BINARY" "$BUNDLER" --out-dir "$TARGET_BUILD_DIR/$UNLOCALIZED_RESOURCES_FOLDER_PATH" --platform ios --project-root "$PROJECT_ROOT"
+"$NODE_BINARY" "$BUNDLER" --out-dir "$TARGET_BUILD_DIR/$UNLOCALIZED_RESOURCES_FOLDER_PATH" --platform ios --project-root "$PROJECT_ROOT" --content ${content}
 `
+}
+
+function pbxQuotedShellScript(script: string): string {
+  return `"${script.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n')}"`
+}
 
 /**
  * Adds (idempotently) the release-only shell-script phase that bakes Dynamic Widget
  * bundles into the extension. Safe to call on every prebuild; only added when absent.
  */
-export function ensureWidgetBundleScriptPhase(xcodeProject: XcodeProject, targetUuid: string): void {
+export function ensureWidgetBundleScriptPhase(
+  xcodeProject: XcodeProject,
+  targetUuid: string,
+  content: 'all' | 'live-activities' = 'all'
+): void {
   const nativeTargets = xcodeProject.pbxNativeTargetSection()
   const target = nativeTargets[targetUuid]
   if (!target) {
@@ -75,15 +87,37 @@ export function ensureWidgetBundleScriptPhase(xcodeProject: XcodeProject, target
 
   const shellPhases = xcodeProject.hash.project.objects.PBXShellScriptBuildPhase || {}
   const quotedName = `"${WIDGET_BUNDLE_PHASE_NAME}"`
-  const alreadyPresent = target.buildPhases.some((entry: any) => shellPhases[entry.value]?.name === quotedName)
-  if (alreadyPresent) {
-    return
-  }
-
-  xcodeProject.addBuildPhase([], 'PBXShellScriptBuildPhase', WIDGET_BUNDLE_PHASE_NAME, targetUuid, {
-    shellPath: '/bin/sh',
-    shellScript: WIDGET_BUNDLE_SHELL_SCRIPT,
+  const quotedLegacyName = `"${LEGACY_WIDGET_BUNDLE_PHASE_NAME}"`
+  const matchingEntries = target.buildPhases.filter((entry: any) => {
+    const name = shellPhases[entry.value]?.name
+    return name === quotedName || name === quotedLegacyName
   })
+  let phase: any | undefined
+  if (matchingEntries.length > 0) {
+    const retained = matchingEntries[0]
+    phase = shellPhases[retained.value]
+    phase.name = quotedName
+    target.buildPhases = target.buildPhases.filter((entry: any) => {
+      if (entry === retained || !matchingEntries.includes(entry)) return true
+      delete shellPhases[entry.value]
+      delete shellPhases[`${entry.value}_comment`]
+      return false
+    })
+  } else {
+    xcodeProject.addBuildPhase([], 'PBXShellScriptBuildPhase', WIDGET_BUNDLE_PHASE_NAME, targetUuid, {
+      shellPath: '/bin/sh',
+      shellScript: bundleShellScript(content),
+    })
+    phase = Object.values(xcodeProject.hash.project.objects.PBXShellScriptBuildPhase || {}).find(
+      (candidate: any) => candidate?.name === quotedName
+    )
+  }
+  if (phase) {
+    // xcode's serializer expects an already PBX-quoted value when an existing
+    // phase is reconciled directly (addBuildPhase performs this for new ones).
+    phase.shellScript = pbxQuotedShellScript(bundleShellScript(content))
+    phase.alwaysOutOfDate = 1
+  }
 
   // The phase intentionally re-bakes on every release build (it can't statically enumerate every
   // widget source as an input). Mark it always-out-of-date so Xcode doesn't warn about the missing
@@ -112,6 +146,8 @@ export interface EnsureBuildPhasesOptions {
   }
   widgetFiles: IOSWidgetExtensionFiles
   mainTargetUuid?: string
+  /** Generated ActivityKit types compiled into both the extension and the app. */
+  mainSwiftFiles?: string[]
 }
 
 /**
@@ -191,6 +227,17 @@ export function ensureBuildPhases(xcodeProject: XcodeProject, options: EnsureBui
     ensureBuildPhaseFiles(xcodeProject, sourcesPhase, [...swiftFiles, ...intentFiles], targetName)
   }
 
+  if (options.mainSwiftFiles && options.mainSwiftFiles.length > 0) {
+    let mainSourcesPhase = findTargetPhaseByType(xcodeProject, mainTargetUuid, 'PBXSourcesBuildPhase')
+    if (!mainSourcesPhase) {
+      xcodeProject.addBuildPhase([], 'PBXSourcesBuildPhase', 'Sources', mainTargetUuid, folderType, buildPath)
+      mainSourcesPhase = findTargetPhaseByType(xcodeProject, mainTargetUuid, 'PBXSourcesBuildPhase')
+    }
+    if (mainSourcesPhase) {
+      ensureBuildPhaseFiles(xcodeProject, mainSourcesPhase, options.mainSwiftFiles, targetName)
+    }
+  }
+
   // Copy files build phase (embed extension into main app) — the embed phase is matched purely by
   // its `dstSubfolderSpec == 13` semantics, both before and after creation
   let copyFilesPhase = findExistingEmbedExtensionsPhase(xcodeProject, mainTargetUuid)

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

@@ -1,7 +1,7 @@
 import { ConfigPlugin, withXcodeProject, XcodeProject } from '@expo/config-plugins'
 import * as path from 'path'
 
-import type { IOSWidgetConfig, IOSWidgetExtensionFiles } from '../../types'
+import type { IOSDynamicLiveActivityConfig, IOSWidgetConfig, IOSWidgetExtensionFiles } from '../../types'
 import { getIOSWidgetExtensionFiles } from '../../utils/fileDiscovery'
 import { detectClientRenderedWidgets } from '../clientRendered'
 import { ensureBuildPhases, ensureWidgetBundleScriptPhase } from './buildPhases'
@@ -20,6 +20,7 @@ export interface ConfigureXcodeProjectProps {
   /** App build number; becomes the widget's CURRENT_PROJECT_VERSION. */
   buildNumber?: string
   widgets?: IOSWidgetConfig[]
+  liveActivities?: IOSDynamicLiveActivityConfig[]
 }
 
 /**
@@ -42,6 +43,13 @@ export function applyXcodeChanges(
 ): void {
   const { targetName, bundleIdentifier, deploymentTarget, version, buildNumber } = props
   const groupName = 'Embed Foundation Extensions'
+  const mainTargetUuid = xcodeProject.getFirstTarget().uuid
+  // The catalog is compiled into the app even for a legacy-only configuration.
+  // Keep it in the extension group too so both targets share one PBX file reference.
+  const effectiveWidgetFiles: IOSWidgetExtensionFiles = {
+    ...widgetFiles,
+    swiftFiles: Array.from(new Set([...widgetFiles.swiftFiles, 'VoltraDynamicLiveActivityTypes.swift'])),
+  }
 
   // Read main app target settings to synchronize code signing (per configuration).
   const mainAppSettings = getMainAppTargetSettings(xcodeProject)
@@ -92,7 +100,7 @@ export function applyXcodeChanges(
   // reference them (the phases resolve files through the widget-scoped group).
   ensurePbxGroup(xcodeProject, {
     targetName,
-    widgetFiles,
+    widgetFiles: effectiveWidgetFiles,
   })
 
   // Ensure build phases and their files.
@@ -101,13 +109,22 @@ export function applyXcodeChanges(
     targetName,
     groupName,
     productFile,
-    widgetFiles,
+    widgetFiles: effectiveWidgetFiles,
     mainTargetUuid: xcodeProject.getFirstTarget().uuid,
+    // The app-side lifecycle service always compiles against the generated catalog.
+    // An empty catalog keeps legacy-only apps source-compatible.
+    mainSwiftFiles: ['VoltraDynamicLiveActivityTypes.swift'],
   })
 
-  if (hasClientRenderedWidgets) {
+  if (hasClientRenderedWidgets || (props.liveActivities?.length ?? 0) > 0) {
     ensureWidgetBundleScriptPhase(xcodeProject, targetUuid)
   }
+  if ((props.liveActivities?.length ?? 0) > 0) {
+    // Local Dynamic Live Activity starts preflight the baked definition from
+    // the app process, while WidgetKit renders from the extension process.
+    // Bake the same manifest into both products.
+    ensureWidgetBundleScriptPhase(xcodeProject, mainTargetUuid, 'live-activities')
+  }
 
   ensureTargetAttributes(xcodeProject, targetUuid)
   ensureTargetDependency(xcodeProject, targetUuid)
@@ -128,7 +145,7 @@ export function applyXcodeChanges(
  * mutation to {@link applyXcodeChanges}.
  */
 export const configureXcodeProject: ConfigPlugin<ConfigureXcodeProjectProps> = (config, props) => {
-  const { targetName, widgets } = props
+  const { targetName, widgets, liveActivities } = props
 
   return withXcodeProject(config, (config) => {
     if (config.modRequest.introspect) {
@@ -147,7 +164,7 @@ export const configureXcodeProject: ConfigPlugin<ConfigureXcodeProjectProps> = (
     const targetPath = path.join(platformProjectRoot, targetName)
     const widgetFiles = getIOSWidgetExtensionFiles(targetPath, targetName)
 
-    applyXcodeChanges(xcodeProject, props, widgetFiles, hasClientRenderedWidgets)
+    applyXcodeChanges(xcodeProject, props, widgetFiles, hasClientRenderedWidgets || (liveActivities?.length ?? 0) > 0)
 
     return config
   })

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,15 +25,12 @@ let package = Package(
         "BrotliCompression.swift",
         "Data+hexString.swift",
         "Date+toTimerInterval.swift",
-        "ShortNames.swift",
         "VoltraAttributes.swift",
-        "VoltraElement.swift",
         "VoltraEvent.swift",
         "VoltraEventBus.swift",
         "VoltraImageStore.swift",
         "VoltraInteractionIntent.swift",
         "VoltraLiveActivityPayload.swift",
-        "VoltraNode.swift",
         "VoltraPersistentEventQueue.swift",
       ],
       sources: [
@@ -42,12 +39,44 @@ let package = Package(
         "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