@halospv3/hce.shared-config 3.4.7-develop.1 → 3.4.8-develop.1

package/mjs/semanticReleaseConfigDotnet.mjs

@@ -1,7 +1,224 @@
-import{baseConfig as e}from"./semanticReleaseConfig.mjs";import t from"./debug.mjs";import{MSBuildProject as n}from"./dotnet/MSBuildProject.mjs";import{getEnvVarValue as r}from"./utils/env.mjs";import{NugetRegistryInfo as i}from"./dotnet/NugetRegistryInfo.mjs";import{configureDotnetNugetPush as a,configurePrepareCmd as o}from"./dotnet/helpers.mjs";import{insertPlugin as s}from"./insertPlugins.mjs";import{inspect as c}from"node:util";import*as l from"node:console";var u=class{options;_projectsToPublish;_projectsToPackAndPush;_evaluatedProjects;constructor(a,o){if(this.options=e,this.options.plugins=this.options.plugins.map(e=>typeof e==`string`?[e,{}]:e),this._projectsToPublish=a,this._projectsToPublish.length===0){let e=r(`PROJECTS_TO_PUBLISH`)?.split(`;`);e&&e.length>0?this._projectsToPublish=e:t.enabled&&t(Error("At least one project must be published. `projectsToPackAndPush` is empty and environment variable `PROJECTS_TO_PUBLISH` is undefined or empty."))}if(this._projectsToPackAndPush=o,this._projectsToPackAndPush.length===0){let e=r(`PROJECTS_TO_PACK_AND_PUSH`)?.split(`;`);e&&e.length>0?this._projectsToPackAndPush=e:t.enabled&&t(Error(`projectsToPackAndPush.length must be > 0 or PROJECTS_TO_PACK_AND_PUSH must be defined and contain at least one path.`))}this._evaluatedProjects=[...this._projectsToPublish.filter(e=>e instanceof n),...this._projectsToPackAndPush.filter(e=>e instanceof i).map(e=>e.project)]}get ProjectsToPublish(){return this._projectsToPublish}get ProjectsToPackAndPush(){return this._projectsToPackAndPush}get EvaluatedProjects(){return this._evaluatedProjects}insertPlugin(e,t,n){this.options.plugins=s(this.options.plugins,e,t,n)}async setupDotnetCommands(){let e=this.options.plugins.findIndex(e=>e[0]===`@semantic-release/exec`);e===-1&&(l.warn("Unable to find`['@semantic-release/exec', unknown]` in plugins array!\nAppending it to the end of the array...This may cause an unexpected order of operations!"),e=this.options.plugins.push([`@semantic-release/exec`,{}])-1);let t=this.options.plugins[e][1];this._projectsToPackAndPush=await Promise.all(this._projectsToPackAndPush.map(async e=>{if(typeof e==`string`){let t=await Promise.all(await n.PackableProjectsToMSBuildProjects([e]));if(t.length===0)throw Error(`No MSBuildProject instances were returned!`);return this._evaluatedProjects.push(...t),t.map(e=>new i({project:e}))}else return[e]})).then(e=>e.flat());let r=await Promise.all(this._projectsToPackAndPush.map(async e=>await e.PackDummyPackage({}).then(()=>e.GetPushDummyCommand({})))).then(e=>e.join(` && `));t.verifyConditionsCmd=t.verifyConditionsCmd&&t.verifyConditionsCmd.trim().length>0?`${t.verifyConditionsCmd} && ${r}`:r;let s=this.ProjectsToPackAndPush.filter(e=>typeof e!=`string`).map(e=>e.GetIsNextVersionAlreadyPublishedCommand()).join(` && `);t.verifyReleaseCmd=t.verifyReleaseCmd&&t.verifyReleaseCmd.trim().length>0?`${t.verifyReleaseCmd} && ${s}`:r;let c=await o(this._projectsToPublish,this._projectsToPackAndPush);if(t.prepareCmd=t.prepareCmd&&t.prepareCmd.trim().length>0?`${t.prepareCmd} && ${c}`:c,this._projectsToPackAndPush.length>0){let e=a(this._projectsToPackAndPush);t.publishCmd=t.publishCmd&&t.publishCmd.trim().length>0?`${t.publishCmd} && ${e}`:e}}splicePlugin(e,t,n){let r=[],i=this.options.plugins.map(e=>typeof e==`string`?e:e[0]),a=e.filter(e=>i.includes(e)).map(e=>i.indexOf(e)).sort().find((e,t,n)=>t===n.length-1);if(!a)throw ReferenceError(`An attempt to get the last element of indexOfLastAfter returned undefined.`);let o=n.filter(e=>i.includes(e)).map(e=>i.indexOf(e)).sort();for(let s of o)if(s<=a){let o=`[`+t.map(e=>`"${e}"`).join(`, `)+`]`,c=`[`+e.map(e=>`"${e}"`).join(`, `)+`]`,l=`[`+n.map(e=>`"${e}"`).join(`, `)+`]`;r.push(Error(`insertPlugin was instructed to insert ${o} after ${c} and before ${l}, but ${JSON.stringify(i[a])} is ordered after ${JSON.stringify(i[s])}!`))}if(r.length>0)throw AggregateError(r,`One or more errors occurred while splicing plugin-option tuples into the Semantic Release config!`);this.options.plugins.splice(a+1,0,...t.map(e=>[e,{}]))}async getTokenTestingCommands(){let e=this.ProjectsToPackAndPush.every(e=>e instanceof i)?this.ProjectsToPackAndPush.map(e=>e.project):await Promise.all(await n.PackableProjectsToMSBuildProjects(this.ProjectsToPackAndPush));for(let t of e)this.EvaluatedProjects.includes(t)||this.EvaluatedProjects.push(t);let t=e.map(e=>new i({project:e}));return(await Promise.all(t.map(e=>e.PackDummyPackage({}).then(t=>{let n=t.find(e=>new RegExp(/(?<!symbols)\.nupkg$/).test(e));if(n!==void 0)return{nri:e,nupkgPath:n};throw Error(`None of the following dummy packages are non-symbol .nupkg files:
-`+t.map(e=>`  - ${e}`).join(`
-`)+`
-If you intended to push only symbol packages, check if a feature request already exists (https://github.com/HaloSPV3/HCE.Shared/issues?q=push+snupkg) and, if one does not exist, create one containing the keywords "push snupkg".`)})))).map(e=>e.nri.GetPushDummyCommand({})).join(` && `)}toOptions(){return this.options}};async function d(n,i){t.enabled&&t(`hce.shared-config:
-`+c(e,!1,1/0,!0));let a=[];if(n.length===0){let e=r(`PROJECTS_TO_PUBLISH`);e===void 0?a.push(Error(`projectsToPublish.length must be > 0 or PROJECTS_TO_PUBLISH must be defined and contain at least one path.`)):n=e.split(`;`)}if(!i){let e=r(`PROJECTS_TO_PACK_AND_PUSH`);e===void 0?a.push(Error(`projectsToPackAndPush.length must be > 0 or PROJECTS_TO_PACK_AND_PUSH must be defined and contain at least one path.`)):i=e.split(`;`)}if(a.length>0)throw Error([`getConfig cannot continue. One or more errors occurred.`,...a.map(e=>e.stack)].join(`
-`));let o=new u(n,i??[]);await o.setupDotnetCommands();let s=o.toOptions();return t.enabled&&(t(`modified plugins array:`),t(c(s.plugins,!1,1/0))),s}export{u as SemanticReleaseConfigDotnet,d as getConfig};
+import { baseConfig } from "./semanticReleaseConfig.mjs";
+import _debug from "./debug.mjs";
+import { MSBuildProject } from "./dotnet/MSBuildProject.mjs";
+import { getEnvVarValue } from "./utils/env.mjs";
+import { NugetRegistryInfo } from "./dotnet/NugetRegistryInfo.mjs";
+import { configureDotnetNugetPush, configurePrepareCmd } from "./dotnet/helpers.mjs";
+import { insertPlugin } from "./insertPlugins.mjs";
+import { inspect } from "node:util";
+import * as console from "node:console";
+//#region src/semanticReleaseConfigDotnet.ts
+/**
+* # Semantic-Release Config Factory (dotnet)
+* A functional Semantic-Release configuration for dotnet projects
+*
+* extends {@link baseConfig }
+*
+* <-- TABLE OF CONTENTS -->
+*
+* EASY: {@link getConfig}
+* Just provide the paths of the project file(s) and keep your API tokens ready.
+* ADVANCED: {@link SemanticReleaseConfigDotnet}
+* Allows for a hands-on customization if {@link getConfig} doesn't meet your needs.
+* Use a copy of {@link getConfig} as the starting point of a new function and make changes from there.
+*   - {@link SemanticReleaseConfigDotnet#splicePlugin splicePlugin (insert/edit plugins)}
+*   - {@link SemanticReleaseConfigDotnet#setupDotnetCommands setupDotnetCommands}
+*   - {@link SemanticReleaseConfigDotnet#getTokenTestingCommands getTokenTestingCommands}
+*/
+var SemanticReleaseConfigDotnet = class {
+	options;
+	_projectsToPublish;
+	_projectsToPackAndPush;
+	_evaluatedProjects;
+	/**
+	* Creates an instance of SemanticReleaseConfigDotnet.
+	* Configures {@link baseConfig} with `@semantic-release/exec` to `dotnet` publish, pack, and push.
+	*
+	* Note: To sign packages, create a Target in the corresponding project(s) e.g.
+	* ```xml
+	* <Target Name="SignNupkgs" AfterTargets="Pack">
+	*   <Exec Command="dotnet nuget sign $(PackageOutputPath) [remaining args]" ConsoleToMsBuild="true" />
+	* </Target>
+	* ```
+	* Alternatively, splice your signing commands into the publishCmd string,
+	* inserting them before `dotnet nuget push`.
+	* If you sign different signatures depending on the NuGet registry,
+	* splice your signing command (with "overwrite signature" enabled, if
+	* desired) before the corresponding registry's `dotnet nuget push` command.
+	* @param projectsToPublish An array of dotnet projects' relative paths. If
+	* empty or unspecified, tries getting projects' semi-colon-separated relative
+	* paths from the `PROJECTS_TO_PUBLISH` environment variable. If configured as
+	* recommended, the projects' publish outputs will be zipped to '$PWD/publish'
+	* for use in the `publish` semantic-release step (typically, GitHub release).
+	* @param projectsToPackAndPush An array of dotnet projects' relative paths.
+	* If empty or unspecified, tries getting projects' semi-colon-separated
+	* relative paths from the `PROJECTS_TO_PACK_AND_PUSH` environment variable.
+	* Otherwise, no packages will be packed and pushed.
+	* If configured as recommended, `dotnet pack` will output the nupkg/snupkg
+	* files to `$PWD/publish` where they will be globbed by `dotnet nuget push`.
+	*/
+	constructor(projectsToPublish, projectsToPackAndPush) {
+		this.options = baseConfig;
+		this.options.plugins = this.options.plugins.map((pluginSpec) => typeof pluginSpec === "string" ? [pluginSpec, {}] : pluginSpec);
+		this._projectsToPublish = projectsToPublish;
+		if (this._projectsToPublish.length === 0) {
+			const p = getEnvVarValue("PROJECTS_TO_PUBLISH")?.split(";");
+			if (p && p.length > 0) this._projectsToPublish = p;
+			else if (_debug.enabled) _debug(/* @__PURE__ */ new Error("At least one project must be published. `projectsToPackAndPush` is empty and environment variable `PROJECTS_TO_PUBLISH` is undefined or empty."));
+		}
+		this._projectsToPackAndPush = projectsToPackAndPush;
+		if (this._projectsToPackAndPush.length === 0) {
+			const p = getEnvVarValue("PROJECTS_TO_PACK_AND_PUSH")?.split(";");
+			if (p && p.length > 0) this._projectsToPackAndPush = p;
+			else if (_debug.enabled) _debug(/* @__PURE__ */ new Error("projectsToPackAndPush.length must be > 0 or PROJECTS_TO_PACK_AND_PUSH must be defined and contain at least one path."));
+		}
+		this._evaluatedProjects = [...this._projectsToPublish.filter((v) => v instanceof MSBuildProject), ...this._projectsToPackAndPush.filter((v) => v instanceof NugetRegistryInfo).map((v) => v.project)];
+	}
+	get ProjectsToPublish() {
+		return this._projectsToPublish;
+	}
+	get ProjectsToPackAndPush() {
+		return this._projectsToPackAndPush;
+	}
+	get EvaluatedProjects() {
+		return this._evaluatedProjects;
+	}
+	/** @deprecated Superseded by {@link splicePlugin} */
+	insertPlugin(afterPluginsIDs, insertPluginIDs, beforePluginsIDs) {
+		this.options.plugins = insertPlugin(this.options.plugins, afterPluginsIDs, insertPluginIDs, beforePluginsIDs);
+	}
+	/**
+	* generate dotnet commands for \@semantic-release/exec, appending commands with ' && ' when necessary.
+	*
+	* Note: All strings in {@link this.ProjectsToPackAndPush} will be converted to basic {@link NugetRegistryInfo} instances with default values.
+	* If you need specific NRI settings or you need to push to GitLab-like or GitHub-like registries, instantiate them instead of passing their paths.
+	* @todo change to builder method? e.g. static async SetupDotnetCommands(this: SemanticReleaseConfigDotnet): Promise<SemanticReleaseConfigDotnet>
+	* @todo Add options param to allow users to enable pushing to GitLab, GitHub, NuGet.org with default settings -OR- with entirely custom settings.
+	* @see https://github.com/semantic-release/exec#usage
+	*/
+	async setupDotnetCommands() {
+		let srExecIndex = this.options.plugins.findIndex((v) => v[0] === "@semantic-release/exec");
+		if (srExecIndex === -1) {
+			console.warn(`\
+Unable to find\`['@semantic-release/exec', unknown]\` in plugins array!
+Appending it to the end of the array...This may cause an unexpected order of operations!`);
+			srExecIndex = this.options.plugins.push(["@semantic-release/exec", {}]) - 1;
+		}
+		const execOptions = this.options.plugins[srExecIndex][1];
+		this._projectsToPackAndPush = await Promise.all(this._projectsToPackAndPush.map(async (project) => {
+			if (typeof project === "string") {
+				const packableProjects = await Promise.all(await MSBuildProject.PackableProjectsToMSBuildProjects([project]));
+				if (packableProjects.length === 0) throw new Error("No MSBuildProject instances were returned!");
+				this._evaluatedProjects.push(...packableProjects);
+				return packableProjects.map((project) => new NugetRegistryInfo({ project }));
+			} else return [project];
+		})).then((p) => p.flat());
+		const verifyConditionsCmdAppendix = await Promise.all(this._projectsToPackAndPush.map(async (project) => await project.PackDummyPackage({}).then(() => project.GetPushDummyCommand({})))).then((cmds) => cmds.join(" && "));
+		execOptions.verifyConditionsCmd = execOptions.verifyConditionsCmd && execOptions.verifyConditionsCmd.trim().length > 0 ? `${execOptions.verifyConditionsCmd} && ${verifyConditionsCmdAppendix}` : verifyConditionsCmdAppendix;
+		const verifyReleaseCmdAppendix = this.ProjectsToPackAndPush.filter((project) => typeof project !== "string").map((project) => project.GetIsNextVersionAlreadyPublishedCommand()).join(" && ");
+		execOptions.verifyReleaseCmd = execOptions.verifyReleaseCmd && execOptions.verifyReleaseCmd.trim().length > 0 ? `${execOptions.verifyReleaseCmd} && ${verifyReleaseCmdAppendix}` : verifyConditionsCmdAppendix;
+		const prepareCmdAppendix = await configurePrepareCmd(this._projectsToPublish, this._projectsToPackAndPush);
+		execOptions.prepareCmd = execOptions.prepareCmd && execOptions.prepareCmd.trim().length > 0 ? `${execOptions.prepareCmd} && ${prepareCmdAppendix}` : prepareCmdAppendix;
+		if (this._projectsToPackAndPush.length > 0) {
+			const publishCmdAppendix = configureDotnetNugetPush(this._projectsToPackAndPush);
+			execOptions.publishCmd = execOptions.publishCmd && execOptions.publishCmd.trim().length > 0 ? `${execOptions.publishCmd} && ${publishCmdAppendix}` : publishCmdAppendix;
+		}
+	}
+	/**
+	* Insert a plugin into the plugins array.
+	* @param insertAfterPluginIDs Plugins which should appear BEFORE
+	* {@link insertPluginIDs}.
+	* @param insertPluginIDs The plugin(s) to insert into the plugins array.
+	* @param insertBeforePluginsIDs plugins which should appear AFTER the
+	* inserted plugin(s).
+	*/
+	splicePlugin(insertAfterPluginIDs, insertPluginIDs, insertBeforePluginsIDs) {
+		const errors = [];
+		const pluginIDs = this.options.plugins.map((v) => typeof v === "string" ? v : v[0]);
+		const indexOfLastPreceding = insertAfterPluginIDs.filter((v) => pluginIDs.includes(v)).map((v) => pluginIDs.indexOf(v)).sort().find((_v, i, obj) => i === obj.length - 1);
+		if (!indexOfLastPreceding) throw new ReferenceError("An attempt to get the last element of indexOfLastAfter returned undefined.");
+		const indicesOfBefore = insertBeforePluginsIDs.filter((v) => pluginIDs.includes(v)).map((v) => pluginIDs.indexOf(v)).sort();
+		for (const index of indicesOfBefore) if (index <= indexOfLastPreceding) {
+			const formattedInsertIds = "[" + insertPluginIDs.map((v) => `"${v}"`).join(", ") + "]";
+			const formattedAfterIds = "[" + insertAfterPluginIDs.map((v) => `"${v}"`).join(", ") + "]";
+			const formattedBeforeIds = "[" + insertBeforePluginsIDs.map((v) => `"${v}"`).join(", ") + "]";
+			errors.push(/* @__PURE__ */ new Error(`insertPlugin was instructed to insert ${formattedInsertIds} after ${formattedAfterIds} and before ${formattedBeforeIds}, but ${JSON.stringify(pluginIDs[indexOfLastPreceding])} is ordered after ${JSON.stringify(pluginIDs[index])}!`));
+		}
+		if (errors.length > 0) throw new AggregateError(errors, "One or more errors occurred while splicing plugin-option tuples into the Semantic Release config!");
+		this.options.plugins.splice(indexOfLastPreceding + 1, 0, ...insertPluginIDs.map((v) => [v, {}]));
+	}
+	async getTokenTestingCommands() {
+		const promiseProjects = this.ProjectsToPackAndPush.every((nri) => nri instanceof NugetRegistryInfo) ? this.ProjectsToPackAndPush.map((nri) => nri.project) : await Promise.all(await MSBuildProject.PackableProjectsToMSBuildProjects(this.ProjectsToPackAndPush));
+		/** if a project is not in {@link EvaluatedProjects}, add it */
+		for (const project of promiseProjects) if (!this.EvaluatedProjects.includes(project)) this.EvaluatedProjects.push(project);
+		const regInfos = promiseProjects.map((p) => new NugetRegistryInfo({ project: p }));
+		return (await Promise.all(regInfos.map((nri) => nri.PackDummyPackage({}).then((nupkgs) => {
+			const mainNupkg = nupkgs.find((nupkg) => (/* @__PURE__ */ new RegExp(/(?<!symbols)\.nupkg$/)).test(nupkg));
+			if (mainNupkg !== void 0) return {
+				nri,
+				nupkgPath: mainNupkg
+			};
+			throw new Error("None of the following dummy packages are non-symbol .nupkg files:\n" + nupkgs.map((nupkg) => `  - ${nupkg}`).join("\n") + "\nIf you intended to push only symbol packages, check if a feature request already exists (https://github.com/HaloSPV3/HCE.Shared/issues?q=push+snupkg) and, if one does not exist, create one containing the keywords \"push snupkg\".");
+		})))).map((pair) => pair.nri.GetPushDummyCommand({})).join(" && ");
+	}
+	toOptions() {
+		return this.options;
+	}
+};
+/**
+* Configures {@link baseConfig} with `@semantic-release/exec` to `dotnet`
+* publish, pack, and nuget-push.
+* @param projectsToPublish
+* An array of dotnet projects' relative paths -OR- an array of
+* {@link MSBuildProject} instances.
+* - If `MSBuildProject[]`, the instances will be used as-is.
+* - If `[]`, tries getting projects' semi-colon-separated relative paths from
+*   the `PROJECTS_TO_PUBLISH` environment variable.
+* - If configured as recommended, the projects' publish outputs will be zipped
+*   to '$PWD/publish' for use in the `publish` semantic-release step e.g. for a
+*   GitHub release.
+* @param projectsToPackAndPush An array of dotnet projects' relative paths -OR-
+* an array of instances of {@link NugetRegistryInfo} and/or derived classes.
+* - If `NugetRegistryInfo[]`, no conversions or modifications will occur.
+* - If `string[]`, the project paths will be converted to
+* {@link NugetRegistryInfo} instances with default values. This may be undesired.
+* - If `[]`, `dotnet pack` and `dotnet nuget push` commands will not be configured.
+* - If `undefined`, tries getting projects' semi-colon-separated relative paths
+* from the `PROJECTS_TO_PACK_AND_PUSH` environment variable.
+* With the recommended configuration, `dotnet pack` will write the nupkg/snupkg
+* files to `$PWD/publish` where they will be globbed by `dotnet nuget push`.
+* @returns a semantic-release Options object, based on
+* `@halospv3/hce.shared-config` (our base config), with the
+* `@semantic-release/exec` plugin configured to `dotnet publish`, `pack`, and
+* `push` the specified projects.
+*/
+async function getConfig(projectsToPublish, projectsToPackAndPush) {
+	if (_debug.enabled) _debug("hce.shared-config:\n" + inspect(baseConfig, false, Infinity, true));
+	const errors = [];
+	if (projectsToPublish.length === 0) {
+		const _ = getEnvVarValue("PROJECTS_TO_PUBLISH");
+		if (_ === void 0) errors.push(/* @__PURE__ */ new Error("projectsToPublish.length must be > 0 or PROJECTS_TO_PUBLISH must be defined and contain at least one path."));
+		else projectsToPublish = _.split(";");
+	}
+	if (!projectsToPackAndPush) {
+		const _ = getEnvVarValue("PROJECTS_TO_PACK_AND_PUSH");
+		if (_ === void 0) errors.push(/* @__PURE__ */ new Error("projectsToPackAndPush.length must be > 0 or PROJECTS_TO_PACK_AND_PUSH must be defined and contain at least one path."));
+		else projectsToPackAndPush = _.split(";");
+	}
+	if (errors.length > 0) throw new Error(["getConfig cannot continue. One or more errors occurred.", ...errors.map((v) => v.stack)].join("\n"));
+	const config = new SemanticReleaseConfigDotnet(projectsToPublish, projectsToPackAndPush ?? []);
+	await config.setupDotnetCommands();
+	const options = config.toOptions();
+	if (_debug.enabled) {
+		_debug("modified plugins array:");
+		_debug(inspect(options.plugins, false, Infinity));
+	}
+	return options;
+}
+/**
+* @module semanticReleaseConfigDotnet
+*/
+//#endregion
+export { SemanticReleaseConfigDotnet, getConfig };
+
 //# sourceMappingURL=semanticReleaseConfigDotnet.mjs.map

