skia-canvas 0.9.28 → 1.0.0

package/CHANGELOG.md

@@ -1,6 +1,78 @@
 # Changelog
 
-<!-- ## 🥚 ⟩ [Unreleased]  -->
+<!-- ## 🥚 ⟩ [Unreleased] -->
+
+## 📦 ⟩ [v1.0.0] ⟩ Aug 5, 2022
+
+### New Features
+- The new [Window][window] class can display a **Canvas** on screen, respond to mouse and keyboard input, and fluidly [animate][window_anim] by calling user-defined [event handlers][window_events].
+- Bitmap rendering now occurs on the GPU by default and can be configured using the **Canvas**'s [`.gpu`][canvas_gpu] property. If the platform supports hardware-accelerated rendering (using Metal on macOS and Vulkan on Linux & Windows), the property will be `true` by default and can be set to `false` to use the software renderer.
+- Added support for recent Chrome features:
+  - the [`reset()`][chrome_reset] context method which erases the canvas, resets the transformation state, and clears the current path
+  - the [`roundRect()`][chrome_rrect] method on contexts and **Path2D** objects which adds a rounded rectangle using 1–4 corner radii (provided as a single value or an array of numbers and/or **DOMPoint** objects)
+
+### Bugfixes
+- The `FontLibrary.reset()` method didn't actually remove previously installed fonts that had already been drawn with (and thus cached). It now clears those caches, which also means previously used fonts can now be replaced by calling `.use()` again with the same family name.
+- The [`.drawCanvas()`][drawCanvas] routine now applies filter effects and shadows consistent with the current resolution and transformation state.
+
+### Misc. Improvements
+- The [`.filter`][filter] property's `"blur(…)"` and `"drop-shadow(…)"` effects now match browser behavior much more closely and scale appropriately with the `density` export option.
+- Antialiasing is smoother, particularly when down-scaling images, thanks to the use of mipmaps rather than Skia's (apparently buggy?) implementation of bucubic interpolation.
+- Calling `clearRect()` with dimensions that fully enclose the canvas will now discard all the vector objects that have been drawn so far (rather than simply covering them up).
+- Upgraded Skia to milestone 103
+
+[window]: https://github.com/samizdatco/skia-canvas#window
+[window_anim]: https://github.com/samizdatco/skia-canvas#events--animation
+[window_events]: https://github.com/samizdatco/skia-canvas#on--off--once
+[canvas_gpu]: https://github.com/samizdatco/skia-canvas#gpu
+[filter]: https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/filter
+[chrome_reset]: https://developer.chrome.com/blog/canvas2d/#context-reset
+[chrome_rrect]: https://developer.chrome.com/blog/canvas2d/#round-rect
+
+## 📦 ⟩ [v0.9.30] ⟩ Jun 7, 2022
+
+### New Features
+- Enhacements to the shared **FontLibrary** object:
+  - Added a [`reset()`][FontLibrary.reset] method to FontLibrary which uninstalls any fonts that had been dynamically installed via `FontLibrary.use()`
+  - The [`use()`][FontLibrary.use] method now checks for previously installed fonts with the same family name (or alias) and will replace them with the newly added font
+- Added pre-compiled binaries for Alpine Linux on arm64
+
+### Bugfixes
+- Calling `clip` with an empty path (or one that does not intersect the current clipping mask) will now prevent drawing altogether
+- Transformation (`translate`, `rotate`, etc.) and line-drawing methods (`moveTo`, `lineTo`, `ellipse`, etc.) are now silently ignored if called with `NaN`, `Infinity`, or non-**Number** values in the arguments rather than throwing an error
+  - applies to both the Context and Path2D versions of the drawing methods
+  - a **TypeError** is thrown only if the number of arguments is too low (mirroring browser behavior)
+- [`conicCurveTo()`][conicCurveTo] now correctly reflects the canvas's transform state
+- The browser-based version of [`loadImage()`][loadImage] now returns a **Promise** that correctly resolves to an **Image** object
+- SVG exports no longer have an invisible, canvas-sized `<rect/>` as their first element
+- Fixed an incompatibility on Alpine between the version of libstdc++ present on the `node:alpine` docker images and the version used when building the precompiled binaries
+
+### Misc. Improvements
+- Upgraded Skia to milestone 101
+
+[conicCurveTo]: https://github.com/samizdatco/skia-canvas#coniccurvetocpx-cpy-x-y-weight
+[FontLibrary.reset]: https://github.com/samizdatco/skia-canvas#reset
+[FontLibrary.use]: https://github.com/samizdatco/skia-canvas#usefamilyname-fontpaths
+[loadImage]: https://github.com/samizdatco/skia-canvas/#loadimage
+
+## 📦 ⟩ [v0.9.29] ⟩ Feb 7, 2022
+
+### New Features
+- PDF exports now support the optional [`matte`][matte] argument.
+
+### Breaking Changes
+- When the [`drawImage()`][mdn_drawImage] function is passed a **Canvas** object as its image source it will now rasterize the canvas before drawing. The prior behavior (in which it is drawn as a vector graphic) can now be accessed through the new [`drawCanvas()`][drawCanvas] method which supports the same numerical arguments as `drawImage` but requires that its first argument be a **Canvas**.
+
+### Bugfixes
+- Regions erased using [`clearRect()`][mdn_clearRect] are now properly antialiased
+- The [`clip()`][mdn_clip] method now interprets the current translate/scale/rotate state correctly when combining clipping masks
+
+### Misc. Improvements
+- Upgraded Skia to milestone 97
+
+[drawCanvas]: https://github.com/samizdatco/skia-canvas#drawcanvascanvas-x-y-
+[mdn_clip]: https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/clip
+[mdn_clearRect]: https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/clearRect
 
 ## 📦 ⟩ [v0.9.28] ⟩ Jan 12, 2022
 
