@craft-native/ios 0.0.451 → 0.0.464

package/dist/index.d.ts

@@ -1,685 +1 @@
-/** Store large native source assets compressed; the host decodes each once on demand. */
-export declare function compressNativeSources(target: string): void;
-import { type CraftAppShortcut } from './app-shortcuts.js';
-/** Package custom fonts and their licenses; removed fonts cannot linger in the app. */
-export declare function syncNativeFonts(fonts: CraftConfig['nativeFonts'], output: string): string[];
-/** This package's version, which the app names in its user agent (`Craft/<version>`). */
-export declare function resolveCraftVersion(startDir?: string): string;
-export type CraftAppearance = 'light' | 'dark' | 'system';
-/** A declared command Craft runs after the native project has been generated. */
-export interface CraftPostGenerateHook {
-    command: string;
-    args?: string[];
-}
-export interface CraftTabBarConfig {
-    selection?: {
-        /** The selected tab indicator's corner radius in points; omitted keeps a capsule. */
-        cornerRadius?: number;
-        /** The selected tab indicator fill as #RRGGBB. */
-        color?: string;
-    };
-}
-export interface CraftConfig {
-    appShortcuts?: CraftAppShortcut[];
-    /** Bundled font files keyed by their PostScript font name, used as native fontFamily. */
-    nativeFonts?: Record<string, {
-        src: string;
-        license?: string;
-    }>;
-    appName: string;
-    bundleId: string;
-    /** Opt in to UIKit + JavaScriptCore instead of the default WebView. */
-    renderer?: 'web' | 'native';
-    version?: string;
-    buildNumber?: string;
-    darkMode?: boolean;
-    /**
-     * Which interface style the app draws in. `system` follows the phone's
-     * Light/Dark setting (and the page's `prefers-color-scheme` with it); `light`
-     * and `dark` pin one. Unset keeps the older `darkMode` switch.
-     */
-    appearance?: CraftAppearance;
-    /** Static native tab-bar styling applied before the page's own tabBar.set call. */
-    tabBar?: CraftTabBarConfig;
-    /** Runs from the generated project root after `craft ios build` writes it. */
-    postGenerate?: CraftPostGenerateHook;
-    backgroundColor?: string;
-    /** Default tint for native controls and selected tabs, as #RRGGBB. */
-    tintColor?: string;
-    /**
-     * CSS font stack for the native chrome's labels (tab bar, bar buttons); the
-     * first family packaged in `nativeFonts` wins, a generic one keeps the system face.
-     */
-    fontFamily?: string;
-    /** CSS font stack for navigation titles; `fontFamily` when unset. */
-    headingFontFamily?: string;
-    /** The launch and webview background while the phone is in Dark Mode. */
-    backgroundColorDark?: string;
-    /** Edge-swipe back and forward through the page's history, pushState entries included. */
-    swipeNavigation?: boolean;
-    enableSpeechRecognition?: boolean;
-    enableHaptics?: boolean;
-    enableShare?: boolean;
-    enableCamera?: boolean;
-    enableBiometric?: boolean;
-    enablePushNotifications?: boolean;
-    enableSecureStorage?: boolean;
-    enableGeolocation?: boolean;
-    enableClipboard?: boolean;
-    enableContacts?: boolean;
-    enableCalendar?: boolean;
-    enableLocalNotifications?: boolean;
-    enableInAppPurchase?: boolean;
-    enableKeepAwake?: boolean;
-    enableOrientationLock?: boolean;
-    enableDeepLinks?: boolean;
-    enableQRScanner?: boolean;
-    /** Reach devices on the local network (a Mac on the same Wi-Fi); iOS asks first. */
-    enableLocalNetwork?: boolean;
-    enableFilePicker?: boolean;
-    enableFileDownload?: boolean;
-    enableSocialAuth?: boolean;
-    /** Native passkeys; requires a matching `webcredentials:` associated domain. */
-    enablePasskeys?: boolean;
-    enableAudioRecording?: boolean;
-    enableVideoRecording?: boolean;
-    enableMotionSensors?: boolean;
-    /** Core Motion relative altitude and pressure; includes the motion usage description. */
-    enableBarometer?: boolean;
-    /** Core Motion interval steps, cadence and seven-day device history. */
-    enablePedometer?: boolean;
-    /** Shaking the phone raises a `shake` event. Arms the accelerometer while the app is in front. */
-    enableShakeGesture?: boolean;
-    enableLocalDatabase?: boolean;
-    enableBluetooth?: boolean;
-    enableNFC?: boolean;
-    enableHealthKit?: boolean;
-    /** Observe declared HealthKit types on background wakes; requires enableHealthKit. */
-    enableHealthKitBackground?: boolean;
-    healthKitBackgroundTypes?: Array<'steps' | 'heartRate' | 'restingHeartRate' | 'heartRateVariability' | 'activeEnergy' | 'distance' | 'bodyMass' | 'sleep' | 'workouts'>;
-    healthKitBackgroundFrequency?: 'immediate' | 'hourly' | 'daily' | 'weekly';
-    /** Native Apple Wallet pass presentation and lookup for native screens. */
-    enableWallet?: boolean;
-    enableLiveActivities?: boolean;
-    enableWatchApp?: boolean;
-    enableBackgroundLocation?: boolean;
-    enableBackgroundTasks?: boolean;
-    enableScreenCapture?: boolean;
-    enablePDFViewer?: boolean;
-    enableAR?: boolean;
-    enableMLKit?: boolean;
-    /**
-     * Show and control what the Music app is playing (`craft.music`, through
-     * MPMusicPlayerController.systemMusicPlayer). Only Apple Music: iOS gives
-     * no app the controls of another player such as Spotify. iOS asks the
-     * person for media library access the first time the page calls
-     * `craft.music.requestAuthorization()`, never at launch.
-     */
-    enableAppleMusic?: boolean;
-    /**
-     * Read a Bluetooth heart-rate strap, or a watch broadcasting its heart rate
-     * (the standard Heart Rate Service), through `craft.heartRate`: scan,
-     * connect, live readings with RR intervals, and a recording kept natively.
-     * Adds the `bluetooth-central` background mode, so readings keep coming
-     * during a workout with the screen locked. iOS asks for Bluetooth the first
-     * time the page scans or connects.
-     */
-    enableHeartRate?: boolean;
-    /**
-     * Keep playing sound with the screen locked or the app in the background:
-     * a sleep soundscape, a meditation timer's ambience. Adds the `audio`
-     * background mode. iOS keeps the app running only while it plays, and App
-     * Review expects audible content, so turn it on only for an app that plays
-     * some (Web Audio on native screens and in the web view, which use the
-     * playback session).
-     */
-    enableBackgroundAudio?: boolean;
-    /**
-     * Schedule structured workouts onto the paired Apple Watch through
-     * `craft.scheduledWorkouts` (WorkoutKit's WorkoutScheduler, iOS 17+): each
-     * appears in the watch's Workout app on its day, with its steps, goals and
-     * alerts. Compiles CraftScheduledWorkouts.swift with the
-     * `CRAFT_SCHEDULED_WORKOUTS` condition, so an app without it never links
-     * WorkoutKit; below iOS 17 it is weak-linked and answers unsupported. iOS
-     * asks the person the first time the page calls
-     * `craft.scheduledWorkouts.requestAuthorization()`, never at launch.
-     */
-    enableScheduledWorkouts?: boolean;
-    /**
-     * Purpose strings in the app's own words, by Info.plist key
-     * (`{ NSAppleMusicUsageDescription: 'Shows the song playing during a workout.' }`).
-     * 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;
-    teamId?: string;
-    urlSchemes?: string[];
-    trustedOrigins?: string[];
-    /**
-     * The domains the app's web view treats as its own (WKAppBoundDomains, at
-     * most 10). Service workers only run in an iOS web view on these, so a site
-     * that works offline in Safari works offline in the app. Unset, they are the
-     * hosts of `trustedOrigins` and the dev server: the origins the bridge is
-     * already injected into, and once any are declared iOS keeps script
-     * injection to them. `[]` declares none.
-     */
-    appBoundDomains?: string[];
-    /**
-     * Also refuse to load anything but the app-bound domains in the web view
-     * (WKWebViewConfiguration.limitsNavigationsToAppBoundDomains). Off by
-     * default: links elsewhere already open in Safari. WebKit applies the limit
-     * to the main frame only, so embedded players and maps in cross-origin
-     * iframes (YouTube, Vimeo) keep loading with it on (checked in the iOS 26
-     * simulator); WebKit only declines to inject user scripts into them, which
-     * the bridge never does.
-     */
-    limitNavigationsToAppBoundDomains?: boolean;
-    /**
-     * Universal links and shared web credentials
-     * (`com.apple.developer.associated-domains`). A bare host such as
-     * `hq.training` is written as `applinks:hq.training`; an entry with its own
-     * service (`webcredentials:`, `applinks:…?mode=developer`) is kept as given.
-     * A universal link reaches the page the way a custom-scheme link does, as
-     * `craftDeepLink`.
-     */
-    associatedDomains?: string[];
-    /**
-     * iOS's scheduled background refresh (BGAppRefreshTask). When enabled the
-     * page gets `craftBackgroundRefresh` and answers with
-     * `craft.background.complete(ok)`. The identifier defaults to
-     * `<bundleId>.refresh` and is declared in BGTaskSchedulerPermittedIdentifiers,
-     * with the `fetch` background mode.
-     */
-    backgroundRefresh?: CraftBackgroundRefresh;
-    appGroups?: string[];
-    appIconPath?: string;
-    /**
-     * The logo the launch screen shows on `backgroundColor`, and that stays on
-     * screen until the page says it is ready (`splash.hide()`), so the app goes
-     * from launch to content without a blank web view in between. PNG, PDF or
-     * SVG, drawn at its own size in points: give an SVG the width and height it
-     * should have on screen. A PNG with `@2x` and `@3x` files beside it
-     * (`LaunchLogo.png`, `LaunchLogo@2x.png`, `LaunchLogo@3x.png`, as ts-images'
-     * `generateSplashScreens` writes them) is sharp on every screen.
-     */
-    splashImagePath?: string;
-    /** The splash logo in Dark Mode, on `backgroundColorDark`. The light one if unset. */
-    splashImagePathDark?: string;
-    /**
-     * Whether the app uses encryption beyond the exempt kinds (HTTPS, the
-     * system's own). Written as `ITSAppUsesNonExemptEncryption`, so App Store
-     * Connect does not ask the export-compliance question on every build.
-     * Default false: a WebView app that talks HTTPS is exempt.
-     */
-    usesNonExemptEncryption?: boolean;
-    privacy?: CraftPrivacyManifest;
-    /** Press-and-hold link previews, as in Safari. Default false. */
-    allowsLinkPreview?: boolean;
-    /**
-     * WebKit's bar above the keyboard for a form field (previous, next, Done),
-     * which no native app's keyboard has. Default false: hidden. A page can
-     * change it with `craft.chrome.setKeyboardAccessory()`.
-     */
-    keyboardAccessory?: boolean;
-    /** Pinch and double-tap zoom off, and the page's viewport pinned at scale 1. Default true. */
-    disableZoom?: boolean;
-    /**
-     * The longest the launch splash stays up, in seconds, when the page neither
-     * hides it (`splash.hide()`) nor paints. Default 3.
-     */
-    splashMaxSeconds?: number;
-    /**
-     * How long the app's own page may take to answer, in seconds, before the
-     * load counts as unreachable and the bundled page stands in. Default 10.
-     */
-    requestTimeoutSeconds?: number;
-    orientations?: Array<'portrait' | 'landscape-left' | 'landscape-right' | 'portrait-upside-down'>;
-    deviceFamilies?: Array<'iphone' | 'ipad'>;
-    /**
-     * 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>;
-    /**
-     * The bundle `stx native compile --format bundle` wrote, copied to
-     * `dist/native-screen.js`; or a directory of route bundles (stx's
-     * `routesDir`: `<Screen>.js` and `__app.js`), copied to
-     * `dist/native-screens/`, so each screen evaluates only its own file.
-     */
-    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;
-    /**
-     * Where native screens run their JavaScript. `"main"` (the default) runs it
-     * on the main thread; `"background"` gives screens a serial thread of their
-     * own, so a screen's script, its timers and its renders never hold the
-     * main thread while it scrolls or animates. UIKit still runs on main: the
-     * shell hands each render to it, and a pushed screen waits for its first
-     * render (at most 0.3 s) so it never slides in empty.
-     */
-    nativeScriptThread?: 'main' | 'background';
-    /**
-     * 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
-     * root path, as the page's tab links name it.
-     */
-    tabs?: CraftTab[];
-    /**
-     * Hybrid: web-storage keys the page writes (localStorage or
-     * sessionStorage) that native screens need, mirrored into the Keychain
-     * under the name given, e.g. `{ "auth_token": "auth.token" }` for
-     * `craft.secureStorage.getSync('auth.token')`. Turns on secure storage.
-     */
-    shareStorage?: Record<string, string>;
-    /**
-     * The secure-storage key the signed-in account's token lives under
-     * (default `auth.token`). `craft.session` follows it: a change of it, made
-     * by any native screen or by the page through a `shareStorage` key, is
-     * `SESSION_CHANGED { key, token, previous }` on every native screen and a
-     * `craftsession` event on the page.
-     */
-    sessionTokenKey?: string;
-    /**
-     * Crash and error reporting to bughq (CraftCrashReporter.swift): crashes
-     * and hangs (signal handlers, NSException, MetricKit), uncaught JavaScript
-     * errors in native screens and the app script, and what the page sends
-     * through `craft.crashReporter`. Queued on disk and sent when online.
-     */
-    crashReporting?: CraftCrashReporting;
-}
-export interface CraftCrashReporting {
-    /** The bughq project's public ingest key. Ships in the app; it is not a secret. */
-    key: string;
-    /** The bughq host. Default https://bughq.org. */
-    host?: string;
-    /** Default `production`. */
-    environment?: string;
-    /** The release every event names. Default `<version>+<build>`, e.g. `1.0.0+41`. */
-    release?: string;
-    /** One session per launch, for crash-free sessions per release. Default on. */
-    sessions?: boolean;
-}
-export interface CraftTab {
-    /** The tab's root path; comes back to the page in `craftTabSelect`. */
-    id: string;
-    title: string;
-    /** An SF Symbol name. */
-    symbol?: string;
-    /** Native selected-tab icon overrides; retained pushed screens keep their owning tab's policy. */
-    selectedSymbol?: string;
-    selectedIconTint?: string;
-    /** False suppresses the legacy pulse while selected; omission uses the legacy policy. */
-    selectedIconPulse?: boolean;
-}
-/** `/a//b/?q#h` → `/a/b`, the way the shell and the page compare paths. Null for a relative path. */
-export declare function normalizeNativePath(raw: string): string | null;
-export interface NativePathMatch {
-    path: string;
-    screen: string;
-    params: Record<string, string>;
-}
-/**
- * The native screen for a path, by the rules the shell (`CraftHybridRoutes`)
- * and the page script apply: static segments win over `:params`, which win
- * over a trailing `*`; query items become params under the path's own.
- */
-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' | 'devServerURL' | 'nativeApp' | 'nativeScriptThread'>): string[];
-/**
- * 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 ['barometer', 'pedometer', 'healthKitBackground'];
-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/`): read when the screen first
- * looks inside them (`__stxNativeReadMessages`). Stacks leaves the languages
- * out of the screens' code only when this is true.
- */
-export declare const nativeMessages = true;
-export interface CraftBackgroundRefresh {
-    enabled: boolean;
-    /** The BGTaskScheduler identifier. Default `<bundleId>.refresh`. */
-    identifier?: string;
-    /** The soonest iOS may run it again, in minutes. Default 15. */
-    minimumIntervalMinutes?: number;
-}
-export interface CraftPrivacyDataType {
-    type: string;
-    linked?: boolean;
-    tracking?: boolean;
-    purposes: string[];
-}
-export interface CraftPrivacyAccessedApiType {
-    type: string;
-    reasons: string[];
-}
-export interface CraftPrivacyManifest {
-    tracking?: boolean;
-    trackingDomains?: string[];
-    collectedDataTypes?: CraftPrivacyDataType[];
-    accessedApiTypes?: CraftPrivacyAccessedApiType[];
-}
-export interface InitOptions {
-    name: string;
-    bundleId?: string;
-    teamId?: string;
-    output: string;
-    config?: Partial<CraftConfig>;
-    /**
-     * Where the Zig runtime archives live, overriding `CRAFT_IOS_RUNTIME`.
-     *
-     * `null` means "no runtime, whatever the environment says" — the shape
-     * `AppConfig.craftPath` has for `CRAFT_BIN`, and the reason it exists here
-     * is the same: a caller that does not opt in should not be steered by an
-     * ambient variable. Without it this package's own tests inherited whatever
-     * the developer's shell exported, and went from 12 passing to 8 passing and
-     * 4 failing when `CRAFT_IOS_RUNTIME` happened to be set.
-     *
-     * Omitted (`undefined`) keeps the environment lookup, which is what the
-     * monorepo dev loop uses.
-     */
-    runtimeDir?: string | null;
-    /** Explicit Craft Zig source package for a per-app runtime build (or CRAFT_IOS_RUNTIME_SOURCE). */
-    runtimeSource?: string | null;
-}
-export interface BuildOptions {
-    htmlPath?: string;
-    /** JavaScript bundle emitted by `stx native compile Screen.stx --format bundle`. */
-    nativeBundlePath?: string;
-    devServer?: string;
-    output: string;
-    generateProject?: boolean;
-    /**
-     * Where to re-read the Zig runtime archives from, overriding
-     * `CRAFT_IOS_RUNTIME`. Same meaning as `InitOptions.runtimeDir`; `null`
-     * leaves whatever `init` installed exactly as it is.
-     */
-    runtimeDir?: string | null;
-    /** Rebuild the installed runtime from this source using the app's current feature flags. */
-    runtimeSource?: 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 {
-    simulator: boolean;
-    output: string;
-}
-export declare function renderDeviceFamilies(config: CraftConfig): string;
-/** `appearance` when set, otherwise what the older `darkMode` switch pinned. */
-export declare function resolveAppearance(config: Pick<CraftConfig, 'appearance' | 'darkMode'>): CraftAppearance;
-/**
- * The Info.plist interface style and the status bar that reads on it.
- *
- * The status bar used to be `LightContent` whatever the app looked like:
- * white text that vanished on a light page. It now follows the appearance —
- * dark text on a light app, light on a dark one, and the system's choice when
- * the app follows the system.
- */
-export declare function renderAppearance(config: Pick<CraftConfig, 'appearance' | 'darkMode'>): {
-    interfaceStyle: string;
-    statusBarStyle: string;
-};
-export declare function renderUsageDescriptions(config: CraftConfig): string;
-export declare function renderOrientations(config: CraftConfig): string;
-/** WKAppBoundDomains: the configured domains plus the dev server's host, at most 10. */
-export declare function renderAppBoundDomains(config: CraftConfig): string;
-export declare function renderUrlTypes(config: CraftConfig): string;
-export declare function renderBackgroundModes(config: CraftConfig): string;
-/** The background refresh task's identifier, or null when it is off. */
-export declare function backgroundRefreshIdentifier(config: Pick<CraftConfig, 'backgroundRefresh' | 'bundleId'>): string | null;
-/** BGTaskSchedulerPermittedIdentifiers: iOS runs no task it does not list. */
-export declare function renderBackgroundTaskIdentifiers(config: Pick<CraftConfig, 'backgroundRefresh' | 'bundleId'>): string;
-/**
- * The associated-domains entitlement's entries. Each needs a service prefix,
- * and a bare host (the easy thing to write) used to be signed as it was and
- * then matched nothing, so universal links silently never opened the app.
- */
-export declare function associatedDomainEntries(domains: string[] | undefined): string[];
-export declare function renderEntitlements(config: CraftConfig): string;
-export declare function renderWatchEntitlements(config: CraftConfig): string;
-/**
- * The build settings that link the Zig runtime into the app target.
- *
- * Two things are load-bearing here:
- *
- * `LIBRARY_SEARCH_PATHS` is written twice, once per SDK, so `-lcraft-ios`
- * resolves to the device archive for a device build and the simulator archive
- * for a simulator one without the flag itself changing. Xcode applies the
- * `[sdk=...]` condition; xcodegen passes these keys through verbatim.
- *
- * The four `-u` flags are the reason anything works at all. Nothing in the
- * Swift source *references* these symbols — `CraftZigRuntime` and
- * `CraftSwiftShim` both find them with `dlsym` at runtime — so a static
- * archive contributes no objects for them and the linker drops the entire
- * runtime as unreachable. `-u` names them as undefined so the objects are
- * pulled in and the symbols end up in the binary for `dlsym` to find.
- *
- * `-u` rather than `-force_load`: forcing the whole archive would pull in
- * every object whether reachable or not, and these four entry points already
- * reach everything the bridge actually uses.
- */
-export declare function renderRuntimeSettings(): string;
-/**
- * Build settings a feature adds to the app target. WorkoutKit is compiled in
- * only for `enableScheduledWorkouts`: CraftScheduledWorkouts.swift imports it
- * behind the `CRAFT_SCHEDULED_WORKOUTS` condition, so an app that does not
- * schedule workouts does not link it. `$(inherited)` keeps Debug's `DEBUG`.
- */
-export declare function renderFeatureSettings(config: Partial<CraftConfig>): string;
-export declare function renderPrivacyManifest(config: CraftConfig): string;
-/**
- * Whether a PNG carries an alpha channel, from its header: colour type 4
- * (grey + alpha) or 6 (RGB + alpha), or a tRNS chunk before the image data.
- */
-export declare function pngHasAlpha(bytes: Uint8Array): boolean;
-/** The asset the launch screen and the splash both draw, so one hands over to the other unseen. */
-export declare const LAUNCH_LOGO = "LaunchLogo";
-/**
- * A bitmap splash's `@2x` and `@3x` files beside it (`LaunchLogo.png`,
- * `LaunchLogo@2x.png`, `LaunchLogo@3x.png`, as ts-images'
- * `generateSplashScreens` writes them), by scale. A bitmap without them is
- * one image, drawn at its pixel size in points.
- */
-export declare function splashScales(source: string): Array<{
-    scale: 1 | 2 | 3;
-    path: string;
-}>;
-/** The launch screen: the background colour, and the splash logo on it when there is one. */
-export declare function renderLaunchScreen(config: Pick<CraftConfig, 'splashImagePath'>): string;
-/** Near-black or near-white, whichever reads on `background` (WCAG relative luminance). */
-export declare function readableTextOn(background: string | undefined): string;
-/**
- * The page the app shows when its own page cannot be reached: the generated
- * `dist/index.html` until the app's web assets replace it.
- *
- * An app whose page has a service worker normally opens from it offline, so
- * this only shows on a first launch without one, or when the remote fails
- * hard. It used to be a placeholder that said "Built with Craft iOS" in white
- * on whatever the background was (invisible on a light one) with a bridge
- * status line under it: debug output, in front of the person using the app.
- *
- * Now it says what happened in the app's own colours, light and dark, sized
- * with Dynamic Type, and Retry asks the shell to load the app's page again.
- * The shell also goes back to the app's page by itself when the connection
- * returns, so the page does not retry on `online` as well.
- */
-export declare function renderOfflinePage(config: Pick<CraftConfig, 'appName' | 'backgroundColor' | 'backgroundColorDark'>): string;
-/** Replace the bundled web application atomically so removed assets cannot linger. */
-export declare function syncWebAssets(source: string, output: string): void;
-/**
- * Initialize a new iOS project
- */
-/**
- * Where the Zig runtime archives live, or null when this build has none.
- *
- * `CRAFT_IOS_RUNTIME` points at a directory holding the archives `zig build
- * build-ios-all` produces. It is opt-in and there is deliberately no fallback
- * search: a generated project with no runtime is the shipping default today,
- * and it works — `CraftZigRuntime.offer` is a `dlsym` miss, every action
- * answers false, and the Swift switch serves the whole surface exactly as it
- * always has. Guessing at a path would turn "no runtime" into "some runtime,
- * from somewhere", which is the failure mode the pantry contract exists to
- * rule out.
- *
- * This is the same shape as `CRAFT_BIN`: an explicit override for the monorepo
- * dev loop, not a lookup path. Shipping the runtime to real apps means putting
- * these archives in the pantry package beside the `craft` binary, which is a
- * distribution decision this function does not make.
- *
- * `override` is what `InitOptions.runtimeDir` passes: a path to use instead of
- * the variable, or `null` to declare there is no runtime regardless of what the
- * environment says. `undefined` falls through to `CRAFT_IOS_RUNTIME`.
- */
-export declare function resolveRuntimeDir(override?: string | null): string | null;
-/**
- * Copy the Zig archives into the generated project as `Runtime/<sdk>/libcraft-ios.a`.
- *
- * One name for both SDKs, in two directories, because that is what lets a
- * single `-lcraft-ios` in OTHER_LDFLAGS work for device and simulator builds:
- * Xcode picks the directory by SDK and the flag never changes.
- *
- * Returns true when a runtime was installed.
- */
-export declare function installRuntime(output: string, runtimeDir: string, config?: CraftConfig): Promise<boolean>;
-/**
- * The identifier an app's display name becomes wherever Xcode or Swift needs
- * one: the project, the target, the product and the `@main` type.
- *
- * The display name goes in front of people and may say anything; an
- * identifier may not. "HQ.training" used to become `struct HQ.trainingApp`,
- * which does not compile. Words are joined in PascalCase ("HQTraining"), and
- * a name that starts with a digit or has no letters at all still yields a
- * valid Swift type.
- */
-export declare function productName(name: string): string;
-/** Restore package-owned Swift, retaining Xcode metadata and bundled screens.
- * Xcode Cloud assigns the distributed build number independently of the source
- * config; keep the packaged runtime identity in step with Apple's build.
- */
-export declare function restoreShell(output: string): void;
-export { assertNoApplicationSwiftSources, findApplicationSwiftSources } from './source-audit.js';
-export declare function init(options: InitOptions): Promise<void>;
-/**
- * Build web assets and generate Xcode project
- */
-export declare function build(options: BuildOptions): Promise<void>;
-/**
- * Open Xcode project
- */
-export declare function open(options: OpenOptions): Promise<void>;
-/**
- * Build and run on simulator or device
- */
-/** One bootable simulator, as `simctl list` describes it. */
-export interface SimulatorDevice {
-    name: string;
-    udid: string;
-    state: string;
-    runtime: string;
-}
-/**
- * Every available *iOS* simulator, newest runtime first, iPhones before iPads.
- *
- * Exported because the choice is worth testing without a simulator present -
- * `pickSimulator` is the policy and this is the data it reads.
- */
-export declare function orderSimulators(devices: SimulatorDevice[], sdkVersion?: string): SimulatorDevice[];
-/**
- * The device to run on.
- *
- * A booted one first - if the developer already has a simulator open, that is
- * the one they are looking at - then the newest iPhone.
- *
- * This used to be the string `iPhone 15`, hard-coded into the `-destination`
- * argument. On a machine whose Xcode ships iPhone 17 and no iPhone 15, that is
- * not a fallback, it is `xcodebuild: error: Unable to find a device named
- * 'iPhone 15'` - the command fails for a reason that has nothing to do with the
- * app being built, and the fix is invisible from the error.
- */
-export declare function pickSimulator(): Promise<SimulatorDevice | null>;
-/**
- * Boot it, and wait until it can actually do something.
- *
- * `simctl boot` returns as soon as the device starts booting, and a device
- * that reports `Booted` is minutes away from being able to install anything on
- * a cold runtime. `bootstatus` is the wait, and skipping it is why a first run
- * on a fresh machine fails where the second succeeds.
- */
-export declare function bootSimulator(device: SimulatorDevice): Promise<void>;
-/**
- * Bring the Simulator window to the front, if it can be found.
- *
- * `open -a Simulator` resolves through LaunchServices, and LaunchServices only
- * knows the name if a Simulator.app has been registered under it - which is not
- * true on a machine running Xcode-beta, where the answer is `Unable to find
- * application named 'Simulator'`. The app is always at a known path under the
- * *selected* developer directory, so that is tried first.
- *
- * Never throws. The window is a convenience: the app is installed and launched
- * either way, and failing the whole run because a window did not come to the
- * front would be reporting a cosmetic problem as a build failure.
- */
-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, TimedTouchPoint } from './testing.js';
+export * from './internal/ios/src/index.js'