com.wallstop-studios.dxmessaging 2.1.7 → 2.1.8

package/.github/scripts/validate_markdown_links.py

@@ -1,194 +0,0 @@
-#!/usr/bin/env python3
-import os
-import re
-import sys
-import urllib.parse
-from typing import Dict, List, Set, Tuple
-
-
-EXCLUDE_DIRS = {".git", "node_modules", ".vs"}
-
-
-LINK_RE = re.compile(r"(?<!\!)\[(?P<text>[^\]]+)\]\((?P<target>[^)\s]+)(?:\s+\"[^\"]*\")?\)")
-
-
-def unescape_uri(s: str) -> str:
-    try:
-        return urllib.parse.unquote(s)
-    except Exception:
-        return s
-
-
-def normalize_heading_to_id(text: str) -> str:
-    """
-    Approximate GitHub-style anchor slug generation (GFM):
-    - Lowercase
-    - Strip Markdown formatting and code ticks
-    - Remove most punctuation
-    - Replace whitespace with hyphens
-    - Collapse multiple hyphens
-    - Trim leading/trailing hyphens
-    """
-    if not text:
-        return ""
-    t = text
-    # Remove inline code ticks
-    t = t.replace("`", "")
-    # Remove Markdown emphasis markers
-    t = t.replace("*", "").replace("_", "").replace("~", "")
-    # Remove link/image markup inside headings e.g. [text](url)
-    t = re.sub(r"!?\[[^\]]*\]\([^)]*\)", "", t)
-    # Remove HTML tags
-    t = re.sub(r"<[^>]+>", "", t)
-    # Lowercase
-    t = t.lower()
-    # Replace whitespace with hyphens
-    t = re.sub(r"\s+", "-", t)
-    # Remove punctuation except hyphens and alphanumerics
-    t = re.sub(r"[^a-z0-9-]", "", t)
-    # Collapse multiple hyphens
-    t = re.sub(r"-+", "-", t)
-    # Trim hyphens
-    t = t.strip("-")
-    return t
-
-
-def collect_heading_ids(file_path: str) -> Set[str]:
-    """
-    Build the set of anchor IDs generated by headings within a markdown file.
-    Handles ATX (# ...) and Setext (underlined) headings. Accounts for duplicate
-    slugs by adding -1, -2, ... suffixes (GitHub behavior).
-    """
-    try:
-        with open(file_path, "r", encoding="utf-8") as f:
-            lines = f.readlines()
-    except Exception:
-        return set()
-
-    ids: Set[str] = set()
-    slug_counts: Dict[str, int] = {}
-
-    def add_slug_from_text(text: str):
-        slug = normalize_heading_to_id(text)
-        if slug == "":
-            return
-        count = slug_counts.get(slug, 0)
-        if count == 0:
-            final = slug
-        else:
-            final = f"{slug}-{count}"
-        slug_counts[slug] = count + 1
-        ids.add(final)
-
-    # ATX headings
-    atx_re = re.compile(r"^\s{0,3}#{1,6}\s+(.*)$")
-
-    # Walk lines, handle setext headings by looking ahead
-    i = 0
-    while i < len(lines):
-        line = lines[i].rstrip("\n")
-        m = atx_re.match(line)
-        if m:
-            add_slug_from_text(m.group(1).strip())
-            i += 1
-            continue
-        # Setext H1/H2
-        if i + 1 < len(lines):
-            underline = lines[i + 1].rstrip("\n")
-            if re.match(r"^\s{0,3}=+\s*$", underline) or re.match(r"^\s{0,3}-+\s*$", underline):
-                add_slug_from_text(line.strip())
-                i += 2
-                continue
-        i += 1
-
-    return ids
-
-
-def is_external(target: str) -> bool:
-    return bool(re.match(r"^(https?://|mailto:|tel:|data:)", target))
-
-
-def resolve_path(base_dir: str, target_path: str) -> str:
-    return os.path.normpath(os.path.join(base_dir, target_path))
-
-
-def check_internal_link(src_file: str, target_raw: str) -> Tuple[bool, str]:
-    # Separate fragment
-    if target_raw.startswith("#"):
-        # Anchor within same file
-        frag = target_raw[1:]
-        anchor = unescape_uri(frag)
-        anchor = anchor.strip()
-        anchor = anchor.lower()
-        ids = collect_heading_ids(src_file)
-        if anchor in ids:
-            return True, ""
-        return False, f"dangling anchor '#{frag}' (no matching heading)"
-
-    # Split off query/fragment
-    core = re.sub(r"[?#].*$", "", target_raw)
-    core = unescape_uri(core)
-    base_dir = os.path.dirname(src_file)
-    target_fs = resolve_path(base_dir, core)
-    if not os.path.exists(target_fs):
-        return False, f"target file not found: {core}"
-
-    # Fragment check if present
-    m = re.search(r"#(.+)$", target_raw)
-    if m:
-        frag = m.group(1)
-        anchor = unescape_uri(frag).strip().lower()
-        ids = collect_heading_ids(target_fs)
-        if anchor not in ids:
-            return False, f"dangling anchor '#{frag}' in {core}"
-
-    return True, ""
-
-
-def main(paths: List[str]) -> int:
-    issues = 0
-
-    def iter_markdown_files() -> List[str]:
-        files: List[str] = []
-        for p in paths:
-            if os.path.isdir(p):
-                for dirpath, dirnames, filenames in os.walk(p):
-                    dirnames[:] = [d for d in dirnames if d not in EXCLUDE_DIRS]
-                    for filename in filenames:
-                        if filename.lower().endswith(".md"):
-                            files.append(os.path.join(dirpath, filename))
-            else:
-                if p.lower().endswith(".md") and os.path.exists(p):
-                    files.append(p)
-        return files
-
-    files = iter_markdown_files()
-    for path in files:
-        try:
-            with open(path, "r", encoding="utf-8") as f:
-                lines = f.readlines()
-        except Exception:
-            continue
-        for idx, line in enumerate(lines, start=1):
-            for m in LINK_RE.finditer(line):
-                target = m.group("target").strip()
-                # Skip images, external links, anchors we can't resolve externally here
-                if is_external(target):
-                    continue
-                ok, reason = check_internal_link(path, target)
-                if not ok:
-                    issues += 1
-                    print(f"{path}:{idx}: Broken link '{target}': {reason}")
-
-    if issues:
-        print(f"Found {issues} broken internal markdown link(s).", file=sys.stderr)
-        print("Fix the paths or anchors so links resolve.", file=sys.stderr)
-        return 1
-    return 0
-
-
-if __name__ == "__main__":
-    args = sys.argv[1:]
-    if not args:
-        args = ["."]
-    sys.exit(main(args))

