herb 0.3.1-arm-linux-gnu → 0.4.2-arm-linux-gnu

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 57f60552dc37faec94f5ecd3db8ddee812b00111432f40140647eb9bf9591300
-  data.tar.gz: 07c1cde2a905f7125fa0c690b113a3f650f0356b20fc80fea0ea6d66ef563b12
+  metadata.gz: f27aaaad81ad225f5316278ca8a3c2412d624597d2a28e7eb5cafce3db32316e
+  data.tar.gz: d6c58ecbfed32f6c6afda64e1956d24f8b354bff4647ec6b01c93846742e51c5
 SHA512:
-  metadata.gz: 6c72b409bfc7f607253efb56713a4f592effedcbbf71f2cb6159c90831153b21413834103e08d923621c942575e4cac91c48e1b0d86cf3f0a3c18a5d26b9a8f1
-  data.tar.gz: 4c2a911b366ef7de04f0303b4a292cdc3b52e13b6c0a54a6555da724c51cf04984a665dfc8864b2be5ff7a4c8e40ecb5f8d829f4243c702baaaa49411884a931
+  metadata.gz: 871f6d51b0eb6be8d052b4ede53807e598a4e65a2b1d94139b2e834f731d11b136624dbe1e9351cc357e100afb1b98f4fe447b114b45328a51d6858747b6d2d2
+  data.tar.gz: 8ad246404e5f6e1e3c6926bfba00a7ea99860d82e8824b0290c29123edc71a11ab0a52801f196819b4e714754ec0a985d28f6f1151ae47987a7d19a0380b1b06

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2024 Marco Roth
+Copyright (c) 2024-2025 Marco Roth
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+THE SOFTWARE.

data/README.md

@@ -1,170 +1,135 @@
 <div align="center">
-  <img alt="Herb HTML+ERB parser" height="256px" src="https://github.com/user-attachments/assets/d0714ee1-ca33-4aa4-aaa9-d632ba79d54a">
+  <img alt="Herb HTML+ERB parser" style="height: 256px" height="256px" src="https://github.com/user-attachments/assets/d0714ee1-ca33-4aa4-aaa9-d632ba79d54a">
 </div>
 
 <h2 align="center">Herb</h2>
 
 <h4 align="center">HTML+ERB (HTML + Embedded Ruby)</h4>
 
-<div align="center">Powerful and seamless HTML-aware ERB parsing and tooling.</div>
+<div align="center">Powerful and seamless HTML-aware ERB parsing and tooling.</div><br/>
 
