@dommaker/harness 0.18.0 → 1.0.0

package/dist/context/file-budget.d.ts

@@ -1,40 +0,0 @@
-/**
- * 文件读取预算
- *
- * 按行数、字节数、Token 数三重限制读取文件
- * 超限时生成 continuationHint 提示 offset
- */
-import type { FileBudgetConfig } from './types';
-export interface FileCheckResult {
-    allowed: boolean;
-    reason?: string;
-    lineCount?: number;
-    byteCount?: number;
-}
-export interface FileReadResult {
-    content: string;
-    truncated: boolean;
-    linesRead: number;
-    bytesRead: number;
-    tokensEstimate: number;
-    continuationHint?: string;
-}
-export declare class FileBudget {
-    private config;
-    constructor(config?: Partial<FileBudgetConfig>);
-    /**
-     * 检查文件是否在预算内（stat 检查）
-     */
-    checkFile(filePath: string): FileCheckResult;
-    /**
-     * 按预算读取文件
-     *
-     * 三重限制：行数 → 字节数 → Token 数
-     */
-    readWithBudget(filePath: string, config?: Partial<FileBudgetConfig>): FileReadResult;
-    /**
-     * 获取当前配置
-     */
-    getConfig(): FileBudgetConfig;
-}
-//# sourceMappingURL=file-budget.d.ts.map

package/dist/context/file-budget.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-budget.d.ts","sourceRoot":"","sources":["../../src/context/file-budget.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGhD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAI9C;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe;IAqB5C;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,cAAc;IAuEpF;;OAEG;IACH,SAAS,IAAI,gBAAgB;CAG9B"}

package/dist/context/file-budget.js

@@ -1,147 +0,0 @@
-"use strict";
-/**
- * 文件读取预算
- *
- * 按行数、字节数、Token 数三重限制读取文件
- * 超限时生成 continuationHint 提示 offset
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileBudget = void 0;
-const fs = __importStar(require("fs"));
-const token_budget_1 = require("./token-budget");
-const types_1 = require("./types");
-class FileBudget {
-    config;
-    constructor(config) {
-        this.config = { ...types_1.DEFAULT_FILE_BUDGET, ...config };
-    }
-    /**
-     * 检查文件是否在预算内（stat 检查）
-     */
-    checkFile(filePath) {
-        try {
-            const stat = fs.statSync(filePath);
-            if (stat.size > this.config.maxBytes) {
-                return {
-                    allowed: false,
-                    reason: `文件大小 ${(stat.size / 1024).toFixed(1)}KB 超过限制 ${(this.config.maxBytes / 1024).toFixed(1)}KB`,
-                    byteCount: stat.size,
-                };
-            }
-            return { allowed: true, byteCount: stat.size };
-        }
-        catch (error) {
-            return {
-                allowed: false,
-                reason: `无法读取文件: ${error.message}`,
-            };
-        }
-    }
-    /**
-     * 按预算读取文件
-     *
-     * 三重限制：行数 → 字节数 → Token 数
-     */
-    readWithBudget(filePath, config) {
-        const effectiveConfig = { ...this.config, ...config };
-        try {
-            const content = fs.readFileSync(filePath, 'utf-8');
-            const lines = content.split('\n');
-            let truncated = false;
-            let selectedLines = lines;
-            let continuationHint;
-            // 限制 1: 行数
-            if (lines.length > effectiveConfig.maxLines) {
-                selectedLines = lines.slice(0, effectiveConfig.maxLines);
-                truncated = true;
-                if (effectiveConfig.continuationHint) {
-                    continuationHint = `文件被截断。已读取 ${effectiveConfig.maxLines} 行，共 ${lines.length} 行。使用 offset=${effectiveConfig.maxLines} 继续读取。`;
-                }
-            }
-            let result = selectedLines.join('\n');
-            // 限制 2: 字节数
-            const byteCount = Buffer.byteLength(result, 'utf-8');
-            if (byteCount > effectiveConfig.maxBytes) {
-                const encoder = new TextEncoder();
-                const bytes = encoder.encode(result);
-                const truncatedBytes = bytes.slice(0, effectiveConfig.maxBytes);
-                result = new TextDecoder().decode(truncatedBytes);
-                truncated = true;
-                if (!continuationHint && effectiveConfig.continuationHint) {
-                    continuationHint = `文件内容被截断。已读取 ${effectiveConfig.maxBytes} 字节。`;
-                }
-            }
-            // 限制 3: Token 数
-            const tokensEstimate = token_budget_1.TokenEstimator.estimateText(result);
-            if (tokensEstimate > effectiveConfig.maxTokenEstimate) {
-                // 按比例截断
-                const ratio = effectiveConfig.maxTokenEstimate / tokensEstimate;
-                const charLimit = Math.floor(result.length * ratio);
-                result = result.slice(0, charLimit);
-                truncated = true;
-                if (!continuationHint && effectiveConfig.continuationHint) {
-                    continuationHint = `文件内容被截断。已读取约 ${effectiveConfig.maxTokenEstimate} tokens。`;
-                }
-            }
-            return {
-                content: result,
-                truncated,
-                linesRead: selectedLines.length,
-                bytesRead: Buffer.byteLength(result, 'utf-8'),
-                tokensEstimate: token_budget_1.TokenEstimator.estimateText(result),
-                continuationHint,
-            };
-        }
-        catch (error) {
-            return {
-                content: '',
-                truncated: false,
-                linesRead: 0,
-                bytesRead: 0,
-                tokensEstimate: 0,
-                continuationHint: `无法读取文件: ${error.message}`,
-            };
-        }
-    }
-    /**
-     * 获取当前配置
-     */
-    getConfig() {
-        return { ...this.config };
-    }
-}
-exports.FileBudget = FileBudget;
-//# sourceMappingURL=file-budget.js.map

