@halospv3/hce.shared-config 3.4.8 → 3.5.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [3.5.0](https://github.com/HaloSPV3/HCE.Shared/compare/v3.4.8...v3.5.0) (2026-04-03)
+
+### Features
+
+* add commit-analyzer types ([6728493](https://github.com/HaloSPV3/HCE.Shared/commit/6728493243c490285dfe33f5ae1fca6ae76847f1)), closes [#662](https://github.com/HaloSPV3/HCE.Shared/issues/662)
+
+## [3.5.0-develop.1](https://github.com/HaloSPV3/HCE.Shared/compare/v3.4.8...v3.5.0-develop.1) (2026-04-03)
+
+### Features
+
+* add commit-analyzer types ([6728493](https://github.com/HaloSPV3/HCE.Shared/commit/6728493243c490285dfe33f5ae1fca6ae76847f1)), closes [#662](https://github.com/HaloSPV3/HCE.Shared/issues/662)
+
 ## [3.4.8](https://github.com/HaloSPV3/HCE.Shared/compare/v3.4.7...v3.4.8) (2026-03-27)
 
 ### Bug Fixes

package/mjs/dotnet/MSBuildProject.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"MSBuildProject.d.mts","names":[],"sources":["../../src/dotnet/MSBuildProject.ts"],"mappings":"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"}
+{"version":3,"file":"MSBuildProject.d.mts","names":[],"sources":["../../src/dotnet/MSBuildProject.ts"],"mappings":";;;;cA2EM,uBAAA,EAAyB,IAAA;EAC7B,UAAA,GAAa,MAAA;EACb,KAAA,GAAQ,MAAA;IAAA;IAEN,QAAA;IACA,QAAA;IACA,OAAA;IACA,QAAA;IACA,SAAA;IACA,WAAA;IACA,SAAA;IACA,YAAA;IACA,YAAA;IACA,WAAA;IACA,YAAA;IACA,uBAAA;IACA,wBAAA;IACA,mBAAA;IACA,wBAAA;IACA,OAAA;IACA,yBAAA;IACA,qBAAA;IACA,kBAAA;IACA,wBAAA;IACA,sBAAA;IACA,iBAAA;EAAA;EAEF,aAAA,GAAgB,MAAA;IACd,MAAA;IACA,KAAA;MAAA;MAEE,QAAA;MACA,QAAA;MACA,OAAA;MACA,QAAA;MACA,SAAA;MACA,WAAA;MACA,SAAA;MACA,YAAA;MACA,YAAA;MACA,WAAA;MACA,YAAA;MACA,uBAAA;MACA,wBAAA;MACA,mBAAA;MACA,wBAAA;MACA,OAAA;MACA,yBAAA;MACA,qBAAA;MACA,kBAAA;MACA,wBAAA;MACA,sBAAA;MACA,iBAAA;IAAA;EAAA;IAGF,MAAA;IACA,KAAA;EAAA;AAAA;AAAA,cAQS,uBAAA;;;;;EAKX,WAAA,CAAY,oBAAA,EAAsB,UAAA,QAAkB,IAAA,CAAK,KAAA,OAAY,UAAA,QAAkB,uBAAA,CAAwB,IAAA;;;;;EAa/G,UAAA,UAAoB,uBAAA,CAAwB,KAAA,CAAM,UAAA;EAlBpD;;;;;EAwBE,KAAA,UAAe,uBAAA,CAAwB,KAAA,CAAM,KAAA;;;;;;EAM7C,aAAA,UAAuB,uBAAA,CAAwB,KAAA,CAAM,aAAA;AAAA;AAAA,cAG1C,iBAAA,EAAmB,IAAA;EAC9B,QAAA;EACA,QAAA;IACE,sBAAA;IACA,YAAA;IACA,0BAAA;IACA,cAAA;IACA,WAAA;IACA,kBAAA;IACA,MAAA;IACA,UAAA;IACA,OAAA;IACA,aAAA;IACA,aAAA;IACA,eAAA;IACA,gBAAA;IACA,iBAAA;IACA,kBAAA;EAAA;EAEF,OAAA;EACA,OAAA;EACA,WAAA;EACA,eAAA;AAAA;AAAA,cAiDW,cAAA;;;;;kBAKY,gBAAA;;;;;;;;;;;;EAkBvB,WAAA,CAAmB,IAAA;IACjB,QAAA;IACA,WAAA;IACA,UAAA,EAAY,uBAAA;EAAA;EAAA,SAgBL,KAAA,EAAO,QAAA,CAAS,QAAA,CAAS,uBAAA;EAAA,SACzB,UAAA,EAAY,QAAA,CAAS,sBAAA;EAAA,SACrB,OAAA;EA5CX;;;EAAA,SAgDW,aAAA,EAAe,QAAA,CAAS,uBAAA;;;;;;;;;;;;;;;;;SAkBpB,UAAA,CACX,WAAA,UACA,gBAAA,aACC,OAAA;;;;;;;;;;;;SAyBiB,QAAA,CAClB,OAAA,SAAgB,iBAAA,CAAkB,QAAA,GACjC,OAAA,CAAQ,cAAA;;;;;;;;;;;;SAiHS,iCAAA,CAClB,qBAAA,aACC,OAAA,CAAQ,OAAA,CAAQ,cAAA;EAAA,OAwFL,QAAA,CAAS,IAAA,WAAe,cAAA;AAAA;;;;;cAsD3B,+BAAA,EAAiC,KAAA;EAC5C,uBAAA;IACE,UAAA,GAAa,MAAA;IACb,KAAA,GAAQ,MAAA;MAAA;MAEN,QAAA;MACA,QAAA;MACA,OAAA;MACA,QAAA;MACA,SAAA;MACA,WAAA;MACA,SAAA;MACA,YAAA;MACA,YAAA;MACA,WAAA;MACA,YAAA;MACA,uBAAA;MACA,wBAAA;MACA,mBAAA;MACA,wBAAA;MACA,OAAA;MACA,yBAAA;MACA,qBAAA;MACA,kBAAA;MACA,wBAAA;MACA,sBAAA;MACA,iBAAA;IAAA;IAEF,aAAA,GAAgB,MAAA;MACd,MAAA;MACA,KAAA;QAAA;QAEE,QAAA;QACA,QAAA;QACA,OAAA;QACA,QAAA;QACA,SAAA;QACA,WAAA;QACA,SAAA;QACA,YAAA;QACA,YAAA;QACA,WAAA;QACA,YAAA;QACA,uBAAA;QACA,wBAAA;QACA,mBAAA;QACA,wBAAA;QACA,OAAA;QACA,yBAAA;QACA,qBAAA;QACA,kBAAA;QACA,wBAAA;QACA,sBAAA;QACA,iBAAA;MAAA;IAAA;MAGF,MAAA;MACA,KAAA;IAAA;EAAA;AAAA;;;;;;;iBAsBU,UAAA,CAAW,KAAA;;;;;;;;;iBA8CX,YAAA,CAAa,KAAA"}

package/mjs/dotnet/MSBuildProject.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MSBuildProject.mjs","names":[],"sources":["../../src/dotnet/MSBuildProject.ts"],"sourcesContent":["import { type, type Scope, type Type } from 'arktype';\nimport { warn } from 'node:console';\nimport { type Dirent } from 'node:fs';\nimport { readdir, realpath, stat } from 'node:fs/promises';\n// eslint-disable-next-line unicorn/import-style\nimport * as path from 'node:path';\nimport { setTimeout } from 'node:timers/promises';\nimport { CaseInsensitiveMap } from '../CaseInsensitiveMap.ts';\nimport { execAsync } from '../utils/execAsync.ts';\nimport { isError } from '../utils/isError.ts';\nimport { MSBuildProjectProperties } from './MSBuildProjectProperties.ts';\nimport {\n  NPPGetterNames,\n  NugetProjectProperties,\n} from './NugetProjectProperties.ts';\n\n/**\n * See [MSBuild well-known item metadata](https://learn.microsoft.com/en-us/visualstudio/msbuild/msbuild-well-known-item-metadata).\n * Additional string-type properties may be present (e.g. `{ SubType: \"designer\" }`).\n */\nconst interface_ItemMetadataBuiltIn = type({\n  '[string]': 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\bin\\\\Debug\\\\net6.0\\\\ConsoleApp1.dll\" */\n  Identity: 'string',\n  /** @example \"Designer\" */\n  'SubType?': 'string',\n  /** @example \".NETCoreApp\" */\n  'TargetFrameworkIdentifier?': 'string',\n  'TargetPlatformMoniker?': 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\obj\\\\Debug\\\\net6.0\\\\ConsoleApp1.csproj.CopyComplete\" */\n  'CopyUpToDateMarker?': 'string',\n  'TargetPlatformIdentifier?': 'string',\n  /** @example \"6.0\" */\n  'TargetFrameworkVersion?': 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\obj\\\\Debug\\\\net6.0\\\\ref\\\\ConsoleApp1.dll\" */\n  'ReferenceAssembly?': 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\bin\\\\Debug\\\\net6.0\\\\ConsoleApp1.dll\" */\n  FullPath: 'string',\n  /** @example \"c:\\\\\" */\n  RootDir: 'string',\n  /** @example \"ConsoleApp1\" */\n  Filename: 'string',\n  /** @example \".dll\" */\n  Extension: 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\bin\\\\Debug\\\\net6.0\\\\\" */\n  RelativeDir: 'string',\n  /** @example \"source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\bin\\\\Debug\\\\net6.0\\\\\" */\n  Directory: 'string',\n  RecursiveDir: 'string',\n  /** @example \"2023-11-30 13:38:06.5084339\" */\n  ModifiedTime: 'string',\n  /** @example \"2023-11-30 13:38:06.9308716\" */\n  CreatedTime: 'string',\n  /** @example \"2023-11-30 13:38:06.9318732\" */\n  AccessedTime: 'string',\n  /** @example \"C:\\\\Program Files\\\\Microsoft Visual Studio\\\\2022\\\\Preview\\\\MSBuild\\\\Current\\\\Bin\\\\amd64\\\\Microsoft.Common.CurrentVersion.targets\" */\n  DefiningProjectFullPath: 'string',\n  /** @example \"C:\\\\Program Files\\\\Microsoft Visual Studio\\\\2022\\\\Preview\\\\MSBuild\\\\Current\\\\Bin\\\\amd64\\\\\" */\n  DefiningProjectDirectory: 'string',\n  /** @example \"Microsoft.Common.CurrentVersion\" */\n  DefiningProjectName: 'string',\n  /** @example \".targets\" */\n  DefiningProjectExtension: 'string',\n});\n\nconst targetSuccess = type({\n  Result: '\\'Success\\'',\n  Items: interface_ItemMetadataBuiltIn.array(),\n});\n\nconst targetFailure = type({\n  Result: '\\'Failure\\'',\n  Items: 'never[]',\n});\n\nconst msbuildEvaluationOutput: Type<{\n  Properties?: Record<string, string> | undefined;\n  Items?: Record<string, {\n    [x: string]: string | undefined;\n    Identity: string;\n    FullPath: string;\n    RootDir: string;\n    Filename: string;\n    Extension: string;\n    RelativeDir: string;\n    Directory: string;\n    RecursiveDir: string;\n    ModifiedTime: string;\n    CreatedTime: string;\n    AccessedTime: string;\n    DefiningProjectFullPath: string;\n    DefiningProjectDirectory: string;\n    DefiningProjectName: string;\n    DefiningProjectExtension: string;\n    SubType?: string;\n    TargetFrameworkIdentifier?: string | undefined;\n    TargetPlatformMoniker?: string | undefined;\n    CopyUpToDateMarker?: string | undefined;\n    TargetPlatformIdentifier?: string | undefined;\n    TargetFrameworkVersion?: string | undefined;\n    ReferenceAssembly?: string | undefined;\n  }[]> | undefined;\n  TargetResults?: Record<string, {\n    Result: 'Success';\n    Items: {\n      [x: string]: string | undefined;\n      Identity: string;\n      FullPath: string;\n      RootDir: string;\n      Filename: string;\n      Extension: string;\n      RelativeDir: string;\n      Directory: string;\n      RecursiveDir: string;\n      ModifiedTime: string;\n      CreatedTime: string;\n      AccessedTime: string;\n      DefiningProjectFullPath: string;\n      DefiningProjectDirectory: string;\n      DefiningProjectName: string;\n      DefiningProjectExtension: string;\n      SubType?: string | undefined;\n      TargetFrameworkIdentifier?: string | undefined;\n      TargetPlatformMoniker?: string | undefined;\n      CopyUpToDateMarker?: string | undefined;\n      TargetPlatformIdentifier?: string | undefined;\n      TargetFrameworkVersion?: string | undefined;\n      ReferenceAssembly?: string | undefined;\n    }[];\n  } | {\n    Result: 'Failure';\n    Items: never[];\n  }> | undefined;\n}> = type({\n  'Properties?': type({ '[string]': 'string' }),\n  'Items?': type({ '[string]': interface_ItemMetadataBuiltIn.array() }),\n  'TargetResults?': type({ '[string]': targetSuccess.or(targetFailure) }),\n});\n\nexport class MSBuildEvaluationOutput {\n  /**\n   * @param rawMSBuildEvaluation The output of a CLI MSBuild project evaluation.\n   * May be the UTF-8 string-encoded JSON or the object decoded from that JSON.\n   */\n  constructor(rawMSBuildEvaluation: Parameters<typeof JSON.parse>[0] | Parameters<typeof msbuildEvaluationOutput.from>[0]) {\n    /** `.assert` instead of `.from` to allow `unknown` JSON.parse return type */\n    const knownObject = msbuildEvaluationOutput.assert(typeof rawMSBuildEvaluation === 'string' ? JSON.parse(rawMSBuildEvaluation) : rawMSBuildEvaluation);\n\n    this.Properties = knownObject.Properties;\n    this.Items = knownObject.Items;\n    this.TargetResults = knownObject.TargetResults;\n  }\n\n  /**\n   * The specified properties and their values as evaluated by MSBuild Core.\n   * `-getProperty:{propertyName,...}`\n   */\n  Properties?: typeof msbuildEvaluationOutput.infer.Properties;\n  /**\n   * The specified items and their values and associated metadata as evaluated\n   * by MSBuild Core.\n   * `-getItem:{itemName,...}`\n   */\n  Items?: typeof msbuildEvaluationOutput.infer.Items;\n  /**\n   * The specified Targets and their output values as evaluated by MSBuild\n   * Core.\n   * `-getTargetResult:{targetName,...}`\n   */\n  TargetResults?: typeof msbuildEvaluationOutput.infer.TargetResults;\n}\n\nexport const EvaluationOptions: Type<{\n  FullName: string;\n  Property: {\n    MSBuildProjectFullPath?: string | undefined;\n    AssemblyName?: string | undefined;\n    BaseIntermediateOutputPath?: string | undefined;\n    BaseOutputPath?: string | undefined;\n    Description?: string | undefined;\n    IntermediateOutput?: string | undefined;\n    OutDir?: string | undefined;\n    OutputPath?: string | undefined;\n    Version?: string | undefined;\n    VersionPrefix?: string | undefined;\n    VersionSuffix?: string | undefined;\n    TargetFramework?: string | undefined;\n    TargetFrameworks?: string | undefined;\n    RuntimeIdentifier?: string | undefined;\n    RuntimeIdentifiers?: string | undefined;\n  };\n  Targets: readonly string[] | string[];\n  GetItem: readonly string[] | string[];\n  GetProperty: readonly string[] | string[];\n  GetTargetResult: readonly string[] | string[];\n}> = Object.freeze(\n  type({\n    /**\n     * The project file's full path.\n     */\n    FullName: 'string',\n    /**\n     * User-defined Properties and their values.\n     * { Configuration: \"Release\" } will cause the MSBuild to first set the\n     * Configuration property  to Release before evaluating the project\n     * or the project's Target(s).\n     * ```txt\n     *   -property:<n>=<v>  Set or override these project-level properties. <n> is\n     *                      the property name, and <v> is the property value. Use a\n     *                      semicolon or a comma to separate multiple properties, or\n     *                      specify each property separately. (Short form: -p)\n     *                      Example:\n     *                        -property:WarningLevel=2;OutDir=bin\\Debug\\\n     * ```\n     */\n    Property: type({ '[string]': 'string' })\n      .as<{ -readonly [P in keyof MSBuildProjectProperties]: MSBuildProjectProperties[P] }>()\n      .partial(),\n    /**\n     * The MSBuild Targets to run for evaluation. [\"Pack\"] is recommended.\n     * Property values may be changed by Targets such as those provided by\n     * dependencies.\n     *\n     * ```txt\n     *   -target:<targets>  Build these targets in this project. Use a semicolon or a\n     *                      comma to separate multiple targets, or specify each\n     *                      target separately. (Short form: -t)\n     *                      Example:\n     *                        -target:Resources;Compile\n     * ```\n     * @default []\n     */\n    Targets: type.string.array().readonly().or('string[]'),\n    /**\n     * MSBuild Items to evaluate. `[\"Compile\"]` will result in the MSBuild output\n     * including {@link MSBuild}\n     */\n    GetItem: type.string.array().readonly().or('string[]'),\n    GetProperty: type.string.array().readonly().or('string[]'),\n    GetTargetResult: type.string.array().readonly().or('string[]'),\n  }),\n);\n\nexport class MSBuildProject {\n  /**\n   * Properties for multi-targeting `dotnet publish` outputs.\n   * These are included in {@link NPPGetterNames.InstanceGettersRecursive}.\n   */\n  public static readonly MatrixProperties: readonly string[] = Object.freeze([\n    'TargetFramework',\n    'TargetFrameworks',\n    'RuntimeIdentifier',\n    'RuntimeIdentifiers',\n  ]);\n\n  /**\n   * Creates an instance of MSBuildProject.\n   * @param opts The order-independent arguments for this constructor.\n   * Properties may be added or moved around in this definition without\n   * breaking compatibility.\n   * @param opts.fullPath The full path of the MSBuild project's file. This\n   * should have a '.csproj', '.fsproj', or '.vbproj' file extension.\n   * @param opts.projTargets A list of MSBuild Targets supported by the project.\n   * @param opts.evaluation The output of an MSBuild project evaluation. This\n   * comprises MSBuild Properties, Items, and Target results.\n   */\n  public constructor(opts: {\n    fullPath: string;\n    projTargets: string[];\n    evaluation: MSBuildEvaluationOutput;\n  }) {\n    this.Items = opts.evaluation.Items ?? {};\n    this.Properties = new NugetProjectProperties(\n      opts.fullPath,\n      new CaseInsensitiveMap<string, string>(\n        Object.entries(opts.evaluation.Properties ?? {}),\n      ),\n    );\n    this.Targets = opts.projTargets;\n    this.TargetResults\n      = opts.evaluation.TargetResults === undefined\n        ? []\n        : [opts.evaluation.TargetResults];\n  }\n\n  readonly Items: Readonly<Required<MSBuildEvaluationOutput>['Items']>;\n  readonly Properties: Readonly<NugetProjectProperties>;\n  readonly Targets: readonly string[];\n  /**\n   * Allows appending subsequent target results.\n   */\n  readonly TargetResults: Required<MSBuildEvaluationOutput>['TargetResults'][];\n\n  /**\n   * @param projectPath The full path of the project file or its directory. A\n   * relative path may be passed, but will resolve relative to the current\n   * working directory.\n   * @param includeNonPublic Include conventionally internal/private MSBuild\n   * targets in the result.\n   * @returns A string array of the project's MSBuild targets.\n   * @todo consider 'file' of -targets[:file]\n   *  Prints a list of available targets without executing the\n   *  actual build process. By default the output is written to\n   *  the console window. If the path to an output file\n   *  is provided that will be used instead.\n   *  (Short form: -ts)\n   *  Example:\n   *    -ts:out.txt\n   */\n  static async GetTargets(\n    projectPath: string,\n    includeNonPublic = false,\n  ): Promise<string[]> {\n    return execAsync(`dotnet msbuild ${projectPath} -targets`, true)\n      .then((v) => {\n        const targets = v.stdout\n          .split('\\n')\n          .filter((v, index) => v !== '' && index !== 0)\n          .map(v => v.replaceAll('\\r', ''))\n          .sort((a, b) => a.localeCompare(b));\n        return includeNonPublic\n          ? targets\n          : targets.filter(v => !v.startsWith('_'));\n      });\n  }\n\n  /**\n   * Evaluate {@link Items}, {@link Properties}, and {@link TargetResults},\n   * returning them as an instance of {@link MSBuildProject}.\\\n   * Note: MSBuild will probably fail if Restore is skipped and another\n   * target is specified. If you choose Pack, you must do ['Restore', 'Pack'].\n   * @param options The result of {@link EvaluationOptions.from}.\n   * @returns A promised {@link MSBuildProject} instance.\n   * @throws {Error} if the exec command fails -OR- the JSON parse fails -OR-\n   * MSBuildProject's constructor fails.\n   * @see {@link PackableProjectsToMSBuildProjects} for most use-cases.\n   */\n  public static async Evaluate(\n    options: typeof EvaluationOptions.inferOut,\n  ): Promise<MSBuildProject> {\n    if (\n      options.GetProperty.length === 0\n      && options.GetItem.length === 0\n      && options.GetTargetResult.length === 0\n    ) {\n      throw new Error(\n        'No MSBuild Property, Item, or TargetResult queries were provided.',\n      );\n    }\n    // reminder: args containing spaces and semi-colons MUST be quote-enclosed!\n    options.FullName = MSBuildProjectProperties.GetFullPath(options.FullName);\n    const _pairs = Object.entries(options.Property).filter(p => typeof p[1] === 'string');\n    const property\n      = _pairs.length === 0\n        ? ''\n        : `-p:\"${_pairs.map(pair => pair[0] + '=' + pair[1]).join(';')}\"`;\n    const target\n      = options.Targets.length === 0\n        ? ''\n        : `\"-t:${options.Targets.join(';')}\"`;\n    const getItem\n      = options.GetItem.length === 0\n        ? ''\n        : `-getItem:\"${options.GetItem.join(',')}\"`;\n    const getProperty\n      = options.GetProperty.length === 0\n        ? ''\n        : `-getProperty:\"${options.GetProperty.join(',')}\"`;\n    const getTargetResult\n      = options.GetTargetResult.length === 0\n        ? ''\n        : `-getTargetResult:\"${options.GetTargetResult.join(',')}\"`;\n    const cmdLine = [\n      'dotnet',\n      'msbuild',\n      `\"${options.FullName}\"`,\n      '-restore',\n      property,\n      target,\n      getItem,\n      getProperty,\n      getTargetResult,\n    ]\n      .filter(v => v !== '')\n      .join(' ');\n    let stdio: Awaited<ReturnType<typeof execAsync>> | undefined = undefined;\n    // may throw\n    while (stdio === undefined) {\n      stdio = await setTimeout(\n        1000,\n        execAsync(cmdLine, true),\n      )\n        .then(async p => await p)\n        .catch<undefined>(catchEBUSY);\n    }\n\n    // todo: consider -getResultOutputFile:file\n    //  Redirect output from get* into a file.\n    //\n    //  Example:\n    //  -getProperty:Bar -getResultOutputFile:Biz.txt\n    //  This writes the value of property Bar into Biz.txt.\n\n    /**\n     * The following issues have triggered this code path:\n     * - BaseIntermediateOutputPath must use Unix path separators ('/') on all\n     *   platforms. Even Windows. Otherwise, MSBuild/dotnet will error-exit with\n     *   \"The BaseIntermediateOutputPath must end with a trailing slash\".\n     */\n    if (stdio.stdout.startsWith('MSBuild version')) {\n      warn(stdio.stdout);\n      throw new Error(\n        'dotnet msbuild was expected to output JSON, but output its version header instead.',\n      );\n    }\n\n    let rawOutput: ConstructorParameters<typeof MSBuildEvaluationOutput>[0];\n    if (stdio.stdout.startsWith('{')) {\n      /** stdout is JSON string */\n      rawOutput = stdio.stdout;\n    }\n    else if (options.GetProperty.length > 0 && options.GetProperty[0] !== undefined) {\n      rawOutput = {\n        Properties: {\n          [options.GetProperty[0]]: String(JSON.parse(stdio.stdout)),\n        },\n      };\n    }\n    else {\n      throw new Error('Dotnet/MSBuild evaluation output is not a string nor JSON object or array.');\n    }\n\n    const evaluation = new MSBuildEvaluationOutput(rawOutput);\n\n    return new MSBuildProject({\n      fullPath: options.FullName,\n      projTargets: await MSBuildProject.GetTargets(options.FullName),\n      evaluation,\n    });\n  }\n\n  /**\n   * Evaluate multiple project paths with some default Evaluate options.\n   * @async\n   * @param projectsToPackAndPush An array of MSBuild projects' full file\n   * paths. If a path is a directory, files in that directory are filtered for\n   * `.csproj`, `.fsproj`, and `.vbproj` project files.\n   * See https://github.com/dotnet/sdk/blob/497f334b2862bdf98b30c00ede2fd259ea5f624d/src/Cli/dotnet/Commands/New/MSBuildEvaluation/MSBuildEvaluationResult.cs#L19-L32.\\\n   * @returns A promised array of {@link MSBuildProject} instances.\n   * All known MSBuild and NuGet properties are evaluated.\n   * If applicable, a project's \"Pack\" target is evaluated.\n   */\n  public static async PackableProjectsToMSBuildProjects(\n    projectsToPackAndPush: string[],\n  ): Promise<Promise<MSBuildProject>[]> {\n    const dirEntriesPromise = toDirEntries(typeof projectsToPackAndPush === 'string' ? [projectsToPackAndPush] : projectsToPackAndPush);\n    const projectPromises: Promise<MSBuildProject>[] = await dirEntriesPromise\n      .then(\n        (direntArray: Dirent[]) =>\n          direntArray.map(element => convertDirentToMSBuildProject(element)),\n      );\n    return projectPromises;\n\n    /**\n     * Map an array of filesystem paths to {@link Dirent} instances representing project files.\n     * @param projectsToPackAndPush An array of MSBuild projects' full file\n     * paths. If a path is a directory, files in that directory are filtered for\n     * `.csproj`, `.fsproj`, and `.vbproj` project files. See\n     * https://github.com/dotnet/sdk/blob/497f334b2862bdf98b30c00ede2fd259ea5f624d/src/Cli/dotnet/Commands/New/MSBuildEvaluation/MSBuildEvaluationResult.cs#L19-L32.\\\n     * @returns An promised array of Dirent instances for discovered project files.\n     */\n    async function toDirEntries(\n      projectsToPackAndPush: string[],\n    ): Promise<Dirent[]> {\n      const dirEntries: (Dirent | Dirent[])[] = await Promise.all(\n        projectsToPackAndPush.map(async (proj) => {\n          proj = await realpath(makeAbsolute(proj));\n          const stats = await stat(proj);\n          let entries: Dirent[];\n\n          if (stats.isFile()) {\n            entries = await readdir(path.dirname(proj), { withFileTypes: true });\n            const dirent: Dirent | undefined = entries.find(v =>\n              path.join(\n                // condition required for compatibility. `.path` was deprecated, but `.parentPath` is not available in our node minversion\n                ('path' in v ? v.path as string | undefined : undefined) ?? (v as unknown as Omit<typeof v, 'path'> & { parentPath: string }).parentPath,\n                v.name,\n              ) === proj,\n            );\n            if (dirent)\n              return dirent;\n            else\n              throw new Error(\n                `file \"${proj}\" not found. It may have been moved or deleted.`,\n              );\n          }\n          if (!stats.isDirectory())\n            throw new Error(`\"${proj}\" is not a file or directory`);\n\n          entries = await readdir(proj, { withFileTypes: true });\n          return entries.filter(v =>\n            v.isFile()\n            && (v.name.endsWith('.csproj') || v.name.endsWith('.fsproj') || v.name.endsWith('.vbproj')),\n          );\n        }),\n      );\n\n      return dirEntries.flat();\n    }\n\n    /**\n     * Map a {@link Dirent} instance to an {@link MSBuildProject} instance.\n     * @param dirent A {@link Dirent} instance. This instance should be an MSBuild project file.\n     * @returns An instance of {@link MSBuildProject} evaluated with the `Pack` target result, if applicable. Evaluated properties will be those whose names are returned by {@link NPPGetterNames.InstanceGettersRecursive}.\n     */\n    async function convertDirentToMSBuildProject(dirent: Dirent): Promise<MSBuildProject> {\n      const fullPath = path.join(\n        // condition required for compatibility. `.path` was deprecated, but `.parentPath` is not available in our node minversion\n        ('path' in dirent ? dirent.path as string | undefined : undefined) ?? (dirent as unknown as Omit<typeof dirent, 'path'> & { parentPath: string }).parentPath,\n        dirent.name,\n      );\n      const projTargets: Promise<string[]> = MSBuildProject.GetTargets(fullPath);\n      const evalTargets = await projTargets.then(v =>\n        v.includes('Pack') ? ['Pack'] : [],\n      );\n      // this might be too long for a command line. What was it on Windows?\n      // 2^15 (32,768) character limit for command lines?\n      const getProperties = NPPGetterNames.InstanceGettersRecursive;\n\n      return await MSBuildProject.Evaluate(\n        EvaluationOptions.from({\n          FullName: fullPath,\n          GetItem: [],\n          GetProperty: getProperties,\n          GetTargetResult: [],\n          Property: {},\n          Targets: evalTargets,\n        }),\n      );\n    }\n  }\n\n  public static fromJSON(json: string): MSBuildProject {\n    const parsed = T_PseudoMSBPInstance.assert(JSON.parse(json));\n\n    type.true.assert(\n      Reflect.setPrototypeOf(parsed, MSBuildProject.prototype),\n    );\n    type.true.assert(\n      Reflect.setPrototypeOf(parsed.Properties, NugetProjectProperties.prototype),\n    );\n    parsed.Properties = T_NPP.assert(parsed.Properties);\n    return T_MSBuildProject.assert(parsed);\n  }\n}\n\nconst T_MSBuildProject = type.instanceOf(MSBuildProject);\nconst T_NPP = type.instanceOf(NugetProjectProperties);\nconst T_PseudoMSBPInstance = type({\n  Items: type({\n    '[string]': type({\n      '[string]': 'string',\n      Identity: 'string',\n      FullPath: 'string',\n      RootDir: 'string',\n      Filename: 'string',\n      Extension: 'string',\n      RelativeDir: 'string',\n      Directory: 'string',\n      RecursiveDir: 'string',\n      ModifiedTime: 'string',\n      CreatedTime: 'string',\n      AccessedTime: 'string',\n      DefiningProjectFullPath: 'string',\n      DefiningProjectDirectory: 'string',\n      DefiningProjectName: 'string',\n      DefiningProjectExtension: 'string',\n      'SubType?': ' string | undefined',\n      'TargetFrameworkIdentifier?': 'string | undefined',\n      'TargetPlatformMoniker?': 'string | undefined',\n      'CopyUpToDateMarker?': 'string | undefined',\n      'TargetPlatformIdentifier?': 'string | undefined',\n      'TargetFrameworkVersion?': 'string | undefined',\n      'ReferenceAssembly?': 'string | undefined',\n    }).array(),\n  }),\n  Properties: type.Record('string', 'string').or(T_NPP),\n  Targets: type.string.array(),\n  TargetResults: msbuildEvaluationOutput.get('TargetResults').exclude('undefined').array(),\n\n});\n\n/**\n * ArkType type definitions for internal usage, but may be re-used elsewhere\n * @internal\n */\nexport const _InternalMSBuildEvaluationTypes: Scope<{\n  msbuildEvaluationOutput: {\n    Properties?: Record<string, string> | undefined;\n    Items?: Record<string, {\n      [x: string]: string | undefined;\n      Identity: string;\n      FullPath: string;\n      RootDir: string;\n      Filename: string;\n      Extension: string;\n      RelativeDir: string;\n      Directory: string;\n      RecursiveDir: string;\n      ModifiedTime: string;\n      CreatedTime: string;\n      AccessedTime: string;\n      DefiningProjectFullPath: string;\n      DefiningProjectDirectory: string;\n      DefiningProjectName: string;\n      DefiningProjectExtension: string;\n      SubType?: string | undefined;\n      TargetFrameworkIdentifier?: string | undefined;\n      TargetPlatformMoniker?: string | undefined;\n      CopyUpToDateMarker?: string | undefined;\n      TargetPlatformIdentifier?: string | undefined;\n      TargetFrameworkVersion?: string | undefined;\n      ReferenceAssembly?: string | undefined;\n    }[]> | undefined;\n    TargetResults?: Record<string, {\n      Result: 'Success';\n      Items: {\n        [x: string]: string | undefined;\n        Identity: string;\n        FullPath: string;\n        RootDir: string;\n        Filename: string;\n        Extension: string;\n        RelativeDir: string;\n        Directory: string;\n        RecursiveDir: string;\n        ModifiedTime: string;\n        CreatedTime: string;\n        AccessedTime: string;\n        DefiningProjectFullPath: string;\n        DefiningProjectDirectory: string;\n        DefiningProjectName: string;\n        DefiningProjectExtension: string;\n        SubType?: string | undefined;\n        TargetFrameworkIdentifier?: string | undefined;\n        TargetPlatformMoniker?: string | undefined;\n        CopyUpToDateMarker?: string | undefined;\n        TargetPlatformIdentifier?: string | undefined;\n        TargetFrameworkVersion?: string | undefined;\n        ReferenceAssembly?: string | undefined;\n      }[];\n    } | {\n      Result: 'Failure';\n      Items: never[];\n    }> | undefined;\n  };\n}> = type.scope({\n  msbuildEvaluationOutput,\n});\n\n/**\n * Resolve a path if it is not already absolute.\n * @param _path A filesystem path.\n * @returns A full path to a filesystem entry. The path is unchecked for whether or not the path (or its parts) exist.\n */\nfunction makeAbsolute(_path: string) {\n  return path.isAbsolute(_path) ? _path : path.resolve(_path);\n}\n\n/**\n * Use this in your catch statement or .catch call to return `undefined` when\n * a \"file in use by another process\" (i.e. EBUSY/ERROR_SHARING_VIOLATION) error is reported.\n * @param error Probably an Error object\n * @returns `undefined` if file in use by another process\n */\nexport function catchEBUSY(error: unknown): undefined {\n  if (isError(error)) {\n    if ('stderr' in error && typeof error.stderr === 'string') {\n      // Normalize colon-like chars: '\\uFF1A'.normalize('NFKC') === ':' === true;\n      const normalizedStderr = error.stderr.normalize('NFKC');\n      const patternEN = /The process cannot access the file '[^']+' because it is being used by another process\\./gm;\n      const hasErrMsgPattern = patternEN.test(normalizedStderr);\n      const isCS2012 = /^CSC ?:.+CS2012:/gm.test(normalizedStderr);\n      // generic error code; error message must be checked.\n      const isAVLN9999 = /AVLN9999:/gm.test(normalizedStderr)\n        && hasErrMsgPattern;\n      if (isCS2012 || isAVLN9999 || hasErrMsgPattern)\n        return undefined; /* retry */\n    }\n    /**\n     * some known warnings/errors:\n     * - warning MSB3073:\n     *   The command \"dotnet tool list kuinox.nupkgdeterministicator\"\n     *   exited with code 145.\n     *    > $ dotnet tool list kuinox.nupkgdeterministicator\n     *    > The command could not be loaded, possibly because:\n     *    >   * You intended to execute a .NET application:\n     *    >       The application 'tool' does not exist.\n     *    >   * You intended to execute a .NET SDK command:\n     *    >       No .NET SDKs were found.\n     *    >\n     *    > Download a .NET SDK:\n     *    > https://aka.ms/dotnet/download\n     *    >\n     *    > Learn about SDK resolution:\n     *    > https://aka.ms/dotnet/sdk-not-found\n     */\n    else throw error;\n  }\n  else throw new Error('unknown error', { cause: error });\n}\n\n/**\n *\n * Use this in your catch statement or .catch call to return `undefined` when\n * MSBuild error CSC2012 (e.g. \"file in use by another process\") is reported.\n * @param error Probably an Error object\n * @returns `undefined` if CSC2012 (file in use by another process) occurs\n * @deprecated Use {@link catchEBUSY}.\n */\nexport function catchCsc2012(error: unknown): undefined {\n  if (isError(error)) {\n    // check for error reported when \"file in use by another process\" i.e. EBUSY\n    // (UNIX), NTSTATUS.ERROR_SHARING_VIOLATION == 0x20 == 32 (Windows)\n    if ('stderr' in error && typeof error.stderr === 'string'\n      && /^CSC ?:.+CS2012:/gm.test(\n        // '\\uFF1A'.normalize('NFKC') === ':' === true;\n        error.stderr.normalize('NFKC'),\n      )\n    ) {\n      return undefined; /* retry */\n    }\n    /**\n     * some known warnings/errors:\n     * - warning MSB3073:\n     *   The command \"dotnet tool list kuinox.nupkgdeterministicator\"\n     *   exited with code 145.\n     *    > $ dotnet tool list kuinox.nupkgdeterministicator\n     *    > The command could not be loaded, possibly because:\n     *    >   * You intended to execute a .NET application:\n     *    >       The application 'tool' does not exist.\n     *    >   * You intended to execute a .NET SDK command:\n     *    >       No .NET SDKs were found.\n     *    >\n     *    > Download a .NET SDK:\n     *    > https://aka.ms/dotnet/download\n     *    >\n     *    > Learn about SDK resolution:\n     *    > https://aka.ms/dotnet/sdk-not-found\n     */\n    else throw error;\n  }\n  else throw new Error('unknown error', { cause: error });\n}\n"],"mappings":"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"}
+{"version":3,"file":"MSBuildProject.mjs","names":[],"sources":["../../src/dotnet/MSBuildProject.ts"],"sourcesContent":["import { type, type Scope, type Type } from 'arktype';\nimport { warn } from 'node:console';\nimport { type Dirent } from 'node:fs';\nimport { readdir, realpath, stat } from 'node:fs/promises';\n// eslint-disable-next-line unicorn/import-style\nimport * as path from 'node:path';\nimport { setTimeout } from 'node:timers/promises';\nimport { CaseInsensitiveMap } from '../CaseInsensitiveMap.ts';\nimport { execAsync } from '../utils/execAsync.ts';\nimport { isError } from '../utils/isError.ts';\nimport { MSBuildProjectProperties } from './MSBuildProjectProperties.ts';\nimport {\n  NPPGetterNames,\n  NugetProjectProperties,\n} from './NugetProjectProperties.ts';\n\n/**\n * See [MSBuild well-known item metadata](https://learn.microsoft.com/en-us/visualstudio/msbuild/msbuild-well-known-item-metadata).\n * Additional string-type properties may be present (e.g. `{ SubType: \"designer\" }`).\n */\nconst interface_ItemMetadataBuiltIn = type({\n  '[string]': 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\bin\\\\Debug\\\\net6.0\\\\ConsoleApp1.dll\" */\n  Identity: 'string',\n  /** @example \"Designer\" */\n  'SubType?': 'string',\n  /** @example \".NETCoreApp\" */\n  'TargetFrameworkIdentifier?': 'string',\n  'TargetPlatformMoniker?': 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\obj\\\\Debug\\\\net6.0\\\\ConsoleApp1.csproj.CopyComplete\" */\n  'CopyUpToDateMarker?': 'string',\n  'TargetPlatformIdentifier?': 'string',\n  /** @example \"6.0\" */\n  'TargetFrameworkVersion?': 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\obj\\\\Debug\\\\net6.0\\\\ref\\\\ConsoleApp1.dll\" */\n  'ReferenceAssembly?': 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\bin\\\\Debug\\\\net6.0\\\\ConsoleApp1.dll\" */\n  FullPath: 'string',\n  /** @example \"c:\\\\\" */\n  RootDir: 'string',\n  /** @example \"ConsoleApp1\" */\n  Filename: 'string',\n  /** @example \".dll\" */\n  Extension: 'string',\n  /** @example \"c:\\\\source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\bin\\\\Debug\\\\net6.0\\\\\" */\n  RelativeDir: 'string',\n  /** @example \"source\\\\repos\\\\ConsoleApp1\\\\ConsoleApp1\\\\bin\\\\Debug\\\\net6.0\\\\\" */\n  Directory: 'string',\n  RecursiveDir: 'string',\n  /** @example \"2023-11-30 13:38:06.5084339\" */\n  ModifiedTime: 'string',\n  /** @example \"2023-11-30 13:38:06.9308716\" */\n  CreatedTime: 'string',\n  /** @example \"2023-11-30 13:38:06.9318732\" */\n  AccessedTime: 'string',\n  /** @example \"C:\\\\Program Files\\\\Microsoft Visual Studio\\\\2022\\\\Preview\\\\MSBuild\\\\Current\\\\Bin\\\\amd64\\\\Microsoft.Common.CurrentVersion.targets\" */\n  DefiningProjectFullPath: 'string',\n  /** @example \"C:\\\\Program Files\\\\Microsoft Visual Studio\\\\2022\\\\Preview\\\\MSBuild\\\\Current\\\\Bin\\\\amd64\\\\\" */\n  DefiningProjectDirectory: 'string',\n  /** @example \"Microsoft.Common.CurrentVersion\" */\n  DefiningProjectName: 'string',\n  /** @example \".targets\" */\n  DefiningProjectExtension: 'string',\n});\n\nconst targetSuccess = type({\n  Result: '\\'Success\\'',\n  Items: interface_ItemMetadataBuiltIn.array(),\n});\n\nconst targetFailure = type({\n  Result: '\\'Failure\\'',\n  Items: 'never[]',\n});\n\nconst msbuildEvaluationOutput: Type<{\n  Properties?: Record<string, string> | undefined;\n  Items?: Record<string, {\n    [x: string]: string | undefined;\n    Identity: string;\n    FullPath: string;\n    RootDir: string;\n    Filename: string;\n    Extension: string;\n    RelativeDir: string;\n    Directory: string;\n    RecursiveDir: string;\n    ModifiedTime: string;\n    CreatedTime: string;\n    AccessedTime: string;\n    DefiningProjectFullPath: string;\n    DefiningProjectDirectory: string;\n    DefiningProjectName: string;\n    DefiningProjectExtension: string;\n    SubType?: string;\n    TargetFrameworkIdentifier?: string | undefined;\n    TargetPlatformMoniker?: string | undefined;\n    CopyUpToDateMarker?: string | undefined;\n    TargetPlatformIdentifier?: string | undefined;\n    TargetFrameworkVersion?: string | undefined;\n    ReferenceAssembly?: string | undefined;\n  }[]> | undefined;\n  TargetResults?: Record<string, {\n    Result: 'Success';\n    Items: {\n      [x: string]: string | undefined;\n      Identity: string;\n      FullPath: string;\n      RootDir: string;\n      Filename: string;\n      Extension: string;\n      RelativeDir: string;\n      Directory: string;\n      RecursiveDir: string;\n      ModifiedTime: string;\n      CreatedTime: string;\n      AccessedTime: string;\n      DefiningProjectFullPath: string;\n      DefiningProjectDirectory: string;\n      DefiningProjectName: string;\n      DefiningProjectExtension: string;\n      SubType?: string | undefined;\n      TargetFrameworkIdentifier?: string | undefined;\n      TargetPlatformMoniker?: string | undefined;\n      CopyUpToDateMarker?: string | undefined;\n      TargetPlatformIdentifier?: string | undefined;\n      TargetFrameworkVersion?: string | undefined;\n      ReferenceAssembly?: string | undefined;\n    }[];\n  } | {\n    Result: 'Failure';\n    Items: never[];\n  }> | undefined;\n}> = type({\n  'Properties?': type({ '[string]': 'string' }),\n  'Items?': type({ '[string]': interface_ItemMetadataBuiltIn.array() }),\n  'TargetResults?': type({ '[string]': targetSuccess.or(targetFailure) }),\n});\n\nexport class MSBuildEvaluationOutput {\n  /**\n   * @param rawMSBuildEvaluation The output of a CLI MSBuild project evaluation.\n   * May be the UTF-8 string-encoded JSON or the object decoded from that JSON.\n   */\n  constructor(rawMSBuildEvaluation: Parameters<typeof JSON.parse>[0] | Parameters<typeof msbuildEvaluationOutput.from>[0]) {\n    /** `.assert` instead of `.from` to allow `unknown` JSON.parse return type */\n    const knownObject = msbuildEvaluationOutput.assert(typeof rawMSBuildEvaluation === 'string' ? JSON.parse(rawMSBuildEvaluation) : rawMSBuildEvaluation);\n\n    this.Properties = knownObject.Properties;\n    this.Items = knownObject.Items;\n    this.TargetResults = knownObject.TargetResults;\n  }\n\n  /**\n   * The specified properties and their values as evaluated by MSBuild Core.\n   * `-getProperty:{propertyName,...}`\n   */\n  Properties?: typeof msbuildEvaluationOutput.infer.Properties;\n  /**\n   * The specified items and their values and associated metadata as evaluated\n   * by MSBuild Core.\n   * `-getItem:{itemName,...}`\n   */\n  Items?: typeof msbuildEvaluationOutput.infer.Items;\n  /**\n   * The specified Targets and their output values as evaluated by MSBuild\n   * Core.\n   * `-getTargetResult:{targetName,...}`\n   */\n  TargetResults?: typeof msbuildEvaluationOutput.infer.TargetResults;\n}\n\nexport const EvaluationOptions: Type<{\n  FullName: string;\n  Property: {\n    MSBuildProjectFullPath?: string | undefined;\n    AssemblyName?: string | undefined;\n    BaseIntermediateOutputPath?: string | undefined;\n    BaseOutputPath?: string | undefined;\n    Description?: string | undefined;\n    IntermediateOutput?: string | undefined;\n    OutDir?: string | undefined;\n    OutputPath?: string | undefined;\n    Version?: string | undefined;\n    VersionPrefix?: string | undefined;\n    VersionSuffix?: string | undefined;\n    TargetFramework?: string | undefined;\n    TargetFrameworks?: string | undefined;\n    RuntimeIdentifier?: string | undefined;\n    RuntimeIdentifiers?: string | undefined;\n  };\n  Targets: readonly string[] | string[];\n  GetItem: readonly string[] | string[];\n  GetProperty: readonly string[] | string[];\n  GetTargetResult: readonly string[] | string[];\n}> = Object.freeze(\n  type({\n    /**\n     * The project file's full path.\n     */\n    FullName: 'string',\n    /**\n     * User-defined Properties and their values.\n     * { Configuration: \"Release\" } will cause the MSBuild to first set the\n     * Configuration property  to Release before evaluating the project\n     * or the project's Target(s).\n     * ```txt\n     *   -property:<n>=<v>  Set or override these project-level properties. <n> is\n     *                      the property name, and <v> is the property value. Use a\n     *                      semicolon or a comma to separate multiple properties, or\n     *                      specify each property separately. (Short form: -p)\n     *                      Example:\n     *                        -property:WarningLevel=2;OutDir=bin\\Debug\\\n     * ```\n     */\n    Property: type({ '[string]': 'string' })\n      .as<{ -readonly [P in keyof MSBuildProjectProperties]: MSBuildProjectProperties[P] }>()\n      .partial(),\n    /**\n     * The MSBuild Targets to run for evaluation. [\"Pack\"] is recommended.\n     * Property values may be changed by Targets such as those provided by\n     * dependencies.\n     *\n     * ```txt\n     *   -target:<targets>  Build these targets in this project. Use a semicolon or a\n     *                      comma to separate multiple targets, or specify each\n     *                      target separately. (Short form: -t)\n     *                      Example:\n     *                        -target:Resources;Compile\n     * ```\n     * @default []\n     */\n    Targets: type.string.array().readonly().or('string[]'),\n    /**\n     * MSBuild Items to evaluate. `[\"Compile\"]` will result in the MSBuild output\n     * including {@link MSBuild}\n     */\n    GetItem: type.string.array().readonly().or('string[]'),\n    GetProperty: type.string.array().readonly().or('string[]'),\n    GetTargetResult: type.string.array().readonly().or('string[]'),\n  }),\n);\n\nexport class MSBuildProject {\n  /**\n   * Properties for multi-targeting `dotnet publish` outputs.\n   * These are included in {@link NPPGetterNames.InstanceGettersRecursive}.\n   */\n  public static readonly MatrixProperties: readonly string[] = Object.freeze([\n    'TargetFramework',\n    'TargetFrameworks',\n    'RuntimeIdentifier',\n    'RuntimeIdentifiers',\n  ]);\n\n  /**\n   * Creates an instance of MSBuildProject.\n   * @param opts The order-independent arguments for this constructor.\n   * Properties may be added or moved around in this definition without\n   * breaking compatibility.\n   * @param opts.fullPath The full path of the MSBuild project's file. This\n   * should have a '.csproj', '.fsproj', or '.vbproj' file extension.\n   * @param opts.projTargets A list of MSBuild Targets supported by the project.\n   * @param opts.evaluation The output of an MSBuild project evaluation. This\n   * comprises MSBuild Properties, Items, and Target results.\n   */\n  public constructor(opts: {\n    fullPath: string;\n    projTargets: string[];\n    evaluation: MSBuildEvaluationOutput;\n  }) {\n    this.Items = opts.evaluation.Items ?? {};\n    this.Properties = new NugetProjectProperties(\n      opts.fullPath,\n      new CaseInsensitiveMap<string, string>(\n        Object.entries(opts.evaluation.Properties ?? {}),\n      ),\n    );\n    this.Targets = opts.projTargets;\n    this.TargetResults\n      = opts.evaluation.TargetResults === undefined\n        ? []\n        : [opts.evaluation.TargetResults];\n  }\n\n  readonly Items: Readonly<Required<MSBuildEvaluationOutput>['Items']>;\n  readonly Properties: Readonly<NugetProjectProperties>;\n  readonly Targets: readonly string[];\n  /**\n   * Allows appending subsequent target results.\n   */\n  readonly TargetResults: Required<MSBuildEvaluationOutput>['TargetResults'][];\n\n  /**\n   * @param projectPath The full path of the project file or its directory. A\n   * relative path may be passed, but will resolve relative to the current\n   * working directory.\n   * @param includeNonPublic Include conventionally internal/private MSBuild\n   * targets in the result.\n   * @returns A string array of the project's MSBuild targets.\n   * @todo consider 'file' of -targets[:file]\n   *  Prints a list of available targets without executing the\n   *  actual build process. By default the output is written to\n   *  the console window. If the path to an output file\n   *  is provided that will be used instead.\n   *  (Short form: -ts)\n   *  Example:\n   *    -ts:out.txt\n   */\n  static async GetTargets(\n    projectPath: string,\n    includeNonPublic = false,\n  ): Promise<string[]> {\n    return execAsync(`dotnet msbuild ${projectPath} -targets`, true)\n      .then((v) => {\n        const targets = v.stdout\n          .split('\\n')\n          .filter((v, index) => v !== '' && index !== 0)\n          .map(v => v.replaceAll('\\r', ''))\n          .sort((a, b) => a.localeCompare(b));\n        return includeNonPublic\n          ? targets\n          : targets.filter(v => !v.startsWith('_'));\n      });\n  }\n\n  /**\n   * Evaluate {@link Items}, {@link Properties}, and {@link TargetResults},\n   * returning them as an instance of {@link MSBuildProject}.\\\n   * Note: MSBuild will probably fail if Restore is skipped and another\n   * target is specified. If you choose Pack, you must do ['Restore', 'Pack'].\n   * @param options The result of {@link EvaluationOptions.from}.\n   * @returns A promised {@link MSBuildProject} instance.\n   * @throws {Error} if the exec command fails -OR- the JSON parse fails -OR-\n   * MSBuildProject's constructor fails.\n   * @see {@link PackableProjectsToMSBuildProjects} for most use-cases.\n   */\n  public static async Evaluate(\n    options: typeof EvaluationOptions.inferOut,\n  ): Promise<MSBuildProject> {\n    if (\n      options.GetProperty.length === 0\n      && options.GetItem.length === 0\n      && options.GetTargetResult.length === 0\n    ) {\n      throw new Error(\n        'No MSBuild Property, Item, or TargetResult queries were provided.',\n      );\n    }\n    // reminder: args containing spaces and semi-colons MUST be quote-enclosed!\n    options.FullName = MSBuildProjectProperties.GetFullPath(options.FullName);\n    const _pairs = Object.entries(options.Property).filter(p => typeof p[1] === 'string');\n    const property\n      = _pairs.length === 0\n        ? ''\n        : `-p:\"${_pairs.map(pair => pair[0] + '=' + pair[1]).join(';')}\"`;\n    const target\n      = options.Targets.length === 0\n        ? ''\n        : `\"-t:${options.Targets.join(';')}\"`;\n    const getItem\n      = options.GetItem.length === 0\n        ? ''\n        : `-getItem:\"${options.GetItem.join(',')}\"`;\n    const getProperty\n      = options.GetProperty.length === 0\n        ? ''\n        : `-getProperty:\"${options.GetProperty.join(',')}\"`;\n    const getTargetResult\n      = options.GetTargetResult.length === 0\n        ? ''\n        : `-getTargetResult:\"${options.GetTargetResult.join(',')}\"`;\n    const cmdLine = [\n      'dotnet',\n      'msbuild',\n      `\"${options.FullName}\"`,\n      '-restore',\n      property,\n      target,\n      getItem,\n      getProperty,\n      getTargetResult,\n    ]\n      .filter(v => v !== '')\n      .join(' ');\n    let stdio: Awaited<ReturnType<typeof execAsync>> | undefined = undefined;\n    // may throw\n    while (stdio === undefined) {\n      stdio = await setTimeout(\n        1000,\n        execAsync(cmdLine, true),\n      )\n        .then(async p => await p)\n        .catch<undefined>(catchEBUSY);\n    }\n\n    // todo: consider -getResultOutputFile:file\n    //  Redirect output from get* into a file.\n    //\n    //  Example:\n    //  -getProperty:Bar -getResultOutputFile:Biz.txt\n    //  This writes the value of property Bar into Biz.txt.\n\n    /**\n     * The following issues have triggered this code path:\n     * - BaseIntermediateOutputPath must use Unix path separators ('/') on all\n     *   platforms. Even Windows. Otherwise, MSBuild/dotnet will error-exit with\n     *   \"The BaseIntermediateOutputPath must end with a trailing slash\".\n     */\n    if (stdio.stdout.startsWith('MSBuild version')) {\n      warn(stdio.stdout);\n      throw new Error(\n        'dotnet msbuild was expected to output JSON, but output its version header instead.',\n      );\n    }\n\n    let rawOutput: ConstructorParameters<typeof MSBuildEvaluationOutput>[0];\n    if (stdio.stdout.startsWith('{')) {\n      /** stdout is JSON string */\n      rawOutput = stdio.stdout;\n    }\n    else if (options.GetProperty.length > 0 && options.GetProperty[0] !== undefined) {\n      rawOutput = {\n        Properties: {\n          [options.GetProperty[0]]: String(JSON.parse(stdio.stdout)),\n        },\n      };\n    }\n    else {\n      throw new Error('Dotnet/MSBuild evaluation output is not a string nor JSON object or array.');\n    }\n\n    const evaluation = new MSBuildEvaluationOutput(rawOutput);\n\n    return new MSBuildProject({\n      fullPath: options.FullName,\n      projTargets: await MSBuildProject.GetTargets(options.FullName),\n      evaluation,\n    });\n  }\n\n  /**\n   * Evaluate multiple project paths with some default Evaluate options.\n   * @async\n   * @param projectsToPackAndPush An array of MSBuild projects' full file\n   * paths. If a path is a directory, files in that directory are filtered for\n   * `.csproj`, `.fsproj`, and `.vbproj` project files.\n   * See https://github.com/dotnet/sdk/blob/497f334b2862bdf98b30c00ede2fd259ea5f624d/src/Cli/dotnet/Commands/New/MSBuildEvaluation/MSBuildEvaluationResult.cs#L19-L32.\\\n   * @returns A promised array of {@link MSBuildProject} instances.\n   * All known MSBuild and NuGet properties are evaluated.\n   * If applicable, a project's \"Pack\" target is evaluated.\n   */\n  public static async PackableProjectsToMSBuildProjects(\n    projectsToPackAndPush: string[],\n  ): Promise<Promise<MSBuildProject>[]> {\n    const dirEntriesPromise = toDirEntries(typeof projectsToPackAndPush === 'string' ? [projectsToPackAndPush] : projectsToPackAndPush);\n    const projectPromises: Promise<MSBuildProject>[] = await dirEntriesPromise\n      .then(\n        (direntArray: Dirent[]) =>\n          direntArray.map(element => convertDirentToMSBuildProject(element)),\n      );\n    return projectPromises;\n\n    /**\n     * Map an array of filesystem paths to {@link Dirent} instances representing project files.\n     * @param projectsToPackAndPush An array of MSBuild projects' full file\n     * paths. If a path is a directory, files in that directory are filtered for\n     * `.csproj`, `.fsproj`, and `.vbproj` project files. See\n     * https://github.com/dotnet/sdk/blob/497f334b2862bdf98b30c00ede2fd259ea5f624d/src/Cli/dotnet/Commands/New/MSBuildEvaluation/MSBuildEvaluationResult.cs#L19-L32.\\\n     * @returns An promised array of Dirent instances for discovered project files.\n     */\n    async function toDirEntries(\n      projectsToPackAndPush: string[],\n    ): Promise<Dirent[]> {\n      const dirEntries: (Dirent | Dirent[])[] = await Promise.all(\n        projectsToPackAndPush.map(async (proj) => {\n          proj = await realpath(makeAbsolute(proj));\n          const stats = await stat(proj);\n          let entries: Dirent[];\n\n          if (stats.isFile()) {\n            entries = await readdir(path.dirname(proj), { withFileTypes: true });\n            const dirent: Dirent | undefined = entries.find(v =>\n              path.join(\n                // condition required for compatibility. `.path` was deprecated, but `.parentPath` is not available in our node minversion\n                ('path' in v ? v.path as string | undefined : undefined) ?? (v as unknown as Omit<typeof v, 'path'> & { parentPath: string }).parentPath,\n                v.name,\n              ) === proj,\n            );\n            if (dirent)\n              return dirent;\n            else\n              throw new Error(\n                `file \"${proj}\" not found. It may have been moved or deleted.`,\n              );\n          }\n          if (!stats.isDirectory())\n            throw new Error(`\"${proj}\" is not a file or directory`);\n\n          entries = await readdir(proj, { withFileTypes: true });\n          return entries.filter(v =>\n            v.isFile()\n            && (v.name.endsWith('.csproj') || v.name.endsWith('.fsproj') || v.name.endsWith('.vbproj')),\n          );\n        }),\n      );\n\n      return dirEntries.flat();\n    }\n\n    /**\n     * Map a {@link Dirent} instance to an {@link MSBuildProject} instance.\n     * @param dirent A {@link Dirent} instance. This instance should be an MSBuild project file.\n     * @returns An instance of {@link MSBuildProject} evaluated with the `Pack` target result, if applicable. Evaluated properties will be those whose names are returned by {@link NPPGetterNames.InstanceGettersRecursive}.\n     */\n    async function convertDirentToMSBuildProject(dirent: Dirent): Promise<MSBuildProject> {\n      const fullPath = path.join(\n        // condition required for compatibility. `.path` was deprecated, but `.parentPath` is not available in our node minversion\n        ('path' in dirent ? dirent.path as string | undefined : undefined) ?? (dirent as unknown as Omit<typeof dirent, 'path'> & { parentPath: string }).parentPath,\n        dirent.name,\n      );\n      const projTargets: Promise<string[]> = MSBuildProject.GetTargets(fullPath);\n      const evalTargets = await projTargets.then(v =>\n        v.includes('Pack') ? ['Pack'] : [],\n      );\n      // this might be too long for a command line. What was it on Windows?\n      // 2^15 (32,768) character limit for command lines?\n      const getProperties = NPPGetterNames.InstanceGettersRecursive;\n\n      return await MSBuildProject.Evaluate(\n        EvaluationOptions.from({\n          FullName: fullPath,\n          GetItem: [],\n          GetProperty: getProperties,\n          GetTargetResult: [],\n          Property: {},\n          Targets: evalTargets,\n        }),\n      );\n    }\n  }\n\n  public static fromJSON(json: string): MSBuildProject {\n    const parsed = T_PseudoMSBPInstance.assert(JSON.parse(json));\n\n    type.true.assert(\n      Reflect.setPrototypeOf(parsed, MSBuildProject.prototype),\n    );\n    type.true.assert(\n      Reflect.setPrototypeOf(parsed.Properties, NugetProjectProperties.prototype),\n    );\n    parsed.Properties = T_NPP.assert(parsed.Properties);\n    return T_MSBuildProject.assert(parsed);\n  }\n}\n\nconst T_MSBuildProject = type.instanceOf(MSBuildProject);\nconst T_NPP = type.instanceOf(NugetProjectProperties);\nconst T_PseudoMSBPInstance = type({\n  Items: type({\n    '[string]': type({\n      '[string]': 'string',\n      Identity: 'string',\n      FullPath: 'string',\n      RootDir: 'string',\n      Filename: 'string',\n      Extension: 'string',\n      RelativeDir: 'string',\n      Directory: 'string',\n      RecursiveDir: 'string',\n      ModifiedTime: 'string',\n      CreatedTime: 'string',\n      AccessedTime: 'string',\n      DefiningProjectFullPath: 'string',\n      DefiningProjectDirectory: 'string',\n      DefiningProjectName: 'string',\n      DefiningProjectExtension: 'string',\n      'SubType?': ' string | undefined',\n      'TargetFrameworkIdentifier?': 'string | undefined',\n      'TargetPlatformMoniker?': 'string | undefined',\n      'CopyUpToDateMarker?': 'string | undefined',\n      'TargetPlatformIdentifier?': 'string | undefined',\n      'TargetFrameworkVersion?': 'string | undefined',\n      'ReferenceAssembly?': 'string | undefined',\n    }).array(),\n  }),\n  Properties: type.Record('string', 'string').or(T_NPP),\n  Targets: type.string.array(),\n  TargetResults: msbuildEvaluationOutput.get('TargetResults').exclude('undefined').array(),\n\n});\n\n/**\n * ArkType type definitions for internal usage, but may be re-used elsewhere\n * @internal\n */\nexport const _InternalMSBuildEvaluationTypes: Scope<{\n  msbuildEvaluationOutput: {\n    Properties?: Record<string, string> | undefined;\n    Items?: Record<string, {\n      [x: string]: string | undefined;\n      Identity: string;\n      FullPath: string;\n      RootDir: string;\n      Filename: string;\n      Extension: string;\n      RelativeDir: string;\n      Directory: string;\n      RecursiveDir: string;\n      ModifiedTime: string;\n      CreatedTime: string;\n      AccessedTime: string;\n      DefiningProjectFullPath: string;\n      DefiningProjectDirectory: string;\n      DefiningProjectName: string;\n      DefiningProjectExtension: string;\n      SubType?: string | undefined;\n      TargetFrameworkIdentifier?: string | undefined;\n      TargetPlatformMoniker?: string | undefined;\n      CopyUpToDateMarker?: string | undefined;\n      TargetPlatformIdentifier?: string | undefined;\n      TargetFrameworkVersion?: string | undefined;\n      ReferenceAssembly?: string | undefined;\n    }[]> | undefined;\n    TargetResults?: Record<string, {\n      Result: 'Success';\n      Items: {\n        [x: string]: string | undefined;\n        Identity: string;\n        FullPath: string;\n        RootDir: string;\n        Filename: string;\n        Extension: string;\n        RelativeDir: string;\n        Directory: string;\n        RecursiveDir: string;\n        ModifiedTime: string;\n        CreatedTime: string;\n        AccessedTime: string;\n        DefiningProjectFullPath: string;\n        DefiningProjectDirectory: string;\n        DefiningProjectName: string;\n        DefiningProjectExtension: string;\n        SubType?: string | undefined;\n        TargetFrameworkIdentifier?: string | undefined;\n        TargetPlatformMoniker?: string | undefined;\n        CopyUpToDateMarker?: string | undefined;\n        TargetPlatformIdentifier?: string | undefined;\n        TargetFrameworkVersion?: string | undefined;\n        ReferenceAssembly?: string | undefined;\n      }[];\n    } | {\n      Result: 'Failure';\n      Items: never[];\n    }> | undefined;\n  };\n}> = type.scope({\n  msbuildEvaluationOutput,\n});\n\n/**\n * Resolve a path if it is not already absolute.\n * @param _path A filesystem path.\n * @returns A full path to a filesystem entry. The path is unchecked for whether or not the path (or its parts) exist.\n */\nfunction makeAbsolute(_path: string) {\n  return path.isAbsolute(_path) ? _path : path.resolve(_path);\n}\n\n/**\n * Use this in your catch statement or .catch call to return `undefined` when\n * a \"file in use by another process\" (i.e. EBUSY/ERROR_SHARING_VIOLATION) error is reported.\n * @param error Probably an Error object\n * @returns `undefined` if file in use by another process\n */\nexport function catchEBUSY(error: unknown): undefined {\n  if (isError(error)) {\n    if ('stderr' in error && typeof error.stderr === 'string') {\n      // Normalize colon-like chars: '\\uFF1A'.normalize('NFKC') === ':' === true;\n      const normalizedStderr = error.stderr.normalize('NFKC');\n      const patternEN = /The process cannot access the file '[^']+' because it is being used by another process\\./gm;\n      const hasErrMsgPattern = patternEN.test(normalizedStderr);\n      const isCS2012 = /^CSC ?:.+CS2012:/gm.test(normalizedStderr);\n      // generic error code; error message must be checked.\n      const isAVLN9999 = /AVLN9999:/gm.test(normalizedStderr)\n        && hasErrMsgPattern;\n      if (isCS2012 || isAVLN9999 || hasErrMsgPattern)\n        // eslint-disable-next-line unicorn/no-useless-undefined\n        return undefined; /* retry */\n    }\n    /**\n     * some known warnings/errors:\n     * - warning MSB3073:\n     *   The command \"dotnet tool list kuinox.nupkgdeterministicator\"\n     *   exited with code 145.\n     *    > $ dotnet tool list kuinox.nupkgdeterministicator\n     *    > The command could not be loaded, possibly because:\n     *    >   * You intended to execute a .NET application:\n     *    >       The application 'tool' does not exist.\n     *    >   * You intended to execute a .NET SDK command:\n     *    >       No .NET SDKs were found.\n     *    >\n     *    > Download a .NET SDK:\n     *    > https://aka.ms/dotnet/download\n     *    >\n     *    > Learn about SDK resolution:\n     *    > https://aka.ms/dotnet/sdk-not-found\n     */\n    else throw error;\n  }\n  else throw new Error('unknown error', { cause: error });\n}\n\n/**\n *\n * Use this in your catch statement or .catch call to return `undefined` when\n * MSBuild error CSC2012 (e.g. \"file in use by another process\") is reported.\n * @param error Probably an Error object\n * @returns `undefined` if CSC2012 (file in use by another process) occurs\n * @deprecated Use {@link catchEBUSY}.\n */\nexport function catchCsc2012(error: unknown): undefined {\n  if (isError(error)) {\n    // check for error reported when \"file in use by another process\" i.e. EBUSY\n    // (UNIX), NTSTATUS.ERROR_SHARING_VIOLATION == 0x20 == 32 (Windows)\n    if ('stderr' in error && typeof error.stderr === 'string'\n      && /^CSC ?:.+CS2012:/gm.test(\n        // '\\uFF1A'.normalize('NFKC') === ':' === true;\n        error.stderr.normalize('NFKC'),\n      )\n    ) {\n      // eslint-disable-next-line unicorn/no-useless-undefined\n      return undefined; /* retry */\n    }\n    /**\n     * some known warnings/errors:\n     * - warning MSB3073:\n     *   The command \"dotnet tool list kuinox.nupkgdeterministicator\"\n     *   exited with code 145.\n     *    > $ dotnet tool list kuinox.nupkgdeterministicator\n     *    > The command could not be loaded, possibly because:\n     *    >   * You intended to execute a .NET application:\n     *    >       The application 'tool' does not exist.\n     *    >   * You intended to execute a .NET SDK command:\n     *    >       No .NET SDKs were found.\n     *    >\n     *    > Download a .NET SDK:\n     *    > https://aka.ms/dotnet/download\n     *    >\n     *    > Learn about SDK resolution:\n     *    > https://aka.ms/dotnet/sdk-not-found\n     */\n    else throw error;\n  }\n  else throw new Error('unknown error', { cause: error });\n}\n"],"mappings":"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"}

package/mjs/semantic-release__commit-analyzer.d.mts

@@ -1,10 +1,207 @@
 //#region src/semantic-release__commit-analyzer.d.ts
 declare module '@semantic-release/commit-analyzer' {
-  interface RuleObject {
-    type?: string;
-    scope?: string;
-    release: string;
+  // #region RuleObject
+  namespace RuleObjects {
+    interface _Base {
+      /** @default true if {@link release} is 'major' */
+      breaking?: boolean;
+      revert?: boolean;
+      /** @default 'patch' if {@link revert} is `true` */
+      release: 'major' | 'premajor' | 'minor' | 'preminor' | 'patch' | 'prepatch' | 'prerelease' | false;
+    }
+    /**
+     * @see {@linkplain https://github.com/conventional-changelog/conventional-changelog/blob/61573ecba6aea718b96365c96993d4fa7d53c6fd/packages/conventional-changelog-angular/src/parser.js#L3-L11 ParserOpts_Angular},
+     */
+    interface Angular extends _Base {
+      type?: 'build' | 'ci' | 'docs' | 'feat' | 'fix' | 'perf' | 'refactor' | 'style' | 'test';
+      scope?: string;
+      subject?: string;
+    }
+    /**
+     * @see {@linkplain https://github.com/conventional-changelog/conventional-changelog/blob/61573ecba6aea718b96365c96993d4fa7d53c6fd/packages/conventional-changelog-atom/src/parser.js#L3-L4 ParserOpts_Atom}
+     * @example The defaults config includes...
+     *  [
+     *    ...
+     *    { emoji: ":racehorse:", release: "patch" },
+     *    { emoji: ":bug:", release: "patch" },
+     *    { emoji: ":penguin:", release: "patch" },
+     *    { emoji: ":apple:", release: "patch" },
+     *    { emoji: ":checkered_flag:", release: "patch" }
+     *    ...
+     *  ]
+     */
+    interface Atom extends _Base {
+      /**
+       * Consider starting the commit message with an applicable emoji:
+       *  - 🎨 :art: when improving the format/structure of the code
+       *  - 🐎 :racehorse: when improving performance
+       *  - 🚱 :non-potable_water: when plugging memory leaks
+       *  - 📝 :memo: when writing docs
+       *  - 🐧 :penguin: when fixing something on Linux
+       *  - 🍎 :apple: when fixing something on Mac OS
+       *  - 🏁 :checkered_flag: when fixing something on Windows
+       *  - 🐛 :bug: when fixing a bug
+       *  - 🔥 :fire: when removing code or files
+       *  - 💚 :green_heart: when fixing the CI build
+       *  - ✅ :white_check_mark: when adding tests
+       *  - 🔒 :lock: when dealing with security
+       *  - ⬆️ :arrow_up: when upgrading dependencies
+       *  - ⬇️ :arrow_down: when downgrading dependencies
+       *  - 👕 :shirt: when removing linter warnings
+       */
+      emoji: `:${string}:`;
+      shortDesc?: string;
+    }
+    /**
+     * @see {@link https://github.com/conventional-changelog/conventional-changelog/blob/61573ecba6aea718b96365c96993d4fa7d53c6fd/packages/conventional-changelog-codemirror/src/parser.js#L3-L7 ParserOpts_CodeMirror}
+     */
+    interface CodeMirror extends _Base {
+      language?: string;
+      type?: string;
+      message: string;
+    }
+    /**
+     * @see {@link https://github.com/conventional-changelog/conventional-changelog/blob/61573ecba6aea718b96365c96993d4fa7d53c6fd/packages/conventional-changelog-conventionalcommits/src/parser.js#L3-L13 ParserOpts_ConventionalCommits}
+     */
+    interface ConventionalCommits extends Angular {
+      type?: 'build' | 'chore' | 'ci' | 'docs' | 'feat' | 'feature' | 'fix' | 'perf' | 'refactor' | 'revert' | 'style' | 'test';
+    }
+    namespace Ember_Subtypes {
+      interface Base extends _Base {
+        /**
+         * In general, almost all commits should fall into one of these categories.
+         * In the cases where they don't, commit without a tag.
+         */
+        tag?: 'BUGFIX' | 'CLEANUP' | 'DOC' | 'FEATURE' | 'SECURITY';
+        /**
+         * BUGFIX: 'beta' | 'release'
+         * CLEANUP: 'beta'
+         * DOCS: 'canary' | 'beta' | 'release'
+         *  Default: 'canary'
+         *  The most stable release the change applies to.
+         * FEATURE: the flag of the feature
+         * SECURITY: 'cve'
+         * @example [BUGFIX beta], [BUGFIX release], [CLEANUP beta], [DOC canary], [DOC beta], [DOC release], [FEATURE <name>], [SECURITY cve]
+         */
+        taggedAs?: string;
+        /** All text after '[$tag $taggedAs]' in the commit message */
+        message?: string;
+      }
+      type None = Omit<Base, 'tag' | 'taggedAs'>;
+      interface BUGFIX extends Base {
+        tag: 'BUGFIX';
+        taggedAs: 'beta' | 'release';
+      }
+      interface CLEANUP extends Base {
+        tag: 'CLEANUP';
+        taggedAs: 'beta';
+      }
+      interface DOC extends Base {
+        tag: 'DOC';
+        taggedAs: 'canary' | 'beta' | 'release';
+      }
+      interface FEATURE extends Base {
+        tag: 'FEATURE';
+        taggedAs: string;
+      }
+      interface SECURITY extends Base {
+        tag: 'SECURITY';
+        taggedAs: 'cve';
+      }
+    }
+    type Ember = Ember_Subtypes.None | Ember_Subtypes.BUGFIX | Ember_Subtypes.CLEANUP | Ember_Subtypes.DOC | Ember_Subtypes.FEATURE | Ember_Subtypes.SECURITY;
+    /** Legacy; ESLint uses Conventional Commits. Source: https://eslint.org/docs/latest/contribute/pull-requests#step2 */
+    interface ESLint extends _Base {
+      /**
+       * - Breaking - for a backwards-incompatible enhancement or feature.
+       * - Build - changes to build process only.
+       * - Chore - for refactoring, adding tests, etc. (anything that isn't user-facing).
+       * - Docs - changes to documentation only.
+       * - Fix - for a bug fix.
+       * - New - implemented a new feature.
+       * - Update - either for a backwards-compatible enhancement or for a rule change that adds reported problems.
+       * - Upgrade - for a dependency upgrade.
+       */
+      tag: 'Breaking' | 'Build' | 'Chore' | 'Docs' | 'Fix' | 'New' | 'Update' | 'Upgrade';
+      message?: string;
+    }
+    /** A derivation of Angular / Conventional Commits */
+    interface Express extends _Base {
+      /** @example 'build' | 'chore' | 'deps' | 'docs' | 'fix' | 'lint' | 'perf' | ... */
+      component: Angular['type'] | 'deps' | 'lint';
+      shortDesc?: string;
+    }
+    interface JQuery extends _Base {
+      /** @example 'Event' | 'Autocomplete' */
+      component?: string;
+    }
+    interface JSHint extends _Base {
+      type: 'FIX' | 'FEAT' | 'DOCS' | 'TEST' | 'CHORE';
+      shortDesc?: string;
+    }
+  }
+  type RuleObject = RuleObjects._Base | RuleObjects.Angular | RuleObjects.Atom | RuleObjects.CodeMirror | RuleObjects.ConventionalCommits | RuleObjects.Ember | RuleObjects.ESLint | RuleObjects.Express | RuleObjects.JQuery | RuleObjects.JSHint; // #endregion RuleObject
+  // #region PresetConfig
+  /**
+   * Substitutions:
+   * - {@linkplain https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#host host}
+   * - {@linkplain https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#owner owner}
+   * - {@linkplain https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#repository repository}
+   * - {@linkplain https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#hash hash}
+   * - {@linkplain https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#previoustype previousTag}
+   * - {@linkplain https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#currenttag currentTag}
+   */
+  namespace PresetConfigs {
+    interface _Base {
+      /** @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#commiturlformat-string */
+      commitUrlFormat?: string;
+      /** @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#compareurlformat-string */
+      compareUrlFormat?: string;
+      /** @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#header-string */
+      header?: string;
+      /**
+       * @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#issueprefixes-array-of-string
+       * @example ['TEST-']
+       */
+      issuePrefixes?: string[];
+      /**
+       * @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#issueurlformat-string
+       * @example 'https://myBugTracker.com/{{prefix}}{{id}}'
+       */
+      issueUrlFormat?: string;
+      /** @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#premajor-boolean */
+      preMajor?: boolean;
+      /** @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#releasecommitmessageformat-string */
+      releaseCommitMessageFormat?: string;
+      /** @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#types */
+      types?: {
+        type: string;
+        scope?: string;
+        section?: string;
+        hidden?: boolean;
+      }[];
+      /** @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#userurlformat-string */
+      userUrlFormat?: string;
+    }
+    interface ConventionalCommits extends _Base {
+      /**
+       * Regular expression to match and exclude commits from the changelog. Commits matching this pattern will be ignored.
+       */
+      ignoreCommits?: string | RegExp;
+      /** Array of commit type objects defining which types to include in the changelog. Hidden types are excluded from the changelog but may still trigger version bumps. Default value accessible via `DEFAULT_COMMIT_TYPES` export. */
+      types?: RuleObjects.ConventionalCommits;
+      /** When `true`, version bumps occur only for breaking changes or non-hidden commit types. When `false` (default), any commit can trigger a version bump. */
+      bumpStrict?: boolean;
+      /** String or array of scope names to filter commits. Only commits with matching scopes will be included. When `scopeOnly` is `false` (default), commits without any scope are also included. */
+      scope?: string | string[];
+      /**
+       * When `true` and `scope` is specified, excludes commits that have no scope. When `false` (default), includes both scoped and unscoped commits when filtering by scope.
+       * @default false
+       */
+      scopeOnly?: boolean;
+    }
   }
+  type PresetConfig = PresetConfigs._Base | PresetConfigs.ConventionalCommits; // #endregion PresetConfig
   type AnyRecord = Record<keyof unknown, unknown>;
   export interface CommitAnalyzerConfig {
     preset?: string;
@@ -15,6 +212,10 @@ declare module '@semantic-release/commit-analyzer' {
      * See https://github.com/semantic-release/commit-analyzer?tab=readme-ov-file#external-package--file
      */
     releaseRules?: string | RuleObject[];
+    /**
+     * Additional configuration passed to the {@linkplain https://github.com/conventional-changelog/conventional-changelog conventional-changelog} preset.
+     * Used for example with {@linkplain https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md conventional-changelog-conventionalcommits}.
+     */
     presetConfig?: AnyRecord;
   }
   export type Options = CommitAnalyzerConfig;

package/mjs/semantic-release__commit-analyzer.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"semantic-release__commit-analyzer.d.mts","names":["Record","AnyRecord","RuleObject","CommitAnalyzerConfig","Promise","type","scope","release","preset","config","parserOpts","releaseRules","presetConfig","Options","analyzeCommits","pluginConfig","commits","cwd","context","sideEffect","_0"],"sources":["../src/semantic-release__commit-analyzer.d.ts"],"mappings":";;YAEYE,UAAAA;IACRG,IAAAA;IACAC,KAAAA;IACAC,OAAAA;EAAAA;EAAAA,KAGGN,SAAAA,GAAYD,MAAAA;EAAAA,iBAEAG,oBAAAA;IACfK,MAAAA;IACAC,MAAAA;IACAC,UAAAA,GAAaT,SAAAA;IAVbI;;;;IAeAM,YAAAA,YAAwBT,UAAAA;IACxBU,YAAAA,GAAeX,SAAAA;EAAAA;EAAAA,YAGLY,OAAAA,GAAUV,oBAAAA;EAJpBQ;;;;;;;;;;;;;EAAAA,gBAmBcG,cAAAA,CACdC,YAAAA;IACEP,MAAAA;IACAC,MAAAA;IACAE,YAAAA,WAAuBV,SAAAA;IACvBS,UAAAA;EAAAA,GAEFQ,OAAAA;IACEF,OAAAA;IACAC,GAAAA;EAAAA,IAEDb,OAAAA;AAAAA"}
+{"version":3,"file":"semantic-release__commit-analyzer.d.mts","names":["_Base","Angular","Base","Omit","Ember_Subtypes","None","BUGFIX","CLEANUP","DOC","FEATURE","SECURITY","RuleObjects","Atom","CodeMirror","ConventionalCommits","Ember","ESLint","Express","JQuery","JSHint","RegExp","PresetConfigs","Record","AnyRecord","RuleObject","CommitAnalyzerConfig","Promise","breaking","revert","release","type","scope","subject","emoji","shortDesc","language","message","tag","taggedAs","component","commitUrlFormat","compareUrlFormat","header","issuePrefixes","issueUrlFormat","preMajor","releaseCommitMessageFormat","types","section","hidden","userUrlFormat","ignoreCommits","bumpStrict","scopeOnly","PresetConfig","preset","config","parserOpts","releaseRules","presetConfig","Options","analyzeCommits","pluginConfig","commits","cwd","context","sideEffect","_0"],"sources":["../src/semantic-release__commit-analyzer.d.ts"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@halospv3/hce.shared-config",
-  "version": "3.4.8",
+  "version": "3.5.0",
   "description": "Automate commit message quality, changelogs, and CI/CD releases. Its `main` entry point is a Semantic Release config. Functions and classes are exposed for customization. An ESLint config, a Commitlint config, and addl. resources for .NET projects are also provided.",
   "keywords": [
     "semantic-release",
@@ -47,7 +47,6 @@
     "lint:check": "eslint --cache .",
     "eslint-inspector": "eslint --inspect-config",
     "prepack": "npm run clean && npm run build",
-    "pack": "echo 'You should use `npm pack`' && exit 1",
     "postinstall": "patch-package && husky",
     "presemantic-release": "npm pack",
     "semantic-release": "semantic-release",
@@ -62,7 +61,7 @@
   "dependencies": {
     "@commitlint/cli": "^20.5.0",
     "@commitlint/config-conventional": "^20.5.0",
-    "@dotenvx/dotenvx": "^1.57.2",
+    "@dotenvx/dotenvx": "^1.59.1",
     "@eslint/js": "^10.0.1",
     "@eslint/json": "^1.2.0",
     "@semantic-release/changelog": "^6.0.3",
@@ -76,7 +75,7 @@
     "@types/node": "~24.12.0",
     "arktype": "^2.1.20",
     "chardet": "^2.1.0",
-    "conventional-changelog-conventionalcommits": "^9.2.0",
+    "conventional-changelog-conventionalcommits": "^9.3.1",
     "debug": "^4.4.1",
     "error.iserror": "^1.0.2",
     "es-main": "^1.3.0",
@@ -87,13 +86,12 @@
     "semantic-release": "^25.0.0",
     "semantic-release-export-data": "^1.1.0",
     "ts-essentials": "^10.1.1",
-    "typescript-eslint": "^8.57.2"
+    "typescript-eslint": "^8.58.0"
   },
   "peerDependencies": {
     "@bintoss/semantic-release-npm-multiple": "^3.0.0 || >= 3.0.0",
     "@commitlint/types": "^20.0.0 || >= 20.0.0",
     "@semantic-release/gitlab": "^13.0.0 || >= 13.0.0",
-    "@tsconfig/node24": "^24.0.3",
     "eslint": "^10.0.0",
     "typescript": "^5.0.0 || >=5.0.0"
   },
@@ -110,22 +108,21 @@
     "@bintoss/semantic-release-npm-multiple": "^3.17.1",
     "@commitlint/types": "^20.5.0",
     "@eslint/config-inspector": "^1.4.2",
-    "@eslint/markdown": "^8.0.0",
+    "@eslint/markdown": "^8.0.1",
     "@sebbo2002/semantic-release-jsr": "^3.2.0",
     "@semantic-release/gitlab": "^13.3.2",
-    "@tsconfig/node24": "^24.0.3",
     "@types/debug": "^4.1.13",
     "@types/tmp": "^0.2.6",
     "conventional-changelog-preset-loader": "^5.0.0",
     "eslint": "^10.1.0",
-    "eslint-plugin-jsdoc": "^62.8.1",
-    "eslint-plugin-unicorn": "^63.0.0",
+    "eslint-plugin-jsdoc": "^62.9.0",
+    "eslint-plugin-unicorn": "^64.0.0",
     "publint": "^0.3.18",
     "tmp": "^0.2.3",
-    "tsdown": "^0.21.5",
+    "tsdown": "^0.21.7",
     "tslib": "^2.8.1",
     "tsx": "^4.20.3",
-    "typescript": "^5.8.3",
+    "typescript": "^6.0.0",
     "unplugin-unused": "^0.5.7"
   },
   "//engines.node": "See file://./.nvmrc, https://github.com/nvm-sh/nvm#nvmrc. Supporting the lowest version possible is a PITA. Just support LTS. ",

package/src/dotnet/MSBuildProject.ts

@@ -685,6 +685,7 @@ export function catchEBUSY(error: unknown): undefined {
       const isAVLN9999 = /AVLN9999:/gm.test(normalizedStderr)
         && hasErrMsgPattern;
       if (isCS2012 || isAVLN9999 || hasErrMsgPattern)
+        // eslint-disable-next-line unicorn/no-useless-undefined
         return undefined; /* retry */
     }
     /**
@@ -728,6 +729,7 @@ export function catchCsc2012(error: unknown): undefined {
         error.stderr.normalize('NFKC'),
       )
     ) {
+      // eslint-disable-next-line unicorn/no-useless-undefined
       return undefined; /* retry */
     }
     /**

package/src/semantic-release__commit-analyzer.d.ts

@@ -1,11 +1,248 @@
 declare module '@semantic-release/commit-analyzer' {
 
-  interface RuleObject {
-    type?: string;
-    scope?: string;
-    release: string;
+  // #region RuleObject
+  namespace RuleObjects {
+    interface _Base {
+    /** @default true if {@link release} is 'major' */
+      breaking?: boolean;
+      revert?: boolean;
+      /** @default 'patch' if {@link revert} is `true` */
+      release: 'major' | 'premajor' | 'minor' | 'preminor' | 'patch' | 'prepatch' | 'prerelease' | false;
+    }
+
+    /**
+     * @see {@linkplain https://github.com/conventional-changelog/conventional-changelog/blob/61573ecba6aea718b96365c96993d4fa7d53c6fd/packages/conventional-changelog-angular/src/parser.js#L3-L11 ParserOpts_Angular},
+     */
+    interface Angular extends _Base {
+      type?: 'build' | 'ci' | 'docs' | 'feat' | 'fix' | 'perf' | 'refactor' | 'style' | 'test';
+      scope?: string;
+      subject?: string;
+    }
+
+    /**
+     * @see {@linkplain https://github.com/conventional-changelog/conventional-changelog/blob/61573ecba6aea718b96365c96993d4fa7d53c6fd/packages/conventional-changelog-atom/src/parser.js#L3-L4 ParserOpts_Atom}
+     * @example The defaults config includes...
+     *  [
+     *    ...
+     *    { emoji: ":racehorse:", release: "patch" },
+     *    { emoji: ":bug:", release: "patch" },
+     *    { emoji: ":penguin:", release: "patch" },
+     *    { emoji: ":apple:", release: "patch" },
+     *    { emoji: ":checkered_flag:", release: "patch" }
+     *    ...
+     *  ]
+     */
+    interface Atom extends _Base {
+    /**
+     * Consider starting the commit message with an applicable emoji:
+     *  - 🎨 :art: when improving the format/structure of the code
+     *  - 🐎 :racehorse: when improving performance
+     *  - 🚱 :non-potable_water: when plugging memory leaks
+     *  - 📝 :memo: when writing docs
+     *  - 🐧 :penguin: when fixing something on Linux
+     *  - 🍎 :apple: when fixing something on Mac OS
+     *  - 🏁 :checkered_flag: when fixing something on Windows
+     *  - 🐛 :bug: when fixing a bug
+     *  - 🔥 :fire: when removing code or files
+     *  - 💚 :green_heart: when fixing the CI build
+     *  - ✅ :white_check_mark: when adding tests
+     *  - 🔒 :lock: when dealing with security
+     *  - ⬆️ :arrow_up: when upgrading dependencies
+     *  - ⬇️ :arrow_down: when downgrading dependencies
+     *  - 👕 :shirt: when removing linter warnings
+     */
+      emoji: `:${string}:`;
+      shortDesc?: string;
+    }
+
+    /**
+     * @see {@link https://github.com/conventional-changelog/conventional-changelog/blob/61573ecba6aea718b96365c96993d4fa7d53c6fd/packages/conventional-changelog-codemirror/src/parser.js#L3-L7 ParserOpts_CodeMirror}
+     */
+    interface CodeMirror extends _Base {
+      language?: string;
+      type?: string;
+      message: string;
+    }
+
+    /**
+     * @see {@link https://github.com/conventional-changelog/conventional-changelog/blob/61573ecba6aea718b96365c96993d4fa7d53c6fd/packages/conventional-changelog-conventionalcommits/src/parser.js#L3-L13 ParserOpts_ConventionalCommits}
+     */
+    interface ConventionalCommits extends Angular {
+      type?: 'build' | 'chore' | 'ci' | 'docs' | 'feat' | 'feature' | 'fix' | 'perf' | 'refactor' | 'revert' | 'style' | 'test';
+    }
+
+    namespace Ember_Subtypes {
+      interface Base extends _Base {
+      /**
+       * In general, almost all commits should fall into one of these categories.
+       * In the cases where they don't, commit without a tag.
+       */
+        tag?:
+          | 'BUGFIX'
+          | 'CLEANUP'
+          | 'DOC'
+          | 'FEATURE'
+          | 'SECURITY';
+        /**
+         * BUGFIX: 'beta' | 'release'
+         * CLEANUP: 'beta'
+         * DOCS: 'canary' | 'beta' | 'release'
+         *  Default: 'canary'
+         *  The most stable release the change applies to.
+         * FEATURE: the flag of the feature
+         * SECURITY: 'cve'
+         * @example [BUGFIX beta], [BUGFIX release], [CLEANUP beta], [DOC canary], [DOC beta], [DOC release], [FEATURE <name>], [SECURITY cve]
+         */
+        taggedAs?: string;
+        /** All text after '[$tag $taggedAs]' in the commit message */
+        message?: string;
+      }
+
+      type None = Omit<Base, 'tag' | 'taggedAs'>;
+
+      interface BUGFIX extends Base {
+        tag: 'BUGFIX';
+        taggedAs: 'beta' | 'release';
+      }
+
+      interface CLEANUP extends Base {
+        tag: 'CLEANUP';
+        taggedAs: 'beta';
+      }
+
+      interface DOC extends Base {
+        tag: 'DOC';
+        taggedAs: 'canary' | 'beta' | 'release';
+      }
+
+      interface FEATURE extends Base {
+        tag: 'FEATURE';
+        taggedAs: string;
+      }
+
+      interface SECURITY extends Base {
+        tag: 'SECURITY';
+        taggedAs: 'cve';
+      }
+    }
+
+    type Ember
+      = | Ember_Subtypes.None
+        | Ember_Subtypes.BUGFIX
+        | Ember_Subtypes.CLEANUP
+        | Ember_Subtypes.DOC
+        | Ember_Subtypes.FEATURE
+        | Ember_Subtypes.SECURITY;
+
+    /** Legacy; ESLint uses Conventional Commits. Source: https://eslint.org/docs/latest/contribute/pull-requests#step2 */
+    interface ESLint extends _Base {
+    /**
+     * - Breaking - for a backwards-incompatible enhancement or feature.
+     * - Build - changes to build process only.
+     * - Chore - for refactoring, adding tests, etc. (anything that isn't user-facing).
+     * - Docs - changes to documentation only.
+     * - Fix - for a bug fix.
+     * - New - implemented a new feature.
+     * - Update - either for a backwards-compatible enhancement or for a rule change that adds reported problems.
+     * - Upgrade - for a dependency upgrade.
+     */
+      tag: 'Breaking' | 'Build' | 'Chore' | 'Docs' | 'Fix' | 'New' | 'Update' | 'Upgrade';
+      message?: string;
+    }
+
+    /** A derivation of Angular / Conventional Commits */
+    interface Express extends _Base {
+      /** @example 'build' | 'chore' | 'deps' | 'docs' | 'fix' | 'lint' | 'perf' | ... */
+      component: Angular['type'] | 'deps' | 'lint';
+      shortDesc?: string;
+    }
+
+    interface JQuery extends _Base {
+      /** @example 'Event' | 'Autocomplete' */
+      component?: string;
+    }
+
+    interface JSHint extends _Base {
+      type: 'FIX' | 'FEAT' | 'DOCS' | 'TEST' | 'CHORE';
+      shortDesc?: string;
+    }
   }
 
+  type RuleObject
+    = | RuleObjects._Base
+      | RuleObjects.Angular
+      | RuleObjects.Atom
+      | RuleObjects.CodeMirror
+      | RuleObjects.ConventionalCommits
+      | RuleObjects.Ember
+      | RuleObjects.ESLint
+      | RuleObjects.Express
+      | RuleObjects.JQuery
+      | RuleObjects.JSHint;
+  // #endregion RuleObject
+
+  // #region PresetConfig
+  /**
+   * Substitutions:
+   * - {@linkplain https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#host host}
+   * - {@linkplain https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#owner owner}
+   * - {@linkplain https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#repository repository}
+   * - {@linkplain https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#hash hash}
+   * - {@linkplain https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#previoustype previousTag}
+   * - {@linkplain https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#currenttag currentTag}
+   */
+  namespace PresetConfigs {
+    interface _Base {
+      /** @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#commiturlformat-string */
+      commitUrlFormat?: string;
+      /** @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#compareurlformat-string */
+      compareUrlFormat?: string;
+      /** @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#header-string */
+      header?: string;
+      /**
+       * @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#issueprefixes-array-of-string
+       * @example ['TEST-']
+       */
+      issuePrefixes?: string[];
+      /**
+       * @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#issueurlformat-string
+       * @example 'https://myBugTracker.com/{{prefix}}{{id}}'
+       */
+      issueUrlFormat?: string;
+      /** @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#premajor-boolean */
+      preMajor?: boolean;
+      /** @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#releasecommitmessageformat-string */
+      releaseCommitMessageFormat?: string;
+      /** @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#types */
+      types?: { type: string; scope?: string; section?: string; hidden?: boolean }[];
+      /** @see https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md#userurlformat-string */
+      userUrlFormat?: string;
+    }
+
+    interface ConventionalCommits extends _Base {
+      /**
+       * Regular expression to match and exclude commits from the changelog. Commits matching this pattern will be ignored.
+       */
+      ignoreCommits?: string | RegExp;
+      /** Array of commit type objects defining which types to include in the changelog. Hidden types are excluded from the changelog but may still trigger version bumps. Default value accessible via `DEFAULT_COMMIT_TYPES` export. */
+      types?: RuleObjects.ConventionalCommits;
+      /** When `true`, version bumps occur only for breaking changes or non-hidden commit types. When `false` (default), any commit can trigger a version bump. */
+      bumpStrict?: boolean;
+      /** String or array of scope names to filter commits. Only commits with matching scopes will be included. When `scopeOnly` is `false` (default), commits without any scope are also included. */
+      scope?: string | string[];
+      /**
+       * When `true` and `scope` is specified, excludes commits that have no scope. When `false` (default), includes both scoped and unscoped commits when filtering by scope.
+       * @default false
+       */
+      scopeOnly?: boolean;
+    }
+  }
+
+  type PresetConfig
+    = | PresetConfigs._Base
+      | PresetConfigs.ConventionalCommits;
+  // #endregion PresetConfig
+
   type AnyRecord = Record<keyof unknown, unknown>;
 
   export interface CommitAnalyzerConfig {
@@ -17,6 +254,10 @@ declare module '@semantic-release/commit-analyzer' {
      * See https://github.com/semantic-release/commit-analyzer?tab=readme-ov-file#external-package--file
      */
     releaseRules?: string | RuleObject[];
+    /**
+     * Additional configuration passed to the {@linkplain https://github.com/conventional-changelog/conventional-changelog conventional-changelog} preset.
+     * Used for example with {@linkplain https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/master/versions/2.2.0/README.md conventional-changelog-conventionalcommits}.
+     */
     presetConfig?: AnyRecord;
   }
 

package/tsconfig.base.json

@@ -23,13 +23,12 @@
     }
   },
   "compileOnSave": true,
-  "extends": "@tsconfig/node24/tsconfig.json",
+  "extends": "./tsconfig.node.json",
   "compilerOptions": {
     "allowImportingTsExtensions": true,
     "composite": true,
     "declarationMap": true,
     "emitDeclarationOnly": true,
-    "esModuleInterop": false,
     "forceConsistentCasingInFileNames": true,
     "isolatedDeclarations": true,
     "isolatedModules": true,

package/tsconfig.json

@@ -1,9 +1,7 @@
 {
   "extends": "./tsconfig.base.json",
   "compilerOptions": {
-    "allowImportingTsExtensions": true,
     "outDir": "_tsout",
-    "target": "es2020",
     "erasableSyntaxOnly": true
   },
   "include": [

package/tsconfig.node.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://www.schemastore.org/tsconfig",
+  "_version": "24.0.0",
+
+  "compilerOptions": {
+    "lib": [
+      "es2024",
+      "ESNext.Array",
+      "ESNext.Collection",
+      "ESNext.Error",
+      "ESNext.Iterator",
+      "ESNext.Promise"
+    ],
+    "module": "nodenext",
+    "target": "es2024",
+    "types": [ "node" ],
+
+    "skipLibCheck": true
+  }
+}