nativine 1.0.2

package/dist/modules/pedometer.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Pedometer / Step Counter Module
+ *
+ * Access the device's built-in step counter sensor to track steps.
+ * Uses Android's TYPE_STEP_COUNTER hardware sensor.
+ * Requires ACTIVITY_RECOGNITION permission on Android 10+.
+ */
+export interface StepCountResult {
+    /** Number of steps since tracking started */
+    steps: number;
+}
+export interface PedometerAvailability {
+    /** Whether the device has a step counter sensor */
+    available: boolean;
+}
+/**
+ * Check if the device has a step counter sensor.
+ *
+ * @returns Promise resolving with availability info
+ *
+ * @example
+ * ```js
+ * const { available } = await nativine.pedometer.isAvailable();
+ * if (available) {
+ *   nativine.pedometer.startTracking();
+ * }
+ * ```
+ */
+export declare function isAvailable(): Promise<PedometerAvailability>;
+/**
+ * Get the current step count since tracking started.
+ * Returns 0 if tracking hasn't been started yet.
+ *
+ * @returns Promise resolving with the step count
+ *
+ * @example
+ * ```js
+ * const { steps } = await nativine.pedometer.getStepCount();
+ * console.log(`You've taken ${steps} steps`);
+ * ```
+ */
+export declare function getStepCount(): Promise<StepCountResult>;
+/**
+ * Start tracking steps. The step count resets to 0 when tracking begins.
+ * Step updates are dispatched as 'stepUpdate' events via `nativine.on()`.
+ *
+ * @example
+ * ```js
+ * nativine.pedometer.startTracking();
+ *
+ * // Listen for real-time step updates
+ * nativine.on('stepUpdate', ({ steps }) => {
+ *   document.getElementById('step-count').textContent = steps;
+ * });
+ * ```
+ */
+export declare function startTracking(): void;
+/**
+ * Stop tracking steps. The sensor listener is unregistered to save battery.
+ *
+ * @example
+ * ```js
+ * nativine.pedometer.stopTracking();
+ * ```
+ */
+export declare function stopTracking(): void;

package/dist/modules/print.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Print Module
+ *
+ * Trigger native print dialog for the current page.
+ */
+/**
+ * Open the native print dialog for the current WebView content.
+ *
+ * @example
+ * ```js
+ * nativine.print();
+ * ```
+ */
+export declare function printPage(): void;

package/dist/modules/reviews.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Reviews Module
+ *
+ * Trigger the native in-app review dialog (Google Play / App Store).
+ */
+/**
+ * Request an in-app review from the user.
+ * Uses Google Play In-App Review API (Android) or StoreKit (iOS).
+ *
+ * Note: The system may not show the dialog if the user has already reviewed
+ * or if the request is too frequent. This is controlled by the platform.
+ *
+ * @example
+ * ```js
+ * // After a positive user interaction
+ * nativine.reviews.request();
+ * ```
+ */
+export declare function request(): void;

package/dist/modules/screenshot.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Screenshot Module
+ *
+ * Control screenshot protection (prevent screenshots of sensitive screens).
+ */
+/**
+ * Enable or disable screenshot/screen recording protection.
+ * When enabled, the app content appears black in screenshots and screen recordings.
+ *
+ * @param enabled - Whether to enable screenshot protection
+ *
+ * @example
+ * ```js
+ * // Protect a banking page
+ * nativine.screenshot.setProtection(true);
+ *
+ * // Remove protection when leaving
+ * nativine.screenshot.setProtection(false);
+ * ```
+ */
+export declare function setProtection(enabled: boolean): void;

package/dist/modules/share.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Share Module
+ *
+ * Trigger the native share sheet to share text, URLs, and files.
+ */
+export interface ShareOptions {
+    /** Title for the share sheet (Android) */
+    title?: string;
+    /** Text content to share */
+    text?: string;
+    /** URL to share */
+    url?: string;
+}
+export interface ShareFileOptions {
+    /** Absolute file path or content:// URI */
+    filePath: string;
+    /** MIME type of the file */
+    mimeType?: string;
+    /** Title for the share sheet */
+    title?: string;
+}
+/**
+ * Open the native share sheet with the specified content.
+ *
+ * @example
+ * ```js
+ * nativine.share.share({
+ *   title: 'Check this out',
+ *   text: 'Amazing app!',
+ *   url: 'https://example.com'
+ * });
+ * ```
+ */
+export declare function share(options: ShareOptions): void;
+/**
+ * Share a file using the native share sheet.
+ *
+ * @example
+ * ```js
+ * nativine.share.shareFile({
+ *   filePath: '/storage/emulated/0/Download/report.pdf',
+ *   mimeType: 'application/pdf'
+ * });
+ * ```
+ */
+export declare function shareFile(options: ShareFileOptions): void;

