@halospv3/hce.shared-config 3.4.7 → 3.4.8

package/mjs/dotnet/MSBuildProject.mjs

@@ -1,3 +1,346 @@
-import{CaseInsensitiveMap as e}from"../CaseInsensitiveMap.mjs";import{isError as t}from"../utils/isError.mjs";import{execAsync as n}from"../utils/execAsync.mjs";import{MSBuildProjectProperties as r}from"./MSBuildProjectProperties.mjs";import{NPPGetterNames as i,NugetProjectProperties as a}from"./NugetProjectProperties.mjs";import{warn as o}from"node:console";import{type as s}from"arktype";import*as c from"node:path";import{readdir as l,realpath as u,stat as d}from"node:fs/promises";import{setTimeout as f}from"node:timers/promises";const p=s({"[string]":`string`,Identity:`string`,"SubType?":`string`,"TargetFrameworkIdentifier?":`string`,"TargetPlatformMoniker?":`string`,"CopyUpToDateMarker?":`string`,"TargetPlatformIdentifier?":`string`,"TargetFrameworkVersion?":`string`,"ReferenceAssembly?":`string`,FullPath:`string`,RootDir:`string`,Filename:`string`,Extension:`string`,RelativeDir:`string`,Directory:`string`,RecursiveDir:`string`,ModifiedTime:`string`,CreatedTime:`string`,AccessedTime:`string`,DefiningProjectFullPath:`string`,DefiningProjectDirectory:`string`,DefiningProjectName:`string`,DefiningProjectExtension:`string`}),m=s({Result:`'Success'`,Items:p.array()}),h=s({Result:`'Failure'`,Items:`never[]`}),g=s({"Properties?":s({"[string]":`string`}),"Items?":s({"[string]":p.array()}),"TargetResults?":s({"[string]":m.or(h)})});var _=class{constructor(e){let t=g.assert(typeof e==`string`?JSON.parse(e):e);this.Properties=t.Properties,this.Items=t.Items,this.TargetResults=t.TargetResults}Properties;Items;TargetResults};const v=Object.freeze(s({FullName:`string`,Property:s({"[string]":`string`}).as().partial(),Targets:s.string.array().readonly().or(`string[]`),GetItem:s.string.array().readonly().or(`string[]`),GetProperty:s.string.array().readonly().or(`string[]`),GetTargetResult:s.string.array().readonly().or(`string[]`)}));var y=class t{static MatrixProperties=Object.freeze([`TargetFramework`,`TargetFrameworks`,`RuntimeIdentifier`,`RuntimeIdentifiers`]);constructor(t){this.Items=t.evaluation.Items??{},this.Properties=new a(t.fullPath,new e(Object.entries(t.evaluation.Properties??{}))),this.Targets=t.projTargets,this.TargetResults=t.evaluation.TargetResults===void 0?[]:[t.evaluation.TargetResults]}Items;Properties;Targets;TargetResults;static async GetTargets(e,t=!1){return n(`dotnet msbuild ${e} -targets`,!0).then(e=>{let n=e.stdout.split(`
-`).filter((e,t)=>e!==``&&t!==0).map(e=>e.replaceAll(`\r`,``)).sort((e,t)=>e.localeCompare(t));return t?n:n.filter(e=>!e.startsWith(`_`))})}static async Evaluate(e){if(e.GetProperty.length===0&&e.GetItem.length===0&&e.GetTargetResult.length===0)throw Error(`No MSBuild Property, Item, or TargetResult queries were provided.`);e.FullName=r.GetFullPath(e.FullName);let i=Object.entries(e.Property).filter(e=>typeof e[1]==`string`),a=i.length===0?``:`-p:"${i.map(e=>e[0]+`=`+e[1]).join(`;`)}"`,s=e.Targets.length===0?``:`"-t:${e.Targets.join(`;`)}"`,c=e.GetItem.length===0?``:`-getItem:"${e.GetItem.join(`,`)}"`,l=e.GetProperty.length===0?``:`-getProperty:"${e.GetProperty.join(`,`)}"`,u=e.GetTargetResult.length===0?``:`-getTargetResult:"${e.GetTargetResult.join(`,`)}"`,d=[`dotnet`,`msbuild`,`"${e.FullName}"`,`-restore`,a,s,c,l,u].filter(e=>e!==``).join(` `),p;for(;p===void 0;)p=await f(1e3,n(d,!0)).then(async e=>await e).catch(T);if(p.stdout.startsWith(`MSBuild version`))throw o(p.stdout),Error(`dotnet msbuild was expected to output JSON, but output its version header instead.`);let m;if(p.stdout.startsWith(`{`))m=p.stdout;else if(e.GetProperty.length>0&&e.GetProperty[0]!==void 0)m={Properties:{[e.GetProperty[0]]:String(JSON.parse(p.stdout))}};else throw Error(`Dotnet/MSBuild evaluation output is not a string nor JSON object or array.`);let h=new _(m);return new t({fullPath:e.FullName,projTargets:await t.GetTargets(e.FullName),evaluation:h})}static async PackableProjectsToMSBuildProjects(e){return await n(typeof e==`string`?[e]:e).then(e=>e.map(e=>r(e)));async function n(e){return(await Promise.all(e.map(async e=>{e=await u(w(e));let t=await d(e),n;if(t.isFile()){n=await l(c.dirname(e),{withFileTypes:!0});let t=n.find(t=>c.join((`path`in t?t.path:void 0)??t.parentPath,t.name)===e);if(t)return t;throw Error(`file "${e}" not found. It may have been moved or deleted.`)}if(!t.isDirectory())throw Error(`"${e}" is not a file or directory`);return n=await l(e,{withFileTypes:!0}),n.filter(e=>e.isFile()&&(e.name.endsWith(`.csproj`)||e.name.endsWith(`.fsproj`)||e.name.endsWith(`.vbproj`)))}))).flat()}async function r(e){let n=c.join((`path`in e?e.path:void 0)??e.parentPath,e.name),r=await t.GetTargets(n).then(e=>e.includes(`Pack`)?[`Pack`]:[]),a=i.InstanceGettersRecursive;return await t.Evaluate(v.from({FullName:n,GetItem:[],GetProperty:a,GetTargetResult:[],Property:{},Targets:r}))}}static fromJSON(e){let n=S.assert(JSON.parse(e));return s.true.assert(Reflect.setPrototypeOf(n,t.prototype)),s.true.assert(Reflect.setPrototypeOf(n.Properties,a.prototype)),n.Properties=x.assert(n.Properties),b.assert(n)}};const b=s.instanceOf(y),x=s.instanceOf(a),S=s({Items:s({"[string]":s({"[string]":`string`,Identity:`string`,FullPath:`string`,RootDir:`string`,Filename:`string`,Extension:`string`,RelativeDir:`string`,Directory:`string`,RecursiveDir:`string`,ModifiedTime:`string`,CreatedTime:`string`,AccessedTime:`string`,DefiningProjectFullPath:`string`,DefiningProjectDirectory:`string`,DefiningProjectName:`string`,DefiningProjectExtension:`string`,"SubType?":` string | undefined`,"TargetFrameworkIdentifier?":`string | undefined`,"TargetPlatformMoniker?":`string | undefined`,"CopyUpToDateMarker?":`string | undefined`,"TargetPlatformIdentifier?":`string | undefined`,"TargetFrameworkVersion?":`string | undefined`,"ReferenceAssembly?":`string | undefined`}).array()}),Properties:s.Record(`string`,`string`).or(x),Targets:s.string.array(),TargetResults:g.get(`TargetResults`).exclude(`undefined`).array()}),C=s.scope({msbuildEvaluationOutput:g});function w(e){return c.isAbsolute(e)?e:c.resolve(e)}function T(e){if(t(e))if(`stderr`in e&&typeof e.stderr==`string`){let t=e.stderr.normalize(`NFKC`),n=/The process cannot access the file '[^']+' because it is being used by another process\./gm.test(t),r=/^CSC ?:.+CS2012:/gm.test(t),i=/AVLN9999:/gm.test(t)&&n;if(r||i||n)return}else throw e;else throw Error(`unknown error`,{cause:e})}function E(e){if(t(e)){if(`stderr`in e&&typeof e.stderr==`string`&&/^CSC ?:.+CS2012:/gm.test(e.stderr.normalize(`NFKC`)))return;throw e}else throw Error(`unknown error`,{cause:e})}export{v as EvaluationOptions,_ as MSBuildEvaluationOutput,y as MSBuildProject,C as _InternalMSBuildEvaluationTypes,E as catchCsc2012,T as catchEBUSY};
+import { CaseInsensitiveMap } from "../CaseInsensitiveMap.mjs";
+import { isError } from "../utils/isError.mjs";
+import { execAsync } from "../utils/execAsync.mjs";
+import { MSBuildProjectProperties } from "./MSBuildProjectProperties.mjs";
+import { NPPGetterNames, NugetProjectProperties } from "./NugetProjectProperties.mjs";
+import { warn } from "node:console";
+import { type } from "arktype";
+import * as path from "node:path";
+import { readdir, realpath, stat } from "node:fs/promises";
+import { setTimeout } from "node:timers/promises";
+//#region src/dotnet/MSBuildProject.ts
+/**
+* See [MSBuild well-known item metadata](https://learn.microsoft.com/en-us/visualstudio/msbuild/msbuild-well-known-item-metadata).
+* Additional string-type properties may be present (e.g. `{ SubType: "designer" }`).
+*/
+const interface_ItemMetadataBuiltIn = type({
+	"[string]": "string",
+	Identity: "string",
+	"SubType?": "string",
+	"TargetFrameworkIdentifier?": "string",
+	"TargetPlatformMoniker?": "string",
+	"CopyUpToDateMarker?": "string",
+	"TargetPlatformIdentifier?": "string",
+	"TargetFrameworkVersion?": "string",
+	"ReferenceAssembly?": "string",
+	FullPath: "string",
+	RootDir: "string",
+	Filename: "string",
+	Extension: "string",
+	RelativeDir: "string",
+	Directory: "string",
+	RecursiveDir: "string",
+	ModifiedTime: "string",
+	CreatedTime: "string",
+	AccessedTime: "string",
+	DefiningProjectFullPath: "string",
+	DefiningProjectDirectory: "string",
+	DefiningProjectName: "string",
+	DefiningProjectExtension: "string"
+});
+const targetSuccess = type({
+	Result: "'Success'",
+	Items: interface_ItemMetadataBuiltIn.array()
+});
+const targetFailure = type({
+	Result: "'Failure'",
+	Items: "never[]"
+});
+const msbuildEvaluationOutput = type({
+	"Properties?": type({ "[string]": "string" }),
+	"Items?": type({ "[string]": interface_ItemMetadataBuiltIn.array() }),
+	"TargetResults?": type({ "[string]": targetSuccess.or(targetFailure) })
+});
+var MSBuildEvaluationOutput = class {
+	/**
+	* @param rawMSBuildEvaluation The output of a CLI MSBuild project evaluation.
+	* May be the UTF-8 string-encoded JSON or the object decoded from that JSON.
+	*/
+	constructor(rawMSBuildEvaluation) {
+		/** `.assert` instead of `.from` to allow `unknown` JSON.parse return type */
+		const knownObject = msbuildEvaluationOutput.assert(typeof rawMSBuildEvaluation === "string" ? JSON.parse(rawMSBuildEvaluation) : rawMSBuildEvaluation);
+		this.Properties = knownObject.Properties;
+		this.Items = knownObject.Items;
+		this.TargetResults = knownObject.TargetResults;
+	}
+	/**
+	* The specified properties and their values as evaluated by MSBuild Core.
+	* `-getProperty:{propertyName,...}`
+	*/
+	Properties;
+	/**
+	* The specified items and their values and associated metadata as evaluated
+	* by MSBuild Core.
+	* `-getItem:{itemName,...}`
+	*/
+	Items;
+	/**
+	* The specified Targets and their output values as evaluated by MSBuild
+	* Core.
+	* `-getTargetResult:{targetName,...}`
+	*/
+	TargetResults;
+};
+const EvaluationOptions = Object.freeze(type({
+	FullName: "string",
+	Property: type({ "[string]": "string" }).as().partial(),
+	Targets: type.string.array().readonly().or("string[]"),
+	GetItem: type.string.array().readonly().or("string[]"),
+	GetProperty: type.string.array().readonly().or("string[]"),
+	GetTargetResult: type.string.array().readonly().or("string[]")
+}));
+var MSBuildProject = class MSBuildProject {
+	/**
+	* Properties for multi-targeting `dotnet publish` outputs.
+	* These are included in {@link NPPGetterNames.InstanceGettersRecursive}.
+	*/
+	static MatrixProperties = Object.freeze([
+		"TargetFramework",
+		"TargetFrameworks",
+		"RuntimeIdentifier",
+		"RuntimeIdentifiers"
+	]);
+	/**
+	* Creates an instance of MSBuildProject.
+	* @param opts The order-independent arguments for this constructor.
+	* Properties may be added or moved around in this definition without
+	* breaking compatibility.
+	* @param opts.fullPath The full path of the MSBuild project's file. This
+	* should have a '.csproj', '.fsproj', or '.vbproj' file extension.
+	* @param opts.projTargets A list of MSBuild Targets supported by the project.
+	* @param opts.evaluation The output of an MSBuild project evaluation. This
+	* comprises MSBuild Properties, Items, and Target results.
+	*/
+	constructor(opts) {
+		this.Items = opts.evaluation.Items ?? {};
+		this.Properties = new NugetProjectProperties(opts.fullPath, new CaseInsensitiveMap(Object.entries(opts.evaluation.Properties ?? {})));
+		this.Targets = opts.projTargets;
+		this.TargetResults = opts.evaluation.TargetResults === void 0 ? [] : [opts.evaluation.TargetResults];
+	}
+	Items;
+	Properties;
+	Targets;
+	/**
+	* Allows appending subsequent target results.
+	*/
+	TargetResults;
+	/**
+	* @param projectPath The full path of the project file or its directory. A
+	* relative path may be passed, but will resolve relative to the current
+	* working directory.
+	* @param includeNonPublic Include conventionally internal/private MSBuild
+	* targets in the result.
+	* @returns A string array of the project's MSBuild targets.
+	* @todo consider 'file' of -targets[:file]
+	*  Prints a list of available targets without executing the
+	*  actual build process. By default the output is written to
+	*  the console window. If the path to an output file
+	*  is provided that will be used instead.
+	*  (Short form: -ts)
+	*  Example:
+	*    -ts:out.txt
+	*/
+	static async GetTargets(projectPath, includeNonPublic = false) {
+		return execAsync(`dotnet msbuild ${projectPath} -targets`, true).then((v) => {
+			const targets = v.stdout.split("\n").filter((v, index) => v !== "" && index !== 0).map((v) => v.replaceAll("\r", "")).sort((a, b) => a.localeCompare(b));
+			return includeNonPublic ? targets : targets.filter((v) => !v.startsWith("_"));
+		});
+	}
+	/**
+	* Evaluate {@link Items}, {@link Properties}, and {@link TargetResults},
+	* returning them as an instance of {@link MSBuildProject}.\
+	* Note: MSBuild will probably fail if Restore is skipped and another
+	* target is specified. If you choose Pack, you must do ['Restore', 'Pack'].
+	* @param options The result of {@link EvaluationOptions.from}.
+	* @returns A promised {@link MSBuildProject} instance.
+	* @throws {Error} if the exec command fails -OR- the JSON parse fails -OR-
+	* MSBuildProject's constructor fails.
+	* @see {@link PackableProjectsToMSBuildProjects} for most use-cases.
+	*/
+	static async Evaluate(options) {
+		if (options.GetProperty.length === 0 && options.GetItem.length === 0 && options.GetTargetResult.length === 0) throw new Error("No MSBuild Property, Item, or TargetResult queries were provided.");
+		options.FullName = MSBuildProjectProperties.GetFullPath(options.FullName);
+		const _pairs = Object.entries(options.Property).filter((p) => typeof p[1] === "string");
+		const property = _pairs.length === 0 ? "" : `-p:"${_pairs.map((pair) => pair[0] + "=" + pair[1]).join(";")}"`;
+		const target = options.Targets.length === 0 ? "" : `"-t:${options.Targets.join(";")}"`;
+		const getItem = options.GetItem.length === 0 ? "" : `-getItem:"${options.GetItem.join(",")}"`;
+		const getProperty = options.GetProperty.length === 0 ? "" : `-getProperty:"${options.GetProperty.join(",")}"`;
+		const getTargetResult = options.GetTargetResult.length === 0 ? "" : `-getTargetResult:"${options.GetTargetResult.join(",")}"`;
+		const cmdLine = [
+			"dotnet",
+			"msbuild",
+			`"${options.FullName}"`,
+			"-restore",
+			property,
+			target,
+			getItem,
+			getProperty,
+			getTargetResult
+		].filter((v) => v !== "").join(" ");
+		let stdio = void 0;
+		while (stdio === void 0) stdio = await setTimeout(1e3, execAsync(cmdLine, true)).then(async (p) => await p).catch(catchEBUSY);
+		/**
+		* The following issues have triggered this code path:
+		* - BaseIntermediateOutputPath must use Unix path separators ('/') on all
+		*   platforms. Even Windows. Otherwise, MSBuild/dotnet will error-exit with
+		*   "The BaseIntermediateOutputPath must end with a trailing slash".
+		*/
+		if (stdio.stdout.startsWith("MSBuild version")) {
+			warn(stdio.stdout);
+			throw new Error("dotnet msbuild was expected to output JSON, but output its version header instead.");
+		}
+		let rawOutput;
+		if (stdio.stdout.startsWith("{"))
+ /** stdout is JSON string */
+		rawOutput = stdio.stdout;
+		else if (options.GetProperty.length > 0 && options.GetProperty[0] !== void 0) rawOutput = { Properties: { [options.GetProperty[0]]: String(JSON.parse(stdio.stdout)) } };
+		else throw new Error("Dotnet/MSBuild evaluation output is not a string nor JSON object or array.");
+		const evaluation = new MSBuildEvaluationOutput(rawOutput);
+		return new MSBuildProject({
+			fullPath: options.FullName,
+			projTargets: await MSBuildProject.GetTargets(options.FullName),
+			evaluation
+		});
+	}
+	/**
+	* Evaluate multiple project paths with some default Evaluate options.
+	* @async
+	* @param projectsToPackAndPush An array of MSBuild projects' full file
+	* paths. If a path is a directory, files in that directory are filtered for
+	* `.csproj`, `.fsproj`, and `.vbproj` project files.
+	* See https://github.com/dotnet/sdk/blob/497f334b2862bdf98b30c00ede2fd259ea5f624d/src/Cli/dotnet/Commands/New/MSBuildEvaluation/MSBuildEvaluationResult.cs#L19-L32.\
+	* @returns A promised array of {@link MSBuildProject} instances.
+	* All known MSBuild and NuGet properties are evaluated.
+	* If applicable, a project's "Pack" target is evaluated.
+	*/
+	static async PackableProjectsToMSBuildProjects(projectsToPackAndPush) {
+		return await toDirEntries(typeof projectsToPackAndPush === "string" ? [projectsToPackAndPush] : projectsToPackAndPush).then((direntArray) => direntArray.map((element) => convertDirentToMSBuildProject(element)));
+		/**
+		* Map an array of filesystem paths to {@link Dirent} instances representing project files.
+		* @param projectsToPackAndPush An array of MSBuild projects' full file
+		* paths. If a path is a directory, files in that directory are filtered for
+		* `.csproj`, `.fsproj`, and `.vbproj` project files. See
+		* https://github.com/dotnet/sdk/blob/497f334b2862bdf98b30c00ede2fd259ea5f624d/src/Cli/dotnet/Commands/New/MSBuildEvaluation/MSBuildEvaluationResult.cs#L19-L32.\
+		* @returns An promised array of Dirent instances for discovered project files.
+		*/
+		async function toDirEntries(projectsToPackAndPush) {
+			return (await Promise.all(projectsToPackAndPush.map(async (proj) => {
+				proj = await realpath(makeAbsolute(proj));
+				const stats = await stat(proj);
+				let entries;
+				if (stats.isFile()) {
+					entries = await readdir(path.dirname(proj), { withFileTypes: true });
+					const dirent = entries.find((v) => path.join(("path" in v ? v.path : void 0) ?? v.parentPath, v.name) === proj);
+					if (dirent) return dirent;
+					else throw new Error(`file "${proj}" not found. It may have been moved or deleted.`);
+				}
+				if (!stats.isDirectory()) throw new Error(`"${proj}" is not a file or directory`);
+				entries = await readdir(proj, { withFileTypes: true });
+				return entries.filter((v) => v.isFile() && (v.name.endsWith(".csproj") || v.name.endsWith(".fsproj") || v.name.endsWith(".vbproj")));
+			}))).flat();
+		}
+		/**
+		* Map a {@link Dirent} instance to an {@link MSBuildProject} instance.
+		* @param dirent A {@link Dirent} instance. This instance should be an MSBuild project file.
+		* @returns An instance of {@link MSBuildProject} evaluated with the `Pack` target result, if applicable. Evaluated properties will be those whose names are returned by {@link NPPGetterNames.InstanceGettersRecursive}.
+		*/
+		async function convertDirentToMSBuildProject(dirent) {
+			const fullPath = path.join(("path" in dirent ? dirent.path : void 0) ?? dirent.parentPath, dirent.name);
+			const evalTargets = await MSBuildProject.GetTargets(fullPath).then((v) => v.includes("Pack") ? ["Pack"] : []);
+			const getProperties = NPPGetterNames.InstanceGettersRecursive;
+			return await MSBuildProject.Evaluate(EvaluationOptions.from({
+				FullName: fullPath,
+				GetItem: [],
+				GetProperty: getProperties,
+				GetTargetResult: [],
+				Property: {},
+				Targets: evalTargets
+			}));
+		}
+	}
+	static fromJSON(json) {
+		const parsed = T_PseudoMSBPInstance.assert(JSON.parse(json));
+		type.true.assert(Reflect.setPrototypeOf(parsed, MSBuildProject.prototype));
+		type.true.assert(Reflect.setPrototypeOf(parsed.Properties, NugetProjectProperties.prototype));
+		parsed.Properties = T_NPP.assert(parsed.Properties);
+		return T_MSBuildProject.assert(parsed);
+	}
+};
+const T_MSBuildProject = type.instanceOf(MSBuildProject);
+const T_NPP = type.instanceOf(NugetProjectProperties);
+const T_PseudoMSBPInstance = type({
+	Items: type({ "[string]": type({
+		"[string]": "string",
+		Identity: "string",
+		FullPath: "string",
+		RootDir: "string",
+		Filename: "string",
+		Extension: "string",
+		RelativeDir: "string",
+		Directory: "string",
+		RecursiveDir: "string",
+		ModifiedTime: "string",
+		CreatedTime: "string",
+		AccessedTime: "string",
+		DefiningProjectFullPath: "string",
+		DefiningProjectDirectory: "string",
+		DefiningProjectName: "string",
+		DefiningProjectExtension: "string",
+		"SubType?": " string | undefined",
+		"TargetFrameworkIdentifier?": "string | undefined",
+		"TargetPlatformMoniker?": "string | undefined",
+		"CopyUpToDateMarker?": "string | undefined",
+		"TargetPlatformIdentifier?": "string | undefined",
+		"TargetFrameworkVersion?": "string | undefined",
+		"ReferenceAssembly?": "string | undefined"
+	}).array() }),
+	Properties: type.Record("string", "string").or(T_NPP),
+	Targets: type.string.array(),
+	TargetResults: msbuildEvaluationOutput.get("TargetResults").exclude("undefined").array()
+});
+/**
+* ArkType type definitions for internal usage, but may be re-used elsewhere
+* @internal
+*/
+const _InternalMSBuildEvaluationTypes = type.scope({ msbuildEvaluationOutput });
+/**
+* Resolve a path if it is not already absolute.
+* @param _path A filesystem path.
+* @returns A full path to a filesystem entry. The path is unchecked for whether or not the path (or its parts) exist.
+*/
+function makeAbsolute(_path) {
+	return path.isAbsolute(_path) ? _path : path.resolve(_path);
+}
+/**
+* Use this in your catch statement or .catch call to return `undefined` when
+* a "file in use by another process" (i.e. EBUSY/ERROR_SHARING_VIOLATION) error is reported.
+* @param error Probably an Error object
+* @returns `undefined` if file in use by another process
+*/
+function catchEBUSY(error) {
+	if (isError(error)) if ("stderr" in error && typeof error.stderr === "string") {
+		const normalizedStderr = error.stderr.normalize("NFKC");
+		const hasErrMsgPattern = /The process cannot access the file '[^']+' because it is being used by another process\./gm.test(normalizedStderr);
+		const isCS2012 = /^CSC ?:.+CS2012:/gm.test(normalizedStderr);
+		const isAVLN9999 = /AVLN9999:/gm.test(normalizedStderr) && hasErrMsgPattern;
+		if (isCS2012 || isAVLN9999 || hasErrMsgPattern) return void 0;
+	} else throw error;
+	else throw new Error("unknown error", { cause: error });
+}
+/**
+*
+* Use this in your catch statement or .catch call to return `undefined` when
+* MSBuild error CSC2012 (e.g. "file in use by another process") is reported.
+* @param error Probably an Error object
+* @returns `undefined` if CSC2012 (file in use by another process) occurs
+* @deprecated Use {@link catchEBUSY}.
+*/
+function catchCsc2012(error) {
+	if (isError(error)) if ("stderr" in error && typeof error.stderr === "string" && /^CSC ?:.+CS2012:/gm.test(error.stderr.normalize("NFKC"))) return;
+	else throw error;
+	else throw new Error("unknown error", { cause: error });
+}
+//#endregion
+export { EvaluationOptions, MSBuildEvaluationOutput, MSBuildProject, _InternalMSBuildEvaluationTypes, catchCsc2012, catchEBUSY };
+
 //# sourceMappingURL=MSBuildProject.mjs.map

