@use-voltra/android 1.3.0

package/build/esm/live-update/api.js

@@ -0,0 +1,203 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { useUpdateOnHMR } from '../utils/index.js';
+import VoltraModule from '../VoltraModule.js';
+import { renderAndroidLiveUpdateToString } from './renderer.js';
+/**
+ * @unstable This API is experimental and may change in future versions.
+ *
+ * React hook for managing Android Live Updates with automatic lifecycle handling.
+ *
+ * @param variants - The Android Live Update content variants to display
+ * @param options - Configuration options for the hook
+ * @returns Object with start, update, end methods and isActive state
+ *
+ * @example
+ * ```tsx
+ * import { VoltraAndroid, useAndroidLiveUpdate } from 'voltra'
+ *
+ * const MyLiveUpdate = () => {
+ *   const { start, update, end, isActive } = useAndroidLiveUpdate({
+ *     collapsed: <VoltraAndroid.Text>Delivery arriving</VoltraAndroid.Text>,
+ *     expanded: <VoltraAndroid.Column>...</VoltraAndroid.Column>,
+ *     channelId: 'delivery_updates',
+ *   }, {
+ *     updateName: 'my-live-update',
+ *     autoStart: true,
+ *     autoUpdate: true
+ *   })
+ *
+ *   return (
+ *     <View>
+ *       <Button title={isActive ? "Stop" : "Start"} onPress={isActive ? end : start} />
+ *     </View>
+ *   )
+ * }
+ * ```
+ */
+export const useAndroidLiveUpdate = (variants, options) => {
+    const [targetId, setTargetId] = useState(() => {
+        if (options?.updateName) {
+            return isAndroidLiveUpdateActive(options.updateName) ? options.updateName : null;
+        }
+        return null;
+    });
+    const isActive = targetId !== null;
+    const optionsRef = useRef(options);
+    const variantsRef = useRef(variants);
+    const lastUpdateOptionsRef = useRef(undefined);
+    // Update refs when values change
+    useEffect(() => {
+        optionsRef.current = options;
+    }, [options]);
+    useEffect(() => {
+        variantsRef.current = variants;
+    }, [variants]);
+    useUpdateOnHMR();
+    const start = useCallback(async (options) => {
+        const id = await startAndroidLiveUpdate(variantsRef.current, {
+            ...optionsRef.current,
+            ...options,
+        });
+        setTargetId(id);
+    }, []);
+    const update = useCallback(async (options) => {
+        if (!targetId) {
+            return;
+        }
+        const updateOptions = { ...optionsRef.current, ...options };
+        lastUpdateOptionsRef.current = updateOptions;
+        await updateAndroidLiveUpdate(targetId, variantsRef.current, updateOptions);
+    }, [targetId]);
+    const end = useCallback(async () => {
+        if (!targetId) {
+            return;
+        }
+        await stopAndroidLiveUpdate(targetId);
+        setTargetId(null);
+    }, [targetId]);
+    useEffect(() => {
+        if (!options?.autoStart) {
+            return;
+        }
+        start();
+    }, [options?.autoStart, start]);
+    useEffect(() => {
+        if (!options?.autoUpdate)
+            return;
+        update(lastUpdateOptionsRef.current);
+    }, [options?.autoUpdate, update, variants]);
+    return {
+        start,
+        update,
+        end,
+        isActive,
+    };
+};
+/**
+ * @unstable This API is experimental and may change in future versions.
+ *
+ * Start a new Android Live Update with the provided content variants.
+ *
+ * @param variants - The Android Live Update content variants to display
+ * @param options - Configuration options for the Live Update
+ * @returns Promise resolving to the notification ID
+ *
+ * @example
+ * ```tsx
+ * import { VoltraAndroid, startAndroidLiveUpdate } from 'voltra'
+ *
+ * const notificationId = await startAndroidLiveUpdate({
+ *   collapsed: <VoltraAndroid.Text>Delivery arriving</VoltraAndroid.Text>,
+ *   expanded: <VoltraAndroid.Column>...</VoltraAndroid.Column>,
+ *   channelId: 'delivery_updates',
+ * }, {
+ *   updateName: 'my-live-update',
+ * })
+ * ```
+ */
+export const startAndroidLiveUpdate = async (variants, options) => {
+    const payload = renderAndroidLiveUpdateToString(variants);
+    const notificationId = await VoltraModule.startAndroidLiveUpdate(payload, {
+        updateName: options?.updateName,
+        channelId: options?.channelId || variants.channelId || 'voltra_live_updates',
+    });
+    return notificationId;
+};
+/**
+ * @unstable This API is experimental and may change in future versions.
+ *
+ * Update an existing Android Live Update with new content.
+ *
+ * @param notificationId - The ID of the notification to update
+ * @param variants - The new Android Live Update content variants
+ * @param options - Update options
+ *
+ * @example
+ * ```tsx
+ * import { VoltraAndroid, updateAndroidLiveUpdate } from 'voltra'
+ *
+ * await updateAndroidLiveUpdate('notification-123', {
+ *   collapsed: <VoltraAndroid.Text>Updated: Delivery arriving</VoltraAndroid.Text>,
+ *   expanded: <VoltraAndroid.Column>...</VoltraAndroid.Column>,
+ * })
+ * ```
+ */
+export const updateAndroidLiveUpdate = async (notificationId, variants, options) => {
+    const payload = renderAndroidLiveUpdateToString(variants);
+    return VoltraModule.updateAndroidLiveUpdate(notificationId, payload);
+};
+/**
+ * @unstable This API is experimental and may change in future versions.
+ *
+ * Stop an Android Live Update and dismiss the notification.
+ *
+ * @param notificationId - The ID of the notification to stop
+ *
+ * @example
+ * ```tsx
+ * import { stopAndroidLiveUpdate } from 'voltra'
+ *
+ * await stopAndroidLiveUpdate('notification-123')
+ * ```
+ */
+export const stopAndroidLiveUpdate = async (notificationId) => {
+    return VoltraModule.stopAndroidLiveUpdate(notificationId);
+};
+/**
+ * @unstable This API is experimental and may change in future versions.
+ *
+ * Check if an Android Live Update with the given name is currently active.
+ *
+ * @param updateName - The name of the Live Update to check
+ * @returns true if the update is active, false otherwise
+ *
+ * @example
+ * ```tsx
+ * import { isAndroidLiveUpdateActive } from 'voltra'
+ *
+ * if (isAndroidLiveUpdateActive('my-live-update')) {
+ *   console.log('Update is running')
+ * }
+ * ```
+ */
+export const isAndroidLiveUpdateActive = (updateName) => {
+    return VoltraModule.isAndroidLiveUpdateActive(updateName);
+};
+/**
+ * @unstable This API is experimental and may change in future versions.
+ *
+ * End all active Android Live Updates.
+ *
+ * This function stops and dismisses all currently running Live Updates in the app.
+ *
+ * @example
+ * ```tsx
+ * import { endAllAndroidLiveUpdates } from 'voltra'
+ *
+ * await endAllAndroidLiveUpdates()
+ * ```
+ */
+export async function endAllAndroidLiveUpdates() {
+    return VoltraModule.endAllAndroidLiveUpdates();
+}
+//# sourceMappingURL=api.js.map

