html2canvas-pro 2.5.3 → 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

@@ -41,7 +41,7 @@ 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 link of the clone has been applied or
+ * 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
@@ -54,6 +54,12 @@ export declare const createIFrameContainer: (ownerDocument: Document, bounds: Bo
  * 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?: {

package/package.json

@@ -19,7 +19,7 @@
       "default": "./dist/html2canvas-pro.esm.js"
     }
   },
-  "version": "2.5.3",
+  "version": "2.5.4",
   "author": {
     "name": "yorickshan",
     "email": "yorickshan@gmail.com",