@halospv3/hce.shared-config 2.2.3 → 2.3.0

package/cjs/semanticReleaseConfigDotnet.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"semanticReleaseConfigDotnet.cjs","sources":["../src/semanticReleaseConfigDotnet.ts"],"sourcesContent":null,"names":["defaultPlugins","setupGitPluginSpec","configurePrepareCmd","configureDotnetNugetPush","log","baseConfig"],"mappings":";;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,oBAAoB,CAAC,MAAM,EAAE;AAC7C,EAAE,MAAM,SAAS,GAAG,MAAM,CAAC;AAC3B;AACA,EAAE,SAAS,CAAC,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,IAAIA,oCAAc,EAAE,CAAC;AAC9D,EAAE,SAAS,CAAC,OAAO,GAAGC,qCAAkB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAC5D,EAAE,OAAO,SAAS,CAAC;AACnB,CAAC;AACM,SAAS,aAAa,CAAC,MAAM,EAAE,iBAAiB,EAAE,qBAAqB,EAAE;AAChF,EAAE,MAAM,SAAS,GAAG,MAAM,CAAC;AAC3B,EAAE,IAAI,SAAS,CAAC,OAAO,KAAK,SAAS,EAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;AAClH,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI;AACxB;AACA;AACA,EAAE,CAAC,wBAAwB,EAAE;AAC7B;AACA,IAAI,UAAU,EAAEC,iCAAmB,CAAC,iBAAiB,EAAE,qBAAqB,CAAC;AAC7E,IAAI,UAAU,EAAEC,sCAAwB,EAAE;AAC1C,GAAG,CAAC,CAAC,CAAC;AACN,EAAE,OAAO,SAAS,CAAC;AACnB,CAAC;AACD;AACA;AACA;AACA;AACO,SAAS,SAAS,CAAC,iBAAiB,EAAE,qBAAqB,EAAE;AACpE,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE;AAC9E,IAAIC,gBAAG,CAAC,CAAC,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAACC,gCAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtE,GAAG;AACH,EAAE,IAAI,SAAS,GAAG;AAClB,IAAI,GAAGA,gCAAU;AACjB,GAAG,CAAC;AACJ,EAAE,SAAS,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAC9C,EAAE,SAAS,GAAG,aAAa,CAAC,SAAS,EAAE,iBAAiB,EAAE,qBAAqB,CAAC,CAAC;AACjF,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE;AAC9E,IAAID,gBAAG,CAAC,CAAC,yBAAyB,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,GAAG;AACH;;;;;;"}

package/cjs/semanticReleaseConfigDotnet.d.ts

@@ -0,0 +1,30 @@
+/** Semantic-Release Config Factory (dotnet)
+ * A functional Semantic-Release configuration for dotnet projects
+ *
+ * extends {@link baseConfig }
+ *
+ * <-- TABLE OF CONTENTS -->
+ * - evaluateProperties
+ * - configureDotnetRelease
+ * - Insert-Edit Plugins
+ * - Append Plugins
+ *
+ */
+import type { Options } from 'semantic-release';
+/**
+ * TODO: options/params for inserts/edits. NOT ready for production. Currently, this can only add Git plugin's options if undefined or one or more is missing.
+ * Insert (`array.splice`) and/or configure plugins.\
+ * Can be used to...\
+ * ...load plugin A before plugin B\
+ * ...edit a plugin's existing configuration
+ *
+ * @param config An instance of {@link Options}
+ * @returns a modified copy of {@link config}
+ */
+export declare function insertAndEditPlugins(config: Options): Options;
+export declare function appendPlugins(config: Options, projectsToPublish: string[], projectsToPackAndPush: string[]): Options;
+/**
+ * @type {import("semantic-release").Options}
+ */
+export declare function getConfig(projectsToPublish: string[], projectsToPackAndPush: string[]): void;
+//# sourceMappingURL=semanticReleaseConfigDotnet.d.ts.map

