@bacons/apple-targets 0.1.19 → 0.2.1

package/README.md

@@ -42,7 +42,7 @@ Some targets have special entitlements behavior:
 Any changes you make outside of the `expo:targets` directory in Xcode are subject to being overwritten by the next `npx expo prebuild --clean`. Check to see if the settings you want to toggle are available in the Info.plist or the `expo-target.config.js` file.
 If you modify the `expo-target.config.js` or your root `app.json`, you will need to re-run `npx expo prebuild --clean` to sync the changes.
 
-You can use the custom Prebuild template `--template node_modules/@bacons/apple-targets/prebuild-blank.tgz` to create a build without React Native, this can make development a bit faster since there's less to compile.
+You can use the custom Prebuild template `--template node_modules/@bacons/apple-targets/prebuild-blank.tgz` to create a build without React Native, this can make development a bit faster since there's less to compile. This is an advanced technique for development **NOT PRODUCTION** and is not intended to be used with third-party Config Plugins.
 
 ## Target config
 
@@ -220,6 +220,8 @@ module.exports = {
 
 ### `action`
 
+![IMG_C2C825ACC8C7-1](https://github.com/user-attachments/assets/8378e022-2061-4da8-9c46-efe3064dd40c)
+
 These show up in the share sheet. The icon should be transparent as it will be masked by the system.
 
 ```js
@@ -410,8 +412,78 @@ For more advanced uses, I recommend the following resources:
 
 This plugin makes use of my proprietary Xcode parsing library, [`@bacons/xcode`](https://github.com/evanbacon/xcode). It's mostly typed, very untested, and possibly full of bugs––however, it's still 10x nicer than the alternative.
 
+## Control widgets
+
+![Simulator Screenshot - iPhone 16 - 2025-01-26 at 15 57 44](https://github.com/user-attachments/assets/c989a3bb-112d-4026-a718-49de4cdb2f3e)
+
+[Control widgets](https://developer.apple.com/documentation/swiftui/controlwidget) are a type of widget that appears in the control center, Siri suggestions, the lock screen, and Shortcuts.
+
+Generally, you'll want to add control widgets to a `widget` target, but they can be added to any target really.
+
+You can add multiple intents, they should be in the `[target]/_shared/*.swift` folder so they can be added to the main target as well as the widget target, this is required to make them work correctly.
+
+The following is an example of a control widget that launches a universal link for my app.
+
+```swift
+// targets/widget/_shared/intents.swift
+
+import AppIntents
+import SwiftUI
+import WidgetKit
+
+// TODO: These must be added to the WidgetBundle manually. They need to be linked outside of the _shared folder.
+// @main
+// struct exportWidgets: WidgetBundle {
+//     var body: some Widget {
+//         widgetControl0()
+//         widgetControl1()
+//     }
+// }
+
+@available(iOS 18.0, *)
+struct widgetControl0: ControlWidget {
+    // Unique ID for the control.
+    static let kind: String = "com.bacon.clipdemo.0"
+    var body: some ControlWidgetConfiguration {
+      StaticControlConfiguration(kind: Self.kind) {
+        ControlWidgetButton(action: OpenAppIntent0()) {
+          // You can also use a custom image but it must be an SF Symbol.
+          Label("App Settings", systemImage: "star")
+        }
+      }
+      // This is the configuration for the widget.
+      .displayName("Launch Settings")
+      .description("A control that launches the app settings.")
+    }
+}
+
+// This must be in both targets when `openAppWhenRun = true`. We can do that by adding it to the _shared folder.
+// https://developer.apple.com/forums/thread/763851
+@available(iOS 18.0, *)
+struct OpenAppIntent0: ControlConfigurationIntent {
+    static let title: LocalizedStringResource = "Launch Settings"
+    static let description = IntentDescription(stringLiteral: "A control that launches the app settings.")
+    static let isDiscoverable = true
+    static let openAppWhenRun: Bool = true
+
+    @MainActor
+    func perform() async throws -> some IntentResult & OpensIntent {
+        // Here's the URL we want to launch. It can be any URL but it should be a universal link for your app.
+        return .result(opensIntent: OpenURLIntent(URL(string: "https://pillarvalley.expo.app/settings")!))
+    }
+}
+```
+
+You should copy the intents into your main `WidgetBundle` struct.
+
+Custom images can be used but they must be SF Symbols, you can use a tool like [Create Custom Symbols](https://github.com/jaywcjlove/create-custom-symbols) to do this. Then simply add to the Assets.xcassets folder and reference it in the `Label`.
+
+You can do a lot of things with Control Widgets like launching a custom UI instead of opening the app. This plugin should allow for most of these things to work.
+
 ## App Clips
 
+![IMG_6BC9D9534F1D-1](https://github.com/user-attachments/assets/f9847f6f-4f0a-44f9-932c-3f8e9703c133)
+
 App Clips leverage the true power of Expo Router, enabling you to link a website and native app to just instantly open the native app on iOS. They're pretty hard to get working though.
 
 Here are a few notes from my experience building https://pillarvalley.expo.app (open on iOS to test).

package/build/config-plugin.js

@@ -20,7 +20,7 @@ const withTargetsDir = (config, _props) => {
         hasWarned = true;
         console.warn((0, chalk_1.default) `{yellow [bacons/apple-targets]} Expo config is missing required {cyan ios.appleTeamId} property. Find this in Xcode and add to the Expo Config to correct. iOS builds may fail until this is corrected.`);
     }
-    const targets = (0, glob_1.sync)(`${root}/${match}/expo-target.config.@(json|js)`, {
+    const targets = (0, glob_1.globSync)(`${root}/${match}/expo-target.config.@(json|js)`, {
         // const targets = globSync(`./targets/action/expo-target.config.@(json|js)`, {
         cwd: projectRoot,
         absolute: true,
@@ -38,6 +38,9 @@ const withTargetsDir = (config, _props) => {
         else if (typeof targetConfig !== "object") {
             throw new Error(`Expected target config to be an object or function that returns an object, but got ${typeof targetConfig}`);
         }
+        if (!evaluatedTargetConfigObject.type) {
+            throw new Error(`Expected target config to have a 'type' property denoting the type of target it is, e.g. 'widget'`);
+        }
         config = (0, withWidget_1.default)(config, {
             appleTeamId,
             ...evaluatedTargetConfigObject,

package/build/icon/withImageAsset.js

@@ -27,7 +27,7 @@ exports.generateWatchIconsInternalAsync = exports.generateIconsInternalAsync = e
 const config_plugins_1 = require("@expo/config-plugins");
 const image_utils_1 = require("@expo/image-utils");
 const AssetContents_1 = require("@expo/prebuild-config/build/plugins/icons/AssetContents");
-const fs = __importStar(require("fs-extra"));
+const fs = __importStar(require("fs"));
 const path_1 = __importStar(require("path"));
 const withImageAsset = (config, { cwd, name, image }) => {
     return (0, config_plugins_1.withDangerousMod)(config, [
@@ -37,7 +37,9 @@ const withImageAsset = (config, { cwd, name, image }) => {
             const iosNamedProjectRoot = (0, path_1.join)(projectRoot, cwd);
             const imgPath = `Assets.xcassets/${name}.imageset`;
             // Ensure the Images.xcassets/AppIcon.appiconset path exists
-            await fs.ensureDir((0, path_1.join)(iosNamedProjectRoot, imgPath));
+            await fs.promises.mkdir((0, path_1.join)(iosNamedProjectRoot, imgPath), {
+                recursive: true,
+            });
             const userDefinedIcon = typeof image === "string"
                 ? { "1x": image, "2x": undefined, "3x": undefined }
                 : image;
@@ -120,7 +122,9 @@ exports.ICON_CONTENTS = [
 ];
 async function setIconsAsync(icon, projectRoot, iosNamedProjectRoot, cacheComponent) {
     // Ensure the Images.xcassets/AppIcon.appiconset path exists
-    await fs.ensureDir((0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH));
+    await fs.promises.mkdir((0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH), {
+        recursive: true,
+    });
     // Finally, write the Config.json
     await (0, AssetContents_1.writeContentsJsonAsync)((0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH), {
         images: await generateIconsInternalAsync(icon, projectRoot, iosNamedProjectRoot, cacheComponent),
@@ -154,7 +158,7 @@ async function generateResizedImageAsync(icon, name, projectRoot, iosNamedProjec
             });
             // Write image buffer to the file system.
             const assetPath = (0, path_1.join)(iosNamedProjectRoot, `Assets.xcassets/${name}.imageset`, filename);
-            await fs.writeFile(assetPath, source);
+            await fs.promises.writeFile(assetPath, source);
             if (filename) {
                 imgEntry.filename = filename;
             }
@@ -196,7 +200,7 @@ async function generateIconsInternalAsync(icon, projectRoot, iosNamedProjectRoot
                     });
                     // Write image buffer to the file system.
                     const assetPath = (0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH, filename);
-                    await fs.writeFile(assetPath, source);
+                    await fs.promises.writeFile(assetPath, source);
                     // Save a reference to the generated image so we don't create a duplicate.
                     generatedIcons[filename] = true;
                 }
@@ -234,7 +238,7 @@ async function generateWatchIconsInternalAsync(icon, projectRoot, iosNamedProjec
     });
     // Write image buffer to the file system.
     const assetPath = (0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH, filename);
-    await fs.writeFile(assetPath, source);
+    await fs.promises.writeFile(assetPath, source);
     imagesJson.push({
         filename: getAppleIconName(size, 1),
         idiom: "universal",

package/build/icon/withIosIcon.js

@@ -27,7 +27,7 @@ exports.generateWatchIconsInternalAsync = exports.generateIconsInternalAsync = e
 const config_plugins_1 = require("@expo/config-plugins");
 const image_utils_1 = require("@expo/image-utils");
 const AssetContents_1 = require("@expo/prebuild-config/build/plugins/icons/AssetContents");
-const fs = __importStar(require("fs-extra"));
+const fs = __importStar(require("fs"));
 const path_1 = require("path");
 // TODO: support dark, tinted, and universal icons for widgets.
 const withIosIcon = (config, { cwd, type, iconFilePath, isTransparent = false }) => {
@@ -38,7 +38,9 @@ const withIosIcon = (config, { cwd, type, iconFilePath, isTransparent = false })
             const namedProjectRoot = (0, path_1.join)(projectRoot, cwd);
             if (type === "watch") {
                 // Ensure the Images.xcassets/AppIcon.appiconset path exists
-                await fs.ensureDir((0, path_1.join)(namedProjectRoot, IMAGESET_PATH));
+                await fs.promises.mkdir((0, path_1.join)(namedProjectRoot, IMAGESET_PATH), {
+                    recursive: true,
+                });
                 // Finally, write the Config.json
                 await (0, AssetContents_1.writeContentsJsonAsync)((0, path_1.join)(namedProjectRoot, IMAGESET_PATH), {
                     images: await generateWatchIconsInternalAsync(iconFilePath, projectRoot, namedProjectRoot, cwd, isTransparent),
@@ -119,7 +121,9 @@ exports.ICON_CONTENTS = [
 ];
 async function setIconsAsync(icon, projectRoot, iosNamedProjectRoot, cacheComponent, isTransparent) {
     // Ensure the Images.xcassets/AppIcon.appiconset path exists
-    await fs.ensureDir((0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH));
+    await fs.promises.mkdir((0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH), {
+        recursive: true,
+    });
     // Finally, write the Config.json
     await (0, AssetContents_1.writeContentsJsonAsync)((0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH), {
         images: await generateIconsInternalAsync(icon, projectRoot, iosNamedProjectRoot, cacheComponent, isTransparent),
@@ -158,7 +162,7 @@ async function generateIconsInternalAsync(icon, projectRoot, iosNamedProjectRoot
                     });
                     // Write image buffer to the file system.
                     const assetPath = (0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH, filename);
-                    await fs.writeFile(assetPath, source);
+                    await fs.promises.writeFile(assetPath, source);
                     // Save a reference to the generated image so we don't create a duplicate.
                     generatedIcons[filename] = true;
                 }
@@ -196,7 +200,7 @@ async function generateWatchIconsInternalAsync(icon, projectRoot, iosNamedProjec
     });
     // Write image buffer to the file system.
     const assetPath = (0, path_1.join)(iosNamedProjectRoot, IMAGESET_PATH, filename);
-    await fs.writeFile(assetPath, source);
+    await fs.promises.writeFile(assetPath, source);
     imagesJson.push({
         filename: getAppleIconName(size, 1),
         idiom: "universal",

package/build/withWidget.js

@@ -45,30 +45,32 @@ function createLogQueue() {
 }
 // Queue up logs so they only run when prebuild is actually running and not during standard config reads.
 const prebuildLogQueue = createLogQueue();
-function kebabToCamelCase(str) {
-    return str.replace(/-([a-z])/g, function (g) {
-        return g[1].toUpperCase();
-    });
-}
 const withWidget = (config, props) => {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
     prebuildLogQueue.add(() => warnOnce((0, chalk_1.default) `\nUsing experimental Config Plugin {bold @bacons/apple-targets} that is subject to breaking changes.`));
     // TODO: Magically based on the top-level folders in the `ios-widgets/` folder
     if (props.icon && !/https?:\/\//.test(props.icon)) {
         props.icon = path_1.default.join(props.directory, props.icon);
     }
-    const widgetDir = path_1.default
-        .basename(props.directory)
-        .replace(/\/+$/, "")
-        .replace(/^\/+/, "");
-    const widget = kebabToCamelCase(widgetDir);
-    const widgetFolderAbsolutePath = path_1.default.join((_b = (_a = config._internal) === null || _a === void 0 ? void 0 : _a.projectRoot) !== null && _b !== void 0 ? _b : "", props.directory);
-    const entitlementsFiles = (0, glob_1.sync)("*.entitlements", {
+    // This value should be used for the target name and other internal uses.
+    const targetDirName = path_1.default.basename(path_1.default.dirname(props.configPath));
+    // Sanitized for general usage. This name just needs to resemble the input value since it shouldn't be used for user-facing values such as the home screen or app store.
+    const productName = sanitizeNameForNonDisplayUse(props.name || targetDirName) ||
+        sanitizeNameForNonDisplayUse(targetDirName) ||
+        sanitizeNameForNonDisplayUse(props.type);
+    // This should never happen.
+    if (!productName) {
+        throw new Error(`[bacons/apple-targets][${props.type}] Target name does not contain any valid characters: ${targetDirName}`);
+    }
+    // TODO: Are there characters that aren't allowed in `CFBundleDisplayName`?
+    const targetDisplayName = (_a = props.name) !== null && _a !== void 0 ? _a : productName;
+    const targetDirAbsolutePath = path_1.default.join((_c = (_b = config._internal) === null || _b === void 0 ? void 0 : _b.projectRoot) !== null && _c !== void 0 ? _c : "", props.directory);
+    const entitlementsFiles = (0, glob_1.globSync)("*.entitlements", {
         absolute: true,
-        cwd: widgetFolderAbsolutePath,
+        cwd: targetDirAbsolutePath,
     });
     if (entitlementsFiles.length > 1) {
-        throw new Error(`[bacons/apple-targets][${props.type}] Found more than one '*.entitlements' file in ${widgetFolderAbsolutePath}`);
+        throw new Error(`[bacons/apple-targets][${props.type}] Found more than one '*.entitlements' file in ${targetDirAbsolutePath}`);
     }
     let entitlementsJson = props.entitlements;
     if (entitlementsJson) {
@@ -87,7 +89,7 @@ const withWidget = (config, props) => {
                     if (!associatedDomains ||
                         !Array.isArray(associatedDomains) ||
                         associatedDomains.length === 0) {
-                        warnOnce((0, chalk_1.default) `{yellow [${widget}]} Apple App Clip may require the associated domains entitlement but none were found in the Expo config.\nExample:\n${JSON.stringify({
+                        warnOnce((0, chalk_1.default) `{yellow [${targetDirName}]} Apple App Clip may require the associated domains entitlement but none were found in the Expo config.\nExample:\n${JSON.stringify({
                             ios: {
                                 associatedDomains: [`applinks:placeholder.expo.app`],
                             },
@@ -110,7 +112,7 @@ const withWidget = (config, props) => {
                             .filter(Boolean);
                         const unique = [...new Set(sanitizedUrls)];
                         if (unique.length) {
-                            warnOnce((0, chalk_1.default) `{gray [${widget}]} Apple App Clip expo-target.config.js missing associated domains entitlements in the target config. Using the following defaults:\n${JSON.stringify({
+                            warnOnce((0, chalk_1.default) `{gray [${targetDirName}]} Apple App Clip expo-target.config.js missing associated domains entitlements in the target config. Using the following defaults:\n${JSON.stringify({
                                 entitlements: {
                                     [associatedDomainsKey]: [
                                         `appclips:${unique[0] || "mywebsite.expo.app"}`,
@@ -137,13 +139,13 @@ const withWidget = (config, props) => {
                     // Then set the target app groups to match the main app.
                     entitlements[APP_GROUP_KEY] = mainAppGroups;
                     prebuildLogQueue.add(() => {
-                        logOnce((0, chalk_1.default) `[${widget}] Syncing app groups with main app. {dim Define entitlements[${JSON.stringify(APP_GROUP_KEY)}] in the {bold expo-target.config} file to override.}`);
+                        logOnce((0, chalk_1.default) `[${targetDirName}] Syncing app groups with main app. {dim Define entitlements[${JSON.stringify(APP_GROUP_KEY)}] in the {bold expo-target.config} file to override.}`);
                     });
                 }
                 else {
                     prebuildLogQueue.add(() => {
                         var _a, _b;
-                        return warnOnce((0, chalk_1.default) `{yellow [${widget}]} Apple target may require the App Groups entitlement but none were found in the Expo config.\nExample:\n${JSON.stringify({
+                        return warnOnce((0, chalk_1.default) `{yellow [${targetDirName}]} Apple target may require the App Groups entitlement but none were found in the Expo config.\nExample:\n${JSON.stringify({
                             ios: {
                                 entitlements: {
                                     [APP_GROUP_KEY]: [
@@ -168,11 +170,11 @@ const withWidget = (config, props) => {
                 const GENERATED_ENTITLEMENTS_FILE_NAME = "generated.entitlements";
                 const entitlementsFilePath = (_a = entitlementsFiles[0]) !== null && _a !== void 0 ? _a : 
                 // Use the name `generated` to help indicate that this file should be in sync with the config
-                path_1.default.join(widgetFolderAbsolutePath, GENERATED_ENTITLEMENTS_FILE_NAME);
+                path_1.default.join(targetDirAbsolutePath, GENERATED_ENTITLEMENTS_FILE_NAME);
                 if (entitlementsFiles[0]) {
-                    const relativeName = path_1.default.relative(widgetFolderAbsolutePath, entitlementsFiles[0]);
+                    const relativeName = path_1.default.relative(targetDirAbsolutePath, entitlementsFiles[0]);
                     if (relativeName !== GENERATED_ENTITLEMENTS_FILE_NAME) {
-                        console.log(`[${widget}] Replacing ${path_1.default.relative(widgetFolderAbsolutePath, entitlementsFiles[0])} with entitlements JSON from config`);
+                        console.log(`[${targetDirName}] Replacing ${path_1.default.relative(targetDirAbsolutePath, entitlementsFiles[0])} with entitlements JSON from config`);
                     }
                 }
                 fs_1.default.writeFileSync(entitlementsFilePath, plist_1.default.build(entitlementsJson));
@@ -190,7 +192,7 @@ const withWidget = (config, props) => {
         "ios",
         async (config) => {
             prebuildLogQueue.flush();
-            fs_1.default.mkdirSync(widgetFolderAbsolutePath, { recursive: true });
+            fs_1.default.mkdirSync(targetDirAbsolutePath, { recursive: true });
             const files = [
                 ["Info.plist", (0, target_1.getTargetInfoPlistForType)(props.type)],
             ];
@@ -208,7 +210,7 @@ const withWidget = (config, props) => {
             //   );
             // }
             files.forEach(([filename, content]) => {
-                const filePath = path_1.default.join(widgetFolderAbsolutePath, filename);
+                const filePath = path_1.default.join(targetDirAbsolutePath, filename);
                 if (!fs_1.default.existsSync(filePath)) {
                     fs_1.default.writeFileSync(filePath, content);
                 }
@@ -216,41 +218,55 @@ const withWidget = (config, props) => {
             return config;
         },
     ]);
-    const targetName = (_c = props.name) !== null && _c !== void 0 ? _c : widget;
     const mainAppBundleId = config.ios.bundleIdentifier;
-    const bundleId = ((_d = props.bundleIdentifier) === null || _d === void 0 ? void 0 : _d.startsWith("."))
-        ? mainAppBundleId + props.bundleIdentifier
-        : (_e = props.bundleIdentifier) !== null && _e !== void 0 ? _e : `${mainAppBundleId}.${props.type === "clip"
-            ? // Use a more standardized bundle identifier for App Clips.
-                "clip"
-            : getSanitizedBundleIdentifier(targetName)}`;
-    const deviceFamilies = ((_f = config.ios) === null || _f === void 0 ? void 0 : _f.isTabletOnly)
+    const bundleId = (() => {
+        var _a;
+        // Support the bundle identifier being appended to the main app's bundle identifier.
+        if ((_a = props.bundleIdentifier) === null || _a === void 0 ? void 0 : _a.startsWith(".")) {
+            return mainAppBundleId + props.bundleIdentifier;
+        }
+        else if (props.bundleIdentifier) {
+            return props.bundleIdentifier;
+        }
+        if (props.type === "clip") {
+            // Use a more standardized bundle identifier for App Clips.
+            return mainAppBundleId + ".clip";
+        }
+        let bundleId = mainAppBundleId;
+        bundleId += ".";
+        // Generate the bundle identifier. This logic needs to remain generally stable since it's used for a permanent value.
+        // Key here is simplicity and predictability since it's already appended to the main app's bundle identifier.
+        return mainAppBundleId + "." + getSanitizedBundleIdentifier(props.type);
+    })();
+    const deviceFamilies = ((_d = config.ios) === null || _d === void 0 ? void 0 : _d.isTabletOnly)
         ? ["tablet"]
-        : ((_g = config.ios) === null || _g === void 0 ? void 0 : _g.supportsTablet)
+        : ((_e = config.ios) === null || _e === void 0 ? void 0 : _e.supportsTablet)
             ? ["phone", "tablet"]
             : ["phone"];
     (0, withXcodeChanges_1.withXcodeChanges)(config, {
+        productName,
         configPath: props.configPath,
-        name: targetName,
+        name: targetDisplayName,
         cwd: "../" +
             path_1.default.relative(config._internal.projectRoot, path_1.default.resolve(props.directory)),
-        deploymentTarget: (_h = props.deploymentTarget) !== null && _h !== void 0 ? _h : DEFAULT_DEPLOYMENT_TARGET,
+        deploymentTarget: (_f = props.deploymentTarget) !== null && _f !== void 0 ? _f : DEFAULT_DEPLOYMENT_TARGET,
         bundleId,
         icon: props.icon,
         orientation: config.orientation,
-        hasAccentColor: !!((_j = props.colors) === null || _j === void 0 ? void 0 : _j.$accent),
+        hasAccentColor: !!((_g = props.colors) === null || _g === void 0 ? void 0 : _g.$accent),
         deviceFamilies,
         // @ts-expect-error: who cares
-        currentProjectVersion: ((_k = config.ios) === null || _k === void 0 ? void 0 : _k.buildNumber) || 1,
+        currentProjectVersion: ((_h = config.ios) === null || _h === void 0 ? void 0 : _h.buildNumber) || 1,
         frameworks: (0, target_1.getFrameworksForType)(props.type).concat(props.frameworks || []),
         type: props.type,
         teamId: props.appleTeamId,
-        exportJs: (_l = props.exportJs) !== null && _l !== void 0 ? _l : 
+        colors: props.colors,
+        exportJs: (_j = props.exportJs) !== null && _j !== void 0 ? _j : 
         // Assume App Clips are used for React Native.
         props.type === "clip",
     });
     config = (0, withEasCredentials_1.withEASTargets)(config, {
-        targetName,
+        targetName: productName,
         bundleIdentifier: bundleId,
         entitlements: entitlementsJson,
     });
@@ -306,3 +322,9 @@ function getSanitizedBundleIdentifier(value) {
     // Can have empty segments (e.g. com.example..app).
     return value.replace(/(^[^a-zA-Z.-]|[^a-zA-Z0-9-.])/g, "-");
 }
+function sanitizeNameForNonDisplayUse(name) {
+    return name
+        .replace(/[\W_]+/g, "")
+        .normalize("NFD")
+        .replace(/[\u0300-\u036f]/g, "");
+}

package/build/withXcodeChanges.d.ts

@@ -2,6 +2,8 @@ import { ConfigPlugin } from "@expo/config-plugins";
 import { ExtensionType } from "./target";
 export type XcodeSettings = {
     name: string;
+    /** Name used for internal purposes. This has more strict rules and should be generated. */
+    productName: string;
     /** Directory relative to the project root, (i.e. outside of the `ios` directory) where the widget code should live. */
     cwd: string;
     bundleId: string;
@@ -10,7 +12,7 @@ export type XcodeSettings = {
     frameworks: string[];
     type: ExtensionType;
     hasAccentColor?: boolean;
-    colors?: Record<string, string>;
+    colors?: Record<string, any>;
     teamId?: string;
     icon?: string;
     exportJs?: boolean;

package/build/withXcodeChanges.js

@@ -14,9 +14,8 @@ const TemplateBuildSettings = XCBuildConfiguration_json_1.default;
 const withXcparse_1 = require("./withXcparse");
 const assert_1 = __importDefault(require("assert"));
 const withXcodeChanges = (config, props) => {
-    return (0, withXcparse_1.withXcodeProjectBeta)(config, (config) => {
-        // @ts-ignore
-        applyXcodeChanges(config, config.modResults, props);
+    return (0, withXcparse_1.withXcodeProjectBeta)(config, async (config) => {
+        await applyXcodeChanges(config, config.modResults, props);
         return config;
     });
 };
@@ -553,7 +552,7 @@ function getDeviceFamilyBuildSettings(deviceFamilies) {
         TARGETED_DEVICE_FAMILY: families.join(","),
     };
 }
-function createConfigurationList(project, { name, cwd, bundleId, deploymentTarget, currentProjectVersion, }) {
+function createWidgetConfigurationList(project, { name, cwd, bundleId, deploymentTarget, currentProjectVersion, }) {
     const debugBuildConfig = xcode_1.XCBuildConfiguration.create(project, {
         name: "Debug",
         buildSettings: {
@@ -641,7 +640,7 @@ function createConfigurationList(project, { name, cwd, bundleId, deploymentTarge
 }
 function createConfigurationListForType(project, props) {
     if (props.type === "widget") {
-        return createConfigurationList(project, props);
+        return createWidgetConfigurationList(project, props);
     }
     else if (props.type === "action") {
         return createExtensionConfigurationListFromTemplate(project, "com.apple.services", props);
@@ -684,7 +683,7 @@ async function applyXcodeChanges(config, project, props) {
         });
     }
     const targets = getExtensionTargets();
-    const productName = props.name;
+    const productName = props.productName;
     let targetToUpdate = (_a = targets.find((target) => target.props.productName === productName)) !== null && _a !== void 0 ? _a : targets[0];
     if (targetToUpdate) {
         console.log(`Target "${targetToUpdate.props.productName}" already exists, updating instead of creating a new one`);
@@ -732,7 +731,7 @@ async function applyXcodeChanges(config, project, props) {
         }
     }
     function configureTargetWithEntitlements(target) {
-        const entitlements = (0, glob_1.sync)("*.entitlements", {
+        const entitlements = (0, glob_1.globSync)("*.entitlements", {
             absolute: false,
             cwd: magicCwd,
         });
@@ -754,7 +753,7 @@ async function applyXcodeChanges(config, project, props) {
         });
     }
     function configureTargetWithPreview(target) {
-        const assets = (0, glob_1.sync)("preview/*.xcassets", {
+        const assets = (0, glob_1.globSync)("preview/*.xcassets", {
             absolute: true,
             cwd: magicCwd,
         })[0];
@@ -833,7 +832,7 @@ async function applyXcodeChanges(config, project, props) {
                     ? "wrapper.extensionkit-extension"
                     : "wrapper.app-extension",
                 includeInIndex: 0,
-                path: productName + (isExtension ? ".appex" : ".app"),
+                path: props.name + (isExtension ? ".appex" : ".app"),
                 sourceTree: "BUILT_PRODUCTS_DIR",
             }),
             settings: {
@@ -845,7 +844,7 @@ async function applyXcodeChanges(config, project, props) {
         appExtensionBuildFile.props.fileRef);
         targetToUpdate = project.rootObject.createNativeTarget({
             buildConfigurationList: createConfigurationListForType(project, props),
-            name: productName,
+            name: props.name,
             productName,
             // @ts-expect-error
             productReference: appExtensionBuildFile.props.fileRef /* alphaExtension.appex */,
@@ -874,7 +873,7 @@ async function applyXcodeChanges(config, project, props) {
             fs_1.default.statSync(path_1.default.join(assetsDir, file)).isDirectory())
             .map((file) => path_1.default.join("assets", file));
     const protectedGroup = ensureProtectedGroup(project, path_1.default.dirname(props.cwd));
-    const sharedAssets = (0, glob_1.sync)("_shared/*", {
+    const sharedAssets = (0, glob_1.globSync)("_shared/*", {
         absolute: false,
         cwd: magicCwd,
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bacons/apple-targets",
-  "version": "0.1.19",
+  "version": "0.2.1",
   "description": "Generate Apple Targets with Expo Prebuild",
   "main": "build/ExtensionStorage.js",
   "types": "build/ExtensionStorage.d.ts",
@@ -33,15 +33,13 @@
   "author": "Evan Bacon",
   "license": "MIT",
   "dependencies": {
-    "@react-native/normalize-colors": "^0.76.1",
-    "glob": "^10.2.6",
     "@bacons/xcode": "1.0.0-alpha.24",
-    "fs-extra": "^11.2.0",
+    "@react-native/normalize-colors": "^0.76.1",
+    "glob": "^10.4.2",
     "debug": "^4.3.4"
   },
   "devDependencies": {
     "@types/debug": "^4.1.7",
-    "@types/fs-extra": "^11.0.4",
     "@types/glob": "^8.1.0",
     "@expo/babel-preset-cli": "^0.3.1",
     "chalk": "^4.0.0",