base-paint 0.3.13 → 0.3.15

package/dist/components/help/shared.js

@@ -0,0 +1,56 @@
+/** help · shared
+ *
+ *  自 `src/help.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/help.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { HELP_SHELL_ID } from '../../spec/help.js';
+import { CONTROL_STYLE_SECTIONS } from '../../spec/style.js';
+import { STYLE_PREFIX } from '../../style.js';
+export const LF = String.fromCharCode(10);
+function sectionSlug(section) {
+    return section.replace(/[A-Z]/g, (ch) => '-' + ch.toLowerCase());
+}
+/** 样式区名（`helpShell`）：**恒取 `CONTROL_STYLE_SECTIONS` 的闭集成员**——kebab 后与 `HELP_SHELL_ID`
+ *  同值者（**不自写字面量**）。闭集漂移即在此 fail-fast，不会静默改用别的命名空间。 */
+const HELP_SECTION = CONTROL_STYLE_SECTIONS.find((section) => STYLE_PREFIX + sectionSlug(section) === HELP_SHELL_ID);
+if (HELP_SECTION === undefined) {
+    throw new Error('base-paint/help：CONTROL_STYLE_SECTIONS 闭集缺与 HELP_SHELL_ID 同 kebab 的区名（'
+        + HELP_SHELL_ID + '）');
+}
+/** 类名命名空间根（`ilife-help-shell`）：由**闭集区名**派生，与根元素 id（`HELP_SHELL_ID`）同值但来源独立。 */
+export const HELP_CLASS_ROOT = STYLE_PREFIX + sectionSlug(HELP_SECTION);
+/** 类名拼装（命名空间内，不自写第二份前缀）。 */
+export function cls(suffix) {
+    return HELP_CLASS_ROOT + '-' + suffix;
+}
+/** 分组 Tab 的 radio `name`（页内唯一分组名，标签用 `for` 跨节点指向）。 */
+export const TAB_GROUP_NAME = cls('tab-group');
+/** 分组页 radio 的 id（**索引派生**：数据里的 group.id 可能重复，不得用作 HTML id）。 */
+export function tabRadioId(index) {
+    return cls('tab-' + index);
+}
+/** 关于 Tab 的 radio id。 */
+export const ABOUT_TAB_ID = cls('tab-about');
+/* ── 1. 错误形态 ────────────────────────────────────────────── */
+/** 校验失败（形态逐字对齐冻结的 `HelpSchemaErrorShape`：`{ name, code, path, message }`）。
+ *
+ * **不从 `src/index.ts` 导出**：冻结面 `SPEC_FROZEN_SURFACE` 无该运行时条目，导出会打破
+ * 「新增运行时出口恰好等于清单 implemented 的运行时项」出口面锁（与 `TemplateError`／`ControlsError` 同口径，
+ * 裁定 R13）。调用方按 `name`／`code`／`path` 判定。
+ */
+export class HelpSchemaError extends Error {
+    name = 'HelpSchemaError';
+    code;
+    /** JSON 指针式路径（根为 `/`）。 */
+    path;
+    constructor(code, path, message) {
+        super(message);
+        this.code = code;
+        this.path = path;
+    }
+}
+export function fail(code, path, message) {
+    throw new HelpSchemaError(code, path, message);
+}

package/dist/components/help/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/components/help/shared.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAA6C,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAuB,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAC1C,SAAS,WAAW,CAAC,OAA4B;IAC/C,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;sDACsD;AACtD,MAAM,YAAY,GAAG,sBAAsB,CAAC,IAAI,CAC9C,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,aAAa,CACnE,CAAC;AACF,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;IAC/B,MAAM,IAAI,KAAK,CAAC,wEAAwE;UACpF,aAAa,GAAG,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;AAExE,4BAA4B;AAC5B,MAAM,UAAU,GAAG,CAAC,MAAc;IAChC,OAAO,eAAe,GAAG,GAAG,GAAG,MAAM,CAAC;AACxC,CAAC;AAED,sDAAsD;AACtD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;AAE/C,gEAAgE;AAChE,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,yBAAyB;AACzB,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;AAE7C,+DAA+D;AAE/D;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,GAAsB,iBAAiB,CAAC;IAC5C,IAAI,CAAsB;IACnC,0BAA0B;IACjB,IAAI,CAAS;IAEtB,YAAY,IAAyB,EAAE,IAAY,EAAE,OAAe;QAClE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,IAAI,CAAC,IAAyB,EAAE,IAAY,EAAE,OAAe;IAC3E,MAAM,IAAI,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC"}

package/dist/components/help/shell.d.ts

