rork-xcode 0.6.0 → 0.8.0

package/dist/index.d.ts

@@ -261,6 +261,15 @@ declare const ProductType: {
  * The Apple platforms the model can resolve a main application target for.
  */
 type ApplePlatform = "ios" | "macos" | "tvos" | "watchos" | "visionos";
+/**
+ * Normalizes a platform name to an {@link ApplePlatform}. Punctuation and
+ * casing are ignored, so spellings like `tvOS`, `TV_OS`, and `visionos`
+ * all resolve, and the SDK names Xcode writes into `SDKROOT` (for
+ * example `iphoneos`, `appletvos`, and `xros`, with their simulator
+ * variants) resolve to the platform they build for. Anything else
+ * returns `undefined`.
+ */
+declare function parseApplePlatform(value: string): ApplePlatform | undefined;
 /**
  * `dstSubfolderSpec` values for copy-files build phases, named after the
  * destination each selects.
@@ -723,6 +732,14 @@ declare class NativeTarget extends Target<NativeTargetProperties> {
    *   target has no product reference to embed.
    */
   embed(extension: NativeTarget): CopyFilesBuildPhase | undefined;
+  /**
+   * The targets whose products this target's copy-files phases carry,
+   * in phase and file order. This is the read-side counterpart of
+   * {@link embed}: extensions, watch apps, and App Clips embedded here
+   * come back as their target views. Targets embedding further targets
+   * of their own can be walked recursively through this accessor.
+   */
+  embeddedTargets(): NativeTarget[];
   /**
    * The on-disk folder paths of the file-system-synchronized groups linked
    * to this target. Empty for targets without synchronized folders
@@ -942,6 +959,11 @@ declare class CopyFilesBuildPhase extends BuildPhase<CopyFilesBuildPhaseProperti
    * when present.
    */
   get dstPath(): string | undefined;
+  /**
+   * The destination folder code, when present. Compare against the
+   * {@link CopyFilesDestination} constants.
+   */
+  get dstSubfolderSpec(): number | undefined;
 }
 /**
  * A `PBXShellScriptBuildPhase` runs a script during the build.
@@ -1946,4 +1968,4 @@ declare function parseXcscheme(text: string): XcschemeDocument;
  */
 declare function generateObjectId(seed: string, existing: ReadonlySet<string>): string;
 //#endregion
