html2canvas-pro 2.5.0 → 2.5.2

package/README.md

@@ -27,7 +27,7 @@ Next generation JavaScript screenshot tool.
 html2canvas-pro is a fork of [niklasvh/html2canvas](https://github.com/niklasvh/html2canvas) that includes various fixes and new features. It offers several advantages over the original html2canvas:
 
 **Modern CSS support**
-- Color functions `color()` (incl. relative colors), `lab()`, `lch()`, `oklab()`, `oklch()`
+- Color functions `color()` (incl. relative colors), `lab()`, `lch()`, `oklab()`, `oklch()` — other functions resolve through the browser's computed styles
 - `background-clip: text` support
 - `mix-blend-mode` and `background-blend-mode` support
 - `object-fit` support for `<img/>`
@@ -35,7 +35,7 @@ html2canvas-pro is a fork of [niklasvh/html2canvas](https://github.com/niklasvh/
 - CSS `writing-mode` support (horizontal-tb, vertical-rl, vertical-lr)
 - `mask-image` alpha masks with position/size/repeat (see [mask support](docs/features.md#mask-support))
 - `backdrop-filter: blur()` for frosted-glass captures (see [backdrop-filter support](docs/features.md#backdrop-filter-support))
-- `conic-gradient()` and `repeating-radial-gradient()` — complete gradient family
+- `conic-gradient()`, `repeating-conic-gradient()` and `repeating-radial-gradient()` — complete gradient family
 - `text-emphasis` (CJK emphasis marks), `-webkit-box-reflect`, `image-set()`, `border-image-outset` / `border-image-width`
 - `accent-color`, `outline`, `-webkit-text-fill-color`, `isolation`
 - `filter` compositing for eligible layers — `blur()` / `drop-shadow()` rendered on a dedicated surface with correct layer `opacity` (see [filter support notes](docs/filter-support.md))
@@ -55,6 +55,16 @@ html2canvas-pro is a fork of [niklasvh/html2canvas](https://github.com/niklasvh/
 - LRU caches for CSS parsing and gradient patterns
 - Native canvas filter fast path with verified SVG fallback
 
+**Render speed** — html2canvas-pro(latest) vs html2canvas 1.4.1, headless Chromium on Apple M4, `scale: 1`, median of 10 interleaved runs ([benchmark script](scripts/benchmarks/render.bench.mjs), reproduce with `corepack pnpm bench:render`):
+
+| Fixture | html2canvas-pro | html2canvas 1.4.1 |
+| --- | --- | --- |
+| Simple document (~40 elements) | **80 ms** | 87 ms |
+| Large document (~1200 elements) | **295 ms** | 468 ms |
+| Modern-CSS page (`oklch()`, `conic-gradient()`, …) | **166 ms** | ✗ cannot render (throws on `oklch()`) |
+
+On element-heavy pages html2canvas-pro is ~1.6× faster, and it is the only one of the two that can render modern-CSS content at all. Absolute times vary by machine — compare ratios, not milliseconds.
+
 If you found this helpful, don't forget to
 leave a star 🌟.
 
@@ -153,6 +163,8 @@ The package exports `html2canvas` (default), plus the following named exports:
 | `Validator` / `createDefaultValidator` | Input validation (URLs, proxy allow-list, element checks) |
 | `PerformanceMonitor` | Phase-level timing metrics |
 | `Options` | The full options type |
+| `ConfigOptions` | Per-call runtime config type (CSP nonce, shared cache) |
+| `ValidationResult` | Result type returned by the `Validator` API |
 
 Full type definitions ship with the package — your editor's IntelliSense covers every option. An HTML API reference can be generated locally with `corepack pnpm docs:api` (TypeDoc).