base-paint 0.3.13 → 0.3.15

package/dist/components/page/fact-strip.js

@@ -0,0 +1,91 @@
+/** 页面级形状件 ①**事实条**（`renderFactStrip`）。
+ *
+ *  一行 N 件事由版式分格承担，文本里一个分隔符都没有。
+ *
+ *  **住址**：目录化批次②把它从 `src/pageShapes.ts` 搬到这里（正文原样，判据＝产物逐字节相同，
+ *  见 `docs/base/base-render/组件目录架构.md`）。
+ */
+import { esc, reqText, optText } from './shared.js';
+/** #950 B4：事实条的缺数占位（与全仓「缺数一律写 —」同字）。 */
+export const FACT_STRIP_MISSING_MARK = '\u2014';
+/** 事实条：一行 N 件事的呈现形状（替掉 `A · B · C` 那种串）。空数组出不了一个字。
+ *  **#950 B4 扩参**：值位可给 `null`（缺数 → 印 `—`，与「0」区分开）＋ 可选单位位。
+ *  给了字符串值又不给单位的既有调用点产物**逐字节不变**。 */
+export function renderFactStrip(input) {
+    const items = input.items;
+    if (!Array.isArray(items))
+        throw new Error('pageShapes: renderFactStrip: input.items 必须是数组');
+    if (items.length === 0)
+        return '';
+    const extra = optText(input.extraClass, 'renderFactStrip: input.extraClass');
+    const cells = items.map((item, i) => {
+        const field = 'renderFactStrip: input.items[' + i + ']';
+        const label = reqText(item.label, field + '.label');
+        const tone = item.tone;
+        if (tone !== undefined && tone !== 'ok' && tone !== 'warn' && tone !== 'danger') {
+            throw new Error('pageShapes: ' + field + '.tone 必须是 ok／warn／danger 之一');
+        }
+        const unit = optText(item.unit, field + '.unit');
+        const missing = item.value === null || item.value === undefined;
+        const value = missing ? FACT_STRIP_MISSING_MARK : reqText(item.value, field + '.value');
+        return '<div class="ilife-block-fact-strip-item">'
+            + '<span class="ilife-block-fact-strip-label">' + esc(label) + '</span>'
+            + '<span class="ilife-block-fact-strip-value'
+            + (tone === undefined ? '' : ' ilife-block-fact-strip-value-' + tone)
+            + (missing ? ' ilife-block-fact-strip-value-missing' : '') + '">' + esc(value)
+            + (missing || unit === undefined ? '' : '<span class="ilife-block-fact-strip-unit">' + esc(unit) + '</span>')
+            + '</span>'
+            + '</div>';
+    }).join('');
+    return '<div class="ilife-block-fact-strip' + (extra === undefined ? '' : ' ' + extra) + '">' + cells + '</div>';
+}
+/** 本件样式段（族组装器 `pageShapeCss()` 按原顺序拼回）。 */
+export function factStripCss(p, root) {
+    return [
+        '/* ① 事实条：一格「标签 ＋ 值」，格与格靠 22px 列距分开（不用任何分隔符字符）。 */',
+        root + ' .' + p + 'block-fact-strip {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  gap: 10px 22px;',
+        '  margin: 12px 0 0;',
+        '}',
+        root + ' .' + p + 'block-fact-strip-item {',
+        '  display: flex;',
+        '  flex-direction: column;',
+        '  gap: 2px;',
+        '  min-width: 0;',
+        '}',
+        root + ' .' + p + 'block-fact-strip-label {',
+        '  color: var(--fg3);',
+        '  font-size: 12px;',
+        '}',
+        root + ' .' + p + 'block-fact-strip-value {',
+        '  color: var(--fg);',
+        // #567 J4（§5.2 区块标题 15 吸收 14／15）。
+        '  font-size: 15px;',
+        '  font-weight: 600;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        root + ' .' + p + 'block-fact-strip-value-ok {',
+        '  color: #1f8c3d;',
+        '}',
+        root + ' .' + p + 'block-fact-strip-value-warn {',
+        '  color: #a25b00;',
+        '}',
+        root + ' .' + p + 'block-fact-strip-value-danger {',
+        '  color: #a83228;',
+        '}',
+        '/* #950 B4：缺数（`value: null`）——占位字 `—` ＋ 降调；与「0」在观感上分开。 */',
+        root + ' .' + p + 'block-fact-strip-value-missing {',
+        '  color: var(--fg3);',
+        '  font-weight: 500;',
+        '}',
+        '/* #950 B4：单位位（值位只吃数，单位小一号跟在后面）。 */',
+        root + ' .' + p + 'block-fact-strip-unit {',
+        '  margin-left: 4px;',
+        '  color: var(--fg2);',
+        '  font-size: 12px;',
+        '  font-weight: 500;',
+        '}',
+    ];
+}

package/dist/components/page/fact-strip.js.map

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

package/dist/components/page/index.d.ts

@@ -0,0 +1,13 @@
+/** 页面级形状族出口：三支形状件 ＋ ②b 占位件 ＋ 族样式组装器。
+ *
+ *  **住址**：目录化批次②把 `src/pageShapes.ts` 拆成「一族一目录、族内一件一文件」：
+ *  `fact-strip.ts`／`media.ts`／`timeline.ts` 各是一件（含自己的样式段），
+ *  `style.ts` 只做组装，`shared.ts` 是三件共用的小件。对外**一字未动**：
+ *  根出口仍出 `FACT_STRIP_MISSING_MARK`／`MEDIA_RATIOS`／`pageShapeCss`／三个 `render*`
+ *  与六个类型，`dist/pageShapes.js` 不再产出（包内无第二处引用）。
+ */
+export * from './fact-strip.js';
+export * from './media.js';
+export * from './timeline.js';
+export * from './style.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/page/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/page/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/components/page/index.js

@@ -0,0 +1,12 @@
+/** 页面级形状族出口：三支形状件 ＋ ②b 占位件 ＋ 族样式组装器。
+ *
+ *  **住址**：目录化批次②把 `src/pageShapes.ts` 拆成「一族一目录、族内一件一文件」：
+ *  `fact-strip.ts`／`media.ts`／`timeline.ts` 各是一件（含自己的样式段），
+ *  `style.ts` 只做组装，`shared.ts` 是三件共用的小件。对外**一字未动**：
+ *  根出口仍出 `FACT_STRIP_MISSING_MARK`／`MEDIA_RATIOS`／`pageShapeCss`／三个 `render*`
+ *  与六个类型，`dist/pageShapes.js` 不再产出（包内无第二处引用）。
+ */
+export * from './fact-strip.js';
+export * from './media.js';
+export * from './timeline.js';
+export * from './style.js';

package/dist/components/page/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/page/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/components/page/media.d.ts

@@ -0,0 +1,67 @@
+/** 页面级形状件 ②**图片与 GIF 容器**＋ ②b **占位件**（`renderMediaFigure`／`renderMediaPlaceholder`）。
+ *
+ *  容器自带明确宽高比；没有图时出人话占位，不出黑条。
+ *
+ *  **住址**：目录化批次②把它从 `src/pageShapes.ts` 搬到这里（正文原样，判据＝产物逐字节相同，
+ *  见 `docs/base/base-render/组件目录架构.md`）。
+ */
+/** 容器宽高比闭集：`natural`＝按图自身比例（不设比，只兜 `max-width`）。
+ *  `4-5` 是 #525 追加窄席位补的**竖版人像档**——照片画廊的格位本来就是 `4/5`，占位件要与真图同规格，
+ *  比例集里就得有这一档（否则占位卡只能拿 `3-4` 凑，与真图卡差一截）。 */
+export declare const MEDIA_RATIOS: readonly ["natural", "1-1", "3-4", "4-5", "4-3", "9-16", "16-9"];
+export type MediaRatio = (typeof MEDIA_RATIOS)[number];
+export interface MediaFigureInput {
+    /** 图源（`data:` 内嵌串或文件名）。给了 `placeholder` 时本项可省。 */
+    readonly src?: string;
+    /** 替代文本（无障碍与图挂掉时的第一句话）。 */
+    readonly alt: string;
+    readonly ratio: MediaRatio;
+    /** 图在框里的摆法：`contain`＝整张都看得见（人像类默认），`cover`＝铺满裁切。 */
+    readonly fit?: 'contain' | 'cover';
+    /** 图注（一行人话）。 */
+    readonly caption?: string;
+    /** 图注下的一句补充（口径、来源之类）。 */
+    readonly note?: string;
+    /** **没有图可显时的整句人话**（如「原图 3.0 MB，超过页面能带的 1 MB，请按文件名自己打开看」）。
+     *  给了它且没给 `src` ⇒ 框里出这句话，不出黑底占位条。 */
+    readonly placeholder?: string;
+    /** 版面锚点（页内导航指过来用）；不给＝不带 id。 */
+    readonly id?: string;
+}
+/** 图片／GIF 容器：比例、`max-width`、`object-fit` 三件都在这里说清，调用方不再写内联样式。
+ *  没给 `src` 而给 `placeholder` 时，框仍按同一个 `ratio` 定尺寸，框里是那句人话（转义后当纯文本放）。 */
+export declare function renderMediaFigure(input: MediaFigureInput): string;
+/** 图片／GIF **占位件**的入参。与 `MediaFigureInput` 同槽位，只是框里装的是「为什么没显」的人话。 */
+export interface MediaPlaceholderInput {
+    /** 替代文本（无障碍，与 `MediaFigureInput.alt` 同槽位）。占位件也占**同一个内容槽**，故同样必填。 */
+    readonly alt: string;
+    /** **与同一处的真图同值**——这正是本件存在的理由，见下方不变量。 */
+    readonly ratio: MediaRatio;
+    /** 框里第一句人话，说清为什么没显（如「找不到文件：2026-06-09_003.jpg」）。 */
+    readonly reason: string;
+    /** 第二句人话：下一步怎么办（可省；不给＝本行不出）。 */
+    readonly next?: string;
+    /** 图注槽（不给＝与真图卡一样只靠容器的固定外边距撑开，不补空白）。 */
+    readonly caption?: string;
+    /** 图注下的一句补充（口径、来源之类），与 `MediaFigureInput.note` 同槽位。 */
+    readonly note?: string;
+    /** 摆法与真图同槽位；占位件内容居中，本项只为签名与真图对齐。 */
+    readonly fit?: 'contain' | 'cover';
+    /** 版面锚点（页内导航指过来用）；不给＝不带 id。 */
+    readonly id?: string;
+}
+/** 图片／GIF 的**占位件**：框里没显出的那一格，规格必须与真图那一格逐项相同。
+ *
+ *  **不变量（写死在这一件里，改它先改 `renderMediaFigure`）**：与 `renderMediaFigure` **同规格** ——
+ *  同一个宽高比容器（`<div class="ilife-block-media-frame …">` ＋ 本件要求的同一个 `ratio`）、
+ *  同一个圆角（14px）、同一条外边距（`figure` 的 `margin: 16px 0`）、同一个图注槽
+ *  （`figcaption.ilife-block-media-caption`）与补充槽（`.ilife-block-media-note`）。
+ *  **做法**：本件**不另写一套框**，整页交给 `renderMediaFigure` 装配——调用方就算把真图卡换成占位卡，
+ *  格子尺寸、圆角、外边距、图注位一处都不会变。缺的只是框里那点内容：`reason` 一句 ＋（可选）`next` 一句。
+ *
+ *  **不新增颜色**：框底用 `--soft`、框线用 `--line`（都来自 `.ilife-block-media-frame` 既有规则），
+ *  两句人话只用既有语义词 `--fg2`（主句）／`--fg3`（下一步）；不新造色值、不新造类名前缀。 */
+export declare function renderMediaPlaceholder(input: MediaPlaceholderInput): string;
+/** 本件样式段（族组装器 `pageShapeCss()` 按原顺序拼回）。 */
+export declare function mediaCss(p: string, root: string): string[];
+//# sourceMappingURL=media.d.ts.map

package/dist/components/page/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../src/components/page/media.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;4CAE4C;AAC5C,eAAO,MAAM,YAAY,kEAAmE,CAAC;AAC7F,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IACnC,gBAAgB;IAChB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,yBAAyB;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;yCACqC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB;AAyBD;wEACwE;AACxE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAuBjE;AAED,oEAAoE;AACpE,MAAM,WAAW,qBAAqB;IACpC,oEAAoE;IACpE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IACnC,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;0DAU0D;AAC1D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CA0B3E;AAED,2CAA2C;AAC3C,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA2F1D"}

package/dist/components/page/media.js

@@ -0,0 +1,191 @@
+/** 页面级形状件 ②**图片与 GIF 容器**＋ ②b **占位件**（`renderMediaFigure`／`renderMediaPlaceholder`）。
+ *
+ *  容器自带明确宽高比；没有图时出人话占位，不出黑条。
+ *
+ *  **住址**：目录化批次②把它从 `src/pageShapes.ts` 搬到这里（正文原样，判据＝产物逐字节相同，
+ *  见 `docs/base/base-render/组件目录架构.md`）。
+ */
+import { esc, reqText, optText } from './shared.js';
+/* ══════════════════════════════════════════════════════════════
+ * ② 图片与 GIF 容器：明确宽高比 ＋ max-width ＋ object-fit
+ * ══════════════════════════════════════════════════════════════ */
+/** 容器宽高比闭集：`natural`＝按图自身比例（不设比，只兜 `max-width`）。
+ *  `4-5` 是 #525 追加窄席位补的**竖版人像档**——照片画廊的格位本来就是 `4/5`，占位件要与真图同规格，
+ *  比例集里就得有这一档（否则占位卡只能拿 `3-4` 凑，与真图卡差一截）。 */
+export const MEDIA_RATIOS = ['natural', '1-1', '3-4', '4-5', '4-3', '9-16', '16-9'];
+/** 容器外框的唯一装配件（本件内部件，不对外给）：`renderMediaFigure` 与 `renderMediaPlaceholder`
+ *  两件共住这一段——**同规格**这条不变量靠它成立，不靠两处各写一遍再对照。
+ *  `innerHtml` 是**已装配好的框内标记**（调用方负责转义自己那点文本；本层不再转义，否则嵌套标记会变成字面量）。 */
+function renderMediaFrame(input) {
+    const parts = ['<figure class="ilife-block ilife-block-media'
+            + (input.id === undefined ? '' : '" id="' + esc(input.id)) + '">',
+        '<div class="ilife-block-media-frame ilife-block-media-frame-' + input.ratio
+            + ' ilife-block-media-frame-' + input.fit + '">',
+        input.innerHtml,
+        '</div>'];
+    if (input.caption !== undefined) {
+        parts.push('<figcaption class="ilife-block-media-caption">' + esc(input.caption) + '</figcaption>');
+    }
+    if (input.note !== undefined) {
+        parts.push('<div class="ilife-block-media-note">' + esc(input.note) + '</div>');
+    }
+    parts.push('</figure>');
+    return parts.join('');
+}
+/** 图片／GIF 容器：比例、`max-width`、`object-fit` 三件都在这里说清，调用方不再写内联样式。
+ *  没给 `src` 而给 `placeholder` 时，框仍按同一个 `ratio` 定尺寸，框里是那句人话（转义后当纯文本放）。 */
+export function renderMediaFigure(input) {
+    const alt = reqText(input.alt, 'renderMediaFigure: input.alt');
+    const ratio = input.ratio;
+    if (!MEDIA_RATIOS.includes(ratio)) {
+        throw new Error('pageShapes: renderMediaFigure: input.ratio 只许 ' + MEDIA_RATIOS.join('／'));
+    }
+    const fit = input.fit ?? 'contain';
+    if (fit !== 'contain' && fit !== 'cover') {
+        throw new Error('pageShapes: renderMediaFigure: input.fit 只许 contain／cover');
+    }
+    const id = optText(input.id, 'renderMediaFigure: input.id');
+    const src = optText(input.src, 'renderMediaFigure: input.src');
+    const caption = optText(input.caption, 'renderMediaFigure: input.caption');
+    const note = optText(input.note, 'renderMediaFigure: input.note');
+    const placeholder = optText(input.placeholder, 'renderMediaFigure: input.placeholder');
+    if (src === undefined && placeholder === undefined) {
+        throw new Error('pageShapes: renderMediaFigure: input.src 与 input.placeholder 至少其一');
+    }
+    const inner = src === undefined
+        ? '<div class="ilife-block-media-frame-empty">' + esc(placeholder) + '</div>'
+        : '<img class="ilife-block-media-img" src="' + esc(src) + '" alt="' + esc(alt) + '"'
+            + ' loading="lazy" decoding="async">';
+    return renderMediaFrame({ alt, ratio, fit, innerHtml: inner, caption, note, id });
+}
+/** 图片／GIF 的**占位件**：框里没显出的那一格，规格必须与真图那一格逐项相同。
+ *
+ *  **不变量（写死在这一件里，改它先改 `renderMediaFigure`）**：与 `renderMediaFigure` **同规格** ——
+ *  同一个宽高比容器（`<div class="ilife-block-media-frame …">` ＋ 本件要求的同一个 `ratio`）、
+ *  同一个圆角（14px）、同一条外边距（`figure` 的 `margin: 16px 0`）、同一个图注槽
+ *  （`figcaption.ilife-block-media-caption`）与补充槽（`.ilife-block-media-note`）。
+ *  **做法**：本件**不另写一套框**，整页交给 `renderMediaFigure` 装配——调用方就算把真图卡换成占位卡，
+ *  格子尺寸、圆角、外边距、图注位一处都不会变。缺的只是框里那点内容：`reason` 一句 ＋（可选）`next` 一句。
+ *
+ *  **不新增颜色**：框底用 `--soft`、框线用 `--line`（都来自 `.ilife-block-media-frame` 既有规则），
+ *  两句人话只用既有语义词 `--fg2`（主句）／`--fg3`（下一步）；不新造色值、不新造类名前缀。 */
+export function renderMediaPlaceholder(input) {
+    const alt = reqText(input.alt, 'renderMediaPlaceholder: input.alt');
+    const ratio = input.ratio;
+    if (!MEDIA_RATIOS.includes(ratio)) {
+        throw new Error('pageShapes: renderMediaPlaceholder: input.ratio 只许 ' + MEDIA_RATIOS.join('／'));
+    }
+    const reason = reqText(input.reason, 'renderMediaPlaceholder: input.reason');
+    const next = optText(input.next, 'renderMediaPlaceholder: input.next');
+    const fit = input.fit ?? 'contain';
+    if (fit !== 'contain' && fit !== 'cover') {
+        throw new Error('pageShapes: renderMediaPlaceholder: input.fit 只许 contain／cover');
+    }
+    const inner = '<div class="ilife-block-media-empty">'
+        + '<div class="ilife-block-media-reason">' + esc(reason) + '</div>'
+        + (next === undefined ? '' : '<div class="ilife-block-media-next">' + esc(next) + '</div>')
+        + '</div>';
+    // 同规格复用：容器比例／圆角／外边距与图注两槽都走同一个装配件，本件不复制那段标记。
+    return renderMediaFrame({
+        alt,
+        ratio,
+        fit,
+        innerHtml: inner,
+        caption: optText(input.caption, 'renderMediaPlaceholder: input.caption'),
+        note: optText(input.note, 'renderMediaPlaceholder: input.note'),
+        id: optText(input.id, 'renderMediaPlaceholder: input.id'),
+    });
+}
+/** 本件样式段（族组装器 `pageShapeCss()` 按原顺序拼回）。 */
+export function mediaCss(p, root) {
+    return [
+        '/* ② 图片／GIF 容器：比例写在容器上，图按 object-fit 摆；没有图时是人话占位，不出黑底条。 */',
+        root + ' .' + p + 'block-media {',
+        '  margin: 16px 0;',
+        '}',
+        root + ' .' + p + 'block-media-frame {',
+        '  position: relative;',
+        '  overflow: hidden;',
+        '  width: 100%;',
+        '  max-width: 100%;',
+        // #530：`width:100%`＋`border:1px` 在 content-box 下＝100%＋2px，09-02 在 768／1440 档
+        // 恰好溢出 2px（回归门红）。框自己吃 border-box，不碰全局盒模型。
+        '  box-sizing: border-box;',
+        '  border: 1px solid var(--line);',
+        '  border-radius: ' + 14 + 'px;',
+        '  background: var(--soft);',
+        '}',
+        root + ' .' + p + 'block-media-frame-1-1 { aspect-ratio: 1 / 1; }',
+        root + ' .' + p + 'block-media-frame-3-4 { aspect-ratio: 3 / 4; }',
+        root + ' .' + p + 'block-media-frame-4-5 { aspect-ratio: 4 / 5; }',
+        root + ' .' + p + 'block-media-frame-4-3 { aspect-ratio: 4 / 3; }',
+        root + ' .' + p + 'block-media-frame-9-16 { aspect-ratio: 9 / 16; }',
+        root + ' .' + p + 'block-media-frame-16-9 { aspect-ratio: 16 / 9; }',
+        root + ' .' + p + 'block-media-frame-natural {',
+        '  aspect-ratio: auto;',
+        '}',
+        root + ' .' + p + 'block-media-img {',
+        '  display: block;',
+        '  width: 100%;',
+        '  height: 100%;',
+        '  max-width: 100%;',
+        '}',
+        root + ' .' + p + 'block-media-frame-contain .' + p + 'block-media-img {',
+        '  object-fit: contain;',
+        '}',
+        root + ' .' + p + 'block-media-frame-cover .' + p + 'block-media-img {',
+        '  object-fit: cover;',
+        '}',
+        root + ' .' + p + 'block-media-frame-empty {',
+        '  display: flex;',
+        '  align-items: center;',
+        '  justify-content: center;',
+        '  box-sizing: border-box;',
+        '  height: 100%;',
+        '  padding: 24px 18px;',
+        '  color: var(--fg2);',
+        '  font-size: 13px;',
+        '  line-height: 1.6;',
+        '  text-align: center;',
+        '}',
+        root + ' .' + p + 'block-media-caption {',
+        '  margin-top: 8px;',
+        '  color: var(--fg);',
+        // #567 J4（§5.2 区块标题 15 吸收 14／15）。
+        '  font-size: 15px;',
+        '  font-weight: 600;',
+        '}',
+        root + ' .' + p + 'block-media-note {',
+        '  margin-top: 2px;',
+        '  color: var(--fg2);',
+        '  font-size: 12px;',
+        '  line-height: 1.6;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* ②b 占位件（`renderMediaPlaceholder`）：框体走上面 ② 的同一套规则（同比例／同圆角／同外边距），',
+        '   这里只补框内那两句人话的槽位；只用既有语义词，不新增颜色。 */',
+        root + ' .' + p + 'block-media-empty {',
+        '  display: flex;',
+        '  flex-direction: column;',
+        '  gap: 6px;',
+        '  box-sizing: border-box;',
+        '  height: 100%;',
+        '  padding: 0 18px;',
+        '  align-items: center;',
+        '  justify-content: center;',
+        '  text-align: center;',
+        '}',
+        root + ' .' + p + 'block-media-reason {',
+        '  color: var(--fg2);',
+        '  font-size: 13px;',
+        '  line-height: 1.6;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        root + ' .' + p + 'block-media-next {',
+        '  color: var(--fg3);',
+        '  font-size: 12px;',
+        '  line-height: 1.6;',
+        '  overflow-wrap: anywhere;',
+        '}',
+    ];
+}

package/dist/components/page/media.js.map

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

package/dist/components/page/shared.d.ts

@@ -0,0 +1,12 @@
+/** 页面级形状族的**共用小件**（三个产出器共用；本件不是组件）。
+ *
+ *  **住址**：目录化批次②从 `src/pageShapes.ts` 的件头小件原样搬来。
+ *  待办：组件层共用件（`src/components/shared/`）落地并提交后，本件应并进那一处，
+ *  不在两处各留一份转义表（铁律二）。此刻**不并**：那一处还没进版本库，引用未跟踪文件
+ *  会让本提交单独检出时编译不过。
+ */
+/** 五字符转义表（与 `blocks.ts` 的 `esc` 逐字同口径，本件不引区块层内部件）。 */
+export declare function esc(value: string): string;
+export declare function reqText(value: unknown, field: string): string;
+export declare function optText(value: unknown, field: string): string | undefined;
+//# sourceMappingURL=shared.d.ts.map

package/dist/components/page/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/components/page/shared.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sDAAsD;AACtD,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQzC;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIzE"}

package/dist/components/page/shared.js

@@ -0,0 +1,34 @@
+/** 页面级形状族的**共用小件**（三个产出器共用；本件不是组件）。
+ *
+ *  **住址**：目录化批次②从 `src/pageShapes.ts` 的件头小件原样搬来。
+ *  待办：组件层共用件（`src/components/shared/`）落地并提交后，本件应并进那一处，
+ *  不在两处各留一份转义表（铁律二）。此刻**不并**：那一处还没进版本库，引用未跟踪文件
+ *  会让本提交单独检出时编译不过。
+ */
+/** 五字符转义表（与 `blocks.ts` 的 `esc` 逐字同口径，本件不引区块层内部件）。 */
+export function esc(value) {
+    return value.replace(/[&<>"']/g, (ch) => {
+        if (ch === '&')
+            return '&amp;';
+        if (ch === '<')
+            return '&lt;';
+        if (ch === '>')
+            return '&gt;';
+        if (ch === '"')
+            return '&quot;';
+        return '&#39;';
+    });
+}
+export function reqText(value, field) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new Error('pageShapes: ' + field + ' 必须是非空字符串');
+    }
+    return value;
+}
+export function optText(value, field) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== 'string')
+        throw new Error('pageShapes: ' + field + ' 必须是字符串');
+    return value === '' ? undefined : value;
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/components/page/shared.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sDAAsD;AACtD,MAAM,UAAU,GAAG,CAAC,KAAa;IAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE;QACtC,IAAI,EAAE,KAAK,GAAG;YAAE,OAAO,OAAO,CAAC;QAC/B,IAAI,EAAE,KAAK,GAAG;YAAE,OAAO,MAAM,CAAC;QAC9B,IAAI,EAAE,KAAK,GAAG;YAAE,OAAO,MAAM,CAAC;QAC9B,IAAI,EAAE,KAAK,GAAG;YAAE,OAAO,QAAQ,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,KAAa;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,cAAc,GAAG,KAAK,GAAG,WAAW,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,KAAa;IACnD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,cAAc,GAAG,KAAK,GAAG,SAAS,CAAC,CAAC;IACnF,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1C,CAAC"}

