autosnippet 3.2.16 → 3.2.18

package/dist/lib/service/wiki/WikiRenderers.js

@@ -17,11 +17,7 @@ import { getInheritanceRoots, getLangTerms, getModuleSourceFiles, inferModulePur
  *
  * 关键区别: 不是润色骨架，而是提供丰富数据让 AI 写完整文章
  *
- * @param {object} topic
- * @param {object} data - { projectInfo, astInfo, moduleInfo, knowledgeInfo }
- * @param {boolean} isZh
- * @param {object|null} codeEntityGraph
- * @returns {string}
+ * @param data { projectInfo, astInfo, moduleInfo, knowledgeInfo }
  */
 export function buildArticlePrompt(topic, data, isZh, codeEntityGraph) {
     const { projectInfo, astInfo, moduleInfo, knowledgeInfo } = data;
@@ -406,11 +402,7 @@ export function buildArticlePrompt(topic, data, isZh, codeEntityGraph) {
  * 构建非 AI 降级的丰富模板内容
  * 即使没有 AI，也要产出有意义的内容 (不是只有列表罗列)
  *
- * @param {object} topic
- * @param {object} data - { projectInfo, astInfo, moduleInfo, knowledgeInfo }
- * @param {boolean} isZh
- * @param {object|null} codeEntityGraph
- * @returns {string}
+ * @param data { projectInfo, astInfo, moduleInfo, knowledgeInfo }
  */
 export function buildFallbackArticle(topic, data, isZh, codeEntityGraph) {
     const { projectInfo, astInfo, moduleInfo, knowledgeInfo } = data;
@@ -438,9 +430,7 @@ export function buildFallbackArticle(topic, data, isZh, codeEntityGraph) {
     }
 }
 // ═══ Markdown 渲染器 ═══════════════════════════════════════
-/**
- * 渲染项目概述页 (index.md)
- */
+/** 渲染项目概述页 (index.md) */
 export function renderIndex(project, ast, modules, knowledge, isZh, allTopics) {
     const title = isZh ? '项目概述' : 'Project Overview';
     const langTerms = getLangTerms(project.primaryLanguage || 'unknown');
@@ -592,15 +582,7 @@ export function renderIndex(project, ast, modules, knowledge, isZh, allTopics) {
     }
     return lines.join('\n');
 }
-/**
- * 渲染架构总览文档 (architecture.md)
- *
- * @param {object} project
- * @param {object} ast
- * @param {object} modules
- * @param {boolean} isZh
- * @param {object|null} codeEntityGraph
- */
+/** 渲染架构总览文档 (architecture.md) */
 export function renderArchitecture(project, ast, modules, isZh, codeEntityGraph) {
     const lines = [
         `# ${isZh ? '架构总览' : 'Architecture Overview'}`,
@@ -721,9 +703,7 @@ export function renderArchitecture(project, ast, modules, isZh, codeEntityGraph)
     lines.push('');
     return lines.join('\n');
 }
-/**
- * 渲染模块详情文档 (modules/{name}.md)
- */
+/** 渲染模块详情文档 (modules/{name}.md) */
 export function renderModule(target, ast, knowledge, isZh, projectInfo) {
     const langTerms = getLangTerms(projectInfo?.primaryLanguage || 'unknown');
     const tl = isZh ? langTerms.typeLabel.zh : langTerms.typeLabel.en;
@@ -879,9 +859,7 @@ export function renderModule(target, ast, knowledge, isZh, projectInfo) {
     lines.push('');
     return lines.join('\n');
 }
-/**
- * 渲染代码模式文档 (patterns.md)
- */
+/** 渲染代码模式文档 (patterns.md) */
 export function renderPatterns(knowledge, isZh) {
     const lines = [
         `# ${isZh ? '代码模式与最佳实践' : 'Code Patterns & Best Practices'}`,
@@ -946,9 +924,7 @@ export function renderPatterns(knowledge, isZh) {
     return lines.join('\n');
 }
 // ═══ V3 新增渲染器 ════════════════════════════════════════
-/**
- * 快速上手指南 (非 AI 降级模板)
- */
+/** 快速上手指南 (非 AI 降级模板) */
 export function renderGettingStarted(project, modules, ast, isZh) {
     const lines = [
         `# ${isZh ? '快速上手' : 'Getting Started'}`,
@@ -1229,9 +1205,7 @@ function _pushBuildSteps(lines, buildSys, projectName, isZh) {
     lines.push('```');
     lines.push('');
 }
-/**
- * 按分类拆分的代码模式文档
- */
+/** 按分类拆分的代码模式文档 */
 export function renderPatternCategory(patternData, isZh) {
     const { category, recipes } = patternData;
     const lines = [
@@ -1275,9 +1249,7 @@ export function renderPatternCategory(patternData, isZh) {
     lines.push('');
     return lines.join('\n');
 }
-/**
- * 协议参考文档
- */
+/** 协议参考文档 */
 export function renderProtocolReference(ast, isZh, projectInfo) {
     const langTerms = getLangTerms(projectInfo?.primaryLanguage || 'unknown');
     const il = isZh ? langTerms.interfaceLabel.zh : langTerms.interfaceLabel.en;
@@ -1325,14 +1297,7 @@ export function renderProtocolReference(ast, isZh, projectInfo) {
     return lines.join('\n');
 }
 // ═══ Folder Profile 渲染器 (AST 不可用时的降级策略) ═══════
-/**
- * 渲染文件夹结构总览 (folder-structure.md)
- *
- * @param {import('./WikiUtils.js').FolderProfile[]} profiles
- * @param {object} projectInfo
- * @param {boolean} isZh
- * @returns {string}
- */
+/** 渲染文件夹结构总览 (folder-structure.md) */
 export function renderFolderOverview(profiles, projectInfo, isZh) {
     const lines = [
         `# ${isZh ? '项目结构分析' : 'Project Structure Analysis'}`,
@@ -1438,14 +1403,7 @@ export function renderFolderOverview(profiles, projectInfo, isZh) {
     lines.push('');
     return lines.join('\n');
 }
-/**
- * 渲染单个文件夹的深度画像文档 (folders/{name}.md)
- *
- * @param {import('./WikiUtils.js').FolderProfile} fp
- * @param {object} projectInfo
- * @param {boolean} isZh
- * @returns {string}
- */
+/** 渲染单个文件夹的深度画像文档 (folders/{name}.md) */
 export function renderFolderProfile(fp, projectInfo, isZh) {
     const lines = [
         `# ${fp.name}`,
@@ -1585,9 +1543,7 @@ export function renderFolderProfile(fp, projectInfo, isZh) {
     return lines.join('\n');
 }
 // ═══ V3 AI 系统 Prompt ═══════════════════════════════════
-/**
- * 构建 AI 系统 Prompt (V3 — 撰写完整文章，非润色骨架)
- */
+/** 构建 AI 系统 Prompt (V3 — 撰写完整文章，非润色骨架) */
 export function buildAiSystemPrompt(isZh) {
     if (isZh) {
         return [
@@ -1626,4 +1582,3 @@ export function buildAiSystemPrompt(isZh) {
         '10. End with a back link: [← Back to Overview](index.md) or [← Back to Overview](../index.md)',
     ].join('\n');
 }
-//# sourceMappingURL=WikiRenderers.js.map

package/dist/lib/service/wiki/WikiTypes.d.ts

@@ -143,4 +143,3 @@ export interface WikiData {
     moduleInfo: WikiModuleInfo;
     knowledgeInfo: WikiKnowledgeInfo;
 }
-//# sourceMappingURL=WikiTypes.d.ts.map

package/dist/lib/service/wiki/WikiTypes.js

@@ -7,4 +7,3 @@
  * @module WikiTypes
  */
 export {};
-//# sourceMappingURL=WikiTypes.js.map

package/dist/lib/service/wiki/WikiUtils.d.ts

@@ -5,17 +5,11 @@
  *
  * @module WikiUtils
  */
-/**
- * 文本 slug 化
- */
+/** 文本 slug 化 */
 export declare function slug(name: string): string;
-/**
- * Mermaid 安全 ID
- */
+/** Mermaid 安全 ID */
 export declare function mermaidId(name: string): string;
-/**
- * 遍历目录（排除 build/Pods/DerivedData 等）
- */
+/** 遍历目录（排除 build/Pods/DerivedData 等） */
 export declare function walkDir(dir: string, callback: (filePath: string) => void, maxFiles?: number): void;
 /**
  * 从文件相对路径推断所属模块名
@@ -56,8 +50,7 @@ export declare function inferModulePurpose(name: string, classes: string[], prot
 } | null;
 /**
  * 从 CodeEntityGraph 提取继承根节点
- * @param {object|null} codeEntityGraph
- * @returns {Array<{name: string, children: string[]}>}
+ * @returns >}
  */
 export declare function getInheritanceRoots(codeEntityGraph: {
     queryEntities?: (filter: Record<string, unknown>) => Array<{
@@ -79,10 +72,7 @@ export declare function getInheritanceRoots(codeEntityGraph: {
  * Layer 1: Title slug 碰撞 — 同名文件不同目录 → hash 相同则删除副本
  * Layer 2: Content hash    — 跨文件内容完全相同 → 仅保留第一个
  *
- * @param {Array} files
- * @param {string} wikiDir
- * @param {(phase: string, progress: number, message: string) => void} emit
- * @returns {{ removed: string[], kept: number }}
+ * @returns }
  */
 export declare function dedup(files: {
     path: string;
@@ -96,8 +86,8 @@ export declare function dedup(files: {
  *
  * 不同语言对"类"和"接口"有不同称谓，Wiki 文档应使用合适的措辞。
  *
- * @param {string} langId - LanguageService langId，如 'swift', 'python', 'go'
- * @returns {{ typeLabel: {zh: string, en: string}, interfaceLabel: {zh: string, en: string}, moduleMetric: {zh: string, en: string} }}
+ * @param langId LanguageService langId，如 'swift', 'python', 'go'
+ * @returns , interfaceLabel: {zh: string, en: string}, moduleMetric: {zh: string, en: string} }}
  */
 export declare function getLangTerms(langId: string): {
     typeLabel: {
@@ -117,7 +107,6 @@ export declare function getLangTerms(langId: string): {
  * 已知的构建系统标志文件 → 生态类型映射
  *
  * @deprecated 请使用 LanguageService.buildSystemMarkers。此处保留为只读引用以保持向后兼容。
- * @type {ReadonlyArray<{file: string, eco: string, buildTool: string}>}
  */
 export declare const BUILD_SYSTEM_MARKERS: readonly {
     file: string;
@@ -131,9 +120,9 @@ export declare const BUILD_SYSTEM_MARKERS: readonly {
  *   1. 先检查根目录的一级文件
  *   2. 如果根目录未找到，检查一级子目录（支持 monorepo 如 AppFlowy/frontend/...）
  *
- * @param {string[]} rootEntryNames 项目根目录一级文件/目录名列表
- * @param {string} [projectRoot] 可选的项目根路径，用于二级检测
- * @returns {Array<{eco: string, buildTool: string}>} 匹配到的构建系统
+ * @param rootEntryNames 项目根目录一级文件/目录名列表
+ * @param [projectRoot] 可选的项目根路径，用于二级检测
+ * @returns >} 匹配到的构建系统
  */
 export declare function detectBuildSystems(rootEntryNames: string[], projectRoot?: string): {
     eco: string;
@@ -145,12 +134,10 @@ export declare function detectBuildSystems(rootEntryNames: string[], projectRoot
  * 适用场景: AST 无法提取 target（类/函数/协议）的语言，
  * 通过文件夹结构、文件命名、轻量 import 分析来产出有意义的 wiki 内容。
  *
- * @param {object} projectInfo - WikiGenerator._scanProject() 的输出
- * @param {object} [options]
- * @param {number} [options.minFiles=3]      文件夹最少文件数阈值
- * @param {number} [options.maxFolders=20]   最多分析的文件夹数
- * @param {number} [options.sampleLines=40]  每个文件采样行数 (用于 import 提取)
- * @returns {FolderProfile[]}
+ * @param projectInfo WikiGenerator._scanProject() 的输出
+ * @param [options.minFiles=3] 文件夹最少文件数阈值
+ * @param [options.maxFolders=20] 最多分析的文件夹数
+ * @param [options.sampleLines=40] 每个文件采样行数 (用于 import 提取)
  */
 export declare function profileFolders(projectInfo: {
     root: string;
@@ -161,4 +148,3 @@ export declare function profileFolders(projectInfo: {
     maxFolders?: number;
     sampleLines?: number;
 }): Record<string, unknown>[];
-//# sourceMappingURL=WikiUtils.d.ts.map

package/dist/lib/service/wiki/WikiUtils.js

@@ -12,21 +12,15 @@ import { LanguageService } from '../../shared/LanguageService.js';
 import { DEFAULT_KNOWLEDGE_BASE_DIR } from '../../shared/ProjectMarkers.js';
 const logger = Logger.getInstance();
 // ─── 工具函数 ────────────────────────────────────────────────
-/**
- * 文本 slug 化
- */
+/** 文本 slug 化 */
 export function slug(name) {
     return name.replace(/[^a-zA-Z0-9_-]/g, '_').toLowerCase();
 }
-/**
- * Mermaid 安全 ID
- */
+/** Mermaid 安全 ID */
 export function mermaidId(name) {
     return name.replace(/[^a-zA-Z0-9]/g, '_');
 }
-/**
- * 遍历目录（排除 build/Pods/DerivedData 等）
- */
+/** 遍历目录（排除 build/Pods/DerivedData 等） */
 export function walkDir(dir, callback, maxFiles = 500) {
     const excludeNames = new Set([
         'Pods',
@@ -255,8 +249,7 @@ export function inferModulePurpose(name, classes, protocols, files) {
 }
 /**
  * 从 CodeEntityGraph 提取继承根节点
- * @param {object|null} codeEntityGraph
- * @returns {Array<{name: string, children: string[]}>}
+ * @returns >}
  */
 export function getInheritanceRoots(codeEntityGraph) {
     if (!codeEntityGraph) {
@@ -288,10 +281,7 @@ export function getInheritanceRoots(codeEntityGraph) {
  * Layer 1: Title slug 碰撞 — 同名文件不同目录 → hash 相同则删除副本
  * Layer 2: Content hash    — 跨文件内容完全相同 → 仅保留第一个
  *
- * @param {Array} files
- * @param {string} wikiDir
- * @param {(phase: string, progress: number, message: string) => void} emit
- * @returns {{ removed: string[], kept: number }}
+ * @returns }
  */
 export function dedup(files, wikiDir, emit) {
     const removed = [];
@@ -376,8 +366,8 @@ export function dedup(files, wikiDir, emit) {
  *
  * 不同语言对"类"和"接口"有不同称谓，Wiki 文档应使用合适的措辞。
  *
- * @param {string} langId - LanguageService langId，如 'swift', 'python', 'go'
- * @returns {{ typeLabel: {zh: string, en: string}, interfaceLabel: {zh: string, en: string}, moduleMetric: {zh: string, en: string} }}
+ * @param langId LanguageService langId，如 'swift', 'python', 'go'
+ * @returns , interfaceLabel: {zh: string, en: string}, moduleMetric: {zh: string, en: string} }}
  */
 export function getLangTerms(langId) {
     const TERMS = {
@@ -447,7 +437,6 @@ export function getLangTerms(langId) {
  * 已知的构建系统标志文件 → 生态类型映射
  *
  * @deprecated 请使用 LanguageService.buildSystemMarkers。此处保留为只读引用以保持向后兼容。
- * @type {ReadonlyArray<{file: string, eco: string, buildTool: string}>}
  */
 export const BUILD_SYSTEM_MARKERS = LanguageService.buildSystemMarkers;
 /**
@@ -457,9 +446,9 @@ export const BUILD_SYSTEM_MARKERS = LanguageService.buildSystemMarkers;
  *   1. 先检查根目录的一级文件
  *   2. 如果根目录未找到，检查一级子目录（支持 monorepo 如 AppFlowy/frontend/...）
  *
- * @param {string[]} rootEntryNames 项目根目录一级文件/目录名列表
- * @param {string} [projectRoot] 可选的项目根路径，用于二级检测
- * @returns {Array<{eco: string, buildTool: string}>} 匹配到的构建系统
+ * @param rootEntryNames 项目根目录一级文件/目录名列表
+ * @param [projectRoot] 可选的项目根路径，用于二级检测
+ * @returns >} 匹配到的构建系统
  */
 export function detectBuildSystems(rootEntryNames, projectRoot) {
     // 委托给 LanguageService 做一级匹配
@@ -498,23 +487,6 @@ export function detectBuildSystems(rootEntryNames, projectRoot) {
     return results;
 }
 // ─── Folder Profile 分析 (AST 不可用时的降级策略) ─────────
-/**
- * @typedef {object} FolderProfile
- * @property {string}  name           文件夹名
- * @property {string}  relPath        相对于项目根的路径
- * @property {number}  fileCount      源文件数 (递归)
- * @property {number}  totalSize      总字节数
- * @property {number}  depth          距项目根的深度
- * @property {Record<string, number>} langBreakdown - {语言 → 文件数}
- * @property {string[]} keyFiles      重要文件 (入口、配置、大文件)
- * @property {string[]} fileNames     所有源文件 basename (排序)
- * @property {string|null} readme     文件夹内 README 内容摘要
- * @property {string|null} purpose    从命名推断的功能描述
- * @property {string[]} imports       通过 import/require regex 提取的外部依赖目标 (其他文件夹)
- * @property {string[]} entryPoints   检测到的入口文件 (index.*, main.*, __init__.py, mod.rs)
- * @property {string[]} namingPatterns 检测到的命名约定
- * @property {string[]} headerComments 从关键文件提取的首段注释
- */
 /** 入口文件名模式 */
 const ENTRY_POINT_NAMES = new Set([
     'index.js',
@@ -566,12 +538,10 @@ const IMPORT_PATTERNS = [
  * 适用场景: AST 无法提取 target（类/函数/协议）的语言，
  * 通过文件夹结构、文件命名、轻量 import 分析来产出有意义的 wiki 内容。
  *
- * @param {object} projectInfo - WikiGenerator._scanProject() 的输出
- * @param {object} [options]
- * @param {number} [options.minFiles=3]      文件夹最少文件数阈值
- * @param {number} [options.maxFolders=20]   最多分析的文件夹数
- * @param {number} [options.sampleLines=40]  每个文件采样行数 (用于 import 提取)
- * @returns {FolderProfile[]}
+ * @param projectInfo WikiGenerator._scanProject() 的输出
+ * @param [options.minFiles=3] 文件夹最少文件数阈值
+ * @param [options.maxFolders=20] 最多分析的文件夹数
+ * @param [options.sampleLines=40] 每个文件采样行数 (用于 import 提取)
  */
 export function profileFolders(projectInfo, options = {}) {
     const { minFiles = 3, maxFolders = 20, sampleLines = 40 } = options;
@@ -766,8 +736,7 @@ function _buildFolderProfile(relDir, files, depth, projectRoot, sampleLines) {
 /**
  * 从文件名列表检测命名约定
  * @private
- * @param {string[]} fileNames - basename 列表
- * @returns {string[]}
+ * @param fileNames basename 列表
  */
 function _detectNamingPatterns(fileNames) {
     const patterns = [];
@@ -969,4 +938,3 @@ function _extractHeaderComment(fullPath) {
         return null;
     }
 }
-//# sourceMappingURL=WikiUtils.js.map

package/dist/lib/shared/LanguageService.d.ts

@@ -16,14 +16,12 @@
 export declare class LanguageService {
     /**
      * 从文件名（或路径）推断规范化语言 ID
-     * @param {string} filename
-     * @returns {string} 语言 ID，如 'swift', 'typescript', 'python', 'unknown'
+     * @returns 语言 ID，如 'swift', 'typescript', 'python', 'unknown'
      */
     static inferLang(filename: string): string;
     /**
      * 从文件扩展名（带 dot）推断语言
-     * @param {string} ext 如 '.ts', '.py'
-     * @returns {string}
+     * @param ext 如 '.ts', '.py'
      */
     static langFromExt(ext: string): string;
     /**
@@ -36,8 +34,8 @@ export declare class LanguageService {
      *   normalize('swift')    → 'swift' (已是规范 ID)
      *   normalize('unknown')  → 'unknown'
      *
-     * @param {string} langId 语言 ID（可能是别名）
-     * @returns {string} 规范化语言 ID
+     * @param langId 语言 ID（可能是别名）
+     * @returns 规范化语言 ID
      */
     static normalize(langId: string): string;
     /**
@@ -45,33 +43,24 @@ export declare class LanguageService {
      *
      * Guard 内置规则使用 'objc' 而非 'objectivec'。
      * 其他语言 ID 不变。
-     *
-     * @param {string} langId
-     * @returns {string}
      */
     static toGuardLangId(langId: string): string;
-    /**
-     * 语言 ID → 人类可读名称
-     * @param {string} langId
-     * @returns {string}
-     */
+    /** 语言 ID → 人类可读名称 */
     static displayName(langId: string): string;
     /**
      * 文件扩展名（带 dot）→ 人类可读语言名
-     * @param {string} ext 如 '.swift', '.ts'
-     * @returns {string}
+     * @param ext 如 '.swift', '.ts'
      */
     static displayNameFromExt(ext: string): string;
     /**
      * 从文件扩展名统计推断主语言
-     * @param {Record<string, number>} langStats - key = 裸扩展名 (如 'ts', 'm', 'py')，value = 文件数
-     * @returns {string} 主语言 ID
+     * @param langStats key = 裸扩展名 (如 'ts', 'm', 'py')，value = 文件数
+     * @returns 主语言 ID
      */
     static detectPrimary(langStats: Record<string, number>): string;
     /**
      * 从文件扩展名统计返回所有检测到的编程语言（按文件数降序）
-     * @param {Record<string, number>} langStats
-     * @returns {Array<{ lang: string, count: number }>}
+     * @returns >}
      */
     static detectAll(langStats: Record<string, number>): {
         lang: string;
@@ -85,10 +74,9 @@ export declare class LanguageService {
      *   - detectProfile 给出完整画像，适用于维度文案、AI prompt 等需要
      *     感知多语言的场景
      *
-     * @param {Record<string, number>} langStats - key=裸扩展名, value=文件数
-     * @param {object} [opts]
-     * @param {number} [opts.secondaryThreshold=0.1] 次要语言文件占比阈值（≥此比例才算次要语言）
-     * @returns {{ primary: string, secondary: string[], all: Array<{lang:string, count:number, ratio:number}>, totalFiles: number, isMultiLang: boolean }}
+     * @param langStats key=裸扩展名, value=文件数
+     * @param [opts.secondaryThreshold=0.1] 次要语言文件占比阈值（≥此比例才算次要语言）
+     * @returns >, totalFiles: number, isMultiLang: boolean }}
      */
     static detectProfile(langStats: Record<string, number>, opts?: {
         secondaryThreshold?: number;
@@ -103,79 +91,49 @@ export declare class LanguageService {
         totalFiles: number;
         isMultiLang: boolean;
     };
-    /**
-     * 该语言 ID 是否是已知编程语言
-     * @param {string} langId
-     * @returns {boolean}
-     */
+    /** 该语言 ID 是否是已知编程语言 */
     static isKnownLang(langId: string): boolean;
     /**
      * 该扩展名是否为源代码文件
-     * @param {string} ext 带 dot，如 '.ts'
-     * @returns {boolean}
+     * @param ext 带 dot，如 '.ts'
      */
     static isSourceExt(ext: string): boolean;
-    /**
-     * 获取所有源代码扩展名（不可变）
-     * @returns {ReadonlySet<string>}
-     */
+    /** 获取所有源代码扩展名（不可变） */
     static get sourceExts(): Readonly<Set<string>>;
-    /**
-     * 获取所有已知编程语言 ID（不可变）
-     * @returns {ReadonlySet<string>}
-     */
+    /** 获取所有已知编程语言 ID（不可变） */
     static get knownLangs(): Readonly<Set<string>>;
-    /**
-     * 获取完整的 ext→lang 映射（不可变）
-     * @returns {Readonly<Record<string, string>>}
-     */
+    /** 获取完整的 ext→lang 映射（不可变） */
     static get extToLangMap(): Record<string, string>;
-    /**
-     * 获取完整的 bareExt→lang 映射（不可变）
-     * @returns {Readonly<Record<string, string>>}
-     */
+    /** 获取完整的 bareExt→lang 映射（不可变） */
     static get bareExtToLangMap(): Record<string, string>;
     /**
      * 根据语言 ID 返回主扩展名（带 dot）
-     * @param {string} langId 如 'go', 'swift', 'python'
-     * @returns {string|null} 如 '.go', '.swift', '.py'；未知返回 null
+     * @param langId 如 'go', 'swift', 'python'
+     * @returns 如 '.go', '.swift', '.py'；未知返回 null
      */
     static extForLang(langId: string): string | null;
-    /**
-     * 获取语言别名映射表（不可变）
-     * @returns {Readonly<Record<string, string>>}
-     */
+    /** 获取语言别名映射表（不可变） */
     static get langAliases(): Record<string, string>;
-    /**
-     * 获取 ECO_TO_LANGS 映射（不可变）
-     * @returns {Readonly<Record<string, readonly string[]>>}
-     */
+    /** 获取 ECO_TO_LANGS 映射（不可变） */
     static get ecoToLangs(): Record<string, readonly string[]>;
-    /**
-     * 获取 BUILD_SYSTEM_MARKERS（不可变）
-     * @returns {ReadonlyArray<BuildSystemMarker>}
-     */
+    /** 获取 BUILD_SYSTEM_MARKERS（不可变） */
     static get buildSystemMarkers(): readonly {
         file: string;
         eco: string;
         buildTool: string;
     }[];
-    /**
-     * 获取 SCAN_SKIP_DIRS（不可变）
-     * @returns {ReadonlySet<string>}
-     */
+    /** 获取 SCAN_SKIP_DIRS（不可变） */
     static get scanSkipDirs(): Readonly<Set<string>>;
     /**
      * 根据生态系统/Discoverer ID 获取对应的语言 ID 数组
-     * @param {string} ecoId 如 'spm', 'node', 'rust', 'dart'
-     * @returns {readonly string[]}
+     * @param ecoId 如 'spm', 'node', 'rust', 'dart'
      */
     static langsForEco(ecoId: string): readonly string[];
     /**
      * 检测构建系统标志文件 — 纯数据匹配，不访问文件系统
      *
-     * @param {string[]} entryNames 目录内文件/目录名列表
-     * @returns {Array<{ eco: string, buildTool: string }>}
+     * @param entryNames 目录内文件/目录名列表
+     * @returns >}
      */
     static matchBuildMarkers(entryNames: string[]): {
         eco: string;
@@ -188,11 +146,10 @@ export declare class LanguageService {
      *   1. 若传入 discovererIds（来自 ModuleService），直接映射为语言
      *   2. 否则扫描项目目录的构建系统标记文件（支持 monorepo 多层扫描）
      *
-     * @param {string} projectRoot 项目根目录绝对路径
-     * @param {object} [opts]
-     * @param {string[]} [opts.discovererIds] - ModuleService 检测到的生态 ID
-     * @param {number}   [opts.maxDepth=2]    最大扫描深度：0=仅根目录，1=+子目录，2=+孙目录
-     * @returns {string[]} 规范化语言 ID 数组（如 ['rust', 'dart']）
+     * @param projectRoot 项目根目录绝对路径
+     * @param [opts.discovererIds] ModuleService 检测到的生态 ID
+     * @param [opts.maxDepth=2] 最大扫描深度：0=仅根目录，1=+子目录，2=+孙目录
+     * @returns 规范化语言 ID 数组（如 ['rust', 'dart']）
      */
     static detectProjectLanguages(projectRoot: string, opts?: {
         discovererIds?: string[];
@@ -200,4 +157,3 @@ export declare class LanguageService {
     }): unknown[];
 }
 export default LanguageService;
-//# sourceMappingURL=LanguageService.d.ts.map