@craft-native/ios 0.0.91 → 0.0.94

package/dist/cli.js

@@ -0,0 +1,751 @@
+#!/usr/bin/env bun
+// @bun
+
+// src/cli.ts
+import { parseArgs } from "util";
+
+// src/index.ts
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "fs";
+import { dirname, join, resolve } from "path";
+var {$ } = globalThis.Bun;
+var TEMPLATES_DIR = join(dirname(import.meta.dir), "templates");
+var DEFAULT_CONFIG = {
+  version: "1.0.0",
+  buildNumber: "1",
+  darkMode: true,
+  backgroundColor: "#0b1712",
+  enableSpeechRecognition: false,
+  enableHaptics: false,
+  enableShare: false,
+  enableCamera: false,
+  enableBiometric: false,
+  enablePushNotifications: false,
+  enableSecureStorage: false,
+  enableGeolocation: false,
+  enableClipboard: false,
+  enableContacts: false,
+  enableCalendar: false,
+  enableLocalNotifications: false,
+  enableInAppPurchase: false,
+  enableKeepAwake: false,
+  enableOrientationLock: false,
+  enableDeepLinks: false,
+  enableQRScanner: false,
+  enableFilePicker: false,
+  enableFileDownload: false,
+  enableSocialAuth: false,
+  enableAudioRecording: false,
+  enableVideoRecording: false,
+  enableMotionSensors: false,
+  enableLocalDatabase: false,
+  enableBluetooth: false,
+  enableNFC: false,
+  enableHealthKit: false,
+  enableLiveActivities: false,
+  enableWatchApp: false,
+  enableBackgroundLocation: false,
+  enableBackgroundTasks: false,
+  enableScreenCapture: false,
+  enablePDFViewer: false,
+  enableAR: false,
+  enableMLKit: false,
+  iosVersion: "16.0",
+  watchosVersion: "9.0",
+  teamId: "",
+  trustedOrigins: [],
+  associatedDomains: [],
+  appGroups: [],
+  orientations: ["portrait"],
+  deviceFamilies: ["iphone", "ipad"]
+};
+function renderDeviceFamilies(config) {
+  const values = new Set(((config.deviceFamilies?.length) ? config.deviceFamilies : ["iphone", "ipad"]).map((family) => family === "ipad" ? "2" : "1"));
+  return [...values].join(",");
+}
+function xmlEscape(value) {
+  return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll(/\u0027/g, "&apos;");
+}
+function plistString(key, value) {
+  return `    <key>${key}</key>
+    <string>${xmlEscape(value)}</string>`;
+}
+function renderUsageDescriptions(config) {
+  const entries = [
+    [config.enableSpeechRecognition, "NSSpeechRecognitionUsageDescription", `${config.appName} uses speech recognition for voice input.`],
+    [config.enableSpeechRecognition || config.enableAudioRecording, "NSMicrophoneUsageDescription", `${config.appName} uses the microphone to record audio.`],
+    [config.enableCamera || config.enableVideoRecording || config.enableQRScanner || config.enableAR, "NSCameraUsageDescription", `${config.appName} uses the camera for photos, video, scanning, and augmented reality.`],
+    [config.enableCamera || config.enableVideoRecording, "NSPhotoLibraryUsageDescription", `${config.appName} lets you choose photos and videos from your library.`],
+    [config.enableGeolocation || config.enableBackgroundLocation, "NSLocationWhenInUseUsageDescription", `${config.appName} uses your location while you record an activity.`],
+    [config.enableBackgroundLocation, "NSLocationAlwaysAndWhenInUseUsageDescription", `${config.appName} continues recording your route when the screen is locked or the app is in the background.`],
+    [config.enableContacts, "NSContactsUsageDescription", `${config.appName} accesses contacts only when you choose a contact feature.`],
+    [config.enableCalendar, "NSCalendarsUsageDescription", `${config.appName} accesses your calendar only when you choose a calendar feature.`],
+    [config.enableBluetooth, "NSBluetoothAlwaysUsageDescription", `${config.appName} uses Bluetooth to connect to nearby devices.`],
+    [config.enableMotionSensors, "NSMotionUsageDescription", `${config.appName} uses motion data for activity features.`],
+    [config.enableNFC, "NFCReaderUsageDescription", `${config.appName} reads NFC tags when you start a scan.`],
+    [config.enableHealthKit, "NSHealthShareUsageDescription", `${config.appName} reads health data you choose to share.`],
+    [config.enableHealthKit, "NSHealthUpdateUsageDescription", `${config.appName} writes health data only with your permission.`],
+    [config.enableBiometric, "NSFaceIDUsageDescription", `${config.appName} uses Face ID to protect your account.`]
+  ];
+  return entries.filter(([enabled]) => enabled).map(([, key, value]) => plistString(key, value)).join(`
+`);
+}
+function renderOrientations(config) {
+  const names = {
+    portrait: "UIInterfaceOrientationPortrait",
+    "landscape-left": "UIInterfaceOrientationLandscapeLeft",
+    "landscape-right": "UIInterfaceOrientationLandscapeRight",
+    "portrait-upside-down": "UIInterfaceOrientationPortraitUpsideDown"
+  };
+  const values = config.orientations?.length ? config.orientations : ["portrait"];
+  return values.map((value) => `        <string>${names[value]}</string>`).join(`
+`);
+}
+function renderUrlTypes(config) {
+  const schemes = [...new Set(config.urlSchemes?.map((value) => value.trim()).filter(Boolean) ?? [])];
+  if (!schemes.length)
+    return "";
+  return `    <key>CFBundleURLTypes</key>
+    <array>
+        <dict>
+            <key>CFBundleURLSchemes</key>
+            <array>
+${schemes.map((value) => `                <string>${xmlEscape(value)}</string>`).join(`
+`)}
+            </array>
+        </dict>
+    </array>`;
+}
+function plistArray(values, indent = 2) {
+  const padding = "    ".repeat(indent);
+  return values.map((value) => `${padding}<string>${xmlEscape(value)}</string>`).join(`
+`);
+}
+function renderBackgroundModes(config) {
+  const modes = new Set;
+  if (config.enableBackgroundLocation)
+    modes.add("location");
+  if (config.enableBackgroundTasks)
+    modes.add("processing");
+  if (config.enablePushNotifications)
+    modes.add("remote-notification");
+  if (!modes.size)
+    return "";
+  return `    <key>UIBackgroundModes</key>
+    <array>
+${plistArray([...modes])}
+    </array>`;
+}
+function renderEntitlements(config) {
+  const entries = [];
+  if (config.associatedDomains?.length) {
+    entries.push(`    <key>com.apple.developer.associated-domains</key>
+    <array>
+${plistArray(config.associatedDomains)}
+    </array>`);
+  }
+  if (config.appGroups?.length) {
+    entries.push(`    <key>com.apple.security.application-groups</key>
+    <array>
+${plistArray(config.appGroups)}
+    </array>`);
+  }
+  if (config.enableHealthKit) {
+    entries.push(`    <key>com.apple.developer.healthkit</key>
+    <true/>`);
+  }
+  if (config.enablePushNotifications) {
+    entries.push(`    <key>aps-environment</key>
+    <string>$(CRAFT_APNS_ENVIRONMENT)</string>`);
+  }
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+${entries.join(`
+`)}
+</dict>
+</plist>
+`;
+}
+function renderWatchEntitlements(config) {
+  const appGroups = config.appGroups?.length ? `    <key>com.apple.security.application-groups</key>
+    <array>
+${plistArray(config.appGroups)}
+    </array>
+` : "";
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+${appGroups}</dict>
+</plist>
+`;
+}
+function renderRuntimeSettings() {
+  return [
+    '      LIBRARY_SEARCH_PATHS[sdk=iphoneos*]: "$(PROJECT_DIR)/Runtime/device"',
+    '      LIBRARY_SEARCH_PATHS[sdk=iphonesimulator*]: "$(PROJECT_DIR)/Runtime/simulator"',
+    '      OTHER_LDFLAGS: "-lcraft-ios -Wl,-u,_craft_ios_handle_action -Wl,-u,_craft_ios_set_webview ' + '-Wl,-u,_craft_ios_deliver_result -Wl,-u,_craft_ios_deliver_error"'
+  ].join(`
+`);
+}
+function renderPrivacyManifest(config) {
+  const privacy = config.privacy ?? {};
+  const collected = privacy.collectedDataTypes ?? [];
+  const accessed = privacy.accessedApiTypes ?? [];
+  const collectedXml = collected.map((item) => `        <dict>
+            <key>NSPrivacyCollectedDataType</key>
+            <string>${xmlEscape(item.type)}</string>
+            <key>NSPrivacyCollectedDataTypeLinked</key>
+            <${item.linked ? "true" : "false"}/>
+            <key>NSPrivacyCollectedDataTypeTracking</key>
+            <${item.tracking ? "true" : "false"}/>
+            <key>NSPrivacyCollectedDataTypePurposes</key>
+            <array>
+${plistArray(item.purposes, 4)}
+            </array>
+        </dict>`).join(`
+`);
+  const accessedXml = accessed.map((item) => `        <dict>
+            <key>NSPrivacyAccessedAPIType</key>
+            <string>${xmlEscape(item.type)}</string>
+            <key>NSPrivacyAccessedAPITypeReasons</key>
+            <array>
+${plistArray(item.reasons, 4)}
+            </array>
+        </dict>`).join(`
+`);
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>NSPrivacyTracking</key>
+    <${privacy.tracking ? "true" : "false"}/>
+    <key>NSPrivacyTrackingDomains</key>
+    <array>
+${plistArray(privacy.trackingDomains ?? [])}
+    </array>
+    <key>NSPrivacyCollectedDataTypes</key>
+    <array>
+${collectedXml}
+    </array>
+    <key>NSPrivacyAccessedAPITypes</key>
+    <array>
+${accessedXml}
+    </array>
+</dict>
+</plist>
+`;
+}
+function renderAssetCatalog(output, config) {
+  const catalog = join(output, "Assets.xcassets");
+  const appIcon = join(catalog, "AppIcon.appiconset");
+  const launchBackground = join(catalog, "LaunchBackground.colorset");
+  mkdirSync(appIcon, { recursive: true });
+  mkdirSync(launchBackground, { recursive: true });
+  writeFileSync(join(catalog, "Contents.json"), `${JSON.stringify({ info: { author: "xcode", version: 1 } }, null, 2)}
+`);
+  const iconFilename = config.appIconPath ? "AppIcon-1024.png" : undefined;
+  if (config.appIconPath) {
+    if (!existsSync(config.appIconPath))
+      throw new Error(`App icon not found: ${config.appIconPath}`);
+    cpSync(config.appIconPath, join(appIcon, iconFilename));
+  }
+  writeFileSync(join(appIcon, "Contents.json"), `${JSON.stringify({
+    images: iconFilename ? [{
+      filename: iconFilename,
+      idiom: "universal",
+      platform: "ios",
+      size: "1024x1024"
+    }] : [],
+    info: { author: "xcode", version: 1 }
+  }, null, 2)}
+`);
+  const color = config.backgroundColor?.replace(/^#/, "") || "000000";
+  const normalized = color.length === 3 ? [...color].map((value) => `${value}${value}`).join("") : color.padEnd(6, "0").slice(0, 6);
+  const components = [0, 2, 4].map((index) => (Number.parseInt(normalized.slice(index, index + 2), 16) / 255).toFixed(3));
+  writeFileSync(join(launchBackground, "Contents.json"), `${JSON.stringify({
+    colors: [{
+      color: {
+        "color-space": "srgb",
+        components: { alpha: "1.000", blue: components[2], green: components[1], red: components[0] }
+      },
+      idiom: "universal"
+    }],
+    info: { author: "xcode", version: 1 }
+  }, null, 2)}
+`);
+}
+function syncWebAssets(source, output) {
+  const sourcePath = resolve(source);
+  if (!existsSync(sourcePath))
+    throw new Error(`Web asset path not found: ${source}`);
+  const distDir = join(output, "dist");
+  rmSync(distDir, { recursive: true, force: true });
+  mkdirSync(distDir, { recursive: true });
+  if (statSync(sourcePath).isDirectory()) {
+    cpSync(sourcePath, distDir, { recursive: true });
+  } else {
+    cpSync(sourcePath, join(distDir, "index.html"));
+  }
+  if (!existsSync(join(distDir, "index.html"))) {
+    throw new Error(`Web asset directory must contain index.html: ${source}`);
+  }
+}
+function resolveRuntimeDir(override) {
+  if (override === null)
+    return null;
+  const dir = override ?? process.env.CRAFT_IOS_RUNTIME;
+  if (!dir)
+    return null;
+  if (!existsSync(dir)) {
+    const source = override === undefined ? "CRAFT_IOS_RUNTIME points at" : "runtimeDir is";
+    throw new Error(`${source} ${dir}, which does not exist.`);
+  }
+  return dir;
+}
+var RUNTIME_ARCHIVES = {
+  device: ["libcraft-ios.a"],
+  simulator: ["libcraft-ios-simulator-arm64.a", "libcraft-ios-simulator-x64.a"]
+};
+async function installRuntime(output, runtimeDir) {
+  const resolved = Object.entries(RUNTIME_ARCHIVES).map(([sdk, archives]) => {
+    const present = archives.filter((a) => existsSync(join(runtimeDir, a)));
+    if (present.length === 0) {
+      throw new Error(`${runtimeDir} has none of ${archives.join(", ")}. ` + `Run \`zig build build-ios-all\` in packages/zig and point at its zig-out/lib.`);
+    }
+    return { sdk, archives, present };
+  });
+  const dest = join(output, "Runtime");
+  rmSync(dest, { recursive: true, force: true });
+  for (const { sdk, archives, present } of resolved) {
+    const sdkDir = join(dest, sdk);
+    mkdirSync(sdkDir, { recursive: true });
+    const target = join(sdkDir, "libcraft-ios.a");
+    if (present.length === 1) {
+      const missing = archives.filter((a) => !present.includes(a));
+      if (missing.length > 0) {
+        console.warn(`   \u26A0 ${sdk}: only ${present[0]} was found; ${missing.join(", ")} is missing. ` + `The generated project will not link on the other architecture.`);
+      }
+      cpSync(join(runtimeDir, present[0]), target);
+    } else {
+      await $`lipo -create ${present.map((a) => join(runtimeDir, a))} -output ${target}`.quiet();
+    }
+  }
+  return true;
+}
+async function refreshRuntime(output, override) {
+  if (!existsSync(join(output, "Runtime")))
+    return;
+  const dir = resolveRuntimeDir(override);
+  if (!dir) {
+    console.log("   Keeping the Zig runtime installed at init (no runtime directory configured)");
+    return;
+  }
+  await installRuntime(output, dir);
+  console.log("   Refreshed the Zig runtime from", dir);
+}
+async function init(options) {
+  const { name, bundleId, teamId, output } = options;
+  console.log(`
+\u26A1 Initializing Craft iOS project: ${name}`);
+  console.log(`   Output: ${output}
+`);
+  const dirs = [output, join(output, "Sources"), join(output, "Shared"), join(output, "dist")];
+  if (options.config?.enableWatchApp)
+    dirs.push(join(output, "WatchApp"), join(output, "WatchExtension"));
+  for (const dir of dirs) {
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true });
+    }
+  }
+  const finalBundleId = bundleId || `com.craft.${name.toLowerCase().replace(/[^a-z0-9]/g, "")}`;
+  const bundleIdPrefix = finalBundleId.split(".").slice(0, -1).join(".");
+  const config = {
+    ...DEFAULT_CONFIG,
+    appName: name,
+    bundleId: finalBundleId,
+    teamId: teamId || "",
+    ...options.config
+  };
+  if (config.enableBackgroundLocation)
+    config.enableGeolocation = true;
+  writeFileSync(join(output, "craft.config.json"), JSON.stringify(config, null, 2));
+  const swiftTemplate = readFileSync(join(TEMPLATES_DIR, "CraftApp.swift"), "utf-8");
+  const swiftSource = swiftTemplate.replace(/CraftApp/g, `${name}App`).replace(/\{\{BUNDLE_ID\}\}/g, finalBundleId);
+  writeFileSync(join(output, "Sources", `${name}App.swift`), swiftSource);
+  const infoPlistTemplate = readFileSync(join(TEMPLATES_DIR, "Info.plist.template"), "utf-8");
+  const infoPlist = infoPlistTemplate.replace(/\{\{APP_NAME\}\}/g, name).replace(/\{\{BUNDLE_ID\}\}/g, finalBundleId).replace(/\{\{VERSION\}\}/g, config.version || "1.0.0").replace(/\{\{BUILD_NUMBER\}\}/g, config.buildNumber || "1").replace(/\{\{UI_STYLE\}\}/g, config.darkMode ? "Dark" : "Light").replace(/\{\{ORIENTATIONS\}\}/g, renderOrientations(config)).replace(/\{\{USAGE_DESCRIPTIONS\}\}/g, renderUsageDescriptions(config)).replace(/\{\{URL_TYPES\}\}/g, renderUrlTypes(config)).replace(/\{\{BACKGROUND_MODES\}\}/g, renderBackgroundModes(config)).replace(/\{\{LIVE_ACTIVITY_SUPPORT\}\}/g, config.enableLiveActivities ? `    <key>NSSupportsLiveActivities</key>
+    <true/>
+    <key>NSSupportsLiveActivitiesFrequentUpdates</key>
+    <true/>` : "");
+  writeFileSync(join(output, "Info.plist"), infoPlist);
+  const projectYmlTemplate = readFileSync(join(TEMPLATES_DIR, "project.yml.template"), "utf-8");
+  const nativeDependencies = [];
+  if (config.enableLiveActivities)
+    nativeDependencies.push(`      - target: ${name}LiveActivity`);
+  if (config.enableWatchApp)
+    nativeDependencies.push(`      - target: ${name}Watch
+        embed: true`);
+  const nativeTargets = [];
+  if (config.enableLiveActivities) {
+    nativeTargets.push(`  ${name}LiveActivity:
+    type: app-extension
+    platform: iOS
+    deploymentTarget: "16.2"
+    sources:
+      - WidgetExtension
+      - Shared
+    settings:
+      INFOPLIST_FILE: WidgetExtension/Info.plist
+      PRODUCT_BUNDLE_IDENTIFIER: ${finalBundleId}.liveactivity
+      SWIFT_VERSION: "5.0"
+      APPLICATION_EXTENSION_API_ONLY: YES
+      SKIP_INSTALL: YES`);
+  }
+  if (config.enableWatchApp) {
+    nativeTargets.push(`  ${name}Watch:
+    type: application.watchapp2
+    platform: watchOS
+    deploymentTarget: "${config.watchosVersion || "9.0"}"
+    sources:
+      - WatchApp
+    settings:
+      INFOPLIST_FILE: WatchApp/Info.plist
+      CODE_SIGN_ENTITLEMENTS: WatchApp/Watch.entitlements
+      PRODUCT_BUNDLE_IDENTIFIER: ${finalBundleId}.watchkitapp
+      SWIFT_VERSION: "5.0"
+      SKIP_INSTALL: YES
+    dependencies:
+      - target: ${name}WatchExtension
+  ${name}WatchExtension:
+    type: watchkit2-extension
+    platform: watchOS
+    deploymentTarget: "${config.watchosVersion || "9.0"}"
+    sources:
+      - WatchExtension
+    settings:
+      INFOPLIST_FILE: WatchExtension/Info.plist
+      CODE_SIGN_ENTITLEMENTS: WatchExtension/Watch.entitlements
+      PRODUCT_BUNDLE_IDENTIFIER: ${finalBundleId}.watchkitapp.watchkitextension
+      SWIFT_VERSION: "5.0"
+      APPLICATION_EXTENSION_API_ONLY: YES
+      SKIP_INSTALL: YES`);
+  }
+  const runtimeDir = resolveRuntimeDir(options.runtimeDir);
+  const hasRuntime = runtimeDir ? await installRuntime(output, runtimeDir) : false;
+  if (hasRuntime) {
+    console.log("   Linked the Zig runtime from", runtimeDir);
+  } else {
+    rmSync(join(output, "Runtime"), { recursive: true, force: true });
+  }
+  const projectYml = projectYmlTemplate.replace(/\{\{CRAFT_RUNTIME_SETTINGS\}\}/g, hasRuntime ? renderRuntimeSettings() : "").replace(/\{\{APP_NAME\}\}/g, name).replace(/\{\{BUNDLE_ID\}\}/g, finalBundleId).replace(/\{\{BUNDLE_ID_PREFIX\}\}/g, bundleIdPrefix).replace(/\{\{VERSION\}\}/g, config.version || "1.0.0").replace(/\{\{BUILD_NUMBER\}\}/g, config.buildNumber || "1").replace(/\{\{IOS_VERSION\}\}/g, config.iosVersion || "15.0").replace(/\{\{DEVICE_FAMILIES\}\}/g, renderDeviceFamilies(config)).replace(/\{\{TEAM_ID\}\}/g, teamId || "").replace(/\{\{NATIVE_DEPENDENCIES\}\}/g, nativeDependencies.length ? `    dependencies:
+${nativeDependencies.join(`
+`)}` : "").replace(/\{\{NATIVE_TARGETS\}\}/g, nativeTargets.join(`
+`));
+  writeFileSync(join(output, "project.yml"), projectYml);
+  writeFileSync(join(output, "Craft.entitlements"), renderEntitlements(config));
+  writeFileSync(join(output, "PrivacyInfo.xcprivacy"), renderPrivacyManifest(config));
+  renderAssetCatalog(output, config);
+  cpSync(join(TEMPLATES_DIR, "CraftActivityAttributes.swift"), join(output, "Shared", "CraftActivityAttributes.swift"));
+  if (config.enableLiveActivities) {
+    mkdirSync(join(output, "WidgetExtension"), { recursive: true });
+    const widgetSource = readFileSync(join(TEMPLATES_DIR, "CraftLiveActivityWidget.swift.template"), "utf8").replace(/\{\{APP_NAME\}\}/g, name);
+    writeFileSync(join(output, "WidgetExtension", `${name}LiveActivity.swift`), widgetSource);
+    const widgetInfo = readFileSync(join(TEMPLATES_DIR, "WidgetExtension.Info.plist"), "utf8");
+    writeFileSync(join(output, "WidgetExtension", "Info.plist"), widgetInfo);
+  }
+  if (config.enableWatchApp) {
+    const watchSource = readFileSync(join(TEMPLATES_DIR, "CraftWatchApp.swift.template"), "utf8").replace(/\{\{APP_NAME\}\}/g, name);
+    writeFileSync(join(output, "WatchExtension", `${name}WatchApp.swift`), watchSource);
+    const watchInfo = readFileSync(join(TEMPLATES_DIR, "WatchApp.Info.plist.template"), "utf8").replace(/\{\{APP_NAME\}\}/g, name).replace(/\{\{BUNDLE_ID\}\}/g, finalBundleId);
+    writeFileSync(join(output, "WatchApp", "Info.plist"), watchInfo);
+    writeFileSync(join(output, "WatchApp", "Watch.entitlements"), renderWatchEntitlements(config));
+    const watchExtensionInfo = readFileSync(join(TEMPLATES_DIR, "WatchExtension.Info.plist.template"), "utf8").replace(/\{\{APP_NAME\}\}/g, name).replace(/\{\{BUNDLE_ID\}\}/g, finalBundleId);
+    writeFileSync(join(output, "WatchExtension", "Info.plist"), watchExtensionInfo);
+    writeFileSync(join(output, "WatchExtension", "Watch.entitlements"), renderWatchEntitlements(config));
+  }
+  const placeholderHtml = `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="viewport-fit=cover, width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
+  <title>${name}</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: -apple-system, system-ui, sans-serif;
+      background: ${config.backgroundColor};
+      color: white;
+      min-height: 100vh;
+      display: flex;
+      justify-content: center;
+      align-items: center;
+      padding: env(safe-area-inset-top) env(safe-area-inset-right) env(safe-area-inset-bottom) env(safe-area-inset-left);
+    }
+    .container { text-align: center; padding: 2rem; }
+    h1 { font-size: 2.5rem; margin-bottom: 1rem; }
+    p { opacity: 0.7; }
+    .ready { color: #4ade80; font-size: 0.9rem; margin-top: 2rem; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <h1>\u26A1 ${name}</h1>
+    <p>Built with Craft iOS</p>
+    <p class="ready" id="status">Waiting for Craft bridge...</p>
+  </div>
+  <script>
+    window.addEventListener('craftReady', (e) => {
+      document.getElementById('status').textContent = \`\u2713 Craft bridge ready (platform: \${e.detail.platform})\`;
+      console.log('Craft capabilities:', e.detail.capabilities);
+    });
+  </script>
+</body>
+</html>`;
+  writeFileSync(join(output, "dist", "index.html"), placeholderHtml);
+  console.log("\u2705 Project initialized");
+  console.log("");
+  console.log("Next steps:");
+  console.log(`  1. cd ${output}`);
+  console.log("  2. Add your web content to dist/index.html");
+  console.log("  3. Run: craft ios build");
+  console.log("  4. Run: craft ios open");
+  console.log("");
+}
+async function build(options) {
+  const { htmlPath, devServer, output, generateProject = true } = options;
+  console.log(`
+\uD83D\uDCE6 Building Craft iOS project...`);
+  const configPath = join(output, "craft.config.json");
+  if (!existsSync(configPath)) {
+    throw new Error(`No craft.config.json found in ${output}. Run 'craft ios init' first.`);
+  }
+  const config = JSON.parse(readFileSync(configPath, "utf-8"));
+  if (devServer) {
+    config.devServerURL = devServer;
+    const origin = new URL(devServer).origin;
+    config.trustedOrigins = [...new Set([...config.trustedOrigins ?? [], origin])];
+    writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log(`   Dev server: ${devServer}`);
+  }
+  if (htmlPath) {
+    syncWebAssets(htmlPath, output);
+    console.log(`   Synced: ${htmlPath} \u2192 dist/`);
+  }
+  await refreshRuntime(output, options.runtimeDir);
+  if (!generateProject)
+    return;
+  try {
+    const result = await $`which xcodegen`.quiet();
+    if (result.exitCode === 0) {
+      console.log("   Running xcodegen...");
+      await $`cd ${output} && xcodegen generate`.quiet();
+      console.log(`\u2705 Xcode project created: ${config.appName}.xcodeproj`);
+    } else {
+      throw new Error("xcodegen not found");
+    }
+  } catch (error) {
+    throw new Error("Unable to generate the Xcode project. Install xcodegen with `brew install xcodegen`.", {
+      cause: error
+    });
+  }
+  console.log("");
+}
+async function open(options) {
+  const { output } = options;
+  const files = readdirSync(output);
+  const xcodeproj = files.find((f) => f.endsWith(".xcodeproj"));
+  if (!xcodeproj) {
+    throw new Error(`No Xcode project found in ${output}. Run 'craft ios build' first.`);
+  }
+  const projectPath = join(output, xcodeproj);
+  console.log(`\uD83D\uDE80 Opening ${xcodeproj}...`);
+  await $`open ${projectPath}`;
+}
+function orderSimulators(devices) {
+  return devices.filter((device) => device.runtime.startsWith("iOS")).sort((left, right) => {
+    const booted = Number(right.state === "Booted") - Number(left.state === "Booted");
+    if (booted !== 0)
+      return booted;
+    const phone = Number(right.name.startsWith("iPhone")) - Number(left.name.startsWith("iPhone"));
+    if (phone !== 0)
+      return phone;
+    return right.runtime.localeCompare(left.runtime);
+  });
+}
+async function pickSimulator() {
+  const listed = await $`xcrun simctl list devices available --json`.quiet().nothrow();
+  if (listed.exitCode !== 0)
+    return null;
+  let parsed;
+  try {
+    parsed = JSON.parse(listed.stdout.toString());
+  } catch {
+    return null;
+  }
+  const devices = [];
+  for (const [runtime, list] of Object.entries(parsed.devices ?? {})) {
+    for (const device of list)
+      devices.push({ ...device, runtime: runtime.split(".").pop() ?? runtime });
+  }
+  return orderSimulators(devices)[0] ?? null;
+}
+async function bootSimulator(device) {
+  if (device.state !== "Booted")
+    await $`xcrun simctl boot ${device.udid}`.quiet().nothrow();
+  await $`xcrun simctl bootstatus ${device.udid}`.quiet().nothrow();
+}
+async function showSimulator() {
+  const selected = await $`xcode-select -p`.quiet().nothrow();
+  const developer = selected.exitCode === 0 ? selected.stdout.toString().trim() : "";
+  if (developer) {
+    const app = join(developer, "Applications", "Simulator.app");
+    if (existsSync(app)) {
+      await $`open ${app}`.quiet().nothrow();
+      return;
+    }
+  }
+  await $`open -a Simulator`.quiet().nothrow();
+}
+async function run(options) {
+  const { simulator, output } = options;
+  await build({ output });
+  const files = readdirSync(output);
+  const xcodeproj = files.find((f) => f.endsWith(".xcodeproj"));
+  if (!xcodeproj) {
+    throw new Error(`No Xcode project found in ${output}`);
+  }
+  const projectPath = join(output, xcodeproj);
+  const appName = xcodeproj.replace(".xcodeproj", "");
+  const configPath = join(output, "craft.config.json");
+  if (!existsSync(configPath))
+    throw new Error(`No craft.config.json found in ${output}. Run 'craft-ios init' first.`);
+  const config = JSON.parse(readFileSync(configPath, "utf-8"));
+  if (simulator) {
+    console.log("\uD83D\uDCF1 Building and running on simulator...");
+    const device = await pickSimulator();
+    if (!device) {
+      throw new Error("No iOS simulator is available. Install a runtime with " + "`xcodebuild -downloadPlatform iOS`, then try again.");
+    }
+    console.log(`   Device: ${device.name} (${device.runtime})`);
+    try {
+      await bootSimulator(device);
+      const derivedData = join(output, "build");
+      const product = join(derivedData, "Build", "Products", "Debug-iphonesimulator", `${appName}.app`);
+      await $`xcodebuild -project ${projectPath} -scheme ${appName} -configuration Debug -destination ${`id=${device.udid}`} -derivedDataPath ${derivedData} build`;
+      if (!existsSync(product)) {
+        throw new Error(`xcodebuild reported success but ${product} does not exist. ` + "The scheme may build a different product name than the project.");
+      }
+      await $`xcrun simctl install ${device.udid} ${product}`;
+      await showSimulator();
+      await $`xcrun simctl launch ${device.udid} ${config.bundleId}`;
+      console.log(`\u2705 ${config.appName} is running on ${device.name}`);
+    } catch (error) {
+      throw new Error(`iOS simulator run failed for ${projectPath}`, { cause: error });
+    }
+  } else {
+    console.log("\uD83D\uDCF1 Opening Xcode for device deployment...");
+    await $`open ${projectPath}`;
+    console.log("");
+    console.log("In Xcode:");
+    console.log("  1. Select your Team in Signing & Capabilities");
+    console.log("  2. Connect your iPhone");
+    console.log("  3. Select your device");
+    console.log("  4. Click Run (\u25B6\uFE0F)");
+  }
+}
+
+// src/cli.ts
+var { values, positionals } = parseArgs({
+  args: Bun.argv.slice(2),
+  options: {
+    help: { type: "boolean", short: "h" },
+    version: { type: "boolean", short: "v" },
+    name: { type: "string", short: "n" },
+    "bundle-id": { type: "string", short: "b" },
+    "team-id": { type: "string", short: "t" },
+    "html-path": { type: "string" },
+    "dev-server": { type: "string", short: "d" },
+    output: { type: "string", short: "o" },
+    simulator: { type: "boolean", short: "s" }
+  },
+  allowPositionals: true
+});
+var command = positionals[0];
+if (values.help || !command) {
+  console.log(`
+Craft iOS - Build native iOS apps with web technologies
+
+Usage:
+  craft-ios <command> [options]
+
+Commands:
+  init <name>     Initialize a new iOS project
+  build           Build web assets and generate Xcode project
+  open            Open Xcode project
+  run             Build and run on simulator
+
+Options:
+  -n, --name <name>         App name
+  -b, --bundle-id <id>      Bundle identifier (e.g., com.example.app)
+  -t, --team-id <id>        Apple Developer Team ID
+  --html-path <path>        Path to HTML file or directory
+  -d, --dev-server <url>    Development server URL
+  -o, --output <dir>        Output directory (default: ./ios)
+  -s, --simulator           Run on simulator instead of device
+  -h, --help                Show help
+  -v, --version             Show version
+
+Examples:
+  craft-ios init MyApp
+  craft-ios build --html-path ./dist/index.html
+  craft-ios build --dev-server http://localhost:3456
+  craft-ios run --simulator
+`);
+  process.exit(0);
+}
+if (values.version) {
+  console.log("craft-ios v0.1.0");
+  process.exit(0);
+}
+async function main() {
+  try {
+    switch (command) {
+      case "init":
+        await init({
+          name: positionals[1] || values.name || "CraftApp",
+          bundleId: values["bundle-id"],
+          teamId: values["team-id"],
+          output: values.output || "./ios"
+        });
+        break;
+      case "build":
+        await build({
+          htmlPath: values["html-path"],
+          devServer: values["dev-server"],
+          output: values.output || "./ios"
+        });
+        break;
+      case "open":
+        await open({
+          output: values.output || "./ios"
+        });
+        break;
+      case "run":
+        await run({
+          simulator: values.simulator || false,
+          output: values.output || "./ios"
+        });
+        break;
+      default:
+        console.error(`Unknown command: ${command}`);
+        console.log("Run craft-ios --help for usage");
+        process.exit(1);
+    }
+  } catch (error) {
+    console.error("Error:", error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+}
+main();