package/cjs/semanticReleaseConfigDotnet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semanticReleaseConfigDotnet.d.ts","sourceRoot":"","sources":["../src/semanticReleaseConfigDotnet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,kBAAkB,CAAC;AAK5D;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAQ7D;AAED,wBAAgB,aAAa,CAC5B,MAAM,EAAE,OAAO,EACf,iBAAiB,EAAE,MAAM,EAAE,EAC3B,qBAAqB,EAAE,MAAM,EAAE,WAkB/B;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,iBAAiB,EAAE,MAAM,EAAE,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAYrF"}

package/cjs/setupGitPluginSpec-wrapper.mjs

@@ -0,0 +1,6 @@
+// Bundled with Packemon: https://packemon.dev
+// This is an MJS wrapper for a sibling CJS file
+
+import data from './setupGitPluginSpec.cjs';
+
+export const { DefaultOptions, GitPluginId, setupGitPluginSpec } = data;

package/cjs/setupGitPluginSpec.cjs

@@ -0,0 +1,67 @@
+'use strict';
+
+const GitPluginId = '@semantic-release/git';
+const DefaultOptions = {
+  assets: ['CHANGELOG.md', 'package.json', 'package-lock.json', 'npm-shrinkwrap.json'],
+  // eslint-disable-next-line no-template-curly-in-string
+  message: 'chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}'
+};
+function gitAssetsToArray(assets) {
+  if (assets === undefined || assets === false) return [];
+  if (Array.isArray(assets)) return assets;
+  if (typeof assets === 'string') return [assets];
+  return assets.path === 'string' ? [assets.path] : [];
+}
+
+/**
+ * https://github.com/semantic-release/git#options
+ *
+ * This plugin may be deprecated at a later date.
+ * Why do you need to commit during release?
+ * If you don't need to update a changelog or version in a file, then you don't need this.
+ *
+ * @returns A {@link PluginSpec} array with {@link PluginSpec<GitOptions>}. If Git plugin not in original array, returns the original array.
+ * todo: deprecate for generic or parameterized function
+ */
+function setupGitPluginSpec(plugins) {
+  let newPlugins = plugins;
+  let gitPluginIndex = -1;
+  function pluginSpecIsGit(pluginSpec, pluginSpecIndex) {
+    if (pluginSpec === GitPluginId || pluginSpec[0] === GitPluginId) {
+      gitPluginIndex = pluginSpecIndex;
+      return true;
+    }
+    return false;
+  }
+
+  // if Git plugin not in load order, return as-is.
+  if (!newPlugins.some(pluginSpecIsGit)) return plugins;
+
+  // if string, replace with tuple with default options.
+  newPlugins = newPlugins.map(plugin => plugin === GitPluginId ? [GitPluginId, DefaultOptions] : plugin);
+
+  // ensure assets is an array
+  newPlugins[gitPluginIndex][1].assets = gitAssetsToArray(newPlugins[gitPluginIndex][1].assets);
+  const discardPile = [];
+
+  // de-duplicate Git plugin entries; assign single entry to newPlugins[gitPluginIndex]
+  newPlugins.forEach((current, i) => {
+    if (i > gitPluginIndex && pluginSpecIsGit(current, gitPluginIndex)) {
+      // convert its assets to an array
+      const assets = newPlugins[i][1].assets;
+      const message = newPlugins[i][1].message;
+      // push unique assets to first entry's assets array
+      if (assets !== undefined) newPlugins[gitPluginIndex][1].assets.push(...gitAssetsToArray(assets));
+      if (message !== undefined) newPlugins[gitPluginIndex][1].message = message;
+      discardPile.push(i);
+    }
+  });
+  for (const i of discardPile.sort().reverse()) {
+    newPlugins.splice(i, 1);
+  }
+  return newPlugins;
+}
+exports.DefaultOptions = DefaultOptions;
+exports.GitPluginId = GitPluginId;
+exports.setupGitPluginSpec = setupGitPluginSpec;
+//# sourceMappingURL=setupGitPluginSpec.cjs.map

