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

package/mjs/dotnet/helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.mjs","names":["MSBPP"],"sources":["../../src/dotnet/helpers.ts"],"sourcesContent":["import { type, type Type } from 'arktype';\n// eslint-disable-next-line unicorn/import-style\nimport * as path from 'node:path';\nimport { cwd } from 'node:process';\nimport { MSBuildProject } from './MSBuildProject.ts';\nimport { MSBuildProjectProperties as MSBPP } from './MSBuildProjectProperties.ts';\nimport { NugetRegistryInfo } from './NugetRegistryInfo.ts';\nimport type { Default } from 'arktype/internal/attributes.ts';\n\nconst ourDefaultPubDir = path.join('.', 'publish') as `.${'/' | '\\\\'}publish`;\n\n/**\n * Build a prepareCmd string from .NET projects.\\\n * This will include a `dotnet publish` for each project's RID and TFM permutation,\\\n * `dotnet pack` for each project with output paths separated by NuGet Source and PackageId,\\\n * and `dotnet nuget sign` for each nupkg output directory.\n * @todo parse Solution files to publish all projects with default Publish parameters (as evaluated by MSBuild).\n * @param projectsToPublish An array of relative or full file paths of `.csproj`\n * projects  -OR- an array of {@link MSBuildProject} objects.\n * The project paths will be passed to `dotnet publish` commands.\n * @param projectsToPackAndPush\n *  Relative and/or full file paths of projects to pass to `dotnet pack`. If\n *  string[], only the default NuGet Source will be used. If GitHub, GitLab,\n *  etc. are also desired, pass {@link NugetRegistryInfo}[]\n * @param dotnetNugetSignOpts A {@link DotnetNugetSignOptions} object. The value\n * of the `--output` argument will be set to {@link ourDefaultPubDir} if `undefined`.\n * @returns A single string of CLI commands joined by ' && '\n */\nexport async function configurePrepareCmd(\n  projectsToPublish: string[] | MSBuildProject[],\n  projectsToPackAndPush?: string[] | NugetRegistryInfo[],\n  dotnetNugetSignOpts?: typeof DotnetNugetSignOptions.inferIn,\n): Promise<string> {\n  const evaluatedProjects: MSBuildProject[] = [];\n\n  // append evaluated projects\n  for (const p of projectsToPublish.filter(p => p instanceof MSBuildProject)) {\n    evaluatedProjects.push(p);\n  }\n  if (projectsToPackAndPush) {\n    for (const p of projectsToPackAndPush.filter(p => p instanceof NugetRegistryInfo)) {\n      evaluatedProjects.push(p.project);\n    }\n  }\n\n  const dotnetPublishCmd: string = await formatDotnetPublish(projectsToPublish);\n  const dotnetPackCmd: string | undefined = await formatDotnetPack(projectsToPackAndPush ?? []);\n  const dotnetNugetSignCmd: string | undefined = formatDotnetNugetSign(dotnetNugetSignOpts);\n\n  return [\n    dotnetPublishCmd,\n    dotnetPackCmd,\n    dotnetNugetSignCmd,\n    // remove no-op commands\n  ]\n    .filter(v => v !== undefined)\n    .join(' && ');\n\n  /**\n   * Create a string of CLI commands to run `dotnet publish` or the Publish\n   * MSBuild target for one or more projects.\n   * @async\n   * @param projectsToPublish An array of one or more projects, either\n   * pre-evaluated (see {@link MSBuildProject.Evaluate}) or as full file paths.\\\n   * NOTE: Although `dotnet publish` allows directory or Solution file (.sln,\n   * .slnx) paths, this function expects projects' full or relative file\n   * paths.\n   * @returns A Promise of a string. This string contains one or more `dotnet publish`\n   * commands conjoined by \" && \". It may also include one or more\n   * `dotnet msbuild ${...} -t:PublishAll -p:Configuration=Release` commands.\n   */\n  async function formatDotnetPublish(\n    projectsToPublish: string[] | MSBuildProject[],\n  ): Promise<string> {\n    /* Fun Fact: You can define a property and get the evaluated value in the same command!\n    ```pwsh\n    dotnet msbuild .\\src\\HXE.csproj -property:RuntimeIdentifiers=\"\"\"place;holder\"\"\" -getProperty:RuntimeIdentifiers\n    place;holder\n    ```\n      enclosing with \"\"\" is required in pwsh to prevent the semicolon from breaking the string.\n    */\n    if (!Array.isArray(projectsToPublish) || projectsToPublish.length === 0) {\n      throw new Error(\n        `Type of projectsToPublish (${typeof projectsToPublish}) is not allowed. Expected a string[] or MSBuildProject[] where length > 0.`,\n      );\n    }\n\n    // each may have TargetFramework OR TargetFrameworks (plural)\n    const evaluatedPublishProjects: MSBuildProject[] = await Promise.all(\n      projectsToPublish.map(async (proj): Promise<MSBuildProject> => {\n        if (proj instanceof MSBuildProject)\n          return proj;\n\n        // filter for projects whose full paths match the full path of the given string\n        const filteredProjects = evaluatedProjects.filter(p =>\n          p.Properties.MSBuildProjectFullPath === MSBPP.GetFullPath(proj),\n        );\n\n        // if no pre-existing MSBuildProject found,\n        // evaluate a new one and push it\n        if (filteredProjects.length === 0) {\n          const _proj = await MSBuildProject.Evaluate({\n            FullName: proj,\n            GetProperty: MSBuildProject.MatrixProperties,\n            GetItem: [],\n            GetTargetResult: [],\n            Property: {},\n            Targets: ['Restore'],\n          });\n          evaluatedProjects.push(_proj);\n          return _proj;\n        }\n\n        /**\n         * Finds and returns the subjectively \"best\" project in {@link filteredProjects}\n         * @returns the subjective \"best\" project in {@link filteredProjects}\n         */\n        function getBest() {\n          let best: MSBuildProject | undefined;\n          if (filteredProjects.length > 0 && (best = filteredProjects[0]) instanceof MSBuildProject)\n            return best;\n          throw new Error('No MSBuildProjects could be found!');\n        }\n\n        /*\n        todo: improve filtering to select \"optimal\" instance.\n          Which properties are most-needed?\n          For now, we just pray the project has a well-defined publish flow e.g.\n          @halospv3/hce.shared-config/dotnet/PublishAll.targets\n         */\n        return getBest();\n      }),\n    );\n\n    /**\n     * Returns an array of one or more `dotnet` arguments.\n     * @param proj An {@link MSBuildProject} to be published for one or more\n     * runtime-framework combinations.\n     * @returns If {@link proj} imports {@link ../../dotnet/PublishAll.targets}...\n     * ```\n     * [`${proj.Properties.MSBuildProjectFullPath} -t:PublishAll -p:Configuration=Release`]\n     * ```\n     * Else, an array of `dotnet publish` arguments permutations e.g.\n     * ```\n     * [\n     *   'myProj.csproj --runtime win7-x86 --framework net6.0',\n     *   'myProj.csproj --runtime win7-x64 --framework net6.0'\n     * ]\n     * ```\n     * @example\n     * const publishCmdArray = [];\n     * const permutations = getPublishArgsPermutations(msbuildProject);\n     * for (const permutation of permutations) {\n     *   if (permutation[0] === 'PublishAll') {\n     *     // 'dotnet msbuild full/path/to/myProj.csproj t:PublishAll'\n     *     publishCmdArray.push(`dotnet msbuild ${permutation[1]}`)\n     *   }\n     *   else {\n     *     publishCmdArray.push(`dotnet publish ${permutation}`)\n     *   }\n     * }\n     * // return array as success-chained CLI commands.\n     * return publishCmdArray.join(' && ');\n     */\n    function getPublishArgsPermutations(proj: MSBuildProject):\n      ([`\"${typeof proj.Properties.MSBuildProjectFullPath}\" -t:PublishAll -p:Configuration=Release`])\n      | ([`\"${typeof proj.Properties.MSBuildProjectFullPath}\"`])\n      | (`\"${typeof proj.Properties.MSBuildProjectFullPath}\" --runtime ${string} --framework ${string}`)[]\n      | (`\"${typeof proj.Properties.MSBuildProjectFullPath}\" --runtime ${string}`)[]\n      | (`\"${typeof proj.Properties.MSBuildProjectFullPath}\" --framework ${string}`)[] {\n      /**\n       * If the project imports PublishAll to publish for each TFM-RID\n       * permutation, return the appropriate command line.\n       */\n      if (proj.Targets.includes('PublishAll'))\n        return [`\"${proj.Properties.MSBuildProjectFullPath}\" -t:PublishAll -p:Configuration=Release`];\n\n      // #region formatFrameworksAndRuntimes\n      const tfmRidPermutations: `--runtime ${string} --framework ${string}`[]\n        | `--runtime ${string}`[]\n        | `--framework ${string}`[]\n          = []; // forEach, run dotnet [proj.Properties.MSBuildProjectFullPath,...v]\n      const RIDs: string[] = proj.Properties.RuntimeIdentifiers.split(';').filter(v => v !== '');\n      const TFMs: string[] = proj.Properties.TargetFrameworks.split(';').filter(v => v !== '');\n\n      if (TFMs.length === 0 && RIDs.length === 0)\n        return [`\"${proj.Properties.MSBuildProjectFullPath}\"`] as [`\"${string}\"`];\n\n      if (RIDs.length > 0) {\n        if (TFMs.length > 0) {\n          for (const RID of RIDs) {\n            for (const TFM of TFMs) {\n              (tfmRidPermutations as `--runtime ${string} --framework ${string}`[]).push(\n                `--runtime ${RID} --framework ${TFM}`,\n              );\n            }\n          }\n        }\n        else {\n          // assume singular TFM. No need to specify it.\n          for (const RID of RIDs) {\n            (tfmRidPermutations as `--runtime ${string}`[]).push(\n              `--runtime ${RID}`,\n            );\n          }\n        }\n      }\n      else if (TFMs.length > 0) {\n        for (const TFM of TFMs) {\n          (tfmRidPermutations as `--framework ${string}`[]).push(`--framework ${TFM}`);\n        }\n      }\n\n      /** prepend each set of args with the project's path */\n      return tfmRidPermutations.map(permArgs =>\n        `\"${proj.Properties.MSBuildProjectFullPath}\" ${permArgs}`,\n      ) as `\"${typeof proj.Properties.MSBuildProjectFullPath}\" --runtime ${string} --framework ${string}`[]\n      | `\"${typeof proj.Properties.MSBuildProjectFullPath}\" --runtime ${string}`[]\n      | `\"${typeof proj.Properties.MSBuildProjectFullPath}\" --framework ${string}`[];\n      // #endregion formatFrameworksAndRuntimes\n    }\n\n    const publishCmds: (`dotnet publish \"${string}\"` | `dotnet publish \"${string}\" ${string}` | `dotnet msbuild \"${string}\" -t:PublishAll -p:Configuration=Release`)[] = [];\n    /** convert {@link evaluatedPublishProjects} to sets of space-separated CLI args. */\n    const argsSets = evaluatedPublishProjects.map(\n      proj => getPublishArgsPermutations(proj),\n    );\n    for (const args of argsSets) {\n      if (typeof args === 'string')\n        throw new Error(`\\`args\\` should not be a string!`);\n      for (const permutation of args) {\n        if (typeof permutation === 'string' && permutation.length === 1)\n          throw new Error('Something has gone terribly wrong. A `dotnet publish` argument set was split to single characters!');\n        if (/\".+\" -t:PublishAll -p:Configuration=Release/.test(permutation))\n          publishCmds.push(`dotnet msbuild ${permutation as `\"${string}\" -t:PublishAll -p:Configuration=Release`}`);\n        else\n          publishCmds.push(`dotnet publish ${permutation}`);\n      }\n    }\n\n    // For each argSet, create a new exec command. Then, join all commands with ' && ' so they are executed serially, synchronously.\n    // e.g. `dotnet publish project.csproj --runtime win7-x86 --framework net6.0 && dotnet publish project.csproj --runtime win-x64 --framework net8.0\n    return publishCmds.join(' && ');\n  }\n\n  /**\n   * @param projectsToPackAndPush a string[] or {@link NugetRegistryInfo}[].\n   * If a string[], the string must be the platform-dependent (not file://),\n   * full path(s) to one or more projects with the .NET \"Pack\" MSBuild target.\n   * See {@link https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-pack}\n   * for command line usage.\n   * @returns one or more command line strings joined with ' && '.\n   * Each command line comprises the `dotnet pack` command, a project file path,\n   * and a hardcoded output path (`--output ${cwd()}/publish`)\n   */\n  async function formatDotnetPack(\n    projectsToPackAndPush: string[] | NugetRegistryInfo[],\n  ): Promise<string | undefined> {\n    if (projectsToPackAndPush.length === 0)\n      return undefined;\n    return await Promise.all(\n      projectsToPackAndPush.map(async (proj) => {\n        if (proj instanceof NugetRegistryInfo)\n          return proj;\n\n        const msbpArr: MSBuildProject[] = await Promise.all(await MSBuildProject.PackableProjectsToMSBuildProjects([proj]));\n        if (msbpArr.length === 0 || msbpArr[0] === undefined) {\n          throw new Error('This should be impossible!');\n        }\n        const msbp: MSBuildProject = msbpArr[0];\n\n        evaluatedProjects.push(msbp);\n\n        return new NugetRegistryInfo({ project: msbp });\n      }),\n    ).then((nriArray: NugetRegistryInfo[]): string => {\n      return nriArray\n        .map((nri: NugetRegistryInfo): string =>\n          nri.GetPackCommand(NugetRegistryInfo.PackPackagesOptionsType.from({})),\n        ).join(' && ');\n    });\n  }\n}\n\n/**\n * Prepare the CLI command to push NuGet packages. This should added to the `publishCmd` option of `@semantic-release/exec`\n *\n * Ensure your verifyConditionsCmd is set to prevent releases failing due to bad tokens or packages!\n * See {@link NugetRegistryInfo#PackDummyPackage}, {@link NugetRegistryInfo#GetPushDummyCommand}\n * @param registryInfos an array of {@link NugetRegistryInfo} (or derived classes) instances.\n * @param packageOutputPath Default: `${cwd()}/publish`.\\\n * The directory at which dotnet outputs the given projects' packages. Passed to\n * `dotnet pack` via the `--output` argument.\n * @returns a string of `dotnet pack` and `dotnet push` commands, joined by ' && '.\n */\nexport function configureDotnetNugetPush(\n  registryInfos: NugetRegistryInfo[],\n  // Explicit type required by JSR\n  // eslint-disable-next-line @typescript-eslint/no-inferrable-types\n  packageOutputPath: string = `${cwd()}/publish`,\n): string {\n  if (registryInfos.some(registry => registry.source.trim() === ''))\n    throw new Error('The URL for one of the provided NuGet registries was empty or whitespace.');\n\n  const packCmds = registryInfos.map(\n    (nri): string =>\n      nri.GetPackCommand(\n        { output: packageOutputPath },\n        true,\n        true,\n      ),\n  );\n\n  const pushCmds = registryInfos.map(nri => nri.GetPushCommand({ root: packageOutputPath }, true, true));\n\n  return [...packCmds, ...pushCmds].join(' && ');\n}\n\n/**\n * You should try {@link ../../dotnet/SignAfterPack.targets}!.\n * @param opts A {@link DotnetNugetSignOptions} object to be deconstructed and\n * passed to `dotnet nuget sign` as args.\n * @returns `dotnet nuget sign {...}`\n */\nfunction formatDotnetNugetSign(\n  opts: typeof DotnetNugetSignOptions.inferIn | undefined,\n): string | undefined {\n  if (opts === undefined)\n    return undefined;\n\n  const validOpts = DotnetNugetSignOptions.from(opts);\n  const args: ['--timestamper', typeof validOpts.timestamper, '-o', string, ...string[]] = [\n    '--timestamper', validOpts.timestamper,\n    '-o', validOpts.output ?? ourDefaultPubDir,\n  ];\n  if (validOpts.certificatePassword)\n    args.push('---certificate-password', validOpts.certificatePassword);\n  if (validOpts.hashAlgorithm)\n    args.push('--hash-algorithm', validOpts.hashAlgorithm);\n  if (validOpts.overwrite)\n    args.push('--overwrite');\n  if (validOpts.timestampHashAlgorithm)\n    args.push('--timestamp-hash-algorithm', validOpts.timestampHashAlgorithm);\n  if (validOpts.verbosity)\n    args.push('-v', validOpts.verbosity);\n\n  if ('certificatePath' in validOpts)\n    args.push('--certificate-path', validOpts.certificatePath);\n  else if ('certificateStoreName' in validOpts) {\n    SetSubjectNameOrFingerprint();\n    args.push('--certificate-store-name', validOpts.certificateStoreName);\n  }\n  else if ('certificateStoreLocation' in validOpts) {\n    SetSubjectNameOrFingerprint();\n    args.push('--certificate-store-location', validOpts.certificateStoreLocation);\n  }\n  else throw new Error('No code signing certificate was specified!');\n\n  return `dotnet nuget sign ${args.join(' ')} `;\n\n  // eslint-disable-next-line jsdoc/require-jsdoc\n  function SetSubjectNameOrFingerprint() {\n    if ('certificateSubjectName' in validOpts)\n      args.push('--certificate-subject-name', validOpts.certificateSubjectName);\n\n    else if ('certificateFingerprint' in validOpts)\n      args.push('--certificate-fingerprint', validOpts.certificateFingerprint);\n    else throw new Error('If certificateStoreName or certificateStoreLocation is set, either certificateSubjectName or certificateFingerprint must also be set!');\n  }\n}\n\nconst DotnetNugetSignOptions: Type<\n  {\n    timestamper: Default<string, 'https://rfc3161.ai.moda/'>;\n    certificatePassword?: string | undefined;\n    hashAlgorithm?: string | undefined;\n    output?: string | undefined;\n    overwrite?: true | undefined;\n    timestampHashAlgorithm?: string | undefined;\n    verbosity?: 'q' | 'quiet' | 'm' | 'minimal' | 'n' | 'normal' | 'd' | 'detailed' | 'diag' | 'diagnostic';\n  } & ({\n    certificatePath: string;\n    certificateSubjectName: string;\n  } | {\n    certificatePath: string;\n    certificateFingerprint: string;\n  } | {\n    certificateStoreName: string;\n    certificateSubjectName: string;\n  } | {\n    certificateStoreName: string;\n    certificateFingerprint: string;\n  } | {\n    certificateStoreLocation: string;\n    certificateSubjectName: string;\n  } | {\n    certificateStoreLocation: string;\n    certificateFingerprint: string;\n  })> = type({\n  /**\n   * Password for the certificate, if needed. This option can be used to specify\n   * the password for the certificate. The command will throw an error message\n   * if certificate is password protected but password is not provided as input.\n   */\n  'certificatePassword?': 'string',\n  /**\n   * Hash algorithm to be used to sign the package. Defaults to SHA256.\n   */\n  'hashAlgorithm?': 'string | \"SHA256\"',\n  /**\n   * Directory where the signed package(s) should be saved. By default the\n   * original package is overwritten by the signed package.\n   */\n  'output?': 'string',\n  /**\n   * Switch to indicate if the current signature should be overwritten. By\n   * default the command will fail if the package already has a signature.\n   */\n  'overwrite?': 'true',\n  /**\n   * URL to an RFC 3161 timestamping server.\n   */\n  timestamper: 'string = \"https://rfc3161.ai.moda/\"',\n  /**\n   * Hash algorithm to be used to sign the package. Defaults to SHA256.\n   */\n  'timestampHashAlgorithm?': 'string | \"SHA256\"',\n  /**\n   * Set the verbosity level of the command. Allowed values are q[uiet],\n   * m[inimal], n[ormal], d[etailed], and diag[nostic].\n   */\n  'verbosity?': '\"q\"|\"quiet\"|\"m\"|\"minimal\"|\"n\"|\"normal\"|\"d\"|\"detailed\"|\"diag\"|\"diagnostic\"',\n}).and(\n  type({\n    /**\n     * File path to the certificate to be used while signing the package.\n     */\n    certificatePath: 'string',\n  }).or(\n    type({\n      /**\n       * Name of the X.509 certificate store to use to search for the\n       * certificate. Defaults to \"My\", the X.509 certificate store for personal\n       * certificates.\n       *\n       * This option should be used when specifying the certificate via\n       * --certificate-subject-name or --certificate-fingerprint options.\n       */\n      certificateStoreName: 'string',\n    }).or({\n      /**\n       * Name of the X.509 certificate store use to search for the\n       * certificate. Defaults to \"CurrentUser\", the X.509 certificate store\n       * used by the current user.\n       *\n       * This option should be used when specifying the certificate via\n       * --certificate-subject-name or --certificate-fingerprint options.\n       */\n      certificateStoreLocation: 'string',\n    }),\n  ).and(\n    type({\n      /**\n       * Subject name of the certificate used to search a local certificate\n       * store for the certificate. The search is a case-insensitive string\n       * comparison using the supplied value, which will find all certificates\n       * with the subject name containing that string, regardless of other\n       * subject values. The certificate store can be specified by\n       * --certificate-store-name and --certificate-store-location options.\n       */\n      certificateSubjectName: 'string',\n    }).or({\n      /**\n       * SHA-256, SHA-384 or SHA-512 fingerprint of the certificate used to\n       * search a local certificate store for the certificate. The certificate\n       * store can be specified by --certificate-store-name and\n       * --certificate-store-location options.\n       */\n      certificateFingerprint: 'string',\n    }),\n  ),\n);\n"],"mappings":"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"}
+{"version":3,"file":"helpers.mjs","names":["MSBPP"],"sources":["../../src/dotnet/helpers.ts"],"sourcesContent":["import { type, type Type } from 'arktype';\n// eslint-disable-next-line unicorn/import-style\nimport * as path from 'node:path';\nimport { cwd } from 'node:process';\nimport { MSBuildProject } from './MSBuildProject.ts';\nimport { MSBuildProjectProperties as MSBPP } from './MSBuildProjectProperties.ts';\nimport { NugetRegistryInfo } from './NugetRegistryInfo.ts';\nimport type { Default } from 'arktype/internal/attributes.ts';\n\nconst ourDefaultPubDir = path.join('.', 'publish') as `.${'/' | '\\\\'}publish`;\n\n/**\n * Build a prepareCmd string from .NET projects.\\\n * This will include a `dotnet publish` for each project's RID and TFM permutation,\\\n * `dotnet pack` for each project with output paths separated by NuGet Source and PackageId,\\\n * and `dotnet nuget sign` for each nupkg output directory.\n * @todo parse Solution files to publish all projects with default Publish parameters (as evaluated by MSBuild).\n * @param projectsToPublish An array of relative or full file paths of `.csproj`\n * projects  -OR- an array of {@link MSBuildProject} objects.\n * The project paths will be passed to `dotnet publish` commands.\n * @param projectsToPackAndPush\n *  Relative and/or full file paths of projects to pass to `dotnet pack`. If\n *  string[], only the default NuGet Source will be used. If GitHub, GitLab,\n *  etc. are also desired, pass {@link NugetRegistryInfo}[]\n * @param dotnetNugetSignOpts A {@link DotnetNugetSignOptions} object. The value\n * of the `--output` argument will be set to {@link ourDefaultPubDir} if `undefined`.\n * @returns A single string of CLI commands joined by ' && '\n */\nexport async function configurePrepareCmd(\n  projectsToPublish: string[] | MSBuildProject[],\n  projectsToPackAndPush?: string[] | NugetRegistryInfo[],\n  dotnetNugetSignOpts?: typeof DotnetNugetSignOptions.inferIn,\n): Promise<string> {\n  const evaluatedProjects: MSBuildProject[] = [];\n\n  // append evaluated projects\n  for (const p of projectsToPublish.filter(p => p instanceof MSBuildProject)) {\n    evaluatedProjects.push(p);\n  }\n  if (projectsToPackAndPush) {\n    for (const p of projectsToPackAndPush.filter(p => p instanceof NugetRegistryInfo)) {\n      evaluatedProjects.push(p.project);\n    }\n  }\n\n  const dotnetPublishCmd: string = await formatDotnetPublish(projectsToPublish);\n  const dotnetPackCmd: string | undefined = await formatDotnetPack(projectsToPackAndPush ?? []);\n  const dotnetNugetSignCmd: string | undefined = formatDotnetNugetSign(dotnetNugetSignOpts);\n\n  return [\n    dotnetPublishCmd,\n    dotnetPackCmd,\n    dotnetNugetSignCmd,\n    // remove no-op commands\n  ]\n    .filter(v => v !== undefined)\n    .join(' && ');\n\n  /**\n   * Create a string of CLI commands to run `dotnet publish` or the Publish\n   * MSBuild target for one or more projects.\n   * @async\n   * @param projectsToPublish An array of one or more projects, either\n   * pre-evaluated (see {@link MSBuildProject.Evaluate}) or as full file paths.\\\n   * NOTE: Although `dotnet publish` allows directory or Solution file (.sln,\n   * .slnx) paths, this function expects projects' full or relative file\n   * paths.\n   * @returns A Promise of a string. This string contains one or more `dotnet publish`\n   * commands conjoined by \" && \". It may also include one or more\n   * `dotnet msbuild ${...} -t:PublishAll -p:Configuration=Release` commands.\n   */\n  async function formatDotnetPublish(\n    projectsToPublish: string[] | MSBuildProject[],\n  ): Promise<string> {\n    /* Fun Fact: You can define a property and get the evaluated value in the same command!\n    ```pwsh\n    dotnet msbuild .\\src\\HXE.csproj -property:RuntimeIdentifiers=\"\"\"place;holder\"\"\" -getProperty:RuntimeIdentifiers\n    place;holder\n    ```\n      enclosing with \"\"\" is required in pwsh to prevent the semicolon from breaking the string.\n    */\n    if (!Array.isArray(projectsToPublish) || projectsToPublish.length === 0) {\n      throw new Error(\n        `Type of projectsToPublish (${typeof projectsToPublish}) is not allowed. Expected a string[] or MSBuildProject[] where length > 0.`,\n      );\n    }\n\n    // each may have TargetFramework OR TargetFrameworks (plural)\n    const evaluatedPublishProjects: MSBuildProject[] = await Promise.all(\n      projectsToPublish.map(async (proj): Promise<MSBuildProject> => {\n        if (proj instanceof MSBuildProject)\n          return proj;\n\n        // filter for projects whose full paths match the full path of the given string\n        const filteredProjects = evaluatedProjects.filter(p =>\n          p.Properties.MSBuildProjectFullPath === MSBPP.GetFullPath(proj),\n        );\n\n        // if no pre-existing MSBuildProject found,\n        // evaluate a new one and push it\n        if (filteredProjects.length === 0) {\n          const _proj = await MSBuildProject.Evaluate({\n            FullName: proj,\n            GetProperty: MSBuildProject.MatrixProperties,\n            GetItem: [],\n            GetTargetResult: [],\n            Property: {},\n            Targets: ['Restore'],\n          });\n          evaluatedProjects.push(_proj);\n          return _proj;\n        }\n\n        /**\n         * Finds and returns the subjectively \"best\" project in {@link filteredProjects}\n         * @returns the subjective \"best\" project in {@link filteredProjects}\n         */\n        function getBest() {\n          let best: MSBuildProject | undefined;\n          if (filteredProjects.length > 0 && (best = filteredProjects[0]) instanceof MSBuildProject)\n            return best;\n          throw new Error('No MSBuildProjects could be found!');\n        }\n\n        /*\n        todo: improve filtering to select \"optimal\" instance.\n          Which properties are most-needed?\n          For now, we just pray the project has a well-defined publish flow e.g.\n          @halospv3/hce.shared-config/dotnet/PublishAll.targets\n         */\n        return getBest();\n      }),\n    );\n\n    /**\n     * Returns an array of one or more `dotnet` arguments.\n     * @param proj An {@link MSBuildProject} to be published for one or more\n     * runtime-framework combinations.\n     * @returns If {@link proj} imports {@link ../../dotnet/PublishAll.targets}...\n     * ```\n     * [`${proj.Properties.MSBuildProjectFullPath} -t:PublishAll -p:Configuration=Release`]\n     * ```\n     * Else, an array of `dotnet publish` arguments permutations e.g.\n     * ```\n     * [\n     *   'myProj.csproj --runtime win7-x86 --framework net6.0',\n     *   'myProj.csproj --runtime win7-x64 --framework net6.0'\n     * ]\n     * ```\n     * @example\n     * const publishCmdArray = [];\n     * const permutations = getPublishArgsPermutations(msbuildProject);\n     * for (const permutation of permutations) {\n     *   if (permutation[0] === 'PublishAll') {\n     *     // 'dotnet msbuild full/path/to/myProj.csproj t:PublishAll'\n     *     publishCmdArray.push(`dotnet msbuild ${permutation[1]}`)\n     *   }\n     *   else {\n     *     publishCmdArray.push(`dotnet publish ${permutation}`)\n     *   }\n     * }\n     * // return array as success-chained CLI commands.\n     * return publishCmdArray.join(' && ');\n     */\n    function getPublishArgsPermutations(proj: MSBuildProject):\n      ([`\"${typeof proj.Properties.MSBuildProjectFullPath}\" -t:PublishAll -p:Configuration=Release`])\n      | ([`\"${typeof proj.Properties.MSBuildProjectFullPath}\"`])\n      | (`\"${typeof proj.Properties.MSBuildProjectFullPath}\" --runtime ${string} --framework ${string}`)[]\n      | (`\"${typeof proj.Properties.MSBuildProjectFullPath}\" --runtime ${string}`)[]\n      | (`\"${typeof proj.Properties.MSBuildProjectFullPath}\" --framework ${string}`)[] {\n      /**\n       * If the project imports PublishAll to publish for each TFM-RID\n       * permutation, return the appropriate command line.\n       */\n      if (proj.Targets.includes('PublishAll'))\n        return [`\"${proj.Properties.MSBuildProjectFullPath}\" -t:PublishAll -p:Configuration=Release`];\n\n      // #region formatFrameworksAndRuntimes\n      const tfmRidPermutations: `--runtime ${string} --framework ${string}`[]\n        | `--runtime ${string}`[]\n        | `--framework ${string}`[]\n          = []; // forEach, run dotnet [proj.Properties.MSBuildProjectFullPath,...v]\n      const RIDs: string[] = proj.Properties.RuntimeIdentifiers.split(';').filter(v => v !== '');\n      const TFMs: string[] = proj.Properties.TargetFrameworks.split(';').filter(v => v !== '');\n\n      if (TFMs.length === 0 && RIDs.length === 0)\n        return [`\"${proj.Properties.MSBuildProjectFullPath}\"`] as [`\"${string}\"`];\n\n      if (RIDs.length > 0) {\n        if (TFMs.length > 0) {\n          for (const RID of RIDs) {\n            for (const TFM of TFMs) {\n              (tfmRidPermutations as `--runtime ${string} --framework ${string}`[]).push(\n                `--runtime ${RID} --framework ${TFM}`,\n              );\n            }\n          }\n        }\n        else {\n          // assume singular TFM. No need to specify it.\n          for (const RID of RIDs) {\n            (tfmRidPermutations as `--runtime ${string}`[]).push(\n              `--runtime ${RID}`,\n            );\n          }\n        }\n      }\n      else if (TFMs.length > 0) {\n        for (const TFM of TFMs) {\n          (tfmRidPermutations as `--framework ${string}`[]).push(`--framework ${TFM}`);\n        }\n      }\n\n      /** prepend each set of args with the project's path */\n      return tfmRidPermutations.map(permArgs =>\n        `\"${proj.Properties.MSBuildProjectFullPath}\" ${permArgs}`,\n      ) as `\"${typeof proj.Properties.MSBuildProjectFullPath}\" --runtime ${string} --framework ${string}`[]\n      | `\"${typeof proj.Properties.MSBuildProjectFullPath}\" --runtime ${string}`[]\n      | `\"${typeof proj.Properties.MSBuildProjectFullPath}\" --framework ${string}`[];\n      // #endregion formatFrameworksAndRuntimes\n    }\n\n    const publishCmds: (`dotnet publish \"${string}\"` | `dotnet publish \"${string}\" ${string}` | `dotnet msbuild \"${string}\" -t:PublishAll -p:Configuration=Release`)[] = [];\n    /** convert {@link evaluatedPublishProjects} to sets of space-separated CLI args. */\n    const argsSets = evaluatedPublishProjects.map(\n      proj => getPublishArgsPermutations(proj),\n    );\n    for (const args of argsSets) {\n      if (typeof args === 'string')\n        throw new Error(`\\`args\\` should not be a string!`);\n      for (const permutation of args) {\n        if (typeof permutation === 'string' && permutation.length === 1)\n          throw new Error('Something has gone terribly wrong. A `dotnet publish` argument set was split to single characters!');\n        if (/\".+\" -t:PublishAll -p:Configuration=Release/.test(permutation))\n          publishCmds.push(`dotnet msbuild ${permutation as `\"${string}\" -t:PublishAll -p:Configuration=Release`}`);\n        else\n          publishCmds.push(`dotnet publish ${permutation}`);\n      }\n    }\n\n    // For each argSet, create a new exec command. Then, join all commands with ' && ' so they are executed serially, synchronously.\n    // e.g. `dotnet publish project.csproj --runtime win7-x86 --framework net6.0 && dotnet publish project.csproj --runtime win-x64 --framework net8.0\n    return publishCmds.join(' && ');\n  }\n\n  /**\n   * @param projectsToPackAndPush a string[] or {@link NugetRegistryInfo}[].\n   * If a string[], the string must be the platform-dependent (not file://),\n   * full path(s) to one or more projects with the .NET \"Pack\" MSBuild target.\n   * See {@link https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-pack}\n   * for command line usage.\n   * @returns one or more command line strings joined with ' && '.\n   * Each command line comprises the `dotnet pack` command, a project file path,\n   * and a hardcoded output path (`--output ${cwd()}/publish`)\n   */\n  async function formatDotnetPack(\n    projectsToPackAndPush: string[] | NugetRegistryInfo[],\n  ): Promise<string | undefined> {\n    if (projectsToPackAndPush.length === 0)\n      return undefined;\n    return await Promise.all(\n      projectsToPackAndPush.map(async (proj) => {\n        if (proj instanceof NugetRegistryInfo)\n          return proj;\n\n        const msbpArr: MSBuildProject[] = await Promise.all(await MSBuildProject.PackableProjectsToMSBuildProjects([proj]));\n        if (msbpArr.length === 0 || msbpArr[0] === undefined) {\n          throw new Error('This should be impossible!');\n        }\n        const msbp: MSBuildProject = msbpArr[0];\n\n        evaluatedProjects.push(msbp);\n\n        return new NugetRegistryInfo({ project: msbp });\n      }),\n    ).then((nriArray: NugetRegistryInfo[]): string => {\n      return nriArray\n        .map((nri: NugetRegistryInfo): string =>\n          nri.GetPackCommand(NugetRegistryInfo.PackPackagesOptionsType.from({})),\n        ).join(' && ');\n    });\n  }\n}\n\n/**\n * Prepare the CLI command to push NuGet packages. This should added to the `publishCmd` option of `@semantic-release/exec`\n *\n * Ensure your verifyConditionsCmd is set to prevent releases failing due to bad tokens or packages!\n * See {@link NugetRegistryInfo#PackDummyPackage}, {@link NugetRegistryInfo#GetPushDummyCommand}\n * @param registryInfos an array of {@link NugetRegistryInfo} (or derived classes) instances.\n * @param packageOutputPath Default: `${cwd()}/publish`.\\\n * The directory at which dotnet outputs the given projects' packages. Passed to\n * `dotnet pack` via the `--output` argument.\n * @returns a string of `dotnet pack` and `dotnet push` commands, joined by ' && '.\n */\nexport function configureDotnetNugetPush(\n  registryInfos: NugetRegistryInfo[],\n  // Explicit type required by JSR\n  // eslint-disable-next-line @typescript-eslint/no-inferrable-types\n  packageOutputPath: string = `${cwd()}/publish`,\n): string {\n  if (registryInfos.some(registry => registry.source.trim() === ''))\n    throw new Error('The URL for one of the provided NuGet registries was empty or whitespace.');\n\n  const packCmds = registryInfos.map(\n    (nri): string =>\n      nri.GetPackCommand(\n        { output: packageOutputPath },\n        true,\n        true,\n      ),\n  );\n\n  const pushCmds = registryInfos.map(nri => nri.GetPushCommand({ root: packageOutputPath }, true, true));\n\n  return [...packCmds, ...pushCmds].join(' && ');\n}\n\n/**\n * You should try {@link ../../dotnet/SignAfterPack.targets}!.\n * @param opts A {@link DotnetNugetSignOptions} object to be deconstructed and\n * passed to `dotnet nuget sign` as args.\n * @returns `dotnet nuget sign {...}`\n */\nfunction formatDotnetNugetSign(\n  opts: typeof DotnetNugetSignOptions.inferIn | undefined,\n): string | undefined {\n  if (opts === undefined)\n    return undefined;\n\n  const validOpts = DotnetNugetSignOptions.from(opts);\n  const args: ['--timestamper', typeof validOpts.timestamper, '-o', string, ...string[]] = [\n    '--timestamper', validOpts.timestamper,\n    '-o', validOpts.output ?? ourDefaultPubDir,\n  ];\n  if (validOpts.certificatePassword)\n    args.push('---certificate-password', validOpts.certificatePassword);\n  if (validOpts.hashAlgorithm)\n    args.push('--hash-algorithm', validOpts.hashAlgorithm);\n  if (validOpts.overwrite)\n    args.push('--overwrite');\n  if (validOpts.timestampHashAlgorithm)\n    args.push('--timestamp-hash-algorithm', validOpts.timestampHashAlgorithm);\n  if (validOpts.verbosity)\n    args.push('-v', validOpts.verbosity);\n\n  if ('certificatePath' in validOpts)\n    args.push('--certificate-path', validOpts.certificatePath);\n  else if ('certificateStoreName' in validOpts) {\n    SetSubjectNameOrFingerprint();\n    args.push('--certificate-store-name', validOpts.certificateStoreName);\n  }\n  else if ('certificateStoreLocation' in validOpts) {\n    SetSubjectNameOrFingerprint();\n    args.push('--certificate-store-location', validOpts.certificateStoreLocation);\n  }\n  else throw new Error('No code signing certificate was specified!');\n\n  return `dotnet nuget sign ${args.join(' ')} `;\n\n  // eslint-disable-next-line jsdoc/require-jsdoc\n  function SetSubjectNameOrFingerprint() {\n    if ('certificateSubjectName' in validOpts)\n      args.push('--certificate-subject-name', validOpts.certificateSubjectName);\n\n    else if ('certificateFingerprint' in validOpts)\n      args.push('--certificate-fingerprint', validOpts.certificateFingerprint);\n    else throw new Error('If certificateStoreName or certificateStoreLocation is set, either certificateSubjectName or certificateFingerprint must also be set!');\n  }\n}\n\nconst DotnetNugetSignOptions: Type<\n  {\n    timestamper: Default<string, 'https://rfc3161.ai.moda/'>;\n    certificatePassword?: string | undefined;\n    hashAlgorithm?: string | undefined;\n    output?: string | undefined;\n    overwrite?: true | undefined;\n    timestampHashAlgorithm?: string | undefined;\n    verbosity?: 'q' | 'quiet' | 'm' | 'minimal' | 'n' | 'normal' | 'd' | 'detailed' | 'diag' | 'diagnostic';\n  } & ({\n    certificatePath: string;\n    certificateSubjectName: string;\n  } | {\n    certificatePath: string;\n    certificateFingerprint: string;\n  } | {\n    certificateStoreName: string;\n    certificateSubjectName: string;\n  } | {\n    certificateStoreName: string;\n    certificateFingerprint: string;\n  } | {\n    certificateStoreLocation: string;\n    certificateSubjectName: string;\n  } | {\n    certificateStoreLocation: string;\n    certificateFingerprint: string;\n  })> = type({\n  /**\n   * Password for the certificate, if needed. This option can be used to specify\n   * the password for the certificate. The command will throw an error message\n   * if certificate is password protected but password is not provided as input.\n   */\n  'certificatePassword?': 'string',\n  /**\n   * Hash algorithm to be used to sign the package. Defaults to SHA256.\n   */\n  'hashAlgorithm?': 'string | \"SHA256\"',\n  /**\n   * Directory where the signed package(s) should be saved. By default the\n   * original package is overwritten by the signed package.\n   */\n  'output?': 'string',\n  /**\n   * Switch to indicate if the current signature should be overwritten. By\n   * default the command will fail if the package already has a signature.\n   */\n  'overwrite?': 'true',\n  /**\n   * URL to an RFC 3161 timestamping server.\n   */\n  timestamper: 'string = \"https://rfc3161.ai.moda/\"',\n  /**\n   * Hash algorithm to be used to sign the package. Defaults to SHA256.\n   */\n  'timestampHashAlgorithm?': 'string | \"SHA256\"',\n  /**\n   * Set the verbosity level of the command. Allowed values are q[uiet],\n   * m[inimal], n[ormal], d[etailed], and diag[nostic].\n   */\n  'verbosity?': '\"q\"|\"quiet\"|\"m\"|\"minimal\"|\"n\"|\"normal\"|\"d\"|\"detailed\"|\"diag\"|\"diagnostic\"',\n}).and(\n  type({\n    /**\n     * File path to the certificate to be used while signing the package.\n     */\n    certificatePath: 'string',\n  }).or(\n    type({\n      /**\n       * Name of the X.509 certificate store to use to search for the\n       * certificate. Defaults to \"My\", the X.509 certificate store for personal\n       * certificates.\n       *\n       * This option should be used when specifying the certificate via\n       * --certificate-subject-name or --certificate-fingerprint options.\n       */\n      certificateStoreName: 'string',\n    }).or({\n      /**\n       * Name of the X.509 certificate store use to search for the\n       * certificate. Defaults to \"CurrentUser\", the X.509 certificate store\n       * used by the current user.\n       *\n       * This option should be used when specifying the certificate via\n       * --certificate-subject-name or --certificate-fingerprint options.\n       */\n      certificateStoreLocation: 'string',\n    }),\n  ).and(\n    type({\n      /**\n       * Subject name of the certificate used to search a local certificate\n       * store for the certificate. The search is a case-insensitive string\n       * comparison using the supplied value, which will find all certificates\n       * with the subject name containing that string, regardless of other\n       * subject values. The certificate store can be specified by\n       * --certificate-store-name and --certificate-store-location options.\n       */\n      certificateSubjectName: 'string',\n    }).or({\n      /**\n       * SHA-256, SHA-384 or SHA-512 fingerprint of the certificate used to\n       * search a local certificate store for the certificate. The certificate\n       * store can be specified by --certificate-store-name and\n       * --certificate-store-location options.\n       */\n      certificateFingerprint: 'string',\n    }),\n  ),\n);\n"],"mappings":"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"}