@@ -10,7 +82,7 @@
 - Colors can now use the [hwb()](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/hwb()) model
 
 ### Breaking Changes
-- The **Canvas** [`.async`](https://github.com/samizdatco/skia-canvas#async) property has been **deprecated** and will be removed in a future release. 
+- The **Canvas** [`.async`](https://github.com/samizdatco/skia-canvas#async) property has been **deprecated** and will be removed in a future release.
   - The `saveAs`, `toBuffer`, and `toDataURL` methods will now be async-only (likewise the [shorthand properties](https://github.com/samizdatco/skia-canvas#pdf-svg-jpg-and-png)).
   - Use their synchronous counterparts (`saveAsSync`, `toBufferSync`, and `toDataURLSync`) if you want to block execution while exporting images.
 - The [ImageData](https://developer.mozilla.org/en-US/docs/Web/API/ImageData/ImageData) constructor now orders its arguments properly: the optional buffer/array argument now comes first
@@ -29,7 +101,7 @@
 
 
 ## 📦 ⟩ [v0.9.27] ⟩ Oct 23, 2021
- 
+
 ### New Features
 - Added pre-compiled binaries for Alpine Linux using the [musl](https://musl.libc.org) C library
 
@@ -41,7 +113,7 @@
 
 ### Bugfixes
 - Windows text rendering has been restored after failing due to changes involving the `icudtl.dat` file
-- `FontLibrary.use` now reports an error if the specified font file doesn't exist 
+- `FontLibrary.use` now reports an error if the specified font file doesn't exist
 - Fixed a crash that could result from calling `measureText` with various unicode escapes
 
 ### Misc. Improvements
@@ -52,7 +124,7 @@
 ## 📦 ⟩ [v0.9.25] ⟩ Aug 22, 2021
 
 ### Bugfixes
-- Improved image scaling when a larger image is being shrunk down to a smaller size via [`drawImage()`](https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/drawImage)
+- Improved image scaling when a larger image is being shrunk down to a smaller size via [`drawImage()`][mdn_drawImage]
 - modified [`imageSmoothingQuality`](https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/imageSmoothingQuality) settings to provide a more meaningful range across `low`, `medium`, and `high`
 - [`measureText()`](https://github.com/samizdatco/skia-canvas#measuretextstr-width) now returns correct metrics regardless of current `textAlign` setting
 - Rolled back `icudtl.dat` changes on Windows (which suppressed the misleading warning message but required running as Administrator)
@@ -60,6 +132,7 @@
 ### Misc. Improvements
 - Now using [Neon](https://github.com/neon-bindings/neon) v0.9 (with enhanced async event scheduling)
 
+[mdn_drawImage]: https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/drawImage
 
 ## 📦 ⟩ [v0.9.24] ⟩ Aug 18, 2021
 
@@ -106,7 +179,7 @@
 ### Misc. Improvements
 
 - The `newPage()` and `saveAs()` methods now work in the browser, including the ability to save image sequences to a zip archive. The browser’s canvas is still doing all the drawing however, so file export formats will be limited to PNG and JPEG and none of the other Skia-specific extensions will be available.
-- The file-export methods now accept a [`matte`][matte] value in their options object which can be used to set the background color for any portions of the canvas that were left semi-transparent 
+- The file-export methods now accept a [`matte`][matte] value in their options object which can be used to set the background color for any portions of the canvas that were left semi-transparent
 - Canvas dimensions are no longer rounded-off to integer values (at least until a bitmap needs to be generated for export)
 - Linux builds will now run on some older systems going back to glibc 2.24
 
@@ -133,7 +206,7 @@
 ### New Features
 
 - Rasterization and file i/o are now handled asynchronously in a background thread. See the discussion of Canvas’s new [`async`](https://github.com/samizdatco/skia-canvas#async) property for details.
-- Output files can now be generated at pixel-ratios > 1 for High-DPI screens. `SaveAs` and the other canvas output functions all accept an optional [`density`](https://github.com/samizdatco/skia-canvas#density) argument which is an integer ≥1 and will upscale the image accordingly. The density can also be passed using the `filename` argument by ending the name with an ‘@’ suffix like `some-image@2x.png`. 
+- Output files can now be generated at pixel-ratios > 1 for High-DPI screens. `SaveAs` and the other canvas output functions all accept an optional [`density`](https://github.com/samizdatco/skia-canvas#density) argument which is an integer ≥1 and will upscale the image accordingly. The density can also be passed using the `filename` argument by ending the name with an ‘@’ suffix like `some-image@2x.png`.
 - SVG exports can optionally convert text to paths by setting the [`outline`](https://github.com/samizdatco/skia-canvas#outline) argument to `true`.
 
 ### Breaking Changes
@@ -182,7 +255,10 @@
 
 **Initial public release** 🎉
 
-[unreleased]: https://github.com/samizdatco/skia-canvas/compare/v0.9.28...HEAD
+[unreleased]: https://github.com/samizdatco/skia-canvas/compare/v1.0.0...HEAD
+[v1.0.0]: https://github.com/samizdatco/skia-canvas/compare/v0.9.30...v1.0.0
+[v0.9.30]: https://github.com/samizdatco/skia-canvas/compare/v0.9.29...v0.9.30
+[v0.9.29]: https://github.com/samizdatco/skia-canvas/compare/v0.9.28...v0.9.29
 [v0.9.28]: https://github.com/samizdatco/skia-canvas/compare/v0.9.27...v0.9.28
 [v0.9.27]: https://github.com/samizdatco/skia-canvas/compare/v0.9.26...v0.9.27
 [v0.9.26]: https://github.com/samizdatco/skia-canvas/compare/v0.9.25...v0.9.26