voltra 1.4.1 → 2.0.0-rc.4

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

@@ -1,265 +0,0 @@
-import { useCallback, useEffect, useRef, useState } from 'react';
-import { addVoltraListener } from '../events.js';
-import { logger } from '../logger.js';
-import { assertRunningOnApple, useUpdateOnHMR } from '../utils/index.js';
-import VoltraModule from '../VoltraModule.js';
-import { renderLiveActivityToString } from './renderer.js';
-const normalizeSharedLiveActivityOptions = (options) => {
-    if (!options)
-        return undefined;
-    const normalizedOptions = {};
-    if (options.staleDate !== undefined) {
-        if (options.staleDate < Date.now()) {
-            logger.warn('Ignoring staleDate because it is in the past, the Live Activity would be dismissed immediately.');
-        }
-        else {
-            normalizedOptions.staleDate = options.staleDate;
-        }
-    }
-    // Always include relevanceScore, defaulting to 0.0 if not provided
-    const relevanceScore = options.relevanceScore ?? 0.0;
-    if (relevanceScore < 0 || relevanceScore > 1) {
-        logger.warn('Ignoring relevanceScore because it is out of range [0.0, 1.0], using default 0.0');
-        normalizedOptions.relevanceScore = 0.0;
-    }
-    else {
-        normalizedOptions.relevanceScore = relevanceScore;
-    }
-    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.
- *
- * @param variants - The Live Activity content variants to display
- * @param options - Configuration options for the hook
- * @returns Object with start, update, end methods and isActive state
- *
- * @example
- * ```tsx
- * import { useLiveActivity, Voltra } from 'voltra'
- *
- * const MyLiveActivity = () => {
- *   const { start, update, end, isActive } = useLiveActivity({
- *     minimal: <Voltra.Text>Live Activity</Voltra.Text>,
- *     compact: <Voltra.HStack>...</Voltra.HStack>,
- *     expanded: <Voltra.VStack>...</Voltra.VStack>
- *   }, {
- *     activityName: 'my-activity',
- *     autoStart: true,
- *     autoUpdate: true
- *   })
- *
- *   return (
- *     <View>
- *       <Button title={isActive ? "Stop" : "Start"} onPress={isActive ? end : start} />
- *     </View>
- *   )
- * }
- * ```
- */
-export const useLiveActivity = (variants, options) => {
-    const [targetId, setTargetId] = useState(() => {
-        if (options?.activityName) {
-            return isLiveActivityActive(options.activityName) ? options.activityName : 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 startLiveActivity(variantsRef.current, { ...optionsRef.current, ...options });
-        setTargetId(id);
-    }, []);
-    const update = useCallback(async (options) => {
-        if (!targetId) {
-            return;
-        }
-        const updateOptions = { ...optionsRef.current, ...options };
-        lastUpdateOptionsRef.current = updateOptions;
-        await updateLiveActivity(targetId, variantsRef.current, updateOptions);
-    }, [targetId]);
-    const end = useCallback(async (options) => {
-        if (!targetId) {
-            return;
-        }
-        await stopLiveActivity(targetId, options);
-        setTargetId(null);
-    }, [targetId]);
-    useEffect(() => {
-        if (!options?.autoStart) {
-            return;
-        }
-        start();
-    }, [options?.autoStart, start]);
-    useEffect(() => {
-        if (!options?.autoUpdate)
-            return;
-        update(lastUpdateOptionsRef.current);
-    }, [options?.autoUpdate, update, variants]);
-    useEffect(() => {
-        if (!targetId)
-            return;
-        const subscription = addVoltraListener('stateChange', (event) => {
-            if (event.activityName !== targetId)
-                return;
-            if (event.activityState === 'dismissed' || event.activityState === 'ended') {
-                // Live Activity is no longer active.
-                setTargetId(null);
-            }
-        });
-        return () => subscription.remove();
-    }, [targetId]);
-    return {
-        start,
-        update,
-        end,
-        isActive,
-    };
-};
-/**
- * Start a new Live Activity with the provided content variants.
- *
- * @param variants - The Live Activity content variants to display
- * @param options - Configuration options for the Live Activity
- * @returns Promise resolving to the activity ID
- *
- * @example
- * ```tsx
- * import { startLiveActivity, Voltra } from 'voltra'
- *
- * const activityId = await startLiveActivity({
- *   minimal: <Voltra.Text>Live Activity</Voltra.Text>,
- *   compact: <Voltra.HStack>...</Voltra.HStack>,
- *   expanded: <Voltra.VStack>...</Voltra.VStack>
- * }, {
- *   activityName: 'my-activity',
- *   deepLinkUrl: '/details',
- *   relevanceScore: 0.8
- * })
- * ```
- */
-export const startLiveActivity = async (variants, options) => {
-    if (!assertRunningOnApple())
-        return Promise.resolve('');
-    const payload = renderLiveActivityToString(variants);
-    const normalizedSharedOptions = normalizeSharedLiveActivityOptions(options);
-    const targetId = await VoltraModule.startLiveActivity(payload, {
-        target: 'liveActivity',
-        deepLinkUrl: options?.deepLinkUrl,
-        activityName: options?.activityName,
-        channelId: options?.channelId,
-        ...normalizedSharedOptions,
-    });
-    return targetId;
-};
-/**
- * Update an existing Live Activity with new content.
- *
- * @param targetId - The ID of the Live Activity to update
- * @param variants - The new Live Activity content variants
- * @param options - Update options like relevance score
- *
- * @example
- * ```tsx
- * import { updateLiveActivity, Voltra } from 'voltra'
- *
- * await updateLiveActivity('activity-123', {
- *   minimal: <Voltra.Text>Updated: Live Activity</Voltra.Text>,
- *   compact: <Voltra.HStack>...</Voltra.HStack>,
- *   expanded: <Voltra.VStack>...</Voltra.VStack>
- * }, {
- *   relevanceScore: 0.9
- * })
- * ```
- */
-export const updateLiveActivity = async (targetId, variants, options) => {
-    if (!assertRunningOnApple())
-        return Promise.resolve();
-    const payload = renderLiveActivityToString(variants);
-    const normalizedSharedOptions = normalizeSharedLiveActivityOptions(options);
-    return VoltraModule.updateLiveActivity(targetId, payload, normalizedSharedOptions);
-};
-/**
- * Stop a Live Activity.
- *
- * @param targetId - The ID of the Live Activity to stop
- * @param options - Options for how to end the activity
- *
- * @example
- * ```tsx
- * import { stopLiveActivity } from 'voltra'
- *
- * await stopLiveActivity('activity-123', { dismissalPolicy: 'immediate' })
- * ```
- */
-export const stopLiveActivity = async (targetId, options) => {
-    if (!assertRunningOnApple())
-        return Promise.resolve();
-    const normalizedOptions = normalizeEndLiveActivityOptions(options);
-    return VoltraModule.endLiveActivity(targetId, normalizedOptions);
-};
-/**
- * Check if a Live Activity with the given name is currently active.
- *
- * @param activityName - The name of the Live Activity to check
- * @returns true if the activity is active, false otherwise
- *
- * @example
- * ```tsx
- * import { isLiveActivityActive } from 'voltra'
- *
- * if (isLiveActivityActive('my-activity')) {
- *   console.log('Activity is running')
- * }
- * ```
- */
-export const isLiveActivityActive = (activityName) => {
-    if (!assertRunningOnApple())
-        return false;
-    return VoltraModule.isLiveActivityActive(activityName);
-};
-/**
- * End all active Live Activities.
- *
- * This function stops and dismisses all currently running Live Activities in the app.
- * It's useful for cleanup operations, such as when the app is being closed or
- * when you want to reset all Live Activity states.
- *
- * @example
- * ```typescript
- * import { endAllLiveActivities } from 'voltra'
- *
- * // End all active Live Activities
- * await endAllLiveActivities()
- * ```
- */
-export async function endAllLiveActivities() {
-    if (!assertRunningOnApple())
-        return Promise.resolve();
-    return VoltraModule.endAllLiveActivities();
-}
-//# sourceMappingURL=api.js.map

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

@@ -1 +0,0 @@
-{"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  /**\n   * Channel ID for broadcast push notifications (iOS 18+).\n   * When provided, the Live Activity subscribes to broadcast updates on this channel\n   * instead of receiving individual push tokens.\n   */\n  channelId?: 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   * Channel ID for broadcast push notifications (iOS 18+).\n   */\n  channelId?: 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    activityName: options?.activityName,\n    channelId: options?.channelId,\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/esm/live-activity/renderer.js

@@ -1,73 +0,0 @@
-import { createVoltraRenderer } from '../renderer/index.js';
-/**
- * Renders Live Activity variants to JSON.
- * Handles non-JSX properties like keylineTint and activityBackgroundTint separately.
- */
-export const renderLiveActivityToJson = (variants) => {
-    const renderer = createVoltraRenderer();
-    // Add lock screen variant
-    if (variants.lockScreen) {
-        const lockScreenVariant = variants.lockScreen;
-        if (typeof lockScreenVariant === 'object' && lockScreenVariant !== null && 'content' in lockScreenVariant) {
-            if (lockScreenVariant.content) {
-                renderer.addRootNode('ls', lockScreenVariant.content);
-            }
-        }
-        else {
-            renderer.addRootNode('ls', lockScreenVariant);
-        }
-    }
-    // Add island variants
-    if (variants.island) {
-        if (variants.island.expanded) {
-            if (variants.island.expanded.center) {
-                renderer.addRootNode('isl_exp_c', variants.island.expanded.center);
-            }
-            if (variants.island.expanded.leading) {
-                renderer.addRootNode('isl_exp_l', variants.island.expanded.leading);
-            }
-            if (variants.island.expanded.trailing) {
-                renderer.addRootNode('isl_exp_t', variants.island.expanded.trailing);
-            }
-            if (variants.island.expanded.bottom) {
-                renderer.addRootNode('isl_exp_b', variants.island.expanded.bottom);
-            }
-        }
-        if (variants.island.compact) {
-            if (variants.island.compact.leading) {
-                renderer.addRootNode('isl_cmp_l', variants.island.compact.leading);
-            }
-            if (variants.island.compact.trailing) {
-                renderer.addRootNode('isl_cmp_t', variants.island.compact.trailing);
-            }
-        }
-        if (variants.island.minimal) {
-            renderer.addRootNode('isl_min', variants.island.minimal);
-        }
-    }
-    // Add supplemental activity family variants (iOS 18+)
-    if (variants.supplementalActivityFamilies?.small) {
-        renderer.addRootNode('saf_sm', variants.supplementalActivityFamilies.small);
-    }
-    // Render all variants
-    const result = renderer.render();
-    // Add non-JSX properties after rendering
-    if (variants.lockScreen &&
-        typeof variants.lockScreen === 'object' &&
-        'activityBackgroundTint' in variants.lockScreen) {
-        if (variants.lockScreen.activityBackgroundTint) {
-            result.ls_background_tint = variants.lockScreen.activityBackgroundTint;
-        }
-    }
-    if (variants.island?.keylineTint) {
-        result.isl_keyline_tint = variants.island.keylineTint;
-    }
-    return result;
-};
-/**
- * Renders Live Activity variants to a JSON string.
- */
-export const renderLiveActivityToString = (variants) => {
-    return JSON.stringify(renderLiveActivityToJson(variants));
-};
-//# sourceMappingURL=renderer.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../../src/live-activity/renderer.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactNode } from 'react'\n\nimport { createVoltraRenderer } from '../renderer/index.js'\nimport type { LiveActivityJson, LiveActivityVariants } from './types.js'\n\n/**\n * Renders Live Activity variants to JSON.\n * Handles non-JSX properties like keylineTint and activityBackgroundTint separately.\n */\nexport const renderLiveActivityToJson = (variants: LiveActivityVariants): LiveActivityJson => {\n  const renderer = createVoltraRenderer()\n\n  // Add lock screen variant\n  if (variants.lockScreen) {\n    const lockScreenVariant = variants.lockScreen\n    if (typeof lockScreenVariant === 'object' && lockScreenVariant !== null && 'content' in lockScreenVariant) {\n      if (lockScreenVariant.content) {\n        renderer.addRootNode('ls', lockScreenVariant.content)\n      }\n    } else {\n      renderer.addRootNode('ls', lockScreenVariant as ReactNode)\n    }\n  }\n\n  // Add island variants\n  if (variants.island) {\n    if (variants.island.expanded) {\n      if (variants.island.expanded.center) {\n        renderer.addRootNode('isl_exp_c', variants.island.expanded.center)\n      }\n      if (variants.island.expanded.leading) {\n        renderer.addRootNode('isl_exp_l', variants.island.expanded.leading)\n      }\n      if (variants.island.expanded.trailing) {\n        renderer.addRootNode('isl_exp_t', variants.island.expanded.trailing)\n      }\n      if (variants.island.expanded.bottom) {\n        renderer.addRootNode('isl_exp_b', variants.island.expanded.bottom)\n      }\n    }\n    if (variants.island.compact) {\n      if (variants.island.compact.leading) {\n        renderer.addRootNode('isl_cmp_l', variants.island.compact.leading)\n      }\n      if (variants.island.compact.trailing) {\n        renderer.addRootNode('isl_cmp_t', variants.island.compact.trailing)\n      }\n    }\n    if (variants.island.minimal) {\n      renderer.addRootNode('isl_min', variants.island.minimal)\n    }\n  }\n\n  // Add supplemental activity family variants (iOS 18+)\n  if (variants.supplementalActivityFamilies?.small) {\n    renderer.addRootNode('saf_sm', variants.supplementalActivityFamilies.small)\n  }\n\n  // Render all variants\n  const result = renderer.render() as LiveActivityJson\n\n  // Add non-JSX properties after rendering\n  if (\n    variants.lockScreen &&\n    typeof variants.lockScreen === 'object' &&\n    'activityBackgroundTint' in variants.lockScreen\n  ) {\n    if (variants.lockScreen.activityBackgroundTint) {\n      result.ls_background_tint = variants.lockScreen.activityBackgroundTint\n    }\n  }\n\n  if (variants.island?.keylineTint) {\n    result.isl_keyline_tint = variants.island.keylineTint\n  }\n\n  return result\n}\n\n/**\n * Renders Live Activity variants to a JSON string.\n */\nexport const renderLiveActivityToString = (variants: LiveActivityVariants): string => {\n  return JSON.stringify(renderLiveActivityToJson(variants))\n}\n"]}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/live-activity/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ReactNode } from 'react'\n\nimport type { VoltraNodeJson } from '../types.js'\n\n/**\n * Live Activity variants - defines content for different states\n */\nexport type LiveActivityVariants = {\n  lockScreen?:\n    | ReactNode\n    | {\n        content?: ReactNode\n        activityBackgroundTint?: string\n      }\n  island?: {\n    keylineTint?: string\n    expanded?: {\n      center?: ReactNode\n      leading?: ReactNode\n      trailing?: ReactNode\n      bottom?: ReactNode\n    }\n    compact?: {\n      leading?: ReactNode\n      trailing?: ReactNode\n    }\n    minimal?: ReactNode\n  }\n  /**\n   * Supplemental activity families for iOS 18+ (watchOS Smart Stack, CarPlay)\n   * Always enabled for all Live Activities\n   */\n  supplementalActivityFamilies?: {\n    /**\n     * Small family for watchOS Smart Stack and CarPlay (iOS 18+)\n     * Should be a simplified version of the lock screen UI\n     * Falls back to compact island regions (leading + trailing) if not provided\n     */\n    small?: ReactNode\n  }\n}\n\n/**\n * Rendered Live Activity variants to JSON.\n */\nexport type LiveActivityVariantsJson = {\n  v: number // Payload version - required for remote updates\n  s?: Record<string, unknown>[] // Shared stylesheet for all variants\n  e?: VoltraNodeJson[] // Shared elements for deduplication\n  ls?: VoltraNodeJson\n  ls_background_tint?: string\n  isl_keyline_tint?: string\n  isl_exp_c?: VoltraNodeJson\n  isl_exp_l?: VoltraNodeJson\n  isl_exp_t?: VoltraNodeJson\n  isl_exp_b?: VoltraNodeJson\n  isl_cmp_l?: VoltraNodeJson\n  isl_cmp_t?: VoltraNodeJson\n  isl_min?: VoltraNodeJson\n  // Supplemental activity families (iOS 18+)\n  saf_sm?: VoltraNodeJson // supplementalActivityFamilies.small (watchOS/CarPlay)\n}\n\n/**\n * JSON representation of live activity variants for rendering\n */\nexport type LiveActivityJson = LiveActivityVariantsJson\n\n/**\n * Dismissal policy for Live Activities.\n */\nexport type DismissalPolicy = 'immediate' | { after: number }\n"]}

package/build/esm/logger.js

@@ -1,33 +0,0 @@
-const LEVELS = {
-    debug: 0,
-    info: 1,
-    warn: 2,
-    error: 3,
-};
-let currentLevel = __DEV__ ? 'debug' : 'info';
-export const logger = {
-    debug: (message) => {
-        if (LEVELS.debug >= LEVELS[currentLevel]) {
-            console.log(`[Voltra] ${message}`);
-        }
-    },
-    info: (message) => {
-        if (LEVELS.info >= LEVELS[currentLevel]) {
-            console.info(`[Voltra] ${message}`);
-        }
-    },
-    warn: (message) => {
-        if (LEVELS.warn >= LEVELS[currentLevel]) {
-            console.warn(`[Voltra] ${message}`);
-        }
-    },
-    error: (message) => {
-        if (LEVELS.error >= LEVELS[currentLevel]) {
-            console.error(`[Voltra] ${message}`);
-        }
-    },
-    setLevel: (level) => {
-        currentLevel = level;
-    },
-};
-//# sourceMappingURL=logger.js.map

package/build/esm/logger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG;IACb,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACA,CAAA;AAGV,IAAI,YAAY,GAAmB,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAA;AAE7D,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE;QACzB,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,EAAE,CAAC,CAAA;QACpC,CAAC;IACH,CAAC;IACD,IAAI,EAAE,CAAC,OAAe,EAAE,EAAE;QACxB,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC,YAAY,OAAO,EAAE,CAAC,CAAA;QACrC,CAAC;IACH,CAAC;IACD,IAAI,EAAE,CAAC,OAAe,EAAE,EAAE;QACxB,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC,YAAY,OAAO,EAAE,CAAC,CAAA;QACrC,CAAC;IACH,CAAC;IACD,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE;QACzB,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,KAAK,CAAC,YAAY,OAAO,EAAE,CAAC,CAAA;QACtC,CAAC;IACH,CAAC;IACD,QAAQ,EAAE,CAAC,KAAqB,EAAE,EAAE;QAClC,YAAY,GAAG,KAAK,CAAA;IACtB,CAAC;CACF,CAAA","sourcesContent":["const LEVELS = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n} as const\nexport type VoltraLogLevel = keyof typeof LEVELS\n\nlet currentLevel: VoltraLogLevel = __DEV__ ? 'debug' : 'info'\n\nexport const logger = {\n  debug: (message: string) => {\n    if (LEVELS.debug >= LEVELS[currentLevel]) {\n      console.log(`[Voltra] ${message}`)\n    }\n  },\n  info: (message: string) => {\n    if (LEVELS.info >= LEVELS[currentLevel]) {\n      console.info(`[Voltra] ${message}`)\n    }\n  },\n  warn: (message: string) => {\n    if (LEVELS.warn >= LEVELS[currentLevel]) {\n      console.warn(`[Voltra] ${message}`)\n    }\n  },\n  error: (message: string) => {\n    if (LEVELS.error >= LEVELS[currentLevel]) {\n      console.error(`[Voltra] ${message}`)\n    }\n  },\n  setLevel: (level: VoltraLogLevel) => {\n    currentLevel = level\n  },\n}\n"]}

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

@@ -1,82 +0,0 @@
-/* eslint-disable */
-// 🤖 AUTO-GENERATED from data/components.json
-// DO NOT EDIT MANUALLY - Changes will be overwritten
-// Schema version: 1.0.0
-/**
- * Mapping from component name to numeric ID
- * Component IDs are assigned sequentially based on order in components.json (0-indexed)
- */
-export const COMPONENT_NAME_TO_ID = {
-    Text: 0,
-    Button: 1,
-    Label: 2,
-    Image: 3,
-    Symbol: 4,
-    Toggle: 5,
-    LinearProgressView: 6,
-    CircularProgressView: 7,
-    Gauge: 8,
-    Timer: 9,
-    LinearGradient: 10,
-    VStack: 11,
-    HStack: 12,
-    ZStack: 13,
-    GroupBox: 14,
-    GlassContainer: 15,
-    Spacer: 16,
-    Divider: 17,
-    Mask: 18,
-    Link: 19,
-    View: 20,
-    Chart: 21,
-};
-/**
- * Mapping from numeric ID to component name
- */
-export const COMPONENT_ID_TO_NAME = {
-    0: 'Text',
-    1: 'Button',
-    2: 'Label',
-    3: 'Image',
-    4: 'Symbol',
-    5: 'Toggle',
-    6: 'LinearProgressView',
-    7: 'CircularProgressView',
-    8: 'Gauge',
-    9: 'Timer',
-    10: 'LinearGradient',
-    11: 'VStack',
-    12: 'HStack',
-    13: 'ZStack',
-    14: 'GroupBox',
-    15: 'GlassContainer',
-    16: 'Spacer',
-    17: 'Divider',
-    18: 'Mask',
-    19: 'Link',
-    20: 'View',
-    21: 'Chart',
-};
-/**
- * Get component ID from name
- * @throws Error if component name is not found
- */
-export function getComponentId(name) {
-    const id = COMPONENT_NAME_TO_ID[name];
-    if (id === undefined) {
-        throw new Error(`Unknown component name: "${name}". Available components: ${Object.keys(COMPONENT_NAME_TO_ID).join(', ')}`);
-    }
-    return id;
-}
-/**
- * Get component name from ID
- * @throws Error if component ID is not found
- */
-export function getComponentName(id) {
-    const name = COMPONENT_ID_TO_NAME[id];
-    if (name === undefined) {
-        throw new Error(`Unknown component ID: ${id}. Valid IDs: 0-${Object.keys(COMPONENT_ID_TO_NAME).length - 1}`);
-    }
-    return name;
-}
-//# sourceMappingURL=component-ids.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"component-ids.js","sourceRoot":"","sources":["../../../src/payload/component-ids.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,8CAA8C;AAC9C,qDAAqD;AACrD,wBAAwB;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAC1D,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,kBAAkB,EAAE,CAAC;IACrB,oBAAoB,EAAE,CAAC;IACvB,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,cAAc,EAAE,EAAE;IAClB,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,QAAQ,EAAE,EAAE;IACZ,cAAc,EAAE,EAAE;IAClB,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;CACV,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAC1D,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,oBAAoB;IACvB,CAAC,EAAE,sBAAsB;IACzB,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,OAAO;IACV,EAAE,EAAE,gBAAgB;IACpB,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,UAAU;IACd,EAAE,EAAE,gBAAgB;IACpB,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,SAAS;IACb,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,OAAO;CACZ,CAAA;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,EAAE,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAA;IACrC,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,4BAA4B,IAAI,4BAA4B,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3G,CAAA;IACH,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,MAAM,IAAI,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAA;IACrC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,yBAAyB,EAAE,kBAAkB,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAA;IAC9G,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC","sourcesContent":["/* eslint-disable */\n// 🤖 AUTO-GENERATED from data/components.json\n// DO NOT EDIT MANUALLY - Changes will be overwritten\n// Schema version: 1.0.0\n\n/**\n * Mapping from component name to numeric ID\n * Component IDs are assigned sequentially based on order in components.json (0-indexed)\n */\nexport const COMPONENT_NAME_TO_ID: Record<string, number> = {\n  Text: 0,\n  Button: 1,\n  Label: 2,\n  Image: 3,\n  Symbol: 4,\n  Toggle: 5,\n  LinearProgressView: 6,\n  CircularProgressView: 7,\n  Gauge: 8,\n  Timer: 9,\n  LinearGradient: 10,\n  VStack: 11,\n  HStack: 12,\n  ZStack: 13,\n  GroupBox: 14,\n  GlassContainer: 15,\n  Spacer: 16,\n  Divider: 17,\n  Mask: 18,\n  Link: 19,\n  View: 20,\n  Chart: 21,\n}\n\n/**\n * Mapping from numeric ID to component name\n */\nexport const COMPONENT_ID_TO_NAME: Record<number, string> = {\n  0: 'Text',\n  1: 'Button',\n  2: 'Label',\n  3: 'Image',\n  4: 'Symbol',\n  5: 'Toggle',\n  6: 'LinearProgressView',\n  7: 'CircularProgressView',\n  8: 'Gauge',\n  9: 'Timer',\n  10: 'LinearGradient',\n  11: 'VStack',\n  12: 'HStack',\n  13: 'ZStack',\n  14: 'GroupBox',\n  15: 'GlassContainer',\n  16: 'Spacer',\n  17: 'Divider',\n  18: 'Mask',\n  19: 'Link',\n  20: 'View',\n  21: 'Chart',\n}\n\n/**\n * Get component ID from name\n * @throws Error if component name is not found\n */\nexport function getComponentId(name: string): number {\n  const id = COMPONENT_NAME_TO_ID[name]\n  if (id === undefined) {\n    throw new Error(\n      `Unknown component name: \"${name}\". Available components: ${Object.keys(COMPONENT_NAME_TO_ID).join(', ')}`\n    )\n  }\n  return id\n}\n\n/**\n * Get component name from ID\n * @throws Error if component ID is not found\n */\nexport function getComponentName(id: number): string {\n  const name = COMPONENT_ID_TO_NAME[id]\n  if (name === undefined) {\n    throw new Error(`Unknown component ID: ${id}. Valid IDs: 0-${Object.keys(COMPONENT_ID_TO_NAME).length - 1}`)\n  }\n  return name\n}\n"]}

package/build/esm/payload/short-names.js

@@ -1,2 +0,0 @@
-export { expand, NAME_TO_SHORT, SHORT_TO_NAME, shorten } from '@use-voltra/core';
-//# sourceMappingURL=short-names.js.map

package/build/esm/payload/short-names.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"short-names.js","sourceRoot":"","sources":["../../../src/payload/short-names.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA","sourcesContent":["export { expand, NAME_TO_SHORT, SHORT_TO_NAME, shorten } from '@use-voltra/core'\n"]}

package/build/esm/payload.js

@@ -1,2 +0,0 @@
-export { ensurePayloadWithinBudget } from '@use-voltra/core';
-//# sourceMappingURL=payload.js.map

package/build/esm/payload.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA","sourcesContent":["export { ensurePayloadWithinBudget } from '@use-voltra/core'\n"]}

package/build/esm/preload.js

@@ -1,107 +0,0 @@
-import { Platform } from 'react-native';
-import VoltraModule from './VoltraModule.js';
-function assertIOS(name) {
-    const isIOS = Platform.OS === 'ios';
-    if (!isIOS)
-        console.error(`${name} is only available on iOS`);
-    return isIOS;
-}
-/**
- * Preload images to App Group storage for use in Live Activities.
- *
- * Downloaded images are stored in shared storage accessible by both the app
- * and the Live Activity widget extension. Images can then be referenced using
- * the `assetName` property in the Image component.
- *
- * Images must be less than 4KB to comply with ActivityKit limits.
- *
- * @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 Live Activity
- * <Voltra.Image source={{ assetName: 'current-album' }} />
- * ```
- */
-export async function preloadImages(images) {
-    if (!assertIOS('preloadImages')) {
-        return { succeeded: [], failed: images.map((img) => ({ key: img.key, error: 'Not available on this platform' })) };
-    }
-    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',
-            })),
-        };
-    }
-}
-/**
- * Reload Live Activities to pick up newly preloaded images.
- *
- * This triggers an update on the specified Live Activities (or all if none specified)
- * with their current content state, forcing SwiftUI to re-render and load the
- * newly preloaded images from App Group storage.
- *
- * @param activityNames - Optional array of activity names to reload. If omitted, reloads all.
- *
- * @example
- * ```typescript
- * // Preload new image
- * await preloadImages([{ url: 'https://example.com/new-art.jpg', key: 'album-art' }])
- *
- * // Reload specific activity to pick up the new image
- * await reloadLiveActivities(['music-player'])
- *
- * // Or reload all activities
- * await reloadLiveActivities()
- * ```
- */
-export async function reloadLiveActivities(activityNames) {
-    if (!assertIOS('reloadLiveActivities'))
-        return;
-    try {
-        await VoltraModule.reloadLiveActivities(activityNames ?? null);
-    }
-    catch (error) {
-        console.error('Failed to reload Live Activities:', error);
-    }
-}
-/**
- * Clear preloaded images from App Group storage.
- *
- * @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) {
-    if (!assertIOS('clearPreloadedImages'))
-        return;
-    try {
-        await VoltraModule.clearPreloadedImages(keys ?? null);
-    }
-    catch (error) {
-        console.error('Failed to clear preloaded images:', error);
-    }
-}
-//# sourceMappingURL=preload.js.map