frontend-guardian-core 2.6.0

package/dist/types.d.ts

@@ -0,0 +1,343 @@
+/**
+ * Core type definitions for frontend-guardian rule engine
+ */
+export type Severity = "critical" | "warning" | "suggestion";
+export type Platform = "pc" | "h5" | "wechat-mp" | "alipay-mp" | "douyin-mp" | "app" | "harmony" | "flutter" | "react-native";
+export type Framework = "react" | "vue" | "nextjs" | "nuxt" | "uniapp" | "taro" | "flutter" | "react-native" | "harmony" | "svelte" | "solidjs" | "astro";
+export type ComponentLib = "antd" | "element-plus" | "mui" | "vuetify" | "nutui" | "tdesign" | "shadcn" | "none";
+export interface Issue {
+    /** Unique rule identifier */
+    ruleId: string;
+    /** Human-readable title */
+    title: string;
+    /** Detailed description */
+    description: string;
+    /** Severity level */
+    severity: Severity;
+    /** File path (relative to project root) */
+    file: string;
+    /** Line number (1-based) */
+    line: number;
+    /** Column number (1-based) */
+    column: number;
+    /** End line number */
+    endLine?: number;
+    /** End column number */
+    endColumn?: number;
+    /** Raw source code snippet */
+    source?: string;
+    /** Suggested fix */
+    fix?: Fix;
+    /** 规则文档链接（终端可点击跳转） */
+    docsUrl?: string;
+    /** Additional metadata */
+    meta?: Record<string, unknown>;
+}
+/** 修复置信度级别 */
+export type FixConfidence = "high" | "medium" | "low";
+export interface Fix {
+    /** Replacement text */
+    text: string;
+    /** Start position in file */
+    start: Position;
+    /** End position in file */
+    end: Position;
+    /** 修复置信度（默认 high） */
+    confidence?: FixConfidence;
+    /** 修复说明（交互式模式下展示给用户） */
+    description?: string;
+}
+/** Fix preview for dry-run mode */
+export interface FixPreview {
+    /** File path */
+    file: string;
+    /** Rule ID */
+    ruleId: string;
+    /** Issue title */
+    title: string;
+    /** Diff preview */
+    diff: string;
+}
+export interface Position {
+    line: number;
+    column: number;
+}
+export interface ScanResult {
+    /** Module name */
+    module: string;
+    /** Total issues found */
+    total: number;
+    /** Issues grouped by severity */
+    issues: Record<Severity, Issue[]>;
+    /** Scan duration in ms */
+    duration: number;
+    /** Files scanned */
+    filesScanned: number;
+    /** Files with issues */
+    filesWithIssues: number;
+}
+export interface Rule {
+    /** Rule ID (kebab-case) */
+    id: string;
+    /** Rule name */
+    name: string;
+    /** Rule description */
+    description: string;
+    /** Default severity */
+    severity: Severity;
+    /** Category */
+    category: RuleCategory;
+    /** Whether rule is enabled by default */
+    defaultEnabled: boolean;
+    /** Frameworks this rule applies to */
+    frameworks?: Framework[];
+    /** Component libs this rule applies to */
+    componentLibs?: ComponentLib[];
+    /** Platforms this rule applies to */
+    platforms?: Platform[];
+    /** Rule metadata (params, notes, etc.) */
+    meta?: Record<string, unknown>;
+    /** 规则文档链接 */
+    docsUrl?: string;
+    /** Execute rule on a file */
+    execute(context: RuleContext): Issue[] | Promise<Issue[]>;
+}
+export type RuleCategory = "i18n" | "component" | "hooks" | "platform" | "performance" | "accessibility" | "security" | "style" | "architecture";
+export interface RuleContext {
+    /** Absolute path to the file being analyzed */
+    filePath: string;
+    /** File content */
+    source: string;
+    /** Parsed AST (if applicable) */
+    ast?: unknown;
+    /** Project configuration */
+    config: ProjectConfig;
+    /** Detected project metadata */
+    projectMeta: ProjectMeta;
+    /** Utility helpers */
+    utils: RuleUtils;
+    /** v2.1.1: 单次扫描内规则间共享的缓存（按文件隔离） */
+    sharedCache?: Map<string, unknown>;
+}
+export interface RuleUtils {
+    /** Parse file to AST */
+    parseAST(source: string, options?: ParseOptions): unknown;
+    /** Get imported modules */
+    getImports(ast: unknown): ImportInfo[];
+    /** Report a position in source */
+    reportPosition(offset: number): Position;
+    /** Extract source snippet */
+    getSourceSnippet(start: number, end: number): string;
+}
+export interface ImportInfo {
+    source: string;
+    specifiers: string[];
+    defaultImport?: string;
+    namespaceImport?: string;
+    line: number;
+    column: number;
+}
+export interface ParseOptions {
+    /** File extension to determine parser */
+    ext?: string;
+    /** Source type: script | module */
+    sourceType?: "script" | "module";
+    /** Enable JSX/TSX */
+    jsx?: boolean;
+}
+export interface RuleConfig {
+    /** 规则 ID */
+    id: string;
+    /** 是否启用（默认 true） */
+    enabled?: boolean;
+    /** 覆盖严重级别 */
+    severity?: Severity;
+    /** 规则参数（覆盖默认值） */
+    params?: Record<string, unknown>;
+}
+export interface CustomRuleConfig {
+    /** 自定义规则文件路径（相对项目根目录或绝对路径） */
+    path: string;
+}
+export interface ProjectConfig {
+    /** Config file path */
+    configFile?: string;
+    /** 继承的组织级基线配置（URL 或本地路径） */
+    extends?: string;
+    /** i18n configuration */
+    i18n?: I18nConfig;
+    /** Component configuration */
+    component?: ComponentConfig;
+    /** Hooks configuration */
+    hooks?: HooksConfig;
+    /** Platform configuration */
+    platform?: PlatformConfig;
+    /** Gate configuration */
+    gate?: GateConfig;
+    /** AI context configuration */
+    aiContext?: AIContextConfig;
+    /** Scan scope */
+    scan?: ScanConfig;
+    /** Naming convention configuration */
+    naming?: NamingConfig;
+    /** ── Phase 3: 规则配置驱动 ── */
+    /** 规则开关/参数配置 */
+    rules?: RuleConfig[];
+    /** 自定义规则文件列表 */
+    customRules?: CustomRuleConfig[];
+}
+export interface I18nConfig {
+    sourceLocale: string;
+    targetLocales: string[];
+    format: "json" | "yaml" | "js" | "ts";
+    keyPattern: string;
+    extractPaths: string[];
+    ignorePaths: string[];
+    interpolationPattern: string;
+    translateProvider: string;
+}
+export interface ComponentConfig {
+    library: "auto" | ComponentLib;
+    themeTokenPrefix: string;
+    maxSelectOptions: number;
+    checkA11y: boolean;
+    checkPerf: boolean;
+    libraryVersion: string;
+}
+export interface HooksConfig {
+    maxEffectDeps: number;
+    checkClosure: boolean;
+    checkCustomHookNaming: boolean;
+    checkVueComposables: boolean;
+}
+export interface PlatformConfig {
+    targets: Platform[];
+    mp: MpConfig;
+    mobile: MobileConfig;
+    harmony: HarmonyConfig;
+}
+export interface MpConfig {
+    type: string;
+    maxMainPackageSize: number;
+    maxSubPackageSize: number;
+    maxBase64ImageSize: number;
+    maxPageStack: number;
+}
+export interface MobileConfig {
+    minTouchTarget: number;
+    checkSafeArea: boolean;
+    checkClickDelay: boolean;
+    checkKeyboard: boolean;
+}
+export interface HarmonyConfig {
+    strictTypeCheck: boolean;
+    arktsVersion: string;
+}
+export interface GateConfig {
+    enabled: boolean;
+    critical: {
+        max: number;
+    };
+    warning: {
+        max: number;
+    };
+    suggestion: {
+        max: number;
+    };
+    blockPipeline: boolean;
+}
+export interface AIContextConfig {
+    agent: "claude" | "cursor" | "copilot" | "all" | "generic";
+    includeFiles: string[];
+    autoUpdate: boolean;
+    excludeDirs: string[];
+}
+export interface ScanConfig {
+    includeExtensions: string[];
+    excludeDirs: string[];
+    excludePatterns: string[];
+}
+export interface NamingConfig {
+    /** 类名规范: PascalCase */
+    classCase: "PascalCase" | "camelCase";
+    /** 接口名规范 */
+    interfaceCase: "PascalCase" | "camelCase";
+    /** 类型别名规范 */
+    typeAliasCase: "PascalCase" | "camelCase";
+    /** 函数/方法规范 */
+    functionCase: "camelCase" | "PascalCase";
+    /** 变量规范 */
+    variableCase: "camelCase" | "snake_case";
+    /** 常量规范 (const 声明的字面量) */
+    constantCase: "UPPER_SNAKE_CASE" | "camelCase";
+    /** 枚举名规范 */
+    enumCase: "PascalCase" | "UPPER_SNAKE_CASE";
+    /** 枚举成员规范 */
+    enumMemberCase: "UPPER_SNAKE_CASE" | "PascalCase";
+    /** 私有成员前缀: underscore | hash | none */
+    privatePrefix: "underscore" | "hash" | "none";
+    /** 文件名规范 */
+    fileNameCase: "kebab-case" | "camelCase" | "PascalCase";
+    /** 文件夹名规范 */
+    folderNameCase: "kebab-case" | "camelCase" | "PascalCase";
+    /** 是否允许单字母变量 (i, j, k, x, y, z) */
+    allowSingleLetter: boolean;
+    /** 是否允许 React 组件使用 PascalCase 函数 */
+    allowPascalCaseComponents: boolean;
+    /** 忽略的命名模式 */
+    ignorePatterns: string[];
+}
+export interface ProjectMeta {
+    /** Detected framework */
+    framework?: Framework;
+    /** Detected component library */
+    componentLib?: ComponentLib;
+    /** Detected platforms */
+    platforms: Platform[];
+    /** Framework version */
+    frameworkVersion?: string;
+    /** Component lib version */
+    componentLibVersion?: string;
+    /** Has TypeScript */
+    hasTypeScript: boolean;
+    /** Has i18n */
+    hasI18n: boolean;
+    /** i18n library */
+    i18nLib?: string;
+    /** Package.json scripts */
+    scripts: Record<string, string>;
+    /** Detected bundler / build tool */
+    bundler?: Bundler;
+    bundlerVersion?: string;
+    /** Detected test framework */
+    testFramework?: TestFramework;
+    testFrameworkVersion?: string;
+    /** Detected state manager */
+    stateManager?: StateManager;
+    stateManagerVersion?: string;
+    /** Detected styling solution */
+    styling?: StylingSolution;
+    stylingVersion?: string;
+    /** Detected router */
+    router?: RouterLib;
+    routerVersion?: string;
+    /** Detected package manager */
+    packageManager: PackageManager;
+    /** Detected linter / formatter */
+    linter?: LinterTool;
+    /** Detected monorepo tool */
+    monorepoTool?: MonorepoTool;
+    /** Runtime (node / deno / bun) */
+    runtime: Runtime;
+    runtimeVersion?: string;
+}
+export type Bundler = "webpack" | "vite" | "rsbuild" | "parcel" | "esbuild" | "rollup" | "turbopack" | "farm" | "rspack" | "wmr";
+export type TestFramework = "jest" | "vitest" | "cypress" | "playwright" | "mocha" | "karma" | "ava" | "node:test";
+export type StateManager = "redux" | "mobx" | "zustand" | "recoil" | "jotai" | "pinia" | "vuex" | "valtio";
+export type StylingSolution = "tailwindcss" | "styled-components" | "emotion" | "sass" | "less" | "css-modules" | "vanilla-extract" | "unocss" | "windicss";
+export type RouterLib = "react-router" | "vue-router" | "tanstack-router" | "wouter" | "nextjs-router" | "nuxt-router";
+export type PackageManager = "npm" | "yarn" | "pnpm" | "bun";
+export type LinterTool = "eslint" | "biome" | "oxlint" | "prettier" | "stylelint";
+export type MonorepoTool = "nx" | "turborepo" | "lerna" | "rush" | "pnpm-workspace";
+export type Runtime = "node" | "deno" | "bun";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Core type definitions for frontend-guardian rule engine
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/utils/ast-parser.d.ts

