@sunshj/vscode-ab5x-utils 0.0.1

package/dist/index.cjs

@@ -0,0 +1,126 @@
+let vscode = require("vscode");
+
+//#region src/index.ts
+/** 创建基于正则的收集函数 */
+function createRegexCollector(regex, setupContextOrTransform, transform) {
+	const hasSetupContext = transform !== void 0;
+	const setupContext = hasSetupContext ? setupContextOrTransform : void 0;
+	const transformFn = hasSetupContext ? transform : setupContextOrTransform;
+	const context = setupContext?.();
+	return (document) => {
+		const items = [];
+		const text = document.getText();
+		const globalRegex = new RegExp(regex.source, regex.flags.includes("g") ? regex.flags : `${regex.flags}g`);
+		let match;
+		while ((match = globalRegex.exec(text)) !== null) if (transformFn) {
+			const item = hasSetupContext ? transformFn(match, context) : transformFn(match);
+			if (item) items.push(item);
+		} else items.push({
+			text: match[0],
+			startIndex: match.index,
+			endIndex: match.index + match[0].length
+		});
+		return items;
+	};
+}
+/** 从匹配项创建 Range */
+function createRange(document, item) {
+	return new vscode.Range(document.positionAt(item.startIndex), document.positionAt(item.endIndex));
+}
+/** 获取匹配项的 extra 数据 */
+function getItemExtra(link) {
+	return link.__extra;
+}
+/** 设置匹配项的 extra 数据到 DocumentLink */
+function setItemExtra(link, extra) {
+	link.__extra = extra;
+}
+/**
+* 定义模式匹配 Provider，统一管理 DocumentLink、Hover、Completion、Decoration、CodeLens 等功能
+*/
+function definePatternProvider(options) {
+	const { selector = { scheme: "file" }, fileFilter = () => true, collect: collectFn, documentLink, hover, completion, decoration, codeLens, commands: commandsConfig } = options;
+	const cache = /* @__PURE__ */ new WeakMap();
+	function collect(document, skipCache = false) {
+		if (!skipCache && cache.has(document.uri)) return cache.get(document.uri);
+		const items = collectFn(document, skipCache);
+		cache.set(document.uri, items);
+		return items;
+	}
+	const decorationType = decoration?.enabled && decoration.style ? vscode.window.createTextEditorDecorationType(decoration.style) : void 0;
+	function createDocumentLinkProvider() {
+		return { provideDocumentLinks(document) {
+			if (!fileFilter(document)) return;
+			return collect(document).map(function(item) {
+				const range = createRange(document, item);
+				const target = documentLink?.target?.(item, document);
+				const link = new vscode.DocumentLink(range, target);
+				link.tooltip = documentLink?.tooltip?.(item, document);
+				setItemExtra(link, item.extra);
+				return link;
+			});
+		} };
+	}
+	function createHoverProvider() {
+		return { provideHover(document, position) {
+			if (!fileFilter(document)) return;
+			const items = collect(document);
+			for (const item of items) {
+				if (!createRange(document, item).contains(position)) continue;
+				return hover?.content(item, document);
+			}
+		} };
+	}
+	function createCompletionProvider() {
+		return { provideCompletionItems(document, position) {
+			if (!fileFilter(document)) return;
+			if (completion?.shouldTrigger && !completion.shouldTrigger(document, position)) return;
+			return completion?.items(document, position);
+		} };
+	}
+	function createCodeLensProvider() {
+		return { provideCodeLenses(document) {
+			if (!fileFilter(document)) return;
+			return collect(document).flatMap((item) => codeLens?.lenses(item, document) ?? []);
+		} };
+	}
+	function register() {
+		const disposables = [];
+		if (commandsConfig?.length) for (const cmd of commandsConfig) disposables.push(vscode.commands.registerCommand(cmd.id, cmd.handler));
+		if (documentLink?.enabled !== false) disposables.push(vscode.languages.registerDocumentLinkProvider(selector, createDocumentLinkProvider()));
+		if (hover?.enabled) disposables.push(vscode.languages.registerHoverProvider(selector, createHoverProvider()));
+		if (completion?.enabled) disposables.push(vscode.languages.registerCompletionItemProvider(selector, createCompletionProvider(), ...completion.triggerCharacters ?? []));
+		if (codeLens?.enabled) disposables.push(vscode.languages.registerCodeLensProvider(selector, createCodeLensProvider()));
+		if (decoration?.enabled && decorationType) {
+			const updateDecorations = (editor) => {
+				if (!editor || !fileFilter(editor.document)) return;
+				const decorations = collect(editor.document, true).map((item) => decoration.render(item, editor.document)).filter((opt) => opt !== void 0);
+				editor.setDecorations(decorationType, decorations);
+			};
+			updateDecorations(vscode.window.activeTextEditor);
+			disposables.push(vscode.window.onDidChangeActiveTextEditor(updateDecorations), vscode.workspace.onDidChangeTextDocument((e) => {
+				if (vscode.window.activeTextEditor?.document === e.document) updateDecorations(vscode.window.activeTextEditor);
+			}));
+		}
+		return disposables;
+	}
+	return {
+		cache,
+		collect,
+		decorationType,
+		register
+	};
+}
+/** Vue 文件过滤器 */
+const vueFileFilter = (document) => document.fileName.endsWith(".vue");
+function createExtFilter(...exts) {
+	return (document) => exts.some((ext) => document.fileName.endsWith(ext));
+}
+
+//#endregion
+exports.createExtFilter = createExtFilter;
+exports.createRange = createRange;
+exports.createRegexCollector = createRegexCollector;
+exports.definePatternProvider = definePatternProvider;
+exports.getItemExtra = getItemExtra;
+exports.vueFileFilter = vueFileFilter;

