@use-voltra/ios-client 1.4.0 → 2.0.0-rc.1

package/expo-plugin/build/cjs/ios-widget/files/index.js

@@ -0,0 +1,92 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateWidgetExtensionFiles = void 0;
+const config_plugins_1 = require("@expo/config-plugins");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const assets_1 = require("./assets");
+const entitlements_1 = require("./entitlements");
+const infoPlist_1 = require("./infoPlist");
+const swift_1 = require("./swift");
+/**
+ * Plugin step that generates all widget extension files.
+ *
+ * This creates:
+ * - Info.plist (required extension manifest)
+ * - Assets.xcassets/ (asset catalog with user images)
+ * - VoltraWidgetBundle.swift (widget bundle definition)
+ * - VoltraWidgetInitialStates.swift (pre-rendered widget states)
+ * - {targetName}.entitlements (entitlements file)
+ *
+ * This should run before configureXcodeProject so the files exist when Xcode project is configured.
+ */
+const generateWidgetExtensionFiles = (config, props) => {
+    const { targetName, widgets, groupIdentifier, keychainGroup, version, buildNumber } = props;
+    return (0, config_plugins_1.withDangerousMod)(config, [
+        'ios',
+        async (config) => {
+            if (config.modRequest.introspect) {
+                return config;
+            }
+            const { platformProjectRoot, projectRoot } = config.modRequest;
+            const targetPath = path.join(platformProjectRoot, targetName);
+            // Ensure target directory exists
+            if (!fs.existsSync(targetPath)) {
+                fs.mkdirSync(targetPath, { recursive: true });
+            }
+            // Generate Info.plist
+            (0, infoPlist_1.generateInfoPlist)(targetPath, targetName, version, buildNumber);
+            // Generate Assets.xcassets and copy user images
+            (0, assets_1.generateAssets)({ targetPath });
+            // Generate Swift files (widget bundle, initial states)
+            await (0, swift_1.generateSwiftFiles)({
+                targetPath,
+                projectRoot,
+                widgets,
+            });
+            // Generate entitlements file (may be empty if no groupIdentifier or keychainGroup)
+            (0, entitlements_1.generateEntitlements)({
+                targetPath,
+                targetName,
+                groupIdentifier,
+                keychainGroup,
+            });
+            return config;
+        },
+    ]);
+};
+exports.generateWidgetExtensionFiles = generateWidgetExtensionFiles;
+//# sourceMappingURL=index.js.map

package/expo-plugin/build/cjs/ios-widget/files/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ios-widget/files/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yDAAqE;AACrE,uCAAwB;AACxB,2CAA4B;AAG5B,qCAAyC;AACzC,iDAAqD;AACrD,2CAA+C;AAC/C,mCAA4C;AAW5C;;;;;;;;;;;GAWG;AACI,MAAM,4BAA4B,GAAoD,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;IAC7G,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,KAAK,CAAA;IAE3F,OAAO,IAAA,iCAAgB,EAAC,MAAM,EAAE;QAC9B,KAAK;QACL,KAAK,EAAE,MAAM,EAAE,EAAE;YACf,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;gBACjC,OAAO,MAAM,CAAA;YACf,CAAC;YAED,MAAM,EAAE,mBAAmB,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,UAAU,CAAA;YAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAA;YAE7D,iCAAiC;YACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/B,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YAC/C,CAAC;YAED,sBAAsB;YACtB,IAAA,6BAAiB,EAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,CAAC,CAAA;YAE/D,gDAAgD;YAChD,IAAA,uBAAc,EAAC,EAAE,UAAU,EAAE,CAAC,CAAA;YAE9B,uDAAuD;YACvD,MAAM,IAAA,0BAAkB,EAAC;gBACvB,UAAU;gBACV,WAAW;gBACX,OAAO;aACR,CAAC,CAAA;YAEF,mFAAmF;YACnF,IAAA,mCAAoB,EAAC;gBACnB,UAAU;gBACV,UAAU;gBACV,eAAe;gBACf,aAAa;aACd,CAAC,CAAA;YAEF,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAC,CAAA;AACJ,CAAC,CAAA;AA1CY,QAAA,4BAA4B,gCA0CxC"}

