autosnippet 3.2.15 → 3.2.17

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

package/dist/lib/shared/LanguageService.js

@@ -18,7 +18,6 @@ import { join } from 'node:path';
 // ═══════════════════════════════════════════════════════════
 // 1) 文件扩展名 → 规范化语言 ID
 // ═══════════════════════════════════════════════════════════
-/** @type {Readonly<Record<string, string>>} */
 const EXT_TO_LANG = Object.freeze({
     // Apple
     '.swift': 'swift',
@@ -66,7 +65,6 @@ const EXT_TO_LANG = Object.freeze({
 // 2) 裸扩展名（不带 dot）→ 规范化语言 ID
 //    用于 langStats（bootstrap 按 extname('.').replace('.','') 做 key）
 // ═══════════════════════════════════════════════════════════
-/** @type {Readonly<Record<string, string>>} */
 const BARE_EXT_TO_LANG = Object.freeze({
     swift: 'swift',
     m: 'objectivec',
@@ -98,7 +96,6 @@ const BARE_EXT_TO_LANG = Object.freeze({
 // ═══════════════════════════════════════════════════════════
 // 3) 语言 ID → 人类可读显示名
 // ═══════════════════════════════════════════════════════════
-/** @type {Readonly<Record<string, string>>} */
 const LANG_DISPLAY_NAMES = Object.freeze({
     swift: 'Swift',
     objectivec: 'Objective-C',
@@ -125,7 +122,6 @@ const LANG_DISPLAY_NAMES = Object.freeze({
 // ═══════════════════════════════════════════════════════════
 // 4) 已知可分析的编程语言集合
 // ═══════════════════════════════════════════════════════════
-/** @type {ReadonlySet<string>} */
 const KNOWN_PROGRAMMING_LANGS = Object.freeze(new Set([
     'swift',
     'objectivec',
@@ -145,7 +141,6 @@ const KNOWN_PROGRAMMING_LANGS = Object.freeze(new Set([
 // ═══════════════════════════════════════════════════════════
 // 5) 源代码扩展名（Guard / 文件收集时使用）
 // ═══════════════════════════════════════════════════════════
-/** @type {ReadonlySet<string>} */
 const SOURCE_CODE_EXTS = Object.freeze(new Set([
     '.m',
     '.mm',
@@ -177,7 +172,6 @@ const SOURCE_CODE_EXTS = Object.freeze(new Set([
 // ═══════════════════════════════════════════════════════════
 // 5.5) 语言别名映射 — 将常见缩写/变体归一化为规范 ID
 // ═══════════════════════════════════════════════════════════
-/** @type {Readonly<Record<string, string>>} */
 const LANG_ALIASES = Object.freeze({
     // Objective-C variants
     objc: 'objectivec',
@@ -210,7 +204,6 @@ const LANG_ALIASES = Object.freeze({
 // ═══════════════════════════════════════════════════════════
 // 6) 生态系统/Discoverer ID → 对应编程语言 ID 数组
 // ═══════════════════════════════════════════════════════════
-/** @type {Readonly<Record<string, readonly string[]>>} */
 const ECO_TO_LANGS = Object.freeze({
     spm: Object.freeze(['swift', 'objectivec']),
     node: Object.freeze(['javascript', 'typescript']),
@@ -226,10 +219,6 @@ const ECO_TO_LANGS = Object.freeze({
 // ═══════════════════════════════════════════════════════════
 // 7) 构建系统标志文件 → 生态系统映射（项目级语言检测的核心数据）
 // ═══════════════════════════════════════════════════════════
-/**
- * @typedef {{ file: string, eco: string, buildTool: string }} BuildSystemMarker
- * @type {ReadonlyArray<BuildSystemMarker>}
- */
 const BUILD_SYSTEM_MARKERS = Object.freeze([
     // Apple / iOS
     { file: 'Package.swift', eco: 'spm', buildTool: 'SPM' },
@@ -289,8 +278,7 @@ export class LanguageService {
     // ─── 文件名 → 语言 ────────────────────────────
     /**
      * 从文件名（或路径）推断规范化语言 ID
-     * @param {string} filename
-     * @returns {string} 语言 ID，如 'swift', 'typescript', 'python', 'unknown'
+     * @returns 语言 ID，如 'swift', 'typescript', 'python', 'unknown'
      */
     static inferLang(filename) {
         if (!filename || typeof filename !== 'string') {
@@ -305,8 +293,7 @@ export class LanguageService {
     }
     /**
      * 从文件扩展名（带 dot）推断语言
-     * @param {string} ext 如 '.ts', '.py'
-     * @returns {string}
+     * @param ext 如 '.ts', '.py'
      */
     static langFromExt(ext) {
         if (!ext || typeof ext !== 'string') {
@@ -325,8 +312,8 @@ export class LanguageService {
      *   normalize('swift')    → 'swift' (已是规范 ID)
      *   normalize('unknown')  → 'unknown'
      *
-     * @param {string} langId 语言 ID（可能是别名）
-     * @returns {string} 规范化语言 ID
+     * @param langId 语言 ID（可能是别名）
+     * @returns 规范化语言 ID
      */
     static normalize(langId) {
         if (!langId || typeof langId !== 'string') {
@@ -343,27 +330,19 @@ export class LanguageService {
      *
      * Guard 内置规则使用 'objc' 而非 'objectivec'。
      * 其他语言 ID 不变。
-     *
-     * @param {string} langId
-     * @returns {string}
      */
     static toGuardLangId(langId) {
         const id = (langId || '').toLowerCase().replace(/[_-]/g, '');
         return id === 'objectivec' ? 'objc' : langId;
     }
     // ─── 显示名 ────────────────────────────────────
-    /**
-     * 语言 ID → 人类可读名称
-     * @param {string} langId
-     * @returns {string}
-     */
+    /** 语言 ID → 人类可读名称 */
     static displayName(langId) {
         return LANG_DISPLAY_NAMES[langId] || langId;
     }
     /**
      * 文件扩展名（带 dot）→ 人类可读语言名
-     * @param {string} ext 如 '.swift', '.ts'
-     * @returns {string}
+     * @param ext 如 '.swift', '.ts'
      */
     static displayNameFromExt(ext) {
         const lang = EXT_TO_LANG[ext.toLowerCase()];
@@ -372,8 +351,8 @@ export class LanguageService {
     // ─── 主语言检测 ────────────────────────────────
     /**
      * 从文件扩展名统计推断主语言
-     * @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) {
         if (!langStats || typeof langStats !== 'object') {
@@ -396,8 +375,7 @@ export class LanguageService {
     }
     /**
      * 从文件扩展名统计返回所有检测到的编程语言（按文件数降序）
-     * @param {Record<string, number>} langStats
-     * @returns {Array<{ lang: string, count: number }>}
+     * @returns >}
      */
     static detectAll(langStats) {
         if (!langStats || typeof langStats !== 'object') {
@@ -421,10 +399,9 @@ export 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, opts = {}) {
         const threshold = opts.secondaryThreshold ?? 0.1;
@@ -448,54 +425,37 @@ export class LanguageService {
         };
     }
     // ─── 查询方法 ─────────────────────────────────
-    /**
-     * 该语言 ID 是否是已知编程语言
-     * @param {string} langId
-     * @returns {boolean}
-     */
+    /** 该语言 ID 是否是已知编程语言 */
     static isKnownLang(langId) {
         return KNOWN_PROGRAMMING_LANGS.has(langId);
     }
     /**
      * 该扩展名是否为源代码文件
-     * @param {string} ext 带 dot，如 '.ts'
-     * @returns {boolean}
+     * @param ext 带 dot，如 '.ts'
      */
     static isSourceExt(ext) {
         return SOURCE_CODE_EXTS.has(ext.toLowerCase());
     }
-    /**
-     * 获取所有源代码扩展名（不可变）
-     * @returns {ReadonlySet<string>}
-     */
+    /** 获取所有源代码扩展名（不可变） */
     static get sourceExts() {
         return SOURCE_CODE_EXTS;
     }
-    /**
-     * 获取所有已知编程语言 ID（不可变）
-     * @returns {ReadonlySet<string>}
-     */
+    /** 获取所有已知编程语言 ID（不可变） */
     static get knownLangs() {
         return KNOWN_PROGRAMMING_LANGS;
     }
-    /**
-     * 获取完整的 ext→lang 映射（不可变）
-     * @returns {Readonly<Record<string, string>>}
-     */
+    /** 获取完整的 ext→lang 映射（不可变） */
     static get extToLangMap() {
         return EXT_TO_LANG;
     }
-    /**
-     * 获取完整的 bareExt→lang 映射（不可变）
-     * @returns {Readonly<Record<string, string>>}
-     */
+    /** 获取完整的 bareExt→lang 映射（不可变） */
     static get bareExtToLangMap() {
         return BARE_EXT_TO_LANG;
     }
     /**
      * 根据语言 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) {
         if (!langId) {
@@ -510,38 +470,25 @@ export class LanguageService {
         return null;
     }
     // ─── 生态系统 / 项目级语言检测 ────────────────
-    /**
-     * 获取语言别名映射表（不可变）
-     * @returns {Readonly<Record<string, string>>}
-     */
+    /** 获取语言别名映射表（不可变） */
     static get langAliases() {
         return LANG_ALIASES;
     }
-    /**
-     * 获取 ECO_TO_LANGS 映射（不可变）
-     * @returns {Readonly<Record<string, readonly string[]>>}
-     */
+    /** 获取 ECO_TO_LANGS 映射（不可变） */
     static get ecoToLangs() {
         return ECO_TO_LANGS;
     }
-    /**
-     * 获取 BUILD_SYSTEM_MARKERS（不可变）
-     * @returns {ReadonlyArray<BuildSystemMarker>}
-     */
+    /** 获取 BUILD_SYSTEM_MARKERS（不可变） */
     static get buildSystemMarkers() {
         return BUILD_SYSTEM_MARKERS;
     }
-    /**
-     * 获取 SCAN_SKIP_DIRS（不可变）
-     * @returns {ReadonlySet<string>}
-     */
+    /** 获取 SCAN_SKIP_DIRS（不可变） */
     static get scanSkipDirs() {
         return SCAN_SKIP_DIRS;
     }
     /**
      * 根据生态系统/Discoverer ID 获取对应的语言 ID 数组
-     * @param {string} ecoId 如 'spm', 'node', 'rust', 'dart'
-     * @returns {readonly string[]}
+     * @param ecoId 如 'spm', 'node', 'rust', 'dart'
      */
     static langsForEco(ecoId) {
         return ECO_TO_LANGS[ecoId] || [];
@@ -549,8 +496,8 @@ export class LanguageService {
     /**
      * 检测构建系统标志文件 — 纯数据匹配，不访问文件系统
      *
-     * @param {string[]} entryNames 目录内文件/目录名列表
-     * @returns {Array<{ eco: string, buildTool: string }>}
+     * @param entryNames 目录内文件/目录名列表
+     * @returns >}
      */
     static matchBuildMarkers(entryNames) {
         if (!Array.isArray(entryNames) || entryNames.length === 0) {
@@ -581,11 +528,10 @@ export 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, opts = {}) {
         if (!projectRoot || typeof projectRoot !== 'string') {
@@ -684,4 +630,3 @@ export class LanguageService {
     }
 }
 export default LanguageService;
-//# sourceMappingURL=LanguageService.js.map