voltra 2.0.0 → 2.1.1

package/build/cjs/platforms/android/gradle.js

@@ -0,0 +1,120 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureAndroidGradleWidgetBundling = ensureAndroidGradleWidgetBundling;
+exports.addDynamicWidgetBundlingSnippet = addDynamicWidgetBundlingSnippet;
+exports.removeDynamicWidgetBundlingSnippet = removeDynamicWidgetBundlingSnippet;
+const node_path_1 = __importDefault(require("node:path"));
+const path_1 = require("../../fs/path");
+const readWrite_1 = require("../../fs/readWrite");
+const MARKER = '// @voltra-widget-bundling';
+const END_MARKER = '// @voltra-widget-bundling-end';
+async function ensureAndroidGradleWidgetBundling(options) {
+    const { projectRoot, discovery, hasDynamicWidgets } = options;
+    const isKotlinDsl = discovery.buildGradlePath.endsWith('.kts');
+    const projectRootRelativeToAppModule = (0, path_1.normalizeRelativePath)(node_path_1.default.relative(discovery.appModuleRoot, projectRoot)) || '.';
+    if (isKotlinDsl) {
+        if (!hasDynamicWidgets) {
+            return {};
+        }
+        return {
+            warnings: ['Voltra: app/build.gradle is not Groovy - skipping Dynamic Widget release bundling wiring.'],
+        };
+    }
+    const previousContent = await (0, readWrite_1.readTextFile)(discovery.buildGradlePath);
+    const removal = removeDynamicWidgetBundlingSnippet(previousContent, projectRootRelativeToAppModule);
+    const nextContent = hasDynamicWidgets
+        ? addDynamicWidgetBundlingSnippet(removal.contents, projectRootRelativeToAppModule)
+        : removal.contents;
+    if (nextContent === previousContent) {
+        return removal.warning ? { warnings: [removal.warning] } : {};
+    }
+    await (0, readWrite_1.writeTextFile)(discovery.buildGradlePath, nextContent);
+    return {
+        change: {
+            kind: 'updated',
+            path: (0, path_1.toRelativePath)(projectRoot, discovery.buildGradlePath),
+        },
+        warnings: removal.warning ? [removal.warning] : undefined,
+    };
+}
+function addDynamicWidgetBundlingSnippet(contents, projectRootRelativeToAppModule) {
+    if (contents.includes(MARKER)) {
+        return contents;
+    }
+    return `${contents.trimEnd()}\n\n${createDynamicWidgetBundlingSnippet(projectRootRelativeToAppModule)}\n`;
+}
+function removeDynamicWidgetBundlingSnippet(contents, projectRootRelativeToAppModule) {
+    const range = findManagedSnippetRange(contents);
+    if (range) {
+        return {
+            contents: collapseRemovedRange(contents, range.start, range.end),
+        };
+    }
+    const legacySnippet = createLegacyDynamicWidgetBundlingSnippet(projectRootRelativeToAppModule);
+    const legacyIndex = contents.indexOf(legacySnippet);
+    if (legacyIndex >= 0) {
+        return {
+            contents: collapseRemovedRange(contents, legacyIndex, legacyIndex + legacySnippet.length),
+        };
+    }
+    if (!contents.includes(MARKER)) {
+        return { contents };
+    }
+    return {
+        contents,
+        warning: 'Voltra: found legacy Dynamic Widget Gradle marker without managed end marker. Preserved trailing Gradle content; remove old @voltra-widget-bundling block manually if no longer needed.',
+    };
+}
+function createDynamicWidgetBundlingSnippet(projectRootRelativeToAppModule) {
+    return `
+${MARKER}
+def voltraProjectRoot = file("${projectRootRelativeToAppModule}")
+def voltraWidgetAssetsDir = file("\${buildDir}/generated/voltra/assets")
+android.sourceSets.getByName("main").assets.srcDir(voltraWidgetAssetsDir)
+
+def voltraBundleWidgets = tasks.register("voltraBundleWidgets", Exec) {
+    description = "Bake Dynamic Widget Voltra bundles into assets (release)."
+    workingDir voltraProjectRoot
+    environment "VOLTRA_PROJECT_ROOT", voltraProjectRoot.absolutePath
+    environment "VOLTRA_OUT_DIR", new File(voltraWidgetAssetsDir, "voltra").absolutePath
+    environment "VOLTRA_BUNDLER_RESOLVER", "const m=require('module'),p=require('path');process.stdout.write(m.createRequire(p.join(process.argv[1],'package.json')).resolve('@use-voltra/metro/bundle-widgets'))"
+    commandLine "bash", "-c", 'BUNDLER="$(node -e "$VOLTRA_BUNDLER_RESOLVER" "$VOLTRA_PROJECT_ROOT")"; if [ -z "$BUNDLER" ]; then echo "error: Voltra could not resolve @use-voltra/metro/bundle-widgets from $VOLTRA_PROJECT_ROOT - install @use-voltra/metro so release widgets can be baked." >&2; exit 1; fi; node "$BUNDLER" --platform android --out-dir "$VOLTRA_OUT_DIR" --project-root "$VOLTRA_PROJECT_ROOT"'
+    outputs.upToDateWhen { false }
+}
+
+android.applicationVariants.all { variant ->
+    if (variant.buildType.name == "release") {
+        tasks.named("merge\${variant.name.capitalize()}Assets").configure { dependsOn voltraBundleWidgets }
+    }
+}
+${END_MARKER}
+`.trim();
+}
+function createLegacyDynamicWidgetBundlingSnippet(projectRootRelativeToAppModule) {
+    return createDynamicWidgetBundlingSnippet(projectRootRelativeToAppModule).replace(`\n${END_MARKER}`, '');
+}
+function findManagedSnippetRange(contents) {
+    const markerIndex = contents.indexOf(MARKER);
+    if (markerIndex < 0) {
+        return null;
+    }
+    const endMarkerIndex = contents.indexOf(END_MARKER, markerIndex);
+    if (endMarkerIndex < 0) {
+        return null;
+    }
+    const lineEndIndex = contents.indexOf('\n', endMarkerIndex);
+    return {
+        start: markerIndex,
+        end: lineEndIndex >= 0 ? lineEndIndex + 1 : contents.length,
+    };
+}
+function collapseRemovedRange(contents, start, end) {
+    const before = contents.slice(0, start).trimEnd();
+    const after = contents.slice(end).replace(/^\s+/, '');
+    const merged = [before, after].filter(Boolean).join('\n\n');
+    return merged ? `${merged}\n` : '';
+}
+//# sourceMappingURL=gradle.js.map

