typeferry 0.10.0 → 0.12.0

package/dist/application/native-devices.js

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+const IOS_RUNTIME = /^com\.apple\.CoreSimulator\.SimRuntime\.iOS-\d+(?:-\d+)*$/;
+const BOOTED_STATE = 'Booted';
+const DISCOVERY_COMMAND = 'typeferry native devices ios';
+const simulatorSchema = z.object({
+    udid: z.uuid(),
+    name: z.string().min(1),
+    state: z.string().min(1),
+    isAvailable: z.boolean(),
+});
+const simulatorListSchema = z.object({
+    devices: z.record(z.string(), z.array(simulatorSchema)),
+});
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function compareSimulators(left, right) {
+    return compareText(left.runtime, right.runtime)
+        || compareText(left.name, right.name)
+        || compareText(left.udid, right.udid);
+}
+/**
+ * Validates consumed simctl fields and discards Apple metadata such as local
+ * filesystem paths. Non-iOS runtimes are excluded, unavailable iOS devices are
+ * retained for diagnostics, and output order does not depend on JSON key order.
+ */
+export function parseIosSimulators(value) {
+    const parsed = simulatorListSchema.safeParse(value);
+    if (!parsed.success) {
+        throw new Error('Invalid iOS simulator device data from xcrun simctl. Check that a supported Xcode installation is selected.');
+    }
+    return Object.entries(parsed.data.devices)
+        .filter(([runtime]) => IOS_RUNTIME.test(runtime))
+        .flatMap(([runtime, devices]) => devices.map(device => ({ ...device, runtime })))
+        .sort(compareSimulators);
+}
+/**
+ * Executes read-only device discovery through the supplied command boundary.
+ */
+export async function readIosSimulators(run) {
+    const { stdout } = await run('xcrun', ['simctl', 'list', 'devices', '--json']);
+    let value;
+    try {
+        value = JSON.parse(stdout);
+    }
+    catch {
+        throw new Error('Invalid JSON from xcrun simctl device discovery. Check that a supported Xcode installation is selected.');
+    }
+    return parseIosSimulators(value);
+}
+function describeCandidates(devices) {
+    return [...devices].sort(compareSimulators).map(device => `  ${device.udid}  ${JSON.stringify(device.name)}  ${device.runtime}  ${JSON.stringify(device.state)}`).join('\n');
+}
+function selectUnique(devices) {
+    if (devices.length === 1 && devices[0])
+        return devices[0];
+    throw new Error(`Multiple iOS simulators match. Choose an exact UDID with --device:\n${describeCandidates(devices)}`);
+}
+function selectExplicit(devices, selector) {
+    const byUdid = devices.filter(device => device.udid.toLowerCase() === selector.toLowerCase());
+    const matches = byUdid.length ? byUdid : devices.filter(device => device.name === selector);
+    const availableMatches = matches.filter(device => device.isAvailable);
+    if (availableMatches.length)
+        return selectUnique(availableMatches);
+    if (matches.length) {
+        throw new Error(`The selected iOS simulator is unavailable. Install its runtime or choose another device with ${DISCOVERY_COMMAND}:\n${describeCandidates(matches)}`);
+    }
+    const available = devices.filter(device => device.isAvailable);
+    throw new Error(`No available iOS simulator matches ${JSON.stringify(selector)}. Run ${DISCOVERY_COMMAND} and select an exact name or UDID with --device.${available.length ? `\n${describeCandidates(available)}` : ''}`);
+}
+/**
+ * Honors explicit identity before defaults. Duplicate names or multiple booted
+ * devices require a human choice; callers always receive a concrete UDID and
+ * must never pass simctl's ambiguous "booted" alias.
+ */
+export function selectIosSimulator(devices, selector) {
+    if (selector !== undefined)
+        return selectExplicit(devices, selector);
+    const available = devices.filter(device => device.isAvailable);
+    if (!available.length) {
+        throw new Error(`No available iOS simulators. Run ${DISCOVERY_COMMAND} and install an iOS simulator runtime in Xcode if needed.`);
+    }
+    const booted = available.filter(device => device.state === BOOTED_STATE);
+    return selectUnique(booted.length ? booted : available);
+}
+/**
+ * Read-only diagnostics cannot implicitly boot or otherwise change a device.
+ */
+export function requireBootedSimulator(device) {
+    if (device.isAvailable && device.state === BOOTED_STATE)
+        return;
+    throw new Error(`iOS simulator ${device.udid} (${JSON.stringify(device.name)}) must be available and booted. Boot this device before requesting logs or a screenshot.`);
+}
+//# sourceMappingURL=native-devices.js.map

