[aesmail]

Summary

• Format ERB on Save (new, callback.document.will-save, scope text.html.erb) indents HTML views with htmlbeautifier.
  • It only runs on .html.erb files, including variants such as .html+phone.erb. Mailer text views and other ERB files are left alone.
  • It uses the document's tab settings (--tab-stops N or --tab) and passes --keep-blank-lines 1, because htmlbeautifier removes every blank line by default. It also passes --stop-on-errors: a view with a closing tag that has no opening tag is saved unchanged, with a tool tip saying where.
  • It runs htmlbeautifier with Bundler when the bundle has it, otherwise as installed for the project's Ruby, through mise. If it isn't installed for that Ruby (a mise shim for another Ruby doesn't count), the view is saved unchanged, without a message.
  • TM_ERB_FORMAT_ON_SAVE = false turns it off. TM_HTMLBEAUTIFIER and TM_HTMLBEAUTIFIER_OPTIONS set the command and add options.
• Formatted text is applied in place. It goes through mate --lsp workspace/applyEdit (built with osascript), so TextMate replaces only the lines that change. With Pair lines that differ only in white space when applying edits textmate#13, the caret and bookmarks also stay on re-indented lines. Untitled documents, or a TextMate that can't apply the edit, get the whole document replaced as before (exit 202). Format Document's RuboCop CLI fallback now works the same way.
• Refactor: Support/lib/rubocop.sh becomes format.sh. ruby_gem_executable GEM … runs RuboCop and htmlbeautifier the same way (TM_«GEM», Bundler, mise) and returns 127 when the tool isn't installed. The temporary folder is shared.
• Tests:
  • They now run commands as script files, as TextMate does.
  • CI moves to macOS, for bash 3.2 and osascript.
  • The README has an ERB section.

Test plan

• ruby Support/test/test_format.rb: 18 runs, 0 failures, 0 skips. New tests cover:
  • edits applied by TextMate, and replacing the whole document when it can't;
  • options and tab settings;
  • only HTML views being indented;
  • turned off, and no changes;
  • htmlbeautifier not installed, both without mise and with mise for a Ruby that lacks it;
  • the bundle's htmlbeautifier;
  • the invalid-nesting tool tip.
• End to end, with my no-UI harness (real TextMate client, real htmlbeautifier 1.4.3 under Ruby 3.4.8): a view was indented on save, three blank lines were collapsed to one, and the file on disk was untouched until saving. With Added test methods of Ruby 1.9 (pass, flunk and skip). textmate/ruby.tmbundle#13, all four bookmarks stayed on their lines. No temporary files were left behind.
• RuboCop through ruby-lsp still formats in place, with bookmarks kept.

🤖 Generated with Claude Code