package/dist/components/page/style.d.ts

@@ -0,0 +1,5 @@
+/** 形状件的样式唯一产出者（①②③ 三支 ＋ ②b 占位件 ＋ ④ 汇总的两族）。 */
+export declare function pageShapeCss(input?: {
+    readonly prefix?: string;
+}): string;
+//# sourceMappingURL=style.d.ts.map

package/dist/components/page/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/page/style.ts"],"names":[],"mappings":"AAcA,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAczE"}

package/dist/components/page/style.js

@@ -0,0 +1,28 @@
+/** 页面级形状族**样式组装器**（`pageShapeCss()`）：本族三支的样式段按原顺序拼回，
+ *  末尾再汇总 `#950` 两族（导航／横条）。恒返回非空 CSS 文本。
+ *
+ *  **住址**：目录化批次②从 `src/pageShapes.ts` 搬来；**拼装顺序一个字未改**（顺序是产物的一部分）。
+ */
+import { pageNavCss } from '../page-nav/index.js';
+import { pageBarsCss } from '../page-bars/index.js';
+import { factStripCss } from './fact-strip.js';
+import { mediaCss } from './media.js';
+import { timelineCss } from './timeline.js';
+/** 换行（仓库口径：不写字面换行转义，与 `blocks.ts` 同）。 */
+const LF = String.fromCharCode(10);
+/** 形状件的样式唯一产出者（①②③ 三支 ＋ ②b 占位件 ＋ ④ 汇总的两族）。 */
+export function pageShapeCss(input) {
+    const p = input !== undefined && input !== null
+        && typeof input.prefix === 'string' && input.prefix !== '' ? input.prefix : 'ilife-';
+    const root = '.' + p + 'page-ui';
+    return [
+        '/* #525 页面级形状件三件 */',
+        ...factStripCss(p, root),
+        ...mediaCss(p, root),
+        ...timelineCss(p, root),
+        '/* ④ 导航族与横条族（#950）：样式住在各自的姊妹件里，出口经本函数汇总；',
+        '   顺序在页面级配方与形状件之后，同权重时按「后出现」取胜。 */',
+        pageNavCss({ prefix: p }),
+        pageBarsCss({ prefix: p }),
+    ].join(LF);
+}