package/expo-plugin/build/cjs/ios-widget/files/infoPlist.js

@@ -0,0 +1,91 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateInfoPlist = generateInfoPlist;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const expo_plugin_1 = require("@use-voltra/expo-plugin");
+/**
+ * Generates the Info.plist content for a WidgetKit extension.
+ *
+ * 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, version, buildNumber) {
+    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">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>$(DEVELOPMENT_LANGUAGE)</string>
+	<key>CFBundleDisplayName</key>
+	<string>${targetName}</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>$(PRODUCT_BUNDLE_PACKAGE_TYPE)</string>
+	<key>CFBundleShortVersionString</key>
+	<string>${version}</string>
+	<key>CFBundleVersion</key>
+	<string>${buildNumber}</string>
+	<key>NSExtension</key>
+	<dict>
+		<key>NSExtensionPointIdentifier</key>
+		<string>com.apple.widgetkit-extension</string>
+	</dict>
+</dict>
+</plist>
+`;
+}
+/**
+ * Generates the Info.plist file for the widget extension.
+ *
+ * @param targetPath - Path to the widget extension target directory
+ * @param targetName - The widget extension target name (used for CFBundleDisplayName)
+ * @param version - The app version (CFBundleShortVersionString)
+ * @param buildNumber - The build number (CFBundleVersion)
+ */
+function generateInfoPlist(targetPath, targetName, version, buildNumber) {
+    const infoPlistPath = path.join(targetPath, 'Info.plist');
+    fs.writeFileSync(infoPlistPath, generateInfoPlistContent(targetName, version, buildNumber));
+    expo_plugin_1.logger.info('Generated Info.plist');
+}
+//# sourceMappingURL=infoPlist.js.map

package/expo-plugin/build/cjs/ios-widget/files/infoPlist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infoPlist.js","sourceRoot":"","sources":["../../../../src/ios-widget/files/infoPlist.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoDA,8CAIC;AAxDD,uCAAwB;AACxB,2CAA4B;AAE5B,yDAAgD;AAEhD;;;;;GAKG;AACH,SAAS,wBAAwB,CAAC,UAAkB,EAAE,OAAe,EAAE,WAAmB;IACxF,OAAO;;;;;;;WAOE,UAAU;;;;;;;;;;;;WAYV,OAAO;;WAEP,WAAW;;;;;;;;CAQrB,CAAA;AACD,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAAC,UAAkB,EAAE,UAAkB,EAAE,OAAe,EAAE,WAAmB;IAC5G,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;IACzD,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,wBAAwB,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAA;IAC3F,oBAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;AACrC,CAAC"}

package/expo-plugin/build/cjs/ios-widget/files/swift.js

