jekyll-imgflow 0.1.5

data/lib/jekyll-imgflow/tags/format_tag.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require_relative "base_tag"
+
+module JekyllImgFlow
+  module Tags
+    # Format tag - validates and processes format conversion
+    class FormatTag < BaseTag
+      def process(input_path, output_path, options = {})
+        formats = options[:formats] || [options[:format]]
+
+        # Handle case where formats is a single string instead of array
+        formats = Array(formats)
+
+        # Validate formats against unified config
+        validated_formats = formats.map { |format| validate_format(format) }
+        results = []
+
+        validated_formats.each do |format|
+          # Simple file extension replacement
+          last_dot = output_path.rindex(".")
+          format_output_path = if last_dot
+                                 output_path[0...last_dot] + ".#{format}"
+                               else
+                                 output_path + ".#{format}"
+                               end
+          ensure_output_dir(format_output_path)
+
+          # Reset provider operations before each format conversion
+          @provider.reset_operations
+          @provider.convert_format(format)
+          @provider.execute(input_path, format_output_path)
+          results << format_output_path
+        end
+
+        results
+      end
+
+      private
+
+      def validate_format(format)
+        raise ArgumentError, "Format cannot be nil" if format.nil?
+
+        # Get allowed formats from unified config (no fallback)
+        allowed_formats = @config.formats
+        raise ArgumentError, "No formats configured in unified config" unless allowed_formats
+
+        format_str = format.to_s.downcase
+
+        # Validate format is allowed in config
+        unless allowed_formats.include?(format_str)
+          raise ArgumentError,
+                "Invalid format: '#{format}'. Must be one of: #{allowed_formats.join(', ')}."
+        end
+
+        # Standardize format names (prefer canonical forms)
+        case format_str
+        when "jpeg" then "jpg" # Standardize to jpg
+        else format_str
+        end
+      end
+    end
+  end
+end

data/lib/jekyll-imgflow/tags/opacity_tag.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative "base_tag"
+
+module JekyllImgFlow
+  module Tags
+    # Opacity tag - validates and processes alpha channel manipulation
+    class OpacityTag < BaseTag
+      def process(input_path, output_path, options = {})
+        ensure_output_dir(output_path)
+
+        # Opacity must be explicitly provided (no default)
+        opacity = options[:opacity]
+        raise ArgumentError, "Opacity parameter is required" if opacity.nil?
+
+        validated_opacity = validate_opacity(opacity)
+
+        @provider.alpha_opacity = validated_opacity
+        @provider.execute(input_path, output_path)
+        output_path
+      end
+
+      private
+
+      def validate_opacity(value)
+        # Check if value is numeric before converting
+        raise ArgumentError, "Invalid opacity: '#{value}'. Must be between 0.01 and 0.99." unless value.to_s.match?(/\A\d*\.?\d+\z/)
+
+        opacity = value.to_f
+        raise ArgumentError, "Invalid opacity: '#{value}'. Must be between 0.01 and 0.99." unless opacity.between?(0.01, 0.99)
+
+        opacity
+      end
+    end
+  end
+end

data/lib/jekyll-imgflow/tags/optimize_tag.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require_relative "base_tag"
+
+module JekyllImgFlow
+  module Tags
+    # Optimize tag - validates and processes optimization levels
+    class OptimizeTag < BaseTag
+      def process(input_path, output_path, options = {})
+        ensure_output_dir(output_path)
+
+        level = options[:level] || :medium
+        quality = translate_optimize_level_to_quality(level)
+
+        # Validate the translated quality
+        quality = validate_quality(quality)
+
+        @provider.quality = quality
+        @provider.execute(input_path, output_path)
+      end
+
+      private
+
+      def translate_optimize_level_to_quality(level)
+        # Use config optimize_qualities for single source of truth
+        optimize_configs = @provider.config.optimize_qualities || raise("No optimize_qualities configured")
+
+        level_key = level.to_s
+        quality = optimize_configs[level_key]
+
+        # Use configured value, or default quality for medium/high
+        if quality.nil? && %w[medium high].include?(level_key)
+          quality = @default_quality || raise("No default quality configured")
+        elsif quality.nil?
+          # Use default config for unknown levels
+          quality = optimize_configs["default"] || raise("No default optimize quality configured")
+        end
+
+        quality
+      end
+
+      def validate_quality(value)
+        return @default_quality if value.nil?
+
+        quality = value.to_i
+        raise ArgumentError, "Invalid quality: '#{value}'. Must be between 1 and 100." unless quality.between?(1, 100)
+
+        quality
+      end
+    end
+  end
+end

