frontend-guardian-core 2.6.0

package/dist/integrations/formatter.js

@@ -0,0 +1,182 @@
+"use strict";
+/**
+ * Formatter Integration — 代码格式化器集成
+ *
+ * 功能：
+ * 1. 自动检测项目使用的格式化工具（Biome / Prettier）
+ * 2. 使用项目已有配置，无配置时回退到默认
+ * 3. 支持 --format 单独运行，或 --fix --format 修复后自动格式化
+ *
+ * 检测优先级：
+ * 1. biome.json / biome.jsonc → Biome
+ * 2. .prettierrc / prettier.config.* → Prettier
+ * 3. 无配置 → 默认 Biome（4空格/120字符/双引号）
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectFormatter = detectFormatter;
+exports.runFormat = runFormat;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const picocolors_1 = __importDefault(require("picocolors"));
+const base_js_1 = require("./base.js");
+/** 检测项目使用的格式化器 */
+function detectFormatter(projectDir) {
+    if (biomeFormatter.isAvailable(projectDir)) {
+        return biomeFormatter;
+    }
+    if (prettierFormatter.isAvailable(projectDir)) {
+        return prettierFormatter;
+    }
+    // 无配置时默认用 Biome
+    if (hasBiomeCli(projectDir)) {
+        return biomeFormatter;
+    }
+    return null;
+}
+/** 运行格式化 */
+function runFormat(projectDir, files) {
+    const formatter = detectFormatter(projectDir);
+    if (!formatter) {
+        return {
+            formatter: "none",
+            formatted: 0,
+            unchanged: 0,
+            errors: ["未检测到可用的格式化工具（Biome 或 Prettier）"],
+            duration: 0,
+        };
+    }
+    return formatter.format(projectDir, files);
+}
+// ── Biome Formatter ────────────────────────────────────────────────────────
+const biomeFormatter = {
+    name: "Biome",
+    isAvailable(projectDir) {
+        return ((0, node_fs_1.existsSync)((0, node_path_1.resolve)(projectDir, "biome.json")) ||
+            (0, node_fs_1.existsSync)((0, node_path_1.resolve)(projectDir, "biome.jsonc")) ||
+            hasBiomeCli(projectDir));
+    },
+    format(projectDir, files) {
+        const start = Date.now();
+        const errors = [];
+        let formatted = 0;
+        let unchanged = 0;
+        // 确保有配置文件
+        ensureBiomeConfig(projectDir);
+        const fileArgs = files && files.length > 0 ? files.join(" ") : ".";
+        const output = (0, base_js_1.runCommand)(`npx biome format --write ${fileArgs}`, projectDir, 120000);
+        if (output === null) {
+            errors.push("Biome format 执行失败");
+        }
+        else {
+            // Biome 输出格式: "Formatted 3 files in 12ms"
+            const match = output.match(/Formatted\s+(\d+)\s+file/i);
+            if (match) {
+                formatted = parseInt(match[1], 10);
+            }
+            // 检查 unchanged
+            const unchangedMatch = output.match(/unchanged\s+(\d+)/i);
+            if (unchangedMatch) {
+                unchanged = parseInt(unchangedMatch[1], 10);
+            }
+            // 如果没匹配到 formatted，可能全部未变更
+            if (!match && output.includes("unchanged")) {
+                const allMatch = output.match(/(\d+)\s+files?\s+unchanged/i);
+                if (allMatch) {
+                    unchanged = parseInt(allMatch[1], 10);
+                }
+            }
+        }
+        return {
+            formatter: "Biome",
+            formatted,
+            unchanged,
+            errors,
+            duration: Date.now() - start,
+        };
+    },
+};
+// ── Prettier Formatter ─────────────────────────────────────────────────────
+const prettierFormatter = {
+    name: "Prettier",
+    isAvailable(projectDir) {
+        return ((0, node_fs_1.existsSync)((0, node_path_1.resolve)(projectDir, ".prettierrc")) ||
+            (0, node_fs_1.existsSync)((0, node_path_1.resolve)(projectDir, ".prettierrc.json")) ||
+            (0, node_fs_1.existsSync)((0, node_path_1.resolve)(projectDir, ".prettierrc.js")) ||
+            (0, node_fs_1.existsSync)((0, node_path_1.resolve)(projectDir, ".prettierrc.mjs")) ||
+            (0, node_fs_1.existsSync)((0, node_path_1.resolve)(projectDir, ".prettierrc.cjs")) ||
+            (0, node_fs_1.existsSync)((0, node_path_1.resolve)(projectDir, ".prettierrc.yaml")) ||
+            (0, node_fs_1.existsSync)((0, node_path_1.resolve)(projectDir, ".prettierrc.yml")) ||
+            (0, node_fs_1.existsSync)((0, node_path_1.resolve)(projectDir, "prettier.config.js")) ||
+            (0, node_fs_1.existsSync)((0, node_path_1.resolve)(projectDir, "prettier.config.mjs")) ||
+            (0, node_fs_1.existsSync)((0, node_path_1.resolve)(projectDir, "prettier.config.cjs")) ||
+            hasPrettierCli(projectDir));
+    },
+    format(projectDir, files) {
+        const start = Date.now();
+        const errors = [];
+        let formatted = 0;
+        let unchanged = 0;
+        const fileArgs = files && files.length > 0 ? files.join(" ") : "**/*.{js,ts,jsx,tsx,vue,svelte,css,scss,less,json,md}";
+        const output = (0, base_js_1.runCommand)(`npx prettier --write --log-level warn ${fileArgs}`, projectDir, 120000);
+        if (output === null) {
+            errors.push("Prettier 执行失败");
+        }
+        else {
+            // Prettier 输出每行一个文件路径
+            const lines = output.split("\n").filter((l) => l.trim());
+            formatted = lines.length;
+        }
+        return {
+            formatter: "Prettier",
+            formatted,
+            unchanged,
+            errors,
+            duration: Date.now() - start,
+        };
+    },
+};
+// ── Helpers ────────────────────────────────────────────────────────────────
+function hasBiomeCli(projectDir) {
+    const result = (0, base_js_1.runCommand)("npx biome --version 2>/dev/null || echo NOT_FOUND", projectDir, 5000);
+    return result !== null && !result.includes("NOT_FOUND");
+}
+function hasPrettierCli(projectDir) {
+    const result = (0, base_js_1.runCommand)("npx prettier --version 2>/dev/null || echo NOT_FOUND", projectDir, 5000);
+    return result !== null && !result.includes("NOT_FOUND");
+}
+/** 如果项目没有 biome.json，生成一个默认配置 */
+function ensureBiomeConfig(projectDir) {
+    const configPath = (0, node_path_1.resolve)(projectDir, "biome.json");
+    if ((0, node_fs_1.existsSync)(configPath))
+        return;
+    const defaultConfig = {
+        "$schema": "https://biomejs.dev/schemas/2.0.0/schema.json",
+        formatter: {
+            enabled: true,
+            indentStyle: "space",
+            indentWidth: 4,
+            lineWidth: 120,
+        },
+        javascript: {
+            formatter: {
+                quoteStyle: "double",
+                trailingCommas: "all",
+            },
+        },
+        files: {
+            ignore: ["node_modules", "dist", "build", ".git", "coverage"],
+        },
+    };
+    try {
+        const fs = require("node:fs");
+        fs.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 4), "utf-8");
+        console.log(picocolors_1.default.blue(`   📝 已生成默认 Biome 配置: ${configPath}`));
+    }
+    catch {
+        // 静默失败
+    }
+}
+//# sourceMappingURL=formatter.js.map

