base-paint 0.3.13 → 0.3.15

package/dist/components/photo-grid/model.d.ts

@@ -0,0 +1,35 @@
+import { type PhotoGridForm, type PhotoGridRatio } from './attrs.js';
+/** 归一化后的一格。 */
+export interface PhotoGridItemModel {
+    readonly src?: string;
+    readonly alt: string;
+    readonly date?: string;
+    readonly caption?: string;
+    /** 张数角标上的字（「3 张」）；不到下限时 `undefined`。 */
+    readonly stackText?: string;
+    readonly size?: string;
+}
+/** 归一化后的一个月（不按月分组时整页只有一组，`month` 为 `undefined`）。 */
+export interface PhotoGridGroupModel {
+    readonly month?: string;
+    readonly note?: string;
+    readonly photos: readonly PhotoGridItemModel[];
+    /** 组头计数（「3 天 · 6 张」；没有日期时写「6 张」）。 */
+    readonly countText: string;
+}
+/** 归一化后的入参。 */
+export interface PhotoGridModel {
+    readonly form: PhotoGridForm;
+    readonly groups: readonly PhotoGridGroupModel[];
+    readonly ratio: PhotoGridRatio;
+    readonly add: boolean;
+    readonly addLabel?: string;
+    readonly addHint?: string;
+    readonly note: readonly string[];
+    /** 一格照片都没有（平铺时是 `photos: []`，分组时是每组都空）。 */
+    readonly total: number;
+    readonly extraClass?: string;
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `PhotoGridModel`。 */
+export declare function normalizePhotoGrid(input: unknown): PhotoGridModel;
+//# sourceMappingURL=model.d.ts.map

package/dist/components/photo-grid/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/photo-grid/model.ts"],"names":[],"mappings":"AASA,OAAO,EAIL,KAAK,aAAa,EAGlB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB,eAAe;AACf,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC/C,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,eAAe;AACf,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAgED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CA+CjE"}

package/dist/components/photo-grid/model.js

@@ -0,0 +1,123 @@
+/** photo-grid · **入参归一化与校验**（把 `any` 与说不出的 `unknown` 挡在门外，产出内部类型）。
+ *
+ *  三条口径：
+ *   1. **非法入参一律 `badInput()`**（抛 `BlocksError`）——不静默降级；
+ *   2. **`photos` 与 `groups` 恰好给一个**：两个都给＝说不清按不按月分；两个都不给＝说不清这一页有没有照片；
+ *   3. **算得出来的都不许调用方再给**：组头的「几天 · 几张」、脚注的「共 N 张」、
+ *      「这张是几张叠着」的角标下限，都是本件算的。
+ */
+import { assertPlainObject, badInput, optExtraClass, optText, reqText } from '../shared/validate.js';
+import { PHOTO_GRID_FORMS, PHOTO_GRID_MIN_STACK, PHOTO_GRID_RATIOS, } from './attrs.js';
+/** 一格里「几张叠着」：正整数，且 `>= PHOTO_GRID_MIN_STACK` 才值得出角标。 */
+function itemModel(value, field) {
+    assertPlainObject(value, field);
+    const raw = value;
+    const alt = reqText(raw.alt, field + '.alt');
+    const src = optText(raw.src, field + '.src');
+    const countGiven = raw.count;
+    let stackText;
+    if (countGiven !== undefined) {
+        if (typeof countGiven !== 'number' || !Number.isInteger(countGiven) || countGiven < 1) {
+            badInput(field + '.count 必须是 >= 1 的整数（这一格是几张叠着）');
+        }
+        if (countGiven >= PHOTO_GRID_MIN_STACK)
+            stackText = String(countGiven) + ' 张';
+    }
+    return {
+        src,
+        alt,
+        date: optText(raw.date, field + '.date'),
+        caption: optText(raw.caption, field + '.caption'),
+        stackText,
+        size: optText(raw.size, field + '.size'),
+    };
+}
+/** 一组：月份（可缺，平铺时缺）＋ 这一组的格。组头计数由本件算。 */
+function groupModel(value, field, withMonth) {
+    assertPlainObject(value, field);
+    const raw = value;
+    const month = withMonth
+        ? reqText(raw.month, field + '.month')
+        : optText(raw.month, field + '.month');
+    const given = raw.photos;
+    if (!Array.isArray(given))
+        badInput(field + '.photos 必须是数组');
+    const photos = given.map((p, i) => itemModel(p, field + '.photos[' + i + ']'));
+    /* 「几天」＝题注条上出现过的**不同日期**个数（不解析日期本身，标了几个不同的日子就是几天）。 */
+    const days = new Set();
+    for (const p of photos)
+        if (p.date !== undefined)
+            days.add(p.date);
+    const countText = (days.size > 0 ? String(days.size) + ' 天 · ' : '') + String(photos.length) + ' 张';
+    return {
+        month,
+        note: optText(raw.note, field + '.note'),
+        photos,
+        countText,
+    };
+}
+/** 串或串数组 → 段数组（与 `page-head` 同口径）。 */
+function textList(value, field) {
+    if (value === undefined)
+        return [];
+    if (typeof value === 'string') {
+        const one = optText(value, field);
+        return one === undefined ? [] : [one];
+    }
+    if (!Array.isArray(value))
+        badInput(field + ' 必须是字符串，或字符串数组（逐段一枚）');
+    const out = [];
+    for (let i = 0; i < value.length; i += 1) {
+        const one = optText(value[i], field + '[' + i + ']');
+        if (one !== undefined)
+            out.push(one);
+    }
+    return out;
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `PhotoGridModel`。 */
+export function normalizePhotoGrid(input) {
+    assertPlainObject(input, 'renderPhotoGrid: input');
+    const raw = input;
+    const form = raw.form === undefined ? PHOTO_GRID_FORMS[0] : raw.form;
+    if (!PHOTO_GRID_FORMS.includes(form)) {
+        badInput('photo-grid: input.form 必须是 ' + PHOTO_GRID_FORMS.join('／') + ' 之一（本件只落地形态 A「网格 ＋ 加一张」）');
+    }
+    const hasPhotos = raw.photos !== undefined;
+    const hasGroups = raw.groups !== undefined;
+    if (hasPhotos === hasGroups) {
+        badInput('photo-grid: input.photos 与 input.groups 恰好给一个'
+            + (hasPhotos ? '（两个都给了：说不清这一页按不按月分）' : '（都没给：说不清这一页有没有照片）'));
+    }
+    let groups;
+    if (hasGroups) {
+        const given = raw.groups;
+        if (!Array.isArray(given))
+            badInput('photo-grid: input.groups 必须是数组');
+        groups = given.map((g, i) => groupModel(g, 'photo-grid: input.groups[' + i + ']', true));
+    }
+    else {
+        const given = raw.photos;
+        if (!Array.isArray(given))
+            badInput('photo-grid: input.photos 必须是数组');
+        /* 平铺也是一组（只是没有月份）：出标记时两条路合成一段代码，两种形态的字面差别就只剩组头。 */
+        groups = [groupModel({ photos: given }, 'photo-grid: input.photos', false)];
+    }
+    const ratioGiven = raw.ratio;
+    if (ratioGiven !== undefined && !PHOTO_GRID_RATIOS.includes(ratioGiven)) {
+        badInput('photo-grid: input.ratio 必须是 ' + PHOTO_GRID_RATIOS.join('／') + ' 之一');
+    }
+    let total = 0;
+    for (const g of groups)
+        total += g.photos.length;
+    return {
+        form: form,
+        groups,
+        ratio: (ratioGiven ?? PHOTO_GRID_RATIOS[0]),
+        add: raw.add !== false,
+        addLabel: optText(raw.addLabel, 'photo-grid: input.addLabel'),
+        addHint: optText(raw.addHint, 'photo-grid: input.addHint'),
+        note: textList(raw.note, 'photo-grid: input.note'),
+        total,
+        extraClass: optExtraClass(raw.extraClass, 'photo-grid: input.extraClass'),
+    };
+}

package/dist/components/photo-grid/model.js.map

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

package/dist/components/photo-grid/render.d.ts

@@ -0,0 +1,3 @@
+/** 渲染照片网格（纯函数：同样的入参恒产同样的字节；转义只经 `shared/escape.ts`）。 */
+export declare function renderPhotoGrid(input: unknown): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/components/photo-grid/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/components/photo-grid/render.ts"],"names":[],"mappings":"AAsHA,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAItD"}

package/dist/components/photo-grid/render.js

@@ -0,0 +1,116 @@
+/** photo-grid · **渲染**（纯函数产 HTML；本件只有形态 A「网格 ＋ 加一张」一种骨架）。
+ *
+ *  —— 形态 A：网格 ＋ 加一张 ——
+ *
+ *  **重做件**（原型 3/3/3）：原型拿渐变块当照片，读者看不出那是相片位。重做后一格由三样定形，
+ *  缺图时也一眼读出「这里放一张照片」：
+ *   ① **定形框**：`aspect-ratio` 落在框上（真图与占位共用同一个框，加载不跳版）；
+ *   ② **四角取景角标**：取景器的样子（纯装饰，`aria-hidden`）；
+ *   ③ **底部题注条**：日期 ＋ 说明（这是这一格「拍的是什么」）。
+ *  末尾那一格是**虚线框 ＋ 加号**，靠**边框样式**（不是颜色）与内容格分开。
+ *
+ *  它替掉的两种错法：
+ *   · 一格一块灰、没有比例 —— 图一到位整页往下推，读者眼前一跳；
+ *   · 末尾那格做成实心按钮 —— 与内容格混成一个网格，读者分不清哪格是照片、哪格是入口。
+ */
+import { esc } from '../shared/escape.js';
+import { PHOTO_GRID_ADD_LABEL, PHOTO_GRID_ADD_MARK, PHOTO_GRID_CLASS, PHOTO_GRID_EMPTY_TEXT, photoGridSlot, } from './attrs.js';
+import { normalizePhotoGrid } from './model.js';
+/** 定形框：比例闭集 → 框上的类（`-frame-4-5` 之类）。真图与占位**同一个框**。 */
+function frameClass(ratio) {
+    return photoGridSlot('frame') + '-' + ratio;
+}
+/** 一格的框里装什么：真图，或者「这里放一张照片」的占位（相机记号 ＋ 这句该放什么）。 */
+function innerHtml(item) {
+    const parts = ['<i class="' + photoGridSlot('marks') + '" aria-hidden="true"></i>'];
+    if (item.src === undefined) {
+        parts.push('<i class="' + photoGridSlot('lens') + '" aria-hidden="true"></i>');
+        parts.push('<span class="' + photoGridSlot('alt') + '">' + esc(item.alt) + '</span>');
+    }
+    else {
+        parts.push('<img class="' + photoGridSlot('img') + '" src="' + esc(item.src) + '" alt="' + esc(item.alt)
+            + '" loading="lazy" decoding="async">');
+    }
+    if (item.stackText !== undefined) {
+        parts.push('<span class="' + photoGridSlot('stack') + '">' + esc(item.stackText) + '</span>');
+    }
+    return parts.join('');
+}
+/** 一格：定形框 ＋ 题注条。 */
+function cellHtml(item, ratio) {
+    const parts = ['<figure class="' + photoGridSlot('cell') + ' '
+            + (item.src === undefined ? 'is-placeholder' : 'is-photo') + '">'];
+    parts.push('<span class="' + photoGridSlot('frame') + ' ' + frameClass(ratio) + '">'
+        + innerHtml(item) + '</span>');
+    const caps = [];
+    if (item.date !== undefined)
+        caps.push('<span class="' + photoGridSlot('date') + '">' + esc(item.date) + '</span>');
+    if (item.caption !== undefined)
+        caps.push('<span class="' + photoGridSlot('text') + '">' + esc(item.caption) + '</span>');
+    if (caps.length > 0) {
+        parts.push('<figcaption class="' + photoGridSlot('caption') + '">' + caps.join('') + '</figcaption>');
+    }
+    parts.push('</figure>');
+    return parts.join('');
+}
+/** 末尾那一格：虚线框 ＋ 加号 ＋ 「加一张」（**内容格**，不是按钮）。 */
+function addHtml(m) {
+    const parts = ['<span class="' + photoGridSlot('add') + '">'];
+    parts.push('<span class="' + photoGridSlot('add-mark') + '" aria-hidden="true">' + esc(PHOTO_GRID_ADD_MARK) + '</span>');
+    parts.push('<span class="' + photoGridSlot('add-label') + '">' + esc(m.addLabel ?? PHOTO_GRID_ADD_LABEL) + '</span>');
+    if (m.addHint !== undefined) {
+        parts.push('<span class="' + photoGridSlot('add-hint') + '">' + esc(m.addHint) + '</span>');
+    }
+    parts.push('</span>');
+    return parts.join('');
+}
+/** 一行的格（末尾那个「加一张」跟着**最后一组**走：它是这面墙的出口，不是某一组的）。 */
+function gridHtml(group, m, last) {
+    const parts = ['<div class="' + photoGridSlot('grid') + '">'];
+    for (const item of group.photos)
+        parts.push(cellHtml(item, m.ratio));
+    if (m.add && last)
+        parts.push(addHtml(m));
+    parts.push('</div>');
+    return parts.join('');
+}
+/** 形态 A 的骨架。平铺＝一组（无组头）；分组＝逐组一块（组头写月份与张数）。 */
+function renderGrid(m) {
+    const parts = [];
+    if (m.total === 0) {
+        parts.push('<p class="' + photoGridSlot('empty') + '">' + esc(PHOTO_GRID_EMPTY_TEXT) + '</p>');
+        if (m.add)
+            parts.push('<div class="' + photoGridSlot('grid') + '">' + addHtml(m) + '</div>');
+        return parts.join('');
+    }
+    m.groups.forEach((group, i) => {
+        const last = i === m.groups.length - 1;
+        if (group.month === undefined) {
+            parts.push(gridHtml(group, m, last));
+            return;
+        }
+        parts.push('<div class="' + photoGridSlot('group') + '">');
+        parts.push('<p class="' + photoGridSlot('group-head') + '">'
+            + '<b class="' + photoGridSlot('month') + '">' + esc(group.month) + '</b>'
+            + '<span class="' + photoGridSlot('group-count') + '">' + esc(group.countText) + '</span>'
+            + (group.note === undefined ? '' : '<span class="' + photoGridSlot('note') + '">' + esc(group.note) + '</span>')
+            + '</p>');
+        parts.push(gridHtml(group, m, last));
+        parts.push('</div>');
+    });
+    const foot = ['<span class="' + photoGridSlot('count') + '">共 ' + esc(String(m.total)) + ' 张</span>'];
+    for (const seg of m.note)
+        foot.push('<span class="' + photoGridSlot('note') + '">' + esc(seg) + '</span>');
+    parts.push('<p class="' + photoGridSlot('foot') + '">' + foot.join('') + '</p>');
+    return parts.join('');
+}
+/** 形态 → 骨架（本件只有一格；分派写在这里，加第二形态就是加一支）。 */
+const SKELETONS = {
+    grid: renderGrid,
+};
+/** 渲染照片网格（纯函数：同样的入参恒产同样的字节；转义只经 `shared/escape.ts`）。 */
+export function renderPhotoGrid(input) {
+    const m = normalizePhotoGrid(input);
+    const extra = m.extraClass === undefined ? '' : ' ' + m.extraClass;
+    return '<div class="' + PHOTO_GRID_CLASS + ' is-' + m.form + extra + '">' + SKELETONS[m.form](m) + '</div>';
+}

package/dist/components/photo-grid/render.js.map

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

package/dist/components/photo-grid/style.d.ts

@@ -0,0 +1,17 @@
+/** 取景角标的臂长（px）：一根角标两条边各这么长。 */
+export declare const PHOTO_GRID_MARK_ARM_PX = 12;
+/** 取景角标的线宽（px）。 */
+export declare const PHOTO_GRID_MARK_THICK_PX = 2;
+/** 取景角标离框边的内距（px）。 */
+export declare const PHOTO_GRID_MARK_INSET_PX = 6;
+/** 末尾「加一张」那格的命中下限（px）：**命中盒不得小于它**（视觉盒可以随比例更高）。 */
+export declare const PHOTO_GRID_TOUCH_PX = 44;
+/** 列数换档的容器阈值（px）：**容器宽 ≤ 它两列，> 它三列**。
+ *  判的是**本件自己的宽度**（`@container`），不是视口宽度。这一档写成**窄档的上界**（`max-width`）、
+ *  宽档当缺省：窄档才是要**覆盖**的那一档，而缺省态本身是站得住的（390 档不必再单列一条规则）。 */
+export declare const PHOTO_GRID_TWO_COL_MAX_PX = 520;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export declare function photoGridCss(input?: {
+    readonly prefix?: string;
+}): string;
+//# sourceMappingURL=style.d.ts.map

package/dist/components/photo-grid/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/photo-grid/style.ts"],"names":[],"mappings":"AAkBA,+BAA+B;AAC/B,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,mBAAmB;AACnB,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,sBAAsB;AACtB,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC;;yDAEyD;AACzD,eAAO,MAAM,yBAAyB,MAAM,CAAC;AA0B7C,4BAA4B;AAC5B,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAkRzE"}

package/dist/components/photo-grid/style.js

@@ -0,0 +1,110 @@
+/** photo-grid · **样式段**（本件唯一的样式来源）。**重做件**：占位必须读得出是相片。
+ *
+ *  四条重做口径（`重做设计口径.md` §0）逐条落在这一段里：
+ *   ① **占位物读得出它是什么**：定形框（`aspect-ratio`）＋ 四角取景角标 ＋ 中央相机记号 ＋ 底部题注条；
+ *   ② **状态除色之外还有第二样**：占位格与真图格靠 `is-placeholder`（虚线内圈 ＋ 相机记号），
+ *      末尾「加一张」靠**虚线边框**与内容格分开 —— 换皮换到零阴影、零圆角也读得出；
+ *   ③ **层次不靠投影与圆角**：框靠一圈发丝线 ＋ 四角角标，题注条靠**软底色 ＋ 上发丝线**；
+ *   ④ **骨架对得上这类数据**：`<figure>` ＋ `<figcaption>`（照片与它的题注本来就是一格一件事）。
+ *
+ *  纪律：只经 `skinVar()` 读皮肤；scope 在 `.<prefix>page-ui` 之下；零 `:root`／`!important`；
+ *  宽度只许容器判（`@container`），媒体查询只判设备能力（本件没用到）。
+ */
+import { skinVar } from '../skin/contract.js';
+import { PHOTO_GRID_RATIOS, photoGridSlot } from './attrs.js';
+/** 换行（仓库口径：不写字面换行转义）。 */
+const LF = String.fromCharCode(10);
+/** 取景角标的臂长（px）：一根角标两条边各这么长。 */
+export const PHOTO_GRID_MARK_ARM_PX = 12;
+/** 取景角标的线宽（px）。 */
+export const PHOTO_GRID_MARK_THICK_PX = 2;
+/** 取景角标离框边的内距（px）。 */
+export const PHOTO_GRID_MARK_INSET_PX = 6;
+/** 末尾「加一张」那格的命中下限（px）：**命中盒不得小于它**（视觉盒可以随比例更高）。 */
+export const PHOTO_GRID_TOUCH_PX = 44;
+/** 列数换档的容器阈值（px）：**容器宽 ≤ 它两列，> 它三列**。
+ *  判的是**本件自己的宽度**（`@container`），不是视口宽度。这一档写成**窄档的上界**（`max-width`）、
+ *  宽档当缺省：窄档才是要**覆盖**的那一档，而缺省态本身是站得住的（390 档不必再单列一条规则）。 */
+export const PHOTO_GRID_TWO_COL_MAX_PX = 520;
+/** 四角取景角标：8 层背景（每角一条横、一条竖），不新增元素、不吃伪元素、零阴影下也在。 */
+function marksCss() {
+    const color = skinVar('line');
+    const bar = 'linear-gradient(' + color + ', ' + color + ')';
+    const arm = String(PHOTO_GRID_MARK_ARM_PX) + 'px';
+    const thick = String(PHOTO_GRID_MARK_THICK_PX) + 'px';
+    const inset = String(PHOTO_GRID_MARK_INSET_PX) + 'px';
+    const right = 'calc(100% - ' + inset + ')';
+    const bottom = 'calc(100% - ' + inset + ')';
+    const pos = [];
+    for (const [y, x] of [[inset, inset], [inset, right], [bottom, inset], [bottom, right]]) {
+        pos.push(x + ' ' + y, x + ' ' + y);
+    }
+    return [
+        '  background-image: ' + [bar, bar, bar, bar, bar, bar, bar, bar].join(', ') + ';',
+        '  background-size: ' + [arm + ' ' + thick, thick + ' ' + arm].join(', ')
+            + [arm + ' ' + thick, thick + ' ' + arm].join(', ')
+            + [arm + ' ' + thick, thick + ' ' + arm].join(', ')
+            + [arm + ' ' + thick, thick + ' ' + arm].join(', ') + ';',
+        '  background-position: ' + pos.join(', ') + ';',
+        '  background-repeat: no-repeat;',
+    ];
+}
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export function photoGridCss(input) {
+    const p = input !== undefined && input !== null
+        && typeof input.prefix === 'string' && input.prefix !== '' ? input.prefix : 'ilife-';
+    const root = '.' + p + 'page-ui';
+    const box = root + ' .' + p + 'block-photo-grid';
+    const slotSel = (s) => '.' + photoGridSlot(s, p);
+    const s = (slot) => root + ' ' + slotSel(slot);
+    const out = [
+        '/* photo-grid（照片网格 · 形态 A「网格 ＋ 加一张」）：定形框 ＋ 四角取景角标 ＋ 底部题注条。',
+        '   **重做件**：占位不再是「一块灰」——没真图时也一眼看出「这里放一张照片」。',
+        '   零阴影、零圆角下层次靠发丝线、软底色与角标 ⇒ 三套皮肤都成立。 */',
+        box + ' {',
+        '  container-type: inline-size;',
+        '  display: grid;',
+        '  gap: 14px;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font') + ';',
+        '  font-size: ' + skinVar('fs-body') + ';',
+        '  line-height: 1.5;',
+        '}',
+        '/* 网格：窄档两列，宽档三列（判的是**本件自己的宽度**，不是视口宽度）。 */',
+        s('grid') + ' {',
+        '  display: grid;',
+        '/* 缺省（宽档）：三列 —— 判的是本件自己的宽度。窄档那一条在文末，把列数**覆盖**成两列。 */',
+        '  grid-template-columns: repeat(3, minmax(0, 1fr));',
+        '  gap: 12px 10px;',
+        '  min-width: 0;',
+        '  align-items: start;',
+        '}',
+        '/* 一格：`<figure>` ＝ 一张照片 ＋ 它的题注（本来就是一格一件事）。 */',
+        s('cell') + ' {',
+        '  display: grid;',
+        '  gap: 6px;',
+        '  min-width: 0;',
+        '  margin: 0;',
+        '}',
+        '/* ① 定形框：比例落在框上，**真图与占位共用一个框** ⇒ 图到位不跳版。 */',
+        s('frame') + ' {',
+        '  position: relative;',
+        '  display: grid;',
+        '  place-items: center;',
+        '  width: 100%;',
+        '  min-width: 0;',
+        '  box-sizing: border-box;',
+        '  border: 1px solid ' + skinVar('edge') + ';',
+        '  border-radius: ' + skinVar('radius-sm') + ';',
+        '  background: ' + skinVar('surface-2') + ';',
+        '  overflow: hidden;',
+        '}',
+    ];
+    for (const ratio of PHOTO_GRID_RATIOS) {
+        out.push(root + ' .' + photoGridSlot('frame', p) + '-' + ratio
+            + ' { aspect-ratio: ' + ratio.split('-').join(' / ') + '; }');
+    }
+    out.push('/* ② 四角取景角标：取景器的样子（8 层背景，不加元素、不用伪元素）。 */', s('marks') + ' {', '  position: absolute;', '  inset: 0;', '  pointer-events: none;', ...marksCss(), '}', '/* 中央那枚相机记号：**只有占位格才出**——一眼看出「这里放一张照片」。 */', s('lens') + ' {', '  position: relative;', '  display: block;', '  grid-area: 1 / 1;', '  align-self: end;', '  margin-bottom: 6px;', '  width: 34px;', '  height: 26px;', '  box-sizing: border-box;', '  border: ' + String(PHOTO_GRID_MARK_THICK_PX) + 'px solid ' + skinVar('ink-3') + ';', '  border-radius: ' + skinVar('radius-sm') + ';', '}', s('lens') + '::before {', '  content: "";', '  position: absolute;', '  left: 50%;', '  top: 50%;', '  width: 10px;', '  height: 10px;', '  margin: -6px 0 0 -6px;', '  box-sizing: border-box;', '  border: ' + String(PHOTO_GRID_MARK_THICK_PX) + 'px solid ' + skinVar('ink-3') + ';', '  border-radius: 50%;', '}', s('lens') + '::after {', '  content: "";', '  position: absolute;', '  right: 3px;', '  top: -7px;', '  width: 8px;', '  height: 5px;', '  box-sizing: border-box;', '  border: ' + String(PHOTO_GRID_MARK_THICK_PX) + 'px solid ' + skinVar('ink-3') + ';', '  border-bottom: 0;', '  border-radius: 3px 3px 0 0;', '}', '/* 占位格写在框里的那句话（＝这一格该放什么照片）＋ 一圈虚线内圈：**与真图格的第二样差别**。 */', s('alt') + ' {', '  grid-area: 2 / 1;', '  align-self: start;', '  justify-self: center;', '  max-width: 100%;', '  padding: 0 8px;', '  box-sizing: border-box;', '  color: ' + skinVar('ink-2') + ';', '  font-size: ' + skinVar('fs-xs') + ';', '  font-weight: 600;', '  text-align: center;', '  overflow-wrap: anywhere;', '}', s('frame') + ' { grid-template-rows: 1fr auto 1fr; }', s('cell') + '.is-placeholder ' + slotSel('frame') + ' {', '  border-style: dashed;', '  background: ' + skinVar('surface') + ';', '}', '/* 真图：比例由框定，`object-fit: cover` 铺满（不裁掉题注条：题注在框外）。 */', s('img') + ' {', '  display: block;', '  grid-area: 1 / 1 / 4 / 2;', '  width: 100%;', '  height: 100%;', '  max-width: 100%;', '  object-fit: cover;', '}', '/* 张数角标（同一天多张）：**面上有字（那就是张数）** ⇒ 走"有文字的一片"那一档：', '   强调软底 ＋ 强调文本字 ＋ 主色描边。旧写法是墨底白字（把正文墨色当面），换皮时读成一块坏斑。 */', s('stack') + ' {', '  position: absolute;', '  right: ' + String(PHOTO_GRID_MARK_INSET_PX) + 'px;', '  bottom: ' + String(PHOTO_GRID_MARK_INSET_PX) + 'px;', '  padding: 1px 7px;', '  border: 1px solid ' + skinVar('accent') + ';', '  border-radius: ' + skinVar('radius-sm') + ';', '  background: ' + skinVar('accent-soft') + ';', '  color: ' + skinVar('accent-text') + ';', '  font-family: ' + skinVar('font-num') + ';', '  font-size: ' + skinVar('fs-xs') + ';', '  font-weight: 700;', '  font-variant-numeric: tabular-nums;', '}', '/* ③ 题注条：底部一行（日期 ＋ 说明）——**零阴影下的那道分家靠软底色 ＋ 上发丝线**。 */', s('caption') + ' {', '  display: flex;', '  flex-wrap: wrap;', '  align-items: baseline;', '  gap: 2px 8px;', '  min-width: 0;', '  padding: 6px 8px;', '  box-sizing: border-box;', '  border-top: 1px solid ' + skinVar('line') + ';', '  background: ' + skinVar('surface-2') + ';', '  border-radius: ' + skinVar('radius-sm') + ';', '  color: ' + skinVar('ink-2') + ';', '  font-size: ' + skinVar('fs-xs') + ';', '  line-height: 1.5;', '}', s('date') + ' {', '  flex: none;', '  color: ' + skinVar('ink') + ';', '  font-family: ' + skinVar('font-num') + ';', '  font-weight: 700;', '  font-variant-numeric: tabular-nums;', '}', s('text') + ' {', '  flex: 1 1 auto;', '  min-width: 0;', '  overflow-wrap: anywhere;', '}', '/* ④ 末尾那一格「加一张」：**虚线框 ＋ 加号**，靠边框样式（不是颜色）与内容格分开。 */', s('add') + ' {', '  display: grid;', '  place-items: center;', '  align-content: center;', '  gap: 4px;', '  min-height: ' + String(PHOTO_GRID_TOUCH_PX) + 'px;', '  box-sizing: border-box;', '  padding: 14px 8px;', '  border: 1px dashed ' + skinVar('line') + ';', '  border-radius: ' + skinVar('radius-sm') + ';', '  background: transparent;', '  color: ' + skinVar('ink-2') + ';', '  font-size: ' + skinVar('fs-xs') + ';', '  font-weight: 700;', '  text-align: center;', '}', s('add-mark') + ' {', '  color: ' + skinVar('ink-2') + ';', '  font-size: calc(' + skinVar('fs-body') + ' * 1.6);', '  line-height: 1;', '  font-weight: 600;', '}', s('add-label') + ', ' + s('add-hint') + ' {', '  max-width: 100%;', '  overflow-wrap: anywhere;', '}', s('add-hint') + ' {', '  color: ' + skinVar('ink-3') + ';', '  font-weight: 600;', '}', '/* 按月分组的组头：月份 ＋ 计数（由本件算）＋ 可选补充；分家靠发丝线。 */', s('group') + ' {', '  display: grid;', '  gap: 8px;', '  min-width: 0;', '}', s('group-head') + ' {', '  display: flex;', '  flex-wrap: wrap;', '  align-items: baseline;', '  gap: 2px 10px;', '  margin: 0;', '  padding-bottom: 6px;', '  min-width: 0;', '  border-bottom: 1px solid ' + skinVar('line') + ';', '}', s('month') + ' {', '  flex: none;', '  color: ' + skinVar('ink') + ';', '  font-size: ' + skinVar('fs-sm') + ';', '  font-weight: 700;', '}', s('group-count') + ' {', '  color: ' + skinVar('ink-2') + ';', '  font-size: ' + skinVar('fs-xs') + ';', '  font-variant-numeric: tabular-nums;', '}', s('group-head') + ' > ' + slotSel('note') + ' { margin-left: auto; }', '/* 脚注：共几张 ＋ 调用方给的口径（逐段一枚 span，段间一条发丝线）。 */', s('foot') + ' {', '  display: flex;', '  flex-wrap: wrap;', '  align-items: baseline;', '  gap: 4px 8px;', '  margin: 0;', '  min-width: 0;', '  color: ' + skinVar('ink-3') + ';', '  font-size: ' + skinVar('fs-xs') + ';', '  line-height: 1.6;', '}', s('count') + ' {', '  color: ' + skinVar('ink-2') + ';', '  font-weight: 700;', '  font-variant-numeric: tabular-nums;', '}', s('foot') + ' > ' + slotSel('note') + ' {', '  padding-left: 8px;', '  border-left: 1px solid ' + skinVar('line') + ';', '  overflow-wrap: anywhere;', '}', '/* 空态：没有照片不是错误（新账本／新物品本来就没有），说清下一步。 */', s('empty') + ' {', '  margin: 0;', '  color: ' + skinVar('ink-2') + ';', '  font-size: ' + skinVar('fs-sm') + ';', '}', '/* 焦点地板：本件不带可点元素；调用方若把某一格或「加一张」包成按钮，焦点必须看得见。 */', box + ' :focus-visible {', '  outline: 2px solid ' + skinVar('accent') + ';', '  outline-offset: 2px;', '}', '/* 窄容器（≤' + String(PHOTO_GRID_TWO_COL_MAX_PX) + 'px）：三列**覆盖**成两列——', '   判的是本件自己的宽度（本件会被嵌进侧栏／面板／卡片，视口宽 ≠ 组件宽，所以这里不写 `@media`）。 */', '@container (max-width: ' + String(PHOTO_GRID_TWO_COL_MAX_PX) + 'px) {', '  ' + s('grid') + ' {', '    grid-template-columns: repeat(2, minmax(0, 1fr));', '  }', '}');
+    return out.join(LF);
+}

package/dist/components/photo-grid/style.js.map

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

package/dist/components/popover-menu/attrs.d.ts

@@ -0,0 +1,98 @@
+/** popover-menu · **标记契约**（渲染与运行时共用的唯一事实：类名／`data-*`／事件名／闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-10-容器与浮层.mjs`，2026-09 用户裁定）
+ *  里的**形态 A「贴着按钮＝复制格式」**——一颗触发键 ＋ 贴着它弹出来的小菜单
+ *  （分组头、快捷键、当前项打勾、危险项垫最后）。用在哪：六个技能的复制格式、更多操作、快捷切换。
+ *
+ *  落地路线（票面钉死）：**`popover` 属性**——
+ *   · 开／关／`Esc`／点外面关，浏览器白送（触发键带 `popovertarget`，**一行脚本都没有也开得出来**）；
+ *   · 定位：`@supports (anchor-name: --a)` **之内**才用 CSS 锚定定位（`position-area` ＋
+ *     `position-try-fallbacks` 贴不下就翻边），**之外**退回普通定位（打开时由运行时按触发键的矩形算边距）；
+ *   · 逐实例锚名从 `id` 算：`--ilife-menu-<id>`，由标记写进 `style` 属性（静态 CSS 认不出逐实例名字）。
+ */
+/** 本件的类名根（挂在包住「触发键 ＋ 面板」的那层容器上）。 */
+export declare const MENU_CLASS = "ilife-block-popover-menu";
+/** 类名根（带前缀）。 */
+export declare function menuClass(prefix?: string): string;
+/** 槽位闭集。 */
+export declare const MENU_SLOTS: readonly ["trigger", "panel", "group", "sep", "item", "key", "note", "shortcut", "tick"];
+export type MenuSlot = (typeof MENU_SLOTS)[number];
+/** 槽类的类名（唯一拼法）。 */
+export declare function menuSlot(slot: MenuSlot, prefix?: string): string;
+/** 形态闭集：本件只落地形态 A「贴着按钮」。 */
+export declare const MENU_FORMS: readonly ["hug"];
+export type MenuForm = (typeof MENU_FORMS)[number];
+/** 贴哪一边（横向）：`end`＝面板右缘贴触发键右缘（贴右，缺省）／`start`＝左缘贴左缘。 */
+export declare const MENU_ALIGNS: readonly ["start", "end"];
+export type MenuAlign = (typeof MENU_ALIGNS)[number];
+/** 项的档闭集：`action`（普通）／`check`（当前项打勾）／`danger`（危险项）。 */
+export declare const MENU_KINDS: readonly ["action", "check", "danger"];
+export type MenuKind = (typeof MENU_KINDS)[number];
+/** 容器的发现锚：值＝菜单 `id`。 */
+export declare const MENU_ATTR = "data-ilife-popover-menu";
+/** 触发键：值＝菜单 `id`。 */
+export declare const MENU_TRIGGER_ATTR = "data-ilife-menu-trigger";
+/** 面板：值＝菜单 `id`；**降级路的开关**（值＝`end`／`start`，运行时按它算贴哪边）。 */
+export declare const MENU_PANEL_ATTR = "data-ilife-menu-panel";
+/** 一枚菜单项：值＝该项的机器值。 */
+export declare const MENU_ITEM_ATTR = "data-ilife-menu-item";
+/** 绑定完成标记（幂等）。 */
+export declare const MENU_BOUND_ATTR = "data-ilife-menu-bound";
+/** 事件名（冒泡 `CustomEvent`；`detail` 见 README 的「交互契约」）。 */
+export declare const MENU_EVENT_SELECT = "ilife:menu-select";
+/** 面板开／关时派发（`detail.phase`＝`open`／`close`）——页面拿它记账或联动，不拿它开菜单。 */
+export declare const MENU_EVENT_TOGGLE = "ilife:menu-toggle";
+/** 锚定定位的两条能力查询：**CSS 与运行时读同一个串**（两边判据必须说同一件事，否则会各走各的）。 */
+export declare const MENU_ANCHOR_QUERY = "anchor-name: --a";
+export declare const MENU_AREA_QUERY = "position-area: bottom";
+/** 逐实例锚名的前缀（完整名＝`--ilife-menu-<id>`；触发键与面板**写同一个名字**）。 */
+export declare const MENU_ANCHOR_PREFIX = "--ilife-menu-";
+/** 几何口径：触发键与菜单项的命中高度下限／相邻命中区间距／面板宽上限／离容器边至少留多少。 */
+export declare const MENU_MIN_HEIGHT_PX = 44;
+export declare const MENU_GAP_PX = 8;
+export declare const MENU_EDGE_PX = 12;
+export declare const MENU_WIDTH_PX = 262;
+export declare const MENU_MAX_HEIGHT_PX = 320;
+/** 面板与触发键之间那道缝（锚定定位下是 `margin`，降级路下是同一个数）。 */
+export declare const MENU_OFFSET_PX = 8;
+/** 触发键上那枚「会弹出东西」的记号（纯装饰，`aria-hidden`）。 */
+export declare const MENU_CARET = "\u25BE";
+/** 打勾位那枚记号（纯装饰；`aria-checked` 才是语义）。 */
+export declare const MENU_TICK = "\u2713";
+/** 一枚菜单项。 */
+export interface PopoverMenuItem {
+    /** 机器值（选中时原样送出）。非空串，菜单内唯一。 */
+    readonly value: string;
+    /** 主文字（如「Markdown」）。非空串；**许换行、不许 `…` 截断**。 */
+    readonly label: string;
+    /** 次文字（如「带标题与表格」）。 */
+    readonly note?: string;
+    /** 快捷键位（如 `⌘⇧M`；只是字，不绑键盘——绑定归页面）。 */
+    readonly shortcut?: string;
+    /** 分组头：与上一项不同时，在它前面出一行分组头。 */
+    readonly group?: string;
+    /** 这一项之前来一条发丝线（比分组头弱一档的分法）。 */
+    readonly sep?: boolean;
+    /** 档：`action`（缺省）／`check`（当前项，打勾）／`danger`（危险项，垫最后）。 */
+    readonly kind?: MenuKind;
+    /** `kind=check` 时的勾选档（缺省 false）。 */
+    readonly checked?: boolean;
+}
+/** 浮出菜单入参（形态 A）。`id`／`trigger`／`items` 必填。 */
+export interface PopoverMenuInput {
+    /** 菜单 `id`（也是触发键 `popovertarget` 指的那个 id）。同页唯一；只许标识符字符。 */
+    readonly id: string;
+    /** 触发键上的字（如「复制为」；记号 `▾` 由组件补，不用写进这里）。 */
+    readonly trigger: string;
+    /** 菜单的无障碍名（不给＝用触发键上的字）。 */
+    readonly menuLabel?: string;
+    /** 贴哪一边（缺省 `end`＝贴右）。 */
+    readonly align?: MenuAlign;
+    /** 菜单项（顺序＝屏上顺序；分组头与发丝线都从项上的字段来）。至少一项。 */
+    readonly items: readonly PopoverMenuItem[];
+    /** 形态键（闭集，缺省 `hug`）。 */
+    readonly form?: MenuForm;
+    /** 附加类名。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

package/dist/components/popover-menu/attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../../src/components/popover-menu/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oCAAoC;AACpC,eAAO,MAAM,UAAU,6BAA6B,CAAC;AAErD,gBAAgB;AAChB,wBAAgB,SAAS,CAAC,MAAM,SAAW,GAAG,MAAM,CAEnD;AAED,YAAY;AACZ,eAAO,MAAM,UAAU,0FAmBb,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,mBAAmB;AACnB,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,SAAW,GAAG,MAAM,CAElE;AAED,4BAA4B;AAC5B,eAAO,MAAM,UAAU,kBAAmB,CAAC;AAC3C,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,sDAAsD;AACtD,eAAO,MAAM,WAAW,2BAA4B,CAAC;AACrD,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,uDAAuD;AACvD,eAAO,MAAM,UAAU,wCAAyC,CAAC;AACjE,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAInD,wBAAwB;AACxB,eAAO,MAAM,SAAS,4BAA4B,CAAC;AACnD,qBAAqB;AACrB,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAC3D,0DAA0D;AAC1D,eAAO,MAAM,eAAe,0BAA0B,CAAC;AACvD,sBAAsB;AACtB,eAAO,MAAM,cAAc,yBAAyB,CAAC;AACrD,kBAAkB;AAClB,eAAO,MAAM,eAAe,0BAA0B,CAAC;AAEvD,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AACrD,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AACpD,eAAO,MAAM,eAAe,0BAA0B,CAAC;AACvD,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,8CAA8C;AAC9C,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,2CAA2C;AAC3C,eAAO,MAAM,UAAU,WAAM,CAAC;AAC9B,wCAAwC;AACxC,eAAO,MAAM,SAAS,WAAM,CAAC;AAE7B,aAAa;AACb,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACzB,oCAAoC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,wBAAwB;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACzB,YAAY;IACZ,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}