ImageScript 4.0 by matmen · Pull Request #84 · imagescript/ImageScript

matmen · 2026-11-14T11:36:12Z

The 4.0 line: everything 3.x deprecated is removed, the API takes options objects, and sixteen behaviors change.
master (3.20.3) is merged in, so this merges cleanly. A draft until 4.0.0.

Release candidate: 4.0.0-rc.4 (npm tag rc, JSR)
Migration guide
CHANGELOG, 4.0.0 section

Before 4.0.0:

feedback on rc.4
the README's migration link points at master
3.x maintenance branch cut from 3.20.3
docs site switched

…ations

…d docs

… or not

…nothing was thrown

…ratio

…an 4

…ers' loop count

… scan

… that throw

matmen added 30 commits November 8, 2026 16:23

remove the RESIZE_*, SVG_MODE_* and DISPOSAL_* constants

d2b1305

remove the absolute argument of the adjust methods

b0523b8

remove Image.encode()

8175879

remove the color helpers of Image

e01dcc7

remove Image[Symbol.iterator] and iterateWithColors

183739c

remove PNGMetadata

13afda1

remove the max argument of cropCircle

145a62c

remove the positional forms of renderText

e07f362

remove the deprecated animation encoder options and frames

df000a4

reject arguments that are not options in cropCircle and renderText

e0340af

remove the positional mode of the resize functions

6556b04

remove the positional arguments of composite and the other image oper…

1ad99fd

…ations

remove the positional arguments of the encoders

ceb2b09

remove the positional arguments of renderSVG

be2a27b

remove the positional arguments of Frame and Animation

c539759

reject arguments that are not options in all methods that take options

d6f3253

decode() returns an Animation for files with several frames

8a73778

remove the GIF class

da60e9e

Animation holds its frames instead of extending Array

474425a

loop counts are Infinity or a count from 0

4214502

add a migration guide for 4.0

c9ce470

text alignments only take the values of their own axis

ec2d056

decode() takes options only

c6fe4e6

channel methods reject the removed absolute argument

bfa2219

resize() needs a height or the options form

d6dde6f

share the loop count conversion

daf8412

refuse loop counts that don't fit the format

5eff581

test that Animation.decode returns an Animation for single frames

9cc0466

changelog and guide: removed types, exact wording

e3f4bda

reject arguments that are not options in apngEncoder

0446780

matmen added 28 commits November 14, 2026 18:17

throw for cut-off JPEG and lossy WebP data

7790b27

address the second user report: pixels(), still durations, inspect an…

0eb1662

…d docs

throw for WebP image data that ends before its chunk size

d5caed7

check the gain map capacities against each other when they are set

95842bc

check the gain map embed and lossy WebP options whether they are used…

1790f80

… or not

reject boolean options that are not booleans

76aef55

throw a TypeError for values of the wrong type where a RangeError or …

124b0b4

…nothing was thrown

write no Exif block when there is nothing to put in it

7a3d4cf

encode gray images as grayscale JPEGs

7016e93

size an SVG with a viewBox and one of width and height by the aspect …

c91bf09

…ratio

align right-to-left text to the right by default

6400209

document that a cut-off animation keeps its whole frames

6d67d9d

start no threads for lossy JPEG XL below 1.5 megapixels with fewer th…

0103188

…an 4

skip PNG metadata chunks with a bad checksum

c53b0b7

carry on after corrupt JPEG data at the next restart marker

ebe498f

trust the alpha mask a BMP declares

46875a2

place left and centered right-to-left lines by their ink

66c6b07

refuse null sizes in renderSVG

5dc2981

throw a TypeError for more values of the wrong type

240f75c

refuse arrays as options and null metadata

a042ddd

name floating-point TIFF samples in the error

cda2fef

correct the docs on JPEG XL memory, grayscale JPEG size and the encod…

4058d8e

…ers' loop count

treat a restart interval whose data runs out as damage, not a cut-off…

85a371a

… scan

drop a fix of an rc-only bug from the CHANGELOG

a6f0725

list the right-to-left alignment default as a breaking change

3a6d1ed

count seventeen behavior changes in the migration guide

50de0b7

add boolean options and cut-off files to the migration guide's values…

52fa11f

… that throw

say that 3.x also made transparent BMPs opaque

4fdb9f6

matmen deployed to npm November 15, 2026 10:14 — with GitHub Actions

View deployment

matmen deployed to jsr November 15, 2026 10:14 — with GitHub Actions

View deployment

Navigation Menu

Repository navigation

ImageScript 4.0 - #84

ImageScript 4.0#84
matmen wants to merge 217 commits into
masterfrom
v4

matmen commented Nov 14, 2026

Uh oh!

This branch was successfully deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

matmen commented Nov 14, 2026

Uh oh!

This branch was successfully deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant