@halospv3/hce.shared-config 3.0.0-develop.8 → 3.0.0

package/mjs/utils/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAG1B;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,aAAa,CAAC,EAAE,mBAAmB,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAO5G;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAOvF"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAM1B;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,aAAa,CAAC,EAAE,mBAAmB,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAO5G;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAUvF"}

package/mjs/utils/env.mjs

@@ -1,6 +1,8 @@
 import { config, get } from '@dotenvx/dotenvx';
 import { env } from 'node:process';
 
+/** `get` can return `undefined`. It can also return a `Record`, but that's internal. */
+
 /**
  * A thin wrapper for {@link loadDotenv}. Loads a .env file from {@link process.cwd()} with the given options (or defaults), returns the new value of {@link process.env} with optional overrides.
  * @param [dotenvOptions] An optional {@link DotenvConfigOptions} object to pass to {@link loadDotenv}.
@@ -31,7 +33,9 @@ function getEnvVarValue(envVar, options) {
   options ??= {
     ignore: ['MISSING_KEY', 'MISSING_ENV_FILE']
   };
-  const value = String(env[envVar] ?? get(envVar, options)).trim();
+  let value = env[envVar];
+  const x = get(envVar, options);
+  if (typeof x === 'string') value = x;
   // I hate this. Why is undefined converted to a string?
   return value === '' || value === 'undefined' ? undefined : value;
 }

package/mjs/utils/env.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"env.mjs","sources":["../../src/utils/env.ts"],"sourcesContent":null,"names":["loadDotenv"],"mappings":";;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,MAAM,CAAC,aAAa,EAAE,SAAS,EAAE;AACjD,EAAEA,MAAU,CAAC,aAAa,CAAC;AAC3B,EAAE,IAAI,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC;AAC9C,EAAE,OAAO,GAAG;AACZ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE;AAChD,EAAE,OAAO,KAAK;AACd,IAAI,MAAM,EAAE,CAAC,aAAa,EAAE,kBAAkB;AAC9C,GAAG;AACH,EAAE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE;AAClE;AACA,EAAE,OAAO,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,WAAW,GAAG,SAAS,GAAG,KAAK;AAClE;;;;"}
+{"version":3,"file":"env.mjs","sources":["../../src/utils/env.ts"],"sourcesContent":null,"names":["loadDotenv"],"mappings":";;;AAGA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,MAAM,CAAC,aAAa,EAAE,SAAS,EAAE;AACjD,EAAEA,MAAU,CAAC,aAAa,CAAC;AAC3B,EAAE,IAAI,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC;AAC9C,EAAE,OAAO,GAAG;AACZ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE;AAChD,EAAE,OAAO,KAAK;AACd,IAAI,MAAM,EAAE,CAAC,aAAa,EAAE,kBAAkB;AAC9C,GAAG;AACH,EAAE,IAAI,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC;AACzB,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;AAChC,EAAE,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,KAAK,GAAG,CAAC;AACtC;AACA,EAAE,OAAO,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,WAAW,GAAG,SAAS,GAAG,KAAK;AAClE;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@halospv3/hce.shared-config",
-  "version": "3.0.0-develop.8",
+  "version": "3.0.0",
   "description": "Automate commit message quality, changelogs, and CI/CD releases. Exports a semantic-release shareable configuration deserialized from this package's '.releaserc.yml'. Shared resources for .NET projects are also distributed with this package.",
   "keywords": [
     "halo",
@@ -26,7 +26,8 @@
     "dotnet/*",
     "dotnet/.github/**/*",
     "mjs/**/*",
-    "src/**/*"
+    "src/**/*",
+    "tsconfig*.json"
   ],
   "main": "./mjs/index.mjs",
   "infra": "polyrepo",
@@ -49,27 +50,25 @@
     "prepare": "husky",
     "presemantic-release": "npm pack",
     "semantic-release": "semantic-release",
-    "test": "npm run build && npm run test:noBuild",
+    "pretest": "npm run build && npm run test:cacheSampleProjects",
+    "test": "tsx --test --experimental-test-coverage --enable-source-maps --test-reporter=spec --test-reporter-destination=stdout --test-reporter=lcov --test-reporter-destination=lcov.txt --test-reporter=junit --test-reporter-destination=junit.xml",
     "test:cacheSampleProjects": "echo \"START: Cache Sample Projects\" && tsx ./tests/dotnet/MSBuildProject.projects.ts && echo \"DONE: Cache Sample Projects\"",
