rork-xcode 0.3.0 → 0.5.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",
@@ -1006,9 +1012,9 @@ function stringItems(value) {
 *
 * Views are lightweight, identity-mapped facades over entries of the
 * document's `objects` dictionary. All state lives in the parsed document
-* itself; a view holds only its id and a reference back to the project, so
-* document text produced from the model reflects every mutation with no
-* separate serialization step.
+* itself, and a view holds only its id and a reference back to the
+* project, so document text produced from the model reflects every
+* mutation with no separate serialization step.
 *
 * @module
 */
@@ -1025,12 +1031,20 @@ 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, and the project's view factory dispatches on it, so the
+	* class itself is the source of truth for which objects it covers.
+	* 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`). */
 	id;
 	/**
-	* Views are created by the project's identity map; use
+	* Views are created by the project's identity map. Use
 	* {@link XcodeProject.get} or a typed query instead of constructing
 	* views directly.
 	*/
@@ -1039,9 +1053,28 @@ var XcodeObject = class {
 		this.id = id;
 	}
 	/**
-	* The object's raw dictionary inside the document. Mutations through the
-	* model write here, and direct writes are equally valid; the model adds
-	* no caching over these properties.
+	* Whether a value is a view of this class, narrowing it when so. Views
+	* come typed out of the factory, and this is the readable way to
+	* discriminate them when iterating mixed objects.
+	*
+	* ```ts
+	* for (const [, object] of project.objects()) {
+	*   if (NativeTarget.is(object)) {
+	*     console.log(object.name);
+	*   }
+	* }
+	* ```
+	*
+	* Subclass views match their parent class too, the way `instanceof`
+	* does, so a `VersionGroup` is a `Group`.
+	*/
+	static is(value) {
+		return value instanceof this;
+	}
+	/**
+	* The object's raw dictionary inside the document. Mutations through
+	* the model write here, direct writes are equally valid, and the model
+	* adds no caching over these properties.
 	*
 	* The typed shape is asserted, not checked. It describes what a
 	* well-formed object of this kind carries (see `properties.ts`).
@@ -1116,11 +1149,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.
@@ -1192,8 +1225,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 {
 	/**
@@ -1249,7 +1292,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,
@@ -1260,10 +1303,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.
 	*/
@@ -1291,7 +1434,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;
@@ -1306,10 +1449,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.
@@ -1324,6 +1512,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.
@@ -1342,10 +1531,189 @@ var VersionGroup = class extends Group {
 	}
 };
 /**
+* An `XCBuildConfiguration` holds one named settings dictionary of a
+* 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.
+	*/
+	get name() {
+		return this.getString("name");
+	}
+	/**
+	* The configuration's settings dictionary, typed with the keys
+	* programmatic edits touch most, or `undefined` when the configuration
+	* carries none. The dictionary is live. Writes through it land in the
+	* document.
+	*/
+	get buildSettings() {
+		return asDictionary(this.properties["buildSettings"]);
+	}
+};
+/**
+* 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.
+	*/
+	get path() {
+		return this.getString("path");
+	}
+	/**
+	* The reference's display name, when it carries one distinct from the
+	* path.
+	*/
+	get name() {
+		return this.getString("name");
+	}
+};
+/**
+* A `PBXContainerItemProxy` is the indirection Xcode places between a
+* 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.
+	*/
+	get remoteInfo() {
+		return this.getString("remoteInfo");
+	}
+};
+/**
+* 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.
@@ -1358,8 +1726,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
@@ -2336,6 +2704,7 @@ const LIST_REFERENCE_PROPERTIES = [
 	"buildConfigurations",
 	"buildPhases",
 	"buildRules",
+	"buildStyles",
 	"children",
 	"dependencies",
 	"exceptions",
@@ -2462,7 +2831,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) {
@@ -2470,7 +2839,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;
 }
@@ -2516,16 +2885,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"));
@@ -2551,8 +2928,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;
 		}
 	}
@@ -2561,17 +2938,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.
@@ -2622,7 +2998,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,
@@ -2641,10 +3017,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,
@@ -2664,6 +3037,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`.
@@ -2683,8 +3057,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
@@ -2700,21 +3074,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.
@@ -2764,9 +3138,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;
@@ -2783,10 +3156,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>"
@@ -2809,10 +3179,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
@@ -2833,7 +3200,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;
 		}