package/build/esm/live-update/api.js.map

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

package/build/esm/live-update/renderer.js

@@ -0,0 +1,41 @@
+import { getAndroidComponentId } from '../payload/component-ids.js';
+import { createVoltraRenderer } from '../renderer/index.js';
+/**
+ * Android component registry that uses Android component ID mappings
+ */
+const androidComponentRegistry = {
+    getComponentId: (name) => getAndroidComponentId(name),
+};
+/**
+ * Renders Android Live Update variants to JSON.
+ * Uses the Android component registry for component ID lookups.
+ */
+export const renderAndroidLiveUpdateToJson = (variants) => {
+    // Create renderer with Android component registry
+    const renderer = createVoltraRenderer(androidComponentRegistry);
+    // Add collapsed notification content
+    if (variants.collapsed) {
+        renderer.addRootNode('collapsed', variants.collapsed);
+    }
+    // Add expanded notification content
+    if (variants.expanded) {
+        renderer.addRootNode('expanded', variants.expanded);
+    }
+    // Render to JSON
+    const result = renderer.render();
+    // Add non-JSX properties
+    if (variants.smallIcon) {
+        result.smallIcon = variants.smallIcon;
+    }
+    if (variants.channelId) {
+        result.channelId = variants.channelId;
+    }
+    return result;
+};
+/**
+ * Renders Android Live Update variants to a JSON string.
+ */
+export const renderAndroidLiveUpdateToString = (variants) => {
+    return JSON.stringify(renderAndroidLiveUpdateToJson(variants));
+};
+//# sourceMappingURL=renderer.js.map

