com.wallstop-studios.dxmessaging 2.1.4 → 2.1.5

package/.github/workflows/deploy-docs.yml

@@ -0,0 +1,118 @@
+# Deploy Documentation to GitHub Pages
+#
+# This workflow builds MkDocs documentation and deploys it to GitHub Pages.
+# It runs on pushes to master (for deployment) and on PRs (for validation only).
+#
+# Badge URL: https://github.com/wallstop/DxMessaging/actions/workflows/deploy-docs.yml/badge.svg
+# Pages URL: https://wallstop.github.io/DxMessaging/
+
+name: Deploy Documentation
+
+on:
+  pull_request:
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - "requirements-docs.txt"
+      - ".github/workflows/deploy-docs.yml"
+  push:
+    branches:
+      - main
+      - master
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - "requirements-docs.txt"
+      - ".github/workflows/deploy-docs.yml"
+  workflow_dispatch:
+
+# Prevent concurrent deployments to avoid conflicts
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    name: Build Documentation
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0 # Full history for git-revision-date-localized plugin
+          persist-credentials: false
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+          cache: "pip"
+          cache-dependency-path: "requirements-docs.txt"
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y --no-install-recommends \
+            libcairo2-dev \
+            libfreetype6-dev \
+            libffi-dev \
+            libjpeg-dev \
+            libpng-dev \
+            libz-dev
+
+      - name: Install Python dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements-docs.txt
+
+      - name: Validate mkdocs.yml syntax
+        run: |
+          python -c "from mkdocs.config import load_config; load_config('mkdocs.yml')"
+          echo "✅ mkdocs.yml syntax validation passed"
+
+      - name: Build documentation
+        run: mkdocs build --strict --site-dir _site
+
+      - name: Validate build output
+        run: |
+          if [ ! -d "_site" ]; then
+            echo "::error::Build failed - _site directory not found"
+            exit 1
+          fi
+          if [ ! -f "_site/index.html" ]; then
+            echo "::error::Build failed - index.html not found"
+            exit 1
+          fi
+          PAGE_COUNT=$(find _site -name '*.html' | wc -l)
+          echo "✅ Build validation passed"
+          echo "📄 Generated $PAGE_COUNT HTML pages"
+          echo "📁 Site contents:"
+          ls -la _site/
+          if [ "$PAGE_COUNT" -lt 5 ]; then
+            echo "::warning::Low page count ($PAGE_COUNT) - verify all docs are included"
+          fi
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: _site
+
+  deploy:
+    name: Deploy to GitHub Pages
+    if: github.event_name != 'pull_request'
+    needs: build
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

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

@@ -16,7 +16,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Setup .NET
         uses: actions/setup-dotnet@v5
@@ -47,7 +47,7 @@ jobs:
           cat artifacts/coverage/Summary.txt
 
       - name: Upload coverage report
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: generator-coverage
           path: artifacts/coverage

package/.github/workflows/format-on-demand.yml

@@ -53,14 +53,14 @@ jobs:
 
       - name: Checkout PR branch (same-repo)
         if: ${{ steps.meta.outputs.same_repo == 'true' }}
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           ref: ${{ steps.meta.outputs.head_ref }}
           fetch-depth: 0
 
       - name: Checkout PR fork head
         if: ${{ steps.meta.outputs.same_repo != 'true' }}
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           repository: ${{ steps.meta.outputs.head_repo }}
           ref: ${{ steps.meta.outputs.head_ref }}
@@ -82,25 +82,28 @@ jobs:
 
       - name: Apply Prettier fixes
         run: |
-          npx --yes prettier@3.3.3 --write "**/*.{md,markdown}"
-          npx --yes prettier@3.3.3 --write "**/*.{json,asmdef,asmref}"
-          npx --yes prettier@3.3.3 --write "**/*.{yml,yaml}"
+          npx --yes prettier@3.8.1 --write "**/*.{md,markdown}"
+          npx --yes prettier@3.8.1 --write "**/*.{json,asmdef,asmref}"
+          npx --yes prettier@3.8.1 --write "**/*.{yml,yaml}"
 
       - name: Apply markdownlint fixes
         run: |
