expo-live-activity 0.4.1 → 0.4.3-alpha1

package/Package.swift

@@ -0,0 +1,16 @@
+// swift-tools-version: 5.7
+
+import PackageDescription
+
+let package = Package(
+  name: "ExpoLiveActivity",
+  platforms: [.iOS(.v16)],
+  products: [.library(name: "ExpoLiveActivity", targets: ["ExpoLiveActivity"])],
+  targets: [
+    .target(
+      name: "ExpoLiveActivity",
+      path: "ios-files",
+      exclude: ["LiveActivityWidgetBundle.swift"]
+    ),
+  ]
+)

package/README.md

@@ -44,7 +44,7 @@ The module comes with a built-in config plugin that creates a target in iOS with
      }
    }
    ```
-   If you want to update Live Acitivity with push notifications you can add option `"enablePushNotifications": true`:
+   If you want to update Live Activity with push notifications you can add option `"enablePushNotifications": true`:
    ```json
    {
      "expo": {
@@ -62,11 +62,14 @@ The module comes with a built-in config plugin that creates a target in iOS with
 2. **Assets configuration:**
    Place images intended for Live Activities in the `assets/liveActivity` folder. The plugin manages these assets automatically.
 
-Then prebuild your app with:
+   Then prebuild your app with:
 
-```sh
-npx expo prebuild --clean
-```
+   ```sh
+   npx expo prebuild --clean
+   ```
+
+> [!NOTE]
+> Because of iOS limitations, the assets can't be bigger than 4KB ([native Live Activity documentation](https://developer.apple.com/documentation/activitykit/displaying-live-data-with-live-activities#Understand-constraints))
 
 ### Step 3: Usage in Your React Native App
 
@@ -153,7 +156,9 @@ The `config` object should include:
    timerType?: DynamicIslandTimerType; // "circular" | "digital" - defines timer appearance on the dynamic island
    padding?: Padding // number | {top?: number bottom?: number ...}
    imagePosition?: ImagePosition; // 'left' | 'right';
-   imageSize?: ImageSize // 'default' | number (points maxHeight)
+   imageAlign?: ImageAlign; // 'top' | 'center' | 'bottom'
+   imageSize?: ImageSize // { width: number|`${number}%`, height: number|`${number}%` } | undefined (defaults to 64pt)
+   contentFit?: ImageContentFit; // 'cover' | 'contain' | 'fill' | 'none' | 'scale-down'
 };
 ```
 
@@ -186,7 +191,9 @@ const config: LiveActivity.LiveActivityConfig = {
   timerType: 'circular',
   padding: { horizontal: 20, top: 16, bottom: 16 },
   imagePosition: 'right',
-  imageSize: 'default', // or a number e.g. 80 for custom image height
+  imageAlign: 'center',
+  imageSize: { height: '50%', width: '50%' }, // number (pt) or percentage of the image container, if empty by default is 64pt.
+  contentFit: 'cover',
 }
 
 const activityId = LiveActivity.startActivity(state, config)

package/build/index.d.ts

@@ -33,7 +33,12 @@ export type Padding = {
 } | number;
 export type ImagePosition = 'left' | 'right' | 'leftStretch' | 'rightStretch';
 export type ImageAlign = 'top' | 'center' | 'bottom';
-export type ImageSize = number;
+export type ImageDimension = number | `${number}%`;
+export type ImageSize = {
+    width: ImageDimension;
+    height: ImageDimension;
+};
+export type ImageContentFit = 'cover' | 'contain' | 'fill' | 'none' | 'scale-down';
 export type LiveActivityConfig = {
     backgroundColor?: string;
     titleColor?: string;
@@ -46,6 +51,7 @@ export type LiveActivityConfig = {
     imagePosition?: ImagePosition;
     imageAlign?: ImageAlign;
     imageSize?: ImageSize;
+    contentFit?: ImageContentFit;
 };
 export type ActivityTokenReceivedEvent = {
     activityID: string;
@@ -53,7 +59,7 @@ export type ActivityTokenReceivedEvent = {
     activityPushToken: string;
 };
 export type ActivityPushToStartTokenReceivedEvent = {
-    activityPushToStartToken: string;
+    activityPushToStartToken: string | null;
 };
 type ActivityState = 'active' | 'dismissed' | 'pending' | 'stale' | 'ended';
 export type ActivityUpdateEvent = {
@@ -82,8 +88,19 @@ export declare function stopActivity(id: string, state: LiveActivityState): any;
  * @param {LiveActivityState} state The updated state for the live activity.
  */
 export declare function updateActivity(id: string, state: LiveActivityState): any;
-export declare function addActivityTokenListener(listener: (event: ActivityTokenReceivedEvent) => void): Voidable<EventSubscription>;
+/**
+ * @param {function} updateTokenListener The listener function that will be called when an update token is received.
+ */
+export declare function addActivityTokenListener(updateTokenListener: (event: ActivityTokenReceivedEvent) => void): Voidable<EventSubscription>;
+/**
+ * Adds a listener that is called when a push-to-start token is received. Supported only on iOS > 17.2.
+ * On earlier iOS versions, the listener will return null as a token.
+ * @param {function} listener The listener function that will be called when the observer starts and then when a push-to-start token is received.
+ */
 export declare function addActivityPushToStartTokenListener(listener: (event: ActivityPushToStartTokenReceivedEvent) => void): Voidable<EventSubscription>;
-export declare function addActivityUpdatesListener(listener: (event: ActivityUpdateEvent) => void): Voidable<EventSubscription>;
+/**
+ * @param {function} statusListener The listener function that will be called when an activity status changes.
+ */
+export declare function addActivityUpdatesListener(statusListener: (event: ActivityUpdateEvent) => void): Voidable<EventSubscription>;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

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

package/build/index.js

@@ -9,7 +9,7 @@ function assertIOS(name) {
 function normalizeConfig(config) {
     if (config === undefined)
         return config;
-    const { padding, ...base } = config;
+    const { padding, imageSize, ...base } = config;
     const normalized = { ...base };
     // Normalize padding: keep number in padding, object in paddingDetails
     if (typeof padding === 'number') {
@@ -18,6 +18,35 @@ function normalizeConfig(config) {
     else if (typeof padding === 'object') {
         normalized.paddingDetails = padding;
     }
+    // Normalize imageSize: object with width/height each a number (points) or percent string like '50%'
+    if (imageSize) {
+        const regExp = /^(100(?:\.0+)?|\d{1,2}(?:\.\d+)?)%$/; // Matches 0.0% to 100.0%
+        const { width, height } = imageSize;
+        if (typeof width === 'number') {
+            normalized.imageWidth = width;
+        }
+        else if (typeof width === 'string') {
+            const match = width.trim().match(regExp);
+            if (match) {
+                normalized.imageWidthPercent = Number(match[1]);
+            }
+            else {
+                throw new Error('imageSize.width percent string must be in format "0%" to "100%"');
+            }
+        }
+        if (typeof height === 'number') {
+            normalized.imageHeight = height;
+        }
+        else if (typeof height === 'string') {
+            const match = height.trim().match(regExp);
+            if (match) {
+                normalized.imageHeightPercent = Number(match[1]);
+            }
+            else {
+                throw new Error('imageSize.height percent string must be in format "0%" to "100%"');
+            }
+        }
+    }
     return normalized;
 }
 /**
@@ -45,16 +74,27 @@ export function updateActivity(id, state) {
     if (assertIOS('updateActivity'))
         return ExpoLiveActivityModule.updateActivity(id, state);
 }
-export function addActivityTokenListener(listener) {
+/**
+ * @param {function} updateTokenListener The listener function that will be called when an update token is received.
+ */
+export function addActivityTokenListener(updateTokenListener) {
     if (assertIOS('addActivityTokenListener'))
-        return ExpoLiveActivityModule.addListener('onTokenReceived', listener);
+        return ExpoLiveActivityModule.addListener('onTokenReceived', updateTokenListener);
 }
+/**
+ * Adds a listener that is called when a push-to-start token is received. Supported only on iOS > 17.2.
+ * On earlier iOS versions, the listener will return null as a token.
+ * @param {function} listener The listener function that will be called when the observer starts and then when a push-to-start token is received.
+ */
 export function addActivityPushToStartTokenListener(listener) {
     if (assertIOS('addActivityPushToStartTokenListener'))
         return ExpoLiveActivityModule.addListener('onPushToStartTokenReceived', listener);
 }
-export function addActivityUpdatesListener(listener) {
+/**
+ * @param {function} statusListener The listener function that will be called when an activity status changes.
+ */
+export function addActivityUpdatesListener(statusListener) {
     if (assertIOS('addActivityUpdatesListener'))
-        return ExpoLiveActivityModule.addListener('onStateChange', listener);
+        return ExpoLiveActivityModule.addListener('onStateChange', statusListener);
 }
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAEvC,OAAO,sBAAsB,MAAM,0BAA0B,CAAA;AAwF7D,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,KAAK,KAAK,CAAA;IAEnC,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,2BAA2B,CAAC,CAAA;IAE7D,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,eAAe,CAAC,MAA2B;IAClD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAA;IAEvC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAA;IAEnC,MAAM,UAAU,GAAqB,EAAE,GAAG,IAAI,EAAE,CAAA;IAEhD,sEAAsE;IACtE,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAA;IAC9B,CAAC;SAAM,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACvC,UAAU,CAAC,cAAc,GAAG,OAAO,CAAA;IACrC,CAAC;IAED,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAwB,EAAE,MAA2B;IACjF,IAAI,SAAS,CAAC,eAAe,CAAC;QAAE,OAAO,sBAAsB,CAAC,aAAa,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAA;AAC7G,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,KAAwB;IAC/D,IAAI,SAAS,CAAC,cAAc,CAAC;QAAE,OAAO,sBAAsB,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;AACtF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU,EAAE,KAAwB;IACjE,IAAI,SAAS,CAAC,gBAAgB,CAAC;QAAE,OAAO,sBAAsB,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;AAC1F,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,QAAqD;IAErD,IAAI,SAAS,CAAC,0BAA0B,CAAC;QAAE,OAAO,sBAAsB,CAAC,WAAW,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAA;AACnH,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,QAAgE;IAEhE,IAAI,SAAS,CAAC,qCAAqC,CAAC;QAClD,OAAO,sBAAsB,CAAC,WAAW,CAAC,4BAA4B,EAAE,QAAQ,CAAC,CAAA;AACrF,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAA8C;IAE9C,IAAI,SAAS,CAAC,4BAA4B,CAAC;QAAE,OAAO,sBAAsB,CAAC,WAAW,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAA;AACnH,CAAC","sourcesContent":["import { EventSubscription } from 'expo-modules-core'\nimport { Platform } from 'react-native'\n\nimport ExpoLiveActivityModule from './ExpoLiveActivityModule'\n\ntype Voidable<T> = T | void\n\nexport type DynamicIslandTimerType = 'circular' | 'digital'\n\ntype ProgressBarType =\n  | {\n      date?: number\n      progress?: undefined\n    }\n  | {\n      date?: undefined\n      progress?: number\n    }\n\nexport type LiveActivityState = {\n  title: string\n  subtitle?: string\n  progressBar?: ProgressBarType\n  imageName?: string\n  dynamicIslandImageName?: string\n}\n\nexport type NativeLiveActivityState = {\n  title: string\n  subtitle?: string\n  date?: number\n  progress?: number\n  imageName?: string\n  dynamicIslandImageName?: string\n}\n\nexport type Padding =\n  | {\n      top?: number\n      bottom?: number\n      left?: number\n      right?: number\n      vertical?: number\n      horizontal?: number\n    }\n  | number\n\nexport type ImagePosition = 'left' | 'right' | 'leftStretch' | 'rightStretch'\n\nexport type ImageAlign = 'top' | 'center' | 'bottom'\n\nexport type ImageSize = number\n\nexport type LiveActivityConfig = {\n  backgroundColor?: string\n  titleColor?: string\n  subtitleColor?: string\n  progressViewTint?: string\n  progressViewLabelColor?: string\n  deepLinkUrl?: string\n  timerType?: DynamicIslandTimerType\n  padding?: Padding\n  imagePosition?: ImagePosition\n  imageAlign?: ImageAlign\n  imageSize?: ImageSize\n}\n\nexport type ActivityTokenReceivedEvent = {\n  activityID: string\n  activityName: string\n  activityPushToken: string\n}\n\nexport type ActivityPushToStartTokenReceivedEvent = {\n  activityPushToStartToken: string\n}\n\ntype ActivityState = 'active' | 'dismissed' | 'pending' | 'stale' | 'ended'\n\nexport type ActivityUpdateEvent = {\n  activityID: string\n  activityName: string\n  activityState: ActivityState\n}\n\nexport type LiveActivityModuleEvents = {\n  onTokenReceived: (params: ActivityTokenReceivedEvent) => void\n  onPushToStartTokenReceived: (params: ActivityPushToStartTokenReceivedEvent) => void\n  onStateChange: (params: ActivityUpdateEvent) => void\n}\n\nfunction assertIOS(name: string) {\n  const isIOS = Platform.OS === 'ios'\n\n  if (!isIOS) console.error(`${name} is only available on iOS`)\n\n  return isIOS\n}\n\nfunction normalizeConfig(config?: LiveActivityConfig) {\n  if (config === undefined) return config\n\n  const { padding, ...base } = config\n  type NormalizedConfig = LiveActivityConfig & { paddingDetails?: Padding }\n  const normalized: NormalizedConfig = { ...base }\n\n  // Normalize padding: keep number in padding, object in paddingDetails\n  if (typeof padding === 'number') {\n    normalized.padding = padding\n  } else if (typeof padding === 'object') {\n    normalized.paddingDetails = padding\n  }\n\n  return normalized\n}\n\n/**\n * @param {LiveActivityState} state The state for the live activity.\n * @param {LiveActivityConfig} config Live activity config object.\n * @returns {string} The identifier of the started activity or undefined if creating live activity failed.\n */\nexport function startActivity(state: LiveActivityState, config?: LiveActivityConfig): Voidable<string> {\n  if (assertIOS('startActivity')) return ExpoLiveActivityModule.startActivity(state, normalizeConfig(config))\n}\n\n/**\n * @param {string} id The identifier of the activity to stop.\n * @param {LiveActivityState} state The updated state for the live activity.\n */\nexport function stopActivity(id: string, state: LiveActivityState) {\n  if (assertIOS('stopActivity')) return ExpoLiveActivityModule.stopActivity(id, state)\n}\n\n/**\n * @param {string} id The identifier of the activity to update.\n * @param {LiveActivityState} state The updated state for the live activity.\n */\nexport function updateActivity(id: string, state: LiveActivityState) {\n  if (assertIOS('updateActivity')) return ExpoLiveActivityModule.updateActivity(id, state)\n}\n\nexport function addActivityTokenListener(\n  listener: (event: ActivityTokenReceivedEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityTokenListener')) return ExpoLiveActivityModule.addListener('onTokenReceived', listener)\n}\n\nexport function addActivityPushToStartTokenListener(\n  listener: (event: ActivityPushToStartTokenReceivedEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityPushToStartTokenListener'))\n    return ExpoLiveActivityModule.addListener('onPushToStartTokenReceived', listener)\n}\n\nexport function addActivityUpdatesListener(\n  listener: (event: ActivityUpdateEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityUpdatesListener')) return ExpoLiveActivityModule.addListener('onStateChange', listener)\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventSubscription } from 'expo-modules-core'\nimport { Platform } from 'react-native'\n\nimport ExpoLiveActivityModule from './ExpoLiveActivityModule'\n\ntype Voidable<T> = T | void\n\nexport type DynamicIslandTimerType = 'circular' | 'digital'\n\ntype ProgressBarType =\n  | {\n      date?: number\n      progress?: undefined\n    }\n  | {\n      date?: undefined\n      progress?: number\n    }\n\nexport type LiveActivityState = {\n  title: string\n  subtitle?: string\n  progressBar?: ProgressBarType\n  imageName?: string\n  dynamicIslandImageName?: string\n}\n\nexport type NativeLiveActivityState = {\n  title: string\n  subtitle?: string\n  date?: number\n  progress?: number\n  imageName?: string\n  dynamicIslandImageName?: string\n}\n\nexport type Padding =\n  | {\n      top?: number\n      bottom?: number\n      left?: number\n      right?: number\n      vertical?: number\n      horizontal?: number\n    }\n  | number\n\nexport type ImagePosition = 'left' | 'right' | 'leftStretch' | 'rightStretch'\n\nexport type ImageAlign = 'top' | 'center' | 'bottom'\n\nexport type ImageDimension = number | `${number}%`\nexport type ImageSize = {\n  width: ImageDimension\n  height: ImageDimension\n}\n\nexport type ImageContentFit = 'cover' | 'contain' | 'fill' | 'none' | 'scale-down'\n\nexport type LiveActivityConfig = {\n  backgroundColor?: string\n  titleColor?: string\n  subtitleColor?: string\n  progressViewTint?: string\n  progressViewLabelColor?: string\n  deepLinkUrl?: string\n  timerType?: DynamicIslandTimerType\n  padding?: Padding\n  imagePosition?: ImagePosition\n  imageAlign?: ImageAlign\n  imageSize?: ImageSize\n  contentFit?: ImageContentFit\n}\n\nexport type ActivityTokenReceivedEvent = {\n  activityID: string\n  activityName: string\n  activityPushToken: string\n}\n\nexport type ActivityPushToStartTokenReceivedEvent = {\n  activityPushToStartToken: string | null\n}\n\ntype ActivityState = 'active' | 'dismissed' | 'pending' | 'stale' | 'ended'\n\nexport type ActivityUpdateEvent = {\n  activityID: string\n  activityName: string\n  activityState: ActivityState\n}\n\nexport type LiveActivityModuleEvents = {\n  onTokenReceived: (params: ActivityTokenReceivedEvent) => void\n  onPushToStartTokenReceived: (params: ActivityPushToStartTokenReceivedEvent) => void\n  onStateChange: (params: ActivityUpdateEvent) => void\n}\n\nfunction assertIOS(name: string) {\n  const isIOS = Platform.OS === 'ios'\n\n  if (!isIOS) console.error(`${name} is only available on iOS`)\n\n  return isIOS\n}\n\nfunction normalizeConfig(config?: LiveActivityConfig) {\n  if (config === undefined) return config\n\n  const { padding, imageSize, ...base } = config\n  type NormalizedConfig = LiveActivityConfig & {\n    paddingDetails?: Padding\n    imageWidth?: number\n    imageHeight?: number\n    imageWidthPercent?: number\n    imageHeightPercent?: number\n  }\n  const normalized: NormalizedConfig = { ...base }\n\n  // Normalize padding: keep number in padding, object in paddingDetails\n  if (typeof padding === 'number') {\n    normalized.padding = padding\n  } else if (typeof padding === 'object') {\n    normalized.paddingDetails = padding\n  }\n\n  // Normalize imageSize: object with width/height each a number (points) or percent string like '50%'\n  if (imageSize) {\n    const regExp = /^(100(?:\\.0+)?|\\d{1,2}(?:\\.\\d+)?)%$/ // Matches 0.0% to 100.0%\n\n    const { width, height } = imageSize\n\n    if (typeof width === 'number') {\n      normalized.imageWidth = width\n    } else if (typeof width === 'string') {\n      const match = width.trim().match(regExp)\n      if (match) {\n        normalized.imageWidthPercent = Number(match[1])\n      } else {\n        throw new Error('imageSize.width percent string must be in format \"0%\" to \"100%\"')\n      }\n    }\n\n    if (typeof height === 'number') {\n      normalized.imageHeight = height\n    } else if (typeof height === 'string') {\n      const match = height.trim().match(regExp)\n      if (match) {\n        normalized.imageHeightPercent = Number(match[1])\n      } else {\n        throw new Error('imageSize.height percent string must be in format \"0%\" to \"100%\"')\n      }\n    }\n  }\n\n  return normalized\n}\n\n/**\n * @param {LiveActivityState} state The state for the live activity.\n * @param {LiveActivityConfig} config Live activity config object.\n * @returns {string} The identifier of the started activity or undefined if creating live activity failed.\n */\nexport function startActivity(state: LiveActivityState, config?: LiveActivityConfig): Voidable<string> {\n  if (assertIOS('startActivity')) return ExpoLiveActivityModule.startActivity(state, normalizeConfig(config))\n}\n\n/**\n * @param {string} id The identifier of the activity to stop.\n * @param {LiveActivityState} state The updated state for the live activity.\n */\nexport function stopActivity(id: string, state: LiveActivityState) {\n  if (assertIOS('stopActivity')) return ExpoLiveActivityModule.stopActivity(id, state)\n}\n\n/**\n * @param {string} id The identifier of the activity to update.\n * @param {LiveActivityState} state The updated state for the live activity.\n */\nexport function updateActivity(id: string, state: LiveActivityState) {\n  if (assertIOS('updateActivity')) return ExpoLiveActivityModule.updateActivity(id, state)\n}\n\n/**\n * @param {function} updateTokenListener The listener function that will be called when an update token is received.\n */\nexport function addActivityTokenListener(\n  updateTokenListener: (event: ActivityTokenReceivedEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityTokenListener'))\n    return ExpoLiveActivityModule.addListener('onTokenReceived', updateTokenListener)\n}\n\n/**\n * Adds a listener that is called when a push-to-start token is received. Supported only on iOS > 17.2.\n * On earlier iOS versions, the listener will return null as a token.\n * @param {function} listener The listener function that will be called when the observer starts and then when a push-to-start token is received.\n */\nexport function addActivityPushToStartTokenListener(\n  listener: (event: ActivityPushToStartTokenReceivedEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityPushToStartTokenListener'))\n    return ExpoLiveActivityModule.addListener('onPushToStartTokenReceived', listener)\n}\n\n/**\n * @param {function} statusListener The listener function that will be called when an activity status changes.\n */\nexport function addActivityUpdatesListener(\n  statusListener: (event: ActivityUpdateEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityUpdatesListener'))\n    return ExpoLiveActivityModule.addListener('onStateChange', statusListener)\n}\n"]}

package/ios/ExpoLiveActivityModule.swift

@@ -59,11 +59,23 @@ public class ExpoLiveActivityModule: Module {
     var imagePosition: String?
 
     @Field
-    var imageSize: Int?
+    var imageWidth: Int?
+
+    @Field
+    var imageHeight: Int?
+
+    @Field
+    var imageWidthPercent: Double?
+
+    @Field
+    var imageHeightPercent: Double?
 
     @Field
     var imageAlign: String?
 
+    @Field
+    var contentFit: String?
+
     struct PaddingDetails: Record {
       @Field var top: Int?
       @Field var bottom: Int?
@@ -129,6 +141,10 @@ public class ExpoLiveActivityModule: Module {
   private func observePushToStartToken() {
     guard #available(iOS 17.2, *), ActivityAuthorizationInfo().areActivitiesEnabled else { return }
 
+    if let initialToken = (Activity<LiveActivityAttributes>.pushToStartToken?.reduce("") { $0 + String(format: "%02x", $1) }) {
+      sendPushToStartToken(activityPushToStartToken: initialToken)
+    }
+
     print("Observing push to start token updates...")
     Task {
       for await data in Activity<LiveActivityAttributes>.pushToStartTokenUpdates {
@@ -184,11 +200,14 @@ public class ExpoLiveActivityModule: Module {
   public func definition() -> ModuleDefinition {
     Name("ExpoLiveActivity")
 
-    OnCreate {
+    OnStartObserving("onTokenReceived") {
+      observeLiveActivityUpdates()
+    }
+
+    OnStartObserving("onPushToStartTokenReceived") {
       if pushNotificationsEnabled {
         observePushToStartToken()
       }
-      observeLiveActivityUpdates()
     }
 
     Events("onTokenReceived", "onPushToStartTokenReceived", "onStateChange")
@@ -225,8 +244,12 @@ public class ExpoLiveActivityModule: Module {
             )
           },
           imagePosition: config.imagePosition,
-          imageSize: config.imageSize,
-          imageAlign: config.imageAlign
+          imageWidth: config.imageWidth,
+          imageHeight: config.imageHeight,
+          imageWidthPercent: config.imageWidthPercent,
+          imageHeightPercent: config.imageHeightPercent,
+          imageAlign: config.imageAlign,
+          contentFit: config.contentFit
         )
 
         let initialState = LiveActivityAttributes.ContentState(

package/ios/LiveActivityAttributes.swift

@@ -22,8 +22,12 @@ struct LiveActivityAttributes: ActivityAttributes {
   var padding: Int?
   var paddingDetails: PaddingDetails?
   var imagePosition: String?
-  var imageSize: Int?
+  var imageWidth: Int?
+  var imageHeight: Int?
+  var imageWidthPercent: Double?
+  var imageHeightPercent: Double?
   var imageAlign: String?
+  var contentFit: String?
 
   enum DynamicIslandTimerType: String, Codable {
     case circular

package/ios-files/Image+dynamic.swift

@@ -1,4 +1,5 @@
 import SwiftUI
+import UIKit
 
 extension Image {
   static func dynamic(assetNameOrPath: String) -> Self {
@@ -15,3 +16,18 @@ extension Image {
     return Image(assetNameOrPath)
   }
 }
+
+extension UIImage {
+  /// Attempts to load a UIImage either from the shared app group container or the main bundle.
+  static func dynamic(assetNameOrPath: String) -> UIImage? {
+    if let container = FileManager.default.containerURL(
+      forSecurityApplicationGroupIdentifier: "group.expoLiveActivity.sharedData"
+    ) {
+      let contentsOfFile = container.appendingPathComponent(assetNameOrPath).path
+      if let uiImage = UIImage(contentsOfFile: contentsOfFile) {
+        return uiImage
+      }
+    }
+    return UIImage(named: assetNameOrPath)
+  }
+}

package/ios-files/LiveActivityView.swift

@@ -15,15 +15,35 @@ import WidgetKit
     }
   }
 
+  struct DebugLog: View {
+    #if DEBUG
+      private let message: String
+      init(_ message: String) {
+        self.message = message
+        print(message)
+      }
+
+      var body: some View {
+        Text(message)
+          .font(.caption2)
+          .foregroundStyle(.red)
+      }
+    #else
+      init(_: String) {}
+      var body: some View { EmptyView() }
+    #endif
+  }
+
   struct LiveActivityView: View {
     let contentState: LiveActivityAttributes.ContentState
     let attributes: LiveActivityAttributes
+    @State private var imageContainerSize: CGSize?
 
     var progressViewTint: Color? {
       attributes.progressViewTint.map { Color(hex: $0) }
     }
 
-    private var imageAlignment: Alignment {
+    private var imageVerticalAlignment: VerticalAlignment {
       switch attributes.imageAlign {
       case "center":
         return .center
@@ -34,13 +54,104 @@ import WidgetKit
       }
     }
 
-    @ViewBuilder
-    private func alignedImage(imageName: String) -> some View {
-      VStack {
-        resizableImage(imageName: imageName)
-          .applyImageSize(attributes.imageSize)
+    private func alignedImage(imageName: String, horizontalAlignment: HorizontalAlignment) -> some View {
+      let defaultHeight: CGFloat = 64
+      let defaultWidth: CGFloat = 64
+      let containerHeight = imageContainerSize?.height
+      let containerWidth = imageContainerSize?.width
+      let hasWidthConstraint = (attributes.imageWidthPercent != nil) || (attributes.imageWidth != nil)
+
+      let computedHeight: CGFloat? = {
+        if let percent = attributes.imageHeightPercent {
+          let clamped = min(max(percent, 0), 100) / 100.0
+          // Use the row height as a base. Fallback to default when row height is not measured yet.
+          let base = (containerHeight ?? defaultHeight)
+          return base * clamped
+        } else if let size = attributes.imageHeight {
+          return CGFloat(size)
+        } else if hasWidthConstraint {
+          // Mimic CSS: when only width is set, keep height automatic to preserve aspect ratio
+          return nil
+        } else {
+          // Mimic CSS: this works against CSS but provides a better default behavior.
+          // When no width/height is set, use a default size (64pt)
+          // Width will adjust automatically base on aspect ratio
+          return defaultHeight
+        }
+      }()
+
+      let computedWidth: CGFloat? = {
+        if let percent = attributes.imageWidthPercent {
+          let clamped = min(max(percent, 0), 100) / 100.0
+          let base = (containerWidth ?? defaultWidth)
+          return base * clamped
+        } else if let size = attributes.imageWidth {
+          return CGFloat(size)
+        } else {
+          return nil // Keep aspect fit based on height
+        }
+      }()
+
+      return ZStack(alignment: .center) {
+        Group {
+          let fit = attributes.contentFit ?? "contain"
+          switch fit {
+          case "contain":
+            Image.dynamic(assetNameOrPath: imageName).resizable().scaledToFit().frame(width: computedWidth, height: computedHeight)
+          case "fill":
+            Image.dynamic(assetNameOrPath: imageName).resizable().frame(
+              width: computedWidth,
+              height: computedHeight
+            )
+          case "none":
+            Image.dynamic(assetNameOrPath: imageName).renderingMode(.original).frame(width: computedWidth, height: computedHeight)
+          case "scale-down":
+            if let uiImage = UIImage.dynamic(assetNameOrPath: imageName) {
+              // Determine the target box. When width/height are nil, we use image's intrinsic dimension for comparison.
+              let targetHeight = computedHeight ?? uiImage.size.height
+              let targetWidth = computedWidth ?? uiImage.size.width
+              let shouldScaleDown = uiImage.size.height > targetHeight || uiImage.size.width > targetWidth
+
+              if shouldScaleDown {
+                Image(uiImage: uiImage)
+                  .resizable()
+                  .scaledToFit()
+                  .frame(width: computedWidth, height: computedHeight)
+              } else {
+                Image(uiImage: uiImage)
+                  .renderingMode(.original)
+                  .frame(width: min(uiImage.size.width, targetWidth), height: min(uiImage.size.height, targetHeight))
+              }
+            } else {
+              DebugLog("⚠️[ExpoLiveActivity] assetNameOrPath couldn't resolve to UIImage")
+            }
+          case "cover":
+            Image.dynamic(assetNameOrPath: imageName).resizable().scaledToFill().frame(
+              width: computedWidth,
+              height: computedHeight
+            ).clipped()
+          default:
+            DebugLog("⚠️[ExpoLiveActivity] Unknown contentFit '\(fit)'")
+          }
+        }
       }
-      .frame(maxHeight: .infinity, alignment: imageAlignment)
+      .frame(
+        maxWidth: .infinity,
+        maxHeight: .infinity,
+        alignment: Alignment(horizontal: horizontalAlignment, vertical: imageVerticalAlignment)
+      )
+      .background(
+        GeometryReader { proxy in
+          Color.clear
+            .onAppear {
+              let s = proxy.size
+              if s.width > 0, s.height > 0 { imageContainerSize = s }
+            }
+            .onChange(of: proxy.size) { s in
+              if s.width > 0, s.height > 0 { imageContainerSize = s }
+            }
+        }
+      )
     }
 
     var body: some View {
@@ -80,10 +191,11 @@ import WidgetKit
         let isLeftImage = position.hasPrefix("left")
         let hasImage = contentState.imageName != nil
         let effectiveStretch = isStretch && hasImage
+
         HStack(alignment: .center) {
           if hasImage, isLeftImage {
             if let imageName = contentState.imageName {
-              alignedImage(imageName: imageName)
+              alignedImage(imageName: imageName, horizontalAlignment: .leading)
             }
           }
 
@@ -110,18 +222,16 @@ import WidgetKit
                   .modifier(ConditionalForegroundViewModifier(color: attributes.progressViewLabelColor))
               }
             }
-          }
+          }.layoutPriority(1)
 
           if hasImage, !isLeftImage { // right side (default)
-            Spacer()
             if let imageName = contentState.imageName {
-              alignedImage(imageName: imageName)
+              alignedImage(imageName: imageName, horizontalAlignment: .trailing)
             }
           }
         }
 
         if !effectiveStretch {
-          // Bottom progress (hidden when using Stretch variants where progress is inline)
           if let date = contentState.timerEndDateInMilliseconds {
             ProgressView(timerInterval: Date.toTimerInterval(miliseconds: date))
               .tint(progressViewTint)

package/ios-files/LiveActivityWidget.swift

@@ -2,14 +2,30 @@ import ActivityKit
 import SwiftUI
 import WidgetKit
 
-struct LiveActivityAttributes: ActivityAttributes {
-  struct ContentState: Codable, Hashable {
+public struct LiveActivityAttributes: ActivityAttributes {
+  public struct ContentState: Codable, Hashable {
     var title: String
     var subtitle: String?
     var timerEndDateInMilliseconds: Double?
     var progress: Double?
     var imageName: String?
     var dynamicIslandImageName: String?
+
+    public init(
+      title: String,
+      subtitle: String? = nil,
+      timerEndDateInMilliseconds: Double? = nil,
+      progress: Double? = nil,
+      imageName: String? = nil,
+      dynamicIslandImageName: String? = nil
+    ) {
+      self.title = title
+      self.subtitle = subtitle
+      self.timerEndDateInMilliseconds = timerEndDateInMilliseconds
+      self.progress = progress
+      self.imageName = imageName
+      self.dynamicIslandImageName = dynamicIslandImageName
+    }
   }
 
   var name: String
@@ -23,26 +39,85 @@ struct LiveActivityAttributes: ActivityAttributes {
   var padding: Int?
   var paddingDetails: PaddingDetails?
   var imagePosition: String?
-  var imageSize: Int?
+  var imageWidth: Int?
+  var imageHeight: Int?
+  var imageWidthPercent: Double?
+  var imageHeightPercent: Double?
   var imageAlign: String?
+  var contentFit: String?
+
+  public init(
+    name: String,
+    backgroundColor: String? = nil,
+    titleColor: String? = nil,
+    subtitleColor: String? = nil,
+    progressViewTint: String? = nil,
+    progressViewLabelColor: String? = nil,
+    deepLinkUrl: String? = nil,
+    timerType: DynamicIslandTimerType? = nil,
+    padding: Int? = nil,
+    paddingDetails: PaddingDetails? = nil,
+    imagePosition: String? = nil,
+    imageWidth: Int? = nil,
+    imageHeight: Int? = nil,
+    imageWidthPercent: Double? = nil,
+    imageHeightPercent: Double? = nil,
+    imageAlign: String? = nil,
+    contentFit: String? = nil
+  ) {
+    self.name = name
+    self.backgroundColor = backgroundColor
+    self.titleColor = titleColor
+    self.subtitleColor = subtitleColor
+    self.progressViewTint = progressViewTint
+    self.progressViewLabelColor = progressViewLabelColor
+    self.deepLinkUrl = deepLinkUrl
+    self.timerType = timerType
+    self.padding = padding
+    self.paddingDetails = paddingDetails
+    self.imagePosition = imagePosition
+    self.imageWidth = imageWidth
+    self.imageHeight = imageHeight
+    self.imageWidthPercent = imageWidthPercent
+    self.imageHeightPercent = imageHeightPercent
+    self.imageAlign = imageAlign
+    self.contentFit = contentFit
+  }
 
-  enum DynamicIslandTimerType: String, Codable {
+  public enum DynamicIslandTimerType: String, Codable {
     case circular
     case digital
   }
 
-  struct PaddingDetails: Codable, Hashable {
+  public struct PaddingDetails: Codable, Hashable {
     var top: Int?
     var bottom: Int?
     var left: Int?
     var right: Int?
     var vertical: Int?
     var horizontal: Int?
+
+    public init(
+      top: Int? = nil,
+      bottom: Int? = nil,
+      left: Int? = nil,
+      right: Int? = nil,
+      vertical: Int? = nil,
+      horizontal: Int? = nil
+    ) {
+      self.top = top
+      self.bottom = bottom
+      self.left = left
+      self.right = right
+      self.vertical = vertical
+      self.horizontal = horizontal
+    }
   }
 }
 
-struct LiveActivityWidget: Widget {
-  var body: some WidgetConfiguration {
+@available(iOS 16.1, *)
+public struct LiveActivityWidget: Widget {
+  public var body: some WidgetConfiguration {
     ActivityConfiguration(for: LiveActivityAttributes.self) { context in
       LiveActivityView(contentState: context.state, attributes: context.attributes)
         .activityBackgroundTint(
@@ -72,6 +147,12 @@ struct LiveActivityWidget: Widget {
             )
             .padding(.horizontal, 5)
             .applyWidgetURL(from: context.attributes.deepLinkUrl)
+          } else if let progress = context.state.progress {
+            dynamicIslandExpandedBottomProgress(
+              progress: progress, progressViewTint: context.attributes.progressViewTint
+            )
+            .padding(.horizontal, 5)
+            .applyWidgetURL(from: context.attributes.deepLinkUrl)
           }
         }
       } compactLeading: {
@@ -87,6 +168,11 @@ struct LiveActivityWidget: Widget {
             timerType: context.attributes.timerType ?? .circular,
             progressViewTint: context.attributes.progressViewTint
           ).applyWidgetURL(from: context.attributes.deepLinkUrl)
+        } else if let progress = context.state.progress {
+          compactProgress(
+            progress: progress,
+            progressViewTint: context.attributes.progressViewTint
+          ).applyWidgetURL(from: context.attributes.deepLinkUrl)
         }
       } minimal: {
         if let date = context.state.timerEndDateInMilliseconds {
@@ -95,11 +181,18 @@ struct LiveActivityWidget: Widget {
             timerType: context.attributes.timerType ?? .circular,
             progressViewTint: context.attributes.progressViewTint
           ).applyWidgetURL(from: context.attributes.deepLinkUrl)
+        } else if let progress = context.state.progress {
+          compactProgress(
+            progress: progress,
+            progressViewTint: context.attributes.progressViewTint
+          ).applyWidgetURL(from: context.attributes.deepLinkUrl)
         }
       }
     }
   }
 
+  public init() {}
+
   @ViewBuilder
   private func compactTimer(
     endDate: Double,
@@ -140,7 +233,6 @@ struct LiveActivityWidget: Widget {
     VStack {
       Spacer()
       resizableImage(imageName: imageName)
-        .frame(maxHeight: 64)
       Spacer()
     }
   }
@@ -163,4 +255,20 @@ struct LiveActivityWidget: Widget {
     )
     .progressViewStyle(.circular)
   }
+
+  private func compactProgress(
+    progress: Double,
+    progressViewTint: String?
+  ) -> some View {
+    ProgressView(value: progress)
+      .progressViewStyle(.circular)
+      .tint(progressViewTint.map { Color(hex: $0) })
+  }
+
+  private func dynamicIslandExpandedBottomProgress(progress: Double, progressViewTint: String?) -> some View {
+    ProgressView(value: progress)
+      .foregroundStyle(.white)
+      .tint(progressViewTint.map { Color(hex: $0) })
+      .padding(.top, 5)
+  }
 }

package/ios-files/ViewHelpers.swift

@@ -6,9 +6,28 @@ func resizableImage(imageName: String) -> some View {
     .scaledToFit()
 }
 
+func resizableImage(imageName: String, height: CGFloat?, width: CGFloat?) -> some View {
+  resizableImage(imageName: imageName)
+    .frame(width: width, height: height)
+}
+
+private struct ContainerSizeKey: PreferenceKey {
+  static var defaultValue: CGSize?
+  static func reduce(value: inout CGSize?, nextValue: () -> CGSize?) {
+    value = nextValue() ?? value
+  }
+}
+
 extension View {
-  @ViewBuilder
-  func applyImageSize(_ size: Int?) -> some View {
-    frame(maxHeight: CGFloat(size ?? 64))
+  func captureContainerSize() -> some View {
+    background(
+      GeometryReader { proxy in
+        Color.clear.preference(key: ContainerSizeKey.self, value: proxy.size)
+      }
+    )
+  }
+
+  func onContainerSize(_ perform: @escaping (CGSize?) -> Void) -> some View {
+    onPreferenceChange(ContainerSizeKey.self, perform: perform)
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-live-activity",
-  "version": "0.4.1",
+  "version": "0.4.3-alpha1",
   "description": "A module for adding Live Activity to a React Native app for iOS.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -9,6 +9,7 @@
     "clean": "expo-module clean",
     "clean:plugin": "rm -rf plugin/build plugin/tsconfig.tsbuildinfo",
     "format:check": "prettier --check .",
+    "format:fix": "prettier --write . && swiftformat --exclude \"**/node_modules/\" .",
     "lint": "expo-module eslint",
     "lint:libOnly": "expo-module eslint --ignore-pattern 'example/*'",
     "test": "expo-module test",
@@ -16,7 +17,10 @@
     "prepublishOnly": "expo-module prepublishOnly",
     "expo-module": "expo-module",
     "open:ios": "xed example/ios",
-    "typecheck": "tsc"
+    "typecheck": "tsc",
+    "generateTests": "node ./example/tests/scripts/generateFlows.js",
+    "runAllTests": "./example/tests/scripts/runAllTests.sh",
+    "generateTestReport": "node ./example/tests/scripts/generateReport.js"
   },
   "keywords": [
     "react-native",
@@ -47,7 +51,8 @@
     "expo": "~54.0.0",
     "expo-module-scripts": "^5.0.3",
     "prettier": "^3.6.2",
-    "react-native": "0.81.4"
+    "react-native": "0.81.4",
+    "pdf-lib": "^1.17.1"
   },
   "peerDependencies": {
     "expo": "*",

package/plugin/build/lib/getWidgetFiles.js

@@ -102,7 +102,7 @@ function getWidgetFiles(targetPath) {
         const imagesXcassetsTarget = path.join(targetPath, 'Assets.xcassets');
         const files = fs.readdirSync(imageAssetsPath);
         files.forEach((file) => {
-            if (path.extname(file).match(/\.(png|jpg|jpeg)$/)) {
+            if (path.extname(file).match(/\.(png|jpg|jpeg|svg)$/)) {
                 const source = path.join(imageAssetsPath, file);
                 const imageSetDir = path.join(imagesXcassetsTarget, `${path.basename(file, path.extname(file))}.imageset`);
                 // Create the .imageset directory if it doesn't exist

package/plugin/build/withPlist.js

@@ -3,8 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const config_plugins_1 = require("@expo/config-plugins");
 const withPlist = (expoConfig) => (0, config_plugins_1.withInfoPlist)(expoConfig, (plistConfig) => {
     const scheme = typeof expoConfig.scheme === 'string' ? expoConfig.scheme : expoConfig.ios?.bundleIdentifier;
-    if (scheme)
-        plistConfig.modResults.CFBundleURLTypes = [{ CFBundleURLSchemes: [scheme] }];
+    if (scheme) {
+        const existingURLTypes = plistConfig.modResults.CFBundleURLTypes || [];
+        const schemeExists = existingURLTypes.some((urlType) => urlType.CFBundleURLSchemes?.includes(scheme));
+        if (!schemeExists) {
+            plistConfig.modResults.CFBundleURLTypes = [...existingURLTypes, { CFBundleURLSchemes: [scheme] }];
+        }
+    }
     return plistConfig;
 });
 exports.default = withPlist;

package/plugin/src/lib/getWidgetFiles.ts

@@ -78,7 +78,7 @@ export function getWidgetFiles(targetPath: string) {
     const files = fs.readdirSync(imageAssetsPath)
 
     files.forEach((file) => {
-      if (path.extname(file).match(/\.(png|jpg|jpeg)$/)) {
+      if (path.extname(file).match(/\.(png|jpg|jpeg|svg)$/)) {
         const source = path.join(imageAssetsPath, file)
         const imageSetDir = path.join(imagesXcassetsTarget, `${path.basename(file, path.extname(file))}.imageset`)
 

package/plugin/src/withPlist.ts

@@ -3,7 +3,16 @@ import { ConfigPlugin, withInfoPlist } from '@expo/config-plugins'
 const withPlist: ConfigPlugin = (expoConfig) =>
   withInfoPlist(expoConfig, (plistConfig) => {
     const scheme = typeof expoConfig.scheme === 'string' ? expoConfig.scheme : expoConfig.ios?.bundleIdentifier
-    if (scheme) plistConfig.modResults.CFBundleURLTypes = [{ CFBundleURLSchemes: [scheme] }]
+
+    if (scheme) {
+      const existingURLTypes = plistConfig.modResults.CFBundleURLTypes || []
+      const schemeExists = existingURLTypes.some((urlType: any) => urlType.CFBundleURLSchemes?.includes(scheme))
+
+      if (!schemeExists) {
+        plistConfig.modResults.CFBundleURLTypes = [...existingURLTypes, { CFBundleURLSchemes: [scheme] }]
+      }
+    }
+
     return plistConfig
   })
 

package/src/index.ts

@@ -49,7 +49,13 @@ export type ImagePosition = 'left' | 'right' | 'leftStretch' | 'rightStretch'
 
 export type ImageAlign = 'top' | 'center' | 'bottom'
 
-export type ImageSize = number
+export type ImageDimension = number | `${number}%`
+export type ImageSize = {
+  width: ImageDimension
+  height: ImageDimension
+}
+
+export type ImageContentFit = 'cover' | 'contain' | 'fill' | 'none' | 'scale-down'
 
 export type LiveActivityConfig = {
   backgroundColor?: string
@@ -63,6 +69,7 @@ export type LiveActivityConfig = {
   imagePosition?: ImagePosition
   imageAlign?: ImageAlign
   imageSize?: ImageSize
+  contentFit?: ImageContentFit
 }
 
 export type ActivityTokenReceivedEvent = {
@@ -72,7 +79,7 @@ export type ActivityTokenReceivedEvent = {
 }
 
 export type ActivityPushToStartTokenReceivedEvent = {
-  activityPushToStartToken: string
+  activityPushToStartToken: string | null
 }
 
 type ActivityState = 'active' | 'dismissed' | 'pending' | 'stale' | 'ended'
@@ -100,8 +107,14 @@ function assertIOS(name: string) {
 function normalizeConfig(config?: LiveActivityConfig) {
   if (config === undefined) return config
 
-  const { padding, ...base } = config
-  type NormalizedConfig = LiveActivityConfig & { paddingDetails?: Padding }
+  const { padding, imageSize, ...base } = config
+  type NormalizedConfig = LiveActivityConfig & {
+    paddingDetails?: Padding
+    imageWidth?: number
+    imageHeight?: number
+    imageWidthPercent?: number
+    imageHeightPercent?: number
+  }
   const normalized: NormalizedConfig = { ...base }
 
   // Normalize padding: keep number in padding, object in paddingDetails
@@ -111,6 +124,35 @@ function normalizeConfig(config?: LiveActivityConfig) {
     normalized.paddingDetails = padding
   }
 
+  // Normalize imageSize: object with width/height each a number (points) or percent string like '50%'
+  if (imageSize) {
+    const regExp = /^(100(?:\.0+)?|\d{1,2}(?:\.\d+)?)%$/ // Matches 0.0% to 100.0%
+
+    const { width, height } = imageSize
+
+    if (typeof width === 'number') {
+      normalized.imageWidth = width
+    } else if (typeof width === 'string') {
+      const match = width.trim().match(regExp)
+      if (match) {
+        normalized.imageWidthPercent = Number(match[1])
+      } else {
+        throw new Error('imageSize.width percent string must be in format "0%" to "100%"')
+      }
+    }
+
+    if (typeof height === 'number') {
+      normalized.imageHeight = height
+    } else if (typeof height === 'string') {
+      const match = height.trim().match(regExp)
+      if (match) {
+        normalized.imageHeightPercent = Number(match[1])
+      } else {
+        throw new Error('imageSize.height percent string must be in format "0%" to "100%"')
+      }
+    }
+  }
+
   return normalized
 }
 
@@ -139,12 +181,21 @@ export function updateActivity(id: string, state: LiveActivityState) {
   if (assertIOS('updateActivity')) return ExpoLiveActivityModule.updateActivity(id, state)
 }
 
+/**
+ * @param {function} updateTokenListener The listener function that will be called when an update token is received.
+ */
 export function addActivityTokenListener(
-  listener: (event: ActivityTokenReceivedEvent) => void
+  updateTokenListener: (event: ActivityTokenReceivedEvent) => void
 ): Voidable<EventSubscription> {
-  if (assertIOS('addActivityTokenListener')) return ExpoLiveActivityModule.addListener('onTokenReceived', listener)
+  if (assertIOS('addActivityTokenListener'))
+    return ExpoLiveActivityModule.addListener('onTokenReceived', updateTokenListener)
 }
 
+/**
+ * Adds a listener that is called when a push-to-start token is received. Supported only on iOS > 17.2.
+ * On earlier iOS versions, the listener will return null as a token.
+ * @param {function} listener The listener function that will be called when the observer starts and then when a push-to-start token is received.
+ */
 export function addActivityPushToStartTokenListener(
   listener: (event: ActivityPushToStartTokenReceivedEvent) => void
 ): Voidable<EventSubscription> {
@@ -152,8 +203,12 @@ export function addActivityPushToStartTokenListener(
     return ExpoLiveActivityModule.addListener('onPushToStartTokenReceived', listener)
 }
 
+/**
+ * @param {function} statusListener The listener function that will be called when an activity status changes.
+ */
 export function addActivityUpdatesListener(
-  listener: (event: ActivityUpdateEvent) => void
+  statusListener: (event: ActivityUpdateEvent) => void
 ): Voidable<EventSubscription> {
-  if (assertIOS('addActivityUpdatesListener')) return ExpoLiveActivityModule.addListener('onStateChange', listener)
+  if (assertIOS('addActivityUpdatesListener'))
+    return ExpoLiveActivityModule.addListener('onStateChange', statusListener)
 }