Merge pull request 'ci: shared ci-workflows macOS workflow; fix the Xcode 27 Document ambiguity (blocked: runner has no GUI session)' (#3) from ci/shared-macos into main

The grogu runner has no GUI session, so xcodebuild test cannot reach
testmanagerd. CI compiles the app and the test bundle unsigned
(build-for-testing); the README documents running just test locally.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

.gitea/workflows/build.yaml

@@ -0,0 +1,16 @@
+name: build
+on:
+  push:
+    branches: ['**']
+    tags: ['v*']
+jobs:
+  macos:
+    uses: self:KofTwentyTwo/ci-workflows/.gitea/workflows/macos.yaml@v1
+    secrets: inherit
+    with:
+      # Build only: the app and the test bundle are compiled unsigned, the tests are not run. They are
+      # app-hosted XCTests and the grogu runner has no GUI session for testmanagerd; run `just test`
+      # locally before merging (README, Building from Source). Package.swift has no test target.
+      commands: |
+        xcodegen generate
+        xcodebuild -quiet -project markdownViewr.xcodeproj -scheme markdownViewr -destination 'platform=macOS' CODE_SIGNING_ALLOWED=NO build-for-testing

.gitleaksignore

@@ -1,2 +0,0 @@
-# Sparkle SUPublicEDKey: EdDSA public verification key, not a secret (exact historical finding only)
-b3940a3656a8dbc8d669825ed1d0cc0ec9e619d4:project.yml:generic-api-key:66

README.md

@@ -61,3 +61,12 @@ just run
 ```
 
 `just --list` shows all available recipes.
+
+### Tests
+
+The tests are app-hosted XCTests (`markdownViewrTests`). CI builds the app and the test bundle unsigned
+but does not run them (the CI macOS runner has no GUI session), so run them locally before merging:
+
+```bash
+just test   # xcodegen generate first if the project is stale
+```

markdownViewr/MarkdownDocument.swift

@@ -60,7 +60,7 @@ struct MarkdownDocument: FileDocument {
 
         let rawContent = frontmatter != nil ? body : markdown
         let content = preProcessSubscript(rawContent, enabled: extensions.subscript_)
-        let document = Markdown.Document(parsing: content)
+        let document = Document(parsing: content)
         var htmlVisitor = HTMLConverter()
         html += htmlVisitor.visit(document)
         return applyExtensions(html, extensions: extensions)
@@ -127,7 +127,7 @@ struct MarkdownDocument: FileDocument {
     }
 
     private static func renderFrontmatterAsMarkdown(_ yaml: String) -> String {
-        let document = Markdown.Document(parsing: "---\n\(yaml)\n---")
+        let document = Document(parsing: "---\n\(yaml)\n---")
         var htmlVisitor = HTMLConverter()
         return htmlVisitor.visit(document)
     }