skia-canvas 1.0.2 → 2.0.0

package/CHANGELOG.md

@@ -2,6 +2,111 @@
 
 <!-- ## 🥚 ⟩ [Unreleased] -->
 
+## 📦 ⟩ [v2.0.0] ⟩ Dec 2, 2024
+
+### New Features
+
+#### Website
+- Documentation is now hosted at [skia-canvas.org](https://skia-canvas.org). Go there for a more readable version of all the details that used to be wedged into the README file.
+
+#### Imagery
+- Added initial SVG rendering support. **Image**s can now load SVG files and can be drawn in a resolution-independent manner via [`drawImage()`][mdn_drawImage] (thanks to @mpaperno #180). Note that **Image**s loaded from SVG files that don't have a `width` and `height` set on their root `<svg>` element have some quirks as of this release:
+  - The **Image** object's `height` will report being `150` and the `width` will be set to accurately capture the image's aspect ratio
+  - When passed to `drawImage()` without size arguments, the SVG will be scaled to a size that fits within the **Canvas**'s current bounds (using an approach akin to CSS's `object-fit: contain`).
+  - When using the 9-argument version of `drawImage()`, the ‘crop’ arguments (`sx`, `sy`, `sWidth`, & `sHeight`) will correspond to this scaled-to-fit size, *not* the **Image**'s reported `width` & `height`.
+- WEBP support
+  - **Canvas**.[saveAs()][Canvas.saveAs] & [toBuffer()][Canvas.toBuffer] can now generate WEBP images and **Image**s can load WEBP files as well (contributed by @mpaperno #177, h/t @revam for the initial work on this)
+- Raw pixel data support
+  - The `toBuffer()` and `saveAs()` methods now support `"raw"` as a format name and/or file extension, causing them to return non-encoded pixel data (by default in an `"rgba"` layout like a standard [ImageData][ImageData] buffer)
+  - Both functions now take an optional [`colorType`][colorType] argument to specify alternative pixel data layouts (e.g., `"rgb"` or `"bgra"`)
+- [**ImageData**][ImageData] enhancements
+  - The [drawImage()][mdn_drawImage] and [createPattern()][mdn_createPattern] methods have been extended to accept **ImageData** objects as arguments. Previously only [putImageData()][mdn_putImageData] could be used for rendering, but this method ignores the context's current transform, filters, opacity, etc.
+  - When creating an **ImageData** via the [getImageData()][mdn_getImageData] & [createImageData()][mdn_createImageData] methods or `new ImageData()` constructor, the optional settings arg now allows you to select the `colorType` for the buffer's pixels.
+
+#### Typography
+- **FontLibrary.**[use()][FontLibrary.use] now supports dynamically loaded [WOFF & WOFF2][woff_wiki] fonts
+- The [`outlineText()`][outline_text] method now takes an optional `width` argument and supports all the context's typographic settings (e.g., `.font`, `.fontVariant`, `.textWrap`, `.textTracking`, etc.)
+- Fonts with condensed/expanded widths can now be selected with the [`.fontStretch`][fontStretch] property. Note that stretch values included in the `.font` string will overwrite the current `.fontStretch` setting (or will reset it to `normal` if omitted).
+- Generic font family names are now mapped to fonts installed on the system. The `serif`, `sans-serif`, `monospace`, and `system-ui` families are currently supported.
+- Underlines, overlines, and strike-throughs can now be set via the **Context**'s `.textDecoration` property.
+- Text spacing can now be fine-tuned using the [`.letterSpacing`][letterSpacing] and [`.wordSpacing`][wordSpacing] properties.
+
+#### GUI
+- The [**Window**][window] class now has a [`resizable`][resizable] property which can be set to `false` to prevent the window from being manually resized or maximized (contributed by @nornagon #124).
+- **Window** [event handlers][win_bind] now support Input Method Editor events for entering composed characters via the [compositionstart][compositionstart], [compositionupdate][compositionupdate], & [compositionend][compositionend] events. The [`input`][input] event now reports the composed character, not the individual keystrokes.
+
+#### Rendering
+- The **Canvas** object has a new `engine` property which describes whether the CPU or GPU is being used, which graphics device was selected, and what (if any) error prevented it from being initialized.
+- The `.transform` and `.setTransform` methods on **Context**, **Path2D**, and **CanvasPattern** objects can now take their arguments in additional formats. They can now be passed a [**DOMMatrix**][DOMMatrix] object or a string with a list of transformation operations compatible with the [CSS `transform`][css_transform] property. The **DOMMatrix** constructor also supports these strings as well as plain, matrix-like objects with numeric attributes named `a`, `b`, `c`, `d`, `e`, & `f` (contributed by @mpaperno #178).
+- The number of background threads used for asynchronous exports can now be controlled with the [`SKIA_CANVAS_THREADS`][multithreading] environment variable
+
+### Breaking Changes
+- An upgrade to [Neon][neon_rs] with [N-API v8][node_napi] raised the minimum required Node version to 12.22+, 14.17+, or 16+.
+- Images now load asynchronously in cases where the `src` property has been set to a local path. As a result, it's now necessary to `await img.decode()` or set up an `.on("load", …)` handler before drawing it—even when the `src` is non-remote.
+- The **KeyboardEvent** object returned by the `keyup`/`keydown` and `input` event listeners now has fields and values consistent with browser behavior. In particular, `code` is now a name (e.g., `ShiftLeft` or `KeyS`) rather than a numeric scancode, `key` is a straightforward label for the key (e.g., `Shift` or `s`) and the new [`location`][key_location] field provides a numeric description of which variant of a key was pressed.
+- The deprecated `.async` property has been removed. See the [v0.9.28](#--v0928--jan-12-2022) release notes for details.
+- The non-standard `.textTracking` property has been removed in favor of the new [`.letterSpacing`][letterSpacing] property
+
+### Bugfixes
+- Initializing a GPU-renderer using Vulkan now uses the [`vulkano`](https://crates.io/crates/vulkano) crate and makes better selections among devices present (previously it was just using the first result, which is not always optimal).
+- The **Image**.onload callback now properly sets `this` to point to the new image (contributed by @mpaperno & @ForkKILLET).
+- Creating a **Window** with `fullscreen` set to `true` now takes effect immediately (previously it was failing silently)
+- Drawing paths after setting an invalid transform no longer crashes (contributed by @mpaperno #175)
+- Windows with `.on("draw")` handlers no longer [become unresponsive](https://github.com/gfx-rs/gfx/issues/2460) on macOS 14+ after being fully occluded by other windows
+- Ellipses with certain combinations of positive and negative start- and stop-angles now render correctly—previously they would not appear at all if the total sweep exceeded 360° (contributed by @mpaperno #176)
+- The `drawCanvas()` method now clips to the specified crop size (contributed by @mpaperno #179)
+- Hit-testing with [`isPointInPath`][isPointInPath()] and [`isPointInStroke`][isPointInStroke()] now works correctly when called with a **Path2D** object as the first argument
+
+### Misc. Improvements
+- Upgraded Skia to [milestone 131](https://github.com/rust-skia/rust-skia/releases/tag/0.80.0)
+- Added TypeScript definitions for the **Window** object’s event types (contributed by @saantonandre #163) and the `roundRect` method (contributed by @sandy85625 & @santilema)
+- Performance improvements to **FontLibrary**, speeding up operations like listing families and adding new typefaces.
+- Updated `winit` and replaced the end-of-life’d [skulpin](https://github.com/aclysma/skulpin)-based Vulkan renderer with a new implementation using Vulkano for window-drawing on Windows and Linux.
+  > It’s a fairly direct adaptation of Vulkano [sample code][vulkano_demo] for device setup with skia-specific rendering routines inspired by [@pragmatrix](https://github.com/pragmatrix)’s renderer for [emergent][pragmatrix_emergent]. All of which is to say, if you understand this better than I do I'd love some suggestions for improving the rendering setup.
+- The GPU is now initialized only when it is needed, not at startup. As a result, setting that **Canvas**'s [`.gpu`][canvas_gpu] property to `false` immediately after creation will prevent any GPU-related resource acquisition from occurring (though rendering speed will be predictably slower).
+- The sample-count used by the GPU for multiscale antialiasing can now be configured through the optional [`msaa`][msaa] export argument. If omitted, defaults to 4x MSAA.
+- Added support for non-default imports (e.g., `import {Image} from "skia-canvas"`) when used as an ES Module.
+- The [getImageData()][mdn_getImageData] method now makes use of the GPU (if enabled) and caches data between calls, greatly improving performance for sequential queries
+
+[resizable]: /docs/api/window.md#resizable
+[key_location]: https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/location
+[vulkano_demo]: https://github.com/vulkano-rs/vulkano/blob/master/examples/triangle/main.rs
+[pragmatrix_emergent]: https://github.com/pragmatrix/emergent/blob/master/src/skia_renderer.rs
+[woff_wiki]: https://en.wikipedia.org/wiki/Web_Open_Font_Format
+[css_transform]: https://developer.mozilla.org/en-US/docs/Web/CSS/transform
+[DOMMatrix]: https://developer.mozilla.org/en-US/docs/Web/API/DOMMatrix
+[FontLibrary.use]: /docs/api/font-library.md#use
+[Canvas.saveAs]: /docs/api/canvas.md#saveas
+[Canvas.toBuffer]: /docs/api/canvas.md#tobuffer
+[letterSpacing]: https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/letterSpacing
+[wordSpacing]: https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/wordSpacing
+[fontStretch]: https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/fontStretch
+[isPointInPath()]: https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/isPointInPath
+[isPointInStroke()]: https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/isPointInStroke
+[node_napi]: https://nodejs.org/api/n-api.html#node-api-version-matrix
+[neon_rs]: https://neon-rs.dev
+[msaa]: /docs/api/canvas.md#msaa
+[multithreading]: /docs/getting-started.md#multithreading
+[compositionstart]: https://developer.mozilla.org/en-US/docs/Web/API/Element/compositionstart_event
+[compositionupdate]: https://developer.mozilla.org/en-US/docs/Web/API/Element/compositionupdate_event
+[compositionend]: https://developer.mozilla.org/en-US/docs/Web/API/Element/compositionend_event
+[input]: https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/input_event
+[win_bind]: /docs/api/window.md#on--off--once
+[ImageData]: /docs/api/imagedata.md
+[colorType]: /docs/api/imagedata.md#colortype
+[mdn_createPattern]: https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/createPattern
+[mdn_getImageData]: https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/getImageData
+[mdn_createImageData]: https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/createImageData
+[mdn_putImageData]: https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/putImageData
+
+## 📦 ⟩ [v1.0.2] ⟩ Aug 21, 2024
+
+### Maintenance
+- After getting a surprise bill from Amazon for the S3 bucket hosting the pre-compiled binaries, I've moved them to GitHub Releases instead. Aside from resolving some security warnings by upgrading dependencies, this version *should* be functionally identical to 1.0.1…
+
+### Breaking Changes
+- The 32-bit ARM-based linux builds are no longer provided pre-compiled; you'll now need to build from source.
+
 ## 📦 ⟩ [v1.0.1] ⟩ Oct 15, 2022
 
 ### Bugfixes
@@ -30,10 +135,10 @@
 - 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
+[window]: /docs/api/window.md
+[window_anim]: /docs/api/window.md#events-for-animation
+[window_events]: /docs/api/window.md#on--off--once
+[canvas_gpu]: /docs/api/canvas.md#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
@@ -52,17 +157,15 @@
   - 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
+- 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
+[conicCurveTo]: /docs/api/context.md#coniccurveto
+[FontLibrary.reset]: /docs/api/font-library.md#reset
 
 ## 📦 ⟩ [v0.9.29] ⟩ Feb 7, 2022
 
@@ -79,7 +182,7 @@
 ### Misc. Improvements
 - Upgraded Skia to milestone 97
 
-[drawCanvas]: https://github.com/samizdatco/skia-canvas#drawcanvascanvas-x-y-
+[drawCanvas]: /docs/api/context.md#drawcanvas
 [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
 
@@ -87,12 +190,12 @@
 
 ### New Features
 - Added TypeScript definitions for extensions to the DOM spec (contributed by [@cprecioso](https://github.com/cprecioso))
-- Added 3D-perspective transformations via the new [createProjection()](https://github.com/samizdatco/skia-canvas#createprojectionquad-basis) context method
+- Added 3D-perspective transformations via the new [createProjection()][createProjection()] context method
 - 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 `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)).
+- The **Canvas** [`.async`][async_depr] 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][shorthands]).
   - 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
 
@@ -109,6 +212,10 @@
 - Added workflow for creating docker build environments
 
 
+[createProjection()]: /docs/api/context.md#createprojection
+[shorthands]: /docs/api/canvas.md#pdf-png-svg-jpg--webp
+[async_depr]: https://github.com/samizdatco/skia-canvas/tree/v0.9.28#async
+
 ## 📦 ⟩ [v0.9.27] ⟩ Oct 23, 2021
 
 ### New Features
@@ -135,22 +242,29 @@
 ### Bugfixes
 - 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
+- [`measureText()`][measureText()] 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)
 
 ### 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
+[measureText()]: /docs/api/context.md#measuretext
 
 ## 📦 ⟩ [v0.9.24] ⟩ Aug 18, 2021
 
 ### New Features
-- **Path2D** objects now have a read/write [`d`](https://github.com/samizdatco/skia-canvas/#d) property with an [SVG representation](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/d#path_commands) of the path’s contours and an [`unwind()`](https://github.com/samizdatco/skia-canvas/#unwind) method for converting from even-odd to non-zero winding rules
-- The [`createTexture()`](https://github.com/samizdatco/skia-canvas#createtexturespacing-path-line-color-angle-offset0) context method returns **CanvasTexture** objects which can be assigned to `fillStyle` or `strokeStyle`
+- **Path2D** objects now have a read/write [`d`][p2d_d] property with an [SVG representation](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/d#path_commands) of the path’s contours and an [`unwind()`][p2d_undwind] method for converting from even-odd to non-zero winding rules
+- The [`createTexture()`][createTexture()] context method returns **CanvasTexture** objects which can be assigned to `fillStyle` or `strokeStyle`
 - Textures draw either a parallel-lines pattern or one derived from the provided **Path2D** object and positioning parameters
-- The marker used when `setLineDash` is active can now be customized by assigning a **Path2D** to the context’s [`lineDashMarker`](https://github.com/samizdatco/skia-canvas#linedashmarker) property (default dashing can be restored by assigning `null`)
-- The marker’s orientation & shape relative to the path being stroked can be controlled by the [`lineDashFit`](https://github.com/samizdatco/skia-canvas#linedashfit) property which defaults to `"turn"` but can be set to `"move"` (which preserves orientation) or `"follow"` (which distorts the marker’s shape to match the contour)
+- The marker used when `setLineDash` is active can now be customized by assigning a **Path2D** to the context’s [`lineDashMarker`][lineDashMarker] property (default dashing can be restored by assigning `null`)
+- The marker’s orientation & shape relative to the path being stroked can be controlled by the [`lineDashFit`][lineDashFit] property which defaults to `"turn"` but can be set to `"move"` (which preserves orientation) or `"follow"` (which distorts the marker’s shape to match the contour)
+
+[p2d_d]: /docs/api/path2d.md#d
+[p2d_unwind]: /docs/api/path2d.md#unwind
+[createTexture()]: /docs/api/context.md#createtexture
+[lineDashMarker]: /docs/api/context.md#linedashmarker
+[lineDashFit]: /docs/api/context.md#linedashfit
 
 ### Bugfixes
 
@@ -159,15 +273,14 @@
 
 ### Misc. Improvements
 
-- The **Path2D** [`simplify()`](https://github.com/samizdatco/skia-canvas/#simplifyrulenonzero) method now takes an optional fill-rule argument
+- The **Path2D** [`simplify()`][simplify] method now takes an optional fill-rule argument
 - Added support for versions of macOS starting with 10.13 (High Sierra)
 
-
 ## 📦 ⟩ [v0.9.23] ⟩ Jul 12, 2021
 
 ### New Features
 
-- [Conic béziers][conic_bezier] can now be drawn to the context or a Path2D with the [`conicCurveTo()`][conic_curveto] method
+- [Conic béziers][conic_bezier] can now be drawn to the context or a Path2D with the [`conicCurveTo()`][conicCurveTo] method
 - Text can be converted to a Path2D using the context’s new [`outlineText()`][outline_text] method
 - Path2D objects can now report back on their internal geometry with:
     - the [`edges`][edges] property which contains an array of line-drawing commands describing the path’s individual contours
@@ -194,29 +307,29 @@
 
 [conic_bezier]: https://docs.microsoft.com/en-us/xamarin/xamarin-forms/user-interface/graphics/skiasharp/curves/beziers#the-conic-bézier-curve
 [conic_curveto]: https://github.com/samizdatco/skia-canvas#coniccurvetocpx-cpy-x-y-weight
-[outline_text]: https://github.com/samizdatco/skia-canvas#outlinetextstr
-[matte]: https://github.com/samizdatco/skia-canvas#matte
+[outline_text]: /docs/api/context.md#outlinetext
+[matte]: /docs/api/canvas.md#matte
 
-[edges]: https://github.com/samizdatco/skia-canvas#edges
-[contains]: https://github.com/samizdatco/skia-canvas#containsx-y
-[points]: https://github.com/samizdatco/skia-canvas#pointsstep1
-[offset]: https://github.com/samizdatco/skia-canvas#offsetdx-dy
-[transform]: https://github.com/samizdatco/skia-canvas#transformmatrix-or-transforma-b-c-d-e-f
+[edges]: /docs/api/path2d.md#edges
+[contains]: /docs/api/path2d.md#contains
+[points]: /docs/api/path2d.md#points
+[offset]: /docs/api/path2d.md#offset
+[transform]: /docs/api/context.md#transform--settransform
 
-[interpolate]: https://github.com/samizdatco/skia-canvas#interpolateotherpath-weight
-[jitter]: https://github.com/samizdatco/skia-canvas#jittersegmentlength-amount-seed0
-[round]: https://github.com/samizdatco/skia-canvas#roundradius
-[simplify]: https://github.com/samizdatco/skia-canvas#simplify
-[trim]: https://github.com/samizdatco/skia-canvas#trimstart-end-inverted
+[interpolate]: /docs/api/path2d.md#interpolate
+[jitter]: /docs/api/path2d.md#jitter
+[round]: /docs/api/path2d.md#round
+[simplify]: /docs/api/path2d.md#simplify
+[trim]: /docs/api/path2d.md#trim
 
 
 ## 📦 ⟩ [v0.9.22] ⟩ Jun 09, 2021
 
 ### 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`.
-- SVG exports can optionally convert text to paths by setting the [`outline`](https://github.com/samizdatco/skia-canvas#outline) argument to `true`.
+- Rasterization and file i/o are now handled asynchronously in a background thread. See the discussion of Canvas’s new [`async`][async_orig] 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`][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`][outline] argument to `true`.
 
 ### Breaking Changes
 
@@ -228,6 +341,9 @@
 - `measureText` was reporting zero when asked to measure a string that was entirely made of whitespace. This is still the case for ‘blank‘ lines when `textWrap` is set to `true` but in the default, single-line mode the metrics will now report the width of the whitespace.
 -  Changed the way text rendering was staged so that SVG exports didn’t *entirely omit(!)* text from their output. As a result, `Context2D`s now use an external `Typesetter` struct to manage layout and rendering.
 
+[density]: /docs/api/canvas.md#density
+[outline]: /docs/api/canvas.md#outline
+[async_orig]: https://github.com/samizdatco/skia-canvas/tree/v0.9.22#async
 
 ## 📦 ⟩ [v0.9.21] ⟩ May 22, 2021
 
@@ -235,9 +351,9 @@
   - Now runs on Windows and Apple Silicon Macs.
   - Precompiled binaries support Node 10, 12, 14+.
   - Image objects can be initialized from PNG, JPEG, GIF, BMP, or ICO data.
-  - Path2D objects can now be combined using [boolean operators](https://github.com/samizdatco/skia-canvas/#complement-difference-intersect-union-and-xor) and can measure their own [bounding boxes](https://github.com/samizdatco/skia-canvas/#bounds).
-  - Context objects now support [`createConicGradient()`](https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/createConicGradient).
-  - Image objects now return a promise from their [`decode()`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/decode) method allowing for async loading without the [`loadImage`](https://github.com/samizdatco/skia-canvas/#loadimage) helper.
+  - Path2D objects can now be combined using [boolean operators][boolean-ops] and can measure their own [bounding boxes][p2d_bounds].
+  - Context objects now support [`createConicGradient()`][createConicGradient()].
+  - Image objects now return a promise from their [`decode()`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/decode) method allowing for async loading without the [`loadImage`][loadImage()] helper.
 
 ### Bugfixes
   - Calling `drawImage` with a `Canvas` object as the argument now uses a Skia `Pict` rather than a  `Drawable` as the interchange format, meaning it can actually respect the canvas's current `globalAlpha` and `globalCompositeOperation` state (fixed #6).
@@ -250,6 +366,10 @@
   - Added new test suites for `Path2D`, `Image`, and `Canvas`’s format support.
   - Created [workflows](https://github.com/samizdatco/skia-canvas/tree/master/.github/workflows) to automate precompiled binary builds, testing, and npm package updating.
 
+[boolean-ops]: /docs/api/path2d.md#complement-difference-intersect-union-and-xor
+[p2d_bounds]: /docs/api/path2d.md#bounds
+[createConicGradient()]: https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/createConicGradient
+[loadImage()]: /docs/api/image.md#loadimage
 
 ## 📦 ⟩ [v0.9.20] ⟩ Mar 27, 2021
 
@@ -264,7 +384,10 @@
 
 **Initial public release** 🎉
 
-[unreleased]: https://github.com/samizdatco/skia-canvas/compare/v1.0.0...HEAD
+[unreleased]: https://github.com/samizdatco/skia-canvas/compare/v2.0.0...HEAD
+[v2.0.0]: https://github.com/samizdatco/skia-canvas/compare/v1.0.2...v2.0.0
+[v1.0.2]: https://github.com/samizdatco/skia-canvas/compare/v1.0.1...v1.0.2
+[v1.0.1]: https://github.com/samizdatco/skia-canvas/compare/v1.0.0...v1.0.1
 [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