@craft-native/ios 0.0.236 → 0.0.238

package/dist/app-shortcuts.d.ts

@@ -0,0 +1,11 @@
+export interface CraftAppShortcut {
+    id: string;
+    title: string;
+    subtitle?: string;
+    symbol: string;
+    url: string;
+    /** Each phrase includes exactly one `{app}` token for Siri's app name. */
+    phrases: string[];
+}
+/** Build-owned App Intents survive shell restoration and need no app Swift. */
+export declare function appShortcutsSwift(shortcuts?: CraftAppShortcut[], schemes?: string[]): string;

package/dist/cli.js

@@ -10,6 +10,60 @@ import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync as readdirSync
 import { dirname as dirname2, extname, join as join3, resolve, sep as sep2 } from "path";
 var {$ } = globalThis.Bun;
 
+// src/app-shortcuts.ts
+function literal(value) {
+  return `"${value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"").replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t")}"`;
+}
+function appShortcutsSwift(shortcuts = [], schemes = []) {
+  if (shortcuts.length > 10)
+    throw new Error("iOS supports at most ten app shortcuts");
+  const ids = new Set;
+  for (const shortcut of shortcuts) {
+    if (!/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(shortcut.id) || ids.has(shortcut.id))
+      throw new Error(`Invalid or duplicate app shortcut id: ${shortcut.id}`);
+    ids.add(shortcut.id);
+    const scheme = /^([a-z][a-z0-9+.-]*):\/\//i.exec(shortcut.url)?.[1];
+    if (!scheme || !schemes.includes(scheme) || /[\s\\]/.test(shortcut.url))
+      throw new Error(`App shortcut ${shortcut.id} needs a registered app URL scheme`);
+    if (!shortcut.title?.trim() || !shortcut.symbol?.trim() || !shortcut.phrases?.length || shortcut.phrases.some((phrase) => phrase.split("{app}").length !== 2))
+      throw new Error(`App shortcut ${shortcut.id} needs a title, symbol and phrases with exactly one {app}`);
+  }
+  const name = (id) => `CraftShortcut${id.split("-").map((part) => part[0].toUpperCase() + part.slice(1)).join("")}Intent`;
+  const intents = shortcuts.map((shortcut) => `@available(iOS 16.4, *)
+struct ${name(shortcut.id)}: AppIntent {
+    static var title: LocalizedStringResource = ${literal(shortcut.title)}
+    static var description = IntentDescription(${literal(shortcut.subtitle ?? shortcut.title)})
+    static var openAppWhenRun: Bool = true
+    @MainActor
+    func perform() async throws -> some IntentResult {
+        if let url = URL(string: ${literal(shortcut.url)}) { await UIApplication.shared.open(url) }
+        return .result()
+    }
+}`).join(`
+
+`);
+  const entries = shortcuts.map((shortcut) => `        AppShortcut(
+            intent: ${name(shortcut.id)}(),
+            phrases: [${shortcut.phrases.map((phrase) => literal(phrase).replace("{app}", "\\(.applicationName)")).join(", ")}],
+            shortTitle: ${literal(shortcut.title)},
+            systemImageName: ${literal(shortcut.symbol)}
+        )`).join(`
+`);
+  return `// Generated by Craft from appShortcuts. Restored from the package at build time.
+import AppIntents
+import UIKit
+
+${intents}
+${shortcuts.length ? `
+@available(iOS 16.4, *)
+struct CraftConfiguredAppShortcuts: AppShortcutsProvider {
+    static var appShortcuts: [AppShortcut] {
+${entries}
+    }
+}
+` : ""}`;
+}
+
 // src/source-audit.ts
 import { readdirSync } from "fs";
 import { join, relative, sep } from "path";
