From c1084229981e0d1408e46380192b20fd40749776 Mon Sep 17 00:00:00 2001
From: Boshen <boshenc@gmail.com>
Date: Thu, 13 Nov 2025 15:03:57 +0800
Subject: [PATCH 1/4] Add Type-Aware Linting Alpha blog post
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .vitepress/config/inlined-scripts/banner.js |  2 +-
 .vitepress/sidebar.blog.json                |  4 ++
 .vitepress/theme/components/Banner.vue      |  4 +-
 src/blog/2025-12-01-type-aware-alpha.md     | 41 +++++++++++++++++++++
 4 files changed, 48 insertions(+), 3 deletions(-)
 create mode 100644 src/blog/2025-12-01-type-aware-alpha.md

diff --git a/.vitepress/config/inlined-scripts/banner.js b/.vitepress/config/inlined-scripts/banner.js
index f5779dd3b2a..c2d5f7e8143 100644
--- a/.vitepress/config/inlined-scripts/banner.js
+++ b/.vitepress/config/inlined-scripts/banner.js
@@ -6,6 +6,6 @@
     }
   };
 
-  window.__OXC_BANNER_ID__ = "/blog/2025-10-09-oxlint-js-plugins";
+  window.__OXC_BANNER_ID__ = "/blog/2025-12-01-type-aware-alpha";
   restore(`oxc-banner-dismissed-${__OXC_BANNER_ID__}`, "banner-dismissed");
 })();
