From afbadbede9a30811de9c3d0aa020c848312eb1df Mon Sep 17 00:00:00 2001
From: Triumph-light <2495685883@qq.com>
Date: Mon, 15 Jun 2026 20:49:32 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=94=AF=E6=8C=81=E6=A8=A1=E7=89=88?=
 =?UTF-8?q?=E6=A0=87=E7=AD=BE=E7=9A=84=E5=8F=B3=E9=94=AE=E6=9F=A5=E7=9C=8B?=
 =?UTF-8?q?=E5=AE=9A=E4=B9=89=E7=9A=84=E8=B7=B3=E8=BD=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../src/plugins/mpx-sfc-template-links.ts     | 221 ++++++++++++++----
 1 file changed, 174 insertions(+), 47 deletions(-)

diff --git a/packages/language-service/src/plugins/mpx-sfc-template-links.ts b/packages/language-service/src/plugins/mpx-sfc-template-links.ts
index b4bf627..4c7e95e 100644
--- a/packages/language-service/src/plugins/mpx-sfc-template-links.ts
+++ b/packages/language-service/src/plugins/mpx-sfc-template-links.ts
@@ -1,7 +1,14 @@
 import type * as vscode from 'vscode-languageserver-protocol'
-import type { LanguageServicePlugin } from '@volar/language-service'
+import type {
+  LanguageServiceContext,
+  LanguageServicePlugin,
+} from '@volar/language-service'
 import { URI } from 'vscode-uri'
