jekyll-imgflow 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a8e1eb8739d53b1ebcdbc440d4c77279ce895794ffb1beda8de9df159227d91
-  data.tar.gz: 730145b3e3017a1a63281f7e68c518cdc82cce708e55d942cdabdba002900d7c
+  metadata.gz: 07f3c2dfe3416810827699ab3b82a29012283ad308ad215f034f1bb86d8d8a79
+  data.tar.gz: 6ee5f237e22490069f7b3dc6ef0d8ba63a2ad8ecd1fe8a90754034a03192b11f
 SHA512:
-  metadata.gz: 23a45cd5749d4c389b65ffdbd54ca3240465441a325861d739acfedcaf342bd3e111eb04165b925d790f8b862a79d40c9bcbe85979181b184ea7bc3253065e00
-  data.tar.gz: 9b71032b277287766586518ef618cde9aa0d787f2ed3e7b061b609685f68221a46a7d5a09b53e8a4907512bf11611028a9b8add638f37477b08b607e9f38aa89
+  metadata.gz: e8da1e7ca9f599f6e1dcfbe5b2a44277ec53edd42b57e34159af1090e0fafcf068b361ac0713ba8932e4acb213f3569a268ffc1471c43c21ffd5845734769315
+  data.tar.gz: 4c7014c3888b5d4a2c94022f89eab3a383edf315fe34b556f3b727d7483f883b0b40ac772ab05fd51d37ab5d900122385d0887052bc6508085a2513dce339d0d

data/README.md

@@ -16,17 +16,26 @@ gem 'jekyll-imgflow'
 # Install
 bundle install
 
-# Configure (_config.yml)
+# Configure (_config.yml) — only originals and output are required,
+# everything else has sensible defaults:
 imgflow:
   originals: "assets/images/originals"
   output: "assets/images/optimized"
-  sizes: {sm: 400, md: 800, lg: 1200}
-  formats: [webp, avif, jpg]
 
 # Use in templates
 {% imgflow photo.jpg resize width:800 %}
 ```
 
+> **Full configuration options:** `quality`, `backend_priority`, `formats`,
+> `fallback_format`, `sizes`, provider URLs, and more — see the
+> [Installation Guide](docs/installation.md#4-add-to-_configyml)
+> and [Configuration Reference](docs/ARCHITECTURE.md).
+
+> **Note:** Image references require exact filenames (or paths relative to
+> `originals`). There is no fuzzy matching or autocomplete yet — if you type
+> `photo.jpg` but the file is `photo.jpeg`, the build will fail with an error.
+> Future versions may add "did you mean" suggestions.
+
 ## ✨ Key Features
 
 - **Multiple Providers**: [Sharp](https://github.com/lovell/sharp), [ImageMagick](https://github.com/ImageMagick/ImageMagick), [LibVips](https://github.com/libvips/libvips), [Imgproxy](https://github.com/imgproxy/imgproxy), [Weserv](https://github.com/weserv/images), [Flyimg](https://github.com/flyimg/flyimg)
@@ -112,18 +121,17 @@ gem 'jekyll-imgflow'
 # Install
 bundle install
 
-# Configure (_config.yml)
+# Configure (_config.yml) — only originals and output required:
 imgflow:
   originals: "assets/images/originals"
   output: "assets/images/optimized"
-  sizes: {sm: 400, md: 800, lg: 1200}
-  formats: [webp, avif, jpg]
 
 # Use in templates
 {% imgflow photo.jpg resize width:800 %}
 ```
 