package/dist/context/file-budget.js.map

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

package/dist/context/progressive-loader.d.ts

@@ -1,109 +0,0 @@
-/**
- * @spec HZ-002
- * @implements HZ-002-C1
- * @acceptance AC-001-1, AC-001-4
- *
- * Progressive Content Loader
- *
- * 通用内容分片加载能力
- * - 支持大数据集分片加载
- * - 支持 Token 预算管理
- * - 零业务逻辑，可被任意系统使用
- */
-export interface ChunkLoadOptions<T = any> {
-    /** 每片大小 */
-    chunkSize: number;
-    /** 每片加载回调 */
-    onChunk?: (chunk: T[], index: number) => Promise<void> | void;
-    /** 进度回调 (loaded, total) */
-    onProgress?: (loaded: number, total: number) => void;
-    /** 是否并行加载 */
-    parallel?: boolean;
-    /** 延迟（毫秒），用于节流 */
-    delay?: number;
-}
-export interface TokenBudgetOptions<T = any> {
-    /** Token 预算 */
-    budget: number;
-    /** Token 估算函数 */
-    estimator: (item: T) => number;
-    /** 预算超限策略 */
-    onBudgetExceeded?: 'truncate' | 'error' | 'skip';
-    /** 最小保留项数（即使超预算） */
-    minItems?: number;
-}
-export interface LoadResult<T> {
-    /** 加载的项 */
-    items: T[];
-    /** 实际消耗的 Token */
-    tokensUsed: number;
-    /** 是否被截断 */
-    truncated: boolean;
-    /** 跳过的项数 */
-    skipped: number;
-}
-/**
- * 渐进式内容加载器
- *
- * 提供通用的内容分片加载和 Token 预算管理能力
- */
-export declare class ProgressiveLoader {
-    /**
-     * 分片加载
-     *
-     * 将大数据集分片加载，避免一次性加载全部内容
-     *
-     * @example
-     * ```typescript
-     * const loader = new ProgressiveLoader();
-     * const largeData = Array.from({ length: 1000 }, (_, i) => ({ id: i }));
-     *
-     * await loader.loadInChunks(largeData, {
-     *   chunkSize: 100,
-     *   onChunk: async (chunk, index) => {
-     *     console.log(`Loaded chunk ${index}: ${chunk.length} items`);
-     *   },
-     *   onProgress: (loaded, total) => {
-     *     console.log(`Progress: ${loaded}/${total}`);
-     *   }
-     * });
-     * ```
-     */
-    loadInChunks<T>(items: T[], options: ChunkLoadOptions<T>): Promise<void>;
-    /**
-     * Token 预算加载
-     *
-     * 在 Token 预算范围内加载内容，超预算时按策略处理
-     *
-     * @example
-     * ```typescript
-     * const loader = new ProgressiveLoader();
-     * const items = [
-     *   { content: 'short text' },
-     *   { content: 'long text '.repeat(100) }
-     * ];
-     *
-     * const result = await loader.loadWithBudget(items, {
-     *   budget: 1000,
-     *   estimator: (item) => item.content.length,
-     *   onBudgetExceeded: 'truncate'
-     * });
-     *
-     * console.log(`Loaded ${result.items.length} items, used ${result.tokensUsed} tokens`);
-     * ```
-     */
-    loadWithBudget<T>(items: T[], options: TokenBudgetOptions<T>): Promise<LoadResult<T>>;
-    /**
-     * 创建流式加载器
-     *
-     * 支持大文件/大内容的流式分片加载
-     */
-    createStream<T>(source: AsyncIterable<T>, chunkSize: number): AsyncIterable<T[]>;
-    /**
-     * 批量处理（带并发控制）
-     */
-    processBatch<T, R>(items: T[], processor: (item: T) => Promise<R>, concurrency?: number): Promise<R[]>;
-    private processChunk;
-}
-export declare const progressiveLoader: ProgressiveLoader;
-//# sourceMappingURL=progressive-loader.d.ts.map

