skill-calorie 0.2.3 → 0.2.4

package/dist/photo/photo.js

@@ -0,0 +1,279 @@
+import { existsSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { getPhotoRow, listPhotos, planGif, tagsContain, } from './photos.js';
+import { shiftISODate, todayISO } from '../analysis/utils.js';
+import { CalorieRenderError } from '../render/errors.js';
+import { buildCrudReceipt } from '../render/receipt.js';
+export function toCard(row, photosDir) {
+    let fileExists = null;
+    if (photosDir) {
+        try {
+            fileExists = existsSync(join(photosDir, basename(row.photo_path)));
+        }
+        catch {
+            fileExists = false;
+        }
+    }
+    return {
+        id: row.id,
+        date: row.date,
+        time: row.time,
+        photoPath: basename(row.photo_path),
+        tagList: [...row.tag_list],
+        note: row.note,
+        fileExists,
+    };
+}
+const ISO_RE = /^\d{4}-\d{2}-\d{2}$/;
+function assertISO(v, field) {
+    if (!ISO_RE.test(v))
+        throw new CalorieRenderError('bad-input', field + ' 非法（须 YYYY-MM-DD）：' + v);
+}
+function diffDays(a, b) {
+    return Math.round((Date.parse(b + 'T12:00:00Z') - Date.parse(a + 'T12:00:00Z')) / 86400000);
+}
+/** 看身材照：网格 + 时间/标签筛选 + 计数（老家 gallery build 对应，默认 90 天窗）。 */
+export function buildGalleryData(db, filter = {}, photosDir) {
+    const today = filter.today ?? todayISO();
+    assertISO(today, 'today');
+    let dateFrom = filter.dateFrom ?? '';
+    let dateTo = filter.dateTo ?? '';
+    if (dateFrom)
+        assertISO(dateFrom, 'dateFrom');
+    if (dateTo)
+        assertISO(dateTo, 'dateTo');
+    if (dateFrom && !dateTo)
+        dateTo = dateFrom;
+    if (!dateFrom && !dateTo) {
+        const days = filter.days ?? 90;
+        if (!Number.isInteger(days) || days < 1 || days > 36500) {
+            throw new CalorieRenderError('bad-input', 'days 须为 1..36500 整数');
+        }
+        dateTo = today;
+        dateFrom = shiftISODate(today, -(days - 1));
+    }
+    if (dateFrom > dateTo)
+        throw new CalorieRenderError('bad-input', 'dateFrom 不得晚于 dateTo');
+    const rows = listPhotos(db, {
+        dateFrom,
+        dateTo,
+        tag: filter.tag ?? null,
+        limit: filter.limit === undefined ? 500 : filter.limit,
+    });
+    if (rows.length === 0) {
+        throw new CalorieRenderError('missing-data', '无身材照（' + dateFrom + ' ~ ' + dateTo + (filter.tag ? ' · 标签 ' + filter.tag : '') + '）');
+    }
+    const counts = new Map();
+    for (const r of listPhotos(db, { days: 36500, limit: null })) {
+        for (const t of r.tag_list)
+            counts.set(t, (counts.get(t) ?? 0) + 1);
+    }
+    const daysSinceLast = diffDays(rows[0]?.date, today) >= 0 ? diffDays(rows[0]?.date, today) : null;
+    return {
+        scene: '看身材照',
+        filters: { tag: filter.tag ?? '', dateFrom, dateTo },
+        totalCount: rows.length,
+        tagCounts: [...counts.entries()].sort((a, b) => (a[0] < b[0] ? -1 : 1)).map(([tag, count]) => ({ tag, count })),
+        daysSinceLast,
+        photos: rows.map((r) => toCard(r, photosDir)),
+    };
+}
+/** 对比两张照片：并排 + 间隔天数 + 跨标签警告（老家方案 B：警告不拦截）。 */
+export function buildCompareData(db, id1, id2, photosDir) {
+    if (!Number.isInteger(id1) || !Number.isInteger(id2)) {
+        throw new CalorieRenderError('bad-input', '照片 id 须为整数');
+    }
+    if (id1 === id2)
+        throw new CalorieRenderError('bad-input', '对比的两张照片不能是同一张');
+    const p1 = getPhotoRow(db, id1);
+    if (!p1)
+        throw new CalorieRenderError('missing-data', '照片 #' + id1 + ' 不存在');
+    const p2 = getPhotoRow(db, id2);
+    if (!p2)
+        throw new CalorieRenderError('missing-data', '照片 #' + id2 + ' 不存在');
+    const intervalDays = Math.abs(diffDays(p1.date, p2.date));
+    const crossTagWarning = [...p1.tag_list].sort().join(',') !== [...p2.tag_list].sort().join(',');
+    return {
+        scene: '对比两张照片',
+        photo1: toCard(p1, photosDir),
+        photo2: toCard(p2, photosDir),
+        intervalDays,
+        orderByDate: p1.date <= p2.date,
+        crossTagWarning,
+    };
+}
+/** 单图查看：照片 + 同标签 prev/next（老家 viewer 邻居口径：同 tag 按日期排序）。 */
+export function buildViewerData(db, id, photosDir) {
+    if (!Number.isInteger(id))
+        throw new CalorieRenderError('bad-input', '照片 id 须为整数');
+    const row = getPhotoRow(db, id);
+    if (!row)
+        throw new CalorieRenderError('missing-data', '照片 #' + id + ' 不存在');
+    const anchor = row.tag_list[0];
+    const pool = listPhotos(db, { days: 36500, limit: null })
+        .filter((r) => (anchor ? tagsContain(r.tag, anchor) : true))
+        .sort((a, b) => (a.date + ' ' + (a.time ?? '') + '#' + a.id < b.date + ' ' + (b.time ?? '') + '#' + b.id ? -1 : 1));
+    const idx = pool.findIndex((r) => r.id === id);
+    return {
+        scene: '查身材照',
+        photo: toCard(row, photosDir),
+        prevId: idx > 0 ? (pool[idx - 1]?.id ?? null) : null,
+        nextId: idx >= 0 && idx < pool.length - 1 ? (pool[idx + 1]?.id ?? null) : null,
+    };
+}
+export const GIF_PASSTHROUGH_NOTE = 'GIF 合成由外部按本任务描述执行，本渲染不碰二进制';
+/** 动图规划器：只出任务描述（T4 planGif 直通；photoIds 显式交集，不跑合成）。 */
+export function buildGifTask(db, input) {
+    const tag = String(input.tag ?? '').trim();
+    if (!tag)
+        throw new CalorieRenderError('bad-input', 'tag 必填（GIF 按标签选照片）');
+    if (input.dateFrom)
+        assertISO(input.dateFrom, 'dateFrom');
+    if (input.dateTo)
+        assertISO(input.dateTo, 'dateTo');
+    const plan = planGif(db, {
+        tag,
+        dateFrom: input.dateFrom ?? null,
+        dateTo: input.dateTo ?? null,
+        days: input.days ?? 90,
+    });
+    let ids = [...plan.photoIds];
+    if (input.photoIds) {
+        const want = new Set(input.photoIds);
+        ids = ids.filter((x) => want.has(x));
+    }
+    // #100 · 空库阻断：零匹配即 missing-data，不返 photoCount=0 的"共 0 张"合成页（exit 4）。
+    if (ids.length === 0) {
+        throw new CalorieRenderError('missing-data', '无匹配照片（标签 ' + tag + '，检查标签/日期范围）');
+    }
+    let firstDate = plan.dateFrom;
+    let lastDate = plan.dateTo;
+    if (input.photoIds) {
+        const dates = ids
+            .map((x) => getPhotoRow(db, x))
+            .filter((r) => r !== null && tagsContain(r.tag, tag))
+            .map((r) => r.date)
+            .sort();
+        firstDate = dates.length > 0 ? dates[0] : null;
+        lastDate = dates.length > 0 ? dates[dates.length - 1] : null;
+    }
+    return {
+        task: 'generate_gif',
+        tag,
+        dateFrom: firstDate,
+        dateTo: lastDate,
+        photoCount: ids.length,
+        photoIds: ids,
+        firstDate,
+        lastDate,
+        note: GIF_PASSTHROUGH_NOTE,
+    };
+}
+/** 没落库的源文件：`addPhotos` 跳过不存在的源文件（`photos.ts:155` 同一判据，装配当刻按同一
+ *  条件复算），故逐张失败行能点名是哪一个文件、为什么没进来。 */
+function missingSourcesOf(srcPaths) {
+    if (srcPaths === undefined || srcPaths.length === 0)
+        return [];
+    return srcPaths.filter((p) => {
+        try {
+            return !existsSync(p);
+        }
+        catch {
+            return true;
+        }
+    });
+}
+/** 存照片回执：单张/含备注/批量（items 逐张状态由调用方按 T4 addPhotos 结果组装）。
+ *
+ * #476 两处修正：
+ * - **失败张逐张上页**：以前失败的不进 `items`（`addPhotos` 直接跳过），逐张状态恒「成功」，
+ *   页面只在摘要给个数字——现在按 `srcPaths` 复算缺哪些，逐条以 `status:'失败'` ＋ `reason`
+ *   入 items（点名源文件），页面逐张印出。
+ * - **`distance` 真传进回执**：原来只在摘要里印，`buildCrudReceipt` 没收到这一位，专用卡恒是死支。
+ *   摘要里那句同时删掉（同一件事不再印两遍），改由页面上的独立小卡说。 */
+export function buildAddReceipt(added, opts) {
+    const scene = added.length > 1 ? '批量存照片' : (opts.note ? '存照片（含备注）' : '存一张照片');
+    const missing = missingSourcesOf(opts.srcPaths);
+    const failedCount = missing.length > 0 ? missing.length : (opts.failedCount ?? 0);
+    let summary = '已存入 ' + added.length + ' 张身材照';
+    if (failedCount > 0)
+        summary += '，' + failedCount + ' 张未存入';
+    return buildCrudReceipt({
+        scene,
+        action: 'add',
+        op: 'create',
+        recordId: added.length > 0 ? (added[0]?.id ?? null) : null,
+        summary,
+        items: [
+            ...added.map((a) => ({ id: a.id, file: a.file, status: '成功', reason: '' })),
+            ...missing.map((p) => ({ file: basename(p), status: '失败', reason: '源文件不存在（或读不到）' })),
+        ],
+        distance: opts.distance ?? null,
+        wakeWord: '记身材照',
+        source: 'body_photos (写库回执)',
+    });
+}
+/** 删照片回执：删除前快照（调用方先 getPhotoRow 取快照，再调 T4 deletePhoto）。
+ *
+ * #101 删除可恢复性口径：`body_photos` 走 `DELETE FROM` ＋ 删文件，属**硬删除**，
+ * 故文案必须显式标注「硬删除，不可恢复」；软删除键（行保留）一律**不承诺可恢复**
+ * （全仓 0 个 restore/undo/recover 入口），词条与 `items[].status` 同源。
+ *
+ * #476：这两串是**机器口径**——写链三源一致判据钉着它们（`cmd-write-40-persist` 比
+ * prose／items[].status／库内行三处），本票一字不改；页面可见文本改词「永久删除，无法恢复」
+ * 且全页只留 1 处，由 `receipt.ts` 自写副标题与状态句承担（页面不再直接印这两串）。
+ */
+export function buildDeleteReceipt(snapshot) {
+    const tags = [...snapshot.tag_list].join('、') || '无标签';
+    const summary = '已删除身材照 #' + snapshot.id + '(' + snapshot.date + ' · ' + tags + ')' +
+        (snapshot.note ? ' · ' + snapshot.note : '') + '（硬删除，不可恢复）';
+    return buildCrudReceipt({
+        scene: '删身材照',
+        action: 'delete',
+        op: 'delete',
+        recordId: snapshot.id,
+        summary,
+        items: [{
+                id: snapshot.id,
+                date: snapshot.date,
+                photoPath: basename(snapshot.photo_path),
+                tagList: [...snapshot.tag_list],
+                status: '已删除（硬，不可恢复）',
+                reason: '',
+            }],
+        wakeWord: '删身材照',
+        source: 'body_photos (删除快照)',
+    });
+}
+/** 标签回执：改前/改后对比 + 无变化明示（set 整套覆盖 / add 追加判重 / remove 移除）。 */
+export function buildTagReceipt(photoId, before, after, scene) {
+    if (!Number.isInteger(photoId))
+        throw new CalorieRenderError('bad-input', '照片 id 须为整数');
+    const noChange = [...before].join(',') === [...after].join(',');
+    let summary;
+    if (scene === '改照片标签') {
+        summary = '照片 #' + photoId + ' 标签已改为：' + after.join('、') + (noChange ? '；以上标签与原来一致，未产生实际变化' : '');
+    }
+    else if (scene === '加照片标签') {
+        summary = noChange
+            ? '⚠ 标签已存在（当前标签：' + before.join('、') + '），未做修改'
+            : '已为照片 #' + photoId + ' 追加标签，当前标签：' + after.join('、');
+    }
+    else {
+        summary = noChange
+            ? '⚠ 标签不存在（当前标签：' + before.join('、') + '），未做修改'
+            : '已从照片 #' + photoId + ' 移除标签，剩余标签：' + after.join('、');
+    }
+    return buildCrudReceipt({
+        scene,
+        action: scene,
+        op: 'update',
+        recordId: photoId,
+        summary,
+        tagDiff: { before: [...before], after: [...after] },
+        noChange,
+        wakeWord: scene,
+        source: 'body_photos (标签更新)',
+    });
+}
+//# sourceMappingURL=photo.js.map

package/dist/photo/photo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"photo.js","sourceRoot":"","sources":["../../src/photo/photo.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACL,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,GAE9C,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAwC,MAAM,sBAAsB,CAAC;AAa9F,MAAM,UAAU,MAAM,CAAC,GAAa,EAAE,SAAyB;IAC7D,IAAI,UAAU,GAAmB,IAAI,CAAC;IACtC,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC;YACH,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC;QACnC,OAAO,EAAE,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,MAAM,GAAG,qBAAqB,CAAC;AAErC,SAAS,SAAS,CAAC,CAAS,EAAE,KAAa;IACzC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,KAAK,GAAG,oBAAoB,GAAG,CAAC,CAAC,CAAC;AACnG,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS,EAAE,CAAS;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,YAAY,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;AAC9F,CAAC;AAoBD,4DAA4D;AAC5D,MAAM,UAAU,gBAAgB,CAAC,EAAgB,EAAE,SAAwB,EAAE,EAAE,SAAyB;IACtG,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,QAAQ,EAAE,CAAC;IACzC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC1B,IAAI,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IACrC,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACjC,IAAI,QAAQ;QAAE,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC9C,IAAI,MAAM;QAAE,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxC,IAAI,QAAQ,IAAI,CAAC,MAAM;QAAE,MAAM,GAAG,QAAQ,CAAC;IAC3C,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;YACxD,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,GAAG,KAAK,CAAC;QACf,QAAQ,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,QAAQ,GAAG,MAAM;QAAE,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAAC;IACzF,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,EAAE;QAC1B,QAAQ;QACR,MAAM;QACN,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK;KACvD,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC;IACtI,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC7D,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAc,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAc,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtH,OAAO;QACL,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;QACpD,UAAU,EAAE,IAAI,CAAC,MAAM;QACvB,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/G,aAAa;QACb,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;KAC9C,CAAC;AACJ,CAAC;AAWD,8CAA8C;AAC9C,MAAM,UAAU,gBAAgB,CAAC,EAAgB,EAAE,GAAW,EAAE,GAAW,EAAE,SAAyB;IACpG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,GAAG,KAAK,GAAG;QAAE,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IAC5E,MAAM,EAAE,GAAG,WAAW,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC;IAC7E,MAAM,EAAE,GAAG,WAAW,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC;IAC7E,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChG,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;QAC7B,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;QAC7B,YAAY;QACZ,WAAW,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI;QAC/B,eAAe;KAChB,CAAC;AACJ,CAAC;AASD,2DAA2D;AAC3D,MAAM,UAAU,eAAe,CAAC,EAAgB,EAAE,EAAU,EAAE,SAAyB;IACrF,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACnF,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;SACtD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAC3D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtH,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/C,OAAO;QACL,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC;QAC7B,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;QACpD,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;KAC/E,CAAC;AACJ,CAAC;AAcD,MAAM,CAAC,MAAM,oBAAoB,GAAG,4BAA4B,CAAC;AAEjE,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAC1B,EAAgB,EAChB,KAAmH;IAEnH,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;IAC1E,IAAI,KAAK,CAAC,QAAQ;QAAE,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC1D,IAAI,KAAK,CAAC,MAAM;QAAE,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,EAAE;QACvB,GAAG;QACH,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;QAChC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;KACvB,CAAC,CAAC;IACH,IAAI,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7B,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACrC,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,qEAAqE;IACrE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,WAAW,GAAG,GAAG,GAAG,aAAa,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC9B,IAAI,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,GAAG;aACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;aAC9B,MAAM,CAAC,CAAC,CAAC,EAAiB,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;aACnE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,EAAE,CAAC;QACV,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,CAAC,CAAY,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3D,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,CAAC;IACD,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,GAAG;QACH,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE,GAAG,CAAC,MAAM;QACtB,QAAQ,EAAE,GAAG;QACb,SAAS;QACT,QAAQ;QACR,IAAI,EAAE,oBAAoB;KAC3B,CAAC;AACJ,CAAC;AAOD;oCACoC;AACpC,SAAS,gBAAgB,CAAC,QAAuC;IAC/D,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/D,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3B,IAAI,CAAC;YACH,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;yCAOyC;AACzC,MAAM,UAAU,eAAe,CAC7B,KAAmB,EACnB,IAAyH;IAEzH,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC9E,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;IAClF,IAAI,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC;IAC9C,IAAI,WAAW,GAAG,CAAC;QAAE,OAAO,IAAI,GAAG,GAAG,WAAW,GAAG,OAAO,CAAC;IAC5D,OAAO,gBAAgB,CAAC;QACtB,KAAK;QACL,MAAM,EAAE,KAAK;QACb,EAAE,EAAE,QAAQ;QACZ,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;QAC1D,OAAO;QACP,KAAK,EAAE;YACL,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YAC3E,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;SACrF;QACD,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;QAC/B,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,oBAAoB;KAC7B,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAkB;IACnD,MAAM,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;IACvD,MAAM,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC,EAAE,GAAG,GAAG,GAAG,QAAQ,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,GAAG;QACjF,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC;IAC9D,OAAO,gBAAgB,CAAC;QACtB,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,QAAQ;QAChB,EAAE,EAAE,QAAQ;QACZ,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,OAAO;QACP,KAAK,EAAE,CAAC;gBACN,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;gBACxC,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC;gBAC/B,MAAM,EAAE,aAAa;gBACrB,MAAM,EAAE,EAAE;aACX,CAAC;QACF,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,oBAAoB;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,MAAgB,EAChB,KAAe,EACf,KAAkC;IAElC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACxF,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChE,IAAI,OAAe,CAAC;IACpB,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACtB,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpG,CAAC;SAAM,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO,GAAG,QAAQ;YAChB,CAAC,CAAC,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ;YAC/C,CAAC,CAAC,QAAQ,GAAG,OAAO,GAAG,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,QAAQ;YAChB,CAAC,CAAC,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ;YAC/C,CAAC,CAAC,QAAQ,GAAG,OAAO,GAAG,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,gBAAgB,CAAC;QACtB,KAAK;QACL,MAAM,EAAE,KAAK;QACb,EAAE,EAAE,QAAQ;QACZ,QAAQ,EAAE,OAAO;QACjB,OAAO;QACP,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE;QACnD,QAAQ;QACR,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,oBAAoB;KAC7B,CAAC,CAAC;AACL,CAAC"}

package/dist/photo/photoThumb.d.ts

@@ -0,0 +1,38 @@
+/** 单张照片过大即不明示字节（防页面体积失控；上限见 `galleryDoc.ts` 的页级上限）。 */
+export declare const PHOTO_EMBED_MAX_BYTES: number;
+export interface PhotoEmbed {
+    readonly fileName: string;
+    readonly mime: string;
+    /** 内嵌成功即 `data:<mime>;base64,…`；失败即 `null`（原因见 `missing`）。 */
+    readonly dataUri: string | null;
+    readonly bytes: number | null;
+    /** 成功即 `null`；失败即面向用户的缺失句（含文件名，可直接断言）。 */
+    readonly missing: string | null;
+}
+/** 单张内嵌：缺目录／缺文件／过大一律回缺失句，不抛（缺失由页面明示哪张）。 */
+export declare function embedPhoto(photosDir: string | null | undefined, photoPath: string): PhotoEmbed;
+/** 批量内嵌（顺序与入参同序；逐张独立成败，互不牵连）。 */
+export declare function embedPhotos(photosDir: string | null | undefined, photos: ReadonlyArray<{
+    readonly photoPath: string;
+}>): PhotoEmbed[];
+/** 按字节预算挑选的结果：内嵌张数 ＋ 因预算未嵌入的张数 ＋ 逐张原因（键＝文件名）。 */
+export interface PhotoEmbedPicks {
+    readonly embeds: PhotoEmbed[];
+    readonly embeddedCount: number;
+    readonly budgetSkippedCount: number;
+    /** 预算未嵌的逐张原因句（键＝文件名；其余张不在表内）。调用方可再补记（页面兜底轮）。 */
+    readonly skipReason: Map<string, string>;
+}
+/** 预算未嵌的原因句（老正本口径：`embed_skipped` 前端显示「未嵌入(体积超限)」）。 */
+export declare const EMBED_BUDGET_REASON = "\u4F53\u79EF\u9884\u7B97\u672A\u5185\u5D4C";
+/** 按预算挑选要内嵌的哪些张：`baseBytes` 是**不含任何内嵌字节**的页面底子大小，
+ *  逐张按顺序试着加（`embeds` 与入参同序，故内嵌集恒是原序的一个子序列），
+ *  单张内嵌字节 ＋ 该张版面开销不超过剩余预算就嵌，否则去掉内嵌字节并标预算未嵌
+ *  （结果集里那张的 `dataUri` 恒为 null，装配处照 `skipReason` 印占位句）。
+ *  一张太大不牵连后面的小图（缺失／预算均逐张独立）。已缺失的张按原样透传。 */
+export declare function embedPhotosWithinBudget(photosDir: string | null | undefined, photos: ReadonlyArray<{
+    readonly photoPath: string;
+}>, baseBytes: number, maxPageBytes: number): PhotoEmbedPicks;
+/** 去掉逐张 data URI 的副本（只留承载：文件名／字节／失败句），供预算挑选后的页面拼装。 */
+export declare function withoutDataUri(e: PhotoEmbed): PhotoEmbed;
+//# sourceMappingURL=photoThumb.d.ts.map

package/dist/photo/photoThumb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photoThumb.d.ts","sourceRoot":"","sources":["../../src/photo/photoThumb.ts"],"names":[],"mappings":"AAkBA,uDAAuD;AACvD,eAAO,MAAM,qBAAqB,QAAkB,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAMD,2CAA2C;AAC3C,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAgB9F;AAED,iCAAiC;AACjC,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,MAAM,EAAE,aAAa,CAAC;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,GACpD,UAAU,EAAE,CAEd;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,+CAAY,CAAC;AAE7C;;;;2CAI2C;AAC3C,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,MAAM,EAAE,aAAa,CAAC;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,EACrD,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,eAAe,CAwBjB;AAKD,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,CAAC,EAAE,UAAU,GAAG,UAAU,CAExD"}

package/dist/photo/photoThumb.js

@@ -0,0 +1,83 @@
+/** #341 · 身材照片内嵌件（照片字节进页面）：读文件 → `data:` URI；缺失明示不抛。
+ *
+ * 住 `src/photo/` 内（票面口径：缩略图件住本能力目录，第二个用法出现才上移共用位）。
+ * 本件只做字节搬运（扩展名定 MIME＋读文件＋base64），不做缩放（老家 PIL 缩放+q75
+ * 在 T10 已有意舍弃，本票只证“字节进页面”这一险）；页面装配另见 `galleryDoc.ts`。
+ */
+import { readFileSync } from 'node:fs';
+import { basename, extname, join } from 'node:path';
+const MIME_OF = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.bmp': 'image/bmp',
+};
+/** 单张照片过大即不明示字节（防页面体积失控；上限见 `galleryDoc.ts` 的页级上限）。 */
+export const PHOTO_EMBED_MAX_BYTES = 4 * 1024 * 1024;
+function mimeOf(fileName) {
+    return MIME_OF[extname(fileName).toLowerCase()] ?? 'application/octet-stream';
+}
+/** 单张内嵌：缺目录／缺文件／过大一律回缺失句，不抛（缺失由页面明示哪张）。 */
+export function embedPhoto(photosDir, photoPath) {
+    const fileName = basename(photoPath);
+    const mime = mimeOf(fileName);
+    if (!photosDir) {
+        return { fileName, mime, dataUri: null, bytes: null, missing: '未配照片目录，只显文件名：' + fileName };
+    }
+    let buf;
+    try {
+        buf = readFileSync(join(photosDir, fileName));
+    }
+    catch {
+        return { fileName, mime, dataUri: null, bytes: null, missing: '文件缺失：' + fileName };
+    }
+    if (buf.length > PHOTO_EMBED_MAX_BYTES) {
+        return { fileName, mime, dataUri: null, bytes: buf.length, missing: '文件过大未内嵌（' + buf.length + ' 字节）：' + fileName };
+    }
+    return { fileName, mime, dataUri: 'data:' + mime + ';base64,' + buf.toString('base64'), bytes: buf.length, missing: null };
+}
+/** 批量内嵌（顺序与入参同序；逐张独立成败，互不牵连）。 */
+export function embedPhotos(photosDir, photos) {
+    return photos.map((p) => embedPhoto(photosDir, p.photoPath));
+}
+/** 预算未嵌的原因句（老正本口径：`embed_skipped` 前端显示「未嵌入(体积超限)」）。 */
+export const EMBED_BUDGET_REASON = '体积预算未内嵌';
+/** 按预算挑选要内嵌的哪些张：`baseBytes` 是**不含任何内嵌字节**的页面底子大小，
+ *  逐张按顺序试着加（`embeds` 与入参同序，故内嵌集恒是原序的一个子序列），
+ *  单张内嵌字节 ＋ 该张版面开销不超过剩余预算就嵌，否则去掉内嵌字节并标预算未嵌
+ *  （结果集里那张的 `dataUri` 恒为 null，装配处照 `skipReason` 印占位句）。
+ *  一张太大不牵连后面的小图（缺失／预算均逐张独立）。已缺失的张按原样透传。 */
+export function embedPhotosWithinBudget(photosDir, photos, baseBytes, maxPageBytes) {
+    let account = baseBytes;
+    const embeds = [];
+    const skipReason = new Map();
+    for (const p of photos) {
+        const e = embedPhoto(photosDir, p.photoPath);
+        if (e.dataUri === null) {
+            embeds.push(e);
+            continue;
+        }
+        const uriBytes = Buffer.byteLength(e.dataUri, 'utf8');
+        // 逐张版面开销（figure 与 figcaption 文本）按文件名长约估，宁可少嵌不多嵌。
+        const overhead = OVERHEAD_BASE_BYTES + e.fileName.length * 4;
+        if (account + uriBytes + overhead > maxPageBytes) {
+            // 预算未嵌的**必须去掉内嵌字节**再入集：留着 dataUri 会让装配处照样印 <img>，
+            // 退让就白做了（本票首版即栽在此处）。字节数留着，供兜底轮挑最大者。
+            skipReason.set(e.fileName, EMBED_BUDGET_REASON);
+            embeds.push(withoutDataUri(e));
+            continue;
+        }
+        account += uriBytes + overhead;
+        embeds.push(e);
+    }
+    return { embeds, embeddedCount: embeds.length - skipReason.size, budgetSkippedCount: skipReason.size, skipReason };
+}
+/** 单张 figure 的固定版面开销（标签／图注／花括号；宁可多估，故取 200）。 */
+const OVERHEAD_BASE_BYTES = 200;
+/** 去掉逐张 data URI 的副本（只留承载：文件名／字节／失败句），供预算挑选后的页面拼装。 */
+export function withoutDataUri(e) {
+    return e.dataUri === null ? e : { ...e, dataUri: null };
+}
+//# sourceMappingURL=photoThumb.js.map