@@ -2852,12 +3219,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.
 	*/
@@ -2898,6 +3268,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.
 	*/
@@ -2910,7 +3281,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.
@@ -2925,7 +3296,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
@@ -2933,7 +3304,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",
@@ -3167,10 +3538,7 @@ var XcodeProject = class XcodeProject {
 	* 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.
@@ -3199,7 +3567,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
@@ -3224,7 +3592,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;
 	}
 	/**
@@ -3356,26 +3724,61 @@ 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.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);
 	}
 };
 /**
+* Every concrete view class of the object model. The registry below is
+* derived from this list, so adding a view class with its `isa` is all
+* it takes to route objects of that kind to it.
+*/
+const VIEW_CLASSES = [
+	AggregateTarget,
+	AppleScriptBuildPhase,
+	BuildConfiguration,
+	BuildFile,
+	BuildFileExceptionSet,
+	BuildPhaseMembershipExceptionSet,
+	BuildRule,
+	BuildStyle,
+	ConfigurationList,
+	ContainerItemProxy,
+	CopyFilesBuildPhase,
+	FileReference,
+	FrameworksBuildPhase,
+	Group,
+	HeadersBuildPhase,
+	LegacyTarget,
+	LocalSwiftPackageReference,
+	NativeTarget,
+	ReferenceProxy,
+	RemoteSwiftPackageReference,
+	ResourcesBuildPhase,
+	RezBuildPhase,
+	RootProject,
+	ShellScriptBuildPhase,
+	SourcesBuildPhase,
+	SwiftPackageProductDependency,
+	SyncRootGroup,
+	TargetDependency,
+	VariantGroup,
+	VersionGroup
+];
+/**
+* View constructors by the isa they model, built from each class's own
+* `isa` declaration.
+*/
+const VIEW_BY_ISA = /* @__PURE__ */ new Map();
+for (const viewClass of VIEW_CLASSES) if (viewClass.isa != null) VIEW_BY_ISA.set(viewClass.isa, viewClass);
+/**
 * Joins two path segments with a `/`, treating an empty prefix as the
 * project root.
 */