package/mjs/semanticReleaseConfigDotnet.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"semanticReleaseConfigDotnet.mjs","names":["debug"],"sources":["../src/semanticReleaseConfigDotnet.ts"],"sourcesContent":["/**\n * # Semantic-Release Config Factory (dotnet)\n * A functional Semantic-Release configuration for dotnet projects\n *\n * extends {@link baseConfig }\n *\n * <-- TABLE OF CONTENTS -->\n *\n * EASY: {@link getConfig}\n * Just provide the paths of the project file(s) and keep your API tokens ready.\n * ADVANCED: {@link SemanticReleaseConfigDotnet}\n * Allows for a hands-on customization if {@link getConfig} doesn't meet your needs.\n * Use a copy of {@link getConfig} as the starting point of a new function and make changes from there.\n *   - {@link SemanticReleaseConfigDotnet#splicePlugin splicePlugin (insert/edit plugins)}\n *   - {@link SemanticReleaseConfigDotnet#setupDotnetCommands setupDotnetCommands}\n *   - {@link SemanticReleaseConfigDotnet#getTokenTestingCommands getTokenTestingCommands}\n */\n\nimport { inspect } from 'node:util';\nimport type { Options } from 'semantic-release';\n// @ts-types=\"./semantic-release__exec.d.ts\"\nimport type { Options as SRExecOptions } from '@semantic-release/exec';\nimport * as console from 'node:console';\nimport debug from './debug.ts';\nimport { configureDotnetNugetPush, configurePrepareCmd } from './dotnet/helpers.ts';\nimport { getEnvVarValue } from './utils/env.ts';\nimport { baseConfig } from './semanticReleaseConfig.ts';\nimport { NugetRegistryInfo } from './dotnet/NugetRegistryInfo.ts';\nimport { MSBuildProject } from './dotnet/MSBuildProject.ts';\nimport { insertPlugin } from './insertPlugins.ts';\n\ntype UnArray<T> = T extends (infer U)[] ? U : T;\ninterface SRConfigDotnetOptions extends Omit<typeof baseConfig, 'plugins'> {\n  plugins: (UnArray<typeof baseConfig.plugins> | [string, unknown])[];\n}\n\nexport class SemanticReleaseConfigDotnet {\n  private readonly options: SRConfigDotnetOptions;\n  private readonly _projectsToPublish: string[] | MSBuildProject[];\n  private _projectsToPackAndPush: string[] | NugetRegistryInfo[];\n  private readonly _evaluatedProjects: MSBuildProject[];\n\n  /**\n   * Creates an instance of SemanticReleaseConfigDotnet.\n   * Configures {@link baseConfig} with `@semantic-release/exec` to `dotnet` publish, pack, and push.\n   *\n   * Note: To sign packages, create a Target in the corresponding project(s) e.g.\n   * ```xml\n   * <Target Name=\"SignNupkgs\" AfterTargets=\"Pack\">\n   *   <Exec Command=\"dotnet nuget sign $(PackageOutputPath) [remaining args]\" ConsoleToMsBuild=\"true\" />\n   * </Target>\n   * ```\n   * Alternatively, splice your signing commands into the publishCmd string,\n   * inserting them before `dotnet nuget push`.\n   * If you sign different signatures depending on the NuGet registry,\n   * splice your signing command (with \"overwrite signature\" enabled, if\n   * desired) before the corresponding registry's `dotnet nuget push` command.\n   * @param projectsToPublish An array of dotnet projects' relative paths. If\n   * empty or unspecified, tries getting projects' semi-colon-separated relative\n   * paths from the `PROJECTS_TO_PUBLISH` environment variable. If configured as\n   * recommended, the projects' publish outputs will be zipped to '$PWD/publish'\n   * for use in the `publish` semantic-release step (typically, GitHub release).\n   * @param projectsToPackAndPush An array of dotnet projects' relative paths.\n   * If empty or unspecified, tries getting projects' semi-colon-separated\n   * relative paths from the `PROJECTS_TO_PACK_AND_PUSH` environment variable.\n   * Otherwise, no packages will be packed and pushed.\n   * If configured as recommended, `dotnet pack` will output the nupkg/snupkg\n   * files to `$PWD/publish` where they will be globbed by `dotnet nuget push`.\n   */\n  constructor(\n    projectsToPublish: string[] | MSBuildProject[],\n    projectsToPackAndPush: string[] | NugetRegistryInfo[],\n  ) {\n    this.options = baseConfig;\n    /* normalize PluginSpecs to tuples */\n    this.options.plugins = this.options.plugins.map(pluginSpec => typeof pluginSpec === 'string'\n      ? [pluginSpec, {}]\n      : pluginSpec,\n    );\n\n    this._projectsToPublish = projectsToPublish;\n    if (this._projectsToPublish.length === 0) {\n      const p = getEnvVarValue('PROJECTS_TO_PUBLISH')?.split(';');\n      if (p && p.length > 0) {\n        this._projectsToPublish = p;\n      }\n      else if (debug.enabled) {\n        debug(new Error('At least one project must be published. `projectsToPackAndPush` is empty and environment variable `PROJECTS_TO_PUBLISH` is undefined or empty.'));\n      }\n    }\n\n    this._projectsToPackAndPush = projectsToPackAndPush;\n    if (this._projectsToPackAndPush.length === 0) {\n      const p = getEnvVarValue('PROJECTS_TO_PACK_AND_PUSH')?.split(';');\n      if (p && p.length > 0) {\n        this._projectsToPackAndPush = p;\n      }\n      else if (debug.enabled) {\n        debug(new Error('projectsToPackAndPush.length must be > 0 or PROJECTS_TO_PACK_AND_PUSH must be defined and contain at least one path.'));\n      }\n    }\n\n    // may be zero-length array\n    this._evaluatedProjects = [\n      ...this._projectsToPublish.filter(v => v instanceof MSBuildProject),\n      ...this._projectsToPackAndPush\n        .filter(v => v instanceof NugetRegistryInfo)\n        .map(v => v.project),\n    ];\n  }\n\n  get ProjectsToPublish(): string[] | MSBuildProject[] {\n    return this._projectsToPublish;\n  }\n\n  get ProjectsToPackAndPush(): string[] | NugetRegistryInfo[] {\n    return this._projectsToPackAndPush;\n  }\n\n  get EvaluatedProjects(): MSBuildProject[] {\n    return this._evaluatedProjects;\n  }\n\n  // eslint-disable-next-line jsdoc/require-param\n  /** @deprecated Superseded by {@link splicePlugin} */\n  insertPlugin(\n    afterPluginsIDs: string[],\n    insertPluginIDs: string[],\n    beforePluginsIDs: string[],\n  ): void {\n    this.options.plugins = insertPlugin(this.options.plugins, afterPluginsIDs, insertPluginIDs, beforePluginsIDs);\n  }\n\n  /**\n   * generate dotnet commands for \\@semantic-release/exec, appending commands with ' && ' when necessary.\n   *\n   * Note: All strings in {@link this.ProjectsToPackAndPush} will be converted to basic {@link NugetRegistryInfo} instances with default values.\n   * If you need specific NRI settings or you need to push to GitLab-like or GitHub-like registries, instantiate them instead of passing their paths.\n   * @todo change to builder method? e.g. static async SetupDotnetCommands(this: SemanticReleaseConfigDotnet): Promise<SemanticReleaseConfigDotnet>\n   * @todo Add options param to allow users to enable pushing to GitLab, GitHub, NuGet.org with default settings -OR- with entirely custom settings.\n   * @see https://github.com/semantic-release/exec#usage\n   */\n  async setupDotnetCommands(): Promise<void> {\n    let srExecIndex = this.options.plugins.findIndex(\n      v => v[0] === '@semantic-release/exec',\n    );\n    if (srExecIndex === -1) {\n      const message = `\\\nUnable to find\\`['@semantic-release/exec', unknown]\\` in plugins array!\nAppending it to the end of the array...This may cause an unexpected order of operations!`;\n      console.warn(message);\n      srExecIndex = this.options.plugins.push(['@semantic-release/exec', {}]) - 1;\n    }\n\n    const plugin = this.options.plugins[srExecIndex] as ['@semantic-release/exec', SRExecOptions];\n    const execOptions: SRExecOptions = plugin[1];\n\n    // ensure all packable projects are evaluated\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion\n    this._projectsToPackAndPush = await Promise.all(\n      this._projectsToPackAndPush.map(async (project) => {\n        if (typeof project === 'string') {\n          const packableProjects = await Promise.all(\n            await MSBuildProject.PackableProjectsToMSBuildProjects(\n              [project],\n            ),\n          );\n          if (packableProjects.length === 0)\n            throw new Error('No MSBuildProject instances were returned!');\n          this._evaluatedProjects.push(...packableProjects);\n\n          // if the user doesn't want a defaulted NRI, they should pass their own NRI (or derived) instance.\n          return packableProjects.map(project => new NugetRegistryInfo({ project }));\n        }\n        else return [project];\n      }),\n    ).then(p => p.flat()) as NugetRegistryInfo[];\n\n    // todo: double-check token-testing commands. Are they formatted prepended correctly?\n    const verifyConditionsCmdAppendix = await Promise.all(\n      this._projectsToPackAndPush\n        .map(async project =>\n          await project.PackDummyPackage({})\n            .then(() =>\n              project.GetPushDummyCommand({}),\n            ),\n        ),\n    ).then(cmds =>\n      cmds.join(' && '),\n    );\n    execOptions.verifyConditionsCmd\n      = execOptions.verifyConditionsCmd && execOptions.verifyConditionsCmd.trim().length > 0\n        ? `${execOptions.verifyConditionsCmd} && ${verifyConditionsCmdAppendix}`\n        : verifyConditionsCmdAppendix;\n\n    const verifyReleaseCmdAppendix\n      = this.ProjectsToPackAndPush\n        .filter(project =>\n          typeof project !== 'string',\n        ).map(project =>\n          project.GetIsNextVersionAlreadyPublishedCommand(),\n        ).join(' && ');\n    execOptions.verifyReleaseCmd\n      = execOptions.verifyReleaseCmd && execOptions.verifyReleaseCmd.trim().length > 0\n        ? `${execOptions.verifyReleaseCmd} && ${verifyReleaseCmdAppendix}`\n        : verifyConditionsCmdAppendix;\n\n    const prepareCmdAppendix = await configurePrepareCmd(\n      this._projectsToPublish,\n      this._projectsToPackAndPush,\n    );\n\n    // 'ZipPublishDir' zips each publish folder to ./publish/*.zip\n    execOptions.prepareCmd\n      = execOptions.prepareCmd && execOptions.prepareCmd.trim().length > 0\n        ? `${execOptions.prepareCmd} && ${prepareCmdAppendix}`\n        : prepareCmdAppendix;\n\n    // FINISHED execOptions.prepareCmd\n    // STARTING execOptions.publishCmd\n    if (this._projectsToPackAndPush.length > 0) {\n      const publishCmdAppendix: string = configureDotnetNugetPush(\n        this._projectsToPackAndPush,\n      );\n      execOptions.publishCmd\n        = execOptions.publishCmd && execOptions.publishCmd.trim().length > 0\n          ? `${execOptions.publishCmd} && ${publishCmdAppendix}`\n          : publishCmdAppendix;\n    }\n\n    // FINISHED execOptions.publishCmd\n  }\n\n  /**\n   * Insert a plugin into the plugins array.\n   * @param insertAfterPluginIDs Plugins which should appear BEFORE\n   * {@link insertPluginIDs}.\n   * @param insertPluginIDs The plugin(s) to insert into the plugins array.\n   * @param insertBeforePluginsIDs plugins which should appear AFTER the\n   * inserted plugin(s).\n   */\n  splicePlugin(\n    insertAfterPluginIDs: string[],\n    insertPluginIDs: string[],\n    insertBeforePluginsIDs: string[],\n  ): void {\n    const errors: Error[] = [];\n    const pluginIDs = this.options.plugins.map(v =>\n      typeof v === 'string' ? v : v[0],\n    ) as (typeof this.options.plugins[number])[][0];\n\n    // if any beforePluginIDs are ordered before the last afterPlugin, throw. Impossible to sort.\n\n    const indexOfLastPreceding: number | undefined = insertAfterPluginIDs\n      .filter(v => pluginIDs.includes(v))\n      .map(v => pluginIDs.indexOf(v))\n      .sort()\n      .find((_v, i, obj) => i === obj.length - 1);\n    if (!indexOfLastPreceding)\n      throw new ReferenceError(\n        'An attempt to get the last element of indexOfLastAfter returned undefined.',\n      );\n\n    const indicesOfBefore: number[] = insertBeforePluginsIDs\n      .filter(v => pluginIDs.includes(v))\n      .map(v => pluginIDs.indexOf(v))\n      .sort();\n\n    for (const index of indicesOfBefore) {\n      if (index <= indexOfLastPreceding) {\n        const formattedInsertIds: string\n          = '[' + insertPluginIDs.map(v => `\"${v}\"`).join(', ') + ']';\n        const formattedAfterIds: string\n          = '[' + insertAfterPluginIDs.map(v => `\"${v}\"`).join(', ') + ']';\n        const formattedBeforeIds: string\n          = '[' + insertBeforePluginsIDs.map(v => `\"${v}\"`).join(', ') + ']';\n        errors.push(\n          new Error(\n            `insertPlugin was instructed to insert ${formattedInsertIds} after ${formattedAfterIds} and before ${formattedBeforeIds}, `\n            + `but ${JSON.stringify(pluginIDs[indexOfLastPreceding])} is ordered after ${JSON.stringify(pluginIDs[index])}!`,\n          ),\n        );\n      }\n    }\n\n    if (errors.length > 0)\n      throw new AggregateError(errors, 'One or more errors occurred while splicing plugin-option tuples into the Semantic Release config!');\n\n    this.options.plugins.splice(\n      indexOfLastPreceding + 1,\n      0,\n      ...insertPluginIDs.map(v => [v, {}] satisfies [string, unknown]),\n    );\n  }\n\n  // todo: join result with dummy pack commands\n  protected async getTokenTestingCommands(): Promise<string> {\n    const promiseProjects = this.ProjectsToPackAndPush.every(nri => nri instanceof NugetRegistryInfo)\n      ? this.ProjectsToPackAndPush.map(nri => nri.project)\n      : await Promise.all(await MSBuildProject.PackableProjectsToMSBuildProjects(this.ProjectsToPackAndPush));\n\n    /** if a project is not in {@link EvaluatedProjects}, add it */\n    for (const project of promiseProjects) {\n      if (!this.EvaluatedProjects.includes(project))\n        this.EvaluatedProjects.push(project);\n    }\n\n    const regInfos = promiseProjects.map(\n      p => new NugetRegistryInfo({ project: p }),\n    );\n    const nupkgPaths = await Promise.all(\n      regInfos.map(nri =>\n        nri.PackDummyPackage({}).then((nupkgs) => {\n          // this is a full file path.\n          const mainNupkg = nupkgs.find(nupkg =>\n            new RegExp(/(?<!symbols)\\.nupkg$/).test(nupkg),\n          );\n          if (mainNupkg !== undefined)\n            return { nri: nri, nupkgPath: mainNupkg } as const;\n          throw new Error(\n            'None of the following dummy packages are non-symbol .nupkg files:\\n'\n            + nupkgs.map(nupkg => `  - ${nupkg}`).join('\\n')\n            + '\\nIf you intended to push only symbol packages, check if a feature request already exists (https://github.com/HaloSPV3/HCE.Shared/issues?q=push+snupkg) and, if one does not exist, create one containing the keywords \"push snupkg\".',\n          );\n        }),\n      ),\n    );\n    const pushCommands = nupkgPaths.map(pair =>\n      pair.nri.GetPushDummyCommand({}),\n    );\n    return pushCommands.join(' && ');\n  }\n\n  toOptions(): Options {\n    return this.options;\n  }\n}\n\n/**\n * Configures {@link baseConfig} with `@semantic-release/exec` to `dotnet`\n * publish, pack, and nuget-push.\n * @param projectsToPublish\n * An array of dotnet projects' relative paths -OR- an array of\n * {@link MSBuildProject} instances.\n * - If `MSBuildProject[]`, the instances will be used as-is.\n * - If `[]`, tries getting projects' semi-colon-separated relative paths from\n *   the `PROJECTS_TO_PUBLISH` environment variable.\n * - If configured as recommended, the projects' publish outputs will be zipped\n *   to '$PWD/publish' for use in the `publish` semantic-release step e.g. for a\n *   GitHub release.\n * @param projectsToPackAndPush An array of dotnet projects' relative paths -OR-\n * an array of instances of {@link NugetRegistryInfo} and/or derived classes.\n * - If `NugetRegistryInfo[]`, no conversions or modifications will occur.\n * - If `string[]`, the project paths will be converted to\n * {@link NugetRegistryInfo} instances with default values. This may be undesired.\n * - If `[]`, `dotnet pack` and `dotnet nuget push` commands will not be configured.\n * - If `undefined`, tries getting projects' semi-colon-separated relative paths\n * from the `PROJECTS_TO_PACK_AND_PUSH` environment variable.\n * With the recommended configuration, `dotnet pack` will write the nupkg/snupkg\n * files to `$PWD/publish` where they will be globbed by `dotnet nuget push`.\n * @returns a semantic-release Options object, based on\n * `@halospv3/hce.shared-config` (our base config), with the\n * `@semantic-release/exec` plugin configured to `dotnet publish`, `pack`, and\n * `push` the specified projects.\n */\nexport async function getConfig(\n  projectsToPublish: string[] | MSBuildProject[],\n  projectsToPackAndPush?: string[] | NugetRegistryInfo[],\n): Promise<Options> {\n  if (debug.enabled) {\n    debug(\n      'hce.shared-config:\\n' + inspect(baseConfig, false, Infinity, true),\n    );\n  }\n\n  const errors: Error[] = [];\n\n  if (projectsToPublish.length === 0) {\n    const _ = getEnvVarValue('PROJECTS_TO_PUBLISH');\n    if (_ === undefined)\n      errors.push(\n        new Error(\n          'projectsToPublish.length must be > 0 or PROJECTS_TO_PUBLISH must be defined and contain at least one path.',\n        ),\n      );\n    else projectsToPublish = _.split(';');\n  }\n\n  if (!projectsToPackAndPush) {\n    const _ = getEnvVarValue('PROJECTS_TO_PACK_AND_PUSH');\n    if (_ === undefined)\n      errors.push(\n        new Error(\n          'projectsToPackAndPush.length must be > 0 or PROJECTS_TO_PACK_AND_PUSH must be defined and contain at least one path.',\n        ),\n      );\n    else projectsToPackAndPush = _.split(';');\n  }\n\n  if (errors.length > 0) {\n    throw new Error(\n      [\n        'getConfig cannot continue. One or more errors occurred.',\n        ...errors.map(v => v.stack),\n      ].join('\\n'),\n    );\n  }\n\n  const config = new SemanticReleaseConfigDotnet(\n    projectsToPublish,\n    projectsToPackAndPush ?? [],\n  );\n  await config.setupDotnetCommands();\n\n  const options: Options = config.toOptions();\n  if (debug.enabled) {\n    debug('modified plugins array:');\n    debug(inspect(options.plugins, false, Infinity));\n  }\n\n  return options;\n}\n\n/**\n * @module semanticReleaseConfigDotnet\n */\n"],"mappings":"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"}
+{"version":3,"file":"semanticReleaseConfigDotnet.mjs","names":["debug"],"sources":["../src/semanticReleaseConfigDotnet.ts"],"sourcesContent":["/**\n * # Semantic-Release Config Factory (dotnet)\n * A functional Semantic-Release configuration for dotnet projects\n *\n * extends {@link baseConfig }\n *\n * <-- TABLE OF CONTENTS -->\n *\n * EASY: {@link getConfig}\n * Just provide the paths of the project file(s) and keep your API tokens ready.\n * ADVANCED: {@link SemanticReleaseConfigDotnet}\n * Allows for a hands-on customization if {@link getConfig} doesn't meet your needs.\n * Use a copy of {@link getConfig} as the starting point of a new function and make changes from there.\n *   - {@link SemanticReleaseConfigDotnet#splicePlugin splicePlugin (insert/edit plugins)}\n *   - {@link SemanticReleaseConfigDotnet#setupDotnetCommands setupDotnetCommands}\n *   - {@link SemanticReleaseConfigDotnet#getTokenTestingCommands getTokenTestingCommands}\n */\n\nimport { inspect } from 'node:util';\nimport type { Options } from 'semantic-release';\n// @ts-types=\"./semantic-release__exec.d.ts\"\nimport type { Options as SRExecOptions } from '@semantic-release/exec';\nimport * as console from 'node:console';\nimport debug from './debug.ts';\nimport { configureDotnetNugetPush, configurePrepareCmd } from './dotnet/helpers.ts';\nimport { getEnvVarValue } from './utils/env.ts';\nimport { baseConfig } from './semanticReleaseConfig.ts';\nimport { NugetRegistryInfo } from './dotnet/NugetRegistryInfo.ts';\nimport { MSBuildProject } from './dotnet/MSBuildProject.ts';\nimport { insertPlugin } from './insertPlugins.ts';\n\ntype UnArray<T> = T extends (infer U)[] ? U : T;\ninterface SRConfigDotnetOptions extends Omit<typeof baseConfig, 'plugins'> {\n  plugins: (UnArray<typeof baseConfig.plugins> | [string, unknown])[];\n}\n\nexport class SemanticReleaseConfigDotnet {\n  private readonly options: SRConfigDotnetOptions;\n  private readonly _projectsToPublish: string[] | MSBuildProject[];\n  private _projectsToPackAndPush: string[] | NugetRegistryInfo[];\n  private readonly _evaluatedProjects: MSBuildProject[];\n\n  /**\n   * Creates an instance of SemanticReleaseConfigDotnet.\n   * Configures {@link baseConfig} with `@semantic-release/exec` to `dotnet` publish, pack, and push.\n   *\n   * Note: To sign packages, create a Target in the corresponding project(s) e.g.\n   * ```xml\n   * <Target Name=\"SignNupkgs\" AfterTargets=\"Pack\">\n   *   <Exec Command=\"dotnet nuget sign $(PackageOutputPath) [remaining args]\" ConsoleToMsBuild=\"true\" />\n   * </Target>\n   * ```\n   * Alternatively, splice your signing commands into the publishCmd string,\n   * inserting them before `dotnet nuget push`.\n   * If you sign different signatures depending on the NuGet registry,\n   * splice your signing command (with \"overwrite signature\" enabled, if\n   * desired) before the corresponding registry's `dotnet nuget push` command.\n   * @param projectsToPublish An array of dotnet projects' relative paths. If\n   * empty or unspecified, tries getting projects' semi-colon-separated relative\n   * paths from the `PROJECTS_TO_PUBLISH` environment variable. If configured as\n   * recommended, the projects' publish outputs will be zipped to '$PWD/publish'\n   * for use in the `publish` semantic-release step (typically, GitHub release).\n   * @param projectsToPackAndPush An array of dotnet projects' relative paths.\n   * If empty or unspecified, tries getting projects' semi-colon-separated\n   * relative paths from the `PROJECTS_TO_PACK_AND_PUSH` environment variable.\n   * Otherwise, no packages will be packed and pushed.\n   * If configured as recommended, `dotnet pack` will output the nupkg/snupkg\n   * files to `$PWD/publish` where they will be globbed by `dotnet nuget push`.\n   */\n  constructor(\n    projectsToPublish: string[] | MSBuildProject[],\n    projectsToPackAndPush: string[] | NugetRegistryInfo[],\n  ) {\n    this.options = baseConfig;\n    /* normalize PluginSpecs to tuples */\n    this.options.plugins = this.options.plugins.map(pluginSpec => typeof pluginSpec === 'string'\n      ? [pluginSpec, {}]\n      : pluginSpec,\n    );\n\n    this._projectsToPublish = projectsToPublish;\n    if (this._projectsToPublish.length === 0) {\n      const p = getEnvVarValue('PROJECTS_TO_PUBLISH')?.split(';');\n      if (p && p.length > 0) {\n        this._projectsToPublish = p;\n      }\n      else if (debug.enabled) {\n        debug(new Error('At least one project must be published. `projectsToPackAndPush` is empty and environment variable `PROJECTS_TO_PUBLISH` is undefined or empty.'));\n      }\n    }\n\n    this._projectsToPackAndPush = projectsToPackAndPush;\n    if (this._projectsToPackAndPush.length === 0) {\n      const p = getEnvVarValue('PROJECTS_TO_PACK_AND_PUSH')?.split(';');\n      if (p && p.length > 0) {\n        this._projectsToPackAndPush = p;\n      }\n      else if (debug.enabled) {\n        debug(new Error('projectsToPackAndPush.length must be > 0 or PROJECTS_TO_PACK_AND_PUSH must be defined and contain at least one path.'));\n      }\n    }\n\n    // may be zero-length array\n    this._evaluatedProjects = [\n      ...this._projectsToPublish.filter(v => v instanceof MSBuildProject),\n      ...this._projectsToPackAndPush\n        .filter(v => v instanceof NugetRegistryInfo)\n        .map(v => v.project),\n    ];\n  }\n\n  get ProjectsToPublish(): string[] | MSBuildProject[] {\n    return this._projectsToPublish;\n  }\n\n  get ProjectsToPackAndPush(): string[] | NugetRegistryInfo[] {\n    return this._projectsToPackAndPush;\n  }\n\n  get EvaluatedProjects(): MSBuildProject[] {\n    return this._evaluatedProjects;\n  }\n\n  // eslint-disable-next-line jsdoc/require-param\n  /** @deprecated Superseded by {@link splicePlugin} */\n  insertPlugin(\n    afterPluginsIDs: string[],\n    insertPluginIDs: string[],\n    beforePluginsIDs: string[],\n  ): void {\n    this.options.plugins = insertPlugin(this.options.plugins, afterPluginsIDs, insertPluginIDs, beforePluginsIDs);\n  }\n\n  /**\n   * generate dotnet commands for \\@semantic-release/exec, appending commands with ' && ' when necessary.\n   *\n   * Note: All strings in {@link this.ProjectsToPackAndPush} will be converted to basic {@link NugetRegistryInfo} instances with default values.\n   * If you need specific NRI settings or you need to push to GitLab-like or GitHub-like registries, instantiate them instead of passing their paths.\n   * @todo change to builder method? e.g. static async SetupDotnetCommands(this: SemanticReleaseConfigDotnet): Promise<SemanticReleaseConfigDotnet>\n   * @todo Add options param to allow users to enable pushing to GitLab, GitHub, NuGet.org with default settings -OR- with entirely custom settings.\n   * @see https://github.com/semantic-release/exec#usage\n   */\n  async setupDotnetCommands(): Promise<void> {\n    let srExecIndex = this.options.plugins.findIndex(\n      v => v[0] === '@semantic-release/exec',\n    );\n    if (srExecIndex === -1) {\n      const message = `\\\nUnable to find\\`['@semantic-release/exec', unknown]\\` in plugins array!\nAppending it to the end of the array...This may cause an unexpected order of operations!`;\n      console.warn(message);\n      srExecIndex = this.options.plugins.push(['@semantic-release/exec', {}]) - 1;\n    }\n\n    const plugin = this.options.plugins[srExecIndex] as ['@semantic-release/exec', SRExecOptions];\n    const execOptions: SRExecOptions = plugin[1];\n\n    // ensure all packable projects are evaluated\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion\n    this._projectsToPackAndPush = await Promise.all(\n      this._projectsToPackAndPush.map(async (project) => {\n        if (typeof project === 'string') {\n          const packableProjects = await Promise.all(\n            await MSBuildProject.PackableProjectsToMSBuildProjects(\n              [project],\n            ),\n          );\n          if (packableProjects.length === 0)\n            throw new Error('No MSBuildProject instances were returned!');\n          this._evaluatedProjects.push(...packableProjects);\n\n          // if the user doesn't want a defaulted NRI, they should pass their own NRI (or derived) instance.\n          return packableProjects.map(project => new NugetRegistryInfo({ project }));\n        }\n        else return [project];\n      }),\n    ).then(p => p.flat()) as NugetRegistryInfo[];\n\n    // todo: double-check token-testing commands. Are they formatted prepended correctly?\n    const verifyConditionsCmdAppendix = await Promise.all(\n      this._projectsToPackAndPush\n        .map(async project =>\n          await project.PackDummyPackage({})\n            .then(() =>\n              project.GetPushDummyCommand({}),\n            ),\n        ),\n    ).then(cmds =>\n      cmds.join(' && '),\n    );\n    execOptions.verifyConditionsCmd\n      = execOptions.verifyConditionsCmd && execOptions.verifyConditionsCmd.trim().length > 0\n        ? `${execOptions.verifyConditionsCmd} && ${verifyConditionsCmdAppendix}`\n        : verifyConditionsCmdAppendix;\n\n    const verifyReleaseCmdAppendix\n      = this.ProjectsToPackAndPush\n        .filter(project =>\n          typeof project !== 'string',\n        ).map(project =>\n          project.GetIsNextVersionAlreadyPublishedCommand(),\n        ).join(' && ');\n    execOptions.verifyReleaseCmd\n      = execOptions.verifyReleaseCmd && execOptions.verifyReleaseCmd.trim().length > 0\n        ? `${execOptions.verifyReleaseCmd} && ${verifyReleaseCmdAppendix}`\n        : verifyConditionsCmdAppendix;\n\n    const prepareCmdAppendix = await configurePrepareCmd(\n      this._projectsToPublish,\n      this._projectsToPackAndPush,\n    );\n\n    // 'ZipPublishDir' zips each publish folder to ./publish/*.zip\n    execOptions.prepareCmd\n      = execOptions.prepareCmd && execOptions.prepareCmd.trim().length > 0\n        ? `${execOptions.prepareCmd} && ${prepareCmdAppendix}`\n        : prepareCmdAppendix;\n\n    // FINISHED execOptions.prepareCmd\n    // STARTING execOptions.publishCmd\n    if (this._projectsToPackAndPush.length > 0) {\n      const publishCmdAppendix: string = configureDotnetNugetPush(\n        this._projectsToPackAndPush,\n      );\n      execOptions.publishCmd\n        = execOptions.publishCmd && execOptions.publishCmd.trim().length > 0\n          ? `${execOptions.publishCmd} && ${publishCmdAppendix}`\n          : publishCmdAppendix;\n    }\n\n    // FINISHED execOptions.publishCmd\n  }\n\n  /**\n   * Insert a plugin into the plugins array.\n   * @param insertAfterPluginIDs Plugins which should appear BEFORE\n   * {@link insertPluginIDs}.\n   * @param insertPluginIDs The plugin(s) to insert into the plugins array.\n   * @param insertBeforePluginsIDs plugins which should appear AFTER the\n   * inserted plugin(s).\n   */\n  splicePlugin(\n    insertAfterPluginIDs: string[],\n    insertPluginIDs: string[],\n    insertBeforePluginsIDs: string[],\n  ): void {\n    const errors: Error[] = [];\n    const pluginIDs = this.options.plugins.map(v =>\n      typeof v === 'string' ? v : v[0],\n    ) as (typeof this.options.plugins[number])[][0];\n\n    // if any beforePluginIDs are ordered before the last afterPlugin, throw. Impossible to sort.\n\n    const indexOfLastPreceding: number | undefined = insertAfterPluginIDs\n      .filter(v => pluginIDs.includes(v))\n      .map(v => pluginIDs.indexOf(v))\n      .sort()\n      .find((_v, i, obj) => i === obj.length - 1);\n    if (!indexOfLastPreceding)\n      throw new ReferenceError(\n        'An attempt to get the last element of indexOfLastAfter returned undefined.',\n      );\n\n    const indicesOfBefore: number[] = insertBeforePluginsIDs\n      .filter(v => pluginIDs.includes(v))\n      .map(v => pluginIDs.indexOf(v))\n      .sort();\n\n    for (const index of indicesOfBefore) {\n      if (index <= indexOfLastPreceding) {\n        const formattedInsertIds: string\n          = '[' + insertPluginIDs.map(v => `\"${v}\"`).join(', ') + ']';\n        const formattedAfterIds: string\n          = '[' + insertAfterPluginIDs.map(v => `\"${v}\"`).join(', ') + ']';\n        const formattedBeforeIds: string\n          = '[' + insertBeforePluginsIDs.map(v => `\"${v}\"`).join(', ') + ']';\n        errors.push(\n          new Error(\n            `insertPlugin was instructed to insert ${formattedInsertIds} after ${formattedAfterIds} and before ${formattedBeforeIds}, `\n            + `but ${JSON.stringify(pluginIDs[indexOfLastPreceding])} is ordered after ${JSON.stringify(pluginIDs[index])}!`,\n          ),\n        );\n      }\n    }\n\n    if (errors.length > 0)\n      throw new AggregateError(errors, 'One or more errors occurred while splicing plugin-option tuples into the Semantic Release config!');\n\n    this.options.plugins.splice(\n      indexOfLastPreceding + 1,\n      0,\n      ...insertPluginIDs.map(v => [v, {}] satisfies [string, unknown]),\n    );\n  }\n\n  // todo: join result with dummy pack commands\n  protected async getTokenTestingCommands(): Promise<string> {\n    const promiseProjects = this.ProjectsToPackAndPush.every(nri => nri instanceof NugetRegistryInfo)\n      ? this.ProjectsToPackAndPush.map(nri => nri.project)\n      : await Promise.all(await MSBuildProject.PackableProjectsToMSBuildProjects(this.ProjectsToPackAndPush));\n\n    /** if a project is not in {@link EvaluatedProjects}, add it */\n    for (const project of promiseProjects) {\n      if (!this.EvaluatedProjects.includes(project))\n        this.EvaluatedProjects.push(project);\n    }\n\n    const regInfos = promiseProjects.map(\n      p => new NugetRegistryInfo({ project: p }),\n    );\n    const nupkgPaths = await Promise.all(\n      regInfos.map(nri =>\n        nri.PackDummyPackage({}).then((nupkgs) => {\n          // this is a full file path.\n          const mainNupkg = nupkgs.find(nupkg =>\n            new RegExp(/(?<!symbols)\\.nupkg$/).test(nupkg),\n          );\n          if (mainNupkg !== undefined)\n            return { nri: nri, nupkgPath: mainNupkg } as const;\n          throw new Error(\n            'None of the following dummy packages are non-symbol .nupkg files:\\n'\n            + nupkgs.map(nupkg => `  - ${nupkg}`).join('\\n')\n            + '\\nIf you intended to push only symbol packages, check if a feature request already exists (https://github.com/HaloSPV3/HCE.Shared/issues?q=push+snupkg) and, if one does not exist, create one containing the keywords \"push snupkg\".',\n          );\n        }),\n      ),\n    );\n    const pushCommands = nupkgPaths.map(pair =>\n      pair.nri.GetPushDummyCommand({}),\n    );\n    return pushCommands.join(' && ');\n  }\n\n  toOptions(): Options {\n    return this.options;\n  }\n}\n\n/**\n * Configures {@link baseConfig} with `@semantic-release/exec` to `dotnet`\n * publish, pack, and nuget-push.\n * @param projectsToPublish\n * An array of dotnet projects' relative paths -OR- an array of\n * {@link MSBuildProject} instances.\n * - If `MSBuildProject[]`, the instances will be used as-is.\n * - If `[]`, tries getting projects' semi-colon-separated relative paths from\n *   the `PROJECTS_TO_PUBLISH` environment variable.\n * - If configured as recommended, the projects' publish outputs will be zipped\n *   to '$PWD/publish' for use in the `publish` semantic-release step e.g. for a\n *   GitHub release.\n * @param projectsToPackAndPush An array of dotnet projects' relative paths -OR-\n * an array of instances of {@link NugetRegistryInfo} and/or derived classes.\n * - If `NugetRegistryInfo[]`, no conversions or modifications will occur.\n * - If `string[]`, the project paths will be converted to\n * {@link NugetRegistryInfo} instances with default values. This may be undesired.\n * - If `[]`, `dotnet pack` and `dotnet nuget push` commands will not be configured.\n * - If `undefined`, tries getting projects' semi-colon-separated relative paths\n * from the `PROJECTS_TO_PACK_AND_PUSH` environment variable.\n * With the recommended configuration, `dotnet pack` will write the nupkg/snupkg\n * files to `$PWD/publish` where they will be globbed by `dotnet nuget push`.\n * @returns a semantic-release Options object, based on\n * `@halospv3/hce.shared-config` (our base config), with the\n * `@semantic-release/exec` plugin configured to `dotnet publish`, `pack`, and\n * `push` the specified projects.\n */\nexport async function getConfig(\n  projectsToPublish: string[] | MSBuildProject[],\n  projectsToPackAndPush?: string[] | NugetRegistryInfo[],\n): Promise<Options> {\n  if (debug.enabled) {\n    debug(\n      'hce.shared-config:\\n' + inspect(baseConfig, false, Infinity, true),\n    );\n  }\n\n  const errors: Error[] = [];\n\n  if (projectsToPublish.length === 0) {\n    const _ = getEnvVarValue('PROJECTS_TO_PUBLISH');\n    if (_ === undefined)\n      errors.push(\n        new Error(\n          'projectsToPublish.length must be > 0 or PROJECTS_TO_PUBLISH must be defined and contain at least one path.',\n        ),\n      );\n    else projectsToPublish = _.split(';');\n  }\n\n  if (!projectsToPackAndPush) {\n    const _ = getEnvVarValue('PROJECTS_TO_PACK_AND_PUSH');\n    if (_ === undefined)\n      errors.push(\n        new Error(\n          'projectsToPackAndPush.length must be > 0 or PROJECTS_TO_PACK_AND_PUSH must be defined and contain at least one path.',\n        ),\n      );\n    else projectsToPackAndPush = _.split(';');\n  }\n\n  if (errors.length > 0) {\n    throw new Error(\n      [\n        'getConfig cannot continue. One or more errors occurred.',\n        ...errors.map(v => v.stack),\n      ].join('\\n'),\n    );\n  }\n\n  const config = new SemanticReleaseConfigDotnet(\n    projectsToPublish,\n    projectsToPackAndPush ?? [],\n  );\n  await config.setupDotnetCommands();\n\n  const options: Options = config.toOptions();\n  if (debug.enabled) {\n    debug('modified plugins array:');\n    debug(inspect(options.plugins, false, Infinity));\n  }\n\n  return options;\n}\n\n/**\n * @module semanticReleaseConfigDotnet\n */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,IAAa,8BAAb,MAAyC;CACvC;CACA;CACA;CACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BA,YACE,mBACA,uBACA;AACA,OAAK,UAAU;AAEf,OAAK,QAAQ,UAAU,KAAK,QAAQ,QAAQ,KAAI,eAAc,OAAO,eAAe,WAChF,CAAC,YAAY,EAAE,CAAC,GAChB,WACH;AAED,OAAK,qBAAqB;AAC1B,MAAI,KAAK,mBAAmB,WAAW,GAAG;GACxC,MAAM,IAAI,eAAe,sBAAsB,EAAE,MAAM,IAAI;AAC3D,OAAI,KAAK,EAAE,SAAS,EAClB,MAAK,qBAAqB;YAEnBA,OAAM,QACb,wBAAM,IAAI,MAAM,iJAAiJ,CAAC;;AAItK,OAAK,yBAAyB;AAC9B,MAAI,KAAK,uBAAuB,WAAW,GAAG;GAC5C,MAAM,IAAI,eAAe,4BAA4B,EAAE,MAAM,IAAI;AACjE,OAAI,KAAK,EAAE,SAAS,EAClB,MAAK,yBAAyB;YAEvBA,OAAM,QACb,wBAAM,IAAI,MAAM,uHAAuH,CAAC;;AAK5I,OAAK,qBAAqB,CACxB,GAAG,KAAK,mBAAmB,QAAO,MAAK,aAAa,eAAe,EACnE,GAAG,KAAK,uBACL,QAAO,MAAK,aAAa,kBAAkB,CAC3C,KAAI,MAAK,EAAE,QAAQ,CACvB;;CAGH,IAAI,oBAAiD;AACnD,SAAO,KAAK;;CAGd,IAAI,wBAAwD;AAC1D,SAAO,KAAK;;CAGd,IAAI,oBAAsC;AACxC,SAAO,KAAK;;;CAKd,aACE,iBACA,iBACA,kBACM;AACN,OAAK,QAAQ,UAAU,aAAa,KAAK,QAAQ,SAAS,iBAAiB,iBAAiB,iBAAiB;;;;;;;;;;;CAY/G,MAAM,sBAAqC;EACzC,IAAI,cAAc,KAAK,QAAQ,QAAQ,WACrC,MAAK,EAAE,OAAO,yBACf;AACD,MAAI,gBAAgB,IAAI;AAItB,WAAQ,KAHQ;;0FAGK;AACrB,iBAAc,KAAK,QAAQ,QAAQ,KAAK,CAAC,0BAA0B,EAAE,CAAC,CAAC,GAAG;;EAI5E,MAAM,cADS,KAAK,QAAQ,QAAQ,aACM;AAI1C,OAAK,yBAAyB,MAAM,QAAQ,IAC1C,KAAK,uBAAuB,IAAI,OAAO,YAAY;AACjD,OAAI,OAAO,YAAY,UAAU;IAC/B,MAAM,mBAAmB,MAAM,QAAQ,IACrC,MAAM,eAAe,kCACnB,CAAC,QAAQ,CACV,CACF;AACD,QAAI,iBAAiB,WAAW,EAC9B,OAAM,IAAI,MAAM,6CAA6C;AAC/D,SAAK,mBAAmB,KAAK,GAAG,iBAAiB;AAGjD,WAAO,iBAAiB,KAAI,YAAW,IAAI,kBAAkB,EAAE,SAAS,CAAC,CAAC;SAEvE,QAAO,CAAC,QAAQ;IACrB,CACH,CAAC,MAAK,MAAK,EAAE,MAAM,CAAC;EAGrB,MAAM,8BAA8B,MAAM,QAAQ,IAChD,KAAK,uBACF,IAAI,OAAM,YACT,MAAM,QAAQ,iBAAiB,EAAE,CAAC,CAC/B,WACC,QAAQ,oBAAoB,EAAE,CAAC,CAChC,CACJ,CACJ,CAAC,MAAK,SACL,KAAK,KAAK,OAAO,CAClB;AACD,cAAY,sBACR,YAAY,uBAAuB,YAAY,oBAAoB,MAAM,CAAC,SAAS,IACjF,GAAG,YAAY,oBAAoB,MAAM,gCACzC;EAEN,MAAM,2BACF,KAAK,sBACJ,QAAO,YACN,OAAO,YAAY,SACpB,CAAC,KAAI,YACJ,QAAQ,yCAAyC,CAClD,CAAC,KAAK,OAAO;AAClB,cAAY,mBACR,YAAY,oBAAoB,YAAY,iBAAiB,MAAM,CAAC,SAAS,IAC3E,GAAG,YAAY,iBAAiB,MAAM,6BACtC;EAEN,MAAM,qBAAqB,MAAM,oBAC/B,KAAK,oBACL,KAAK,uBACN;AAGD,cAAY,aACR,YAAY,cAAc,YAAY,WAAW,MAAM,CAAC,SAAS,IAC/D,GAAG,YAAY,WAAW,MAAM,uBAChC;AAIN,MAAI,KAAK,uBAAuB,SAAS,GAAG;GAC1C,MAAM,qBAA6B,yBACjC,KAAK,uBACN;AACD,eAAY,aACR,YAAY,cAAc,YAAY,WAAW,MAAM,CAAC,SAAS,IAC/D,GAAG,YAAY,WAAW,MAAM,uBAChC;;;;;;;;;;;CAcV,aACE,sBACA,iBACA,wBACM;EACN,MAAM,SAAkB,EAAE;EAC1B,MAAM,YAAY,KAAK,QAAQ,QAAQ,KAAI,MACzC,OAAO,MAAM,WAAW,IAAI,EAAE,GAC/B;EAID,MAAM,uBAA2C,qBAC9C,QAAO,MAAK,UAAU,SAAS,EAAE,CAAC,CAClC,KAAI,MAAK,UAAU,QAAQ,EAAE,CAAC,CAC9B,MAAM,CACN,MAAM,IAAI,GAAG,QAAQ,MAAM,IAAI,SAAS,EAAE;AAC7C,MAAI,CAAC,qBACH,OAAM,IAAI,eACR,6EACD;EAEH,MAAM,kBAA4B,uBAC/B,QAAO,MAAK,UAAU,SAAS,EAAE,CAAC,CAClC,KAAI,MAAK,UAAU,QAAQ,EAAE,CAAC,CAC9B,MAAM;AAET,OAAK,MAAM,SAAS,gBAClB,KAAI,SAAS,sBAAsB;GACjC,MAAM,qBACF,MAAM,gBAAgB,KAAI,MAAK,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,GAAG;GAC1D,MAAM,oBACF,MAAM,qBAAqB,KAAI,MAAK,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,GAAG;GAC/D,MAAM,qBACF,MAAM,uBAAuB,KAAI,MAAK,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,GAAG;AACjE,UAAO,qBACL,IAAI,MACF,yCAAyC,mBAAmB,SAAS,kBAAkB,cAAc,mBAAmB,QAC/G,KAAK,UAAU,UAAU,sBAAsB,CAAC,oBAAoB,KAAK,UAAU,UAAU,OAAO,CAAC,GAC/G,CACF;;AAIL,MAAI,OAAO,SAAS,EAClB,OAAM,IAAI,eAAe,QAAQ,oGAAoG;AAEvI,OAAK,QAAQ,QAAQ,OACnB,uBAAuB,GACvB,GACA,GAAG,gBAAgB,KAAI,MAAK,CAAC,GAAG,EAAE,CAAC,CAA6B,CACjE;;CAIH,MAAgB,0BAA2C;EACzD,MAAM,kBAAkB,KAAK,sBAAsB,OAAM,QAAO,eAAe,kBAAkB,GAC7F,KAAK,sBAAsB,KAAI,QAAO,IAAI,QAAQ,GAClD,MAAM,QAAQ,IAAI,MAAM,eAAe,kCAAkC,KAAK,sBAAsB,CAAC;;AAGzG,OAAK,MAAM,WAAW,gBACpB,KAAI,CAAC,KAAK,kBAAkB,SAAS,QAAQ,CAC3C,MAAK,kBAAkB,KAAK,QAAQ;EAGxC,MAAM,WAAW,gBAAgB,KAC/B,MAAK,IAAI,kBAAkB,EAAE,SAAS,GAAG,CAAC,CAC3C;AAqBD,UApBmB,MAAM,QAAQ,IAC/B,SAAS,KAAI,QACX,IAAI,iBAAiB,EAAE,CAAC,CAAC,MAAM,WAAW;GAExC,MAAM,YAAY,OAAO,MAAK,2BAC5B,IAAI,OAAO,uBAAuB,EAAC,KAAK,MAAM,CAC/C;AACD,OAAI,cAAc,KAAA,EAChB,QAAO;IAAO;IAAK,WAAW;IAAW;AAC3C,SAAM,IAAI,MACR,wEACE,OAAO,KAAI,UAAS,OAAO,QAAQ,CAAC,KAAK,KAAK,GAC9C,0OACH;IACD,CACH,CACF,EAC+B,KAAI,SAClC,KAAK,IAAI,oBAAoB,EAAE,CAAC,CACjC,CACmB,KAAK,OAAO;;CAGlC,YAAqB;AACnB,SAAO,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BhB,eAAsB,UACpB,mBACA,uBACkB;AAClB,KAAIA,OAAM,QACR,QACE,yBAAyB,QAAQ,YAAY,OAAO,UAAU,KAAK,CACpE;CAGH,MAAM,SAAkB,EAAE;AAE1B,KAAI,kBAAkB,WAAW,GAAG;EAClC,MAAM,IAAI,eAAe,sBAAsB;AAC/C,MAAI,MAAM,KAAA,EACR,QAAO,qBACL,IAAI,MACF,6GACD,CACF;MACE,qBAAoB,EAAE,MAAM,IAAI;;AAGvC,KAAI,CAAC,uBAAuB;EAC1B,MAAM,IAAI,eAAe,4BAA4B;AACrD,MAAI,MAAM,KAAA,EACR,QAAO,qBACL,IAAI,MACF,uHACD,CACF;MACE,yBAAwB,EAAE,MAAM,IAAI;;AAG3C,KAAI,OAAO,SAAS,EAClB,OAAM,IAAI,MACR,CACE,2DACA,GAAG,OAAO,KAAI,MAAK,EAAE,MAAM,CAC5B,CAAC,KAAK,KAAK,CACb;CAGH,MAAM,SAAS,IAAI,4BACjB,mBACA,yBAAyB,EAAE,CAC5B;AACD,OAAM,OAAO,qBAAqB;CAElC,MAAM,UAAmB,OAAO,WAAW;AAC3C,KAAIA,OAAM,SAAS;AACjB,SAAM,0BAA0B;AAChC,SAAM,QAAQ,QAAQ,SAAS,OAAO,SAAS,CAAC;;AAGlD,QAAO"}

package/mjs/setupGitPluginSpec.default.mjs

@@ -1,4 +1,20 @@
-const e={assets:[`README.md`,`CHANGELOG.md`,`package.json`,`package-lock.json`,`npm-shrinkwrap.json`],message:`chore(release): \${nextRelease.version} [skip ci]
+//#region src/setupGitPluginSpec.default.ts
+/**
+* As specified at https://github.com/semantic-release/git#options
+* To use, assign or create an object with the same (but mutable) properties and deeply-copy to the object
+* @satisfies { GitOptions }
+*/
+const DefaultOptions = {
+	assets: [
+		"README.md",
+		"CHANGELOG.md",
+		"package.json",
+		"package-lock.json",
+		"npm-shrinkwrap.json"
+	],
+	message: "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+};
+//#endregion
+export { DefaultOptions };
 
-\${nextRelease.notes}`};export{e as DefaultOptions};
 //# sourceMappingURL=setupGitPluginSpec.default.mjs.map

package/mjs/setupGitPluginSpec.default.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"setupGitPluginSpec.default.mjs","names":[],"sources":["../src/setupGitPluginSpec.default.ts"],"sourcesContent":["/// <reference file=\"./semantic-release__git.d.ts\">\n// @ts-types=\"./semantic-release__git.d.ts\"\nimport type { Options as GitOptions } from '@semantic-release/git';\n/**\n * As specified at https://github.com/semantic-release/git#options\n * To use, assign or create an object with the same (but mutable) properties and deeply-copy to the object\n * @satisfies { GitOptions }\n */\nexport const DefaultOptions: {\n  readonly assets: ['README.md', 'CHANGELOG.md', 'package.json', 'package-lock.json', 'npm-shrinkwrap.json'];\n  readonly message: 'chore(release): ${nextRelease.version} [skip ci]\\n\\n${nextRelease.notes}';\n} = {\n  assets: [\n    'README.md',\n    'CHANGELOG.md',\n    'package.json',\n    'package-lock.json',\n    'npm-shrinkwrap.json',\n  ],\n  message:\n    'chore(release): ${nextRelease.version} [skip ci]\\n\\n${nextRelease.notes}',\n} as const satisfies GitOptions;\n"],"mappings":"AAQA,MAAa,EAGT,CACF,OAAQ,CACN,YACA,eACA,eACA,oBACA,sBACD,CACD,QACE;;uBACH"}
+{"version":3,"file":"setupGitPluginSpec.default.mjs","names":[],"sources":["../src/setupGitPluginSpec.default.ts"],"sourcesContent":["/// <reference file=\"./semantic-release__git.d.ts\">\n// @ts-types=\"./semantic-release__git.d.ts\"\nimport type { Options as GitOptions } from '@semantic-release/git';\n/**\n * As specified at https://github.com/semantic-release/git#options\n * To use, assign or create an object with the same (but mutable) properties and deeply-copy to the object\n * @satisfies { GitOptions }\n */\nexport const DefaultOptions: {\n  readonly assets: ['README.md', 'CHANGELOG.md', 'package.json', 'package-lock.json', 'npm-shrinkwrap.json'];\n  readonly message: 'chore(release): ${nextRelease.version} [skip ci]\\n\\n${nextRelease.notes}';\n} = {\n  assets: [\n    'README.md',\n    'CHANGELOG.md',\n    'package.json',\n    'package-lock.json',\n    'npm-shrinkwrap.json',\n  ],\n  message:\n    'chore(release): ${nextRelease.version} [skip ci]\\n\\n${nextRelease.notes}',\n} as const satisfies GitOptions;\n"],"mappings":";;;;;;AAQA,MAAa,iBAGT;CACF,QAAQ;EACN;EACA;EACA;EACA;EACA;EACD;CACD,SACE;CACH"}

