@halospv3/hce.shared-config 3.0.0-develop.16 → 3.0.0-develop.18

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [3.0.0-develop.18](https://github.com/HaloSPV3/HCE.Shared/compare/v3.0.0-develop.17...v3.0.0-develop.18) (2025-08-05)
+
+### Bug Fixes
+
+* **dotnet.INVAP:** execute INVAP cli only if it's the main module ([5006ab1](https://github.com/HaloSPV3/HCE.Shared/commit/5006ab1d6ff46554f5fd17d076465fcc1e2018e6)), closes [#455](https://github.com/HaloSPV3/HCE.Shared/issues/455)
+
+## [3.0.0-develop.17](https://github.com/HaloSPV3/HCE.Shared/compare/v3.0.0-develop.16...v3.0.0-develop.17) (2025-07-31)
+
+### Bug Fixes
+
+* **dotnet:** do not mix `export *` and `export type *`! ([1184896](https://github.com/HaloSPV3/HCE.Shared/commit/118489616924fdb3d62670a67b1a0ab8123ba299))
+
 ## [3.0.0-develop.16](https://github.com/HaloSPV3/HCE.Shared/compare/v3.0.0-develop.15...v3.0.0-develop.16) (2025-07-31)
 
 ### Bug Fixes

package/mjs/dotnet/IsNextVersionAlreadyPublished.cli.mjs

@@ -1,26 +1,41 @@
 import { getGithubOutput, NugetRegistryInfo } from './NugetRegistryInfo.mjs';
-const args = process.argv.slice(2);
+import esMain from 'es-main';
 
-// Parse command-line arguments - https://stackoverflow.com/a/76298476/14894786
-const options = {};
-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 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() {
+  const args = process.argv.slice(2);
+  // Parse command-line arguments - https://stackoverflow.com/a/76298476/14894786
+  const options = {};
+  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] = 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');
+  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);
+  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 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 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.`);
+if (esMain(import.meta)) await main();
 //# sourceMappingURL=IsNextVersionAlreadyPublished.cli.mjs.map

package/mjs/dotnet/IsNextVersionAlreadyPublished.cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"IsNextVersionAlreadyPublished.cli.mjs","sources":["../../src/dotnet/IsNextVersionAlreadyPublished.cli.ts"],"sourcesContent":null,"names":[],"mappings":";;AACA,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;;AAElC;AACA,MAAM,OAAO,GAAG,EAAE;AAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;AACzC,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;AACzB,EAAE,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AAC9B,EAAE,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE;AAC/G,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ;AACxC;AACA;AACA,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,EAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC;AACxF,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;AAClF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS;AACnC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM;AACzB,EAAE,cAAc,GAAG,IAAI,MAAM,CAAC,wBAAwB,CAAC;AACvD,MAAM,QAAQ,GAAG,CAAC,MAAM,eAAe,EAAE,KAAK,EAAE;AAChD,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,EAAE,CAAC;AAC1E,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,IAAI,KAAK,CAAC,yHAAyH,CAAC;AACxL,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;AAC9B,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC;AACzG,IAAI,OAAO,WAAW,KAAK,SAAS,EAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC;AACrF,IAAI,WAAW,EAAE,MAAM,IAAI,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAC5F,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,uBAAuB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"IsNextVersionAlreadyPublished.cli.mjs","sources":["../../src/dotnet/IsNextVersionAlreadyPublished.cli.ts"],"sourcesContent":null,"names":[],"mappings":";;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,IAAI,GAAG;AACtB,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AACpC;AACA,EAAE,MAAM,OAAO,GAAG,EAAE;AACpB,EAAE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;AAC3C,IAAI,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;AAC3B,IAAI,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AAChC,IAAI,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE;AACjH,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,QAAQ;AACjC;AACA;AACA,EAAE,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,EAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC;AAC1F,EAAE,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;AACpF,EAAE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS;AACrC,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM;AAC3B,IAAI,cAAc,GAAG,IAAI,MAAM,CAAC,wBAAwB,CAAC;AACzD,EAAE,MAAM,QAAQ,GAAG,CAAC,MAAM,eAAe,EAAE,KAAK,EAAE;AAClD,EAAE,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,EAAE,CAAC;AAC5E,EAAE,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,IAAI,KAAK,CAAC,yHAAyH,CAAC;AAC1L,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;AAChC,EAAE,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC;AAC3G,EAAE,IAAI,OAAO,WAAW,KAAK,SAAS,EAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC;AACvF,EAAE,IAAI,WAAW,EAAE,MAAM,IAAI,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAC9F,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,uBAAuB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AACtF,EAAE,OAAO,CAAC;AACV;AACA,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,IAAI,EAAE"}

package/mjs/dotnet/index.d.ts

@@ -1,11 +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/mjs/dotnet/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dotnet/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,8BAA8B,CAAC;AAClD,mBAAmB,8BAA8B,CAAC;AAClD,mBAAmB,cAAc,CAAC;AAClC,mBAAmB,wCAAwC,CAAC;AAC5D,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,+BAA+B,CAAC;AACnD,mBAAmB,6BAA6B,CAAC;AACjD,mBAAmB,wBAAwB,CAAC;AAE5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,cAAc,CAAC;AAC7B,cAAc,wCAAwC,CAAC;AACvD,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dotnet/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,cAAc,CAAC;AAC7B,cAAc,wCAAwC,CAAC;AACvD,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@halospv3/hce.shared-config",
-  "version": "3.0.0-develop.16",
+  "version": "3.0.0-develop.18",
   "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",
@@ -75,6 +76,7 @@
     "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",

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 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;
+    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] = 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/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/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/"
+  }
+}