-export { type AddNativeTargetOptions, AggregateTarget, type ApplePlatform, AppleScriptBuildPhase, BuildConfiguration, type BuildConfigurationProperties, BuildFile, BuildFileExceptionSet, type BuildFileProperties, BuildPhase, type BuildPhaseIsa, BuildPhaseMembershipExceptionSet, type BuildPhaseMembershipExceptionSetProperties, type BuildPhaseOf, type BuildPhaseProperties, BuildRule, type BuildRuleProperties, type BuildSettings, BuildStyle, type BuildStyleProperties, BuildableReference, ConfigurationList, type ConfigurationListProperties, ContainerItemProxy, type ContainerItemProxyProperties, CopyFilesBuildPhase, type CopyFilesBuildPhaseProperties, CopyFilesDestination, type CreateXcschemeOptions, ExceptionSet, type ExceptionSetProperties, FileReference, type FileReferenceProperties, FrameworksBuildPhase, Group, type GroupProperties, HeadersBuildPhase, Isa, type IsaValue, LegacyTarget, type LegacyTargetProperties, LocalSwiftPackageReference, type LocalSwiftPackageReferenceProperties, NativeTarget, type NativeTargetProperties, type PbxprojArray, PbxprojBuildError, type PbxprojErrorPosition, type PbxprojObject, PbxprojParseError, type PbxprojValue, ProductType, type ProjectIssue, type ProjectIssueKind, ReferenceProxy, type ReferenceProxyProperties, RemoteSwiftPackageReference, type RemoteSwiftPackageReferenceProperties, ResourcesBuildPhase, RezBuildPhase, RootProject, type RootProjectProperties, ShellScriptBuildPhase, type ShellScriptBuildPhaseProperties, SourcesBuildPhase, SwiftPackageProductDependency, type SwiftPackageProductDependencyProperties, SwiftPackageReference, type SwiftPackageReferenceProperties, SyncRootGroup, type SyncRootGroupProperties, Target, TargetDependency, type TargetDependencyProperties, type TargetProperties, VariantGroup, VersionGroup, type VersionGroupProperties, type ViewByIsa, type ViewOf, XcodeModelError, XcodeObject, XcodeProject, Xcscheme, XcschemeBuildError, type XcschemeComment, type XcschemeDocument, type XcschemeElement, type XcschemeNode, XcschemeParseError, buildPbxproj, buildXcscheme, createXcscheme, generateObjectId, isXcschemeElement, parsePbxproj, parseXcscheme, xcschemeElements };
+export { type AddNativeTargetOptions, AggregateTarget, type ApplePlatform, AppleScriptBuildPhase, BuildConfiguration, type BuildConfigurationProperties, BuildFile, BuildFileExceptionSet, type BuildFileProperties, BuildPhase, type BuildPhaseIsa, BuildPhaseMembershipExceptionSet, type BuildPhaseMembershipExceptionSetProperties, type BuildPhaseOf, type BuildPhaseProperties, BuildRule, type BuildRuleProperties, type BuildSettings, BuildStyle, type BuildStyleProperties, BuildableReference, ConfigurationList, type ConfigurationListProperties, ContainerItemProxy, type ContainerItemProxyProperties, CopyFilesBuildPhase, type CopyFilesBuildPhaseProperties, CopyFilesDestination, type CreateXcschemeOptions, ExceptionSet, type ExceptionSetProperties, FileReference, type FileReferenceProperties, FrameworksBuildPhase, Group, type GroupProperties, HeadersBuildPhase, Isa, type IsaValue, LegacyTarget, type LegacyTargetProperties, LocalSwiftPackageReference, type LocalSwiftPackageReferenceProperties, NativeTarget, type NativeTargetProperties, type PbxprojArray, PbxprojBuildError, type PbxprojErrorPosition, type PbxprojObject, PbxprojParseError, type PbxprojValue, ProductType, type ProjectIssue, type ProjectIssueKind, ReferenceProxy, type ReferenceProxyProperties, RemoteSwiftPackageReference, type RemoteSwiftPackageReferenceProperties, ResourcesBuildPhase, RezBuildPhase, RootProject, type RootProjectProperties, ShellScriptBuildPhase, type ShellScriptBuildPhaseProperties, SourcesBuildPhase, SwiftPackageProductDependency, type SwiftPackageProductDependencyProperties, SwiftPackageReference, type SwiftPackageReferenceProperties, SyncRootGroup, type SyncRootGroupProperties, Target, TargetDependency, type TargetDependencyProperties, type TargetProperties, VariantGroup, VersionGroup, type VersionGroupProperties, type ViewByIsa, type ViewOf, XcodeModelError, XcodeObject, XcodeProject, Xcscheme, XcschemeBuildError, type XcschemeComment, type XcschemeDocument, type XcschemeElement, type XcschemeNode, XcschemeParseError, buildPbxproj, buildXcscheme, createXcscheme, generateObjectId, isXcschemeElement, parseApplePlatform, parsePbxproj, parseXcscheme, xcschemeElements };

package/dist/index.js

