@use-voltra/ios-client 2.1.1 → 2.3.0

package/expo-plugin/src/ios-widget/clientRendered.ts

@@ -1,7 +1,7 @@
 import * as fs from 'fs'
 import * as path from 'path'
 
-import { evaluateWidgetModuleExports } from '@use-voltra/expo-plugin'
+import { createPrerenderWidgetModuleLoader, type WidgetModuleLoader } from '@use-voltra/expo-plugin'
 
 import type { IOSWidgetConfig } from '../types'
 
@@ -30,7 +30,8 @@ let hasWarnedExperimental = false
 
 /** Inspect every widget once and tag entry-backed widgets as Dynamic Widgets. */
 export function detectClientRenderedWidgets(widgets: IOSWidgetConfig[], projectRoot: string): DetectedIOSWidget[] {
-  const detected = widgets.map((widget) => detectSingleWidget(widget, projectRoot))
+  const loader = createPrerenderWidgetModuleLoader(projectRoot, 'ios')
+  const detected = widgets.map((widget) => detectSingleWidget(widget, projectRoot, loader))
 
   if (!hasWarnedExperimental) {
     const clientWidgetIds = detected.filter((widget) => widget.clientRendered).map((widget) => widget.id)
@@ -47,7 +48,11 @@ export function detectClientRenderedWidgets(widgets: IOSWidgetConfig[], projectR
   return detected
 }
 
-function detectSingleWidget(widget: IOSWidgetConfig, projectRoot: string): DetectedIOSWidget {
+function detectSingleWidget(
+  widget: IOSWidgetConfig,
+  projectRoot: string,
+  loader: WidgetModuleLoader
+): DetectedIOSWidget {
   if (widget.entry === undefined) {
     return {
       ...widget,
@@ -65,8 +70,7 @@ function detectSingleWidget(widget: IOSWidgetConfig, projectRoot: string): Detec
     )
   }
 
-  const widgetModule = evaluateWidgetModuleExports(projectRoot, sourcePath)
-  const widgetFn = widgetModule?.default ?? widgetModule
+  const widgetFn = loader.loadDefaultExport(sourcePath)
   if (typeof widgetFn !== 'function') {
     throw new Error(
       `[voltra] Dynamic Widget "${widget.id}" at ${path.relative(

package/expo-plugin/src/ios-widget/clientRenderedPrerender.ts

@@ -1,4 +1,9 @@
-import { evaluateWidgetModuleExports, logger, type PrerenderedWidgetStates } from '@use-voltra/expo-plugin'
+import {
+  createPrerenderWidgetModuleLoader,
+  logger,
+  resolveInstalledPackageVersion,
+  type PrerenderedWidgetStates,
+} from '@use-voltra/expo-plugin'
 
 import type { DetectedIOSWidget } from './clientRendered'
 
@@ -31,7 +36,7 @@ const SINGLE_LOCALE_KEY = '__default'
  * mirror `WidgetEnvironment` from packages/core/src/widget-environment.ts so the widget
  * function sees the same shape it gets at runtime.
  */
-function buildPlaceholderEnv(): Record<string, unknown> {
+function buildPlaceholderEnv(voltraVersion: string): Record<string, unknown> {
   return {
     date: Date.now(),
     widgetFamily: 'systemMedium',
@@ -44,7 +49,7 @@ function buildPlaceholderEnv(): Record<string, unknown> {
       isDev: false,
       metroUrl: null,
       appVersion: 'unknown',
-      voltraVersion: '1.4.1',
+      voltraVersion,
     },
   }
 }
@@ -75,12 +80,12 @@ export async function prerenderClientRenderedWidgets(
     renderVoltraVariantToJson: (element: unknown) => unknown
   }
 
-  const placeholderEnv = buildPlaceholderEnv()
+  const placeholderEnv = buildPlaceholderEnv(resolveInstalledPackageVersion(projectRoot, '@use-voltra/ios-client'))
+  const loader = createPrerenderWidgetModuleLoader(projectRoot, 'ios')
 
   for (const widget of clientWidgets) {
     try {
-      const widgetModule = evaluateWidgetModuleExports(projectRoot, widget.clientSourcePath)
-      const widgetFn = widgetModule?.default ?? widgetModule
+      const widgetFn = loader.loadDefaultExport(widget.clientSourcePath)
       if (typeof widgetFn !== 'function') {
         throw new Error(
           `Expected the entry module at ${widget.clientSourcePath} to default-export a function or component.`

package/expo-plugin/src/ios-widget/dynamic-live-activity/swift.ts

@@ -0,0 +1,138 @@
+import dedent from 'dedent'
+
+import { getDynamicLiveActivityAttributesType } from '@use-voltra/expo-plugin'
+
+import type { IOSDynamicLiveActivityConfig } from '../../types'
+import { escapeForSwiftStringLiteral } from '../files/swift-utils'
+
+export function generateDynamicLiveActivityWidgetInstances(liveActivities: IOSDynamicLiveActivityConfig[]): string {
+  return sortedDefinitions(liveActivities)
+    .map((liveActivity) => `VoltraDynamicLiveActivity_${getDynamicLiveActivityAttributesType(liveActivity.id)}()`)
+    .join('\n    ')
+}
+
+/** Generates the Dynamic Live Activity types shared by the app and extension targets. */
+export function generateDynamicLiveActivityTypesSwift(liveActivities: IOSDynamicLiveActivityConfig[]): string {
+  const definitions = sortedDefinitions(liveActivities)
+  const typeDefinitions = definitions.map(generateDynamicLiveActivitySwift).map(normalizeIndent).join('\n\n')
+
+  const header = dedent`
+    //
+    //  VoltraDynamicLiveActivityTypes.swift
+    //
+    //  Auto-generated by Voltra config plugin. Do not edit.
+    //
+
+    import ActivityKit
+    import Foundation
+
+    import VoltraRuntime
+
+    @objc(VoltraGeneratedDynamicLiveActivityRegistration)
+    public final class VoltraGeneratedDynamicLiveActivityRegistration: NSObject {
+      @objc public static func registerDefinitions() {
+${definitions
+  .map(
+    (liveActivity) =>
+      `        VoltraDynamicLiveActivityRegistry.shared.register(${getDynamicLiveActivityAttributesType(
+        liveActivity.id
+      )}.self)`
+  )
+  .join('\n')}
+      }
+    }
+
+  `
+  return [header.trim(), typeDefinitions.trim()].filter(Boolean).join('\n\n')
+}
+
+/** Generates extension-only ActivityConfiguration declarations for Dynamic Live Activities. */
+export function generateDynamicLiveActivitiesSwift(liveActivities: IOSDynamicLiveActivityConfig[]): string {
+  const configurations = sortedDefinitions(liveActivities)
+    .map((liveActivity) => {
+      const attributesType = getDynamicLiveActivityAttributesType(liveActivity.id)
+      const definitionId = escapeForSwiftStringLiteral(liveActivity.id)
+      return dedent`
+        public struct VoltraDynamicLiveActivity_${attributesType}: Widget {
+          public init() {}
+
+          public var body: some WidgetConfiguration {
+            if #available(iOS 18.0, *) {
+              return adaptiveConfig()
+            } else {
+              return defaultConfig()
+            }
+          }
+
+          @available(iOS 18.0, *)
+          private func adaptiveConfig() -> some WidgetConfiguration {
+            ActivityConfiguration(for: ${attributesType}.self) { context in
+              VoltraDynamicLiveActivityRenderer.lockScreen(definitionId: "${definitionId}", context: context)
+            } dynamicIsland: { context in
+              VoltraDynamicLiveActivityRenderer.dynamicIsland(definitionId: "${definitionId}", context: context)
+            }
+            .supplementalActivityFamilies([.small, .medium])
+          }
+
+          private func defaultConfig() -> some WidgetConfiguration {
+            ActivityConfiguration(for: ${attributesType}.self) { context in
+              VoltraDynamicLiveActivityRenderer.lockScreen(definitionId: "${definitionId}", context: context)
+            } dynamicIsland: { context in
+              VoltraDynamicLiveActivityRenderer.dynamicIsland(definitionId: "${definitionId}", context: context)
+            }
+          }
+        }
+      `
+    })
+    .map(normalizeIndent)
+    .join('\n\n')
+
+  const header = dedent`
+    //
+    //  VoltraDynamicLiveActivities.swift
+    //
+    //  Auto-generated by Voltra config plugin. Do not edit.
+    //
+
+    import ActivityKit
+    import SwiftUI
+    import WidgetKit
+    import VoltraRuntime
+
+  `
+  return [header.trim(), configurations.trim()].filter(Boolean).join('\n\n')
+}
+
+function generateDynamicLiveActivitySwift(liveActivity: IOSDynamicLiveActivityConfig): string {
+  const attributesType = getDynamicLiveActivityAttributesType(liveActivity.id)
+  const definitionId = escapeForSwiftStringLiteral(liveActivity.id)
+
+  return dedent`
+    public struct ${attributesType}: ActivityAttributes {
+      public typealias ContentState = VoltraDynamicLiveActivityContentState
+
+      public let name: String
+      public let deepLinkUrl: String?
+
+      public init(name: String, deepLinkUrl: String?) {
+        self.name = name
+        self.deepLinkUrl = deepLinkUrl
+      }
+    }
+
+    extension ${attributesType}: VoltraDynamicLiveActivityDefinition {
+      public static let definitionId = "${definitionId}"
+    }
+
+  `
+}
+
+function sortedDefinitions(liveActivities: IOSDynamicLiveActivityConfig[]): IOSDynamicLiveActivityConfig[] {
+  return [...liveActivities].sort((left, right) => left.id.localeCompare(right.id))
+}
+
+function normalizeIndent(source: string): string {
+  const lines = source.trim().split('\n')
+  const indent = Math.min(...lines.filter(Boolean).map((line) => line.match(/^\s*/)?.[0].length ?? 0))
+  return lines.map((line) => line.slice(indent)).join('\n')
+}

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

@@ -2,20 +2,22 @@ import { ConfigPlugin, withDangerousMod } from '@expo/config-plugins'
 import * as fs from 'fs'
 import * as path from 'path'
 
-import type { IOSWidgetConfig } from '../../types'
+import type { IOSDynamicLiveActivityConfig, IOSWidgetConfig } from '../../types'
 import { generateAssets } from './assets'
 import { generateEntitlements } from './entitlements'
 import { generateInfoPlist } from './infoPlist'
-import { generateIOSDynamicWidgetsManifest } from './manifest'
+import { generateIOSDynamicLiveActivitiesManifest, generateIOSDynamicWidgetsManifest } from './manifest'
 import { generateSwiftFiles } from './swift'
 
 export interface GenerateWidgetExtensionFilesProps {
   targetName: string
   widgets?: IOSWidgetConfig[]
+  liveActivities?: IOSDynamicLiveActivityConfig[]
   groupIdentifier?: string
   keychainGroup?: string
   version: string
   buildNumber: string
+  voltraVersion: string
 }
 
 /**
@@ -31,7 +33,8 @@ export interface GenerateWidgetExtensionFilesProps {
  * This should run before configureXcodeProject so the files exist when Xcode project is configured.
  */
 export const generateWidgetExtensionFiles: ConfigPlugin<GenerateWidgetExtensionFilesProps> = (config, props) => {
-  const { targetName, widgets, groupIdentifier, keychainGroup, version, buildNumber } = props
+  const { targetName, widgets, liveActivities, groupIdentifier, keychainGroup, version, buildNumber, voltraVersion } =
+    props
 
   return withDangerousMod(config, [
     'ios',
@@ -49,7 +52,7 @@ export const generateWidgetExtensionFiles: ConfigPlugin<GenerateWidgetExtensionF
       }
 
       // Generate Info.plist
-      generateInfoPlist(targetPath, targetName, version, buildNumber)
+      generateInfoPlist(targetPath, targetName, version, buildNumber, voltraVersion)
 
       // Generate Assets.xcassets and copy user images
       generateAssets({ targetPath })
@@ -59,6 +62,7 @@ export const generateWidgetExtensionFiles: ConfigPlugin<GenerateWidgetExtensionF
         targetPath,
         projectRoot,
         widgets,
+        liveActivities,
       })
 
       // Write the iOS-owned Dynamic Widgets manifest for Metro to consume later.
@@ -67,6 +71,13 @@ export const generateWidgetExtensionFiles: ConfigPlugin<GenerateWidgetExtensionF
         widgets,
       })
 
+      // Dynamic Live Activities have their own Metro manifest so their IDs may overlap with
+      // Dynamic Widgets and stale declarations never leak into a later prebuild.
+      generateIOSDynamicLiveActivitiesManifest({
+        projectRoot,
+        liveActivities,
+      })
+
       // Generate entitlements file (may be empty if no groupIdentifier or keychainGroup)
       generateEntitlements({
         targetPath,

package/expo-plugin/src/ios-widget/files/infoPlist.ts

@@ -9,7 +9,12 @@ import { logger } from '@use-voltra/expo-plugin'
  * This includes version information and the required WidgetKit extension point.
  * Version keys are written directly to the plist following the Expo pattern.
  */
-function generateInfoPlistContent(targetName: string, version: string, buildNumber: string): string {
+function generateInfoPlistContent(
+  targetName: string,
+  version: string,
+  buildNumber: string,
+  voltraVersion: string
+): string {
   return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
@@ -32,6 +37,8 @@ function generateInfoPlistContent(targetName: string, version: string, buildNumb
 	<string>${version}</string>
 	<key>CFBundleVersion</key>
 	<string>${buildNumber}</string>
+	<key>Voltra_Version</key>
+	<string>${voltraVersion}</string>
 	<key>NSExtension</key>
 	<dict>
 		<key>NSExtensionPointIdentifier</key>
@@ -49,9 +56,16 @@ function generateInfoPlistContent(targetName: string, version: string, buildNumb
  * @param targetName - The widget extension target name (used for CFBundleDisplayName)
  * @param version - The app version (CFBundleShortVersionString)
  * @param buildNumber - The build number (CFBundleVersion)
+ * @param voltraVersion - The installed @use-voltra/ios-client package version
  */
-export function generateInfoPlist(targetPath: string, targetName: string, version: string, buildNumber: string): void {
+export function generateInfoPlist(
+  targetPath: string,
+  targetName: string,
+  version: string,
+  buildNumber: string,
+  voltraVersion: string
+): void {
   const infoPlistPath = path.join(targetPath, 'Info.plist')
-  fs.writeFileSync(infoPlistPath, generateInfoPlistContent(targetName, version, buildNumber))
+  fs.writeFileSync(infoPlistPath, generateInfoPlistContent(targetName, version, buildNumber, voltraVersion))
   logger.info('Generated Info.plist')
 }

package/expo-plugin/src/ios-widget/files/manifest.ts

@@ -1,17 +1,28 @@
 import * as fs from 'fs'
 import * as path from 'path'
 
-import { type DynamicWidgetManifest, logger, validateWidgetEntry } from '@use-voltra/expo-plugin'
+import {
+  type DynamicLiveActivityManifest,
+  type DynamicWidgetManifest,
+  logger,
+  validateWidgetEntry,
+} from '@use-voltra/expo-plugin'
 
-import type { IOSWidgetConfig } from '../../types'
+import type { IOSDynamicLiveActivityConfig, IOSWidgetConfig } from '../../types'
 
 const MANIFEST_PATH = path.join('.voltra', 'manifest.ios.json')
+const LIVE_ACTIVITIES_MANIFEST_PATH = path.join('.voltra', 'manifest.ios.live-activities.json')
 
 export interface GenerateIOSDynamicWidgetsManifestOptions {
   projectRoot: string
   widgets?: IOSWidgetConfig[]
 }
 
+export interface GenerateIOSDynamicLiveActivitiesManifestOptions {
+  projectRoot: string
+  liveActivities?: IOSDynamicLiveActivityConfig[]
+}
+
 export function createIOSDynamicWidgetsManifest(
   projectRoot: string,
   widgets: IOSWidgetConfig[]
@@ -36,6 +47,22 @@ export function createIOSDynamicWidgetsManifest(
   }
 }
 
+export function createIOSDynamicLiveActivitiesManifest(
+  projectRoot: string,
+  liveActivities: IOSDynamicLiveActivityConfig[]
+): DynamicLiveActivityManifest {
+  return {
+    version: 1,
+    platform: 'ios',
+    liveActivities: [...liveActivities]
+      .sort((left, right) => left.id.localeCompare(right.id))
+      .map((liveActivity) => ({
+        id: liveActivity.id,
+        entry: validateWidgetEntry(liveActivity.entry, liveActivity.id, projectRoot),
+      })),
+  }
+}
+
 export function generateIOSDynamicWidgetsManifest(options: GenerateIOSDynamicWidgetsManifestOptions): void {
   const { projectRoot, widgets } = options
   const manifestPath = path.join(projectRoot, MANIFEST_PATH)
@@ -45,3 +72,16 @@ export function generateIOSDynamicWidgetsManifest(options: GenerateIOSDynamicWid
   fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`)
   logger.info(`Generated ${MANIFEST_PATH}`)
 }
+
+/** Writes the dedicated Dynamic Live Activity manifest on every prebuild, including when empty. */
+export function generateIOSDynamicLiveActivitiesManifest(
+  options: GenerateIOSDynamicLiveActivitiesManifestOptions
+): void {
+  const { projectRoot, liveActivities } = options
+  const manifestPath = path.join(projectRoot, LIVE_ACTIVITIES_MANIFEST_PATH)
+  const manifest = createIOSDynamicLiveActivitiesManifest(projectRoot, liveActivities ?? [])
+
+  fs.mkdirSync(path.dirname(manifestPath), { recursive: true })
+  fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`)
+  logger.info(`Generated ${LIVE_ACTIVITIES_MANIFEST_PATH}`)
+}

package/expo-plugin/src/ios-widget/files/swift-utils.ts

@@ -0,0 +1,3 @@
+export function escapeForSwiftStringLiteral(value: string): string {
+  return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n').replace(/\r/g, '\\r')
+}

package/expo-plugin/src/ios-widget/files/swift.ts

@@ -11,16 +11,24 @@ import {
   type WidgetLabel,
 } from '@use-voltra/expo-plugin'
 
-import { DEFAULT_WIDGET_FAMILIES, WIDGET_FAMILY_MAP } from '../../constants'
-import type { IOSWidgetConfig } from '../../types'
+import { DEFAULT_WIDGET_FAMILIES, WIDGET_FAMILY_MAP, widgetKind } from '../../constants'
+import type { IOSDynamicLiveActivityConfig, IOSWidgetConfig } from '../../types'
 import { VOLTRA_WIDGET_STRINGS_BASENAME } from '../../utils/fileDiscovery'
 import { detectClientRenderedWidgets, type DetectedIOSWidget } from '../clientRendered'
 import { prerenderClientRenderedWidgets } from '../clientRenderedPrerender'
+import {
+  generateDynamicLiveActivitiesSwift,
+  generateDynamicLiveActivityTypesSwift,
+  generateDynamicLiveActivityWidgetInstances,
+} from '../dynamic-live-activity/swift'
+
+import { escapeForSwiftStringLiteral } from './swift-utils'
 
 export interface GenerateSwiftFilesOptions {
   targetPath: string
   projectRoot: string
   widgets?: IOSWidgetConfig[]
+  liveActivities?: IOSDynamicLiveActivityConfig[]
 }
 
 type RenderWidgetToString = (variants: unknown) => string
@@ -37,7 +45,7 @@ type RenderWidgetToString = (variants: unknown) => string
  * - VoltraWidgetBundle.swift (widget bundle definition)
  */
 export async function generateSwiftFiles(options: GenerateSwiftFilesOptions): Promise<void> {
-  const { targetPath, projectRoot, widgets } = options
+  const { targetPath, projectRoot, widgets, liveActivities } = options
 
   // Dynamic import keeps the plugin CommonJS-compatible while resolving the current package entry.
   const serverModuleId = '@use-voltra/ios/server'
@@ -59,7 +67,7 @@ export async function generateSwiftFiles(options: GenerateSwiftFilesOptions): Pr
   // stringify). Both produce entries in the same map shape so
   // VoltraWidgetInitialStates.swift can read either via the same lookup at runtime.
   const serverWidgets = detectedWidgets.filter((w) => !w.clientRendered)
-  const serverStates = await prerenderWidgetState(serverWidgets, projectRoot, renderWidgetToString)
+  const serverStates = await prerenderWidgetState(serverWidgets, projectRoot, renderWidgetToString, 'ios')
   const clientStates = await prerenderClientRenderedWidgets(detectedWidgets, projectRoot)
   const prerenderedStates = new Map([...serverStates, ...clientStates])
 
@@ -76,12 +84,24 @@ export async function generateSwiftFiles(options: GenerateSwiftFilesOptions): Pr
 
   // Generate the widget bundle Swift file
   const widgetBundleContent =
-    detectedWidgets.length > 0 ? generateWidgetBundleSwift(detectedWidgets) : generateDefaultWidgetBundleSwift()
+    detectedWidgets.length > 0 || (liveActivities?.length ?? 0) > 0
+      ? generateWidgetBundleSwift(detectedWidgets, liveActivities ?? [])
+      : generateDefaultWidgetBundleSwift()
 
   const widgetBundlePath = path.join(targetPath, 'VoltraWidgetBundle.swift')
   fs.writeFileSync(widgetBundlePath, widgetBundleContent)
 
   logger.info(`Generated VoltraWidgetBundle.swift with ${widgets?.length ?? 0} home screen widgets`)
+
+  fs.writeFileSync(
+    path.join(targetPath, 'VoltraDynamicLiveActivityTypes.swift'),
+    generateDynamicLiveActivityTypesSwift(liveActivities ?? [])
+  )
+  fs.writeFileSync(
+    path.join(targetPath, 'VoltraDynamicLiveActivities.swift'),
+    generateDynamicLiveActivitiesSwift(liveActivities ?? [])
+  )
+  logger.info(`Generated Dynamic Live Activity Swift scaffolding with ${liveActivities?.length ?? 0} definition(s)`)
 }
 
 const GENERATED_INITIAL_STATE_LOCALE_HELPER = dedent`
@@ -155,10 +175,6 @@ const GENERATED_INITIAL_STATE_LOCALE_HELPER = dedent`
 // https://developer.apple.com/documentation/foundation/localizedstringresource
 // ============================================================================
 
-function escapeForSwiftStringLiteral(s: string): string {
-  return s.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n').replace(/\r/g, '\\r')
-}
-
 function escapeDotStringsValue(s: string): string {
   return escapeForSwiftStringLiteral(s)
 }
@@ -285,6 +301,12 @@ function iosWidgetGalleryLabelSwiftExpr(
  *  - Dynamic Widget → `VoltraClientWidgetProvider` + `VoltraClientWidgetContentView`
  *    (the content view internally renders via VoltraHomeWidgetView so the UI layer is
  *    identical to the fallback state path — see VoltraClientWidgetRuntime.swift)
+ *  - Dynamic Widget with a `serverUpdate` → `VoltraDynamicWidgetServerUpdateProvider`, which wraps
+ *    the one above and adds the fetch, the commit and the schedule
+ *
+ * `entry` picks the render engine and `serverUpdate` picks where the data comes from, so the two
+ * keys together select one of four providers. Runtime code never asks "is this server-driven?" —
+ * the answer is baked in here, once, at generate time.
  */
 function widgetUsesAppIntent(widget: DetectedIOSWidget): boolean {
   return widget.clientRendered && !!widget.appIntent && widget.appIntent.parameters.length > 0
@@ -306,9 +328,13 @@ function generateWidgetStruct(widget: DetectedIOSWidget): string {
   const displayNameExpr = iosWidgetGalleryLabelSwiftExpr(widget.id, 'displayName', widget.displayName)
   const descriptionExpr = iosWidgetGalleryLabelSwiftExpr(widget.id, 'description', widget.description)
 
+  const clientProviderName = widget.serverUpdate
+    ? 'VoltraDynamicWidgetServerUpdateProvider'
+    : 'VoltraClientWidgetProvider'
+
   const providerAndContent = widget.clientRendered
     ? dedent`
-        provider: VoltraClientWidgetProvider(
+        provider: ${clientProviderName}(
           widgetId: widgetId,
           initialState: VoltraWidgetInitialStates.getInitialState(for: widgetId)
         )
@@ -335,7 +361,7 @@ function generateWidgetStruct(widget: DetectedIOSWidget): string {
 
       public var body: some WidgetConfiguration {
         StaticConfiguration(
-          kind: "Voltra_Widget_${widget.id}",
+          kind: "${widgetKind(widget)}",
           ${providerAndContent}
         .configurationDisplayName(${displayNameExpr})
         .description(${descriptionExpr})
@@ -377,6 +403,18 @@ function generateClientAppIntentWidgetCode(widget: DetectedIOSWidget): string {
   const initBody = params.map((p) => `    self.${p.name} = ${p.name}`).join('\n')
   const configuredDict = dictLiteral(params.map((p) => `"${p.name}": configuration.${p.name}`))
   const defaultDict = dictLiteral(params.map((p) => `"${p.name}": ${swiftDefault(p)}`))
+  // A server-driven Dynamic Widget fetches on every timeline request and schedules the next one
+  // from its resolved interval; a plain one has nothing to ask again for, so its policy is .never.
+  const appIntentTimelineBody = widget.serverUpdate
+    ? dedent`
+        return await VoltraDynamicWidgetServerUpdateProvider.timeline(
+          widgetId: widgetId,
+          family: context.family,
+          configuration: ${configuredDict}
+        )`
+    : dedent`
+        let entry = await VoltraClientWidgetProvider.loadEntry(widgetId: widgetId, configuration: ${configuredDict})
+        return Timeline(entries: [entry], policy: .never)`
 
   return dedent`
     // MARK: - Client-rendered AppIntent widget: ${widget.id}
@@ -408,9 +446,8 @@ function generateClientAppIntentWidgetCode(widget: DetectedIOSWidget): string {
         await VoltraClientWidgetProvider.loadEntry(widgetId: widgetId, configuration: ${configuredDict})
       }
 
-      func timeline(for configuration: ${intentName}, in _: Context) async -> Timeline<VoltraClientWidgetEntry> {
-        let entry = await VoltraClientWidgetProvider.loadEntry(widgetId: widgetId, configuration: ${configuredDict})
-        return Timeline(entries: [entry], policy: .never)
+      func timeline(for configuration: ${intentName}, in context: Context) async -> Timeline<VoltraClientWidgetEntry> {
+    ${appIntentTimelineBody}
       }
     }
 
@@ -422,7 +459,7 @@ function generateClientAppIntentWidgetCode(widget: DetectedIOSWidget): string {
 
       public var body: some WidgetConfiguration {
         AppIntentConfiguration(
-          kind: "Voltra_Widget_${widget.id}",
+          kind: "${widgetKind(widget)}",
           intent: ${intentName}.self,
           provider: ${providerName}()
         ) { entry in
@@ -443,7 +480,10 @@ function generateClientAppIntentWidgetCode(widget: DetectedIOSWidget): string {
 /**
  * Generates the VoltraWidgetBundle.swift file content with configured widgets
  */
-function generateWidgetBundleSwift(widgets: DetectedIOSWidget[]): string {
+function generateWidgetBundleSwift(
+  widgets: DetectedIOSWidget[],
+  liveActivities: IOSDynamicLiveActivityConfig[] = []
+): string {
   // Generate widget structs
   const widgetStructs = widgets.map((w) => generateWidgetStruct(w)).join('\n\n')
 
@@ -457,7 +497,12 @@ function generateWidgetBundleSwift(widgets: DetectedIOSWidget[]): string {
           .map((w) => `VoltraWidget_${w.id}()`)
           .join('\n      ')}\n    }`
       : ''
-  const widgetInstances = [plainInstances, appIntentInstances].filter(Boolean).join('\n    ')
+  const dynamicLiveActivityInstances = generateDynamicLiveActivityWidgetInstances(liveActivities)
+  const widgetInstances = [plainInstances, appIntentInstances, dynamicLiveActivityInstances]
+    .filter(Boolean)
+    .join('\n    ')
+  const widgetSectionTitle =
+    liveActivities.length > 0 ? 'Home Screen Widgets and Dynamic Live Activities' : 'Home Screen Widgets'
 
   const needsFoundation = widgets.some(widgetUsesGalleryLocalization)
   const foundationImport = needsFoundation ? 'import Foundation\n' : ''
@@ -473,7 +518,7 @@ function generateWidgetBundleSwift(widgets: DetectedIOSWidget[]): string {
 
     ${foundationImport}${appIntentsImport}import SwiftUI
     import WidgetKit
-    import VoltraWidget
+    import VoltraRuntime
 
     @main
     struct VoltraWidgetBundle: WidgetBundle {
@@ -481,7 +526,7 @@ function generateWidgetBundleSwift(widgets: DetectedIOSWidget[]): string {
         // Live Activity (with Watch/CarPlay support)
         VoltraWidget()
 
-        // Home Screen Widgets
+        // ${widgetSectionTitle}
         ${widgetInstances}
       }
     }
@@ -493,8 +538,8 @@ function generateWidgetBundleSwift(widgets: DetectedIOSWidget[]): string {
 }
 
 /**
- * Generates the VoltraWidgetBundle.swift file content when no widgets are configured
- * (only Live Activities)
+ * Generates the VoltraWidgetBundle.swift file content when no Home Screen widgets or Dynamic
+ * Live Activities are configured. Keep this legacy output stable for existing projects.
  */
 function generateDefaultWidgetBundleSwift(): string {
   return dedent`
@@ -507,7 +552,7 @@ function generateDefaultWidgetBundleSwift(): string {
 
     import SwiftUI
     import WidgetKit
-    import VoltraWidget  // Import Voltra widgets
+    import VoltraRuntime  // Import Voltra widgets
 
     @main
     struct VoltraWidgetBundle: WidgetBundle {
@@ -624,4 +669,6 @@ function getSwiftRawStringDelimiter(str: string): string {
 export const __test__ = {
   generateInitialStatesSwift,
   generateWidgetBundleSwift,
+  generateDynamicLiveActivityTypesSwift,
+  generateDynamicLiveActivitiesSwift,
 }