package/cjs/setupGitPluginSpec.cjs.map

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

package/cjs/setupGitPluginSpec.d.ts

@@ -0,0 +1,18 @@
+import type { PluginSpec } from 'semantic-release';
+export declare const GitPluginId = "@semantic-release/git";
+export declare const DefaultOptions: {
+    assets: string[];
+    message: string;
+};
+/**
+ * https://github.com/semantic-release/git#options
+ *
+ * This plugin may be deprecated at a later date.
+ * Why do you need to commit during release?
+ * If you don't need to update a changelog or version in a file, then you don't need this.
+ *
+ * @returns A {@link PluginSpec} array with {@link PluginSpec<GitOptions>}. If Git plugin not in original array, returns the original array.
+ * todo: deprecate for generic or parameterized function
+ */
+export declare function setupGitPluginSpec(plugins: PluginSpec[]): PluginSpec[];
+//# sourceMappingURL=setupGitPluginSpec.d.ts.map

package/cjs/setupGitPluginSpec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupGitPluginSpec.d.ts","sourceRoot":"","sources":["../src/setupGitPluginSpec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,eAAO,MAAM,WAAW,0BAA0B,CAAC;AACnD,eAAO,MAAM,cAAc;;;CAIL,CAAC;AASvB;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CA+CtE"}

package/dotnet/HCE.Shared.CI.props

@@ -0,0 +1,8 @@
+<!-- Provides sane defaults for CI builds -->
+<Project>
+  <PropertyGroup Condition="'$(CI)' != '' AND '$(CI)' != 'Debug'">
+    <Configuration>Release</Configuration>
+    <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
+    <Deterministic>true</Deterministic>
+  </PropertyGroup>
+</Project>

package/dotnet/HCE.Shared.props

@@ -0,0 +1,6 @@
+<Project>
+  <PropertyGroup>
+    <HCESharedDir>$([System.IO.Path]::GetDirectoryName($(MSBuildThisFileDirectory)))</HCESharedDir>
+    <GitVersion_Path Condition="'$(GitVersion_Path)' == ''">$(MSBuildThisFileDirectory)GitVersion.yml</GitVersion_Path>
+  </PropertyGroup>
+</Project>

package/dotnet/HCE.Shared.targets

@@ -0,0 +1,9 @@
+<!--
+    Import all other .props and .targets in this directory
+    If you import this, you don't need to import anything else. -->
+<Project Label="All HCE.Shared Properties and Targets">
+  <Import Project="./HCE.Shared.CI.props" />
+  <Import Project="./ZipPublishDir.targets" />
+  <!-- Must be explicitly targeted via 'dotnet project.csproj -t:PublishAll'. May lead to incompatibility errors -->
+  <Import Project="./PublishAll.targets" />
+</Project>

package/dotnet/PublishAll.targets