package/dist/integrations/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/integrations/formatter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;AA2BH,0CAYC;AAGD,8BAYC;AApDD,qCAAqC;AACrC,yCAAoC;AACpC,4DAA4B;AAC5B,uCAAuC;AAqBvC,kBAAkB;AAClB,SAAgB,eAAe,CAAC,UAAkB;IAC9C,IAAI,cAAc,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,OAAO,cAAc,CAAC;IAC1B,CAAC;IACD,IAAI,iBAAiB,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5C,OAAO,iBAAiB,CAAC;IAC7B,CAAC;IACD,gBAAgB;IAChB,IAAI,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1B,OAAO,cAAc,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,YAAY;AACZ,SAAgB,SAAS,CAAC,UAAkB,EAAE,KAAgB;IAC1D,MAAM,SAAS,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO;YACH,SAAS,EAAE,MAAM;YACjB,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,CAAC;YACZ,MAAM,EAAE,CAAC,gCAAgC,CAAC;YAC1C,QAAQ,EAAE,CAAC;SACd,CAAC;IACN,CAAC;IACD,OAAO,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,8EAA8E;AAE9E,MAAM,cAAc,GAAkB;IAClC,IAAI,EAAE,OAAO;IACb,WAAW,CAAC,UAAkB;QAC1B,OAAO,CACH,IAAA,oBAAU,EAAC,IAAA,mBAAO,EAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YAC7C,IAAA,oBAAU,EAAC,IAAA,mBAAO,EAAC,UAAU,EAAE,aAAa,CAAC,CAAC;YAC9C,WAAW,CAAC,UAAU,CAAC,CAC1B,CAAC;IACN,CAAC;IACD,MAAM,CAAC,UAAkB,EAAE,KAAgB;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,UAAU;QACV,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAE9B,MAAM,QAAQ,GAAG,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACnE,MAAM,MAAM,GAAG,IAAA,oBAAU,EACrB,4BAA4B,QAAQ,EAAE,EACtC,UAAU,EACV,MAAM,CACT,CAAC;QAEF,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACJ,0CAA0C;YAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;YACxD,IAAI,KAAK,EAAE,CAAC;gBACR,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvC,CAAC;YACD,eAAe;YACf,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC1D,IAAI,cAAc,EAAE,CAAC;gBACjB,SAAS,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChD,CAAC;YACD,2BAA2B;YAC3B,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;gBAC7D,IAAI,QAAQ,EAAE,CAAC;oBACX,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC1C,CAAC;YACL,CAAC;QACL,CAAC;QAED,OAAO;YACH,SAAS,EAAE,OAAO;YAClB,SAAS;YACT,SAAS;YACT,MAAM;YACN,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC/B,CAAC;IACN,CAAC;CACJ,CAAC;AAEF,8EAA8E;AAE9E,MAAM,iBAAiB,GAAkB;IACrC,IAAI,EAAE,UAAU;IAChB,WAAW,CAAC,UAAkB;QAC1B,OAAO,CACH,IAAA,oBAAU,EAAC,IAAA,mBAAO,EAAC,UAAU,EAAE,aAAa,CAAC,CAAC;YAC9C,IAAA,oBAAU,EAAC,IAAA,mBAAO,EAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;YACnD,IAAA,oBAAU,EAAC,IAAA,mBAAO,EAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;YACjD,IAAA,oBAAU,EAAC,IAAA,mBAAO,EAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;YAClD,IAAA,oBAAU,EAAC,IAAA,mBAAO,EAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;YAClD,IAAA,oBAAU,EAAC,IAAA,mBAAO,EAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;YACnD,IAAA,oBAAU,EAAC,IAAA,mBAAO,EAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;YAClD,IAAA,oBAAU,EAAC,IAAA,mBAAO,EAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;YACrD,IAAA,oBAAU,EAAC,IAAA,mBAAO,EAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;YACtD,IAAA,oBAAU,EAAC,IAAA,mBAAO,EAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;YACtD,cAAc,CAAC,UAAU,CAAC,CAC7B,CAAC;IACN,CAAC;IACD,MAAM,CAAC,UAAkB,EAAE,KAAgB;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,MAAM,QAAQ,GAAG,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,uDAAuD,CAAC;QACvH,MAAM,MAAM,GAAG,IAAA,oBAAU,EACrB,yCAAyC,QAAQ,EAAE,EACnD,UAAU,EACV,MAAM,CACT,CAAC;QAEF,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACJ,sBAAsB;YACtB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACzD,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;QAC7B,CAAC;QAED,OAAO;YACH,SAAS,EAAE,UAAU;YACrB,SAAS;YACT,SAAS;YACT,MAAM;YACN,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC/B,CAAC;IACN,CAAC;CACJ,CAAC;AAEF,8EAA8E;AAE9E,SAAS,WAAW,CAAC,UAAkB;IACnC,MAAM,MAAM,GAAG,IAAA,oBAAU,EAAC,mDAAmD,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACjG,OAAO,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,cAAc,CAAC,UAAkB;IACtC,MAAM,MAAM,GAAG,IAAA,oBAAU,EAAC,sDAAsD,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACpG,OAAO,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC5D,CAAC;AAED,iCAAiC;AACjC,SAAS,iBAAiB,CAAC,UAAkB;IACzC,MAAM,UAAU,GAAG,IAAA,mBAAO,EAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACrD,IAAI,IAAA,oBAAU,EAAC,UAAU,CAAC;QAAE,OAAO;IAEnC,MAAM,aAAa,GAAG;QAClB,SAAS,EAAE,+CAA+C;QAC1D,SAAS,EAAE;YACP,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,OAAO;YACpB,WAAW,EAAE,CAAC;YACd,SAAS,EAAE,GAAG;SACjB;QACD,UAAU,EAAE;YACR,SAAS,EAAE;gBACP,UAAU,EAAE,QAAQ;gBACpB,cAAc,EAAE,KAAK;aACxB;SACJ;QACD,KAAK,EAAE;YACH,MAAM,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC;SAChE;KACJ,CAAC;IAEF,IAAI,CAAC;QACD,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9B,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9E,OAAO,CAAC,GAAG,CAAC,oBAAE,CAAC,IAAI,CAAC,yBAAyB,UAAU,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACL,OAAO;IACX,CAAC;AACL,CAAC"}