-## Contributing
-
-This project builds the Herb program and its associated unit tests using a Makefile for automation. The Makefile provides several useful commands for compiling, running tests, and cleaning the project.
-
-### Requirements
-
-- [**Check**](https://libcheck.github.io/check/): For unit testing.
-- [**Clang 19**](https://clang.llvm.org): The compiler used to build this project.
-- [**Clang Format 19**](https://clang.llvm.org/docs/ClangFormat.html): For formatting the project.
-- [**Clang Tidy 19**](https://clang.llvm.org/extra/clang-tidy/): For linting the project.
-- [**Prism Ruby Parser v1.4.0**](https://github.com/ruby/prism/releases/tag/v1.4.0): We use Prism for Parsing the Ruby Source Code in the HTML+ERB files.
-- [**Ruby**](https://www.ruby-lang.org/en/): We need Ruby as a dependency for `bundler`.
-- [**Bundler**](https://bundler.io): We are using `bundler` to build [`prism`](https://github.com/ruby/prism) from source so we can build `herb` against it.
-- [**Emscripten**](https://emscripten.org): For the WebAssembly build of `libherb` so it can be used in the browser using the [`@herb-tools/browser`](https://github.com/marcoroth/herb/blob/main/javascript/packages/browser) package.
-- [**Doxygen**](https://www.doxygen.nl): For building the C-Reference documentation pages.
+<p align="center">
+  <a href="https://rubygems.org/gems/herb"><img alt="Gem Version" src="https://img.shields.io/gem/v/herb"></a>
+  <a href="https://herb-tools.dev"><img alt="Documentation" src="https://img.shields.io/badge/documentation-available-green"></a>
+  <a href="https://herb-tools.dev/playground"><img alt="playground" src="https://img.shields.io/badge/playground-Try_it_in_the_browser!-green"></a>
+  <a href="https://github.com/marcoroth/herb/blob/main/LICENSE.txt"><img alt="License" src="https://img.shields.io/github/license/marcoroth/herb"></a>
+  <a href="https://github.com/marcoroth/herb/issues"><img alt="Issues" src="https://img.shields.io/github/issues/marcoroth/herb"></a>
+</p>
 
-##### For Linux
+<br/><br/><br/>
 
-```bash
-xargs sudo apt-get install < Aptfile
-```
-or:
+## What is Herb?
 
-```bash
-sudo apt-get install check clang-19 clang-tidy-19 clang-format-19 emscripten doxygen
-```
+**Herb** is an ecosystem of developer tooling built specifically around **HTML+ERB** (`.html.erb`) files. It is designed to simplify and enhance the experience of working with HTML+ERB templates through precise, accurate tooling.
 
-##### For macOS (using Homebrew)
+At the core of Herb is the **Herb Parser**, a fast, portable, and HTML-aware ERB parser written in C. The parser generates a detailed, accurate syntax tree that serves as the foundation for reliable code analysis, transformations, and developer tooling.
 
-```bash
-brew bundle
-```
-or:
+The Herb ecosystem includes **developer tools** (CLI, language server, formatter, linter), **language bindings** (for Ruby, Node.js, and the Browser using WebAssembly), and **utility libraries** (language service, highlighter, minifier, printer). All these components leverage the Herb Parser's syntax tree to provide consistent, accurate, and helpful tooling experiences.
 
-```bash
-brew install check llvm@19 emscripten doxygen
-```
+## What Herb Can Do for You
 
-### Building
+Herb provides a complete ecosystem of HTML+ERB tooling, designed to simplify and enhance your daily workflow. Built on the **Herb Parser**, it offers multiple tools that integrate seamlessly into editors, developer environments, and CI pipelines:
 
-#### Clone the Repo
+- **Herb Language Server** ([available now](https://herb-tools.dev/projects/language-server)):
+  Rich integration for editors like VS Code, Zed, Neovim, and more. It provides diagnostics and real-time feedback to keep your templates error-free.
 
-Clone the Git Repository:
+- **Herb Formatter** ([experimental preview](https://herb-tools.dev/projects/formatter)):
+  Automatic, consistent formatting for HTML+ERB files, reducing manual styling and enforcing a standard across projects. Currently in experimental preview - use with caution on version-controlled files.
 
-```
-git clone https://github.com/marcoroth/herb && cd herb/
-```
+- **Herb Linter** ([available now](https://herb-tools.dev/projects/linter)):  
+  Static analysis for your HTML+ERB templates to enforce best practices and quickly identify common mistakes with 17 configurable rules.
 
-#### Build Herb
+You can use Herb programmatically in **Ruby**, as well as in **JavaScript** via Node.js, WebAssembly, or directly in browsers.
 
-We can now compile all source files in `src/` and generate the `herb` executable.
+For a complete overview of all available tools, libraries, and integrations, visit the [**Projects page**](https://herb-tools.dev/projects) on our documentation site.
 
-```bash
-make all
-```
+## Motivation
 
-> [!NOTE]
-For any consecutive builds you can just run `make`/`make all`.
+HTML+ERB templates never really had good, accurate, and reliable tooling. While developer tooling for Ruby code improved significantly in the last few years (especially with the introduction of the new Prism parser), HTML+ERB files remained underserved, lacking fundamental support like syntax checking, auto-formatting, linting, and structural understanding.
 
-### Run
+At the same time, with the rise of tools like [Hotwire](https://hotwired.dev), [Stimulus](https://stimulus.hotwired.dev), [Turbo](https://turbo.hotwired.dev), [HTMX](https://htmx.org), [Unpoly](https://unpoly.com), and [Alpine.js](https://alpinejs.dev), advanced HTML templating became increasingly relevant (again). Developers expect modern, reliable, and precise tooling, especially given the robust ecosystem available to JavaScript frameworks and libraries.
 
-The `herb` executable exposes a few commands for interacting with `.html.erb` files:
+Herb was built to close this tooling gap, providing proper tooling for HTML+ERB that matches what modern developers expect in the age of language servers, LLMs, and AI-driven workflows.
 
-```
-❯ ./herb
-./herb [command] [options]
+## Command-Line Usage
 
-Herb 🌿 Powerful and seamless HTML-aware ERB parsing and tooling.
+Install the Herb gem via RubyGems:
 
-./herb lex [file]      -  Lex a file
-./herb lex_json [file] -  Lex a file and return the result as json.
-./herb parse [file]    -  Parse a file
-./herb ruby [file]     -  Extract Ruby from a file
-./herb html [file]     -  Extract HTML from a file
-./herb prism [file]    -  Extract Ruby from a file and parse the Ruby source with Prism
+```sh
+gem install herb
 ```
 
-Running the executable shows a pretty-printed output for the respective command and the time it took to execute:
+Basic usage to analyze all HTML+ERB files in your project:
 
+```sh
+herb analyze .
 ```
-❯ ./herb lex examples/simple_erb.html.erb
-
-#<Herb::Token type="TOKEN_ERB_START" value="<%" range=[0, 2] start=(1:0) end=(1:2)>
-#<Herb::Token type="TOKEN_ERB_CONTENT" value=" title " range=[2, 9] start=(1:2) end=(1:9)>
-#<Herb::Token type="TOKEN_ERB_END" value="%>" range=[9, 11] start=(1:9) end=(1:11)>
-#<Herb::Token type="TOKEN_NEWLINE" value="\n" range=[11, 12] start=(1:0) end=(2:1)>
-#<Herb::Token type="TOKEN_EOF" value="" range=[12, 12] start=(2:1) end=(2:1)>
 
-Finished lexing in:
-
-        12 µs
-     0.012 ms
-  0.000012  s
+This will give you an overview of how the Herb Parser sees your project:
 ```
+--- SUMMARY --------------------------------------------------------------------
+Total files: 145
+✅ Successful: 143 (98.6%)
+❌ Failed: 0 (0.0%)
+⚠️ Parse errors: 2 (1.4%)
+⏱️ Timed out: 0 (0.0%)
 
-### Building the Ruby extension
-
-We use `rake` and `rake-compiler` to compile the Ruby extension. Running rake will generate the needed templates, run make, build the needed artifacts, and run the Ruby tests.
+Files with parse errors:
+  - app/views/contributions/index.html.erb
+  - index.html.erb
 
-```bash
-rake
+Results saved to 2025-06-29_12-16-23_erb_parsing_result_rubyevents.log
 ```
 
-If `rake` was successful you can use `bundle console` to interact with `Herb`:
+Herb also comes with other useful commands:
 
-```bash
-bundle console
-```
-
-```
-irb(main):001> Herb.parse("<div></div>")
-
-# => #<Herb::ParseResult:0x0000000 ... >
-```
-
-### Test
-
-Builds the test suite from files in `test/` and creates the `run_herb_tests` executable to run the tests:
-
-#### For the C Tests
-
-```bash
-make test && ./run_herb_tests
 ```
+Herb 🌿 Powerful and seamless HTML-aware ERB parsing and tooling.
 
-#### For the Ruby Tests
+Usage:
+  bundle exec herb [command] [options]
 
-```bash
-rake test
+Commands:
+  bundle exec herb lex [file]         Lex a file.
+  bundle exec herb parse [file]       Parse a file.
+  bundle exec herb analyze [path]     Analyze a project by passing a directory to the root of the project
+  bundle exec herb ruby [file]        Extract Ruby from a file.
+  bundle exec herb html [file]        Extract HTML from a file.
+  bundle exec herb playground [file]  Open the content of the source file in the playground
+  bundle exec herb version            Prints the versions of the Herb gem and the libherb library.
 ```
 
-### Clean
+For detailed information, like how you can use Herb progamatiacally in Ruby and JavaScript, visit the [documentation site](https://herb-tools.dev/bindings/ruby/reference).
 
-Removes the `herb`, `run_herb_tests`, `prism` installation, and all `.o` files.
 
-```bash
-make clean
-```
+## Background and Talk
 
-### Local Integration Testing
+**Herb** was first introduced at [**RubyKaigi 2025**](https://rubykaigi.org/2025/presentations/marcoroth.html) in April 2025 with the talk [*Empowering Developers with HTML-Aware ERB Tooling*](https://www.rubyevents.org/talks/empowering-developers-with-html-aware-erb-tooling-rubykaigi-2025).
 
-The `bin/integration` script allows for quick local iteration. On every run it cleans the directory, builds the source from scratch and runs all checks, including the C-Tests, Ruby Tests, Linters, and examples in succession.
+## Contributing
 
-```bash
-bin/integration
-```
+Bug reports and pull requests are welcome on [GitHub](https://github.com/marcoroth/herb). Please see the [CONTRIBUTING.md](https://github.com/marcoroth/herb/blob/main/CONTRIBUTING.md) document for guidelines on how to set up Herb for local development and how to contribute to **Herb**.
 
-The integration was successful if you see:
+## Prior Art & Inspiration
 
-```
-❯ bin/integration
+While Herb brings a fresh approach to HTML+ERB tooling, it builds upon and learns from several existing tools and approaches in the ecosystem:
 
-[...]
+- [**Tree-sitter**](https://tree-sitter.github.io/tree-sitter/)
+- [**tree-sitter-embedded-template**](https://github.com/tree-sitter/tree-sitter-embedded-template)
+- [**Prism Ruby Parser**](https://github.com/ruby/prism)
+- [**Ruby LSP**](https://github.com/Shopify/ruby-lsp)
+- [**better-html**](https://github.com/Shopify/better-html)
+- [**erb_lint**](https://github.com/Shopify/erb_lint)
+- [**erb-formatter**](https://github.com/nebulab/erb-formatter)
+- [**erb-formatter-vscode**](https://github.com/nebulab/erb-formatter-vscode)
+- [**deface**](https://github.com/spree/deface)
+- [**html_press**](https://github.com/stereobooster/html_press)
+- [**htmlbeautifier**](https://github.com/threedaymonk/htmlbeautifier)
+- [**vscode-erb-beautify**](https://github.com/aliariff/vscode-erb-beautify)
+- [**vscode-erb-linter**](https://github.com/manuelpuyol/vscode-erb-linter)
 
-Integration successful!
-```
+Herb differentiates itself by being HTML-aware from the ground up, providing a unified parsing approach that understands both HTML and ERB as first-class citizens, rather than treating one as embedded within the other.
 
 ## License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE.txt) file for details.
+This project is available as open source under the terms of the [MIT License](https://github.com/marcoroth/herb/blob/main/LICENSE.txt).

data/ext/herb/error_helpers.c

@@ -1,5 +1,5 @@
 // NOTE: This file is generated by the templates/template.rb script and should not
-// be modified manually. See /Users/marcoroth/Development/herb-release/templates/ext/herb/error_helpers.c.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-6/templates/ext/herb/error_helpers.c.erb
 
 #include <ruby.h>
 

data/ext/herb/error_helpers.h

@@ -1,5 +1,5 @@
 // NOTE: This file is generated by the templates/template.rb script and should not
-// be modified manually. See /Users/marcoroth/Development/herb-release/templates/ext/herb/error_helpers.h.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-6/templates/ext/herb/error_helpers.h.erb
 
 #ifndef HERB_EXTENSION_ERROR_HELPERS_H
 #define HERB_EXTENSION_ERROR_HELPERS_H

data/ext/herb/nodes.c

@@ -1,5 +1,5 @@
 // NOTE: This file is generated by the templates/template.rb script and should not
-// be modified manually. See /Users/marcoroth/Development/herb-release/templates/ext/herb/nodes.c.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-6/templates/ext/herb/nodes.c.erb
 
 #include <ruby.h>
 
@@ -415,7 +415,7 @@ static VALUE rb_erb_content_node_from_c_struct(AST_ERB_CONTENT_NODE_T* erb_conte
   VALUE erb_content_node_tag_opening = rb_token_from_c_struct(erb_content_node->tag_opening);
   VALUE erb_content_node_content = rb_token_from_c_struct(erb_content_node->content);
   VALUE erb_content_node_tag_closing = rb_token_from_c_struct(erb_content_node->tag_closing);
-  /* #<Herb::Template::AnalyzedRubyField:0x00007fffe335bca0 @name="analyzed_ruby", @options={kind: nil}> */
+  /* #<Herb::Template::AnalyzedRubyField:0x00007fffe335ba20 @name="analyzed_ruby", @options={kind: nil}> */
   VALUE erb_content_node_analyzed_ruby = Qnil;
   VALUE erb_content_node_parsed = (erb_content_node->parsed) ? Qtrue : Qfalse;
   VALUE erb_content_node_valid = (erb_content_node->valid) ? Qtrue : Qfalse;

data/ext/herb/nodes.h

@@ -1,5 +1,5 @@
 // NOTE: This file is generated by the templates/template.rb script and should not
-// be modified manually. See /Users/marcoroth/Development/herb-release/templates/ext/herb/nodes.h.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-6/templates/ext/herb/nodes.h.erb
 
 #ifndef HERB_EXTENSION_NODES_H
 #define HERB_EXTENSION_NODES_H

data/lib/herb/ast/node.rb

@@ -51,7 +51,7 @@ module Herb
         output = +""
 
         if array.any?
-          output += "(#{array.count} #{array.count == 1 ? item_name : "#{item_name}s"})"
+          output += "(#{array.count} #{array.one? ? item_name : "#{item_name}s"})"
           output += "\n"
 
           items = array.map { |item|
@@ -92,6 +92,11 @@ module Herb
       def compact_child_nodes
         child_nodes.compact
       end
+
+      #: () -> Array[Herb::Errors::Error]
+      def recursive_errors
+        errors + compact_child_nodes.flat_map(&:recursive_errors)
+      end
     end
   end
 end

data/lib/herb/ast/nodes.rb

@@ -2,7 +2,7 @@
 # typed: true
 
 # NOTE: This file is generated by the templates/template.rb script and should not be
-# modified manually. See /Users/marcoroth/Development/herb-release/templates/lib/herb/ast/nodes.rb.erb
+# modified manually. See /Users/marcoroth/Development/herb-release-6/templates/lib/herb/ast/nodes.rb.erb
 
 module Herb
   module AST

data/lib/herb/cli.rb

@@ -6,7 +6,7 @@
 require "optparse"
 
 class Herb::CLI
-  attr_accessor :json, :silent
+  attr_accessor :json, :silent, :no_interactive, :no_log_file, :no_timing
 
   def initialize(args)
     @args = args
@@ -106,7 +106,11 @@ class Herb::CLI
   def result
     @result ||= case @command
                 when "analyze"
-                  Herb::Project.new(directory).parse!
+                  project = Herb::Project.new(directory)
+                  project.no_interactive = no_interactive
+                  project.no_log_file = no_log_file
+                  project.no_timing = no_timing
+                  project.parse!
                   exit(0)
                 when "parse"
                   Herb.parse(file_content)
@@ -162,6 +166,18 @@ class Herb::CLI
       parser.on("-s", "--silent", "Log no result to stdout") do
         self.silent = true
       end
+
+      parser.on("-n", "--non-interactive", "Disable interactive output (progress bars, terminal clearing)") do
+        self.no_interactive = true
+      end
+
+      parser.on("--no-log-file", "Disable log file generation") do
+        self.no_log_file = true
+      end
+
+      parser.on("--no-timing", "Disable timing output") do
+        self.no_timing = true
+      end
     end
   end
 

data/lib/herb/errors.rb

@@ -2,7 +2,7 @@
 # typed: true
 
 # NOTE: This file is generated by the templates/template.rb script and should not be
-# modified manually. See /Users/marcoroth/Development/herb-release/templates/lib/herb/errors.rb.erb
+# modified manually. See /Users/marcoroth/Development/herb-release-6/templates/lib/herb/errors.rb.erb
 
 module Herb
   module Errors

data/lib/herb/parse_result.rb

@@ -12,9 +12,14 @@ module Herb
       super(source, warnings, errors)
     end
 
+    #: () -> Array[Herb::Errors::Error]
+    def errors
+      super + value.recursive_errors
+    end
+
     #: () -> bool
     def failed?
-      errors.any? || value.errors.any? # TODO: this should probably be recursive
+      errors.any?
     end
 
     #: () -> bool
@@ -24,7 +29,7 @@ module Herb
 
     #: () -> String
     def pretty_errors
-      JSON.pretty_generate(errors + value.errors)
+      JSON.pretty_generate(errors)
     end
 
     #: (Visitor) -> void

data/lib/herb/project.rb

@@ -8,10 +8,17 @@ require "timeout"
 require "tempfile"
 require "pathname"
 require "English"
+require "stringio"
 
 module Herb
   class Project
-    attr_accessor :project_path, :output_file
+    attr_accessor :project_path, :output_file, :no_interactive, :no_log_file, :no_timing
+
+    def interactive?
+      return false if no_interactive
+
+      !IO.console.nil?
+    end
 
     def initialize(project_path, output_file: nil)
       @project_path = Pathname.new(
@@ -39,7 +46,15 @@ module Herb
     end
 
     def parse!
-      File.open(output_file, "w") do |log|
+      start_time = Time.now unless no_timing
+
+      log = if no_log_file
+              StringIO.new
+            else
+              File.open(output_file, "w")
+            end
+
+      begin
         log.puts heading("METADATA")
         log.puts "Herb Version: #{Herb.version}"
         log.puts "Reported at: #{Time.now.strftime("%Y-%m-%dT%H:%M:%S")}\n\n"
@@ -54,10 +69,10 @@ module Herb
           message = "No .html.erb files found using #{full_path_glob}"
           log.puts message
           puts message
-          next
+          return
         end
 
-        print "\e[H\e[2J"
+        print "\e[H\e[2J" if interactive?
 
         successful_files = []
         failed_files = []
@@ -77,37 +92,43 @@ module Herb
           lines_to_clear += 3 if total_timeout.positive?
           lines_to_clear += 3 if total_errors.positive?
 
-          lines_to_clear.times { print "\e[1A\e[K" } if index.positive?
+          lines_to_clear.times { print "\e[1A\e[K" } if index.positive? && interactive?
 
-          puts "Parsing .html.erb files in: #{project_path}"
-          puts "Total files to process: #{files.count}\n"
+          if interactive?
+            puts "Parsing .html.erb files in: #{project_path}"
+            puts "Total files to process: #{files.count}\n"
 
-          relative_path = file_path.sub("#{project_path}/", "")
+            relative_path = file_path.sub("#{project_path}/", "")
 
-          puts
-          puts progress_bar(index + 1, files.count)
-          puts
-          puts "Processing [#{index + 1}/#{files.count}]: #{relative_path}"
-
-          if failed_files.any?
             puts
-            puts "Files that failed:"
-            failed_files.each { |file| puts "  - #{file}" }
+            puts progress_bar(index + 1, files.count)
             puts
+          else
+            relative_path = file_path.sub("#{project_path}/", "")
           end
+          puts "Processing [#{index + 1}/#{files.count}]: #{relative_path}"
 
-          if timeout_files.any?
-            puts
-            puts "Files that timed out:"
-            timeout_files.each { |file| puts "  - #{file}" }
-            puts
-          end
+          if interactive?
+            if failed_files.any?
+              puts
+              puts "Files that failed:"
+              failed_files.each { |file| puts "  - #{file}" }
+              puts
+            end
 
-          if error_files.any?
-            puts
-            puts "Files with parse errors:"
-            error_files.each { |file| puts "  - #{file}" }
-            puts
+            if timeout_files.any?
+              puts
+              puts "Files that timed out:"
+              timeout_files.each { |file| puts "  - #{file}" }
+              puts
+            end
+
+            if error_files.any?
+              puts
+              puts "Files with parse errors:"
+              error_files.each { |file| puts "  - #{file}" }
+              puts
+            end
           end
 
           begin
@@ -214,10 +235,13 @@ module Herb
           end
         end
 
-        print "\e[1A\e[K"
-        puts "Completed processing all files."
-
-        print "\e[H\e[2J"
+        if interactive?
+          print "\e[1A\e[K"
+          puts "Completed processing all files."
+          print "\e[H\e[2J"
+        else
+          puts "Completed processing all files."
+        end
 
         log.puts ""
 
@@ -333,13 +357,23 @@ module Herb
           end
         end
 
-        puts "\nResults saved to #{output_file}"
+        unless no_timing
+          end_time = Time.now
+          duration = end_time - start_time
+          timing_message = "\n⏱️ Total time: #{format_duration(duration)}"
+          log.puts timing_message
+          puts timing_message
+        end
+
+        puts "\nResults saved to #{output_file}" unless no_log_file
+      ensure
+        log.close unless no_log_file
       end
     end
 
     private
 
-    def progress_bar(current, total, width = IO.console.winsize[1] - "[] 100% (#{total}/#{total})".length)
+    def progress_bar(current, total, width = (IO.console&.winsize&.[](1) || 80) - "[] 100% (#{total}/#{total})".length)
       progress = current.to_f / total
       completed_length = (progress * width).to_i
       completed = "█" * completed_length
@@ -366,5 +400,17 @@ module Herb
 
       prefix + ("-" * (80 - prefix.length))
     end
+
+    def format_duration(seconds)
+      if seconds < 1
+        "#{(seconds * 1000).round(2)}ms"
+      elsif seconds < 60
+        "#{seconds.round(2)}s"
+      else
+        minutes = (seconds / 60).to_i
+        remaining_seconds = seconds % 60
+        "#{minutes}m #{remaining_seconds.round(2)}s"
+      end
+    end
   end
 end

data/lib/herb/version.rb

@@ -2,5 +2,5 @@
 # typed: true
 
 module Herb
-  VERSION = "0.3.1"
+  VERSION = "0.4.2"
 end

data/lib/herb/visitor.rb

@@ -2,7 +2,7 @@
 # typed: true
 
 # NOTE: This file is generated by the templates/template.rb script and should not be
-# modified manually. See /Users/marcoroth/Development/herb-release/templates/lib/herb/visitor.rb.erb
+# modified manually. See /Users/marcoroth/Development/herb-release-6/templates/lib/herb/visitor.rb.erb
 
 module Herb
   class Visitor

data/sig/herb/ast/node.rbs

@@ -43,6 +43,9 @@ module Herb
 
       # : () -> Array[Herb::AST::Node]
       def compact_child_nodes: () -> Array[Herb::AST::Node]
+
+      # : () -> Array[Herb::Errors::Error]
+      def recursive_errors: () -> Array[Herb::Errors::Error]
     end
   end
 end