craft-native 0.0.236 → 0.0.238

package/dist/index.js

@@ -57,7 +57,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.236";
+var version = "0.0.238";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;
@@ -4981,6 +4981,92 @@ var secureStorage = {
     Object.keys(localStorage).filter((k) => k.startsWith("secure_")).forEach((k) => localStorage.removeItem(k));
   }
 };
+function storageHost(method) {
+  const host2 = getCraftRoot()?.storage;
+  if (typeof host2?.[method] !== "function")
+    throw Object.assign(new Error("This host does not provide native storage"), { code: "STORAGE_UNSUPPORTED" });
+  return host2;
+}
+var storage2 = {
+  supportsSetIfAbsent() {
+    const root = getCraftRoot();
+    const caps = root?.capabilities;
+    const supported = Array.isArray(caps) ? caps.includes("storageSetIfAbsent") : caps?.storageSetIfAbsent === true;
+    return supported && typeof root?.storage?.setIfAbsent === "function";
+  },
+  supportsCompareAndSet() {
+    const root = getCraftRoot();
+    const caps = root?.capabilities;
+    const supported = Array.isArray(caps) ? caps.includes("storageCompareAndSet") : caps?.storageCompareAndSet === true;
+    return supported && typeof root?.storage?.compareAndSet === "function";
+  },
+  async get(key) {
+    return storageHost("get").get(key);
+  },
+  async set(key, value) {
+    return storageHost("set").set(key, value);
+  },
+  async remove(key) {
+    return storageHost("remove").remove(key);
+  },
+  async clear() {
+    return storageHost("clear").clear();
+  },
+  async keys() {
+    return storageHost("keys").keys();
+  },
+  async setIfAbsent(key, value) {
+    if (!storage2.supportsSetIfAbsent())
+      throw Object.assign(new Error("This app build cannot atomically register an intent"), { code: "STORAGE_SET_IF_ABSENT_UNSUPPORTED" });
+    if (typeof key !== "string" || !key.trim() || JSON.stringify(value) === undefined)
+      throw Object.assign(new Error("setIfAbsent needs a key and JSON value"), { code: "INVALID_ARGUMENT" });
+    return storageHost("setIfAbsent").setIfAbsent(key, value);
+  },
+  async compareAndSet(key, expectedValue, nextValue) {
+    if (!storage2.supportsCompareAndSet())
+      throw Object.assign(new Error("This app build cannot atomically checkpoint existing storage"), { code: "STORAGE_COMPARE_AND_SET_UNSUPPORTED" });
+    if (typeof key !== "string" || !key.trim() || JSON.stringify(expectedValue) === undefined || JSON.stringify(nextValue) === undefined)
+      throw Object.assign(new Error("compareAndSet needs a key and JSON values"), { code: "INVALID_ARGUMENT" });
+    return storageHost("compareAndSet").compareAndSet(key, expectedValue, nextValue);
+  }
+};
+function recordingOwnershipSupported(namespace) {
+  const root = getCraftRoot();
+  const flag = namespace === "location" ? "locationRecordingOwnership" : "heartRateRecordingOwnership";
+  const caps = root?.capabilities;
+  const advertised = Array.isArray(caps) ? caps.includes(flag) : caps?.[flag] === true;
+  return advertised && ["pauseRecording", "resumeRecording", "stopRecording", "readRecording", "getRecordingState", "acknowledgeRecording"].every((method) => typeof root?.[namespace]?.[method] === "function");
+}
+function recordingIntentSupported(namespace) {
+  const root = getCraftRoot();
+  const flag = namespace === "location" ? "locationRecordingIntentIdentity" : "heartRateRecordingIntentIdentity";
+  const caps = root?.capabilities;
+  const advertised = Array.isArray(caps) ? caps.includes(flag) : caps?.[flag] === true;
+  return advertised && recordingOwnershipSupported(namespace) && typeof root?.[namespace]?.startRecording === "function";
+}
+function validateRecordingStart(namespace, options) {
+  if (!Object.prototype.hasOwnProperty.call(options, "recordingId"))
+    return;
+  if (typeof options.recordingId !== "string" || !options.recordingId.trim())
+    throw Object.assign(new Error("recordingId must be a nonempty recording ID"), { code: "INVALID_ARGUMENT" });
+  if (!recordingIntentSupported(namespace))
+    throw Object.assign(new Error("This app build cannot start the persisted recording intent"), { code: "RECORDING_INTENT_IDENTITY_UNSUPPORTED" });
+}
+function verifyRecordingStart(options, result) {
+  if (options.recordingId !== undefined && result.id !== options.recordingId)
+    throw Object.assign(new Error("The native recording does not match the persisted intent"), { code: "RECORDING_CONFLICT" });
+  return result;
+}
+function validateRecordingOwnership(namespace, options) {
+  if (!options || !Object.prototype.hasOwnProperty.call(options, "expectedId"))
+    return;
+  if (typeof options.expectedId !== "string" || !options.expectedId.trim())
+    throw Object.assign(new Error("expectedId must be a nonempty recording ID"), { code: "INVALID_ARGUMENT" });
+  if ((getCraftRoot() || namespace === "heartRate") && !recordingOwnershipSupported(namespace))
+    throw Object.assign(new Error("This app build cannot enforce recording ownership"), { code: "RECORDING_OWNERSHIP_UNSUPPORTED" });
+  if (namespace === "location" && !getCraftRoot() && options.expectedId !== webLocationRecording.id)
+    throw Object.assign(new Error("The active location recording has changed"), { code: "RECORDING_CONFLICT" });
+}
 var webLocationRecording = {
   id: null,
   active: false,
@@ -4990,6 +5076,8 @@ var webLocationRecording = {
 };
 var webLocationRecordingWatchId = null;
 var location = {
+  supportsRecordingOwnership: () => recordingOwnershipSupported("location"),
+  supportsRecordingIntentIdentity: () => recordingIntentSupported("location"),
   async getCurrentPosition(options = {}) {
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location) {
@@ -5038,9 +5126,12 @@ var location = {
     navigator.geolocation.clearWatch(watchId);
   },
   async startRecording(options = {}) {
+    validateRecordingStart("location", options);
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.startRecording)
-      return craft.location.startRecording(options);
+      return verifyRecordingStart(options, await craft.location.startRecording(options));
+    if (webLocationRecording.active)
+      throw Object.assign(new Error("A location recording is already active"), { code: "RECORDING_ALREADY_ACTIVE" });
     if (webLocationRecordingWatchId !== null)
       navigator.geolocation.clearWatch(webLocationRecordingWatchId);
     webLocationRecording = {
@@ -5056,24 +5147,27 @@ var location = {
     }, options);
     return { ...webLocationRecording, sampleCount: 0 };
   },
-  async pauseRecording() {
+  async pauseRecording(options) {
+    validateRecordingOwnership("location", options);
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.pauseRecording)
-      return craft.location.pauseRecording();
+      return craft.location.pauseRecording(options);
     webLocationRecording.paused = true;
     return { ...webLocationRecording, sampleCount: webLocationRecording.locations.length };
   },
-  async resumeRecording() {
+  async resumeRecording(options) {
+    validateRecordingOwnership("location", options);
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.resumeRecording)
-      return craft.location.resumeRecording();
+      return craft.location.resumeRecording(options);
     webLocationRecording.paused = false;
     return { ...webLocationRecording, sampleCount: webLocationRecording.locations.length };
   },
-  async stopRecording() {
+  async stopRecording(options) {
+    validateRecordingOwnership("location", options);
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.stopRecording)
-      return craft.location.stopRecording();
+      return craft.location.stopRecording(options);
     if (webLocationRecordingWatchId !== null) {
       location.clearWatch(webLocationRecordingWatchId);
       webLocationRecordingWatchId = null;
@@ -5082,16 +5176,30 @@ var location = {
     webLocationRecording.paused = false;
     return { ...webLocationRecording, locations: [...webLocationRecording.locations] };
   },
-  async getRecordingState() {
+  async getRecordingState(options) {
+    validateRecordingOwnership("location", options);
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.getRecordingState)
-      return craft.location.getRecordingState();
+      return craft.location.getRecordingState(options);
     return { ...webLocationRecording, sampleCount: webLocationRecording.locations.length };
   },
-  async readRecording() {
+  async acknowledgeRecording(options) {
+    if (!options || !Object.prototype.hasOwnProperty.call(options, "expectedId"))
+      throw Object.assign(new Error("Acknowledgement needs expectedId"), { code: "INVALID_ARGUMENT" });
+    validateRecordingOwnership("location", options);
+    const craft = getCraftMobile();
+    if (craft?.location?.acknowledgeRecording)
+      return craft.location.acknowledgeRecording(options);
+    if (webLocationRecording.active)
+      throw Object.assign(new Error("The recording is still active"), { code: "RECORDING_ALREADY_ACTIVE" });
+    webLocationRecording = { id: null, active: false, paused: false, startedAt: null, locations: [] };
+    return true;
+  },
+  async readRecording(options) {
+    validateRecordingOwnership("location", options);
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.location?.readRecording)
-      return craft.location.readRecording();
+      return craft.location.readRecording(options);
     return [...webLocationRecording.locations];
   }
 };
@@ -5213,6 +5321,11 @@ function onCraftEvent(eventName, callback) {
   globalThis.addEventListener(eventName, listener);
   return () => globalThis.removeEventListener(eventName, listener);
 }
+function getCraftRoot() {
+  if (typeof window === "undefined")
+    return;
+  return window.craft;
+}
 function detectPlatform2() {
   if (typeof window === "undefined")
     return "linux";
@@ -11296,6 +11409,7 @@ export {
   styles,
   style,
   storeKit,
+  storage2 as storage,
   stat,
   startupTask,
   stageManager,

package/dist/ios/src/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/ios/src/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/ios/src/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;
 
+// ../ios/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}
+    }
+}
+` : ""}`;
+}
+
 // ../ios/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/ios/src/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;
 }