Changelog

Copy Markdown View Source

All notable changes to this project will be documented in this file. See Keep a Changelog.

[v0.1.1] — 2026-06-23

Bug Fixes

  • Don't emit g_face parameter when focus is not face.

[v0.1.0] — 2026-06-23

Phoenix.Component wrappers and per-CDN URL builders for the elixir-image ecosystem. Same canonical Image.Plug.Pipeline IR drives every URL grammar, so a single attribute set yields equivalent URLs across providers — modulo each CDN's grammar gaps.

Features

  • <.image> — renders an <img> whose src is projected from the per-transform attribute set onto the chosen CDN's URL grammar.

  • <.picture> — renders a <picture> with one <source srcset> per format (default [:avif, :webp]) plus a fallback <img>.

  • <.iiif> — IIIF-specific component with three modes: :static (single <img>), :tiles (one <img> per tile from source_width/source_height + tile_width/scale_factor), and :viewer (a <div> carrying data-iiif-* for an OpenSeadragon / Mirador / Leaflet-IIIF hook).

  • URL builders for five providers: Image.Components.URL.cloudflare/2, cloudinary/2, imgix/2, imagekit/2, and iiif/2 (IIIF Image API 3.0, Compliance Level 2).

  • Image.Components.URL.iiif_info_url/1 — builds the canonical IIIF info.json discovery URL, honouring :host and :iiif_prefix.

  • HMAC URL signing via :sign (and optional :sign_expires_at) on every builder — SHA-256 for Cloudflare/imgix, SHA-1 for ImageKit, base64url path-segment for Cloudinary.

  • region and iiif_quality attributes on <.image> / <.picture> for IIIF region crops (:full, {:pixels, …}, {:percent, …}) and quality (:default, :color, :gray, :bitonal).

Guides

  • guides/usage.md — <.image> / <.picture> walk-through, host/mount config, face-aware crops, per-CDN encoding of adjust effects, content negotiation.

  • guides/responsive.md — the four responsive-image problems (format, density, width-based srcset, art direction) with worked recipes and performance hints.

  • guides/environments.md — running an in-process image_plug in dev/test and pointing at a real CDN edge in production.

  • guides/iiif.md — IIIF provider walk-through covering URL shape, the per-attribute mapping table, deliberately-dropped concepts, and the <.iiif> component's three modes.