package/build/esm/live-update/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../../src/live-update/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AAEnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAG3D;;GAEG;AACH,MAAM,wBAAwB,GAAsB;IAClD,cAAc,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC;CAC9D,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,QAAmC,EAAyB,EAAE;IAC1G,kDAAkD;IAClD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,wBAAwB,CAAC,CAAA;IAE/D,qCAAqC;IACrC,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAA;IACvD,CAAC;IAED,oCAAoC;IACpC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACtB,QAAQ,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACrD,CAAC;IAED,iBAAiB;IACjB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAA2B,CAAA;IAEzD,yBAAyB;IACzB,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,MAAM,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAA;IACvC,CAAC;IAED,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,MAAM,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAA;IACvC,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,QAAmC,EAAU,EAAE;IAC7F,OAAO,IAAI,CAAC,SAAS,CAAC,6BAA6B,CAAC,QAAQ,CAAC,CAAC,CAAA;AAChE,CAAC,CAAA"}

package/build/esm/live-update/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/esm/live-update/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/live-update/types.ts"],"names":[],"mappings":""}

package/build/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/build/esm/payload/component-ids.js

@@ -0,0 +1,79 @@
+// 🤖 AUTO-GENERATED from data/components.json
+// DO NOT EDIT MANUALLY - Changes will be overwritten
+// Schema version: 1.0.0
+/**
+ * Mapping from Android component name to numeric ID
+ * Component IDs are assigned sequentially based on order in components.json (0-indexed)
+ */
+export const ANDROID_COMPONENT_NAME_TO_ID = {
+    AndroidFilledButton: 0,
+    AndroidImage: 1,
+    AndroidSwitch: 2,
+    AndroidCheckBox: 3,
+    AndroidRadioButton: 4,
+    AndroidBox: 5,
+    AndroidButton: 6,
+    AndroidCircleIconButton: 7,
+    AndroidCircularProgressIndicator: 8,
+    AndroidColumn: 9,
+    AndroidLazyColumn: 10,
+    AndroidLazyVerticalGrid: 11,
+    AndroidLinearProgressIndicator: 12,
+    AndroidOutlineButton: 13,
+    AndroidRow: 14,
+    AndroidScaffold: 15,
+    AndroidSpacer: 16,
+    AndroidSquareIconButton: 17,
+    AndroidText: 18,
+    AndroidTitleBar: 19,
+    AndroidChart: 20,
+};
+/**
+ * Mapping from numeric ID to Android component name
+ */
+export const ANDROID_COMPONENT_ID_TO_NAME = {
+    0: 'AndroidFilledButton',
+    1: 'AndroidImage',
+    2: 'AndroidSwitch',
+    3: 'AndroidCheckBox',
+    4: 'AndroidRadioButton',
+    5: 'AndroidBox',
+    6: 'AndroidButton',
+    7: 'AndroidCircleIconButton',
+    8: 'AndroidCircularProgressIndicator',
+    9: 'AndroidColumn',
+    10: 'AndroidLazyColumn',
+    11: 'AndroidLazyVerticalGrid',
+    12: 'AndroidLinearProgressIndicator',
+    13: 'AndroidOutlineButton',
+    14: 'AndroidRow',
+    15: 'AndroidScaffold',
+    16: 'AndroidSpacer',
+    17: 'AndroidSquareIconButton',
+    18: 'AndroidText',
+    19: 'AndroidTitleBar',
+    20: 'AndroidChart',
+};
+/**
+ * Get Android component ID from name
+ * @throws Error if component name is not found
+ */
+export function getAndroidComponentId(name) {
+    const id = ANDROID_COMPONENT_NAME_TO_ID[name];
+    if (id === undefined) {
+        throw new Error(`Unknown Android component name: "${name}". Available components: ${Object.keys(ANDROID_COMPONENT_NAME_TO_ID).join(', ')}`);
+    }
+    return id;
+}
+/**
+ * Get Android component name from ID
+ * @throws Error if component ID is not found
+ */
+export function getAndroidComponentName(id) {
+    const name = ANDROID_COMPONENT_ID_TO_NAME[id];
+    if (name === undefined) {
+        throw new Error(`Unknown Android component ID: ${id}. Valid IDs: 0-${Object.keys(ANDROID_COMPONENT_ID_TO_NAME).length - 1}`);
+    }
+    return name;
+}
+//# sourceMappingURL=component-ids.js.map