package/dist/application/native-devices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-devices.js","sourceRoot":"","sources":["../../src/application/native-devices.ts"],"names":[],"mappings":"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"}

package/dist/application/native-doctor.d.ts

@@ -0,0 +1,17 @@
+import type { ResolvedApplicationConfig } from './config.js';
+import { type NativeCommandRunner } from './native-command.js';
+export interface NativeDoctorCheck {
+    readonly name: string;
+    readonly ok: boolean;
+    readonly detail: string;
+}
+export interface NativeDoctorReport {
+    readonly ok: boolean;
+    readonly checks: readonly NativeDoctorCheck[];
+}
+/**
+ * Inspects simulator prerequisites without booting devices, compiling products,
+ * installing applications or changing signing settings. A successful report is
+ * not evidence of distribution signing or developer-account readiness.
+ */
+export declare function inspectSimulatorEnvironment(config: ResolvedApplicationConfig, selector?: string, run?: NativeCommandRunner, platform?: NodeJS.Platform): Promise<NativeDoctorReport>;

package/dist/application/native-doctor.js

@@ -0,0 +1,79 @@
+import { access } from 'node:fs/promises';
+import { z } from 'zod';
+import { executeNativeCommand, NativeCommandInterruptedError } from './native-command.js';
+import { readIosSimulators, selectIosSimulator } from './native-devices.js';
+import { resolveSimulatorSettings } from './native-simulator-settings.js';
+const schemeListSchema = z.object({ schemes: z.array(z.string()) });
+const xcodeListSchema = z.object({
+    project: schemeListSchema.optional(),
+    workspace: schemeListSchema.optional(),
+});
+/**
+ * Inspects simulator prerequisites without booting devices, compiling products,
+ * installing applications or changing signing settings. A successful report is
+ * not evidence of distribution signing or developer-account readiness.
+ */
+export async function inspectSimulatorEnvironment(config, selector, run = executeNativeCommand, platform = process.platform) {
+    const checks = [];
+    const check = async (name, advice, inspect) => {
+        try {
+            checks.push({ name, ok: true, detail: await inspect() });
+        }
+        catch (error) {
+            if (error instanceof NativeCommandInterruptedError)
+                throw error;
+            checks.push({ name, ok: false, detail: `${advice}: ${error instanceof Error ? error.message : String(error)}` });
+        }
+    };
+    if (platform !== 'darwin')
+        return { ok: false, checks: [{ name: 'platform', ok: false, detail: 'iOS simulator commands require macOS with a full Xcode installation.' }] };
+    checks.push({ name: 'platform', ok: true, detail: 'macOS supports the iOS simulator toolchain.' });
+    await check('xcode', 'Install and select full Xcode, then complete its first-launch setup', async () => {
+        const { stdout } = await run('xcodebuild', ['-version']);
+        if (!/^Xcode\s+\S+/mu.test(stdout))
+            throw new Error('The selected developer tools did not identify a full Xcode installation');
+        return stdout.trim();
+    });
+    await check('simctl', 'Select an Xcode installation containing Simulator tools', async () => {
+        const { stdout } = await run('xcrun', ['--find', 'simctl']);
+        if (!stdout.trim())
+            throw new Error('simctl was not found');
+        return stdout.trim();
+    });
+    await check('sdk', 'Install the iOS simulator SDK in the selected Xcode installation', async () => {
+        const { stdout } = await run('xcrun', ['--sdk', 'iphonesimulator', '--show-sdk-path']);
+        if (!stdout.trim())
+            throw new Error('The iOS simulator SDK was not found');
+        return stdout.trim();
+    });
+    let settings;
+    await check('configuration', 'Configure application identity and client.targets.ios', async () => {
+        settings = resolveSimulatorSettings(config);
+        return `Simulator configuration for ${settings.bundleId}. Ad-hoc simulator signing preserves project entitlements; distribution signing is not checked.`;
+    });
+    await check('device', 'Install an available iOS runtime and select an unambiguous device with --device', async () => {
+        const device = selectIosSimulator(await readIosSimulators(run), selector ?? settings?.device);
+        return `${device.name} (${device.udid}), ${device.runtime}, ${device.state}`;
+    });
+    if (settings) {
+        const resolved = settings;
+        await check('container', 'Generate or configure the Xcode project or workspace', async () => {
+            await access(resolved.container.path);
+            return resolved.container.path;
+        });
+        await check('scheme', 'Select a shared application scheme from the configured Xcode project or workspace', async () => {
+            const { stdout } = await run('xcodebuild', [
+                `-${resolved.container.kind}`, resolved.container.path,
+                '-list', '-json', '-disableAutomaticPackageResolution', '-skipPackageUpdates',
+            ], { cwd: resolved.root });
+            const value = JSON.parse(stdout);
+            const list = xcodeListSchema.parse(value);
+            const schemes = list[resolved.container.kind]?.schemes ?? [];
+            if (!schemes.includes(resolved.scheme))
+                throw new Error(`Scheme ${JSON.stringify(resolved.scheme)} is unavailable. Available schemes: ${schemes.join(', ') || '(none)'}`);
+            return resolved.scheme;
+        });
+    }
+    return { ok: checks.every(item => item.ok), checks };
+}
+//# sourceMappingURL=native-doctor.js.map