package/dist/integrations/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 外部工具集成索引
+ * Phase 4: 覆盖全面化 — 集成 ESLint / TypeScript / Stylelint
+ */
+export type { ExternalTool, ExternalToolResult } from "./base.js";
+export { runAllExternalTools, runCommand, eslintSeverityToFg, hasPackage } from "./base.js";
+import { eslintIntegration as _eslintIntegration } from "./eslint.js";
+import { typescriptIntegration as _typescriptIntegration } from "./typescript.js";
+import { stylelintIntegration as _stylelintIntegration } from "./stylelint.js";
+export { _eslintIntegration as eslintIntegration };
+export { _typescriptIntegration as typescriptIntegration };
+export { _stylelintIntegration as stylelintIntegration };
+/** 所有可用的外部工具列表 */
+export declare const allExternalTools: import("./base.js").ExternalTool[];
+export { detectFormatter, runFormat } from "./formatter.js";
+export type { FormatResult, FormatterTool } from "./formatter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5F,OAAO,EAAE,iBAAiB,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,qBAAqB,IAAI,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,oBAAoB,IAAI,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE/E,OAAO,EAAE,kBAAkB,IAAI,iBAAiB,EAAE,CAAC;AACnD,OAAO,EAAE,sBAAsB,IAAI,qBAAqB,EAAE,CAAC;AAC3D,OAAO,EAAE,qBAAqB,IAAI,oBAAoB,EAAE,CAAC;AAEzD,kBAAkB;AAClB,eAAO,MAAM,gBAAgB,oCAAsE,CAAC;AAGpG,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/integrations/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * 外部工具集成索引
+ * Phase 4: 覆盖全面化 — 集成 ESLint / TypeScript / Stylelint
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runFormat = exports.detectFormatter = exports.allExternalTools = exports.stylelintIntegration = exports.typescriptIntegration = exports.eslintIntegration = exports.hasPackage = exports.eslintSeverityToFg = exports.runCommand = exports.runAllExternalTools = void 0;
+var base_js_1 = require("./base.js");
+Object.defineProperty(exports, "runAllExternalTools", { enumerable: true, get: function () { return base_js_1.runAllExternalTools; } });
+Object.defineProperty(exports, "runCommand", { enumerable: true, get: function () { return base_js_1.runCommand; } });
+Object.defineProperty(exports, "eslintSeverityToFg", { enumerable: true, get: function () { return base_js_1.eslintSeverityToFg; } });
+Object.defineProperty(exports, "hasPackage", { enumerable: true, get: function () { return base_js_1.hasPackage; } });
+const eslint_js_1 = require("./eslint.js");
+Object.defineProperty(exports, "eslintIntegration", { enumerable: true, get: function () { return eslint_js_1.eslintIntegration; } });
+const typescript_js_1 = require("./typescript.js");
+Object.defineProperty(exports, "typescriptIntegration", { enumerable: true, get: function () { return typescript_js_1.typescriptIntegration; } });
+const stylelint_js_1 = require("./stylelint.js");
+Object.defineProperty(exports, "stylelintIntegration", { enumerable: true, get: function () { return stylelint_js_1.stylelintIntegration; } });
+/** 所有可用的外部工具列表 */
+exports.allExternalTools = [eslint_js_1.eslintIntegration, typescript_js_1.typescriptIntegration, stylelint_js_1.stylelintIntegration];
+// Phase 5+6: 格式化器集成
+var formatter_js_1 = require("./formatter.js");
+Object.defineProperty(exports, "detectFormatter", { enumerable: true, get: function () { return formatter_js_1.detectFormatter; } });
+Object.defineProperty(exports, "runFormat", { enumerable: true, get: function () { return formatter_js_1.runFormat; } });
+//# sourceMappingURL=index.js.map