@@ -0,0 +1,18 @@
+/** help · shell
+ *
+ *  自 `src/help.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/help.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { HelpShellInput } from '../../spec/help.js';
+import { FillTemplateOutput } from '../../spec/template.js';
+/** HELP模板渲染（冻结签名 `(input: HelpShellInput): FillTemplateOutput`）。
+ *
+ * 次序：**先校验 `sceneData`**（失败抛 `HelpSchemaError`）→ 再拼内置help模板（或 `template` 覆盖）
+ * → **一律走 `fillTemplate`**（共享资产与 JSON 载荷由填充器注入，help模板不得自填）。
+ *
+ * `strict` 原样透传给 `fillTemplate`（契约 §3.5.3「透传」）；`template` 覆盖时按调用方模板填充。
+ */
+export declare function renderHelpShell(input: HelpShellInput): FillTemplateOutput;
+//# sourceMappingURL=shell.d.ts.map

package/dist/components/help/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/components/help/shell.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAK5D;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,kBAAkB,CAYzE"}

package/dist/components/help/shell.js

@@ -0,0 +1,30 @@
+/** help · shell
+ *
+ *  自 `src/help.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/help.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { validateSceneData } from './schema.js';
+import { buildShellTemplate } from './template.js';
+import { fillTemplate } from '../../template.js';
+/* ── 6. 对外出口 ────────────────────────────────────────────── */
+/** HELP模板渲染（冻结签名 `(input: HelpShellInput): FillTemplateOutput`）。
+ *
+ * 次序：**先校验 `sceneData`**（失败抛 `HelpSchemaError`）→ 再拼内置help模板（或 `template` 覆盖）
+ * → **一律走 `fillTemplate`**（共享资产与 JSON 载荷由填充器注入，help模板不得自填）。
+ *
+ * `strict` 原样透传给 `fillTemplate`（契约 §3.5.3「透传」）；`template` 覆盖时按调用方模板填充。
+ */
+export function renderHelpShell(input) {
+    const source = input ?? {};
+    const sceneData = source.sceneData;
+    validateSceneData(sceneData);
+    const template = typeof source.template === 'string' ? source.template : buildShellTemplate(sceneData);
+    return fillTemplate({
+        template,
+        assets: source.assets,
+        data: sceneData,
+        strict: source.strict === true,
+    });
+}

package/dist/components/help/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../src/components/help/shell.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,+DAA+D;AAE/D;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAqB;IACnD,MAAM,MAAM,GAAG,KAAK,IAAK,EAAqB,CAAC;IAC/C,MAAM,SAAS,GAAY,MAAM,CAAC,SAAS,CAAC;IAC5C,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAE7B,MAAM,QAAQ,GAAG,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACvG,OAAO,YAAY,CAAC;QAClB,QAAQ;QACR,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,IAAI;KAC/B,CAAC,CAAC;AACL,CAAC"}

package/dist/components/help/template.d.ts

@@ -0,0 +1,18 @@
+/** help · template
+ *
+ *  自 `src/help.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/help.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { SceneData } from '../../spec/help.js';
+/** 内置help模板（**完整 HTML 文档**，R31）：数据页分型（`<!--INJECT-DATA-->` 恰 1 次且在自带容器内；
+ *  `<!--SHARED-CSS-->` 落在 `<head>`、`<!--SHARED-HELPERS-->` 落在 `<body>`，各恰 1；
+ *  `<!--CHARTS-HELPERS-->`／`<!--CONTENT-->` 各 0）。
+ *
+ *  完整文档而非片段：`<meta charset="utf-8">` 是含中文的 UTF-8 文件经 `file://` 打开不乱码的前提
+ *  （Windows 尤甚），速查台是独立页面（仓内各技能包的 `templates` 目录与旧
+ *  `help_template.html` 同为完整文档）。两个共享资产标记仍是**裸标记**（不得预包裹，不变量②），
+ *  包裹由 `fillTemplate` 按 `ASSET_WRAPPERS` 完成。 */
+export declare function buildShellTemplate(data: SceneData): string;
+//# sourceMappingURL=template.d.ts.map

package/dist/components/help/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../src/components/help/template.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAiB,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAiB9D;;;;;;;gDAOgD;AAChD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAuC1D"}

package/dist/components/help/template.js