package/build/esm/payload/component-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-ids.js","sourceRoot":"","sources":["../../../src/payload/component-ids.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,qDAAqD;AACrD,wBAAwB;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA2B;IAClE,mBAAmB,EAAE,CAAC;IACtB,YAAY,EAAE,CAAC;IACf,aAAa,EAAE,CAAC;IAChB,eAAe,EAAE,CAAC;IAClB,kBAAkB,EAAE,CAAC;IACrB,UAAU,EAAE,CAAC;IACb,aAAa,EAAE,CAAC;IAChB,uBAAuB,EAAE,CAAC;IAC1B,gCAAgC,EAAE,CAAC;IACnC,aAAa,EAAE,CAAC;IAChB,iBAAiB,EAAE,EAAE;IACrB,uBAAuB,EAAE,EAAE;IAC3B,8BAA8B,EAAE,EAAE;IAClC,oBAAoB,EAAE,EAAE;IACxB,UAAU,EAAE,EAAE;IACd,eAAe,EAAE,EAAE;IACnB,aAAa,EAAE,EAAE;IACjB,uBAAuB,EAAE,EAAE;IAC3B,WAAW,EAAE,EAAE;IACf,eAAe,EAAE,EAAE;IACnB,YAAY,EAAE,EAAE;CACjB,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA2B;IAClE,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,cAAc;IACjB,CAAC,EAAE,eAAe;IAClB,CAAC,EAAE,iBAAiB;IACpB,CAAC,EAAE,oBAAoB;IACvB,CAAC,EAAE,YAAY;IACf,CAAC,EAAE,eAAe;IAClB,CAAC,EAAE,yBAAyB;IAC5B,CAAC,EAAE,kCAAkC;IACrC,CAAC,EAAE,eAAe;IAClB,EAAE,EAAE,mBAAmB;IACvB,EAAE,EAAE,yBAAyB;IAC7B,EAAE,EAAE,gCAAgC;IACpC,EAAE,EAAE,sBAAsB;IAC1B,EAAE,EAAE,YAAY;IAChB,EAAE,EAAE,iBAAiB;IACrB,EAAE,EAAE,eAAe;IACnB,EAAE,EAAE,yBAAyB;IAC7B,EAAE,EAAE,aAAa;IACjB,EAAE,EAAE,iBAAiB;IACrB,EAAE,EAAE,cAAc;CACnB,CAAA;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,EAAE,GAAG,4BAA4B,CAAC,IAAI,CAAC,CAAA;IAC7C,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,oCAAoC,IAAI,4BAA4B,MAAM,CAAC,IAAI,CAC7E,4BAA4B,CAC7B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACf,CAAA;IACH,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,EAAU;IAChD,MAAM,IAAI,GAAG,4BAA4B,CAAC,EAAE,CAAC,CAAA;IAC7C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,iCAAiC,EAAE,kBAAkB,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAC5G,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/build/esm/preload.js

