autosnippet 3.2.10 → 3.2.12

package/dist/lib/infrastructure/monitoring/ErrorTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorTracker.js","sourceRoot":"","sources":["../../../../lib/infrastructure/monitoring/ErrorTracker.ts"],"names":[],"mappings":"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"}

package/dist/lib/infrastructure/monitoring/PerformanceMonitor.d.ts

@@ -0,0 +1,121 @@
+/**
+ * 性能监控中间件
+ * 记录 API 请求的响应时间、吞吐量和错误率
+ */
+interface EndpointStats {
+    count: number;
+    errors: number;
+    totalDuration: number;
+    minDuration: number;
+    maxDuration: number;
+    avgDuration: number;
+}
+interface RequestData {
+    route: string;
+    method: string;
+    path: string;
+    statusCode: number;
+    duration: number;
+    userAgent?: string;
+    ip?: string;
+    timestamp: string;
+}
+export declare class PerformanceMonitor {
+    config: {
+        slowRequestThreshold: number;
+        maxResponseTimeSamples: number;
+        maxSlowRequests: number;
+    };
+    metrics: {
+        requests: {
+            total: number;
+            success: number;
+            errors: number;
+        };
+        endpoints: Map<string, EndpointStats>;
+        responseTimes: number[];
+        slowRequests: RequestData[];
+        errorRate: number | string;
+        averageResponseTime: number;
+        startTime: number;
+        rpm?: number;
+        p95?: number;
+        p99?: number;
+    };
+    statsInterval: ReturnType<typeof setInterval>;
+    constructor();
+    /**
+     * Express 中间件
+     */
+    middleware(): (req: {
+        method: string;
+        path: string;
+        get: (header: string) => string | undefined;
+        ip?: string;
+    }, res: {
+        on: (event: string, cb: () => void) => void;
+        statusCode: number;
+    }, next: () => void) => void;
+    /**
+     * 记录请求
+     */
+    recordRequest(requestData: RequestData): void;
+    /**
+     * 计算统计数据
+     */
+    calculateStats(): void;
+    /**
+     * 获取统计信息
+     */
+    getStats(): {
+        summary: {
+            totalRequests: number;
+            successfulRequests: number;
+            failedRequests: number;
+            errorRate: string;
+            averageResponseTime: string;
+            requestsPerMinute: number | undefined;
+            p95ResponseTime: string;
+            p99ResponseTime: string;
+            uptime: number;
+        };
+        topEndpoints: {
+            avgDuration: number;
+            count: number;
+            errors: number;
+            totalDuration: number;
+            minDuration: number;
+            maxDuration: number;
+            route: string;
+        }[];
+        slowestEndpoints: {
+            route: string;
+            avgDuration: number;
+            count: number;
+        }[];
+        recentSlowRequests: {
+            route: string;
+            duration: string;
+            timestamp: string;
+            statusCode: number;
+        }[];
+    };
+    /**
+     * 重置统计
+     */
+    reset(): void;
+    /**
+     * 停止监控
+     */
+    shutdown(): void;
+}
+/**
+ * 初始化性能监控
+ */
+export declare function initPerformanceMonitor(): PerformanceMonitor;
+/**
+ * 获取性能监控实例
+ */
+export declare function getPerformanceMonitor(): PerformanceMonitor;
+export default PerformanceMonitor;
+//# sourceMappingURL=PerformanceMonitor.d.ts.map

package/dist/lib/infrastructure/monitoring/PerformanceMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerformanceMonitor.d.ts","sourceRoot":"","sources":["../../../../lib/infrastructure/monitoring/PerformanceMonitor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,kBAAkB;IAC7B,MAAM,EAAE;QAAE,oBAAoB,EAAE,MAAM,CAAC;QAAC,sBAAsB,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IAClG,OAAO,EAAE;QACP,QAAQ,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7D,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QACtC,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,YAAY,EAAE,WAAW,EAAE,CAAC;QAC5B,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;QAC3B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,aAAa,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;;IA6B9C;;OAEG;IACH,UAAU,KAEN,KAAK;QACH,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;QAC5C,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,EACD,KAAK;QAAE,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EACxE,MAAM,MAAM,IAAI;IA0BpB;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,WAAW;IAsEtC;;OAEG;IACH,cAAc;IAmCd;;OAEG;IACH,QAAQ;;;;;;;;;;;;;;mBAtND,MAAM;oBACL,MAAM;2BACC,MAAM;yBACR,MAAM;yBACN,MAAM;;;;;;;;;;;;;;;IA8PnB;;OAEG;IACH,KAAK;IAiBL;;OAEG;IACH,QAAQ;CAMT;AAKD;;GAEG;AACH,wBAAgB,sBAAsB,uBAQrC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,uBAKpC;AAED,eAAe,kBAAkB,CAAC"}