package/mjs/dotnet/index.mjs

@@ -1 +1,9 @@
-import{MSBuildProjectProperties as e}from"./MSBuildProjectProperties.mjs";import{NPPGetterNames as t,NugetProjectProperties as n}from"./NugetProjectProperties.mjs";import{EvaluationOptions as r,MSBuildEvaluationOutput as i,MSBuildProject as a,_InternalMSBuildEvaluationTypes as o,catchCsc2012 as s,catchEBUSY as c}from"./MSBuildProject.mjs";import{NRIOpts as l,NRIOptsBase as u,NugetRegistryInfo as d,getGithubOutput as f,getGithubOutputSync as p}from"./NugetRegistryInfo.mjs";import{configureDotnetNugetPush as m,configurePrepareCmd as h}from"./helpers.mjs";import{DefaultGithubTokenEnvVars as g,GHNRIOpts as _,GithubNugetRegistryInfo as v}from"./GithubNugetRegistryInfo.mjs";import{GLNRIOpts as y,GitlabNugetRegistryInfo as b}from"./GitlabNugetRegistryInfo.mjs";import"./IsNextVersionAlreadyPublished.cli.mjs";export{g as DefaultGithubTokenEnvVars,r as EvaluationOptions,_ as GHNRIOpts,y as GLNRIOpts,v as GithubNugetRegistryInfo,b as GitlabNugetRegistryInfo,i as MSBuildEvaluationOutput,a as MSBuildProject,e as MSBuildProjectProperties,t as NPPGetterNames,l as NRIOpts,u as NRIOptsBase,n as NugetProjectProperties,d as NugetRegistryInfo,o as _InternalMSBuildEvaluationTypes,s as catchCsc2012,c as catchEBUSY,m as configureDotnetNugetPush,h as configurePrepareCmd,f as getGithubOutput,p as getGithubOutputSync};
+import { MSBuildProjectProperties } from "./MSBuildProjectProperties.mjs";
+import { NPPGetterNames, NugetProjectProperties } from "./NugetProjectProperties.mjs";
+import { EvaluationOptions, MSBuildEvaluationOutput, MSBuildProject, _InternalMSBuildEvaluationTypes, catchCsc2012, catchEBUSY } from "./MSBuildProject.mjs";
+import { NRIOpts, NRIOptsBase, NugetRegistryInfo, getGithubOutput, getGithubOutputSync } from "./NugetRegistryInfo.mjs";
+import { configureDotnetNugetPush, configurePrepareCmd } from "./helpers.mjs";
+import { DefaultGithubTokenEnvVars, GHNRIOpts, GithubNugetRegistryInfo } from "./GithubNugetRegistryInfo.mjs";
+import { GLNRIOpts, GitlabNugetRegistryInfo } from "./GitlabNugetRegistryInfo.mjs";
+import "./IsNextVersionAlreadyPublished.cli.mjs";
+export { DefaultGithubTokenEnvVars, EvaluationOptions, GHNRIOpts, GLNRIOpts, GithubNugetRegistryInfo, GitlabNugetRegistryInfo, MSBuildEvaluationOutput, MSBuildProject, MSBuildProjectProperties, NPPGetterNames, NRIOpts, NRIOptsBase, NugetProjectProperties, NugetRegistryInfo, _InternalMSBuildEvaluationTypes, catchCsc2012, catchEBUSY, configureDotnetNugetPush, configurePrepareCmd, getGithubOutput, getGithubOutputSync };

