@flightdev/mobile 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Flight Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,184 @@
+# @flight-framework/mobile
+
+Mobile app support for Flight Framework via Capacitor. Build iOS and Android apps with the same codebase.
+
+## Philosophy
+
+**Flight doesn't impose** - install only the Capacitor plugins you need. All plugins are optional peer dependencies. Hooks gracefully degrade on web.
+
+## Features
+
+- **Cross-platform** - iOS, Android, and Web from one codebase
+- **React hooks** - usePlatform, useCamera, useGeolocation, and more
+- **Vue composables** - Reactive wrappers with automatic cleanup
+- **Plugin freedom** - Install only what you need
+- **Web fallback** - Graceful degradation, no errors
+
+## Installation
+
+```bash
+# Core package
+npm install @flight-framework/mobile
+
+# Install Capacitor (required for native)
+npm install @capacitor/core @capacitor/cli
+
+# Install only the plugins you need
+npm install @capacitor/camera          # Optional
+npm install @capacitor/geolocation     # Optional
+npm install @capacitor/push-notifications # Optional
+npm install @capacitor/haptics         # Optional
+npm install @capacitor/preferences     # Optional
+```
+
+## Quick Start
+
+### React
+
+```tsx
+import { usePlatform, useCamera, useGeolocation } from '@flight-framework/mobile/react';
+
+function App() {
+    const { isNative, isIOS, isAndroid } = usePlatform();
+    const { takePhoto, available: cameraAvailable } = useCamera();
+    const { position, getCurrentPosition } = useGeolocation();
+    
+    return (
+        <div>
+            <p>Platform: {isIOS ? 'iOS' : isAndroid ? 'Android' : 'Web'}</p>
+            
+            {cameraAvailable && (
+                <button onClick={() => takePhoto()}>Take Photo</button>
+            )}
+            
+            <button onClick={getCurrentPosition}>Get Location</button>
+            {position && <p>Lat: {position.coords.latitude}</p>}
+        </div>
+    );
+}
+```
+
+### Vue
+
+```vue
+<script setup>
+import { usePlatform, useCamera, useGeolocation } from '@flight-framework/mobile/vue';
+
+const { isNative, isIOS } = usePlatform();
+const { takePhoto, available } = useCamera();
+const { position, getCurrentPosition, loading } = useGeolocation();
+</script>
+
+<template>
+    <p>Platform: {{ isIOS ? 'iOS' : 'Web' }}</p>
+    <button v-if="available" @click="takePhoto">Take Photo</button>
+    <button @click="getCurrentPosition">Get Location</button>
+</template>
+```
+
+## Hooks
+
+### usePlatform
+
+Detect current platform.
+
+```typescript
+const { platform, isNative, isIOS, isAndroid, isWeb } = usePlatform();
+```
+
+### useCamera
+
+Take photos and pick images.
+
+```typescript
+const { takePhoto, pickImage, available } = useCamera();
+
+const photo = await takePhoto({ quality: 90 });
+const image = await pickImage();
+```
+
+### useGeolocation
+
+Get device location.
+
+```typescript
+const { position, error, loading, getCurrentPosition, watchPosition } = useGeolocation();
+
+await getCurrentPosition();
+console.log(position.coords.latitude, position.coords.longitude);
+```
+
+### usePushNotifications
+
+Handle push notifications.
+
+```typescript
+const { token, requestPermission, onNotificationReceived } = usePushNotifications();
+
+await requestPermission();
+console.log('FCM Token:', token);
+```
+
+### useHaptics
+
+Haptic feedback.
+
+```typescript
+const { impact, notification, vibrate } = useHaptics();
+
+await impact('medium');
+await notification('success');
+await vibrate(300);
+```
+
+### useStorage
+
+Secure key-value storage.
+
+```typescript
+const { get, set, remove } = useStorage();
+
+await set('theme', 'dark');
+const theme = await get('theme');
+```
+
+## Configuration
+
+Create `capacitor.config.ts`:
+
+```typescript
+import { defineCapacitorConfig } from '@flight-framework/mobile/config';
+
+export default defineCapacitorConfig({
+    appId: 'com.example.myapp',
+    appName: 'My App',
+    webDir: 'dist',
+    plugins: {
+        PushNotifications: {
+            presentationOptions: ['badge', 'sound', 'alert'],
+        },
+    },
+});
+```
+
+## Build Commands
+
+```bash
+# Add platforms
+npx cap add ios
+npx cap add android
+
+# Build web assets
+npm run build
+
+# Sync to native projects
+npx cap sync
+
+# Open native IDE
+npx cap open ios
+npx cap open android
+```
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Capacitor configuration helper.
+ * Creates type-safe configuration for mobile builds.
+ */
+interface MobileConfig {
+    /** Bundle identifier (com.example.app) */
+    appId: string;
+    /** Display name of the app */
+    appName: string;
+    /** Directory containing the web assets (default: dist) */
+    webDir?: string;
+    /** Server configuration for live reload */
+    server?: {
+        url?: string;
+        cleartext?: boolean;
+    };
+    /** iOS-specific configuration */
+    ios?: {
+        /** Path to iOS project (default: ios) */
+        path?: string;
+        /** Scheme for deep links */
+        scheme?: string;
+        /** Content inset mode */
+        contentInset?: 'always' | 'scrollable' | 'automatic' | 'never';
+        /** Background color of web view */
+        backgroundColor?: string;
+        /** Preferred content mode */
+        preferredContentMode?: 'mobile' | 'desktop' | 'recommended';
+    };
+    /** Android-specific configuration */
+    android?: {
+        /** Path to Android project (default: android) */
+        path?: string;
+        /** Flavor for build variants */
+        flavor?: string;
+        /** Background color of web view */
+        backgroundColor?: string;
+        /** Allow mixed content */
+        allowMixedContent?: boolean;
+        /** Initial focus on web view */
+        initialFocus?: boolean;
+    };
+    /** Plugin configurations */
+    plugins?: {
+        /** Push notifications config */
+        PushNotifications?: {
+            presentationOptions?: ('badge' | 'sound' | 'alert')[];
+        };
+        /** Splash screen config */
+        SplashScreen?: {
+            launchShowDuration?: number;
+            launchAutoHide?: boolean;
+            launchFadeOutDuration?: number;
+            backgroundColor?: string;
+            androidSplashResourceName?: string;
+            androidScaleType?: 'CENTER' | 'CENTER_CROP' | 'CENTER_INSIDE' | 'FIT_CENTER' | 'FIT_XY';
+            showSpinner?: boolean;
+            spinnerStyle?: 'horizontal' | 'small' | 'large';
+            spinnerColor?: string;
+        };
+        /** Local notifications config */
+        LocalNotifications?: {
+            smallIcon?: string;
+            iconColor?: string;
+            sound?: string;
+        };
+        /** Keyboard config */
+        Keyboard?: {
+            resize?: 'body' | 'ionic' | 'native' | 'none';
+            style?: 'dark' | 'light' | 'default';
+            resizeOnFullScreen?: boolean;
+        };
+    };
+}
+/**
+ * Create a Capacitor configuration.
+ *
+ * Use this in your capacitor.config.ts file:
+ *
+ * @example
+ * ```typescript
+ * // capacitor.config.ts
+ * import { defineCapacitorConfig } from '@flightdev/mobile/config';
+ *
+ * export default defineCapacitorConfig({
+ *     appId: 'com.example.myapp',
+ *     appName: 'My App',
+ *     webDir: 'dist',
+ *     plugins: {
+ *         PushNotifications: {
+ *             presentationOptions: ['badge', 'sound', 'alert'],
+ *         },
+ *     },
+ * });
+ * ```
+ */
+declare function defineCapacitorConfig(config: MobileConfig): {
+    appId: string;
+    appName: string;
+    webDir: string;
+    server: {
+        url?: string;
+        cleartext?: boolean;
+    } | undefined;
+    ios: {
+        path: string;
+        scheme?: string;
+        contentInset?: "always" | "scrollable" | "automatic" | "never";
+        backgroundColor?: string;
+        preferredContentMode?: "mobile" | "desktop" | "recommended";
+    };
+    android: {
+        path: string;
+        flavor?: string;
+        backgroundColor?: string;
+        allowMixedContent?: boolean;
+        initialFocus?: boolean;
+    };
+    plugins: {
+        /** Push notifications config */
+        PushNotifications?: {
+            presentationOptions?: ("badge" | "sound" | "alert")[];
+        };
+        /** Splash screen config */
+        SplashScreen?: {
+            launchShowDuration?: number;
+            launchAutoHide?: boolean;
+            launchFadeOutDuration?: number;
+            backgroundColor?: string;
+            androidSplashResourceName?: string;
+            androidScaleType?: "CENTER" | "CENTER_CROP" | "CENTER_INSIDE" | "FIT_CENTER" | "FIT_XY";
+            showSpinner?: boolean;
+            spinnerStyle?: "horizontal" | "small" | "large";
+            spinnerColor?: string;
+        };
+        /** Local notifications config */
+        LocalNotifications?: {
+            smallIcon?: string;
+            iconColor?: string;
+            sound?: string;
+        };
+        /** Keyboard config */
+        Keyboard?: {
+            resize?: "body" | "ionic" | "native" | "none";
+            style?: "dark" | "light" | "default";
+            resizeOnFullScreen?: boolean;
+        };
+    } | undefined;
+};
+/**
+ * Create Flight-specific mobile configuration.
+ * Extends Capacitor config with Flight-specific options.
+ *
+ * @example
+ * ```typescript
+ * // flight.config.ts
+ * import { defineMobileConfig } from '@flightdev/mobile/config';
+ *
+ * export default {
+ *     mobile: defineMobileConfig({
+ *         appId: 'com.example.myapp',
+ *         appName: 'My App',
+ *     }),
+ * };
+ * ```
+ */
+declare function defineMobileConfig(config: MobileConfig): {
+    _flight: true;
+    /** Bundle identifier (com.example.app) */
+    appId: string;
+    /** Display name of the app */
+    appName: string;
+    /** Directory containing the web assets (default: dist) */
+    webDir?: string;
+    /** Server configuration for live reload */
+    server?: {
+        url?: string;
+        cleartext?: boolean;
+    };
+    /** iOS-specific configuration */
+    ios?: {
+        /** Path to iOS project (default: ios) */
+        path?: string;
+        /** Scheme for deep links */
+        scheme?: string;
+        /** Content inset mode */
+        contentInset?: "always" | "scrollable" | "automatic" | "never";
+        /** Background color of web view */
+        backgroundColor?: string;
+        /** Preferred content mode */
+        preferredContentMode?: "mobile" | "desktop" | "recommended";
+    };
+    /** Android-specific configuration */
+    android?: {
+        /** Path to Android project (default: android) */
+        path?: string;
+        /** Flavor for build variants */
+        flavor?: string;
+        /** Background color of web view */
+        backgroundColor?: string;
+        /** Allow mixed content */
+        allowMixedContent?: boolean;
+        /** Initial focus on web view */
+        initialFocus?: boolean;
+    };
+    /** Plugin configurations */
+    plugins?: {
+        /** Push notifications config */
+        PushNotifications?: {
+            presentationOptions?: ("badge" | "sound" | "alert")[];
+        };
+        /** Splash screen config */
+        SplashScreen?: {
+            launchShowDuration?: number;
+            launchAutoHide?: boolean;
+            launchFadeOutDuration?: number;
+            backgroundColor?: string;
+            androidSplashResourceName?: string;
+            androidScaleType?: "CENTER" | "CENTER_CROP" | "CENTER_INSIDE" | "FIT_CENTER" | "FIT_XY";
+            showSpinner?: boolean;
+            spinnerStyle?: "horizontal" | "small" | "large";
+            spinnerColor?: string;
+        };
+        /** Local notifications config */
+        LocalNotifications?: {
+            smallIcon?: string;
+            iconColor?: string;
+            sound?: string;
+        };
+        /** Keyboard config */
+        Keyboard?: {
+            resize?: "body" | "ionic" | "native" | "none";
+            style?: "dark" | "light" | "default";
+            resizeOnFullScreen?: boolean;
+        };
+    };
+};
+/**
+ * Generate capacitor.config.ts content from Flight config.
+ */
+declare function generateCapacitorConfig(config: MobileConfig): string;
+
+export { type MobileConfig, defineCapacitorConfig, defineMobileConfig, generateCapacitorConfig };

