@craft-native/android 0.0.451 → 0.0.464

package/README.md

@@ -292,7 +292,12 @@ native bridge supports device info, clipboard read/write, haptic impact,
 persistent JSON storage, SQLite queries and transactions, lifecycle and deep-link
 events, and local notifications. Storage and SQLite survive process relaunch;
 notifications use `AlarmManager`, so delivery does not require a running
-JavaScriptSandbox process. Enable `enableLocalDatabase`,
+JavaScriptSandbox process. Notification groups retain their child membership
+across receiver recreation. Replacing a child updates that membership before
+posting; cancelling or dismissing the last child removes its summary even when
+Android has not yet applied an earlier post or cancellation. Cancelling all
+notifications also clears their saved membership and action tokens.
+Enable `enableLocalDatabase`,
 `enableLocalNotifications`, and `enableDeepLinks` explicitly. These optional
 boolean fields are accepted by `CraftAndroidConfig` and `InitOptions.config`;
 omitting them or setting them to `false` keeps the capabilities disabled. Disabled or
@@ -1178,3 +1183,16 @@ when available. `monospace`/`ui-monospace`, `serif`/`ui-serif` and
 `sans-serif`/`ui-sans-serif`/`system-ui` select platform fonts, retaining requested
 weight, italic style and system text scaling. A missing custom face falls through
 to the next family rather than silently replacing a requested mono font with sans.
+
+### Native route parameter constraints
+
+`nativeScreenConstraints` applies the same decoded parameter rules as the iOS
+host and browser-safe `craft-native/mobile` matcher. For example,
+`{ '/:username': { username: { pattern: '[a-z]+', exclude: ['terms'], normalize: 'lowercase' } } }`
+normalizes decoded parameters and exclusions independently of device locale,
+then applies a complete case-sensitive pattern and returns normalized parameters.
+leaves `/terms` to the normal website fallback while `/ava` opens the profile.
+Patterns match the complete value; use syntax shared by JavaScript, Foundation
+and Kotlin. Invalid configuration is rejected by the builder, invalid runtime
+rules fail closed, and query parameters cannot replace path parameters. Static
+routes retain priority.

package/dist/index.d.ts

