craft-native 0.0.154 → 0.0.156

package/dist/cli.js

@@ -3303,7 +3303,7 @@ function pinCraftNativeDependency(packagePath, craftVersion) {
 `);
 }
 // package.json
-var version = "0.0.154";
+var version = "0.0.156";
 
 // bin/cli.ts
 var spawnedFrom = process6.env[CRAFT_CLI_SPAWN_MARKER];

package/dist/index.cjs

@@ -310,7 +310,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.154";
+var version = "0.0.156";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;

package/dist/index.js

@@ -58,7 +58,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.154";
+var version = "0.0.156";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;

package/dist/ios/src/index.d.ts

@@ -83,6 +83,14 @@ export interface CraftConfig {
      * Each replaces the generic sentence Craft writes for that key.
      */
     usageDescriptions?: Record<string, string>;
+    /**
+     * The app's site. With `renderer: "web"` it is the page the web view loads.
+     * With `renderer: "native"` and `nativeScreens` there is no web view: its
+     * path is the path the app starts on (`/` when unset), and a path no native
+     * screen draws (`craft.navigation.open('/terms')`, or a link to this host)
+     * opens in the in-app browser against its origin. Native screens read it as
+     * `__stxNativeBridge.appURL`.
+     */
     devServerURL?: string;
     iosVersion?: string;
     watchosVersion?: string;
@@ -168,16 +176,32 @@ export interface CraftConfig {
     orientations?: Array<'portrait' | 'landscape-left' | 'landscape-right' | 'portrait-upside-down'>;
     deviceFamilies?: Array<'iphone' | 'ipad'>;
     /**
-     * Hybrid: app paths drawn as native stx screens instead of in the
-     * web view, each to the screen in the native bundle that draws it, e.g.
-     * `{ "/m": "Today", "/m/calendar": "Calendar" }`. A segment may be a
-     * parameter (`/m/workout/:id`) and the last one `*`. Needs `renderer: "web"`
-     * and `nativeBundle`; every other path stays in the web view, and a path
-     * whose screen is missing or throws falls back to it.
+     * App paths drawn as native stx screens, each to the screen in the native
+     * bundle that draws it, e.g. `{ "/m": "Today", "/m/calendar": "Calendar" }`.
+     * A segment may be a parameter (`/m/workout/:id`) and the last one `*`.
+     * Needs `nativeBundle`.
+     *
+     * With `renderer: "web"` (hybrid) every other path stays in the web view,
+     * and a path whose screen is missing or throws falls back to it.
+     *
+     * With `renderer: "native"` the app is all native, with the same tabs and
+     * path routing and no web view at all: every tab id and the start path (the
+     * path of `devServerURL`) must be a native screen's, and any other path
+     * opens in the in-app browser on the app's site.
      */
     nativeScreens?: Record<string, string>;
-    /** Hybrid: the bundle `stx native compile --format bundle` wrote, copied to `dist/native-screen.js`. */
+    /** The bundle `stx native compile --format bundle` wrote, copied to `dist/native-screen.js`. */
     nativeBundle?: string;
+    /**
+     * The bundle route of a screen-less script that runs once for the app's
+     * whole life, beside the screens (Stacks names it `__app`). It hears the
+     * app's events (`craftNotificationResponse`, `craftNotificationReceived`,
+     * `craftSilentPush`, `craftBackgroundRefresh`, `craftShortcut`,
+     * `craftSiriShortcut`) as `CRAFT_EVENT` messages instead of the page, every
+     * `APP_STATE`, and can open paths with `craft.navigation.open`. Needs
+     * `nativeScreens` or `renderer: "native"`, and the native bundle.
+     */
+    nativeApp?: string;
     /**
      * The native tab bar, shown from the first frame, before the page loads.
      * The page's own `tabBar.set` replaces it later. Each `id` is the tab's
@@ -214,8 +238,18 @@ export interface NativePathMatch {
 export declare function matchNativePath(nativeScreens: Record<string, string> | undefined, raw: string): NativePathMatch | null;
 /** Whether a config mixes native screens into its web page. */
 export declare function isHybrid(config: Pick<CraftConfig, 'renderer' | 'nativeScreens'>): boolean;
+/** Whether a config is an all-native app with routes: `renderer: "native"` and `nativeScreens`, tabs and paths with no web view. */
+export declare function hasNativeRoutes(config: Pick<CraftConfig, 'renderer' | 'nativeScreens'>): boolean;
+/** Whether a config draws any native screen, and so needs `dist/native-screen.js`. */
+export declare function usesNativeBundle(config: Pick<CraftConfig, 'renderer' | 'nativeScreens'>): boolean;
+/**
+ * The path the app starts on: the path of `devServerURL` (with its query),
+ * `/` when there is none. The shell reads it the same way
+ * (`CraftHybridRoutes.appPath`).
+ */
+export declare function nativeStartPath(config: Pick<CraftConfig, 'devServerURL'>): string;
 /** What is wrong with a config's hybrid and tab settings, one sentence each. */
-export declare function hybridConfigProblems(config: Pick<CraftConfig, 'renderer' | 'nativeScreens' | 'tabs' | 'shareStorage'>): string[];
+export declare function hybridConfigProblems(config: Pick<CraftConfig, 'renderer' | 'nativeScreens' | 'tabs' | 'shareStorage' | 'devServerURL' | 'nativeApp'>): string[];
 export interface CraftBackgroundRefresh {
     enabled: boolean;
     /** The BGTaskScheduler identifier. Default `<bundleId>.refresh`. */
@@ -412,6 +446,8 @@ export declare function installRuntime(output: string, runtimeDir: string): Prom
  * valid Swift type.
  */
 export declare function productName(name: string): string;
+/** Restore package-owned Swift into an existing project, without changing its Xcode metadata or bundled screens. */
+export declare function restoreShell(output: string): void;
 export declare function init(options: InitOptions): Promise<void>;
 /**
  * Build web assets and generate Xcode project
@@ -475,3 +511,5 @@ export declare function bootSimulator(device: SimulatorDevice): Promise<void>;
  */
 export declare function showSimulator(): Promise<void>;
 export declare function run(options: RunOptions): Promise<void>;
+export { createNativeMutationValidator, initSimulatorDriver, serializeSimulatorSteps } from './testing.js';
+export type { NativeMutationValidator, NativeValidationResult, SimulatorDriverOptions, SimulatorStep } from './testing.js';