package/dist/context/progressive-loader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"progressive-loader.d.ts","sourceRoot":"","sources":["../../src/context/progressive-loader.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,GAAG;IACvC,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9D,2BAA2B;IAC3B,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,aAAa;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,GAAG;IACzC,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC/B,aAAa;IACb,gBAAgB,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;IACjD,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,WAAW;IACX,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,YAAY,CAAC,CAAC,EAClB,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC;IAgChB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,cAAc,CAAC,CAAC,EACpB,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAkDzB;;;;OAIG;IACI,YAAY,CAAC,CAAC,EACnB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,SAAS,EAAE,MAAM,GAChB,aAAa,CAAC,CAAC,EAAE,CAAC;IAkBrB;;OAEG;IACG,YAAY,CAAC,CAAC,EAAE,CAAC,EACrB,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAClC,WAAW,GAAE,MAAU,GACtB,OAAO,CAAC,CAAC,EAAE,CAAC;YAmBD,YAAY;CAiB3B;AAGD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/context/progressive-loader.js

@@ -1,166 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.progressiveLoader = exports.ProgressiveLoader = void 0;
-const exec_1 = require("../utils/exec");
-/**
- * 渐进式内容加载器
- *
- * 提供通用的内容分片加载和 Token 预算管理能力
- */
-class ProgressiveLoader {
-    /**
-     * 分片加载
-     *
-     * 将大数据集分片加载，避免一次性加载全部内容
-     *
-     * @example
-     * ```typescript
-     * const loader = new ProgressiveLoader();
-     * const largeData = Array.from({ length: 1000 }, (_, i) => ({ id: i }));
-     *
-     * await loader.loadInChunks(largeData, {
-     *   chunkSize: 100,
-     *   onChunk: async (chunk, index) => {
-     *     console.log(`Loaded chunk ${index}: ${chunk.length} items`);
-     *   },
-     *   onProgress: (loaded, total) => {
-     *     console.log(`Progress: ${loaded}/${total}`);
-     *   }
-     * });
-     * ```
-     */
-    async loadInChunks(items, options) {
-        const { chunkSize, onChunk, onProgress, parallel = false, delay: throttleDelay = 0 } = options;
-        const total = items.length;
-        const chunks = [];
-        // 分片
-        for (let i = 0; i < total; i += chunkSize) {
-            chunks.push(items.slice(i, i + chunkSize));
-        }
-        // 加载
-        if (parallel) {
-            // 并行加载
-            await Promise.all(chunks.map(async (chunk, index) => {
-                if (throttleDelay > 0) {
-                    await (0, exec_1.delay)(throttleDelay * index);
-                }
-                await this.processChunk(chunk, index, onChunk, onProgress, total);
-            }));
-        }
-        else {
-            // 串行加载
-            for (let i = 0; i < chunks.length; i++) {
-                if (throttleDelay > 0 && i > 0) {
-                    await (0, exec_1.delay)(throttleDelay);
-                }
-                await this.processChunk(chunks[i], i, onChunk, onProgress, total);
-            }
-        }
-    }
-    /**
-     * Token 预算加载
-     *
-     * 在 Token 预算范围内加载内容，超预算时按策略处理
-     *
-     * @example
-     * ```typescript
-     * const loader = new ProgressiveLoader();
-     * const items = [
-     *   { content: 'short text' },
-     *   { content: 'long text '.repeat(100) }
-     * ];
-     *
-     * const result = await loader.loadWithBudget(items, {
-     *   budget: 1000,
-     *   estimator: (item) => item.content.length,
-     *   onBudgetExceeded: 'truncate'
-     * });
-     *
-     * console.log(`Loaded ${result.items.length} items, used ${result.tokensUsed} tokens`);
-     * ```
-     */
-    async loadWithBudget(items, options) {
-        const { budget, estimator, onBudgetExceeded = 'truncate', minItems = 1 } = options;
-        const result = {
-            items: [],
-            tokensUsed: 0,
-            truncated: false,
-            skipped: 0
-        };
-        let currentBudget = budget;
-        for (const item of items) {
-            const itemTokens = estimator(item);
-            // 检查预算
-            if (itemTokens > currentBudget) {
-                // 预算超限
-                if (result.items.length >= minItems) {
-                    // 已达到最小项数，按策略处理
-                    switch (onBudgetExceeded) {
-                        case 'truncate':
-                            result.truncated = true;
-                            return result;
-                        case 'error':
-                            throw new Error(`Token budget exceeded: need ${itemTokens}, remaining ${currentBudget}`);
-                        case 'skip':
-                            result.skipped++;
-                            continue;
-                    }
-                }
-                // 未达到最小项数，强制添加（可能超预算）
-            }
-            // 添加项
-            result.items.push(item);
-            result.tokensUsed += itemTokens;
-            currentBudget -= itemTokens;
-        }
-        return result;
-    }
-    /**
-     * 创建流式加载器
-     *
-     * 支持大文件/大内容的流式分片加载
-     */
-    async *createStream(source, chunkSize) {
-        let chunk = [];
-        for await (const item of source) {
-            chunk.push(item);
-            if (chunk.length >= chunkSize) {
-                yield chunk;
-                chunk = [];
-            }
-        }
-        //  yield remaining items
-        if (chunk.length > 0) {
-            yield chunk;
-        }
-    }
-    /**
-     * 批量处理（带并发控制）
-     */
-    async processBatch(items, processor, concurrency = 5) {
-        const results = new Array(items.length);
-        let nextIndex = 0;
-        const worker = async () => {
-            while (nextIndex < items.length) {
-                const index = nextIndex++;
-                results[index] = await processor(items[index]);
-            }
-        };
-        const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker());
-        await Promise.all(workers);
-        return results;
-    }
-    async processChunk(chunk, index, onChunk, onProgress, total) {
-        if (onChunk) {
-            await onChunk(chunk, index);
-        }
-        if (onProgress) {
-            const loaded = Math.min((index + 1) * chunk.length, total);
-            onProgress(loaded, total);
-        }
-    }
-}
-exports.ProgressiveLoader = ProgressiveLoader;
-// 默认实例
-exports.progressiveLoader = new ProgressiveLoader();
-//# sourceMappingURL=progressive-loader.js.map

