@halospv3/hce.shared-config 3.4.6 → 3.4.7

package/mjs/semanticReleaseConfigDotnet.mjs

@@ -1,274 +1,7 @@
-import { inspect } from 'node:util';
-import _debug from './debug.mjs';
-import { configurePrepareCmd, configureDotnetNugetPush } from './dotnet/helpers.mjs';
-import { getEnvVarValue } from './utils/env.mjs';
-import { baseConfig } from './semanticReleaseConfig.mjs';
-import { NugetRegistryInfo } from './dotnet/NugetRegistryInfo.mjs';
-import { MSBuildProject } from './dotnet/MSBuildProject.mjs';
-import { insertPlugin } from './insertPlugins.mjs';
-
-/**
- * # 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}
- */
-
-class SemanticReleaseConfigDotnet {
-  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;
-    /* normalize PluginSpecs to tuples */
-    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(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(new Error('projectsToPackAndPush.length must be > 0 or PROJECTS_TO_PACK_AND_PUSH must be defined and contain at least one path.'));
-      }
-    }
-
-    // may be zero-length array
-    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;
-  }
-
-  // eslint-disable-next-line jsdoc/require-param
-  /** @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) {
-      const message = `\
-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!`;
-      console.warn(message);
-      srExecIndex = this.options.plugins.push(['@semantic-release/exec', {}]) - 1;
-    }
-    const plugin = this.options.plugins[srExecIndex];
-    const execOptions = plugin[1];
-
-    // ensure all packable projects are evaluated
-    // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion
-    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);
-
-        // if the user doesn't want a defaulted NRI, they should pass their own NRI (or derived) instance.
-        return packableProjects.map(project => new NugetRegistryInfo({
-          project
-        }));
-      } else return [project];
-    })).then(p => p.flat());
-
-    // todo: double-check token-testing commands. Are they formatted prepended correctly?
-    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);
-
-    // 'ZipPublishDir' zips each publish folder to ./publish/*.zip
-    execOptions.prepareCmd = execOptions.prepareCmd && execOptions.prepareCmd.trim().length > 0 ? `${execOptions.prepareCmd} && ${prepareCmdAppendix}` : prepareCmdAppendix;
-
-    // FINISHED execOptions.prepareCmd
-    // STARTING execOptions.publishCmd
-    if (this._projectsToPackAndPush.length > 0) {
-      const publishCmdAppendix = configureDotnetNugetPush(this._projectsToPackAndPush);
-      execOptions.publishCmd = execOptions.publishCmd && execOptions.publishCmd.trim().length > 0 ? `${execOptions.publishCmd} && ${publishCmdAppendix}` : publishCmdAppendix;
-    }
-
-    // FINISHED execOptions.publishCmd
-  }
-
-  /**
-   * 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]);
-
-    // if any beforePluginIDs are ordered before the last afterPlugin, throw. Impossible to sort.
-
-    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(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, {}]));
-  }
-
-  // todo: join result with dummy pack commands
-  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
-    }));
-    const nupkgPaths = await Promise.all(regInfos.map(async nri => nri.PackDummyPackage({}).then(nupkgs => {
-      // this is a full file path.
-      const mainNupkg = nupkgs.find(nupkg => new RegExp(/(?<!symbols)\.nupkg$/).test(nupkg));
-      if (mainNupkg !== undefined) return {
-        nri: 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".');
-    })));
-    const pushCommands = nupkgPaths.map(pair => pair.nri.GetPushDummyCommand({}));
-    return pushCommands.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 (_ === undefined) errors.push(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 (_ === undefined) errors.push(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
- */
-
-export { SemanticReleaseConfigDotnet, getConfig };
-//# sourceMappingURL=semanticReleaseConfigDotnet.mjs.map
+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};
+//# sourceMappingURL=semanticReleaseConfigDotnet.mjs.map

package/mjs/semanticReleaseConfigDotnet.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"semanticReleaseConfigDotnet.mjs","sources":["../src/semanticReleaseConfigDotnet.ts"],"names":["debug"],"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":"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"}

