jekyll-imgflow 0.4.3 → 0.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa6365d868c6ab77f4d57c45ffc04240c763891a5247dc94f3a0c498945331e2
-  data.tar.gz: 7c9016ec2a30c19fff8feb025cc79eb0a47b9ee9f9e52081b019c092bee26d95
+  metadata.gz: c9496f81e064e499eed64e5b894553a4631448bb103a1f538fa10d5d16b09028
+  data.tar.gz: cb2c0d6d2fda26e79bbddcd2de701a626c0fde8a1b2cdd1e49116f25e05cfc72
 SHA512:
-  metadata.gz: 20c21f06af136041b02c6f06bdd82a846b80b6f53152aa34b2037acdb5fe73d3ce2bb328e64060247af9bf67e0230e955e2f3d220ea35828c0e2d6393f18b6e1
-  data.tar.gz: 67f1a53d20b6957060007ea2acc60451f68b35323a8373005ede2ceb702e8c868a34cfa4218cc960b61920cadad3cc7021711115b905712b3d2ec2cf262182ee
+  metadata.gz: 6cc5cd2ef513d558f2fc5fc84ed0170ec5bb6361907ce72212e8cf6138865dc9fddb59e1ec62880f41740f762bbdc550434145849d4f781ede0e1e22a031055f
+  data.tar.gz: 2c95809a7775802e1a0a7932b1532c04bfe8d845806c0d73859096f33e1df8062717ce59244c85d46186158c1621ff093242da97f84758ca567e39134568a0ff

data/README.md

@@ -143,9 +143,10 @@ rake quick                           # Quick checks (style + tests)
 rake test                            # All tests
 rake parallel:test                   # Parallel testing (faster)
 
-# Docker Services
-rake start_services                  # Start services (pulls latest pinned images)
+# Docker Services (test tasks start/stop these automatically)
+rake start_services                  # Start services manually for repeated test runs
 rake check_services                  # Verify services
+rake stop_services                   # Stop services
 ```
 
 **See:** [testing.md](docs/testing.md) for comprehensive testing guide, [scripts.md](docs/scripts.md) for development utilities, and [rake.md](docs/rake.md) for all available Rake tasks
@@ -184,6 +185,10 @@ imgflow:
 
 ## 🐳 Docker Setup (Recommended)
 
+Test tasks that need the HTTP providers (e.g. `rake test_http_providers`)
+start these services automatically and stop them when the run finishes.
+Use the commands below only to keep services up across repeated runs:
+
 ```bash
 # Start all services (pulls latest pinned images first)
 rake start_services

data/interface.yml

@@ -2,7 +2,7 @@
 # Public tag/config surface for tooling (editor extensions, doc linters).
 ---
 gem: jekyll-imgflow
-version: 0.4.3
+version: 0.4.4
 tags:
   imgflow:
     params:

data/lib/jekyll-imgflow/html_generator.rb

@@ -5,6 +5,7 @@ module JekyllImgFlow
   # Supports Picture Tag compatibility with multiple markup formats and attributes
   class HtmlGenerator
     include ModalWrapper
+    include IntrinsicDimensions
 
     # Markup formats accepted via `markup:` (see docs/usage/tag-options.md).
     # Unknown values fall back to `img`.
@@ -110,7 +111,7 @@ module JekyllImgFlow
     # Generate standard <picture> element with <source> tags
     def generate_picture_element
       picture_attrs = build_attributes(@attributes[:picture])
-      img_attrs = build_img_attributes
+      img_attrs = build_img_attributes(find_fallback_image(@results))
 
       html = "<picture#{picture_attrs}>"
 
@@ -137,8 +138,8 @@ module JekyllImgFlow
 
     # Generate standard <img> element
     def generate_img_element
-      img_attrs = build_img_attributes
       primary = @results.first
+      img_attrs = build_img_attributes(primary)
 
       # Build srcset if multiple results
       srcset_attr = if @results.length > 1
@@ -154,7 +155,7 @@ module JekyllImgFlow
     # Generate <picture> element with data-* attributes for lazy loading
     def generate_data_picture_element
       picture_attrs = build_attributes(@attributes[:picture])
-      img_attrs = build_data_img_attributes
+      img_attrs = build_data_img_attributes(find_fallback_image(@results))
 
       html = "<picture#{picture_attrs}>"
 
