@choochmeque/tauri-apple-extensions 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Choochmeque
+
+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,90 @@
+# tauri-apple-extensions
+
+[![npm](https://img.shields.io/npm/v/@choochmeque/tauri-apple-extensions.svg)](https://www.npmjs.com/package/@choochmeque/tauri-apple-extensions)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Add iOS extensions to Tauri apps with a single command.
+
+## Features
+
+- Automatic Xcode project configuration via XcodeGen
+- Plugin-based template system
+- Idempotent - safe to re-run
+- Share Extension support (more extension types coming soon)
+
+## Prerequisites
+
+- [XcodeGen](https://github.com/yonaskolb/XcodeGen) installed (`brew install xcodegen`)
+- Tauri iOS project initialized (`tauri ios init`)
+
+## Installation
+
+```bash
+npm install -D @choochmeque/tauri-apple-extensions
+```
+
+## Usage
+
+### With a plugin (recommended)
+
+If you're using a Tauri plugin that provides iOS extension templates:
+
+```bash
+npx @choochmeque/tauri-apple-extensions add share --plugin @choochmeque/tauri-plugin-sharekit-api
+```
+
+### With custom templates
+
+```bash
+npx @choochmeque/tauri-apple-extensions add share --templates ./path/to/templates
+```
+
+## Supported Extensions
+
+| Type | Status | Description |
+|------|--------|-------------|
+| `share` | Available | Share Extension for receiving shared content |
+
+## For Plugin Developers
+
+To make your plugin compatible with this tool, add the following to your `package.json`:
+
+```json
+{
+  "tauri-apple-extension": {
+    "type": "share",
+    "templates": "./ios/templates"
+  }
+}
+```
+
+Your templates directory should contain:
+- Swift source files with `{{VARIABLE}}` placeholders
+- `Info.plist` for the extension
+
+### Template Variables
+
+| Variable | Description |
+|----------|-------------|
+| `{{APP_GROUP_IDENTIFIER}}` | App Group ID (e.g., `group.com.example.app`) |
+| `{{APP_URL_SCHEME}}` | URL scheme for deep linking |
+| `{{VERSION}}` | App version from tauri.conf.json |
+| `{{BUNDLE_IDENTIFIER}}` | Extension bundle identifier |
+| `{{PRODUCT_NAME}}` | App product name |
+
+## Post-Setup Steps
+
+After running the tool:
+
+1. Open the Xcode project (`src-tauri/gen/apple/*.xcodeproj`)
+2. Select your Apple Developer Team for both targets
+3. Enable required capabilities (e.g., App Groups) for both targets
+4. Configure the capability in Apple Developer Portal
+
+## Contributing
+
+PRs accepted. Please make sure to read the Contributing Guide before making a pull request.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli.js

@@ -0,0 +1,536 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+
+/**
+ * Simple YAML-like parsing for the values we need.
+ * This is not a full YAML parser, just extracts top-level key-value pairs.
+ */
+function parseYamlSimple(content) {
+    const lines = content.split("\n");
+    const result = {};
+    for (const line of lines) {
+        const match = line.match(/^(\w+):\s*(.+)$/);
+        if (match) {
+            result[match[1]] = match[2].trim();
+        }
+    }
+    return result;
+}
+
+function findProjectRoot() {
+    let dir = process.cwd();
+    while (dir !== path.dirname(dir)) {
+        if (fs.existsSync(path.join(dir, "tauri.conf.json")) ||
+            fs.existsSync(path.join(dir, "src-tauri", "tauri.conf.json"))) {
+            return dir;
+        }
+        dir = path.dirname(dir);
+    }
+    return process.cwd();
+}
+function findTauriConfig(projectRoot) {
+    const paths = [
+        path.join(projectRoot, "src-tauri", "tauri.conf.json"),
+        path.join(projectRoot, "tauri.conf.json"),
+    ];
+    for (const p of paths) {
+        if (fs.existsSync(p)) {
+            return JSON.parse(fs.readFileSync(p, "utf8"));
+        }
+    }
+    throw new Error("Could not find tauri.conf.json");
+}
+function findAppleProjectDir(projectRoot) {
+    const paths = [
+        path.join(projectRoot, "src-tauri", "gen", "apple"),
+        path.join(projectRoot, "gen", "apple"),
+    ];
+    for (const p of paths) {
+        if (fs.existsSync(p)) {
+            return p;
+        }
+    }
+    throw new Error("Could not find iOS project directory. Run 'tauri ios init' first.");
+}
+function getAppInfo(tauriConfig, projectYml) {
+    const parsed = parseYamlSimple(projectYml);
+    const productName = tauriConfig.productName || tauriConfig.package?.productName || "app";
+    const bundleIdPrefix = parsed.bundleIdPrefix || "com.tauri";
+    const identifier = tauriConfig.identifier || `${bundleIdPrefix}.${productName}`;
+    const version = tauriConfig.version || "1.0.0";
+    return {
+        productName,
+        bundleIdPrefix,
+        identifier,
+        version,
+    };
+}
+
+function readProjectYml(appleDir) {
+    const projectYmlPath = path.join(appleDir, "project.yml");
+    if (!fs.existsSync(projectYmlPath)) {
+        throw new Error("project.yml not found. Run 'tauri ios init' first.");
+    }
+    return fs.readFileSync(projectYmlPath, "utf8");
+}
+function writeProjectYml(appleDir, content) {
+    const projectYmlPath = path.join(appleDir, "project.yml");
+    fs.writeFileSync(projectYmlPath, content);
+}
+function addExtensionTarget(projectYml, targetConfig) {
+    let modified = projectYml;
+    // Remove existing target if it exists (to allow re-running the script)
+    // Note: Don't use 'm' flag - we need $ to match only at true end of string
+    const existingTargetRegex = new RegExp(`\\n  ${targetConfig.name}:[\\s\\S]*?(?=\\n  [a-zA-Z_]|\\n[a-zA-Z]|$)`);
+    if (modified.match(existingTargetRegex)) {
+        console.log(`Removing existing ${targetConfig.name} target to recreate it...`);
+        modified = modified.replace(existingTargetRegex, "");
+    }
+    // Find the end of targets section and insert the new target
+    if (modified.includes("targets:")) {
+        const targetsIndex = modified.indexOf("targets:");
+        const afterTargets = modified.slice(targetsIndex);
+        const lines = afterTargets.split("\n");
+        let inTargets = false;
+        let lastTargetEnd = targetsIndex;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (line.match(/^targets:/)) {
+                inTargets = true;
+                continue;
+            }
+            if (inTargets) {
+                // Check if we've exited the targets section (new top-level key)
+                if (line.match(/^[a-zA-Z]/) && !line.startsWith(" ")) {
+                    break;
+                }
+                lastTargetEnd = targetsIndex + lines.slice(0, i + 1).join("\n").length;
+            }
+        }
+        modified =
+            modified.slice(0, lastTargetEnd) +
+                targetConfig.yaml +
+                modified.slice(lastTargetEnd);
+    }
+    return modified;
+}
+function addDependencyToTarget(projectYml, mainTargetName, dependencyConfig) {
+    let modified = projectYml;
+    // Remove existing dependency if it exists
+    const existingDepRegex = new RegExp(`\\n      - target: ${dependencyConfig.target}\\n        embed: true\\n        codeSign: true`, "g");
+    modified = modified.replace(existingDepRegex, "");
+    // Find the main target's dependencies section and add the extension
+    const targetRegex = new RegExp(`(${mainTargetName}:[\\s\\S]*?dependencies:)([\\s\\S]*?)(\\n\\s{4}\\w|$)`, "m");
+    const depMatch = modified.match(targetRegex);
+    if (depMatch) {
+        const depSection = depMatch[2];
+        const newDep = `\n      - target: ${dependencyConfig.target}
+        embed: true
+        codeSign: true`;
+        if (!depSection.includes(dependencyConfig.target)) {
+            modified = modified.replace(targetRegex, `$1${depSection}${newDep}$3`);
+        }
+    }
+    return modified;
+}
+
+function updateMainAppEntitlements(appleDir, appInfo) {
+    const targetName = `${appInfo.productName}_iOS`;
+    const entitlementsPath = path.join(appleDir, targetName, `${targetName}.entitlements`);
+    const appGroupId = `group.${appInfo.identifier}`;
+    let entitlements;
+    if (fs.existsSync(entitlementsPath)) {
+        entitlements = fs.readFileSync(entitlementsPath, "utf8");
+    }
+    else {
+        entitlements = `<?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>
+</dict>
+</plist>`;
+    }
+    // Check if app groups already configured
+    if (entitlements.includes("com.apple.security.application-groups")) {
+        if (!entitlements.includes(appGroupId)) {
+            // Add our group to existing array
+            entitlements = entitlements.replace(/(<key>com\.apple\.security\.application-groups<\/key>\s*<array>)/, `$1\n        <string>${appGroupId}</string>`);
+        }
+    }
+    else {
+        // Add app groups entitlement
+        entitlements = entitlements.replace(/<dict>\s*<\/dict>/, `<dict>
+    <key>com.apple.security.application-groups</key>
+    <array>
+        <string>${appGroupId}</string>
+    </array>
+</dict>`);
+    }
+    fs.writeFileSync(entitlementsPath, entitlements);
+    console.log(`Updated main app entitlements: ${entitlementsPath}`);
+}
+function createExtensionEntitlements(extensionDir, appGroupId) {
+    const entitlements = `<?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>com.apple.security.application-groups</key>
+    <array>
+        <string>${appGroupId}</string>
+    </array>
+</dict>
+</plist>`;
+    const entitlementsPath = path.join(extensionDir, `${path.basename(extensionDir)}.entitlements`);
+    fs.writeFileSync(entitlementsPath, entitlements);
+    return entitlementsPath;
+}
+
+function addUrlSchemeToInfoPlist(appleDir, appInfo) {
+    const targetName = `${appInfo.productName}_iOS`;
+    const infoPlistPath = path.join(appleDir, targetName, "Info.plist");
+    const urlScheme = appInfo.productName.toLowerCase().replace(/[^a-z0-9]/g, "");
+    if (!fs.existsSync(infoPlistPath)) {
+        console.log(`Info.plist not found at ${infoPlistPath}, skipping URL scheme setup`);
+        return;
+    }
+    let infoPlist = fs.readFileSync(infoPlistPath, "utf8");
+    // Check if URL schemes already configured
+    if (infoPlist.includes("CFBundleURLSchemes")) {
+        if (!infoPlist.includes(urlScheme)) {
+            console.log(`URL scheme may need manual configuration. Add '${urlScheme}' to CFBundleURLSchemes.`);
+        }
+        return;
+    }
+    // Add URL scheme - need to insert before closing </dict></plist>
+    const urlSchemeEntry = `    <key>CFBundleURLTypes</key>
+    <array>
+        <dict>
+            <key>CFBundleURLSchemes</key>
+            <array>
+                <string>${urlScheme}</string>
+            </array>
+            <key>CFBundleURLName</key>
+            <string>${appInfo.identifier}</string>
+        </dict>
+    </array>
+`;
+    // Insert before the last </dict>
+    infoPlist = infoPlist.replace(/(\s*)<\/dict>\s*<\/plist>/, `\n${urlSchemeEntry}$1</dict>\n</plist>`);
+    fs.writeFileSync(infoPlistPath, infoPlist);
+    console.log(`Added URL scheme '${urlScheme}' to Info.plist`);
+}
+
+function runXcodeGen(appleDir) {
+    try {
+        console.log("Running xcodegen to regenerate project...");
+        execSync("xcodegen generate", {
+            cwd: appleDir,
+            stdio: "inherit",
+        });
+        console.log("Xcode project regenerated successfully!");
+    }
+    catch (error) {
+        console.log("\nNote: xcodegen not found or failed. You may need to run it manually:");
+        console.log(`  cd ${appleDir} && xcodegen generate`);
+        console.log(`  Error: ${error.message}`);
+    }
+}
+
+/**
+ * Replace template variables in content.
+ * Variables are in the format {{VARIABLE_NAME}}
+ */
+function replaceTemplateVariables(content, variables) {
+    let result = content;
+    for (const [key, value] of Object.entries(variables)) {
+        const regex = new RegExp(`\\{\\{${key}\\}\\}`, "g");
+        result = result.replace(regex, value);
+    }
+    return result;
+}
+/**
+ * Copy a template file to destination, replacing variables.
+ */
+function copyTemplateFile(src, dest, variables) {
+    let content = fs.readFileSync(src, "utf8");
+    content = replaceTemplateVariables(content, variables);
+    fs.writeFileSync(dest, content);
+}
+
+const shareExtension = {
+    type: "share",
+    displayName: "Share Extension",
+    extensionSuffix: "ShareExtension",
+    extensionPointIdentifier: "com.apple.share-services",
+    extensionName(appInfo) {
+        return `${appInfo.productName}-ShareExtension`;
+    },
+    createFiles(appleDir, appInfo, templatesDir) {
+        const extensionDir = path.join(appleDir, "ShareExtension");
+        const appGroupId = `group.${appInfo.identifier}`;
+        const urlScheme = appInfo.productName
+            .toLowerCase()
+            .replace(/[^a-z0-9]/g, "");
+        // Create directory
+        if (!fs.existsSync(extensionDir)) {
+            fs.mkdirSync(extensionDir, { recursive: true });
+        }
+        const variables = {
+            APP_GROUP_IDENTIFIER: appGroupId,
+            APP_URL_SCHEME: urlScheme,
+            VERSION: appInfo.version,
+            BUNDLE_IDENTIFIER: `${appInfo.identifier}.ShareExtension`,
+            PRODUCT_NAME: appInfo.productName,
+        };
+        // Copy ShareViewController.swift
+        const viewControllerSrc = path.join(templatesDir, "ShareViewController.swift");
+        if (fs.existsSync(viewControllerSrc)) {
+            copyTemplateFile(viewControllerSrc, path.join(extensionDir, "ShareViewController.swift"), variables);
+        }
+        else {
+            throw new Error(`Template not found: ${viewControllerSrc}`);
+        }
+        // Copy Info.plist
+        const possibleInfoPlists = [
+            path.join(templatesDir, "Info.plist"),
+            path.join(templatesDir, "ShareExtension-Info.plist"),
+        ];
+        let infoPlistFound = false;
+        for (const src of possibleInfoPlists) {
+            if (fs.existsSync(src)) {
+                copyTemplateFile(src, path.join(extensionDir, "Info.plist"), variables);
+                infoPlistFound = true;
+                break;
+            }
+        }
+        if (!infoPlistFound) {
+            // Create a default Info.plist
+            const defaultInfoPlist = `<?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>CFBundleDevelopmentRegion</key>
+    <string>$(DEVELOPMENT_LANGUAGE)</string>
+    <key>CFBundleDisplayName</key>
+    <string>Share</string>
+    <key>CFBundleExecutable</key>
+    <string>$(EXECUTABLE_NAME)</string>
+    <key>CFBundleIdentifier</key>
+    <string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+    <key>CFBundleInfoDictionaryVersion</key>
+    <string>6.0</string>
+    <key>CFBundleName</key>
+    <string>$(PRODUCT_NAME)</string>
+    <key>CFBundlePackageType</key>
+    <string>XPC!</string>
+    <key>CFBundleShortVersionString</key>
+    <string>${appInfo.version}</string>
+    <key>CFBundleVersion</key>
+    <string>${appInfo.version}</string>
+    <key>NSExtension</key>
+    <dict>
+        <key>NSExtensionAttributes</key>
+        <dict>
+            <key>NSExtensionActivationRule</key>
+            <dict>
+                <key>NSExtensionActivationSupportsFileWithMaxCount</key>
+                <integer>10</integer>
+                <key>NSExtensionActivationSupportsImageWithMaxCount</key>
+                <integer>10</integer>
+                <key>NSExtensionActivationSupportsMovieWithMaxCount</key>
+                <integer>10</integer>
+                <key>NSExtensionActivationSupportsText</key>
+                <true/>
+                <key>NSExtensionActivationSupportsWebURLWithMaxCount</key>
+                <integer>1</integer>
+            </dict>
+        </dict>
+        <key>NSExtensionPointIdentifier</key>
+        <string>com.apple.share-services</string>
+        <key>NSExtensionPrincipalClass</key>
+        <string>$(PRODUCT_MODULE_NAME).ShareViewController</string>
+    </dict>
+</dict>
+</plist>`;
+            fs.writeFileSync(path.join(extensionDir, "Info.plist"), defaultInfoPlist);
+        }
+        // Create entitlements
+        createExtensionEntitlements(extensionDir, appGroupId);
+        console.log(`Created ShareExtension files in ${extensionDir}`);
+    },
+    updateProjectYml(projectYml, appInfo) {
+        const extensionName = this.extensionName(appInfo);
+        const extensionBundleId = `${appInfo.identifier}.ShareExtension`;
+        const targetName = `${appInfo.productName}_iOS`;
+        // Create the extension target YAML
+        const extensionTarget = `
+  ${extensionName}:
+    type: app-extension
+    platform: iOS
+    deploymentTarget: "14.0"
+    sources:
+      - path: ShareExtension
+    info:
+      path: ShareExtension/Info.plist
+      properties:
+        CFBundleDisplayName: Share
+        CFBundleShortVersionString: "${appInfo.version}"
+        CFBundleVersion: "${appInfo.version}"
+        NSExtension:
+          NSExtensionAttributes:
+            NSExtensionActivationRule:
+              NSExtensionActivationSupportsFileWithMaxCount: 10
+              NSExtensionActivationSupportsImageWithMaxCount: 10
+              NSExtensionActivationSupportsMovieWithMaxCount: 10
+              NSExtensionActivationSupportsText: true
+              NSExtensionActivationSupportsWebURLWithMaxCount: 1
+          NSExtensionPointIdentifier: com.apple.share-services
+          NSExtensionPrincipalClass: $(PRODUCT_MODULE_NAME).ShareViewController
+    settings:
+      base:
+        PRODUCT_BUNDLE_IDENTIFIER: ${extensionBundleId}
+        SKIP_INSTALL: YES
+        CODE_SIGN_ENTITLEMENTS: ShareExtension/ShareExtension.entitlements
+`;
+        // Add the target
+        let modified = addExtensionTarget(projectYml, {
+            name: extensionName,
+            yaml: extensionTarget,
+        });
+        // Add dependency to main target
+        modified = addDependencyToTarget(modified, targetName, {
+            target: extensionName,
+        });
+        return modified;
+    },
+};
+
+const __filename$1 = fileURLToPath(import.meta.url);
+const __dirname$1 = path.dirname(__filename$1);
+const EXTENSIONS = {
+    share: shareExtension,
+};
+function resolveTemplatesDir(options, extensionType) {
+    // Option 1: Explicit templates path
+    if (options.templates) {
+        const templatesPath = path.resolve(process.cwd(), options.templates);
+        if (!fs.existsSync(templatesPath)) {
+            throw new Error(`Templates directory not found: ${templatesPath}`);
+        }
+        return templatesPath;
+    }
+    // Option 2: Plugin templates
+    if (options.plugin) {
+        const pluginPath = resolvePluginPath(options.plugin);
+        const pluginPkg = JSON.parse(fs.readFileSync(path.join(pluginPath, "package.json"), "utf8"));
+        const extensionConfig = pluginPkg["tauri-apple-extension"];
+        if (!extensionConfig) {
+            throw new Error(`Plugin ${options.plugin} does not have tauri-apple-extension config in package.json`);
+        }
+        if (extensionConfig.type !== extensionType) {
+            throw new Error(`Plugin ${options.plugin} is for '${extensionConfig.type}' extension, not '${extensionType}'`);
+        }
+        const templatesPath = path.join(pluginPath, extensionConfig.templates);
+        if (!fs.existsSync(templatesPath)) {
+            throw new Error(`Plugin templates directory not found: ${templatesPath}`);
+        }
+        return templatesPath;
+    }
+    // Option 3: Default templates
+    const defaultTemplates = path.join(__dirname$1, "../../templates", extensionType);
+    if (!fs.existsSync(defaultTemplates)) {
+        throw new Error(`No templates found. Use --plugin or --templates to specify templates.`);
+    }
+    return defaultTemplates;
+}
+function resolvePluginPath(pluginName) {
+    // Try to find in node_modules
+    const possiblePaths = [
+        path.join(process.cwd(), "node_modules", pluginName),
+        path.join(process.cwd(), "src-tauri", "node_modules", pluginName),
+    ];
+    for (const p of possiblePaths) {
+        if (fs.existsSync(p)) {
+            return p;
+        }
+    }
+    throw new Error(`Plugin ${pluginName} not found in node_modules. Make sure it's installed.`);
+}
+async function addExtension(type, options) {
+    console.log(`\nTauri Apple Extensions - Add ${type}\n`);
+    try {
+        // Validate extension type
+        const extension = EXTENSIONS[type];
+        if (!extension) {
+            const available = Object.keys(EXTENSIONS).join(", ");
+            throw new Error(`Unknown extension type: ${type}. Available: ${available}`);
+        }
+        // Find project
+        const projectRoot = findProjectRoot();
+        console.log(`Project root: ${projectRoot}`);
+        const tauriConfig = findTauriConfig(projectRoot);
+        const appleDir = findAppleProjectDir(projectRoot);
+        console.log(`Apple project dir: ${appleDir}`);
+        // Get app info
+        let projectYml = readProjectYml(appleDir);
+        const appInfo = getAppInfo(tauriConfig, projectYml);
+        console.log(`\nApp Info:`);
+        console.log(`  Product Name: ${appInfo.productName}`);
+        console.log(`  Bundle ID: ${appInfo.identifier}`);
+        console.log(`  Version: ${appInfo.version}`);
+        const appGroupId = `group.${appInfo.identifier}`;
+        const urlScheme = appInfo.productName
+            .toLowerCase()
+            .replace(/[^a-z0-9]/g, "");
+        console.log(`  App Group: ${appGroupId}`);
+        console.log(`  URL Scheme: ${urlScheme}`);
+        // Resolve templates
+        const templatesDir = resolveTemplatesDir(options, type);
+        console.log(`\nUsing templates from: ${templatesDir}`);
+        // Run extension setup
+        console.log(`\n1. Creating ${extension.displayName} files...`);
+        extension.createFiles(appleDir, appInfo, templatesDir);
+        console.log(`\n2. Updating main app entitlements...`);
+        updateMainAppEntitlements(appleDir, appInfo);
+        console.log(`\n3. Adding URL scheme to Info.plist...`);
+        addUrlSchemeToInfoPlist(appleDir, appInfo);
+        console.log(`\n4. Updating project.yml...`);
+        projectYml = readProjectYml(appleDir);
+        projectYml = extension.updateProjectYml(projectYml, appInfo);
+        writeProjectYml(appleDir, projectYml);
+        console.log(`\n5. Regenerating Xcode project...`);
+        runXcodeGen(appleDir);
+        console.log(`\n========================================`);
+        console.log(`${extension.displayName} setup complete!`);
+        console.log(`========================================\n`);
+        console.log(`Next steps:`);
+        console.log(`1. Open the Xcode project`);
+        console.log(`2. Select your team for both targets (main app and ${extension.extensionName(appInfo)})`);
+        console.log(`3. Enable 'App Groups' capability for both targets with: ${appGroupId}`);
+        console.log(`4. Build and run!\n`);
+        console.log(`IMPORTANT: You need to configure App Groups in Apple Developer Portal:`);
+        console.log(`  - Create App Group: ${appGroupId}`);
+        console.log(`  - Add it to both App IDs: ${appInfo.identifier} and ${appInfo.identifier}.${extension.extensionSuffix}\n`);
+    }
+    catch (error) {
+        console.error(`\nError: ${error.message}`);
+        process.exit(1);
+    }
+}
+
+const program = new Command();
+program
+    .name("tauri-apple-extensions")
+    .description("Add iOS extensions to Tauri apps")
+    .version("0.1.0");
+program
+    .command("add <type>")
+    .description("Add an extension (e.g., share)")
+    .option("-p, --plugin <name>", "Plugin to use for templates")
+    .option("-t, --templates <path>", "Custom templates directory")
+    .action(addExtension);
+program.parse();

package/dist/commands/add.d.ts

@@ -0,0 +1,2 @@
+import type { AddOptions } from "../types.js";
+export declare function addExtension(type: string, options: AddOptions): Promise<void>;

package/dist/core/entitlements.d.ts

@@ -0,0 +1,3 @@
+import type { AppInfo } from "../types.js";
+export declare function updateMainAppEntitlements(appleDir: string, appInfo: AppInfo): void;
+export declare function createExtensionEntitlements(extensionDir: string, appGroupId: string): string;

package/dist/core/info-plist.d.ts

@@ -0,0 +1,2 @@
+import type { AppInfo } from "../types.js";
+export declare function addUrlSchemeToInfoPlist(appleDir: string, appInfo: AppInfo): void;

package/dist/core/project-discovery.d.ts

@@ -0,0 +1,5 @@
+import type { AppInfo, TauriConfig } from "../types.js";
+export declare function findProjectRoot(): string;
+export declare function findTauriConfig(projectRoot: string): TauriConfig;
+export declare function findAppleProjectDir(projectRoot: string): string;
+export declare function getAppInfo(tauriConfig: TauriConfig, projectYml: string): AppInfo;

package/dist/core/project-yml.d.ts

@@ -0,0 +1,5 @@
+import type { TargetConfig, DependencyConfig } from "../types.js";
+export declare function readProjectYml(appleDir: string): string;
+export declare function writeProjectYml(appleDir: string, content: string): void;
+export declare function addExtensionTarget(projectYml: string, targetConfig: TargetConfig): string;
+export declare function addDependencyToTarget(projectYml: string, mainTargetName: string, dependencyConfig: DependencyConfig): string;

package/dist/core/xcodegen.d.ts

@@ -0,0 +1 @@
+export declare function runXcodeGen(appleDir: string): void;

package/dist/extensions/share.d.ts

@@ -0,0 +1,2 @@
+import type { Extension } from "../types.js";
+export declare const shareExtension: Extension;