@@ -0,0 +1,43 @@
+<!-- `dotnet -t:PublishAll` will publish all permutations derived from TargetFrameworks and RuntimeIdentifiers
+     !Beware: No compatibility checks are performed! 
+     netstandard2.0 + PublishSingleFile may cause errors! Weirdly, net480 + linux-x64 builds AND runs on both WSL and Windows...
+
+      Based on https://stackoverflow.com/a/43951971/14894786
+      Licensed under CC BY-SA 3.0
+ 
+      ?Ask yourself "Do I *really* need multi-targeting?"
+      If you want to target netstandard2.0, then just do that. It's forward-compatible.
+      If you want that AND you want conditional access to .NET 5+ stuff, then multi-target.
+      If you want to target net462 and net6.0, then multi-target. But also ask yourself why you need to target net462.
+
+      Multi-runtimes?
+      Only useful if you need Self-Contained i.e. include the runtime with your project.
+      If you want to publish Single-File, you don't *need* Self-Contained. Just inform users they must install a particular runtime/framework beforehand.
+  -->
+<Project>
+
+  <Target Name="_PublishProjectIfFrameworkSetAndNotMultiRuntime"
+          DependsOnTargets="Publish"
+          Condition="'$(RuntimeIdentifiers)' == '' And '$(TargetFramework)' != '' " />
+
+  <Target Name="_PublishProjectForAllFrameworksAndRuntimes"
+          Condition=" '$(TargetFramework)' == '' And '$(RuntimeIdentifiers)' != '' ">
+    <ItemGroup>
+      <_PublishFramework Include="$(TargetFrameworks)" />
+      <_PublishRuntime Include="$(RuntimeIdentifiers)" />
+    </ItemGroup>
+
+    <MSBuild Projects="$(MSBuildProjectFile)" Targets="Publish" Properties="TargetFramework=%(_PublishFramework.Identity);RuntimeIdentifier=%(_PublishRuntime.Identity)" />
+  </Target>
+
+  <Target Name="_PublishProjectForAllFrameworksIfFrameworkUnset" 
+          Condition=" '$(TargetFramework)' == '' And '$(RuntimeIdentifiers)' == '' ">
+    <ItemGroup>
+      <_PublishFramework Include="$(TargetFrameworks)" />
+    </ItemGroup>
+    <MSBuild Projects="$(MSBuildProjectFile)" Targets="Publish" Properties="TargetFramework=%(_PublishFramework.Identity)" />
+  </Target>
+
+  <Target Name="PublishAll"
+          DependsOnTargets="_PublishProjectIfFrameworkSetAndNotMultiRuntime;_PublishProjectIfFrameworkSetAndNotMultiRuntime;_PublishProjectForAllFrameworksIfFrameworkUnset" />
+</Project>

package/dotnet/ZipPublishDir.targets

@@ -1,12 +1,23 @@
 <Project>
+  <PropertyGroup>
+    <RepoRoot Condition="'$(RepoRoot)' == '' And '$(ProjectRootDir)' != ''">$(ProjectRootDir)</RepoRoot>
+    <RepoRoot Condition="'$(RepoRoot)' == ''">$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), '.git/index'))</RepoRoot>
+    <RepoRootPublishDir>$(RepoRoot)/publish</RepoRootPublishDir>
+    <PackageOutputPath Condition="'$(PackageOutputPath)' == ''">$(RepoRootPublishDir)</PackageOutputPath>
+  </PropertyGroup>
+
+  <PropertyGroup Condition="'$(CI)' != ''">
+    <Deterministic>true</Deterministic>
+    <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
+    <Configuration>Release</Configuration>
+  </PropertyGroup>
+
   <Target Name="ZipPublishDir" AfterTargets="Publish"
           Outputs="$(DestinationFile)">
     <PropertyGroup>
-      <!-- Required Parameters -->
-      <RepoRoot Condition="'$(RepoRoot)' == '' And '$(ProjectRootDir)' != ''">$(ProjectRootDir)</RepoRoot>
-      <RepoRoot Condition="'$(RepoRoot)' == ''">$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), '.git/index'))</RepoRoot>
-
-      <!-- Optional Parameters
+      <!-- inputs
+          - RepoRoot
+          - RepoRootPublishDir
           - AssemblyName
           - Version
           - VariantArgs (default: Configuration;TargetFramework;RuntimeIdentifier)
@@ -17,8 +28,8 @@
       <AppendVariantArgs Condition="'$(AppendVariantArgs)' == ''">true</AppendVariantArgs>
 
       <appendVarArgs>$(AppendVariantArgs)</appendVarArgs>
-      <repoRootPublishDir>$(RepoRoot)/publish</repoRootPublishDir>
-      
+      <RepoRootPublishDir>$(RepoRoot)/publish</RepoRootPublishDir>
+
       <!-- Only add Configuration when Debug -->
       <dbgCfg Condition="'$(Configuration)' == 'Debug'">$(Configuration)</dbgCfg>
       <!-- "net6.0 win7-x86"
