mingyu-core 0.1.0

package/dist/divination/algorithms/qimen/helpers/palace-relations.js

@@ -0,0 +1,279 @@
+/**
+ * @file 单宫门星神关系分析
+ * @description 分析一个宫位内八门、九星、八神之间的五行生克关系，
+ * 判断宫位内部的和谐程度，为宫位能量解读提供基础。
+ *
+ * 古籍依据：
+ *   - 《烟波钓叟歌》：「九星八门八神配五行，生克判吉凶」
+ *   - 《奇门遁甲秘籍大全·门星神合参章》：「门为事体，星为事主，神为事机。
+ *     三者相生则吉，比和则顺，相克则阻。」
+ *   - 《遁甲演义》：「凡门星神三者比和，此宫为吉；三者相克，此宫大凶；
+ *     凡生我者为恩，克我者为仇，我生者为泄，我克者为制。」
+ *
+ * 门星神三者的五行生克是判断宫位能量是否协调的核心：
+ *   - 比和（同五行）：相互支持，和谐稳定
+ *   - 相生（我生/生我）：有助力或宣泄，整体偏正
+ *   - 相克（我克/克我）：有压制或反抗，有矛盾张力
+ */
+import { doorElements, starElements, isGenerating, isControlling } from './_constants';
+// ============================================================================
+// 1. 八神五行映射
+// ============================================================================
+/**
+ * 八神五行属性
+ *
+ * 古籍依据：
+ *   - 《太白阴经》：「值符之气属土，其性厚重；螣蛇之气属火，其性虚幻；
+ *     太阴之气属金，其性肃杀；六合之气属木，其性和合；
+ *     白虎之气属金，其性凶悍；玄武之气属水，其性暗昧；
+ *     九地之气属土，其性隐伏；九天之气属金，其性高远。」
+ *   - 《奇门遁甲秘籍大全》：「八神各有本气，随五行转宫，吉凶各有所主。」
+ */
+const godElements = {
+    值符: '土',
+    螣蛇: '火',
+    太阴: '金',
+    六合: '木',
+    白虎: '金',
+    玄武: '水',
+    九地: '土',
+    九天: '金',
+};
+// ============================================================================
+// 2. 元素获取函数
+// ============================================================================
+/**
+ * 获取八门的五行属性
+ *
+ * @param door 八门名称（如 "休门"、"生门"）
+ * @returns 对应的五行（"水"、"火"、"木"、"金"、"土"），未知时返回空字符串
+ *
+ * @example
+ * ```ts
+ * getDoorElement('休门'); // '水'
+ * getDoorElement('景门'); // '火'
+ * ```
+ */
+export function getDoorElement(door) {
+    return doorElements[door] || '';
+}
+/**
+ * 获取九星的五行属性
+ *
+ * @param star 九星名称（如 "天蓬"、"天芮"）
+ * @returns 对应的五行（"水"、"火"、"木"、"金"、"土"），未知时返回空字符串
+ *
+ * @example
+ * ```ts
+ * getStarElement('天蓬'); // '水'
+ * getStarElement('天英'); // '火'
+ * ```
+ */
+export function getStarElement(star) {
+    return starElements[star] || '';
+}
+/**
+ * 获取八神的五行属性
+ *
+ * @param god 八神名称（如 "值符"、"螣蛇"）
+ * @returns 对应的五行（"水"、"火"、"木"、"金"、"土"），未知时返回空字符串
+ *
+ * @example
+ * ```ts
+ * getGodElement('值符'); // '土'
+ * getGodElement('螣蛇'); // '火'
+ * getGodElement('太阴'); // '金'
+ * ```
+ */
+export function getGodElement(god) {
+    return godElements[god] || '';
+}
+// ============================================================================
+// 4. 五行生克关系判定
+// ============================================================================
+/**
+ * 判断两个五行的生克关系
+ *
+ * @param elem1 第一个五行
+ * @param elem2 第二个五行
+ * @returns '比和' | '相生' | '相克'
+ *
+ * 比和：两五行相同，互相支持
+ * 相生：一方生另一方（双向判断，无论谁生谁）
+ * 相克：一方克另一方（双向判断，无论谁克谁）
+ */
+function getWuxingRelation(elem1, elem2) {
+    if (!elem1 || !elem2)
+        return '比和';
+    if (elem1 === elem2)
+        return '比和';
+    if (isGenerating(elem1, elem2) || isGenerating(elem2, elem1))
+        return '相生';
+    return '相克';
+}
+/**
+ * 生成单对关系的中文描述
+ *
+ * @param name1 第一个元素名称
+ * @param elem1 第一个元素五行
+ * @param name2 第二个元素名称
+ * @param elem2 第二个元素五行
+ * @param relation 关系类型
+ * @returns 描述文本
+ */
+function buildPairDescription(name1, elem1, name2, elem2, relation) {
+    switch (relation) {
+        case '比和':
+            return `${name1}（${elem1}）与 ${name2}（${elem2}）五行相同，比和相助，能量稳定。`;
+        case '相生':
+            if (isGenerating(elem1, elem2)) {
+                return `${name1}（${elem1}）生 ${name2}（${elem2}），前者生助后者，能量流动顺畅。`;
+            }
+            return `${name2}（${elem2}）生 ${name1}（${elem1}），后者生助前者，有幕后支撑。`;
+        case '相克':
+            if (isControlling(elem1, elem2)) {
+                return `${name1}（${elem1}）克 ${name2}（${elem2}），前者克制后者，存在压制关系。`;
+            }
+            return `${name2}（${elem2}）克 ${name1}（${elem1}），后者克制前者，有反制牵制。`;
+    }
+}
+// ============================================================================
+// 5. 宫位关系综合分析
+// ============================================================================
+/**
+ * 分析单个宫位中门、星、神之间的两两五行关系
+ *
+ * 逐一计算门与星、门与神、星与神的五行生克，汇总得到宫位内部能量状态。
+ * 门星神三者的和谐程度决定了该宫位行事是否顺畅：
+ *   - 和谐：多数为相生或比和，能量协同，利于在该宫方位行事
+ *   - 有拉扯：生克参半，有助力也有阻力，需要具体分析矛盾项
+ *   - 冲突：多数为相克，矛盾突出，在该宫方位易生阻碍
+ *
+ * @param palace 宫位数据（须含 renPan.door、tianPan.star、shenPan.god）
+ * @returns 包含三对关系详情、综合等级和评分的结果对象
+ *
+ * @example
+ * ```ts
+ * const result = analyzePalaceRelations(jiuGongGe[0]);
+ * // {
+ * //   doorStar: { first: '休门', second: '天蓬', firstElement: '水', secondElement: '水', relation: '比和', description: '...' },
+ * //   harmony: '和谐',
+ * //   score: 3,
+ * //   description: '该宫门星神三者关系和谐，利于行事。'
+ * // }
+ * ```
+ */
+export function analyzePalaceRelations(palace) {
+    const door = palace.renPan.door;
+    const star = palace.tianPan.star;
+    const god = palace.shenPan.god;
+    const doorElem = getDoorElement(door);
+    const starElem = getStarElement(star);
+    const godElem = getGodElement(god);
+    // 分析三对关系
+    const doorStarRel = getWuxingRelation(doorElem, starElem);
+    const doorGodRel = getWuxingRelation(doorElem, godElem);
+    const starGodRel = getWuxingRelation(starElem, godElem);
+    // 构建配对详情
+    const doorStar = {
+        first: door,
+        second: star,
+        firstElement: doorElem,
+        secondElement: starElem,
+        relation: doorStarRel,
+        description: buildPairDescription(door, doorElem, star, starElem, doorStarRel),
+    };
+    const doorGod = {
+        first: door,
+        second: god,
+        firstElement: doorElem,
+        secondElement: godElem,
+        relation: doorGodRel,
+        description: buildPairDescription(door, doorElem, god, godElem, doorGodRel),
+    };
+    const starGod = {
+        first: star,
+        second: god,
+        firstElement: starElem,
+        secondElement: godElem,
+        relation: starGodRel,
+        description: buildPairDescription(star, starElem, god, godElem, starGodRel),
+    };
+    // 计算综合评分：比和 +1，相生 +1，相克 -1（范围 -3 ~ +3）
+    const relations = [doorStarRel, doorGodRel, starGodRel];
+    let score = 0;
+    for (const rel of relations) {
+        switch (rel) {
+            case '比和':
+            case '相生':
+                score += 1;
+                break;
+            case '相克':
+                score -= 1;
+                break;
+        }
+    }
+    // 判定和谐等级
+    let harmony;
+    if (score >= 2) {
+        harmony = '和谐';
+    }
+    else if (score <= -2) {
+        harmony = '冲突';
+    }
+    else {
+        harmony = '有拉扯';
+    }
+    // 构建综合描述
+    const description = buildOverallDescription(door, star, god, doorElem, starElem, godElem, harmony, score, relations);
+    return { doorStar, doorGod, starGod, harmony, score, description };
+}
+/**
+ * 构建宫位关系的综合描述文本
+ */
+function buildOverallDescription(door, star, god, doorElem, starElem, godElem, harmony, score, relations) {
+    const pairLabels = ['门星', '门神', '星神'];
+    const relationText = relations.map((rel, i) => `${pairLabels[i]}${rel}`).join('，');
+    switch (harmony) {
+        case '和谐':
+            return (`该宫门（${door}·${doorElem}）星（${star}·${starElem}）神（${god}·${godElem}）` +
+                `关系总体和谐（${relationText}），宫位内部能量协同，` +
+                `利于在此方位推进事项。`);
+        case '冲突':
+            return (`该宫门（${door}·${doorElem}）星（${star}·${starElem}）神（${god}·${godElem}）` +
+                `之间多有克制（${relationText}），宫位内部矛盾突出，` +
+                `易生阻碍或反复，宜谨慎行事。`);
+        case '有拉扯':
+            return (`该宫门（${door}·${doorElem}）星（${star}·${starElem}）神（${god}·${godElem}）` +
+                `关系有生有克（${relationText}），宫位能量存在拉扯，` +
+                `需结合具体用神判断吉凶。`);
+    }
+}
+// ============================================================================
+// 6. 宫位和谐总分
+// ============================================================================
+/**
+ * 获取宫位门星神三者的整体和谐评分
+ *
+ * 评分规则（-3 ~ +3，整数）：
+ *   门-星：比和 +1 | 相生 +1 | 相克 -1
+ *   门-神：比和 +1 | 相生 +1 | 相克 -1
+ *   星-神：比和 +1 | 相生 +1 | 相克 -1
+ *
+ * 分值含义：
+ *   +3 ~ +2：能量协同，吉顺
+ *   +1 ~ -1：有拉扯，需具体分析
+ *   -2 ~ -3：能量冲突，多阻碍
+ *
+ * @param palace 宫位数据（须含 renPan.door、tianPan.star、shenPan.god）
+ * @returns 和谐评分，-3（最冲突）到 +3（最和谐）
+ *
+ * @example
+ * ```ts
+ * const score = getPalaceHarmony(jiuGongGe[1]); // 返回 -1, 2, 等
+ * ```
+ */
+export function getPalaceHarmony(palace) {
+    return analyzePalaceRelations(palace).score;
+}
+//# sourceMappingURL=palace-relations.js.map

