@zooique/memora 1.0.1 → 2.0.3

package/dist/utils/segmenter.js

@@ -43,10 +43,18 @@ function tokenizeKeywords(input) {
  * 匹配策略：先分词，再对每个关键词做子串搜索（tokens + 原文双保险）。
  * 大小写不敏感，中英文混合友好。
  *
+ * 评分公式：hitCount / Math.min(keywordList.length, KEYWORD_SCORE_DENOMINATOR_MAX)
+ *
+ * 分母上限 KEYWORD_SCORE_DENOMINATOR_MAX = 3，避免关键词多的角色被惩罚：
+ *   - 10 个 keywords 命中 2 个：原 2/10=0.2（被误判低置信度），现 2/3=0.67（高置信度）
+ *   - 2 个 keywords 命中 2 个：原 2/2=1.0，现 2/2=1.0（不变）
+ *
  * @param userInput - 用户输入文本
  * @param keywordList - 待匹配的关键词数组
  * @returns 匹配得分 (0~1)，0 表示无命中
  */
+/** 评分分母上限：防止关键词多的角色被惩罚（命中 2 个即视为强匹配） */
+const KEYWORD_SCORE_DENOMINATOR_MAX = 3;
 export function scoreByKeywords(userInput, keywordList) {
     if (keywordList.length === 0)
         return 0;
@@ -59,7 +67,8 @@ export function scoreByKeywords(userInput, keywordList) {
             hitCount++;
         }
     }
-    return hitCount / keywordList.length;
+    // 分母取 min(关键词总数, 3)：命中 2+ 个即高置信度，不受关键词总量影响
+    return hitCount / Math.min(keywordList.length, KEYWORD_SCORE_DENOMINATOR_MAX);
 }
 /**
  * 单行分词（用于 LLM 输出的精确切分）
@@ -82,6 +91,19 @@ export function segmentText(text) {
     }
     return tokens;
 }
+/**
+ * 分词后小写化（文本预处理快捷方法）
+ *
+ * 组合 segmentText + toLowerCase，消除 6 处散落的 `.map((t) => t.toLowerCase())` 模式
+ * （ADR-017 枝叶层 2 次提取原则）。
+ * 用于关键词匹配/召回场景的文本预处理（大小写不敏感匹配）。
+ *
+ * @param text 原文
+ * @returns 分词后的小写 token 数组
+ */
+export function segmentLower(text) {
+    return segmentText(text).map((t) => t.toLowerCase());
+}
 /**
  * 中文停用词集合
  * 用于关键词提取时过滤无意义词汇（从 memory/types.ts 迁入，

package/dist/utils/segmenter.js.map

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

package/dist/utils/strings.d.ts

@@ -8,11 +8,32 @@
  *
  * 规则：
  *   - 冒号和空白替换为连字符
- *   - 只保留字母、数字、中文、连字符、下划线
+ *   - 只保留字母、数字、中文、连字符、下划号
  *   - 截断到 MAX_SLUG_LENGTH 字符
  *
  * @param value 输入字符串
  * @returns slug 格式的字符串
  */
 export declare function slugify(value: string): string;
+/**
+ * 截断文本到指定长度，超长时追加后缀（省略号）
+ *
+ * 统一内核中 15 处散落的 `slice + suffix` 模式（ADR-017 枝叶层 2 次提取）。
+ *
+ * 与 sprite 的 `shared/truncate.ts` 独立（ADR-002 内核零依赖约束，kernel/sprite 各自维护）。
+ *
+ * 后缀约定：
+ *   - 默认 '…'（Unicode U+2026，1 字符）：UI 预览场景，简洁
+ *   - '…[截断]'：LLM prompt 场景，明确告知模型"此处被截断，非原文结束"
+ *   - 调用方可通过 suffix 参数自定义
+ *
+ * ellipsis 统一：将散落的 '...'（ASCII 3 字符）统一为 '…'（Unicode 1 字符），
+ * 与 sprite truncate.ts 保持一致。
+ *
+ * @param text 原始文本
+ * @param maxLen 最大保留长度（后缀不计入；截断后总长度 = maxLen + suffix.length）
+ * @param suffix 超长时追加的后缀，默认 '…'
+ * @returns 截断后的文本（含后缀），或原文本（未超长时原样返回）
+ */
+export declare function truncate(text: string, maxLen: number, suffix?: string): string;
 //# sourceMappingURL=strings.d.ts.map

