ci: stabilize documentation dependency updates

Author: vib-tools

.gitattributes

@@ -0,0 +1,9 @@
+* text=auto eol=lf
+
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.woff binary
+*.woff2 binary

.github/dependabot.yml

@@ -1,11 +1,17 @@
 version: 2
+
 updates:
   - package-ecosystem: npm
-    directory: /
+    directory: "/"
     schedule:
       interval: weekly
     open-pull-requests-limit: 5
+    ignore:
+      - dependency-name: "typescript"
+        update-types:
+          - "version-update:semver-major"
+
   - package-ecosystem: github-actions
-    directory: /
+    directory: "/"
     schedule:
       interval: monthly

.github/workflows/ci.yml

@@ -8,17 +8,32 @@ on:
 permissions:
   contents: read
 
+concurrency:
+  group: documentation-ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   validate:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 20
+
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: 22
+
       - name: Install dependencies
-        run: npm install
-      - name: Validate public content and build
-        run: npm run validate
+        run: npm install --no-audit --no-fund
+
+      - name: Validate public content
+        run: npm run validate:public
+
+      - name: Type-check
+        run: npm run typecheck
+
+      - name: Build Docusaurus site
+        run: npm run build

package.json

@@ -1,56 +1,56 @@
 {
-  "name": "@vibtools/ygit-platform-docs",
-  "version": "0.1.0",
-  "private": true,
-  "description": "Official public documentation platform for YGIT.",
-  "license": "UNLICENSED",
-  "engines": {
-    "node": ">=20.0"
-  },
-  "scripts": {
-    "docusaurus": "docusaurus",
-    "start": "docusaurus start",
-    "build": "docusaurus build",
-    "serve": "docusaurus serve",
-    "clear": "docusaurus clear",
-    "swizzle": "docusaurus swizzle",
-    "deploy": "docusaurus deploy",
-    "typecheck": "tsc --noEmit",
-    "validate:public": "node scripts/validate-public-content.mjs",
-    "validate": "npm run validate:public && npm run typecheck && npm run build",
-    "version:docs": "docusaurus docs:version",
-    "version:cli": "docusaurus docs:version:cli",
-    "version:sdk": "docusaurus docs:version:sdk",
-    "version:api": "docusaurus docs:version:api"
-  },
-  "dependencies": {
-    "@docusaurus/core": "3.10.2",
-    "@docusaurus/plugin-content-docs": "3.10.2",
-    "@docusaurus/preset-classic": "3.10.2",
-    "@docusaurus/theme-mermaid": "3.10.2",
-    "@docusaurus/theme-search-algolia": "3.10.2",
-    "@mdx-js/react": "^3.0.0",
-    "clsx": "^2.1.1",
-    "prism-react-renderer": "^2.4.1",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0"
-  },
-  "devDependencies": {
-    "@docusaurus/module-type-aliases": "3.10.2",
-    "@docusaurus/tsconfig": "3.10.2",
-    "@docusaurus/types": "3.10.2",
-    "typescript": "~5.6.3"
-  },
-  "browserslist": {
-    "production": [
-      ">0.5%",
-      "not dead",
-      "not op_mini all"
-    ],
-    "development": [
-      "last 3 chrome version",
-      "last 3 firefox version",
-      "last 5 safari version"
-    ]
-  }
+    "name":  "@vibtools/ygit-platform-docs",
+    "version":  "0.1.0",
+    "private":  true,
+    "description":  "Official public documentation platform for YGIT.",
+    "license":  "UNLICENSED",
+    "engines":  {
+                    "node":  "\u003e=20.0"
+                },
+    "scripts":  {
+                    "docusaurus":  "docusaurus",
+                    "start":  "docusaurus start",
+                    "build":  "docusaurus build",
+                    "serve":  "docusaurus serve",
+                    "clear":  "docusaurus clear",
+                    "swizzle":  "docusaurus swizzle",
+                    "deploy":  "docusaurus deploy",
+                    "typecheck":  "tsc --noEmit",
+                    "validate:public":  "node scripts/validate-public-content.mjs",
+                    "validate":  "npm run validate:public \u0026\u0026 npm run typecheck \u0026\u0026 npm run build",
+                    "version:docs":  "docusaurus docs:version",
+                    "version:cli":  "docusaurus docs:version:cli",
+                    "version:sdk":  "docusaurus docs:version:sdk",
+                    "version:api":  "docusaurus docs:version:api"
+                },
+    "dependencies":  {
+                         "@docusaurus/core":  "3.10.2",
+                         "@docusaurus/plugin-content-docs":  "3.10.2",
+                         "@docusaurus/preset-classic":  "3.10.2",
+                         "@docusaurus/theme-mermaid":  "3.10.2",
+                         "@docusaurus/theme-search-algolia":  "3.10.2",
+                         "@mdx-js/react":  "^3.0.0",
+                         "clsx":  "^2.1.1",
+                         "prism-react-renderer":  "^2.4.1",
+                         "react":  "^19.0.0",
+                         "react-dom":  "^19.0.0"
+                     },
+    "devDependencies":  {
+                            "@docusaurus/module-type-aliases":  "3.10.2",
+                            "@docusaurus/tsconfig":  "3.10.2",
+                            "@docusaurus/types":  "3.10.2",
+                            "typescript":  "5.6.3"
+                        },
+    "browserslist":  {
+                         "production":  [
+                                            "\u003e0.5%",
+                                            "not dead",
+                                            "not op_mini all"
+                                        ],
+                         "development":  [
+                                             "last 3 chrome version",
+                                             "last 3 firefox version",
+                                             "last 5 safari version"
+                                         ]
+                     }
 }