@@ -0,0 +1,72 @@
+import VoltraModule from './VoltraModule.js';
+/**
+ * Preload images to Android cache for use in Widgets.
+ *
+ * Downloaded images are stored in the app's cache directory and exposed via FileProvider.
+ * Images can then be referenced using the `assetName` property in the Image component.
+ *
+ * @param images - Array of images to preload
+ * @returns Result indicating which images succeeded or failed
+ *
+ * @example
+ * ```typescript
+ * const result = await preloadImages([
+ *   {
+ *     url: 'https://example.com/album-art.jpg',
+ *     key: 'current-album',
+ *     headers: { 'Authorization': 'Bearer token' }
+ *   }
+ * ])
+ *
+ * // Use in Android Widget
+ * <VoltraAndroid.Image source={{ assetName: 'current-album' }} />
+ * ```
+ */
+export async function preloadImages(images) {
+    try {
+        return await VoltraModule.preloadImages(images);
+    }
+    catch (error) {
+        return {
+            succeeded: [],
+            failed: images.map((img) => ({
+                key: img.key,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            })),
+        };
+    }
+}
+/**
+ * Clear preloaded images from Android cache.
+ *
+ * @param keys - Optional array of image keys to clear. If omitted, clears all preloaded images.
+ *
+ * @example
+ * ```typescript
+ * // Clear specific images
+ * await clearPreloadedImages(['album-art', 'profile-pic'])
+ *
+ * // Clear all preloaded images
+ * await clearPreloadedImages()
+ * ```
+ */
+export async function clearPreloadedImages(keys) {
+    try {
+        await VoltraModule.clearPreloadedImages(keys ?? null);
+    }
+    catch (error) {
+        console.error('Failed to clear preloaded images:', error);
+    }
+}
+/**
+ * Reload Android Widgets. (Alias for reloadAndroidWidgets)
+ */
+export async function reloadWidgets(widgetIds) {
+    try {
+        await VoltraModule.reloadAndroidWidgets(widgetIds ?? null);
+    }
+    catch (error) {
+        console.error('Failed to reload Android widgets:', error);
+    }
+}
+//# sourceMappingURL=preload.js.map

package/build/esm/preload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preload.js","sourceRoot":"","sources":["../../src/preload.ts"],"names":[],"mappings":"AACA,OAAO,YAAY,MAAM,mBAAmB,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAA6B;IAC/D,IAAI,CAAC;QACH,OAAO,MAAM,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IACjD,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;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAe;IACxD,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,oBAAoB,CAAC,IAAI,IAAI,IAAI,CAAC,CAAA;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAoB;IACtD,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,oBAAoB,CAAC,SAAS,IAAI,IAAI,CAAC,CAAA;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC"}

package/build/esm/renderer/index.js

@@ -0,0 +1,2 @@
+export { createVoltraRenderer, renderAndroidVariantToJson, VOLTRA_PAYLOAD_VERSION, } from './renderer.js';
+//# sourceMappingURL=index.js.map

package/build/esm/renderer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/renderer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,eAAe,CAAA"}

package/build/esm/renderer/renderer.js

@@ -0,0 +1,13 @@
+import { createVoltraRenderer as createCoreVoltraRenderer, renderVariantToJson, VOLTRA_PAYLOAD_VERSION, } from '@use-voltra/core';
+import { getAndroidComponentId } from '../payload/component-ids.js';
+export const androidComponentRegistry = {
+    getComponentId: (name) => getAndroidComponentId(name),
+};
+export { VOLTRA_PAYLOAD_VERSION };
+export const renderAndroidVariantToJson = (element) => {
+    return renderVariantToJson(element, androidComponentRegistry);
+};
+export const createVoltraRenderer = (componentRegistry = androidComponentRegistry) => {
+    return createCoreVoltraRenderer(componentRegistry);
+};
+//# sourceMappingURL=renderer.js.map