data/lib/jekyll-imgflow/tags/quality_tag.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative "base_tag"
+
+module JekyllImgFlow
+  module Tags
+    # Quality tag - validates and processes quality settings
+    class QualityTag < BaseTag
+      def process(input_path, output_path, options = {})
+        ensure_output_dir(output_path)
+
+        # Validate quality (use default from config if not provided)
+        quality = validate_quality(options[:quality])
+
+        @provider.quality = quality
+        @provider.execute(input_path, output_path)
+      end
+
+      private
+
+      def validate_quality(value)
+        return @default_quality if value.nil?
+
+        quality = value.to_i
+        raise ArgumentError, "Invalid quality: '#{value}'. Must be between 1 and 100." unless quality.between?(1, 100)
+
+        quality
+      end
+    end
+  end
+end

data/lib/jekyll-imgflow/tags/resize_tag.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require_relative "base_tag"
+
+module JekyllImgFlow
+  module Tags
+    # Resize tag - validates and processes image resizing
+    class ResizeTag < BaseTag
+      def process(input_path, output_path, options = {})
+        ensure_output_dir(output_path)
+
+        # Validate inputs
+        width = validate_positive_integer(options[:width], "width")
+        height = validate_positive_integer(options[:height], "height")
+
+        # At least one dimension must be specified
+        raise ArgumentError, "Either width or height must be specified for resize operation." if width.nil? && height.nil?
+
+        # Get original dimensions
+        original_width, original_height = get_image_dimensions(input_path)
+
+        # Calculate missing dimension to maintain aspect ratio ONLY when one dimension is missing
+        if width.nil? && height
+          # Only height provided - calculate width to maintain aspect ratio
+          aspect_ratio = original_width.to_f / original_height
+          width = (height * aspect_ratio).round
+        elsif height.nil? && width
+          # Only width provided - calculate height to maintain aspect ratio
+          aspect_ratio = original_height.to_f / original_width
+          height = (width * aspect_ratio).round
+        end
+        # If both width and height are provided, use them as-is (allows aspect ratio changes)
+
+        # Calculate scale factors for provider
+        scale_x = width && original_width ? width.to_f / original_width : nil
+        scale_y = height && original_height ? height.to_f / original_height : nil
+
+        # Provider receives ALL data - provider chooses what to use
+        resize_data = {
+          original_width: original_width,
+          original_height: original_height,
+          target_width: width,
+          target_height: height,
+          scale_x: scale_x,
+          scale_y: scale_y
+        }
+
+        Jekyll.logger.debug "🔍 ResizeTag: About to execute provider - input: #{input_path}, output: #{output_path}"
+        @provider.resize(width, height, resize_data)
+        result = @provider.execute(input_path, output_path)
+        Jekyll.logger.debug "🔍 ResizeTag: Provider executed - result: #{result}, output exists: #{File.exist?(output_path)}"
+        result
+      end
+
+      # validate_positive_integer inherited from BaseTag
+    end
+  end
+end

