autosnippet 3.3.6 → 3.3.8

package/dist/lib/core/discovery/parsers/GradleDslParser.js

@@ -0,0 +1,171 @@
+/**
+ * @module GradleDslParser
+ * @description Gradle DSL 轻量解析器 — 从 settings.gradle.kts / build.gradle.kts 提取项目拓扑
+ *
+ * 支持解析：
+ *  - settings.gradle.kts: rootProject.name + include() 模块声明
+ *  - build.gradle.kts: plugins {} + dependencies {} (project-to-project)
+ *  - settings.gradle (Groovy 语法)
+ *
+ * 同时支持 Kotlin DSL 和 Groovy DSL 的正则模式。
+ */
+// ── settings.gradle 解析模式 ─────────────────────────
+const SETTINGS_ROOT_NAME_KT = /rootProject\.name\s*=\s*"([^"]+)"/;
+const SETTINGS_ROOT_NAME_GR = /rootProject\.name\s*=\s*'([^']+)'/;
+// Kotlin DSL: include(":core:network") 或 include(":app", ":core")
+const INCLUDE_KT = /include\(\s*((?:"[^"]+"(?:\s*,\s*)?)+)\s*\)/g;
+// Groovy DSL: include ':core:network' 或 include ':app', ':core'
+const INCLUDE_GR = /include\s+((?:'[^']+'(?:\s*,\s*)?)+)/g;
+// ── build.gradle 解析模式 ────────────────────────────
+// Kotlin DSL: id("myapp.android.feature")
+const PLUGIN_KT = /id\(\s*"([^"]+)"\s*\)/g;
+// Groovy DSL: id 'myapp.android.feature'
+const PLUGIN_GR = /id\s+'([^']+)'/g;
+// Kotlin DSL: implementation(project(":core:network"))
+const PROJECT_DEP_KT = /(implementation|api|compileOnly|testImplementation|runtimeOnly|kapt|ksp)\s*\(\s*project\(\s*"([^"]+)"\s*\)\s*\)/g;
+// Groovy DSL: implementation project(':core:network')
+const PROJECT_DEP_GR = /(implementation|api|compileOnly|testImplementation|runtimeOnly|kapt|ksp)\s+project\(\s*['"]([^'"]+)['"]\s*\)/g;
+// kotlin("multiplatform") plugin detection
+const KMP_PLUGIN_RE = /kotlin\(\s*"multiplatform"\s*\)/;
+// ── 公开 API ────────────────────────────────────────
+/**
+ * 解析 settings.gradle.kts / settings.gradle 内容
+ * 提取 rootProject 名和所有 include 模块
+ *
+ * 当传入 build 文件内容时（附带 module 参数），解析 plugins 和 dependencies 到该模块上
+ */
+export function parseGradleProject(content, existingModule) {
+    const result = {
+        rootProjectName: '',
+        includedModules: [],
+    };
+    // 如果传入了 existingModule，解析 build 文件内容
+    if (existingModule) {
+        const updatedMod = parseBuildFileForModule(content, existingModule);
+        result.includedModules = [updatedMod];
+        return result;
+    }
+    // 解析 rootProject.name
+    const rootNameKt = content.match(SETTINGS_ROOT_NAME_KT);
+    const rootNameGr = content.match(SETTINGS_ROOT_NAME_GR);
+    result.rootProjectName = rootNameKt?.[1] ?? rootNameGr?.[1] ?? '';
+    // 解析 include 声明
+    const modules = new Map();
+    // Kotlin DSL includes
+    const ktContent = content;
+    let m;
+    const ktIncludeRe = new RegExp(INCLUDE_KT.source, 'g');
+    while ((m = ktIncludeRe.exec(ktContent)) !== null) {
+        const innerStr = m[1];
+        const pathRe = /"([^"]+)"/g;
+        let pathMatch;
+        while ((pathMatch = pathRe.exec(innerStr)) !== null) {
+            const modPath = pathMatch[1];
+            if (!modules.has(modPath)) {
+                modules.set(modPath, {
+                    path: modPath,
+                    directory: modPath.replace(/^:/, '').replace(/:/g, '/'),
+                    dependencies: [],
+                });
+            }
+        }
+    }
+    // Groovy DSL includes
+    const grIncludeRe = new RegExp(INCLUDE_GR.source, 'g');
+    while ((m = grIncludeRe.exec(content)) !== null) {
+        const innerStr = m[1];
+        const pathRe = /'([^']+)'/g;
+        let pathMatch;
+        while ((pathMatch = pathRe.exec(innerStr)) !== null) {
+            const modPath = pathMatch[1];
+            if (!modules.has(modPath)) {
+                modules.set(modPath, {
+                    path: modPath,
+                    directory: modPath.replace(/^:/, '').replace(/:/g, '/'),
+                    dependencies: [],
+                });
+            }
+        }
+    }
+    // 检测 version catalog
+    if (content.includes('libs.versions.toml') || content.includes('versionCatalogs')) {
+        result.versionCatalog = 'gradle/libs.versions.toml';
+    }
+    result.includedModules = [...modules.values()];
+    return result;
+}
+/**
+ * 检测 build 文件中是否使用了 Kotlin Multiplatform 插件
+ */
+export function isKmpBuildFile(content) {
+    return KMP_PLUGIN_RE.test(content);
+}
+// ── 内部函数 ────────────────────────────────────────
+function parseBuildFileForModule(content, module) {
+    const result = { ...module, dependencies: [] };
+    // 提取 convention plugin
+    const pluginKtRe = new RegExp(PLUGIN_KT.source, 'g');
+    const pluginGrRe = new RegExp(PLUGIN_GR.source, 'g');
+    let m;
+    while ((m = pluginKtRe.exec(content)) !== null) {
+        const pluginId = m[1];
+        // Convention plugins 通常是项目自定义的（包含项目名前缀）
+        if (pluginId.includes('.') &&
+            !pluginId.startsWith('com.android') &&
+            !pluginId.startsWith('org.jetbrains')) {
+            result.conventionPlugin = pluginId;
+            break;
+        }
+    }
+    if (!result.conventionPlugin) {
+        while ((m = pluginGrRe.exec(content)) !== null) {
+            const pluginId = m[1];
+            if (pluginId.includes('.') &&
+                !pluginId.startsWith('com.android') &&
+                !pluginId.startsWith('org.jetbrains')) {
+                result.conventionPlugin = pluginId;
+                break;
+            }
+        }
+    }
+    // 提取 project dependencies
+    const depKtRe = new RegExp(PROJECT_DEP_KT.source, 'g');
+    const depGrRe = new RegExp(PROJECT_DEP_GR.source, 'g');
+    while ((m = depKtRe.exec(content)) !== null) {
+        result.dependencies.push({
+            configuration: m[1],
+            target: m[2],
+            isProject: true,
+        });
+    }
+    while ((m = depGrRe.exec(content)) !== null) {
+        result.dependencies.push({
+            configuration: m[1],
+            target: m[2],
+            isProject: true,
+        });
+    }
+    return result;
+}
+/**
+ * 从 convention plugin id 推断模块角色
+ * 例: "myapp.android.feature" → "feature"
+ */
+export function inferConventionRole(pluginId) {
+    const parts = pluginId.split('.');
+    const last = parts[parts.length - 1];
+    const ROLE_KEYWORDS = {
+        feature: 'feature',
+        library: 'library',
+        app: 'application',
+        application: 'application',
+        core: 'core',
+        data: 'data',
+        domain: 'domain',
+        ui: 'ui',
+        test: 'test',
+        compose: 'compose',
+        hilt: 'di',
+    };
+    return ROLE_KEYWORDS[last] ?? undefined;
+}