package/mjs/dotnet.mjs

@@ -1 +1,9 @@
-import{MSBuildProjectProperties as e}from"./dotnet/MSBuildProjectProperties.mjs";import{NPPGetterNames as t,NugetProjectProperties as n}from"./dotnet/NugetProjectProperties.mjs";import{EvaluationOptions as r,MSBuildEvaluationOutput as i,MSBuildProject as a,_InternalMSBuildEvaluationTypes as o,catchCsc2012 as s,catchEBUSY as c}from"./dotnet/MSBuildProject.mjs";import{NRIOpts as l,NRIOptsBase as u,NugetRegistryInfo as d,getGithubOutput as f,getGithubOutputSync as p}from"./dotnet/NugetRegistryInfo.mjs";import{configureDotnetNugetPush as m,configurePrepareCmd as h}from"./dotnet/helpers.mjs";import{DefaultGithubTokenEnvVars as g,GHNRIOpts as _,GithubNugetRegistryInfo as v}from"./dotnet/GithubNugetRegistryInfo.mjs";import{GLNRIOpts as y,GitlabNugetRegistryInfo as b}from"./dotnet/GitlabNugetRegistryInfo.mjs";import"./dotnet/index.mjs";export{g as DefaultGithubTokenEnvVars,r as EvaluationOptions,_ as GHNRIOpts,y as GLNRIOpts,v as GithubNugetRegistryInfo,b as GitlabNugetRegistryInfo,i as MSBuildEvaluationOutput,a as MSBuildProject,e as MSBuildProjectProperties,t as NPPGetterNames,l as NRIOpts,u as NRIOptsBase,n as NugetProjectProperties,d as NugetRegistryInfo,o as _InternalMSBuildEvaluationTypes,s as catchCsc2012,c as catchEBUSY,m as configureDotnetNugetPush,h as configurePrepareCmd,f as getGithubOutput,p as getGithubOutputSync};
+import { MSBuildProjectProperties } from "./dotnet/MSBuildProjectProperties.mjs";
+import { NPPGetterNames, NugetProjectProperties } from "./dotnet/NugetProjectProperties.mjs";
+import { EvaluationOptions, MSBuildEvaluationOutput, MSBuildProject, _InternalMSBuildEvaluationTypes, catchCsc2012, catchEBUSY } from "./dotnet/MSBuildProject.mjs";
+import { NRIOpts, NRIOptsBase, NugetRegistryInfo, getGithubOutput, getGithubOutputSync } from "./dotnet/NugetRegistryInfo.mjs";
+import { configureDotnetNugetPush, configurePrepareCmd } from "./dotnet/helpers.mjs";
+import { DefaultGithubTokenEnvVars, GHNRIOpts, GithubNugetRegistryInfo } from "./dotnet/GithubNugetRegistryInfo.mjs";
+import { GLNRIOpts, GitlabNugetRegistryInfo } from "./dotnet/GitlabNugetRegistryInfo.mjs";
+import "./dotnet/index.mjs";
+export { DefaultGithubTokenEnvVars, EvaluationOptions, GHNRIOpts, GLNRIOpts, GithubNugetRegistryInfo, GitlabNugetRegistryInfo, MSBuildEvaluationOutput, MSBuildProject, MSBuildProjectProperties, NPPGetterNames, NRIOpts, NRIOptsBase, NugetProjectProperties, NugetRegistryInfo, _InternalMSBuildEvaluationTypes, catchCsc2012, catchEBUSY, configureDotnetNugetPush, configurePrepareCmd, getGithubOutput, getGithubOutputSync };

