a11y-lint 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e12c6c589719fa574aecc86ff23ba8f3c2f9b3ae7f5d4da88bae60bbd3035735
-  data.tar.gz: c107e0d511e57a1cbbbb61ec62a28d3f704bb11e3dbea32851000146f3053a4c
+  metadata.gz: 5c000b195d8308dc83a3480df00e9a469e064535305ece969f779ee05b93fc87
+  data.tar.gz: cf3ec59befbf3057ff5f1a9d971925656fbf0f0c001e40780202abd862bd67a2
 SHA512:
-  metadata.gz: 81a64d2d5a348f5341636124859d31a61f65d6e4fce0d4712bafae17092d7749d5b629aa7f2a7e4269bc54f6e5ce3ff4cbf60225b1ccbcf7f44375104eaa773c
-  data.tar.gz: bda106347b59bb146e5acc02937eae5d54c0649833c86e86982f6759b128c5fc7b8885b632ee00d6d0848c3746d8d7eb5e4a041b74e1916cc39e6921a57d3ab3
+  metadata.gz: ad3e23e799fce7418f9e28224a9ec63120f42d5a04bd27710637df12e278118728af0a3baf47c5fe8b3cfa2a12e6bfbc366d8f334a453b385111b1befc2828df
+  data.tar.gz: 8be4c61819523edcbb0a11bb4959ab5834b0552d0fe27be2fc71aa30362dc18eb5ca8f9d25bffa5578f7f77d0af11b5e1716e8429b4c2a865fcd3a243031ede0

data/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.1] - 2026-03-27
+
+### Fixed
+
+- `ImageTagMissingAlt` rule: detect `image_tag` nested inside `link_to` and other helper calls
+
+## [0.3.0] - 2026-03-27
+
+### Added
+
+- `ImageTagMissingAlt` rule: detects `image_tag` calls without an `alt` option
+
 ## [0.2.0] - 2026-03-27
 
 ### Added

data/lib/a11y/lint/node.rb

@@ -15,6 +15,12 @@ module A11y
         @sexp[2]
       end
 
+      def ruby_code
+        return unless @sexp[0] == :slim && @sexp[1] == :output
+
+        @sexp[3]
+      end
+
       def attribute?(name)
         attributes.key?(name)
       end

data/lib/a11y/lint/rules/image_tag_missing_alt.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require "ripper"
+
+module A11y
+  module Lint
+    module Rules
+      # Checks that image_tag calls include an alt option (WCAG 1.1.1).
+      class ImageTagMissingAlt < Rule
+        def check(node)
+          return unless an_image_tag_without_an_alt_attribute?(node)
+
+          "image_tag is missing an alt option (WCAG 1.1.1)"
+        end
+
+        private
+
+        def an_image_tag_without_an_alt_attribute?(node)
+          code = node.ruby_code
+          return false unless code
+
+          sexp = Ripper.sexp(code)
+          return false unless sexp
+
+          call = extract_image_tag_call(sexp)
+          call && !alt_key_within?(call)
+        end
+
+        def extract_image_tag_call(sexp)
+          return unless sexp.is_a?(Array)
+          return sexp if image_tag_call?(sexp)
+
+          sexp.each do |child|
+            result = extract_image_tag_call(child)
+            return result if result
+          end
+
+          nil
+        end
+
+        def image_tag_call?(sexp)
+          case sexp
+          in [:command, [:@ident, "image_tag", *], *] then true
+          in [:method_add_arg, [:fcall, [:@ident, "image_tag", *]], *] then true
+          else false
+          end
+        end
+
+        def alt_key_within?(sexp)
+          return true if alt_key?(sexp)
+          return false unless sexp.is_a?(Array)
+
+          sexp.any? { |child| alt_key_within?(child) }
+        end
+
+        def alt_key?(sexp)
+          return false unless sexp.is_a?(Array) && sexp[0] == :assoc_new
+
+          key = sexp[1]
+          (key in [:@label, "alt:", *]) ||
+            (key in [:string_literal, [:string_content, [:@tstring_content, "alt", *]]])
+        end
+      end
+    end
+  end
+end

data/lib/a11y/lint/runner.rb

@@ -26,7 +26,7 @@ module A11y
 
         @line += 1 if sexp[0] == :newline
         new_node = Node.new(sexp, line: @line)
-        check_node(new_node) if html_tag?(sexp)
+        check_node(new_node) if html_tag?(sexp) || slim_output?(sexp)
         sexp.each { |child| walk(child) }
       end
 
@@ -34,6 +34,10 @@ module A11y
         sexp[0] == :html && sexp[1] == :tag
       end
 
+      def slim_output?(sexp)
+        sexp[0] == :slim && sexp[1] == :output
+      end
+
       def node?(sexp)
         sexp.is_a?(Array) && !sexp.empty? && sexp[0].is_a?(Symbol)
       end

data/lib/a11y/lint/version.rb

@@ -2,6 +2,6 @@
 
 module A11y
   module Lint
-    VERSION = "0.2.0"
+    VERSION = "0.3.1"
   end
 end

data/lib/a11y/lint.rb

@@ -5,6 +5,7 @@ require_relative "lint/version"
 require_relative "lint/offense"
 require_relative "lint/node"
 require_relative "lint/rule"
+require_relative "lint/rules/image_tag_missing_alt"
 require_relative "lint/rules/img_missing_alt"
 require_relative "lint/runner"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: a11y-lint
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Abdullah Hashim
@@ -45,6 +45,7 @@ files:
 - lib/a11y/lint/node.rb
 - lib/a11y/lint/offense.rb
 - lib/a11y/lint/rule.rb
+- lib/a11y/lint/rules/image_tag_missing_alt.rb
 - lib/a11y/lint/rules/img_missing_alt.rb
 - lib/a11y/lint/runner.rb
 - lib/a11y/lint/version.rb