@@ -0,0 +1,67 @@
+/** help · template
+ *
+ *  自 `src/help.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/help.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { attr, renderAboutPage, renderGroupPage, renderHero, renderInitBanner, renderMetaBlocks, renderTabBar, text } from './render.js';
+import { HELP_CLASS_ROOT, LF, cls } from './shared.js';
+import { HELP_SHELL_ID } from '../../spec/help.js';
+import { ASSET_WRAPPERS, CONTAINER_CHECK_RULE, TEMPLATE_MARKERS } from '../../spec/template.js';
+/* ── 5. 内置help模板（**非导出**，裁定 R13；可经 `HelpShellInput.template` 覆盖） ── */
+/** payload 容器开标签：标签名恒取 `ASSET_WRAPPERS`，`id`／`type` 恒取 `CONTAINER_CHECK_RULE`
+ *  （容器校验规则的 `id`／`type` 与 `DEFAULT_DATA_SCRIPT_ID`／`DATA_SCRIPT_TYPE` 同值，不写第二份字面量）。 */
+const DATA_SCRIPT_OPEN = ASSET_WRAPPERS.sharedHelpersJs.openTag.slice(0, -1)
+    + ' id="' + CONTAINER_CHECK_RULE.id + '" type="' + CONTAINER_CHECK_RULE.type + '">';
+const DATA_SCRIPT_CLOSE = ASSET_WRAPPERS.sharedHelpersJs.closeTag;
+/** 文档 `<title>`：`title · skill_name`（两者均经 `escapeHtml`，R31）。
+ *  `title` 是必填非空字段（`minLength: 1`），`skill_name` 同；拼串使两个字段都有可观察效果。 */
+function documentTitle(data) {
+    return data.title + ' · ' + data.skill_name;
+}
+/** 内置help模板（**完整 HTML 文档**，R31）：数据页分型（`<!--INJECT-DATA-->` 恰 1 次且在自带容器内；
+ *  `<!--SHARED-CSS-->` 落在 `<head>`、`<!--SHARED-HELPERS-->` 落在 `<body>`，各恰 1；
+ *  `<!--CHARTS-HELPERS-->`／`<!--CONTENT-->` 各 0）。
+ *
+ *  完整文档而非片段：`<meta charset="utf-8">` 是含中文的 UTF-8 文件经 `file://` 打开不乱码的前提
+ *  （Windows 尤甚），速查台是独立页面（仓内各技能包的 `templates` 目录与旧
+ *  `help_template.html` 同为完整文档）。两个共享资产标记仍是**裸标记**（不得预包裹，不变量②），
+ *  包裹由 `fillTemplate` 按 `ASSET_WRAPPERS` 完成。 */
+export function buildShellTemplate(data) {
+    const groups = data.groups;
+    const sceneCount = groups.reduce((total, group) => total + group.subgroups.reduce((sub, item) => sub + item.scenes.length, 0), 0);
+    const hasGroupPage = groups.length > 0;
+    const parts = [];
+    parts.push('<!DOCTYPE html>');
+    parts.push('<html lang="zh-CN">');
+    parts.push('<head>');
+    parts.push('<meta charset="utf-8">');
+    parts.push('<meta name="viewport" content="width=device-width, initial-scale=1">');
+    parts.push('<title>' + text(documentTitle(data)) + '</title>');
+    parts.push(TEMPLATE_MARKERS.sharedCss); // 裸标记：填充器包成 <style>（落在 <head> 内）
+    parts.push('</head>');
+    parts.push('<body>');
+    parts.push('<section class="' + HELP_CLASS_ROOT + '"' + attr('id', HELP_SHELL_ID) + '>');
+    parts.push(renderHero(data, sceneCount));
+    if (data.init_banner !== undefined)
+        parts.push(renderInitBanner(data.init_banner));
+    parts.push(renderTabBar(groups));
+    parts.push('<div class="' + cls('pages') + '">');
+    groups.forEach((group, index) => {
+        parts.push(renderGroupPage(data, group, index, index === 0));
+    });
+    parts.push(renderAboutPage(data, !hasGroupPage));
+    parts.push('</div>');
+    const metaBlocks = data.meta_blocks ?? [];
+    if (metaBlocks.length > 0) {
+        parts.push('<div class="' + cls('meta') + '">' + renderMetaBlocks(metaBlocks) + '</div>');
+    }
+    parts.push('</section>');
+    // 载荷容器（自带；填充器只替换标记文本，不补写标签）+ 共享 helpers 标记（**裸标记**，不得预包裹）。
+    parts.push(DATA_SCRIPT_OPEN + TEMPLATE_MARKERS.injectData + DATA_SCRIPT_CLOSE);
+    parts.push(TEMPLATE_MARKERS.sharedHelpers);
+    parts.push('</body>');
+    parts.push('</html>');
+    return parts.join(LF);
+}