package/build/esm/renderer/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../../src/renderer/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,oBAAoB,IAAI,wBAAwB,EAChD,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AAGnE,MAAM,CAAC,MAAM,wBAAwB,GAAsB;IACzD,cAAc,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC;CAC9D,CAAA;AAED,OAAO,EAAE,sBAAsB,EAAE,CAAA;AAGjC,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,OAAkB,EAAkB,EAAE;IAC/E,OAAO,mBAAmB,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAA;AAC/D,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,oBAAuC,wBAAwB,EAAE,EAAE;IACtG,OAAO,wBAAwB,CAAC,iBAAiB,CAAC,CAAA;AACpD,CAAC,CAAA"}

package/build/esm/server.js

@@ -0,0 +1,3 @@
+export { renderAndroidLiveUpdateToString } from './live-update/renderer.js';
+export { renderAndroidWidgetToString } from './widgets/renderer.js';
+//# sourceMappingURL=server.js.map

package/build/esm/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAA;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAA"}

package/build/esm/styles/types.js

@@ -0,0 +1,6 @@
+/**
+ * Android-specific style types for Voltra components.
+ * These types mirror the supported properties in the Android implementation (Glance).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/build/esm/styles/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/styles/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/build/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/build/esm/utils/index.js

@@ -0,0 +1,2 @@
+export * from './useUpdateOnHMR.js';
+//# sourceMappingURL=index.js.map

package/build/esm/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA"}

package/build/esm/utils/useUpdateOnHMR.js

@@ -0,0 +1,23 @@
+import { useEffect, useState } from 'react';
+/**
+ * Taps into the HMR accept function to forcefully re-render the component when any module is updated.
+ * Is only available in development mode.
+ */
+export const useUpdateOnHMR = () => {
+    const [, forceUpdate] = useState(0);
+    useEffect(() => {
+        if (!__DEV__) {
+            return;
+        }
+        // Override the accept function to forcefully re-render when any module is updated
+        const oldAccept = global['__accept'];
+        global['__accept'] = (...args) => {
+            forceUpdate((prev) => prev + 1);
+            oldAccept?.(...args);
+        };
+        return () => {
+            global['__accept'] = oldAccept;
+        };
+    }, []);
+};
+//# sourceMappingURL=useUpdateOnHMR.js.map

package/build/esm/utils/useUpdateOnHMR.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpdateOnHMR.js","sourceRoot":"","sources":["../../../src/utils/useUpdateOnHMR.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAO3C;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;IAEnC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAM;QACR,CAAC;QAED,kFAAkF;QAClF,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,CAAA;QACpC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE;YAC/B,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;YAC/B,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;QACtB,CAAC,CAAA;QAED,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,UAAU,CAAC,GAAG,SAAS,CAAA;QAChC,CAAC,CAAA;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;AACR,CAAC,CAAA"}

package/build/esm/widgets/api.js