package/dist/components/page/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../../../src/components/page/style.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,yCAAyC;AACzC,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAEnC,8CAA8C;AAC9C,MAAM,UAAU,YAAY,CAAC,KAAoC;IAC/D,MAAM,CAAC,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;WAC1C,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;IACvF,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC;IACjC,OAAO;QACD,qBAAqB;QACzB,GAAG,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC;QACxB,GAAG,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC;QACpB,GAAG,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC;QACrB,0CAA0C;QAC1C,oCAAoC;QACpC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QACzB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;KAC7B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACb,CAAC"}

package/dist/components/page/timeline.d.ts

@@ -0,0 +1,25 @@
+/** 页面级形状件 ③**时间轴条**（`renderTimelineRows`）。
+ *
+ *  左侧一条轴线＋圆点，时间与正文分两槽。
+ *
+ *  **住址**：目录化批次②把它从 `src/pageShapes.ts` 搬到这里（正文原样，判据＝产物逐字节相同，
+ *  见 `docs/base/base-render/组件目录架构.md`）。
+ */
+export interface TimelineRowInput {
+    /** 时间槽（人话串，如「5 月 30 日」）。 */
+    readonly time: string;
+    /** 主文（这一条发生了什么）。 */
+    readonly main: string;
+    /** 补充说明（可省）。 */
+    readonly note?: string;
+}
+export interface TimelineRowsInput {
+    readonly rows: readonly TimelineRowInput[];
+    /** 版面根的附加类名（空格分隔）。 */
+    readonly extraClass?: string;
+}
+/** 时间轴条：一串「时间 ＋ 做了什么」的呈现形状。0 条＝空串。 */
+export declare function renderTimelineRows(input: TimelineRowsInput): string;
+/** 本件样式段（族组装器 `pageShapeCss()` 按原顺序拼回）。 */
+export declare function timelineCss(p: string, root: string): string[];
+//# sourceMappingURL=timeline.d.ts.map