package/dist/components/help/template.js.map

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

package/dist/components/hour-band/attrs.d.ts

@@ -0,0 +1,96 @@
+/** hour-band · **标记契约**（渲染与调用方共用的唯一事实：类名／形态闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-05-时间与分组.mjs`）里的
+ *  **形态 A「单带＋整点刻度尺（0–23）＋下方明细行」**：一天 24 小时摊成**一条带**，
+ *  哪几段在做什么、每段多长一眼看得出；下面逐段列明细行。
+ *
+ *  它替掉的三种错法：
+ *   · 用一句摘要说"今天很忙"——读不出哪几段忙、忙了多久；
+ *   · 把一天写成 24 行"每小时记了多少分钟"——那是**复盘**的形状（住 `packages/skill-schedule` 的本地件
+ *     `renderHourBand`），不是"一段时间在做什么"的概览；
+ *   · 只画带的形状不给起止——带上的段读得出长度，读不出"从几点到几点"（明细行补这一半）。
+ *
+ *  **与 `packages/skill-schedule/src/shared/pageParts.ts` 的本地件 `renderHourBand` 的关系**（要写清的 `dup`）：
+ *  那个本地件画的是 **24 根柱子**（柱高＝该小时已记录的分钟数、柱色＝该小时主键、空数组出空串），
+ *  问的是"每小时记了多少"；本件画的是 **一条带上的若干区间**，问的是"几段时间在做什么"。
+ *  两者概念相邻、结构不同（柱 vs 带），且那个件**不在公共层**（住在技能包里）——
+ *  本件落地**不替代**它：复盘柱状图仍归技能包自己的形状，概览带收上来当公共件。
+ *
+ *  形态键写在 `HOUR_BAND_FORMS`（闭集）：本件只有一格，但键必须存在——
+ *  「形态是骨架，不是地址」，日后加第二形态是在闭集里加一格，不是新开一件。
+ */
+/** 本件的类名根：全部槽位类名都是 `HOUR_BAND_CLASS + '-' + 槽名`。 */
+export declare const HOUR_BAND_CLASS = "ilife-block-hour-band";
+/** 槽位闭集（标记契约的一部分：`render.ts` 与判据都用这里的名字拼类名，不各抄一份字面量）。 */
+export declare const HOUR_BAND_SLOTS: readonly ["hd", "title", "use", "sum", "sum-label", "sum-value", "band", "sg", "sg-text", "ruler", "ruler-hour", "lgs", "sw", "rows", "r", "t", "n", "v", "meta", "note"];
+export type HourBandSlot = (typeof HOUR_BAND_SLOTS)[number];
+/** 槽类的类名（唯一拼法：别处不许再写 `HOUR_BAND_CLASS + '-' + …`）。 */
+export declare function hourBandSlot(slot: HourBandSlot, prefix?: string): string;
+/** 形态闭集：本件只落地了形态 A「单带＋整点刻度尺＋下方明细行」。 */
+export declare const HOUR_BAND_FORMS: readonly ["band"];
+export type HourBandForm = (typeof HOUR_BAND_FORMS)[number];
+/** 深浅档闭集（1 最浅、4 最深）：时段是**非文本**色块，用强调色的四档。 */
+export declare const HOUR_BAND_TONES: readonly [1, 2, 3, 4];
+export type HourBandTone = (typeof HOUR_BAND_TONES)[number];
+/** 时段的缺省深浅档。 */
+export declare const HOUR_BAND_DEFAULT_TONE: HourBandTone;
+/** 一天有多少分钟：**本件的轴长**（时刻一律用"当天第几分钟"当机器值）。 */
+export declare const HOUR_BAND_MINUTES_PER_DAY = 1440;
+/** 刻度尺上有几个整点（0..23）。 */
+export declare const HOUR_BAND_HOURS = 24;
+/** **段内时长字上屏的最小占比**：段窄于轴全长的这个比例时，带上不写时长字
+ *  （写了必然挤成一团或被裁），时长仍由明细行的读数给出——语义一个字都不丢。 */
+export declare const HOUR_BAND_TEXT_MIN_FRACTION = 0.2;
+/** 窄容器阈值（px）：整点刻度尺只留偶数点（每 2 小时一格）。
+ *  **这是本件自己的宽度**（`@container` 判的），不是视口宽度。 */
+export declare const HOUR_BAND_RULER_NARROW_PX = 700;
+/** 未记录那一行的写法：`— ／ 其余时间未记录 ／ 时长`（缺值一律 `—`）。 */
+export declare const HOUR_BAND_UNRECORDED_LABEL = "\u5176\u4F59\u65F6\u95F4\u672A\u8BB0\u5F55";
+export declare const HOUR_BAND_MISSING = "\u2014";
+/** 一段时间在做什么（时刻＝当天第几分钟，0..1440）。 */
+export interface HourBandIntervalInput {
+    /** 起点（当天第几分钟，闭区间）。 */
+    readonly from: number;
+    /** 终点（当天第几分钟；必须大于起点）。 */
+    readonly to: number;
+    /** 这一段在做什么（如「工作 · 上午」）。 */
+    readonly label: string;
+    /** 深浅档（1..4，缺省 2）。 */
+    readonly tone?: HourBandTone;
+    /** 行末的补充读数（如 `320 kcal`）；不给＝不出。 */
+    readonly meta?: string;
+}
+/** 图例的一条（时段色 ↔ 类别名）。 */
+export interface HourBandLegendItem {
+    /** 色块对应的档（1..4）。 */
+    readonly tone: HourBandTone;
+    /** 色块的说明（如「工作」）。 */
+    readonly label: string;
+}
+/** 头部右端的合计位。 */
+export interface HourBandSummary {
+    /** 标签（如「已记录」）。 */
+    readonly label: string;
+    /** 值（如 `19h40m`）。 */
+    readonly value: string;
+}
+/** 时段带入参。`title` 与 `intervals` 必填——**没有时段就不走本件**（本件只有形态 A 一种骨架）。 */
+export interface HourBandInput {
+    /** 标题（如「5 月 14 日 周四」）；**不许 `…` 截断**，长了就换行。 */
+    readonly title: string;
+    /** 时段（顺序＝阅读顺序；**跨午夜请调用方拆成两段**：本件不做跨界推断）。0 条＝空串。 */
+    readonly intervals: readonly HourBandIntervalInput[];
+    /** 用途说明（如「作息管家 · 全天概览」）；不给＝不出。 */
+    readonly use?: string;
+    /** 头部右端的合计位；不给＝不出。 */
+    readonly summary?: HourBandSummary;
+    /** 深浅图例（0 条＝不出）。 */
+    readonly legend?: readonly HourBandLegendItem[];
+    /** 脚注；不给＝不出。 */
+    readonly note?: string;
+    /** 形态键（闭集，缺省 `band`）。 */
+    readonly form?: HourBandForm;
+    /** 附加类名（空格分隔；逐个过类名正则）。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

package/dist/components/hour-band/attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../../src/components/hour-band/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,oDAAoD;AACpD,eAAO,MAAM,eAAe,0BAA0B,CAAC;AAEvD,yDAAyD;AACzD,eAAO,MAAM,eAAe,2KAyClB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,SAAW,GAAG,MAAM,CAE1E;AAED,uCAAuC;AACvC,eAAO,MAAM,eAAe,mBAAoB,CAAC;AACjD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,6CAA6C;AAC7C,eAAO,MAAM,eAAe,uBAAwB,CAAC;AACrD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,gBAAgB;AAChB,eAAO,MAAM,sBAAsB,EAAE,YAAgB,CAAC;AAEtD,4CAA4C;AAC5C,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,wBAAwB;AACxB,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;4CAC4C;AAC5C,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C;6CAC6C;AAC7C,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,8CAA8C;AAC9C,eAAO,MAAM,0BAA0B,+CAAY,CAAC;AACpD,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAE1C,mCAAmC;AACnC,MAAM,WAAW,qBAAqB;IACpC,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,mCAAmC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAwB;AACxB,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,oBAAoB;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACrD,kCAAkC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,sBAAsB;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,oBAAoB;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAChD,gBAAgB;IAChB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,yBAAyB;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/components/hour-band/attrs.js

@@ -0,0 +1,89 @@
+/** hour-band · **标记契约**（渲染与调用方共用的唯一事实：类名／形态闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-05-时间与分组.mjs`）里的
+ *  **形态 A「单带＋整点刻度尺（0–23）＋下方明细行」**：一天 24 小时摊成**一条带**，
+ *  哪几段在做什么、每段多长一眼看得出；下面逐段列明细行。
+ *
+ *  它替掉的三种错法：
+ *   · 用一句摘要说"今天很忙"——读不出哪几段忙、忙了多久；
+ *   · 把一天写成 24 行"每小时记了多少分钟"——那是**复盘**的形状（住 `packages/skill-schedule` 的本地件
+ *     `renderHourBand`），不是"一段时间在做什么"的概览；
+ *   · 只画带的形状不给起止——带上的段读得出长度，读不出"从几点到几点"（明细行补这一半）。
+ *
+ *  **与 `packages/skill-schedule/src/shared/pageParts.ts` 的本地件 `renderHourBand` 的关系**（要写清的 `dup`）：
+ *  那个本地件画的是 **24 根柱子**（柱高＝该小时已记录的分钟数、柱色＝该小时主键、空数组出空串），
+ *  问的是"每小时记了多少"；本件画的是 **一条带上的若干区间**，问的是"几段时间在做什么"。
+ *  两者概念相邻、结构不同（柱 vs 带），且那个件**不在公共层**（住在技能包里）——
+ *  本件落地**不替代**它：复盘柱状图仍归技能包自己的形状，概览带收上来当公共件。
+ *
+ *  形态键写在 `HOUR_BAND_FORMS`（闭集）：本件只有一格，但键必须存在——
+ *  「形态是骨架，不是地址」，日后加第二形态是在闭集里加一格，不是新开一件。
+ */
+/** 本件的类名根：全部槽位类名都是 `HOUR_BAND_CLASS + '-' + 槽名`。 */
+export const HOUR_BAND_CLASS = 'ilife-block-hour-band';
+/** 槽位闭集（标记契约的一部分：`render.ts` 与判据都用这里的名字拼类名，不各抄一份字面量）。 */
+export const HOUR_BAND_SLOTS = [
+    /** 头部那一排：标题 ＋ 用途 ＋ 合计（窄档自己折行）。 */
+    'hd',
+    /** 标题（如「5 月 14 日 周四」）。 */
+    'title',
+    /** 用途说明（如「作息管家 · 全天概览」）。 */
+    'use',
+    /** 头部右端的合计位。 */
+    'sum',
+    /** 合计位的标签（如「已记录」）。 */
+    'sum-label',
+    /** 合计位的值（已经是给人看的样子）。 */
+    'sum-value',
+    /** 那条 24 小时的带（纯形状，`aria-hidden`：语义在明细行里）。 */
+    'band',
+    /** 带上的一个时段（位置与长度就是它的起止与时长）。 */
+    'sg',
+    /** 时段里那枚时长字（**只在段够宽时才上屏**；时长永远另有明细行的读数兜底）。 */
+    'sg-text',
+    /** 整点刻度尺（24 格，`aria-hidden`：轴线不是读数）。 */
+    'ruler',
+    /** 刻度尺上的一格（0..23；窄档只留偶数点）。 */
+    'ruler-hour',
+    /** 深浅图例那一排（时段色 ↔ 类别名）。 */
+    'lgs',
+    /** 图例里的色块。 */
+    'sw',
+    /** 明细行区（逐段一行：起止／名称／时长／补充读数）。 */
+    'rows',
+    /** 一条明细行。 */
+    'r',
+    /** 起止时间（`HH:MM – HH:MM`；未记录那一行写 `—`）。 */
+    't',
+    /** 这一段在做什么。 */
+    'n',
+    /** 时长（**读得出"多久"**）。 */
+    'v',
+    /** 补充读数（如 `320 kcal`）；不给＝不出。 */
+    'meta',
+    /** 脚注（弱文字，可很长、必须能换行）。 */
+    'note',
+];
+/** 槽类的类名（唯一拼法：别处不许再写 `HOUR_BAND_CLASS + '-' + …`）。 */
+export function hourBandSlot(slot, prefix = 'ilife-') {
+    return prefix + 'block-hour-band-' + slot;
+}
+/** 形态闭集：本件只落地了形态 A「单带＋整点刻度尺＋下方明细行」。 */
+export const HOUR_BAND_FORMS = ['band'];
+/** 深浅档闭集（1 最浅、4 最深）：时段是**非文本**色块，用强调色的四档。 */
+export const HOUR_BAND_TONES = [1, 2, 3, 4];
+/** 时段的缺省深浅档。 */
+export const HOUR_BAND_DEFAULT_TONE = 2;
+/** 一天有多少分钟：**本件的轴长**（时刻一律用"当天第几分钟"当机器值）。 */
+export const HOUR_BAND_MINUTES_PER_DAY = 1440;
+/** 刻度尺上有几个整点（0..23）。 */
+export const HOUR_BAND_HOURS = 24;
+/** **段内时长字上屏的最小占比**：段窄于轴全长的这个比例时，带上不写时长字
+ *  （写了必然挤成一团或被裁），时长仍由明细行的读数给出——语义一个字都不丢。 */
+export const HOUR_BAND_TEXT_MIN_FRACTION = 0.2;
+/** 窄容器阈值（px）：整点刻度尺只留偶数点（每 2 小时一格）。
+ *  **这是本件自己的宽度**（`@container` 判的），不是视口宽度。 */
+export const HOUR_BAND_RULER_NARROW_PX = 700;
+/** 未记录那一行的写法：`— ／ 其余时间未记录 ／ 时长`（缺值一律 `—`）。 */
+export const HOUR_BAND_UNRECORDED_LABEL = '其余时间未记录';
+export const HOUR_BAND_MISSING = '\u2014';

package/dist/components/hour-band/attrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.js","sourceRoot":"","sources":["../../../src/components/hour-band/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEvD,yDAAyD;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,kCAAkC;IAClC,IAAI;IACJ,0BAA0B;IAC1B,OAAO;IACP,4BAA4B;IAC5B,KAAK;IACL,gBAAgB;IAChB,KAAK;IACL,sBAAsB;IACtB,WAAW;IACX,wBAAwB;IACxB,WAAW;IACX,6CAA6C;IAC7C,MAAM;IACN,+BAA+B;IAC/B,IAAI;IACJ,8CAA8C;IAC9C,SAAS;IACT,wCAAwC;IACxC,OAAO;IACP,8BAA8B;IAC9B,YAAY;IACZ,0BAA0B;IAC1B,KAAK;IACL,cAAc;IACd,IAAI;IACJ,gCAAgC;IAChC,MAAM;IACN,aAAa;IACb,GAAG;IACH,yCAAyC;IACzC,GAAG;IACH,eAAe;IACf,GAAG;IACH,uBAAuB;IACvB,GAAG;IACH,gCAAgC;IAChC,MAAM;IACN,yBAAyB;IACzB,MAAM;CACE,CAAC;AAGX,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAC,IAAkB,EAAE,MAAM,GAAG,QAAQ;IAChE,OAAO,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAAC;AAC5C,CAAC;AAED,uCAAuC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,CAAU,CAAC;AAGjD,6CAA6C;AAC7C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,CAAC;AAGrD,gBAAgB;AAChB,MAAM,CAAC,MAAM,sBAAsB,GAAiB,CAAC,CAAC;AAEtD,4CAA4C;AAC5C,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAE9C,wBAAwB;AACxB,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC;4CAC4C;AAC5C,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAE/C;6CAC6C;AAC7C,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C,8CAA8C;AAC9C,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,CAAC;AACpD,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC"}

package/dist/components/hour-band/index.d.ts

@@ -0,0 +1,17 @@
+/** hour-band · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  三件出口：`renderHourBand(input)`（产标记，零 DOM）／`hourBandCss()`（样式段）／
+ *  标记契约常量（类名根、槽位闭集、形态闭集、深浅档闭集、轴长与"段内时长字"的阈值）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ *  样式由页面按需注入 `hourBandCss()`（**加法式**：不挂就零命中，别的页逐字节不变）。
+ *
+ *  **与 `packages/skill-schedule` 的本地件 `renderHourBand` 不是同一个东西**：那个画 24 根柱子
+ *  （每小时记了多少分钟），本件画一条带上的若干区间（几段时间在做什么）；两者都在，互不替代。
+ */
+export { HOUR_BAND_CLASS, HOUR_BAND_DEFAULT_TONE, HOUR_BAND_FORMS, HOUR_BAND_HOURS, HOUR_BAND_MINUTES_PER_DAY, HOUR_BAND_MISSING, HOUR_BAND_RULER_NARROW_PX, HOUR_BAND_SLOTS, HOUR_BAND_TEXT_MIN_FRACTION, HOUR_BAND_TONES, HOUR_BAND_UNRECORDED_LABEL, hourBandSlot, } from './attrs.js';
+export type { HourBandForm, HourBandInput, HourBandIntervalInput, HourBandLegendItem, HourBandSlot, HourBandSummary, HourBandTone, } from './attrs.js';
+export { renderHourBand } from './render.js';
+export { HOUR_BAND_HEIGHT_PX, HOUR_BAND_RULER_FONT_PX, hourBandCss, } from './style.js';
+export { hourBandClock, hourBandDuration, hourBandPercent } from './model.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/hour-band/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/hour-band/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,2BAA2B,EAC3B,eAAe,EACf,0BAA0B,EAC1B,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/hour-band/index.js

@@ -0,0 +1,15 @@
+/** hour-band · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  三件出口：`renderHourBand(input)`（产标记，零 DOM）／`hourBandCss()`（样式段）／
+ *  标记契约常量（类名根、槽位闭集、形态闭集、深浅档闭集、轴长与"段内时长字"的阈值）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ *  样式由页面按需注入 `hourBandCss()`（**加法式**：不挂就零命中，别的页逐字节不变）。
+ *
+ *  **与 `packages/skill-schedule` 的本地件 `renderHourBand` 不是同一个东西**：那个画 24 根柱子
+ *  （每小时记了多少分钟），本件画一条带上的若干区间（几段时间在做什么）；两者都在，互不替代。
+ */
+export { HOUR_BAND_CLASS, HOUR_BAND_DEFAULT_TONE, HOUR_BAND_FORMS, HOUR_BAND_HOURS, HOUR_BAND_MINUTES_PER_DAY, HOUR_BAND_MISSING, HOUR_BAND_RULER_NARROW_PX, HOUR_BAND_SLOTS, HOUR_BAND_TEXT_MIN_FRACTION, HOUR_BAND_TONES, HOUR_BAND_UNRECORDED_LABEL, hourBandSlot, } from './attrs.js';
+export { renderHourBand } from './render.js';
+export { HOUR_BAND_HEIGHT_PX, HOUR_BAND_RULER_FONT_PX, hourBandCss, } from './style.js';
+export { hourBandClock, hourBandDuration, hourBandPercent } from './model.js';

package/dist/components/hour-band/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/hour-band/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,2BAA2B,EAC3B,eAAe,EACf,0BAA0B,EAC1B,YAAY,GACb,MAAM,YAAY,CAAC;AAUpB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/hour-band/model.d.ts

@@ -0,0 +1,51 @@
+import { type HourBandForm, type HourBandTone } from './attrs.js';
+/** 归一后的一个时段（`left`／`width` 已是上屏的百分比串）。 */
+export interface HourBandIntervalModel {
+    readonly from: number;
+    readonly to: number;
+    readonly label: string;
+    readonly tone: HourBandTone;
+    readonly meta?: string;
+    /** 轴上的起点（百分比）。 */
+    readonly left: number;
+    /** 轴上的长度（百分比）。 */
+    readonly width: number;
+    /** 时长读数（如 `6h40m`）。 */
+    readonly duration: string;
+    /** 起止读数（如 `00:00 – 06:40`）。 */
+    readonly clock: string;
+    /** 带上那枚时长字：**只在段够宽时**才有值（否则 `undefined`）。 */
+    readonly bandText?: string;
+}
+/** 内部类型：每个字段都已校验、已归一（`undefined` 一律换成「不给」或空数组）。 */
+export interface HourBandModel {
+    readonly form: HourBandForm;
+    readonly title: string;
+    readonly use?: string;
+    readonly summary?: {
+        readonly label: string;
+        readonly value: string;
+    };
+    readonly intervals: readonly HourBandIntervalModel[];
+    readonly legend: readonly {
+        readonly tone: HourBandTone;
+        readonly label: string;
+    }[];
+    /** 带上没盖到的分钟数（0 ＝ 一天被时段盖满）。 */
+    readonly unrecordedMinutes: number;
+    /** 未记录那一行的时长读数（`unrecordedMinutes` 为 0 时是空串）。 */
+    readonly unrecordedText: string;
+    readonly note?: string;
+    readonly extraClass?: string;
+}
+/** 当天第几分钟 → 轴上的百分比（**几何是形状事实**：渲染只读它，判据也读它）。
+ *  口径与 `range-bar` 的 `rangeBarPercent` 同一条：**百分比**（0..100）四舍五入到 4 位小数。
+ *  （2026-09 现场：这里曾漏乘 100，段被画成 0.2778% 的发丝——判据正是量它才抓住的。） */
+export declare function hourBandPercent(minute: number): string;
+/** 分钟 → 时长读数（`50m`／`6h40m`／`24h00m`）。**口径只在这里写一遍**。 */
+export declare function hourBandDuration(minutes: number): string;
+/** 分钟 → 钟点读数（`00:00`／`06:40`／`24:00`）。 */
+export declare function hourBandClock(minutes: number): string;
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `HourBandModel`，不再自己碰 `any`。 */
+export declare function normalizeHourBand(input: unknown): HourBandModel;
+//# sourceMappingURL=model.d.ts.map

package/dist/components/hour-band/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/hour-band/model.ts"],"names":[],"mappings":"AAWA,OAAO,EAML,KAAK,YAAY,EAEjB,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAEpB,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,QAAQ,CAAC,SAAS,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpF,8BAA8B;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,iDAAiD;IACjD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;2DAE2D;AAC3D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED,0CAA0C;AAC1C,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKrD;AA4FD,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAwB/D"}