package/dist/integrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAGH,qCAA4F;AAAnF,8GAAA,mBAAmB,OAAA;AAAE,qGAAA,UAAU,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAAE,qGAAA,UAAU,OAAA;AAExE,2CAAsE;AAIvC,kGAJD,6BAAkB,OAIA;AAHhD,mDAAkF;AAI/C,sGAJD,qCAAsB,OAIA;AAHxD,iDAA+E;AAI7C,qGAJD,mCAAqB,OAIA;AAEtD,kBAAkB;AACL,QAAA,gBAAgB,GAAG,CAAC,6BAAkB,EAAE,qCAAsB,EAAE,mCAAqB,CAAC,CAAC;AAEpG,oBAAoB;AACpB,+CAA4D;AAAnD,+GAAA,eAAe,OAAA;AAAE,yGAAA,SAAS,OAAA"}

package/dist/integrations/stylelint.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Stylelint 集成
+ *
+ * 调用 npx stylelint --formatter json 并解析 CSS 规范问题为 Issue 格式
+ */
+import type { ExternalTool } from "./base.js";
+export declare const stylelintIntegration: ExternalTool;
+//# sourceMappingURL=stylelint.d.ts.map

package/dist/integrations/stylelint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stylelint.d.ts","sourceRoot":"","sources":["../../src/integrations/stylelint.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAgC9C,eAAO,MAAM,oBAAoB,EAAE,YA4ClC,CAAC"}

