diff --git a/.changeset/tired-lamps-attend.md b/.changeset/tired-lamps-attend.md
new file mode 100644
index 0000000000..6ede347f35
--- /dev/null
+++ b/.changeset/tired-lamps-attend.md
@@ -0,0 +1,11 @@
+---
+"@lynx-js/rspeedy": minor
+---
+
+**BREAKING CHANGE**: Added explicit TypeScript peer dependency requirement of 5.1.6 - 5.8.x.
+
+This formalizes the existing TypeScript version requirement in `peerDependencies` (marked as optional since it is only needed for TypeScript configurations). The actual required TypeScript version has not changed.
+
+Note: This may cause installation to fail if you have strict peer dependency checks enabled.
+
+Node.js v22.7+ users can bypass TypeScript installation using `--experimental-transform-types` or `--experimental-strip-types` flags. Node.js v23.6+ users don't need any flags. See [Node.js - TypeScript](https://nodejs.org/api/typescript.html) for details.
diff --git a/packages/rspeedy/core/package.json b/packages/rspeedy/core/package.json
index 78a29cd06e..8e6249524b 100644
--- a/packages/rspeedy/core/package.json
+++ b/packages/rspeedy/core/package.json
@@ -81,6 +81,14 @@
     "vitest": "^3.1.1",
     "webpack": "^5.98.0"
   },
+  "peerDependencies": {
+    "typescript": "5.1.6 - 5.8.x"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  },
   "engines": {
     "node": ">=18"
   },
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 67430a6826..7c32fa2d40 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -282,6 +282,9 @@ importers:
       '@rsdoctor/rspack-plugin':
         specifier: 1.0.1
         version: 1.0.1(@rsbuild/core@1.3.2)(@rspack/core@1.3.1(@swc/helpers@0.5.15))(webpack@5.98.0)
+      typescript:
+        specifier: 5.1.6 - 5.8.x
+        version: 5.8.2
     devDependencies:
       '@lynx-js/vitest-setup':
         specifier: workspace:*