**Last updated: November 11th, 2026**

> 📘 See the full changelog for 2.0.0
>
> These are the changes since `2.0.0-beta.2` (released October 6th, 2026). For all changes since v1.4, see the [2.0.0 changelog](/docs/2.0/changelog).

## Highlights

- **macOS x64 support.** The beta SDK now ships for macOS x64 (Intel Macs) alongside macOS arm64, Windows x64, and Linux x64, requiring macOS 11.3 or later.
- **Async GPU driver.** The Platform module adds `GPUDriverAsync` to run GPU commands on a separate render thread, with reference drivers for Direct3D 11, Direct3D 12, and Metal, plus C API bindings— see [Asynchronous GPU Driver](/docs/2.0/async-gpu-driver).
- **AppCore asynchronous rendering.** `Settings::use_async_gpu_driver` runs GPU work and presentation on a dedicated thread so pages keep rendering while waiting to present (on by default on macOS, off on Windows).
- **Crisp pixel fonts.** They keep hard edges at every display scale on both renderers with no CSS or `Config` changes— see [Text Rendering and Fonts](/docs/2.0/text-rendering-and-fonts).
- **Text layout closer to Safari.** The library now supports CSS `font-palette`, `font-size-adjust`, and `@font-feature-values`.
- **More JavaScript object operations.** Delete object properties again with `Value::Delete()` (as in Ultralight 1.4), with new support for own keys, defining and freezing properties, constructors, and dates.

## Upgrading from beta.2

Recompile everything against the beta.3 headers. Then check the two lists below.

### Changes the compiler won't catch

Some of the API *behavior* has changed, make sure to be aware of the following changes:

**Custom GPU drivers:**

- `UpdateCommandList()` must append each new command list after pending ones rather than replacing them, running all lists in order.
- Textures created with `kGPUTextureFlag_Immutable` now have immutable bitmaps (`Bitmap::is_immutable()` is `true`), so writes (`Erase()`, `Set()`, `DrawBitmap()`) fail or do nothing while reads work.
- Replace copied SDK `platform/` code or shaders with beta.3 copies because the shaders changed.
- `GPUContextD3D11.h` and `GPUContextD3D12.h` no longer define `ENABLE_MSAA`, so `#if ENABLE_MSAA` now silently evaluates to `0`.
- `GPUContextMetal` no longer creates its own driver (`driver()` is null until attached), so create `GPUDriverMetal(context)` yourself and destroy it before the context.

**Renderer:**

- Call `Renderer::Render()` every frame even with nothing to paint, or an undisplayed `<canvas>` that script draws into holds draw calls in memory.
- `Config::num_renderer_threads` is now honored, whereas beta.2 ignored it and always used 8 threads.

**AppCore:**

- On macOS, GPU work and presentation run on a dedicated thread by default, so set `Settings::use_async_gpu_driver = false` to keep beta.2 behavior (ignored on Linux, on CPU renderers, and with your own GPU driver).
- `LayoutNode::bounds()` reads after a change now return the new geometry right away (previously after the next paint), and `OnLayoutChange()` callbacks run at the start of the next update rather than during paint.
- Layout override delegates run only when size, children, options, or display scale change, so call the new `Container::SetNeedsLayout()` when other state changes.

**Text and canvas:**

- Text layout is now closer to Safari, so lines are often 1-2 px shorter.
- Canvas `shadowOffsetY` now moves downward for positive values (beta.2 mirrored this), so remove any workaround.
- Pixel font sizes snap to the closest 1:1 size (`Config::snap_pixel_font_size` defaults to `true`) with whole-pixel advances, `font_embolden` no longer applies, and computed style keeps the authored size.

**Downloads and navigation:**

- Subframes (`<iframe>`) start a download only after a user click in that frame, while the main frame is unchanged.
- Responses without a usable `Content-Type` now have their MIME type sniffed, so HTML, text, or images that beta.2 downloaded may display instead while binary bodies still download in the main frame.

**Logging:**

- The Direct3D 11 and Direct3D 12 reference drivers now log under `d3d11` and `d3d12`, and `GPUContextMetal` logs under `metal` instead of `render` (`GPUDriverMetal` still logs under `render`), so update your log filters.

**JavaScript:**

- `Value::To()` into `std::map<std::string, T>` now fails for `Map`, `Set`, `Date`, and typed arrays, where beta.2 succeeded and usually returned an empty map.

### Changes the compiler will catch

When you rebuild the compiler should flag each of these changes. In the tables below, the left column is beta.2 code and the right column is the equivalent in beta.3.

**Renderer configuration:**

| beta.2 | beta.3 |
| --- | --- |
| `config.bitmap_alignment = 16;` | `config.bitmap_row_alignment = 16;` |
| `ulConfigSetBitmapAlignment(config, 16);` | `ulConfigSetBitmapRowAlignment(config, 16);` |