package/dist/components/page/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../../src/components/page/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC3C,sBAAsB;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,sCAAsC;AACtC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAkBnE;AAED,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA+C7D"}

package/dist/components/page/timeline.js

@@ -0,0 +1,79 @@
+/** 页面级形状件 ③**时间轴条**（`renderTimelineRows`）。
+ *
+ *  左侧一条轴线＋圆点，时间与正文分两槽。
+ *
+ *  **住址**：目录化批次②把它从 `src/pageShapes.ts` 搬到这里（正文原样，判据＝产物逐字节相同，
+ *  见 `docs/base/base-render/组件目录架构.md`）。
+ */
+import { esc, reqText, optText } from './shared.js';
+/** 时间轴条：一串「时间 ＋ 做了什么」的呈现形状。0 条＝空串。 */
+export function renderTimelineRows(input) {
+    const rows = input.rows;
+    if (!Array.isArray(rows))
+        throw new Error('pageShapes: renderTimelineRows: input.rows 必须是数组');
+    if (rows.length === 0)
+        return '';
+    const extra = optText(input.extraClass, 'renderTimelineRows: input.extraClass');
+    const body = rows.map((row, i) => {
+        const field = 'renderTimelineRows: input.rows[' + i + ']';
+        const time = reqText(row.time, field + '.time');
+        const main = reqText(row.main, field + '.main');
+        const note = optText(row.note, field + '.note');
+        return '<li class="ilife-block-timeline-row">'
+            + '<span class="ilife-block-timeline-dot" aria-hidden="true"></span>'
+            + '<span class="ilife-block-timeline-time">' + esc(time) + '</span>'
+            + '<span class="ilife-block-timeline-main">' + esc(main) + '</span>'
+            + (note === undefined ? '' : '<span class="ilife-block-timeline-note">' + esc(note) + '</span>')
+            + '</li>';
+    }).join('');
+    return '<ol class="ilife-block-timeline' + (extra === undefined ? '' : ' ' + extra) + '">' + body + '</ol>';
+}
+/** 本件样式段（族组装器 `pageShapeCss()` 按原顺序拼回）。 */
+export function timelineCss(p, root) {
+    return [
+        '/* ③ 时间轴条：一条轴线 ＋ 逐条圆点；时间与正文分两槽（不用 · 串）。 */',
+        root + ' .' + p + 'block-timeline {',
+        '  margin: 16px 0;',
+        '  padding: 4px 0 4px 18px;',
+        '  border-left: 1px solid var(--line);',
+        '  list-style: none;',
+        '}',
+        root + ' .' + p + 'block-timeline-row {',
+        '  position: relative;',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  gap: 2px 12px;',
+        '  align-items: baseline;',
+        '  padding: 6px 0;',
+        '}',
+        root + ' .' + p + 'block-timeline-dot {',
+        '  position: absolute;',
+        '  left: -23px;',
+        '  top: 13px;',
+        '  width: 9px;',
+        '  height: 9px;',
+        '  border-radius: 50%;',
+        '  background: var(--blue);',
+        '}',
+        root + ' .' + p + 'block-timeline-time {',
+        '  flex: 0 0 auto;',
+        '  color: var(--fg2);',
+        '  font-size: 13px;',
+        '  font-variant-numeric: tabular-nums;',
+        '}',
+        root + ' .' + p + 'block-timeline-main {',
+        '  flex: 1 1 auto;',
+        '  min-width: 0;',
+        '  color: var(--fg);',
+        // #567 J4（§5.2 区块标题 15 吸收 14／15）。
+        '  font-size: 15px;',
+        '  font-weight: 600;',
+        '}',
+        root + ' .' + p + 'block-timeline-note {',
+        '  flex: 1 1 100%;',
+        '  color: var(--fg3);',
+        '  font-size: 12px;',
+        '  line-height: 1.6;',
+        '}',
+    ];
+}

