koishi-plugin-rocom 1.0.18 → 1.0.24

package/lib/egg-service.js

@@ -9,6 +9,7 @@ exports.formatEggGroups = formatEggGroups;
 const koishi_1 = require("koishi");
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
+const pet_size_1 = require("./pet-size");
 const logger = new koishi_1.Logger('rocom-egg');
 exports.EGG_GROUP_META = {
     1: { label: '未发现', desc: '不能和任何精灵生蛋' },
@@ -70,6 +71,8 @@ function fmtRange(lo, hi, u) {
     return `${lo ?? hi}${u}`;
 }
 function num(value) {
+    if (value === null || value === undefined || value === '')
+        return null;
     const parsed = Number(value);
     return Number.isFinite(parsed) ? parsed : null;
 }
@@ -275,33 +278,60 @@ class EggService {
             weight_min: weightMin,
             weight_max: weightMax,
             weight_label: fmtRange(weightMin, weightMax, 'kg'),
+            ...(0, pet_size_1.sizeVariantPayload)(queryWeight, pet?.breeding?.weight_low == null ? null : pet.breeding.weight_low / 1000, pet?.breeding?.weight_high == null ? null : pet.breeding.weight_high / 1000),
             probability,
             match_count: matchCount,
             match_info_label: this.formatMatchSummary(probability, matchCount),
         };
     }