data/lib/jekyll-imgflow/tags/tag_registry.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require_relative "base_tag"
+
+module JekyllImgFlow
+  module Tags
+    # Registry for managing tags
+    class TagRegistry
+      def self.register_tag(name, tag_class)
+        @tags ||= {}
+        @tags[name.to_sym] = tag_class
+      end
+
+      def self.get_tag(name)
+        @tags ||= {}
+        discover_tags unless @tags_discovered
+        @tags[name.to_sym]
+      end
+
+      def self.available_tags
+        @tags ||= {}
+        discover_tags unless @tags_discovered
+        @tags.keys
+      end
+
+      # Dynamic tag discovery
+      def self.discover_tags
+        return if @tags_discovered
+
+        @tags ||= {}
+        tags_dir = File.dirname(__FILE__)
+
+        Dir.glob(File.join(tags_dir, "*_tag.rb")).each do |file|
+          next if File.basename(file) == "base_tag.rb"
+
+          tag_name = File.basename(file, ".rb").gsub("_tag", "")
+          register_tag_from_file(tag_name)
+        end
+
+        @tags_discovered = true
+        Jekyll.logger.debug "ImgFlow:", "Discovered #{@tags.size} tags"
+      end
+
+      def self.register_tag_from_file(name)
+        class_name = "#{name.split('_').map(&:capitalize).join}Tag"
+
+        begin
+          require_relative "#{name}_tag"
+          tag_class = JekyllImgFlow::Tags.const_get(class_name)
+          register_tag name.to_sym, tag_class
+          Jekyll.logger.debug "ImgFlow:", "Registered tag: #{name} (#{class_name})"
+        rescue NameError => e
+          Jekyll.logger.warn "ImgFlow:", "Failed to load tag #{name}: #{e.message}"
+        rescue LoadError => e
+          Jekyll.logger.warn "ImgFlow:", "Failed to require tag #{name}: #{e.message}"
+        end
+      end
+
+      def self.tags_discovered?
+        @tags_discovered ||= false
+      end
+
+      # Force discovery (useful for testing)
+      def self.reset!
+        @tags = {}
+        @tags_discovered = false
+      end
+    end
+  end
+end

data/lib/jekyll-imgflow/tags/watermark_tag.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative "base_tag"
+
+module JekyllImgFlow
+  module Tags
+    # Watermark tag - validates and processes watermark operations
+    class WatermarkTag < BaseTag
+      def process(input_path, output_path, options = {})
+        ensure_output_dir(output_path)
+
+        watermark_path = options[:watermark]
+        position = options[:position] || :bottom_right
+        opacity = options[:opacity] || 0.7
+
+        # Validate and translate position for providers
+        translated_position = translate_watermark_position(position)
+        translated_opacity = validate_opacity(opacity)
+
+        @provider.add_watermark(watermark_path, position: translated_position,
+                                                opacity: translated_opacity)
+        @provider.execute(input_path, output_path)
+        output_path
+      end
+
+      private
+
+      def translate_watermark_position(position)
+        # Translate abstract positions to provider-specific values
+        case position
+        when :top_left then "northwest"
+        when :top_right then "northeast"
+        when :bottom_left then "southwest"
+        when :bottom_right then "southeast"
+        when :center then "center"
+        else position.to_s
+        end
+      end
+
+      def validate_opacity(value)
+        # Check if value is numeric before converting
+        raise ArgumentError, "Invalid opacity: '#{value}'. Must be between 0.0 and 1.0." unless value.to_s.match?(/\A\d*\.?\d+\z/)
+
+        opacity = value.to_f
+        raise ArgumentError, "Invalid opacity: '#{value}'. Must be between 0.0 and 1.0." unless opacity.between?(0.0, 1.0)
+
+        opacity
+      end
+    end
+  end
+end

data/lib/jekyll-imgflow/version.rb

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