@@ -181,8 +182,8 @@ module JekyllImgFlow
 
     # Generate <img> element with data-* attributes for lazy loading
     def generate_data_img_element
-      img_attrs = build_data_img_attributes
       primary = @results.first
+      img_attrs = build_data_img_attributes(primary)
 
       # Build data-srcset if multiple results
       srcset_attr = if @results.length > 1
@@ -206,18 +207,16 @@ module JekyllImgFlow
     end
 
     # Build img attributes including alt, loading, and custom attributes
-    def build_img_attributes
-      attrs = @attributes[:img].dup
-      attrs["alt"] = @attributes[:alt] if @attributes[:alt]
+    def build_img_attributes(result = nil)
+      attrs = base_img_attrs(result)
       attrs["loading"] = "lazy" unless attrs["loading"]
 
       build_attributes(attrs)
     end
 
     # Build img attributes with data-* for lazy loading
-    def build_data_img_attributes
-      attrs = @attributes[:img].dup
-      attrs["alt"] = @attributes[:alt] if @attributes[:alt]
+    def build_data_img_attributes(result = nil)
+      attrs = base_img_attrs(result)
       attrs["class"] = [attrs["class"], "lazy"].compact.join(" ")
 
       build_attributes(attrs)

data/lib/jekyll-imgflow/intrinsic_dimensions.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require "fastimage"
+
+module JekyllImgFlow
+  # Reads a generated image file's pixel dimensions so emitted markup can
+  # carry intrinsic width/height — the browser reserves the image box before
+  # download (avoids layout shift). Mixed into HtmlGenerator.
+  module IntrinsicDimensions
+    # Emit the file's pixel dimensions unless the user supplied any.
+    # Partial overrides (e.g. only width:) would skew the aspect ratio,
+    # so both attributes are skipped together.
+    def inject_intrinsic_dimensions(attrs, result)
+      return unless result
+      return if attrs["width"] || attrs["height"]
+
+      size = intrinsic_size(result)
+      return unless size
+
+      attrs["width"] = size[0]
+      attrs["height"] = size[1]
+    end
+
+    private
+
+    def base_img_attrs(result = nil)
+      attrs = @attributes[:img].dup
+      attrs["alt"] = @attributes[:alt] if @attributes[:alt]
+      inject_intrinsic_dimensions(attrs, result)
+      attrs
+    end
+
+    def intrinsic_size(result)
+      @intrinsic_sizes ||= {}
+      return @intrinsic_sizes[result] if @intrinsic_sizes.key?(result)
+
+      @intrinsic_sizes[result] = resolve_intrinsic_size(result)
+    end
+
+    def resolve_intrinsic_size(result)
+      site = @context&.registers&.dig(:site)
+      return unless site
+
+      rel = result.delete_prefix("/")
+      roots = [site.source]
+      roots << site.dest if site.respond_to?(:dest)
+      path = roots.map { |root| File.join(root, rel) }.find { |p| File.file?(p) }
+      return unless path
+
+      FastImage.size(path)
+    rescue FastImage::ImageFetchError, FastImage::UnknownImageType
+      nil
+    end
+  end
+end

data/lib/jekyll-imgflow/version.rb

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

data/lib/jekyll-imgflow.rb

@@ -24,6 +24,7 @@ require_relative "jekyll-imgflow/build_time_processor"
 require_relative "jekyll-imgflow/parser"
 require_relative "jekyll-imgflow/tags/tag_registry"
 require_relative "jekyll-imgflow/modal_assets"
+require_relative "jekyll-imgflow/intrinsic_dimensions"
 require_relative "jekyll-imgflow/html_generator"
 require_relative "jekyll-imgflow/imgflow_tag"
 require_relative "jekyll-imgflow/picture_tag_adaptor"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-imgflow
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: 0.4.4
 platform: ruby
 authors:
 - Svend Gundestrup
@@ -75,6 +75,7 @@ files:
 - lib/jekyll-imgflow/html_generator.rb
 - lib/jekyll-imgflow/imgflow_tag.rb
 - lib/jekyll-imgflow/interface.rb
+- lib/jekyll-imgflow/intrinsic_dimensions.rb
 - lib/jekyll-imgflow/manifest_manager.rb
 - lib/jekyll-imgflow/modal_assets.rb
 - lib/jekyll-imgflow/operation_processor.rb