package/dist/config.js

@@ -0,0 +1,37 @@
+// src/config.ts
+function defineCapacitorConfig(config) {
+  return {
+    appId: config.appId,
+    appName: config.appName,
+    webDir: config.webDir ?? "dist",
+    server: config.server,
+    ios: {
+      path: "ios",
+      ...config.ios
+    },
+    android: {
+      path: "android",
+      ...config.android
+    },
+    plugins: config.plugins
+  };
+}
+function defineMobileConfig(config) {
+  return {
+    ...config,
+    _flight: true
+  };
+}
+function generateCapacitorConfig(config) {
+  const configObj = defineCapacitorConfig(config);
+  return `import type { CapacitorConfig } from '@capacitor/cli';
+
+const config: CapacitorConfig = ${JSON.stringify(configObj, null, 2)};
+
+export default config;
+`;
+}
+
+export { defineCapacitorConfig, defineMobileConfig, generateCapacitorConfig };
+//# sourceMappingURL=config.js.map
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"names":[],"mappings":";AA0GO,SAAS,sBAAsB,MAAA,EAAsB;AACxD,EAAA,OAAO;AAAA,IACH,OAAO,MAAA,CAAO,KAAA;AAAA,IACd,SAAS,MAAA,CAAO,OAAA;AAAA,IAChB,MAAA,EAAQ,OAAO,MAAA,IAAU,MAAA;AAAA,IACzB,QAAQ,MAAA,CAAO,MAAA;AAAA,IACf,GAAA,EAAK;AAAA,MACD,IAAA,EAAM,KAAA;AAAA,MACN,GAAG,MAAA,CAAO;AAAA,KACd;AAAA,IACA,OAAA,EAAS;AAAA,MACL,IAAA,EAAM,SAAA;AAAA,MACN,GAAG,MAAA,CAAO;AAAA,KACd;AAAA,IACA,SAAS,MAAA,CAAO;AAAA,GACpB;AACJ;AAmBO,SAAS,mBAAmB,MAAA,EAAsB;AACrD,EAAA,OAAO;AAAA,IACH,GAAG,MAAA;AAAA,IACH,OAAA,EAAS;AAAA,GACb;AACJ;AASO,SAAS,wBAAwB,MAAA,EAA8B;AAClE,EAAA,MAAM,SAAA,GAAY,sBAAsB,MAAM,CAAA;AAE9C,EAAA,OAAO,CAAA;;AAAA,gCAAA,EAEuB,IAAA,CAAK,SAAA,CAAU,SAAA,EAAW,IAAA,EAAM,CAAC,CAAC,CAAA;;AAAA;AAAA,CAAA;AAIpE","file":"config.js","sourcesContent":["/**\r\n * Capacitor configuration helper.\r\n * Creates type-safe configuration for mobile builds.\r\n */\r\n\r\n// =============================================================================\r\n// Types\r\n// =============================================================================\r\n\r\nexport interface MobileConfig {\r\n    /** Bundle identifier (com.example.app) */\r\n    appId: string;\r\n    /** Display name of the app */\r\n    appName: string;\r\n    /** Directory containing the web assets (default: dist) */\r\n    webDir?: string;\r\n    /** Server configuration for live reload */\r\n    server?: {\r\n        url?: string;\r\n        cleartext?: boolean;\r\n    };\r\n    /** iOS-specific configuration */\r\n    ios?: {\r\n        /** Path to iOS project (default: ios) */\r\n        path?: string;\r\n        /** Scheme for deep links */\r\n        scheme?: string;\r\n        /** Content inset mode */\r\n        contentInset?: 'always' | 'scrollable' | 'automatic' | 'never';\r\n        /** Background color of web view */\r\n        backgroundColor?: string;\r\n        /** Preferred content mode */\r\n        preferredContentMode?: 'mobile' | 'desktop' | 'recommended';\r\n    };\r\n    /** Android-specific configuration */\r\n    android?: {\r\n        /** Path to Android project (default: android) */\r\n        path?: string;\r\n        /** Flavor for build variants */\r\n        flavor?: string;\r\n        /** Background color of web view */\r\n        backgroundColor?: string;\r\n        /** Allow mixed content */\r\n        allowMixedContent?: boolean;\r\n        /** Initial focus on web view */\r\n        initialFocus?: boolean;\r\n    };\r\n    /** Plugin configurations */\r\n    plugins?: {\r\n        /** Push notifications config */\r\n        PushNotifications?: {\r\n            presentationOptions?: ('badge' | 'sound' | 'alert')[];\r\n        };\r\n        /** Splash screen config */\r\n        SplashScreen?: {\r\n            launchShowDuration?: number;\r\n            launchAutoHide?: boolean;\r\n            launchFadeOutDuration?: number;\r\n            backgroundColor?: string;\r\n            androidSplashResourceName?: string;\r\n            androidScaleType?: 'CENTER' | 'CENTER_CROP' | 'CENTER_INSIDE' | 'FIT_CENTER' | 'FIT_XY';\r\n            showSpinner?: boolean;\r\n            spinnerStyle?: 'horizontal' | 'small' | 'large';\r\n            spinnerColor?: string;\r\n        };\r\n        /** Local notifications config */\r\n        LocalNotifications?: {\r\n            smallIcon?: string;\r\n            iconColor?: string;\r\n            sound?: string;\r\n        };\r\n        /** Keyboard config */\r\n        Keyboard?: {\r\n            resize?: 'body' | 'ionic' | 'native' | 'none';\r\n            style?: 'dark' | 'light' | 'default';\r\n            resizeOnFullScreen?: boolean;\r\n        };\r\n    };\r\n}\r\n\r\n// =============================================================================\r\n// Factory\r\n// =============================================================================\r\n\r\n/**\r\n * Create a Capacitor configuration.\r\n * \r\n * Use this in your capacitor.config.ts file:\r\n * \r\n * @example\r\n * ```typescript\r\n * // capacitor.config.ts\r\n * import { defineCapacitorConfig } from '@flightdev/mobile/config';\r\n * \r\n * export default defineCapacitorConfig({\r\n *     appId: 'com.example.myapp',\r\n *     appName: 'My App',\r\n *     webDir: 'dist',\r\n *     plugins: {\r\n *         PushNotifications: {\r\n *             presentationOptions: ['badge', 'sound', 'alert'],\r\n *         },\r\n *     },\r\n * });\r\n * ```\r\n */\r\nexport function defineCapacitorConfig(config: MobileConfig) {\r\n    return {\r\n        appId: config.appId,\r\n        appName: config.appName,\r\n        webDir: config.webDir ?? 'dist',\r\n        server: config.server,\r\n        ios: {\r\n            path: 'ios',\r\n            ...config.ios,\r\n        },\r\n        android: {\r\n            path: 'android',\r\n            ...config.android,\r\n        },\r\n        plugins: config.plugins,\r\n    };\r\n}\r\n\r\n/**\r\n * Create Flight-specific mobile configuration.\r\n * Extends Capacitor config with Flight-specific options.\r\n * \r\n * @example\r\n * ```typescript\r\n * // flight.config.ts\r\n * import { defineMobileConfig } from '@flightdev/mobile/config';\r\n * \r\n * export default {\r\n *     mobile: defineMobileConfig({\r\n *         appId: 'com.example.myapp',\r\n *         appName: 'My App',\r\n *     }),\r\n * };\r\n * ```\r\n */\r\nexport function defineMobileConfig(config: MobileConfig) {\r\n    return {\r\n        ...config,\r\n        _flight: true as const,\r\n    };\r\n}\r\n\r\n// =============================================================================\r\n// Utilities\r\n// =============================================================================\r\n\r\n/**\r\n * Generate capacitor.config.ts content from Flight config.\r\n */\r\nexport function generateCapacitorConfig(config: MobileConfig): string {\r\n    const configObj = defineCapacitorConfig(config);\r\n\r\n    return `import type { CapacitorConfig } from '@capacitor/cli';\r\n\r\nconst config: CapacitorConfig = ${JSON.stringify(configObj, null, 2)};\r\n\r\nexport default config;\r\n`;\r\n}\r\n"]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { P as Platform, a as PlatformInfo, g as getPlatform, b as getSafeAreaInsets, c as isPWA, i as isPluginAvailable } from './platform-Cq72g4Qx.js';
+export { MobileConfig, defineCapacitorConfig, defineMobileConfig, generateCapacitorConfig } from './config.js';