package/dist/index.d.mts

@@ -0,0 +1,115 @@
+import { CodeLens, CompletionItem, DecorationOptions, Disposable, DocumentLink, DocumentSelector, Hover, Position, Range, TextDocument, TextEditorDecorationType, Uri, window } from "vscode";
+
+//#region src/index.d.ts
+/** 匹配结果项 */
+interface MatchItem<TExtra = unknown> {
+  /** 匹配的文本 */
+  text: string;
+  /** 匹配开始索引 */
+  startIndex: number;
+  /** 匹配结束索引 */
+  endIndex: number;
+  /** 额外数据，用于 Hover/Completion/Decoration */
+  extra?: TExtra;
+}
+/** 收集函数类型 */
+type CollectFn<TExtra = unknown> = (document: TextDocument, skipCache?: boolean) => Array<MatchItem<TExtra>>;
+/** DocumentLink 配置 */
+interface DocumentLinkConfig<TExtra = unknown> {
+  /** 是否启用 */
+  enabled?: boolean;
+  /** 生成链接目标 URI */
+  target?: (item: MatchItem<TExtra>, document: TextDocument) => Uri | undefined;
+  /** 生成 tooltip */
+  tooltip?: (item: MatchItem<TExtra>, document: TextDocument) => string | undefined;
+}
+/** Hover 配置 */
+interface HoverConfig<TExtra = unknown> {
+  /** 是否启用 */
+  enabled?: boolean;
+  /** 生成 Hover 内容 */
+  content: (item: MatchItem<TExtra>, document: TextDocument) => Hover | undefined;
+}
+/** Completion 配置 */
+interface CompletionConfig {
+  /** 是否启用 */
+  enabled?: boolean;
+  /** 触发字符 */
+  triggerCharacters?: string[];
+  /** 判断当前位置是否应该触发补全 */
+  shouldTrigger?: (document: TextDocument, position: Position) => boolean;
+  /** 生成补全项列表 */
+  items: (document: TextDocument, position: Position) => CompletionItem[] | undefined;
+}
+/** Decoration 配置 */
+interface DecorationConfig<TExtra = unknown> {
+  /** 是否启用 */
+  enabled?: boolean;
+  /** 装饰器类型样式 */
+  style?: Parameters<typeof window.createTextEditorDecorationType>[0];
+  /** 生成装饰器选项 */
+  render: (item: MatchItem<TExtra>, document: TextDocument) => DecorationOptions | undefined;
+}
+/** CodeLens 配置 */
+interface CodeLensConfig<TExtra = unknown> {
+  /** 是否启用 */
+  enabled?: boolean;
+  /** 生成 CodeLens 列表 */
+  lenses: (item: MatchItem<TExtra>, document: TextDocument) => CodeLens[] | undefined;
+}
+/** 命令配置 */
+interface CommandConfig {
+  /** 命令 ID */
+  id: string;
+  /** 命令处理函数 */
+  handler: (...args: any[]) => any;
+}
+/** 配置选项 */
+interface PatternProviderOptions<TExtra = unknown> {
+  /** 文档选择器 */
+  selector?: DocumentSelector;
+  /** 文件过滤器，返回 false 则跳过该文档 */
+  fileFilter?: (document: TextDocument) => boolean;
+  /** 收集匹配项的函数 */
+  collect: CollectFn<TExtra>;
+  /** DocumentLink 配置 */
+  documentLink?: DocumentLinkConfig<TExtra>;
+  /** Hover 配置 */
+  hover?: HoverConfig<TExtra>;
+  /** Completion 配置 */
+  completion?: CompletionConfig;
+  /** Decoration 配置 */
+  decoration?: DecorationConfig<TExtra>;
+  /** CodeLens 配置 */
+  codeLens?: CodeLensConfig<TExtra>;
+  /** 注册的命令 */
+  commands?: CommandConfig[];
+}
+/** 返回值 */
+interface PatternProviderReturn<TExtra = unknown> {
+  /** 缓存的链接 */
+  cache: WeakMap<Uri, Array<MatchItem<TExtra>>>;
+  /** 收集匹配项 */
+  collect: (document: TextDocument, skipCache?: boolean) => Array<MatchItem<TExtra>>;
+  /** 装饰器类型（如果启用） */
+  decorationType?: TextEditorDecorationType;
+  /** 注册所有 Provider，返回 disposables */
+  register: () => Disposable[];
+}
+/** 创建基于正则的收集函数 - 无 context */
+declare function createRegexCollector<TExtra = unknown>(regex: RegExp, transform?: (match: RegExpExecArray) => MatchItem<TExtra> | undefined): CollectFn<TExtra>;
+/** 创建基于正则的收集函数 - 带 context */
+declare function createRegexCollector<TContext, TExtra = unknown>(regex: RegExp, setupContext: () => TContext, transform: (match: RegExpExecArray, context: TContext) => MatchItem<TExtra> | undefined): CollectFn<TExtra>;
+/** 从匹配项创建 Range */
+declare function createRange(document: TextDocument, item: MatchItem): Range;
+/** 获取匹配项的 extra 数据 */
+declare function getItemExtra<TExtra>(link: DocumentLink): TExtra | undefined;
+/**
+ * 定义模式匹配 Provider，统一管理 DocumentLink、Hover、Completion、Decoration、CodeLens 等功能
+ */
+declare function definePatternProvider<TExtra = unknown>(options: PatternProviderOptions<TExtra>): PatternProviderReturn<TExtra>;
+/** Vue 文件过滤器 */
+declare const vueFileFilter: (document: TextDocument) => boolean;
+declare function createExtFilter(...exts: string[]): (document: TextDocument) => boolean;
+//#endregion
+export { CodeLensConfig, CollectFn, CommandConfig, CompletionConfig, DecorationConfig, DocumentLinkConfig, HoverConfig, MatchItem, PatternProviderOptions, PatternProviderReturn, createExtFilter, createRange, createRegexCollector, definePatternProvider, getItemExtra, vueFileFilter };

