voltra 1.0.0-rc.1 → 1.0.0

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+- Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

package/CONTRIBUTING.md

@@ -0,0 +1,235 @@
+# Contributing to Voltra
+
+## Before you start any work
+
+Please open an issue before starting to work on a new feature or a fix to a bug you encountered. This will prevent you from wasting your time on a feature that's not going to be merged, because for instance it's out of scope. If there is an existing issue present for the matter you want to work on, make sure to post a comment saying you are going to work on it. This will make sure there will be only one person working on a given issue.
+
+## Development process
+
+All work on Voltra happens directly on GitHub. Contributors send pull requests which go through the review process.
+
+> **Working on your first pull request?** You can learn how from this _free_ series: [How to Contribute to an Open Source Project on GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github).
+
+1. Fork the repo and create your branch from `main` (a guide on [how to fork a repository](https://help.github.com/articles/fork-a-repo/)).
+2. Run `npm install` to install all required dependencies.
+3. Build the plugin: `npx tsc -p plugin/tsconfig.json`.
+4. Now you are ready to make changes.
+
+## Architecture overview
+
+### JS/TS code structure
+
+The JavaScript/TypeScript code has **two separate entry points** that must be maintained as independent boundaries:
+
+- **Client entry (`src/index.ts`)**: React Native code that runs in the app. Exports JSX components, hooks, and the imperative API for managing Live Activities.
+- **Server entry (`src/server.ts`)**: Node.js code for rendering Voltra components to string payloads. Used for server-side rendering and push notification payloads.
+
+⚠️ **Important**: These two entry points must remain separate. Client code should not import server-only dependencies, and server code should not import React Native-specific modules.
+
+### Expo config plugin (`plugin/`)
+
+The Expo plugin in `plugin/src/` handles all Xcode project setup during `expo prebuild`:
+
+1. **Creates the widget extension target** with proper build settings
+2. **Copies template files** from `ios-files/` (widget bundle, assets, Info.plist) into the extension target
+3. **Configures CocoaPods** to include the `VoltraWidget` subspec in the extension target
+4. **Sets up entitlements** for App Groups (optional, for event forwarding)
+5. **Configures push notifications** (optional)
+
+### Swift code distribution (`ios/`)
+
+Voltra's Swift code lives in `ios/` and is distributed as a **CocoaPods package** with multiple subspecs:
+
+```ruby
+# From ios/Voltra.podspec
+s.subspec 'Core' do |ss|
+  # React Native bridge module (auto-linked by Expo)
+  ss.source_files = ["app/**/*.swift", "shared/**/*.swift", "ui/**/*.swift"]
+end
+
+s.subspec 'Widget' do |ss|
+  # Widget extension code (used by Live Activity target)
+  ss.source_files = ["shared/**/*.swift", "ui/**/*.swift", "target/**/*.swift"]
+end
+```
+
+- **`Core` subspec**: Contains the React Native module (`app/`), shared code (`shared/`), and UI components (`ui/`). Auto-linked by Expo in the main app.
+- **`Widget` subspec**: Contains shared code, UI components, and widget-specific files (`target/`). Used by the Live Activity extension target.
+
+This separation ensures the widget extension doesn't include unnecessary React Native dependencies.
+
+### Template files (`ios-files/`)
+
+Files in `ios-files/` are copied by the config plugin into the generated widget extension:
+
+- `VoltraWidgetBundle.swift` — Widget bundle entry point
+- `Assets.xcassets/` — Asset catalog for the extension
+- `Info.plist` — Extension configuration
+
+## Props synchronization
+
+Component props are kept in sync between TypeScript and Swift via a **custom code generator**. The single source of truth is:
+
+```
+data/components.json
+```
+
+This file defines all components, their parameters, types, and short names used for payload compression.
+
+### Running the generator
+
+```sh
+npm run generate
+```
+
+This generates:
+
+- **TypeScript prop types**: `src/jsx/props/*.ts`
+- **Swift parameter structs**: `ios/ui/Generated/Parameters/*.swift`
+- **Component ID mappings**: `src/payload/component-ids.ts` and `ios/shared/ComponentTypeID.swift`
+- **Short name mappings**: `src/payload/short-names.ts` and `ios/shared/ShortNames.swift`
+
+⚠️ **Important**: When adding new components or modifying props, always update `data/components.json` first, then run the generator. Do not manually edit generated files (marked with `.generated`).
+
+## Payload size budget
+
+Live Activity payloads have strict size limits imposed by iOS. Voltra includes tests that track payload sizes for real-world examples.
+
+### How it works
+
+The test in `src/__tests__/payload-size.node.test.tsx` renders example components and snapshots their compressed payload size:
+
+```typescript
+it('BasicLiveActivityUI', async () => {
+  const size = await getPayloadSize({
+    lockScreen: <BasicLiveActivityUI />,
+  })
+  expect(size).toMatchSnapshot()
+})
+```
+
+### When payload size changes
+
+If your changes affect payload size, the tests will fail. This is intentional:
+
+- **Size decreased?** Great! Run `npm test -- -u` to update snapshots and lock in the improvement.
+- **Size increased?** Investigate carefully. Is the increase justified? Can it be optimized? Only update snapshots after confirming the increase is necessary.
+
+⚠️ **CI will block merging** if payload size snapshots are out of date. This ensures we don't accidentally regress payload efficiency.
+
+## Payload schema versioning
+
+The payload schema has a version number to support forward compatibility. When the Swift code receives a payload with a newer version than it understands, it renders empty instead of crashing.
+
+### Version constants
+
+The version is defined in two places that must stay in sync:
+
+- **TypeScript**: `src/renderer/renderer.ts` → `VOLTRA_PAYLOAD_VERSION`
+- **Swift**: `ios/shared/VoltraPayloadMigrator.swift` → `currentVersion`
+
+### When to increment the version
+
+Increment the version when making **breaking changes** to the payload schema:
+
+- Adding required fields that old Swift code wouldn't understand
+- Changing the structure of existing fields
+- Renaming keys in a way that breaks parsing
+
+You do **not** need to increment for:
+
+- Adding optional fields (old Swift code will ignore them)
+- Bug fixes that don't change the schema
+- Adding new component types (they render as `EmptyView` if unknown)
+
+### Adding migrations
+
+When you increment the version, add a migration in Swift to upgrade old payloads:
+
+1. Increment `currentVersion` in both TypeScript and Swift
+2. Create a migration struct implementing `VoltraPayloadMigration`
+3. Register it in the `migrations` dictionary
+
+```swift
+// Example: V1ToV2Migration.swift
+struct V1ToV2Migration: VoltraPayloadMigration {
+    static let fromVersion = 1
+    static let toVersion = 2
+
+    static func migrate(_ json: JSONValue) throws -> JSONValue {
+        // Transform v1 payload to v2 format
+        // Update the version field
+        var result = json
+        result["v"] = .int(2)
+        return result
+    }
+}
+
+// In VoltraPayloadMigrator.swift:
+private static let migrations: [Int: any VoltraPayloadMigration.Type] = [
+    1: V1ToV2Migration.self,
+]
+```
+
+This ensures users with older apps can still receive updates from newer servers.
+
+## Testing your changes
+
+The `example/` directory contains an Expo app for testing changes.
+
+### Running the example app
+
+```sh
+# 1) Build the plugin
+npx tsc -p plugin/tsconfig.json
+
+# 2) Install example dependencies
+(cd example && npm install)
+
+# 3) Prebuild for iOS
+(cd example && npx expo prebuild -p ios)
+
+# 4) Run on iOS
+(cd example && npx expo run:ios)
+```
+
+If iterating on the plugin, rebuild after each change in `plugin/src/`.
+
+### Running tests
+
+Run the following checks before opening a pull request:
+
+```sh
+# Linting
+npm run lint:libOnly
+
+# Type checking
+npm run build
+
+# Unit tests
+npm test
+
+# Format check
+npm run format:check
+```
+
+If formatting fails, run `npx prettier --write .` to fix it.
+
+## Creating a pull request
+
+When you are ready to have your changes incorporated into the main codebase, open a pull request.
+
+This repository follows [the Conventional Commits specification](https://www.conventionalcommits.org/en/v1.0.0/#summary). Please follow this pattern in your pull request titles. Keep in mind your commits will be squashed before merging and the title will be used as a commit title.
+
+### Pull request checklist
+
+- [ ] Tests pass (`npm test`)
+- [ ] Linting passes (`npm run lint:libOnly`)
+- [ ] Formatting is correct (`npm run format:check`)
+- [ ] If props changed, generator was run (`npm run generate`)
+- [ ] If payload size changed, snapshots were intentionally updated
+- [ ] Documentation updated if needed
+
+## License
+
+By contributing to Voltra, you agree that your contributions will be licensed under its MIT license.

package/README.md

@@ -84,13 +84,15 @@ export function OrderTracker({ orderId }: { orderId: string }) {
 
 **Note:** This module is intended for use on **iOS devices only**.
 
-## Made with ❤️ at Callstack
+## Authors
 
-`voltra` is an open source project and will always remain free to use. If you think it's cool, please star it 🌟.
+`voltra` is an open source collaboration between [Saúl Sharma](https://github.com/saul-sharma) and [Szymon Chmal](https://github.com/szymonchmal) at [Callstack][callstack-readme-with-love].
+
+If you think it's cool, please star it 🌟. This project will always remain free to use.
 
 [Callstack][callstack-readme-with-love] is a group of React and React Native geeks, contact us at [hello@callstack.com](mailto:hello@callstack.com) if you need any help with these or just want to say hi!
 
-Like the project? ⚛️ [Join the team](https://callstack.com/careers/?utm_campaign=Senior_RN&utm_source=github&utm_medium=readme) who does amazing stuff for clients and drives React Native Open Source! 🔥
+Like the project? ⚛️ [Join the Callstack team](https://callstack.com/careers/?utm_campaign=Senior_RN&utm_source=github&utm_medium=readme) who does amazing stuff for clients and drives React Native Open Source! 🔥
 
 [callstack-readme-with-love]: https://callstack.com/?utm_source=github.com&utm_medium=referral&utm_campaign=voltra&utm_term=readme-with-love
 [license-badge]: https://img.shields.io/npm/l/voltra?style=for-the-badge

package/build/VoltraModule.d.ts

@@ -1,3 +1,121 @@
-declare const _default: any;
-export default _default;
+import type { EventSubscription, PreloadImageOptions, PreloadImagesResult, UpdateWidgetOptions } from './types.js';
+/**
+ * Options for starting a Live Activity
+ */
+export type StartVoltraOptions = {
+    /**
+     * Target type for the activity (used internally)
+     */
+    target?: string;
+    /**
+     * URL to open when the Live Activity is tapped.
+     */
+    deepLinkUrl?: string;
+    /**
+     * The ID/name of the Live Activity.
+     * Allows you to rebind to the same activity on app restart.
+     */
+    activityId?: string;
+    /**
+     * Unix timestamp in milliseconds
+     */
+    staleDate?: number;
+    /**
+     * Double value between 0.0 and 1.0, defaults to 0.0
+     */
+    relevanceScore?: number;
+};
+/**
+ * Options for updating a Live Activity
+ */
+export type UpdateVoltraOptions = {
+    /**
+     * Unix timestamp in milliseconds
+     */
+    staleDate?: number;
+    /**
+     * Double value between 0.0 and 1.0, defaults to 0.0
+     */
+    relevanceScore?: number;
+};
+/**
+ * Options for ending a Live Activity
+ */
+export type EndVoltraOptions = {
+    dismissalPolicy?: {
+        type: 'immediate' | 'after';
+        date?: number;
+    };
+};
+/**
+ * VoltraModule native module interface
+ */
+export interface VoltraModuleSpec {
+    /**
+     * Start a new Live Activity
+     */
+    startLiveActivity(jsonString: string, options?: StartVoltraOptions): Promise<string>;
+    /**
+     * Update an existing Live Activity
+     */
+    updateLiveActivity(activityId: string, jsonString: string, options?: UpdateVoltraOptions): Promise<void>;
+    /**
+     * End a Live Activity
+     */
+    endLiveActivity(activityId: string, options?: EndVoltraOptions): Promise<void>;
+    /**
+     * End all active Live Activities
+     */
+    endAllLiveActivities(): Promise<void>;
+    /**
+     * Get the latest (most recently created) Voltra Live Activity ID, if any
+     */
+    getLatestVoltraActivityId(): Promise<string | null>;
+    /**
+     * List all running Voltra Live Activity IDs
+     */
+    listVoltraActivityIds(): Promise<string[]>;
+    /**
+     * Check if a Live Activity with the given name is currently active
+     */
+    isLiveActivityActive(activityName: string): boolean;
+    /**
+     * Check if the app was launched in the background (headless)
+     */
+    isHeadless(): boolean;
+    /**
+     * Preload images to App Group storage for use in Live Activities
+     */
+    preloadImages(images: PreloadImageOptions[]): Promise<PreloadImagesResult>;
+    /**
+     * Reload Live Activities to pick up preloaded images
+     */
+    reloadLiveActivities(activityNames?: string[] | null): Promise<void>;
+    /**
+     * Clear preloaded images from App Group storage
+     */
+    clearPreloadedImages(keys?: string[] | null): Promise<void>;
+    /**
+     * Update a home screen widget with new content
+     */
+    updateWidget(widgetId: string, jsonString: string, options?: UpdateWidgetOptions): Promise<void>;
+    /**
+     * Reload widget timelines to refresh their content
+     */
+    reloadWidgets(widgetIds?: string[] | null): Promise<void>;
+    /**
+     * Clear a widget's stored data
+     */
+    clearWidget(widgetId: string): Promise<void>;
+    /**
+     * Clear all widgets' stored data
+     */
+    clearAllWidgets(): Promise<void>;
+    /**
+     * Add an event listener
+     */
+    addListener(event: string, listener: (event: any) => void): EventSubscription;
+}
+declare const VoltraModule: VoltraModuleSpec;
+export default VoltraModule;
 //# sourceMappingURL=VoltraModule.d.ts.map

package/build/VoltraModule.d.ts.map

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

package/build/VoltraModule.js

@@ -1,3 +1,4 @@
 import { requireNativeModule } from 'expo';
-export default requireNativeModule('VoltraModule');
+const VoltraModule = requireNativeModule('VoltraModule');
+export default VoltraModule;
 //# sourceMappingURL=VoltraModule.js.map

package/build/VoltraModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"VoltraModule.js","sourceRoot":"","sources":["../src/VoltraModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAA;AAE1C,eAAe,mBAAmB,CAAC,cAAc,CAAC,CAAA","sourcesContent":["import { requireNativeModule } from 'expo'\n\nexport default requireNativeModule('VoltraModule')\n"]}
+{"version":3,"file":"VoltraModule.js","sourceRoot":"","sources":["../src/VoltraModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAA;AA4I1C,MAAM,YAAY,GAAG,mBAAmB,CAAmB,cAAc,CAAC,CAAA;AAE1E,eAAe,YAAY,CAAA","sourcesContent":["import { requireNativeModule } from 'expo'\n\nimport type { EventSubscription, PreloadImageOptions, PreloadImagesResult, UpdateWidgetOptions } from './types.js'\n\n/**\n * Options for starting a Live Activity\n */\nexport type StartVoltraOptions = {\n  /**\n   * Target type for the activity (used internally)\n   */\n  target?: string\n  /**\n   * URL to open when the Live Activity is tapped.\n   */\n  deepLinkUrl?: string\n  /**\n   * The ID/name of the Live Activity.\n   * Allows you to rebind to the same activity on app restart.\n   */\n  activityId?: string\n  /**\n   * Unix timestamp in milliseconds\n   */\n  staleDate?: number\n  /**\n   * Double value between 0.0 and 1.0, defaults to 0.0\n   */\n  relevanceScore?: number\n}\n\n/**\n * Options for updating a Live Activity\n */\nexport type UpdateVoltraOptions = {\n  /**\n   * Unix timestamp in milliseconds\n   */\n  staleDate?: number\n  /**\n   * Double value between 0.0 and 1.0, defaults to 0.0\n   */\n  relevanceScore?: number\n}\n\n/**\n * Options for ending a Live Activity\n */\nexport type EndVoltraOptions = {\n  dismissalPolicy?: {\n    type: 'immediate' | 'after'\n    date?: number\n  }\n}\n\n/**\n * VoltraModule native module interface\n */\nexport interface VoltraModuleSpec {\n  /**\n   * Start a new Live Activity\n   */\n  startLiveActivity(jsonString: string, options?: StartVoltraOptions): Promise<string>\n\n  /**\n   * Update an existing Live Activity\n   */\n  updateLiveActivity(activityId: string, jsonString: string, options?: UpdateVoltraOptions): Promise<void>\n\n  /**\n   * End a Live Activity\n   */\n  endLiveActivity(activityId: string, options?: EndVoltraOptions): Promise<void>\n\n  /**\n   * End all active Live Activities\n   */\n  endAllLiveActivities(): Promise<void>\n\n  /**\n   * Get the latest (most recently created) Voltra Live Activity ID, if any\n   */\n  getLatestVoltraActivityId(): Promise<string | null>\n\n  /**\n   * List all running Voltra Live Activity IDs\n   */\n  listVoltraActivityIds(): Promise<string[]>\n\n  /**\n   * Check if a Live Activity with the given name is currently active\n   */\n  isLiveActivityActive(activityName: string): boolean\n\n  /**\n   * Check if the app was launched in the background (headless)\n   */\n  isHeadless(): boolean\n\n  /**\n   * Preload images to App Group storage for use in Live Activities\n   */\n  preloadImages(images: PreloadImageOptions[]): Promise<PreloadImagesResult>\n\n  /**\n   * Reload Live Activities to pick up preloaded images\n   */\n  reloadLiveActivities(activityNames?: string[] | null): Promise<void>\n\n  /**\n   * Clear preloaded images from App Group storage\n   */\n  clearPreloadedImages(keys?: string[] | null): Promise<void>\n\n  /**\n   * Update a home screen widget with new content\n   */\n  updateWidget(widgetId: string, jsonString: string, options?: UpdateWidgetOptions): Promise<void>\n\n  /**\n   * Reload widget timelines to refresh their content\n   */\n  reloadWidgets(widgetIds?: string[] | null): Promise<void>\n\n  /**\n   * Clear a widget's stored data\n   */\n  clearWidget(widgetId: string): Promise<void>\n\n  /**\n   * Clear all widgets' stored data\n   */\n  clearAllWidgets(): Promise<void>\n\n  /**\n   * Add an event listener\n   */\n  addListener(event: string, listener: (event: any) => void): EventSubscription\n}\n\nconst VoltraModule = requireNativeModule<VoltraModuleSpec>('VoltraModule')\n\nexport default VoltraModule\n"]}

package/build/events.d.ts

@@ -1,6 +1,4 @@
-export type EventSubscription = {
-    remove: () => void;
-};
+import type { EventSubscription } from './types.js';
 export type BasicVoltraEvent = {
     source: string;
     timestamp: number;

package/build/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;AACjG,MAAM,MAAM,gCAAgC,GAAG,gBAAgB,GAAG;IAChE,IAAI,EAAE,uBAAuB,CAAA;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AACD,MAAM,MAAM,2CAA2C,GAAG,gBAAgB,GAAG;IAC3E,IAAI,EAAE,kCAAkC,CAAA;IACxC,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AACD,MAAM,MAAM,yBAAyB,GAAG,gBAAgB,GAAG;IACzD,IAAI,EAAE,aAAa,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,mBAAmB,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG;IACtD,IAAI,EAAE,aAAa,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAMD,MAAM,MAAM,cAAc,GAAG;IAC3B,qBAAqB,EAAE,gCAAgC,CAAA;IACvD,gCAAgC,EAAE,2CAA2C,CAAA;IAC7E,WAAW,EAAE,yBAAyB,CAAA;IACtC,WAAW,EAAE,sBAAsB,CAAA;CACpC,CAAA;AAED,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,cAAc,EAC9D,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,GAC3C,iBAAiB,CAMnB"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAInD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;AACjG,MAAM,MAAM,gCAAgC,GAAG,gBAAgB,GAAG;IAChE,IAAI,EAAE,uBAAuB,CAAA;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AACD,MAAM,MAAM,2CAA2C,GAAG,gBAAgB,GAAG;IAC3E,IAAI,EAAE,kCAAkC,CAAA;IACxC,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AACD,MAAM,MAAM,yBAAyB,GAAG,gBAAgB,GAAG;IACzD,IAAI,EAAE,aAAa,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,mBAAmB,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG;IACtD,IAAI,EAAE,aAAa,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAMD,MAAM,MAAM,cAAc,GAAG;IAC3B,qBAAqB,EAAE,gCAAgC,CAAA;IACvD,gCAAgC,EAAE,2CAA2C,CAAA;IAC7E,WAAW,EAAE,yBAAyB,CAAA;IACtC,WAAW,EAAE,sBAAsB,CAAA;CACpC,CAAA;AAED,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,cAAc,EAC9D,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,GAC3C,iBAAiB,CAMnB"}

package/build/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,YAAY,MAAM,mBAAmB,CAAA;AAiC5C,MAAM,gBAAgB,GAAsB;IAC1C,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;CACjB,CAAA;AASD,MAAM,UAAU,iBAAiB,CAC/B,KAAQ,EACR,QAA4C;IAE5C,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAC5B,OAAO,gBAAgB,CAAA;IACzB,CAAC;IAED,OAAO,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AAClD,CAAC","sourcesContent":["import { assertRunningOnApple } from './utils/index.js'\nimport VoltraModule from './VoltraModule.js'\n\nexport type EventSubscription = {\n  remove: () => void\n}\n\nexport type BasicVoltraEvent = {\n  source: string\n  timestamp: number\n}\n\nexport type VoltraActivityState = 'active' | 'dismissed' | 'pending' | 'stale' | 'ended' | string\nexport type VoltraActivityTokenReceivedEvent = BasicVoltraEvent & {\n  type: 'activityTokenReceived'\n  activityName: string\n  pushToken: string\n}\nexport type VoltraActivityPushToStartTokenReceivedEvent = BasicVoltraEvent & {\n  type: 'activityPushToStartTokenReceived'\n  pushToStartToken: string\n}\nexport type VoltraActivityUpdateEvent = BasicVoltraEvent & {\n  type: 'stateChange'\n  activityName: string\n  activityState: VoltraActivityState\n}\n\nexport type VoltraInteractionEvent = BasicVoltraEvent & {\n  type: 'interaction'\n  identifier: string\n  payload: string\n}\n\nconst noopSubscription: EventSubscription = {\n  remove: () => {},\n}\n\nexport type VoltraEventMap = {\n  activityTokenReceived: VoltraActivityTokenReceivedEvent\n  activityPushToStartTokenReceived: VoltraActivityPushToStartTokenReceivedEvent\n  stateChange: VoltraActivityUpdateEvent\n  interaction: VoltraInteractionEvent\n}\n\nexport function addVoltraListener<K extends keyof VoltraEventMap>(\n  event: K,\n  listener: (event: VoltraEventMap[K]) => void\n): EventSubscription {\n  if (!assertRunningOnApple()) {\n    return noopSubscription\n  }\n\n  return VoltraModule.addListener(event, listener)\n}\n"]}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,YAAY,MAAM,mBAAmB,CAAA;AA6B5C,MAAM,gBAAgB,GAAsB;IAC1C,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;CACjB,CAAA;AASD,MAAM,UAAU,iBAAiB,CAC/B,KAAQ,EACR,QAA4C;IAE5C,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAC5B,OAAO,gBAAgB,CAAA;IACzB,CAAC;IAED,OAAO,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AAClD,CAAC","sourcesContent":["import type { EventSubscription } from './types.js'\nimport { assertRunningOnApple } from './utils/index.js'\nimport VoltraModule from './VoltraModule.js'\n\nexport type BasicVoltraEvent = {\n  source: string\n  timestamp: number\n}\n\nexport type VoltraActivityState = 'active' | 'dismissed' | 'pending' | 'stale' | 'ended' | string\nexport type VoltraActivityTokenReceivedEvent = BasicVoltraEvent & {\n  type: 'activityTokenReceived'\n  activityName: string\n  pushToken: string\n}\nexport type VoltraActivityPushToStartTokenReceivedEvent = BasicVoltraEvent & {\n  type: 'activityPushToStartTokenReceived'\n  pushToStartToken: string\n}\nexport type VoltraActivityUpdateEvent = BasicVoltraEvent & {\n  type: 'stateChange'\n  activityName: string\n  activityState: VoltraActivityState\n}\n\nexport type VoltraInteractionEvent = BasicVoltraEvent & {\n  type: 'interaction'\n  identifier: string\n  payload: string\n}\n\nconst noopSubscription: EventSubscription = {\n  remove: () => {},\n}\n\nexport type VoltraEventMap = {\n  activityTokenReceived: VoltraActivityTokenReceivedEvent\n  activityPushToStartTokenReceived: VoltraActivityPushToStartTokenReceivedEvent\n  stateChange: VoltraActivityUpdateEvent\n  interaction: VoltraInteractionEvent\n}\n\nexport function addVoltraListener<K extends keyof VoltraEventMap>(\n  event: K,\n  listener: (event: VoltraEventMap[K]) => void\n): EventSubscription {\n  if (!assertRunningOnApple()) {\n    return noopSubscription\n  }\n\n  return VoltraModule.addListener(event, listener)\n}\n"]}

package/build/live-activity/api.d.ts

@@ -140,7 +140,7 @@ export declare const updateLiveActivity: (targetId: string, variants: LiveActivi
  * ```tsx
  * import { stopLiveActivity } from 'voltra'
  *
- * await stopLiveActivity('activity-123', { dismissalPolicy: 'afterDate' })
+ * await stopLiveActivity('activity-123', { dismissalPolicy: 'immediate' })
  * ```
  */
 export declare const stopLiveActivity: (targetId: string, options?: EndLiveActivityOptions) => Promise<void>;

package/build/live-activity/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/live-activity/api.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEvE,MAAM,MAAM,yBAAyB,GAAG;IACtC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,yBAAyB,CAAA;AAE7B,MAAM,MAAM,yBAAyB,GAAG,yBAAyB,CAAA;AAEjE,MAAM,MAAM,sBAAsB,GAAG;IACnC,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,yBAAyB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9D,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxD,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA;AA6BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,oBAAoB,EAC9B,UAAU,sBAAsB,KAC/B,qBAwFF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,oBAAoB,EAC9B,UAAU,wBAAwB,KACjC,OAAO,CAAC,MAAM,CAahB,CAAA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,MAAM,EAChB,UAAU,oBAAoB,EAC9B,UAAU,yBAAyB,KAClC,OAAO,CAAC,IAAI,CAOd,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,GAAU,UAAU,MAAM,EAAE,UAAU,sBAAsB,KAAG,OAAO,CAAC,IAAI,CAIvG,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,MAAM,KAAG,OAI3D,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1D"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/live-activity/api.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEvE,MAAM,MAAM,yBAAyB,GAAG;IACtC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,yBAAyB,CAAA;AAE7B,MAAM,MAAM,yBAAyB,GAAG,yBAAyB,CAAA;AAEjE,MAAM,MAAM,sBAAsB,GAAG;IACnC,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,yBAAyB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9D,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxD,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA;AA8CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,oBAAoB,EAC9B,UAAU,sBAAsB,KAC/B,qBAwFF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,oBAAoB,EAC9B,UAAU,wBAAwB,KACjC,OAAO,CAAC,MAAM,CAahB,CAAA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,MAAM,EAChB,UAAU,oBAAoB,EAC9B,UAAU,yBAAyB,KAClC,OAAO,CAAC,IAAI,CAOd,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,GAAU,UAAU,MAAM,EAAE,UAAU,sBAAsB,KAAG,OAAO,CAAC,IAAI,CAKvG,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,MAAM,KAAG,OAI3D,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1D"}

package/build/live-activity/api.js

@@ -27,6 +27,20 @@ const normalizeSharedLiveActivityOptions = (options) => {
     }
     return Object.keys(normalizedOptions).length > 0 ? normalizedOptions : undefined;
 };
+const normalizeEndLiveActivityOptions = (options) => {
+    if (!options?.dismissalPolicy)
+        return undefined;
+    if (typeof options.dismissalPolicy === 'string') {
+        if (options.dismissalPolicy === 'immediate') {
+            return { dismissalPolicy: { type: 'immediate' } };
+        }
+    }
+    else if (typeof options.dismissalPolicy === 'object' && 'after' in options.dismissalPolicy) {
+        return { dismissalPolicy: { type: 'after', date: options.dismissalPolicy.after } };
+    }
+    // Default to immediate if unrecognized
+    return { dismissalPolicy: { type: 'immediate' } };
+};
 /**
  * React hook for managing Live Activities with automatic lifecycle handling.
  *
@@ -198,13 +212,14 @@ export const updateLiveActivity = async (targetId, variants, options) => {
  * ```tsx
  * import { stopLiveActivity } from 'voltra'
  *
- * await stopLiveActivity('activity-123', { dismissalPolicy: 'afterDate' })
+ * await stopLiveActivity('activity-123', { dismissalPolicy: 'immediate' })
  * ```
  */
 export const stopLiveActivity = async (targetId, options) => {
     if (!assertRunningOnApple())
         return Promise.resolve();
-    return VoltraModule.endLiveActivity(targetId, options);
+    const normalizedOptions = normalizeEndLiveActivityOptions(options);
+    return VoltraModule.endLiveActivity(targetId, normalizedOptions);
 };
 /**
  * Check if a Live Activity with the given name is currently active.

package/build/live-activity/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/live-activity/api.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react'\n\nimport { addVoltraListener } from '../events.js'\nimport { logger } from '../logger.js'\nimport { assertRunningOnApple, useUpdateOnHMR } from '../utils/index.js'\nimport VoltraModule from '../VoltraModule.js'\nimport { renderLiveActivityToString } from './renderer.js'\nimport type { DismissalPolicy, LiveActivityVariants } from './types.js'\n\nexport type SharedLiveActivityOptions = {\n  /**\n   * Unix timestamp in milliseconds\n   */\n  staleDate?: number\n  /**\n   * Double value between 0.0 and 1.0\n   * @default 0.0\n   */\n  relevanceScore?: number\n  /**\n   * How the Live Activity should be dismissed after ending\n   * @default 'immediate'\n   */\n  dismissalPolicy?: DismissalPolicy\n}\n\nexport type StartLiveActivityOptions = {\n  /**\n   * The name of the Live Activity.\n   * Allows you to rebind to the same activity on app restart.\n   */\n  activityName?: string\n  /**\n   * URL to open when the Live Activity is tapped.\n   */\n  deepLinkUrl?: string\n} & SharedLiveActivityOptions\n\nexport type UpdateLiveActivityOptions = SharedLiveActivityOptions\n\nexport type EndLiveActivityOptions = {\n  dismissalPolicy?: DismissalPolicy\n}\n\nexport type UseLiveActivityOptions = {\n  /**\n   * The name of the Live Activity.\n   * Allows you to rebind to the same activity on app restart.\n   */\n  activityName?: string\n  /**\n   * Automatically start the Live Activity when the component mounts.\n   */\n  autoStart?: boolean\n  /**\n   * Automatically update the Live Activity when the component updates.\n   */\n  autoUpdate?: boolean\n  /**\n   * URL to open when the Live Activity is tapped.\n   */\n  deepLinkUrl?: string\n}\n\nexport type UseLiveActivityResult = {\n  start: (options?: StartLiveActivityOptions) => Promise<void>\n  update: (options?: UpdateLiveActivityOptions) => Promise<void>\n  end: (options?: EndLiveActivityOptions) => Promise<void>\n  isActive: boolean\n}\n\nconst normalizeSharedLiveActivityOptions = (\n  options?: SharedLiveActivityOptions\n): SharedLiveActivityOptions | undefined => {\n  if (!options) return undefined\n\n  const normalizedOptions: SharedLiveActivityOptions = {}\n\n  if (options.staleDate !== undefined) {\n    if (options.staleDate < Date.now()) {\n      logger.warn('Ignoring staleDate because it is in the past, the Live Activity would be dismissed immediately.')\n    } else {\n      normalizedOptions.staleDate = options.staleDate\n    }\n  }\n\n  // Always include relevanceScore, defaulting to 0.0 if not provided\n  const relevanceScore = options.relevanceScore ?? 0.0\n  if (relevanceScore < 0 || relevanceScore > 1) {\n    logger.warn('Ignoring relevanceScore because it is out of range [0.0, 1.0], using default 0.0')\n    normalizedOptions.relevanceScore = 0.0\n  } else {\n    normalizedOptions.relevanceScore = relevanceScore\n  }\n\n  return Object.keys(normalizedOptions).length > 0 ? normalizedOptions : undefined\n}\n\n/**\n * React hook for managing Live Activities with automatic lifecycle handling.\n *\n * @param variants - The Live Activity content variants to display\n * @param options - Configuration options for the hook\n * @returns Object with start, update, end methods and isActive state\n *\n * @example\n * ```tsx\n * import { useLiveActivity, Voltra } from 'voltra'\n *\n * const MyLiveActivity = () => {\n *   const { start, update, end, isActive } = useLiveActivity({\n *     minimal: <Voltra.Text>Live Activity</Voltra.Text>,\n *     compact: <Voltra.HStack>...</Voltra.HStack>,\n *     expanded: <Voltra.VStack>...</Voltra.VStack>\n *   }, {\n *     activityName: 'my-activity',\n *     autoStart: true,\n *     autoUpdate: true\n *   })\n *\n *   return (\n *     <View>\n *       <Button title={isActive ? \"Stop\" : \"Start\"} onPress={isActive ? end : start} />\n *     </View>\n *   )\n * }\n * ```\n */\nexport const useLiveActivity = (\n  variants: LiveActivityVariants,\n  options?: UseLiveActivityOptions\n): UseLiveActivityResult => {\n  const [targetId, setTargetId] = useState<string | null>(() => {\n    if (options?.activityName) {\n      return isLiveActivityActive(options.activityName) ? options.activityName : null\n    }\n\n    return null\n  })\n  const isActive = targetId !== null\n  const optionsRef = useRef(options)\n  const variantsRef = useRef(variants)\n  const lastUpdateOptionsRef = useRef<UpdateLiveActivityOptions | undefined>(undefined)\n\n  // Update refs when values change\n  useEffect(() => {\n    optionsRef.current = options\n  }, [options])\n\n  useEffect(() => {\n    variantsRef.current = variants\n  }, [variants])\n\n  useUpdateOnHMR()\n\n  const start = useCallback(async (options?: StartLiveActivityOptions) => {\n    const id = await startLiveActivity(variantsRef.current, { ...optionsRef.current, ...options })\n    setTargetId(id)\n  }, [])\n\n  const update = useCallback(\n    async (options?: UpdateLiveActivityOptions) => {\n      if (!targetId) {\n        return\n      }\n\n      const updateOptions = { ...optionsRef.current, ...options }\n      lastUpdateOptionsRef.current = updateOptions\n      await updateLiveActivity(targetId, variantsRef.current, updateOptions)\n    },\n    [targetId]\n  )\n\n  const end = useCallback(\n    async (options?: EndLiveActivityOptions) => {\n      if (!targetId) {\n        return\n      }\n\n      await stopLiveActivity(targetId, options)\n      setTargetId(null)\n    },\n    [targetId]\n  )\n\n  useEffect(() => {\n    if (!options?.autoStart) {\n      return\n    }\n\n    start()\n  }, [options?.autoStart, start])\n\n  useEffect(() => {\n    if (!options?.autoUpdate) return\n    update(lastUpdateOptionsRef.current)\n  }, [options?.autoUpdate, update, variants])\n\n  useEffect(() => {\n    if (!targetId) return\n\n    const subscription = addVoltraListener('stateChange', (event) => {\n      if (event.activityName !== targetId) return\n\n      if (event.activityState === 'dismissed' || event.activityState === 'ended') {\n        // Live Activity is no longer active.\n        setTargetId(null)\n      }\n    })\n\n    return () => subscription.remove()\n  }, [targetId])\n\n  return {\n    start,\n    update,\n    end,\n    isActive,\n  }\n}\n\n/**\n * Start a new Live Activity with the provided content variants.\n *\n * @param variants - The Live Activity content variants to display\n * @param options - Configuration options for the Live Activity\n * @returns Promise resolving to the activity ID\n *\n * @example\n * ```tsx\n * import { startLiveActivity, Voltra } from 'voltra'\n *\n * const activityId = await startLiveActivity({\n *   minimal: <Voltra.Text>Live Activity</Voltra.Text>,\n *   compact: <Voltra.HStack>...</Voltra.HStack>,\n *   expanded: <Voltra.VStack>...</Voltra.VStack>\n * }, {\n *   activityName: 'my-activity',\n *   deepLinkUrl: '/details',\n *   relevanceScore: 0.8\n * })\n * ```\n */\nexport const startLiveActivity = async (\n  variants: LiveActivityVariants,\n  options?: StartLiveActivityOptions\n): Promise<string> => {\n  if (!assertRunningOnApple()) return Promise.resolve('')\n\n  const payload = renderLiveActivityToString(variants)\n\n  const normalizedSharedOptions = normalizeSharedLiveActivityOptions(options)\n  const targetId = await VoltraModule.startLiveActivity(payload, {\n    target: 'liveActivity',\n    deepLinkUrl: options?.deepLinkUrl,\n    activityId: options?.activityName,\n    ...normalizedSharedOptions,\n  })\n  return targetId\n}\n\n/**\n * Update an existing Live Activity with new content.\n *\n * @param targetId - The ID of the Live Activity to update\n * @param variants - The new Live Activity content variants\n * @param options - Update options like relevance score\n *\n * @example\n * ```tsx\n * import { updateLiveActivity, Voltra } from 'voltra'\n *\n * await updateLiveActivity('activity-123', {\n *   minimal: <Voltra.Text>Updated: Live Activity</Voltra.Text>,\n *   compact: <Voltra.HStack>...</Voltra.HStack>,\n *   expanded: <Voltra.VStack>...</Voltra.VStack>\n * }, {\n *   relevanceScore: 0.9\n * })\n * ```\n */\nexport const updateLiveActivity = async (\n  targetId: string,\n  variants: LiveActivityVariants,\n  options?: UpdateLiveActivityOptions\n): Promise<void> => {\n  if (!assertRunningOnApple()) return Promise.resolve()\n\n  const payload = renderLiveActivityToString(variants)\n\n  const normalizedSharedOptions = normalizeSharedLiveActivityOptions(options)\n  return VoltraModule.updateLiveActivity(targetId, payload, normalizedSharedOptions)\n}\n\n/**\n * Stop a Live Activity.\n *\n * @param targetId - The ID of the Live Activity to stop\n * @param options - Options for how to end the activity\n *\n * @example\n * ```tsx\n * import { stopLiveActivity } from 'voltra'\n *\n * await stopLiveActivity('activity-123', { dismissalPolicy: 'afterDate' })\n * ```\n */\nexport const stopLiveActivity = async (targetId: string, options?: EndLiveActivityOptions): Promise<void> => {\n  if (!assertRunningOnApple()) return Promise.resolve()\n\n  return VoltraModule.endLiveActivity(targetId, options)\n}\n\n/**\n * Check if a Live Activity with the given name is currently active.\n *\n * @param activityName - The name of the Live Activity to check\n * @returns true if the activity is active, false otherwise\n *\n * @example\n * ```tsx\n * import { isLiveActivityActive } from 'voltra'\n *\n * if (isLiveActivityActive('my-activity')) {\n *   console.log('Activity is running')\n * }\n * ```\n */\nexport const isLiveActivityActive = (activityName: string): boolean => {\n  if (!assertRunningOnApple()) return false\n\n  return VoltraModule.isLiveActivityActive(activityName)\n}\n\n/**\n * End all active Live Activities.\n *\n * This function stops and dismisses all currently running Live Activities in the app.\n * It's useful for cleanup operations, such as when the app is being closed or\n * when you want to reset all Live Activity states.\n *\n * @example\n * ```typescript\n * import { endAllLiveActivities } from 'voltra'\n *\n * // End all active Live Activities\n * await endAllLiveActivities()\n * ```\n */\nexport async function endAllLiveActivities(): Promise<void> {\n  if (!assertRunningOnApple()) return Promise.resolve()\n  return VoltraModule.endAllLiveActivities()\n}\n"]}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/live-activity/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,YAAY,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAA;AAiE1D,MAAM,kCAAkC,GAAG,CACzC,OAAmC,EACI,EAAE;IACzC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAA;IAE9B,MAAM,iBAAiB,GAA8B,EAAE,CAAA;IAEvD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACpC,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,iGAAiG,CAAC,CAAA;QAChH,CAAC;aAAM,CAAC;YACN,iBAAiB,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;QACjD,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,GAAG,CAAA;IACpD,IAAI,cAAc,GAAG,CAAC,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,kFAAkF,CAAC,CAAA;QAC/F,iBAAiB,CAAC,cAAc,GAAG,GAAG,CAAA;IACxC,CAAC;SAAM,CAAC;QACN,iBAAiB,CAAC,cAAc,GAAG,cAAc,CAAA;IACnD,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAA;AAClF,CAAC,CAAA;AAED,MAAM,+BAA+B,GAAG,CACtC,OAAgC,EACkD,EAAE;IACpF,IAAI,CAAC,OAAO,EAAE,eAAe;QAAE,OAAO,SAAS,CAAA;IAE/C,IAAI,OAAO,OAAO,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;QAChD,IAAI,OAAO,CAAC,eAAe,KAAK,WAAW,EAAE,CAAC;YAC5C,OAAO,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CAAA;QACnD,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,OAAO,CAAC,eAAe,KAAK,QAAQ,IAAI,OAAO,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;QAC7F,OAAO,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,EAAE,CAAA;IACpF,CAAC;IAED,uCAAuC;IACvC,OAAO,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CAAA;AACnD,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,QAA8B,EAC9B,OAAgC,EACT,EAAE;IACzB,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAgB,GAAG,EAAE;QAC3D,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;YAC1B,OAAO,oBAAoB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAA;QACjF,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;IACF,MAAM,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAA;IAClC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;IAClC,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IACpC,MAAM,oBAAoB,GAAG,MAAM,CAAwC,SAAS,CAAC,CAAA;IAErF,iCAAiC;IACjC,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,OAAO,CAAA;IAC9B,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IAEb,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAA;IAChC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEd,cAAc,EAAE,CAAA;IAEhB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,OAAkC,EAAE,EAAE;QACrE,MAAM,EAAE,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;QAC9F,WAAW,CAAC,EAAE,CAAC,CAAA;IACjB,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,OAAmC,EAAE,EAAE;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAM;QACR,CAAC;QAED,MAAM,aAAa,GAAG,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAA;QAC3D,oBAAoB,CAAC,OAAO,GAAG,aAAa,CAAA;QAC5C,MAAM,kBAAkB,CAAC,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,CAAA;IACxE,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAA;IAED,MAAM,GAAG,GAAG,WAAW,CACrB,KAAK,EAAE,OAAgC,EAAE,EAAE;QACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAM;QACR,CAAC;QAED,MAAM,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACzC,WAAW,CAAC,IAAI,CAAC,CAAA;IACnB,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAA;IAED,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;YACxB,OAAM;QACR,CAAC;QAED,KAAK,EAAE,CAAA;IACT,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAA;IAE/B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,EAAE,UAAU;YAAE,OAAM;QAChC,MAAM,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAA;IACtC,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;IAE3C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ;YAAE,OAAM;QAErB,MAAM,YAAY,GAAG,iBAAiB,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE;YAC9D,IAAI,KAAK,CAAC,YAAY,KAAK,QAAQ;gBAAE,OAAM;YAE3C,IAAI,KAAK,CAAC,aAAa,KAAK,WAAW,IAAI,KAAK,CAAC,aAAa,KAAK,OAAO,EAAE,CAAC;gBAC3E,qCAAqC;gBACrC,WAAW,CAAC,IAAI,CAAC,CAAA;YACnB,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAA;IACpC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEd,OAAO;QACL,KAAK;QACL,MAAM;QACN,GAAG;QACH,QAAQ;KACT,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EACpC,QAA8B,EAC9B,OAAkC,EACjB,EAAE;IACnB,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAEvD,MAAM,OAAO,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAA;IAEpD,MAAM,uBAAuB,GAAG,kCAAkC,CAAC,OAAO,CAAC,CAAA;IAC3E,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,iBAAiB,CAAC,OAAO,EAAE;QAC7D,MAAM,EAAE,cAAc;QACtB,WAAW,EAAE,OAAO,EAAE,WAAW;QACjC,UAAU,EAAE,OAAO,EAAE,YAAY;QACjC,GAAG,uBAAuB;KAC3B,CAAC,CAAA;IACF,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,QAAgB,EAChB,QAA8B,EAC9B,OAAmC,EACpB,EAAE;IACjB,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAErD,MAAM,OAAO,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAA;IAEpD,MAAM,uBAAuB,GAAG,kCAAkC,CAAC,OAAO,CAAC,CAAA;IAC3E,OAAO,YAAY,CAAC,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAA;AACpF,CAAC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,QAAgB,EAAE,OAAgC,EAAiB,EAAE;IAC1G,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAErD,MAAM,iBAAiB,GAAG,+BAA+B,CAAC,OAAO,CAAC,CAAA;IAClE,OAAO,YAAY,CAAC,eAAe,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAA;AAClE,CAAC,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,YAAoB,EAAW,EAAE;IACpE,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO,KAAK,CAAA;IAEzC,OAAO,YAAY,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAA;AACxD,CAAC,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IACrD,OAAO,YAAY,CAAC,oBAAoB,EAAE,CAAA;AAC5C,CAAC","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react'\n\nimport { addVoltraListener } from '../events.js'\nimport { logger } from '../logger.js'\nimport { assertRunningOnApple, useUpdateOnHMR } from '../utils/index.js'\nimport VoltraModule from '../VoltraModule.js'\nimport { renderLiveActivityToString } from './renderer.js'\nimport type { DismissalPolicy, LiveActivityVariants } from './types.js'\n\nexport type SharedLiveActivityOptions = {\n  /**\n   * Unix timestamp in milliseconds\n   */\n  staleDate?: number\n  /**\n   * Double value between 0.0 and 1.0\n   * @default 0.0\n   */\n  relevanceScore?: number\n  /**\n   * How the Live Activity should be dismissed after ending\n   * @default 'immediate'\n   */\n  dismissalPolicy?: DismissalPolicy\n}\n\nexport type StartLiveActivityOptions = {\n  /**\n   * The name of the Live Activity.\n   * Allows you to rebind to the same activity on app restart.\n   */\n  activityName?: string\n  /**\n   * URL to open when the Live Activity is tapped.\n   */\n  deepLinkUrl?: string\n} & SharedLiveActivityOptions\n\nexport type UpdateLiveActivityOptions = SharedLiveActivityOptions\n\nexport type EndLiveActivityOptions = {\n  dismissalPolicy?: DismissalPolicy\n}\n\nexport type UseLiveActivityOptions = {\n  /**\n   * The name of the Live Activity.\n   * Allows you to rebind to the same activity on app restart.\n   */\n  activityName?: string\n  /**\n   * Automatically start the Live Activity when the component mounts.\n   */\n  autoStart?: boolean\n  /**\n   * Automatically update the Live Activity when the component updates.\n   */\n  autoUpdate?: boolean\n  /**\n   * URL to open when the Live Activity is tapped.\n   */\n  deepLinkUrl?: string\n}\n\nexport type UseLiveActivityResult = {\n  start: (options?: StartLiveActivityOptions) => Promise<void>\n  update: (options?: UpdateLiveActivityOptions) => Promise<void>\n  end: (options?: EndLiveActivityOptions) => Promise<void>\n  isActive: boolean\n}\n\nconst normalizeSharedLiveActivityOptions = (\n  options?: SharedLiveActivityOptions\n): SharedLiveActivityOptions | undefined => {\n  if (!options) return undefined\n\n  const normalizedOptions: SharedLiveActivityOptions = {}\n\n  if (options.staleDate !== undefined) {\n    if (options.staleDate < Date.now()) {\n      logger.warn('Ignoring staleDate because it is in the past, the Live Activity would be dismissed immediately.')\n    } else {\n      normalizedOptions.staleDate = options.staleDate\n    }\n  }\n\n  // Always include relevanceScore, defaulting to 0.0 if not provided\n  const relevanceScore = options.relevanceScore ?? 0.0\n  if (relevanceScore < 0 || relevanceScore > 1) {\n    logger.warn('Ignoring relevanceScore because it is out of range [0.0, 1.0], using default 0.0')\n    normalizedOptions.relevanceScore = 0.0\n  } else {\n    normalizedOptions.relevanceScore = relevanceScore\n  }\n\n  return Object.keys(normalizedOptions).length > 0 ? normalizedOptions : undefined\n}\n\nconst normalizeEndLiveActivityOptions = (\n  options?: EndLiveActivityOptions\n): { dismissalPolicy?: { type: 'immediate' | 'after'; date?: number } } | undefined => {\n  if (!options?.dismissalPolicy) return undefined\n\n  if (typeof options.dismissalPolicy === 'string') {\n    if (options.dismissalPolicy === 'immediate') {\n      return { dismissalPolicy: { type: 'immediate' } }\n    }\n  } else if (typeof options.dismissalPolicy === 'object' && 'after' in options.dismissalPolicy) {\n    return { dismissalPolicy: { type: 'after', date: options.dismissalPolicy.after } }\n  }\n\n  // Default to immediate if unrecognized\n  return { dismissalPolicy: { type: 'immediate' } }\n}\n\n/**\n * React hook for managing Live Activities with automatic lifecycle handling.\n *\n * @param variants - The Live Activity content variants to display\n * @param options - Configuration options for the hook\n * @returns Object with start, update, end methods and isActive state\n *\n * @example\n * ```tsx\n * import { useLiveActivity, Voltra } from 'voltra'\n *\n * const MyLiveActivity = () => {\n *   const { start, update, end, isActive } = useLiveActivity({\n *     minimal: <Voltra.Text>Live Activity</Voltra.Text>,\n *     compact: <Voltra.HStack>...</Voltra.HStack>,\n *     expanded: <Voltra.VStack>...</Voltra.VStack>\n *   }, {\n *     activityName: 'my-activity',\n *     autoStart: true,\n *     autoUpdate: true\n *   })\n *\n *   return (\n *     <View>\n *       <Button title={isActive ? \"Stop\" : \"Start\"} onPress={isActive ? end : start} />\n *     </View>\n *   )\n * }\n * ```\n */\nexport const useLiveActivity = (\n  variants: LiveActivityVariants,\n  options?: UseLiveActivityOptions\n): UseLiveActivityResult => {\n  const [targetId, setTargetId] = useState<string | null>(() => {\n    if (options?.activityName) {\n      return isLiveActivityActive(options.activityName) ? options.activityName : null\n    }\n\n    return null\n  })\n  const isActive = targetId !== null\n  const optionsRef = useRef(options)\n  const variantsRef = useRef(variants)\n  const lastUpdateOptionsRef = useRef<UpdateLiveActivityOptions | undefined>(undefined)\n\n  // Update refs when values change\n  useEffect(() => {\n    optionsRef.current = options\n  }, [options])\n\n  useEffect(() => {\n    variantsRef.current = variants\n  }, [variants])\n\n  useUpdateOnHMR()\n\n  const start = useCallback(async (options?: StartLiveActivityOptions) => {\n    const id = await startLiveActivity(variantsRef.current, { ...optionsRef.current, ...options })\n    setTargetId(id)\n  }, [])\n\n  const update = useCallback(\n    async (options?: UpdateLiveActivityOptions) => {\n      if (!targetId) {\n        return\n      }\n\n      const updateOptions = { ...optionsRef.current, ...options }\n      lastUpdateOptionsRef.current = updateOptions\n      await updateLiveActivity(targetId, variantsRef.current, updateOptions)\n    },\n    [targetId]\n  )\n\n  const end = useCallback(\n    async (options?: EndLiveActivityOptions) => {\n      if (!targetId) {\n        return\n      }\n\n      await stopLiveActivity(targetId, options)\n      setTargetId(null)\n    },\n    [targetId]\n  )\n\n  useEffect(() => {\n    if (!options?.autoStart) {\n      return\n    }\n\n    start()\n  }, [options?.autoStart, start])\n\n  useEffect(() => {\n    if (!options?.autoUpdate) return\n    update(lastUpdateOptionsRef.current)\n  }, [options?.autoUpdate, update, variants])\n\n  useEffect(() => {\n    if (!targetId) return\n\n    const subscription = addVoltraListener('stateChange', (event) => {\n      if (event.activityName !== targetId) return\n\n      if (event.activityState === 'dismissed' || event.activityState === 'ended') {\n        // Live Activity is no longer active.\n        setTargetId(null)\n      }\n    })\n\n    return () => subscription.remove()\n  }, [targetId])\n\n  return {\n    start,\n    update,\n    end,\n    isActive,\n  }\n}\n\n/**\n * Start a new Live Activity with the provided content variants.\n *\n * @param variants - The Live Activity content variants to display\n * @param options - Configuration options for the Live Activity\n * @returns Promise resolving to the activity ID\n *\n * @example\n * ```tsx\n * import { startLiveActivity, Voltra } from 'voltra'\n *\n * const activityId = await startLiveActivity({\n *   minimal: <Voltra.Text>Live Activity</Voltra.Text>,\n *   compact: <Voltra.HStack>...</Voltra.HStack>,\n *   expanded: <Voltra.VStack>...</Voltra.VStack>\n * }, {\n *   activityName: 'my-activity',\n *   deepLinkUrl: '/details',\n *   relevanceScore: 0.8\n * })\n * ```\n */\nexport const startLiveActivity = async (\n  variants: LiveActivityVariants,\n  options?: StartLiveActivityOptions\n): Promise<string> => {\n  if (!assertRunningOnApple()) return Promise.resolve('')\n\n  const payload = renderLiveActivityToString(variants)\n\n  const normalizedSharedOptions = normalizeSharedLiveActivityOptions(options)\n  const targetId = await VoltraModule.startLiveActivity(payload, {\n    target: 'liveActivity',\n    deepLinkUrl: options?.deepLinkUrl,\n    activityId: options?.activityName,\n    ...normalizedSharedOptions,\n  })\n  return targetId\n}\n\n/**\n * Update an existing Live Activity with new content.\n *\n * @param targetId - The ID of the Live Activity to update\n * @param variants - The new Live Activity content variants\n * @param options - Update options like relevance score\n *\n * @example\n * ```tsx\n * import { updateLiveActivity, Voltra } from 'voltra'\n *\n * await updateLiveActivity('activity-123', {\n *   minimal: <Voltra.Text>Updated: Live Activity</Voltra.Text>,\n *   compact: <Voltra.HStack>...</Voltra.HStack>,\n *   expanded: <Voltra.VStack>...</Voltra.VStack>\n * }, {\n *   relevanceScore: 0.9\n * })\n * ```\n */\nexport const updateLiveActivity = async (\n  targetId: string,\n  variants: LiveActivityVariants,\n  options?: UpdateLiveActivityOptions\n): Promise<void> => {\n  if (!assertRunningOnApple()) return Promise.resolve()\n\n  const payload = renderLiveActivityToString(variants)\n\n  const normalizedSharedOptions = normalizeSharedLiveActivityOptions(options)\n  return VoltraModule.updateLiveActivity(targetId, payload, normalizedSharedOptions)\n}\n\n/**\n * Stop a Live Activity.\n *\n * @param targetId - The ID of the Live Activity to stop\n * @param options - Options for how to end the activity\n *\n * @example\n * ```tsx\n * import { stopLiveActivity } from 'voltra'\n *\n * await stopLiveActivity('activity-123', { dismissalPolicy: 'immediate' })\n * ```\n */\nexport const stopLiveActivity = async (targetId: string, options?: EndLiveActivityOptions): Promise<void> => {\n  if (!assertRunningOnApple()) return Promise.resolve()\n\n  const normalizedOptions = normalizeEndLiveActivityOptions(options)\n  return VoltraModule.endLiveActivity(targetId, normalizedOptions)\n}\n\n/**\n * Check if a Live Activity with the given name is currently active.\n *\n * @param activityName - The name of the Live Activity to check\n * @returns true if the activity is active, false otherwise\n *\n * @example\n * ```tsx\n * import { isLiveActivityActive } from 'voltra'\n *\n * if (isLiveActivityActive('my-activity')) {\n *   console.log('Activity is running')\n * }\n * ```\n */\nexport const isLiveActivityActive = (activityName: string): boolean => {\n  if (!assertRunningOnApple()) return false\n\n  return VoltraModule.isLiveActivityActive(activityName)\n}\n\n/**\n * End all active Live Activities.\n *\n * This function stops and dismisses all currently running Live Activities in the app.\n * It's useful for cleanup operations, such as when the app is being closed or\n * when you want to reset all Live Activity states.\n *\n * @example\n * ```typescript\n * import { endAllLiveActivities } from 'voltra'\n *\n * // End all active Live Activities\n * await endAllLiveActivities()\n * ```\n */\nexport async function endAllLiveActivities(): Promise<void> {\n  if (!assertRunningOnApple()) return Promise.resolve()\n  return VoltraModule.endAllLiveActivities()\n}\n"]}

package/build/preload.d.ts

@@ -1,40 +1,5 @@
-/**
- * Options for preloading a single image
- */
-export type PreloadImageOptions = {
-    /**
-     * The URL to download the image from
-     */
-    url: string;
-    /**
-     * The key to use when referencing this image (used as assetName in Image component)
-     */
-    key: string;
-    /**
-     * HTTP method to use. Defaults to 'GET'.
-     */
-    method?: 'GET' | 'POST' | 'PUT';
-    /**
-     * Optional HTTP headers to include in the request
-     */
-    headers?: Record<string, string>;
-};
-/**
- * Result of preloading images
- */
-export type PreloadImagesResult = {
-    /**
-     * Keys of images that were successfully preloaded
-     */
-    succeeded: string[];
-    /**
-     * Images that failed to preload, with error messages
-     */
-    failed: {
-        key: string;
-        error: string;
-    }[];
-};
+import type { PreloadImageOptions, PreloadImagesResult } from './types.js';
+export type { PreloadImageOptions, PreloadImagesResult } from './types.js';
 /**
  * Preload images to App Group storage for use in Live Activities.
  *

package/build/preload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preload.d.ts","sourceRoot":"","sources":["../src/preload.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IACX;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IACX;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;IAC/B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB;;OAEG;IACH,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACzC,CAAA;AAQD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgB/F;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,oBAAoB,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE"}
+{"version":3,"file":"preload.d.ts","sourceRoot":"","sources":["../src/preload.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAI1E,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAQ1E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgB/F;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,oBAAoB,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE"}

package/build/preload.js.map

@@ -1 +1 @@
-{"version":3,"file":"preload.js","sourceRoot":"","sources":["../src/preload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAEvC,OAAO,YAAY,MAAM,mBAAmB,CAAA;AAsC5C,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,KAAK,KAAK,CAAA;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,2BAA2B,CAAC,CAAA;IAC7D,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAA6B;IAC/D,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC,CAAC,EAAE,CAAA;IACpH,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAO,YAAoB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC3B,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAChE,CAAC,CAAC;SACJ,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,aAAwB;IACjE,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC;QAAE,OAAM;IAE9C,IAAI,CAAC;QACH,MAAO,YAAoB,CAAC,oBAAoB,CAAC,aAAa,IAAI,IAAI,CAAC,CAAA;IACzE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAe;IACxD,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC;QAAE,OAAM;IAE9C,IAAI,CAAC;QACH,MAAO,YAAoB,CAAC,oBAAoB,CAAC,IAAI,IAAI,IAAI,CAAC,CAAA;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC","sourcesContent":["import { Platform } from 'react-native'\n\nimport VoltraModule from './VoltraModule.js'\n\n/**\n * Options for preloading a single image\n */\nexport type PreloadImageOptions = {\n  /**\n   * The URL to download the image from\n   */\n  url: string\n  /**\n   * The key to use when referencing this image (used as assetName in Image component)\n   */\n  key: string\n  /**\n   * HTTP method to use. Defaults to 'GET'.\n   */\n  method?: 'GET' | 'POST' | 'PUT'\n  /**\n   * Optional HTTP headers to include in the request\n   */\n  headers?: Record<string, string>\n}\n\n/**\n * Result of preloading images\n */\nexport type PreloadImagesResult = {\n  /**\n   * Keys of images that were successfully preloaded\n   */\n  succeeded: string[]\n  /**\n   * Images that failed to preload, with error messages\n   */\n  failed: { key: string; error: string }[]\n}\n\nfunction assertIOS(name: string): boolean {\n  const isIOS = Platform.OS === 'ios'\n  if (!isIOS) console.error(`${name} is only available on iOS`)\n  return isIOS\n}\n\n/**\n * Preload images to App Group storage for use in Live Activities.\n *\n * Downloaded images are stored in shared storage accessible by both the app\n * and the Live Activity widget extension. Images can then be referenced using\n * the `assetName` property in the Image component.\n *\n * Images must be less than 4KB to comply with ActivityKit limits.\n *\n * @param images - Array of images to preload\n * @returns Result indicating which images succeeded or failed\n *\n * @example\n * ```typescript\n * const result = await preloadImages([\n *   {\n *     url: 'https://example.com/album-art.jpg',\n *     key: 'current-album',\n *     headers: { 'Authorization': 'Bearer token' }\n *   }\n * ])\n *\n * // Use in Live Activity\n * <Voltra.Image source={{ assetName: 'current-album' }} />\n * ```\n */\nexport async function preloadImages(images: PreloadImageOptions[]): Promise<PreloadImagesResult> {\n  if (!assertIOS('preloadImages')) {\n    return { succeeded: [], failed: images.map((img) => ({ key: img.key, error: 'Not available on this platform' })) }\n  }\n\n  try {\n    return await (VoltraModule as any).preloadImages(images)\n  } catch (error) {\n    return {\n      succeeded: [],\n      failed: images.map((img) => ({\n        key: img.key,\n        error: error instanceof Error ? error.message : 'Unknown error',\n      })),\n    }\n  }\n}\n\n/**\n * Reload Live Activities to pick up newly preloaded images.\n *\n * This triggers an update on the specified Live Activities (or all if none specified)\n * with their current content state, forcing SwiftUI to re-render and load the\n * newly preloaded images from App Group storage.\n *\n * @param activityNames - Optional array of activity names to reload. If omitted, reloads all.\n *\n * @example\n * ```typescript\n * // Preload new image\n * await preloadImages([{ url: 'https://example.com/new-art.jpg', key: 'album-art' }])\n *\n * // Reload specific activity to pick up the new image\n * await reloadLiveActivities(['music-player'])\n *\n * // Or reload all activities\n * await reloadLiveActivities()\n * ```\n */\nexport async function reloadLiveActivities(activityNames?: string[]): Promise<void> {\n  if (!assertIOS('reloadLiveActivities')) return\n\n  try {\n    await (VoltraModule as any).reloadLiveActivities(activityNames ?? null)\n  } catch (error) {\n    console.error('Failed to reload Live Activities:', error)\n  }\n}\n\n/**\n * Clear preloaded images from App Group storage.\n *\n * @param keys - Optional array of image keys to clear. If omitted, clears all preloaded images.\n *\n * @example\n * ```typescript\n * // Clear specific images\n * await clearPreloadedImages(['album-art', 'profile-pic'])\n *\n * // Clear all preloaded images\n * await clearPreloadedImages()\n * ```\n */\nexport async function clearPreloadedImages(keys?: string[]): Promise<void> {\n  if (!assertIOS('clearPreloadedImages')) return\n\n  try {\n    await (VoltraModule as any).clearPreloadedImages(keys ?? null)\n  } catch (error) {\n    console.error('Failed to clear preloaded images:', error)\n  }\n}\n"]}
+{"version":3,"file":"preload.js","sourceRoot":"","sources":["../src/preload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAGvC,OAAO,YAAY,MAAM,mBAAmB,CAAA;AAK5C,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,KAAK,KAAK,CAAA;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,2BAA2B,CAAC,CAAA;IAC7D,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAA6B;IAC/D,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC,CAAC,EAAE,CAAA;IACpH,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAO,YAAoB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC3B,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAChE,CAAC,CAAC;SACJ,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,aAAwB;IACjE,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC;QAAE,OAAM;IAE9C,IAAI,CAAC;QACH,MAAO,YAAoB,CAAC,oBAAoB,CAAC,aAAa,IAAI,IAAI,CAAC,CAAA;IACzE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAe;IACxD,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC;QAAE,OAAM;IAE9C,IAAI,CAAC;QACH,MAAO,YAAoB,CAAC,oBAAoB,CAAC,IAAI,IAAI,IAAI,CAAC,CAAA;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC","sourcesContent":["import { Platform } from 'react-native'\n\nimport type { PreloadImageOptions, PreloadImagesResult } from './types.js'\nimport VoltraModule from './VoltraModule.js'\n\n// Re-export types for public API\nexport type { PreloadImageOptions, PreloadImagesResult } from './types.js'\n\nfunction assertIOS(name: string): boolean {\n  const isIOS = Platform.OS === 'ios'\n  if (!isIOS) console.error(`${name} is only available on iOS`)\n  return isIOS\n}\n\n/**\n * Preload images to App Group storage for use in Live Activities.\n *\n * Downloaded images are stored in shared storage accessible by both the app\n * and the Live Activity widget extension. Images can then be referenced using\n * the `assetName` property in the Image component.\n *\n * Images must be less than 4KB to comply with ActivityKit limits.\n *\n * @param images - Array of images to preload\n * @returns Result indicating which images succeeded or failed\n *\n * @example\n * ```typescript\n * const result = await preloadImages([\n *   {\n *     url: 'https://example.com/album-art.jpg',\n *     key: 'current-album',\n *     headers: { 'Authorization': 'Bearer token' }\n *   }\n * ])\n *\n * // Use in Live Activity\n * <Voltra.Image source={{ assetName: 'current-album' }} />\n * ```\n */\nexport async function preloadImages(images: PreloadImageOptions[]): Promise<PreloadImagesResult> {\n  if (!assertIOS('preloadImages')) {\n    return { succeeded: [], failed: images.map((img) => ({ key: img.key, error: 'Not available on this platform' })) }\n  }\n\n  try {\n    return await (VoltraModule as any).preloadImages(images)\n  } catch (error) {\n    return {\n      succeeded: [],\n      failed: images.map((img) => ({\n        key: img.key,\n        error: error instanceof Error ? error.message : 'Unknown error',\n      })),\n    }\n  }\n}\n\n/**\n * Reload Live Activities to pick up newly preloaded images.\n *\n * This triggers an update on the specified Live Activities (or all if none specified)\n * with their current content state, forcing SwiftUI to re-render and load the\n * newly preloaded images from App Group storage.\n *\n * @param activityNames - Optional array of activity names to reload. If omitted, reloads all.\n *\n * @example\n * ```typescript\n * // Preload new image\n * await preloadImages([{ url: 'https://example.com/new-art.jpg', key: 'album-art' }])\n *\n * // Reload specific activity to pick up the new image\n * await reloadLiveActivities(['music-player'])\n *\n * // Or reload all activities\n * await reloadLiveActivities()\n * ```\n */\nexport async function reloadLiveActivities(activityNames?: string[]): Promise<void> {\n  if (!assertIOS('reloadLiveActivities')) return\n\n  try {\n    await (VoltraModule as any).reloadLiveActivities(activityNames ?? null)\n  } catch (error) {\n    console.error('Failed to reload Live Activities:', error)\n  }\n}\n\n/**\n * Clear preloaded images from App Group storage.\n *\n * @param keys - Optional array of image keys to clear. If omitted, clears all preloaded images.\n *\n * @example\n * ```typescript\n * // Clear specific images\n * await clearPreloadedImages(['album-art', 'profile-pic'])\n *\n * // Clear all preloaded images\n * await clearPreloadedImages()\n * ```\n */\nexport async function clearPreloadedImages(keys?: string[]): Promise<void> {\n  if (!assertIOS('clearPreloadedImages')) return\n\n  try {\n    await (VoltraModule as any).clearPreloadedImages(keys ?? null)\n  } catch (error) {\n    console.error('Failed to clear preloaded images:', error)\n  }\n}\n"]}

package/build/types.d.ts

@@ -14,4 +14,62 @@ export type VoltraElementRef = {
     $r: number;
 };
 export type VoltraNodeJson = VoltraElementJson | VoltraElementJson[] | VoltraElementRef | string;
+/**
+ * Event subscription interface
+ */
+export type EventSubscription = {
+    remove: () => void;
+};
+/**
+ * Options for preloading a single image
+ */
+export type PreloadImageOptions = {
+    /**
+     * The URL to download the image from
+     */
+    url: string;
+    /**
+     * The key to use when referencing this image (used as assetName in Image component)
+     */
+    key: string;
+    /**
+     * HTTP method to use. Defaults to 'GET'.
+     */
+    method?: 'GET' | 'POST' | 'PUT';
+    /**
+     * Optional HTTP headers to include in the request
+     */
+    headers?: Record<string, string>;
+};
+/**
+ * Result of a failed image preload
+ */
+export type PreloadImageFailure = {
+    key: string;
+    error: string;
+};
+/**
+ * Result of preloading images
+ */
+export type PreloadImagesResult = {
+    /**
+     * Keys of images that were successfully preloaded
+     */
+    succeeded: string[];
+    /**
+     * Images that failed to preload, with error messages
+     */
+    failed: PreloadImageFailure[];
+};
+/**
+ * Options for updating a home screen widget
+ */
+export type UpdateWidgetOptions = {
+    /**
+     * URL to open when the widget is tapped.
+     * Can be a full URL (e.g., "myapp://screen/details")
+     * or a path that will be prefixed with your app's URL scheme.
+     */
+    deepLinkUrl?: string;
+};
 //# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,cAAc,CAAA;AAE/E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,CAAC,CAAC,EAAE,cAAc,CAAA;IAClB,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CACpC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAA;CACX,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG,iBAAiB,EAAE,GAAG,gBAAgB,GAAG,MAAM,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,cAAc,CAAA;AAE/E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,CAAC,CAAC,EAAE,cAAc,CAAA;IAClB,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CACpC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAA;CACX,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG,iBAAiB,EAAE,GAAG,gBAAgB,GAAG,MAAM,CAAA;AAEhG;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IACX;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IACX;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;IAC/B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB;;OAEG;IACH,MAAM,EAAE,mBAAmB,EAAE,CAAA;CAC9B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA"}

package/build/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["export type VoltraPropValue = string | number | boolean | null | VoltraNodeJson // Allow component trees in props\n\nexport type VoltraElementJson = {\n  t: number\n  i?: string\n  c?: VoltraNodeJson\n  p?: Record<string, VoltraPropValue>\n}\n\n/**\n * Reference to a shared element by index.\n * Used for element deduplication - when the same JSX element (by reference)\n * appears multiple times in the tree.\n */\nexport type VoltraElementRef = {\n  $r: number\n}\n\nexport type VoltraNodeJson = VoltraElementJson | VoltraElementJson[] | VoltraElementRef | string\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["export type VoltraPropValue = string | number | boolean | null | VoltraNodeJson // Allow component trees in props\n\nexport type VoltraElementJson = {\n  t: number\n  i?: string\n  c?: VoltraNodeJson\n  p?: Record<string, VoltraPropValue>\n}\n\n/**\n * Reference to a shared element by index.\n * Used for element deduplication - when the same JSX element (by reference)\n * appears multiple times in the tree.\n */\nexport type VoltraElementRef = {\n  $r: number\n}\n\nexport type VoltraNodeJson = VoltraElementJson | VoltraElementJson[] | VoltraElementRef | string\n\n/**\n * Event subscription interface\n */\nexport type EventSubscription = {\n  remove: () => void\n}\n\n/**\n * Options for preloading a single image\n */\nexport type PreloadImageOptions = {\n  /**\n   * The URL to download the image from\n   */\n  url: string\n  /**\n   * The key to use when referencing this image (used as assetName in Image component)\n   */\n  key: string\n  /**\n   * HTTP method to use. Defaults to 'GET'.\n   */\n  method?: 'GET' | 'POST' | 'PUT'\n  /**\n   * Optional HTTP headers to include in the request\n   */\n  headers?: Record<string, string>\n}\n\n/**\n * Result of a failed image preload\n */\nexport type PreloadImageFailure = {\n  key: string\n  error: string\n}\n\n/**\n * Result of preloading images\n */\nexport type PreloadImagesResult = {\n  /**\n   * Keys of images that were successfully preloaded\n   */\n  succeeded: string[]\n  /**\n   * Images that failed to preload, with error messages\n   */\n  failed: PreloadImageFailure[]\n}\n\n/**\n * Options for updating a home screen widget\n */\nexport type UpdateWidgetOptions = {\n  /**\n   * URL to open when the widget is tapped.\n   * Can be a full URL (e.g., \"myapp://screen/details\")\n   * or a path that will be prefixed with your app's URL scheme.\n   */\n  deepLinkUrl?: string\n}\n"]}

package/build/widgets/widget-api.d.ts

@@ -1,15 +1,6 @@
+import type { UpdateWidgetOptions } from '../types.js';
 import { WidgetVariants } from './types.js';
-/**
- * Options for updating a home screen widget
- */
-export type UpdateWidgetOptions = {
-    /**
-     * URL to open when the widget is tapped.
-     * Can be a full URL (e.g., "myapp://screen/details")
-     * or a path that will be prefixed with your app's URL scheme.
-     */
-    deepLinkUrl?: string;
-};
+export type { UpdateWidgetOptions } from '../types.js';
 /**
  * Update a home screen widget with new content.
  *

package/build/widgets/widget-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widget-api.d.ts","sourceRoot":"","sources":["../../src/widgets/widget-api.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,EAChB,UAAU,cAAc,EACxB,UAAU,mBAAmB,KAC5B,OAAO,CAAC,IAAI,CAQd,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa,GAAU,YAAY,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAItE,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,IAAI,CAIhE,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,QAAa,OAAO,CAAC,IAAI,CAIpD,CAAA"}
+{"version":3,"file":"widget-api.d.ts","sourceRoot":"","sources":["../../src/widgets/widget-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAItD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG3C,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,EAChB,UAAU,cAAc,EACxB,UAAU,mBAAmB,KAC5B,OAAO,CAAC,IAAI,CAQd,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa,GAAU,YAAY,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAItE,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,IAAI,CAIhE,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,QAAa,OAAO,CAAC,IAAI,CAIpD,CAAA"}

package/build/widgets/widget-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"widget-api.js","sourceRoot":"","sources":["../../src/widgets/widget-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AACvE,OAAO,YAAY,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAepD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,QAAgB,EAChB,QAAwB,EACxB,OAA6B,EACd,EAAE;IACjB,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAErD,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAA;IAE9C,OAAO,YAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE;QAClD,WAAW,EAAE,OAAO,EAAE,WAAW;KAClC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,SAAoB,EAAiB,EAAE;IACzE,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAErD,OAAO,YAAY,CAAC,aAAa,CAAC,SAAS,IAAI,IAAI,CAAC,CAAA;AACtD,CAAC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,QAAgB,EAAiB,EAAE;IACnE,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAErD,OAAO,YAAY,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;AAC3C,CAAC,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,IAAmB,EAAE;IACvD,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAErD,OAAO,YAAY,CAAC,eAAe,EAAE,CAAA;AACvC,CAAC,CAAA","sourcesContent":["import { assertRunningOnApple } from '../utils/assertRunningOnApple.js'\nimport VoltraModule from '../VoltraModule.js'\nimport { renderWidgetToString } from './renderer.js'\nimport { WidgetVariants } from './types.js'\n\n/**\n * Options for updating a home screen widget\n */\nexport type UpdateWidgetOptions = {\n  /**\n   * URL to open when the widget is tapped.\n   * Can be a full URL (e.g., \"myapp://screen/details\")\n   * or a path that will be prefixed with your app's URL scheme.\n   */\n  deepLinkUrl?: string\n}\n\n/**\n * Update a home screen widget with new content.\n *\n * The content will be stored in App Group storage and the widget timeline\n * will be reloaded to display the new content.\n *\n * @param widgetId - The widget identifier (as defined in your config plugin)\n * @param variants - An object mapping widget families to specific content.\n *   Each key corresponds to a widget size family.\n * @param options - Optional settings like deep link URL\n *\n * @example Different content per size\n * ```tsx\n * import { updateWidget, Voltra } from 'voltra'\n *\n * await updateWidget('weather', {\n *   systemSmall: <Voltra.Text fontSize={32}>72°F</Voltra.Text>,\n *   systemMedium: (\n *     <Voltra.HStack>\n *       <Voltra.Text fontSize={32}>72°F</Voltra.Text>\n *       <Voltra.VStack>\n *         <Voltra.Text>Sunny</Voltra.Text>\n *         <Voltra.Text>High: 78° Low: 65°</Voltra.Text>\n *       </Voltra.VStack>\n *     </Voltra.HStack>\n *   ),\n * }, { deepLinkUrl: '/weather' })\n * ```\n */\nexport const updateWidget = async (\n  widgetId: string,\n  variants: WidgetVariants,\n  options?: UpdateWidgetOptions\n): Promise<void> => {\n  if (!assertRunningOnApple()) return Promise.resolve()\n\n  const payload = renderWidgetToString(variants)\n\n  return VoltraModule.updateWidget(widgetId, payload, {\n    deepLinkUrl: options?.deepLinkUrl,\n  })\n}\n\n/**\n * Reload widget timelines to refresh their content.\n *\n * Use this after updating data that widgets depend on (e.g., after preloading\n * new images) to force them to re-render.\n *\n * @param widgetIds - Optional array of widget IDs to reload. If omitted, reloads all widgets.\n *\n * @example\n * ```typescript\n * // Reload specific widgets\n * await reloadWidgets(['weather', 'calendar'])\n *\n * // Reload all widgets\n * await reloadWidgets()\n * ```\n */\nexport const reloadWidgets = async (widgetIds?: string[]): Promise<void> => {\n  if (!assertRunningOnApple()) return Promise.resolve()\n\n  return VoltraModule.reloadWidgets(widgetIds ?? null)\n}\n\n/**\n * Clear a widget's stored data.\n *\n * This removes the JSON content and deep link URL for the specified widget,\n * causing it to show its placeholder state.\n *\n * @param widgetId - The widget identifier to clear\n *\n * @example\n * ```typescript\n * await clearWidget('weather')\n * ```\n */\nexport const clearWidget = async (widgetId: string): Promise<void> => {\n  if (!assertRunningOnApple()) return Promise.resolve()\n\n  return VoltraModule.clearWidget(widgetId)\n}\n\n/**\n * Clear all widgets' stored data.\n *\n * This removes the JSON content and deep link URLs for all configured widgets,\n * causing them to show their placeholder states.\n *\n * @example\n * ```typescript\n * await clearAllWidgets()\n * ```\n */\nexport const clearAllWidgets = async (): Promise<void> => {\n  if (!assertRunningOnApple()) return Promise.resolve()\n\n  return VoltraModule.clearAllWidgets()\n}\n"]}
+{"version":3,"file":"widget-api.js","sourceRoot":"","sources":["../../src/widgets/widget-api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AACvE,OAAO,YAAY,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAMpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,QAAgB,EAChB,QAAwB,EACxB,OAA6B,EACd,EAAE;IACjB,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAErD,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAA;IAE9C,OAAO,YAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE;QAClD,WAAW,EAAE,OAAO,EAAE,WAAW;KAClC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,SAAoB,EAAiB,EAAE;IACzE,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAErD,OAAO,YAAY,CAAC,aAAa,CAAC,SAAS,IAAI,IAAI,CAAC,CAAA;AACtD,CAAC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,QAAgB,EAAiB,EAAE;IACnE,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAErD,OAAO,YAAY,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;AAC3C,CAAC,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,IAAmB,EAAE;IACvD,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAErD,OAAO,YAAY,CAAC,eAAe,EAAE,CAAA;AACvC,CAAC,CAAA","sourcesContent":["import type { UpdateWidgetOptions } from '../types.js'\nimport { assertRunningOnApple } from '../utils/assertRunningOnApple.js'\nimport VoltraModule from '../VoltraModule.js'\nimport { renderWidgetToString } from './renderer.js'\nimport { WidgetVariants } from './types.js'\n\n// Re-export type for public API\nexport type { UpdateWidgetOptions } from '../types.js'\n\n/**\n * Update a home screen widget with new content.\n *\n * The content will be stored in App Group storage and the widget timeline\n * will be reloaded to display the new content.\n *\n * @param widgetId - The widget identifier (as defined in your config plugin)\n * @param variants - An object mapping widget families to specific content.\n *   Each key corresponds to a widget size family.\n * @param options - Optional settings like deep link URL\n *\n * @example Different content per size\n * ```tsx\n * import { updateWidget, Voltra } from 'voltra'\n *\n * await updateWidget('weather', {\n *   systemSmall: <Voltra.Text fontSize={32}>72°F</Voltra.Text>,\n *   systemMedium: (\n *     <Voltra.HStack>\n *       <Voltra.Text fontSize={32}>72°F</Voltra.Text>\n *       <Voltra.VStack>\n *         <Voltra.Text>Sunny</Voltra.Text>\n *         <Voltra.Text>High: 78° Low: 65°</Voltra.Text>\n *       </Voltra.VStack>\n *     </Voltra.HStack>\n *   ),\n * }, { deepLinkUrl: '/weather' })\n * ```\n */\nexport const updateWidget = async (\n  widgetId: string,\n  variants: WidgetVariants,\n  options?: UpdateWidgetOptions\n): Promise<void> => {\n  if (!assertRunningOnApple()) return Promise.resolve()\n\n  const payload = renderWidgetToString(variants)\n\n  return VoltraModule.updateWidget(widgetId, payload, {\n    deepLinkUrl: options?.deepLinkUrl,\n  })\n}\n\n/**\n * Reload widget timelines to refresh their content.\n *\n * Use this after updating data that widgets depend on (e.g., after preloading\n * new images) to force them to re-render.\n *\n * @param widgetIds - Optional array of widget IDs to reload. If omitted, reloads all widgets.\n *\n * @example\n * ```typescript\n * // Reload specific widgets\n * await reloadWidgets(['weather', 'calendar'])\n *\n * // Reload all widgets\n * await reloadWidgets()\n * ```\n */\nexport const reloadWidgets = async (widgetIds?: string[]): Promise<void> => {\n  if (!assertRunningOnApple()) return Promise.resolve()\n\n  return VoltraModule.reloadWidgets(widgetIds ?? null)\n}\n\n/**\n * Clear a widget's stored data.\n *\n * This removes the JSON content and deep link URL for the specified widget,\n * causing it to show its placeholder state.\n *\n * @param widgetId - The widget identifier to clear\n *\n * @example\n * ```typescript\n * await clearWidget('weather')\n * ```\n */\nexport const clearWidget = async (widgetId: string): Promise<void> => {\n  if (!assertRunningOnApple()) return Promise.resolve()\n\n  return VoltraModule.clearWidget(widgetId)\n}\n\n/**\n * Clear all widgets' stored data.\n *\n * This removes the JSON content and deep link URLs for all configured widgets,\n * causing them to show their placeholder states.\n *\n * @example\n * ```typescript\n * await clearAllWidgets()\n * ```\n */\nexport const clearAllWidgets = async (): Promise<void> => {\n  if (!assertRunningOnApple()) return Promise.resolve()\n\n  return VoltraModule.clearAllWidgets()\n}\n"]}

package/ios/Voltra.podspec

@@ -22,26 +22,11 @@ Pod::Spec.new do |s|
     'DEFINES_MODULE' => 'YES',
   }
 
-  # Default subspec: main app module (auto-linked by Expo)
-  s.default_subspecs = 'Core'
+  s.dependency 'ExpoModulesCore'
 
-  # Core subspec: React Native bridge module
-  s.subspec 'Core' do |ss|
-    ss.dependency 'ExpoModulesCore'
-
-    ss.source_files = [
-      "app/**/*.swift",
-      "shared/**/*.swift",
-      "ui/**/*.swift",  # Add shared UI code
-    ]
-  end
-
-  # Widget subspec: Widget extension code
-  s.subspec 'Widget' do |ss|
-    ss.source_files = [
-      "shared/**/*.swift",
-      "ui/**/*.swift",     # Add shared UI code
-      "target/**/*.swift", # Widget-specific files only
-    ]
-  end
+  s.source_files = [
+    "app/**/*.swift",
+    "ui/**/*.swift",
+    "shared/**/*.swift",
+  ]
 end

package/ios/VoltraWidget.podspec

@@ -0,0 +1,30 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name           = 'VoltraWidget'
+  s.version        = package['version']
+  s.summary        = package['description']
+  s.description    = 'Voltra Widget Extension support.'
+  s.license        = package['license']
+  s.author         = package['author']
+  s.homepage       = package['homepage']
+  s.platforms      = {
+    :ios => '16.2',
+  }
+  s.swift_version  = '5.9'
+  s.source         = { git: 'https://github.com/callstackincubator/voltra' }
+  s.static_framework = true
+
+  # Swift/Objective-C compatibility
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+  }
+
+  s.source_files = [
+    "ui/**/*.swift",
+    "shared/**/*.swift",
+    "target/**/*.swift",
+  ]
+end

package/ios/shared/Data+hexString.swift

@@ -6,5 +6,3 @@ extension Data {
     map { String(format: "%02x", $0) }.joined()
   }
 }
-
-

package/ios/ui/Style/StyleConverter.swift

@@ -1,6 +1,5 @@
 import SwiftUI
 
-// TODO: Refactor to NOT overwrite defaults.
 enum StyleConverter {
   static func convert(_ js: [String: Any]) -> (LayoutStyle, DecorationStyle, RenderingStyle, TextStyle) {
     (parseLayout(js), parseDecoration(js), parseRendering(js), parseText(js))
@@ -12,9 +11,9 @@ enum StyleConverter {
     let flexGrow = JSStyleParser.number(js["flexGrow"]) ?? 0
     let finalFlex = max(flexVal, flexGrow)
 
-    // If it flexes, give it priority 1 so it beats fixed items (default 0).
-    // Do NOT use the raw value (e.g. 2.0), or it will eat other flex items.
-    let priority: Double = finalFlex > 0 ? 1.0 : 0.0
+    // If it flexes, give it priority 1 so it beats fixed items.
+    // Only set layoutPriority when flex is active; nil means "don't apply modifier".
+    let priority: Double? = finalFlex > 0 ? 1.0 : nil
 
     // Position parsing (offsetX/offsetY -> CGPoint)
     var position: CGPoint?
@@ -26,8 +25,8 @@ enum StyleConverter {
       position = CGPoint(x: 0, y: offsetY)
     }
 
-    // zIndex parsing
-    let zIndex = JSStyleParser.number(js["zIndex"]) ?? 0.0
+    // zIndex: only set if explicitly provided in JS
+    let zIndex = JSStyleParser.number(js["zIndex"])
 
     return LayoutStyle(
       // Dimensions
@@ -49,7 +48,7 @@ enum StyleConverter {
 
       // Positioning
       position: position,
-      zIndex: zIndex
+      zIndex: zIndex.map { Double($0) }
     )
   }
 

package/package.json

@@ -1,17 +1,9 @@
 {
   "name": "voltra",
-  "version": "1.0.0-rc.1",
+  "version": "1.0.0",
   "description": "Build Live Activities with JSX in React Native",
   "main": "build/index.js",
   "types": "build/index.d.ts",
-  "files": [
-    "build",
-    "plugin/build",
-    "app.plugin.js",
-    "expo-module.config.json",
-    "ios-files",
-    "ios"
-  ],
   "exports": {
     ".": {
       "types": "./build/index.d.ts",

package/plugin/build/features/ios/files/swift/widgetBundle.js

@@ -57,7 +57,7 @@ function generateWidgetBundleSwift(widgets) {
 
     import SwiftUI
     import WidgetKit
-    import Voltra
+    import VoltraWidget
 
     @main
     struct VoltraWidgetBundle: WidgetBundle {
@@ -90,7 +90,7 @@ function generateDefaultWidgetBundleSwift() {
 
     import SwiftUI
     import WidgetKit
-    import Voltra  // Import Voltra widgets
+    import VoltraWidget  // Import Voltra widgets
 
     @main
     struct VoltraWidgetBundle: WidgetBundle {

package/plugin/build/features/ios/podfile/index.js

@@ -26,7 +26,7 @@ target '${targetName}' do
   voltra_module = JSON.parse(${backtick}npx expo-modules-autolinking search -p apple --json --project-root #{project_root}${backtick})
   podspec_dir_path = Pathname.new(File.join(voltra_module['${libraryName}']['path'], 'ios')).relative_path_from(Pathname.new(__dir__)).to_path
   
-  pod 'Voltra/Widget', :path => podspec_dir_path
+  pod 'VoltraWidget', :path => podspec_dir_path
 end`;
 }
 /**