chore: upgrade deps, migrate theme to TypeScript, and update GitHub Actions (#345)

Align with sibling Doocs projects: add TypeScript tooling, pin GitHub Actions to Node 24-compatible versions, and bump pnpm to v10.

Author: yanglbme

.github/workflows/compress.yml

@@ -11,11 +11,11 @@ jobs:
     if: github.repository == 'doocs/advanced-java'
     steps:
       - name: Checkout Branch
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Compress Images
         id: calibre
-        uses: calibreapp/image-actions@main
+        uses: calibreapp/image-actions@1.5.0
         with:
           githubToken: ${{ secrets.GITHUB_TOKEN }}
           compressOnly: true
@@ -31,6 +31,6 @@ jobs:
       - name: Push Changes
         if: |
           steps.calibre.outputs.markdown != ''
-        uses: ad-m/github-push-action@master
+        uses: ad-m/github-push-action@v1.3.0
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/deploy.yml

@@ -9,12 +9,12 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           fetch-depth: 0
 
       - name: Setup pnpm
-        uses: pnpm/action-setup@v4
+        uses: pnpm/action-setup@v6
 
       - name: Setup Node.js
         uses: actions/setup-node@v6
@@ -32,7 +32,7 @@ jobs:
         run: echo "java.doocs.org" > docs/.vitepress/dist/CNAME
 
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@v5
         with:
           path: docs/.vitepress/dist
 
@@ -48,4 +48,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v5

docs/.vitepress/env.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="vitepress/client" />
+
+declare module "*.vue" {
+  import type { DefineComponent } from "vue";
+  const component: DefineComponent<object, object, unknown>;
+  export default component;
+}

docs/.vitepress/theme/index.js docs/.vitepress/theme/index.tsdocs/.vitepress/theme/index.js renamed to docs/.vitepress/theme/index.ts

@@ -2,11 +2,12 @@ import DefaultTheme from "vitepress/theme";
 import giscusTalk from "vitepress-plugin-comment-with-giscus";
 import { useData, useRoute } from "vitepress";
 import { toRefs } from "vue";
+import type { Theme } from "vitepress";
 import Layout from "./Layout.vue";
 
 export default {
   extends: DefaultTheme,
-  Layout: Layout,
+  Layout,
   enhanceApp(ctx) {
     DefaultTheme.enhanceApp(ctx);
   },
@@ -30,7 +31,7 @@ export default {
         frontmatter,
         route,
       },
-      true
+      true,
     );
   },
-};
+} satisfies Theme;

package.json

@@ -1,16 +1,18 @@
 {
   "name": "advanced-java",
   "private": true,
-  "packageManager": "pnpm@9.12.3",
+  "packageManager": "pnpm@10.33.0",
   "scripts": {
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
-    "docs:preview": "vitepress preview docs"
+    "docs:preview": "vitepress preview docs",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "vitepress-plugin-comment-with-giscus": "^1.1.15"
   },
   "devDependencies": {
+    "typescript": "^6.0.3",
     "vitepress": "2.0.0-alpha.17"
   }
 }

pnpm-lock.yaml

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true
+  },
+  "include": ["docs/.vitepress/**/*"]
+}