package/dist/application/native-doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-doctor.js","sourceRoot":"","sources":["../../src/application/native-doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,oBAAoB,EAAE,6BAA6B,EAA4B,MAAM,kBAAkB,CAAA;AAChH,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AAatE,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAA;AACnE,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,OAAO,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACpC,SAAS,EAAE,gBAAgB,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAA;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAAiC,EACjC,QAAiB,EACjB,MAA2B,oBAAoB,EAC/C,WAA4B,OAAO,CAAC,QAAQ;IAE5C,MAAM,MAAM,GAAwB,EAAE,CAAA;IACtC,MAAM,KAAK,GAAG,KAAK,EAAE,IAAY,EAAE,MAAc,EAAE,OAA8B,EAAiB,EAAE;QAClG,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,OAAO,EAAE,EAAE,CAAC,CAAA;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,6BAA6B;gBAAE,MAAM,KAAK,CAAA;YAC/D,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;QAClH,CAAC;IACH,CAAC,CAAA;IAED,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,sEAAsE,EAAE,CAAC,EAAE,CAAA;IAC1K,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,6CAA6C,EAAE,CAAC,CAAA;IAElG,MAAM,KAAK,CAAC,OAAO,EAAE,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACrG,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,CAAC,CAAA;QACxD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAA;QAC9H,OAAO,MAAM,CAAC,IAAI,EAAE,CAAA;IACtB,CAAC,CAAC,CAAA;IACF,MAAM,KAAK,CAAC,QAAQ,EAAE,yDAAyD,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAA;QAC3D,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;QAC3D,OAAO,MAAM,CAAC,IAAI,EAAE,CAAA;IACtB,CAAC,CAAC,CAAA;IACF,MAAM,KAAK,CAAC,KAAK,EAAE,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChG,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAA;QACtF,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;QAC1E,OAAO,MAAM,CAAC,IAAI,EAAE,CAAA;IACtB,CAAC,CAAC,CAAA;IAEF,IAAI,QAAiE,CAAA;IACrE,MAAM,KAAK,CAAC,eAAe,EAAE,uDAAuD,EAAE,KAAK,IAAI,EAAE;QAC/F,QAAQ,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAA;QAC3C,OAAO,+BAA+B,QAAQ,CAAC,QAAQ,iGAAiG,CAAA;IAC1J,CAAC,CAAC,CAAA;IAEF,MAAM,KAAK,CAAC,QAAQ,EAAE,iFAAiF,EAAE,KAAK,IAAI,EAAE;QAClH,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,EAAE,QAAQ,IAAI,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC7F,OAAO,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,KAAK,EAAE,CAAA;IAC9E,CAAC,CAAC,CAAA;IACF,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,QAAQ,CAAA;QACzB,MAAM,KAAK,CAAC,WAAW,EAAE,sDAAsD,EAAE,KAAK,IAAI,EAAE;YAC1F,MAAM,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;YACrC,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAA;QAChC,CAAC,CAAC,CAAA;QACF,MAAM,KAAK,CAAC,QAAQ,EAAE,mFAAmF,EAAE,KAAK,IAAI,EAAE;YACpH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,YAAY,EAAE;gBACzC,IAAI,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI;gBACtD,OAAO,EAAE,OAAO,EAAE,oCAAoC,EAAE,qBAAqB;aAC9E,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;YAC1B,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;YACzC,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YACzC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,IAAI,EAAE,CAAA;YAC5D,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,uCAAuC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAA;YACzK,OAAO,QAAQ,CAAC,MAAM,CAAA;QACxB,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;AACtD,CAAC"}