@@ -3454,26 +3857,28 @@ function isXcschemeElement(node) {
 /**
 * Serializer for the `.xcscheme` XML dialect.
 *
-* The output reproduces Xcode's own layout byte for byte: the UTF-8
-* declaration, three-space indentation, one attribute per line with
-* spaces around the equals sign, the closing angle bracket glued to the
-* last attribute, and an explicit close tag on every element. Parsing an
-* Xcode-written scheme and building it back yields the identical file,
-* and any input reaches that canonical form in one build.
+* The output reproduces Xcode's own layout byte for byte. Xcode writes
+* the UTF-8 declaration, indents with three spaces, puts each attribute
+* on its own line with spaces around the equals sign, glues the closing
+* angle bracket to the last attribute, and closes every element with an
+* explicit close tag. Parsing an Xcode-written scheme and building it
+* back therefore yields the identical file, and any other input reaches
+* that canonical form in one build.
 *
 * @module
 */
+/** The declaration line Xcode writes at the top of every scheme file. */
 const XML_DECLARATION = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n";
 /** One indentation step of Xcode's scheme writer. */
 const INDENT = "   ";
 /**
-* Matches the names Xcode's scheme vocabulary uses; a stray non-name
-* (an empty string, spaces, XML syntax) must fail rather than produce a
+* Matches valid XML names. A stray non-name, such as an empty string or
+* one carrying spaces or XML syntax, must fail rather than produce a
 * document no parser accepts.
 */
 const NAME_PATTERN = /^[A-Za-z_:][A-Za-z0-9_:.-]*$/u;
 /**
-* Matches characters that cannot appear in an attribute value: XML 1.0
+* Matches characters that cannot appear in an attribute value. XML 1.0
 * has no representation for control characters other than tab, line
 * feed, and carriage return.
 */
@@ -3493,9 +3898,10 @@ function buildXcscheme(document) {
 	return output;
 }
 /**
-* Renders one element with Xcode's layout: attributes each on their own
-* line indented one step past the tag, `>` glued to the last attribute,
-* children indented one step, and always an explicit close tag.
+* Renders one element with Xcode's layout. Attributes go each on their
+* own line indented one step past the tag, the `>` glues to the last
+* attribute, children indent one step, and the close tag is always
+* explicit.
 */
 function renderElement(element, depth, path) {
 	if (!NAME_PATTERN.test(element.name)) throw new XcschemeBuildError(`Element name ${JSON.stringify(element.name)} is not a valid XML name`, path);
@@ -3533,10 +3939,10 @@ function renderChildren(children, depth, path) {
 	return output;
 }
 /**
-* Escapes an attribute value the way Xcode's writer does: the five named
-* entities for XML syntax characters, and character references for tab,
-* line feed, and carriage return so they survive attribute-value
-* normalization on the next parse.
+* Escapes an attribute value the way Xcode's writer does. XML syntax
+* characters become the five named entities, and tab, line feed, and
+* carriage return become character references so they survive
+* attribute-value normalization on the next parse.
 */
 function escapeAttribute(value, path, attributeName) {
 	const unencodable = UNENCODABLE_PATTERN.exec(value);
@@ -3544,152 +3950,17 @@ function escapeAttribute(value, path, attributeName) {
 	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;").replaceAll("	", "&#9;").replaceAll("\n", "&#10;").replaceAll("\r", "&#13;");
 }
 //#endregion
-//#region src/scheme/model.ts
-/**
-* Helpers over the scheme node tree: element queries and the default
-* scheme factory.
-*
-* The tree itself is plain data, so most edits are direct property
-* writes. What this module adds is the recursive query that editing
-* flows start from and a factory producing the scheme Xcode's own "New
-* Scheme" action writes for an application target.
-*
-* @module
-*/
-/**
-* Collects elements of the given name anywhere in the tree, in document
-* order, the subtree root included. Passing no name collects every
-* element.
-*
-* ```ts
-* for (const reference of xcschemeElements(scheme.root, "BuildableReference")) {
-*   reference.attributes["BlueprintName"] = "RenamedApp";
-* }
-* ```
-*/
-function xcschemeElements(root, name) {
-	const found = [];
-	const visit = (element) => {
-		if (name == null || element.name === name) found.push(element);
-		for (const child of element.children) if (isXcschemeElement(child)) visit(child);
-	};
-	visit(root);
-	return found;
-}
-/**
-* Creates the scheme Xcode writes for an application target: build,
-* launch, profile, analyze, and archive actions wired to the app product,
-* with Xcode's default configuration choices (Debug for development
-* actions, Release for profiling and archiving).
-*/
-function createXcscheme(options) {
-	const xcodeprojName = options.xcodeprojName ?? `${options.appName}.xcodeproj`;
-	/**
-	* Buildable references appear once per action; each site gets its own
-	* element so a mutation through one action cannot alias into another.
-	*/
-	const buildableReference = () => ({
-		name: "BuildableReference",
-		attributes: {
-			BuildableIdentifier: "primary",
-			BlueprintIdentifier: options.blueprintIdentifier ?? "",
-			BuildableName: `${options.appName}.app`,
-			BlueprintName: options.appName,
-			ReferencedContainer: `container:${xcodeprojName}`
-		},
-		children: []
-	});
-	return {
-		leading: [],
-		root: {
-			name: "Scheme",
-			attributes: { version: "1.7" },
-			children: [
-				{
-					name: "BuildAction",
-					attributes: {
-						parallelizeBuildables: "YES",
-						buildImplicitDependencies: "YES"
-					},
-					children: [{
-						name: "BuildActionEntries",
-						attributes: {},
-						children: [{
-							name: "BuildActionEntry",
-							attributes: {
-								buildForTesting: "YES",
-								buildForRunning: "YES",
-								buildForProfiling: "YES",
-								buildForArchiving: "YES",
-								buildForAnalyzing: "YES"
-							},
-							children: [buildableReference()]
-						}]
-					}]
-				},
-				{
-					name: "LaunchAction",
-					attributes: {
-						buildConfiguration: "Debug",
-						selectedDebuggerIdentifier: "Xcode.DebuggerFoundation.Debugger.LLDB",
-						selectedLauncherIdentifier: "Xcode.DebuggerFoundation.Launcher.LLDB",
-						launchStyle: "0",
-						useCustomWorkingDirectory: "NO",
-						ignoresPersistentStateOnLaunch: "NO",
-						debugDocumentVersioning: "YES",
-						debugServiceExtension: "internal",
-						allowLocationSimulation: "YES"
-					},
-					children: [{
-						name: "BuildableProductRunnable",
-						attributes: { runnableDebuggingMode: "0" },
-						children: [buildableReference()]
-					}]
-				},
-				{
-					name: "ProfileAction",
-					attributes: {
-						buildConfiguration: "Release",
-						shouldUseLaunchSchemeArgsEnv: "YES",
-						savedToolIdentifier: "",
-						useCustomWorkingDirectory: "NO",
-						debugDocumentVersioning: "YES"
-					},
-					children: [{
-						name: "BuildableProductRunnable",
-						attributes: { runnableDebuggingMode: "0" },
-						children: [buildableReference()]
-					}]
-				},
-				{
-					name: "AnalyzeAction",
-					attributes: { buildConfiguration: "Debug" },
-					children: []
-				},
-				{
-					name: "ArchiveAction",
-					attributes: {
-						buildConfiguration: "Release",
-						revealArchiveInOrganizer: "YES"
-					},
-					children: []
-				}
-			]
-		},
-		trailing: []
-	};
-}
-//#endregion
 //#region src/scheme/parse.ts
 /**
 * Parser for the `.xcscheme` XML dialect.
 *
-* Scheme files are XML with a narrow shape: elements with attributes and
-* child elements, no text content, no namespaces, no DOCTYPE. The parser
-* accepts that shape from any writer (attribute order, quoting style, and
-* whitespace vary across tools), resolves character and entity references
-* in attribute values, and preserves comments. Anything outside the shape
-* fails loudly with a position, in line with the pbxproj parser.
+* Scheme files are XML with a narrow shape. Elements carry attributes and
+* child elements, and there is no text content, no namespace, and no
+* DOCTYPE. The parser accepts that shape from any writer, since attribute
+* order, quoting style, and whitespace vary across tools. Character and
+* entity references in attribute values resolve to their characters, and
+* comments are preserved. Anything outside the shape fails loudly with a
+* position, in line with the pbxproj parser.
 *
 * @module
 */
@@ -3746,13 +4017,24 @@ const NAMED_ENTITIES = {
 function parseXcscheme(text) {
 	return new Parser(text).parseDocument();
 }
+/**
+* Single-pass recursive-descent parser over the source text. One instance
+* parses one document and is discarded.
+*/
 var Parser = class {
+	/** The full source text of the scheme file. */
 	input;
+	/** Cursor into {@link input}, in UTF-16 code units. */
 	pos = 0;
 	constructor(input) {
 		this.input = input;
 		if (input.charCodeAt(0) === CODE_BOM) this.pos = 1;
 	}
+	/**
+	* Parses the whole document. The XML declaration is skipped, comments
+	* around the root element are collected, and anything left after the
+	* root fails.
+	*/
 	parseDocument() {
 		this.skipWhitespace();
 		this.skipDeclaration();
@@ -3778,7 +4060,8 @@ var Parser = class {
 	}
 	/**
 	* Skips the `<?xml ... ?>` declaration when present. Its attributes are
-	* not retained: the writer always emits the canonical UTF-8 declaration.
+	* not retained, since the writer always emits the canonical UTF-8
+	* declaration.
 	*/
 	skipDeclaration() {
 		if (this.input.charCodeAt(this.pos) !== CODE_LESS_THAN || this.input.charCodeAt(this.pos + 1) !== CODE_QUESTION) return;
@@ -3786,6 +4069,12 @@ var Parser = class {
 		if (end === -1) this.fail("Unterminated XML declaration");
 		this.pos = end + 2;
 	}
+	/**
+	* Parses one element with the cursor on its opening `<`, including its
+	* attributes and children, through to the matching close tag. Xcode
+	* never writes self-closing tags, but other generators do, so both
+	* forms are accepted.
+	*/
 	parseElement() {
 		if (this.input.charCodeAt(this.pos) !== CODE_LESS_THAN) this.fail("Expected an element");
 		this.pos++;
@@ -3839,9 +4128,16 @@ var Parser = class {
 			else children.push(this.parseElement());
 		}
 	}
+	/**
+	* Whether the cursor sits on a `<!--` comment opener.
+	*/
 	peekIsCommentStart() {
 		return this.input.charCodeAt(this.pos) === CODE_LESS_THAN && this.input.charCodeAt(this.pos + 1) === CODE_BANG && this.input.charCodeAt(this.pos + 2) === CODE_HYPHEN && this.input.charCodeAt(this.pos + 3) === CODE_HYPHEN;
 	}
+	/**
+	* Parses one comment with the cursor on its `<!--` opener. The text
+	* between the markers is kept verbatim.
+	*/
 	parseComment() {
 		const end = this.input.indexOf("-->", this.pos + 4);
 		if (end === -1) this.fail("Unterminated comment");
@@ -3849,6 +4145,10 @@ var Parser = class {
 		this.pos = end + 3;
 		return { comment };
 	}
+	/**
+	* Parses an XML name at the cursor. The `what` label names the
+	* expectation in the error when no name starts here.
+	*/
 	parseName(what) {
 		const start = this.pos;
 		if (!isNameStart(this.input.charCodeAt(this.pos))) this.fail(`Expected ${what}`);
@@ -3856,6 +4156,12 @@ var Parser = class {
 		while (isNameChar(this.input.charCodeAt(this.pos))) this.pos++;
 		return this.input.slice(start, this.pos);
 	}
+	/**
+	* Parses a quoted attribute value with the cursor on the opening quote,
+	* resolving character and entity references along the way. Both quote
+	* styles are accepted, and a raw `<` inside the value fails as XML
+	* requires.
+	*/
 	parseAttributeValue() {
 		const quote = this.input.charCodeAt(this.pos);
 		if (quote !== CODE_QUOTE && quote !== CODE_APOSTROPHE) this.fail("Expected a quoted attribute value");
@@ -3912,12 +4218,275 @@ var Parser = class {
 		while (isWhitespace(this.input.charCodeAt(this.pos))) this.pos++;
 		return this.pos > start;
 	}
+	/**
+	* Throws a parse error at the cursor.
+	*/
 	fail(message) {
 		this.failAt(message, this.pos);
 	}
+	/**
+	* Throws a parse error at an explicit offset, which reference parsing
+	* uses to point at the start of a bad reference rather than its end.
+	*/
 	failAt(message, offset) {
 		throw new XcschemeParseError(message, this.input, offset);
 	}
 };
 //#endregion
-export { AggregateTarget, BuildPhase, BuildRule, CopyFilesDestination, Group, Isa, LegacyTarget, NativeTarget, PbxprojBuildError, PbxprojParseError, ProductType, ReferenceProxy, RootProject, SyncRootGroup, Target, VersionGroup, XcodeModelError, XcodeObject, XcodeProject, XcschemeBuildError, XcschemeParseError, buildPbxproj, buildXcscheme, createXcscheme, generateObjectId, isXcschemeElement, parsePbxproj, parseXcscheme, xcschemeElements };
+//#region src/scheme/model.ts
+/**
+* The scheme object model and its helpers.
+*
+* {@link Xcscheme} wraps a parsed document with the typed access editing
+* flows want, {@link BuildableReference} gives buildable references
+* property-style attribute access, {@link xcschemeElements} is the
+* recursive query underneath it all, and {@link createXcscheme} produces
+* the scheme Xcode's own "New Scheme" action writes. The node tree stays
+* the single source of truth. Views hold only a reference into it, so
+* model calls and direct tree edits compose freely.
+*
+* @module
+*/
+/**
+* Collects elements of the given name anywhere in the tree, in document
+* order, the subtree root included. Passing no name collects every
+* element.
+*/
+function xcschemeElements(root, name) {
+	const found = [];
+	const visit = (element) => {
+		if (name == null || element.name === name) found.push(element);
+		for (const child of element.children) if (isXcschemeElement(child)) visit(child);
+	};
+	visit(root);
+	return found;
+}
+/**
+* A `BuildableReference` element with property-style attribute access.
+*
+* Buildable references are the elements editing flows touch most, since
+* every action points at its target through one. The view reads and
+* writes the element's attributes directly, so it never goes stale and
+* needs no separate save step.
+*/
+var BuildableReference = class {
+	/** The underlying element inside the document tree. */
+	element;
+	constructor(element) {
+		this.element = element;
+	}
+	/**
+	* The referenced target's object id in the project document, when
+	* present. Xcode repairs a missing or stale identifier on first open.
+	*/
+	get blueprintIdentifier() {
+		return this.element.attributes["BlueprintIdentifier"];
+	}
+	set blueprintIdentifier(value) {
+		this.element.attributes["BlueprintIdentifier"] = value;
+	}
+	/**
+	* The referenced target's name, when present.
+	*/
+	get blueprintName() {
+		return this.element.attributes["BlueprintName"];
+	}
+	set blueprintName(value) {
+		this.element.attributes["BlueprintName"] = value;
+	}
+	/**
+	* The built product's file name, for example `DemoApp.app`, when
+	* present.
+	*/
+	get buildableName() {
+		return this.element.attributes["BuildableName"];
+	}
+	set buildableName(value) {
+		this.element.attributes["BuildableName"] = value;
+	}
+	/**
+	* The container the target lives in, for example
+	* `container:DemoApp.xcodeproj`, when present.
+	*/
+	get referencedContainer() {
+		return this.element.attributes["ReferencedContainer"];
+	}
+	set referencedContainer(value) {
+		this.element.attributes["ReferencedContainer"] = value;
+	}
+};
+/**
+* A scheme document with typed access to the elements editing flows
+* touch.
+*
+* The model is a thin layer over the node tree. All state lives in the
+* document itself, and {@link build} serializes whatever the tree
+* currently says, so typed edits and direct tree edits compose freely.
+*
+* ```ts
+* const scheme = Xcscheme.parse(xcschemeText);
+* for (const reference of scheme.buildableReferences()) {
+*   reference.blueprintName = "RenamedApp";
+*   reference.buildableName = "RenamedApp.app";
+* }
+* const text = scheme.build();
+* ```
+*/
+var Xcscheme = class Xcscheme {
+	/** The underlying parsed document. */
+	document;
+	constructor(document) {
+		this.document = document;
+	}
+	/**
+	* Parses the text of a `.xcscheme` file into a scheme model.
+	*
+	* @throws XcschemeParseError when the text is not a well-formed scheme
+	*   document, with the line and column of the failure.
+	*/
+	static parse(text) {
+		return new Xcscheme(parseXcscheme(text));
+	}
+	/**
+	* Creates the scheme Xcode writes for an application target. See
+	* {@link createXcscheme} for the shape it produces.
+	*/
+	static create(options) {
+		return new Xcscheme(createXcscheme(options));
+	}
+	/**
+	* The document's `Scheme` element.
+	*/
+	get root() {
+		return this.document.root;
+	}
+	/**
+	* Serializes the scheme to the text of a `.xcscheme` file in Xcode's
+	* canonical layout.
+	*/
+	build() {
+		return buildXcscheme(this.document);
+	}
+	/**
+	* Collects elements of the given name anywhere in the document, in
+	* document order. Passing no name collects every element.
+	*/
+	elements(name) {
+		return xcschemeElements(this.document.root, name);
+	}
+	/**
+	* The views of every buildable reference in the document, in document
+	* order. Build entries, testables, macro expansions, runnables, and
+	* action environment buildables all point at their target through one
+	* of these, so rename flows iterate this list.
+	*/
+	buildableReferences() {
+		return this.elements("BuildableReference").map((element) => new BuildableReference(element));
+	}
+};
+/**
+* Creates the scheme Xcode writes for an application target. The
+* document carries build, launch, profile, analyze, and archive actions
+* wired to the app product, with Xcode's default configuration choices
+* of Debug for development actions and Release for profiling and
+* archiving.
+*/
+function createXcscheme(options) {
+	const xcodeprojName = options.xcodeprojName ?? `${options.appName}.xcodeproj`;
+	/**
+	* Buildable references appear once per action. Each site gets its own
+	* element so a mutation through one action cannot alias into another.
+	*/
+	const buildableReference = () => ({
+		name: "BuildableReference",
+		attributes: {
+			BuildableIdentifier: "primary",
+			BlueprintIdentifier: options.blueprintIdentifier ?? "",
+			BuildableName: `${options.appName}.app`,
+			BlueprintName: options.appName,
+			ReferencedContainer: `container:${xcodeprojName}`
+		},
+		children: []
+	});
+	return {
+		leading: [],
+		root: {
+			name: "Scheme",
+			attributes: { version: "1.7" },
+			children: [
+				{
+					name: "BuildAction",
+					attributes: {
+						parallelizeBuildables: "YES",
+						buildImplicitDependencies: "YES"
+					},
+					children: [{
+						name: "BuildActionEntries",
+						attributes: {},
+						children: [{
+							name: "BuildActionEntry",
+							attributes: {
+								buildForTesting: "YES",
+								buildForRunning: "YES",
+								buildForProfiling: "YES",
+								buildForArchiving: "YES",
+								buildForAnalyzing: "YES"
+							},
+							children: [buildableReference()]
+						}]
+					}]
+				},
+				{
+					name: "LaunchAction",
+					attributes: {
+						buildConfiguration: "Debug",
+						selectedDebuggerIdentifier: "Xcode.DebuggerFoundation.Debugger.LLDB",
+						selectedLauncherIdentifier: "Xcode.DebuggerFoundation.Launcher.LLDB",
+						launchStyle: "0",
+						useCustomWorkingDirectory: "NO",
+						ignoresPersistentStateOnLaunch: "NO",
+						debugDocumentVersioning: "YES",
+						debugServiceExtension: "internal",
+						allowLocationSimulation: "YES"
+					},
+					children: [{
+						name: "BuildableProductRunnable",
+						attributes: { runnableDebuggingMode: "0" },
+						children: [buildableReference()]
+					}]
+				},
+				{
+					name: "ProfileAction",
+					attributes: {
+						buildConfiguration: "Release",
+						shouldUseLaunchSchemeArgsEnv: "YES",
+						savedToolIdentifier: "",
+						useCustomWorkingDirectory: "NO",
+						debugDocumentVersioning: "YES"
+					},
+					children: [{
+						name: "BuildableProductRunnable",
+						attributes: { runnableDebuggingMode: "0" },
+						children: [buildableReference()]
+					}]
+				},
+				{
+					name: "AnalyzeAction",
+					attributes: { buildConfiguration: "Debug" },
+					children: []
+				},
+				{
+					name: "ArchiveAction",
+					attributes: {
+						buildConfiguration: "Release",
+						revealArchiveInOrganizer: "YES"
+					},
+					children: []
+				}
+			]
+		},
+		trailing: []
+	};
+}
+//#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 };