skill-calorie 0.2.3 → 0.2.5

package/dist/diet/nutritionPort.js

@@ -0,0 +1,248 @@
+import { WATER_NAME, readGoal } from '../fetch/diet.js';
+import { sourceStats } from './productStore.js';
+import { shiftISODate } from '../analysis/utils.js';
+/* #717 批②·推荐区间归一：区间正本上移共用位 `shared/nutritionRange.ts`——诊断侧的失衡判决读同一处，
+   本件不再自己写一份区间数（从前配比页印 10-20／45-65／20-35，而诊断按另一套 15-30／40-60／20-35 判）。 */
+/* #717 批④·第 4 件：闭区间天数只读共用位正本（本件原先自写一份 `daysBetween`，名字说的是「两点差」、算的是含首末日）。 */
+import { daysIn } from '../shared/params.js';
+import { NUTRITION_RANGE } from '../shared/nutritionRange.js';
+import { CalorieRenderError } from '../render/errors.js';
+function assertRange(start, end) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(start) || !/^\d{4}-\d{2}-\d{2}$/.test(end)) {
+        throw new CalorieRenderError('bad-input', '起止日期非法: ' + start + ' ~ ' + end);
+    }
+    if (start > end)
+        throw new CalorieRenderError('bad-input', 'start 不得晚于 end');
+}
+function assertISODate(v, field) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(v)) {
+        throw new CalorieRenderError('bad-input', field + ' 非法（须 YYYY-MM-DD）：' + v);
+    }
+}
+/* #717 批④·第 4 件（闭区间天数）：本件原有一个本地 `daysBetween(start, end)`，但它算的是
+   **闭区间天数（含首末日）**——挂着「两点差」的名字算着「窗内几天」，正是规格点名的那处混淆。
+   现删掉本副本、改调共用位正本 `shared/params.ts` 的 `daysIn({start,end})`（同一个算式，同一处定义）。 */
+/** 一位小数（老 Python `round(x, 1)` 口径；本域只此一处定义）。 */
+function round1(n) {
+    return Math.round(n * 10) / 10;
+}
+/** 库里到底有没有底：**窗口为空**与**库为空**的分辨判据（`t425` 裁定 4 的 2026-09-15 澄清）。
+ *
+ *  本层的三个取数口在窗内零行时一律抛 `missing-data`（沿 G5 #100「缺失阻断不返空」）——那一条不改。
+ *  两态的分辨**由调用点做**：抛出来的若带底（别处还有记录），就是「这条词跑得通、只是这段没记」，
+ *  出完整空态页；若连底都没有，原样抛出去走 exit 4（**既有设计行为，任何票不得据裁定 4 去改它**）。
+ *
+ *  判据只看这一张表的行数在不在，不看错误文案（文案会随取数层改）。 */
+export function hasAnyDietRow(db) {
+    const row = db.prepare('SELECT COUNT(*) AS n FROM food_log').get();
+    return (row?.n ?? 0) > 0;
+}
+/** 推荐范围（旧 render_nutrition_ratio.py range 表逐字；#717 批② 起正本住 `shared/nutritionRange.ts`，
+ *  本处只把共用位的键名对齐到本视图的字段名——数值一个都不在本文件里出现）。 */
+const RATIO_RANGE = NUTRITION_RANGE;
+export function buildNutritionRatioView(db, start, end) {
+    assertRange(start, end);
+    const row = db.prepare(`SELECT COUNT(*) AS n, COALESCE(SUM(protein), 0) AS p, COALESCE(SUM(carbs), 0) AS c,
+       COALESCE(SUM(fat), 0) AS f, COALESCE(SUM(calories), 0) AS cal
+     FROM food_log WHERE date BETWEEN ? AND ? AND food_name != ?`).get(start, end, WATER_NAME);
+    if (row.n === 0)
+        throw new CalorieRenderError('missing-data', `无饮食记录：${start} ~ ${end}`);
+    const days = daysIn({ start, end });
+    const total = row.cal;
+    // 占比口径沿旧（蛋白/碳水×4、脂肪×9 除以总热量；实现差异：旧 Python round 为银行家
+    // 舍入，本层 Math.round 半值上入，pct 整数差至多 1，见证据 R5）。
+    const pPct = total > 0 ? Math.round((row.p * 4) / total * 100) : 0;
+    const cPct = total > 0 ? Math.round((row.c * 4) / total * 100) : 0;
+    const fPct = total > 0 ? Math.round((row.f * 9) / total * 100) : 0;
+    // 失衡计数沿旧（蛋白<5、碳水<30 或 >70、脂肪>40）。
+    const bad = (pPct < 5 ? 1 : 0) + (cPct < 30 || cPct > 70 ? 1 : 0) + (fPct > 40 ? 1 : 0);
+    // 目标沿新侧约定读 daily_goal id=1（fetch/diet readGoal）；无目标行即 null 不编数
+    // （旧脚本的 (120,200,60,1800) 硬编码回退不沿用，见证据 R6）。
+    const goal = readGoal(db);
+    return {
+        start,
+        end,
+        days,
+        totalCalorie: total,
+        proteinG: row.p,
+        proteinPct: pPct,
+        carbG: row.c,
+        carbPct: cPct,
+        fatG: row.f,
+        fatPct: fPct,
+        balance: bad === 0 ? 'good' : (bad <= 1 ? 'warn' : 'bad'),
+        targetProteinG: goal ? goal.protein_goal * days : null,
+        targetCarbG: goal ? goal.carbs_goal * days : null,
+        targetFatG: goal ? goal.fat_goal * days : null,
+        range: {
+            protein: { ...RATIO_RANGE.protein },
+            carb: { ...RATIO_RANGE.carb },
+            fat: { ...RATIO_RANGE.fat },
+        },
+    };
+}
+/** 固定推荐值（旧 render_nutrition_detail.py DRI 表逐字：中国居民膳食指南 2022）。
+ *
+ *  #511 · 单位从 `g`／`mg` 改成「克」／「毫克」（`.scratch/t155o/text-review-P0.md` 第 53 条：
+ *  营养素深度那张表整列是 `0g`／`540mg`／`77.1mg/天`，读者要认识英文缩写才读得懂）。
+ *  单位是上屏字，取数侧跟着读侧一起改——`nutritionPortDocs` 直接拼 `it.unit`／`it.good`，不留两处口径。 */
+const DRI = [
+    { key: 'fiber', label: '膳食纤维', unit: '克', target: 25, good: '≥25 克/天' },
+    { key: 'sodium', label: '钠', unit: '毫克', target: 2000, good: '≤2000 毫克/天' },
+    { key: 'sugar', label: '糖', unit: '克', target: 50, good: '≤50 克/天' },
+];
+export function buildNutritionDetailView(db, start, end) {
+    assertRange(start, end);
+    const meals = db.prepare('SELECT food_name, grams FROM food_log WHERE date BETWEEN ? AND ? AND food_name != ?').all(start, end, WATER_NAME);
+    if (meals.length === 0)
+        throw new CalorieRenderError('missing-data', `无饮食记录：${start} ~ ${end}`);
+    // 食品库按名称聚合（首条命中，沿旧 `lib[food][0]`；精确名匹配，不做子串——R12 收敛点）。
+    const lib = new Map();
+    const prodRows = db.prepare('SELECT product_name, dietary_fiber, sodium, sugar FROM nutrition_products WHERE is_deprecated = 0').all();
+    for (const r of prodRows) {
+        if (!lib.has(r.product_name)) {
+            lib.set(r.product_name, {
+                fiber: r.dietary_fiber ?? 0,
+                sodium: r.sodium ?? 0,
+                sugar: r.sugar ?? 0,
+            });
+        }
+    }
+    const totals = { fiber: 0, sodium: 0, sugar: 0 };
+    const missing = new Set();
+    let matched = 0;
+    for (const m of meals) {
+        const grams = Number(m.grams ?? 0);
+        const hit = lib.get(m.food_name);
+        if (!hit || !(grams > 0)) {
+            missing.add(m.food_name);
+            continue;
+        }
+        const scale = grams / 100;
+        totals.fiber += hit.fiber * scale;
+        totals.sodium += hit.sodium * scale;
+        totals.sugar += hit.sugar * scale;
+        matched += 1;
+    }
+    const days = Math.max(1, daysIn({ start, end }));
+    // 命中 0 亦渲染（缺数据盒明示，不编数）；连一餐都没有才 missing（上游已拦）。
+    const items = DRI.map((spec) => {
+        const val = round1(totals[spec.key]);
+        const avg = round1(val / days);
+        const pct = spec.target > 0 ? round1((avg / spec.target) * 100) : 0;
+        // 状态口径沿旧（三项一律 pct<=100 即 ok，含纤维；旧模板未对纤维反转，见证据 R7）。
+        return {
+            key: spec.key,
+            label: spec.label,
+            unit: spec.unit,
+            value: val,
+            avg,
+            target: spec.target,
+            pct,
+            good: spec.good,
+            status: pct <= 100 ? 'ok' : 'over',
+        };
+    });
+    return { start, end, days, items, matchedMeals: matched, missingFoods: [...missing].sort() };
+}
+export function buildSourceStatsView(db) {
+    const { stats, total } = sourceStats(db);
+    if (total === 0)
+        throw new CalorieRenderError('missing-data', '食品库为空（无来源统计）');
+    // 空串／NULL 来源归“未知”（沿旧 `src or '未知'`）；占比保留 1 位小数（沿旧 round(cnt/total*100, 1)）。
+    const items = stats.map((s) => ({
+        source: s.source === null || s.source === undefined || String(s.source) === '' ? '未知' : String(s.source),
+        count: s.count,
+        pct: total > 0 ? Math.round((s.count / total) * 1000) / 10 : 0,
+    }));
+    const merged = new Map();
+    for (const it of items) {
+        const acc = merged.get(it.source) ?? { count: 0, pct: 0 };
+        acc.count += it.count;
+        acc.pct = total > 0 ? Math.round((acc.count / total) * 1000) / 10 : 0;
+        merged.set(it.source, acc);
+    }
+    return {
+        total,
+        sources: merged.size,
+        items: [...merged.entries()]
+            .map(([source, v]) => ({ source, ...v }))
+            .sort((a, b) => b.count - a.count),
+    };
+}
+/** 周一（老 `date.weekday()`：周一＝0）。按 UTC 取星期，避开时区把日期挪一天。 */
+function mondayOf(date) {
+    const [y, m, d] = date.split('-').map(Number);
+    const weekday = new Date(Date.UTC(y, m - 1, d)).getUTCDay();
+    return shiftISODate(date, -((weekday + 6) % 7));
+}
+/** 当月 1 日（老 `today.replace(day=1)`）。 */
+function monthFirstOf(date) {
+    return date.slice(0, 7) + '-01';
+}
+function overviewPeriod(db, start, end) {
+    const days = start <= end ? daysIn({ start, end }) : 0;
+    const daily = [];
+    if (days > 0) {
+        const by = new Map();
+        const rows = db.prepare(`SELECT date, COALESCE(SUM(calories), 0) AS cal, COALESCE(SUM(protein), 0) AS pro
+         FROM food_log WHERE date BETWEEN ? AND ? AND food_name != ? GROUP BY date ORDER BY date`).all(start, end, WATER_NAME);
+        for (const r of rows)
+            by.set(String(r.date), Number(r.cal) || 0);
+        for (let i = 0; i < days; i += 1) {
+            const d = shiftISODate(start, i);
+            daily.push({ date: d, calorie: by.get(d) ?? 0 });
+        }
+        const totalCal = round1(rows.reduce((a, r) => a + (Number(r.cal) || 0), 0));
+        const totalPro = round1(rows.reduce((a, r) => a + (Number(r.pro) || 0), 0));
+        return {
+            start, end, days, loggedDays: rows.length, totalCalorie: totalCal,
+            avgCalorie: round1(totalCal / Math.max(1, days)), totalProtein: totalPro, daily,
+        };
+    }
+    return { start, end, days: 0, loggedDays: 0, totalCalorie: 0, avgCalorie: 0, totalProtein: 0, daily };
+}
+/** 饮食总览取数（服务 `calorie.view.diet` 的「看饮食总览」区块，作者＝#271）：
+ *  **不含今日**（老脚本 2026-08-01 对抗审查修复那条：今日由主页「看今日饮食概览」承接）；
+ *  **不抛 missing-data**——它是宿主页面里的一块，缺失阻断由宿主按自己的窗口做，本层给零值 ＋
+ *  `loggedDays` 让块自己出「无记录」空态（不编数）。 */
+export function buildDietOverviewView(db, date) {
+    assertISODate(date, 'date');
+    const yesterday = shiftISODate(date, -1);
+    return {
+        today: date,
+        week: overviewPeriod(db, mondayOf(date), yesterday),
+        month: overviewPeriod(db, monthFirstOf(date), yesterday),
+    };
+}
+export function buildTodayWaterView(db, date) {
+    assertISODate(date, 'date');
+    const goal = readGoal(db);
+    // 目标沿旧（water_goal 列，无行或空值即 2000；新侧 readGoal 同表同行）。
+    const targetMl = goal && goal.water_goal ? goal.water_goal : 2000;
+    const todayMl = Number(db.prepare('SELECT COALESCE(SUM(grams), 0) AS w FROM food_log WHERE date = ? AND food_name = ?').get(date, WATER_NAME).w ?? 0);
+    const cupRows = db.prepare('SELECT time, grams FROM food_log WHERE date = ? AND food_name = ? ORDER BY time').all(date, WATER_NAME);
+    // 7 天窗＝date 当天往前 6 个自然日（沿旧“含今天，最早 6 天前”；R11 收敛点：不做周一派生）。
+    const weekMl = [];
+    const weekDates = [];
+    for (let i = 6; i >= 0; i -= 1) {
+        const d = shiftISODate(date, -i);
+        const w = Number(db.prepare('SELECT COALESCE(SUM(grams), 0) AS w FROM food_log WHERE date = ? AND food_name = ?').get(d, WATER_NAME).w ?? 0);
+        weekMl.push(w);
+        weekDates.push(d);
+    }
+    if (todayMl === 0 && weekMl.every((v) => v === 0)) {
+        throw new CalorieRenderError('missing-data', `无饮水记录：${weekDates[0]} ~ ${date}`);
+    }
+    return {
+        date,
+        todayMl,
+        targetMl,
+        pct: targetMl > 0 ? Math.round((todayMl / targetMl) * 100) : 0,
+        remainMl: targetMl - todayMl,
+        cups: cupRows.map((c) => ({ time: String(c.time ?? '').slice(0, 5), ml: Number(c.grams ?? 0) })),
+        weekMl,
+        weekDates,
+    };
+}
+//# sourceMappingURL=nutritionPort.js.map

