autosnippet 3.3.6 → 3.3.8

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

@@ -0,0 +1,109 @@
+/**
+ * LanguageProfiles — 全景分析多语言统一注册中心
+ *
+ * 设计原则:
+ *   1. **语言族 (LanguageFamily)** 是核心抽象 — 同族语言共享 import 语法、框架类体系、生态库
+ *   2. **单一数据源** — 新增语言只需添加一条 FamilyProfile，所有消费者自动生效
+ *   3. **与 LanguageService 互补** — LanguageService 管理基础映射 (ext→lang)，
+ *      LanguageProfiles 管理分析知识 (import 解析、角色推断、技术栈分类)
+ *   4. **按关注点暴露 API** — 消费者调用自己需要的访问器，无需了解内部数据结构
+ *
+ * 消费者:
+ *   - CouplingAnalyzer  → importPatterns, sourceExts
+ *   - RoleRefiner        → familyOf, superclassRoles, protocolRoles, importRolePatterns
+ *   - TechStackProfiler  → knownLibraries, keywordCategories
+ *   - ModuleDiscoverer   → skipDirs, artifactSuffixes, vendorDirs, sourceExts
+ *
+ * @module LanguageProfiles
+ */
+/** 模块在软件架构中扮演的角色 */
+export type ModuleRole = 'core' | 'service' | 'ui' | 'networking' | 'storage' | 'test' | 'app' | 'routing' | 'utility' | 'model' | 'auth' | 'config' | 'feature';
+export type LanguageFamily = 'apple' | 'jvm' | 'dart' | 'python' | 'web' | 'go' | 'rust' | 'dotnet';
+/** import 语句解析模式 — 用于依赖边提取 */
+export interface ImportPattern {
+    /** 匹配 import 语句的正则 (对 trimmed 行执行) */
+    regex: RegExp;
+    /** 从匹配结果提取模块名候选列表 */
+    extract: (m: RegExpExecArray) => string[];
+}
+/** import 关键词 → 角色推断模式 */
+export interface RolePattern {
+    regex: RegExp;
+    role: ModuleRole;
+}
+export declare class LanguageProfiles {
+    /** 将规范化语言 ID 映射到语言族 */
+    static familyOf(langId: string): LanguageFamily | undefined;
+    /** 返回所有已注册的语言族 ID */
+    static allFamilies(): LanguageFamily[];
+    /** 根据主语言解析项目涉及的语言族 */
+    static resolveFamilies(primaryLang: string | null): LanguageFamily[];
+    /**
+     * 获取所有 import 解析模式 (合并全部语言族 + C/C++)
+     *
+     * CouplingAnalyzer 对每行代码尝试所有模式，
+     * 按「特异性递减」排列：最特殊的模式在前。
+     */
+    static get importPatterns(): readonly ImportPattern[];
+    /**
+     * 源代码文件扩展名集合 — 委托 LanguageService
+     *
+     * 消除 CouplingAnalyzer / ModuleDiscoverer 自建 SOURCE_EXTS 的重复。
+     */
+    static get sourceExts(): ReadonlySet<string>;
+    /**
+     * 合并指定语言族的超类→角色映射
+     * @param families 项目检测到的语言族
+     */
+    static superclassRoles(families: LanguageFamily[]): Record<string, ModuleRole>;
+    /**
+     * 合并指定语言族的协议/接口→角色映射
+     * @param families 项目检测到的语言族
+     */
+    static protocolRoles(families: LanguageFamily[]): Record<string, ModuleRole>;
+    /**
+     * 合并指定语言族的 import→角色模式 + 通用模式
+     * @param families 项目检测到的语言族
+     */
+    static importRolePatterns(families: LanguageFamily[]): RolePattern[];
+    /**
+     * 获取全量已知库→分类映射 (合并所有族 + 跨平台库)
+     *
+     * TechStackProfiler 不按族过滤 — 外部依赖可能跨生态
+     */
+    static get knownLibraries(): Readonly<Record<string, string>>;
+    /** 关键词启发式分类 — KNOWN_LIBRARIES 未命中时的 fallback */
+    static get keywordCategories(): ReadonlyArray<[RegExp, string]>;
+    /**
+     * 应跳过的目录名集合 (合并 LanguageService.scanSkipDirs + 各族额外目录)
+     */
+    static get skipDirs(): ReadonlySet<string>;
+    /** 构建产物后缀 (合并全部族) */
+    static get artifactSuffixes(): readonly string[];
+    /** Vendor / 第三方目录名集合 (合并通用 + 各族) */
+    static get vendorDirs(): ReadonlySet<string>;
+    /**
+     * 三方库路径正则 — 匹配路径中的 vendor 目录名或已知库名
+     *
+     * 组成:
+     *   1. vendorDirs + 常见 skip 目录 (Pods, Carthage, DerivedData, …)
+     *   2. knownLibraries 中所有库名 (首字母大写形式)
+     *
+     * 用于 Agent 工具层对搜索结果做三方库过滤。
+     */
+    static get thirdPartyPathRegex(): RegExp;
+    /**
+     * 多语言基类/根类型排除集 — 合并所有族的 superclassRoles + protocolRoles + 额外基础类型。
+     *
+     * 用于 getHotNodes() 等入度统计，排除高入度但无信息量的语言根类型。
+     * 新增语言族时自动生效，无需手动维护排除列表。
+     */
+    static get baseClassExclusions(): ReadonlySet<string>;
+    /**
+     * 合法代码语言集合 — 合并 LanguageService.knownLangs + 常见别名。
+     *
+     * QualityScorer 格式评分使用，判断 recipe 的 language 字段是否合法。
+     * 新增语言时只需在 LanguageService 添加，此处自动生效。
+     */
+    static get validCodeLanguages(): ReadonlySet<string>;
+}