dsh-tavern-bundle 0.1.0

package/lib/import/artifact-service.d.ts

@@ -0,0 +1,33 @@
+/**
+ * ArtifactService —— 原始导入资产的持久化（内容寻址 + SHA-256 去重）。
+ *
+ * artifacts 表（tavern domain）以内容哈希为 id：同一字节内容只存一份。
+ * 导入内容是不可信数据：仅保存原始字节的哈希引用与元数据，不解析、不执行。
+ */
+import type { KvTable } from '@deepseek-ai/dsh-storage-domain';
+import type { Artifact, ArtifactKind } from '../domain/schemas.js';
+export interface ArtifactMetadata {
+    readonly fileName?: string;
+    readonly cardVersion?: number;
+    readonly characterId?: string;
+    readonly unsupportedFields?: readonly string[];
+}
+export interface StoredArtifactResult {
+    /** 内容哈希（= artifact id）。 */
+    readonly hash: string;
+    /** 是否已存在（去重命中）。 */
+    readonly existed: boolean;
+    readonly artifact: Artifact;
+}
+export declare class ArtifactService {
+    #private;
+    constructor(artifacts: KvTable<string, Artifact>);
+    /** 按内容哈希读取资产；不存在返回 null。 */
+    getArtifact(hash: string): Artifact | null;
+    /**
+     * 保存原始资产（幂等）：同 hash 已存在则直接返回（去重），
+     * 否则写入并返回。metadata 变更时合并更新（例如绑定 characterId）。
+     */
+    storeArtifact(bytes: Uint8Array, kind: ArtifactKind, metadata: ArtifactMetadata): Promise<StoredArtifactResult>;
+}
+//# sourceMappingURL=artifact-service.d.ts.map

package/lib/import/artifact-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-service.d.ts","sourceRoot":"","sources":["../../src/import/artifact-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAE9D,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAElE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC/C;AAED,MAAM,WAAW,oBAAoB;IACnC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,mBAAmB;IACnB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;CAC5B;AAED,qBAAa,eAAe;;gBAGd,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC;IAIhD,4BAA4B;IAC5B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAI1C;;;OAGG;IACG,aAAa,CACjB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,oBAAoB,CAAC;CAuCjC"}

package/lib/import/artifact-service.js

@@ -0,0 +1,67 @@
+/**
+ * ArtifactService —— 原始导入资产的持久化（内容寻址 + SHA-256 去重）。
+ *
+ * artifacts 表（tavern domain）以内容哈希为 id：同一字节内容只存一份。
+ * 导入内容是不可信数据：仅保存原始字节的哈希引用与元数据，不解析、不执行。
+ */
+import { sha256 } from './parser.js';
+export class ArtifactService {
+    #artifacts;
+    constructor(artifacts) {
+        this.#artifacts = artifacts;
+    }
+    /** 按内容哈希读取资产；不存在返回 null。 */
+    getArtifact(hash) {
+        return this.#artifacts.get(hash) ?? null;
+    }
+    /**
+     * 保存原始资产（幂等）：同 hash 已存在则直接返回（去重），
+     * 否则写入并返回。metadata 变更时合并更新（例如绑定 characterId）。
+     */
+    async storeArtifact(bytes, kind, metadata) {
+        const hash = sha256(bytes);
+        const existing = this.getArtifact(hash);
+        if (existing !== null) {
+            const merged = this.#mergeMetadata(existing, metadata);
+            if (merged !== existing)
+                await this.#artifacts.put(hash, merged);
+            return { hash, existed: true, artifact: merged };
+        }
+        const artifact = {
+            id: hash,
+            kind,
+            hash,
+            size: bytes.byteLength,
+            metadata: this.#plainMetadata(metadata),
+            storedAt: new Date().toISOString(),
+        };
+        await this.#artifacts.put(hash, artifact);
+        return { hash, existed: false, artifact };
+    }
+    #mergeMetadata(existing, metadata) {
+        const merged = { ...existing.metadata };
+        if (metadata.fileName !== undefined && typeof merged.fileName !== 'string')
+            merged.fileName = metadata.fileName;
+        if (metadata.cardVersion !== undefined && typeof merged.cardVersion !== 'number')
+            merged.cardVersion = metadata.cardVersion;
+        if (metadata.characterId !== undefined)
+            merged.characterId = metadata.characterId;
+        if (metadata.unsupportedFields !== undefined && !Array.isArray(merged.unsupportedFields)) {
+            merged.unsupportedFields = [...metadata.unsupportedFields];
+        }
+        return { ...existing, metadata: merged };
+    }
+    #plainMetadata(metadata) {
+        const result = {};
+        if (metadata.fileName !== undefined)
+            result.fileName = metadata.fileName;
+        if (metadata.cardVersion !== undefined)
+            result.cardVersion = metadata.cardVersion;
+        if (metadata.characterId !== undefined)
+            result.characterId = metadata.characterId;
+        if (metadata.unsupportedFields !== undefined)
+            result.unsupportedFields = [...metadata.unsupportedFields];
+        return result;
+    }
+}
+//# sourceMappingURL=artifact-service.js.map