package/mjs/dotnet/MSBuildProject.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MSBuildProject.mjs","names":[],"sources":["../../src/dotnet/MSBuildProject.ts"],"sourcesContent":["import { type, type Scope, type Type } from 'arktype';\nimport { warn } from 'node:console';\nimport { type Dirent } from 'node:fs';\nimport { readdir, realpath, stat } from 'node:fs/promises';\n// eslint-disable-next-line unicorn/import-style\nimport * as path from 'node:path';\nimport { setTimeout } from 'node:timers/promises';\nimport { CaseInsensitiveMap } from '../CaseInsensitiveMap.ts';\nimport { execAsync } from '../utils/execAsync.ts';\nimport { isError } from '../utils/isError.ts';\nimport { MSBuildProjectProperties } from './MSBuildProjectProperties.ts';\nimport {\n  NPPGetterNames,\n  NugetProjectProperties,\n} from './NugetProjectProperties.ts';\n\n/**\n * See [MSBuild well-known item metadata](https://learn.microsoft.com/en-us/visualstudio/msbuild/msbuild-well-known-item-metadata).\n * Additional string-type properties may be present (e.g. `{ SubType: \"designer\" }`).\n */\nconst interface_ItemMetadataBuiltIn = type({\n  '[string]': 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\bin\\\\Debug\\\\net6.0\\\\ConsoleApp1.dll\" */\n  Identity: 'string',\n  /** @example \"Designer\" */\n  'SubType?': 'string',\n  /** @example \".NETCoreApp\" */\n  'TargetFrameworkIdentifier?': 'string',\n  'TargetPlatformMoniker?': 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\obj\\\\Debug\\\\net6.0\\\\ConsoleApp1.csproj.CopyComplete\" */\n  'CopyUpToDateMarker?': 'string',\n  'TargetPlatformIdentifier?': 'string',\n  /** @example \"6.0\" */\n  'TargetFrameworkVersion?': 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\obj\\\\Debug\\\\net6.0\\\\ref\\\\ConsoleApp1.dll\" */\n  'ReferenceAssembly?': 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\bin\\\\Debug\\\\net6.0\\\\ConsoleApp1.dll\" */\n  FullPath: 'string',\n  /** @example \"c:\\\\\" */\n  RootDir: 'string',\n  /** @example \"ConsoleApp1\" */\n  Filename: 'string',\n  /** @example \".dll\" */\n  Extension: 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\bin\\\\Debug\\\\net6.0\\\\\" */\n  RelativeDir: 'string',\n  /** @example \"source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\bin\\\\Debug\\\\net6.0\\\\\" */\n  Directory: 'string',\n  RecursiveDir: 'string',\n  /** @example \"2023-11-30 13:38:06.5084339\" */\n  ModifiedTime: 'string',\n  /** @example \"2023-11-30 13:38:06.9308716\" */\n  CreatedTime: 'string',\n  /** @example \"2023-11-30 13:38:06.9318732\" */\n  AccessedTime: 'string',\n  /** @example \"C:\\\\Program Files\\\\Microsoft Visual Studio\\\\2022\\\\Preview\\\\MSBuild\\\\Current\\\\Bin\\\\amd64\\\\Microsoft.Common.CurrentVersion.targets\" */\n  DefiningProjectFullPath: 'string',\n  /** @example \"C:\\\\Program Files\\\\Microsoft Visual Studio\\\\2022\\\\Preview\\\\MSBuild\\\\Current\\\\Bin\\\\amd64\\\\\" */\n  DefiningProjectDirectory: 'string',\n  /** @example \"Microsoft.Common.CurrentVersion\" */\n  DefiningProjectName: 'string',\n  /** @example \".targets\" */\n  DefiningProjectExtension: 'string',\n});\n\nconst targetSuccess = type({\n  Result: '\\'Success\\'',\n  Items: interface_ItemMetadataBuiltIn.array(),\n});\n\nconst targetFailure = type({\n  Result: '\\'Failure\\'',\n  Items: 'never[]',\n});\n\nconst msbuildEvaluationOutput: Type<{\n  Properties?: Record<string, string> | undefined;\n  Items?: Record<string, {\n    [x: string]: string | undefined;\n    Identity: string;\n    FullPath: string;\n    RootDir: string;\n    Filename: string;\n    Extension: string;\n    RelativeDir: string;\n    Directory: string;\n    RecursiveDir: string;\n    ModifiedTime: string;\n    CreatedTime: string;\n    AccessedTime: string;\n    DefiningProjectFullPath: string;\n    DefiningProjectDirectory: string;\n    DefiningProjectName: string;\n    DefiningProjectExtension: string;\n    SubType?: string;\n    TargetFrameworkIdentifier?: string | undefined;\n    TargetPlatformMoniker?: string | undefined;\n    CopyUpToDateMarker?: string | undefined;\n    TargetPlatformIdentifier?: string | undefined;\n    TargetFrameworkVersion?: string | undefined;\n    ReferenceAssembly?: string | undefined;\n  }[]> | undefined;\n  TargetResults?: Record<string, {\n    Result: 'Success';\n    Items: {\n      [x: string]: string | undefined;\n      Identity: string;\n      FullPath: string;\n      RootDir: string;\n      Filename: string;\n      Extension: string;\n      RelativeDir: string;\n      Directory: string;\n      RecursiveDir: string;\n      ModifiedTime: string;\n      CreatedTime: string;\n      AccessedTime: string;\n      DefiningProjectFullPath: string;\n      DefiningProjectDirectory: string;\n      DefiningProjectName: string;\n      DefiningProjectExtension: string;\n      SubType?: string | undefined;\n      TargetFrameworkIdentifier?: string | undefined;\n      TargetPlatformMoniker?: string | undefined;\n      CopyUpToDateMarker?: string | undefined;\n      TargetPlatformIdentifier?: string | undefined;\n      TargetFrameworkVersion?: string | undefined;\n      ReferenceAssembly?: string | undefined;\n    }[];\n  } | {\n    Result: 'Failure';\n    Items: never[];\n  }> | undefined;\n}> = type({\n  'Properties?': type({ '[string]': 'string' }),\n  'Items?': type({ '[string]': interface_ItemMetadataBuiltIn.array() }),\n  'TargetResults?': type({ '[string]': targetSuccess.or(targetFailure) }),\n});\n\nexport class MSBuildEvaluationOutput {\n  /**\n   * @param rawMSBuildEvaluation The output of a CLI MSBuild project evaluation.\n   * May be the UTF-8 string-encoded JSON or the object decoded from that JSON.\n   */\n  constructor(rawMSBuildEvaluation: Parameters<typeof JSON.parse>[0] | Parameters<typeof msbuildEvaluationOutput.from>[0]) {\n    /** `.assert` instead of `.from` to allow `unknown` JSON.parse return type */\n    const knownObject = msbuildEvaluationOutput.assert(typeof rawMSBuildEvaluation === 'string' ? JSON.parse(rawMSBuildEvaluation) : rawMSBuildEvaluation);\n\n    this.Properties = knownObject.Properties;\n    this.Items = knownObject.Items;\n    this.TargetResults = knownObject.TargetResults;\n  }\n\n  /**\n   * The specified properties and their values as evaluated by MSBuild Core.\n   * `-getProperty:{propertyName,...}`\n   */\n  Properties?: typeof msbuildEvaluationOutput.infer.Properties;\n  /**\n   * The specified items and their values and associated metadata as evaluated\n   * by MSBuild Core.\n   * `-getItem:{itemName,...}`\n   */\n  Items?: typeof msbuildEvaluationOutput.infer.Items;\n  /**\n   * The specified Targets and their output values as evaluated by MSBuild\n   * Core.\n   * `-getTargetResult:{targetName,...}`\n   */\n  TargetResults?: typeof msbuildEvaluationOutput.infer.TargetResults;\n}\n\nexport const EvaluationOptions: Type<{\n  FullName: string;\n  Property: {\n    MSBuildProjectFullPath?: string | undefined;\n    AssemblyName?: string | undefined;\n    BaseIntermediateOutputPath?: string | undefined;\n    BaseOutputPath?: string | undefined;\n    Description?: string | undefined;\n    IntermediateOutput?: string | undefined;\n    OutDir?: string | undefined;\n    OutputPath?: string | undefined;\n    Version?: string | undefined;\n    VersionPrefix?: string | undefined;\n    VersionSuffix?: string | undefined;\n    TargetFramework?: string | undefined;\n    TargetFrameworks?: string | undefined;\n    RuntimeIdentifier?: string | undefined;\n    RuntimeIdentifiers?: string | undefined;\n  };\n  Targets: readonly string[] | string[];\n  GetItem: readonly string[] | string[];\n  GetProperty: readonly string[] | string[];\n  GetTargetResult: readonly string[] | string[];\n}> = Object.freeze(\n  type({\n    /**\n     * The project file's full path.\n     */\n    FullName: 'string',\n    /**\n     * User-defined Properties and their values.\n     * { Configuration: \"Release\" } will cause the MSBuild to first set the\n     * Configuration property  to Release before evaluating the project\n     * or the project's Target(s).\n     * ```txt\n     *   -property:<n>=<v>  Set or override these project-level properties. <n> is\n     *                      the property name, and <v> is the property value. Use a\n     *                      semicolon or a comma to separate multiple properties, or\n     *                      specify each property separately. (Short form: -p)\n     *                      Example:\n     *                        -property:WarningLevel=2;OutDir=bin\\Debug\\\n     * ```\n     */\n    Property: type({ '[string]': 'string' })\n      .as<{ -readonly [P in keyof MSBuildProjectProperties]: MSBuildProjectProperties[P] }>()\n      .partial(),\n    /**\n     * The MSBuild Targets to run for evaluation. [\"Pack\"] is recommended.\n     * Property values may be changed by Targets such as those provided by\n     * dependencies.\n     *\n     * ```txt\n     *   -target:<targets>  Build these targets in this project. Use a semicolon or a\n     *                      comma to separate multiple targets, or specify each\n     *                      target separately. (Short form: -t)\n     *                      Example:\n     *                        -target:Resources;Compile\n     * ```\n     * @default []\n     */\n    Targets: type.string.array().readonly().or('string[]'),\n    /**\n     * MSBuild Items to evaluate. `[\"Compile\"]` will result in the MSBuild output\n     * including {@link MSBuild}\n     */\n    GetItem: type.string.array().readonly().or('string[]'),\n    GetProperty: type.string.array().readonly().or('string[]'),\n    GetTargetResult: type.string.array().readonly().or('string[]'),\n  }),\n);\n\nexport class MSBuildProject {\n  /**\n   * Properties for multi-targeting `dotnet publish` outputs.\n   * These are included in {@link NPPGetterNames.InstanceGettersRecursive}.\n   */\n  public static readonly MatrixProperties: readonly string[] = Object.freeze([\n    'TargetFramework',\n    'TargetFrameworks',\n    'RuntimeIdentifier',\n    'RuntimeIdentifiers',\n  ]);\n\n  /**\n   * Creates an instance of MSBuildProject.\n   * @param opts The order-independent arguments for this constructor.\n   * Properties may be added or moved around in this definition without\n   * breaking compatibility.\n   * @param opts.fullPath The full path of the MSBuild project's file. This\n   * should have a '.csproj', '.fsproj', or '.vbproj' file extension.\n   * @param opts.projTargets A list of MSBuild Targets supported by the project.\n   * @param opts.evaluation The output of an MSBuild project evaluation. This\n   * comprises MSBuild Properties, Items, and Target results.\n   */\n  public constructor(opts: {\n    fullPath: string;\n    projTargets: string[];\n    evaluation: MSBuildEvaluationOutput;\n  }) {\n    this.Items = opts.evaluation.Items ?? {};\n    this.Properties = new NugetProjectProperties(\n      opts.fullPath,\n      new CaseInsensitiveMap<string, string>(\n        Object.entries(opts.evaluation.Properties ?? {}),\n      ),\n    );\n    this.Targets = opts.projTargets;\n    this.TargetResults\n      = opts.evaluation.TargetResults === undefined\n        ? []\n        : [opts.evaluation.TargetResults];\n  }\n\n  readonly Items: Readonly<Required<MSBuildEvaluationOutput>['Items']>;\n  readonly Properties: Readonly<NugetProjectProperties>;\n  readonly Targets: readonly string[];\n  /**\n   * Allows appending subsequent target results.\n   */\n  readonly TargetResults: Required<MSBuildEvaluationOutput>['TargetResults'][];\n\n  /**\n   * @param projectPath The full path of the project file or its directory. A\n   * relative path may be passed, but will resolve relative to the current\n   * working directory.\n   * @param includeNonPublic Include conventionally internal/private MSBuild\n   * targets in the result.\n   * @returns A string array of the project's MSBuild targets.\n   * @todo consider 'file' of -targets[:file]\n   *  Prints a list of available targets without executing the\n   *  actual build process. By default the output is written to\n   *  the console window. If the path to an output file\n   *  is provided that will be used instead.\n   *  (Short form: -ts)\n   *  Example:\n   *    -ts:out.txt\n   */\n  static async GetTargets(\n    projectPath: string,\n    includeNonPublic = false,\n  ): Promise<string[]> {\n    return execAsync(`dotnet msbuild ${projectPath} -targets`, true)\n      .then((v) => {\n        const targets = v.stdout\n          .split('\\n')\n          .filter((v, index) => v !== '' && index !== 0)\n          .map(v => v.replaceAll('\\r', ''))\n          .sort((a, b) => a.localeCompare(b));\n        return includeNonPublic\n          ? targets\n          : targets.filter(v => !v.startsWith('_'));\n      });\n  }\n\n  /**\n   * Evaluate {@link Items}, {@link Properties}, and {@link TargetResults},\n   * returning them as an instance of {@link MSBuildProject}.\\\n   * Note: MSBuild will probably fail if Restore is skipped and another\n   * target is specified. If you choose Pack, you must do ['Restore', 'Pack'].\n   * @param options The result of {@link EvaluationOptions.from}.\n   * @returns A promised {@link MSBuildProject} instance.\n   * @throws {Error} if the exec command fails -OR- the JSON parse fails -OR-\n   * MSBuildProject's constructor fails.\n   * @see {@link PackableProjectsToMSBuildProjects} for most use-cases.\n   */\n  public static async Evaluate(\n    options: typeof EvaluationOptions.inferOut,\n  ): Promise<MSBuildProject> {\n    if (\n      options.GetProperty.length === 0\n      && options.GetItem.length === 0\n      && options.GetTargetResult.length === 0\n    ) {\n      throw new Error(\n        'No MSBuild Property, Item, or TargetResult queries were provided.',\n      );\n    }\n    // reminder: args containing spaces and semi-colons MUST be quote-enclosed!\n    options.FullName = MSBuildProjectProperties.GetFullPath(options.FullName);\n    const _pairs = Object.entries(options.Property).filter(p => typeof p[1] === 'string');\n    const property\n      = _pairs.length === 0\n        ? ''\n        : `-p:\"${_pairs.map(pair => pair[0] + '=' + pair[1]).join(';')}\"`;\n    const target\n      = options.Targets.length === 0\n        ? ''\n        : `\"-t:${options.Targets.join(';')}\"`;\n    const getItem\n      = options.GetItem.length === 0\n        ? ''\n        : `-getItem:\"${options.GetItem.join(',')}\"`;\n    const getProperty\n      = options.GetProperty.length === 0\n        ? ''\n        : `-getProperty:\"${options.GetProperty.join(',')}\"`;\n    const getTargetResult\n      = options.GetTargetResult.length === 0\n        ? ''\n        : `-getTargetResult:\"${options.GetTargetResult.join(',')}\"`;\n    const cmdLine = [\n      'dotnet',\n      'msbuild',\n      `\"${options.FullName}\"`,\n      '-restore',\n      property,\n      target,\n      getItem,\n      getProperty,\n      getTargetResult,\n    ]\n      .filter(v => v !== '')\n      .join(' ');\n    let stdio: Awaited<ReturnType<typeof execAsync>> | undefined = undefined;\n    // may throw\n    while (stdio === undefined) {\n      stdio = await setTimeout(\n        1000,\n        execAsync(cmdLine, true),\n      )\n        .then(async p => await p)\n        .catch<undefined>(catchEBUSY);\n    }\n\n    // todo: consider -getResultOutputFile:file\n    //  Redirect output from get* into a file.\n    //\n    //  Example:\n    //  -getProperty:Bar -getResultOutputFile:Biz.txt\n    //  This writes the value of property Bar into Biz.txt.\n\n    /**\n     * The following issues have triggered this code path:\n     * - BaseIntermediateOutputPath must use Unix path separators ('/') on all\n     *   platforms. Even Windows. Otherwise, MSBuild/dotnet will error-exit with\n     *   \"The BaseIntermediateOutputPath must end with a trailing slash\".\n     */\n    if (stdio.stdout.startsWith('MSBuild version')) {\n      warn(stdio.stdout);\n      throw new Error(\n        'dotnet msbuild was expected to output JSON, but output its version header instead.',\n      );\n    }\n\n    let rawOutput: ConstructorParameters<typeof MSBuildEvaluationOutput>[0];\n    if (stdio.stdout.startsWith('{')) {\n      /** stdout is JSON string */\n      rawOutput = stdio.stdout;\n    }\n    else if (options.GetProperty.length > 0 && options.GetProperty[0] !== undefined) {\n      rawOutput = {\n        Properties: {\n          [options.GetProperty[0]]: String(JSON.parse(stdio.stdout)),\n        },\n      };\n    }\n    else {\n      throw new Error('Dotnet/MSBuild evaluation output is not a string nor JSON object or array.');\n    }\n\n    const evaluation = new MSBuildEvaluationOutput(rawOutput);\n\n    return new MSBuildProject({\n      fullPath: options.FullName,\n      projTargets: await MSBuildProject.GetTargets(options.FullName),\n      evaluation,\n    });\n  }\n\n  /**\n   * Evaluate multiple project paths with some default Evaluate options.\n   * @async\n   * @param projectsToPackAndPush An array of MSBuild projects' full file\n   * paths. If a path is a directory, files in that directory are filtered for\n   * `.csproj`, `.fsproj`, and `.vbproj` project files.\n   * See https://github.com/dotnet/sdk/blob/497f334b2862bdf98b30c00ede2fd259ea5f624d/src/Cli/dotnet/Commands/New/MSBuildEvaluation/MSBuildEvaluationResult.cs#L19-L32.\\\n   * @returns A promised array of {@link MSBuildProject} instances.\n   * All known MSBuild and NuGet properties are evaluated.\n   * If applicable, a project's \"Pack\" target is evaluated.\n   */\n  public static async PackableProjectsToMSBuildProjects(\n    projectsToPackAndPush: string[],\n  ): Promise<Promise<MSBuildProject>[]> {\n    const dirEntriesPromise = toDirEntries(typeof projectsToPackAndPush === 'string' ? [projectsToPackAndPush] : projectsToPackAndPush);\n    const projectPromises: Promise<MSBuildProject>[] = await dirEntriesPromise\n      .then(\n        (direntArray: Dirent[]) =>\n          direntArray.map(element => convertDirentToMSBuildProject(element)),\n      );\n    return projectPromises;\n\n    /**\n     * Map an array of filesystem paths to {@link Dirent} instances representing project files.\n     * @param projectsToPackAndPush An array of MSBuild projects' full file\n     * paths. If a path is a directory, files in that directory are filtered for\n     * `.csproj`, `.fsproj`, and `.vbproj` project files. See\n     * https://github.com/dotnet/sdk/blob/497f334b2862bdf98b30c00ede2fd259ea5f624d/src/Cli/dotnet/Commands/New/MSBuildEvaluation/MSBuildEvaluationResult.cs#L19-L32.\\\n     * @returns An promised array of Dirent instances for discovered project files.\n     */\n    async function toDirEntries(\n      projectsToPackAndPush: string[],\n    ): Promise<Dirent[]> {\n      const dirEntries: (Dirent | Dirent[])[] = await Promise.all(\n        projectsToPackAndPush.map(async (proj) => {\n          proj = await realpath(makeAbsolute(proj));\n          const stats = await stat(proj);\n          let entries: Dirent[];\n\n          if (stats.isFile()) {\n            entries = await readdir(path.dirname(proj), { withFileTypes: true });\n            const dirent: Dirent | undefined = entries.find(v =>\n              path.join(\n                // condition required for compatibility. `.path` was deprecated, but `.parentPath` is not available in our node minversion\n                ('path' in v ? v.path as string | undefined : undefined) ?? (v as unknown as Omit<typeof v, 'path'> & { parentPath: string }).parentPath,\n                v.name,\n              ) === proj,\n            );\n            if (dirent)\n              return dirent;\n            else\n              throw new Error(\n                `file \"${proj}\" not found. It may have been moved or deleted.`,\n              );\n          }\n          if (!stats.isDirectory())\n            throw new Error(`\"${proj}\" is not a file or directory`);\n\n          entries = await readdir(proj, { withFileTypes: true });\n          return entries.filter(v =>\n            v.isFile()\n            && (v.name.endsWith('.csproj') || v.name.endsWith('.fsproj') || v.name.endsWith('.vbproj')),\n          );\n        }),\n      );\n\n      return dirEntries.flat();\n    }\n\n    /**\n     * Map a {@link Dirent} instance to an {@link MSBuildProject} instance.\n     * @param dirent A {@link Dirent} instance. This instance should be an MSBuild project file.\n     * @returns An instance of {@link MSBuildProject} evaluated with the `Pack` target result, if applicable. Evaluated properties will be those whose names are returned by {@link NPPGetterNames.InstanceGettersRecursive}.\n     */\n    async function convertDirentToMSBuildProject(dirent: Dirent): Promise<MSBuildProject> {\n      const fullPath = path.join(\n        // condition required for compatibility. `.path` was deprecated, but `.parentPath` is not available in our node minversion\n        ('path' in dirent ? dirent.path as string | undefined : undefined) ?? (dirent as unknown as Omit<typeof dirent, 'path'> & { parentPath: string }).parentPath,\n        dirent.name,\n      );\n      const projTargets: Promise<string[]> = MSBuildProject.GetTargets(fullPath);\n      const evalTargets = await projTargets.then(v =>\n        v.includes('Pack') ? ['Pack'] : [],\n      );\n      // this might be too long for a command line. What was it on Windows?\n      // 2^15 (32,768) character limit for command lines?\n      const getProperties = NPPGetterNames.InstanceGettersRecursive;\n\n      return await MSBuildProject.Evaluate(\n        EvaluationOptions.from({\n          FullName: fullPath,\n          GetItem: [],\n          GetProperty: getProperties,\n          GetTargetResult: [],\n          Property: {},\n          Targets: evalTargets,\n        }),\n      );\n    }\n  }\n\n  public static fromJSON(json: string): MSBuildProject {\n    const parsed = T_PseudoMSBPInstance.assert(JSON.parse(json));\n\n    type.true.assert(\n      Reflect.setPrototypeOf(parsed, MSBuildProject.prototype),\n    );\n    type.true.assert(\n      Reflect.setPrototypeOf(parsed.Properties, NugetProjectProperties.prototype),\n    );\n    parsed.Properties = T_NPP.assert(parsed.Properties);\n    return T_MSBuildProject.assert(parsed);\n  }\n}\n\nconst T_MSBuildProject = type.instanceOf(MSBuildProject);\nconst T_NPP = type.instanceOf(NugetProjectProperties);\nconst T_PseudoMSBPInstance = type({\n  Items: type({\n    '[string]': type({\n      '[string]': 'string',\n      Identity: 'string',\n      FullPath: 'string',\n      RootDir: 'string',\n      Filename: 'string',\n      Extension: 'string',\n      RelativeDir: 'string',\n      Directory: 'string',\n      RecursiveDir: 'string',\n      ModifiedTime: 'string',\n      CreatedTime: 'string',\n      AccessedTime: 'string',\n      DefiningProjectFullPath: 'string',\n      DefiningProjectDirectory: 'string',\n      DefiningProjectName: 'string',\n      DefiningProjectExtension: 'string',\n      'SubType?': ' string | undefined',\n      'TargetFrameworkIdentifier?': 'string | undefined',\n      'TargetPlatformMoniker?': 'string | undefined',\n      'CopyUpToDateMarker?': 'string | undefined',\n      'TargetPlatformIdentifier?': 'string | undefined',\n      'TargetFrameworkVersion?': 'string | undefined',\n      'ReferenceAssembly?': 'string | undefined',\n    }).array(),\n  }),\n  Properties: type.Record('string', 'string').or(T_NPP),\n  Targets: type.string.array(),\n  TargetResults: msbuildEvaluationOutput.get('TargetResults').exclude('undefined').array(),\n\n});\n\n/**\n * ArkType type definitions for internal usage, but may be re-used elsewhere\n * @internal\n */\nexport const _InternalMSBuildEvaluationTypes: Scope<{\n  msbuildEvaluationOutput: {\n    Properties?: Record<string, string> | undefined;\n    Items?: Record<string, {\n      [x: string]: string | undefined;\n      Identity: string;\n      FullPath: string;\n      RootDir: string;\n      Filename: string;\n      Extension: string;\n      RelativeDir: string;\n      Directory: string;\n      RecursiveDir: string;\n      ModifiedTime: string;\n      CreatedTime: string;\n      AccessedTime: string;\n      DefiningProjectFullPath: string;\n      DefiningProjectDirectory: string;\n      DefiningProjectName: string;\n      DefiningProjectExtension: string;\n      SubType?: string | undefined;\n      TargetFrameworkIdentifier?: string | undefined;\n      TargetPlatformMoniker?: string | undefined;\n      CopyUpToDateMarker?: string | undefined;\n      TargetPlatformIdentifier?: string | undefined;\n      TargetFrameworkVersion?: string | undefined;\n      ReferenceAssembly?: string | undefined;\n    }[]> | undefined;\n    TargetResults?: Record<string, {\n      Result: 'Success';\n      Items: {\n        [x: string]: string | undefined;\n        Identity: string;\n        FullPath: string;\n        RootDir: string;\n        Filename: string;\n        Extension: string;\n        RelativeDir: string;\n        Directory: string;\n        RecursiveDir: string;\n        ModifiedTime: string;\n        CreatedTime: string;\n        AccessedTime: string;\n        DefiningProjectFullPath: string;\n        DefiningProjectDirectory: string;\n        DefiningProjectName: string;\n        DefiningProjectExtension: string;\n        SubType?: string | undefined;\n        TargetFrameworkIdentifier?: string | undefined;\n        TargetPlatformMoniker?: string | undefined;\n        CopyUpToDateMarker?: string | undefined;\n        TargetPlatformIdentifier?: string | undefined;\n        TargetFrameworkVersion?: string | undefined;\n        ReferenceAssembly?: string | undefined;\n      }[];\n    } | {\n      Result: 'Failure';\n      Items: never[];\n    }> | undefined;\n  };\n}> = type.scope({\n  msbuildEvaluationOutput,\n});\n\n/**\n * Resolve a path if it is not already absolute.\n * @param _path A filesystem path.\n * @returns A full path to a filesystem entry. The path is unchecked for whether or not the path (or its parts) exist.\n */\nfunction makeAbsolute(_path: string) {\n  return path.isAbsolute(_path) ? _path : path.resolve(_path);\n}\n\n/**\n * Use this in your catch statement or .catch call to return `undefined` when\n * a \"file in use by another process\" (i.e. EBUSY/ERROR_SHARING_VIOLATION) error is reported.\n * @param error Probably an Error object\n * @returns `undefined` if file in use by another process\n */\nexport function catchEBUSY(error: unknown): undefined {\n  if (isError(error)) {\n    if ('stderr' in error && typeof error.stderr === 'string') {\n      // Normalize colon-like chars: '\\uFF1A'.normalize('NFKC') === ':' === true;\n      const normalizedStderr = error.stderr.normalize('NFKC');\n      const patternEN = /The process cannot access the file '[^']+' because it is being used by another process\\./gm;\n      const hasErrMsgPattern = patternEN.test(normalizedStderr);\n      const isCS2012 = /^CSC ?:.+CS2012:/gm.test(normalizedStderr);\n      // generic error code; error message must be checked.\n      const isAVLN9999 = /AVLN9999:/gm.test(normalizedStderr)\n        && hasErrMsgPattern;\n      if (isCS2012 || isAVLN9999 || hasErrMsgPattern)\n        return undefined; /* retry */\n    }\n    /**\n     * some known warnings/errors:\n     * - warning MSB3073:\n     *   The command \"dotnet tool list kuinox.nupkgdeterministicator\"\n     *   exited with code 145.\n     *    > $ dotnet tool list kuinox.nupkgdeterministicator\n     *    > The command could not be loaded, possibly because:\n     *    >   * You intended to execute a .NET application:\n     *    >       The application 'tool' does not exist.\n     *    >   * You intended to execute a .NET SDK command:\n     *    >       No .NET SDKs were found.\n     *    >\n     *    > Download a .NET SDK:\n     *    > https://aka.ms/dotnet/download\n     *    >\n     *    > Learn about SDK resolution:\n     *    > https://aka.ms/dotnet/sdk-not-found\n     */\n    else throw error;\n  }\n  else throw new Error('unknown error', { cause: error });\n}\n\n/**\n *\n * Use this in your catch statement or .catch call to return `undefined` when\n * MSBuild error CSC2012 (e.g. \"file in use by another process\") is reported.\n * @param error Probably an Error object\n * @returns `undefined` if CSC2012 (file in use by another process) occurs\n * @deprecated Use {@link catchEBUSY}.\n */\nexport function catchCsc2012(error: unknown): undefined {\n  if (isError(error)) {\n    // check for error reported when \"file in use by another process\" i.e. EBUSY\n    // (UNIX), NTSTATUS.ERROR_SHARING_VIOLATION == 0x20 == 32 (Windows)\n    if ('stderr' in error && typeof error.stderr === 'string'\n      && /^CSC ?:.+CS2012:/gm.test(\n        // '\\uFF1A'.normalize('NFKC') === ':' === true;\n        error.stderr.normalize('NFKC'),\n      )\n    ) {\n      return undefined; /* retry */\n    }\n    /**\n     * some known warnings/errors:\n     * - warning MSB3073:\n     *   The command \"dotnet tool list kuinox.nupkgdeterministicator\"\n     *   exited with code 145.\n     *    > $ dotnet tool list kuinox.nupkgdeterministicator\n     *    > The command could not be loaded, possibly because:\n     *    >   * You intended to execute a .NET application:\n     *    >       The application 'tool' does not exist.\n     *    >   * You intended to execute a .NET SDK command:\n     *    >       No .NET SDKs were found.\n     *    >\n     *    > Download a .NET SDK:\n     *    > https://aka.ms/dotnet/download\n     *    >\n     *    > Learn about SDK resolution:\n     *    > https://aka.ms/dotnet/sdk-not-found\n     */\n    else throw error;\n  }\n  else throw new Error('unknown error', { cause: error });\n}\n"],"mappings":"yhBAoBA,MAAM,EAAgC,EAAK,CACzC,WAAY,SAEZ,SAAU,SAEV,WAAY,SAEZ,6BAA8B,SAC9B,yBAA0B,SAE1B,sBAAuB,SACvB,4BAA6B,SAE7B,0BAA2B,SAE3B,qBAAsB,SAEtB,SAAU,SAEV,QAAS,SAET,SAAU,SAEV,UAAW,SAEX,YAAa,SAEb,UAAW,SACX,aAAc,SAEd,aAAc,SAEd,YAAa,SAEb,aAAc,SAEd,wBAAyB,SAEzB,yBAA0B,SAE1B,oBAAqB,SAErB,yBAA0B,SAC3B,CAAC,CAEI,EAAgB,EAAK,CACzB,OAAQ,YACR,MAAO,EAA8B,OAAO,CAC7C,CAAC,CAEI,EAAgB,EAAK,CACzB,OAAQ,YACR,MAAO,UACR,CAAC,CAEI,EA0DD,EAAK,CACR,cAAe,EAAK,CAAE,WAAY,SAAU,CAAC,CAC7C,SAAU,EAAK,CAAE,WAAY,EAA8B,OAAO,CAAE,CAAC,CACrE,iBAAkB,EAAK,CAAE,WAAY,EAAc,GAAG,EAAc,CAAE,CAAC,CACxE,CAAC,CAEF,IAAa,EAAb,KAAqC,CAKnC,YAAY,EAA6G,CAEvH,IAAM,EAAc,EAAwB,OAAO,OAAO,GAAyB,SAAW,KAAK,MAAM,EAAqB,CAAG,EAAqB,CAEtJ,KAAK,WAAa,EAAY,WAC9B,KAAK,MAAQ,EAAY,MACzB,KAAK,cAAgB,EAAY,cAOnC,WAMA,MAMA,eAGF,MAAa,EAuBR,OAAO,OACV,EAAK,CAIH,SAAU,SAeV,SAAU,EAAK,CAAE,WAAY,SAAU,CAAC,CACrC,IAAsF,CACtF,SAAS,CAeZ,QAAS,EAAK,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,WAAW,CAKtD,QAAS,EAAK,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,WAAW,CACtD,YAAa,EAAK,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,WAAW,CAC1D,gBAAiB,EAAK,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,WAAW,CAC/D,CAAC,CACH,CAED,IAAa,EAAb,MAAa,CAAe,CAK1B,OAAuB,iBAAsC,OAAO,OAAO,CACzE,kBACA,mBACA,oBACA,qBACD,CAAC,CAaF,YAAmB,EAIhB,CACD,KAAK,MAAQ,EAAK,WAAW,OAAS,EAAE,CACxC,KAAK,WAAa,IAAI,EACpB,EAAK,SACL,IAAI,EACF,OAAO,QAAQ,EAAK,WAAW,YAAc,EAAE,CAAC,CACjD,CACF,CACD,KAAK,QAAU,EAAK,YACpB,KAAK,cACD,EAAK,WAAW,gBAAkB,IAAA,GAChC,EAAE,CACF,CAAC,EAAK,WAAW,cAAc,CAGvC,MACA,WACA,QAIA,cAkBA,aAAa,WACX,EACA,EAAmB,GACA,CACnB,OAAO,EAAU,kBAAkB,EAAY,WAAY,GAAK,CAC7D,KAAM,GAAM,CACX,IAAM,EAAU,EAAE,OACf,MAAM;EAAK,CACX,QAAQ,EAAG,IAAU,IAAM,IAAM,IAAU,EAAE,CAC7C,IAAI,GAAK,EAAE,WAAW,KAAM,GAAG,CAAC,CAChC,MAAM,EAAG,IAAM,EAAE,cAAc,EAAE,CAAC,CACrC,OAAO,EACH,EACA,EAAQ,OAAO,GAAK,CAAC,EAAE,WAAW,IAAI,CAAC,EAC3C,CAcN,aAAoB,SAClB,EACyB,CACzB,GACE,EAAQ,YAAY,SAAW,GAC5B,EAAQ,QAAQ,SAAW,GAC3B,EAAQ,gBAAgB,SAAW,EAEtC,MAAU,MACR,oEACD,CAGH,EAAQ,SAAW,EAAyB,YAAY,EAAQ,SAAS,CACzE,IAAM,EAAS,OAAO,QAAQ,EAAQ,SAAS,CAAC,OAAO,GAAK,OAAO,EAAE,IAAO,SAAS,CAC/E,EACF,EAAO,SAAW,EAChB,GACA,OAAO,EAAO,IAAI,GAAQ,EAAK,GAAK,IAAM,EAAK,GAAG,CAAC,KAAK,IAAI,CAAC,GAC7D,EACF,EAAQ,QAAQ,SAAW,EACzB,GACA,OAAO,EAAQ,QAAQ,KAAK,IAAI,CAAC,GACjC,EACF,EAAQ,QAAQ,SAAW,EACzB,GACA,aAAa,EAAQ,QAAQ,KAAK,IAAI,CAAC,GACvC,EACF,EAAQ,YAAY,SAAW,EAC7B,GACA,iBAAiB,EAAQ,YAAY,KAAK,IAAI,CAAC,GAC/C,EACF,EAAQ,gBAAgB,SAAW,EACjC,GACA,qBAAqB,EAAQ,gBAAgB,KAAK,IAAI,CAAC,GACvD,EAAU,CACd,SACA,UACA,IAAI,EAAQ,SAAS,GACrB,WACA,EACA,EACA,EACA,EACA,EACD,CACE,OAAO,GAAK,IAAM,GAAG,CACrB,KAAK,IAAI,CACR,EAEJ,KAAO,IAAU,IAAA,IACf,EAAQ,MAAM,EACZ,IACA,EAAU,EAAS,GAAK,CACzB,CACE,KAAK,KAAM,IAAK,MAAM,EAAE,CACxB,MAAiB,EAAW,CAgBjC,GAAI,EAAM,OAAO,WAAW,kBAAkB,CAE5C,MADA,EAAK,EAAM,OAAO,CACR,MACR,qFACD,CAGH,IAAI,EACJ,GAAI,EAAM,OAAO,WAAW,IAAI,CAE9B,EAAY,EAAM,eAEX,EAAQ,YAAY,OAAS,GAAK,EAAQ,YAAY,KAAO,IAAA,GACpE,EAAY,CACV,WAAY,EACT,EAAQ,YAAY,IAAK,OAAO,KAAK,MAAM,EAAM,OAAO,CAAC,CAC3D,CACF,MAGD,MAAU,MAAM,6EAA6E,CAG/F,IAAM,EAAa,IAAI,EAAwB,EAAU,CAEzD,OAAO,IAAI,EAAe,CACxB,SAAU,EAAQ,SAClB,YAAa,MAAM,EAAe,WAAW,EAAQ,SAAS,CAC9D,aACD,CAAC,CAcJ,aAAoB,kCAClB,EACoC,CAOpC,OALmD,MADzB,EAAa,OAAO,GAA0B,SAAW,CAAC,EAAsB,CAAG,EAAsB,CAEhI,KACE,GACC,EAAY,IAAI,GAAW,EAA8B,EAAQ,CAAC,CACrE,CAWH,eAAe,EACb,EACmB,CAkCnB,OAjC0C,MAAM,QAAQ,IACtD,EAAsB,IAAI,KAAO,IAAS,CACxC,EAAO,MAAM,EAAS,EAAa,EAAK,CAAC,CACzC,IAAM,EAAQ,MAAM,EAAK,EAAK,CAC1B,EAEJ,GAAI,EAAM,QAAQ,CAAE,CAClB,EAAU,MAAM,EAAQ,EAAK,QAAQ,EAAK,CAAE,CAAE,cAAe,GAAM,CAAC,CACpE,IAAM,EAA6B,EAAQ,KAAK,GAC9C,EAAK,MAEF,SAAU,EAAI,EAAE,KAA6B,IAAA,KAAe,EAAiE,WAC9H,EAAE,KACH,GAAK,EACP,CACD,GAAI,EACF,OAAO,EAEP,MAAU,MACR,SAAS,EAAK,iDACf,CAEL,GAAI,CAAC,EAAM,aAAa,CACtB,MAAU,MAAM,IAAI,EAAK,8BAA8B,CAGzD,MADA,GAAU,MAAM,EAAQ,EAAM,CAAE,cAAe,GAAM,CAAC,CAC/C,EAAQ,OAAO,GACpB,EAAE,QAAQ,GACN,EAAE,KAAK,SAAS,UAAU,EAAI,EAAE,KAAK,SAAS,UAAU,EAAI,EAAE,KAAK,SAAS,UAAU,EAC3F,EACD,CACH,EAEiB,MAAM,CAQ1B,eAAe,EAA8B,EAAyC,CACpF,IAAM,EAAW,EAAK,MAEnB,SAAU,EAAS,EAAO,KAA6B,IAAA,KAAe,EAA2E,WAClJ,EAAO,KACR,CAEK,EAAc,MADmB,EAAe,WAAW,EAAS,CACpC,KAAK,GACzC,EAAE,SAAS,OAAO,CAAG,CAAC,OAAO,CAAG,EAAE,CACnC,CAGK,EAAgB,EAAe,yBAErC,OAAO,MAAM,EAAe,SAC1B,EAAkB,KAAK,CACrB,SAAU,EACV,QAAS,EAAE,CACX,YAAa,EACb,gBAAiB,EAAE,CACnB,SAAU,EAAE,CACZ,QAAS,EACV,CAAC,CACH,EAIL,OAAc,SAAS,EAA8B,CACnD,IAAM,EAAS,EAAqB,OAAO,KAAK,MAAM,EAAK,CAAC,CAS5D,OAPA,EAAK,KAAK,OACR,QAAQ,eAAe,EAAQ,EAAe,UAAU,CACzD,CACD,EAAK,KAAK,OACR,QAAQ,eAAe,EAAO,WAAY,EAAuB,UAAU,CAC5E,CACD,EAAO,WAAa,EAAM,OAAO,EAAO,WAAW,CAC5C,EAAiB,OAAO,EAAO,GAI1C,MAAM,EAAmB,EAAK,WAAW,EAAe,CAClD,EAAQ,EAAK,WAAW,EAAuB,CAC/C,EAAuB,EAAK,CAChC,MAAO,EAAK,CACV,WAAY,EAAK,CACf,WAAY,SACZ,SAAU,SACV,SAAU,SACV,QAAS,SACT,SAAU,SACV,UAAW,SACX,YAAa,SACb,UAAW,SACX,aAAc,SACd,aAAc,SACd,YAAa,SACb,aAAc,SACd,wBAAyB,SACzB,yBAA0B,SAC1B,oBAAqB,SACrB,yBAA0B,SAC1B,WAAY,sBACZ,6BAA8B,qBAC9B,yBAA0B,qBAC1B,sBAAuB,qBACvB,4BAA6B,qBAC7B,0BAA2B,qBAC3B,qBAAsB,qBACvB,CAAC,CAAC,OAAO,CACX,CAAC,CACF,WAAY,EAAK,OAAO,SAAU,SAAS,CAAC,GAAG,EAAM,CACrD,QAAS,EAAK,OAAO,OAAO,CAC5B,cAAe,EAAwB,IAAI,gBAAgB,CAAC,QAAQ,YAAY,CAAC,OAAO,CAEzF,CAAC,CAMW,EA4DR,EAAK,MAAM,CACd,0BACD,CAAC,CAOF,SAAS,EAAa,EAAe,CACnC,OAAO,EAAK,WAAW,EAAM,CAAG,EAAQ,EAAK,QAAQ,EAAM,CAS7D,SAAgB,EAAW,EAA2B,CACpD,GAAI,EAAQ,EAAM,CAChB,GAAI,WAAY,GAAS,OAAO,EAAM,QAAW,SAAU,CAEzD,IAAM,EAAmB,EAAM,OAAO,UAAU,OAAO,CAEjD,EADY,6FACiB,KAAK,EAAiB,CACnD,EAAW,qBAAqB,KAAK,EAAiB,CAEtD,EAAa,cAAc,KAAK,EAAiB,EAClD,EACL,GAAI,GAAY,GAAc,EAC5B,YAoBC,MAAM,OAER,MAAU,MAAM,gBAAiB,CAAE,MAAO,EAAO,CAAC,CAWzD,SAAgB,EAAa,EAA2B,CACtD,GAAI,EAAQ,EAAM,CAGhB,IAAI,WAAY,GAAS,OAAO,EAAM,QAAW,UAC5C,qBAAqB,KAEtB,EAAM,OAAO,UAAU,OAAO,CAC/B,CAED,OAoBG,MAAM,OAER,MAAU,MAAM,gBAAiB,CAAE,MAAO,EAAO,CAAC"}
+{"version":3,"file":"MSBuildProject.mjs","names":[],"sources":["../../src/dotnet/MSBuildProject.ts"],"sourcesContent":["import { type, type Scope, type Type } from 'arktype';\nimport { warn } from 'node:console';\nimport { type Dirent } from 'node:fs';\nimport { readdir, realpath, stat } from 'node:fs/promises';\n// eslint-disable-next-line unicorn/import-style\nimport * as path from 'node:path';\nimport { setTimeout } from 'node:timers/promises';\nimport { CaseInsensitiveMap } from '../CaseInsensitiveMap.ts';\nimport { execAsync } from '../utils/execAsync.ts';\nimport { isError } from '../utils/isError.ts';\nimport { MSBuildProjectProperties } from './MSBuildProjectProperties.ts';\nimport {\n  NPPGetterNames,\n  NugetProjectProperties,\n} from './NugetProjectProperties.ts';\n\n/**\n * See [MSBuild well-known item metadata](https://learn.microsoft.com/en-us/visualstudio/msbuild/msbuild-well-known-item-metadata).\n * Additional string-type properties may be present (e.g. `{ SubType: \"designer\" }`).\n */\nconst interface_ItemMetadataBuiltIn = type({\n  '[string]': 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\bin\\\\Debug\\\\net6.0\\\\ConsoleApp1.dll\" */\n  Identity: 'string',\n  /** @example \"Designer\" */\n  'SubType?': 'string',\n  /** @example \".NETCoreApp\" */\n  'TargetFrameworkIdentifier?': 'string',\n  'TargetPlatformMoniker?': 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\obj\\\\Debug\\\\net6.0\\\\ConsoleApp1.csproj.CopyComplete\" */\n  'CopyUpToDateMarker?': 'string',\n  'TargetPlatformIdentifier?': 'string',\n  /** @example \"6.0\" */\n  'TargetFrameworkVersion?': 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\obj\\\\Debug\\\\net6.0\\\\ref\\\\ConsoleApp1.dll\" */\n  'ReferenceAssembly?': 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\bin\\\\Debug\\\\net6.0\\\\ConsoleApp1.dll\" */\n  FullPath: 'string',\n  /** @example \"c:\\\\\" */\n  RootDir: 'string',\n  /** @example \"ConsoleApp1\" */\n  Filename: 'string',\n  /** @example \".dll\" */\n  Extension: 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\bin\\\\Debug\\\\net6.0\\\\\" */\n  RelativeDir: 'string',\n  /** @example \"source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\bin\\\\Debug\\\\net6.0\\\\\" */\n  Directory: 'string',\n  RecursiveDir: 'string',\n  /** @example \"2023-11-30 13:38:06.5084339\" */\n  ModifiedTime: 'string',\n  /** @example \"2023-11-30 13:38:06.9308716\" */\n  CreatedTime: 'string',\n  /** @example \"2023-11-30 13:38:06.9318732\" */\n  AccessedTime: 'string',\n  /** @example \"C:\\\\Program Files\\\\Microsoft Visual Studio\\\\2022\\\\Preview\\\\MSBuild\\\\Current\\\\Bin\\\\amd64\\\\Microsoft.Common.CurrentVersion.targets\" */\n  DefiningProjectFullPath: 'string',\n  /** @example \"C:\\\\Program Files\\\\Microsoft Visual Studio\\\\2022\\\\Preview\\\\MSBuild\\\\Current\\\\Bin\\\\amd64\\\\\" */\n  DefiningProjectDirectory: 'string',\n  /** @example \"Microsoft.Common.CurrentVersion\" */\n  DefiningProjectName: 'string',\n  /** @example \".targets\" */\n  DefiningProjectExtension: 'string',\n});\n\nconst targetSuccess = type({\n  Result: '\\'Success\\'',\n  Items: interface_ItemMetadataBuiltIn.array(),\n});\n\nconst targetFailure = type({\n  Result: '\\'Failure\\'',\n  Items: 'never[]',\n});\n\nconst msbuildEvaluationOutput: Type<{\n  Properties?: Record<string, string> | undefined;\n  Items?: Record<string, {\n    [x: string]: string | undefined;\n    Identity: string;\n    FullPath: string;\n    RootDir: string;\n    Filename: string;\n    Extension: string;\n    RelativeDir: string;\n    Directory: string;\n    RecursiveDir: string;\n    ModifiedTime: string;\n    CreatedTime: string;\n    AccessedTime: string;\n    DefiningProjectFullPath: string;\n    DefiningProjectDirectory: string;\n    DefiningProjectName: string;\n    DefiningProjectExtension: string;\n    SubType?: string;\n    TargetFrameworkIdentifier?: string | undefined;\n    TargetPlatformMoniker?: string | undefined;\n    CopyUpToDateMarker?: string | undefined;\n    TargetPlatformIdentifier?: string | undefined;\n    TargetFrameworkVersion?: string | undefined;\n    ReferenceAssembly?: string | undefined;\n  }[]> | undefined;\n  TargetResults?: Record<string, {\n    Result: 'Success';\n    Items: {\n      [x: string]: string | undefined;\n      Identity: string;\n      FullPath: string;\n      RootDir: string;\n      Filename: string;\n      Extension: string;\n      RelativeDir: string;\n      Directory: string;\n      RecursiveDir: string;\n      ModifiedTime: string;\n      CreatedTime: string;\n      AccessedTime: string;\n      DefiningProjectFullPath: string;\n      DefiningProjectDirectory: string;\n      DefiningProjectName: string;\n      DefiningProjectExtension: string;\n      SubType?: string | undefined;\n      TargetFrameworkIdentifier?: string | undefined;\n      TargetPlatformMoniker?: string | undefined;\n      CopyUpToDateMarker?: string | undefined;\n      TargetPlatformIdentifier?: string | undefined;\n      TargetFrameworkVersion?: string | undefined;\n      ReferenceAssembly?: string | undefined;\n    }[];\n  } | {\n    Result: 'Failure';\n    Items: never[];\n  }> | undefined;\n}> = type({\n  'Properties?': type({ '[string]': 'string' }),\n  'Items?': type({ '[string]': interface_ItemMetadataBuiltIn.array() }),\n  'TargetResults?': type({ '[string]': targetSuccess.or(targetFailure) }),\n});\n\nexport class MSBuildEvaluationOutput {\n  /**\n   * @param rawMSBuildEvaluation The output of a CLI MSBuild project evaluation.\n   * May be the UTF-8 string-encoded JSON or the object decoded from that JSON.\n   */\n  constructor(rawMSBuildEvaluation: Parameters<typeof JSON.parse>[0] | Parameters<typeof msbuildEvaluationOutput.from>[0]) {\n    /** `.assert` instead of `.from` to allow `unknown` JSON.parse return type */\n    const knownObject = msbuildEvaluationOutput.assert(typeof rawMSBuildEvaluation === 'string' ? JSON.parse(rawMSBuildEvaluation) : rawMSBuildEvaluation);\n\n    this.Properties = knownObject.Properties;\n    this.Items = knownObject.Items;\n    this.TargetResults = knownObject.TargetResults;\n  }\n\n  /**\n   * The specified properties and their values as evaluated by MSBuild Core.\n   * `-getProperty:{propertyName,...}`\n   */\n  Properties?: typeof msbuildEvaluationOutput.infer.Properties;\n  /**\n   * The specified items and their values and associated metadata as evaluated\n   * by MSBuild Core.\n   * `-getItem:{itemName,...}`\n   */\n  Items?: typeof msbuildEvaluationOutput.infer.Items;\n  /**\n   * The specified Targets and their output values as evaluated by MSBuild\n   * Core.\n   * `-getTargetResult:{targetName,...}`\n   */\n  TargetResults?: typeof msbuildEvaluationOutput.infer.TargetResults;\n}\n\nexport const EvaluationOptions: Type<{\n  FullName: string;\n  Property: {\n    MSBuildProjectFullPath?: string | undefined;\n    AssemblyName?: string | undefined;\n    BaseIntermediateOutputPath?: string | undefined;\n    BaseOutputPath?: string | undefined;\n    Description?: string | undefined;\n    IntermediateOutput?: string | undefined;\n    OutDir?: string | undefined;\n    OutputPath?: string | undefined;\n    Version?: string | undefined;\n    VersionPrefix?: string | undefined;\n    VersionSuffix?: string | undefined;\n    TargetFramework?: string | undefined;\n    TargetFrameworks?: string | undefined;\n    RuntimeIdentifier?: string | undefined;\n    RuntimeIdentifiers?: string | undefined;\n  };\n  Targets: readonly string[] | string[];\n  GetItem: readonly string[] | string[];\n  GetProperty: readonly string[] | string[];\n  GetTargetResult: readonly string[] | string[];\n}> = Object.freeze(\n  type({\n    /**\n     * The project file's full path.\n     */\n    FullName: 'string',\n    /**\n     * User-defined Properties and their values.\n     * { Configuration: \"Release\" } will cause the MSBuild to first set the\n     * Configuration property  to Release before evaluating the project\n     * or the project's Target(s).\n     * ```txt\n     *   -property:<n>=<v>  Set or override these project-level properties. <n> is\n     *                      the property name, and <v> is the property value. Use a\n     *                      semicolon or a comma to separate multiple properties, or\n     *                      specify each property separately. (Short form: -p)\n     *                      Example:\n     *                        -property:WarningLevel=2;OutDir=bin\\Debug\\\n     * ```\n     */\n    Property: type({ '[string]': 'string' })\n      .as<{ -readonly [P in keyof MSBuildProjectProperties]: MSBuildProjectProperties[P] }>()\n      .partial(),\n    /**\n     * The MSBuild Targets to run for evaluation. [\"Pack\"] is recommended.\n     * Property values may be changed by Targets such as those provided by\n     * dependencies.\n     *\n     * ```txt\n     *   -target:<targets>  Build these targets in this project. Use a semicolon or a\n     *                      comma to separate multiple targets, or specify each\n     *                      target separately. (Short form: -t)\n     *                      Example:\n     *                        -target:Resources;Compile\n     * ```\n     * @default []\n     */\n    Targets: type.string.array().readonly().or('string[]'),\n    /**\n     * MSBuild Items to evaluate. `[\"Compile\"]` will result in the MSBuild output\n     * including {@link MSBuild}\n     */\n    GetItem: type.string.array().readonly().or('string[]'),\n    GetProperty: type.string.array().readonly().or('string[]'),\n    GetTargetResult: type.string.array().readonly().or('string[]'),\n  }),\n);\n\nexport class MSBuildProject {\n  /**\n   * Properties for multi-targeting `dotnet publish` outputs.\n   * These are included in {@link NPPGetterNames.InstanceGettersRecursive}.\n   */\n  public static readonly MatrixProperties: readonly string[] = Object.freeze([\n    'TargetFramework',\n    'TargetFrameworks',\n    'RuntimeIdentifier',\n    'RuntimeIdentifiers',\n  ]);\n\n  /**\n   * Creates an instance of MSBuildProject.\n   * @param opts The order-independent arguments for this constructor.\n   * Properties may be added or moved around in this definition without\n   * breaking compatibility.\n   * @param opts.fullPath The full path of the MSBuild project's file. This\n   * should have a '.csproj', '.fsproj', or '.vbproj' file extension.\n   * @param opts.projTargets A list of MSBuild Targets supported by the project.\n   * @param opts.evaluation The output of an MSBuild project evaluation. This\n   * comprises MSBuild Properties, Items, and Target results.\n   */\n  public constructor(opts: {\n    fullPath: string;\n    projTargets: string[];\n    evaluation: MSBuildEvaluationOutput;\n  }) {\n    this.Items = opts.evaluation.Items ?? {};\n    this.Properties = new NugetProjectProperties(\n      opts.fullPath,\n      new CaseInsensitiveMap<string, string>(\n        Object.entries(opts.evaluation.Properties ?? {}),\n      ),\n    );\n    this.Targets = opts.projTargets;\n    this.TargetResults\n      = opts.evaluation.TargetResults === undefined\n        ? []\n        : [opts.evaluation.TargetResults];\n  }\n\n  readonly Items: Readonly<Required<MSBuildEvaluationOutput>['Items']>;\n  readonly Properties: Readonly<NugetProjectProperties>;\n  readonly Targets: readonly string[];\n  /**\n   * Allows appending subsequent target results.\n   */\n  readonly TargetResults: Required<MSBuildEvaluationOutput>['TargetResults'][];\n\n  /**\n   * @param projectPath The full path of the project file or its directory. A\n   * relative path may be passed, but will resolve relative to the current\n   * working directory.\n   * @param includeNonPublic Include conventionally internal/private MSBuild\n   * targets in the result.\n   * @returns A string array of the project's MSBuild targets.\n   * @todo consider 'file' of -targets[:file]\n   *  Prints a list of available targets without executing the\n   *  actual build process. By default the output is written to\n   *  the console window. If the path to an output file\n   *  is provided that will be used instead.\n   *  (Short form: -ts)\n   *  Example:\n   *    -ts:out.txt\n   */\n  static async GetTargets(\n    projectPath: string,\n    includeNonPublic = false,\n  ): Promise<string[]> {\n    return execAsync(`dotnet msbuild ${projectPath} -targets`, true)\n      .then((v) => {\n        const targets = v.stdout\n          .split('\\n')\n          .filter((v, index) => v !== '' && index !== 0)\n          .map(v => v.replaceAll('\\r', ''))\n          .sort((a, b) => a.localeCompare(b));\n        return includeNonPublic\n          ? targets\n          : targets.filter(v => !v.startsWith('_'));\n      });\n  }\n\n  /**\n   * Evaluate {@link Items}, {@link Properties}, and {@link TargetResults},\n   * returning them as an instance of {@link MSBuildProject}.\\\n   * Note: MSBuild will probably fail if Restore is skipped and another\n   * target is specified. If you choose Pack, you must do ['Restore', 'Pack'].\n   * @param options The result of {@link EvaluationOptions.from}.\n   * @returns A promised {@link MSBuildProject} instance.\n   * @throws {Error} if the exec command fails -OR- the JSON parse fails -OR-\n   * MSBuildProject's constructor fails.\n   * @see {@link PackableProjectsToMSBuildProjects} for most use-cases.\n   */\n  public static async Evaluate(\n    options: typeof EvaluationOptions.inferOut,\n  ): Promise<MSBuildProject> {\n    if (\n      options.GetProperty.length === 0\n      && options.GetItem.length === 0\n      && options.GetTargetResult.length === 0\n    ) {\n      throw new Error(\n        'No MSBuild Property, Item, or TargetResult queries were provided.',\n      );\n    }\n    // reminder: args containing spaces and semi-colons MUST be quote-enclosed!\n    options.FullName = MSBuildProjectProperties.GetFullPath(options.FullName);\n    const _pairs = Object.entries(options.Property).filter(p => typeof p[1] === 'string');\n    const property\n      = _pairs.length === 0\n        ? ''\n        : `-p:\"${_pairs.map(pair => pair[0] + '=' + pair[1]).join(';')}\"`;\n    const target\n      = options.Targets.length === 0\n        ? ''\n        : `\"-t:${options.Targets.join(';')}\"`;\n    const getItem\n      = options.GetItem.length === 0\n        ? ''\n        : `-getItem:\"${options.GetItem.join(',')}\"`;\n    const getProperty\n      = options.GetProperty.length === 0\n        ? ''\n        : `-getProperty:\"${options.GetProperty.join(',')}\"`;\n    const getTargetResult\n      = options.GetTargetResult.length === 0\n        ? ''\n        : `-getTargetResult:\"${options.GetTargetResult.join(',')}\"`;\n    const cmdLine = [\n      'dotnet',\n      'msbuild',\n      `\"${options.FullName}\"`,\n      '-restore',\n      property,\n      target,\n      getItem,\n      getProperty,\n      getTargetResult,\n    ]\n      .filter(v => v !== '')\n      .join(' ');\n    let stdio: Awaited<ReturnType<typeof execAsync>> | undefined = undefined;\n    // may throw\n    while (stdio === undefined) {\n      stdio = await setTimeout(\n        1000,\n        execAsync(cmdLine, true),\n      )\n        .then(async p => await p)\n        .catch<undefined>(catchEBUSY);\n    }\n\n    // todo: consider -getResultOutputFile:file\n    //  Redirect output from get* into a file.\n    //\n    //  Example:\n    //  -getProperty:Bar -getResultOutputFile:Biz.txt\n    //  This writes the value of property Bar into Biz.txt.\n\n    /**\n     * The following issues have triggered this code path:\n     * - BaseIntermediateOutputPath must use Unix path separators ('/') on all\n     *   platforms. Even Windows. Otherwise, MSBuild/dotnet will error-exit with\n     *   \"The BaseIntermediateOutputPath must end with a trailing slash\".\n     */\n    if (stdio.stdout.startsWith('MSBuild version')) {\n      warn(stdio.stdout);\n      throw new Error(\n        'dotnet msbuild was expected to output JSON, but output its version header instead.',\n      );\n    }\n\n    let rawOutput: ConstructorParameters<typeof MSBuildEvaluationOutput>[0];\n    if (stdio.stdout.startsWith('{')) {\n      /** stdout is JSON string */\n      rawOutput = stdio.stdout;\n    }\n    else if (options.GetProperty.length > 0 && options.GetProperty[0] !== undefined) {\n      rawOutput = {\n        Properties: {\n          [options.GetProperty[0]]: String(JSON.parse(stdio.stdout)),\n        },\n      };\n    }\n    else {\n      throw new Error('Dotnet/MSBuild evaluation output is not a string nor JSON object or array.');\n    }\n\n    const evaluation = new MSBuildEvaluationOutput(rawOutput);\n\n    return new MSBuildProject({\n      fullPath: options.FullName,\n      projTargets: await MSBuildProject.GetTargets(options.FullName),\n      evaluation,\n    });\n  }\n\n  /**\n   * Evaluate multiple project paths with some default Evaluate options.\n   * @async\n   * @param projectsToPackAndPush An array of MSBuild projects' full file\n   * paths. If a path is a directory, files in that directory are filtered for\n   * `.csproj`, `.fsproj`, and `.vbproj` project files.\n   * See https://github.com/dotnet/sdk/blob/497f334b2862bdf98b30c00ede2fd259ea5f624d/src/Cli/dotnet/Commands/New/MSBuildEvaluation/MSBuildEvaluationResult.cs#L19-L32.\\\n   * @returns A promised array of {@link MSBuildProject} instances.\n   * All known MSBuild and NuGet properties are evaluated.\n   * If applicable, a project's \"Pack\" target is evaluated.\n   */\n  public static async PackableProjectsToMSBuildProjects(\n    projectsToPackAndPush: string[],\n  ): Promise<Promise<MSBuildProject>[]> {\n    const dirEntriesPromise = toDirEntries(typeof projectsToPackAndPush === 'string' ? [projectsToPackAndPush] : projectsToPackAndPush);\n    const projectPromises: Promise<MSBuildProject>[] = await dirEntriesPromise\n      .then(\n        (direntArray: Dirent[]) =>\n          direntArray.map(element => convertDirentToMSBuildProject(element)),\n      );\n    return projectPromises;\n\n    /**\n     * Map an array of filesystem paths to {@link Dirent} instances representing project files.\n     * @param projectsToPackAndPush An array of MSBuild projects' full file\n     * paths. If a path is a directory, files in that directory are filtered for\n     * `.csproj`, `.fsproj`, and `.vbproj` project files. See\n     * https://github.com/dotnet/sdk/blob/497f334b2862bdf98b30c00ede2fd259ea5f624d/src/Cli/dotnet/Commands/New/MSBuildEvaluation/MSBuildEvaluationResult.cs#L19-L32.\\\n     * @returns An promised array of Dirent instances for discovered project files.\n     */\n    async function toDirEntries(\n      projectsToPackAndPush: string[],\n    ): Promise<Dirent[]> {\n      const dirEntries: (Dirent | Dirent[])[] = await Promise.all(\n        projectsToPackAndPush.map(async (proj) => {\n          proj = await realpath(makeAbsolute(proj));\n          const stats = await stat(proj);\n          let entries: Dirent[];\n\n          if (stats.isFile()) {\n            entries = await readdir(path.dirname(proj), { withFileTypes: true });\n            const dirent: Dirent | undefined = entries.find(v =>\n              path.join(\n                // condition required for compatibility. `.path` was deprecated, but `.parentPath` is not available in our node minversion\n                ('path' in v ? v.path as string | undefined : undefined) ?? (v as unknown as Omit<typeof v, 'path'> & { parentPath: string }).parentPath,\n                v.name,\n              ) === proj,\n            );\n            if (dirent)\n              return dirent;\n            else\n              throw new Error(\n                `file \"${proj}\" not found. It may have been moved or deleted.`,\n              );\n          }\n          if (!stats.isDirectory())\n            throw new Error(`\"${proj}\" is not a file or directory`);\n\n          entries = await readdir(proj, { withFileTypes: true });\n          return entries.filter(v =>\n            v.isFile()\n            && (v.name.endsWith('.csproj') || v.name.endsWith('.fsproj') || v.name.endsWith('.vbproj')),\n          );\n        }),\n      );\n\n      return dirEntries.flat();\n    }\n\n    /**\n     * Map a {@link Dirent} instance to an {@link MSBuildProject} instance.\n     * @param dirent A {@link Dirent} instance. This instance should be an MSBuild project file.\n     * @returns An instance of {@link MSBuildProject} evaluated with the `Pack` target result, if applicable. Evaluated properties will be those whose names are returned by {@link NPPGetterNames.InstanceGettersRecursive}.\n     */\n    async function convertDirentToMSBuildProject(dirent: Dirent): Promise<MSBuildProject> {\n      const fullPath = path.join(\n        // condition required for compatibility. `.path` was deprecated, but `.parentPath` is not available in our node minversion\n        ('path' in dirent ? dirent.path as string | undefined : undefined) ?? (dirent as unknown as Omit<typeof dirent, 'path'> & { parentPath: string }).parentPath,\n        dirent.name,\n      );\n      const projTargets: Promise<string[]> = MSBuildProject.GetTargets(fullPath);\n      const evalTargets = await projTargets.then(v =>\n        v.includes('Pack') ? ['Pack'] : [],\n      );\n      // this might be too long for a command line. What was it on Windows?\n      // 2^15 (32,768) character limit for command lines?\n      const getProperties = NPPGetterNames.InstanceGettersRecursive;\n\n      return await MSBuildProject.Evaluate(\n        EvaluationOptions.from({\n          FullName: fullPath,\n          GetItem: [],\n          GetProperty: getProperties,\n          GetTargetResult: [],\n          Property: {},\n          Targets: evalTargets,\n        }),\n      );\n    }\n  }\n\n  public static fromJSON(json: string): MSBuildProject {\n    const parsed = T_PseudoMSBPInstance.assert(JSON.parse(json));\n\n    type.true.assert(\n      Reflect.setPrototypeOf(parsed, MSBuildProject.prototype),\n    );\n    type.true.assert(\n      Reflect.setPrototypeOf(parsed.Properties, NugetProjectProperties.prototype),\n    );\n    parsed.Properties = T_NPP.assert(parsed.Properties);\n    return T_MSBuildProject.assert(parsed);\n  }\n}\n\nconst T_MSBuildProject = type.instanceOf(MSBuildProject);\nconst T_NPP = type.instanceOf(NugetProjectProperties);\nconst T_PseudoMSBPInstance = type({\n  Items: type({\n    '[string]': type({\n      '[string]': 'string',\n      Identity: 'string',\n      FullPath: 'string',\n      RootDir: 'string',\n      Filename: 'string',\n      Extension: 'string',\n      RelativeDir: 'string',\n      Directory: 'string',\n      RecursiveDir: 'string',\n      ModifiedTime: 'string',\n      CreatedTime: 'string',\n      AccessedTime: 'string',\n      DefiningProjectFullPath: 'string',\n      DefiningProjectDirectory: 'string',\n      DefiningProjectName: 'string',\n      DefiningProjectExtension: 'string',\n      'SubType?': ' string | undefined',\n      'TargetFrameworkIdentifier?': 'string | undefined',\n      'TargetPlatformMoniker?': 'string | undefined',\n      'CopyUpToDateMarker?': 'string | undefined',\n      'TargetPlatformIdentifier?': 'string | undefined',\n      'TargetFrameworkVersion?': 'string | undefined',\n      'ReferenceAssembly?': 'string | undefined',\n    }).array(),\n  }),\n  Properties: type.Record('string', 'string').or(T_NPP),\n  Targets: type.string.array(),\n  TargetResults: msbuildEvaluationOutput.get('TargetResults').exclude('undefined').array(),\n\n});\n\n/**\n * ArkType type definitions for internal usage, but may be re-used elsewhere\n * @internal\n */\nexport const _InternalMSBuildEvaluationTypes: Scope<{\n  msbuildEvaluationOutput: {\n    Properties?: Record<string, string> | undefined;\n    Items?: Record<string, {\n      [x: string]: string | undefined;\n      Identity: string;\n      FullPath: string;\n      RootDir: string;\n      Filename: string;\n      Extension: string;\n      RelativeDir: string;\n      Directory: string;\n      RecursiveDir: string;\n      ModifiedTime: string;\n      CreatedTime: string;\n      AccessedTime: string;\n      DefiningProjectFullPath: string;\n      DefiningProjectDirectory: string;\n      DefiningProjectName: string;\n      DefiningProjectExtension: string;\n      SubType?: string | undefined;\n      TargetFrameworkIdentifier?: string | undefined;\n      TargetPlatformMoniker?: string | undefined;\n      CopyUpToDateMarker?: string | undefined;\n      TargetPlatformIdentifier?: string | undefined;\n      TargetFrameworkVersion?: string | undefined;\n      ReferenceAssembly?: string | undefined;\n    }[]> | undefined;\n    TargetResults?: Record<string, {\n      Result: 'Success';\n      Items: {\n        [x: string]: string | undefined;\n        Identity: string;\n        FullPath: string;\n        RootDir: string;\n        Filename: string;\n        Extension: string;\n        RelativeDir: string;\n        Directory: string;\n        RecursiveDir: string;\n        ModifiedTime: string;\n        CreatedTime: string;\n        AccessedTime: string;\n        DefiningProjectFullPath: string;\n        DefiningProjectDirectory: string;\n        DefiningProjectName: string;\n        DefiningProjectExtension: string;\n        SubType?: string | undefined;\n        TargetFrameworkIdentifier?: string | undefined;\n        TargetPlatformMoniker?: string | undefined;\n        CopyUpToDateMarker?: string | undefined;\n        TargetPlatformIdentifier?: string | undefined;\n        TargetFrameworkVersion?: string | undefined;\n        ReferenceAssembly?: string | undefined;\n      }[];\n    } | {\n      Result: 'Failure';\n      Items: never[];\n    }> | undefined;\n  };\n}> = type.scope({\n  msbuildEvaluationOutput,\n});\n\n/**\n * Resolve a path if it is not already absolute.\n * @param _path A filesystem path.\n * @returns A full path to a filesystem entry. The path is unchecked for whether or not the path (or its parts) exist.\n */\nfunction makeAbsolute(_path: string) {\n  return path.isAbsolute(_path) ? _path : path.resolve(_path);\n}\n\n/**\n * Use this in your catch statement or .catch call to return `undefined` when\n * a \"file in use by another process\" (i.e. EBUSY/ERROR_SHARING_VIOLATION) error is reported.\n * @param error Probably an Error object\n * @returns `undefined` if file in use by another process\n */\nexport function catchEBUSY(error: unknown): undefined {\n  if (isError(error)) {\n    if ('stderr' in error && typeof error.stderr === 'string') {\n      // Normalize colon-like chars: '\\uFF1A'.normalize('NFKC') === ':' === true;\n      const normalizedStderr = error.stderr.normalize('NFKC');\n      const patternEN = /The process cannot access the file '[^']+' because it is being used by another process\\./gm;\n      const hasErrMsgPattern = patternEN.test(normalizedStderr);\n      const isCS2012 = /^CSC ?:.+CS2012:/gm.test(normalizedStderr);\n      // generic error code; error message must be checked.\n      const isAVLN9999 = /AVLN9999:/gm.test(normalizedStderr)\n        && hasErrMsgPattern;\n      if (isCS2012 || isAVLN9999 || hasErrMsgPattern)\n        return undefined; /* retry */\n    }\n    /**\n     * some known warnings/errors:\n     * - warning MSB3073:\n     *   The command \"dotnet tool list kuinox.nupkgdeterministicator\"\n     *   exited with code 145.\n     *    > $ dotnet tool list kuinox.nupkgdeterministicator\n     *    > The command could not be loaded, possibly because:\n     *    >   * You intended to execute a .NET application:\n     *    >       The application 'tool' does not exist.\n     *    >   * You intended to execute a .NET SDK command:\n     *    >       No .NET SDKs were found.\n     *    >\n     *    > Download a .NET SDK:\n     *    > https://aka.ms/dotnet/download\n     *    >\n     *    > Learn about SDK resolution:\n     *    > https://aka.ms/dotnet/sdk-not-found\n     */\n    else throw error;\n  }\n  else throw new Error('unknown error', { cause: error });\n}\n\n/**\n *\n * Use this in your catch statement or .catch call to return `undefined` when\n * MSBuild error CSC2012 (e.g. \"file in use by another process\") is reported.\n * @param error Probably an Error object\n * @returns `undefined` if CSC2012 (file in use by another process) occurs\n * @deprecated Use {@link catchEBUSY}.\n */\nexport function catchCsc2012(error: unknown): undefined {\n  if (isError(error)) {\n    // check for error reported when \"file in use by another process\" i.e. EBUSY\n    // (UNIX), NTSTATUS.ERROR_SHARING_VIOLATION == 0x20 == 32 (Windows)\n    if ('stderr' in error && typeof error.stderr === 'string'\n      && /^CSC ?:.+CS2012:/gm.test(\n        // '\\uFF1A'.normalize('NFKC') === ':' === true;\n        error.stderr.normalize('NFKC'),\n      )\n    ) {\n      return undefined; /* retry */\n    }\n    /**\n     * some known warnings/errors:\n     * - warning MSB3073:\n     *   The command \"dotnet tool list kuinox.nupkgdeterministicator\"\n     *   exited with code 145.\n     *    > $ dotnet tool list kuinox.nupkgdeterministicator\n     *    > The command could not be loaded, possibly because:\n     *    >   * You intended to execute a .NET application:\n     *    >       The application 'tool' does not exist.\n     *    >   * You intended to execute a .NET SDK command:\n     *    >       No .NET SDKs were found.\n     *    >\n     *    > Download a .NET SDK:\n     *    > https://aka.ms/dotnet/download\n     *    >\n     *    > Learn about SDK resolution:\n     *    > https://aka.ms/dotnet/sdk-not-found\n     */\n    else throw error;\n  }\n  else throw new Error('unknown error', { cause: error });\n}\n"],"mappings":"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"}