craft-native 0.0.204 → 0.0.206

package/dist/cli.js

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

package/dist/components/index.d.ts

@@ -86,7 +86,13 @@ export interface LayoutStyle {
     /** Overflow */
     overflow?: 'visible' | 'hidden' | 'scroll';
     /** Display */
-    display?: 'flex' | 'none';
+    display?: 'flex' | 'none' | 'grid';
+    /** Equal-width grid track count or CSS-shaped `repeat(N, 1fr)` tracks. */
+    gridTemplateColumns?: number | string;
+    /** Legacy numeric alias for the grid track count. */
+    gridColumns?: number;
+    /** Intrinsic or fixed height for automatically-created grid rows. */
+    gridAutoRows?: number | string;
 }
 /**
  * Spacing style properties.
@@ -166,6 +172,14 @@ export interface ColorStyle {
     backgroundColor?: string;
     /** Opacity */
     opacity?: number;
+    /** Linear-gradient direction used by native hosts. */
+    gradientDirection?: 'to-t' | 'to-tr' | 'to-r' | 'to-br' | 'to-b' | 'to-bl' | 'to-l' | 'to-tl';
+    /** Linear-gradient start color. */
+    gradientFrom?: string;
+    /** Optional linear-gradient middle stop. */
+    gradientVia?: string;
+    /** Linear-gradient end color. */
+    gradientTo?: string;
 }
 /**
  * Shadow style properties.
@@ -265,7 +279,7 @@ export type TextStyle = ViewStyle & TextStyleProps;
  */
 export interface ImageStyleProps {
     /** Resize mode */
-    resizeMode?: 'cover' | 'contain' | 'stretch' | 'repeat' | 'center';
+    resizeMode?: 'cover' | 'contain' | 'stretch' | 'center';
     /** Tint color */
     tintColor?: string;
 }
@@ -290,7 +304,9 @@ export interface BaseProps {
     /** Accessibility state exposed to assistive technologies */
     accessibilityState?: AccessibilityState;
     /** Accessibility role */
-    accessibilityRole?: 'none' | 'button' | 'link' | 'image' | 'text' | 'header' | 'search' | 'menu';
+    accessibilityRole?: 'none' | 'button' | 'link' | 'image' | 'text' | 'header' | 'search' | 'adjustable' | 'menu' | 'summary' | 'alert' | 'checkbox' | 'combobox' | 'menuitem' | 'progressbar' | 'radio' | 'tablist' | 'radiogroup' | 'list' | 'menubar' | 'spinbutton' | 'switch' | 'tab' | 'timer' | 'toolbar' | 'scrollbar';
+    /** Matches a view across an animated state change. */
+    transitionID?: string;
     /** Children elements */
     children?: any;
 }