package/mjs/eslintConfig.mjs

@@ -1,2 +1,98 @@
-import e from"@eslint/js";import{defineConfig as t,globalIgnores as n}from"eslint/config";import"eslint";import r from"@stylistic/eslint-plugin";import i from"@eslint/json";import a from"globals/globals.json"with{type:"json"};import o from"typescript-eslint";const s=n([`_tsout/**/*`,`_tsout/*`,`_tsout/`,`cjs/**/*`,`cjs/*/*`,`cjs/*`,`mjs/**/*`,`mjs/*`,`mjs/`,`node_modules/**/*`,`**/node_modules/**/*`,`**/*.tsbuildinfo`,`**/bin/**/*`,`**/obj/**/*`,`.pnp.cjs`,`.pnp.loader.mjs`,`.yarn/sdks/**`]),c=r.configs.customize({quoteProps:`as-needed`,semi:!0,indent:2,severity:`warn`});c.rules??={},c.rules[`@stylistic/no-extra-parens`]=[`warn`,`all`,{allowParensAfterCommentPattern:`@type|@satisfies`,nestedBinaryExpressions:!1}],c.rules[`@stylistic/semi`]=[`warn`,`always`,{omitLastInOneLineBlock:!1,omitLastInOneLineClassBody:!1}];const l=t({...i.configs.recommended,name:`JSON Recommended`,files:[`**/*.json`],ignores:[`**/.vscode/*.json`],language:`json/json`},{name:`JSON - Allow empty keys in package-lock.json`,files:[`**/package-lock.json`],rules:{"json/no-empty-keys":`off`}},{...i.configs.recommended,name:`JSONC Recommended`,files:[`**/*.jsonc`,`**/.vscode/*.json`],language:`json/jsonc`},{...i.configs.recommended,name:`JSON5 Recommended`,files:[`**/*.json5`],language:`json/json5`},{name:`TSJS`,extends:[e.configs.recommended,...o.configs.strictTypeChecked,...o.configs.stylisticTypeChecked,c],files:[`**/*.ts`,`**/*.cts`,`**/*.mts`,`**/*.js`,`**/*.cjs`,`**/*.mjs`,`**/*.jsx`,`**/*.tsx`],ignores:s.ignores,languageOptions:{parserOptions:{projectService:!0},globals:a.node}},s);export{l as default};
+import eslint from "@eslint/js";
+import { defineConfig, globalIgnores } from "eslint/config";
+import "eslint";
+import stylistic from "@stylistic/eslint-plugin";
+import json from "@eslint/json";
+import globals from "globals/globals.json" with { type: "json" };
+import tseslint from "typescript-eslint";
+//#region src/eslintConfig.ts
+const globalIgnores$1 = globalIgnores([
+	"_tsout/**/*",
+	"_tsout/*",
+	"_tsout/",
+	"cjs/**/*",
+	"cjs/*/*",
+	"cjs/*",
+	"mjs/**/*",
+	"mjs/*",
+	"mjs/",
+	"node_modules/**/*",
+	"**/node_modules/**/*",
+	"**/*.tsbuildinfo",
+	"**/bin/**/*",
+	"**/obj/**/*",
+	".pnp.cjs",
+	".pnp.loader.mjs",
+	".yarn/sdks/**"
+]);
+const stylisticWarn = stylistic.configs.customize({
+	quoteProps: "as-needed",
+	semi: true,
+	indent: 2,
+	severity: "warn"
+});
+stylisticWarn.rules ??= {};
+stylisticWarn.rules["@stylistic/no-extra-parens"] = [
+	"warn",
+	"all",
+	{
+		allowParensAfterCommentPattern: "@type|@satisfies",
+		nestedBinaryExpressions: false
+	}
+];
+stylisticWarn.rules["@stylistic/semi"] = [
+	"warn",
+	"always",
+	{
+		omitLastInOneLineBlock: false,
+		omitLastInOneLineClassBody: false
+	}
+];
+const config = defineConfig({
+	...json.configs.recommended,
+	name: "JSON Recommended",
+	files: ["**/*.json"],
+	ignores: ["**/.vscode/*.json"],
+	language: "json/json"
+}, {
+	name: "JSON - Allow empty keys in package-lock.json",
+	files: ["**/package-lock.json"],
+	rules: { "json/no-empty-keys": "off" }
+}, {
+	...json.configs.recommended,
+	name: "JSONC Recommended",
+	files: ["**/*.jsonc", "**/.vscode/*.json"],
+	language: "json/jsonc"
+}, {
+	...json.configs.recommended,
+	name: "JSON5 Recommended",
+	files: ["**/*.json5"],
+	language: "json/json5"
+}, {
+	name: "TSJS",
+	extends: [
+		eslint.configs.recommended,
+		...tseslint.configs.strictTypeChecked,
+		...tseslint.configs.stylisticTypeChecked,
+		stylisticWarn
+	],
+	files: [
+		"**/*.ts",
+		"**/*.cts",
+		"**/*.mts",
+		"**/*.js",
+		"**/*.cjs",
+		"**/*.mjs",
+		"**/*.jsx",
+		"**/*.tsx"
+	],
+	ignores: globalIgnores$1.ignores,
+	languageOptions: {
+		parserOptions: { projectService: true },
+		globals: globals.node
+	}
+}, globalIgnores$1);
+//#endregion
+export { config as default };
+
 //# sourceMappingURL=eslintConfig.mjs.map

