@zumer/snapdom 1.7.1 → 1.9.3

package/dist/snapdom.mjs

@@ -1,11 +1,12 @@
 
 /*
 * snapdom
-* v.1.7.1
+* v.1.9.3
 * Author Juan Martin Muda
 * License MIT
 **/
 
+
 // src/core/cache.js
 var imageCache = /* @__PURE__ */ new Map();
 var bgCache = /* @__PURE__ */ new Map();
@@ -13,6 +14,7 @@ var resourceCache = /* @__PURE__ */ new Map();
 var defaultStylesCache = /* @__PURE__ */ new Map();
 var baseCSSCache = /* @__PURE__ */ new Map();
 var computedStyleCache = /* @__PURE__ */ new WeakMap();
+var processedFontURLs = /* @__PURE__ */ new Set();
 
 // src/utils/cssTools.js
 var commonTags = [
@@ -152,6 +154,26 @@ function generateCSSClasses(styleMap) {
 }
 
 // src/utils/helpers.js
+async function inlineSingleBackgroundEntry(entry, options = {}) {
+  const isUrl = entry.startsWith("url(");
+  const isGradient = /^((repeating-)?(linear|radial|conic)-gradient)\(/i.test(entry);
+  if (isUrl) {
+    const rawUrl = extractURL(entry);
+    if (!rawUrl) return entry;
+    const encodedUrl = safeEncodeURI(rawUrl);
+    if (bgCache.has(encodedUrl)) {
+      return options.skipInline ? void 0 : `url(${bgCache.get(encodedUrl)})`;
+    } else {
+      const dataUrl = await fetchImage(encodedUrl, { useProxy: options.useProxy });
+      bgCache.set(encodedUrl, dataUrl);
+      return options.skipInline ? void 0 : `url("${dataUrl}")`;
+    }
+  }
+  if (isGradient || entry === "none") {
+    return entry;
+  }
+  return entry;
+}
 function idle(fn, { fast = false } = {}) {
   if (fast) return fn();
   if ("requestIdleCallback" in window) {
@@ -196,29 +218,84 @@ function extractURL(value) {
   }
   return url;
 }
-function isIconFont(familyOrUrl) {
-  const iconFontPatterns = [
-    /font\s*awesome/i,
-    /material\s*icons/i,
-    /ionicons/i,
-    /glyphicons/i,
-    /feather/i,
-    /bootstrap\s*icons/i,
-    /remix\s*icons/i,
-    /heroicons/i
-  ];
-  return iconFontPatterns.some((rx) => rx.test(familyOrUrl));
-}
-function fetchImage(src, timeout = 3e3, crossOrigin = "anonymous") {
+function fetchImage(src, { timeout = 3e3, useProxy = "" } = {}) {
+  function getCrossOriginMode(url) {
+    try {
+      const parsed = new URL(url, window.location.href);
+      return parsed.origin === window.location.origin ? "use-credentials" : "anonymous";
+    } catch {
+      return "anonymous";
+    }
+  }
+  async function fetchWithFallback(url) {
+    const fetchBlobAsDataURL = (fetchUrl) => fetch(fetchUrl, {
+      mode: "cors",
+      credentials: getCrossOriginMode(fetchUrl) === "use-credentials" ? "include" : "omit"
+    }).then((r) => r.blob()).then((blob) => new Promise((resolve, reject) => {
+      const reader = new FileReader();
+      reader.onloadend = () => {
+        const base64 = reader.result;
+        if (typeof base64 !== "string" || !base64.startsWith("data:image/")) {
+          reject(new Error("Invalid image data URL"));
+          return;
+        }
+        resolve(base64);
+      };
+      reader.onerror = () => reject(new Error("FileReader error"));
+      reader.readAsDataURL(blob);
+    }));
+    try {
+      return await fetchBlobAsDataURL(url);
+    } catch (e) {
+      if (useProxy && typeof useProxy === "string") {
+        const proxied = useProxy.replace(/\/$/, "") + safeEncodeURI(url);
+        try {
+          return await fetchBlobAsDataURL(proxied);
+        } catch {
+          console.error(`[SnapDOM - fetchImage] Proxy fallback failed for: ${url}`);
+          throw new Error("CORS restrictions prevented image capture (even via proxy)");
+        }
+      } else {
+        console.error(`[SnapDOM - fetchImage] No valid proxy URL provided for fallback: ${url}`);
+        throw new Error("Fetch fallback failed and no proxy provided");
+      }
+    }
+  }
+  const crossOriginValue = getCrossOriginMode(src);
+  console.log(`[SnapDOM - fetchImage] Start loading image: ${src} with crossOrigin=${crossOriginValue}`);
   if (imageCache.has(src)) {
+    console.log(`[SnapDOM - fetchImage] Cache hit for: ${src}`);
     return Promise.resolve(imageCache.get(src));
   }
+  const isDataURI = src.startsWith("data:image/");
+  if (isDataURI) {
+    imageCache.set(src, src);
+    return Promise.resolve(src);
+  }
+  const isSVG = /\.svg(\?.*)?$/i.test(src);
+  if (isSVG) {
+    return (async () => {
+      try {
+        const response = await fetch(src, {
+          mode: "cors",
+          credentials: crossOriginValue === "use-credentials" ? "include" : "omit"
+        });
+        const svgText = await response.text();
+        const encoded = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svgText)}`;
+        imageCache.set(src, encoded);
+        return encoded;
+      } catch {
+        return fetchWithFallback(src);
+      }
+    })();
+  }
   return new Promise((resolve, reject) => {
     const timeoutId = setTimeout(() => {
+      console.log(`[SnapDOM - fetchImage] Timeout after ${timeout}ms for image: ${src}`);
       reject(new Error("Image load timed out"));
     }, timeout);
     const image = new Image();
-    image.crossOrigin = crossOrigin;
+    image.crossOrigin = crossOriginValue;
     image.onload = async () => {
       clearTimeout(timeoutId);
       try {
@@ -228,20 +305,29 @@ function fetchImage(src, timeout = 3e3, crossOrigin = "anonymous") {
         canvas.height = image.height;
         const ctx = canvas.getContext("2d");
         ctx.drawImage(image, 0, 0, canvas.width, canvas.height);
+        const dataURL = canvas.toDataURL("image/png");
+        imageCache.set(src, dataURL);
+        resolve(dataURL);
+      } catch {
         try {
-          const dataURL = canvas.toDataURL("image/png");
-          imageCache.set(src, dataURL);
-          resolve(dataURL);
+          const fallbackDataURL = await fetchWithFallback(src);
+          imageCache.set(src, fallbackDataURL);
+          resolve(fallbackDataURL);
         } catch (e) {
-          reject(new Error("CORS restrictions prevented image capture"));
+          reject(e);
         }
-      } catch (e) {
-        reject(e);
       }
     };
-    image.onerror = (e) => {
+    image.onerror = async () => {
       clearTimeout(timeoutId);
-      reject(new Error("Failed to load image: " + (e.message || "Unknown error")));
+      console.error(`[SnapDOM - fetchImage] Image failed to load: ${src}`);
+      try {
+        const fallbackDataURL = await fetchWithFallback(src);
+        imageCache.set(src, fallbackDataURL);
+        resolve(fallbackDataURL);
+      } catch (e) {
+        reject(e);
+      }
     };
     image.src = src;
   });
@@ -256,35 +342,136 @@ function snapshotComputedStyle(style) {
 function isSafari() {
   return /^((?!chrome|android).)*safari/i.test(navigator.userAgent);
 }
+function stripTranslate(transform) {
+  if (!transform || transform === "none") return "";
+  let cleaned = transform.replace(/translate[XY]?\([^)]*\)/g, "");
+  cleaned = cleaned.replace(/matrix\(([^)]+)\)/g, (_, values) => {
+    const parts = values.split(",").map((s) => s.trim());
+    if (parts.length !== 6) return `matrix(${values})`;
+    parts[4] = "0";
+    parts[5] = "0";
+    return `matrix(${parts.join(", ")})`;
+  });
+  cleaned = cleaned.replace(/matrix3d\(([^)]+)\)/g, (_, values) => {
+    const parts = values.split(",").map((s) => s.trim());
+    if (parts.length !== 16) return `matrix3d(${values})`;
+    parts[12] = "0";
+    parts[13] = "0";
+    return `matrix3d(${parts.join(", ")})`;
+  });
+  return cleaned.trim().replace(/\s{2,}/g, " ");
+}
+function safeEncodeURI(uri) {
+  if (/%[0-9A-Fa-f]{2}/.test(uri)) return uri;
+  try {
+    return encodeURI(uri);
+  } catch {
+    return uri;
+  }
+}
+function splitBackgroundImage(bg) {
+  const parts = [];
+  let depth = 0;
+  let lastIndex = 0;
+  for (let i = 0; i < bg.length; i++) {
+    const char = bg[i];
+    if (char === "(") depth++;
+    if (char === ")") depth--;
+    if (char === "," && depth === 0) {
+      parts.push(bg.slice(lastIndex, i).trim());
+      lastIndex = i + 1;
+    }
+  }
+  parts.push(bg.slice(lastIndex).trim());
+  return parts;
+}
 
 // src/modules/styles.js
+var snapshotCache = /* @__PURE__ */ new WeakMap();
+var snapshotKeyCache = /* @__PURE__ */ new Map();
+function snapshotComputedStyleFull(style) {
+  const result = {};
+  for (let i = 0; i < style.length; i++) {
+    const prop = style[i];
+    let val = style.getPropertyValue(prop);
+    if ((prop === "background-image" || prop === "content") && val.includes("url(") && !val.includes("data:")) {
+      val = "none";
+    }
+    result[prop] = val;
+  }
+  return result;
+}
 function inlineAllStyles(source, clone, styleMap, cache, compress) {
   if (source.tagName === "STYLE") return;
   if (!cache.has(source)) {
     cache.set(source, getStyle(source));
   }
   const style = cache.get(source);
-  const snapshot = snapshotComputedStyle(style);
+  if (!snapshotCache.has(source)) {
+    const snapshot2 = snapshotComputedStyleFull(style);
+    snapshotCache.set(source, snapshot2);
+  }
+  const snapshot = snapshotCache.get(source);
+  const hash = Object.entries(snapshot).sort(([a], [b]) => a.localeCompare(b)).map(([prop, val]) => `${prop}:${val}`).join(";");
+  if (snapshotKeyCache.has(hash)) {
+    styleMap.set(clone, snapshotKeyCache.get(hash));
+    return;
+  }
   const tagName = source.tagName?.toLowerCase() || "div";
   const key = getStyleKey(snapshot, tagName, compress);
+  snapshotKeyCache.set(hash, key);
   styleMap.set(clone, key);
 }
 
 // src/core/clone.js
-function deepClone(node, styleMap, styleCache, nodeMap, compress) {
-  if (node.nodeType === Node.ELEMENT_NODE && node.getAttribute("data-capture") === "exclude") {
+function deepClone(node, styleMap, styleCache, nodeMap, compress, options = {}, originalRoot) {
+  if (node.nodeType === Node.TEXT_NODE) {
+    if (node.parentElement?.shadowRoot) {
+      const tag = node.parentElement.tagName.toLowerCase();
+      if (customElements.get(tag)) return null;
+    }
+    return node.cloneNode(true);
+  }
+  if (node.nodeType !== Node.ELEMENT_NODE) return node.cloneNode(true);
+  if (node.getAttribute("data-capture") === "exclude") {
     const spacer = document.createElement("div");
     const rect = node.getBoundingClientRect();
     spacer.style.cssText = `display: inline-block; width: ${rect.width}px; height: ${rect.height}px; visibility: hidden;`;
     return spacer;
   }
+  if (options.exclude && Array.isArray(options.exclude) && options.exclude.length > 0) {
+    for (const selector of options.exclude) {
+      try {
+        if (node.matches && node.matches(selector)) {
+          const spacer = document.createElement("div");
+          const rect = node.getBoundingClientRect();
+          spacer.style.cssText = `display: inline-block; width: ${rect.width}px; height: ${rect.height}px; visibility: hidden;`;
+          return spacer;
+        }
+      } catch (err) {
+        console.warn(`Invalid selector in exclude option: ${selector}`, err);
+      }
+    }
+  }
+  if (typeof options.filter === "function") {
+    try {
+      if (!options.filter(node, originalRoot || node)) {
+        const spacer = document.createElement("div");
+        const rect = node.getBoundingClientRect();
+        spacer.style.cssText = `display: inline-block; width: ${rect.width}px; height: ${rect.height}px; visibility: hidden;`;
+        return spacer;
+      }
+    } catch (err) {
+      console.warn("Error in filter function:", err);
+    }
+  }
   if (node.tagName === "IFRAME") {
     const fallback = document.createElement("div");
     fallback.textContent = "";
-    fallback.style.cssText = `width: ${node.offsetWidth}px; height: ${node.offsetHeight}px; background: repeating-linear-gradient(45deg, #ddd, #ddd 5px, #f9f9f9 5px, #f9f9f9 10px);display: flex;align-items: center;justify-content: center;font-size: 12px;color: #555; border: 1px solid #aaa;`;
+    fallback.style.cssText = `width: ${node.offsetWidth}px; height: ${node.offsetHeight}px; background-image: repeating-linear-gradient(45deg, #ddd, #ddd 5px, #f9f9f9 5px, #f9f9f9 10px);display: flex;align-items: center;justify-content: center;font-size: 12px;color: #555; border: 1px solid #aaa;`;
     return fallback;
   }
-  if (node.nodeType === Node.ELEMENT_NODE && node.getAttribute("data-capture") === "placeholder") {
+  if (node.getAttribute("data-capture") === "placeholder") {
     const clone2 = node.cloneNode(false);
     nodeMap.set(clone2, node);
     inlineAllStyles(node, clone2, styleMap, styleCache, compress);
@@ -301,18 +488,10 @@ function deepClone(node, styleMap, styleCache, nodeMap, compress) {
     img.width = node.width;
     img.height = node.height;
     img.style.display = "inline-block";
-    img.style.width = `${node.width}px`;
-    img.style.height = `${node.height}px`;
+    img.style.width = node.style.width || `${node.width}px`;
+    img.style.height = node.style.height || `${node.height}px`;
     return img;
   }
-  if (node.nodeType === Node.TEXT_NODE) {
-    if (node.parentElement?.shadowRoot) {
-      const tag = node.parentElement.tagName.toLowerCase();
-      if (customElements.get(tag)) return null;
-    }
-    return node.cloneNode(true);
-  }
-  if (node.nodeType !== Node.ELEMENT_NODE) return node.cloneNode(true);
   const clone = node.cloneNode(false);
   nodeMap.set(clone, node);
   if (node instanceof HTMLInputElement) {
@@ -337,13 +516,14 @@ function deepClone(node, styleMap, styleCache, nodeMap, compress) {
   }
   inlineAllStyles(node, clone, styleMap, styleCache, compress);
   const frag = document.createDocumentFragment();
+  const rootElement = originalRoot || node;
   node.childNodes.forEach((child) => {
-    const clonedChild = deepClone(child, styleMap, styleCache, nodeMap, compress);
+    const clonedChild = deepClone(child, styleMap, styleCache, nodeMap, compress, options, rootElement);
     if (clonedChild) frag.appendChild(clonedChild);
   });
   clone.appendChild(frag);
   if (node.shadowRoot) {
-    const shadowContent = Array.from(node.shadowRoot.children).filter((el) => el.tagName !== "STYLE").map((el) => deepClone(el, styleMap, styleCache, nodeMap)).filter(Boolean);
+    const shadowContent = Array.from(node.shadowRoot.children).filter((el) => el.tagName !== "STYLE").map((el) => deepClone(el, styleMap, styleCache, nodeMap, compress, options, rootElement)).filter(Boolean);
     const shadowFrag = document.createDocumentFragment();
     shadowContent.forEach((child) => shadowFrag.appendChild(child));
     clone.appendChild(shadowFrag);
@@ -351,6 +531,43 @@ function deepClone(node, styleMap, styleCache, nodeMap, compress) {
   return clone;
 }
 
+// src/modules/iconFonts.js
+var defaultIconFonts = [
+  // /uicons/i,
+  /font\s*awesome/i,
+  /material\s*icons/i,
+  /ionicons/i,
+  /glyphicons/i,
+  /feather/i,
+  /bootstrap\s*icons/i,
+  /remix\s*icons/i,
+  /heroicons/i,
+  /layui/i,
+  /lucide/i
+];
+var userIconFonts = [];
+function extendIconFonts(fonts) {
+  const list = Array.isArray(fonts) ? fonts : [fonts];
+  for (const f of list) {
+    if (f instanceof RegExp) {
+      userIconFonts.push(f);
+    } else if (typeof f === "string") {
+      userIconFonts.push(new RegExp(f, "i"));
+    } else {
+      console.warn("[snapdom] Ignored invalid iconFont value:", f);
+    }
+  }
+}
+function isIconFont(input) {
+  const text = typeof input === "string" ? input : "";
+  const candidates = [...defaultIconFonts, ...userIconFonts];
+  for (const rx of candidates) {
+    if (rx instanceof RegExp && rx.test(text)) return true;
+  }
+  if (/icon/i.test(text) || /glyph/i.test(text) || /symbols/i.test(text) || /feather/i.test(text) || /fontawesome/i.test(text)) return true;
+  return false;
+}
+
 // src/modules/fonts.js
 async function iconToImage(unicodeChar, fontFamily, fontWeight, fontSize = 32, color = "#000") {
   fontFamily = fontFamily.replace(/^['"]+|['"]+$/g, "");
@@ -375,36 +592,67 @@ async function iconToImage(unicodeChar, fontFamily, fontWeight, fontSize = 32, c
   ctx.fillText(unicodeChar, 0, ascent);
   return canvas.toDataURL();
 }
-async function embedCustomFonts({ ignoreIconFonts = true, preCached = false } = {}) {
+function isStylesheetLoaded(href) {
+  return Array.from(document.styleSheets).some((sheet) => sheet.href === href);
+}
+function injectLinkIfMissing(href) {
+  return new Promise((resolve) => {
+    if (isStylesheetLoaded(href)) return resolve(null);
+    const link = document.createElement("link");
+    link.rel = "stylesheet";
+    link.href = href;
+    link.setAttribute("data-snapdom", "injected-import");
+    link.onload = () => resolve(link);
+    link.onerror = () => resolve(null);
+    document.head.appendChild(link);
+  });
+}
+async function embedCustomFonts({ preCached = false } = {}) {
+  if (resourceCache.has("fonts-embed-css")) {
+    if (preCached) {
+      const style = document.createElement("style");
+      style.setAttribute("data-snapdom", "embedFonts");
+      style.textContent = resourceCache.get("fonts-embed-css");
+      document.head.appendChild(style);
+    }
+    return resourceCache.get("fonts-embed-css");
+  }
+  const importRegex = /@import\s+url\(["']?([^"')]+)["']?\)/g;
+  const styleImports = [];
+  for (const styleTag of document.querySelectorAll("style")) {
+    const cssText = styleTag.textContent || "";
+    const matches = Array.from(cssText.matchAll(importRegex));
+    for (const match of matches) {
+      const importUrl = match[1];
+      if (isIconFont(importUrl)) continue;
+      if (!isStylesheetLoaded(importUrl)) {
+        styleImports.push(importUrl);
+      }
+    }
+  }
+  await Promise.all(styleImports.map(injectLinkIfMissing));
   const links = Array.from(document.querySelectorAll('link[rel="stylesheet"]')).filter((link) => link.href);
   let finalCSS = "";
   for (const link of links) {
     try {
       const res = await fetch(link.href);
       const cssText = await res.text();
-      if (ignoreIconFonts && (isIconFont(link.href) || isIconFont(cssText))) {
-        continue;
-      }
-      const urlRegex = /url\(([^)]+)\)/g;
+      if (isIconFont(link.href) || isIconFont(cssText)) continue;
+      const urlRegex = /url\((["']?)([^"')]+)\1\)/g;
       const inlinedCSS = await Promise.all(
         Array.from(cssText.matchAll(urlRegex)).map(async (match) => {
           let rawUrl = extractURL(match[0]);
           if (!rawUrl) return null;
           let url = rawUrl;
-          if (!url.startsWith("http")) {
+          if (!url.startsWith("http") && !url.startsWith("data:")) {
             url = new URL(url, link.href).href;
           }
-          try {
-            url = encodeURI(url);
-          } catch (e) {
-            console.warn("[snapdom] Failed to encode font URL:", url);
-          }
-          if (ignoreIconFonts && isIconFont(url)) {
-            return null;
-          }
+          if (isIconFont(url)) return null;
           if (resourceCache.has(url)) {
+            processedFontURLs.add(url);
             return { original: match[0], inlined: `url(${resourceCache.get(url)})` };
           }
+          if (processedFontURLs.has(url)) return null;
           try {
             const fontRes = await fetch(url);
             const blob = await fontRes.blob();
@@ -414,18 +662,17 @@ async function embedCustomFonts({ ignoreIconFonts = true, preCached = false } =
               reader.readAsDataURL(blob);
             });
             resourceCache.set(url, b64);
+            processedFontURLs.add(url);
             return { original: match[0], inlined: `url(${b64})` };
-          } catch (err) {
-            console.warn("[snapdom] Failed to fetch font:", url);
+          } catch (e) {
+            console.warn("[snapdom] Failed to fetch font resource:", url);
             return null;
           }
         })
       );
       let cssFinal = cssText;
       for (const r of inlinedCSS) {
-        if (r) {
-          cssFinal = cssFinal.replace(r.original, r.inlined);
-        }
+        if (r) cssFinal = cssFinal.replace(r.original, r.inlined);
       }
       finalCSS += cssFinal + "\n";
     } catch (e) {
@@ -438,24 +685,25 @@ async function embedCustomFonts({ ignoreIconFonts = true, preCached = false } =
         for (const rule of sheet.cssRules) {
           if (rule.type === CSSRule.FONT_FACE_RULE) {
             const src = rule.style.getPropertyValue("src");
-            if (!src) continue;
-            const urlRegex = /url\(([^)]+)\)/g;
+            const family = rule.style.getPropertyValue("font-family");
+            if (!src || isIconFont(family)) continue;
+            const urlRegex = /url\((["']?)([^"')]+)\1\)/g;
             let inlinedSrc = src;
             const matches = Array.from(src.matchAll(urlRegex));
             for (const match of matches) {
-              let rawUrl = match[1].trim().replace(/^["']|["']$/g, "");
+              let rawUrl = match[2].trim();
               if (!rawUrl) continue;
               let url = rawUrl;
               if (!url.startsWith("http") && !url.startsWith("data:")) {
                 url = new URL(url, sheet.href || location.href).href;
               }
-              if (ignoreIconFonts && isIconFont(url)) {
-                continue;
-              }
+              if (isIconFont(url)) continue;
               if (resourceCache.has(url)) {
+                processedFontURLs.add(url);
                 inlinedSrc = inlinedSrc.replace(match[0], `url(${resourceCache.get(url)})`);
                 continue;
               }
+              if (processedFontURLs.has(url)) continue;
               try {
                 const res = await fetch(url);
                 const blob = await res.blob();
@@ -465,13 +713,14 @@ async function embedCustomFonts({ ignoreIconFonts = true, preCached = false } =
                   reader.readAsDataURL(blob);
                 });
                 resourceCache.set(url, b64);
+                processedFontURLs.add(url);
                 inlinedSrc = inlinedSrc.replace(match[0], `url(${b64})`);
               } catch (e) {
                 console.warn("[snapdom] Failed to fetch font URL:", url);
               }
             }
             finalCSS += `@font-face {
-  font-family: ${rule.style.getPropertyValue("font-family")};
+  font-family: ${family};
   src: ${inlinedSrc};
   font-style: ${rule.style.getPropertyValue("font-style") || "normal"};
   font-weight: ${rule.style.getPropertyValue("font-weight") || "normal"};
@@ -486,11 +735,13 @@ async function embedCustomFonts({ ignoreIconFonts = true, preCached = false } =
   }
   for (const font of document.fonts) {
     if (font.family && font.status === "loaded" && font._snapdomSrc) {
+      if (isIconFont(font.family)) continue;
       let b64 = font._snapdomSrc;
       if (!b64.startsWith("data:")) {
         if (resourceCache.has(font._snapdomSrc)) {
           b64 = resourceCache.get(font._snapdomSrc);
-        } else {
+          processedFontURLs.add(font._snapdomSrc);
+        } else if (!processedFontURLs.has(font._snapdomSrc)) {
           try {
             const res = await fetch(font._snapdomSrc);
             const blob = await res.blob();
@@ -500,6 +751,7 @@ async function embedCustomFonts({ ignoreIconFonts = true, preCached = false } =
               reader.readAsDataURL(blob);
             });
             resourceCache.set(font._snapdomSrc, b64);
+            processedFontURLs.add(font._snapdomSrc);
           } catch (e) {
             console.warn("[snapdom] Failed to fetch dynamic font src:", font._snapdomSrc);
             continue;
@@ -515,27 +767,56 @@ async function embedCustomFonts({ ignoreIconFonts = true, preCached = false } =
 `;
     }
   }
-  if (finalCSS && preCached) {
-    const style = document.createElement("style");
-    style.setAttribute("data-snapdom", "embedFonts");
-    style.textContent = finalCSS;
-    document.head.appendChild(style);
+  if (finalCSS) {
+    resourceCache.set("fonts-embed-css", finalCSS);
+    if (preCached) {
+      const style = document.createElement("style");
+      style.setAttribute("data-snapdom", "embedFonts");
+      style.textContent = finalCSS;
+      document.head.appendChild(style);
+    }
   }
   return finalCSS;
 }
 
 // src/modules/pseudo.js
-async function inlinePseudoElements(source, clone, styleMap, styleCache, compress, embedFonts = false) {
+async function inlinePseudoElements(source, clone, styleMap, styleCache, compress, embedFonts = false, useProxy) {
   if (!(source instanceof Element) || !(clone instanceof Element)) return;
-  for (const pseudo of ["::before", "::after"]) {
+  for (const pseudo of ["::before", "::after", "::first-letter"]) {
     try {
       const style = getStyle(source, pseudo);
-      if (!style) continue;
+      if (!style || typeof style[Symbol.iterator] !== "function") continue;
+      if (pseudo === "::first-letter") {
+        const normal = getComputedStyle(source);
+        const isMeaningful = style.color !== normal.color || style.fontSize !== normal.fontSize || style.fontWeight !== normal.fontWeight;
+        if (!isMeaningful) continue;
+        const textNode = Array.from(clone.childNodes).find(
+          (n) => n.nodeType === Node.TEXT_NODE && n.textContent && n.textContent.trim().length > 0
+        );
+        if (!textNode) continue;
+        const text = textNode.textContent;
+        const match = text.match(/^([^\p{L}\p{N}\s]*[\p{L}\p{N}](?:['’])?)/u);
+        const first = match?.[0];
+        const rest = text.slice(first?.length || 0);
+        if (!first || /[\uD800-\uDFFF]/.test(first)) continue;
+        const span = document.createElement("span");
+        span.textContent = first;
+        span.dataset.snapdomPseudo = "::first-letter";
+        const snapshot = snapshotComputedStyle(style);
+        const key = getStyleKey(snapshot, "span", compress);
+        styleMap.set(span, key);
+        const restNode = document.createTextNode(rest);
+        clone.replaceChild(restNode, textNode);
+        clone.insertBefore(span, restNode);
+        continue;
+      }
       const content = style.getPropertyValue("content");
       const bg = style.getPropertyValue("background-image");
-      const hasContent = content && content !== "none" && content !== '""' && content !== "''";
-      const hasBg = bg && bg.startsWith("url(");
-      if (hasContent || hasBg) {
+      const bgColor = style.getPropertyValue("background-color");
+      const hasContent = content !== "none";
+      const hasBg = bg && bg !== "none";
+      const hasBgColor = bgColor && bgColor !== "transparent" && bgColor !== "rgba(0, 0, 0, 0)";
+      if (hasContent || hasBg || hasBgColor) {
         const fontFamily = style.getPropertyValue("font-family");
         const fontSize = parseInt(style.getPropertyValue("font-size")) || 32;
         const fontWeight = parseInt(style.getPropertyValue("font-weight")) || false;
@@ -545,29 +826,21 @@ async function inlinePseudoElements(source, clone, styleMap, styleCache, compres
         const snapshot = snapshotComputedStyle(style);
         const key = getStyleKey(snapshot, "span", compress);
         styleMap.set(pseudoEl, key);
-        const isIconFont2 = fontFamily && /font.*awesome|material|bootstrap|glyphicons|ionicons|remixicon|simple-line-icons|octicons|feather|typicons|weathericons/i.test(
-          fontFamily
-        );
-        let cleanContent = parseContent(content);
-        if (!embedFonts && isIconFont2 && cleanContent.length === 1) {
+        const isIconFont2 = isIconFont(fontFamily);
+        const cleanContent = parseContent(content);
+        if (isIconFont2 && cleanContent.length === 1) {
           const imgEl = document.createElement("img");
-          imgEl.src = await iconToImage(
-            cleanContent,
-            fontFamily,
-            fontWeight,
-            fontSize,
-            color
-          );
-          imgEl.style = "display:block;width:100%;height:100%;object-fit:contain;";
+          imgEl.src = await iconToImage(cleanContent, fontFamily, fontWeight, fontSize, color);
+          imgEl.style = `width:${fontSize}px;height:auto;object-fit:contain;`;
           pseudoEl.appendChild(imgEl);
         } else if (cleanContent.startsWith("url(")) {
           const rawUrl = extractURL(cleanContent);
-          if (rawUrl) {
+          if (rawUrl && rawUrl.trim() !== "") {
             try {
               const imgEl = document.createElement("img");
-              const dataUrl = await fetchImage(encodeURI(rawUrl));
+              const dataUrl = await fetchImage(safeEncodeURI(rawUrl, { useProxy }));
               imgEl.src = dataUrl;
-              imgEl.style = "display:block;width:100%;height:100%;object-fit:contain;";
+              imgEl.style = `width:${fontSize}px;height:auto;object-fit:contain;`;
               pseudoEl.appendChild(imgEl);
             } catch (e) {
               console.error(`[snapdom] Error in pseudo ${pseudo} for`, source, e);
@@ -576,24 +849,22 @@ async function inlinePseudoElements(source, clone, styleMap, styleCache, compres
         } else if (!isIconFont2 && cleanContent && cleanContent !== "none") {
           pseudoEl.textContent = cleanContent;
         }
-        if (hasBg && bg) {
-          const rawUrl = extractURL(bg);
-          if (rawUrl) {
-            try {
-              const dataUrl = await fetchImage(encodeURI(rawUrl));
-              pseudoEl.style.backgroundImage = `url(${dataUrl})`;
-            } catch (e) {
-              console.warn(`[snapdom] Failed to inline background-image for ${pseudo}`, e);
-            }
+        if (hasBg) {
+          try {
+            const bgSplits = splitBackgroundImage(bg);
+            const newBgParts = await Promise.all(
+              bgSplits.map((entry) => inlineSingleBackgroundEntry(entry))
+            );
+            pseudoEl.style.backgroundImage = newBgParts.join(", ");
+          } catch (e) {
+            console.warn(`[snapdom] Failed to inline background-image for ${pseudo}`, e);
           }
         }
+        if (hasBgColor) pseudoEl.style.backgroundColor = bgColor;
         const hasContent2 = pseudoEl.childNodes.length > 0 || pseudoEl.textContent && pseudoEl.textContent.trim() !== "";
-        if (!hasContent2 && !hasBg) continue;
-        if (pseudo === "::before") {
-          clone.insertBefore(pseudoEl, clone.firstChild);
-        } else {
-          clone.appendChild(pseudoEl);
-        }
+        const hasVisibleBox = hasContent2 || hasBg || hasBgColor;
+        if (!hasVisibleBox) continue;
+        pseudo === "::before" ? clone.insertBefore(pseudoEl, clone.firstChild) : clone.appendChild(pseudoEl);
       }
     } catch (e) {
       console.warn(`[snapdom] Failed to capture ${pseudo} for`, source, e);
@@ -608,28 +879,64 @@ async function inlinePseudoElements(source, clone, styleMap, styleCache, compres
       styleMap,
       styleCache,
       compress,
-      embedFonts
+      embedFonts,
+      useProxy
     );
   }
 }
 
+// src/modules/svgDefs.js
+function inlineExternalDef(root) {
+  if (!root) return;
+  const defsSources = document.querySelectorAll("svg > defs");
+  if (!defsSources.length) return;
+  root.querySelectorAll("svg").forEach((svg) => {
+    const uses = svg.querySelectorAll("use");
+    if (!uses.length) return;
+    const usedIds = /* @__PURE__ */ new Set();
+    uses.forEach((use) => {
+      const href = use.getAttribute("xlink:href") || use.getAttribute("href");
+      if (href && href.startsWith("#")) usedIds.add(href.slice(1));
+    });
+    if (!usedIds.size) return;
+    const defs = document.createElementNS("http://www.w3.org/2000/svg", "defs");
+    for (const id of usedIds) {
+      for (const source of defsSources) {
+        const def = source.querySelector(`#${CSS.escape(id)}`);
+        if (def) {
+          defs.appendChild(def.cloneNode(true));
+          break;
+        }
+      }
+    }
+    if (defs.childNodes.length) {
+      svg.insertBefore(defs, svg.firstChild);
+    }
+  });
+}
+
 // src/core/prepare.js
-async function prepareClone(element, compress = false, embedFonts = false) {
+async function prepareClone(element, compress = false, embedFonts = false, options = {}) {
   const styleMap = /* @__PURE__ */ new Map();
   const styleCache = /* @__PURE__ */ new WeakMap();
   const nodeMap = /* @__PURE__ */ new Map();
   let clone;
   try {
-    clone = deepClone(element, styleMap, styleCache, nodeMap, compress);
+    clone = deepClone(element, styleMap, styleCache, nodeMap, compress, options, element);
   } catch (e) {
     console.warn("deepClone failed:", e);
     throw e;
   }
   try {
-    await inlinePseudoElements(element, clone, styleMap, styleCache, compress, embedFonts);
+    await inlinePseudoElements(element, clone, styleMap, styleCache, compress, embedFonts, options.useProxy);
   } catch (e) {
     console.warn("inlinePseudoElements failed:", e);
   }
+  try {
+    inlineExternalDef(clone);
+  } catch (e) {
+    console.warn("inlineExternalDef failed:", e);
+  }
   let classCSS = "";
   if (compress) {
     const keyToClass = generateCSSClasses(styleMap);
@@ -667,6 +974,27 @@ async function prepareClone(element, compress = false, embedFonts = false) {
       cloneNode.appendChild(inner);
     }
   }
+  if (element === nodeMap.get(clone)) {
+    const computed = styleCache.get(element) || window.getComputedStyle(element);
+    styleCache.set(element, computed);
+    const transform = stripTranslate(computed.transform);
+    clone.style.margin = "0";
+    clone.style.position = "static";
+    clone.style.top = "auto";
+    clone.style.left = "auto";
+    clone.style.right = "auto";
+    clone.style.bottom = "auto";
+    clone.style.zIndex = "auto";
+    clone.style.float = "none";
+    clone.style.clear = "none";
+    clone.style.transform = transform || "";
+  }
+  for (const [cloneNode, originalNode] of nodeMap.entries()) {
+    if (originalNode.tagName === "PRE") {
+      cloneNode.style.marginTop = "0";
+      cloneNode.style.marginBlockStart = "0";
+    }
+  }
   return { clone, classCSS, styleCache };
 }
 
@@ -676,8 +1004,7 @@ async function inlineImages(clone, options = {}) {
   const processImg = async (img) => {
     const src = img.src;
     try {
-      const crossOrigin = options.crossOrigin ? options.crossOrigin(src) : "anonymous";
-      const dataUrl = await fetchImage(src, 3e3, crossOrigin);
+      const dataUrl = await fetchImage(src, { useProxy: options.useProxy });
       img.src = dataUrl;
       if (!img.width) img.width = img.naturalWidth || 100;
       if (!img.height) img.height = img.naturalHeight || 100;
@@ -702,28 +1029,24 @@ async function inlineBackgroundImages(source, clone, styleCache, options = {}) {
     const style = styleCache.get(srcNode) || getStyle(srcNode);
     if (!styleCache.has(srcNode)) styleCache.set(srcNode, style);
     const bg = style.getPropertyValue("background-image");
-    const bgSplits = bg.split(",");
-    for (let i = 0; i < bgSplits.length; i++) {
-      const rawUrl = extractURL(bgSplits[i]);
-      if (rawUrl) {
-        try {
-          let bgUrl = encodeURI(rawUrl);
-          let dataUrl;
-          if (bgCache.has(bgUrl)) {
-            dataUrl = bgCache.get(bgUrl);
-          } else {
-            const crossOrigin = options.crossOrigin ? options.crossOrigin(bgUrl) : "anonymous";
-            dataUrl = await fetchImage(bgUrl, 3e3, crossOrigin);
-            bgCache.set(bgUrl, dataUrl);
-          }
-          bgSplits[i] = `url(${dataUrl})`;
-        } catch {
-          bgSplits[i] = "none";
-        }
+    const bgColor = style.getPropertyValue("background-color");
+    if (!bg || bg === "none") {
+      const sChildren2 = Array.from(srcNode.children);
+      const cChildren2 = Array.from(cloneNode.children);
+      for (let i = 0; i < Math.min(sChildren2.length, cChildren2.length); i++) {
+        queue.push([sChildren2[i], cChildren2[i]]);
       }
+      continue;
     }
-    if (bgSplits.some((s) => s.includes("url("))) {
-      cloneNode.style.backgroundImage = bgSplits.join(",");
+    const bgSplits = splitBackgroundImage(bg);
+    const newBgParts = await Promise.all(
+      bgSplits.map((entry) => inlineSingleBackgroundEntry(entry, options))
+    );
+    if (newBgParts.some((p) => p && p !== "none" && !/^url\(undefined\)/.test(p))) {
+      cloneNode.style.backgroundImage = newBgParts.join(", ");
+    }
+    if (bgColor && bgColor !== "transparent" && bgColor !== "rgba(0, 0, 0, 0)") {
+      cloneNode.style.backgroundColor = bgColor;
     }
     const sChildren = Array.from(srcNode.children);
     const cChildren = Array.from(cloneNode.children);
@@ -736,13 +1059,13 @@ async function inlineBackgroundImages(source, clone, styleCache, options = {}) {
 // src/core/capture.js
 async function captureDOM(element, options = {}) {
   if (!element) throw new Error("Element cannot be null or undefined");
-  const { compress = true, embedFonts = false, fast = true, scale = 1 } = options;
+  const { compress = true, embedFonts = false, fast = true, scale = 1, useProxy = "" } = options;
   let clone, classCSS, styleCache;
   let fontsCSS = "";
   let baseCSS = "";
   let dataURL;
   let svgString;
-  ({ clone, classCSS, styleCache } = await prepareClone(element, compress, embedFonts));
+  ({ clone, classCSS, styleCache } = await prepareClone(element, compress, embedFonts, options));
   await new Promise((resolve) => {
     idle(async () => {
       await inlineImages(clone, options);
@@ -758,7 +1081,7 @@ async function captureDOM(element, options = {}) {
   if (embedFonts) {
     await new Promise((resolve) => {
       idle(async () => {
-        fontsCSS = await embedCustomFonts({ ignoreIconFonts: !embedFonts });
+        fontsCSS = await embedCustomFonts();
         resolve();
       }, { fast });
     });
@@ -781,11 +1104,37 @@ async function captureDOM(element, options = {}) {
   await new Promise((resolve) => {
     idle(() => {
       const rect = element.getBoundingClientRect();
-      const w = Math.ceil(rect.width);
-      const h = Math.ceil(rect.height);
+      let w = rect.width;
+      let h = rect.height;
+      const hasW = Number.isFinite(options.width);
+      const hasH = Number.isFinite(options.height);
+      const hasScale = typeof scale === "number" && scale !== 1;
+      if (!hasScale) {
+        const aspect = rect.width / rect.height;
+        if (hasW && hasH) {
+          w = options.width;
+          h = options.height;
+        } else if (hasW) {
+          w = options.width;
+          h = w / aspect;
+        } else if (hasH) {
+          h = options.height;
+          w = h * aspect;
+        }
+      }
+      w = Math.ceil(w);
+      h = Math.ceil(h);
       clone.setAttribute("xmlns", "http://www.w3.org/1999/xhtml");
       clone.style.transformOrigin = "top left";
-      if (scale !== 1 && isSafari()) {
+      if (!hasScale && (hasW || hasH)) {
+        const originalW = rect.width;
+        const originalH = rect.height;
+        const scaleX = w / originalW;
+        const scaleY = h / originalH;
+        const existingTransform = clone.style.transform || "";
+        const scaleTransform = `scale(${scaleX}, ${scaleY})`;
+        clone.style.transform = `${scaleTransform} ${existingTransform}`.trim();
+      } else if (hasScale && isSafari()) {
         clone.style.scale = `${scale}`;
       }
       const svgNS = "http://www.w3.org/2000/svg";
@@ -840,9 +1189,26 @@ async function toCanvas(url, { dpr = 1, scale = 1 } = {}) {
   canvas.style.height = `${height}px`;
   return canvas;
 }
-async function toBlob(url) {
-  const svgText = decodeURIComponent(url.split(",")[1]);
-  return new Blob([svgText], { type: "image/svg+xml" });
+async function toBlob(url, {
+  type = "svg",
+  scale = 1,
+  backgroundColor = "#fff",
+  quality
+} = {}) {
+  const mime = {
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    png: "image/png",
+    webp: "image/webp"
+  }[type] || "image/png";
+  if (type === "svg") {
+    const svgText = decodeURIComponent(url.split(",")[1]);
+    return new Blob([svgText], { type: "image/svg+xml" });
+  }
+  const canvas = await createBackground(url, { dpr: 1, scale }, backgroundColor);
+  return new Promise((resolve) => {
+    canvas.toBlob((blob) => resolve(blob), `${mime}`, quality);
+  });
 }
 async function createBackground(url, { dpr = 1, scale = 1 }, backgroundColor) {
   const baseCanvas = await toCanvas(url, { dpr, scale });
@@ -894,6 +1260,9 @@ async function download(url, { dpr = 1, scale = 1, backgroundColor = "#fff", for
 async function snapdom(element, options = {}) {
   options = { scale: 1, ...options };
   if (!element) throw new Error("Element cannot be null or undefined");
+  if (options.iconFonts) {
+    extendIconFonts(options.iconFonts);
+  }
   return await snapdom.capture(element, options);
 }
 snapdom.capture = async (el, options = {}) => {
@@ -906,7 +1275,7 @@ snapdom.capture = async (el, options = {}) => {
     toRaw: () => url,
     toImg: () => toImg(url, { dpr, scale }),
     toCanvas: () => toCanvas(url, { dpr, scale }),
-    toBlob: () => toBlob(url),
+    toBlob: (options2) => toBlob(url, { dpr, scale, ...options2 }),
     toPng: (options2) => toRasterImg(url, { dpr, scale, ...options2 }, "png"),
     toJpg: (options2) => toRasterImg(url, { dpr, scale, ...options2 }, "jpeg"),
     toWebp: (options2) => toRasterImg(url, { dpr, scale, ...options2 }, "webp"),
@@ -916,7 +1285,7 @@ snapdom.capture = async (el, options = {}) => {
 snapdom.toRaw = async (el, options) => (await snapdom.capture(el, options)).toRaw();
 snapdom.toImg = async (el, options) => (await snapdom.capture(el, options)).toImg();
 snapdom.toCanvas = async (el, options) => (await snapdom.capture(el, options)).toCanvas();
-snapdom.toBlob = async (el, options) => (await snapdom.capture(el, options)).toBlob();
+snapdom.toBlob = async (el, options) => (await snapdom.capture(el, options)).toBlob(options);
 snapdom.toPng = async (el, options) => (await snapdom.capture(el, options)).toPng(options);
 snapdom.toJpg = async (el, options) => (await snapdom.capture(el, options)).toJpg(options);
 snapdom.toWebp = async (el, options) => (await snapdom.capture(el, options)).toWebp(options);
@@ -933,13 +1302,12 @@ snapdom.download = async (el, options = {}) => {
 
 // src/api/preCache.js
 async function preCache(root = document, options = {}) {
-  const { embedFonts = true, reset = false, crossOrigin: crossOriginFn } = options;
+  const { embedFonts = true, reset = false } = options;
   if (reset) {
     imageCache.clear();
     bgCache.clear();
     resourceCache.clear();
     baseCSSCache.clear();
-    computedStyleCache.clear();
     return;
   }
   await document.fonts.ready;
@@ -953,26 +1321,29 @@ async function preCache(root = document, options = {}) {
   for (const img of imgEls) {
     const src = img.src;
     if (!imageCache.has(src)) {
-      const crossOrigin = crossOriginFn ? crossOriginFn(src) : "anonymous";
       promises.push(
-        fetchImage(src, 3e3, crossOrigin).then((dataURL) => imageCache.set(src, dataURL)).catch(() => {
+        fetchImage(src, { useProxy: options.useProxy }).then((dataURL) => imageCache.set(src, dataURL)).catch(() => {
         })
       );
     }
   }
   for (const el of allEls) {
-    const bg = getComputedStyle(el).backgroundImage;
-    const url = extractURL(bg);
-    if (url && !bgCache.has(url)) {
-      const crossOrigin = crossOriginFn ? crossOriginFn(url) : "anonymous";
-      promises.push(
-        fetchImage(url, 3e3, crossOrigin).then((dataURL) => bgCache.set(url, dataURL)).catch(() => {
-        })
-      );
+    const bg = getStyle(el).backgroundImage;
+    if (bg && bg !== "none") {
+      const bgSplits = splitBackgroundImage(bg);
+      for (const entry of bgSplits) {
+        const isUrl = entry.startsWith("url(");
+        if (isUrl) {
+          promises.push(
+            inlineSingleBackgroundEntry(entry, options).catch(() => {
+            })
+          );
+        }
+      }
     }
   }
   if (embedFonts) {
-    await embedCustomFonts({ ignoreIconFonts: !embedFonts, preCached: true });
+    await embedCustomFonts({ preCached: true });
   }
   await Promise.all(promises);
 }