@craft-native/android 0.0.92 → 0.0.95

package/README.md

@@ -132,12 +132,24 @@ Edit `craft.config.json` in your Android project:
 }
 ```
 
+Every `enable*` flag is enforced, not only reported. A call whose capability is
+off rejects with `CAPABILITY_DISABLED`, as it does on iOS, and
+`window.craft.capabilities` reports the same answer, so a page that
+feature-detects and a page that just calls behave the same. Calls that answer
+nothing yet, such as `haptic` and `vibrate`, do nothing and say so on the
+console. Every flag defaults to off, so an app that shipped without setting one
+and relied on Android serving it anyway has to turn it on.
+
 Only the fields shown above are generator options. Enabling background location
 also enables foreground geolocation. Push notifications require a regular
 `googleServicesFile` whose JSON contains a client matching the generated
 Android package. Deep links require at least one valid URI scheme; scheme names
 are normalized to lowercase.
-Health Connect normalizes `minSdk` to at least 26 and `compileSdk` to at least 36.
+The generated runtime supports Android 8.0 / API 26 and newer, exported as
+`ANDROID_MIN_SDK`. `minSdk` defaults to that floor; lower values are rejected
+before project files are written, including when Health Connect is enabled.
+Health Connect normalizes `compileSdk` to at least 36.
+The same effective `minSdk` is written to Gradle and both configuration files.
 A custom `appIconPath` must be a regular PNG, WebP, JPG, or GIF file; its supported
 extension is preserved in the generated drawable resource.
 

package/dist/index.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Craft Android Builder
+ *
+ * Generates native Android apps from web content using WebView.
+ */
+/** Oldest Android API level supported by the generated Kotlin runtime. */
+export declare const ANDROID_MIN_SDK = 26;
+export interface CraftAndroidConfig {
+    appName: string;
+    packageName: string;
+    version?: string;
+    versionCode?: number;
+    darkMode?: boolean;
+    backgroundColor?: string;
+    enableSpeechRecognition?: boolean;
+    enableHaptics?: boolean;
+    enableShare?: boolean;
+    enableCamera?: boolean;
+    enableBiometric?: boolean;
+    enablePushNotifications?: boolean;
+    enableSecureStorage?: boolean;
+    enableGeolocation?: boolean;
+    enableBackgroundLocation?: boolean;
+    enableHealthConnect?: boolean;
+    enableKeepAwake?: boolean;
+    enableDeepLinks?: boolean;
+    urlSchemes?: string[];
+    trustedOrigins?: string[];
+    appIconPath?: string;
+    googleServicesFile?: string;
+    devServerURL?: string;
+    hasBundledFallback?: boolean;
+    /** Android API level, at least ANDROID_MIN_SDK (26). */
+    minSdk?: number;
+    compileSdk?: number;
+    targetSdk?: number;
+}
+export interface InitOptions {
+    name: string;
+    packageName?: string;
+    output: string;
+    config?: Partial<CraftAndroidConfig>;
+    /**
+     * Where to find the Zig runtime's `<abi>/libcraft.so`.
+     *
+     * `null` means no runtime regardless of the environment; `undefined` falls
+     * through to `CRAFT_ANDROID_RUNTIME`. Same shape as the iOS builder's
+     * `runtimeDir`.
+     */
+    runtimeDir?: string | null;
+}
+export interface BuildOptions {
+    htmlPath?: string;
+    devServer?: string;
+    output: string;
+    release?: boolean;
+    compile?: boolean;
+    /** Same meaning as `InitOptions.runtimeDir`; refreshes what init installed. */
+    runtimeDir?: string | null;
+}
+export interface OpenOptions {
+    output: string;
+}
+export interface RunOptions {
+    device?: string;
+    output: string;
+}
+export declare function syncAndroidWebAssets(source: string, output: string): void;
+export declare function renderAndroidPermissions(config: CraftAndroidConfig): string;
+export declare function renderAndroidDeepLinks(config: CraftAndroidConfig): string;
+/**
+ * Where the runtime directory comes from when the caller does not say.
+ *
+ * The same shape as `CRAFT_BIN` and the iOS builder's `CRAFT_IOS_RUNTIME`: an
+ * explicit override for the monorepo dev loop, not a lookup path. Shipping the
+ * runtime to real apps means putting these libraries in the pantry package
+ * beside the `craft` binary, which is a distribution decision this function
+ * does not make.
+ */
+export declare function resolveRuntimeDir(override?: string | null): string | null;
+/**
+ * Copy the Zig runtime into the generated project as
+ * `app/src/main/jniLibs/<abi>/libcraft.so`.
+ *
+ * That path is AGP's default `jniLibs.srcDirs`, so nothing in the Gradle
+ * templates has to know about it — the library is packaged into the APK and
+ * `System.loadLibrary("craft")` finds it because the file is named for the
+ * `craft` it asks for.
+ *
+ * Until this existed, nothing put the library anywhere. `CraftNative` caught
+ * the `UnsatisfiedLinkError`, set `isAvailable = false`, and every action fell
+ * through to the Kotlin shim — by design, so an app with no runtime still
+ * works, which is also why nobody noticed that *every* generated app was in
+ * that state and the whole Android half of the Zig bridge had never run.
+ *
+ * Returns true when a runtime was installed.
+ */
+export declare function installRuntime(output: string, runtimeDir: string): boolean;
+export declare function init(options: InitOptions): Promise<void>;
+/**
+ * Build Android project
+ */
+export declare function build(options: BuildOptions): Promise<void>;
+/**
+ * Open Android project in Android Studio
+ */
+export declare function open(options: OpenOptions): Promise<void>;
+/**
+ * Run on Android device or emulator
+ */
+export declare function run(options: RunOptions): Promise<void>;