package/.github/workflows/actionlint.yml

@@ -1,47 +0,0 @@
-name: Actionlint
-
-on:
-  pull_request:
-    paths:
-      - ".github/workflows/**"
-      - "scripts/validate-workflows.js"
-  push:
-    branches:
-      - main
-      - master
-    paths:
-      - ".github/workflows/**"
-      - "scripts/validate-workflows.js"
-  workflow_dispatch:
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-permissions:
-  contents: read
-
-jobs:
-  actionlint:
-    name: Lint GitHub Actions workflows
-    runs-on: ubuntu-latest
-    timeout-minutes: 5
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v6
-        with:
-          persist-credentials: false
-
-      - name: Install shellcheck
-        run: sudo apt-get update && sudo apt-get install -y --no-install-recommends shellcheck
-
-      - name: Run actionlint
-        uses: rhysd/actionlint@v1.7.10
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v6
-        with:
-          node-version: "20"
-
-      - name: Validate workflow patterns
-        run: node scripts/validate-workflows.js

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

@@ -1,192 +0,0 @@
-name: CSharpier Auto Format
-
-on:
-  pull_request:
-    paths:
-      - "**/*.cs"
-      - ".config/dotnet-tools.json"
-  pull_request_target:
-    paths:
-      - "**/*.cs"
-      - ".config/dotnet-tools.json"
-  workflow_dispatch:
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-permissions:
-  contents: write
-  pull-requests: write
-
-jobs:
-  format:
-    name: Format and propose changes
-    if: ${{ github.event_name != 'pull_request_target' }}
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-
-      - name: Setup .NET
-        uses: actions/setup-dotnet@v5
-        with:
-          dotnet-version: "8.0.x"
-
-      - name: Restore .NET tools
-        run: dotnet tool restore
-
-      - name: Run CSharpier (format repository)
-        if: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository && github.event.pull_request.user.login == 'dependabot[bot]' }}
-        run: dotnet tool run csharpier format
-
-      - name: Renormalize line endings
-        if: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository && github.event.pull_request.user.login == 'dependabot[bot]' }}
-        shell: bash
-        run: |
-          # Renormalize each extension separately to avoid "pathspec did not match" failures
-          # when certain file types don't exist or aren't accessible in this checkout context
-          for ext in cs; do
-            if git ls-files "*.$ext" "**/*.$ext" | grep -q .; then
-              git add --renormalize -- "*.$ext" "**/*.$ext"
-            fi
-          done
-
-      - 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]' }}
-        uses: stefanzweifel/git-auto-commit-action@v7
-        with:
-          commit_message: "chore(format): apply CSharpier formatting"
-          branch: ${{ github.head_ref }}
-          add_options: --renormalize
-          file_pattern: |
-            **/*.cs
-
-      - name: Verify formatting (CI gate)
-        run: dotnet tool run csharpier check .
-
-  format_fork:
-    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
-    steps:
-      - name: Checkout fork PR HEAD
-        uses: actions/checkout@v6
-        with:
-          repository: ${{ github.event.pull_request.head.repo.full_name }}
-          ref: ${{ github.event.pull_request.head.ref }}
-          persist-credentials: false
-          fetch-depth: 0
-
-      - name: Setup .NET
-        uses: actions/setup-dotnet@v5
-        with:
-          dotnet-version: "8.0.x"
-
-      - name: Install CSharpier (pinned)
-        run: dotnet tool install -g csharpier --version 1.1.2
-
-      - name: Run CSharpier (format repository)
-        run: ~/.dotnet/tools/csharpier .
-
-      - name: Renormalize line endings
-        shell: bash
-        run: |
-          # Renormalize each extension separately to avoid "pathspec did not match" failures
-          # when certain file types don't exist or aren't accessible in this checkout context
-          for ext in cs; do
-            if git ls-files "*.$ext" "**/*.$ext" | grep -q .; then
-              git add --renormalize -- "*.$ext" "**/*.$ext"
-            fi
-          done
-
-      - name: Detect changes
-        id: changes
-        shell: bash
-        run: |
-          if git diff --quiet; then
-            echo "has_changes=false" >> "$GITHUB_OUTPUT"
-          else
-            echo "has_changes=true" >> "$GITHUB_OUTPUT"
-          fi
-
-      - name: Create bot branch and push to base repo
-        if: steps.changes.outputs.has_changes == 'true'
-        shell: bash
-        env:
-          GH_REPO: ${{ github.repository }}
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          set -euo pipefail
-          BRANCH="bot/csharpier/pr-${{ github.event.pull_request.number }}"
-          git config user.name "github-actions[bot]"
-          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          git checkout -B "$BRANCH"
-          # Only stage C# files to avoid touching workflow YAML (requires special permissions)
-          # Use --renormalize to ensure LF line endings in git index per .gitattributes
-          # Renormalize each extension separately to avoid "pathspec did not match" failures
-          for ext in cs; do
-            if git ls-files "*.$ext" "**/*.$ext" | grep -q .; then
-              git add --renormalize -- "*.$ext" "**/*.$ext"
-            fi
-          done
-          git commit -m "chore(format): apply CSharpier formatting 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"
-
-      - name: Open or update formatting PR in base repo
-        if: steps.changes.outputs.has_changes == 'true'
-        uses: actions/github-script@v8
-        with:
-          script: |
-            const prNumber = context.payload.pull_request.number;
-            const baseRef = context.payload.pull_request.base.ref;
-            const headBranch = `bot/csharpier/pr-${prNumber}`;
-            const {owner, repo} = context.repo;
-            const title = `chore(format): Apply CSharpier to PR #${prNumber}`;
-            const body = [
-              `This automated PR applies CSharpier formatting to the changes from PR #${prNumber}.`,
-              '',
-              `- Source PR (fork): #${prNumber}`,
-              `- Target branch: ${baseRef}`,
-              '',
-              'If this PR is merged, it will include the contributor\'s changes plus required formatting.',
-              'You can then close the original PR or ask the author to rebase.',
-            ].join('\n');
-
-            // Check if a PR from this branch already exists
-            const existing = await github.rest.pulls.list({ owner, repo, state: 'open', head: `${owner}:${headBranch}` });
-            if (existing.data.length === 0) {
-              await github.rest.pulls.create({ owner, repo, head: headBranch, base: baseRef, title, body });
-            }
-
-      - name: Comment link on original PR
-        if: steps.changes.outputs.has_changes == 'true'
-        uses: actions/github-script@v8
-        with:
-          script: |
-            const prNumber = context.payload.pull_request.number;
-            const {owner, repo} = context.repo;
-            const headBranch = `bot/csharpier/pr-${prNumber}`;
-            // Find the formatting PR we just created or updated
-            const resp = await github.rest.pulls.list({ owner, repo, state: 'open', head: `${owner}:${headBranch}` });
-            if (resp.data.length > 0) {
-              const fmtPr = resp.data[0];
-              const body = `A formatting PR has been opened: #${fmtPr.number} (applies CSharpier to this PR).`;
-              // Avoid duplicate comments by checking recent comments
-              const comments = await github.rest.issues.listComments({ owner, repo, issue_number: prNumber, per_page: 50 });
-              const already = comments.data.some(
-                (c) =>
-                  c.body &&
-                  c.body.includes(`#${fmtPr.number}`) &&
-                  c.user &&
-                  c.user.login === 'github-actions[bot]'
-              );
-              if (!already) {
-                await github.rest.issues.createComment({ owner, repo, issue_number: prNumber, body });
-              }
-            }

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

