Fix docs lint issues and reuse setup action in release workflow

Author: TrueNine

.github/actions/setup-node-pnpm/action.yml

@@ -10,6 +10,10 @@ inputs:
     description: pnpm version
     required: false
     default: "10.33.0"
+  registry-url:
+    description: Optional npm registry URL to configure for npm publish/auth steps
+    required: false
+    default: ""
   install:
     description: Whether to run pnpm install
     required: false
@@ -29,6 +33,7 @@ runs:
         node-version: ${{ inputs.node-version }}
         cache: pnpm
         cache-dependency-path: pnpm-lock.yaml
+        registry-url: ${{ inputs.registry-url }}
 
     - name: Install workspace dependencies
       if: inputs.install == 'true'

.github/workflows/release-cli.yml

@@ -1,7 +1,6 @@
 name: Release Packages
 
 env:
-  NODE_VERSION: "25.6.1"
   NPM_REGISTRY_URL: https://registry.npmjs.org/
   NPM_PUBLISH_VERIFY_ATTEMPTS: "90"
   NPM_PUBLISH_VERIFY_DELAY_SECONDS: "10"
@@ -57,9 +56,9 @@ jobs:
       version: ${{ steps.check.outputs.version }}
     steps:
       - uses: actions/checkout@v6
-      - uses: actions/setup-node@v6
+      - uses: ./.github/actions/setup-node-pnpm
         with:
-          node-version: ${{ env.NODE_VERSION }}
+          install: "false"
 
       - name: Check if should publish
         id: check
@@ -240,10 +239,6 @@ jobs:
       - uses: ./.github/actions/setup-node-pnpm
         with:
           install: "true"
-      - name: Setup npm registry
-        uses: actions/setup-node@v6
-        with:
-          node-version: ${{ env.NODE_VERSION }}
           registry-url: https://registry.npmjs.org/
       - name: Preflight npm auth
         shell: bash
@@ -464,10 +459,7 @@ jobs:
     steps:
       - uses: actions/checkout@v6
       - uses: ./.github/actions/setup-node-pnpm
-      - name: Setup npm registry
-        uses: actions/setup-node@v6
         with:
-          node-version: ${{ env.NODE_VERSION }}
           registry-url: https://registry.npmjs.org/
       - name: Preflight npm auth
         shell: bash
@@ -590,10 +582,7 @@ jobs:
     steps:
       - uses: actions/checkout@v6
       - uses: ./.github/actions/setup-node-pnpm
-      - name: Setup npm registry
-        uses: actions/setup-node@v6
         with:
-          node-version: ${{ env.NODE_VERSION }}
           registry-url: https://registry.npmjs.org/
       - name: Preflight npm auth
         shell: bash

doc/app/docs/[[...mdxPath]]/layout.tsx

@@ -16,7 +16,7 @@ export default async function DocsLayout({
   const firstSegment = params.mdxPath?.[0]
   const section = firstSegment != null && isDocSectionName(firstSegment)
     ? firstSegment
-    : undefined
+    : void 0
   const pageMap = await getPageMap(section ? `/docs/${section}` : '/docs')
 
   return (

doc/app/layout.tsx

@@ -1,55 +1,55 @@
-import type { Metadata } from "next";
-import { Inter, JetBrains_Mono } from "next/font/google";
-import { getSiteUrl, siteConfig } from "../lib/site";
-import "nextra-theme-docs/style.css";
-import "./globals.scss";
+import type {Metadata} from 'next'
+import {Inter, JetBrains_Mono} from 'next/font/google'
+import {getSiteUrl, siteConfig} from '../lib/site'
+import 'nextra-theme-docs/style.css'
+import './globals.scss'
 
 const sans = Inter({
-  variable: "--font-sans",
+  variable: '--font-sans',
   preload: true,
-  subsets: ["latin"],
-});
+  subsets: ['latin']
+})
 
 const mono = JetBrains_Mono({
-  variable: "--font-mono",
-  subsets: ["latin"],
-  preload: true,
-});
+  variable: '--font-mono',
+  subsets: ['latin'],
+  preload: true
+})
 
 export const metadata: Metadata = {
   metadataBase: getSiteUrl(),
   title: {
     default: siteConfig.title,
-    template: `%s | ${siteConfig.productName}`,
+    template: `%s | ${siteConfig.productName}`
   },
   description: siteConfig.description,
   applicationName: siteConfig.shortName,
   alternates: {
-    canonical: "/",
+    canonical: '/'
   },
-  category: "developer tools",
-  manifest: "/manifest.webmanifest",
+  category: 'developer tools',
+  manifest: '/manifest.webmanifest',
   openGraph: {
-    type: "website",
-    url: "/",
+    type: 'website',
+    url: '/',
     title: siteConfig.title,
     description: siteConfig.description,
     siteName: siteConfig.title,
-    locale: "zh_CN",
+    locale: 'zh_CN'
   },
   twitter: {
-    card: "summary_large_image",
+    card: 'summary_large_image',
     title: siteConfig.title,
-    description: siteConfig.description,
-  },
-};
+    description: siteConfig.description
+  }
+}
 