package/lib/import/artifact-service.js.map

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

package/lib/import/import-service.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ImportService —— 角色卡导入流水线编排。
+ *
+ * 上传 artifact → 类型检测 → 解析提取 → 规范化（补全/降级/诊断）→
+ * 内容哈希去重并保存原始 artifact → 创建 CharacterDefinition（revision=1，
+ * capabilityProfileId 固定 companion，不可提升）→ 返回导入诊断。
+ *
+ * 安全：导入内容不可信，全部解析在 parser.ts 的边界内完成；本服务不执行
+ * 任何卡内代码，正则/脚本/HTML 等字段仅保留元数据并标记 unsupported。
+ */
+import type { KvTable } from '@deepseek-ai/dsh-storage-domain';
+import type { Artifact, CharacterDefinition, ImportDiagnostic, LorebookDefinition } from '../domain/schemas.js';
+/** 导入角色固定使用的 CapabilityProfile（角色卡无法提升权限）。 */
+export declare const IMPORT_CAPABILITY_PROFILE_ID = "companion";
+export interface CharacterImportResult {
+    readonly characterId: string;
+    readonly name: string;
+    readonly revision: number;
+    /** 内容哈希去重命中（同内容重复导入）。 */
+    readonly deduplicated: boolean;
+    readonly artifactHash: string;
+    readonly diagnostics: readonly ImportDiagnostic[];
+}
+export declare class ImportService {
+    #private;
+    constructor(characters: KvTable<string, CharacterDefinition>, artifacts: KvTable<string, Artifact>, lorebooks: KvTable<string, LorebookDefinition>);
+    /** 编排一次导入。解析失败抛错（带明确信息），成功返回诊断。 */
+    importCharacter(bytes: Uint8Array, fileName?: string): Promise<CharacterImportResult>;
+}
+//# sourceMappingURL=import-service.d.ts.map

package/lib/import/import-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-service.d.ts","sourceRoot":"","sources":["../../src/import/import-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAC9D,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,gBAAgB,EAEhB,kBAAkB,EACnB,MAAM,sBAAsB,CAAA;AAI7B,8CAA8C;AAC9C,eAAO,MAAM,4BAA4B,cAAc,CAAA;AAEvD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,yBAAyB;IACzB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAClD;AAUD,qBAAa,aAAa;;gBAMtB,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAChD,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,EACpC,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAOhD,mCAAmC;IAC7B,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CA4H5F"}

package/lib/import/import-service.js