package/dist/index.mjs

@@ -0,0 +1,121 @@
+import { DocumentLink, Range, commands, languages, window, workspace } from "vscode";
+
+//#region src/index.ts
+/** 创建基于正则的收集函数 */
+function createRegexCollector(regex, setupContextOrTransform, transform) {
+	const hasSetupContext = transform !== void 0;
+	const setupContext = hasSetupContext ? setupContextOrTransform : void 0;
+	const transformFn = hasSetupContext ? transform : setupContextOrTransform;
+	const context = setupContext?.();
+	return (document) => {
+		const items = [];
+		const text = document.getText();
+		const globalRegex = new RegExp(regex.source, regex.flags.includes("g") ? regex.flags : `${regex.flags}g`);
+		let match;
+		while ((match = globalRegex.exec(text)) !== null) if (transformFn) {
+			const item = hasSetupContext ? transformFn(match, context) : transformFn(match);
+			if (item) items.push(item);
+		} else items.push({
+			text: match[0],
+			startIndex: match.index,
+			endIndex: match.index + match[0].length
+		});
+		return items;
+	};
+}
+/** 从匹配项创建 Range */
+function createRange(document, item) {
+	return new Range(document.positionAt(item.startIndex), document.positionAt(item.endIndex));
+}
+/** 获取匹配项的 extra 数据 */
+function getItemExtra(link) {
+	return link.__extra;
+}
+/** 设置匹配项的 extra 数据到 DocumentLink */
+function setItemExtra(link, extra) {
+	link.__extra = extra;
+}
+/**
+* 定义模式匹配 Provider，统一管理 DocumentLink、Hover、Completion、Decoration、CodeLens 等功能
+*/
+function definePatternProvider(options) {
+	const { selector = { scheme: "file" }, fileFilter = () => true, collect: collectFn, documentLink, hover, completion, decoration, codeLens, commands: commandsConfig } = options;
+	const cache = /* @__PURE__ */ new WeakMap();
+	function collect(document, skipCache = false) {
+		if (!skipCache && cache.has(document.uri)) return cache.get(document.uri);
+		const items = collectFn(document, skipCache);
+		cache.set(document.uri, items);
+		return items;
+	}
+	const decorationType = decoration?.enabled && decoration.style ? window.createTextEditorDecorationType(decoration.style) : void 0;
+	function createDocumentLinkProvider() {
+		return { provideDocumentLinks(document) {
+			if (!fileFilter(document)) return;
+			return collect(document).map(function(item) {
+				const range = createRange(document, item);
+				const target = documentLink?.target?.(item, document);
+				const link = new DocumentLink(range, target);
+				link.tooltip = documentLink?.tooltip?.(item, document);
+				setItemExtra(link, item.extra);
+				return link;
+			});
+		} };
+	}
+	function createHoverProvider() {
+		return { provideHover(document, position) {
+			if (!fileFilter(document)) return;
+			const items = collect(document);
+			for (const item of items) {
+				if (!createRange(document, item).contains(position)) continue;
+				return hover?.content(item, document);
+			}
+		} };
+	}
+	function createCompletionProvider() {
+		return { provideCompletionItems(document, position) {
+			if (!fileFilter(document)) return;
+			if (completion?.shouldTrigger && !completion.shouldTrigger(document, position)) return;
+			return completion?.items(document, position);
+		} };
+	}
+	function createCodeLensProvider() {
+		return { provideCodeLenses(document) {
+			if (!fileFilter(document)) return;
+			return collect(document).flatMap((item) => codeLens?.lenses(item, document) ?? []);
+		} };
+	}
+	function register() {
+		const disposables = [];
+		if (commandsConfig?.length) for (const cmd of commandsConfig) disposables.push(commands.registerCommand(cmd.id, cmd.handler));
+		if (documentLink?.enabled !== false) disposables.push(languages.registerDocumentLinkProvider(selector, createDocumentLinkProvider()));
+		if (hover?.enabled) disposables.push(languages.registerHoverProvider(selector, createHoverProvider()));
+		if (completion?.enabled) disposables.push(languages.registerCompletionItemProvider(selector, createCompletionProvider(), ...completion.triggerCharacters ?? []));
+		if (codeLens?.enabled) disposables.push(languages.registerCodeLensProvider(selector, createCodeLensProvider()));
+		if (decoration?.enabled && decorationType) {
+			const updateDecorations = (editor) => {
+				if (!editor || !fileFilter(editor.document)) return;
+				const decorations = collect(editor.document, true).map((item) => decoration.render(item, editor.document)).filter((opt) => opt !== void 0);
+				editor.setDecorations(decorationType, decorations);
+			};
+			updateDecorations(window.activeTextEditor);
+			disposables.push(window.onDidChangeActiveTextEditor(updateDecorations), workspace.onDidChangeTextDocument((e) => {
+				if (window.activeTextEditor?.document === e.document) updateDecorations(window.activeTextEditor);
+			}));
+		}
+		return disposables;
+	}
+	return {
+		cache,
+		collect,
+		decorationType,
+		register
+	};
+}
+/** Vue 文件过滤器 */
+const vueFileFilter = (document) => document.fileName.endsWith(".vue");
+function createExtFilter(...exts) {
+	return (document) => exts.some((ext) => document.fileName.endsWith(ext));
+}
+
+//#endregion
+export { createExtFilter, createRange, createRegexCollector, definePatternProvider, getItemExtra, vueFileFilter };

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@sunshj/vscode-ab5x-utils",
+  "version": "0.0.1",
+  "description": "AB5X VSCode Utils",
+  "type": "module",
+  "keywords": [],
+  "license": "ISC",
+  "author": "sunshj",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "prepublishOnly": "pnpm build",
+    "release": "bumpp && npm publish"
+  }
+}