-**See:** [installation.md](docs/installation.md) for detailed installation instructions and configuration options
+**See:** [installation.md](docs/installation.md) for detailed installation and
+[all configuration options](docs/installation.md#4-add-to-_configyml)
 
 ## 🐳 Docker Setup (Recommended)
 

data/lib/jekyll-imgflow/batch_manager.rb

@@ -213,8 +213,8 @@ module JekyllImgFlow
           # Use FilenameGenerator to generate proper filename
           operations = { width: width, format: format, quality: config.quality }
           filename = filename_generator.generate_filename(original_name, operations)
-          # Write to _site during build (after Jekyll copies assets)
-          output_path = path_resolver.resolve_output_path(filename)
+          # Write to source directory so Jekyll copies files to _site during write phase
+          output_path = path_resolver.resolve_source_output_path(filename)
 
           tasks << {
             original_name: original_name,

data/lib/jekyll-imgflow/config.rb

@@ -2,10 +2,29 @@
 
 module JekyllImgFlow
   class Config
+    # Sensible defaults — users only need to configure `originals` and `output`
+    # (or even nothing at all). All other values fall back to these.
+    DEFAULT_ORIGINALS = "assets/images/originals"
+    DEFAULT_OUTPUT = "assets/images/optimized"
+    DEFAULT_INPUT_FORMATS = %w[jpg jpeg png webp avif gif tiff tif svg].freeze
+    # Output format priority: avif > webp > png > jpg (fallback).
+    # The browser picks the first <source> format it supports, so avif is
+    # served to modern browsers, webp as a fallback for avif, png for
+    # transparency, and jpg as the universal <img> fallback.
+    DEFAULT_FORMATS = %w[avif webp png jpg].freeze
+    DEFAULT_SIZES = { "sm" => 400, "md" => 800, "lg" => 1200, "xl" => 2000 }.freeze
+    DEFAULT_QUALITY = 85
+    # Ordered by speed (see docs/providers.md benchmark):
+    # sharp (14s) → libvips (22s) → imagemagick (31s) → imgproxy (31s) → weserv (30s) → flyimg
+    DEFAULT_BACKEND_PRIORITY = %w[sharp libvips imagemagick imgproxy weserv flyimg].freeze
+    # Format used for the <img> fallback in <picture> elements.
+    # All other formats in `formats` get <source> tags for browsers that support them.
+    DEFAULT_FALLBACK_FORMAT = "jpg"
+
     attr_reader :site, :originals, :output, :input_formats, :sizes, :formats,
                 :quality, :backend_priority, :imgproxy_url,
                 :image_compressor_url, :weserv_url, :flyimg_url,
-                :optimize_qualities
+                :optimize_qualities, :fallback_format
 
     def initialize(site)
       shared = site.config["shared_images_configs"] || {}
@@ -13,20 +32,14 @@ module JekyllImgFlow
       cfg = shared.merge(overrides)
 
       @site             = site
-      @originals        = cfg["originals"]
-      @output           = cfg["output"]
-      @input_formats    = cfg["input_formats"]
-      @sizes            = cfg["sizes"]
-      @formats          = cfg["formats"]
-      @quality          = cfg["quality"]
-      @backend_priority = cfg["backend_priority"]
-
-      # Validate required config fields
-      raise ArgumentError, "No originals configured in unified config" unless @originals
-      raise ArgumentError, "No output configured in unified config" unless @output
-      raise ArgumentError, "No input_formats configured in unified config" unless @input_formats
-      raise ArgumentError, "No formats configured in unified config" unless @formats
-      raise ArgumentError, "No sizes configured in unified config" unless @sizes
+      @originals        = cfg["originals"] || DEFAULT_ORIGINALS
+      @output           = cfg["output"] || DEFAULT_OUTPUT
+      @input_formats    = cfg["input_formats"] || DEFAULT_INPUT_FORMATS
+      @sizes            = cfg["sizes"] || DEFAULT_SIZES
+      @formats          = cfg["formats"] || DEFAULT_FORMATS
+      @quality          = cfg["quality"] || DEFAULT_QUALITY
+      @backend_priority = cfg["backend_priority"] || DEFAULT_BACKEND_PRIORITY
+      @fallback_format  = cfg["fallback_format"] || DEFAULT_FALLBACK_FORMAT
 
       @imgproxy_url = cfg["imgproxy_url"]
       @image_compressor_url = cfg["image_compressor_url"]

data/lib/jekyll-imgflow/html_generator.rb

@@ -58,13 +58,13 @@ module JekyllImgFlow
 
     private
 
-    # Get fallback formats from config or use sensible defaults
+    # Get fallback formats — only the configured fallback format (e.g. jpg).
+    # These are skipped in the <source> loop and used for the <img> fallback.
+    # All other formats (webp, avif, etc.) get <source> tags.
     def fallback_formats
-      if @config&.formats
-        # Convert format names to extensions and add dots
-        @config.formats.map { |fmt| ".#{fmt}" }
+      if @config&.fallback_format
+        [".#{@config.fallback_format}"]
       else
-        # Fallback to common formats if no config available
         %w[.jpg .jpeg .png]
       end
     end
@@ -242,13 +242,40 @@ module JekyllImgFlow
       "<div#{parent_attrs}>#{html}</div>"
     end
 
-    # Group results by file extension/format
+    # Group results by file extension, ordered by config format priority
+    # (avif → webp → png → jpg). The browser picks the first <source> format
+    # it supports, so the order of <source> tags determines format priority.
     def group_by_format(results)
-      results.group_by { |r| File.extname(r).downcase }
+      grouped = results.group_by { |r| File.extname(r).downcase }
+      sort_format_groups(grouped)
     end
 
-    # Find fallback image (prefer jpg/jpeg/png)
+    # Sort format groups by config format priority (first = highest priority).
+    # Formats not in config.formats are appended at the end alphabetically.
+    def sort_format_groups(grouped)
+      priority = build_format_priority
+      grouped.sort_by { |ext, _| priority.index(ext) || Float::INFINITY }
+    end
+
+    # Build a lookup of format extensions ordered by config.formats priority.
+    # E.g. ["avif", "webp", "png", "jpg"] → [".avif", ".webp", ".png", ".jpg"]
+    def build_format_priority
+      return %w[.avif .webp .png .jpg] unless @config&.formats
+
+      @config.formats.map { |fmt| ".#{fmt.downcase}" }
+    end
+
+    # Find fallback image — prefer the configured fallback format,
+    # then any legacy format (jpg/jpeg/png), then first result.
     def find_fallback_image(results)
+      return results.first if results.empty?
+
+      preferred = @config&.fallback_format
+      if preferred
+        found = results.find { |r| r.end_with?(".#{preferred}") }
+        return found if found
+      end
+
       results.find { |r| r.match?(/\.(jpe?g|png)$/i) } || results.first
     end
 

data/lib/jekyll-imgflow/imgflow_tag.rb

@@ -97,7 +97,7 @@ module Jekyll
                  end
 
                  filename = components[:filename_generator].generate_filename(input_path, params)
-                 output_path = components[:path_resolver].resolve_output_path(filename)
+                 output_path = components[:path_resolver].resolve_source_output_path(filename)
 
                  # Determine version type
                  version_type = determine_version_type(params, components[:config])

data/lib/jekyll-imgflow/manifest_manager.rb

@@ -114,7 +114,7 @@ module JekyllImgFlow
 
       # Get optimized directory path
       config = JekyllImgFlow::Config.new(@site)
-      optimized_dir = File.join(@site.dest, config.output)
+      optimized_dir = File.join(@site.source, config.output)
 
       # Safety guard: prevent deletion of _site itself
       raise "Refusing to delete optimized directory: path resolves to site dest or is empty" if optimized_dir == @site.dest || optimized_dir.empty?
@@ -261,12 +261,7 @@ module JekyllImgFlow
       cleaned = []
 
       orphans.each do |orphan|
-        output_file = if orphan["output"].start_with?("/")
-                        orphan["output"]
-                      else
-                        File.join(@site.dest,
-                                  orphan["output"])
-                      end
+        output_file = File.join(@site.source, orphan["output"])
         if File.exist?(output_file)
           File.delete(output_file)
           cleaned << orphan["output"]

data/lib/jekyll-imgflow/operation_processor.rb

@@ -44,8 +44,8 @@ module JekyllImgFlow
 
       # Generate filename using FilenameGenerator (JPT compatible)
       filename = @filename_generator.generate_filename(input_path, params)
-      # Write to _site during build (after Jekyll copies assets)
-      actual_output_path = @path_resolver.resolve_output_path(filename)
+      # Write to source directory so Jekyll copies files to _site during write phase
+      actual_output_path = @path_resolver.resolve_source_output_path(filename)
 
       # Determine version type
       version_type = determine_version_type(params)
@@ -68,8 +68,8 @@ module JekyllImgFlow
 
       # Register in manifest
       if @manifest
-        # Convert absolute path to relative for manifest storage
-        relative_path = actual_output_path.sub(@path_resolver.site_dest, "")
+        # Store relative path (with leading /) for manifest storage
+        relative_path = "/#{@path_resolver.resolve_relative_output_path(filename)}"
 
         provider_name = @provider.class.provider_name
         @manifest.register_version(
@@ -83,9 +83,43 @@ module JekyllImgFlow
         )
       end
 
+      # Register as Jekyll static file so Jekyll copies it to _site during
+      # the write phase. Without this, files created during pre_render (or
+      # during render via imgflow tags) are not picked up by Jekyll's static
+      # file reader, which runs before pre_render. This would leave _site
+      # without optimized images until a second build.
+      register_jekyll_static_file(actual_output_path)
+
       actual_output_path
     end
 
+    # Register a generated file as a Jekyll::StaticFile so Jekyll copies it
+    # to _site during the write phase. No-op for mock/test sites.
+    # @param file_path [String] Absolute path to the generated file in source
+    def register_jekyll_static_file(file_path)
+      site = @config&.site
+      return unless site.is_a?(Jekyll::Site)
+
+      relative = file_path.delete_prefix("#{site.source}/")
+      return if relative == file_path # not under site source
+
+      add_static_file(site, relative) unless static_file_registered?(site, relative)
+    end
+
+    # @param site [Jekyll::Site] Jekyll site object
+    # @param relative [String] Path relative to site source
+    def static_file_registered?(site, relative)
+      site.static_files.any? { |sf| sf.relative_path == "/#{relative}" }
+    end
+
+    # @param site [Jekyll::Site] Jekyll site object
+    # @param relative [String] Path relative to site source
+    def add_static_file(site, relative)
+      site.static_files << Jekyll::StaticFile.new(
+        site, site.source, File.dirname(relative), File.basename(relative)
+      )
+    end
+
     # Process multiple operations on an image in sequence (batch)
     # @param operations [Array<Hash>] Array of operations to process
     # @param input_path [String] Path to input image

data/lib/jekyll-imgflow/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JekyllImgFlow
-  VERSION = "0.1.6"
+  VERSION = "0.1.7"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-imgflow
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.7
 platform: ruby
 authors:
 - Svend Gundestrup