package/mjs/eslintConfig.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"eslintConfig.mjs","names":["globalIgnores","setGlobalIgnores"],"sources":["../src/eslintConfig.ts"],"sourcesContent":["import eslint from '@eslint/js';\nimport { defineConfig, globalIgnores as setGlobalIgnores } from 'eslint/config';\nimport { type Linter } from 'eslint';\nimport stylistic, { type RuleOptions } from '@stylistic/eslint-plugin';\nimport json from '@eslint/json';\nimport globals from 'globals/globals.json' with { type: 'json' };\nimport tseslint from 'typescript-eslint';\n\n// https://eslint.org/docs/latest/use/configure/migration-guide#using-eslintrc-configs-in-flat-config\n// https://www.google.com/search?q=javascript+recurse+through+object+and+remove+undefined+properties\n\nconst globalIgnores: ReturnType<typeof setGlobalIgnores> = setGlobalIgnores([\n  '_tsout/**/*',\n  '_tsout/*',\n  '_tsout/',\n  'cjs/**/*',\n  'cjs/*/*',\n  'cjs/*',\n  'mjs/**/*',\n  'mjs/*',\n  'mjs/',\n  'node_modules/**/*',\n  '**/node_modules/**/*',\n  '**/*.tsbuildinfo',\n  '**/bin/**/*',\n  '**/obj/**/*',\n  '.pnp.cjs',\n  '.pnp.loader.mjs',\n  '.yarn/sdks/**',\n]);\n\nconst stylisticWarn: Linter.Config = stylistic.configs.customize({\n  quoteProps: 'as-needed',\n  semi: true,\n  indent: 2,\n  severity: 'warn',\n});\nstylisticWarn.rules ??= {};\n\nstylisticWarn.rules['@stylistic/no-extra-parens'] = [\n  'warn',\n  'all',\n  {\n    allowParensAfterCommentPattern: '@type|@satisfies',\n    nestedBinaryExpressions: false,\n  },\n] satisfies Linter.RuleEntry<RuleOptions['@stylistic/no-extra-parens']>;\n\nstylisticWarn.rules['@stylistic/semi'] = [\n  'warn',\n  'always',\n  {\n    omitLastInOneLineBlock: false,\n    omitLastInOneLineClassBody: false,\n  },\n] satisfies Linter.RuleEntry<RuleOptions['@stylistic/semi']>;\n\nconst config: ReturnType<typeof defineConfig> = defineConfig(\n  { ...json.configs.recommended, name: 'JSON Recommended', files: ['**/*.json'], ignores: ['**/.vscode/*.json'], language: 'json/json' },\n  { name: 'JSON - Allow empty keys in package-lock.json', files: ['**/package-lock.json'], rules: { 'json/no-empty-keys': 'off' } },\n  { ...json.configs.recommended, name: 'JSONC Recommended', files: ['**/*.jsonc', '**/.vscode/*.json'], language: 'json/jsonc' },\n  { ...json.configs.recommended, name: 'JSON5 Recommended', files: ['**/*.json5'], language: 'json/json5' },\n  {\n    name: 'TSJS',\n    extends: [\n      eslint.configs.recommended,\n      ...tseslint.configs.strictTypeChecked,\n      ...tseslint.configs.stylisticTypeChecked,\n      stylisticWarn,\n    ],\n    files: [\n      '**/*.ts',\n      '**/*.cts',\n      '**/*.mts',\n      '**/*.js',\n      '**/*.cjs',\n      '**/*.mjs',\n      '**/*.jsx',\n      '**/*.tsx',\n    ],\n    ignores: globalIgnores.ignores,\n    languageOptions: {\n      parserOptions: {\n        projectService: true,\n      },\n      globals: globals.node,\n    },\n  },\n  globalIgnores,\n);\nexport default config;\n"],"mappings":"mQAWA,MAAMA,EAAqDC,EAAiB,CAC1E,cACA,WACA,UACA,WACA,UACA,QACA,WACA,QACA,OACA,oBACA,uBACA,mBACA,cACA,cACA,WACA,kBACA,gBACD,CAAC,CAEI,EAA+B,EAAU,QAAQ,UAAU,CAC/D,WAAY,YACZ,KAAM,GACN,OAAQ,EACR,SAAU,OACX,CAAC,CACF,EAAc,QAAU,EAAE,CAE1B,EAAc,MAAM,8BAAgC,CAClD,OACA,MACA,CACE,+BAAgC,mBAChC,wBAAyB,GAC1B,CACF,CAED,EAAc,MAAM,mBAAqB,CACvC,OACA,SACA,CACE,uBAAwB,GACxB,2BAA4B,GAC7B,CACF,CAED,MAAM,EAA0C,EAC9C,CAAE,GAAG,EAAK,QAAQ,YAAa,KAAM,mBAAoB,MAAO,CAAC,YAAY,CAAE,QAAS,CAAC,oBAAoB,CAAE,SAAU,YAAa,CACtI,CAAE,KAAM,+CAAgD,MAAO,CAAC,uBAAuB,CAAE,MAAO,CAAE,qBAAsB,MAAO,CAAE,CACjI,CAAE,GAAG,EAAK,QAAQ,YAAa,KAAM,oBAAqB,MAAO,CAAC,aAAc,oBAAoB,CAAE,SAAU,aAAc,CAC9H,CAAE,GAAG,EAAK,QAAQ,YAAa,KAAM,oBAAqB,MAAO,CAAC,aAAa,CAAE,SAAU,aAAc,CACzG,CACE,KAAM,OACN,QAAS,CACP,EAAO,QAAQ,YACf,GAAG,EAAS,QAAQ,kBACpB,GAAG,EAAS,QAAQ,qBACpB,EACD,CACD,MAAO,CACL,UACA,WACA,WACA,UACA,WACA,WACA,WACA,WACD,CACD,QAASD,EAAc,QACvB,gBAAiB,CACf,cAAe,CACb,eAAgB,GACjB,CACD,QAAS,EAAQ,KAClB,CACF,CACDA,EACD"}
+{"version":3,"file":"eslintConfig.mjs","names":["globalIgnores","setGlobalIgnores"],"sources":["../src/eslintConfig.ts"],"sourcesContent":["import eslint from '@eslint/js';\nimport { defineConfig, globalIgnores as setGlobalIgnores } from 'eslint/config';\nimport { type Linter } from 'eslint';\nimport stylistic, { type RuleOptions } from '@stylistic/eslint-plugin';\nimport json from '@eslint/json';\nimport globals from 'globals/globals.json' with { type: 'json' };\nimport tseslint from 'typescript-eslint';\n\n// https://eslint.org/docs/latest/use/configure/migration-guide#using-eslintrc-configs-in-flat-config\n// https://www.google.com/search?q=javascript+recurse+through+object+and+remove+undefined+properties\n\nconst globalIgnores: ReturnType<typeof setGlobalIgnores> = setGlobalIgnores([\n  '_tsout/**/*',\n  '_tsout/*',\n  '_tsout/',\n  'cjs/**/*',\n  'cjs/*/*',\n  'cjs/*',\n  'mjs/**/*',\n  'mjs/*',\n  'mjs/',\n  'node_modules/**/*',\n  '**/node_modules/**/*',\n  '**/*.tsbuildinfo',\n  '**/bin/**/*',\n  '**/obj/**/*',\n  '.pnp.cjs',\n  '.pnp.loader.mjs',\n  '.yarn/sdks/**',\n]);\n\nconst stylisticWarn: Linter.Config = stylistic.configs.customize({\n  quoteProps: 'as-needed',\n  semi: true,\n  indent: 2,\n  severity: 'warn',\n});\nstylisticWarn.rules ??= {};\n\nstylisticWarn.rules['@stylistic/no-extra-parens'] = [\n  'warn',\n  'all',\n  {\n    allowParensAfterCommentPattern: '@type|@satisfies',\n    nestedBinaryExpressions: false,\n  },\n] satisfies Linter.RuleEntry<RuleOptions['@stylistic/no-extra-parens']>;\n\nstylisticWarn.rules['@stylistic/semi'] = [\n  'warn',\n  'always',\n  {\n    omitLastInOneLineBlock: false,\n    omitLastInOneLineClassBody: false,\n  },\n] satisfies Linter.RuleEntry<RuleOptions['@stylistic/semi']>;\n\nconst config: ReturnType<typeof defineConfig> = defineConfig(\n  { ...json.configs.recommended, name: 'JSON Recommended', files: ['**/*.json'], ignores: ['**/.vscode/*.json'], language: 'json/json' },\n  { name: 'JSON - Allow empty keys in package-lock.json', files: ['**/package-lock.json'], rules: { 'json/no-empty-keys': 'off' } },\n  { ...json.configs.recommended, name: 'JSONC Recommended', files: ['**/*.jsonc', '**/.vscode/*.json'], language: 'json/jsonc' },\n  { ...json.configs.recommended, name: 'JSON5 Recommended', files: ['**/*.json5'], language: 'json/json5' },\n  {\n    name: 'TSJS',\n    extends: [\n      eslint.configs.recommended,\n      ...tseslint.configs.strictTypeChecked,\n      ...tseslint.configs.stylisticTypeChecked,\n      stylisticWarn,\n    ],\n    files: [\n      '**/*.ts',\n      '**/*.cts',\n      '**/*.mts',\n      '**/*.js',\n      '**/*.cjs',\n      '**/*.mjs',\n      '**/*.jsx',\n      '**/*.tsx',\n    ],\n    ignores: globalIgnores.ignores,\n    languageOptions: {\n      parserOptions: {\n        projectService: true,\n      },\n      globals: globals.node,\n    },\n  },\n  globalIgnores,\n);\nexport default config;\n"],"mappings":";;;;;;;;AAWA,MAAMA,kBAAqDC,cAAiB;CAC1E;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAM,gBAA+B,UAAU,QAAQ,UAAU;CAC/D,YAAY;CACZ,MAAM;CACN,QAAQ;CACR,UAAU;CACX,CAAC;AACF,cAAc,UAAU,EAAE;AAE1B,cAAc,MAAM,gCAAgC;CAClD;CACA;CACA;EACE,gCAAgC;EAChC,yBAAyB;EAC1B;CACF;AAED,cAAc,MAAM,qBAAqB;CACvC;CACA;CACA;EACE,wBAAwB;EACxB,4BAA4B;EAC7B;CACF;AAED,MAAM,SAA0C,aAC9C;CAAE,GAAG,KAAK,QAAQ;CAAa,MAAM;CAAoB,OAAO,CAAC,YAAY;CAAE,SAAS,CAAC,oBAAoB;CAAE,UAAU;CAAa,EACtI;CAAE,MAAM;CAAgD,OAAO,CAAC,uBAAuB;CAAE,OAAO,EAAE,sBAAsB,OAAO;CAAE,EACjI;CAAE,GAAG,KAAK,QAAQ;CAAa,MAAM;CAAqB,OAAO,CAAC,cAAc,oBAAoB;CAAE,UAAU;CAAc,EAC9H;CAAE,GAAG,KAAK,QAAQ;CAAa,MAAM;CAAqB,OAAO,CAAC,aAAa;CAAE,UAAU;CAAc,EACzG;CACE,MAAM;CACN,SAAS;EACP,OAAO,QAAQ;EACf,GAAG,SAAS,QAAQ;EACpB,GAAG,SAAS,QAAQ;EACpB;EACD;CACD,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD;CACD,SAASD,gBAAc;CACvB,iBAAiB;EACf,eAAe,EACb,gBAAgB,MACjB;EACD,SAAS,QAAQ;EAClB;CACF,EACDA,gBACD"}