@@ -33,11 +44,11 @@
            "" -->
       <version Condition="'$(Version)' != ''"> $(Version)</version>
       <!-- "C:\Repos\HaloSPV3\HXE\publish\HXE 1.2.3-preview.4 (net6.0 win7-x86).zip" -->
-      <DestinationFile>$(repoRootPublishDir)/$(AssemblyName)$(version)$(enclosedVArgs).zip</DestinationFile>
+      <DestinationFile>$(RepoRootPublishDir)/$(AssemblyName)$(version)$(enclosedVArgs).zip</DestinationFile>
       <!-- todo: look into .NET 8 SDK's Artifacts feature -->
     </PropertyGroup>
 
-    <MakeDir Condition="!Exists('$(repoRootPublishDir)')" Directories="$(repoRootPublishDir)"/>
+    <MakeDir Condition="!Exists('$(RepoRootPublishDir)')" Directories="$(RepoRootPublishDir)"/>
     <ZipDirectory
       SourceDirectory="$(PublishDir)"
       DestinationFile="$(DestinationFile)"

package/dotnet/dotnet-build.ps1

@@ -0,0 +1,67 @@
+# input: SLN_OR_PROJ_FILES
+# Comma-separated. May be relative or absolute.
+
+[System.IO.FileInfo[]]$solutions += ($env:SLN_OR_PROJ_FILES -split ';' | ForEach-Object { if ($_.Length -gt 0) { Get-Item $_ } });
+if ($args.Count -gt 0) {
+    $args | ForEach-Object {
+        $solutions += ($_ -split ';' | ForEach-Object { Get-Item $_ })
+    }
+}
+
+$excludedDirs = '.git', 'bin', 'node_modules', 'obj', 'publish';
+$slnExts = '.sln', '.slnf', '.slnx';
+
+function RecursivelySearchForSolutions {
+    $result;
+
+    # get solutions (*.sln, *.slnf, *.slnx, etc) -in $rootItems
+    $solutions += (Get-ChildItem -File |
+        Where-Object { $_.Extension.ToLowerInvariant() -in $slnExts } |
+        Sort-Object |
+        Get-Unique
+    );
+
+    # also check in sub-directories
+    $subdirs = Get-ChildItem -Path $rootDir -Directory;
+    for ($i = 0; $i -lt $subdirs.Count; $i++) {
+        if (-not ($subdirs[$i].Name -in $excludedDirs)) {
+            $subdirs += (
+                Get-ChildItem -Path $curDir -Directory |
+                Where-Object { -not ($_.Name -in $excludedDirs) }
+            );
+        }
+    }
+    $solutions += (
+        $subdirs |
+        ForEach-Object {
+            Get-ChildItem -Path $_ -File |
+            Where-Object {
+                $_.Extension.ToLowerInvariant() -in $slnExts
+            }
+        }
+    );
+}
+
+# search for solutions files
+if ($solutions.Count -eq 0) {
+    RecursivelySearchForSolutions
+}
+
+# search for project files
+if ($solutions.Count -eq 0 ) {
+    $slnExts += ('.csproj', '.fsproj', '.proj');
+    RecursivelySearchForSolutions
+}
+
+if ($solutions.Count -eq 0) {
+    throw [System.IO.FileNotFoundException]::new('No Solution files (.sln, .slnf, .slnx) or Project files (.csproj, .fsproj, .proj) could be found!')
+}
+
+# solutions/projects are build sequentially. Debug is built, then Release is build.
+$solutions | ForEach-Object {
+    ($_, 'Debug'), ($_, 'Release') |
+    ForEach-Object {
+        Set-Location $_[0].Directory
+        dotnet build ($_[0].FullName) --configuration $_[1]
+    }
+}

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "@halospv3/hce.shared-config",
-  "version": "2.2.3",
+  "version": "2.3.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",
     "halo-ce",
     "semantic-release",
-    "semantic-release-config"
+    "semantic-release-config",
+    "commitlint",
+    "commitlint-config"
   ],
   "type": "module",
   "homepage": "https://github.com/halospv3/hce.shared#readme",