@@ -887,6 +887,33 @@ const PRODUCT_FILE_INFO = {
 	}
 };
 /**
+* Normalizes a platform name to an {@link ApplePlatform}. Punctuation and
+* casing are ignored, so spellings like `tvOS`, `TV_OS`, and `visionos`
+* all resolve, and the SDK names Xcode writes into `SDKROOT` (for
+* example `iphoneos`, `appletvos`, and `xros`, with their simulator
+* variants) resolve to the platform they build for. Anything else
+* returns `undefined`.
+*/
+function parseApplePlatform(value) {
+	switch (value.toLowerCase().replaceAll(/[^a-z]/gu, "")) {
+		case "ios":
+		case "iphoneos":
+		case "iphonesimulator": return "ios";
+		case "macos":
+		case "macosx":
+		case "osx": return "macos";
+		case "tvos":
+		case "appletvos":
+		case "appletvsimulator": return "tvos";
+		case "watchos":
+		case "watchsimulator": return "watchos";
+		case "visionos":
+		case "xros":
+		case "xrsimulator": return "visionos";
+		default: return;
+	}
+}
+/**
 * The build-setting key that carries each platform's deployment target.
 * A target (or its project) sets exactly one of these per platform it
 * builds for, which is what makes them usable as a platform signal.
@@ -1343,6 +1370,14 @@ var CopyFilesBuildPhase = class extends BuildPhase {
 	get dstPath() {
 		return this.getString("dstPath");
 	}
+	/**
+	* The destination folder code, when present. Compare against the
+	* {@link CopyFilesDestination} constants.
+	*/
+	get dstSubfolderSpec() {
+		const value = this.properties["dstSubfolderSpec"];
+		return typeof value === "number" ? value : void 0;
+	}
 };
 /**
 * A `PBXShellScriptBuildPhase` runs a script during the build.
@@ -3136,6 +3171,32 @@ var NativeTarget = class extends Target {
 		return phase;
 	}
 	/**
+	* The targets whose products this target's copy-files phases carry,
+	* in phase and file order. This is the read-side counterpart of
+	* {@link embed}: extensions, watch apps, and App Clips embedded here
+	* come back as their target views. Targets embedding further targets
+	* of their own can be walked recursively through this accessor.
+	*/
+	embeddedTargets() {
+		const ownersByProductId = /* @__PURE__ */ new Map();
+		for (const candidate of this.project.nativeTargets()) {
+			const product = candidate.productReference;
+			if (product != null) ownersByProductId.set(product.id, candidate);
+		}
+		const embedded = [];
+		for (const phase of this.buildPhases()) {
+			if (!CopyFilesBuildPhase.is(phase)) continue;
+			for (const buildFileId of phase.buildFileIds) {
+				const buildFile = this.project.get(buildFileId);
+				if (!BuildFile.is(buildFile)) continue;
+				const reference = buildFile.fileReference();
+				const owner = reference == null ? void 0 : ownersByProductId.get(reference.id);
+				if (owner != null && owner !== this && !embedded.includes(owner)) embedded.push(owner);
+			}
+		}
+		return embedded;
+	}
+	/**
 	* The on-disk folder paths of the file-system-synchronized groups linked
 	* to this target. Empty for targets without synchronized folders
 	* (projects predating Xcode 16).
@@ -4496,4 +4557,4 @@ function createXcscheme(options) {
 	};
 }
 //#endregion
-export { AggregateTarget, AppleScriptBuildPhase, BuildConfiguration, BuildFile, BuildFileExceptionSet, BuildPhase, BuildPhaseMembershipExceptionSet, BuildRule, BuildStyle, BuildableReference, ConfigurationList, ContainerItemProxy, CopyFilesBuildPhase, CopyFilesDestination, ExceptionSet, FileReference, FrameworksBuildPhase, Group, HeadersBuildPhase, Isa, LegacyTarget, LocalSwiftPackageReference, NativeTarget, PbxprojBuildError, PbxprojParseError, ProductType, ReferenceProxy, RemoteSwiftPackageReference, ResourcesBuildPhase, RezBuildPhase, RootProject, ShellScriptBuildPhase, SourcesBuildPhase, SwiftPackageProductDependency, SwiftPackageReference, SyncRootGroup, Target, TargetDependency, VariantGroup, VersionGroup, XcodeModelError, XcodeObject, XcodeProject, Xcscheme, XcschemeBuildError, XcschemeParseError, buildPbxproj, buildXcscheme, createXcscheme, generateObjectId, isXcschemeElement, parsePbxproj, parseXcscheme, xcschemeElements };
+export { AggregateTarget, AppleScriptBuildPhase, BuildConfiguration, BuildFile, BuildFileExceptionSet, BuildPhase, BuildPhaseMembershipExceptionSet, BuildRule, BuildStyle, BuildableReference, ConfigurationList, ContainerItemProxy, CopyFilesBuildPhase, CopyFilesDestination, ExceptionSet, FileReference, FrameworksBuildPhase, Group, HeadersBuildPhase, Isa, LegacyTarget, LocalSwiftPackageReference, NativeTarget, PbxprojBuildError, PbxprojParseError, ProductType, ReferenceProxy, RemoteSwiftPackageReference, ResourcesBuildPhase, RezBuildPhase, RootProject, ShellScriptBuildPhase, SourcesBuildPhase, SwiftPackageProductDependency, SwiftPackageReference, SyncRootGroup, Target, TargetDependency, VariantGroup, VersionGroup, XcodeModelError, XcodeObject, XcodeProject, Xcscheme, XcschemeBuildError, XcschemeParseError, buildPbxproj, buildXcscheme, createXcscheme, generateObjectId, isXcschemeElement, parseApplePlatform, parsePbxproj, parseXcscheme, xcschemeElements };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rork-xcode",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Zero-dependency Xcode project (pbxproj) and scheme (xcscheme) parser, builder, and object model that runs identically in every JavaScript runtime",
   "keywords": [
     "apple",