@tauri-native/cli 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tauri-native contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+# @tauri-native/cli
+
+Experimental CLI for packaging a Tauri microfrontend and its Rust application core for an iOS host.
+
+## Install
+
+```sh
+npm install --save-dev @tauri-native/cli@experimental
+```
+
+Node.js 22.12 or newer, Rust with the iOS targets, and Xcode are required.
+
+Install the package in the Tauri project that owns the frontend and Rust core. React Native and Lynx hosts consume its exported artifacts and do not need the CLI as a dependency.
+
+## Export for iOS
+
+```sh
+npx tauri-native export ios
+```
+
+Run this from the Tauri project root. By default, the command reads `src-tauri/tauri.conf.json`, builds `src-tauri/crates/app-core/Cargo.toml`, uses `src-tauri/crates/app-core/include/tauri_native.h`, and writes the co-located export to `src-tauri/gen/tauri-native/ios`. Use `--tauri-dir`, `--manifest`, or `--header` when the project uses another layout.
+
+Pass `--output-dir` to export directly into a native host instead:
+
+```sh
+npx tauri-native export ios \
+  --output-dir ../mobile-app/ios/tauri-native
+```
+
+The output directory contains:
+
+- `TauriNativeCore.xcframework`
+- `TauriNativeAssets.bundle`
+- `TauriNativeGenerated.podspec`
+
+Copy or reference the exported directory from the native host, then add its generated local Pod before installing native dependencies.
+
+## License
+
+MIT