package/dist/integrations/stylelint.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Stylelint 集成
+ *
+ * 调用 npx stylelint --formatter json 并解析 CSS 规范问题为 Issue 格式
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stylelintIntegration = void 0;
+const base_js_1 = require("./base.js");
+function slSeverityToFg(severity) {
+    switch (severity) {
+        case "error":
+            return "critical";
+        case "warning":
+            return "warning";
+        default:
+            return "suggestion";
+    }
+}
+exports.stylelintIntegration = {
+    name: "Stylelint",
+    isAvailable(projectDir) {
+        return (0, base_js_1.hasPackage)(projectDir, "stylelint");
+    },
+    run(projectDir, files) {
+        const patterns = files && files.length > 0 ? files.join(" ") : '"src/**/*.{css,scss,less,sass}"';
+        const stdout = (0, base_js_1.runCommand)(`npx stylelint ${patterns} --formatter json --allow-empty-input`, projectDir, 120000);
+        if (!stdout) {
+            return [];
+        }
+        let results;
+        try {
+            results = JSON.parse(stdout);
+        }
+        catch {
+            return [];
+        }
+        const issues = [];
+        for (const result of results) {
+            for (const warning of result.warnings) {
+                issues.push({
+                    ruleId: `stylelint-${warning.rule}`,
+                    title: warning.rule,
+                    description: warning.text.replace(/\s*\(.*\)\s*$/, ""), // 去掉末尾的 URL 提示
+                    severity: slSeverityToFg(warning.severity),
+                    file: result.source,
+                    line: warning.line,
+                    column: warning.column,
+                    meta: {
+                        tool: "stylelint",
+                        url: warning.url,
+                    },
+                });
+            }
+        }
+        return issues;
+    },
+};
+//# sourceMappingURL=stylelint.js.map

