autosnippet 3.2.9 → 3.2.11

package/dist/lib/service/guard/RuleLearner.js

@@ -0,0 +1,298 @@
+/**
+ * RuleLearner — Guard 规则学习系统
+ * 追踪规则触发与用户反馈，计算 P/R/F1，识别高误报规则并给出优化建议
+ * 持久化到 AutoSnippet/guard-learner.json（Git 友好）
+ */
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import Logger from '../../infrastructure/logging/Logger.js';
+import { RULE_LEARNER } from '../../shared/constants.js';
+import pathGuard from '../../shared/PathGuard.js';
+const PROBLEMATIC_THRESHOLD = {
+    falsePositiveRate: RULE_LEARNER.PROBLEMATIC_FALSE_POSITIVE_RATE,
+    minTriggers: RULE_LEARNER.PROBLEMATIC_MIN_TRIGGERS,
+};
+export class RuleLearner {
+    #learnerPath;
+    #data;
+    constructor(projectRoot, options = {}) {
+        const kbDir = options.knowledgeBaseDir || 'AutoSnippet';
+        this.#learnerPath = join(projectRoot, kbDir, 'guard-learner.json');
+        pathGuard.assertProjectWriteSafe(this.#learnerPath);
+        this.#migrateOldPath(projectRoot, options.internalDir || '.autosnippet');
+        this.#data = this.#load();
+    }
+    /**
+     * 记录规则触发
+     * @param {string} ruleId
+     * @param {{ filePath?: string, message?: string }} context
+     */
+    recordTrigger(ruleId, _context = {}) {
+        const stat = this.#ensureStat(ruleId);
+        stat.triggers++;
+        const now = new Date().toISOString();
+        stat.lastTriggered = now;
+        if (!stat.firstTriggered) {
+            stat.firstTriggered = now;
+        }
+        this.#save();
+    }
+    /**
+     * 记录用户反馈
+     * @param {string} ruleId
+     * @param {'correct'|'falsePositive'|'falseNegative'} feedbackType
+     */
+    recordFeedback(ruleId, feedbackType) {
+        const stat = this.#ensureStat(ruleId);
+        if (feedbackType === 'correct') {
+            stat.correct++;
+        }
+        else if (feedbackType === 'falsePositive') {
+            stat.falsePositive++;
+        }
+        else if (feedbackType === 'falseNegative') {
+            stat.falseNegative++;
+        }
+        stat.lastFeedback = new Date().toISOString();
+        this.#save();
+    }
+    /**
+     * 获取规则精准度指标
+     * @param {string} ruleId
+     * @returns {{ precision: number, recall: number, f1: number, triggers: number, falsePositiveRate: number }}
+     */
+    getMetrics(ruleId) {
+        const stat = this.#data.ruleStats[ruleId];
+        if (!stat || stat.triggers === 0) {
+            return { precision: 1, recall: 1, f1: 1, triggers: 0, falsePositiveRate: 0 };
+        }
+        const tp = stat.correct;
+        const fp = stat.falsePositive;
+        const fn = stat.falseNegative;
+        const precision = tp + fp > 0 ? tp / (tp + fp) : 1;
+        const recall = tp + fn > 0 ? tp / (tp + fn) : 1;
+        const f1 = precision + recall > 0 ? (2 * precision * recall) / (precision + recall) : 0;
+        const falsePositiveRate = stat.triggers > 0 ? fp / stat.triggers : 0;
+        return { precision, recall, f1, triggers: stat.triggers, falsePositiveRate };
+    }
+    /**
+     * 识别问题规则（高误报）
+     * @returns {Array<{ ruleId: string, metrics: object, recommendation: string }>}
+     */
+    getProblematicRules() {
+        const results = [];
+        for (const [ruleId, stat] of Object.entries(this.#data.ruleStats)) {
+            if (stat.triggers < PROBLEMATIC_THRESHOLD.minTriggers) {
+                continue;
+            }
+            const metrics = this.getMetrics(ruleId);
+            if (metrics.falsePositiveRate >= PROBLEMATIC_THRESHOLD.falsePositiveRate) {
+                let recommendation;
+                if (metrics.falsePositiveRate > 0.7) {
+                    recommendation = 'disable';
+                }
+                else if (metrics.precision < 0.5) {
+                    recommendation = 'tune';
+                }
+                else {
+                    recommendation = 'review';
+                }
+                results.push({ ruleId, metrics, recommendation });
+            }
+        }
+        return results.sort((a, b) => b.metrics.falsePositiveRate - a.metrics.falsePositiveRate);
+    }
+    /**
+     * 获取所有规则统计
+     */
+    getAllStats() {
+        const result = {};
+        for (const [ruleId] of Object.entries(this.#data.ruleStats)) {
+            result[ruleId] = {
+                ...this.#data.ruleStats[ruleId],
+                metrics: this.getMetrics(ruleId),
+            };
+        }
+        return result;
+    }
+    /**
+     * 重置指定规则或全部统计
+     */
+    resetStats(ruleId = null) {
+        if (ruleId) {
+            delete this.#data.ruleStats[ruleId];
+        }
+        else {
+            this.#data.ruleStats = {};
+        }
+        this.#save();
+    }
+    /**
+     * 基于历史数据提出规则优化建议
+     * 策略 1: 高误报规则 → 建议调整
+     * 策略 2: 高触发且高精度 → 建议创建项目特化版本
+     * @returns {Array<{ type: string, ruleId: string, message: string, confidence: number, evidence: object }>}
+     */
+    suggestRules() {
+        const suggestions = [];
+        // 策略 1: 从高误报规则推导改进建议
+        const problematic = this.getProblematicRules();
+        for (const p of problematic) {
+            if (p.recommendation === 'tune') {
+                suggestions.push({
+                    type: 'tune_existing',
+                    ruleId: p.ruleId,
+                    message: `规则 ${p.ruleId} 误报率 ${(p.metrics.falsePositiveRate * 100).toFixed(0)}%，建议调整正则或收窄语言范围`,
+                    confidence: RULE_LEARNER.CONFIDENCE_TUNE,
+                    evidence: p.metrics,
+                });
+            }
+            else if (p.recommendation === 'disable') {
+                suggestions.push({
+                    type: 'disable',
+                    ruleId: p.ruleId,
+                    message: `规则 ${p.ruleId} 误报率 ${(p.metrics.falsePositiveRate * 100).toFixed(0)}%，建议禁用`,
+                    confidence: RULE_LEARNER.CONFIDENCE_DISABLE,
+                    evidence: p.metrics,
+                });
+            }
+        }
+        // 策略 2: 高触发 + 高精度内置规则 → 建议创建项目定制版
+        const allStats = this.getAllStats();
+        for (const [ruleId, stat] of Object.entries(allStats)) {
+            if (stat.triggers > RULE_LEARNER.HIGH_TRIGGER_COUNT &&
+                (stat.metrics?.precision ?? 1) > RULE_LEARNER.HIGH_PRECISION) {
+                suggestions.push({
+                    type: 'specialize',
+                    ruleId,
+                    message: `规则 ${ruleId} 触发 ${stat.triggers} 次且精准度高 (${((stat.metrics?.precision ?? 1) * 100).toFixed(0)}%)，建议创建项目定制版本`,
+                    confidence: RULE_LEARNER.CONFIDENCE_SPECIALIZE,
+                    evidence: stat.metrics,
+                });
+            }
+        }
+        // 策略 3: 长期无触发的规则 → 可能不适用
+        for (const [ruleId, stat] of Object.entries(allStats)) {
+            if (stat.triggers === 0 && stat.lastTriggered) {
+                const daysSinceLastTrigger = (Date.now() - new Date(stat.lastTriggered).getTime()) / 86400000;
+                if (daysSinceLastTrigger > RULE_LEARNER.UNUSED_DAYS_THRESHOLD) {
+                    suggestions.push({
+                        type: 'review_unused',
+                        ruleId,
+                        message: `规则 ${ruleId} 超过 ${RULE_LEARNER.UNUSED_DAYS_THRESHOLD} 天未触发，建议审查是否仍需保留`,
+                        confidence: RULE_LEARNER.CONFIDENCE_REVIEW,
+                        evidence: {
+                            daysSinceLastTrigger: Math.round(daysSinceLastTrigger),
+                            triggers: stat.triggers,
+                        },
+                    });
+                }
+            }
+        }
+        return suggestions.sort((a, b) => b.confidence - a.confidence);
+    }
+    /**
+     * 追踪规则创建后的效果
+     * 对比首次触发后的表现，判断规则是否有效
+     * @param {string} ruleId
+     * @returns {{ status: string, triggers: number, precision: number, recommendation: string, daysSinceFirstTrigger?: number }}
+     */
+    trackRuleEffectiveness(ruleId) {
+        const stat = this.#data.ruleStats[ruleId];
+        if (!stat) {
+            return { status: 'no_data', triggers: 0, precision: 1, recommendation: 'monitor' };
+        }
+        const firstTriggered = stat.firstTriggered || stat.lastTriggered;
+        if (!firstTriggered) {
+            return { status: 'no_triggers', triggers: 0, precision: 1, recommendation: 'monitor' };
+        }
+        const daysSinceFirstTrigger = (Date.now() - new Date(firstTriggered).getTime()) / 86400000;
+        // 不足 14 天 → 观察期
+        if (daysSinceFirstTrigger < 14) {
+            return {
+                status: 'monitoring',
+                triggers: stat.triggers,
+                precision: this.getMetrics(ruleId).precision,
+                recommendation: 'wait',
+                daysSinceFirstTrigger: Math.round(daysSinceFirstTrigger),
+            };
+        }
+        const metrics = this.getMetrics(ruleId);
+        // 14 天后判定
+        if (metrics.precision < RULE_LEARNER.LOW_PRECISION &&
+            stat.triggers >= PROBLEMATIC_THRESHOLD.minTriggers) {
+            return {
+                status: 'ineffective',
+                triggers: stat.triggers,
+                precision: metrics.precision,
+                recommendation: 'review_or_disable',
+                daysSinceFirstTrigger: Math.round(daysSinceFirstTrigger),
+            };
+        }
+        return {
+            status: 'effective',
+            triggers: stat.triggers,
+            precision: metrics.precision,
+            recommendation: 'keep',
+            daysSinceFirstTrigger: Math.round(daysSinceFirstTrigger),
+        };
+    }
+    // ─── 私有 ─────────────────────────────────────────────
+    #ensureStat(ruleId) {
+        if (!this.#data.ruleStats[ruleId]) {
+            this.#data.ruleStats[ruleId] = {
+                triggers: 0,
+                correct: 0,
+                falsePositive: 0,
+                falseNegative: 0,
+                firstTriggered: null,
+                lastTriggered: null,
+                lastFeedback: null,
+            };
+        }
+        return this.#data.ruleStats[ruleId];
+    }
+    #load() {
+        try {
+            if (existsSync(this.#learnerPath)) {
+                return JSON.parse(readFileSync(this.#learnerPath, 'utf-8'));
+            }
+        }
+        catch {
+            /* silent */
+        }
+        return { ruleStats: {} };
+    }
+    #save() {
+        try {
+            const dir = dirname(this.#learnerPath);
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+            writeFileSync(this.#learnerPath, JSON.stringify(this.#data, null, 2));
+        }
+        catch (err) {
+            Logger.getInstance().warn('RuleLearner: failed to persist learner data', {
+                error: err.message,
+            });
+        }
+    }
+    #migrateOldPath(projectRoot, internalDir) {
+        try {
+            const oldPath = join(projectRoot, internalDir, 'guard-learner.json');
+            if (existsSync(oldPath) && !existsSync(this.#learnerPath)) {
+                const content = readFileSync(oldPath, 'utf-8');
+                const dir = dirname(this.#learnerPath);
+                if (!existsSync(dir)) {
+                    mkdirSync(dir, { recursive: true });
+                }
+                writeFileSync(this.#learnerPath, content);
+                unlinkSync(oldPath);
+            }
+        }
+        catch {
+            /* 迁移失败不阻断启动 */
+        }
+    }
+}
+//# sourceMappingURL=RuleLearner.js.map

package/dist/lib/service/guard/RuleLearner.js.map

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

package/dist/lib/service/guard/SourceFileCollector.d.ts

@@ -0,0 +1,42 @@
+/**
+ * SourceFileCollector — 递归收集项目源文件
+ *
+ * 从 GuardHandler 提取的公共工具，供 ComplianceReporter / guard:ci / guard:staged 复用
+ */
+/** 支持审计的源文件扩展名 — 委托给 LanguageService */
+export declare const SOURCE_EXTS: Readonly<Set<string>>;
+/**
+ * 递归收集目录下所有源文件路径
+ * @param {string} dir 根目录
+ * @param {object} options
+ * @param {Set<string>} [options.extensions] 允许的扩展名（默认 SOURCE_EXTS）
+ * @param {Set<string>} [options.skipDirs] 跳过的目录名（默认 SKIP_DIRS）
+ * @param {number} [options.maxFiles] 最大文件数量（默认无限制）
+ * @returns {Promise<string[]>} 文件路径列表
+ */
+export declare function collectSourceFiles(dir: string, options?: {
+    extensions?: Set<string>;
+    skipDirs?: Set<string>;
+    maxFiles?: number;
+}): Promise<string[]>;
+/**
+ * 收集源文件并读取内容
+ * @param {string} dir 根目录
+ * @param {object} options - collectSourceFiles 选项
+ * @returns {Promise<Array<{path: string, content: string}>>}
+ */
+export declare function collectSourceFilesWithContent(dir: string, options?: {
+    extensions?: Set<string>;
+    skipDirs?: Set<string>;
+    maxFiles?: number;
+}): Promise<{
+    path: string;
+    content: string;
+}[]>;
+declare const _default: {
+    collectSourceFiles: typeof collectSourceFiles;
+    collectSourceFilesWithContent: typeof collectSourceFilesWithContent;
+    SOURCE_EXTS: Readonly<Set<string>>;
+};
+export default _default;
+//# sourceMappingURL=SourceFileCollector.d.ts.map

package/dist/lib/service/guard/SourceFileCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SourceFileCollector.d.ts","sourceRoot":"","sources":["../../../../lib/service/guard/SourceFileCollector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,wCAAwC;AACxC,eAAO,MAAM,WAAW,uBAA6B,CAAC;AAiCtD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,qBAuCtF;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO;UAG9D,MAAM;aAAW,MAAM;KAY/C;;;;;;AAED,wBAAkF"}

package/dist/lib/service/guard/SourceFileCollector.js

@@ -0,0 +1,106 @@
+/**
+ * SourceFileCollector — 递归收集项目源文件
+ *
+ * 从 GuardHandler 提取的公共工具，供 ComplianceReporter / guard:ci / guard:staged 复用
+ */
+import { readdir, readFile } from 'node:fs/promises';
+import { extname, join } from 'node:path';
+import { LanguageService } from '../../shared/LanguageService.js';
+/** 支持审计的源文件扩展名 — 委托给 LanguageService */
+export const SOURCE_EXTS = LanguageService.sourceExts;
+/** 跳过的目录 */
+const SKIP_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'build',
+    'DerivedData',
+    'Pods',
+    '.build',
+    'vendor',
+    'dist',
+    '.next',
+    'Carthage',
+    'xcuserdata',
+    '__pycache__',
+    // Rust
+    'target',
+    '.cargo',
+    // Python 虚拟环境
+    'venv',
+    '.venv',
+    'env',
+    // JVM 构建工具
+    '.gradle',
+    '.mvn',
+    // 通用构建/输出目录
+    'out',
+    'coverage',
+    '.turbo',
+    '.parcel-cache',
+]);
+/**
+ * 递归收集目录下所有源文件路径
+ * @param {string} dir 根目录
+ * @param {object} options
+ * @param {Set<string>} [options.extensions] 允许的扩展名（默认 SOURCE_EXTS）
+ * @param {Set<string>} [options.skipDirs] 跳过的目录名（默认 SKIP_DIRS）
+ * @param {number} [options.maxFiles] 最大文件数量（默认无限制）
+ * @returns {Promise<string[]>} 文件路径列表
+ */
+export async function collectSourceFiles(dir, options = {}) {
+    const { extensions = SOURCE_EXTS, skipDirs = SKIP_DIRS, maxFiles = Infinity } = options;
+    const files = [];
+    async function walk(currentDir) {
+        if (files.length >= maxFiles) {
+            return;
+        }
+        let entries;
+        try {
+            entries = await readdir(currentDir, { withFileTypes: true });
+        }
+        catch {
+            return; // 权限不足等情况跳过
+        }
+        for (const entry of entries) {
+            if (files.length >= maxFiles) {
+                return;
+            }
+            if (entry.name.startsWith('.') && entry.name !== '.') {
+                continue;
+            }
+            const fullPath = join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                if (!skipDirs.has(entry.name)) {
+                    await walk(fullPath);
+                }
+            }
+            else if (entry.isFile() && extensions.has(extname(entry.name).toLowerCase())) {
+                files.push(fullPath);
+            }
+        }
+    }
+    await walk(dir);
+    return files;
+}
+/**
+ * 收集源文件并读取内容
+ * @param {string} dir 根目录
+ * @param {object} options - collectSourceFiles 选项
+ * @returns {Promise<Array<{path: string, content: string}>>}
+ */
+export async function collectSourceFilesWithContent(dir, options = {}) {
+    const paths = await collectSourceFiles(dir, options);
+    const results = [];
+    for (const filePath of paths) {
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            results.push({ path: filePath, content });
+        }
+        catch {
+            // 读取失败跳过
+        }
+    }
+    return results;
+}
+export default { collectSourceFiles, collectSourceFilesWithContent, SOURCE_EXTS };
+//# sourceMappingURL=SourceFileCollector.js.map

package/dist/lib/service/guard/SourceFileCollector.js.map

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

package/dist/lib/service/guard/ViolationsStore.d.ts

@@ -0,0 +1,118 @@
+/**
+ * ViolationsStore — Guard 违反记录存储（DB 版）
+ * 记录每次 as:audit 运行的审计结果，持久化到 SQLite guard_violations 表。
+ * 最多保留 200 条。
+ */
+interface DatabaseLike {
+    prepare(sql: string): {
+        run(...params: unknown[]): unknown;
+        get(...params: unknown[]): Record<string, unknown>;
+        all(...params: unknown[]): Record<string, unknown>[];
+    };
+}
+interface ViolationRecord {
+    ruleId?: string;
+    severity?: string;
+    message?: string;
+    [key: string]: unknown;
+}
+interface RunInput {
+    filePath?: string;
+    violations?: ViolationRecord[];
+    summary?: string;
+}
+interface RunOutput {
+    id: string;
+    filePath: string;
+    triggeredAt: string;
+    violations: ViolationRecord[];
+    violationCount: number;
+    summary: string;
+}
+export declare class ViolationsStore {
+    #private;
+    /**
+     * @param {import('better-sqlite3').Database} db - SQLite 数据库实例
+     */
+    constructor(db: DatabaseLike);
+    /**
+     * 追加一次 Guard 运行记录
+     * ★ Drizzle 类型安全 INSERT + raw SQL 截断
+     */
+    appendRun(run: RunInput): string;
+    /**
+     * 获取所有运行记录（最新在后）
+     * ★ Drizzle 类型安全 SELECT
+     */
+    getRuns(): RunOutput[];
+    /**
+     * 按文件路径查询历史
+     * ★ Drizzle 类型安全 SELECT WHERE
+     */
+    getRunsByFile(filePath: string): RunOutput[];
+    /**
+     * 获取最近 N 条记录
+     * ★ Drizzle 类型安全 SELECT + ORDER + LIMIT
+     */
+    getRecentRuns(n?: number): RunOutput[];
+    /**
+     * 获取统计汇总
+     */
+    getStats(): {
+        totalRuns: number;
+        totalViolations: number;
+        averageViolationsPerRun: string | number;
+        lastRunAt: string | null;
+    };
+    /**
+     * 按规则 ID 聚合统计
+     * 利用 SQLite json_each 展开 violations_json 数组
+     * @returns {Array<{ruleId: string, severity: string, count: number}>}
+     */
+    getStatsByRule(): Record<string, unknown>[];
+    /**
+     * 获取趋势数据 — 对比最近两次运行
+     * @returns {{ errorsChange: number, warningsChange: number, latestErrors: number, latestWarnings: number, previousErrors: number, previousWarnings: number }}
+     */
+    getTrend(): {
+        errorsChange: number;
+        warningsChange: number;
+        latestErrors: number;
+        latestWarnings: number;
+        previousErrors: number;
+        previousWarnings: number;
+        hasHistory: boolean;
+    };
+    /**
+     * 清空所有记录
+     * ★ Drizzle 类型安全 DELETE
+     */
+    clearRuns(): void;
+    /**
+     * 清除指定规则或文件的记录
+     */
+    clearAll(): Promise<void>;
+    clear({ ruleId, file }?: {
+        ruleId?: string;
+        file?: string;
+    }): Promise<void>;
+    /**
+     * 兼容 v2 violations.js 路由的 list()
+     */
+    list(filters?: {
+        file?: string;
+    }, { page, limit }?: {
+        page?: number | undefined;
+        limit?: number | undefined;
+    }): Promise<{
+        data: RunOutput[];
+        pagination: {
+            page: number;
+            limit: number;
+            total: number;
+            pages: number;
+        };
+    }>;
+}
+export {};
+//# sourceMappingURL=ViolationsStore.d.ts.map

package/dist/lib/service/guard/ViolationsStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViolationsStore.d.ts","sourceRoot":"","sources":["../../../../lib/service/guard/ViolationsStore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,UAAU,YAAY;IACpB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG;QACpB,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QACnC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnD,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;KACtD,CAAC;CACH;AAED,UAAU,eAAe;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,QAAQ;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;;IAI1B;;OAEG;gBACS,EAAE,EAAE,YAAY;IAO5B;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,QAAQ;IA+BvB;;;OAGG;IACH,OAAO;IASP;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM;IAU9B;;;OAGG;IACH,aAAa,CAAC,CAAC,SAAK;IAUpB;;OAEG;IACH,QAAQ;;;;;;IAoBR;;;;OAIG;IACH,cAAc;IAmBd;;;OAGG;IACH,QAAQ;;;;;;;;;IAkCR;;;OAGG;IACH,SAAS;IAIT;;OAEG;IACG,QAAQ;IAIR,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO;IAQrE;;OAEG;IACG,IAAI,CAAC,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,EAAE,EAAE,IAAQ,EAAE,KAAU,EAAE;;;KAAK;;;;;;;;;CA2C1E"}