package/dist/lib/infrastructure/monitoring/PerformanceMonitor.js

@@ -0,0 +1,250 @@
+/**
+ * 性能监控中间件
+ * 记录 API 请求的响应时间、吞吐量和错误率
+ */
+import Logger from '../logging/Logger.js';
+export class PerformanceMonitor {
+    config;
+    metrics;
+    statsInterval;
+    constructor() {
+        this.metrics = {
+            requests: {
+                total: 0,
+                success: 0,
+                errors: 0,
+            },
+            endpoints: new Map(), // 各端点统计
+            responseTimes: [], // 最近 1000 个请求的响应时间
+            slowRequests: [], // 慢请求队列（> 1s）
+            errorRate: 0,
+            averageResponseTime: 0,
+            startTime: Date.now(),
+        };
+        this.config = {
+            slowRequestThreshold: 1000, // 慢请求阈值（毫秒）
+            maxResponseTimeSamples: 1000, // 保留样本数
+            maxSlowRequests: 100, // 最多保留慢请求数
+        };
+        // 定期计算统计数据（unref 避免阻止进程退出）
+        this.statsInterval = setInterval(() => this.calculateStats(), 30000);
+        if (this.statsInterval.unref) {
+            this.statsInterval.unref();
+        }
+    }
+    /**
+     * Express 中间件
+     */
+    middleware() {
+        return (req, res, next) => {
+            const startTime = Date.now();
+            const route = `${req.method} ${req.path}`;
+            // 响应完成时记录
+            res.on('finish', () => {
+                const duration = Date.now() - startTime;
+                const statusCode = res.statusCode;
+                this.recordRequest({
+                    route,
+                    method: req.method,
+                    path: req.path,
+                    statusCode,
+                    duration,
+                    userAgent: req.get('user-agent'),
+                    ip: req.ip,
+                    timestamp: new Date().toISOString(),
+                });
+            });
+            next();
+        };
+    }
+    /**
+     * 记录请求
+     */
+    recordRequest(requestData) {
+        const { route, statusCode, duration } = requestData;
+        // 总体统计
+        this.metrics.requests.total++;
+        if (statusCode >= 200 && statusCode < 400) {
+            this.metrics.requests.success++;
+        }
+        else if (statusCode >= 400) {
+            this.metrics.requests.errors++;
+        }
+        // 端点统计（限制 Map 上限避免内存泄漏）
+        if (!this.metrics.endpoints.has(route)) {
+            if (this.metrics.endpoints.size >= 500) {
+                // 淘汰最少访问的端点
+                let minKey = null, minCount = Infinity;
+                for (const [k, v] of this.metrics.endpoints) {
+                    if (v.count < minCount) {
+                        minCount = v.count;
+                        minKey = k;
+                    }
+                }
+                if (minKey) {
+                    this.metrics.endpoints.delete(minKey);
+                }
+            }
+            this.metrics.endpoints.set(route, {
+                count: 0,
+                errors: 0,
+                totalDuration: 0,
+                minDuration: Infinity,
+                maxDuration: 0,
+                avgDuration: 0,
+            });
+        }
+        const endpointStats = this.metrics.endpoints.get(route);
+        endpointStats.count++;
+        endpointStats.totalDuration += duration;
+        endpointStats.minDuration = Math.min(endpointStats.minDuration, duration);
+        endpointStats.maxDuration = Math.max(endpointStats.maxDuration, duration);
+        endpointStats.avgDuration = endpointStats.totalDuration / endpointStats.count;
+        if (statusCode >= 400) {
+            endpointStats.errors++;
+        }
+        // 响应时间样本
+        this.metrics.responseTimes.push(duration);
+        if (this.metrics.responseTimes.length > this.config.maxResponseTimeSamples) {
+            this.metrics.responseTimes.shift();
+        }
+        // 慢请求记录（排除设计上就是长耗时的 long-poll 端点）
+        const isLongPoll = route.includes('/remote/wait');
+        if (duration > this.config.slowRequestThreshold && !isLongPoll) {
+            this.metrics.slowRequests.push({
+                ...requestData,
+                duration,
+            });
+            if (this.metrics.slowRequests.length > this.config.maxSlowRequests) {
+                this.metrics.slowRequests.shift();
+            }
+            Logger.warn(`🐢 慢请求: ${route} - ${duration}ms`);
+        }
+    }
+    /**
+     * 计算统计数据
+     */
+    calculateStats() {
+        const { total, errors } = this.metrics.requests;
+        // 错误率
+        this.metrics.errorRate = total > 0 ? ((errors / total) * 100).toFixed(2) : 0;
+        // 平均响应时间
+        if (this.metrics.responseTimes.length > 0) {
+            const sum = this.metrics.responseTimes.reduce((acc, val) => acc + val, 0);
+            this.metrics.averageResponseTime = Math.round(sum / this.metrics.responseTimes.length);
+        }
+        // 每分钟请求数 (RPM)
+        const uptime = (Date.now() - this.metrics.startTime) / 1000 / 60; // 分钟
+        this.metrics.rpm = uptime > 0 ? Math.round(total / uptime) : 0;
+        // P95, P99 响应时间
+        if (this.metrics.responseTimes.length > 0) {
+            const sorted = [...this.metrics.responseTimes].sort((a, b) => a - b);
+            const p95Index = Math.floor(sorted.length * 0.95);
+            const p99Index = Math.floor(sorted.length * 0.99);
+            this.metrics.p95 = sorted[p95Index] || 0;
+            this.metrics.p99 = sorted[p99Index] || 0;
+        }
+        Logger.info('📊 性能统计已更新', {
+            requests: total,
+            errors,
+            errorRate: `${this.metrics.errorRate}%`,
+            avgResponseTime: `${this.metrics.averageResponseTime}ms`,
+            rpm: this.metrics.rpm,
+        });
+    }
+    /**
+     * 获取统计信息
+     */
+    getStats() {
+        this.calculateStats(); // 实时计算
+        const topEndpoints = Array.from(this.metrics.endpoints.entries())
+            .sort((a, b) => b[1].count - a[1].count)
+            .slice(0, 10)
+            .map(([route, stats]) => ({
+            route,
+            ...stats,
+            avgDuration: Math.round(stats.avgDuration),
+        }));
+        const slowestEndpoints = Array.from(this.metrics.endpoints.entries())
+            .sort((a, b) => b[1].avgDuration - a[1].avgDuration)
+            .slice(0, 10)
+            .map(([route, stats]) => ({
+            route,
+            avgDuration: Math.round(stats.avgDuration),
+            count: stats.count,
+        }));
+        return {
+            summary: {
+                totalRequests: this.metrics.requests.total,
+                successfulRequests: this.metrics.requests.success,
+                failedRequests: this.metrics.requests.errors,
+                errorRate: `${this.metrics.errorRate}%`,
+                averageResponseTime: `${this.metrics.averageResponseTime}ms`,
+                requestsPerMinute: this.metrics.rpm,
+                p95ResponseTime: `${this.metrics.p95 || 0}ms`,
+                p99ResponseTime: `${this.metrics.p99 || 0}ms`,
+                uptime: Math.round((Date.now() - this.metrics.startTime) / 1000), // 秒
+            },
+            topEndpoints,
+            slowestEndpoints,
+            recentSlowRequests: this.metrics.slowRequests.slice(-10).map((req) => ({
+                route: req.route,
+                duration: `${req.duration}ms`,
+                timestamp: req.timestamp,
+                statusCode: req.statusCode,
+            })),
+        };
+    }
+    /**
+     * 重置统计
+     */
+    reset() {
+        this.metrics = {
+            requests: {
+                total: 0,
+                success: 0,
+                errors: 0,
+            },
+            endpoints: new Map(),
+            responseTimes: [],
+            slowRequests: [],
+            errorRate: 0,
+            averageResponseTime: 0,
+            startTime: Date.now(),
+        };
+        Logger.info('性能监控统计已重置');
+    }
+    /**
+     * 停止监控
+     */
+    shutdown() {
+        if (this.statsInterval) {
+            clearInterval(this.statsInterval);
+        }
+        Logger.info('性能监控已停止');
+    }
+}
+// 单例实例
+let performanceMonitorInstance = null;
+/**
+ * 初始化性能监控
+ */
+export function initPerformanceMonitor() {
+    if (performanceMonitorInstance) {
+        return performanceMonitorInstance;
+    }
+    performanceMonitorInstance = new PerformanceMonitor();
+    Logger.info('✅ 性能监控已启用');
+    return performanceMonitorInstance;
+}
+/**
+ * 获取性能监控实例
+ */
+export function getPerformanceMonitor() {
+    if (!performanceMonitorInstance) {
+        throw new Error('性能监控未初始化，请先调用 initPerformanceMonitor()');
+    }
+    return performanceMonitorInstance;
+}
+export default PerformanceMonitor;
+//# sourceMappingURL=PerformanceMonitor.js.map

