voltra 2.2.0 → 2.3.1

package/build/types/platforms/ios/generated.d.ts

@@ -1,10 +1,10 @@
 import { VoltraCliError } from '../../reporting/summary';
 import type { IOSProjectDiscovery } from '../../discovery/ios';
-import type { NormalizedVoltraIOSConfig } from '../../config/types';
+import type { NormalizedIOSWidgetConfig, ResolvedVoltraIOSConfig } from '../../config/types';
 import type { ReportedChange } from '../../reporting/summary';
 export interface GenerateIOSFilesOptions {
     projectRoot: string;
-    ios: NormalizedVoltraIOSConfig;
+    ios: ResolvedVoltraIOSConfig;
     discovery: IOSProjectDiscovery;
 }
 export interface GenerateIOSFilesResult {
@@ -14,8 +14,20 @@ export interface GenerateIOSFilesResult {
     targetName: string;
     targetPath: string;
 }
+export type DetectedIOSWidget = (NormalizedIOSWidgetConfig & {
+    clientRendered: false;
+}) | (NormalizedIOSWidgetConfig & {
+    entry: string;
+    clientRendered: true;
+    clientSourcePath: string;
+});
 export declare class IOSGeneratedFilesError extends VoltraCliError {
     constructor(message: string);
 }
 export declare function generateIOSFiles(options: GenerateIOSFilesOptions): Promise<GenerateIOSFilesResult>;
+declare function generateWidgetBundleSwift(widgets: DetectedIOSWidget[]): string;
+export declare const __test__: {
+    generateWidgetBundleSwift: typeof generateWidgetBundleSwift;
+};
+export {};
 //# sourceMappingURL=generated.d.ts.map

package/build/types/platforms/ios/generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generated.d.ts","sourceRoot":"","sources":["../../../../src/platforms/ios/generated.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAKxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,KAAK,EAIV,yBAAyB,EAE1B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AA8E7D,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,yBAAyB,CAAA;IAC9B,SAAS,EAAE,mBAAmB,CAAA;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AA8BD,qBAAa,sBAAuB,SAAQ,cAAc;gBAC5C,OAAO,EAAE,MAAM;CAI5B;AAMD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAmExG"}
+{"version":3,"file":"generated.d.ts","sourceRoot":"","sources":["../../../../src/platforms/ios/generated.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAQxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,KAAK,EAGV,yBAAyB,EACzB,uBAAuB,EAExB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AA8E7D,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,uBAAuB,CAAA;IAC5B,SAAS,EAAE,mBAAmB,CAAA;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AA0BD,MAAM,MAAM,iBAAiB,GACzB,CAAC,yBAAyB,GAAG;IAAE,cAAc,EAAE,KAAK,CAAA;CAAE,CAAC,GACvD,CAAC,yBAAyB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,IAAI,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAEnG,qBAAa,sBAAuB,SAAQ,cAAc;gBAC5C,OAAO,EAAE,MAAM;CAI5B;AAMD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAgFxG;AAuVD,iBAAS,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAkEvE;AA6qBD,eAAO,MAAM,QAAQ;;CAEpB,CAAA"}

package/build/types/platforms/ios/plist.d.ts

@@ -1,15 +1,15 @@
 import { VoltraCliError } from '../../reporting/summary';
 import type { IOSProjectDiscovery } from '../../discovery/ios';
-import type { NormalizedVoltraIOSConfig } from '../../config/types';
+import type { ResolvedVoltraIOSConfig } from '../../config/types';
 import type { ReportedChange } from '../../reporting/summary';
 type PlistErrorFactory = (message: string) => Error;
 export interface EnsureInfoPlistOptions {
     projectRoot: string;
-    ios: NormalizedVoltraIOSConfig;
+    ios: ResolvedVoltraIOSConfig;
     discovery: IOSProjectDiscovery;
 }
 export interface EnsureInfoPlistResult {
-    change?: ReportedChange;
+    changes: ReportedChange[];
 }
 export declare class IOSInfoPlistMutationError extends VoltraCliError {
     constructor(message: string);

package/build/types/platforms/ios/plist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plist.d.ts","sourceRoot":"","sources":["../../../../src/platforms/ios/plist.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAExD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAa7D,KAAK,iBAAiB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,KAAK,CAAA;AAEnD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,yBAAyB,CAAA;IAC9B,SAAS,EAAE,mBAAmB,CAAA;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,cAAc,CAAA;CACxB;AAED,qBAAa,yBAA0B,SAAQ,cAAc;gBAC/C,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAmCrG;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAuBlC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,iBAAiB,GAAG,MAAM,CAiBpF"}
+{"version":3,"file":"plist.d.ts","sourceRoot":"","sources":["../../../../src/platforms/ios/plist.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAExD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAa7D,KAAK,iBAAiB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,KAAK,CAAA;AAEnD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,uBAAuB,CAAA;IAC5B,SAAS,EAAE,mBAAmB,CAAA;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,cAAc,EAAE,CAAA;CAC1B;AAED,qBAAa,yBAA0B,SAAQ,cAAc;gBAC/C,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAcrG;AAmDD,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAuBlC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,iBAAiB,GAAG,MAAM,CAiBpF"}

package/build/types/platforms/ios/podfile.d.ts

@@ -1,10 +1,10 @@
 import { VoltraCliError } from '../../reporting/summary';
 import type { IOSProjectDiscovery } from '../../discovery/ios';
-import type { NormalizedVoltraIOSConfig } from '../../config/types';
+import type { ResolvedVoltraIOSConfig } from '../../config/types';
 import type { ReportedChange } from '../../reporting/summary';
 export interface EnsurePodfileBlockOptions {
     projectRoot: string;
-    ios: NormalizedVoltraIOSConfig;
+    ios: ResolvedVoltraIOSConfig;
     discovery: IOSProjectDiscovery;
 }
 export interface EnsurePodfileBlockResult {

package/build/types/platforms/ios/podfile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"podfile.d.ts","sourceRoot":"","sources":["../../../../src/platforms/ios/podfile.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAIxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAO7D,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,yBAAyB,CAAA;IAC9B,SAAS,EAAE,mBAAmB,CAAA;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,qBAAa,uBAAwB,SAAQ,cAAc;gBAC7C,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAsB9G"}
+{"version":3,"file":"podfile.d.ts","sourceRoot":"","sources":["../../../../src/platforms/ios/podfile.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAIxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAO7D,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,uBAAuB,CAAA;IAC5B,SAAS,EAAE,mBAAmB,CAAA;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,qBAAa,uBAAwB,SAAQ,cAAc;gBAC7C,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAsB9G"}

package/build/types/platforms/ios/targetName.d.ts

@@ -1,4 +1,4 @@
 import type { IOSProjectDiscovery } from '../../discovery/ios';
-import type { NormalizedVoltraIOSConfig } from '../../config/types';
-export declare function resolveIOSWidgetTargetName(ios: NormalizedVoltraIOSConfig, discovery: IOSProjectDiscovery): string;
+import type { ResolvedVoltraIOSConfig } from '../../config/types';
+export declare function resolveIOSWidgetTargetName(ios: ResolvedVoltraIOSConfig, discovery: IOSProjectDiscovery): string;
 //# sourceMappingURL=targetName.d.ts.map

package/build/types/platforms/ios/targetName.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"targetName.d.ts","sourceRoot":"","sources":["../../../../src/platforms/ios/targetName.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AAEnE,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,yBAAyB,EAAE,SAAS,EAAE,mBAAmB,GAAG,MAAM,CAOjH"}
+{"version":3,"file":"targetName.d.ts","sourceRoot":"","sources":["../../../../src/platforms/ios/targetName.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAEjE,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,uBAAuB,EAAE,SAAS,EAAE,mBAAmB,GAAG,MAAM,CAO/G"}

package/build/types/platforms/ios/xcodeTarget.d.ts

@@ -1,13 +1,15 @@
 import { VoltraCliError } from '../../reporting/summary';
 import type { IOSProjectDiscovery } from '../../discovery/ios';
-import type { NormalizedVoltraIOSConfig } from '../../config/types';
+import type { ResolvedVoltraIOSConfig } from '../../config/types';
 import type { ReportedChange } from '../../reporting/summary';
 export interface EnsureIOSWidgetTargetOptions {
     projectRoot: string;
-    ios: NormalizedVoltraIOSConfig;
+    ios: ResolvedVoltraIOSConfig;
     discovery: IOSProjectDiscovery;
     generatedFiles: string[];
     previousGeneratedFiles?: string[];
+    /** User-defined build settings to write at project level, keyed by build configuration name. */
+    buildSettings?: Map<string, Record<string, string>>;
 }
 export interface EnsureIOSWidgetTargetResult {
     change?: ReportedChange;

package/build/types/platforms/ios/xcodeTarget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xcodeTarget.d.ts","sourceRoot":"","sources":["../../../../src/platforms/ios/xcodeTarget.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAOxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AA2D7D,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,yBAAyB,CAAA;IAC9B,SAAS,EAAE,mBAAmB,CAAA;IAC9B,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAA;CAClC;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,4BAA6B,SAAQ,cAAc;gBAClD,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CAkDtC"}
+{"version":3,"file":"xcodeTarget.d.ts","sourceRoot":"","sources":["../../../../src/platforms/ios/xcodeTarget.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAQxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAgE7D,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,uBAAuB,CAAA;IAC5B,SAAS,EAAE,mBAAmB,CAAA;IAC9B,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAA;IACjC,gGAAgG;IAChG,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACpD;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,4BAA6B,SAAQ,cAAc;gBAClD,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CAwDtC"}

package/build/types/platforms/shared/widgetModule.d.ts

@@ -1,9 +1,18 @@
+import { type WidgetModuleLoader } from '@use-voltra/compiler';
+import type { VoltraPlatform } from '../../config/types';
 export interface WidgetModuleBuildInfo {
     isDev: false;
     metroUrl: null;
     appVersion: 'unknown';
-    voltraVersion: '1.4.1';
+    voltraVersion: string;
 }
-export declare const DYNAMIC_WIDGET_BUILD_INFO: WidgetModuleBuildInfo;
-export declare function evaluateWidgetModuleExports(projectRoot: string, filePath: string, createError: (message: string) => Error): unknown;
+export declare function createDynamicWidgetBuildInfo(voltraVersion: string): WidgetModuleBuildInfo;
+/**
+ * Loader used by the apply pipeline to evaluate widget source at build time.
+ *
+ * The evaluation rules — which imports are allowed and what they resolve to — live in
+ * `@use-voltra/compiler` so that `voltra apply`, the Expo config plugins, and the Metro
+ * widget bundler all apply the same contract.
+ */
+export declare function createGeneratedWidgetModuleLoader(projectRoot: string, platform: VoltraPlatform, createError: (message: string) => Error, onWarning?: (message: string) => void): WidgetModuleLoader;
 //# sourceMappingURL=widgetModule.d.ts.map

package/build/types/platforms/shared/widgetModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widgetModule.d.ts","sourceRoot":"","sources":["../../../../src/platforms/shared/widgetModule.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,KAAK,CAAA;IACZ,QAAQ,EAAE,IAAI,CAAA;IACd,UAAU,EAAE,SAAS,CAAA;IACrB,aAAa,EAAE,OAAO,CAAA;CACvB;AAED,eAAO,MAAM,yBAAyB,EAAE,qBAKvC,CAAA;AAED,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,KAAK,GACtC,OAAO,CA2CT"}
+{"version":3,"file":"widgetModule.d.ts","sourceRoot":"","sources":["../../../../src/platforms/shared/widgetModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAExF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,KAAK,CAAA;IACZ,QAAQ,EAAE,IAAI,CAAA;IACd,UAAU,EAAE,SAAS,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,wBAAgB,4BAA4B,CAAC,aAAa,EAAE,MAAM,GAAG,qBAAqB,CAOzF;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,KAAK,EACvC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACpC,kBAAkB,CAEpB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "voltra",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "description": "CLI for applying Voltra to native React Native projects",
   "main": "build/cjs/index.js",
   "module": "build/esm/index.js",
@@ -40,22 +40,22 @@
   "license": "MIT",
   "homepage": "https://use-voltra.dev",
   "dependencies": {
-    "@babel/core": "^7.27.4",
     "@bacons/xcode": "^1.0.0-alpha.33",
     "@clack/prompts": "^1.0.0-alpha.5",
     "commander": "^12.1.0",
     "cosmiconfig": "^9.0.0",
     "vd-tool": "^4.0.2",
-    "xml2js": "^0.6.2"
+    "xml2js": "^0.6.2",
+    "@use-voltra/compiler": "^2.3.1"
   },
   "devDependencies": {
-    "@types/babel__core": "^7.20.5"
+    "tsx": "^4.19.0"
   },
   "scripts": {
     "build": "node ../../scripts/build-package.mjs packages/cli",
     "clean": "rm -rf build",
     "lint": "oxlint src",
     "typecheck": "tsc -p tsconfig.typecheck.json --noEmit",
-    "test": "node --test"
+    "test": "node --import tsx --test"
   }
 }

package/src/apply/index.ts

@@ -9,6 +9,7 @@ import { applyAndroidPlatform, createAndroidPreflightRunner } from '../platforms
 import { applyIOSPlatform, createIOSPreflightRunner } from '../platforms/ios/apply'
 import { renderApplySummary, renderIntro } from '../reporting/clack'
 import { VoltraCliError } from '../reporting/summary'
+import { findMissingMetroPackageWarning } from '../discovery/metro'
 import { diffVoltraState } from '../state/diff'
 import { loadVoltraState } from '../state/load'
 import { saveVoltraState } from '../state/save'
@@ -108,7 +109,11 @@ export async function runApplyPipeline(options: ApplyOptions, dependencies: Appl
   const deletedChanges = await removeStaleGeneratedFiles(normalizedConfig.projectRoot, stateDiff.staleFiles)
   await saveVoltraState(normalizedConfig.projectRoot, { files: stateDiff.nextFiles })
 
-  const summaryWarnings = platformResults.flatMap((result) => result.warnings ?? []).filter(isDefined)
+  const summaryWarnings = [
+    ...(normalizedConfig.warnings ?? []),
+    ...platformResults.flatMap((result) => result.warnings ?? []),
+    findMissingMetroPackageWarning(normalizedConfig),
+  ].filter(isDefined)
   const summaryChanges = [...platformResults.flatMap((result) => result.changes), ...deletedChanges]
 
   await resolvedDependencies.writeSummary({ changes: summaryChanges, warnings: summaryWarnings })

package/src/config/normalize.node.test.ts

@@ -0,0 +1,105 @@
+import assert from 'node:assert/strict'
+import { describe, test } from 'node:test'
+
+import { normalizeVoltraConfig, VoltraConfigNormalizationError } from './normalize.ts'
+
+import type { AndroidWidgetConfig, IOSWidgetConfig } from './types.ts'
+
+function normalizeWidgets(widgets: IOSWidgetConfig[]) {
+  return normalizeVoltraConfig({
+    config: { ios: { widgets } },
+    configDir: process.cwd(),
+  })
+}
+
+const streak: IOSWidgetConfig = { id: 'streak', displayName: 'Streak', description: 'Your daily streak' }
+const weather: IOSWidgetConfig = { id: 'weather', displayName: 'Weather', description: 'Shows weather' }
+
+describe('ios widget kind', () => {
+  test('accepts a custom kind', () => {
+    const config = normalizeWidgets([{ ...streak, kind: 'StreakWidget' }])
+
+    assert.equal(config.ios?.widgets[0]?.kind, 'StreakWidget')
+  })
+
+  test('leaves the kind unset when the config does not pin one', () => {
+    const config = normalizeWidgets([streak])
+
+    assert.equal(config.ios?.widgets[0]?.kind, undefined)
+  })
+
+  test('rejects an empty kind', () => {
+    assert.throws(
+      () => normalizeWidgets([{ ...streak, kind: '' }]),
+      (error: unknown) =>
+        error instanceof VoltraConfigNormalizationError && /ios\.widgets\[streak\]\.kind/.test(error.message)
+    )
+  })
+
+  test('rejects two widgets sharing a kind', () => {
+    assert.throws(
+      () =>
+        normalizeWidgets([
+          { ...streak, kind: 'Widgets' },
+          { ...weather, kind: 'Widgets' },
+        ]),
+      (error: unknown) =>
+        error instanceof VoltraConfigNormalizationError && /Duplicate ios widget kind 'Widgets'/.test(error.message)
+    )
+  })
+
+  test('rejects a custom kind that collides with another widget default kind', () => {
+    // `weather` would answer to `Voltra_Widget_weather` too, so both would fight over the same
+    // placed instances.
+    assert.throws(
+      () => normalizeWidgets([{ ...streak, kind: 'Voltra_Widget_weather' }, weather]),
+      (error: unknown) =>
+        error instanceof VoltraConfigNormalizationError &&
+        /Duplicate ios widget kind 'Voltra_Widget_weather'/.test(error.message)
+    )
+  })
+})
+
+describe('appIntent without an entry', () => {
+  const parameters = [{ name: 'city', title: 'City', default: 'Seul' }]
+
+  const androidWeather: AndroidWidgetConfig = {
+    id: 'weather_widget',
+    displayName: 'Weather Widget',
+    description: 'Test Weather component',
+    targetCellWidth: 3,
+    targetCellHeight: 2,
+  }
+
+  function normalizeAndroidWidgets(widgets: AndroidWidgetConfig[]) {
+    return normalizeVoltraConfig({
+      config: { android: { widgets } },
+      configDir: process.cwd(),
+    })
+  }
+
+  test('warns that android appIntent needs an entry', () => {
+    const config = normalizeAndroidWidgets([{ ...androidWeather, appIntent: { parameters } }])
+
+    assert.match(config.warnings?.join('\n') ?? '', /android\.widgets\[weather_widget\]\.appIntent is ignored/)
+    assert.match(config.warnings?.join('\n') ?? '', /'entry'/)
+  })
+
+  test('warns that ios appIntent needs an entry', () => {
+    const config = normalizeWidgets([{ ...weather, appIntent: { parameters } }])
+
+    assert.match(config.warnings?.join('\n') ?? '', /ios\.widgets\[weather\]\.appIntent is ignored/)
+  })
+
+  test('stays quiet when the widget has an entry', () => {
+    const config = normalizeWidgets([{ ...weather, entry: './widgets/weather.tsx', appIntent: { parameters } }])
+
+    assert.deepEqual(config.warnings, [])
+  })
+
+  test('stays quiet for an appIntent that declares no parameters', () => {
+    const config = normalizeWidgets([{ ...weather, appIntent: { parameters: [] } }])
+
+    assert.deepEqual(config.warnings, [])
+  })
+})