package/dist/application/native-project.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Updates generated files only when their last generated contents are intact.
+ * User edits are never overwritten by synchronization.
+ */
+export declare function writeGeneratedFile(root: string, relativePath: string, contents: string): Promise<void>;
+/**
+ * Registers a generated Swift file in Capacitor's conventional App target.
+ * Existing IDs and custom project settings remain untouched.
+ */
+export declare function registerNativeSource(project: string): string;
+export declare function fileExists(file: string): Promise<boolean>;
+/**
+ * Capacitor's scene lifecycle constructs its controller directly; storyboard
+ * registration alone does not install the native bridge in modern projects.
+ */
+export declare function registerNativeScene(source: string): string;

package/dist/application/native-project.js

@@ -0,0 +1,82 @@
+import { createHash } from 'node:crypto';
+import { access, mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+/**
+ * Updates generated files only when their last generated contents are intact.
+ * User edits are never overwritten by synchronization.
+ */
+export async function writeGeneratedFile(root, relativePath, contents) {
+    const destination = path.join(root, relativePath);
+    const ledger = path.join(root, '.typeferry', 'generated', `${createHash('sha256').update(relativePath).digest('hex')}.sha256`);
+    let existing;
+    try {
+        existing = await readFile(destination, 'utf8');
+    }
+    catch (error) {
+        if (!(error instanceof Error && 'code' in error && error.code === 'ENOENT'))
+            throw error;
+    }
+    if (existing === contents) {
+        await mkdir(path.dirname(ledger), { recursive: true });
+        await writeFile(ledger, hash(contents));
+        return;
+    }
+    if (existing !== undefined) {
+        let previousHash;
+        try {
+            previousHash = await readFile(ledger, 'utf8');
+        }
+        catch { /* Unowned files cannot be replaced. */ }
+        if (previousHash !== hash(existing))
+            throw new Error(`Refusing to overwrite edited or app-owned file: ${relativePath}`);
+    }
+    await mkdir(path.dirname(destination), { recursive: true });
+    await mkdir(path.dirname(ledger), { recursive: true });
+    await writeFile(destination, contents);
+    await writeFile(ledger, hash(contents));
+}
+function hash(value) { return createHash('sha256').update(value).digest('hex'); }
+/**
+ * Registers a generated Swift file in Capacitor's conventional App target.
+ * Existing IDs and custom project settings remain untouched.
+ */
+export function registerNativeSource(project) {
+    if (project.includes('/* TypeFerryNative.swift in Sources */'))
+        return project;
+    const reference = 'F3A000000000000000000001';
+    const build = 'F3A000000000000000000002';
+    if (project.includes(reference) || project.includes(build))
+        throw new Error('Native project identifier collision');
+    const anchors = ['/* Begin PBXBuildFile section */', '/* Begin PBXFileReference section */', /\t+\w+ \/\* AppDelegate.swift \*\/,/u, /\t+\w+ \/\* AppDelegate.swift in Sources \*\/,/u];
+    for (const anchor of anchors) {
+        if (typeof anchor === 'string' ? !project.includes(anchor) : !anchor.test(project))
+            throw new Error('Unsupported Xcode project structure; expected AppDelegate.swift in App target');
+    }
+    return project
+        .replace(anchors[0], `${anchors[0]}\n\t\t${build} /* TypeFerryNative.swift in Sources */ = {isa = PBXBuildFile; fileRef = ${reference} /* TypeFerryNative.swift */; };`)
+        .replace(anchors[1], `${anchors[1]}\n\t\t${reference} /* TypeFerryNative.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = TypeFerryNative.swift; sourceTree = "<group>"; };`)
+        .replace(anchors[2], match => `${match}\n\t\t\t\t${reference} /* TypeFerryNative.swift */,`)
+        .replace(anchors[3], match => `${match}\n\t\t\t\t${build} /* TypeFerryNative.swift in Sources */,`);
+}
+export async function fileExists(file) {
+    try {
+        await access(file);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Capacitor's scene lifecycle constructs its controller directly; storyboard
+ * registration alone does not install the native bridge in modern projects.
+ */
+export function registerNativeScene(source) {
+    if (/rootViewController\s*=\s*TypeFerryBridgeViewController\(\)/u.test(source))
+        return source;
+    const stockController = /rootViewController\s*=\s*CAPBridgeViewController\(\)/u;
+    if (!stockController.test(source))
+        throw new Error('Custom scene controller detected; integrate TypeFerry native registration explicitly');
+    return source.replace(stockController, 'rootViewController = TypeFerryBridgeViewController()');
+}
+//# sourceMappingURL=native-project.js.map

package/dist/application/native-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-project.js","sourceRoot":"","sources":["../../src/application/native-project.ts"],"names":[],"mappings":"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"}

package/dist/application/native-simulator-settings.d.ts

@@ -0,0 +1,24 @@
+import type { ResolvedApplicationConfig } from './config.js';
+export interface SimulatorSettings {
+    readonly root: string;
+    readonly bundleId: string;
+    readonly container: {
+        readonly kind: 'project' | 'workspace';
+        readonly path: string;
+    };
+    readonly scheme: string;
+    readonly configuration: string;
+    readonly derivedDataPath: string;
+    readonly device?: string;
+}
+/**
+ * Xcode defaults follow the generated Capacitor app. Application signing/team
+ * settings are deliberately read from its project rather than framework config.
+ */
+export declare function resolveSimulatorSettings(config: ResolvedApplicationConfig): SimulatorSettings;
+export declare function simulatorBuildArguments(settings: SimulatorSettings, udid: string): readonly string[];
+/**
+ * Schemes can include extensions and test bundles. Select the actual application
+ * by its configured bundle identifier and resolved simulator platform.
+ */
+export declare function resolveSimulatorProduct(value: unknown, bundleId: string): string;

package/dist/application/native-simulator-settings.js

@@ -0,0 +1,55 @@
+import path from 'node:path';
+import { z } from 'zod';
+/**
+ * Xcode defaults follow the generated Capacitor app. Application signing/team
+ * settings are deliberately read from its project rather than framework config.
+ */
+export function resolveSimulatorSettings(config) {
+    const ios = config.client.targets.ios;
+    if (!ios || !config.application)
+        throw new Error('Configure application identity and client.targets.ios first');
+    const xcode = ios.xcode;
+    return {
+        root: config.root,
+        bundleId: config.application.id,
+        container: xcode?.workspace
+            ? { kind: 'workspace', path: path.resolve(config.root, xcode.workspace) }
+            : { kind: 'project', path: path.resolve(config.root, xcode?.project ?? 'ios/App/App.xcodeproj') },
+        scheme: xcode?.scheme ?? 'App',
+        configuration: xcode?.configuration ?? 'Debug',
+        derivedDataPath: path.resolve(config.root, xcode?.derivedDataPath ?? 'ios/DerivedData/Simulator'),
+        device: ios.simulator?.device,
+    };
+}
+export function simulatorBuildArguments(settings, udid) {
+    return [
+        `-${settings.container.kind}`, settings.container.path,
+        '-scheme', settings.scheme,
+        '-configuration', settings.configuration,
+        '-destination', `platform=iOS Simulator,id=${udid}`,
+        '-sdk', 'iphonesimulator',
+        '-derivedDataPath', settings.derivedDataPath,
+        'CODE_SIGNING_ALLOWED=YES', 'CODE_SIGN_IDENTITY=-',
+    ];
+}
+const buildSettingsSchema = z.array(z.object({ buildSettings: z.record(z.string(), z.unknown()) }));
+/**
+ * Schemes can include extensions and test bundles. Select the actual application
+ * by its configured bundle identifier and resolved simulator platform.
+ */
+export function resolveSimulatorProduct(value, bundleId) {
+    const candidates = buildSettingsSchema.parse(value).filter(({ buildSettings: settings }) => settings['PRODUCT_BUNDLE_IDENTIFIER'] === bundleId &&
+        settings['WRAPPER_EXTENSION'] === 'app' &&
+        settings['PLATFORM_NAME'] === 'iphonesimulator');
+    if (candidates.length !== 1)
+        throw new Error(`Expected one simulator application product for ${bundleId}; found ${candidates.length}. Check the configured scheme.`);
+    const settings = candidates[0]?.buildSettings;
+    const directory = settings?.['TARGET_BUILD_DIR'];
+    const name = settings?.['FULL_PRODUCT_NAME'];
+    if (typeof directory !== 'string' || !path.isAbsolute(directory) ||
+        typeof name !== 'string' || path.basename(name) !== name || !name.endsWith('.app')) {
+        throw new Error('Xcode returned an invalid simulator application product path');
+    }
+    return path.join(directory, name);
+}
+//# sourceMappingURL=native-simulator-settings.js.map

package/dist/application/native-simulator-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-simulator-settings.js","sourceRoot":"","sources":["../../src/application/native-simulator-settings.ts"],"names":[],"mappings":"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"}

package/dist/application/native-simulator.d.ts

@@ -0,0 +1,19 @@
+import type { NativeCliArguments } from './cli-arguments.js';
+import type { ResolvedApplicationConfig } from './config.js';
+import { type NativeCommandRunner } from './native-command.js';
+type SimulatorCommand = Exclude<NativeCliArguments, {
+    readonly action: 'add' | 'sync' | 'open';
+}>;
+export interface SimulatorDependencies {
+    readonly run: NativeCommandRunner;
+    readonly build: (config: ResolvedApplicationConfig) => Promise<void>;
+    readonly sync: (config: ResolvedApplicationConfig) => Promise<void>;
+    readonly write: (message: string) => void;
+    readonly platform: NodeJS.Platform;
+}
+/**
+ * Simulator tooling deliberately has no distribution, account, certificate or
+ * data-reset operations. Each mutation targets one resolved device identifier.
+ */
+export declare function runNativeSimulator(config: ResolvedApplicationConfig, command: SimulatorCommand, deps?: SimulatorDependencies): Promise<boolean>;
+export {};

package/dist/application/native-simulator.js

@@ -0,0 +1,101 @@
+import { randomUUID } from 'node:crypto';
+import { access, mkdir, open, rm } from 'node:fs/promises';
+import path from 'node:path';
+import { runBuild } from './build.js';
+import { runNative } from './native.js';
+import { executeNativeCommand } from './native-command.js';
+import { readIosSimulators, requireBootedSimulator, selectIosSimulator } from './native-devices.js';
+import { inspectSimulatorEnvironment } from './native-doctor.js';
+import { resolveSimulatorProduct, resolveSimulatorSettings, simulatorBuildArguments } from './native-simulator-settings.js';
+const dependencies = {
+    run: executeNativeCommand,
+    build: config => runBuild(config, 'ios'),
+    sync: config => runNative(config, 'sync'),
+    write: message => process.stdout.write(`${message}\n`),
+    platform: process.platform,
+};
+/**
+ * Simulator tooling deliberately has no distribution, account, certificate or
+ * data-reset operations. Each mutation targets one resolved device identifier.
+ */
+export async function runNativeSimulator(config, command, deps = dependencies) {
+    if (command.action === 'doctor') {
+        const report = await inspectSimulatorEnvironment(config, command.device, deps.run, deps.platform);
+        deps.write(command.json ? JSON.stringify(report, null, 2) : report.checks.map(check => `${check.ok ? 'OK' : 'FAIL'} ${check.name}: ${check.detail}`).join('\n'));
+        return report.ok;
+    }
+    if (deps.platform !== 'darwin')
+        throw new Error('iOS simulator commands require macOS with full Xcode installed. Run native doctor ios on a Mac.');
+    const devices = await readIosSimulators(deps.run);
+    if (command.action === 'devices') {
+        deps.write(command.json ? JSON.stringify(devices, null, 2) : devices.map(device => `${device.udid}  ${device.name}  ${device.runtime}  ${device.state}${device.isAvailable ? '' : ' (unavailable)'}`).join('\n') || 'No iOS simulators found. Install an iOS runtime in Xcode.');
+        return true;
+    }
+    const settings = resolveSimulatorSettings(config);
+    const device = selectIosSimulator(devices, command.device ?? settings.device);
+    if (command.action === 'run') {
+        await runApplication(config, settings, device.udid, command.headless, deps);
+        return true;
+    }
+    requireBootedSimulator(device);
+    if (command.action === 'screenshot') {
+        await captureScreenshot(settings, device.udid, command.output, deps);
+    }
+    else {
+        await streamApplicationLogs(settings, device.udid, deps);
+    }
+    return true;
+}
+async function runApplication(config, settings, udid, headless, deps) {
+    await access(settings.container.path).catch(() => { throw new Error(`Xcode ${settings.container.kind} not found: ${settings.container.path}. Create the native project with native add ios or configure its location.`); });
+    deps.write(`Building ${settings.bundleId} for simulator ${udid}`);
+    await deps.build(config);
+    await deps.sync(config);
+    await deps.run('xcrun', ['simctl', 'bootstatus', udid, '-b'], { stream: true, timeoutMs: 180_000 });
+    if (!headless)
+        await deps.run('open', ['-a', 'Simulator', '--args', '-CurrentDeviceUDID', udid]);
+    const args = simulatorBuildArguments(settings, udid);
+    await deps.run('xcodebuild', [...args, 'build'], { cwd: settings.root, stream: true, timeoutMs: 900_000 });
+    const result = await deps.run('xcodebuild', [...args, '-showBuildSettings', '-json'], { cwd: settings.root });
+    const product = resolveSimulatorProduct(JSON.parse(result.stdout), settings.bundleId);
+    const identity = await deps.run('/usr/bin/plutil', ['-extract', 'CFBundleIdentifier', 'raw', '-o', '-', path.join(product, 'Info.plist')]);
+    if (identity.stdout.trim() !== settings.bundleId)
+        throw new Error('Built app identity does not match application.id; refusing to install a different application');
+    await deps.run('codesign', ['--verify', '--deep', '--strict', product]);
+    await deps.run('xcrun', ['simctl', 'install', udid, product]);
+    await deps.run('xcrun', ['simctl', 'launch', '--terminate-running-process', udid, settings.bundleId]);
+    deps.write(`Launched ${settings.bundleId} on ${udid}\nApplication: ${product}`);
+}
+async function captureScreenshot(settings, udid, requested, deps) {
+    const output = requested
+        ? path.resolve(settings.root, requested)
+        : path.join(settings.derivedDataPath, 'screenshots', `${new Date().toISOString().replaceAll(':', '-')}-${randomUUID()}.png`);
+    if (path.extname(output).toLowerCase() !== '.png')
+        throw new Error('Screenshot output must use a .png extension');
+    await mkdir(path.dirname(output), { recursive: true });
+    const reservation = await open(output, 'wx').catch((error) => {
+        if (error instanceof Error && 'code' in error && error.code === 'EEXIST')
+            throw new Error(`Screenshot already exists: ${output}. Choose a new --output path.`);
+        throw error;
+    });
+    await reservation.close();
+    try {
+        await deps.run('xcrun', ['simctl', 'io', udid, 'screenshot', '--type=png', output]);
+    }
+    catch (error) {
+        await rm(output, { force: true });
+        throw error;
+    }
+    deps.write(output);
+}
+async function streamApplicationLogs(settings, udid, deps) {
+    const container = await deps.run('xcrun', ['simctl', 'get_app_container', udid, settings.bundleId, 'app']);
+    const executable = await deps.run('/usr/bin/plutil', ['-extract', 'CFBundleExecutable', 'raw', '-o', '-', path.join(container.stdout.trim(), 'Info.plist')]);
+    const name = executable.stdout.trim();
+    if (!name || /[\r\n\0]/u.test(name))
+        throw new Error('Installed application has an invalid executable name');
+    const quotedName = JSON.stringify(name);
+    deps.write(`Streaming ${settings.bundleId} on ${udid}. Press Ctrl+C to stop.`);
+    await deps.run('xcrun', ['simctl', 'spawn', udid, 'log', 'stream', '--style', 'compact', '--level', 'debug', '--predicate', `process == ${quotedName}`], { stream: true });
+}
+//# sourceMappingURL=native-simulator.js.map

package/dist/application/native-simulator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-simulator.js","sourceRoot":"","sources":["../../src/application/native-simulator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAGlC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,EAAE,oBAAoB,EAA4B,MAAM,kBAAkB,CAAA;AACjF,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAChG,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AAC7D,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,uBAAuB,EAA0B,MAAM,6BAA6B,CAAA;AAYhJ,MAAM,YAAY,GAA0B;IAC1C,GAAG,EAAE,oBAAoB;IACzB,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC;IACtD,QAAQ,EAAE,OAAO,CAAC,QAAQ;CAC3B,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAiC,EACjC,OAAyB,EACzB,OAA8B,YAAY;IAE1C,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;QACjG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QAChK,OAAO,MAAM,CAAC,EAAE,CAAA;IAClB,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,iGAAiG,CAAC,CAAA;IAClJ,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,2DAA2D,CAAC,CAAA;QAChR,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,QAAQ,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAA;IACjD,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC7E,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC7B,MAAM,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC3E,OAAO,IAAI,CAAA;IACb,CAAC;IACD,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QACpC,MAAM,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACtE,CAAC;SAAM,CAAC;QACN,MAAM,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAC1D,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,MAAiC,EACjC,QAA2B,EAC3B,IAAY,EACZ,QAAiB,EACjB,IAA2B;IAE3B,MAAM,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,CAAC,SAAS,CAAC,IAAI,eAAe,QAAQ,CAAC,SAAS,CAAC,IAAI,4EAA4E,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;IAC1N,IAAI,CAAC,KAAK,CAAC,YAAY,QAAQ,CAAC,QAAQ,kBAAkB,IAAI,EAAE,CAAC,CAAA;IACjE,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACxB,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACvB,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAA;IACnG,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,CAAC,CAAC,CAAA;IAChG,MAAM,IAAI,GAAG,uBAAuB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IACpD,MAAM,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAA;IAC1G,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IAC7G,MAAM,OAAO,GAAG,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAChG,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,UAAU,EAAE,oBAAoB,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;IAC1I,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,+FAA+F,CAAC,CAAA;IAClK,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAA;IACvE,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;IAC7D,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,6BAA6B,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;IACrG,IAAI,CAAC,KAAK,CAAC,YAAY,QAAQ,CAAC,QAAQ,OAAO,IAAI,kBAAkB,OAAO,EAAE,CAAC,CAAA;AACjF,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,QAA2B,EAAE,IAAY,EAAE,SAA6B,EAAE,IAA2B;IACpI,MAAM,MAAM,GAAG,SAAS;QACtB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;QACxC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,aAAa,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,UAAU,EAAE,MAAM,CAAC,CAAA;IAC9H,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IACjH,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACtD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACpE,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,+BAA+B,CAAC,CAAA;QAC9J,MAAM,KAAK,CAAA;IACb,CAAC,CAAC,CAAA;IACF,MAAM,WAAW,CAAC,KAAK,EAAE,CAAA;IACzB,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAA;IACrF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACjC,MAAM,KAAK,CAAA;IACb,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AACpB,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,QAA2B,EAAE,IAAY,EAAE,IAA2B;IACzG,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAA;IAC1G,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,UAAU,EAAE,oBAAoB,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;IAC5J,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;IACrC,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;IAC5G,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IACvC,IAAI,CAAC,KAAK,CAAC,aAAa,QAAQ,CAAC,QAAQ,OAAO,IAAI,yBAAyB,CAAC,CAAA;IAC9E,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,cAAc,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;AAC5K,CAAC"}

package/dist/application/native.d.ts

@@ -0,0 +1,2 @@
+import type { ResolvedApplicationConfig } from './config.js';
+export declare function runNative(config: ResolvedApplicationConfig, action: 'add' | 'sync' | 'open'): Promise<void>;