soloforge 1.1.38 → 1.1.40

package/dist/engine/config/detector/blueprint.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Blueprint 解析 — 从自然语言描述推断框架/技术栈。
+ *
+ * 从 zero_config_init.ts 提取 parseBlueprint() 函数，
+ * 支持从自然语言描述中识别技术栈关键词。
+ */
+/** Blueprint 解析结果 */
+export interface BlueprintResult {
+    /** 匹配的后端框架 */
+    backend: {
+        lang: string;
+        framework: string;
+    } | null;
+    /** 匹配的前端框架 */
+    frontend: {
+        lang: string;
+        framework: string;
+    } | null;
+}
+/**
+ * 从自然语言描述推断技术栈。
+ * 用于 `soloforge init --blueprint "..."` 场景。
+ */
+export declare function parseBlueprint(description: string): BlueprintResult;
+//# sourceMappingURL=blueprint.d.ts.map

package/dist/engine/config/detector/blueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../../../../src/engine/config/detector/blueprint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmCH,qBAAqB;AACrB,MAAM,WAAW,eAAe;IAC9B,cAAc;IACd,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpD,cAAc;IACd,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAenE"}

package/dist/engine/config/detector/blueprint.js

@@ -0,0 +1,47 @@
+/**
+ * Blueprint 解析 — 从自然语言描述推断框架/技术栈。
+ *
+ * 从 zero_config_init.ts 提取 parseBlueprint() 函数，
+ * 支持从自然语言描述中识别技术栈关键词。
+ */
+// ── Blueprint 关键词映射 ──
+const BLUEPRINT_PATTERNS = [
+    // 后端
+    { pattern: /spring\s*boot/i, lang: "java", framework: "spring-boot", layer: "backend" },
+    { pattern: /quarkus/i, lang: "java", framework: "quarkus", layer: "backend" },
+    { pattern: /gradle/i, lang: "java", framework: "gradle-java", layer: "backend" },
+    { pattern: /\bgo\b|golang/i, lang: "go", framework: "go", layer: "backend" },
+    { pattern: /rust|cargo/i, lang: "rust", framework: "rust", layer: "backend" },
+    { pattern: /nestjs|nest\.?js/i, lang: "typescript", framework: "nestjs", layer: "backend" },
+    { pattern: /express/i, lang: "typescript", framework: "express", layer: "backend" },
+    { pattern: /django/i, lang: "python", framework: "django", layer: "backend" },
+    // 前端
+    { pattern: /react/i, lang: "typescript", framework: "react", layer: "frontend" },
+    { pattern: /next\.?js|nextjs/i, lang: "typescript", framework: "next", layer: "frontend" },
+    { pattern: /vue/i, lang: "typescript", framework: "vue", layer: "frontend" },
+    { pattern: /nuxt/i, lang: "typescript", framework: "nuxt", layer: "frontend" },
+    { pattern: /angular/i, lang: "typescript", framework: "angular", layer: "frontend" },
+    { pattern: /svelte/i, lang: "typescript", framework: "svelte", layer: "frontend" },
+    { pattern: /solid\s*js|solidjs/i, lang: "typescript", framework: "solid", layer: "frontend" },
+    { pattern: /astro/i, lang: "typescript", framework: "astro", layer: "frontend" },
+];
+/**
+ * 从自然语言描述推断技术栈。
+ * 用于 `soloforge init --blueprint "..."` 场景。
+ */
+export function parseBlueprint(description) {
+    let backend = null;
+    let frontend = null;
+    for (const bp of BLUEPRINT_PATTERNS) {
+        if (!bp.pattern.test(description))
+            continue;
+        if (bp.layer === "backend" && !backend) {
+            backend = { lang: bp.lang, framework: bp.framework };
+        }
+        else if (bp.layer === "frontend" && !frontend) {
+            frontend = { lang: bp.lang, framework: bp.framework };
+        }
+    }
+    return { backend, frontend };
+}
+//# sourceMappingURL=blueprint.js.map

package/dist/engine/config/detector/blueprint.js.map

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