**Platform module:**

| beta.2 | beta.3 |
| --- | --- |
| `bool queued = chain->PresentFrame(true);` | `bool queued = chain->PresentFrame(true) == SwapChainD3D11::PresentResult::Presented;` |

- `SwapChainD3D11::PresentFrame()` and `SwapChainD3D12::PresentFrame()` return `PresentResult` (`Presented`, `Busy`, `Failed`) instead of `bool`, and swap chains are no longer copyable.
- Direct3D reference headers no longer put `ComPtr` in the global namespace, so add `using Microsoft::WRL::ComPtr;` to code that relied on it.

## What's New

**GPU drivers:**

- Add `GPUDriverAsync` and `GPUFrame` (`Platform/GPUDriverAsync.h`), with reference drivers for Direct3D 11, Direct3D 12, and Metal
- Add C API bindings for async GPU drivers in `AppCore/CAPI/CAPI_GPUDriverAsync.h`
- Add texture readback via `platform::GPUDriver::ReadbackTexture()` and `supports_readback()` in all reference drivers
- Support texture readback in custom GPU drivers by overriding `ReadTexturePixels()` and `supports_readback()` (overrides of `BeginSynchronize()` or `EndSynchronize()` must call the base implementation, else readback fails)
- Add `Bitmap::is_immutable()` and `ulBitmapIsImmutable()`

**AppCore:**

- Add `Settings::use_async_gpu_driver`
- Allow `WindowListener::OnClear()` and `OnPaint()` to draw through the public `GPUDriver` (`ulAppGetGPUDriver()` in C)
- Add `Container::SetNeedsLayout()`

**JavaScript:**

- Add property deletion via `Value::Delete()` and `Value::DeleteProperty()`
- Add own property inspection via `Value::HasOwn()` and `Value::OwnKeys()`
- Add `Value::DefineProperty()`, `Value::DefineAccessor()`, and `Value::Freeze()`
- Add constructors via `Value::Construct()` and `Value::IsConstructor()`
- Add Dates via `Context::MakeDate()` and `Value::TimeValue()`
- Add C API counterparts for JavaScript object operations (`ulJSObjectDeleteProperty()`, etc.)

**CSS and text:**

- Add CSS `font-palette` and `@font-palette-values` on color fonts
- Add CSS `font-size-adjust` and `@font-feature-values`
- Add `Config::pixel_font_rendering` (`Pixelated` default, `Smooth`), `Config::snap_pixel_font_size`, and `-ul-font-rendering` CSS property (`auto`, `smooth`, `pixelated`)

**Networking:**

- Sniff MIME types for frame navigations without a usable `Content-Type`, matching Chrome's rules

**Performance:**

- Draw scaled-down images roughly 10x faster
- Speed up the Direct3D 12 and Metal reference drivers
- Optimize `matchMedia()` so evaluating it every frame no longer slows frames

## Notable Fixes

- Fix Direct3D 12 device-removed faults on window resize or close, and debug-layer errors every frame in AppCore windows
- Fix Direct3D 11 and Direct3D 12 reference crashes, leaks, and message boxes on failure paths, falling back to CPU rendering in AppCore when Direct3D 11 device creation fails
- Fix occluded macOS windows blocking the main thread for roughly one second under synchronous Metal
- Fix Linux OpenGL crash on closing a window or popup
- Fix `App::Quit()` during an update continuing to paint windows
- Fix rendering of one-stop gradients, hard stops at 0% and 100%, zero-size gradients, and radius-0 radial gradients
- Fix translucent colors and opacity rendering one level too dark on both renderers
- Fix cubic Bezier curves with long handles shifting by up to 1.7 px ([GitHub #539](https://github.com/ultralight-ux/Ultralight/issues/539))
- Fix canvas `globalAlpha` and shadows applying twice when `ctx.filter` is set, `drawImage()` ignoring `globalAlpha` for videos, full-circle `arc()` calls drawing nothing, and `strokeRect()` rendering nothing when either dimension is zero
- Fix canvas shadows rendering only on solid rectangle fills (they now apply to all draws)
- Fix ligatures remaining active when `letter-spacing` is set, single characters losing OpenType features, and combining marks following a space inheriting the space's width
- Fix bitmap-only fonts missing glyphs, rendering at the wrong size, and ignoring `-webkit-text-stroke`
- Fix large images failing to appear when decoding takes longer than a frame
- Fix crash when script opens or closes a View (eg, a `<select>` popup) during paint
- Fix media elements with no playable tracks holding the page `load` event
- Fix `ImageSource` leak where bitmaps and GPU textures were never freed in apps that swap images