package/dist/lib/infrastructure/monitoring/PerformanceMonitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerformanceMonitor.js","sourceRoot":"","sources":["../../../../lib/infrastructure/monitoring/PerformanceMonitor.ts"],"names":[],"mappings":"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"}

package/dist/lib/infrastructure/paths/HeaderResolver.d.ts

@@ -0,0 +1,45 @@
+/**
+ * HeaderResolver — ObjC/Swift #import 头文件路径解析
+ * 解析 import 语句，定位头文件相对路径
+ */
+/**
+ * 解析单行 import 语句
+ */
+export declare function parseImportLine(headerStr: string): {
+    moduleName: string;
+    headerName: string;
+} | {
+    moduleName: null;
+    headerName: string;
+} | null;
+/**
+ * 解析单个 import 的相对路径
+ */
+export declare function resolveHeaderRelativePath(headerStr: string, targetRootDir: string): Promise<string | undefined>;
+/**
+ * 从文件路径和 Package 信息推断模块名
+ */
+export declare function determineModuleNameFromPath(filePath: string, packageInfo: {
+    path: string;
+    targets?: string[];
+    name?: string;
+}): string | null;
+/**
+ * 综合解析：从路径+文本提取 headers、headerPaths、moduleName
+ * @param {string} projectRoot
+ * @param {string} relativePath
+ * @param {string} text
+ */
+export declare function resolveHeadersForText(projectRoot: string, relativePath: string, text: string): Promise<{
+    headers: string[];
+    headerPaths: (string | undefined)[];
+    moduleName: string | null;
+}>;
+declare const _default: {
+    resolveHeadersForText: typeof resolveHeadersForText;
+    parseImportLine: typeof parseImportLine;
+    resolveHeaderRelativePath: typeof resolveHeaderRelativePath;
+    determineModuleNameFromPath: typeof determineModuleNameFromPath;
+};
+export default _default;
+//# sourceMappingURL=HeaderResolver.d.ts.map