@@ -890,11 +944,13 @@ function writeShell(output, config) {
   if (!config.appName || !/^[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+$/.test(config.bundleId))
     throw new Error("The iOS shell needs an appName and a valid bundleId in craft.config.json.");
   const name = productName(config.appName);
+  const shortcutSource = appShortcutsSwift(config.appShortcuts, config.urlSchemes);
   mkdirSync(join3(output, "Sources"), { recursive: true });
   mkdirSync(join3(output, "Shared"), { recursive: true });
   const swiftTemplate = readFileSync(join3(TEMPLATES_DIR, "CraftApp.swift"), "utf-8");
   const swiftSource = swiftTemplate.replace(/CraftApp/g, `${name}App`).replace(/\{\{BUNDLE_ID\}\}/g, config.bundleId).replace(/\{\{CRAFT_VERSION\}\}/g, CRAFT_VERSION);
   writeFileSync(join3(output, "Sources", `${name}App.swift`), swiftSource);
+  writeFileSync(join3(output, "Sources", "CraftAppShortcuts.swift"), shortcutSource);
   cpSync(join3(TEMPLATES_DIR, "CraftNativeScreen.swift"), join3(output, "Sources", "CraftNativeScreen.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftNativeFlatList.swift"), join3(output, "Sources", "CraftNativeFlatList.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftNativeActions.swift"), join3(output, "Sources", "CraftNativeActions.swift"));
@@ -902,6 +958,8 @@ function writeShell(output, config) {
   cpSync(join3(TEMPLATES_DIR, "CraftMusic.swift"), join3(output, "Sources", "CraftMusic.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftBluetooth.swift"), join3(output, "Sources", "CraftBluetooth.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftHeartRate.swift"), join3(output, "Sources", "CraftHeartRate.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftRecordingArchive.swift"), join3(output, "Sources", "CraftRecordingArchive.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftPersistentStorage.swift"), join3(output, "Sources", "CraftPersistentStorage.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftScheduledWorkouts.swift"), join3(output, "Sources", "CraftScheduledWorkouts.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftNativeMutation.swift"), join3(output, "Sources", "CraftNativeMutation.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftNativeUI.swift"), join3(output, "Sources", "CraftNativeUI.swift"));

package/dist/index.d.ts

@@ -3,12 +3,14 @@
  *
  * Generates native iOS apps from web content using WKWebView.
  */
+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';
 export interface CraftConfig {
+    appShortcuts?: CraftAppShortcut[];
     /** Bundled font files keyed by their PostScript font name, used as native fontFamily. */
     nativeFonts?: Record<string, {
         src: string;
@@ -272,6 +274,11 @@ export interface CraftTab {
     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;

package/dist/index.js

@@ -4,6 +4,60 @@ import { cpSync, existsSync, mkdirSync as mkdirSync2, readFileSync as readFileSy
 import { dirname as dirname2, extname, join as join3, resolve, sep as sep2 } from "path";
 var {$ } = globalThis.Bun;
 
+// src/app-shortcuts.ts
+function literal(value) {
+  return `"${value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"").replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t")}"`;
+}
+function appShortcutsSwift(shortcuts = [], schemes = []) {
+  if (shortcuts.length > 10)
+    throw new Error("iOS supports at most ten app shortcuts");
+  const ids = new Set;
+  for (const shortcut of shortcuts) {
+    if (!/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(shortcut.id) || ids.has(shortcut.id))
+      throw new Error(`Invalid or duplicate app shortcut id: ${shortcut.id}`);
+    ids.add(shortcut.id);
+    const scheme = /^([a-z][a-z0-9+.-]*):\/\//i.exec(shortcut.url)?.[1];
+    if (!scheme || !schemes.includes(scheme) || /[\s\\]/.test(shortcut.url))
+      throw new Error(`App shortcut ${shortcut.id} needs a registered app URL scheme`);
+    if (!shortcut.title?.trim() || !shortcut.symbol?.trim() || !shortcut.phrases?.length || shortcut.phrases.some((phrase) => phrase.split("{app}").length !== 2))
+      throw new Error(`App shortcut ${shortcut.id} needs a title, symbol and phrases with exactly one {app}`);
+  }
+  const name = (id) => `CraftShortcut${id.split("-").map((part) => part[0].toUpperCase() + part.slice(1)).join("")}Intent`;
+  const intents = shortcuts.map((shortcut) => `@available(iOS 16.4, *)
+struct ${name(shortcut.id)}: AppIntent {
+    static var title: LocalizedStringResource = ${literal(shortcut.title)}
+    static var description = IntentDescription(${literal(shortcut.subtitle ?? shortcut.title)})
+    static var openAppWhenRun: Bool = true
+    @MainActor
+    func perform() async throws -> some IntentResult {
+        if let url = URL(string: ${literal(shortcut.url)}) { await UIApplication.shared.open(url) }
+        return .result()
+    }
+}`).join(`
+
+`);
+  const entries = shortcuts.map((shortcut) => `        AppShortcut(
+            intent: ${name(shortcut.id)}(),
+            phrases: [${shortcut.phrases.map((phrase) => literal(phrase).replace("{app}", "\\(.applicationName)")).join(", ")}],
+            shortTitle: ${literal(shortcut.title)},
+            systemImageName: ${literal(shortcut.symbol)}
+        )`).join(`
+`);
+  return `// Generated by Craft from appShortcuts. Restored from the package at build time.
+import AppIntents
+import UIKit
+
+${intents}
+${shortcuts.length ? `
+@available(iOS 16.4, *)
+struct CraftConfiguredAppShortcuts: AppShortcutsProvider {
+    static var appShortcuts: [AppShortcut] {
+${entries}
+    }
+}
+` : ""}`;
+}
+
 // src/source-audit.ts
 import { readdirSync } from "fs";
 import { join, relative, sep } from "path";
@@ -79,13 +133,19 @@ function initSimulatorDriver(options) {
     throw new Error("The simulator driver requires iOS 17.0 or newer");
   if (!["http:", "https:"].includes(new URL(control).protocol))
     throw new Error("controlUrl must use HTTP or HTTPS");
+  const tabIdentifiers = Object.entries(options.tabIdentifiers ?? {});
+  for (const [name2, identifier] of tabIdentifiers) {
+    if (!name2.trim() || !identifier.trim())
+      throw new Error("Tab names and native identifiers must be nonempty");
+  }
   const replacements = {
     PROJECT_NAME: name,
     BUNDLE_PREFIX: prefix,
     IOS_VERSION: version,
     BUNDLE_ID: swiftString(bundleId),
     CONTROL_URL: swiftString(control),
-    TABS: `[${(options.tabs ?? []).map(swiftString).join(", ")}]`
+    TABS: `[${(options.tabs ?? []).map(swiftString).join(", ")}]`,
+    TAB_IDENTIFIERS: tabIdentifiers.length ? `[${tabIdentifiers.map(([name2, identifier]) => `${swiftString(name2)}: ${swiftString(identifier)}`).join(", ")}]` : "[:]"
   };
   for (const [source, destination] of [
     ["HostApp.swift", "Host/HostApp.swift"],
@@ -1073,11 +1133,13 @@ function writeShell(output, config) {
   if (!config.appName || !/^[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+$/.test(config.bundleId))
     throw new Error("The iOS shell needs an appName and a valid bundleId in craft.config.json.");
   const name = productName(config.appName);
+  const shortcutSource = appShortcutsSwift(config.appShortcuts, config.urlSchemes);
   mkdirSync2(join3(output, "Sources"), { recursive: true });
   mkdirSync2(join3(output, "Shared"), { recursive: true });
   const swiftTemplate = readFileSync2(join3(TEMPLATES_DIR, "CraftApp.swift"), "utf-8");
   const swiftSource = swiftTemplate.replace(/CraftApp/g, `${name}App`).replace(/\{\{BUNDLE_ID\}\}/g, config.bundleId).replace(/\{\{CRAFT_VERSION\}\}/g, CRAFT_VERSION);
   writeFileSync2(join3(output, "Sources", `${name}App.swift`), swiftSource);
+  writeFileSync2(join3(output, "Sources", "CraftAppShortcuts.swift"), shortcutSource);
   cpSync(join3(TEMPLATES_DIR, "CraftNativeScreen.swift"), join3(output, "Sources", "CraftNativeScreen.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftNativeFlatList.swift"), join3(output, "Sources", "CraftNativeFlatList.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftNativeActions.swift"), join3(output, "Sources", "CraftNativeActions.swift"));
@@ -1085,6 +1147,8 @@ function writeShell(output, config) {
   cpSync(join3(TEMPLATES_DIR, "CraftMusic.swift"), join3(output, "Sources", "CraftMusic.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftBluetooth.swift"), join3(output, "Sources", "CraftBluetooth.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftHeartRate.swift"), join3(output, "Sources", "CraftHeartRate.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftRecordingArchive.swift"), join3(output, "Sources", "CraftRecordingArchive.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftPersistentStorage.swift"), join3(output, "Sources", "CraftPersistentStorage.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftScheduledWorkouts.swift"), join3(output, "Sources", "CraftScheduledWorkouts.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftNativeMutation.swift"), join3(output, "Sources", "CraftNativeMutation.swift"));
   cpSync(join3(TEMPLATES_DIR, "CraftNativeUI.swift"), join3(output, "Sources", "CraftNativeUI.swift"));

package/dist/testing.d.ts

@@ -7,6 +7,8 @@ export interface SimulatorDriverOptions {
     deploymentTarget?: string;
     controlUrl?: string;
     tabs?: readonly string[];
+    /** Stable native accessibility identifiers for tabs whose labels can change. */
+    tabIdentifiers?: Readonly<Record<string, string>>;
     /** Bundle a wire-protocol journey and save native XCTest attachments. No control server is needed on physical devices. */
     script?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craft-native/ios",
-  "version": "0.0.236",
+  "version": "0.0.238",
   "homepage": "https://github.com/craft-native/craft/tree/main/packages/ios#readme",
   "repository": {
     "type": "git",