-          npx --yes markdownlint-cli@0.40.0 "**/*.md" "**/*.markdown" --config .markdownlint.json --ignore-path .markdownlintignore --fix
+          npx --yes markdownlint-cli2@0.20.0 "**/*.md" "**/*.markdown" --fix
 
       - name: Apply CSharpier formatting
         run: dotnet tool run csharpier format
 
+      - name: Renormalize line endings
+        run: git add --renormalize -- '*.cs' '**/*.cs' '*.md' '**/*.md' '*.markdown' '**/*.markdown' '*.json' '**/*.json' '*.asmdef' '**/*.asmdef' '*.asmref' '**/*.asmref'
+
       - name: Detect changes
         id: changes
         shell: bash
         run: |
           if git diff --quiet; then
-            echo "has_changes=false" >> $GITHUB_OUTPUT
+            echo "has_changes=false" >> "$GITHUB_OUTPUT"
           else
-            echo "has_changes=true" >> $GITHUB_OUTPUT
+            echo "has_changes=true" >> "$GITHUB_OUTPUT"
           fi
 
       - name: Commit changes to PR branch (same-repo)
@@ -109,6 +112,7 @@ jobs:
         with:
           commit_message: "chore(format): apply requested formatting"
           branch: ${{ steps.meta.outputs.head_ref }}
+          add_options: --renormalize
           file_pattern: |
             **/*.cs
             **/*.md
@@ -130,7 +134,8 @@ jobs:
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
           git checkout -B "$BRANCH"
           # Stage only supported text files; avoid workflows to prevent permission issues
-          git add '**/*.cs' '**/*.md' '**/*.markdown' '**/*.json' '**/*.asmdef' '**/*.asmref'
+          # Use --renormalize to ensure LF line endings in git index per .gitattributes
+          git add --renormalize -- '*.cs' '**/*.cs' '*.md' '**/*.md' '*.markdown' '**/*.markdown' '*.json' '**/*.json' '*.asmdef' '**/*.asmdef' '*.asmref' '**/*.asmref'
           git commit -m "chore(format): apply requested formatting for PR #${{ steps.meta.outputs.pr }}"
           git remote add upstream "https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git"
           git fetch upstream
@@ -199,14 +204,14 @@ jobs:
 
       - name: Checkout PR branch (same-repo)
         if: ${{ steps.meta.outputs.same_repo == 'true' }}
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           ref: ${{ steps.meta.outputs.head_ref }}
           fetch-depth: 0
 
       - name: Checkout PR fork head
         if: ${{ steps.meta.outputs.same_repo != 'true' }}
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           repository: ${{ steps.meta.outputs.head_repo }}
           ref: ${{ steps.meta.outputs.head_ref }}
@@ -228,25 +233,28 @@ jobs:
 
       - name: Apply Prettier fixes
         run: |
-          npx --yes prettier@3.3.3 --write "**/*.{md,markdown}"
-          npx --yes prettier@3.3.3 --write "**/*.{json,asmdef,asmref}"
-          npx --yes prettier@3.3.3 --write "**/*.{yml,yaml}"
+          npx --yes prettier@3.8.1 --write "**/*.{md,markdown}"
+          npx --yes prettier@3.8.1 --write "**/*.{json,asmdef,asmref}"
+          npx --yes prettier@3.8.1 --write "**/*.{yml,yaml}"
 
       - name: Apply markdownlint fixes
         run: |
-          npx --yes markdownlint-cli@0.40.0 "**/*.md" "**/*.markdown" --config .markdownlint.json --ignore-path .markdownlintignore --fix
+          npx --yes markdownlint-cli2@0.20.0 "**/*.md" "**/*.markdown" --fix
 
       - name: Apply CSharpier formatting
         run: dotnet tool run csharpier format
 
+      - name: Renormalize line endings
+        run: git add --renormalize -- '*.cs' '**/*.cs' '*.md' '**/*.md' '*.markdown' '**/*.markdown' '*.json' '**/*.json' '*.asmdef' '**/*.asmdef' '*.asmref' '**/*.asmref'
+
       - name: Detect changes
         id: changes
         shell: bash
         run: |
           if git diff --quiet; then
