@sunshj/vscode-ab5x-utils 0.0.1 → 0.0.3

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@sunshj/vscode-ab5x-utils",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "AB5X VSCode Utils",
   "type": "module",
   "keywords": [],
   "license": "ISC",
   "author": "sunshj",
+  "files": [
+    "dist"
+  ],
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
   "types": "dist/index.d.mts",
@@ -22,6 +25,6 @@
   "scripts": {
     "build": "tsdown",
     "prepublishOnly": "pnpm build",
-    "release": "bumpp && npm publish"
+    "release": "bumpp --tag \"vscode-ab5x-utils-v%s\" --commit \"release @sunshj/vscode-ab5x-utils v%s\" && npm publish"
   }
 }

package/src/index.ts

@@ -1,388 +0,0 @@
-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

@@ -1,22 +0,0 @@
-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
-  }
-])