package/dist/lib/infrastructure/paths/HeaderResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeaderResolver.d.ts","sourceRoot":"","sources":["../../../../lib/infrastructure/paths/HeaderResolver.ts"],"names":[],"mappings":"AAIA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM;;;;;;SAgBhD;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,+BAcvF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,iBAUjE;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM;;;;GAuCb;;;;;;;AAED,wBAKE"}

package/dist/lib/infrastructure/paths/HeaderResolver.js

@@ -0,0 +1,102 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import * as PathFinder from './PathFinder.js';
+/**
+ * HeaderResolver — ObjC/Swift #import 头文件路径解析
+ * 解析 import 语句，定位头文件相对路径
+ */
+/**
+ * 解析单行 import 语句
+ */
+export function parseImportLine(headerStr) {
+    const s = String(headerStr || '').trim();
+    const angle = s.match(/#import\s+<([^>]+)>/);
+    if (angle) {
+        const part = angle[1].trim();
+        const slash = part.indexOf('/');
+        if (slash !== -1) {
+            return { moduleName: part.slice(0, slash), headerName: path.basename(part, '.h') };
+        }
+        return { moduleName: null, headerName: path.basename(part, '.h') };
+    }
+    const quote = s.match(/#import\s+"([^"]+)"/);
+    if (quote) {
+        return { moduleName: null, headerName: path.basename(quote[1], '.h') };
+    }
+    return null;
+}
+/**
+ * 解析单个 import 的相对路径
+ */
+export async function resolveHeaderRelativePath(headerStr, targetRootDir) {
+    if (!targetRootDir) {
+        return undefined;
+    }
+    const parsed = parseImportLine(headerStr);
+    if (!parsed) {
+        return undefined;
+    }
+    const { moduleName, headerName } = parsed;
+    const headerPath = await PathFinder.findSubHeaderPath(targetRootDir, headerName, moduleName);
+    if (!headerPath) {
+        return undefined;
+    }
+    return path.relative(targetRootDir, headerPath);
+}
+/**
+ * 从文件路径和 Package 信息推断模块名
+ */
+export function determineModuleNameFromPath(filePath, packageInfo) {
+    const relativePath = path.relative(packageInfo.path, filePath);
+    const segments = relativePath.split(path.sep);
+    for (let i = segments.length - 1; i >= 0; i--) {
+        if (packageInfo.targets?.includes(segments[i])) {
+            return segments[i];
+        }
+    }
+    return packageInfo.targets?.[0] || packageInfo.name || null;
+}
+/**
+ * 综合解析：从路径+文本提取 headers、headerPaths、moduleName
+ * @param {string} projectRoot
+ * @param {string} relativePath
+ * @param {string} text
+ */
+export async function resolveHeadersForText(projectRoot, relativePath, text) {
+    const fullPath = path.resolve(projectRoot, (relativePath || '').trim());
+    if (!relativePath || !fs.existsSync(fullPath)) {
+        return { headers: [], headerPaths: [], moduleName: null };
+    }
+    const targetRootDir = await PathFinder.findTargetRootDir(fullPath);
+    let moduleName = targetRootDir ? path.basename(targetRootDir) : null;
+    const importRegex = /^(?:#import|import)\s+.*$/gm;
+    let headers = (text.match(importRegex) || []).filter(Boolean);
+    let headerPaths = targetRootDir
+        ? await Promise.all(headers.map((h) => resolveHeaderRelativePath(h, targetRootDir)))
+        : [];
+    // 如果 .m/.mm 无 import，尝试推断同名 .h
+    const ext = path.extname(fullPath).toLowerCase();
+    if (targetRootDir && headers.length === 0 && (ext === '.m' || ext === '.mm')) {
+        const headerNameWithoutExt = path.basename(fullPath, ext);
+        const packagePath = await PathFinder.findPackageSwiftPath(fullPath);
+        const packageInfo = packagePath ? await PathFinder.parsePackageSwift(packagePath) : null;
+        if (packageInfo) {
+            moduleName = determineModuleNameFromPath(fullPath, packageInfo);
+        }
+        const headerPath = await PathFinder.findSubHeaderPath(targetRootDir, headerNameWithoutExt, moduleName);
+        if (headerPath) {
+            headers = [
+                `#import <${moduleName || path.basename(targetRootDir)}/${headerNameWithoutExt}.h>`,
+            ];
+            headerPaths = [path.relative(targetRootDir, headerPath)];
+        }
+    }
+    return { headers, headerPaths, moduleName };
+}
+export default {
+    resolveHeadersForText,
+    parseImportLine,
+    resolveHeaderRelativePath,
+    determineModuleNameFromPath,
+};
+//# sourceMappingURL=HeaderResolver.js.map

package/dist/lib/infrastructure/paths/HeaderResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeaderResolver.js","sourceRoot":"","sources":["../../../../lib/infrastructure/paths/HeaderResolver.ts"],"names":[],"mappings":"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"}

package/dist/lib/infrastructure/paths/PathFinder.d.ts

@@ -0,0 +1,38 @@
+/**
+ * PathFinder — 轻量级路径发现工具（V2 ESM）
+ * 从文件路径向上查找 SPM 项目结构：Package.swift、Target 根目录、头文件路径
+ */
+/**
+ * 向上遍历目录，查找含 Code/ 或 Sources/ 子目录的 target 根目录
+ * @param {string} filePath
+ * @returns {Promise<string|null>}
+ */
+export declare function findTargetRootDir(filePath: string): Promise<string | null>;
+/**
+ * 向上查找 Package.swift
+ */
+export declare function findPackageSwiftPath(filePath: string): Promise<string | null>;
+/**
+ * 简易解析 Package.swift，提取 targets 数组和包名
+ */
+export declare function parsePackageSwift(packagePath: string): Promise<{
+    name: string;
+    path: string;
+    targets: string[];
+} | null>;
+/**
+ * 在 targetRootDir 下递归查找指定头文件
+ * @param {string} rootDir - target 根目录
+ * @param {string} headerName 不含扩展名的头文件名
+ * @param {string|null} moduleName 模块名（可选，用于优先匹配模块子目录）
+ * @returns {Promise<string|null>}
+ */
+export declare function findSubHeaderPath(rootDir: string, headerName: string, moduleName: string | null): Promise<string | null>;
+declare const _default: {
+    findTargetRootDir: typeof findTargetRootDir;
+    findPackageSwiftPath: typeof findPackageSwiftPath;
+    parsePackageSwift: typeof parsePackageSwift;
+    findSubHeaderPath: typeof findSubHeaderPath;
+};
+export default _default;
+//# sourceMappingURL=PathFinder.d.ts.map

package/dist/lib/infrastructure/paths/PathFinder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathFinder.d.ts","sourceRoot":"","sources":["../../../../lib/infrastructure/paths/PathFinder.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAEH;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,0BAoBvD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,0BAc1D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM;;;;UAgB1D;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAAG,IAAI,0BAkB1B;;;;;;;AA4BD,wBAKE"}