@@ -1,118 +0,0 @@
-# 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

@@ -1,85 +0,0 @@
-name: dotnet-tests
-
-on:
-  push:
-    branches:
-      - master
-      - main
-      - develop
-    paths:
-      - "**/*.cs"
-      - "**/*.csproj"
-      - "**/*.sln"
-      - "SourceGenerators/**"
-      - ".config/dotnet-tools.json"
-  pull_request:
-    branches:
-      - "*"
-    paths:
-      - "**/*.cs"
-      - "**/*.csproj"
-      - "**/*.sln"
-      - "SourceGenerators/**"
-      - ".config/dotnet-tools.json"
-  workflow_dispatch:
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v6
-
-      - name: Setup .NET
-        uses: actions/setup-dotnet@v5
-        with:
-          dotnet-version: "9.0.x"
-
-      - name: Install reportgenerator tool
-        run: |
-          dotnet tool install --global dotnet-reportgenerator-globaltool
-          echo "$HOME/.dotnet/tools" >> "$GITHUB_PATH"
-
-      - name: Restore
-        run: dotnet restore SourceGenerators/WallstopStudios.DxMessaging.SourceGenerators.Tests/WallstopStudios.DxMessaging.SourceGenerators.Tests.csproj
-
-      - name: Run generator diagnostics tests
-        run: >
-          dotnet test SourceGenerators/WallstopStudios.DxMessaging.SourceGenerators.Tests/WallstopStudios.DxMessaging.SourceGenerators.Tests.csproj
-          --configuration Release
-          --collect:"XPlat Code Coverage"
-
-      - name: Generate coverage summary
-        run: |
-          mkdir -p artifacts/coverage
-          reportgenerator \
-            -reports:".artifacts/SourceGenerators.Tests/TestResults/**/coverage.cobertura.xml" \
-            -targetdir:"artifacts/coverage" \
-            -reporttypes:"TextSummary;HtmlSummary;Cobertura"
-          cat artifacts/coverage/Summary.txt
-
-      - name: Upload coverage report
-        uses: actions/upload-artifact@v6
-        with:
-          name: generator-coverage
-          path: artifacts/coverage
-
-      - name: Check for TODO/FIXME markers
-        shell: bash
-        run: |
-          set -uo pipefail
-          if rg --files-with-matches "(TODO|FIXME)" \
-                --hidden \
-                --no-ignore \
-                -g '!.git/**' \
-                -g '!.artifacts/**' \
-                -g '!node_modules/**' \
-                -g '!Tests/**/TestResults/**' \
-                -g '!PLAN.md' \
-                -g '!.vs/**'; then
-            echo "::error::Found TODO/FIXME markers in the repository. Please resolve or suppress them."
-            exit 1
-          else
-            echo "No TODO/FIXME markers detected."
-          fi