@xfe-repo/cli-plugin-ai-rules 2.0.0

package/dist/formats/mcp-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-json.d.ts","sourceRoot":"","sources":["../../src/formats/mcp-json.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAGtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AASjD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,WAAW,EAAE,CAkBxH;AAID,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU9F;AAID,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CA4CvI;AAID,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAElE"}

package/dist/formats/mcp-json.js

@@ -0,0 +1,132 @@
+/**
+ * MCP JSON 格式模块
+ *
+ * 处理 MCP 配置文件（.vscode/mcp.json、.cursor/mcp.json、.mcp.json）的同步写入：
+ * - 使用 `xfe:` 前缀隔离 xfe 管理的 server 条目与用户自定义条目
+ * - 写入时保留非 xfe 前缀的用户条目，仅覆盖 xfe 前缀条目
+ * - 不做冲突检测（前缀隔离已足够）
+ */
+import { existsSync } from 'node:fs';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { SyncItemType } from '../types.js';
+import { getTarget } from '../targets.js';
+import { computeHash } from './shared.js';
+// ─── Constants ──────
+const MCP_SERVER_PREFIX = 'xfe:';
+// ─── Plan ──────
+/**
+ * 将 MCP server 项按 target 转换为 PlannedFile
+ *
+ * 可选注入项合并到同一 JSON 文件
+ */
+export function planMcpJsonFiles(target, items, injections) {
+    if (!target.mcp)
+        return [];
+    const syncServers = buildServerEntries(items.filter((i) => i.type === SyncItemType.McpServer));
+    const injectionServers = injections ? buildServerEntries(collectMcpItems(injections)) : {};
+    const servers = { ...syncServers, ...injectionServers };
+    if (Object.keys(servers).length === 0)
+        return [];
+    return [
+        {
+            relativePath: target.mcp,
+            content: buildMcpJson(target, servers),
+            action: 'write',
+            source: Object.keys(syncServers).length > 0 ? 'sync' : 'injection',
+            format: 'mcp-json',
+        },
+    ];
+}
+// ─── Write ──────
+export async function writeMcpJsonFile(file, projectRoot) {
+    const absPath = path.join(projectRoot, file.relativePath);
+    await mkdir(path.dirname(absPath), { recursive: true });
+    const merged = await mergeWithExisting(absPath, file.content);
+    await writeFile(absPath, merged, 'utf-8');
+    return computeHash(merged);
+}
+export async function patchMcpJsonInjections(config, projectRoot, injections) {
+    const servers = buildServerEntries(collectMcpItems(injections));
+    const isEmpty = Object.keys(servers).length === 0;
+    let written = 0;
+    let removed = 0;
+    for (const targetId of config.targets) {
+        const target = getTarget(targetId);
+        if (!target?.mcp)
+            continue;
+        const absPath = path.join(projectRoot, target.mcp);
+        if (!existsSync(absPath)) {
+            if (!isEmpty) {
+                await mkdir(path.dirname(absPath), { recursive: true });
+                await writeFile(absPath, buildMcpJson(target, servers), 'utf-8');
+                written++;
+            }
+            continue;
+        }
+        const content = await readFile(absPath, 'utf-8');
+        const rootKey = target.mcpRootKey ?? 'mcpServers';
+        const parsed = JSON.parse(content);
+        const existing = parsed[rootKey] ?? {};
+        const userServers = filterUserServers(existing);
+        if (isEmpty) {
+            if (Object.keys(existing).some((k) => k.startsWith(MCP_SERVER_PREFIX))) {
+                parsed[rootKey] = userServers;
+                await writeFile(absPath, JSON.stringify(parsed, null, 2) + '\n', 'utf-8');
+                removed++;
+            }
+        }
+        else {
+            parsed[rootKey] = { ...userServers, ...servers };
+            await writeFile(absPath, JSON.stringify(parsed, null, 2) + '\n', 'utf-8');
+            written++;
+        }
+    }
+    return { written, removed, hashes: {} };
+}
+// ─── Gitignore ──────
+export function getMcpJsonGitignore(target) {
+    return target.mcp ? [target.mcp] : [];
+}
+// ─── Helpers ──────
+function buildServerEntries(items) {
+    const servers = {};
+    for (const item of items) {
+        if (!item.serverConfig)
+            continue;
+        servers[`${MCP_SERVER_PREFIX}${item.id}`] = item.serverConfig;
+    }
+    return servers;
+}
+function buildMcpJson(target, servers) {
+    const rootKey = target.mcpRootKey ?? 'mcpServers';
+    return JSON.stringify({ [rootKey]: servers }, null, 2) + '\n';
+}
+function collectMcpItems(injections) {
+    return [...injections.values()].flat().filter((i) => i.type === SyncItemType.McpServer);
+}
+function filterUserServers(servers) {
+    const user = {};
+    for (const [key, value] of Object.entries(servers)) {
+        if (!key.startsWith(MCP_SERVER_PREFIX))
+            user[key] = value;
+    }
+    return user;
+}
+async function mergeWithExisting(absPath, newContent) {
+    if (!existsSync(absPath))
+        return newContent;
+    let existing;
+    try {
+        existing = JSON.parse(await readFile(absPath, 'utf-8'));
+    }
+    catch {
+        return newContent;
+    }
+    const newParsed = JSON.parse(newContent);
+    const rootKey = Object.keys(newParsed)[0];
+    const userServers = filterUserServers(existing[rootKey] ?? {});
+    existing[rootKey] = { ...userServers, ...newParsed[rootKey] };
+    return JSON.stringify(existing, null, 2) + '\n';
+}
+//# sourceMappingURL=mcp-json.js.map