package/dist/integrations/stylelint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stylelint.js","sourceRoot":"","sources":["../../src/integrations/stylelint.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAIH,uCAAmD;AAoBnD,SAAS,cAAc,CAAC,QAAgB;IACpC,QAAQ,QAAQ,EAAE,CAAC;QACf,KAAK,OAAO;YACR,OAAO,UAAU,CAAC;QACtB,KAAK,SAAS;YACV,OAAO,SAAS,CAAC;QACrB;YACI,OAAO,YAAY,CAAC;IAC5B,CAAC;AACL,CAAC;AAEY,QAAA,oBAAoB,GAAiB;IAC9C,IAAI,EAAE,WAAW;IAEjB,WAAW,CAAC,UAAkB;QAC1B,OAAO,IAAA,oBAAU,EAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED,GAAG,CAAC,UAAkB,EAAE,KAAgB;QACpC,MAAM,QAAQ,GAAG,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,iCAAiC,CAAC;QAEjG,MAAM,MAAM,GAAG,IAAA,oBAAU,EAAC,iBAAiB,QAAQ,uCAAuC,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAEhH,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;QACd,CAAC;QAED,IAAI,OAA0B,CAAC;QAC/B,IAAI,CAAC;YACD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,EAAE,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC3B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpC,MAAM,CAAC,IAAI,CAAC;oBACR,MAAM,EAAE,aAAa,OAAO,CAAC,IAAI,EAAE;oBACnC,KAAK,EAAE,OAAO,CAAC,IAAI;oBACnB,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,EAAE,eAAe;oBACvE,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC;oBAC1C,IAAI,EAAE,MAAM,CAAC,MAAM;oBACnB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,IAAI,EAAE;wBACF,IAAI,EAAE,WAAW;wBACjB,GAAG,EAAE,OAAO,CAAC,GAAG;qBACnB;iBACJ,CAAC,CAAC;YACP,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ,CAAC"}

package/dist/integrations/typescript.d.ts

@@ -0,0 +1,8 @@
+/**
+ * TypeScript 集成
+ *
+ * 调用 npx tsc --noEmit 并解析类型错误为 Issue 格式
+ */
+import type { ExternalTool } from "./base.js";
+export declare const typescriptIntegration: ExternalTool;
+//# sourceMappingURL=typescript.d.ts.map

package/dist/integrations/typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../src/integrations/typescript.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAmC9C,eAAO,MAAM,qBAAqB,EAAE,YA0DnC,CAAC"}

package/dist/integrations/typescript.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * TypeScript 集成
+ *
+ * 调用 npx tsc --noEmit 并解析类型错误为 Issue 格式
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typescriptIntegration = void 0;
+const base_js_1 = require("./base.js");
+/** TSC 错误码分类：关键类型错误 */
+const CRITICAL_CODES = new Set([
+    2322, // Type 'X' is not assignable to type 'Y'
+    2345, // Argument of type 'X' is not assignable to parameter of type 'Y'
+    2321, // Excess property checks
+    2531, // Object is possibly 'null'
+    2532, // Object is possibly 'undefined'
+    2533, // Object is possibly 'null' or 'undefined'
+    2571, // Object is of type 'unknown'
+    18046, // 'X' is of type 'unknown'
+    18047, // 'X' is possibly 'null'
+    18048, // 'X' is possibly 'undefined'
+    7006, // Parameter 'X' implicitly has an 'any' type
+    7008, // Member 'X' implicitly has an 'any' type
+    7017, // Element implicitly has an 'any' type because index expression is not of type 'number'
+    7019, // Element implicitly has an 'any' type because expression of type 'X' can't be used to index type 'Y'
+]);
+const WARNING_CODES = new Set([
+    6133, // 'X' is declared but its value is never read
+    6196, // 'X' is declared but never used
+    2578, // Unused '@ts-expect-error' directive
+    7027, // Unreachable code detected
+    7030, // Not all code paths return a value
+]);
+function tscCodeToSeverity(code) {
+    if (CRITICAL_CODES.has(code))
+        return "critical";
+    if (WARNING_CODES.has(code))
+        return "warning";
+    return "suggestion";
+}
+exports.typescriptIntegration = {
+    name: "TypeScript",
+    isAvailable(projectDir) {
+        // 检查 tsconfig.json 是否存在
+        try {
+            const fs = require("node:fs");
+            return fs.existsSync(require("node:path").join(projectDir, "tsconfig.json"));
+        }
+        catch {
+            return false;
+        }
+    },
+    run(projectDir, files) {
+        // 如果指定了文件列表，只检查这些文件
+        const cmd = files && files.length > 0 ? `npx tsc --noEmit ${files.join(" ")}` : "npx tsc --noEmit";
+        const stdout = (0, base_js_1.runCommand)(cmd, projectDir, 180000);
+        if (!stdout) {
+            return [];
+        }
+        const issues = [];
+        const lines = stdout.split("\n");
+        // 解析 TSC 错误输出格式：
+        // src/file.ts(10,5): error TS2322: Type 'string' is not assignable to type 'number'.
+        const errorRegex = /^(.+)\((\d+),(\d+)\):\s+(error|warning)\s+TS(\d+):\s+(.+)$/;
+        for (const line of lines) {
+            const match = line.match(errorRegex);
+            if (!match)
+                continue;
+            const [, filePath, lineStr, colStr, category, codeStr, message] = match;
+            const code = parseInt(codeStr, 10);
+            const lineNum = parseInt(lineStr, 10);
+            const colNum = parseInt(colStr, 10);
+            const severity = tscCodeToSeverity(code);
+            issues.push({
+                ruleId: `tsc-TS${code}`,
+                title: `TS${code}: ${message.slice(0, 60)}`,
+                description: message,
+                severity,
+                file: filePath,
+                line: lineNum,
+                column: colNum,
+                meta: {
+                    tool: "typescript",
+                    code,
+                    category,
+                },
+            });
+        }
+        return issues;
+    },
+};
+//# sourceMappingURL=typescript.js.map