@@ -0,0 +1,154 @@
+/**
+ * ImportService —— 角色卡导入流水线编排。
+ *
+ * 上传 artifact → 类型检测 → 解析提取 → 规范化（补全/降级/诊断）→
+ * 内容哈希去重并保存原始 artifact → 创建 CharacterDefinition（revision=1，
+ * capabilityProfileId 固定 companion，不可提升）→ 返回导入诊断。
+ *
+ * 安全：导入内容不可信，全部解析在 parser.ts 的边界内完成；本服务不执行
+ * 任何卡内代码，正则/脚本/HTML 等字段仅保留元数据并标记 unsupported。
+ */
+import { ArtifactService } from './artifact-service.js';
+import { detectCardKind, parseCard } from './parser.js';
+/** 导入角色固定使用的 CapabilityProfile（角色卡无法提升权限）。 */
+export const IMPORT_CAPABILITY_PROFILE_ID = 'companion';
+function info(field, message) {
+    return { level: 'info', field, message };
+}
+function warning(field, message) {
+    return { level: 'warning', field, message };
+}
+export class ImportService {
+    #characters;
+    #artifacts;
+    #lorebooks;
+    constructor(characters, artifacts, lorebooks) {
+        this.#characters = characters;
+        this.#artifacts = new ArtifactService(artifacts);
+        this.#lorebooks = lorebooks;
+    }
+    /** 编排一次导入。解析失败抛错（带明确信息），成功返回诊断。 */
+    async importCharacter(bytes, fileName) {
+        const kind = detectCardKind(fileName, bytes);
+        const card = parseCard(bytes, kind);
+        const diagnostics = [];
+        // 字段映射诊断
+        diagnostics.push(info('name', `name -> ${card.name}`));
+        if (card.persona.trim() === '') {
+            diagnostics.push(warning('persona', 'description/personality/system_prompt/constant 世界书全为空：角色将无人设，仅按系统默认行为运行'));
+        }
+        else {
+            diagnostics.push(info('persona', `persona 已组合（${card.persona.length} 字符；含 description/personality/system_prompt 与 constant 世界书条目）`));
+        }
+        if (card.constantLoreCount > 0) {
+            diagnostics.push(info('character_book', `${card.constantLoreCount} 条 constant 世界书条目已并入 persona（始终激活）`));
+        }
+        if (card.scenario !== undefined)
+            diagnostics.push(info('scenario', 'scenario 已映射'));
+        else
+            diagnostics.push(warning('scenario', '缺少 scenario，留空'));
+        if (card.exampleDialogue !== undefined)
+            diagnostics.push(info('exampleDialogue', 'mes_example -> exampleDialogue 已映射'));
+        else
+            diagnostics.push(warning('exampleDialogue', '缺少 mes_example，留空'));
+        if (card.firstMessage !== undefined)
+            diagnostics.push(info('firstMessage', 'first_mes -> firstMessage 已映射'));
+        else
+            diagnostics.push(warning('firstMessage', '缺少 first_mes，开场白留空'));
+        diagnostics.push(info('alternateGreetings', `alternate_greetings ${card.alternateGreetings.length} 条`));
+        if (card.lorebook !== undefined) {
+            diagnostics.push(info('lorebook', '内嵌世界书已保留在 artifact 元数据，阶段 4 规范化'));
+        }
+        for (const item of card.unsupported) {
+            diagnostics.push(warning(item.field, `${item.detail}（仅保留元数据）`));
+        }
+        if (card.unknownFields.length > 0) {
+            diagnostics.push(warning('unknown', `未知字段忽略：${card.unknownFields.slice(0, 8).join('、')}${card.unknownFields.length > 8 ? '…' : ''}`));
+        }
+        // 内容哈希去重 + 保存原始 artifact
+        const unsupportedFields = card.unsupported.map(item => `${item.field}: ${item.detail}`);
+        const stored = await this.#artifacts.storeArtifact(bytes, kind, {
+            ...(fileName === undefined ? {} : { fileName }),
+            cardVersion: card.version,
+            unsupportedFields,
+        });
+        diagnostics.push(info('artifact', `原始资产已保存（kind=${kind} hash=${stored.hash.slice(0, 12)}… ${stored.existed ? '去重命中' : '新建'})`));
+        // 去重：同 hash 已关联角色则复用
+        const existingCharacterId = stored.artifact.metadata.characterId;
+        if (typeof existingCharacterId === 'string' && this.#characters.get(existingCharacterId) !== undefined) {
+            const existing = this.#characters.get(existingCharacterId);
+            diagnostics.push(warning('deduplicate', `同内容已导入过（characterId=${existingCharacterId} revision=${existing.revision}），复用`));
+            return {
+                characterId: existingCharacterId,
+                name: existing.name,
+                revision: existing.revision,
+                deduplicated: true,
+                artifactHash: stored.hash,
+                diagnostics,
+            };
+        }
+        // 创建 CharacterDefinition（revision=1，固定 companion）
+        const now = new Date().toISOString();
+        const characterId = `card-${stored.hash.slice(0, 16)}`;
+        // 内嵌世界书 → LorebookDefinition（绑定到角色；constant 条目已并入 persona
+        // 且带标记，ContextAssembler 检索时跳过，避免重复注入）。
+        let lorebookIds = [];
+        if (card.lorebook !== undefined && card.lorebook.entries.length > 0) {
+            const lorebookId = `lore-${characterId}`;
+            const entries = card.lorebook.entries.map(entry => ({
+                id: entry.id,
+                keys: [...entry.keys],
+                content: entry.content,
+                priority: entry.priority,
+                enabled: entry.enabled,
+                constant: entry.constant,
+                caseSensitive: entry.caseSensitive,
+                matchMode: entry.matchMode,
+            }));
+            await this.#lorebooks.put(lorebookId, {
+                id: lorebookId,
+                name: card.lorebook.name,
+                entries,
+                createdAt: now,
+                updatedAt: now,
+            });
+            lorebookIds = [lorebookId];
+            diagnostics.push(info('lorebook', `世界书已创建（id=${lorebookId}，${entries.length} 条，其中 ${card.lorebook.constantCount} 条 constant 已并入 persona，其余按关键词触发注入）`));
+        }
+        const definition = {
+            id: characterId,
+            revision: 1,
+            name: card.name,
+            persona: card.persona,
+            ...(card.scenario === undefined ? {} : { scenario: card.scenario }),
+            ...(card.exampleDialogue === undefined ? {} : { exampleDialogue: card.exampleDialogue }),
+            ...(card.firstMessage === undefined ? {} : { firstMessage: card.firstMessage }),
+            alternateGreetings: [...card.alternateGreetings],
+            capabilityProfileId: IMPORT_CAPABILITY_PROFILE_ID,
+            lorebookIds,
+            importRecordId: stored.hash,
+            status: 'active',
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.#characters.put(characterId, definition);
+        // 绑定 artifact → characterId（去重可复用）
+        await this.#artifacts.storeArtifact(bytes, kind, {
+            ...(fileName === undefined ? {} : { fileName }),
+            cardVersion: card.version,
+            characterId,
+            unsupportedFields,
+        });
+        diagnostics.push(info('capabilityProfileId', `导入角色固定 ${IMPORT_CAPABILITY_PROFILE_ID}（角色卡无法提升权限）`));
+        diagnostics.push(info('created', `CharacterDefinition 已创建（id=${characterId} revision=1）`));
+        return {
+            characterId,
+            name: card.name,
+            revision: 1,
+            deduplicated: false,
+            artifactHash: stored.hash,
+            diagnostics,
+        };
+    }
+}
+//# sourceMappingURL=import-service.js.map