package/dist/index.mjs

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+import process from "node:process";
+import { Command } from "commander";
+import { execFileSync, execSync } from "node:child_process";
+import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { wrapTextWithPrefix } from "@clack/core";
+//#region src/utils/cargo-manifest.ts
+function libraryNameFromManifest(source) {
+	const libSection = source.match(/\[lib\]([\s\S]*?)(?=\n\[|$)/)?.[1];
+	const packageSection = source.match(/\[package\]([\s\S]*?)(?=\n\[|$)/)?.[1];
+	const name = libSection?.match(/^name\s*=\s*"([^"]+)"/m)?.[1] ?? packageSection?.match(/^name\s*=\s*"([^"]+)"/m)?.[1];
+	if (!name) throw new Error("Could not find a package or library name");
+	return name.replaceAll("-", "_");
+}
+function readLibraryName(manifest) {
+	try {
+		return libraryNameFromManifest(readFileSync(manifest, "utf8"));
+	} catch (error) {
+		if (error instanceof Error && error.message === "Could not find a package or library name") throw new Error(`${error.message} in ${manifest}`);
+		throw error;
+	}
+}
+//#endregion
+//#region src/utils/files.ts
+function requireFile(file) {
+	if (!existsSync(file)) throw new Error(`Required file does not exist: ${file}`);
+}
+//#endregion
+//#region src/utils/output.ts
+function message(text, startPrefix = "◇ ") {
+	process.stdout.write(`${wrapTextWithPrefix(process.stdout, text, "│ ", startPrefix, "│ ")}\n`);
+}
+function writeError(text) {
+	process.stderr.write(`${wrapTextWithPrefix(process.stderr, text, "│ ", "■ ", "│ ")}\n`);
+}
+//#endregion
+//#region src/utils/process.ts
+function run(command, args, options = {}) {
+	message(`${command} ${args.join(" ")}`);
+	execFileSync(command, args, {
+		stdio: "inherit",
+		...options
+	});
+}
+//#endregion
+//#region src/commands/export-ios.ts
+const IOS_TARGETS = [
+	"aarch64-apple-ios",
+	"aarch64-apple-ios-sim",
+	"x86_64-apple-ios"
+];
+const ASSET_BUNDLE_INFO = `<?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>CFBundleIdentifier</key><string>dev.tauri-native.assets</string>
+  <key>CFBundleName</key><string>TauriNativeAssets</string>
+  <key>CFBundlePackageType</key><string>BNDL</string>
+  <key>CFBundleVersion</key><string>1</string>
+</dict></plist>
+`;
+const GENERATED_PODSPEC = `Pod::Spec.new do |s|
+  s.name = "TauriNativeGenerated"
+  s.version = "0.0.0"
+  s.summary = "Application-specific artifacts generated by @tauri-native/cli"
+  s.homepage = "https://github.com/gronxb/tauri-native"
+  s.license = { :type => "MIT" }
+  s.authors = "tauri-native contributors"
+  s.source = { :git => "https://github.com/gronxb/tauri-native.git", :branch => "main" }
+  s.platform = :ios, "13.0"
+  s.static_framework = true
+  s.vendored_frameworks = "TauriNativeCore.xcframework"
+  s.resources = "TauriNativeAssets.bundle"
+end
+`;
+function writeGeneratedPodspec(outputDirectory) {
+	const podspec = path.join(outputDirectory, "TauriNativeGenerated.podspec");
+	writeFileSync(podspec, GENERATED_PODSPEC);
+	return podspec;
+}
+function exportIos(options) {
+	const workingDirectory = process.cwd();
+	const tauriDirectory = path.resolve(workingDirectory, options.tauriDir);
+	const manifest = options.manifest ? path.resolve(workingDirectory, options.manifest) : path.join(tauriDirectory, "crates/app-core/Cargo.toml");
+	const manifestDirectory = path.dirname(manifest);
+	const header = options.header ? path.resolve(workingDirectory, options.header) : path.join(manifestDirectory, "include/tauri_native.h");
+	const outputDirectory = path.resolve(workingDirectory, options.outputDir ?? path.join(tauriDirectory, "gen/tauri-native/ios"));
+	const configPath = path.join(tauriDirectory, "tauri.conf.json");
+	for (const requiredPath of [
+		manifest,
+		header,
+		configPath
+	]) requireFile(requiredPath);
+	const config = JSON.parse(readFileSync(configPath, "utf8"));
+	const frontendDirectory = path.dirname(tauriDirectory);
+	if (typeof config.build?.beforeBuildCommand === "string") {
+		message(`Building the Tauri microfrontend in ${frontendDirectory}`);
+		execSync(config.build.beforeBuildCommand, {
+			cwd: frontendDirectory,
+			stdio: "inherit"
+		});
+	}
+	if (typeof config.build?.frontendDist !== "string") throw new Error(`${configPath} must define build.frontendDist`);
+	const frontendDist = path.resolve(tauriDirectory, config.build.frontendDist);
+	requireFile(path.join(frontendDist, "index.html"));
+	const libraryName = readLibraryName(manifest);
+	const targetDirectory = path.join(tauriDirectory, "target/tauri-native");
+	const cargoEnvironment = {
+		...process.env,
+		CARGO_TARGET_DIR: targetDirectory
+	};
+	run("rustup", [
+		"target",
+		"add",
+		...IOS_TARGETS
+	]);
+	for (const target of IOS_TARGETS) run("cargo", [
+		"build",
+		"--manifest-path",
+		manifest,
+		"--target",
+		target,
+		"--release"
+	], { env: cargoEnvironment });
+	mkdirSync(outputDirectory, { recursive: true });
+	const framework = path.join(outputDirectory, "TauriNativeCore.xcframework");
+	const assetBundle = path.join(outputDirectory, "TauriNativeAssets.bundle");
+	const universalDirectory = path.join(targetDirectory, "ios-simulator-universal/release");
+	const universalLibrary = path.join(universalDirectory, `lib${libraryName}.a`);
+	mkdirSync(universalDirectory, { recursive: true });
+	run("lipo", [
+		"-create",
+		path.join(targetDirectory, `aarch64-apple-ios-sim/release/lib${libraryName}.a`),
+		path.join(targetDirectory, `x86_64-apple-ios/release/lib${libraryName}.a`),
+		"-output",
+		universalLibrary
+	]);
+	rmSync(framework, {
+		recursive: true,
+		force: true
+	});
+	run("xcodebuild", [
+		"-create-xcframework",
+		"-library",
+		path.join(targetDirectory, `aarch64-apple-ios/release/lib${libraryName}.a`),
+		"-headers",
+		path.dirname(header),
+		"-library",
+		universalLibrary,
+		"-headers",
+		path.dirname(header),
+		"-output",
+		framework
+	]);
+	rmSync(assetBundle, {
+		recursive: true,
+		force: true
+	});
+	cpSync(frontendDist, assetBundle, { recursive: true });
+	writeFileSync(path.join(assetBundle, "Info.plist"), ASSET_BUNDLE_INFO);
+	message(`Created ${framework}\nCreated ${assetBundle}\nCreated ${writeGeneratedPodspec(outputDirectory)}`, "◆ ");
+}
+//#endregion
+//#region src/cli.ts
+function createProgram() {
+	const program = new Command();
+	program.name("tauri-native").description("Export a Tauri microfrontend for a native host").showHelpAfterError();
+	program.command("export").description("Export Tauri artifacts for a native host").command("ios").description("Export an XCFramework and a Tauri web asset bundle").option("--tauri-dir <path>", "Tauri Rust directory", "src-tauri").option("--manifest <path>", "native core Cargo.toml").option("--header <path>", "C ABI header").option("--output-dir <path>", "generated artifact directory").action((options) => exportIos(options));
+	return program;
+}
+//#endregion
+//#region src/index.ts
+try {
+	await createProgram().parseAsync(process.argv);
+} catch (error) {
+	writeError(error instanceof Error ? error.message : String(error));
+	process.exitCode = 1;
+}
+//#endregion
+export {};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@tauri-native/cli",
+  "version": "0.0.2",
+  "description": "Export a Tauri microfrontend and its Rust core for native hosts",
+  "type": "module",
+  "bin": {
+    "tauri-native": "./dist/index.mjs"
+  },
+  "exports": {
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "prepack": "tsdown",
+    "test": "nub run build && node --experimental-strip-types --test test/*.test.ts && nub run test:package",
+    "test:package": "node ../../scripts/verify-package.mjs",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@clack/core": "^1.4.3",
+    "commander": "^15.0.0"
+  },
+  "keywords": [
+    "ios",
+    "react-native",
+    "rust",
+    "tauri"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gronxb/tauri-native.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/gronxb/tauri-native#readme",
+  "bugs": {
+    "url": "https://github.com/gronxb/tauri-native/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "tag": "experimental"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.1",
+    "tsdown": "^0.22.14",
+    "typescript": "7.0.2"
+  }
+}