@@ -1,350 +1 @@
-/** Store large native source assets compressed; the host decodes each once on demand. */
-export declare function compressNativeSources(target: string): void;
-import { type AndroidMapProvider } from './native-map.js';
-export type { AndroidMapProvider } from './native-map.js';
-/**
- * The builder installs a directory of route bundles (stx's `routesDir`) as
- * well as the one-file bundle, and the app runs each screen from its own
- * route's file. Stacks asks for route bundles only when this is true.
- */
-/** Build-time proof for Stacks capability mappings, including unreleased source builds. */
-export declare const nativeSensorCapabilities: readonly ['motionSensors', 'barometer', 'pedometer'];
-export declare const nativeRouteBundles = true;
-/**
- * The app evaluates stx's shared runtime (`__runtime.js`, stx's
- * `sharedRuntime`) in each screen's context before the route's own file.
- * Stacks asks stx for it only when this is true: a route file built so
- * refuses to run without it.
- */
-export declare const nativeRouteRuntime = true;
-/**
- * The app gives a screen its messages a language at a time (stx's
- * `messages`, `native-screens/__messages/`): the areas its route uses,
- * evaluated ahead of it (an isolate cannot read a file when asked). Stacks leaves the languages
- * out of the screens' code only when this is true.
- */
-export declare const nativeMessages = true;
-/** Providers this published builder can generate as real Android map views. */
-export declare const nativeMapProviders: readonly ['google', 'maplibre'];
-export { runKotlinFixture } from './testing.js';
-export { createAndroidEmulator } from './emulator.js';
-export type { AndroidEmulatorOptions, AndroidEmulatorSession } from './emulator.js';
-/** Package custom fonts and their licenses; removed fonts cannot linger in the app. */
-export declare function syncNativeFonts(fonts: CraftAndroidConfig['nativeFonts'], output: string): string[];
-/** Oldest Android API level supported by the generated Kotlin runtime. */
-export declare const ANDROID_MIN_SDK = 26;
-export interface CraftAndroidConfig {
-    /** Bundled font files keyed by their PostScript font name, used as native fontFamily. */
-    nativeFonts?: Record<string, {
-        src: string;
-        license?: string;
-    }>;
-    appName: string;
-    packageName: string;
-    renderer?: 'web' | 'native';
-    /** "system" follows the device; light/dark pin the generated host. */
-    appearance?: 'light' | 'dark' | 'system';
-    /** Static native tab-bar styling applied before the page's own tabBar.set call. */
-    tabBar?: CraftTabBarConfig;
-    /** Runs from the generated project root before Gradle compiles the app. */
-    postGenerate?: CraftPostGenerateHook;
-    version?: string;
-    versionCode?: number;
-    darkMode?: boolean;
-    backgroundColor?: string;
-    backgroundColorDark?: string;
-    enableSpeechRecognition?: boolean;
-    enableAudioRecording?: boolean;
-    enableHaptics?: boolean;
-    enableShare?: boolean;
-    enableCamera?: boolean;
-    enableBiometric?: boolean;
-    enablePushNotifications?: boolean;
-    /** Enable native SQLite queries and transactions. Disabled unless explicitly true. */
-    enableLocalDatabase?: boolean;
-    /** Enable native AlarmManager local notification scheduling. Disabled unless explicitly true. */
-    enableLocalNotifications?: boolean;
-    enableSecureStorage?: boolean;
-    enableGeolocation?: boolean;
-    enableBackgroundLocation?: boolean;
-    /** Foreground raw Android sensors on native screens; separate from iOS fused motion. */
-    enableMotionSensors?: boolean;
-    /** Foreground pressure and session-relative altitude; does not enable background recording. */
-    enableBarometer?: boolean;
-    /** Foreground hardware step counters/detectors; requires activity recognition on Android 10+. */
-    enablePedometer?: boolean;
-    enableBluetooth?: boolean;
-    /**
-     * A Bluetooth heart-rate strap, or a watch broadcasting its heart rate (the
-     * standard Heart Rate Service), through `craft.heartRate` on a page and the
-     * `HeartRate` module on a native screen (CraftHeartRate.kt): scan, connect,
-     * live readings as `craftHeartRate` events, and a recording kept natively,
-     * in the foreground (a connectedDevice service) while it runs. The iOS
-     * builder's flag of the same name.
-     */
-    enableHeartRate?: boolean;
-    enableHealthConnect?: boolean;
-    /** Android Health Services live exercise tracking for native screens. Requires minSdk 30. */
-    enableHealthServices?: boolean;
-    /** Google Wallet save-link or native SDK handoff for native screens. */
-    enableWallet?: boolean;
-    /**
-     * The Health Connect data the app reads and writes, by the shared type
-     * names (`steps`, `sleep`, `workouts`...). The manifest declares only
-     * these, as Play's health permissions review requires; without it, the
-     * original set (steps, heart rate, energy, distance, workouts).
-     */
-    healthConnect?: {
-        read?: HealthConnectType[];
-        write?: HealthConnectType[];
-        /** Read while the app is in the background (a WorkManager refresh): Android 15's READ_HEALTH_DATA_IN_BACKGROUND. */
-        background?: boolean;
-        /** Read further back than the 30 days before the first grant: READ_HEALTH_DATA_HISTORY. */
-        history?: boolean;
-    };
-    enableHealthConnectBackground?: boolean;
-    enableHealthConnectHistory?: boolean;
-    /** The app's privacy policy, which Health Connect links to from its permission screen. */
-    privacyPolicyURL?: string;
-    enableKeepAwake?: boolean;
-    enableDeepLinks?: boolean;
-    /** Reach the person's own devices on the local network over plain HTTP (a Mac companion). */
-    enableLocalNetwork?: boolean;
-    urlSchemes?: string[];
-    /** HTTPS hosts owned by the app; path rules are ordered, with `*` matching any path text. */
-    /** Ordered path rules: * matches zero or more characters, ? one, and ?* one or more. */
-    appLinks?: Array<{
-        host: string;
-        paths?: Array<{
-            pattern: string;
-            exclude?: boolean;
-        }>;
-    }>;
-    trustedOrigins?: string[];
-    appIconPath?: string;
-    /**
-     * The launch splash: a directory laid out as Android resources, holding
-     * `drawable-<density>/splash_icon.png` (Android 12's splash icon, 288dp
-     * with its content inside the 192dp circle) and `splash_logo.png` (the
-     * logo the window background centres before Android 12), with Dark Mode
-     * ones in `drawable-night-<density>`. ts-images' `generateSplashScreens`
-     * writes exactly this (`android.resources`). Both sit on `backgroundColor`
-     * (`backgroundColorDark` at night), the colour the first frame continues.
-     * Without it, Android 12 shows the launcher icon and older versions the
-     * background colour.
-     */
-    splashResources?: string;
-    /**
-     * The small icon in the status bar and on every notification the app
-     * shows, push or local: an Android vector drawable (`.xml`) or a `.png`,
-     * white on transparent, since Android draws only its shape. Without one,
-     * a white Craft mark. Never the launcher icon, which shows as a white
-     * square.
-     */
-    notificationIconPath?: string;
-    /** The `#RRGGBB` Android tints the notification icon and app name with. The system's own colour without it. */
-    notificationColor?: string;
-    googleServicesFile?: string;
-    /** Native map renderer. MapLibre needs no SDK key; Google remains the default for compatibility. */
-    mapProvider?: AndroidMapProvider;
-    /** Google Maps Android SDK key, used only by the Google native map host. */
-    mapsApiKey?: string;
-    devServerURL?: string;
-    hasBundledFallback?: boolean;
-    /** Android API level, at least ANDROID_MIN_SDK (26), or 30 with Health Services. */
-    minSdk?: number;
-    compileSdk?: number;
-    targetSdk?: number;
-    /**
-     * Native renderer: the app's paths and the screen drawing each
-     * (`/m/workout/:id` → `Workout`), its tabs, and the bundle route of the
-     * script that runs beside the screens. The same keys as the iOS builder.
-     */
-    nativeScreens?: Record<string, string>;
-    tabs?: Array<{
-        id: string;
-        title: string;
-        symbol?: string;
-        /** Native selected-tab icon overrides, also supported by navigation.setOptions({ tabItem }). */
-        selectedSymbol?: string;
-        selectedIconTint?: string;
-        selectedIconPulse?: boolean;
-    }>;
-    nativeApp?: string;
-    /**
-     * The secure-storage key the signed-in account's token lives under
-     * (default `auth.token`). `craft.session` follows it on every native
-     * screen, and a change of it is `SESSION_CHANGED { key, token, previous }`.
-     */
-    sessionTokenKey?: string;
-    /** Wake the app script every so often (`craftBackgroundRefresh`), through WorkManager. */
-    backgroundRefresh?: {
-        enabled?: boolean;
-        minimumIntervalMinutes?: number;
-    };
-    /**
-     * Crash and error reporting to bughq (CraftCrashReporter.kt): uncaught JVM
-     * exceptions, ANRs and native crashes (ApplicationExitInfo), uncaught
-     * JavaScript errors, and what the page sends through `craft.crashReporter`.
-     * Queued on disk and sent when online. Release builds are minified: upload
-     * `app/build/outputs/mapping/release/mapping.txt` so bughq can retrace.
-     */
-    crashReporting?: {
-        /** The bughq project's public ingest key. */
-        key: string;
-        /** Default https://bughq.org. */
-        host?: string;
-        /** Default `production`. */
-        environment?: string;
-        /** Default `<versionName>+<versionCode>`, e.g. `1.0.0+41`. */
-        release?: string;
-        /** One session per launch, for crash-free sessions. Default on. */
-        sessions?: boolean;
-    };
-}
-export interface CraftTabBarConfig {
-    selection?: {
-        /** The selected tab indicator's corner radius in dp; omitted keeps the default. */
-        cornerRadius?: number;
-        /** The selected tab indicator fill as #RRGGBB. */
-        color?: string;
-    };
-}
-/** A declared command Craft runs after the native project has been generated. */
-export interface CraftPostGenerateHook {
-    command: string;
-    args?: string[];
-}
-/** The shared health data types (the iOS builder's HealthKit names). */
-export type HealthConnectType = 'steps' | 'heartRate' | 'activeEnergy' | 'distance' | 'workouts' | 'restingHeartRate' | 'heartRateVariability' | 'bodyMass' | 'sleep' | 'mindful' | 'dietaryEnergy' | 'dietaryProtein' | 'dietaryCarbohydrates' | 'dietaryFat' | 'bloodGlucose' | 'insulinDelivery';
-/**
- * The Health Connect permissions behind each type, for reading and for
- * writing. CraftNativeHealth.kt asks for the same ones; a permission the
- * manifest does not declare is refused without a prompt.
- */
-export declare const HEALTH_CONNECT_PERMISSIONS: Record<HealthConnectType, {
-    read: string[];
-    write: string[];
-}>;
-/** Every `android.permission.health.*` the app's Health Connect types need. */
-export declare function healthConnectPermissions(config: Pick<CraftAndroidConfig, 'healthConnect'>): string[];
-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;
-    nativeBundlePath?: string;
-    /**
-     * Native renderer: the app's icons as vectors (`{ viewBox, strokeWidth,
-     * icons: { name: svgBody } }`, keyed by Iconify name and SF Symbol), which
-     * `<Icon>`, the tab bar and the bar buttons draw. Without it they fall
-     * back to the glyphs Android's fonts have.
-     */
-    iconsPath?: string;
-    devServer?: string;
-    output: string;
-    release?: boolean;
-    /**
-     * An Android App Bundle (`bundleRelease`, `.aab`), what Google Play takes,
-     * rather than an APK. Signed with CRAFT_ANDROID_KEYSTORE,
-     * CRAFT_ANDROID_KEYSTORE_PASSWORD, CRAFT_ANDROID_KEY_ALIAS and
-     * CRAFT_ANDROID_KEY_PASSWORD when they are set.
-     */
-    bundle?: boolean;
-    compile?: boolean;
-    /** Same meaning as `InitOptions.runtimeDir`; refreshes what init installed. */
-    runtimeDir?: string | null;
-}
-/**
- * Run the app's declared generator hook without invoking a shell.
- *
- * A hook gets the generated project as its cwd and explicit metadata so a
- * patch can target the right platform and phase without guessing from paths.
- */
-export declare function runPostGenerateHook(hook: CraftPostGenerateHook | undefined, output: string, phase?: 'build'): void;
-export interface OpenOptions {
-    output: string;
-}
-export interface RunOptions {
-    device?: string;
-    output: string;
-}
-/** A splash file, by its place under `res/` (`drawable-night-xxhdpi/splash_icon.png`). */
-export interface AndroidSplashFile {
-    folder: string;
-    name: 'splash_icon.png' | 'splash_logo.png';
-    path: string;
-}
-/**
- * The splash files in a resources directory: `splash_icon.png` and
- * `splash_logo.png` in each `drawable[-night][-<density>]` folder. A directory
- * with neither is a mistake, not an app without a splash.
- */
-export declare function androidSplashFiles(resources: string): AndroidSplashFile[];
-/**
- * The launch theme the activity starts in, and the theme it swaps to before
- * its first frame. Android 12 and later draw their splash from
- * `windowSplashScreen*`; earlier versions draw the window background, here
- * the logo centred on the background colour. Either way the colour is the
- * app's own `background`, so nothing flashes when the first frame replaces it.
- */
-export declare function androidLaunchThemes(splash: Pick<AndroidSplashFile, 'name'>[]): {
-    base: string;
-    v31: string;
-    background?: 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>;
+export * from './internal/android/src/index.js'