package/mjs/setupGitPluginSpec.d.mts

@@ -0,0 +1,18 @@
+import { DefaultOptions } from "./setupGitPluginSpec.default.mjs";
+import { PluginSpecTuple } from "./semanticReleaseConfig.mjs";
+
+//#region src/setupGitPluginSpec.d.ts
+declare const GitPluginId = "@semantic-release/git";
+/**
+* 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.
+*/
+declare function setupGitPluginSpec(plugins: PluginSpecTuple[]): PluginSpecTuple[];
+//#endregion
+export { DefaultOptions, GitPluginId, setupGitPluginSpec };
+//# sourceMappingURL=setupGitPluginSpec.d.mts.map

package/mjs/setupGitPluginSpec.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupGitPluginSpec.d.mts","names":[],"sources":["../src/setupGitPluginSpec.ts"],"mappings":";;;;cAKa,WAAA;;AAAb;;;;;AAiGA;;;iBAAgB,kBAAA,CAAmB,OAAA,EAAS,eAAA,KAAoB,eAAA"}

package/mjs/setupGitPluginSpec.default.d.mts

@@ -0,0 +1,13 @@
+//#region src/setupGitPluginSpec.default.d.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 }
+*/
+declare const DefaultOptions: {
+  readonly assets: ["README.md", "CHANGELOG.md", "package.json", "package-lock.json", "npm-shrinkwrap.json"];
+  readonly message: "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}";
+};
+//#endregion
+export { DefaultOptions };
+//# sourceMappingURL=setupGitPluginSpec.default.d.mts.map

package/mjs/setupGitPluginSpec.default.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupGitPluginSpec.default.d.mts","names":[],"sources":["../src/setupGitPluginSpec.default.ts"],"mappings":";;AAQA;;;;cAAa,cAAA;EAAA,SACF,MAAA;EAAA,SACA,OAAA;AAAA"}

package/mjs/setupGitPluginSpec.default.mjs

@@ -0,0 +1,4 @@
+const e={assets:[`README.md`,`CHANGELOG.md`,`package.json`,`package-lock.json`,`npm-shrinkwrap.json`],message:`chore(release): \${nextRelease.version} [skip ci]
+
+\${nextRelease.notes}`};export{e as DefaultOptions};
+//# sourceMappingURL=setupGitPluginSpec.default.mjs.map

package/mjs/setupGitPluginSpec.default.mjs.map

@@ -0,0 +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"}

package/mjs/setupGitPluginSpec.mjs

@@ -1,144 +1,2 @@
-function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
-function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
-function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
-function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-const GitPluginId = '@semantic-release/git';
-
-/**
- * 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}'
-};
-
-/**
- * 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;
-  // Avoid ending condition with `typeof unk.path === 'string'`.
-  // TS narrowing is bugged; requires the check to be performed TWICE!!
-  if (typeof unk === 'object' && unk != undefined && '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 === undefined) 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 _objectSpread(_objectSpread({}, 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 == undefined) 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.
-   */
-  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-  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) => {
-    // skip everything up to and including the first Git PluginSpec
-    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;
-    }
-    return undefined;
-  }).filter(pluginSpec => pluginSpec !== undefined);
-}
-export { DefaultOptions, GitPluginId, setupGitPluginSpec };
-//# sourceMappingURL=setupGitPluginSpec.mjs.map
+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};
+//# sourceMappingURL=setupGitPluginSpec.mjs.map

package/mjs/setupGitPluginSpec.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"setupGitPluginSpec.mjs","sources":["../src/setupGitPluginSpec.ts"],"names":[],"mappings":"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"}
+{"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"}

package/mjs/utils/Exact.d.mts

@@ -0,0 +1,18 @@
+//#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}
+*/
+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;
+}
+type Coerce<T> = `${T & (string | number)}`;
+//#endregion
+export { Exact };
+//# sourceMappingURL=Exact.d.mts.map