TypeScriptをセットアップ (#899)

Author: chvmvd

babel.config.js

@@ -1,10 +1,11 @@
 import { themes as prismThemes } from "prism-react-renderer";
+import type { Config } from "@docusaurus/types";
+import type * as Preset from "@docusaurus/preset-classic";
 import { execSync } from "node:child_process";
 import math from "remark-math";
 import katex from "rehype-katex";
 
-/** @type {import("@docusaurus/types").Config} */
-const config = {
+const config: Config = {
   title: "ut.code(); Learn",
   tagline: "ut.code(); 公式学習教材",
   url: "https://learn.utcode.net/",
@@ -40,11 +41,10 @@ const config = {
   presets: [
     [
       "@docusaurus/preset-classic",
-      /** @type {import('@docusaurus/preset-classic').Options} */
       {
         docs: {
           showLastUpdateTime: true,
-          sidebarPath: "./sidebars.js",
+          sidebarPath: "./sidebars.ts",
           editUrl: "https://github.com/ut-code/utcode-learn/blob/main/",
           remarkPlugins: [math],
           rehypePlugins: [katex],
@@ -58,10 +58,9 @@ const config = {
         gtag: process.env.GOOGLE_ANALYTICS_TRACKING_ID && {
           trackingID: process.env.GOOGLE_ANALYTICS_TRACKING_ID,
         },
-      },
+      } satisfies Preset.Options,
     ],
   ],
-  /** @type {import("@docusaurus/preset-classic").ThemeConfig} */
   themeConfig: {
     docs: {
       sidebar: {
@@ -110,7 +109,7 @@ const config = {
       ],
       copyright: `Copyright © ${new Date().getFullYear()} ut.code();. Built with Docusaurus.`,
     },
-  },
+  } satisfies Preset.ThemeConfig,
 };
 
 export default config;

docusaurus.config.js docusaurus.config.tsdocusaurus.config.js renamed to docusaurus.config.ts

@@ -14,6 +14,7 @@
   },
   "dependencies": {
     "@docusaurus/core": "^3.9.1",
+    "@docusaurus/plugin-content-docs": "^3.9.1",
     "@docusaurus/preset-classic": "^3.9.1",
     "@docusaurus/theme-mermaid": "^3.9.1",
     "@easyops-cn/docusaurus-search-local": "^0.52.1",
@@ -48,7 +49,11 @@
     "node": ">=18.0"
   },
   "devDependencies": {
+    "@docusaurus/module-type-aliases": "^3.9.1",
+    "@docusaurus/tsconfig": "^3.9.1",
+    "@docusaurus/types": "^3.9.1",
     "@types/react-slick": "^0.23.13",
-    "prettier": "^3.6.2"
+    "prettier": "^3.6.2",
+    "typescript": "^5.9.3"
   }
 }

package-lock.json

@@ -0,0 +1,7 @@
+import type { SidebarsConfig } from "@docusaurus/plugin-content-docs";
+
+const sidebars: SidebarsConfig = {
+  sidebar: [{ type: "autogenerated", dirName: "." }],
+};
+
+export default sidebars;