expo-widgets 56.0.0 → 56.0.2

package/CHANGELOG.md

@@ -10,6 +10,14 @@
 
 ### 💡 Others
 
+## 56.0.2 — 2026-05-06
+
+_This version does not introduce any user-facing changes._
+
+## 56.0.1 — 2026-05-05
+
+_This version does not introduce any user-facing changes._
+
 ## 56.0.0 — 2026-05-05
 
 ### 🛠 Breaking changes
@@ -23,6 +31,7 @@
 - Support `PlatformColor`. ([#44193](https://github.com/expo/expo/pull/44193) by [@jakex7](https://github.com/jakex7))
 - [plugin] Make incremental prebuilds work ([#45157](https://github.com/expo/expo/pull/45157) by [@jakex7](https://github.com/jakex7))
 - [android] Add stub methods. ([#45335](https://github.com/expo/expo/pull/45335) by [@jakex7](https://github.com/jakex7))
+- Add widget RedBox. ([#45402](https://github.com/expo/expo/pull/45402) by [@jakex7](https://github.com/jakex7))
 
 ### 🐛 Bug fixes
 

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-present 650 Industries, Inc. (aka Expo)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/ios/Widgets/AppIntent.swift

@@ -1,6 +1,28 @@
 import AppIntents
 import WidgetKit
 
+struct WidgetReload: AppIntent {
+  // title is not used for non-discoverable intents, but it is required
+  static var title: LocalizedStringResource = "Reload widget"
+  static var isDiscoverable: Bool = false
+  @Parameter(title: "source")
+  var source: String?
+
+  init() {}
+  init(source: String?) {
+    self.source = source
+  }
+
+  func perform() async throws -> some IntentResult {
+    guard let source else {
+      return .result()
+    }
+
+    WidgetCenter.shared.reloadTimelines(ofKind: source)
+    return .result()
+  }
+}
+
 @available(iOS 16.0, *)
 struct WidgetUserInteraction: AppIntent {
   // title is not used for non-discoverable intents, but it is required

package/ios/Widgets/DynamicView.swift

@@ -104,11 +104,21 @@ public struct WidgetsDynamicView: View, ExpoSwiftUI.AnyChild {
       render(FragmentView.self, FragmentProps.self, updateProps: updateChildren)
     case "LinkView":
       render(LinkView.self, LinkViewProps.self, updateProps: updateChildren)
+#if DEBUG
+    case "RedBoxView":
+      render(RedBoxView.self, RedBoxViewProps.self) { redBoxProps in
+        redBoxProps.source = name
+        redBoxProps.kind = kind
+      }
     default:
       ZStack {
         Color.red.opacity(0.5)
         Text("Unable to get the view for: \(node["type"] as? String ?? "undefined")")
       }
+#else
+    default:
+      EmptyView()
+#endif
     }
   }
 

package/ios/Widgets/RedBoxView.swift

@@ -0,0 +1,83 @@
+import ExpoModulesCore
+import SwiftUI
+import ExpoUI
+
+public final class RedBoxViewProps: UIBaseViewProps {
+  @Field var message: String
+  @Field var source: String?
+  @Field var stack: String?
+  var kind: WidgetsKind = .widget
+}
+
+public struct RedBoxView: ExpoSwiftUI.View {
+  @ObservedObject public var props: RedBoxViewProps
+
+  public init(props: RedBoxViewProps) {
+    self.props = props
+  }
+
+  public var body: some View {
+    FullSizeZStack(kind: props.kind) {
+      Color.red
+      VStack(alignment: .leading, spacing: 2) {
+        HStack(spacing: 6) {
+          Image(systemName: "exclamationmark.triangle.fill")
+          Text("Error").font(.headline)
+          Spacer()
+          if #available(iOS 17.0, *) {
+            Button(intent: WidgetReload(source: props.source)) {
+              Image(systemName: "arrow.clockwise")
+            }
+              .buttonStyle(.plain)
+              .padding(4)
+          }
+        }
+        .foregroundStyle(.white)
+
+        Text(props.message)
+          .font(.system(size: 14).bold().monospaced())
+          .foregroundStyle(.white.opacity(0.9))
+          .modifier(RedBoxBody())
+
+        if let stack = props.stack, !stack.isEmpty {
+          Text(stack)
+            .font(.system(size: 11).monospaced())
+            .foregroundStyle(.white.opacity(0.75))
+            .modifier(RedBoxBody())
+        }
+      }
+      .padding(12)
+      .frame(maxWidth: .infinity, maxHeight: .infinity, alignment: .topLeading)
+    }
+  }
+}
+
+private struct RedBoxBody: ViewModifier {
+  @ViewBuilder
+  func body(content: Content) -> some View {
+    let base = content.lineLimit(nil).fixedSize(horizontal: false, vertical: true)
+    if #available(iOS 26.0, *) {
+      base.lineHeight(.tight)
+    } else {
+      base
+    }
+  }
+}
+
+public struct FullSizeZStack<Content: View>: View {
+  let kind: WidgetsKind
+  let content: Content
+
+  init(kind: WidgetsKind = .widget, @ViewBuilder _ content: () -> Content) {
+    self.kind = kind
+    self.content = content()
+  }
+
+  public var body: some View {
+    if #available(iOS 17.0, *), kind == .widget {
+      ZStack { content }.containerRelativeFrame([.horizontal, .vertical])
+    } else {
+      ZStack { content }.frame(maxWidth: .infinity)
+    }
+  }
+}

package/ios/Widgets/Utils.swift

@@ -20,6 +20,14 @@ func parseTimeline(identifier: String, name: String, family: WidgetFamily) -> [W
   return entries.compactMap(\.self)
 }
 
+func createRedBox(message: String, stack: String? = nil) -> [String: Any] {
+  var props: [String: Any] = ["message": message]
+  if let stack {
+    props["stack"] = stack
+  }
+  return ["type": "RedBoxView", "props": props]
+}
+
 func evaluateLayout(
   layout: String,
   props: [String: Any],
@@ -32,6 +40,10 @@ func evaluateLayout(
   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]
 }
 
@@ -49,6 +61,12 @@ func getLiveActivityNodes(forName name: String, props: String = "{}", environmen
   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())]
+  }
+
   return result?.toObject() as? [String: Any] ?? [:]
 }
 

package/ios/Widgets/WidgetContext.swift

@@ -6,12 +6,6 @@ func createWidgetContext(layout: String) -> JSContext? {
     return nil
   }
 
-  context.exceptionHandler = { _, exception in
-    if let exception {
-      print("[ExpoWidgets] Layout evaluation failed: \(exception)")
-    }
-  }
-
   // Inject ExpoUI bundle
   guard let bundleURL = Bundle.main.url(forResource: "ExpoWidgets", withExtension: "bundle"),
         let bundle = Bundle(url: bundleURL),

package/package.json

@@ -1,19 +1,9 @@
 {
   "name": "expo-widgets",
-  "version": "56.0.0",
+  "version": "56.0.2",
   "description": "Widgets.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
-  "scripts": {
-    "build": "expo-module build",
-    "build:plugin": "expo-module build plugin",
-    "build:bundle": "node ./scripts/build-bundle.mjs",
-    "clean": "expo-module clean",
-    "lint": "expo-module lint",
-    "test": "expo-module test",
-    "prepublishOnly": "expo-module prepublishOnly",
-    "expo-module": "expo-module"
-  },
   "keywords": [
     "react-native",
     "expo",
@@ -31,21 +21,31 @@
   "license": "MIT",
   "homepage": "https://docs.expo.dev/versions/latest/sdk/widgets/",
   "dependencies": {
-    "@expo/plist": "0.6.0",
-    "@expo/ui": "56.0.0"
+    "@expo/plist": "^0.6.0",
+    "@expo/ui": "~56.0.1"
   },
   "devDependencies": {
     "@expo/spawn-async": "^1.7.2",
     "@types/node": "^22.14.0",
     "@types/react": "~19.2.0",
-    "expo-module-scripts": "56.0.0",
     "react-native": "0.85.2",
-    "resolve-workspace-root": "^2.0.0"
+    "resolve-workspace-root": "^2.0.0",
+    "expo": "56.0.0-preview.3",
+    "expo-module-scripts": "56.0.1"
   },
   "peerDependencies": {
-    "expo": "56.0.0-preview.0",
+    "expo": "*",
     "react": "*",
     "react-native": "*"
   },
-  "gitHead": "6dcd9ce9d615d25df78597f60520492e35e02efb"
-}
+  "gitHead": "71ec800b2fa6133d22d69b70945132e22f1b7ae8",
+  "scripts": {
+    "build": "expo-module build",
+    "build:plugin": "expo-module build plugin",
+    "build:bundle": "node ./scripts/build-bundle.mjs",
+    "clean": "expo-module clean",
+    "lint": "expo-module lint",
+    "test": "expo-module test",
+    "expo-module": "expo-module"
+  }
+}

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"}