package/dist/diet/nutritionPort.js.map

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

package/dist/diet/nutritionPortDocs.d.ts

@@ -0,0 +1,106 @@
+import type { DietOverviewView, NutritionDetailView, NutritionRatioView, TodayWaterView } from './nutritionPort.js';
+/** **窗口为空**那一态的整页（裁定 4／§五 的 ⑥ 类骨架：页头 ＋ 页题 ＋ 结论句槽 ＋ 页内导航 ＋
+ *  空态块 ＋ 来源脚注 ＋ 复制区）。
+ *
+ *  两态互斥且不重叠，别把口径搅在一起：
+ *    · **窗口为空**（这条词跑得通、库里别处有记录，只是这段没记）⇒ 走本函数：完整页 ＋ 空态句 ＋
+ *      引导句（「怎么记第一条」），照样有页内导航与复制区，缺的只是读数；
+ *    · **库为空**（连取数的底都没有）⇒ 取数层原样抛 `missing-data`、`exit 4`、不落盘，
+ *      **是既有设计行为，本函数不接那一支**。
+ *  两态的分辨在调用点做（`./nutrition.ts`／`./today.ts` 用 `hasAnyDietRow(db)`），本件只负责装配。
+ *
+ *  字段面收在八个（结构纪律：一个类型的字段不多于八个）——锚点、导航文案、库文件名都是本页常量，
+ *  由本件自己定，不叫调用方填。 */
+export interface EmptyWindowDocInput {
+    /** 复制载荷的命令键（复制数据那一栏用）。 */
+    readonly key: string;
+    /** 眉标（§五 第 1 行：唤醒词 · 饮食；**不出命令键**——裁定 1）。 */
+    readonly metaLeft: string;
+    /** 页题（§五 第 2 行：页面名 ＋ 窗口／日期）。 */
+    readonly title: string;
+    /** 空态块的标题（这一块本来要出的是什么）。 */
+    readonly blockTitle: string;
+    /** 空态句（窗口内零记录这一件事，说清楚是哪一段）。 */
+    readonly emptyText: string;
+    /** 引导句（怎么记第一条）。裁定 4 要求空态句后必接一句。 */
+    readonly guide: string;
+    /** 来源脚注（普通小字行；裁定 3）。 */
+    readonly footnote: string;
+    /** 本次命令原文（复制日志第 4 段，裁定 7）。不给＝不出复制区。 */
+    readonly command?: string;
+}
+export declare function buildEmptyWindowDoc(input: EmptyWindowDocInput): string;
+/** 同源入口页的**入口标记**（两条唤醒词共用同一条命令时的页头开关）。
+ *
+ *  #511 · 两组「同源入口页」在命令面上完全同形，参数也一字不差，命令这一层分不出进来的是哪条词
+ *  （审查件第 80 条「78 与 38 逐行相同」、第 81 条「80 与 24 逐行相同」）：
+ *    · `calorie.view.nutrition-detail` ← 看营养素深度 ／ 看营养素明细；
+ *    · `calorie.view.today-water`     ← 看今日喝水 ／ 看今日饮水。
+ *  作者裁定一：两个入口都留，各自标题对上进来的那条词。做法沿 #509 的 `source:'photo'`——
+ *  由**入口自己**（`src/diet/routes.ts` 的路由记录）把标记带进命令，命令侧只拿它取页头。
+ *  标记名绝不上屏、不写库、不进 `writtenFields`；不给标记时页头与从前一字不差。 */
+export declare const ENTRY_DETAIL = "detail";
+export declare const ENTRY_DRINK = "drink";
+/** 第三组「同源入口页」的入口标记（**#271**）：`calorie.view.diet` 底下这一条命令挂着 15 条唤醒词，
+ *  其中「看饮食总览」与「看最近 7 天饮食」在参数上只差这一位⇒由入口把标记带进命令，命令侧见它
+ *  整页换总览页（本周／本月累计，都统计到昨日）。不给标记（含未知值）＝其余 8 个窗口词与 5 条餐别词
+ *  从前的行为，一字不差。标记名与 `ENTRY_DETAIL`／`ENTRY_DRINK` 同规矩：不上屏、不写库。 */
+export declare const ENTRY_OVERVIEW = "overview";
+/** 营养配比区块的开关（`buildNutritionRatioBlock` 的第二参；`#275` 微修按编排者 2026-09-15 指令加）。
+ *
+ *  一个区块里能出的东西只有一样是可选的：**末尾那一节复制区**。宿主页自己多半也有一整个复制区
+ *  （复盘页就有），两处并排既重复又难看 ⇒ 由**宿主页**决定要不要区块自带的那一节。
+ *
+ *  **两个位各守一件事，别混**：
+ *   · `copy` 只管**区块自带的那一节**；**缺省 `true`**——与 #275 交付时的行为一字不差，
+ *     老调用点（#273 的 `buildNutritionRatioBlock(ratio)`）不改也不变。宿主页自己出复制区时传 `false`。
+ *   · `command` 是**那一节**的日志第 4 段要写的本次命令原文——**不给就整节不出**（裁定 7：
+ *     不编命令原文，也不出点不动的日志按钮）。所以 `copy` 为真而 `command` 不给 ＝ 不出那一节，
+ *     不是出个半截（`copy` 为真时 `command` 是必需位）。
+ *
+ *  **整页那一支怎么用**（本件自己的先例）：`buildNutritionRatioDoc` 把命令原文**交给区块**出那一节，
+ *  自己不再另出一节 ⇒ 一张页只有一个复制区。这就是给 #273 的写法：
+ *  宿主页已有复制区就传 `copy: false`，没有就把命令原文给区块让它出。 */
+interface NutritionRatioBlockOptions {
+    /** 区块末尾要不要自带那一节复制区；缺省 `true`。宿主页自己出复制区时传 `false`。 */
+    readonly copy?: boolean;
+    /** 区块自带那一节的日志第 4 段＝本次命令原文（含 `--params`）。不给＝那一节整节不出。 */
+    readonly command?: string;
+    /** #647 · 名称栏形状开关：`true` ＝ 图例条（分布行）名称栏**只出短名**（蛋白／碳水／脂肪），
+     *  推荐范围归下面那张「推荐范围对比」表承担（该表本页恒出，范围一个字不少）；缺省 `false` ＝
+     *  老写法「蛋白（推荐 10–20%）」。
+     *
+     *  **缺省位是给老调用点留的**：`calorie.view.diet-review` 那一族（复盘 8 词，经 `diet/review.ts`）
+     *  不传这一位 ⇒ 产物逐字节不变。公共层那口窄槽（`minmax(0, 6em)`＝13px 下 78px ＋ `nowrap`）
+     *  一个字不碰——形状裁定＝短名化（#646 拍板），10 页铺开归 #648。 */
+    readonly shortNames?: boolean;
+}
+/** 营养配比区块（**服务 `calorie.view.diet-review`**，作者＝#273：「看营养结构」按老 SKILL 也出这张页，
+ *  老模板 `templates/nutrition_ratio.html`；#273 把它嵌进复盘页。本件只交付，不集成）。
+ *
+ *  宿主页里出柱／环图 ⇒ `assembleDocPage` 的 `charts` 传 `true`。
+ *
+ *  末尾那一节复制区（数据 ＋ 日志）的开关见 `NutritionRatioBlockOptions`：**缺省带**（老调用点逐字节不变），
+ *  宿主页自己出复制区时传 `{ copy: false }` 把它关掉——一张页上只该有一个复制区。 */
+export declare function buildNutritionRatioBlock(v: NutritionRatioView, opts?: NutritionRatioBlockOptions): string;
+/** 营养配比**整页**（`calorie.view.nutrition-ratio`）。`command`＝本次命令原文（复制日志第 4 段）。 */
+export declare function buildNutritionRatioDoc(v: NutritionRatioView, command?: string): string;
+/** 营养素深度区块（3 项固定推荐量逐项一行：名称＋推荐＋累计＋日均＋占比）。
+ *
+ *  #496 · 三处内部说法改人话（审查件第 51、52、54、55 条）：`DRI` 缩写、`沿旧 D5.4 口径`
+ *  版本号、「累计 vs 日均」分不清；「vs」也不是中文。列头按审查件建议写全，口径句重写一句。 */
+export declare function buildNutritionDetailBlock(v: NutritionDetailView): string;
+/** 营养素深度**整页**（`calorie.view.nutrition-detail`）。`command`＝本次命令原文（复制日志第 4 段）。 */
+export declare function buildNutritionDetailDoc(v: NutritionDetailView, entry?: string, command?: string): string;
+/** 今日饮水区块（进度环／7 天柱图／每杯明细三块，标题逐字取老实物的三个 h2）。
+ *  `name`＝这一页的正文叫法（「今日喝水」／「今日饮水」，由入口标记定，见 `ENTRY_DRINK`）。 */
+export declare function buildTodayWaterBlock(v: TodayWaterView, name: string): string;
+export declare function buildTodayWaterDoc(v: TodayWaterView, entry?: string, command?: string): string;
+/** 看饮食总览区块（**服务 `calorie.view.diet`**，作者＝#271：取数调 `buildDietOverviewView(db, date)`，
+ *  本函数只装块、不集成）。本块含柱图 ⇒ 宿主页 `assembleDocPage` 的 `charts` 传 `true`。
+ *
+ *  块内自带两个锚点 `sec-week`／`sec-month`，宿主页的页内导航（`renderTocBlock`）按这两个 id 出项。
+ *  `command`＝宿主页本次命令原文（复制日志第 4 段，裁定 7），由 #271 从自己的处理体传进来。 */
+export declare function buildDietOverviewBlock(v: DietOverviewView, command?: string): string;
+export {};
+//# sourceMappingURL=nutritionPortDocs.d.ts.map

package/dist/diet/nutritionPortDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nutritionPortDocs.d.ts","sourceRoot":"","sources":["../../src/diet/nutritionPortDocs.ts"],"names":[],"mappings":"AA2DA,OAAO,KAAK,EAEV,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACf,MAAM,oBAAoB,CAAC;AA+D5B;;;;;;;;;;;qBAWqB;AACrB,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAmBtE;AAED;;;;;;;;qDAQqD;AACrD,eAAO,MAAM,YAAY,WAAW,CAAC;AACrC,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC;;;gEAGgE;AAChE,eAAO,MAAM,cAAc,aAAa,CAAC;AAsEzC;;;;;;;;;;;;;;+CAc+C;AAC/C,UAAU,0BAA0B;IAClC,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;iDAM6C;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;wDAMwD;AACxD,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,0BAA0B,GAAG,MAAM,CA+GzG;AAED,8EAA8E;AAC9E,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAgCtF;AAiCD;;;sDAGsD;AACtD,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAwCxE;AAcD,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,mBAAmB,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAuCxG;AAkBD;6DAC6D;AAC7D,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA8D5E;AASD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAmC9F;AAyCD;;;;6DAI6D;AAC7D,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAkBpF"}