package/mjs/index.mjs

@@ -1 +1,2 @@
-import{baseConfig as e}from"./semanticReleaseConfig.mjs";export{e as default};
+import { baseConfig } from "./semanticReleaseConfig.mjs";
+export { baseConfig as default };

package/mjs/insertPlugins.mjs

@@ -1,2 +1,36 @@
-function e(e,t,n,r){let i=e.map(e=>typeof e==`string`?e:e[0]),a=t.filter(e=>i.includes(e)).map(e=>i.indexOf(e)).sort().find((e,t,n)=>t===n.length-1);if(a===void 0)throw ReferenceError(`An attempt to get the last element of an array returned undefined.`);let o=r.filter(e=>i.includes(e)).map(e=>i.indexOf(e)).sort(),s=[];for(let e of o)e<=a&&s.push(Error(`insertPlugin was instructed to insert one or more plugins after [${t.map(e=>`"`+e+`"`).join(`, `)}] and before [${r.map(e=>`"${e}"`).join(`, `)}], but ${JSON.stringify(i[a])} comes after ${JSON.stringify(i[e])}!`));if(s.length>0)throw AggregateError(s,`One or more errors occurred while inserting plugin configs into the Semantic Release config!`);let c=e.slice(0,a+1),l=e.slice(a+1,e.length+1);return[...c,...n.map(e=>[e,{}]),...l]}export{e as insertPlugin};
+//#region src/insertPlugins.ts
+/**
+* @param plugins {@link SemanticReleaseOptions.plugins}
+* @param afterPluginsIDs The `string` IDs of plugins that the {@link insertPluginIDs} must follow.
+* @param insertPluginIDs The `string` IDs of plugins to insert into a copy of the {@link plugins} array.
+* @param beforePluginsIDs The `string` IDs of plugins that the {@link insertPluginIDs} must precede.
+* @returns
+* A modified copy of {@link plugins} with the given plugins inserted
+* before {@link beforePluginsIDs} and after {@link afterPluginsIDs}.
+*
+* Inserted plugins will be a `[string, {}]` tuple.
+* @throws {ReferenceError} This should never occur. One or more of the
+* {@link afterPluginsIDs} had been found in {@link plugins}, but a `.find` call
+* to get the highest index of the found plugins had returned `undefined`
+* @throws {AggregateError} One or more error occurred when inserting plugins: `insertPlugin was instructed to insert one or more plugins after [${afterPluginsIDs.map(v => '"' + v + '"').join(', ')}] and before [${beforePluginsIDs.map(v => `"${v}"`).join(', ')}], but ${JSON.stringify(pluginIDs[indexOfLastAfter])} comes after ${JSON.stringify(pluginIDs[index])}!`
+*/
+function insertPlugin(plugins, afterPluginsIDs, insertPluginIDs, beforePluginsIDs) {
+	const pluginIDs = plugins.map((v) => typeof v === "string" ? v : v[0]);
+	const indexOfLastAfter = afterPluginsIDs.filter((v) => pluginIDs.includes(v)).map((v) => pluginIDs.indexOf(v)).sort().find((_v, i, obj) => i === obj.length - 1);
+	if (void 0 === indexOfLastAfter) throw new ReferenceError("An attempt to get the last element of an array returned undefined.");
+	const indicesOfBefore = beforePluginsIDs.filter((v) => pluginIDs.includes(v)).map((v) => pluginIDs.indexOf(v)).sort();
+	const errors = [];
+	for (const index of indicesOfBefore) if (index <= indexOfLastAfter) errors.push(/* @__PURE__ */ new Error(`insertPlugin was instructed to insert one or more plugins after [${afterPluginsIDs.map((v) => "\"" + v + "\"").join(", ")}] and before [${beforePluginsIDs.map((v) => `"${v}"`).join(", ")}], but ${JSON.stringify(pluginIDs[indexOfLastAfter])} comes after ${JSON.stringify(pluginIDs[index])}!`));
+	if (errors.length > 0) throw new AggregateError(errors, "One or more errors occurred while inserting plugin configs into the Semantic Release config!");
+	const beforeInsert = plugins.slice(0, indexOfLastAfter + 1);
+	const afterInsert = plugins.slice(indexOfLastAfter + 1, plugins.length + 1);
+	return [
+		...beforeInsert,
+		...insertPluginIDs.map((id) => [id, {}]),
+		...afterInsert
+	];
+}
+//#endregion
+export { insertPlugin };
+
 //# sourceMappingURL=insertPlugins.mjs.map