package/mjs/setupGitPluginSpec.mjs

@@ -1,2 +1,109 @@
-import{DefaultOptions as e}from"./setupGitPluginSpec.default.mjs";const t=`@semantic-release/git`;function n(e){return typeof e==`string`?!0:typeof e==`object`&&e&&`path`in e?typeof e.path==`string`:!1}function r(e){if(e===void 0)return[];if(Array.isArray(e))return e.filter(e=>n(e)).map(e=>typeof e==`string`?e:e.path);if(typeof e==`string`)return[e];if(typeof e.path==`string`)return[e.path];throw TypeError(`assets is not typeof GitOptions['assets'!`)}function i(e){return{...e,assets:e.assets===!1?e.assets:r(e.assets)}}function a(e){let t=!1;return typeof e!=`object`||!e?t:(`assets`in e&&(t=Array.isArray(e.assets)?e.assets.every(e=>n(e)):n(e.assets)),`message`in e&&(t=typeof e.message==`string`),t)}function o(e){return a(e[1])}function s(e){return e[0]===t}function c(t){let n=t.findIndex(e=>s(e));if(n===-1)return t;let c=t[n],l=a(c[1])?i(c[1]):e;return t.map((e,t)=>{if(t<=n||!s(e))return e;if(o(e)){let t=i(e[1]);if(t.assets===!1)l.assets=!1;else{let e=r(t.assets);Array.isArray(l.assets)?l.assets.push(...e):l.assets=e}typeof t.message==`string`&&(l.message=t.message)}}).filter(e=>e!==void 0)}export{e as DefaultOptions,t as GitPluginId,c as setupGitPluginSpec};
+import { DefaultOptions } from "./setupGitPluginSpec.default.mjs";
+//#region src/setupGitPluginSpec.ts
+const GitPluginId = "@semantic-release/git";
+/**
+* Check if {@link unk} is an {@link AssetEntry}.
+* @param unk Anything.
+* @returns `true` if {@link unk} is an {@link AssetEntry}. Else, `false`.
+*/
+function isGitAsset(unk) {
+	if (typeof unk === "string") return true;
+	if (typeof unk === "object" && unk != void 0 && "path" in unk) return typeof unk.path === "string";
+	return false;
+}
+/**
+* Convert one or more {@link AssetEntry AssetEntries} to a `string[]`.
+* @param assets The `assets` property of a {@link GitOptions} object. This may not be `false`.
+* @returns A `string[]` of the given {@link AssetEntry} objects or strings.
+*/
+function gitAssetsToStringArray(assets) {
+	if (assets === void 0) return [];
+	if (Array.isArray(assets)) return assets.filter((asset) => isGitAsset(asset)).map((v) => typeof v === "string" ? v : v.path);
+	if (typeof assets === "string") return [assets];
+	if (typeof assets.path === "string") return [assets.path];
+	else throw new TypeError("assets is not typeof GitOptions['assets'!");
+}
+/**
+* Sanitize a {@link GitOptions} object so its {@link GitOptions#assets} property is either `false` or a `string[]`.
+* @param opts A {@link GitOptions} object.
+* @returns A {@link GitOptions} object whose {@link GitOptions#assets} is `string[] | false`.
+*/
+function sanitizeGitOptions(opts) {
+	return {
+		...opts,
+		assets: opts.assets === false ? opts.assets : gitAssetsToStringArray(opts.assets)
+	};
+}
+/**
+*Determine if {@link opts} is a {@link GitOptions} object.
+* @param opts Anything.
+* @returns `true` if {@link opts} is a {@link GitOptions} object. Else, `false`.
+*/
+function isGitOptions(opts) {
+	let isOptions = false;
+	if (typeof opts !== "object" || opts == void 0) return isOptions;
+	if ("assets" in opts) isOptions = Array.isArray(opts.assets) ? opts.assets.every((unk) => isGitAsset(unk)) : isGitAsset(opts.assets);
+	if ("message" in opts) isOptions = typeof opts.message === "string";
+	return isOptions;
+}
+/**
+* Determine if {@link pluginSpec} includes a {@link GitOptions} object.
+* @param pluginSpec a {@link PluginSpecTuple}.
+* @returns `true` if {@link pluginSpec[1]} is a {@link GitOptions} object. Else, `false`.
+*/
+function hasGitOptions(pluginSpec) {
+	return isGitOptions(pluginSpec[1]);
+}
+/**
+* Determined if the plugin ID in {@link pluginSpec} is {@link GitPluginId}.
+* @param pluginSpec A {@link PluginSpecTuple}
+* @returns `true` if {@link pluginSpec[0]} is {@link GitPluginId}
+*/
+function isGitPluginSpecTuple(pluginSpec) {
+	return pluginSpec[0] === GitPluginId;
+}
+/**
+* https://github.com/semantic-release/git#options
+*
+* This plugin may be deprecated at a later date.
+* Q: Why would I need to commit during release?
+* A: This is for committing your changelog, README, and/or other files updated during the release procedure.
+* @param plugins An ordered array of {@link PluginSpecTuple PluginSpecTuples}.
+* @returns A {@link PluginSpecTuple}[]. Duplicate `@semantic-release/git` plugin entries are merged or overridden. The last entry takes priority e.g. if the last entry is `{assets: false}`, previous entries' assets are ignored.
+*/
+function setupGitPluginSpec(plugins) {
+	/** if Git plugin not in load order, return as-is. */
+	const firstGitPluginIndex = plugins.findIndex((plugin) => isGitPluginSpecTuple(plugin));
+	if (firstGitPluginIndex === -1) return plugins;
+	/**
+	* the following two const variables are references--not clones.
+	* Modifying them will affect the plugins array.
+	*/
+	const firstGitPlugin = plugins[firstGitPluginIndex];
+	const firstGitOpts = isGitOptions(firstGitPlugin[1]) ? sanitizeGitOptions(firstGitPlugin[1]) : DefaultOptions;
+	/**
+	* remove duplicate Git plugin entries;
+	* merge extra options into firstGitPlugin's options
+	* if `firstGitOpts.assets === false`, do not change it.
+	* All duplicate PluginSpecSRGit entries are then reassigned `undefined` and all
+	* `undefined` items are filtered from the plugins array.
+	*/
+	return plugins.map((current, index) => {
+		if (index <= firstGitPluginIndex || !isGitPluginSpecTuple(current)) return current;
+		/** if another Git PluginSpec is discovered, copy its options to the first Git PluginSpec and return undefined. */
+		if (hasGitOptions(current)) {
+			const currentGitOpts = sanitizeGitOptions(current[1]);
+			if (currentGitOpts.assets === false) firstGitOpts.assets = false;
+			else {
+				const assets = gitAssetsToStringArray(currentGitOpts.assets);
+				if (Array.isArray(firstGitOpts.assets)) firstGitOpts.assets.push(...assets);
+				else firstGitOpts.assets = assets;
+			}
+			if (typeof currentGitOpts.message === "string") firstGitOpts.message = currentGitOpts.message;
+		}
+	}).filter((pluginSpec) => pluginSpec !== void 0);
+}
+//#endregion
+export { DefaultOptions, GitPluginId, setupGitPluginSpec };
+
 //# sourceMappingURL=setupGitPluginSpec.mjs.map