@@ -0,0 +1,21 @@
+/**
+ * AST 解析工具
+ * 基于 @babel/parser，支持 JS/TS/JSX/TSX/Vue SFC
+ */
+import type { ParseResult } from "@babel/parser";
+import type { File, Node } from "@babel/types";
+import type { ImportInfo } from "../types.js";
+export interface ParseOptions {
+    ext?: string;
+    sourceType?: "script" | "module";
+    jsx?: boolean;
+}
+/** 解析源代码为 AST */
+export declare function parseAST(source: string, options?: ParseOptions): ParseResult<File> | null;
+/** 从 AST 提取 import 信息 */
+export declare function getImports(ast: ParseResult<File> | null): ImportInfo[];
+/** 检查 AST 是否包含特定 import */
+export declare function hasImport(ast: ParseResult<File> | null, moduleName: string, importName?: string): boolean;
+/** 遍历 AST 节点 */
+export declare function walkAST<T extends Node>(ast: ParseResult<File> | null, nodeType: string, callback: (node: T, path: any) => void): void;
+//# sourceMappingURL=ast-parser.d.ts.map

package/dist/utils/ast-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-parser.d.ts","sourceRoot":"","sources":["../../src/utils/ast-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,eAAe,CAAC;AAChE,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,YAAY;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACjC,GAAG,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,iBAAiB;AACjB,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAsCzF;AAED,yBAAyB;AACzB,wBAAgB,UAAU,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,UAAU,EAAE,CAmCtE;AAED,2BAA2B;AAC3B,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAazG;AAED,gBAAgB;AAChB,wBAAgB,OAAO,CAAC,CAAC,SAAS,IAAI,EAClC,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,EAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,GACvC,IAAI,CAQN"}

