expo-widgets 56.0.8 → 56.0.10

package/CHANGELOG.md

@@ -10,6 +10,27 @@
 
 ### 💡 Others
 
+## 56.0.10 — 2026-05-19
+
+### 💡 Others
+
+- Validate/sanitize config-plugin inputs more comprehensively ([#45884](https://github.com/expo/expo/pull/45884) by [@kitten](https://github.com/kitten))
+
+## 56.0.9 — 2026-05-15
+
+### 🎉 New features
+
+- Use shared JS runtime. ([#45781](https://github.com/expo/expo/pull/45781) by [@jakex7](https://github.com/jakex7))
+
+### 🐛 Bug fixes
+
+- Fix Live Activity multiple evaluations. ([#45675](https://github.com/expo/expo/pull/45675) by [@nkopylov](https://github.com/nkopylov))
+- Fix module precompile. ([#45715](https://github.com/expo/expo/pull/45715) by [@jakex7](https://github.com/jakex7))
+
+### 💡 Others
+
+- Migrated to the single-payload `SharedObject.emit` API. ([#45596](https://github.com/expo/expo/pull/45596) by [@tsapeta](https://github.com/tsapeta))
+
 ## 56.0.8 — 2026-05-13
 
 ### 🎉 New features

package/ios/LiveActivity.swift

@@ -66,7 +66,7 @@ final class LiveActivity: SharedObject {
     pushTokenObserverTask = Task {
       for await data in activity.pushTokenUpdates {
         let token = data.reduce("") { $0 + String(format: "%02x", $1) }
-        emit(event: onTokenReceived, arguments: [
+        emit(event: onTokenReceived, payload: [
           "activityId": activity.id,
           "pushToken": token
         ])

package/ios/Widgets/AppIntent.swift

@@ -58,19 +58,25 @@ struct WidgetUserInteraction: AppIntent {
 
     guard let timeline,
           let entryIndex,
+          timeline.indices.contains(entryIndex),
           let entry = timeline[entryIndex] as? [String: Any],
           let props = entry["props"] as? [String: Any],
-          let context = createWidgetContext(layout: layout),
           let environmentData = environmentString?.data(using: .utf8),
           var environment = try? JSONSerialization.jsonObject(with: environmentData) as? [String: Any] else {
       return .result()
     }
     environment["target"] = target
 
-    let result = context.objectForKeyedSubscript("__expoWidgetHandlePress")?.call(
-      withArguments: [props, environment]
-    )
-    if let newProps = result?.toObject() as? [String: Any] {
+    let newProps: [String: Any]?
+    switch evaluateWidgetButtonPress(layout: layout, props: props, environment: environment) {
+    case .success(let result):
+      newProps = result
+    case .failure(let error):
+      print("[ExpoWidgets] Button press evaluation failed: \(error.message)")
+      newProps = nil
+    }
+
+    if let newProps {
       var newEntry = entry
       if let originalProps = entry["props"] as? [String: Any] {
         newEntry["props"] = originalProps.merging(newProps) { _, new in new }

package/ios/Widgets/Utils.swift

@@ -33,41 +33,27 @@ public func evaluateLayout(
   props: [String: Any],
   environment: [String: Any]
 ) -> [String: Any] {
-  guard let context = createWidgetContext(layout: layout) else {
-    return createRedBox(message: "Could not create context for layout evaluation.")
+  switch evaluateWidgetLayout(layout: layout, props: props, environment: environment) {
+  case .success(let result):
+    return result
+  case .failure(let error):
+    print("[ExpoWidgets] Layout evaluation failed: \(error.message)")
+    return createRedBox(message: error.message)
   }
-
-  let result = context.objectForKeyedSubscript("__expoWidgetRender")?.call(
-    withArguments: [props, environment]
-  )
-  if let exception = context.exception {
-    print("[ExpoWidgets] Layout evaluation failed: \(exception)")
-    return createRedBox(message: exception.toString())
-  }
-  return result?.toObject() as? [String: Any] ?? createRedBox(message: "Expo widget render did not produce any results.")
 }
 
 func getLiveActivityNodes(forName name: String, props: String = "{}", environment: [String: Any]) -> [String: Any] {
   let layout = WidgetsStorage.getString(forKey: "__expo_widgets_live_activity_\(name)_layout") ?? ""
   let propsData = props.data(using: .utf8)
   let propsDict = propsData.flatMap { try? JSONSerialization.jsonObject(with: $0, options: []) as? [String: Any] } ?? [:]
-  guard let context = createWidgetContext(layout: layout) else {
-    return ["banner": createRedBox(message: "Could not create context for layout evaluation.")]
-  }
 
-  var widgetEnvironment = environment
-  widgetEnvironment["timestamp"] = Int(Date.now.timeIntervalSince1970 * 1000)
-
-  let result = context.objectForKeyedSubscript("__expoWidgetRender")?.call(
-    withArguments: [propsDict, environment]
-  )
-
-  if let exception = context.exception {
-    print("[ExpoWidgets] Layout evaluation failed: \(exception)")
-    return ["banner": createRedBox(message: exception.toString())]
+  switch evaluateWidgetLayout(layout: layout, props: propsDict, environment: environment) {
+  case .success(let result):
+    return result
+  case .failure(let error):
+    print("[ExpoWidgets] Layout evaluation failed: \(error.message)")
+    return ["banner": createRedBox(message: error.message)]
   }
-
-  return result?.toObject() as? [String: Any] ?? ["banner": createRedBox(message: "Expo widget render did not produce any results.")]
 }
 
 func getLiveActivityUrl(forName name: String) -> URL? {

package/ios/Widgets/WidgetLiveActivity.swift

@@ -24,27 +24,37 @@ public struct WidgetLiveActivity: Widget {
 
   public var body: some WidgetConfiguration {
     ActivityConfiguration(for: LiveActivityAttributes.self) { context in
-      LiveActivityBannerView(context: context, environment: environment)
+      let nodes = getLiveActivityNodes(
+        forName: context.state.name,
+        props: context.state.props,
+        environment: environment
+      )
+      LiveActivityBannerView(context: context, nodes: nodes)
     } dynamicIsland: { context in
-      DynamicIsland {
+      let nodes = getLiveActivityNodes(
+        forName: context.state.name,
+        props: context.state.props,
+        environment: environment
+      )
+      return DynamicIsland {
         DynamicIslandExpandedRegion(.center) {
-          LiveActivitySectionView(context: context, environment: environment, sectionName: "expandedCenter")
+          LiveActivitySectionView(context: context, nodes: nodes, sectionName: "expandedCenter")
         }
         DynamicIslandExpandedRegion(.leading) {
-          LiveActivitySectionView(context: context, environment: environment, sectionName: "expandedLeading")
+          LiveActivitySectionView(context: context, nodes: nodes, sectionName: "expandedLeading")
         }
         DynamicIslandExpandedRegion(.trailing) {
-          LiveActivitySectionView(context: context, environment: environment, sectionName: "expandedTrailing")
+          LiveActivitySectionView(context: context, nodes: nodes, sectionName: "expandedTrailing")
         }
         DynamicIslandExpandedRegion(.bottom) {
-          LiveActivitySectionView(context: context, environment: environment, sectionName: "expandedBottom")
+          LiveActivitySectionView(context: context, nodes: nodes, sectionName: "expandedBottom")
         }
       } compactLeading: {
-        LiveActivitySectionView(context: context, environment: environment, sectionName: "compactLeading")
+        LiveActivitySectionView(context: context, nodes: nodes, sectionName: "compactLeading")
       } compactTrailing: {
-        LiveActivitySectionView(context: context, environment: environment, sectionName: "compactTrailing")
+        LiveActivitySectionView(context: context, nodes: nodes, sectionName: "compactTrailing")
       } minimal: {
-        LiveActivitySectionView(context: context, environment: environment, sectionName: "minimal")
+        LiveActivitySectionView(context: context, nodes: nodes, sectionName: "minimal")
       }
       .widgetURL(getLiveActivityUrl(forName: context.state.name))
     }
@@ -55,15 +65,10 @@ public struct WidgetLiveActivity: Widget {
 @available(iOS 16.1, *)
 private struct LiveActivitySectionView: View {
   let context: ActivityViewContext<LiveActivityAttributes>
-  let environment: [String: Any]
+  let nodes: [String: Any]
   let sectionName: String
 
   var body: some View {
-    let nodes = getLiveActivityNodes(
-      forName: context.state.name,
-      props: context.state.props,
-      environment: environment
-    )
     if let node = nodes[sectionName] as? [String: Any] {
       WidgetsDynamicView(name: context.activityID, kind: .liveActivity, node: node)
     } else {
@@ -75,14 +80,9 @@ private struct LiveActivitySectionView: View {
 @available(iOS 16.1, *)
 private struct LiveActivityBannerView: View {
   var context: ActivityViewContext<LiveActivityAttributes>
-  let environment: [String: Any]
+  let nodes: [String: Any]
 
   var body: some View {
-    let nodes = getLiveActivityNodes(
-      forName: context.state.name,
-      props: context.state.props,
-      environment: environment
-    )
     if #available(iOS 18.0, *) {
       LiveActivityBanner(context: context, nodes: nodes)
     } else if let node = nodes["banner"] as? [String: Any] {

package/ios/Widgets/WidgetsJSRuntime.swift

@@ -0,0 +1,142 @@
+import Foundation
+import JavaScriptCore
+
+struct WidgetJavaScriptError: Error {
+  let message: String
+}
+
+typealias WidgetJavaScriptResult<Value> = Result<Value, WidgetJavaScriptError>
+
+private final class WidgetsJSRuntime {
+  static let shared = WidgetsJSRuntime()
+
+  private let lock = NSRecursiveLock()
+  private var context: JSContext?
+  private var bundleScript: String?
+  private var layoutCache: [String: JSValue] = [:]
+
+  private init() {}
+
+  func render(layout: String, props: [String: Any], environment: [String: Any]) -> WidgetJavaScriptResult<[String: Any]> {
+    call(layout: layout, functionName: "__expoWidgetRender", arguments: [props, environment]).flatMap { result in
+      guard let renderedNode = result?.toObject() as? [String: Any] else {
+        return .failure(WidgetJavaScriptError(message: "Expo widget render did not produce any results."))
+      }
+      return .success(renderedNode)
+    }
+  }
+
+  func handlePress(layout: String, props: [String: Any], environment: [String: Any]) -> WidgetJavaScriptResult<[String: Any]?> {
+    call(layout: layout, functionName: "__expoWidgetHandlePress", arguments: [props, environment])
+      .map { $0?.toObject() as? [String: Any] }
+  }
+
+  private func call(layout: String, functionName: String, arguments: [Any]) -> WidgetJavaScriptResult<JSValue?> {
+    lock.lock()
+    defer { lock.unlock() }
+
+    guard let context = getContext() else {
+      return .failure(WidgetJavaScriptError(message: "Could not create context for layout evaluation."))
+    }
+    guard let layoutValue = getLayoutValue(layout, in: context) else {
+      return .failure(WidgetJavaScriptError(message: contextExceptionMessage(context) ?? "Could not evaluate layout."))
+    }
+
+    context.exception = nil
+    context.setObject(layoutValue, forKeyedSubscript: "__expoWidgetLayout" as NSString)
+
+    let function = context.objectForKeyedSubscript(functionName)
+    guard let function, function.isObject else {
+      return .failure(WidgetJavaScriptError(message: "Expo widget runtime function \(functionName) is unavailable."))
+    }
+
+    let result = function.call(withArguments: arguments)
+    if let exceptionMessage = contextExceptionMessage(context) {
+      return .failure(WidgetJavaScriptError(message: exceptionMessage))
+    }
+    return .success(result)
+  }
+
+  private func getContext() -> JSContext? {
+    if let context {
+      return context
+    }
+
+    guard let context = JSContext() else {
+      return nil
+    }
+
+    guard let script = getBundleScript() else {
+      print("[ExpoWidgets] Missing ExpoWidgets.bundle")
+      return nil
+    }
+
+    context.evaluateScript(script)
+    if let exceptionMessage = contextExceptionMessage(context) {
+      print("[ExpoWidgets] Bundle evaluation failed: \(exceptionMessage)")
+      return nil
+    }
+
+    self.context = context
+    return context
+  }
+
+  private func getBundleScript() -> String? {
+    if let bundleScript {
+      return bundleScript
+    }
+
+    guard let bundleURL = Bundle.main.url(forResource: "ExpoWidgets", withExtension: "bundle"),
+          let bundle = Bundle(url: bundleURL),
+          let url = bundle.url(forResource: "ExpoWidgets", withExtension: "bundle"),
+          let script = try? String(contentsOf: url, encoding: .utf8) else {
+      return nil
+    }
+
+    bundleScript = script
+    return script
+  }
+
+  private func getLayoutValue(_ layout: String, in context: JSContext) -> JSValue? {
+    if let layoutValue = layoutCache[layout] {
+      return layoutValue
+    }
+
+    context.exception = nil
+    guard let layoutValue = context.evaluateScript("(\(layout))"),
+          !layoutValue.isUndefined else {
+      return nil
+    }
+    guard context.exception == nil else {
+      return nil
+    }
+
+    layoutCache[layout] = layoutValue
+    return layoutValue
+  }
+
+  private func contextExceptionMessage(_ context: JSContext) -> String? {
+    guard let exception = context.exception else {
+      return nil
+    }
+
+    context.exception = nil
+    return exception.toString() ?? "Unknown JavaScript exception."
+  }
+}
+
+func evaluateWidgetLayout(
+  layout: String,
+  props: [String: Any],
+  environment: [String: Any]
+) -> WidgetJavaScriptResult<[String: Any]> {
+  WidgetsJSRuntime.shared.render(layout: layout, props: props, environment: environment)
+}
+
+func evaluateWidgetButtonPress(
+  layout: String,
+  props: [String: Any],
+  environment: [String: Any]
+) -> WidgetJavaScriptResult<[String: Any]?> {
+  WidgetsJSRuntime.shared.handlePress(layout: layout, props: props, environment: environment)
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-widgets",
-  "version": "56.0.8",
+  "version": "56.0.10",
   "description": "Widgets.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -22,7 +22,7 @@
   "homepage": "https://docs.expo.dev/versions/latest/sdk/widgets/",
   "dependencies": {
     "@expo/plist": "^0.6.0",
-    "@expo/ui": "~56.0.7"
+    "@expo/ui": "~56.0.9"
   },
   "devDependencies": {
     "@expo/spawn-async": "^1.7.2",
@@ -30,7 +30,7 @@
     "@types/react": "~19.2.0",
     "react-native": "0.85.3",
     "resolve-workspace-root": "^2.0.0",
-    "expo": "56.0.0-preview.11",
+    "expo": "56.0.0-preview.13",
     "expo-module-scripts": "56.0.2"
   },
   "peerDependencies": {
@@ -44,7 +44,7 @@
       "./scripts/xcode-build-bundle.sh"
     ]
   },
-  "gitHead": "51c27fce31a5b3a877a4b05d832dabf4a99db5e1",
+  "gitHead": "290368bc41026449a05a4ebf991b85c3a2fb0e3a",
   "scripts": {
     "build": "expo-module build",
     "build:plugin": "expo-module build plugin",

package/plugin/build/withWidgetSourceFiles.js

@@ -40,31 +40,71 @@ const plist_1 = __importDefault(require("@expo/plist"));
 const config_plugins_1 = require("expo/config-plugins");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const withWidgetSourceFiles = (config, { widgets, targetName, onFilesGenerated, groupIdentifier }) => (0, config_plugins_1.withDangerousMod)(config, [
-    'ios',
-    async (config) => {
-        const projectRoot = config.modRequest.platformProjectRoot;
-        const targetDirectory = path.join(projectRoot, targetName);
-        const existingInfoPlistPath = path.join(targetDirectory, 'Info.plist');
-        const existingInfoPlist = fs.existsSync(existingInfoPlistPath)
-            ? fs.readFileSync(existingInfoPlistPath, 'utf8')
-            : null;
-        if (fs.existsSync(targetDirectory)) {
-            fs.rmSync(targetDirectory, { recursive: true, force: true });
+const WidgetFamily_type_1 = require("./types/WidgetFamily.type");
+const VALID_WIDGET_FAMILIES = new Set(Object.values(WidgetFamily_type_1.WidgetFamily));
+function assertSwiftIdentifier(value, label) {
+    if (typeof value !== 'string' || !/^[A-Za-z_][A-Za-z0-9_]*$/.test(value)) {
+        throw new Error(`Invalid ${label} ${JSON.stringify(value)}: must be a Swift identifier.`);
+    }
+}
+function assertWidgetFamily(value) {
+    if (typeof value !== 'string' || !VALID_WIDGET_FAMILIES.has(value)) {
+        throw new Error(`Invalid supportedFamilies entry ${JSON.stringify(value)}: must be one of ${[...VALID_WIDGET_FAMILIES].join(', ')}.`);
+    }
+}
+function validateWidget(widget) {
+    assertSwiftIdentifier(widget.name, 'widget name');
+    for (const family of widget.supportedFamilies) {
+        assertWidgetFamily(family);
+    }
+    if (widget.configuration) {
+        for (const [paramName, param] of Object.entries(widget.configuration.parameters)) {
+            assertSwiftIdentifier(paramName, 'parameter name');
+            if (param.type === 'number' && typeof param.default !== 'number') {
+                throw new Error(`Invalid default for ${JSON.stringify(paramName)}: must be a number.`);
+            }
+            else if (param.type === 'boolean' && typeof param.default !== 'boolean') {
+                throw new Error(`Invalid default for ${JSON.stringify(paramName)}: must be a boolean.`);
+            }
+            else if (param.type === 'enum') {
+                assertSwiftIdentifier(param.default, `default for ${JSON.stringify(paramName)}`);
+                for (const value of param.values) {
+                    assertSwiftIdentifier(value.value, `enum case for ${JSON.stringify(paramName)}`);
+                }
+            }
         }
-        fs.mkdirSync(targetDirectory, { recursive: true });
-        const entitlementsPath = path.join(targetDirectory, `${targetName}.entitlements`);
-        const entitlementsContent = {
-            'com.apple.security.application-groups': [groupIdentifier],
-        };
-        fs.writeFileSync(entitlementsPath, plist_1.default.build(entitlementsContent));
-        const infoPlistPath = createInfoPlist(groupIdentifier, targetDirectory, config.ios?.version ?? config.version ?? '1.0', config.ios?.buildNumber ?? '1', existingInfoPlist);
-        const indexSwiftPath = createIndexSwift(widgets, targetDirectory);
-        const widgetSwiftPaths = widgets.map((widget) => createWidgetSwift(widget, targetDirectory));
-        onFilesGenerated([entitlementsPath, infoPlistPath, indexSwiftPath, ...widgetSwiftPaths]);
-        return config;
-    },
-]);
+    }
+}
+const withWidgetSourceFiles = (config, { widgets, targetName, onFilesGenerated, groupIdentifier }) => {
+    for (const widget of widgets) {
+        validateWidget(widget);
+    }
+    return (0, config_plugins_1.withDangerousMod)(config, [
+        'ios',
+        async (config) => {
+            const projectRoot = config.modRequest.platformProjectRoot;
+            const targetDirectory = path.join(projectRoot, targetName);
+            const existingInfoPlistPath = path.join(targetDirectory, 'Info.plist');
+            const existingInfoPlist = fs.existsSync(existingInfoPlistPath)
+                ? fs.readFileSync(existingInfoPlistPath, 'utf8')
+                : null;
+            if (fs.existsSync(targetDirectory)) {
+                fs.rmSync(targetDirectory, { recursive: true, force: true });
+            }
+            fs.mkdirSync(targetDirectory, { recursive: true });
+            const entitlementsPath = path.join(targetDirectory, `${targetName}.entitlements`);
+            const entitlementsContent = {
+                'com.apple.security.application-groups': [groupIdentifier],
+            };
+            fs.writeFileSync(entitlementsPath, plist_1.default.build(entitlementsContent));
+            const infoPlistPath = createInfoPlist(groupIdentifier, targetDirectory, config.ios?.version ?? config.version ?? '1.0', config.ios?.buildNumber ?? '1', existingInfoPlist);
+            const indexSwiftPath = createIndexSwift(widgets, targetDirectory);
+            const widgetSwiftPaths = widgets.map((widget) => createWidgetSwift(widget, targetDirectory));
+            onFilesGenerated([entitlementsPath, infoPlistPath, indexSwiftPath, ...widgetSwiftPaths]);
+            return config;
+        },
+    ]);
+};
 const createIndexSwift = (widgets, targetPath) => {
     const indexFilePath = path.join(targetPath, `index.swift`);
     const numberOfWidgets = widgets.length;
@@ -138,8 +178,8 @@ struct ${widget.name}: Widget {
     StaticConfiguration(kind: name, provider: WidgetsTimelineProvider(name: name)) { entry in
       WidgetsEntryView(entry: entry)
     }
-    .configurationDisplayName("${widget.displayName}")
-    .description("${widget.description}")
+    .configurationDisplayName(${JSON.stringify(widget.displayName)})
+    .description(${JSON.stringify(widget.description)})
     .supportedFamilies([.${widget.supportedFamilies.join(', .')}])${widget.contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
   }
 }`;
@@ -150,8 +190,8 @@ internal import ExpoWidgets
 
 // AppIntent
 struct ${widget.name}ConfigurationAppIntent: WidgetConfigurationIntent {
-  static var title: LocalizedStringResource = "${widget.configuration?.title ?? widget.displayName} Configuration"
-${widget.configuration?.description ? `  static var description: LocalizedStringResource = "${widget.configuration?.description}"\n` : ''}
+  static var title: LocalizedStringResource = ${JSON.stringify(`${widget.configuration?.title ?? widget.displayName} Configuration`)}
+${widget.configuration?.description ? `  static var description: LocalizedStringResource = ${JSON.stringify(widget.configuration.description)}\n` : ''}
 ${Object.entries(widget.configuration?.parameters ?? {})
         .map(([name, param]) => {
         let paramType;
@@ -171,7 +211,7 @@ ${Object.entries(widget.configuration?.parameters ?? {})
             default:
                 paramType = 'String';
         }
-        return `  @Parameter(title: "${param.title}", default: ${param.type === 'string' ? `"${param.default}"` : param.type === 'number' ? param.default : param.type === 'boolean' ? param.default : `${widget.name}${name[0]?.toUpperCase() + name.slice(1)}Enum.${param.default}`})\n  var ${name}: ${paramType}`;
+        return `  @Parameter(title: ${JSON.stringify(param.title)}, default: ${param.type === 'string' ? JSON.stringify(param.default) : param.type === 'number' ? param.default : param.type === 'boolean' ? param.default : `${widget.name}${name[0]?.toUpperCase() + name.slice(1)}Enum.${param.default}`})\n  var ${name}: ${paramType}`;
     })
         .join('\n')}
 
@@ -192,12 +232,12 @@ enum ${paramTypeName}: String, CaseIterable, AppEnum {
         })
             .join('\n  ')}
 
-  static var typeDisplayRepresentation = TypeDisplayRepresentation(name: "${param.title}")
+  static var typeDisplayRepresentation = TypeDisplayRepresentation(name: ${JSON.stringify(param.title)})
 
   static var caseDisplayRepresentations: [${paramTypeName}: DisplayRepresentation] = [
     ${param.values
             .map((value) => {
-            return `.${value.value}: DisplayRepresentation(title: "${value.name}")`;
+            return `.${value.value}: DisplayRepresentation(title: ${JSON.stringify(value.name)})`;
         })
             .join(',\n    ')}
   ]
@@ -297,8 +337,8 @@ struct ${widget.name}: Widget {
     return AppIntentConfiguration(kind: name, intent: ${widget.name}ConfigurationAppIntent.self, provider: ${widget.name}TimelineProvider()) { entry in
       ${widget.name}EntryView(entry: entry)
     }
-    .configurationDisplayName("${widget.displayName}")
-    .description("${widget.description}")
+    .configurationDisplayName(${JSON.stringify(widget.displayName)})
+    .description(${JSON.stringify(widget.description)})
     .supportedFamilies([.${widget.supportedFamilies.join(', .')}])${widget.contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
   }
 }`;

package/plugin/src/withWidgetSourceFiles.ts

@@ -4,6 +4,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 
 import { WidgetConfig } from './types/WidgetConfig.type';
+import { WidgetFamily } from './types/WidgetFamily.type';
 
 type WidgetSourceFilesProps = {
   targetName: string;
@@ -12,11 +13,52 @@ type WidgetSourceFilesProps = {
   onFilesGenerated: (files: string[]) => void;
 };
 
+const VALID_WIDGET_FAMILIES: ReadonlySet<string> = new Set(Object.values(WidgetFamily));
+
+function assertSwiftIdentifier(value: unknown, label: string): asserts value is string {
+  if (typeof value !== 'string' || !/^[A-Za-z_][A-Za-z0-9_]*$/.test(value)) {
+    throw new Error(`Invalid ${label} ${JSON.stringify(value)}: must be a Swift identifier.`);
+  }
+}
+
+function assertWidgetFamily(value: unknown): asserts value is WidgetFamily {
+  if (typeof value !== 'string' || !VALID_WIDGET_FAMILIES.has(value)) {
+    throw new Error(
+      `Invalid supportedFamilies entry ${JSON.stringify(value)}: must be one of ${[...VALID_WIDGET_FAMILIES].join(', ')}.`
+    );
+  }
+}
+
+function validateWidget(widget: WidgetConfig): void {
+  assertSwiftIdentifier(widget.name, 'widget name');
+  for (const family of widget.supportedFamilies) {
+    assertWidgetFamily(family);
+  }
+  if (widget.configuration) {
+    for (const [paramName, param] of Object.entries(widget.configuration.parameters)) {
+      assertSwiftIdentifier(paramName, 'parameter name');
+      if (param.type === 'number' && typeof param.default !== 'number') {
+        throw new Error(`Invalid default for ${JSON.stringify(paramName)}: must be a number.`);
+      } else if (param.type === 'boolean' && typeof param.default !== 'boolean') {
+        throw new Error(`Invalid default for ${JSON.stringify(paramName)}: must be a boolean.`);
+      } else if (param.type === 'enum') {
+        assertSwiftIdentifier(param.default, `default for ${JSON.stringify(paramName)}`);
+        for (const value of param.values) {
+          assertSwiftIdentifier(value.value, `enum case for ${JSON.stringify(paramName)}`);
+        }
+      }
+    }
+  }
+}
+
 const withWidgetSourceFiles: ConfigPlugin<WidgetSourceFilesProps> = (
   config,
   { widgets, targetName, onFilesGenerated, groupIdentifier }
-) =>
-  withDangerousMod(config, [
+) => {
+  for (const widget of widgets) {
+    validateWidget(widget);
+  }
+  return withDangerousMod(config, [
     'ios',
     async (config) => {
       const projectRoot = config.modRequest.platformProjectRoot;
@@ -50,6 +92,7 @@ const withWidgetSourceFiles: ConfigPlugin<WidgetSourceFilesProps> = (
       return config;
     },
   ]);
+};
 
 const createIndexSwift = (widgets: WidgetConfig[], targetPath: string): string => {
   const indexFilePath = path.join(targetPath, `index.swift`);
@@ -143,8 +186,8 @@ struct ${widget.name}: Widget {
     StaticConfiguration(kind: name, provider: WidgetsTimelineProvider(name: name)) { entry in
       WidgetsEntryView(entry: entry)
     }
-    .configurationDisplayName("${widget.displayName}")
-    .description("${widget.description}")
+    .configurationDisplayName(${JSON.stringify(widget.displayName)})
+    .description(${JSON.stringify(widget.description)})
     .supportedFamilies([.${widget.supportedFamilies.join(', .')}])${widget.contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
   }
 }`;
@@ -155,8 +198,8 @@ internal import ExpoWidgets
 
 // AppIntent
 struct ${widget.name}ConfigurationAppIntent: WidgetConfigurationIntent {
-  static var title: LocalizedStringResource = "${widget.configuration?.title ?? widget.displayName} Configuration"
-${widget.configuration?.description ? `  static var description: LocalizedStringResource = "${widget.configuration?.description}"\n` : ''}
+  static var title: LocalizedStringResource = ${JSON.stringify(`${widget.configuration?.title ?? widget.displayName} Configuration`)}
+${widget.configuration?.description ? `  static var description: LocalizedStringResource = ${JSON.stringify(widget.configuration.description)}\n` : ''}
 ${Object.entries(widget.configuration?.parameters ?? {})
   .map(([name, param]) => {
     let paramType: string;
@@ -176,7 +219,7 @@ ${Object.entries(widget.configuration?.parameters ?? {})
       default:
         paramType = 'String';
     }
-    return `  @Parameter(title: "${param.title}", default: ${param.type === 'string' ? `"${param.default}"` : param.type === 'number' ? param.default : param.type === 'boolean' ? param.default : `${widget.name}${name[0]?.toUpperCase() + name.slice(1)}Enum.${param.default}`})\n  var ${name}: ${paramType}`;
+    return `  @Parameter(title: ${JSON.stringify(param.title)}, default: ${param.type === 'string' ? JSON.stringify(param.default) : param.type === 'number' ? param.default : param.type === 'boolean' ? param.default : `${widget.name}${name[0]?.toUpperCase() + name.slice(1)}Enum.${param.default}`})\n  var ${name}: ${paramType}`;
   })
   .join('\n')}
 
@@ -196,12 +239,12 @@ enum ${paramTypeName}: String, CaseIterable, AppEnum {
     })
     .join('\n  ')}
 
-  static var typeDisplayRepresentation = TypeDisplayRepresentation(name: "${param.title}")
+  static var typeDisplayRepresentation = TypeDisplayRepresentation(name: ${JSON.stringify(param.title)})
 
   static var caseDisplayRepresentations: [${paramTypeName}: DisplayRepresentation] = [
     ${param.values
       .map((value) => {
-        return `.${value.value}: DisplayRepresentation(title: "${value.name}")`;
+        return `.${value.value}: DisplayRepresentation(title: ${JSON.stringify(value.name)})`;
       })
       .join(',\n    ')}
   ]
@@ -301,8 +344,8 @@ struct ${widget.name}: Widget {
     return AppIntentConfiguration(kind: name, intent: ${widget.name}ConfigurationAppIntent.self, provider: ${widget.name}TimelineProvider()) { entry in
       ${widget.name}EntryView(entry: entry)
     }
-    .configurationDisplayName("${widget.displayName}")
-    .description("${widget.description}")
+    .configurationDisplayName(${JSON.stringify(widget.displayName)})
+    .description(${JSON.stringify(widget.description)})
     .supportedFamilies([.${widget.supportedFamilies.join(', .')}])${widget.contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
   }
 }`;

package/plugin/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/index.ts","./src/withappgroupentitlements.ts","./src/withappinfoplist.ts","./src/witheasconfig.ts","./src/withioswarning.ts","./src/withpodslinking.ts","./src/withpushnotifications.ts","./src/withwidgetsourcefiles.ts","./src/types/widgetconfig.type.ts","./src/types/widgetfamily.type.ts","./src/xcode/addbuildphases.ts","./src/xcode/addpbxgroup.ts","./src/xcode/addproductfile.ts","./src/xcode/addtargetdependency.ts","./src/xcode/addtopbxnativetargetsection.ts","./src/xcode/addtopbxprojectsection.ts","./src/xcode/addxcconfigurationlist.ts","./src/xcode/withtargetxcodeproject.ts"],"version":"5.9.2"}

package/spm.config.json

@@ -12,6 +12,7 @@
         "React",
         "Hermes",
         "expo-modules-core/ExpoModulesCore",
+        "expo-modules-core/ExpoModulesWorklets",
         "@expo/ui/ExpoUI"
       ],
       "targets": [
@@ -25,6 +26,7 @@
             "React",
             "Hermes",
             "expo-modules-core/ExpoModulesCore",
+            "expo-modules-core/ExpoModulesWorklets",
             "@expo/ui/ExpoUI"
           ],
           "linkedFrameworks": [

package/ios/Widgets/WidgetContext.swift

@@ -1,23 +0,0 @@
-import Foundation
-import JavaScriptCore
-
-func createWidgetContext(layout: String) -> JSContext? {
-  guard let context = JSContext() else {
-    return nil
-  }
-
-  // Inject ExpoUI bundle
-  guard let bundleURL = Bundle.main.url(forResource: "ExpoWidgets", withExtension: "bundle"),
-        let bundle = Bundle(url: bundleURL),
-        let url = bundle.url(forResource: "ExpoWidgets", withExtension: "bundle"),
-        let bundleJS = try? String(contentsOf: url, encoding: .utf8) else {
-    print("[ExpoWidgets] Missing ExpoWidgets.bundle")
-    return nil
-  }
-  context.evaluateScript(bundleJS)
-
-  // Inject layout
-  let layoutValue = context.evaluateScript("(\(layout))")
-  context.setObject(layoutValue, forKeyedSubscript: "__expoWidgetLayout" as NSString)
-  return context
-}