package/mjs/setupGitPluginSpec.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"setupGitPluginSpec.mjs","names":[],"sources":["../src/setupGitPluginSpec.ts"],"sourcesContent":["// @ts-types=\"./semantic-release__git.d.ts\"\nimport type { AssetEntry, Options as GitOptions } from '@semantic-release/git';\nimport type { PluginSpecSRGit, PluginSpecTuple } from './semanticReleaseConfig.ts';\nimport { DefaultOptions } from './setupGitPluginSpec.default.ts';\n\nexport const GitPluginId = '@semantic-release/git';\nexport { DefaultOptions } from './setupGitPluginSpec.default.ts';\n\n/**\n * Check if {@link unk} is an {@link AssetEntry}.\n * @param unk Anything.\n * @returns `true` if {@link unk} is an {@link AssetEntry}. Else, `false`.\n */\nfunction isGitAsset(unk: unknown): unk is AssetEntry {\n  if (typeof unk === 'string')\n    return true;\n  // Avoid ending condition with `typeof unk.path === 'string'`.\n  // TS narrowing is bugged; requires the check to be performed TWICE!!\n  if (typeof unk === 'object' && unk != undefined && 'path' in unk) {\n    return typeof unk.path === 'string';\n  }\n  return false;\n}\n\n/**\n * Convert one or more {@link AssetEntry AssetEntries} to a `string[]`.\n * @param assets The `assets` property of a {@link GitOptions} object. This may not be `false`.\n * @returns A `string[]` of the given {@link AssetEntry} objects or strings.\n */\nfunction gitAssetsToStringArray(\n  assets: Exclude<GitOptions['assets'], false>,\n): string[] {\n  if (assets === undefined)\n    return [];\n  if (Array.isArray(assets)) {\n    return assets.filter(asset => isGitAsset(asset))\n      .map(v => typeof v === 'string' ? v : v.path);\n  }\n  if (typeof assets === 'string')\n    return [assets] as string[];\n  if (typeof assets.path === 'string')\n    return [assets.path];\n  else\n    throw new TypeError('assets is not typeof GitOptions[\\'assets\\'!');\n}\n\n/**\n * Sanitize a {@link GitOptions} object so its {@link GitOptions#assets} property is either `false` or a `string[]`.\n * @param opts A {@link GitOptions} object.\n * @returns A {@link GitOptions} object whose {@link GitOptions#assets} is `string[] | false`.\n */\nfunction sanitizeGitOptions(opts: GitOptions): Omit<GitOptions, 'assets'> & { assets: string[] | false } {\n  return { ...opts, assets: opts.assets === false ? opts.assets : gitAssetsToStringArray(opts.assets) };\n}\n\n/**\n *Determine if {@link opts} is a {@link GitOptions} object.\n * @param opts Anything.\n * @returns `true` if {@link opts} is a {@link GitOptions} object. Else, `false`.\n */\nfunction isGitOptions(opts: unknown): opts is GitOptions {\n  let isOptions = false;\n\n  if (typeof opts !== 'object' || opts == undefined)\n    return isOptions;\n  if ('assets' in opts) {\n    isOptions = Array.isArray(opts.assets)\n      ? opts.assets.every(unk => isGitAsset(unk))\n      : isGitAsset(opts.assets);\n  }\n  if ('message' in opts)\n    isOptions = typeof opts.message === 'string';\n  return isOptions;\n}\n\n/**\n * Determine if {@link pluginSpec} includes a {@link GitOptions} object.\n * @param pluginSpec a {@link PluginSpecTuple}.\n * @returns `true` if {@link pluginSpec[1]} is a {@link GitOptions} object. Else, `false`.\n */\nfunction hasGitOptions<P extends string>(pluginSpec: PluginSpecTuple<P>): pluginSpec is PluginSpecTuple<P, GitOptions> {\n  return isGitOptions(pluginSpec[1]);\n};\n\n/**\n * Determined if the plugin ID in {@link pluginSpec} is {@link GitPluginId}.\n * @param pluginSpec A {@link PluginSpecTuple}\n * @returns `true` if {@link pluginSpec[0]} is {@link GitPluginId}\n */\nfunction isGitPluginSpecTuple<T>(pluginSpec: [string, T]): pluginSpec is [typeof GitPluginId, T] {\n  return pluginSpec[0] === GitPluginId;\n}\n\n/**\n * https://github.com/semantic-release/git#options\n *\n * This plugin may be deprecated at a later date.\n * Q: Why would I need to commit during release?\n * A: This is for committing your changelog, README, and/or other files updated during the release procedure.\n * @param plugins An ordered array of {@link PluginSpecTuple PluginSpecTuples}.\n * @returns A {@link PluginSpecTuple}[]. Duplicate `@semantic-release/git` plugin entries are merged or overridden. The last entry takes priority e.g. if the last entry is `{assets: false}`, previous entries' assets are ignored.\n */\nexport function setupGitPluginSpec(plugins: PluginSpecTuple[]): PluginSpecTuple[] {\n  /** if Git plugin not in load order, return as-is. */\n  const firstGitPluginIndex = plugins.findIndex(plugin => isGitPluginSpecTuple(plugin));\n  if (firstGitPluginIndex === -1)\n    return plugins;\n\n  /**\n   * the following two const variables are references--not clones.\n   * Modifying them will affect the plugins array.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n  const firstGitPlugin = plugins[firstGitPluginIndex]!;\n  const firstGitOpts: ReturnType<typeof sanitizeGitOptions> = isGitOptions(firstGitPlugin[1])\n    ? sanitizeGitOptions(firstGitPlugin[1])\n    : DefaultOptions;\n\n  /**\n   * remove duplicate Git plugin entries;\n   * merge extra options into firstGitPlugin's options\n   * if `firstGitOpts.assets === false`, do not change it.\n   * All duplicate PluginSpecSRGit entries are then reassigned `undefined` and all\n   * `undefined` items are filtered from the plugins array.\n   */\n  return plugins.map((current: PluginSpecTuple, index): PluginSpecTuple | PluginSpecSRGit | undefined => {\n    // skip everything up to and including the first Git PluginSpec\n    if (index <= firstGitPluginIndex || !isGitPluginSpecTuple(current))\n      return current;\n\n    /** if another Git PluginSpec is discovered, copy its options to the first Git PluginSpec and return undefined. */\n    if (hasGitOptions(current)) {\n      const currentGitOpts = sanitizeGitOptions(current[1]);\n\n      if (currentGitOpts.assets === false) {\n        firstGitOpts.assets = false;\n      }\n      else {\n        const assets: string[] = gitAssetsToStringArray(currentGitOpts.assets);\n        if (Array.isArray(firstGitOpts.assets)) {\n          firstGitOpts.assets.push(...assets);\n        }\n        else {\n          firstGitOpts.assets = assets;\n        }\n      }\n\n      if (typeof currentGitOpts.message === 'string')\n        firstGitOpts.message = currentGitOpts.message;\n    }\n    return undefined;\n  }).filter(pluginSpec => pluginSpec !== undefined);\n}\n"],"mappings":"kEAKA,MAAa,EAAc,wBAQ3B,SAAS,EAAW,EAAiC,CAQnD,OAPI,OAAO,GAAQ,SACV,GAGL,OAAO,GAAQ,UAAY,GAAoB,SAAU,EACpD,OAAO,EAAI,MAAS,SAEtB,GAQT,SAAS,EACP,EACU,CACV,GAAI,IAAW,IAAA,GACb,MAAO,EAAE,CACX,GAAI,MAAM,QAAQ,EAAO,CACvB,OAAO,EAAO,OAAO,GAAS,EAAW,EAAM,CAAC,CAC7C,IAAI,GAAK,OAAO,GAAM,SAAW,EAAI,EAAE,KAAK,CAEjD,GAAI,OAAO,GAAW,SACpB,MAAO,CAAC,EAAO,CACjB,GAAI,OAAO,EAAO,MAAS,SACzB,MAAO,CAAC,EAAO,KAAK,CAEpB,MAAU,UAAU,4CAA8C,CAQtE,SAAS,EAAmB,EAA6E,CACvG,MAAO,CAAE,GAAG,EAAM,OAAQ,EAAK,SAAW,GAAQ,EAAK,OAAS,EAAuB,EAAK,OAAO,CAAE,CAQvG,SAAS,EAAa,EAAmC,CACvD,IAAI,EAAY,GAWhB,OATI,OAAO,GAAS,WAAY,EACvB,GACL,WAAY,IACd,EAAY,MAAM,QAAQ,EAAK,OAAO,CAClC,EAAK,OAAO,MAAM,GAAO,EAAW,EAAI,CAAC,CACzC,EAAW,EAAK,OAAO,EAEzB,YAAa,IACf,EAAY,OAAO,EAAK,SAAY,UAC/B,GAQT,SAAS,EAAgC,EAA8E,CACrH,OAAO,EAAa,EAAW,GAAG,CAQpC,SAAS,EAAwB,EAAgE,CAC/F,OAAO,EAAW,KAAO,EAY3B,SAAgB,EAAmB,EAA+C,CAEhF,IAAM,EAAsB,EAAQ,UAAU,GAAU,EAAqB,EAAO,CAAC,CACrF,GAAI,IAAwB,GAC1B,OAAO,EAOT,IAAM,EAAiB,EAAQ,GACzB,EAAsD,EAAa,EAAe,GAAG,CACvF,EAAmB,EAAe,GAAG,CACrC,EASJ,OAAO,EAAQ,KAAK,EAA0B,IAAyD,CAErG,GAAI,GAAS,GAAuB,CAAC,EAAqB,EAAQ,CAChE,OAAO,EAGT,GAAI,EAAc,EAAQ,CAAE,CAC1B,IAAM,EAAiB,EAAmB,EAAQ,GAAG,CAErD,GAAI,EAAe,SAAW,GAC5B,EAAa,OAAS,OAEnB,CACH,IAAM,EAAmB,EAAuB,EAAe,OAAO,CAClE,MAAM,QAAQ,EAAa,OAAO,CACpC,EAAa,OAAO,KAAK,GAAG,EAAO,CAGnC,EAAa,OAAS,EAItB,OAAO,EAAe,SAAY,WACpC,EAAa,QAAU,EAAe,WAG1C,CAAC,OAAO,GAAc,IAAe,IAAA,GAAU"}
+{"version":3,"file":"setupGitPluginSpec.mjs","names":[],"sources":["../src/setupGitPluginSpec.ts"],"sourcesContent":["// @ts-types=\"./semantic-release__git.d.ts\"\nimport type { AssetEntry, Options as GitOptions } from '@semantic-release/git';\nimport type { PluginSpecSRGit, PluginSpecTuple } from './semanticReleaseConfig.ts';\nimport { DefaultOptions } from './setupGitPluginSpec.default.ts';\n\nexport const GitPluginId = '@semantic-release/git';\nexport { DefaultOptions } from './setupGitPluginSpec.default.ts';\n\n/**\n * Check if {@link unk} is an {@link AssetEntry}.\n * @param unk Anything.\n * @returns `true` if {@link unk} is an {@link AssetEntry}. Else, `false`.\n */\nfunction isGitAsset(unk: unknown): unk is AssetEntry {\n  if (typeof unk === 'string')\n    return true;\n  // Avoid ending condition with `typeof unk.path === 'string'`.\n  // TS narrowing is bugged; requires the check to be performed TWICE!!\n  if (typeof unk === 'object' && unk != undefined && 'path' in unk) {\n    return typeof unk.path === 'string';\n  }\n  return false;\n}\n\n/**\n * Convert one or more {@link AssetEntry AssetEntries} to a `string[]`.\n * @param assets The `assets` property of a {@link GitOptions} object. This may not be `false`.\n * @returns A `string[]` of the given {@link AssetEntry} objects or strings.\n */\nfunction gitAssetsToStringArray(\n  assets: Exclude<GitOptions['assets'], false>,\n): string[] {\n  if (assets === undefined)\n    return [];\n  if (Array.isArray(assets)) {\n    return assets.filter(asset => isGitAsset(asset))\n      .map(v => typeof v === 'string' ? v : v.path);\n  }\n  if (typeof assets === 'string')\n    return [assets] as string[];\n  if (typeof assets.path === 'string')\n    return [assets.path];\n  else\n    throw new TypeError('assets is not typeof GitOptions[\\'assets\\'!');\n}\n\n/**\n * Sanitize a {@link GitOptions} object so its {@link GitOptions#assets} property is either `false` or a `string[]`.\n * @param opts A {@link GitOptions} object.\n * @returns A {@link GitOptions} object whose {@link GitOptions#assets} is `string[] | false`.\n */\nfunction sanitizeGitOptions(opts: GitOptions): Omit<GitOptions, 'assets'> & { assets: string[] | false } {\n  return { ...opts, assets: opts.assets === false ? opts.assets : gitAssetsToStringArray(opts.assets) };\n}\n\n/**\n *Determine if {@link opts} is a {@link GitOptions} object.\n * @param opts Anything.\n * @returns `true` if {@link opts} is a {@link GitOptions} object. Else, `false`.\n */\nfunction isGitOptions(opts: unknown): opts is GitOptions {\n  let isOptions = false;\n\n  if (typeof opts !== 'object' || opts == undefined)\n    return isOptions;\n  if ('assets' in opts) {\n    isOptions = Array.isArray(opts.assets)\n      ? opts.assets.every(unk => isGitAsset(unk))\n      : isGitAsset(opts.assets);\n  }\n  if ('message' in opts)\n    isOptions = typeof opts.message === 'string';\n  return isOptions;\n}\n\n/**\n * Determine if {@link pluginSpec} includes a {@link GitOptions} object.\n * @param pluginSpec a {@link PluginSpecTuple}.\n * @returns `true` if {@link pluginSpec[1]} is a {@link GitOptions} object. Else, `false`.\n */\nfunction hasGitOptions<P extends string>(pluginSpec: PluginSpecTuple<P>): pluginSpec is PluginSpecTuple<P, GitOptions> {\n  return isGitOptions(pluginSpec[1]);\n};\n\n/**\n * Determined if the plugin ID in {@link pluginSpec} is {@link GitPluginId}.\n * @param pluginSpec A {@link PluginSpecTuple}\n * @returns `true` if {@link pluginSpec[0]} is {@link GitPluginId}\n */\nfunction isGitPluginSpecTuple<T>(pluginSpec: [string, T]): pluginSpec is [typeof GitPluginId, T] {\n  return pluginSpec[0] === GitPluginId;\n}\n\n/**\n * https://github.com/semantic-release/git#options\n *\n * This plugin may be deprecated at a later date.\n * Q: Why would I need to commit during release?\n * A: This is for committing your changelog, README, and/or other files updated during the release procedure.\n * @param plugins An ordered array of {@link PluginSpecTuple PluginSpecTuples}.\n * @returns A {@link PluginSpecTuple}[]. Duplicate `@semantic-release/git` plugin entries are merged or overridden. The last entry takes priority e.g. if the last entry is `{assets: false}`, previous entries' assets are ignored.\n */\nexport function setupGitPluginSpec(plugins: PluginSpecTuple[]): PluginSpecTuple[] {\n  /** if Git plugin not in load order, return as-is. */\n  const firstGitPluginIndex = plugins.findIndex(plugin => isGitPluginSpecTuple(plugin));\n  if (firstGitPluginIndex === -1)\n    return plugins;\n\n  /**\n   * the following two const variables are references--not clones.\n   * Modifying them will affect the plugins array.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n  const firstGitPlugin = plugins[firstGitPluginIndex]!;\n  const firstGitOpts: ReturnType<typeof sanitizeGitOptions> = isGitOptions(firstGitPlugin[1])\n    ? sanitizeGitOptions(firstGitPlugin[1])\n    : DefaultOptions;\n\n  /**\n   * remove duplicate Git plugin entries;\n   * merge extra options into firstGitPlugin's options\n   * if `firstGitOpts.assets === false`, do not change it.\n   * All duplicate PluginSpecSRGit entries are then reassigned `undefined` and all\n   * `undefined` items are filtered from the plugins array.\n   */\n  return plugins.map((current: PluginSpecTuple, index): PluginSpecTuple | PluginSpecSRGit | undefined => {\n    // skip everything up to and including the first Git PluginSpec\n    if (index <= firstGitPluginIndex || !isGitPluginSpecTuple(current))\n      return current;\n\n    /** if another Git PluginSpec is discovered, copy its options to the first Git PluginSpec and return undefined. */\n    if (hasGitOptions(current)) {\n      const currentGitOpts = sanitizeGitOptions(current[1]);\n\n      if (currentGitOpts.assets === false) {\n        firstGitOpts.assets = false;\n      }\n      else {\n        const assets: string[] = gitAssetsToStringArray(currentGitOpts.assets);\n        if (Array.isArray(firstGitOpts.assets)) {\n          firstGitOpts.assets.push(...assets);\n        }\n        else {\n          firstGitOpts.assets = assets;\n        }\n      }\n\n      if (typeof currentGitOpts.message === 'string')\n        firstGitOpts.message = currentGitOpts.message;\n    }\n    return undefined;\n  }).filter(pluginSpec => pluginSpec !== undefined);\n}\n"],"mappings":";;AAKA,MAAa,cAAc;;;;;;AAQ3B,SAAS,WAAW,KAAiC;AACnD,KAAI,OAAO,QAAQ,SACjB,QAAO;AAGT,KAAI,OAAO,QAAQ,YAAY,OAAO,KAAA,KAAa,UAAU,IAC3D,QAAO,OAAO,IAAI,SAAS;AAE7B,QAAO;;;;;;;AAQT,SAAS,uBACP,QACU;AACV,KAAI,WAAW,KAAA,EACb,QAAO,EAAE;AACX,KAAI,MAAM,QAAQ,OAAO,CACvB,QAAO,OAAO,QAAO,UAAS,WAAW,MAAM,CAAC,CAC7C,KAAI,MAAK,OAAO,MAAM,WAAW,IAAI,EAAE,KAAK;AAEjD,KAAI,OAAO,WAAW,SACpB,QAAO,CAAC,OAAO;AACjB,KAAI,OAAO,OAAO,SAAS,SACzB,QAAO,CAAC,OAAO,KAAK;KAEpB,OAAM,IAAI,UAAU,4CAA8C;;;;;;;AAQtE,SAAS,mBAAmB,MAA6E;AACvG,QAAO;EAAE,GAAG;EAAM,QAAQ,KAAK,WAAW,QAAQ,KAAK,SAAS,uBAAuB,KAAK,OAAO;EAAE;;;;;;;AAQvG,SAAS,aAAa,MAAmC;CACvD,IAAI,YAAY;AAEhB,KAAI,OAAO,SAAS,YAAY,QAAQ,KAAA,EACtC,QAAO;AACT,KAAI,YAAY,KACd,aAAY,MAAM,QAAQ,KAAK,OAAO,GAClC,KAAK,OAAO,OAAM,QAAO,WAAW,IAAI,CAAC,GACzC,WAAW,KAAK,OAAO;AAE7B,KAAI,aAAa,KACf,aAAY,OAAO,KAAK,YAAY;AACtC,QAAO;;;;;;;AAQT,SAAS,cAAgC,YAA8E;AACrH,QAAO,aAAa,WAAW,GAAG;;;;;;;AAQpC,SAAS,qBAAwB,YAAgE;AAC/F,QAAO,WAAW,OAAO;;;;;;;;;;;AAY3B,SAAgB,mBAAmB,SAA+C;;CAEhF,MAAM,sBAAsB,QAAQ,WAAU,WAAU,qBAAqB,OAAO,CAAC;AACrF,KAAI,wBAAwB,GAC1B,QAAO;;;;;CAOT,MAAM,iBAAiB,QAAQ;CAC/B,MAAM,eAAsD,aAAa,eAAe,GAAG,GACvF,mBAAmB,eAAe,GAAG,GACrC;;;;;;;;AASJ,QAAO,QAAQ,KAAK,SAA0B,UAAyD;AAErG,MAAI,SAAS,uBAAuB,CAAC,qBAAqB,QAAQ,CAChE,QAAO;;AAGT,MAAI,cAAc,QAAQ,EAAE;GAC1B,MAAM,iBAAiB,mBAAmB,QAAQ,GAAG;AAErD,OAAI,eAAe,WAAW,MAC5B,cAAa,SAAS;QAEnB;IACH,MAAM,SAAmB,uBAAuB,eAAe,OAAO;AACtE,QAAI,MAAM,QAAQ,aAAa,OAAO,CACpC,cAAa,OAAO,KAAK,GAAG,OAAO;QAGnC,cAAa,SAAS;;AAI1B,OAAI,OAAO,eAAe,YAAY,SACpC,cAAa,UAAU,eAAe;;GAG1C,CAAC,QAAO,eAAc,eAAe,KAAA,EAAU"}

