@halospv3/hce.shared-config 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,66 @@
+## [1.1.0](https://github.com/halospv3/hce.shared/compare/v1.0.5...v1.1.0) (2023-10-19)
+
+
+### Features
+
+* add ZipPublishDir Target ([36755ac](https://github.com/halospv3/hce.shared/commit/36755ac51586a636ee91057adda94dbff1359c73))
+* **node:** adopt Packemon for project management ([daafc7f](https://github.com/halospv3/hce.shared/commit/daafc7f74939f2793b1e3b8312fe95aa832614d3))
+* **node:** load, validate, and export semantic-release shareable configuration ([74c11af](https://github.com/halospv3/hce.shared/commit/74c11af149f36be5e84a9ee064caaf50522017d1))
+
+
+### Bug Fixes
+
+* **deps:** update semantic-release monorepo ([b8dd3c2](https://github.com/halospv3/hce.shared/commit/b8dd3c2386d9f9717a7f916dcdbc1a1cc5a5f5c5))
+* **deps:** update semantic-release monorepo ([f507178](https://github.com/halospv3/hce.shared/commit/f507178302719193bf323a2f9decb113c078e163))
+* **dotnet:** always overwrite ZipPublishDir DestinationFile ([38ef324](https://github.com/halospv3/hce.shared/commit/38ef32430858ed1060077e7453f5f2825c7c6ab8))
+* **node:** bump minimum Node version to 18.17.1 ([92f5b47](https://github.com/halospv3/hce.shared/commit/92f5b47d40d1f9832b2e9f00b49579976b465166))
+* **node:** lift main function body to top-level; assign to const and export it ([c0cc133](https://github.com/halospv3/hce.shared/commit/c0cc133d9d57949339d223f8aa12c123500c4d9c))
+* **node:** remove use of semantic-release's private get-config, get-logger ([658b37c](https://github.com/halospv3/hce.shared/commit/658b37c6aee922a123b3c2128f5f588372bcbd7b))
+* **node:** resolve "parameter 'options' implicitly 'any'" (TS7006) ([5fd278b](https://github.com/halospv3/hce.shared/commit/5fd278bf0983f63bf41db1484fd62df133993870))
+* update destination path in ZipPublishDir ([b7bfc24](https://github.com/halospv3/hce.shared/commit/b7bfc24f4917628ef9837f94d6e3f87be4b54b1b))
+
+
+### Reverts
+
+* **node:** rename index.mts to index.ts ([f0cd2ee](https://github.com/halospv3/hce.shared/commit/f0cd2ee2bc1e1a4af7dde349d6df65c85944b035))
+
+# Changelog
+
+All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
+
+## [1.0.5](https://github.com/halospv3/hce.shared/compare/v1.0.4...v1.0.5) (2023-07-17)
+
+
+### Bug Fixes
+
+* **deps:** update dependency conventional-changelog-conventionalcommits to v6 ([8f283e6](https://github.com/halospv3/hce.shared/commit/8f283e63fdc03d2fe04e04c25e4283dfa757d4ff))
+* **deps:** update semantic-release monorepo ([8d14404](https://github.com/halospv3/hce.shared/commit/8d1440455fe38d74f6e2a585a22dea9707659a69))
+* remove leftover mrm reference ([a60a1d2](https://github.com/halospv3/hce.shared/commit/a60a1d26f68149b364fb3c155fd605b48ea1cfc8))
+
+## [1.0.4](https://github.com/halospv3/hce.shared/compare/v1.0.3...v1.0.4) (2023-05-26)
+
+
+### Bug Fixes
+
+* **deps:** change all devDependencies to dependencies ([79a4a30](https://github.com/halospv3/hce.shared/commit/79a4a3049d8c6f5f9c91a945bb06e0b2daea3cc7))
+
+### 1.0.3 (2023-05-26)
+
+
+### Bug Fixes
+
+* **dev-deps:** import deps into index.js stub ([7fdb046](https://github.com/halospv3/hce.shared/commit/7fdb04646162dc205024c2b04af945e34d57b52c))
+* **dev-deps:** remove commitizen, cz-conventional-changelog ([b91155a](https://github.com/halospv3/hce.shared/commit/b91155a7d4ba81af1432c520f55e3cb09c13089c))
+* remove commitizen script ([46fdf69](https://github.com/halospv3/hce.shared/commit/46fdf6929bffbf63a81a2c2bfc06fb0d92e905e3))
+
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+### 1.0.2 (2021-12-29)
+
+
+### Bug Fixes
+
+* **dev-deps:** import deps into index.js stub ([7fdb046](https://github.com/halospv3/hce.shared/commit/7fdb04646162dc205024c2b04af945e34d57b52c))
+* **dev-deps:** remove commitizen, cz-conventional-changelog ([b91155a](https://github.com/halospv3/hce.shared/commit/b91155a7d4ba81af1432c520f55e3cb09c13089c))

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2023 Noah Sherwin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+# HCE.Shared
+Infrastructure resources shared with other HaloSPV3 repositories.
+
+It is recommended to "install" this repo via [Node Package Manager](#npm)
+
+## NPM
+
+`npm install HaloSPV3/HCE.Shared --save-dev`
+
+See [package.json](package.json) and [node/](node/)
+
+## .NET
+
+See [dotnet/](dotnet/)
+
+GitHub Actions workflow examples are in [dotnet/.github/workflows/](dotnet/.github/workflows/).
+
+#### TODO:
+
+Eventually, I hope to make boilerplate workflows useable from via relative paths e.g.
+```yml
+jobs:
+    release:
+        steps:
+        - uses: actions/checkout@v3
+        - name: dotnet build/publish; copy release artifacts to './publish/'
+          uses: ./node_modules/@halospv3/hce.shared/dotnet/.github/workflows/dotnet-release.yml
+            with:
+                projects:
+                    - src/lib/lib.csproj
+                    - src/lib-sample/sample.csproj
+```
+
+### Directory.Build.props
+
+Add the file `Directory.Build.props` to your repository's root directory or solution directory if you haven't already.
+Then, add the following properties:
+```xml
+<Project>
+    <PropertyGroup>
+        <ProjectRootDir>$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), '.git/index'))</ProjectRootDir>
+        <HCESharedDir>$(ProjectRootDir)/node_modules/@halospv3/hce.shared/</HCESharedDir>
+    </PropertyGroup>
+</Project>
+```
+
+These may evaluate to the following:
+| Property | Evaluated Value|
+| - | - |
+|`ProjectRootDir` | `c:\Repos\HaloSPV3\HCE.Shared\` |
+|`HCESharedDir`| `c:\Repos\HaloSPV3\HCE.Shared\node_modules\@halospv3\hce.shared\` |
+
+<br/>
+
+If you want properties set only in a CI/CD environment (e.g. a GitHub workflow), add the following conditional property group to the props file:
+```xml, diff
+<Project>
+    <PropertyGroup>
+        ...
+    </PropertyGroup>
+
+    <PropertyGroup Condition=" '$(CI)' == 'true' ">
+        <Configuration>Release</Configuration>
+        <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
+   </PropertyGroup>
+</Project>
+```
+> Any properties added to this conditional property group will only be evaluated when `$(CI)` is defined either as a property or as an environment variable. This is most useful for properties such as `ContinuousIntegrationBuild`.
+
+### GitVersion
+
+By default, GitVersion will search only the "current directory" for `GitVersion.yml`. GitVersion has a lesser-known CLI argument, "Path" which allows users to specify the path to `GitVersion.yml`. The NuGet package `GitVersion.MSBuild` exposes this as the read-write property `$(GitVersion_Path)`.
+```xml
+<PropertyGroup>
+    <GitVersion_Path>../SiblingDir/GitVersion.yml</GitVersion_Path>
+</PropertyGroup>
+```

package/cjs/index-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 './index.cjs';
+
+export default data;

package/cjs/index.cjs

@@ -0,0 +1,37 @@
+'use strict';
+
+const node_fs = require('node:fs');
+const path = require('node:path');
+const node_url = require('node:url');
+const jsYaml = require('js-yaml');
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+const _interopDefault = e => e && e.__esModule ? e : {
+  default: e
+};
+const path__default = /*#__PURE__*/_interopDefault(path);
+const jsYaml__default = /*#__PURE__*/_interopDefault(jsYaml);
+function findStaticConfig() {
+  const glob = "static/.releaserc.yml";
+  let dirPath = node_url.fileURLToPath(path__default.default.dirname(typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : _documentCurrentScript && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href));
+  let combinedPath = path__default.default.join(dirPath, glob);
+  while (!node_fs.existsSync(combinedPath)) {
+    /* file:// + dirname behavior on Windows. 'root' is empty when 'file://' is present.
+     * file:///C:/Repos
+     * file:///C:
+     * file://
+     * .
+     */
+    // DEBUG.log(dirPath);
+    // DEBUG.log(combinedPath.href);
+    /** Throw if we reached root. */
+    if (path__default.default.dirname(dirPath) === "") throw new Error(`Failed to get full path for HCE.Shared's shared configuration. HCE.Shared recursively searched parent directories for '${glob}' starting from '${path__default.default.dirname(typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : _documentCurrentScript && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)}'`);
+    dirPath = path__default.default.dirname(dirPath);
+    combinedPath = path__default.default.join(dirPath, glob);
+  }
+  return combinedPath;
+}
+const options = jsYaml__default.default.load(node_fs.readFileSync(findStaticConfig(), {
+  encoding: "utf8"
+}));
+module.exports = options;
+//# sourceMappingURL=index.cjs.map

package/cjs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/index.ts"],"sourcesContent":null,"names":["fileURLToPath","path","existsSync","jsYaml","readFileSync"],"mappings":";;;;;;;;;;;;;AAIA,SAAS,gBAAgB,GAAG;AAC5B,EAAE,MAAM,IAAI,GAAG,uBAAuB,CAAC;AACvC,EAAE,IAAI,OAAO,GAAGA,sBAAa,CAACC,qBAAI,CAAC,OAAO,CAAC,8LAAe,CAAC,CAAC,CAAC;AAC7D,EAAE,IAAI,YAAY,GAAGA,qBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC9C,EAAE,OAAO,CAACC,kBAAU,CAAC,YAAY,CAAC,EAAE;AACpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,IAAID,qBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,IAAI,KAAK,CAAC,CAAC,uHAAuH,EAAE,IAAI,CAAC,iBAAiB,EAAEA,qBAAI,CAAC,OAAO,CAAC,8LAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1O,IAAI,OAAO,GAAGA,qBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACpC,IAAI,YAAY,GAAGA,qBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC5C,GAAG;AACH,EAAE,OAAO,YAAY,CAAC;AACtB,CAAC;AACI,MAAC,OAAO,GAAGE,uBAAM,CAAC,IAAI,CAACC,oBAAY,CAAC,gBAAgB,EAAE,EAAE;AAC7D,EAAE,QAAQ,EAAE,MAAM;AAClB,CAAC,CAAC;;;;"}

package/cjs/index.d.ts

@@ -0,0 +1,8 @@
+import type { Options } from "semantic-release";
+declare const options: Options;
+/**
+ * Runs HCE.Shared and returns a semantic-release "shareable configuration" object.
+ * @type {Options}.
+ */
+export default options;
+//# sourceMappingURL=index.d.ts.map

package/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AA6BhD,QAAA,MAAM,OAAO,SAAiF,CAAC;AAE/F;;;GAGG;AACH,eAAe,OAAO,CAAC"}

package/dotnet/.github/workflows/dotnet-release.yml

@@ -0,0 +1,89 @@
+name: dotnet-release
+
+# TODO
+# - Get AssemblyName, RuntimeIdentifier (RID) from Directory.Build.props, *.csproj
+# - Allow workflows to be driven by the project(s)
+# - support multiple ASSEMBLYNAME parameters for matrices
+
+on:
+  push:
+    branches: [ main, develop ]
+    paths-ignore:
+    - ".github/**/*.*"
+    - "**/*.md"
+    - "**/*.txt"
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    strategy: # TODO: Get variables from config file(s). May require a parent workflow to allow matrix runs.
+      matrix:
+        RID: [ "win-x86", "win-x64" ]
+        ASSEMBLYNAME: [ "SPV3.Loader", "SPV3.Installer", "HXE" ] #TODO: update
+    env:
+        PROJPATH: "./src/${{ matrix.ASSEMBLYNAME }}.csproj"
+
+    steps:
+    - name: Wait for build to succeed
+      uses: lewagon/wait-on-check-action@v1.3.1
+      with:
+        ref: ${{ github.ref }}
+        check-name: 'Build (${{matrix.RID}}, ${{matrix.ASSEMBLYNAME}})'
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        wait-interval: 10
+
+    ################
+    # SETUP
+    ################
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0 # Required by GitVersion
+        submodules: "recursive" # submodule fetch depth unknown
+    - uses: actions/setup-dotnet@v3
+    - name: Setup Node
+      uses: actions/setup-node@v3
+    - run: npm ci # Required by Semantic Release
+
+    ################
+    # BUILD
+    ################
+    - name: dotnet publish
+      run: |
+        dotnet publish ${{ matrix.PROJPATH }} -c Release --no-self-contained -p:ContinuousIntegrationBuild=true
+        src/.msb.noConfig.ps1
+
+    # required variables: TargetFramework, RuntimeIdentifier, GitVersion_FullSemVer
+    # TODO: replace with ZipPublishDir (see Bintoss/GroupBox.Avalonia)
+    - name: Compress Publish Artifacts
+      shell: pwsh
+      run: |
+        $archiveName = "$env:ASSEMBLYNAME.$env:RID.$env:GitVersion_FullSemVer.zip";
+        Compress-Archive -Path publish -DestinationPath $archiveName -CompressionLevel Optimal;
+
+    ################
+    # RELEASE
+    ################
+    # https://github.com/semantic-release/semantic-release
+    - name: Semantic Release
+      run: npx semantic-release
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Upload Artifact
+      uses: actions/upload-artifact@v3
+      with:
+        name: publish-artifacts
+        path: publish
+
+    - name: Publish to GitHub Packages
+      working-directory: publish
+      run: dotnet nuget push *.nupkg -s https://nuget.pkg.github.com/HaloSPV3/index.json -k ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Publish to nuget.org
+      working-directory: publish
+      run: dotnet nuget push *.nupkg -k ${{ secrets.NUGET_TOKEN }}

package/dotnet/.github/workflows/sample-dotnet-build.yml

@@ -0,0 +1,21 @@
+# This workflow demonstrates the minimal requirements for
+# building, publishing, and packing a CSharp Project with DotNet CLI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        submodules: 'recursive'
+        fetch-depth: 0
+
+    - uses: actions/setup-dotnet@v3
+
+    - run: dotnet build src/SPV3.csproj -c Release -p:ContinuousIntegrationBuild=true
+      # ContinuousIntegrationBuild comes from dotnet/sourcelink. Make sure Deterministic is also true!
+      # Alternatively, add a PropertyGroup with the condition " '$(CI)' != '' "

package/dotnet/GitVersion.yml

@@ -0,0 +1,5 @@
+# https://gitversion.net/docs/reference/configuration
+mode: MainLine
+major-version-bump-message: "^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)(\\([\\w\\s-]*\\))?(!:|:.*\\n\\n((.+\\n)+\\n)?BREAKING CHANGE:\\s.+)"
+minor-version-bump-message: "^(feat)(\\([\\w\\s-]*\\))?:"
+patch-version-bump-message: "^(build|chore|ci|docs|fix|perf|refactor|revert|style|test)(\\([\\w\\s-]*\\))?:"

package/dotnet/ZipPublishDir.targets

@@ -0,0 +1,17 @@
+<Project>
+  <!-- https://learn.microsoft.com/en-us/visualstudio/msbuild/zipdirectory-task?view=vs-2022 -->
+  <Target Name="ZipPublishDir" AfterTargets="Publish">
+    <PropertyGroup>
+      <RepoRoot>$([System.IO.Path]::GetDirectoryName($([MSBuild]::GetPathOfFileAbove('.gitignore', '$(MSBuildProjectDirectory)'))))</RepoRoot>
+      <Destination>$(RepoRoot)/publish/$(AssemblyName).$(Version)$(PART_RuntimeIdentifier)</Destination>
+      <Destination Condition="'$(RuntimeIdentifier)' != '' ">$(Destination).$(RuntimeIdentifier)</Destination>
+    </PropertyGroup>
+
+    <!-- https://www.nuget.org/packages/GitInfo -->
+
+    <ZipDirectory
+      SourceDirectory="$(PublishDir)"
+      DestinationFile="$(Destination).zip"
+      Overwrite="true" />
+  </Target>
+</Project>

package/package.json

@@ -0,0 +1,107 @@
+{
+  "name": "@halospv3/hce.shared-config",
+  "version": "1.1.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"
+  ],
+  "type": "module",
+  "homepage": "https://github.com/halospv3/hce.shared#readme",
+  "bugs": "https://github.com/halospv3/hce.shared/issues",
+  "license": "MIT",
+  "author": "Noah Sherwin",
+  "files": [
+    "!tests/",
+    "CHANGELOG.md",
+    "cjs/**/*",
+    "dotnet/",
+    "src/**/*",
+    "static/**/*"
+  ],
+  "main": "./cjs/index.cjs",
+  "infra": "polyrepo",
+  "repository": "github:halospv3/hce.shared",
+  "scripts": {
+    "build": "packemon build",
+    "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",
+    "prepare": "husky install",
+    "presemantic-release": "npm run pack && npm run check",
+    "semantic-release": "npx semantic-release",
+    "test": "node --loader tsx --no-warnings --test ./tests/index.test.mts",
+    "type": "tsc",
+    "validate": "packemon validate",
+    "watch": "packemon watch"
+  },
+  "dependencies": {
+    "@commitlint/cli": "^17.7.1",
+    "@commitlint/config-conventional": "^17.8.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^11.0.0",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^9.0.4",
+    "@semantic-release/npm": "^11.0.0",
+    "@semantic-release/release-notes-generator": "^12.0.0",
+    "conventional-changelog-conventionalcommits": "^7.0.2",
+    "husky": "^8.0.3",
+    "js-yaml": "^4.1.0",
+    "node-fetch": "^3.3.2",
+    "semantic-release": "^22.0.0"
+  },
+  "devDependencies": {
+    "@tsconfig/node-lts": "^18.12.5",
+    "@types/debug": "^4.1.8",
+    "@types/js-yaml": "^4.0.8",
+    "@types/node": "^20.5.1",
+    "@types/semantic-release": "^20.0.1",
+    "@typescript-eslint/eslint-plugin": "^6.7.5",
+    "@typescript-eslint/parser": "^6.7.5",
+    "ajv": "^8.12.0",
+    "ajv-draft-04": "^1.0.0",
+    "babel-cli": "^6.26.0",
+    "babel-plugin-cjs-esm-interop": "^3.0.2",
+    "eslint": "^8.51.0",
+    "eslint-config-moon": "^2.0.10",
+    "eslint-plugin-disable": "^2.0.3",
+    "node-fetch": "^3.3.2",
+    "packemon": "^3.2.1",
+    "prettier": "^3.0.3",
+    "prettier-config-moon": "^1.1.2",
+    "tsconfig-moon": "^1.3.0",
+    "tslib": "^2.6.2",
+    "tsx": "^3.13.0",
+    "typescript": "^5.2.2"
+  },
+  "engines": {
+    "node": ">=16.12.0"
+  },
+  "publishConfig": {
+    "tag": "latest"
+  },
+  "exports": {
+    ".": {
+      "node": {
+        "import": "./index-wrapper.mjs",
+        "types": "./index.d.ts",
+        "require": "./index.cjs"
+      }
+    }
+  },
+  "types": "./cjs/index.d.ts",
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "packemon": {
+    "format": "cjs",
+    "platform": "node"
+  }
+}

package/src/index.ts

@@ -0,0 +1,40 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import jsYaml from "js-yaml";
+import type { Options } from "semantic-release";
+
+function findStaticConfig(): string {
+  const glob = "static/.releaserc.yml";
+  let dirPath = fileURLToPath(path.dirname(import.meta.url));
+  let combinedPath = path.join(dirPath, glob);
+
+  while (!existsSync(combinedPath)) {
+    /* file:// + dirname behavior on Windows. 'root' is empty when 'file://' is present.
+     * file:///C:/Repos
+     * file:///C:
+     * file://
+     * .
+     */
+    // DEBUG.log(dirPath);
+    // DEBUG.log(combinedPath.href);
+    /** Throw if we reached root. */
+    if (path.dirname(dirPath) === "")
+      throw new Error(
+        `Failed to get full path for HCE.Shared's shared configuration. HCE.Shared recursively searched parent directories for '${glob}' starting from '${path.dirname(
+          import.meta.url,
+        )}'`,
+      );
+    dirPath = path.dirname(dirPath);
+    combinedPath = path.join(dirPath, glob);
+  }
+  return combinedPath;
+}
+
+const options = jsYaml.load(readFileSync(findStaticConfig(), { encoding: "utf8" })) as Options;
+
+/**
+ * Runs HCE.Shared and returns a semantic-release "shareable configuration" object.
+ * @type {Options}.
+ */
+export default options;

package/static/.releaserc.yml

@@ -0,0 +1,31 @@
+# footer contains links e.g. 3rd-party plugins, little-known features
+
+### global vars
+# https://semantic-release.gitbook.io/semantic-release/v/beta/usage/plugins#plugin-options-configuration
+preset: conventionalcommits
+
+###
+
+branches: # https://semantic-release.gitbook.io/semantic-release/v/beta/usage/configuration#branches
+  - main
+  - name: develop
+    channel: develop
+    prerelease: true
+
+plugins: # https://semantic-release.gitbook.io/semantic-release/v/beta/usage/configuration#plugins
+  - "@semantic-release/commit-analyzer"
+  - "@semantic-release/release-notes-generator"
+  - "@semantic-release/changelog"
+  - - "@semantic-release/git"
+    - assets:
+        - README.md
+        - CHANGELOG.md
+  - - "@semantic-release/github"
+    - assets:
+        - path: ./publish/*.zip
+## (OPTIONAL) export data
+# https://github.com/felipecrs/semantic-release-export-data#readme
+
+## (OPTIONAL) update Version strings
+# https://github.com/jpoehnelt/semantic-release-replace-plugin
+# https://github.com/droidsolutions/semantic-release-update-file