package/lib/import/import-service.js.map

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

package/lib/import/parser.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 角色卡解析器（Tavern Character Card V1/V2/V3）。
+ *
+ * 安全模型：导入内容一律视为不可信数据——
+ * - 只解析，不执行任何代码（无 eval、无动态 import、无脚本宿主）；
+ * - JSON / PNG 元数据 / CHARX 解压全部有字节与条目上限；
+ * - UTF-8 fatal 解码（拒绝非法编码，不做替换字符猜测）；
+ * - base64 规范校验（canonicality）；
+ * - CHARX 路径穿越防护（normalizeCharxPath）。
+ *
+ * 降级规则：regex / Tavern Helper / HTML / 远程代码等字段仅保留原始
+ * 元数据并标记 unsupported，绝不执行。
+ */
+import type { LoreMatchMode } from '../domain/schemas.js';
+/** 单个角色卡 JSON（解码后）的最大字节数。 */
+export declare const MAX_CARD_JSON_BYTES: number;
+/** 单个导入文件（压缩前）的最大字节数。 */
+export declare const MAX_IMPORT_BYTES: number;
+/** CHARX 解压总字节上限。 */
+export declare const MAX_CHARX_UNCOMPRESSED_BYTES: number;
+/** CHARX 条目数上限。 */
+export declare const MAX_CHARX_ENTRIES = 512;
+export type CardKind = 'character-card-json' | 'character-card-png' | 'charx';
+/** 规范化的世界书（角色卡内嵌 character_book）：constant 条目并入 persona，
+ * 全部条目保留供存储与溯源；检索注入仅针对非 constant 条目（阶段 4 修复）。 */
+export interface ParsedLorebook {
+    readonly name: string;
+    readonly entries: readonly {
+        readonly id: string;
+        readonly keys: readonly string[];
+        readonly content: string;
+        readonly priority: number;
+        readonly enabled: boolean;
+        /** constant（始终激活）：已并入 persona，检索阶段跳过。 */
+        readonly constant: boolean;
+        readonly caseSensitive: boolean;
+        readonly matchMode: LoreMatchMode;
+    }[];
+    /** constant（始终激活）条目数——这些已并入 persona，不参与检索。 */
+    readonly constantCount: number;
+}
+export interface ParsedCharacterCard {
+    readonly version: 1 | 2 | 3;
+    readonly specVersion: string;
+    readonly name: string;
+    readonly persona: string;
+    /** 并入 persona 的 constant 世界书条目数（始终激活）。 */
+    readonly constantLoreCount: number;
+    readonly scenario?: string;
+    readonly exampleDialogue?: string;
+    readonly firstMessage?: string;
+    readonly alternateGreetings: readonly string[];
+    /** 规范化后的内嵌世界书（无则 undefined）。 */
+    readonly lorebook?: ParsedLorebook;
+    /** 降级项：保留元数据、不执行的字段。 */
+    readonly unsupported: readonly {
+        readonly field: string;
+        readonly detail: string;
+    }[];
+    /** 被忽略的未知字段。 */
+    readonly unknownFields: readonly string[];
+    /** 解析后的原始 JSON（用于 artifact 溯源）。 */
+    readonly raw: unknown;
+}
+/** 检测文件种类：文件名扩展名优先，magic bytes 兜底。 */
+export declare function detectCardKind(fileName: string | undefined, bytes: Uint8Array): CardKind;
+/** 宽容解析一张卡 JSON；仅 name 缺失时报错，其余字段缺失给空值由调用方诊断。 */
+export declare function parseCardJson(parsed: unknown): ParsedCharacterCard;
+/** 解析 JSON 角色卡字节（V1/V2/V3）。 */
+export declare function parseJSONCard(bytes: Uint8Array): ParsedCharacterCard;
+/** 解析 PNG 角色卡（chara / ccv3 元数据）。 */
+export declare function parsePNGCard(bytes: Uint8Array): ParsedCharacterCard;
+/** 规范化 CHARX 条目路径：防穿越、防绝对路径、防重复。 */
+export declare function normalizeCharxPath(value: string): string;
+/** 解析 CHARX 压缩包：card.json 必须位于根且为 V3。 */
+export declare function parseCHARXCard(bytes: Uint8Array): ParsedCharacterCard;
+/** 内容哈希（SHA-256 hex）——导入去重与 artifact 内容寻址。 */
+export declare function sha256(bytes: Uint8Array): string;
+/** 统一入口：按检测出的类型解析。 */
+export declare function parseCard(bytes: Uint8Array, kind: CardKind): ParsedCharacterCard;
+//# sourceMappingURL=parser.d.ts.map