-            echo "has_changes=false" >> $GITHUB_OUTPUT
+            echo "has_changes=false" >> "$GITHUB_OUTPUT"
           else
-            echo "has_changes=true" >> $GITHUB_OUTPUT
+            echo "has_changes=true" >> "$GITHUB_OUTPUT"
           fi
 
       - name: Commit changes to PR branch (same-repo)
@@ -255,6 +263,7 @@ jobs:
         with:
           commit_message: "chore(format): apply requested formatting"
           branch: ${{ steps.meta.outputs.head_ref }}
+          add_options: --renormalize
           file_pattern: |
             **/*.cs
             **/*.md
@@ -276,7 +285,8 @@ jobs:
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
           git checkout -B "$BRANCH"
           # Stage only supported text files; avoid workflows to prevent permission issues
-          git add '**/*.cs' '**/*.md' '**/*.markdown' '**/*.json' '**/*.asmdef' '**/*.asmref'
+          # Use --renormalize to ensure LF line endings in git index per .gitattributes
+          git add --renormalize -- '*.cs' '**/*.cs' '*.md' '**/*.md' '*.markdown' '**/*.markdown' '*.json' '**/*.json' '*.asmdef' '**/*.asmdef' '*.asmref' '**/*.asmref'
           git commit -m "chore(format): apply requested formatting for PR #${{ steps.meta.outputs.pr }}"
           git remote add upstream "https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git"
           git fetch upstream

package/.github/workflows/json-format-check.yml

@@ -5,6 +5,7 @@ on:
   push:
     branches:
       - main
+      - master
   workflow_dispatch:
 
 jobs:
@@ -13,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Setup Node
         uses: actions/setup-node@v6

package/.github/workflows/lint-doc-links.yml

@@ -4,6 +4,7 @@ on:
   push:
     branches:
       - main
+      - master
   pull_request:
 
 jobs:
@@ -11,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Run Markdown link linter
         shell: pwsh

package/.github/workflows/markdown-json.yml

@@ -4,6 +4,7 @@ on:
   push:
     branches:
       - main
+      - master
   pull_request:
 
 permissions:
@@ -14,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Setup Node.js
         uses: actions/setup-node@v6

package/.github/workflows/markdown-link-text-check.yml

@@ -4,6 +4,7 @@ on:
   pull_request:
   push:
     branches:
+      - main
       - master
   workflow_dispatch:
 
@@ -12,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Validate link text for markdown-to-markdown links
         run: python .github/scripts/check_markdown_links.py .

package/.github/workflows/markdown-link-validity.yml

@@ -4,6 +4,7 @@ on:
   pull_request:
   push:
     branches:
+      - main
       - master
   workflow_dispatch:
 
@@ -12,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Run lychee link checker (repo-wide)
         uses: lycheeverse/lychee-action@v2

package/.github/workflows/markdownlint.yml

@@ -2,15 +2,39 @@ name: Markdown Lint
 
 on:
   pull_request:
+    paths:
+      - "**/*.md"
+      - "**/*.markdown"
+      - ".markdownlint.json"
+      - ".markdownlint-cli2.jsonc"
+      - "package.json"
+  push:
+    branches:
+      - main
+      - master
+    paths:
+      - "**/*.md"
+      - "**/*.markdown"
+      - ".markdownlint.json"
+      - ".markdownlint-cli2.jsonc"
+      - "package.json"
   workflow_dispatch:
 
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   markdownlint:
     name: Lint repository Markdown
     runs-on: ubuntu-latest
+    timeout-minutes: 5
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Setup Node.js
         uses: actions/setup-node@v6

package/.github/workflows/prettier-autofix.yml

@@ -5,6 +5,10 @@ on:
   pull_request_target:
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 permissions:
   contents: write
   pull-requests: write
@@ -14,9 +18,10 @@ jobs:
     name: Format and propose changes
     if: ${{ github.event_name != 'pull_request_target' }}
     runs-on: ubuntu-latest