package/dist/photo/photoThumb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"photoThumb.js","sourceRoot":"","sources":["../../src/photo/photoThumb.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,OAAO,GAA2B;IACtC,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;CACpB,CAAC;AAEF,uDAAuD;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAYrD,SAAS,MAAM,CAAC,QAAgB;IAC9B,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,0BAA0B,CAAC;AAChF,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,UAAU,CAAC,SAAoC,EAAE,SAAiB;IAChF,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,GAAG,QAAQ,EAAE,CAAC;IAC7F,CAAC;IACD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,QAAQ,EAAE,CAAC;IACrF,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,GAAG,qBAAqB,EAAE,CAAC;QACvC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,GAAG,CAAC,MAAM,GAAG,OAAO,GAAG,QAAQ,EAAE,CAAC;IACrH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC7H,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,WAAW,CACzB,SAAoC,EACpC,MAAqD;IAErD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAC/D,CAAC;AAWD,uDAAuD;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAE7C;;;;2CAI2C;AAC3C,MAAM,UAAU,uBAAuB,CACrC,SAAoC,EACpC,MAAqD,EACrD,SAAiB,EACjB,YAAoB;IAEpB,IAAI,OAAO,GAAG,SAAS,CAAC;IACxB,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACf,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACtD,iDAAiD;QACjD,MAAM,QAAQ,GAAG,mBAAmB,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAC7D,IAAI,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,EAAE,CAAC;YACjD,kDAAkD;YAClD,oCAAoC;YACpC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;YAChD,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,SAAS;QACX,CAAC;QACD,OAAO,IAAI,QAAQ,GAAG,QAAQ,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,kBAAkB,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC;AACrH,CAAC;AAED,gDAAgD;AAChD,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,sDAAsD;AACtD,MAAM,UAAU,cAAc,CAAC,CAAa;IAC1C,OAAO,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC1D,CAAC"}

