@use-voltra/android 1.3.0

package/build/types/live-update/api.d.ts

@@ -0,0 +1,126 @@
+import type { AndroidLiveUpdateVariants, StartAndroidLiveUpdateOptions, UpdateAndroidLiveUpdateOptions, UseAndroidLiveUpdateOptions, UseAndroidLiveUpdateResult } from './types.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 declare const useAndroidLiveUpdate: (variants: AndroidLiveUpdateVariants, options?: UseAndroidLiveUpdateOptions) => UseAndroidLiveUpdateResult;
+/**
+ * @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 declare const startAndroidLiveUpdate: (variants: AndroidLiveUpdateVariants, options?: StartAndroidLiveUpdateOptions) => Promise<string>;
+/**
+ * @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 declare const updateAndroidLiveUpdate: (notificationId: string, variants: AndroidLiveUpdateVariants, options?: UpdateAndroidLiveUpdateOptions) => Promise<void>;
+/**
+ * @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 declare const stopAndroidLiveUpdate: (notificationId: string) => Promise<void>;
+/**
+ * @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 declare const isAndroidLiveUpdateActive: (updateName: string) => boolean;
+/**
+ * @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 declare function endAllAndroidLiveUpdates(): Promise<void>;
+//# sourceMappingURL=api.d.ts.map

package/build/types/live-update/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/live-update/api.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC9B,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,yBAAyB,EACnC,UAAU,2BAA2B,KACpC,0BAyEF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,yBAAyB,EACnC,UAAU,6BAA6B,KACtC,OAAO,CAAC,MAAM,CAShB,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,uBAAuB,GAClC,gBAAgB,MAAM,EACtB,UAAU,yBAAyB,EACnC,UAAU,8BAA8B,KACvC,OAAO,CAAC,IAAI,CAId,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,GAAU,gBAAgB,MAAM,KAAG,OAAO,CAAC,IAAI,CAEhF,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,yBAAyB,GAAI,YAAY,MAAM,KAAG,OAE9D,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9D"}

package/build/types/live-update/renderer.d.ts

@@ -0,0 +1,11 @@
+import type { AndroidLiveUpdateJson, AndroidLiveUpdateVariants } from './types.js';
+/**
+ * Renders Android Live Update variants to JSON.
+ * Uses the Android component registry for component ID lookups.
+ */
+export declare const renderAndroidLiveUpdateToJson: (variants: AndroidLiveUpdateVariants) => AndroidLiveUpdateJson;
+/**
+ * Renders Android Live Update variants to a JSON string.
+ */
+export declare const renderAndroidLiveUpdateToString: (variants: AndroidLiveUpdateVariants) => string;
+//# sourceMappingURL=renderer.d.ts.map

package/build/types/live-update/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/live-update/renderer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA;AASlF;;;GAGG;AACH,eAAO,MAAM,6BAA6B,GAAI,UAAU,yBAAyB,KAAG,qBA2BnF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,+BAA+B,GAAI,UAAU,yBAAyB,KAAG,MAErF,CAAA"}

package/build/types/live-update/types.d.ts

