expo-widgets 56.0.6 → 56.0.8

package/CHANGELOG.md

@@ -10,6 +10,23 @@
 
 ### 💡 Others
 
+## 56.0.8 — 2026-05-13
+
+### 🎉 New features
+
+- Support configurable widgets. ([#45726](https://github.com/expo/expo/pull/45726) by [@jakex7](https://github.com/jakex7))
+- Improve RedBox messages. ([#45732](https://github.com/expo/expo/pull/45732) by [@jakex7](https://github.com/jakex7))
+
+### 🐛 Bug fixes
+
+- Improve environment configuration types. ([#45734](https://github.com/expo/expo/pull/45734) by [@jakex7](https://github.com/jakex7))
+
+## 56.0.7 — 2026-05-13
+
+### 🎉 New features
+
+- Add `ChartView` support. ([#45674](https://github.com/expo/expo/pull/45674) by [@jakex7](https://github.com/jakex7))
+
 ## 56.0.6 — 2026-05-11
 
 _This version does not introduce any user-facing changes._

package/build/Widgets.d.ts

@@ -3,10 +3,10 @@ import type { ExpoWidgetsEvents, LiveActivityComponent, LiveActivityDismissalPol
 /**
  * Represents a widget instance. Provides methods to manage the widget's timeline.
  */
-export declare class Widget<T extends object = object> {
+export declare class Widget<PropsType extends object = object, ConfigurationType extends object | undefined = undefined> {
     /** @hidden */
     private nativeWidgetObject;
-    constructor(name: string, layout: (props: T, environment: WidgetEnvironment) => React.JSX.Element);
+    constructor(name: string, layout: (props: PropsType, environment: WidgetEnvironment<ConfigurationType>) => React.JSX.Element);
     /**
      * Force reloads the widget, causing it to refresh its content and timeline.
      */
@@ -15,16 +15,16 @@ export declare class Widget<T extends object = object> {
      * Schedules a series of updates for the widget's content and reloads the widget.
      * @param entries Timeline entries, each specifying a date and the props to display at that time.
      */
-    updateTimeline(entries: WidgetTimelineEntry<T>[]): void;
+    updateTimeline(entries: WidgetTimelineEntry<PropsType>[]): void;
     /**
      * Sets the widget's content to the given props immediately, without scheduling a timeline.
      * @param props The properties to display in the widget.
      */
-    updateSnapshot(props: T): void;
+    updateSnapshot(props: PropsType): void;
     /**
      * Returns the current timeline entries for the widget, including past and future entries.
      */
-    getTimeline(): Promise<WidgetTimelineEntry<T>[]>;
+    getTimeline(): Promise<WidgetTimelineEntry<PropsType>[]>;
 }
 /**
  * Represents a Live Activity instance. Provides methods to update its content and end it.
@@ -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: T, context: WidgetEnvironment) => React.JSX.Element): Widget<T>;
+export declare function createWidget<PropsType extends object = object, ConfigurationType extends object | undefined = undefined>(name: string, widget: (props: PropsType, context: WidgetEnvironment<ConfigurationType>) => React.JSX.Element): Widget<PropsType, ConfigurationType>;
 /**
  * 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,KAAK,EAAE,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"}
+{"version":3,"file":"Widgets.d.ts","sourceRoot":"","sources":["../src/Widgets.ts"],"names":[],"mappings":"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"}

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  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"]}
+{"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<\n  PropsType extends object = object,\n  ConfigurationType extends object | undefined = undefined,\n> {\n  /** @hidden */\n  private nativeWidgetObject: NativeWidgetObject;\n  constructor(\n    name: string,\n    layout: (\n      props: PropsType,\n      environment: WidgetEnvironment<ConfigurationType>\n    ) => 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<PropsType>[]) {\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: PropsType) {\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<PropsType>[]> {\n    return (await this.nativeWidgetObject.getTimeline()).map((entry) => ({\n      date: new Date(entry.timestamp),\n      props: entry.props as PropsType,\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<\n  PropsType extends object = object,\n  ConfigurationType extends object | undefined = undefined,\n>(\n  name: string,\n  widget: (props: PropsType, context: WidgetEnvironment<ConfigurationType>) => React.JSX.Element\n): Widget<PropsType, ConfigurationType> {\n  return new Widget<PropsType, ConfigurationType>(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

@@ -33,7 +33,7 @@ export type ActivityFamily = 'small' | 'medium';
  * - `accessoryInline` - Inline accessory widget for the Lock Screen.
  */
 export type WidgetFamily = 'systemSmall' | 'systemMedium' | 'systemLarge' | 'systemExtraLarge' | 'accessoryCircular' | 'accessoryRectangular' | 'accessoryInline';
-export type WidgetEnvironment = {
+export type WidgetEnvironment<T extends object | undefined = undefined> = {
     /**
      * The date of this timeline entry.
      */
@@ -79,6 +79,11 @@ export type WidgetEnvironment = {
      * @platform iOS 26+
      */
     levelOfDetail?: LevelOfDetail;
+    /**
+     * Widget configuration parameters.
+     * @platform iOS 17+
+     */
+    configuration: T;
 };
 export type LiveActivityEnvironment = {
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"Widgets.types.d.ts","sourceRoot":"","sources":["../src/Widgets.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AAErD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhD;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GACpB,aAAa,GACb,cAAc,GACd,aAAa,GACb,kBAAkB,GAClB,mBAAmB,GACnB,sBAAsB,GACtB,iBAAiB,CAAC;AAEtB,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;IACX;;OAEG;IACH,YAAY,EAAE,YAAY,CAAC;IAC3B;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC/B;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,oBAAoB,CAAC,EAAE;QACrB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC;;OAEG;IACH,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IAC3D;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;IACX;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC;CACV,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;IAClB;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;;OAEG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B;;OAEG;IACH,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B;;OAEG;IACH,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B;;OAEG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B;;OAEG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,CAC7D,KAAK,EAAE,CAAC,EACR,WAAW,EAAE,uBAAuB,KACjC,kBAAkB,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,IAAI,EAAE,4BAA4B,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,wBAAwB,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;AAE7F,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,4BAA4B,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACpE;;;OAGG;IACH,qCAAqC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAC/E,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;OAGG;IACH,0BAA0B,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC7D,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,YAAY;gBAC9C,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IACxC,MAAM,IAAI,IAAI;IACd,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAClD,WAAW,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAC5C;AAED,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,YAAY;gBACrD,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IACxC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,kBAAkB;IACtD,YAAY,IAAI,kBAAkB,EAAE;CACrC;AAED,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,YAAY,CAAC,kBAAkB,CAAC;IAC9E,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACpC,GAAG,CACD,eAAe,CAAC,EAAE,MAAM,EACxB,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAChB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CACvC"}
+{"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":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC","sourcesContent":["import { SharedObject } from 'expo';\nimport type { ReactNode } from 'react';\n\nimport type { 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 * @platform 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 * @platform 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   * @platform iOS 16+\n   */\n  isLuminanceReduced?: boolean;\n  /**\n   * The widget's rendering mode, based on where the system is displaying it.\n   * @platform iOS 16+\n   */\n  widgetRenderingMode?: WidgetRenderingMode;\n  /**\n   * A Boolean value that indicates whether an accessory family widget can display an accessory label.\n   * @platform iOS 16+\n   */\n  showsWidgetLabel?: boolean;\n  /**\n   * The content margins for the widget.\n   * @platform 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   * @platform 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   * @platform iOS 16+\n   */\n  isLuminanceReduced?: boolean;\n  /**\n   * Whether the activity is currently displayed in fullscreen.\n   * @platform iOS 16.1+\n   */\n  isActivityFullscreen?: boolean;\n  /**\n   * A Boolean value that indicates whether the Live Activity update synchronization rate is reduced.\n   * @platform iOS 18+\n   */\n  isActivityUpdateReduced?: boolean;\n  /**\n   * The size family of the current Live Activity.\n   * @platform iOS 18+\n   */\n  activityFamily?: ActivityFamily;\n  /**\n   * The level of detail the view is recommended to have.\n   * @platform 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"]}
+{"version":3,"file":"Widgets.types.js","sourceRoot":"","sources":["../src/Widgets.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC","sourcesContent":["import { SharedObject } from 'expo';\nimport type { ReactNode } from 'react';\n\nimport type { 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 * @platform 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 * @platform 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<T extends object | undefined = undefined> = {\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   * @platform iOS 16+\n   */\n  isLuminanceReduced?: boolean;\n  /**\n   * The widget's rendering mode, based on where the system is displaying it.\n   * @platform iOS 16+\n   */\n  widgetRenderingMode?: WidgetRenderingMode;\n  /**\n   * A Boolean value that indicates whether an accessory family widget can display an accessory label.\n   * @platform iOS 16+\n   */\n  showsWidgetLabel?: boolean;\n  /**\n   * The content margins for the widget.\n   * @platform 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   * @platform iOS 26+\n   */\n  levelOfDetail?: LevelOfDetail;\n  /**\n   * Widget configuration parameters.\n   * @platform iOS 17+\n   */\n  configuration: T;\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   * @platform iOS 16+\n   */\n  isLuminanceReduced?: boolean;\n  /**\n   * Whether the activity is currently displayed in fullscreen.\n   * @platform iOS 16.1+\n   */\n  isActivityFullscreen?: boolean;\n  /**\n   * A Boolean value that indicates whether the Live Activity update synchronization rate is reduced.\n   * @platform iOS 18+\n   */\n  isActivityUpdateReduced?: boolean;\n  /**\n   * The size family of the current Live Activity.\n   * @platform iOS 18+\n   */\n  activityFamily?: ActivityFamily;\n  /**\n   * The level of detail the view is recommended to have.\n   * @platform 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/ios/Widgets/DynamicView.swift

@@ -81,6 +81,8 @@ public struct WidgetsDynamicView: View, ExpoSwiftUI.AnyChild {
       render(UnevenRoundedRectangleView.self, UnevenRoundedRectangleViewProps.self)
     case "GaugeView":
       render(GaugeView.self, GaugeProps.self)
+    case "ChartView":
+      render(ChartView.self, ChartProps.self)
     case "Button":
       if #available(iOS 17.0, *) {
         switch kind {

package/ios/Widgets/EntryView.swift

@@ -25,13 +25,12 @@ public struct WidgetsEntryView: View {
   }
 
   public var body: some View {
-    let layout = WidgetsStorage.getString(forKey: "__expo_widgets_\(entry.name)_layout") ?? ""
-    let node = evaluateLayout(layout: layout, props: entry.props ?? [:], environment: widgetEnvironment)
-
-    if let node {
+    if let layout = WidgetsStorage.getString(forKey: "__expo_widgets_\(entry.name)_layout"),
+       !layout.isEmpty {
+      let node = evaluateLayout(layout: layout, props: entry.props ?? [:], environment: widgetEnvironment)
       WidgetsDynamicView(name: entry.name, kind: .widget, node: node, entryIndex: entry.entryIndex, environmentString: widgetEnvironmentString)
     } else {
-      EmptyView()
+      WidgetsDynamicView(name: entry.name, kind: .widget, node: createRedBox(message: "No layout found for \(WidgetsStorage.appGroupIdentifier ?? "")::\(entry.name)"), entryIndex: entry.entryIndex, environmentString: widgetEnvironmentString)
     }
   }
 }

package/ios/Widgets/Utils.swift

@@ -20,7 +20,7 @@ func parseTimeline(identifier: String, name: String, family: WidgetFamily) -> [W
   return entries.compactMap(\.self)
 }
 
-func createRedBox(message: String, stack: String? = nil) -> [String: Any] {
+public func createRedBox(message: String, stack: String? = nil) -> [String: Any] {
   var props: [String: Any] = ["message": message]
   if let stack {
     props["stack"] = stack
@@ -28,13 +28,13 @@ func createRedBox(message: String, stack: String? = nil) -> [String: Any] {
   return ["type": "RedBoxView", "props": props]
 }
 
-func evaluateLayout(
+public func evaluateLayout(
   layout: String,
   props: [String: Any],
   environment: [String: Any]
-) -> [String: Any]? {
+) -> [String: Any] {
   guard let context = createWidgetContext(layout: layout) else {
-    return nil
+    return createRedBox(message: "Could not create context for layout evaluation.")
   }
 
   let result = context.objectForKeyedSubscript("__expoWidgetRender")?.call(
@@ -44,7 +44,7 @@ func evaluateLayout(
     print("[ExpoWidgets] Layout evaluation failed: \(exception)")
     return createRedBox(message: exception.toString())
   }
-  return result?.toObject() as? [String: Any]
+  return result?.toObject() as? [String: Any] ?? createRedBox(message: "Expo widget render did not produce any results.")
 }
 
 func getLiveActivityNodes(forName name: String, props: String = "{}", environment: [String: Any]) -> [String: Any] {
@@ -52,7 +52,7 @@ func getLiveActivityNodes(forName name: String, props: String = "{}", environmen
   let propsData = props.data(using: .utf8)
   let propsDict = propsData.flatMap { try? JSONSerialization.jsonObject(with: $0, options: []) as? [String: Any] } ?? [:]
   guard let context = createWidgetContext(layout: layout) else {
-    return [:]
+    return ["banner": createRedBox(message: "Could not create context for layout evaluation.")]
   }
 
   var widgetEnvironment = environment
@@ -67,7 +67,7 @@ func getLiveActivityNodes(forName name: String, props: String = "{}", environmen
     return ["banner": createRedBox(message: exception.toString())]
   }
 
-  return result?.toObject() as? [String: Any] ?? [:]
+  return result?.toObject() as? [String: Any] ?? ["banner": createRedBox(message: "Expo widget render did not produce any results.")]
 }
 
 func getLiveActivityUrl(forName name: String) -> URL? {
@@ -77,7 +77,7 @@ func getLiveActivityUrl(forName name: String) -> URL? {
   return URL(string: urlString)
 }
 
-func getWidgetEnvironment(environment: EnvironmentValues) -> [String: Any] {
+public func getWidgetEnvironment(environment: EnvironmentValues) -> [String: Any] {
   var env: [String: Any] = [
     "showsContainerBackground": environment.showsWidgetContainerBackground,
     "widgetFamily": environment.widgetFamily.description,

package/ios/WidgetsStorage.swift

@@ -1,5 +1,5 @@
-enum WidgetsStorage {
-  static var appGroupIdentifier: String? = Bundle.main.object(forInfoDictionaryKey: "ExpoWidgetsAppGroupIdentifier") as? String
+public enum WidgetsStorage {
+  public static var appGroupIdentifier: String? = Bundle.main.object(forInfoDictionaryKey: "ExpoWidgetsAppGroupIdentifier") as? String
   static let defaults = UserDefaults(suiteName: appGroupIdentifier)
 
   static func set(_ value: [String: Any], forKey key: String) {
@@ -26,25 +26,25 @@ enum WidgetsStorage {
     defaults.set(value, forKey: key)
   }
 
-  static func getDictionary(forKey key: String) -> [String: Any]? {
+  public static func getDictionary(forKey key: String) -> [String: Any]? {
     guard let defaults else { return nil }
 
     return defaults.dictionary(forKey: key)
   }
 
-  static func getArray(forKey key: String) -> [Any]? {
+  public static func getArray(forKey key: String) -> [Any]? {
     guard let defaults else { return nil }
 
     return defaults.array(forKey: key)
   }
 
-  static func getData(forKey key: String) -> Data? {
+  public static func getData(forKey key: String) -> Data? {
     guard let defaults else { return nil }
 
     return defaults.data(forKey: key)
   }
 
-  static func getString(forKey key: String) -> String? {
+  public static func getString(forKey key: String) -> String? {
     guard let defaults else { return nil }
 
     return defaults.string(forKey: key)

package/package.json

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

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

@@ -5,4 +5,34 @@ export type WidgetConfig = {
     displayName: string;
     description: string;
     contentMarginsDisabled: boolean;
+    configuration?: {
+        title: string;
+        description?: string;
+        parameters: Record<string, WidgetParameter>;
+    };
 };
+export type WidgetParameterString = {
+    title: string;
+    type: 'string';
+    default: string;
+};
+export type WidgetParameterNumber = {
+    title: string;
+    type: 'number';
+    default: number;
+};
+export type WidgetParameterBoolean = {
+    title: string;
+    type: 'boolean';
+    default: boolean;
+};
+export type WidgetParameterEnum = {
+    title: string;
+    type: 'enum';
+    values: {
+        name: string;
+        value: string;
+    }[];
+    default: string;
+};
+export type WidgetParameter = WidgetParameterString | WidgetParameterNumber | WidgetParameterBoolean | WidgetParameterEnum;

package/plugin/build/withWidgetSourceFiles.js

@@ -112,11 +112,22 @@ const addIndexSwiftChunk = (widgets, index, isLastChunk) => `
 ${index === 0 ? '@main' : ''}
 struct ExportWidgets${index}: WidgetBundle {
   var body: some Widget {
-    ${widgets.map((widget) => `${widget.name}()`).join('\n\t')}
+    ${widgets
+    .map((widget) => {
+    if (widget.configuration) {
+        return `if #available(iOS 17.0, *) {
+      ${widget.name}()
+    }`;
+    }
+    return `${widget.name}()`;
+})
+    .join('\n    ')}
     ${!isLastChunk ? `ExportWidgets${index + 1}().body` : `WidgetLiveActivity()`}
   }
 }`;
-const widgetSwift = (widget) => `import WidgetKit
+const widgetSwift = (widget) => {
+    if (!widget.configuration)
+        return `import WidgetKit
 import SwiftUI
 internal import ExpoWidgets
 
@@ -132,6 +143,166 @@ struct ${widget.name}: Widget {
     .supportedFamilies([.${widget.supportedFamilies.join(', .')}])${widget.contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
   }
 }`;
+    return `import WidgetKit
+import SwiftUI
+import AppIntents
+internal import ExpoWidgets
+
+// AppIntent
+struct ${widget.name}ConfigurationAppIntent: WidgetConfigurationIntent {
+  static var title: LocalizedStringResource = "${widget.configuration?.title ?? widget.displayName} Configuration"
+${widget.configuration?.description ? `  static var description: LocalizedStringResource = "${widget.configuration?.description}"\n` : ''}
+${Object.entries(widget.configuration?.parameters ?? {})
+        .map(([name, param]) => {
+        let paramType;
+        switch (param.type) {
+            case 'string':
+                paramType = 'String';
+                break;
+            case 'number':
+                paramType = 'Double';
+                break;
+            case 'boolean':
+                paramType = 'Bool';
+                break;
+            case 'enum':
+                paramType = `${widget.name}${name[0]?.toUpperCase() + name.slice(1)}Enum`;
+                break;
+            default:
+                paramType = 'String';
+        }
+        return `  @Parameter(title: "${param.title}", default: ${param.type === 'string' ? `"${param.default}"` : param.type === 'number' ? param.default : param.type === 'boolean' ? param.default : `${widget.name}${name[0]?.toUpperCase() + name.slice(1)}Enum.${param.default}`})\n  var ${name}: ${paramType}`;
+    })
+        .join('\n')}
+
+  func perform() async throws -> some IntentResult {
+    return .result()
+  }
+}
+${Object.entries(widget.configuration?.parameters ?? {})
+        .map(([name, param]) => {
+        if (param.type !== 'enum')
+            return '';
+        const paramTypeName = `${widget.name}${name[0]?.toUpperCase() + name.slice(1)}Enum`;
+        return `
+enum ${paramTypeName}: String, CaseIterable, AppEnum {
+  ${param.values
+            .map((value) => {
+            return `case ${value.value}`;
+        })
+            .join('\n  ')}
+
+  static var typeDisplayRepresentation = TypeDisplayRepresentation(name: "${param.title}")
+
+  static var caseDisplayRepresentations: [${paramTypeName}: DisplayRepresentation] = [
+    ${param.values
+            .map((value) => {
+            return `.${value.value}: DisplayRepresentation(title: "${value.name}")`;
+        })
+            .join(',\n    ')}
+  ]
+}`;
+    })
+        .join('\n')}
+
+struct ${widget.name}TimelineEntry: TimelineEntry {
+  let date: Date
+  public let name: String
+  public let props: [String: Any]?
+  public let entryIndex: Int?
+  let configuration: ${widget.name}ConfigurationAppIntent
+}
+
+struct ${widget.name}TimelineProvider: AppIntentTimelineProvider {
+  func placeholder(in context: Context) -> ${widget.name}TimelineEntry {
+    ${widget.name}TimelineEntry(date: Date(), name: "${widget.name}", props: nil, entryIndex: nil, configuration: ${widget.name}ConfigurationAppIntent())
+  }
+
+  func snapshot(for configuration: ${widget.name}ConfigurationAppIntent, in context: Context) async -> ${widget.name}TimelineEntry {
+    let entries = parseTimeline(configuration: configuration)
+    return entries.first ?? ${widget.name}TimelineEntry(date: Date(), name: "${widget.name}", props: nil, entryIndex: nil, configuration: configuration)
+  }
+
+  func timeline(for configuration: ${widget.name}ConfigurationAppIntent, in context: Context) async -> Timeline<${widget.name}TimelineEntry> {
+    let entries = self.parseTimeline(configuration: configuration)
+    let timeline = Timeline<${widget.name}TimelineEntry>(entries: entries, policy: .atEnd)
+    return timeline
+  }
+  
+  func parseTimeline(configuration: ${widget.name}ConfigurationAppIntent) -> [${widget.name}TimelineEntry] {
+    let timeline = WidgetsStorage.getArray(forKey: "__expo_widgets_${widget.name}_timeline") ?? []
+    let entries: [${widget.name}TimelineEntry?] = timeline.enumerated().map { index, entry in
+      guard let entry = entry as? [String: Any], let timestamp = entry["timestamp"] as? Int, let props = entry["props"] as? [String: Any] else {
+        return nil
+      }
+      return ${widget.name}TimelineEntry(
+        date: Date(timeIntervalSince1970: Double(timestamp) / 1000),
+        name: "${widget.name}",
+        props: props,
+        entryIndex: index,
+        configuration: configuration
+      )
+    }
+
+    return entries.compactMap(\\.self)
+  }
+}
+
+struct ${widget.name}EntryView: View {
+  @Environment(\\.self) var environment
+  var entry: ${widget.name}TimelineProvider.Entry
+
+  init(entry: ${widget.name}TimelineProvider.Entry) {
+    self.entry = entry
+  }
+
+  private var widgetEnvironment: [String: Any] {
+    var env: [String: Any] = getWidgetEnvironment(environment: environment)
+    env["timestamp"] = Int(entry.date.timeIntervalSince1970 * 1000)
+    env["configuration"] = [
+${Object.entries(widget.configuration?.parameters ?? {})
+        .map(([name, param]) => {
+        return `      "${name}": entry.configuration.${name}${param.type === 'enum' ? '.rawValue' : ''}`;
+    })
+        .join(',\n')}
+    ]
+    return env
+  }
+
+  private var widgetEnvironmentString: String? {
+    guard let data = try? JSONSerialization.data(withJSONObject: widgetEnvironment),
+          let jsonString = String(data: data, encoding: .utf8) else {
+        return nil
+    }
+    return jsonString
+  }
+
+  public var body: some View {
+    if let layout = WidgetsStorage.getString(forKey: "__expo_widgets_\\(entry.name)_layout"),
+       !layout.isEmpty {
+      let node = evaluateLayout(layout: layout, props: entry.props ?? [:], environment: widgetEnvironment)
+      WidgetsDynamicView(name: entry.name, kind: .widget, node: node, entryIndex: entry.entryIndex, environmentString: widgetEnvironmentString)
+    } else {
+      WidgetsDynamicView(name: entry.name, kind: .widget, node: createRedBox(message: "No layout found for \\(WidgetsStorage.appGroupIdentifier ?? "")::\\(entry.name)"), entryIndex: entry.entryIndex, environmentString: widgetEnvironmentString)
+    }
+  }
+}
+
+
+@available(iOS 17.0, *)
+struct ${widget.name}: Widget {
+  let name: String = "${widget.name}"
+
+  var body: some WidgetConfiguration {
+    return AppIntentConfiguration(kind: name, intent: ${widget.name}ConfigurationAppIntent.self, provider: ${widget.name}TimelineProvider()) { entry in
+      ${widget.name}EntryView(entry: entry)
+    }
+    .configurationDisplayName("${widget.displayName}")
+    .description("${widget.description}")
+    .supportedFamilies([.${widget.supportedFamilies.join(', .')}])${widget.contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
+  }
+}`;
+};
 const infoPlist = (groupIdentifier, marketingVersion, bundleVersion) => `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">

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

@@ -6,4 +6,40 @@ export type WidgetConfig = {
   displayName: string;
   description: string;
   contentMarginsDisabled: boolean;
+  configuration?: {
+    title: string;
+    description?: string;
+    parameters: Record<string, WidgetParameter>;
+  };
 };
+
+export type WidgetParameterString = {
+  title: string;
+  type: 'string';
+  default: string;
+};
+export type WidgetParameterNumber = {
+  title: string;
+  type: 'number';
+  default: number;
+};
+export type WidgetParameterBoolean = {
+  title: string;
+  type: 'boolean';
+  default: boolean;
+};
+export type WidgetParameterEnum = {
+  title: string;
+  type: 'enum';
+  values: {
+    name: string;
+    value: string;
+  }[];
+  default: string;
+};
+
+export type WidgetParameter =
+  | WidgetParameterString
+  | WidgetParameterNumber
+  | WidgetParameterBoolean
+  | WidgetParameterEnum;

package/plugin/src/withWidgetSourceFiles.ts

@@ -116,12 +116,23 @@ const addIndexSwiftChunk = (
 ${index === 0 ? '@main' : ''}
 struct ExportWidgets${index}: WidgetBundle {
   var body: some Widget {
-    ${widgets.map((widget) => `${widget.name}()`).join('\n\t')}
+    ${widgets
+      .map((widget) => {
+        if (widget.configuration) {
+          return `if #available(iOS 17.0, *) {
+      ${widget.name}()
+    }`;
+        }
+        return `${widget.name}()`;
+      })
+      .join('\n    ')}
     ${!isLastChunk ? `ExportWidgets${index + 1}().body` : `WidgetLiveActivity()`}
   }
 }`;
 
-const widgetSwift = (widget: WidgetConfig): string => `import WidgetKit
+const widgetSwift = (widget: WidgetConfig): string => {
+  if (!widget.configuration)
+    return `import WidgetKit
 import SwiftUI
 internal import ExpoWidgets
 
@@ -137,6 +148,165 @@ struct ${widget.name}: Widget {
     .supportedFamilies([.${widget.supportedFamilies.join(', .')}])${widget.contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
   }
 }`;
+  return `import WidgetKit
+import SwiftUI
+import AppIntents
+internal import ExpoWidgets
+
+// AppIntent
+struct ${widget.name}ConfigurationAppIntent: WidgetConfigurationIntent {
+  static var title: LocalizedStringResource = "${widget.configuration?.title ?? widget.displayName} Configuration"
+${widget.configuration?.description ? `  static var description: LocalizedStringResource = "${widget.configuration?.description}"\n` : ''}
+${Object.entries(widget.configuration?.parameters ?? {})
+  .map(([name, param]) => {
+    let paramType: string;
+    switch (param.type) {
+      case 'string':
+        paramType = 'String';
+        break;
+      case 'number':
+        paramType = 'Double';
+        break;
+      case 'boolean':
+        paramType = 'Bool';
+        break;
+      case 'enum':
+        paramType = `${widget.name}${name[0]?.toUpperCase() + name.slice(1)}Enum`;
+        break;
+      default:
+        paramType = 'String';
+    }
+    return `  @Parameter(title: "${param.title}", default: ${param.type === 'string' ? `"${param.default}"` : param.type === 'number' ? param.default : param.type === 'boolean' ? param.default : `${widget.name}${name[0]?.toUpperCase() + name.slice(1)}Enum.${param.default}`})\n  var ${name}: ${paramType}`;
+  })
+  .join('\n')}
+
+  func perform() async throws -> some IntentResult {
+    return .result()
+  }
+}
+${Object.entries(widget.configuration?.parameters ?? {})
+  .map(([name, param]) => {
+    if (param.type !== 'enum') return '';
+    const paramTypeName = `${widget.name}${name[0]?.toUpperCase() + name.slice(1)}Enum`;
+    return `
+enum ${paramTypeName}: String, CaseIterable, AppEnum {
+  ${param.values
+    .map((value) => {
+      return `case ${value.value}`;
+    })
+    .join('\n  ')}
+
+  static var typeDisplayRepresentation = TypeDisplayRepresentation(name: "${param.title}")
+
+  static var caseDisplayRepresentations: [${paramTypeName}: DisplayRepresentation] = [
+    ${param.values
+      .map((value) => {
+        return `.${value.value}: DisplayRepresentation(title: "${value.name}")`;
+      })
+      .join(',\n    ')}
+  ]
+}`;
+  })
+  .join('\n')}
+
+struct ${widget.name}TimelineEntry: TimelineEntry {
+  let date: Date
+  public let name: String
+  public let props: [String: Any]?
+  public let entryIndex: Int?
+  let configuration: ${widget.name}ConfigurationAppIntent
+}
+
+struct ${widget.name}TimelineProvider: AppIntentTimelineProvider {
+  func placeholder(in context: Context) -> ${widget.name}TimelineEntry {
+    ${widget.name}TimelineEntry(date: Date(), name: "${widget.name}", props: nil, entryIndex: nil, configuration: ${widget.name}ConfigurationAppIntent())
+  }
+
+  func snapshot(for configuration: ${widget.name}ConfigurationAppIntent, in context: Context) async -> ${widget.name}TimelineEntry {
+    let entries = parseTimeline(configuration: configuration)
+    return entries.first ?? ${widget.name}TimelineEntry(date: Date(), name: "${widget.name}", props: nil, entryIndex: nil, configuration: configuration)
+  }
+
+  func timeline(for configuration: ${widget.name}ConfigurationAppIntent, in context: Context) async -> Timeline<${widget.name}TimelineEntry> {
+    let entries = self.parseTimeline(configuration: configuration)
+    let timeline = Timeline<${widget.name}TimelineEntry>(entries: entries, policy: .atEnd)
+    return timeline
+  }
+  
+  func parseTimeline(configuration: ${widget.name}ConfigurationAppIntent) -> [${widget.name}TimelineEntry] {
+    let timeline = WidgetsStorage.getArray(forKey: "__expo_widgets_${widget.name}_timeline") ?? []
+    let entries: [${widget.name}TimelineEntry?] = timeline.enumerated().map { index, entry in
+      guard let entry = entry as? [String: Any], let timestamp = entry["timestamp"] as? Int, let props = entry["props"] as? [String: Any] else {
+        return nil
+      }
+      return ${widget.name}TimelineEntry(
+        date: Date(timeIntervalSince1970: Double(timestamp) / 1000),
+        name: "${widget.name}",
+        props: props,
+        entryIndex: index,
+        configuration: configuration
+      )
+    }
+
+    return entries.compactMap(\\.self)
+  }
+}
+
+struct ${widget.name}EntryView: View {
+  @Environment(\\.self) var environment
+  var entry: ${widget.name}TimelineProvider.Entry
+
+  init(entry: ${widget.name}TimelineProvider.Entry) {
+    self.entry = entry
+  }
+
+  private var widgetEnvironment: [String: Any] {
+    var env: [String: Any] = getWidgetEnvironment(environment: environment)
+    env["timestamp"] = Int(entry.date.timeIntervalSince1970 * 1000)
+    env["configuration"] = [
+${Object.entries(widget.configuration?.parameters ?? {})
+  .map(([name, param]) => {
+    return `      "${name}": entry.configuration.${name}${param.type === 'enum' ? '.rawValue' : ''}`;
+  })
+  .join(',\n')}
+    ]
+    return env
+  }
+
+  private var widgetEnvironmentString: String? {
+    guard let data = try? JSONSerialization.data(withJSONObject: widgetEnvironment),
+          let jsonString = String(data: data, encoding: .utf8) else {
+        return nil
+    }
+    return jsonString
+  }
+
+  public var body: some View {
+    if let layout = WidgetsStorage.getString(forKey: "__expo_widgets_\\(entry.name)_layout"),
+       !layout.isEmpty {
+      let node = evaluateLayout(layout: layout, props: entry.props ?? [:], environment: widgetEnvironment)
+      WidgetsDynamicView(name: entry.name, kind: .widget, node: node, entryIndex: entry.entryIndex, environmentString: widgetEnvironmentString)
+    } else {
+      WidgetsDynamicView(name: entry.name, kind: .widget, node: createRedBox(message: "No layout found for \\(WidgetsStorage.appGroupIdentifier ?? "")::\\(entry.name)"), entryIndex: entry.entryIndex, environmentString: widgetEnvironmentString)
+    }
+  }
+}
+
+
+@available(iOS 17.0, *)
+struct ${widget.name}: Widget {
+  let name: String = "${widget.name}"
+
+  var body: some WidgetConfiguration {
+    return AppIntentConfiguration(kind: name, intent: ${widget.name}ConfigurationAppIntent.self, provider: ${widget.name}TimelineProvider()) { entry in
+      ${widget.name}EntryView(entry: entry)
+    }
+    .configurationDisplayName("${widget.displayName}")
+    .description("${widget.description}")
+    .supportedFamilies([.${widget.supportedFamilies.join(', .')}])${widget.contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
+  }
+}`;
+};
 
 const infoPlist = (
   groupIdentifier: string,

package/src/Widgets.ts

@@ -16,12 +16,18 @@ import type {
 /**
  * Represents a widget instance. Provides methods to manage the widget's timeline.
  */
-export class Widget<T extends object = object> {
+export class Widget<
+  PropsType extends object = object,
+  ConfigurationType extends object | undefined = undefined,
+> {
   /** @hidden */
   private nativeWidgetObject: NativeWidgetObject;
   constructor(
     name: string,
-    layout: (props: T, environment: WidgetEnvironment) => React.JSX.Element
+    layout: (
+      props: PropsType,
+      environment: WidgetEnvironment<ConfigurationType>
+    ) => React.JSX.Element
   ) {
     this.nativeWidgetObject = new ExpoWidgetsModule.Widget(name, layout as unknown as string);
   }
@@ -37,7 +43,7 @@ export class Widget<T extends object = object> {
    * Schedules a series of updates for the widget's content and reloads the widget.
    * @param entries Timeline entries, each specifying a date and the props to display at that time.
    */
-  updateTimeline(entries: WidgetTimelineEntry<T>[]) {
+  updateTimeline(entries: WidgetTimelineEntry<PropsType>[]) {
     this.nativeWidgetObject.updateTimeline(
       entries.map((entry) => ({ timestamp: entry.date.getTime(), props: entry.props }))
     );
@@ -47,17 +53,17 @@ export class Widget<T extends object = object> {
    * Sets the widget's content to the given props immediately, without scheduling a timeline.
    * @param props The properties to display in the widget.
    */
-  updateSnapshot(props: T) {
+  updateSnapshot(props: PropsType) {
     this.nativeWidgetObject.updateTimeline([{ timestamp: Date.now(), props }]);
   }
 
   /**
    * Returns the current timeline entries for the widget, including past and future entries.
    */
-  async getTimeline(): Promise<WidgetTimelineEntry<T>[]> {
+  async getTimeline(): Promise<WidgetTimelineEntry<PropsType>[]> {
     return (await this.nativeWidgetObject.getTimeline()).map((entry) => ({
       date: new Date(entry.timestamp),
-      props: entry.props as T,
+      props: entry.props as PropsType,
     }));
   }
 }
@@ -175,11 +181,14 @@ export function after(date: Date): { after: 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 function createWidget<T extends object = object>(
+export function createWidget<
+  PropsType extends object = object,
+  ConfigurationType extends object | undefined = undefined,
+>(
   name: string,
-  widget: (props: T, context: WidgetEnvironment) => React.JSX.Element
-): Widget<T> {
-  return new Widget<T>(name, widget);
+  widget: (props: PropsType, context: WidgetEnvironment<ConfigurationType>) => React.JSX.Element
+): Widget<PropsType, ConfigurationType> {
+  return new Widget<PropsType, ConfigurationType>(name, widget);
 }
 
 /**

package/src/Widgets.types.ts

@@ -46,7 +46,7 @@ export type WidgetFamily =
   | 'accessoryRectangular'
   | 'accessoryInline';
 
-export type WidgetEnvironment = {
+export type WidgetEnvironment<T extends object | undefined = undefined> = {
   /**
    * The date of this timeline entry.
    */
@@ -92,6 +92,11 @@ export type WidgetEnvironment = {
    * @platform iOS 26+
    */
   levelOfDetail?: LevelOfDetail;
+  /**
+   * Widget configuration parameters.
+   * @platform iOS 17+
+   */
+  configuration: T;
 };
 
 export type LiveActivityEnvironment = {

package/plugin/tsconfig.tsbuildinfo

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