@@ -7,81 +7,17 @@
 
 ---
 
-**ImageScript** is a zero-dependency alternative to common JavaScript bitmap image manipulation tools. Every codec and
-renderer is written in TypeScript: no WebAssembly, no native binaries, no npm dependencies, no install scripts. The
-package is about 160 kB (compressed) and runs in Node.js 22.13 or newer (including Alpine/musl, ARM and bundled
-serverless functions), Deno, Bun and browsers. It works with both `import` and `require()`, type definitions are included.
+**ImageScript** decodes, edits and encodes images in pure TypeScript: no WebAssembly, no native binaries, no
+dependencies. It runs in Node.js 22.13+, Deno, Bun and browsers, with `import` or `require()`, and includes type
+definitions.
 
 ```sh
 npm install imagescript              # Node.js, Bun and bundlers
-deno add jsr:@matmen/imagescript     # Deno (npm:imagescript works too)
+deno add jsr:@matmen/imagescript     # Deno
 ```
 
 ---
 
-### Features
-
-- [Decoding images](https://imagescript.matmen.dev/classes/Image.html#decode)
-  - PNGs (grayscale, RGB, indexed colors, 1-16 bit, interlaced) with and without alpha channels
-  - JPEGs (baseline and progressive; grayscale, RGB, CMYK)
-  - TIFFs (strips and tiles; uncompressed, LZW, deflate, PackBits and JPEG compressed; BigTIFF)
-  - WebPs (lossy, lossless and with alpha; bit-exact with libwebp)
-  - BMPs (1-64 bit, with any channel masks, alpha, RLE4 and RLE8, embedded JPEGs and PNGs; also OS/2 bitmaps)
-  - ICOs and CURs (the largest image: bitmaps with their masks, or PNGs)
-  - QOIs
-  - Netpbm images: PBM, PGM, PPM (plain and raw, up to 16 bits), PAM and PFM
-  - Radiance HDRs (RGBE and XYZE, every orientation), tone mapped to sRGB like Reinhard's operator does (or clamped,
-    `toneMapping`)
-  - TGAs (color mapped, truecolor and greyscale; uncompressed and run length encoded)
-  - AVIFs (4:2:0, 4:2:2, 4:4:4 and monochrome, 8-12 bit; grids, alpha, crop, rotation and mirroring; the first frame
-    of image sequences; bit-exact with dav1d and libavif), HDR ones (PQ, HLG) tone mapped to sRGB
-  - JPEG XLs (Modular and VarDCT, lossless and lossy, every coding tool: progressive passes and LF frames, patches,
-    splines, noise, restoration filters, upsampling, JPEG recompression, layers and blending, alpha and spot colors,
-    CMYK; animations; within 1 of libjxl's djxl on the conformance suite), XYB ones as sRGB, HDR ones tone mapped to
-    sRGB
-  - JPEGs, TIFFs, PNGs and WebPs are rotated as their Exif (or, for PNGs, XMP) orientation says
-  - images larger than 268 megapixels (`maxPixels`) are rejected before decoding, so small files declaring huge images
-    can't exhaust the memory
-- [Decoding animations](https://imagescript.matmen.dev/classes/Animation.html#decode) (GIF, APNG, WebP and JPEG XL) with all
-  frames, durations and disposal modes
-- [Rendering SVGs](https://imagescript.matmen.dev/classes/Image.html#rendersvg) (shapes, paths, gradients, strokes, clip paths,
-  masks, CSS; no text, images or filters)
-- [Rendering vector fonts](https://imagescript.matmen.dev/classes/Image.html#rendertext) (TrueType and OpenType, with
-  complex text shaping in every script, right to left and bidirectional text, outlines, TrueType hinting, fallback
-  fonts and color emoji)
-- [Resizing](https://imagescript.matmen.dev/classes/Image.html#resize) (bilinear, bicubic, area averaging and nearest neighbor)
-- Image manipulation functions ([crop](https://imagescript.matmen.dev/classes/Image.html#crop)
-  , [region](https://imagescript.matmen.dev/classes/Image.html#region)
-  , [rotate](https://imagescript.matmen.dev/classes/Image.html#rotate)
-  , [cropCircle](https://imagescript.matmen.dev/classes/Image.html#cropcircle)
-  , [roundCorners](https://imagescript.matmen.dev/classes/Image.html#roundcorners)
-  , [trim](https://imagescript.matmen.dev/classes/Image.html#trim), ...)
-- Filters and color adjustments ([blur](https://imagescript.matmen.dev/classes/Image.html#blur)
-  , [sharpen](https://imagescript.matmen.dev/classes/Image.html#sharpen)
-  , [brightness](https://imagescript.matmen.dev/classes/Image.html#brightness)
-  , [hueShift](https://imagescript.matmen.dev/classes/Image.html#hueshift), ...)
-- Compositing with opacity and blend modes ([composite](https://imagescript.matmen.dev/classes/Image.html#composite)),
-  removing backgrounds ([colorToAlpha](https://imagescript.matmen.dev/classes/Image.html#colortoalpha))
-- Color information functions ([averageColor](https://imagescript.matmen.dev/classes/Image.html#averagecolor)
-  , [dominantColor](https://imagescript.matmen.dev/classes/Image.html#dominantcolor), ...)
-- Encoding images as [PNGs](https://imagescript.matmen.dev/classes/Image.html#encode) (smallest lossless color type)
-  , [JPEGs](https://imagescript.matmen.dev/classes/Image.html#encodejpeg)
-  , lossless and lossy [WebPs](https://imagescript.matmen.dev/classes/Image.html#encodewebp) (lossy ones byte for
-  byte like libwebp's cwebp)
-  , [AVIFs](https://imagescript.matmen.dev/classes/Image.html#encodeavif) (lossy and lossless, with alpha)
-  , [JPEG XLs](https://imagescript.matmen.dev/classes/Image.html#encodejxl) (lossless byte for byte like libjxl's
-  `cjxl -e 1`, lossy about as small as `cjxl -e 5`)
-  , [BMPs](https://imagescript.matmen.dev/classes/Image.html#encodebmp)
-  , [QOIs](https://imagescript.matmen.dev/classes/Image.html#encodeqoi)
-  , [Netpbm images](https://imagescript.matmen.dev/classes/Image.html#encodepnm) (PBM, PGM, PPM or PAM, whichever is
-  smallest)
-  and [TGAs](https://imagescript.matmen.dev/classes/Image.html#encodetga)
-- Encoding animations as [GIF](https://imagescript.matmen.dev/classes/Animation.html#encodegif),
-  [APNG](https://imagescript.matmen.dev/classes/Animation.html#encodeapng) and lossless or lossy
-  [WebP](https://imagescript.matmen.dev/classes/Animation.html#encodewebp), storing only what changes from frame to frame
-
----
-
 ### Example
 
 ```js
@@ -93,47 +29,59 @@ image.resize(256, Image.RESIZE_AUTO).roundCorners(16);
 await writeFile('output.png', await image.encode());
 ```
 
-With CommonJS:
-
-```js
-const { Image } = require('imagescript');
-```
-
-All coordinates are 0-based, `(0, 0)` is the top left pixel.
-
-A bigger example is the [README image generation](https://github.com/matmen/ImageScript/blob/master/tests/readme.js).
-Upgrading from 1.x? Version 3 has breaking changes (0-based coordinates, lossy WebP encoding as `encodeWebP({ quality })`,
-Node.js 22.13+, ...), see the [changelog](https://github.com/matmen/ImageScript/blob/master/CHANGELOG.md).
+Coordinates are 0-based, `(0, 0)` is the top left pixel. A bigger example is the
+[README image generation](https://github.com/matmen/ImageScript/blob/master/tests/readme.js):
 
 [![Example](https://github.com/matmen/ImageScript/raw/master/tests/targets/readme.png)](https://github.com/matmen/ImageScript/blob/master/tests/readme.js)
 
 ---
 
-### Benchmarks
+### Features
 
-[bench/](bench/README.md) compares ImageScript to Jimp, image-js, Photon, sharp and @napi-rs/canvas: speed of decoding,
-encoding, image operations and rendering, encoded file sizes and install sizes. It runs for every release.
+| Format | Decode | Encode |
+|---|---|---|
+| PNG | ✓ | ✓ |
+| JPEG | ✓ | ✓ |
+| WebP | ✓ | ✓ (lossless and lossy) |
+| AVIF | ✓ | ✓ (lossless and lossy) |
+| JPEG XL | ✓ | ✓ (lossless and lossy) |
+| GIF, APNG (animations) | ✓ | ✓ |
+| BMP, QOI, TGA, Netpbm | ✓ | ✓ |
+| TIFF, ICO/CUR, Radiance HDR | ✓ | |
+
+Animated WebPs and JPEG XLs decode too, and [animations](https://imagescript.matmen.dev/classes/Animation.html)
+encode as GIF, APNG or WebP.
+
+- [Text rendering](https://imagescript.matmen.dev/classes/Image.html#rendertext) with TrueType and OpenType fonts,
+  in every script, with color emoji
+- [SVG rendering](https://imagescript.matmen.dev/classes/Image.html#rendersvg) (no text, images or filters)
+- [Resizing](https://imagescript.matmen.dev/classes/Image.html#resize),
+  [cropping](https://imagescript.matmen.dev/classes/Image.html#crop),
+  [rotating](https://imagescript.matmen.dev/classes/Image.html#rotate),
+  [trimming](https://imagescript.matmen.dev/classes/Image.html#trim),
+  [rounded corners](https://imagescript.matmen.dev/classes/Image.html#roundcorners), ...
+- [Compositing](https://imagescript.matmen.dev/classes/Image.html#composite) with opacity and blend modes
+- Filters and color adjustments: [blur](https://imagescript.matmen.dev/classes/Image.html#blur),
+  [sharpen](https://imagescript.matmen.dev/classes/Image.html#sharpen),
+  [brightness](https://imagescript.matmen.dev/classes/Image.html#brightness),
+  [hueShift](https://imagescript.matmen.dev/classes/Image.html#hueshift), ...
+
+See the [documentation](https://imagescript.matmen.dev/) for everything else, and the
+[changelog](https://github.com/matmen/ImageScript/blob/master/CHANGELOG.md) when upgrading from an older major version.
+[bench/](bench/README.md) compares ImageScript to Jimp, sharp and others.
 
 ---
 
 ### Credits
 
-The deflate/inflate implementation is derived from [fflate](https://github.com/101arrowz/fflate) and the CRC-32 from
-[Fast CRC32 in JavaScript](https://gist.github.com/101arrowz/e58695f7ccfdf74f60ba22018093edea), both by Arjun Barrett.
-The JPEG codec is based in part on the work of the Independent JPEG Group (libjpeg) and on
-[pdf.js](https://github.com/mozilla/pdf.js), the glyph rasterizer is translated from
-[font-rs](https://github.com/raphlinus/font-rs). The WebP codecs follow [RFC 9649](https://www.rfc-editor.org/rfc/rfc9649) and [RFC 6386](https://www.rfc-editor.org/rfc/rfc6386)
-and reproduce [libwebp](https://chromium.googlesource.com/webm/libwebp)'s color conversion, the lossy WebP encoder is
-ported from libwebp's, the TrueType hinting follows
-[FreeType](https://freetype.org)'s interpreter (portions of this software are copyright © 2026 The FreeType Project),
-the text shaping is ported from [HarfBuzz](https://github.com/harfbuzz/harfbuzz) and uses data of the
-[Unicode Character Database](https://www.unicode.org/ucd/). The AV1 decoder is ported from
-[dav1d](https://code.videolan.org/videolan/dav1d), AVIFs are converted to RGB like
-[libavif](https://github.com/AOMediaCodec/libavif) does, the JPEG XL decoder is ported from
-[jxl-oxide](https://github.com/tirr-c/jxl-oxide) and [libjxl](https://github.com/libjxl/libjxl), the JPEG XL encoders
-follow libjxl's fast lossless encoder and its lossy heuristics, the AV1 encoder mirrors the decoder and uses libaom's symbol encoder.
-See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) for their licenses.
+ImageScript builds on [fflate](https://github.com/101arrowz/fflate), libjpeg, [pdf.js](https://github.com/mozilla/pdf.js),
+[font-rs](https://github.com/raphlinus/font-rs), [libwebp](https://chromium.googlesource.com/webm/libwebp),
+[HarfBuzz](https://github.com/harfbuzz/harfbuzz), [dav1d](https://code.videolan.org/videolan/dav1d),
+[libavif](https://github.com/AOMediaCodec/libavif), libaom, [jxl-oxide](https://github.com/tirr-c/jxl-oxide) and
+[libjxl](https://github.com/libjxl/libjxl). The TrueType hinting follows [FreeType](https://freetype.org): portions of
+this software are copyright © 2026 The FreeType Project (www.freetype.org). All rights reserved. See
+[THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) for the licenses.
 
 ---
 
-If you have any additional questions, feel free to join the [discord support server](https://discord.gg/8hPrwAH).
+Questions? Join the [Discord server](https://discord.gg/8hPrwAH).