# What changed in @takumi-rs/wasm

> 19 changes in @takumi-rs/wasm 1 to 2 from its official release notes, upgrade guides and advisories: 14 breaking, 3 new APIs and options. Each one cited. Sources checked 2026-10-24. HTML: https://unstale.sh/npm/@takumi-rs/wasm/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @takumi-rs/wasm 2

### Breaking changes

- The shorthand no longer parses or resets background-blend-mode; set the blend mode with the longhand. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)
- An omitted border width now resolves to medium (3px) instead of 0; thin, medium, and thick are accepted. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)
- encodeFrames is removed; use renderAnimation or render once per frame for raw output. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)
- Pass each render's required images through images, keyed by src; the renderer no longer retains a persistent image store. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)
- line-clamp is now a shorthand for max-lines, block-ellipsis, and continue; clamped ancestors no longer impose their line limit on descendants. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)
- The default changes from top-left to center (50% 50%); specify the anchor explicitly where you relied on the old default. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)
- An omitted outline width now resolves to medium (3px) instead of 0; thin, medium, and thick are accepted. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)
- The default changes from relative to static; set position: relative where you relied on the old containing-block or inset behavior. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)
- Use registerFont to preload fonts on a reused renderer; it accepts raw bytes or a font descriptor and resolves to registered families. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)
- Rendering throws when animation frame rate exceeds the format limit: 90 fps for WebP and APNG, or 50 fps for GIF. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)
- The constructor no longer accepts fonts or a context; construct it without arguments and pass fonts through each render's fonts option. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)
- Negative scale values now reflect or mirror the element instead of collapsing it to zero. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)
- The default changes from top-left to center (50% 50%); specify the origin explicitly where you relied on the old default. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)

### New APIs and options

- Each render can specify an ordered font family fallback list; by default, all registered families are tried in registration order. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)
- Render options accept fonts, including bare URL strings; URL fonts are fetched on demand and cached. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)
- A Map-like byte cache can be shared across renders to deduplicate concurrent image fetches. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)

### Behavior and default changes

- The WebAssembly binding supports the quality field for JPEG only; it does not support lossless, and WebP is always lossless. (2.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v2)

## @takumi-rs/wasm 1

### Breaking changes

- takumi-js now detects the runtime and selects the appropriate bindings; import ImageResponse from takumi-js/response instead of importing WASM bindings directly. (1.0.0) — [upgrade guide](https://takumi.kane.tw/docs/migration/v1)

### Fixes and other changes

- CJS consumers resolve the package’s `.d.cts` declarations through export types split by import/require condition. (1.8.7) — [release notes](https://github.com/kane50613/takumi/releases/tag/%40takumi-rs/wasm%401.8.7)
