@craft-native/android 0.0.203 → 0.0.205

package/README.md

@@ -2,6 +2,12 @@
 
 Build native Android apps with web technologies using Craft.
 
+`appLinks` path rules use the website association wildcards: `*` matches zero
+or more characters, `?` matches one, and `?*` matches one or more. The first
+matching rule decides whether a link opens in the app or browser. For example,
+`/gyms/*/?*` excludes a nonempty subpath without excluding `/gyms/trifit/`.
+The `?` and `?*` wildcards require Craft 0.0.204 or later.
+
 ## Features
 
 ### Core
@@ -100,16 +106,21 @@ Native mode maps STX `View`, `SafeAreaView`, `Text`, `Button`, `Link`, `Icon`,
 `Pressable`, `TouchableOpacity`, `TouchableHighlight`, `Checkbox`, `TextInput`, `Picker`, `DatePicker`, `Modal`, `Switch`, `Slider`, `ActivityIndicator`, `Image`, `ImageBackground`, `Video`, `Svg`, `G`, `SvgText`, `ScrollView`,
 `Map`, `SectionList`, and `FlatList` to Android views. `Map` uses the Google
 Maps SDK for trail polylines and marker taps; its overlays carry flat
-latitude/longitude `geometry` arrays and can fit the visible region to their
-bounds. Set `mapsApiKey` in the Android config to emit the SDK manifest key;
-Coordinates are range-checked at the native boundary, and invalid points or
-pole-crossing regions are ignored.
+latitude/longitude `geometry` arrays, `strokeWidth` is expressed in logical
+points, and the camera supports controlled `region`, one-time `initialRegion`,
+and `fitToBounds`. Set `mapsApiKey` in the Android config to emit the SDK manifest key;
+Coordinates must be JSON numbers (numeric strings are not coerced), are
+range-checked at the native boundary, and invalid points or pole-crossing
+regions are ignored. `fitToBounds` waits for the map viewport to
+be measured before caching a successful camera fit, so an early map callback
+does not lose the initial route framing.
 without it, the native map remains an explicit opt-in integration that needs
 the app's own Maps credentials. `SectionList` uses the same
 native scroll host for ordinary `.stx` slot children; grouped section data
 should use `FlatList` until the section-data protocol is available. The
 generated host routes both list names through `CraftNativeScrollView` for this
-slot-based contract. `Picker` renders `<select>`/`<option>` values
+slot-based contract. `ScrollView` also supports `stickyHeaderIndices` and
+`scrollTarget` for vertical native content. `Picker` renders `<select>`/`<option>` values
 with `onValueChange` or `onChange`. `DatePicker` uses the platform `DatePicker`
 and `TimePicker` controls for date, time, datetime, and countdown modes and
 emits local `value`, ISO, and millisecond `timestamp` fields. `Modal` is parent-scoped and supports
@@ -119,7 +130,10 @@ and `thumbColor`, while `Slider` supports track/thumb tint props and `step`
 snapping without collapsing stepped ranges to a fixed pixel-like precision.
 `ActivityIndicator` keeps a visible stopped indicator genuinely
 non-animated when `animating={false}` and `hidesWhenStopped={false}`. `Image`
-reports load lifecycle events and structured failures. `Video` uses the native
+reports load lifecycle events and structured failures. Native image sources
+accept HTTPS everywhere and loopback HTTP for local development (`localhost`,
+`127.0.0.1`, `10.0.2.2`, `::1`, and `*.localhost`); public HTTP and unsupported
+schemes are rejected. `Video` uses the native
 `VideoView` for URI playback with autoplay, pause, looping, mute, controls, and
 resize-mode props.
 `ImageBackground` loads an image behind ordinary native children while
@@ -140,8 +154,9 @@ become checked on their first user toggle.
 horizontal and inverted layouts, list chrome, and end-reached pagination.
 Flex items support `flex`, `flexGrow`, `flexShrink`, and numeric or percentage
 `flexBasis` for main-axis space distribution while preserving gaps and margins.
-Shared transforms, z-order, view shadows, text shadows, and Android `elevation`
-are applied with the same style keys as the iOS renderer.
+Shared transforms, z-order, view shadows, text shadows, per-edge border
+styles, and linear gradients are applied with the same style keys as the iOS
+renderer. Android `elevation` remains an additional native shadow input.
 `gap`, `rowGap`, and `columnGap` retain fractional density-independent values
 through line distribution and round only the final native frames.
 Numeric lengths and percentage widths/heights resolve against the native parent
@@ -228,11 +243,18 @@ With `nativeScreens` (paths to the screens that draw them), `tabs` and
 `nativeApp` in craft.config.json, the same keys as the iOS builder, the
 native renderer is a whole app rather than one bundle route:
 
+`craft android init` and `craft android build` validate every tab and the
+configured start path against `nativeScreens`; invalid native route tables are
+rejected before a project is generated.
+
 - a tab bar and a navigation bar (`craft.navigation.setOptions`: title, large
   title, right buttons with badges, `tabBarHidden`), a stack per tab, Android's
   Back key popping it; completed left/right swipes switch between tab roots
   interactively, yield to a horizontal scroll view, and can be disabled per
   screen with `craft.navigation.setOptions({ tabSwipeEnabled: false })`;
+  each screen may also set `backgroundColor`; omitting it or passing `null`
+  follows the app's light/dark background resource, and the navigation bar and
+  large title use the same resolved color;
 - `craft.navigation.open(path)` matched in the iOS shell's order (fixed segments
   before parameters), a tab's path selecting its tab, a path no screen draws
   opening the site in a Custom Tab; deep links and tapped notifications route

