frontend-guardian-core 2.6.0

package/dist/utils/baseline.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * Baseline 管理器
+ *
+ * 支持已有问题不阻塞，仅关注新增问题的渐进式治理模式。
+ * 适用于遗留项目首次接入 frontend-guardian。
+ *
+ * 使用方式：
+ * 1. 首次运行：fg-core --baseline .fg-baseline.json --module all
+ *    → 扫描全部问题并保存为 baseline 文件
+ * 2. 后续运行：fg-core --baseline .fg-baseline.json --module all
+ *    → 仅报告新增问题（与 baseline 对比）
+ * 3. 定期刷新：删除 baseline 重新生成（清理已修复的遗留问题）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaselineManager = void 0;
+exports.toBaselineIssue = toBaselineIssue;
+exports.loadBaseline = loadBaseline;
+exports.saveBaseline = saveBaseline;
+exports.compareWithBaseline = compareWithBaseline;
+exports.generateBaseline = generateBaseline;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/** 问题匹配键 */
+function issueKey(issue) {
+    // 列号可选，允许小范围偏移（±5列）视为同一问题
+    const col = issue.column != null ? Math.round(issue.column / 5) * 5 : 0;
+    return `${issue.file}|${issue.ruleId}|${issue.line}|${col}`;
+}
+/** 将 Issue 精简为 BaselineIssue */
+function toBaselineIssue(issue) {
+    return {
+        file: issue.file,
+        ruleId: issue.ruleId,
+        line: issue.line,
+        column: issue.column,
+        severity: issue.severity,
+        title: issue.title,
+    };
+}
+/** 加载 baseline 文件 */
+function loadBaseline(filePath) {
+    try {
+        if (!(0, node_fs_1.existsSync)(filePath)) {
+            return null;
+        }
+        const raw = (0, node_fs_1.readFileSync)(filePath, "utf-8");
+        const data = JSON.parse(raw);
+        // 版本校验
+        if (!data.version || !Array.isArray(data.issues)) {
+            return null;
+        }
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+/** 保存 baseline 文件 */
+function saveBaseline(filePath, issues, meta) {
+    const baseline = {
+        version: "1.0",
+        generatedAt: Date.now(),
+        issues: issues.map(toBaselineIssue),
+        meta: {
+            toolVersion: "2.3.0",
+            ...meta,
+        },
+    };
+    (0, node_fs_1.writeFileSync)(filePath, JSON.stringify(baseline, null, 2), "utf-8");
+}
+/**
+ * 将当前扫描结果与 baseline 对比
+ * @param issues 当前扫描出的所有问题
+ * @param baselinePath baseline 文件路径（绝对或相对）
+ * @param projectDir 项目根目录（用于解析相对路径）
+ * @returns BaselineResult 对比结果
+ */
+function compareWithBaseline(issues, baselinePath, projectDir) {
+    const resolvedPath = (0, node_path_1.resolve)(projectDir, baselinePath);
+    const baseline = loadBaseline(resolvedPath);
+    if (!baseline) {
+        // baseline 文件不存在，返回全部问题作为 newIssues
+        return {
+            newIssues: issues,
+            knownIssues: [],
+            fixedIssues: [],
+            totalIssues: issues.length,
+            baselineLoaded: false,
+        };
+    }
+    const baselineKeys = new Set(baseline.issues.map((i) => issueKey(i)));
+    const currentKeys = new Set(issues.map((i) => issueKey(i)));
+    const newIssues = [];
+    const knownIssues = [];
+    for (const issue of issues) {
+        if (baselineKeys.has(issueKey(issue))) {
+            knownIssues.push(issue);
+        }
+        else {
+            newIssues.push(issue);
+        }
+    }
+    const fixedIssues = baseline.issues.filter((i) => !currentKeys.has(issueKey(i)));
+    return {
+        newIssues,
+        knownIssues,
+        fixedIssues,
+        totalIssues: issues.length,
+        baselineLoaded: true,
+    };
+}
+/**
+ * 生成或更新 baseline 文件
+ * 如果文件已存在则覆盖
+ */
+function generateBaseline(issues, baselinePath, projectDir, meta) {
+    const resolvedPath = (0, node_path_1.resolve)(projectDir, baselinePath);
+    saveBaseline(resolvedPath, issues, meta);
+}
+/**
+ * BaselineManager — 面向对象的封装
+ */
+class BaselineManager {
+    baselinePath;
+    projectDir;
+    baseline = null;
+    constructor(baselinePath, projectDir) {
+        this.baselinePath = (0, node_path_1.resolve)(projectDir, baselinePath);
+        this.projectDir = projectDir;
+        this.baseline = loadBaseline(this.baselinePath);
+    }
+    /** 是否已加载有效的 baseline */
+    isLoaded() {
+        return this.baseline !== null;
+    }
+    /** 获取已加载的 baseline 内容 */
+    getBaseline() {
+        return this.baseline;
+    }
+    /** 对比当前 issues，返回仅含新增问题的过滤结果 */
+    filterNewIssues(issues) {
+        return compareWithBaseline(issues, this.baselinePath, this.projectDir);
+    }
+    /** 将当前 issues 保存为 baseline（覆盖） */
+    save(issues, meta) {
+        saveBaseline(this.baselinePath, issues, meta);
+        this.baseline = loadBaseline(this.baselinePath);
+    }
+    /** 获取 baseline 文件路径 */
+    getPath() {
+        return this.baselinePath;
+    }
+}
+exports.BaselineManager = BaselineManager;
+//# sourceMappingURL=baseline.js.map

package/dist/utils/baseline.js.map

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

package/dist/utils/ci-generator.d.ts

@@ -0,0 +1,34 @@
+/**
+ * CI 配置自动生成工具
+ * 一键生成 GitHub Actions / GitLab CI 配置文件
+ */
+export type CIProvider = "github" | "gitlab" | "both";
+export interface CIGeneratorOptions {
+    provider: CIProvider;
+    /** Node.js 版本 */
+    nodeVersion?: string;
+    /** 包管理器 */
+    packageManager?: "npm" | "yarn" | "pnpm";
+    /** 是否运行测试 */
+    runTests?: boolean;
+    /** 是否上传报告为 artifact */
+    uploadArtifact?: boolean;
+    /** 扫描参数 */
+    scanArgs?: string;
+    /** 门禁配置 */
+    gate?: boolean;
+    /** 是否在 MR/PR 中自动发布评论 */
+    postComment?: boolean;
+}
+/**
+ * 自动检测项目使用的 CI 平台
+ * 基于目录结构和 git remote URL 推断
+ */
+export declare function detectCIProvider(projectDir: string): "github" | "gitlab";
+/**
+ * 生成 CI 配置文件
+ */
+export declare function generateCIConfig(projectDir: string, options: CIGeneratorOptions): {
+    created: string[];
+};
+//# sourceMappingURL=ci-generator.d.ts.map

package/dist/utils/ci-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-generator.d.ts","sourceRoot":"","sources":["../../src/utils/ci-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,EAAE,UAAU,CAAC;IACrB,iBAAiB;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IACzC,aAAa;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wBAAwB;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAuHD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CA+BxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAyCvG"}

package/dist/utils/ci-generator.js

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * CI 配置自动生成工具
+ * 一键生成 GitHub Actions / GitLab CI 配置文件
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectCIProvider = detectCIProvider;
+exports.generateCIConfig = generateCIConfig;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const GITHUB_ACTIONS_TEMPLATE = `name: Frontend Guardian
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  scan:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+{{NODE_SETUP}}
+{{INSTALL}}
+{{TEST}}
+      - name: 🛡️ Frontend Guardian Scan
+        run: npx fg-core . --scan --gate --output fg-report.md{{ARGS}}
+        continue-on-error: true
+
+      - name: 💬 Post PR Comment
+        if: github.event_name == 'pull_request'
+        run: npx fg-core . --scan --post-comment{{ARGS}}
+        env:
+          GITHUB_TOKEN: \${{ secrets.GITHUB_TOKEN }}
+        continue-on-error: true
+
+      - name: 📊 Upload Report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: frontend-guardian-report
+          path: fg-report.md
+
+      - name: 🚪 Gate Check
+        run: |
+          if [ -f fg-report.md ]; then
+            echo "报告已生成"
+          fi
+          # 如果扫描返回非 0 则失败
+          npx fg-core . --scan --gate{{ARGS}}
+`;
+const GITLAB_CI_TEMPLATE = `stages:
+  - test
+
+variables:
+  NPM_CONFIG_CACHE: .npm
+
+frontend-guardian-scan:
+  stage: test
+  image: node:{{NODE_VERSION}}-alpine
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+  cache:
+    key:
+      files:
+        - {{LOCK_FILE}}
+    paths:
+      - .npm/
+  before_script:
+{{INSTALL}}
+  script:
+    - npx fg-core . --scan --gate --output fg-report.md --post-comment{{ARGS}}
+  artifacts:
+    when: always
+    paths:
+      - fg-report.md
+    expire_in: 1 week
+  allow_failure: false
+`;
+function renderNodeSetup(pm) {
+    if (pm === "pnpm") {
+        return `      - uses: pnpm/action-setup@v2\n      - uses: actions/setup-node@v4\n        with:\n          node-version: '{{NODE_VERSION}}'\n          cache: 'pnpm'`;
+    }
+    return `      - uses: actions/setup-node@v4\n        with:\n          node-version: '{{NODE_VERSION}}'\n          cache: '${pm}'`;
+}
+function renderInstall(pm) {
+    const cmds = {
+        npm: "npm ci",
+        yarn: "yarn install --frozen-lockfile",
+        pnpm: "pnpm install --frozen-lockfile",
+    };
+    const cmd = cmds[pm] || cmds.npm;
+    return `      - name: 📦 Install Dependencies\n        run: ${cmd}`;
+}
+function renderTest(runTests) {
+    if (!runTests)
+        return "";
+    return `      - name: 🧪 Run Tests\n        run: npm test\n`;
+}
+function renderGitlabInstall(pm) {
+    const cmds = {
+        npm: "    - npm ci --cache .npm --prefer-offline",
+        yarn: "    - yarn install --frozen-lockfile",
+        pnpm: "    - npm install -g pnpm\n    - pnpm install --frozen-lockfile",
+    };
+    return cmds[pm] || cmds.npm;
+}
+function renderLockFile(pm) {
+    const files = {
+        npm: "package-lock.json",
+        yarn: "yarn.lock",
+        pnpm: "pnpm-lock.yaml",
+    };
+    return files[pm] || files.npm;
+}
+/**
+ * 自动检测项目使用的 CI 平台
+ * 基于目录结构和 git remote URL 推断
+ */
+function detectCIProvider(projectDir) {
+    // 1. 检查现有 CI 配置文件
+    if ((0, node_fs_1.existsSync)((0, node_path_1.resolve)(projectDir, ".gitlab-ci.yml"))) {
+        return "gitlab";
+    }
+    if ((0, node_fs_1.existsSync)((0, node_path_1.resolve)(projectDir, ".github", "workflows"))) {
+        return "github";
+    }
+    // 2. 检查 git remote URL
+    try {
+        const configPath = (0, node_path_1.resolve)(projectDir, ".git", "config");
+        if ((0, node_fs_1.existsSync)(configPath)) {
+            const config = (0, node_fs_1.readFileSync)(configPath, "utf-8");
+            const urlMatch = config.match(/\[remote "origin"\]\s*\n\s*url\s*=\s*(.+)/);
+            if (urlMatch) {
+                const remoteUrl = urlMatch[1].trim();
+                if (remoteUrl.includes("gitlab.com") || remoteUrl.includes("gitlab")) {
+                    return "gitlab";
+                }
+                if (remoteUrl.includes("github.com") || remoteUrl.includes("github")) {
+                    return "github";
+                }
+            }
+        }
+    }
+    catch {
+        // 读取失败，忽略
+    }
+    // 3. 默认 GitHub
+    return "github";
+}
+/**
+ * 生成 CI 配置文件
+ */
+function generateCIConfig(projectDir, options) {
+    const created = [];
+    const nodeVersion = options.nodeVersion || "20";
+    const pm = options.packageManager || "npm";
+    const args = options.scanArgs ? ` ${options.scanArgs}` : "";
+    const providers = options.provider === "both" ? ["github", "gitlab"] : [options.provider];
+    for (const provider of providers) {
+        if (provider === "github") {
+            const workflowDir = (0, node_path_1.resolve)(projectDir, ".github", "workflows");
+            if (!(0, node_fs_1.existsSync)(workflowDir)) {
+                (0, node_fs_1.mkdirSync)(workflowDir, { recursive: true });
+            }
+            let content = GITHUB_ACTIONS_TEMPLATE;
+            content = content.replace("{{NODE_SETUP}}", renderNodeSetup(pm));
+            content = content.replace("{{INSTALL}}", renderInstall(pm));
+            content = content.replace("{{TEST}}", renderTest(options.runTests ?? false));
+            content = content.replace(/{{NODE_VERSION}}/g, nodeVersion);
+            content = content.replace(/{{ARGS}}/g, args);
+            const path = (0, node_path_1.resolve)(workflowDir, "frontend-guardian.yml");
+            (0, node_fs_1.writeFileSync)(path, content, "utf-8");
+            created.push(path);
+        }
+        if (provider === "gitlab") {
+            let content = GITLAB_CI_TEMPLATE;
+            content = content.replace(/{{NODE_VERSION}}/g, nodeVersion);
+            content = content.replace("{{INSTALL}}", renderGitlabInstall(pm));
+            content = content.replace(/{{LOCK_FILE}}/g, renderLockFile(pm));
+            content = content.replace(/{{ARGS}}/g, args);
+            const path = (0, node_path_1.resolve)(projectDir, ".gitlab-ci.yml");
+            (0, node_fs_1.writeFileSync)(path, content, "utf-8");
+            created.push(path);
+        }
+    }
+    return { created };
+}
+//# sourceMappingURL=ci-generator.js.map

package/dist/utils/ci-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-generator.js","sourceRoot":"","sources":["../../src/utils/ci-generator.ts"],"names":[],"mappings":"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"}

package/dist/utils/common.d.ts

@@ -0,0 +1,8 @@
+/**
+ * v2.1.0: 公共工具函数 — 从各 scanner 提取，消除代码重复
+ */
+/** 从文件路径提取扩展名 */
+export declare function getFileExt(filePath: string): string;
+/** 从 JSX AST 节点提取标签名（支持 <Component.Sub />） */
+export declare function getJSXTagName(name: any): string | null;
+//# sourceMappingURL=common.d.ts.map

package/dist/utils/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/utils/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iBAAiB;AACjB,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAqBtD"}

package/dist/utils/common.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * v2.1.0: 公共工具函数 — 从各 scanner 提取，消除代码重复
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFileExt = getFileExt;
+exports.getJSXTagName = getJSXTagName;
+/** 从文件路径提取扩展名 */
+function getFileExt(filePath) {
+    const match = filePath.match(/\.[^.]+$/);
+    return match ? match[0] : ".js";
+}
+/** 从 JSX AST 节点提取标签名（支持 <Component.Sub />） */
+function getJSXTagName(name) {
+    if (name.type === "JSXIdentifier") {
+        return name.name;
+    }
+    if (name.type === "JSXMemberExpression") {
+        const parts = [];
+        let current = name;
+        while (current) {
+            if (current.type === "JSXIdentifier") {
+                parts.unshift(current.name);
+                break;
+            }
+            else if (current.type === "JSXMemberExpression") {
+                parts.unshift(current.property.name);
+                current = current.object;
+            }
+            else {
+                break;
+            }
+        }
+        return parts.join(".");
+    }
+    return null;
+}
+//# sourceMappingURL=common.js.map

package/dist/utils/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/utils/common.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAGH,gCAGC;AAGD,sCAqBC;AA5BD,iBAAiB;AACjB,SAAgB,UAAU,CAAC,QAAgB;IACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACzC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACpC,CAAC;AAED,8CAA8C;AAC9C,SAAgB,aAAa,CAAC,IAAS;IACnC,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;QACtC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,OAAO,OAAO,EAAE,CAAC;YACb,IAAI,OAAO,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACnC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC5B,MAAM;YACV,CAAC;iBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBAChD,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACrC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACJ,MAAM;YACV,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/utils/concurrent.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Concurrent execution utilities — 并发控制工具
+ *
+ * v2.1.0: 提供受控并发的 Promise.all 替代方案，避免大项目 OOM。
+ */
+/** 获取合理的默认并发数（CPU 核心数） */
+export declare function getDefaultConcurrency(): number;
+/**
+ * 受控并发的 map 操作
+ * @param items   待处理数组
+ * @param concurrency 最大并发数
+ * @param fn      处理函数
+ * @returns       按原顺序的结果数组
+ */
+export declare function concurrentMap<T, R>(items: T[], concurrency: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;
+//# sourceMappingURL=concurrent.d.ts.map

package/dist/utils/concurrent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrent.d.ts","sourceRoot":"","sources":["../../src/utils/concurrent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,0BAA0B;AAC1B,wBAAgB,qBAAqB,IAAI,MAAM,CAM9C;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,CAAC,EACpC,KAAK,EAAE,CAAC,EAAE,EACV,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAC3C,OAAO,CAAC,CAAC,EAAE,CAAC,CAuBd"}

package/dist/utils/concurrent.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Concurrent execution utilities — 并发控制工具
+ *
+ * v2.1.0: 提供受控并发的 Promise.all 替代方案，避免大项目 OOM。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultConcurrency = getDefaultConcurrency;
+exports.concurrentMap = concurrentMap;
+const node_os_1 = require("node:os");
+/** 获取合理的默认并发数（CPU 核心数） */
+function getDefaultConcurrency() {
+    try {
+        return (0, node_os_1.availableParallelism)();
+    }
+    catch {
+        return 4;
+    }
+}
+/**
+ * 受控并发的 map 操作
+ * @param items   待处理数组
+ * @param concurrency 最大并发数
+ * @param fn      处理函数
+ * @returns       按原顺序的结果数组
+ */
+async function concurrentMap(items, concurrency, fn) {
+    if (items.length === 0)
+        return [];
+    const results = new Array(items.length);
+    let index = 0;
+    let error = null;
+    async function worker() {
+        while (index < items.length && !error) {
+            const currentIndex = index++;
+            try {
+                results[currentIndex] = await fn(items[currentIndex], currentIndex);
+            }
+            catch (err) {
+                error = err;
+                throw err;
+            }
+        }
+    }
+    const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker());
+    await Promise.all(workers);
+    return results;
+}
+//# sourceMappingURL=concurrent.js.map

package/dist/utils/concurrent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrent.js","sourceRoot":"","sources":["../../src/utils/concurrent.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAKH,sDAMC;AASD,sCA2BC;AA7CD,qCAA+C;AAE/C,0BAA0B;AAC1B,SAAgB,qBAAqB;IACjC,IAAI,CAAC;QACD,OAAO,IAAA,8BAAoB,GAAE,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,CAAC,CAAC;IACb,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,aAAa,CAC/B,KAAU,EACV,WAAmB,EACnB,EAA0C;IAE1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAY,IAAI,CAAC;IAE1B,KAAK,UAAU,MAAM;QACjB,OAAO,KAAK,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACpC,MAAM,YAAY,GAAG,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACD,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC,CAAC;YACxE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,KAAK,GAAG,GAAG,CAAC;gBACZ,MAAM,GAAG,CAAC;YACd,CAAC;QACL,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5F,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE3B,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/dist/utils/config-loader.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 配置文件加载工具
+ * 支持 .frontend-guardian.yml 和 .frontend-guardian.json
+ * 支持 extends 继承组织级基线配置
+ */
+import type { ProjectConfig } from "../types.js";
+export declare function loadConfig(projectDir: string, configFile?: string): ProjectConfig;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/utils/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/utils/config-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,YAAY,CAAC;AAE5D,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAkCjF"}