@@ -14,12 +16,15 @@
   "license": "MIT",
   "author": "Noah Sherwin",
   "files": [
+    "!.github/",
+    "!.husky/",
+    "!.vscode/",
+    "!_tsout/",
     "!tests/",
     "CHANGELOG.md",
     "cjs/**/*",
-    "commitlint.config.js",
-    "commitlint.config.ts",
-    "dotnet/",
+    "dotnet/**/*",
+    "mjs/**/*",
     "src/**/*",
     "static/**/*"
   ],
@@ -27,66 +32,75 @@
   "infra": "polyrepo",
   "repository": "github:halospv3/hce.shared",
   "scripts": {
-    "build": "packemon build",
+    "build": "packemon build --addExports --addFiles --declaration --loadConfigs",
     "check": "npm run type && npm run test && npm run lint",
     "clean": "packemon clean",
     "coverage": "npm run test --coverage",
-    "format": "prettier --write \"./src/**/*\" \"./tests/**/*\"",
-    "lint": "eslint --cache --fix \"./src/**/*\" \"./tests/**/*\"",
-    "pack": "packemon pack --addEngines --addFiles --declaration",
+    "format": "prettier --write",
+    "lint": "eslint --cache --fix .",
+    "eslint-inspector": "eslint --inspect-config",
+    "pack": "packemon pack --addExports --addFiles --declaration --loadConfigs && npm run validate",
     "prepare": "husky",
     "presemantic-release": "npm run pack && npm run check",
     "semantic-release": "npx semantic-release",
-    "test": "tsx --test ./tests/index.test.mts",
-    "type": "tsc",
+    "test": "node --test --import tsx ./tests/**/*.test.ts",
+    "type": "tsc --build",
     "validate": "packemon validate",
     "watch": "packemon watch"
   },
   "dependencies": {
-    "@commitlint/cli": "^19.2.1",
-    "@commitlint/config-conventional": "^19.1.0",
+    "@commitlint/cli": "^19.3.0",
+    "@commitlint/config-conventional": "^19.2.2",
     "@commitlint/types": "^19.0.3",
+    "@eslint/js": "^9.3.0",
+    "@octokit/request": "^9.1.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^12.0.0",
     "@semantic-release/exec": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^10.0.2",
+    "@semantic-release/github": "^10.0.4",
     "@semantic-release/npm": "^12.0.0",
     "@semantic-release/release-notes-generator": "^13.0.0",
-    "conventional-changelog-conventionalcommits": "^7.0.2",
+    "@stylistic/eslint-plugin": "^2.1.0",
+    "@types/eslint__js": "^8.42.3",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.12.12",
+    "@types/semantic-release": "^20.0.6",
+    "@typescript-eslint/eslint-plugin": "^7.10.0",
+    "@typescript-eslint/parser": "^7.10.0",
+    "conventional-changelog-conventionalcommits": "^8.0.0",
+    "eslint-plugin-jsonc": "^2.15.1",
+    "globals": "^15.3.0",
     "husky": "^9.0.11",
     "js-yaml": "^4.1.0",
     "node-fetch": "^3.3.2",
-    "semantic-release": "^23.0.4",
-    "semantic-release-export-data": "^1.0.1"
+    "semantic-release": "^23.1.1",
+    "semantic-release-export-data": "^1.0.1",
+    "typescript-eslint": "^7.10.0"
   },
   "devDependencies": {
-    "@babel/cli": "^7.23.9",
-    "@halospv3/hce.shared-config": "./",
+    "@babel/cli": "^7.24.5",
+    "@babel/core": "^7.24.5",
+    "@babel/eslint-parser": "^7.24.5",
+    "@eslint/eslintrc": "^3.1.0",
     "@tsconfig/node-lts": "^20.1.2",
+    "@types/babel__core": "^7.20.5",
     "@types/debug": "^4.1.12",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^20.11.28",
-    "@types/semantic-release": "^20.0.6",
-    "@typescript-eslint/eslint-plugin": "^7.2.0",
-    "@typescript-eslint/parser": "^7.2.0",
-    "ajv": "^8.12.0",
+    "@types/eslint__eslintrc": "^2.1.1",
+    "ajv": "^8.13.0",
     "ajv-draft-04": "^1.0.0",
     "babel-plugin-cjs-esm-interop": "^4.0.0",
     "eslint": "^8.57.0",
-    "eslint-config-moon": "^3.0.0",
-    "eslint-plugin-disable": "^2.0.3",
     "node-fetch": "^3.3.2",
     "packemon": "^4.0.1",
     "prettier": "^3.2.5",
     "prettier-config-moon": "^1.1.2",
-    "tsconfig-moon": "^1.3.0",
     "tslib": "^2.6.2",
-    "tsx": "^4.7.1",
-    "typescript": "^5.4.3"
+    "tsx": "^4.10.5",
+    "typescript": "^5.4.5"
   },
   "engines": {
-    "node": ">=18.12.0",
+    "node": ">=20.8.1",
     "npm": ">=10.5.0"
   },
   "engineStrict": true,
