diff --git a/.agents/skills/website-docs-url-mapping/SKILL.md b/.agents/skills/website-docs-url-mapping/SKILL.md
new file mode 100644
index 000000000..35f4fffa0
--- /dev/null
+++ b/.agents/skills/website-docs-url-mapping/SKILL.md
@@ -0,0 +1,69 @@
+---
+name: website-docs-url-mapping
+description: Modify URL mapping rules in the website-docs Gatsby site by editing gatsby/url-resolver/config.ts and gatsby/link-resolver/config.ts, updating Jest tests, updating gatsby/URL_MAPPING_ARCHITECTURE.md, and reviewing gatsby-plugin-react-i18next matchPath when URL prefixes or languages change.
+---
+
+# Website-docs URL Mapping
+
+## Overview
+
+Modify the mapping rules between docs source paths and site URLs, and resolve internal Markdown links, while keeping tests and docs in sync.
+
+## Workflow
+
+### 1) Gather Requirements (Clarify First)
+
+Ask the user for “input → expected output” examples (at least 3 of each; more is better):
+- Page URLs: `sourcePath/slug -> pageUrl` (whether to omit default language `/en/`, and trailing slash expectations)
+- Link resolution: `(linkPath, currentPageUrl) -> resolvedUrl` (include edge cases: hash, no leading slash, relative paths, etc.)
+
+### 2) Review Existing Design (Align Terms and Current Behavior)
+
+Open and quickly locate the rules sections:
+- `gatsby/URL_MAPPING_ARCHITECTURE.md` (Configuration Rules)
+- `gatsby/url-resolver/README.md` (pattern/alias/filenameTransform)
+- `gatsby/link-resolver/README.md` (direct vs path-based, conditions/pathConditions)
+
+### 3) Edit URL Resolver (Page URLs)
+
+Edit: `gatsby/url-resolver/config.ts`
+- `pathMappings` are matched in order (first match wins); new rules usually go before more general ones.
+- `sourcePattern` supports `{var}` and `{...var}`; `conditions` use extracted variables to decide applicability.
+- Use `filenameTransform` to handle `_index` / `_docHome` (ignore filename or switch `targetPattern`).
+- If branch display logic changes, update `aliases` as well (e.g. `{branch:branch-alias-tidb}`).
+
+### 4) Edit Link Resolver (Markdown Links)
+
+Edit: `gatsby/link-resolver/config.ts`
+- Direct mapping: only `linkPattern` (does not depend on the current page)
+- Path-based mapping: `pathPattern + linkPattern`, constrained by `pathConditions`
+- Use `namespaceTransform` for namespace migrations (e.g. `develop -> developer`)
+- Watch `defaultLanguage` omission logic and `url-resolver.trailingSlash` (tests should cover both)
+
+### 5) Update/Add Tests (Prevent Regressions)
+
+- `gatsby/url-resolver/__tests__/url-resolver.test.ts`
+- `gatsby/link-resolver/__tests__/link-resolver.test.ts`
+
+Coverage (at minimum, every new/changed rule has assertions):
+- New rule match vs fallback (ordering)
+- `en/zh/ja` + whether `/en/` is omitted
+- `_index` vs non-`_index`
+- Links: preserve hash, no leading slash, path depth, multi-segment prefixes, etc.
+
+### 6) Run Tests
+
+- Full suite: `yarn test`
+- Or run a single test file first: `yarn test gatsby/url-resolver/__tests__/url-resolver.test.ts`, `yarn test gatsby/link-resolver/__tests__/link-resolver.test.ts`
+
+### 7) Update Architecture Doc (Keep It In Sync)
+
+Edit: `gatsby/URL_MAPPING_ARCHITECTURE.md`
+- Update interpretations under “URL Resolver Configuration Rules” and “Link Resolver Configuration Rules”
+- Keep rule numbering/order consistent with `config.ts`, and update input/output examples
+
+### 8) Check i18n Routing (Often Required When URL Prefixes Change)
+
+Review: `gatsby-config.js` → `gatsby-plugin-react-i18next`:
+- Ensure `languages` matches supported site languages (currently `en/zh/ja`)
+- Ensure `pages[].matchPath` includes any new/renamed top-level path prefixes (e.g. `developer`, `best-practices`, `api`, `releases`, and repo keys in `docs/docs.json`)
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 000000000..f9cb49efd
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,46 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+
+- `src/`: Gatsby site code (React components, templates, state, theme, and styles).
+- `gatsby/`: build-time utilities (page creation, link/url resolvers, custom plugins) and unit tests.
+- `docs/`: documentation content (git submodule pointing to `pingcap/docs-staging`).
+- `locale/`: i18n dictionaries (`locale/{en,zh,ja}/translation.json`).
+- `static/`, `src/media/`, `images/`: static assets used by the site/README.
+- Generated (do not commit): `.cache/`, `public/`, `coverage/`.
+
+## Build, Test, and Development Commands
+
+- `yarn`: install dependencies and apply `patches/` via `patch-package`.
+- `git submodule update --init --depth 1 --remote`: fetch/update the docs submodule content.
+- `yarn start` (or `yarn dev`): run local development server (Gatsby develop).
+- `yarn build`: create a production build.
+- `yarn serve`: serve the production build locally.
+- `yarn clean`: remove Gatsby build caches (`.cache/`, `public/`).
+- `yarn test`: run Jest with coverage for code under `gatsby/`.
+
+## Coding Style & Naming Conventions
+
+- Indentation: 2 spaces (see `.editorconfig`); keep TypeScript `strict` passing.
+- Formatting: Prettier runs via Husky + lint-staged on commit (`.husky/pre-commit`).
+- Components: PascalCase folders/files (e.g. `src/components/Layout/`); utilities/hooks: camelCase.
+- Styles: prefer CSS Modules (`*.module.css`); shared CSS in `src/styles/*.css`.
+- Imports: `tsconfig.json` sets `baseUrl: "./src"` (absolute imports like `shared/utils/...` are preferred).
+
+## Testing Guidelines
+
+- Framework: Jest + `ts-jest` (`jest.config.js`).
+- Location/pattern: `gatsby/**/__tests__/**/*.test.{ts,tsx,js,jsx}`.
+- Add/adjust tests when changing resolver logic or Gatsby build utilities.
+
+## Commit & Pull Request Guidelines
+
+- Commit messages follow a Conventional Commits pattern (common types: `feat:`, `fix:`, `refactor:`, `chore:`).
+- PRs should include: clear description + rationale, linked issue(s), and screenshots for UI changes.
+- Before requesting review, ensure `yarn test` and `yarn build` pass locally.
+
+## Security & Configuration Tips
+
+- Put local-only env vars in `.env.development` (e.g. `GATSBY_ALGOLIA_APPLICATION_ID`, `GATSBY_ALGOLIA_API_KEY`).
+- If GitHub API rate-limits during development, set `GITHUB_AUTHORIZATION_TOKEN=...` when running commands.
+- Never commit `.env*` files (they are gitignored).
diff --git a/gatsby-config.js b/gatsby-config.js
index a0d7fdae5..9558c88ef 100644
--- a/gatsby-config.js
+++ b/gatsby-config.js
@@ -79,7 +79,9 @@ module.exports = {
             getLanguageFromPath: false,
           },
           {
-            matchPath: `/:lang?/(${Object.keys(docs.docs).join("|")})/(.*)`,
+            matchPath: `/:lang?/(${Object.keys(docs.docs).join(
+              "|"
+            )}|developer|best-practices|api|ai|releases)/(.*)`,
             getLanguageFromPath: true,
           },
           {
diff --git a/gatsby-node.js b/gatsby-node.js
index 6d01d9062..184065bb0 100644
--- a/gatsby-node.js
+++ b/gatsby-node.js
@@ -8,7 +8,7 @@ const {
   createDocSearch,
   create404,
 } = require("./gatsby/create-pages");
-const { createExtraType } = require("./gatsby/create-types");
+const { createFrontmatter, createNavs } = require("./gatsby/create-types");
 const {
   createConditionalToc,
 } = require("./gatsby/plugin/conditional-toc/conditional-toc");
@@ -26,6 +26,7 @@ exports.createPages = async ({ graphql, actions }) => {
 };
 
 exports.createSchemaCustomization = (options) => {
-  createExtraType(options);
+  createFrontmatter(options);
+  createNavs(options);
   createConditionalToc(options);
 };
diff --git a/gatsby-ssr.js b/gatsby-ssr.js
index c294d8d28..c38020b96 100644
--- a/gatsby-ssr.js
+++ b/gatsby-ssr.js
@@ -95,7 +95,113 @@ const fulfillCloudPlanScript = `
 })();
 `;
 
-export const onRenderBody = ({ setPostBodyComponents, setHeadComponents }) => {
+const headerPrehydrateScript = `
+(function() {
+  try {
+    var ROOT_SELECTOR = "[data-pc-docs-header-root]";
+    var LEFT_CLUSTER_SELECTOR = "[data-pc-docs-header-left-cluster]";
+    var LOGO_MEASURE_SELECTOR = "[data-pc-docs-header-logo-measure]";
+    var CSS_VAR_TRANSLATE_X = "--pc-docs-header-translate-x";
+    var CSS_VAR_LOGO_SCALE = "--pc-docs-header-logo-scale";
+    var LOGO_GAP = 24;
+    var FIRST_ROW_HEIGHT = 56;
+
+    function clamp(value, min, max) {
+      return Math.min(max, Math.max(min, value));
+    }
+
+    function sync(root) {
+      if (!root || !root.style) {
+        return false;
+      }
+
+      var y = window.scrollY || 0;
+      var progress = clamp(y / FIRST_ROW_HEIGHT, 0, 1);
+      var logoScale = 1 - progress * 0.2;
+
+      var leftCluster = root.querySelector(LEFT_CLUSTER_SELECTOR);
+      var logoMeasure = root.querySelector(LOGO_MEASURE_SELECTOR);
+
+      if (!leftCluster || !logoMeasure) {
+        return false;
+      }
+
+      var leftClusterWidth = leftCluster.getBoundingClientRect().width || 0;
+      var logoWidth = logoMeasure.getBoundingClientRect().width || 0;
+
+      // Always update logo scale; translateX depends on measured widths.
+      root.style.setProperty(CSS_VAR_LOGO_SCALE, "" + logoScale);
+
+      if (!leftClusterWidth || !logoWidth) {
+        return false;
+      }
+
+      var menuWidth = Math.max(0, leftClusterWidth - logoWidth);
+      var translateX = progress * (menuWidth + logoWidth * logoScale + LOGO_GAP);
+
+      root.style.setProperty(CSS_VAR_TRANSLATE_X, translateX + "px");
+      return true;
+    }
+
+    function trySync() {
+      var root = document.querySelector(ROOT_SELECTOR);
+      if (!root) {
+        return false;
+      }
+
+      // Desktop only: xs uses a different layout and doesn't consume translateX.
+      var isDesktop = false;
+      try {
+        isDesktop = window.matchMedia && window.matchMedia("(min-width: 900px)").matches;
+      } catch (e) {
+        isDesktop = false;
+      }
+      if (!isDesktop) {
+        root.style.setProperty(CSS_VAR_TRANSLATE_X, "0px");
+        root.style.setProperty(CSS_VAR_LOGO_SCALE, "1");
+        return true;
+      }
+
+      return sync(root);
+    }
+
+    if (trySync()) {
+      return;
+    }
+
+    var observer = new MutationObserver(function() {
+      if (trySync()) {
+        observer.disconnect();
+      }
+    });
+
+    observer.observe(document.documentElement, { childList: true, subtree: true });
+
+    // Fallback retries (in case layout isn't ready when the observer fires).
+    var retries = 0;
+    (function retry() {
+      if (trySync()) {
+        observer.disconnect();
+        return;
+      }
+      retries += 1;
+      if (retries >= 20) {
+        observer.disconnect();
+        return;
+      }
+      setTimeout(retry, 50);
+    })();
+  } catch (e) {
+    // no-op
+  }
+})();
+`;
+
+export const onRenderBody = ({
+  setPostBodyComponents,
+  setHeadComponents,
+  setPreBodyComponents,
+}) => {
   setHeadComponents([
     <link
       key="moderat-bold"
@@ -130,6 +236,12 @@ export const onRenderBody = ({ setPostBodyComponents, setHeadComponents }) => {
       crossOrigin="anonymous"
     />,
   ]);
+  setPreBodyComponents([
+    <script
+      key="header-prehydrate"
+      dangerouslySetInnerHTML={{ __html: headerPrehydrateScript }}
+    />,
+  ]);
   setPostBodyComponents([
     <script key="deprecated" dangerouslySetInnerHTML={{ __html: script }} />,
     <script
diff --git a/gatsby/URL_MAPPING_ARCHITECTURE.md b/gatsby/URL_MAPPING_ARCHITECTURE.md
new file mode 100644
index 000000000..484bf378e
--- /dev/null
+++ b/gatsby/URL_MAPPING_ARCHITECTURE.md
@@ -0,0 +1,578 @@
+# URL Mapping Architecture
+
+## Overview
+
+This document describes how the project handles URL mapping across three key areas:
+1. **Page URL Mapping**: Converting source file paths to published page URLs during build
+2. **TOC Mapping**: Resolving links in TOC (Table of Contents) files
+3. **Article Link Mapping**: Transforming internal links within markdown articles
+
+The system uses two core resolvers (`url-resolver` and `link-resolver`) that work together to provide a consistent, maintainable URL structure throughout the documentation site.
+
+## Architecture Flow
+
+### 1. Page URL Mapping (Build Time)
+
+**Location**: `gatsby/create-pages/create-docs.ts`
+
+**Process**:
+1. Gatsby queries all MDX files from the GraphQL data layer
+2. For each file, `calculateFileUrl()` from `url-resolver` converts the source path to a published URL
+3. `getTOCNamespace()` from `toc-namespace` determines the page's TOC namespace for navigation/context
+4. The resolved URL is used to create the Gatsby page with `createPage()`
+
+**Example**:
+```typescript
+// Source file: docs/markdown-pages/en/tidb/master/alert-rules.md
+// Slug: "en/tidb/master/alert-rules"
+const path = calculateFileUrl(node.slug, true);
+// Result: "/tidb/dev/alert-rules"
+// Creates page at: /tidb/dev/alert-rules
+```
+
+**Key Points**:
+- Uses `url-resolver` to transform source paths to URLs
+- Default language (`en`) is omitted from URLs (`omitDefaultLanguage: true`)
+- Only files referenced in TOC files are built (filtered by `filterNodesByToc`)
+
+### 2. TOC Mapping (Build Time)
+
+**Location**: `gatsby/toc.ts` and `gatsby/toc-filter.ts`
+
+**Process**:
+1. Gatsby queries all TOC files (files matching `/TOC.*md$/`)
+2. For each TOC file, `mdxAstToToc()` parses the markdown AST
+3. Links within TOC are resolved using `resolveMarkdownLink()` from `link-resolver`
+4. The resolved TOC structure is used to:
+   - Determine which files should be built (`getFilesFromTocs`)
+   - Generate navigation menus for pages
+
+**Example**:
+```typescript
+// TOC file: docs/markdown-pages/en/tidb/stable/TOC.md
+// Contains link: [Getting Started](/develop/getting-started)
+// TOC path: "/en/tidb/stable" (resolved from TOC file slug)
+const resolvedLink = resolveMarkdownLink("/develop/getting-started", "/en/tidb/stable");
+// Result: "/developer/getting-started"
+// Used in navigation menu
+```
+
+**Key Points**:
+- Uses `link-resolver` to resolve links in TOC files
+- TOC links are resolved relative to the TOC file's own URL
+- Resolved links are used to build a whitelist of files to include in the build
+
+### 3. Article Link Mapping (Build Time)
+
+**Location**: `gatsby/plugin/content/index.ts`
+
+**Process**:
+1. During markdown processing, Gatsby's MDX plugin processes each article
+2. For each link in the markdown AST, `resolveMarkdownLink()` resolves the link path
+3. The resolved link is converted to a Gatsby `<Link>` component
+4. External links (`http://`, `https://`) are kept as-is with `target="_blank"`
+
+**Example**:
+```typescript
+// Article: docs/markdown-pages/en/tidb/stable/overview.md
+// Contains link: [Upgrade Guide](/upgrade/upgrade-tidb-using-tiup)
+// Current page URL: "/tidb/stable/overview" (resolved from file path)
+const resolvedPath = resolveMarkdownLink(
+  "/upgrade/upgrade-tidb-using-tiup",
+  "/tidb/stable/overview"
+);
+// Result: "/tidb/stable/upgrade-tidb-using-tiup"
+// Rendered as: <Link to="/tidb/stable/upgrade-tidb-using-tiup">Upgrade Guide</Link>
+```
+
+**Key Points**:
+- Uses `link-resolver` to resolve links based on current page context
+- Links are resolved relative to the current article's URL
+- Hash fragments (`#section`) are preserved automatically
+
+## How They Connect
+
+### Build Process Flow
+
+```
+1. GraphQL Query
+   └─> Query all MDX files (including TOC files)
+
+2. TOC Processing (toc-filter.ts)
+   ├─> Parse TOC files
+   ├─> Resolve TOC links (link-resolver)
+   └─> Build file whitelist (locale/repo/version -> Set<filenames>)
+
+3. Page Creation (create-docs.ts)
+   ├─> Filter files by TOC whitelist
+   ├─> Resolve page URLs (url-resolver)
+   ├─> Determine namespace (toc-namespace/getTOCNamespace)
+   └─> Create Gatsby pages
+
+4. Content Processing (plugin/content/index.ts)
+   ├─> Process markdown AST
+   ├─> Resolve article links (link-resolver)
+   └─> Convert to JSX components
+```
+
+### Data Flow
+
+```
+Source File Path
+    ↓
+[url-resolver] → Published Page URL
+    ↓
+Page Context (pageUrl, namespace, etc.)
+    ↓
+[link-resolver] → Resolved Links (in TOC and articles)
+    ↓
+Final HTML/JSX
+```
+
+### Example: Complete Flow
+
+**Scenario**: Building a TiDB article with links
+
+1. **Source File**: `docs/markdown-pages/en/tidb/master/alert-rules.md`
+   - Contains link: `[Vector Search](/develop/vector-search)`
+
+2. **Page URL Resolution** (`create-docs.ts`):
+   ```typescript
+   const pageUrl = calculateFileUrl("en/tidb/master/alert-rules", true);
+   // Result: "/tidb/dev/alert-rules"
+   ```
+
+3. **TOC Processing** (`toc-filter.ts`):
+   - TOC file: `en/tidb/stable/TOC.md`
+   - Contains link to `alert-rules`
+   - Link resolved: `/tidb/dev/alert-rules`
+   - File added to whitelist: `en/tidb/stable -> Set(["alert-rules"])`
+
+4. **Page Creation** (`create-docs.ts`):
+   - File matches TOC whitelist → page is created
+   - Page URL: `/tidb/dev/alert-rules`
+   - Namespace: `TOCNamespace.TiDB`
+
+5. **Content Processing** (`plugin/content/index.ts`):
+   - Current page URL: `/en/tidb/dev/alert-rules`
+   - Link `/develop/vector-search` resolved:
+     ```typescript
+     resolveMarkdownLink("/develop/vector-search", "/en/tidb/dev/alert-rules")
+     // Result: "/developer/vector-search"
+     ```
+   - Rendered as: `<Link to="/developer/vector-search">Vector Search</Link>`
+
+## Configuration Rules
+
+The following sections describe the effects of each configuration rule in order of evaluation.
+
+---
+
+## URL Resolver Configuration Rules
+
+Rules are evaluated in order; the first matching rule wins.
+
+### Rule 1: TiDBCloud Dedicated Index
+
+**Effect**: Maps TiDBCloud dedicated `_index.md` files to the TiDBCloud root URL.
+
+**Source Pattern**: `/{lang}/tidbcloud/master/tidb-cloud/dedicated/{filename}`
+
+**Target Pattern**: `/{lang}/tidbcloud`
+
+**Conditions**: `filename = "_index"`
+
+**Example**:
+- Source: `en/tidbcloud/master/tidb-cloud/dedicated/_index.md`
+- Target: `/tidbcloud` (or `/en/tidbcloud` if default language not omitted)
+
+**Use Case**: The dedicated plan index page is served at the TiDBCloud root.
+
+---
+
+### Rule 2: TiDBCloud Releases Index
+
+**Effect**: Maps TiDBCloud releases `_index.md` to the releases namespace.
+
+**Source Pattern**: `/{lang}/tidbcloud/master/tidb-cloud/releases/{filename}`
+
+**Target Pattern**: `/{lang}/releases/tidb-cloud`
+
+**Conditions**: `filename = "_index"`
+
+**Example**:
+- Source: `en/tidbcloud/master/tidb-cloud/releases/_index.md`
+- Target: `/releases/tidb-cloud`
+
+**Use Case**: TiDBCloud releases are grouped under the shared releases namespace.
+
+---
+
+### Rule 3: TiDB Releases Index
+
+**Effect**: Maps TiDB stable branch releases `_index.md` to the releases namespace.
+
+**Source Pattern**: `/{lang}/tidb/{stable}/releases/{filename}`
+
+**Target Pattern**: `/{lang}/releases/tidb-self-managed`
+
+**Conditions**: `filename = "_index"`
+
+**Example**:
+- Source: `en/tidb/release-8.5/releases/_index.md`
+- Target: `/releases/tidb-self-managed`
+
+**Use Case**: TiDB releases are grouped under the shared releases namespace.
+
+---
+
+### Rule 4: TiDB-in-Kubernetes Releases Index
+
+**Effect**: Maps TiDB-in-Kubernetes releases `_index.md` to the releases namespace.
+
+**Source Pattern**: `/{lang}/tidb-in-kubernetes/main/releases/{filename}`
+
+**Target Pattern**: `/{lang}/releases/tidb-operator`
+
+**Conditions**: `filename = "_index"`
+
+**Example**:
+- Source: `en/tidb-in-kubernetes/main/releases/_index.md`
+- Target: `/releases/tidb-operator`
+
+**Use Case**: TiDB-in-Kubernetes releases are grouped under the shared releases namespace.
+
+---
+
+### Rule 5: TiDBCloud with Prefix
+
+**Effect**: Maps TiDBCloud pages with prefixes (dedicated, starter, essential) to TiDBCloud URLs.
+
+**Source Pattern**: `/{lang}/tidbcloud/{branch}/tidb-cloud/{...prefixes}/{filename}`
+
+**Target Pattern**:
+- For `_index`: `/{lang}/tidbcloud/{prefixes}` (keeps prefixes)
+- For other files: `/{lang}/tidbcloud/{filename}` (removes prefixes)
+
+**Filename Transform**:
+- `ignoreIf: ["_index"]` - Filename removed from URL for non-index files
+- `conditionalTarget.keepIf: ["_index"]` - Uses alternative pattern for `_index` files
+
+**Example**:
+- Source: `en/tidbcloud/master/tidb-cloud/dedicated/starter/_index.md`
+- Target: `/tidbcloud/dedicated/starter`
+- Source: `en/tidbcloud/master/tidb-cloud/dedicated/starter/getting-started.md`
+- Target: `/tidbcloud/getting-started`
+
+**Use Case**: TiDBCloud has multiple plan types (dedicated, starter, essential) with different URL structures.
+
+---
+
+### Rule 6: Developer/Best-Practices/API/AI Namespace
+
+**Effect**: Maps TiDB pages in `develop` (published as `developer`), `best-practices`, `api`, or `ai` folders to namespace URLs.
+
+**Source Pattern**: `/{lang}/tidb/{stable}/{folder}/{...folders}/{filename}`
+
+**Target Pattern**:
+- For `develop` folder:
+  - `_index`: `/{lang}/developer/{folders}` (keeps folder structure)
+  - Other files: `/{lang}/developer/{filename}` (removes folder structure)
+- For `best-practices`, `api`, and `ai` folders:
+  - `_index`: `/{lang}/{folder}/{folders}` (keeps folder structure)
+  - Other files: `/{lang}/{folder}/{filename}` (removes folder structure)
+
+**Conditions**:
+- `folder = ["develop"]` → published under `/developer`
+- `folder = ["best-practices", "api", "ai"]` → published under `/{folder}`
+
+**Filename Transform**:
+- `ignoreIf: ["_index"]` - Filename removed from URL for non-index files
+- `conditionalTarget.keepIf: ["_index"]` - Uses alternative pattern for `_index` files
+
+**Example**:
+- Source: `en/tidb/release-8.5/develop/subfolder/_index.md`
+- Target: `/developer/subfolder`
+- Source: `en/tidb/release-8.5/develop/subfolder/vector-search.md`
+- Target: `/developer/vector-search`
+- Source: `en/tidb/release-8.5/ai/overview.md`
+- Target: `/ai/overview`
+
+**Use Case**: These namespaces are shared across all TiDB versions, so folder structure is flattened for non-index files.
+
+---
+
+### Rule 7: TiDB with Branch Alias
+
+**Effect**: Maps TiDB pages with branch aliasing (master → dev, release-* → v*).
+
+**Source Pattern**: `/{lang}/tidb/{branch}/{...folders}/{filename}`
+
+**Target Pattern**: `/{lang}/tidb/{branch:branch-alias-tidb}/{filename}`
+
+**Filename Transform**: `ignoreIf: ["_index", "_docHome"]`
+
+**Alias Mapping** (`branch-alias-tidb`):
+- `master` → `dev`
+- `{stable}` → `stable` (exact match)
+- `release-*` → `v*` (wildcard pattern)
+
+**Example**:
+- Source: `en/tidb/master/alert-rules.md`
+- Target: `/tidb/dev/alert-rules`
+- Source: `en/tidb/release-8.5/alert-rules.md`
+- Target: `/tidb/v8.5/alert-rules`
+
+**Use Case**: Branch names are transformed to user-friendly version identifiers.
+
+---
+
+### Rule 8: TiDB-in-Kubernetes with Branch Alias
+
+**Effect**: Maps TiDB-in-Kubernetes pages with branch aliasing (main → dev, release-* → v*).
+
+**Source Pattern**: `/{lang}/tidb-in-kubernetes/{branch}/{...folders}/{filename}`
+
+**Target Pattern**: `/{lang}/tidb-in-kubernetes/{branch:branch-alias-tidb-in-kubernetes}/{filename}`
+
+**Filename Transform**: `ignoreIf: ["_index", "_docHome"]`
+
+**Alias Mapping** (`branch-alias-tidb-in-kubernetes`):
+- `main` → `dev`
+- `{stable}` → `stable` (exact match)
+- `release-*` → `v*` (wildcard pattern)
+
+**Example**:
+- Source: `en/tidb-in-kubernetes/main/deploy/deploy-tidb-on-kubernetes.md`
+- Target: `/tidb-in-kubernetes/dev/deploy-tidb-on-kubernetes`
+- Source: `en/tidb-in-kubernetes/release-1.6/deploy/deploy-tidb-on-kubernetes.md`
+- Target: `/tidb-in-kubernetes/v1.6/deploy-tidb-on-kubernetes`
+
+**Use Case**: Branch names are transformed to user-friendly version identifiers.
+
+---
+
+### Rule 9: Fallback Rule
+
+**Effect**: Generic fallback for any remaining paths.
+
+**Source Pattern**: `/{lang}/{repo}/{...any}/{filename}`
+
+**Target Pattern**: `/{lang}/{repo}/{filename}`
+
+**Filename Transform**: `ignoreIf: ["_index", "_docHome"]`
+
+**Example**:
+- Source: `en/dm/release-5.3/migration/migrate-data.md`
+- Target: `/en/dm/migrate-data`
+
+**Use Case**: Catches any paths that don't match previous rules.
+
+---
+
+## Link Resolver Configuration Rules
+
+Rules are evaluated in order; the first matching rule wins.
+
+### Rule 1: Releases Index Links
+
+**Effect**: Resolves `/releases/_index` links to TiDB self-managed releases page.
+
+**Link Pattern**: `/releases/_index`
+
+**Target Pattern**: `/{curLang}/releases/tidb-self-managed`
+
+**Example**:
+- Link: `/releases/_index`
+- Current Page: Any page
+- Result: `/releases/tidb-self-managed` (or `/en/releases/tidb-self-managed` if default language not omitted)
+
+**Use Case**: Direct links to TiDB releases page.
+
+---
+
+### Rule 2: TiDB Cloud Releases Index Links
+
+**Effect**: Resolves `/tidb-cloud/releases/_index` links to TiDB Cloud releases page.
+
+**Link Pattern**: `/tidb-cloud/releases/_index`
+
+**Target Pattern**: `/{curLang}/releases/tidb-cloud`
+
+**Example**:
+- Link: `/tidb-cloud/releases/_index`
+- Current Page: Any page
+- Result: `/releases/tidb-cloud`
+
+**Use Case**: Direct links to TiDB Cloud releases page.
+
+---
+
+### Rule 3: TiDB-in-Kubernetes Releases Index Links (Path-Based)
+
+**Effect**: Resolves `/tidb-in-kubernetes/releases/_index` links from TiDB-in-Kubernetes pages.
+
+**Path Pattern**: `/{lang}/tidb-in-kubernetes/{branch}/{...any}`
+
+**Link Pattern**: `/tidb-in-kubernetes/releases/_index`
+
+**Target Pattern**: `/{curLang}/releases/tidb-operator`
+
+**Example**:
+- Current Page: `/tidb-in-kubernetes/stable/deploy`
+- Link: `/tidb-in-kubernetes/releases/_index`
+- Result: `/releases/tidb-operator`
+
+**Use Case**: Links to TiDB-in-Kubernetes releases from operator pages.
+
+---
+
+### Rule 4: Links from TiDB Releases Landing Page (Path-Based)
+
+**Effect**: Resolves `/releases/*` links from the releases landing page to TiDB stable branch URLs.
+
+**Path Pattern**: `/{lang}/releases/tidb-self-managed/{...any}`
+
+**Link Pattern**: `/releases/{docname}`
+
+**Target Pattern**: `/{lang}/tidb/stable/{docname}`
+
+**Example**:
+- Current Page: `/releases/tidb-self-managed`
+- Link: `/releases/release-8.5.4`
+- Result: `/tidb/stable/release-8.5.4` (or `/en/tidb/stable/release-8.5.4` if default language not omitted)
+
+**Use Case**: The releases landing page uses `/releases/*` links, but the actual release notes pages are published under `/tidb/stable/*`.
+
+---
+
+### Rule 5: Links from TiDB Operator Releases Landing Page (Path-Based, /releases/*)
+
+**Effect**: Resolves `/releases/*` links from the operator releases landing page to TiDB-in-Kubernetes `dev` branch URLs.
+
+**Path Pattern**: `/{lang}/releases/tidb-operator/{...any}`
+
+**Link Pattern**: `/releases/{docname}`
+
+**Target Pattern**: `/{lang}/tidb-in-kubernetes/dev/{docname}`
+
+**Example**:
+- Current Page: `/releases/tidb-operator`
+- Link: `/releases/release-2.0.0`
+- Result: `/tidb-in-kubernetes/dev/release-2.0.0` (or `/en/tidb-in-kubernetes/dev/release-2.0.0` if default language not omitted)
+
+**Use Case**: The operator releases landing page is under `/releases/`, but the actual release notes pages are published under `/tidb-in-kubernetes/dev/*` (`main` is published as `dev`).
+
+---
+
+### Rule 6: Namespace Links (Direct Mapping)
+
+**Effect**: Resolves namespace links (`develop`, `best-practices`, `api`, `ai`, `tidb-cloud`) to namespace URLs (published as `/developer`, `/best-practices`, `/api`, `/ai`, `/tidbcloud`).
+
+**Link Pattern**: `/{namespace}/{...any}/{docname}`
+
+**Target Pattern**: `/{curLang}/{namespace}/{docname}`
+
+**Conditions**: `namespace = ["tidb-cloud", "develop", "best-practices", "api", "ai"]`
+
+**Namespace Transform**:
+- `tidb-cloud` → `tidbcloud`
+- `develop` → `developer`
+
+**Example**:
+- Link: `/develop/vector-search`
+- Current Page: Any page
+- Result: `/developer/vector-search`
+- Link: `/tidb-cloud/releases/_index`
+- Current Page: Any page
+- Result: `/tidbcloud/releases/_index` (namespace transformed)
+
+**Use Case**: Direct links to namespace pages from any location.
+
+---
+
+### Rule 7: TiDBCloud Page Links (Path-Based)
+
+**Effect**: Resolves relative links from TiDBCloud pages to TiDBCloud URLs.
+
+**Path Pattern**: `/{lang}/tidbcloud/{...any}`
+
+**Link Pattern**: `/{...any}/{docname}`
+
+**Target Pattern**: `/{lang}/tidbcloud/{docname}`
+
+**Example**:
+- Current Page: `/tidbcloud/dedicated`
+- Link: `/getting-started`
+- Result: `/tidbcloud/getting-started`
+- Current Page: `/tidbcloud/dedicated/starter`
+- Link: `/quick-start`
+- Result: `/tidbcloud/quick-start`
+
+**Use Case**: Relative links within TiDBCloud documentation preserve the TiDBCloud context.
+
+---
+
+### Rule 8: Developer/Best-Practices/API/AI Namespace Page Links (Path-Based)
+
+**Effect**: Resolves relative links from namespace pages to TiDB stable branch URLs.
+
+**Path Pattern**: `/{lang}/{namespace}/{...any}`
+
+**Path Conditions**: `namespace = ["developer", "best-practices", "api", "ai"]`
+
+**Link Pattern**: `/{...any}/{docname}`
+
+**Target Pattern**: `/{lang}/tidb/stable/{docname}`
+
+**Example**:
+- Current Page: `/developer/overview`
+- Link: `/vector-search`
+- Result: `/tidb/stable/vector-search`
+- Current Page: `/best-practices/guide`
+- Link: `/performance-tuning`
+- Result: `/tidb/stable/performance-tuning`
+
+**Use Case**: Links from namespace pages resolve to TiDB stable branch, maintaining namespace context.
+
+---
+
+### Rule 9: TiDB/TiDB-in-Kubernetes Page Links (Path-Based)
+
+**Effect**: Resolves relative links from TiDB or TiDB-in-Kubernetes pages, preserving branch/version.
+
+**Path Pattern**: `/{lang}/{repo}/{branch}/{...any}`
+
+**Path Conditions**: `repo = ["tidb", "tidb-in-kubernetes"]`
+
+**Link Pattern**: `/{...any}/{docname}`
+
+**Target Pattern**: `/{lang}/{repo}/{branch}/{docname}`
+
+**Example**:
+- Current Page: `/tidb/stable/upgrade`
+- Link: `/upgrade-tidb-using-tiup`
+- Result: `/tidb/stable/upgrade-tidb-using-tiup`
+- Current Page: `/tidb/v8.5/alert-rules`
+- Link: `/monitoring`
+- Result: `/tidb/v8.5/monitoring`
+- Current Page: `/tidb-in-kubernetes/stable/deploy`
+- Link: `/deploy-tidb-on-kubernetes`
+- Result: `/tidb-in-kubernetes/stable/deploy-tidb-on-kubernetes`
+
+**Use Case**: Relative links within TiDB or TiDB-in-Kubernetes documentation preserve the branch/version context.
+
+---
+
+## Summary
+
+The URL mapping system provides:
+
+1. **Consistent URL Structure**: Source files are mapped to clean, SEO-friendly URLs
+2. **Context-Aware Link Resolution**: Links are resolved based on the current page's context
+3. **Namespace Support**: Special namespaces (`developer`, `best-practices`, `api`, `ai`) have their own URL structure
+4. **Branch Aliasing**: Internal branch names are transformed to user-friendly versions
+5. **Default Language Omission**: Default language (`en`) is omitted from URLs for cleaner paths
+6. **TOC-Driven Build**: Only files referenced in TOC files are built, reducing build size
+
+The system is designed to be maintainable and extensible, with configuration-driven rules that can be easily modified or extended as the documentation structure evolves.
diff --git a/gatsby/__tests__/toc-filter.test.ts b/gatsby/__tests__/toc-filter.test.ts
new file mode 100644
index 000000000..c5c030d74
--- /dev/null
+++ b/gatsby/__tests__/toc-filter.test.ts
@@ -0,0 +1,36 @@
+describe("toc-filter ignore rules", () => {
+  const originalEnv = process.env.WEBSITE_IGNORED_TOC_RELATIVE_PATH_SUBSTRINGS;
+
+  afterEach(() => {
+    if (originalEnv == null) {
+      delete process.env.WEBSITE_IGNORED_TOC_RELATIVE_PATH_SUBSTRINGS;
+    } else {
+      process.env.WEBSITE_IGNORED_TOC_RELATIVE_PATH_SUBSTRINGS = originalEnv;
+    }
+    jest.resetModules();
+  });
+
+  it("ignores TOC-pingkai.md for release-8.5 zh", () => {
+    // Load module after reset to ensure env is applied consistently
+    jest.resetModules();
+    const { isIgnoredTocRelativePath } = require("../toc-ignore");
+
+    expect(
+      isIgnoredTocRelativePath(
+        "markdown-pages/zh/tidb/release-8.5/TOC-pingkai.md"
+      )
+    ).toBe(true);
+  });
+
+  it("supports env-based ignore substrings", () => {
+    process.env.WEBSITE_IGNORED_TOC_RELATIVE_PATH_SUBSTRINGS =
+      "custom/TOC-ignore-me.md, TOC-some-other.md";
+
+    jest.resetModules();
+    const { isIgnoredTocRelativePath } = require("../toc-ignore");
+
+    expect(isIgnoredTocRelativePath("custom/TOC-ignore-me.md")).toBe(true);
+    expect(isIgnoredTocRelativePath("foo/bar/TOC-some-other.md")).toBe(true);
+    expect(isIgnoredTocRelativePath("custom/TOC-keep-me.md")).toBe(false);
+  });
+});
diff --git a/gatsby/cloud-plan.ts b/gatsby/cloud-plan.ts
index fd2e9c49e..4e5192620 100644
--- a/gatsby/cloud-plan.ts
+++ b/gatsby/cloud-plan.ts
@@ -1,7 +1,8 @@
 import { mdxAstToToc, TocQueryData } from "./toc";
 import { generateConfig } from "./path";
 import { extractFilesFromToc } from "./toc-filter";
-import { CloudPlan } from "shared/interface";
+import { CloudPlan } from "../src/shared/interface";
+import { calculateFileUrl } from "./url-resolver";
 
 type TocMap = Map<
   string,
@@ -46,7 +47,8 @@ export async function getTidbCloudFilesFromTocs(graphql: any): Promise<TocMap> {
 
   tocNodes.forEach((node: TocQueryData["allMdx"]["nodes"][0]) => {
     const { config } = generateConfig(node.slug);
-    const toc = mdxAstToToc(node.mdxAST.children, config);
+    const tocPath = calculateFileUrl(node.slug);
+    const toc = mdxAstToToc(node.mdxAST.children, tocPath || node.slug);
     const files = extractFilesFromToc(toc);
 
     // Create a key for this specific locale/repo/version combination
@@ -59,13 +61,13 @@ export async function getTidbCloudFilesFromTocs(graphql: any): Promise<TocMap> {
     let tocType: CloudPlan | null = null;
 
     if (relativePath.includes("TOC.md")) {
-      tocType = "dedicated";
+      tocType = CloudPlan.Dedicated;
     } else if (relativePath.includes("TOC-tidb-cloud-starter")) {
-      tocType = "starter";
+      tocType = CloudPlan.Starter;
     } else if (relativePath.includes("TOC-tidb-cloud-essential")) {
-      tocType = "essential";
+      tocType = CloudPlan.Essential;
     } else if (relativePath.includes("TOC-tidb-cloud-premium")) {
-      tocType = "premium";
+      tocType = CloudPlan.Premium;
     }
 
     // Initialize the entry if it doesn't exist
@@ -118,12 +120,12 @@ export function determineInDefaultPlan(
 
   // Check if article is in TOC.md (dedicated)
   if (dedicated.has(fileName)) {
-    return "dedicated";
+    return CloudPlan.Dedicated;
   }
 
   // Check if article is in TOC-tidb-cloud-starter.md but not in TOC.md
   if (starter.has(fileName) && !dedicated.has(fileName)) {
-    return "starter";
+    return CloudPlan.Starter;
   }
 
   // Check if article is only in TOC-tidb-cloud-essential.md
@@ -132,7 +134,7 @@ export function determineInDefaultPlan(
     !dedicated.has(fileName) &&
     !starter.has(fileName)
   ) {
-    return "essential";
+    return CloudPlan.Essential;
   }
 
   if (
@@ -141,7 +143,7 @@ export function determineInDefaultPlan(
     !dedicated.has(fileName) &&
     !starter.has(fileName)
   ) {
-    return "premium";
+    return CloudPlan.Premium;
   }
 
   return null;
diff --git a/gatsby/create-pages/create-doc-home.ts b/gatsby/create-pages/create-doc-home.ts
index 76f5618c8..751d22a4c 100644
--- a/gatsby/create-pages/create-doc-home.ts
+++ b/gatsby/create-pages/create-doc-home.ts
@@ -3,13 +3,16 @@ import { resolve } from "path";
 import type { CreatePagesArgs } from "gatsby";
 import sig from "signale";
 
-import { Locale, BuildType } from "../../src/shared/interface";
+import {
+  Locale,
+  BuildType,
+  TOCNamespace,
+  TOCNamespaceSlugMap,
+} from "../../src/shared/interface";
 import {
   generateConfig,
-  generateNav,
+  generateNavTOCPath,
   generateDocHomeUrl,
-  generateStarterNav,
-  generateEssentialNav,
 } from "../../gatsby/path";
 import { DEFAULT_BUILD_TYPE, PageQueryData } from "./interface";
 
@@ -86,9 +89,14 @@ export const createDocHome = async ({
   nodes.forEach((node) => {
     const { id, name, pathConfig, filePath, slug } = node;
     const path = generateDocHomeUrl(name, pathConfig);
-    const navUrl = generateNav(pathConfig);
-    const starterNavUrl = generateStarterNav(pathConfig);
-    const essentialNavUrl = generateEssentialNav(pathConfig);
+    const namespace = TOCNamespace.Home;
+    const namespaceSlug = TOCNamespaceSlugMap[namespace];
+    const navUrl = generateNavTOCPath(pathConfig, namespaceSlug);
+    const starterNavUrl = generateNavTOCPath(pathConfig, "tidb-cloud-starter");
+    const essentialNavUrl = generateNavTOCPath(
+      pathConfig,
+      "tidb-cloud-essential"
+    );
     const locale =
       process.env.WEBSITE_BUILD_TYPE === "archive"
         ? [Locale.en, Locale.zh]
@@ -118,6 +126,7 @@ export const createDocHome = async ({
           feedback: true,
           globalHome: true,
         },
+        namespace,
       },
     });
   });
diff --git a/gatsby/create-pages/create-docs.ts b/gatsby/create-pages/create-docs.ts
index ca266fbf9..eaadbf93e 100644
--- a/gatsby/create-pages/create-docs.ts
+++ b/gatsby/create-pages/create-docs.ts
@@ -3,14 +3,16 @@ import { resolve } from "path";
 import type { CreatePagesArgs } from "gatsby";
 import sig from "signale";
 
-import { Locale, Repo, BuildType } from "../../src/shared/interface";
 import {
-  generateConfig,
-  generateUrl,
-  generateNav,
-  generateStarterNav,
-  generateEssentialNav,
-} from "../../gatsby/path";
+  Locale,
+  Repo,
+  BuildType,
+  TOCNamespaceSlugMap,
+  TOCNamespace,
+} from "../../src/shared/interface";
+import { generateConfig, generateNavTOCPath } from "../../gatsby/path";
+import { getTOCNamespace } from "../../gatsby/toc-namespace";
+import { calculateFileUrl } from "../../gatsby/url-resolver";
 import { cpMarkdown } from "../../gatsby/cp-markdown";
 import {
   getTidbCloudFilesFromTocs,
@@ -28,7 +30,7 @@ export const createDocs = async (createPagesArgs: CreatePagesArgs) => {
   const template = resolve(__dirname, "../../src/templates/DocTemplate.tsx");
 
   // First, get the list of files that should be built based on TOC content
-  const tocFilesMap = await getFilesFromTocs(graphql);
+  const { tocFilesMap, tocNamesByFileMap } = await getFilesFromTocs(graphql);
 
   // Get tidbcloud specific TOC files for plan determination
   const tidbCloudTocFilesMap = await getTidbCloudFilesFromTocs(graphql);
@@ -69,7 +71,8 @@ export const createDocs = async (createPagesArgs: CreatePagesArgs) => {
       const { config, name, filePath } = generateConfig(node.slug);
       return { ...node, pathConfig: config, name, filePath };
     }),
-    tocFilesMap
+    tocFilesMap,
+    tocNamesByFileMap
   );
 
   sig.info(
@@ -106,16 +109,28 @@ export const createDocs = async (createPagesArgs: CreatePagesArgs) => {
   );
 
   nodes.forEach((node) => {
-    const { id, name, pathConfig, filePath } = node;
+    const { id, name, pathConfig, filePath, tocNames } = node;
 
     if (name?.startsWith("_")) {
       return;
     }
 
-    const path = generateUrl(name, pathConfig);
-    const navUrl = generateNav(pathConfig);
-    const starterNavUrl = generateStarterNav(pathConfig);
-    const essentialNavUrl = generateEssentialNav(pathConfig);
+    const path = calculateFileUrl(node.slug, true);
+    if (!path) {
+      console.info(
+        `Failed to calculate URL for ${node.slug}, filePath: ${filePath}`
+      );
+      return;
+    }
+
+    const namespace = getTOCNamespace(node.slug);
+    const namespaceSlug = TOCNamespaceSlugMap[namespace || TOCNamespace.TiDB];
+    const navUrl = generateNavTOCPath(pathConfig, namespaceSlug);
+    const starterNavUrl = generateNavTOCPath(pathConfig, "tidb-cloud-starter");
+    const essentialNavUrl = generateNavTOCPath(
+      pathConfig,
+      "tidb-cloud-essential"
+    );
 
     const locale = [Locale.en, Locale.zh, Locale.ja]
       .map((l) =>
@@ -142,6 +157,7 @@ export const createDocs = async (createPagesArgs: CreatePagesArgs) => {
         pathConfig,
         // use for edit in github
         filePath,
+        tocNames,
         pageUrl: path,
         navUrl,
         starterNavUrl,
@@ -157,6 +173,7 @@ export const createDocs = async (createPagesArgs: CreatePagesArgs) => {
           feedback: true,
         },
         inDefaultPlan,
+        namespace,
       },
     });
 
diff --git a/gatsby/create-pages/interface.ts b/gatsby/create-pages/interface.ts
index a87d27237..8f5be2334 100644
--- a/gatsby/create-pages/interface.ts
+++ b/gatsby/create-pages/interface.ts
@@ -8,6 +8,10 @@ export interface PageQueryData {
       id: string;
       frontmatter: { aliases: string[] };
       slug: string;
+      parent: {
+        fileAbsolutePath: string;
+        relativePath: string;
+      } | null;
     }[];
   };
 }
diff --git a/gatsby/create-types/create-frontmatter.ts b/gatsby/create-types/create-frontmatter.ts
new file mode 100644
index 000000000..993e76299
--- /dev/null
+++ b/gatsby/create-types/create-frontmatter.ts
@@ -0,0 +1,29 @@
+import { CreatePagesArgs } from "gatsby";
+
+export const createFrontmatter = ({ actions }: CreatePagesArgs) => {
+  const { createTypes } = actions;
+
+  const typeDefs = `
+    """
+    Markdown Node
+    """
+    type Mdx implements Node @dontInfer {
+      frontmatter: Frontmatter
+    }
+
+    """
+    Markdown Frontmatter
+    """
+    type Frontmatter {
+      title: String!
+      summary: String
+      aliases: [String!]
+      draft: Boolean
+      hide_sidebar: Boolean
+      hide_commit: Boolean
+      hide_leftNav: Boolean
+    }
+  `;
+
+  createTypes(typeDefs);
+};
diff --git a/gatsby/create-types.ts b/gatsby/create-types/create-navs.ts
similarity index 72%
rename from gatsby/create-types.ts
rename to gatsby/create-types/create-navs.ts
index b2c6e4053..5fe431d74 100644
--- a/gatsby/create-types.ts
+++ b/gatsby/create-types/create-navs.ts
@@ -1,35 +1,11 @@
 import { CreatePagesArgs } from "gatsby";
-import { generateConfig } from "./path";
-import { mdxAstToToc } from "./toc";
-import { Root, List } from "mdast";
+import { mdxAstToToc } from "../toc";
+import { Root } from "mdast";
+import { calculateFileUrl } from "../url-resolver";
 
-export const createExtraType = ({ actions }: CreatePagesArgs) => {
+export const createNavs = ({ actions }: CreatePagesArgs) => {
   const { createTypes, createFieldExtension } = actions;
 
-  const typeDefs = `
-    """
-    Markdown Node
-    """
-    type Mdx implements Node @dontInfer {
-      frontmatter: Frontmatter
-    }
-
-    """
-    Markdown Frontmatter
-    """
-    type Frontmatter {
-      title: String!
-      summary: String
-      aliases: [String!]
-      draft: Boolean
-      hide_sidebar: Boolean
-      hide_commit: Boolean
-      hide_leftNav: Boolean
-    }
-  `;
-
-  createTypes(typeDefs);
-
   createFieldExtension({
     name: "navigation",
     extend() {
@@ -55,10 +31,13 @@ export const createExtraType = ({ actions }: CreatePagesArgs) => {
             }
           );
 
-          if (!slug.endsWith("TOC"))
-            throw new Error(`unsupported query in ${slug}`);
-          const { config } = generateConfig(slug);
-          const res = mdxAstToToc(mdxAST.children, config, undefined, true);
+          const tocPath = calculateFileUrl(slug);
+          const res = mdxAstToToc(
+            mdxAST.children,
+            tocPath || slug,
+            undefined,
+            true
+          );
           mdxNode.nav = res;
           return res;
         },
@@ -93,8 +72,13 @@ export const createExtraType = ({ actions }: CreatePagesArgs) => {
 
           if (!slug.endsWith("TOC-tidb-cloud-starter"))
             throw new Error(`unsupported query in ${slug}`);
-          const { config } = generateConfig(slug);
-          const res = mdxAstToToc(mdxAST.children, config, undefined, true);
+          const tocPath = calculateFileUrl(slug);
+          const res = mdxAstToToc(
+            mdxAST.children,
+            tocPath || slug,
+            undefined,
+            true
+          );
           mdxNode.starterNav = res;
           return res;
         },
@@ -129,8 +113,13 @@ export const createExtraType = ({ actions }: CreatePagesArgs) => {
 
           if (!slug.endsWith("TOC-tidb-cloud-essential"))
             throw new Error(`unsupported query in ${slug}`);
-          const { config } = generateConfig(slug);
-          const res = mdxAstToToc(mdxAST.children, config, undefined, true);
+          const tocPath = calculateFileUrl(slug);
+          const res = mdxAstToToc(
+            mdxAST.children,
+            tocPath || slug,
+            undefined,
+            true
+          );
           mdxNode.essentialNav = res;
           return res;
         },
diff --git a/gatsby/create-types/index.ts b/gatsby/create-types/index.ts
new file mode 100644
index 000000000..c31f8a93c
--- /dev/null
+++ b/gatsby/create-types/index.ts
@@ -0,0 +1,2 @@
+export * from "./create-frontmatter";
+export * from "./create-navs";
diff --git a/gatsby/link-resolver/README.md b/gatsby/link-resolver/README.md
new file mode 100644
index 000000000..cecfcf967
--- /dev/null
+++ b/gatsby/link-resolver/README.md
@@ -0,0 +1,445 @@
+# Link Resolver
+
+## Overview
+
+The Link Resolver is a module that transforms internal markdown links within articles based on the current page's context. It provides context-aware link resolution, allowing relative links in markdown files to be automatically converted to correct absolute URLs.
+
+## Purpose
+
+The Link Resolver serves the following purposes:
+
+1. **Context-Aware Resolution**: Resolves relative links based on the current page's URL, maintaining proper navigation structure
+2. **Namespace Handling**: Handles special namespaces (`develop`, `best-practices`, `api`, `tidb-cloud`) with custom transformation rules (`develop` links are mapped to `developer`)
+3. **Language Preservation**: Automatically preserves the current page's language in resolved links
+4. **Path-Based Mapping**: Supports both direct link mappings and path-based mappings (where rules depend on the current page's path)
+5. **Default Language Omission**: Optionally omits the default language prefix from resolved URLs
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { resolveMarkdownLink } from "../../gatsby/link-resolver";
+
+// Resolve a link from a tidbcloud page
+const resolved = resolveMarkdownLink(
+  "/dedicated/getting-started",  // link path
+  "/tidbcloud/dedicated"          // current page URL
+);
+// Result: "/tidbcloud/getting-started"
+
+// Resolve a legacy namespace link (/develop -> /developer)
+const resolved2 = resolveMarkdownLink(
+  "/develop/vector-search",
+  "/en/tidb/stable/overview"
+);
+// Result: "/developer/vector-search"
+
+// Resolve a link from a tidb page
+const resolved3 = resolveMarkdownLink(
+  "/upgrade/upgrade-tidb-using-tiup",
+  "/tidb/stable/overview"
+);
+// Result: "/tidb/stable/upgrade-tidb-using-tiup"
+```
+
+### Usage in Gatsby
+
+The Link Resolver is used in `gatsby/plugin/content/index.ts` during markdown processing:
+
+```typescript
+import { calculateFileUrl } from "../../url-resolver";
+import { resolveMarkdownLink } from "../../link-resolver";
+
+module.exports = function ({ markdownAST, markdownNode }) {
+  // Get current page URL from file path
+  const currentFileUrl = calculateFileUrl(markdownNode.fileAbsolutePath) || "";
+
+  visit(markdownAST, (node: any) => {
+    if (node.type === "link" && !node.url.startsWith("#")) {
+      const ele = node as Link;
+
+      if (ele.url.startsWith("http")) {
+        // External links: keep as-is
+        return externalLinkNode;
+      } else {
+        // Internal links: resolve using link-resolver
+        const resolvedPath = resolveMarkdownLink(
+          ele.url.replace(".md", ""),  // Remove .md extension
+          currentFileUrl
+        );
+
+        return {
+          type: "jsx",
+          value: `<Link to="${resolvedPath}">`,
+          // ... children
+        };
+      }
+    }
+  });
+};
+```
+
+## Configuration
+
+### Configuration Structure
+
+The Link Resolver configuration is defined in `gatsby/link-resolver/config.ts`:
+
+```typescript
+export const defaultLinkResolverConfig: LinkResolverConfig = {
+  defaultLanguage: "en",
+
+  linkMappings: [
+    // Direct link mapping (no pathPattern)
+    {
+      linkPattern: "/{namespace}/{...any}/{docname}",
+      targetPattern: "/{curLang}/{namespace}/{docname}",
+      conditions: {
+        namespace: ["tidb-cloud", "develop", "best-practices", "api"],
+      },
+      namespaceTransform: {
+        "tidb-cloud": "tidbcloud",
+        develop: "developer",
+      },
+    },
+
+    // Path-based mapping (with pathPattern)
+    {
+      pathPattern: "/{lang}/tidbcloud/{...any}",
+      linkPattern: "/{...any}/{docname}",
+      targetPattern: "/{lang}/tidbcloud/{docname}",
+    },
+    // ... more rules
+  ],
+};
+```
+
+### `LinkResolverConfig` Options
+
+- `linkMappings` (`LinkMappingRule[]`): Ordered link resolution rules (first match wins). Each rule can be either:
+  - **Direct mapping**: `linkPattern` + `targetPattern`
+  - **Path-based mapping**: `pathPattern` + `linkPattern` + `targetPattern`
+- `defaultLanguage` (`string`, optional): If the resolved URL starts with `/{defaultLanguage}/`, the language prefix is removed (for example, `/en/tidb/stable/...` -> `/tidb/stable/...`). If omitted, it falls back to the `url-resolver` `defaultLanguage`.
+
+#### `LinkMappingRule` Fields
+
+- `pathPattern` (`string`, optional): Pattern to match the current page URL (enables path-based mapping and provides context variables like `{lang}`, `{repo}`, `{branch}`).
+- `linkPattern` (`string`): Pattern to match the markdown link path (the input link is normalized to start with `/` before matching).
+- `targetPattern` (`string`): Pattern to generate the resolved URL. Can reference extracted variables and `{curLang}` (current page language).
+- `conditions` (`Record<string, string[]>`, optional): Restricts when the rule applies by allowing only specific values for extracted variables.
+- `pathConditions` (`Record<string, string[]>`, optional): Like `conditions`, but checked against variables extracted from `pathPattern` (only for path-based mappings).
+- `namespaceTransform` (`Record<string, string>`, optional): Transforms the `{namespace}` variable before applying `targetPattern` (for example, `develop -> developer`, `tidb-cloud -> tidbcloud`).
+
+### Pattern Syntax
+
+#### Variables
+
+- `{curLang}` - Current page's language (extracted from current page URL)
+- `{lang}` - Language from current page or link path
+- `{repo}` - Repository name (e.g., `tidb`, `tidbcloud`)
+- `{branch}` - Branch name (e.g., `stable`, `v8.5`)
+- `{namespace}` - Namespace (e.g., `develop`, `best-practices`, `api`)
+- `{docname}` - Document name (filename without extension)
+- `{...any}` - Variable number of path segments
+
+### Rule Types
+
+#### 1. Direct Link Mapping
+
+Direct link mappings match links directly without considering the current page path:
+
+```typescript
+{
+  linkPattern: "/{namespace}/{...any}/{docname}",
+  targetPattern: "/{curLang}/{namespace}/{docname}",
+  conditions: {
+    namespace: ["develop", "best-practices", "api"],
+  },
+}
+```
+
+**Example**:
+- Link: `/develop/vector-search`
+- Current Page: `/en/tidb/stable/overview` (any page)
+- Result: `/developer/vector-search` (or `/zh/developer/vector-search` depending on current page language)
+
+#### 2. Path-Based Mapping
+
+Path-based mappings first match the current page path, then match the link path:
+
+```typescript
+{
+  pathPattern: "/{lang}/tidbcloud/{...any}",
+  linkPattern: "/{...any}/{docname}",
+  targetPattern: "/{lang}/tidbcloud/{docname}",
+}
+```
+
+**Example**:
+- Current Page: `/tidbcloud/dedicated`
+- Link: `/getting-started`
+- Result: `/tidbcloud/getting-started`
+
+**How it works**:
+1. Match `pathPattern` against current page: `/{lang}/tidbcloud/{...any}` matches `/tidbcloud/dedicated`
+   - Variables: `{ lang: "en" (default), ...any: ["dedicated"] }`
+2. Match `linkPattern` against link: `/{...any}/{docname}` matches `/getting-started`
+   - Variables: `{ ...any: [], docname: "getting-started" }`
+3. Merge variables and apply `targetPattern`: `/{lang}/tidbcloud/{docname}`
+   - Result: `/tidbcloud/getting-started`
+
+### Conditions
+
+#### `conditions`
+
+Conditions are checked against link variables (for direct mappings) or merged variables (for path-based mappings):
+
+```typescript
+{
+  linkPattern: "/{namespace}/{...any}/{docname}",
+  targetPattern: "/{curLang}/{namespace}/{docname}",
+  conditions: {
+    namespace: ["develop", "best-practices", "api"],
+  },
+}
+```
+
+#### `pathConditions`
+
+Path conditions are checked against variables extracted from the current page path (only for path-based mappings):
+
+```typescript
+{
+  pathPattern: "/{lang}/{repo}/{branch}/{...any}",
+  pathConditions: {
+    repo: ["tidb", "tidb-in-kubernetes"],
+  },
+  linkPattern: "/{...any}/{docname}",
+  targetPattern: "/{lang}/{repo}/{branch}/{docname}",
+}
+```
+
+### Namespace Transformation
+
+Transform namespace values during resolution:
+
+```typescript
+{
+  linkPattern: "/{namespace}/{...any}/{docname}",
+  targetPattern: "/{curLang}/{namespace}/{docname}",
+  namespaceTransform: {
+    "tidb-cloud": "tidbcloud",
+  },
+}
+```
+
+**Example**:
+- Link: `/tidb-cloud/releases/_index`
+- Result: `/tidbcloud/releases/_index` (namespace transformed)
+
+## API Reference
+
+### `resolveMarkdownLink(linkPath, currentPageUrl)`
+
+Resolves a markdown link path based on the current page URL.
+
+**Parameters**:
+- `linkPath`: The markdown link path to resolve (e.g., `"/develop/vector-search"` or `"develop/vector-search"`)
+- `currentPageUrl`: The current page URL for context-based resolution (e.g., `"/tidb/stable/overview"`)
+
+**Returns**: `string | null` - The resolved URL or the original link path if no rule matches
+
+**Behavior**:
+- Returns external links (`http://`, `https://`) as-is
+- Returns anchor links (`#section`) as-is
+- Returns empty links as-is
+- Normalizes link paths (adds leading slash if missing)
+- Processes rules in order (first match wins)
+- Caches results for performance
+
+### `clearLinkResolverCache()`
+
+Clears all caches (useful for testing or when configuration changes).
+
+## How It Works
+
+1. **Early Exit**: External links, anchor links, and empty links are returned as-is.
+
+2. **Path Normalization**: Link paths are normalized (leading slash added if missing).
+
+3. **Rule Processing**: Rules are processed in order:
+   - **Direct Link Mapping**: Match `linkPattern` against link path
+   - **Path-Based Mapping**:
+     - First match `pathPattern` against current page path
+     - Check `pathConditions` if specified
+     - Then match `linkPattern` against link path
+     - Merge variables from both matches
+
+4. **Variable Extraction**: Variables are extracted from matched patterns.
+
+5. **Condition Checking**: Conditions are checked against extracted variables.
+
+6. **Namespace Transformation**: If `namespaceTransform` is specified, transform namespace values.
+
+7. **curLang Injection**: The current page's language (`curLang`) is automatically extracted and added to variables.
+
+8. **URL Construction**: The target URL is built by applying the target pattern with variables.
+
+9. **Post-processing**:
+   - Default language omission (if `defaultLanguage` is set)
+   - Trailing slash removal (if `trailingSlash: "never"`)
+
+10. **Fallback**: If no rule matches, return the original link path.
+
+## Examples
+
+### Example 1: Namespace Link from Any Page
+
+```typescript
+// Link: "/develop/vector-search"
+// Current Page: "/en/tidb/stable/overview" (any page)
+// Rule: Direct link mapping
+//   linkPattern: "/{namespace}/{...any}/{docname}"
+//   Matches: namespace="develop", docname="vector-search"
+//   targetPattern: "/{curLang}/{namespace}/{docname}"
+//   curLang extracted from current page: "en"
+//   namespaceTransform: "develop" -> "developer"
+// Result: "/developer/vector-search" (default language omitted)
+```
+
+### Example 2: TiDBCloud Page Link
+
+```typescript
+// Current Page: "/tidbcloud/dedicated"
+// Link: "/getting-started"
+// Rule: Path-based mapping
+//   pathPattern: "/{lang}/tidbcloud/{...any}"
+//     Matches current page: lang="en" (default), ...any=["dedicated"]
+//   linkPattern: "/{...any}/{docname}"
+//     Matches link: ...any=[], docname="getting-started"
+//   targetPattern: "/{lang}/tidbcloud/{docname}"
+// Result: "/tidbcloud/getting-started"
+```
+
+### Example 3: TiDB Page with Branch
+
+```typescript
+// Current Page: "/tidb/stable/upgrade"
+// Link: "/upgrade-tidb-using-tiup"
+// Rule: Path-based mapping
+//   pathPattern: "/{lang}/{repo}/{branch}/{...any}"
+//     pathConditions: repo=["tidb", "tidb-in-kubernetes"]
+//     Matches current page: lang="en", repo="tidb", branch="stable", ...any=["upgrade"]
+//   linkPattern: "/{...any}/{docname}"
+//     Matches link: ...any=[], docname="upgrade-tidb-using-tiup"
+//   targetPattern: "/{lang}/{repo}/{branch}/{docname}"
+// Result: "/tidb/stable/upgrade-tidb-using-tiup"
+```
+
+### Example 4: Namespace Transformation
+
+```typescript
+// Link: "/tidb-cloud/releases/_index"
+// Current Page: "/en/tidb/stable/overview" (any page)
+// Rule: Direct link mapping with namespace transform
+//   linkPattern: "/{namespace}/{...any}/{docname}"
+//     Matches: namespace="tidb-cloud", docname="_index"
+//   namespaceTransform: "tidb-cloud" -> "tidbcloud"
+//   targetPattern: "/{curLang}/{namespace}/{docname}"
+// Result: "/tidbcloud/releases/_index"
+```
+
+### Example 5: Hash Preservation
+
+```typescript
+// Link: "/develop/vector-search#data-types"
+// Current Page: "/en/tidb/stable/overview"
+// Rule: Direct link mapping
+//   Hash is preserved automatically
+// Result: "/developer/vector-search#data-types"
+```
+
+## Common Patterns
+
+### Pattern 1: Namespace Links
+
+Links starting with `develop`, `best-practices`, `api`, or `tidb-cloud` are resolved to namespace URLs (`develop` is mapped to `/developer`):
+
+```markdown
+<!-- In any markdown file -->
+[Vector Search](/develop/vector-search)
+<!-- Resolves to: /developer/vector-search -->
+```
+
+### Pattern 2: Relative Links from TiDBCloud Pages
+
+Relative links from TiDBCloud pages are resolved to TiDBCloud URLs:
+
+```markdown
+<!-- In /tidbcloud/dedicated page -->
+[Getting Started](/getting-started)
+<!-- Resolves to: /tidbcloud/getting-started -->
+```
+
+### Pattern 3: Relative Links from TiDB Pages
+
+Relative links from TiDB pages preserve the branch:
+
+```markdown
+<!-- In /tidb/stable/upgrade page -->
+[Upgrade Guide](/upgrade-tidb-using-tiup)
+<!-- Resolves to: /tidb/stable/upgrade-tidb-using-tiup -->
+```
+
+### Pattern 4: Releases Links
+
+Special handling for releases index pages:
+
+```markdown
+<!-- In any page -->
+[TiDB Releases](/releases/_index)
+<!-- Resolves to: /releases/tidb-self-managed -->
+
+[TiDB Cloud Releases](/tidb-cloud/releases/_index)
+<!-- Resolves to: /releases/tidb-cloud -->
+```
+
+## Best Practices
+
+1. **Rule Order**: Place more specific rules before general ones, as the first match wins.
+
+2. **Path Conditions**: Use `pathConditions` to narrow down when path-based rules should apply.
+
+3. **curLang Variable**: Always use `{curLang}` in target patterns to preserve the current page's language.
+
+4. **Namespace Transforms**: Use `namespaceTransform` to handle namespace name differences (e.g., `tidb-cloud` vs `tidbcloud`).
+
+5. **Hash Preservation**: The resolver automatically preserves hash fragments (`#section`) in links.
+
+6. **Testing**: Test link resolution from various page contexts to ensure correct behavior.
+
+## Troubleshooting
+
+### Link Not Resolved
+
+- Check if the link matches any `linkPattern` in the configuration
+- For path-based mappings, verify the current page matches the `pathPattern`
+- Check if conditions are correctly specified
+- Ensure the link path format is correct (with or without leading slash)
+
+### Wrong URL Generated
+
+- Check rule order - earlier rules take precedence
+- Verify path conditions are correctly specified
+- Check if namespace transforms are applied correctly
+- Ensure `curLang` is being extracted correctly from the current page
+
+### Language Not Preserved
+
+- Ensure `{curLang}` is used in the target pattern
+- Verify the current page URL has a language prefix (or defaults to configured default language)
+
+### Hash Fragment Lost
+
+- Hash fragments are automatically preserved - if lost, check if the link is being processed elsewhere
diff --git a/gatsby/link-resolver/__tests__/link-resolver.test.ts b/gatsby/link-resolver/__tests__/link-resolver.test.ts
new file mode 100644
index 000000000..c12241850
--- /dev/null
+++ b/gatsby/link-resolver/__tests__/link-resolver.test.ts
@@ -0,0 +1,879 @@
+/**
+ * Tests for link-resolver.ts
+ */
+
+import { resolveMarkdownLink } from "../link-resolver";
+
+describe("resolveMarkdownLink", () => {
+  describe("External links and anchor links", () => {
+    it("should return external http links as-is", () => {
+      const result = resolveMarkdownLink(
+        "http://example.com/page",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("http://example.com/page");
+    });
+
+    it("should return external https links as-is", () => {
+      const result = resolveMarkdownLink(
+        "https://example.com/page",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("https://example.com/page");
+    });
+
+    it("should return anchor links as-is", () => {
+      const result = resolveMarkdownLink(
+        "#section",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("#section");
+    });
+
+    it("should return empty link as-is", () => {
+      const result = resolveMarkdownLink("", "/en/tidb/stable/alert-rules");
+      expect(result).toBe("");
+    });
+  });
+
+  describe("Links with hash (anchor)", () => {
+    it("should preserve hash for namespace links", () => {
+      const result = resolveMarkdownLink(
+        "/develop/vector-search#data-types",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/developer/vector-search#data-types");
+    });
+
+    it("should preserve hash for tidbcloud links", () => {
+      const result = resolveMarkdownLink(
+        "/dedicated/getting-started#quick-start",
+        "/en/tidbcloud/dedicated"
+      );
+      expect(result).toBe("/tidbcloud/getting-started#quick-start");
+    });
+
+    it("should preserve hash for tidb links", () => {
+      const result = resolveMarkdownLink(
+        "/upgrade/upgrade-tidb-using-tiup#prerequisites",
+        "/en/tidb/stable/upgrade"
+      );
+      expect(result).toBe("/tidb/stable/upgrade-tidb-using-tiup#prerequisites");
+    });
+
+    it("should preserve hash for links that don't match any rule", () => {
+      const result = resolveMarkdownLink(
+        "/some/path/to/page#section",
+        "/en/tidb/some-path"
+      );
+      // /en/tidb/some-path matches Rule 3 /{lang}/{repo}/{branch}/{...any} where branch=some-path, {...any}=""
+      // Link /some/path/to/page matches /{...any}/{docname} where {...any}=some/path/to, docname=page
+      // Target: /{lang}/{repo}/{branch}/{docname} = /en/tidb/some-path/page
+      // After defaultLanguage omission: /tidb/some-path/page
+      expect(result).toBe("/tidb/some-path/page#section");
+    });
+
+    it("should preserve hash with multiple segments", () => {
+      const result = resolveMarkdownLink(
+        "/develop/a/b/c/page#anchor-name",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/developer/page#anchor-name");
+    });
+
+    it("should preserve hash for links without leading slash", () => {
+      const result = resolveMarkdownLink(
+        "develop/vector-search#section",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/developer/vector-search#section");
+    });
+
+    it("should preserve hash for tidb-in-kubernetes links", () => {
+      const result = resolveMarkdownLink(
+        "/deploy/deploy-tidb-on-kubernetes#configuration",
+        "/en/tidb-in-kubernetes/stable/deploy"
+      );
+      expect(result).toBe(
+        "/tidb-in-kubernetes/stable/deploy-tidb-on-kubernetes#configuration"
+      );
+    });
+
+    it("should preserve hash for Chinese links", () => {
+      const result = resolveMarkdownLink(
+        "/dedicated/getting-started#快速开始",
+        "/zh/tidbcloud/dedicated"
+      );
+      expect(result).toBe("/zh/tidbcloud/getting-started#快速开始");
+    });
+
+    it("should preserve hash for links that don't match any rule", () => {
+      const result = resolveMarkdownLink(
+        "/unknown/path#anchor",
+        "/en/tidb/stable/alert-rules"
+      );
+      // Link doesn't match linkMappings, but matches linkMappingsByPath
+      expect(result).toBe("/tidb/stable/path#anchor");
+    });
+
+    it("should handle hash with special characters", () => {
+      const result = resolveMarkdownLink(
+        "/develop/page#section-1_2-3",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/developer/page#section-1_2-3");
+    });
+  });
+
+  describe("linkMappings - namespace rules", () => {
+    it("should resolve develop namespace links (en - default language omitted)", () => {
+      const result = resolveMarkdownLink(
+        "/develop/vector-search/vector-search-data-types",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/developer/vector-search-data-types");
+    });
+
+    it("should resolve develop namespace links (zh - language prefix included)", () => {
+      const result = resolveMarkdownLink(
+        "/develop/vector-search/vector-search-data-types",
+        "/zh/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/zh/developer/vector-search-data-types");
+    });
+
+    it("should resolve develop namespace links (ja - language prefix included)", () => {
+      const result = resolveMarkdownLink(
+        "/develop/vector-search/vector-search-data-types",
+        "/ja/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/ja/developer/vector-search-data-types");
+    });
+
+    it("should resolve best-practices namespace links (en - default language omitted)", () => {
+      const result = resolveMarkdownLink(
+        "/best-practices/optimization/query-optimization",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/best-practices/query-optimization");
+    });
+
+    it("should resolve best-practices namespace links (zh - language prefix included)", () => {
+      const result = resolveMarkdownLink(
+        "/best-practices/optimization/query-optimization",
+        "/zh/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/zh/best-practices/query-optimization");
+    });
+
+    it("should resolve api namespace links (en - default language omitted)", () => {
+      const result = resolveMarkdownLink(
+        "/api/overview/introduction",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/api/introduction");
+    });
+
+    it("should resolve api namespace links (zh - language prefix included)", () => {
+      const result = resolveMarkdownLink(
+        "/api/overview/introduction",
+        "/zh/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/zh/api/introduction");
+    });
+
+    it("should resolve ai namespace links (en - default language omitted)", () => {
+      const result = resolveMarkdownLink(
+        "/ai/overview/introduction",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/ai/introduction");
+    });
+
+    it("should resolve ai namespace links (zh - language prefix included)", () => {
+      const result = resolveMarkdownLink(
+        "/ai/overview/introduction",
+        "/zh/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/zh/ai/introduction");
+    });
+
+    it("should resolve releases/_index links to tidb-self-managed (en - default language omitted)", () => {
+      const result = resolveMarkdownLink(
+        "/releases/_index",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/releases/tidb-self-managed");
+    });
+
+    it("should resolve releases/_index links to tidb-self-managed (zh - language prefix included)", () => {
+      const result = resolveMarkdownLink(
+        "/releases/_index",
+        "/zh/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/zh/releases/tidb-self-managed");
+    });
+
+    it("should resolve releases/_index links to tidb-self-managed (en - currentPageUrl without language prefix)", () => {
+      const result = resolveMarkdownLink(
+        "/releases/_index",
+        "/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/releases/tidb-self-managed");
+    });
+
+    it("should resolve tidb-cloud/releases/_index links (en - default language omitted)", () => {
+      const result = resolveMarkdownLink(
+        "/tidb-cloud/releases/_index",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/releases/tidb-cloud");
+    });
+
+    it("should resolve tidb-cloud/releases/_index links (zh - language prefix included)", () => {
+      const result = resolveMarkdownLink(
+        "/tidb-cloud/releases/_index",
+        "/zh/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/zh/releases/tidb-cloud");
+    });
+
+    it("should resolve tidb-cloud/releases/_index links (en - currentPageUrl without language prefix)", () => {
+      const result = resolveMarkdownLink(
+        "/tidb-cloud/releases/_index",
+        "/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/releases/tidb-cloud");
+    });
+
+    it("should resolve tidb-in-kubernetes/releases/_index links from tidb-in-kubernetes pages (en - default language omitted)", () => {
+      const result = resolveMarkdownLink(
+        "/tidb-in-kubernetes/releases/_index",
+        "/en/tidb-in-kubernetes/stable/deploy"
+      );
+      expect(result).toBe("/releases/tidb-operator");
+    });
+
+    it("should resolve tidb-in-kubernetes/releases/_index links from tidb-in-kubernetes pages (zh - language prefix included)", () => {
+      const result = resolveMarkdownLink(
+        "/tidb-in-kubernetes/releases/_index",
+        "/zh/tidb-in-kubernetes/stable/deploy"
+      );
+      expect(result).toBe("/zh/releases/tidb-operator");
+    });
+
+    it("should resolve tidb-in-kubernetes/releases/_index links from tidb-in-kubernetes pages (en - currentPageUrl without language prefix)", () => {
+      const result = resolveMarkdownLink(
+        "/tidb-in-kubernetes/releases/_index",
+        "/tidb-in-kubernetes/stable/deploy"
+      );
+      expect(result).toBe("/releases/tidb-operator");
+    });
+
+    it("should resolve /releases/* links from releases/tidb-self-managed page (en - default language omitted)", () => {
+      const result = resolveMarkdownLink(
+        "/releases/release-8.5.4",
+        "/en/releases/tidb-self-managed"
+      );
+      expect(result).toBe("/tidb/stable/release-8.5.4");
+    });
+
+    it("should resolve /releases/* links from releases/tidb-self-managed page (en - currentPageUrl without language prefix)", () => {
+      const result = resolveMarkdownLink(
+        "/releases/release-8.5.4",
+        "/releases/tidb-self-managed"
+      );
+      expect(result).toBe("/tidb/stable/release-8.5.4");
+    });
+
+    it("should resolve /releases/* links from releases/tidb-self-managed page (zh - language prefix included)", () => {
+      const result = resolveMarkdownLink(
+        "/releases/release-8.5.4",
+        "/zh/releases/tidb-self-managed"
+      );
+      expect(result).toBe("/zh/tidb/stable/release-8.5.4");
+    });
+
+    it("should resolve /releases/* links from releases/tidb-operator page (en - default language omitted)", () => {
+      const result = resolveMarkdownLink(
+        "/releases/release-2.0.0",
+        "/en/releases/tidb-operator"
+      );
+      expect(result).toBe("/tidb-in-kubernetes/dev/release-2.0.0");
+    });
+
+    it("should resolve /releases/* links from releases/tidb-operator page (en - currentPageUrl without language prefix)", () => {
+      const result = resolveMarkdownLink(
+        "/releases/release-2.0.0",
+        "/releases/tidb-operator"
+      );
+      expect(result).toBe("/tidb-in-kubernetes/dev/release-2.0.0");
+    });
+
+    it("should resolve /releases/* links from releases/tidb-operator page (en - default language omitted)", () => {
+      const result = resolveMarkdownLink(
+        "/release-2.0.0",
+        "/en/releases/tidb-operator"
+      );
+      expect(result).toBe("/tidb-in-kubernetes/dev/release-2.0.0");
+    });
+
+    it("should resolve /releases/* links from releases/tidb-operator page (en - currentPageUrl without language prefix)", () => {
+      const result = resolveMarkdownLink(
+        "/release-2.0.0",
+        "/releases/tidb-operator"
+      );
+      expect(result).toBe("/tidb-in-kubernetes/dev/release-2.0.0");
+    });
+
+    it("should resolve /releases/* links from releases/tidb-operator page (zh - language prefix included)", () => {
+      const result = resolveMarkdownLink(
+        "/releases/release-2.0.0",
+        "/zh/releases/tidb-operator"
+      );
+      expect(result).toBe("/zh/tidb-in-kubernetes/dev/release-2.0.0");
+    });
+
+    it("should resolve /releases/* links from releases/tidb-operator page (zh - language prefix included)", () => {
+      const result = resolveMarkdownLink(
+        "/release-2.0.0",
+        "/zh/releases/tidb-operator"
+      );
+      expect(result).toBe("/zh/tidb-in-kubernetes/dev/release-2.0.0");
+    });
+
+    it("should resolve releases namespace links (en - matches Rule 4, not Rule 1)", () => {
+      const result = resolveMarkdownLink(
+        "/releases/v8.5/release-notes",
+        "/en/tidb/stable/alert-rules"
+      );
+      // /releases/v8.5/release-notes doesn't match Rule 1 (releases not in conditions)
+      // Matches Rule 4: current page /en/tidb/stable/alert-rules matches /{lang}/{repo}/{branch}/{...any}
+      // Link /releases/v8.5/release-notes matches /{...any}/{docname}
+      // Target: /{lang}/{repo}/{branch}/{docname} = /en/tidb/stable/release-notes
+      // After defaultLanguage omission: /tidb/stable/release-notes
+      expect(result).toBe("/tidb/stable/release-notes");
+    });
+
+    it("should resolve releases namespace links (zh - matches Rule 4, not Rule 1)", () => {
+      const result = resolveMarkdownLink(
+        "/releases/v8.5/release-notes",
+        "/zh/tidb/stable/alert-rules"
+      );
+      // Same as above but with zh language prefix
+      expect(result).toBe("/zh/tidb/stable/release-notes");
+    });
+
+    it("should transform tidb-cloud to tidbcloud (en - default language omitted)", () => {
+      const result = resolveMarkdownLink(
+        "/tidb-cloud/dedicated/getting-started",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/tidbcloud/getting-started");
+    });
+
+    it("should transform tidb-cloud to tidbcloud (zh - language prefix included)", () => {
+      const result = resolveMarkdownLink(
+        "/tidb-cloud/dedicated/getting-started",
+        "/zh/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/zh/tidbcloud/getting-started");
+    });
+
+    it("should not match non-namespace links", () => {
+      const result = resolveMarkdownLink(
+        "/other/path/to/page",
+        "/en/tidb/stable/alert-rules"
+      );
+      // Link /other/path/to/page doesn't match linkMappings (not a namespace)
+      // But current page /en/tidb/stable/alert-rules matches /{lang}/{repo}/{branch}/{...any}
+      // Link matches /{...any}/{docname} where {...any} = other/path/to, docname = page
+      // Target pattern /{lang}/{repo}/{branch}/{docname} = /en/tidb/stable/page
+      // After defaultLanguage omission: /tidb/stable/page
+      expect(result).toBe("/tidb/stable/page");
+    });
+
+    it("should handle namespace links with multiple path segments (en)", () => {
+      const result = resolveMarkdownLink(
+        "/develop/a/b/c/d/e/page",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/developer/page");
+    });
+
+    it("should handle namespace links with multiple path segments (zh)", () => {
+      const result = resolveMarkdownLink(
+        "/develop/a/b/c/d/e/page",
+        "/zh/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/zh/developer/page");
+    });
+  });
+
+  describe("linkMappingsByPath - tidbcloud pages", () => {
+    it("should resolve links from tidbcloud pages (with lang)", () => {
+      const result = resolveMarkdownLink(
+        "/dedicated/getting-started",
+        "/en/tidbcloud/dedicated"
+      );
+      expect(result).toBe("/tidbcloud/getting-started");
+    });
+
+    it("should resolve links from tidbcloud pages (without lang, default omitted)", () => {
+      const result = resolveMarkdownLink(
+        "/dedicated/getting-started",
+        "/tidbcloud/dedicated"
+      );
+      // Should match by assuming default language is omitted from currentPageUrl
+      expect(result).toBe("/tidbcloud/getting-started");
+    });
+
+    it("should resolve links with multiple path segments from tidbcloud pages", () => {
+      const result = resolveMarkdownLink(
+        "/dedicated/setup/configuration",
+        "/en/tidbcloud/dedicated"
+      );
+      expect(result).toBe("/tidbcloud/configuration");
+    });
+
+    it("should resolve links from tidbcloud pages /tidbcloud", () => {
+      const result = resolveMarkdownLink(
+        "/vector-search/vector-search-data-types",
+        "/en/tidbcloud"
+      );
+      expect(result).toBe("/tidbcloud/vector-search-data-types");
+    });
+  });
+
+  describe("linkMappingsByPath - tidb pages with branch", () => {
+    it("should resolve links from tidb pages with stable branch", () => {
+      const result = resolveMarkdownLink(
+        "/upgrade/upgrade-tidb-using-tiup",
+        "/en/tidb/stable/upgrade"
+      );
+      expect(result).toBe("/tidb/stable/upgrade-tidb-using-tiup");
+    });
+
+    it("should resolve links from tidb pages with version branch", () => {
+      const result = resolveMarkdownLink(
+        "/upgrade/upgrade-tidb-using-tiup",
+        "/en/tidb/v8.5/upgrade"
+      );
+      expect(result).toBe("/tidb/v8.5/upgrade-tidb-using-tiup");
+    });
+
+    it("should resolve links from tidb-in-kubernetes pages", () => {
+      const result = resolveMarkdownLink(
+        "/deploy/deploy-tidb-on-kubernetes",
+        "/en/tidb-in-kubernetes/stable/deploy"
+      );
+      expect(result).toBe(
+        "/tidb-in-kubernetes/stable/deploy-tidb-on-kubernetes"
+      );
+    });
+
+    it("should not match non-tidb repo pages (pathConditions check)", () => {
+      const result = resolveMarkdownLink(
+        "/upgrade/upgrade-tidb-using-tiup",
+        "/en/other-repo/stable/upgrade"
+      );
+      // Should not match pathConditions for tidb/tidb-in-kubernetes, no fallback rule
+      expect(result).toBe("/upgrade/upgrade-tidb-using-tiup");
+    });
+
+    it("should resolve links with multiple path segments from tidb pages", () => {
+      const result = resolveMarkdownLink(
+        "/upgrade/a/b/c/page",
+        "/en/tidb/stable/upgrade"
+      );
+      expect(result).toBe("/tidb/stable/page");
+    });
+  });
+
+  describe("linkMappingsByPath - Rule 3: developer/best-practices/api/ai/releases namespace pages", () => {
+    it("should resolve links from develop namespace page", () => {
+      const result = resolveMarkdownLink(
+        "/vector-search/vector-search-overview",
+        "/en/developer/vector-search"
+      );
+      expect(result).toBe("/tidb/stable/vector-search-overview");
+    });
+
+    it("should resolve links from best-practices namespace page", () => {
+      const result = resolveMarkdownLink(
+        "/optimization/query-optimization",
+        "/en/best-practices/optimization"
+      );
+      expect(result).toBe("/tidb/stable/query-optimization");
+    });
+
+    it("should resolve links from api namespace page", () => {
+      const result = resolveMarkdownLink(
+        "/tiproxy/tiproxy-api",
+        "/en/api/tiproxy-api-overview"
+      );
+      expect(result).toBe("/tidb/stable/tiproxy-api");
+    });
+
+    it("should resolve links from ai namespace page", () => {
+      const result = resolveMarkdownLink("/some/linked-doc", "/en/ai/overview");
+      expect(result).toBe("/tidb/stable/linked-doc");
+    });
+
+    it("should resolve links from releases namespace page", () => {
+      const result = resolveMarkdownLink(
+        "/v8.5/release-notes",
+        "/en/releases/v8.5"
+      );
+      // Current page /en/releases/v8.5 doesn't match Rule 3 (releases not in pathConditions)
+      // Should return original link or match other rules
+      // Actually matches Rule 4: /en/releases/v8.5 matches /{lang}/{repo}/{branch}/{...any} where repo=releases, branch=v8.5
+      // But repo="releases" is not in pathConditions ["tidb", "tidb-in-kubernetes"]
+      // So it doesn't match Rule 4 either
+      // Should return original link
+      expect(result).toBe("/v8.5/release-notes");
+    });
+
+    it("should resolve links with multiple path segments from develop namespace", () => {
+      const result = resolveMarkdownLink(
+        "/vector-search/data-types/vector-search-data-types-overview",
+        "/en/developer/vector-search/data-types"
+      );
+      expect(result).toBe("/tidb/stable/vector-search-data-types-overview");
+    });
+
+    it("should resolve links with multiple path segments from best-practices namespace", () => {
+      const result = resolveMarkdownLink(
+        "/optimization/query/query-performance-tuning",
+        "/en/best-practices/optimization/query"
+      );
+      expect(result).toBe("/tidb/stable/query-performance-tuning");
+    });
+
+    it("should resolve links with multiple path segments from api namespace", () => {
+      const result = resolveMarkdownLink(
+        "/overview/api-reference/getting-started",
+        "/en/api/overview/api-reference"
+      );
+      expect(result).toBe("/tidb/stable/getting-started");
+    });
+
+    it("should resolve links with multiple path segments from releases namespace", () => {
+      const result = resolveMarkdownLink(
+        "/v8.5/whats-new/features",
+        "/en/releases/v8.5/whats-new"
+      );
+      // Current page /en/releases/v8.5/whats-new doesn't match Rule 3 (releases not in pathConditions)
+      // Should return original link or match other rules
+      // Actually matches Rule 4: /en/releases/v8.5/whats-new matches /{lang}/{repo}/{branch}/{...any} where repo=releases, branch=v8.5
+      // But repo="releases" is not in pathConditions ["tidb", "tidb-in-kubernetes"]
+      // So it doesn't match Rule 4 either
+      // Should return original link
+      expect(result).toBe("/v8.5/whats-new/features");
+    });
+
+    it("should preserve hash for links from develop namespace", () => {
+      const result = resolveMarkdownLink(
+        "/vector-search/vector-search-overview#data-types",
+        "/en/developer/vector-search"
+      );
+      expect(result).toBe("/tidb/stable/vector-search-overview#data-types");
+    });
+
+    it("should preserve hash for links from best-practices namespace", () => {
+      const result = resolveMarkdownLink(
+        "/optimization/query-optimization#index-selection",
+        "/en/best-practices/optimization"
+      );
+      expect(result).toBe("/tidb/stable/query-optimization#index-selection");
+    });
+
+    it("should resolve links from Chinese develop namespace", () => {
+      const result = resolveMarkdownLink(
+        "/vector-search/vector-search-overview",
+        "/zh/developer/vector-search"
+      );
+      expect(result).toBe("/zh/tidb/stable/vector-search-overview");
+    });
+
+    it("should resolve links from Japanese develop namespace", () => {
+      const result = resolveMarkdownLink(
+        "/vector-search/vector-search-overview",
+        "/ja/developer/vector-search"
+      );
+      expect(result).toBe("/ja/tidb/stable/vector-search-overview");
+    });
+
+    it("should resolve single segment links from develop namespace", () => {
+      const result = resolveMarkdownLink(
+        "/page-name",
+        "/en/developer/vector-search"
+      );
+      expect(result).toBe("/tidb/stable/page-name");
+    });
+
+    it("should resolve links from develop namespace root", () => {
+      const result = resolveMarkdownLink(
+        "/vector-search-overview",
+        "/en/developer"
+      );
+      expect(result).toBe("/tidb/stable/vector-search-overview");
+    });
+
+    it("should resolve links from api namespace root", () => {
+      const result = resolveMarkdownLink("/api-overview", "/en/api");
+      expect(result).toBe("/tidb/stable/api-overview");
+    });
+
+    it("should handle links without leading slash from develop namespace", () => {
+      const result = resolveMarkdownLink(
+        "vector-search/vector-search-overview",
+        "/en/developer/vector-search"
+      );
+      expect(result).toBe("/tidb/stable/vector-search-overview");
+    });
+
+    it("should resolve links from best-practices namespace with deep nesting", () => {
+      const result = resolveMarkdownLink(
+        "/a/b/c/d/e/page",
+        "/en/best-practices/a/b/c/d/e"
+      );
+      expect(result).toBe("/tidb/stable/page");
+    });
+
+    it("should resolve links from releases namespace with version segments", () => {
+      const result = resolveMarkdownLink(
+        "/v8.5/changelog/changes",
+        "/en/releases/v8.5/changelog"
+      );
+      // Current page /en/releases/v8.5/changelog doesn't match Rule 3 (releases not in pathConditions)
+      // Should return original link or match other rules
+      // Actually matches Rule 4: /en/releases/v8.5/changelog matches /{lang}/{repo}/{branch}/{...any} where repo=releases, branch=v8.5
+      // But repo="releases" is not in pathConditions ["tidb", "tidb-in-kubernetes"]
+      // So it doesn't match Rule 4 either
+      // Should return original link
+      expect(result).toBe("/v8.5/changelog/changes");
+    });
+
+    it("should not match non-develop/best-practices/api/releases namespace pages", () => {
+      const result = resolveMarkdownLink(
+        "/some/path/to/page",
+        "/en/other-namespace/some/path"
+      );
+      // Should not match Rule 3 (namespace is "other-namespace", not in pathConditions)
+      // Should return original link or match other rules
+      expect(result).toBe("/some/path/to/page");
+    });
+  });
+
+  describe("Default language omission", () => {
+    it("should omit /en/ prefix for English links from tidbcloud pages", () => {
+      const result = resolveMarkdownLink(
+        "/dedicated/getting-started",
+        "/en/tidbcloud/dedicated"
+      );
+      expect(result).toBe("/tidbcloud/getting-started");
+    });
+
+    it("should omit /en/ prefix for English links from tidb pages", () => {
+      const result = resolveMarkdownLink(
+        "/upgrade/upgrade-tidb-using-tiup",
+        "/en/tidb/stable/upgrade"
+      );
+      expect(result).toBe("/tidb/stable/upgrade-tidb-using-tiup");
+    });
+
+    it("should keep /zh/ prefix for Chinese links", () => {
+      const result = resolveMarkdownLink(
+        "/dedicated/getting-started",
+        "/zh/tidbcloud/dedicated"
+      );
+      expect(result).toBe("/zh/tidbcloud/getting-started");
+    });
+
+    it("should keep /ja/ prefix for Japanese links", () => {
+      const result = resolveMarkdownLink(
+        "/upgrade/upgrade-tidb-using-tiup",
+        "/ja/tidb/stable/upgrade"
+      );
+      expect(result).toBe("/ja/tidb/stable/upgrade-tidb-using-tiup");
+    });
+  });
+
+  describe("curLang variable", () => {
+    it("should extract curLang from current page URL first segment (en)", () => {
+      const result = resolveMarkdownLink(
+        "/develop/vector-search",
+        "/en/tidb/stable/alert-rules"
+      );
+      // curLang should be "en" and omitted in result
+      expect(result).toBe("/developer/vector-search");
+    });
+
+    it("should extract curLang from current page URL first segment (zh)", () => {
+      const result = resolveMarkdownLink(
+        "/develop/vector-search",
+        "/zh/tidb/stable/alert-rules"
+      );
+      // curLang should be "zh" and included in result
+      expect(result).toBe("/zh/developer/vector-search");
+    });
+
+    it("should extract curLang from current page URL first segment (ja)", () => {
+      const result = resolveMarkdownLink(
+        "/develop/vector-search",
+        "/ja/tidb/stable/alert-rules"
+      );
+      // curLang should be "ja" and included in result
+      expect(result).toBe("/ja/developer/vector-search");
+    });
+
+    it("should handle curLang when current page URL has no language prefix", () => {
+      const result = resolveMarkdownLink(
+        "/develop/vector-search",
+        "/tidb/stable/alert-rules"
+      );
+      // curLang should fallback to default language when language prefix is omitted
+      expect(result).toBe("/developer/vector-search");
+    });
+
+    it("should use curLang in releases/_index target pattern for tidb-self-managed", () => {
+      const result = resolveMarkdownLink(
+        "/releases/_index",
+        "/zh/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/zh/releases/tidb-self-managed");
+    });
+
+    it("should use curLang in tidb-cloud/releases/_index target pattern", () => {
+      const result = resolveMarkdownLink(
+        "/tidb-cloud/releases/_index",
+        "/ja/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/ja/releases/tidb-cloud");
+    });
+
+    it("should use curLang in tidb-in-kubernetes/releases/_index target pattern", () => {
+      const result = resolveMarkdownLink(
+        "/tidb-in-kubernetes/releases/_index",
+        "/ja/tidb-in-kubernetes/stable/deploy"
+      );
+      expect(result).toBe("/ja/releases/tidb-operator");
+    });
+
+    it("should use curLang in namespace links target pattern", () => {
+      const result = resolveMarkdownLink(
+        "/api/overview/introduction",
+        "/zh/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/zh/api/introduction");
+    });
+  });
+
+  describe("Trailing slash handling", () => {
+    it("should remove trailing slash (trailingSlash: never)", () => {
+      const result = resolveMarkdownLink(
+        "/develop/vector-search/",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/developer/vector-search");
+    });
+
+    it("should handle links without trailing slash", () => {
+      const result = resolveMarkdownLink(
+        "/develop/vector-search",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/developer/vector-search");
+    });
+  });
+
+  describe("Link path normalization", () => {
+    it("should handle links without leading slash", () => {
+      const result = resolveMarkdownLink(
+        "develop/vector-search",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/developer/vector-search");
+    });
+
+    it("should handle links with multiple leading slashes", () => {
+      const result = resolveMarkdownLink(
+        "///develop/vector-search",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/developer/vector-search");
+    });
+
+    it("should handle empty path segments", () => {
+      const result = resolveMarkdownLink(
+        "/develop//vector-search",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/developer/vector-search");
+    });
+  });
+
+  describe("Edge cases", () => {
+    it("should return original link if current page doesn't match any pathPattern", () => {
+      const result = resolveMarkdownLink(
+        "/unknown/path/to/page",
+        "/en/unknown/current/page"
+      );
+      // No matching rule, should return original link
+      expect(result).toBe("/unknown/path/to/page");
+    });
+
+    it("should handle root path links", () => {
+      const result = resolveMarkdownLink("/", "/en/tidb/stable/alert-rules");
+      expect(result).toBe("/");
+    });
+
+    it("should handle single segment links", () => {
+      const result = resolveMarkdownLink(
+        "/page",
+        "/en/tidb/stable/alert-rules"
+      );
+      // Current page /en/tidb/stable/alert-rules matches Rule 3 /{lang}/{repo}/{branch}/{...any}:
+      // - lang = en, repo = tidb, branch = stable, {...any} = alert-rules
+      // Link /page matches /{...any}/{docname} where {...any} is empty, docname = page
+      // Target pattern /{lang}/{repo}/{branch}/{docname} = /en/tidb/stable/page
+      // After defaultLanguage omission: /tidb/stable/page
+      expect(result).toBe("/tidb/stable/page");
+    });
+
+    it("should handle links with special characters", () => {
+      const result = resolveMarkdownLink(
+        "/develop/page-name-with-dashes",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/developer/page-name-with-dashes");
+    });
+  });
+
+  describe("Complex scenarios", () => {
+    it("should resolve nested namespace links correctly", () => {
+      const result = resolveMarkdownLink(
+        "/develop/vector-search/vector-search-data-types/vector-search-data-types-overview",
+        "/en/tidb/stable/alert-rules"
+      );
+      expect(result).toBe("/developer/vector-search-data-types-overview");
+    });
+
+    it("should resolve links from tidbcloud with multiple prefixes", () => {
+      const result = resolveMarkdownLink(
+        "/dedicated/starter/setup/config",
+        "/en/tidbcloud/dedicated/starter"
+      );
+      expect(result).toBe("/tidbcloud/config");
+    });
+
+    it("should resolve links from tidb with deep folder structure", () => {
+      const result = resolveMarkdownLink(
+        "/upgrade/from-v7/to-v8/upgrade-guide",
+        "/en/tidb/stable/upgrade/from-v7"
+      );
+      expect(result).toBe("/tidb/stable/upgrade-guide");
+    });
+  });
+});
diff --git a/gatsby/link-resolver/config.ts b/gatsby/link-resolver/config.ts
new file mode 100644
index 000000000..0f8f989fd
--- /dev/null
+++ b/gatsby/link-resolver/config.ts
@@ -0,0 +1,87 @@
+/**
+ * Default link resolver configuration
+ */
+
+import type { LinkResolverConfig } from "./types";
+
+export const defaultLinkResolverConfig: LinkResolverConfig = {
+  // Default language to omit from resolved URLs
+  defaultLanguage: "en",
+  // Supported languages for parsing currentPageUrl
+  languages: ["en", "zh", "ja"],
+
+  linkMappings: [
+    {
+      linkPattern: "/releases/_index",
+      targetPattern: "/{curLang}/releases/tidb-self-managed",
+    },
+    {
+      linkPattern: "/tidb-cloud/releases/_index",
+      targetPattern: "/{curLang}/releases/tidb-cloud",
+    },
+    {
+      pathPattern: "/{lang}/tidb-in-kubernetes/{branch}/{...any}",
+      linkPattern: "/tidb-in-kubernetes/releases/_index",
+      targetPattern: "/{curLang}/releases/tidb-operator",
+    },
+    // Releases pages (path-based mapping)
+    // Current page: /{lang}/releases/tidb-self-managed
+    // Link: /releases/{docname} -> /{lang}/tidb/stable/{docname}
+    {
+      pathPattern: "/{lang}/releases/tidb-self-managed",
+      linkPattern: "/{...any}/{docname}",
+      targetPattern: "/{lang}/tidb/stable/{docname}",
+    },
+    // Current page: /{lang}/releases/tidb-operator
+    // Link: /releases/{docname} -> /{lang}/tidb-in-kubernetes/dev/{docname}
+    {
+      pathPattern: "/{lang}/releases/tidb-operator",
+      linkPattern: "/{...any}/{docname}",
+      targetPattern: "/{lang}/tidb-in-kubernetes/dev/{docname}",
+    },
+    // Rule 1: Links starting with specific namespaces (direct link mapping)
+    // /{namespace}/{...any}/{docname} -> /{curLang}/{namespace}/{docname}
+    // Special: tidb-cloud -> tidbcloud, develop -> developer
+    {
+      linkPattern: "/{namespace}/{...any}/{docname}",
+      targetPattern: "/{curLang}/{namespace}/{docname}",
+      conditions: {
+        namespace: ["tidb-cloud", "develop", "best-practices", "api", "ai"],
+      },
+      namespaceTransform: {
+        "tidb-cloud": "tidbcloud",
+        develop: "developer",
+      },
+    },
+    // Rule 2: tidbcloud with prefix pages (path-based mapping)
+    // Current page: /{lang}/tidbcloud/{...any}
+    // Link: /{...any}/{docname} -> /{lang}/tidbcloud/{docname}
+    {
+      pathPattern: "/{lang}/tidbcloud/{...any}",
+      linkPattern: "/{...any}/{docname}",
+      targetPattern: "/{lang}/tidbcloud/{docname}",
+    },
+    // Rule 3: developer, best-practices, api, ai namespace in tidb folder
+    // Current page: /{lang}/{namespace}/{...any}
+    // Link: /{...any}/{docname} -> /{lang}/{namespace}/{docname}
+    {
+      pathPattern: `/{lang}/{namespace}/{...any}`,
+      pathConditions: {
+        namespace: ["developer", "best-practices", "api", "ai"],
+      },
+      linkPattern: "/{...any}/{docname}",
+      targetPattern: "/{lang}/tidb/stable/{docname}",
+    },
+    // Rule 4: tidb with branch pages (path-based mapping)
+    // Current page: /{lang}/tidb/{branch}/{...any} (branch is already aliased, e.g., "stable", "v8.5")
+    // Link: /{...any}/{docname} -> /{lang}/tidb/{branch}/{docname}
+    {
+      pathPattern: "/{lang}/{repo}/{branch}/{...any}",
+      pathConditions: {
+        repo: ["tidb", "tidb-in-kubernetes"],
+      },
+      linkPattern: "/{...any}/{docname}",
+      targetPattern: "/{lang}/{repo}/{branch}/{docname}",
+    },
+  ],
+};
diff --git a/gatsby/link-resolver/index.ts b/gatsby/link-resolver/index.ts
new file mode 100644
index 000000000..ffba02eed
--- /dev/null
+++ b/gatsby/link-resolver/index.ts
@@ -0,0 +1,16 @@
+/**
+ * Link Resolver - Main entry point
+ *
+ * This module provides utilities for:
+ * - Resolving markdown links within articles based on mapping rules
+ * - Context-based link resolution based on current page URL
+ */
+
+// Export types
+export type { LinkMappingRule, LinkResolverConfig } from "./types";
+
+// Export link resolver functions
+export { resolveMarkdownLink, clearLinkResolverCache } from "./link-resolver";
+
+// Export default configuration
+export { defaultLinkResolverConfig } from "./config";
diff --git a/gatsby/link-resolver/link-resolver.ts b/gatsby/link-resolver/link-resolver.ts
new file mode 100644
index 000000000..f499d28c8
--- /dev/null
+++ b/gatsby/link-resolver/link-resolver.ts
@@ -0,0 +1,238 @@
+/**
+ * Link resolver for transforming markdown links within articles
+ */
+
+import { matchPattern, applyPattern } from "../url-resolver/pattern-matcher";
+import { defaultUrlResolverConfig } from "../url-resolver/config";
+import { defaultLinkResolverConfig } from "./config";
+
+// Cache for resolveMarkdownLink results
+// Key: linkPath + currentPageUrl
+// Value: resolved URL or original linkPath
+const linkResolverCache = new Map<string, string>();
+
+// Cache for parseLinkPath results
+// Key: linkPath
+// Value: parsed segments array
+const parsedLinkPathCache = new Map<string, string[]>();
+
+/**
+ * Parse link path into segments
+ */
+function parseLinkPath(linkPath: string): string[] {
+  // Check cache first
+  const cached = parsedLinkPathCache.get(linkPath);
+  if (cached !== undefined) {
+    return cached;
+  }
+
+  // Remove leading and trailing slashes, then split
+  const normalized = linkPath.replace(/^\/+|\/+$/g, "");
+  if (!normalized) {
+    parsedLinkPathCache.set(linkPath, []);
+    return [];
+  }
+  const segments = normalized.split("/").filter((s) => s.length > 0);
+  parsedLinkPathCache.set(linkPath, segments);
+  return segments;
+}
+
+/**
+ * Check if conditions are met
+ */
+function checkConditions(
+  conditions: Record<string, string[]> | undefined,
+  variables: Record<string, string>
+): boolean {
+  if (!conditions) return true;
+
+  for (const [variableName, allowedValues] of Object.entries(conditions)) {
+    const variableValue = variables[variableName];
+    if (variableValue && allowedValues) {
+      if (!allowedValues.includes(variableValue)) {
+        return false;
+      }
+    }
+  }
+
+  return true;
+}
+
+/**
+ * Resolve markdown link based on mapping rules
+ * Uses global defaultLinkResolverConfig and defaultUrlResolverConfig
+ *
+ * @param linkPath - The markdown link path to resolve
+ * @param currentPageUrl - The current page URL for context-based resolution
+ */
+export function resolveMarkdownLink(
+  linkPath: string,
+  currentPageUrl: string
+): string | null {
+  // Early exit for external links and anchor links (most common case)
+  if (!linkPath || linkPath.startsWith("http") || linkPath.startsWith("#")) {
+    return linkPath;
+  }
+
+  // Check cache
+  const cacheKey = `${linkPath}::${currentPageUrl}`;
+  const cached = linkResolverCache.get(cacheKey);
+  if (cached !== undefined) {
+    return cached;
+  }
+
+  const linkConfig = defaultLinkResolverConfig;
+  const urlConfig = defaultUrlResolverConfig;
+
+  // Normalize link path
+  const normalizedLink = linkPath.startsWith("/") ? linkPath : "/" + linkPath;
+  const linkSegments = parseLinkPath(normalizedLink);
+
+  // Early exit for empty links
+  if (linkSegments.length === 0) {
+    linkResolverCache.set(cacheKey, linkPath);
+    return linkPath;
+  }
+
+  // Process all rules in order (first match wins)
+  const currentPageSegments = parseLinkPath(currentPageUrl);
+
+  // Determine current language from currentPageUrl
+  // If currentPageUrl does not include a language prefix, assume defaultLanguage is omitted.
+  const defaultLanguage = linkConfig.defaultLanguage || urlConfig.defaultLanguage;
+  const supportedLanguages = linkConfig.languages || ["en", "zh", "ja"];
+
+  const firstSegment = currentPageSegments.length > 0 ? currentPageSegments[0] : "";
+  const hasLanguagePrefix =
+    firstSegment.length > 0 && supportedLanguages.includes(firstSegment);
+  const curLang = hasLanguagePrefix ? firstSegment : defaultLanguage || "";
+  const currentPageSegmentsWithDefaultLang =
+    !hasLanguagePrefix && curLang
+      ? [curLang, ...currentPageSegments]
+      : currentPageSegments;
+
+  for (const rule of linkConfig.linkMappings) {
+    let variables: Record<string, string> | null = null;
+
+    // Check if this is a direct link mapping (linkPattern only) or path-based mapping (pathPattern + linkPattern)
+    if (!rule.pathPattern) {
+      // Direct link mapping: match link path directly
+      variables = matchPattern(rule.linkPattern, linkSegments);
+      if (!variables) {
+        continue;
+      }
+
+      // Add curLang as default variable
+      if (curLang) {
+        variables.curLang = curLang;
+      }
+
+      // Check conditions
+      if (rule.conditions) {
+        let conditionsMet = true;
+        for (const [varName, allowedValues] of Object.entries(
+          rule.conditions
+        )) {
+          const varValue = variables[varName];
+          if (varValue && allowedValues) {
+            if (!allowedValues.includes(varValue)) {
+              conditionsMet = false;
+              break;
+            }
+          }
+        }
+        if (!conditionsMet) {
+          continue;
+        }
+      }
+
+      // Apply namespace transformation if needed
+      if (rule.namespaceTransform && variables.namespace) {
+        const transformed = rule.namespaceTransform[variables.namespace];
+        if (transformed) {
+          variables.namespace = transformed;
+        }
+      }
+    } else {
+      // Path-based mapping: match current page path first, then link path
+      let pageVars = matchPattern(rule.pathPattern, currentPageSegments);
+      if (
+        !pageVars &&
+        currentPageSegmentsWithDefaultLang !== currentPageSegments
+      ) {
+        pageVars = matchPattern(rule.pathPattern, currentPageSegmentsWithDefaultLang);
+      }
+      if (!pageVars) {
+        continue;
+      }
+
+      // Check path conditions (if specified, check against page variables)
+      if (rule.pathConditions) {
+        if (!checkConditions(rule.pathConditions, pageVars)) {
+          continue;
+        }
+      }
+
+      // Check conditions (if specified, check against page variables as fallback)
+      if (rule.conditions && !rule.pathConditions) {
+        if (!checkConditions(rule.conditions, pageVars)) {
+          continue;
+        }
+      }
+
+      // Match link pattern
+      const linkVars = matchPattern(rule.linkPattern, linkSegments);
+      if (!linkVars) {
+        continue;
+      }
+
+      // Merge current page variables with link variables
+      variables = { ...pageVars, ...linkVars };
+
+      // Add curLang as default variable
+      if (curLang) {
+        variables.curLang = curLang;
+      }
+
+      // Set default values for missing variables
+      // For tidb pages without lang prefix, default to "en"
+      if (pageVars.repo === "tidb" && !variables.lang && defaultLanguage) {
+        variables.lang = defaultLanguage;
+      }
+    }
+
+    // Build target URL
+    const targetUrl = applyPattern(rule.targetPattern, variables, urlConfig);
+
+    // Handle default language and trailing slash
+    let result = targetUrl;
+    // Use linkConfig.defaultLanguage if available, otherwise fallback to urlConfig.defaultLanguage
+    const defaultLanguageToOmit = defaultLanguage;
+    if (
+      defaultLanguageToOmit &&
+      result.startsWith(`/${defaultLanguageToOmit}/`)
+    ) {
+      result = result.replace(`/${defaultLanguageToOmit}/`, "/");
+    }
+    if (urlConfig.trailingSlash === "never") {
+      result = result.replace(/\/$/, "");
+    }
+
+    // Cache the result
+    linkResolverCache.set(cacheKey, result);
+    return result;
+  }
+
+  // No match found, return original link
+  // Cache the original linkPath
+  linkResolverCache.set(cacheKey, linkPath);
+  return linkPath;
+}
+
+/**
+ * Clear link resolver cache (useful for testing or when config changes)
+ */
+export function clearLinkResolverCache(): void {
+  linkResolverCache.clear();
+  parsedLinkPathCache.clear();
+}
diff --git a/gatsby/link-resolver/types.ts b/gatsby/link-resolver/types.ts
new file mode 100644
index 000000000..16a183bb9
--- /dev/null
+++ b/gatsby/link-resolver/types.ts
@@ -0,0 +1,33 @@
+/**
+ * Type definitions for link resolver
+ */
+
+export interface LinkMappingRule {
+  // Pattern to match current page path (for path-based mapping, optional)
+  // e.g., "/tidbcloud/{...any}" or "/{lang}/{repo}/{branch:branch-alias}/{...any}"
+  // If not specified, this is a direct link mapping
+  pathPattern?: string;
+  // Pattern to match link path
+  // e.g., "/{namespace}/{...any}/{docname}" or "/{...any}/{docname}"
+  linkPattern: string;
+  // Target URL pattern
+  // e.g., "/{namespace}/{docname}" or "/{lang}/tidbcloud/{docname}"
+  targetPattern: string;
+  // Conditions for this rule to apply (checked against link variables or merged variables)
+  conditions?: Record<string, string[]>;
+  // Conditions for current page path variables (checked against variables extracted from pathPattern)
+  pathConditions?: Record<string, string[]>;
+  // Namespace transformation (e.g., "tidb-cloud" -> "tidbcloud")
+  namespaceTransform?: Record<string, string>;
+}
+
+export interface LinkResolverConfig {
+  // Link mapping rules (ordered, first match wins)
+  // Rules can be either direct link mappings (linkPattern only) or path-based mappings (pathPattern + linkPattern)
+  linkMappings: LinkMappingRule[];
+  // Default language to omit from resolved URLs (e.g., "en" -> /tidb/stable instead of /en/tidb/stable)
+  defaultLanguage?: string;
+  // Supported languages for parsing currentPageUrl.
+  // If currentPageUrl does not start with one of these, resolver assumes defaultLanguage is omitted.
+  languages?: string[];
+}
diff --git a/gatsby/path.ts b/gatsby/path/index.ts
similarity index 80%
rename from gatsby/path.ts
rename to gatsby/path/index.ts
index 9e5ed6952..fd3c88c0e 100644
--- a/gatsby/path.ts
+++ b/gatsby/path/index.ts
@@ -1,6 +1,12 @@
-import { Locale, Repo, PathConfig, CloudPlan } from "../src/shared/interface";
-import CONFIG from "../docs/docs.json";
-
+import {
+  Locale,
+  Repo,
+  PathConfig,
+  CloudPlan,
+} from "../../src/shared/interface";
+import CONFIG from "../../docs/docs.json";
+
+// @deprecated, use calculateFileUrl instead
 export function generateUrl(filename: string, config: PathConfig) {
   const lang = config.locale === Locale.en ? "" : `/${config.locale}`;
 
@@ -27,16 +33,6 @@ export function generatePdfUrl(config: PathConfig) {
   }-manual.pdf`;
 }
 
-export function generateNav(config: PathConfig) {
-  return `${config.locale}/${config.repo}/${config.branch}/TOC`;
-}
-export function generateStarterNav(config: PathConfig) {
-  return `${config.locale}/${config.repo}/${config.branch}/TOC-tidb-cloud-starter`;
-}
-export function generateEssentialNav(config: PathConfig) {
-  return `${config.locale}/${config.repo}/${config.branch}/TOC-tidb-cloud-essential`;
-}
-
 export function generateConfig(slug: string): {
   config: PathConfig;
   filePath: string;
@@ -60,10 +56,12 @@ export function generateConfig(slug: string): {
 
   // only index page should have a prefix, e.g. /tidbcloud/starter/
   if (repo === Repo.tidbcloud && !name && !slug.includes("dedicated/")) {
-    const simplePrefixes = ["starter", "essential", "premium"];
-    prefix = simplePrefixes.find((p) => slug.includes(`${p}/`)) as
-      | CloudPlan
-      | undefined;
+    const simplePrefixes = [
+      CloudPlan.Starter,
+      CloudPlan.Essential,
+      CloudPlan.Premium,
+    ] as const;
+    prefix = simplePrefixes.find((p) => slug.includes(`${p}/`));
   }
 
   return {
@@ -123,3 +121,9 @@ export function getRepo(config: PathConfig) {
 
   throw new Error(`no ${config.locale} in repo ${config.repo}`);
 }
+
+export function generateNavTOCPath(config: PathConfig, postSlug: string) {
+  return `${config.locale}/${config.repo}/${config.branch}/TOC${
+    postSlug ? `-${postSlug}` : ""
+  }`;
+}
diff --git a/gatsby/plugin/content/index.ts b/gatsby/plugin/content/index.ts
index fc37babfb..6750ba89d 100644
--- a/gatsby/plugin/content/index.ts
+++ b/gatsby/plugin/content/index.ts
@@ -1,30 +1,32 @@
-import visit from 'unist-util-visit'
-import type { Root, Link, Blockquote } from 'mdast'
+import visit from "unist-util-visit";
+import type { Root, Link, Blockquote } from "mdast";
+import { calculateFileUrl } from "../../url-resolver";
+import { resolveMarkdownLink } from "../../link-resolver";
 
 function textToJsx(text: string) {
   switch (text) {
-    case 'Note:':
-    case '注意：':
-    case 'Note':
-    case '注意':
-      return 'Note'
-    case 'Warning:':
-    case '警告：':
-    case 'Warning':
-    case '警告':
-      return 'Warning'
-    case 'Tip:':
-    case '建议：':
-    case 'Tip':
-    case '建议':
-      return 'Tip'
-    case 'Important:':
-    case '重要：':
-    case 'Important':
-    case '重要':
-      return 'Important'
+    case "Note:":
+    case "注意：":
+    case "Note":
+    case "注意":
+      return "Note";
+    case "Warning:":
+    case "警告：":
+    case "Warning":
+    case "警告":
+      return "Warning";
+    case "Tip:":
+    case "建议：":
+    case "Tip":
+    case "建议":
+      return "Tip";
+    case "Important:":
+    case "重要：":
+    case "Important":
+    case "重要":
+      return "Important";
     default:
-      throw new Error('unreachable')
+      throw new Error("unreachable");
   }
 }
 
@@ -32,86 +34,89 @@ module.exports = function ({
   markdownAST,
   markdownNode,
 }: {
-  markdownAST: Root
-  markdownNode: { fileAbsolutePath: string }
+  markdownAST: Root;
+  markdownNode: { fileAbsolutePath: string };
 }) {
+  const currentFileUrl = calculateFileUrl(markdownNode.fileAbsolutePath) || "";
+
   visit(markdownAST, (node: any) => {
     if (Array.isArray(node.children)) {
       node.children = node.children.flatMap((node: any) => {
-        if (node.type === 'link' && !node.url.startsWith('#')) {
-          const ele = node as Link
+        if (node.type === "link" && !node.url.startsWith("#")) {
+          const ele = node as Link;
 
-          if (ele.url.startsWith('http')) {
+          if (ele.url.startsWith("http")) {
             return [
               {
-                type: 'jsx',
+                type: "jsx",
                 value: `<a href="${ele.url}" target="_blank" referrerPolicy="no-referrer-when-downgrade">`,
               },
               ...node.children,
-              { type: 'jsx', value: '</a>' },
-            ]
+              { type: "jsx", value: "</a>" },
+            ];
           } else {
-            const urlSeg = ele.url.split('/')
-            const fileName = urlSeg[urlSeg.length - 1].replace('.md', '')
-            const path = markdownNode.fileAbsolutePath.endsWith('_index.md')
-              ? fileName
-              : '../' + fileName
+            // Resolve markdown link using link-resolver
+            const resolvedPath = resolveMarkdownLink(
+              ele.url.replace(".md", ""),
+              currentFileUrl
+            );
+
             return [
               {
-                type: 'jsx',
-                value: `<Link to="${path}">`,
+                type: "jsx",
+                value: `<Link to="${resolvedPath}">`,
               },
               ...node.children,
-              { type: 'jsx', value: '</Link>' },
-            ]
+              { type: "jsx", value: "</Link>" },
+            ];
           }
         }
 
-        if (node.type === 'blockquote') {
-          const ele = node as Blockquote
-          const first = ele.children[0]
+        if (node.type === "blockquote") {
+          const ele = node as Blockquote;
+          const first = ele.children[0];
           if (
-            first?.type === 'paragraph' &&
-            first.children?.[0].type === 'strong' &&
-            first.children[0].children?.[0].type === 'text'
+            first?.type === "paragraph" &&
+            first.children?.[0].type === "strong" &&
+            first.children[0].children?.[0].type === "text"
           ) {
-            const text = first.children[0].children[0].value
+            const text = first.children[0].children[0].value;
             switch (text) {
-              case 'Note:':
+              case "Note:":
               // https://github.com/orgs/community/discussions/16925
-              case 'Note':
-              case '注意：':
-              case '注意':
-              case 'Warning:':
-              case 'Warning':
-              case '警告：':
-              case '警告':
-              case 'Tip:':
-              case 'Tip':
-              case '建议：':
-              case '建议':
-              case 'Important:':
-              case 'Important':
-              case '重要：':
-              case '重要': {
-                const children = node.children.slice(1)
-                const jsx = textToJsx(text)
+              case "Note":
+              case "注意：":
+              case "注意":
+              case "Warning:":
+              case "Warning":
+              case "警告：":
+              case "警告":
+              case "Tip:":
+              case "Tip":
+              case "建议：":
+              case "建议":
+              case "Important:":
+              case "Important":
+              case "重要：":
+              case "重要": {
+                const children = node.children.slice(1);
+                const jsx = textToJsx(text);
                 return [
-                  { type: 'jsx', value: `<${jsx}>` },
+                  { type: "jsx", value: `<${jsx}>` },
                   ...children,
-                  { type: 'jsx', value: `</${jsx}>` },
-                ]
+                  { type: "jsx", value: `</${jsx}>` },
+                ];
               }
 
               default:
-                return ele
+                return ele;
             }
           }
-          return ele
+          return ele;
         }
 
-        return node
-      })
+        return node;
+      });
     }
-  })
-}
+  });
+};
diff --git a/gatsby/toc-filter.ts b/gatsby/toc-filter.ts
index d7361f7fc..2d1a0e663 100644
--- a/gatsby/toc-filter.ts
+++ b/gatsby/toc-filter.ts
@@ -1,9 +1,19 @@
 import { mdxAstToToc, TocQueryData } from "./toc";
 import { generateConfig } from "./path";
+import { calculateFileUrl } from "./url-resolver";
+import { isIgnoredTocRelativePath } from "./toc-ignore";
 
 // Whitelist of files that should always be built regardless of TOC content
 const WHITELIST = [""];
 
+type TocFilesMap = Map<string, Set<string>>;
+type TocNamesByFileMap = Map<string, Map<string, Set<string>>>;
+
+export interface TocFilesResult {
+  tocFilesMap: TocFilesMap;
+  tocNamesByFileMap: TocNamesByFileMap;
+}
+
 /**
  * Extract file paths from TOC navigation structure
  */
@@ -37,13 +47,36 @@ export function extractFilesFromToc(nav: any[]): string[] {
   return [...new Set(files)];
 }
 
+function getTocNameFromRelativePath(relativePath: string): string {
+  const filename = relativePath.split("/").pop() || relativePath;
+  return filename.replace(/\.md$/, "");
+}
+
+function sortTocNames(tocNames: Iterable<string>): string[] {
+  const priority = [
+    "TOC",
+    "TOC-tidb-cloud-starter",
+    "TOC-tidb-cloud-essential",
+    "TOC-tidb-cloud-premium",
+  ];
+  const priorityIndex = new Map(priority.map((name, idx) => [name, idx]));
+  return [...new Set(tocNames)].sort((a, b) => {
+    const ai = priorityIndex.get(a);
+    const bi = priorityIndex.get(b);
+    if (ai != null && bi != null) return ai - bi;
+    if (ai != null) return -1;
+    if (bi != null) return 1;
+    return a.localeCompare(b);
+  });
+}
+
 /**
  * Get files that should be built based on TOC content
  * Returns a Map where key is "locale/repo/version" and value is Set of file names
  */
 export async function getFilesFromTocs(
   graphql: any
-): Promise<Map<string, Set<string>>> {
+): Promise<TocFilesResult> {
   const tocQuery = await graphql(`
     {
       allMdx(filter: { fileAbsolutePath: { regex: "/TOC.*md$/" } }) {
@@ -66,26 +99,39 @@ export async function getFilesFromTocs(
   }
 
   const tocNodes = tocQuery.data!.allMdx.nodes;
-  const tocFilesMap = new Map<string, Set<string>>();
+  const tocFilesMap: TocFilesMap = new Map();
+  const tocNamesByFileMap: TocNamesByFileMap = new Map();
 
-  // TODO: Remove this filter once premium is public. Currently filtering out TOC-tidb-cloud-premium.md
   const filteredTocNodes = tocNodes.filter(
-    (node: TocQueryData["allMdx"]["nodes"][0]) => {
-      const relativePath = node.parent?.relativePath || "";
-      return !relativePath.includes("TOC-tidb-cloud-premium.md");
-    }
+    (node: TocQueryData["allMdx"]["nodes"][0]) =>
+      !isIgnoredTocRelativePath(node.parent?.relativePath || "")
   );
 
   filteredTocNodes.forEach((node: TocQueryData["allMdx"]["nodes"][0]) => {
     const { config } = generateConfig(node.slug);
-    const toc = mdxAstToToc(node.mdxAST.children, config);
+    const tocPath = calculateFileUrl(node.slug);
+    const toc = mdxAstToToc(node.mdxAST.children, tocPath || node.slug);
     const files = extractFilesFromToc(toc);
+    const tocName = getTocNameFromRelativePath(node.parent.relativePath);
 
     // Create a key for this specific locale/repo/version combination
     const key = `${config.locale}/${config.repo}/${
       config.version || config.branch
     }`;
 
+    // Track TOC membership for each file (normalized by removing anchor)
+    if (!tocNamesByFileMap.has(key)) {
+      tocNamesByFileMap.set(key, new Map());
+    }
+    const fileToTocs = tocNamesByFileMap.get(key)!;
+    files.forEach((file) => {
+      const normalizedFile = file.split("#")[0];
+      if (!fileToTocs.has(normalizedFile)) {
+        fileToTocs.set(normalizedFile, new Set());
+      }
+      fileToTocs.get(normalizedFile)!.add(tocName);
+    });
+
     // If key already exists, take union with existing files
     if (tocFilesMap.has(key)) {
       const existingFiles = tocFilesMap.get(key)!;
@@ -102,7 +148,7 @@ export async function getFilesFromTocs(
     }
   });
 
-  return tocFilesMap;
+  return { tocFilesMap, tocNamesByFileMap };
 }
 
 /**
@@ -111,18 +157,21 @@ export async function getFilesFromTocs(
  */
 export function filterNodesByToc(
   nodes: any[],
-  tocFilesMap: Map<string, Set<string>>
+  tocFilesMap: TocFilesMap,
+  tocNamesByFileMap: TocNamesByFileMap
 ): any[] {
   const skippedNodes: Map<string, string[]> = new Map();
   const filteredNodes = nodes.filter((node) => {
     // Check if file is in whitelist - if so, always build it
     if (WHITELIST.includes(node.name)) {
+      node.tocNames = [];
       return true;
     }
 
     // Filter nodes based on TOC content
     if (tocFilesMap.size === 0) {
       // If no TOC files found, build all files (fallback)
+      node.tocNames = [];
       return true;
     }
 
@@ -159,6 +208,12 @@ export function filterNodesByToc(
         skippedNodes.set(key, []);
       }
       skippedNodes.get(key)!.push(node.name);
+      node.tocNames = [];
+    }
+
+    if (isIncluded) {
+      const tocNamesSet = tocNamesByFileMap.get(key)?.get(fullPath);
+      node.tocNames = tocNamesSet ? sortTocNames(tocNamesSet) : [];
     }
     return isIncluded;
   });
diff --git a/gatsby/toc-ignore.ts b/gatsby/toc-ignore.ts
new file mode 100644
index 000000000..a9a036339
--- /dev/null
+++ b/gatsby/toc-ignore.ts
@@ -0,0 +1,28 @@
+function parseCommaSeparatedEnv(name: string): string[] {
+  const raw = process.env[name];
+  if (!raw) return [];
+  return raw
+    .split(",")
+    .map((v) => v.trim())
+    .filter(Boolean);
+}
+
+const DEFAULT_IGNORED_TOC_RELATIVE_PATH_SUBSTRINGS = [
+  // TODO: Remove this filter once premium is public.
+  "TOC-tidb-cloud-premium.md",
+  // Temporarily ignore this TOC during build.
+  "TOC-pingkai.md",
+];
+
+const IGNORED_TOC_RELATIVE_PATH_SUBSTRINGS = [
+  ...DEFAULT_IGNORED_TOC_RELATIVE_PATH_SUBSTRINGS,
+  ...parseCommaSeparatedEnv("WEBSITE_IGNORED_TOC_RELATIVE_PATH_SUBSTRINGS"),
+];
+
+export function isIgnoredTocRelativePath(relativePath: string): boolean {
+  if (!relativePath) return false;
+  return IGNORED_TOC_RELATIVE_PATH_SUBSTRINGS.some(
+    (substr) => substr && relativePath.includes(substr)
+  );
+}
+
diff --git a/gatsby/toc-namespace/index.ts b/gatsby/toc-namespace/index.ts
new file mode 100644
index 000000000..7a92cd350
--- /dev/null
+++ b/gatsby/toc-namespace/index.ts
@@ -0,0 +1,197 @@
+import { Locale, Repo, TOCNamespace } from "../../src/shared/interface";
+import CONFIG from "../../docs/docs.json";
+
+/**
+ * Namespace matching rule configuration
+ */
+export interface NamespaceRule {
+  /** Target namespace to return when matched */
+  namespace: TOCNamespace;
+  /** Repo to match against (optional, matches all if not specified) */
+  repo?: Repo | Repo[];
+  /** Branch to match against (optional, matches all if not specified) */
+  branch?: string | string[] | ((branch: string) => boolean);
+  /** Folder name to match against (optional, matches all if not specified) */
+  folder?: string | string[];
+  /** Rest path segments to match against (optional) */
+  restPath?: string | string[] | ((rest: string[]) => boolean);
+  /** Minimum number of rest path segments required */
+  minRestLength?: number;
+}
+
+/**
+ * Configuration for shared namespace rules
+ * Add new rules here to extend namespace matching logic
+ */
+const SHARED_NAMESPACE_RULES: NamespaceRule[] = [
+  {
+    namespace: TOCNamespace.AI,
+    repo: Repo.tidb,
+    branch: CONFIG.docs.tidb.stable,
+    folder: "ai",
+    minRestLength: 1,
+  },
+  {
+    namespace: TOCNamespace.Develop,
+    repo: Repo.tidb,
+    branch: CONFIG.docs.tidb.stable,
+    folder: "develop",
+    minRestLength: 1,
+  },
+  {
+    namespace: TOCNamespace.BestPractices,
+    repo: Repo.tidb,
+    branch: CONFIG.docs.tidb.stable,
+    folder: "best-practices",
+    minRestLength: 1,
+  },
+  {
+    namespace: TOCNamespace.API,
+    repo: Repo.tidb,
+    branch: CONFIG.docs.tidb.stable,
+    folder: "api",
+    minRestLength: 1,
+  },
+  {
+    namespace: TOCNamespace.TiDBReleases,
+    repo: Repo.tidb,
+    branch: CONFIG.docs.tidb.stable,
+    folder: "releases",
+    minRestLength: 1,
+  },
+  {
+    namespace: TOCNamespace.TidbCloudReleases,
+    repo: Repo.tidbcloud,
+    folder: "tidb-cloud",
+    restPath: (rest) => rest[0] === "releases",
+  },
+  {
+    namespace: TOCNamespace.TiDBInKubernetesReleases,
+    repo: Repo.operator,
+    branch: "main",
+    folder: "releases",
+    minRestLength: 1,
+  },
+  {
+    namespace: TOCNamespace.TiDB,
+    repo: Repo.tidb,
+  },
+  {
+    namespace: TOCNamespace.TiDBCloud,
+    repo: Repo.tidbcloud,
+  },
+  {
+    namespace: TOCNamespace.TiDBInKubernetes,
+    repo: Repo.operator,
+  },
+];
+
+/**
+ * Check if a value matches the rule condition
+ */
+function matchesValue(
+  value: string | undefined,
+  condition?: string | string[] | ((val: string) => boolean)
+): boolean {
+  if (condition === undefined) {
+    return true;
+  }
+
+  if (typeof condition === "function") {
+    return value !== undefined && condition(value);
+  }
+
+  if (typeof condition === "string") {
+    return value === condition;
+  }
+
+  return condition.includes(value!);
+}
+
+/**
+ * Check if an array matches the rule condition
+ */
+function matchesArray(
+  value: string[],
+  condition?: string | string[] | ((arr: string[]) => boolean)
+): boolean {
+  if (condition === undefined) {
+    return true;
+  }
+
+  if (typeof condition === "function") {
+    return condition(value);
+  }
+
+  if (typeof condition === "string") {
+    return value.includes(condition);
+  }
+
+  return condition.some((c) => value.includes(c));
+}
+
+/**
+ * Check if a rule matches the given path segments
+ */
+function matchesRule(
+  rule: NamespaceRule,
+  repo: Repo,
+  branch: string,
+  folder: string | undefined,
+  rest: string[]
+): boolean {
+  // Check repo
+  if (rule.repo !== undefined) {
+    const repos = Array.isArray(rule.repo) ? rule.repo : [rule.repo];
+    if (!repos.includes(repo)) {
+      return false;
+    }
+  }
+
+  // Check branch
+  if (!matchesValue(branch, rule.branch)) {
+    return false;
+  }
+
+  // Check folder
+  if (!matchesValue(folder, rule.folder)) {
+    return false;
+  }
+
+  // Check minimum rest length
+  if (rule.minRestLength !== undefined && rest.length < rule.minRestLength) {
+    return false;
+  }
+
+  // Check rest path
+  if (rule.restPath !== undefined) {
+    if (!matchesArray(rest, rule.restPath)) {
+      return false;
+    }
+  }
+
+  return true;
+}
+
+/**
+ * Get shared namespace from slug based on configured rules
+ * Returns the first matching namespace or empty string if no match
+ */
+export const getTOCNamespace = (slug: string): TOCNamespace | undefined => {
+  const [locale, repo, branch, folder, ...rest] = slug.split("/") as [
+    Locale,
+    Repo,
+    string,
+    string,
+    ...string[]
+  ];
+
+  // Find the first matching rule
+  for (const rule of SHARED_NAMESPACE_RULES) {
+    if (matchesRule(rule, repo, branch, folder, rest)) {
+      return rule.namespace;
+    }
+  }
+
+  return;
+};
diff --git a/gatsby/toc.ts b/gatsby/toc.ts
index 96cde833e..fef4f3d35 100644
--- a/gatsby/toc.ts
+++ b/gatsby/toc.ts
@@ -9,8 +9,9 @@ import {
   Heading,
 } from "mdast";
 
-import { RepoNav, RepoNavLink, PathConfig } from "../src/shared/interface";
-import { generateUrl } from "./path";
+import { RepoNav, RepoNavLink } from "../src/shared/interface";
+import { calculateFileUrl } from "./url-resolver";
+import { resolveMarkdownLink } from "./link-resolver";
 
 const SKIP_MODE_HEADING = "_BUILD_ALLOWLIST";
 
@@ -82,11 +83,12 @@ export interface TocQueryData {
 
 export function mdxAstToToc(
   ast: Content[],
-  tocConfig: PathConfig,
+  tocSlug: string,
   prefixId = `0`,
   filterWhitelist = false
 ): RepoNav {
   const filteredAst = filterWhitelist ? filterWhitelistContent(ast) : ast;
+  const tocPath = calculateFileUrl(tocSlug) || "";
 
   return filteredAst
     .filter(
@@ -95,7 +97,7 @@ export function mdxAstToToc(
     )
     .map((node, idx) => {
       if (node.type === "list") {
-        return handleList(node.children, tocConfig, `${prefixId}-${idx}`);
+        return handleList(node.children, tocPath, `${prefixId}-${idx}`);
       } else {
         return handleHeading((node as Heading).children, `${prefixId}-${idx}`);
       }
@@ -103,15 +105,11 @@ export function mdxAstToToc(
     .flat();
 }
 
-function handleList(ast: ListItem[], tocConfig: PathConfig, prefixId = `0`) {
+function handleList(ast: ListItem[], tocPath: string, prefixId = `0`) {
   return ast.map((node, idx) => {
     const content = node.children as [Paragraph, List | undefined];
     if (content.length > 0 && content.length <= 2) {
-      const ret = getContentFromLink(
-        content[0],
-        tocConfig,
-        `${prefixId}-${idx}`
-      );
+      const ret = getContentFromLink(content[0], tocPath, `${prefixId}-${idx}`);
 
       if (content[1]) {
         const list = content[1];
@@ -121,11 +119,7 @@ function handleList(ast: ListItem[], tocConfig: PathConfig, prefixId = `0`) {
           );
         }
 
-        ret.children = handleList(
-          list.children,
-          tocConfig,
-          `${prefixId}-${idx}`
-        );
+        ret.children = handleList(list.children, tocPath, `${prefixId}-${idx}`);
       }
 
       return ret;
@@ -152,7 +146,7 @@ function handleHeading(ast: PhrasingContent[], id = `0`): RepoNavLink[] {
 
 function getContentFromLink(
   content: Paragraph,
-  tocConfig: PathConfig,
+  tocPath: string,
   id: string
 ): RepoNavLink {
   if (content.type !== "paragraph" || content.children.length === 0) {
@@ -195,12 +189,10 @@ function getContentFromLink(
       };
     }
 
-    const urlSegs = child.url.split("/");
-    let filename = urlSegs[urlSegs.length - 1].replace(".md", "");
-
     return {
       type: "nav",
-      link: generateUrl(filename, tocConfig),
+      link:
+        resolveMarkdownLink(child.url.replace(".md", ""), tocPath || "") || "",
       content,
       tag,
       id,
diff --git a/gatsby/url-resolver/README.md b/gatsby/url-resolver/README.md
new file mode 100644
index 000000000..e9480a372
--- /dev/null
+++ b/gatsby/url-resolver/README.md
@@ -0,0 +1,346 @@
+# URL Resolver
+
+## Overview
+
+The URL Resolver is a core module that maps source file paths to published URLs during the Gatsby build process. It provides a flexible, pattern-based configuration system for transforming file paths into clean, SEO-friendly URLs.
+
+## Purpose
+
+The URL Resolver serves the following purposes:
+
+1. **Path Transformation**: Converts source file paths (e.g., `/docs/markdown-pages/en/tidb/master/alert-rules.md`) into published URLs (e.g., `/tidb/dev/alert-rules`)
+2. **Branch Aliasing**: Maps internal branch names (e.g., `master`, `release-8.5`) to display versions (e.g., `dev`, `v8.5`)
+3. **Namespace Handling**: Handles special namespaces like `developer` (source folder `develop`), `best-practices`, `api`, and `releases` with custom URL structures
+4. **Default Language Omission**: Optionally omits the default language prefix (e.g., `/en/`) from URLs
+5. **Trailing Slash Control**: Configures trailing slash behavior (`always`, `never`, or `auto`)
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { calculateFileUrl } from "../../gatsby/url-resolver";
+
+// Calculate URL from absolute file path
+const url = calculateFileUrl(
+  "/path/to/docs/markdown-pages/en/tidb/master/alert-rules.md",
+  true // omitDefaultLanguage: omit /en/ prefix for default language
+);
+// Result: "/tidb/dev/alert-rules"
+
+// Calculate URL from slug format (relative path)
+const url2 = calculateFileUrl("en/tidb/master/alert-rules", true);
+// Result: "/tidb/dev/alert-rules"
+```
+
+### Usage in Gatsby
+
+The URL Resolver is used in `gatsby/create-pages/create-docs.ts` to generate page URLs:
+
+```typescript
+import { calculateFileUrl } from "../../gatsby/url-resolver";
+
+nodes.forEach((node) => {
+  // node.slug is in format: "en/tidb/master/alert-rules"
+  const path = calculateFileUrl(node.slug, true);
+
+  if (!path) {
+    console.info(`Failed to calculate URL for ${node.slug}`);
+    return;
+  }
+
+  createPage({
+    path,
+    component: template,
+    context: { /* ... */ },
+  });
+});
+```
+
+## Configuration
+
+### Configuration Structure
+
+The URL Resolver configuration is defined in `gatsby/url-resolver/config.ts`:
+
+```typescript
+export const defaultUrlResolverConfig: UrlResolverConfig = {
+  sourceBasePath: path.resolve(__dirname, "../../docs/markdown-pages"),
+  defaultLanguage: "en",
+  trailingSlash: "never",
+
+  pathMappings: [
+    // Rules are evaluated in order, first match wins
+    {
+      sourcePattern: "/{lang}/tidb/{branch}/{...folders}/{filename}",
+      targetPattern: "/{lang}/tidb/{branch:branch-alias-tidb}/{filename}",
+      filenameTransform: {
+        ignoreIf: ["_index", "_docHome"],
+      },
+    },
+    // ... more rules
+  ],
+
+  aliases: {
+    "branch-alias-tidb": {
+      mappings: {
+        master: "dev",
+        "release-*": "v*", // Wildcard pattern
+      },
+    },
+  },
+};
+```
+
+### `UrlResolverConfig` Options
+
+- `sourceBasePath` (`string`): Base directory of the source markdown files. Used by `parseSourcePath()` to convert absolute file paths into slug-like relative paths.
+- `pathMappings` (`PathMappingRule[]`): Ordered mapping rules (first match wins).
+  - `sourcePattern` (`string`): Pattern to match the parsed source path (supports `{var}` and `{...var}` variables).
+  - `targetPattern` (`string`): Pattern to generate the published URL. Supports alias syntax like `{branch:branch-alias-tidb}`.
+  - `conditions` (`Record<string, string[]>`, optional): Restricts when the rule applies by allowing only specific values for variables extracted from `sourcePattern`.
+  - `filenameTransform` (optional): Special handling for filenames like `_index`/`_docHome`.
+    - `ignoreIf` (`string[]`, optional): If the filename matches, omit the `{filename}` part in the generated URL.
+    - `conditionalTarget` (optional): Use an alternate `keepTargetPattern` when the filename matches `keepIf`.
+- `aliases` (optional): Named alias tables referenced from `targetPattern` via `{var:alias-name}`.
+  - `context` (`Record<string, string[]>`, optional): Apply the alias only when other variables match specific values (for example, only for certain `repo` values).
+  - `mappings` (`AliasMapping`): Alias definitions supporting exact matches (for example, `master -> dev`) and wildcard/regex replacements (for example, `release-* -> v*`).
+- `defaultLanguage` (`string`, optional): When `calculateFileUrl(..., omitDefaultLanguage=true)` and the resolved URL starts with `/{defaultLanguage}/`, the language prefix is removed.
+- `trailingSlash` (`"always" | "never" | "auto"`, optional): Controls trailing slash behavior of the resolved URL.
+  - `"never"`: never ends with `/`
+  - `"always"`: always ends with `/`
+  - `"auto"`: add/remove `/` based on whether the resolved URL represents an index page (for example, when `{filename}` is omitted)
+
+### Pattern Syntax
+
+#### Variables
+
+- `{lang}` - Language code (e.g., `en`, `zh`, `ja`)
+- `{repo}` - Repository name (e.g., `tidb`, `tidbcloud`, `tidb-in-kubernetes`)
+- `{branch}` - Branch name (e.g., `master`, `release-8.5`)
+- `{filename}` - File name without extension (e.g., `alert-rules`, `_index`)
+- `{...folders}` - Variable number of folder segments (captures all remaining segments)
+- `{namespace}` - Namespace (e.g., `developer`, `best-practices`, `api`)
+
+#### Alias Syntax
+
+Use `{variable:alias-name}` in target patterns to apply aliases:
+
+```typescript
+// In targetPattern: "{branch:branch-alias-tidb}"
+// This applies the "branch-alias-tidb" alias to the branch variable
+```
+
+#### Filename Transform
+
+```typescript
+filenameTransform: {
+  // Ignore filename in target URL if it matches any value
+  ignoreIf: ["_index", "_docHome"],
+
+  // Use alternative target pattern when filename matches
+  conditionalTarget: {
+    keepIf: ["_index"],
+    keepTargetPattern: "/{lang}/{namespace}/{folders}",
+  },
+}
+```
+
+### Example Rules
+
+#### 1. TiDBCloud Dedicated Index
+
+```typescript
+{
+  sourcePattern: "/{lang}/tidbcloud/master/tidb-cloud/dedicated/{filename}",
+  targetPattern: "/{lang}/tidbcloud",
+  conditions: { filename: ["_index"] },
+}
+```
+
+**Result**:
+- Source: `/en/tidbcloud/master/tidb-cloud/dedicated/_index.md`
+- Target: `/en/tidbcloud` (or `/tidbcloud` if default language is omitted)
+
+#### 2. Developer Namespace with Folders (Source: `develop`)
+
+```typescript
+{
+  sourcePattern: "/{lang}/tidb/{branch}/{folder}/{...folders}/{filename}",
+  targetPattern: "/{lang}/developer/{filename}",
+  conditions: { folder: ["develop"] },
+  filenameTransform: {
+    ignoreIf: ["_index"],
+    conditionalTarget: {
+      keepIf: ["_index"],
+      keepTargetPattern: "/{lang}/developer/{folders}",
+    },
+  },
+}
+```
+
+**Result**:
+- Source: `/en/tidb/master/develop/subfolder/_index.md`
+- Target: `/en/developer/subfolder`
+- Source: `/en/tidb/master/develop/subfolder/page.md`
+- Target: `/en/developer/page`
+
+#### 3. Branch Aliasing
+
+```typescript
+{
+  sourcePattern: "/{lang}/tidb/{branch}/{...folders}/{filename}",
+  targetPattern: "/{lang}/tidb/{branch:branch-alias-tidb}/{filename}",
+  filenameTransform: {
+    ignoreIf: ["_index", "_docHome"],
+  },
+}
+```
+
+With alias configuration:
+```typescript
+aliases: {
+  "branch-alias-tidb": {
+    mappings: {
+      master: "dev",
+      "release-*": "v*", // release-8.5 -> v8.5
+    },
+  },
+}
+```
+
+**Result**:
+- Source: `/en/tidb/master/alert-rules.md`
+- Target: `/en/tidb/dev/alert-rules`
+- Source: `/en/tidb/release-8.5/alert-rules.md`
+- Target: `/en/tidb/v8.5/alert-rules`
+
+## API Reference
+
+### `parseSourcePath(absolutePath, sourceBasePath)`
+
+Parses a source file path into segments and filename.
+
+**Parameters**:
+- `absolutePath`: Absolute path to source file or slug format (e.g., `"en/tidb/master/alert-rules"`)
+- `sourceBasePath`: Base path for source files
+
+**Returns**: `ParsedSourcePath | null`
+
+```typescript
+interface ParsedSourcePath {
+  segments: string[]; // ["en", "tidb", "master", "alert-rules.md"]
+  filename: string;   // "alert-rules"
+}
+```
+
+### `calculateFileUrl(absolutePath, omitDefaultLanguage?)`
+
+Calculates the published URL for a source file path.
+
+**Parameters**:
+- `absolutePath`: Absolute path to source file or slug format
+- `omitDefaultLanguage`: Whether to omit default language prefix (default: `false`)
+
+**Returns**: `string | null` - The resolved URL or `null` if no rule matches
+
+### `calculateFileUrlWithConfig(absolutePath, config, omitDefaultLanguage?)`
+
+Internal implementation that accepts a custom configuration object.
+
+### `clearUrlResolverCache()`
+
+Clears all caches (useful for testing or when configuration changes).
+
+## How It Works
+
+1. **Parse Source Path**: The resolver first parses the input path (absolute or slug format) into segments and filename.
+
+2. **Pattern Matching**: It iterates through `pathMappings` rules in order, trying to match the `sourcePattern` against the parsed segments.
+
+3. **Variable Extraction**: When a pattern matches, variables are extracted (e.g., `lang`, `repo`, `branch`, `filename`).
+
+4. **Condition Checking**: If the rule has `conditions`, they are checked against the extracted variables.
+
+5. **Filename Transform**: If `filenameTransform` is specified, the filename may be ignored or an alternative target pattern may be used.
+
+6. **Alias Application**: If the target pattern contains alias syntax (e.g., `{branch:branch-alias-tidb}`), the alias is applied.
+
+7. **URL Construction**: The target URL is built by applying the target pattern with the variables.
+
+8. **Post-processing**:
+   - Default language omission (if `omitDefaultLanguage` is `true`)
+   - Trailing slash handling (based on `trailingSlash` config)
+
+9. **Fallback**: If no rule matches, a default fallback rule is used.
+
+## Examples
+
+### Example 1: Basic TiDB Page
+
+```typescript
+// Input: "en/tidb/master/alert-rules.md"
+// Rule matches: /{lang}/tidb/{branch}/{...folders}/{filename}
+// Variables: { lang: "en", repo: "tidb", branch: "master", filename: "alert-rules" }
+// Alias applied: master -> dev (via branch-alias-tidb)
+// Target: /{lang}/tidb/{branch}/{filename} = /en/tidb/dev/alert-rules
+// omitDefaultLanguage=true: /tidb/dev/alert-rules
+```
+
+### Example 2: Developer Namespace Index (Source: `develop`)
+
+```typescript
+// Input: "en/tidb/release-8.5/develop/subfolder/_index.md"
+// Rule matches: /{lang}/tidb/{branch}/{folder}/{...folders}/{filename}
+//   with condition: folder = "develop"
+// Variables: { lang: "en", repo: "tidb", branch: "release-8.5", folder: "develop", folders: ["subfolder"], filename: "_index" }
+// Filename transform: _index matches keepIf, use keepTargetPattern
+// Target: /{lang}/developer/{folders} = /en/developer/subfolder
+// omitDefaultLanguage=true: /developer/subfolder
+```
+
+### Example 3: TiDBCloud with Prefix
+
+```typescript
+// Input: "en/tidbcloud/master/tidb-cloud/dedicated/starter/_index.md"
+// Rule matches: /{lang}/tidbcloud/{branch}/tidb-cloud/{...prefixes}/{filename}
+// Variables: { lang: "en", repo: "tidbcloud", branch: "master", prefixes: ["dedicated", "starter"], filename: "_index" }
+// Filename transform: _index matches keepIf, use keepTargetPattern
+// Target: /{lang}/tidbcloud/{prefixes} = /en/tidbcloud/dedicated/starter
+// omitDefaultLanguage=true: /tidbcloud/dedicated/starter
+```
+
+## Best Practices
+
+1. **Rule Order**: Place more specific rules before general ones, as the first match wins.
+
+2. **Conditions**: Use conditions to narrow down when a rule should apply, avoiding conflicts.
+
+3. **Filename Transforms**: Use `filenameTransform` to handle special cases like `_index` files.
+
+4. **Aliases**: Use aliases for branch name transformations to keep rules clean and maintainable.
+
+5. **Testing**: Always test URL resolution with various input formats (absolute paths, slugs, with/without extensions).
+
+6. **Cache Clearing**: Clear caches when configuration changes during development.
+
+## Troubleshooting
+
+### URL is `null`
+
+- Check if the source path matches any `sourcePattern` in the configuration
+- Verify the path format (absolute path or valid slug format)
+- Ensure the path has at least 2 segments (lang + filename or more)
+
+### Wrong URL Generated
+
+- Check rule order - earlier rules take precedence
+- Verify conditions are correctly specified
+- Check if filename transforms are applied correctly
+- Ensure aliases are properly configured
+
+### Default Language Not Omitted
+
+- Ensure `omitDefaultLanguage` parameter is set to `true`
+- Verify `defaultLanguage` is set in configuration
+- Check that the URL starts with `/{defaultLanguage}/`
diff --git a/gatsby/url-resolver/__tests__/README.md b/gatsby/url-resolver/__tests__/README.md
new file mode 100644
index 000000000..8dfc8eafa
--- /dev/null
+++ b/gatsby/url-resolver/__tests__/README.md
@@ -0,0 +1,65 @@
+# URL Resolver Tests
+
+This directory contains test cases for the URL resolver module.
+
+## Test Files
+
+- **pattern-matcher.test.ts**: Tests for pattern matching functionality
+  - Pattern matching with variables
+  - Variable segments (0 or N segments)
+  - Pattern application with aliases
+
+- **branch-alias.test.ts**: Tests for alias functionality
+  - Exact match aliases
+  - Wildcard pattern aliases
+  - Regex pattern aliases
+  - Context-based alias selection
+
+- **url-resolver.test.ts**: Tests for URL resolver main functionality
+  - Source path parsing
+  - URL calculation with different mapping rules
+  - Conditional target patterns
+  - Branch aliasing
+
+## Running Tests
+
+To run all tests:
+
+```bash
+yarn test
+```
+
+To run tests for a specific file:
+
+```bash
+yarn test pattern-matcher
+yarn test branch-alias
+yarn test url-resolver
+```
+
+## Test Coverage
+
+The tests cover:
+
+1. **Pattern Matching**
+   - Simple variable matching
+   - Variable segments (0 or more)
+   - Complex patterns with multiple variables
+
+2. **Pattern Application**
+   - Variable substitution
+   - Empty variable handling
+   - Alias syntax with context
+
+3. **Alias Resolution**
+   - Exact matches
+   - Wildcard patterns (`release-*` -> `v*`)
+   - Regex patterns
+   - Context-based filtering
+
+4. **URL Resolution**
+   - tidbcloud with prefix mapping
+   - ai/develop/best-practices/api/releases mapping
+   - tidb with branch aliasing
+   - Fallback rules
+   - Conditional target patterns (for `_index` files)
diff --git a/gatsby/url-resolver/__tests__/branch-alias.test.ts b/gatsby/url-resolver/__tests__/branch-alias.test.ts
new file mode 100644
index 000000000..07fdc559b
--- /dev/null
+++ b/gatsby/url-resolver/__tests__/branch-alias.test.ts
@@ -0,0 +1,168 @@
+/**
+ * Tests for branch-alias.ts
+ */
+
+import { getAlias, getVariableAlias } from "../branch-alias";
+import type { AliasMapping, UrlResolverConfig } from "../types";
+
+describe("getAlias", () => {
+  it("should return exact match", () => {
+    const mappings: AliasMapping = {
+      master: "stable",
+      main: "stable",
+    };
+    expect(getAlias(mappings, "master")).toBe("stable");
+    expect(getAlias(mappings, "main")).toBe("stable");
+  });
+
+  it("should return null for non-existent key", () => {
+    const mappings: AliasMapping = {
+      master: "stable",
+    };
+    expect(getAlias(mappings, "unknown")).toBeNull();
+  });
+
+  it("should handle wildcard pattern matching", () => {
+    const mappings: AliasMapping = {
+      "release-*": "v*",
+    };
+    expect(getAlias(mappings, "release-8.5")).toBe("v8.5");
+    expect(getAlias(mappings, "release-8.1")).toBe("v8.1");
+    expect(getAlias(mappings, "release-7.5")).toBe("v7.5");
+  });
+
+  it("should handle multiple wildcards in pattern", () => {
+    const mappings: AliasMapping = {
+      "release-*-*": "v*-*",
+    };
+    expect(getAlias(mappings, "release-8-5")).toBe("v8-5");
+  });
+
+  it("should handle regex pattern matching", () => {
+    const mappings: AliasMapping = {
+      pattern: {
+        pattern: "release-(.*)",
+        replacement: "v$1",
+        useRegex: true,
+      },
+    };
+    expect(getAlias(mappings, "release-8.5")).toBe("v8.5");
+    expect(getAlias(mappings, "release-8.1")).toBe("v8.1");
+  });
+
+  it("should prioritize exact match over pattern match", () => {
+    const mappings: AliasMapping = {
+      "release-8.5": "v8.5-specific",
+      "release-*": "v*",
+    };
+    expect(getAlias(mappings, "release-8.5")).toBe("v8.5-specific");
+    expect(getAlias(mappings, "release-8.1")).toBe("v8.1");
+  });
+
+  it("should return null for non-matching pattern", () => {
+    const mappings: AliasMapping = {
+      "release-*": "v*",
+    };
+    expect(getAlias(mappings, "master")).toBeNull();
+  });
+});
+
+describe("getVariableAlias", () => {
+  it("should return alias when context matches", () => {
+    const config: Partial<UrlResolverConfig> = {
+      aliases: {
+        "branch-alias": {
+          context: {
+            repo: ["tidb", "tidb-in-kubernetes"],
+          },
+          mappings: {
+            master: "stable",
+          },
+        },
+      },
+    };
+    const contextVariables = {
+      repo: "tidb",
+    };
+    expect(
+      getVariableAlias("branch-alias", "master", config, contextVariables)
+    ).toBe("stable");
+  });
+
+  it("should return null when context doesn't match", () => {
+    const config: Partial<UrlResolverConfig> = {
+      aliases: {
+        "branch-alias": {
+          context: {
+            repo: ["tidb", "tidb-in-kubernetes"],
+          },
+          mappings: {
+            master: "stable",
+          },
+        },
+      },
+    };
+    const contextVariables = {
+      repo: "other-repo",
+    };
+    expect(
+      getVariableAlias("branch-alias", "master", config, contextVariables)
+    ).toBeNull();
+  });
+
+  it("should return alias when no context is specified", () => {
+    const config: Partial<UrlResolverConfig> = {
+      aliases: {
+        "branch-alias": {
+          mappings: {
+            master: "stable",
+          },
+        },
+      },
+    };
+    const contextVariables = {};
+    expect(
+      getVariableAlias("branch-alias", "master", config, contextVariables)
+    ).toBe("stable");
+  });
+
+  it("should handle multiple context conditions", () => {
+    const config: Partial<UrlResolverConfig> = {
+      aliases: {
+        "branch-alias": {
+          context: {
+            repo: ["tidb"],
+            lang: ["en"],
+          },
+          mappings: {
+            master: "stable",
+          },
+        },
+      },
+    };
+    const contextVariables1 = {
+      repo: "tidb",
+      lang: "en",
+    };
+    const contextVariables2 = {
+      repo: "tidb",
+      lang: "zh",
+    };
+    expect(
+      getVariableAlias("branch-alias", "master", config, contextVariables1)
+    ).toBe("stable");
+    expect(
+      getVariableAlias("branch-alias", "master", config, contextVariables2)
+    ).toBeNull();
+  });
+
+  it("should return null for non-existent alias name", () => {
+    const config: Partial<UrlResolverConfig> = {
+      aliases: {},
+    };
+    const contextVariables = {};
+    expect(
+      getVariableAlias("non-existent", "master", config, contextVariables)
+    ).toBeNull();
+  });
+});
diff --git a/gatsby/url-resolver/__tests__/pattern-matcher.test.ts b/gatsby/url-resolver/__tests__/pattern-matcher.test.ts
new file mode 100644
index 000000000..adc63ed96
--- /dev/null
+++ b/gatsby/url-resolver/__tests__/pattern-matcher.test.ts
@@ -0,0 +1,232 @@
+/**
+ * Tests for pattern-matcher.ts
+ */
+
+import { matchPattern, applyPattern } from "../pattern-matcher";
+import type { UrlResolverConfig } from "../types";
+
+describe("matchPattern", () => {
+  it("should match simple pattern with variables", () => {
+    const pattern = "/{lang}/{repo}/{filename}";
+    const segments = ["en", "tidb", "alert-rules"];
+    const result = matchPattern(pattern, segments);
+    expect(result).toEqual({
+      lang: "en",
+      repo: "tidb",
+      filename: "alert-rules",
+    });
+  });
+
+  it("should match pattern with variable segments (0 segments)", () => {
+    const pattern = "/{lang}/{repo}/{...folders}/{filename}";
+    const segments = ["en", "tidb", "alert-rules"];
+    const result = matchPattern(pattern, segments);
+    expect(result).toEqual({
+      lang: "en",
+      repo: "tidb",
+      folders: "",
+      filename: "alert-rules",
+    });
+  });
+
+  it("should match pattern with variable segments (1 segment)", () => {
+    const pattern = "/{lang}/{repo}/{...folders}/{filename}";
+    const segments = ["en", "tidb", "subfolder", "alert-rules"];
+    const result = matchPattern(pattern, segments);
+    expect(result).toEqual({
+      lang: "en",
+      repo: "tidb",
+      folders: "subfolder",
+      filename: "alert-rules",
+    });
+  });
+
+  it("should match pattern with variable segments (multiple segments)", () => {
+    const pattern = "/{lang}/{repo}/{...folders}/{filename}";
+    const segments = [
+      "en",
+      "tidb",
+      "folder1",
+      "folder2",
+      "folder3",
+      "alert-rules",
+    ];
+    const result = matchPattern(pattern, segments);
+    expect(result).toEqual({
+      lang: "en",
+      repo: "tidb",
+      folders: "folder1/folder2/folder3",
+      filename: "alert-rules",
+    });
+  });
+
+  it("should match pattern with variable segments at the end", () => {
+    const pattern = "/{lang}/{repo}/{namespace}/{...prefixes}/{filename}";
+    const segments = [
+      "en",
+      "tidbcloud",
+      "tidb-cloud",
+      "dedicated",
+      "starter",
+      "_index",
+    ];
+    const result = matchPattern(pattern, segments);
+    expect(result).toEqual({
+      lang: "en",
+      repo: "tidbcloud",
+      namespace: "tidb-cloud",
+      prefixes: "dedicated/starter",
+      filename: "_index",
+    });
+  });
+
+  it("should return null for non-matching pattern", () => {
+    const pattern = "/{lang}/{repo}/{filename}";
+    const segments = ["en", "tidb", "folder", "alert-rules"];
+    const result = matchPattern(pattern, segments);
+    expect(result).toBeNull();
+  });
+
+  it("should match complex pattern with conditions", () => {
+    const pattern =
+      "/{lang}/{repo}/{branch}/{namespace}/{...prefixes}/{filename}";
+    const segments = [
+      "en",
+      "tidbcloud",
+      "master",
+      "tidb-cloud",
+      "dedicated",
+      "_index",
+    ];
+    const result = matchPattern(pattern, segments);
+    expect(result).toEqual({
+      lang: "en",
+      repo: "tidbcloud",
+      branch: "master",
+      namespace: "tidb-cloud",
+      prefixes: "dedicated",
+      filename: "_index",
+    });
+  });
+});
+
+describe("applyPattern", () => {
+  it("should apply simple pattern with variables", () => {
+    const pattern = "/{lang}/{repo}/{filename}";
+    const variables = {
+      lang: "en",
+      repo: "tidb",
+      filename: "alert-rules",
+    };
+    const result = applyPattern(pattern, variables);
+    expect(result).toBe("/en/tidb/alert-rules");
+  });
+
+  it("should skip empty variables (from 0-match variable segments)", () => {
+    const pattern = "/{lang}/{repo}/{folders}/{filename}";
+    const variables = {
+      lang: "en",
+      repo: "tidb",
+      folders: "",
+      filename: "alert-rules",
+    };
+    const result = applyPattern(pattern, variables);
+    expect(result).toBe("/en/tidb/alert-rules");
+  });
+
+  it("should expand variable segments with slashes", () => {
+    const pattern = "/{lang}/{repo}/{folders}/{filename}";
+    const variables = {
+      lang: "en",
+      repo: "tidb",
+      folders: "folder1/folder2/folder3",
+      filename: "alert-rules",
+    };
+    const result = applyPattern(pattern, variables);
+    expect(result).toBe("/en/tidb/folder1/folder2/folder3/alert-rules");
+  });
+
+  it("should apply alias syntax with context", () => {
+    const pattern = "/{lang}/{repo}/{branch:branch-alias}/{filename}";
+    const variables = {
+      lang: "en",
+      repo: "tidb",
+      branch: "master",
+      filename: "alert-rules",
+    };
+    const config: Partial<UrlResolverConfig> = {
+      aliases: {
+        "branch-alias": {
+          context: {
+            repo: ["tidb", "tidb-in-kubernetes"],
+          },
+          mappings: {
+            master: "stable",
+          },
+        },
+      },
+    };
+    const result = applyPattern(pattern, variables, config);
+    expect(result).toBe("/en/tidb/stable/alert-rules");
+  });
+
+  it("should not apply alias when context doesn't match", () => {
+    const pattern = "/{lang}/{repo}/{branch:branch-alias}/{filename}";
+    const variables = {
+      lang: "en",
+      repo: "other-repo",
+      branch: "master",
+      filename: "alert-rules",
+    };
+    const config: Partial<UrlResolverConfig> = {
+      aliases: {
+        "branch-alias": {
+          context: {
+            repo: ["tidb", "tidb-in-kubernetes"],
+          },
+          mappings: {
+            master: "stable",
+          },
+        },
+      },
+    };
+    const result = applyPattern(pattern, variables, config);
+    expect(result).toBe("/en/other-repo/master/alert-rules");
+  });
+
+  it("should handle wildcard alias patterns", () => {
+    const pattern = "/{lang}/{repo}/{branch:branch-alias}/{filename}";
+    const variables = {
+      lang: "en",
+      repo: "tidb",
+      branch: "release-8.5",
+      filename: "alert-rules",
+    };
+    const config: Partial<UrlResolverConfig> = {
+      aliases: {
+        "branch-alias": {
+          context: {
+            repo: ["tidb"],
+          },
+          mappings: {
+            "release-*": "v*",
+          },
+        },
+      },
+    };
+    const result = applyPattern(pattern, variables, config);
+    expect(result).toBe("/en/tidb/v8.5/alert-rules");
+  });
+
+  it("should handle empty folders variable", () => {
+    const pattern = "/{lang}/{repo}/{folders}/{filename}";
+    const variables = {
+      lang: "en",
+      repo: "tidb",
+      folders: "",
+      filename: "alert-rules",
+    };
+    const result = applyPattern(pattern, variables);
+    expect(result).toBe("/en/tidb/alert-rules");
+  });
+});
diff --git a/gatsby/url-resolver/__tests__/url-resolver.test.ts b/gatsby/url-resolver/__tests__/url-resolver.test.ts
new file mode 100644
index 000000000..09f72c6b1
--- /dev/null
+++ b/gatsby/url-resolver/__tests__/url-resolver.test.ts
@@ -0,0 +1,643 @@
+/**
+ * Tests for url-resolver.ts
+ */
+
+import { parseSourcePath, calculateFileUrlWithConfig } from "../url-resolver";
+import type { UrlResolverConfig } from "../types";
+import { defaultUrlResolverConfig } from "../config";
+import path from "path";
+
+describe("parseSourcePath", () => {
+  const sourceBasePath = "/base/path/docs/markdown-pages";
+
+  it("should parse valid source path", () => {
+    const absolutePath =
+      "/base/path/docs/markdown-pages/en/tidb/master/alert-rules.md";
+    const result = parseSourcePath(absolutePath, sourceBasePath);
+    expect(result).toEqual({
+      segments: ["en", "tidb", "master", "alert-rules.md"],
+      filename: "alert-rules",
+    });
+  });
+
+  it("should handle _index.md files", () => {
+    const absolutePath =
+      "/base/path/docs/markdown-pages/en/tidbcloud/master/tidb-cloud/dedicated/_index.md";
+    const result = parseSourcePath(absolutePath, sourceBasePath);
+    expect(result).toEqual({
+      segments: [
+        "en",
+        "tidbcloud",
+        "master",
+        "tidb-cloud",
+        "dedicated",
+        "_index.md",
+      ],
+      filename: "_index",
+    });
+  });
+
+  it("should handle relative path (slug format) without .md extension", () => {
+    const slug = "en/tidb/master/alert-rules";
+    const result = parseSourcePath(slug, sourceBasePath);
+    expect(result).toEqual({
+      segments: ["en", "tidb", "master", "alert-rules.md"],
+      filename: "alert-rules",
+    });
+  });
+
+  it("should handle relative path (slug format) with .md extension", () => {
+    const slug = "en/tidb/master/alert-rules.md";
+    const result = parseSourcePath(slug, sourceBasePath);
+    expect(result).toEqual({
+      segments: ["en", "tidb", "master", "alert-rules.md"],
+      filename: "alert-rules",
+    });
+  });
+
+  it("should handle relative path (slug format) with leading slash", () => {
+    const slug = "/en/tidb/master/alert-rules";
+    const result = parseSourcePath(slug, sourceBasePath);
+    expect(result).toEqual({
+      segments: ["en", "tidb", "master", "alert-rules.md"],
+      filename: "alert-rules",
+    });
+  });
+
+  it("should handle relative path for tidbcloud", () => {
+    const slug = "en/tidbcloud/master/tidb-cloud/dedicated/_index";
+    const result = parseSourcePath(slug, sourceBasePath);
+    expect(result).toEqual({
+      segments: [
+        "en",
+        "tidbcloud",
+        "master",
+        "tidb-cloud",
+        "dedicated",
+        "_index.md",
+      ],
+      filename: "_index",
+    });
+  });
+
+  it("should return null for path with too few segments", () => {
+    const absolutePath = "/base/path/docs/markdown-pages/en.md";
+    const result = parseSourcePath(absolutePath, sourceBasePath);
+    expect(result).toBeNull();
+  });
+
+  it("should handle paths with trailing slashes", () => {
+    const absolutePath =
+      "/base/path/docs/markdown-pages/en/tidb/master/alert-rules.md/";
+    const result = parseSourcePath(absolutePath, sourceBasePath);
+    expect(result).toEqual({
+      segments: ["en", "tidb", "master", "alert-rules.md"],
+      filename: "alert-rules",
+    });
+  });
+});
+
+describe("calculateFileUrl", () => {
+  const sourceBasePath = path.resolve(
+    __dirname,
+    "../../../docs/markdown-pages"
+  );
+
+  const testConfig: UrlResolverConfig = {
+    ...defaultUrlResolverConfig,
+    sourceBasePath,
+    // Test config: don't omit default language, use auto trailing slash
+    defaultLanguage: undefined,
+    trailingSlash: "auto",
+  };
+
+  it("should resolve tidbcloud dedicated _index to /tidbcloud (first rule)", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidbcloud/master/tidb-cloud/dedicated/_index.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    // First rule matches: /{lang}/tidbcloud/master/tidb-cloud/dedicated/{filename}
+    // with condition filename = "_index" -> /{lang}/tidbcloud
+    // trailingSlash: "auto" adds trailing slash for _index files
+    expect(url).toBe("/en/tidbcloud/");
+  });
+
+  it("should resolve tidbcloud _index with prefixes (second rule)", () => {
+    // This test verifies the second rule for paths with multiple prefixes
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidbcloud/master/tidb-cloud/dedicated/starter/_index.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    // Second rule matches: /{lang}/tidbcloud/{branch}/tidb-cloud/{...prefixes}/{filename}
+    // with conditionalTarget for _index -> /{lang}/tidbcloud/{prefixes}
+    expect(url).toBe("/en/tidbcloud/dedicated/starter");
+  });
+
+  it("should resolve tidbcloud non-index without prefixes", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidbcloud/master/tidb-cloud/dedicated/some-page.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBe("/en/tidbcloud/some-page/");
+  });
+
+  it("should resolve tidbcloud with multiple prefixes for _index", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidbcloud/master/tidb-cloud/dedicated/starter/_index.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBe("/en/tidbcloud/dedicated/starter");
+  });
+
+  it("should resolve develop _index with folders", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/release-8.5/develop/subfolder/_index.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBe("/en/developer/subfolder");
+  });
+
+  it("should resolve develop non-index without folders", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/release-8.5/develop/subfolder/some-page.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBe("/en/developer/some-page/");
+  });
+
+  it("should resolve tidb with branch alias (master -> dev)", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/master/alert-rules.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBe("/en/tidb/dev/alert-rules/");
+  });
+
+  it("should resolve tidb with branch alias (release-8.5 -> stable)", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/release-8.5/alert-rules.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    // release-8.5 -> stable via branch-alias-tidb (exact match takes precedence)
+    expect(url).toBe("/en/tidb/stable/alert-rules/");
+  });
+
+  it("should resolve tidb _index with branch alias", () => {
+    const absolutePath = path.join(sourceBasePath, "en/tidb/master/_index.md");
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBe("/en/tidb/dev");
+  });
+
+  it("should resolve tidb with folders and branch alias", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/master/subfolder/page.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBe("/en/tidb/dev/page/");
+  });
+
+  it("should resolve api folder", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/release-8.5/api/overview.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBe("/en/api/overview/");
+  });
+
+  it("should resolve best-practices folder", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/release-8.5/best-practices/guide.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBe("/en/best-practices/guide/");
+  });
+
+  it("should resolve ai folder", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/release-8.5/ai/overview.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBe("/en/ai/overview/");
+  });
+
+  it("should resolve ai _index with folders", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/release-8.5/ai/subfolder/_index.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBe("/en/ai/subfolder");
+  });
+
+  it("should resolve releases folder", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/release-8.5/releases/_index.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    // Matches rule: /{lang}/tidb/release-8.5/releases/{filename} -> /{lang}/releases/tidb
+    // trailingSlash: "auto" adds trailing slash for _index files
+    expect(url).toBe("/en/releases/tidb-self-managed/");
+  });
+
+  it("should resolve releases folder zh", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "zh/tidb/release-8.5/releases/_index.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    // Matches rule: /{lang}/tidb/release-8.5/releases/{filename} -> /{lang}/releases/tidb
+    // trailingSlash: "auto" adds trailing slash for _index files
+    expect(url).toBe("/zh/releases/tidb-self-managed/");
+  });
+
+  it("should resolve tidbcloud releases folder", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidbcloud/master/tidb-cloud/releases/_index.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    // Matches rule: /{lang}/tidbcloud/master/tidb-cloud/releases/{filename} -> /{lang}/releases/tidb-cloud
+    // trailingSlash: "auto" adds trailing slash for _index files
+    expect(url).toBe("/en/releases/tidb-cloud/");
+  });
+
+  it("should resolve tidbcloud releases folder zh", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "zh/tidbcloud/master/tidb-cloud/releases/_index.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    // Matches rule: /{lang}/tidbcloud/master/tidb-cloud/releases/{filename} -> /{lang}/releases/tidb-cloud
+    // trailingSlash: "auto" adds trailing slash for _index files
+    expect(url).toBe("/zh/releases/tidb-cloud/");
+  });
+
+  it("should use fallback rule for unmatched patterns", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/other-repo/some-folder/page.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBe("/en/other-repo/page/");
+  });
+
+  it("should handle fallback with _index", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/other-repo/some-folder/_index.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBe("/en/other-repo");
+  });
+
+  it("should handle nested fallback with _index at repo root", () => {
+    const absolutePath = path.join(sourceBasePath, "en/other-repo/_index.md");
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBe("/en/other-repo");
+  });
+
+  it("should return null for invalid path", () => {
+    const absolutePath = "/invalid/path/file.md";
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBeNull();
+  });
+
+  it("should resolve tidb with release-8.5 branch alias (release-8.5 -> stable)", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/release-8.5/alert-rules.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    // release-8.5 -> stable via branch-alias-tidb (exact match)
+    expect(url).toBe("/en/tidb/stable/alert-rules/");
+  });
+});
+
+describe("calculateFileUrl with defaultLanguage: 'en'", () => {
+  const sourceBasePath = path.resolve(
+    __dirname,
+    "../../../docs/markdown-pages"
+  );
+
+  const configWithDefaultLang: UrlResolverConfig = {
+    ...defaultUrlResolverConfig,
+    sourceBasePath,
+    defaultLanguage: "en",
+    trailingSlash: "never",
+  };
+
+  it("should omit /en/ prefix for English files (tidb)", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/master/alert-rules.md"
+    );
+    const url = calculateFileUrlWithConfig(
+      absolutePath,
+      configWithDefaultLang,
+      true
+    );
+    // master -> dev via branch-alias-tidb
+    expect(url).toBe("/tidb/dev/alert-rules");
+  });
+
+  it("should omit /en/ prefix for English files (tidbcloud)", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidbcloud/master/tidb-cloud/dedicated/some-page.md"
+    );
+    const url = calculateFileUrlWithConfig(
+      absolutePath,
+      configWithDefaultLang,
+      true
+    );
+    expect(url).toBe("/tidbcloud/some-page");
+  });
+
+  it("should omit /en/ prefix for English dedicated _index files (tidbcloud)", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidbcloud/master/tidb-cloud/dedicated/_index.md"
+    );
+    const url = calculateFileUrlWithConfig(
+      absolutePath,
+      configWithDefaultLang,
+      true
+    );
+    // First rule matches: /{lang}/tidbcloud/master/tidb-cloud/dedicated/{filename}
+    // with condition filename = "_index" -> /{lang}/tidbcloud
+    // After defaultLanguage omission: /tidbcloud
+    // trailingSlash: "never" removes trailing slash
+    expect(url).toBe("/tidbcloud");
+  });
+
+  it("should omit /en/ prefix for English develop files", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/release-8.5/develop/overview.md"
+    );
+    const url = calculateFileUrlWithConfig(
+      absolutePath,
+      configWithDefaultLang,
+      true
+    );
+    expect(url).toBe("/developer/overview");
+  });
+
+  it("should keep /zh/ prefix for Chinese files", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "zh/tidb/master/alert-rules.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, configWithDefaultLang);
+    // master -> dev via branch-alias-tidb
+    expect(url).toBe("/zh/tidb/dev/alert-rules");
+  });
+
+  it("should keep /ja/ prefix for Japanese files", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "ja/tidb/release-8.5/alert-rules.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, configWithDefaultLang);
+    // release-8.5 -> stable via branch-alias-tidb (exact match)
+    expect(url).toBe("/ja/tidb/stable/alert-rules");
+  });
+
+  it("should omit /en/ prefix for English api files", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/release-8.5/api/overview.md"
+    );
+    const url = calculateFileUrlWithConfig(
+      absolutePath,
+      configWithDefaultLang,
+      true
+    );
+    expect(url).toBe("/api/overview");
+  });
+
+  it("should omit /en/ prefix for English release branch files", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/release-8.5/alert-rules.md"
+    );
+    const url = calculateFileUrlWithConfig(
+      absolutePath,
+      configWithDefaultLang,
+      true
+    );
+    // release-8.5 -> stable via branch-alias-tidb (exact match takes precedence)
+    expect(url).toBe("/tidb/stable/alert-rules");
+  });
+});
+
+describe("calculateFileUrl with slug format (relative path)", () => {
+  const sourceBasePath = path.resolve(
+    __dirname,
+    "../../../docs/markdown-pages"
+  );
+
+  const configWithDefaultLang: UrlResolverConfig = {
+    sourceBasePath,
+    defaultLanguage: "en",
+    trailingSlash: "never",
+    pathMappings: [
+      // tidbcloud with prefix
+      {
+        sourcePattern:
+          "/{lang}/{repo}/{branch}/{namespace}/{...prefixes}/{filename}",
+        targetPattern: "/{lang}/{repo}/{filename}",
+        conditions: {
+          repo: ["tidbcloud"],
+          namespace: ["tidb-cloud"],
+        },
+        filenameTransform: {
+          ignoreIf: ["_index"],
+          conditionalTarget: {
+            keepIf: ["_index"],
+            keepTargetPattern: "/{lang}/{repo}/{prefixes}",
+          },
+        },
+      },
+      // tidb with branch
+      {
+        sourcePattern: "/{lang}/{repo}/{branch}/{...folders}/{filename}",
+        targetPattern: "/{lang}/{repo}/{branch:branch-alias-tidb}/{filename}",
+        conditions: {
+          repo: ["tidb"],
+        },
+        filenameTransform: {
+          ignoreIf: ["_index", "_docHome"],
+        },
+      },
+      // tidb-in-kubernetes with branch
+      {
+        sourcePattern: "/{lang}/{repo}/{branch}/{...folders}/{filename}",
+        targetPattern:
+          "/{lang}/{repo}/{branch:branch-alias-tidb-in-kubernetes}/{filename}",
+        conditions: {
+          repo: ["tidb-in-kubernetes"],
+        },
+        filenameTransform: {
+          ignoreIf: ["_index", "_docHome"],
+        },
+      },
+      // Fallback
+      {
+        sourcePattern: "/{lang}/{repo}/{...any}/{filename}",
+        targetPattern: "/{lang}/{repo}/{filename}",
+        filenameTransform: {
+          ignoreIf: ["_index", "_docHome"],
+        },
+      },
+    ],
+    aliases: {
+      "branch-alias-tidb": {
+        mappings: {
+          master: "dev",
+          "release-8.5": "stable",
+          "release-*": "v*",
+        },
+      },
+      "branch-alias-tidb-in-kubernetes": {
+        mappings: {
+          main: "dev",
+          "release-1.6": "stable",
+          "release-*": "v*",
+        },
+      },
+    },
+  };
+
+  it("should resolve slug format for tidb files", () => {
+    const slug = "en/tidb/master/alert-rules";
+    const url = calculateFileUrlWithConfig(slug, configWithDefaultLang, true);
+    // master -> dev via branch-alias-tidb
+    expect(url).toBe("/tidb/dev/alert-rules");
+  });
+
+  it("should resolve slug format for tidbcloud files", () => {
+    const slug = "en/tidbcloud/master/tidb-cloud/dedicated/some-page";
+    const url = calculateFileUrlWithConfig(slug, configWithDefaultLang, true);
+    expect(url).toBe("/tidbcloud/some-page");
+  });
+
+  it("should resolve slug format for tidbcloud _index files", () => {
+    const slug = "en/tidbcloud/master/tidb-cloud/dedicated/_index";
+    const url = calculateFileUrlWithConfig(slug, configWithDefaultLang, true);
+    expect(url).toBe("/tidbcloud/dedicated");
+  });
+
+  it("should resolve slug format with leading slash", () => {
+    const slug = "/en/tidb/master/alert-rules";
+    const url = calculateFileUrlWithConfig(slug, configWithDefaultLang, true);
+    // master -> dev via branch-alias-tidb
+    expect(url).toBe("/tidb/dev/alert-rules");
+  });
+
+  it("should resolve slug format for Chinese files", () => {
+    const slug = "zh/tidb/master/alert-rules";
+    const url = calculateFileUrlWithConfig(slug, configWithDefaultLang);
+    // master -> dev via branch-alias-tidb
+    expect(url).toBe("/zh/tidb/dev/alert-rules");
+  });
+
+  it("should return null for invalid slug format", () => {
+    const invalidSlug = "invalid/path";
+    const url = calculateFileUrlWithConfig(invalidSlug, configWithDefaultLang);
+    expect(url).toBeNull();
+  });
+});
+
+describe("calculateFileUrl with omitDefaultLanguage parameter", () => {
+  const sourceBasePath = path.resolve(
+    __dirname,
+    "../../../docs/markdown-pages"
+  );
+
+  const configWithDefaultLang: UrlResolverConfig = {
+    ...defaultUrlResolverConfig,
+    sourceBasePath,
+    defaultLanguage: "en",
+    trailingSlash: "never",
+  };
+
+  it("should keep default language when omitDefaultLanguage is false (default)", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/master/alert-rules.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, configWithDefaultLang);
+    // master -> dev via branch-alias-tidb
+    expect(url).toBe("/en/tidb/dev/alert-rules");
+  });
+
+  it("should keep default language when omitDefaultLanguage is undefined (default)", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/master/alert-rules.md"
+    );
+    const url = calculateFileUrlWithConfig(
+      absolutePath,
+      configWithDefaultLang,
+      false
+    );
+    // master -> dev via branch-alias-tidb
+    expect(url).toBe("/en/tidb/dev/alert-rules");
+  });
+
+  it("should omit default language when omitDefaultLanguage is true", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb/master/alert-rules.md"
+    );
+    const url = calculateFileUrlWithConfig(
+      absolutePath,
+      configWithDefaultLang,
+      true
+    );
+    // master -> dev via branch-alias-tidb
+    expect(url).toBe("/tidb/dev/alert-rules");
+  });
+
+  it("should keep non-default language even when omitDefaultLanguage is false", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "zh/tidb/master/alert-rules.md"
+    );
+    const url = calculateFileUrlWithConfig(
+      absolutePath,
+      configWithDefaultLang,
+      false
+    );
+    // master -> dev via branch-alias-tidb
+    expect(url).toBe("/zh/tidb/dev/alert-rules");
+  });
+
+  it("should keep non-default language when omitDefaultLanguage is true", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "zh/tidb/master/alert-rules.md"
+    );
+    const url = calculateFileUrlWithConfig(
+      absolutePath,
+      configWithDefaultLang,
+      true
+    );
+    // master -> dev via branch-alias-tidb
+    expect(url).toBe("/zh/tidb/dev/alert-rules");
+  });
+});
diff --git a/gatsby/url-resolver/branch-alias.ts b/gatsby/url-resolver/branch-alias.ts
new file mode 100644
index 000000000..8762735ac
--- /dev/null
+++ b/gatsby/url-resolver/branch-alias.ts
@@ -0,0 +1,191 @@
+/**
+ * Alias matching utilities (generalized from branch alias)
+ */
+
+import type { AliasMapping, AliasPattern } from "./types";
+
+/**
+ * Convert wildcard pattern to regex
+ * e.g., "release-*" -> /^release-(.+)$/
+ */
+function wildcardToRegex(pattern: string): RegExp {
+  // Escape special regex characters except *
+  const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+  // Replace * with (.+?) to capture the matched part (non-greedy)
+  const regexPattern = escaped.replace(/\*/g, "(.+?)");
+  return new RegExp(`^${regexPattern}$`);
+}
+
+/**
+ * Apply wildcard replacement
+ * e.g., pattern: "release-*", replacement: "v*", input: "release-8.5" -> "v8.5"
+ */
+function applyWildcardReplacement(
+  pattern: string,
+  replacement: string,
+  input: string
+): string | null {
+  const regex = wildcardToRegex(pattern);
+  const match = input.match(regex);
+  if (!match) {
+    return null;
+  }
+
+  const replacementWildcardCount = (replacement.match(/\*/g) || []).length;
+
+  // Replace * in replacement with captured groups
+  let result = replacement;
+  let replacementIndex = 0;
+  for (
+    let i = 1;
+    i < match.length && replacementIndex < replacementWildcardCount;
+    i++
+  ) {
+    // Replace the first * with the captured group
+    result = result.replace("*", match[i]);
+    replacementIndex++;
+  }
+
+  return result;
+}
+
+/**
+ * Apply regex replacement
+ * e.g., pattern: "release-(.*)", replacement: "v$1", input: "release-8.5" -> "v8.5"
+ */
+function applyRegexReplacement(
+  pattern: string,
+  replacement: string,
+  input: string
+): string | null {
+  try {
+    const regex = new RegExp(pattern);
+    const match = input.match(regex);
+    if (!match) {
+      return null;
+    }
+
+    // Replace $1, $2, etc. with captured groups
+    let result = replacement;
+    for (let i = 1; i < match.length; i++) {
+      result = result.replace(new RegExp(`\\$${i}`, "g"), match[i]);
+    }
+
+    return result;
+  } catch (e) {
+    // Invalid regex pattern
+    return null;
+  }
+}
+
+/**
+ * Get alias for a given value
+ * Supports both exact matches and pattern-based matches
+ */
+export function getAlias(
+  aliasMappings: AliasMapping,
+  value: string
+): string | null {
+  // First, try exact match
+  const exactMatch = aliasMappings[value];
+  if (typeof exactMatch === "string") {
+    return exactMatch;
+  }
+
+  // Then, try pattern-based matches
+  // Check each entry in aliasMappings
+  for (const [key, mappingValue] of Object.entries(aliasMappings)) {
+    // Skip if it's an exact match (already checked)
+    if (key === value) {
+      continue;
+    }
+
+    // Check if it's a pattern-based alias
+    if (typeof mappingValue === "object" && mappingValue !== null) {
+      const pattern = mappingValue as AliasPattern;
+      if (pattern.pattern && pattern.replacement) {
+        let result: string | null = null;
+        if (pattern.useRegex) {
+          result = applyRegexReplacement(
+            pattern.pattern,
+            pattern.replacement,
+            value
+          );
+        } else {
+          // Try wildcard matching
+          result = applyWildcardReplacement(
+            pattern.pattern,
+            pattern.replacement,
+            value
+          );
+        }
+        if (result) {
+          return result;
+        }
+      }
+    } else if (typeof mappingValue === "string") {
+      // Check if key is a wildcard pattern
+      if (key.includes("*")) {
+        const result = applyWildcardReplacement(key, mappingValue, value);
+        if (result) {
+          return result;
+        }
+      }
+    }
+  }
+
+  return null;
+}
+
+/**
+ * Check if context conditions are met
+ */
+function checkContext(
+  context: Record<string, string[]> | undefined,
+  variables: Record<string, string>
+): boolean {
+  if (!context) return true;
+
+  for (const [varName, allowedValues] of Object.entries(context)) {
+    const varValue = variables[varName];
+    if (varValue && allowedValues) {
+      if (!allowedValues.includes(varValue)) {
+        return false;
+      }
+    }
+  }
+
+  return true;
+}
+
+/**
+ * Get alias for a variable value using alias configuration
+ * Supports context-based alias selection
+ */
+export function getVariableAlias(
+  aliasName: string,
+  variableValue: string,
+  config: {
+    aliases?: {
+      [aliasName: string]: {
+        context?: Record<string, string[]>;
+        mappings: AliasMapping;
+      };
+    };
+  },
+  contextVariables: Record<string, string>
+): string | null {
+  if (!config.aliases || !config.aliases[aliasName]) {
+    return null;
+  }
+
+  const aliasConfig = config.aliases[aliasName];
+
+  // Check context conditions if specified
+  if (!checkContext(aliasConfig.context, contextVariables)) {
+    return null;
+  }
+
+  // Get alias from mappings
+  return getAlias(aliasConfig.mappings, variableValue);
+}
diff --git a/gatsby/url-resolver/config.ts b/gatsby/url-resolver/config.ts
new file mode 100644
index 000000000..8b219ef04
--- /dev/null
+++ b/gatsby/url-resolver/config.ts
@@ -0,0 +1,156 @@
+/**
+ * Default URL resolver configuration
+ */
+
+import path from "path";
+import type { UrlResolverConfig } from "./types";
+import CONFIG from "../../docs/docs.json";
+
+export const defaultUrlResolverConfig: UrlResolverConfig = {
+  sourceBasePath: path.resolve(__dirname, "../../docs/markdown-pages"),
+  // Default language (used when omitDefaultLanguage is true)
+  defaultLanguage: "en",
+  // Trailing slash behavior: "never" to match generateUrl behavior
+  trailingSlash: "never",
+
+  pathMappings: [
+    // tidbcloud dedicated _index
+    // /en/tidbcloud/master/tidb-cloud/dedicated/_index.md -> /en/tidbcloud/dedicated/
+    {
+      sourcePattern: "/{lang}/tidbcloud/master/tidb-cloud/dedicated/{filename}",
+      targetPattern: "/{lang}/tidbcloud",
+      conditions: { filename: ["_index"] },
+    },
+    // tidbcloud releases
+    // /en/tidbcloud/master/tidb-cloud/releases/_index.md -> /en/releases/tidb-cloud
+    {
+      sourcePattern: "/{lang}/tidbcloud/master/tidb-cloud/releases/{filename}",
+      targetPattern: "/{lang}/releases/tidb-cloud",
+      conditions: { filename: ["_index"] },
+    },
+    // tidb releases
+    // /en/tidb/master/releases/_index.md -> /en/releases/tidb-self-managed
+    {
+      sourcePattern: `/{lang}/tidb/${CONFIG.docs.tidb.stable}/releases/{filename}`,
+      targetPattern: "/{lang}/releases/tidb-self-managed",
+      conditions: { filename: ["_index"] },
+    },
+    {
+      sourcePattern: `/{lang}/tidb-in-kubernetes/main/releases/{filename}`,
+      targetPattern: "/{lang}/releases/tidb-operator",
+      conditions: { filename: ["_index"] },
+    },
+    // tidbcloud with prefix (dedicated, starter, etc.)
+    // When filename = "_index": /en/tidbcloud/tidb-cloud/{prefix}/_index.md -> /en/tidbcloud/{prefix}/
+    // When filename != "_index": /en/tidbcloud/tidb-cloud/{prefix}/{filename}.md -> /en/tidbcloud/{filename}/
+    {
+      sourcePattern:
+        "/{lang}/tidbcloud/{branch}/tidb-cloud/{...prefixes}/{filename}",
+      targetPattern: "/{lang}/tidbcloud/{filename}",
+      filenameTransform: {
+        ignoreIf: ["_index"],
+        conditionalTarget: {
+          keepIf: ["_index"],
+          keepTargetPattern: "/{lang}/tidbcloud/{prefixes}",
+        },
+      },
+    },
+    // develop namespace in tidb folder
+    // When filename = "_index": /en/tidb/master/develop/{folders}/_index.md -> /en/developer/{folders}/
+    // When filename != "_index": /en/tidb/master/develop/{folders}/{filename}.md -> /en/developer/{filename}/
+    {
+      sourcePattern: `/{lang}/tidb/${CONFIG.docs.tidb.stable}/{folder}/{...folders}/{filename}`,
+      targetPattern: "/{lang}/developer/{filename}",
+      conditions: {
+        folder: ["develop"],
+      },
+      filenameTransform: {
+        ignoreIf: ["_index"],
+        conditionalTarget: {
+          keepIf: ["_index"],
+          keepTargetPattern: "/{lang}/developer/{folders}",
+        },
+      },
+    },
+    // best-practices, api, ai namespace in tidb folder
+    // When filename = "_index": /en/tidb/master/best-practices/{folders}/_index.md -> /en/best-practices/{folders}/
+    // When filename != "_index": /en/tidb/master/api/{folders}/{filename}.md -> /en/api/{filename}/
+    {
+      sourcePattern: `/{lang}/tidb/${CONFIG.docs.tidb.stable}/{folder}/{...folders}/{filename}`,
+      targetPattern: "/{lang}/{folder}/{filename}",
+      conditions: {
+        folder: ["best-practices", "api", "ai"],
+      },
+      filenameTransform: {
+        ignoreIf: ["_index"],
+        conditionalTarget: {
+          keepIf: ["_index"],
+          keepTargetPattern: "/{lang}/{folder}/{folders}",
+        },
+      },
+    },
+    // tidb with branch and optional folders
+    // /en/tidb/master/{...folders}/{filename} -> /en/tidb/stable/{filename}
+    // /en/tidb/release-8.5/{...folders}/{filename} -> /en/tidb/v8.5/{filename}
+    {
+      sourcePattern: "/{lang}/tidb/{branch}/{...folders}/{filename}",
+      targetPattern: "/{lang}/tidb/{branch:branch-alias-tidb}/{filename}",
+      filenameTransform: {
+        ignoreIf: ["_index", "_docHome"],
+      },
+    },
+    // tidb-in-kubernetes with branch and optional folders
+    // /en/tidb-in-kubernetes/main/{...folders}/{filename} -> /en/tidb-in-kubernetes/stable/{filename}
+    // /en/tidb-in-kubernetes/release-1.6/{...folders}/{filename} -> /en/tidb-in-kubernetes/v1.6/{filename}
+    {
+      sourcePattern:
+        "/{lang}/tidb-in-kubernetes/{branch}/{...folders}/{filename}",
+      targetPattern:
+        "/{lang}/tidb-in-kubernetes/{branch:branch-alias-tidb-in-kubernetes}/{filename}",
+      filenameTransform: {
+        ignoreIf: ["_index", "_docHome"],
+      },
+    },
+    // Fallback: /{lang}/{repo}/{...any}/{filename} -> /{lang}/{repo}/{filename}
+    {
+      sourcePattern: "/{lang}/{repo}/{...any}/{filename}",
+      targetPattern: "/{lang}/{repo}/{filename}",
+      filenameTransform: {
+        ignoreIf: ["_index", "_docHome"],
+      },
+    },
+  ],
+
+  aliases: {
+    // Branch alias for tidb: used in {branch:branch-alias-tidb}
+    "branch-alias-tidb": {
+      mappings: {
+        master: "dev",
+        // Exact match for tidb stable branch
+        [CONFIG.docs.tidb.stable]: "stable",
+        // Wildcard pattern: release-* -> v*
+        // Matches any branch starting with "release-" and replaces with "v" prefix
+        // Examples:
+        //   release-8.5 -> v8.5
+        //   release-8.1 -> v8.1
+        //   release-7.5 -> v7.5
+        "release-*": "v*",
+      },
+    },
+    // Branch alias for tidb-in-kubernetes: used in {branch:branch-alias-tidb-in-kubernetes}
+    "branch-alias-tidb-in-kubernetes": {
+      mappings: {
+        main: "dev",
+        // Exact match for tidb-in-kubernetes stable branch
+        [CONFIG.docs["tidb-in-kubernetes"].stable]: "stable",
+        // Wildcard pattern: release-* -> v*
+        // Matches any branch starting with "release-" and replaces with "v" prefix
+        // Examples:
+        //   release-1.6 -> v1.6
+        //   release-1.5 -> v1.5
+        //   release-2.0 -> v2.0
+        "release-*": "v*",
+      },
+    },
+  },
+};
diff --git a/gatsby/url-resolver/index.ts b/gatsby/url-resolver/index.ts
new file mode 100644
index 000000000..e46f39df7
--- /dev/null
+++ b/gatsby/url-resolver/index.ts
@@ -0,0 +1,28 @@
+/**
+ * URL Resolver - Main entry point
+ *
+ * This module provides utilities for:
+ * - Mapping source file paths to published URLs
+ */
+
+// Export types
+export type {
+  PathMappingRule,
+  AliasMapping,
+  AliasPattern,
+  UrlResolverConfig,
+  ParsedSourcePath,
+  FileUrlContext,
+} from "./types";
+
+// Export URL resolver functions
+export { parseSourcePath, calculateFileUrl, calculateFileUrlWithConfig, clearUrlResolverCache } from "./url-resolver";
+
+// Export pattern matcher utilities (for advanced use cases)
+export { matchPattern, applyPattern } from "./pattern-matcher";
+
+// Export alias utilities
+export { getAlias, getVariableAlias } from "./branch-alias";
+
+// Export default configuration
+export { defaultUrlResolverConfig } from "./config";
diff --git a/gatsby/url-resolver/pattern-matcher.ts b/gatsby/url-resolver/pattern-matcher.ts
new file mode 100644
index 000000000..c101b38fa
--- /dev/null
+++ b/gatsby/url-resolver/pattern-matcher.ts
@@ -0,0 +1,223 @@
+/**
+ * Pattern matching utilities for URL resolver
+ */
+
+import { getAlias } from "./branch-alias";
+
+// Cache for parsed pattern parts
+const patternPartsCache = new Map<string, string[]>();
+
+/**
+ * Match path segments against a pattern
+ * Supports patterns with variable number of segments using {...variableName} syntax
+ * Variables are dynamically extracted from the pattern
+ *
+ * Examples:
+ * - {...folders} matches 0 or more segments, accessible as {folders} in target
+ * - {...prefix} matches 0 or more segments, accessible as {prefix} in target
+ */
+export function matchPattern(
+  pattern: string,
+  segments: string[]
+): Record<string, string> | null {
+  // Cache pattern parts parsing
+  let patternParts = patternPartsCache.get(pattern);
+  if (!patternParts) {
+    patternParts = pattern
+      .split("/")
+      .filter((p) => p.length > 0)
+      .filter((p) => !p.startsWith("/"));
+    patternPartsCache.set(pattern, patternParts);
+  }
+
+  const result: Record<string, string> = {};
+  let segmentIndex = 0;
+  let patternIndex = 0;
+
+  while (patternIndex < patternParts.length && segmentIndex < segments.length) {
+    const patternPart = patternParts[patternIndex];
+    const segment = segments[segmentIndex];
+
+    // Handle variable segments pattern {...variableName}
+    // e.g., {...folders} -> variable name is "folders", accessible as {folders} in target
+    if (patternPart.startsWith("{...") && patternPart.endsWith("}")) {
+      // Extract variable name from {...variableName}
+      const variableName = patternPart.slice(4, -1); // Remove "{..." and "}"
+
+      // Find the next pattern part after {...variableName}
+      const nextPatternIndex = patternIndex + 1;
+      if (nextPatternIndex < patternParts.length) {
+        // We need to match the remaining patterns to the remaining segments
+        // The variable segments should be everything between current position and where the next pattern matches
+        const remainingPatterns = patternParts.slice(nextPatternIndex);
+        const remainingSegments = segments.slice(segmentIndex);
+
+        // Calculate how many segments should be consumed by variable segments
+        // The remaining patterns need to match the remaining segments
+        // So variable segments = remainingSegments.length - remainingPatterns.length
+        const variableCount =
+          remainingSegments.length - remainingPatterns.length;
+        if (variableCount >= 0) {
+          // Extract variable segments (can be empty if variableCount is 0)
+          const variableSegments = remainingSegments.slice(0, variableCount);
+          // Store with the variable name (without ...)
+          result[variableName] = variableSegments.join("/");
+          // Continue matching from after variable segments
+          segmentIndex += variableCount;
+          patternIndex++;
+          continue;
+        }
+      } else {
+        // {...variableName} is the last pattern part
+        // All remaining segments are variable segments
+        const variableSegments = segments.slice(segmentIndex);
+        result[variableName] = variableSegments.join("/");
+        segmentIndex = segments.length;
+        patternIndex++;
+        continue;
+      }
+      return null;
+    }
+
+    // Handle regular variable patterns {variable}
+    if (patternPart.startsWith("{") && patternPart.endsWith("}")) {
+      const key = patternPart.slice(1, -1);
+      // Skip colon syntax for now (e.g., {branch:branch-alias} is not used in source pattern)
+      result[key] = segment;
+      segmentIndex++;
+      patternIndex++;
+    } else if (patternPart === segment) {
+      // Literal match
+      segmentIndex++;
+      patternIndex++;
+    } else {
+      // No match
+      return null;
+    }
+  }
+
+  // Handle case where {...variableName} is the last pattern part and there are no more segments
+  // This allows {...variableName} at the end to match 0 segments
+  if (patternIndex < patternParts.length && segmentIndex === segments.length) {
+    const remainingPatternPart = patternParts[patternIndex];
+    if (
+      remainingPatternPart.startsWith("{...") &&
+      remainingPatternPart.endsWith("}")
+    ) {
+      // This is a {...variableName} pattern at the end, allow it to match 0 segments
+      const variableName = remainingPatternPart.slice(4, -1);
+      result[variableName] = "";
+      patternIndex++;
+    }
+  }
+
+  // Check if we consumed all segments and patterns
+  if (
+    segmentIndex !== segments.length ||
+    patternIndex !== patternParts.length
+  ) {
+    return null;
+  }
+
+  return result;
+}
+
+/**
+ * Apply pattern to generate URL from variables
+ * Supports variable references like {folders}, {prefix}, etc.
+ * Empty variables (from {...variableName} matching 0 segments) are skipped
+ * Supports alias syntax: {variable:alias-name} -> uses aliases['alias-name']
+ */
+export function applyPattern(
+  pattern: string,
+  variables: Record<string, string>,
+  config?: {
+    aliases?: {
+      [aliasName: string]: {
+        context?: Record<string, string[]>;
+        mappings: any;
+      };
+    };
+  }
+): string {
+  // Cache pattern parts parsing
+  let parts = patternPartsCache.get(pattern);
+  if (!parts) {
+    parts = pattern
+      .split("/")
+      .filter((p) => p.length > 0)
+      .filter((p) => !p.startsWith("/"));
+    patternPartsCache.set(pattern, parts);
+  }
+
+  const result: string[] = [];
+  for (const part of parts) {
+    if (part.startsWith("{") && part.endsWith("}")) {
+      const key = part.slice(1, -1);
+      // Handle variable:alias-name syntax (e.g., {branch:branch-alias}, {repo:repo-alias})
+      if (key.includes(":")) {
+        const [varKey, aliasName] = key.split(":");
+        const value = variables[varKey];
+
+        if (value && config?.aliases?.[aliasName]) {
+          // Try to get alias from config
+          const aliasConfig = config.aliases[aliasName];
+
+          // Check context conditions if specified
+          let contextMatches = true;
+          if (aliasConfig.context) {
+            for (const [ctxVarName, allowedValues] of Object.entries(
+              aliasConfig.context
+            )) {
+              const ctxValue = variables[ctxVarName];
+              if (ctxValue && allowedValues) {
+                if (!allowedValues.includes(ctxValue)) {
+                  contextMatches = false;
+                  break;
+                }
+              }
+            }
+          }
+
+          if (contextMatches) {
+            const alias = getAlias(aliasConfig.mappings, value);
+            if (alias) {
+              result.push(alias);
+            } else if (value) {
+              result.push(value);
+            }
+          } else if (value) {
+            result.push(value);
+          }
+        } else if (value) {
+          // Fallback to original value if alias not found
+          result.push(value);
+        }
+      } else {
+        const value = variables[key];
+        // Only push if value exists and is not empty
+        // Empty string means {...variableName} matched 0 segments, so skip it
+        if (value && value.length > 0) {
+          // If value contains "/", split and push each segment
+          // This handles cases like folders: "folder1/folder2" -> ["folder1", "folder2"]
+          if (value.includes("/")) {
+            result.push(...value.split("/"));
+          } else {
+            result.push(value);
+          }
+        }
+      }
+    } else {
+      result.push(part);
+    }
+  }
+
+  return "/" + result.join("/");
+}
+
+/**
+ * Clear pattern parts cache (useful for testing or when patterns change)
+ */
+export function clearPatternCache(): void {
+  patternPartsCache.clear();
+}
diff --git a/gatsby/url-resolver/types.ts b/gatsby/url-resolver/types.ts
new file mode 100644
index 000000000..aeba088ed
--- /dev/null
+++ b/gatsby/url-resolver/types.ts
@@ -0,0 +1,86 @@
+/**
+ * Type definitions for URL resolver
+ */
+
+export interface PathMappingRule {
+  // Pattern to match source path segments
+  // e.g., "/{lang}/{repo}/{namespace}/{prefix}/{filename}"
+  sourcePattern: string;
+  // Target URL pattern
+  // e.g., "/{lang}/{repo}/{prefix}/{filename}"
+  targetPattern: string;
+  // Conditions for this rule to apply
+  // Supports arbitrary variables from sourcePattern
+  // e.g., { repo: ["tidbcloud"], folder: ["develop", "api"] }
+  conditions?: Record<string, string[]>;
+  // Special handling for filename
+  filenameTransform?: {
+    ignoreIf?: string[]; // e.g., ["_index"] - ignore filename if it matches
+    // Conditional target pattern based on filename
+    // If filename matches any value in keepIf, use keepTargetPattern, otherwise use targetPattern
+    conditionalTarget?: {
+      keepIf?: string[]; // e.g., ["_index"] - use keepTargetPattern if filename matches
+      keepTargetPattern: string; // Alternative target pattern when filename matches keepIf
+    };
+  };
+}
+
+export interface AliasPattern {
+  // Pattern to match value (supports wildcard * and regex)
+  // e.g., "release-*" or "release-(.*)"
+  pattern: string;
+  // Replacement pattern (supports $1, $2, etc. for captured groups)
+  // e.g., "v$1" for "release-8.5" -> "v8.5"
+  replacement: string;
+  // Whether to use regex matching (default: false, uses wildcard matching)
+  useRegex?: boolean;
+}
+
+export interface AliasMapping {
+  // Value to alias mapping
+  // Can be:
+  // 1. Simple string mapping: { "master": "stable" }
+  // 2. Pattern-based mapping: { "release-*": "v*" } (wildcard)
+  // 3. Regex-based mapping: { pattern: "release-(.*)", replacement: "v$1", useRegex: true }
+  [value: string]: string | AliasPattern;
+}
+
+export interface UrlResolverConfig {
+  // Base path for source files
+  sourceBasePath: string;
+  // Path mapping rules (ordered, first match wins)
+  pathMappings: PathMappingRule[];
+  // Alias mappings for variables
+  // Supports arbitrary alias names like 'branch-alias', 'repo-alias', etc.
+  // Usage in targetPattern: {branch:branch-alias} -> uses aliases['branch-alias']
+  aliases?: {
+    [aliasName: string]: {
+      // Optional context conditions for the alias
+      // e.g., { repo: ["tidb", "tidb-in-kubernetes"] } - only apply when repo matches
+      context?: Record<string, string[]>;
+      // The actual alias mappings
+      mappings: AliasMapping;
+    };
+  };
+  // Default language to omit from URL (e.g., "en" -> /tidb/stable instead of /en/tidb/stable)
+  defaultLanguage?: string;
+  // Control trailing slash behavior
+  // "always" - always add trailing slash
+  // "never" - never add trailing slash
+  // "auto" - add for non-index files, remove for index files (default)
+  trailingSlash?: "always" | "never" | "auto";
+}
+
+export interface ParsedSourcePath {
+  segments: string[];
+  filename: string;
+}
+
+export interface FileUrlContext {
+  lang: string;
+  repo: string;
+  branch?: string;
+  version?: string;
+  prefix?: string;
+  filename?: string;
+}
diff --git a/gatsby/url-resolver/url-resolver.ts b/gatsby/url-resolver/url-resolver.ts
new file mode 100644
index 000000000..be6bfcdb0
--- /dev/null
+++ b/gatsby/url-resolver/url-resolver.ts
@@ -0,0 +1,319 @@
+/**
+ * URL resolver for mapping source file paths to published URLs
+ */
+
+import type {
+  PathMappingRule,
+  UrlResolverConfig,
+  ParsedSourcePath,
+} from "./types";
+import {
+  matchPattern,
+  applyPattern,
+  clearPatternCache,
+} from "./pattern-matcher";
+import { defaultUrlResolverConfig } from "./config";
+
+// Cache for calculateFileUrl results
+// Key: absolutePath + omitDefaultLanguage flag
+// Value: resolved URL or null
+const fileUrlCache = new Map<string, string | null>();
+
+// Cache for parseSourcePath results
+// Key: absolutePath + sourceBasePath
+// Value: ParsedSourcePath or null
+const parsedPathCache = new Map<string, ParsedSourcePath | null>();
+
+/**
+ * Parse source file path into segments and filename
+ * No hardcoded logic - variables will be extracted via pattern matching
+ *
+ * Supports both absolute paths and relative paths (slug format):
+ * - Absolute path: "/path/to/docs/markdown-pages/en/tidb/master/alert-rules.md"
+ * - Relative path (slug): "en/tidb/master/alert-rules" (will be treated as relative to sourceBasePath)
+ *
+ * A path is considered a slug (relative path) if:
+ * - It doesn't start with sourceBasePath
+ * - It doesn't start with "/" (unless it's a valid slug starting with lang code)
+ * - It looks like a slug format (starts with lang code like "en/", "zh/", "ja/")
+ */
+export function parseSourcePath(
+  absolutePath: string,
+  sourceBasePath: string
+): ParsedSourcePath | null {
+  // Check cache first
+  const cacheKey = `${absolutePath}::${sourceBasePath}`;
+  const cached = parsedPathCache.get(cacheKey);
+  if (cached !== undefined) {
+    return cached;
+  }
+
+  // Normalize paths
+  const normalizedBase = sourceBasePath.replace(/\/$/, "");
+  const normalizedPath = absolutePath.replace(/\/$/, "");
+
+  let relativePath: string;
+
+  // Check if path is absolute (starts with sourceBasePath)
+  if (normalizedPath.startsWith(normalizedBase)) {
+    // Absolute path: extract relative path
+    relativePath = normalizedPath.slice(normalizedBase.length);
+  } else {
+    // Check if it looks like a slug (relative path)
+    // Remove leading slash if present for checking
+    const pathWithoutLeadingSlash = normalizedPath.startsWith("/")
+      ? normalizedPath.slice(1)
+      : normalizedPath;
+
+    // Slug format: must start with valid lang code (en/, zh/, ja/)
+    // This ensures we only accept valid slug formats, not arbitrary paths
+    const isSlugFormat = /^(en|zh|ja)\//.test(pathWithoutLeadingSlash);
+
+    if (isSlugFormat) {
+      // Relative path (slug format): use path without leading slash
+      relativePath = pathWithoutLeadingSlash;
+    } else {
+      // Invalid path: doesn't match absolute path and doesn't look like a slug
+      return null;
+    }
+  }
+
+  // Remove leading slash for processing
+  if (relativePath.startsWith("/")) {
+    relativePath = relativePath.slice(1);
+  }
+
+  const segments = relativePath
+    .split("/")
+    .filter((s) => s.length > 0)
+    .filter((s) => !s.startsWith("."));
+
+  if (segments.length < 2) {
+    // At least: lang, filename (or more)
+    return null;
+  }
+
+  // Extract filename (last segment)
+  // If it doesn't have .md extension, add it for consistency
+  let lastSegment = segments[segments.length - 1];
+  if (!lastSegment.endsWith(".md")) {
+    lastSegment = lastSegment + ".md";
+  }
+  const filename = lastSegment.replace(/\.md$/, "");
+
+  // Update segments array to include .md extension if it was added
+  segments[segments.length - 1] = lastSegment;
+
+  const result: ParsedSourcePath = {
+    segments,
+    filename,
+  };
+
+  // Cache the result
+  parsedPathCache.set(cacheKey, result);
+  return result;
+}
+
+/**
+ * Check if conditions are met
+ * Conditions are checked against matched variables from pattern
+ * Supports arbitrary variables from sourcePattern
+ */
+function checkConditions(
+  conditions: PathMappingRule["conditions"],
+  variables: Record<string, string>
+): boolean {
+  if (!conditions) return true;
+
+  // Check each condition - supports arbitrary variable names
+  for (const [variableName, allowedValues] of Object.entries(conditions)) {
+    const variableValue = variables[variableName];
+    if (variableValue && allowedValues) {
+      if (!allowedValues.includes(variableValue)) {
+        return false;
+      }
+    }
+  }
+
+  return true;
+}
+
+/**
+ * Calculate file URL from source path (internal implementation with config)
+ * Variables are dynamically extracted via pattern matching
+ */
+export function calculateFileUrlWithConfig(
+  absolutePath: string,
+  config: UrlResolverConfig,
+  omitDefaultLanguage: boolean = false
+): string | null {
+  // Check cache first
+  const cacheKey = `${absolutePath}::${omitDefaultLanguage}`;
+  const cached = fileUrlCache.get(cacheKey);
+  if (cached !== undefined) {
+    return cached;
+  }
+
+  const parsed = parseSourcePath(absolutePath, config.sourceBasePath);
+  if (!parsed) {
+    // Cache null result
+    fileUrlCache.set(cacheKey, null);
+    return null;
+  }
+
+  // Build segments for pattern matching (include filename)
+  const allSegments = [...parsed.segments];
+
+  // Try each mapping rule in order
+  for (const rule of config.pathMappings) {
+    // Try to match source pattern first to extract variables
+    const variables = matchPattern(rule.sourcePattern, allSegments);
+    if (!variables) {
+      continue;
+    }
+
+    // Replace filename variable with parsed filename (without .md extension)
+    // This ensures conditions can check against the actual filename without extension
+    if (variables.filename) {
+      variables.filename = parsed.filename;
+    }
+
+    // Check conditions using matched variables
+    if (!checkConditions(rule.conditions, variables)) {
+      continue;
+    }
+
+    // Handle filename transform
+    let finalFilename = parsed.filename;
+    if (rule.filenameTransform?.ignoreIf) {
+      if (rule.filenameTransform.ignoreIf.includes(parsed.filename)) {
+        finalFilename = "";
+      }
+    }
+
+    // Determine which target pattern to use
+    let targetPatternToUse = rule.targetPattern;
+    if (rule.filenameTransform?.conditionalTarget?.keepIf) {
+      if (
+        rule.filenameTransform.conditionalTarget.keepIf.includes(
+          parsed.filename
+        )
+      ) {
+        targetPatternToUse =
+          rule.filenameTransform.conditionalTarget.keepTargetPattern;
+      }
+    }
+
+    // Build target URL
+    const targetVars = { ...variables };
+    if (finalFilename) {
+      targetVars.filename = finalFilename;
+    } else {
+      delete targetVars.filename;
+    }
+
+    let url = applyPattern(targetPatternToUse, targetVars, config);
+
+    // Handle default language omission
+    // Only omit if omitDefaultLanguage is explicitly true
+    if (
+      omitDefaultLanguage === true &&
+      config.defaultLanguage &&
+      url.startsWith(`/${config.defaultLanguage}/`)
+    ) {
+      url = url.replace(`/${config.defaultLanguage}/`, "/");
+    }
+
+    // Handle trailing slash based on config
+    const trailingSlash = config.trailingSlash || "auto";
+    if (trailingSlash === "never") {
+      url = url.replace(/\/$/, "");
+    } else if (trailingSlash === "always") {
+      if (!url.endsWith("/")) {
+        url = url + "/";
+      }
+    } else {
+      // "auto" mode: remove trailing slash if filename was ignored, add for non-index files
+      if (!finalFilename && url.endsWith("/")) {
+        url = url.slice(0, -1);
+      } else if (finalFilename && !url.endsWith("/")) {
+        url = url + "/";
+      }
+    }
+
+    return url;
+  }
+
+  // Fallback: use default rule
+  // Extract at least lang and repo from segments
+  if (parsed.segments.length >= 2) {
+    const lang = parsed.segments[0];
+    const repo = parsed.segments[1];
+    let url = `/${lang}/${repo}`;
+    if (parsed.filename && parsed.filename !== "_index") {
+      url = `${url}/${parsed.filename}/`;
+    } else {
+      url = url + "/";
+    }
+
+    // Handle default language omission
+    // Only omit if omitDefaultLanguage is explicitly true
+    if (
+      omitDefaultLanguage === true &&
+      config.defaultLanguage &&
+      url.startsWith(`/${config.defaultLanguage}/`)
+    ) {
+      url = url.replace(`/${config.defaultLanguage}/`, "/");
+    }
+
+    // Handle trailing slash based on config
+    const trailingSlash = config.trailingSlash || "auto";
+    if (trailingSlash === "never") {
+      url = url.replace(/\/$/, "");
+    } else if (trailingSlash === "always") {
+      if (!url.endsWith("/")) {
+        url = url + "/";
+      }
+    }
+    // "auto" mode is already handled above
+
+    // Cache the result before returning
+    fileUrlCache.set(cacheKey, url);
+    return url;
+  }
+
+  // Cache null result
+  fileUrlCache.set(cacheKey, null);
+  // Cache null result
+  fileUrlCache.set(cacheKey, null);
+  return null;
+}
+
+/**
+ * Calculate file URL from source path
+ * Variables are dynamically extracted via pattern matching
+ * Uses global defaultUrlResolverConfig
+ *
+ * @param absolutePath - Absolute path to the source file or slug format (e.g., "en/tidb/master/alert-rules")
+ * @param omitDefaultLanguage - Whether to omit default language prefix (default: false, keeps language prefix)
+ */
+export function calculateFileUrl(
+  absolutePath: string,
+  omitDefaultLanguage: boolean = false
+): string | null {
+  return calculateFileUrlWithConfig(
+    absolutePath,
+    defaultUrlResolverConfig,
+    omitDefaultLanguage
+  );
+}
+
+/**
+ * Clear all caches (useful for testing or when config changes)
+ */
+export function clearUrlResolverCache(): void {
+  fileUrlCache.clear();
+  parsedPathCache.clear();
+  // Also clear pattern cache
+  clearPatternCache();
+}
diff --git a/jest.config.js b/jest.config.js
new file mode 100644
index 000000000..9218ec604
--- /dev/null
+++ b/jest.config.js
@@ -0,0 +1,17 @@
+/**
+ * Jest configuration for TypeScript tests
+ */
+
+module.exports = {
+  roots: ["<rootDir>/gatsby"],
+  testMatch: ["**/__tests__/**/*.test.{ts,tsx,js,jsx}"],
+  transform: {
+    "^.+\\.tsx?$": "ts-jest",
+  },
+  moduleFileExtensions: ["ts", "tsx", "js", "jsx", "json", "node"],
+  collectCoverageFrom: [
+    "gatsby/**/*.{ts,tsx}",
+    "!gatsby/**/*.d.ts",
+    "!gatsby/**/__tests__/**",
+  ],
+};
diff --git a/locale/en/translation.json b/locale/en/translation.json
index cc1ffc25c..8c3ba2a71 100644
--- a/locale/en/translation.json
+++ b/locale/en/translation.json
@@ -20,9 +20,28 @@
     "home": "Home",
     "archive-home": "Archived Docs Home",
     "archive-label": "Archived Docs",
+    "product": "Product",
+    "ai": "AI",
+    "tidbForAI": "TiDB for AI",
+    "developer": "Developer",
+    "bestPractices": "Best Practices",
+    "api": "API",
+    "releases": "Releases",
     "tidb": "TiDB Self-Managed",
     "tools": "Tools",
     "cloud": "TiDB Cloud",
+    "tidbCloudStarter": "TiDB Cloud Starter",
+    "tidbCloudEssential": "TiDB Cloud Essential",
+    "tidbCloudDedicated": "TiDB Cloud Dedicated",
+    "tidbShortTerm": "TiDB",
+    "tidbOnKubernetes": "TiDB on Kubernetes",
+    "tidbCloudReleases": "TiDB Cloud Releases",
+    "tidbSelfManagedReleases": "TiDB Self-Managed Releases",
+    "tidbOperatorReleases": "TiDB Operator Releases",
+    "tiupReleases": "TiUP Releases",
+    "badge": {
+      "preview": "Preview"
+    },
     "appdev": "App Dev",
     "asktug": "Forum",
     "download": "Try TiDB",
@@ -42,7 +61,7 @@
     "notExist": "This doc does not exist",
     "toc": "ON THIS PAGE",
     "contribute": "Contribute",
-    "copy-for-llm": "Copy for LLM",
+    "copy-for-llm": "Copy as Markdown",
     "view-as-markdown": "View as Markdown",
     "download-pdf": "Download PDF",
     "improve": "Edit this page",
diff --git a/locale/ja/translation.json b/locale/ja/translation.json
index 111f9a77b..0ccce517c 100644
--- a/locale/ja/translation.json
+++ b/locale/ja/translation.json
@@ -20,9 +20,28 @@
     "home": "Home",
     "archive-home": "Archived Docs Home",
     "archive-label": "Archived Docs",
+    "product": "製品",
+    "ai": "AI",
+    "tidbForAI": "TiDB for AI",
+    "developer": "開発者向け",
+    "bestPractices": "ベストプラクティス",
+    "api": "API",
+    "releases": "リリース",
     "tidb": "TiDB Self-Managed",
     "tools": "ツール",
     "cloud": "TiDB Cloud",
+    "tidbCloudStarter": "TiDB Cloud Starter",
+    "tidbCloudEssential": "TiDB Cloud Essential",
+    "tidbCloudDedicated": "TiDB Cloud Dedicated",
+    "tidbShortTerm": "TiDB",
+    "tidbOnKubernetes": "TiDB on Kubernetes",
+    "tidbCloudReleases": "TiDB Cloud リリース",
+    "tidbSelfManagedReleases": "TiDB Self-Managed リリース",
+    "tidbOperatorReleases": "TiDB Operator リリース",
+    "tiupReleases": "TiUP リリース",
+    "badge": {
+      "preview": "Preview"
+    },
     "appdev": "アプリ開発",
     "asktug": "Forum",
     "download": "無料ウェビナー",
diff --git a/locale/zh/translation.json b/locale/zh/translation.json
index 6cbd518af..faf70ecc2 100644
--- a/locale/zh/translation.json
+++ b/locale/zh/translation.json
@@ -18,9 +18,28 @@
     "home": "文档中心",
     "archive-home": "归档文档中心",
     "archive-label": "归档文档",
-    "tidb": "TiDB",
+    "product": "产品",
+    "ai": "AI",
+    "tidbForAI": "TiDB for AI",
+    "developer": "应用开发",
+    "bestPractices": "最佳实践",
+    "api": "API",
+    "releases": "发布记录",
+    "tidb": "TiDB Self-Managed",
     "tools": "生态工具",
     "cloud": "TiDB Cloud",
+    "tidbCloudStarter": "TiDB Cloud Starter",
+    "tidbCloudEssential": "TiDB Cloud Essential",
+    "tidbCloudDedicated": "TiDB Cloud Dedicated",
+    "tidbShortTerm": "TiDB",
+    "tidbOnKubernetes": "TiDB on Kubernetes",
+    "tidbCloudReleases": "TiDB Cloud 发布记录",
+    "tidbSelfManagedReleases": "TiDB 版本发布记录",
+    "tidbOperatorReleases": "TiDB Operator 版本发布记录",
+    "tiupReleases": "TiUP 版本发布记录",
+    "badge": {
+      "preview": "Preview"
+    },
     "appdev": "开发指南",
     "asktug": "社区",
     "download": "免费试用",
diff --git a/package.json b/package.json
index 9481a66ff..e20facaaa 100644
--- a/package.json
+++ b/package.json
@@ -78,8 +78,9 @@
     "@ti-fe/cli": "^0.12.0",
     "@ti-fe/prettier-config": "^1.0.3",
     "@types/fs-extra": "^11.0.4",
+    "@types/jest": "^30.0.0",
     "@types/mdx-js__react": "^1.5.5",
-    "@types/node": "^17.0.21",
+    "@types/node": "^25.0.7",
     "@types/react-dom": "^18.0.5",
     "@types/signale": "^1.4.3",
     "anafanafo": "^1.0.0",
@@ -89,11 +90,13 @@
     "gatsby-plugin-root-import": "^2.0.8",
     "husky": "^7.0.4",
     "is-ci": "^3.0.1",
+    "jest": "^30.2.0",
     "lint-staged": "^12.1.2",
     "patch-package": "^8.0.0",
     "pegjs": "^0.10.0",
     "prettier": "2.5.1",
     "sass": "^1.45.0",
+    "ts-jest": "^29.4.6",
     "ts-node": "^10.4.0",
     "typescript": "^4.5.4"
   },
@@ -103,12 +106,13 @@
   "license": "MIT",
   "scripts": {
     "postinstall": "patch-package",
+    "dev": "yarn start",
     "start": "gatsby develop",
     "start:0.0.0.0": "gatsby develop -H 0.0.0.0",
     "build": "gatsby build",
     "serve": "gatsby serve",
     "clean": "gatsby clean",
-    "test": "jest --coverage --roots src",
+    "test": "jest --coverage --roots gatsby",
     "prepare": "is-ci || husky install"
   },
   "lint-staged": {
diff --git a/src/components/Card/FeedbackSection/FeedbackSection.tsx b/src/components/Card/FeedbackSection/FeedbackSection.tsx
index 979c5c76b..6e76e11f6 100644
--- a/src/components/Card/FeedbackSection/FeedbackSection.tsx
+++ b/src/components/Card/FeedbackSection/FeedbackSection.tsx
@@ -8,6 +8,7 @@ import {
   Radio,
   FormControlLabel,
   TextField,
+  Button,
 } from "@mui/material";
 import { ThumbUpOutlined, ThumbDownOutlined } from "@mui/icons-material";
 import { Locale } from "shared/interface";
@@ -15,12 +16,7 @@ import { useState } from "react";
 import { trackCustomEvent } from "gatsby-plugin-google-analytics";
 import { submitFeedbackDetail, submitLiteFeedback } from "./tracking";
 import { FeedbackCategory } from "./types";
-import {
-  ActionButton,
-  controlLabelSx,
-  labelProps,
-  radioSx,
-} from "./components";
+import { controlLabelSx, labelProps, radioSx } from "./components";
 
 interface FeedbackSectionProps {
   title: string;
@@ -120,8 +116,9 @@ export function FeedbackSection({ title, locale }: FeedbackSectionProps) {
       </Typography>
       {thumbVisible && (
         <Stack direction="row" spacing={2} mb="48px">
-          <ActionButton
+          <Button
             variant="outlined"
+            color="secondary"
             size="small"
             startIcon={<ThumbUpOutlined sx={{ width: 14, height: 14 }} />}
             className="FeedbackBtn-thumbUp"
@@ -129,9 +126,10 @@ export function FeedbackSection({ title, locale }: FeedbackSectionProps) {
             onClick={() => onThumbClick(true)}
           >
             <Trans i18nKey="docHelpful.thumbUp" />
-          </ActionButton>
-          <ActionButton
+          </Button>
+          <Button
             variant="outlined"
+            color="secondary"
             size="small"
             startIcon={<ThumbDownOutlined sx={{ width: 14, height: 14 }} />}
             className="FeedbackBtn-thumbDown"
@@ -139,7 +137,7 @@ export function FeedbackSection({ title, locale }: FeedbackSectionProps) {
             onClick={() => onThumbClick(false)}
           >
             <Trans i18nKey="docHelpful.thumbDown" />
-          </ActionButton>
+          </Button>
         </Stack>
       )}
       {surveyVisible && helpful && (
@@ -204,17 +202,23 @@ export function FeedbackSection({ title, locale }: FeedbackSectionProps) {
           </Stack>
 
           <Stack direction="row" spacing={2} mt="12px" mb="24px">
-            <ActionButton
+            <Button
               variant="outlined"
+              color="secondary"
               size="small"
               disabled={!positiveVal}
               onClick={onPositiveSubmit}
             >
               <Trans i18nKey="docFeedbackSurvey.action.submit" />
-            </ActionButton>
-            <ActionButton variant="outlined" size="small" onClick={onSkip}>
+            </Button>
+            <Button
+              variant="outlined"
+              color="secondary"
+              size="small"
+              onClick={onSkip}
+            >
               <Trans i18nKey="docFeedbackSurvey.action.skip" />
-            </ActionButton>
+            </Button>
           </Stack>
         </Box>
       )}
@@ -289,17 +293,23 @@ export function FeedbackSection({ title, locale }: FeedbackSectionProps) {
           </Stack>
 
           <Stack direction="row" spacing={2} mt="12px" mb="24px">
-            <ActionButton
+            <Button
               variant="outlined"
+              color="secondary"
               size="small"
               disabled={!negativeVal}
               onClick={onNegativeSubmit}
             >
               <Trans i18nKey="docFeedbackSurvey.action.submit" />
-            </ActionButton>
-            <ActionButton variant="outlined" size="small" onClick={onSkip}>
+            </Button>
+            <Button
+              variant="outlined"
+              color="secondary"
+              size="small"
+              onClick={onSkip}
+            >
               <Trans i18nKey="docFeedbackSurvey.action.skip" />
-            </ActionButton>
+            </Button>
           </Stack>
         </Box>
       )}
diff --git a/src/components/Card/FeedbackSection/components.ts b/src/components/Card/FeedbackSection/components.ts
index a4972391f..2035e2fcf 100644
--- a/src/components/Card/FeedbackSection/components.ts
+++ b/src/components/Card/FeedbackSection/components.ts
@@ -1,18 +1,5 @@
 import { Button, styled } from "@mui/material";
 
-export const ActionButton = styled(Button)(({ theme }) => ({
-  backgroundColor: "#F9F9F9",
-  borderColor: "#D9D9D9",
-  color: theme.palette.text.primary,
-  "&:hover": {
-    backgroundColor: "#F9F9F9",
-    borderColor: theme.palette.text.primary,
-  },
-  ".MuiButton-startIcon": {
-    marginRight: 4,
-  },
-}));
-
 export const controlLabelSx = {
   ml: 0,
   py: "6px",
diff --git a/src/components/Layout/Banner/Banner.tsx b/src/components/Layout/Banner/Banner.tsx
index 75024decb..8ab44b4d5 100644
--- a/src/components/Layout/Banner/Banner.tsx
+++ b/src/components/Layout/Banner/Banner.tsx
@@ -1,4 +1,6 @@
-import { Box, Divider, Stack, Typography } from "@mui/material";
+import * as React from "react";
+import { Box, Stack, Typography } from "@mui/material";
+import { HEADER_HEIGHT } from "shared/headerHeight";
 
 export function Banner({
   url,
@@ -17,14 +19,12 @@ export function Banner({
     <Box
       sx={{
         flexShrink: 0,
-        minHeight: "1.5rem",
+        height: HEADER_HEIGHT.BANNER,
         backgroundColor: bgColor || "var(--tiui-palette-peacock-100)",
         // backgroundImage: `url(${bgImgSrc})`,
         backgroundPosition: "bottom left",
         backgroundSize: "400px auto",
         backgroundRepeat: "no-repeat",
-        paddingTop: "0.5rem",
-        paddingBottom: "0.5rem",
       }}
     >
       <Stack
@@ -56,7 +56,7 @@ export function Banner({
         {textList.map((text, index) =>
           typeof text === "string" ? (
             <Typography
-              key={index}
+              key={`banner-text-${index}`}
               component="span"
               variant="body2"
               color="inherit"
@@ -65,7 +65,7 @@ export function Banner({
               {text}
             </Typography>
           ) : (
-            text
+            <React.Fragment key={`banner-node-${index}`}>{text}</React.Fragment>
           )
         )}
       </Stack>
diff --git a/src/components/Layout/Header.tsx b/src/components/Layout/Header.tsx
deleted file mode 100644
index 106a4fa93..000000000
--- a/src/components/Layout/Header.tsx
+++ /dev/null
@@ -1,177 +0,0 @@
-import * as React from "react";
-import AppBar from "@mui/material/AppBar";
-import Box from "@mui/material/Box";
-import Toolbar from "@mui/material/Toolbar";
-import { useTheme } from "@mui/material/styles";
-
-import LinkComponent, { BlueAnchorLink } from "components/Link";
-import HeaderNavStack, {
-  HeaderNavStackMobile,
-} from "components/Layout/HeaderNav";
-import HeaderAction from "components/Layout/HeaderAction";
-
-import TiDBLogo from "media/logo/tidb-logo-withtext.svg";
-
-import { Locale, BuildType, PathConfig } from "shared/interface";
-import { GTMEvent, gtmTrack } from "shared/utils/gtm";
-import { Banner } from "./Banner";
-import { generateDocsHomeUrl, generateUrl } from "shared/utils";
-import { useI18next } from "gatsby-plugin-react-i18next";
-import { useIsAutoTranslation } from "shared/useIsAutoTranslation";
-import { ErrorOutlineOutlined } from "@mui/icons-material";
-
-interface HeaderProps {
-  bannerEnabled?: boolean;
-  menu?: React.ReactNode;
-  locales: Locale[];
-  docInfo?: { type: string; version: string };
-  buildType?: BuildType;
-  pageUrl?: string;
-  name?: string;
-  pathConfig?: PathConfig;
-}
-
-export default function Header(props: HeaderProps) {
-  const { language } = useI18next();
-  const theme = useTheme();
-
-  return (
-    <AppBar
-      className="doc-site-header"
-      position="fixed"
-      sx={{
-        zIndex: 9,
-        backgroundColor: "carbon.50",
-        boxShadow: "none",
-        height: props.bannerEnabled ? "7.5rem" : "5rem",
-      }}
-    >
-      <HeaderBanner {...props} />
-
-      <Toolbar
-        sx={{
-          height: "100%",
-          paddingLeft: "24px",
-          paddingRight: "24px",
-          borderBottom: `1px solid ${theme.palette.carbon[400]}`,
-        }}
-      >
-        {props.menu}
-        <Box
-          sx={{
-            display: {
-              xs: "none",
-              md: "block",
-            },
-          }}
-        >
-          <LinkComponent
-            to={generateDocsHomeUrl(language)}
-            onClick={() =>
-              gtmTrack(GTMEvent.ClickHeadNav, {
-                item_name: "logo",
-              })
-            }
-          >
-            <TiDBLogo />
-          </LinkComponent>
-        </Box>
-
-        <HeaderNavStack buildType={props.buildType} pageUrl={props.pageUrl} />
-        <HeaderNavStackMobile buildType={props.buildType} />
-
-        <HeaderAction
-          supportedLocales={props.locales}
-          docInfo={props.docInfo}
-          buildType={props.buildType}
-          pageUrl={props.pageUrl}
-        />
-      </Toolbar>
-    </AppBar>
-  );
-}
-
-const HeaderBanner = (props: HeaderProps) => {
-  const { t } = useI18next();
-  const isAutoTranslation = useIsAutoTranslation(props.pageUrl || "");
-  const urlAutoTranslation =
-    props.pathConfig?.repo === "tidbcloud"
-      ? `/tidbcloud/${props.name === "_index" ? "" : props.name}`
-      : `/${props.pathConfig?.repo}/${props.pathConfig?.version || "stable"}/${
-          props.name === "_index" ? "" : props.name
-        }`;
-
-  let archivedTargetUrl = "";
-  if (props.name && props.pathConfig) {
-    const stableCfg = { ...props.pathConfig, version: "stable" };
-    const path = generateUrl(props.name, stableCfg);
-    archivedTargetUrl = `https://docs.pingcap.com${path}`;
-  } else {
-    const lang =
-      props.pathConfig?.locale === Locale.en
-        ? ""
-        : `/${props.pathConfig?.locale}`;
-    archivedTargetUrl = `https://docs.pingcap.com${lang}/tidb/stable/`;
-  }
-
-  if (props.buildType === "archive") {
-    return (
-      <Banner
-        bgColor="#FEFBF3"
-        textColor="#AE6D0C"
-        logo={
-          <ErrorOutlineOutlined sx={{ fontSize: "1rem", color: "#F2AA18" }} />
-        }
-        textList={[
-          t("banner.archive.title"),
-          <BlueAnchorLink to={archivedTargetUrl} target="_blank">
-            {t("banner.archive.viewLatestLTSVersion")} ↗
-          </BlueAnchorLink>,
-        ]}
-      />
-    );
-  }
-
-  if (isAutoTranslation) {
-    return (
-      <Banner
-        // bgColor="#FEFBF3"
-        // textColor="#AE6D0C"
-        // logo={
-        //   <ErrorOutlineOutlined sx={{ fontSize: "1rem", color: "#F2AA18" }} />
-        // }
-        logo={"📣"}
-        textList={[
-          <BlueAnchorLink
-            to="https://www.pingcap.com/blog/tidb-cloud-essential-now-available-public-preview-aws-alibaba-cloud/"
-            target="_blank"
-          >
-            {t("banner.autoTrans.title1")}
-          </BlueAnchorLink>,
-          t("banner.autoTrans.title2"),
-          <BlueAnchorLink to={urlAutoTranslation} target="_blank">
-            {t("banner.autoTrans.end")}
-          </BlueAnchorLink>,
-        ]}
-      />
-    );
-  }
-
-  return props.bannerEnabled ? (
-    <Banner
-      logo={"📣"}
-      textList={[
-        <BlueAnchorLink
-          to="https://www.pingcap.com/blog/tidb-cloud-essential-now-available-public-preview-aws-alibaba-cloud/"
-          target="_blank"
-        >
-          {t("banner.campaign.title1")}
-        </BlueAnchorLink>,
-        t("banner.campaign.title2"),
-        <BlueAnchorLink to={t("banner.campaign.link")} target="_blank">
-          {t("banner.campaign.end")}
-        </BlueAnchorLink>,
-      ]}
-    />
-  ) : null;
-};
diff --git a/src/components/Layout/Header/HeaderAction.tsx b/src/components/Layout/Header/HeaderAction.tsx
new file mode 100644
index 000000000..0aad7c7db
--- /dev/null
+++ b/src/components/Layout/Header/HeaderAction.tsx
@@ -0,0 +1,210 @@
+import * as React from "react";
+import { useI18next } from "gatsby-plugin-react-i18next";
+
+import Stack from "@mui/material/Stack";
+import Button from "@mui/material/Button";
+import Menu from "@mui/material/Menu";
+import MenuItem from "@mui/material/MenuItem";
+import IconButton from "@mui/material/IconButton";
+import Typography from "@mui/material/Typography";
+import StarIcon from "media/icons/star.svg";
+
+import CloudIcon from "@mui/icons-material/Cloud";
+import { useTheme } from "@mui/material/styles";
+
+import Search from "components/Search";
+
+import { Locale, BuildType, TOCNamespace } from "shared/interface";
+import { Link } from "gatsby";
+import { useIsAutoTranslation } from "shared/useIsAutoTranslation";
+
+const useTiDBAIStatus = () => {
+  const [showTiDBAIButton, setShowTiDBAIButton] = React.useState(true);
+  const [initializingTiDBAI, setInitializingTiDBAI] = React.useState(true);
+
+  React.useEffect(() => {
+    if (!!window.tidbai) {
+      setInitializingTiDBAI(false);
+    }
+
+    const onTiDBAIInitialized = () => {
+      setInitializingTiDBAI(false);
+    };
+    const onTiDBAIError = () => {
+      setInitializingTiDBAI(false);
+      setShowTiDBAIButton(false);
+    };
+    window.addEventListener("tidbaiinitialized", onTiDBAIInitialized);
+    window.addEventListener("tidbaierror", onTiDBAIError);
+
+    const timer = setTimeout(() => {
+      if (!window.tidbai) {
+        setInitializingTiDBAI(false);
+        setShowTiDBAIButton(false);
+      }
+    }, 10000);
+    return () => {
+      clearTimeout(timer);
+      window.removeEventListener("tidbaiinitialized", onTiDBAIInitialized);
+      window.removeEventListener("tidbaierror", onTiDBAIError);
+    };
+  }, []);
+
+  return { showTiDBAIButton, initializingTiDBAI };
+};
+
+export default function HeaderAction(props: {
+  supportedLocales: Locale[];
+  docInfo?: { type: string; version: string };
+  buildType?: BuildType;
+  namespace: TOCNamespace;
+}) {
+  const { docInfo, buildType, namespace } = props;
+  const { language, t } = useI18next();
+  const { showTiDBAIButton, initializingTiDBAI } = useTiDBAIStatus();
+  const isAutoTranslation = useIsAutoTranslation(namespace);
+
+	  return (
+	    <Stack
+	      direction="row"
+	      spacing={{ xs: 1, md: 2 }}
+	      sx={{ alignItems: "center" }}
+	    >
+      {docInfo && !isAutoTranslation && buildType !== "archive" && (
+        <>
+          <Search placeholder={t("navbar.searchDocs")} docInfo={docInfo} />
+          {language === "en" && showTiDBAIButton && (
+            <Button
+              id="header-ask-ai"
+              variant="outlined"
+              startIcon={<StarIcon />}
+              disabled={initializingTiDBAI}
+              size="medium"
+              sx={{
+                fontSize: "14px",
+                display: {
+                  xs: "none",
+                  xl: "flex",
+                },
+              }}
+              onClick={() => {
+                window.tidbai.open = true;
+              }}
+            >
+              Ask AI
+            </Button>
+          )}
+        </>
+      )}
+      {language === "en" && <TiDBCloudBtnGroup />}
+    </Stack>
+  );
+}
+
+const TiDBCloudBtnGroup = () => {
+  const theme = useTheme();
+  const [anchorEl, setAnchorEl] = React.useState<null | HTMLElement>(null);
+  const open = Boolean(anchorEl);
+  const handleClick = (event: React.MouseEvent<HTMLButtonElement>) => {
+    setAnchorEl(event.currentTarget);
+  };
+  const handleClose = () => {
+    setAnchorEl(null);
+  };
+
+  return (
+    <>
+      <Stack
+        direction="row"
+        spacing={2}
+        display={{
+          xs: "none",
+          xl: "flex",
+        }}
+      >
+        <Button
+          variant="outlined"
+          color="secondary"
+          href={`https://tidbcloud.com/signin`}
+          // https://developer.chrome.com/blog/referrer-policy-new-chrome-default/
+          referrerPolicy="no-referrer-when-downgrade"
+          target="_blank"
+          size="medium"
+          sx={{
+            fontSize: "14px",
+          }}
+        >
+          Sign In
+        </Button>
+        <Button
+          variant="contained"
+          color="secondary"
+          target="_blank"
+          href="https://tidbcloud.com/free-trial"
+          // https://developer.chrome.com/blog/referrer-policy-new-chrome-default/
+          referrerPolicy="no-referrer-when-downgrade"
+          size="medium"
+          sx={{
+            fontSize: "14px",
+          }}
+        >
+          Start for Free
+        </Button>
+      </Stack>
+
+      {/* Mobile menu */}
+      <IconButton
+        id="tidb-cloud-menu-button"
+        aria-controls={open ? "tidb-cloud-menu" : undefined}
+        aria-haspopup="true"
+        aria-expanded={open ? "true" : undefined}
+        onClick={handleClick}
+        sx={{
+          display: {
+            xs: "inline-flex",
+            xl: "none",
+          },
+        }}
+      >
+        <CloudIcon
+          sx={{ width: 17, height: 17, fill: theme.palette.carbon[900] }}
+        />
+      </IconButton>
+      <Menu
+        id="tidb-cloud-menu"
+        anchorEl={anchorEl}
+        open={open}
+        onClose={handleClose}
+        MenuListProps={{
+          "aria-labelledby": "idb-cloud-menu-button",
+        }}
+      >
+        <MenuItem
+          component={Link}
+          to={`https://tidbcloud.com/signin`}
+          target="_blank"
+          referrerPolicy="no-referrer-when-downgrade"
+          sx={{
+            textDecoration: "none",
+          }}
+        >
+          <Typography>Sign In</Typography>
+        </MenuItem>
+        <MenuItem
+          onClick={() => {
+            handleClose();
+          }}
+          component={Link}
+          to={`https://tidbcloud.com/free-trial`}
+          target="_blank"
+          referrerPolicy="no-referrer-when-downgrade"
+          sx={{
+            textDecoration: "none",
+          }}
+        >
+          <Typography>Try Free</Typography>
+        </MenuItem>
+      </Menu>
+    </>
+  );
+};
diff --git a/src/components/Layout/Header/HeaderNav.tsx b/src/components/Layout/Header/HeaderNav.tsx
new file mode 100644
index 000000000..0f34b9dd2
--- /dev/null
+++ b/src/components/Layout/Header/HeaderNav.tsx
@@ -0,0 +1,618 @@
+import * as React from "react";
+import { useI18next } from "gatsby-plugin-react-i18next";
+import Box from "@mui/material/Box";
+import Typography from "@mui/material/Typography";
+import Stack from "@mui/material/Stack";
+import { useTheme } from "@mui/material/styles";
+import MenuItem from "@mui/material/MenuItem";
+import Popover from "@mui/material/Popover";
+import Divider from "@mui/material/Divider";
+
+import LinkComponent from "components/Link";
+import { BuildType, TOCNamespace } from "shared/interface";
+import { GTMEvent, gtmTrack } from "shared/utils/gtm";
+import { useCloudPlan } from "shared/useCloudPlan";
+import ChevronDownIcon from "media/icons/chevron-down.svg";
+import {
+  NavConfig,
+  NavGroupConfig,
+  NavItemConfig,
+} from "./HeaderNavConfigType";
+import { generateNavConfig } from "./HeaderNavConfigData";
+import { clearAllNavStates } from "../LeftNav/LeftNavTree";
+import { getSelectedNavItem } from "./getSelectedNavItem";
+
+export default function HeaderNavStack(props: {
+  buildType?: BuildType;
+  config?: NavConfig[];
+  namespace?: TOCNamespace;
+  onSelectedNavItemChange?: (item: NavItemConfig | null) => void;
+}) {
+  const { language, t } = useI18next();
+  const { cloudPlan } = useCloudPlan();
+
+  // Default configuration (backward compatible)
+  const defaultConfig: NavConfig[] = React.useMemo(() => {
+    if (props.config) {
+      return props.config;
+    }
+    // Use new config generator
+    return generateNavConfig(t, cloudPlan, props.buildType, language);
+  }, [props.config, props.buildType, cloudPlan, t, language]);
+
+  // Find and notify selected item
+  React.useEffect(() => {
+    if (props.onSelectedNavItemChange) {
+      const selectedNavItem = getSelectedNavItem(defaultConfig, props.namespace);
+      props.onSelectedNavItemChange(selectedNavItem);
+    }
+  }, [defaultConfig, props.namespace, props.onSelectedNavItemChange]);
+
+  return (
+    <Stack
+      direction="row"
+      spacing={3}
+      sx={{
+        height: "100%",
+        flexShrink: 0,
+        display: {
+          xs: "none",
+          md: "flex",
+        },
+      }}
+    >
+      {defaultConfig.map((navConfig, index) => {
+        // Check condition
+        if (
+          navConfig.condition &&
+          !navConfig.condition(language, props.buildType)
+        ) {
+          return null;
+        }
+
+        return (
+          <NavGroup
+            key={index}
+            config={navConfig}
+            namespace={props.namespace}
+            language={language}
+          />
+        );
+      })}
+    </Stack>
+  );
+}
+
+const NavGroup = (props: {
+  config: NavConfig;
+  namespace?: TOCNamespace;
+  language?: string;
+}) => {
+  const { config } = props;
+  const theme = useTheme();
+  const [anchorEl, setAnchorEl] = React.useState<HTMLElement | null>(null);
+  const open = Boolean(anchorEl);
+  const closeTimeoutRef = React.useRef<NodeJS.Timeout | null>(null);
+
+  // Check if this is an item or a group without children
+  const isItem = config.type === "item";
+  const isGroupWithoutChildren =
+    config.type === "group" &&
+    (!config.children || config.children.length === 0);
+  const shouldShowPopover = !isItem && !isGroupWithoutChildren;
+
+  const handlePopoverOpen = (event: React.MouseEvent<HTMLElement>) => {
+    // Clear any pending close timeout
+    if (closeTimeoutRef.current) {
+      clearTimeout(closeTimeoutRef.current);
+      closeTimeoutRef.current = null;
+    }
+    setAnchorEl(event.currentTarget);
+  };
+
+  const handlePopoverClose = () => {
+    // Add a small delay before closing to allow moving to the popover
+    closeTimeoutRef.current = setTimeout(() => {
+      setAnchorEl(null);
+    }, 100);
+  };
+
+  const handlePopoverKeepOpen = () => {
+    // Clear any pending close timeout when mouse enters popover
+    if (closeTimeoutRef.current) {
+      clearTimeout(closeTimeoutRef.current);
+      closeTimeoutRef.current = null;
+    }
+  };
+
+  const handlePopoverToggle = (event: React.MouseEvent<HTMLElement>) => {
+    // Toggle popover on click
+    if (anchorEl) {
+      // If already open, close it immediately
+      if (closeTimeoutRef.current) {
+        clearTimeout(closeTimeoutRef.current);
+        closeTimeoutRef.current = null;
+      }
+      setAnchorEl(null);
+    } else {
+      // If closed, open it
+      handlePopoverOpen(event);
+    }
+  };
+
+  const handlePopoverCloseImmediate = () => {
+    // Close popover immediately (for click outside)
+    if (closeTimeoutRef.current) {
+      clearTimeout(closeTimeoutRef.current);
+      closeTimeoutRef.current = null;
+    }
+    setAnchorEl(null);
+  };
+
+  React.useEffect(() => {
+    return () => {
+      // Cleanup timeout on unmount
+      if (closeTimeoutRef.current) {
+        clearTimeout(closeTimeoutRef.current);
+      }
+    };
+  }, []);
+
+  // Check if this item/group is selected
+  const isSelected: boolean =
+    isItem && typeof config.selected === "function"
+      ? config.selected(props.namespace)
+      : isItem
+      ? ((config.selected ?? false) as boolean)
+      : false;
+
+  // Check if any child is selected (recursively check nested groups)
+  const hasSelectedChild =
+    !isItem && config.type === "group" && config.children
+      ? config.children.some((child) => {
+          if (child.type === "item") {
+            const childSelected =
+              typeof child.selected === "function"
+                ? child.selected(props.namespace)
+                : child.selected ?? false;
+            return childSelected;
+          } else {
+            // For nested groups, check if any nested child is selected
+            return child.children.some((nestedChild) => {
+              if (nestedChild.type === "item") {
+                const nestedSelected =
+                  typeof nestedChild.selected === "function"
+                    ? nestedChild.selected(props.namespace)
+                    : nestedChild.selected ?? false;
+                return nestedSelected;
+              }
+              return false;
+            });
+          }
+        })
+      : false;
+
+  return (
+    <>
+      <NavButton
+        config={config}
+        isItem={isItem}
+        selected={isSelected}
+        hasSelectedChild={hasSelectedChild}
+        shouldShowPopover={shouldShowPopover}
+        open={open}
+        onMouseEnter={handlePopoverOpen}
+        onMouseLeave={handlePopoverClose}
+        onClick={shouldShowPopover ? handlePopoverToggle : undefined}
+        language={props.language}
+      />
+
+      {shouldShowPopover && (
+        <Popover
+          id="mouse-over-popover"
+          open={open}
+          anchorEl={anchorEl}
+          anchorOrigin={{
+            vertical: "bottom",
+            horizontal: "left",
+          }}
+          transformOrigin={{
+            vertical: "top",
+            horizontal: "left",
+          }}
+          onClose={handlePopoverCloseImmediate}
+          disableRestoreFocus
+          sx={{ pointerEvents: "none" }}
+          PaperProps={{
+            onMouseEnter: handlePopoverKeepOpen,
+            onMouseLeave: handlePopoverClose,
+            sx: {
+              border: "1px solid #F4F4F4",
+              boxShadow: "0px 8px 32px 0px rgba(0, 0, 0, 0.08)",
+              pointerEvents: "auto",
+              padding: "16px",
+              marginTop: "8px",
+            },
+          }}
+        >
+          {(() => {
+            if (config.type !== "group" || !config.children) {
+              return null;
+            }
+            const groups = config.children.filter(
+              (child) => child.type === "group"
+            );
+            const items = config.children.filter(
+              (child) => child.type === "item"
+            );
+
+            return (
+              <>
+                {groups.length > 0 && (
+                  <Box display="flex" flexDirection="row" gap="0">
+                    {groups.map((child, index) => (
+                      <React.Fragment key={index}>
+                        <Box
+                          display="flex"
+                          flexDirection="column"
+                          gap="4px"
+                          minWidth="200px"
+                        >
+                          <GroupTitle
+                            title={child.title}
+                            titleIcon={child.titleIcon}
+                          />
+                          {child.children.map((nestedChild, nestedIndex) => {
+                            if (nestedChild.type === "item") {
+                              return (
+                                <NavMenuItem
+                                  key={`${index}-${nestedIndex}`}
+                                  item={nestedChild}
+                                  groupTitle={child.title}
+                                  namespace={props.namespace}
+                                  onClose={handlePopoverCloseImmediate}
+                                  language={props.language}
+                                />
+                              );
+                            }
+                            return null;
+                          })}
+                        </Box>
+                        {index < groups.length - 1 && (
+                          <Divider
+                            orientation="vertical"
+                            flexItem
+                            sx={{
+                              borderColor: theme.palette.carbon[400],
+                              margin: "0 16px",
+                            }}
+                          />
+                        )}
+                      </React.Fragment>
+                    ))}
+                  </Box>
+                )}
+                {items.length > 0 && (
+                  <Box
+                    display="flex"
+                    flexDirection="column"
+                    gap="4px"
+                    minWidth="200px"
+                  >
+                    {items.map((child, index) => (
+                      <NavMenuItem
+                        key={index}
+                        item={child}
+                        namespace={props.namespace}
+                        onClose={handlePopoverCloseImmediate}
+                        language={props.language}
+                      />
+                    ))}
+                  </Box>
+                )}
+              </>
+            );
+          })()}
+        </Popover>
+      )}
+    </>
+  );
+};
+
+// Group title component
+const GroupTitle = (props: {
+  title: string | React.ReactNode;
+  titleIcon?: React.ReactNode;
+}) => {
+  const theme = useTheme();
+  if (!props.title) return null;
+  return (
+    <Typography
+      variant="subtitle2"
+      component="div"
+      sx={{
+        padding: "12px 8px",
+        color: theme.palette.carbon[900],
+        fontSize: "16px",
+        fontWeight: 700,
+        display: "inline-flex",
+        alignItems: "center",
+        gap: 1,
+      }}
+    >
+      {props.titleIcon && (
+        <Box sx={{ display: "flex", alignItems: "center" }}>
+          {props.titleIcon}
+        </Box>
+      )}
+      {props.title}
+    </Typography>
+  );
+};
+
+// Menu item component
+const NavMenuItem = (props: {
+  item: NavItemConfig;
+  groupTitle?: string | React.ReactNode;
+  namespace?: TOCNamespace;
+  onClose: () => void;
+  language?: string;
+}) => {
+  const { item, groupTitle, namespace, onClose, language } = props;
+  const isSelected =
+    typeof item.selected === "function"
+      ? item.selected(namespace)
+      : item.selected ?? false;
+
+  const isDisabled =
+    typeof item.disabled === "function"
+      ? item.disabled(language || "")
+      : item.disabled ?? false;
+
+  const menuItemContent = (
+    <MenuItem
+      onClick={() => {
+        if (isDisabled) return;
+        clearAllNavStates();
+        onClose();
+        item.onClick?.();
+      }}
+      disableRipple
+      selected={isSelected}
+      disabled={isDisabled}
+      sx={{
+        padding: groupTitle ? "10px 12px" : "8px 12px",
+        opacity: isDisabled ? 0.5 : 1,
+        cursor: isDisabled ? "not-allowed" : "pointer",
+      }}
+    >
+      <Box
+        sx={{
+          display: "flex",
+          alignItems: "center",
+          gap: 1,
+          width: "100%",
+        }}
+      >
+        {item.startIcon && (
+          <Box
+            sx={{
+              display: "flex",
+              alignItems: "center",
+            }}
+          >
+            {item.startIcon}
+          </Box>
+        )}
+        <Typography component="span" sx={{ fontSize: "14px" }}>
+          {item.label}
+        </Typography>
+        {item.endIcon && (
+          <Box
+            sx={{
+              display: "flex",
+              alignItems: "center",
+              marginLeft: "auto",
+            }}
+          >
+            {item.endIcon}
+          </Box>
+        )}
+      </Box>
+    </MenuItem>
+  );
+
+  if (isDisabled) {
+    return menuItemContent;
+  }
+
+  return (
+    <LinkComponent
+      isI18n={item.isI18n ?? true}
+      to={item.to}
+      style={{ width: "100%", textDecoration: "none" }}
+      onClick={() => {
+        gtmTrack(GTMEvent.ClickHeadNav, {
+          item_name: item.label || item.alt,
+        });
+      }}
+    >
+      {menuItemContent}
+    </LinkComponent>
+  );
+};
+
+// Nav button component (for both item and group)
+const NavButton = (props: {
+  config: NavConfig;
+  isItem: boolean;
+  selected: boolean;
+  hasSelectedChild: boolean;
+  shouldShowPopover: boolean;
+  open: boolean;
+  onMouseEnter?: (event: React.MouseEvent<HTMLElement>) => void;
+  onMouseLeave?: () => void;
+  onClick?: (event: React.MouseEvent<HTMLElement>) => void;
+  language?: string;
+}) => {
+  const {
+    config,
+    isItem,
+    selected,
+    hasSelectedChild,
+    shouldShowPopover,
+    open,
+    onMouseEnter,
+    onMouseLeave,
+    onClick,
+    language,
+  } = props;
+  const theme = useTheme();
+  const label = isItem
+    ? (config as NavItemConfig).label
+    : (config as NavGroupConfig).title;
+  const to = isItem ? (config as NavItemConfig).to : undefined;
+  const startIcon = isItem
+    ? (config as NavItemConfig).startIcon
+    : (config as NavGroupConfig).titleIcon;
+  const endIcon = isItem ? (config as NavItemConfig).endIcon : undefined;
+  const alt = isItem ? (config as NavItemConfig).alt : undefined;
+  const isI18n = isItem ? (config as NavItemConfig).isI18n ?? true : true;
+  const disabled = isItem
+    ? (() => {
+        const itemDisabled = (config as NavItemConfig).disabled;
+        if (typeof itemDisabled === "function") {
+          return itemDisabled(language || "");
+        }
+        return itemDisabled ?? false;
+      })()
+    : false;
+
+  // Determine selected state for border styling
+  const isSelectedState = isItem ? selected : hasSelectedChild;
+
+  return (
+    <>
+      {isItem && to ? (
+        // Render as link for item (or disabled text if disabled)
+        disabled ? (
+          <Typography
+            variant="body1"
+            component="div"
+            padding="4px 12px"
+            sx={{
+              display: "inline-flex",
+              boxSizing: "border-box",
+              alignItems: "center",
+              gap: 0.5,
+              fontSize: "16px",
+              color: theme.palette.carbon[400],
+              height: "100%",
+              fontWeight: 400,
+              opacity: 0.5,
+              cursor: "not-allowed",
+            }}
+          >
+            {startIcon}
+            {label}
+            {endIcon}
+          </Typography>
+        ) : (
+          <LinkComponent
+            isI18n={isI18n}
+            to={to}
+            onClick={() => {
+              clearAllNavStates();
+              gtmTrack(GTMEvent.ClickHeadNav, {
+                item_name: label || alt,
+              });
+              if (isItem) {
+                (config as NavItemConfig).onClick?.();
+              }
+            }}
+          >
+            <Typography
+              variant="body1"
+              component="div"
+              padding="4px 12px"
+              sx={{
+                display: "inline-flex",
+                boxSizing: "border-box",
+                alignItems: "center",
+                gap: 0.5,
+                fontSize: "16px",
+                color: theme.palette.carbon[900],
+                height: "100%",
+                paddingBottom: isSelectedState ? "0" : "4px",
+                borderBottom: isSelectedState
+                  ? `4px solid ${theme.palette.primary.main}`
+                  : ``,
+                fontWeight: isSelectedState ? 700 : 400,
+              }}
+            >
+              {startIcon}
+              {label}
+              {endIcon}
+            </Typography>
+          </LinkComponent>
+        )
+      ) : (
+        // Render as button for group (with or without popover)
+        <Box
+          aria-owns={
+            shouldShowPopover && open ? "mouse-over-popover" : undefined
+          }
+          aria-haspopup={shouldShowPopover ? "true" : undefined}
+          aria-expanded={shouldShowPopover ? open : undefined}
+          onMouseEnter={shouldShowPopover ? onMouseEnter : undefined}
+          onMouseLeave={shouldShowPopover ? onMouseLeave : undefined}
+          onClick={shouldShowPopover ? onClick : undefined}
+          sx={{
+            cursor: shouldShowPopover ? "pointer" : "default",
+            display: "inline-flex",
+            boxSizing: "border-box",
+            alignItems: "center",
+            gap: 0.5,
+            padding: "4px 12px",
+            height: "100%",
+            paddingBottom: isSelectedState ? "0" : "4px",
+            borderBottom: isSelectedState
+              ? `4px solid ${theme.palette.primary.main}`
+              : ``,
+          }}
+        >
+          {startIcon && (
+            <Box sx={{ display: "flex", alignItems: "center" }}>
+              {startIcon}
+            </Box>
+          )}
+          {label && (
+            <Typography
+              variant="body1"
+              component="div"
+              sx={{
+                display: "inline-flex",
+                alignItems: "center",
+                gap: 0.5,
+                fontSize: 16,
+                fontWeight: isSelectedState ? 700 : 400,
+                color: theme.palette.carbon[900],
+              }}
+            >
+              {label}
+            </Typography>
+          )}
+          {shouldShowPopover && (
+            <ChevronDownIcon
+              sx={{
+                fill: theme.palette.carbon[900],
+                transform: open ? "rotate(180deg)" : "rotate(0deg)",
+                transition: "transform 0.2s",
+              }}
+            />
+          )}
+        </Box>
+      )}
+    </>
+  );
+};
diff --git a/src/components/Layout/Header/HeaderNavConfigData.tsx b/src/components/Layout/Header/HeaderNavConfigData.tsx
new file mode 100644
index 000000000..6983d1371
--- /dev/null
+++ b/src/components/Layout/Header/HeaderNavConfigData.tsx
@@ -0,0 +1,218 @@
+import { NavConfig } from "./HeaderNavConfigType";
+import { CLOUD_MODE_KEY } from "shared/useCloudPlan";
+import { CloudPlan, TOCNamespace } from "shared/interface";
+import OpenInNewIcon from "@mui/icons-material/OpenInNew";
+import Chip from "@mui/material/Chip";
+import { useTheme } from "@mui/material/styles";
+
+import TiDBCloudIcon from "media/icons/cloud-03.svg";
+import TiDBIcon from "media/icons/layers-three-01.svg";
+
+const PreviewBadge = (props: { label: string }) => {
+  const theme = useTheme();
+  return (
+    <Chip
+      label={props.label}
+      size="small"
+      variant="outlined"
+      sx={{
+        height: "20px",
+        fontSize: "12px",
+        fontWeight: 400,
+        borderRadius: "10px",
+        pointerEvents: "none",
+        "& .MuiChip-label": {
+          paddingLeft: "8px",
+          paddingRight: "8px",
+          lineHeight: "20px",
+          color: theme.palette.carbon[700],
+        },
+      }}
+    />
+  );
+};
+
+/**
+ * Default navigation configuration
+ */
+const getDefaultNavConfig = (
+  t: (key: string) => string,
+  cloudPlan: CloudPlan | null
+): NavConfig[] => [
+  {
+    type: "group",
+    title: t("navbar.product"),
+    children: [
+      {
+        type: "group",
+        title: t("navbar.cloud"),
+        titleIcon: <TiDBCloudIcon width="16px" height="16px" />,
+        children: [
+          {
+            type: "item",
+            label: t("navbar.tidbCloudStarter"),
+            to: `/tidbcloud/starter?${CLOUD_MODE_KEY}=${CloudPlan.Starter}`,
+            selected: (namespace) =>
+              namespace === TOCNamespace.TiDBCloud &&
+              cloudPlan === CloudPlan.Starter,
+            onClick: () => {
+              if (typeof window !== "undefined") {
+                sessionStorage.setItem(CLOUD_MODE_KEY, CloudPlan.Starter);
+              }
+            },
+          },
+          {
+            type: "item",
+            label: t("navbar.tidbCloudEssential"),
+            endIcon: <PreviewBadge label={t("navbar.badge.preview")} />,
+            to: `/tidbcloud/essential?${CLOUD_MODE_KEY}=${CloudPlan.Essential}`,
+            selected: (namespace) =>
+              namespace === TOCNamespace.TiDBCloud &&
+              cloudPlan === CloudPlan.Essential,
+            onClick: () => {
+              if (typeof window !== "undefined") {
+                sessionStorage.setItem(CLOUD_MODE_KEY, CloudPlan.Essential);
+              }
+            },
+          },
+          // {
+          //   type: "item",
+          //   label: "TiDB Cloud Premium",
+          //   to: `/tidbcloud/premium?${CLOUD_MODE_KEY}=premium`,
+          //   selected: (namespace) =>
+          //     namespace === TOCNamespace.TiDBCloud &&
+          //     cloudPlan === CloudPlan.Premium,
+          //   onClick: () => {
+          //     if (typeof window !== "undefined") {
+          //       sessionStorage.setItem(CLOUD_MODE_KEY, "premium");
+          //     }
+          //   },
+          // },
+          {
+            type: "item",
+            label: t("navbar.tidbCloudDedicated"),
+            to:
+              cloudPlan === CloudPlan.Dedicated || !cloudPlan
+                ? `/tidbcloud`
+                : `/tidbcloud?${CLOUD_MODE_KEY}=${CloudPlan.Dedicated}`,
+            selected: (namespace) =>
+              namespace === TOCNamespace.TiDBCloud &&
+              cloudPlan === CloudPlan.Dedicated,
+            onClick: () => {
+              if (typeof window !== "undefined") {
+                sessionStorage.setItem(CLOUD_MODE_KEY, CloudPlan.Dedicated);
+              }
+            },
+          },
+        ],
+      },
+      {
+        type: "group",
+        title: t("navbar.tidb"),
+        titleIcon: <TiDBIcon width="16px" height="16px" />,
+        children: [
+          {
+            type: "item",
+            label: t("navbar.tidbShortTerm"),
+            leftNavLabel: t("navbar.tidb"),
+            to: "/tidb/stable",
+            selected: (namespace) => namespace === TOCNamespace.TiDB,
+          },
+          {
+            type: "item",
+            label: t("navbar.tidbOnKubernetes"),
+            to: "/tidb-in-kubernetes/stable",
+            selected: (namespace) =>
+              namespace === TOCNamespace.TiDBInKubernetes,
+            disabled: (lang: string) => lang === "ja",
+          },
+        ],
+      },
+    ],
+  },
+  {
+    type: "item",
+    label: t("navbar.ai"),
+    leftNavLabel: t("navbar.tidbForAI"),
+    to: "/ai",
+    selected: (namespace) => namespace === TOCNamespace.AI,
+  },
+  {
+    type: "item",
+    label: t("navbar.developer"),
+    to: "/developer",
+    selected: (namespace) => namespace === TOCNamespace.Develop,
+  },
+  {
+    type: "item",
+    label: t("navbar.bestPractices"),
+    to: "/best-practices",
+    selected: (namespace) => namespace === TOCNamespace.BestPractices,
+  },
+  {
+    type: "item",
+    label: t("navbar.api"),
+    to: "/api",
+    selected: (namespace) => namespace === TOCNamespace.API,
+  },
+  {
+    type: "group",
+    title: t("navbar.releases"),
+    children: [
+      {
+        type: "item",
+        label: t("navbar.tidbCloudReleases"),
+        to: "/releases/tidb-cloud",
+        selected: (namespace) => namespace === TOCNamespace.TidbCloudReleases,
+      },
+      {
+        type: "item",
+        label: t("navbar.tidbSelfManagedReleases"),
+        to: "/releases/tidb-self-managed",
+        selected: (namespace) => namespace === TOCNamespace.TiDBReleases,
+      },
+      {
+        type: "item",
+        label: t("navbar.tidbOperatorReleases"),
+        to: "/releases/tidb-operator",
+        selected: (namespace) =>
+          namespace === TOCNamespace.TiDBInKubernetesReleases,
+        disabled: (lang: string) => lang === "ja",
+      },
+      {
+        type: "item",
+        label: t("navbar.tiupReleases"),
+        to: "https://github.com/pingcap/tiup/releases",
+        selected: () => false,
+        endIcon: <OpenInNewIcon sx={{ fontSize: "14px", marginLeft: "4px" }} />,
+      },
+    ],
+  },
+];
+
+/**
+ * Archive navigation configuration (only TiDB Self-Managed)
+ */
+const archiveNavConfig: NavConfig[] = [
+  {
+    type: "item",
+    label: "TiDB Self-Managed",
+    to: "/tidb/v2.1",
+    selected: (namespace) => namespace === TOCNamespace.TiDB,
+  },
+];
+
+/**
+ * Generate navigation configuration
+ */
+export const generateNavConfig = (
+  t: (key: string) => string,
+  cloudPlan: CloudPlan | null,
+  buildType?: string,
+  language?: string
+): NavConfig[] => {
+  if (buildType === "archive") {
+    return archiveNavConfig;
+  }
+  return getDefaultNavConfig(t, cloudPlan);
+};
diff --git a/src/components/Layout/Header/HeaderNavConfigType.ts b/src/components/Layout/Header/HeaderNavConfigType.ts
new file mode 100644
index 000000000..742d567c3
--- /dev/null
+++ b/src/components/Layout/Header/HeaderNavConfigType.ts
@@ -0,0 +1,51 @@
+import { ReactNode } from "react";
+import { TOCNamespace } from "shared/interface";
+
+/**
+ * Single navigation item configuration
+ */
+export interface NavItemConfig {
+  type: "item";
+  /** Navigation label */
+  label: string | ReactNode;
+  /** Optional alias label displayed in left navigation title */
+  leftNavLabel?: string | ReactNode;
+  /** Navigation URL */
+  to: string;
+  /** Optional icon before label */
+  startIcon?: ReactNode;
+  /** Optional icon after label */
+  endIcon?: ReactNode;
+  /** Optional alt text for GTM tracking */
+  alt?: string;
+  /** Whether this item is selected (can be a function that returns boolean) */
+  selected?: boolean | ((namespace?: TOCNamespace) => boolean);
+  /** Optional click handler */
+  onClick?: () => void;
+  /** Whether to use i18n for the link */
+  isI18n?: boolean;
+  /** Condition to show this item */
+  condition?: (language: string, buildType?: string) => boolean;
+  /** Whether this item is disabled (can be a function that returns boolean based on language) */
+  disabled?: boolean | ((language: string) => boolean);
+}
+
+/**
+ * Navigation group configuration
+ */
+export interface NavGroupConfig {
+  type: "group";
+  /** Group title (empty string means no title displayed) */
+  title: string | ReactNode;
+  /** Optional icon before title */
+  titleIcon?: ReactNode;
+  /** Children navigation items or nested groups */
+  children: (NavItemConfig | NavGroupConfig)[];
+  /** Condition to show this group */
+  condition?: (language: string, buildType?: string) => boolean;
+}
+
+/**
+ * Navigation configuration (either item or group)
+ */
+export type NavConfig = NavItemConfig | NavGroupConfig;
diff --git a/src/components/Layout/Header/HeaderNavMobile.tsx b/src/components/Layout/Header/HeaderNavMobile.tsx
new file mode 100644
index 000000000..108c964f5
--- /dev/null
+++ b/src/components/Layout/Header/HeaderNavMobile.tsx
@@ -0,0 +1,348 @@
+import * as React from "react";
+import { useI18next } from "gatsby-plugin-react-i18next";
+import Box from "@mui/material/Box";
+import Typography from "@mui/material/Typography";
+import Button from "@mui/material/Button";
+import { useTheme } from "@mui/material/styles";
+import Menu from "@mui/material/Menu";
+import MenuItem from "@mui/material/MenuItem";
+import Divider from "@mui/material/Divider";
+
+import LinkComponent from "components/Link";
+import ChevronDownIcon from "media/icons/chevron-down.svg";
+import { BuildType, TOCNamespace } from "shared/interface";
+import { GTMEvent, gtmTrack } from "shared/utils/gtm";
+
+import TiDBLogo from "media/logo/tidb-logo-withtext.svg";
+import { useCloudPlan } from "shared/useCloudPlan";
+import {
+  NavConfig,
+  NavItemConfig,
+  NavGroupConfig,
+} from "./HeaderNavConfigType";
+import { generateNavConfig } from "./HeaderNavConfigData";
+import { clearAllNavStates } from "../LeftNav/LeftNavTree";
+
+export function HeaderNavStackMobile(props: {
+  buildType?: BuildType;
+  namespace?: TOCNamespace;
+}) {
+  const [anchorEl, setAnchorEl] = React.useState<null | HTMLElement>(null);
+
+  const theme = useTheme();
+  const { language, t } = useI18next();
+  const { cloudPlan } = useCloudPlan();
+  const open = Boolean(anchorEl);
+  const handleClick = (event: React.MouseEvent<HTMLElement>) => {
+    setAnchorEl(event.currentTarget);
+  };
+  const handleClose = () => {
+    setAnchorEl(null);
+  };
+
+  // Generate navigation config
+  const navConfig: NavConfig[] = React.useMemo(() => {
+    return generateNavConfig(t, cloudPlan, props.buildType, language);
+  }, [t, cloudPlan, props.buildType, language]);
+
+  return (
+    <Box
+      color={theme.palette.website.m5}
+      sx={{
+        display: {
+          md: "none",
+        },
+      }}
+    >
+      <Button
+        id="header-nav-items"
+        aria-controls={open ? "nav-menu" : undefined}
+        aria-haspopup="true"
+        aria-expanded={open ? "true" : undefined}
+        disableElevation
+        onClick={handleClick}
+        color="inherit"
+        startIcon={
+          <TiDBLogo width={132} height={28.8} />
+        }
+        endIcon={<ChevronDownIcon />}
+      ></Button>
+      <Menu
+        id="header-nav-menu"
+        anchorEl={anchorEl}
+        open={open}
+        onClose={handleClose}
+        elevation={0}
+        anchorOrigin={{
+          vertical: "bottom",
+          horizontal: "center",
+        }}
+        transformOrigin={{
+          vertical: "top",
+          horizontal: "center",
+        }}
+        PaperProps={{
+          sx: {
+            maxHeight: "80vh",
+            overflowY: "auto",
+          },
+        }}
+      >
+        {navConfig
+          .filter((config) => {
+            // Filter out configs that don't meet condition
+            if (
+              config.condition &&
+              !config.condition(language, props.buildType)
+            ) {
+              return false;
+            }
+            return true;
+          })
+          .flatMap((config, index) => {
+            const items: React.ReactNode[] = [];
+            if (index > 0) {
+              items.push(<Divider key={`divider-${index}`} />);
+            }
+            items.push(
+              <RenderNavConfig
+                key={`config-${index}`}
+                config={config}
+                namespace={props.namespace}
+                onClose={handleClose}
+                language={language}
+              />
+            );
+            return items;
+          })}
+      </Menu>
+    </Box>
+  );
+}
+
+// Recursive component to render nav config (item or group)
+const RenderNavConfig = (props: {
+  config: NavConfig;
+  namespace?: TOCNamespace;
+  onClose: () => void;
+  language?: string;
+}) => {
+  const { config, namespace, onClose, language } = props;
+
+  if (config.type === "item") {
+    return (
+      <NavMenuItem item={config} namespace={namespace} onClose={onClose} language={language} />
+    );
+  }
+
+  // Handle group
+  if (config.type === "group") {
+    const groups = config.children.filter(
+      (child) => child.type === "group"
+    ) as NavGroupConfig[];
+    const items = config.children.filter(
+      (child) => child.type === "item"
+    ) as NavItemConfig[];
+
+    // Don't render if no children
+    if (groups.length === 0 && items.length === 0) {
+      return null;
+    }
+
+    return (
+      <>
+        {/* Render group title if it exists */}
+        {config.title && (
+          <Box
+            sx={{
+              padding: "12px 16px 8px",
+              display: "flex",
+              alignItems: "center",
+              gap: 1,
+            }}
+          >
+            {config.titleIcon && (
+              <Box sx={{ display: "flex", alignItems: "center" }}>
+                {config.titleIcon}
+              </Box>
+            )}
+            <Typography
+              variant="subtitle2"
+              component="div"
+              sx={{
+                fontSize: "14px",
+                fontWeight: 700,
+                color: "carbon.900",
+              }}
+            >
+              {config.title}
+            </Typography>
+          </Box>
+        )}
+
+        {/* Render nested groups */}
+        {groups.map((group, groupIndex) => {
+          const groupItems = group.children.filter(
+            (child) => child.type === "item"
+          ) as NavItemConfig[];
+
+          if (groupItems.length === 0) {
+            return null;
+          }
+
+          return (
+            <React.Fragment key={`group-${groupIndex}`}>
+              {groupIndex > 0 && <Divider sx={{ margin: "8px 0" }} />}
+              {group.title && (
+                <Box
+                  sx={{
+                    padding: "8px 16px 4px",
+                    display: "flex",
+                    alignItems: "center",
+                    gap: 1,
+                  }}
+                >
+                  {group.titleIcon && (
+                    <Box sx={{ display: "flex", alignItems: "center" }}>
+                      {group.titleIcon}
+                    </Box>
+                  )}
+                  <Typography
+                    variant="subtitle2"
+                    component="div"
+                    sx={{
+                      fontSize: "13px",
+                      fontWeight: 600,
+                      color: "carbon.700",
+                    }}
+                  >
+                    {group.title}
+                  </Typography>
+                </Box>
+              )}
+              {groupItems.map((child, childIndex) => (
+                <NavMenuItem
+                  key={`group-${groupIndex}-item-${childIndex}`}
+                  item={child}
+                  namespace={namespace}
+                  onClose={onClose}
+                  language={language}
+                />
+              ))}
+            </React.Fragment>
+          );
+        })}
+
+        {/* Render direct items */}
+        {items.map((item, itemIndex) => (
+          <NavMenuItem
+            key={`item-${itemIndex}`}
+            item={item}
+            namespace={namespace}
+            onClose={onClose}
+            language={language}
+          />
+        ))}
+      </>
+    );
+  }
+
+  return null;
+};
+
+// Menu item component
+const NavMenuItem = (props: {
+  item: NavItemConfig;
+  namespace?: TOCNamespace;
+  onClose: () => void;
+  language?: string;
+}) => {
+  const { item, namespace, onClose, language } = props;
+  const isSelected =
+    typeof item.selected === "function"
+      ? item.selected(namespace)
+      : item.selected ?? false;
+
+  const isDisabled =
+    typeof item.disabled === "function"
+      ? item.disabled(language || "")
+      : item.disabled ?? false;
+
+  const menuItemContent = (
+    <MenuItem
+      onClick={() => {
+        if (isDisabled) return;
+        clearAllNavStates();
+        onClose();
+        item.onClick?.();
+      }}
+      disableRipple
+      selected={isSelected}
+      disabled={isDisabled}
+      sx={{
+        padding: "10px 16px",
+        opacity: isDisabled ? 0.5 : 1,
+        cursor: isDisabled ? "not-allowed" : "pointer",
+      }}
+    >
+      <Box
+        sx={{
+          display: "flex",
+          alignItems: "center",
+          gap: 1,
+          width: "100%",
+        }}
+      >
+          {item.startIcon && (
+            <Box
+              sx={{
+                display: "flex",
+                alignItems: "center",
+              }}
+            >
+              {item.startIcon}
+            </Box>
+          )}
+          <Typography
+            component="span"
+            sx={{
+              fontSize: "14px",
+              fontWeight: isSelected ? 600 : 400,
+            }}
+          >
+            {item.label}
+          </Typography>
+          {item.endIcon && (
+            <Box
+              sx={{
+                display: "flex",
+                alignItems: "center",
+                marginLeft: "auto",
+              }}
+            >
+              {item.endIcon}
+            </Box>
+          )}
+        </Box>
+    </MenuItem>
+  );
+
+  if (isDisabled) {
+    return menuItemContent;
+  }
+
+  return (
+    <LinkComponent
+      isI18n={item.isI18n ?? true}
+      to={item.to}
+      style={{ width: "100%", textDecoration: "none" }}
+      onClick={() => {
+        gtmTrack(GTMEvent.ClickHeadNav, {
+          item_name: item.label || item.alt,
+        });
+      }}
+    >
+      {menuItemContent}
+    </LinkComponent>
+  );
+};
diff --git a/src/components/Layout/Header/LangSwitch.tsx b/src/components/Layout/Header/LangSwitch.tsx
new file mode 100644
index 000000000..325b96cf1
--- /dev/null
+++ b/src/components/Layout/Header/LangSwitch.tsx
@@ -0,0 +1,135 @@
+import * as React from "react";
+import { Trans, useI18next } from "gatsby-plugin-react-i18next";
+
+import Box from "@mui/material/Box";
+import Typography from "@mui/material/Typography";
+import Button from "@mui/material/Button";
+import Menu from "@mui/material/Menu";
+import MenuItem from "@mui/material/MenuItem";
+import IconButton from "@mui/material/IconButton";
+import { useTheme } from "@mui/material/styles";
+
+import TranslateIcon from "media/icons/globe-02.svg";
+import ChevronDownIcon from "media/icons/chevron-down.svg";
+
+import { Locale } from "shared/interface";
+
+const LANG_MAP = {
+  [Locale.en]: "English",
+  [Locale.zh]: "简体中文",
+  [Locale.ja]: "日本語",
+};
+
+export const LangSwitch = (props: {
+  language?: string;
+  changeLanguage?: () => void;
+  supportedLocales: Locale[];
+}) => {
+  const { supportedLocales } = props;
+
+  const [anchorEl, setAnchorEl] = React.useState<null | HTMLElement>(null);
+
+  const theme = useTheme();
+  const { language, changeLanguage } = useI18next();
+
+  const open = Boolean(anchorEl);
+  const handleClick = (event: React.MouseEvent<HTMLElement>) => {
+    setAnchorEl(event.currentTarget);
+  };
+  const handleClose = () => {
+    setAnchorEl(null);
+  };
+
+  const toggleLanguage = (locale: Locale) => () => {
+    changeLanguage(locale);
+    handleClose();
+  };
+
+  return (
+    <Box color={theme.palette.carbon[900]}>
+      <IconButton
+        onClick={handleClick}
+        sx={{
+          color: "inherit",
+          display: {
+            lg: "none",
+          },
+        }}
+      >
+        <TranslateIcon />
+      </IconButton>
+      <Button
+        id="header-lang-switch"
+        aria-controls={open ? "languages-menu" : undefined}
+        aria-haspopup="true"
+        aria-expanded={open ? "true" : undefined}
+        disableElevation
+        onClick={handleClick}
+        color="inherit"
+        startIcon={<TranslateIcon sx={{ fill: theme.palette.carbon[900] }} />}
+        endIcon={<ChevronDownIcon sx={{ fill: theme.palette.carbon[900] }} />}
+        size="large"
+        sx={{
+          display: {
+            xs: "none",
+            lg: "inline-flex",
+          },
+        }}
+      >
+        {LANG_MAP[language as Locale]}
+      </Button>
+      <Menu
+        id="header-lang-menu"
+        anchorEl={anchorEl}
+        open={open}
+        onClose={handleClose}
+        elevation={0}
+        anchorOrigin={{
+          vertical: "bottom",
+          horizontal: "left",
+        }}
+        transformOrigin={{
+          vertical: "top",
+          horizontal: "left",
+        }}
+        PaperProps={{
+          sx: {
+            border: "1px solid #F4F4F4",
+            filter: "drop-shadow(0px 1px 4px rgba(0, 0, 0, 0.08))",
+          },
+        }}
+      >
+        <MenuItem
+          onClick={toggleLanguage(Locale.en)}
+          disableRipple
+          selected={language === Locale.en}
+          disabled={!supportedLocales.includes(Locale.en)}
+        >
+          <Typography component="span">
+            <Trans i18nKey="lang.en" />
+          </Typography>
+        </MenuItem>
+        <MenuItem
+          onClick={toggleLanguage(Locale.zh)}
+          disableRipple
+          selected={language === Locale.zh}
+          disabled={!supportedLocales.includes(Locale.zh)}
+        >
+          <Typography component="span">
+            <Trans i18nKey="lang.zh" />
+          </Typography>
+        </MenuItem>
+        <MenuItem
+          onClick={toggleLanguage(Locale.ja)}
+          disableRipple
+          selected={language === Locale.ja}
+          disabled={!supportedLocales.includes(Locale.ja)}
+        >
+          <Typography component="span">
+            <Trans i18nKey="lang.ja" />
+          </Typography>
+        </MenuItem>
+      </Menu>
+    </Box>
+  );
+};
diff --git a/src/components/Layout/Header/getSelectedNavItem.ts b/src/components/Layout/Header/getSelectedNavItem.ts
new file mode 100644
index 000000000..75ddec0dd
--- /dev/null
+++ b/src/components/Layout/Header/getSelectedNavItem.ts
@@ -0,0 +1,27 @@
+import { TOCNamespace } from "shared/interface";
+import { NavConfig, NavItemConfig } from "./HeaderNavConfigType";
+
+export const getSelectedNavItem = (
+  configs: NavConfig[],
+  namespace?: TOCNamespace
+): NavItemConfig | null => {
+  for (const config of configs) {
+    if (config.type === "item") {
+      const isSelected =
+        typeof config.selected === "function"
+          ? config.selected(namespace)
+          : config.selected ?? false;
+      if (isSelected) {
+        return config;
+      }
+      continue;
+    }
+
+    const item = getSelectedNavItem(config.children, namespace);
+    if (item) {
+      return item;
+    }
+  }
+  return null;
+};
+
diff --git a/src/components/Layout/Header/index.tsx b/src/components/Layout/Header/index.tsx
new file mode 100644
index 000000000..ab929798d
--- /dev/null
+++ b/src/components/Layout/Header/index.tsx
@@ -0,0 +1,517 @@
+import * as React from "react";
+import Box from "@mui/material/Box";
+import IconButton from "@mui/material/IconButton";
+import { useTheme } from "@mui/material/styles";
+
+import LinkComponent, { BlueAnchorLink } from "components/Link";
+import HeaderNavStack from "components/Layout/Header/HeaderNav";
+import { HeaderNavStackMobile } from "components/Layout/Header/HeaderNavMobile";
+import HeaderAction from "components/Layout/Header/HeaderAction";
+import { LangSwitch } from "components/Layout/Header/LangSwitch";
+
+import TiDBLogo from "media/logo/tidb-logo-withtext.svg";
+
+import { Locale, BuildType, PathConfig, TOCNamespace } from "shared/interface";
+import { GTMEvent, gtmTrack } from "shared/utils/gtm";
+import { Banner } from "components/Layout/Banner";
+import { generateDocsHomeUrl, generateUrl } from "shared/utils";
+import { useI18next } from "gatsby-plugin-react-i18next";
+import { useIsAutoTranslation } from "shared/useIsAutoTranslation";
+import { ErrorOutlineOutlined, ArrowUpward } from "@mui/icons-material";
+import { HEADER_HEIGHT } from "shared/headerHeight";
+
+import { NavItemConfig } from "./HeaderNavConfigType";
+
+interface HeaderProps {
+  bannerEnabled?: boolean;
+  children?: React.ReactNode;
+  menu?: React.ReactNode;
+  locales: Locale[];
+  docInfo?: { type: string; version: string };
+  buildType?: BuildType;
+  name?: string;
+  pathConfig?: PathConfig;
+  namespace: TOCNamespace;
+  onSelectedNavItemChange?: (item: NavItemConfig | null) => void;
+}
+
+const clamp = (value: number, min: number, max: number): number => {
+  return Math.min(max, Math.max(min, value));
+};
+
+const LOGO_GAP = 24;
+const CSS_VAR_TRANSLATE_X = "--pc-docs-header-translate-x";
+const CSS_VAR_LOGO_SCALE = "--pc-docs-header-logo-scale";
+
+export default function Header(props: HeaderProps) {
+  const { language } = useI18next();
+  const theme = useTheme();
+  const isAutoTranslation = useIsAutoTranslation(props.namespace);
+  const bannerVisible =
+    props.buildType === "archive" || isAutoTranslation || !!props.bannerEnabled;
+
+  const firstRowHeightPx = React.useMemo(() => {
+    return Number.parseInt(HEADER_HEIGHT.FIRST_ROW, 10);
+  }, []);
+
+  const cssVarRootRef = React.useRef<HTMLDivElement | null>(null);
+  const leftClusterRef = React.useRef<HTMLDivElement | null>(null);
+  const logoMeasureRef = React.useRef<HTMLDivElement | null>(null);
+  const leftClusterWidthRef = React.useRef(0);
+  const logoWidthRef = React.useRef(0);
+  const [showBackToTop, setShowBackToTop] = React.useState(false);
+  const showBackToTopRef = React.useRef(false);
+
+  const handleBackToTop = React.useCallback(() => {
+    if (typeof window === "undefined") {
+      return;
+    }
+    window.scrollTo({ top: 0, behavior: "smooth" });
+  }, []);
+
+  const syncScrollStyles = React.useCallback(() => {
+    if (typeof window === "undefined") {
+      return;
+    }
+    const root = cssVarRootRef.current;
+    if (!root) {
+      return;
+    }
+
+    const y = window.scrollY || 0;
+    const progress = clamp(y / firstRowHeightPx, 0, 1);
+    const logoScale = 1 - progress * 0.2;
+
+    const logoWidth = logoWidthRef.current;
+    const leftClusterWidth = leftClusterWidthRef.current;
+    root.style.setProperty(CSS_VAR_LOGO_SCALE, `${logoScale}`);
+    if (logoWidth === 0 || leftClusterWidth === 0) {
+      // Keep the last known translateX (or SSR value) until we have sizes.
+      return;
+    }
+
+    const menuWidth = Math.max(0, leftClusterWidth - logoWidth);
+    const translateX =
+      progress * (menuWidth + logoWidth * logoScale + LOGO_GAP);
+
+    root.style.setProperty(CSS_VAR_TRANSLATE_X, `${translateX}px`);
+  }, [firstRowHeightPx]);
+
+  const updateLeftClusterSizes = React.useCallback(() => {
+    if (typeof window === "undefined") {
+      return;
+    }
+
+    const clusterElement = leftClusterRef.current;
+    if (clusterElement) {
+      const rect = clusterElement.getBoundingClientRect();
+      if (rect.width !== 0) {
+        leftClusterWidthRef.current = rect.width;
+      }
+    }
+
+    const logoElement = logoMeasureRef.current;
+    if (logoElement) {
+      const rect = logoElement.getBoundingClientRect();
+      if (rect.width !== 0) {
+        logoWidthRef.current = rect.width;
+      }
+    }
+    syncScrollStyles();
+  }, [firstRowHeightPx, syncScrollStyles]);
+
+  React.useEffect(() => {
+    if (typeof window === "undefined") {
+      return;
+    }
+
+    let rafId: number | null = null;
+    const measure = () => {
+      updateLeftClusterSizes();
+    };
+    rafId = window.requestAnimationFrame(measure);
+    window.addEventListener("resize", measure);
+
+    return () => {
+      if (rafId != null) {
+        window.cancelAnimationFrame(rafId);
+      }
+      window.removeEventListener("resize", measure);
+    };
+  }, [updateLeftClusterSizes]);
+
+  React.useEffect(() => {
+    if (typeof window === "undefined") {
+      return;
+    }
+
+    let ticking = false;
+    let rafId: number | null = null;
+    const update = () => {
+      syncScrollStyles();
+      const y = window.scrollY || 0;
+      const shouldShowBackToTop = y >= firstRowHeightPx;
+      if (shouldShowBackToTop !== showBackToTopRef.current) {
+        showBackToTopRef.current = shouldShowBackToTop;
+        setShowBackToTop(shouldShowBackToTop);
+      }
+      ticking = false;
+    };
+
+    update();
+    const onScroll = () => {
+      if (ticking) {
+        return;
+      }
+      ticking = true;
+      rafId = window.requestAnimationFrame(update);
+    };
+    window.addEventListener("scroll", onScroll, { passive: true });
+
+    return () => {
+      if (rafId != null) {
+        window.cancelAnimationFrame(rafId);
+      }
+      window.removeEventListener("scroll", onScroll);
+    };
+  }, [syncScrollStyles]);
+
+  return (
+    <Box
+      ref={cssVarRootRef}
+      data-pc-docs-header-root="true"
+      sx={{
+        [CSS_VAR_TRANSLATE_X]: "0px",
+        [CSS_VAR_LOGO_SCALE]: "1",
+      }}
+    >
+      {bannerVisible && (
+        <Box
+          sx={{
+            position: "fixed",
+            top: 0,
+            left: 0,
+            right: 0,
+            zIndex: 10,
+          }}
+        >
+          <HeaderBanner {...props} />
+        </Box>
+      )}
+
+      <Box
+        sx={{
+          display: {
+            xs: "none",
+            md: "flex",
+          },
+          position: "fixed",
+          top: bannerVisible ? HEADER_HEIGHT.BANNER : 0,
+          left: 0,
+          right: 0,
+          height: HEADER_HEIGHT.SECOND_ROW,
+          zIndex: 11,
+          alignItems: "center",
+          paddingLeft: "24px",
+          paddingRight: "24px",
+          pointerEvents: "none",
+        }}
+      >
+        <Box
+          sx={{
+            display: "flex",
+            alignItems: "center",
+            pointerEvents: "none",
+          }}
+        >
+          {props.menu && (
+            <Box
+              sx={{
+                display: "flex",
+                alignItems: "center",
+                pointerEvents: "auto",
+              }}
+            >
+              {props.menu}
+            </Box>
+          )}
+          <Box
+            height="34px"
+            sx={{
+              display: "block",
+              pointerEvents: "auto",
+              transform: `scale(var(${CSS_VAR_LOGO_SCALE}))`,
+              transformOrigin: "left center",
+              willChange: "transform",
+            }}
+          >
+            <LinkComponent
+              to={generateDocsHomeUrl(language)}
+              onClick={() =>
+                gtmTrack(GTMEvent.ClickHeadNav, {
+                  item_name: "logo",
+                })
+              }
+            >
+              <TiDBLogo height="100%" width="100%" />
+            </LinkComponent>
+          </Box>
+        </Box>
+      </Box>
+
+      <Box
+        sx={{
+          paddingTop: bannerVisible ? HEADER_HEIGHT.BANNER : 0,
+          display: "flex",
+          flexDirection: "column",
+        }}
+      >
+        {/* First row: Logo and HeaderAction */}
+        <Box
+          sx={{
+            order: {
+              xs: 1,
+              md: 0,
+            },
+            display: { xs: "none", md: "flex" },
+            alignItems: "center",
+            width: "100%",
+            height: HEADER_HEIGHT.FIRST_ROW,
+            flexShrink: 0,
+            paddingLeft: { xs: "12px", md: "24px" },
+            paddingRight: { xs: "12px", md: "24px" },
+            backgroundColor: "carbon.50",
+            boxSizing: "border-box",
+          }}
+        >
+          <Box
+            ref={leftClusterRef}
+            data-pc-docs-header-left-cluster="true"
+            sx={{
+              display: {
+                xs: "none",
+                md: "flex",
+              },
+              alignItems: "center",
+              height: "100%",
+              visibility: "hidden",
+              pointerEvents: "none",
+            }}
+          >
+            {props.menu}
+            <Box
+              ref={logoMeasureRef}
+              data-pc-docs-header-logo-measure="true"
+              height="34px"
+              sx={{ display: "block" }}
+            >
+              <LinkComponent
+                to={generateDocsHomeUrl(language)}
+                onClick={() =>
+                  gtmTrack(GTMEvent.ClickHeadNav, {
+                    item_name: "logo",
+                  })
+                }
+              >
+                <TiDBLogo height="100%" width="100%" />
+              </LinkComponent>
+            </Box>
+          </Box>
+
+          <Box sx={{ marginLeft: "auto" }}>
+            <HeaderAction
+              supportedLocales={props.locales}
+              docInfo={props.docInfo}
+              buildType={props.buildType}
+              namespace={props.namespace}
+            />
+          </Box>
+        </Box>
+
+        {/* Second row: sticky */}
+        <Box
+          className="doc-site-header"
+          sx={{
+            order: {
+              xs: 0,
+              md: 1,
+            },
+            position: "sticky",
+            top: bannerVisible ? HEADER_HEIGHT.BANNER : 0,
+            zIndex: 9,
+            display: "flex",
+            alignItems: "center",
+            width: "100%",
+            height: HEADER_HEIGHT.SECOND_ROW,
+            paddingLeft: { xs: "12px", md: "24px" },
+            paddingRight: { xs: "12px", md: "24px" },
+            backgroundColor: "carbon.50",
+            borderBottom: `1px solid ${theme.palette.carbon[400]}`,
+            boxSizing: "border-box",
+          }}
+        >
+          {props.menu && (
+            <Box
+              sx={{
+                display: {
+                  xs: "flex",
+                  md: "none",
+                },
+                alignItems: "center",
+                mr: 1,
+              }}
+            >
+              {props.menu}
+            </Box>
+          )}
+          <Box
+            sx={{
+              display: "flex",
+              alignItems: "center",
+              height: "100%",
+              transform: {
+                xs: "none",
+                md: `translate3d(var(${CSS_VAR_TRANSLATE_X}), 0, 0)`,
+              },
+              willChange: {
+                xs: "auto",
+                md: "transform",
+              },
+            }}
+          >
+            <HeaderNavStack
+              buildType={props.buildType}
+              namespace={props.namespace}
+              onSelectedNavItemChange={props.onSelectedNavItemChange}
+            />
+            <HeaderNavStackMobile
+              buildType={props.buildType}
+              namespace={props.namespace}
+            />
+          </Box>
+
+          <Box
+            sx={{
+              marginLeft: "auto",
+              display: "flex",
+              alignItems: "center",
+              gap: 1,
+            }}
+          >
+            <Box sx={{ display: { xs: "flex", md: "none" } }}>
+              <HeaderAction
+                supportedLocales={props.locales}
+                docInfo={props.docInfo}
+                buildType={props.buildType}
+                namespace={props.namespace}
+              />
+            </Box>
+            {showBackToTop && (
+              <IconButton
+                aria-label="Back to top"
+                size="small"
+                onClick={handleBackToTop}
+                sx={{
+                  display: { xs: "none", md: "inline-flex" },
+                  color: theme.palette.carbon[700],
+                }}
+              >
+                <ArrowUpward fontSize="small" />
+              </IconButton>
+            )}
+            {props.locales.length > 0 && (
+              <LangSwitch supportedLocales={props.locales} />
+            )}
+          </Box>
+        </Box>
+
+        <Box sx={{ order: 2 }}>{props.children}</Box>
+      </Box>
+    </Box>
+  );
+}
+
+const HeaderBanner = (props: HeaderProps) => {
+  const { t } = useI18next();
+  const isAutoTranslation = useIsAutoTranslation(props.namespace);
+  const urlAutoTranslation =
+    props.pathConfig?.repo === "tidbcloud"
+      ? `/tidbcloud/${props.name === "_index" ? "" : props.name}`
+      : `/${props.pathConfig?.repo}/${props.pathConfig?.version || "stable"}/${
+          props.name === "_index" ? "" : props.name
+        }`;
+
+  let archivedTargetUrl = "";
+  if (props.name && props.pathConfig) {
+    const stableCfg = { ...props.pathConfig, version: "stable" };
+    const path = generateUrl(props.name, stableCfg);
+    archivedTargetUrl = `https://docs.pingcap.com${path}`;
+  } else {
+    const lang =
+      props.pathConfig?.locale === Locale.en
+        ? ""
+        : `/${props.pathConfig?.locale}`;
+    archivedTargetUrl = `https://docs.pingcap.com${lang}/tidb/stable/`;
+  }
+
+  if (props.buildType === "archive") {
+    return (
+      <Banner
+        bgColor="#FEFBF3"
+        textColor="#AE6D0C"
+        logo={
+          <ErrorOutlineOutlined sx={{ fontSize: "1rem", color: "#F2AA18" }} />
+        }
+        textList={[
+          t("banner.archive.title"),
+          <BlueAnchorLink to={archivedTargetUrl} target="_blank">
+            {t("banner.archive.viewLatestLTSVersion")} ↗
+          </BlueAnchorLink>,
+        ]}
+      />
+    );
+  }
+
+  if (isAutoTranslation) {
+    return (
+      <Banner
+        // bgColor="#FEFBF3"
+        // textColor="#AE6D0C"
+        // logo={
+        //   <ErrorOutlineOutlined sx={{ fontSize: "1rem", color: "#F2AA18" }} />
+        // }
+        logo={"📣"}
+        textList={[
+          <BlueAnchorLink
+            to="https://www.pingcap.com/blog/tidb-cloud-essential-now-available-public-preview-aws-alibaba-cloud/"
+            target="_blank"
+          >
+            {t("banner.autoTrans.title1")}
+          </BlueAnchorLink>,
+          t("banner.autoTrans.title2"),
+          <BlueAnchorLink to={urlAutoTranslation} target="_blank">
+            {t("banner.autoTrans.end")}
+          </BlueAnchorLink>,
+        ]}
+      />
+    );
+  }
+
+  return props.bannerEnabled ? (
+    <Banner
+      logo={"📣"}
+      textList={[
+        <BlueAnchorLink
+          to="https://www.pingcap.com/blog/tidb-cloud-essential-now-available-public-preview-aws-alibaba-cloud/"
+          target="_blank"
+        >
+          {t("banner.campaign.title1")}
+        </BlueAnchorLink>,
+        t("banner.campaign.title2"),
+        <BlueAnchorLink to={t("banner.campaign.link")} target="_blank">
+          {t("banner.campaign.end")}
+        </BlueAnchorLink>,
+      ]}
+    />
+  ) : null;
+};
diff --git a/src/components/Layout/HeaderAction.tsx b/src/components/Layout/HeaderAction.tsx
deleted file mode 100644
index d14c675e9..000000000
--- a/src/components/Layout/HeaderAction.tsx
+++ /dev/null
@@ -1,329 +0,0 @@
-import * as React from "react";
-import { Trans, useI18next } from "gatsby-plugin-react-i18next";
-
-import Box from "@mui/material/Box";
-import Typography from "@mui/material/Typography";
-import Stack from "@mui/material/Stack";
-import { useTheme } from "@mui/material/styles";
-import Button from "@mui/material/Button";
-import Menu from "@mui/material/Menu";
-import MenuItem from "@mui/material/MenuItem";
-import IconButton from "@mui/material/IconButton";
-import StarIcon from "media/icons/star.svg";
-
-import KeyboardArrowDownIcon from "@mui/icons-material/KeyboardArrowDown";
-import CloudIcon from "@mui/icons-material/Cloud";
-import TranslateIcon from "media/icons/globe-02.svg";
-
-import Search from "components/Search";
-
-import { Locale, BuildType } from "shared/interface";
-import { ActionButton } from "components/Card/FeedbackSection/components";
-import { Link } from "gatsby";
-import { useIsAutoTranslation } from "shared/useIsAutoTranslation";
-
-const useTiDBAIStatus = () => {
-  const [showTiDBAIButton, setShowTiDBAIButton] = React.useState(true);
-  const [initializingTiDBAI, setInitializingTiDBAI] = React.useState(true);
-
-  React.useEffect(() => {
-    if (!!window.tidbai) {
-      setInitializingTiDBAI(false);
-    }
-
-    const onTiDBAIInitialized = () => {
-      setInitializingTiDBAI(false);
-    };
-    const onTiDBAIError = () => {
-      setInitializingTiDBAI(false);
-      setShowTiDBAIButton(false);
-    };
-    window.addEventListener("tidbaiinitialized", onTiDBAIInitialized);
-    window.addEventListener("tidbaierror", onTiDBAIError);
-
-    const timer = setTimeout(() => {
-      if (!window.tidbai) {
-        setInitializingTiDBAI(false);
-        setShowTiDBAIButton(false);
-      }
-    }, 10000);
-    return () => {
-      clearTimeout(timer);
-      window.removeEventListener("tidbaiinitialized", onTiDBAIInitialized);
-      window.removeEventListener("tidbaierror", onTiDBAIError);
-    };
-  }, []);
-
-  return { showTiDBAIButton, initializingTiDBAI };
-};
-
-export default function HeaderAction(props: {
-  supportedLocales: Locale[];
-  docInfo?: { type: string; version: string };
-  buildType?: BuildType;
-  pageUrl?: string;
-}) {
-  const { supportedLocales, docInfo, buildType, pageUrl } = props;
-  const { language, t } = useI18next();
-  const { showTiDBAIButton, initializingTiDBAI } = useTiDBAIStatus();
-  const isAutoTranslation = useIsAutoTranslation(pageUrl || "");
-
-  return (
-    <Stack
-      direction="row"
-      spacing={{
-        xs: 1,
-        lg: 2,
-      }}
-      sx={{ marginLeft: "auto", alignItems: "center" }}
-    >
-      {supportedLocales.length > 0 && (
-        <LangSwitch supportedLocales={supportedLocales} />
-      )}
-      {docInfo && !isAutoTranslation && buildType !== "archive" && (
-        <>
-          <Stack direction="row" spacing={1}>
-            <Search placeholder={t("navbar.searchDocs")} docInfo={docInfo} />
-            {language === "en" && showTiDBAIButton && (
-              <ActionButton
-                id="header-ask-ai"
-                variant="outlined"
-                startIcon={<StarIcon />}
-                disabled={initializingTiDBAI}
-                sx={{
-                  display: {
-                    xs: "none",
-                    xl: "flex",
-                  },
-                }}
-                onClick={() => {
-                  window.tidbai.open = true;
-                }}
-              >
-                Ask AI
-              </ActionButton>
-            )}
-          </Stack>
-        </>
-      )}
-      {language === "en" && <TiDBCloudBtnGroup />}
-    </Stack>
-  );
-}
-
-const LANG_MAP = {
-  [Locale.en]: "EN",
-  [Locale.zh]: "中文",
-  [Locale.ja]: "日本語",
-};
-
-const LangSwitch = (props: {
-  language?: string;
-  changeLanguage?: () => void;
-  supportedLocales: Locale[];
-}) => {
-  const { supportedLocales } = props;
-
-  const [anchorEl, setAnchorEl] = React.useState<null | HTMLElement>(null);
-
-  const theme = useTheme();
-  const { language, changeLanguage } = useI18next();
-
-  const open = Boolean(anchorEl);
-  const handleClick = (event: React.MouseEvent<HTMLElement>) => {
-    setAnchorEl(event.currentTarget);
-  };
-  const handleClose = () => {
-    setAnchorEl(null);
-  };
-
-  const toggleLanguage = (locale: Locale) => () => {
-    changeLanguage(locale);
-    handleClose();
-  };
-
-  return (
-    <Box color={theme.palette.carbon[900]}>
-      <IconButton
-        onClick={handleClick}
-        sx={{
-          color: "inherit",
-          display: {
-            lg: "none",
-          },
-        }}
-      >
-        <TranslateIcon />
-      </IconButton>
-      <Button
-        id="header-lang-switch"
-        aria-controls={open ? "languages-menu" : undefined}
-        aria-haspopup="true"
-        aria-expanded={open ? "true" : undefined}
-        disableElevation
-        onClick={handleClick}
-        color="inherit"
-        startIcon={<TranslateIcon sx={{ fill: theme.palette.carbon[900] }} />}
-        endIcon={
-          <KeyboardArrowDownIcon
-            sx={{ fill: theme.palette.carbon[900], marginLeft: "-4px" }}
-          />
-        }
-        sx={{
-          display: {
-            xs: "none",
-            lg: "inline-flex",
-          },
-        }}
-      >
-        {LANG_MAP[language as Locale]}
-      </Button>
-      <Menu
-        id="header-lang-menu"
-        anchorEl={anchorEl}
-        open={open}
-        onClose={handleClose}
-        elevation={0}
-        anchorOrigin={{
-          vertical: "bottom",
-          horizontal: "left",
-        }}
-        transformOrigin={{
-          vertical: "top",
-          horizontal: "left",
-        }}
-        PaperProps={{
-          sx: {
-            border: "1px solid #F4F4F4",
-            filter: "drop-shadow(0px 1px 4px rgba(0, 0, 0, 0.08))",
-          },
-        }}
-      >
-        <MenuItem
-          onClick={toggleLanguage(Locale.en)}
-          disableRipple
-          selected={language === Locale.en}
-          disabled={!supportedLocales.includes(Locale.en)}
-        >
-          <Typography component="span" color={theme.palette.carbon[900]}>
-            <Trans i18nKey="lang.en" />
-          </Typography>
-        </MenuItem>
-        <MenuItem
-          onClick={toggleLanguage(Locale.zh)}
-          disableRipple
-          selected={language === Locale.zh}
-          disabled={!supportedLocales.includes(Locale.zh)}
-        >
-          <Typography component="span" color={theme.palette.carbon[900]}>
-            <Trans i18nKey="lang.zh" />
-          </Typography>
-        </MenuItem>
-        <MenuItem
-          onClick={toggleLanguage(Locale.ja)}
-          disableRipple
-          selected={language === Locale.ja}
-          disabled={!supportedLocales.includes(Locale.ja)}
-        >
-          <Typography component="span" color={theme.palette.carbon[900]}>
-            <Trans i18nKey="lang.ja" />
-          </Typography>
-        </MenuItem>
-      </Menu>
-    </Box>
-  );
-};
-
-const TiDBCloudBtnGroup = () => {
-  const [anchorEl, setAnchorEl] = React.useState<null | HTMLElement>(null);
-  const open = Boolean(anchorEl);
-  const handleClick = (event: React.MouseEvent<HTMLButtonElement>) => {
-    setAnchorEl(event.currentTarget);
-  };
-  const handleClose = () => {
-    setAnchorEl(null);
-  };
-
-  return (
-    <>
-      <Stack
-        direction="row"
-        spacing={1}
-        display={{
-          xs: "none",
-          xl: "flex",
-        }}
-      >
-        <Button
-          variant="text"
-          href={`https://tidbcloud.com/signin`}
-          // https://developer.chrome.com/blog/referrer-policy-new-chrome-default/
-          referrerPolicy="no-referrer-when-downgrade"
-          target="_blank"
-        >
-          Sign In
-        </Button>
-        <Button
-          variant="contained"
-          target="_blank"
-          href="https://tidbcloud.com/free-trial"
-          // https://developer.chrome.com/blog/referrer-policy-new-chrome-default/
-          referrerPolicy="no-referrer-when-downgrade"
-        >
-          Start for Free
-        </Button>
-      </Stack>
-
-      <IconButton
-        id="tidb-cloud-menu-button"
-        aria-controls={open ? "tidb-cloud-menu" : undefined}
-        aria-haspopup="true"
-        aria-expanded={open ? "true" : undefined}
-        onClick={handleClick}
-        sx={{
-          display: {
-            xs: "inline-flex",
-            xl: "none",
-          },
-        }}
-      >
-        <CloudIcon />
-      </IconButton>
-      <Menu
-        id="tidb-cloud-menu"
-        anchorEl={anchorEl}
-        open={open}
-        onClose={handleClose}
-        MenuListProps={{
-          "aria-labelledby": "idb-cloud-menu-button",
-        }}
-      >
-        <MenuItem
-          component={Link}
-          to={`https://tidbcloud.com/signin`}
-          target="_blank"
-          referrerPolicy="no-referrer-when-downgrade"
-          sx={{
-            textDecoration: "none",
-          }}
-        >
-          <Typography>Sign In</Typography>
-        </MenuItem>
-        <MenuItem
-          onClick={() => {
-            handleClose();
-          }}
-          component={Link}
-          to={`https://tidbcloud.com/free-trial`}
-          target="_blank"
-          referrerPolicy="no-referrer-when-downgrade"
-          sx={{
-            textDecoration: "none",
-          }}
-        >
-          <Typography>Try Free</Typography>
-        </MenuItem>
-      </Menu>
-    </>
-  );
-};
diff --git a/src/components/Layout/HeaderNav.tsx b/src/components/Layout/HeaderNav.tsx
deleted file mode 100644
index d39503015..000000000
--- a/src/components/Layout/HeaderNav.tsx
+++ /dev/null
@@ -1,361 +0,0 @@
-import * as React from "react";
-import { Trans, useI18next } from "gatsby-plugin-react-i18next";
-import Box from "@mui/material/Box";
-import Typography from "@mui/material/Typography";
-import Stack from "@mui/material/Stack";
-import Button from "@mui/material/Button";
-import { useTheme } from "@mui/material/styles";
-import Menu from "@mui/material/Menu";
-import MenuItem from "@mui/material/MenuItem";
-import KeyboardArrowDownIcon from "@mui/icons-material/KeyboardArrowDown";
-import DownloadIcon from "@mui/icons-material/Download";
-
-import LinkComponent from "components/Link";
-import {
-  generateDownloadURL,
-  generateContactURL,
-  generateLearningCenterURL,
-  generateDocsHomeUrl,
-  getPageType,
-  PageType,
-} from "shared/utils";
-import { BuildType } from "shared/interface";
-import { GTMEvent, gtmTrack } from "shared/utils/gtm";
-
-import TiDBLogo from "media/logo/tidb-logo-withtext.svg";
-import { CLOUD_MODE_KEY, useCloudPlan } from "shared/useCloudPlan";
-
-// `pageUrl` comes from server side render (or build): gatsby/path.ts/generateUrl
-// it will be `undefined` in client side render
-const useSelectedNavItem = (language?: string, pageUrl?: string) => {
-  // init in server side
-  const [selectedItem, setSelectedItem] = React.useState<PageType>(
-    () => getPageType(language, pageUrl) || "home"
-  );
-
-  // update in client side
-  React.useEffect(() => {
-    setSelectedItem(getPageType(language, window.location.pathname));
-  }, [language]);
-
-  return selectedItem;
-};
-
-export default function HeaderNavStack(props: {
-  buildType?: BuildType;
-  pageUrl?: string;
-}) {
-  const { language, t } = useI18next();
-  const selectedItem = useSelectedNavItem(language, props.pageUrl);
-  const { cloudPlan } = useCloudPlan();
-
-  return (
-    <Stack
-      direction="row"
-      spacing={3}
-      sx={{
-        paddingLeft: "20px",
-        height: "100%",
-        display: {
-          xs: "none",
-          md: "flex",
-        },
-      }}
-    >
-      {props.buildType !== "archive" && (
-        <NavItem
-          selected={selectedItem === "tidbcloud"}
-          label={t("navbar.cloud")}
-          to={
-            cloudPlan === "dedicated" || !cloudPlan
-              ? `/tidbcloud`
-              : `/tidbcloud/${cloudPlan}?${CLOUD_MODE_KEY}=${cloudPlan}`
-          }
-        />
-      )}
-
-      <NavItem
-        selected={selectedItem === "tidb"}
-        label={t("navbar.tidb")}
-        to={props.buildType === "archive" ? "/tidb/v2.1" : "/tidb/stable"}
-      />
-
-      {["zh"].includes(language) && (
-        <NavItem label={t("navbar.asktug")} to="https://asktug.com/" />
-      )}
-
-      {["en", "ja"].includes(language) && (
-        <NavItem
-          label={t("navbar.learningCenter")}
-          to={generateLearningCenterURL(language)}
-        />
-      )}
-
-      <NavItem
-        label={t("navbar.contactUs")}
-        to={generateContactURL(language)}
-      />
-
-      {language === "zh" && (
-        <NavItem
-          // label={<Trans i18nKey="navbar.download" />}
-          to={generateDownloadURL(language)}
-          alt="download"
-          startIcon={<DownloadIcon fontSize="inherit" color="inherit" />}
-        />
-      )}
-    </Stack>
-  );
-}
-
-const NavItem = (props: {
-  selected?: boolean;
-  label?: string | React.ReactElement;
-  to: string;
-  startIcon?: React.ReactNode;
-  alt?: string;
-  onClick?: () => void;
-}) => {
-  const theme = useTheme();
-  return (
-    <>
-      <Box
-        sx={{
-          display: "flex",
-          alignItems: "center",
-          paddingTop: "0.25rem",
-          paddingBottom: props.selected ? "0" : "0.25rem",
-          borderBottom: props.selected
-            ? `4px solid ${theme.palette.primary.main}`
-            : ``,
-        }}
-      >
-        <LinkComponent
-          isI18n
-          to={props.to}
-          onClick={() => {
-            gtmTrack(GTMEvent.ClickHeadNav, {
-              item_name: props.label || props.alt,
-            });
-
-            props.onClick?.();
-          }}
-        >
-          <Typography
-            variant="body1"
-            component="div"
-            color="website.f1"
-            padding="12px 0"
-            sx={{
-              display: "inline-flex",
-              alignItems: "center",
-              gap: 0.5,
-            }}
-          >
-            {props.startIcon}
-            {props.label}
-          </Typography>
-        </LinkComponent>
-      </Box>
-    </>
-  );
-};
-
-export function HeaderNavStackMobile(props: { buildType?: BuildType }) {
-  const [anchorEl, setAnchorEl] = React.useState<null | HTMLElement>(null);
-
-  const theme = useTheme();
-  const { language, t } = useI18next();
-  const selectedItem = useSelectedNavItem(language);
-  const { cloudPlan } = useCloudPlan();
-  const open = Boolean(anchorEl);
-  const handleClick = (event: React.MouseEvent<HTMLElement>) => {
-    setAnchorEl(event.currentTarget);
-  };
-  const handleClose = () => {
-    setAnchorEl(null);
-  };
-
-  return (
-    <Box
-      color={theme.palette.website.m5}
-      sx={{
-        display: {
-          md: "none",
-        },
-      }}
-    >
-      <Button
-        id="header-nav-items"
-        aria-controls={open ? "nav-menu" : undefined}
-        aria-haspopup="true"
-        aria-expanded={open ? "true" : undefined}
-        disableElevation
-        onClick={handleClick}
-        color="inherit"
-        startIcon={<TiDBLogo />}
-        endIcon={<KeyboardArrowDownIcon />}
-      ></Button>
-      <Menu
-        id="header-nav-menu"
-        anchorEl={anchorEl}
-        open={open}
-        onClose={handleClose}
-        elevation={0}
-        anchorOrigin={{
-          vertical: "bottom",
-          horizontal: "center",
-        }}
-        transformOrigin={{
-          vertical: "top",
-          horizontal: "center",
-        }}
-      >
-        {["en", "zh"].includes(language) && (
-          <MenuItem
-            onClick={handleClose}
-            disableRipple
-            selected={selectedItem === "home"}
-          >
-            <LinkComponent
-              isI18n
-              to="/"
-              style={{ width: "100%" }}
-              onClick={() =>
-                gtmTrack(GTMEvent.ClickHeadNav, {
-                  item_name: "home",
-                })
-              }
-            >
-              <Typography variant="body1" component="div" color="website.f1">
-                {props.buildType === "archive" ? (
-                  <Trans i18nKey="navbar.archive-home" />
-                ) : (
-                  <Trans i18nKey="navbar.home" />
-                )}
-              </Typography>
-            </LinkComponent>
-          </MenuItem>
-        )}
-
-        {props.buildType !== "archive" && (
-          <MenuItem
-            onClick={handleClose}
-            disableRipple
-            selected={selectedItem === "tidbcloud"}
-          >
-            <LinkComponent
-              isI18n
-              to={
-                cloudPlan === "dedicated" || !cloudPlan
-                  ? `/tidbcloud`
-                  : `/tidbcloud/${cloudPlan}?${CLOUD_MODE_KEY}=${cloudPlan}`
-              }
-              style={{ width: "100%" }}
-              onClick={() =>
-                gtmTrack(GTMEvent.ClickHeadNav, {
-                  item_name: t("navbar.cloud"),
-                })
-              }
-            >
-              <Typography variant="body1" component="div" color="website.f1">
-                <Trans i18nKey="navbar.cloud" />
-              </Typography>
-            </LinkComponent>
-          </MenuItem>
-        )}
-
-        <MenuItem
-          onClick={handleClose}
-          disableRipple
-          selected={selectedItem === "tidb"}
-        >
-          <LinkComponent
-            isI18n
-            to={props.buildType === "archive" ? "/tidb/v2.1" : "/tidb/stable"}
-            style={{ width: "100%" }}
-            onClick={() =>
-              gtmTrack(GTMEvent.ClickHeadNav, {
-                item_name: t("navbar.tidb"),
-              })
-            }
-          >
-            <Typography variant="body1" component="div" color="website.f1">
-              <Trans i18nKey="navbar.tidb" />
-            </Typography>
-          </LinkComponent>
-        </MenuItem>
-
-        {language === "zh" && (
-          <MenuItem onClick={handleClose} disableRipple>
-            <LinkComponent
-              to={generateDownloadURL(language)}
-              style={{ width: "100%" }}
-              onClick={() =>
-                gtmTrack(GTMEvent.ClickHeadNav, {
-                  item_name: t("navbar.download"),
-                })
-              }
-            >
-              <Typography variant="body1" component="div" color="website.f1">
-                <Trans i18nKey="navbar.download" />
-              </Typography>
-            </LinkComponent>
-          </MenuItem>
-        )}
-
-        {["ja", "en"].includes(language) && (
-          <MenuItem onClick={handleClose} disableRipple>
-            <LinkComponent
-              to={generateLearningCenterURL(language)}
-              style={{ width: "100%" }}
-              onClick={() =>
-                gtmTrack(GTMEvent.ClickHeadNav, {
-                  item_name: t("navbar.learningCenter"),
-                })
-              }
-            >
-              <Typography variant="body1" component="div" color="website.f1">
-                <Trans i18nKey="navbar.learningCenter" />
-              </Typography>
-            </LinkComponent>
-          </MenuItem>
-        )}
-
-        {["zh"].includes(language) && (
-          <MenuItem onClick={handleClose} disableRipple>
-            <LinkComponent
-              to="https://asktug.com/"
-              style={{ width: "100%" }}
-              onClick={() =>
-                gtmTrack(GTMEvent.ClickHeadNav, {
-                  item_name: t("navbar.asktug"),
-                })
-              }
-            >
-              <Typography variant="body1" component="div" color="website.f1">
-                <Trans i18nKey="navbar.asktug" />
-              </Typography>
-            </LinkComponent>
-          </MenuItem>
-        )}
-
-        <MenuItem onClick={handleClose} disableRipple>
-          <LinkComponent
-            to={generateContactURL(language)}
-            style={{ width: "100%" }}
-            onClick={() =>
-              gtmTrack(GTMEvent.ClickHeadNav, {
-                item_name: t("navbar.contactUs"),
-              })
-            }
-          >
-            <Typography variant="body1" component="div" color="website.f1">
-              <Trans i18nKey="navbar.contactUs" />
-            </Typography>
-          </LinkComponent>
-        </MenuItem>
-      </Menu>
-    </Box>
-  );
-}
diff --git a/src/components/Layout/LeftNav/LeftNav.tsx b/src/components/Layout/LeftNav/LeftNav.tsx
index 1bd372928..938a61aa6 100644
--- a/src/components/Layout/LeftNav/LeftNav.tsx
+++ b/src/components/Layout/LeftNav/LeftNav.tsx
@@ -1,22 +1,31 @@
 import * as React from "react";
-import { useI18next } from "gatsby-plugin-react-i18next";
 import Box from "@mui/material/Box";
 import Stack from "@mui/material/Stack";
 import Drawer from "@mui/material/Drawer";
 import Divider from "@mui/material/Divider";
+import Typography from "@mui/material/Typography";
+import { useTheme } from "@mui/material/styles";
 
 import IconButton from "@mui/material/IconButton";
 import MenuIcon from "@mui/icons-material/Menu";
 
-import { RepoNav, PathConfig, BuildType } from "shared/interface";
+import {
+  RepoNav,
+  PathConfig,
+  BuildType,
+  TOCNamespace,
+  CloudPlan,
+} from "shared/interface";
+import { NavItemConfig } from "../Header/HeaderNavConfigType";
 import LinkComponent from "components/Link";
-import LeftNavTree from "./LeftNavTree";
+import LeftNavTree, { clearAllNavStates } from "./LeftNavTree";
 import VersionSelect, {
   NativeVersionSelect,
 } from "../VersionSelect/VersionSelect";
+import { LeftNavStickyContainer } from "../VersionSelect/SharedSelect";
+import { getHeaderStickyHeight } from "shared/headerHeight";
 
 import TiDBLogoWithoutText from "media/logo/tidb-logo.svg";
-import CloudVersionSelect from "../VersionSelect/CloudVersionSelect";
 
 interface LeftNavProps {
   data: RepoNav;
@@ -26,7 +35,10 @@ interface LeftNavProps {
   availIn: string[];
   buildType?: BuildType;
   bannerEnabled?: boolean;
-  availablePlans: string[];
+  availablePlans: CloudPlan[];
+  selectedNavItem?: NavItemConfig | null;
+  language?: string;
+  namespace?: TOCNamespace;
 }
 
 export function LeftNavDesktop(props: LeftNavProps) {
@@ -37,8 +49,10 @@ export function LeftNavDesktop(props: LeftNavProps) {
     pathConfig,
     availIn,
     buildType,
-    availablePlans,
+    selectedNavItem,
+    namespace,
   } = props;
+  const theme = useTheme();
 
   return (
     <Box
@@ -55,31 +69,78 @@ export function LeftNavDesktop(props: LeftNavProps) {
       <Box
         sx={{
           position: "sticky",
-          top: props.bannerEnabled ? "7.5rem" : "5rem",
+          top: getHeaderStickyHeight(props.bannerEnabled || false),
           height: "100%",
-          maxHeight: `calc(100vh - ${props.bannerEnabled ? "7.5rem" : "5rem"})`,
+          maxHeight: `calc(100vh - ${getHeaderStickyHeight(
+            props.bannerEnabled || false
+          )})`,
           boxSizing: "border-box",
           overflowY: "auto",
-          padding: "20px 14px",
+          padding: "0 16px 20px",
         }}
       >
-        {pathConfig.repo !== "tidbcloud" && (
-          <VersionSelect
-            name={name}
-            pathConfig={pathConfig}
-            availIn={availIn}
-            buildType={buildType}
-          />
-        )}
-        {pathConfig.repo === "tidbcloud" && (
-          <CloudVersionSelect
-            name={name}
-            pathConfig={pathConfig}
-            availIn={availIn}
-            buildType={buildType}
-            availablePlans={availablePlans}
-          />
-        )}
+        <LeftNavStickyContainer top={0} paddingTop="20px">
+          {selectedNavItem && (
+            <Box
+              sx={{
+                borderRadius: "4px",
+                "&:hover": {
+                  backgroundColor: theme.palette.carbon[200],
+                },
+              }}
+            >
+              <LinkComponent
+                isI18n={selectedNavItem.isI18n ?? true}
+                to={selectedNavItem.to}
+                style={{ textDecoration: "none", display: "block" }}
+                onClick={() => {
+                  clearAllNavStates();
+                }}
+              >
+                <Typography
+                  variant="h6"
+                  component="div"
+                  sx={{
+                    fontSize: "18px",
+                    fontWeight: 700,
+                    color: theme.palette.carbon[900],
+                    padding: "8px",
+                    display: "inline-flex",
+                    alignItems: "center",
+                    gap: 1,
+                  }}
+                >
+                  {selectedNavItem.leftNavLabel ?? selectedNavItem.label}
+                  {selectedNavItem.endIcon && (
+                    <Box
+                      component="span"
+                      sx={{
+                        display: "inline-flex",
+                        alignItems: "center",
+                      }}
+                    >
+                      {selectedNavItem.endIcon}
+                    </Box>
+                  )}
+                </Typography>
+              </LinkComponent>
+            </Box>
+          )}
+
+          {(namespace === TOCNamespace.TiDB ||
+            namespace === TOCNamespace.TiDBInKubernetes) && (
+            <Box marginTop={1}>
+              <VersionSelect
+                name={name}
+                pathConfig={pathConfig}
+                availIn={availIn}
+                buildType={buildType}
+                disableStickyContainer
+              />
+            </Box>
+          )}
+        </LeftNavStickyContainer>
+
         <LeftNavTree data={data} current={current} />
       </Box>
     </Box>
@@ -87,12 +148,11 @@ export function LeftNavDesktop(props: LeftNavProps) {
 }
 
 export function LeftNavMobile(props: LeftNavProps) {
-  const { data, current, name, pathConfig, availIn, buildType } = props;
+  const { data, current, name, pathConfig, availIn, buildType, namespace } =
+    props;
 
   const [open, setOpen] = React.useState(false);
 
-  const { language } = useI18next();
-
   const toggleDrawer =
     (open: boolean) => (event: React.KeyboardEvent | React.MouseEvent) => {
       if (
@@ -119,7 +179,7 @@ export function LeftNavMobile(props: LeftNavProps) {
         <MenuIcon />
       </IconButton>
       <Drawer anchor="left" open={open} onClose={toggleDrawer(false)}>
-        <Box sx={{ width: "17.125rem", padding: "0.625rem" }}>
+        <Box sx={{ padding: "0.625rem" }}>
           <Stack
             direction="row"
             sx={{
@@ -137,7 +197,8 @@ export function LeftNavMobile(props: LeftNavProps) {
                 paddingLeft: "1.25rem",
               }}
             />
-            {pathConfig.repo !== "tidbcloud" && (
+            {(namespace === TOCNamespace.TiDB ||
+              namespace === TOCNamespace.TiDBInKubernetes) && (
               <NativeVersionSelect
                 name={name}
                 pathConfig={pathConfig}
diff --git a/src/components/Layout/LeftNav/LeftNavTree.tsx b/src/components/Layout/LeftNav/LeftNavTree.tsx
index 4f033ae86..5412d370e 100644
--- a/src/components/Layout/LeftNav/LeftNavTree.tsx
+++ b/src/components/Layout/LeftNav/LeftNavTree.tsx
@@ -2,76 +2,17 @@ import * as React from "react";
 import Box from "@mui/material/Box";
 import ChevronRightIcon from "@mui/icons-material/ChevronRight";
 import TreeView from "@mui/lab/TreeView";
-import TreeItem, { TreeItemProps, treeItemClasses } from "@mui/lab/TreeItem";
+import TreeItem from "@mui/lab/TreeItem";
 import Stack from "@mui/material/Stack";
 import Typography from "@mui/material/Typography";
-import { styled, useTheme } from "@mui/material/styles";
-import { SvgIconProps } from "@mui/material/SvgIcon";
+import Divider from "@mui/material/Divider";
+import { useTheme } from "@mui/material/styles";
 
 import { RepoNavLink, RepoNav } from "shared/interface";
 import LinkComponent from "components/Link";
 import { scrollToElementIfInView } from "shared/utils";
 import { alpha, Chip } from "@mui/material";
 
-type StyledTreeItemProps = TreeItemProps & {
-  bgColor?: string;
-  color?: string;
-  labelIcon?: React.ElementType<SvgIconProps>;
-  labelInfo?: string;
-  labelText?: string;
-};
-
-const StyledTreeItemRoot = styled(TreeItem)(({ theme }) => ({
-  [`& .${treeItemClasses.content}`]: {
-    color: theme.palette.website.f1,
-    "&:hover": {
-      backgroundColor: theme.palette.carbon[200],
-    },
-    "&.Mui-selected, &.Mui-selected.Mui-focused, &.Mui-selected:hover": {
-      backgroundColor: theme.palette.carbon[300],
-      color: theme.palette.secondary.main,
-      [`& svg.MuiTreeItem-ChevronRightIcon`]: {
-        fill: theme.palette.carbon[700],
-      },
-    },
-    "&.Mui-focused": {
-      backgroundColor: `#f9f9f9`,
-    },
-    [`& .${treeItemClasses.label}`]: {
-      fontWeight: "inherit",
-      color: "inherit",
-      paddingLeft: 0,
-    },
-    [`& .${treeItemClasses.iconContainer}`]: {
-      display: "none",
-    },
-  },
-  [`& .${treeItemClasses.group}`]: {
-    marginLeft: 0,
-  },
-}));
-
-function StyledTreeItem(props: StyledTreeItemProps) {
-  const {
-    bgColor,
-    color,
-    labelIcon: LabelIcon,
-    labelInfo,
-    labelText,
-    ...other
-  } = props;
-
-  return (
-    <StyledTreeItemRoot
-      style={{
-        marginTop: "4px",
-        marginBottom: "4px",
-      }}
-      {...other}
-    />
-  );
-}
-
 const calcExpandedIds = (
   data: RepoNavLink[],
   targetLink: string,
@@ -99,6 +40,10 @@ const calcExpandedIds = (
 
 // Session storage key prefix for nav item id
 const NAV_ITEM_ID_STORAGE_KEY = "nav_item_id_";
+// Session storage key prefix for scroll position
+const NAV_SCROLL_POSITION_STORAGE_KEY = "nav_scroll_position_";
+// Session storage key prefix for expanded tree nodes
+const NAV_EXPANDED_IDS_STORAGE_KEY = "nav_expanded_ids_";
 
 // Get nav item id from session storage for a given path
 const getNavItemIdFromStorage = (path: string): string | null => {
@@ -120,6 +65,113 @@ const saveNavItemIdToStorage = (path: string, id: string): void => {
   }
 };
 
+// Get scroll position from session storage for a given path
+const getScrollPositionFromStorage = (path: string): number | null => {
+  if (typeof window === "undefined") return null;
+  try {
+    const value = sessionStorage.getItem(
+      `${NAV_SCROLL_POSITION_STORAGE_KEY}${path}`
+    );
+    return value ? parseInt(value, 10) : null;
+  } catch {
+    return null;
+  }
+};
+
+// Save scroll position to session storage for a given path
+const saveScrollPositionToStorage = (path: string, scrollTop: number): void => {
+  if (typeof window === "undefined") return;
+  try {
+    sessionStorage.setItem(
+      `${NAV_SCROLL_POSITION_STORAGE_KEY}${path}`,
+      scrollTop.toString()
+    );
+  } catch {
+    // Ignore storage errors
+  }
+};
+
+// Get expanded IDs from session storage for a given path
+const getExpandedIdsFromStorage = (path: string): string[] | null => {
+  if (typeof window === "undefined") return null;
+  try {
+    const value = sessionStorage.getItem(
+      `${NAV_EXPANDED_IDS_STORAGE_KEY}${path}`
+    );
+    return value ? JSON.parse(value) : null;
+  } catch {
+    return null;
+  }
+};
+
+// Save expanded IDs to session storage for a given path
+const saveExpandedIdsToStorage = (
+  path: string,
+  expandedIds: string[]
+): void => {
+  if (typeof window === "undefined") return;
+  try {
+    sessionStorage.setItem(
+      `${NAV_EXPANDED_IDS_STORAGE_KEY}${path}`,
+      JSON.stringify(expandedIds)
+    );
+  } catch {
+    // Ignore storage errors
+  }
+};
+
+// Get the scrollable container element
+const getScrollableContainer = (): HTMLElement | null => {
+  if (typeof document === "undefined") return null;
+  const treeView = document.querySelector("#left-nav-treeview");
+  if (!treeView) return null;
+
+  // Find the nearest scrollable parent
+  let parent = treeView.parentElement;
+  while (parent) {
+    const style = window.getComputedStyle(parent);
+    if (style.overflowY === "auto" || style.overflowY === "scroll") {
+      return parent;
+    }
+    parent = parent.parentElement;
+  }
+  return null;
+};
+
+// Clear all navigation state from session storage for a given path
+export const clearNavState = (path: string): void => {
+  if (typeof window === "undefined") return;
+  try {
+    sessionStorage.removeItem(`${NAV_ITEM_ID_STORAGE_KEY}${path}`);
+    sessionStorage.removeItem(`${NAV_SCROLL_POSITION_STORAGE_KEY}${path}`);
+    sessionStorage.removeItem(`${NAV_EXPANDED_IDS_STORAGE_KEY}${path}`);
+  } catch {
+    // Ignore storage errors
+  }
+};
+
+// Clear all navigation states from session storage (for all paths)
+export const clearAllNavStates = (): void => {
+  if (typeof window === "undefined") return;
+  try {
+    const keysToRemove: string[] = [];
+    for (let i = 0; i < sessionStorage.length; i++) {
+      const key = sessionStorage.key(i);
+      if (
+        key &&
+        (key.startsWith(NAV_ITEM_ID_STORAGE_KEY) ||
+          key.startsWith(NAV_SCROLL_POSITION_STORAGE_KEY) ||
+          key.startsWith(NAV_EXPANDED_IDS_STORAGE_KEY))
+      ) {
+        keysToRemove.push(key);
+      }
+    }
+    keysToRemove.forEach((key) => sessionStorage.removeItem(key));
+  } catch {
+    // Ignore storage errors
+  }
+};
+
 export default function ControlledTreeView(props: {
   data: RepoNav;
   current: string;
@@ -138,16 +190,43 @@ export default function ControlledTreeView(props: {
   });
 
   const theme = useTheme();
+  const [disableTransition, setDisableTransition] = React.useState(false);
+  const previousUrlRef = React.useRef<string | null>(null);
 
   React.useEffect(() => {
     const storedId = getNavItemIdFromStorage(currentUrl);
-    const expandedIds = calcExpandedIds(
-      data,
-      currentUrl,
-      storedId || undefined
-    );
+    // Try to get saved expanded IDs first
+    const savedExpandedIds = getExpandedIdsFromStorage(currentUrl);
+
+    let expandedIds: string[];
+    let selectedId: string | undefined;
+    const isUrlChanged = previousUrlRef.current !== currentUrl;
+    previousUrlRef.current = currentUrl;
+
+    if (savedExpandedIds && savedExpandedIds.length > 0) {
+      // Use saved expanded IDs if available
+      expandedIds = savedExpandedIds;
+      // Use storedId for selected if available, otherwise use the last expanded ID
+      selectedId = storedId || undefined;
+
+      // Disable transition animation only when restoring saved state and URL changed
+      if (isUrlChanged) {
+        setDisableTransition(true);
+        // Re-enable transitions after a short delay
+        setTimeout(() => {
+          setDisableTransition(false);
+        }, 100);
+      }
+    } else {
+      // Fallback to calculating from current URL
+      expandedIds = calcExpandedIds(data, currentUrl, storedId || undefined);
+      selectedId = storedId || undefined;
+    }
+
     setExpanded(expandedIds);
-    expandedIds.length && setSelected([expandedIds[expandedIds.length - 1]]);
+    if (selectedId) {
+      setSelected([selectedId]);
+    }
   }, [data, currentUrl]);
 
   // ! Add "auto scroll" to left nav is not recommended.
@@ -156,26 +235,43 @@ export default function ControlledTreeView(props: {
       | (HTMLElement & { scrollIntoViewIfNeeded: () => void })
       | null = document?.querySelector(".MuiTreeView-root .Mui-selected");
     if (targetActiveItem) {
-      scrollToElementIfInView(targetActiveItem);
+      // Check if there's a saved scroll position for this URL
+      const savedScrollPosition = getScrollPositionFromStorage(currentUrl);
+      const scrollContainer = getScrollableContainer();
+
+      if (savedScrollPosition !== null && scrollContainer) {
+        // Restore scroll position
+        scrollContainer.scrollTop = savedScrollPosition;
+      } else {
+        // Fallback to original behavior
+        scrollToElementIfInView(targetActiveItem);
+      }
     }
-  }, [selected]);
+  }, [selected, currentUrl]);
 
   const renderNavs = (items: RepoNavLink[]) => {
     return items.map((item) => {
       if (item.type === "heading") {
         return (
-          <Typography
-            pl="8px"
-            mb="8px"
-            mt="16px"
-            fontWeight={700}
-            fontSize="12px"
-            lineHeight="1.15rem"
-            color="#666"
-            sx={{ textTransform: "uppercase" }}
+          <Box
+            key={item.id || `heading-${item.content[0]}`}
+            sx={{
+              display: "flex",
+              alignItems: "center",
+              my: "16px",
+            }}
           >
-            {item.content[0] as string}
-          </Typography>
+            <Typography
+              pl="8px"
+              fontWeight={300}
+              fontSize="14px"
+              color="carbon.700"
+              sx={{ textTransform: "uppercase", flexShrink: 0 }}
+            >
+              {item.content[0] as string}
+            </Typography>
+            <Divider sx={{ flexGrow: 1, ml: "10px" }} />
+          </Box>
         );
       } else {
         return renderTreeItems([item]);
@@ -231,10 +327,22 @@ export default function ControlledTreeView(props: {
             // Save nav item id to session storage when clicked
             if (item.link) {
               saveNavItemIdToStorage(item.link, item.id);
+
+              // Save scroll position to session storage
+              const scrollContainer = getScrollableContainer();
+              if (scrollContainer) {
+                saveScrollPositionToStorage(
+                  item.link,
+                  scrollContainer.scrollTop
+                );
+              }
+
+              // Save expanded IDs to session storage
+              saveExpandedIdsToStorage(item.link, expanded);
             }
           }}
         >
-          <StyledTreeItem
+          <TreeItem
             nodeId={item.id}
             label={<LabelEle />}
             ContentProps={{
@@ -244,7 +352,7 @@ export default function ControlledTreeView(props: {
             {hasChildren
               ? renderTreeItems(item.children as RepoNavLink[], deepth + 1)
               : null}
-          </StyledTreeItem>
+          </TreeItem>
         </LinkComponent>
       );
     });
@@ -252,6 +360,10 @@ export default function ControlledTreeView(props: {
 
   const handleToggle = (event: React.SyntheticEvent, nodeIds: string[]) => {
     setExpanded(nodeIds);
+    // Save expanded IDs to session storage when toggled
+    if (currentUrl) {
+      saveExpandedIdsToStorage(currentUrl, nodeIds);
+    }
   };
 
   return (
@@ -261,6 +373,16 @@ export default function ControlledTreeView(props: {
       expanded={expanded}
       selected={selected}
       onNodeToggle={handleToggle}
+      sx={{
+        ...(disableTransition && {
+          "& .MuiTreeItem-group": {
+            transition: "none !important",
+          },
+          "& .MuiCollapse-root": {
+            transition: "none !important",
+          },
+        }),
+      }}
     >
       {renderNavs(data)}
     </TreeView>
@@ -286,6 +408,7 @@ const generateItemLabel = ({ content: contents, tag }: RepoNavLink) => {
           const c = isContentString ? content : content.value;
           return (
             <Typography
+              key={`${c}_${index}`}
               component={typeof content === "string" ? "div" : "code"}
               sx={{
                 color: "inherit",
diff --git a/src/components/Layout/RightNav/RightNav.bk.tsx b/src/components/Layout/RightNav/RightNav.bk.tsx
deleted file mode 100644
index 91d8294a1..000000000
--- a/src/components/Layout/RightNav/RightNav.bk.tsx
+++ /dev/null
@@ -1,396 +0,0 @@
-import * as React from "react";
-import { Trans, useI18next } from "gatsby-plugin-react-i18next";
-import { graphql, useStaticQuery } from "gatsby";
-import { useLocation } from "@reach/router";
-import Box from "@mui/material/Box";
-import Typography from "@mui/material/Typography";
-import Stack from "@mui/material/Stack";
-import { useTheme } from "@mui/material/styles";
-import Button from "@mui/material/Button";
-import Menu from "@mui/material/Menu";
-import MenuItem from "@mui/material/MenuItem";
-import KeyboardArrowDownIcon from "@mui/icons-material/KeyboardArrowDown";
-import SimCardDownloadIcon from "@mui/icons-material/SimCardDownload";
-import QuestionAnswerIcon from "@mui/icons-material/QuestionAnswer";
-import EditIcon from "@mui/icons-material/Edit";
-import GitHubIcon from "@mui/icons-material/GitHub";
-import SvgIcon from "@mui/material/SvgIcon";
-
-import { TableOfContent, PathConfig, BuildType } from "shared/interface";
-import {
-  calcPDFUrl,
-  getRepoFromPathCfg,
-  transformCustomId,
-  removeHtmlTag,
-} from "shared/utils";
-import { sliceVersionMark } from "shared/utils/anchor";
-import { getPageType } from "shared/utils";
-
-interface RightNavProps {
-  toc?: TableOfContent[];
-  pathConfig: PathConfig;
-  filePath: string;
-  buildType?: BuildType;
-  pageUrl?: string;
-  bannerVisible?: boolean;
-}
-
-export default function RightNav(props: RightNavProps) {
-  const {
-    toc = [],
-    pathConfig,
-    filePath,
-    buildType,
-    pageUrl,
-    bannerVisible,
-  } = props;
-
-  const theme = useTheme();
-  const { language, t } = useI18next();
-
-  const pdfUrlMemo = React.useMemo(() => calcPDFUrl(pathConfig), [pathConfig]);
-  const pageType = React.useMemo(
-    () => getPageType(language, pageUrl),
-    [pageUrl]
-  );
-
-  // ! TOREMOVED
-  const { site } = useStaticQuery(graphql`
-    query {
-      site {
-        siteMetadata {
-          siteUrl
-        }
-      }
-    }
-  `);
-  let { pathname } = useLocation();
-  if (pathname.endsWith("/")) {
-    pathname = pathname.slice(0, -1); // unify client and ssr
-  }
-
-  // Track active heading for scroll highlighting
-  const [activeId, setActiveId] = React.useState<string>("");
-
-  React.useEffect(() => {
-    // Collect all heading IDs from the TOC
-    const headingIds: string[] = [];
-    const collectIds = (items: TableOfContent[]) => {
-      items.forEach((item) => {
-        if (item.url) {
-          const id = item.url.replace(/^#/, "");
-          if (id) {
-            headingIds.push(id);
-          }
-        }
-        if (item?.items) {
-          collectIds(item.items);
-        }
-      });
-    };
-    collectIds(toc);
-
-    if (headingIds.length === 0) return;
-
-    // Create an intersection observer
-    const observer = new IntersectionObserver(
-      (entries) => {
-        entries.forEach((entry) => {
-          if (entry.isIntersecting) {
-            setActiveId(entry.target.id);
-          }
-        });
-      },
-      {
-        rootMargin: "-80px 0px -80% 0px",
-        threshold: 0,
-      }
-    );
-
-    setTimeout(() => {
-      // Observe all heading elements
-      headingIds.forEach((id) => {
-        const element = document.getElementById(id);
-        if (element) {
-          observer.observe(element);
-        }
-      });
-    }, 1000);
-
-    // Cleanup
-    return () => {
-      headingIds.forEach((id) => {
-        const element = document.getElementById(id);
-        if (element) {
-          observer.unobserve(element);
-        }
-      });
-    };
-  }, [toc]);
-
-  return (
-    <>
-      <Box
-        sx={{
-          position: "sticky",
-          top: bannerVisible ? "7.5rem" : "5rem",
-          height: "100%",
-          maxHeight: bannerVisible
-            ? "calc(100vh - 7.5rem)"
-            : "calc(100vh - 5rem)",
-          overflowY: "auto",
-          padding: "36px 16px",
-          display: "flex",
-          flexDirection: "column",
-          gap: "36px",
-        }}
-      >
-        {language !== "ja" && (
-          <Stack spacing={1}>
-            {pageType !== "tidbcloud" && (
-              <ActionItem
-                icon={SimCardDownloadIcon}
-                url={`https://docs-download.pingcap.com/pdf/${pdfUrlMemo}`}
-                label={t("doc.download-pdf")}
-                rel="noreferrer"
-                download
-              />
-            )}
-            {buildType !== "archive" && (
-              <ActionItem
-                icon={GitHubIcon}
-                url={`https://github.com/${getRepoFromPathCfg(
-                  pathConfig
-                )}/issues/new?body=File:%20[/${
-                  pathConfig.branch
-                }/${filePath}](${site.siteMetadata.siteUrl}${pathname})`}
-                label={t("doc.feedback")}
-                rel="noreferrer"
-              />
-            )}
-            {buildType !== "archive" &&
-              ["zh", "en"].includes(pathConfig.locale) && (
-                <ActionItem
-                  icon={QuestionAnswerIcon}
-                  url={
-                    pathConfig.locale === "zh"
-                      ? `https://asktug.com/?utm_source=doc`
-                      : `https://discord.gg/DQZ2dy3cuc?utm_source=doc`
-                  }
-                  label={t("doc.feedbackAskTug")}
-                  rel="noreferrer"
-                />
-              )}
-            {buildType !== "archive" && pathConfig.version === "dev" && (
-              <ActionItem
-                icon={EditIcon}
-                url={`https://github.com/${getRepoFromPathCfg(
-                  pathConfig
-                )}/edit/${pathConfig.branch}/${filePath}`}
-                label={t("doc.improve")}
-                rel="noreferrer"
-              />
-            )}
-          </Stack>
-        )}
-
-        <Box id="toc-container" component="nav" aria-label="toc">
-          <Typography
-            component="div"
-            sx={{
-              paddingLeft: "0.5rem",
-              color: theme.palette.website.f1,
-              fontSize: "0.875rem",
-              fontWeight: "700",
-              lineHeight: "1.25rem",
-              paddingBottom: "0.5rem",
-            }}
-          >
-            <Trans i18nKey="doc.toc" />
-          </Typography>
-          {generateToc(toc, 0, activeId)}
-        </Box>
-      </Box>
-    </>
-  );
-}
-
-const generateToc = (items: TableOfContent[], level = 0, activeId = "") => {
-  const theme = useTheme();
-
-  return (
-    <Typography
-      component="ul"
-      sx={{
-        listStyle: "none",
-        padding: 0,
-      }}
-    >
-      {items.map((item) => {
-        const { url, title, items } = item;
-        const { label: newLabel, anchor: newAnchor } = transformCustomId(
-          title,
-          url
-        );
-        const itemId = url?.replace(/^#/, "") || "";
-        const isActive = itemId && itemId === activeId;
-
-        return (
-          <Typography key={`${level}-${item.title}`} component="li">
-            <Typography
-              component="a"
-              href={newAnchor?.replace(sliceVersionMark, "")}
-              sx={{
-                display: "flex",
-                textDecoration: "none",
-                fontSize: "14px",
-                lineHeight: "1.25rem",
-                borderLeft: `1px solid transparent`,
-                paddingLeft: `${0.5 + 1 * level}rem`,
-                paddingTop: "0.25rem",
-                paddingBottom: "0.25rem",
-                fontWeight: isActive ? "700" : "400",
-                color: isActive ? theme.palette.website.f1 : "inherit",
-                "&:hover": {
-                  color: theme.palette.website.f3,
-                  borderLeft: `1px solid ${theme.palette.website.f3}`,
-                },
-              }}
-            >
-              {removeHtmlTag(newLabel)}
-            </Typography>
-            {items && generateToc(items, level + 1, activeId)}
-          </Typography>
-        );
-      })}
-    </Typography>
-  );
-};
-
-const ActionItem = (props: {
-  url: string;
-  label: string;
-  icon?: typeof SvgIcon;
-  [key: string]: any;
-}) => {
-  const { url, label, sx, ...rest } = props;
-  const theme = useTheme();
-  return (
-    <Typography
-      component="a"
-      href={url}
-      target="_blank"
-      sx={{
-        width: "fit-content",
-        textDecoration: "none",
-        fontSize: "14px",
-        lineHeight: "1.25rem",
-        display: "flex",
-        alignItems: "center",
-        gap: "0.25rem",
-        "&:hover, &:focus, &:active": {
-          color: theme.palette.secondary.main,
-        },
-        ...sx,
-      }}
-      {...rest}
-    >
-      {props.icon && (
-        <props.icon
-          sx={{
-            width: "1.25rem",
-            height: "1.25rem",
-          }}
-        />
-      )}
-      {label}
-    </Typography>
-  );
-};
-
-export function RightNavMobile(props: RightNavProps) {
-  const { toc = [], pathConfig, filePath, buildType } = props;
-
-  const [anchorEl, setAnchorEl] = React.useState<null | HTMLElement>(null);
-  const open = Boolean(anchorEl);
-  const handleClick = (event: React.MouseEvent<HTMLButtonElement>) => {
-    setAnchorEl(event.currentTarget);
-  };
-  const handleClose = () => {
-    setAnchorEl(null);
-  };
-
-  const generateMobileTocList = (items: TableOfContent[], level = 0) => {
-    const result: { label: string; anchor: string; depth: number }[] = [];
-    items.forEach((item) => {
-      const { url, title, items: children } = item;
-      const { label: newLabel, anchor: newAnchor } = transformCustomId(
-        title,
-        url
-      );
-      result.push({
-        label: newLabel,
-        anchor: newAnchor,
-        depth: level,
-      });
-      if (children) {
-        const childrenresult = generateMobileTocList(children, level + 1);
-        result.push(...childrenresult);
-      }
-    });
-    return result;
-  };
-
-  return (
-    <Box>
-      <Button
-        id="toc-mobile-button"
-        variant="outlined"
-        aria-controls={open ? "toc-mobile-menu" : undefined}
-        aria-haspopup="true"
-        aria-expanded={open ? "true" : undefined}
-        onClick={handleClick}
-        endIcon={<KeyboardArrowDownIcon />}
-        sx={{
-          width: "100%",
-        }}
-      >
-        <Trans i18nKey="doc.toc" />
-      </Button>
-      <Menu
-        id="toc-mobile-menu"
-        anchorEl={anchorEl}
-        open={open}
-        onClose={handleClose}
-        MenuListProps={{
-          "aria-labelledby": "toc-mobile-button",
-        }}
-      >
-        {generateMobileTocList(toc).map((item) => {
-          return (
-            <MenuItem
-              key={`${item.depth}-${item.label}`}
-              onClick={handleClose}
-              dense
-              sx={{
-                width: "calc(100vw - 2rem)",
-              }}
-            >
-              <Typography
-                component="a"
-                href={item.anchor}
-                sx={{
-                  width: "100%",
-                  textDecoration: "none",
-                  paddingLeft: `${0.5 + 1 * item.depth}rem`,
-                }}
-              >
-                {item.label}
-              </Typography>
-            </MenuItem>
-          );
-        })}
-      </Menu>
-    </Box>
-  );
-}
diff --git a/src/components/Layout/RightNav/RightNav.tsx b/src/components/Layout/RightNav/RightNav.tsx
index f84810146..0af9f4a07 100644
--- a/src/components/Layout/RightNav/RightNav.tsx
+++ b/src/components/Layout/RightNav/RightNav.tsx
@@ -7,11 +7,11 @@ import { useTheme } from "@mui/material/styles";
 import Button from "@mui/material/Button";
 import Menu from "@mui/material/Menu";
 import MenuItem from "@mui/material/MenuItem";
-import KeyboardArrowDownIcon from "@mui/icons-material/KeyboardArrowDown";
-
 import { TableOfContent, PathConfig, BuildType } from "shared/interface";
+import ChevronDownIcon from "media/icons/chevron-down.svg";
 import { transformCustomId, removeHtmlTag } from "shared/utils";
 import { sliceVersionMark } from "shared/utils/anchor";
+import { getHeaderStickyHeight } from "shared/headerHeight";
 
 interface RightNavProps {
   toc?: TableOfContent[];
@@ -96,11 +96,11 @@ export default function RightNav(props: RightNavProps) {
       <Box
         sx={{
           position: "sticky",
-          top: bannerVisible ? "7.5rem" : "5rem",
+          top: getHeaderStickyHeight(bannerVisible || false),
           height: "100%",
-          maxHeight: bannerVisible
-            ? "calc(100vh - 7.5rem)"
-            : "calc(100vh - 5rem)",
+          maxHeight: `calc(100vh - ${getHeaderStickyHeight(
+            bannerVisible || false
+          )})`,
           overflowY: "auto",
           padding: "36px 16px",
           display: "flex",
@@ -116,7 +116,7 @@ export default function RightNav(props: RightNavProps) {
                 paddingLeft: "0.5rem",
                 color: theme.palette.carbon[700],
                 fontSize: "0.875rem",
-                fontWeight: "500",
+                fontWeight: "300",
                 lineHeight: "1.25rem",
                 paddingBottom: "0.5rem",
               }}
@@ -166,10 +166,8 @@ const generateToc = (items: TableOfContent[], level = 0, activeId = "") => {
                 paddingTop: "0.25rem",
                 paddingBottom: "0.25rem",
                 fontWeight: isActive ? "700" : "400",
-                color: isActive ? theme.palette.website.f1 : "inherit",
                 "&:hover": {
-                  color: theme.palette.website.f3,
-                  borderLeft: `1px solid ${theme.palette.website.f3}`,
+                  fontWeight: "700",
                 },
               }}
             >
@@ -225,7 +223,7 @@ export function RightNavMobile(props: RightNavProps) {
         aria-haspopup="true"
         aria-expanded={open ? "true" : undefined}
         onClick={handleClick}
-        endIcon={<KeyboardArrowDownIcon />}
+        endIcon={<ChevronDownIcon />}
         sx={{
           width: "100%",
         }}
diff --git a/src/components/Layout/TitleAction/TitleAction.tsx b/src/components/Layout/TitleAction/TitleAction.tsx
index 8001d49f9..95b403391 100644
--- a/src/components/Layout/TitleAction/TitleAction.tsx
+++ b/src/components/Layout/TitleAction/TitleAction.tsx
@@ -10,15 +10,14 @@ import { useTheme } from "@mui/material/styles";
 import Button from "@mui/material/Button";
 import Menu from "@mui/material/Menu";
 import MenuItem from "@mui/material/MenuItem";
-import KeyboardArrowDownIcon from "@mui/icons-material/KeyboardArrowDown";
-
 import EditIcon from "media/icons/edit.svg";
 import CopyIcon from "media/icons/copy.svg";
 import MarkdownIcon from "media/icons/markdown.svg";
 import FileIcon from "media/icons/file.svg";
+import ChevronDownIcon from "media/icons/chevron-down.svg";
 
-import { BuildType, PathConfig } from "shared/interface";
-import { calcPDFUrl, getPageType, getRepoFromPathCfg } from "shared/utils";
+import { BuildType, PathConfig, TOCNamespace } from "shared/interface";
+import { calcPDFUrl, getRepoFromPathCfg } from "shared/utils";
 import { Tooltip, Divider } from "@mui/material";
 
 interface TitleActionProps {
@@ -27,20 +26,18 @@ interface TitleActionProps {
   pageUrl: string;
   buildType: BuildType;
   language: string;
+  namespace?: TOCNamespace;
 }
 
 export const TitleAction = (props: TitleActionProps) => {
-  const { pathConfig, filePath, pageUrl, buildType, language } = props;
+  const { pathConfig, filePath, pageUrl, buildType, language, namespace } =
+    props;
   const { t } = useI18next();
   const theme = useTheme();
   const [contributeAnchorEl, setContributeAnchorEl] =
     React.useState<null | HTMLElement>(null);
   const [copied, setCopied] = React.useState(false);
   const isArchive = buildType === "archive";
-  const pageType = React.useMemo(
-    () => getPageType(language, pageUrl),
-    [pageUrl]
-  );
 
   const contributeOpen = Boolean(contributeAnchorEl);
 
@@ -145,7 +142,7 @@ export const TitleAction = (props: TitleActionProps) => {
             onClick={handleContributeClick}
             startIcon={<EditIcon sx={{ fill: theme.palette.carbon[700] }} />}
             endIcon={
-              <KeyboardArrowDownIcon
+              <ChevronDownIcon
                 sx={{ fill: theme.palette.carbon[700], marginLeft: "-4px" }}
               />
             }
@@ -249,7 +246,7 @@ export const TitleAction = (props: TitleActionProps) => {
       )}
 
       {/* Download PDF */}
-      {pageType === "tidb" && language !== "ja" && (
+      {namespace === TOCNamespace.TiDB && language !== "ja" && (
         <Button
           onClick={handleDownloadPDF}
           startIcon={<FileIcon sx={{ fill: theme.palette.carbon[700] }} />}
diff --git a/src/components/Layout/VersionSelect/CloudVersionSelect.tsx b/src/components/Layout/VersionSelect/CloudVersionSelect.tsx
index 58282adea..a5e991bf5 100644
--- a/src/components/Layout/VersionSelect/CloudVersionSelect.tsx
+++ b/src/components/Layout/VersionSelect/CloudVersionSelect.tsx
@@ -3,7 +3,7 @@ import * as React from "react";
 import MenuItem from "@mui/material/MenuItem";
 import CheckIcon from "@mui/icons-material/Check";
 
-import { PathConfig, BuildType } from "shared/interface";
+import { PathConfig, BuildType, CloudPlan } from "shared/interface";
 import { AllVersion } from "shared/utils";
 import LinkComponent from "components/Link";
 import { Box, Typography } from "@mui/material";
@@ -14,16 +14,16 @@ import { useEffect, useRef, useState } from "react";
 
 export const CLOUD_PLAN_LABEL_ELEMENT_ID = "cloud-plan-label";
 
-export const CLOUD_PLAN_LABEL_STRINGS = {
-  dedicated: "Dedicated",
-  starter: "Starter (formerly Serverless)",
-  essential: "Essential",
+export const CLOUD_PLAN_LABEL_STRINGS: Partial<Record<CloudPlan, string>> = {
+  [CloudPlan.Dedicated]: "Dedicated",
+  [CloudPlan.Starter]: "Starter (formerly Serverless)",
+  [CloudPlan.Essential]: "Essential",
 };
 
 const CLOUD_VERSIONS = [
   {
     label: "Dedicated",
-    value: "dedicated",
+    value: CloudPlan.Dedicated,
   },
   {
     label: (
@@ -31,11 +31,11 @@ const CLOUD_VERSIONS = [
         Starter<span style={{ color: "#9FA9AD" }}> (formerly Serverless)</span>
       </span>
     ),
-    value: "starter",
+    value: CloudPlan.Starter,
   },
   {
     label: "Essential",
-    value: "essential",
+    value: CloudPlan.Essential,
     icon: (
       <Chip
         label="Preview"
@@ -59,7 +59,7 @@ const VersionItems = (props: {
   pathConfig: PathConfig;
   name: string;
   onClick: () => void;
-  availablePlans: string[];
+  availablePlans: CloudPlan[];
 }) => {
   const { pathConfig } = props;
   const { cloudPlan, setCloudPlan } = useCloudPlan();
@@ -70,11 +70,11 @@ const VersionItems = (props: {
   const getToUrl = (version: string) => {
     const searchParams = new URLSearchParams();
     searchParams.set(CLOUD_MODE_KEY, version);
-    return version === "dedicated"
+    return version === CloudPlan.Dedicated
       ? `/${pathConfig.repo}/`
       : `/${pathConfig.repo}/${version}/?${searchParams.toString()}`;
   };
-  const onClick = (version: string) => {
+  const onClick = (version: CloudPlan) => {
     setCloudPlan(version);
     props.onClick();
   };
@@ -90,7 +90,7 @@ const VersionItems = (props: {
           component={LinkComponent}
           isI18n
           to={getToUrl(version.value)}
-          clearCloudMode={version.value === "dedicated"}
+          clearCloudMode={version.value === CloudPlan.Dedicated}
           onClick={() => onClick(version.value)}
         >
           <Box sx={{ display: "flex" }}>
@@ -124,11 +124,13 @@ interface VersionSelectProps {
   pathConfig: PathConfig;
   availIn: string[];
   buildType?: BuildType;
-  availablePlans: string[];
+  availablePlans: CloudPlan[];
+  disableStickyContainer?: boolean;
 }
 
 export default function CloudVersionSelect(props: VersionSelectProps) {
-  const { name, pathConfig, availIn, availablePlans } = props;
+  const { name, pathConfig, availIn, availablePlans, disableStickyContainer } =
+    props;
   const { cloudPlan } = useCloudPlan();
   const currentCloudVersion =
     CLOUD_VERSIONS.find((version) => version.value === cloudPlan) ||
@@ -144,7 +146,12 @@ export default function CloudVersionSelect(props: VersionSelectProps) {
 
   return (
     <>
-      <VersionSelectButton open={open} handleClick={handleClick} ref={anchorEl}>
+      <VersionSelectButton
+        open={open}
+        handleClick={handleClick}
+        ref={anchorEl}
+        disableStickyContainer={disableStickyContainer}
+      >
         <Box display="flex">
           <Typography
             component="div"
diff --git a/src/components/Layout/VersionSelect/SharedSelect.tsx b/src/components/Layout/VersionSelect/SharedSelect.tsx
index 525185810..ebb988161 100644
--- a/src/components/Layout/VersionSelect/SharedSelect.tsx
+++ b/src/components/Layout/VersionSelect/SharedSelect.tsx
@@ -5,69 +5,88 @@ import { styled, alpha } from "@mui/material/styles";
 import ChevronRightIcon from "@mui/icons-material/ChevronRight";
 import { forwardRef } from "react";
 
+export const LeftNavStickyContainer = (
+  props: React.PropsWithChildren<{
+    top?: number | string;
+    paddingTop?: number | string;
+  }>
+) => {
+  const { top = "-20px", paddingTop = "20px", children } = props;
+  return (
+    <Box
+      sx={{
+        position: "sticky",
+        top,
+        backgroundColor: "#fff",
+        marginLeft: "-16px",
+        marginRight: "-16px",
+        paddingTop,
+        paddingLeft: "16px",
+        paddingRight: "16px",
+        zIndex: 1000,
+      }}
+    >
+      {children}
+    </Box>
+  );
+};
+
 export const VersionSelectButton = forwardRef(
   (
     {
       open,
       handleClick,
       children,
+      disableStickyContainer,
     }: React.PropsWithChildren<{
       open: boolean;
       handleClick: () => void;
+      disableStickyContainer?: boolean;
     }>,
     ref
   ) => {
-    return (
-      <Box
+    const button = (
+      <Button
+        ref={ref as React.RefObject<HTMLButtonElement>}
         sx={{
-          position: "sticky",
-          top: "-20px",
-          backgroundColor: "#fff",
-          marginTop: "-20px",
-          marginLeft: "-16px",
-          marginRight: "-16px",
-          paddingTop: "20px",
-          paddingLeft: "16px",
-          paddingRight: "16px",
-          zIndex: 1000,
+          width: "100%",
+          height: "40px",
+          justifyContent: "space-between",
+          borderStyle: "solid",
+          borderWidth: "2px",
+          marginBottom: "1rem",
+          borderColor: open ? "#1E2426" : "#DCE3E5",
+          "&:hover": {
+            borderColor: "#9FA9AD",
+            backgroundColor: "#fff",
+          },
         }}
+        id="version-select-button"
+        aria-controls={open ? "verison-menu" : undefined}
+        aria-haspopup="true"
+        aria-expanded={open ? "true" : undefined}
+        onClick={handleClick}
+        endIcon={
+          <ChevronRightIcon
+            sx={(theme) => ({
+              transform: open ? "rotate(90deg)" : "rotate(0deg)",
+              height: "16px",
+              width: "16px",
+              fill: theme.palette.website.f3,
+              marginRight: "0.25rem",
+            })}
+          />
+        }
       >
-        <Button
-          ref={ref as React.RefObject<HTMLButtonElement>}
-          sx={{
-            width: "100%",
-            height: "40px",
-            justifyContent: "space-between",
-            borderStyle: "solid",
-            borderWidth: "2px",
-            marginBottom: "1rem",
-            borderColor: open ? "#1E2426" : "#DCE3E5",
-            "&:hover": {
-              borderColor: "#9FA9AD",
-              backgroundColor: "#fff",
-            },
-          }}
-          id="version-select-button"
-          aria-controls={open ? "verison-menu" : undefined}
-          aria-haspopup="true"
-          aria-expanded={open ? "true" : undefined}
-          onClick={handleClick}
-          endIcon={
-            <ChevronRightIcon
-              sx={(theme) => ({
-                transform: open ? "rotate(90deg)" : "rotate(0deg)",
-                height: "16px",
-                width: "16px",
-                fill: theme.palette.website.f3,
-                marginRight: "0.25rem",
-              })}
-            />
-          }
-        >
-          {children}
-        </Button>
-      </Box>
+        {children}
+      </Button>
     );
+
+    if (disableStickyContainer) {
+      return button;
+    }
+
+    return <LeftNavStickyContainer>{button}</LeftNavStickyContainer>;
   }
 );
 
diff --git a/src/components/Layout/VersionSelect/VersionSelect.tsx b/src/components/Layout/VersionSelect/VersionSelect.tsx
index 436464f41..103c41b56 100644
--- a/src/components/Layout/VersionSelect/VersionSelect.tsx
+++ b/src/components/Layout/VersionSelect/VersionSelect.tsx
@@ -71,10 +71,12 @@ const VersionItems = (props: {
   return (
     <>
       <MenuItem
+        disableRipple
         key={`menu-dev`}
         value={`menu-dev`}
         hidden={shouldHideDevMemo}
         disabled={!availIn.includes(`dev`)}
+        selected={pathConfig.version === "dev"}
         component={LinkComponent}
         isI18n
         to={`/${pathConfig.repo}/dev/${name}`}
@@ -90,7 +92,7 @@ const VersionItems = (props: {
         </Typography>
       </MenuItem>
 
-      <Divider sx={{ margin: "4px 0" }} />
+      <Divider />
 
       {pathConfig.repo === "tidb" && (
         <FormLabel
@@ -100,7 +102,6 @@ const VersionItems = (props: {
             lineHeight: "1.25rem",
             color: "#6F787B",
             pl: "12px",
-            mb: "8px",
           }}
         >
           Long-Term Support
@@ -108,9 +109,11 @@ const VersionItems = (props: {
       )}
       {LTSVersions.map((version) => (
         <MenuItem
+          disableRipple
           key={`menu-${version}`}
           value={`menu-${version}`}
           disabled={!availIn.includes(version || "")}
+          selected={pathConfig.version === version}
           component={LinkComponent}
           isI18n
           to={`/${pathConfig.repo}/${version}/${name}`}
@@ -127,7 +130,7 @@ const VersionItems = (props: {
         </MenuItem>
       ))}
 
-      <Divider sx={{ margin: "4px 0" }} />
+      <Divider />
 
       {pathConfig.repo === "tidb" && DMRVersions.length > 0 && (
         <>
@@ -145,9 +148,11 @@ const VersionItems = (props: {
           </FormLabel>
           {DMRVersions.map((version) => (
             <MenuItem
+              disableRipple
               key={`menu-${version}`}
               value={`menu-${version}`}
               disabled={!availIn.includes(version || "")}
+              selected={pathConfig.version === version}
               component={LinkComponent}
               isI18n
               to={`/${pathConfig.repo}/${version}/${name}`}
@@ -163,11 +168,12 @@ const VersionItems = (props: {
               </Typography>
             </MenuItem>
           ))}
-          <Divider sx={{ margin: "4px 0" }} />
+          <Divider />
         </>
       )}
 
       <MenuItem
+        disableRipple
         component={LinkComponent}
         isI18n
         to={generateArchivedWebsiteUrlByLangAndType(language, pathConfig.repo)}
@@ -213,9 +219,11 @@ const VersionItemsArchived = (props: {
       </FormLabel>
       {archiveList.map((version) => (
         <MenuItem
+          disableRipple
           key={`menu-${version}`}
           value={`menu-${version}`}
           disabled={!availIn.includes(version || "")}
+          selected={pathConfig.version === version}
           component={LinkComponent}
           isI18n
           to={`/${pathConfig.repo}/${version}/${name}`}
@@ -240,10 +248,11 @@ interface VersionSelectProps {
   pathConfig: PathConfig;
   availIn: string[];
   buildType?: BuildType;
+  disableStickyContainer?: boolean;
 }
 
 export default function VersionSelect(props: VersionSelectProps) {
-  const { name, pathConfig, availIn, buildType } = props;
+  const { name, pathConfig, availIn, buildType, disableStickyContainer } = props;
   const anchorEl = useRef<HTMLButtonElement>(null);
   const [open, setOpen] = React.useState<boolean>(false);
   const handleClick = () => setOpen(true);
@@ -251,7 +260,12 @@ export default function VersionSelect(props: VersionSelectProps) {
 
   return (
     <>
-      <VersionSelectButton open={open} handleClick={handleClick} ref={anchorEl}>
+      <VersionSelectButton
+        open={open}
+        handleClick={handleClick}
+        ref={anchorEl}
+        disableStickyContainer={disableStickyContainer}
+      >
         <Typography
           component="div"
           sx={{
@@ -332,7 +346,7 @@ export function NativeVersionSelect(props: VersionSelectProps) {
 
   return (
     <>
-      <FormControl sx={{ m: 1 }} variant="standard">
+      <FormControl variant="standard">
         <NativeSelect
           id="version-select-native"
           value={`${pathConfig.version}`}
diff --git a/src/components/Layout/index.tsx b/src/components/Layout/index.tsx
index a5e0d2c85..11b2fb717 100644
--- a/src/components/Layout/index.tsx
+++ b/src/components/Layout/index.tsx
@@ -8,7 +8,8 @@ import "@fontsource/ibm-plex-sans";
 import theme from "theme/index";
 import Header from "components/Layout/Header";
 import Footer from "components/Layout/Footer";
-import { Locale, BuildType, PathConfig } from "shared/interface";
+import { Locale, BuildType, PathConfig, TOCNamespace } from "shared/interface";
+import { NavItemConfig } from "components/Layout/Header/HeaderNavConfigType";
 
 export default function Layout(props: {
   children?: React.ReactNode;
@@ -17,9 +18,10 @@ export default function Layout(props: {
   locales?: Locale[];
   docInfo?: { type: string; version: string };
   buildType?: BuildType;
-  pageUrl?: string;
   name?: string;
   pathConfig?: PathConfig;
+  namespace: TOCNamespace;
+  onSelectedNavItemChange?: (item: NavItemConfig | null) => void;
 }) {
   return (
     <ThemeProvider theme={theme}>
@@ -30,12 +32,14 @@ export default function Layout(props: {
         locales={props.locales || []}
         docInfo={props.docInfo}
         buildType={props.buildType}
-        pageUrl={props.pageUrl}
         name={props.name}
         pathConfig={props.pathConfig}
-      />
-      {props.children}
-      <Footer />
+        namespace={props.namespace}
+        onSelectedNavItemChange={props.onSelectedNavItemChange}
+      >
+        {props.children}
+        <Footer />
+      </Header>
     </ThemeProvider>
   );
 }
diff --git a/src/components/MDXComponents/CustomContent.tsx b/src/components/MDXComponents/CustomContent.tsx
index aefe6c8cf..350022efc 100644
--- a/src/components/MDXComponents/CustomContent.tsx
+++ b/src/components/MDXComponents/CustomContent.tsx
@@ -1,18 +1,19 @@
 import { PropsWithChildren } from "react";
-import { PageType } from "shared/utils";
-import { CloudPlan } from "shared/interface";
+import { TOCNamespace, CloudPlan } from "shared/interface";
 
 interface CustomContentProps {
-  platform?: "tidb" | "tidb-cloud";
+  // using in markdown file
+  platform?: TOCNamespace;
   language?: string;
   plan?: CloudPlan;
-  pageTypeFromURL?: PageType;
+
+  currentNamespace?: TOCNamespace;
   languageFromURL?: string;
   cloudPlanFromURL?: CloudPlan | null;
 }
 
 export const useCustomContent = (
-  pageTypeFromURL: PageType,
+  currentNamespace: TOCNamespace,
   cloudPlanFromURL?: CloudPlan | null,
   languageFromURL?: string
 ) => {
@@ -20,7 +21,7 @@ export const useCustomContent = (
     return (
       <CustomContent
         {...props}
-        pageTypeFromURL={pageTypeFromURL}
+        currentNamespace={currentNamespace}
         languageFromURL={languageFromURL}
         cloudPlanFromURL={cloudPlanFromURL}
       />
@@ -32,16 +33,15 @@ export const CustomContent: React.FC<PropsWithChildren<CustomContentProps>> = (
   props
 ) => {
   const {
-    platform: _pageType,
-    pageTypeFromURL,
+    platform: namespace,
+    currentNamespace,
     children,
     languageFromURL,
     language,
     cloudPlanFromURL,
     plan,
   } = props;
-  const pageType = _pageType?.replace("-", "") || "";
-  const shouldDisplayByPageType = pageTypeFromURL === pageType;
+  const shouldDisplayByNamespace = currentNamespace === namespace;
 
   const cloudPlanArray = plan?.split(",").map((p) => p.trim()) || [];
   const shouldDisplayByCloudPlan = cloudPlanArray.includes(
@@ -53,11 +53,11 @@ export const CustomContent: React.FC<PropsWithChildren<CustomContentProps>> = (
     : [];
   const shouldDisplayByLanguage = languageArray.includes(languageFromURL || "");
 
-  const isPageTypeMatch = !pageType || shouldDisplayByPageType;
+  const isNamespaceMatch = !namespace || shouldDisplayByNamespace;
   const isLanguageMatch = !language || shouldDisplayByLanguage;
   const isCloudPlanMatch = !plan || shouldDisplayByCloudPlan;
 
-  const shouldDisplay = isPageTypeMatch && isLanguageMatch && isCloudPlanMatch;
+  const shouldDisplay = isNamespaceMatch && isLanguageMatch && isCloudPlanMatch;
 
   return <>{shouldDisplay ? children : <></>}</>;
 };
diff --git a/src/components/MDXComponents/DocHome.tsx b/src/components/MDXComponents/DocHome.tsx
index 96c233557..151cee403 100644
--- a/src/components/MDXComponents/DocHome.tsx
+++ b/src/components/MDXComponents/DocHome.tsx
@@ -203,11 +203,11 @@ export function DocHomeContainer(
                   component="div"
                   sx={{
                     paddingLeft: "0.5rem",
-                    paddingBottom: "1rem",
-                    color: theme.palette.website.f1,
+                    color: theme.palette.carbon[700],
                     fontSize: "0.875rem",
-                    fontWeight: "700",
+                    fontWeight: "300",
                     lineHeight: "1.25rem",
+                    paddingBottom: "0.5rem",
                   }}
                 >
                   <Trans i18nKey="doc.toc" />
@@ -243,15 +243,15 @@ export function DocHomeContainer(
                         sx={{
                           display: "flex",
                           textDecoration: "none",
-                          fontSize: "13px",
+                          fontSize: "14px",
                           lineHeight: "1.25rem",
                           borderLeft: `1px solid transparent`,
                           paddingLeft: `0.5rem`,
-                          paddingTop: `4px`,
-                          paddingBottom: `4px`,
+                          paddingTop: "0.25rem",
+                          paddingBottom: "0.25rem",
+                          fontWeight: "400",
                           "&:hover": {
-                            color: theme.palette.website.f3,
-                            borderLeft: `1px solid ${theme.palette.website.f3}`,
+                            fontWeight: "700",
                           },
                         }}
                       >
@@ -262,13 +262,6 @@ export function DocHomeContainer(
                 </Box>
               </>
             )}
-            {/* <ul>
-            {headingsMemo.map((i) => (
-              <li key={i.id}>
-                <a href={`#${i.anchor}`}>{i.label}</a>
-              </li>
-            ))}
-          </ul> */}
           </Grid2>
         )}
       </Grid2>
diff --git a/src/components/MDXComponents/EmailSubscriptionForm.tsx b/src/components/MDXComponents/EmailSubscriptionForm.tsx
index 697654e76..aeea524e9 100644
--- a/src/components/MDXComponents/EmailSubscriptionForm.tsx
+++ b/src/components/MDXComponents/EmailSubscriptionForm.tsx
@@ -104,6 +104,7 @@ function EmailSubscriptionForm() {
               <LoadingButton
                 type="submit"
                 variant="contained"
+                size="large"
                 loading={formData.loading}
                 aria-label="subscribe"
                 sx={{
diff --git a/src/components/MDXComponents/SimpleTab.tsx b/src/components/MDXComponents/SimpleTab.tsx
index e133f7a68..3cdae3685 100644
--- a/src/components/MDXComponents/SimpleTab.tsx
+++ b/src/components/MDXComponents/SimpleTab.tsx
@@ -1,6 +1,16 @@
 import { tabs, active, hidden } from "./simple-tab.module.css";
 
-import { ReactElement, useState, useMemo, useEffect, useRef } from "react";
+import {
+  Children,
+  Fragment,
+  isValidElement,
+  ReactElement,
+  ReactNode,
+  useState,
+  useMemo,
+  useEffect,
+  useRef,
+} from "react";
 import { useDispatch, useSelector } from "react-redux";
 import { setTabGroup } from "state";
 import clsx from "clsx";
@@ -10,36 +20,73 @@ export function SimpleTab({
   children,
 }: {
   groupId: string;
-  children: ReactElement<{
-    label: string;
-    value?: string;
-    children: ReactElement[];
-  }>[];
+  children: ReactNode;
 }) {
   const [renderedTabs, setRenderedTabs] = useState<string[]>([]);
-  const actualTabs = useMemo(() => {
-    const tabs: ReactElement[] = [];
+  const tabEntries = useMemo(() => {
+    type TabElement = ReactElement<{ label: string; value?: string }>;
+    type TabEntry = {
+      // The actual tab <div label=... value=...> element used for labels/ids
+      tab: TabElement;
+      // The original top-level node we should render as content (could be a wrapper like <CustomContent>)
+      renderNode: ReactNode;
+    };
+
+    const isTabElement = (node: unknown): node is TabElement => {
+      if (!isValidElement(node as ReactElement)) {
+        return false;
+      }
+      const props = (node as any).props;
+      return typeof props?.label === "string" && props.label.length > 0;
+    };
 
-    const extractTabs = (elements: ReactElement[]) => {
-      elements.forEach((element) => {
-        if (element.props.mdxType === "CustomContent") {
-          if (element.props.children) {
-            const childrenArray = Array.isArray(element.props.children)
-              ? element.props.children
-              : [element.props.children];
-            extractTabs(childrenArray);
+    const unwrapToTab = (node: ReactNode): TabElement | null => {
+      // Find the first tab element inside this node (supports wrapper like <CustomContent>).
+      return Children.toArray(node).reduce<TabElement | null>(
+        (found, child) => {
+          if (found) {
+            return found;
+          }
+          if (!isValidElement(child)) {
+            return null;
           }
-        } else {
-          tabs.push(element);
+          if ((child.props as any)?.mdxType === "CustomContent") {
+            return unwrapToTab(child.props?.children);
+          }
+          if (isTabElement(child)) {
+            return child;
+          }
+          // If it's some other element (e.g. Fragment), keep walking down its children.
+          return unwrapToTab(child.props?.children);
+        },
+        null
+      );
+    };
+
+    const flattenTopLevelNodes = (nodes: ReactNode): ReactNode[] => {
+      // MDX can sometimes pass a single Fragment that wraps multiple tab panes.
+      // We want each tab pane to be a top-level entry, so we manually unwrap Fragments here.
+      return Children.toArray(nodes).reduce<ReactNode[]>((acc, node) => {
+        if (isValidElement(node) && node.type === Fragment) {
+          return acc.concat(Children.toArray(node.props?.children));
         }
-      });
+        return acc.concat(node);
+      }, []);
     };
 
-    extractTabs(children);
+    // Preserve original top-level nodes for rendering (keeps wrappers like <CustomContent> intact).
+    const tabEntries = flattenTopLevelNodes(children)
+      .map<TabEntry | null>((node) => {
+        const tab = unwrapToTab(node);
+        return tab ? { tab, renderNode: node } : null;
+      })
+      .filter((entry): entry is TabEntry => entry !== null);
 
-    return tabs;
+    return tabEntries;
   }, [children]);
 
+  const actualTabs = useMemo(() => tabEntries.map((e) => e.tab), [tabEntries]);
+
   const defaultValue =
     actualTabs[0]?.props?.value || actualTabs[0]?.props.label;
   const [activeTab, setActiveTab] = useState(defaultValue);
@@ -52,7 +99,7 @@ export function SimpleTab({
       activeTabGroup &&
       activeTabGroup !== activeTab &&
       actualTabs.some(
-        (child) => child.props?.value || child.props.label === activeTabGroup
+        (child) => (child.props?.value || child.props.label) === activeTabGroup
       )
     ) {
       setActiveTab(activeTabGroup);
@@ -96,9 +143,8 @@ export function SimpleTab({
           );
         })}
       </ul>
-      {children.map((child, index) => {
-        const actualChild = actualTabs[index];
-        const id: string = actualChild.props?.value || actualChild.props.label;
+      {tabEntries.map(({ tab, renderNode }) => {
+        const id: string = tab.props?.value || tab.props.label;
         return (
           <TabContentDetector
             key={id}
@@ -124,7 +170,7 @@ export function SimpleTab({
               });
             }}
           >
-            {child}
+            {renderNode}
           </TabContentDetector>
         );
       })}
@@ -139,7 +185,7 @@ export const TabContentDetector = ({
   renderedTabs,
   onRendered,
 }: {
-  children: ReactElement;
+  children: ReactNode;
   id: string;
   activeTab: string;
   renderedTabs: string[];
diff --git a/src/components/MDXComponents/developer/DevToolCard.tsx b/src/components/MDXComponents/developer/DevToolCard.tsx
index dfbc05eab..96907b926 100644
--- a/src/components/MDXComponents/developer/DevToolCard.tsx
+++ b/src/components/MDXComponents/developer/DevToolCard.tsx
@@ -51,7 +51,7 @@ export function DevToolCard({
         "> a.MuiCardActionArea-root:hover, a.MuiButton-text:hover": {
           textDecoration: "none",
         },
-        ".MuiCardActions-root > a.MuiButton-text": {
+        ".MuiCardActions-root > a.MuiButton-text:not(.button)": {
           color: "text.secondary",
           borderRadius: 0,
         },
diff --git a/src/components/MDXContent.tsx b/src/components/MDXContent.tsx
index 87ccfc3ea..ebef8ed93 100644
--- a/src/components/MDXContent.tsx
+++ b/src/components/MDXContent.tsx
@@ -8,11 +8,15 @@ import Box from "@mui/material/Box";
 
 import * as MDXComponents from "components/MDXComponents";
 import { CustomNotice } from "components/Card/CustomNotice";
-import { PathConfig, BuildType, CloudPlan } from "shared/interface";
+import {
+  PathConfig,
+  BuildType,
+  CloudPlan,
+  TOCNamespace,
+} from "shared/interface";
 import replaceInternalHref from "shared/utils/anchor";
 import { Pre } from "components/MDXComponents/Pre";
 import { useCustomContent } from "components/MDXComponents/CustomContent";
-import { getPageType } from "shared/utils";
 import { H1 } from "./MDXComponents/H1";
 
 export default function MDXContent(props: {
@@ -26,6 +30,7 @@ export default function MDXContent(props: {
   buildType: BuildType;
   pageUrl: string;
   cloudPlan: CloudPlan | null;
+  namespace?: TOCNamespace;
 }) {
   const {
     data,
@@ -38,10 +43,14 @@ export default function MDXContent(props: {
     buildType,
     pageUrl,
     cloudPlan,
+    namespace,
   } = props;
 
-  const pageType = getPageType(language, pageUrl);
-  const CustomContent = useCustomContent(pageType, cloudPlan, language);
+  const CustomContent = useCustomContent(
+    namespace || TOCNamespace.TiDB,
+    cloudPlan,
+    language
+  );
   // const isAutoTranslation = useIsAutoTranslation(pageUrl || "");
 
   React.useEffect(() => {
@@ -67,7 +76,7 @@ export default function MDXContent(props: {
         {...props}
       />
     ),
-    [pathConfig, filePath, pageUrl]
+    [pathConfig, filePath, pageUrl, namespace]
   );
 
   return (
diff --git a/src/components/Search/index.tsx b/src/components/Search/index.tsx
index b5afefe8e..608c7e668 100644
--- a/src/components/Search/index.tsx
+++ b/src/components/Search/index.tsx
@@ -31,7 +31,7 @@ const StyledTextField = styled((props: TextFieldProps) => (
   },
 }));
 
-const SEARCH_WIDTH = 250;
+const SEARCH_WIDTH = 400;
 
 enum SearchType {
   Onsite = "onsite",
diff --git a/src/media/icons/chevron-down.svg b/src/media/icons/chevron-down.svg
new file mode 100644
index 000000000..b912fc636
--- /dev/null
+++ b/src/media/icons/chevron-down.svg
@@ -0,0 +1,3 @@
+<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M4 6L8 10L12 6" stroke="#383E40" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
diff --git a/src/media/icons/cloud-03.svg b/src/media/icons/cloud-03.svg
new file mode 100644
index 000000000..c9d24ae71
--- /dev/null
+++ b/src/media/icons/cloud-03.svg
@@ -0,0 +1,3 @@
+<svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M7.9165 15.8335C4.46472 15.8335 1.6665 13.0353 1.6665 9.5835C1.6665 6.13172 4.46472 3.3335 7.9165 3.3335C10.3187 3.3335 12.4044 4.68878 13.4507 6.67644C13.5496 6.67007 13.6493 6.66683 13.7498 6.66683C16.2811 6.66683 18.3332 8.71886 18.3332 11.2502C18.3332 13.7815 16.2811 15.8335 13.7498 15.8335C11.6236 15.8335 10.1018 15.8335 7.9165 15.8335Z" stroke="#383E40" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
diff --git a/src/media/icons/layers-three-01.svg b/src/media/icons/layers-three-01.svg
new file mode 100644
index 000000000..97af7b2c1
--- /dev/null
+++ b/src/media/icons/layers-three-01.svg
@@ -0,0 +1,10 @@
+<svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_460_3703)">
+<path d="M1.6665 9.99997L9.70169 14.0176C9.81101 14.0722 9.86567 14.0996 9.923 14.1103C9.97378 14.1198 10.0259 14.1198 10.0767 14.1103C10.134 14.0996 10.1887 14.0722 10.298 14.0176L18.3332 9.99997M1.6665 14.1666L9.70169 18.1842C9.81101 18.2389 9.86567 18.2662 9.923 18.277C9.97378 18.2865 10.0259 18.2865 10.0767 18.277C10.134 18.2662 10.1887 18.2389 10.298 18.1842L18.3332 14.1666M1.6665 5.83331L9.70169 1.81571C9.81101 1.76105 9.86567 1.73372 9.923 1.72297C9.97378 1.71344 10.0259 1.71344 10.0767 1.72297C10.134 1.73372 10.1887 1.76105 10.298 1.81571L18.3332 5.83331L10.298 9.8509C10.1887 9.90556 10.134 9.93289 10.0767 9.94365C10.0259 9.95317 9.97378 9.95317 9.923 9.94365C9.86567 9.93289 9.81101 9.90556 9.70169 9.8509L1.6665 5.83331Z" stroke="#383E40" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</g>
+<defs>
+<clipPath id="clip0_460_3703">
+<rect width="20" height="20" fill="white"/>
+</clipPath>
+</defs>
+</svg>
diff --git a/src/media/logo/tidb-logo-withtext.svg b/src/media/logo/tidb-logo-withtext.svg
index 28bd4072a..1225ad09a 100644
--- a/src/media/logo/tidb-logo-withtext.svg
+++ b/src/media/logo/tidb-logo-withtext.svg
@@ -1,17 +1,17 @@
-<svg width="152" height="36" viewBox="0 0 152 36" fill="none" xmlns="http://www.w3.org/2000/svg">
-<g clip-path="url(#clip0_789_1365)">
-<path d="M0 26.9605V9.04959C0 9.01208 0.0187549 8.98395 0.0468872 8.96519L15.5478 0.00973267C15.5759 -0.00902222 15.6134 -0.00902222 15.6416 0.00973267L31.1425 8.95581C31.1706 8.97457 31.1894 9.0027 31.1894 9.04021V26.9511C31.1894 26.9886 31.1706 27.0168 31.1425 27.0355L15.6416 35.991C15.6134 36.0097 15.5759 36.0097 15.5478 35.991L0.0468872 27.0355C0.0187549 27.0168 0 26.9886 0 26.9605Z" fill="#DC150B"/>
-<path d="M10.3808 15.0336C10.3714 15.0242 10.3527 15.0149 10.3433 15.0242L5.25136 17.9688H5.2326C5.21384 17.9688 5.20447 17.9594 5.20447 17.9406V12.0047C5.20447 11.9953 5.21384 11.986 5.22322 11.9766L5.22322 11.9766L15.5572 6.01253C15.5665 6.00315 15.5759 6.00315 15.5853 6.01253L20.7241 8.9758L20.7335 8.98518C20.7429 8.99455 20.7335 9.01331 20.7241 9.02268L15.5759 11.9953C15.5665 12.0047 15.5572 12.0141 15.5572 12.0235V29.9625V29.9813C15.5478 29.9906 15.529 30 15.5197 29.9906L10.3902 27.0368C10.3902 27.0274 10.3808 27.018 10.3808 27.0086V15.0524V15.0336Z" fill="white"/>
-<path d="M20.7992 26.9992C20.7804 26.9992 20.7616 26.9805 20.7616 26.9617V15.0336C20.7616 15.0149 20.771 15.0055 20.7804 14.9961L25.9286 12.0235L25.9286 12.0235C25.938 12.0141 25.938 12.0141 25.9474 12.0141C25.9661 12.0141 25.9849 12.0328 25.9849 12.0516V23.9797C25.9849 23.9985 25.9755 24.0078 25.9661 24.0172L20.8179 26.9899C20.8085 26.9992 20.8085 26.9992 20.7992 26.9992Z" fill="white"/>
+<svg width="165" height="36" viewBox="0 0 165 36" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_22_2744)">
+<path d="M0 26.9604V9.04953C0 9.01202 0.0187549 8.98388 0.0468872 8.96513L15.5478 0.00967163C15.5759 -0.00908325 15.6134 -0.00908325 15.6416 0.00967163L31.1425 8.95575C31.1706 8.97451 31.1894 9.00264 31.1894 9.04015V26.9511C31.1894 26.9886 31.1706 27.0167 31.1425 27.0355L15.6416 35.9909C15.6134 36.0097 15.5759 36.0097 15.5478 35.9909L0.0468872 27.0355C0.0187549 27.0167 0 26.9886 0 26.9604Z" fill="#DC150B"/>
+<path d="M10.3809 15.0335C10.3716 15.0241 10.3528 15.0147 10.3434 15.0241L5.25148 17.9686H5.23272C5.21397 17.9686 5.20459 17.9593 5.20459 17.9405V12.0046C5.20459 11.9952 5.21397 11.9858 5.22334 11.9765L5.22334 11.9765L15.5573 6.0124C15.5667 6.00303 15.576 6.00303 15.5854 6.0124L20.7243 8.97568L20.7336 8.98505C20.743 8.99443 20.7336 9.01319 20.7243 9.02256L15.576 11.9952C15.5667 12.0046 15.5573 12.014 15.5573 12.0233V29.9624V29.9811C15.5479 29.9905 15.5292 29.9999 15.5198 29.9905L10.3903 27.0366C10.3903 27.0273 10.3809 27.0179 10.3809 27.0085V15.0523V15.0335Z" fill="white"/>
+<path d="M20.7993 26.9991C20.7805 26.9991 20.7618 26.9804 20.7618 26.9616V15.0335C20.7618 15.0147 20.7711 15.0054 20.7805 14.996L25.9287 12.0233L25.9287 12.0233C25.9381 12.014 25.9381 12.014 25.9475 12.014C25.9662 12.014 25.985 12.0327 25.985 12.0515V23.9796C25.985 23.9983 25.9756 24.0077 25.9662 24.0171L20.818 26.9897C20.8087 26.9991 20.8087 26.9991 20.7993 26.9991Z" fill="white"/>
 </g>
-<path d="M37.1894 12.4971H42.0242V26.9998H45.4248V12.4971H50.2596V9.37683H37.1894V12.4971Z" fill="black"/>
-<path d="M53.6372 9C53.1197 9 52.6672 9.18709 52.2887 9.55826C51.9102 9.92943 51.7151 10.3941 51.7151 10.9373C51.7151 11.4503 51.9073 11.8999 52.2858 12.2802C52.6643 12.6574 53.1167 12.8505 53.6342 12.8505C54.1517 12.8505 54.5775 12.6574 54.9501 12.2802C55.3227 11.903 55.509 11.4503 55.509 10.9373C55.509 10.3941 55.3257 9.93245 54.9619 9.56128C54.5982 9.19011 54.1517 9.00302 53.6372 9.00302V9Z" fill="black"/>
-<path d="M55.2895 14.3592H51.9864V27H55.2895V14.3592Z" fill="black"/>
-<path d="M64.3322 9.37683H58.2613V26.9998H64.3322C66.9492 26.9998 69.028 26.2031 70.5124 24.6309C71.9939 23.0587 72.748 20.8921 72.748 18.1883C72.748 15.4845 71.9969 13.2967 70.5124 11.7336C69.028 10.1705 66.9492 9.37683 64.3322 9.37683ZM61.6619 12.4971H64.2109C65.9024 12.4971 67.1798 12.998 68.0137 13.9847C68.8506 14.9775 69.2734 16.3566 69.2734 18.0857C69.2734 19.8148 68.8476 21.2512 68.0108 22.3013C67.1769 23.3454 65.8994 23.8765 64.208 23.8765H61.659V12.494L61.6619 12.4971Z" fill="black"/>
-<path d="M86.5964 19.1388C86.0346 18.4418 85.3663 17.9409 84.6152 17.6512V17.621C86.1883 16.8424 86.9838 15.566 86.9838 13.8278C86.9838 12.479 86.5461 11.3866 85.6856 10.5839C84.8251 9.78421 83.5566 9.37683 81.9154 9.37683H74.7948V26.9998H81.8681C83.6068 26.9998 84.9907 26.5652 85.9784 25.7082C86.972 24.8482 87.4747 23.6261 87.4747 22.075C87.4747 20.8468 87.179 19.8601 86.5994 19.1388H86.5964ZM78.1185 16.5256V12.1953H81.4718C82.1105 12.1953 82.628 12.3884 83.0095 12.7686C83.388 13.1489 83.5802 13.68 83.5802 14.3499C83.5802 15.0198 83.3909 15.5569 83.0184 15.9432C82.6458 16.3294 82.1105 16.5256 81.4216 16.5256H78.1156H78.1185ZM83.9972 21.8245C83.9972 22.5276 83.7872 23.101 83.3762 23.5295C82.9651 23.958 82.356 24.1753 81.5724 24.1753H78.1215V19.3471H81.5724C82.3235 19.3471 82.9237 19.5794 83.3525 20.0411C83.7813 20.5028 84.0001 21.1033 84.0001 21.8215L83.9972 21.8245Z" fill="black"/>
-<path d="M97.3306 26.5V9.7H102.299C107.771 9.7 111.083 12.868 111.083 18.1C111.083 23.332 107.771 26.5 102.299 26.5H97.3306ZM102.299 24.364C106.331 24.364 108.659 22.06 108.659 18.1C108.659 14.14 106.331 11.836 102.299 11.836H99.7066V24.364H102.299ZM118.968 26.764C115.464 26.764 112.824 24.052 112.824 20.5C112.824 16.948 115.464 14.236 118.968 14.236C122.472 14.236 125.112 16.948 125.112 20.5C125.112 24.052 122.472 26.764 118.968 26.764ZM118.968 24.628C121.152 24.628 122.736 22.876 122.736 20.5C122.736 18.124 121.152 16.372 118.968 16.372C116.784 16.372 115.2 18.124 115.2 20.5C115.2 22.876 116.784 24.628 118.968 24.628ZM132.772 26.764C129.22 26.764 126.7 24.124 126.7 20.5C126.7 16.876 129.22 14.236 132.772 14.236C135.652 14.236 137.884 15.964 138.244 18.532H135.844C135.532 17.236 134.332 16.372 132.772 16.372C130.588 16.372 129.076 18.076 129.076 20.5C129.076 22.9 130.588 24.628 132.772 24.628C134.332 24.628 135.532 23.764 135.844 22.468H138.244C137.884 25.036 135.652 26.764 132.772 26.764ZM144.557 26.764C141.677 26.764 139.781 25.108 139.709 22.732H142.085C142.229 23.956 142.973 24.724 144.581 24.724C145.733 24.724 146.765 24.34 146.765 23.332C146.765 22.588 146.333 22.06 145.157 21.7L143.333 21.172C141.173 20.548 140.093 19.3 140.093 17.716C140.093 15.604 141.965 14.236 144.413 14.236C146.885 14.236 148.685 15.7 148.829 17.74H146.453C146.285 16.828 145.445 16.204 144.341 16.204C143.261 16.204 142.469 16.804 142.469 17.716C142.469 18.412 142.925 18.868 144.245 19.228L146.069 19.732C148.109 20.308 149.141 21.556 149.141 23.188C149.141 25.396 147.197 26.764 144.557 26.764Z" fill="black"/>
+<path d="M37.1895 12.4971H42.0243V26.9998H45.4249V12.4971H50.2597V9.37683H37.1895V12.4971Z" fill="black"/>
+<path d="M53.6372 9C53.1197 9 52.6673 9.18709 52.2888 9.55826C51.9103 9.92943 51.7151 10.3941 51.7151 10.9373C51.7151 11.4503 51.9073 11.8999 52.2858 12.2802C52.6644 12.6574 53.1168 12.8505 53.6343 12.8505C54.1518 12.8505 54.5776 12.6574 54.9502 12.2802C55.3228 11.903 55.509 11.4503 55.509 10.9373C55.509 10.3941 55.3257 9.93245 54.962 9.56128C54.5983 9.19011 54.1518 9.00302 53.6372 9.00302V9Z" fill="black"/>
+<path d="M55.2895 14.3592H51.9865V27H55.2895V14.3592Z" fill="black"/>
+<path d="M64.3322 9.37683H58.2614V26.9998H64.3322C66.9492 26.9998 69.028 26.2031 70.5125 24.6309C71.994 23.0587 72.748 20.8921 72.748 18.1883C72.748 15.4845 71.9969 13.2967 70.5125 11.7336C69.028 10.1705 66.9492 9.37683 64.3322 9.37683ZM61.662 12.4971H64.211C65.9024 12.4971 67.1799 12.998 68.0138 13.9847C68.8506 14.9775 69.2735 16.3566 69.2735 18.0857C69.2735 19.8148 68.8477 21.2512 68.0108 22.3013C67.1769 23.3454 65.8995 23.8765 64.208 23.8765H61.659V12.494L61.662 12.4971Z" fill="black"/>
+<path d="M86.5965 19.1388C86.0346 18.4418 85.3663 17.9409 84.6152 17.6512V17.621C86.1884 16.8424 86.9838 15.566 86.9838 13.8278C86.9838 12.479 86.5462 11.3866 85.6857 10.5839C84.8252 9.78421 83.5566 9.37683 81.9154 9.37683H74.7948V26.9998H81.8681C83.6069 26.9998 84.9908 26.5652 85.9784 25.7082C86.972 24.8482 87.4747 23.6261 87.4747 22.075C87.4747 20.8468 87.179 19.8601 86.5994 19.1388H86.5965ZM78.1186 16.5256V12.1953H81.4719C82.1106 12.1953 82.6281 12.3884 83.0096 12.7686C83.3881 13.1489 83.5803 13.68 83.5803 14.3499C83.5803 15.0198 83.391 15.5569 83.0184 15.9432C82.6458 16.3294 82.1106 16.5256 81.4216 16.5256H78.1156H78.1186ZM83.9972 21.8245C83.9972 22.5276 83.7873 23.101 83.3762 23.5295C82.9652 23.958 82.356 24.1753 81.5724 24.1753H78.1215V19.3471H81.5724C82.3235 19.3471 82.9238 19.5794 83.3526 20.0411C83.7813 20.5028 84.0002 21.1033 84.0002 21.8215L83.9972 21.8245Z" fill="black"/>
+<path d="M97.3305 26.5V9.7H102.298C107.77 9.7 111.082 12.868 111.082 18.1C111.082 23.332 107.77 26.5 102.298 26.5H97.3305ZM102.298 24.364C106.33 24.364 108.658 22.06 108.658 18.1C108.658 14.14 106.33 11.836 102.298 11.836H99.7065V24.364H102.298ZM122.079 26.764C117.111 26.764 113.511 23.14 113.511 18.1C113.511 13.06 117.111 9.436 122.079 9.436C127.047 9.436 130.647 13.06 130.647 18.1C130.647 23.14 127.047 26.764 122.079 26.764ZM122.079 24.58C125.679 24.58 128.223 21.916 128.223 18.1C128.223 14.284 125.679 11.62 122.079 11.62C118.455 11.62 115.935 14.284 115.935 18.1C115.935 21.916 118.455 24.58 122.079 24.58ZM141.195 26.764C136.347 26.764 133.059 23.14 133.059 18.124C133.059 13.18 136.443 9.436 141.195 9.436C144.867 9.436 147.867 11.62 148.515 14.932H146.091C145.323 12.748 143.523 11.62 141.195 11.62C137.691 11.62 135.483 14.164 135.483 18.1C135.483 21.772 137.523 24.58 141.195 24.58C143.499 24.58 145.371 23.524 146.115 21.268H148.539C147.915 24.628 144.915 26.764 141.195 26.764ZM156.396 26.764C153.036 26.764 150.612 24.796 150.42 21.7H152.94C153.228 23.572 154.5 24.58 156.396 24.58C158.196 24.58 159.708 23.692 159.708 22.084C159.708 20.836 158.844 19.876 156.972 19.276L154.836 18.58C152.268 17.74 150.996 16.06 150.996 13.996C150.996 11.236 153.3 9.436 156.276 9.436C159.252 9.436 161.7 11.452 161.82 14.02H159.3C159.132 12.628 157.908 11.62 156.276 11.62C154.692 11.62 153.42 12.58 153.42 13.996C153.42 15.124 154.188 15.892 156.036 16.492L157.86 17.068C160.74 17.98 162.132 19.876 162.132 22.084C162.132 25.036 159.564 26.764 156.396 26.764Z" fill="#DC150B"/>
 <defs>
-<clipPath id="clip0_789_1365">
+<clipPath id="clip0_22_2744">
 <rect width="31.1894" height="36" fill="white"/>
 </clipPath>
 </defs>
diff --git a/src/shared/filterRightToc.ts b/src/shared/filterRightToc.ts
index 0b1e57549..f40c1a2e1 100644
--- a/src/shared/filterRightToc.ts
+++ b/src/shared/filterRightToc.ts
@@ -1,13 +1,12 @@
-import { TableOfContent, CloudPlan } from "./interface";
-import { PageType } from "./utils";
+import { TableOfContent, CloudPlan, TOCNamespace } from "./interface";
 
 /**
  * Filter right TOC based on CustomContent conditions
- * Removes TOC items that don't match current context (pageType, cloudPlan, language)
+ * Removes TOC items that don't match current context (namespace, cloudPlan, language)
  */
 export function filterRightToc(
   items: TableOfContent[],
-  pageType: PageType,
+  namespace: TOCNamespace,
   cloudPlan: CloudPlan | null,
   language: string
 ): TableOfContent[] {
@@ -19,10 +18,10 @@ export function filterRightToc(
       if (item.condition) {
         const { platform, plan, language: conditionLang } = item.condition;
 
-        // Check platform match
+        // Check platform match (namespace)
         if (platform) {
-          const normalizedPlatform = platform.replace("-", "");
-          if (normalizedPlatform !== pageType) {
+          // platform value should match TOCNamespace enum value
+          if (platform !== namespace) {
             return null; // Filter out this item
           }
         }
@@ -48,7 +47,7 @@ export function filterRightToc(
       if (item.items && item.items.length > 0) {
         const filteredItems = filterRightToc(
           item.items,
-          pageType,
+          namespace,
           cloudPlan,
           language
         );
diff --git a/src/shared/headerHeight.ts b/src/shared/headerHeight.ts
new file mode 100644
index 000000000..96b7168c6
--- /dev/null
+++ b/src/shared/headerHeight.ts
@@ -0,0 +1,42 @@
+/**
+ * Header height constants
+ * These values should be kept in sync with the actual header height in Header.tsx
+ */
+const BANNER_HEIGHT_PX = 40;
+const FIRST_ROW_HEIGHT_PX = 56;
+const SECOND_ROW_HEIGHT_PX = 56;
+const WITHOUT_BANNER_HEIGHT_PX = FIRST_ROW_HEIGHT_PX + SECOND_ROW_HEIGHT_PX;
+const WITH_BANNER_HEIGHT_PX = WITHOUT_BANNER_HEIGHT_PX + BANNER_HEIGHT_PX;
+const STICKY_WITHOUT_BANNER_HEIGHT_PX = SECOND_ROW_HEIGHT_PX;
+const STICKY_WITH_BANNER_HEIGHT_PX =
+  STICKY_WITHOUT_BANNER_HEIGHT_PX + BANNER_HEIGHT_PX;
+
+const px = (value: number) => `${value}px`;
+
+export const HEADER_HEIGHT = {
+  BANNER: px(BANNER_HEIGHT_PX),
+  FIRST_ROW: px(FIRST_ROW_HEIGHT_PX),
+  SECOND_ROW: px(SECOND_ROW_HEIGHT_PX),
+  WITHOUT_BANNER: px(WITHOUT_BANNER_HEIGHT_PX),
+  WITH_BANNER: px(WITH_BANNER_HEIGHT_PX),
+  STICKY_WITHOUT_BANNER: px(STICKY_WITHOUT_BANNER_HEIGHT_PX),
+  STICKY_WITH_BANNER: px(STICKY_WITH_BANNER_HEIGHT_PX),
+} as const;
+
+/**
+ * Get header height based on banner visibility
+ */
+export const getHeaderHeight = (bannerEnabled: boolean): string => {
+  return bannerEnabled
+    ? HEADER_HEIGHT.WITH_BANNER
+    : HEADER_HEIGHT.WITHOUT_BANNER;
+};
+
+/**
+ * Get sticky top offset (banner + second row) based on banner visibility.
+ */
+export const getHeaderStickyHeight = (bannerEnabled: boolean): string => {
+  return bannerEnabled
+    ? HEADER_HEIGHT.STICKY_WITH_BANNER
+    : HEADER_HEIGHT.STICKY_WITHOUT_BANNER;
+};
diff --git a/src/shared/interface.ts b/src/shared/interface.ts
index 97cd2b16d..7870a7f31 100644
--- a/src/shared/interface.ts
+++ b/src/shared/interface.ts
@@ -9,6 +9,40 @@ export interface TableOfContent {
   };
 }
 
+export enum TOCNamespace {
+  Home = "home",
+  NotFound = "not-found",
+  Search = "search",
+  CloudAPIApp = "cloud-api-app",
+  TiDB = "tidb",
+  TiDBCloud = "tidb-cloud",
+  TiDBInKubernetes = "tidb-in-kubernetes",
+  AI = "ai",
+  Develop = "develop",
+  BestPractices = "best-practices",
+  API = "api",
+  TiDBReleases = "tidb-releases",
+  TidbCloudReleases = "tidb-cloud-releases",
+  TiDBInKubernetesReleases = "tidb-in-kubernetes-releases",
+}
+
+export const TOCNamespaceSlugMap: Record<TOCNamespace, string> = {
+  [TOCNamespace.Home]: "",
+  [TOCNamespace.NotFound]: "",
+  [TOCNamespace.Search]: "",
+  [TOCNamespace.CloudAPIApp]: "",
+  [TOCNamespace.TiDB]: "",
+  [TOCNamespace.TiDBCloud]: "",
+  [TOCNamespace.TiDBInKubernetes]: "",
+  [TOCNamespace.AI]: "ai",
+  [TOCNamespace.Develop]: "develop",
+  [TOCNamespace.BestPractices]: "best-practices",
+  [TOCNamespace.API]: "api",
+  [TOCNamespace.TiDBReleases]: "tidb-releases",
+  [TOCNamespace.TidbCloudReleases]: "tidb-cloud-releases",
+  [TOCNamespace.TiDBInKubernetesReleases]: "tidb-operator-releases",
+};
+
 export enum Repo {
   tidb = "tidb",
   dm = "tidb-data-migration",
@@ -68,4 +102,9 @@ export type RepoNav = RepoNavLink[];
 
 export type BuildType = "prod" | "archive";
 
-export type CloudPlan = "dedicated" | "starter" | "essential" | "premium";
+export enum CloudPlan {
+  Dedicated = "dedicated",
+  Starter = "starter",
+  Essential = "essential",
+  Premium = "premium",
+}
diff --git a/src/shared/useCloudPlan.ts b/src/shared/useCloudPlan.ts
index 34b0cdc48..2185f5888 100644
--- a/src/shared/useCloudPlan.ts
+++ b/src/shared/useCloudPlan.ts
@@ -1,18 +1,45 @@
 import { navigate } from "gatsby";
+import { useLocation } from "@reach/router";
 import {
   createContext,
   Dispatch,
   SetStateAction,
+  useCallback,
   useContext,
   useEffect,
-  useState,
 } from "react";
-import { CloudPlan, Repo } from "./interface";
+import { CloudPlan, Repo, TOCNamespace } from "./interface";
 
 export const CLOUD_MODE_KEY = "plan";
-export const CLOUD_MODE_VALUE_STARTER = "starter";
-export const CLOUD_MODE_VALUE_ESSENTIAL = "essential";
-export const CLOUD_MODE_VALUE_PREMIUM = "premium";
+
+const TOC_NAME_TO_CLOUD_PLAN: Record<string, CloudPlan> = {
+  TOC: CloudPlan.Dedicated,
+  "TOC-tidb-cloud-starter": CloudPlan.Starter,
+  "TOC-tidb-cloud-essential": CloudPlan.Essential,
+  "TOC-tidb-cloud-premium": CloudPlan.Premium,
+};
+
+function isCloudPlan(value: string | null): value is CloudPlan {
+  return (
+    value === CloudPlan.Dedicated ||
+    value === CloudPlan.Starter ||
+    value === CloudPlan.Essential ||
+    value === CloudPlan.Premium
+  );
+}
+
+function getCloudPlansFromTocNames(tocNames: string[] | null | undefined) {
+  if (!tocNames || tocNames.length === 0) return [];
+  const plans: CloudPlan[] = [];
+  const seen = new Set<CloudPlan>();
+  tocNames.forEach((tocName) => {
+    const plan = TOC_NAME_TO_CLOUD_PLAN[tocName];
+    if (!plan || seen.has(plan)) return;
+    plans.push(plan);
+    seen.add(plan);
+  });
+  return plans;
+}
 
 const CloudPlanContext = createContext<{
   repo: Repo;
@@ -31,38 +58,52 @@ export const useCloudPlan = () => {
     setCloudPlan: _setCloudPlan,
     repo,
   } = useContext(CloudPlanContext);
+  const { search } = useLocation();
   const isTidbcloud = repo === Repo.tidbcloud;
-  const [isStarter, setIsStarter] = useState<boolean>(false);
-  const [isEssential, setIsEssential] = useState<boolean>(false);
-  const [isPremium, setIsPremium] = useState<boolean>(false);
-  const [isClassic, setIsClassic] = useState<boolean>(true);
-
-  const setCloudPlan = (cloudPlan: CloudPlan) => {
-    _setCloudPlan(cloudPlan);
-    sessionStorage.setItem(CLOUD_MODE_KEY, cloudPlan);
-  };
+
+  const searchParams = new URLSearchParams(search);
+  const cloudPlanFromQueryRaw = isTidbcloud
+    ? searchParams.get(CLOUD_MODE_KEY)
+    : null;
+  const cloudPlanFromSessionRaw =
+    isTidbcloud && typeof window !== "undefined"
+      ? sessionStorage.getItem(CLOUD_MODE_KEY)
+      : null;
+  const cloudPlanFromQuery = isCloudPlan(cloudPlanFromQueryRaw)
+    ? cloudPlanFromQueryRaw
+    : null;
+  const cloudPlanFromSession = isCloudPlan(cloudPlanFromSessionRaw)
+    ? cloudPlanFromSessionRaw
+    : null;
+  const resolvedCloudPlan =
+    cloudPlanFromQuery || cloudPlanFromSession || _cloudPlan;
+
+  const setCloudPlan = useCallback(
+    (cloudPlan: CloudPlan) => {
+      _setCloudPlan(cloudPlan);
+      if (typeof window !== "undefined") {
+        sessionStorage.setItem(CLOUD_MODE_KEY, cloudPlan);
+      }
+    },
+    [_setCloudPlan]
+  );
 
   useEffect(() => {
-    const searchParams = new URLSearchParams(location.search);
-    const cloudPlanFromSession = sessionStorage.getItem(CLOUD_MODE_KEY);
-    const cloudPlan = (searchParams.get(CLOUD_MODE_KEY) ||
-      cloudPlanFromSession ||
-      _cloudPlan) as CloudPlan;
-    const isStarter = isTidbcloud && cloudPlan === CLOUD_MODE_VALUE_STARTER;
-    const isEssential = isTidbcloud && cloudPlan === CLOUD_MODE_VALUE_ESSENTIAL;
-    const isPremium = isTidbcloud && cloudPlan === CLOUD_MODE_VALUE_PREMIUM;
-    const isClassic =
-      !isTidbcloud || !cloudPlan || (!isStarter && !isEssential);
-
-    _setCloudPlan(cloudPlan);
-    setIsStarter(isStarter);
-    setIsEssential(isEssential);
-    setIsPremium(isPremium);
-    setIsClassic(isClassic);
-  }, []);
+    if (_cloudPlan !== resolvedCloudPlan) {
+      _setCloudPlan(resolvedCloudPlan);
+    }
+  }, [_cloudPlan, resolvedCloudPlan, _setCloudPlan]);
+
+  const isStarter = isTidbcloud && resolvedCloudPlan === CloudPlan.Starter;
+  const isEssential = isTidbcloud && resolvedCloudPlan === CloudPlan.Essential;
+  const isPremium = isTidbcloud && resolvedCloudPlan === CloudPlan.Premium;
+  const isClassic =
+    !isTidbcloud ||
+    !resolvedCloudPlan ||
+    (!isStarter && !isEssential);
 
   return {
-    cloudPlan: _cloudPlan,
+    cloudPlan: resolvedCloudPlan,
     setCloudPlan,
     isStarter,
     isEssential,
@@ -72,33 +113,81 @@ export const useCloudPlan = () => {
 };
 
 export const useCloudPlanNavigate = (
-  repo: Repo,
-  inDefaultPlan: string | null
+  namespace: TOCNamespace,
+  inDefaultPlan: CloudPlan | null,
+  tocNames: string[] | null | undefined,
+  cloudPlan: CloudPlan | null,
+  setCloudPlan: (plan: CloudPlan) => void
 ) => {
+  const { pathname, search, hash } = useLocation();
+  const tocNamesKey = Array.isArray(tocNames) ? tocNames.join("|") : "";
+
   useEffect(() => {
-    if (repo !== Repo.tidbcloud) {
+    if (namespace !== TOCNamespace.TiDBCloud) {
       return;
     }
-    const searchParams = new URLSearchParams(location.search);
-    const cloudModeFromSession = sessionStorage.getItem(CLOUD_MODE_KEY);
-    const cloudMode =
-      searchParams.get(CLOUD_MODE_KEY) || cloudModeFromSession || inDefaultPlan;
+    const searchParams = new URLSearchParams(search);
 
-    if (!cloudModeFromSession && !!cloudMode) {
+    const cloudModeFromQueryRaw = searchParams.get(CLOUD_MODE_KEY);
+    const cloudModeFromSessionRaw = sessionStorage.getItem(CLOUD_MODE_KEY);
+
+    const cloudModeFromQuery = isCloudPlan(cloudModeFromQueryRaw)
+      ? cloudModeFromQueryRaw
+      : null;
+    const cloudModeFromSession = isCloudPlan(cloudModeFromSessionRaw)
+      ? cloudModeFromSessionRaw
+      : null;
+
+    const allowedCloudPlans = getCloudPlansFromTocNames(tocNames);
+    const defaultCloudPlan =
+      allowedCloudPlans[0] || inDefaultPlan || CloudPlan.Dedicated;
+
+    const requestedCloudPlan = cloudModeFromQuery || cloudModeFromSession;
+    const shouldFallbackToDefault =
+      !requestedCloudPlan ||
+      (allowedCloudPlans.length > 0 &&
+        !allowedCloudPlans.includes(requestedCloudPlan));
+
+    const cloudMode = shouldFallbackToDefault
+      ? defaultCloudPlan
+      : requestedCloudPlan;
+
+    if (cloudPlan !== cloudMode) {
+      setCloudPlan(cloudMode);
+    }
+
+    if (cloudModeFromSession !== cloudMode) {
       sessionStorage.setItem(CLOUD_MODE_KEY, cloudMode);
     }
 
-    if (
-      !!cloudMode &&
-      cloudMode !== "dedicated" &&
-      !searchParams.get(CLOUD_MODE_KEY)
-    ) {
+    // Ensure URL carries the chosen plan when necessary, and fix invalid/mismatched plan param.
+    if (cloudMode !== CloudPlan.Dedicated) {
+      if (cloudModeFromQuery !== cloudMode) {
+        searchParams.set(CLOUD_MODE_KEY, cloudMode);
+        navigate(
+          `${pathname}?${searchParams.toString()}${hash || ""}`,
+          { replace: true }
+        );
+      }
+      return;
+    }
+
+    // Dedicated: keep URL without plan param by default; only normalize when an invalid/mismatched plan is present.
+    if (cloudModeFromQueryRaw && cloudModeFromQueryRaw !== CloudPlan.Dedicated) {
+      searchParams.set(CLOUD_MODE_KEY, CloudPlan.Dedicated);
       navigate(
-        `${location.pathname}?${CLOUD_MODE_KEY}=${cloudMode}${
-          location.hash ? location.hash : ""
-        }`,
+        `${pathname}?${searchParams.toString()}${hash || ""}`,
         { replace: true }
       );
     }
-  }, []);
+  }, [
+    namespace,
+    inDefaultPlan,
+    tocNamesKey,
+    cloudPlan,
+    setCloudPlan,
+    pathname,
+    search,
+    hash,
+  ]);
 };
diff --git a/src/shared/useIsAutoTranslation.ts b/src/shared/useIsAutoTranslation.ts
index 1756735b5..9057a59bd 100644
--- a/src/shared/useIsAutoTranslation.ts
+++ b/src/shared/useIsAutoTranslation.ts
@@ -1,11 +1,16 @@
 import { useI18next } from "gatsby-plugin-react-i18next";
-import { getPageType } from "./utils";
+import { TOCNamespace } from "shared/interface";
 
-export const useIsAutoTranslation = (pageUrl: string) => {
+export const useIsAutoTranslation = (namespace: TOCNamespace) => {
   const { language } = useI18next();
-  const pageType = getPageType(language, pageUrl);
+  const isJA = language === "ja";
+  const isZH = language === "zh";
   const isAutoTranslation =
-    pageType !== "home" &&
-    (language === "ja" || (language === "zh" && pageType === "tidbcloud"));
+    namespace !== TOCNamespace.Home &&
+    (isJA ||
+      (isZH &&
+        (namespace === TOCNamespace.TiDBCloud ||
+          namespace === TOCNamespace.TidbCloudReleases ||
+          namespace === TOCNamespace.AI)));
   return isAutoTranslation;
 };
diff --git a/src/shared/utils/index.ts b/src/shared/utils/index.ts
index 3bb0edf76..65e412a0a 100644
--- a/src/shared/utils/index.ts
+++ b/src/shared/utils/index.ts
@@ -215,7 +215,11 @@ export const AllVersion = Object.keys(CONFIG.docs).reduce((acc, val) => {
   return acc;
 }, {} as Record<Repo, Record<Locale, (string | null)[]>>);
 
-export function convertVersionName(version: string, stable: string, repo?: string) {
+export function convertVersionName(
+  version: string,
+  stable: string,
+  repo?: string
+) {
   const devBranch = repo === "tidb-in-kubernetes" ? "main" : "master";
   switch (version) {
     case devBranch:
@@ -293,19 +297,3 @@ export function scrollToElementIfInView(
 ) {
   element.scrollIntoView({ block: "end" });
 }
-
-export type PageType = "home" | "tidb" | "tidbcloud" | undefined;
-
-export const getPageType = (language?: string, pageUrl?: string): PageType => {
-  if (pageUrl === "/" || pageUrl === `/${language}/`) {
-    return "home";
-  } else if (pageUrl?.includes("/tidb/")) {
-    return "tidb";
-  } else if (
-    pageUrl?.includes("/tidbcloud/") ||
-    pageUrl?.endsWith("/tidbcloud")
-  ) {
-    return "tidbcloud";
-  }
-  return;
-};
diff --git a/src/styles/typographyDefine.css b/src/styles/typographyDefine.css
index a6d93b35e..73cf30aa5 100644
--- a/src/styles/typographyDefine.css
+++ b/src/styles/typographyDefine.css
@@ -72,7 +72,7 @@ h3,
 h4,
 h5,
 h6 {
-  scroll-margin-top: 5rem;
+  scroll-margin-top: 72px;
 }
 
 .doc-feature-banner h1,
@@ -81,5 +81,5 @@ h6 {
 .doc-feature-banner h4,
 .doc-feature-banner h5,
 .doc-feature-banner h6 {
-  scroll-margin-top: 7.5rem;
+  scroll-margin-top: 112px;
 }
diff --git a/src/templates/404Template.tsx b/src/templates/404Template.tsx
index c7ebb8c9d..d6e808b37 100644
--- a/src/templates/404Template.tsx
+++ b/src/templates/404Template.tsx
@@ -15,6 +15,7 @@ import Seo from "components/Seo";
 
 import CONFIG from "../../docs/docs.json";
 import { useEffect, useRef, useState } from "react";
+import { TOCNamespace } from "shared/interface";
 interface AllLocales {
   locales: {
     edges: {
@@ -77,8 +78,11 @@ export default function PageNotFoundTemplate({
   }, [language, data]);
 
   const isArchived = buildType === "archive";
+  const isAutoTranslation = language === Locale.ja;
   const bannerVisible =
-    (feature?.banner && language !== Locale.ja) || isArchived;
+    isArchived ||
+    isAutoTranslation ||
+    (feature?.banner && language !== Locale.ja);
 
   const secondsRef = useRef(REDIRECT_SECONDS);
   const [seconds, setSeconds] = useState(REDIRECT_SECONDS);
@@ -119,11 +123,14 @@ export default function PageNotFoundTemplate({
     <>
       <I18nextProvider i18n={i18n}>
         <I18nextContext.Provider value={{ ...context, language }}>
-          <Layout bannerEnabled={bannerVisible} buildType={buildType}>
+          <Layout
+            bannerEnabled={bannerVisible}
+            buildType={buildType}
+            namespace={TOCNamespace.NotFound}
+          >
             <Seo lang={language} title="404 Not Found" noindex />
             <Container
               sx={{
-                marginTop: bannerVisible ? "7.5rem" : "5rem",
                 minHeight: "calc(100vh - 30rem)",
                 display: "flex",
                 alignItems: "center",
diff --git a/src/templates/CloudAPIReferenceTemplate.tsx b/src/templates/CloudAPIReferenceTemplate.tsx
index 4f1c0eede..08256b49d 100644
--- a/src/templates/CloudAPIReferenceTemplate.tsx
+++ b/src/templates/CloudAPIReferenceTemplate.tsx
@@ -4,8 +4,10 @@ import Box from "@mui/material/Box";
 
 import Seo from "components/Seo";
 import Layout from "components/Layout";
-import { type BuildType, Locale } from "../shared/interface";
+import { type BuildType, Locale, TOCNamespace } from "../shared/interface";
 import { useI18next } from "gatsby-plugin-react-i18next";
+import { useIsAutoTranslation } from "shared/useIsAutoTranslation";
+import { getHeaderStickyHeight } from "shared/headerHeight";
 
 declare const Redoc: any;
 
@@ -58,7 +60,11 @@ export default function APIReferenceTemplate({
   data,
 }: APIReferenceTemplateProps) {
   const { language } = useI18next();
-  const bannerVisible = feature?.banner && language !== Locale.ja;
+  const isAutoTranslation = useIsAutoTranslation(TOCNamespace.CloudAPIApp);
+  const bannerVisible =
+    buildType === "archive" ||
+    isAutoTranslation ||
+    (feature?.banner && language !== Locale.ja);
 
   const specUrl = isProduction ? production : preview;
 
@@ -78,7 +84,10 @@ export default function APIReferenceTemplate({
         specUrl,
         {
           schemaExpansionLevel: 3,
-          scrollYOffset: ".doc-site-header",
+          scrollYOffset: Number.parseInt(
+            getHeaderStickyHeight(bannerVisible || false),
+            10
+          ),
           theme: {
             logo: { maxHeight: 0, maxWidth: 0 },
           },
@@ -117,6 +126,7 @@ export default function APIReferenceTemplate({
         //   type: pathConfig.repo,
         // }}
         buildType={buildType}
+        namespace={TOCNamespace.CloudAPIApp}
       >
         <Seo
           title="TiDB Cloud API"
@@ -133,7 +143,9 @@ export default function APIReferenceTemplate({
           ]}
         />
         <Box
-          sx={{ marginTop: bannerVisible ? "7.5rem" : "5rem", width: "100%" }}
+          sx={{
+            width: "100%",
+          }}
         >
           <Box id="redoc-container" data-testid="redoc-container" />
         </Box>
diff --git a/src/templates/DocSearchTemplate.tsx b/src/templates/DocSearchTemplate.tsx
index a07c88437..191281b4c 100644
--- a/src/templates/DocSearchTemplate.tsx
+++ b/src/templates/DocSearchTemplate.tsx
@@ -27,9 +27,10 @@ import {
   ZH_DOC_TYPE_LIST,
   TIDB_ZH_SEARCH_INDEX_VERSION,
 } from "shared/resources";
-import { Locale } from "shared/interface";
+import { Locale, TOCNamespace } from "shared/interface";
 import { FeedbackSurveyCampaign } from "components/Campaign/FeedbackSurvey";
 import { useEffect } from "react";
+import { useIsAutoTranslation } from "shared/useIsAutoTranslation";
 
 // TiDB: get searchable versions from fetchTidbSearchIndcies
 // TiDB Cloud: only has one version
@@ -196,14 +197,15 @@ export default function DocSearchTemplate({
     });
   };
 
-  const bannerVisible = feature?.banner && language !== Locale.ja;
+  const isAutoTranslation = useIsAutoTranslation(TOCNamespace.Search);
+  const bannerVisible =
+    isAutoTranslation || (feature?.banner && language !== Locale.ja);
 
   return (
     <>
-      <Layout bannerEnabled={bannerVisible}>
+      <Layout bannerEnabled={bannerVisible} namespace={TOCNamespace.Search}>
         <Container
           sx={{
-            marginTop: bannerVisible ? "7.5rem" : "5rem",
             minHeight: "calc(100vh - 30rem)",
             position: "relative",
           }}
diff --git a/src/templates/DocTemplate.tsx b/src/templates/DocTemplate.tsx
index a0b85b388..c75b16d42 100644
--- a/src/templates/DocTemplate.tsx
+++ b/src/templates/DocTemplate.tsx
@@ -22,13 +22,18 @@ import {
   BuildType,
   Locale,
   CloudPlan,
+  TOCNamespace,
 } from "shared/interface";
 import Seo from "components/Seo";
-import { getStable, generateUrl, getPageType } from "shared/utils";
+import { getStable, generateUrl } from "shared/utils";
+import { NavItemConfig } from "components/Layout/Header/HeaderNavConfigType";
+import { generateNavConfig } from "components/Layout/Header/HeaderNavConfigData";
+import { getSelectedNavItem } from "components/Layout/Header/getSelectedNavItem";
 import GitCommitInfoCard from "components/Card/GitCommitInfoCard";
 import { FeedbackSection } from "components/Card/FeedbackSection";
 import { FeedbackSurveyCampaign } from "components/Campaign/FeedbackSurvey";
 import { DOC_HOME_URL } from "shared/resources";
+import { useIsAutoTranslation } from "shared/useIsAutoTranslation";
 import { useReportReadingRate } from "shared/useReportReadingRate";
 import {
   CloudPlanProvider,
@@ -47,7 +52,9 @@ interface DocTemplateProps {
       banner?: boolean;
       feedback?: boolean;
     };
-    inDefaultPlan: string | null;
+    inDefaultPlan?: CloudPlan | null;
+    tocNames?: string[] | null;
+    namespace: TOCNamespace;
   };
   data: {
     site: {
@@ -75,7 +82,7 @@ interface DocTemplateProps {
 
 const DocTemplateWithProvider = (props: DocTemplateProps) => {
   const [cloudPlan, setCloudPlan] = React.useState<CloudPlan | null>(
-    props.pageContext.inDefaultPlan as CloudPlan | null
+    props.pageContext.inDefaultPlan ?? null
   );
   return (
     <CloudPlanProvider
@@ -102,6 +109,8 @@ function DocTemplate({
     buildType,
     feature,
     inDefaultPlan,
+    tocNames,
+    namespace,
   },
   data,
 }: DocTemplateProps) {
@@ -112,8 +121,14 @@ function DocTemplate({
     essentialNavigation: essentialNav,
   } = data;
 
-  const { cloudPlan, isStarter, isEssential } = useCloudPlan();
-  useCloudPlanNavigate(pathConfig.repo, inDefaultPlan);
+  const { cloudPlan, setCloudPlan, isStarter, isEssential } = useCloudPlan();
+  useCloudPlanNavigate(
+    namespace,
+    inDefaultPlan ?? null,
+    tocNames,
+    cloudPlan,
+    setCloudPlan
+  );
   useReportReadingRate(timeToRead);
 
   const classicNavigation = originNav ? originNav.navigation : [];
@@ -121,26 +136,27 @@ function DocTemplate({
   const essentialNavigation = essentialNav
     ? essentialNav.essentialNavigation
     : [];
-  const navigation = filterTOC(
-    isStarter
+  const navigationByNamespace =
+    namespace !== TOCNamespace.TiDBCloud
+      ? classicNavigation
+      : isStarter
       ? starterNavigation
       : isEssential
       ? essentialNavigation
-      : classicNavigation
-  );
+      : classicNavigation;
+  const navigation = filterTOC(navigationByNamespace);
 
-  const { language } = useI18next();
+  const { language, t } = useI18next();
   const haveStarter = starterNavigation.length > 0;
   const haveEssential = essentialNavigation.length > 0;
-  const availablePlans = ["dedicated"];
+  const availablePlans: CloudPlan[] = [CloudPlan.Dedicated];
   if (haveStarter) {
-    availablePlans.push("starter");
+    availablePlans.push(CloudPlan.Starter);
   }
   if (haveEssential) {
-    availablePlans.push("essential");
+    availablePlans.push(CloudPlan.Essential);
   }
 
-  const pageType = getPageType(language, pageUrl);
   const rightTocData: TableOfContent[] | undefined = React.useMemo(() => {
     let tocItems: TableOfContent[] = [];
     if (toc?.items?.length === 1) {
@@ -150,21 +166,32 @@ function DocTemplate({
     }
 
     // Filter TOC based on CustomContent conditions
-    return filterRightToc(tocItems, pageType, cloudPlan, language);
-  }, [toc, pageType, cloudPlan, language]);
+    return filterRightToc(tocItems, namespace, cloudPlan, language);
+  }, [toc, namespace, cloudPlan, language]);
 
   const stableBranch = getStable(pathConfig.repo);
 
-  const bannerVisible = feature?.banner;
+  const isAutoTranslation = useIsAutoTranslation(namespace);
+  const bannerVisible =
+    buildType === "archive" || isAutoTranslation || feature?.banner;
   const isGlobalHome = !!feature?.globalHome;
 
+  const selectedNavItem = React.useMemo<NavItemConfig | null>(() => {
+    const headerNavConfig = generateNavConfig(
+      t,
+      cloudPlan,
+      buildType,
+      language
+    );
+    return getSelectedNavItem(headerNavConfig, namespace);
+  }, [t, cloudPlan, buildType, language, namespace]);
+
   return (
     <Layout
       name={name}
       pathConfig={pathConfig}
       locales={availIn.locale}
       bannerEnabled={bannerVisible}
-      pageUrl={pageUrl}
       menu={
         frontmatter?.hide_leftNav ? null : (
           <LeftNavMobile
@@ -174,6 +201,7 @@ function DocTemplate({
             pathConfig={pathConfig}
             availIn={availIn.version}
             availablePlans={availablePlans}
+            namespace={namespace}
           />
         )
       }
@@ -182,10 +210,15 @@ function DocTemplate({
         type: pathConfig.repo,
       }}
       buildType={buildType}
+      namespace={namespace}
     >
       <Seo
         lang={language as Locale}
-        title={frontmatter.title}
+        title={`${frontmatter.title}${
+          !!pathConfig.version && pathConfig.version !== "stable"
+            ? ` - ${pathConfig.version}`
+            : ""
+        }`}
         description={frontmatter.summary}
         meta={[
           {
@@ -218,7 +251,9 @@ function DocTemplate({
         archived={buildType === "archive"}
       />
       <Box
-        sx={{ marginTop: bannerVisible ? "7.5rem" : "5rem", display: "flex" }}
+        sx={{
+          display: "flex",
+        }}
         className={clsx("PingCAP-Doc", {
           "doc-feature-banner": bannerVisible,
         })}
@@ -234,6 +269,8 @@ function DocTemplate({
               buildType={buildType}
               bannerEnabled={bannerVisible}
               availablePlans={availablePlans}
+              selectedNavItem={selectedNavItem}
+              namespace={namespace}
             />
           )}
           <Box
@@ -291,6 +328,7 @@ function DocTemplate({
                     buildType={buildType}
                     pageUrl={pageUrl}
                     cloudPlan={cloudPlan}
+                    namespace={namespace}
                   />
                   {!frontmatter?.hide_commit && buildType !== "archive" && (
                     <GitCommitInfoCard
diff --git a/src/theme/index.tsx b/src/theme/index.tsx
index df34343b3..8618b99db 100644
--- a/src/theme/index.tsx
+++ b/src/theme/index.tsx
@@ -1,10 +1,6 @@
-import * as React from "react";
-import {
-  createTheme,
-  PaletteColorOptions,
-  ThemeOptions,
-} from "@mui/material/styles";
+import { createTheme, ThemeOptions } from "@mui/material/styles";
 import { ColorPartial } from "@mui/material/styles/createPalette";
+import { treeItemClasses } from "@mui/lab/TreeItem";
 
 declare module "@mui/material/styles" {
   interface Theme {
@@ -172,15 +168,15 @@ theme = createTheme(theme, {
     carbon: theme.palette.augmentColor({
       color: {
         50: "#FFFFFF",
-        100: "#FBFDFD",
-        200: "#F5F8FA",
-        300: "#EDF0F1",
-        400: "#ECE3E5",
-        500: "#C8CED0",
+        100: "#FDFEFF",
+        200: "#F9FAFB",
+        300: "#EDF1F2",
+        400: "#DCE3E5",
+        500: "#C4CDD0",
         600: "#9FA9AD",
         700: "#6F787B",
-        800: "#3D4143",
-        900: "#262A2C",
+        800: "#383E40",
+        900: "#1E2426",
       },
       name: "carbon",
     }),
@@ -256,24 +252,63 @@ theme = createTheme(theme, {
           fontSize: "16px",
         },
         root: ({ ownerState }) => ({
+          ".MuiButton-startIcon": {
+            marginLeft: "0",
+          },
+          ".MuiButton-endIcon": {
+            marginRight: "0",
+          },
           ...(ownerState.variant === "text" && {
             color: theme.palette.text.primary,
             "&:hover": {
               backgroundColor: theme.palette.carbon[300],
             },
           }),
-          ...(ownerState.variant === "outlined" && {
-            color: theme.palette.text.primary,
-            borderColor: "#D9D9D9",
-            backgroundColor: "#F9F9F9",
-            "&:hover": {
-              borderColor: "#262A2C",
-              backgroundColor: "#F9F9F9",
-            },
-          }),
+          ...(ownerState.variant === "outlined" &&
+            ownerState.color === "secondary" && {
+              color: theme.palette.text.primary,
+              borderColor: "#C4CDD0",
+              backgroundColor: "#F9FAFB",
+              "&:hover": {
+                borderColor: "#262A2C",
+                backgroundColor: "#F9FAFB",
+              },
+            }),
+          ...(ownerState.variant === "contained" &&
+            ownerState.color === "secondary" && {
+              color: theme.palette.carbon[50],
+              backgroundColor: theme.palette.carbon[900],
+              "&:hover": {
+                backgroundColor: theme.palette.carbon[800],
+              },
+            }),
         }),
       },
     },
+    MuiMenu: {
+      styleOverrides: {
+        root: {
+          "& .MuiPaper-root .MuiList-root .MuiMenuItem-root:active": {
+            backgroundColor: theme.palette.carbon[300],
+          },
+        },
+        item: {
+          "&:active": {
+            backgroundColor: theme.palette.carbon[300],
+          },
+        },
+        list: {
+          display: "flex",
+          flexDirection: "column",
+          gap: "4px",
+          padding: "8px",
+          "& .MuiButtonBase-root+.MuiDivider-root": {
+            marginTop: "4px",
+            marginBottom: "4px",
+          },
+        },
+      },
+    },
     MuiMenuItem: {
       styleOverrides: {
         root: {
@@ -284,7 +319,7 @@ theme = createTheme(theme, {
             },
           },
           "&:hover": {
-            backgroundColor: theme.palette.carbon[300],
+            backgroundColor: theme.palette.carbon[200],
           },
         },
       },
@@ -299,6 +334,41 @@ theme = createTheme(theme, {
         },
       },
     },
+    MuiTreeItem: {
+      styleOverrides: {
+        root: {
+          marginTop: "4px",
+          marginBottom: "4px",
+          [`& .${treeItemClasses.content}`]: {
+            "&:hover": {
+              backgroundColor: theme.palette.carbon[200],
+            },
+            [`&.${treeItemClasses.focused}`]: {
+              backgroundColor: "#fff",
+              "&:hover": {
+                backgroundColor: theme.palette.carbon[200],
+              },
+            },
+            "&.Mui-selected, &.Mui-selected.Mui-focused, &.Mui-selected:hover":
+              {
+                backgroundColor: theme.palette.carbon[300],
+                [`& svg.MuiTreeItem-ChevronRightIcon`]: {
+                  fill: theme.palette.carbon[700],
+                },
+              },
+            [`&.${treeItemClasses.selected} .MuiTypography-root`]: {
+              fontWeight: 700,
+            },
+            [`& .${treeItemClasses.iconContainer}`]: {
+              display: "none",
+            },
+          },
+          [`& .${treeItemClasses.group}`]: {
+            marginLeft: 0,
+          },
+        },
+      },
+    },
   },
 } as ThemeOptions);
 
diff --git a/src/theme/variables.css b/src/theme/variables.css
index f4de5f01c..7ee9fe1cd 100644
--- a/src/theme/variables.css
+++ b/src/theme/variables.css
@@ -12,15 +12,15 @@
 
   /* Carbon */
   --tiui-palette-carbon-50: #ffffff;
-  --tiui-palette-carbon-100: #fbfdfd;
-  --tiui-palette-carbon-200: #f5f8fa;
-  --tiui-palette-carbon-300: #edf0f1;
-  --tiui-palette-carbon-400: #e3e8ea;
-  --tiui-palette-carbon-500: #c8ced0;
-  --tiui-palette-carbon-600: #9faaad;
-  --tiui-palette-carbon-700: #6c7679;
-  --tiui-palette-carbon-800: #3d4143;
-  --tiui-palette-carbon-900: #262a2c;
+  --tiui-palette-carbon-100: #fdfeff;
+  --tiui-palette-carbon-200: #f9fafb;
+  --tiui-palette-carbon-300: #edf1f2;
+  --tiui-palette-carbon-400: #c4cdd0;
+  --tiui-palette-carbon-500: #9fa9ad;
+  --tiui-palette-carbon-600: #6f787b;
+  --tiui-palette-carbon-700: #383e40;
+  --tiui-palette-carbon-800: #1e2426;
+  --tiui-palette-carbon-900: #1e2426;
 
   /* Peacock */
   --tiui-palette-peacock-50: #fbfdfe;
diff --git a/yarn.lock b/yarn.lock
index 6262999d4..05885a9e4 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -207,6 +207,15 @@
     js-tokens "^4.0.0"
     picocolors "^1.0.0"
 
+"@babel/code-frame@^7.27.1", "@babel/code-frame@^7.28.6":
+  version "7.28.6"
+  resolved "https://registry.yarnpkg.com/@babel/code-frame/-/code-frame-7.28.6.tgz#72499312ec58b1e2245ba4a4f550c132be4982f7"
+  integrity sha512-JYgintcMjRiCvS8mMECzaEn+m3PfoQiyqukOMCCVQtoJGYJw8j/8LBJEiqkHLkfwCcs74E3pbAUFNg7d9VNJ+Q==
+  dependencies:
+    "@babel/helper-validator-identifier" "^7.28.5"
+    js-tokens "^4.0.0"
+    picocolors "^1.1.1"
+
 "@babel/compat-data@^7.17.7", "@babel/compat-data@^7.18.8":
   version "7.18.8"
   resolved "https://registry.yarnpkg.com/@babel/compat-data/-/compat-data-7.18.8.tgz#2483f565faca607b8535590e84e7de323f27764d"
@@ -222,6 +231,11 @@
   resolved "https://registry.yarnpkg.com/@babel/compat-data/-/compat-data-7.26.3.tgz#99488264a56b2aded63983abd6a417f03b92ed02"
   integrity sha512-nHIxvKPniQXpmQLb0vhY3VaFb3S0YrTAwpOWJZh1wn3oJPjJk9Asva204PsBdmAE8vpzfHudT8DB0scYvy9q0g==
 
+"@babel/compat-data@^7.28.6":
+  version "7.28.6"
+  resolved "https://registry.yarnpkg.com/@babel/compat-data/-/compat-data-7.28.6.tgz#103f466803fa0f059e82ccac271475470570d74c"
+  integrity sha512-2lfu57JtzctfIrcGMz992hyLlByuzgIk58+hhGCxjKZ3rWI82NnVLjXcaTqkI2NvlcvOskZaiZ5kjUALo3Lpxg==
+
 "@babel/core@7.12.9":
   version "7.12.9"
   resolved "https://registry.yarnpkg.com/@babel/core/-/core-7.12.9.tgz#fd450c4ec10cdbb980e2928b7aa7a28484593fc8"
@@ -286,6 +300,27 @@
     json5 "^2.2.3"
     semver "^6.3.1"
 
+"@babel/core@^7.23.9", "@babel/core@^7.27.4":
+  version "7.28.6"
+  resolved "https://registry.yarnpkg.com/@babel/core/-/core-7.28.6.tgz#531bf883a1126e53501ba46eb3bb414047af507f"
+  integrity sha512-H3mcG6ZDLTlYfaSNi0iOKkigqMFvkTKlGUYlD8GW7nNOYRrevuA46iTypPyv+06V3fEmvvazfntkBU34L0azAw==
+  dependencies:
+    "@babel/code-frame" "^7.28.6"
+    "@babel/generator" "^7.28.6"
+    "@babel/helper-compilation-targets" "^7.28.6"
+    "@babel/helper-module-transforms" "^7.28.6"
+    "@babel/helpers" "^7.28.6"
+    "@babel/parser" "^7.28.6"
+    "@babel/template" "^7.28.6"
+    "@babel/traverse" "^7.28.6"
+    "@babel/types" "^7.28.6"
+    "@jridgewell/remapping" "^2.3.5"
+    convert-source-map "^2.0.0"
+    debug "^4.1.0"
+    gensync "^1.0.0-beta.2"
+    json5 "^2.2.3"
+    semver "^6.3.1"
+
 "@babel/eslint-parser@^7.15.4":
   version "7.26.8"
   resolved "https://registry.yarnpkg.com/@babel/eslint-parser/-/eslint-parser-7.26.8.tgz#55c4f4aae4970ae127f7a12369182ed6250e6f09"
@@ -335,6 +370,17 @@
     "@jridgewell/trace-mapping" "^0.3.25"
     jsesc "^3.0.2"
 
+"@babel/generator@^7.27.5", "@babel/generator@^7.28.6":
+  version "7.28.6"
+  resolved "https://registry.yarnpkg.com/@babel/generator/-/generator-7.28.6.tgz#48dcc65d98fcc8626a48f72b62e263d25fc3c3f1"
+  integrity sha512-lOoVRwADj8hjf7al89tvQ2a1lf53Z+7tiXMgpZJL3maQPDxh0DgLMN62B2MKUOFcoodBHLMbDM6WAbKgNy5Suw==
+  dependencies:
+    "@babel/parser" "^7.28.6"
+    "@babel/types" "^7.28.6"
+    "@jridgewell/gen-mapping" "^0.3.12"
+    "@jridgewell/trace-mapping" "^0.3.28"
+    jsesc "^3.0.2"
+
 "@babel/helper-annotate-as-pure@^7.18.6":
   version "7.18.6"
   resolved "https://registry.yarnpkg.com/@babel/helper-annotate-as-pure/-/helper-annotate-as-pure-7.18.6.tgz#eaa49f6f80d5a33f9a5dd2276e6d6e451be0a6bb"
@@ -389,6 +435,17 @@
     lru-cache "^5.1.1"
     semver "^6.3.1"
 
+"@babel/helper-compilation-targets@^7.28.6":
+  version "7.28.6"
+  resolved "https://registry.yarnpkg.com/@babel/helper-compilation-targets/-/helper-compilation-targets-7.28.6.tgz#32c4a3f41f12ed1532179b108a4d746e105c2b25"
+  integrity sha512-JYtls3hqi15fcx5GaSNL7SCTJ2MNmjrkHXg4FSpOA/grxK8KwyZ5bubHsCq8FXCkua6xhuaaBit+3b7+VZRfcA==
+  dependencies:
+    "@babel/compat-data" "^7.28.6"
+    "@babel/helper-validator-option" "^7.27.1"
+    browserslist "^4.24.0"
+    lru-cache "^5.1.1"
+    semver "^6.3.1"
+
 "@babel/helper-create-class-features-plugin@^7.18.6":
   version "7.18.9"
   resolved "https://registry.yarnpkg.com/@babel/helper-create-class-features-plugin/-/helper-create-class-features-plugin-7.18.9.tgz#d802ee16a64a9e824fcbf0a2ffc92f19d58550ce"
@@ -466,6 +523,11 @@
     "@babel/template" "^7.18.6"
     "@babel/types" "^7.18.9"
 
+"@babel/helper-globals@^7.28.0":
+  version "7.28.0"
+  resolved "https://registry.yarnpkg.com/@babel/helper-globals/-/helper-globals-7.28.0.tgz#b9430df2aa4e17bc28665eadeae8aa1d985e6674"
+  integrity sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==
+
 "@babel/helper-hoist-variables@^7.16.7", "@babel/helper-hoist-variables@^7.18.6":
   version "7.18.6"
   resolved "https://registry.yarnpkg.com/@babel/helper-hoist-variables/-/helper-hoist-variables-7.18.6.tgz#d4d2c8fb4baeaa5c68b99cc8245c56554f926678"
@@ -503,6 +565,14 @@
   dependencies:
     "@babel/types" "^7.18.6"
 
+"@babel/helper-module-imports@^7.28.6":
+  version "7.28.6"
+  resolved "https://registry.yarnpkg.com/@babel/helper-module-imports/-/helper-module-imports-7.28.6.tgz#60632cbd6ffb70b22823187201116762a03e2d5c"
+  integrity sha512-l5XkZK7r7wa9LucGw9LwZyyCUscb4x37JWTPz7swwFE/0FMQAGpiWUZn8u9DzkSBWEcK25jmvubfpw2dnAMdbw==
+  dependencies:
+    "@babel/traverse" "^7.28.6"
+    "@babel/types" "^7.28.6"
+
 "@babel/helper-module-transforms@^7.12.1":
   version "7.17.6"
   resolved "https://registry.yarnpkg.com/@babel/helper-module-transforms/-/helper-module-transforms-7.17.6.tgz#3c3b03cc6617e33d68ef5a27a67419ac5199ccd0"
@@ -540,6 +610,15 @@
     "@babel/helper-validator-identifier" "^7.25.9"
     "@babel/traverse" "^7.25.9"
 
+"@babel/helper-module-transforms@^7.28.6":
+  version "7.28.6"
+  resolved "https://registry.yarnpkg.com/@babel/helper-module-transforms/-/helper-module-transforms-7.28.6.tgz#9312d9d9e56edc35aeb6e95c25d4106b50b9eb1e"
+  integrity sha512-67oXFAYr2cDLDVGLXTEABjdBJZ6drElUSI7WKp70NrpyISso3plG9SAGEF6y7zbha/wOzUByWWTJvEDVNIUGcA==
+  dependencies:
+    "@babel/helper-module-imports" "^7.28.6"
+    "@babel/helper-validator-identifier" "^7.28.5"
+    "@babel/traverse" "^7.28.6"
+
 "@babel/helper-optimise-call-expression@^7.18.6":
   version "7.18.6"
   resolved "https://registry.yarnpkg.com/@babel/helper-optimise-call-expression/-/helper-optimise-call-expression-7.18.6.tgz#9369aa943ee7da47edab2cb4e838acf09d290ffe"
@@ -569,6 +648,11 @@
   resolved "https://registry.yarnpkg.com/@babel/helper-plugin-utils/-/helper-plugin-utils-7.26.5.tgz#18580d00c9934117ad719392c4f6585c9333cc35"
   integrity sha512-RS+jZcRdZdRFzMyr+wcsaqOmld1/EqTghfaBGQQd/WnRdzdlvSZ//kF7U8VQTxf1ynZ4cjUcYgjVGx13ewNPMg==
 
+"@babel/helper-plugin-utils@^7.28.6":
+  version "7.28.6"
+  resolved "https://registry.yarnpkg.com/@babel/helper-plugin-utils/-/helper-plugin-utils-7.28.6.tgz#6f13ea251b68c8532e985fd532f28741a8af9ac8"
+  integrity sha512-S9gzZ/bz83GRysI7gAD4wPT/AI3uCnY+9xn+Mx/KPs2JwHJIz1W8PZkg2cqyt3RNOBM8ejcXhV6y8Og7ly/Dug==
+
 "@babel/helper-remap-async-to-generator@^7.18.6", "@babel/helper-remap-async-to-generator@^7.18.9":
   version "7.18.9"
   resolved "https://registry.yarnpkg.com/@babel/helper-remap-async-to-generator/-/helper-remap-async-to-generator-7.18.9.tgz#997458a0e3357080e54e1d79ec347f8a8cd28519"
@@ -645,6 +729,11 @@
   resolved "https://registry.yarnpkg.com/@babel/helper-string-parser/-/helper-string-parser-7.25.9.tgz#1aabb72ee72ed35789b4bbcad3ca2862ce614e8c"
   integrity sha512-4A/SCr/2KLd5jrtOMFzaKjVtAei3+2r/NChoBNoZ3EyP/+GlhoaEGoWOZUmFmoITP7zOJyHIMm+DYRd8o3PvHA==
 
+"@babel/helper-string-parser@^7.27.1":
+  version "7.27.1"
+  resolved "https://registry.yarnpkg.com/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz#54da796097ab19ce67ed9f88b47bb2ec49367687"
+  integrity sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==
+
 "@babel/helper-validator-identifier@^7.16.7", "@babel/helper-validator-identifier@^7.18.6":
   version "7.18.6"
   resolved "https://registry.yarnpkg.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.18.6.tgz#9c97e30d31b2b8c72a1d08984f2ca9b574d7a076"
@@ -655,6 +744,11 @@
   resolved "https://registry.yarnpkg.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.25.9.tgz#24b64e2c3ec7cd3b3c547729b8d16871f22cbdc7"
   integrity sha512-Ed61U6XJc3CVRfkERJWDz4dJwKe7iLmmJsbOGu9wSloNSFttHV0I8g6UAgb7qnK5ly5bGLPd4oXZlxCdANBOWQ==
 
+"@babel/helper-validator-identifier@^7.28.5":
+  version "7.28.5"
+  resolved "https://registry.yarnpkg.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz#010b6938fab7cb7df74aa2bbc06aa503b8fe5fb4"
+  integrity sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==
+
 "@babel/helper-validator-option@^7.18.6":
   version "7.18.6"
   resolved "https://registry.yarnpkg.com/@babel/helper-validator-option/-/helper-validator-option-7.18.6.tgz#bf0d2b5a509b1f336099e4ff36e1a63aa5db4db8"
@@ -665,6 +759,11 @@
   resolved "https://registry.yarnpkg.com/@babel/helper-validator-option/-/helper-validator-option-7.25.9.tgz#86e45bd8a49ab7e03f276577f96179653d41da72"
   integrity sha512-e/zv1co8pp55dNdEcCynfj9X7nyUKUXoUEwfXqaZt0omVOmDe9oOTdKStH4GmAw6zxMFs50ZayuMfHDKlO7Tfw==
 
+"@babel/helper-validator-option@^7.27.1":
+  version "7.27.1"
+  resolved "https://registry.yarnpkg.com/@babel/helper-validator-option/-/helper-validator-option-7.27.1.tgz#fa52f5b1e7db1ab049445b421c4471303897702f"
+  integrity sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==
+
 "@babel/helper-wrap-function@^7.18.9":
   version "7.18.11"
   resolved "https://registry.yarnpkg.com/@babel/helper-wrap-function/-/helper-wrap-function-7.18.11.tgz#bff23ace436e3f6aefb61f85ffae2291c80ed1fb"
@@ -701,6 +800,14 @@
     "@babel/template" "^7.25.9"
     "@babel/types" "^7.26.0"
 
+"@babel/helpers@^7.28.6":
+  version "7.28.6"
+  resolved "https://registry.yarnpkg.com/@babel/helpers/-/helpers-7.28.6.tgz#fca903a313ae675617936e8998b814c415cbf5d7"
+  integrity sha512-xOBvwq86HHdB7WUDTfKfT/Vuxh7gElQ+Sfti2Cy6yIWNW05P8iUslOVcZ4/sKbE+/jQaukQAdz/gf3724kYdqw==
+  dependencies:
+    "@babel/template" "^7.28.6"
+    "@babel/types" "^7.28.6"
+
 "@babel/highlight@^7.10.4", "@babel/highlight@^7.16.7", "@babel/highlight@^7.18.6":
   version "7.18.6"
   resolved "https://registry.yarnpkg.com/@babel/highlight/-/highlight-7.18.6.tgz#81158601e93e2563795adcbfbdf5d64be3f2ecdf"
@@ -710,6 +817,13 @@
     chalk "^2.0.0"
     js-tokens "^4.0.0"
 
+"@babel/parser@^7.1.0", "@babel/parser@^7.20.7", "@babel/parser@^7.23.9", "@babel/parser@^7.28.6":
+  version "7.28.6"
+  resolved "https://registry.yarnpkg.com/@babel/parser/-/parser-7.28.6.tgz#f01a8885b7fa1e56dd8a155130226cd698ef13fd"
+  integrity sha512-TeR9zWR18BvbfPmGbLampPMW+uW1NZnJlRuuHso8i87QZNq2JRF9i6RgxRqtEq+wQGsS19NNTWr2duhnE49mfQ==
+  dependencies:
+    "@babel/types" "^7.28.6"
+
 "@babel/parser@^7.12.7":
   version "7.17.3"
   resolved "https://registry.yarnpkg.com/@babel/parser/-/parser-7.17.3.tgz#b07702b982990bf6fdc1da5049a23fece4c5c3d0"
@@ -904,6 +1018,13 @@
   dependencies:
     "@babel/helper-plugin-utils" "^7.8.0"
 
+"@babel/plugin-syntax-bigint@^7.8.3":
+  version "7.8.3"
+  resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-bigint/-/plugin-syntax-bigint-7.8.3.tgz#4c9a6f669f5d0cdf1b90a1671e9a146be5300cea"
+  integrity sha512-wnTnFlG+YxQm3vDxpGE57Pj0srRU4sHE/mDkt1qv2YJJSeUAec2ma4WLUnUPeKjyrfntVwe/N6dCXpU+zL3Npg==
+  dependencies:
+    "@babel/helper-plugin-utils" "^7.8.0"
+
 "@babel/plugin-syntax-class-properties@^7.0.0", "@babel/plugin-syntax-class-properties@^7.12.13":
   version "7.12.13"
   resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-class-properties/-/plugin-syntax-class-properties-7.12.13.tgz#b5c987274c4a3a82b89714796931a6b53544ae10"
@@ -953,6 +1074,20 @@
   dependencies:
     "@babel/helper-plugin-utils" "^7.25.9"
 
+"@babel/plugin-syntax-import-attributes@^7.24.7":
+  version "7.28.6"
+  resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.28.6.tgz#b71d5914665f60124e133696f17cd7669062c503"
+  integrity sha512-jiLC0ma9XkQT3TKJ9uYvlakm66Pamywo+qwL+oL8HJOvc6TWdZXVfhqJr8CCzbSGUAbDOzlGHJC1U+vRfLQDvw==
+  dependencies:
+    "@babel/helper-plugin-utils" "^7.28.6"
+
+"@babel/plugin-syntax-import-meta@^7.10.4":
+  version "7.10.4"
+  resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-import-meta/-/plugin-syntax-import-meta-7.10.4.tgz#ee601348c370fa334d2207be158777496521fd51"
+  integrity sha512-Yqfm+XDx0+Prh3VSeEQCPU81yC+JWZ2pDPFSS4ZdpfZhp4MkFMaDC1UqseovEKwSUpnIL7+vK+Clp7bfh0iD7g==
+  dependencies:
+    "@babel/helper-plugin-utils" "^7.10.4"
+
 "@babel/plugin-syntax-json-strings@^7.8.3":
   version "7.8.3"
   resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-json-strings/-/plugin-syntax-json-strings-7.8.3.tgz#01ca21b668cd8218c9e640cb6dd88c5412b2c96a"
@@ -981,6 +1116,13 @@
   dependencies:
     "@babel/helper-plugin-utils" "^7.25.9"
 
+"@babel/plugin-syntax-jsx@^7.27.1":
+  version "7.28.6"
+  resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.28.6.tgz#f8ca28bbd84883b5fea0e447c635b81ba73997ee"
+  integrity sha512-wgEmr06G6sIpqr8YDwA2dSRTE3bJ+V0IfpzfSY3Lfgd7YWOaAdlykvJi13ZKBt8cZHfgH1IXN+CL656W3uUa4w==
+  dependencies:
+    "@babel/helper-plugin-utils" "^7.28.6"
+
 "@babel/plugin-syntax-logical-assignment-operators@^7.10.4":
   version "7.10.4"
   resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-logical-assignment-operators/-/plugin-syntax-logical-assignment-operators-7.10.4.tgz#ca91ef46303530448b906652bac2e9fe9941f699"
@@ -1044,6 +1186,13 @@
   dependencies:
     "@babel/helper-plugin-utils" "^7.25.9"
 
+"@babel/plugin-syntax-typescript@^7.27.1":
+  version "7.28.6"
+  resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.28.6.tgz#c7b2ddf1d0a811145b1de800d1abd146af92e3a2"
+  integrity sha512-+nDNmQye7nlnuuHDboPbGm00Vqg3oO8niRRL27/4LYHUsHYh0zJ1xWOz0uRwNFmM1Avzk8wZbc6rdiYhomzv/A==
+  dependencies:
+    "@babel/helper-plugin-utils" "^7.28.6"
+
 "@babel/plugin-transform-arrow-functions@^7.0.0", "@babel/plugin-transform-arrow-functions@^7.18.6":
   version "7.18.6"
   resolved "https://registry.yarnpkg.com/@babel/plugin-transform-arrow-functions/-/plugin-transform-arrow-functions-7.18.6.tgz#19063fcf8771ec7b31d742339dac62433d0611fe"
@@ -1579,6 +1728,15 @@
     "@babel/parser" "^7.26.8"
     "@babel/types" "^7.26.8"
 
+"@babel/template@^7.28.6":
+  version "7.28.6"
+  resolved "https://registry.yarnpkg.com/@babel/template/-/template-7.28.6.tgz#0e7e56ecedb78aeef66ce7972b082fce76a23e57"
+  integrity sha512-YA6Ma2KsCdGb+WC6UpBVFJGXL58MDA6oyONbjyF/+5sBgxY/dwkhLogbMT2GXXyU84/IhRw/2D1Os1B/giz+BQ==
+  dependencies:
+    "@babel/code-frame" "^7.28.6"
+    "@babel/parser" "^7.28.6"
+    "@babel/types" "^7.28.6"
+
 "@babel/traverse@^7.12.9":
   version "7.17.3"
   resolved "https://registry.yarnpkg.com/@babel/traverse/-/traverse-7.17.3.tgz#0ae0f15b27d9a92ba1f2263358ea7c4e7db47b57"
@@ -1653,6 +1811,19 @@
     debug "^4.3.1"
     globals "^11.1.0"
 
+"@babel/traverse@^7.28.6":
+  version "7.28.6"
+  resolved "https://registry.yarnpkg.com/@babel/traverse/-/traverse-7.28.6.tgz#871ddc79a80599a5030c53b1cc48cbe3a5583c2e"
+  integrity sha512-fgWX62k02qtjqdSNTAGxmKYY/7FSL9WAS1o2Hu5+I5m9T0yxZzr4cnrfXQ/MX0rIifthCSs6FKTlzYbJcPtMNg==
+  dependencies:
+    "@babel/code-frame" "^7.28.6"
+    "@babel/generator" "^7.28.6"
+    "@babel/helper-globals" "^7.28.0"
+    "@babel/parser" "^7.28.6"
+    "@babel/template" "^7.28.6"
+    "@babel/types" "^7.28.6"
+    debug "^4.3.1"
+
 "@babel/types@^7.0.0", "@babel/types@^7.15.4", "@babel/types@^7.16.7", "@babel/types@^7.16.8", "@babel/types@^7.17.0", "@babel/types@^7.18.0", "@babel/types@^7.18.10", "@babel/types@^7.18.6", "@babel/types@^7.18.9", "@babel/types@^7.4.4":
   version "7.18.10"
   resolved "https://registry.yarnpkg.com/@babel/types/-/types-7.18.10.tgz#4908e81b6b339ca7c6b7a555a5fc29446f26dde6"
@@ -1678,6 +1849,14 @@
     "@babel/helper-validator-identifier" "^7.16.7"
     to-fast-properties "^2.0.0"
 
+"@babel/types@^7.20.7", "@babel/types@^7.27.3", "@babel/types@^7.28.2", "@babel/types@^7.28.6":
+  version "7.28.6"
+  resolved "https://registry.yarnpkg.com/@babel/types/-/types-7.28.6.tgz#c3e9377f1b155005bcc4c46020e7e394e13089df"
+  integrity sha512-0ZrskXVEHSWIqZM/sQZ4EV3jZJXRkio/WCxaqKZP1g//CEWEPSfeZFcms4XeKBCHU0ZKnIkdJeU/kF+eRp5lBg==
+  dependencies:
+    "@babel/helper-string-parser" "^7.27.1"
+    "@babel/helper-validator-identifier" "^7.28.5"
+
 "@babel/types@^7.25.9", "@babel/types@^7.26.0", "@babel/types@^7.26.3":
   version "7.26.3"
   resolved "https://registry.yarnpkg.com/@babel/types/-/types-7.26.3.tgz#37e79830f04c2b5687acc77db97fbc75fb81f3c0"
@@ -1686,6 +1865,11 @@
     "@babel/helper-string-parser" "^7.25.9"
     "@babel/helper-validator-identifier" "^7.25.9"
 
+"@bcoe/v8-coverage@^0.2.3":
+  version "0.2.3"
+  resolved "https://registry.yarnpkg.com/@bcoe/v8-coverage/-/v8-coverage-0.2.3.tgz#75a2e8b51cb758a7553d6804a5932d7aace75c39"
+  integrity sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw==
+
 "@builder.io/partytown@^0.5.2":
   version "0.5.4"
   resolved "https://registry.yarnpkg.com/@builder.io/partytown/-/partytown-0.5.4.tgz#1a89069978734e132fa4a59414ddb64e4b94fde7"
@@ -1817,6 +2001,28 @@
     is-absolute "^1.0.0"
     is-negated-glob "^1.0.0"
 
+"@emnapi/core@^1.4.3":
+  version "1.8.1"
+  resolved "https://registry.yarnpkg.com/@emnapi/core/-/core-1.8.1.tgz#fd9efe721a616288345ffee17a1f26ac5dd01349"
+  integrity sha512-AvT9QFpxK0Zd8J0jopedNm+w/2fIzvtPKPjqyw9jwvBaReTTqPBk9Hixaz7KbjimP+QNz605/XnjFcDAL2pqBg==
+  dependencies:
+    "@emnapi/wasi-threads" "1.1.0"
+    tslib "^2.4.0"
+
+"@emnapi/runtime@^1.4.3":
+  version "1.8.1"
+  resolved "https://registry.yarnpkg.com/@emnapi/runtime/-/runtime-1.8.1.tgz#550fa7e3c0d49c5fb175a116e8cd70614f9a22a5"
+  integrity sha512-mehfKSMWjjNol8659Z8KxEMrdSJDDot5SXMq00dM8BN4o+CLNXQ0xH2V7EchNHV4RmbZLmmPdEaXZc5H2FXmDg==
+  dependencies:
+    tslib "^2.4.0"
+
+"@emnapi/wasi-threads@1.1.0":
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/@emnapi/wasi-threads/-/wasi-threads-1.1.0.tgz#60b2102fddc9ccb78607e4a3cf8403ea69be41bf"
+  integrity sha512-WI0DdZ8xFSbgMjR1sFsKABJ/C5OnRrjT06JXbZKexJGrDuPTzZdDYfFlsgcCXCyf+suG5QU2e/y1Wo2V/OapLQ==
+  dependencies:
+    tslib "^2.4.0"
+
 "@emotion/babel-plugin@^11.10.0":
   version "11.10.0"
   resolved "https://registry.yarnpkg.com/@emotion/babel-plugin/-/babel-plugin-11.10.0.tgz#ae545b8faa6b42d3a50ec86b70b758296f3c4467"
@@ -2298,6 +2504,254 @@
   resolved "https://registry.yarnpkg.com/@humanwhocodes/object-schema/-/object-schema-1.2.1.tgz#b520529ec21d8e5945a1851dfd1c32e94e39ff45"
   integrity sha512-ZnQMnLV4e7hDlUvw8H+U8ASL02SS2Gn6+9Ac3wGGLIe7+je2AeAOxPY+izIPJDfFDb7eDjev0Us8MO1iFRN8hA==
 
+"@isaacs/cliui@^8.0.2":
+  version "8.0.2"
+  resolved "https://registry.yarnpkg.com/@isaacs/cliui/-/cliui-8.0.2.tgz#b37667b7bc181c168782259bab42474fbf52b550"
+  integrity sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==
+  dependencies:
+    string-width "^5.1.2"
+    string-width-cjs "npm:string-width@^4.2.0"
+    strip-ansi "^7.0.1"
+    strip-ansi-cjs "npm:strip-ansi@^6.0.1"
+    wrap-ansi "^8.1.0"
+    wrap-ansi-cjs "npm:wrap-ansi@^7.0.0"
+
+"@istanbuljs/load-nyc-config@^1.0.0":
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/@istanbuljs/load-nyc-config/-/load-nyc-config-1.1.0.tgz#fd3db1d59ecf7cf121e80650bb86712f9b55eced"
+  integrity sha512-VjeHSlIzpv/NyD3N0YuHfXOPDIixcA1q2ZV98wsMqcYlPmv2n3Yb2lYP9XMElnaFVXg5A7YLTeLu6V84uQDjmQ==
+  dependencies:
+    camelcase "^5.3.1"
+    find-up "^4.1.0"
+    get-package-type "^0.1.0"
+    js-yaml "^3.13.1"
+    resolve-from "^5.0.0"
+
+"@istanbuljs/schema@^0.1.2", "@istanbuljs/schema@^0.1.3":
+  version "0.1.3"
+  resolved "https://registry.yarnpkg.com/@istanbuljs/schema/-/schema-0.1.3.tgz#e45e384e4b8ec16bce2fd903af78450f6bf7ec98"
+  integrity sha512-ZXRY4jNvVgSVQ8DL3LTcakaAtXwTVUxE81hslsyD2AtoXW/wVob10HkOJ1X/pAlcI7D+2YoZKg5do8G/w6RYgA==
+
+"@jest/console@30.2.0":
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/@jest/console/-/console-30.2.0.tgz#c52fcd5b58fdd2e8eb66b2fd8ae56f2f64d05b28"
+  integrity sha512-+O1ifRjkvYIkBqASKWgLxrpEhQAAE7hY77ALLUufSk5717KfOShg6IbqLmdsLMPdUiFvA2kTs0R7YZy+l0IzZQ==
+  dependencies:
+    "@jest/types" "30.2.0"
+    "@types/node" "*"
+    chalk "^4.1.2"
+    jest-message-util "30.2.0"
+    jest-util "30.2.0"
+    slash "^3.0.0"
+
+"@jest/core@30.2.0":
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/@jest/core/-/core-30.2.0.tgz#813d59faa5abd5510964a8b3a7b17cc77b775275"
+  integrity sha512-03W6IhuhjqTlpzh/ojut/pDB2LPRygyWX8ExpgHtQA8H/3K7+1vKmcINx5UzeOX1se6YEsBsOHQ1CRzf3fOwTQ==
+  dependencies:
+    "@jest/console" "30.2.0"
+    "@jest/pattern" "30.0.1"
+    "@jest/reporters" "30.2.0"
+    "@jest/test-result" "30.2.0"
+    "@jest/transform" "30.2.0"
+    "@jest/types" "30.2.0"
+    "@types/node" "*"
+    ansi-escapes "^4.3.2"
+    chalk "^4.1.2"
+    ci-info "^4.2.0"
+    exit-x "^0.2.2"
+    graceful-fs "^4.2.11"
+    jest-changed-files "30.2.0"
+    jest-config "30.2.0"
+    jest-haste-map "30.2.0"
+    jest-message-util "30.2.0"
+    jest-regex-util "30.0.1"
+    jest-resolve "30.2.0"
+    jest-resolve-dependencies "30.2.0"
+    jest-runner "30.2.0"
+    jest-runtime "30.2.0"
+    jest-snapshot "30.2.0"
+    jest-util "30.2.0"
+    jest-validate "30.2.0"
+    jest-watcher "30.2.0"
+    micromatch "^4.0.8"
+    pretty-format "30.2.0"
+    slash "^3.0.0"
+
+"@jest/diff-sequences@30.0.1":
+  version "30.0.1"
+  resolved "https://registry.yarnpkg.com/@jest/diff-sequences/-/diff-sequences-30.0.1.tgz#0ededeae4d071f5c8ffe3678d15f3a1be09156be"
+  integrity sha512-n5H8QLDJ47QqbCNn5SuFjCRDrOLEZ0h8vAHCK5RL9Ls7Xa8AQLa/YxAc9UjFqoEDM48muwtBGjtMY5cr0PLDCw==
+
+"@jest/environment@30.2.0":
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/@jest/environment/-/environment-30.2.0.tgz#1e673cdb8b93ded707cf6631b8353011460831fa"
+  integrity sha512-/QPTL7OBJQ5ac09UDRa3EQes4gt1FTEG/8jZ/4v5IVzx+Cv7dLxlVIvfvSVRiiX2drWyXeBjkMSR8hvOWSog5g==
+  dependencies:
+    "@jest/fake-timers" "30.2.0"
+    "@jest/types" "30.2.0"
+    "@types/node" "*"
+    jest-mock "30.2.0"
+
+"@jest/expect-utils@30.2.0":
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/@jest/expect-utils/-/expect-utils-30.2.0.tgz#4f95413d4748454fdb17404bf1141827d15e6011"
+  integrity sha512-1JnRfhqpD8HGpOmQp180Fo9Zt69zNtC+9lR+kT7NVL05tNXIi+QC8Csz7lfidMoVLPD3FnOtcmp0CEFnxExGEA==
+  dependencies:
+    "@jest/get-type" "30.1.0"
+
+"@jest/expect@30.2.0":
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/@jest/expect/-/expect-30.2.0.tgz#9a5968499bb8add2bbb09136f69f7df5ddbf3185"
+  integrity sha512-V9yxQK5erfzx99Sf+7LbhBwNWEZ9eZay8qQ9+JSC0TrMR1pMDHLMY+BnVPacWU6Jamrh252/IKo4F1Xn/zfiqA==
+  dependencies:
+    expect "30.2.0"
+    jest-snapshot "30.2.0"
+
+"@jest/fake-timers@30.2.0":
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/@jest/fake-timers/-/fake-timers-30.2.0.tgz#0941ddc28a339b9819542495b5408622dc9e94ec"
+  integrity sha512-HI3tRLjRxAbBy0VO8dqqm7Hb2mIa8d5bg/NJkyQcOk7V118ObQML8RC5luTF/Zsg4474a+gDvhce7eTnP4GhYw==
+  dependencies:
+    "@jest/types" "30.2.0"
+    "@sinonjs/fake-timers" "^13.0.0"
+    "@types/node" "*"
+    jest-message-util "30.2.0"
+    jest-mock "30.2.0"
+    jest-util "30.2.0"
+
+"@jest/get-type@30.1.0":
+  version "30.1.0"
+  resolved "https://registry.yarnpkg.com/@jest/get-type/-/get-type-30.1.0.tgz#4fcb4dc2ebcf0811be1c04fd1cb79c2dba431cbc"
+  integrity sha512-eMbZE2hUnx1WV0pmURZY9XoXPkUYjpc55mb0CrhtdWLtzMQPFvu/rZkTLZFTsdaVQa+Tr4eWAteqcUzoawq/uA==
+
+"@jest/globals@30.2.0":
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/@jest/globals/-/globals-30.2.0.tgz#2f4b696d5862664b89c4ee2e49ae24d2bb7e0988"
+  integrity sha512-b63wmnKPaK+6ZZfpYhz9K61oybvbI1aMcIs80++JI1O1rR1vaxHUCNqo3ITu6NU0d4V34yZFoHMn/uoKr/Rwfw==
+  dependencies:
+    "@jest/environment" "30.2.0"
+    "@jest/expect" "30.2.0"
+    "@jest/types" "30.2.0"
+    jest-mock "30.2.0"
+
+"@jest/pattern@30.0.1":
+  version "30.0.1"
+  resolved "https://registry.yarnpkg.com/@jest/pattern/-/pattern-30.0.1.tgz#d5304147f49a052900b4b853dedb111d080e199f"
+  integrity sha512-gWp7NfQW27LaBQz3TITS8L7ZCQ0TLvtmI//4OwlQRx4rnWxcPNIYjxZpDcN4+UlGxgm3jS5QPz8IPTCkb59wZA==
+  dependencies:
+    "@types/node" "*"
+    jest-regex-util "30.0.1"
+
+"@jest/reporters@30.2.0":
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/@jest/reporters/-/reporters-30.2.0.tgz#a36b28fcbaf0c4595250b108e6f20e363348fd91"
+  integrity sha512-DRyW6baWPqKMa9CzeiBjHwjd8XeAyco2Vt8XbcLFjiwCOEKOvy82GJ8QQnJE9ofsxCMPjH4MfH8fCWIHHDKpAQ==
+  dependencies:
+    "@bcoe/v8-coverage" "^0.2.3"
+    "@jest/console" "30.2.0"
+    "@jest/test-result" "30.2.0"
+    "@jest/transform" "30.2.0"
+    "@jest/types" "30.2.0"
+    "@jridgewell/trace-mapping" "^0.3.25"
+    "@types/node" "*"
+    chalk "^4.1.2"
+    collect-v8-coverage "^1.0.2"
+    exit-x "^0.2.2"
+    glob "^10.3.10"
+    graceful-fs "^4.2.11"
+    istanbul-lib-coverage "^3.0.0"
+    istanbul-lib-instrument "^6.0.0"
+    istanbul-lib-report "^3.0.0"
+    istanbul-lib-source-maps "^5.0.0"
+    istanbul-reports "^3.1.3"
+    jest-message-util "30.2.0"
+    jest-util "30.2.0"
+    jest-worker "30.2.0"
+    slash "^3.0.0"
+    string-length "^4.0.2"
+    v8-to-istanbul "^9.0.1"
+
+"@jest/schemas@30.0.5":
+  version "30.0.5"
+  resolved "https://registry.yarnpkg.com/@jest/schemas/-/schemas-30.0.5.tgz#7bdf69fc5a368a5abdb49fd91036c55225846473"
+  integrity sha512-DmdYgtezMkh3cpU8/1uyXakv3tJRcmcXxBOcO0tbaozPwpmh4YMsnWrQm9ZmZMfa5ocbxzbFk6O4bDPEc/iAnA==
+  dependencies:
+    "@sinclair/typebox" "^0.34.0"
+
+"@jest/snapshot-utils@30.2.0":
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/@jest/snapshot-utils/-/snapshot-utils-30.2.0.tgz#387858eb90c2f98f67bff327435a532ac5309fbe"
+  integrity sha512-0aVxM3RH6DaiLcjj/b0KrIBZhSX1373Xci4l3cW5xiUWPctZ59zQ7jj4rqcJQ/Z8JuN/4wX3FpJSa3RssVvCug==
+  dependencies:
+    "@jest/types" "30.2.0"
+    chalk "^4.1.2"
+    graceful-fs "^4.2.11"
+    natural-compare "^1.4.0"
+
+"@jest/source-map@30.0.1":
+  version "30.0.1"
+  resolved "https://registry.yarnpkg.com/@jest/source-map/-/source-map-30.0.1.tgz#305ebec50468f13e658b3d5c26f85107a5620aaa"
+  integrity sha512-MIRWMUUR3sdbP36oyNyhbThLHyJ2eEDClPCiHVbrYAe5g3CHRArIVpBw7cdSB5fr+ofSfIb2Tnsw8iEHL0PYQg==
+  dependencies:
+    "@jridgewell/trace-mapping" "^0.3.25"
+    callsites "^3.1.0"
+    graceful-fs "^4.2.11"
+
+"@jest/test-result@30.2.0":
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/@jest/test-result/-/test-result-30.2.0.tgz#9c0124377fb7996cdffb86eda3dbc56eacab363d"
+  integrity sha512-RF+Z+0CCHkARz5HT9mcQCBulb1wgCP3FBvl9VFokMX27acKphwyQsNuWH3c+ojd1LeWBLoTYoxF0zm6S/66mjg==
+  dependencies:
+    "@jest/console" "30.2.0"
+    "@jest/types" "30.2.0"
+    "@types/istanbul-lib-coverage" "^2.0.6"
+    collect-v8-coverage "^1.0.2"
+
+"@jest/test-sequencer@30.2.0":
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/@jest/test-sequencer/-/test-sequencer-30.2.0.tgz#bf0066bc72e176d58f5dfa7f212b6e7eee44f221"
+  integrity sha512-wXKgU/lk8fKXMu/l5Hog1R61bL4q5GCdT6OJvdAFz1P+QrpoFuLU68eoKuVc4RbrTtNnTL5FByhWdLgOPSph+Q==
+  dependencies:
+    "@jest/test-result" "30.2.0"
+    graceful-fs "^4.2.11"
+    jest-haste-map "30.2.0"
+    slash "^3.0.0"
+
+"@jest/transform@30.2.0":
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/@jest/transform/-/transform-30.2.0.tgz#54bef1a4510dcbd58d5d4de4fe2980a63077ef2a"
+  integrity sha512-XsauDV82o5qXbhalKxD7p4TZYYdwcaEXC77PPD2HixEFF+6YGppjrAAQurTl2ECWcEomHBMMNS9AH3kcCFx8jA==
+  dependencies:
+    "@babel/core" "^7.27.4"
+    "@jest/types" "30.2.0"
+    "@jridgewell/trace-mapping" "^0.3.25"
+    babel-plugin-istanbul "^7.0.1"
+    chalk "^4.1.2"
+    convert-source-map "^2.0.0"
+    fast-json-stable-stringify "^2.1.0"
+    graceful-fs "^4.2.11"
+    jest-haste-map "30.2.0"
+    jest-regex-util "30.0.1"
+    jest-util "30.2.0"
+    micromatch "^4.0.8"
+    pirates "^4.0.7"
+    slash "^3.0.0"
+    write-file-atomic "^5.0.1"
+
+"@jest/types@30.2.0":
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/@jest/types/-/types-30.2.0.tgz#1c678a7924b8f59eafd4c77d56b6d0ba976d62b8"
+  integrity sha512-H9xg1/sfVvyfU7o3zMfBEjQ1gcsdeTMgqHoYdN79tuLqfTtuu7WckRA1R5whDwOzxaZAeMKTYWqP+WCAi0CHsg==
+  dependencies:
+    "@jest/pattern" "30.0.1"
+    "@jest/schemas" "30.0.5"
+    "@types/istanbul-lib-coverage" "^2.0.6"
+    "@types/istanbul-reports" "^3.0.4"
+    "@types/node" "*"
+    "@types/yargs" "^17.0.33"
+    chalk "^4.1.2"
+
 "@jimp/bmp@^0.16.1":
   version "0.16.1"
   resolved "https://registry.yarnpkg.com/@jimp/bmp/-/bmp-0.16.1.tgz#6e2da655b2ba22e721df0795423f34e92ef13768"
@@ -2605,6 +3059,14 @@
     "@jridgewell/sourcemap-codec" "^1.4.10"
     "@jridgewell/trace-mapping" "^0.3.9"
 
+"@jridgewell/gen-mapping@^0.3.12":
+  version "0.3.13"
+  resolved "https://registry.yarnpkg.com/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz#6342a19f44347518c93e43b1ac69deb3c4656a1f"
+  integrity sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==
+  dependencies:
+    "@jridgewell/sourcemap-codec" "^1.5.0"
+    "@jridgewell/trace-mapping" "^0.3.24"
+
 "@jridgewell/gen-mapping@^0.3.5":
   version "0.3.5"
   resolved "https://registry.yarnpkg.com/@jridgewell/gen-mapping/-/gen-mapping-0.3.5.tgz#dcce6aff74bdf6dad1a95802b69b04a2fcb1fb36"
@@ -2614,6 +3076,14 @@
     "@jridgewell/sourcemap-codec" "^1.4.10"
     "@jridgewell/trace-mapping" "^0.3.24"
 
+"@jridgewell/remapping@^2.3.5":
+  version "2.3.5"
+  resolved "https://registry.yarnpkg.com/@jridgewell/remapping/-/remapping-2.3.5.tgz#375c476d1972947851ba1e15ae8f123047445aa1"
+  integrity sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==
+  dependencies:
+    "@jridgewell/gen-mapping" "^0.3.5"
+    "@jridgewell/trace-mapping" "^0.3.24"
+
 "@jridgewell/resolve-uri@^3.0.3":
   version "3.1.0"
   resolved "https://registry.yarnpkg.com/@jridgewell/resolve-uri/-/resolve-uri-3.1.0.tgz#2203b118c157721addfe69d47b70465463066d78"
@@ -2660,6 +3130,19 @@
   resolved "https://registry.yarnpkg.com/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.0.tgz#3188bcb273a414b0d215fd22a58540b989b9409a"
   integrity sha512-gv3ZRaISU3fjPAgNsriBRqGWQL6quFx04YMPW/zD8XMLsU32mhCCbfbO6KZFLjvYpCZ8zyDEgqsgf+PwPaM7GQ==
 
+"@jridgewell/sourcemap-codec@^1.5.0":
+  version "1.5.5"
+  resolved "https://registry.yarnpkg.com/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz#6912b00d2c631c0d15ce1a7ab57cd657f2a8f8ba"
+  integrity sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==
+
+"@jridgewell/trace-mapping@^0.3.12", "@jridgewell/trace-mapping@^0.3.23", "@jridgewell/trace-mapping@^0.3.28":
+  version "0.3.31"
+  resolved "https://registry.yarnpkg.com/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz#db15d6781c931f3a251a3dac39501c98a6082fd0"
+  integrity sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==
+  dependencies:
+    "@jridgewell/resolve-uri" "^3.1.0"
+    "@jridgewell/sourcemap-codec" "^1.4.14"
+
 "@jridgewell/trace-mapping@^0.3.13", "@jridgewell/trace-mapping@^0.3.24", "@jridgewell/trace-mapping@^0.3.25":
   version "0.3.25"
   resolved "https://registry.yarnpkg.com/@jridgewell/trace-mapping/-/trace-mapping-0.3.25.tgz#15f190e98895f3fc23276ee14bc76b675c2e50f0"
@@ -2933,6 +3416,15 @@
     prop-types "^15.8.1"
     react-is "^18.2.0"
 
+"@napi-rs/wasm-runtime@^0.2.11":
+  version "0.2.12"
+  resolved "https://registry.yarnpkg.com/@napi-rs/wasm-runtime/-/wasm-runtime-0.2.12.tgz#3e78a8b96e6c33a6c517e1894efbd5385a7cb6f2"
+  integrity sha512-ZVWUcfwY4E/yPitQJl481FjFo3K22D6qF0DuFH6Y/nbnE11GY5uguDxZMGXPQ8WQ0128MXQD7TnfHyK4oWoIJQ==
+  dependencies:
+    "@emnapi/core" "^1.4.3"
+    "@emnapi/runtime" "^1.4.3"
+    "@tybys/wasm-util" "^0.10.0"
+
 "@nicolo-ribaudo/eslint-scope-5-internals@5.1.1-v1":
   version "5.1.1-v1"
   resolved "https://registry.yarnpkg.com/@nicolo-ribaudo/eslint-scope-5-internals/-/eslint-scope-5-internals-5.1.1-v1.tgz#dbf733a965ca47b1973177dc0bb6c889edcfb129"
@@ -3343,6 +3835,16 @@
     chrome-trace-event "^1.0.2"
     nullthrows "^1.1.1"
 
+"@pkgjs/parseargs@^0.11.0":
+  version "0.11.0"
+  resolved "https://registry.yarnpkg.com/@pkgjs/parseargs/-/parseargs-0.11.0.tgz#a77ea742fab25775145434eb1d2328cf5013ac33"
+  integrity sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==
+
+"@pkgr/core@^0.2.9":
+  version "0.2.9"
+  resolved "https://registry.yarnpkg.com/@pkgr/core/-/core-0.2.9.tgz#d229a7b7f9dac167a156992ef23c7f023653f53b"
+  integrity sha512-QNqXyfVS2wm9hweSYD2O7F0G06uurj9kZ96TRQE5Y9hU7+tgdZwIkbAKc5Ocy1HxEY2kuDQa6cQ1WRs/O5LFKA==
+
 "@pmmmwh/react-refresh-webpack-plugin@^0.5.7":
   version "0.5.15"
   resolved "https://registry.yarnpkg.com/@pmmmwh/react-refresh-webpack-plugin/-/react-refresh-webpack-plugin-0.5.15.tgz#f126be97c30b83ed777e2aeabd518bc592e6e7c4"
@@ -3562,6 +4064,11 @@
   resolved "https://registry.yarnpkg.com/@sideway/pinpoint/-/pinpoint-2.0.0.tgz#cff8ffadc372ad29fd3f78277aeb29e632cc70df"
   integrity sha512-RNiOoTPkptFtSVzQevY/yWtZwf/RxyVnPy/OcA9HBM3MlGDnBEYL5B41H0MTn0Uec8Hi+2qUtTfG2WWZBmMejQ==
 
+"@sinclair/typebox@^0.34.0":
+  version "0.34.47"
+  resolved "https://registry.yarnpkg.com/@sinclair/typebox/-/typebox-0.34.47.tgz#61b684d8a20d2890b9f1f7b0d4f76b4b39f5bc0d"
+  integrity sha512-ZGIBQ+XDvO5JQku9wmwtabcVTHJsgSWAHYtVuM9pBNNR5E88v6Jcj/llpmsjivig5X8A8HHOb4/mbEKPS5EvAw==
+
 "@sindresorhus/is@^0.14.0":
   version "0.14.0"
   resolved "https://registry.yarnpkg.com/@sindresorhus/is/-/is-0.14.0.tgz#9fb3a3cf3132328151f353de4632e01e52102bea"
@@ -3588,6 +4095,20 @@
     escape-string-regexp "^2.0.0"
     lodash.deburr "^4.1.0"
 
+"@sinonjs/commons@^3.0.1":
+  version "3.0.1"
+  resolved "https://registry.yarnpkg.com/@sinonjs/commons/-/commons-3.0.1.tgz#1029357e44ca901a615585f6d27738dbc89084cd"
+  integrity sha512-K3mCHKQ9sVh8o1C9cxkwxaOmXoAMlDxC1mYyHrjqOWEcBjYr76t96zL2zlj5dUGZ3HSw240X1qgH3Mjf1yJWpQ==
+  dependencies:
+    type-detect "4.0.8"
+
+"@sinonjs/fake-timers@^13.0.0":
+  version "13.0.5"
+  resolved "https://registry.yarnpkg.com/@sinonjs/fake-timers/-/fake-timers-13.0.5.tgz#36b9dbc21ad5546486ea9173d6bea063eb1717d5"
+  integrity sha512-36/hTbH2uaWuGVERyC6da9YwGWnzUZXuPro/F2LfsdOsLnCojz/iSH8MxUt/FD2S5XBSVPhmArFUXcpCQ2Hkiw==
+  dependencies:
+    "@sinonjs/commons" "^3.0.1"
+
 "@socket.io/component-emitter@~3.1.0":
   version "3.1.2"
   resolved "https://registry.yarnpkg.com/@socket.io/component-emitter/-/component-emitter-3.1.2.tgz#821f8442f4175d8f0467b9daf26e3a18e2d02af2"
@@ -3691,6 +4212,46 @@
   resolved "https://registry.yarnpkg.com/@turist/time/-/time-0.0.2.tgz#32fe0ce708ea0f4512776bd313409f1459976dda"
   integrity sha512-qLOvfmlG2vCVw5fo/oz8WAZYlpe5a5OurgTj3diIxJCdjRHpapC+vQCz3er9LV79Vcat+DifBjeAhOAdmndtDQ==
 
+"@tybys/wasm-util@^0.10.0":
+  version "0.10.1"
+  resolved "https://registry.yarnpkg.com/@tybys/wasm-util/-/wasm-util-0.10.1.tgz#ecddd3205cf1e2d5274649ff0eedd2991ed7f414"
+  integrity sha512-9tTaPJLSiejZKx+Bmog4uSubteqTvFrVrURwkmHixBo0G4seD0zUxp98E1DzUBJxLQ3NPwXrGKDiVjwx/DpPsg==
+  dependencies:
+    tslib "^2.4.0"
+
+"@types/babel__core@^7.20.5":
+  version "7.20.5"
+  resolved "https://registry.yarnpkg.com/@types/babel__core/-/babel__core-7.20.5.tgz#3df15f27ba85319caa07ba08d0721889bb39c017"
+  integrity sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==
+  dependencies:
+    "@babel/parser" "^7.20.7"
+    "@babel/types" "^7.20.7"
+    "@types/babel__generator" "*"
+    "@types/babel__template" "*"
+    "@types/babel__traverse" "*"
+
+"@types/babel__generator@*":
+  version "7.27.0"
+  resolved "https://registry.yarnpkg.com/@types/babel__generator/-/babel__generator-7.27.0.tgz#b5819294c51179957afaec341442f9341e4108a9"
+  integrity sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==
+  dependencies:
+    "@babel/types" "^7.0.0"
+
+"@types/babel__template@*":
+  version "7.4.4"
+  resolved "https://registry.yarnpkg.com/@types/babel__template/-/babel__template-7.4.4.tgz#5672513701c1b2199bc6dad636a9d7491586766f"
+  integrity sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==
+  dependencies:
+    "@babel/parser" "^7.1.0"
+    "@babel/types" "^7.0.0"
+
+"@types/babel__traverse@*":
+  version "7.28.0"
+  resolved "https://registry.yarnpkg.com/@types/babel__traverse/-/babel__traverse-7.28.0.tgz#07d713d6cce0d265c9849db0cbe62d3f61f36f74"
+  integrity sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==
+  dependencies:
+    "@babel/types" "^7.28.2"
+
 "@types/cacheable-request@^6.0.1":
   version "6.0.2"
   resolved "https://registry.yarnpkg.com/@types/cacheable-request/-/cacheable-request-6.0.2.tgz#c324da0197de0a98a2312156536ae262429ff6b9"
@@ -3818,6 +4379,33 @@
   dependencies:
     "@types/node" "*"
 
+"@types/istanbul-lib-coverage@*", "@types/istanbul-lib-coverage@^2.0.1", "@types/istanbul-lib-coverage@^2.0.6":
+  version "2.0.6"
+  resolved "https://registry.yarnpkg.com/@types/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.6.tgz#7739c232a1fee9b4d3ce8985f314c0c6d33549d7"
+  integrity sha512-2QF/t/auWm0lsy8XtKVPG19v3sSOQlJe/YHZgfjb/KBBHOGSV+J2q/S671rcq9uTBrLAXmZpqJiaQbMT+zNU1w==
+
+"@types/istanbul-lib-report@*":
+  version "3.0.3"
+  resolved "https://registry.yarnpkg.com/@types/istanbul-lib-report/-/istanbul-lib-report-3.0.3.tgz#53047614ae72e19fc0401d872de3ae2b4ce350bf"
+  integrity sha512-NQn7AHQnk/RSLOxrBbGyJM/aVQ+pjj5HCgasFxc0K/KhoATfQ/47AyUl15I2yBUpihjmas+a+VJBOqecrFH+uA==
+  dependencies:
+    "@types/istanbul-lib-coverage" "*"
+
+"@types/istanbul-reports@^3.0.4":
+  version "3.0.4"
+  resolved "https://registry.yarnpkg.com/@types/istanbul-reports/-/istanbul-reports-3.0.4.tgz#0f03e3d2f670fbdac586e34b433783070cc16f54"
+  integrity sha512-pk2B1NWalF9toCRu6gjBzR69syFjP4Od8WRAX+0mmf9lAjCRicLOWc+ZrxZHx/0XRjotgkF9t6iaMJ+aXcOdZQ==
+  dependencies:
+    "@types/istanbul-lib-report" "*"
+
+"@types/jest@^30.0.0":
+  version "30.0.0"
+  resolved "https://registry.yarnpkg.com/@types/jest/-/jest-30.0.0.tgz#5e85ae568006712e4ad66f25433e9bdac8801f1d"
+  integrity sha512-XTYugzhuwqWjws0CVz8QpM36+T+Dz5mTEBKhNs/esGLnCIlGdRy+Dq78NRjd7ls7r8BC8ZRMOrKlkO1hU0JOwA==
+  dependencies:
+    expect "^30.0.0"
+    pretty-format "^30.0.0"
+
 "@types/json-buffer@~3.0.0":
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/@types/json-buffer/-/json-buffer-3.0.0.tgz#85c1ff0f0948fc159810d4b5be35bf8c20875f64"
@@ -3916,16 +4504,18 @@
   resolved "https://registry.yarnpkg.com/@types/node/-/node-16.9.1.tgz#0611b37db4246c937feef529ddcc018cf8e35708"
   integrity sha512-QpLcX9ZSsq3YYUUnD3nFDY8H7wctAhQj/TFKL8Ya8v5fMm3CFXxo8zStsLAl780ltoYoo1WvKUVGBQK+1ifr7g==
 
-"@types/node@^17.0.21":
-  version "17.0.21"
-  resolved "https://registry.yarnpkg.com/@types/node/-/node-17.0.21.tgz#864b987c0c68d07b4345845c3e63b75edd143644"
-  integrity sha512-DBZCJbhII3r90XbQxI8Y9IjjiiOGlZ0Hr32omXIZvwwZ7p4DMMXGrKXVyPfuoBOri9XNtL0UK69jYIBIsRX3QQ==
-
 "@types/node@^17.0.5":
   version "17.0.45"
   resolved "https://registry.yarnpkg.com/@types/node/-/node-17.0.45.tgz#2c0fafd78705e7a18b7906b5201a522719dc5190"
   integrity sha512-w+tIMs3rq2afQdsPJlODhoUEKzFP1ayaoyl1CcnwtIlsVe7K7bA1NGm4s3PraqTLlXnbIN84zuBlxBWo1u9BLw==
 
+"@types/node@^25.0.7":
+  version "25.0.7"
+  resolved "https://registry.yarnpkg.com/@types/node/-/node-25.0.7.tgz#afd2f0d34358631a287c6726dabe0c845abc2bae"
+  integrity sha512-C/er7DlIZgRJO7WtTdYovjIFzGsz0I95UlMyR9anTb4aCpBSRWe5Jc1/RvLKUfzmOxHPGjSE5+63HgLtndxU4w==
+  dependencies:
+    undici-types "~7.16.0"
+
 "@types/node@^8.5.7":
   version "8.10.66"
   resolved "https://registry.yarnpkg.com/@types/node/-/node-8.10.66.tgz#dd035d409df322acc83dff62a602f12a5783bbb3"
@@ -4049,6 +4639,11 @@
   dependencies:
     "@types/node" "*"
 
+"@types/stack-utils@^2.0.3":
+  version "2.0.3"
+  resolved "https://registry.yarnpkg.com/@types/stack-utils/-/stack-utils-2.0.3.tgz#6209321eb2c1712a7e7466422b8cb1fc0d9dd5d8"
+  integrity sha512-9aEbYZ3TbYMznPdcdr3SmIrLXwC/AKZXQeCf9Pgao5CKb8CyHuEX5jzWPTkvregvhRJHcpRO6BFoGW9ycaOkYw==
+
 "@types/tmp@^0.0.33":
   version "0.0.33"
   resolved "https://registry.yarnpkg.com/@types/tmp/-/tmp-0.0.33.tgz#1073c4bc824754ae3d10cfab88ab0237ba964e4d"
@@ -4075,6 +4670,18 @@
     "@types/unist" "*"
     "@types/vfile-message" "*"
 
+"@types/yargs-parser@*":
+  version "21.0.3"
+  resolved "https://registry.yarnpkg.com/@types/yargs-parser/-/yargs-parser-21.0.3.tgz#815e30b786d2e8f0dcd85fd5bcf5e1a04d008f15"
+  integrity sha512-I4q9QU9MQv4oEOz4tAHJtNz1cwuLxn2F3xcc2iV5WdqLPpUnj30aUuxt1mAxYTG+oe8CZMV/+6rU4S4gRDzqtQ==
+
+"@types/yargs@^17.0.33":
+  version "17.0.35"
+  resolved "https://registry.yarnpkg.com/@types/yargs/-/yargs-17.0.35.tgz#07013e46aa4d7d7d50a49e15604c1c5340d4eb24"
+  integrity sha512-qUHkeCyQFxMXg79wQfTtfndEC+N9ZZg76HJftDJp+qH2tV7Gj4OJi7l+PiWwJ+pWtW8GwSmqsDj/oymhrTWXjg==
+  dependencies:
+    "@types/yargs-parser" "*"
+
 "@types/yoga-layout@1.9.2":
   version "1.9.2"
   resolved "https://registry.yarnpkg.com/@types/yoga-layout/-/yoga-layout-1.9.2.tgz#efaf9e991a7390dc081a0b679185979a83a9639a"
@@ -4150,6 +4757,108 @@
     "@typescript-eslint/types" "4.33.0"
     eslint-visitor-keys "^2.0.0"
 
+"@ungap/structured-clone@^1.3.0":
+  version "1.3.0"
+  resolved "https://registry.yarnpkg.com/@ungap/structured-clone/-/structured-clone-1.3.0.tgz#d06bbb384ebcf6c505fde1c3d0ed4ddffe0aaff8"
+  integrity sha512-WmoN8qaIAo7WTYWbAZuG8PYEhn5fkz7dZrqTBZ7dtt//lL2Gwms1IcnQ5yHqjDfX8Ft5j4YzDM23f87zBfDe9g==
+
+"@unrs/resolver-binding-android-arm-eabi@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-android-arm-eabi/-/resolver-binding-android-arm-eabi-1.11.1.tgz#9f5b04503088e6a354295e8ea8fe3cb99e43af81"
+  integrity sha512-ppLRUgHVaGRWUx0R0Ut06Mjo9gBaBkg3v/8AxusGLhsIotbBLuRk51rAzqLC8gq6NyyAojEXglNjzf6R948DNw==
+
+"@unrs/resolver-binding-android-arm64@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-android-arm64/-/resolver-binding-android-arm64-1.11.1.tgz#7414885431bd7178b989aedc4d25cccb3865bc9f"
+  integrity sha512-lCxkVtb4wp1v+EoN+HjIG9cIIzPkX5OtM03pQYkG+U5O/wL53LC4QbIeazgiKqluGeVEeBlZahHalCaBvU1a2g==
+
+"@unrs/resolver-binding-darwin-arm64@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-darwin-arm64/-/resolver-binding-darwin-arm64-1.11.1.tgz#b4a8556f42171fb9c9f7bac8235045e82aa0cbdf"
+  integrity sha512-gPVA1UjRu1Y/IsB/dQEsp2V1pm44Of6+LWvbLc9SDk1c2KhhDRDBUkQCYVWe6f26uJb3fOK8saWMgtX8IrMk3g==
+
+"@unrs/resolver-binding-darwin-x64@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-darwin-x64/-/resolver-binding-darwin-x64-1.11.1.tgz#fd4d81257b13f4d1a083890a6a17c00de571f0dc"
+  integrity sha512-cFzP7rWKd3lZaCsDze07QX1SC24lO8mPty9vdP+YVa3MGdVgPmFc59317b2ioXtgCMKGiCLxJ4HQs62oz6GfRQ==
+
+"@unrs/resolver-binding-freebsd-x64@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-freebsd-x64/-/resolver-binding-freebsd-x64-1.11.1.tgz#d2513084d0f37c407757e22f32bd924a78cfd99b"
+  integrity sha512-fqtGgak3zX4DCB6PFpsH5+Kmt/8CIi4Bry4rb1ho6Av2QHTREM+47y282Uqiu3ZRF5IQioJQ5qWRV6jduA+iGw==
+
+"@unrs/resolver-binding-linux-arm-gnueabihf@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-linux-arm-gnueabihf/-/resolver-binding-linux-arm-gnueabihf-1.11.1.tgz#844d2605d057488d77fab09705f2866b86164e0a"
+  integrity sha512-u92mvlcYtp9MRKmP+ZvMmtPN34+/3lMHlyMj7wXJDeXxuM0Vgzz0+PPJNsro1m3IZPYChIkn944wW8TYgGKFHw==
+
+"@unrs/resolver-binding-linux-arm-musleabihf@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-linux-arm-musleabihf/-/resolver-binding-linux-arm-musleabihf-1.11.1.tgz#204892995cefb6bd1d017d52d097193bc61ddad3"
+  integrity sha512-cINaoY2z7LVCrfHkIcmvj7osTOtm6VVT16b5oQdS4beibX2SYBwgYLmqhBjA1t51CarSaBuX5YNsWLjsqfW5Cw==
+
+"@unrs/resolver-binding-linux-arm64-gnu@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-linux-arm64-gnu/-/resolver-binding-linux-arm64-gnu-1.11.1.tgz#023eb0c3aac46066a10be7a3f362e7b34f3bdf9d"
+  integrity sha512-34gw7PjDGB9JgePJEmhEqBhWvCiiWCuXsL9hYphDF7crW7UgI05gyBAi6MF58uGcMOiOqSJ2ybEeCvHcq0BCmQ==
+
+"@unrs/resolver-binding-linux-arm64-musl@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-linux-arm64-musl/-/resolver-binding-linux-arm64-musl-1.11.1.tgz#9e6f9abb06424e3140a60ac996139786f5d99be0"
+  integrity sha512-RyMIx6Uf53hhOtJDIamSbTskA99sPHS96wxVE/bJtePJJtpdKGXO1wY90oRdXuYOGOTuqjT8ACccMc4K6QmT3w==
+
+"@unrs/resolver-binding-linux-ppc64-gnu@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-linux-ppc64-gnu/-/resolver-binding-linux-ppc64-gnu-1.11.1.tgz#b111417f17c9d1b02efbec8e08398f0c5527bb44"
+  integrity sha512-D8Vae74A4/a+mZH0FbOkFJL9DSK2R6TFPC9M+jCWYia/q2einCubX10pecpDiTmkJVUH+y8K3BZClycD8nCShA==
+
+"@unrs/resolver-binding-linux-riscv64-gnu@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-linux-riscv64-gnu/-/resolver-binding-linux-riscv64-gnu-1.11.1.tgz#92ffbf02748af3e99873945c9a8a5ead01d508a9"
+  integrity sha512-frxL4OrzOWVVsOc96+V3aqTIQl1O2TjgExV4EKgRY09AJ9leZpEg8Ak9phadbuX0BA4k8U5qtvMSQQGGmaJqcQ==
+
+"@unrs/resolver-binding-linux-riscv64-musl@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-linux-riscv64-musl/-/resolver-binding-linux-riscv64-musl-1.11.1.tgz#0bec6f1258fc390e6b305e9ff44256cb207de165"
+  integrity sha512-mJ5vuDaIZ+l/acv01sHoXfpnyrNKOk/3aDoEdLO/Xtn9HuZlDD6jKxHlkN8ZhWyLJsRBxfv9GYM2utQ1SChKew==
+
+"@unrs/resolver-binding-linux-s390x-gnu@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-linux-s390x-gnu/-/resolver-binding-linux-s390x-gnu-1.11.1.tgz#577843a084c5952f5906770633ccfb89dac9bc94"
+  integrity sha512-kELo8ebBVtb9sA7rMe1Cph4QHreByhaZ2QEADd9NzIQsYNQpt9UkM9iqr2lhGr5afh885d/cB5QeTXSbZHTYPg==
+
+"@unrs/resolver-binding-linux-x64-gnu@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-linux-x64-gnu/-/resolver-binding-linux-x64-gnu-1.11.1.tgz#36fb318eebdd690f6da32ac5e0499a76fa881935"
+  integrity sha512-C3ZAHugKgovV5YvAMsxhq0gtXuwESUKc5MhEtjBpLoHPLYM+iuwSj3lflFwK3DPm68660rZ7G8BMcwSro7hD5w==
+
+"@unrs/resolver-binding-linux-x64-musl@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-linux-x64-musl/-/resolver-binding-linux-x64-musl-1.11.1.tgz#bfb9af75f783f98f6a22c4244214efe4df1853d6"
+  integrity sha512-rV0YSoyhK2nZ4vEswT/QwqzqQXw5I6CjoaYMOX0TqBlWhojUf8P94mvI7nuJTeaCkkds3QE4+zS8Ko+GdXuZtA==
+
+"@unrs/resolver-binding-wasm32-wasi@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-wasm32-wasi/-/resolver-binding-wasm32-wasi-1.11.1.tgz#752c359dd875684b27429500d88226d7cc72f71d"
+  integrity sha512-5u4RkfxJm+Ng7IWgkzi3qrFOvLvQYnPBmjmZQ8+szTK/b31fQCnleNl1GgEt7nIsZRIf5PLhPwT0WM+q45x/UQ==
+  dependencies:
+    "@napi-rs/wasm-runtime" "^0.2.11"
+
+"@unrs/resolver-binding-win32-arm64-msvc@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-win32-arm64-msvc/-/resolver-binding-win32-arm64-msvc-1.11.1.tgz#ce5735e600e4c2fbb409cd051b3b7da4a399af35"
+  integrity sha512-nRcz5Il4ln0kMhfL8S3hLkxI85BXs3o8EYoattsJNdsX4YUU89iOkVn7g0VHSRxFuVMdM4Q1jEpIId1Ihim/Uw==
+
+"@unrs/resolver-binding-win32-ia32-msvc@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-win32-ia32-msvc/-/resolver-binding-win32-ia32-msvc-1.11.1.tgz#72fc57bc7c64ec5c3de0d64ee0d1810317bc60a6"
+  integrity sha512-DCEI6t5i1NmAZp6pFonpD5m7i6aFrpofcp4LA2i8IIq60Jyo28hamKBxNrZcyOwVOZkgsRp9O2sXWBWP8MnvIQ==
+
+"@unrs/resolver-binding-win32-x64-msvc@1.11.1":
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/@unrs/resolver-binding-win32-x64-msvc/-/resolver-binding-win32-x64-msvc-1.11.1.tgz#538b1e103bf8d9864e7b85cc96fa8d6fb6c40777"
+  integrity sha512-lrW200hZdbfRtztbygyaq/6jP6AKE8qQN2KvPcJ+x7wiD038YtnYtZ82IMNJ69GJibV7bwL3y9FgK+5w/pYt6g==
+
 "@vercel/webpack-asset-relocator-loader@1.7.3":
   version "1.7.3"
   resolved "https://registry.yarnpkg.com/@vercel/webpack-asset-relocator-loader/-/webpack-asset-relocator-loader-1.7.3.tgz#e65ca1fd9feb045039788f9b4710e5acc84b01b0"
@@ -4486,7 +5195,7 @@ ansi-escapes@^3.1.0:
   resolved "https://registry.yarnpkg.com/ansi-escapes/-/ansi-escapes-3.2.0.tgz#8780b98ff9dbf5638152d1f1fe5c1d7b4442976b"
   integrity sha512-cBhpre4ma+U0T1oM5fXg7Dy1Jw7zzwv7lt/GoCpr+hDQJoYnKVPLL4dCvSEFMmQurOQvSrwT7SL/DAlhBI97RQ==
 
-ansi-escapes@^4.2.1, ansi-escapes@^4.3.0:
+ansi-escapes@^4.2.1, ansi-escapes@^4.3.0, ansi-escapes@^4.3.2:
   version "4.3.2"
   resolved "https://registry.yarnpkg.com/ansi-escapes/-/ansi-escapes-4.3.2.tgz#6b2291d1db7d98b6521d5f1efa42d0f3a9feb65e"
   integrity sha512-gKXj5ALrKWQLsYG9jlTRmR/xKluxHV+Z9QEwNIgCfM1/uwPMCuzVVnh5mwTd+OuBZcwSIMbqssNWRm1lE51QaQ==
@@ -4537,16 +5246,34 @@ ansi-styles@^4.0.0, ansi-styles@^4.1.0:
   dependencies:
     color-convert "^2.0.1"
 
+ansi-styles@^5.2.0:
+  version "5.2.0"
+  resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-5.2.0.tgz#07449690ad45777d1924ac2abb2fc8895dba836b"
+  integrity sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==
+
 ansi-styles@^6.0.0:
   version "6.1.0"
   resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-6.1.0.tgz#87313c102b8118abd57371afab34618bf7350ed3"
   integrity sha512-VbqNsoz55SYGczauuup0MFUyXNQviSpFTj1RQtFzmQLk18qbVSpTFFGMT293rmDaQuKCT6InmbuEyUne4mTuxQ==
 
+ansi-styles@^6.1.0:
+  version "6.2.3"
+  resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-6.2.3.tgz#c044d5dcc521a076413472597a1acb1f103c4041"
+  integrity sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==
+
 any-base@^1.1.0:
   version "1.1.0"
   resolved "https://registry.yarnpkg.com/any-base/-/any-base-1.1.0.tgz#ae101a62bc08a597b4c9ab5b7089d456630549fe"
   integrity sha512-uMgjozySS8adZZYePpaWs8cxB9/kdzmpX6SgJZ+wbz1K5eYk5QMYDVJaZKhxyIHUdnnJkfR7SVgStgH7LkGUyg==
 
+anymatch@^3.1.3:
+  version "3.1.3"
+  resolved "https://registry.yarnpkg.com/anymatch/-/anymatch-3.1.3.tgz#790c58b19ba1720a84205b57c618d5ad8524973e"
+  integrity sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==
+  dependencies:
+    normalize-path "^3.0.0"
+    picomatch "^2.0.4"
+
 anymatch@~3.1.2:
   version "3.1.2"
   resolved "https://registry.yarnpkg.com/anymatch/-/anymatch-3.1.2.tgz#c0557c096af32f106198f4f4e2a383537e378716"
@@ -4859,6 +5586,19 @@ axobject-query@^4.1.0:
   resolved "https://registry.yarnpkg.com/axobject-query/-/axobject-query-4.1.0.tgz#28768c76d0e3cff21bc62a9e2d0b6ac30042a1ee"
   integrity sha512-qIj0G9wZbMGNLjLmg1PT6v2mE9AH2zlnADJD/2tC6E00hgmhUOfEB6greHPAfLRSufHqROIUTkw6E+M3lH0PTQ==
 
+babel-jest@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/babel-jest/-/babel-jest-30.2.0.tgz#fd44a1ec9552be35ead881f7381faa7d8f3b95ac"
+  integrity sha512-0YiBEOxWqKkSQWL9nNGGEgndoeL0ZpWrbLMNL5u/Kaxrli3Eaxlt3ZtIDktEvXt4L/R9r3ODr2zKwGM/2BjxVw==
+  dependencies:
+    "@jest/transform" "30.2.0"
+    "@types/babel__core" "^7.20.5"
+    babel-plugin-istanbul "^7.0.1"
+    babel-preset-jest "30.2.0"
+    chalk "^4.1.2"
+    graceful-fs "^4.2.11"
+    slash "^3.0.0"
+
 babel-loader@^8.2.3:
   version "8.4.1"
   resolved "https://registry.yarnpkg.com/babel-loader/-/babel-loader-8.4.1.tgz#6ccb75c66e62c3b144e1c5f2eaec5b8f6c08c675"
@@ -4896,6 +5636,24 @@ babel-plugin-extract-import-names@1.6.22:
   dependencies:
     "@babel/helper-plugin-utils" "7.10.4"
 
+babel-plugin-istanbul@^7.0.1:
+  version "7.0.1"
+  resolved "https://registry.yarnpkg.com/babel-plugin-istanbul/-/babel-plugin-istanbul-7.0.1.tgz#d8b518c8ea199364cf84ccc82de89740236daf92"
+  integrity sha512-D8Z6Qm8jCvVXtIRkBnqNHX0zJ37rQcFJ9u8WOS6tkYOsRdHBzypCstaxWiu5ZIlqQtviRYbgnRLSoCEvjqcqbA==
+  dependencies:
+    "@babel/helper-plugin-utils" "^7.0.0"
+    "@istanbuljs/load-nyc-config" "^1.0.0"
+    "@istanbuljs/schema" "^0.1.3"
+    istanbul-lib-instrument "^6.0.2"
+    test-exclude "^6.0.0"
+
+babel-plugin-jest-hoist@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/babel-plugin-jest-hoist/-/babel-plugin-jest-hoist-30.2.0.tgz#94c250d36b43f95900f3a219241e0f4648191ce2"
+  integrity sha512-ftzhzSGMUnOzcCXd6WHdBGMyuwy15Wnn0iyyWGKgBDLxf9/s5ABuraCSpBX2uG0jUg4rqJnxsLc5+oYBqoxVaA==
+  dependencies:
+    "@types/babel__core" "^7.20.5"
+
 babel-plugin-lodash@^3.3.4:
   version "3.3.4"
   resolved "https://registry.yarnpkg.com/babel-plugin-lodash/-/babel-plugin-lodash-3.3.4.tgz#4f6844358a1340baed182adbeffa8df9967bc196"
@@ -4988,6 +5746,27 @@ babel-plugin-transform-react-remove-prop-types@^0.4.24:
   resolved "https://registry.yarnpkg.com/babel-plugin-transform-react-remove-prop-types/-/babel-plugin-transform-react-remove-prop-types-0.4.24.tgz#f2edaf9b4c6a5fbe5c1d678bfb531078c1555f3a"
   integrity sha512-eqj0hVcJUR57/Ug2zE1Yswsw4LhuqqHhD+8v120T1cl3kjg76QwtyBrdIk4WVwK+lAhBJVYCd/v+4nc4y+8JsA==
 
+babel-preset-current-node-syntax@^1.2.0:
+  version "1.2.0"
+  resolved "https://registry.yarnpkg.com/babel-preset-current-node-syntax/-/babel-preset-current-node-syntax-1.2.0.tgz#20730d6cdc7dda5d89401cab10ac6a32067acde6"
+  integrity sha512-E/VlAEzRrsLEb2+dv8yp3bo4scof3l9nR4lrld+Iy5NyVqgVYUJnDAmunkhPMisRI32Qc4iRiz425d8vM++2fg==
+  dependencies:
+    "@babel/plugin-syntax-async-generators" "^7.8.4"
+    "@babel/plugin-syntax-bigint" "^7.8.3"
+    "@babel/plugin-syntax-class-properties" "^7.12.13"
+    "@babel/plugin-syntax-class-static-block" "^7.14.5"
+    "@babel/plugin-syntax-import-attributes" "^7.24.7"
+    "@babel/plugin-syntax-import-meta" "^7.10.4"
+    "@babel/plugin-syntax-json-strings" "^7.8.3"
+    "@babel/plugin-syntax-logical-assignment-operators" "^7.10.4"
+    "@babel/plugin-syntax-nullish-coalescing-operator" "^7.8.3"
+    "@babel/plugin-syntax-numeric-separator" "^7.10.4"
+    "@babel/plugin-syntax-object-rest-spread" "^7.8.3"
+    "@babel/plugin-syntax-optional-catch-binding" "^7.8.3"
+    "@babel/plugin-syntax-optional-chaining" "^7.8.3"
+    "@babel/plugin-syntax-private-property-in-object" "^7.14.5"
+    "@babel/plugin-syntax-top-level-await" "^7.14.5"
+
 babel-preset-fbjs@^3.4.0:
   version "3.4.0"
   resolved "https://registry.yarnpkg.com/babel-preset-fbjs/-/babel-preset-fbjs-3.4.0.tgz#38a14e5a7a3b285a3f3a86552d650dca5cf6111c"
@@ -5042,6 +5821,14 @@ babel-preset-gatsby@^2.25.0:
     gatsby-core-utils "^3.25.0"
     gatsby-legacy-polyfills "^2.25.0"
 
+babel-preset-jest@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/babel-preset-jest/-/babel-preset-jest-30.2.0.tgz#04717843e561347781d6d7f69c81e6bcc3ed11ce"
+  integrity sha512-US4Z3NOieAQumwFnYdUWKvUKh8+YSnS/gB3t6YBiz0bskpu7Pine8pPCheNxlPEW4wnUkma2a94YuW2q3guvCQ==
+  dependencies:
+    babel-plugin-jest-hoist "30.2.0"
+    babel-preset-current-node-syntax "^1.2.0"
+
 babel-runtime@6.26.0, babel-runtime@^6.26.0:
   version "6.26.0"
   resolved "https://registry.yarnpkg.com/babel-runtime/-/babel-runtime-6.26.0.tgz#965c7058668e82b55d7bfe04ff2337bc8b5647fe"
@@ -5248,6 +6035,13 @@ browserslist@^4.24.0:
     node-releases "^2.0.18"
     update-browserslist-db "^1.1.1"
 
+bs-logger@^0.2.6:
+  version "0.2.6"
+  resolved "https://registry.yarnpkg.com/bs-logger/-/bs-logger-0.2.6.tgz#eb7d365307a72cf974cc6cda76b68354ad336bd8"
+  integrity sha512-pd8DCoxmbgc7hyPKOvxtqNcjYoOsABPQdcCUjGp3d42VR2CX1ORhk2A87oqqu5R1kk+76nsxZupkmyd+MVtCog==
+  dependencies:
+    fast-json-stable-stringify "2.x"
+
 bser@2.1.1:
   version "2.1.1"
   resolved "https://registry.yarnpkg.com/bser/-/bser-2.1.1.tgz#e6787da20ece9d07998533cfd9de6f5c38f4bc05"
@@ -5379,7 +6173,7 @@ call-me-maybe@^1.0.1:
   resolved "https://registry.yarnpkg.com/call-me-maybe/-/call-me-maybe-1.0.1.tgz#26d208ea89e37b5cbde60250a15f031c16a4d66b"
   integrity sha1-JtII6onje1y95gJQoV8DHBak1ms=
 
-callsites@^3.0.0:
+callsites@^3.0.0, callsites@^3.1.0:
   version "3.1.0"
   resolved "https://registry.yarnpkg.com/callsites/-/callsites-3.1.0.tgz#b3630abd8943432f54b3f0519238e33cd7df2f73"
   integrity sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==
@@ -5419,7 +6213,7 @@ camelcase@5.3.1, camelcase@^5.0.0, camelcase@^5.3.1:
   resolved "https://registry.yarnpkg.com/camelcase/-/camelcase-5.3.1.tgz#e3c9b31569e106811df242f715725a1f4c494320"
   integrity sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==
 
-camelcase@^6.2.0:
+camelcase@^6.2.0, camelcase@^6.3.0:
   version "6.3.0"
   resolved "https://registry.yarnpkg.com/camelcase/-/camelcase-6.3.0.tgz#5685b95eb209ac9c0c177467778c9c84df58ba9a"
   integrity sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==
@@ -5562,6 +6356,11 @@ change-case@^4.1.2:
     snake-case "^3.0.4"
     tslib "^2.0.3"
 
+char-regex@^1.0.2:
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/char-regex/-/char-regex-1.0.2.tgz#d744358226217f981ed58f479b1d6bcc29545dcf"
+  integrity sha512-kWWXztvZ5SBQV+eRgKFeh8q5sLuZY2+8WUIzlxWVTg+oGwY14qylx1KbKzHd8P6ZYkAg0xyIDU9JMHhyJMZ1jw==
+
 char-width-table-consumer@^1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/char-width-table-consumer/-/char-width-table-consumer-1.0.0.tgz#bb44ccd1ba3ed4fcdb062e22876721858a7697a8"
@@ -5656,6 +6455,16 @@ ci-info@^3.7.0:
   resolved "https://registry.yarnpkg.com/ci-info/-/ci-info-3.9.0.tgz#4279a62028a7b1f262f3473fc9605f5e218c59b4"
   integrity sha512-NIxF55hv4nSqQswkAeiOi1r83xy8JldOFDTWiug55KBu9Jnblncd2U6ViHmYgHf01TPZS77NJBhBMKdWj9HQMQ==
 
+ci-info@^4.2.0:
+  version "4.3.1"
+  resolved "https://registry.yarnpkg.com/ci-info/-/ci-info-4.3.1.tgz#355ad571920810b5623e11d40232f443f16f1daa"
+  integrity sha512-Wdy2Igu8OcBpI2pZePZ5oWjPC38tmDVx5WKUXKwlLYkA0ozo85sLsLvkBbBn/sZaSCMFOGZJ14fvW9t5/d7kdA==
+
+cjs-module-lexer@^2.1.0:
+  version "2.2.0"
+  resolved "https://registry.yarnpkg.com/cjs-module-lexer/-/cjs-module-lexer-2.2.0.tgz#b3ca5101843389259ade7d88c77bd06ce55849ca"
+  integrity sha512-4bHTS2YuzUvtoLjdy+98ykbNB5jS0+07EvFNXerqZQJ89F7DI6ET7OQo/HJuW6K0aVsKA9hj9/RVb2kQVOrPDQ==
+
 classnames@^2.2.6:
   version "2.3.1"
   resolved "https://registry.yarnpkg.com/classnames/-/classnames-2.3.1.tgz#dfcfa3891e306ec1dad105d0e88f4417b8535e8e"
@@ -5726,6 +6535,15 @@ cliui@^7.0.2:
     strip-ansi "^6.0.0"
     wrap-ansi "^7.0.0"
 
+cliui@^8.0.1:
+  version "8.0.1"
+  resolved "https://registry.yarnpkg.com/cliui/-/cliui-8.0.1.tgz#0c04b075db02cbfe60dc8e6cf2f5486b1a3608aa"
+  integrity sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==
+  dependencies:
+    string-width "^4.2.0"
+    strip-ansi "^6.0.1"
+    wrap-ansi "^7.0.0"
+
 clone-deep@^4.0.1:
   version "4.0.1"
   resolved "https://registry.yarnpkg.com/clone-deep/-/clone-deep-4.0.1.tgz#c19fd9bdbbf85942b4fd979c84dcf7d5f07c2387"
@@ -5757,6 +6575,11 @@ clsx@^1.2.1:
   resolved "https://registry.yarnpkg.com/clsx/-/clsx-1.2.1.tgz#0ddc4a20a549b59c93a4116bb26f5294ca17dc12"
   integrity sha512-EcR6r5a8bj6pu3ycsa/E/cKVGuTgZJZdsyUYHOksG/UHIiKfjxzRxYJpyVBwYaQeOvghal9fcc4PidlgzugAQg==
 
+co@^4.6.0:
+  version "4.6.0"
+  resolved "https://registry.yarnpkg.com/co/-/co-4.6.0.tgz#6ea6bdf3d853ae54ccb8e47bfa0bf3f9031fb184"
+  integrity sha512-QVb0dM5HvG+uaxitm8wONl7jltx8dqhfU33DcqtOZcLSVIKSDDLDi7+0LbAKiyI8hD9u42m2YxXSkMGWThaecQ==
+
 coa@^2.0.2:
   version "2.0.2"
   resolved "https://registry.yarnpkg.com/coa/-/coa-2.0.2.tgz#43f6c21151b4ef2bf57187db0d73de229e3e7ec3"
@@ -5776,6 +6599,11 @@ collapse-white-space@^1.0.2:
   resolved "https://registry.yarnpkg.com/collapse-white-space/-/collapse-white-space-1.0.6.tgz#e63629c0016665792060dbbeb79c42239d2c5287"
   integrity sha512-jEovNnrhMuqyCcjfEJA56v0Xq8SkIoPKDyaHahwo3POf4qcSXqMYuwNcOTzp74vTsR9Tn08z4MxWqAhcekogkQ==
 
+collect-v8-coverage@^1.0.2:
+  version "1.0.3"
+  resolved "https://registry.yarnpkg.com/collect-v8-coverage/-/collect-v8-coverage-1.0.3.tgz#cc1f01eb8d02298cbc9a437c74c70ab4e5210b80"
+  integrity sha512-1L5aqIkwPfiodaMgQunkF1zRhNqifHBmtbbbxcr6yVxxBnliw4TDOW6NxpO8DJLgJ16OT+Y4ztZqP6p/FtXnAw==
+
 color-convert@^1.9.0:
   version "1.9.3"
   resolved "https://registry.yarnpkg.com/color-convert/-/color-convert-1.9.3.tgz#bb71850690e1f136567de629d2d5471deda4c1e8"
@@ -6149,10 +6977,19 @@ cross-spawn@^6.0.5:
     shebang-command "^1.2.0"
     which "^1.2.9"
 
-cross-spawn@^7.0.2, cross-spawn@^7.0.3:
-  version "7.0.3"
-  resolved "https://registry.yarnpkg.com/cross-spawn/-/cross-spawn-7.0.3.tgz#f73a85b9d5d41d045551c177e2882d4ac85728a6"
-  integrity sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==
+cross-spawn@^7.0.2, cross-spawn@^7.0.3:
+  version "7.0.3"
+  resolved "https://registry.yarnpkg.com/cross-spawn/-/cross-spawn-7.0.3.tgz#f73a85b9d5d41d045551c177e2882d4ac85728a6"
+  integrity sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==
+  dependencies:
+    path-key "^3.1.0"
+    shebang-command "^2.0.0"
+    which "^2.0.1"
+
+cross-spawn@^7.0.6:
+  version "7.0.6"
+  resolved "https://registry.yarnpkg.com/cross-spawn/-/cross-spawn-7.0.6.tgz#8a58fe78f00dcd70c370451759dfbfaf03e8ee9f"
+  integrity sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==
   dependencies:
     path-key "^3.1.0"
     shebang-command "^2.0.0"
@@ -6493,6 +7330,11 @@ decompress-response@^6.0.0:
   dependencies:
     mimic-response "^3.1.0"
 
+dedent@^1.6.0:
+  version "1.7.1"
+  resolved "https://registry.yarnpkg.com/dedent/-/dedent-1.7.1.tgz#364661eea3d73f3faba7089214420ec2f8f13e15"
+  integrity sha512-9JmrhGZpOlEgOLdQgSm0zxFaYoQon408V1v49aqTWuXENVlnCuY9JBZcXZiCsZQWDjTm5Qf/nIvAy77mXDAjEg==
+
 deep-extend@^0.6.0:
   version "0.6.0"
   resolved "https://registry.yarnpkg.com/deep-extend/-/deep-extend-0.6.0.tgz#c4fa7c95404a17a9c3e8ca7e1537312b736330ac"
@@ -6508,6 +7350,11 @@ deepmerge@^4.2.2:
   resolved "https://registry.yarnpkg.com/deepmerge/-/deepmerge-4.2.2.tgz#44d2ea3679b8f4d4ffba33f03d865fc1e7bf4955"
   integrity sha512-FJ3UgI4gIl+PHZm53knsuSFpE+nESMr7M4v9QcgB7S63Kj/6WqMiFQJpBBYz1Pt+66bZpP3Q7Lye0Oo9MPKEdg==
 
+deepmerge@^4.3.1:
+  version "4.3.1"
+  resolved "https://registry.yarnpkg.com/deepmerge/-/deepmerge-4.3.1.tgz#44b5f2147cd3b00d4b56137685966f26fd25dd4a"
+  integrity sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==
+
 defer-to-connect@^1.0.1:
   version "1.1.3"
   resolved "https://registry.yarnpkg.com/defer-to-connect/-/defer-to-connect-1.1.3.tgz#331ae050c08dcf789f8c83a7b81f0ed94f4ac591"
@@ -6591,6 +7438,11 @@ detect-libc@^2.0.0, detect-libc@^2.0.1:
   resolved "https://registry.yarnpkg.com/detect-libc/-/detect-libc-2.0.1.tgz#e1897aa88fa6ad197862937fbc0441ef352ee0cd"
   integrity sha512-463v3ZeIrcWtdgIg6vI6XUncguvr2TnGl4SzDXinkt9mSLpBJKXT3mW6xT3VQdDN11+WVs29pgvivTc4Lp8v+w==
 
+detect-newline@^3.1.0:
+  version "3.1.0"
+  resolved "https://registry.yarnpkg.com/detect-newline/-/detect-newline-3.1.0.tgz#576f5dfc63ae1a192ff192d8ad3af6308991b651"
+  integrity sha512-TLz+x/vEXm/Y7P7wn1EJFNLxYpUD4TgMosxY6fAVJUnJMbupHBOncxyWUG9OpTaH9EBD7uFI5LfEgmMOc54DsA==
+
 detect-port-alt@^1.1.6:
   version "1.1.6"
   resolved "https://registry.yarnpkg.com/detect-port-alt/-/detect-port-alt-1.1.6.tgz#24707deabe932d4a3cf621302027c2b266568275"
@@ -6854,6 +7706,11 @@ electron-to-chromium@^1.5.73:
   resolved "https://registry.yarnpkg.com/electron-to-chromium/-/electron-to-chromium-1.5.96.tgz#afa3bf1608c897a7c7e33f22d4be1596dd5a4f3e"
   integrity sha512-8AJUW6dh75Fm/ny8+kZKJzI1pgoE8bKLZlzDU2W1ENd+DXKJrx7I7l9hb8UWR4ojlnb5OlixMt00QWiYJoVw1w==
 
+emittery@^0.13.1:
+  version "0.13.1"
+  resolved "https://registry.yarnpkg.com/emittery/-/emittery-0.13.1.tgz#c04b8c3457490e0847ae51fced3af52d338e3dad"
+  integrity sha512-DeWwawk6r5yR9jFgnDKYt4sLS0LmHJJi3ZOnb5/JdbYwj3nW+FxQnHIjhBKz8YLC7oRNPVM9NQ47I3CVx34eqQ==
+
 emoji-regex@^8.0.0:
   version "8.0.0"
   resolved "https://registry.yarnpkg.com/emoji-regex/-/emoji-regex-8.0.0.tgz#e818fd69ce5ccfcb404594f842963bf53164cc37"
@@ -7531,11 +8388,28 @@ exif-parser@^0.1.12:
   resolved "https://registry.yarnpkg.com/exif-parser/-/exif-parser-0.1.12.tgz#58a9d2d72c02c1f6f02a0ef4a9166272b7760922"
   integrity sha512-c2bQfLNbMzLPmzQuOr8fy0csy84WmwnER81W88DzTp9CYNPJ6yzOj2EZAh9pywYpqHnshVLHQJ8WzldAyfY+Iw==
 
+exit-x@^0.2.2:
+  version "0.2.2"
+  resolved "https://registry.yarnpkg.com/exit-x/-/exit-x-0.2.2.tgz#1f9052de3b8d99a696b10dad5bced9bdd5c3aa64"
+  integrity sha512-+I6B/IkJc1o/2tiURyz/ivu/O0nKNEArIUB5O7zBrlDVJr22SCLH3xTeEry428LvFhRzIA1g8izguxJ/gbNcVQ==
+
 expand-template@^2.0.3:
   version "2.0.3"
   resolved "https://registry.yarnpkg.com/expand-template/-/expand-template-2.0.3.tgz#6e14b3fcee0f3a6340ecb57d2e8918692052a47c"
   integrity sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==
 
+expect@30.2.0, expect@^30.0.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/expect/-/expect-30.2.0.tgz#d4013bed267013c14bc1199cec8aa57cee9b5869"
+  integrity sha512-u/feCi0GPsI+988gU2FLcsHyAHTU0MX1Wg68NhAnN7z/+C5wqG+CY8J53N9ioe8RXgaoz0nBR/TYMf3AycUuPw==
+  dependencies:
+    "@jest/expect-utils" "30.2.0"
+    "@jest/get-type" "30.1.0"
+    jest-matcher-utils "30.2.0"
+    jest-message-util "30.2.0"
+    jest-mock "30.2.0"
+    jest-util "30.2.0"
+
 express-graphql@^0.12.0:
   version "0.12.0"
   resolved "https://registry.yarnpkg.com/express-graphql/-/express-graphql-0.12.0.tgz#58deabc309909ca2c9fe2f83f5fbe94429aa23df"
@@ -7636,7 +8510,7 @@ fast-glob@^3.2.11, fast-glob@^3.2.5, fast-glob@^3.2.9:
     merge2 "^1.3.0"
     micromatch "^4.0.4"
 
-fast-json-stable-stringify@^2.0.0:
+fast-json-stable-stringify@2.x, fast-json-stable-stringify@^2.0.0, fast-json-stable-stringify@^2.1.0:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz#874bf69c6f404c2b5d99c481341399fd55892633"
   integrity sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==
@@ -7675,6 +8549,13 @@ fb-watchman@^2.0.0:
   dependencies:
     bser "2.1.1"
 
+fb-watchman@^2.0.2:
+  version "2.0.2"
+  resolved "https://registry.yarnpkg.com/fb-watchman/-/fb-watchman-2.0.2.tgz#e9524ee6b5c77e9e5001af0f85f3adbb8623255c"
+  integrity sha512-p5161BqbuCaSnB8jIbzQHOlpgsPmK5rJVDfDKO91Axs5NC1uu3HRQm6wt9cd9/+GtQQIO53JdGXXoyDpTAsgYA==
+  dependencies:
+    bser "2.1.1"
+
 fbjs-css-vars@^1.0.0:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/fbjs-css-vars/-/fbjs-css-vars-1.0.2.tgz#216551136ae02fe255932c3ec8775f18e2c078b8"
@@ -7878,6 +8759,14 @@ for-each@^0.3.3:
   dependencies:
     is-callable "^1.2.7"
 
+foreground-child@^3.1.0:
+  version "3.3.1"
+  resolved "https://registry.yarnpkg.com/foreground-child/-/foreground-child-3.3.1.tgz#32e8e9ed1b68a3497befb9ac2b6adf92a638576f"
+  integrity sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==
+  dependencies:
+    cross-spawn "^7.0.6"
+    signal-exit "^4.0.1"
+
 fork-ts-checker-webpack-plugin@^6.5.0:
   version "6.5.2"
   resolved "https://registry.yarnpkg.com/fork-ts-checker-webpack-plugin/-/fork-ts-checker-webpack-plugin-6.5.2.tgz#4f67183f2f9eb8ba7df7177ce3cf3e75cdafb340"
@@ -7988,6 +8877,11 @@ fs.realpath@^1.0.0:
   resolved "https://registry.yarnpkg.com/fs.realpath/-/fs.realpath-1.0.0.tgz#1504ad2523158caa40db4a2787cb01411994ea4f"
   integrity sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==
 
+fsevents@^2.3.3:
+  version "2.3.3"
+  resolved "https://registry.yarnpkg.com/fsevents/-/fsevents-2.3.3.tgz#cac6407785d03675a2a5e1a5305c697b347d90d6"
+  integrity sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==
+
 fsevents@~2.3.2:
   version "2.3.2"
   resolved "https://registry.yarnpkg.com/fsevents/-/fsevents-2.3.2.tgz#8a526f78b8fdf4623b709e0b975c52c24c02fd1a"
@@ -8777,6 +9671,11 @@ get-intrinsic@^1.2.4, get-intrinsic@^1.2.5, get-intrinsic@^1.2.6, get-intrinsic@
     hasown "^2.0.2"
     math-intrinsics "^1.1.0"
 
+get-package-type@^0.1.0:
+  version "0.1.0"
+  resolved "https://registry.yarnpkg.com/get-package-type/-/get-package-type-0.1.0.tgz#8de2d803cff44df3bc6c456e6668b36c3926e11a"
+  integrity sha512-pjzuKtY64GYfWizNAJ0fr9VqttZkNiK2iS430LtIHzjBEr6bX8Am2zm4sW4Ro5wjWW5cAlRL1qAMTcXbjNAO2Q==
+
 get-port@^3.2.0:
   version "3.2.0"
   resolved "https://registry.yarnpkg.com/get-port/-/get-port-3.2.0.tgz#dd7ce7de187c06c8bf353796ac71e099f0980ebc"
@@ -8877,6 +9776,18 @@ glob-to-regexp@^0.4.1:
   resolved "https://registry.yarnpkg.com/glob-to-regexp/-/glob-to-regexp-0.4.1.tgz#c75297087c851b9a578bd217dd59a92f59fe546e"
   integrity sha512-lkX1HJXwyMcprw/5YUZc2s7DrpAiHB21/V+E1rHUrVNokkvB6bqMzT0VfV6/86ZNabt1k14YOIaT7nDvOX3Iiw==
 
+glob@^10.3.10:
+  version "10.5.0"
+  resolved "https://registry.yarnpkg.com/glob/-/glob-10.5.0.tgz#8ec0355919cd3338c28428a23d4f24ecc5fe738c"
+  integrity sha512-DfXN8DfhJ7NH3Oe7cFmu3NCu1wKbkReJ8TorzSAFbSKrlNaQSKfIzqYqVY8zlbs2NLBbWpRiU52GX2PbaBVNkg==
+  dependencies:
+    foreground-child "^3.1.0"
+    jackspeak "^3.1.2"
+    minimatch "^9.0.4"
+    minipass "^7.1.2"
+    package-json-from-dist "^1.0.0"
+    path-scurry "^1.11.1"
+
 glob@^7.0.0:
   version "7.2.0"
   resolved "https://registry.yarnpkg.com/glob/-/glob-7.2.0.tgz#d15535af7732e02e948f4c41628bd910293f6023"
@@ -8889,7 +9800,7 @@ glob@^7.0.0:
     once "^1.3.0"
     path-is-absolute "^1.0.0"
 
-glob@^7.1.1, glob@^7.1.2, glob@^7.1.3, glob@^7.1.6, glob@^7.1.7, glob@^7.2.3:
+glob@^7.1.1, glob@^7.1.2, glob@^7.1.3, glob@^7.1.4, glob@^7.1.6, glob@^7.1.7, glob@^7.2.3:
   version "7.2.3"
   resolved "https://registry.yarnpkg.com/glob/-/glob-7.2.3.tgz#b8df0fb802bbfa8e89bd1d938b4e16578ed44f2b"
   integrity sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==
@@ -9088,6 +9999,18 @@ gzip-size@^6.0.0:
   dependencies:
     duplexer "^0.1.2"
 
+handlebars@^4.7.8:
+  version "4.7.8"
+  resolved "https://registry.yarnpkg.com/handlebars/-/handlebars-4.7.8.tgz#41c42c18b1be2365439188c77c6afae71c0cd9e9"
+  integrity sha512-vafaFqs8MZkRrSX7sFVUdo3ap/eNiLnb4IakshzvP56X5Nr1iGKAIqdX6tMlm6HcNRIkr6AxO5jFEoJzzpT8aQ==
+  dependencies:
+    minimist "^1.2.5"
+    neo-async "^2.6.2"
+    source-map "^0.6.1"
+    wordwrap "^1.0.0"
+  optionalDependencies:
+    uglify-js "^3.1.4"
+
 hard-rejection@^2.1.0:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/hard-rejection/-/hard-rejection-2.1.0.tgz#1c6eda5c1685c63942766d79bb40ae773cecd883"
@@ -9317,6 +10240,11 @@ html-entities@^2.3.3:
   resolved "https://registry.yarnpkg.com/html-entities/-/html-entities-2.3.3.tgz#117d7626bece327fc8baace8868fa6f5ef856e46"
   integrity sha512-DV5Ln36z34NNTDgnz0EWGBLZENelNAtkiFA4kyNOG2tDI6Mz1uSWiq1wAKdyjnJwyDiDO7Fa2SO1CTxPXL8VxA==
 
+html-escaper@^2.0.0:
+  version "2.0.2"
+  resolved "https://registry.yarnpkg.com/html-escaper/-/html-escaper-2.0.2.tgz#dfd60027da36a36dfcbe236262c00a5822681453"
+  integrity sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==
+
 html-parse-stringify@^3.0.1:
   version "3.0.1"
   resolved "https://registry.yarnpkg.com/html-parse-stringify/-/html-parse-stringify-3.0.1.tgz#dfc1017347ce9f77c8141a507f233040c59c55d2"
@@ -9499,6 +10427,14 @@ import-lazy@^2.1.0:
   resolved "https://registry.yarnpkg.com/import-lazy/-/import-lazy-2.1.0.tgz#05698e3d45c88e8d7e9d92cb0584e77f096f3e43"
   integrity sha512-m7ZEHgtw69qOGw+jwxXkHlrlIPdTGkyh66zXZ1ajZbxkDBNjSY/LGbmjc7h0s2ELsUDTAhFr55TrPSSqJGPG0A==
 
+import-local@^3.2.0:
+  version "3.2.0"
+  resolved "https://registry.yarnpkg.com/import-local/-/import-local-3.2.0.tgz#c3d5c745798c02a6f8b897726aba5100186ee260"
+  integrity sha512-2SPlun1JUPWoM6t3F0dw0FkCF/jWY8kttcY4f599GLTSjh2OCuuhdTkJQsEcZzBqbXZGKMK2OqW1oZsjtf/gQA==
+  dependencies:
+    pkg-dir "^4.2.0"
+    resolve-cwd "^3.0.0"
+
 imurmurhash@^0.1.4:
   version "0.1.4"
   resolved "https://registry.yarnpkg.com/imurmurhash/-/imurmurhash-0.1.4.tgz#9218b9b2b928a238b13dc4fb6b6d576f231453ea"
@@ -9808,6 +10744,11 @@ is-function@^1.0.1:
   resolved "https://registry.yarnpkg.com/is-function/-/is-function-1.0.2.tgz#4f097f30abf6efadac9833b17ca5dc03f8144e08"
   integrity sha512-lw7DUp0aWXYg+CBCN+JKkcE0Q2RayZnSvnZBlwgxHBQhqt5pZNVy4Ri7H9GmmXkdu7LUthszM+Tor1u/2iBcpQ==
 
+is-generator-fn@^2.1.0:
+  version "2.1.0"
+  resolved "https://registry.yarnpkg.com/is-generator-fn/-/is-generator-fn-2.1.0.tgz#7d140adc389aaf3011a8f2a2a4cfa6faadffb118"
+  integrity sha512-cTIB4yPYL/Grw0EaSzASzg6bBy9gqCofvWN8okThAYIxKJZC+udlRAmGbM0XLeniEJSs8uEgHPGuHSe1XsOLSQ==
+
 is-generator-function@^1.0.10:
   version "1.1.0"
   resolved "https://registry.yarnpkg.com/is-generator-function/-/is-generator-function-1.1.0.tgz#bf3eeda931201394f57b5dba2800f91a238309ca"
@@ -10173,6 +11114,48 @@ isobject@^3.0.1:
   resolved "https://registry.yarnpkg.com/isobject/-/isobject-3.0.1.tgz#4e431e92b11a9731636aa1f9c8d1ccbcfdab78df"
   integrity sha512-WhB9zCku7EGTj/HQQRz5aUQEUeoQZH2bWcltRErOpymJ4boYE6wL9Tbr23krRPSZ+C5zqNSrSw+Cc7sZZ4b7vg==
 
+istanbul-lib-coverage@^3.0.0, istanbul-lib-coverage@^3.2.0:
+  version "3.2.2"
+  resolved "https://registry.yarnpkg.com/istanbul-lib-coverage/-/istanbul-lib-coverage-3.2.2.tgz#2d166c4b0644d43a39f04bf6c2edd1e585f31756"
+  integrity sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==
+
+istanbul-lib-instrument@^6.0.0, istanbul-lib-instrument@^6.0.2:
+  version "6.0.3"
+  resolved "https://registry.yarnpkg.com/istanbul-lib-instrument/-/istanbul-lib-instrument-6.0.3.tgz#fa15401df6c15874bcb2105f773325d78c666765"
+  integrity sha512-Vtgk7L/R2JHyyGW07spoFlB8/lpjiOLTjMdms6AFMraYt3BaJauod/NGrfnVG/y4Ix1JEuMRPDPEj2ua+zz1/Q==
+  dependencies:
+    "@babel/core" "^7.23.9"
+    "@babel/parser" "^7.23.9"
+    "@istanbuljs/schema" "^0.1.3"
+    istanbul-lib-coverage "^3.2.0"
+    semver "^7.5.4"
+
+istanbul-lib-report@^3.0.0:
+  version "3.0.1"
+  resolved "https://registry.yarnpkg.com/istanbul-lib-report/-/istanbul-lib-report-3.0.1.tgz#908305bac9a5bd175ac6a74489eafd0fc2445a7d"
+  integrity sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==
+  dependencies:
+    istanbul-lib-coverage "^3.0.0"
+    make-dir "^4.0.0"
+    supports-color "^7.1.0"
+
+istanbul-lib-source-maps@^5.0.0:
+  version "5.0.6"
+  resolved "https://registry.yarnpkg.com/istanbul-lib-source-maps/-/istanbul-lib-source-maps-5.0.6.tgz#acaef948df7747c8eb5fbf1265cb980f6353a441"
+  integrity sha512-yg2d+Em4KizZC5niWhQaIomgf5WlL4vOOjZ5xGCmF8SnPE/mDWWXgvRExdcpCgh9lLRRa1/fSYp2ymmbJ1pI+A==
+  dependencies:
+    "@jridgewell/trace-mapping" "^0.3.23"
+    debug "^4.1.1"
+    istanbul-lib-coverage "^3.0.0"
+
+istanbul-reports@^3.1.3:
+  version "3.2.0"
+  resolved "https://registry.yarnpkg.com/istanbul-reports/-/istanbul-reports-3.2.0.tgz#cb4535162b5784aa623cee21a7252cf2c807ac93"
+  integrity sha512-HGYWWS/ehqTV3xN10i23tkPkpH46MLCIMFNCaaKNavAXTF1RkqxawEPtnjnGZ6XKSInBKkiOA5BKS+aZiY3AvA==
+  dependencies:
+    html-escaper "^2.0.0"
+    istanbul-lib-report "^3.0.0"
+
 iterator.prototype@^1.1.4:
   version "1.1.5"
   resolved "https://registry.yarnpkg.com/iterator.prototype/-/iterator.prototype-1.1.5.tgz#12c959a29de32de0aa3bbbb801f4d777066dae39"
@@ -10185,11 +11168,366 @@ iterator.prototype@^1.1.4:
     has-symbols "^1.1.0"
     set-function-name "^2.0.2"
 
+jackspeak@^3.1.2:
+  version "3.4.3"
+  resolved "https://registry.yarnpkg.com/jackspeak/-/jackspeak-3.4.3.tgz#8833a9d89ab4acde6188942bd1c53b6390ed5a8a"
+  integrity sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==
+  dependencies:
+    "@isaacs/cliui" "^8.0.2"
+  optionalDependencies:
+    "@pkgjs/parseargs" "^0.11.0"
+
 javascript-stringify@^2.0.1:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/javascript-stringify/-/javascript-stringify-2.1.0.tgz#27c76539be14d8bd128219a2d731b09337904e79"
   integrity sha512-JVAfqNPTvNq3sB/VHQJAFxN/sPgKnsKrCwyRt15zwNCdrMMJDdcEOdubuy+DuJYYdm0ox1J4uzEuYKkN+9yhVg==
 
+jest-changed-files@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-changed-files/-/jest-changed-files-30.2.0.tgz#602266e478ed554e1e1469944faa7efd37cee61c"
+  integrity sha512-L8lR1ChrRnSdfeOvTrwZMlnWV8G/LLjQ0nG9MBclwWZidA2N5FviRki0Bvh20WRMOX31/JYvzdqTJrk5oBdydQ==
+  dependencies:
+    execa "^5.1.1"
+    jest-util "30.2.0"
+    p-limit "^3.1.0"
+
+jest-circus@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-circus/-/jest-circus-30.2.0.tgz#98b8198b958748a2f322354311023d1d02e7603f"
+  integrity sha512-Fh0096NC3ZkFx05EP2OXCxJAREVxj1BcW/i6EWqqymcgYKWjyyDpral3fMxVcHXg6oZM7iULer9wGRFvfpl+Tg==
+  dependencies:
+    "@jest/environment" "30.2.0"
+    "@jest/expect" "30.2.0"
+    "@jest/test-result" "30.2.0"
+    "@jest/types" "30.2.0"
+    "@types/node" "*"
+    chalk "^4.1.2"
+    co "^4.6.0"
+    dedent "^1.6.0"
+    is-generator-fn "^2.1.0"
+    jest-each "30.2.0"
+    jest-matcher-utils "30.2.0"
+    jest-message-util "30.2.0"
+    jest-runtime "30.2.0"
+    jest-snapshot "30.2.0"
+    jest-util "30.2.0"
+    p-limit "^3.1.0"
+    pretty-format "30.2.0"
+    pure-rand "^7.0.0"
+    slash "^3.0.0"
+    stack-utils "^2.0.6"
+
+jest-cli@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-cli/-/jest-cli-30.2.0.tgz#1780f8e9d66bf84a10b369aea60aeda7697dcc67"
+  integrity sha512-Os9ukIvADX/A9sLt6Zse3+nmHtHaE6hqOsjQtNiugFTbKRHYIYtZXNGNK9NChseXy7djFPjndX1tL0sCTlfpAA==
+  dependencies:
+    "@jest/core" "30.2.0"
+    "@jest/test-result" "30.2.0"
+    "@jest/types" "30.2.0"
+    chalk "^4.1.2"
+    exit-x "^0.2.2"
+    import-local "^3.2.0"
+    jest-config "30.2.0"
+    jest-util "30.2.0"
+    jest-validate "30.2.0"
+    yargs "^17.7.2"
+
+jest-config@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-config/-/jest-config-30.2.0.tgz#29df8c50e2ad801cc59c406b50176c18c362a90b"
+  integrity sha512-g4WkyzFQVWHtu6uqGmQR4CQxz/CH3yDSlhzXMWzNjDx843gYjReZnMRanjRCq5XZFuQrGDxgUaiYWE8BRfVckA==
+  dependencies:
+    "@babel/core" "^7.27.4"
+    "@jest/get-type" "30.1.0"
+    "@jest/pattern" "30.0.1"
+    "@jest/test-sequencer" "30.2.0"
+    "@jest/types" "30.2.0"
+    babel-jest "30.2.0"
+    chalk "^4.1.2"
+    ci-info "^4.2.0"
+    deepmerge "^4.3.1"
+    glob "^10.3.10"
+    graceful-fs "^4.2.11"
+    jest-circus "30.2.0"
+    jest-docblock "30.2.0"
+    jest-environment-node "30.2.0"
+    jest-regex-util "30.0.1"
+    jest-resolve "30.2.0"
+    jest-runner "30.2.0"
+    jest-util "30.2.0"
+    jest-validate "30.2.0"
+    micromatch "^4.0.8"
+    parse-json "^5.2.0"
+    pretty-format "30.2.0"
+    slash "^3.0.0"
+    strip-json-comments "^3.1.1"
+
+jest-diff@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-diff/-/jest-diff-30.2.0.tgz#e3ec3a6ea5c5747f605c9e874f83d756cba36825"
+  integrity sha512-dQHFo3Pt4/NLlG5z4PxZ/3yZTZ1C7s9hveiOj+GCN+uT109NC2QgsoVZsVOAvbJ3RgKkvyLGXZV9+piDpWbm6A==
+  dependencies:
+    "@jest/diff-sequences" "30.0.1"
+    "@jest/get-type" "30.1.0"
+    chalk "^4.1.2"
+    pretty-format "30.2.0"
+
+jest-docblock@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-docblock/-/jest-docblock-30.2.0.tgz#42cd98d69f887e531c7352309542b1ce4ee10256"
+  integrity sha512-tR/FFgZKS1CXluOQzZvNH3+0z9jXr3ldGSD8bhyuxvlVUwbeLOGynkunvlTMxchC5urrKndYiwCFC0DLVjpOCA==
+  dependencies:
+    detect-newline "^3.1.0"
+
+jest-each@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-each/-/jest-each-30.2.0.tgz#39e623ae71641c2ac3ee69b3ba3d258fce8e768d"
+  integrity sha512-lpWlJlM7bCUf1mfmuqTA8+j2lNURW9eNafOy99knBM01i5CQeY5UH1vZjgT9071nDJac1M4XsbyI44oNOdhlDQ==
+  dependencies:
+    "@jest/get-type" "30.1.0"
+    "@jest/types" "30.2.0"
+    chalk "^4.1.2"
+    jest-util "30.2.0"
+    pretty-format "30.2.0"
+
+jest-environment-node@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-environment-node/-/jest-environment-node-30.2.0.tgz#3def7980ebd2fd86e74efd4d2e681f55ab38da0f"
+  integrity sha512-ElU8v92QJ9UrYsKrxDIKCxu6PfNj4Hdcktcn0JX12zqNdqWHB0N+hwOnnBBXvjLd2vApZtuLUGs1QSY+MsXoNA==
+  dependencies:
+    "@jest/environment" "30.2.0"
+    "@jest/fake-timers" "30.2.0"
+    "@jest/types" "30.2.0"
+    "@types/node" "*"
+    jest-mock "30.2.0"
+    jest-util "30.2.0"
+    jest-validate "30.2.0"
+
+jest-haste-map@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-haste-map/-/jest-haste-map-30.2.0.tgz#808e3889f288603ac70ff0ac047598345a66022e"
+  integrity sha512-sQA/jCb9kNt+neM0anSj6eZhLZUIhQgwDt7cPGjumgLM4rXsfb9kpnlacmvZz3Q5tb80nS+oG/if+NBKrHC+Xw==
+  dependencies:
+    "@jest/types" "30.2.0"
+    "@types/node" "*"
+    anymatch "^3.1.3"
+    fb-watchman "^2.0.2"
+    graceful-fs "^4.2.11"
+    jest-regex-util "30.0.1"
+    jest-util "30.2.0"
+    jest-worker "30.2.0"
+    micromatch "^4.0.8"
+    walker "^1.0.8"
+  optionalDependencies:
+    fsevents "^2.3.3"
+
+jest-leak-detector@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-leak-detector/-/jest-leak-detector-30.2.0.tgz#292fdca7b7c9cf594e1e570ace140b01d8beb736"
+  integrity sha512-M6jKAjyzjHG0SrQgwhgZGy9hFazcudwCNovY/9HPIicmNSBuockPSedAP9vlPK6ONFJ1zfyH/M2/YYJxOz5cdQ==
+  dependencies:
+    "@jest/get-type" "30.1.0"
+    pretty-format "30.2.0"
+
+jest-matcher-utils@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-matcher-utils/-/jest-matcher-utils-30.2.0.tgz#69a0d4c271066559ec8b0d8174829adc3f23a783"
+  integrity sha512-dQ94Nq4dbzmUWkQ0ANAWS9tBRfqCrn0bV9AMYdOi/MHW726xn7eQmMeRTpX2ViC00bpNaWXq+7o4lIQ3AX13Hg==
+  dependencies:
+    "@jest/get-type" "30.1.0"
+    chalk "^4.1.2"
+    jest-diff "30.2.0"
+    pretty-format "30.2.0"
+
+jest-message-util@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-message-util/-/jest-message-util-30.2.0.tgz#fc97bf90d11f118b31e6131e2b67fc4f39f92152"
+  integrity sha512-y4DKFLZ2y6DxTWD4cDe07RglV88ZiNEdlRfGtqahfbIjfsw1nMCPx49Uev4IA/hWn3sDKyAnSPwoYSsAEdcimw==
+  dependencies:
+    "@babel/code-frame" "^7.27.1"
+    "@jest/types" "30.2.0"
+    "@types/stack-utils" "^2.0.3"
+    chalk "^4.1.2"
+    graceful-fs "^4.2.11"
+    micromatch "^4.0.8"
+    pretty-format "30.2.0"
+    slash "^3.0.0"
+    stack-utils "^2.0.6"
+
+jest-mock@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-mock/-/jest-mock-30.2.0.tgz#69f991614eeb4060189459d3584f710845bff45e"
+  integrity sha512-JNNNl2rj4b5ICpmAcq+WbLH83XswjPbjH4T7yvGzfAGCPh1rw+xVNbtk+FnRslvt9lkCcdn9i1oAoKUuFsOxRw==
+  dependencies:
+    "@jest/types" "30.2.0"
+    "@types/node" "*"
+    jest-util "30.2.0"
+
+jest-pnp-resolver@^1.2.3:
+  version "1.2.3"
+  resolved "https://registry.yarnpkg.com/jest-pnp-resolver/-/jest-pnp-resolver-1.2.3.tgz#930b1546164d4ad5937d5540e711d4d38d4cad2e"
+  integrity sha512-+3NpwQEnRoIBtx4fyhblQDPgJI0H1IEIkX7ShLUjPGA7TtUTvI1oiKi3SR4oBR0hQhQR80l4WAe5RrXBwWMA8w==
+
+jest-regex-util@30.0.1:
+  version "30.0.1"
+  resolved "https://registry.yarnpkg.com/jest-regex-util/-/jest-regex-util-30.0.1.tgz#f17c1de3958b67dfe485354f5a10093298f2a49b"
+  integrity sha512-jHEQgBXAgc+Gh4g0p3bCevgRCVRkB4VB70zhoAE48gxeSr1hfUOsM/C2WoJgVL7Eyg//hudYENbm3Ne+/dRVVA==
+
+jest-resolve-dependencies@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-resolve-dependencies/-/jest-resolve-dependencies-30.2.0.tgz#3370e2c0b49cc560f6a7e8ec3a59dd99525e1a55"
+  integrity sha512-xTOIGug/0RmIe3mmCqCT95yO0vj6JURrn1TKWlNbhiAefJRWINNPgwVkrVgt/YaerPzY3iItufd80v3lOrFJ2w==
+  dependencies:
+    jest-regex-util "30.0.1"
+    jest-snapshot "30.2.0"
+
+jest-resolve@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-resolve/-/jest-resolve-30.2.0.tgz#2e2009cbd61e8f1f003355d5ec87225412cebcd7"
+  integrity sha512-TCrHSxPlx3tBY3hWNtRQKbtgLhsXa1WmbJEqBlTBrGafd5fiQFByy2GNCEoGR+Tns8d15GaL9cxEzKOO3GEb2A==
+  dependencies:
+    chalk "^4.1.2"
+    graceful-fs "^4.2.11"
+    jest-haste-map "30.2.0"
+    jest-pnp-resolver "^1.2.3"
+    jest-util "30.2.0"
+    jest-validate "30.2.0"
+    slash "^3.0.0"
+    unrs-resolver "^1.7.11"
+
+jest-runner@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-runner/-/jest-runner-30.2.0.tgz#c62b4c3130afa661789705e13a07bdbcec26a114"
+  integrity sha512-PqvZ2B2XEyPEbclp+gV6KO/F1FIFSbIwewRgmROCMBo/aZ6J1w8Qypoj2pEOcg3G2HzLlaP6VUtvwCI8dM3oqQ==
+  dependencies:
+    "@jest/console" "30.2.0"
+    "@jest/environment" "30.2.0"
+    "@jest/test-result" "30.2.0"
+    "@jest/transform" "30.2.0"
+    "@jest/types" "30.2.0"
+    "@types/node" "*"
+    chalk "^4.1.2"
+    emittery "^0.13.1"
+    exit-x "^0.2.2"
+    graceful-fs "^4.2.11"
+    jest-docblock "30.2.0"
+    jest-environment-node "30.2.0"
+    jest-haste-map "30.2.0"
+    jest-leak-detector "30.2.0"
+    jest-message-util "30.2.0"
+    jest-resolve "30.2.0"
+    jest-runtime "30.2.0"
+    jest-util "30.2.0"
+    jest-watcher "30.2.0"
+    jest-worker "30.2.0"
+    p-limit "^3.1.0"
+    source-map-support "0.5.13"
+
+jest-runtime@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-runtime/-/jest-runtime-30.2.0.tgz#395ea792cde048db1b0cd1a92dc9cb9f1921bf8a"
+  integrity sha512-p1+GVX/PJqTucvsmERPMgCPvQJpFt4hFbM+VN3n8TMo47decMUcJbt+rgzwrEme0MQUA/R+1de2axftTHkKckg==
+  dependencies:
+    "@jest/environment" "30.2.0"
+    "@jest/fake-timers" "30.2.0"
+    "@jest/globals" "30.2.0"
+    "@jest/source-map" "30.0.1"
+    "@jest/test-result" "30.2.0"
+    "@jest/transform" "30.2.0"
+    "@jest/types" "30.2.0"
+    "@types/node" "*"
+    chalk "^4.1.2"
+    cjs-module-lexer "^2.1.0"
+    collect-v8-coverage "^1.0.2"
+    glob "^10.3.10"
+    graceful-fs "^4.2.11"
+    jest-haste-map "30.2.0"
+    jest-message-util "30.2.0"
+    jest-mock "30.2.0"
+    jest-regex-util "30.0.1"
+    jest-resolve "30.2.0"
+    jest-snapshot "30.2.0"
+    jest-util "30.2.0"
+    slash "^3.0.0"
+    strip-bom "^4.0.0"
+
+jest-snapshot@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-snapshot/-/jest-snapshot-30.2.0.tgz#266fbbb4b95fc4665ce6f32f1f38eeb39f4e26d0"
+  integrity sha512-5WEtTy2jXPFypadKNpbNkZ72puZCa6UjSr/7djeecHWOu7iYhSXSnHScT8wBz3Rn8Ena5d5RYRcsyKIeqG1IyA==
+  dependencies:
+    "@babel/core" "^7.27.4"
+    "@babel/generator" "^7.27.5"
+    "@babel/plugin-syntax-jsx" "^7.27.1"
+    "@babel/plugin-syntax-typescript" "^7.27.1"
+    "@babel/types" "^7.27.3"
+    "@jest/expect-utils" "30.2.0"
+    "@jest/get-type" "30.1.0"
+    "@jest/snapshot-utils" "30.2.0"
+    "@jest/transform" "30.2.0"
+    "@jest/types" "30.2.0"
+    babel-preset-current-node-syntax "^1.2.0"
+    chalk "^4.1.2"
+    expect "30.2.0"
+    graceful-fs "^4.2.11"
+    jest-diff "30.2.0"
+    jest-matcher-utils "30.2.0"
+    jest-message-util "30.2.0"
+    jest-util "30.2.0"
+    pretty-format "30.2.0"
+    semver "^7.7.2"
+    synckit "^0.11.8"
+
+jest-util@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-util/-/jest-util-30.2.0.tgz#5142adbcad6f4e53c2776c067a4db3c14f913705"
+  integrity sha512-QKNsM0o3Xe6ISQU869e+DhG+4CK/48aHYdJZGlFQVTjnbvgpcKyxpzk29fGiO7i/J8VENZ+d2iGnSsvmuHywlA==
+  dependencies:
+    "@jest/types" "30.2.0"
+    "@types/node" "*"
+    chalk "^4.1.2"
+    ci-info "^4.2.0"
+    graceful-fs "^4.2.11"
+    picomatch "^4.0.2"
+
+jest-validate@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-validate/-/jest-validate-30.2.0.tgz#273eaaed4c0963b934b5b31e96289edda6e0a2ef"
+  integrity sha512-FBGWi7dP2hpdi8nBoWxSsLvBFewKAg0+uSQwBaof4Y4DPgBabXgpSYC5/lR7VmnIlSpASmCi/ntRWPbv7089Pw==
+  dependencies:
+    "@jest/get-type" "30.1.0"
+    "@jest/types" "30.2.0"
+    camelcase "^6.3.0"
+    chalk "^4.1.2"
+    leven "^3.1.0"
+    pretty-format "30.2.0"
+
+jest-watcher@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-watcher/-/jest-watcher-30.2.0.tgz#f9c055de48e18c979e7756a3917e596e2d69b07b"
+  integrity sha512-PYxa28dxJ9g777pGm/7PrbnMeA0Jr7osHP9bS7eJy9DuAjMgdGtxgf0uKMyoIsTWAkIbUW5hSDdJ3urmgXBqxg==
+  dependencies:
+    "@jest/test-result" "30.2.0"
+    "@jest/types" "30.2.0"
+    "@types/node" "*"
+    ansi-escapes "^4.3.2"
+    chalk "^4.1.2"
+    emittery "^0.13.1"
+    jest-util "30.2.0"
+    string-length "^4.0.2"
+
+jest-worker@30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest-worker/-/jest-worker-30.2.0.tgz#fd5c2a36ff6058ec8f74366ec89538cc99539d26"
+  integrity sha512-0Q4Uk8WF7BUwqXHuAjc23vmopWJw5WH7w2tqBoUOZpOjW/ZnR44GXXd1r82RvnmI2GZge3ivrYXk/BE2+VtW2g==
+  dependencies:
+    "@types/node" "*"
+    "@ungap/structured-clone" "^1.3.0"
+    jest-util "30.2.0"
+    merge-stream "^2.0.0"
+    supports-color "^8.1.1"
+
 jest-worker@^26.3.0:
   version "26.6.2"
   resolved "https://registry.yarnpkg.com/jest-worker/-/jest-worker-26.6.2.tgz#7f72cbc4d643c365e27b9fd775f9d0eaa9c7a8ed"
@@ -10208,6 +11546,16 @@ jest-worker@^27.4.5, jest-worker@^27.5.1:
     merge-stream "^2.0.0"
     supports-color "^8.0.0"
 
+jest@^30.2.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/jest/-/jest-30.2.0.tgz#9f0a71e734af968f26952b5ae4b724af82681630"
+  integrity sha512-F26gjC0yWN8uAA5m5Ss8ZQf5nDHWGlN/xWZIh8S5SRbsEKBovwZhxGd6LJlbZYxBgCYOtreSUyb8hpXyGC5O4A==
+  dependencies:
+    "@jest/core" "30.2.0"
+    "@jest/types" "30.2.0"
+    import-local "^3.2.0"
+    jest-cli "30.2.0"
+
 jimp@^0.16.1:
   version "0.16.1"
   resolved "https://registry.yarnpkg.com/jimp/-/jimp-0.16.1.tgz#192f851a30e5ca11112a3d0aa53137659a78ca7a"
@@ -10467,6 +11815,11 @@ latest-version@5.1.0, latest-version@^5.1.0:
   dependencies:
     package-json "^6.3.0"
 
+leven@^3.1.0:
+  version "3.1.0"
+  resolved "https://registry.yarnpkg.com/leven/-/leven-3.1.0.tgz#77891de834064cccba82ae7842bb6b14a13ed7f2"
+  integrity sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A==
+
 levn@^0.4.1:
   version "0.4.1"
   resolved "https://registry.yarnpkg.com/levn/-/levn-0.4.1.tgz#ae4562c007473b932a6200d403268dd2fffc6ade"
@@ -10912,11 +12265,25 @@ make-dir@^3.0.0, make-dir@^3.0.2, make-dir@^3.1.0:
   dependencies:
     semver "^6.0.0"
 
-make-error@^1.1.1:
+make-dir@^4.0.0:
+  version "4.0.0"
+  resolved "https://registry.yarnpkg.com/make-dir/-/make-dir-4.0.0.tgz#c3c2307a771277cd9638305f915c29ae741b614e"
+  integrity sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==
+  dependencies:
+    semver "^7.5.3"
+
+make-error@^1.1.1, make-error@^1.3.6:
   version "1.3.6"
   resolved "https://registry.yarnpkg.com/make-error/-/make-error-1.3.6.tgz#2eb2e37ea9b67c4891f684a1394799af484cf7a2"
   integrity sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==
 
+makeerror@1.0.12:
+  version "1.0.12"
+  resolved "https://registry.yarnpkg.com/makeerror/-/makeerror-1.0.12.tgz#3e5dd2079a82e812e983cc6610c4a2cb0eaa801a"
+  integrity sha512-JmqCvUhmt43madlpFzG4BQzG2Z3m6tvQDNKdClZnO3VbIudJYmxsT0FNJMeiB2+JTSlTQTSbU8QdesVmwJcmLg==
+  dependencies:
+    tmpl "1.0.5"
+
 map-age-cleaner@^0.1.3:
   version "0.1.3"
   resolved "https://registry.yarnpkg.com/map-age-cleaner/-/map-age-cleaner-0.1.3.tgz#7d583a7306434c055fe474b0f45078e6e1b4b92a"
@@ -11130,7 +12497,7 @@ methods@~1.1.2:
   resolved "https://registry.yarnpkg.com/methods/-/methods-1.1.2.tgz#5529a4d67654134edcc5266656835b0f851afcee"
   integrity sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==
 
-micromatch@^4.0.2:
+micromatch@^4.0.2, micromatch@^4.0.8:
   version "4.0.8"
   resolved "https://registry.yarnpkg.com/micromatch/-/micromatch-4.0.8.tgz#d66fa18f3a47076789320b9b1af32bd86d9fa202"
   integrity sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==
@@ -11240,6 +12607,13 @@ minimatch@^8.0.2:
   dependencies:
     brace-expansion "^2.0.1"
 
+minimatch@^9.0.4:
+  version "9.0.5"
+  resolved "https://registry.yarnpkg.com/minimatch/-/minimatch-9.0.5.tgz#d74f9dd6b57d83d8e98cfb82133b03978bc929e5"
+  integrity sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==
+  dependencies:
+    brace-expansion "^2.0.1"
+
 minimist-options@4.1.0:
   version "4.1.0"
   resolved "https://registry.yarnpkg.com/minimist-options/-/minimist-options-4.1.0.tgz#c0655713c53a8a2ebd77ffa247d342c40f010619"
@@ -11264,7 +12638,7 @@ minipass@^4.2.4:
   resolved "https://registry.yarnpkg.com/minipass/-/minipass-4.2.8.tgz#f0010f64393ecfc1d1ccb5f582bcaf45f48e1a3a"
   integrity sha512-fNzuVyifolSLFL4NzpF+wEF4qrgqaaKX0haXPQEdQ7NKAN+WecoKMHV09YcuL/DHxrUsYQOK3MiuDf7Ip2OXfQ==
 
-"minipass@^5.0.0 || ^6.0.2 || ^7.0.0":
+"minipass@^5.0.0 || ^6.0.2 || ^7.0.0", minipass@^7.1.2:
   version "7.1.2"
   resolved "https://registry.yarnpkg.com/minipass/-/minipass-7.1.2.tgz#93a9626ce5e5e66bd4db86849e7515e92340a707"
   integrity sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==
@@ -11384,6 +12758,11 @@ napi-build-utils@^1.0.1:
   resolved "https://registry.yarnpkg.com/napi-build-utils/-/napi-build-utils-1.0.2.tgz#b1fddc0b2c46e380a0b7a76f984dd47c41a13806"
   integrity sha512-ONmRUqK7zj7DWX0D9ADe03wbwOBZxNAfF20PlGfCWQcD3+/MakShIHrMqx9YwPTfxDdF1zLeL+RGZiR9kGMLdg==
 
+napi-postinstall@^0.3.0:
+  version "0.3.4"
+  resolved "https://registry.yarnpkg.com/napi-postinstall/-/napi-postinstall-0.3.4.tgz#7af256d6588b5f8e952b9190965d6b019653bbb9"
+  integrity sha512-PHI5f1O0EP5xJ9gQmFGMS6IZcrVvTjpXjz7Na41gTE7eE2hK11lg04CECCYEEjdc17EV4DO+fkGEtt7TpTaTiQ==
+
 natural-compare@^1.4.0:
   version "1.4.0"
   resolved "https://registry.yarnpkg.com/natural-compare/-/natural-compare-1.4.0.tgz#4abebfeed7541f2c27acfb29bdbbd15c8d5ba4f7"
@@ -11889,7 +13268,7 @@ p-finally@^1.0.0:
   resolved "https://registry.yarnpkg.com/p-finally/-/p-finally-1.0.0.tgz#3fbcfb15b899a44123b34b6dcc18b724336a2cae"
   integrity sha512-LICb2p9CB7FS+0eR1oqWnHhp0FljGLZCWBE9aix0Uye9W8LTQPwMTYVGWQWIw9RdQiDg4+epXQODwIYJtSJaow==
 
-p-limit@3.1.0, p-limit@^3.0.2:
+p-limit@3.1.0, p-limit@^3.0.2, p-limit@^3.1.0:
   version "3.1.0"
   resolved "https://registry.yarnpkg.com/p-limit/-/p-limit-3.1.0.tgz#e1daccbe78d0d1388ca18c64fea38e3e57e3706b"
   integrity sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==
@@ -11970,6 +13349,11 @@ p-try@^2.0.0:
   resolved "https://registry.yarnpkg.com/p-try/-/p-try-2.2.0.tgz#cb2868540e313d61de58fafbe35ce9004d5540e6"
   integrity sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==
 
+package-json-from-dist@^1.0.0:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz#4f1471a010827a86f94cfd9b0727e36d267de505"
+  integrity sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==
+
 package-json@^6.3.0:
   version "6.5.0"
   resolved "https://registry.yarnpkg.com/package-json/-/package-json-6.5.0.tgz#6feedaca35e75725876d0b0e64974697fed145b0"
@@ -12081,7 +13465,7 @@ parse-json@^4.0.0:
     error-ex "^1.3.1"
     json-parse-better-errors "^1.0.1"
 
-parse-json@^5.0.0:
+parse-json@^5.0.0, parse-json@^5.2.0:
   version "5.2.0"
   resolved "https://registry.yarnpkg.com/parse-json/-/parse-json-5.2.0.tgz#c76fc66dee54231c962b22bcc8a72cf2f99753cd"
   integrity sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==
@@ -12243,7 +13627,7 @@ path-root@^0.1.1:
   dependencies:
     path-root-regex "^0.1.0"
 
-path-scurry@^1.6.1:
+path-scurry@^1.11.1, path-scurry@^1.6.1:
   version "1.11.1"
   resolved "https://registry.yarnpkg.com/path-scurry/-/path-scurry-1.11.1.tgz#7960a668888594a0720b12a911d1a742ab9f11d2"
   integrity sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==
@@ -12301,11 +13685,21 @@ picomatch@^2.0.4, picomatch@^2.2.1, picomatch@^2.3.1:
   resolved "https://registry.yarnpkg.com/picomatch/-/picomatch-2.3.1.tgz#3ba3833733646d9d3e4995946c1365a67fb07a42"
   integrity sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==
 
+picomatch@^4.0.2:
+  version "4.0.3"
+  resolved "https://registry.yarnpkg.com/picomatch/-/picomatch-4.0.3.tgz#796c76136d1eead715db1e7bad785dedd695a042"
+  integrity sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==
+
 pify@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/pify/-/pify-3.0.0.tgz#e5a4acd2c101fdf3d9a4d07f0dbc4db49dd28176"
   integrity sha1-5aSs0sEB/fPZpNB/DbxNtJ3SgXY=
 
+pirates@^4.0.7:
+  version "4.0.7"
+  resolved "https://registry.yarnpkg.com/pirates/-/pirates-4.0.7.tgz#643b4a18c4257c8a65104b73f3049ce9a0a15e22"
+  integrity sha512-TfySrs/5nm8fQJDcBDuUng3VOUKsd7S+zqvbOTiGXHfxX4wK31ard+hoNuvkicM/2YFzlpDgABOevKSsB4G/FA==
+
 pixelmatch@^4.0.2:
   version "4.0.2"
   resolved "https://registry.yarnpkg.com/pixelmatch/-/pixelmatch-4.0.2.tgz#8f47dcec5011b477b67db03c243bc1f3085e8854"
@@ -12321,7 +13715,7 @@ pkg-conf@^2.1.0:
     find-up "^2.0.0"
     load-json-file "^4.0.0"
 
-pkg-dir@^4.1.0:
+pkg-dir@^4.1.0, pkg-dir@^4.2.0:
   version "4.2.0"
   resolved "https://registry.yarnpkg.com/pkg-dir/-/pkg-dir-4.2.0.tgz#f099133df7ede422e81d1d8448270eeb3e4261f3"
   integrity sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==
@@ -12953,6 +14347,15 @@ pretty-error@^2.1.2:
     lodash "^4.17.20"
     renderkid "^2.0.4"
 
+pretty-format@30.2.0, pretty-format@^30.0.0:
+  version "30.2.0"
+  resolved "https://registry.yarnpkg.com/pretty-format/-/pretty-format-30.2.0.tgz#2d44fe6134529aed18506f6d11509d8a62775ebe"
+  integrity sha512-9uBdv/B4EefsuAL+pWqueZyZS2Ba+LxfFeQ9DN14HU4bN8bhaxKdkpjpB6fs9+pSjIBu+FXQHImEg8j/Lw0+vA==
+  dependencies:
+    "@jest/schemas" "30.0.5"
+    ansi-styles "^5.2.0"
+    react-is "^18.3.1"
+
 probe-image-size@^7.2.3:
   version "7.2.3"
   resolved "https://registry.yarnpkg.com/probe-image-size/-/probe-image-size-7.2.3.tgz#d49c64be540ec8edea538f6f585f65a9b3ab4309"
@@ -13065,6 +14468,11 @@ pupa@^2.1.1:
   dependencies:
     escape-goat "^2.0.0"
 
+pure-rand@^7.0.0:
+  version "7.0.1"
+  resolved "https://registry.yarnpkg.com/pure-rand/-/pure-rand-7.0.1.tgz#6f53a5a9e3e4a47445822af96821ca509ed37566"
+  integrity sha512-oTUZM/NAZS8p7ANR3SHh30kXB+zK2r2BPcEn/awJIbOvq82WoMN4p62AWWp3Hhw50G0xMsw1mhIBLqHw64EcNQ==
+
 purgecss@^4.1.3:
   version "4.1.3"
   resolved "https://registry.yarnpkg.com/purgecss/-/purgecss-4.1.3.tgz#683f6a133c8c4de7aa82fe2746d1393b214918f7"
@@ -13282,6 +14690,11 @@ react-is@^18.2.0:
   resolved "https://registry.yarnpkg.com/react-is/-/react-is-18.2.0.tgz#199431eeaaa2e09f86427efbb4f1473edb47609b"
   integrity sha512-xWGDIW6x921xtzPkhiULtthJHoJvBbF3q26fzloPCK0hsvxtPVelvftw3zjbHWSkR2km9Z+4uxbDDK/6Zw9B8w==
 
+react-is@^18.3.1:
+  version "18.3.1"
+  resolved "https://registry.yarnpkg.com/react-is/-/react-is-18.3.1.tgz#e83557dc12eae63a99e003a46388b1dcbb44db7e"
+  integrity sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg==
+
 react-lifecycles-compat@^3.0.4:
   version "3.0.4"
   resolved "https://registry.yarnpkg.com/react-lifecycles-compat/-/react-lifecycles-compat-3.0.4.tgz#4f1a273afdfc8f3488a8c516bfda78f872352362"
@@ -14118,6 +15531,11 @@ semver@^7.5.3:
   resolved "https://registry.yarnpkg.com/semver/-/semver-7.7.1.tgz#abd5098d82b18c6c81f6074ff2647fd3e7220c9f"
   integrity sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==
 
+semver@^7.5.4, semver@^7.7.2, semver@^7.7.3:
+  version "7.7.3"
+  resolved "https://registry.yarnpkg.com/semver/-/semver-7.7.3.tgz#4b5f4143d007633a8dc671cd0a6ef9147b8bb946"
+  integrity sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==
+
 send@0.19.0:
   version "0.19.0"
   resolved "https://registry.yarnpkg.com/send/-/send-0.19.0.tgz#bbc5a388c8ea6c048967049dbeac0e4a3f09d7f8"
@@ -14391,6 +15809,11 @@ signal-exit@^3.0.0, signal-exit@^3.0.2, signal-exit@^3.0.3, signal-exit@^3.0.5,
   resolved "https://registry.yarnpkg.com/signal-exit/-/signal-exit-3.0.7.tgz#a9a1767f8af84155114eaabd73f99273c8f59ad9"
   integrity sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==
 
+signal-exit@^4.0.1:
+  version "4.1.0"
+  resolved "https://registry.yarnpkg.com/signal-exit/-/signal-exit-4.1.0.tgz#952188c1cbd546070e2dd20d0f41c0ae0530cb04"
+  integrity sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==
+
 signale@^1.4.0:
   version "1.4.0"
   resolved "https://registry.yarnpkg.com/signale/-/signale-1.4.0.tgz#c4be58302fb0262ac00fc3d886a7c113759042f1"
@@ -14568,6 +15991,14 @@ source-map-resolve@^0.5.2:
     source-map-url "^0.4.0"
     urix "^0.1.0"
 
+source-map-support@0.5.13:
+  version "0.5.13"
+  resolved "https://registry.yarnpkg.com/source-map-support/-/source-map-support-0.5.13.tgz#31b24a9c2e73c2de85066c0feb7d44767ed52932"
+  integrity sha512-SHSKFHadjVA5oR4PPqhtAVdcBWwRYVd6g6cAXnIbRiIwc2EhPrTuKUBdSLvlEKyIP3GCf89fltvcZiP9MMFA1w==
+  dependencies:
+    buffer-from "^1.0.0"
+    source-map "^0.6.0"
+
 source-map-support@^0.5.19, source-map-support@~0.5.20:
   version "0.5.21"
   resolved "https://registry.yarnpkg.com/source-map-support/-/source-map-support-0.5.21.tgz#04fe7c7f9e1ed2d662233c28cb2b35b9f63f6e4f"
@@ -14672,6 +16103,13 @@ stack-trace@^0.0.10:
   resolved "https://registry.yarnpkg.com/stack-trace/-/stack-trace-0.0.10.tgz#547c70b347e8d32b4e108ea1a2a159e5fdde19c0"
   integrity sha512-KGzahc7puUKkzyMt+IqAep+TVNbKP+k2Lmwhub39m1AsTSkaDutx56aDCo+HLDzf/D26BIHTJWNiTG1KAJiQCg==
 
+stack-utils@^2.0.6:
+  version "2.0.6"
+  resolved "https://registry.yarnpkg.com/stack-utils/-/stack-utils-2.0.6.tgz#aaf0748169c02fc33c8232abccf933f54a1cc34f"
+  integrity sha512-XlkWvfIm6RmsWtNJx+uqtKLS8eqFbxUg0ZzLXqY0caEy9l7hruX8IpiDnjsLavoBgqCCR71TqWO8MaXYheJ3RQ==
+  dependencies:
+    escape-string-regexp "^2.0.0"
+
 stackframe@^1.3.4:
   version "1.3.4"
   resolved "https://registry.yarnpkg.com/stackframe/-/stackframe-1.3.4.tgz#b881a004c8c149a5e8efef37d51b16e412943310"
@@ -14730,6 +16168,14 @@ string-hash@1.1.3:
   resolved "https://registry.yarnpkg.com/string-hash/-/string-hash-1.1.3.tgz#e8aafc0ac1855b4666929ed7dd1275df5d6c811b"
   integrity sha1-6Kr8CsGFW0Zmkp7X3RJ1311sgRs=
 
+string-length@^4.0.2:
+  version "4.0.2"
+  resolved "https://registry.yarnpkg.com/string-length/-/string-length-4.0.2.tgz#a8a8dc7bd5c1a82b9b3c8b87e125f66871b6e57a"
+  integrity sha512-+l6rNN5fYHNhZZy41RXsYptCjA2Igmq4EG7kZAYFQI1E1VTXarr6ZPXBg6eq7Y6eK4FEhY6AJlyuFIb/v/S0VQ==
+  dependencies:
+    char-regex "^1.0.2"
+    strip-ansi "^6.0.0"
+
 string-natural-compare@^3.0.1:
   version "3.0.1"
   resolved "https://registry.yarnpkg.com/string-natural-compare/-/string-natural-compare-3.0.1.tgz#7a42d58474454963759e8e8b7ae63d71c1e7fdf4"
@@ -14746,6 +16192,15 @@ string-similarity@^1.2.2:
     lodash.map "^4.6.0"
     lodash.maxby "^4.6.0"
 
+"string-width-cjs@npm:string-width@^4.2.0":
+  version "4.2.3"
+  resolved "https://registry.yarnpkg.com/string-width/-/string-width-4.2.3.tgz#269c7117d27b05ad2e536830a8ec895ef9c6d010"
+  integrity sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==
+  dependencies:
+    emoji-regex "^8.0.0"
+    is-fullwidth-code-point "^3.0.0"
+    strip-ansi "^6.0.1"
+
 string-width@^4.0.0, string-width@^4.1.0, string-width@^4.2.0, string-width@^4.2.2, string-width@^4.2.3:
   version "4.2.3"
   resolved "https://registry.yarnpkg.com/string-width/-/string-width-4.2.3.tgz#269c7117d27b05ad2e536830a8ec895ef9c6d010"
@@ -14764,6 +16219,15 @@ string-width@^5.0.0:
     emoji-regex "^9.2.2"
     strip-ansi "^7.0.1"
 
+string-width@^5.0.1, string-width@^5.1.2:
+  version "5.1.2"
+  resolved "https://registry.yarnpkg.com/string-width/-/string-width-5.1.2.tgz#14f8daec6d81e7221d2a357e668cab73bdbca794"
+  integrity sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==
+  dependencies:
+    eastasianwidth "^0.2.0"
+    emoji-regex "^9.2.2"
+    strip-ansi "^7.0.1"
+
 string.prototype.includes@^2.0.1:
   version "2.0.1"
   resolved "https://registry.yarnpkg.com/string.prototype.includes/-/string.prototype.includes-2.0.1.tgz#eceef21283640761a81dbe16d6c7171a4edf7d92"
@@ -14879,6 +16343,13 @@ stringify-entities@^1.0.1:
     is-alphanumerical "^1.0.0"
     is-hexadecimal "^1.0.0"
 
+"strip-ansi-cjs@npm:strip-ansi@^6.0.1":
+  version "6.0.1"
+  resolved "https://registry.yarnpkg.com/strip-ansi/-/strip-ansi-6.0.1.tgz#9e26c63d30f53443e9489495b2105d37b67a85d9"
+  integrity sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==
+  dependencies:
+    ansi-regex "^5.0.1"
+
 strip-ansi@^3.0.1:
   version "3.0.1"
   resolved "https://registry.yarnpkg.com/strip-ansi/-/strip-ansi-3.0.1.tgz#6a385fb8853d952d5ff05d0e8aaf94278dc63dcf"
@@ -14917,6 +16388,11 @@ strip-bom@^3.0.0:
   resolved "https://registry.yarnpkg.com/strip-bom/-/strip-bom-3.0.0.tgz#2334c18e9c759f7bdd56fdef7e9ae3d588e68ed3"
   integrity sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA==
 
+strip-bom@^4.0.0:
+  version "4.0.0"
+  resolved "https://registry.yarnpkg.com/strip-bom/-/strip-bom-4.0.0.tgz#9c3505c1db45bcedca3d9cf7a16f5c5aa3901878"
+  integrity sha512-3xurFv5tEgii33Zi8Jtp55wEIILR9eh34FAW00PZf+JnSsTmV/ioewSgQl97JHvgjoRGwPShsWm+IdrxB35d0w==
+
 strip-eof@^1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/strip-eof/-/strip-eof-1.0.0.tgz#bb43ff5598a6eb05d89b59fcd129c983313606bf"
@@ -15047,7 +16523,7 @@ supports-color@^7.0.0, supports-color@^7.1.0:
   dependencies:
     has-flag "^4.0.0"
 
-supports-color@^8.0.0:
+supports-color@^8.0.0, supports-color@^8.1.1:
   version "8.1.1"
   resolved "https://registry.yarnpkg.com/supports-color/-/supports-color-8.1.1.tgz#cd6fc17e28500cff56c1b86c0a7fd4a54a73005c"
   integrity sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==
@@ -15140,6 +16616,13 @@ swap-case@^2.0.2:
   dependencies:
     tslib "^2.0.3"
 
+synckit@^0.11.8:
+  version "0.11.11"
+  resolved "https://registry.yarnpkg.com/synckit/-/synckit-0.11.11.tgz#c0b619cf258a97faa209155d9cd1699b5c998cb0"
+  integrity sha512-MeQTA1r0litLUf0Rp/iisCaL8761lKAZHaimlbGK4j0HysC4PLfqygQj9srcs0m2RdtDYnF8UuYyKpbjHYp7Jw==
+  dependencies:
+    "@pkgr/core" "^0.2.9"
+
 table@^6.0.9:
   version "6.8.0"
   resolved "https://registry.yarnpkg.com/table/-/table-6.8.0.tgz#87e28f14fa4321c3377ba286f07b79b281a3b3ca"
@@ -15218,6 +16701,15 @@ terser@^5.31.1:
     commander "^2.20.0"
     source-map-support "~0.5.20"
 
+test-exclude@^6.0.0:
+  version "6.0.0"
+  resolved "https://registry.yarnpkg.com/test-exclude/-/test-exclude-6.0.0.tgz#04a8698661d805ea6fa293b6cb9e63ac044ef15e"
+  integrity sha512-cAGWPIyOHU6zlmg88jwm7VRyXnMN7iV68OGAbYDk/Mh/xC/pzVPlQtY6ngoIH/5/tciuhGfvESU8GrHrcxD56w==
+  dependencies:
+    "@istanbuljs/schema" "^0.1.2"
+    glob "^7.1.4"
+    minimatch "^3.0.4"
+
 text-table@^0.2.0:
   version "0.2.0"
   resolved "https://registry.yarnpkg.com/text-table/-/text-table-0.2.0.tgz#7f5ee823ae805207c00af2df4a84ec3fcfa570b4"
@@ -15291,6 +16783,11 @@ tmp@^0.2.1:
   dependencies:
     rimraf "^3.0.0"
 
+tmpl@1.0.5:
+  version "1.0.5"
+  resolved "https://registry.yarnpkg.com/tmpl/-/tmpl-1.0.5.tgz#8683e0b902bb9c20c4f726e3c0b69f36518c07cc"
+  integrity sha512-3f0uOEAQwIqGuWW2MVzYg8fV/QNnc/IpuJNG837rLuczAaLVHslWHZQj4IGiEl5Hs3kkbhwL9Ab7Hrsmuj+Smw==
+
 to-fast-properties@^1.0.3:
   version "1.0.3"
   resolved "https://registry.yarnpkg.com/to-fast-properties/-/to-fast-properties-1.0.3.tgz#b83571fa4d8c25b82e231b06e3a3055de4ca1a47"
@@ -15378,6 +16875,21 @@ trough@^1.0.0:
   resolved "https://registry.yarnpkg.com/true-case-path/-/true-case-path-2.2.1.tgz#c5bf04a5bbec3fd118be4084461b3a27c4d796bf"
   integrity sha512-0z3j8R7MCjy10kc/g+qg7Ln3alJTodw9aDuVWZa3uiWqfuBMKeAeP2ocWcxoyM3D73yz3Jt/Pu4qPr4wHSdB/Q==
 
+ts-jest@^29.4.6:
+  version "29.4.6"
+  resolved "https://registry.yarnpkg.com/ts-jest/-/ts-jest-29.4.6.tgz#51cb7c133f227396818b71297ad7409bb77106e9"
+  integrity sha512-fSpWtOO/1AjSNQguk43hb/JCo16oJDnMJf3CdEGNkqsEX3t0KX96xvyX1D7PfLCpVoKu4MfVrqUkFyblYoY4lA==
+  dependencies:
+    bs-logger "^0.2.6"
+    fast-json-stable-stringify "^2.1.0"
+    handlebars "^4.7.8"
+    json5 "^2.2.3"
+    lodash.memoize "^4.1.2"
+    make-error "^1.3.6"
+    semver "^7.7.3"
+    type-fest "^4.41.0"
+    yargs-parser "^21.1.1"
+
 ts-morph@^9.1.0:
   version "9.1.0"
   resolved "https://registry.yarnpkg.com/ts-morph/-/ts-morph-9.1.0.tgz#10d2088387c71f3c674f82492a3cec1e3538f0dd"
@@ -15457,6 +16969,11 @@ type-check@^0.4.0, type-check@~0.4.0:
   dependencies:
     prelude-ls "^1.2.1"
 
+type-detect@4.0.8:
+  version "4.0.8"
+  resolved "https://registry.yarnpkg.com/type-detect/-/type-detect-4.0.8.tgz#7646fb5f18871cfbb7749e69bd39a6388eb7450c"
+  integrity sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==
+
 type-fest@^0.13.1:
   version "0.13.1"
   resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-0.13.1.tgz#0172cb5bce80b0bd542ea348db50c7e21834d934"
@@ -15482,6 +16999,11 @@ type-fest@^0.8.0, type-fest@^0.8.1:
   resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-0.8.1.tgz#09e249ebde851d3b1e48d27c105444667f17b83d"
   integrity sha512-4dbzIzqvjtgiM5rw1k5rEHtBANKmdudhGyBEajN01fEyhaAIhsoKNy6y7+IN93IfpFtwY9iqi7kD+xwKhQsNJA==
 
+type-fest@^4.41.0:
+  version "4.41.0"
+  resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-4.41.0.tgz#6ae1c8e5731273c2bf1f58ad39cbae2c91a46c58"
+  integrity sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA==
+
 type-is@^1.6.4, type-is@~1.6.18:
   version "1.6.18"
   resolved "https://registry.yarnpkg.com/type-is/-/type-is-1.6.18.tgz#4e552cd05df09467dcbc4ef739de89f2cf37c131"
@@ -15577,6 +17099,11 @@ ua-parser-js@^0.7.30:
   resolved "https://registry.yarnpkg.com/ua-parser-js/-/ua-parser-js-0.7.31.tgz#649a656b191dffab4f21d5e053e27ca17cbff5c6"
   integrity sha512-qLK/Xe9E2uzmYI3qLeOmI0tEOt+TBBQyUIAh4aAgU05FVYzeZrKUdkAZfBNVGRaHVgV0TDkdEngJSw/SyQchkQ==
 
+uglify-js@^3.1.4:
+  version "3.19.3"
+  resolved "https://registry.yarnpkg.com/uglify-js/-/uglify-js-3.19.3.tgz#82315e9bbc6f2b25888858acd1fff8441035b77f"
+  integrity sha512-v3Xu+yuwBXisp6QYTcH4UbH+xYJXqnq2m/LtQVWKWzYc1iehYnLixoQDN9FH6/j9/oybfd6W9Ghwkl8+UMKTKQ==
+
 unbox-primitive@^1.0.2:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/unbox-primitive/-/unbox-primitive-1.0.2.tgz#29032021057d5e6cdbd08c5129c226dff8ed6f9e"
@@ -15610,6 +17137,11 @@ underscore.string@^3.3.5:
     sprintf-js "^1.1.1"
     util-deprecate "^1.0.2"
 
+undici-types@~7.16.0:
+  version "7.16.0"
+  resolved "https://registry.yarnpkg.com/undici-types/-/undici-types-7.16.0.tgz#ffccdff36aea4884cbfce9a750a0580224f58a46"
+  integrity sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==
+
 unherit@^1.0.4:
   version "1.1.3"
   resolved "https://registry.yarnpkg.com/unherit/-/unherit-1.1.3.tgz#6c9b503f2b41b262330c80e91c8614abdaa69c22"
@@ -15868,6 +17400,33 @@ unquote@~1.1.1:
   resolved "https://registry.yarnpkg.com/unquote/-/unquote-1.1.1.tgz#8fded7324ec6e88a0ff8b905e7c098cdc086d544"
   integrity sha512-vRCqFv6UhXpWxZPyGDh/F3ZpNv8/qo7w6iufLpQg9aKnQ71qM4B5KiI7Mia9COcjEhrO9LueHpMYjYzsWH3OIg==
 
+unrs-resolver@^1.7.11:
+  version "1.11.1"
+  resolved "https://registry.yarnpkg.com/unrs-resolver/-/unrs-resolver-1.11.1.tgz#be9cd8686c99ef53ecb96df2a473c64d304048a9"
+  integrity sha512-bSjt9pjaEBnNiGgc9rUiHGKv5l4/TGzDmYw3RhnkJGtLhbnnA/5qJj7x3dNDCRx/PJxu774LlH8lCOlB4hEfKg==
+  dependencies:
+    napi-postinstall "^0.3.0"
+  optionalDependencies:
+    "@unrs/resolver-binding-android-arm-eabi" "1.11.1"
+    "@unrs/resolver-binding-android-arm64" "1.11.1"
+    "@unrs/resolver-binding-darwin-arm64" "1.11.1"
+    "@unrs/resolver-binding-darwin-x64" "1.11.1"
+    "@unrs/resolver-binding-freebsd-x64" "1.11.1"
+    "@unrs/resolver-binding-linux-arm-gnueabihf" "1.11.1"
+    "@unrs/resolver-binding-linux-arm-musleabihf" "1.11.1"
+    "@unrs/resolver-binding-linux-arm64-gnu" "1.11.1"
+    "@unrs/resolver-binding-linux-arm64-musl" "1.11.1"
+    "@unrs/resolver-binding-linux-ppc64-gnu" "1.11.1"
+    "@unrs/resolver-binding-linux-riscv64-gnu" "1.11.1"
+    "@unrs/resolver-binding-linux-riscv64-musl" "1.11.1"
+    "@unrs/resolver-binding-linux-s390x-gnu" "1.11.1"
+    "@unrs/resolver-binding-linux-x64-gnu" "1.11.1"
+    "@unrs/resolver-binding-linux-x64-musl" "1.11.1"
+    "@unrs/resolver-binding-wasm32-wasi" "1.11.1"
+    "@unrs/resolver-binding-win32-arm64-msvc" "1.11.1"
+    "@unrs/resolver-binding-win32-ia32-msvc" "1.11.1"
+    "@unrs/resolver-binding-win32-x64-msvc" "1.11.1"
+
 update-browserslist-db@^1.0.5:
   version "1.0.5"
   resolved "https://registry.yarnpkg.com/update-browserslist-db/-/update-browserslist-db-1.0.5.tgz#be06a5eedd62f107b7c19eb5bcefb194411abf38"
@@ -16023,6 +17582,15 @@ v8-compile-cache@^2.0.3:
   resolved "https://registry.yarnpkg.com/v8-compile-cache/-/v8-compile-cache-2.3.0.tgz#2de19618c66dc247dcfb6f99338035d8245a2cee"
   integrity sha512-l8lCEmLcLYZh4nbunNZvQCJc5pv7+RCwa8q/LdUx8u7lsWvPDKmpodJAJNwkAhJC//dFY48KuIEmjtd4RViDrA==
 
+v8-to-istanbul@^9.0.1:
+  version "9.3.0"
+  resolved "https://registry.yarnpkg.com/v8-to-istanbul/-/v8-to-istanbul-9.3.0.tgz#b9572abfa62bd556c16d75fdebc1a411d5ff3175"
+  integrity sha512-kiGUalWN+rgBJ/1OHZsBtU4rXZOfj/7rKQxULKlIzwzQSvMJUUNgPwJEEh7gU6xEVxC0ahoOBvN2YI8GH6FNgA==
+  dependencies:
+    "@jridgewell/trace-mapping" "^0.3.12"
+    "@types/istanbul-lib-coverage" "^2.0.1"
+    convert-source-map "^2.0.0"
+
 valid-url@^1.0.9:
   version "1.0.9"
   resolved "https://registry.yarnpkg.com/valid-url/-/valid-url-1.0.9.tgz#1c14479b40f1397a75782f115e4086447433a200"
@@ -16114,6 +17682,13 @@ void-elements@3.1.0:
   resolved "https://registry.yarnpkg.com/void-elements/-/void-elements-3.1.0.tgz#614f7fbf8d801f0bb5f0661f5b2f5785750e4f09"
   integrity sha512-Dhxzh5HZuiHQhbvTW9AMetFfBHDMYpo23Uo9btPXgdYP+3T5S+p+jgNy7spra+veYhBP2dCSgxR/i2Y02h5/6w==
 
+walker@^1.0.8:
+  version "1.0.8"
+  resolved "https://registry.yarnpkg.com/walker/-/walker-1.0.8.tgz#bd498db477afe573dc04185f011d3ab8a8d7653f"
+  integrity sha512-ts/8E8l5b7kY0vlWLewOkDXMmPdLcVV4GmOQLyxuSswIJsweeFZtAsMF7k1Nszz+TYBQrlYRmzOnr398y1JemQ==
+  dependencies:
+    makeerror "1.0.12"
+
 watchpack@^2.4.1:
   version "2.4.2"
   resolved "https://registry.yarnpkg.com/watchpack/-/watchpack-2.4.2.tgz#2feeaed67412e7c33184e5a79ca738fbd38564da"
@@ -16337,6 +17912,20 @@ word-wrap@^1.2.3:
   resolved "https://registry.yarnpkg.com/word-wrap/-/word-wrap-1.2.3.tgz#610636f6b1f703891bd34771ccb17fb93b47079c"
   integrity sha512-Hz/mrNwitNRh/HUAtM/VT/5VH+ygD6DV7mYKZAtHOrbs8U7lvPS6xf7EJKMF0uW1KJCl0H701g3ZGus+muE5vQ==
 
+wordwrap@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/wordwrap/-/wordwrap-1.0.0.tgz#27584810891456a4171c8d0226441ade90cbcaeb"
+  integrity sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==
+
+"wrap-ansi-cjs@npm:wrap-ansi@^7.0.0":
+  version "7.0.0"
+  resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-7.0.0.tgz#67e145cff510a6a6984bdf1152911d69d2eb9e43"
+  integrity sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==
+  dependencies:
+    ansi-styles "^4.0.0"
+    string-width "^4.1.0"
+    strip-ansi "^6.0.0"
+
 wrap-ansi@^6.2.0:
   version "6.2.0"
   resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-6.2.0.tgz#e9393ba07102e6c91a3b221478f0257cd2856e53"
@@ -16355,6 +17944,15 @@ wrap-ansi@^7.0.0:
     string-width "^4.1.0"
     strip-ansi "^6.0.0"
 
+wrap-ansi@^8.1.0:
+  version "8.1.0"
+  resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-8.1.0.tgz#56dc22368ee570face1b49819975d9b9a5ead214"
+  integrity sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==
+  dependencies:
+    ansi-styles "^6.1.0"
+    string-width "^5.0.1"
+    strip-ansi "^7.0.1"
+
 wrappy@1:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/wrappy/-/wrappy-1.0.2.tgz#b5243d8f3ec1aa35f1364605bc0d1036e30ab69f"
@@ -16370,6 +17968,14 @@ write-file-atomic@^3.0.0:
     signal-exit "^3.0.2"
     typedarray-to-buffer "^3.1.5"
 
+write-file-atomic@^5.0.1:
+  version "5.0.1"
+  resolved "https://registry.yarnpkg.com/write-file-atomic/-/write-file-atomic-5.0.1.tgz#68df4717c55c6fa4281a7860b4c2ba0a6d2b11e7"
+  integrity sha512-+QU2zd6OTD8XWIJCbffaiQeH9U73qIqafo1x6V1snCWYGJf6cVE0cDR4D8xRzcEnfI21IFrUPzPGtcPf8AC+Rw==
+  dependencies:
+    imurmurhash "^0.1.4"
+    signal-exit "^4.0.1"
+
 ws@~8.2.3:
   version "8.2.3"
   resolved "https://registry.yarnpkg.com/ws/-/ws-8.2.3.tgz#63a56456db1b04367d0b721a0b80cae6d8becbba"
@@ -16525,6 +18131,11 @@ yargs-parser@^21.0.0:
   resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-21.0.0.tgz#a485d3966be4317426dd56bdb6a30131b281dc55"
   integrity sha512-z9kApYUOCwoeZ78rfRYYWdiU/iNL6mwwYlkkZfJoyMR1xps+NEBX5X7XmRpxkZHhXJ6+Ey00IwKxBBSW9FIjyA==
 
+yargs-parser@^21.1.1:
+  version "21.1.1"
+  resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-21.1.1.tgz#9096bceebf990d21bb31fa9516e0ede294a77d35"
+  integrity sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==
+
 yargs@^15.3.1, yargs@^15.4.1:
   version "15.4.1"
   resolved "https://registry.yarnpkg.com/yargs/-/yargs-15.4.1.tgz#0d87a16de01aee9d8bec2bfbf74f67851730f4f8"
@@ -16555,6 +18166,19 @@ yargs@^17.0.1:
     y18n "^5.0.5"
     yargs-parser "^21.0.0"
 
+yargs@^17.7.2:
+  version "17.7.2"
+  resolved "https://registry.yarnpkg.com/yargs/-/yargs-17.7.2.tgz#991df39aca675a192b816e1e0363f9d75d2aa269"
+  integrity sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==
+  dependencies:
+    cliui "^8.0.1"
+    escalade "^3.1.1"
+    get-caller-file "^2.0.5"
+    require-directory "^2.1.1"
+    string-width "^4.2.3"
+    y18n "^5.0.5"
+    yargs-parser "^21.1.1"
+
 yn@3.1.1:
   version "3.1.1"
   resolved "https://registry.yarnpkg.com/yn/-/yn-3.1.1.tgz#1e87401a09d767c1d5eab26a6e4c185182d2eb50"