Update maplibre, add release workflow, build for .net 8

.editorconfig

@@ -0,0 +1,39 @@
+root = true
+
+# All files
+[*]
+charset = utf-8
+end_of_line = crlf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+# C++/CLI source and headers
+[*.{cpp,h,hpp}]
+indent_style = space
+indent_size = 4
+
+# CMake
+[CMakeLists.txt]
+indent_style = space
+indent_size = 2
+
+[*.cmake]
+indent_style = space
+indent_size = 2
+
+# PowerShell
+[*.ps1]
+indent_style = space
+indent_size = 4
+
+# JSON / YAML
+[*.{json,yml,yaml}]
+indent_style = space
+indent_size = 2
+
+# Dependencies are managed externally — do not reformat
+[dependencies/**]
+indent_style = unset
+indent_size = unset
+trim_trailing_whitespace = false
+insert_final_newline = false

.github/workflows/bump-version.yml

@@ -0,0 +1,221 @@
+name: Create bump version PR
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: Version bump type.
+        required: true
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+          - prepatch
+          - preminor
+          - premajor
+          - prerelease
+      preid:
+        description: Prerelease identifier (e.g., 'alpha', 'beta', 'rc'). Only used with pre* version types.
+        required: false
+        type: string
+        default: 'rc'
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  bump-version-pr:
+    name: Bump version PR
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Create bump script
+        run: |
+          cat > bump-version.py << 'PYEOF'
+          import re, sys, os, subprocess, json
+
+          version_type = sys.argv[1]
+          preid        = sys.argv[2] if len(sys.argv) > 2 and sys.argv[2].strip() else 'rc'
+          cmake_path     = 'CMakeLists.txt'
+          changelog_path = 'CHANGELOG.md'
+
+          # ── Read current version from CMakeLists.txt ─────────────────────────────
+          cmake = open(cmake_path).read()
+          m = re.search(r'set\(MAPLIBRE_NET_VERSION "([^"]+)"\)', cmake)
+          if not m:
+              raise RuntimeError(f"Could not find MAPLIBRE_NET_VERSION in {cmake_path}")
+          current = m.group(1).strip()
+          print(f"Current version: {current}")
+
+          # ── Parse version (supports X.Y.Z and X.Y.Z-pre.N) ──────────────────────
+          pre_match = re.match(r'^(\d+)\.(\d+)\.(\d+)-(.+?)\.(\d+)$', current)
+          rel_match = re.match(r'^(\d+)\.(\d+)\.(\d+)$', current)
+
+          if pre_match:
+              major, minor, patch = int(pre_match.group(1)), int(pre_match.group(2)), int(pre_match.group(3))
+              pre_tag, pre_num = pre_match.group(4), int(pre_match.group(5))
+              is_pre = True
+          elif rel_match:
+              major, minor, patch = int(rel_match.group(1)), int(rel_match.group(2)), int(rel_match.group(3))
+              pre_tag, pre_num = None, 0
+              is_pre = False
+          else:
+              raise RuntimeError(f"Unrecognised version format: {current}")
+
+          # ── Compute new version ──────────────────────────────────────────────────
+          if version_type == 'patch':
+              new_version = f"{major}.{minor}.{patch}" if is_pre else f"{major}.{minor}.{patch + 1}"
+          elif version_type == 'minor':
+              new_version = f"{major}.{minor}.0" if is_pre else f"{major}.{minor + 1}.0"
+          elif version_type == 'major':
+              new_version = f"{major}.0.0" if is_pre else f"{major + 1}.0.0"
+          elif version_type == 'prepatch':
+              new_version = f"{major}.{minor}.{patch + 1}-{preid}.1"
+          elif version_type == 'preminor':
+              new_version = f"{major}.{minor + 1}.0-{preid}.1"
+          elif version_type == 'premajor':
+              new_version = f"{major + 1}.0.0-{preid}.1"
+          elif version_type == 'prerelease':
+              if is_pre:
+                  new_version = f"{major}.{minor}.{patch}-{pre_tag}.{pre_num + 1}"
+              else:
+                  new_version = f"{major}.{minor}.{patch + 1}-{preid}.1"
+          else:
+              raise RuntimeError(f"Unknown version type: {version_type}")
+
+          print(f"New version: {new_version}")
+
+          # ── Update CMakeLists.txt ────────────────────────────────────────────────
+          cmake = re.sub(
+              r'(set\(MAPLIBRE_NET_VERSION ")[^"]+(")',
+              rf'\g<1>{new_version}\g<2>',
+              cmake)
+          open(cmake_path, 'w').write(cmake)
+          print(f"Updated {cmake_path}")
+
+          # ── Update CHANGELOG.md ──────────────────────────────────────────────────
+          if not os.path.exists(changelog_path):
+              print("No CHANGELOG.md found, creating one")
+              open(changelog_path, 'w').write('# Changelog\n\n')
+
+          changelog = open(changelog_path).read()
+
+          # Collect PRs since last tag that aren't already in the changelog
+          missing_entries = []
+          try:
+              latest_tag = subprocess.check_output(
+                  ['git', 'describe', '--tags', '--abbrev=0'], text=True).strip()
+              print(f"Latest tag: {latest_tag}")
+              commit_range = f"{latest_tag}..HEAD"
+          except subprocess.CalledProcessError:
+              print("No previous tags found, using all commits")
+              commit_range = 'HEAD'
+
+          try:
+              commits = subprocess.check_output(
+                  ['git', 'log', commit_range, '--oneline'], text=True)
+          except subprocess.CalledProcessError:
+              commits = ''
+
+          pr_numbers = re.findall(r'#(\d+)', commits)
+          missing_prs = [n for n in pr_numbers if f'#{n}' not in changelog]
+          print(f"Found {len(missing_prs)} new PRs to add to changelog")
+
+          if missing_prs:
+              try:
+                  remote_url = subprocess.check_output(
+                      ['git', 'config', '--get', 'remote.origin.url'], text=True).strip()
+                  repo_match = re.search(r'github\.com[:/](.+?)(?:\.git)?$', remote_url)
+                  repo_full = repo_match.group(1) if repo_match else None
+              except Exception:
+                  repo_full = None
+
+              for pr_num in missing_prs:
+                  try:
+                      pr_json = subprocess.check_output(
+                          ['gh', 'pr', 'view', pr_num, '--json', 'title,author,number'], text=True)
+                      pr = json.loads(pr_json)
+                      if 'dependabot' in pr['author']['login']:
+                          continue
+                      pr_url = f"https://github.com/{repo_full}/pull/{pr['number']}" if repo_full else f"#{pr['number']}"
+                      entry = f"- {pr['title']} ([#{pr['number']}]({pr_url})) (@{pr['author']['login']})"
+                      missing_entries.append(entry)
+                      print(f"Added: {entry}")
+                  except Exception as e:
+                      print(f"Could not fetch PR #{pr_num}: {e}")
+
+          # Replace "## master" or "## main" with new version heading
+          changelog = re.sub(r'^## (?:master|main)\s*$', f'## {new_version}', changelog, flags=re.MULTILINE)
+          changelog = changelog.replace('- _...Add new stuff here..._\n', '')
+
+          # Prepend fresh master section
+          master_section = '\n'.join([
+              '## master',
+              '### ✨ Features and improvements',
+              '- _...Add new stuff here..._',
+              '',
+              '### 🐞 Bug fixes',
+              '- _...Add new stuff here..._',
+              '',
+              '',
+          ])
+
+          title_match = re.match(r'^(# .+?\n\n)', changelog)
+          if title_match:
+              title = title_match.group(1)
+              rest  = changelog[len(title):]
+          else:
+              title = '# Changelog\n\n'
+              rest  = changelog
+
+          # Insert missing PR entries into the Bug fixes block of the new version section
+          if missing_entries:
+              bug_fix_pattern = re.compile(
+                  r'^(## [^\n]+\n### ✨ Features and improvements\n(?:.*\n)*?### 🐞 Bug fixes\n)',
+                  re.MULTILINE)
+              bf_match = bug_fix_pattern.search(rest)
+              if bf_match:
+                  insert_at = bf_match.end()
+                  entries_text = '\n' + '\n'.join(missing_entries) + '\n'
+                  rest = rest[:insert_at] + entries_text + rest[insert_at:]
+              else:
+                  rest = rest + '\n' + '\n'.join(missing_entries) + '\n'
+
+          changelog = title + master_section + rest
+          open(changelog_path, 'w').write(changelog)
+          print("Updated CHANGELOG.md")
+
+          with open(os.environ['GITHUB_OUTPUT'], 'a') as f:
+              f.write(f"version={new_version}\n")
+          PYEOF
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Bump version and update changelog
+        id: version-details
+        run: |
+          python bump-version.py "${{ inputs.version }}" "${{ inputs.preid }}"
+          rm bump-version.py
+        env:
+          GH_TOKEN: ${{ github.token }}
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v7
+        with:
+          commit-message: Release v${{ steps.version-details.outputs.version }}
+          branch: release-v${{ steps.version-details.outputs.version }}
+          title: Release v${{ steps.version-details.outputs.version }}
+          body: |
+            Automated version bump to `v${{ steps.version-details.outputs.version }}`.
+
+            Review the `CHANGELOG.md` entries before merging. Once merged, trigger the **Build and Release** workflow to publish the GitHub release.
+          labels: release

.github/workflows/docs.yml

@@ -0,0 +1,97 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build-docs:
+    name: Build documentation
+    runs-on: windows-latest
+
+    steps:
+      - name: Enable Git long paths
+        run: git config --global core.longpaths true
+
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Set up MSVC developer tools
+        uses: ilammy/msvc-dev-cmd@v1
+        with:
+          arch: x64
+
+      - name: Get vcpkg commit ID
+        id: vcpkg-id
+        shell: pwsh
+        run: |
+          $id = git -C dependencies/maplibre-native/platform/windows/vendor/vcpkg rev-parse HEAD
+          Add-Content -Path $env:GITHUB_OUTPUT -Value "commit_id=$id"
+
+      - name: Cache vcpkg binary cache
+        uses: actions/cache@v4
+        with:
+          path: dependencies/maplibre-native/platform/windows/vendor/vcpkg/archives
+          key: vcpkg-x64-windows-${{ steps.vcpkg-id.outputs.commit_id }}
+
+      - name: Bootstrap vcpkg
+        run: |
+          & "dependencies\maplibre-native\platform\windows\vendor\vcpkg\bootstrap-vcpkg.bat" -disableMetrics
+
+      - name: Configure CMake
+        shell: pwsh
+        env:
+          VCPKG_BINARY_SOURCES: "clear;files,${{ github.workspace }}\\dependencies\\maplibre-native\\platform\\windows\\vendor\\vcpkg\\archives,readwrite"
+        run: |
+          $maxAttempts = 3
+          for ($attempt = 1; $attempt -le $maxAttempts; $attempt++) {
+            cmake -B build -G "Visual Studio 17 2022" -A x64 `
+              -DMLN_WITH_OPENGL=ON `
+              -DMLN_WITH_EGL=OFF `
+              -DMLN_WITH_VULKAN=OFF `
+              "-DCMAKE_CXX_FLAGS=/wd4267" `
+              "-DMAPLIBRE_NET_DOTNET_VERSION=net9.0"
+            if ($LASTEXITCODE -eq 0) { break }
+            if ($attempt -lt $maxAttempts) {
+              Remove-Item -Recurse -Force build -ErrorAction SilentlyContinue
+            } else {
+              exit $LASTEXITCODE
+            }
+          }
+
+      - name: Build (Release)
+        run: cmake --build build --target mbgl-dotnet --config Release --parallel
+
+      - name: Install docfx
+        run: dotnet tool install -g docfx
+
+      - name: Build documentation
+        run: docfx docs/docfx.json
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_site
+
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: build-docs
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4