frontend-guardian-core 2.6.0

package/dist/rules/registry.js

@@ -0,0 +1,205 @@
+"use strict";
+/**
+ * RuleRegistry — 规则注册中心
+ *
+ * Phase 3 核心组件：
+ * 1. 统一管理内置规则 + 自定义规则
+ * 2. 支持配置驱动（启用/禁用/调整 severity/参数化）
+ * 3. 支持热加载用户自定义 JS 规则文件
+ * 4. 框架抽象：规则按 category 分组，引擎按需取用
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RuleRegistry = void 0;
+exports.createRegistry = createRegistry;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const picocolors_1 = __importDefault(require("picocolors"));
+/** 规则注册中心 */
+class RuleRegistry {
+    /** 内置规则（原始定义，不可变） */
+    builtInRules = new Map();
+    /** 自定义规则（从外部 JS 文件加载） */
+    customRules = new Map();
+    /** 配置覆盖（id → RuleConfig） */
+    configOverrides = new Map();
+    /** 注册单条规则 */
+    register(rule) {
+        this.builtInRules.set(rule.id, rule);
+        return this;
+    }
+    /** 批量注册规则 */
+    registerAll(rules) {
+        for (const rule of rules) {
+            this.register(rule);
+        }
+        return this;
+    }
+    /** 注销规则（仅对自定义规则有效，内置规则不可注销） */
+    unregister(ruleId) {
+        this.customRules.delete(ruleId);
+        return this;
+    }
+    /** 获取单条规则（原始定义，未应用配置） */
+    getRaw(ruleId) {
+        return this.customRules.get(ruleId) || this.builtInRules.get(ruleId);
+    }
+    /** 获取所有已注册规则 ID */
+    getRuleIds() {
+        const ids = new Set();
+        for (const id of this.builtInRules.keys())
+            ids.add(id);
+        for (const id of this.customRules.keys())
+            ids.add(id);
+        return Array.from(ids);
+    }
+    /** ───────────────────────────────────────────────────────────────────────── */
+    /** 配置驱动                                                                      */
+    /** ───────────────────────────────────────────────────────────────────────── */
+    /**
+     * 从配置加载规则覆盖
+     * @param configs 规则配置列表（来自 .frontend-guardian.yml 的 rules: 节点）
+     */
+    loadFromConfig(configs) {
+        for (const cfg of configs) {
+            if (!cfg.id) {
+                console.warn(picocolors_1.default.yellow(`⚠️ RuleRegistry: 规则配置缺少 id，已跳过`));
+                continue;
+            }
+            this.configOverrides.set(cfg.id, cfg);
+        }
+    }
+    /**
+     * 加载自定义规则文件
+     * @param filePath 规则文件路径（相对或绝对）
+     * @param projectDir 项目根目录（用于解析相对路径）
+     */
+    loadCustomRule(filePath, projectDir) {
+        const absolutePath = projectDir ? (0, node_path_1.resolve)(projectDir, filePath) : (0, node_path_1.resolve)(filePath);
+        if (!(0, node_fs_1.existsSync)(absolutePath)) {
+            console.warn(picocolors_1.default.yellow(`⚠️ RuleRegistry: 自定义规则文件不存在: ${absolutePath}`));
+            return false;
+        }
+        try {
+            // 清除 require 缓存，支持热重载
+            delete require.cache[require.resolve(absolutePath)];
+            const mod = require(absolutePath);
+            const rule = mod.default || mod;
+            if (!rule || !rule.id || typeof rule.execute !== "function") {
+                console.warn(picocolors_1.default.yellow(`⚠️ RuleRegistry: 自定义规则文件格式不正确（需导出 Rule 对象）: ${absolutePath}`));
+                return false;
+            }
+            this.customRules.set(rule.id, rule);
+            return true;
+        }
+        catch (err) {
+            console.warn(picocolors_1.default.yellow(`⚠️ RuleRegistry: 加载自定义规则失败: ${absolutePath}`), err);
+            return false;
+        }
+    }
+    /** 加载多个自定义规则文件 */
+    loadCustomRules(paths, projectDir) {
+        const loaded = [];
+        const failed = [];
+        for (const p of paths) {
+            if (this.loadCustomRule(p, projectDir)) {
+                loaded.push(p);
+            }
+            else {
+                failed.push(p);
+            }
+        }
+        return { loaded, failed };
+    }
+    /** ───────────────────────────────────────────────────────────────────────── */
+    /** 规则取用                                                                      */
+    /** ───────────────────────────────────────────────────────────────────────── */
+    /**
+     * 获取应用了配置覆盖后的规则
+     * @returns 规则副本（severity/params 已按配置调整）
+     */
+    getRule(ruleId) {
+        const raw = this.getRaw(ruleId);
+        if (!raw)
+            return undefined;
+        const override = this.configOverrides.get(ruleId);
+        if (!override)
+            return raw;
+        return this.applyOverride(raw, override);
+    }
+    /**
+     * 获取所有启用的规则
+     * @param category 可选：按分类过滤
+     */
+    getActiveRules(category) {
+        const allIds = this.getRuleIds();
+        const result = [];
+        for (const id of allIds) {
+            const override = this.configOverrides.get(id);
+            // 被配置显式禁用的规则跳过
+            if (override?.enabled === false)
+                continue;
+            const rule = this.getRule(id);
+            if (!rule)
+                continue;
+            if (category && rule.category !== category)
+                continue;
+            result.push(rule);
+        }
+        return result;
+    }
+    /**
+     * 按条件过滤规则（框架/平台/组件库）
+     * 与 RuleEngine.filterRules 保持一致
+     */
+    filterRules(options) {
+        return this.getActiveRules().filter((rule) => {
+            if (options?.category && rule.category !== options.category)
+                return false;
+            if (options?.framework && rule.frameworks && !rule.frameworks.includes(options.framework))
+                return false;
+            if (options?.platform && rule.platforms && !rule.platforms.includes(options.platform))
+                return false;
+            if (options?.componentLib &&
+                rule.componentLibs &&
+                !rule.componentLibs.includes(options.componentLib))
+                return false;
+            return true;
+        });
+    }
+    /** 清除所有配置覆盖（重置为默认状态） */
+    clearOverrides() {
+        this.configOverrides.clear();
+    }
+    /** 清除所有自定义规则 */
+    clearCustomRules() {
+        this.customRules.clear();
+    }
+    /** ───────────────────────────────────────────────────────────────────────── */
+    /** 内部工具                                                                      */
+    /** ───────────────────────────────────────────────────────────────────────── */
+    /** 将配置覆盖应用到规则，返回新副本 */
+    applyOverride(rule, override) {
+        const cloned = { ...rule };
+        if (override.severity) {
+            cloned.severity = override.severity;
+        }
+        // 将 params 存入 meta，规则 execute 可通过 context.config 读取
+        if (override.params && Object.keys(override.params).length > 0) {
+            cloned.meta = {
+                ...rule.meta,
+                ...override.params,
+                _paramsOverride: override.params,
+            };
+        }
+        return cloned;
+    }
+}
+exports.RuleRegistry = RuleRegistry;
+/** 创建空的规则注册中心 */
+function createRegistry() {
+    return new RuleRegistry();
+}
+//# sourceMappingURL=registry.js.map

package/dist/rules/registry.js.map

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

package/dist/scanners/a11y-scanner.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 可访问性规则 Scanner
+ * 参考 WCAG 2.1 标准和 Vercel Web Design Guidelines
+ *
+ * 规则列表：
+ * 1. a11y-img-alt       — 图片必须有 alt 属性
+ * 2. a11y-form-label    — 表单元素必须有 label
+ * 3. a11y-button-role   — 可点击元素语义化
+ * 4. a11y-contrast      — 颜色对比度 WCAG AA
+ * 5. a11y-aria-valid    — ARIA 属性合法性
+ */
+import type { Rule } from "../types.js";
+export declare const a11yRules: Rule[];
+//# sourceMappingURL=a11y-scanner.d.ts.map

package/dist/scanners/a11y-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-scanner.d.ts","sourceRoot":"","sources":["../../src/scanners/a11y-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAsB,MAAM,YAAY,CAAC;AAiO3D,eAAO,MAAM,SAAS,EAAE,IAAI,EAoU3B,CAAC"}