package/dist/index.d.ts

@@ -52,6 +52,7 @@ export interface CraftAndroidConfig {
     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<{

package/dist/index.js

@@ -380,6 +380,94 @@ function validateAndroidConfig(config) {
     throw new Error("Android targetSdk must not exceed compileSdk");
   }
 }
+function normalizeNativeRoutePath(raw) {
+  if (typeof raw !== "string")
+    return null;
+  let path = raw;
+  const cut = path.search(/[?#]/);
+  if (cut >= 0)
+    path = path.slice(0, cut);
+  if (!path.startsWith("/"))
+    return null;
+  path = path.replace(/\/{2,}/g, "/");
+  if (path.length > 1 && path.endsWith("/"))
+    path = path.slice(0, -1);
+  return path;
+}
+function nativeRouteSegments(path) {
+  return path === "/" ? [] : path.slice(1).split("/");
+}
+function matchesNativeRoute(nativeScreens, raw) {
+  const path = normalizeNativeRoutePath(raw);
+  if (path === null)
+    return false;
+  const parts = nativeRouteSegments(path);
+  return Object.entries(nativeScreens ?? {}).some(([pattern, screen]) => {
+    if (!screen)
+      return false;
+    const normalized = normalizeNativeRoutePath(pattern);
+    if (normalized === null)
+      return false;
+    const route = nativeRouteSegments(normalized);
+    for (let index = 0;index < route.length; index++) {
+      const segment = route[index];
+      if (segment === "*")
+        return index === route.length - 1;
+      if (index >= parts.length)
+        return false;
+      if (segment.startsWith(":")) {
+        if (!parts[index])
+          return false;
+      } else if (segment !== parts[index])
+        return false;
+    }
+    return route.length === parts.length;
+  });
+}
+function nativeStartPath(config) {
+  if (!config.devServerURL)
+    return "/";
+  try {
+    const url = new URL(config.devServerURL);
+    return `${url.pathname || "/"}${url.search}`;
+  } catch {
+    return "/";
+  }
+}
+function validateNativeRouteConfig(config) {
+  const screens = Object.entries(config.nativeScreens ?? {});
+  for (const [pattern, screen] of screens) {
+    if (normalizeNativeRoutePath(pattern) !== pattern || /[?#]/.test(pattern))
+      throw new Error(`nativeScreens path "${pattern}" must be an absolute path with no query, hash or trailing slash.`);
+    if (nativeRouteSegments(normalizeNativeRoutePath(pattern) ?? "/").slice(0, -1).includes("*"))
+      throw new Error(`nativeScreens path "${pattern}" may only end in *.`);
+    if (typeof screen !== "string" || !/^[A-Za-z_$][\w$-]*$/.test(screen))
+      throw new Error(`nativeScreens screen "${String(screen)}" for "${pattern}" must be a screen name from the native bundle.`);
+  }
+  const ids = new Set;
+  for (const tab of config.tabs ?? []) {
+    if (!tab || typeof tab.id !== "string" || !tab.id || typeof tab.title !== "string" || !tab.title)
+      throw new Error("Each tab needs an id (its root path) and a title.");
+    if (ids.has(tab.id))
+      throw new Error(`Tab "${tab.id}" is listed twice.`);
+    ids.add(tab.id);
+  }
+  if (config.renderer === "native" && screens.length > 0) {
+    for (const id of ids) {
+      if (!matchesNativeRoute(config.nativeScreens, id))
+        throw new Error(`Tab "${id}" is not a nativeScreens path; with renderer: "native" every tab must be a native screen.`);
+    }
+    const start = nativeStartPath(config);
+    if (!matchesNativeRoute(config.nativeScreens, start))
+      throw new Error(`The start path "${start}" (from devServerURL) is not a nativeScreens path; with renderer: "native" the app must start on a native screen.`);
+  }
+  if (config.nativeApp !== undefined) {
+    if (typeof config.nativeApp !== "string" || !/^[A-Za-z_$][\w$-]*$/.test(config.nativeApp))
+      throw new Error(`nativeApp "${String(config.nativeApp)}" must be a route name from the native bundle.`);
+    if (config.renderer !== "native" && screens.length === 0)
+      throw new Error('nativeApp runs in the native bundle; it needs nativeScreens or renderer: "native".');
+  }
+}
 function writeAndroidConfig(output, config) {
   writeFileSync(join2(output, "craft.config.json"), JSON.stringify(config, null, 2));
   const runtimeConfig = { ...config };
@@ -601,6 +689,7 @@ async function init(options) {
   }
   normalizeAndroidNetworkConfig(config);
   validateAndroidConfig(config);
+  validateNativeRouteConfig(config);
   if (config.enablePushNotifications && !config.googleServicesFile) {
     throw new Error("Android push notifications require a googleServicesFile");
   }
@@ -861,6 +950,7 @@ async function build(options) {
   }
   const config = JSON.parse(readFileSync2(configPath, "utf-8"));
   validateAndroidConfig(config);
+  validateNativeRouteConfig(config);
   if (config.renderer === "native") {
     if (htmlPath || devServer)
       throw new Error("A native Android screen cannot use --html-path or --dev-server.");
@@ -990,4 +1080,4 @@ export {
   ANDROID_MIN_SDK
 };
 
-//# debugId=12217629CA4DCE5764756E2164756E21
+//# debugId=D95CCF804E0EBBCF64756E2164756E21