package/build/cjs/platforms/android/gradle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradle.js","sourceRoot":"","sources":["../../../../src/platforms/android/gradle.ts"],"names":[],"mappings":"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"}

package/build/cjs/platforms/ios/generated.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -41,21 +8,20 @@ exports.generateIOSFiles = generateIOSFiles;
 const node_fs_1 = __importDefault(require("node:fs"));
 const promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
-const node_vm_1 = __importDefault(require("node:vm"));
 const node_module_1 = require("node:module");
-const babel = __importStar(require("@babel/core"));
 const platformPackages_1 = require("../../dependencies/platformPackages");
 const readWrite_1 = require("../../fs/readWrite");
 const path_1 = require("../../fs/path");
 const summary_1 = require("../../reporting/summary");
+const widgetModule_1 = require("../shared/widgetModule");
 const plist_1 = require("./plist");
 const targetName_1 = require("./targetName");
-const MODULE_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', ''];
 const VALID_IMAGE_EXTENSIONS = new Set(['.png', '.jpg', '.jpeg']);
 const FONT_EXTENSIONS = new Set(['.ttf', '.otf', '.woff', '.woff2']);
 const MAX_IMAGE_SIZE_BYTES = 4096;
 const DEFAULT_INITIAL_STATE_LOCALE = '__default';
 const VOLTRA_WIDGET_STRINGS_BASENAME = 'VoltraWidgets.strings';