package/dist/components/page/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../../src/components/page/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAoBpD,sCAAsC;AACtC,MAAM,UAAU,kBAAkB,CAAC,KAAwB;IACzD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAC9F,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,sCAAsC,CAAC,CAAC;IAChF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAC/B,MAAM,KAAK,GAAG,iCAAiC,GAAG,CAAC,GAAG,GAAG,CAAC;QAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC;QAChD,OAAO,uCAAuC;cAC1C,mEAAmE;cACnE,0CAA0C,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,SAAS;cAClE,0CAA0C,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,SAAS;cAClE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,0CAA0C,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;cAC9F,OAAO,CAAC;IACd,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,iCAAiC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC;AAC9G,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,IAAY;IACjD,OAAO;QACH,4CAA4C;QAC5C,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,kBAAkB;QACpC,mBAAmB;QACnB,4BAA4B;QAC5B,uCAAuC;QACvC,qBAAqB;QACrB,GAAG;QACH,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,sBAAsB;QACxC,uBAAuB;QACvB,kBAAkB;QAClB,oBAAoB;QACpB,kBAAkB;QAClB,0BAA0B;QAC1B,mBAAmB;QACnB,GAAG;QACH,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,sBAAsB;QACxC,uBAAuB;QACvB,gBAAgB;QAChB,cAAc;QACd,eAAe;QACf,gBAAgB;QAChB,uBAAuB;QACvB,4BAA4B;QAC5B,GAAG;QACH,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,uBAAuB;QACzC,mBAAmB;QACnB,sBAAsB;QACtB,oBAAoB;QACpB,uCAAuC;QACvC,GAAG;QACH,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,uBAAuB;QACzC,mBAAmB;QACnB,iBAAiB;QACjB,qBAAqB;QACrB,kCAAkC;QAClC,oBAAoB;QACpB,qBAAqB;QACrB,GAAG;QACH,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,uBAAuB;QACzC,mBAAmB;QACnB,sBAAsB;QACtB,oBAAoB;QACpB,qBAAqB;QACrB,GAAG;KACN,CAAC;AACJ,CAAC"}