rork-xcode 0.8.0 → 0.10.0

package/dist/index.js

@@ -52,8 +52,8 @@ function repoNameFromUrl(repoUrl) {
 * Builds the uuid-to-comment map for a parsed project document.
 *
 * Objects that should render without a comment (unnamed groups) map to the
-* empty string; uuids absent from the map are not references at all.
-* Derivation is linear over the object graph: reverse indexes are built in
+* empty string, and uuids absent from the map are not references at all.
+* Derivation is linear over the object graph. Reverse indexes are built in
 * one pass, and every object's comment is computed once and cached.
 */
 function createReferenceComments(root) {
@@ -100,9 +100,9 @@ function createReferenceComments(root) {
 	};
 	/**
 	* Comment for a `PBXFileSystemSynchronizedBuildFileExceptionSet`,
-	* matching current Xcode: `Exceptions for "clip" folder in "clip"
-	* target`. Falls back to the isa when the folder or target cannot be
-	* resolved (older documents and hand-edited graphs).
+	* matching current Xcode, for example `Exceptions for "clip" folder in
+	* "clip" target`. Falls back to the isa when the folder or target cannot
+	* be resolved (older documents and hand-edited graphs).
 	*/
 	const buildFileExceptionSetComment = (id, set) => {
 		const folder = exceptionSetFolderName(id);
@@ -114,9 +114,9 @@ function createReferenceComments(root) {
 	};
 	/**
 	* Comment for a `PBXFileSystemSynchronizedGroupBuildPhaseMembershipExceptionSet`,
-	* matching current Xcode: `Exceptions for "Tophat" folder in "CopyFiles"
-	* phase from "Tophat" target`. Falls back to the isa when any of the
-	* three names cannot be resolved.
+	* matching current Xcode, for example `Exceptions for "Tophat" folder in
+	* "CopyFiles" phase from "Tophat" target`. Falls back to the isa when
+	* any of the three names cannot be resolved.
 	*/
 	const membershipExceptionSetComment = (id, set) => {
 		const folder = exceptionSetFolderName(id);
@@ -246,7 +246,7 @@ var PbxprojParseError = class extends Error {
 	/** Where in the source text parsing failed. */
 	position;
 	/**
-	* @param message Failure description without location; the location is
+	* @param message Failure description without location. The location is
 	*   appended automatically.
 	* @param source Full source text, used to compute the position.
 	* @param offset Character offset of the failure inside `source`.
@@ -270,7 +270,7 @@ var XcschemeParseError = class extends Error {
 	/** Where in the source text parsing failed. */
 	position;
 	/**
-	* @param message Failure description without location; the location is
+	* @param message Failure description without location. The location is
 	*   appended automatically.
 	* @param source Full source text, used to compute the position.
 	* @param offset Character offset of the failure inside `source`.
@@ -283,6 +283,30 @@ var XcschemeParseError = class extends Error {
 	}
 };
 /**
+* Thrown when the source text is not a well-formed build configuration
+* file (the line-based format of `.xcconfig` files).
+*
+* The message always embeds the line and column of the failure, and the
+* same information is available in structured form on {@link position}
+* for programmatic use.
+*/
+var XcconfigParseError = class extends Error {
+	/** Where in the source text parsing failed. */
+	position;
+	/**
+	* @param message Failure description without location. The location is
+	*   appended automatically.
+	* @param source Full source text, used to compute the position.
+	* @param offset Character offset of the failure inside `source`.
+	*/
+	constructor(message, source, offset) {
+		const position = positionAt(source, offset);
+		super(`${message} (line ${position.line}, column ${position.column})`);
+		this.name = "XcconfigParseError";
+		this.position = position;
+	}
+};
+/**
 * Thrown when a scheme element cannot be written as XML.
 *
 * Raised for element and attribute names that are not valid XML names and
@@ -293,7 +317,7 @@ var XcschemeBuildError = class extends Error {
 	/** Path to the offending element from the root, e.g. `Scheme.BuildAction[0]`. */
 	path;
 	/**
-	* @param message Failure description without location; the element path
+	* @param message Failure description without location. The element path
 	*   is appended automatically.
 	* @param path Path to the offending element from the root.
 	*/
@@ -304,7 +328,7 @@ var XcschemeBuildError = class extends Error {
 	}
 };
 /**
-* Thrown by the object model when an operation cannot proceed: the
+* Thrown by the object model when an operation cannot proceed, because the
 * document lacks the structure the operation needs (no objects dictionary,
 * no root project object), a view's object was removed from the document,
 * or a creation request names a product type the model cannot scaffold.
@@ -336,7 +360,7 @@ var PbxprojBuildError = class extends Error {
 	/** Path to the offending value from the root, e.g. `$.objects.13B07F86.name`. */
 	path;
 	/**
-	* @param message Failure description without location; the value path is
+	* @param message Failure description without location. The value path is
 	*   appended automatically.
 	* @param path Path to the offending value from the root, `$`.
 	*/
@@ -363,8 +387,8 @@ var PbxprojBuildError = class extends Error {
 */
 const UNQUOTED_SAFE_PATTERN = /^[A-Za-z0-9_$/:.]+$/u;
 /**
-* Whether the value can render without quotes: every character is in the
-* unquoted-safe alphabet and the string is not empty.
+* Whether the value can render without quotes, meaning every character is
+* in the unquoted-safe alphabet and the string is not empty.
 *
 * Quoting decisions scan every string a document carries, and many of those
 * strings are substring slices of the source text. The regex engine flattens
@@ -376,7 +400,7 @@ function isSafeUnquoted(value) {
 }
 /**
 * Whether the string contains characters that require escape sequences
-* inside a quoted string: control characters, `"`, `\`, or DEL.
+* inside a quoted string, meaning control characters, `"`, `\`, or DEL.
 */
 function needsEscaping(value) {
 	for (let i = 0; i < value.length; i++) {
@@ -386,8 +410,8 @@ function needsEscaping(value) {
 	return false;
 }
 /**
-* Escapes special characters for a quoted string: the named C-style escapes
-* plus `\Uxxxx` for remaining control characters.
+* Escapes special characters for a quoted string, using the named C-style
+* escapes plus `\Uxxxx` for remaining control characters.
 */
 function escapeString(value) {
 	let result = "";
@@ -439,7 +463,7 @@ function ensureQuotes(value) {
 	return `"${escapeString(value)}"`;
 }
 /**
-* Renders binary data as an uppercase hex run: `<DEADBEEF>`.
+* Renders binary data as an uppercase hex run, for example `<DEADBEEF>`.
 */
 function formatData(data) {
 	let hex = "";
@@ -461,7 +485,7 @@ function formatData(data) {
 * - reference comments (`13B07F86… /* AppDelegate.swift in Sources *​/`)
 *   derived from the object graph.
 *
-* Numbers render exactly as JavaScript formats them; the version-like
+* Numbers render exactly as JavaScript formats them. The version-like
 * settings Xcode writes with a trailing zero (`SWIFT_VERSION = 5.0`) arrive
 * from the parser as strings and round-trip verbatim, so no reformatting
 * heuristic is needed or applied.
@@ -517,25 +541,25 @@ function indentString(depth) {
 /**
 * Serialization state for one {@link buildPbxproj} call.
 *
-* The `write*` methods append directly to the output string; the `render*`
-* methods return fragments for the caller to place. Output accumulates by
-* appending, because engines represent growing strings as ropes: appends
-* stay cheap where template interpolation would allocate an intermediate
-* string per line.
+* The `write*` methods append directly to the output string, and the
+* `render*` methods return fragments for the caller to place. Output
+* accumulates by appending, because engines represent growing strings as
+* ropes. Appends stay cheap where template interpolation would allocate
+* an intermediate string per line.
 */
 var Writer = class {
 	/** The document text accumulated so far. */
 	out = "";
-	/** Current nesting depth; one tab per level. */
+	/** Current nesting depth, one tab per level. */
 	indent = 0;
 	/** Display comment per referenced uuid, derived once from the object graph. */
 	comments;
 	/**
-	* Rendered string values by input string: `id /* comment *​/` for
-	* referenced uuids, quoted text for everything else. Referenced objects
-	* render at least twice (their section entry plus each referencing site)
-	* and build settings repeat across configurations, so most renders are
-	* cache hits. The map lives for one build call only.
+	* Rendered string values keyed by input string. Referenced uuids render
+	* as `id /* comment *​/` and everything else as quoted text. Referenced
+	* objects render at least twice (their section entry plus each
+	* referencing site) and build settings repeat across configurations, so
+	* most renders are cache hits. The map lives for one build call only.
 	*/
 	renderedReferences = /* @__PURE__ */ new Map();
 	/**
@@ -544,7 +568,7 @@ var Writer = class {
 	*/
 	quotedKeys = /* @__PURE__ */ new Map();
 	/**
-	* Serializes the whole document eagerly; read it back with
+	* Serializes the whole document eagerly. Read it back with
 	* {@link toString}.
 	*
 	* @param root The document root dictionary.
@@ -582,7 +606,7 @@ var Writer = class {
 	*
 	* Most calls hit the cache, and the writers call this for every key and
 	* reference, so the method body stays small enough for the engine to
-	* inline; the miss path lives in {@link renderReferenceUncached}.
+	* inline. The miss path lives in {@link renderReferenceUncached}.
 	*/
 	renderReference(id) {
 		const cached = this.renderedReferences.get(id);
@@ -623,8 +647,8 @@ var Writer = class {
 	* Renders a string value in its key's context.
 	*
 	* `remoteGlobalIDString` and `TestTargetID` hold uuids of objects in
-	* another container; annotating them with this container's comments would
-	* be wrong, so they render bare.
+	* another container. Annotating them with this container's comments
+	* would be wrong, so they render bare.
 	*/
 	renderStringValue(key, value) {
 		if (key === "remoteGlobalIDString" || key === "TestTargetID") return ensureQuotes(value);
@@ -634,7 +658,7 @@ var Writer = class {
 	* Appends the entries of a dictionary, one `key = value;` line each.
 	*
 	* Value paths (`$.objects.AA….name`) exist for error messages and are
-	* only constructed in the branches that recurse or throw; the flat string
+	* only constructed in the branches that recurse or throw. The flat string
 	* and number lines that dominate documents skip the concatenation.
 	*
 	* @param object The dictionary whose entries to write.
@@ -773,18 +797,18 @@ var Writer = class {
 /**
 * Serializes a project document to `project.pbxproj` text.
 *
-* The input is the same shape {@link parsePbxproj} produces; see the module
-* documentation of `types.ts` for the value model. Output is stable: two
+* The input is the same shape {@link parsePbxproj} produces. See the module
+* documentation of `types.ts` for the value model. Output is stable, so two
 * calls with semantically equal documents produce identical text, and the
 * layout matches what Xcode itself writes so diffs stay minimal.
 *
 * @param root The document root. Real project documents carry `objects`,
 *   `rootObject`, and the version fields, but any dictionary serializes.
 * @returns The document text, terminated by a newline.
-* @throws PbxprojBuildError when a value has no pbxproj representation:
-*   `null`, `undefined`, booleans, bigints, functions, symbols, class
-*   instances, or non-finite numbers. The error names the path of the
-*   offending value.
+* @throws PbxprojBuildError when a value has no pbxproj representation,
+*   meaning `null`, `undefined`, booleans, bigints, functions, symbols,
+*   class instances, or non-finite numbers. The error names the path of
+*   the offending value.
 */
 function buildPbxproj(root) {
 	if (!isDictionary(root)) throw new PbxprojBuildError("The document root must be a dictionary", "$");
@@ -795,15 +819,15 @@ function buildPbxproj(root) {
 /**
 * Names and well-known values of the pbxproj object vocabulary.
 *
-* Everything here mirrors strings Xcode itself writes; nothing is invented.
-* Centralizing them keeps the object model free of string literals and
-* gives call sites one place to import from.
+* Everything here mirrors strings Xcode itself writes, and nothing is
+* invented. Centralizing them keeps the object model free of string
+* literals and gives call sites one place to import from.
 *
 * @module
 */
 /**
 * The `isa` names the object model works with. The parser and serializer
-* accept any isa; this list only covers the kinds the model creates or
+* accept any isa, and this list only covers the kinds the model creates or
 * gives typed access to.
 */
 const Isa = {
@@ -935,7 +959,7 @@ const CopyFilesDestination = {
 };
 /**
 * Resolves the embed phase destination for an extension-like product type.
-* Watch applications are embedded by product type here; callers that only
+* Watch applications are embedded by product type here. Callers that only
 * know build settings should check the deployment-target key instead.
 */
 function embedDestinationFor(productType) {
@@ -1023,7 +1047,7 @@ function ensureArray(object, key) {
 * Collects the string items of a possibly absent, possibly mixed array.
 *
 * Reference lists in well-formed documents contain only id strings, but a
-* malformed document can mix in anything; non-strings are skipped rather
+* malformed document can mix in anything. Non-strings are skipped rather
 * than thrown on, matching the library's soft-failure stance on reads.
 */
 function stringItems(value) {
@@ -1155,8 +1179,8 @@ var XcodeObject = class {
 	* nested dictionaries keyed by object id (such as the root project's
 	* `TargetAttributes`) drop its entry.
 	*
-	* This is the low-level removal; it does not cascade to objects that only
-	* made sense alongside this one. Higher-level operations like
+	* This is the low-level removal, so it does not cascade to objects that
+	* only made sense alongside this one. Higher-level operations like
 	* {@link XcodeProject.removeTarget} compose it into full teardowns.
 	*/
 	removeFromProject() {
@@ -1169,9 +1193,9 @@ var XcodeObject = class {
 * Typed views over the document object kinds that are not targets, from
 * groups and build phases to version groups and reference proxies.
 *
-* Each class adds the accessors and mutations its kind supports; everything
-* ultimately reads and writes the raw dictionaries through the base class,
-* so mixing model calls with direct property access stays safe.
+* Each class adds the accessors and mutations its kind supports.
+* Everything ultimately reads and writes the raw dictionaries through the
+* base class, so mixing model calls with direct property access stays safe.
 *
 * @module
 */
@@ -1233,7 +1257,7 @@ var Group = class Group extends XcodeObject {
 	* it to the group's children.
 	*
 	* The reference's `lastKnownFileType` derives from the file extension
-	* when it is a known kind; otherwise the reference carries no type and
+	* when it is a known kind. Otherwise the reference carries no type and
 	* Xcode re-derives one on open.
 	*
 	* @param path File path relative to the group, for example
@@ -1269,8 +1293,8 @@ var VariantGroup = class extends Group {
 var BuildPhase = class extends XcodeObject {
 	/**
 	* The phase's display name, when it carries an explicit one. Xcode names
-	* copy-files and shell-script phases; the standard phases derive their
-	* names from their isa.
+	* copy-files and shell-script phases, while the standard phases derive
+	* their names from their isa.
 	*/
 	get name() {
 		return this.getString("name");
@@ -1310,7 +1334,7 @@ var BuildPhase = class extends XcodeObject {
 	* @param reference The file reference or package product the build file
 	*   should point at.
 	* @param options.referenceKey Which build-file field carries the
-	*   reference: `fileRef` for file references (the default) or
+	*   reference, either `fileRef` for file references (the default) or
 	*   `productRef` for Swift package products.
 	* @param options.settings Optional per-file settings, for example
 	*   `{ ATTRIBUTES: ["RemoveHeadersOnCopy"] }`.
@@ -1423,7 +1447,7 @@ var BuildFile = class extends XcodeObject {
 	/**
 	* 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}.
+	* `productRef` instead, resolved through {@link productDependency}.
 	*/
 	fileReference() {
 		return this.project.get(this.getString("fileRef"));
@@ -1456,12 +1480,12 @@ var SyncRootGroup = class extends XcodeObject {
 	*
 	* Xcode keeps one exception set per target and folder, so when this
 	* group already carries a set for the target, the file names merge into
-	* it instead of creating a second set; names already excluded are not
-	* duplicated.
+	* it instead of creating a second set, and names already excluded are
+	* not duplicated.
 	*
 	* The standard use is keeping a scaffolded `Info.plist` from being
-	* double-copied: the build already processes it through the target's
-	* `INFOPLIST_FILE` setting.
+	* double-copied, since the build already processes it through the
+	* target's `INFOPLIST_FILE` setting.
 	*
 	* @param target The target whose membership the exceptions restrict.
 	* @param membershipExceptions File names inside the folder to exclude.
@@ -1587,6 +1611,16 @@ var BuildConfiguration = class extends XcodeObject {
 	get buildSettings() {
 		return asDictionary(this.properties["buildSettings"]);
 	}
+	/**
+	* The view of the `.xcconfig` file reference this configuration is
+	* based on, when the configuration has one and it resolves. The file's
+	* settings sit below the configuration's own `buildSettings` in
+	* Xcode's resolution order.
+	*/
+	baseConfigurationReference() {
+		const view = this.project.get(this.getString("baseConfigurationReference"));
+		return FileReference.is(view) ? view : void 0;
+	}
 };
 /**
 * A `PBXBuildStyle` is the pre-Xcode-2 predecessor of
@@ -1782,9 +1816,10 @@ var ReferenceProxy = class extends XcodeObject {
 * NeXTSTEP character set for byte values 0x80-0xFF, indexed by `byte - 0x80`.
 *
 * Octal escapes are how pre-Unicode NeXTSTEP text encoded non-ASCII
-* characters; mapping them through this table is what makes `\341` decode to
-* `Æ` instead of the Latin-1 `á`. Values are Unicode code points, per the
-* published NEXTSTEP.TXT vendor mapping in the Unicode Character Database.
+* characters, and mapping them through this table is what makes `\341`
+* decode to `Æ` instead of the Latin-1 `á`. Values are Unicode code
+* points, per the published NEXTSTEP.TXT vendor mapping in the Unicode
+* Character Database.
 */
 const NEXT_STEP_MAPPINGS = [
 	160,
@@ -1919,8 +1954,8 @@ const NEXT_STEP_MAPPINGS = [
 /**
 * Maps an octal escape value to its Unicode code point.
 *
-* Values below 0x80 are ASCII and pass through; values in 0x80-0xFF select
-* from the NeXTSTEP character set.
+* Values below 0x80 are ASCII and pass through, while values in 0x80-0xFF
+* select from the NeXTSTEP character set.
 */
 function nextStepToUnicode(code) {
 	if (code < 128 || code > 255) return code;
@@ -2029,7 +2064,8 @@ function unescapeString(input) {
 * @module
 */
 /**
-* Characters allowed in unquoted string literals: `[A-Za-z0-9_$/:.-]`.
+* The characters allowed in unquoted string literals are
+* `[A-Za-z0-9_$/:.-]`.
 *
 * A 256-entry lookup table keyed by code unit keeps classification to a
 * single array read in the hot loop. Non-ASCII units index past the table
@@ -2090,7 +2126,7 @@ function isDigit(code) {
 * Scanner state and grammar productions for one parse call.
 *
 * The parser holds a single cursor into the source string and advances it
-* through the `read*` and `parse*` methods; there is no separate tokenizer
+* through the `read*` and `parse*` methods. There is no separate tokenizer
 * stage and no token objects.
 */
 var Parser$1 = class {
@@ -2101,7 +2137,7 @@ var Parser$1 = class {
 	/**
 	* Offset of an unterminated block comment the trivia scanner consumed, or
 	* -1. Recording it instead of throwing keeps the trivia scanner free of
-	* failure branches; see {@link fail}.
+	* failure branches, and {@link fail} reports it.
 	*/
 	unterminatedCommentAt = -1;
 	/**
@@ -2115,13 +2151,13 @@ var Parser$1 = class {
 	* failure.
 	*
 	* An unterminated block comment swallows the rest of the input, so any
-	* failure raised after one (always some end-of-input error) is a symptom;
-	* the comment itself is reported instead. Content after the root value is
-	* never scanned, so a trailing unterminated comment still parses, as
-	* Apple's parser accepts it too.
+	* failure raised after one (always some end-of-input error) is a symptom
+	* and the comment itself is reported instead. Content after the root
+	* value is never scanned, so a trailing unterminated comment still
+	* parses, as Apple's parser accepts it too.
 	*
 	* @param message Failure description without location.
-	* @param offset Offset of the failure; defaults to the current cursor.
+	* @param offset Offset of the failure, defaulting to the current cursor.
 	*/
 	fail(message, offset = this.pos) {
 		if (this.unterminatedCommentAt !== -1) throw new PbxprojParseError("Unterminated block comment", this.input, this.unterminatedCommentAt);
@@ -2217,11 +2253,11 @@ var Parser$1 = class {
 		return input.slice(start, pos);
 	}
 	/**
-	* Reads a quoted string; the opening quote is at the current position.
+	* Reads a quoted string whose opening quote is at the current position.
 	*
-	* The scan tracks whether any escape sequence occurred: unescaped strings
-	* (the overwhelming majority) return as a direct slice, and only escaped
-	* ones pay for {@link unescapeString}.
+	* The scan tracks whether any escape sequence occurred, so unescaped
+	* strings (the overwhelming majority) return as a direct slice, and only
+	* escaped ones pay for {@link unescapeString}.
 	*/
 	readQuotedString() {
 		const input = this.input;
@@ -2270,7 +2306,7 @@ var Parser$1 = class {
 		return bytes;
 	}
 	/**
-	* Parses the document root: a dictionary or an array.
+	* Parses the document root, which is a dictionary or an array.
 	*/
 	parseDocument() {
 		const code = this.peek();
@@ -2280,7 +2316,7 @@ var Parser$1 = class {
 		this.fail(`Expected '{' or '(' at the start of the document but found '${this.input[this.pos]}'`);
 	}
 	/**
-	* Parses a `{ key = value; ... }` dictionary; the `{` is at the current
+	* Parses a `{ key = value; ... }` dictionary whose `{` is at the current
 	* position. Keys may be quoted or unquoted, and every entry requires the
 	* `=` and terminating `;`.
 	*/
@@ -2314,9 +2350,9 @@ var Parser$1 = class {
 		}
 	}
 	/**
-	* Parses a `( item, item, ... )` array; the `(` is at the current
-	* position. A trailing comma before `)` is allowed; Xcode writes one
-	* after every item.
+	* Parses a `( item, item, ... )` array whose `(` is at the current
+	* position. A trailing comma before `)` is allowed, because Xcode writes
+	* one after every item.
 	*/
 	parseArray() {
 		const input = this.input;
@@ -2363,12 +2399,12 @@ var Parser$1 = class {
 /**
 * Decides whether an unquoted literal is a number or a string.
 *
-* One loop with an early exit: the first character outside `[0-9.]` (after
-* an optional leading `-`) settles the token as a string, so the
-* 24-character identifiers that dominate project documents are classified
-* within their first few characters.
+* The decision is one loop with an early exit. The first character outside
+* `[0-9.]` (after an optional leading `-`) settles the token as a string,
+* so the 24-character identifiers that dominate project documents are
+* classified within their first few characters.
 *
-* Numeric-looking candidates convert under a single print-back rule: the
+* Numeric-looking candidates convert under a single print-back rule. The
 * literal becomes a number exactly when the number formats back to the
 * identical text. Any literal the conversion would reshape stays a string,
 * so a parse and build cycle cannot change a single byte of any scalar.
@@ -2406,13 +2442,34 @@ function interpretLiteral(literal) {
 * @param text Source text of the document.
 * @returns The document's root value. For real project files this is the
 *   root dictionary with `objects`, `rootObject`, and version fields.
-* @throws PbxprojParseError when the document is malformed; the error
+* @throws PbxprojParseError when the document is malformed. The error
 *   carries the line and column of the failure.
 */
 function parsePbxproj(text) {
 	return new Parser$1(text).parseDocument();
 }
 //#endregion
+//#region src/rename.ts
+/**
+* The stem-matching rule shared by the rename flows. The project model
+* renames product file references and host paths with it, and the scheme
+* model renames buildable names with it, so both sides agree on what
+* counts as the renamed target's file.
+*
+* @module
+*/
+/**
+* Renames a file name whose stem is the target name, keeping the
+* extension. `SampleApp` and `SampleApp.app` rename, and so does a
+* multi-part extension like `SampleApp.app.dSYM`. A name whose stem
+* merely starts with the old name, like `SampleAppTests.xctest`, is a
+* different target's product and returns `undefined`.
+*/
+function renameFileNameStem(fileName, oldName, newName) {
+	if (fileName === oldName) return newName;
+	if (fileName.startsWith(`${oldName}.`)) return newName + fileName.slice(oldName.length);
+}
+//#endregion
 //#region src/md5.ts
 /**
 * Embedded MD5, implemented from RFC 1321.
@@ -2420,8 +2477,8 @@ function parsePbxproj(text) {
 * Deterministic object ids hash their seed text (see `uuid.ts`), and the
 * library runs in every JavaScript runtime without depending on a crypto
 * module, so the digest is implemented here. MD5 is used strictly as a
-* stable text-to-bits mapping for identifier generation; nothing security
-* relevant derives from it.
+* stable text-to-bits mapping for identifier generation, and nothing
+* security relevant derives from it.
 *
 * @module
 */
@@ -2496,7 +2553,7 @@ const SHIFTS = [
 	21
 ];
 /**
-* Step constants for the 64 steps: the integer parts of
+* Step constants for the 64 steps, which are the integer parts of
 * `abs(sin(i + 1)) * 2^32`, as RFC 1321 section 3.4 tabulates them. The
 * values are fixed by the specification rather than derived through
 * `Math.sin` at load, because the digest feeds deterministic identifiers
@@ -2570,9 +2627,9 @@ const SINES = new Uint32Array([
 	3951481745
 ]);
 /**
-* Encodes text as UTF-8 bytes with RFC 1321 padding applied: a `0x80`
-* terminator, zero fill to 56 bytes mod 64, then the bit length as a
-* little-endian 64-bit integer.
+* Encodes text as UTF-8 bytes with RFC 1321 padding applied, meaning a
+* `0x80` terminator, zero fill to 56 bytes mod 64, then the bit length as
+* a little-endian 64-bit integer.
 */
 function paddedUtf8(text) {
 	const bytes = new TextEncoder().encode(text);
@@ -2590,8 +2647,8 @@ function paddedUtf8(text) {
 /**
 * Adds two 32-bit values with wraparound, keeping intermediates inside the
 * 32-bit range JavaScript bitwise operators preserve. `Math.trunc` is not
-* a substitute here: the bitwise coercion is what performs the modular
-* wrap the algorithm requires.
+* a substitute here, because the bitwise coercion is what performs the
+* modular wrap the algorithm requires.
 */
 function add32(a, b) {
 	return a + b | 0;
@@ -2663,7 +2720,7 @@ function md5Hex(text) {
 * Deterministic object identifiers for generated pbxproj objects.
 *
 * Xcode identifies every object with 24 hexadecimal characters. Generated
-* ids here are deterministic: the same seed always produces the same id, so
+* ids here are deterministic. The same seed always produces the same id, so
 * programmatic edits are reproducible and diffs stay minimal across runs.
 * The format is `XX` + the first 20 characters of `md5(seed)` + `XX`, which
 * is a valid identifier that remains recognizable as generated.
@@ -2880,16 +2937,23 @@ function configurationsOf(project, configurationListId) {
 	return configurations;
 }
 /**
-* The settings dictionary of a configuration list's default configuration:
-* the one named by `defaultConfigurationName`, falling back to the first
-* configuration. Returns `undefined` when the list has no configurations
-* or the default carries no settings dictionary.
+* The view of a configuration list's default configuration, which is the
+* one named by `defaultConfigurationName`, falling back to the first
+* configuration. Returns `undefined` when the list has no configurations.
 */
-function defaultConfigurationSettingsOf(project, configurationListId) {
+function defaultConfigurationOf(project, configurationListId) {
 	const list = asDictionary(project.propertiesOfOptional(configurationListId));
 	const configurations = configurationsOf(project, configurationListId);
 	const defaultName = asString(list?.["defaultConfigurationName"]);
-	return asDictionary((configurations.find((configuration) => configuration.getString("name") === defaultName) ?? configurations[0])?.properties["buildSettings"]);
+	return configurations.find((configuration) => configuration.getString("name") === defaultName) ?? configurations[0];
+}
+/**
+* The settings dictionary of a configuration list's default configuration
+* (see {@link defaultConfigurationOf}). Returns `undefined` when the list
+* has no configurations or the default carries no settings dictionary.
+*/
+function defaultConfigurationSettingsOf(project, configurationListId) {
+	return asDictionary(defaultConfigurationOf(project, configurationListId)?.properties["buildSettings"]);
 }
 //#endregion
 //#region src/model/target.ts
@@ -2899,7 +2963,7 @@ function defaultConfigurationSettingsOf(project, configurationListId) {
 * extends it with products, embedding, synchronized folders, Swift
 * packages, and system frameworks.
 *
-* Reads are deliberately soft: user-generated projects can be malformed,
+* Reads are deliberately soft. User-generated projects can be malformed,
 * so lookups return `undefined` instead of throwing wherever a document
 * could legally or illegally omit something. Mutations create any missing
 * structure they need.
@@ -2950,13 +3014,24 @@ var Target = class extends XcodeObject {
 	* generated app templates set values like `SDKROOT` only at the project
 	* level.
 	*
-	* Only string values are returned; a list- or number-valued setting reads
-	* as `undefined`.
+	* Configurations based on `.xcconfig` files take part once the files
+	* are registered through {@link XcodeProject.registerXcconfig}, in
+	* Xcode's order of target settings, then the target's xcconfig, then
+	* project settings, then the project's xcconfig.
+	*
+	* Only string values are returned, so a list- or number-valued setting
+	* reads as `undefined`.
 	*/
 	getBuildSetting(key) {
-		const targetSettings = this.defaultConfigurationSettings();
+		const targetConfiguration = defaultConfigurationOf(this.project, this.getString("buildConfigurationList"));
+		const targetSettings = asDictionary(targetConfiguration?.properties["buildSettings"]);
 		if (targetSettings != null && key in targetSettings) return asString(targetSettings[key]);
-		return asString(this.project.rootProject.defaultConfigurationSettings()?.[key]);
+		const targetXcconfig = targetConfiguration == null ? void 0 : this.project.xcconfigSettingsOf(targetConfiguration);
+		if (targetXcconfig != null && key in targetXcconfig) return targetXcconfig[key];
+		const projectConfiguration = defaultConfigurationOf(this.project, this.project.rootProject.getString("buildConfigurationList"));
+		const projectSettings = asDictionary(projectConfiguration?.properties["buildSettings"]);
+		if (projectSettings != null && key in projectSettings) return asString(projectSettings[key]);
+		return (projectConfiguration == null ? void 0 : this.project.xcconfigSettingsOf(projectConfiguration))?.[key];
 	}
 	/**
 	* Writes a build setting on every configuration of the target, so Debug
@@ -3320,7 +3395,7 @@ var LegacyTarget = class extends Target {
 * `project.pbxproj`.
 *
 * The model is a set of lightweight views over the plain parsed document.
-* All state lives in the document itself; views hold only an id and a
+* All state lives in the document itself. Views hold only an id and a
 * project reference, so model mutations and direct dictionary writes
 * compose freely and {@link XcodeProject.build} always serializes the
 * current state. New objects receive deterministic identifiers (see
@@ -3350,7 +3425,7 @@ var RootProject = class extends XcodeObject {
 	}
 	/**
 	* The settings dictionary of the project-level default configuration.
-	* Targets inherit from these settings; see
+	* Targets inherit from these settings, as described on
 	* {@link NativeTarget.getBuildSetting}.
 	*/
 	defaultConfigurationSettings() {
@@ -3400,6 +3475,12 @@ var XcodeProject = class XcodeProject {
 	* access, so views of the same object compare with `===`.
 	*/
 	views = /* @__PURE__ */ new Map();
+	/**
+	* Flattened settings of registered `.xcconfig` files, keyed by the id
+	* of the file reference configurations name in
+	* `baseConfigurationReference`.
+	*/
+	xcconfigSettings = /* @__PURE__ */ new Map();
 	constructor(document) {
 		const objects = asDictionary(document["objects"]);
 		if (objects == null) throw new XcodeModelError("The document has no objects dictionary");
@@ -3419,7 +3500,7 @@ var XcodeProject = class XcodeProject {
 	}
 	/**
 	* Wraps an already parsed document in a model. The document is used in
-	* place, not copied; model mutations write into it.
+	* place rather than copied, so model mutations write into it.
 	*/
 	static fromDocument(document) {
 		return new XcodeProject(document);
@@ -3434,7 +3515,7 @@ var XcodeProject = class XcodeProject {
 	/**
 	* The raw properties dictionary of an object.
 	*
-	* @throws XcodeModelError when no object with the id exists; views use
+	* @throws XcodeModelError when no object with the id exists. Views use
 	*   this accessor, so a view of a deleted object fails loudly instead of
 	*   resurrecting the entry.
 	*/
@@ -3477,8 +3558,8 @@ var XcodeProject = class XcodeProject {
 	}
 	/**
 	* Generates a deterministic 24-character id from a seed, avoiding every
-	* id the document currently contains. The id is not reserved; adding an
-	* object with it (see {@link add}) is what claims it.
+	* id the document currently contains. The id is not reserved, and only
+	* adding an object with it (see {@link add}) claims it.
 	*/
 	generateId(seed) {
 		return generateObjectId(seed, new Set(Object.keys(this.objectsDictionary)));
@@ -3508,6 +3589,27 @@ var XcodeProject = class XcodeProject {
 		return view;
 	}
 	/**
+	* Registers the contents of a `.xcconfig` file so build-setting reads
+	* can layer it below the configurations that are based on it. The
+	* library never touches the filesystem, so the caller loads the file
+	* and hands it over together with the file reference that
+	* configurations name in `baseConfigurationReference`. Included files
+	* take part through {@link XcconfigSettingsOptions.resolveInclude};
+	* the settings are flattened once, at registration.
+	*/
+	registerXcconfig(reference, config, options = {}) {
+		this.xcconfigSettings.set(reference.id, config.settings(options));
+	}
+	/**
+	* The flattened settings registered for the `.xcconfig` file a
+	* configuration is based on, or `undefined` when the configuration
+	* names none or the file was not registered.
+	*/
+	xcconfigSettingsOf(configuration) {
+		const referenceId = configuration.getString("baseConfigurationReference");
+		return referenceId == null ? void 0 : this.xcconfigSettings.get(referenceId);
+	}
+	/**
 	* The view of the document's root `PBXProject` object.
 	*
 	* @throws XcodeModelError when `rootObject` is missing or dangling,
@@ -3564,7 +3666,8 @@ var XcodeProject = class XcodeProject {
 	* and Resources build phases, and registers it on the project.
 	*
 	* @throws XcodeModelError for product types the model cannot create a
-	*   product reference for; see {@link AddNativeTargetOptions.productType}.
+	*   product reference for, listed on
+	*   {@link AddNativeTargetOptions.productType}.
 	*/
 	addNativeTarget(options) {
 		const productInfo = PRODUCT_FILE_INFO[options.productType];
@@ -3610,7 +3713,7 @@ var XcodeProject = class XcodeProject {
 	/**
 	* Adds a remote Swift package reference and registers it on the project.
 	* When the project already references the repository, the existing
-	* reference is returned unchanged, requirement included; adjust an
+	* reference is returned unchanged, requirement included. Adjust an
 	* existing requirement through the reference's properties. Link products
 	* to targets with {@link NativeTarget.addSwiftPackageProduct}.
 	*
@@ -3685,7 +3788,7 @@ var XcodeProject = class XcodeProject {
 	* list containing it, or a nested dictionary carrying it as a key or
 	* string value.
 	*
-	* The scan is linear over the document; removal flows call it once per
+	* The scan is linear over the document. Removal flows call it once per
 	* removed object, which keeps teardown proportional to what is actually
 	* removed.
 	*/
@@ -3701,7 +3804,7 @@ var XcodeProject = class XcodeProject {
 	* (such as `TargetAttributes`) drop its entry.
 	*
 	* Removing an id the document does not contain is a no-op. This is the
-	* low-level removal; {@link removeTarget} composes it into a full
+	* low-level removal, and {@link removeTarget} composes it into a full
 	* teardown.
 	*/
 	removeObject(id) {
@@ -3719,7 +3822,7 @@ var XcodeProject = class XcodeProject {
 	* dependencies on others), its membership exception sets, and
 	* synchronized folders no remaining target links.
 	*
-	* On-disk sources are untouched; the removal is document-only, like
+	* On-disk sources are untouched. The removal is document-only, like
 	* deleting a target in Xcode and keeping its folder.
 	*
 	* @throws XcodeModelError when the target belongs to another project,
@@ -3762,12 +3865,58 @@ var XcodeProject = class XcodeProject {
 		for (const groupId of syncGroupIds) if (!this.nativeTargets().some((remaining) => stringItems(remaining.properties["fileSystemSynchronizedGroups"]).includes(groupId))) this.removeObject(groupId);
 	}
 	/**
+	* Renames a target and every place the document knows it by name. That
+	* covers the target's `name` and `productName`, its product file
+	* reference (`OldName.app` becomes `NewName.app`, whatever the
+	* extension), the `remoteInfo` of container item proxies pointing at
+	* the target, `TEST_TARGET_NAME` settings naming it, and the path
+	* segments of `TEST_HOST` and `BUNDLE_LOADER` settings that name the
+	* target or its product. A `PRODUCT_NAME` of the target's own
+	* configurations is rewritten only when it spells the old name
+	* literally. The usual `$(TARGET_NAME)` follows by itself.
+	*
+	* Scheme files live outside the pbxproj, so buildable references are
+	* renamed separately through `Xcscheme.renameTarget`. On-disk renames
+	* (source folders, entitlements files) and the group paths pointing at
+	* those folders stay with the caller. Sibling targets such as
+	* `OldNameTests` are renamed with their own calls.
+	*
+	* @throws XcodeModelError when the target belongs to another project.
+	*/
+	renameTarget(target, newName) {
+		if (target.project !== this) throw new XcodeModelError("Cannot rename a target that belongs to another project");
+		const oldName = target.name;
+		if (oldName === newName) return;
+		target.set("name", newName);
+		if (oldName == null) return;
+		if (target.getString("productName") === oldName) target.set("productName", newName);
+		const product = this.get(target.getString("productReference"));
+		if (product != null) for (const key of ["path", "name"]) {
+			const fileName = product.getString(key);
+			const renamed = fileName == null ? void 0 : renameFileNameStem(fileName, oldName, newName);
+			if (renamed != null) product.set(key, renamed);
+		}
+		for (const configuration of target.buildConfigurations()) {
+			const settings = configuration.buildSettings;
+			if (settings?.PRODUCT_NAME === oldName) settings.PRODUCT_NAME = newName;
+		}
+		for (const [, view] of this.objects()) {
+			if (ContainerItemProxy.is(view) && view.getString("remoteGlobalIDString") === target.id && view.remoteInfo === oldName) view.set("remoteInfo", newName);
+			if (BuildConfiguration.is(view)) {
+				const settings = view.buildSettings;
+				if (settings == null) continue;
+				if (settings.TEST_TARGET_NAME === oldName) settings.TEST_TARGET_NAME = newName;
+				renameHostPathSettings(settings, oldName, newName);
+			}
+		}
+	}
+	/**
 	* Finds a file reference by its project-relative path, resolving each
 	* reference's location through the group tree from the main group
 	* (nested group `path` components join with `/`).
 	*
 	* Members of file-system-synchronized folders are not listed in the
-	* document and therefore cannot be found; check
+	* document and therefore cannot be found. Check
 	* {@link NativeTarget.syncGroupPaths} for folder-level containment
 	* instead.
 	*/
@@ -3854,6 +4003,31 @@ function joinPath(prefix, segment) {
 	return prefix === "" ? segment : `${prefix}/${segment}`;
 }
 /**
+* Renames the segments of a path-valued build setting that name the
+* target or one of its products. Settings like `TEST_HOST` embed the
+* product path as
+* `$(BUILT_PRODUCTS_DIR)/SampleApp.app/.../SampleApp`, so each segment
+* is matched whole against the target name. Substring occurrences inside
+* unrelated segments stay untouched.
+*/
+function renamePathSegments(value, oldName, newName) {
+	return value.split("/").map((segment) => renameFileNameStem(segment, oldName, newName) ?? segment).join("/");
+}
+/**
+* Renames the target name inside the host-path settings of one
+* configuration. `TEST_HOST` and `BUNDLE_LOADER` carry the hosting
+* product's path, so their segments rename the way the product file
+* reference does.
+*/
+function renameHostPathSettings(settings, oldName, newName) {
+	for (const key of ["TEST_HOST", "BUNDLE_LOADER"]) {
+		const value = asString(settings[key]);
+		if (value == null) continue;
+		const rewritten = renamePathSegments(value, oldName, newName);
+		if (rewritten !== value) settings[key] = rewritten;
+	}
+}
+/**
 * Whether a value references the id anywhere in its structure. A
 * reference is a string equal to it, an array containing it at any depth,
 * or a dictionary carrying it as a key or somewhere in its values.
@@ -3899,7 +4073,7 @@ function stripValue(value, id) {
 	return value;
 }
 /**
-* Strips every reference to the id from an object's properties; see
+* Strips every reference to the id from an object's properties. See
 * {@link stripValue} for the shapes handled. String properties naming the
 * id are deleted rather than left empty.
 */
@@ -4451,6 +4625,46 @@ var Xcscheme = class Xcscheme {
 	buildableReferences() {
 		return this.elements("BuildableReference").map((element) => new BuildableReference(element));
 	}
+	/**
+	* Renames every buildable reference pointing at a target. The blueprint
+	* name is matched whole, and the buildable name is matched by its stem,
+	* so `OldApp.app` becomes `NewApp.app` while `OldAppTests.xctest`, a
+	* different target's product, stays untouched. This is the scheme-file
+	* side of `XcodeProject.renameTarget`. Returns whether anything
+	* changed, so callers can skip rewriting untouched files.
+	*/
+	renameTarget(oldName, newName) {
+		if (oldName === newName) return false;
+		let changed = false;
+		for (const reference of this.buildableReferences()) {
+			if (reference.blueprintName === oldName) {
+				reference.blueprintName = newName;
+				changed = true;
+			}
+			const buildableName = reference.buildableName;
+			const renamed = buildableName == null ? void 0 : renameFileNameStem(buildableName, oldName, newName);
+			if (renamed != null) {
+				reference.buildableName = renamed;
+				changed = true;
+			}
+		}
+		return changed;
+	}
+	/**
+	* Rewrites every buildable reference's container after the
+	* `.xcodeproj` directory itself is renamed, so `container:Old.xcodeproj`
+	* becomes `container:New.xcodeproj`. The project names are matched
+	* exactly. Returns whether anything changed.
+	*/
+	renameContainer(oldProjectName, newProjectName) {
+		if (oldProjectName === newProjectName) return false;
+		let changed = false;
+		for (const reference of this.buildableReferences()) if (reference.referencedContainer === `container:${oldProjectName}.xcodeproj`) {
+			reference.referencedContainer = `container:${newProjectName}.xcodeproj`;
+			changed = true;
+		}
+		return changed;
+	}
 };
 /**
 * Creates the scheme Xcode writes for an application target. The
@@ -4557,4 +4771,328 @@ 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, parseApplePlatform, parsePbxproj, parseXcscheme, xcschemeElements };
+//#region src/xcconfig/build.ts
+/**
+* Serializes a document back to `.xcconfig` text.
+*/
+function buildXcconfig(document) {
+	let text = "";
+	for (const statement of document.statements) text += statement.raw + statement.eol;
+	return text;
+}
+//#endregion
+//#region src/xcconfig/parse.ts
+/**
+* Parser for Xcode build configuration files (`.xcconfig`).
+*
+* The grammar is line based. A line is blank, a `//` comment, an
+* `#include "path"` directive, or a `KEY[conditions] = value` assignment.
+* `//` starts a comment anywhere on a line, including inside values, which
+* matches Xcode's reading of the format. Every parsed statement keeps its
+* exact source text, so an untouched document rebuilds byte for byte.
+*
+* @module
+*/
+/**
+* Matches `#include "path"` and `#include? "path"`, with an optional
+* trailing comment.
+*/
+const INCLUDE_PATTERN = /^#include(\?)?\s*"([^"]*)"\s*(?:\/\/.*)?$/u;
+/**
+* Matches the head of an assignment, which is the leading whitespace, the
+* setting name, and the raw conditions block up to the equals sign.
+*/
+const ASSIGNMENT_HEAD_PATTERN = /^\s*([A-Za-z_][A-Za-z0-9_]*)\s*((?:\[[^\]]*\])*)\s*=/u;
+/**
+* Matches one `[name=value]` condition group inside the conditions block.
+*/
+const CONDITION_PATTERN = /\[([^=\]]+)=([^\]]*)\]/gu;
+/**
+* Strips the trailing comment, surrounding whitespace, and one trailing
+* semicolon from an assignment's right-hand side. Xcode tolerates the
+* semicolon as a leftover from property-list habits and ignores it.
+*/
+function cleanValue(rightHandSide) {
+	const commentStart = rightHandSide.indexOf("//");
+	const trimmed = (commentStart === -1 ? rightHandSide : rightHandSide.slice(0, commentStart)).trim();
+	return trimmed.endsWith(";") ? trimmed.slice(0, -1).trimEnd() : trimmed;
+}
+/**
+* Parses the conditions block of an assignment, for example
+* `[sdk=iphoneos*][arch=arm64]`.
+*
+* @throws XcconfigParseError when the block has content that is not a
+*   well-formed `[name=value]` sequence.
+*/
+function parseConditions(block, source, blockOffset) {
+	const conditions = [];
+	let consumed = 0;
+	for (const match of block.matchAll(CONDITION_PATTERN)) {
+		if (match.index !== consumed) throw new XcconfigParseError("Malformed setting condition", source, blockOffset + consumed);
+		conditions.push({
+			name: match[1].trim(),
+			value: match[2].trim()
+		});
+		consumed = match.index + match[0].length;
+	}
+	if (consumed !== block.length) throw new XcconfigParseError("Malformed setting condition", source, blockOffset + consumed);
+	return conditions;
+}
+/**
+* Parses one line into a statement.
+*
+* @param content The line without its terminator.
+* @param source The full source text, for error positions.
+* @param lineOffset Offset of the line inside `source`.
+*/
+function parseLine(content, eol, source, lineOffset) {
+	const trimmed = content.trim();
+	if (trimmed === "") return {
+		kind: "blank",
+		raw: content,
+		eol
+	};
+	if (trimmed.startsWith("//")) return {
+		kind: "comment",
+		text: trimmed.slice(2),
+		raw: content,
+		eol
+	};
+	if (trimmed.startsWith("#")) {
+		const include = INCLUDE_PATTERN.exec(trimmed);
+		if (include == null) throw new XcconfigParseError("Malformed #include directive", source, lineOffset + content.indexOf("#"));
+		return {
+			kind: "include",
+			path: include[2],
+			optional: include[1] === "?",
+			raw: content,
+			eol
+		};
+	}
+	const head = ASSIGNMENT_HEAD_PATTERN.exec(content);
+	if (head == null) throw new XcconfigParseError("Expected a setting assignment, an #include directive, or a // comment", source, lineOffset + (content.length - content.trimStart().length));
+	const conditionsBlock = head[2];
+	const conditionsOffset = lineOffset + head[0].indexOf(conditionsBlock, head[1].length);
+	const conditions = conditionsBlock === "" ? [] : parseConditions(conditionsBlock, source, conditionsOffset);
+	return {
+		kind: "assignment",
+		key: head[1],
+		conditions,
+		value: cleanValue(content.slice(head[0].length)),
+		raw: content,
+		eol
+	};
+}
+/**
+* Parses `.xcconfig` text into its document form.
+*
+* @throws XcconfigParseError when a line is not a blank, a comment, an
+*   include, or a well-formed assignment. The error carries the line and
+*   column of the failure.
+*/
+function parseXcconfig(source) {
+	if (source === "") return { statements: [] };
+	const statements = [];
+	let offset = 0;
+	while (offset < source.length) {
+		const lineFeed = source.indexOf("\n", offset);
+		const end = lineFeed === -1 ? source.length : lineFeed;
+		const hasCarriageReturn = end > offset && source.charCodeAt(end - 1) === 13;
+		const content = source.slice(offset, hasCarriageReturn ? end - 1 : end);
+		const eol = lineFeed === -1 ? "" : hasCarriageReturn ? "\r\n" : "\n";
+		statements.push(parseLine(content, eol, source, offset));
+		if (lineFeed === -1) break;
+		offset = lineFeed + 1;
+	}
+	return { statements };
+}
+//#endregion
+//#region src/xcconfig/model.ts
+/**
+* Object model for Xcode build configuration files (`.xcconfig`).
+*
+* {@link Xcconfig} wraps a parsed document the way `XcodeProject` wraps a
+* pbxproj. The document stays the single source of truth, reads and
+* writes go through it, and {@link Xcconfig.build} emits it back with
+* untouched lines preserved byte for byte.
+*
+* @module
+*/
+/**
+* Whether a condition value matches a context value. A bare `*` matches
+* anything, a trailing `*` matches by prefix, and anything else matches
+* exactly.
+*/
+function matchesCondition(conditionValue, contextValue) {
+	if (conditionValue === "*") return true;
+	if (conditionValue.endsWith("*")) return contextValue.startsWith(conditionValue.slice(0, -1));
+	return conditionValue === contextValue;
+}
+/**
+* Splices a prior value into `$(inherited)` and `${inherited}`
+* references. With no prior value the references stay literal, because
+* they then refer to layers below the file chain, which resolve later.
+*/
+function spliceInherited(value, prior) {
+	if (prior == null) return value;
+	return value.replaceAll("$(inherited)", prior).replaceAll("${inherited}", prior);
+}
+/**
+* A build configuration file with typed, mutable access to its settings.
+*
+* ```ts
+* const config = Xcconfig.parse(text);
+* config.get("PRODUCT_BUNDLE_IDENTIFIER");
+* config.set("MARKETING_VERSION", "1.2.0");
+* const updated = config.build();
+* ```
+*/
+var Xcconfig = class Xcconfig {
+	/** The parsed document this model wraps. */
+	document;
+	constructor(document) {
+		this.document = document;
+	}
+	/**
+	* Parses `.xcconfig` text and wraps it in a model.
+	*
+	* @throws XcconfigParseError when the text is malformed.
+	*/
+	static parse(text) {
+		return new Xcconfig(parseXcconfig(text));
+	}
+	/**
+	* Creates an empty configuration file.
+	*/
+	static create() {
+		return new Xcconfig({ statements: [] });
+	}
+	/**
+	* Serializes the current document state to `.xcconfig` text.
+	*/
+	build() {
+		return buildXcconfig(this.document);
+	}
+	/**
+	* The names of the settings this file assigns unconditionally, in
+	* first-assignment order. Conditional assignments such as
+	* `KEY[sdk=iphoneos*]` are reachable through {@link assignments}.
+	*/
+	keys() {
+		const keys = [];
+		for (const statement of this.document.statements) if (statement.kind === "assignment" && statement.conditions.length === 0 && !keys.includes(statement.key)) keys.push(statement.key);
+		return keys;
+	}
+	/**
+	* Every assignment of this file, conditional ones included, in
+	* document order. The items are the document's own nodes, not copies,
+	* so treat them as read-only views. Writes belong on {@link set},
+	* which keeps a statement's value and its source text in step.
+	*/
+	assignments() {
+		return this.document.statements.filter((statement) => statement.kind === "assignment");
+	}
+	/**
+	* The `#include` directives of this file, in document order. The items
+	* are the document's own nodes, not copies, so treat them as read-only
+	* views.
+	*/
+	includes() {
+		return this.document.statements.filter((statement) => statement.kind === "include");
+	}
+	/**
+	* Reads the value of a setting from this file alone. When the key is
+	* assigned more than once the last assignment wins, matching how Xcode
+	* reads the file top to bottom. Conditional assignments are ignored.
+	*/
+	get(key) {
+		let value;
+		for (const statement of this.document.statements) if (statement.kind === "assignment" && statement.key === key && statement.conditions.length === 0) value = statement.value;
+		return value;
+	}
+	/**
+	* Writes a setting. The last unconditional assignment of the key is
+	* rewritten in place as a canonical `KEY = value` line, replacing any
+	* trailing comment the line carried. A key the file does not assign
+	* yet is appended at the end, following the document's line-ending
+	* convention.
+	*/
+	set(key, value) {
+		let target;
+		for (const statement of this.document.statements) if (statement.kind === "assignment" && statement.key === key && statement.conditions.length === 0) target = statement;
+		if (target != null) {
+			target.value = value;
+			target.raw = `${key} = ${value}`;
+			return;
+		}
+		const eol = this.document.statements.find((statement) => statement.eol !== "")?.eol ?? "\n";
+		const last = this.document.statements.at(-1);
+		if (last != null && last.eol === "") last.eol = eol;
+		this.document.statements.push({
+			kind: "assignment",
+			key,
+			conditions: [],
+			value,
+			raw: `${key} = ${value}`,
+			eol
+		});
+	}
+	/**
+	* Removes every unconditional assignment of a setting.
+	*
+	* @returns True when at least one assignment was removed.
+	*/
+	remove(key) {
+		const kept = this.document.statements.filter((statement) => statement.kind !== "assignment" || statement.key !== key || statement.conditions.length > 0);
+		const removed = kept.length !== this.document.statements.length;
+		this.document.statements = kept;
+		return removed;
+	}
+	/**
+	* Flattens the file into a settings dictionary the way Xcode reads it:
+	* top to bottom with later assignments winning, and every `#include`
+	* contributing its settings at the point of the directive, so lines
+	* after an include override it.
+	*
+	* Conditional assignments apply when every condition matches
+	* {@link XcconfigSettingsOptions.context}; without a context they are
+	* skipped. `$(inherited)` references splice in the value accumulated
+	* earlier in the chain, and stay literal when there is none, since
+	* they then refer to layers below the file, which resolve later.
+	*
+	* Includes only take part when {@link XcconfigSettingsOptions.resolveInclude}
+	* is provided, since the library never touches the filesystem itself.
+	* A file included again later re-applies, exactly like pasting its text
+	* a second time. Only re-entry while a file is still being expanded is
+	* skipped, tracked by include path and by instance, so cyclic includes
+	* terminate even when the resolver parses a fresh instance per call.
+	*/
+	settings(options = {}) {
+		const merged = {};
+		const pathStack = /* @__PURE__ */ new Set();
+		const instanceStack = /* @__PURE__ */ new Set();
+		const context = options.context;
+		const applies = (statement) => statement.conditions.every((condition) => {
+			const contextValue = condition.name === "sdk" || condition.name === "arch" || condition.name === "config" ? context?.[condition.name] : void 0;
+			return contextValue != null && matchesCondition(condition.value, contextValue);
+		});
+		const visit = (config) => {
+			if (instanceStack.has(config)) return;
+			instanceStack.add(config);
+			for (const statement of config.document.statements) if (statement.kind === "include") {
+				if (pathStack.has(statement.path)) continue;
+				const included = options.resolveInclude?.(statement.path, statement.optional);
+				if (included != null) {
+					pathStack.add(statement.path);
+					visit(included);
+					pathStack.delete(statement.path);
+				}
+			} else if (statement.kind === "assignment" && applies(statement)) merged[statement.key] = spliceInherited(statement.value, merged[statement.key]);
+			instanceStack.delete(config);
+		};
+		visit(this);
+		return merged;
+	}
+};
+//#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, Xcconfig, XcconfigParseError, XcodeModelError, XcodeObject, XcodeProject, Xcscheme, XcschemeBuildError, XcschemeParseError, buildPbxproj, buildXcconfig, buildXcscheme, createXcscheme, generateObjectId, isXcschemeElement, parseApplePlatform, parsePbxproj, parseXcconfig, parseXcscheme, xcschemeElements };