@use-voltra/ios-client 2.1.1 → 2.3.0

package/expo-plugin/build/types/ios-widget/xcode/buildPhases.d.ts

@@ -4,25 +4,23 @@ import type { IOSWidgetExtensionFiles } from '../../types';
  * 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 declare function ensureWidgetBundleScriptPhase(xcodeProject: XcodeProject, targetUuid: string): void;
-export interface AddBuildPhasesOptions {
+export declare function ensureWidgetBundleScriptPhase(xcodeProject: XcodeProject, targetUuid: string, content?: 'all' | 'live-activities'): void;
+export interface EnsureBuildPhasesOptions {
     targetUuid: string;
+    targetName: string;
     groupName: string;
     productFile: {
         uuid: string;
+        fileRef?: string;
         target?: string;
         basename: string;
         group: string;
     };
     widgetFiles: IOSWidgetExtensionFiles;
-}
-export interface EnsureBuildPhasesOptions extends AddBuildPhasesOptions {
     mainTargetUuid?: string;
+    /** Generated ActivityKit types compiled into both the extension and the app. */
+    mainSwiftFiles?: string[];
 }
-/**
- * Adds all required build phases for the widget extension target.
- */
-export declare function addBuildPhases(xcodeProject: XcodeProject, options: AddBuildPhasesOptions): void;
 /**
  * Ensures all required build phases and files exist for the widget extension target.
  */

package/expo-plugin/build/types/ios-widget/xcode/buildPhases.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildPhases.d.ts","sourceRoot":"","sources":["../../../../src/ios-widget/xcode/buildPhases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAyD1D;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAkClG;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;IACD,WAAW,EAAE,uBAAuB,CAAA;CACrC;AAED,MAAM,WAAW,wBAAyB,SAAQ,qBAAqB;IACrE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAuC/F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAuDrG"}
+{"version":3,"file":"buildPhases.d.ts","sourceRoot":"","sources":["../../../../src/ios-widget/xcode/buildPhases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAkE1D;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,KAAK,GAAG,iBAAyB,GACzC,IAAI,CAwDN;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;IACD,WAAW,EAAE,uBAAuB,CAAA;IACpC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;AAqDD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,wBAAwB,GAAG,IAAI,CA4DrG"}

package/expo-plugin/build/types/ios-widget/xcode/configurationList.d.ts

@@ -1,20 +1,25 @@
 import { XcodeProject } from '@expo/config-plugins';
-export interface AddConfigurationListOptions {
+import type { MainAppTargetSettings } from './mainAppSettings';
+export interface EnsureConfigurationListOptions {
     targetName: string;
     bundleIdentifier: string;
     deploymentTarget: string;
-    codeSignStyle?: string;
-    developmentTeam?: string;
-    provisioningProfileSpecifier?: string;
+    /**
+     * App marketing version (CFBundleShortVersionString). App Store Connect expects the appex
+     * version to match the app's, so this becomes the widget's MARKETING_VERSION.
+     */
+    version?: string;
+    /** App build number; becomes the widget's CURRENT_PROJECT_VERSION. */
+    buildNumber?: string;
+    /** Main app signing settings, applied per configuration name (Debug→Debug, Release→Release). */
+    mainAppSettings?: MainAppTargetSettings | null;
 }
 /**
- * Adds the XCConfigurationList for the widget extension target.
+ * Ensures an existing XCConfigurationList is updated, or adds a new one if missing. Each widget
+ * configuration receives the build settings derived for its own name, so Debug and Release signing
+ * stay in sync with the main app's respective configurations.
  */
-export declare function addXCConfigurationList(xcodeProject: XcodeProject, options: AddConfigurationListOptions): any;
-/**
- * Ensures an existing XCConfigurationList is updated, or adds a new one if missing.
- */
-export declare function ensureXCConfigurationList(xcodeProject: XcodeProject, options: AddConfigurationListOptions, existingConfigurationListId?: string | {
+export declare function ensureXCConfigurationList(xcodeProject: XcodeProject, options: EnsureConfigurationListOptions, existingConfigurationListId?: string | {
     value?: string;
 }): any;
 //# sourceMappingURL=configurationList.d.ts.map

package/expo-plugin/build/types/ios-widget/xcode/configurationList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configurationList.d.ts","sourceRoot":"","sources":["../../../../src/ios-widget/xcode/configurationList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAInD,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,4BAA4B,CAAC,EAAE,MAAM,CAAA;CACtC;AA0CD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,2BAA2B,OA4BtG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,2BAA2B,EACpC,2BAA2B,CAAC,EAAE,MAAM,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,OAkC1D"}
+{"version":3,"file":"configurationList.d.ts","sourceRoot":"","sources":["../../../../src/ios-widget/xcode/configurationList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGnD,OAAO,KAAK,EAA0B,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAEtF,MAAM,WAAW,8BAA8B;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gGAAgG;IAChG,eAAe,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAA;CAC/C;AAkFD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,8BAA8B,EACvC,2BAA2B,CAAC,EAAE,MAAM,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,OAmC1D"}

package/expo-plugin/build/types/ios-widget/xcode/fileReferences.d.ts

@@ -0,0 +1,16 @@
+import { XcodeProject } from '@expo/config-plugins';
+/** Strips surrounding quotes from a pbx path/name value. */
+export declare function normalizePath(value: string | undefined): string;
+/** Strips a trailing `/* comment *\/` and whitespace, yielding the bare UUID of a pbx reference. */
+export declare function normalizeRef(value: unknown): string;
+/**
+ * Resolves the PBXFileReference UUID for a widget file, scoped to the widget's own PBXGroup.
+ *
+ * pbxproj paths are group-relative, so a bare path like `Assets.xcassets` collides with any other
+ * extension's identically named file. Scoping the lookup to the children of the widget group
+ * (identified by `targetName`) keeps the widget's references distinct from those, which is what
+ * prevents the shared-fileRef corruption behind issues #87/#32. When the widget group does not
+ * exist yet, a fresh reference is created.
+ */
+export declare function ensureWidgetFileReference(xcodeProject: XcodeProject, filePath: string, targetName: string): string;
+//# sourceMappingURL=fileReferences.d.ts.map

package/expo-plugin/build/types/ios-widget/xcode/fileReferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileReferences.d.ts","sourceRoot":"","sources":["../../../../src/ios-widget/xcode/fileReferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAInD,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAK/D;AAED,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAInD;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAsBlH"}

package/expo-plugin/build/types/ios-widget/xcode/groups.d.ts

@@ -4,10 +4,6 @@ export interface AddPbxGroupOptions {
     targetName: string;
     widgetFiles: IOSWidgetExtensionFiles;
 }
-/**
- * Adds a PBXGroup for the widget extension files.
- */
-export declare function addPbxGroup(xcodeProject: XcodeProject, options: AddPbxGroupOptions): void;
 /**
  * Ensures a PBXGroup exists for the widget extension files.
  */

package/expo-plugin/build/types/ios-widget/xcode/groups.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../../../src/ios-widget/xcode/groups.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAI1D,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,uBAAuB,CAAA;CACrC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CA4BzF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAiC5F"}
+{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../../../src/ios-widget/xcode/groups.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAK1D,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,uBAAuB,CAAA;CACrC;AA6DD;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAwB5F"}

package/expo-plugin/build/types/ios-widget/xcode/index.d.ts

@@ -1,11 +1,29 @@
-import { ConfigPlugin } from '@expo/config-plugins';
-import type { IOSWidgetConfig } from '../../types';
+import { ConfigPlugin, XcodeProject } from '@expo/config-plugins';
+import type { IOSDynamicLiveActivityConfig, IOSWidgetConfig, IOSWidgetExtensionFiles } from '../../types';
 export interface ConfigureXcodeProjectProps {
     targetName: string;
     bundleIdentifier: string;
     deploymentTarget: string;
+    /** App marketing version; becomes the widget's MARKETING_VERSION so the appex matches the app. */
+    version?: string;
+    /** App build number; becomes the widget's CURRENT_PROJECT_VERSION. */
+    buildNumber?: string;
     widgets?: IOSWidgetConfig[];
+    liveActivities?: IOSDynamicLiveActivityConfig[];
 }
+/**
+ * Applies all widget-extension changes to an already-parsed Xcode project.
+ *
+ * This is the pure core of {@link configureXcodeProject}: it takes the parsed project, the plugin
+ * props, the discovered widget files, and whether any widget is client-rendered, then mutates the
+ * project in place. It performs no filesystem or `modRequest` access, which makes it directly
+ * testable against pbxproj fixtures.
+ *
+ * When the widget target does not exist yet, the minimal native-target skeleton is created first
+ * (targets cannot be "ensured" into existence); every other object is then reconciled by the same
+ * idempotent ensure pipeline that runs for an already-existing target.
+ */
+export declare function applyXcodeChanges(xcodeProject: XcodeProject, props: ConfigureXcodeProjectProps, widgetFiles: IOSWidgetExtensionFiles, hasClientRenderedWidgets?: boolean): void;
 /**
  * Plugin step that configures the Xcode project for the widget extension.
  *
@@ -16,7 +34,9 @@ export interface ConfigureXcodeProjectProps {
  * - Adds build phases (Sources, CopyFiles, Frameworks, Resources)
  * - Adds PBXGroup for widget files
  *
- * This should run after generateWidgetExtensionFiles so the files exist.
+ * This should run after generateWidgetExtensionFiles so the files exist. The wrapper is kept thin:
+ * it discovers widget files and detects client-rendered widgets, then delegates the actual pbxproj
+ * mutation to {@link applyXcodeChanges}.
  */
 export declare const configureXcodeProject: ConfigPlugin<ConfigureXcodeProjectProps>;
 //# sourceMappingURL=index.d.ts.map

package/expo-plugin/build/types/ios-widget/xcode/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ios-widget/xcode/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAoB,MAAM,sBAAsB,CAAA;AAGrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAUlD,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAA;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAAY,CAAC,0BAA0B,CAqI1E,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ios-widget/xcode/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAoB,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGnF,OAAO,KAAK,EAAE,4BAA4B,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAUzG,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,kGAAkG;IAClG,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAA;IAC3B,cAAc,CAAC,EAAE,4BAA4B,EAAE,CAAA;CAChD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,0BAA0B,EACjC,WAAW,EAAE,uBAAuB,EACpC,wBAAwB,UAAQ,GAC/B,IAAI,CAwFN;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAAY,CAAC,0BAA0B,CAwB1E,CAAA"}

package/expo-plugin/build/types/ios-widget/xcode/mainAppSettings.d.ts

@@ -1,15 +1,27 @@
 import { XcodeProject } from '@expo/config-plugins';
-export interface MainAppTargetSettings {
-    deploymentTarget: string;
+/** Code-signing settings read from one of the main app target's build configurations. */
+export interface MainAppSigningSettings {
     codeSignStyle?: string;
     developmentTeam?: string;
     provisioningProfileSpecifier?: string;
 }
+export interface MainAppTargetSettings {
+    /**
+     * Signing settings keyed by build-configuration name (e.g. `Debug`, `Release`). Release
+     * provisioning often differs from Debug, so the widget must mirror the main app per
+     * configuration rather than copying one configuration's signing into both.
+     */
+    byConfigurationName: Record<string, MainAppSigningSettings>;
+    /** The first configuration's settings, used for widget configurations with no name match. */
+    fallback: MainAppSigningSettings;
+}
 /**
- * Reads build settings from the main app target to synchronize code signing with the widget extension.
+ * Reads code-signing build settings from every build configuration of the main app target, so the
+ * widget extension can synchronize signing per configuration (Debug→Debug, Release→Release).
  *
  * @param xcodeProject The Xcode project instance
- * @returns The main app target's build settings, or null if not found
+ * @returns Signing settings keyed by configuration name plus a first-configuration fallback, or
+ * null when the main app target or its configurations cannot be resolved
  */
 export declare function getMainAppTargetSettings(xcodeProject: XcodeProject): MainAppTargetSettings | null;
 //# sourceMappingURL=mainAppSettings.d.ts.map

package/expo-plugin/build/types/ios-widget/xcode/mainAppSettings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mainAppSettings.d.ts","sourceRoot":"","sources":["../../../../src/ios-widget/xcode/mainAppSettings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,4BAA4B,CAAC,EAAE,MAAM,CAAA;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,qBAAqB,GAAG,IAAI,CA+EjG"}
+{"version":3,"file":"mainAppSettings.d.ts","sourceRoot":"","sources":["../../../../src/ios-widget/xcode/mainAppSettings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,yFAAyF;AACzF,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,4BAA4B,CAAC,EAAE,MAAM,CAAA;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;IAC3D,6FAA6F;IAC7F,QAAQ,EAAE,sBAAsB,CAAA;CACjC;AAmBD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,qBAAqB,GAAG,IAAI,CAsDjG"}

package/expo-plugin/build/types/ios-widget/xcode/productFile.d.ts

@@ -3,10 +3,6 @@ export interface AddProductFileOptions {
     targetName: string;
     groupName: string;
 }
-/**
- * Adds the product file (.appex) for the widget extension.
- */
-export declare function addProductFile(xcodeProject: XcodeProject, options: AddProductFileOptions): any;
 /**
  * Ensures the product file (.appex) exists and returns it.
  */

package/expo-plugin/build/types/ios-widget/xcode/productFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"productFile.d.ts","sourceRoot":"","sources":["../../../../src/ios-widget/xcode/productFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAsCD;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,qBAAqB,OAkBxF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,qBAAqB,OAqB3F"}
+{"version":3,"file":"productFile.d.ts","sourceRoot":"","sources":["../../../../src/ios-widget/xcode/productFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AA8DD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,qBAAqB,OAqB3F"}

package/expo-plugin/build/types/ios-widget/xcode/target.d.ts

@@ -1,36 +1,21 @@
 import { XcodeProject } from '@expo/config-plugins';
-export interface ConfigureTargetOptions {
+export interface CreateTargetSkeletonOptions {
     targetName: string;
     targetUuid: string;
-    productFile: {
-        fileRef: string;
-    };
-    xCConfigurationList: {
-        uuid: string;
-    };
 }
 /**
- * Configures the widget extension target in the Xcode project.
+ * Creates the minimal widget-extension native target and registers it with the project.
  *
- * This:
- * - Adds the target to PBXNativeTarget section
- * - Adds the target to PBXProject section
- * - Adds a dependency from the main app to the widget extension
+ * A target cannot be "ensured" into existence, so this is the one create-only step in
+ * {@link applyXcodeChanges}: it adds an empty `PBXNativeTarget` (no product reference, configuration
+ * list or build phases yet) to the `PBXNativeTarget` and `PBXProject` sections. The shared ensure
+ * pipeline then fills in the configuration list, product file, group, build phases, attributes and
+ * dependency — the same code that reconciles an already-existing target.
+ *
+ * @returns The freshly created native-target object (the value stored in the `PBXNativeTarget`
+ * section under `targetUuid`).
  */
-export declare function configureTarget(xcodeProject: XcodeProject, options: ConfigureTargetOptions): {
-    uuid: string;
-    pbxNativeTarget: {
-        isa: string;
-        name: string;
-        productName: string;
-        productReference: string;
-        productType: string;
-        buildConfigurationList: string;
-        buildPhases: never[];
-        buildRules: never[];
-        dependencies: never[];
-    };
-};
+export declare function createTargetSkeleton(xcodeProject: XcodeProject, options: CreateTargetSkeletonOptions): any;
 /**
  * Ensures target attributes (LastSwiftMigration) exist for the target.
  */

package/expo-plugin/build/types/ios-widget/xcode/target.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../../../src/ios-widget/xcode/target.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAQnD,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAChC,mBAAmB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CACtC;AAaD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,sBAAsB;;;;;;;;;;;;;EAM1F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAa3F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAqB3F"}
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../../../src/ios-widget/xcode/target.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAQnD,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,2BAA2B,OAsBpG;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAa3F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAqB3F"}

package/expo-plugin/build/types/types.d.ts

@@ -1,5 +1,5 @@
 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.
  */
@@ -30,9 +30,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'] */
@@ -47,12 +53,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;
@@ -76,6 +92,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[];
@@ -93,6 +111,7 @@ export interface IOSWidgetExtensionPluginProps {
     bundleIdentifier: string;
     deploymentTarget: string;
     widgets?: IOSWidgetConfig[];
+    liveActivities?: IOSDynamicLiveActivityConfig[];
     groupIdentifier?: string;
     keychainGroup?: string;
     fonts?: string[];

package/expo-plugin/build/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAExD,OAAO,KAAK,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE5G;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,cAAc,GACd,aAAa,GACb,kBAAkB,GAClB,mBAAmB,GACnB,sBAAsB,GACtB,iBAAiB,CAAA;AAErB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAA;IACb,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uFAAuF;IACvF,UAAU,EAAE,kBAAkB,EAAE,CAAA;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,wBAAwB;IAC/D;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,WAAW,CAAA;IACxB,WAAW,EAAE,WAAW,CAAA;IACxB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,eAAe,EAAE,CAAA;IACrC,gBAAgB,CAAC,EAAE,sBAAsB,CAAA;IACzC,YAAY,CAAC,EAAE,2BAA2B,CAAA;IAC1C;;;;;OAKG;IACH,SAAS,CAAC,EAAE,wBAAwB,CAAA;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAA;IACX,kBAAkB;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qBAAqB;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,wFAAwF;IACxF,wBAAwB,EAAE,MAAM,EAAE,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAA;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAA;AAElF,MAAM,WAAW,qBAAqB;IACpC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAA;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAA;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/expo-plugin/build/types/utils/urlScheme.d.ts

@@ -1,4 +1,19 @@
 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 declare function getAppURLSchemes(config: ExpoConfig): string[];
+/**
+ * Appends a URL type for every scheme not already listed. Returns `types` itself when nothing is
+ * missing.
+ */
+export declare function appendMissingURLSchemes<T extends URLType>(types: T[], schemes: string[]): (T | {
+    CFBundleURLSchemes: string[];
+})[];
 /**
  * Ensures the main app has a URL scheme set so widgetURL can open it.
  * This is an optional feature for deep linking from widgets.
@@ -7,4 +22,5 @@ import type { ExpoConfig } from 'expo/config';
  * @returns The modified config with URL scheme ensured
  */
 export declare function ensureURLScheme(config: ExpoConfig): ExpoConfig;
+export {};
 //# sourceMappingURL=urlScheme.d.ts.map

package/expo-plugin/build/types/utils/urlScheme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"urlScheme.d.ts","sourceRoot":"","sources":["../../../src/utils/urlScheme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAmC9D"}
+{"version":3,"file":"urlScheme.d.ts","sourceRoot":"","sources":["../../../src/utils/urlScheme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,KAAK,OAAO,GAAG;IAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAE/C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAU7D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,OAAO,EACvD,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,MAAM,EAAE,GAChB,CAAC,CAAC,GAAG;IAAE,kBAAkB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EAAE,CAU1C;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CA4B9D"}

package/expo-plugin/build/types/validation.d.ts

@@ -1,4 +1,5 @@
-import type { IOSConfigPluginProps, IOSWidgetConfig } from './types';
+import type { IOSConfigPluginProps, IOSDynamicLiveActivityConfig, IOSWidgetConfig } from './types';
+export declare function validateIOSDynamicLiveActivityConfig(liveActivity: IOSDynamicLiveActivityConfig, projectRoot?: string): void;
 export declare function validateIOSWidgetConfig(widget: IOSWidgetConfig, projectRoot?: string): void;
 export declare function validateIOSConfigPluginProps(props: IOSConfigPluginProps, projectRoot?: string): void;
 //# sourceMappingURL=validation.d.ts.map

package/expo-plugin/build/types/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/validation.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAmB,MAAM,SAAS,CAAA;AAYrF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAwB3F;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,oBAAoB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CA0BpG"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/validation.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,eAAe,EAAmB,MAAM,SAAS,CAAA;AAanH,wBAAgB,oCAAoC,CAClD,YAAY,EAAE,4BAA4B,EAC1C,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAaN;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CA6B3F;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,oBAAoB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAwEpG"}

package/expo-plugin/src/constants.ts

@@ -1,4 +1,4 @@
-import type { IOSWidgetFamily } from './types'
+import type { IOSWidgetConfig, IOSWidgetFamily } from './types'
 
 export const IOS = {
   DEPLOYMENT_TARGET: '17.0',
@@ -23,3 +23,26 @@ export const WIDGET_FAMILY_MAP: Record<IOSWidgetFamily, string> = {
   accessoryRectangular: '.accessoryRectangular',
   accessoryInline: '.accessoryInline',
 }
+
+/** Default prefix of a widget's WidgetKit `kind`: `Voltra_Widget_<id>`. Mirrors `VoltraStorageKeys.widgetKindPrefix`. */
+export const WIDGET_KIND_PREFIX = 'Voltra_Widget_'
+
+/** WidgetKit `kind` of a widget: the `kind` option when set, else `Voltra_Widget_<id>`. */
+export const widgetKind = (widget: Pick<IOSWidgetConfig, 'id' | 'kind'>): string =>
+  widget.kind ?? `${WIDGET_KIND_PREFIX}${widget.id}`
+
+/**
+ * `{ id: kind }` for the widgets that pin a custom `kind`, or undefined when none does.
+ * Written to both Info.plists (`Voltra_WidgetKinds`) so native code maps ids to kinds and back.
+ */
+export const widgetKindOverrides = (
+  widgets?: Pick<IOSWidgetConfig, 'id' | 'kind'>[]
+): Record<string, string> | undefined => {
+  const overrides: Record<string, string> = {}
+  for (const widget of widgets ?? []) {
+    if (widget.kind !== undefined) {
+      overrides[widget.id] = widget.kind
+    }
+  }
+  return Object.keys(overrides).length > 0 ? overrides : undefined
+}

package/expo-plugin/src/index.ts

@@ -1,5 +1,7 @@
 import { IOSConfig } from 'expo/config-plugins'
 
+import { resolveInstalledPackageVersion } from '@use-voltra/expo-plugin'
+
 import { IOS } from './constants'
 import { withIOS, withPushNotifications } from './ios'
 import { withIOS as withIOSWidget } from './ios-widget'
@@ -16,9 +18,15 @@ const withVoltraIos: VoltraIosConfigPlugin = (config, props = {}) => {
   const projectRoot = (config as { modRequest?: { projectRoot?: string } }).modRequest?.projectRoot
   validateIOSConfigPluginProps(props, projectRoot)
 
+  const voltraVersion = resolveInstalledPackageVersion(projectRoot ?? process.cwd(), '@use-voltra/ios-client')
+
   const iosBundleIdentifier = config.ios?.bundleIdentifier
   if (!iosBundleIdentifier) {
-    return config
+    throw new Error(
+      'The Voltra iOS config plugin requires "expo.ios.bundleIdentifier" to be set in the app config — ' +
+        'it derives the widget extension bundle identifier from it. ' +
+        'Set "ios.bundleIdentifier" (e.g. "com.example.app") in app.json or app.config.(js|ts) and run prebuild again.'
+    )
   }
 
   const deploymentTarget = props.deploymentTarget || IOS.DEPLOYMENT_TARGET
@@ -37,7 +45,9 @@ const withVoltraIos: VoltraIosConfigPlugin = (config, props = {}) => {
     groupIdentifier: props.groupIdentifier,
     widgetIds: props.widgets && props.widgets.length > 0 ? props.widgets.map((w) => w.id) : undefined,
     widgets: props.widgets,
+    liveActivities: props.liveActivities,
     keychainGroup,
+    voltraVersion,
   })
 
   config = withIOSWidget(config, {
@@ -45,8 +55,10 @@ const withVoltraIos: VoltraIosConfigPlugin = (config, props = {}) => {
     bundleIdentifier,
     deploymentTarget,
     widgets: props.widgets,
+    liveActivities: props.liveActivities,
     version,
     buildNumber,
+    voltraVersion,
     ...(props.groupIdentifier ? { groupIdentifier: props.groupIdentifier } : {}),
     ...(keychainGroup ? { keychainGroup } : {}),
     ...(props.fonts ? { fonts: props.fonts } : {}),
@@ -63,6 +75,7 @@ export default withVoltraIos
 
 export type {
   IOSConfigPluginProps,
+  IOSDynamicLiveActivityConfig,
   IOSMainAppPluginProps,
   IOSWidgetConfig,
   IOSWidgetExtensionFiles,

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

@@ -8,7 +8,9 @@ export interface IOSConfigProps {
   groupIdentifier?: string
   widgetIds?: string[]
   widgets?: import('../types').IOSWidgetConfig[]
+  liveActivities?: import('../types').IOSDynamicLiveActivityConfig[]
   keychainGroup?: string
+  voltraVersion: string
 }
 
 /**
@@ -27,6 +29,7 @@ export function withIOS(config: ExpoConfig, props: IOSConfigProps): ExpoConfig {
     widgetIds: props.widgetIds,
     widgets: props.widgets,
     keychainGroup: props.keychainGroup,
+    voltraVersion: props.voltraVersion,
   })
 
   // Configure entitlements

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

@@ -1,12 +1,15 @@
 import { ConfigPlugin, withInfoPlist } from '@expo/config-plugins'
 
+import { widgetKindOverrides } from '../constants'
 import type { IOSWidgetConfig } from '../types'
+import { resolveIOSWidgetServerUpdate } from './serverUpdate'
 
 export interface ConfigureInfoPlistProps {
   groupIdentifier?: string
   widgetIds?: string[]
   widgets?: IOSWidgetConfig[]
   keychainGroup?: string
+  voltraVersion: string
 }
 
 /**
@@ -16,14 +19,16 @@ export interface ConfigureInfoPlistProps {
  * - NSSupportsLiveActivities: Enables Live Activities support
  * - Voltra_AppGroupIdentifier: App group ID for widget communication (if provided)
  * - Voltra_WidgetIds: Array of widget IDs for native module access (if provided)
+ * - Voltra_WidgetKinds: Map of widget IDs to custom WidgetKit kinds (if any widget sets `kind`)
  * - Voltra_WidgetServerUrls: Map of widget IDs to server URLs (if any widgets have serverUpdate)
  * - Voltra_WidgetServerIntervals: Map of widget IDs to update intervals (if any widgets have serverUpdate)
  * - Voltra_KeychainGroup: Keychain access group for shared credentials (if provided)
  */
-export const configureInfoPlist: ConfigPlugin<ConfigureInfoPlistProps> = (config, props = {}) => {
+export const configureInfoPlist: ConfigPlugin<ConfigureInfoPlistProps> = (config, props) => {
   return withInfoPlist(config, (mod) => {
     mod.modResults.NSSupportsLiveActivities = true
     mod.modResults.NSSupportsLiveActivitiesFrequentUpdates = false
+    mod.modResults.Voltra_Version = props.voltraVersion
 
     // Only add group identifier if provided
     if (props.groupIdentifier) {
@@ -35,21 +40,44 @@ export const configureInfoPlist: ConfigPlugin<ConfigureInfoPlistProps> = (config
       mod.modResults.Voltra_WidgetIds = props.widgetIds
     }
 
+    // Store custom widget kinds so native code can map ids to kinds and back. A prebuild over an
+    // existing ios/ directory keeps whatever the plist already holds, so a `kind` that was removed
+    // from the config has to be deleted here or the widget would keep a kind nobody configured.
+    const widgetKinds = widgetKindOverrides(props.widgets)
+    if (widgetKinds) {
+      mod.modResults.Voltra_WidgetKinds = widgetKinds
+    } else {
+      delete mod.modResults.Voltra_WidgetKinds
+    }
+
     // Configure server update URLs and intervals for widgets
     if (props.widgets && props.widgets.length > 0) {
       const serverUrls: Record<string, string> = {}
       const serverIntervals: Record<string, number> = {}
 
       for (const widget of props.widgets) {
-        if (widget.serverUpdate) {
-          serverUrls[widget.id] = widget.serverUpdate.url
-          serverIntervals[widget.id] = widget.serverUpdate.intervalMinutes ?? 15
+        const serverUpdate = resolveIOSWidgetServerUpdate(widget)
+
+        if (!serverUpdate) {
+          continue
+        }
+
+        // Every server-driven widget gets an interval, so this dictionary's keys are the set of
+        // server-driven widget ids the runtime settings store validates against. A URL is written
+        // only when app.json set one; otherwise the app supplies it with setWidgetServerUpdate.
+        serverIntervals[widget.id] = serverUpdate.intervalMinutes
+
+        if (serverUpdate.url !== undefined) {
+          serverUrls[widget.id] = serverUpdate.url
         }
       }
 
+      if (Object.keys(serverIntervals).length > 0) {
+        mod.modResults.Voltra_WidgetServerIntervals = serverIntervals
+      }
+
       if (Object.keys(serverUrls).length > 0) {
         mod.modResults.Voltra_WidgetServerUrls = serverUrls
-        mod.modResults.Voltra_WidgetServerIntervals = serverIntervals
       }
     }
 

package/expo-plugin/src/ios/serverUpdate.ts

@@ -0,0 +1,29 @@
+import { resolveWidgetServerUpdate } from '@use-voltra/expo-plugin'
+
+import type { ResolvedWidgetServerUpdateConfig, WidgetServerUpdateRules } from '@use-voltra/expo-plugin'
+
+import type { IOSWidgetConfig } from '../types'
+
+/**
+ * iOS payload widgets have always defaulted to 15 minutes and accepted anything down to 1, since
+ * WidgetKit stretches a timeline it cannot honour rather than refusing it. A widget with an
+ * `entry` follows ADR 0002 instead: default 15, floor 15 on both platforms.
+ */
+export function iosServerUpdateRules(widget: Pick<IOSWidgetConfig, 'entry'>): WidgetServerUpdateRules {
+  return {
+    hasEntry: widget.entry !== undefined,
+    defaultIntervalMinutes: 15,
+    minimumIntervalMinutes: 1,
+  }
+}
+
+/** `serverUpdate` with defaults applied, as the plist and Swift generators consume it. */
+export function resolveIOSWidgetServerUpdate(
+  widget: Pick<IOSWidgetConfig, 'entry' | 'serverUpdate'>
+): ResolvedWidgetServerUpdateConfig | undefined {
+  if (widget.serverUpdate === undefined) {
+    return undefined
+  }
+
+  return resolveWidgetServerUpdate(widget.serverUpdate, iosServerUpdateRules(widget))
+}