-    "pretest:noBuild": "npm run test:cacheSampleProjects",
-    "test:noBuild": "npm run test:justTest",
-    "test:justTest": "tsx --test --experimental-test-coverage --enable-source-maps --test-reporter=spec --test-reporter-destination=stdout --test-reporter=lcov --test-reporter-destination=lcov.txt --test-reporter=junit --test-reporter-destination=junit.xml",
-    "test:watch": "npm run test:justTest -- -- --watch",
+    "test:watch": "npm run test -- --watch",
     "type": "tsc --build",
     "validate": "packemon validate",
     "watch": "packemon watch --loadConfigs"
   },
   "dependencies": {
-    "@commitlint/cli": "^19.8.1",
-    "@commitlint/config-conventional": "^19.8.1",
+    "@commitlint/cli": "^20.0.0",
+    "@commitlint/config-conventional": "^20.0.0",
     "@dotenvx/dotenvx": "^1.47.6",
     "@eslint/js": "^9.31.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/exec": "^7.1.0",
     "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^11.0.3",
-    "@semantic-release/npm": "^12.0.2",
+    "@semantic-release/github": "^12.0.0",
+    "@semantic-release/npm": "^13.0.0",
     "@semantic-release/release-notes-generator": "^14.0.3",
     "@stylistic/eslint-plugin": "^5.1.0",
     "@types/node": "~20.11.0",
@@ -77,20 +76,22 @@
     "chardet": "^2.1.0",
     "conventional-changelog-conventionalcommits": "^9.1.0",
     "debug": "^4.4.1",
+    "es-main": "^1.3.0",
     "eslint-plugin-jsonc": "^2.20.1",
     "globals": "^16.3.0",
     "husky": "^9.1.7",
     "sanitize-filename": "^1.6.3",
-    "semantic-release": "^24.2.7",
+    "semantic-release": "^25.0.0",
     "semantic-release-export-data": "^1.1.0",
     "ts-essentials": "^10.1.1",
     "typescript-eslint": "^8.37.0"
   },
   "devDependencies": {
+    "@amanda-mitchell/semantic-release-npm-multiple": "^3.16.0",
     "@babel/cli": "^7.28.0",
     "@babel/core": "^7.28.0",
     "@babel/eslint-parser": "^7.28.0",
-    "@commitlint/types": "^19.8.1",
+    "@commitlint/types": "^20.0.0",
     "@eslint/config-inspector": "^1.1.0",
     "@eslint/markdown": "^7.0.0",
     "@sebbo2002/semantic-release-jsr": "^3.0.0",
@@ -100,8 +101,8 @@
     "@types/tmp": "^0.2.6",
     "conventional-changelog-preset-loader": "^5.0.0",
     "eslint": "^9.31.0",
-    "eslint-plugin-jsdoc": "^51.4.0",
-    "eslint-plugin-unicorn": "^60.0.0",
+    "eslint-plugin-jsdoc": "^61.0.0",
+    "eslint-plugin-unicorn": "^61.0.0",
     "packemon": "^4.1.2",
     "tmp": "^0.2.3",
     "tslib": "^2.8.1",
@@ -137,5 +138,5 @@
       "setupGitPluginSpec": "src/setupGitPluginSpec.ts"
     }
   },
-  "packageManager": "pnpm@10.13.1+sha512.37ebf1a5c7a30d5fabe0c5df44ee8da4c965ca0c5af3dbab28c3a1681b70a256218d05c81c9c0dcf767ef6b8551eb5b960042b9ed4300c59242336377e01cfad"
+  "packageManager": "pnpm@10.18.1+sha512.77a884a165cbba2d8d1c19e3b4880eee6d2fcabd0d879121e282196b80042351d5eb3ca0935fa599da1dc51265cc68816ad2bddd2a2de5ea9fdf92adbec7cd34"
 }

package/src/debug.ts

@@ -1,9 +1,10 @@
-import debug from 'debug';
+// note: @types/debug is incorrect. There is no .log function!
+import createDebugger, { type Debugger } from 'debug';
 