package/dist/context/progressive-loader.js.map

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

package/dist/context/token-pipeline.d.ts

@@ -1,55 +0,0 @@
-/**
- * Token 流水线
- *
- * 五步：收集 → 排序 → 压缩 → 预算 → 组装
- * 每次 LLM 调用前运行
- */
-import type { ContextSource, TokenBudgetAllocation, PipelineInput, PipelineOutput } from './types';
-interface CollectedGroup {
-    priority: number;
-    sources: ContextSource[];
-}
-export declare class TokenPipeline {
-    /**
-     * 完整流水线：收集 → 排序 → 压缩 → 预算 → 组装
-     */
-    run(input: PipelineInput): PipelineOutput;
-    /**
-     * Step 1: 收集 — 从 sources 按 priority 分组
-     */
-    collect(sources: ContextSource[]): CollectedGroup[];
-    /**
-     * Step 2: 排序 — 按 P1→P6，组内保持原序
-     */
-    sort(groups: CollectedGroup[]): ContextSource[];
-    /**
-     * Step 3: 压缩 — 对 P3-P5 应用 token 预算裁剪
-     *
-     * P1（系统提示词）和 P6（用户消息）不压缩
-     * P2（工具定义）按需懒加载，这里不处理
-     */
-    compress(sorted: ContextSource[], budget: TokenBudgetAllocation): {
-        compressed: ContextSource[];
-        dropped: Array<{
-            type: string;
-            id: string;
-            reason: string;
-        }>;
-    };
-    /**
-     * Step 4: 预算 — 按 TokenBudgetAllocation 分配各段
-     */
-    applyBudget(compressed: ContextSource[], budget: TokenBudgetAllocation): ContextSource[];
-    /**
-     * Step 5: 组装 — 拼装最终 prompt
-     *
-     * P1 开头 + P6 结尾，中间 P2-P5
-     */
-    assemble(budgeted: ContextSource[]): string;
-    /**
-     * 构建上下文使用快照
-     */
-    private buildSnapshot;
-}
-export {};
-//# sourceMappingURL=token-pipeline.d.ts.map

package/dist/context/token-pipeline.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"token-pipeline.d.ts","sourceRoot":"","sources":["../../src/context/token-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,cAAc,EAEf,MAAM,SAAS,CAAC;AAEjB,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,qBAAa,aAAa;IACxB;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc;IAwBzC;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,cAAc,EAAE;IAcnD;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,aAAa,EAAE;IAU/C;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,qBAAqB,GAAG;QAChE,UAAU,EAAE,aAAa,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC9D;IAkED;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,qBAAqB,GAAG,aAAa,EAAE;IAqBxF;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM;IAgC3C;;OAEG;IACH,OAAO,CAAC,aAAa;CA8CtB"}