@@ -0,0 +1,443 @@
+"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 };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__test__ = void 0;
+exports.generateSwiftFiles = generateSwiftFiles;
+const dedent_1 = __importDefault(require("dedent"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const expo_plugin_1 = require("@use-voltra/expo-plugin");
+const constants_1 = require("../../constants");
+const fileDiscovery_1 = require("../../utils/fileDiscovery");
+// ============================================================================
+// Main Function
+// ============================================================================
+/**
+ * Generates all Swift files for the widget extension.
+ *
+ * This creates:
+ * - VoltraWidgetInitialStates.swift (pre-rendered widget states)
+ * - VoltraWidgetBundle.swift (widget bundle definition)
+ */
+async function generateSwiftFiles(options) {
+    const { targetPath, projectRoot, widgets } = options;
+    // Dynamic import keeps the plugin CommonJS-compatible while resolving the current package entry.
+    const serverModuleId = '@use-voltra/ios/server';
+    const { renderWidgetToString } = (await Promise.resolve(`${serverModuleId}`).then(s => __importStar(require(s))));
+    // Prerender widget initial states if any widgets have initialStatePath configured
+    const prerenderedStates = await (0, expo_plugin_1.prerenderWidgetState)(widgets || [], projectRoot, renderWidgetToString);
+    syncVoltraWidgetGalleryStrings(targetPath, widgets);
+    // Generate the initial states Swift file
+    const initialStatesContent = generateInitialStatesSwift(prerenderedStates);
+    const initialStatesPath = path.join(targetPath, 'VoltraWidgetInitialStates.swift');
+    fs.writeFileSync(initialStatesPath, initialStatesContent);
+    expo_plugin_1.logger.info(`Generated VoltraWidgetInitialStates.swift with ${prerenderedStates.size} widget(s) (localized initial states where configured)`);
+    // Generate the widget bundle Swift file
+    const widgetBundleContent = widgets && widgets.length > 0 ? generateWidgetBundleSwift(widgets) : generateDefaultWidgetBundleSwift();
+    const widgetBundlePath = path.join(targetPath, 'VoltraWidgetBundle.swift');
+    fs.writeFileSync(widgetBundlePath, widgetBundleContent);
+    expo_plugin_1.logger.info(`Generated VoltraWidgetBundle.swift with ${widgets?.length ?? 0} home screen widgets`);
+}
+const GENERATED_INITIAL_STATE_LOCALE_HELPER = (0, dedent_1.default) `
+  private enum VoltraGeneratedInitialStateLocale {
+    static func pickJson(from perLocale: [String: String], preferredLanguages: [String]) -> String? {
+      let entries = perLocale.filter { !$0.value.isEmpty }
+      if entries.isEmpty {
+        return nil
+      }
+
+      func normalize(_ tag: String) -> String {
+        tag.trimmingCharacters(in: .whitespacesAndNewlines)
+          .lowercased()
+          .replacingOccurrences(of: "_", with: "-")
+      }
+
+      var byNorm: [String: String] = [:]
+      for (k, v) in entries {
+        byNorm[normalize(k)] = v
+      }
+
+      for pref in preferredLanguages {
+        let n = normalize(pref)
+        if let direct = byNorm[n] {
+          return direct
+        }
+        let lang = n.split(separator: "-").first.map(String.init) ?? n
+        for (key, val) in entries {
+          let kn = normalize(key)
+          let keyLang = kn.split(separator: "-").first.map(String.init) ?? kn
+          if keyLang == lang {
+            return val
+          }
+        }
+      }
+
+      if let en = byNorm["en"] {
+        return en
+      }
+      if let englishFamily = entries.keys.sorted().first(where: {
+        let normalized = normalize($0)
+        return normalized == "en" || normalized.hasPrefix("en-")
+      }) {
+        return entries[englishFamily]
+      }
+      if let def = byNorm["__default"] {
+        return def
+      }
+
+      let sorted = entries.keys.sorted()
+      guard let firstKey = sorted.first else {
+        return nil
+      }
+      return entries[firstKey]
+    }
+
+    static func preferredLanguageTags() -> [String] {
+      Locale.preferredLanguages
+    }
+  }
+`;
+// ============================================================================
+// Widget gallery localization: *.lproj/VoltraWidgets.strings + LocalizedStringResource
+//
+// We use classic .strings tables (not .xcstrings): the `xcode` npm library assigns
+// unknown lastKnownFileType to .xcstrings, so Xcode may not treat them as string tables
+// and lookups fall back to English defaultValue.
+//
+// LocalizedStringResource is still appropriate for extensions (deferred resolution).
+// https://developer.apple.com/documentation/foundation/localizedstringresource
+// ============================================================================
+function escapeForSwiftStringLiteral(s) {
+    return s.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n').replace(/\r/g, '\\r');
+}
+function escapeDotStringsValue(s) {
+    return escapeForSwiftStringLiteral(s);
+}
+function collectGalleryStringsByLocale(widgets) {
+    const byLocale = new Map();
+    const add = (locale, key, value) => {
+        let bucket = byLocale.get(locale);
+        if (!bucket) {
+            bucket = {};
+            byLocale.set(locale, bucket);
+        }
+        bucket[key] = value;
+    };
+    for (const w of widgets) {
+        if ((0, expo_plugin_1.isWidgetLocalizedMap)(w.displayName)) {
+            const key = `voltra_widget_${w.id}_displayName`;
+            for (const [locale, val] of Object.entries(w.displayName)) {
+                if (typeof val === 'string' && val.trim()) {
+                    add(locale, key, val);
+                }
+            }
+        }
+        if ((0, expo_plugin_1.isWidgetLocalizedMap)(w.description)) {
+            const key = `voltra_widget_${w.id}_description`;
+            for (const [locale, val] of Object.entries(w.description)) {
+                if (typeof val === 'string' && val.trim()) {
+                    add(locale, key, val);
+                }
+            }
+        }
+    }
+    return byLocale;
+}
+function formatVoltraWidgetsStringsFile(entries) {
+    const sortedKeys = Object.keys(entries).sort();
+    const lines = sortedKeys.map((k) => `"${k}" = "${escapeDotStringsValue(entries[k])}";`);
+    return `/* Voltra widget gallery strings (auto-generated) */\n${lines.join('\n')}\n`;
+}
+/** Remove generated gallery strings and obsolete string catalog before rewriting. */
+function clearVoltraWidgetGalleryStringArtifacts(targetPath) {
+    const catalogPath = path.join(targetPath, 'VoltraWidgets.xcstrings');
+    if (fs.existsSync(catalogPath)) {
+        fs.unlinkSync(catalogPath);
+    }
+    if (!fs.existsSync(targetPath)) {
+        return;
+    }
+    for (const entry of fs.readdirSync(targetPath)) {
+        if (!entry.endsWith('.lproj')) {
+            continue;
+        }
+        const stringsPath = path.join(targetPath, entry, fileDiscovery_1.VOLTRA_WIDGET_STRINGS_BASENAME);
+        if (fs.existsSync(stringsPath)) {
+            fs.unlinkSync(stringsPath);
+        }
+        const dirPath = path.join(targetPath, entry);
+        try {
+            if (fs.existsSync(dirPath) && fs.readdirSync(dirPath).length === 0) {
+                fs.rmdirSync(dirPath);
+            }
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+/**
+ * Writes `<locale>.lproj/VoltraWidgets.strings` for locale-map gallery labels.
+ */
+function syncVoltraWidgetGalleryStrings(targetPath, widgets) {
+    const list = widgets ?? [];
+    clearVoltraWidgetGalleryStringArtifacts(targetPath);
+    if (list.length === 0) {
+        return;
+    }
+    const byLocale = collectGalleryStringsByLocale(list);
+    if (byLocale.size === 0) {
+        return;
+    }
+    for (const [locale, kv] of byLocale) {
+        const lproj = path.join(targetPath, `${locale}.lproj`);
+        fs.mkdirSync(lproj, { recursive: true });
+        fs.writeFileSync(path.join(lproj, fileDiscovery_1.VOLTRA_WIDGET_STRINGS_BASENAME), formatVoltraWidgetsStringsFile(kv), 'utf8');
+    }
+}
+function widgetUsesGalleryLocalization(widget) {
+    return (0, expo_plugin_1.isWidgetLocalizedMap)(widget.displayName) || (0, expo_plugin_1.isWidgetLocalizedMap)(widget.description);
+}
+/**
+ * Widget gallery title / description: deferred lookup via LocalizedStringResource when using a locale map
+ * (recommended for extensions); plain Text for single-string config.
+ */
+function iosWidgetGalleryLabelSwiftExpr(widgetId, field, label) {
+    if (!(0, expo_plugin_1.isWidgetLocalizedMap)(label)) {
+        return `Text("${escapeForSwiftStringLiteral(label)}")`;
+    }
+    const key = `voltra_widget_${widgetId}_${field}`;
+    const defaultEnglish = escapeForSwiftStringLiteral((0, expo_plugin_1.widgetLabelEnglish)(label));
+    return `Text(LocalizedStringResource("${key}", defaultValue: String.LocalizationValue("${defaultEnglish}"), table: "VoltraWidgets"))`;
+}
+/**
+ * Generates Swift code for a single widget struct
+ */
+function generateWidgetStruct(widget) {
+    const families = widget.supportedFamilies ?? constants_1.DEFAULT_WIDGET_FAMILIES;
+    const familiesSwift = families.map((f) => constants_1.WIDGET_FAMILY_MAP[f]).join(', ');
+    // Sanitize the widget id for use as a Swift identifier
+    const structName = `VoltraWidget_${widget.id}`;
+    const displayNameExpr = iosWidgetGalleryLabelSwiftExpr(widget.id, 'displayName', widget.displayName);
+    const descriptionExpr = iosWidgetGalleryLabelSwiftExpr(widget.id, 'description', widget.description);
+    return (0, dedent_1.default) `
+    public struct ${structName}: Widget {
+      private let widgetId = "${widget.id}"
+
+      public init() {}
+
+      public var body: some WidgetConfiguration {
+        StaticConfiguration(
+          kind: "Voltra_Widget_${widget.id}",
+          provider: VoltraHomeWidgetProvider(
+            widgetId: widgetId,
+            initialState: VoltraWidgetInitialStates.getInitialState(for: widgetId)
+          )
+        ) { entry in
+          VoltraHomeWidgetView(entry: entry)
+        }
+        .configurationDisplayName(${displayNameExpr})
+        .description(${descriptionExpr})
+        .supportedFamilies([${familiesSwift}])
+        .contentMarginsDisabled()
+      }
+    }
+  `;
+}
+/**
+ * Generates the VoltraWidgetBundle.swift file content with configured widgets
+ */
+function generateWidgetBundleSwift(widgets) {
+    // Generate widget structs
+    const widgetStructs = widgets.map(generateWidgetStruct).join('\n\n');
+    // Generate widget bundle body entries
+    const widgetInstances = widgets.map((w) => `VoltraWidget_${w.id}()`).join('\n    ');
+    const needsFoundation = widgets.some(widgetUsesGalleryLocalization);
+    const foundationImport = needsFoundation ? 'import Foundation\n' : '';
+    return (0, dedent_1.default) `
+    //
+    //  VoltraWidgetBundle.swift
+    //
+    //  Auto-generated by Voltra config plugin.
+    //  This file defines which Voltra widgets are available in your app.
+    //
+
+    ${foundationImport}import SwiftUI
+    import WidgetKit
+    import VoltraWidget
+
+    @main
+    struct VoltraWidgetBundle: WidgetBundle {
+      var body: some Widget {
+        // Live Activity (with Watch/CarPlay support)
+        VoltraWidget()
+
+        // Home Screen Widgets
+        ${widgetInstances}
+      }
+    }
+
+    // MARK: - Home Screen Widget Definitions
+
+    ${widgetStructs}
+  `;
+}
+/**
+ * Generates the VoltraWidgetBundle.swift file content when no widgets are configured
+ * (only Live Activities)
+ */
+function generateDefaultWidgetBundleSwift() {
+    return (0, dedent_1.default) `
+    //
+    //  VoltraWidgetBundle.swift
+    //
+    //  This file defines which Voltra widgets are available in your app.
+    //  You can customize which widgets to include by adding or removing them below.
+    //
+
+    import SwiftUI
+    import WidgetKit
+    import VoltraWidget  // Import Voltra widgets
+
+    @main
+    struct VoltraWidgetBundle: WidgetBundle {
+      var body: some Widget {
+        // Live Activity (with Watch/CarPlay support)
+        VoltraWidget()
+      }
+    }
+  `;
+}
+// ============================================================================
+// Initial States
+// ============================================================================
+/**
+ * Generates Swift code that bundles pre-rendered widget initial states (per locale when configured).
+ */
+function generateInitialStatesSwift(prerenderedStates) {
+    if (prerenderedStates.size === 0) {
+        return generateEmptyInitialStatesSwift();
+    }
+    const widgetEntries = Array.from(prerenderedStates.entries())
+        .map(([widgetId, perLocale]) => {
+        const localeEntries = Array.from(perLocale.entries())
+            .map(([localeKey, json]) => {
+            const delimiter = getSwiftRawStringDelimiter(json);
+            return `"${escapeForSwiftStringLiteral(localeKey)}": ${delimiter}"${json}"${delimiter}`;
+        })
+            .join(',\n        ');
+        return `"${widgetId}": [\n        ${localeEntries}\n      ]`;
+    })
+        .join(',\n    ');
+    return (0, dedent_1.default) `
+    //
+    //  VoltraWidgetInitialStates.swift
+    //
+    //  Auto-generated by Voltra config plugin.
+    //  Contains pre-rendered initial states for home screen widgets.
+    //
+
+    import Foundation
+
+    ${GENERATED_INITIAL_STATE_LOCALE_HELPER}
+
+    public enum VoltraWidgetInitialStates {
+      private static let bundledLocalizedStates: [String: [String: String]] = [
+        ${widgetEntries}
+      ]
+
+      /// Get the bundled initial state JSON for a widget, matching the device locale when multiple locales were built.
+      /// Returns nil if no initial state was configured for the widget.
+      public static func getInitialState(for widgetId: String) -> Data? {
+        guard let perLocale = bundledLocalizedStates[widgetId] else { return nil }
+        let tags = VoltraGeneratedInitialStateLocale.preferredLanguageTags()
+        guard let jsonString = VoltraGeneratedInitialStateLocale.pickJson(from: perLocale, preferredLanguages: tags) else {
+          return nil
+        }
+        return jsonString.data(using: .utf8)
+      }
+    }
+  `;
+}
+/**
+ * Generates empty Swift code when no widgets have initial states configured.
+ */
+function generateEmptyInitialStatesSwift() {
+    return (0, dedent_1.default) `
+    //
+    //  VoltraWidgetInitialStates.swift
+    //
+    //  Auto-generated by Voltra config plugin.
+    //  No widget initial states configured.
+    //
+
+    import Foundation
+
+    public enum VoltraWidgetInitialStates {
+      /// Get the bundled initial state JSON for a widget.
+      /// Always returns nil since no initial states are configured.
+      public static func getInitialState(for widgetId: String) -> Data? {
+        return nil
+      }
+    }
+  `;
+}
+/**
+ * Determines the appropriate Swift raw string delimiter for a given string.
+ * Counts the maximum consecutive '#' characters after a '"' in the content
+ * and returns a delimiter with one more '#' than that maximum.
+ *
+ * For example:
+ * - Content has no '"#' → returns '#'
+ * - Content has '"#' (1 hash) → returns '##'
+ * - Content has '"##' (2 hashes) → returns '###'
+ */
+function getSwiftRawStringDelimiter(str) {
+    // Find all sequences of '#' that follow a '"'
+    const matches = str.match(/"#+/g);
+    if (!matches) {
+        return '#';
+    }
+    // Find the maximum number of consecutive '#' after a '"'
+    const maxHashes = Math.max(...matches.map((m) => m.length - 1)); // -1 to exclude the '"'
+    return '#'.repeat(maxHashes + 1);
+}
+exports.__test__ = {
+    generateInitialStatesSwift,
+};
+//# sourceMappingURL=swift.js.map

package/expo-plugin/build/cjs/ios-widget/files/swift.js.map

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