@@ -0,0 +1,143 @@
+import VoltraModule from '../VoltraModule.js';
+import { renderAndroidWidgetToString } from './renderer.js';
+/**
+ * Update an Android home screen widget with new content.
+ *
+ * The content will be stored in SharedPreferences and the widget
+ * will be updated to display the new content.
+ *
+ * @param widgetId - The widget identifier
+ * @param variants - An array of size variants with their breakpoints and content.
+ *   Android will automatically select the best matching variant based on the
+ *   actual widget dimensions.
+ * @param options - Optional settings like deep link URL
+ *
+ * @example Different content per size
+ * ```tsx
+ * import { VoltraAndroid, updateAndroidWidget } from 'voltra'
+ *
+ * await updateAndroidWidget('weather', [
+ *   {
+ *     size: { width: 150, height: 100 },
+ *     content: <VoltraAndroid.Text fontSize={32}>72°F</VoltraAndroid.Text>
+ *   },
+ *   {
+ *     size: { width: 250, height: 150 },
+ *     content: (
+ *       <VoltraAndroid.Row>
+ *         <VoltraAndroid.Text fontSize={32}>72°F</VoltraAndroid.Text>
+ *         <VoltraAndroid.Column>
+ *           <VoltraAndroid.Text>Sunny</VoltraAndroid.Text>
+ *           <VoltraAndroid.Text>High: 78° Low: 65°</VoltraAndroid.Text>
+ *         </VoltraAndroid.Column>
+ *       </VoltraAndroid.Row>
+ *     )
+ *   }
+ * ], { deepLinkUrl: '/weather' })
+ * ```
+ */
+export const updateAndroidWidget = async (widgetId, variants, options) => {
+    const payload = renderAndroidWidgetToString(variants);
+    return VoltraModule.updateAndroidWidget(widgetId, payload, {
+        deepLinkUrl: options?.deepLinkUrl,
+    });
+};
+/**
+ * Reload widget timelines to refresh their content.
+ *
+ * Use this after updating data that widgets depend on (e.g., after preloading
+ * new images) to force them to re-render.
+ *
+ * @param widgetIds - Optional array of widget IDs to reload. If omitted, reloads all widgets.
+ *
+ * @example
+ * ```typescript
+ * // Reload specific widgets
+ * await reloadAndroidWidgets(['weather', 'calendar'])
+ *
+ * // Reload all widgets
+ * await reloadAndroidWidgets()
+ * ```
+ */
+export const reloadAndroidWidgets = async (widgetIds) => {
+    return VoltraModule.reloadAndroidWidgets(widgetIds ?? null);
+};
+/**
+ * Clear a widget's stored data.
+ *
+ * This removes the JSON content and deep link URL for the specified widget,
+ * causing it to show its placeholder state.
+ *
+ * @param widgetId - The widget identifier to clear
+ *
+ * @example
+ * ```typescript
+ * await clearAndroidWidget('weather')
+ * ```
+ */
+export const clearAndroidWidget = async (widgetId) => {
+    return VoltraModule.clearAndroidWidget(widgetId);
+};
+/**
+ * Clear all widgets' stored data.
+ *
+ * This removes the JSON content and deep link URLs for all configured widgets,
+ * causing them to show their placeholder states.
+ *
+ * @example
+ * ```typescript
+ * await clearAllAndroidWidgets()
+ * ```
+ */
+export const clearAllAndroidWidgets = async () => {
+    return VoltraModule.clearAllAndroidWidgets();
+};
+/**
+ * Request to pin a widget to the home screen.
+ *
+ * This will show the Android system pin widget dialog, allowing the user
+ * to add the widget to their home screen. Optionally, you can provide
+ * preview dimensions to show a preview of the widget in the pin dialog.
+ *
+ * See: https://developer.android.com/develop/ui/compose/glance/pin-in-app
+ *
+ * @param widgetId - The widget identifier to pin
+ * @param options - Optional settings for the pin request
+ * @param options.previewWidth - Optional preview width in dp (default: 245)
+ * @param options.previewHeight - Optional preview height in dp (default: 115)
+ * @returns Promise that resolves to true if the pin request was successful
+ *
+ * @example Basic usage
+ * ```typescript
+ * const success = await requestPinAndroidWidget('weather')
+ * if (success) {
+ *   console.log('Widget pin request sent')
+ * }
+ * ```
+ *
+ * @example With preview dimensions
+ * ```typescript
+ * const success = await requestPinAndroidWidget('weather', {
+ *   previewWidth: 245,
+ *   previewHeight: 115
+ * })
+ * ```
+ */
+export const requestPinAndroidWidget = async (widgetId, options) => {
+    return VoltraModule.requestPinGlanceAppWidget(widgetId, options);
+};
+/**
+ * Fetches all active widget instances for the containing app on Android.
+ *
+ * @returns A promise that resolves to an array of active widget instances.
+ *
+ * @example
+ * ```typescript
+ * const widgets = await getActiveWidgets()
+ * console.log('Active widgets:', widgets)
+ * ```
+ */
+export const getActiveWidgets = async () => {
+    return VoltraModule.getActiveWidgets();
+};
+//# sourceMappingURL=api.js.map