package/dist/utils/strings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/utils/strings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO7C"}
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/utils/strings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO7C;AAID;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAY,GAAG,MAAM,CAKnF"}

package/dist/utils/strings.js

@@ -10,7 +10,7 @@ const MAX_SLUG_LENGTH = 40;
  *
  * 规则：
  *   - 冒号和空白替换为连字符
- *   - 只保留字母、数字、中文、连字符、下划线
+ *   - 只保留字母、数字、中文、连字符、下划号
  *   - 截断到 MAX_SLUG_LENGTH 字符
  *
  * @param value 输入字符串
@@ -24,4 +24,32 @@ export function slugify(value) {
         .replace(/^-|-$/g, '')
         .slice(0, MAX_SLUG_LENGTH);
 }
+// ─── 文本截断 ─────────────────────────────────────────
+/**
+ * 截断文本到指定长度，超长时追加后缀（省略号）
+ *
+ * 统一内核中 15 处散落的 `slice + suffix` 模式（ADR-017 枝叶层 2 次提取）。
+ *
+ * 与 sprite 的 `shared/truncate.ts` 独立（ADR-002 内核零依赖约束，kernel/sprite 各自维护）。
+ *
+ * 后缀约定：
+ *   - 默认 '…'（Unicode U+2026，1 字符）：UI 预览场景，简洁
+ *   - '…[截断]'：LLM prompt 场景，明确告知模型"此处被截断，非原文结束"
+ *   - 调用方可通过 suffix 参数自定义
+ *
+ * ellipsis 统一：将散落的 '...'（ASCII 3 字符）统一为 '…'（Unicode 1 字符），
+ * 与 sprite truncate.ts 保持一致。
+ *
+ * @param text 原始文本
+ * @param maxLen 最大保留长度（后缀不计入；截断后总长度 = maxLen + suffix.length）
+ * @param suffix 超长时追加的后缀，默认 '…'
+ * @returns 截断后的文本（含后缀），或原文本（未超长时原样返回）
+ */
+export function truncate(text, maxLen, suffix = '…') {
+    // 未超长直接返回原文本（含 text.length === maxLen 的边界情况）
+    if (text.length <= maxLen)
+        return text;
+    // 超长时截断到 maxLen 并追加后缀
+    return text.slice(0, maxLen) + suffix;
+}
 //# sourceMappingURL=strings.js.map

package/dist/utils/strings.js.map

@@ -1 +1 @@
-{"version":3,"file":"strings.js","sourceRoot":"","sources":["../../src/utils/strings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gBAAgB;AAChB,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC;SAC5C,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"strings.js","sourceRoot":"","sources":["../../src/utils/strings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gBAAgB;AAChB,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC;SAC5C,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;AAC/B,CAAC;AAED,qDAAqD;AAErD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,MAAc,EAAE,SAAiB,GAAG;IACzE,6CAA6C;IAC7C,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC;IACvC,sBAAsB;IACtB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;AACxC,CAAC"}

package/dist/utils/time.d.ts

@@ -3,6 +3,9 @@
  *
  * 从 messageHistory.ts 提取的公共时间格式化函数，
  * 消除跨模块 `new Date().toISOString()` 内联重复。
+ *
+ * API 对齐：formatDateKey(date) 与精灵 shared/dateUtils.ts 语义一致，
+ * 用于格式化任意 Date 为 YYYY-MM-DD（本地时区）。
  */
 /**
  * 获取当前时间的 ISO 8601 时间戳
@@ -10,12 +13,24 @@
  * @returns 如 "2026-06-21T12:34:56.789Z"
  */
 export declare function nowIso(): string;
+/**
+ * 格式化 Date 为 YYYY-MM-DD 日期键（本地时区）
+ *
+ * 使用 getFullYear/getMonth/getDate（本地时区），替代 toISOString().slice(0,10)（UTC）。
+ * 修复场景：Asia/Shanghai 凌晨 00:00-08:00 期间 UTC 仍是前一天，导致按日期分组的
+ * 计数（chatTurns / dailyMessageCount）写入错误的日期 key。
+ *
+ * 与精灵 shared/dateUtils.ts:formatDateKey 行为完全对齐。
+ *
+ * @param date Date 对象
+ * @returns YYYY-MM-DD 字符串（本地日期）
+ */
+export declare function formatDateKey(date: Date): string;
 /**
  * 获取当前日期字符串（YYYY-MM-DD，本地时区）
  *
- * 使用本地时区日期，避免 UTC 偏移导致跨天错位
- * （如 Asia/Shanghai 00:00-08:00 期间 UTC 仍是前一天，
- * 会话文件会写入"昨天"导致跨天 reset 与 UI 错乱）
+ * 委托 formatDateKey(new Date())，避免逻辑重复。
+ * 保留无参形态是因为多数调用点只关心"今天"，无需先构造 new Date()。
  *
  * @returns 如 "2026-06-21"
  */

package/dist/utils/time.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAMlC"}
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAKhD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/dist/utils/time.js

@@ -3,6 +3,9 @@
  *
  * 从 messageHistory.ts 提取的公共时间格式化函数，
  * 消除跨模块 `new Date().toISOString()` 内联重复。
+ *
+ * API 对齐：formatDateKey(date) 与精灵 shared/dateUtils.ts 语义一致，
+ * 用于格式化任意 Date 为 YYYY-MM-DD（本地时区）。
  */
 /**
  * 获取当前时间的 ISO 8601 时间戳
@@ -12,20 +15,33 @@
 export function nowIso() {
     return new Date().toISOString();
 }
+/**
+ * 格式化 Date 为 YYYY-MM-DD 日期键（本地时区）
+ *
+ * 使用 getFullYear/getMonth/getDate（本地时区），替代 toISOString().slice(0,10)（UTC）。
+ * 修复场景：Asia/Shanghai 凌晨 00:00-08:00 期间 UTC 仍是前一天，导致按日期分组的
+ * 计数（chatTurns / dailyMessageCount）写入错误的日期 key。
+ *
+ * 与精灵 shared/dateUtils.ts:formatDateKey 行为完全对齐。
+ *
+ * @param date Date 对象
+ * @returns YYYY-MM-DD 字符串（本地日期）
+ */
+export function formatDateKey(date) {
+    const y = date.getFullYear();
+    const m = String(date.getMonth() + 1).padStart(2, '0');
+    const d = String(date.getDate()).padStart(2, '0');
+    return `${y}-${m}-${d}`;
+}
 /**
  * 获取当前日期字符串（YYYY-MM-DD，本地时区）
  *
- * 使用本地时区日期，避免 UTC 偏移导致跨天错位
- * （如 Asia/Shanghai 00:00-08:00 期间 UTC 仍是前一天，
- * 会话文件会写入"昨天"导致跨天 reset 与 UI 错乱）
+ * 委托 formatDateKey(new Date())，避免逻辑重复。
+ * 保留无参形态是因为多数调用点只关心"今天"，无需先构造 new Date()。
  *
  * @returns 如 "2026-06-21"
  */
 export function todayDate() {
-    const now = new Date();
-    const year = now.getFullYear();
-    const month = String(now.getMonth() + 1).padStart(2, '0');
-    const day = String(now.getDate()).padStart(2, '0');
-    return `${year}-${month}-${day}`;
+    return formatDateKey(new Date());
 }
 //# sourceMappingURL=time.js.map

package/dist/utils/time.js.map

@@ -1 +1 @@
-{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;AACnC,CAAC"}
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,aAAa,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AACnC,CAAC"}

package/dist/utils/toError.d.ts

@@ -4,10 +4,14 @@
  * 将 catch 块中的 unknown 值安全转换为 Error 对象。
  * 从 errors.ts 中提取，确保浏览器端可直接 import 而不引入 logging（pino）依赖。
  *
- * 转换规则：
- * - Error 实例：原样返回
- * - 对象且含 message 属性：包装为 Error
- * - 其他：调用 String() 转为 message
+ * 转换规则（5 分支，与精灵 shared/toError.ts 行为对齐）：
+ *   1. Error 实例：原样返回
+ *   2. 字符串：包装为 Error
+ *   3. 含 message 属性的对象：提取 message 包装为 Error
+ *   4. 普通对象（无 message）：JSON 序列化（try-catch 防循环引用）
+ *   5. 其他类型（number/boolean/symbol/null/undefined）：String() 转换
+ *
+ * null/undefined 返回 '未知错误'，比 'null'/'undefined' 更友好。
  */
 export declare function toError(err: unknown): Error;
 //# sourceMappingURL=toError.d.ts.map

package/dist/utils/toError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toError.d.ts","sourceRoot":"","sources":["../../src/utils/toError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAU3C"}
+{"version":3,"file":"toError.d.ts","sourceRoot":"","sources":["../../src/utils/toError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAwB3C"}

package/dist/utils/toError.js

@@ -4,19 +4,39 @@
  * 将 catch 块中的 unknown 值安全转换为 Error 对象。
  * 从 errors.ts 中提取，确保浏览器端可直接 import 而不引入 logging（pino）依赖。
  *
- * 转换规则：
- * - Error 实例：原样返回
- * - 对象且含 message 属性：包装为 Error
- * - 其他：调用 String() 转为 message
+ * 转换规则（5 分支，与精灵 shared/toError.ts 行为对齐）：
+ *   1. Error 实例：原样返回
+ *   2. 字符串：包装为 Error
+ *   3. 含 message 属性的对象：提取 message 包装为 Error
+ *   4. 普通对象（无 message）：JSON 序列化（try-catch 防循环引用）
+ *   5. 其他类型（number/boolean/symbol/null/undefined）：String() 转换
+ *
+ * null/undefined 返回 '未知错误'，比 'null'/'undefined' 更友好。
  */
 export function toError(err) {
+    // 1. Error 实例直接返回（最常见路径）
     if (err instanceof Error)
         return err;
+    // 2. 字符串包装为 Error
+    if (typeof err === 'string')
+        return new Error(err);
+    // 3. 含 message 属性的对象（如 IPC 序列化错误）提取 message
     if (typeof err === 'object' &&
         err !== null &&
         typeof err.message === 'string') {
         return new Error(err.message);
     }
-    return new Error(String(err));
+    // 4. 普通对象（无 message 属性）：JSON 序列化保留调试信息，try-catch 防止循环引用抛错
+    if (typeof err === 'object' && err !== null) {
+        try {
+            return new Error(JSON.stringify(err));
+        }
+        catch {
+            // 循环引用等无法序列化的情况，降级到 String()
+            return new Error(String(err));
+        }
+    }
+    // 5. 基础类型（number/boolean/symbol/null/undefined）
+    return new Error(String(err ?? '未知错误'));
 }
 //# sourceMappingURL=toError.js.map

package/dist/utils/toError.js.map

@@ -1 +1 @@
-{"version":3,"file":"toError.js","sourceRoot":"","sources":["../../src/utils/toError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC;IACrC,IACE,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,OAAQ,GAA6B,CAAC,OAAO,KAAK,QAAQ,EAC1D,CAAC;QACD,OAAO,IAAI,KAAK,CAAE,GAA2B,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAChC,CAAC"}
+{"version":3,"file":"toError.js","sourceRoot":"","sources":["../../src/utils/toError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,yBAAyB;IACzB,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC;IACrC,kBAAkB;IAClB,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,4CAA4C;IAC5C,IACE,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,OAAQ,GAA6B,CAAC,OAAO,KAAK,QAAQ,EAC1D,CAAC;QACD,OAAO,IAAI,KAAK,CAAE,GAA2B,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IACD,0DAA0D;IAC1D,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;YAC7B,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,gDAAgD;IAChD,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC;AAC1C,CAAC"}