@use-voltra/expo-plugin 1.3.0

package/build/esm/utils/logger.js

@@ -0,0 +1,48 @@
+/**
+ * Structured logging utility for the Voltra plugin
+ */
+const PREFIX = '[Voltra]';
+// ANSI color codes
+const RED = '\x1b[31m';
+const RESET = '\x1b[0m';
+export const logger = {
+    /**
+     * Log an informational message
+     */
+    info: (message) => {
+        console.log(`${PREFIX} ${message}`);
+    },
+    /**
+     * Log a warning message
+     */
+    warn: (message) => {
+        console.warn(`${PREFIX} ⚠️  ${message}`);
+    },
+    /**
+     * Log a warning message in red (for critical warnings)
+     */
+    warnRed: (message) => {
+        console.warn(`${RED}${PREFIX} ⚠️  ${message}${RESET}`);
+    },
+    /**
+     * Log an error message
+     */
+    error: (message) => {
+        console.error(`${PREFIX} ❌ ${message}`);
+    },
+    /**
+     * Log a success message
+     */
+    success: (message) => {
+        console.log(`${PREFIX} ✅ ${message}`);
+    },
+    /**
+     * Log a debug message (only when VOLTRA_DEBUG env var is set)
+     */
+    debug: (message) => {
+        if (process.env.VOLTRA_DEBUG) {
+            console.log(`${PREFIX} 🔍 ${message}`);
+        }
+    },
+};
+//# sourceMappingURL=logger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,GAAG,UAAU,CAAA;AAEzB,mBAAmB;AACnB,MAAM,GAAG,GAAG,UAAU,CAAA;AACtB,MAAM,KAAK,GAAG,SAAS,CAAA;AAEvB,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB;;OAEG;IACH,IAAI,EAAE,CAAC,OAAe,EAAQ,EAAE;QAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC,CAAA;IACrC,CAAC;IAED;;OAEG;IACH,IAAI,EAAE,CAAC,OAAe,EAAQ,EAAE;QAC9B,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,QAAQ,OAAO,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED;;OAEG;IACH,OAAO,EAAE,CAAC,OAAe,EAAQ,EAAE;QACjC,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,MAAM,QAAQ,OAAO,GAAG,KAAK,EAAE,CAAC,CAAA;IACxD,CAAC;IAED;;OAEG;IACH,KAAK,EAAE,CAAC,OAAe,EAAQ,EAAE;QAC/B,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,OAAO,EAAE,CAAC,CAAA;IACzC,CAAC;IAED;;OAEG;IACH,OAAO,EAAE,CAAC,OAAe,EAAQ,EAAE;QACjC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,MAAM,OAAO,EAAE,CAAC,CAAA;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,EAAE,CAAC,OAAe,EAAQ,EAAE;QAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,OAAO,OAAO,EAAE,CAAC,CAAA;QACxC,CAAC;IACH,CAAC;CACF,CAAA"}

package/build/esm/utils/prerender.js

