a11y-lint 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e12c6c589719fa574aecc86ff23ba8f3c2f9b3ae7f5d4da88bae60bbd3035735
-  data.tar.gz: c107e0d511e57a1cbbbb61ec62a28d3f704bb11e3dbea32851000146f3053a4c
+  metadata.gz: c669543def8cb0173342e7399bebd99e9b51ae325e9a81323c3ee3cffe16b3b5
+  data.tar.gz: 9e1822681da394ecc9246998a403f05bb09d928303c4282185600f02a6688fa5
 SHA512:
-  metadata.gz: 81a64d2d5a348f5341636124859d31a61f65d6e4fce0d4712bafae17092d7749d5b629aa7f2a7e4269bc54f6e5ce3ff4cbf60225b1ccbcf7f44375104eaa773c
-  data.tar.gz: bda106347b59bb146e5acc02937eae5d54c0649833c86e86982f6759b128c5fc7b8885b632ee00d6d0848c3746d8d7eb5e4a041b74e1916cc39e6921a57d3ab3
+  metadata.gz: 337c2cb2bbd729cc2f8fa14889cdb48aedbb83a0d755ecd294667a977a91055ad09f26ca14f180c56dbfdf67f158a40a81ef962b79dfcab4bf5df3e496bcf611
+  data.tar.gz: c5a9ba84ff944b7750e2ac6d90d9d5ebfb5b460317d4b400f93869ff87e9a636ba6efdbd1c11357cc3e3c85fad1a25adc9b30ce8f00b910c4fc5710ec4526947

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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,60 @@
+# 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)
+          statement = sexp.dig(1, 0)
+          return unless statement.is_a?(Array)
+
+          case statement
+          in [:command, [:@ident, "image_tag", *], *]
+            statement
+          in [:method_add_arg, [:fcall, [:@ident, "image_tag", *]], *]
+            statement
+          else
+            nil
+          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.0"
   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.0
 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