html2canvas-pro 2.5.2 → 2.5.4

package/dist/types/core/constants.d.ts

@@ -16,12 +16,23 @@ export declare const DEFAULT_IMAGE_TIMEOUT_MS = 15000;
 export declare const SHADOW_MASK_OFFSET = 10000;
 /** Polling interval (ms) when waiting for the cloned iframe to become ready. */
 export declare const IFRAME_READY_POLL_MS = 50;
+/** Polling interval (ms) when waiting for clone stylesheets to apply. */
+export declare const STYLESHEET_READY_POLL_MS = 50;
 /**
  * Total time (ms) to wait for the cloned iframe document to become ready
  * after its load event. A missed deadline resolves with a warning (the
  * capture continues with a possibly incomplete document).
  */
 export declare const CLONE_READY_TIMEOUT_MS = 30000;
+/**
+ * Total time (ms) to wait for the clone's external stylesheets (link and
+ * @import chains) to apply. Shorter than the document readiness window: a
+ * stylesheet that needs longer usually means a hung CDN, and rendering with
+ * a 10s-old layout beats blocking the capture for 30s. A missed deadline
+ * resolves with a warning (the capture continues with a possibly unstyled
+ * clone).
+ */
+export declare const STYLESHEET_READY_TIMEOUT_MS = 10000;
 /**
  * Hard ceiling (ms) for the cloned iframe's load event itself. If the event
  * never fires, the mount is rejected instead of hanging forever.

package/dist/types/dom/iframe-mount.d.ts

@@ -40,6 +40,31 @@ type TrustedTypePolicyLike = {
  */
 export declare const resolveTrustedTypesPolicy: (ownerWindow: Window | null) => TrustedTypePolicyLike | null;
 export declare const createIFrameContainer: (ownerDocument: Document, bounds: Bounds, customContainer?: HTMLElement | ShadowRoot) => HTMLIFrameElement;
+/**
+ * Wait until every external stylesheet of the clone has been applied or
+ * definitively failed, or the readiness budget expires.
+ *
+ * The clone is mounted by adoptNode() into an already-closed document
+ * (close() must precede adoptNode for Chrome uppercase class-name matching,
+ * see the mount sequence below), so the cloned <link rel="stylesheet">
+ * elements are inserted after the document finished loading: they neither
+ * delay the iframe load event nor change readyState, and the iframeLoader
+ * readiness poll cannot observe them. On a cold cache the first capture
+ * could then measure the clone before its external CSS arrived and render
+ * an unstyled layout (issue #245). Inline <style> clones apply
+ * synchronously and document-level adopted stylesheets are serialised at
+ * clone time, so neither needs this wait.
+ *
+ * Readiness is polled rather than purely event-driven because a <style>
+ * clone serialised from `createStyleClone` re-fetches its external @import
+ * rules without firing link load/error events, and shadow-root links are
+ * equally event-hostile in some engines. The poll covers both; link events
+ * remain as the settle path for plain <link> fetches.
+ * @internal – exported for testing only.
+ */
+export declare const stylesheetsReady: (documentClone: Document, logger?: {
+    warn: (msg: string) => void;
+}, signal?: AbortSignal) => Promise<void>;
 /**
  * Serialise a document type declaration to an HTML string.
  * @internal – exported for testing only, not part of the public API.

package/package.json

@@ -19,7 +19,7 @@
       "default": "./dist/html2canvas-pro.esm.js"
     }
   },
-  "version": "2.5.2",
+  "version": "2.5.4",
   "author": {
     "name": "yorickshan",
     "email": "yorickshan@gmail.com",
@@ -42,43 +42,43 @@
     "@commitlint/cli": "^21.2.3",
     "@commitlint/config-conventional": "^21.2.3",
     "@types/express": "^5.0.6",
-    "@types/node": "^26.6.3",
+    "@types/node": "^26.6.5",
     "@types/pngjs": "^6.0.5",
     "@types/serve-index": "^1.9.4",
-    "@typescript-eslint/eslint-plugin": "^8.70.1",
-    "@typescript-eslint/parser": "^8.70.1",
+    "@typescript-eslint/eslint-plugin": "^8.71.2",
+    "@typescript-eslint/parser": "^8.71.2",
     "@typescript/native": "npm:typescript@^7.0.2",
-    "@vitest/coverage-v8": "^5.0.2",
+    "@vitest/coverage-v8": "^5.0.4",
+    "axios": "^1.20.0",
     "body-parser": "^2.3.0",
     "conventional-changelog": "^8.1.3",
-    "conventional-changelog-conventionalcommits": "^10.4.0",
+    "conventional-changelog-conventionalcommits": "^10.4.1",
     "cors": "^2.8.6",
-    "eslint": "^10.11.0",
+    "eslint": "^10.12.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.6",
-    "express": "^5.2.1",
-    "filenamify-url": "4.0.0",
+    "express": "^5.3.0",
+    "express-rate-limit": "^8.7.1",
     "glob": "^13.0.6",
     "husky": "^9.1.7",
-    "jsdom": "^30.1.1",
+    "jsdom": "^30.1.2",
     "lint-staged": "^17.6.0",
-    "pixelmatch": "^7.2.0",
-    "playwright": "1.63.0",
+    "pixelmatch": "^8.0.0",
+    "playwright": "1.64.0",
     "pngjs": "^7.0.0",
-    "prettier": "^3.9.9",
+    "prettier": "^3.9.10",
     "rimraf": "^6.1.3",
-    "rolldown": "^1.2.11",
+    "rolldown": "^1.2.13",
     "serve-index": "^1.9.2",
     "slash": "5.1.0",
     "tsx": "^4.23.15",
     "typedoc": "^0.28.20",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
-    "vite": "^8.3.1",
-    "vitepress": "^1.6.4",
-    "vitest": "^5.0.2",
+    "vite": "^8.3.4",
+    "vitepress": "^2.0.0-alpha.20",
+    "vitest": "^5.0.4",
     "yargs": "^18.2.0"
   },
-  "dependencies": {},
   "lint-staged": {
     "{src,tests}/**/*.ts": [
       "prettier --write",
@@ -88,7 +88,6 @@
   "scripts": {
     "prebuild": "rimraf dist/ && rimraf build/ && mkdir -p dist && mkdir -p build",
     "build": "tsc -p tsconfig.build.json && rolldown -c rolldown.config.ts && pnpm build:create-reftest-list && node scripts/bundle-filter-surface.mjs",
-    "build:testrunner": "rolldown -c tests/rolldown.testrunner.config.ts",
     "build:reftest-result-list": "tsx scripts/create-reftest-result-list.ts",
     "build:create-reftest-list": "tsx scripts/create-reftest-list.ts tests/reftests/ignore.txt build/reftests.js",
     "release": "sh scripts/version-upgrade.sh",