package/dist/integrations/typescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.js","sourceRoot":"","sources":["../../src/integrations/typescript.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAIH,uCAAuC;AAEvC,uBAAuB;AACvB,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC3B,IAAI,EAAE,yCAAyC;IAC/C,IAAI,EAAE,kEAAkE;IACxE,IAAI,EAAE,yBAAyB;IAC/B,IAAI,EAAE,4BAA4B;IAClC,IAAI,EAAE,iCAAiC;IACvC,IAAI,EAAE,2CAA2C;IACjD,IAAI,EAAE,8BAA8B;IACpC,KAAK,EAAE,2BAA2B;IAClC,KAAK,EAAE,yBAAyB;IAChC,KAAK,EAAE,8BAA8B;IACrC,IAAI,EAAE,6CAA6C;IACnD,IAAI,EAAE,0CAA0C;IAChD,IAAI,EAAE,wFAAwF;IAC9F,IAAI,EAAE,sGAAsG;CAC/G,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC1B,IAAI,EAAE,8CAA8C;IACpD,IAAI,EAAE,iCAAiC;IACvC,IAAI,EAAE,sCAAsC;IAC5C,IAAI,EAAE,4BAA4B;IAClC,IAAI,EAAE,oCAAoC;CAC7C,CAAC,CAAC;AAEH,SAAS,iBAAiB,CAAC,IAAY;IACnC,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,UAAU,CAAC;IAChD,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,OAAO,YAAY,CAAC;AACxB,CAAC;AAEY,QAAA,qBAAqB,GAAiB;IAC/C,IAAI,EAAE,YAAY;IAElB,WAAW,CAAC,UAAkB;QAC1B,wBAAwB;QACxB,IAAI,CAAC;YACD,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;YAC9B,OAAO,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC;QACjF,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,GAAG,CAAC,UAAkB,EAAE,KAAgB;QACpC,oBAAoB;QACpB,MAAM,GAAG,GAAG,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,oBAAoB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC;QAEnG,MAAM,MAAM,GAAG,IAAA,oBAAU,EAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAEnD,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEjC,iBAAiB;QACjB,qFAAqF;QACrF,MAAM,UAAU,GAAG,4DAA4D,CAAC;QAEhF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACrC,IAAI,CAAC,KAAK;gBAAE,SAAS;YAErB,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;YACxE,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACtC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACpC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAEzC,MAAM,CAAC,IAAI,CAAC;gBACR,MAAM,EAAE,SAAS,IAAI,EAAE;gBACvB,KAAK,EAAE,KAAK,IAAI,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;gBAC3C,WAAW,EAAE,OAAO;gBACpB,QAAQ;gBACR,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE;oBACF,IAAI,EAAE,YAAY;oBAClB,IAAI;oBACJ,QAAQ;iBACX;aACJ,CAAC,CAAC;QACP,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ,CAAC"}

package/dist/rules/registry.d.ts