package/lib/import/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/import/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,6BAA6B;AAC7B,eAAO,MAAM,mBAAmB,QAAkB,CAAA;AAClD,yBAAyB;AACzB,eAAO,MAAM,gBAAgB,QAAmB,CAAA;AAChD,qBAAqB;AACrB,eAAO,MAAM,4BAA4B,QAAoB,CAAA;AAC7D,mBAAmB;AACnB,eAAO,MAAM,iBAAiB,MAAM,CAAA;AAIpC,MAAM,MAAM,QAAQ,GAAG,qBAAqB,GAAG,oBAAoB,GAAG,OAAO,CAAA;AAE7E;iDACiD;AACjD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS;QACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;QAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;QACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;QACzB,yCAAyC;QACzC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;QAC1B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;QAC/B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;KAClC,EAAE,CAAA;IACH,8CAA8C;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9C,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAA;IAClC,wBAAwB;IACxB,QAAQ,CAAC,WAAW,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACpF,gBAAgB;IAChB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;IACzC,mCAAmC;IACnC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;CACtB;AAUD,sCAAsC;AACtC,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,UAAU,GAAG,QAAQ,CAuBxF;AA6ID,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,mBAAmB,CAiDlE;AAED,+BAA+B;AAC/B,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,CAapE;AAmFD,oCAAoC;AACpC,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,CAUnE;AAED,oCAAoC;AACpC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYxD;AAED,yCAAyC;AACzC,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,CAiCrE;AAED,8CAA8C;AAC9C,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEhD;AAED,sBAAsB;AACtB,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,mBAAmB,CAIhF"}