From 724ba033e0344b0b1524eb5c6a86ca85bcf2e447 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 2 Jul 2026 20:08:10 +0000 Subject: [PATCH] docs: regenerate API diffs and polish release notes Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .../docfx/releases/4.148.1-unreleased.md | 10 +- .../docfx/releases/4.151.0-unreleased.md | 42 ++--- documentation/docfx/releases/4.151.0.md | 164 ++++++++++++++++++ documentation/docfx/releases/TOC.yml | 4 +- documentation/docfx/releases/index.md | 3 +- scripts/infra/docs/pr-authors.json | 5 +- 6 files changed, 194 insertions(+), 34 deletions(-) create mode 100644 documentation/docfx/releases/4.151.0.md diff --git a/documentation/docfx/releases/4.148.1-unreleased.md b/documentation/docfx/releases/4.148.1-unreleased.md index 638cd908d34..347f5a29d59 100644 --- a/documentation/docfx/releases/4.148.1-unreleased.md +++ b/documentation/docfx/releases/4.148.1-unreleased.md @@ -3,7 +3,7 @@ AI uses this data to generate the polished release notes below. Re-run the script to refresh this data from git history. - Generated: 2026-07-02T11:06:10Z by generate-release-notes.py + Generated: 2026-07-02T19:58:53Z by generate-release-notes.py version: 4.148.1 status: unreleased branch: release/4.148.x @@ -16,7 +16,7 @@ - Bump to the next version (4.148.1) after release by @mattleibow in https://github.com/mono/SkiaSharp/pull/4212 --> - + # Version 4.148.1 @@ -24,10 +24,12 @@ ## Highlights -This upcoming patch release brings upstream Chrome/m148 bug fixes from the Skia engine into the 4.148.x maintenance branch. +This patch cherry-picks upstream Skia chrome/m148 bug fixes into the `release/4.148.x` branch, keeping the 4.148 line current with Google's latest engine stability work. ## Bug Fixes ### Engine -- **Skia m148 upstream bug fixes** — Merges upstream bug fixes from the Chrome m148 Skia branch into the 4.148.x maintenance line. ([#4262](https://github.com/mono/SkiaSharp/pull/4262)) +- **Upstream Skia m148 bug fixes** — Merges cherry-picked bug fixes from the Chrome m148 branch, ensuring the 4.148.x release line benefits from the latest Skia engine improvements. ([#4262](https://github.com/mono/SkiaSharp/pull/4262)) + +Plus CI and documentation housekeeping. diff --git a/documentation/docfx/releases/4.151.0-unreleased.md b/documentation/docfx/releases/4.151.0-unreleased.md index e7ed8b420c5..8bbf341024a 100644 --- a/documentation/docfx/releases/4.151.0-unreleased.md +++ b/documentation/docfx/releases/4.151.0-unreleased.md @@ -3,31 +3,23 @@ AI uses this data to generate the polished release notes below. Re-run the script to refresh this data from git history. - Generated: 2026-07-02T11:06:10Z by generate-release-notes.py + Generated: 2026-07-02T19:58:53Z by generate-release-notes.py version: 4.151.0 status: unreleased branch: main - diff: release/4.150.0-rc.1..main - prs: 14 + diff: release/4.151.0-preview.1..main + prs: 6 api: hb=14.2.1 - - [skia-sync] Drive upstream sync from versions.json with a run-number rotation by @mattleibow in https://github.com/mono/SkiaSharp/pull/4306 - - [externals] Bump skia submodule to drop SK_BUILD_FOR_WASM redef by @ramezgerges in https://github.com/mono/SkiaSharp/pull/3788 [community ✨] (skia: mono/skia#204) - - Update README.md by @mattleibow in https://github.com/mono/SkiaSharp/pull/4299 - - [skia-sync] Update Skia to milestone m151 (4.151.0) by @mattleibow in https://github.com/mono/SkiaSharp/pull/4294 (skia: mono/skia#274) - - docs: regenerate API diffs and polish release notes by @github-actions[bot] in https://github.com/mono/SkiaSharp/pull/4298 [community ✨] - - docs: add release cadence section to releases index, driven by Chrome's schedule by @mattleibow in https://github.com/mono/SkiaSharp/pull/4297 - - docs: regenerate API diffs and polish release notes by @github-actions[bot] in https://github.com/mono/SkiaSharp/pull/4296 [community ✨] - - docs: add "AI in SkiaSharp" site page by @mattleibow in https://github.com/mono/SkiaSharp/pull/4292 - - docs: add release cadence section to releases index by @mattleibow in https://github.com/mono/SkiaSharp/pull/4291 - - Rework the api-docs skill: router layout, direct-XML edits, Cake tooling by @mattleibow in https://github.com/mono/SkiaSharp/pull/4242 - - Add embedded image/font selectors to SkiaFiddle by @mattleibow in https://github.com/mono/SkiaSharp/pull/4284 - - ci(docs): stop the PR-author cache from re-triggering the docs pipeline by @mattleibow in https://github.com/mono/SkiaSharp/pull/4285 - - docs: regenerate API diffs and polish release notes by @github-actions[bot] in https://github.com/mono/SkiaSharp/pull/4283 [community ✨] - - [Infra] Add milestone sync and audit scripts for Chrome-aligned releases by @mattleibow in https://github.com/mono/SkiaSharp/pull/4282 + - Remove unnecessary `unsafe` modifier from GRContextOptions by @Copilot in https://github.com/mono/SkiaSharp/pull/3991 [community ✨] + - Update docs submodule to latest main by @github-actions[bot] in https://github.com/mono/SkiaSharp/pull/4304 [community ✨] + - [docs-site] Skip PR staging previews for non-site file changes by @mattleibow in https://github.com/mono/SkiaSharp/pull/4321 + - [docs-site] Add "Moving faster with AI" dashboard to the AI page by @mattleibow in https://github.com/mono/SkiaSharp/pull/4318 + - [infra] Remove obsolete skiasharp-docker registry auth by @Copilot in https://github.com/mono/SkiaSharp/pull/4310 [community ✨] + - [docs-site] Sweep staging previews for open PRs inactive over 3 months by @mattleibow in https://github.com/mono/SkiaSharp/pull/4313 --> - + # Version 4.151.0 @@ -37,22 +29,18 @@ ## Highlights -This upcoming release advances the Skia engine to milestone m151, carrying all upstream graphics improvements and fixes from Chrome's m151 cycle. A community contributor resolved a WebAssembly build regression by removing a conflicting `SK_BUILD_FOR_WASM` redefinition from the Skia submodule. HarfBuzz 14.2.1 ships alongside this release — see the [HarfBuzz 14.2.1](harfbuzzsharp/14.2.1.md) page for text-engine details. +This delta covers changes on `main` since the last tagged preview. The primary code change is a clean-up of the `GRContextOptions` API surface contributed by [@Copilot](https://github.com/Copilot). The remaining work consists of website tooling and CI pipeline improvements. ## New Features -### Engine +### API Surface -- **Skia m151 milestone update** — Advances the Skia engine to Chrome milestone m151, incorporating all upstream graphics improvements, performance work, and bug fixes. ([#4294](https://github.com/mono/SkiaSharp/pull/4294)) -- **WebAssembly build fix** — Removes a redundant `SK_BUILD_FOR_WASM` redefinition from the Skia submodule that caused WASM build failures. ❤️ [@ramezgerges](https://github.com/ramezgerges) ([#3788](https://github.com/mono/SkiaSharp/pull/3788)) +- **Clean up `GRContextOptions`** — Removes an unnecessary `unsafe` modifier, improving API clarity without any behavioral change. ❤️ [@Copilot](https://github.com/Copilot) ([#3991](https://github.com/mono/SkiaSharp/pull/3991)) -### Developer Tools - -- **SkiaFiddle asset selectors** — Adds embedded image and font selectors to SkiaFiddle, making it easier to load assets when experimenting with the live editor. ([#4284](https://github.com/mono/SkiaSharp/pull/4284)) -- **Chrome-aligned release automation** — Introduces milestone sync and audit scripts to keep SkiaSharp's release cadence aligned with Chrome's schedule. ([#4282](https://github.com/mono/SkiaSharp/pull/4282)) +Plus several CI and documentation improvements. ## Community Contributors ❤️ | Contributor | What They Did | |-------------|--------------| -| [@ramezgerges](https://github.com/ramezgerges) | Fixed WebAssembly build by removing a redundant `SK_BUILD_FOR_WASM` redefinition | +| [@Copilot](https://github.com/Copilot) | Removed unnecessary `unsafe` modifier from `GRContextOptions` | diff --git a/documentation/docfx/releases/4.151.0.md b/documentation/docfx/releases/4.151.0.md new file mode 100644 index 00000000000..da44869329c --- /dev/null +++ b/documentation/docfx/releases/4.151.0.md @@ -0,0 +1,164 @@ + + + + +# Version 4.151.0 + +> **Upcoming release** · In development · Not yet available on NuGet + +> **API changes** · [HarfBuzzSharp 14.2.1](harfbuzzsharp/14.2.1.md) + +## Highlights + +Version 4.151.0 upgrades the Skia engine to milestone m151 and introduces four new rendering APIs — `SKPaint.GetFastBounds()`, `SKColorFilter.CreateOverdraw()`, `SKImageFilter.CreateCrop()`, and `SKImageFilter.CreateEmpty()` — for richer GPU and image-processing control. A critical small-sigma raster blur regression is resolved, and `SKSurface.Canvas` access is now more efficient through wrapper caching. HarfBuzz 14.2.1 ships alongside — see the [HarfBuzzSharp 14.2.1](harfbuzzsharp/14.2.1.md) page for details. Community contributor [@ramezgerges](https://github.com/ramezgerges) drove several of the most impactful changes: the performance gain, the rendering fix, a WebAssembly build fix, and pre-v4 API cleanup. + +## ⚠️ Breaking Changes + +- **Pre-v4 obsolete APIs now error at compile time** — APIs deprecated during the v4 migration are now compile errors. Resolve any remaining pre-v4 usages before upgrading. Obsolete enums in the reference assembly have also been trimmed. ❤️ [@ramezgerges](https://github.com/ramezgerges) ([#4195](https://github.com/mono/SkiaSharp/pull/4195)) +- **Removed .NET Interactive (Polyglot Notebooks) support** — The deprecated Polyglot Notebooks integration is removed. Projects using this should migrate to standard .NET APIs. ([#4186](https://github.com/mono/SkiaSharp/pull/4186)) + +## New Features + +### Engine + +- **Skia m151 upgrade** — Updates the Skia engine to Chrome milestone m151, bringing upstream graphics improvements, bug fixes, and performance work from Google. ([#4294](https://github.com/mono/SkiaSharp/pull/4294)) +- **Skia m150 upstream bug fixes** — Merges cherry-picked bug fixes from the upstream chrome/m150 branch. ([#4190](https://github.com/mono/SkiaSharp/pull/4190)) +- **Skia m150 initial upgrade** — Bumps the Skia engine from m148 to m150. ([#4146](https://github.com/mono/SkiaSharp/pull/4146)) +- **HarfBuzz 14.2.1** — Updates the bundled HarfBuzz text-shaping library to 14.2.1. See [HarfBuzzSharp 14.2.1](harfbuzzsharp/14.2.1.md) for binding details. ([#4167](https://github.com/mono/SkiaSharp/pull/4167)) +- **WebAssembly build fix** — Removes a conflicting `SK_BUILD_FOR_WASM` redefinition that caused build failures in WASM configurations. ❤️ [@ramezgerges](https://github.com/ramezgerges) ([#3788](https://github.com/mono/SkiaSharp/pull/3788)) + +### API Surface + +- **`SKPaint.GetFastBounds()`** — Adds a fast bounds query for efficient quick-reject culling, enabling applications to skip drawing operations that fall outside the visible region without a full render pass. ([#4271](https://github.com/mono/SkiaSharp/pull/4271)) +- **`SKColorFilter.CreateOverdraw()`** — Adds an overdraw-visualization color filter that highlights areas drawn multiple times, useful for debugging and rendering optimization. ([#4227](https://github.com/mono/SkiaSharp/pull/4227)) +- **`SKImageFilter.CreateCrop()`** — Adds a crop image filter that clips the output of a filter graph to a specified rectangle. ([#4229](https://github.com/mono/SkiaSharp/pull/4229)) +- **`SKImageFilter.CreateEmpty()`** — Adds an empty (transparent-black) image filter, useful as a no-op placeholder in filter chains. ([#4228](https://github.com/mono/SkiaSharp/pull/4228)) + +### Performance + +- **`SKSurface.Canvas` wrapper caching** — Caches the managed `SKCanvas` wrapper across calls to `SKSurface.Canvas`, reducing unnecessary allocations and GC pressure in rendering loops. ❤️ [@ramezgerges](https://github.com/ramezgerges) ([#4247](https://github.com/mono/SkiaSharp/pull/4247)) + +## Bug Fixes + +- **Small-sigma raster blur regression** — Fixes a performance regression where small-radius blurs fell back to a slow software render pipeline, resolving incorrect rendering for small blur sigma values. ❤️ [@ramezgerges](https://github.com/ramezgerges) ([#4269](https://github.com/mono/SkiaSharp/pull/4269)) + +## Platform Support + +| Platform | What's New | +|----------|-----------| +| 🌐 WebAssembly | Fixed `SK_BUILD_FOR_WASM` build-flag conflict | +| 📦 Tizen | Native dependencies now built in a Docker container | +| 🎨 Core API | `SKPaint.GetFastBounds()`, `SKColorFilter.CreateOverdraw()`, `SKImageFilter.CreateCrop()`, `SKImageFilter.CreateEmpty()` | + +## Community Contributors ❤️ + +| Contributor | What They Did | +|-------------|--------------| +| [@ramezgerges](https://github.com/ramezgerges) | Fixed small-sigma raster blur; added `SKSurface.Canvas` caching; promoted pre-v4 obsoletes to errors; fixed WebAssembly build | + +--- + +## Release Candidate 1 · 4.150.0 (June 29, 2026) + +Added `SKPaint.GetFastBounds()`, `SKColorFilter.CreateOverdraw()`, `SKImageFilter.CreateCrop()`, and `SKImageFilter.CreateEmpty()`; fixed the small-sigma raster blur regression; improved `SKSurface.Canvas` performance. + +[Full Changelog](https://github.com/mono/SkiaSharp/compare/v4.150.0-preview.2.1...v4.150.0-rc.1.1) + +--- + +## Preview 2 · 4.150.0 (June 24, 2026) + +Updated HarfBuzz to 14.2.1, promoted pre-v4 obsolete APIs to compile errors, removed Polyglot Notebooks support, and added Tizen Docker-based native builds. + +[Full Changelog](https://github.com/mono/SkiaSharp/compare/v4.150.0-preview.1.1...v4.150.0-preview.2.1) + +--- + +## Preview 1 · 4.150.0 (June 13, 2026) + +Initial Skia milestone bump to m150. + +[Full Changelog](https://github.com/mono/SkiaSharp/compare/v4.148.0...v4.150.0-preview.1.1) diff --git a/documentation/docfx/releases/TOC.yml b/documentation/docfx/releases/TOC.yml index 160d3a25f26..984754247f1 100644 --- a/documentation/docfx/releases/TOC.yml +++ b/documentation/docfx/releases/TOC.yml @@ -1,10 +1,12 @@ - name: Overview href: index.md - name: Version 4.151.x - href: 4.151.0-unreleased.md + href: 4.151.0.md items: - name: Version 4.151.0 (Unreleased) href: 4.151.0-unreleased.md + - name: Version 4.151.0 + href: 4.151.0.md - name: Version 4.150.x href: 4.150.0.md items: diff --git a/documentation/docfx/releases/index.md b/documentation/docfx/releases/index.md index cb5cdcf659a..b325831de8f 100644 --- a/documentation/docfx/releases/index.md +++ b/documentation/docfx/releases/index.md @@ -56,11 +56,12 @@ The full Chrome release calendar is published at [Chromium's release schedule](h |------|--------------|----------------| | Stable | 4.150.x | [4.150.0](4.150.0.md) | | Stable | 4.148.x | [4.148.0](4.148.0.md) | -| Preview | 4.151.x | [4.151.0 (Unreleased)](4.151.0-unreleased.md) | +| Preview | 4.151.x | [4.151.0](4.151.0.md) | ## Supported versions - **Version 4.151.x** — Preview + - [Version 4.151.0](4.151.0.md) - [Version 4.151.0 (Unreleased)](4.151.0-unreleased.md) - **Version 4.150.x** — Stable - [Version 4.150.0](4.150.0.md) diff --git a/scripts/infra/docs/pr-authors.json b/scripts/infra/docs/pr-authors.json index 04ae4989eb7..329a040c3a6 100644 --- a/scripts/infra/docs/pr-authors.json +++ b/scripts/infra/docs/pr-authors.json @@ -964,5 +964,8 @@ "4294": "mattleibow", "4297": "mattleibow", "4299": "mattleibow", - "4306": "mattleibow" + "4306": "mattleibow", + "4313": "mattleibow", + "4318": "mattleibow", + "4321": "mattleibow" }