+    timeout-minutes: 10
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
@@ -44,7 +49,11 @@ jobs:
 
       - name: Markdownlint (auto-fix)
         if: ${{ github.event.pull_request.user.login == 'dependabot[bot]' }}
-        run: npx --yes markdownlint-cli@0.40.0 "**/*.md" "**/*.markdown" --config .markdownlint.json --ignore-path .markdownlintignore --fix
+        run: npx --yes markdownlint-cli2@0.20.0 "**/*.md" "**/*.markdown" --fix
+
+      - name: Renormalize line endings
+        if: ${{ github.event.pull_request.user.login == 'dependabot[bot]' }}
+        run: git add --renormalize -- '*.md' '**/*.md' '*.markdown' '**/*.markdown' '*.json' '**/*.json' '*.asmdef' '**/*.asmdef' '*.asmref' '**/*.asmref' '*.yml' '**/*.yml' '*.yaml' '**/*.yaml'
 
       - name: Commit formatting changes to PR branch (Dependabot only)
         if: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository && github.event.pull_request.user.login == 'dependabot[bot]' }}
@@ -52,6 +61,7 @@ jobs:
         with:
           commit_message: "chore(format): apply Prettier/markdownlint fixes"
           branch: ${{ github.head_ref }}
+          add_options: --renormalize
           file_pattern: |
             **/*.md
             **/*.markdown
@@ -81,9 +91,10 @@ jobs:
     name: Fork PR bot formatting PR (Dependabot only)
     if: ${{ github.event_name == 'pull_request_target' && github.event.pull_request.head.repo.full_name != github.repository && github.event.pull_request.user.login == 'dependabot[bot]' }}
     runs-on: ubuntu-latest
+    timeout-minutes: 10
     steps:
       - name: Checkout fork PR HEAD
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           repository: ${{ github.event.pull_request.head.repo.full_name }}
           ref: ${{ github.event.pull_request.head.ref }}
@@ -112,16 +123,19 @@ jobs:
           npm run format:yaml
 
       - name: Markdownlint (auto-fix)
-        run: npx --yes markdownlint-cli@0.40.0 "**/*.md" "**/*.markdown" --config .markdownlint.json --ignore-path .markdownlintignore --fix
+        run: npx --yes markdownlint-cli2@0.20.0 "**/*.md" "**/*.markdown" --fix
+
+      - name: Renormalize line endings
+        run: git add --renormalize -- '*.md' '**/*.md' '*.markdown' '**/*.markdown' '*.json' '**/*.json' '*.asmdef' '**/*.asmdef' '*.asmref' '**/*.asmref' '*.yml' '**/*.yml' '*.yaml' '**/*.yaml'
 
       - name: Detect changes
         id: changes
         shell: bash
         run: |
           if git diff --quiet; then
-            echo "has_changes=false" >> $GITHUB_OUTPUT
+            echo "has_changes=false" >> "$GITHUB_OUTPUT"
           else
-            echo "has_changes=true" >> $GITHUB_OUTPUT
+            echo "has_changes=true" >> "$GITHUB_OUTPUT"
           fi
 
       - name: Create bot branch and push to base repo
@@ -137,12 +151,13 @@ jobs:
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
           git checkout -B "$BRANCH"
           # Stage only files we format; avoid workflows to prevent permission issues
-          git add '**/*.md' '**/*.markdown' '**/*.json' '**/*.asmdef' '**/*.asmref' '**/*.yml' '**/*.yaml'
+          # Use --renormalize to ensure LF line endings in git index per .gitattributes
+          git add --renormalize -- '*.md' '**/*.md' '*.markdown' '**/*.markdown' '*.json' '**/*.json' '*.asmdef' '**/*.asmdef' '*.asmref' '**/*.asmref' '*.yml' '**/*.yml' '*.yaml' '**/*.yaml'
           git commit -m "chore(format): apply Prettier/markdownlint fixes for PR #${{ github.event.pull_request.number }}"
           git remote add upstream "https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git"
           git fetch upstream
           git push upstream "$BRANCH" --force