data/lib/jekyll-imgflow.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "jekyll"
+require "liquid"
+require "json"
+require "digest"
+require "net/http"
+require "uri"
+require_relative "jekyll-imgflow/version"
+require_relative "jekyll-imgflow/config"
+require_relative "jekyll-imgflow/manifest_manager"
+require_relative "jekyll-imgflow/tag_scanner"
+require_relative "jekyll-imgflow/path_resolver"
+require_relative "jekyll-imgflow/filename_generator"
+require_relative "jekyll-imgflow/operation_processor"
+require_relative "jekyll-imgflow/batch_manager"
+require_relative "jekyll-imgflow/preset_manager"
+require_relative "jekyll-imgflow/helpers/http_downloader"
+require_relative "jekyll-imgflow/provider_registry"
+require_relative "jekyll-imgflow/build_time_processor"
+require_relative "jekyll-imgflow/parser"
+require_relative "jekyll-imgflow/tags/tag_registry"
+require_relative "jekyll-imgflow/html_generator"
+require_relative "jekyll-imgflow/imgflow_tag"
+require_relative "jekyll-imgflow/picture_tag_adaptor"
+require_relative "jekyll-imgflow/picture_tag_preset_migrator"
+require_relative "jekyll-imgflow/hooks"
+
+module JekyllImgFlow
+end

metadata

@@ -0,0 +1,261 @@
+--- !ruby/object:Gem::Specification
+name: jekyll-imgflow
+version: !ruby/object:Gem::Version
+  version: 0.1.5
+platform: ruby
+authors:
+- Svend Gundestrup
+bindir: bin
+cert_chain: []
+date: 2026-07-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: fastimage
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: bundler-audit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: reek
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.88'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.88'
+- !ruby/object:Gem::Dependency
+  name: rubocop-markdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.26'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.26'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.10'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: ImgFlow provides automatic image optimization for Jekyll with support
+  for multiple providers (Sharp, Imgproxy, ImageMagick, LibVips), multiple formats
+  (AVIF, WebP, PNG, JPG), and responsive image generation with modern picture tags.
+email: svend@gundestrup.dk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/jekyll-imgflow.rb
+- lib/jekyll-imgflow/batch_manager.rb
+- lib/jekyll-imgflow/build_time_processor.rb
+- lib/jekyll-imgflow/config.rb
+- lib/jekyll-imgflow/filename_generator.rb
+- lib/jekyll-imgflow/helpers/http_downloader.rb
+- lib/jekyll-imgflow/hooks.rb
+- lib/jekyll-imgflow/html_generator.rb
+- lib/jekyll-imgflow/imgflow_tag.rb
+- lib/jekyll-imgflow/manifest_manager.rb
+- lib/jekyll-imgflow/operation_processor.rb
+- lib/jekyll-imgflow/parser.rb
+- lib/jekyll-imgflow/path_resolver.rb
+- lib/jekyll-imgflow/picture_tag_adaptor.rb
+- lib/jekyll-imgflow/picture_tag_preset_migrator.rb
+- lib/jekyll-imgflow/preset_manager.rb
+- lib/jekyll-imgflow/provider_registry.rb
+- lib/jekyll-imgflow/providers/base_provider.rb
+- lib/jekyll-imgflow/providers/flyimg.rb
+- lib/jekyll-imgflow/providers/imagemagick.rb
+- lib/jekyll-imgflow/providers/imgproxy.rb
+- lib/jekyll-imgflow/providers/libvips.rb
+- lib/jekyll-imgflow/providers/sharp.rb
+- lib/jekyll-imgflow/providers/weserv.rb
+- lib/jekyll-imgflow/tag_scanner.rb
+- lib/jekyll-imgflow/tags/base_tag.rb
+- lib/jekyll-imgflow/tags/crop_tag.rb
+- lib/jekyll-imgflow/tags/format_tag.rb
+- lib/jekyll-imgflow/tags/opacity_tag.rb
+- lib/jekyll-imgflow/tags/optimize_tag.rb
+- lib/jekyll-imgflow/tags/quality_tag.rb
+- lib/jekyll-imgflow/tags/resize_tag.rb
+- lib/jekyll-imgflow/tags/tag_registry.rb
+- lib/jekyll-imgflow/tags/watermark_tag.rb
+- lib/jekyll-imgflow/version.rb
+homepage: https://github.com/gundestrup/jekyll-imgflow
+licenses:
+- AGPL-3.0-or-later
+metadata:
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: A modern, multi-provider, multi-format image optimization engine for Jekyll
+test_files: []