package/src/index.ts

@@ -0,0 +1,388 @@
+import {
+  commands,
+  DocumentLink,
+  languages,
+  Range,
+  window,
+  workspace,
+  type CodeLens,
+  type CodeLensProvider,
+  type CompletionItem,
+  type CompletionItemProvider,
+  type CompletionList,
+  type DecorationOptions,
+  type Disposable,
+  type DocumentLinkProvider,
+  type DocumentSelector,
+  type Hover,
+  type HoverProvider,
+  type Position,
+  type ProviderResult,
+  type TextDocument,
+  type TextEditor,
+  type TextEditorDecorationType,
+  type Uri
+} from 'vscode'
+
+/** 匹配结果项 */
+export interface MatchItem<TExtra = unknown> {
+  /** 匹配的文本 */
+  text: string
+  /** 匹配开始索引 */
+  startIndex: number
+  /** 匹配结束索引 */
+  endIndex: number
+  /** 额外数据，用于 Hover/Completion/Decoration */
+  extra?: TExtra
+}
+
+/** 收集函数类型 */
+export type CollectFn<TExtra = unknown> = (
+  document: TextDocument,
+  skipCache?: boolean
+) => Array<MatchItem<TExtra>>
+
+/** DocumentLink 配置 */
+export interface DocumentLinkConfig<TExtra = unknown> {
+  /** 是否启用 */
+  enabled?: boolean
+  /** 生成链接目标 URI */
+  target?: (item: MatchItem<TExtra>, document: TextDocument) => Uri | undefined
+  /** 生成 tooltip */
+  tooltip?: (item: MatchItem<TExtra>, document: TextDocument) => string | undefined
+}
+
+/** Hover 配置 */
+export interface HoverConfig<TExtra = unknown> {
+  /** 是否启用 */
+  enabled?: boolean
+  /** 生成 Hover 内容 */
+  content: (item: MatchItem<TExtra>, document: TextDocument) => Hover | undefined
+}
+
+/** Completion 配置 */
+export interface CompletionConfig {
+  /** 是否启用 */
+  enabled?: boolean
+  /** 触发字符 */
+  triggerCharacters?: string[]
+  /** 判断当前位置是否应该触发补全 */
+  shouldTrigger?: (document: TextDocument, position: Position) => boolean
+  /** 生成补全项列表 */
+  items: (document: TextDocument, position: Position) => CompletionItem[] | undefined
+}
+
+/** Decoration 配置 */
+export interface DecorationConfig<TExtra = unknown> {
+  /** 是否启用 */
+  enabled?: boolean
+  /** 装饰器类型样式 */
+  style?: Parameters<typeof window.createTextEditorDecorationType>[0]
+  /** 生成装饰器选项 */
+  render: (item: MatchItem<TExtra>, document: TextDocument) => DecorationOptions | undefined
+}
+
+/** CodeLens 配置 */
+export interface CodeLensConfig<TExtra = unknown> {
+  /** 是否启用 */
+  enabled?: boolean
+  /** 生成 CodeLens 列表 */
+  lenses: (item: MatchItem<TExtra>, document: TextDocument) => CodeLens[] | undefined
+}
+
+/** 命令配置 */
+export interface CommandConfig {
+  /** 命令 ID */
+  id: string
+  /** 命令处理函数 */
+  handler: (...args: any[]) => any
+}
+
+/** 配置选项 */
+export interface PatternProviderOptions<TExtra = unknown> {
+  /** 文档选择器 */
+  selector?: DocumentSelector
+  /** 文件过滤器，返回 false 则跳过该文档 */
+  fileFilter?: (document: TextDocument) => boolean
+  /** 收集匹配项的函数 */
+  collect: CollectFn<TExtra>
+  /** DocumentLink 配置 */
+  documentLink?: DocumentLinkConfig<TExtra>
+  /** Hover 配置 */
+  hover?: HoverConfig<TExtra>
+  /** Completion 配置 */
+  completion?: CompletionConfig
+  /** Decoration 配置 */
+  decoration?: DecorationConfig<TExtra>
+  /** CodeLens 配置 */
+  codeLens?: CodeLensConfig<TExtra>
+  /** 注册的命令 */
+  commands?: CommandConfig[]
+}
+
+/** 返回值 */
+export interface PatternProviderReturn<TExtra = unknown> {
+  /** 缓存的链接 */
+  cache: WeakMap<Uri, Array<MatchItem<TExtra>>>
+  /** 收集匹配项 */
+  collect: (document: TextDocument, skipCache?: boolean) => Array<MatchItem<TExtra>>
+  /** 装饰器类型（如果启用） */
+  decorationType?: TextEditorDecorationType
+  /** 注册所有 Provider，返回 disposables */
+  register: () => Disposable[]
+}
+
+/** 创建基于正则的收集函数 - 无 context */
+export function createRegexCollector<TExtra = unknown>(
+  regex: RegExp,
+  transform?: (match: RegExpExecArray) => MatchItem<TExtra> | undefined
+): CollectFn<TExtra>
+
+/** 创建基于正则的收集函数 - 带 context */
+export function createRegexCollector<TContext, TExtra = unknown>(
+  regex: RegExp,
+  setupContext: () => TContext,
+  transform: (match: RegExpExecArray, context: TContext) => MatchItem<TExtra> | undefined
+): CollectFn<TExtra>
+
+/** 创建基于正则的收集函数 */
+export function createRegexCollector<TContext = undefined, TExtra = unknown>(
+  regex: RegExp,
+  setupContextOrTransform?:
+    | (() => TContext)
+    | ((match: RegExpExecArray) => MatchItem<TExtra> | undefined),
+  transform?: (match: RegExpExecArray, context: TContext) => MatchItem<TExtra> | undefined
+): CollectFn<TExtra> {
+  // 判断第二个参数是 setupContext 还是 transform
+  const hasSetupContext = transform !== undefined
+  const setupContext = hasSetupContext ? (setupContextOrTransform as () => TContext) : undefined
+  const transformFn = hasSetupContext
+    ? transform
+    : (setupContextOrTransform as
+        | ((match: RegExpExecArray) => MatchItem<TExtra> | undefined)
+        | undefined)
+
+  const context = setupContext?.()
+
+  return (document: TextDocument) => {
+    const items: Array<MatchItem<TExtra>> = []
+    const text = document.getText()
+    // 确保正则有 g 标志
+    const globalRegex = new RegExp(
+      regex.source,
+      regex.flags.includes('g') ? regex.flags : `${regex.flags}g`
+    )
+
+    let match: RegExpExecArray | null
+    while ((match = globalRegex.exec(text)) !== null) {
+      if (transformFn) {
+        const item = hasSetupContext
+          ? (transformFn as (m: RegExpExecArray, c: TContext) => MatchItem<TExtra> | undefined)(
+              match,
+              context!
+            )
+          : (transformFn as (m: RegExpExecArray) => MatchItem<TExtra> | undefined)(match)
+        if (item) items.push(item)
+      } else {
+        items.push({
+          text: match[0],
+          startIndex: match.index,
+          endIndex: match.index + match[0].length
+        })
+      }
+    }
+    return items
+  }
+}
+
+/** 从匹配项创建 Range */
+export function createRange(document: TextDocument, item: MatchItem): Range {
+  return new Range(document.positionAt(item.startIndex), document.positionAt(item.endIndex))
+}
+
+/** 获取匹配项的 extra 数据 */
+export function getItemExtra<TExtra>(link: DocumentLink): TExtra | undefined {
+  return (link as any).__extra as TExtra
+}
+
+/** 设置匹配项的 extra 数据到 DocumentLink */
+function setItemExtra<TExtra>(link: DocumentLink, extra: TExtra): void {
+  ;(link as any).__extra = extra
+}
+
+/**
+ * 定义模式匹配 Provider，统一管理 DocumentLink、Hover、Completion、Decoration、CodeLens 等功能
+ */
+export function definePatternProvider<TExtra = unknown>(
+  options: PatternProviderOptions<TExtra>
+): PatternProviderReturn<TExtra> {
+  const {
+    selector = { scheme: 'file' },
+    fileFilter = () => true,
+    collect: collectFn,
+    documentLink,
+    hover,
+    completion,
+    decoration,
+    codeLens,
+    commands: commandsConfig
+  } = options
+
+  const cache = new WeakMap<Uri, Array<MatchItem<TExtra>>>()
+
+  // 带缓存的收集函数
+  function collect(document: TextDocument, skipCache = false): Array<MatchItem<TExtra>> {
+    if (!skipCache && cache.has(document.uri)) {
+      return cache.get(document.uri)!
+    }
+    const items = collectFn(document, skipCache)
+    cache.set(document.uri, items)
+    return items
+  }
+
+  // 创建装饰器类型（如果启用）
+  const decorationType =
+    decoration?.enabled && decoration.style
+      ? window.createTextEditorDecorationType(decoration.style)
+      : undefined
+
+  // DocumentLink Provider
+  function createDocumentLinkProvider(): DocumentLinkProvider {
+    return {
+      provideDocumentLinks(document: TextDocument): ProviderResult<DocumentLink[]> {
+        if (!fileFilter(document)) return
+        const items = collect(document)
+        return items.map(function (item) {
+          const range = createRange(document, item)
+          const target = documentLink?.target?.(item, document)
+          const link = new DocumentLink(range, target)
+          link.tooltip = documentLink?.tooltip?.(item, document)
+          setItemExtra(link, item.extra)
+          return link
+        })
+      }
+    }
+  }
+
+  // Hover Provider
+  function createHoverProvider(): HoverProvider {
+    return {
+      provideHover(document: TextDocument, position: Position): ProviderResult<Hover> {
+        if (!fileFilter(document)) return
+        const items = collect(document)
+
+        for (const item of items) {
+          const range = createRange(document, item)
+          if (!range.contains(position)) continue
+          return hover?.content(item, document)
+        }
+      }
+    }
+  }
+
+  // Completion Provider
+  function createCompletionProvider(): CompletionItemProvider {
+    return {
+      provideCompletionItems(
+        document: TextDocument,
+        position: Position
+      ): ProviderResult<CompletionItem[] | CompletionList<CompletionItem>> {
+        if (!fileFilter(document)) return
+        if (completion?.shouldTrigger && !completion.shouldTrigger(document, position)) return
+        return completion?.items(document, position)
+      }
+    }
+  }
+
+  // CodeLens Provider
+  function createCodeLensProvider(): CodeLensProvider {
+    return {
+      provideCodeLenses(document: TextDocument): ProviderResult<CodeLens[]> {
+        if (!fileFilter(document)) return
+        const items = collect(document)
+        return items.flatMap(item => codeLens?.lenses(item, document) ?? [])
+      }
+    }
+  }
+
+  // 注册函数
+  function register(): Disposable[] {
+    const disposables: Disposable[] = []
+
+    // 注册命令
+    if (commandsConfig?.length) {
+      for (const cmd of commandsConfig) {
+        disposables.push(commands.registerCommand(cmd.id, cmd.handler))
+      }
+    }
+
+    // 注册 DocumentLink Provider
+    if (documentLink?.enabled !== false) {
+      disposables.push(
+        languages.registerDocumentLinkProvider(selector, createDocumentLinkProvider())
+      )
+    }
+
+    // 注册 Hover Provider
+    if (hover?.enabled) {
+      disposables.push(languages.registerHoverProvider(selector, createHoverProvider()))
+    }
+
+    // 注册 Completion Provider
+    if (completion?.enabled) {
+      disposables.push(
+        languages.registerCompletionItemProvider(
+          selector,
+          createCompletionProvider(),
+          ...(completion.triggerCharacters ?? [])
+        )
+      )
+    }
+
+    // 注册 CodeLens Provider
+    if (codeLens?.enabled) {
+      disposables.push(languages.registerCodeLensProvider(selector, createCodeLensProvider()))
+    }
+
+    // 注册 Decoration
+    if (decoration?.enabled && decorationType) {
+      const updateDecorations = (editor: TextEditor | undefined) => {
+        if (!editor || !fileFilter(editor.document)) return
+        const items = collect(editor.document, true)
+        const decorations = items
+          .map(item => decoration.render(item, editor.document))
+          .filter((opt): opt is DecorationOptions => opt !== undefined)
+        editor.setDecorations(decorationType, decorations)
+      }
+
+      // 初始更新
+      updateDecorations(window.activeTextEditor)
+
+      disposables.push(
+        // 监听编辑器切换
+        window.onDidChangeActiveTextEditor(updateDecorations),
+        // 监听文档变化
+        workspace.onDidChangeTextDocument(e => {
+          if (window.activeTextEditor?.document === e.document) {
+            updateDecorations(window.activeTextEditor)
+          }
+        })
+      )
+    }
+
+    return disposables
+  }
+
+  return {
+    cache,
+    collect,
+    decorationType,
+    register
+  }
+}
+
+/** Vue 文件过滤器 */
+export const vueFileFilter = (document: TextDocument) => document.fileName.endsWith('.vue')
+export function createExtFilter(...exts: string[]) {
+  return (document: TextDocument) => exts.some(ext => document.fileName.endsWith(ext))
+}

package/tsdown.config.ts

@@ -0,0 +1,22 @@
+import { defineConfig, type UserConfig } from 'tsdown'
+
+const sharedConfig: UserConfig = {
+  entry: ['src/index.ts'],
+  platform: 'node',
+  external: ['vscode']
+}
+
+export default defineConfig([
+  {
+    ...sharedConfig,
+    name: 'lib-bundle:esm',
+    format: 'esm',
+    dts: true
+  },
+  {
+    ...sharedConfig,
+    name: 'lib-bundle:cjs',
+    format: 'cjs',
+    dts: false
+  }
+])