package/dist/photo/photoUi.d.ts

@@ -0,0 +1,39 @@
+/** 键值行的一行：左是名字，右是值（`v` 与 `vHtml` 二选一，`vHtml` 给已组合好的受信形状）。 */
+export interface FactRow {
+    readonly k: string;
+    readonly v?: string;
+    readonly vHtml?: string;
+}
+/** 形状词汇的 CSS（冻结 token；不新增 `:root` 变量、不新造断点）。 */
+export declare function photoUiCss(): string;
+/** 徽章列（页头身份行／图注元数据）：并列小标签一律走公共层 `renderChips`，本件只给容器。
+ *  空表＝空串（没内容不留空壳）。 */
+export declare function chipRow(items: readonly string[]): string;
+/** 键值行（详情页「这张照片的信息」那一块）：一行一件事，窄屏塌成上下两行。空表＝空串。 */
+export declare function factRows(rows: readonly FactRow[]): string;
+/** 用户自己连写的文本 → 分段形状：命中并列分隔符即拆段，段间由细线分（**用户数据一字不改**，
+ *  只把「拿符号顶版面」换成「把版面画出来」）。无分隔符即原样一段。 */
+export declare function noteSegments(text: string): string;
+/** 间隔条（对比页）：大数字＋单位＋两张日期块——「间隔 N 天」原来只是页头标题里的半句话。 */
+export declare function intervalStrip(days: number, left: string, right: string): string;
+/** 候选行的一行（#527 规划器）：编号槽／文件槽／标签槽／异常徽标槽 ＋ 次要行的事实。 */
+export interface PhotoPickRowInput {
+    /** 编号槽（人话，如「照片 31」）。 */
+    readonly no: string;
+    /** 文件槽（文件名；**不内嵌字节**，只有名字）。 */
+    readonly file: string;
+    /** 标签槽（本张的标签，短词）。 */
+    readonly tag?: string;
+    /** 异常徽标（正常张不给——「存在」是零信息值）。 */
+    readonly badge?: {
+        readonly tone: 'ok' | 'warn' | 'danger';
+        readonly text: string;
+    };
+    /** 次要行（日期／整图或裁剪这类事实）；空数组＝不出这一行。 */
+    readonly meta?: readonly string[];
+}
+/** 候选行（#527 规划器）：原来六列表在窄屏被挤成长串，改「一行一张照片」——编号、文件名、
+ *  标签、异常徽标各占一槽，次要事实走第二行的徽章列。**不印 `#N`**（那是内部标识符口径），
+ *  改「照片 31」这种读者话；行高在 820 以下补到 44px 触摸面。 */
+export declare function photoPickRows(rows: readonly PhotoPickRowInput[]): string;
+//# sourceMappingURL=photoUi.d.ts.map

package/dist/photo/photoUi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photoUi.d.ts","sourceRoot":"","sources":["../../src/photo/photoUi.ts"],"names":[],"mappings":"AAoCA,6DAA6D;AAC7D,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,gDAAgD;AAChD,wBAAgB,UAAU,IAAI,MAAM,CA4InC;AAED;sBACsB;AACtB,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAIxD;AAED,iDAAiD;AACjD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAOzD;AAED;uCACuC;AACvC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/E;AAED,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACpF,mCAAmC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;2CAE2C;AAC3C,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,iBAAiB,EAAE,GAAG,MAAM,CAaxE"}