package/dist/utils/ast-parser.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * AST 解析工具
+ * 基于 @babel/parser，支持 JS/TS/JSX/TSX/Vue SFC
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAST = parseAST;
+exports.getImports = getImports;
+exports.hasImport = hasImport;
+exports.walkAST = walkAST;
+const parser_1 = require("@babel/parser");
+const traverse_1 = __importDefault(require("@babel/traverse"));
+/** 解析源代码为 AST */
+function parseAST(source, options) {
+    const ext = options?.ext || ".js";
+    const isTS = ext === ".ts" || ext === ".tsx" || ext === ".vue";
+    const isJSX = ext === ".jsx" || ext === ".tsx" || ext === ".vue" || options?.jsx;
+    // Vue SFC: 提取 <script> 内容
+    if (ext === ".vue") {
+        const scriptMatch = source.match(/<script[^>]*>([\s\S]*?)<\/script>/);
+        if (scriptMatch) {
+            source = scriptMatch[1].trim();
+        }
+        else {
+            return null;
+        }
+    }
+    const parserOpts = {
+        sourceType: options?.sourceType || "module",
+        allowImportExportEverywhere: true,
+        allowReturnOutsideFunction: true,
+        plugins: [
+            "decorators-legacy",
+            "classProperties",
+            "objectRestSpread",
+            "asyncGenerators",
+            "dynamicImport",
+            "optionalChaining",
+            "nullishCoalescingOperator",
+            ...(isTS ? ["typescript"] : []),
+            ...(isJSX ? ["jsx"] : []),
+        ],
+    };
+    try {
+        return (0, parser_1.parse)(source, parserOpts);
+    }
+    catch (err) {
+        // 解析失败，返回 null
+        return null;
+    }
+}
+/** 从 AST 提取 import 信息 */
+function getImports(ast) {
+    if (!ast)
+        return [];
+    const imports = [];
+    (0, traverse_1.default)(ast, {
+        ImportDeclaration(path) {
+            const source = path.node.source.value;
+            const specifiers = [];
+            let defaultImport;
+            let namespaceImport;
+            const { line, column } = path.node.loc?.start || { line: 0, column: 0 };
+            for (const spec of path.node.specifiers) {
+                if (spec.type === "ImportDefaultSpecifier") {
+                    defaultImport = spec.local.name;
+                }
+                else if (spec.type === "ImportNamespaceSpecifier") {
+                    namespaceImport = spec.local.name;
+                }
+                else if (spec.type === "ImportSpecifier") {
+                    specifiers.push(spec.local.name);
+                }
+            }
+            imports.push({
+                source,
+                specifiers,
+                defaultImport,
+                namespaceImport,
+                line,
+                column,
+            });
+        },
+    });
+    return imports;
+}
+/** 检查 AST 是否包含特定 import */
+function hasImport(ast, moduleName, importName) {
+    if (!ast)
+        return false;
+    const imports = getImports(ast);
+    for (const imp of imports) {
+        if (imp.source === moduleName) {
+            if (!importName)
+                return true;
+            if (imp.defaultImport === importName)
+                return true;
+            if (imp.namespaceImport === importName)
+                return true;
+            if (imp.specifiers.includes(importName))
+                return true;
+        }
+    }
+    return false;
+}
+/** 遍历 AST 节点 */
+function walkAST(ast, nodeType, callback) {
+    if (!ast)
+        return;
+    (0, traverse_1.default)(ast, {
+        [nodeType](path) {
+            callback(path.node, path);
+        },
+    });
+}
+//# sourceMappingURL=ast-parser.js.map