@@ -0,0 +1,152 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import vm from 'node:vm';
+import * as babel from '@babel/core';
+import { MODULE_EXTENSIONS } from '../constants';
+/**
+ * Check if a module specifier is a relative or absolute path (local file)
+ */
+function isLocalModule(moduleSpecifier) {
+    return moduleSpecifier.startsWith('.') || moduleSpecifier.startsWith('/');
+}
+/**
+ * Resolve a module path, trying different extensions
+ */
+function resolveModulePath(moduleSpecifier, fromDir) {
+    const basePath = path.resolve(fromDir, moduleSpecifier);
+    for (const ext of MODULE_EXTENSIONS) {
+        const fullPath = basePath + ext;
+        if (fs.existsSync(fullPath) && fs.statSync(fullPath).isFile()) {
+            return fullPath;
+        }
+    }
+    // Try index files if it's a directory
+    if (fs.existsSync(basePath) && fs.statSync(basePath).isDirectory()) {
+        for (const ext of MODULE_EXTENSIONS) {
+            const indexPath = path.join(basePath, 'index' + ext);
+            if (fs.existsSync(indexPath)) {
+                return indexPath;
+            }
+        }
+    }
+    return null;
+}
+function getProjectBabelConfigPath(projectRoot) {
+    const configPath = path.join(projectRoot, 'babel.config.js');
+    return fs.existsSync(configPath) ? configPath : null;
+}
+function getFallbackExpoPreset(projectRoot) {
+    return require.resolve('babel-preset-expo', { paths: [projectRoot] });
+}
+/**
+ * Transpile a file with Babel
+ */
+function transpileFile(filePath, projectRoot) {
+    const code = fs.readFileSync(filePath, 'utf8');
+    const projectBabelConfigPath = getProjectBabelConfigPath(projectRoot);
+    const result = babel.transformSync(code, {
+        cwd: projectRoot,
+        filename: filePath,
+        ...(projectBabelConfigPath
+            ? { configFile: projectBabelConfigPath }
+            : {
+                babelrc: false,
+                configFile: false,
+                presets: [getFallbackExpoPreset(projectRoot)],
+            }),
+    });
+    if (!result || !result.code) {
+        throw new Error(`Babel transpilation failed for ${filePath}`);
+    }
+    return result.code;
+}
+/**
+ * Evaluate a widget module using Babel transpilation and Node.js VM.
+ * This allows executing widget code that uses JSX and React components.
+ * Local module dependencies are also transpiled with the same Babel settings.
+ */
+function evaluateWidgetModule(projectRoot, filePath) {
+    // Cache for already-evaluated modules to handle circular dependencies
+    const moduleCache = new Map();
+    /**
+     * Custom require that transpiles local modules with Babel
+     */
+    function customRequire(moduleSpecifier, currentDir) {
+        // For non-local modules (npm packages), use native require
+        if (!isLocalModule(moduleSpecifier)) {
+            return require(moduleSpecifier);
+        }
+        // Resolve the local module path
+        const resolvedPath = resolveModulePath(moduleSpecifier, currentDir);
+        if (!resolvedPath) {
+            throw new Error(`Cannot resolve module '${moduleSpecifier}' from '${currentDir}'`);
+        }
+        // Return cached module if already evaluated
+        if (moduleCache.has(resolvedPath)) {
+            return moduleCache.get(resolvedPath);
+        }
+        // Transpile and evaluate the module
+        const transpiledCode = transpileFile(resolvedPath, projectRoot);
+        const moduleDir = path.dirname(resolvedPath);
+        const mockModule = { exports: {} };
+        // Create require function bound to the module's directory
+        const boundRequire = (spec) => customRequire(spec, moduleDir);
+        const context = vm.createContext({
+            exports: mockModule.exports,
+            module: mockModule,
+            require: boundRequire,
+            __filename: resolvedPath,
+            __dirname: moduleDir,
+            console: console,
+            process: process,
+        });
+        // Cache before evaluation to handle circular dependencies
+        moduleCache.set(resolvedPath, mockModule.exports);
+        const script = new vm.Script(transpiledCode, { filename: resolvedPath });
+        script.runInContext(context);
+        // Update cache with final exports (in case module.exports was reassigned)
+        moduleCache.set(resolvedPath, mockModule.exports);
+        return mockModule.exports;
+    }
+    // Evaluate the entry module
+    const exports = customRequire(filePath, path.dirname(filePath));
+    const widgetVariants = exports.default || exports;
+    if (!widgetVariants || typeof widgetVariants !== 'object') {
+        throw new Error('Widget file must export a WidgetVariants object or have a default export of WidgetVariants');
+    }
+    return widgetVariants;
+}
+/**
+ * Prerender widget initial states for build-time inclusion.
+ *
+ * Widget code is transpiled with Babel and executed in a Node.js VM sandbox.
+ * This function loads widget files that export WidgetVariants for widgets with initialStatePath configured,
+ * renders them to JSON, and returns a map of prerendered states that can be bundled into the app.
+ *
+ * @param widgets - Array of widget configurations
+ * @param projectRoot - Root directory of the Expo project
+ * @param renderer - The renderer function to use (voltra/server or voltra/android/server)
+ * @returns Map of widgetId -> prerendered widget state as JSON string
+ */
+export async function prerenderWidgetState(widgets, projectRoot, renderer) {
+    const prerenderedStates = new Map();
+    for (const widget of widgets) {
+        if (!widget.initialStatePath) {
+            continue;
+        }
+        try {
+            // Resolve the absolute path to the widget file
+            const absoluteWidgetPath = path.resolve(projectRoot, widget.initialStatePath);
+            // Evaluate the module (transpiles with Babel and executes in VM)
+            const widgetVariants = evaluateWidgetModule(projectRoot, absoluteWidgetPath);
+            // Render the widget variants to a JSON string
+            const prerenderedState = renderer(widgetVariants);
+            prerenderedStates.set(widget.id, prerenderedState);
+        }
+        catch (error) {
+            throw new Error(`Failed to prerender widget state for ${widget.id} (${widget.initialStatePath}): ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return prerenderedStates;
+}
+//# sourceMappingURL=prerender.js.map

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

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

package/build/esm/utils/urlScheme.js

@@ -0,0 +1,37 @@
+/**
+ * Ensures the main app has a URL scheme set so widgetURL can open it.
+ * This is an optional feature for deep linking from widgets.
+ *
+ * @param config - The Expo config object
+ * @returns The modified config with URL scheme ensured
+ */
+export function ensureURLScheme(config) {
+    const scheme = typeof config.scheme === 'string' ? config.scheme : config.ios?.bundleIdentifier;
+    if (!scheme) {
+        return config;
+    }
+    const existingInfoPlist = config.ios?.infoPlist || {};
+    const existingTypes = existingInfoPlist.CFBundleURLTypes || [];
+    // Check if scheme already exists
+    const hasScheme = existingTypes.some((t) => Array.isArray(t?.CFBundleURLSchemes) && t.CFBundleURLSchemes.includes(scheme));
+    if (hasScheme) {
+        return config;
+    }
+    // Add the URL scheme
+    return {
+        ...config,
+        ios: {
+            ...config.ios,
+            infoPlist: {
+                ...existingInfoPlist,
+                CFBundleURLTypes: [
+                    ...existingTypes,
+                    {
+                        CFBundleURLSchemes: [scheme],
+                    },
+                ],
+            },
+        },
+    };
+}
+//# sourceMappingURL=urlScheme.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"urlScheme.js","sourceRoot":"","sources":["../../../src/utils/urlScheme.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,MAAkB;IAChD,MAAM,MAAM,GAAG,OAAQ,MAAc,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAE,MAAc,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,gBAAgB,CAAA;IAEjH,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,MAAM,CAAA;IACf,CAAC;IAED,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,EAAE,SAAS,IAAI,EAAE,CAAA;IACrD,MAAM,aAAa,GAAI,iBAAiB,CAAC,gBAA0B,IAAI,EAAE,CAAA;IAEzE,iCAAiC;IACjC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,CACrF,CAAA;IAED,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,MAAM,CAAA;IACf,CAAC;IAED,qBAAqB;IACrB,OAAO;QACL,GAAG,MAAM;QACT,GAAG,EAAE;YACH,GAAG,MAAM,CAAC,GAAG;YACb,SAAS,EAAE;gBACT,GAAG,iBAAiB;gBACpB,gBAAgB,EAAE;oBAChB,GAAG,aAAa;oBAChB;wBACE,kBAAkB,EAAE,CAAC,MAAM,CAAC;qBAC7B;iBACF;aACF;SACF;KACF,CAAA;AACH,CAAC"}

package/build/esm/validation.js

@@ -0,0 +1,193 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Validation functions for the Voltra plugin
+ */
+// ============================================================================
+// iOS Widget Validation
+// ============================================================================
+const VALID_FAMILIES = new Set([
+    'systemSmall',
+    'systemMedium',
+    'systemLarge',
+    'systemExtraLarge',
+    'accessoryCircular',
+    'accessoryRectangular',
+    'accessoryInline',
+]);
+/**
+ * Validates a widget configuration.
+ * Throws an error if validation fails.
+ */
+export function validateWidgetConfig(widget) {
+    // Validate widget ID
+    if (!widget.id || typeof widget.id !== 'string') {
+        throw new Error('Widget ID is required and must be a string');
+    }
+    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(widget.id)) {
+        throw new Error(`Widget ID '${widget.id}' is invalid. ` +
+            'Must start with a letter or underscore and contain only alphanumeric characters and underscores.');
+    }
+    // Validate display name
+    if (!widget.displayName?.trim()) {
+        throw new Error(`Widget '${widget.id}': displayName is required`);
+    }
+    // Validate description
+    if (!widget.description?.trim()) {
+        throw new Error(`Widget '${widget.id}': description is required`);
+    }
+    // Validate supported families if provided
+    if (widget.supportedFamilies) {
+        if (!Array.isArray(widget.supportedFamilies)) {
+            throw new Error(`Widget '${widget.id}': supportedFamilies must be an array`);
+        }
+        for (const family of widget.supportedFamilies) {
+            if (!VALID_FAMILIES.has(family)) {
+                throw new Error(`Widget '${widget.id}': Invalid widget family '${family}'. ` +
+                    `Valid families are: ${Array.from(VALID_FAMILIES).join(', ')}`);
+            }
+        }
+    }
+}
+// ============================================================================
+// Android Widget Validation
+// ============================================================================
+/**
+ * Validates an Android widget configuration.
+ * Throws an error if validation fails.
+ */
+export function validateAndroidWidgetConfig(widget, projectRoot) {
+    // Validate widget ID
+    if (!widget.id || typeof widget.id !== 'string') {
+        throw new Error('Widget ID is required and must be a string');
+    }
+    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(widget.id)) {
+        throw new Error(`Widget ID '${widget.id}' is invalid. ` +
+            'Must start with a letter or underscore and contain only alphanumeric characters and underscores.');
+    }
+    // Validate display name
+    if (!widget.displayName?.trim()) {
+        throw new Error(`Widget '${widget.id}': displayName is required`);
+    }
+    // Validate description
+    if (!widget.description?.trim()) {
+        throw new Error(`Widget '${widget.id}': description is required`);
+    }
+    // Validate targetCellWidth
+    if (typeof widget.targetCellWidth !== 'number') {
+        throw new Error(`Widget '${widget.id}': targetCellWidth is required and must be a number`);
+    }
+    if (!Number.isInteger(widget.targetCellWidth) || widget.targetCellWidth < 1) {
+        throw new Error(`Widget '${widget.id}': targetCellWidth must be a positive integer (typically 1-5)`);
+    }
+    // Validate targetCellHeight
+    if (typeof widget.targetCellHeight !== 'number') {
+        throw new Error(`Widget '${widget.id}': targetCellHeight is required and must be a number`);
+    }
+    if (!Number.isInteger(widget.targetCellHeight) || widget.targetCellHeight < 1) {
+        throw new Error(`Widget '${widget.id}': targetCellHeight must be a positive integer (typically 1-5)`);
+    }
+    // Validate minCellWidth if provided
+    if (widget.minCellWidth !== undefined) {
+        if (typeof widget.minCellWidth !== 'number' || !Number.isInteger(widget.minCellWidth) || widget.minCellWidth < 1) {
+            throw new Error(`Widget '${widget.id}': minCellWidth must be a positive integer`);
+        }
+    }
+    // Validate minCellHeight if provided
+    if (widget.minCellHeight !== undefined) {
+        if (typeof widget.minCellHeight !== 'number' ||
+            !Number.isInteger(widget.minCellHeight) ||
+            widget.minCellHeight < 1) {
+            throw new Error(`Widget '${widget.id}': minCellHeight must be a positive integer`);
+        }
+    }
+    // Validate previewImage if provided
+    if (widget.previewImage !== undefined) {
+        if (typeof widget.previewImage !== 'string' || !widget.previewImage.trim()) {
+            throw new Error(`Widget '${widget.id}': previewImage must be a non-empty string`);
+        }
+        const ext = path.extname(widget.previewImage).toLowerCase();
+        const validImageExts = ['.png', '.jpg', '.jpeg', '.webp'];
+        if (!validImageExts.includes(ext)) {
+            throw new Error(`Widget '${widget.id}': previewImage must be a PNG, JPG, JPEG, or WebP file. Got: ${ext}`);
+        }
+        // Check file exists if projectRoot is provided
+        if (projectRoot) {
+            const fullPath = path.join(projectRoot, widget.previewImage);
+            if (!fs.existsSync(fullPath)) {
+                throw new Error(`Widget '${widget.id}': previewImage file not found at ${widget.previewImage}`);
+            }
+        }
+    }
+    // Validate previewLayout if provided
+    if (widget.previewLayout !== undefined) {
+        if (typeof widget.previewLayout !== 'string' || !widget.previewLayout.trim()) {
+            throw new Error(`Widget '${widget.id}': previewLayout must be a non-empty string`);
+        }
+        const ext = path.extname(widget.previewLayout).toLowerCase();
+        if (ext !== '.xml') {
+            throw new Error(`Widget '${widget.id}': previewLayout must be an XML file. Got: ${ext}`);
+        }
+        // Check file exists if projectRoot is provided
+        if (projectRoot) {
+            const fullPath = path.join(projectRoot, widget.previewLayout);
+            if (!fs.existsSync(fullPath)) {
+                throw new Error(`Widget '${widget.id}': previewLayout file not found at ${widget.previewLayout}`);
+            }
+        }
+    }
+}
+// ============================================================================
+// Plugin Props Validation
+// ============================================================================
+/**
+ * Validates the plugin props at entry point.
+ * Throws an error if validation fails.
+ */
+export function validateProps(props) {
+    // Validate group identifier format if provided
+    if (props.groupIdentifier !== undefined) {
+        if (typeof props.groupIdentifier !== 'string') {
+            throw new Error('groupIdentifier must be a string');
+        }
+        if (!props.groupIdentifier.startsWith('group.')) {
+            throw new Error(`groupIdentifier '${props.groupIdentifier}' must start with 'group.'`);
+        }
+    }
+    // Validate iOS widgets if provided
+    if (props.widgets !== undefined) {
+        if (!Array.isArray(props.widgets)) {
+            throw new Error('widgets must be an array');
+        }
+        // Check for duplicate widget IDs
+        const seenIds = new Set();
+        for (const widget of props.widgets) {
+            validateWidgetConfig(widget);
+            if (seenIds.has(widget.id)) {
+                throw new Error(`Duplicate widget ID: '${widget.id}'`);
+            }
+            seenIds.add(widget.id);
+        }
+    }
+    // Validate Android configuration if provided
+    if (props.android !== undefined) {
+        if (typeof props.android !== 'object' || props.android === null) {
+            throw new Error('android configuration must be an object');
+        }
+        if (props.android.widgets !== undefined) {
+            if (!Array.isArray(props.android.widgets)) {
+                throw new Error('android.widgets must be an array');
+            }
+            // Check for duplicate widget IDs
+            const seenIds = new Set();
+            for (const widget of props.android.widgets) {
+                validateAndroidWidgetConfig(widget);
+                if (seenIds.has(widget.id)) {
+                    throw new Error(`Duplicate Android widget ID: '${widget.id}'`);
+                }
+                seenIds.add(widget.id);
+            }
+        }
+    }
+}
+//# sourceMappingURL=validation.js.map

package/build/esm/validation.js.map

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

package/build/types/android/files/assets.d.ts

@@ -0,0 +1,26 @@
+import type { AndroidWidgetConfig } from '../../types';
+export interface GenerateAndroidAssetsOptions {
+    platformProjectRoot: string;
+    projectRoot: string;
+    userImagesPath?: string;
+    widgets: AndroidWidgetConfig[];
+}
+/**
+ * Generates all asset files for Android widgets.
+ *
+ * This creates:
+ * - res/drawable/ directory structure
+ * - Copies user images to drawable resources as Android-compatible resources
+ * - Copies widget preview images to drawable resources
+ * - Validates image sizes for widget compatibility
+ *
+ * @returns Map of widgetId to preview image drawable resource name
+ */
+export declare function generateAndroidAssets(options: GenerateAndroidAssetsOptions): Promise<Map<string, string>>;
+/**
+ * Copies preview images to Android drawable resources.
+ * Returns a map of widgetId to drawable resource name.
+ */
+declare function copyPreviewImagesToAndroid(widgets: AndroidWidgetConfig[], projectRoot: string, drawablePath: string): Promise<Map<string, string>>;
+export { copyPreviewImagesToAndroid };
+//# sourceMappingURL=assets.d.ts.map

package/build/types/android/files/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../../src/android/files/assets.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAGtD,MAAM,WAAW,4BAA4B;IAC3C,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,OAAO,EAAE,mBAAmB,EAAE,CAAA;CAC/B;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiD/G;AAgKD;;;GAGG;AACH,iBAAe,0BAA0B,CACvC,OAAO,EAAE,mBAAmB,EAAE,EAC9B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAqC9B;AAED,OAAO,EAAE,0BAA0B,EAAE,CAAA"}

package/build/types/android/files/fonts.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Font configuration for Android widgets.
+ *
+ * Copies custom font files to the Android assets/fonts/ directory
+ * so they can be loaded by TextBitmapRenderer via Typeface.createFromAsset().
+ */
+export interface CopyAndroidFontsOptions {
+    platformProjectRoot: string;
+    projectRoot: string;
+    fonts: string[];
+}
+/**
+ * Copies custom font files to android/app/src/main/assets/fonts/.
+ *
+ * Resolves each path relative to the project root.
+ * If a path points to a directory, all .ttf/.otf files inside it are copied.
+ */
+export declare function copyAndroidFonts(options: CopyAndroidFontsOptions): Promise<void>;
+//# sourceMappingURL=fonts.d.ts.map

package/build/types/android/files/fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../../../../src/android/files/fonts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBtF"}

package/build/types/android/files/index.d.ts

@@ -0,0 +1,21 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+import type { AndroidWidgetConfig } from '../../types';
+export interface GenerateAndroidWidgetFilesProps {
+    widgets: AndroidWidgetConfig[];
+    userImagesPath?: string;
+    fonts?: string[];
+}
+/**
+ * Plugin step that generates all Android widget files.
+ *
+ * This creates:
+ * - Kotlin receiver classes for each widget
+ * - res/xml/{widget_id}_info.xml (widget provider info)
+ * - res/layout/voltra_widget_placeholder.xml (placeholder layout)
+ * - res/values/voltra_widgets.xml (widget descriptions)
+ * - res/drawable/ images (user images as drawable resources)
+ *
+ * This should run before configureAndroidManifest so the files exist when the manifest is configured.
+ */
+export declare const generateAndroidWidgetFiles: ConfigPlugin<GenerateAndroidWidgetFilesProps>;
+//# sourceMappingURL=index.d.ts.map

package/build/types/android/files/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/android/files/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAoB,MAAM,sBAAsB,CAAA;AAErE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAOtD,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,mBAAmB,EAAE,CAAA;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,EAAE,YAAY,CAAC,+BAA+B,CAsEpF,CAAA"}

package/build/types/android/files/initialStates.d.ts

@@ -0,0 +1,14 @@
+import type { AndroidWidgetConfig } from '../../types';
+export interface GenerateInitialStatesOptions {
+    widgets: AndroidWidgetConfig[];
+    projectRoot: string;
+    platformProjectRoot: string;
+}
+/**
+ * Generates the initial states JSON file for Android widgets.
+ *
+ * This file (voltra_initial_states.json) is placed in the Android assets directory
+ * and contains the pre-rendered payloads for all widgets that have an initialStatePath.
+ */
+export declare function generateAndroidInitialStates(options: GenerateInitialStatesOptions): Promise<void>;
+//# sourceMappingURL=initialStates.d.ts.map

package/build/types/android/files/initialStates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialStates.d.ts","sourceRoot":"","sources":["../../../../src/android/files/initialStates.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAItD,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,mBAAmB,EAAE,CAAA;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAID;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCvG"}

package/build/types/android/files/kotlin.d.ts

@@ -0,0 +1,11 @@
+import type { AndroidWidgetConfig } from '../../types';
+export interface GenerateKotlinFilesProps {
+    platformProjectRoot: string;
+    packageName: string;
+    widgets: AndroidWidgetConfig[];
+}
+/**
+ * Generates Kotlin receiver classes for all configured widgets
+ */
+export declare function generateWidgetReceivers(props: GenerateKotlinFilesProps): Promise<void>;
+//# sourceMappingURL=kotlin.d.ts.map

package/build/types/android/files/kotlin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kotlin.d.ts","sourceRoot":"","sources":["../../../../src/android/files/kotlin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD,MAAM,WAAW,wBAAwB;IACvC,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,mBAAmB,EAAE,CAAA;CAC/B;AAMD;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB5F"}

package/build/types/android/files/xml.d.ts

@@ -0,0 +1,25 @@
+import type { AndroidWidgetConfig } from '../../types';
+export interface GenerateXmlFilesProps {
+    platformProjectRoot: string;
+    projectRoot: string;
+    widgets: AndroidWidgetConfig[];
+    previewImageMap: Map<string, string>;
+}
+/**
+ * Generates widget info XML files for all widgets
+ */
+export declare function generateWidgetInfoFiles(props: {
+    platformProjectRoot: string;
+    widgets: AndroidWidgetConfig[];
+}): Promise<void>;
+/**
+ * Generates placeholder layout XML
+ */
+export declare function generateWidgetPlaceholderLayouts(props: {
+    platformProjectRoot: string;
+}): Promise<void>;
+/**
+ * Generates preview layouts for widgets
+ */
+export declare function generateWidgetPreviewLayouts(props: GenerateXmlFilesProps): Promise<void>;
+//# sourceMappingURL=xml.d.ts.map

package/build/types/android/files/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../../../src/android/files/xml.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAGtD,MAAM,WAAW,qBAAqB;IACpC,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,mBAAmB,EAAE,CAAA;IAC9B,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC;AAMD;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,mBAAmB,EAAE,MAAM,CAAA;IAC3B,OAAO,EAAE,mBAAmB,EAAE,CAAA;CAC/B,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhB;AAED;;GAEG;AACH,wBAAsB,gCAAgC,CAAC,KAAK,EAAE;IAAE,mBAAmB,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAU5G;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB9F"}

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

@@ -0,0 +1,12 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+import type { AndroidPluginProps } from '../types';
+/**
+ * Main Android configuration plugin.
+ *
+ * This orchestrates all Android-related configuration in the correct order:
+ * 1. Validate widget configurations with file existence checks
+ * 2. Generate widget files (Kotlin receivers, XML metadata, resources)
+ * 3. Configure AndroidManifest (receiver entries)
+ */
+export declare const withAndroid: ConfigPlugin<AndroidPluginProps>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/android/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAe,MAAM,sBAAsB,CAAA;AAEhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAKlD;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,YAAY,CAAC,kBAAkB,CAsBxD,CAAA"}

package/build/types/android/manifest.d.ts

@@ -0,0 +1,15 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+import type { AndroidWidgetConfig } from '../types';
+export interface ConfigureAndroidManifestProps {
+    widgets: AndroidWidgetConfig[];
+}
+/**
+ * Plugin step that adds widget receiver entries to AndroidManifest.xml
+ *
+ * This adds a <receiver> entry for each widget with:
+ * - The generated receiver class name
+ * - APPWIDGET_UPDATE intent filter
+ * - Widget provider metadata reference
+ */
+export declare const configureAndroidManifest: ConfigPlugin<ConfigureAndroidManifestProps>;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/android/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,sBAAsB,CAAA;AAGxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAEnD,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,mBAAmB,EAAE,CAAA;CAC/B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,EAAE,YAAY,CAAC,6BAA6B,CAsDhF,CAAA"}