soloforge 1.1.33 → 1.1.34

package/dist/engine/contracts/artifact_process_rules.js

@@ -0,0 +1,396 @@
+/**
+ * 产物过程规则 — 为每种产物类型定义按操作类型区分的执行规则。
+ *
+ * 四种操作类型：
+ * - extract  — 首次提取/生成（从源材料创建产物）
+ * - review   — 审查/分析（对比源材料与产物，标记偏差）
+ * - fix      — 修复（修正偏差项，保持正确内容不变）
+ * - iterate  — 迭代（增量修改，保持结构）
+ *
+ * 设计决策：
+ * - ProcessRules 是"护栏"（按场景选择），不是"契约"（强制）
+ * - 与 Schema 解耦：Schema 定义"是什么"，ProcessRules 定义"怎么做"
+ * - 按 OperationType 选择规则，注入到 prompt 中指导 AI 行为
+ */
+// ── 通用规则模板 ──
+/** 通用提取规则 — 适用于大多数产物类型 */
+function genericExtractRules(sourceName) {
+    return {
+        instructions: [
+            `从${sourceName}中提取信息，按 Schema 定义的章节结构组织输出`,
+            "每个章节必须有实质性内容，不得留空或使用占位符",
+            "表格数据必须与源材料对应，不得编造",
+        ],
+        constraints: [
+            "不得删除 Schema 要求的任何章节",
+            "所有数据必须有源材料依据",
+        ],
+        input_materials: [sourceName],
+    };
+}
+/** 通用审查规则 */
+function genericReviewRules(sourceName) {
+    return {
+        instructions: [
+            `逐章节与${sourceName}对比，标记偏差项（❌）和遗漏项（⚠️）`,
+            "偏差判定依据：章节缺失、数据不一致、流程不符",
+            "输出必须保持 Schema 定义的章节结构，仅标注问题",
+        ],
+        constraints: [
+            "不得删除 Schema 要求的任何章节",
+            "审查时不得修改正确内容",
+            "每个偏差项必须给出具体位置和原因",
+        ],
+        input_materials: [sourceName, "当前产物文档"],
+    };
+}
+/** 通用修复规则 */
+function genericFixRules(sourceName) {
+    return {
+        instructions: [
+            "仅修改已标注的偏差项，保持已正确内容不变",
+            "修复后每个章节必须与源材料内容对应",
+            "修复处标记 [已修复] 便于追踪",
+        ],
+        constraints: [
+            "不得删除 Schema 要求的任何章节",
+            "不得引入与源材料无关的新内容",
+            "已正确的章节不得被修改",
+        ],
+        input_materials: [sourceName, "偏差项清单", "当前产物文档"],
+    };
+}
+/** 通用迭代规则 */
+function genericIterateRules() {
+    return {
+        instructions: [
+            "在现有产物基础上增量修改",
+            "保持 Schema 定义的章节结构不变",
+            "新增或修改的内容必须标注变更原因",
+        ],
+        constraints: [
+            "不得删除 Schema 要求的任何章节",
+            "变更后的内容必须保持一致性",
+        ],
+        input_materials: ["当前产物文档", "变更需求"],
+    };
+}
+// ── 过程规则注册表 ──
+const PROCESS_RULES = new Map();
+/** 注册过程规则（内部函数） */
+function registerRules(kind, extract, review, fix, iterate) {
+    PROCESS_RULES.set(kind, { kind, extract, review, fix, iterate });
+}
+// ── P0 产物类型的定制规则 ──
+registerRules("prototype_spec", {
+    instructions: [
+        "从原型源码包（Figma Make 导出）中提取页面结构、设计令牌、交互逻辑",
+        "按 Schema 定义的 10 个章节组织输出",
+        "设计令牌（色彩/间距/字体）必须从源码 CSS 变量中提取",
+        "组件数据绑定必须映射到源码中的实际字段名",
+        "交互流转必须反映源码中的事件处理器逻辑",
+    ],
+    constraints: [
+        "只能从源码包提取，不得凭空编造",
+        "每个组件必须有源码文件对应",
+        "色彩值必须为实际 hex/hsl 值，不得用'主色'等模糊描述",
+    ],
+    input_materials: ["原型源码包（Figma Make 导出）"],
+}, {
+    instructions: [
+        "逐章节与原型源码包对比，标记偏差项（❌）和遗漏项（⚠️）",
+        "偏差判定依据：章节缺失、表格数据与源码不一致、交互流程与源码行为不符",
+        "输出必须保持 Schema 定义的 10 个章节结构，仅标注问题",
+    ],
+    constraints: [
+        "不得删除 Schema 要求的任何章节",
+        "审查时不得修改正确内容",
+        "每个偏差项必须指出具体位置和源码参照",
+    ],
+    input_materials: ["原型源码包", "当前原型说明文档"],
+}, {
+    instructions: [
+        "仅修改已标注的偏差项，保持已正确内容不变",
+        "修复后每个章节必须与源码包内容对应",
+        "修复处标记 [已修复] 便于追踪",
+    ],
+    constraints: [
+        "不得删除 Schema 要求的任何章节",
+        "不得引入源码包中不存在的内容",
+    ],
+    input_materials: ["原型源码包", "偏差项清单", "当前原型说明文档"],
+}, {
+    instructions: [
+        "在现有原型说明基础上增量修改",
+        "保持 Schema 定义的 10 个章节结构",
+        "新增或修改的内容必须标注变更原因",
+    ],
+    constraints: [
+        "不得删除 Schema 要求的任何章节",
+        "变更后的内容必须与最新源码保持一致",
+    ],
+    input_materials: ["当前原型说明文档", "变更需求"],
+});
+registerRules("design_doc", {
+    instructions: [
+        "从架构决策记录和需求文档中提取信息，按 Schema 定义的 12 个章节组织",
+        "架构决策状态总表必须包含所有已确认决策",
+        "技术选型表必须列出候选方案和选择理由",
+        "Mermaid 图必须反映实际的模块关系和数据流向",
+    ],
+    constraints: [
+        "所有架构决策必须有决策记录引用",
+        "技术选型必须有对比依据",
+        "模块划分不得遗漏需求中的功能点",
+    ],
+    input_materials: ["决策记录", "需求文档", "架构决策研讨闭合确认"],
+}, {
+    instructions: [
+        "逐章节与决策记录和需求对比，标记偏差项和遗漏项",
+        "重点检查：架构决策是否全部落实、技术选型是否与实际一致",
+        "Mermaid 图是否与文字描述一致",
+    ],
+    constraints: [
+        "不得删除 Schema 要求的任何章节",
+        "每个偏差项必须指出与哪个决策/需求矛盾",
+    ],
+    input_materials: ["决策记录", "需求文档", "当前架构设计文档"],
+}, genericFixRules("决策记录"), genericIterateRules());
+registerRules("api_spec", {
+    instructions: [
+        "从后端架构决策和需求文档中提取 API 接口信息",
+        "每个 Endpoint 必须包含完整的请求/响应字段表",
+        "字段表必须包含 Schema 要求的所有列（类型、必填、格式、映射等）",
+        "错误码必须覆盖所有业务异常场景",
+    ],
+    constraints: [
+        "每个 Endpoint 必须有验收场景",
+        "字段类型必须与后端实际 DTO 一致",
+        "OpenAPI 文件必须同步生成",
+    ],
+    input_materials: ["后端架构决策", "需求文档", "OpenAPI 规范"],
+}, {
+    instructions: [
+        "逐 Endpoint 与后端实现对比，标记偏差项",
+        "重点检查：字段是否遗漏、类型是否一致、错误码是否完整",
+        "页面交互映射是否与前端实际调用一致",
+    ],
+    constraints: [
+        "不得删除 Schema 要求的任何章节",
+        "每个偏差项必须指出与哪个接口/字段矛盾",
+    ],
+    input_materials: ["后端架构决策", "OpenAPI 规范", "当前 API 接口规格文档"],
+}, genericFixRules("后端架构决策"), genericIterateRules());
+registerRules("verification_report", {
+    instructions: [
+        "收集所有设计产物的 Hash 和验证结果",
+        "跨产物追踪矩阵必须覆盖所有引用关系",
+        "Implementation Readiness 结论必须基于证据",
+    ],
+    constraints: [
+        "每个产物的 Hash 必须可验证",
+        "冲突清单不得遗漏已知冲突",
+    ],
+    input_materials: ["架构设计文档", "数据库设计文档", "API 接口规格", "OpenAPI", "SQL/migration"],
+}, {
+    instructions: [
+        "验证设计产物是否与当前代码一致",
+        "跨产物追踪矩阵是否完整",
+        "残余风险是否已被评估",
+    ],
+    constraints: [
+        "验证结论必须有证据支撑",
+        "不得跳过任何产物类型",
+    ],
+    input_materials: ["所有设计产物", "当前代码实现"],
+}, genericFixRules("设计产物"), genericIterateRules());
+// ── P1 产物类型的规则 ──
+registerRules("detailed_design", genericExtractRules("架构设计文档和需求"), genericReviewRules("架构设计文档"), genericFixRules("架构设计文档"), genericIterateRules());
+registerRules("api_design", {
+    instructions: [
+        "从第三方服务文档中提取接口信息",
+        "数据映射表必须覆盖所有字段转换",
+        "容错策略必须包含超时、重试、降级方案",
+    ],
+    constraints: [
+        "接口清单必须完整",
+        "错误码映射必须双向覆盖",
+    ],
+    input_materials: ["第三方服务文档", "后端架构设计"],
+}, genericReviewRules("第三方服务文档"), genericFixRules("第三方服务文档"), genericIterateRules());
+registerRules("requirement_analysis", {
+    instructions: [
+        "从需求来源中提取功能点，按 Schema 定义的章节组织",
+        "功能点清单必须包含验收标准",
+        "写操作失败反馈必须覆盖所有用户可触发的失败场景",
+        "冲突与越界项必须标注处理方式",
+    ],
+    constraints: [
+        "每个功能点必须有明确的验收标准",
+        "未确认项必须标注阻塞程度",
+    ],
+    input_materials: ["需求来源文档", "原型材料"],
+}, genericReviewRules("需求来源"), genericFixRules("需求来源"), genericIterateRules());
+registerRules("test_plan", genericExtractRules("需求文档和功能点清单"), genericReviewRules("需求文档"), genericFixRules("需求文档"), genericIterateRules());
+registerRules("task_breakdown", {
+    instructions: [
+        "根据架构设计和需求文档拆分开发切片",
+        "每个切片必须可独立验证",
+        "执行顺序必须考虑依赖关系",
+    ],
+    constraints: [
+        "切片粒度不宜过大（单切片不超过 3 天工作量）",
+        "缓冲安排必须标注",
+    ],
+    input_materials: ["架构设计文档", "需求文档"],
+}, genericReviewRules("架构设计文档"), genericFixRules("架构设计文档"), genericIterateRules());
+registerRules("task_plan", {
+    instructions: [
+        "根据切片计划安排执行时间线",
+        "标注里程碑和关键路径",
+        "预留缓冲时间",
+    ],
+    constraints: [
+        "时间线必须与切片依赖关系一致",
+    ],
+    input_materials: ["切片计划", "资源信息"],
+}, genericReviewRules("切片计划"), genericFixRules("切片计划"), genericIterateRules());
+registerRules("root_cause", {
+    instructions: [
+        "按时间线复现问题，记录复现步骤",
+        "使用假设-验证法逐步排除",
+        "根因分析必须定位到代码级原因",
+        "修复方案必须包含预防措施",
+    ],
+    constraints: [
+        "每个假设必须有验证结果",
+        "根因不得使用模糊描述（如'系统不稳定'）",
+    ],
+    input_materials: ["报错日志", "相关代码", "复现环境"],
+}, genericReviewRules("报错日志"), genericFixRules("报错日志"), genericIterateRules());
+registerRules("incident_review", {
+    instructions: [
+        "按时间线记录故障全过程",
+        "根因分析必须定位到代码/配置/流程层面",
+        "后续改进项必须指定责任人和计划时间",
+    ],
+    constraints: [
+        "时间线不得有空白时段",
+        "监控盲区必须标注改进方案",
+    ],
+    input_materials: ["故障日志", "监控数据", "处理记录"],
+}, genericReviewRules("故障日志"), genericFixRules("故障日志"), genericIterateRules());
+registerRules("review_report", {
+    instructions: [
+        "按维度（功能、性能、安全、可维护性）逐项审查",
+        "发现项必须标注严重程度和具体文件位置",
+        "审查清单必须全部校验",
+    ],
+    constraints: [
+        "每个发现项必须有具体建议",
+        "严重程度不得降级",
+    ],
+    input_materials: ["待审查代码", "需求文档", "架构设计文档"],
+}, genericReviewRules("待审查代码"), genericFixRules("待审查代码"), genericIterateRules());
+registerRules("tech_decision_record", {
+    instructions: [
+        "记录决策背景、候选选项和选择理由",
+        "结论必须明确，不得模棱两可",
+        "原因必须包含定量依据",
+    ],
+    constraints: [
+        "每个选项必须有优劣分析",
+        "结论不得与已有决策矛盾",
+    ],
+    input_materials: ["技术调研资料", "项目约束"],
+}, genericReviewRules("技术调研资料"), genericFixRules("技术调研资料"), genericIterateRules());
+registerRules("migration_plan", {
+    instructions: [
+        "评估迁移范围和兼容性影响",
+        "迁移阶段必须包含回滚方案",
+        "风险评估必须覆盖数据丢失和业务中断",
+    ],
+    constraints: [
+        "每个迁移阶段必须有回滚方案",
+        "兼容性分析必须覆盖前后端",
+    ],
+    input_materials: ["当前系统文档", "目标系统文档"],
+}, genericReviewRules("系统文档"), genericFixRules("系统文档"), genericIterateRules());
+// ── P2 产物类型的规则 ──
+registerRules("acceptance_checklist", genericExtractRules("验收标准"), {
+    instructions: [
+        "逐项检查验收标准是否满足",
+        "每项必须给出通过/不通过结论",
+    ],
+    constraints: [
+        "不得跳过任何验收项",
+    ],
+    input_materials: ["验收标准", "当前实现"],
+}, genericFixRules("验收标准"), genericIterateRules());
+registerRules("interaction_spec", {
+    instructions: [
+        "从原型源码包中提取交互逻辑",
+        "交互流转必须反映完整的状态机",
+        "动效规范必须包含时长和缓动函数",
+    ],
+    constraints: [
+        "交互流转不得遗漏异常分支",
+        "响应式断点必须覆盖主流设备",
+    ],
+    input_materials: ["原型源码包"],
+}, genericReviewRules("原型源码包"), genericFixRules("原型源码包"), genericIterateRules());
+registerRules("domain_model", {
+    instructions: [
+        "识别核心业务对象及其职责",
+        "按 SOLID 原则验证对象划分合理性",
+        "接口与依赖方向必须符合 DIP",
+    ],
+    constraints: [
+        "每个对象必须有单一职责",
+        "变化点分析必须覆盖已知扩展需求",
+    ],
+    input_materials: ["需求文档", "架构设计文档"],
+}, genericReviewRules("架构设计文档"), genericFixRules("架构设计文档"), genericIterateRules());
+// ── 查询函数 ──
+/**
+ * 获取指定产物类型的过程规则。
+ */
+export function getProcessRules(kind) {
+    return PROCESS_RULES.get(kind);
+}
+/**
+ * 获取指定产物类型在特定操作类型下的规则。
+ */
+export function getOperationRules(kind, operationType) {
+    const ruleSet = PROCESS_RULES.get(kind);
+    if (!ruleSet)
+        return undefined;
+    return ruleSet[operationType];
+}
+/**
+ * 将过程规则格式化为可注入 prompt 的文本。
+ */
+export function formatProcessRulesForPrompt(ruleSet, operationType) {
+    const rules = ruleSet[operationType];
+    if (!rules)
+        return "";
+    const lines = [];
+    lines.push(`## 执行规则（${ruleSet.kind} / ${operationType}）`);
+    if (rules.instructions.length > 0) {
+        lines.push("执行指令：");
+        for (const inst of rules.instructions) {
+            lines.push(`- ${inst}`);
+        }
+    }
+    if (rules.constraints.length > 0) {
+        lines.push("约束：");
+        for (const c of rules.constraints) {
+            lines.push(`- ${c}`);
+        }
+    }
+    if (rules.input_materials.length > 0) {
+        lines.push(`参考材料：${rules.input_materials.join("、")}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=artifact_process_rules.js.map

package/dist/engine/contracts/artifact_process_rules.js.map

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

package/dist/engine/contracts/artifact_schema_registry.d.ts

@@ -0,0 +1,137 @@
+/**
+ * 产物 Schema 注册中心 — 集中管理所有 19 种产物类型的结构定义。
+ *
+ * 职责：
+ * 1. 定义 ArtifactSchema 接口（必填章节、表格、字段、附属产物）
+ * 2. 注册所有 19 种 ArtifactKind 的完整 schema
+ * 3. 提供按 kind 查询、格式化为 prompt 注入文本的能力
+ *
+ * 设计决策：
+ * - Schema 是结构契约（强制），与模板正文（参考范例）解耦
+ * - Section 名称取自模板 ## 标题的关键文本，匹配时容许编号前缀
+ * - P0 契约（standard_asset_contract.ts）中不完整的 sections 已从此处补齐
+ */
+import type { ArtifactKind } from "./artifact_contract_registry.js";
+/** 产物结构 Schema — 定义输出文档必须满足的结构约束 */
+export interface ArtifactSchema {
+    /** 产物类型 */
+    kind: ArtifactKind;
+    /** 必填章节标题（关键文本，用于 markdown heading 匹配） */
+    required_sections: string[];
+    /** 必填表格关键词（用于 markdown table 匹配） */
+    required_tables: string[];
+    /** 表格内必填列名（tableName → columnName[]） */
+    required_fields?: Record<string, string[]>;
+    /** 必填附属产物（文件路径模式或关键词描述） */
+    required_artifacts?: string[];
+    /** 禁止出现的空白/占位标记 */
+    forbidden_gaps?: string[];
+    /** 对应的模板文件名（在 templates/artifacts/shared/ 目录下） */
+    template_file?: string;
+}
+/**
+ * 获取指定产物类型的 Schema。
+ * @returns Schema 或 undefined（未知类型）
+ */
+export declare function getArtifactSchema(kind: ArtifactKind): ArtifactSchema | undefined;
+/**
+ * 检查指定产物类型是否有已注册的 Schema。
+ */
+export declare function hasArtifactSchema(kind: string): boolean;
+/**
+ * 获取所有已注册的 Schema（不含 custom 和 knowledge_rule）。
+ */
+export declare function getAllArtifactSchemas(): ArtifactSchema[];
+/**
+ * 获取所有已注册 Schema 的 kind 列表。
+ */
+export declare function getRegisteredSchemaKinds(): ArtifactKind[];
+/**
+ * 获取有实质结构约束的 Schema 列表（required_sections 或 required_tables 非空）。
+ */
+export declare function getStructuralSchemas(): ArtifactSchema[];
+/**
+ * 灵活的章节标题匹配 — 容许编号前缀（如 "1. "、"2.1 "）。
+ *
+ * 匹配规则：
+ * - `## 页面元数据` → 匹配 section "页面元数据"
+ * - `## 1. 页面元数据` → 匹配 section "页面元数据"
+ * - `### 2.1 色彩` → 匹配 section "色彩"
+ */
+export declare function matchSection(content: string, sectionName: string): boolean;
+/**
+ * 在内容中查找所有缺失的必填章节。
+ * @returns 缺失的章节名称列表
+ */
+export declare function findMissingSections(content: string, schema: ArtifactSchema): string[];
+/**
+ * 在内容中查找所有缺失的必填表格。
+ * @returns 缺失的表格名称列表
+ */
+export declare function findMissingTables(content: string, schema: ArtifactSchema): string[];
+/**
+ * 将 ArtifactSchema 格式化为可注入 prompt 的结构约束文本。
+ *
+ * 输出格式：
+ * ```
+ * ## 产物结构约束：prototype_spec
+ * 必填章节：页面元数据、设计令牌、页面布局树...
+ * 必填表格：色彩令牌表、间距与圆角表...
+ * 表格必填列：
+ *   色彩令牌表 → 令牌名、色值、用途
+ *   ...
+ * ```
+ */
+export declare function formatSchemaForPrompt(schema: ArtifactSchema): string;
+/** 空洞章节 — 标题存在但正文内容 < threshold 字符 */
+export interface HollowSection {
+    /** 章节名（与 schema.required_sections 中的名称一致） */
+    section_name: string;
+    /** 标题所在行号（1-based） */
+    line_number: number;
+    /** 章节正文（去除标题行和空行后） */
+    body_chars: number;
+}
+/** 占位符发现 */
+export interface PlaceholderFinding {
+    /** 占位符文本 */
+    placeholder: string;
+    /** 所在行号（1-based） */
+    line_number: number;
+    /** 上下文片段（前 80 字符） */
+    context: string;
+}
+/** 空表格发现 */
+export interface EmptyTableFinding {
+    /** 表格 header 关键词 */
+    table_keyword: string;
+    /** 表格起始行号（1-based） */
+    line_number: number;
+    /** 是否为必填表格 */
+    is_required: boolean;
+}
+/**
+ * 检测空洞章节 — 标题存在但正文内容不足阈值。
+ *
+ * 算法：
+ * 1. 按行提取所有 ## 级别的标题
+ * 2. 对每个标题，取其到下一个同级标题之间的正文
+ * 3. 正文预处理：去掉 markdown 格式标记、代码块行、表格行、空行
+ * 4. 用 matchSection() 与 schema.required_sections 匹配
+ * 5. 匹配成功的章节，正文长度 < threshold → 空洞
+ */
+export declare function findHollowSections(content: string, schema: ArtifactSchema, threshold?: number): HollowSection[];
+/**
+ * 检测占位符 — 正文中的"待补充"、"TODO"等空洞标记。
+ *
+ * 维护代码围栏状态机，跳过代码块内行，避免误报。
+ * 可追加自定义占位符模式。
+ */
+export declare function findPlaceholders(content: string, extraPatterns?: RegExp[]): PlaceholderFinding[];
+/**
+ * 检测空表格 — 表格有 header 和 separator 但无数据行。
+ *
+ * 与 schema.required_tables 做关键词匹配，必填表格空 → is_required=true。
+ */
+export declare function findEmptyTables(content: string, schema: ArtifactSchema): EmptyTableFinding[];
+//# sourceMappingURL=artifact_schema_registry.d.ts.map

package/dist/engine/contracts/artifact_schema_registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact_schema_registry.d.ts","sourceRoot":"","sources":["../../../src/engine/contracts/artifact_schema_registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIpE,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,0CAA0C;IAC1C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,oCAAoC;IACpC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,2BAA2B;IAC3B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,mBAAmB;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAqdD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,SAAS,CAEhF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,cAAc,EAAE,CAGxD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,YAAY,EAAE,CAEzD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,EAAE,CAGvD;AAID;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAK1E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAIrF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CASnF;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA8BpE;AAID,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,YAAY;AACZ,MAAM,WAAW,kBAAkB;IACjC,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,YAAY;AACZ,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,WAAW,EAAE,OAAO,CAAC;CACtB;AAYD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,EACtB,SAAS,GAAE,MAAW,GACrB,aAAa,EAAE,CAsEjB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,kBAAkB,EAAE,CAkCtB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,GACrB,iBAAiB,EAAE,CA8ErB"}