GIF 与无损 PNG

Phase 2 提供两条 GIF 路径和两条无损 PNG 路径。兼容入口沿用 imagemin 插件 名称；显式原生入口暴露许可更简单、可进入 napi-rs worker pool 的 profile。

gifsicle()：兼容 sidecar

import imagemin, { gifsicle } from "imagemin-rs";

const output = await imagemin.buffer(input, {
  plugins: [gifsicle({ optimizationLevel: 3, colors: 128 })],
});

支持 interlaced、optimizationLevel: 1 | 2 | 3 与 colors: 2..256。未指定 optimizationLevel 时不会偷偷补入 level 1，这与 imagemin-gifsicle@7.0.0 的真实代码一致。

该入口执行项目从固定源码自建的 Gifsicle 1.96，不链接进 MIT native addon。8 个 @imagemin-rs/sidecar-gifsicle-* 平台包携带 SHA-256 provenance 与完整 GPL-2.0-only 文本，不使用运行时下载或安装期编译。普通 application extensions 默认删除， NETSCAPE loop、frame delays 和动画语义保留。进程限制为 256 MiB 输入、512 MiB stdout、1 MiB stderr 与 120 秒。

colors 是有损量化。gifsicle@5.3.0 仅保留为开发差分 oracle；跨平台只在同一 自建 Gifsicle 版本与配置间比较。

giflossless()：原生保守优化

import { giflossless } from "imagemin-rs";

const output = await giflossless({ strip: false })(input);

此入口通过 napi-rs AsyncTask 使用 permissive Rust parser/compositor。它只在 逐帧合成像素可证明等价时重编码为 global palette 与 delta rectangles；颜色超过 256、opaque → transparent 等不能安全表达的动画会原样返回。默认保留 metadata， strip:true 删除 comment/application metadata，但保留 loop。

giflossless() 不支持 colors 或 Gifsicle optimization levels。需要这些能力时 使用 gifsicle()。

optipng()：OptiPNG-shaped native profile

import { optipng } from "imagemin-rs";

const output = await optipng({
  optimizationLevel: 3,
  bitDepthReduction: true,
  colorTypeReduction: true,
  paletteReduction: true,
  interlaced: false,
  errorRecovery: true,
})(input);

默认值与 imagemin-optipng@8.0.0 一致，并总是删除 ancillary metadata。显式 interlaced:null 保持输入状态；默认 false 强制 non-interlaced。level 0 按 OptiPNG -nx -nz 语义关闭 reductions/IDAT recoding；level 7 使用 Oxipng 6 的 最接近 profile。

底层是 oxipng@10.1.1，不是 OptiPNG 0.7.7，因此不承诺相同的 trial 数、repair 集合或输出 bytes。metadata stripping、interlace 转换和 repair 优先于 keep-smaller， 极小文件可能变大。

对真实 OptiPNG 0.7.x（optipng-bin@7.0.1）的 corpus 差分固化了以下可依赖的行为： 全部 color type 与位深 1..16 的输出经独立 decoder 验证像素无损；-strip all 剥离集合与 OptiPNG 一致；level 0 与 OptiPNG 逐 chunk 一致，唯一分歧是 Oxipng 会 无损截断尾部全不透明的 tRNS 条目；Oxipng 可能在输出更小时把 palette 展开为 truecolor（OptiPNG 只朝 palette 方向缩减），差分把「表示分歧必须换来更小输出」 作为硬门槛；默认 level 3 在 1 像素宽的退化几何上可能大于 OptiPNG，level 7 消除 该差距；CRC 损坏输入的 errorRecovery 开/关行为与 -fix 一致。

APNG 是明确的 pass-through：OptiPNG 0.7.7 早于 APNG，而 strip all 会删除 animation chunks。项目在拥有 APNG-aware encoder 和逐帧 oracle 前不会静默把动画 降级为静态 PNG。

oxipng()：原生 Oxipng profile

oxipng() 保留 Oxipng 自己的 0..6 presets、strip: "none" | "safe" | "all"、 optimizeAlpha 与 interlace。它只采用更小或等大的结果。两个 PNG 工厂不能互换 理解：一个兼容 imagemin option shape，一个直接表达 Oxipng policy。