package/dist/divination/algorithms/qimen/helpers/palace-relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palace-relations.js","sourceRoot":"","sources":["../../../../../src/divination/algorithms/qimen/helpers/palace-relations.ts"],"names":[],"mappings":"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"}

package/dist/divination/algorithms/qimen/helpers/palace-utils.d.ts

@@ -0,0 +1,4 @@
+export declare function getDunJiaStem(hourGanZhi: string): string;
+export declare function getOppositePalace(palace: number): number | null;
+export declare function getDoorElement(door: string): string;
+//# sourceMappingURL=palace-utils.d.ts.map

package/dist/divination/algorithms/qimen/helpers/palace-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palace-utils.d.ts","sourceRoot":"","sources":["../../../../../src/divination/algorithms/qimen/helpers/palace-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAexD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAa/D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAanD"}

package/dist/divination/algorithms/qimen/helpers/palace-utils.js

@@ -0,0 +1,41 @@
+export function getDunJiaStem(hourGanZhi) {
+    if (!hourGanZhi.startsWith('甲')) {
+        return hourGanZhi.charAt(0);
+    }
+    const dunJiaMap = {
+        甲子: '戊',
+        甲戌: '己',
+        甲申: '庚',
+        甲午: '辛',
+        甲辰: '壬',
+        甲寅: '癸',
+    };
+    return dunJiaMap[hourGanZhi] || '戊';
+}
+export function getOppositePalace(palace) {
+    const oppositeMap = {
+        1: 9,
+        2: 8,
+        3: 7,
+        4: 6,
+        6: 4,
+        7: 3,
+        8: 2,
+        9: 1,
+    };
+    return oppositeMap[palace] || null;
+}
+export function getDoorElement(door) {
+    const doorElementMap = {
+        休门: '水',
+        生门: '土',
+        伤门: '木',
+        杜门: '木',
+        景门: '火',
+        死门: '土',
+        惊门: '金',
+        开门: '金',
+    };
+    return doorElementMap[door] || '';
+}
+//# sourceMappingURL=palace-utils.js.map

package/dist/divination/algorithms/qimen/helpers/palace-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palace-utils.js","sourceRoot":"","sources":["../../../../../src/divination/algorithms/qimen/helpers/palace-utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,SAAS,GAA2B;QACxC,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;KACR,CAAC;IAEF,OAAO,SAAS,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,WAAW,GAA2B;QAC1C,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,CAAC;KACL,CAAC;IAEF,OAAO,WAAW,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,cAAc,GAA2B;QAC7C,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;KACR,CAAC;IAEF,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;AACpC,CAAC"}

package/dist/divination/algorithms/qimen/helpers/patterns.d.ts

@@ -0,0 +1,187 @@
+/**
+ * @file 奇门遁甲模式标签与宫位洞察
+ * @description 提供奇门遁甲基础格局标签识别（伏吟、反吟、门迫、击刑、入墓、
+ * 三奇得、符使同宫、三奇得使、马星）、标签转详情、以及宫位级洞察。
+ *
+ * 古籍依据：
+ *   - 《烟波钓叟歌》：「星反吟兮门反吟，门迫宫兮事难行」
+ *   - 《烟波钓叟歌》：「击刑之处防官非，十干入墓主事迟」
+ *   - 《烟波钓叟歌》：「三奇得使最为良，符使同宫事必成」
+ *   - 《遁甲演义》：「天马方为动应之神，驿马冲则事速」
+ *
+ * @module patterns
+ */
+import type { QimenJiuGongGe } from '../../../../types/divination';
+/**
+ * 标签识别函数 getQimenPatternTags 的输入参数
+ */
+export interface QimenPatternTagParams {
+    /** 值符星名称（如 天蓬、天芮） */
+    zhiFu: string;
+    /** 值使门名称（如 休门、生门） */
+    zhiShi: string;
+    /** 值符星落宫编号（1-9） */
+    zhiFuLandingPalace: number;
+    /** 值使门落宫编号（1-9） */
+    zhiShiLandingPalace: number;
+    /** 九宫格完整数据 */
+    jiuGongGe: QimenJiuGongGe[];
+    /** 时干遁干（用于击刑/入墓判断） */
+    hourGanForFind: string;
+    /**
+     * 马星落宫编号（可选）
+     * 由调用方传入（通常为时支驿马所在宫位）。
+     * 不传或 undefined 时不输出马星标签。
+     */
+    horsePalace?: number;
+    /**
+     * 马星名称（可选，配合 horsePalace 使用）
+     * 如果不传则默认以 "驿马" 称呼。
+     */
+    horsePalaceName?: string;
+}
+/**
+ * 识别奇门遁甲基础模式标签
+ *
+ * 依次检测以下标签（每类标签可能输出0到多条）：
+ *
+ * **伏吟 / 反吟（全局层面）**
+ *   - 星伏吟：值符星落回原宫（九星原位），主事缓盘桓
+ *   - 星反吟：值符星落原宫对冲宫，主波动反复
+ *   - 门伏吟：值使门落回原宫（八门本位），主事迟待机
+ *   - 门反吟：值使门落原宫对冲宫，主突变调整
+ *
+ * **宫位层面**
+ *   - 门迫：门克宫，该宫事务易受阻
+ *   - 击刑：时干遁干落击刑宫，主压力掣肘
+ *   - 入墓：时干遁干落入墓宫，主能量被困
+ *
+ * **吉格局**
+ *   - 三奇得：乙/丙/丁在天盘显现
+ *   - 符使同宫：值符星与值使门同落一宫
+ *   - 三奇得使：乙/丙/丁临值使门所在宫
+ *   - 马星：驿马所在宫（需传入 horsePalace）
+ *
+ * @param params - 标签识别参数
+ * @returns 模式标签字符串数组
+ *
+ * @example
+ * ```ts
+ * const tags = getQimenPatternTags({
+ *   zhiFu: '天蓬',
+ *   zhiShi: '休门',
+ *   zhiFuLandingPalace: 1,
+ *   zhiShiLandingPalace: 8,
+ *   jiuGongGe,
+ *   hourGanForFind: '戊',
+ *   horsePalace: 3,
+ * });
+ * // => ['星伏吟', '三奇得（乙奇到震三宫）', '马星（驿马落震三宫）']
+ * ```
+ */
+export declare function getQimenPatternTags(params: QimenPatternTagParams): string[];
+/**
+ * 模式标签详情条目
+ */
+export interface PatternDetail {
+    /** 原始标签文本 */
+    tag: string;
+    /** 面向用户的简要解读 */
+    summary: string;
+}
+/**
+ * 将模式标签数组转换为带解读的详情对象数组
+ *
+ * 每个标签映射为 { tag, summary } 结构，方便前端直接使用。
+ *
+ * @param patternTags - 模式标签字符串数组
+ * @returns 详情对象数组
+ *
+ * @example
+ * ```ts
+ * buildPatternDetails(['星伏吟', '门迫（离九宫景门）']);
+ * // => [
+ * //   { tag: '星伏吟', summary: '九星回原位，事情多原地盘旋、推进偏慢。' },
+ * //   { tag: '门迫（离九宫景门）', summary: '门受宫克，该宫事项易受压制，行动阻力偏大。' },
+ * // ]
+ * ```
+ */
+export declare function buildPatternDetails(patternTags: string[]): PatternDetail[];
+/**
+ * 宫位洞察函数 buildPalaceInsights 的输入参数
+ */
+export interface PalaceInsightParams {
+    /** 九宫格完整数据 */
+    jiuGongGe: QimenJiuGongGe[];
+    /** 值符星名称 */
+    zhiFu: string;
+    /** 值使门名称 */
+    zhiShi: string;
+    /** 全部模式标签（用于风险类标签匹配检测） */
+    patternTags: string[];
+}
+/**
+ * 宫位洞察条目
+ */
+export interface PalaceInsight {
+    /** 宫位编号（1-9） */
+    gong: number;
+    /** 宫位中文名（如 坎一宫、离九宫） */
+    name: string;
+    /**
+     * 洞察等级：
+     *   - 有利：该宫有吉门、吉神或值使，适合行动
+     *   - 关注：该宫有值符，是全局核心观察位
+     *   - 风险：该宫有凶门、凶神或携带风险类标签
+     */
+    level: '有利' | '风险' | '关注';
+    /** 面向用户的中文解读 */
+    summary: string;
+}
+/**
+ * 生成宫位级洞察
+ *
+ * 对每个宫位，综合门、神、星和现有模式标签，给出以下三类判断：
+ *
+ * **有利（绿色）**
+ *   该宫携带值使门、吉门（开/休/生）或吉神（值符/六合/九天/太阴）。
+ *   可作为推进、求助或争取资源的优先方位。
+ *
+ * **关注（黄色）**
+ *   该宫有值符星（大值符），是局核心观察位。
+ *   代表当前事体的统领方，需重点关注此宫动静。
+ *
+ * **风险（红色）**
+ *   该宫带有门迫/击刑/入墓等风险标签，或携凶门（伤/死/惊）/凶神（白虎/玄武/螣蛇）。
+ *   行为阻滞和牵制较明显，宜谨慎行事。
+ *
+ * 注意：同一宫位可能同时属于多个等级（如有值符同时也有凶门），
+ * 此时会输出多条洞察，风险优先展示。
+ *
+ * 古籍依据：
+ *   - 《烟波钓叟歌》：「八门若遇开休生，诸事逢之总称情」
+ *   - 《烟波钓叟歌》：「伤死惊门皆凶恶，杜门无事好躲藏」
+ *   - 《遁甲演义》：「值符为八神之主，其所在宫为全局枢纽」
+ *
+ * @param args - 宫位洞察输入参数
+ * @returns 宫位洞察条目数组
+ *
+ * @example
+ * ```ts
+ * const insights = buildPalaceInsights({
+ *   jiuGongGe,
+ *   zhiFu: '天蓬',
+ *   zhiShi: '休门',
+ *   patternTags,
+ * });
+ * // 返回值示例：
+ * // [
+ * //   { gong: 1, name: '坎一宫', level: '风险',
+ * //     summary: '该宫带有门迫（坎一宫休门），行事阻滞和牵制较明显。' },
+ * //   { gong: 1, name: '坎一宫', level: '关注',
+ * //     summary: '值符落坎一宫，是当前局的核心观察位。' },
+ * // ]
+ * ```
+ */
+export declare function buildPalaceInsights(args: PalaceInsightParams): PalaceInsight[];
+//# sourceMappingURL=patterns.d.ts.map

package/dist/divination/algorithms/qimen/helpers/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../../../../src/divination/algorithms/qimen/helpers/patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAoInE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc;IACd,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAgG3E;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AA6DD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAK1E;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc;IACd,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,aAAa,EAAE,CA4E9E"}