@@ -0,0 +1,100 @@
+import type { ReactNode } from 'react';
+import type { VoltraNodeJson } from '../types.js';
+/**
+ * Android Live Update variants for Ongoing Notifications.
+ *
+ * Android ongoing notifications have a simpler structure than iOS Live Activities.
+ * There's no Dynamic Island equivalent.
+ */
+export type AndroidLiveUpdateVariants = {
+    /**
+     * The collapsed notification content (always visible in the notification shade).
+     * Height constraint: ~64dp
+     */
+    collapsed?: ReactNode;
+    /**
+     * The expanded notification content (visible when user expands the notification).
+     * Height constraint: up to 256dp
+     */
+    expanded?: ReactNode;
+    /**
+     * Small icon resource name for the notification.
+     * Should reference a drawable resource (e.g., 'ic_notification')
+     */
+    smallIcon?: string;
+    /**
+     * Notification channel ID (required on Android 8+).
+     * The channel must be created before starting the live update.
+     */
+    channelId?: string;
+};
+/**
+ * Rendered Android Live Update variants to JSON.
+ */
+export type AndroidLiveUpdateVariantsJson = {
+    /** Payload version - required for remote updates */
+    v: number;
+    /** Shared stylesheet for all variants */
+    s?: Record<string, unknown>[];
+    /** Shared elements for deduplication */
+    e?: VoltraNodeJson[];
+    /** Collapsed notification content */
+    collapsed?: VoltraNodeJson;
+    /** Expanded notification content */
+    expanded?: VoltraNodeJson;
+    /** Small icon resource name */
+    smallIcon?: string;
+    /** Notification channel ID */
+    channelId?: string;
+};
+/**
+ * JSON representation of Android live update variants for rendering
+ */
+export type AndroidLiveUpdateJson = AndroidLiveUpdateVariantsJson;
+/**
+ * Options for starting an Android Live Update
+ */
+export type StartAndroidLiveUpdateOptions = {
+    /**
+     * A unique name for this live update.
+     * Allows you to rebind to the same notification on app restart.
+     */
+    updateName?: string;
+    /**
+     * The notification channel ID to use.
+     * Overrides the channelId from variants if provided.
+     */
+    channelId?: string;
+};
+/**
+ * Options for updating an Android Live Update
+ */
+export type UpdateAndroidLiveUpdateOptions = {};
+/**
+ * Options for the useAndroidLiveUpdate hook
+ */
+export type UseAndroidLiveUpdateOptions = {
+    /**
+     * A unique name for this live update.
+     * Allows you to rebind to the same notification on app restart.
+     */
+    updateName?: string;
+    /**
+     * Automatically start the live update when the component mounts.
+     */
+    autoStart?: boolean;
+    /**
+     * Automatically update the live update when the component updates.
+     */
+    autoUpdate?: boolean;
+};
+/**
+ * Result from the useAndroidLiveUpdate hook
+ */
+export type UseAndroidLiveUpdateResult = {
+    start: (options?: StartAndroidLiveUpdateOptions) => Promise<void>;
+    update: (options?: UpdateAndroidLiveUpdateOptions) => Promise<void>;
+    end: () => Promise<void>;
+    isActive: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/build/types/live-update/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/live-update/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAA;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,oDAAoD;IACpD,CAAC,EAAE,MAAM,CAAA;IACT,yCAAyC;IACzC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAC7B,wCAAwC;IACxC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAA;IACpB,qCAAqC;IACrC,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,6BAA6B,CAAA;AAEjE;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,EAE5C,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,6BAA6B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjE,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,8BAA8B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACnE,GAAG,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA"}

package/build/types/payload/component-ids.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Mapping from Android component name to numeric ID
+ * Component IDs are assigned sequentially based on order in components.json (0-indexed)
+ */
+export declare const ANDROID_COMPONENT_NAME_TO_ID: Record<string, number>;
+/**
+ * Mapping from numeric ID to Android component name
+ */
+export declare const ANDROID_COMPONENT_ID_TO_NAME: Record<number, string>;
+/**
+ * Get Android component ID from name
+ * @throws Error if component name is not found
+ */
+export declare function getAndroidComponentId(name: string): number;
+/**
+ * Get Android component name from ID
+ * @throws Error if component ID is not found
+ */
+export declare function getAndroidComponentName(id: number): string;
+//# sourceMappingURL=component-ids.d.ts.map

package/build/types/payload/component-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-ids.d.ts","sourceRoot":"","sources":["../../../src/payload/component-ids.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsB/D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsB/D,CAAA;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU1D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAQ1D"}

package/build/types/preload.d.ts

@@ -0,0 +1,45 @@
+import type { PreloadImageOptions, PreloadImagesResult } from './types.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 declare function preloadImages(images: PreloadImageOptions[]): Promise<PreloadImagesResult>;
+/**
+ * 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 declare function clearPreloadedImages(keys?: string[]): Promise<void>;
+/**
+ * Reload Android Widgets. (Alias for reloadAndroidWidgets)
+ */
+export declare function reloadWidgets(widgetIds?: string[]): Promise<void>;
+//# sourceMappingURL=preload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preload.d.ts","sourceRoot":"","sources":["../../src/preload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAG1E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAY/F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvE"}

package/build/types/renderer/index.d.ts

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

package/build/types/renderer/index.d.ts.map

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

package/build/types/renderer/renderer.d.ts

@@ -0,0 +1,12 @@
+import { type ComponentRegistry, VOLTRA_PAYLOAD_VERSION } from '@use-voltra/core';
+import type { ReactNode } from 'react';
+import type { VoltraNodeJson } from '../types.js';
+export declare const androidComponentRegistry: ComponentRegistry;
+export { VOLTRA_PAYLOAD_VERSION };
+export type { ComponentRegistry };
+export declare const renderAndroidVariantToJson: (element: ReactNode) => VoltraNodeJson;
+export declare const createVoltraRenderer: (componentRegistry?: ComponentRegistry) => {
+    addRootNode: (name: string, node: ReactNode) => void;
+    render: () => Record<string, any>;
+};
+//# sourceMappingURL=renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/renderer/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EAGtB,sBAAsB,EACvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,eAAO,MAAM,wBAAwB,EAAE,iBAEtC,CAAA;AAED,OAAO,EAAE,sBAAsB,EAAE,CAAA;AACjC,YAAY,EAAE,iBAAiB,EAAE,CAAA;AAEjC,eAAO,MAAM,0BAA0B,GAAI,SAAS,SAAS,KAAG,cAE/D,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,oBAAmB,iBAA4C;;;CAEnG,CAAA"}

package/build/types/server.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","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/types/styles/types.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Android-specific style types for Voltra components.
+ * These types mirror the supported properties in the Android implementation (Glance).
+ */
+export type StyleProp<T> = T | T[] | null | undefined | false;
+export type VoltraAndroidViewStyle = {
+    /** Width of the component. Supports fixed numbers (dp) or "100%" to fill. */
+    width?: number | string;
+    /** Height of the component. Supports fixed numbers (dp) or "100%" to fill. */
+    height?: number | string;
+    /** Minimum width (Note: Limited support in Glance) */
+    minWidth?: number;
+    /** Maximum width (Note: Limited support in Glance) */
+    maxWidth?: number;
+    /** Minimum height (Note: Limited support in Glance) */
+    minHeight?: number;
+    /** Maximum height (Note: Limited support in Glance) */
+    maxHeight?: number;
+    /** Flex weight for the component (maps to .defaultWeight() in Glance) */
+    flex?: number;
+    /** Flex grow weight for the component (maps to .defaultWeight() in Glance) */
+    flexGrow?: number;
+    /** Aspect ratio of the component (Note: Not supported in Glance) */
+    aspectRatio?: number;
+    /** Inner padding for the component */
+    padding?: number;
+    paddingTop?: number;
+    paddingBottom?: number;
+    paddingLeft?: number;
+    paddingRight?: number;
+    paddingVertical?: number;
+    paddingHorizontal?: number;
+    /** Outer margin for the component (Note: Often implemented as padding in Glance) */
+    margin?: number;
+    marginTop?: number;
+    marginBottom?: number;
+    marginLeft?: number;
+    marginRight?: number;
+    marginVertical?: number;
+    marginHorizontal?: number;
+    /** Gap between children (Note: Supported by specific layouts like LazyColumn/Row) */
+    gap?: number;
+    /** Alignment of children along the cross axis */
+    alignItems?: 'flex-start' | 'flex-end' | 'center' | 'stretch' | 'baseline';
+    /** Alignment of children along the main axis */
+    justifyContent?: 'flex-start' | 'flex-end' | 'center' | 'space-between' | 'space-around' | 'space-evenly';
+    /** Absolute positioning from the left (maps to Offset in Glance) */
+    left?: number;
+    /** Absolute positioning from the top (maps to Offset in Glance) */
+    top?: number;
+    /** Z-index for layering (Note: Limited support in Glance) */
+    zIndex?: number;
+    /** Background color of the component */
+    backgroundColor?: string;
+    /** Corner radius for the component (requires Android 12+) */
+    borderRadius?: number;
+    /** Border width (Note: Not yet implemented in Glance) */
+    borderWidth?: number;
+    /** Border color (Note: Not yet implemented in Glance) */
+    borderColor?: string;
+    /** Opacity of the component (Note: Not supported in Glance - apply alpha to colors instead) */
+    opacity?: number;
+    /** Controls if content is clipped to the border (maps to clipToOutline) */
+    overflow?: 'visible' | 'hidden';
+    /** Controls layout display mode */
+    display?: 'none' | 'flex';
+    /** Controls component visibility */
+    visibility?: 'visible' | 'hidden' | 'invisible';
+    /** Transform effects (Note: Not supported in Glance) */
+    transform?: ({
+        rotate: string;
+    } | {
+        rotateZ: string;
+    } | {
+        scale: number;
+    } | {
+        scaleX: number;
+    } | {
+        scaleY: number;
+    })[];
+    /** Shadow properties (Note: Not supported in Glance) */
+    shadowColor?: string;
+    shadowOffset?: {
+        width: number;
+        height: number;
+    };
+    shadowOpacity?: number;
+    shadowRadius?: number;
+    /** Glass effect (iOS-specific, included for API compatibility) */
+    glassEffect?: 'clear' | 'identity' | 'regular' | 'none';
+};
+export type VoltraAndroidTextStyle = VoltraAndroidViewStyle & {
+    /** Text color */
+    color?: string;
+    /** Font size in sp */
+    fontSize?: number;
+    /** Font weight */
+    fontWeight?: 'normal' | 'bold' | '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900' | number;
+    /** Font family name. When used with `renderAsBitmap`, loads custom .ttf/.otf from `assets/fonts/` */
+    fontFamily?: string;
+    /** Text alignment */
+    textAlign?: 'auto' | 'left' | 'right' | 'center' | 'justify' | 'start' | 'end';
+    /** Text decoration line */
+    textDecorationLine?: 'none' | 'underline' | 'line-through' | 'underline line-through';
+    /** Line height (maps to line spacing in Glance) */
+    lineHeight?: number;
+    /** Letter spacing (Note: Not supported in Glance) */
+    letterSpacing?: number;
+    /** Font variants (Note: Not supported in Glance) */
+    fontVariant?: ('small-caps' | 'tabular-nums')[];
+    /** Maximum number of lines to display (maps to lineLimit) */
+    numberOfLines?: number;
+};
+export type VoltraAndroidStyleProp = StyleProp<VoltraAndroidViewStyle>;
+export type VoltraAndroidTextStyleProp = StyleProp<VoltraAndroidTextStyle>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/build/types/types.d.ts

@@ -0,0 +1,2 @@
+export type { EventSubscription, PreloadImageFailure, PreloadImageOptions, PreloadImagesResult, UpdateWidgetOptions, VoltraElementJson, VoltraElementRef, VoltraNodeJson, VoltraPropValue, WidgetServerCredentials, } from '@use-voltra/core';
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,uBAAuB,GACxB,MAAM,kBAAkB,CAAA"}

package/build/types/utils/index.d.ts

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

package/build/types/utils/index.d.ts.map

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

package/build/types/utils/useUpdateOnHMR.d.ts

@@ -0,0 +1,9 @@
+declare global {
+    var __accept: (...args: unknown[]) => void;
+}
+/**
+ * Taps into the HMR accept function to forcefully re-render the component when any module is updated.
+ * Is only available in development mode.
+ */
+export declare const useUpdateOnHMR: () => void;
+//# sourceMappingURL=useUpdateOnHMR.d.ts.map

package/build/types/utils/useUpdateOnHMR.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpdateOnHMR.d.ts","sourceRoot":"","sources":["../../../src/utils/useUpdateOnHMR.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CAC3C;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,YAmB1B,CAAA"}

package/build/types/widgets/api.d.ts

@@ -0,0 +1,131 @@
+import type { AndroidWidgetVariants, UpdateAndroidWidgetOptions, WidgetInfo } from './types.js';
+export type { AndroidWidgetSize, AndroidWidgetSizeVariant, AndroidWidgetVariants, UpdateAndroidWidgetOptions, WidgetInfo, } from './types.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 declare const updateAndroidWidget: (widgetId: string, variants: AndroidWidgetVariants, options?: UpdateAndroidWidgetOptions) => Promise<void>;
+/**
+ * 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 declare const reloadAndroidWidgets: (widgetIds?: string[]) => Promise<void>;
+/**
+ * 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 declare const clearAndroidWidget: (widgetId: string) => Promise<void>;
+/**
+ * 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 declare const clearAllAndroidWidgets: () => Promise<void>;
+/**
+ * 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 declare const requestPinAndroidWidget: (widgetId: string, options?: {
+    previewWidth?: number;
+    previewHeight?: number;
+}) => Promise<boolean>;
+/**
+ * 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 declare const getActiveWidgets: () => Promise<WidgetInfo[]>;
+//# sourceMappingURL=api.d.ts.map

package/build/types/widgets/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/widgets/api.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAG/F,YAAY,EACV,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,UAAU,GACX,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,MAAM,EAChB,UAAU,qBAAqB,EAC/B,UAAU,0BAA0B,KACnC,OAAO,CAAC,IAAI,CAMd,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,GAAU,YAAY,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAE7E,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,IAAI,CAEvE,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,QAAa,OAAO,CAAC,IAAI,CAE3D,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,MAAM,EAChB,UAAU;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,KAC1D,OAAO,CAAC,OAAO,CAEjB,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,QAAa,OAAO,CAAC,UAAU,EAAE,CAE7D,CAAA"}

package/build/types/widgets/index.d.ts

@@ -0,0 +1,3 @@
+export { clearAllAndroidWidgets, clearAndroidWidget, getActiveWidgets, reloadAndroidWidgets, requestPinAndroidWidget, updateAndroidWidget, } from './api.js';
+export type { AndroidWidgetSize, AndroidWidgetSizeVariant, AndroidWidgetVariants, UpdateAndroidWidgetOptions, WidgetInfo, } from './types.js';
+//# sourceMappingURL=index.d.ts.map