fangguo-component 1.2.2 → 1.2.4

package/dist/montageImgUrl-DP5jMHCX.js

@@ -0,0 +1,445 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+import { ref } from "vue";
+const DEFAULT_IMG_FASTEN = {
+  notSupported: "//static.fangguo.com/assets/img/pic-fasten/not-supported.png",
+  error: "//static.fangguo.com/assets/img/pic-fasten/error.png",
+  empty: "//static.fangguo.com/assets/img/pic-fasten/empty.png"
+};
+let ossLinks = [];
+let imgFasten = __spreadValues({}, DEFAULT_IMG_FASTEN);
+const imgUrlConfigKey = ref(0);
+function getOssLinks() {
+  return ossLinks;
+}
+function getImgFasten() {
+  return imgFasten;
+}
+function configureImgUrl(config = {}) {
+  let changed = false;
+  if (config.ossLinks) {
+    ossLinks = [...config.ossLinks];
+    changed = true;
+  }
+  if (config.imgFasten) {
+    imgFasten = __spreadValues(__spreadValues({}, imgFasten), config.imgFasten);
+    changed = true;
+  }
+  if (changed) {
+    imgUrlConfigKey.value++;
+  }
+}
+let lastEffectiveType = null;
+let lastSaveData = null;
+let networkListenerInitialized = false;
+const cachedResults = /* @__PURE__ */ new Map();
+const MAX_CACHE_ENTRIES = 500;
+const networkKey = ref(0);
+function normalizeCacheKeyOptions(baseOptions) {
+  const o = baseOptions != null ? baseOptions : {};
+  const w = typeof o.w === "number" ? o.w : "";
+  const h = typeof o.h === "number" ? o.h : "";
+  const Q = typeof o.Q === "number" ? o.Q : "";
+  const q = typeof o.q === "number" ? o.q : "";
+  const format = typeof o.format === "string" ? o.format : "";
+  return `w=${w}&h=${h}&Q=${Q}&q=${q}&format=${format}`;
+}
+function lruGet(key) {
+  const hit = cachedResults.get(key);
+  if (!hit) return null;
+  cachedResults.delete(key);
+  cachedResults.set(key, hit);
+  return hit;
+}
+function lruSet(key, value) {
+  if (cachedResults.has(key)) cachedResults.delete(key);
+  cachedResults.set(key, value);
+  if (cachedResults.size > MAX_CACHE_ENTRIES) {
+    const oldestKey = cachedResults.keys().next().value;
+    if (oldestKey) cachedResults.delete(oldestKey);
+  }
+}
+function getNetworkAdaptiveOptions(baseOptions = { h: 260, Q: 92 }) {
+  var _a;
+  const conn = navigator.connection;
+  const effectiveType = (conn == null ? void 0 : conn.effectiveType) || "4g";
+  const saveData = (_a = conn == null ? void 0 : conn.saveData) != null ? _a : false;
+  const key = `${effectiveType}|${String(saveData)}|${normalizeCacheKeyOptions(baseOptions)}`;
+  if (effectiveType === lastEffectiveType && saveData === lastSaveData) {
+    const hit = lruGet(key);
+    if (hit) return hit;
+  }
+  let scale = 1;
+  let quality = baseOptions.Q || 92;
+  switch (effectiveType) {
+    case "slow-2g":
+    case "2g":
+      scale = saveData ? 0.3 : 0.4;
+      quality = saveData ? 40 : 50;
+      break;
+    case "3g":
+      scale = saveData ? 0.5 : 0.7;
+      quality = saveData ? 60 : 82;
+      break;
+    case "4g":
+    default:
+      scale = saveData ? 0.7 : 1;
+      quality = saveData ? 85 : baseOptions.Q || 92;
+      break;
+  }
+  const options = __spreadValues({}, baseOptions);
+  if (options.w) options.w = Math.round(options.w * scale);
+  if (options.h) options.h = Math.round(options.h * scale);
+  options.Q = quality;
+  lastEffectiveType = effectiveType;
+  lastSaveData = saveData;
+  lruSet(key, options);
+  return options;
+}
+function initNetworkListener() {
+  if (networkListenerInitialized) return;
+  networkListenerInitialized = true;
+  const conn = navigator.connection;
+  if (conn == null ? void 0 : conn.addEventListener) {
+    conn.addEventListener("change", () => {
+      cachedResults.clear();
+      lastEffectiveType = null;
+      lastSaveData = null;
+      networkKey.value++;
+    });
+  }
+  getNetworkAdaptiveOptions();
+}
+const AMAZON_DIM_TOKEN = "UL|SR|SL|SX|SY|SF|SC";
+function toPositiveInteger(value) {
+  if (value === void 0 || value === null || value === "") return 0;
+  const n = Number(value);
+  if (!Number.isFinite(n) || n <= 0) return 0;
+  return Math.round(n);
+}
+function parseHttpUrl(url) {
+  const raw = (url || "").trim();
+  if (!raw) return null;
+  try {
+    if (raw.startsWith("//")) return new URL(`https:${raw}`);
+    if (/^https?:\/\//i.test(raw)) return new URL(raw);
+  } catch (e) {
+    return null;
+  }
+  return null;
+}
+function removeImageUrlQuery(url) {
+  const raw = (url || "").trim();
+  if (!raw) return "";
+  const hashIndex = raw.indexOf("#");
+  const beforeHash = hashIndex === -1 ? raw : raw.slice(0, hashIndex);
+  const hash = hashIndex === -1 ? "" : raw.slice(hashIndex);
+  return beforeHash.split("?")[0] + hash;
+}
+function getTemuOriginalImageUrl(url) {
+  const parsed = parseHttpUrl(url);
+  if (!parsed || !/(^|\.)kwcdn\.com$/i.test(parsed.hostname)) return url;
+  return removeImageUrlQuery(url);
+}
+function getSheinOriginalImageUrl(url) {
+  const parsed = parseHttpUrl(url);
+  if (!parsed || !/(^|\.)ltwebstatic\.com$/i.test(parsed.hostname)) return url;
+  let base = removeImageUrlQuery(url);
+  base = base.replace(/_thumbnail_\d+x\d*\.(webp|png|jpg|jpeg)/gi, "_thumbnail_fullx.$1");
+  base = base.replace(/_square_thumbnail_\d+x\d*\.(webp|png|jpg|jpeg)/gi, "_square_thumbnail_fullx.$1");
+  return base;
+}
+function getAmazonOriginalImageUrl(url) {
+  const parsed = parseHttpUrl(url);
+  const isAmazonImageHost = parsed && (/(^|\.)media-amazon\.com$/i.test(parsed.hostname) || /(^|\.)ssl-images-amazon\.com$/i.test(parsed.hostname) || /(^|\.)amazon\./i.test(parsed.hostname));
+  if (!isAmazonImageHost) return url;
+  const base = removeImageUrlQuery(url);
+  const marker = "._AC_";
+  const i = base.indexOf(marker);
+  if (i === -1) return base;
+  const prefix = base.slice(0, i + marker.length);
+  let rest = base.slice(i + marker.length);
+  const reLead = new RegExp(`^(${AMAZON_DIM_TOKEN})(\\d+)(?:,(\\d+))?`);
+  rest = rest.replace(
+    reLead,
+    (_m, tag, _n1, n2) => n2 != null && n2 !== "" ? `${tag}full,full` : `${tag}full`
+  );
+  const reChain = new RegExp(`_(${AMAZON_DIM_TOKEN})(\\d+)(?:,(\\d+))?`, "g");
+  rest = rest.replace(
+    reChain,
+    (_m, tag, _n1, n2) => n2 != null && n2 !== "" ? `_${tag}full,full` : `_${tag}full`
+  );
+  return prefix + rest;
+}
+function getEtsyOriginalImageUrl(url) {
+  const parsed = parseHttpUrl(url);
+  const isEtsyImageHost = parsed && (/(^|\.)etsystatic\.com$/i.test(parsed.hostname) || /(^|\.)etsy\./i.test(parsed.hostname));
+  if (!isEtsyImageHost) return url;
+  return removeImageUrlQuery(url).replace(/il_\d+x\d+\./i, "il_fullxfull.");
+}
+function buildTemuImageResizeUrl(url, options = {}) {
+  const parsed = parseHttpUrl(url);
+  if (!parsed || !/(^|\.)kwcdn\.com$/i.test(parsed.hostname)) return url;
+  const width = toPositiveInteger(options.width);
+  if (!width) return url;
+  const base = removeImageUrlQuery(url);
+  return `${base}?imageView2/2/w/${width}/q/50/format/avif%7CimageVqr/2`;
+}
+function buildSheinImageResizeUrl(url, options = {}) {
+  const parsed = parseHttpUrl(url);
+  if (!parsed || !/(^|\.)ltwebstatic\.com$/i.test(parsed.hostname)) return url;
+  const width = toPositiveInteger(options.width) || toPositiveInteger(options.height);
+  const height = toPositiveInteger(options.height) || toPositiveInteger(options.width);
+  if (!width || !height) return url;
+  const base = removeImageUrlQuery(url);
+  const thumbnailUrl = base.replace(
+    /_thumbnail_\d+x\d*\.(webp|png|jpg|jpeg)/gi,
+    `_thumbnail_${width}x${height}.$1`
+  );
+  const next = thumbnailUrl.replace(
+    /_square_thumbnail_\d+x\d*\.(webp|png|jpg|jpeg)/gi,
+    `_square_thumbnail_${width}x${height}.$1`
+  );
+  return next === base ? url : next;
+}
+function buildAmazonImageResizeUrl(url, options = {}) {
+  const parsed = parseHttpUrl(url);
+  const isAmazonImageHost = parsed && (/(^|\.)media-amazon\.com$/i.test(parsed.hostname) || /(^|\.)ssl-images-amazon\.com$/i.test(parsed.hostname) || /(^|\.)amazon\./i.test(parsed.hostname));
+  if (!isAmazonImageHost) return url;
+  const width = toPositiveInteger(options.width);
+  const height = toPositiveInteger(options.height);
+  if (!width && !height) return url;
+  const single = String(width || height);
+  const pairW = String(width || height);
+  const pairH = String(height || width);
+  const base = removeImageUrlQuery(url);
+  const marker = "._AC_";
+  const i = base.indexOf(marker);
+  if (i === -1) return url;
+  const prefix = base.slice(0, i + marker.length);
+  let rest = base.slice(i + marker.length);
+  const reLead = new RegExp(`^(${AMAZON_DIM_TOKEN})(\\d+|full)(?:,(\\d+|full))?`, "i");
+  rest = rest.replace(
+    reLead,
+    (_m, tag, _n1, n2) => n2 != null && n2 !== "" ? `${tag}${pairW},${pairH}` : `${tag}${single}`
+  );
+  const reChain = new RegExp(`_(${AMAZON_DIM_TOKEN})(\\d+|full)(?:,(\\d+|full))?`, "gi");
+  rest = rest.replace(
+    reChain,
+    (_m, tag, _n1, n2) => n2 != null && n2 !== "" ? `_${tag}${pairW},${pairH}` : `_${tag}${single}`
+  );
+  return prefix + rest;
+}
+function buildEtsyImageResizeUrl(url, options = {}) {
+  const parsed = parseHttpUrl(url);
+  const isEtsyImageHost = parsed && (/(^|\.)etsystatic\.com$/i.test(parsed.hostname) || /(^|\.)etsy\./i.test(parsed.hostname));
+  if (!isEtsyImageHost) return url;
+  const width = toPositiveInteger(options.width) || toPositiveInteger(options.height);
+  const height = toPositiveInteger(options.height) || toPositiveInteger(options.width);
+  if (!width || !height) return url;
+  const base = removeImageUrlQuery(url);
+  const next = base.replace(/il_(?:\d+|full)x(?:\d+|full)\./i, `il_${width}x${height}.`);
+  return next === base ? url : next;
+}
+function resolveOssLinks(options = {}) {
+  var _a;
+  return (_a = options.ossLinks) != null ? _a : getOssLinks();
+}
+function isOssImageUrl(url, options = {}) {
+  const ossLinks2 = resolveOssLinks(options);
+  if (!ossLinks2.length) return false;
+  return ossLinks2.some((domain) => url.includes(domain));
+}
+function buildOssImageResizeUrl(url, options = {}) {
+  var _a;
+  if (!isOssImageUrl(url, options)) return url;
+  const width = toPositiveInteger(options.width);
+  const height = toPositiveInteger(options.height);
+  const qualityVal = (_a = options.Q) != null ? _a : options.q;
+  const format = options.format || "";
+  const formatPart = format ? `/format,${format}` : "";
+  const useAbsoluteQuality = options.Q != null;
+  let finalUrl = url;
+  const hasProcess = url.includes("x-oss-process=");
+  if (hasProcess) {
+    if (height) finalUrl = finalUrl.replace(/h_\d+/, `h_${height}`);
+    if (width) finalUrl = finalUrl.replace(/w_\d+/, `w_${width}`);
+    if (qualityVal) {
+      finalUrl = finalUrl.replace(
+        /quality,[Qq]_\d+/,
+        `quality,${useAbsoluteQuality ? "Q" : "q"}_${qualityVal}`
+      );
+    }
+    if (format) {
+      if (finalUrl.includes("/format,")) {
+        finalUrl = finalUrl.replace(/\/format,\w+/, formatPart);
+      } else {
+        finalUrl += formatPart;
+      }
+    }
+    return finalUrl;
+  }
+  let resizeStr = "resize,";
+  if (width) resizeStr += `w_${width}`;
+  else if (height) resizeStr += `h_${height}`;
+  else resizeStr += "l_120";
+  const qualityPart = qualityVal && qualityVal >= 1 && qualityVal <= 100 ? `/quality,${useAbsoluteQuality ? "Q" : "q"}_${qualityVal}` : "";
+  const connector = url.includes("?") ? "&" : "?";
+  return `${url}${connector}x-oss-process=image/${resizeStr}${qualityPart}${formatPart}`;
+}
+const IMAGE_RESIZE_RULES = [
+  {
+    name: "temu-kwcdn",
+    match: (url) => /(^|\.)kwcdn\.com$/i.test(url.hostname),
+    build: buildTemuImageResizeUrl
+  },
+  {
+    name: "shein-ltwebstatic",
+    match: (url) => /(^|\.)ltwebstatic\.com$/i.test(url.hostname),
+    build: buildSheinImageResizeUrl
+  },
+  {
+    name: "amazon",
+    match: (url) => /(^|\.)media-amazon\.com$/i.test(url.hostname) || /(^|\.)ssl-images-amazon\.com$/i.test(url.hostname) || /(^|\.)amazon\./i.test(url.hostname),
+    build: buildAmazonImageResizeUrl
+  },
+  {
+    name: "etsy",
+    match: (url) => /(^|\.)etsystatic\.com$/i.test(url.hostname) || /(^|\.)etsy\./i.test(url.hostname),
+    build: buildEtsyImageResizeUrl
+  },
+  {
+    name: "oss",
+    match: (url, options) => isOssImageUrl(url.href, options),
+    build: buildOssImageResizeUrl
+  }
+];
+const IMAGE_ORIGINAL_RULES = [
+  {
+    name: "temu-kwcdn",
+    match: (url) => /(^|\.)kwcdn\.com$/i.test(url.hostname),
+    build: getTemuOriginalImageUrl
+  },
+  {
+    name: "shein-ltwebstatic",
+    match: (url) => /(^|\.)ltwebstatic\.com$/i.test(url.hostname),
+    build: getSheinOriginalImageUrl
+  },
+  {
+    name: "amazon",
+    match: (url) => /(^|\.)media-amazon\.com$/i.test(url.hostname) || /(^|\.)ssl-images-amazon\.com$/i.test(url.hostname) || /(^|\.)amazon\./i.test(url.hostname),
+    build: getAmazonOriginalImageUrl
+  },
+  {
+    name: "etsy",
+    match: (url) => /(^|\.)etsystatic\.com$/i.test(url.hostname) || /(^|\.)etsy\./i.test(url.hostname),
+    build: getEtsyOriginalImageUrl
+  }
+];
+function buildPlatformImageResizeUrl(url, options = {}) {
+  const raw = (url || "").trim();
+  if (!raw) return "";
+  const parsed = parseHttpUrl(raw);
+  if (!parsed) return url;
+  const rule = IMAGE_RESIZE_RULES.find((item) => item.match(parsed, options));
+  if (!rule) return url;
+  return rule.build(raw, options);
+}
+function getPlatformOriginalImageUrl(url) {
+  const raw = (url || "").trim();
+  if (!raw) return "";
+  const parsed = parseHttpUrl(raw);
+  if (!parsed) return url;
+  const rule = IMAGE_ORIGINAL_RULES.find((item) => item.match(parsed));
+  if (!rule) return url;
+  return rule.build(raw);
+}
+function getImageResizeRuleName(url) {
+  var _a;
+  const parsed = parseHttpUrl(url);
+  if (!parsed) return "";
+  return ((_a = IMAGE_RESIZE_RULES.find((item) => item.match(parsed))) == null ? void 0 : _a.name) || "";
+}
+const notSupportedImgTypes = ["tif", "tiff", "psd"];
+function isUnsupportedImg(url) {
+  const pathname = url.split(/[?#]/)[0];
+  const filename = pathname.slice(pathname.lastIndexOf("/") + 1);
+  const dot = filename.lastIndexOf(".");
+  if (dot === -1) return false;
+  return notSupportedImgTypes.includes(filename.slice(dot + 1).toLowerCase());
+}
+function replaceUnsupportedImg(url = "") {
+  if (!url) return url;
+  return isUnsupportedImg(url) ? getImgFasten().notSupported : url;
+}
+function temuThumbUrl(url, imgSize) {
+  var _a, _b;
+  return buildPlatformImageResizeUrl(url, {
+    width: (_b = (_a = imgSize == null ? void 0 : imgSize.w) != null ? _a : imgSize == null ? void 0 : imgSize.h) != null ? _b : 200,
+    height: imgSize == null ? void 0 : imgSize.h
+  });
+}
+function toPlatformResizeOptions(imgSize, ossLinks2) {
+  var _a, _b;
+  const width = (_a = imgSize == null ? void 0 : imgSize.w) != null ? _a : imgSize == null ? void 0 : imgSize.h;
+  const height = (_b = imgSize == null ? void 0 : imgSize.h) != null ? _b : imgSize == null ? void 0 : imgSize.w;
+  return {
+    width,
+    height,
+    Q: imgSize == null ? void 0 : imgSize.Q,
+    q: imgSize == null ? void 0 : imgSize.q,
+    format: typeof (imgSize == null ? void 0 : imgSize.format) === "string" ? imgSize.format : void 0,
+    ossLinks: ossLinks2
+  };
+}
+function montageImgUrl(url = "", imgSize, options = {}) {
+  var _a;
+  const imgFasten2 = getImgFasten();
+  if (!url) return imgFasten2.empty;
+  if (isUnsupportedImg(url)) return imgFasten2.notSupported;
+  const ruleName = getImageResizeRuleName(url);
+  const ossLinks2 = (_a = options.ossLinks) != null ? _a : getOssLinks();
+  const hitOssByLinks = ossLinks2.some((domain) => url.includes(domain));
+  if (ruleName === "oss" || !ruleName && hitOssByLinks) {
+    if (!hitOssByLinks) return url;
+    const networkOpts = getNetworkAdaptiveOptions(imgSize || { h: 260, Q: 92 });
+    return buildPlatformImageResizeUrl(url, toPlatformResizeOptions(__spreadValues(__spreadValues({}, imgSize), networkOpts), ossLinks2));
+  }
+  if (ruleName) {
+    return buildPlatformImageResizeUrl(url, toPlatformResizeOptions(imgSize));
+  }
+  return url;
+}
+export {
+  DEFAULT_IMG_FASTEN as D,
+  getImgFasten as a,
+  buildPlatformImageResizeUrl as b,
+  configureImgUrl as c,
+  getNetworkAdaptiveOptions as d,
+  getOssLinks as e,
+  getPlatformOriginalImageUrl as f,
+  getImageResizeRuleName as g,
+  initNetworkListener as h,
+  imgUrlConfigKey as i,
+  isUnsupportedImg as j,
+  notSupportedImgTypes as k,
+  replaceUnsupportedImg as l,
+  montageImgUrl as m,
+  networkKey as n,
+  removeImageUrlQuery as r,
+  temuThumbUrl as t
+};

package/dist/tools/ImageParserUtils/index.d.ts

@@ -4,4 +4,4 @@
 export { parsePSD } from './parsePSD';
 export { parseTIFF } from './parseTIFF';
 export { parseImage } from './parseImage';
-export { parsePSDFile, parseTIFFFile, parseImageFile, detectFileType, formatFileSize, parseFile, parseFiles, type ParsedImageInfo, type ParseOptions } from './common';
+export { parsePSDFile, parseTIFFFile, parseImageFile, detectFileType, formatFileSize, parseFile, parseFiles, type ParsedImageInfo, type ParseOptions, type AgPsdOptions, } from './common';

package/dist/tools/imgUrl/imageUrl.d.ts

@@ -0,0 +1,209 @@
+type ImageSizeValue = number | string | null | undefined;
+export type ImageResizeOptions = {
+    width?: ImageSizeValue;
+    height?: ImageSizeValue;
+    /** OSS 绝对质量 Q（1–100） */
+    Q?: number;
+    /** OSS 相对质量 q（1–100）；与 Q 同时存在时优先 Q */
+    q?: number;
+    /** OSS 输出格式，如 webp */
+    format?: string;
+    /** 当前调用使用的 OSS 域名白名单；未传时使用 configureImgUrl 注入的全局配置 */
+    ossLinks?: string[];
+};
+/**
+ * 移除 URL query，保留 hash。
+ *
+ * @example
+ * removeImageUrlQuery('https://a.com/img.jpg?x=1#top')
+ * // 'https://a.com/img.jpg#top'
+ */
+export declare function removeImageUrlQuery(url: string): string;
+/**
+ * Temu / kwcdn 获取原图。
+ *
+ * 当前采集规则是直接去掉 query 参数。
+ *
+ * @example
+ * getTemuOriginalImageUrl(
+ *     'https://img.kwcdn.com/thumbnail/s/a.jpeg?imageView2/2/w/150/q/50/format/avif%7CimageVqr/2'
+ * )
+ * // 'https://img.kwcdn.com/thumbnail/s/a.jpeg'
+ */
+export declare function getTemuOriginalImageUrl(url: string): string;
+/**
+ * Shein / ltwebstatic 获取原图。
+ *
+ * 当前采集规则：
+ * - _thumbnail_405x552.jpg -> _thumbnail_fullx.jpg
+ * - _square_thumbnail_405x552.jpg -> _square_thumbnail_fullx.jpg
+ *
+ * @example
+ * getSheinOriginalImageUrl(
+ *     '//img.ltwebstatic.com/v4/j/pi/2025/12/12/22/a_thumbnail_405x552.jpg'
+ * )
+ * // '//img.ltwebstatic.com/v4/j/pi/2025/12/12/22/a_thumbnail_fullx.jpg'
+ */
+export declare function getSheinOriginalImageUrl(url: string): string;
+/**
+ * Amazon 获取原图。
+ *
+ * 当前采集规则是把 ._AC_ 后的尺寸段扩成 full，保留 QL/FMwebp 等非尺寸段。
+ *
+ * @example
+ * getAmazonOriginalImageUrl('https://m.media-amazon.com/images/I/abc._AC_UL450_SR450,320_.jpg')
+ * // 'https://m.media-amazon.com/images/I/abc._AC_ULfull_SRfull,full_.jpg'
+ */
+export declare function getAmazonOriginalImageUrl(url: string): string;
+/**
+ * Etsy 获取原图。
+ *
+ * 当前采集规则：il_75x75 / il_340x270 等改成 il_fullxfull。
+ *
+ * @example
+ * getEtsyOriginalImageUrl('https://i.etsystatic.com/123/r/il_340x270.456.jpg')
+ * // 'https://i.etsystatic.com/123/r/il_fullxfull.456.jpg'
+ */
+export declare function getEtsyOriginalImageUrl(url: string): string;
+/**
+ * Temu / kwcdn
+ *
+ * 优先使用 width；未传 width 时回退 height（组件侧常只传 h）。
+ * 原链接已有 query（含历史 imageView2 / 非法双 ? + imageMogr2）时，先清掉再统一换成 imageView2。
+ *
+ * @example
+ * buildTemuImageResizeUrl(
+ *     'https://img.kwcdn.com/thumbnail/s/a.jpeg?imageView2/2/w/500/q/70/format/avif?imageMogr2/thumbnail/100x',
+ *     { width: 100 }
+ * )
+ * // 'https://img.kwcdn.com/thumbnail/s/a.jpeg?imageView2/2/w/100/q/50/format/avif%7CimageVqr/2'
+ */
+export declare function buildTemuImageResizeUrl(url: string, options?: ImageResizeOptions): string;
+/**
+ * Shein / ltwebstatic
+ *
+ * Shein 尺寸在文件路径里，不在 query 中；因此通过替换路径里的 thumbnail 尺寸实现。
+ * 宽高缺一时用另一个回填。
+ *
+ * @example
+ * buildSheinImageResizeUrl(
+ *     '//img.ltwebstatic.com/v4/j/pi/2025/12/12/22/a_thumbnail_405x552.jpg',
+ *     { width: 300, height: 409 }
+ * )
+ * // '//img.ltwebstatic.com/v4/j/pi/2025/12/12/22/a_thumbnail_300x409.jpg'
+ */
+export declare function buildSheinImageResizeUrl(url: string, options?: ImageResizeOptions): string;
+/**
+ * Amazon
+ *
+ * 替换 ._AC_ 后 UL/SR/SX 等尺寸段；单值标签用 width（缺省用 height），
+ * 双值标签用 width,height（缺一则用另一个填充）。也支持把 full 改回具体尺寸。
+ *
+ * @example
+ * buildAmazonImageResizeUrl(
+ *     'https://m.media-amazon.com/images/I/abc._AC_UL450_SR450,320_.jpg',
+ *     { width: 200, height: 150 }
+ * )
+ * // 'https://m.media-amazon.com/images/I/abc._AC_UL200_SR200,150_.jpg'
+ */
+export declare function buildAmazonImageResizeUrl(url: string, options?: ImageResizeOptions): string;
+/**
+ * Etsy
+ *
+ * 将路径里的 il_{w}x{h} / il_fullxfull 替换为 il_{width}x{height}。
+ * 宽高缺一时用另一个回填（组件侧常只传 w 或 h）。
+ *
+ * @example
+ * buildEtsyImageResizeUrl(
+ *     'https://i.etsystatic.com/123/r/il_340x270.456.jpg',
+ *     { width: 200, height: 200 }
+ * )
+ * // 'https://i.etsystatic.com/123/r/il_200x200.456.jpg'
+ *
+ * @example
+ * buildEtsyImageResizeUrl(
+ *     'https://i.etsystatic.com/123/r/il_fullxfull.456.jpg',
+ *     { width: 100 }
+ * )
+ * // 'https://i.etsystatic.com/123/r/il_100x100.456.jpg'
+ */
+export declare function buildEtsyImageResizeUrl(url: string, options?: ImageResizeOptions): string;
+/**
+ * OSS（阿里云等）图片处理参数拼接。
+ *
+ * 规则对齐 montageImgUrl：
+ * - 命中 ossLinks 白名单才处理
+ * - 已有 x-oss-process 时原地替换 w_/h_/quality/format
+ * - 否则追加 ?x-oss-process=image/resize,w_{width}|h_{height}
+ * - 新建 process 且宽高都缺失时，默认 l_120（与 montageImgUrl 一致）
+ *
+ * @example
+ * buildOssImageResizeUrl(
+ *     'https://static.fangguo.com/a.jpg',
+ *     { width: 200, Q: 90, ossLinks: ['static.fangguo.com'] }
+ * )
+ * // 'https://static.fangguo.com/a.jpg?x-oss-process=image/resize,w_200/quality,Q_90'
+ */
+export declare function buildOssImageResizeUrl(url: string, options?: ImageResizeOptions): string;
+/**
+ * 按图片域名/平台拼接对应尺寸参数。
+ * 未匹配或参数不足的平台会原链接返回。
+ *
+ * @example
+ * buildPlatformImageResizeUrl(
+ *     'https://img.kwcdn.com/thumbnail/s/a.jpeg',
+ *     { width: 150 }
+ * )
+ * // 'https://img.kwcdn.com/thumbnail/s/a.jpeg?imageView2/2/w/150/q/50/format/avif%7CimageVqr/2'
+ *
+ * @example
+ * buildPlatformImageResizeUrl(
+ *     '//img.ltwebstatic.com/v4/j/pi/2025/12/12/22/a_thumbnail_405x552.jpg',
+ *     { width: 300, height: 409 }
+ * )
+ * // '//img.ltwebstatic.com/v4/j/pi/2025/12/12/22/a_thumbnail_300x409.jpg'
+ *
+ * @example
+ * buildPlatformImageResizeUrl(
+ *     'https://img.fangguo.com/a.jpg',
+ *     { width: 200, Q: 90, ossLinks: ['img.fangguo.com'] }
+ * )
+ * // 'https://img.fangguo.com/a.jpg?x-oss-process=image/resize,w_200/quality,Q_90'
+ *
+ * @example
+ * buildPlatformImageResizeUrl('https://example.com/a.jpg', { width: 100 })
+ * // 'https://example.com/a.jpg'
+ */
+export declare function buildPlatformImageResizeUrl(url: string, options?: ImageResizeOptions): string;
+/**
+ * 按当前商品采集规则获取主图/原图。
+ * 未匹配的平台会原链接返回。
+ *
+ * @example
+ * getPlatformOriginalImageUrl(
+ *     'https://img.kwcdn.com/thumbnail/s/a.jpeg?imageView2/2/w/150/q/50/format/avif%7CimageVqr/2'
+ * )
+ * // 'https://img.kwcdn.com/thumbnail/s/a.jpeg'
+ *
+ * @example
+ * getPlatformOriginalImageUrl(
+ *     '//img.ltwebstatic.com/v4/j/pi/2025/12/12/22/a_thumbnail_405x552.jpg'
+ * )
+ * // '//img.ltwebstatic.com/v4/j/pi/2025/12/12/22/a_thumbnail_fullx.jpg'
+ */
+export declare function getPlatformOriginalImageUrl(url: string): string;
+/**
+ * 获取当前图片地址命中的规则名，便于调试或埋点。
+ * OSS 规则依赖 configureImgUrl 注入的全局 ossLinks。
+ *
+ * @example
+ * getImageResizeRuleName('https://img.kwcdn.com/thumbnail/s/a.jpeg')
+ * // 'temu-kwcdn'
+ *
+ * @example
+ * // configureImgUrl({ ossLinks: ['img.fangguo.com'] }) 之后
+ * getImageResizeRuleName('https://img.fangguo.com/a.jpg')
+ * // 'oss'
+ */
+export declare function getImageResizeRuleName(url: string): string;
+export {};

package/dist/tools/imgUrl/index.d.ts

@@ -1,4 +1,6 @@
 export { configureImgUrl, DEFAULT_IMG_FASTEN, getImgFasten, getOssLinks, imgUrlConfigKey } from './config';
 export { getNetworkAdaptiveOptions, initNetworkListener, networkKey } from './networkAdaptive';
 export { isUnsupportedImg, montageImgUrl, notSupportedImgTypes, replaceUnsupportedImg, temuThumbUrl, } from './montageImgUrl';
+export { buildPlatformImageResizeUrl, getImageResizeRuleName, getPlatformOriginalImageUrl, removeImageUrlQuery, } from './imageUrl';
+export type { ImageResizeOptions } from './imageUrl';
 export type { ImgFastenConfig, ImgSizeOptions, ImgUrlConfig, MontageImgUrlOptions } from './types';