package/dist/utils/ast-parser.js.map

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

package/dist/utils/baseline.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 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 重新生成（清理已修复的遗留问题）
+ */
+import type { Issue } from "../types.js";
+/** Baseline 文件格式 */
+export interface BaselineFile {
+    /** 格式版本 */
+    version: string;
+    /** 生成时间戳 */
+    generatedAt: number;
+    /** 已知问题列表 */
+    issues: BaselineIssue[];
+    /** 元数据 */
+    meta?: {
+        projectDir?: string;
+        toolVersion?: string;
+    };
+}
+/** Baseline 中的单条问题（精简字段，用于匹配） */
+export interface BaselineIssue {
+    file: string;
+    ruleId: string;
+    line: number;
+    column: number;
+    severity: Issue["severity"];
+    title: string;
+}
+/** Baseline 对比结果 */
+export interface BaselineResult {
+    /** 新问题（不在 baseline 中） */
+    newIssues: Issue[];
+    /** 已知问题（在 baseline 中，本次仍出现） */
+    knownIssues: Issue[];
+    /** 已修复问题（在 baseline 中，本次未出现） */
+    fixedIssues: BaselineIssue[];
+    /** 总问题数 */
+    totalIssues: number;
+    /** 是否使用了 baseline */
+    baselineLoaded: boolean;
+}
+/** 将 Issue 精简为 BaselineIssue */
+export declare function toBaselineIssue(issue: Issue): BaselineIssue;
+/** 加载 baseline 文件 */
+export declare function loadBaseline(filePath: string): BaselineFile | null;
+/** 保存 baseline 文件 */
+export declare function saveBaseline(filePath: string, issues: Issue[], meta?: BaselineFile["meta"]): void;
+/**
+ * 将当前扫描结果与 baseline 对比
+ * @param issues 当前扫描出的所有问题
+ * @param baselinePath baseline 文件路径（绝对或相对）
+ * @param projectDir 项目根目录（用于解析相对路径）
+ * @returns BaselineResult 对比结果
+ */
+export declare function compareWithBaseline(issues: Issue[], baselinePath: string, projectDir: string): BaselineResult;
+/**
+ * 生成或更新 baseline 文件
+ * 如果文件已存在则覆盖
+ */
+export declare function generateBaseline(issues: Issue[], baselinePath: string, projectDir: string, meta?: BaselineFile["meta"]): void;
+/**
+ * BaselineManager — 面向对象的封装
+ */
+export declare class BaselineManager {
+    private baselinePath;
+    private projectDir;
+    private baseline;
+    constructor(baselinePath: string, projectDir: string);
+    /** 是否已加载有效的 baseline */
+    isLoaded(): boolean;
+    /** 获取已加载的 baseline 内容 */
+    getBaseline(): BaselineFile | null;
+    /** 对比当前 issues，返回仅含新增问题的过滤结果 */
+    filterNewIssues(issues: Issue[]): BaselineResult;
+    /** 将当前 issues 保存为 baseline（覆盖） */
+    save(issues: Issue[], meta?: BaselineFile["meta"]): void;
+    /** 获取 baseline 文件路径 */
+    getPath(): string;
+}
+//# sourceMappingURL=baseline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.d.ts","sourceRoot":"","sources":["../../src/utils/baseline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,oBAAoB;AACpB,MAAM,WAAW,YAAY;IACzB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa;IACb,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,UAAU;IACV,IAAI,CAAC,EAAE;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACL;AAED,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,oBAAoB;AACpB,MAAM,WAAW,cAAc;IAC3B,yBAAyB;IACzB,SAAS,EAAE,KAAK,EAAE,CAAC;IACnB,+BAA+B;IAC/B,WAAW,EAAE,KAAK,EAAE,CAAC;IACrB,gCAAgC;IAChC,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,cAAc,EAAE,OAAO,CAAC;CAC3B;AASD,gCAAgC;AAChC,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa,CAS3D;AAED,qBAAqB;AACrB,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAelE;AAED,qBAAqB;AACrB,wBAAgB,YAAY,CACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,KAAK,EAAE,EACf,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,GAC5B,IAAI,CAWN;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,KAAK,EAAE,EACf,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACnB,cAAc,CAsChB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC5B,MAAM,EAAE,KAAK,EAAE,EACf,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,GAC5B,IAAI,CAGN;AAED;;GAEG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAA6B;gBAEjC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAMpD,wBAAwB;IACxB,QAAQ,IAAI,OAAO;IAInB,yBAAyB;IACzB,WAAW,IAAI,YAAY,GAAG,IAAI;IAIlC,gCAAgC;IAChC,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,cAAc;IAIhD,kCAAkC;IAClC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,IAAI;IAKxD,uBAAuB;IACvB,OAAO,IAAI,MAAM;CAGpB"}