-export default function RootLayout({ children }: { readonly children: React.ReactNode }) {
+export default function RootLayout({children}: {readonly children: React.ReactNode}) {
   return (
-    <html lang="zh-CN" className="dark" style={{ colorScheme: "dark", backgroundColor: "#0b0c10" }} suppressHydrationWarning>
+    <html lang="zh-CN" className="dark" style={{colorScheme: 'dark', backgroundColor: '#0b0c10'}} suppressHydrationWarning>
       <body className={`${sans.variable} ${mono.variable}`} suppressHydrationWarning>
         {children}
       </body>
     </html>
-  );
+  )
 }

doc/components/docs-callout.tsx

@@ -44,7 +44,7 @@ function getMeaningfulChildren(children: ReactNode): ReactNode[] {
 function stripMarkerFromChildren(children: ReactNode): ReactNode {
   const items = getMeaningfulChildren(children)
 
-  return items.map((item, index) => {
+  return items.map(async (item, index) => {
     if (index !== 0) {
       return item
     }
@@ -74,14 +74,10 @@ function stripMarkerFromChildren(children: ReactNode): ReactNode {
 function resolveCalloutTone(children: ReactNode): CalloutTone | null {
   const firstChild = getMeaningfulChildren(children)[0]
   const firstText = extractText(firstChild).trimStart()
-  const matched = firstText.match(CALLOUT_PATTERN)?.[1]?.toLowerCase()
+  const matched = CALLOUT_PATTERN.exec(firstText)?.[1]?.toLowerCase()
 
   if (
-    matched === 'note'
-    || matched === 'tip'
-    || matched === 'important'
-    || matched === 'warning'
-    || matched === 'caution'
+    new Set(['note', 'tip', 'important', 'warning', 'caution']).has(matched)
   ) {
     return matched
   }

doc/components/home-contributors.tsx

@@ -1,6 +1,7 @@
-import {siteConfig} from '../lib/site'
 import {execFileSync} from 'node:child_process'
 import path from 'node:path'
+import process from 'node:process'
+import {siteConfig} from '../lib/site'
 
 interface GitHubContributor {
   readonly avatar_url: string
@@ -44,10 +45,12 @@ const CONTRIBUTORS_PER_PAGE = 100
 const MAX_CONTRIBUTOR_PAGES = 10
 const CONTRIBUTORS_REVALIDATE_SECONDS = 60 * 60 * 12
 const REPO_ROOT = path.resolve(process.cwd(), '..')
+const LEADING_SLASHES_PATTERN = /^\/+/
+const CO_AUTHOR_PREFIX = 'co-authored-by:'
 
 function getRepoCoordinates(repoUrl: string) {
   const url = new URL(repoUrl)
-  const [owner, repo] = url.pathname.replace(/^\/+/, '').split('/')
+  const [owner, repo] = url.pathname.replace(LEADING_SLASHES_PATTERN, '').split('/')
 
   if (!owner || !repo) {
     throw new Error(`Invalid GitHub repository URL: ${repoUrl}`)
@@ -58,10 +61,13 @@ function getRepoCoordinates(repoUrl: string) {
 
 function getGitHubHeaders() {
   const token = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN
+  const authorization = token != null && token !== ''
+    ? {Authorization: `Bearer ${token}`}
+    : {}
 
   return {
     Accept: 'application/vnd.github+json',
-    ...(token ? {Authorization: `Bearer ${token}`} : {})
+    ...authorization
   }
 }
 
@@ -117,20 +123,36 @@ async function fetchGitHubUser(login: string): Promise<ResolvedGitHubUser | null
 }
 
 function parseCoAuthors(message: string) {
-  const matches = message.matchAll(/^Co-authored-by:\s+(.+?)\s+<(.+?)>$/gim)
   const coAuthors: CoAuthorIdentity[] = []
 
-  for (const match of matches) {
-    const [, name, email] = match
+  for (const rawLine of message.split('\n')) {
+    const line = rawLine.trim()
 
-    if (!name || !email) {
+    if (!line.toLowerCase().startsWith(CO_AUTHOR_PREFIX)) {
+      continue
+    }
+
+    const footer = line.slice(CO_AUTHOR_PREFIX.length).trim()
+    const openAngleBracketIndex = footer.lastIndexOf('<')
+    const closeAngleBracketIndex = footer.endsWith('>')
+      ? footer.length - 1
+      : -1
+
+    if (openAngleBracketIndex <= 0 || closeAngleBracketIndex <= openAngleBracketIndex) {
+      continue
+    }
+
+    const name = footer.slice(0, openAngleBracketIndex).trim()
+    const email = footer.slice(openAngleBracketIndex + 1, closeAngleBracketIndex).trim()
+
+    if (name === '' || email === '') {
       continue
     }
 
     coAuthors.push({
       count: 1,
-      email: email.trim(),
-      name: name.trim()
+      email,
+      name
     })
   }
 
@@ -167,7 +189,7 @@ function getCoAuthorSearchQueries(identity: CoAuthorIdentity) {
 
   queries.push(`${identity.name} in:login`)
 
-  return Array.from(new Set(queries))
+  return [...new Set(queries)]
 }
 
 function getKnownCoAuthorProfile(identity: CoAuthorIdentity): KnownCoAuthorProfile | null {
@@ -252,7 +274,7 @@ async function getCoAuthors() {
     }
   }
 
-  return Array.from(coAuthors.values()).sort((left, right) => right.count - left.count)
+  return [...coAuthors.values()].sort((left, right) => right.count - left.count)
 }
 
 async function resolveCoAuthor(identity: CoAuthorIdentity) {
@@ -355,34 +377,33 @@ async function getContributorCards() {
     cards.set(key, value)
   }
 
-  return Array.from(cards.values())
-    .map(contributor => {
-      if (contributor.htmlUrl === 'https://github.com/cursoragent') {
-        return {
-          ...contributor,
-          kind: 'agent' as const,
-          label: 'cursoragent'
-        }
+  return Array.from(cards.values(), contributor => {
+    if (contributor.htmlUrl === 'https://github.com/cursoragent') {
+      return {
+        ...contributor,
+        kind: 'agent' as const,
+        label: 'cursoragent'
       }
+    }
 
-      if (contributor.htmlUrl === 'https://github.com/anthropics-claude-code') {
-        return {
-          ...contributor,
-          kind: 'agent' as const,
-          label: 'Claude Code'
-        }
+    if (contributor.htmlUrl === 'https://github.com/anthropics-claude-code') {
+      return {
+        ...contributor,
+        kind: 'agent' as const,
+        label: 'Claude Code'
       }
+    }
 
-      if (contributor.htmlUrl === 'https://github.com/windsurf') {
-        return {
-          ...contributor,
-          kind: 'agent' as const,
-          label: 'Windsurf'
-        }
+    if (contributor.htmlUrl === 'https://github.com/windsurf') {
+      return {
+        ...contributor,
+        kind: 'agent' as const,
+        label: 'Windsurf'
       }
+    }
 
-      return contributor
-    })
+    return contributor
+  })
     .sort((left, right) => right.sortWeight - left.sortWeight)
 }
 

doc/components/mermaid.tsx

@@ -153,7 +153,6 @@ export function Mermaid({chart, title}: MermaidProps) {
     }, 1800)
   }
 
-  const hasTitle = title !== void 0 && title !== ''
   const hasSvg = svg !== void 0 && svg !== ''
   const hasError = error !== void 0 && error !== ''
   let diagramBody: ReactNode = <div className="mermaid-diagram__loading">Rendering diagram...</div>

doc/components/package-manager-tabs.tsx

@@ -39,6 +39,8 @@ export function PackageManagerTabs({
 }: PackageManagerTabsProps): ReactNode {
   const instanceId = useId()
   const [selectedManager, setSelectedManager] = useState<PackageManager>(defaultManager)
+  const hasTitle = title !== void 0 && title !== ''
+  const hasDescription = description !== void 0 && description !== null && description !== false
   const tabs: PackageManagerTab[] = TAB_ORDER.map(id => ({
     command: commands[id],
     id,
@@ -55,12 +57,14 @@ export function PackageManagerTabs({
 
   return (
     <section className="docs-package-manager-tabs">
-      {title || description ? (
-        <header className="docs-widget-header">
-          {title ? <h3>{title}</h3> : null}
-          {description ? <p>{description}</p> : null}
-        </header>
-      ) : null}
+      {hasTitle || hasDescription
+        ? (
+            <header className="docs-widget-header">
+              {hasTitle ? <h3>{title}</h3> : null}
+              {hasDescription ? <p>{description}</p> : null}
+            </header>
+          )
+        : null}
       <div className="docs-package-manager-tabs-list" role="tablist" aria-label="Package manager commands">
         {tabs.map(tab => {
           const isSelected = tab.id === activeTab.id
@@ -80,9 +84,9 @@ export function PackageManagerTabs({
               }}
             >
               {tab.label}
-              {tab.id === recommendedManager ? (
-                <span className="docs-package-manager-tab-badge">推荐</span>
-              ) : null}
+              {tab.id === recommendedManager
+                ? <span className="docs-package-manager-tab-badge">推荐</span>
+                : null}
             </button>
           )
         })}

doc/content/sdk/_meta.ts

@@ -1,3 +1,3 @@
 export default {
-  'index': '概览'
+  index: '概览'
 }