package/mjs/utils/Exact.d.mts

@@ -1,17 +1,17 @@
 //#region src/utils/Exact.d.ts
 /**
-* ### `Exact<T, S>`
-*
-* [issue](https://github.com/microsoft/TypeScript/issues/12936#issuecomment-2816928183)\
-* [author](https://github.com/ahrjarrett)\
-* license: unlicensed[!]
-* @see
-* - {@link https://tsplay.dev/NnGG6m}
-*/
+ * ### `Exact<T, S>`
+ *
+ * [issue](https://github.com/microsoft/TypeScript/issues/12936#issuecomment-2816928183)\
+ * [author](https://github.com/ahrjarrett)\
+ * license: unlicensed[!]
+ * @see
+ * - {@link https://tsplay.dev/NnGG6m}
+ */
 type Exact<T, S> = [keyof T] extends [keyof S] ? [T] extends [S] ? { [K in keyof T]: T[K] } : S : { [K in keyof T as K extends keyof S ? never : K]: TypeError<`Excess: '${Coerce<K>}'`> };
 interface TypeError<Message> {
-  [" TypeError"]: Message;
-}
+  [' TypeError']: Message;
+} // prior art: use arktype's ^^^ leading whitespace trick to avoid collisions
 type Coerce<T> = `${T & (string | number)}`;
 //#endregion
 export { Exact };

package/mjs/utils/Exact.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"Exact.d.mts","names":[],"sources":["../../src/utils/Exact.ts"],"mappings":";;AASA;;;;;;;;KAAY,KAAA,gBAAqB,CAAA,iBAAkB,CAAA,KAC9C,CAAA,WAAY,CAAA,kBAAmB,CAAA,GAAI,CAAA,CAAE,CAAA,MAAO,CAAA,iBAC/B,CAAA,IAAK,CAAA,eAAgB,CAAA,WAAY,CAAA,GAAI,SAAA,aAAsB,MAAA,CAAO,CAAA;AAAA,UA2B1E,SAAA;EAAA,CAAsB,YAAA,GAAe,OAAA;AAAA;AAAA,KAG1C,MAAA,SAAe,CAAA"}
+{"version":3,"file":"Exact.d.mts","names":["Exact","T","S","K","Coerce","TypeError","Message"],"sources":["../../src/utils/Exact.d.ts"],"mappings":";;AASA;;;;;;;;KAAYA,KAAAA,gBAAqBC,CAAAA,iBAAkBC,CAAAA,KAC9CD,CAAAA,WAAYC,CAAAA,kBAAmBD,CAAAA,GAAIA,CAAAA,CAAEE,CAAAA,MAAOD,CAAAA,iBAC/BD,CAAAA,IAAKE,CAAAA,eAAgBD,CAAAA,WAAYC,CAAAA,GAAIE,SAAAA,aAAsBD,MAAAA,CAAOD,CAAAA;AAAAA,UAE1EE,SAAAA;EAAAA,CAAsB,YAAA,GAAeC,OAAAA;AAAAA;AAAAA,KAG1CF,MAAAA,SAAeH,CAAAA"}