+const IOS_DYNAMIC_WIDGET_MANIFEST_PATH = node_path_1.default.join('.voltra', 'manifest.ios.json');
 const IOS_WIDGET_FAMILY_MAP = {
     systemSmall: '.systemSmall',
     systemMedium: '.systemMedium',
@@ -137,11 +103,13 @@ async function generateIOSFiles(options) {
     const { projectRoot, ios, discovery } = options;
     const targetName = (0, targetName_1.resolveIOSWidgetTargetName)(ios, discovery);
     const targetPath = node_path_1.default.join(discovery.iosRoot, targetName);
+    const detectedWidgets = detectClientRenderedWidgets(projectRoot, ios.widgets);
     const mainAppMetadata = await readMainAppMetadata(discovery.infoPlistPath);
     const changes = [];
     const warnings = [];
     const generatedFiles = new Set();
-    const infoPlistResult = await generateInfoPlistFile(projectRoot, targetPath, targetName, ios, mainAppMetadata);
+    mergeSingleResult(await writeGeneratedTextFile(projectRoot, node_path_1.default.join(projectRoot, IOS_DYNAMIC_WIDGET_MANIFEST_PATH), `${JSON.stringify(createDynamicWidgetsManifest(detectedWidgets), null, 2)}\n`), changes, generatedFiles);
+    const infoPlistResult = await generateInfoPlistFile(projectRoot, targetPath, targetName, ios, mainAppMetadata, detectedWidgets);
     mergeSingleResult(infoPlistResult, changes, generatedFiles);
     const entitlementsResult = await generateEntitlementsFile(projectRoot, targetPath, targetName, ios);
     mergeSingleResult(entitlementsResult, changes, generatedFiles);
@@ -149,11 +117,11 @@ async function generateIOSFiles(options) {
     mergeResult(assetResult, changes, warnings, generatedFiles);
     const fontsResult = await copyIOSFonts(projectRoot, targetPath, ios.fonts);
     mergeResult(fontsResult, changes, warnings, generatedFiles);
-    const initialStatesResult = await generateInitialStatesSwift(projectRoot, ios.widgets);
+    const initialStatesResult = await generateInitialStatesSwift(projectRoot, detectedWidgets);
     mergeSingleResult(await writeGeneratedTextFile(projectRoot, node_path_1.default.join(targetPath, 'VoltraWidgetInitialStates.swift'), initialStatesResult), changes, generatedFiles);
-    const widgetBundleResult = await writeGeneratedTextFile(projectRoot, node_path_1.default.join(targetPath, 'VoltraWidgetBundle.swift'), generateWidgetBundleSwift(ios.widgets));
+    const widgetBundleResult = await writeGeneratedTextFile(projectRoot, node_path_1.default.join(targetPath, 'VoltraWidgetBundle.swift'), generateWidgetBundleSwift(detectedWidgets));
     mergeSingleResult(widgetBundleResult, changes, generatedFiles);
-    const localizedStringResults = await generateLocalizedWidgetStrings(projectRoot, targetPath, ios.widgets);
+    const localizedStringResults = await generateLocalizedWidgetStrings(projectRoot, targetPath, detectedWidgets);
     mergeResult(localizedStringResults, changes, warnings, generatedFiles);
     return {
         changes,
@@ -163,10 +131,11 @@ async function generateIOSFiles(options) {
         targetPath,
     };
 }
-async function generateInfoPlistFile(projectRoot, targetPath, targetName, ios, mainAppMetadata) {
+async function generateInfoPlistFile(projectRoot, targetPath, targetName, ios, mainAppMetadata, widgets) {
     const plistPath = node_path_1.default.join(targetPath, 'Info.plist');
     const fontNames = ios.fonts.map((fontPath) => node_path_1.default.basename(fontPath)).sort();
-    const serverWidgets = ios.widgets.filter((widget) => widget.serverUpdate);
+    const serverWidgets = widgets.filter((widget) => widget.serverUpdate);
+    const hasClientRenderedWidget = widgets.some((widget) => widget.clientRendered);
     const serverUrls = Object.fromEntries(serverWidgets.map((widget) => [widget.id, widget.serverUpdate?.url]));
     const serverIntervals = Object.fromEntries(serverWidgets.map((widget) => [widget.id, widget.serverUpdate?.intervalMinutes]));
     const serverRefresh = Object.fromEntries(serverWidgets.map((widget) => [widget.id, widget.serverUpdate?.refresh ?? false]));
@@ -190,16 +159,30 @@ async function generateInfoPlistFile(projectRoot, targetPath, targetName, ios, m
         Voltra_KeychainGroup: ios.keychainGroup,
         Voltra_WidgetServerIntervals: Object.keys(serverIntervals).length > 0 ? serverIntervals : undefined,
         Voltra_WidgetServerRefresh: Object.keys(serverRefresh).length > 0 ? serverRefresh : undefined,
-        NSAppTransportSecurity: serverWidgets.length > 0
-            ? {
-                NSAllowsLocalNetworking: true,
-                NSAllowsArbitraryLoads: false,
-            }
-            : undefined,
+        NSAppTransportSecurity: createWidgetAppTransportSecurity(hasClientRenderedWidget, serverWidgets.length > 0),
         Voltra_WidgetServerUrls: Object.keys(serverUrls).length > 0 ? serverUrls : undefined,
     }, createGeneratedFilesError);
     return writeGeneratedTextFile(projectRoot, plistPath, infoPlist);
 }
+function createWidgetAppTransportSecurity(hasClientRenderedWidget, hasServerWidgets) {
+    if (!hasClientRenderedWidget && !hasServerWidgets) {
+        return undefined;
+    }
+    return {
+        NSAllowsLocalNetworking: true,
+        ...(hasClientRenderedWidget
+            ? {
+                NSExceptionDomains: {
+                    localhost: {
+                        NSExceptionAllowsInsecureHTTPLoads: true,
+                        NSIncludesSubdomains: true,
+                    },
+                },
+            }
+            : {}),
+        ...(hasServerWidgets ? { NSAllowsArbitraryLoads: false } : {}),
+    };
+}
 async function generateEntitlementsFile(projectRoot, targetPath, targetName, ios) {
     const entitlementsPath = node_path_1.default.join(targetPath, `${targetName}.entitlements`);
     const entitlements = (0, plist_1.buildPlistXml)({
@@ -294,8 +277,12 @@ async function readMainAppMetadata(infoPlistPath) {
     };
 }
 async function generateInitialStatesSwift(projectRoot, widgets) {
-    const prerenderableWidgets = widgets.filter((widget) => widget.initialStatePath);
-    if (prerenderableWidgets.length === 0) {
+    const serverWidgets = widgets.filter((widget) => !widget.clientRendered);
+    const prerenderableServerWidgets = serverWidgets.filter((widget) => widget.initialStatePath);
+    const serverStates = await prerenderWidgetStates(projectRoot, prerenderableServerWidgets, loadIOSWidgetRenderer(projectRoot));
+    const clientStates = await prerenderClientRenderedWidgets(projectRoot, widgets);
+    const prerenderedStates = new Map([...serverStates, ...clientStates]);
+    if (prerenderedStates.size === 0) {
         return [
             '//',
             '//  VoltraWidgetInitialStates.swift',
@@ -314,7 +301,6 @@ async function generateInitialStatesSwift(projectRoot, widgets) {
             '',
         ].join('\n');
     }
-    const prerenderedStates = await prerenderWidgetStates(projectRoot, prerenderableWidgets, loadIOSWidgetRenderer(projectRoot));
     const widgetEntries = [...prerenderedStates.entries()]
         .map(([widgetId, localeMap]) => {
         const localeEntries = [...localeMap.entries()]
@@ -357,8 +343,10 @@ async function generateInitialStatesSwift(projectRoot, widgets) {
 }
 function generateWidgetBundleSwift(widgets) {
     const needsFoundation = widgets.some((widget) => isWidgetLocalizedMap(widget.displayName) || isWidgetLocalizedMap(widget.description));
+    const appIntentWidgets = widgets.filter(widgetUsesAppIntent);
     const imports = [
         needsFoundation ? 'import Foundation' : undefined,
+        appIntentWidgets.length > 0 ? 'import AppIntents' : undefined,
         'import SwiftUI',
         'import WidgetKit',
         'import VoltraWidget',
@@ -385,7 +373,14 @@ function generateWidgetBundleSwift(widgets) {
         ].join('\n');
     }
     const widgetStructs = widgets.map(generateWidgetStruct).join('\n\n');
-    const widgetInstances = widgets.map((widget) => `    VoltraWidget_${widget.id}()`).join('\n');
+    const plainWidgets = widgets.filter((widget) => !widgetUsesAppIntent(widget));
+    const plainInstances = plainWidgets.map((widget) => `    VoltraWidget_${widget.id}()`).join('\n');
+    const appIntentInstances = appIntentWidgets.length > 0
+        ? `    if #available(iOS 17.0, *) {\n${appIntentWidgets
+            .map((widget) => `      VoltraWidget_${widget.id}()`)
+            .join('\n')}\n    }`
+        : '';
+    const widgetInstances = [plainInstances, appIntentInstances].filter(Boolean).join('\n');
     return [
         '//',
         '//  VoltraWidgetBundle.swift',
@@ -408,9 +403,32 @@ function generateWidgetBundleSwift(widgets) {
     ].join('\n');
 }
 function generateWidgetStruct(widget) {
+    if (widgetUsesAppIntent(widget)) {
+        return generateClientAppIntentWidgetCode(widget);
+    }
     const familiesSwift = widget.supportedFamilies.map((family) => IOS_WIDGET_FAMILY_MAP[family]).join(', ');
     const displayNameExpr = createSwiftLabelExpression(widget.id, 'displayName', widget.displayName);
     const descriptionExpr = createSwiftLabelExpression(widget.id, 'description', widget.description);
+    const providerAndContent = widget.clientRendered
+        ? [
+            '      provider: VoltraClientWidgetProvider(',
+            '        widgetId: widgetId,',
+            '        initialState: VoltraWidgetInitialStates.getInitialState(for: widgetId)',
+            '      )',
+            '    ) { entry in',
+            '      VoltraClientWidgetContentView(',
+            '        entry: entry,',
+            '        initialState: VoltraWidgetInitialStates.getInitialState(for: widgetId)',
+            '      )',
+        ].join('\n')
+        : [
+            '      provider: VoltraHomeWidgetProvider(',
+            '        widgetId: widgetId,',
+            '        initialState: VoltraWidgetInitialStates.getInitialState(for: widgetId)',
+            '      )',
+            '    ) { entry in',
+            '      VoltraHomeWidgetView(entry: entry)',
+        ].join('\n');
     return [
         `public struct VoltraWidget_${widget.id}: Widget {`,
         `  private let widgetId = ${JSON.stringify(widget.id)}`,
@@ -420,12 +438,85 @@ function generateWidgetStruct(widget) {
         '  public var body: some WidgetConfiguration {',
         '    StaticConfiguration(',
         `      kind: ${JSON.stringify(`Voltra_Widget_${widget.id}`)},`,
-        '      provider: VoltraHomeWidgetProvider(',
-        '        widgetId: widgetId,',
+        providerAndContent,
+        '    }',
+        `    .configurationDisplayName(${displayNameExpr})`,
+        `    .description(${descriptionExpr})`,
+        `    .supportedFamilies([${familiesSwift}])`,
+        '    .contentMarginsDisabled()',
+        '  }',
+        '}',
+    ].join('\n');
+}
+function widgetUsesAppIntent(widget) {
+    return widget.clientRendered && !!widget.appIntent && widget.appIntent.parameters.length > 0;
+}
+function generateClientAppIntentWidgetCode(widget) {
+    const familiesSwift = widget.supportedFamilies.map((family) => IOS_WIDGET_FAMILY_MAP[family]).join(', ');
+    const intentName = `VoltraWidget_${widget.id}_Intent`;
+    const providerName = `VoltraWidget_${widget.id}_ClientProvider`;
+    const intentTitle = `Configure ${widgetLabelEnglish(widget.displayName)}`;
+    const displayNameExpr = createSwiftLabelExpression(widget.id, 'displayName', widget.displayName);
+    const descriptionExpr = createSwiftLabelExpression(widget.id, 'description', widget.description);
+    const parameterDeclarations = widget.appIntent.parameters
+        .map((parameter) => `  @Parameter(title: ${JSON.stringify(parameter.title)}, default: ${swiftDefaultValue(parameter)})\n  var ${parameter.name}: String`)
+        .join('\n\n');
+    const initializerParameters = widget.appIntent.parameters.map((parameter) => `${parameter.name}: String`).join(', ');
+    const initializerAssignments = widget.appIntent.parameters
+        .map((parameter) => `    self.${parameter.name} = ${parameter.name}`)
+        .join('\n');
+    const configuredDictionary = createSwiftDictionaryLiteral(widget.appIntent.parameters.map((parameter) => `${JSON.stringify(parameter.name)}: configuration.${parameter.name}`));
+    const defaultDictionary = createSwiftDictionaryLiteral(widget.appIntent.parameters.map((parameter) => `${JSON.stringify(parameter.name)}: ${swiftDefaultValue(parameter)}`));
+    return [
+        `@available(iOS 17.0, *)`,
+        `struct ${intentName}: WidgetConfigurationIntent {`,
+        `  static var title: LocalizedStringResource = ${JSON.stringify(intentTitle)}`,
+        '',
+        parameterDeclarations,
+        '',
+        '  init() {}',
+        `  init(${initializerParameters}) {`,
+        initializerAssignments,
+        '  }',
+        '}',
+        '',
+        `@available(iOS 17.0, *)`,
+        `private struct ${providerName}: AppIntentTimelineProvider {`,
+        `  typealias Intent = ${intentName}`,
+        '  typealias Entry = VoltraClientWidgetEntry',
+        '',
+        `  private let widgetId = ${JSON.stringify(widget.id)}`,
+        '',
+        '  func placeholder(in _: Context) -> VoltraClientWidgetEntry {',
+        `    VoltraClientWidgetEntry(date: Date(), widgetId: widgetId, bundleReady: false, configuration: ${defaultDictionary})`,
+        '  }',
+        '',
+        `  func snapshot(for configuration: ${intentName}, in _: Context) async -> VoltraClientWidgetEntry {`,
+        `    await VoltraClientWidgetProvider.loadEntry(widgetId: widgetId, configuration: ${configuredDictionary})`,
+        '  }',
+        '',
+        `  func timeline(for configuration: ${intentName}, in _: Context) async -> Timeline<VoltraClientWidgetEntry> {`,
+        `    let entry = await VoltraClientWidgetProvider.loadEntry(widgetId: widgetId, configuration: ${configuredDictionary})`,
+        '    return Timeline(entries: [entry], policy: .never)',
+        '  }',
+        '}',
+        '',
+        `@available(iOS 17.0, *)`,
+        `public struct VoltraWidget_${widget.id}: Widget {`,
+        `  private let widgetId = ${JSON.stringify(widget.id)}`,
+        '',
+        '  public init() {}',
+        '',
+        '  public var body: some WidgetConfiguration {',
+        '    AppIntentConfiguration(',
+        `      kind: ${JSON.stringify(`Voltra_Widget_${widget.id}`)},`,
+        `      intent: ${intentName}.self,`,
+        `      provider: ${providerName}()`,
+        '    ) { entry in',
+        '      VoltraClientWidgetContentView(',
+        '        entry: entry,',
         '        initialState: VoltraWidgetInitialStates.getInitialState(for: widgetId)',
         '      )',
-        '    ) { entry in',
-        '      VoltraHomeWidgetView(entry: entry)',
         '    }',
         `    .configurationDisplayName(${displayNameExpr})`,
         `    .description(${descriptionExpr})`,
@@ -443,6 +534,12 @@ function createSwiftLabelExpression(widgetId, field, label) {
     const defaultEnglish = widgetLabelEnglish(label);
     return `Text(LocalizedStringResource(${JSON.stringify(key)}, defaultValue: String.LocalizationValue(${JSON.stringify(defaultEnglish)}), table: ${JSON.stringify('VoltraWidgets')}))`;
 }
+function swiftDefaultValue(parameter) {
+    return JSON.stringify(parameter.default ?? '');
+}
+function createSwiftDictionaryLiteral(entries) {
+    return entries.length > 0 ? `[${entries.join(', ')}]` : '[:]';
+}
 async function prerenderWidgetStates(projectRoot, widgets, renderer) {
     const prerenderedStates = new Map();
     for (const widget of widgets) {
@@ -456,47 +553,15 @@ async function prerenderWidgetStates(projectRoot, widgets, renderer) {
             if (!(await (0, readWrite_1.pathExists)(modulePath))) {
                 throw new IOSGeneratedFilesError(`Initial state file not found for widget '${widget.id}' at ${modulePath}`);
             }
-            const widgetVariants = evaluateWidgetModule(projectRoot, modulePath);
+            const widgetVariants = evaluateLegacyWidgetModule(projectRoot, modulePath);
             localeStates.set(localeKey, renderer(widgetVariants));
         }
         prerenderedStates.set(widget.id, localeStates);
     }
     return prerenderedStates;
 }
-function evaluateWidgetModule(projectRoot, filePath) {
-    const projectRequire = createProjectRequire(projectRoot);
-    const moduleCache = new Map();
-    const customRequire = (moduleSpecifier, currentDir) => {
-        if (!isLocalModule(moduleSpecifier)) {
-            return projectRequire(moduleSpecifier);
-        }
-        const resolvedModulePath = resolveModulePath(moduleSpecifier, currentDir);
-        if (!resolvedModulePath) {
-            throw new IOSGeneratedFilesError(`Cannot resolve module '${moduleSpecifier}' from '${currentDir}'`);
-        }
-        const cachedModule = moduleCache.get(resolvedModulePath);
-        if (cachedModule !== undefined) {
-            return cachedModule;
-        }
-        const transpiledCode = transpileWidgetModule(projectRoot, resolvedModulePath, projectRequire);
-        const moduleDir = node_path_1.default.dirname(resolvedModulePath);
-        const moduleRecord = { exports: {} };
-        moduleCache.set(resolvedModulePath, moduleRecord.exports);
-        const context = node_vm_1.default.createContext({
-            __dirname: moduleDir,
-            __filename: resolvedModulePath,
-            console,
-            exports: moduleRecord.exports,
-            module: moduleRecord,
-            process,
-            require: (specifier) => customRequire(specifier, moduleDir),
-        });
-        const script = new node_vm_1.default.Script(transpiledCode, { filename: resolvedModulePath });
-        script.runInContext(context);
-        moduleCache.set(resolvedModulePath, moduleRecord.exports);
-        return moduleRecord.exports;
-    };
-    const exports = customRequire(filePath, node_path_1.default.dirname(filePath));
+function evaluateLegacyWidgetModule(projectRoot, filePath) {
+    const exports = (0, widgetModule_1.evaluateWidgetModuleExports)(projectRoot, filePath, createGeneratedFilesError);
     const widgetVariants = exports.default ?? exports;
     if (!widgetVariants || typeof widgetVariants !== 'object') {
         throw new IOSGeneratedFilesError(`Widget file must export widget variants: ${filePath}`);
@@ -510,68 +575,107 @@ function loadIOSWidgetRenderer(projectRoot) {
     }
     return iosPackage.renderWidgetToString;
 }
-function transpileWidgetModule(projectRoot, filePath, projectRequire) {
-    const source = node_fs_1.default.readFileSync(filePath, 'utf8');
-    const projectBabelConfigPath = resolveProjectBabelConfig(projectRoot);
-    const result = babel.transformSync(source, {
-        babelrc: false,
-        configFile: projectBabelConfigPath,
-        cwd: projectRoot,
-        filename: filePath,
-        presets: projectBabelConfigPath ? undefined : [resolveFallbackBabelPreset(projectRequire)],
-    });
-    if (!result?.code) {
-        throw new IOSGeneratedFilesError(`Babel transpilation failed for ${filePath}`);
-    }
-    return result.code;
-}
-function resolveProjectBabelConfig(projectRoot) {
-    const candidates = ['babel.config.js', 'babel.config.cjs', 'babel.config.mjs'];
-    for (const candidate of candidates) {
-        const candidatePath = node_path_1.default.join(projectRoot, candidate);
-        if (node_fs_1.default.existsSync(candidatePath)) {
-            return candidatePath;
-        }
+function loadIOSDynamicWidgetRenderer(projectRoot) {
+    const iosPackage = (0, platformPackages_1.requirePlatformPackage)(projectRoot, 'ios');
+    if (typeof iosPackage.renderVoltraVariantToJson !== 'function') {
+        throw new IOSGeneratedFilesError('Installed @use-voltra/ios package does not export renderVoltraVariantToJson.');
     }
-    return undefined;
+    return iosPackage.renderVoltraVariantToJson;
 }
-function resolveFallbackBabelPreset(projectRequire) {
-    try {
-        return projectRequire.resolve('@react-native/babel-preset');
+function createDynamicWidgetsManifest(widgets) {
+    return {
+        version: 1,
+        platform: 'ios',
+        widgets: widgets
+            .filter((widget) => widget.clientRendered)
+            .map((widget) => ({
+            id: widget.id,
+            entry: widget.entry,
+        })),
+    };
+}
+function detectClientRenderedWidgets(projectRoot, widgets) {
+    return widgets.map((widget) => detectSingleWidget(projectRoot, widget));
+}
+function detectSingleWidget(projectRoot, widget) {
+    if (!widget.entry) {
+        return {
+            ...widget,
+            clientRendered: false,
+        };
     }
-    catch {
+    const clientSourcePath = node_path_1.default.join(projectRoot, widget.entry);
+    if (!node_fs_1.default.existsSync(clientSourcePath) || !node_fs_1.default.statSync(clientSourcePath).isFile()) {
+        throw createGeneratedFilesError(`[voltra] Dynamic Widget "${widget.id}" entry not found at ${widget.entry}`);
+    }
+    const widgetModule = safelyEvaluateDynamicWidget(projectRoot, widget.id, widget.entry, clientSourcePath);
+    const widgetFn = readDynamicWidgetExport(widget.id, widget.entry, widgetModule);
+    if (typeof widgetFn !== 'function') {
+        throw createGeneratedFilesError(`[voltra] Dynamic Widget "${widget.id}" at ${widget.entry} must default-export a function or component.`);
+    }
+    return {
+        ...widget,
+        entry: widget.entry,
+        clientRendered: true,
+        clientSourcePath,
+    };
+}
+async function prerenderClientRenderedWidgets(projectRoot, widgets) {
+    const clientWidgets = widgets.filter((widget) => widget.clientRendered);
+    if (clientWidgets.length === 0) {
+        return new Map();
+    }
+    const renderer = loadIOSDynamicWidgetRenderer(projectRoot);
+    const placeholderEnv = {
+        date: Date.now(),
+        widgetFamily: 'systemMedium',
+        colorScheme: 'light',
+        locale: 'en-US',
+        widgetRenderingMode: 'fullColor',
+        showsWidgetContainerBackground: true,
+        configuration: undefined,
+        build: widgetModule_1.DYNAMIC_WIDGET_BUILD_INFO,
+    };
+    const prerenderedStates = new Map();
+    for (const widget of clientWidgets) {
         try {
-            return projectRequire.resolve('babel-preset-expo');
+            const widgetModule = safelyEvaluateDynamicWidget(projectRoot, widget.id, widget.entry, widget.clientSourcePath);
+            const widgetFn = readDynamicWidgetExport(widget.id, widget.entry, widgetModule);
+            const element = widgetFn({}, placeholderEnv);
+            prerenderedStates.set(widget.id, new Map([[DEFAULT_INITIAL_STATE_LOCALE, JSON.stringify(renderer(element))]]));
         }
-        catch {
-            throw new IOSGeneratedFilesError('Could not resolve a Babel preset for iOS initial state generation. Add a project babel.config.js or install @react-native/babel-preset.');
+        catch (error) {
+            if (error instanceof IOSGeneratedFilesError) {
+                throw error;
+            }
+            throw createGeneratedFilesError(`[voltra] Dynamic Widget "${widget.id}" failed placeholder prerender at ${widget.entry}: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
+    return prerenderedStates;
 }
-function createProjectRequire(projectRoot) {
-    return (0, node_module_1.createRequire)(node_path_1.default.join(projectRoot, 'package.json'));
-}
-function isLocalModule(moduleSpecifier) {
-    return moduleSpecifier.startsWith('.') || moduleSpecifier.startsWith('/');
-}
-function resolveModulePath(moduleSpecifier, fromDir) {
-    const basePath = node_path_1.default.resolve(fromDir, moduleSpecifier);
-    for (const extension of MODULE_EXTENSIONS) {
-        const candidate = `${basePath}${extension}`;
-        if (node_fs_1.default.existsSync(candidate) && node_fs_1.default.statSync(candidate).isFile()) {
-            return candidate;
-        }
-    }
-    if (!node_fs_1.default.existsSync(basePath) || !node_fs_1.default.statSync(basePath).isDirectory()) {
-        return null;
+function safelyEvaluateDynamicWidget(projectRoot, widgetId, widgetEntry, clientSourcePath) {
+    try {
+        return (0, widgetModule_1.evaluateWidgetModuleExports)(projectRoot, clientSourcePath, createGeneratedFilesError);
     }
-    for (const extension of MODULE_EXTENSIONS) {
-        const indexCandidate = node_path_1.default.join(basePath, `index${extension}`);
-        if (node_fs_1.default.existsSync(indexCandidate) && node_fs_1.default.statSync(indexCandidate).isFile()) {
-            return indexCandidate;
+    catch (error) {
+        if (error instanceof IOSGeneratedFilesError) {
+            throw error;
         }
+        throw createGeneratedFilesError(`[voltra] Dynamic Widget "${widgetId}" failed to evaluate entry at ${widgetEntry}: ${error instanceof Error ? error.message : String(error)}`);
     }
-    return null;
+}
+function readDynamicWidgetExport(widgetId, widgetEntry, widgetModule) {
+    const exports = widgetModule && typeof widgetModule === 'object'
+        ? widgetModule
+        : { default: widgetModule };
+    const widgetFn = exports.default ?? widgetModule;
+    if (typeof widgetFn !== 'function') {
+        throw createGeneratedFilesError(`[voltra] Dynamic Widget "${widgetId}" at ${widgetEntry} must default-export a function or component.`);
+    }
+    return widgetFn;
+}
+function createProjectRequire(projectRoot) {
+    return (0, node_module_1.createRequire)(node_path_1.default.join(projectRoot, 'package.json'));
 }
 async function resolveFontPaths(projectRoot, fonts) {
     const projectRequire = createProjectRequire(projectRoot);