package/dist/lib/core/discovery/parsers/JsonConfigParser.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @module JsonConfigParser
+ * @description JSON 配置文件解析器 — 支持 Nx project.json、Flutter 插件依赖、React Native 检测
+ *
+ * 每个解析函数接受文件内容字符串，返回类型化结果。
+ */
+export interface ParsedNxWorkspace {
+    projects: NxProject[];
+}
+export interface NxProject {
+    name: string;
+    root: string;
+    projectType: string;
+    tags: string[];
+}
+export interface ParsedFlutterPluginsDeps {
+    plugins: FlutterPlugin[];
+    flutterSdkVersion?: string;
+}
+export interface FlutterPlugin {
+    name: string;
+    path: string;
+    platform: string;
+}
+export interface ParsedReactNativeProject {
+    isReactNative: boolean;
+    name: string;
+    rnVersion?: string;
+    hasFabric?: boolean;
+    hasTurboModules?: boolean;
+}
+/**
+ * 解析 Nx project.json 内容
+ * 每个 project.json 描述一个项目
+ */
+export declare function parseNxWorkspace(content: string): ParsedNxWorkspace;
+/**
+ * 解析 .flutter-plugins-dependencies 文件内容
+ * 该文件由 Flutter 工具链自动生成
+ */
+export declare function parseFlutterPluginsDeps(content: string): ParsedFlutterPluginsDeps;
+/**
+ * 解析 package.json 内容，判断是否是 React Native 项目
+ */
+export declare function parseReactNativeProject(content: string): ParsedReactNativeProject;