diff --git a/.vitepress/sidebar.blog.json b/.vitepress/sidebar.blog.json
index bc6cc8b0e04..70ed5dc136c 100644
--- a/.vitepress/sidebar.blog.json
+++ b/.vitepress/sidebar.blog.json
@@ -1,4 +1,8 @@
 [
+  {
+    "text": "Type-Aware Linting Alpha",
+    "link": "/blog/2025-12-01-type-aware-alpha"
+  },
   {
     "text": "Oxlint JS Plugins Preview",
     "link": "/blog/2025-10-09-oxlint-js-plugins"
diff --git a/.vitepress/theme/components/Banner.vue b/.vitepress/theme/components/Banner.vue
index c388be9f167..9c8023366a1 100644
--- a/.vitepress/theme/components/Banner.vue
+++ b/.vitepress/theme/components/Banner.vue
@@ -17,7 +17,7 @@ const hide = () => {
 };
 
 // Sync with inlined-scripts/banner.js
-const slug = "/blog/2025-10-09-oxlint-js-plugins";
+const slug = "/blog/2025-12-01-type-aware-alpha";
 
 const bannerDismissed = useLocalStorage<boolean>(`oxc-banner-dismissed-${slug}`, false);
 
@@ -46,7 +46,7 @@ const dismiss = () => {
 
 <template>
   <div ref="el" class="banner banner-dismissed">
-    <div class="text"><a :href="slug">Announcing Oxlint JS Plugins Preview</a> 🎉</div>
+    <div class="text"><a :href="slug">Announcing Type-Aware Linting Alpha</a> 🎉</div>
 
     <button type="button" @click="dismiss">
       <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor">
diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
new file mode 100644
index 00000000000..18b35e832e4
--- /dev/null
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -0,0 +1,41 @@
+---
+title: Type-Aware Linting Alpha
+outline: deep
+authors:
+  - cameron
+  - camchenry
+---
+
+<AppBlogPostHeader />
+
+<br>
+
+We're excited to announce the alpha release of type-aware linting in Oxlint!
+
+## Overview
+
+[Add overview content here]
+
+## Quick Start
+
+[Add quick start instructions here]
+
+## What's New
+
+[Add details about new features and capabilities]
+
+## Performance
+
+[Add performance benchmarks and comparisons]
+
+## Technical Details
+
+[Add technical implementation details]
+
+## What's Next
+
+[Add roadmap and future plans]
+
+## Try It Out
+
+[Add call to action and community information]

From 645fea1bbd53b8083daa14325c44e73835a9b4f7 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Sat, 15 Nov 2025 11:25:50 +0000
Subject: [PATCH 2/4] first pass

---
 src/blog/2025-12-01-type-aware-alpha.md | 83 ++++++++++++++++++++++++-
 1 file changed, 80 insertions(+), 3 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 18b35e832e4..4ff828e3ab6 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -14,11 +14,54 @@ We're excited to announce the alpha release of type-aware linting in Oxlint!
 
 ## Overview
 
-[Add overview content here]
+Following our [technical preview in August](/blog/2025-08-17-oxlint-type-aware), we're excited to announce that type-aware linting has reached alpha status. This milestone brings significant improvements in stability, configurability, and rule coverage.
+
+Type-aware linting enables powerful rules like `no-floating-promises`, `no-misused-promises`, and `await-thenable` that catch bugs by understanding TypeScript's type system. With N type-aware rules now available, you can catch entire categories of runtime errors before they happen.
+
+The alpha release addresses the major limitations from the technical preview:
+
+- **Full rule configuration support** - Configure individual type-aware rules in `.oxlintrc.json`
+- **Disable comment support** - Use `eslint-disable` comments to control type-aware rules
+- **IDE support** - Type-aware linting works in VSCode and other supported editors
+- **Improved stability** - Many crashes and edge cases have been fixed
+
+While we're still working on performance for very large monorepos and some advanced rules, the alpha is ready for testing in production codebases.
 
 ## Quick Start
 
-[Add quick start instructions here]
+Install `oxlint` and `oxlint-tsgolint`, then run with the `--type-aware` flag:
+
+::: code-group
+
+```sh [npm]
+npm add -D oxlint oxlint-tsgolint@latest
+npx oxlint --type-aware
+```
+
+```sh [pnpm]
+pnpm add -D oxlint oxlint-tsgolint@latest
+pnpm oxlint --type-aware
+```
+
+```sh [yarn]
+yarn add -D oxlint oxlint-tsgolint@latest
+yarn oxlint --type-aware
+```
+
+```sh [bun]
+bun add -D oxlint oxlint-tsgolint@latest
+bunx oxlint --type-aware
+```
+
+:::
+
+To try a specific type-aware rule without other configuration:
+
+```bash
+npx oxlint --type-aware -A all -D typescript/no-floating-promises
+```
+
+For more configuration options, see our [usage guide](/docs/guide/usage/linter/type-aware).
 
 ## What's New
 
@@ -30,7 +73,41 @@ We're excited to announce the alpha release of type-aware linting in Oxlint!
 
 ## Technical Details
 
-[Add technical implementation details]
+### Architecture
+
+Type-aware linting in Oxlint uses a unique two-binary architecture:
+
+```
+oxlint CLI (Rust)
+  ├─ Handles file traversal, ignore logic, and diagnostics
+  ├─ Passes paths and configuration to tsgolint
+  └─ Formats and displays results
+
+tsgolint (Go)
+  ├─ Uses typescript-go for type checking
+  ├─ Executes type-aware rules
+  └─ Returns structured diagnostics
+```
+
+This design keeps Oxlint's core fast while leveraging TypeScript's type system through typescript-go. The frontend-backend separation means `oxlint` controls the user experience while `tsgolint` handles the heavy lifting of type analysis.
+
+### TypeScript Compatibility
+
+`tsgolint` is based on [typescript-go](https://github.com/microsoft/typescript-go), Microsoft's TypeScript v7.0 rewrite in Go, not the original TypeScript compiler.
+
+**Important compatibility notes:**
+
+- Only TypeScript 7.0+ features are supported
+- Pre-7.0 syntax and deprecated features are not supported
+- Legacy `tsconfig.json` options like `baseUrl` have been removed in TypeScript 7.0
+
+If you're using deprecated features from TypeScript 6.0 or earlier, you'll need to migrate your codebase first. See the [TypeScript migration guide](https://github.com/microsoft/TypeScript/issues/62508#issuecomment-3348649259) for help updating deprecated tsconfig options.
+
+### Implementation Details
+
+`tsgolint` doesn't use typescript-go's public APIs. Instead, it compiles typescript-go by [shimming](https://github.com/oxc-project/tsgolint/tree/main/shim) internal APIs to make them accessible. We actively track typescript-go updates and fix breaking changes as needed.
+
+Our typescript-go fork is synced regularly using renovatebot, ensuring we stay current with the latest improvements and fixes.
 
 ## What's Next
 

From a2539763389a5972f1265043daa31720f40b259e Mon Sep 17 00:00:00 2001
From: Cam McHenry <camchenry@users.noreply.github.com>
Date: Sat, 15 Nov 2025 14:41:37 -0500
Subject: [PATCH 3/4] Add features

Added new features and capabilities for rule configuration and diagnostics in oxlint.

Signed-off-by: Cam McHenry <camchenry@users.noreply.github.com>
---
 src/blog/2025-12-01-type-aware-alpha.md | 65 ++++++++++++++++++++++++-
 1 file changed, 64 insertions(+), 1 deletion(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 4ff828e3ab6..0450365080c 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -65,7 +65,70 @@ For more configuration options, see our [usage guide](/docs/guide/usage/linter/t
 
 ## What's New
 
-[Add details about new features and capabilities]
+### Rule configuration support in `oxlint`
+
+Type-aware rules that run in `tsgolint` can be configured in `oxlint` just like any other lint rule. For example, you can configure the `no-floating-promises` rule to allow certain safe calls or ignore `void`:
+
+```json
+{
+  "rules": {
+    "typescript/no-floating-promises": ["error", {
+      "ignoreVoid": true,
+      "allowForKnownSafePromises": [
+        { "from": "file", "name": "SafePromise" },
+        { "from": "lib", "name": "PromiseLike" },
+      ]
+    }]
+  }
+}
+```
+
+Previously, this would silently fail, but now the configuration is actually passed to `tsgolint` and parsed for the lint rule to use.
+
+### Disable comment support in `oxlint`
+
+Rules that run in `tsgolint` can now be disabled similar to any other `oxlint` rule by placing a comment in the file or on a line:
+
+```js
+// oxlint-disable-next-line typescript/no-floating-promises
+
+/* oxlint-disable-file typescript/no-floating-promises
+```
+
+Previously, this didn't actually disable the rule, but now it will.
+
+### More supported rules
+
+The alpha milestone is largely focused on stability and integrating `tsgolint` more closely with `oxlint`, but we've still ported several rules from `typescript-eslint` which you can now use via `oxlint` as well: 
+
+- `no-deprecated`
+- `prefer-includes`
+- `strict-boolean-expressions`
+
+### TypeScript program diagnostics are now reported
+
+Previously, if TypeScript failed to create and parse a program, these errors were not reported which lead to confusion around why linting was not working. Now, we report any issues with creating a program as a diagnostic. For example, if a `tsconfig.json` file contains `baseUrl`, that will be reported now:
+
+```
+$ oxlint --type-aware
+
+  × Invalid tsconfig
+   ╭─[docs/tsconfig.json:1:1]
+ 1 │ {
+   · ▲
+ 2 │   "compilerOptions": {
+   ╰────
+  help: Non-relative paths are not allowed. Did you forget a leading './'?
+
+  × Invalid tsconfig
+   ╭─[test/ui/tsconfig.json:1:1]
+ 1 │ {
+   · ▲
+ 2 │   "extends": "../../tsconfig.base.json",
+   ╰────
+  help: Option 'baseUrl' has been removed. Please remove it from your configuration.
+        See https://github.com/oxc-project/tsgolint/issues/351 for more information.
+```
 
 ## Performance
 

From fea8db65aa53bd49f7c84d5ece8cd5130807a438 Mon Sep 17 00:00:00 2001
From: Cam McHenry <camchenry@users.noreply.github.com>
Date: Sat, 15 Nov 2025 14:44:01 -0500
Subject: [PATCH 4/4] Fix code block

Signed-off-by: Cam McHenry <camchenry@users.noreply.github.com>
---
 src/blog/2025-12-01-type-aware-alpha.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 0450365080c..a65f513ee77 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -89,10 +89,11 @@ Previously, this would silently fail, but now the configuration is actually pass
 
 Rules that run in `tsgolint` can now be disabled similar to any other `oxlint` rule by placing a comment in the file or on a line:
 
-```js
-// oxlint-disable-next-line typescript/no-floating-promises
+```ts
+/* oxlint-disable typescript/no-floating-promises */
 
-/* oxlint-disable-file typescript/no-floating-promises
+// oxlint-disable-next-line typescript/no-floating-promises
+[1, 2, 3].map(async x => x + 1);
 ```
 
 Previously, this didn't actually disable the rule, but now it will.