@@ -0,0 +1,83 @@
+/**
+ * RuleRegistry — 规则注册中心
+ *
+ * Phase 3 核心组件：
+ * 1. 统一管理内置规则 + 自定义规则
+ * 2. 支持配置驱动（启用/禁用/调整 severity/参数化）
+ * 3. 支持热加载用户自定义 JS 规则文件
+ * 4. 框架抽象：规则按 category 分组，引擎按需取用
+ */
+import type { Rule, RuleConfig, RuleCategory } from "../types.js";
+/** 规则注册中心 */
+export declare class RuleRegistry {
+    /** 内置规则（原始定义，不可变） */
+    private builtInRules;
+    /** 自定义规则（从外部 JS 文件加载） */
+    private customRules;
+    /** 配置覆盖（id → RuleConfig） */
+    private configOverrides;
+    /** 注册单条规则 */
+    register(rule: Rule): this;
+    /** 批量注册规则 */
+    registerAll(rules: Rule[]): this;
+    /** 注销规则（仅对自定义规则有效，内置规则不可注销） */
+    unregister(ruleId: string): this;
+    /** 获取单条规则（原始定义，未应用配置） */
+    getRaw(ruleId: string): Rule | undefined;
+    /** 获取所有已注册规则 ID */
+    getRuleIds(): string[];
+    /** ───────────────────────────────────────────────────────────────────────── */
+    /** 配置驱动                                                                      */
+    /** ───────────────────────────────────────────────────────────────────────── */
+    /**
+     * 从配置加载规则覆盖
+     * @param configs 规则配置列表（来自 .frontend-guardian.yml 的 rules: 节点）
+     */
+    loadFromConfig(configs: RuleConfig[]): void;
+    /**
+     * 加载自定义规则文件
+     * @param filePath 规则文件路径（相对或绝对）
+     * @param projectDir 项目根目录（用于解析相对路径）
+     */
+    loadCustomRule(filePath: string, projectDir?: string): boolean;
+    /** 加载多个自定义规则文件 */
+    loadCustomRules(paths: string[], projectDir?: string): {
+        loaded: string[];
+        failed: string[];
+    };
+    /** ───────────────────────────────────────────────────────────────────────── */
+    /** 规则取用                                                                      */
+    /** ───────────────────────────────────────────────────────────────────────── */
+    /**
+     * 获取应用了配置覆盖后的规则
+     * @returns 规则副本（severity/params 已按配置调整）
+     */
+    getRule(ruleId: string): Rule | undefined;
+    /**
+     * 获取所有启用的规则
+     * @param category 可选：按分类过滤
+     */
+    getActiveRules(category?: RuleCategory): Rule[];
+    /**
+     * 按条件过滤规则（框架/平台/组件库）
+     * 与 RuleEngine.filterRules 保持一致
+     */
+    filterRules(options?: {
+        category?: string;
+        framework?: string;
+        platform?: string;
+        componentLib?: string;
+    }): Rule[];
+    /** 清除所有配置覆盖（重置为默认状态） */
+    clearOverrides(): void;
+    /** 清除所有自定义规则 */
+    clearCustomRules(): void;
+    /** ───────────────────────────────────────────────────────────────────────── */
+    /** 内部工具                                                                      */
+    /** ───────────────────────────────────────────────────────────────────────── */
+    /** 将配置覆盖应用到规则，返回新副本 */
+    private applyOverride;
+}
+/** 创建空的规则注册中心 */
+export declare function createRegistry(): RuleRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/rules/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/rules/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAY,MAAM,YAAY,CAAC;AAG3E,aAAa;AACb,qBAAa,YAAY;IACrB,qBAAqB;IACrB,OAAO,CAAC,YAAY,CAA2B;IAC/C,yBAAyB;IACzB,OAAO,CAAC,WAAW,CAA2B;IAC9C,4BAA4B;IAC5B,OAAO,CAAC,eAAe,CAAiC;IAExD,aAAa;IACb,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAK1B,aAAa;IACb,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAOhC,+BAA+B;IAC/B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKhC,yBAAyB;IACzB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIxC,mBAAmB;IACnB,UAAU,IAAI,MAAM,EAAE;IAOtB,gFAAgF;IAChF,gFAAgF;IAChF,gFAAgF;IAEhF;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI;IAU3C;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO;IA6B9D,kBAAkB;IAClB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAe7F,gFAAgF;IAChF,gFAAgF;IAChF,gFAAgF;IAEhF;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAUzC;;;OAGG;IACH,cAAc,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,EAAE;IAqB/C;;;OAGG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,EAAE;IAgBlH,wBAAwB;IACxB,cAAc,IAAI,IAAI;IAItB,gBAAgB;IAChB,gBAAgB,IAAI,IAAI;IAIxB,gFAAgF;IAChF,gFAAgF;IAChF,gFAAgF;IAEhF,uBAAuB;IACvB,OAAO,CAAC,aAAa;CAkBxB;AAED,iBAAiB;AACjB,wBAAgB,cAAc,IAAI,YAAY,CAE7C"}