-const _debug: ReturnType<typeof debug> = debug('@halospv3/hce.shared-config');
+const _debug = createDebugger('@halospv3/hce.shared-config') as Debugger & { log: never };
 
-if (process.argv.some(v => v.includes('--debug')) || debug.enabled('@halospv3/hce.shared-config')) {
-  debug.enable(_debug.namespace);
+if (process.argv.some(v => v.includes('--debug')) || createDebugger.enabled('@halospv3/hce.shared-config')) {
+  createDebugger.enable(_debug.namespace);
 }
 
 export default _debug;

package/src/dotnet/IsNextVersionAlreadyPublished.cli.ts

@@ -1,44 +1,61 @@
 import { NugetRegistryInfo, getGithubOutput } from './NugetRegistryInfo.js';
+import esMain from 'es-main';
 
-const args = process.argv.slice(2);
-
-// Parse command-line arguments - https://stackoverflow.com/a/76298476/14894786
-const options: {
-  packageId?: string;
-  source?: string;
-} & Record<string, string> = {};
-for (let i = 0; i < args.length; i += 2) {
-  const argName = args[i];
-  const argValue = args[i + 1];
-  if (argValue !== undefined && argName?.startsWith('--') === true && options[argName.slice(2)] !== undefined) {
-    options[argName.slice(2)] = argValue;
+/**
+ * @returns if successful
+ * @throws {Error} if...
+ * - {@link process.argv} does not include...
+ *   - `--packageId [string]`
+ *   - `--source [string]`
+ * - Value of `await getGithubOutput())['new-release-version']`...
+ *   - is not a valid Version
+ *   - already exists at `source`
+ */
+async function main(): Promise<0> {
+  const args = process.argv.slice(2);
+  // Parse command-line arguments - https://stackoverflow.com/a/76298476/14894786
+  const options: {
+    packageId: string | undefined;
+    source: string | undefined;
+  } & Record<string, string | undefined> = { packageId: undefined, source: undefined };
+  for (let i = 0; i < args.length; i += 2) {
+    const argName = args[i];
+    const argValue = args[i + 1];
+    if (argValue !== undefined && argName?.startsWith('--') === true) {
+      options[argName.slice(2)] = argValue;
+    }
   }
-}
 
-if (typeof options.packageId !== 'string')
-  throw new Error('packageId must be a string');
-if (typeof options.source !== 'string')
-  throw new Error('source must be a string');
+  if (typeof options.packageId !== 'string')
+    throw new Error('packageId must be a string');
+  if (typeof options.source !== 'string')
+    throw new Error('source must be a string');
+
+  const packageId = options.packageId,
+    source = options.source,
+    versionPattern = new RegExp(/\d+\.\d+\.\d+([-+].+)?/);
+  const ghOutput = await getGithubOutput() ?? {};
+  const matches = versionPattern.exec(ghOutput['new-release-version'] ?? '');
+  if (matches === null || matches.length === 0)
+    throw new Error(
+      'The variable new-release-version is not present in the GITHUB_OUTPUT env file or its value contains invalid characters.',
+    );
 
-const packageId = options.packageId,
-  source = options.source,
-  versionPattern = new RegExp(/\d+\.\d+\.\d+([-+].+)?/);
-const ghOutput = await getGithubOutput() ?? {};
-const matches = versionPattern.exec(ghOutput['new-release-version'] ?? '');
-if (matches === null || matches.length === 0)
-  throw new Error(
-    'The variable new-release-version is not present in the GITHUB_OUTPUT env file or its value contains invalid characters.',
+  const nextVersion = matches[0];
+  const isPublished = await NugetRegistryInfo.IsNextVersionAlreadyPublished(
+    source,
+    packageId,
+    nextVersion,
   );
 
-const nextVersion = matches[0];
-const isPublished = await NugetRegistryInfo.IsNextVersionAlreadyPublished(
-  source,
-  packageId,
-  nextVersion,
-);
+  if (typeof isPublished !== 'boolean')
+    throw new Error('isPublished is not a boolean');
+  if (isPublished)
+    throw new Error(`${packageId}@${nextVersion} already exists at ${source}.`);
+  console.log(`OK: ${packageId}@${nextVersion} does NOT yet exist at ${source}. Yay.`);
+
+  return 0;
+}
 
-if (typeof isPublished !== 'boolean')
-  throw new Error('isPublished is not a boolean');
-if (isPublished)
-  throw new Error(`${packageId}@${nextVersion} already exists at ${source}.`);
-console.log(`OK: ${packageId}@${nextVersion} does NOT yet exist at ${source}. Yay.`);
+if (esMain(import.meta))
+  await main();

package/src/dotnet/MSBuildProject.ts

@@ -331,7 +331,7 @@ export class MSBuildProject {
    * target is specified. If you choose Pack, you must do ['Restore', 'Pack'].
    * @param options The result of {@link EvaluationOptions.from}.
    * @returns A promised {@link MSBuildProject} instance.
-   * @throws if the exec command fails -OR- the JSON parse fails -OR-
+   * @throws {Error} if the exec command fails -OR- the JSON parse fails -OR-
    * MSBuildProject's constructor fails.
    * @see {@link PackableProjectsToMSBuildProjects} for most use-cases.
    */

package/src/dotnet/helpers.ts

@@ -67,7 +67,7 @@ export async function configurePrepareCmd(
    * paths.
    * @returns A Promise of a string. This string contains one or more `dotnet publish`
    * commands conjoined by " && ". It may also include one or more
-   * `dotnet msbuild ${...} -t:PublishAll` commands.
+   * `dotnet msbuild ${...} -t:PublishAll -p:Configuration=Release` commands.
    */
   async function formatDotnetPublish(
     projectsToPublish: string[] | MSBuildProject[],
@@ -138,7 +138,7 @@ export async function configurePrepareCmd(
      * runtime-framework combinations.
      * @returns If {@link proj} imports {@link ../../dotnet/PublishAll.targets}...
      * ```
-     * [`${proj.Properties.MSBuildProjectFullPath} -t:PublishAll`]
+     * [`${proj.Properties.MSBuildProjectFullPath} -t:PublishAll -p:Configuration=Release`]
      * ```
      * Else, an array of `dotnet publish` arguments permutations e.g.
      * ```
@@ -163,7 +163,7 @@ export async function configurePrepareCmd(
      * return publishCmdArray.join(' && ');
      */
     function getPublishArgsPermutations(proj: MSBuildProject):
-      ([`"${typeof proj.Properties.MSBuildProjectFullPath}" -t:PublishAll`])
+      ([`"${typeof proj.Properties.MSBuildProjectFullPath}" -t:PublishAll -p:Configuration=Release`])
       | ([`"${typeof proj.Properties.MSBuildProjectFullPath}"`])
       | (`"${typeof proj.Properties.MSBuildProjectFullPath}" --runtime ${string} --framework ${string}`)[]
       | (`"${typeof proj.Properties.MSBuildProjectFullPath}" --runtime ${string}`)[]
@@ -173,7 +173,7 @@ export async function configurePrepareCmd(
        * permutation, return the appropriate command line.
        */
       if (proj.Targets.includes('PublishAll'))
-        return [`"${proj.Properties.MSBuildProjectFullPath}" -t:PublishAll`];
+        return [`"${proj.Properties.MSBuildProjectFullPath}" -t:PublishAll -p:Configuration=Release`];
 
       // #region formatFrameworksAndRuntimes
       const tfmRidPermutations: `--runtime ${string} --framework ${string}`[]
@@ -220,7 +220,7 @@ export async function configurePrepareCmd(
       // #endregion formatFrameworksAndRuntimes
     }
 
-    const publishCmds: (`dotnet publish "${string}"` | `dotnet publish "${string}" ${string}` | `dotnet msbuild "${string}" -t:PublishAll`)[] = [];
+    const publishCmds: (`dotnet publish "${string}"` | `dotnet publish "${string}" ${string}` | `dotnet msbuild "${string}" -t:PublishAll -p:Configuration=Release`)[] = [];
     /** convert {@link evaluatedPublishProjects} to sets of space-separated CLI args. */
     const argsSets = evaluatedPublishProjects.map(
       proj => getPublishArgsPermutations(proj),
@@ -231,7 +231,10 @@ export async function configurePrepareCmd(
       for (const permutation of args) {
         if (typeof permutation === 'string' && permutation.length === 1)
           throw new Error('Something has gone terribly wrong. A `dotnet publish` argument set was split to single characters!');
-        publishCmds.push(`dotnet publish ${permutation}`);
+        if (/".+" -t:PublishAll -p:Configuration=Release/.test(permutation))
+          publishCmds.push(`dotnet msbuild ${permutation as `"${string}" -t:PublishAll -p:Configuration=Release`}`);
+        else
+          publishCmds.push(`dotnet publish ${permutation}`);
       }
     }
 

package/src/dotnet/index.ts

@@ -1,12 +1,3 @@
-export type * from './GithubNugetRegistryInfo.js';
-export type * from './GitlabNugetRegistryInfo.js';
-export type * from './helpers.js';
-export type * from './IsNextVersionAlreadyPublished.cli.js';
-export type * from './MSBuildProject.js';
-export type * from './MSBuildProjectProperties.js';
-export type * from './NugetProjectProperties.js';
-export type * from './NugetRegistryInfo.js';
-
 export * from './GithubNugetRegistryInfo.js';
 export * from './GitlabNugetRegistryInfo.js';
 export * from './helpers.js';

package/src/dotnet.ts

@@ -1,2 +1 @@
-export type * from './dotnet/index.js';
 export * from './dotnet/index.js';

package/src/eslintConfig.ts

@@ -1,6 +1,7 @@
 import eslint from '@eslint/js';
+import { defineConfig, globalIgnores as setGlobalIgnores } from 'eslint/config';
+import { type Linter } from 'eslint';
 import stylistic, { type RuleOptions } from '@stylistic/eslint-plugin';
-import type { TSESLint } from '@typescript-eslint/utils';
 import jsonc from 'eslint-plugin-jsonc';
 import globals from 'globals/globals.json' with { type: 'json' };
 import tseslint from 'typescript-eslint';
@@ -8,25 +9,22 @@ import tseslint from 'typescript-eslint';
 // https://eslint.org/docs/latest/use/configure/migration-guide#using-eslintrc-configs-in-flat-config
 // https://www.google.com/search?q=javascript+recurse+through+object+and+remove+undefined+properties
 
-const globalIgnores: TSESLint.FlatConfig.Config = {
-  name: 'global ignores',
-  ignores: [
-    '_tsout/**/*',
-    '_tsout/*',
-    '_tsout/',
-    'cjs/**/*',
-    'cjs/*/*',
-    'cjs/*',
-    'mjs/**/*',
-    'mjs/*',
-    'mjs/',
-    'node_modules/**/*',
-    '**/node_modules/**/*',
-    '**/*.tsbuildinfo',
-    '**/bin/**/*',
-    '**/obj/**/*',
-  ],
-};
+const globalIgnores: ReturnType<typeof setGlobalIgnores> = setGlobalIgnores([
+  '_tsout/**/*',
+  '_tsout/*',
+  '_tsout/',
+  'cjs/**/*',
+  'cjs/*/*',
+  'cjs/*',
+  'mjs/**/*',
+  'mjs/*',
+  'mjs/',
+  'node_modules/**/*',
+  '**/node_modules/**/*',
+  '**/*.tsbuildinfo',
+  '**/bin/**/*',
+  '**/obj/**/*',
+]);
 
 const json_json = {
   /** jsonc config union types are a pain to work with. Each union member is mutually exclusive to the others */
@@ -62,18 +60,20 @@ const json_jsonc = {
   ignores: globalIgnores.ignores,
 };
 
-const stylisticWarn = stylistic.configs.customize({
+const stylisticWarn: Linter.Config = stylistic.configs.customize({
   quoteProps: 'as-needed',
   semi: true,
   indent: 2,
-}) as TSESLint.FlatConfig.Config & { rules: { [K in keyof RuleOptions]: TSESLint.SharedConfig.RuleLevel | [TSESLint.SharedConfig.RuleLevel, ...RuleOptions[K]] } };
-// change all stylistic error-severity to warn-severity. Style violations should not denote code errors.
+});
+stylisticWarn.rules ??= {};
+
+// change all stylistic error-severity to warn-severity. Style violations should not imply code errors.
 for (const key in stylisticWarn.rules) {
   const element = stylisticWarn.rules[key];
   if (Array.isArray(element) && (element[0] === 2 || element[0] === 'error'))
     element[0] = 'warn';
   else if (element === 2 || element === 'error') {
-    stylisticWarn.rules[key] = 'warn' satisfies TSESLint.SharedConfig.RuleLevel;
+    stylisticWarn.rules[key] = 'warn';
   }
 }
 
@@ -84,7 +84,7 @@ stylisticWarn.rules['@stylistic/no-extra-parens'] = [
     allowParensAfterCommentPattern: '@type|@satisfies',
     nestedBinaryExpressions: false,
   },
-];
+] satisfies Linter.RuleEntry<RuleOptions['@stylistic/no-extra-parens']>;
 
 stylisticWarn.rules['@stylistic/semi'] = [
   'warn',
@@ -93,9 +93,9 @@ stylisticWarn.rules['@stylistic/semi'] = [
     omitLastInOneLineBlock: false,
     omitLastInOneLineClassBody: false,
   },
-] satisfies TSESLint.SharedConfig.RuleEntry | [TSESLint.SharedConfig.RuleLevelAndOptions, RuleOptions['@stylistic/semi'][0], RuleOptions['@stylistic/semi'][1]];
+] satisfies Linter.RuleEntry<RuleOptions['@stylistic/semi']>;
 
-const config: TSESLint.FlatConfig.ConfigArray = tseslint.config(
+const config: ReturnType<typeof defineConfig> = defineConfig(
   json_json,
   json_json5,
   json_jsonc,

package/src/semanticReleaseConfigDotnet.ts

@@ -80,7 +80,7 @@ export class SemanticReleaseConfigDotnet {
         this._projectsToPublish = p;
       }
       else if (debug.enabled) {
-        debug.log(new Error('At least one project must be published. `projectsToPackAndPush` is empty and environment variable `PROJECTS_TO_PUBLISH` is undefined or empty.'));
+        debug(new Error('At least one project must be published. `projectsToPackAndPush` is empty and environment variable `PROJECTS_TO_PUBLISH` is undefined or empty.'));
       }
     }
 
@@ -91,7 +91,7 @@ export class SemanticReleaseConfigDotnet {
         this._projectsToPackAndPush = p;
       }
       else if (debug.enabled) {
-        debug.log(new Error('projectsToPackAndPush.length must be > 0 or PROJECTS_TO_PACK_AND_PUSH must be defined and contain at least one path.'));
+        debug(new Error('projectsToPackAndPush.length must be > 0 or PROJECTS_TO_PACK_AND_PUSH must be defined and contain at least one path.'));
       }
     }
 
@@ -185,16 +185,13 @@ Appending it to the end of the array...This may cause an unexpected order of ope
         ? `${execOptions.verifyConditionsCmd} && ${verifyConditionsCmdAppendix}`
         : verifyConditionsCmdAppendix;
 
-    const verifyReleaseCmdAppendix = await Promise.all(
-      this.ProjectsToPackAndPush
+    const verifyReleaseCmdAppendix
+      = this.ProjectsToPackAndPush
         .filter(project =>
           typeof project !== 'string',
         ).map(project =>
           project.GetIsNextVersionAlreadyPublishedCommand(),
-        ),
-    ).then(cmds =>
-      cmds.join(' && '),
-    );
+        ).join(' && ');
     execOptions.verifyReleaseCmd
       = execOptions.verifyReleaseCmd && execOptions.verifyReleaseCmd.trim().length > 0
         ? `${execOptions.verifyReleaseCmd} && ${verifyReleaseCmdAppendix}`
@@ -364,7 +361,7 @@ export async function getConfig(
   projectsToPackAndPush?: string[] | NugetRegistryInfo[],
 ): Promise<Options> {
   if (debug.enabled) {
-    debug.log(
+    debug(
       'hce.shared-config:\n' + inspect(baseConfig, false, Infinity, true),
     );
   }
@@ -410,9 +407,8 @@ export async function getConfig(
 
   const options: Options = config.toOptions();
   if (debug.enabled) {
-    console.debug(
-      `modified plugins array:\n${inspect(options.plugins, false, Infinity)}`,
-    );
+    debug('modified plugins array:');
+    debug(inspect(options.plugins, false, Infinity));
   }
 
   return options;

package/src/utils/env.ts

@@ -5,6 +5,9 @@ import { get,
 } from '@dotenvx/dotenvx';
 import { env } from 'node:process';
 
+/** `get` can return `undefined`. It can also return a `Record`, but that's internal. */
+type Get = (key: string, options?: GetOptions) => string | undefined;
+
 /**
  * A thin wrapper for {@link loadDotenv}. Loads a .env file from {@link process.cwd()} with the given options (or defaults), returns the new value of {@link process.env} with optional overrides.
  * @param [dotenvOptions] An optional {@link DotenvConfigOptions} object to pass to {@link loadDotenv}.
@@ -36,7 +39,10 @@ export function getEnv(dotenvOptions?: DotenvConfigOptions, overrides?: NodeJS.P
  */
 export function getEnvVarValue(envVar: string, options?: GetOptions): string | undefined {
   options ??= { ignore: ['MISSING_KEY', 'MISSING_ENV_FILE'] };
-  const value = String(env[envVar] ?? get(envVar, options)).trim();
+  let value = env[envVar];
+  const x = (get as Get)(envVar, options);
+  if (typeof x === 'string')
+    value = x;
   // I hate this. Why is undefined converted to a string?
   return value === '' || value === 'undefined'
     ? undefined

package/tsconfig.base.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig#",
+  "//": {
+    "Typescript Node.js Target Mapping": "https://github.com/microsoft/TypeScript/wiki/Node-Target-Mapping",
+    "Node.js ECMAScript Mapping": "https://node.green/",
+    "vscode-versions": "https://github.com/ewanharris/vscode-versions",
+    "Recommended TSConfig Bases": "https://github.com/tsconfig/bases?tab=readme-ov-file#table-of-tsconfigs",
+    "Available/Latest GitHub Runner Images": "https://github.com/actions/runner-images/tree/main?tab=readme-ov-file#available-images",
+    "Node.js versions in GitHub Runner Images": {
+      "Ubuntu 2404 - Node.js version(s)": {
+        "installed": "https://github.com/actions/runner-images/blob/main/images/ubuntu/Ubuntu2404-Readme.md#language-and-runtime",
+        "cached": "https://github.com/actions/runner-images/blob/main/images/ubuntu/Ubuntu2404-Readme.md#nodejs"
+      },
+      "macOS 14": {
+        "installed": "https://github.com/actions/runner-images/blob/main/images/macos/macos-14-Readme.md#language-and-runtime",
+        "cached": "https://github.com/actions/runner-images/blob/main/images/macos/macos-14-Readme.md#nodejs"
+      },
+      "Windows Server 2022": {
+        "!note!": "[Windows 19 and 22] Node.js version 16 will be removed from Windows images on 2025-05-05. See https://github.com/actions/runner-images/issues/11710",
+        "installed": "https://github.com/actions/runner-images/blob/main/images/windows/Windows2022-Readme.md#language-and-runtime",
+        "cached": "https://github.com/actions/runner-images/blob/main/images/windows/Windows2022-Readme.md#nodejs"
+      }
+    }
+  },
+  "compileOnSave": true,
+  "extends": "./node_modules/@tsconfig/node20/tsconfig.json",
+  "compilerOptions": {
+    "composite": true,
+    "declarationMap": true,
+    "emitDeclarationOnly": true,
+    "forceConsistentCasingInFileNames": true,
+    "isolatedDeclarations": true,
+    "isolatedModules": true,
+    "module": "Node18",
+    "noEmitOnError": true,
+    "noErrorTruncation": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noUncheckedIndexedAccess": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true,
+    "sourceMap": true,
+    "verbatimModuleSyntax": true
+  },
+  "exclude": [
+    "**/node_modules/**",
+    "**/tsconfig.json",
+    "**/tsconfig.*.json"
+  ]
+}

package/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "extends": "./tsconfig.base.json",
+  "compilerOptions": {
+    "allowImportingTsExtensions": true,
+    "outDir": "_tsout",
+    "target": "es2020",
+    "erasableSyntaxOnly": true
+  },
+  "include": [
+    "./*.cts",
+    "./*.mts",
+    "./*.ts"
+  ],
+  "references": [
+    {
+      "path": "./tests/tsconfig.json"
+    },
+    {
+      "path": "./src/tsconfig.json"
+    }
+  ]
+}

package/tsconfig.mjs.json

@@ -0,0 +1,8 @@
+{
+  "extends": "./src/tsconfig.json",
+  "compilerOptions": {
+    "declarationDir": "./mjs/",
+    "outDir": "./mjs/",
+    "rootDir": "./src/"
+  }
+}