package/dist/index.js

@@ -0,0 +1,93 @@
+// src/platform.ts
+function getCapacitor() {
+  try {
+    const Capacitor = globalThis.Capacitor;
+    return Capacitor || null;
+  } catch {
+    return null;
+  }
+}
+function getPlatform() {
+  const Capacitor = getCapacitor();
+  if (!Capacitor) {
+    return {
+      platform: "web",
+      isNative: false,
+      isIOS: false,
+      isAndroid: false,
+      isWeb: true,
+      hasCapacitor: false
+    };
+  }
+  const platform = Capacitor.getPlatform();
+  const isNative = Capacitor.isNativePlatform();
+  return {
+    platform,
+    isNative,
+    isIOS: platform === "ios",
+    isAndroid: platform === "android",
+    isWeb: platform === "web",
+    hasCapacitor: true
+  };
+}
+function isPluginAvailable(pluginName) {
+  const Capacitor = getCapacitor();
+  if (!Capacitor || !Capacitor.isPluginAvailable) {
+    return false;
+  }
+  return Capacitor.isPluginAvailable(pluginName);
+}
+function getSafeAreaInsets() {
+  if (typeof window !== "undefined" && typeof window.getComputedStyle === "function") {
+    const style = getComputedStyle(document.documentElement);
+    return {
+      top: parseInt(style.getPropertyValue("--sat") || "0", 10),
+      bottom: parseInt(style.getPropertyValue("--sab") || "0", 10),
+      left: parseInt(style.getPropertyValue("--sal") || "0", 10),
+      right: parseInt(style.getPropertyValue("--sar") || "0", 10)
+    };
+  }
+  return { top: 0, bottom: 0, left: 0, right: 0 };
+}
+function isPWA() {
+  if (typeof window === "undefined") return false;
+  return window.matchMedia("(display-mode: standalone)").matches || window.navigator.standalone === true;
+}
+
+// src/config.ts
+function defineCapacitorConfig(config) {
+  return {
+    appId: config.appId,
+    appName: config.appName,
+    webDir: config.webDir ?? "dist",
+    server: config.server,
+    ios: {
+      path: "ios",
+      ...config.ios
+    },
+    android: {
+      path: "android",
+      ...config.android
+    },
+    plugins: config.plugins
+  };
+}
+function defineMobileConfig(config) {
+  return {
+    ...config,
+    _flight: true
+  };
+}
+function generateCapacitorConfig(config) {
+  const configObj = defineCapacitorConfig(config);
+  return `import type { CapacitorConfig } from '@capacitor/cli';
+
+const config: CapacitorConfig = ${JSON.stringify(configObj, null, 2)};
+
+export default config;
+`;
+}
+
+export { defineCapacitorConfig, defineMobileConfig, generateCapacitorConfig, getPlatform, getSafeAreaInsets, isPWA, isPluginAvailable };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/platform.ts","../src/config.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * Platform detection utilities.\r\n * Works without Capacitor installed - gracefully degrades.\r\n */\r\n\r\n// =============================================================================\r\n// Types\r\n// =============================================================================\r\n\r\nexport type Platform = 'web' | 'ios' | 'android';\r\n\r\nexport interface PlatformInfo {\r\n    /** Current platform: 'web', 'ios', or 'android' */\r\n    platform: Platform;\r\n    /** True if running as a native app (iOS or Android) */\r\n    isNative: boolean;\r\n    /** True if running on iOS */\r\n    isIOS: boolean;\r\n    /** True if running on Android */\r\n    isAndroid: boolean;\r\n    /** True if running as a web app */\r\n    isWeb: boolean;\r\n    /** True if Capacitor is available */\r\n    hasCapacitor: boolean;\r\n}\r\n\r\n// =============================================================================\r\n// Detection\r\n// =============================================================================\r\n\r\n/**\r\n * Get Capacitor instance if available.\r\n * Returns null if Capacitor is not installed.\r\n */\r\nfunction getCapacitor(): any {\r\n    try {\r\n        // Dynamic import to avoid errors when Capacitor is not installed\r\n        const Capacitor = (globalThis as any).Capacitor;\r\n        return Capacitor || null;\r\n    } catch {\r\n        return null;\r\n    }\r\n}\r\n\r\n/**\r\n * Detect the current platform.\r\n * \r\n * @returns Platform information object\r\n * \r\n * @example\r\n * ```typescript\r\n * const { isNative, isIOS, platform } = getPlatform();\r\n * \r\n * if (isNative) {\r\n *     // Use native features\r\n * }\r\n * \r\n * if (isIOS) {\r\n *     // iOS-specific code\r\n * }\r\n * ```\r\n */\r\nexport function getPlatform(): PlatformInfo {\r\n    const Capacitor = getCapacitor();\r\n\r\n    if (!Capacitor) {\r\n        return {\r\n            platform: 'web',\r\n            isNative: false,\r\n            isIOS: false,\r\n            isAndroid: false,\r\n            isWeb: true,\r\n            hasCapacitor: false,\r\n        };\r\n    }\r\n\r\n    const platform = Capacitor.getPlatform() as Platform;\r\n    const isNative = Capacitor.isNativePlatform();\r\n\r\n    return {\r\n        platform,\r\n        isNative,\r\n        isIOS: platform === 'ios',\r\n        isAndroid: platform === 'android',\r\n        isWeb: platform === 'web',\r\n        hasCapacitor: true,\r\n    };\r\n}\r\n\r\n/**\r\n * Check if a Capacitor plugin is available.\r\n * \r\n * @param pluginName - Name of the plugin to check\r\n * @returns True if the plugin is registered\r\n * \r\n * @example\r\n * ```typescript\r\n * if (isPluginAvailable('Camera')) {\r\n *     // Camera plugin is installed\r\n * }\r\n * ```\r\n */\r\nexport function isPluginAvailable(pluginName: string): boolean {\r\n    const Capacitor = getCapacitor();\r\n\r\n    if (!Capacitor || !Capacitor.isPluginAvailable) {\r\n        return false;\r\n    }\r\n\r\n    return Capacitor.isPluginAvailable(pluginName);\r\n}\r\n\r\n/**\r\n * Get safe area insets for notched devices.\r\n * Returns zeros on web or when not available.\r\n */\r\nexport function getSafeAreaInsets(): {\r\n    top: number;\r\n    bottom: number;\r\n    left: number;\r\n    right: number;\r\n} {\r\n    // Try to get from CSS env variables\r\n    if (typeof window !== 'undefined' && typeof window.getComputedStyle === 'function') {\r\n        const style = getComputedStyle(document.documentElement);\r\n        return {\r\n            top: parseInt(style.getPropertyValue('--sat') || '0', 10),\r\n            bottom: parseInt(style.getPropertyValue('--sab') || '0', 10),\r\n            left: parseInt(style.getPropertyValue('--sal') || '0', 10),\r\n            right: parseInt(style.getPropertyValue('--sar') || '0', 10),\r\n        };\r\n    }\r\n\r\n    return { top: 0, bottom: 0, left: 0, right: 0 };\r\n}\r\n\r\n/**\r\n * Check if running in a PWA installed context.\r\n */\r\nexport function isPWA(): boolean {\r\n    if (typeof window === 'undefined') return false;\r\n\r\n    return window.matchMedia('(display-mode: standalone)').matches ||\r\n        (window.navigator as any).standalone === true;\r\n}\r\n","/**\r\n * Capacitor configuration helper.\r\n * Creates type-safe configuration for mobile builds.\r\n */\r\n\r\n// =============================================================================\r\n// Types\r\n// =============================================================================\r\n\r\nexport interface MobileConfig {\r\n    /** Bundle identifier (com.example.app) */\r\n    appId: string;\r\n    /** Display name of the app */\r\n    appName: string;\r\n    /** Directory containing the web assets (default: dist) */\r\n    webDir?: string;\r\n    /** Server configuration for live reload */\r\n    server?: {\r\n        url?: string;\r\n        cleartext?: boolean;\r\n    };\r\n    /** iOS-specific configuration */\r\n    ios?: {\r\n        /** Path to iOS project (default: ios) */\r\n        path?: string;\r\n        /** Scheme for deep links */\r\n        scheme?: string;\r\n        /** Content inset mode */\r\n        contentInset?: 'always' | 'scrollable' | 'automatic' | 'never';\r\n        /** Background color of web view */\r\n        backgroundColor?: string;\r\n        /** Preferred content mode */\r\n        preferredContentMode?: 'mobile' | 'desktop' | 'recommended';\r\n    };\r\n    /** Android-specific configuration */\r\n    android?: {\r\n        /** Path to Android project (default: android) */\r\n        path?: string;\r\n        /** Flavor for build variants */\r\n        flavor?: string;\r\n        /** Background color of web view */\r\n        backgroundColor?: string;\r\n        /** Allow mixed content */\r\n        allowMixedContent?: boolean;\r\n        /** Initial focus on web view */\r\n        initialFocus?: boolean;\r\n    };\r\n    /** Plugin configurations */\r\n    plugins?: {\r\n        /** Push notifications config */\r\n        PushNotifications?: {\r\n            presentationOptions?: ('badge' | 'sound' | 'alert')[];\r\n        };\r\n        /** Splash screen config */\r\n        SplashScreen?: {\r\n            launchShowDuration?: number;\r\n            launchAutoHide?: boolean;\r\n            launchFadeOutDuration?: number;\r\n            backgroundColor?: string;\r\n            androidSplashResourceName?: string;\r\n            androidScaleType?: 'CENTER' | 'CENTER_CROP' | 'CENTER_INSIDE' | 'FIT_CENTER' | 'FIT_XY';\r\n            showSpinner?: boolean;\r\n            spinnerStyle?: 'horizontal' | 'small' | 'large';\r\n            spinnerColor?: string;\r\n        };\r\n        /** Local notifications config */\r\n        LocalNotifications?: {\r\n            smallIcon?: string;\r\n            iconColor?: string;\r\n            sound?: string;\r\n        };\r\n        /** Keyboard config */\r\n        Keyboard?: {\r\n            resize?: 'body' | 'ionic' | 'native' | 'none';\r\n            style?: 'dark' | 'light' | 'default';\r\n            resizeOnFullScreen?: boolean;\r\n        };\r\n    };\r\n}\r\n\r\n// =============================================================================\r\n// Factory\r\n// =============================================================================\r\n\r\n/**\r\n * Create a Capacitor configuration.\r\n * \r\n * Use this in your capacitor.config.ts file:\r\n * \r\n * @example\r\n * ```typescript\r\n * // capacitor.config.ts\r\n * import { defineCapacitorConfig } from '@flightdev/mobile/config';\r\n * \r\n * export default defineCapacitorConfig({\r\n *     appId: 'com.example.myapp',\r\n *     appName: 'My App',\r\n *     webDir: 'dist',\r\n *     plugins: {\r\n *         PushNotifications: {\r\n *             presentationOptions: ['badge', 'sound', 'alert'],\r\n *         },\r\n *     },\r\n * });\r\n * ```\r\n */\r\nexport function defineCapacitorConfig(config: MobileConfig) {\r\n    return {\r\n        appId: config.appId,\r\n        appName: config.appName,\r\n        webDir: config.webDir ?? 'dist',\r\n        server: config.server,\r\n        ios: {\r\n            path: 'ios',\r\n            ...config.ios,\r\n        },\r\n        android: {\r\n            path: 'android',\r\n            ...config.android,\r\n        },\r\n        plugins: config.plugins,\r\n    };\r\n}\r\n\r\n/**\r\n * Create Flight-specific mobile configuration.\r\n * Extends Capacitor config with Flight-specific options.\r\n * \r\n * @example\r\n * ```typescript\r\n * // flight.config.ts\r\n * import { defineMobileConfig } from '@flightdev/mobile/config';\r\n * \r\n * export default {\r\n *     mobile: defineMobileConfig({\r\n *         appId: 'com.example.myapp',\r\n *         appName: 'My App',\r\n *     }),\r\n * };\r\n * ```\r\n */\r\nexport function defineMobileConfig(config: MobileConfig) {\r\n    return {\r\n        ...config,\r\n        _flight: true as const,\r\n    };\r\n}\r\n\r\n// =============================================================================\r\n// Utilities\r\n// =============================================================================\r\n\r\n/**\r\n * Generate capacitor.config.ts content from Flight config.\r\n */\r\nexport function generateCapacitorConfig(config: MobileConfig): string {\r\n    const configObj = defineCapacitorConfig(config);\r\n\r\n    return `import type { CapacitorConfig } from '@capacitor/cli';\r\n\r\nconst config: CapacitorConfig = ${JSON.stringify(configObj, null, 2)};\r\n\r\nexport default config;\r\n`;\r\n}\r\n"]}