@@ -307,12 +323,12 @@ export interface ViewProps extends BaseProps {
     style?: ViewStyle | ViewStyle[];
     /** Press handler */
     onPress?: () => void;
+    /** DOM-compatible press alias accepted by native hosts. */
+    onClick?: () => void;
     /** Long press handler */
     onLongPress?: () => void;
     /** Layout change handler */
     onLayout?: (event: LayoutEvent) => void;
-    /** Pointer events behavior */
-    pointerEvents?: 'auto' | 'none' | 'box-none' | 'box-only';
 }
 /** Safe-area container props used by native iOS and Android screens. */
 export interface SafeAreaViewProps extends ViewProps {
@@ -324,6 +340,17 @@ export interface KeyboardAvoidingViewProps extends ViewProps {
     behavior?: 'height' | 'position' | 'padding';
     keyboardVerticalOffset?: number;
 }
+/** Native status-bar appearance for the current screen. */
+export interface StatusBarProps extends BaseProps {
+    barStyle?: 'default' | 'light-content' | 'dark-content';
+    hidden?: boolean;
+}
+/** Pull-to-refresh control consumed by a parent ScrollView or FlatList. */
+export interface RefreshControlProps extends BaseProps {
+    refreshing?: boolean;
+    onRefresh?: () => void;
+    tintColor?: string;
+}
 /**
  * Text component props.
  */
@@ -334,8 +361,6 @@ export interface TextProps extends BaseProps {
     numberOfLines?: number;
     /** Ellipsize mode */
     ellipsizeMode?: 'head' | 'middle' | 'tail' | 'clip';
-    /** Selectable text */
-    selectable?: boolean;
     /** Press handler */
     onPress?: () => void;
     /** Long press handler */
@@ -345,6 +370,7 @@ export interface TextProps extends BaseProps {
 export interface ButtonProps extends BaseProps {
     title?: string;
     onPress?: () => void;
+    onClick?: () => void;
     disabled?: boolean;
     color?: string;
 }
@@ -369,10 +395,8 @@ export interface TouchableHighlightProps extends ViewProps {
  */
 export type ImageSource = {
     uri: string;
-    width?: number;
-    height?: number;
     headers?: Record<string, string>;
-} | number;
+};
 /**
  * Image component props.
  */
@@ -382,7 +406,7 @@ export interface ImageProps extends BaseProps {
     /** Style object or array */
     style?: ImageStyle | ImageStyle[];
     /** Resize mode */
-    resizeMode?: 'cover' | 'contain' | 'stretch' | 'repeat' | 'center';
+    resizeMode?: 'cover' | 'contain' | 'stretch' | 'center';
     /** Load start handler */
     onLoadStart?: () => void;
     /** Load handler */
@@ -393,10 +417,6 @@ export interface ImageProps extends BaseProps {
     onError?: (error: Error) => void;
     /** Default source while loading */
     defaultSource?: ImageSource;
-    /** Blur radius */
-    blurRadius?: number;
-    /** Fade duration (ms) */
-    fadeDuration?: number;
     /** Alt text for accessibility */
     alt?: string;
 }
@@ -453,12 +473,15 @@ export interface MapRegion {
 }
 export interface MapProps extends BaseProps {
     region?: MapRegion;
+    /** Initial camera region; applied once, then controlled by subsequent props. */
+    initialRegion?: MapRegion;
     fitToBounds?: boolean;
     showsUserLocation?: boolean;
     scrollEnabled?: boolean;
     zoomEnabled?: boolean;
     rotateEnabled?: boolean;
-    mapType?: 'standard' | 'satellite' | 'hybrid' | 'terrain';
+    /** Map styles implemented consistently by the maintained iOS and Android hosts. */
+    mapType?: 'standard' | 'satellite' | 'hybrid';
     onMarkerPress?: (event: {
         nativeEvent: {
             id: string;
@@ -486,7 +509,60 @@ export interface MapMarkerProps extends BaseProps {
     }) => void;
 }
 export interface ImageBackgroundProps extends ImageProps {
-    imageStyle?: ImageStyle | ImageStyle[];
+}
+/** Shared paint and accessibility props for DOM-free native SVG nodes. */
+export interface SvgPaintProps extends BaseProps {
+    style?: ViewStyle | ViewStyle[];
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
+    strokeDasharray?: number[] | string;
+    strokeDashoffset?: number;
+    strokeLinecap?: 'butt' | 'round' | 'square';
+    strokeLinejoin?: 'miter' | 'round' | 'bevel';
+    strokeMiterlimit?: number;
+    strokeOpacity?: number;
+    fillOpacity?: number;
+    fillRule?: 'nonzero' | 'evenodd';
+    vectorEffect?: 'none' | 'non-scaling-stroke';
+    color?: string;
+    opacity?: number;
+    /** Font weight inherited by descendant native SVG text. */
+    fontWeight?: string | number;
+}
+/** Root native SVG drawing surface. */
+export interface SvgProps extends SvgPaintProps {
+    viewBox?: [number, number, number, number] | string;
+    preserveAspectRatio?: string;
+}
+/** Native SVG group inheriting paint from its parent. */
+export interface GProps extends SvgPaintProps {
+}
+/** Shared generated geometry prop for native SVG shape nodes. */
+export interface SvgShapeProps extends SvgPaintProps {
+    geometry?: number[];
+}
+export interface PathProps extends SvgShapeProps {
+}
+export interface LineProps extends SvgShapeProps {
+}
+export interface RectProps extends SvgShapeProps {
+}
+export interface CircleProps extends SvgShapeProps {
+}
+export interface EllipseProps extends SvgShapeProps {
+}
+export interface PolylineProps extends SvgShapeProps {
+}
+export interface PolygonProps extends SvgShapeProps {
+}
+/** Native SVG text painted in the root viewBox. */
+export interface SvgTextProps extends SvgPaintProps {
+    x?: number;
+    y?: number;
+    fontSize?: number;
+    textAnchor?: 'start' | 'middle' | 'end' | string;
+    dominantBaseline?: string;
 }
 /**
  * ScrollView component props.
@@ -524,8 +600,18 @@ export interface ScrollViewProps extends ViewProps {
     keyboardDismissMode?: 'none' | 'on-drag' | 'interactive';
     /** Keyboard should persist taps */
     keyboardShouldPersistTaps?: 'always' | 'never' | 'handled';
-    /** Refresh control component */
-    refreshControl?: any;
+    /** Keep indexed vertical children pinned while scrolling. */
+    stickyHeaderIndices?: number[];
+    /** Scroll a child into view when this target changes. */
+    scrollTarget?: string | {
+        id: string;
+        animated?: boolean;
+        key?: string;
+    } | null;
+    /** Render content in reverse order along the scroll axis. */
+    inverted?: boolean;
+    /** Controlled native pull-to-refresh component. */
+    refreshControl?: RefreshControlProps;
 }
 /**
  * Pressable component props.
@@ -537,28 +623,6 @@ export interface PressableProps extends ViewProps {
     onPressIn?: () => void;
     /** Press out handler */
     onPressOut?: () => void;
-    /** Hit slop for touch area */
-    hitSlop?: number | {
-        top?: number;
-        right?: number;
-        bottom?: number;
-        left?: number;
-    };
-    /** Press retention offset */
-    pressRetentionOffset?: number | {
-        top?: number;
-        right?: number;
-        bottom?: number;
-        left?: number;
-    };
-    /** Android ripple effect */
-    android_ripple?: {
-        color?: string;
-        borderless?: boolean;
-        radius?: number;
-    };
-    /** Delay for long press */
-    delayLongPress?: number;
 }
 /**
  * TextInput component props.
@@ -586,6 +650,10 @@ export interface TextInputProps extends BaseProps {
     autoFocus?: boolean;
     /** Secure text entry (password) */
     secureTextEntry?: boolean;
+    /** Platform autofill content type (for example `username` or `oneTimeCode`). */
+    textContentType?: string;
+    /** HTML-style autofill hint (for example `current-password`). */
+    autoComplete?: string;
     /** Multi-line input */
     multiline?: boolean;
     /** Number of lines for multiline */
@@ -598,6 +666,8 @@ export interface TextInputProps extends BaseProps {
     selectionColor?: string;
     /** Change text handler */
     onChangeText?: (text: string) => void;
+    /** DOM-compatible change alias accepted by native hosts. */
+    onChange?: (text: string) => void;
     /** Focus handler */
     onFocus?: () => void;
     /** Blur handler */
@@ -607,11 +677,13 @@ export interface TextInputProps extends BaseProps {
     /** End editing handler */
     onEndEditing?: () => void;
 }
-export type KeyboardType = 'default' | 'email-address' | 'numeric' | 'phone-pad' | 'number-pad' | 'decimal-pad' | 'url' | 'web-search' | 'visible-password' | 'ascii-capable' | 'numbers-and-punctuation' | 'name-phone-pad' | 'twitter';
+export type KeyboardType = 'default' | 'email-address' | 'numeric' | 'phone-pad' | 'number-pad' | 'decimal-pad' | 'url' | 'web-search' | 'visible-password';
 export type ReturnKeyType = 'done' | 'go' | 'next' | 'search' | 'send' | 'join' | 'route' | 'continue' | 'emergency-call' | 'default';
 export interface SwitchProps extends BaseProps {
+    /** Controlled boolean state; malformed native bridge values stay off. */
     value?: boolean;
     onValueChange?: (value: boolean) => void;
+    onChange?: (value: boolean) => void;
     disabled?: boolean;
     trackColor?: {
         false?: string;
@@ -621,11 +693,13 @@ export interface SwitchProps extends BaseProps {
     ios_backgroundColor?: string;
 }
 export interface CheckboxProps extends BaseProps {
+    /** Controlled boolean state; malformed native bridge values stay off. */
     value?: boolean;
     checked?: boolean;
     indeterminate?: boolean;
     label?: string;
     onValueChange?: (value: boolean) => void;
+    onChange?: (value: boolean) => void;
     disabled?: boolean;
     color?: string;
 }
@@ -635,6 +709,7 @@ export interface SliderProps extends BaseProps {
     maximumValue?: number;
     step?: number;
     onValueChange?: (value: number) => void;
+    onChange?: (value: number) => void;
     onSlidingComplete?: (value: number) => void;
     disabled?: boolean;
     minimumTrackTintColor?: string;
@@ -643,12 +718,15 @@ export interface SliderProps extends BaseProps {
 }
 export interface PickerOption {
     label: string;
+    /** String or finite number; other bridge values are ignored by native hosts. */
     value: string | number;
 }
 export interface PickerProps extends BaseProps {
-    items: PickerOption[];
+    /** Typed options; child options remain supported when omitted. */
+    items?: PickerOption[];
     selectedValue?: string | number;
     onValueChange?: (value: string | number, index: number) => void;
+    onChange?: (value: string | number, index: number) => void;
     disabled?: boolean;
 }
 export interface DatePickerChange {
@@ -662,8 +740,8 @@ export interface DatePickerProps extends BaseProps {
     minimumDate?: string | number;
     maximumDate?: string | number;
     minuteInterval?: number;
-    display?: 'compact' | 'inline' | 'wheels';
     onValueChange?: (event: DatePickerChange) => void;
+    onChange?: (event: DatePickerChange) => void;
     disabled?: boolean;
 }
 export interface ActivityIndicatorProps extends BaseProps {
@@ -685,28 +763,8 @@ export interface FlatListProps<T> extends ScrollViewProps {
     }) => any;
     /** Key extractor function */
     keyExtractor?: (item: T, index: number) => string;
-    /** Item separator component */
-    ItemSeparatorComponent?: any;
-    /** List header component */
-    ListHeaderComponent?: any;
-    /** List footer component */
-    ListFooterComponent?: any;
-    /** Empty list component */
-    ListEmptyComponent?: any;
     /** Number of columns */
     numColumns?: number;
-    /** Initial number to render */
-    initialNumToRender?: number;
-    /** Max to render per batch */
-    maxToRenderPerBatch?: number;
-    /** Window size */
-    windowSize?: number;
-    /** Get item layout for optimization */
-    getItemLayout?: (data: T[] | null, index: number) => {
-        length: number;
-        offset: number;
-        index: number;
-    };
     /** End reached handler */
     onEndReached?: () => void;
     /** End reached threshold */
@@ -722,16 +780,6 @@ export interface SectionListSection<T> {
     title?: string;
 }
 export interface SectionListProps<T> extends ScrollViewProps {
-    sections: SectionListSection<T>[];
-    renderItem: (info: {
-        item: T;
-        index: number;
-        section: SectionListSection<T>;
-    }) => any;
-    renderSectionHeader?: (info: {
-        section: SectionListSection<T>;
-    }) => any;
-    keyExtractor?: (item: T, index: number) => string;
 }
 export interface ModalProps extends BaseProps {
     visible?: boolean;

package/dist/index.cjs

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

package/dist/index.d.cts

@@ -30,7 +30,7 @@ export * from './utils/index.js';
 export * from './api/index.js';
 export * as components from './components/index.js';
 export { createTahoeSidebar, createArcSidebar, createOrbStackSidebar, sidebarItem, sidebarSection, sidebarSeparator, tahoeStyle, arcStyle, orbstackStyle, createSplitView, SplitViewInstance, createFileBrowser, FileBrowserInstance, createOutlineView, OutlineViewInstance, createTableView, TableViewInstance, showQuickLook, hideQuickLook, canQuickLook, showColorPicker, showFontPicker, showDatePicker, createProgress, ProgressInstance, setToolbar, updateToolbarItem, setToolbarVisible, setTouchBar, updateTouchBarItem, StyleSheet, Animated, } from './components/index.js';
-export type { ContextMenuItem, SidebarStyle, SidebarPosition, SidebarHeaderConfig, SidebarFooterConfig, SidebarEventType, SidebarEventMap, SidebarEventHandler, ComponentProps, ComponentInstance, SplitViewOrientation, SplitViewDividerStyle, SplitViewConfig, FileBrowserConfig, FileBrowserSelection, OutlineItem, OutlineViewConfig, TableRow, TableViewConfig, QuickLookConfig, ColorPickerConfig, FontPickerConfig, FontResult, DatePickerConfig, ProgressConfig, ToolbarItem, ToolbarConfig, TouchBarConfig, FlexStyle, LayoutStyle, SpacingStyle, BorderStyle, ColorStyle, ShadowStyle, TransformStyle, ViewStyle, TextStyleProps, TextStyle, ImageStyleProps, ImageStyle, BaseProps, ViewProps, SafeAreaViewProps, KeyboardAvoidingViewProps, TextProps, ButtonProps, LinkProps, TouchableOpacityProps, TouchableHighlightProps, ImageSource, ImageProps, ImageBackgroundProps, IconProps, VideoProps, MapRegion, MapProps, MapPolylineProps, MapMarkerProps, ScrollViewProps, PressableProps, TextInputProps, KeyboardType, ReturnKeyType, SwitchProps, CheckboxProps, SliderProps, PickerOption, PickerProps, DatePickerChange, DatePickerProps, ActivityIndicatorProps, FlatListProps, SectionListSection, SectionListProps, ModalProps, LayoutEvent, ScrollEvent, } from './components/index.js';
+export type { ContextMenuItem, SidebarStyle, SidebarPosition, SidebarHeaderConfig, SidebarFooterConfig, SidebarEventType, SidebarEventMap, SidebarEventHandler, ComponentProps, ComponentInstance, SplitViewOrientation, SplitViewDividerStyle, SplitViewConfig, FileBrowserConfig, FileBrowserSelection, OutlineItem, OutlineViewConfig, TableRow, TableViewConfig, QuickLookConfig, ColorPickerConfig, FontPickerConfig, FontResult, DatePickerConfig, ProgressConfig, ToolbarItem, ToolbarConfig, TouchBarConfig, FlexStyle, LayoutStyle, SpacingStyle, BorderStyle, ColorStyle, ShadowStyle, TransformStyle, ViewStyle, TextStyleProps, TextStyle, ImageStyleProps, ImageStyle, BaseProps, ViewProps, SafeAreaViewProps, KeyboardAvoidingViewProps, StatusBarProps, RefreshControlProps, TextProps, ButtonProps, LinkProps, TouchableOpacityProps, TouchableHighlightProps, ImageSource, ImageProps, ImageBackgroundProps, SvgPaintProps, SvgProps, GProps, SvgShapeProps, PathProps, LineProps, RectProps, CircleProps, EllipseProps, PolylineProps, PolygonProps, SvgTextProps, IconProps, VideoProps, MapRegion, MapProps, MapPolylineProps, MapMarkerProps, ScrollViewProps, PressableProps, TextInputProps, KeyboardType, ReturnKeyType, SwitchProps, CheckboxProps, SliderProps, PickerOption, PickerProps, DatePickerChange, DatePickerProps, ActivityIndicatorProps, FlatListProps, SectionListSection, SectionListProps, ModalProps, LayoutEvent, ScrollEvent, } from './components/index.js';
 export * from './styles/headwind.js';
 export * from './styles/index.js';
 export * from './optimizations/index.js';

package/dist/index.d.ts

@@ -30,7 +30,7 @@ export * from './utils/index.js';
 export * from './api/index.js';
 export * as components from './components/index.js';
 export { createTahoeSidebar, createArcSidebar, createOrbStackSidebar, sidebarItem, sidebarSection, sidebarSeparator, tahoeStyle, arcStyle, orbstackStyle, createSplitView, SplitViewInstance, createFileBrowser, FileBrowserInstance, createOutlineView, OutlineViewInstance, createTableView, TableViewInstance, showQuickLook, hideQuickLook, canQuickLook, showColorPicker, showFontPicker, showDatePicker, createProgress, ProgressInstance, setToolbar, updateToolbarItem, setToolbarVisible, setTouchBar, updateTouchBarItem, StyleSheet, Animated, } from './components/index.js';
-export type { ContextMenuItem, SidebarStyle, SidebarPosition, SidebarHeaderConfig, SidebarFooterConfig, SidebarEventType, SidebarEventMap, SidebarEventHandler, ComponentProps, ComponentInstance, SplitViewOrientation, SplitViewDividerStyle, SplitViewConfig, FileBrowserConfig, FileBrowserSelection, OutlineItem, OutlineViewConfig, TableRow, TableViewConfig, QuickLookConfig, ColorPickerConfig, FontPickerConfig, FontResult, DatePickerConfig, ProgressConfig, ToolbarItem, ToolbarConfig, TouchBarConfig, FlexStyle, LayoutStyle, SpacingStyle, BorderStyle, ColorStyle, ShadowStyle, TransformStyle, ViewStyle, TextStyleProps, TextStyle, ImageStyleProps, ImageStyle, BaseProps, ViewProps, SafeAreaViewProps, KeyboardAvoidingViewProps, TextProps, ButtonProps, LinkProps, TouchableOpacityProps, TouchableHighlightProps, ImageSource, ImageProps, ImageBackgroundProps, IconProps, VideoProps, MapRegion, MapProps, MapPolylineProps, MapMarkerProps, ScrollViewProps, PressableProps, TextInputProps, KeyboardType, ReturnKeyType, SwitchProps, CheckboxProps, SliderProps, PickerOption, PickerProps, DatePickerChange, DatePickerProps, ActivityIndicatorProps, FlatListProps, SectionListSection, SectionListProps, ModalProps, LayoutEvent, ScrollEvent, } from './components/index.js';
+export type { ContextMenuItem, SidebarStyle, SidebarPosition, SidebarHeaderConfig, SidebarFooterConfig, SidebarEventType, SidebarEventMap, SidebarEventHandler, ComponentProps, ComponentInstance, SplitViewOrientation, SplitViewDividerStyle, SplitViewConfig, FileBrowserConfig, FileBrowserSelection, OutlineItem, OutlineViewConfig, TableRow, TableViewConfig, QuickLookConfig, ColorPickerConfig, FontPickerConfig, FontResult, DatePickerConfig, ProgressConfig, ToolbarItem, ToolbarConfig, TouchBarConfig, FlexStyle, LayoutStyle, SpacingStyle, BorderStyle, ColorStyle, ShadowStyle, TransformStyle, ViewStyle, TextStyleProps, TextStyle, ImageStyleProps, ImageStyle, BaseProps, ViewProps, SafeAreaViewProps, KeyboardAvoidingViewProps, StatusBarProps, RefreshControlProps, TextProps, ButtonProps, LinkProps, TouchableOpacityProps, TouchableHighlightProps, ImageSource, ImageProps, ImageBackgroundProps, SvgPaintProps, SvgProps, GProps, SvgShapeProps, PathProps, LineProps, RectProps, CircleProps, EllipseProps, PolylineProps, PolygonProps, SvgTextProps, IconProps, VideoProps, MapRegion, MapProps, MapPolylineProps, MapMarkerProps, ScrollViewProps, PressableProps, TextInputProps, KeyboardType, ReturnKeyType, SwitchProps, CheckboxProps, SliderProps, PickerOption, PickerProps, DatePickerChange, DatePickerProps, ActivityIndicatorProps, FlatListProps, SectionListSection, SectionListProps, ModalProps, LayoutEvent, ScrollEvent, } from './components/index.js';
 export * from './styles/headwind.js';
 export * from './styles/index.js';
 export * from './optimizations/index.js';

package/dist/index.js

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

package/dist/ios/src/index.js

@@ -102,6 +102,17 @@ function initSimulatorDriver(options) {
     if (previous !== content)
       writeFileSync(path, content);
   }
+  const script = join2(output, "UITests/journey.txt");
+  if (options.script === undefined)
+    rmSync(script, { force: true });
+  else {
+    let previous;
+    try {
+      previous = readFileSync(script, "utf8");
+    } catch {}
+    if (previous !== options.script)
+      writeFileSync(script, options.script);
+  }
 }
 function serializeSimulatorSteps(steps) {
   const number = (value) => {

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

@@ -7,11 +7,13 @@ export interface SimulatorDriverOptions {
     deploymentTarget?: string;
     controlUrl?: string;
     tabs?: readonly string[];
+    /** Bundle a wire-protocol journey and save native XCTest attachments. No control server is needed on physical devices. */
+    script?: string;
 }
 /** Generate the reusable XCUITest shell from package templates. No app-owned Swift. */
 export declare function initSimulatorDriver(options: SimulatorDriverOptions): void;
 export type SimulatorStep = {
-    command: 'launch' | 'activate' | 'terminate' | 'home' | 'back' | 'return' | 'unlabelled';
+    command: 'launch' | 'activate' | 'terminate' | 'home' | 'back' | 'return' | 'unlabelled' | 'notifications';
 } | {
     command: 'background' | 'wait';
     seconds: number;
@@ -45,14 +47,14 @@ export type SimulatorStep = {
     id: string;
     text: string;
 } | {
-    command: 'expect' | 'expectexact' | 'expectid';
+    command: 'expect' | 'expectexact' | 'expectid' | 'systemexpect';
     text: string;
     seconds?: number;
 } | {
-    command: 'tap' | 'tapif' | 'tapid' | 'tapexact' | 'type' | 'absent' | 'absentid' | 'selected' | 'tab' | 'scrollto' | 'dismiss' | 'log';
+    command: 'tap' | 'tapif' | 'tapid' | 'tapexact' | 'type' | 'absent' | 'absentid' | 'selected' | 'tab' | 'scrollto' | 'dismiss' | 'log' | 'systemtap' | 'systemabsent';
     text: string;
 } | {
-    command: 'shot' | 'tree' | 'audit' | 'exec';
+    command: 'shot' | 'tree' | 'audit' | 'exec' | 'systemtree';
     name: string;
 } | {
     command: 'openurl';

package/dist/ios/templates/CraftHybrid.swift

@@ -146,8 +146,10 @@ struct CraftHybridRoutes {
         let scheme = (url.scheme ?? "").lowercased()
         guard scheme == "http" || scheme == "https",
               let host = url.host?.lowercased(), !host.isEmpty,
-              let siteHost = site?.host?.lowercased() else { return false }
-        return host == siteHost
+              let siteScheme = site?.scheme?.lowercased(), scheme == siteScheme,
+              let siteHost = site?.host?.lowercased(), host == siteHost,
+              url.port == site?.port else { return false }
+        return true
     }
 
     /// Where a path no native screen draws opens in an app with no web view:
@@ -979,6 +981,17 @@ final class CraftHybridWebSlot: UIViewController {
     /// ready. This belongs to the incoming slot, beyond the push animation.
     private(set) var waitingPageSnapshot: UIView?
 
+    /// A canceled tab swipe may leave this slot hidden after the page has
+    /// already reported its destination. Reconcile that route before the
+    /// WebView is adopted again, so the slot cannot stay transparent forever.
+    @discardableResult
+    func markArrivedIfNeeded(_ currentPath: String?) -> Bool {
+        guard awaitingPage, let currentPath,
+              CraftHybridRoutes.normalize(currentPath) == CraftHybridRoutes.normalize(path) else { return false }
+        awaitingPage = false
+        return true
+    }
+
     func keepPageVisible(_ snapshot: UIView) {
         waitingPageSnapshot?.removeFromSuperview()
         snapshot.frame = view.bounds
@@ -1392,7 +1405,7 @@ final class CraftHybridController: UIViewController, UINavigationControllerDeleg
 
     /// The entry for a path: its native screen, or a web entry.
     private func entry(for path: String, isTabRoot: Bool, depth: Int?, params extra: [String: Any] = [:]) -> UIViewController {
-        if let match = hybrid.routes.match(path) {
+        if hybrid.isEnabled, let match = hybrid.routes.match(path) {
             var params = self.params(for: path, match)
             extra.forEach { params[$0.key] = $0.value }
             let screen = CraftNativeScreenController(config: config, routeName: match.screen, routeParams: params)
@@ -1441,6 +1454,7 @@ final class CraftHybridController: UIViewController, UINavigationControllerDeleg
     func adoptWeb(into slot: CraftHybridWebSlot, allowHiddenStack: Bool = false) {
         guard let webHost,
               allowHiddenStack || slot.navigationController === visibleStack || visibleStack == nil else { return }
+        slot.markArrivedIfNeeded(hybrid.pagePath)
         attachWeb()
         moveWeb(to: slot, in: slot.view)
         webHost.view.alpha = slot.awaitingPage ? 0 : 1

package/dist/ios/templates/CraftNativeFlatList.swift

@@ -158,6 +158,8 @@ final class CraftNativeFlatList: UICollectionView, UICollectionViewDelegateFlowL
     private var refreshHandler: (() -> Void)?
     private let keyboardTapGesture = UITapGestureRecognizer()
     private var keyboardShouldPersistTaps = "never"
+    private var scrollTargetKey: String?
+    private var pendingScrollTarget: (id: String, animated: Bool, attempts: Int)?
 
     init() {
         let layout = CraftNativeFlatListLayout()
@@ -271,6 +273,37 @@ final class CraftNativeFlatList: UICollectionView, UICollectionViewDelegateFlowL
         updateItemEstimate()
         super.layoutSubviews()
         craftApplyCornerRadius()
+        scrollToPendingTarget()
+    }
+
+    /// Scroll to a virtualized row identified by its native testID, id, or key.
+    /// The row need not be mounted yet; the data snapshot is enough to find its
+    /// index, and UIKit will mount it as part of the scroll.
+    func setScrollTarget(_ value: Any?) {
+        var id: String?
+        var animated = true
+        if let text = value as? String {
+            id = text
+        } else if let target = value as? [String: Any] {
+            id = target["id"] as? String
+            animated = target["animated"] as? Bool ?? true
+        }
+        guard let id, !id.isEmpty else {
+            scrollTargetKey = nil
+            pendingScrollTarget = nil
+            return
+        }
+        let key: String
+        if let target = value as? [String: Any],
+           let data = try? JSONSerialization.data(withJSONObject: target, options: [.sortedKeys]) {
+            key = String(decoding: data, as: UTF8.self)
+        } else {
+            key = id
+        }
+        guard key != scrollTargetKey else { return }
+        scrollTargetKey = key
+        pendingScrollTarget = (id, animated, 0)
+        scrollToPendingTarget()
     }
 
     func setContentContainerStyle(_ raw: [String: Any]?) {
@@ -315,6 +348,10 @@ final class CraftNativeFlatList: UICollectionView, UICollectionViewDelegateFlowL
         }
     }
 
+    func setRefreshAppearance(_ props: [String: Any]) {
+        nativeRefreshControl.tintColor = (props["tintColor"] as? String).flatMap { UIColor(hex: $0) }
+    }
+
     @objc private func refreshTriggered() {
         refreshHandler?()
         DispatchQueue.main.async { [weak self] in
@@ -473,6 +510,8 @@ final class CraftNativeFlatList: UICollectionView, UICollectionViewDelegateFlowL
         onMomentumScrollBegin = nil
         onMomentumScrollEnd = nil
         pendingThemeRefresh = false
+        scrollTargetKey = nil
+        pendingScrollTarget = nil
     }
 
     func refreshThemeDefaults() {
@@ -543,10 +582,39 @@ final class CraftNativeFlatList: UICollectionView, UICollectionViewDelegateFlowL
                 self.refreshThemeDefaults()
                 return
             }
+            self.scrollToPendingTarget()
             self.evaluateEndReached()
         }
     }
 
+    private func targetIndex(for id: String) -> Int? {
+        items.firstIndex { item in
+            let props = item.node["props"] as? [String: Any] ?? [:]
+            return [props["testID"], props["id"], item.node["id"], item.identity]
+                .compactMap { $0 as? String }
+                .contains(id)
+        }
+    }
+
+    private func scrollToPendingTarget() {
+        guard let target = pendingScrollTarget else { return }
+        guard let index = targetIndex(for: target.id), index < numberOfItems(inSection: 0) else {
+            if target.attempts >= 4 {
+                // A diffable snapshot may still be applying. Keep the target
+                // for finishApplyingSnapshot(), but discard an invalid target
+                // once the list is otherwise idle.
+                if !isApplyingSnapshot { pendingScrollTarget = nil }
+                return
+            }
+            pendingScrollTarget = (target.id, target.animated, target.attempts + 1)
+            DispatchQueue.main.async { [weak self] in self?.scrollToPendingTarget() }
+            return
+        }
+        pendingScrollTarget = nil
+        let position: UICollectionView.ScrollPosition = flowLayout.scrollDirection == .horizontal ? .left : .top
+        scrollToItem(at: IndexPath(item: index, section: 0), at: position, animated: target.animated)
+    }
+
     private func clamped(_ offset: CGPoint) -> CGPoint {
         CGPoint(
             x: min(max(-adjustedContentInset.left, offset.x), max(-adjustedContentInset.left, contentSize.width - bounds.width + adjustedContentInset.right)),