rork-xcode 0.4.0 → 0.6.0

package/dist/index.js

@@ -808,20 +808,26 @@ function buildPbxproj(root) {
 */
 const Isa = {
 	aggregateTarget: "PBXAggregateTarget",
+	appleScriptBuildPhase: "PBXAppleScriptBuildPhase",
 	buildFile: "PBXBuildFile",
 	buildRule: "PBXBuildRule",
+	buildStyle: "PBXBuildStyle",
 	containerItemProxy: "PBXContainerItemProxy",
 	copyFilesBuildPhase: "PBXCopyFilesBuildPhase",
 	fileReference: "PBXFileReference",
 	fileSystemSynchronizedBuildFileExceptionSet: "PBXFileSystemSynchronizedBuildFileExceptionSet",
+	fileSystemSynchronizedGroupBuildPhaseMembershipExceptionSet: "PBXFileSystemSynchronizedGroupBuildPhaseMembershipExceptionSet",
 	fileSystemSynchronizedRootGroup: "PBXFileSystemSynchronizedRootGroup",
 	frameworksBuildPhase: "PBXFrameworksBuildPhase",
 	group: "PBXGroup",
+	headersBuildPhase: "PBXHeadersBuildPhase",
 	legacyTarget: "PBXLegacyTarget",
 	nativeTarget: "PBXNativeTarget",
 	project: "PBXProject",
 	referenceProxy: "PBXReferenceProxy",
 	resourcesBuildPhase: "PBXResourcesBuildPhase",
+	rezBuildPhase: "PBXRezBuildPhase",
+	shellScriptBuildPhase: "PBXShellScriptBuildPhase",
 	sourcesBuildPhase: "PBXSourcesBuildPhase",
 	targetDependency: "PBXTargetDependency",
 	variantGroup: "PBXVariantGroup",
@@ -1025,6 +1031,15 @@ function stringItems(value) {
 * itself always reads through the narrowing accessors.
 */
 var XcodeObject = class {
+	/**
+	* The `isa` name this view class models. Each concrete view declares
+	* its own, the factory registry routes objects of that isa to the
+	* class, and the model tests keep the registry and these declarations
+	* in agreement. Classes that only share behavior, like this base class
+	* and the abstract target and phase bases, declare `null` and never
+	* route.
+	*/
+	static isa = null;
 	/** The project this object belongs to. */
 	project;
 	/** The object's 24-character identifier (its key in `objects`). */
@@ -1135,11 +1150,11 @@ var XcodeObject = class {
 */
 /**
 * A `PBXGroup` is a folder in Xcode's navigator, holding references to
-* files and other groups. Variant groups (`PBXVariantGroup`) share this
-* view. The type parameter lets subclasses carry a more specific property
-* shape.
+* files and other groups. The type parameter lets subclasses carry a more
+* specific property shape.
 */
 var Group = class Group extends XcodeObject {
+	static isa = Isa.group;
 	/**
 	* Ids of the group's children, in navigator order. Non-string entries of
 	* a malformed document are skipped.
@@ -1211,8 +1226,18 @@ var Group = class Group extends XcodeObject {
 	}
 };
 /**
+* A `PBXVariantGroup` holds the localized variants of one file, one child
+* per language. Everything else behaves like a plain group.
+*/
+var VariantGroup = class extends Group {
+	static isa = Isa.variantGroup;
+};
+/**
 * A build phase is an ordered list of build files processed by one step
-* of a target's build. Every `PBX*BuildPhase` kind shares this view.
+* of a target's build. Every `PBX*BuildPhase` kind extends this view, and
+* kinds without a class of their own still map here through the factory's
+* suffix fallback. The type parameter lets subclasses carry a more
+* specific property shape.
 */
 var BuildPhase = class extends XcodeObject {
 	/**
@@ -1268,7 +1293,7 @@ var BuildPhase = class extends XcodeObject {
 		const referenceKey = options.referenceKey ?? "fileRef";
 		for (const buildFileId of this.buildFileIds) {
 			const existing = this.project.get(buildFileId);
-			if (existing?.getString(referenceKey) === reference.id) return existing;
+			if (BuildFile.is(existing) && existing.getString(referenceKey) === reference.id) return existing;
 		}
 		const buildFile = this.project.add(Isa.buildFile, {
 			[referenceKey]: reference.id,
@@ -1279,10 +1304,110 @@ var BuildPhase = class extends XcodeObject {
 	}
 };
 /**
+* A `PBXSourcesBuildPhase` compiles the target's source files.
+*/
+var SourcesBuildPhase = class extends BuildPhase {
+	static isa = Isa.sourcesBuildPhase;
+};
+/**
+* A `PBXFrameworksBuildPhase` links the target against frameworks,
+* libraries, and Swift package products.
+*/
+var FrameworksBuildPhase = class extends BuildPhase {
+	static isa = Isa.frameworksBuildPhase;
+};
+/**
+* A `PBXResourcesBuildPhase` copies the target's resources into the
+* built product.
+*/
+var ResourcesBuildPhase = class extends BuildPhase {
+	static isa = Isa.resourcesBuildPhase;
+};
+/**
+* A `PBXHeadersBuildPhase` installs a framework target's headers with
+* their public, private, or project visibility.
+*/
+var HeadersBuildPhase = class extends BuildPhase {
+	static isa = Isa.headersBuildPhase;
+};
+/**
+* A `PBXCopyFilesBuildPhase` copies its build files to a destination
+* inside the built product, which is how extensions and watch apps embed.
+*/
+var CopyFilesBuildPhase = class extends BuildPhase {
+	static isa = Isa.copyFilesBuildPhase;
+	/**
+	* The destination path inside the folder `dstSubfolderSpec` selects,
+	* when present.
+	*/
+	get dstPath() {
+		return this.getString("dstPath");
+	}
+};
+/**
+* A `PBXShellScriptBuildPhase` runs a script during the build.
+*/
+var ShellScriptBuildPhase = class extends BuildPhase {
+	static isa = Isa.shellScriptBuildPhase;
+	/**
+	* The script's source text, when present.
+	*/
+	get shellScript() {
+		return this.getString("shellScript");
+	}
+	/**
+	* The interpreter the script runs under, when present. Xcode's default
+	* is `/bin/sh`.
+	*/
+	get shellPath() {
+		return this.getString("shellPath");
+	}
+};
+/**
+* A `PBXRezBuildPhase` runs Rez, the classic Mac OS resource compiler,
+* over `.r` files. Xcode's UI called it "Build Carbon Resources".
+* Current Xcode no longer creates these phases, but old documents still
+* carry them.
+*/
+var RezBuildPhase = class extends BuildPhase {
+	static isa = Isa.rezBuildPhase;
+};
+/**
+* A `PBXAppleScriptBuildPhase` compiles AppleScript sources. Current
+* Xcode no longer creates these, but old documents still carry them.
+*/
+var AppleScriptBuildPhase = class extends BuildPhase {
+	static isa = Isa.appleScriptBuildPhase;
+};
+/**
+* A `PBXBuildFile` places one file reference or package product inside
+* one build phase, optionally with per-file settings.
+*/
+var BuildFile = class extends XcodeObject {
+	static isa = Isa.buildFile;
+	/**
+	* The view of the file reference the build file points at, when it
+	* points at one. Build files for Swift package products carry a
+	* `productRef` instead; see {@link productDependency}.
+	*/
+	fileReference() {
+		return this.project.get(this.getString("fileRef"));
+	}
+	/**
+	* The view of the Swift package product dependency the build file
+	* points at, when it points at one.
+	*/
+	productDependency() {
+		const view = this.project.get(this.getString("productRef"));
+		return SwiftPackageProductDependency.is(view) ? view : void 0;
+	}
+};
+/**
 * A `PBXFileSystemSynchronizedRootGroup` is an Xcode 16 folder whose
 * members are synchronized from disk instead of listed individually.
 */
 var SyncRootGroup = class extends XcodeObject {
+	static isa = Isa.fileSystemSynchronizedRootGroup;
 	/**
 	* The group's on-disk folder path, when present.
 	*/
@@ -1310,7 +1435,7 @@ var SyncRootGroup = class extends XcodeObject {
 	addMembershipExceptions(target, membershipExceptions) {
 		for (const id of stringItems(this.properties["exceptions"])) {
 			const existing = this.project.get(id);
-			if (existing?.isa === Isa.fileSystemSynchronizedBuildFileExceptionSet && existing.getString("target") === target.id) {
+			if (BuildFileExceptionSet.is(existing) && existing.getString("target") === target.id) {
 				const names = ensureArray(existing.properties, "membershipExceptions");
 				for (const name of membershipExceptions) if (!names.includes(name)) names.push(name);
 				return existing;
@@ -1325,10 +1450,55 @@ var SyncRootGroup = class extends XcodeObject {
 	}
 };
 /**
+* Behavior shared by the synchronized-folder exception set kinds, which
+* carve files out of a folder's automatic membership for one target. The
+* type parameter lets subclasses carry a more specific property shape.
+*/
+var ExceptionSet = class extends XcodeObject {
+	/**
+	* The file names the set excludes, in declaration order. Non-string
+	* entries of a malformed document are skipped.
+	*/
+	get membershipExceptions() {
+		return stringItems(this.properties["membershipExceptions"]);
+	}
+	/**
+	* The view of the target whose membership the set restricts, when the
+	* reference resolves.
+	*/
+	target() {
+		return this.project.get(this.getString("target"));
+	}
+};
+/**
+* A `PBXFileSystemSynchronizedBuildFileExceptionSet` excludes files from
+* a synchronized folder's automatic target membership.
+*/
+var BuildFileExceptionSet = class extends ExceptionSet {
+	static isa = Isa.fileSystemSynchronizedBuildFileExceptionSet;
+};
+/**
+* A `PBXFileSystemSynchronizedGroupBuildPhaseMembershipExceptionSet`
+* assigns some of a synchronized folder's files to a different build
+* phase than the automatic one.
+*/
+var BuildPhaseMembershipExceptionSet = class extends ExceptionSet {
+	static isa = Isa.fileSystemSynchronizedGroupBuildPhaseMembershipExceptionSet;
+	/**
+	* The view of the build phase the listed files belong to, when the
+	* reference resolves.
+	*/
+	buildPhase() {
+		const view = this.project.get(this.getString("buildPhase"));
+		return BuildPhase.is(view) ? view : void 0;
+	}
+};
+/**
 * A `PBXBuildRule` tells a target which compiler or script processes a
 * kind of file.
 */
 var BuildRule = class extends XcodeObject {
+	static isa = Isa.buildRule;
 	/**
 	* The rule's script, when it is a script rule rather than a reference
 	* to a compiler specification.
@@ -1343,6 +1513,7 @@ var BuildRule = class extends XcodeObject {
 * `currentVersion` names the active one.
 */
 var VersionGroup = class extends Group {
+	static isa = Isa.versionGroup;
 	/**
 	* The view of the active model version's file reference, when the group
 	* names one.
@@ -1365,6 +1536,7 @@ var VersionGroup = class extends Group {
 * target or of the project, for example Debug or Release.
 */
 var BuildConfiguration = class extends XcodeObject {
+	static isa = Isa.buildConfiguration;
 	/**
 	* The configuration's name, when present.
 	*/
@@ -1382,10 +1554,33 @@ var BuildConfiguration = class extends XcodeObject {
 	}
 };
 /**
+* A `PBXBuildStyle` is the pre-Xcode-2 predecessor of
+* `XCBuildConfiguration`. Current Xcode neither creates nor reads them,
+* but old documents still carry them.
+*/
+var BuildStyle = class extends XcodeObject {
+	static isa = Isa.buildStyle;
+	/**
+	* The style's name, when present.
+	*/
+	get name() {
+		return this.getString("name");
+	}
+	/**
+	* The style's settings dictionary, or `undefined` when the style
+	* carries none. The dictionary is live. Writes through it land in the
+	* document.
+	*/
+	get buildSettings() {
+		return asDictionary(this.properties["buildSettings"]);
+	}
+};
+/**
 * A `PBXFileReference` names one file on disk, from source files to the
 * built products themselves.
 */
 var FileReference = class extends XcodeObject {
+	static isa = Isa.fileReference;
 	/**
 	* The reference's path, relative to its `sourceTree`, when present.
 	*/
@@ -1405,6 +1600,7 @@ var FileReference = class extends XcodeObject {
 * target dependency and the target it points at.
 */
 var ContainerItemProxy = class extends XcodeObject {
+	static isa = Isa.containerItemProxy;
 	/**
 	* The display name of the object the proxy points at, when present.
 	* For target dependencies this is the target's name.
@@ -1414,10 +1610,111 @@ var ContainerItemProxy = class extends XcodeObject {
 	}
 };
 /**
+* A `PBXTargetDependency` records that one target must build before
+* another, through a container item proxy naming the prerequisite.
+*/
+var TargetDependency = class extends XcodeObject {
+	static isa = Isa.targetDependency;
+	/**
+	* The view of the target this dependency points at, when the reference
+	* resolves to one inside this document.
+	*/
+	target() {
+		return this.project.get(this.getString("target"));
+	}
+	/**
+	* The view of the dependency's container item proxy, when the reference
+	* resolves.
+	*/
+	targetProxy() {
+		const view = this.project.get(this.getString("targetProxy"));
+		return ContainerItemProxy.is(view) ? view : void 0;
+	}
+};
+/**
+* An `XCConfigurationList` owns the named build configurations of one
+* target or of the project, plus the default configuration choice.
+*/
+var ConfigurationList = class extends XcodeObject {
+	static isa = Isa.configurationList;
+	/**
+	* The name of the configuration builds use when none is specified, when
+	* present.
+	*/
+	get defaultConfigurationName() {
+		return this.getString("defaultConfigurationName");
+	}
+	/**
+	* The views of the list's build configurations, in list order. Dangling
+	* ids and objects of other kinds are skipped.
+	*/
+	configurations() {
+		const configurations = [];
+		for (const id of stringItems(this.properties["buildConfigurations"])) {
+			const view = this.project.get(id);
+			if (BuildConfiguration.is(view)) configurations.push(view);
+		}
+		return configurations;
+	}
+};
+/**
+* Behavior shared by the Swift package reference kinds. The type
+* parameter lets subclasses carry a more specific property shape.
+*/
+var SwiftPackageReference = class extends XcodeObject {};
+/**
+* An `XCRemoteSwiftPackageReference` names a package repository and a
+* version requirement.
+*/
+var RemoteSwiftPackageReference = class extends SwiftPackageReference {
+	static isa = Isa.remoteSwiftPackageReference;
+	/**
+	* The package's repository URL, when present.
+	*/
+	get repositoryURL() {
+		return this.getString("repositoryURL");
+	}
+};
+/**
+* An `XCLocalSwiftPackageReference` names a package directory relative
+* to the project.
+*/
+var LocalSwiftPackageReference = class extends SwiftPackageReference {
+	static isa = Isa.localSwiftPackageReference;
+	/**
+	* The package's path relative to the project, when present.
+	*/
+	get relativePath() {
+		return this.getString("relativePath");
+	}
+};
+/**
+* An `XCSwiftPackageProductDependency` links one product of a Swift
+* package to the target that consumes it.
+*/
+var SwiftPackageProductDependency = class extends XcodeObject {
+	static isa = Isa.swiftPackageProductDependency;
+	/**
+	* The product's name as the package manifest declares it, when present.
+	*/
+	get productName() {
+		return this.getString("productName");
+	}
+	/**
+	* The view of the package reference the product comes from, when the
+	* reference resolves. Products of local packages can omit it.
+	*/
+	packageReference() {
+		const view = this.project.get(this.getString("package"));
+		return SwiftPackageReference.is(view) ? view : void 0;
+	}
+};
+/**
 * A `PBXReferenceProxy` stands in for a product built by a target of
 * another project referenced from this one.
 */
 var ReferenceProxy = class extends XcodeObject {
+	static isa = Isa.referenceProxy;
 	/**
 	* The proxy's product path inside the other project's build directory,
 	* when present.
@@ -1430,8 +1727,8 @@ var ReferenceProxy = class extends XcodeObject {
 	* when the reference resolves.
 	*/
 	remoteReference() {
-		const id = this.getString("remoteRef");
-		return id == null ? void 0 : this.project.get(id);
+		const view = this.project.get(this.getString("remoteRef"));
+		return ContainerItemProxy.is(view) ? view : void 0;
 	}
 };
 //#endregion
@@ -2408,6 +2705,7 @@ const LIST_REFERENCE_PROPERTIES = [
 	"buildConfigurations",
 	"buildPhases",
 	"buildRules",
+	"buildStyles",
 	"children",
 	"dependencies",
 	"exceptions",
@@ -2534,7 +2832,7 @@ function pruneOrphanObjects(project) {
 */
 /**
 * The views of a configuration list's build configurations, in list order.
-* Dangling ids and non-dictionary entries of malformed documents are
+* Dangling ids and objects of other kinds in malformed documents are
 * skipped.
 */
 function configurationsOf(project, configurationListId) {
@@ -2542,7 +2840,7 @@ function configurationsOf(project, configurationListId) {
 	const configurations = [];
 	for (const id of stringItems(list?.["buildConfigurations"])) {
 		const configuration = project.get(id);
-		if (configuration != null) configurations.push(configuration);
+		if (BuildConfiguration.is(configuration)) configurations.push(configuration);
 	}
 	return configurations;
 }
@@ -2588,16 +2886,24 @@ var Target = class extends XcodeObject {
 		return this.getString("name");
 	}
 	/**
+	* The view of the target's configuration list, when the reference
+	* resolves.
+	*/
+	configurationList() {
+		const view = this.project.get(this.getString("buildConfigurationList"));
+		return ConfigurationList.is(view) ? view : void 0;
+	}
+	/**
 	* The views of the target's build configurations, in list order.
 	*/
 	buildConfigurations() {
 		return configurationsOf(this.project, this.getString("buildConfigurationList"));
 	}
 	/**
-	* The settings dictionary of the target's default configuration: the one
-	* named by the list's `defaultConfigurationName`, falling back to the
-	* first configuration. Returns `undefined` when the target has no
-	* configurations or the default carries no settings dictionary.
+	* The settings dictionary of the target's default configuration, which
+	* is the one named by the list's `defaultConfigurationName`, falling
+	* back to the first configuration. Returns `undefined` when the target
+	* has no configurations or the default carries no settings dictionary.
 	*/
 	defaultConfigurationSettings() {
 		return defaultConfigurationSettingsOf(this.project, this.getString("buildConfigurationList"));
@@ -2623,8 +2929,8 @@ var Target = class extends XcodeObject {
 	*/
 	setBuildSetting(key, value) {
 		for (const configuration of this.buildConfigurations()) {
-			const settings = asDictionary(configuration.properties["buildSettings"]);
-			if (settings == null) configuration.properties["buildSettings"] = { [key]: value };
+			const settings = configuration.buildSettings;
+			if (settings == null) configuration.properties.buildSettings = { [key]: value };
 			else settings[key] = value;
 		}
 	}
@@ -2633,17 +2939,16 @@ var Target = class extends XcodeObject {
 	*/
 	removeBuildSetting(key) {
 		for (const configuration of this.buildConfigurations()) {
-			const settings = asDictionary(configuration.properties["buildSettings"]);
+			const settings = configuration.buildSettings;
 			if (settings != null) delete settings[key];
 		}
 	}
 	/**
-	* The views of the target's dependency objects
-	* (`PBXTargetDependency`), in declaration order. Resolve a dependency's
-	* target through its `target` property.
+	* The views of the target's dependencies, in declaration order. Resolve
+	* a dependency's target through {@link TargetDependency.target}.
 	*/
 	dependencies() {
-		return this.referencedViews("dependencies");
+		return this.referencedViews("dependencies").filter((view) => TargetDependency.is(view));
 	}
 	/**
 	* The views of the target's build phases, in build order.
@@ -2658,7 +2963,9 @@ var Target = class extends XcodeObject {
 	}
 	/**
 	* Finds the target's first build phase with the given isa, and, when
-	* `name` is provided, the given display name.
+	* `name` is provided, the given display name. An isa literal of the
+	* vocabulary types the result, so `findBuildPhase(Isa.copyFilesBuildPhase)`
+	* gives a `CopyFilesBuildPhase | undefined`.
 	*/
 	findBuildPhase(isa, name) {
 		return this.buildPhases().find((phase) => phase.isa === isa && (name == null || phase.name === name));
@@ -2666,7 +2973,8 @@ var Target = class extends XcodeObject {
 	/**
 	* Returns the target's build phase with the given isa and properties,
 	* creating and appending it when missing. The properties apply only on
-	* creation; an existing phase is returned as is.
+	* creation. An existing phase is returned as is, already typed as the
+	* phase class the isa names.
 	*
 	* The match key is the isa plus the `name` property when one is given,
 	* so differently named copy-files phases coexist.
@@ -2694,7 +3002,7 @@ var Target = class extends XcodeObject {
 	* @param properties Phase properties, most usefully `shellScript`.
 	*/
 	ensureShellScriptPhase(name, properties = {}) {
-		return this.ensureBuildPhase("PBXShellScriptBuildPhase", {
+		return this.ensureBuildPhase(Isa.shellScriptBuildPhase, {
 			inputFileListPaths: [],
 			inputPaths: [],
 			name,
@@ -2713,10 +3021,7 @@ var Target = class extends XcodeObject {
 	* @returns The view of the target dependency object.
 	*/
 	addDependency(dependency) {
-		for (const id of stringItems(this.properties["dependencies"])) {
-			const existing = this.project.get(id);
-			if (existing?.getString("target") === dependency.id) return existing;
-		}
+		for (const dependencyView of this.dependencies()) if (dependencyView.getString("target") === dependency.id) return dependencyView;
 		const proxy = this.project.add(Isa.containerItemProxy, {
 			containerPortal: this.project.rootProject.id,
 			proxyType: 1,
@@ -2736,6 +3041,7 @@ var Target = class extends XcodeObject {
 * itself, such as an application or an app extension.
 */
 var NativeTarget = class extends Target {
+	static isa = Isa.nativeTarget;
 	/**
 	* The target's product type identifier, for example
 	* `com.apple.product-type.application`.
@@ -2755,8 +3061,8 @@ var NativeTarget = class extends Target {
 	* one.
 	*/
 	get productReference() {
-		const id = this.getString("productReference");
-		return id == null ? void 0 : this.project.get(id);
+		const view = this.project.get(this.getString("productReference"));
+		return FileReference.is(view) ? view : void 0;
 	}
 	/**
 	* Whether the target builds for watchOS, decided by its product type or
@@ -2772,21 +3078,21 @@ var NativeTarget = class extends Target {
 	* declaration order.
 	*/
 	packageProductDependencies() {
-		return this.referencedViews("packageProductDependencies");
+		return this.referencedViews("packageProductDependencies").filter((view) => SwiftPackageProductDependency.is(view));
 	}
 	/**
 	* The views of the target's file-system-synchronized folders, in
 	* declaration order.
 	*/
 	syncGroups() {
-		return this.referencedViews("fileSystemSynchronizedGroups").filter((view) => view instanceof SyncRootGroup);
+		return this.referencedViews("fileSystemSynchronizedGroups").filter((view) => SyncRootGroup.is(view));
 	}
 	/**
 	* The views of the target's build rules, in evaluation order. Empty for
 	* targets without custom rules, which is nearly all of them.
 	*/
 	buildRules() {
-		return this.referencedViews("buildRules").filter((view) => view instanceof BuildRule);
+		return this.referencedViews("buildRules").filter((view) => BuildRule.is(view));
 	}
 	/**
 	* The target's sources phase, created when missing.
@@ -2836,9 +3142,8 @@ var NativeTarget = class extends Target {
 	*/
 	syncGroupPaths() {
 		const paths = [];
-		for (const id of stringItems(this.properties["fileSystemSynchronizedGroups"])) {
-			const group = this.project.get(id);
-			const path = group instanceof SyncRootGroup ? group.path : void 0;
+		for (const group of this.syncGroups()) {
+			const path = group.path;
 			if (path != null) paths.push(path);
 		}
 		return paths;
@@ -2855,10 +3160,7 @@ var NativeTarget = class extends Target {
 	* @returns The view of the target's synchronized folder for the path.
 	*/
 	addSyncGroup(path) {
-		for (const id of stringItems(this.properties["fileSystemSynchronizedGroups"])) {
-			const existing = this.project.get(id);
-			if (existing instanceof SyncRootGroup && existing.path === path) return existing;
-		}
+		for (const existing of this.syncGroups()) if (existing.path === path) return existing;
 		const group = this.project.add(Isa.fileSystemSynchronizedRootGroup, {
 			path,
 			sourceTree: "<group>"
@@ -2881,10 +3183,7 @@ var NativeTarget = class extends Target {
 	* @returns The view of the product dependency.
 	*/
 	addSwiftPackageProduct(options) {
-		for (const id of stringItems(this.properties["packageProductDependencies"])) {
-			const existing = this.project.get(id);
-			if (existing?.getString("productName") === options.productName && existing.getString("package") === options.packageReference.id) return existing;
-		}
+		for (const existing of this.packageProductDependencies()) if (existing.productName === options.productName && existing.getString("package") === options.packageReference.id) return existing;
 		const productDependency = this.project.add(Isa.swiftPackageProductDependency, {
 			package: options.packageReference.id,
 			productName: options.productName
@@ -2905,7 +3204,7 @@ var NativeTarget = class extends Target {
 	addSystemFramework(name) {
 		const path = `System/Library/Frameworks/${name}.framework`;
 		let reference;
-		for (const [, view] of this.project.objects()) if (view.isa === Isa.fileReference && view.getString("path") === path) {
+		for (const [, view] of this.project.objects()) if (FileReference.is(view) && view.path === path) {
 			reference = view;
 			break;
 		}
@@ -2924,12 +3223,15 @@ var NativeTarget = class extends Target {
 * targets through its dependencies and to run script or copy-files
 * phases, and the shared target surface covers everything it carries.
 */
-var AggregateTarget = class extends Target {};
+var AggregateTarget = class extends Target {
+	static isa = Isa.aggregateTarget;
+};
 /**
 * A legacy target shells out to an external build tool such as make
 * instead of using Xcode's build system.
 */
 var LegacyTarget = class extends Target {
+	static isa = Isa.legacyTarget;
 	/**
 	* The build tool the target invokes, as an absolute path.
 	*/
@@ -2970,6 +3272,7 @@ var LegacyTarget = class extends Target {
 * the main group, and the project-level configurations.
 */
 var RootProject = class extends XcodeObject {
+	static isa = Isa.project;
 	/**
 	* Ids of the project's targets, in project order.
 	*/
@@ -2982,7 +3285,7 @@ var RootProject = class extends XcodeObject {
 	*/
 	mainGroup() {
 		const group = this.project.get(this.getString("mainGroup"));
-		return group instanceof Group ? group : void 0;
+		return Group.is(group) ? group : void 0;
 	}
 	/**
 	* The settings dictionary of the project-level default configuration.
@@ -2997,7 +3300,7 @@ var RootProject = class extends XcodeObject {
 	* in declaration order.
 	*/
 	packageReferences() {
-		return this.referencedViews("packageReferences");
+		return this.referencedViews("packageReferences").filter((view) => SwiftPackageReference.is(view));
 	}
 	/**
 	* The group product references live in, creating it (and registering it
@@ -3005,7 +3308,7 @@ var RootProject = class extends XcodeObject {
 	*/
 	ensureProductsGroup() {
 		const existing = this.project.get(this.getString("productRefGroup"));
-		if (existing instanceof Group) return existing;
+		if (Group.is(existing)) return existing;
 		const group = this.project.add(Isa.group, {
 			children: [],
 			name: "Products",
@@ -3120,13 +3423,16 @@ var XcodeProject = class XcodeProject {
 		return generateObjectId(seed, new Set(Object.keys(this.objectsDictionary)));
 	}
 	/**
-	* Adds an object to the document and returns its view.
+	* Adds an object to the document and returns its view. When the isa is
+	* a literal of the vocabulary, the returned view is already the exact
+	* class for it, so `add(Isa.fileReference, ...)` gives a `FileReference`
+	* with no cast at the call site.
 	*
-	* @param isa The object's kind; written as the `isa` property.
+	* @param isa The object's kind, written as the `isa` property.
 	* @param properties The object's remaining properties. The dictionary is
 	*   stored as passed (not copied), with `isa` written first so the
 	*   serialized entry leads with it.
-	* @param seed Seed for the deterministic id; defaults to the isa, which
+	* @param seed Seed for the deterministic id. Defaults to the isa, which
 	*   is only sensible for singleton objects.
 	* @returns The view of the created object.
 	*/
@@ -3229,20 +3535,16 @@ var XcodeProject = class XcodeProject {
 			productType: options.productType
 		}, `${Isa.nativeTarget} ${options.name}`);
 		ensureArray(this.rootProject.properties, "targets").push(target.id);
-		const nativeTarget = target;
-		nativeTarget.ensureSourcesPhase();
-		nativeTarget.ensureFrameworksPhase();
-		nativeTarget.ensureResourcesPhase();
-		return nativeTarget;
+		target.ensureSourcesPhase();
+		target.ensureFrameworksPhase();
+		target.ensureResourcesPhase();
+		return target;
 	}
 	/**
 	* Finds the remote Swift package reference for a repository URL.
 	*/
 	findSwiftPackage(repositoryUrl) {
-		for (const id of stringItems(this.rootProject.properties["packageReferences"])) {
-			const reference = this.get(id);
-			if (reference?.getString("repositoryURL") === repositoryUrl) return reference;
-		}
+		return this.rootProject.packageReferences().filter((reference) => RemoteSwiftPackageReference.is(reference)).find((reference) => reference.repositoryURL === repositoryUrl);
 	}
 	/**
 	* Adds a remote Swift package reference and registers it on the project.
@@ -3271,7 +3573,7 @@ var XcodeProject = class XcodeProject {
 	* Finds the local Swift package reference for a directory path.
 	*/
 	findLocalSwiftPackage(relativePath) {
-		return this.rootProject.packageReferences().find((reference) => reference.isa === Isa.localSwiftPackageReference && reference.getString("relativePath") === relativePath);
+		return this.rootProject.packageReferences().filter((reference) => LocalSwiftPackageReference.is(reference)).find((reference) => reference.relativePath === relativePath);
 	}
 	/**
 	* Adds a local (path-based) Swift package reference and registers it on
@@ -3296,7 +3598,7 @@ var XcodeProject = class XcodeProject {
 	*/
 	buildFilesReferencing(reference) {
 		const buildFiles = [];
-		for (const [, view] of this.objects()) if (view.isa === Isa.buildFile && (view.getString("fileRef") === reference.id || view.getString("productRef") === reference.id)) buildFiles.push(view);
+		for (const [, view] of this.objects()) if (BuildFile.is(view) && (view.getString("fileRef") === reference.id || view.getString("productRef") === reference.id)) buildFiles.push(view);
 		return buildFiles;
 	}
 	/**
@@ -3428,29 +3730,62 @@ var XcodeProject = class XcodeProject {
 		return search(mainGroup, "");
 	}
 	/**
-	* Creates the typed view for an object, dispatching on its isa. Objects
-	* outside the typed vocabulary get the generic base view.
+	* Creates the typed view for an object, dispatching on the isa each
+	* view class declares. Unknown `PBX*BuildPhase` kinds still map to
+	* {@link BuildPhase}, and everything else outside the vocabulary gets
+	* the generic base view.
 	*/
 	createView(id, isa) {
-		switch (isa) {
-			case Isa.nativeTarget: return new NativeTarget(this, id);
-			case Isa.aggregateTarget: return new AggregateTarget(this, id);
-			case Isa.legacyTarget: return new LegacyTarget(this, id);
-			case Isa.project: return new RootProject(this, id);
-			case Isa.group:
-			case Isa.variantGroup: return new Group(this, id);
-			case Isa.versionGroup: return new VersionGroup(this, id);
-			case Isa.fileSystemSynchronizedRootGroup: return new SyncRootGroup(this, id);
-			case Isa.buildRule: return new BuildRule(this, id);
-			case Isa.buildConfiguration: return new BuildConfiguration(this, id);
-			case Isa.fileReference: return new FileReference(this, id);
-			case Isa.containerItemProxy: return new ContainerItemProxy(this, id);
-			case Isa.referenceProxy: return new ReferenceProxy(this, id);
-			default: return isa.endsWith("BuildPhase") ? new BuildPhase(this, id) : new XcodeObject(this, id);
-		}
+		const View = VIEW_BY_ISA.get(isa);
+		if (View != null) return new View(this, id);
+		return isa.endsWith("BuildPhase") ? new BuildPhase(this, id) : new XcodeObject(this, id);
 	}
 };
 /**
+* The view class for every isa of the vocabulary. The runtime registry
+* and the {@link ViewByIsa} type are both derived from this one object,
+* so the class an object routes to and the class its isa literal promises
+* are always the same. The `satisfies` clause keeps the object covering
+* the whole vocabulary, and the model tests check that every entry agrees
+* with its class's own `isa` declaration.
+*/
+const VIEWS = {
+	[Isa.aggregateTarget]: AggregateTarget,
+	[Isa.appleScriptBuildPhase]: AppleScriptBuildPhase,
+	[Isa.buildConfiguration]: BuildConfiguration,
+	[Isa.buildFile]: BuildFile,
+	[Isa.buildRule]: BuildRule,
+	[Isa.buildStyle]: BuildStyle,
+	[Isa.configurationList]: ConfigurationList,
+	[Isa.containerItemProxy]: ContainerItemProxy,
+	[Isa.copyFilesBuildPhase]: CopyFilesBuildPhase,
+	[Isa.fileReference]: FileReference,
+	[Isa.fileSystemSynchronizedBuildFileExceptionSet]: BuildFileExceptionSet,
+	[Isa.fileSystemSynchronizedGroupBuildPhaseMembershipExceptionSet]: BuildPhaseMembershipExceptionSet,
+	[Isa.fileSystemSynchronizedRootGroup]: SyncRootGroup,
+	[Isa.frameworksBuildPhase]: FrameworksBuildPhase,
+	[Isa.group]: Group,
+	[Isa.headersBuildPhase]: HeadersBuildPhase,
+	[Isa.legacyTarget]: LegacyTarget,
+	[Isa.localSwiftPackageReference]: LocalSwiftPackageReference,
+	[Isa.nativeTarget]: NativeTarget,
+	[Isa.project]: RootProject,
+	[Isa.referenceProxy]: ReferenceProxy,
+	[Isa.remoteSwiftPackageReference]: RemoteSwiftPackageReference,
+	[Isa.resourcesBuildPhase]: ResourcesBuildPhase,
+	[Isa.rezBuildPhase]: RezBuildPhase,
+	[Isa.shellScriptBuildPhase]: ShellScriptBuildPhase,
+	[Isa.sourcesBuildPhase]: SourcesBuildPhase,
+	[Isa.swiftPackageProductDependency]: SwiftPackageProductDependency,
+	[Isa.targetDependency]: TargetDependency,
+	[Isa.variantGroup]: VariantGroup,
+	[Isa.versionGroup]: VersionGroup
+};
+/**
+* View constructors by the isa they model, in `Map` form for the factory.
+*/
+const VIEW_BY_ISA = new Map(Object.entries(VIEWS));
+/**
 * Joins two path segments with a `/`, treating an empty prefix as the
 * project root.
 */
@@ -4161,4 +4496,4 @@ function createXcscheme(options) {
 	};
 }
 //#endregion
-export { AggregateTarget, BuildConfiguration, BuildPhase, BuildRule, BuildableReference, ContainerItemProxy, CopyFilesDestination, FileReference, Group, Isa, LegacyTarget, NativeTarget, PbxprojBuildError, PbxprojParseError, ProductType, ReferenceProxy, RootProject, SyncRootGroup, Target, 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, parsePbxproj, parseXcscheme, xcschemeElements };