-          echo "branch=$BRANCH" >> $GITHUB_OUTPUT
+          echo "branch=$BRANCH" >> "$GITHUB_OUTPUT"
 
       - name: Open or update formatting PR in base repo
         if: steps.changes.outputs.has_changes == 'true'

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

@@ -0,0 +1,135 @@
+name: Release Drafter
+
+on:
+  push:
+    branches:
+      - main
+      - master
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+concurrency:
+  group: release-drafter
+  cancel-in-progress: false
+
+jobs:
+  update-release-draft:
+    if: github.repository == 'wallstop/DxMessaging'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Extract version from package.json
+        id: version
+        run: |
+          if [ ! -f package.json ]; then
+            echo "Error: package.json not found"
+            exit 1
+          fi
+          VERSION=$(jq -r '.version // empty' package.json)
+          if [ -z "$VERSION" ]; then
+            echo "Error: version field not found in package.json"
+            exit 1
+          fi
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "Extracted version: $VERSION"
+
+      - name: Extract changelog for version
+        id: changelog
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+          echo "Looking for version: $VERSION"
+
+          if [ ! -f CHANGELOG.md ]; then
+            echo "Warning: CHANGELOG.md not found"
+            echo "No changelog file found." > /tmp/changelog_section.md
+            echo "changelog_file=/tmp/changelog_section.md" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          # Extract the changelog section for this version
+          # Matches from "## [VERSION]" until the next "## [" or end of file
+          CHANGELOG_CONTENT=$(awk -v ver="$VERSION" '
+            BEGIN { found=0; content="" }
+            /^## \[/ {
+              if (found) exit
+              if (index($0, "[" ver "]") > 0) {
+                found=1
+                next
+              }
+            }
+            found { content = content $0 "\n" }
+            END { print content }
+          ' CHANGELOG.md)
+
+          # Handle empty changelog
+          if [ -z "$CHANGELOG_CONTENT" ] || [ "$CHANGELOG_CONTENT" = $'\n' ]; then
+            CHANGELOG_CONTENT="No changelog entry found for version $VERSION"
+          fi
+
+          # Write to file for multi-line handling
+          echo "$CHANGELOG_CONTENT" > /tmp/changelog_section.md
+          echo "changelog_file=/tmp/changelog_section.md" >> "$GITHUB_OUTPUT"
+
+      - name: Run Release Drafter
+        uses: release-drafter/release-drafter@v6
+        id: release_drafter
+        with:
+          config-name: release-drafter.yml
+          version: ${{ steps.version.outputs.version }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Update release body with changelog
+        uses: actions/github-script@v7
+        env:
+          RELEASE_ID: ${{ steps.release_drafter.outputs.id }}
+          VERSION: ${{ steps.version.outputs.version }}
+          DRAFTER_BODY: ${{ steps.release_drafter.outputs.body }}
+          CHANGELOG_FILE: ${{ steps.changelog.outputs.changelog_file }}
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const fs = require('fs');
+
+            const releaseId = parseInt(process.env.RELEASE_ID, 10);
+            if (!Number.isInteger(releaseId) || releaseId <= 0) {
+              throw new Error('Invalid releaseId: ' + process.env.RELEASE_ID + '. Expected a positive integer.');
+            }
+            const version = process.env.VERSION;
+            const drafterBody = process.env.DRAFTER_BODY || '';
+            const changelogFile = process.env.CHANGELOG_FILE;
+
+            let changelogContent = '';
+            try {
+              changelogContent = fs.readFileSync(changelogFile, 'utf8').trim();
+            } catch (err) {
+              console.log('Warning: Could not read changelog file:', err.message);
+              changelogContent = 'No changelog content available.';
+            }
+
+            const bodyParts = [
+              '## Changelog',
+              '',
+              changelogContent,
+              '',
+              '---',
+              '',
+              drafterBody
+            ];
+            const body = bodyParts.join('\n');
+
+            await github.rest.repos.updateRelease({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              release_id: releaseId,
+              body: body,
+              name: version,
+              tag_name: version
+            });
+
+            console.log('Updated release draft for version ' + version);