@@ -94,19 +108,36 @@
     "tag": "latest"
   },
   "exports": {
-    ".": {
-      "node": {
-        "import": "./cjs/index-wrapper.mjs",
-        "types": "./cjs/index.d.ts",
-        "require": "./cjs/index.cjs"
-      }
+    "./package.json": "./package.json",
+    "./*": {
+      "types": "./cjs/*.d.ts",
+      "default": "./cjs/*.cjs"
+    },
+    "./dotnet/*": {
+      "types": "./cjs/dotnet/*.d.ts",
+      "default": "./cjs/dotnet/*.cjs"
     },
-    "./static/.releaserc.yml": "./static/.releaserc.yml",
-    "./commitlint.config.ts": "./commitlint.config.ts"
+    ".": {
+      "types": "./cjs/index.d.ts",
+      "import": "./cjs/index-wrapper.mjs",
+      "default": "./cjs/index.cjs"
+    }
   },
   "types": "./cjs/index.d.ts",
   "packemon": {
-    "format": "cjs",
-    "platform": "node"
+    "format": [
+      "cjs"
+    ],
+    "platform": "node",
+    "inputs": {
+      "commitlintConfig": "src/commitlintConfig.ts",
+      "dotnet": "src/dotnet.ts",
+      "eslintConfig": "src/eslintConfig.ts",
+      "findStaticConfig": "src/findStaticConfig.ts",
+      "index": "src/index.ts",
+      "semanticReleaseConfig": "src/semanticReleaseConfig.ts",
+      "semanticReleaseConfigDotnet": "src/semanticReleaseConfigDotnet.ts",
+      "setupGitPluginSpec": "src/setupGitPluginSpec.ts"
+    }
   }
 }

package/src/commitlintConfig.ts

@@ -0,0 +1,15 @@
+import { type RuleConfigSeverity, type UserConfig } from '@commitlint/types';
+
+// CJS compatibility; This enum cannot be required.
+const disabled = 0 as RuleConfigSeverity.Disabled;
+const commitlintConfig: UserConfig = {
+	extends: ['@commitlint/config-conventional'],
+	rules: {
+		'body-max-line-length': [disabled],
+		'footer-max-line-length': [disabled],
+		'header-max-length': [disabled],
+	},
+};
+
+// only `default` export is loaded via `extends` config key!
+export default commitlintConfig;

package/src/dotnet/MSBuildProject.ts

