expo-widgets 55.0.2 → 55.0.4

package/CHANGELOG.md

@@ -10,11 +10,29 @@
 
 ### 💡 Others
 
+## 55.0.4 — 2026-03-11
+
+### 🛠 Breaking changes
+
+- Pass environment to Widgets and Live Activities. ([#43681](https://github.com/expo/expo/pull/43681) by [@jakex7](https://github.com/jakex7))
+
+### 🐛 Bug fixes
+
+- Filter out invalid children. ([#43720](https://github.com/expo/expo/pull/43720) by [@jakex7](https://github.com/jakex7))
+
+## 55.0.3 — 2026-03-05
+
+### 🐛 Bug fixes
+
+- [plugin] Fix reading undefined when config is not provided. ([#43568](https://github.com/expo/expo/pull/43568) by [@jakex7](https://github.com/jakex7))
+- Skip server bundling in `export:embed` call for `expo-widgets` bundle ([#43602](https://github.com/expo/expo/pull/43602) by [@kitten](https://github.com/kitten))
+
 ## 55.0.2 — 2026-02-26
 
 ### 🎉 New features
 
 - Add support for `after(date)` dismissal policy, final content state, and `contentDate` when ending a Live Activity. ([#43472](https://github.com/expo/expo/pull/43472) by [@jakex7](https://github.com/jakex7))
+- [plugin] Add `contentMarginsDisabled`. ([#43799](https://github.com/expo/expo/pull/43799) by [@jakex7](https://github.com/jakex7))
 
 ### 🐛 Bug fixes
 

package/build/Widgets.d.ts

@@ -1,12 +1,12 @@
 import { type EventSubscription } from 'expo-modules-core';
-import type { ExpoWidgetsEvents, LiveActivityComponent, LiveActivityDismissalPolicy, NativeLiveActivity, PushTokenEvent, WidgetBase, WidgetTimelineEntry } from './Widgets.types';
+import type { ExpoWidgetsEvents, LiveActivityComponent, LiveActivityDismissalPolicy, NativeLiveActivity, PushTokenEvent, WidgetEnvironment, WidgetTimelineEntry } from './Widgets.types';
 /**
  * Represents a widget instance. Provides methods to manage the widget's timeline.
  */
 export declare class Widget<T extends object = object> {
     /** @hidden */
     private nativeWidgetObject;
-    constructor(name: string, layout: (p: WidgetBase<T>) => React.JSX.Element);
+    constructor(name: string, layout: (props: T, environment: WidgetEnvironment) => React.JSX.Element);
     /**
      * Force reloads the widget, causing it to refresh its content and timeline.
      */
@@ -91,7 +91,7 @@ export declare function after(date: Date): {
  * @param name The widget name. Must match the `'name'` field in your widget configuration in the app config.
  * @param widget The widget component, marked with the `'widget'` directive.
  */
-export declare function createWidget<T extends object = object>(name: string, widget: (props: WidgetBase<T>) => React.JSX.Element): Widget<T>;
+export declare function createWidget<T extends object = object>(name: string, widget: (props: T, context: WidgetEnvironment) => React.JSX.Element): Widget<T>;
 /**
  * Creates a Live Activity Factory for managing Live Activities of a specific type.
  * @param name The Live Activity name. Must match the `'name'` field in your widget configuration in the app config.

package/build/Widgets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Widgets.d.ts","sourceRoot":"","sources":["../src/Widgets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,2BAA2B,EAC3B,kBAAkB,EAGlB,cAAc,EACd,UAAU,EACV,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,qBAAa,MAAM,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC3C,cAAc;IACd,OAAO,CAAC,kBAAkB,CAAqB;gBACnC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,OAAO;IAIzE;;OAEG;IACH,MAAM;IAIN;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE;IAMhD;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,CAAC;IAIvB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;CAMvD;AAED;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACjD,cAAc;IACd,OAAO,CAAC,kBAAkB,CAAqB;gBACnC,kBAAkB,EAAE,kBAAkB;IAIlD;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/B;;;;;;OAMG;IACH,GAAG,CAAC,eAAe,CAAC,EAAE,2BAA2B,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBhG;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAItC;;;;;OAKG;IACH,oBAAoB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,iBAAiB;CAGnF;AAED;;GAEG;AACH,qBAAa,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACxD,cAAc;IACd,OAAO,CAAC,yBAAyB,CAA4B;gBACjD,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAO1D;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM;IAI5B;;OAEG;IACH,YAAY;CAKb;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACpD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,OAAO,GAClD,MAAM,CAAC,CAAC,CAAC,CAEX;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC1D,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,qBAAqB,CAAC,CAAC,CAAC,GACrC,mBAAmB,CAAC,CAAC,CAAC,CAExB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,iBAAiB,CAAC,8BAA8B,CAAC,GAC1D,iBAAiB,CAEnB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,iBAAiB,CAAC,uCAAuC,CAAC,GACnE,iBAAiB,CAEnB"}
+{"version":3,"file":"Widgets.d.ts","sourceRoot":"","sources":["../src/Widgets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,2BAA2B,EAC3B,kBAAkB,EAGlB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,qBAAa,MAAM,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC3C,cAAc;IACd,OAAO,CAAC,kBAAkB,CAAqB;gBAE7C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,iBAAiB,KAAK,KAAK,CAAC,GAAG,CAAC,OAAO;IAKzE;;OAEG;IACH,MAAM;IAIN;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE;IAMhD;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,CAAC;IAIvB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;CAMvD;AAED;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACjD,cAAc;IACd,OAAO,CAAC,kBAAkB,CAAqB;gBACnC,kBAAkB,EAAE,kBAAkB;IAIlD;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/B;;;;;;OAMG;IACH,GAAG,CAAC,eAAe,CAAC,EAAE,2BAA2B,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBhG;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAItC;;;;;OAKG;IACH,oBAAoB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,iBAAiB;CAGnF;AAED;;GAEG;AACH,qBAAa,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACxD,cAAc;IACd,OAAO,CAAC,yBAAyB,CAA4B;gBACjD,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAO1D;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM;IAI5B;;OAEG;IACH,YAAY;CAKb;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACpD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,iBAAiB,KAAK,KAAK,CAAC,GAAG,CAAC,OAAO,GAClE,MAAM,CAAC,CAAC,CAAC,CAEX;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC1D,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,qBAAqB,CAAC,CAAC,CAAC,GACrC,mBAAmB,CAAC,CAAC,CAAC,CAExB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,iBAAiB,CAAC,8BAA8B,CAAC,GAC1D,iBAAiB,CAEnB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,iBAAiB,CAAC,uCAAuC,CAAC,GACnE,iBAAiB,CAEnB"}

package/build/Widgets.js.map

@@ -1 +1 @@
-{"version":3,"file":"Widgets.js","sourceRoot":"","sources":["../src/Widgets.ts"],"names":[],"mappings":"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","sourcesContent":["import { type EventSubscription } from 'expo-modules-core';\n\nimport ExpoWidgetsModule from './ExpoWidgets';\nimport type {\n  ExpoWidgetsEvents,\n  LiveActivityComponent,\n  LiveActivityDismissalPolicy,\n  NativeLiveActivity,\n  NativeLiveActivityFactory,\n  NativeWidgetObject,\n  PushTokenEvent,\n  WidgetBase,\n  WidgetTimelineEntry,\n} from './Widgets.types';\n\n/**\n * Represents a widget instance. Provides methods to manage the widget's timeline.\n */\nexport class Widget<T extends object = object> {\n  /** @hidden */\n  private nativeWidgetObject: NativeWidgetObject;\n  constructor(name: string, layout: (p: WidgetBase<T>) => React.JSX.Element) {\n    this.nativeWidgetObject = new ExpoWidgetsModule.Widget(name, layout as unknown as string);\n  }\n\n  /**\n   * Force reloads the widget, causing it to refresh its content and timeline.\n   */\n  reload() {\n    this.nativeWidgetObject.reload();\n  }\n\n  /**\n   * Schedules a series of updates for the widget's content and reloads the widget.\n   * @param entries Timeline entries, each specifying a date and the props to display at that time.\n   */\n  updateTimeline(entries: WidgetTimelineEntry<T>[]) {\n    this.nativeWidgetObject.updateTimeline(\n      entries.map((entry) => ({ timestamp: entry.date.getTime(), props: entry.props }))\n    );\n  }\n\n  /**\n   * Sets the widget's content to the given props immediately, without scheduling a timeline.\n   * @param props The properties to display in the widget.\n   */\n  updateSnapshot(props: T) {\n    this.nativeWidgetObject.updateTimeline([{ timestamp: Date.now(), props }]);\n  }\n\n  /**\n   * Returns the current timeline entries for the widget, including past and future entries.\n   */\n  async getTimeline(): Promise<WidgetTimelineEntry<T>[]> {\n    return (await this.nativeWidgetObject.getTimeline()).map((entry) => ({\n      date: new Date(entry.timestamp),\n      props: entry.props as T,\n    }));\n  }\n}\n\n/**\n * Represents a Live Activity instance. Provides methods to update its content and end it.\n */\nexport class LiveActivity<T extends object = object> {\n  /** @hidden */\n  private nativeLiveActivity: NativeLiveActivity;\n  constructor(nativeLiveActivity: NativeLiveActivity) {\n    this.nativeLiveActivity = nativeLiveActivity;\n  }\n\n  /**\n   * Updates the Live Activity's content. The UI reflects the new properties immediately.\n   * @param props The updated content properties.\n   */\n  update(props: T): Promise<void> {\n    return this.nativeLiveActivity.update(JSON.stringify(props));\n  }\n\n  /**\n   * Ends the Live Activity.\n   * @param dismissalPolicy Controls when the Live Activity is removed from the Lock Screen after ending.\n   * Can be `'default'`, `'immediate'`, or `after(date)`.\n   * @param props Final content properties to update after the activity ends.\n   * @param contentDate The time the data in the payload was generated. If this is older than a previous update or push payload, the system ignores this update.\n   */\n  end(dismissalPolicy?: LiveActivityDismissalPolicy, props?: T, contentDate?: Date): Promise<void> {\n    const serializedProps = props ? JSON.stringify(props) : undefined;\n    if (\n      typeof dismissalPolicy === 'object' &&\n      dismissalPolicy !== null &&\n      'after' in dismissalPolicy\n    ) {\n      return this.nativeLiveActivity.end(\n        'after',\n        dismissalPolicy.after?.getTime(),\n        serializedProps,\n        contentDate?.getTime()\n      );\n    }\n    return this.nativeLiveActivity.end(\n      dismissalPolicy,\n      undefined,\n      serializedProps,\n      contentDate?.getTime()\n    );\n  }\n\n  /**\n   * Returns the push token for this Live Activity, used to send push notification updates via APNs.\n   * Returns `null` if push notifications are not enabled or the token is not yet available.\n   */\n  getPushToken(): Promise<string | null> {\n    return this.nativeLiveActivity.getPushToken();\n  }\n\n  /**\n   * Adds a listener for push token update events on this Live Activity instance.\n   * The token can be used to send content updates to this specific activity via APNs.\n   * @param listener Callback invoked when a new push token is available.\n   * @returns An event subscription that can be used to remove the listener.\n   */\n  addPushTokenListener(listener: (event: PushTokenEvent) => void): EventSubscription {\n    return this.nativeLiveActivity.addListener('onExpoWidgetsTokenReceived', listener);\n  }\n}\n\n/**\n * Manages Live Activity instances of a specific type. Use it to start new activities and retrieve currently active ones.\n */\nexport class LiveActivityFactory<T extends object = object> {\n  /** @hidden */\n  private nativeLiveActivityFactory: NativeLiveActivityFactory;\n  constructor(name: string, layout: LiveActivityComponent<T>) {\n    this.nativeLiveActivityFactory = new ExpoWidgetsModule.LiveActivityFactory(\n      name,\n      layout as unknown as string\n    );\n  }\n\n  /**\n   * Starts a new Live Activity with the given properties.\n   * @param props The initial content properties for the Live Activity.\n   * @param url An optional URL to associate with the Live Activity, used for deep linking.\n   * @returns The new Live Activity instance.\n   */\n  start(props: T, url?: string) {\n    return new LiveActivity<T>(this.nativeLiveActivityFactory.start(JSON.stringify(props), url));\n  }\n\n  /**\n   * Returns all currently active instances of this Live Activity type.\n   */\n  getInstances() {\n    return this.nativeLiveActivityFactory\n      .getInstances()\n      .map((instance) => new LiveActivity<T>(instance));\n  }\n}\n\n/**\n * Creates a dismissal policy that removes the Live Activity at the specified time within a four-hour window.\n * @param date The date after which the Live Activity should be removed from the Lock Screen.\n * @hidden\n */\nexport function after(date: Date): { after: Date } {\n  return { after: date };\n}\n\n/**\n * Creates a Widget instance.\n * @param name The widget name. Must match the `'name'` field in your widget configuration in the app config.\n * @param widget The widget component, marked with the `'widget'` directive.\n */\nexport function createWidget<T extends object = object>(\n  name: string,\n  widget: (props: WidgetBase<T>) => React.JSX.Element\n): Widget<T> {\n  return new Widget<T>(name, widget);\n}\n\n/**\n * Creates a Live Activity Factory for managing Live Activities of a specific type.\n * @param name The Live Activity name. Must match the `'name'` field in your widget configuration in the app config.\n * @param liveActivity The Live Activity component, marked with the `'widget'` directive.\n */\nexport function createLiveActivity<T extends object = object>(\n  name: string,\n  liveActivity: LiveActivityComponent<T>\n): LiveActivityFactory<T> {\n  return new LiveActivityFactory<T>(name, liveActivity);\n}\n\n/**\n * Adds a listener for widget interaction events (for example, button taps).\n * @param listener Callback function to handle user interaction events.\n * @return An event subscription that can be used to remove the listener.\n */\nexport function addUserInteractionListener(\n  listener: ExpoWidgetsEvents['onExpoWidgetsUserInteraction']\n): EventSubscription {\n  return ExpoWidgetsModule.addListener('onExpoWidgetsUserInteraction', listener);\n}\n\n/**\n * Adds a listener for push-to-start token events.\n * This token can be used to start live activities remotely via APNs.\n * @param listener Callback function to handle push-to-start token events.\n * @return An event subscription that can be used to remove the listener.\n */\nexport function addPushToStartTokenListener(\n  listener: ExpoWidgetsEvents['onExpoWidgetsPushToStartTokenReceived']\n): EventSubscription {\n  return ExpoWidgetsModule.addListener('onExpoWidgetsPushToStartTokenReceived', listener);\n}\n"]}
+{"version":3,"file":"Widgets.js","sourceRoot":"","sources":["../src/Widgets.ts"],"names":[],"mappings":"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","sourcesContent":["import { type EventSubscription } from 'expo-modules-core';\n\nimport ExpoWidgetsModule from './ExpoWidgets';\nimport type {\n  ExpoWidgetsEvents,\n  LiveActivityComponent,\n  LiveActivityDismissalPolicy,\n  NativeLiveActivity,\n  NativeLiveActivityFactory,\n  NativeWidgetObject,\n  PushTokenEvent,\n  WidgetEnvironment,\n  WidgetTimelineEntry,\n} from './Widgets.types';\n\n/**\n * Represents a widget instance. Provides methods to manage the widget's timeline.\n */\nexport class Widget<T extends object = object> {\n  /** @hidden */\n  private nativeWidgetObject: NativeWidgetObject;\n  constructor(\n    name: string,\n    layout: (props: T, environment: WidgetEnvironment) => React.JSX.Element\n  ) {\n    this.nativeWidgetObject = new ExpoWidgetsModule.Widget(name, layout as unknown as string);\n  }\n\n  /**\n   * Force reloads the widget, causing it to refresh its content and timeline.\n   */\n  reload() {\n    this.nativeWidgetObject.reload();\n  }\n\n  /**\n   * Schedules a series of updates for the widget's content and reloads the widget.\n   * @param entries Timeline entries, each specifying a date and the props to display at that time.\n   */\n  updateTimeline(entries: WidgetTimelineEntry<T>[]) {\n    this.nativeWidgetObject.updateTimeline(\n      entries.map((entry) => ({ timestamp: entry.date.getTime(), props: entry.props }))\n    );\n  }\n\n  /**\n   * Sets the widget's content to the given props immediately, without scheduling a timeline.\n   * @param props The properties to display in the widget.\n   */\n  updateSnapshot(props: T) {\n    this.nativeWidgetObject.updateTimeline([{ timestamp: Date.now(), props }]);\n  }\n\n  /**\n   * Returns the current timeline entries for the widget, including past and future entries.\n   */\n  async getTimeline(): Promise<WidgetTimelineEntry<T>[]> {\n    return (await this.nativeWidgetObject.getTimeline()).map((entry) => ({\n      date: new Date(entry.timestamp),\n      props: entry.props as T,\n    }));\n  }\n}\n\n/**\n * Represents a Live Activity instance. Provides methods to update its content and end it.\n */\nexport class LiveActivity<T extends object = object> {\n  /** @hidden */\n  private nativeLiveActivity: NativeLiveActivity;\n  constructor(nativeLiveActivity: NativeLiveActivity) {\n    this.nativeLiveActivity = nativeLiveActivity;\n  }\n\n  /**\n   * Updates the Live Activity's content. The UI reflects the new properties immediately.\n   * @param props The updated content properties.\n   */\n  update(props: T): Promise<void> {\n    return this.nativeLiveActivity.update(JSON.stringify(props));\n  }\n\n  /**\n   * Ends the Live Activity.\n   * @param dismissalPolicy Controls when the Live Activity is removed from the Lock Screen after ending.\n   * Can be `'default'`, `'immediate'`, or `after(date)`.\n   * @param props Final content properties to update after the activity ends.\n   * @param contentDate The time the data in the payload was generated. If this is older than a previous update or push payload, the system ignores this update.\n   */\n  end(dismissalPolicy?: LiveActivityDismissalPolicy, props?: T, contentDate?: Date): Promise<void> {\n    const serializedProps = props ? JSON.stringify(props) : undefined;\n    if (\n      typeof dismissalPolicy === 'object' &&\n      dismissalPolicy !== null &&\n      'after' in dismissalPolicy\n    ) {\n      return this.nativeLiveActivity.end(\n        'after',\n        dismissalPolicy.after?.getTime(),\n        serializedProps,\n        contentDate?.getTime()\n      );\n    }\n    return this.nativeLiveActivity.end(\n      dismissalPolicy,\n      undefined,\n      serializedProps,\n      contentDate?.getTime()\n    );\n  }\n\n  /**\n   * Returns the push token for this Live Activity, used to send push notification updates via APNs.\n   * Returns `null` if push notifications are not enabled or the token is not yet available.\n   */\n  getPushToken(): Promise<string | null> {\n    return this.nativeLiveActivity.getPushToken();\n  }\n\n  /**\n   * Adds a listener for push token update events on this Live Activity instance.\n   * The token can be used to send content updates to this specific activity via APNs.\n   * @param listener Callback invoked when a new push token is available.\n   * @returns An event subscription that can be used to remove the listener.\n   */\n  addPushTokenListener(listener: (event: PushTokenEvent) => void): EventSubscription {\n    return this.nativeLiveActivity.addListener('onExpoWidgetsTokenReceived', listener);\n  }\n}\n\n/**\n * Manages Live Activity instances of a specific type. Use it to start new activities and retrieve currently active ones.\n */\nexport class LiveActivityFactory<T extends object = object> {\n  /** @hidden */\n  private nativeLiveActivityFactory: NativeLiveActivityFactory;\n  constructor(name: string, layout: LiveActivityComponent<T>) {\n    this.nativeLiveActivityFactory = new ExpoWidgetsModule.LiveActivityFactory(\n      name,\n      layout as unknown as string\n    );\n  }\n\n  /**\n   * Starts a new Live Activity with the given properties.\n   * @param props The initial content properties for the Live Activity.\n   * @param url An optional URL to associate with the Live Activity, used for deep linking.\n   * @returns The new Live Activity instance.\n   */\n  start(props: T, url?: string) {\n    return new LiveActivity<T>(this.nativeLiveActivityFactory.start(JSON.stringify(props), url));\n  }\n\n  /**\n   * Returns all currently active instances of this Live Activity type.\n   */\n  getInstances() {\n    return this.nativeLiveActivityFactory\n      .getInstances()\n      .map((instance) => new LiveActivity<T>(instance));\n  }\n}\n\n/**\n * Creates a dismissal policy that removes the Live Activity at the specified time within a four-hour window.\n * @param date The date after which the Live Activity should be removed from the Lock Screen.\n * @hidden\n */\nexport function after(date: Date): { after: Date } {\n  return { after: date };\n}\n\n/**\n * Creates a Widget instance.\n * @param name The widget name. Must match the `'name'` field in your widget configuration in the app config.\n * @param widget The widget component, marked with the `'widget'` directive.\n */\nexport function createWidget<T extends object = object>(\n  name: string,\n  widget: (props: T, context: WidgetEnvironment) => React.JSX.Element\n): Widget<T> {\n  return new Widget<T>(name, widget);\n}\n\n/**\n * Creates a Live Activity Factory for managing Live Activities of a specific type.\n * @param name The Live Activity name. Must match the `'name'` field in your widget configuration in the app config.\n * @param liveActivity The Live Activity component, marked with the `'widget'` directive.\n */\nexport function createLiveActivity<T extends object = object>(\n  name: string,\n  liveActivity: LiveActivityComponent<T>\n): LiveActivityFactory<T> {\n  return new LiveActivityFactory<T>(name, liveActivity);\n}\n\n/**\n * Adds a listener for widget interaction events (for example, button taps).\n * @param listener Callback function to handle user interaction events.\n * @return An event subscription that can be used to remove the listener.\n */\nexport function addUserInteractionListener(\n  listener: ExpoWidgetsEvents['onExpoWidgetsUserInteraction']\n): EventSubscription {\n  return ExpoWidgetsModule.addListener('onExpoWidgetsUserInteraction', listener);\n}\n\n/**\n * Adds a listener for push-to-start token events.\n * This token can be used to start live activities remotely via APNs.\n * @param listener Callback function to handle push-to-start token events.\n * @return An event subscription that can be used to remove the listener.\n */\nexport function addPushToStartTokenListener(\n  listener: ExpoWidgetsEvents['onExpoWidgetsPushToStartTokenReceived']\n): EventSubscription {\n  return ExpoWidgetsModule.addListener('onExpoWidgetsPushToStartTokenReceived', listener);\n}\n"]}

package/build/Widgets.types.d.ts

@@ -1,6 +1,27 @@
 import { SharedObject } from 'expo';
 import { ReactNode } from 'react';
 import { after } from './Widgets';
+/**
+ * The rendering mode of the widget as provided by WidgetKit.
+ * - `fullColor` — Home screen widgets (default).
+ * - `accented` — Tinted widgets (iOS 18+) and watchOS.
+ * - `vibrant` — Lock screen widgets.
+ */
+export type WidgetRenderingMode = 'fullColor' | 'accented' | 'vibrant';
+/**
+ * The level of detail the view is recommended to have.
+ * The system can update the levelOfDetail value based on user proximity or other system specific factors and allow content customization adapting to show different levels of details.
+ * - `simplified` — The system recommends showing a simplified view with less details.
+ * - `default` — The system has no specific recommendation for the level of detail.
+ * @available iOS 26+
+ */
+export type LevelOfDetail = 'simplified' | 'default';
+/**
+ * The size family of the current Live Activity.
+ * A Live Activity you initiate on one device can also appear on a remote device that renders the Live Activity in a different family size. As a result, it renders for a specific family, depending on both the device and the location in which it appears.
+ * @available iOS 18+
+ */
+export type ActivityFamily = 'small' | 'medium';
 /**
  * The widget family (size).
  * - `systemSmall` - Small square widget (2x2 grid).
@@ -12,10 +33,7 @@ import { after } from './Widgets';
  * - `accessoryInline` - Inline accessory widget for the Lock Screen.
  */
 export type WidgetFamily = 'systemSmall' | 'systemMedium' | 'systemLarge' | 'systemExtraLarge' | 'accessoryCircular' | 'accessoryRectangular' | 'accessoryInline';
-/**
- * Props passed to a widget component.
- */
-export type WidgetBase<T extends object = object> = {
+export type WidgetEnvironment = {
     /**
      * The date of this timeline entry.
      */
@@ -23,8 +41,76 @@ export type WidgetBase<T extends object = object> = {
     /**
      * The widget family.
      */
-    family: WidgetFamily;
-} & T;
+    widgetFamily: WidgetFamily;
+    /**
+     * The color scheme of the widget's environment.
+     */
+    colorScheme?: 'light' | 'dark';
+    /**
+     * A Boolean value that indicates whether the display or environment currently requires reduced luminance.
+     *
+     * When you detect this condition, lower the overall brightness of your view.
+     * For example, you can change large, filled shapes to be stroked, and choose less bright colors.
+     * @available iOS 16+
+     */
+    isLuminanceReduced?: boolean;
+    /**
+     * The widget's rendering mode, based on where the system is displaying it.
+     * @available iOS 16+
+     */
+    widgetRenderingMode?: WidgetRenderingMode;
+    /**
+     * A Boolean value that indicates whether an accessory family widget can display an accessory label.
+     * @available iOS 16+
+     */
+    showsWidgetLabel?: boolean;
+    /**
+     * The content margins for the widget.
+     * @available iOS 17+
+     */
+    widgetContentMargins?: {
+        top: number;
+        bottom: number;
+        leading: number;
+        trailing: number;
+    };
+    /**
+     * The level of detail the view is recommended to have.
+     * @available iOS 26+
+     */
+    levelOfDetail?: LevelOfDetail;
+};
+export type LiveActivityEnvironment = {
+    /**
+     * The color scheme of the activity's environment.
+     */
+    colorScheme: 'light' | 'dark';
+    /**
+     * Whether the activity is displayed in a context with reduced luminance.
+     * @available iOS 16+
+     */
+    isLuminanceReduced?: boolean;
+    /**
+     * Whether the activity is currently displayed in fullscreen.
+     * @available iOS 16.1+
+     */
+    isActivityFullscreen?: boolean;
+    /**
+     * A Boolean value that indicates whether the Live Activity update synchronization rate is reduced.
+     * @available iOS 18+
+     */
+    isActivityUpdateReduced?: boolean;
+    /**
+     * The size family of the current Live Activity.
+     * @available iOS 18+
+     */
+    activityFamily?: ActivityFamily;
+    /**
+     * The level of detail the view is recommended to have.
+     * @available iOS 26+
+     */
+    levelOfDetail?: LevelOfDetail;
+};
 export type WidgetTimelineEntry<T extends object = object> = {
     /**
      * Date when widget should update.
@@ -83,7 +169,7 @@ export type LiveActivityLayout = {
 /**
  * A function that returns the layout for a Live Activity.
  */
-export type LiveActivityComponent<T extends object = object> = (props?: T) => LiveActivityLayout;
+export type LiveActivityComponent<T extends object = object> = (props: T, environment: LiveActivityEnvironment) => LiveActivityLayout;
 /**
  * Event emitted when a user interacts with a widget.
  */

package/build/Widgets.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Widgets.types.d.ts","sourceRoot":"","sources":["../src/Widgets.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Widgets.types.d.ts","sourceRoot":"","sources":["../src/Widgets.types.ts"],"names":[],"mappings":"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"}

package/build/Widgets.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"Widgets.types.js","sourceRoot":"","sources":["../src/Widgets.types.ts"],"names":[],"mappings":"","sourcesContent":["import { SharedObject } from 'expo';\nimport { ReactNode } from 'react';\n\nimport { after } from './Widgets';\n\n/**\n * The widget family (size).\n * - `systemSmall` - Small square widget (2x2 grid).\n * - `systemMedium` - Medium widget (4x2 grid).\n * - `systemLarge` - Large widget (4x4 grid).\n * - `systemExtraLarge` - Extra large widget (iPad only, 6x4 grid).\n * - `accessoryCircular` - Circular accessory widget for the Lock Screen.\n * - `accessoryRectangular` - Rectangular accessory widget for the Lock Screen.\n * - `accessoryInline` - Inline accessory widget for the Lock Screen.\n */\nexport type WidgetFamily =\n  | 'systemSmall'\n  | 'systemMedium'\n  | 'systemLarge'\n  | 'systemExtraLarge'\n  | 'accessoryCircular'\n  | 'accessoryRectangular'\n  | 'accessoryInline';\n\n/**\n * Props passed to a widget component.\n */\nexport type WidgetBase<T extends object = object> = {\n  /**\n   * The date of this timeline entry.\n   */\n  date: Date;\n  /**\n   * The widget family.\n   */\n  family: WidgetFamily;\n} & T;\n\nexport type WidgetTimelineEntry<T extends object = object> = {\n  /**\n   * Date when widget should update.\n   */\n  date: Date;\n  /**\n   * Props to be passed to the widget.\n   */\n  props: T;\n};\n\nexport type ExpoTimelineEntry = {\n  timestamp: number;\n  props: Record<string, any>;\n};\n\n/**\n * Defines the layout sections for an iOS Live Activity.\n */\nexport type LiveActivityLayout = {\n  /**\n   * The main banner content displayed in Notifications Center.\n   */\n  banner: ReactNode;\n  /**\n   * The small banner content displayed in CarPlay and WatchOS. Falls back to `banner` if not provided.\n   */\n  bannerSmall?: ReactNode;\n  /**\n   * The leading content in the compact Dynamic Island presentation.\n   */\n  compactLeading?: ReactNode;\n  /**\n   * The trailing content in the compact Dynamic Island presentation.\n   */\n  compactTrailing?: ReactNode;\n  /**\n   * The minimal content shown when the Dynamic Island is in its smallest form.\n   */\n  minimal?: ReactNode;\n  /**\n   * The center content in the expanded Dynamic Island presentation.\n   */\n  expandedCenter?: ReactNode;\n  /**\n   * The leading content in the expanded Dynamic Island presentation.\n   */\n  expandedLeading?: ReactNode;\n  /**\n   * The trailing content in the expanded Dynamic Island presentation.\n   */\n  expandedTrailing?: ReactNode;\n  /**\n   * The bottom content in the expanded Dynamic Island presentation.\n   */\n  expandedBottom?: ReactNode;\n};\n\n/**\n * A function that returns the layout for a Live Activity.\n */\nexport type LiveActivityComponent<T extends object = object> = (props?: T) => LiveActivityLayout;\n\n/**\n * Event emitted when a user interacts with a widget.\n */\nexport type UserInteractionEvent = {\n  /**\n   * Widget that triggered the interaction.\n   */\n  source: string;\n  /**\n   * Button/toggle that was pressed.\n   */\n  target: string;\n  /**\n   * Timestamp of the event.\n   */\n  timestamp: number;\n  /**\n   * The event type identifier.\n   */\n  type: 'ExpoWidgetsUserInteraction';\n};\n\n/**\n * Event emitted when a push token is received for a live activity.\n */\nexport type PushTokenEvent = {\n  /**\n   * The ID of the live activity.\n   */\n  activityId: string;\n  /**\n   * The push token for the live activity.\n   */\n  pushToken: string;\n};\n\n/**\n * Event emitted when a push-to-start token is received.\n */\nexport type PushToStartTokenEvent = {\n  /**\n   * The push-to-start token for starting live activities remotely.\n   */\n  activityPushToStartToken: string;\n};\n\n/**\n * Dismissal policy for ending a live activity.\n * - `'default'` - The system’s default dismissal policy for the Live Activity.\n * - `'immediate'` - The system immediately removes the Live Activity that ended.\n * - `after(date)` - The system removes the Live Activity that ended at the specified time within a four-hour window.\n */\nexport type LiveActivityDismissalPolicy = 'default' | 'immediate' | ReturnType<typeof after>;\n\nexport type ExpoWidgetsEvents = {\n  /**\n   * Function that is invoked when user interacts with a widget.\n   * @param event Interaction event details.\n   */\n  onExpoWidgetsUserInteraction: (event: UserInteractionEvent) => void;\n  /**\n   * Function that is invoked when a push-to-start token is received.\n   * @param event Token event details.\n   */\n  onExpoWidgetsPushToStartTokenReceived: (event: PushToStartTokenEvent) => void;\n};\n\nexport type LiveActivityEvents = {\n  /**\n   * Function that is invoked when a push token is received for a live activity.\n   * @param event Token event details.\n   */\n  onExpoWidgetsTokenReceived: (event: PushTokenEvent) => void;\n};\n\nexport declare class NativeWidgetObject extends SharedObject {\n  constructor(name: string, layout: string);\n  reload(): void;\n  updateTimeline(entries: ExpoTimelineEntry[]): void;\n  getTimeline(): Promise<ExpoTimelineEntry[]>;\n}\n\nexport declare class NativeLiveActivityFactory extends SharedObject {\n  constructor(name: string, layout: string);\n  start(props: string, url?: string): NativeLiveActivity;\n  getInstances(): NativeLiveActivity[];\n}\n\nexport declare class NativeLiveActivity extends SharedObject<LiveActivityEvents> {\n  update(props: string): Promise<void>;\n  end(\n    dismissalPolicy?: string,\n    afterDate?: number,\n    state?: string,\n    contentDate?: number\n  ): Promise<void>;\n  getPushToken(): Promise<string | null>;\n}\n"]}
+{"version":3,"file":"Widgets.types.js","sourceRoot":"","sources":["../src/Widgets.types.ts"],"names":[],"mappings":"","sourcesContent":["import { SharedObject } from 'expo';\nimport { ReactNode } from 'react';\n\nimport { after } from './Widgets';\n\n/**\n * The rendering mode of the widget as provided by WidgetKit.\n * - `fullColor` — Home screen widgets (default).\n * - `accented` — Tinted widgets (iOS 18+) and watchOS.\n * - `vibrant` — Lock screen widgets.\n */\nexport type WidgetRenderingMode = 'fullColor' | 'accented' | 'vibrant';\n\n/**\n * The level of detail the view is recommended to have.\n * The system can update the levelOfDetail value based on user proximity or other system specific factors and allow content customization adapting to show different levels of details.\n * - `simplified` — The system recommends showing a simplified view with less details.\n * - `default` — The system has no specific recommendation for the level of detail.\n * @available iOS 26+\n */\nexport type LevelOfDetail = 'simplified' | 'default';\n\n/**\n * The size family of the current Live Activity.\n * A Live Activity you initiate on one device can also appear on a remote device that renders the Live Activity in a different family size. As a result, it renders for a specific family, depending on both the device and the location in which it appears.\n * @available iOS 18+\n */\nexport type ActivityFamily = 'small' | 'medium';\n\n/**\n * The widget family (size).\n * - `systemSmall` - Small square widget (2x2 grid).\n * - `systemMedium` - Medium widget (4x2 grid).\n * - `systemLarge` - Large widget (4x4 grid).\n * - `systemExtraLarge` - Extra large widget (iPad only, 6x4 grid).\n * - `accessoryCircular` - Circular accessory widget for the Lock Screen.\n * - `accessoryRectangular` - Rectangular accessory widget for the Lock Screen.\n * - `accessoryInline` - Inline accessory widget for the Lock Screen.\n */\nexport type WidgetFamily =\n  | 'systemSmall'\n  | 'systemMedium'\n  | 'systemLarge'\n  | 'systemExtraLarge'\n  | 'accessoryCircular'\n  | 'accessoryRectangular'\n  | 'accessoryInline';\n\nexport type WidgetEnvironment = {\n  /**\n   * The date of this timeline entry.\n   */\n  date: Date;\n  /**\n   * The widget family.\n   */\n  widgetFamily: WidgetFamily;\n  /**\n   * The color scheme of the widget's environment.\n   */\n  colorScheme?: 'light' | 'dark';\n  /**\n   * A Boolean value that indicates whether the display or environment currently requires reduced luminance.\n   *\n   * When you detect this condition, lower the overall brightness of your view.\n   * For example, you can change large, filled shapes to be stroked, and choose less bright colors.\n   * @available iOS 16+\n   */\n  isLuminanceReduced?: boolean;\n  /**\n   * The widget's rendering mode, based on where the system is displaying it.\n   * @available iOS 16+\n   */\n  widgetRenderingMode?: WidgetRenderingMode;\n  /**\n   * A Boolean value that indicates whether an accessory family widget can display an accessory label.\n   * @available iOS 16+\n   */\n  showsWidgetLabel?: boolean;\n  /**\n   * The content margins for the widget.\n   * @available iOS 17+\n   */\n  widgetContentMargins?: {\n    top: number;\n    bottom: number;\n    leading: number;\n    trailing: number;\n  };\n  /**\n   * The level of detail the view is recommended to have.\n   * @available iOS 26+\n   */\n  levelOfDetail?: LevelOfDetail;\n};\n\nexport type LiveActivityEnvironment = {\n  /**\n   * The color scheme of the activity's environment.\n   */\n  colorScheme: 'light' | 'dark';\n  /**\n   * Whether the activity is displayed in a context with reduced luminance.\n   * @available iOS 16+\n   */\n  isLuminanceReduced?: boolean;\n  /**\n   * Whether the activity is currently displayed in fullscreen.\n   * @available iOS 16.1+\n   */\n  isActivityFullscreen?: boolean;\n  /**\n   * A Boolean value that indicates whether the Live Activity update synchronization rate is reduced.\n   * @available iOS 18+\n   */\n  isActivityUpdateReduced?: boolean;\n  /**\n   * The size family of the current Live Activity.\n   * @available iOS 18+\n   */\n  activityFamily?: ActivityFamily;\n  /**\n   * The level of detail the view is recommended to have.\n   * @available iOS 26+\n   */\n  levelOfDetail?: LevelOfDetail;\n};\n\nexport type WidgetTimelineEntry<T extends object = object> = {\n  /**\n   * Date when widget should update.\n   */\n  date: Date;\n  /**\n   * Props to be passed to the widget.\n   */\n  props: T;\n};\n\nexport type ExpoTimelineEntry = {\n  timestamp: number;\n  props: Record<string, any>;\n};\n\n/**\n * Defines the layout sections for an iOS Live Activity.\n */\nexport type LiveActivityLayout = {\n  /**\n   * The main banner content displayed in Notifications Center.\n   */\n  banner: ReactNode;\n  /**\n   * The small banner content displayed in CarPlay and WatchOS. Falls back to `banner` if not provided.\n   */\n  bannerSmall?: ReactNode;\n  /**\n   * The leading content in the compact Dynamic Island presentation.\n   */\n  compactLeading?: ReactNode;\n  /**\n   * The trailing content in the compact Dynamic Island presentation.\n   */\n  compactTrailing?: ReactNode;\n  /**\n   * The minimal content shown when the Dynamic Island is in its smallest form.\n   */\n  minimal?: ReactNode;\n  /**\n   * The center content in the expanded Dynamic Island presentation.\n   */\n  expandedCenter?: ReactNode;\n  /**\n   * The leading content in the expanded Dynamic Island presentation.\n   */\n  expandedLeading?: ReactNode;\n  /**\n   * The trailing content in the expanded Dynamic Island presentation.\n   */\n  expandedTrailing?: ReactNode;\n  /**\n   * The bottom content in the expanded Dynamic Island presentation.\n   */\n  expandedBottom?: ReactNode;\n};\n\n/**\n * A function that returns the layout for a Live Activity.\n */\nexport type LiveActivityComponent<T extends object = object> = (\n  props: T,\n  environment: LiveActivityEnvironment\n) => LiveActivityLayout;\n\n/**\n * Event emitted when a user interacts with a widget.\n */\nexport type UserInteractionEvent = {\n  /**\n   * Widget that triggered the interaction.\n   */\n  source: string;\n  /**\n   * Button/toggle that was pressed.\n   */\n  target: string;\n  /**\n   * Timestamp of the event.\n   */\n  timestamp: number;\n  /**\n   * The event type identifier.\n   */\n  type: 'ExpoWidgetsUserInteraction';\n};\n\n/**\n * Event emitted when a push token is received for a live activity.\n */\nexport type PushTokenEvent = {\n  /**\n   * The ID of the live activity.\n   */\n  activityId: string;\n  /**\n   * The push token for the live activity.\n   */\n  pushToken: string;\n};\n\n/**\n * Event emitted when a push-to-start token is received.\n */\nexport type PushToStartTokenEvent = {\n  /**\n   * The push-to-start token for starting live activities remotely.\n   */\n  activityPushToStartToken: string;\n};\n\n/**\n * Dismissal policy for ending a live activity.\n * - `'default'` - The system’s default dismissal policy for the Live Activity.\n * - `'immediate'` - The system immediately removes the Live Activity that ended.\n * - `after(date)` - The system removes the Live Activity that ended at the specified time within a four-hour window.\n */\nexport type LiveActivityDismissalPolicy = 'default' | 'immediate' | ReturnType<typeof after>;\n\nexport type ExpoWidgetsEvents = {\n  /**\n   * Function that is invoked when user interacts with a widget.\n   * @param event Interaction event details.\n   */\n  onExpoWidgetsUserInteraction: (event: UserInteractionEvent) => void;\n  /**\n   * Function that is invoked when a push-to-start token is received.\n   * @param event Token event details.\n   */\n  onExpoWidgetsPushToStartTokenReceived: (event: PushToStartTokenEvent) => void;\n};\n\nexport type LiveActivityEvents = {\n  /**\n   * Function that is invoked when a push token is received for a live activity.\n   * @param event Token event details.\n   */\n  onExpoWidgetsTokenReceived: (event: PushTokenEvent) => void;\n};\n\nexport declare class NativeWidgetObject extends SharedObject {\n  constructor(name: string, layout: string);\n  reload(): void;\n  updateTimeline(entries: ExpoTimelineEntry[]): void;\n  getTimeline(): Promise<ExpoTimelineEntry[]>;\n}\n\nexport declare class NativeLiveActivityFactory extends SharedObject {\n  constructor(name: string, layout: string);\n  start(props: string, url?: string): NativeLiveActivity;\n  getInstances(): NativeLiveActivity[];\n}\n\nexport declare class NativeLiveActivity extends SharedObject<LiveActivityEvents> {\n  update(props: string): Promise<void>;\n  end(\n    dismissalPolicy?: string,\n    afterDate?: number,\n    state?: string,\n    contentDate?: number\n  ): Promise<void>;\n  getPushToken(): Promise<string | null>;\n}\n"]}

package/build/index.d.ts

@@ -1,3 +1,3 @@
 export * from './Widgets';
-export { ExpoWidgetsEvents, LiveActivityComponent, LiveActivityDismissalPolicy, LiveActivityEvents, LiveActivityLayout, PushTokenEvent, PushToStartTokenEvent, UserInteractionEvent, WidgetBase, WidgetFamily, WidgetTimelineEntry, } from './Widgets.types';
+export { ExpoWidgetsEvents, LevelOfDetail, LiveActivityComponent, LiveActivityDismissalPolicy, LiveActivityEvents, LiveActivityLayout, PushTokenEvent, PushToStartTokenEvent, UserInteractionEvent, WidgetEnvironment, WidgetFamily, WidgetRenderingMode, WidgetTimelineEntry, } from './Widgets.types';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,2BAA2B,EAC3B,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,2BAA2B,EAC3B,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC","sourcesContent":["export * from './Widgets';\nexport {\n  ExpoWidgetsEvents,\n  LiveActivityComponent,\n  LiveActivityDismissalPolicy,\n  LiveActivityEvents,\n  LiveActivityLayout,\n  PushTokenEvent,\n  PushToStartTokenEvent,\n  UserInteractionEvent,\n  WidgetBase,\n  WidgetFamily,\n  WidgetTimelineEntry,\n} from './Widgets.types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC","sourcesContent":["export * from './Widgets';\nexport {\n  ExpoWidgetsEvents,\n  LevelOfDetail,\n  LiveActivityComponent,\n  LiveActivityDismissalPolicy,\n  LiveActivityEvents,\n  LiveActivityLayout,\n  PushTokenEvent,\n  PushToStartTokenEvent,\n  UserInteractionEvent,\n  WidgetEnvironment,\n  WidgetFamily,\n  WidgetRenderingMode,\n  WidgetTimelineEntry,\n} from './Widgets.types';\n"]}

package/bundle/index.ts

@@ -6,39 +6,35 @@ import * as modifiers from '@expo/ui/swift-ui/modifiers';
 import * as jsxRuntime from './jsx-runtime-stub';
 import * as React from './react-stub';
 
-type WidgetProps = Record<string, unknown>;
-type WidgetNode = { props?: WidgetProps };
+type Dictionary = Record<string, unknown>;
 
 declare global {
-  var __expoWidgetLayout: (props: WidgetProps) => WidgetNode;
-  var __expoWidgetProps: WidgetProps | undefined;
-  var __expoWidgetRender: (timestamp: number, family?: string) => WidgetProps;
+  var __expoWidgetLayout: (props: Dictionary, environment: Dictionary) => Dictionary;
+  var __expoWidgetRender: (props: Dictionary, environment: Dictionary) => Dictionary;
   var __expoWidgetHandlePress: (
-    timestamp: number,
-    family: string | undefined,
-    target: string | undefined
-  ) => WidgetProps | undefined;
+    environment: Dictionary & { target?: string }
+  ) => Dictionary | undefined;
 }
 
-const __expoWidgetRender = function (timestamp: number, family?: string) {
-  if (family) {
-    return globalThis.__expoWidgetLayout(
-      Object.assign({ date: new Date(timestamp), family }, globalThis.__expoWidgetProps || {})
-    );
+const __expoWidgetRender = function (props: Dictionary, environment: Dictionary) {
+  const { timestamp, ...rest } = environment;
+  const decoratedEnvironment: Dictionary = { ...rest };
+  if (timestamp) {
+    decoratedEnvironment.date = new Date(timestamp as number);
   }
-  return globalThis.__expoWidgetLayout(
-    Object.assign({ date: new Date(timestamp) }, globalThis.__expoWidgetProps || {})
-  );
+
+  return globalThis.__expoWidgetLayout(props, decoratedEnvironment as any);
 };
 
 const __expoWidgetHandlePress = function (
-  timestamp: number,
-  family: string | undefined,
-  target: string | undefined
+  props: Dictionary,
+  environment: Dictionary & { target?: string }
 ) {
-  function findAndCallOnPress(node?: WidgetNode): WidgetProps | undefined {
+  const { target, ...renderEnvironment } = environment;
+
+  function findAndCallOnPress(node?: Dictionary): Dictionary | undefined {
     const props = node?.props as {
-      onButtonPress?: () => WidgetProps;
+      onButtonPress?: () => Dictionary;
       target?: string;
       children?: unknown;
     };
@@ -48,7 +44,7 @@ const __expoWidgetHandlePress = function (
 
     if (props?.children && Array.isArray(props.children)) {
       for (const child of props.children) {
-        const result = findAndCallOnPress(child as WidgetNode);
+        const result = findAndCallOnPress(child as Dictionary);
         if (result) {
           return result;
         }
@@ -56,8 +52,8 @@ const __expoWidgetHandlePress = function (
     }
   }
 
-  const node = globalThis.__expoWidgetRender(timestamp, family);
-  return findAndCallOnPress(node as WidgetNode);
+  const node = globalThis.__expoWidgetRender(props, renderEnvironment);
+  return findAndCallOnPress(node as Dictionary);
 };
 
 Object.assign(globalThis, {

package/ios/Widgets/AppIntent.swift

@@ -34,12 +34,15 @@ struct WidgetUserInteraction: AppIntent {
           let entryIndex,
           let entry = timeline[entryIndex] as? [String: Any],
           let props = entry["props"] as? [String: Any],
-          let context = createWidgetContext(layout: layout, props: props) else {
+          let context = createWidgetContext(layout: layout) else {
       return .result()
     }
-    let familyKey: String? = "systemSmall"
+    let pressEnvironment: [String: Any] = [
+      "timestamp": Int(Date.now.timeIntervalSince1970 * 1000),
+      "target": target as Any
+    ]
     let result = context.objectForKeyedSubscript("__expoWidgetHandlePress")?.call(
-      withArguments: [Int(Date.now.timeIntervalSince1970 * 1000), familyKey as Any, target as Any]
+      withArguments: [props, pressEnvironment]
     )
     if let newProps = result?.toObject() as? [String: Any] {
       var newEntry = entry

package/ios/Widgets/DynamicView.swift

@@ -127,8 +127,9 @@ public struct WidgetsDynamicView: View, ExpoSwiftUI.AnyChild {
   private func updateChildren<P>(_ initialProps: P) throws
   where P: UIBaseViewProps {
     if let props = node["props"] as? [String: Any] {
-      if let children = props["children"] as? [[String: Any]] {
-        initialProps.children = children.map { WidgetsDynamicView(source: source, kind: kind, node: $0, entryIndex: entryIndex) }
+      if let children = props["children"] as? [Any] {
+        let validChildren = children.compactMap { $0 as? [String: Any] }
+        initialProps.children = validChildren.map { WidgetsDynamicView(source: source, kind: kind, node: $0, entryIndex: entryIndex) }
       } else if let child = props["children"] as? [String: Any] {
         initialProps.children = [WidgetsDynamicView(source: source, kind: kind, node: child, entryIndex: entryIndex)]
       }

package/ios/Widgets/EntryView.swift

@@ -3,15 +3,24 @@ import ExpoModulesCore
 import WidgetKit
 
 public struct WidgetsEntryView: View {
-  @Environment(\.widgetFamily) var widgetFamily
+  @Environment(\.self) var environment
   var entry: WidgetsTimelineProvider.Entry
 
   public init(entry: WidgetsTimelineProvider.Entry) {
     self.entry = entry
   }
 
+  private var widgetEnvironment: [String: Any] {
+    var env: [String: Any] = getWidgetEnvironment(environment: environment)
+    env["timestamp"] = Int(entry.date.timeIntervalSince1970 * 1000)
+    return env
+  }
+
   public var body: some View {
-    if let node = entry.node {
+    let layout = WidgetsStorage.getString(forKey: "__expo_widgets_\(entry.source)_layout") ?? ""
+    let node = evaluateLayout(layout: layout, props: entry.props ?? [:], environment: widgetEnvironment)
+
+    if let node {
       if #available(iOS 17.0, *) {
         WidgetsDynamicView(source: entry.source, kind: .widget, node: node, entryIndex: entry.entryIndex)
           .containerBackground(.clear, for: .widget)

package/ios/Widgets/TimelineEntry.swift

@@ -3,6 +3,6 @@ import WidgetKit
 public struct WidgetsTimelineEntry: WidgetKit.TimelineEntry {
   public let date: Date
   public let source: String
-  public let node: [String: Any]?
+  public let props: [String: Any]?
   public let entryIndex: Int?
 }

package/ios/Widgets/TimelineProvider.swift

@@ -2,7 +2,7 @@ import WidgetKit
 
 public struct WidgetsTimelineProvider: TimelineProvider {
   public func placeholder(in context: Context) -> WidgetsTimelineEntry {
-    WidgetsTimelineEntry(date: Date(), source: name, node: nil, entryIndex: nil)
+    WidgetsTimelineEntry(date: Date(), source: name, props: nil, entryIndex: nil)
   }
 
   public func getSnapshot(
@@ -11,12 +11,12 @@ public struct WidgetsTimelineProvider: TimelineProvider {
     let groupIdentifier =
       Bundle.main.object(forInfoDictionaryKey: "ExpoWidgetsAppGroupIdentifier") as? String
     guard let groupIdentifier else {
-      completion(WidgetsTimelineEntry(date: Date(), source: name, node: nil, entryIndex: nil))
+      completion(WidgetsTimelineEntry(date: Date(), source: name, props: nil, entryIndex: nil))
       return
     }
 
     let entries = parseTimeline(identifier: groupIdentifier, name: name, family: context.family)
-    completion(entries.first ?? WidgetsTimelineEntry(date: Date(), source: name, node: nil, entryIndex: nil))
+    completion(entries.first ?? WidgetsTimelineEntry(date: Date(), source: name, props: nil, entryIndex: nil))
   }
 
   public func getTimeline(

package/ios/Widgets/Type.swift

@@ -4,16 +4,3 @@ public enum WidgetsKind {
   case widget
   case liveActivity
 }
-
-func getKeyFor(widgetFamily: WidgetFamily) -> String {
-  switch widgetFamily {
-  case .systemSmall: return "systemSmall"
-  case .systemMedium: return "systemMedium"
-  case .systemLarge: return "systemLarge"
-  case .systemExtraLarge: return "systemExtraLarge"
-  case .accessoryCircular: return "accessoryCircular"
-  case .accessoryRectangular: return "accessoryRectangular"
-  case .accessoryInline: return "accessoryInline"
-  default: return "systemSmall"
-  }
-}

package/ios/Widgets/Utils.swift

@@ -1,17 +1,16 @@
+import SwiftUI
 import WidgetKit
 import Foundation
 
 func parseTimeline(identifier: String, name: String, family: WidgetFamily) -> [WidgetsTimelineEntry] {
-  let layout = WidgetsStorage.getString(forKey: "__expo_widgets_\(name)_layout") ?? ""
   let timeline = WidgetsStorage.getArray(forKey: "__expo_widgets_\(name)_timeline") ?? []
 
   let entries: [WidgetsTimelineEntry?] = timeline.enumerated().map { index, entry in
     if let entry = entry as? [String: Any], let timestamp = entry["timestamp"] as? Int, let props = entry["props"] as? [String: Any] {
-      let node = evaluateLayout(layout: layout, props: props, timestamp: timestamp, family: family)
       return WidgetsTimelineEntry(
         date: Date(timeIntervalSince1970: Double(timestamp) / 1000),
         source: name,
-        node: node,
+        props: props,
         entryIndex: index
       )
     }
@@ -24,30 +23,31 @@ func parseTimeline(identifier: String, name: String, family: WidgetFamily) -> [W
 func evaluateLayout(
   layout: String,
   props: [String: Any],
-  timestamp: Int,
-  family: WidgetFamily
+  environment: [String: Any]
 ) -> [String: Any]? {
-  guard let context = createWidgetContext(layout: layout, props: props) else {
+  guard let context = createWidgetContext(layout: layout) else {
     return nil
   }
-  let familyKey: String? = getKeyFor(widgetFamily: family)
 
   let result = context.objectForKeyedSubscript("__expoWidgetRender")?.call(
-    withArguments: [timestamp, familyKey as Any]
+    withArguments: [props, environment]
   )
   return result?.toObject() as? [String: Any]
 }
 
-func getLiveActivityNodes(forName name: String, props: String = "{}") -> [String: Any] {
+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, props: propsDict ?? [:]) else {
+  let propsDict = propsData.flatMap { try? JSONSerialization.jsonObject(with: $0, options: []) as? [String: Any] } ?? [:]
+  guard let context = createWidgetContext(layout: layout) else {
     return [:]
   }
 
+  var widgetEnvironment = environment
+  widgetEnvironment["timestamp"] = Int(Date.now.timeIntervalSince1970 * 1000)
+
   let result = context.objectForKeyedSubscript("__expoWidgetRender")?.call(
-    withArguments: [Int(Date.now.timeIntervalSince1970 * 1000)]
+    withArguments: [propsDict, environment]
   )
   return result?.toObject() as? [String: Any] ?? [:]
 }
@@ -59,3 +59,50 @@ func getLiveActivityUrl(forName name: String) -> URL? {
   }
   return nil
 }
+
+func getWidgetEnvironment(environment: EnvironmentValues) -> [String: Any] {
+  var env: [String: Any] = [
+    "showsContainerBackground": environment.showsWidgetContainerBackground,
+    "widgetFamily": environment.widgetFamily.description,
+    "colorScheme": "\(environment.colorScheme)"
+  ]
+
+  if #available(iOS 16.0, *) {
+    env["isLuminanceReduced"] = environment.isLuminanceReduced
+    env["widgetRenderingMode"] = environment.widgetRenderingMode.description
+    env["showsWidgetLabel"] = environment.showsWidgetLabel
+  }
+  if #available(iOS 17.0, *) {
+    env["widgetContentMargins"] = [
+      "top": environment.widgetContentMargins.top,
+      "bottom": environment.widgetContentMargins.bottom,
+      "leading": environment.widgetContentMargins.leading,
+      "trailing": environment.widgetContentMargins.trailing,
+    ]
+  }
+  if #available(iOS 26.0, *) {
+    env["levelOfDetail"] = environment.levelOfDetail == .simplified ? "simplified" : environment.levelOfDetail == .default ? "default" : nil
+  }
+  return env
+}
+
+func getLiveActivityEnvironment(environment: EnvironmentValues) -> [String: Any] {
+  var env: [String: Any] = [
+    "colorScheme": "\(environment.colorScheme)"
+  ]
+
+  if #available(iOS 16.0, *) {
+    env["isLuminanceReduced"] = environment.isLuminanceReduced
+  }
+  if #available(iOS 16.1, *) {
+    env["isActivityFullscreen"] = environment.isActivityFullscreen
+  }
+  if #available(iOS 18.0, *) {
+    env["isActivityUpdateReduced"] = environment.isActivityUpdateReduced
+    env["activityFamily"] = "\(environment.activityFamily)"
+  }
+  if #available(iOS 26.0, *) {
+    env["levelOfDetail"] = environment.levelOfDetail == .simplified ? "simplified" : environment.levelOfDetail == .default ? "default" : nil
+  }
+  return env
+}

package/ios/Widgets/WidgetContext.swift

@@ -1,7 +1,7 @@
 import Foundation
 import JavaScriptCore
 
-func createWidgetContext(layout: String, props: [String: Any]) -> JSContext? {
+func createWidgetContext(layout: String) -> JSContext? {
   guard let context = JSContext() else {
     return nil
   }
@@ -22,9 +22,8 @@ func createWidgetContext(layout: String, props: [String: Any]) -> JSContext? {
   }
   context.evaluateScript(bundleJS)
 
-  // Inject layout and props
+  // Inject layout
   let layoutValue = context.evaluateScript("(\(layout))")
   context.setObject(layoutValue, forKeyedSubscript: "__expoWidgetLayout" as NSString)
-  context.setObject(props, forKeyedSubscript: "__expoWidgetProps" as NSString)
   return context
 }

package/ios/Widgets/WidgetLiveActivity.swift

@@ -12,55 +12,84 @@ struct LiveActivityAttributes: ActivityAttributes {
 
 @available(iOS 16.1, *)
 public struct WidgetLiveActivity: Widget {
+  @Environment(\.self) var env
+  
   let widgetContext: AppContext = AppContext()
+  
+  var environment: [String: Any] {
+    return getLiveActivityEnvironment(environment: env)
+  }
 
   public init() {}
 
   public var body: some WidgetConfiguration {
     ActivityConfiguration(for: LiveActivityAttributes.self) { context in
-      let nodes = getLiveActivityNodes(forName: context.state.name, props: context.state.props)
-      if #available(iOS 18.0, *) {
-        LiveActivityBanner(context: context, nodes: nodes)
-      } else {
-        liveActivitySection("banner", source: context.activityID, nodes: nodes)
-      }
+      LiveActivityBannerView(context: context, environment: environment)
     } dynamicIsland: { context in
-      let nodes = getLiveActivityNodes(forName: context.state.name, props: context.state.props)
-      return DynamicIsland {
-        expandedContent(source: context.activityID, nodes: nodes)
+      DynamicIsland {
+        DynamicIslandExpandedRegion(.center) {
+          LiveActivitySectionView(context: context, environment: environment, sectionName: "expandedCenter")
+        }
+        DynamicIslandExpandedRegion(.leading) {
+          LiveActivitySectionView(context: context, environment: environment, sectionName: "expandedLeading")
+        }
+        DynamicIslandExpandedRegion(.trailing) {
+          LiveActivitySectionView(context: context, environment: environment, sectionName: "expandedTrailing")
+        }
+        DynamicIslandExpandedRegion(.bottom) {
+          LiveActivitySectionView(context: context, environment: environment, sectionName: "expandedBottom")
+        }
       } compactLeading: {
-        liveActivitySection("compactLeading", source: context.activityID, nodes: nodes)
+        LiveActivitySectionView(context: context, environment: environment, sectionName: "compactLeading")
       } compactTrailing: {
-        liveActivitySection("compactTrailing", source: context.activityID, nodes: nodes)
+        LiveActivitySectionView(context: context, environment: environment, sectionName: "compactTrailing")
       } minimal: {
-        liveActivitySection("minimal", source: context.activityID, nodes: nodes)
+        LiveActivitySectionView(context: context, environment: environment, sectionName: "minimal")
       }
       .widgetURL(getLiveActivityUrl(forName: context.state.name))
     }
     .supplementalActivityFamiliesIfAvailable()
   }
+}
 
-  @DynamicIslandExpandedContentBuilder
-  private func expandedContent(source: String, nodes: [String: Any]?) -> DynamicIslandExpandedContent<some View> {
-    DynamicIslandExpandedRegion(.center) {
-      liveActivitySection("expandedCenter", source: source, nodes: nodes)
-    }
-    DynamicIslandExpandedRegion(.leading) {
-      liveActivitySection("expandedLeading", source: source, nodes: nodes)
-    }
-    DynamicIslandExpandedRegion(.trailing) {
-      liveActivitySection("expandedTrailing", source: source, nodes: nodes)
-    }
-    DynamicIslandExpandedRegion(.bottom) {
-      liveActivitySection("expandedBottom", source: source, nodes: nodes)
+@available(iOS 16.1, *)
+private struct LiveActivitySectionView: View {
+  let context: ActivityViewContext<LiveActivityAttributes>
+  let environment: [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(source: context.activityID, kind: .liveActivity, node: node)
+    } else {
+      EmptyView()
     }
   }
+}
 
-  private func liveActivitySection(_ sectionName: String, source: String, nodes: [String: Any]?) -> some View {
-    guard let node = nodes?[sectionName] as? [String: Any] else {
-      return AnyView(EmptyView())
+@available(iOS 16.1, *)
+private struct LiveActivityBannerView: View {
+  var context: ActivityViewContext<LiveActivityAttributes>
+  let environment: [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] {
+      WidgetsDynamicView(source: context.activityID, kind: .liveActivity, node: node)
+    } else {
+      EmptyView()
     }
-    return AnyView(WidgetsDynamicView(source: source, kind: .liveActivity, node: node))
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-widgets",
-  "version": "55.0.2",
+  "version": "55.0.4",
   "description": "Widgets.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -33,7 +33,7 @@
   "homepage": "https://docs.expo.dev/versions/latest/sdk/widgets/",
   "dependencies": {
     "@expo/plist": "^0.5.2",
-    "@expo/ui": "~55.0.1"
+    "@expo/ui": "~55.0.2"
   },
   "devDependencies": {
     "expo-module-scripts": "^55.0.2"
@@ -42,5 +42,5 @@
     "expo": "*",
     "react": "*"
   },
-  "gitHead": "413b0450434d3e456eb391eca792ee9ac1e1efec"
+  "gitHead": "bcdd2c239f8a92cdf5140e35cde768352630acd6"
 }

package/plugin/build/index.d.ts

@@ -7,5 +7,5 @@ type ExpoWidgetsConfigPluginProps = {
     frequentUpdates?: boolean;
     widgets?: WidgetConfig[];
 };
-declare const _default: ConfigPlugin<ExpoWidgetsConfigPluginProps>;
+declare const _default: ConfigPlugin<ExpoWidgetsConfigPluginProps | undefined>;
 export default _default;

package/plugin/build/index.js

@@ -17,7 +17,7 @@ const withWidgets = (config, props) => {
     let plugins = [];
     const deploymentTarget = '16.2';
     const targetName = 'ExpoWidgetsTarget';
-    let bundleIdentifier = props.bundleIdentifier;
+    let bundleIdentifier = props?.bundleIdentifier;
     if (!bundleIdentifier) {
         bundleIdentifier = `${config.ios?.bundleIdentifier}.${targetName}`;
         plugins.push([
@@ -28,7 +28,7 @@ const withWidgets = (config, props) => {
             },
         ]);
     }
-    let groupIdentifier = props.groupIdentifier;
+    let groupIdentifier = props?.groupIdentifier;
     if (!groupIdentifier) {
         if (!config.ios?.bundleIdentifier) {
             throw new Error('iOS bundle identifier is required. Please set `ios.bundleIdentifier` in `app.json` or `app.config.js`');
@@ -42,9 +42,9 @@ const withWidgets = (config, props) => {
             },
         ]);
     }
-    const widgets = props.widgets ?? [];
-    const enablePushNotifications = props.enablePushNotifications ?? false;
-    const frequentUpdates = props.frequentUpdates ?? false;
+    const widgets = props?.widgets ?? [];
+    const enablePushNotifications = props?.enablePushNotifications ?? false;
+    const frequentUpdates = props?.frequentUpdates ?? false;
     let sharedFiles = [];
     const setFiles = (files) => {
         sharedFiles = [...sharedFiles, ...files];

package/plugin/build/types/WidgetConfig.type.d.ts

@@ -4,4 +4,5 @@ export type WidgetConfig = {
     supportedFamilies: WidgetFamily[];
     displayName: string;
     description: string;
+    contentMarginsDisabled: boolean;
 };

package/plugin/build/withWidgetSourceFiles.js

@@ -117,7 +117,7 @@ struct ${widget.name}: Widget {
     }
     .configurationDisplayName("${widget.displayName}")
     .description("${widget.description}")
-    .supportedFamilies([.${widget.supportedFamilies.join(', .')}])
+    .supportedFamilies([.${widget.supportedFamilies.join(', .')}])${widget.contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
   }
 }`;
 const infoPlist = (groupIdentifier) => `<?xml version="1.0" encoding="UTF-8"?>

package/plugin/src/index.ts

@@ -24,12 +24,12 @@ type ExpoWidgetsConfigPluginProps = {
   widgets?: WidgetConfig[];
 };
 
-const withWidgets: ConfigPlugin<ExpoWidgetsConfigPluginProps> = (config, props) => {
+const withWidgets: ConfigPlugin<ExpoWidgetsConfigPluginProps | undefined> = (config, props) => {
   let plugins: (StaticPlugin | ConfigPlugin | string)[] = [];
   const deploymentTarget = '16.2';
   const targetName = 'ExpoWidgetsTarget';
 
-  let bundleIdentifier = props.bundleIdentifier;
+  let bundleIdentifier = props?.bundleIdentifier;
   if (!bundleIdentifier) {
     bundleIdentifier = `${config.ios?.bundleIdentifier}.${targetName}`;
     plugins.push([
@@ -41,7 +41,7 @@ const withWidgets: ConfigPlugin<ExpoWidgetsConfigPluginProps> = (config, props)
     ]);
   }
 
-  let groupIdentifier = props.groupIdentifier;
+  let groupIdentifier = props?.groupIdentifier;
   if (!groupIdentifier) {
     if (!config.ios?.bundleIdentifier) {
       throw new Error(
@@ -58,9 +58,9 @@ const withWidgets: ConfigPlugin<ExpoWidgetsConfigPluginProps> = (config, props)
     ]);
   }
 
-  const widgets = props.widgets ?? [];
-  const enablePushNotifications = props.enablePushNotifications ?? false;
-  const frequentUpdates = props.frequentUpdates ?? false;
+  const widgets = props?.widgets ?? [];
+  const enablePushNotifications = props?.enablePushNotifications ?? false;
+  const frequentUpdates = props?.frequentUpdates ?? false;
 
   let sharedFiles: string[] = [];
   const setFiles = (files: string[]) => {

package/plugin/src/types/WidgetConfig.type.ts

@@ -5,4 +5,5 @@ export type WidgetConfig = {
   supportedFamilies: WidgetFamily[];
   displayName: string;
   description: string;
+  contentMarginsDisabled: boolean;
 };

package/plugin/src/withWidgetSourceFiles.ts

@@ -106,7 +106,7 @@ struct ${widget.name}: Widget {
     }
     .configurationDisplayName("${widget.displayName}")
     .description("${widget.description}")
-    .supportedFamilies([.${widget.supportedFamilies.join(', .')}])
+    .supportedFamilies([.${widget.supportedFamilies.join(', .')}])${widget.contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
   }
 }`;
 

package/scripts/build-bundle.mjs

@@ -49,7 +49,8 @@ const result = await spawn(
     '--entry-file',
     path.join(__dirname, '../bundle/index.ts'),
     '--dev',
-    false,
+    'false',
+    '--skip-server',
     ...argv.slice(2),
   ],
   {

package/src/Widgets.ts

@@ -9,7 +9,7 @@ import type {
   NativeLiveActivityFactory,
   NativeWidgetObject,
   PushTokenEvent,
-  WidgetBase,
+  WidgetEnvironment,
   WidgetTimelineEntry,
 } from './Widgets.types';
 
@@ -19,7 +19,10 @@ import type {
 export class Widget<T extends object = object> {
   /** @hidden */
   private nativeWidgetObject: NativeWidgetObject;
-  constructor(name: string, layout: (p: WidgetBase<T>) => React.JSX.Element) {
+  constructor(
+    name: string,
+    layout: (props: T, environment: WidgetEnvironment) => React.JSX.Element
+  ) {
     this.nativeWidgetObject = new ExpoWidgetsModule.Widget(name, layout as unknown as string);
   }
 
@@ -174,7 +177,7 @@ export function after(date: Date): { after: Date } {
  */
 export function createWidget<T extends object = object>(
   name: string,
-  widget: (props: WidgetBase<T>) => React.JSX.Element
+  widget: (props: T, context: WidgetEnvironment) => React.JSX.Element
 ): Widget<T> {
   return new Widget<T>(name, widget);
 }

package/src/Widgets.types.ts

@@ -3,6 +3,30 @@ import { ReactNode } from 'react';
 
 import { after } from './Widgets';
 
+/**
+ * The rendering mode of the widget as provided by WidgetKit.
+ * - `fullColor` — Home screen widgets (default).
+ * - `accented` — Tinted widgets (iOS 18+) and watchOS.
+ * - `vibrant` — Lock screen widgets.
+ */
+export type WidgetRenderingMode = 'fullColor' | 'accented' | 'vibrant';
+
+/**
+ * The level of detail the view is recommended to have.
+ * The system can update the levelOfDetail value based on user proximity or other system specific factors and allow content customization adapting to show different levels of details.
+ * - `simplified` — The system recommends showing a simplified view with less details.
+ * - `default` — The system has no specific recommendation for the level of detail.
+ * @available iOS 26+
+ */
+export type LevelOfDetail = 'simplified' | 'default';
+
+/**
+ * The size family of the current Live Activity.
+ * A Live Activity you initiate on one device can also appear on a remote device that renders the Live Activity in a different family size. As a result, it renders for a specific family, depending on both the device and the location in which it appears.
+ * @available iOS 18+
+ */
+export type ActivityFamily = 'small' | 'medium';
+
 /**
  * The widget family (size).
  * - `systemSmall` - Small square widget (2x2 grid).
@@ -22,10 +46,7 @@ export type WidgetFamily =
   | 'accessoryRectangular'
   | 'accessoryInline';
 
-/**
- * Props passed to a widget component.
- */
-export type WidgetBase<T extends object = object> = {
+export type WidgetEnvironment = {
   /**
    * The date of this timeline entry.
    */
@@ -33,8 +54,77 @@ export type WidgetBase<T extends object = object> = {
   /**
    * The widget family.
    */
-  family: WidgetFamily;
-} & T;
+  widgetFamily: WidgetFamily;
+  /**
+   * The color scheme of the widget's environment.
+   */
+  colorScheme?: 'light' | 'dark';
+  /**
+   * A Boolean value that indicates whether the display or environment currently requires reduced luminance.
+   *
+   * When you detect this condition, lower the overall brightness of your view.
+   * For example, you can change large, filled shapes to be stroked, and choose less bright colors.
+   * @available iOS 16+
+   */
+  isLuminanceReduced?: boolean;
+  /**
+   * The widget's rendering mode, based on where the system is displaying it.
+   * @available iOS 16+
+   */
+  widgetRenderingMode?: WidgetRenderingMode;
+  /**
+   * A Boolean value that indicates whether an accessory family widget can display an accessory label.
+   * @available iOS 16+
+   */
+  showsWidgetLabel?: boolean;
+  /**
+   * The content margins for the widget.
+   * @available iOS 17+
+   */
+  widgetContentMargins?: {
+    top: number;
+    bottom: number;
+    leading: number;
+    trailing: number;
+  };
+  /**
+   * The level of detail the view is recommended to have.
+   * @available iOS 26+
+   */
+  levelOfDetail?: LevelOfDetail;
+};
+
+export type LiveActivityEnvironment = {
+  /**
+   * The color scheme of the activity's environment.
+   */
+  colorScheme: 'light' | 'dark';
+  /**
+   * Whether the activity is displayed in a context with reduced luminance.
+   * @available iOS 16+
+   */
+  isLuminanceReduced?: boolean;
+  /**
+   * Whether the activity is currently displayed in fullscreen.
+   * @available iOS 16.1+
+   */
+  isActivityFullscreen?: boolean;
+  /**
+   * A Boolean value that indicates whether the Live Activity update synchronization rate is reduced.
+   * @available iOS 18+
+   */
+  isActivityUpdateReduced?: boolean;
+  /**
+   * The size family of the current Live Activity.
+   * @available iOS 18+
+   */
+  activityFamily?: ActivityFamily;
+  /**
+   * The level of detail the view is recommended to have.
+   * @available iOS 26+
+   */
+  levelOfDetail?: LevelOfDetail;
+};
 
 export type WidgetTimelineEntry<T extends object = object> = {
   /**
@@ -97,7 +187,10 @@ export type LiveActivityLayout = {
 /**
  * A function that returns the layout for a Live Activity.
  */
-export type LiveActivityComponent<T extends object = object> = (props?: T) => LiveActivityLayout;
+export type LiveActivityComponent<T extends object = object> = (
+  props: T,
+  environment: LiveActivityEnvironment
+) => LiveActivityLayout;
 
 /**
  * Event emitted when a user interacts with a widget.

package/src/index.ts

@@ -1,6 +1,7 @@
 export * from './Widgets';
 export {
   ExpoWidgetsEvents,
+  LevelOfDetail,
   LiveActivityComponent,
   LiveActivityDismissalPolicy,
   LiveActivityEvents,
@@ -8,7 +9,8 @@ export {
   PushTokenEvent,
   PushToStartTokenEvent,
   UserInteractionEvent,
-  WidgetBase,
+  WidgetEnvironment,
   WidgetFamily,
+  WidgetRenderingMode,
   WidgetTimelineEntry,
 } from './Widgets.types';