package/dist/modules/storage.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Storage Module
+ *
+ * Persistent key-value storage that survives WebView cache clears.
+ * Data is stored in Android SharedPreferences / iOS UserDefaults,
+ * not in the WebView's localStorage.
+ */
+/**
+ * Store a value persistently in native storage.
+ * This data persists even when the WebView cache is cleared.
+ *
+ * @param key - The storage key
+ * @param value - The value to store (will be serialized to string)
+ *
+ * @example
+ * ```js
+ * await nativine.storage.set('auth_token', 'abc123');
+ * await nativine.storage.set('user', JSON.stringify({ name: 'John' }));
+ * ```
+ */
+export declare function set(key: string, value: string): void;
+/**
+ * Retrieve a value from native persistent storage.
+ *
+ * @param key - The storage key
+ * @param defaultValue - Value to return if key doesn't exist (default: '')
+ * @returns The stored value, or defaultValue if not found
+ *
+ * @example
+ * ```js
+ * const token = nativine.storage.get('auth_token');
+ * const user = JSON.parse(nativine.storage.get('user', '{}'));
+ * ```
+ */
+export declare function get(key: string, defaultValue?: string): string;
+/**
+ * Remove a specific key from native persistent storage.
+ *
+ * @param key - The storage key to remove
+ *
+ * @example
+ * ```js
+ * nativine.storage.remove('auth_token');
+ * ```
+ */
+export declare function remove(key: string): void;
+/**
+ * Clear all data from native persistent storage.
+ *
+ * @example
+ * ```js
+ * // On logout
+ * nativine.storage.clear();
+ * ```
+ */
+export declare function clear(): void;

package/dist/modules/toast.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Toast Module
+ *
+ * Show native Android toast messages.
+ */
+export type ToastDuration = 'short' | 'long';
+/**
+ * Show a native toast message.
+ *
+ * @param message - The text to display
+ * @param duration - 'short' (~2s) or 'long' (~3.5s)
+ *
+ * @example
+ * ```js
+ * nativine.toast('Item added to cart!');
+ * nativine.toast('Processing payment...', 'long');
+ * ```
+ */
+export declare function showToast(message: string, duration?: ToastDuration): void;

package/dist/modules/ui.d.ts

@@ -0,0 +1,109 @@
+/**
+ * UI Module
+ *
+ * Control native UI elements: status bar, navigation bar, splash screen,
+ * screen orientation, and native component visibility.
+ */
+export interface StatusBarOptions {
+    /** Hex color for the status bar background (e.g., "#1a1a2e") */
+    color?: string;
+    /** Content style: 'light' for white icons, 'dark' for dark icons */
+    style?: 'light' | 'dark';
+    /** Whether the status bar should be visible */
+    visible?: boolean;
+}
+export interface NavigationBarOptions {
+    /** Hex color for the navigation bar background (e.g., "#16213e") */
+    color?: string;
+    /** Icon style: 'light' for white icons, 'dark' for dark icons */
+    style?: 'light' | 'dark';
+}
+/**
+ * Configure the native status bar appearance.
+ *
+ * @example
+ * ```js
+ * nativine.ui.statusBar({ color: '#1a1a2e', style: 'light' });
+ * ```
+ */
+export declare function statusBar(options: StatusBarOptions): void;
+/**
+ * Configure the native navigation bar appearance (Android only).
+ *
+ * @example
+ * ```js
+ * nativine.ui.navigationBar({ color: '#16213e' });
+ * ```
+ */
+export declare function navigationBar(options: NavigationBarOptions): void;
+/**
+ * Programmatically hide the splash screen.
+ * Useful when your web app needs time to load data before revealing the UI.
+ *
+ * @example
+ * ```js
+ * await fetchInitialData();
+ * nativine.ui.hideSplashScreen();
+ * ```
+ */
+export declare function hideSplashScreen(): void;
+/**
+ * Lock the screen to a specific orientation.
+ *
+ * @param mode - 'portrait' | 'landscape' | 'auto'
+ *
+ * @example
+ * ```js
+ * // Lock to landscape for a video player
+ * nativine.ui.setOrientation('landscape');
+ *
+ * // Unlock when done
+ * nativine.ui.setOrientation('auto');
+ * ```
+ */
+export declare function setOrientation(mode: 'portrait' | 'landscape' | 'auto'): void;
+/**
+ * Show native UI components (header, bottom nav, floating button).
+ * Reverses the effect of `hideNativeComponents()`.
+ *
+ * @example
+ * ```js
+ * nativine.ui.showNativeComponents();
+ * ```
+ */
+export declare function showNativeComponents(): void;
+/**
+ * Hide all native UI components (header, bottom nav, floating button).
+ * Useful for fullscreen content like videos or immersive experiences.
+ *
+ * @example
+ * ```js
+ * // Enter fullscreen mode
+ * nativine.ui.hideNativeComponents();
+ * ```
+ */
+export declare function hideNativeComponents(): void;
+/**
+ * Toggle pull-to-refresh behavior.
+ *
+ * @param enabled - Whether pull-to-refresh should be enabled
+ *
+ * @example
+ * ```js
+ * // Disable on a page with custom scroll behavior
+ * nativine.ui.setPullToRefresh(false);
+ * ```
+ */
+export declare function setPullToRefresh(enabled: boolean): void;
+/**
+ * Toggle pinch-to-zoom behavior.
+ *
+ * @param enabled - Whether pinch-to-zoom should be enabled
+ *
+ * @example
+ * ```js
+ * // Enable for an image gallery
+ * nativine.ui.setPinchToZoom(true);
+ * ```
+ */
+export declare function setPinchToZoom(enabled: boolean): void;

package/dist/modules/updates.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Updates Module
+ *
+ * Check for and trigger in-app updates (Android only).
+ */
+/**
+ * Check for available app updates using the Android In-App Update API.
+ * If an update is available, a native update UI will be shown.
+ *
+ * @example
+ * ```js
+ * nativine.updates.check();
+ * ```
+ */
+export declare function check(): void;