@@ -0,0 +1,83 @@
+import { execFileSync } from 'node:child_process';
+import { MSBuildProjectProperties } from './MSBuildProjectProperties.js';
+
+/**
+ * All pre-defined properties of {@link MSBuildProjectProperties} except FullPath
+ */
+export const MSBuildProjectPreDefinedProperties = Object.keys(
+	new MSBuildProjectProperties('', false),
+).filter((p) => p !== 'FullPath');
+/** @todo Experimental and may be removed in a later release.
+ * A cache for your evaluated MSBuild Projects.
+ */
+export const MSBuildEvaluatedProjects: MSBuildProject[] = [];
+
+export class MSBuildProject {
+	Properties: MSBuildProjectProperties;
+
+	/**
+	 *
+	 * @param fullPath The full path of the .NET MSBuild project file.
+	 * @param customProperties MSBuild properties to evaluate in addition to those pre-defined in {@link MSBuildProjectProperties}
+	 */
+	constructor(fullPath: string, customProperties?: string[]) {
+		// super();
+		this.Properties = MSBuildProject.evaluateProperties(fullPath, customProperties ?? []);
+	}
+
+	/**
+	 *
+	 * `dotnet msbuild src -getProperty:TargetFramework -getProperty:TargetFrameworks -getProperty:RuntimeIdentifiers -getProperty:IsTrimmable`
+	 *
+	 * ...produces...
+	 *
+	 * ```json
+	 * {
+	 *   "Properties": {
+	 *     "TargetFramework": "net6.0",
+	 *     "TargetFrameworks": "",
+	 *     "RuntimeIdentifiers": "win7-x64;win7-x86;win-arm64;linux-x64;linux-arm64",
+	 *     "IsTrimmable": "true",
+	 *   }
+	 * }
+	 * ```
+	 *
+	 * ...which can can be parsed like...
+	 * ```js
+	 * var ridArray = JSON.parse(out).Properties.RuntimeIdentifiers.split(';');
+	 * ```
+	 */
+	static evaluateProperties(fullPath: string, properties: string[]): MSBuildProjectProperties {
+		const evaluatedProps: MSBuildProjectProperties = new MSBuildProjectProperties(fullPath);
+
+		// if a default prop isn't in properties, add it
+		const defaultProps = MSBuildProjectPreDefinedProperties;
+		for (const defaultProp of defaultProps) {
+			if (!properties.includes(defaultProp)) properties.push(defaultProp);
+		}
+		const getPropArgs: string[] = properties.map((propName) => `-getProperty:${propName}`);
+		// should return a single value OR string-encoded JSON object with 'Properties' object-type property.
+		const out = execFileSync('dotnet', ['msbuild', evaluatedProps.FullPath, ...getPropArgs], {
+			encoding: 'utf8',
+			stdio: 'pipe',
+		}).trim();
+		if (out.startsWith('MSBUILD : error'))
+			throw new Error(out);
+
+		let props: Record<string, string>;
+		if (out.startsWith('{')) {
+			const obj = JSON.parse(out) as object;
+			if ("Properties" in obj && typeof obj.Properties === 'object' && obj.Properties !== null)
+				props = obj.Properties as Record<string, string>;
+			throw new Error('When evaluating properties with MSBuild, "Properties" could not be found in the deserialized JSON object.')
+		}
+		else {
+			props = { [properties[0]]: out.trim() }
+		}
+
+		return {
+			...evaluatedProps,
+			...props,
+		};
+	}
+}

package/src/dotnet/MSBuildProjectProperties.ts

@@ -0,0 +1,28 @@
+import { existsSync } from 'node:fs';
+import { basename, isAbsolute, resolve } from 'node:path';
+
+/**
+ * Known properties. Additional properties may be added upon request.
+ */
+export class MSBuildProjectProperties {
+	[Property: string]: string;
+
+	FullPath = '';
+
+	TargetFramework = '';
+
+	TargetFrameworks = '';
+
+	RuntimeIdentifier = '';
+
+	RuntimeIdentifiers = '';
+
+	constructor(fullPath: string, exists = true) {
+		this.FullPath = fullPath;
+		if (!isAbsolute(this.FullPath)) this.FullPath = resolve(this.FullPath);
+		if (!existsSync(this.FullPath) && exists)
+			throw new Error(
+				`Project ${basename(this.FullPath)} could not be found at "${this.FullPath}"`,
+			);
+	}
+}