package/dist/engine/config/detector/fingerprint.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 核心探测 — detectFingerprint() 实现。
+ *
+ * 关键设计决策（设计文档 §5.3）：
+ * 1. 后端先检测，前端排除已被后端使用的标记文件 → 解决 NestJS 误判
+ * 2. 使用 framework_map 的 detect 函数做内容验证 → 精确框架识别
+ * 3. 版本号从实际文件内容解析 → 实时准确
+ * 4. wrapper 检测影响构建命令选择
+ */
+/** 检测到的框架信息 */
+export interface DetectedFramework {
+    /** 编程语言 */
+    lang: string;
+    /** 框架名称 */
+    framework: string;
+    /** 框架版本 */
+    version: string;
+    /** 检测来源文件 */
+    detected_from: string;
+}
+/** 项目指纹 */
+export interface Fingerprint {
+    /** 项目根路径 */
+    project_root: string;
+    /** 后端框架检测结果 */
+    backend: DetectedFramework | null;
+    /** 前端框架检测结果 */
+    frontend: DetectedFramework | null;
+    /** 包管理器列表 */
+    package_managers: string[];
+    /** package.json scripts */
+    pkg_scripts: Record<string, string>;
+    /** workspace 信息（monorepo 检测） */
+    workspace: WorkspaceInfo | null;
+    /** 项目目录列表 */
+    directories: string[];
+    /** 检测警告 */
+    warnings: string[];
+}
+/** Workspace 信息 */
+export interface WorkspaceInfo {
+    /** workspace 类型 */
+    type: "pnpm" | "nx" | "turbo" | "lerna" | "yarn" | "npm";
+    /** 子包列表 */
+    packages: WorkspacePackage[];
+}
+/** Workspace 子包 */
+export interface WorkspacePackage {
+    /** 子包名称 */
+    name: string;
+    /** 相对路径 */
+    path: string;
+    /** 分类 */
+    layer: "backend" | "frontend" | "shared";
+}
+/**
+ * 探测项目指纹 — 纯确定性，无 LLM 参与。
+ *
+ * 执行顺序：
+ * 1. 读取 package.json（缓存，避免重复读取）
+ * 2. 后端探测（遍历 backend profiles）
+ * 3. 记录后端已使用的标记文件
+ * 4. 前端探测（排除后端已使用的标记）
+ * 5. 包管理器 / scripts / workspace 检测
+ */
+export declare function detectFingerprint(projectRoot: string): Promise<Fingerprint>;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/engine/config/detector/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../../../src/engine/config/detector/fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAeH,eAAe;AACf,MAAM,WAAW,iBAAiB;IAChC,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,WAAW;AACX,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC,eAAe;IACf,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,aAAa;IACb,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,gCAAgC;IAChC,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,aAAa;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW;IACX,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,mBAAmB;AACnB,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IACzD,WAAW;IACX,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,mBAAmB;AACnB,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS;IACT,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;CAC1C;AAID;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAgDjF"}

package/dist/engine/config/detector/fingerprint.js