package/mjs/insertPlugins.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"insertPlugins.mjs","names":[],"sources":["../src/insertPlugins.ts"],"sourcesContent":["import type {\n  PluginSpec,\n  Options as SemanticReleaseOptions,\n} from 'semantic-release';\n\n/**\n * @since 3.0.0\n * @deprecated EXPERIMENTAL\n */\ninterface PluginInsertRuleSet {\n  Id: string;\n  BeforeIds: string[];\n  AfterIds: string[];\n}\n\n/**\n * [W.I.P. STUB]\n *\n * Given an array of {@link PluginInsertRuleSet}s, insert plugins into a\n * {@link https://developer.mozilla.org/en-US/docs/Web/API/Window/structuredClone structured clone}\n * (i.e. deep-copy) of the {@link plugins} array, sort the plugin entries, and\n * return the modified array copy.\n * @todo implement\n * @param plugins Your {@link SemanticReleaseOptions.plugins} array.\n * @param inserts An array of {@link PluginInsertRuleSet}s.\n *\n * If a plugin is already in the plugins array, inserting is skipped. The\n * existing entry is sorted according to its ruleset.\n *\n * If any rulesets conflict, an error will be thrown.\n * - error: A must precede B; B must precede A.\n * - pass: C must precede D and E; D must precede E and follow B. Add ruleset\n *   interface: {Id:string, BeforeIds:string[], AfterIds:string[] }\n * @returns A deep-cloned, modified copy of {@link plugins} with plugins\n * inserted and sorted where needed.\n * @since 3.0.0\n * @deprecated EXPERIMENTAL\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\ndeclare function insertAndSortPlugins(\n  plugins: Exclude<SemanticReleaseOptions['plugins'], undefined>,\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  inserts: PluginInsertRuleSet[],\n): PluginSpec[];\n\n/**\n * @param plugins {@link SemanticReleaseOptions.plugins}\n * @param afterPluginsIDs The `string` IDs of plugins that the {@link insertPluginIDs} must follow.\n * @param insertPluginIDs The `string` IDs of plugins to insert into a copy of the {@link plugins} array.\n * @param beforePluginsIDs The `string` IDs of plugins that the {@link insertPluginIDs} must precede.\n * @returns\n * A modified copy of {@link plugins} with the given plugins inserted\n * before {@link beforePluginsIDs} and after {@link afterPluginsIDs}.\n *\n * Inserted plugins will be a `[string, {}]` tuple.\n * @throws {ReferenceError} This should never occur. One or more of the\n * {@link afterPluginsIDs} had been found in {@link plugins}, but a `.find` call\n * to get the highest index of the found plugins had returned `undefined`\n * @throws {AggregateError} One or more error occurred when inserting plugins: `insertPlugin was instructed to insert one or more plugins after [${afterPluginsIDs.map(v => '\"' + v + '\"').join(', ')}] and before [${beforePluginsIDs.map(v => `\"${v}\"`).join(', ')}], but ${JSON.stringify(pluginIDs[indexOfLastAfter])} comes after ${JSON.stringify(pluginIDs[index])}!`\n */\nexport function insertPlugin(\n  plugins: Exclude<PluginSpec, string>[],\n  afterPluginsIDs: string[],\n  insertPluginIDs: string[],\n  beforePluginsIDs: string[],\n): Exclude<PluginSpec, string>[] {\n  const pluginIDs = plugins.map(v =>\n    typeof v === 'string' ? v : v[0],\n  );\n\n  // if any beforePluginIDs are ordered before the last afterPlugin, throw. Impossible to sort.\n\n  const indexOfLastAfter = afterPluginsIDs\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 (undefined === indexOfLastAfter)\n    throw new ReferenceError(\n      'An attempt to get the last element of an array returned undefined.',\n    );\n\n  const indicesOfBefore = beforePluginsIDs\n    .filter(v => pluginIDs.includes(v))\n    .map(v => pluginIDs.indexOf(v))\n    .sort();\n\n  // This for-of collects *all* sorting errors. The resulting AggregateError\n  // notifies the API user of *all* errors in the order rather than just the\n  // first error encountered.\n  const errors: Error[] = [];\n  for (const index of indicesOfBefore) {\n    if (index <= indexOfLastAfter) {\n      errors.push(\n        new Error(\n          `insertPlugin was instructed to insert one or more plugins after [${afterPluginsIDs.map(v => '\"' + v + '\"').join(', ')}] and before [${beforePluginsIDs.map(v => `\"${v}\"`).join(', ')}], but ${JSON.stringify(pluginIDs[indexOfLastAfter])} comes after ${JSON.stringify(pluginIDs[index])}!`,\n        ),\n      );\n    }\n  }\n  if (errors.length > 0)\n    throw new AggregateError(errors, 'One or more errors occurred while inserting plugin configs into the Semantic Release config!');\n\n  // insert plugin(s)\n\n  const beforeInsert = plugins.slice(0, indexOfLastAfter + 1);\n  const afterInsert = plugins.slice(indexOfLastAfter + 1, plugins.length + 1);\n\n  return [\n    ...beforeInsert,\n    ...insertPluginIDs.map(id =>\n      [id, {}] as [string, unknown],\n    ),\n    ...afterInsert,\n  ];\n}\n"],"mappings":"AA4DA,SAAgB,EACd,EACA,EACA,EACA,EAC+B,CAC/B,IAAM,EAAY,EAAQ,IAAI,GAC5B,OAAO,GAAM,SAAW,EAAI,EAAE,GAC/B,CAIK,EAAmB,EACtB,OAAO,GAAK,EAAU,SAAS,EAAE,CAAC,CAClC,IAAI,GAAK,EAAU,QAAQ,EAAE,CAAC,CAC9B,MAAM,CACN,MAAM,EAAI,EAAG,IAAQ,IAAM,EAAI,OAAS,EAAE,CAC7C,GAAkB,IAAd,IAAA,GACF,MAAU,eACR,qEACD,CAEH,IAAM,EAAkB,EACrB,OAAO,GAAK,EAAU,SAAS,EAAE,CAAC,CAClC,IAAI,GAAK,EAAU,QAAQ,EAAE,CAAC,CAC9B,MAAM,CAKH,EAAkB,EAAE,CAC1B,IAAK,IAAM,KAAS,EACd,GAAS,GACX,EAAO,KACD,MACF,oEAAoE,EAAgB,IAAI,GAAK,IAAM,EAAI,IAAI,CAAC,KAAK,KAAK,CAAC,gBAAgB,EAAiB,IAAI,GAAK,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC,SAAS,KAAK,UAAU,EAAU,GAAkB,CAAC,eAAe,KAAK,UAAU,EAAU,GAAO,CAAC,GAC5R,CACF,CAGL,GAAI,EAAO,OAAS,EAClB,MAAU,eAAe,EAAQ,+FAA+F,CAIlI,IAAM,EAAe,EAAQ,MAAM,EAAG,EAAmB,EAAE,CACrD,EAAc,EAAQ,MAAM,EAAmB,EAAG,EAAQ,OAAS,EAAE,CAE3E,MAAO,CACL,GAAG,EACH,GAAG,EAAgB,IAAI,GACrB,CAAC,EAAI,EAAE,CAAC,CACT,CACD,GAAG,EACJ"}
+{"version":3,"file":"insertPlugins.mjs","names":[],"sources":["../src/insertPlugins.ts"],"sourcesContent":["import type {\n  PluginSpec,\n  Options as SemanticReleaseOptions,\n} from 'semantic-release';\n\n/**\n * @since 3.0.0\n * @deprecated EXPERIMENTAL\n */\ninterface PluginInsertRuleSet {\n  Id: string;\n  BeforeIds: string[];\n  AfterIds: string[];\n}\n\n/**\n * [W.I.P. STUB]\n *\n * Given an array of {@link PluginInsertRuleSet}s, insert plugins into a\n * {@link https://developer.mozilla.org/en-US/docs/Web/API/Window/structuredClone structured clone}\n * (i.e. deep-copy) of the {@link plugins} array, sort the plugin entries, and\n * return the modified array copy.\n * @todo implement\n * @param plugins Your {@link SemanticReleaseOptions.plugins} array.\n * @param inserts An array of {@link PluginInsertRuleSet}s.\n *\n * If a plugin is already in the plugins array, inserting is skipped. The\n * existing entry is sorted according to its ruleset.\n *\n * If any rulesets conflict, an error will be thrown.\n * - error: A must precede B; B must precede A.\n * - pass: C must precede D and E; D must precede E and follow B. Add ruleset\n *   interface: {Id:string, BeforeIds:string[], AfterIds:string[] }\n * @returns A deep-cloned, modified copy of {@link plugins} with plugins\n * inserted and sorted where needed.\n * @since 3.0.0\n * @deprecated EXPERIMENTAL\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\ndeclare function insertAndSortPlugins(\n  plugins: Exclude<SemanticReleaseOptions['plugins'], undefined>,\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  inserts: PluginInsertRuleSet[],\n): PluginSpec[];\n\n/**\n * @param plugins {@link SemanticReleaseOptions.plugins}\n * @param afterPluginsIDs The `string` IDs of plugins that the {@link insertPluginIDs} must follow.\n * @param insertPluginIDs The `string` IDs of plugins to insert into a copy of the {@link plugins} array.\n * @param beforePluginsIDs The `string` IDs of plugins that the {@link insertPluginIDs} must precede.\n * @returns\n * A modified copy of {@link plugins} with the given plugins inserted\n * before {@link beforePluginsIDs} and after {@link afterPluginsIDs}.\n *\n * Inserted plugins will be a `[string, {}]` tuple.\n * @throws {ReferenceError} This should never occur. One or more of the\n * {@link afterPluginsIDs} had been found in {@link plugins}, but a `.find` call\n * to get the highest index of the found plugins had returned `undefined`\n * @throws {AggregateError} One or more error occurred when inserting plugins: `insertPlugin was instructed to insert one or more plugins after [${afterPluginsIDs.map(v => '\"' + v + '\"').join(', ')}] and before [${beforePluginsIDs.map(v => `\"${v}\"`).join(', ')}], but ${JSON.stringify(pluginIDs[indexOfLastAfter])} comes after ${JSON.stringify(pluginIDs[index])}!`\n */\nexport function insertPlugin(\n  plugins: Exclude<PluginSpec, string>[],\n  afterPluginsIDs: string[],\n  insertPluginIDs: string[],\n  beforePluginsIDs: string[],\n): Exclude<PluginSpec, string>[] {\n  const pluginIDs = plugins.map(v =>\n    typeof v === 'string' ? v : v[0],\n  );\n\n  // if any beforePluginIDs are ordered before the last afterPlugin, throw. Impossible to sort.\n\n  const indexOfLastAfter = afterPluginsIDs\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 (undefined === indexOfLastAfter)\n    throw new ReferenceError(\n      'An attempt to get the last element of an array returned undefined.',\n    );\n\n  const indicesOfBefore = beforePluginsIDs\n    .filter(v => pluginIDs.includes(v))\n    .map(v => pluginIDs.indexOf(v))\n    .sort();\n\n  // This for-of collects *all* sorting errors. The resulting AggregateError\n  // notifies the API user of *all* errors in the order rather than just the\n  // first error encountered.\n  const errors: Error[] = [];\n  for (const index of indicesOfBefore) {\n    if (index <= indexOfLastAfter) {\n      errors.push(\n        new Error(\n          `insertPlugin was instructed to insert one or more plugins after [${afterPluginsIDs.map(v => '\"' + v + '\"').join(', ')}] and before [${beforePluginsIDs.map(v => `\"${v}\"`).join(', ')}], but ${JSON.stringify(pluginIDs[indexOfLastAfter])} comes after ${JSON.stringify(pluginIDs[index])}!`,\n        ),\n      );\n    }\n  }\n  if (errors.length > 0)\n    throw new AggregateError(errors, 'One or more errors occurred while inserting plugin configs into the Semantic Release config!');\n\n  // insert plugin(s)\n\n  const beforeInsert = plugins.slice(0, indexOfLastAfter + 1);\n  const afterInsert = plugins.slice(indexOfLastAfter + 1, plugins.length + 1);\n\n  return [\n    ...beforeInsert,\n    ...insertPluginIDs.map(id =>\n      [id, {}] as [string, unknown],\n    ),\n    ...afterInsert,\n  ];\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA4DA,SAAgB,aACd,SACA,iBACA,iBACA,kBAC+B;CAC/B,MAAM,YAAY,QAAQ,KAAI,MAC5B,OAAO,MAAM,WAAW,IAAI,EAAE,GAC/B;CAID,MAAM,mBAAmB,gBACtB,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,KAAI,KAAA,MAAc,iBAChB,OAAM,IAAI,eACR,qEACD;CAEH,MAAM,kBAAkB,iBACrB,QAAO,MAAK,UAAU,SAAS,EAAE,CAAC,CAClC,KAAI,MAAK,UAAU,QAAQ,EAAE,CAAC,CAC9B,MAAM;CAKT,MAAM,SAAkB,EAAE;AAC1B,MAAK,MAAM,SAAS,gBAClB,KAAI,SAAS,iBACX,QAAO,qBACL,IAAI,MACF,oEAAoE,gBAAgB,KAAI,MAAK,OAAM,IAAI,KAAI,CAAC,KAAK,KAAK,CAAC,gBAAgB,iBAAiB,KAAI,MAAK,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC,SAAS,KAAK,UAAU,UAAU,kBAAkB,CAAC,eAAe,KAAK,UAAU,UAAU,OAAO,CAAC,GAC5R,CACF;AAGL,KAAI,OAAO,SAAS,EAClB,OAAM,IAAI,eAAe,QAAQ,+FAA+F;CAIlI,MAAM,eAAe,QAAQ,MAAM,GAAG,mBAAmB,EAAE;CAC3D,MAAM,cAAc,QAAQ,MAAM,mBAAmB,GAAG,QAAQ,SAAS,EAAE;AAE3E,QAAO;EACL,GAAG;EACH,GAAG,gBAAgB,KAAI,OACrB,CAAC,IAAI,EAAE,CAAC,CACT;EACD,GAAG;EACJ"}

package/mjs/semanticReleaseConfig.mjs

@@ -1,2 +1,64 @@
-import{DefaultOptions as e}from"./setupGitPluginSpec.default.mjs";const t=Object.freeze([`@semantic-release/commit-analyzer`,`@semantic-release/release-notes-generator`,`@semantic-release/npm`,`@semantic-release/github`]),n={preset:`conventionalcommits`,branches:[`main`,{name:`develop`,channel:`develop`,prerelease:!0}],plugins:[[`@semantic-release/commit-analyzer`,{}],[`semantic-release-export-data`,{}],[`@semantic-release/release-notes-generator`,{}],[`@semantic-release/changelog`,{}],[`@semantic-release/git`,e],[`@semantic-release/exec`,{}],[`@semantic-release/github`,{addReleases:`bottom`,assets:[`./publish/*`,`!./publish/.gitkeep`]}]]};export{n as baseConfig,t as defaultPlugins};
+import { DefaultOptions } from "./setupGitPluginSpec.default.mjs";
+//#region src/semanticReleaseConfig.ts
+/**
+* @satisfies { Readonly<PluginSpec[]> }
+*/
+const defaultPlugins = Object.freeze([
+	"@semantic-release/commit-analyzer",
+	"@semantic-release/release-notes-generator",
+	"@semantic-release/npm",
+	"@semantic-release/github"
+]);
+/**
+* The base configuration for various Semantic Release scenarios.
+* - Prefers preset "conventionalcommits"
+*   (Conventional-Changelog-ConventionalCommits).
+* - Creates tags and release commits on "main" branch, pre-releases on
+*   "develop" branch in "develop" channel.
+* - Creates GitHub Releases.
+* - Exports the following variables as GitHub Actions outputs:
+*   - "new-release-published": "true" | "false"
+*   - "new-release-version" : string
+*   - "new-release-git-tag" : string
+* - includes default plugins (except `@semantic-release/npm`) and more
+*   - `@semantic-release/commit-analyzer`
+*   - semantic-release-export-data
+*   - `@semantic-release/release-notes-generator`
+*   - `@semantic-release/changelog`
+*   - `@semantic-release/git`
+*     - add modified CHANGELOG.md in release commit
+*   - `@semantic-release/exec`
+*     - does nothing by default. Included for convenience.
+*   - `@semantic-release/github`
+*     - uploads all files from `./publish/*`. This is non-recursive.
+*     - adds a list of links to related release pages (e.g. the release's page on npmjs.com)
+*
+* (OPTIONAL) update static Version strings before Git plugin
+* - https://github.com/jpoehnelt/semantic-release-replace-plugin
+* - https://github.com/droidsolutions/semantic-release-update-file
+* @satisfies {Options}
+*/
+const baseConfig = {
+	preset: "conventionalcommits",
+	branches: ["main", {
+		name: "develop",
+		channel: "develop",
+		prerelease: true
+	}],
+	plugins: [
+		["@semantic-release/commit-analyzer", {}],
+		["semantic-release-export-data", {}],
+		["@semantic-release/release-notes-generator", {}],
+		["@semantic-release/changelog", {}],
+		["@semantic-release/git", DefaultOptions],
+		["@semantic-release/exec", {}],
+		["@semantic-release/github", {
+			addReleases: "bottom",
+			assets: ["./publish/*", "!./publish/.gitkeep"]
+		}]
+	]
+};
+//#endregion
+export { baseConfig, defaultPlugins };
+
 //# sourceMappingURL=semanticReleaseConfig.mjs.map

package/mjs/semanticReleaseConfig.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"semanticReleaseConfig.mjs","names":[],"sources":["../src/semanticReleaseConfig.ts"],"sourcesContent":["// @ts-types=\"./semantic-release__commit-analyzer.d.ts\"\nimport type { Options as SRCommitAnalyzerOptions } from '@semantic-release/commit-analyzer';\n// @ts-types=\"./semantic-release__exec.d.ts\"\nimport type { Options as SRExecOptions } from '@semantic-release/exec';\n// @ts-types=\"./semantic-release__git.d.ts\"\nimport type { Options as SRGitOptions } from '@semantic-release/git';\n// @ts-types=\"./semantic-release__github.d.ts\"\nimport type { Options as SRGithubOptions } from '@semantic-release/github';\nimport type { Options, PluginSpec } from 'semantic-release';\nimport { DefaultOptions } from './setupGitPluginSpec.default.ts';\n\nexport interface SRReleaseNotesGeneratorOptions {\n  /**\n   * conventional-changelog preset.\n   * @default 'angular'\n   */\n  preset?: 'angular' | 'atom' | 'codemirror' | 'ember' | 'eslint' | 'express' | 'jquery' | 'jscs' | 'jshint' | 'conventionalcommits' | (string & Record<never, never>) | undefined;\n  /**\n   * Requireable npm package with a custom conventional-changelog preset.\n   */\n  config?: string | undefined;\n  /**\n   * Additional `conventional-changelog-parser` options that will overwrite ones loaded by `preset` or `config`.\n   */\n  parserOpts: object;\n  /**\n   * Additional `conventional-changelog-writer` options that will overwrite ones loaded by `preset` or `config`.\n   */\n  writerOpts: object;\n}\n\n/**\n * A two-type PluginSpec to tie a plugin's name to its Options type. This is\n * intended for use by plugins to associate their Options type with their plugin\n * name.\n */\nexport type PluginSpecTuple<P extends string = string, T = unknown> = [P, T];\nexport type PluginSpecSRCommitAnalyzer<V extends SRCommitAnalyzerOptions = SRCommitAnalyzerOptions> = PluginSpecTuple<'@semantic-release/commit-analyzer', V>;\nexport type PluginSpecSRChangelog<V extends Record<'changelogFile' | 'changelogTitle', string>> = PluginSpecTuple<'@semantic-release/changelog', V>;\nexport type PluginSpecExportData<V extends Record<string, unknown> = Record<string, unknown>> = PluginSpecTuple<'semantic-release-export-data', V>;\nexport type PluginSpecSRReleaseNotesGen<V extends SRReleaseNotesGeneratorOptions = SRReleaseNotesGeneratorOptions> = PluginSpecTuple<'@semantic-release/release-notes-generator', V>;\nexport type PluginSpecSRExec<V extends SRExecOptions = SRExecOptions> = PluginSpecTuple<'@semantic-release/exec', V>;\nexport type PluginSpecSRGit<V extends SRGitOptions = SRGitOptions> = PluginSpecTuple<'@semantic-release/git', V>;\nexport type PluginSpecSRGithub<V extends SRGithubOptions = SRGithubOptions> = PluginSpecTuple<'@semantic-release/github', V>;\n\n/**\n * @satisfies { Readonly<PluginSpec[]> }\n */\nexport const defaultPlugins: readonly [\n  '@semantic-release/commit-analyzer',\n  '@semantic-release/release-notes-generator',\n  '@semantic-release/npm',\n  '@semantic-release/github',\n] = Object.freeze([\n  '@semantic-release/commit-analyzer',\n  '@semantic-release/release-notes-generator',\n  '@semantic-release/npm',\n  '@semantic-release/github',\n] as const) satisfies readonly PluginSpec[];\n\n// define as const for string literals in type, then...\n/**\n *  @see baseConfig\n */\nconst _baseConfig = {\n  /** @see https://semantic-release.gitbook.io/semantic-release/usage/plugins#plugin-options-configuration */\n  preset: 'conventionalcommits' as const,\n  branches: [\n    'main',\n    { name: 'develop', channel: 'develop', prerelease: true },\n  ] as ['main', { name: 'develop'; channel: 'develop'; prerelease: true }],\n  plugins: [\n    ['@semantic-release/commit-analyzer', {}],\n    ['semantic-release-export-data', {}],\n    ['@semantic-release/release-notes-generator', {}],\n    ['@semantic-release/changelog', {}],\n    ['@semantic-release/git', DefaultOptions],\n    ['@semantic-release/exec', {}],\n    ['@semantic-release/github', { addReleases: 'bottom', assets: ['./publish/*', '!./publish/.gitkeep'] }],\n  ] as [\n    PluginSpecSRCommitAnalyzer,\n    PluginSpecExportData,\n    PluginSpecSRReleaseNotesGen,\n    PluginSpecSRChangelog<Record<'changelogFile' | 'changelogTitle', string>>,\n    PluginSpecSRGit<typeof DefaultOptions>,\n    PluginSpecSRExec,\n    PluginSpecSRGithub<{ addReleases: 'bottom'; assets: [{ path: './publish/*' }] }>,\n  ] | Exclude<PluginSpec, string>[],\n};\n\n/**\n * The base configuration for various Semantic Release scenarios.\n * - Prefers preset \"conventionalcommits\"\n *   (Conventional-Changelog-ConventionalCommits).\n * - Creates tags and release commits on \"main\" branch, pre-releases on\n *   \"develop\" branch in \"develop\" channel.\n * - Creates GitHub Releases.\n * - Exports the following variables as GitHub Actions outputs:\n *   - \"new-release-published\": \"true\" | \"false\"\n *   - \"new-release-version\" : string\n *   - \"new-release-git-tag\" : string\n * - includes default plugins (except `@semantic-release/npm`) and more\n *   - `@semantic-release/commit-analyzer`\n *   - semantic-release-export-data\n *   - `@semantic-release/release-notes-generator`\n *   - `@semantic-release/changelog`\n *   - `@semantic-release/git`\n *     - add modified CHANGELOG.md in release commit\n *   - `@semantic-release/exec`\n *     - does nothing by default. Included for convenience.\n *   - `@semantic-release/github`\n *     - uploads all files from `./publish/*`. This is non-recursive.\n *     - adds a list of links to related release pages (e.g. the release's page on npmjs.com)\n *\n * (OPTIONAL) update static Version strings before Git plugin\n * - https://github.com/jpoehnelt/semantic-release-replace-plugin\n * - https://github.com/droidsolutions/semantic-release-update-file\n * @satisfies {Options}\n */\nexport const baseConfig: typeof _baseConfig = _baseConfig satisfies Options;\n"],"mappings":"kEAgDA,MAAa,EAKT,OAAO,OAAO,CAChB,oCACA,4CACA,wBACA,2BACD,CAAU,CA6DE,EAvDO,CAElB,OAAQ,sBACR,SAAU,CACR,OACA,CAAE,KAAM,UAAW,QAAS,UAAW,WAAY,GAAM,CAC1D,CACD,QAAS,CACP,CAAC,oCAAqC,EAAE,CAAC,CACzC,CAAC,+BAAgC,EAAE,CAAC,CACpC,CAAC,4CAA6C,EAAE,CAAC,CACjD,CAAC,8BAA+B,EAAE,CAAC,CACnC,CAAC,wBAAyB,EAAe,CACzC,CAAC,yBAA0B,EAAE,CAAC,CAC9B,CAAC,2BAA4B,CAAE,YAAa,SAAU,OAAQ,CAAC,cAAe,sBAAsB,CAAE,CAAC,CACxG,CASF"}
+{"version":3,"file":"semanticReleaseConfig.mjs","names":[],"sources":["../src/semanticReleaseConfig.ts"],"sourcesContent":["// @ts-types=\"./semantic-release__commit-analyzer.d.ts\"\nimport type { Options as SRCommitAnalyzerOptions } from '@semantic-release/commit-analyzer';\n// @ts-types=\"./semantic-release__exec.d.ts\"\nimport type { Options as SRExecOptions } from '@semantic-release/exec';\n// @ts-types=\"./semantic-release__git.d.ts\"\nimport type { Options as SRGitOptions } from '@semantic-release/git';\n// @ts-types=\"./semantic-release__github.d.ts\"\nimport type { Options as SRGithubOptions } from '@semantic-release/github';\nimport type { Options, PluginSpec } from 'semantic-release';\nimport { DefaultOptions } from './setupGitPluginSpec.default.ts';\n\nexport interface SRReleaseNotesGeneratorOptions {\n  /**\n   * conventional-changelog preset.\n   * @default 'angular'\n   */\n  preset?: 'angular' | 'atom' | 'codemirror' | 'ember' | 'eslint' | 'express' | 'jquery' | 'jscs' | 'jshint' | 'conventionalcommits' | (string & Record<never, never>) | undefined;\n  /**\n   * Requireable npm package with a custom conventional-changelog preset.\n   */\n  config?: string | undefined;\n  /**\n   * Additional `conventional-changelog-parser` options that will overwrite ones loaded by `preset` or `config`.\n   */\n  parserOpts: object;\n  /**\n   * Additional `conventional-changelog-writer` options that will overwrite ones loaded by `preset` or `config`.\n   */\n  writerOpts: object;\n}\n\n/**\n * A two-type PluginSpec to tie a plugin's name to its Options type. This is\n * intended for use by plugins to associate their Options type with their plugin\n * name.\n */\nexport type PluginSpecTuple<P extends string = string, T = unknown> = [P, T];\nexport type PluginSpecSRCommitAnalyzer<V extends SRCommitAnalyzerOptions = SRCommitAnalyzerOptions> = PluginSpecTuple<'@semantic-release/commit-analyzer', V>;\nexport type PluginSpecSRChangelog<V extends Record<'changelogFile' | 'changelogTitle', string>> = PluginSpecTuple<'@semantic-release/changelog', V>;\nexport type PluginSpecExportData<V extends Record<string, unknown> = Record<string, unknown>> = PluginSpecTuple<'semantic-release-export-data', V>;\nexport type PluginSpecSRReleaseNotesGen<V extends SRReleaseNotesGeneratorOptions = SRReleaseNotesGeneratorOptions> = PluginSpecTuple<'@semantic-release/release-notes-generator', V>;\nexport type PluginSpecSRExec<V extends SRExecOptions = SRExecOptions> = PluginSpecTuple<'@semantic-release/exec', V>;\nexport type PluginSpecSRGit<V extends SRGitOptions = SRGitOptions> = PluginSpecTuple<'@semantic-release/git', V>;\nexport type PluginSpecSRGithub<V extends SRGithubOptions = SRGithubOptions> = PluginSpecTuple<'@semantic-release/github', V>;\n\n/**\n * @satisfies { Readonly<PluginSpec[]> }\n */\nexport const defaultPlugins: readonly [\n  '@semantic-release/commit-analyzer',\n  '@semantic-release/release-notes-generator',\n  '@semantic-release/npm',\n  '@semantic-release/github',\n] = Object.freeze([\n  '@semantic-release/commit-analyzer',\n  '@semantic-release/release-notes-generator',\n  '@semantic-release/npm',\n  '@semantic-release/github',\n] as const) satisfies readonly PluginSpec[];\n\n// define as const for string literals in type, then...\n/**\n *  @see baseConfig\n */\nconst _baseConfig = {\n  /** @see https://semantic-release.gitbook.io/semantic-release/usage/plugins#plugin-options-configuration */\n  preset: 'conventionalcommits' as const,\n  branches: [\n    'main',\n    { name: 'develop', channel: 'develop', prerelease: true },\n  ] as ['main', { name: 'develop'; channel: 'develop'; prerelease: true }],\n  plugins: [\n    ['@semantic-release/commit-analyzer', {}],\n    ['semantic-release-export-data', {}],\n    ['@semantic-release/release-notes-generator', {}],\n    ['@semantic-release/changelog', {}],\n    ['@semantic-release/git', DefaultOptions],\n    ['@semantic-release/exec', {}],\n    ['@semantic-release/github', { addReleases: 'bottom', assets: ['./publish/*', '!./publish/.gitkeep'] }],\n  ] as [\n    PluginSpecSRCommitAnalyzer,\n    PluginSpecExportData,\n    PluginSpecSRReleaseNotesGen,\n    PluginSpecSRChangelog<Record<'changelogFile' | 'changelogTitle', string>>,\n    PluginSpecSRGit<typeof DefaultOptions>,\n    PluginSpecSRExec,\n    PluginSpecSRGithub<{ addReleases: 'bottom'; assets: [{ path: './publish/*' }] }>,\n  ] | Exclude<PluginSpec, string>[],\n};\n\n/**\n * The base configuration for various Semantic Release scenarios.\n * - Prefers preset \"conventionalcommits\"\n *   (Conventional-Changelog-ConventionalCommits).\n * - Creates tags and release commits on \"main\" branch, pre-releases on\n *   \"develop\" branch in \"develop\" channel.\n * - Creates GitHub Releases.\n * - Exports the following variables as GitHub Actions outputs:\n *   - \"new-release-published\": \"true\" | \"false\"\n *   - \"new-release-version\" : string\n *   - \"new-release-git-tag\" : string\n * - includes default plugins (except `@semantic-release/npm`) and more\n *   - `@semantic-release/commit-analyzer`\n *   - semantic-release-export-data\n *   - `@semantic-release/release-notes-generator`\n *   - `@semantic-release/changelog`\n *   - `@semantic-release/git`\n *     - add modified CHANGELOG.md in release commit\n *   - `@semantic-release/exec`\n *     - does nothing by default. Included for convenience.\n *   - `@semantic-release/github`\n *     - uploads all files from `./publish/*`. This is non-recursive.\n *     - adds a list of links to related release pages (e.g. the release's page on npmjs.com)\n *\n * (OPTIONAL) update static Version strings before Git plugin\n * - https://github.com/jpoehnelt/semantic-release-replace-plugin\n * - https://github.com/droidsolutions/semantic-release-update-file\n * @satisfies {Options}\n */\nexport const baseConfig: typeof _baseConfig = _baseConfig satisfies Options;\n"],"mappings":";;;;;AAgDA,MAAa,iBAKT,OAAO,OAAO;CAChB;CACA;CACA;CACA;CACD,CAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DX,MAAa,aAvDO;CAElB,QAAQ;CACR,UAAU,CACR,QACA;EAAE,MAAM;EAAW,SAAS;EAAW,YAAY;EAAM,CAC1D;CACD,SAAS;EACP,CAAC,qCAAqC,EAAE,CAAC;EACzC,CAAC,gCAAgC,EAAE,CAAC;EACpC,CAAC,6CAA6C,EAAE,CAAC;EACjD,CAAC,+BAA+B,EAAE,CAAC;EACnC,CAAC,yBAAyB,eAAe;EACzC,CAAC,0BAA0B,EAAE,CAAC;EAC9B,CAAC,4BAA4B;GAAE,aAAa;GAAU,QAAQ,CAAC,eAAe,sBAAsB;GAAE,CAAC;EACxG;CASF"}