package/dist/lib/core/discovery/parsers/JsonConfigParser.js

@@ -0,0 +1,122 @@
+/**
+ * @module JsonConfigParser
+ * @description JSON 配置文件解析器 — 支持 Nx project.json、Flutter 插件依赖、React Native 检测
+ *
+ * 每个解析函数接受文件内容字符串，返回类型化结果。
+ */
+// ── Nx 解析 ─────────────────────────────────────────
+/**
+ * 解析 Nx project.json 内容
+ * 每个 project.json 描述一个项目
+ */
+export function parseNxWorkspace(content) {
+    const result = { projects: [] };
+    try {
+        const json = JSON.parse(content);
+        const name = json.name ?? '';
+        const root = json.root ?? json.sourceRoot ?? '.';
+        const projectType = json.projectType ?? 'library';
+        const tags = Array.isArray(json.tags) ? json.tags : [];
+        if (name) {
+            result.projects.push({ name, root, projectType, tags });
+        }
+    }
+    catch {
+        // JSON 解析失败时返回空结果
+    }
+    return result;
+}
+// ── Flutter 解析 ────────────────────────────────────
+/**
+ * 解析 .flutter-plugins-dependencies 文件内容
+ * 该文件由 Flutter 工具链自动生成
+ */
+export function parseFlutterPluginsDeps(content) {
+    const result = { plugins: [] };
+    try {
+        const json = JSON.parse(content);
+        // dependencyGraph 数组包含 Flutter embedding 信息
+        const depGraph = json.dependencyGraph;
+        if (Array.isArray(depGraph)) {
+            for (const entry of depGraph) {
+                if (typeof entry === 'object' && entry !== null) {
+                    const rec = entry;
+                    const name = rec.name ?? '';
+                    if (name && name !== 'flutter') {
+                        result.plugins.push({
+                            name,
+                            path: rec.path ?? '',
+                            platform: 'flutter',
+                        });
+                    }
+                }
+            }
+        }
+        // 也解析 plugins.ios / plugins.android 中的平台插件
+        const plugins = json.plugins;
+        if (typeof plugins === 'object' && plugins !== null) {
+            const platformPlugins = plugins;
+            for (const [platform, list] of Object.entries(platformPlugins)) {
+                if (Array.isArray(list)) {
+                    for (const p of list) {
+                        if (typeof p === 'object' && p !== null) {
+                            const rec = p;
+                            const name = rec.name ?? '';
+                            // 避免重复
+                            if (name &&
+                                !result.plugins.some((existing) => existing.name === name && existing.platform === platform)) {
+                                result.plugins.push({
+                                    name,
+                                    path: rec.path ?? '',
+                                    platform,
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        // Flutter SDK 版本
+        if (typeof json.flutterVersion === 'string') {
+            result.flutterSdkVersion = json.flutterVersion;
+        }
+    }
+    catch {
+        // JSON 解析失败时返回空结果
+    }
+    return result;
+}
+// ── React Native 解析 ──────────────────────────────
+/**
+ * 解析 package.json 内容，判断是否是 React Native 项目
+ */
+export function parseReactNativeProject(content) {
+    const result = {
+        isReactNative: false,
+        name: '',
+    };
+    try {
+        const json = JSON.parse(content);
+        result.name = json.name ?? '';
+        const deps = (json.dependencies ?? {});
+        const devDeps = (json.devDependencies ?? {});
+        if (deps['react-native'] || devDeps['react-native']) {
+            result.isReactNative = true;
+            result.rnVersion = deps['react-native'] ?? devDeps['react-native'];
+        }
+        // Fabric (new architecture) 检测
+        if (result.isReactNative) {
+            const scripts = (json.scripts ?? {});
+            result.hasFabric =
+                deps['react-native-codegen'] !== undefined ||
+                    Object.values(scripts).some((s) => s.includes('codegen'));
+            // TurboModules 检测
+            result.hasTurboModules =
+                typeof json.codegenConfig === 'object' || deps['react-native-turbo-modules'] !== undefined;
+        }
+    }
+    catch {
+        // JSON 解析失败时返回空结果
+    }
+    return result;
+}

package/dist/lib/core/discovery/parsers/RubyDslParser.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @module RubyDslParser
+ * @description Ruby DSL 轻量解析器 — 从 Boxfile / podspec 类文件中提取项目结构信息
+ *
+ * 不需要完整的 Ruby 解析器，使用正则 + 上下文状态机提取：
+ *  - 层级 (layer) 声明与层间访问规则
+ *  - 模块 (box) 声明（本地/远程）
+ *  - 宿主应用信息
+ *  - 模块级 spec 依赖/源文件路径
+ *
+ * 支持 EasyBox (Boxfile + *.boxspec) 和结构类似的自研工具。
+ */
+export interface ParsedModule {
+    name: string;
+    version: string;
+    isLocal: boolean;
+    localPath?: string;
+    group?: string;
+}
+export interface ParsedLayer {
+    name: string;
+    order: number;
+    accessibleLayers: string[];
+    modules: ParsedModule[];
+}
+export interface ParsedProjectConfig {
+    hostApp?: {
+        name: string;
+        version: string;
+    };
+    layers: ParsedLayer[];
+    globalDependencies: ParsedModule[];
+}
+export interface ParsedModuleSpec {
+    name: string;
+    version: string;
+    sources: string;
+    dependencies: string[];
+    publicHeaders: string[];
+    deploymentTarget?: string;
+}
+/**
+ * 解析 Boxfile 内容，提取层级、模块、宿主应用信息
+ */
+export declare function parseBoxfile(content: string): ParsedProjectConfig;
+/**
+ * 解析 boxspec/podspec 文件内容，提取模块元数据
+ */
+export declare function parseModuleSpec(content: string): ParsedModuleSpec;

package/dist/lib/core/discovery/parsers/RubyDslParser.js

@@ -0,0 +1,282 @@
+/**
+ * @module RubyDslParser
+ * @description Ruby DSL 轻量解析器 — 从 Boxfile / podspec 类文件中提取项目结构信息
+ *
+ * 不需要完整的 Ruby 解析器，使用正则 + 上下文状态机提取：
+ *  - 层级 (layer) 声明与层间访问规则
+ *  - 模块 (box) 声明（本地/远程）
+ *  - 宿主应用信息
+ *  - 模块级 spec 依赖/源文件路径
+ *
+ * 支持 EasyBox (Boxfile + *.boxspec) 和结构类似的自研工具。
+ */
+// ── Boxfile 解析 ────────────────────────────────────
+/**
+ * 解析 Boxfile 内容，提取层级、模块、宿主应用信息
+ */
+export function parseBoxfile(content) {
+    const result = {
+        layers: [],
+        globalDependencies: [],
+    };
+    // 提取 host_app
+    const hostAppMatch = content.match(/host_app\s+['"]([^'"]+)['"]\s*(?:,\s*['"]([^'"]+)['"])?/);
+    if (hostAppMatch) {
+        result.hostApp = {
+            name: hostAppMatch[1],
+            version: hostAppMatch[2] || '0.0.0',
+        };
+    }
+    // 按 layer block 分割解析
+    const layerBlocks = extractLayerBlocks(content);
+    let layerOrder = 0;
+    for (const block of layerBlocks) {
+        const layer = {
+            name: block.name,
+            order: layerOrder++,
+            accessibleLayers: extractAccessLayers(block.body),
+            modules: extractModules(block.body),
+        };
+        result.layers.push(layer);
+    }
+    // 提取 layer 外层的全局模块声明
+    const outsideLayerContent = removeLayerBlocks(content);
+    result.globalDependencies = extractModules(outsideLayerContent);
+    return result;
+}
+// ── *.boxspec / *.podspec 解析 ────────────────────────
+/**
+ * 解析 boxspec/podspec 文件内容，提取模块元数据
+ */
+export function parseModuleSpec(content) {
+    return {
+        name: extractSpecField(content, 'name') || 'unknown',
+        version: extractSpecField(content, 'version') || '0.0.0',
+        sources: extractSpecField(content, 'source_files') ||
+            extractSpecField(content, 'sources') ||
+            extractSpecField(content, 'source') ||
+            '',
+        dependencies: extractSpecDependencies(content),
+        publicHeaders: extractSpecArrayField(content, 'public_headers') ||
+            extractSpecArrayField(content, 'public_header_files') ||
+            [],
+        deploymentTarget: extractSpecDeploymentTarget(content),
+    };
+}
+/**
+ * 提取所有 layer 'Name' do ... end 块
+ * 使用 do/end 嵌套计数处理嵌套 block
+ */
+function extractLayerBlocks(content) {
+    const blocks = [];
+    const layerRe = /layer\s+['"](\w+)['"]\s+do\b/g;
+    let match;
+    while ((match = layerRe.exec(content)) !== null) {
+        const name = match[1];
+        const startIndex = match.index;
+        const bodyStart = match.index + match[0].length;
+        const endIndex = findMatchingEnd(content, bodyStart);
+        if (endIndex === -1) {
+            continue;
+        }
+        blocks.push({
+            name,
+            body: content.substring(bodyStart, endIndex),
+            startIndex,
+            endIndex: endIndex + 3, // 'end' is 3 chars
+        });
+    }
+    return blocks;
+}
+/**
+ * 从 do 之后的位置开始，找到匹配的 end
+ * 处理嵌套的 do...end 块（如 group do ... end）
+ */
+function findMatchingEnd(content, startPos) {
+    let depth = 1;
+    // 逐行扫描以正确识别 do/end 关键字（避免匹配字符串内的）
+    const lines = content.substring(startPos).split('\n');
+    let pos = startPos;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // 跳过注释行
+        if (trimmed.startsWith('#')) {
+            pos += line.length + 1;
+            continue;
+        }
+        // 计算该行的 do 和 end
+        // 匹配行尾的 do（不匹配字符串内的）
+        if (/\bdo\b\s*(?:#.*)?$/.test(trimmed)) {
+            depth++;
+        }
+        // 匹配行首的 end（独立的 end 关键字）
+        if (/^\s*end\b/.test(line)) {
+            depth--;
+            if (depth === 0) {
+                return pos;
+            }
+        }
+        pos += line.length + 1;
+    }
+    return -1;
+}
+/**
+ * 移除所有 layer 块，返回剩余内容（用于提取全局模块）
+ */
+function removeLayerBlocks(content) {
+    const blocks = extractLayerBlocks(content);
+    if (blocks.length === 0) {
+        return content;
+    }
+    let result = '';
+    let lastEnd = 0;
+    for (const block of blocks) {
+        result += content.substring(lastEnd, block.startIndex);
+        lastEnd = block.endIndex;
+    }
+    result += content.substring(lastEnd);
+    return result;
+}
+// ── Box/模块提取 ────────────────────────────────────
+/**
+ * 从内容中提取所有 box 声明
+ *
+ * 支持格式：
+ *   box 'Name', 'Version'
+ *   box 'Name', :path => 'LocalModule/Name'
+ *   box 'Name', path: 'LocalModule/Name'
+ *   box 'Name', '~> 1.0', :path => '...'
+ */
+function extractModules(content) {
+    const modules = [];
+    const seen = new Set();
+    // 当前 group 上下文跟踪
+    let currentGroup;
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // 跳过注释
+        if (trimmed.startsWith('#')) {
+            continue;
+        }
+        // 检查 group 开始
+        const groupMatch = trimmed.match(/group\s+['"]([^'"]+)['"]\s+do/);
+        if (groupMatch) {
+            currentGroup = groupMatch[1];
+            continue;
+        }
+        // 检查 group/layer 结束
+        if (/^\s*end\b/.test(line) && currentGroup) {
+            currentGroup = undefined;
+            continue;
+        }
+        // 解析 box 声明
+        const boxMatch = trimmed.match(/^box\s+['"]([^'"]+)['"]/);
+        if (!boxMatch) {
+            continue;
+        }
+        const name = boxMatch[1];
+        if (seen.has(name)) {
+            continue;
+        }
+        seen.add(name);
+        const rest = trimmed.substring(boxMatch[0].length);
+        // 检查是否有 :path（本地模块）
+        const pathMatch = rest.match(/:path\s*=>\s*['"]([^'"]+)['"]|path:\s*['"]([^'"]+)['"]/);
+        const isLocal = pathMatch !== null;
+        const localPath = pathMatch ? pathMatch[1] || pathMatch[2] : undefined;
+        // 提取版本号
+        let version = '';
+        const versionMatch = rest.match(/,\s*['"]([^'"]+)['"]/);
+        if (versionMatch && !versionMatch[1].includes('/')) {
+            version = versionMatch[1];
+        }
+        modules.push({
+            name,
+            version,
+            isLocal,
+            localPath,
+            group: currentGroup,
+        });
+    }
+    return modules;
+}
+// ── Access 规则提取 ─────────────────────────────────
+/**
+ * 提取 access 声明中的层名列表
+ *
+ * 支持格式：
+ *   access 'Layer1', 'Layer2', 'Layer3'
+ *   access "Layer1", "Layer2"
+ */
+function extractAccessLayers(content) {
+    const layers = [];
+    const accessRe = /access\s+(.+)/g;
+    let match;
+    while ((match = accessRe.exec(content)) !== null) {
+        const rest = match[1];
+        const nameRe = /['"]([^'"]+)['"]/g;
+        let nameMatch;
+        while ((nameMatch = nameRe.exec(rest)) !== null) {
+            if (!layers.includes(nameMatch[1])) {
+                layers.push(nameMatch[1]);
+            }
+        }
+    }
+    return layers;
+}
+// ── Spec 字段提取 ───────────────────────────────────
+/**
+ * 从 podspec/boxspec 中提取单值字段
+ * 支持: s.name = 'Value' 和 spec.name = 'Value'
+ */
+function extractSpecField(content, field) {
+    const re = new RegExp(`\\b\\w+\\.${field}\\s*=\\s*['"]([^'"]+)['"]`, 'i');
+    const match = content.match(re);
+    return match ? match[1] : undefined;
+}
+/**
+ * 从 podspec/boxspec 中提取 dependency 声明列表
+ *
+ * 支持:
+ *   s.dependency 'ModuleName'
+ *   s.dependency 'ModuleName', '~> 1.0'
+ *   s.dependency "ModuleName"
+ */
+function extractSpecDependencies(content) {
+    const deps = [];
+    const re = /\b\w+\.dependency\s+['"]([^'"]+)['"]/g;
+    let match;
+    while ((match = re.exec(content)) !== null) {
+        if (!deps.includes(match[1])) {
+            deps.push(match[1]);
+        }
+    }
+    return deps;
+}
+/**
+ * 从 podspec/boxspec 中提取数组字段
+ * 支持: s.public_headers = ['path1', 'path2']
+ */
+function extractSpecArrayField(content, field) {
+    const re = new RegExp(`\\b\\w+\\.${field}\\s*=\\s*\\[([^\\]]+)\\]`, 'i');
+    const match = content.match(re);
+    if (!match) {
+        return undefined;
+    }
+    const items = [];
+    const itemRe = /['"]([^'"]+)['"]/g;
+    let m;
+    while ((m = itemRe.exec(match[1])) !== null) {
+        items.push(m[1]);
+    }
+    return items.length > 0 ? items : undefined;
+}
+/**
+ * 提取部署目标版本
+ * 支持: s.ios.deployment_target = '13.0'
+ */
+function extractSpecDeploymentTarget(content) {
+    const match = content.match(/\b\w+\.ios\.deployment_target\s*=\s*['"]([^'"]+)['"]/);
+    return match ? match[1] : undefined;
+}