expo-widgets 55.0.1 → 55.0.2

package/CHANGELOG.md

@@ -10,6 +10,20 @@
 
 ### 💡 Others
 
+## 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))
+
+### 🐛 Bug fixes
+
+- Add missing project root to `watchFolders` in `metro.config.js` ([#43449](https://github.com/expo/expo/pull/43449) by [@kitten](https://github.com/kitten))
+
+### 💡 Others
+
+- Remove extraneous `@expo/config-plugins` dependency ([#43452](https://github.com/expo/expo/pull/43452) by [@kitten](https://github.com/kitten))
+
 ## 55.0.1 — 2026-02-25
 
 ### 🐛 Bug fixes

package/build/Widgets.d.ts

@@ -41,8 +41,11 @@ export declare class LiveActivity<T extends object = object> {
     /**
      * Ends the Live Activity.
      * @param dismissalPolicy Controls when the Live Activity is removed from the Lock Screen after ending.
+     * Can be `'default'`, `'immediate'`, or `after(date)`.
+     * @param props Final content properties to update after the activity ends.
+     * @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.
      */
-    end(dismissalPolicy?: LiveActivityDismissalPolicy): Promise<void>;
+    end(dismissalPolicy?: LiveActivityDismissalPolicy, props?: T, contentDate?: Date): Promise<void>;
     /**
      * Returns the push token for this Live Activity, used to send push notification updates via APNs.
      * Returns `null` if push notifications are not enabled or the token is not yet available.
@@ -75,6 +78,14 @@ export declare class LiveActivityFactory<T extends object = object> {
      */
     getInstances(): LiveActivity<T>[];
 }
+/**
+ * Creates a dismissal policy that removes the Live Activity at the specified time within a four-hour window.
+ * @param date The date after which the Live Activity should be removed from the Lock Screen.
+ * @hidden
+ */
+export declare function after(date: Date): {
+    after: Date;
+};
 /**
  * Creates a Widget instance.
  * @param name The widget 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;;;OAGG;IACH,GAAG,CAAC,eAAe,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE;;;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,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,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"}

package/build/Widgets.js

@@ -57,9 +57,18 @@ export class LiveActivity {
     /**
      * Ends the Live Activity.
      * @param dismissalPolicy Controls when the Live Activity is removed from the Lock Screen after ending.
+     * Can be `'default'`, `'immediate'`, or `after(date)`.
+     * @param props Final content properties to update after the activity ends.
+     * @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.
      */
-    end(dismissalPolicy) {
-        return this.nativeLiveActivity.end(dismissalPolicy);
+    end(dismissalPolicy, props, contentDate) {
+        const serializedProps = props ? JSON.stringify(props) : undefined;
+        if (typeof dismissalPolicy === 'object' &&
+            dismissalPolicy !== null &&
+            'after' in dismissalPolicy) {
+            return this.nativeLiveActivity.end('after', dismissalPolicy.after?.getTime(), serializedProps, contentDate?.getTime());
+        }
+        return this.nativeLiveActivity.end(dismissalPolicy, undefined, serializedProps, contentDate?.getTime());
     }
     /**
      * Returns the push token for this Live Activity, used to send push notification updates via APNs.
@@ -105,6 +114,14 @@ export class LiveActivityFactory {
             .map((instance) => new LiveActivity(instance));
     }
 }
+/**
+ * Creates a dismissal policy that removes the Live Activity at the specified time within a four-hour window.
+ * @param date The date after which the Live Activity should be removed from the Lock Screen.
+ * @hidden
+ */
+export function after(date) {
+    return { after: date };
+}
 /**
  * Creates a Widget instance.
  * @param name The widget name. Must match the `'name'` field in your widget configuration in the app config.

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   */\n  end(dismissalPolicy?: LiveActivityDismissalPolicy): Promise<void> {\n    return this.nativeLiveActivity.end(dismissalPolicy);\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 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  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"]}

package/build/Widgets.types.d.ts

@@ -1,5 +1,6 @@
 import { SharedObject } from 'expo';
 import { ReactNode } from 'react';
+import { after } from './Widgets';
 /**
  * The widget family (size).
  * - `systemSmall` - Small square widget (2x2 grid).
@@ -128,8 +129,11 @@ export type PushToStartTokenEvent = {
 };
 /**
  * Dismissal policy for ending a live activity.
+ * - `'default'` - The system’s default dismissal policy for the Live Activity.
+ * - `'immediate'` - The system immediately removes the Live Activity that ended.
+ * - `after(date)` - The system removes the Live Activity that ended at the specified time within a four-hour window.
  */
-export type LiveActivityDismissalPolicy = 'default' | 'immediate';
+export type LiveActivityDismissalPolicy = 'default' | 'immediate' | ReturnType<typeof after>;
 export type ExpoWidgetsEvents = {
     /**
      * Function that is invoked when user interacts with a widget.
@@ -162,7 +166,7 @@ export declare class NativeLiveActivityFactory extends SharedObject {
 }
 export declare class NativeLiveActivity extends SharedObject<LiveActivityEvents> {
     update(props: string): Promise<void>;
-    end(dismissalPolicy?: LiveActivityDismissalPolicy): Promise<void>;
+    end(dismissalPolicy?: string, afterDate?: number, state?: string, contentDate?: number): Promise<void>;
     getPushToken(): Promise<string | null>;
 }
 //# sourceMappingURL=Widgets.types.d.ts.map

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\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 */\nexport type LiveActivityDismissalPolicy = 'default' | 'immediate';\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(dismissalPolicy?: LiveActivityDismissalPolicy): 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 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"]}

package/ios/LiveActivity.swift

@@ -23,22 +23,25 @@ final class LiveActivity: SharedObject {
     await activity.update(ActivityContent(state: newState, staleDate: nil))
   }
 
-  func end(dismissalPolicy: String?) async throws {
+  func end(dismissalPolicy: LiveActivityDismissalPolicy?, afterDate: Date?, props: String?, contentDate: Date?) async throws {
     guard #available(iOS 16.2, *) else { throw LiveActivitiesNotSupportedException() }
 
     guard let activity = Activity<LiveActivityAttributes>.activities.first(where: { $0.id == id }) else {
       throw LiveActivityNotFoundException(id)
     }
 
-    let policy: ActivityUIDismissalPolicy
-    switch dismissalPolicy {
-    case "immediate":
-      policy = .immediate
-    default:
-      policy = .default
+    let content: ActivityContent<LiveActivityAttributes.ContentState>?
+    if let props {
+      content = ActivityContent(state: LiveActivityAttributes.ContentState(name: name, props: props), staleDate: nil)
+    } else {
+      content = nil
     }
 
-    await activity.end(dismissalPolicy: policy)
+    guard let contentDate, #available(iOS 17.2, *) else {
+      return await activity.end(content, dismissalPolicy: dismissalPolicy?.toDismissalPolicy(date: afterDate) ?? .default)
+    }
+
+    await activity.end(content, dismissalPolicy: dismissalPolicy?.toDismissalPolicy(date: afterDate) ?? .default, timestamp: contentDate)
   }
 
   func getPushToken() throws -> String? {

package/ios/WidgetsModule.swift

@@ -86,8 +86,8 @@ public final class WidgetsModule: Module {
         try await instance.update(props: props)
       }
 
-      AsyncFunction("end") { (instance: LiveActivity, dismissalPolicy: String?) in
-        try await instance.end(dismissalPolicy: dismissalPolicy)
+      AsyncFunction("end") { (instance: LiveActivity, dismissalPolicy: LiveActivityDismissalPolicy?, afterDate: Date?, props: String?, contentDate: Date?) in
+        try await instance.end(dismissalPolicy: dismissalPolicy, afterDate: afterDate, props: props, contentDate: contentDate)
       }
 
       AsyncFunction("getPushToken") { (instance: LiveActivity) in

package/ios/WidgetsRecords.swift

@@ -1,6 +1,22 @@
 import ExpoModulesCore
+import ActivityKit
 
 struct WidgetsJSTimelineEntry: Record {
   @Field var timestamp: Int
   @Field var props: [String: Any] = [:]
 }
+
+internal enum LiveActivityDismissalPolicy: String, Enumerable {
+  case `default`
+  case immediate
+  case after
+
+  @available(iOS 16.1, *)
+  internal func toDismissalPolicy(date: Date?) -> ActivityUIDismissalPolicy {
+    return switch self {
+    case .default: .default
+    case .immediate: .immediate
+    case .after: .after(date ?? Date.now)
+    }
+  }
+}

package/metro.config.js

@@ -1,19 +1,26 @@
 const { getDefaultConfig } = require('expo/metro-config');
 const path = require('path');
 
-const config = getDefaultConfig(process.cwd());
+const projectRoot = process.cwd();
+const config = getDefaultConfig(projectRoot);
 
 const expoStubPath = path.resolve(__dirname, './bundle/expo-module-stub.ts');
 const reactStubPath = path.resolve(__dirname, './bundle/react-stub.ts');
 const jsxRuntimeStubPath = path.resolve(__dirname, './bundle/jsx-runtime-stub.ts');
 
+// The `projectRoot` won't be included by default, since we alter it to be `__dirname`
+// to bundle from `expo-widgets` as the main module
+// NOTE: We check the `watchFolders` to start with `projectRoot`, since `expo/metro-config`
+// might add folders if we're in a monorepo
+const watchFolders = config.watchFolders;
+if (!watchFolders.some((entry) => !entry.startsWith(projectRoot))) {
+  watchFolders.push(projectRoot);
+}
+
 const buildConfig = {
   ...config,
-  projectRoot: __dirname,
-  watchFolders: [
-    ...config.watchFolders,
-    __dirname,
-  ],
+  projectRoot: __dirname, // Override root to be expo-widgets
+  watchFolders,
   resolver: {
     ...config.resolver,
     resolveRequest(context, moduleName, platform) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-widgets",
-  "version": "55.0.1",
+  "version": "55.0.2",
   "description": "Widgets.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -32,10 +32,8 @@
   "license": "MIT",
   "homepage": "https://docs.expo.dev/versions/latest/sdk/widgets/",
   "dependencies": {
-    "@expo/config-plugins": "~55.0.6",
-    "@expo/config-types": "^55.0.5",
     "@expo/plist": "^0.5.2",
-    "@expo/ui": "55.0.1"
+    "@expo/ui": "~55.0.1"
   },
   "devDependencies": {
     "expo-module-scripts": "^55.0.2"
@@ -44,5 +42,5 @@
     "expo": "*",
     "react": "*"
   },
-  "gitHead": "39a7a009e215eb71a112f4a20dba2d471ab21108"
+  "gitHead": "413b0450434d3e456eb391eca792ee9ac1e1efec"
 }

package/plugin/build/withIosWarning.d.ts

@@ -1,4 +1,4 @@
-import { ConfigPlugin } from '@expo/config-plugins';
+import { ConfigPlugin } from 'expo/config-plugins';
 type WithIosWarningProps = {
     property: string;
     warning: string;

package/plugin/build/withIosWarning.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const config_plugins_1 = require("@expo/config-plugins");
+const config_plugins_1 = require("expo/config-plugins");
 // Hack to display the warning only once
 const withIosWarning = (config, { property, warning }) => (0, config_plugins_1.withInfoPlist)(config, (config) => {
     config_plugins_1.WarningAggregator.addWarningIOS(property, warning);

package/plugin/src/withIosWarning.ts

@@ -1,5 +1,5 @@
-import { ConfigPlugin, WarningAggregator, withInfoPlist } from '@expo/config-plugins';
-import { ExpoConfig } from '@expo/config-types';
+import type { ExpoConfig } from 'expo/config';
+import { ConfigPlugin, WarningAggregator, withInfoPlist } from 'expo/config-plugins';
 
 type WithIosWarningProps = { property: string; warning: string };
 

package/src/Widgets.ts

@@ -80,9 +80,30 @@ export class LiveActivity<T extends object = object> {
   /**
    * Ends the Live Activity.
    * @param dismissalPolicy Controls when the Live Activity is removed from the Lock Screen after ending.
+   * Can be `'default'`, `'immediate'`, or `after(date)`.
+   * @param props Final content properties to update after the activity ends.
+   * @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.
    */
-  end(dismissalPolicy?: LiveActivityDismissalPolicy): Promise<void> {
-    return this.nativeLiveActivity.end(dismissalPolicy);
+  end(dismissalPolicy?: LiveActivityDismissalPolicy, props?: T, contentDate?: Date): Promise<void> {
+    const serializedProps = props ? JSON.stringify(props) : undefined;
+    if (
+      typeof dismissalPolicy === 'object' &&
+      dismissalPolicy !== null &&
+      'after' in dismissalPolicy
+    ) {
+      return this.nativeLiveActivity.end(
+        'after',
+        dismissalPolicy.after?.getTime(),
+        serializedProps,
+        contentDate?.getTime()
+      );
+    }
+    return this.nativeLiveActivity.end(
+      dismissalPolicy,
+      undefined,
+      serializedProps,
+      contentDate?.getTime()
+    );
   }
 
   /**
@@ -137,6 +158,15 @@ export class LiveActivityFactory<T extends object = object> {
   }
 }
 
+/**
+ * Creates a dismissal policy that removes the Live Activity at the specified time within a four-hour window.
+ * @param date The date after which the Live Activity should be removed from the Lock Screen.
+ * @hidden
+ */
+export function after(date: Date): { after: Date } {
+  return { after: date };
+}
+
 /**
  * Creates a Widget instance.
  * @param name The widget name. Must match the `'name'` field in your widget configuration in the app config.

package/src/Widgets.types.ts

@@ -1,6 +1,8 @@
 import { SharedObject } from 'expo';
 import { ReactNode } from 'react';
 
+import { after } from './Widgets';
+
 /**
  * The widget family (size).
  * - `systemSmall` - Small square widget (2x2 grid).
@@ -145,8 +147,11 @@ export type PushToStartTokenEvent = {
 
 /**
  * Dismissal policy for ending a live activity.
+ * - `'default'` - The system’s default dismissal policy for the Live Activity.
+ * - `'immediate'` - The system immediately removes the Live Activity that ended.
+ * - `after(date)` - The system removes the Live Activity that ended at the specified time within a four-hour window.
  */
-export type LiveActivityDismissalPolicy = 'default' | 'immediate';
+export type LiveActivityDismissalPolicy = 'default' | 'immediate' | ReturnType<typeof after>;
 
 export type ExpoWidgetsEvents = {
   /**
@@ -184,6 +189,11 @@ export declare class NativeLiveActivityFactory extends SharedObject {
 
 export declare class NativeLiveActivity extends SharedObject<LiveActivityEvents> {
   update(props: string): Promise<void>;
-  end(dismissalPolicy?: LiveActivityDismissalPolicy): Promise<void>;
+  end(
+    dismissalPolicy?: string,
+    afterDate?: number,
+    state?: string,
+    contentDate?: number
+  ): Promise<void>;
   getPushToken(): Promise<string | null>;
 }