-    formatSizeApiCard(item) {
-        // 新版 /wiki/pet-size/query 返回 items[].pet / egg_size / match 结构；旧接口是平铺字段。
+    formatSizeApiCard(item, queryWeight) {
+        // 兼容 /wiki/pet-size/query 的 items[].pet/egg_size/match 结构与 /egg/search 的
+        // height_range_m/cm、weight_range_kg/g、r_value/range_area 平铺结构。
         const petInfo = item?.pet && typeof item.pet === 'object' ? item.pet : {};
         const eggSize = item?.egg_size && typeof item.egg_size === 'object' ? item.egg_size : {};
         const heightRange = eggSize?.height && typeof eggSize.height === 'object' ? eggSize.height : {};
         const weightRange = eggSize?.weight && typeof eggSize.weight === 'object' ? eggSize.weight : {};
         const match = item?.match && typeof item.match === 'object' ? item.match : {};
-        const petId = petInfo?.pet_id || item?.petId || item?.pet_id || '-';
-        const petName = petInfo?.name || (typeof item?.pet === 'string' ? item.pet : '') || item?.name || '未知精灵';
+        const petId = petInfo?.pet_id || petInfo?.id || item?.petId || item?.pet_id || item?.id || '-';
+        const petForm = String(petInfo?.form || item?.form || '').trim();
+        let petName = petInfo?.name || (typeof item?.pet === 'string' ? item.pet : '') || item?.name || item?.pet_name || '未知精灵';
+        if (petForm && !String(petName).includes(petForm))
+            petName = `${petName}（${petForm}）`;
         const typeNames = Array.isArray(petInfo?.type_names) ? petInfo.type_names.filter(Boolean) : [];
         const eggGroupNames = Array.isArray(petInfo?.egg_group_names) ? petInfo.egg_group_names.filter(Boolean) : [];
+        const [heightRangeMMin, heightRangeMMax] = this.rangePair(item?.height_range_m);
+        const [heightRangeCmMin, heightRangeCmMax] = this.rangePair(item?.height_range_cm);
+        const [weightRangeKgMin, weightRangeKgMax] = this.rangePair(item?.weight_range_kg);
+        const [weightRangeGMin, weightRangeGMax] = this.rangePair(item?.weight_range_g);
         const probability = num(item?.probability) ?? num(match?.percent);
         const matchCount = num(item?.matchCount);
-        const heightMin = num(heightRange?.min_m ?? item?.diameterMin);
-        const heightMax = num(heightRange?.max_m ?? item?.diameterMax);
-        const weightMin = num(weightRange?.min_kg ?? item?.weightMin);
-        const weightMax = num(weightRange?.max_kg ?? item?.weightMax);
+        const heightMin = num(heightRange?.min_m) ?? heightRangeMMin
+            ?? (heightRangeCmMin == null ? null : heightRangeCmMin / 100)
+            ?? num(item?.diameterMin);
+        const heightMax = num(heightRange?.max_m) ?? heightRangeMMax
+            ?? (heightRangeCmMax == null ? null : heightRangeCmMax / 100)
+            ?? num(item?.diameterMax);
+        const weightMin = num(weightRange?.min_kg) ?? weightRangeKgMin
+            ?? (weightRangeGMin == null ? null : weightRangeGMin / 1000)
+            ?? num(item?.weightMin);
+        const weightMax = num(weightRange?.max_kg) ?? weightRangeKgMax
+            ?? (weightRangeGMax == null ? null : weightRangeGMax / 1000)
+            ?? num(item?.weightMax);
+        const rValue = num(item?.r_value);
+        const rangeArea = num(item?.range_area);
+        const sizeVariant = (0, pet_size_1.sizeVariantPayload)(queryWeight, weightMin, weightMax, fmtRange(weightMin, weightMax, 'kg'));
+        const fallbackMatchLabel = [
+            rValue != null ? `R值 ${formatNumber(rValue, 3)}` : '',
+            rangeArea != null ? `范围面积 ${formatNumber(rangeArea, 0)}` : '',
+        ].filter(Boolean).join(' / ');
+        const matchInfoLabel = String(match?.match_percent_text || '')
+            || fallbackMatchLabel
+            || this.formatMatchSummary(probability, matchCount);
         return {
             id: petId,
             name: petName,
-            icon: petInfo?.icon || item?.petIcon || petIconUrl(petId),
-            image: petInfo?.small_icon || item?.petImage || petImageUrl(petId),
+            icon: petInfo?.icon || item?.pet_icon_url || item?.petIcon || petIconUrl(petId),
+            image: petInfo?.small_icon || item?.pet_img_url || item?.petImage || petImageUrl(petId),
             type_label: typeNames.length ? typeNames.join(' / ') : '后端未提供',
             egg_group_ids: [],
             egg_groups_label: eggGroupNames.length ? eggGroupNames.join(' / ') : '后端未提供',
@@ -311,11 +341,18 @@ class EggService {
             weight_min: weightMin,
             weight_max: weightMax,
             weight_label: fmtRange(weightMin, weightMax, 'kg'),
+            query_weight: queryWeight,
+            ...sizeVariant,
             probability,
             match_count: matchCount,
-            match_info_label: String(match?.match_percent_text || '') || this.formatMatchSummary(probability, matchCount),
+            match_info_label: matchInfoLabel,
         };
     }
+    rangePair(value) {
+        if (Array.isArray(value) && value.length >= 2)
+            return [num(value[0]), num(value[1])];
+        return [null, null];
+    }
     // 新版尺寸反查按 match.layer 划分完美/范围匹配。
     splitNewSizeApiItems(items) {
         const perfect = [];
@@ -473,7 +510,7 @@ class EggService {
             lines.push(`✅ 完美匹配 ${condStr} 的精灵（共 ${results.perfect.length} 只）：`);
             results.perfect.slice(0, 10).forEach((p, i) => {
                 const br = p.breeding || {};
-                lines.push(`  ${i + 1}. ${petName(p)} (#${p.id}) — ${fmtRange(ht(br.height_low), ht(br.height_high), 'm')} / ${fmtRange(wt(br.weight_low), wt(br.weight_high), 'kg')} · ${formatEggGroups(this.getEggGroups(p))}`);
+                lines.push(`  ${i + 1}. ${petName(p)} (#${p.id}) — ${fmtRange(ht(br.height_low), ht(br.height_high), 'm')} / ${fmtRange(wt(br.weight_low), wt(br.weight_high), 'kg')} · ${formatEggGroups(this.getEggGroups(p))}${this.formatPetCard(p, height, weight).size_variant_label ? ' · 【' + this.formatPetCard(p, height, weight).size_variant_label + '】' : ''}`);
             });
         }
         if (results.range.length) {
@@ -482,7 +519,7 @@ class EggService {
             lines.push(`🔍 范围匹配 ${condStr} 的精灵（共 ${results.range.length} 只，容差±15%）：`);
             results.range.slice(0, 10).forEach((p, i) => {
                 const br = p.breeding || {};
-                lines.push(`  ${i + 1}. ${petName(p)} (#${p.id}) — ${fmtRange(ht(br.height_low), ht(br.height_high), 'm')} / ${fmtRange(wt(br.weight_low), wt(br.weight_high), 'kg')} · ${formatEggGroups(this.getEggGroups(p))}`);
+                lines.push(`  ${i + 1}. ${petName(p)} (#${p.id}) — ${fmtRange(ht(br.height_low), ht(br.height_high), 'm')} / ${fmtRange(wt(br.weight_low), wt(br.weight_high), 'kg')} · ${formatEggGroups(this.getEggGroups(p))}${this.formatPetCard(p, height, weight).size_variant_label ? ' · 【' + this.formatPetCard(p, height, weight).size_variant_label + '】' : ''}`);
             });
         }
         return lines.join('\n');
@@ -501,8 +538,8 @@ class EggService {
         if (exact.length) {
             lines.push(`✅ 完美匹配 ${condStr} 的精灵（共 ${exact.length} 只）：`);
             exact.slice(0, 10).forEach((item, i) => {
-                const card = this.formatSizeApiCard(item);
-                lines.push(`  ${i + 1}. ${card.name} (#${card.id}) — ${card.height_label} / ${card.weight_label}`);
+                const card = this.formatSizeApiCard(item, weight);
+                lines.push(`  ${i + 1}. ${card.name} (#${card.id}) — ${card.height_label} / ${card.weight_label}${card.size_variant_label ? ` · 【${card.size_variant_label}】` : ''}`);
             });
         }
         if (candidates.length) {
@@ -510,8 +547,8 @@ class EggService {
                 lines.push('');
             lines.push(`🔍 范围匹配 ${condStr} 的精灵（共 ${candidates.length} 只）：`);
             candidates.slice(0, 10).forEach((item, i) => {
-                const card = this.formatSizeApiCard(item);
-                lines.push(`  ${i + 1}. ${card.name} (#${card.id}) — ${card.height_label} / ${card.weight_label}`);
+                const card = this.formatSizeApiCard(item, weight);
+                lines.push(`  ${i + 1}. ${card.name} (#${card.id}) — ${card.height_label} / ${card.weight_label}${card.size_variant_label ? ` · 【${card.size_variant_label}】` : ''}`);
             });
         }
         return lines.join('\n');
@@ -534,7 +571,7 @@ class EggService {
             `🥚 ${data?.pet_name || '未知精灵'} (#${data?.pet_id || '-'})`,
             `属性：${data?.type_label || '未知'}`,
             `蛋组：${data?.egg_groups_label || '暂无蛋组数据'}`,
-            `可配种精灵数：${data?.total_compatible || 0}`,
+            `${data?.compatible_total_known === false ? '当前预览精灵数' : '可配种精灵数'}：${data?.total_compatible || 0}`,
         ];
         if (data?.is_undiscovered)
             lines.push('⚠️ 该精灵属于「未发现」蛋组，无法配种。');
@@ -792,6 +829,185 @@ class EggService {
             copyright: 'Koishi & WeGame 洛克王国插件',
         };
     }
+    // ─── 后端 Egg API 转换───
+    buildCandidatesFromEggApi(keyword, candidates) {
+        return {
+            keyword,
+            count: candidates.length,
+            candidates: candidates.map(item => this.formatEggApiCard(item)),
+            commandHint: '请使用更精确的名称重新查询',
+            copyright: 'Koishi & WeGame 洛克王国插件',
+        };
+    }
+    buildSearchDataFromEggApi(pet, compatibleByGroup = {}) {
+        const groups = this.eggApiGroups(pet);
+        const groupIds = [];
+        const groupLabels = {};
+        for (const group of groups) {
+            const id = this.eggGroupId(group);
+            if (id === null || groupIds.includes(id))
+                continue;
+            groupIds.push(id);
+            groupLabels[id] = this.eggGroupLabel(group);
+        }
+        const seen = new Set();
+        let totalCompatible = 0;
+        const sections = groups.map((group) => {
+            const gid = this.eggGroupId(group);
+            const label = this.eggGroupLabel(group);
+            if (gid === null)
+                return null;
+            if (this.isUndiscoveredEggGroup(gid, label)) {
+                return {
+                    id: gid,
+                    label: label || '未发现',
+                    desc: '不能和任何精灵生蛋，多用于传说中的精灵',
+                    count: 0,
+                    members: [],
+                    has_more: false,
+                    total: 0,
+                };
+            }
+            const groupResult = compatibleByGroup[String(gid)] ?? compatibleByGroup[gid] ?? {};
+            const rawMembers = Array.isArray(groupResult)
+                ? groupResult
+                : (Array.isArray(groupResult?.items) ? groupResult.items : []);
+            const members = [];
+            for (const item of rawMembers) {
+                const itemId = item?.id ?? item?.pet_id;
+                if (String(itemId ?? '') === String(pet?.id ?? pet?.pet_id ?? ''))
+                    continue;
+                const key = String(itemId ?? item?.name ?? '');
+                if (key && !seen.has(key)) {
+                    seen.add(key);
+                    totalCompatible += 1;
+                }
+                members.push(this.formatEggApiMember(item));
+            }
+            const total = num(groupResult?.total) ?? members.length;
+            return {
+                id: gid,
+                label,
+                desc: this.eggGroupDesc(group),
+                count: total,
+                members: members.slice(0, 30),
+                has_more: total > 30 || members.length > 30,
+                total,
+            };
+        }).filter(Boolean);
+        const [heightMin, heightMax] = this.eggHeightRangeM(pet);
+        const [weightMin, weightMax] = this.eggWeightRangeKg(pet);
+        const petId = pet?.id ?? pet?.pet_id ?? '-';
+        return {
+            pet_name: this.eggPetDisplayName(pet),
+            pet_id: petId,
+            pet_icon: pet?.pet_icon_url || pet?.icon_url || petIconUrl(petId),
+            pet_image: pet?.pet_img_url || pet?.image_url || petImageUrl(petId),
+            type_label: this.eggApiTypeLabel(pet),
+            egg_groups_label: groupIds.map(id => groupLabels[id] || String(id)).join(' / ') || '暂无蛋组数据',
+            egg_groups: groupIds,
+            egg_group_labels: groupLabels,
+            male_rate: null,
+            female_rate: null,
+            hatch_label: '后端未提供',
+            weight_label: fmtRange(weightMin, weightMax, 'kg'),
+            height_label: fmtRange(heightMin, heightMax, 'm'),
+            total_compatible: num(compatibleByGroup.__all__?.total) ?? totalCompatible,
+            compatible_total_known: num(compatibleByGroup.__all__?.total) !== null,
+            is_undiscovered: groups.some(group => this.isUndiscoveredEggGroup(this.eggGroupId(group), this.eggGroupLabel(group))),
+            egg_group_sections: sections,
+            total_stats: '后端未提供',
+            egg_details: { has_data: false },
+            commandHint: '数据来自后端查蛋；接口不可用时自动回退 Wiki / 本地查蛋' + (num(compatibleByGroup.__all__?.total) === null ? '。总数不可用，当前数量仅为已加载预览' : ''),
+            copyright: 'Koishi & WeGame 洛克王国插件',
+        };
+    }
+    formatEggApiCard(item) {
+        const petId = item?.id ?? item?.pet_id ?? '-';
+        const [heightMin, heightMax] = this.eggHeightRangeM(item);
+        const [weightMin, weightMax] = this.eggWeightRangeKg(item);
+        return {
+            id: petId,
+            name: this.eggPetDisplayName(item),
+            icon: item?.pet_icon_url || item?.icon_url || petIconUrl(petId),
+            image: item?.pet_img_url || item?.image_url || petImageUrl(petId),
+            type_label: this.eggApiTypeLabel(item),
+            egg_group_ids: [],
+            egg_groups_label: this.eggGroupsLabel(item),
+            height_min: heightMin,
+            height_max: heightMax,
+            height_label: fmtRange(heightMin, heightMax, 'm'),
+            weight_min: weightMin,
+            weight_max: weightMax,
+            weight_label: fmtRange(weightMin, weightMax, 'kg'),
+            probability: null,
+            match_count: null,
+            match_info_label: '后端命中',
+        };
+    }
+    formatEggApiMember(item) {
+        return {
+            name: this.eggPetDisplayName(item),
+            id: item?.id ?? item?.pet_id ?? '-',
+            type_label: this.eggApiTypeLabel(item),
+            egg_groups_label: this.eggGroupsLabel(item),
+        };
+    }
+    eggApiGroups(item) {
+        const groups = item?.egg_groups ?? item?.egg_group ?? [];
+        const list = Array.isArray(groups) ? groups : [groups];
+        return list
+            .filter(Boolean)
+            .map(group => (group && typeof group === 'object' ? group : { name: String(group), official_name: String(group) }));
+    }
+    eggGroupId(group) {
+        return num(group?.group_id ?? group?.id);
+    }
+    eggGroupLabel(group) {
+        return String(group?.official_name || group?.name || group?.display_name || '').trim();
+    }
+    eggGroupDesc(group) {
+        const label = this.eggGroupLabel(group);
+        const display = String(group?.display_name || '').trim();
+        return display && display !== label ? display : '';
+    }
+    isUndiscoveredEggGroup(id, label) {
+        const text = String(label || '');
+        return String(id) === '1' || text.includes('未发现') || text.includes('无法孵蛋');
+    }
+    eggPetDisplayName(item) {
+        const name = String(item?.name || item?.pet_name || '未知精灵').trim() || '未知精灵';
+        const form = String(item?.form || '').trim();
+        return form && !name.includes(form) ? `${name}（${form}）` : name;
+    }
+    eggApiTypeLabel(item) {
+        const types = item?.unit_type;
+        if (Array.isArray(types) && types.length)
+            return types.filter(Boolean).join(' / ') || '未知';
+        return String(item?.type || item?.attribute_name || '未知');
+    }
+    eggGroupsLabel(item) {
+        const labels = this.eggApiGroups(item).map(group => this.eggGroupLabel(group)).filter(Boolean);
+        return labels.length ? labels.join(' / ') : '暂无蛋组数据';
+    }
+    eggHeightRangeM(item) {
+        const direct = this.rangePair(item?.height_range_m);
+        if (direct[0] != null || direct[1] != null)
+            return direct;
+        const cm = this.rangePair(item?.height_range_cm);
+        if (cm[0] != null || cm[1] != null)
+            return [cm[0] == null ? null : cm[0] / 100, cm[1] == null ? null : cm[1] / 100];
+        return [null, null];
+    }
+    eggWeightRangeKg(item) {
+        const direct = this.rangePair(item?.weight_range_kg);
+        if (direct[0] != null || direct[1] != null)
+            return direct;
+        const g = this.rangePair(item?.weight_range_g);
+        if (g[0] != null || g[1] != null)
+            return [g[0] == null ? null : g[0] / 1000, g[1] == null ? null : g[1] / 1000];
+        return [null, null];
+    }
     buildSizeSearchData(height, weight, results, heightDisplay) {
         const conditions = [];
         if (height != null)
@@ -816,7 +1032,7 @@ class EggService {
         if (weight != null)
             conditions.push(`体重 ${weight} kg`);
         const groups = this.sizeApiResultGroups(results);
-        const [perfect, ranged] = this.mergeCardsByName(groups.exact.map((item) => this.formatSizeApiCard(item)), groups.candidates.map((item) => this.formatSizeApiCard(item)));
+        const [perfect, ranged] = this.mergeCardsByName(groups.exact.map((item) => this.formatSizeApiCard(item, weight)), groups.candidates.map((item) => this.formatSizeApiCard(item, weight)));
         const poolName = results?.query?.pool && typeof results.query.pool === 'object'
             ? results.query.pool.name
             : '';

package/lib/element-colors.d.ts

@@ -0,0 +1,3 @@
+export declare const ELEMENT_COLORS: Record<string, string>;
+export declare function elementColor(name: string): string;
+export declare function bloodlineElement(name: string): string;

package/lib/element-colors.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ELEMENT_COLORS = void 0;
+exports.elementColor = elementColor;
+exports.bloodlineElement = bloodlineElement;
+// 元素配色表，供信笺风阵容分享与家园详情 classic 模板共用。
+exports.ELEMENT_COLORS = {
+    草: '#4ebc73',
+    火: '#db5525',
+    水: '#3f89b4',
+    光: '#6aa9fe',
+    地: '#9a7e3f',
+    冰: '#63aeda',
+    龙: '#ed4962',
+    电: '#e7c506',
+    毒: '#ba62e0',
+    虫: '#96ca0f',
+    武: '#ff9636',
+    翼: '#3ec7ca',
+    萌: '#fc74a7',
+    幽: '#9446ec',
+    恶: '#cf467a',
+    机械: '#40cba9',
+    幻: '#9fa7f8',
+    普通: '#babbc6',
+    无: '#babbc6',
+};
+function elementColor(name) {
+    return exports.ELEMENT_COLORS[String(name || '').trim()] || '#a687d5';
+}
+// 「烈焰血脉」→「火」这类血脉名到元素名的归一。
+function bloodlineElement(name) {
+    return String(name || '').replace(/系血脉$/, '').replace(/血脉$/, '').trim() || '普通';
+}

package/lib/icon-metrics.d.ts

@@ -0,0 +1,32 @@
+export interface ImageContentBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface ImageMetrics {
+    width: number;
+    height: number;
+    content: ImageContentBox;
+}
+export interface IconFit {
+    scale: number;
+    offsetX: number;
+    offsetY: number;
+}
+/** 读一张图的尺寸与内容框；无法识别时返回 null。 */
+export declare function readImageMetrics(buffer: Buffer): ImageMetrics | null;
+export interface IconFitBox {
+    width: number;
+    height: number;
+    targetArea: number;
+}
+/**
+ * 把「等面积归一」算成 CSS transform 参数。
+ * `.goods-img` 本身 object-fit: contain 按整张画布贴边居中，这里再叠一层
+ * 以框中心为原点的 translate(...) scale(...)：
+ *   - scale 把不透明内容缩放到 targetArea 对应面积，上限是不溢出图标框；
+ *   - translate 写在 scale 前，矩阵乘法上位移不会被 scale 再放大，
+ *     用于把不在画布中心的内容挪回框中心。
+ */
+export declare function buildIconFit(metrics: ImageMetrics | null | undefined, options: IconFitBox): IconFit | null;

package/lib/icon-metrics.js

@@ -0,0 +1,255 @@
+"use strict";
+// 图片尺寸与「不透明内容框」测量，用于商品图标等面积归一。
+// 商品图标画布大小、四周留白、内容长宽比都不一致，object-fit: contain 按整张画布贴边，
+// 会导致同一张卡片里圆球占满、细长商品偏小。这里量出不透明内容包围盒供缩放换算。
+// PNG 只精确支持 8bit 非隔行且带独立 alpha 的变体；WebP 只读画布尺寸；其余返回 null 按原样渲染。
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readImageMetrics = readImageMetrics;
+exports.buildIconFit = buildIconFit;
+const node_zlib_1 = __importDefault(require("node:zlib"));
+const PNG_SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+/** PNG 颜色类型 → 每像素通道数 */
+const PNG_CHANNELS = { 0: 1, 2: 3, 3: 1, 4: 2, 6: 4 };
+/** 带独立 alpha 通道的颜色类型 → alpha 在像素里的下标 */
+const PNG_ALPHA_INDEX = { 4: 1, 6: 3 };
+function paeth(a, b, c) {
+    const p = a + b - c;
+    const pa = Math.abs(p - a);
+    const pb = Math.abs(p - b);
+    const pc = Math.abs(p - c);
+    if (pa <= pb && pa <= pc)
+        return a;
+    if (pb <= pc)
+        return b;
+    return c;
+}
+/** 按 PNG 的 5 种行过滤器还原一行原始像素 */
+function unfilterScanline(src, dest, prev, filter, bpp) {
+    const length = src.length;
+    if (filter === 0) {
+        src.copy(dest, 0, 0, length);
+        return true;
+    }
+    if (filter === 1) {
+        for (let i = 0; i < length; i += 1) {
+            dest[i] = (src[i] + (i >= bpp ? dest[i - bpp] : 0)) & 0xff;
+        }
+        return true;
+    }
+    if (filter === 2) {
+        for (let i = 0; i < length; i += 1) {
+            dest[i] = (src[i] + prev[i]) & 0xff;
+        }
+        return true;
+    }
+    if (filter === 3) {
+        for (let i = 0; i < length; i += 1) {
+            const left = i >= bpp ? dest[i - bpp] : 0;
+            dest[i] = (src[i] + ((left + prev[i]) >> 1)) & 0xff;
+        }
+        return true;
+    }
+    if (filter === 4) {
+        for (let i = 0; i < length; i += 1) {
+            const left = i >= bpp ? dest[i - bpp] : 0;
+            const up = prev[i];
+            const upLeft = i >= bpp ? prev[i - bpp] : 0;
+            dest[i] = (src[i] + paeth(left, up, upLeft)) & 0xff;
+        }
+        return true;
+    }
+    return false;
+}
+function readPngHeader(buffer) {
+    if (buffer.length < 33)
+        return null;
+    if (buffer.toString('ascii', 12, 16) !== 'IHDR')
+        return null;
+    const width = buffer.readUInt32BE(16);
+    const height = buffer.readUInt32BE(20);
+    if (width <= 0 || height <= 0)
+        return null;
+    return {
+        width,
+        height,
+        bitDepth: buffer[24],
+        colorType: buffer[25],
+        interlace: buffer[28],
+    };
+}
+/** 量 PNG 的不透明内容框；只处理 8bit 非隔行带独立 alpha 的图，其余返回 null（整张都算内容）。 */
+function readPngContentBox(buffer, header) {
+    const alphaIndex = PNG_ALPHA_INDEX[header.colorType];
+    if (alphaIndex === undefined)
+        return null;
+    if (header.bitDepth !== 8 || header.interlace !== 0)
+        return null;
+    const channels = PNG_CHANNELS[header.colorType];
+    const stride = header.width * channels;
+    if (stride <= 0)
+        return null;
+    const idatParts = [];
+    let offset = 8;
+    while (offset + 8 <= buffer.length) {
+        const length = buffer.readUInt32BE(offset);
+        const type = buffer.toString('ascii', offset + 4, offset + 8);
+        const dataStart = offset + 8;
+        if (dataStart + length > buffer.length)
+            break;
+        if (type === 'IDAT')
+            idatParts.push(buffer.subarray(dataStart, dataStart + length));
+        if (type === 'IEND')
+            break;
+        offset = dataStart + length + 4;
+    }
+    if (idatParts.length === 0)
+        return null;
+    let raw;
+    try {
+        raw = node_zlib_1.default.inflateSync(Buffer.concat(idatParts));
+    }
+    catch {
+        return null;
+    }
+    let current = Buffer.alloc(stride);
+    let previous = Buffer.alloc(stride);
+    let cursor = 0;
+    let minX = header.width;
+    let minY = header.height;
+    let maxX = -1;
+    let maxY = -1;
+    for (let y = 0; y < header.height; y += 1) {
+        if (cursor + 1 + stride > raw.length)
+            return null;
+        const filter = raw[cursor];
+        cursor += 1;
+        const line = raw.subarray(cursor, cursor + stride);
+        cursor += stride;
+        if (!unfilterScanline(line, current, previous, filter, channels))
+            return null;
+        for (let x = 0; x < header.width; x += 1) {
+            if (current[(x * channels) + alphaIndex] === 0)
+                continue;
+            if (x < minX)
+                minX = x;
+            if (x > maxX)
+                maxX = x;
+            if (y < minY)
+                minY = y;
+            if (y > maxY)
+                maxY = y;
+        }
+        const swap = previous;
+        previous = current;
+        current = swap;
+    }
+    if (maxX < 0)
+        return null;
+    return {
+        x: minX,
+        y: minY,
+        width: (maxX - minX) + 1,
+        height: (maxY - minY) + 1,
+    };
+}
+/** 读 WebP 画布尺寸（VP8X / VP8L / VP8） */
+function readWebpSize(buffer) {
+    if (buffer.length < 30)
+        return null;
+    if (buffer.toString('ascii', 0, 4) !== 'RIFF')
+        return null;
+    if (buffer.toString('ascii', 8, 12) !== 'WEBP')
+        return null;
+    const chunk = buffer.toString('ascii', 12, 16);
+    if (chunk === 'VP8X') {
+        const width = 1 + (buffer[24] | (buffer[25] << 8) | (buffer[26] << 16));
+        const height = 1 + (buffer[27] | (buffer[28] << 8) | (buffer[29] << 16));
+        return { width, height };
+    }
+    if (chunk === 'VP8L') {
+        const bits = buffer.readUInt32LE(21);
+        return {
+            width: (bits & 0x3fff) + 1,
+            height: ((bits >> 14) & 0x3fff) + 1,
+        };
+    }
+    if (chunk === 'VP8 ') {
+        return {
+            width: buffer.readUInt16LE(26) & 0x3fff,
+            height: buffer.readUInt16LE(28) & 0x3fff,
+        };
+    }
+    return null;
+}
+/** 读一张图的尺寸与内容框；无法识别时返回 null。 */
+function readImageMetrics(buffer) {
+    if (!Buffer.isBuffer(buffer) || buffer.length < 16)
+        return null;
+    if (buffer.subarray(0, 8).equals(PNG_SIGNATURE)) {
+        const header = readPngHeader(buffer);
+        if (!header)
+            return null;
+        return {
+            width: header.width,
+            height: header.height,
+            content: readPngContentBox(buffer, header) || {
+                x: 0,
+                y: 0,
+                width: header.width,
+                height: header.height,
+            },
+        };
+    }
+    const webp = readWebpSize(buffer);
+    if (webp) {
+        return {
+            width: webp.width,
+            height: webp.height,
+            content: { x: 0, y: 0, width: webp.width, height: webp.height },
+        };
+    }
+    return null;
+}
+function round4(value) {
+    // +0 归一掉 -0，避免模板里出现 "scale(-0)" 之类的输出
+    return Math.round(value * 10000) / 10000 + 0;
+}
+/**
+ * 把「等面积归一」算成 CSS transform 参数。
+ * `.goods-img` 本身 object-fit: contain 按整张画布贴边居中，这里再叠一层
+ * 以框中心为原点的 translate(...) scale(...)：
+ *   - scale 把不透明内容缩放到 targetArea 对应面积，上限是不溢出图标框；
+ *   - translate 写在 scale 前，矩阵乘法上位移不会被 scale 再放大，
+ *     用于把不在画布中心的内容挪回框中心。
+ */
+function buildIconFit(metrics, options) {
+    const boxWidth = Number(options.width) || 0;
+    const boxHeight = Number(options.height) || 0;
+    const targetArea = Number(options.targetArea) || 0;
+    if (boxWidth <= 0 || boxHeight <= 0 || targetArea <= 0)
+        return null;
+    const width = Number(metrics?.width) || 0;
+    const height = Number(metrics?.height) || 0;
+    const content = metrics?.content;
+    const contentWidth = Number(content?.width) || 0;
+    const contentHeight = Number(content?.height) || 0;
+    if (width <= 0 || height <= 0 || contentWidth <= 0 || contentHeight <= 0)
+        return null;
+    const containScale = Math.min(boxWidth / width, boxHeight / height);
+    if (!Number.isFinite(containScale) || containScale <= 0)
+        return null;
+    const contentScale = Math.min(Math.sqrt(targetArea / (contentWidth * contentHeight)), boxWidth / contentWidth, boxHeight / contentHeight);
+    if (!Number.isFinite(contentScale) || contentScale <= 0)
+        return null;
+    const contentCenterX = (Number(content?.x) || 0) + (contentWidth / 2);
+    const contentCenterY = (Number(content?.y) || 0) + (contentHeight / 2);
+    const scale = contentScale / containScale;
+    return {
+        scale: round4(scale),
+        offsetX: round4(-contentScale * (contentCenterX - (width / 2))),
+        offsetY: round4(-contentScale * (contentCenterY - (height / 2))),
+    };
+}