-import { MpxVirtualCode, Sfc, tsCodegen } from '@mpxjs/language-core'
+import {
+  MpxVirtualCode,
+  SfcJsonBlockUsingComponents,
+  tsCodegen,
+} from '@mpxjs/language-core'
 import { isMpPluginComponentPath } from '../utils'
 
 export function create(): LanguageServicePlugin {
@@ -10,27 +17,23 @@ export function create(): LanguageServicePlugin {
 
     capabilities: {
       documentLinkProvider: {},
+      definitionProvider: true,
     },
 
     create(context) {
       return {
         async provideDocumentLinks(document) {
-          const uri = URI.parse(document.uri)
-          const decoded = context.decodeEmbeddedDocumentUri(uri)
-          if (!decoded) {
-            return
-          }
-          const [documentUri, embeddedCodeId] = decoded
-          const sourceScript = context.language.scripts.get(documentUri)
-          const virtualCode =
-            sourceScript?.generated?.embeddedCodes.get(embeddedCodeId)
-          if (!sourceScript?.generated || virtualCode?.id !== 'template') {
-            return
-          }
-          const root = sourceScript.generated.root
-          if (!(root instanceof MpxVirtualCode)) {
+          const tplCtx = await resolveTemplateContext(context, document.uri)
+          if (!tplCtx) {
             return
           }
+          const {
+            decoded,
+            sourceScript,
+            root,
+            templateNodeTags,
+            usingComponents,
+          } = tplCtx
 
           const result: vscode.DocumentLink[] = []
           const { sfc } = root
@@ -43,7 +46,7 @@ export function create(): LanguageServicePlugin {
             string,
             {
               index: number
-              style: Sfc['styles'][number]
+              style: (typeof sfc.styles)[number]
               classOffset: number
             }[]
           >()
@@ -71,11 +74,11 @@ export function create(): LanguageServicePlugin {
             if (styles) {
               for (const style of styles) {
                 const styleDocumentUri = context.encodeEmbeddedDocumentUri(
-                  decoded![0],
+                  decoded[0],
                   'style_' + style.index,
                 )
                 const styleVirtualCode =
-                  sourceScript.generated.embeddedCodes.get(
+                  sourceScript.generated!.embeddedCodes.get(
                     'style_' + style.index,
                   )
                 if (!styleVirtualCode) {
@@ -97,7 +100,7 @@ export function create(): LanguageServicePlugin {
                   },
                   target:
                     context.encodeEmbeddedDocumentUri(
-                      decoded![0],
+                      decoded[0],
                       'style_' + style.index,
                     ) +
                     `#L${start.line + 1},${start.character + 1}-L${end.line + 1},${end.character + 1}`,
@@ -108,10 +111,6 @@ export function create(): LanguageServicePlugin {
           // #endregion
 
           // #region document link for component tag
-          const templateNodeTags =
-            codegen?.getGeneratedTemplate()?.templateNodeTags ?? []
-          const { result: usingComponents } =
-            (await sfc.json?.resolvedUsingComponents) || {}
           if (usingComponents?.size) {
             for (const nodeTag of templateNodeTags) {
               const {
@@ -122,29 +121,9 @@ export function create(): LanguageServicePlugin {
               if (!usingComponents.has(componentTag) || !startTagOffset) {
                 continue
               }
-              const rawComponentPaths = usingComponents.get(componentTag)!
-
-              // 根据 text 字段去重，创建一个映射表保存唯一的路径
-              const uniqueComponentMap = new Map<
-                string,
-                {
-                  componentPath: string
-                  targetFilePath: string
-                  id: number
-                }
-              >()
-
-              let _index = 1
-              rawComponentPaths.forEach(path => {
-                if (!uniqueComponentMap.has(path.text) && path.realFilename) {
-                  uniqueComponentMap.set(path.text, {
-                    componentPath: path.text,
-                    targetFilePath: path.realFilename,
-                    id: _index++,
-                  })
-                }
-              })
-
+              const uniqueComponentMap = dedupeComponentPaths(
+                usingComponents.get(componentTag)!,
+              )
               const uniqueComponentCount = uniqueComponentMap.size
 
               for (const [
@@ -181,7 +160,155 @@ export function create(): LanguageServicePlugin {
 
           return result
         },
+
+        /**
+         * 在 <template> 中对自定义组件标签提供「转到定义」(F12 / 右键转到定义)。
+         * documentLinkProvider 仅响应 Ctrl/Cmd 点击,不参与 LSP textDocument/definition,
+         * 所以基于同样的 templateNodeTags + resolvedUsingComponents 再提供一份。
+         */
+        async provideDefinition(document, position) {
+          const tplCtx = await resolveTemplateContext(context, document.uri)
+          if (!tplCtx) {
+            return
+          }
+          const { templateNodeTags, usingComponents } = tplCtx
+          if (!usingComponents?.size || !templateNodeTags.length) {
+            return
+          }
+
+          const offset = document.offsetAt(position)
+          const definitions: vscode.LocationLink[] = []
+
+          for (const nodeTag of templateNodeTags) {
+            const { name: componentTag } = nodeTag
+            if (!usingComponents.has(componentTag)) {
+              continue
+            }
+            const hitOffset = getTagHitOffset(nodeTag, offset)
+            if (hitOffset == null) {
+              continue
+            }
+
+            const uniqueComponentMap = dedupeComponentPaths(
+              usingComponents.get(componentTag)!,
+            )
+            for (const [
+              componentPath,
+              { targetFilePath },
+            ] of uniqueComponentMap) {
+              if (isMpPluginComponentPath(componentPath)) continue
+              definitions.push({
+                originSelectionRange: {
+                  start: document.positionAt(hitOffset),
+                  end: document.positionAt(hitOffset + componentTag.length),
+                },
+                targetUri: URI.file(targetFilePath).toString(),
+                targetRange: {
+                  start: { line: 0, character: 0 },
+                  end: { line: 0, character: 0 },
+                },
+                targetSelectionRange: {
+                  start: { line: 0, character: 0 },
+                  end: { line: 0, character: 0 },
+                },
+              })
+            }
+            // 命中且已收集完成,无需继续遍历
+            if (definitions.length) break
+          }
+
+          return definitions.length ? definitions : undefined
+        },
       }
     },
   }
 }
+
+interface TemplateNodeTag {
+  name: string
+  startTagOffset?: number
+  endTagOffset?: number
+}
+
+/**
+ * 解析 template 嵌入块的公共上下文,documentLink 与 definition 共用。
+ * 非 template 嵌入块或非 MpxVirtualCode 时返回 null。
+ */
+async function resolveTemplateContext(
+  context: LanguageServiceContext,
+  rawUri: string,
+) {
+  const uri = URI.parse(rawUri)
+  const decoded = context.decodeEmbeddedDocumentUri(uri)
+  if (!decoded) return null
+  const [documentUri, embeddedCodeId] = decoded
+  const sourceScript = context.language.scripts.get(documentUri)
+  const virtualCode = sourceScript?.generated?.embeddedCodes.get(embeddedCodeId)
+  if (!sourceScript?.generated || virtualCode?.id !== 'template') {
+    return null
+  }
+  const root = sourceScript.generated.root
+  if (!(root instanceof MpxVirtualCode)) {
+    return null
+  }
+  const codegen = tsCodegen.get(root.sfc)
+  const templateNodeTags: TemplateNodeTag[] =
+    codegen?.getGeneratedTemplate()?.templateNodeTags ?? []
+  const { result: usingComponents } =
+    (await root.sfc.json?.resolvedUsingComponents) || {}
+
+  return {
+    decoded,
+    sourceScript,
+    root,
+    templateNodeTags,
+    usingComponents: usingComponents as SfcJsonBlockUsingComponents | undefined,
+  }
+}
+
+/**
+ * 判断光标是否落在标签名 range(开始或结束标签)内,返回对应起始 offset。
+ */
+function getTagHitOffset(
+  nodeTag: TemplateNodeTag,
+  cursorOffset: number,
+): number | null {
+  const { name, startTagOffset, endTagOffset } = nodeTag
+  if (
+    startTagOffset != null &&
+    cursorOffset >= startTagOffset &&
+    cursorOffset <= startTagOffset + name.length
+  ) {
+    return startTagOffset
+  }
+  if (
+    endTagOffset != null &&
+    cursorOffset >= endTagOffset &&
+    cursorOffset <= endTagOffset + name.length
+  ) {
+    return endTagOffset
+  }
+  return null
+}
+
+/**
+ * 按 text 去重,丢弃没有 realFilename 的项,并记录序号便于 tooltip 标注来源。
+ */
+function dedupeComponentPaths(
+  rawComponentPaths: { text: string; realFilename?: string }[],
+): Map<string, { componentPath: string; targetFilePath: string; id: number }> {
+  const map = new Map<
+    string,
+    { componentPath: string; targetFilePath: string; id: number }
+  >()
+  let id = 1
+  for (const path of rawComponentPaths) {
+    if (!path.realFilename || map.has(path.text)) continue
+    map.set(path.text, {
+      componentPath: path.text,
+      targetFilePath: path.realFilename,
+      id: id++,
+    })
+  }
+  return map
+}