@@ -0,0 +1,160 @@
+/**
+ * 核心探测 — detectFingerprint() 实现。
+ *
+ * 关键设计决策（设计文档 §5.3）：
+ * 1. 后端先检测，前端排除已被后端使用的标记文件 → 解决 NestJS 误判
+ * 2. 使用 framework_map 的 detect 函数做内容验证 → 精确框架识别
+ * 3. 版本号从实际文件内容解析 → 实时准确
+ * 4. wrapper 检测影响构建命令选择
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { debug } from "../../core/logger.js";
+import { safeJsonParse } from "../../core/helpers.js";
+import { getBackendProfiles, getFrontendProfiles, detectProfile, } from "./framework_map.js";
+// ── 核心探测函数 ──
+/**
+ * 探测项目指纹 — 纯确定性，无 LLM 参与。
+ *
+ * 执行顺序：
+ * 1. 读取 package.json（缓存，避免重复读取）
+ * 2. 后端探测（遍历 backend profiles）
+ * 3. 记录后端已使用的标记文件
+ * 4. 前端探测（排除后端已使用的标记）
+ * 5. 包管理器 / scripts / workspace 检测
+ */
+export async function detectFingerprint(projectRoot) {
+    debug("探测", "开始探测项目指纹", projectRoot);
+    const warnings = [];
+    // 1. 读取 package.json
+    const pkgJson = readPackageJson(projectRoot);
+    // 2. 目录扫描
+    const directories = scanDirectories(projectRoot);
+    // 3. 后端探测
+    const backendResult = detectBackend(projectRoot, pkgJson);
+    // 4. 记录后端已使用的标记文件
+    const usedMarkers = new Set();
+    if (backendResult) {
+        // 如果后端使用了 package.json，前端不应再因 package.json 被误判
+        usedMarkers.add(backendResult.detected_from);
+    }
+    // 5. 前端探测 — 排除逻辑
+    const frontendResult = detectFrontend(projectRoot, pkgJson, backendResult);
+    // 6. 包管理器检测
+    const packageManagers = detectPackageManagers(projectRoot, pkgJson);
+    // 7. package.json 中的脚本命令
+    const pkgScripts = pkgJson?.scripts && typeof pkgJson.scripts === "object"
+        ? pkgJson.scripts
+        : {};
+    // 8. workspace 检测
+    const workspace = detectWorkspace(projectRoot, pkgJson);
+    if (!backendResult && !frontendResult) {
+        warnings.push("未检测到后端或前端框架 — 配置将使用默认值");
+    }
+    return {
+        project_root: projectRoot,
+        backend: backendResult,
+        frontend: frontendResult,
+        package_managers: packageManagers,
+        pkg_scripts: pkgScripts,
+        workspace,
+        directories,
+        warnings,
+    };
+}
+// ── 后端探测 ──
+function detectBackend(projectRoot, pkgJson) {
+    const profiles = getBackendProfiles();
+    for (const profile of profiles) {
+        const result = detectProfile(profile, projectRoot, pkgJson);
+        if (result) {
+            debug("探测", `后端检测到: ${result.framework} (${result.detected_from})`);
+            return result;
+        }
+    }
+    return null;
+}
+// ── 前端探测 — 关键：排除已被后端使用的标记 ──
+function detectFrontend(projectRoot, pkgJson, _backend) {
+    const profiles = getFrontendProfiles();
+    // 关键修正：后端是 Node.js 框架（nestjs/express）时，
+    // 前端不应因为 package.json 的存在而误判
+    // → 前端框架需要明确的依赖声明（react/vue/angular 等）
+    //   而非仅凭 package.json 存在就识别
+    for (const profile of profiles) {
+        const result = detectProfile(profile, projectRoot, pkgJson);
+        if (result) {
+            debug("探测", `前端检测到: ${result.framework} (${result.detected_from})`);
+            return result;
+        }
+    }
+    return null;
+}
+// ── 包管理器检测 ──
+function detectPackageManagers(projectRoot, pkgJson) {
+    const managers = [];
+    if (pkgJson)
+        managers.push("npm");
+    if (fs.existsSync(path.join(projectRoot, "pnpm-lock.yaml")))
+        managers.push("pnpm");
+    if (fs.existsSync(path.join(projectRoot, "yarn.lock")))
+        managers.push("yarn");
+    if (fs.existsSync(path.join(projectRoot, "go.sum")) || fs.existsSync(path.join(projectRoot, "go.mod")))
+        managers.push("go-modules");
+    return managers;
+}
+// ── 目录扫描 ──
+function scanDirectories(projectRoot) {
+    const dirs = [];
+    try {
+        const entries = fs.readdirSync(projectRoot, { withFileTypes: true });
+        for (const e of entries) {
+            if (e.isDirectory() && !e.name.startsWith(".")) {
+                dirs.push(e.name);
+            }
+        }
+    }
+    catch {
+        debug("探测", "读取项目根目录失败");
+    }
+    return dirs;
+}
+// ── package.json 读取 ──
+function readPackageJson(projectRoot) {
+    const pkgPath = path.join(projectRoot, "package.json");
+    try {
+        const content = fs.readFileSync(pkgPath, "utf-8");
+        return safeJsonParse(content) ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+// ── Workspace 检测 ──
+function detectWorkspace(projectRoot, pkgJson) {
+    // pnpm workspace 配置检测
+    if (fs.existsSync(path.join(projectRoot, "pnpm-workspace.yaml"))) {
+        return { type: "pnpm", packages: [] };
+    }
+    // nx
+    if (fs.existsSync(path.join(projectRoot, "nx.json"))) {
+        return { type: "nx", packages: [] };
+    }
+    // turbo
+    if (fs.existsSync(path.join(projectRoot, "turbo.json"))) {
+        return { type: "turbo", packages: [] };
+    }
+    // lerna
+    if (fs.existsSync(path.join(projectRoot, "lerna.json"))) {
+        return { type: "lerna", packages: [] };
+    }
+    // yarn/npm workspaces（在 package.json 中声明）
+    if (pkgJson) {
+        const workspaces = pkgJson.workspaces;
+        if (workspaces && typeof workspaces === "object") {
+            return { type: "yarn", packages: [] };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/engine/config/detector/fingerprint.js.map

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

package/dist/engine/config/detector/framework_map.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 框架知识表 — 16 个框架的探测 profile。
+ *
+ * 每个 profile 包含：
+ * - markers: 文件标记（含内容验证）
+ * - defaultScope: 框架约定的目录结构
+ * - defaultBuildCommands: 默认构建命令
+ * - wrapperCheck: wrapper 脚本检测
+ * - layer: backend | frontend 分类
+ *
+ * 关键设计决策（设计文档 §5.3）：
+ * 1. 精确框架识别 — detect 函数检查文件内容，非仅文件存在
+ * 2. 后端先检测 + 前端排除已用标记 — 解决 NestJS 误判
+ * 3. 版本号实时解析 — 从实际文件内容提取
+ * 4. wrapper 检测 — mvnw/gradlew 存在性影响构建命令
+ */
+/** 框架标记文件 */
+export interface FrameworkMarker {
+    /** 相对项目根目录的文件路径 */
+    file: string;
+    /**
+     * 内容验证函数 — 返回 true 表示该文件确实表明使用了此框架。
+     * 不仅检查文件存在，还验证内容中的框架特征。
+     */
+    detect: (content: string, pkgJson?: PkgJsonData) => boolean;
+    /** 从文件内容中提取版本号 */
+    extractVersion: (content: string, pkgJson?: PkgJsonData) => string;
+}
+/** 框架 Profile */
+export interface FrameworkProfile {
+    /** 框架标识名 */
+    name: string;
+    /** 编程语言 */
+    lang: string;
+    /** 层级：backend 或 frontend */
+    layer: "backend" | "frontend";
+    /** 检测标记列表（任一匹配即识别） */
+    markers: FrameworkMarker[];
+    /** 默认作用域目录 */
+    defaultScope: string[];
+    /** 默认构建命令（无 wrapper） */
+    defaultBuildCommands: {
+        build: string;
+        test: string;
+        full: string;
+    };
+    /** wrapper 脚本文件名（如 "mvnw"） */
+    wrapperFile?: string;
+    /** wrapper 存在时的构建命令前缀 */
+    wrapperPrefix?: string;
+}
+/** package.json 简化类型 — 仅用于依赖检查 */
+export interface PkgJsonData {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    scripts?: Record<string, string>;
+}
+/** 从 package.json 合并所有依赖 */
+export declare function getAllDeps(pkg?: PkgJsonData | null): Record<string, string>;
+/** 从依赖版本字符串中提取主版本号 */
+export declare function extractMajorVersion(versionStr?: string, fallback?: string): string;
+/** 安全读取文件内容 */
+export declare function readFileContent(filePath: string): string | null;
+export declare const FRAMEWORK_PROFILES: FrameworkProfile[];
+/** 按层级获取 profile */
+export declare function getBackendProfiles(): FrameworkProfile[];
+export declare function getFrontendProfiles(): FrameworkProfile[];
+/** 按名称查找 profile */
+export declare function getProfileByName(name: string): FrameworkProfile | undefined;
+/**
+ * 对单个 profile 执行探测 — 检查标记文件是否存在且内容匹配。
+ * 返回匹配的标记信息，无匹配返回 null。
+ */
+export declare function detectProfile(profile: FrameworkProfile, projectRoot: string, pkgJson?: PkgJsonData | null): {
+    framework: string;
+    lang: string;
+    version: string;
+    detected_from: string;
+} | null;
+/**
+ * 获取框架的构建命令 — 考虑 wrapper 检测。
+ * 如果 wrapper 文件存在，使用 wrapperPrefix 替代默认命令前缀。
+ */
+export declare function resolveBuildCommands(profile: FrameworkProfile, projectRoot: string): {
+    build: string;
+    test: string;
+    full: string;
+};
+//# sourceMappingURL=framework_map.d.ts.map

package/dist/engine/config/detector/framework_map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework_map.d.ts","sourceRoot":"","sources":["../../../../src/engine/config/detector/framework_map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,aAAa;AACb,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;IAC5D,kBAAkB;IAClB,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,MAAM,CAAC;CACpE;AAED,iBAAiB;AACjB,MAAM,WAAW,gBAAgB;IAC/B,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,KAAK,EAAE,SAAS,GAAG,UAAU,CAAC;IAC9B,sBAAsB;IACtB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,cAAc;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wBAAwB;IACxB,oBAAoB,EAAE;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAID,4BAA4B;AAC5B,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAG3E;AAED,sBAAsB;AACtB,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,CAI/E;AAED,eAAe;AACf,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM/D;AAID,eAAO,MAAM,kBAAkB,EAAE,gBAAgB,EA0ThD,CAAC;AAEF,oBAAoB;AACpB,wBAAgB,kBAAkB,IAAI,gBAAgB,EAAE,CAEvD;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,EAAE,CAExD;AAED,oBAAoB;AACpB,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE3E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,gBAAgB,EACzB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,GAC3B;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA6BpF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,WAAW,EAAE,MAAM,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAkB/C"}