package/dist/formats/mcp-json.js.map

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

package/dist/formats/shared.d.ts

@@ -0,0 +1,4 @@
+/** 格式模块共享工具：hash 计算 + 标记块操作 */
+export declare function computeHash(content: string): string;
+export declare function spliceMarkerBlock(content: string, beginMarker: string, endMarker: string, replacement?: string): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/formats/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/formats/shared.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAI/B,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAuBvH"}

package/dist/formats/shared.js

@@ -0,0 +1,24 @@
+/** 格式模块共享工具：hash 计算 + 标记块操作 */
+import { createHash } from 'node:crypto';
+export function computeHash(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+export function spliceMarkerBlock(content, beginMarker, endMarker, replacement) {
+    const beginIdx = content.indexOf(beginMarker);
+    const endIdx = content.indexOf(endMarker);
+    const found = beginIdx !== -1 && endIdx !== -1;
+    if (!found) {
+        if (replacement === undefined)
+            return content;
+        const sep = content.endsWith('\n') ? '\n' : '\n\n';
+        return content + sep + replacement + '\n';
+    }
+    const before = content.slice(0, beginIdx);
+    const after = content.slice(endIdx + endMarker.length);
+    if (replacement === undefined) {
+        const trimmed = before.trimEnd();
+        return trimmed ? trimmed + after.trimStart() : after.trimStart();
+    }
+    return before + replacement + after;
+}
+//# sourceMappingURL=shared.js.map

package/dist/formats/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/formats/shared.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,WAAmB,EAAE,SAAiB,EAAE,WAAoB;IAC7G,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACzC,MAAM,KAAK,GAAG,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,CAAA;IAE9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO,OAAO,CAAA;QAE7C,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;QAElD,OAAO,OAAO,GAAG,GAAG,GAAG,WAAW,GAAG,IAAI,CAAA;IAC3C,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;IAEtD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAA;QAEhC,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,CAAA;IAClE,CAAC;IAED,OAAO,MAAM,GAAG,WAAW,GAAG,KAAK,CAAA;AACrC,CAAC"}

package/dist/formats/skill-dir.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Skill 目录格式模块
+ *
+ * 处理 skill 文件夹的同步写入：整目录 rm + cp 覆盖，
+ * 不做文件级 diff / 冲突检测。merge 型目标跳过 skill 同步。
+ */
+import type { AiConfig, InjectionRegistry, SkillDirPlan, SyncEntry } from '../types.js';
+import type { TargetConfig } from '../targets.js';
+export declare function planSkillDirs(target: TargetConfig, items: SyncEntry[]): SkillDirPlan[];
+export declare function writeSkillDir(plan: SkillDirPlan, projectRoot: string): Promise<void>;
+export interface SkillPatchResult {
+    written: number;
+    dirs: string[];
+}
+export declare function patchSkillDirInjections(config: AiConfig, projectRoot: string, injections: InjectionRegistry): Promise<SkillPatchResult>;
+export declare function removeStaleSkillDirs(projectRoot: string, prevDirs: string[], currentDirs: string[]): Promise<number>;
+//# sourceMappingURL=skill-dir.d.ts.map

package/dist/formats/skill-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-dir.d.ts","sourceRoot":"","sources":["../../src/formats/skill-dir.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAGvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAIjD,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,YAAY,EAAE,CAgBtF;AAID,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK1F;AAID,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,QAAQ,EAChB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,iBAAiB,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CA8B3B;AAID,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB1H"}

package/dist/formats/skill-dir.js

@@ -0,0 +1,72 @@
+/**
+ * Skill 目录格式模块
+ *
+ * 处理 skill 文件夹的同步写入：整目录 rm + cp 覆盖，
+ * 不做文件级 diff / 冲突检测。merge 型目标跳过 skill 同步。
+ */
+import { cp, rm } from 'node:fs/promises';
+import path from 'node:path';
+import { SyncItemType } from '../types.js';
+import { getTarget, isIndividualSlot, resolvePathTemplate } from '../targets.js';
+// ─── Plan ──────
+export function planSkillDirs(target, items) {
+    const template = resolvePathTemplate(target, SyncItemType.Skill);
+    if (!template || !isIndividualSlot(template))
+        return [];
+    const plans = [];
+    for (const item of items) {
+        if (item.type !== SyncItemType.Skill || !item.sourcePath)
+            continue;
+        const targetDir = path.dirname(template.replace('{id}', item.id));
+        plans.push({ id: item.id, sourceDir: item.sourcePath, targetDir, source: 'sync' });
+    }
+    return plans;
+}
+// ─── Write ──────
+export async function writeSkillDir(plan, projectRoot) {
+    const absTarget = path.join(projectRoot, plan.targetDir);
+    await rm(absTarget, { recursive: true, force: true });
+    await cp(plan.sourceDir, absTarget, { recursive: true });
+}
+export async function patchSkillDirInjections(config, projectRoot, injections) {
+    const skillItems = [...injections.values()].flat().filter((i) => i.type === SyncItemType.Skill && i.sourcePath);
+    if (skillItems.length === 0)
+        return { written: 0, dirs: [] };
+    let written = 0;
+    const dirs = [];
+    for (const targetId of config.targets) {
+        const target = getTarget(targetId);
+        if (!target)
+            continue;
+        const template = resolvePathTemplate(target, SyncItemType.Skill);
+        if (!template || !isIndividualSlot(template))
+            continue;
+        for (const item of skillItems) {
+            const targetDir = path.dirname(template.replace('{id}', item.id));
+            const absTarget = path.join(projectRoot, targetDir);
+            await rm(absTarget, { recursive: true, force: true });
+            await cp(item.sourcePath, absTarget, { recursive: true });
+            dirs.push(targetDir);
+            written++;
+        }
+    }
+    return { written, dirs };
+}
+// ─── Stale Cleanup ──────
+export async function removeStaleSkillDirs(projectRoot, prevDirs, currentDirs) {
+    const currentSet = new Set(currentDirs);
+    let removed = 0;
+    for (const dir of prevDirs) {
+        if (currentSet.has(dir))
+            continue;
+        try {
+            await rm(path.join(projectRoot, dir), { recursive: true, force: true });
+            removed++;
+        }
+        catch {
+            // 删除失败时静默跳过
+        }
+    }
+    return removed;
+}
+//# sourceMappingURL=skill-dir.js.map

package/dist/formats/skill-dir.js.map

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

package/dist/gitignore.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - .gitignore 管理
+ *
+ * 在项目 .gitignore 中维护 xfe-ai-rules 标记块
+ */
+/**
+ * 更新项目 .gitignore 中的 xfe-ai-rules 标记块
+ *
+ * 如果标记块已存在则替换其内容，否则追加到文件末尾
+ */
+export declare function updateGitignore(projectRoot: string, entries: string[]): Promise<void>;
+//# sourceMappingURL=gitignore.d.ts.map

package/dist/gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../src/gitignore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAe3F"}

package/dist/gitignore.js

@@ -0,0 +1,32 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - .gitignore 管理
+ *
+ * 在项目 .gitignore 中维护 xfe-ai-rules 标记块
+ */
+import { existsSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { spliceMarkerBlock } from './injection.js';
+// ─── Constants ──────
+const BLOCK_START = '# xfe-ai-rules (auto-generated, do not edit)';
+const BLOCK_END = '# end xfe-ai-rules';
+// ─── Public ──────
+/**
+ * 更新项目 .gitignore 中的 xfe-ai-rules 标记块
+ *
+ * 如果标记块已存在则替换其内容，否则追加到文件末尾
+ */
+export async function updateGitignore(projectRoot, entries) {
+    if (entries.length === 0)
+        return;
+    const gitignorePath = path.join(projectRoot, '.gitignore');
+    const newBlock = [BLOCK_START, ...entries, BLOCK_END].join('\n');
+    if (!existsSync(gitignorePath)) {
+        await writeFile(gitignorePath, newBlock + '\n', 'utf-8');
+        return;
+    }
+    const content = await readFile(gitignorePath, 'utf-8');
+    const updated = spliceMarkerBlock(content, BLOCK_START, BLOCK_END, newBlock);
+    await writeFile(gitignorePath, updated, 'utf-8');
+}
+//# sourceMappingURL=gitignore.js.map

package/dist/gitignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.js","sourceRoot":"","sources":["../src/gitignore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAElD,uBAAuB;AAEvB,MAAM,WAAW,GAAG,8CAA8C,CAAA;AAClE,MAAM,SAAS,GAAG,oBAAoB,CAAA;AAEtC,oBAAoB;AAEpB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAmB,EAAE,OAAiB;IAC1E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAEhC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAA;IAC1D,MAAM,QAAQ,GAAG,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEhE,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,MAAM,SAAS,CAAC,aAAa,EAAE,QAAQ,GAAG,IAAI,EAAE,OAAO,CAAC,CAAA;QACxD,OAAM;IACR,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;IACtD,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAA;IAE5E,MAAM,SAAS,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AAClD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - 插件入口
+ *
+ * 声明式 AI 配置同步：从 xfe.json 读取 ai 配置，
+ * 拉取远程仓库内容，按 target 注册表分发到项目 IDE 配置
+ */
+import type { XfePlugin } from '@xfe-repo/cli-core';
+import type { AiRulesCapability, AiRulesStoreState } from './types.js';
+export { SyncItemType } from './types.js';
+export type { AiRulesCapability, SyncEntry } from './types.js';
+declare const AI_RULES_STORE_INITIAL: AiRulesStoreState;
+declare module '@xfe-repo/cli-core' {
+    interface XfePluginRegistry {
+        'ai-rules': XfePlugin<typeof AI_RULES_STORE_INITIAL, AiRulesCapability>;
+    }
+}
+export declare function aiRulesPlugin(): XfePlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,oBAAoB,CAAA;AAIlE,OAAO,KAAK,EAAY,iBAAiB,EAAE,iBAAiB,EAAoD,MAAM,YAAY,CAAA;AAelI,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAI9D,QAAA,MAAM,sBAAsB,EAAE,iBAI7B,CAAA;AAED,OAAO,QAAQ,oBAAoB,CAAC;IAClC,UAAU,iBAAiB;QACzB,UAAU,EAAE,SAAS,CAAC,OAAO,sBAAsB,EAAE,iBAAiB,CAAC,CAAA;KACxE;CACF;AAID,wBAAgB,aAAa,IAAI,SAAS,CA+FzC"}