lostcoords-ui 0.5.0 → 0.7.0

data/lib/lostcoords/ui/builders.rb

@@ -10,8 +10,8 @@ module Lostcoords::Ui
 
       def component?
         !name.to_s.end_with?("_class") &&
-          !%i[lc_tw lc_sheet_data lc_alert_icon].include?(name) &&
-          helper != "EmojiPickerHelper"
+          !%i[lc_tw lc_sheet_data lc_shortcut_data lc_alert_icon].include?(name) &&
+          (helper != "EmojiPickerHelper" || name == :lc_emoji_picker)
       end
     end
 

data/lib/lostcoords/ui/form_builder.rb

@@ -1,4 +1,13 @@
 module Lostcoords::Ui
+  # Rails wraps a field with errors in <div class="field_with_errors">. Controls this builder renders show
+  # errors themselves, so the wrapper is skipped while it renders; other forms keep Rails' behaviour.
+  module SkipsFieldErrorWrapper
+    def error_wrapping(html_tag)
+      @template_object.instance_variable_get(:@lc_skip_field_error_wrapper) ? html_tag : super
+    end
+  end
+  ActionView::Helpers::Tags::Base.prepend(SkipsFieldErrorWrapper)
+
   # Rails form builder that renders the library's controls and connects model errors to them.
   #
   #   <%= lc_form_with model: @project do |form| %>
@@ -16,6 +25,21 @@ module Lostcoords::Ui
       date_field time_field datetime_field datetime_local_field month_field week_field
     ].freeze
 
+    # Every helper that renders a control, wrapped so Rails' error wrapper stays out of its markup.
+    WRAPPED = [ *field_helpers, :select, :collection_select, :grouped_collection_select, :time_zone_select,
+      :collection_check_boxes, :collection_radio_buttons, :switch, :choice ].uniq - %i[label fields_for fields hidden_field]
+
+    module WithoutFieldErrorWrapper
+      WRAPPED.each do |helper|
+        module_eval <<~RUBY, __FILE__, __LINE__ + 1
+          def #{helper}(...)
+            without_field_error_wrapper { super(...) }
+          end
+        RUBY
+      end
+    end
+    prepend WithoutFieldErrorWrapper
+
     INPUTS.each do |selector|
       define_method(selector) do |method, options = {}|
         size = control_size!(options)
@@ -33,6 +57,11 @@ module Lostcoords::Ui
       super(method, choices, options, control_options(method, html_options, "select", @template.lc_select_class(size: size)), &block)
     end
 
+    SELECT_OPTIONS = %i[include_blank prompt selected disabled].freeze
+
+    alias_method :rails_check_box, :check_box
+    private :rails_check_box
+
     def check_box(method, options = {}, checked_value = "1", unchecked_value = "0")
       super(method, control_options(method, options, "checkbox-input", @template.lc_checkbox_class), checked_value, unchecked_value)
     end
@@ -44,13 +73,14 @@ module Lostcoords::Ui
 
     # A checkbox drawn as a switch, with its label beside it.
     def switch(method, label: nil, hint: nil, checked_value: "1", unchecked_value: "0", **options)
-      input = check_box(method, { role: "switch", class: @template.lc_switch_class(extra: options.delete(:class)), data: { slot: "switch-input" } }.merge(options), checked_value, unchecked_value)
+      input = rails_check_box(method, control_options(method, { role: "switch" }.merge(options), "switch-input", @template.lc_switch_class, described: true), checked_value, unchecked_value)
       choice_label(method, label, hint, "switch", input)
     end
 
     # A checkbox with its label beside it.
     def choice(method, label: nil, hint: nil, checked_value: "1", unchecked_value: "0", **options)
-      choice_label(method, label, hint, "checkbox", check_box(method, options, checked_value, unchecked_value))
+      input = rails_check_box(method, control_options(method, options, "checkbox-input", @template.lc_checkbox_class, described: true), checked_value, unchecked_value)
+      choice_label(method, label, hint, "checkbox", input)
     end
 
     def label(method, text = nil, options = {}, &block)
@@ -68,36 +98,51 @@ module Lostcoords::Ui
       end
       variant = options.delete(:variant) || :primary
       size = options.delete(:size) || :md
-      super(value, options.merge(class: @template.lc_button_class(variant: variant, size: size, extra: options[:class])))
+      data = { slot: "button", variant: variant, size: size }.merge(options.delete(:data) || {})
+      super(value, options.merge(class: @template.lc_button_class(variant: variant, size: size, extra: options[:class]), data: data))
     end
 
     # Label, control, hint and the attribute's errors in one field. `as:` names the control helper;
-    # a block renders a custom control and receives its attributes to splat with `**control`.
-    def field(method, label: nil, hint: nil, as: :text_field, **options, &block)
+    # `as: :select` takes `choices:` and Rails' select options such as `include_blank:`. A block renders
+    # a custom control and receives its attributes to splat with `**control`.
+    def field(method, label: nil, hint: nil, as: :text_field, choices: nil, **options, &block)
       @template.lc_field(label: label || human_name(method), id: field_id(method), hint: hint, error: errors_for(method)) do |control|
-        if block
-          @template.capture(control, &block)
+        next @template.capture(control, &block) if block
+
+        attributes = @template.send(:lc_attributes, options.except(*SELECT_OPTIONS), control.to_hash.except(:id))
+        if as.to_sym == :select
+          select(method, choices, options.slice(*SELECT_OPTIONS), attributes)
         else
-          public_send(as, method, **options, **control.to_hash.except(:id))
+          public_send(as, method, attributes.merge(options.slice(*SELECT_OPTIONS)))
         end
       end
     end
 
     private
+      def without_field_error_wrapper
+        previous = @template.instance_variable_get(:@lc_skip_field_error_wrapper)
+        @template.instance_variable_set(:@lc_skip_field_error_wrapper, true)
+        yield
+      ensure
+        @template.instance_variable_set(:@lc_skip_field_error_wrapper, previous)
+      end
+
       def control_size!(options)
         options[:size].is_a?(Symbol) || options[:size].is_a?(String) && options[:size].match?(/\A[a-z]+\z/) ? options.delete(:size).to_sym : :md
       end
 
-      def control_options(method, options, slot, classes)
+      # described: points aria-describedby at the error a choice label renders, as lc_field does for its control.
+      def control_options(method, options, slot, classes, described: false)
         options = options.dup
         aria = (options.delete(:aria) || {}).dup
         aria[:invalid] = true if errors_for(method).any? && !aria.key?(:invalid)
+        aria[:describedby] = [ aria[:describedby], "#{field_id(method)}-error" ].compact.join(" ") if described && errors_for(method).any?
         data = { slot: slot }.merge(options.delete(:data) || {})
         options.merge(class: @template.lc_tw(classes, options[:class]), aria: aria, data: data)
       end
 
       def choice_label(method, text, hint, slot, input)
-        @template.send(:lc_choice_label, slot, text || human_name(method), hint, input, for: field_id(method))
+        @template.send(:lc_choice_label, slot, text || human_name(method), hint, input, errors: errors_for(method), error_id: "#{field_id(method)}-error", for: field_id(method))
       end
 
       def errors_for(method)

data/lib/lostcoords/ui/stylesheets.rb

@@ -0,0 +1,25 @@
+require "fileutils"
+require "pathname"
+
+module Lostcoords::Ui
+  # The Tailwind entries a host can import: the document defaults, core.css and one file per opt-in component.
+  module Stylesheets
+    ROOT = Pathname(File.expand_path("../../../app/assets/tailwind/lostcoords/ui", __dir__))
+
+    def self.entries
+      [ ROOT.join("base.css"), ROOT.join("core.css"), *ROOT.glob("components/*.css").sort ]
+    end
+
+    # tailwindcss-rails gives an engine one generated import, of engine.css. These proxies give every
+    # entry a stable path in the host, such as builds/tailwind/lostcoords_ui/components/dialog.css.
+    def self.write(builds)
+      directory = Pathname(builds).join("lostcoords_ui")
+      FileUtils.rm_rf(directory)
+      entries.each do |entry|
+        path = directory.join(entry.relative_path_from(ROOT))
+        FileUtils.mkdir_p(path.dirname)
+        path.write("/* Generated by lostcoords-ui before every Tailwind build; do not edit. */\n@import \"#{entry}\";\n")
+      end
+    end
+  end
+end

data/lib/lostcoords/ui/version.rb

@@ -1,5 +1,5 @@
 module Lostcoords
   module Ui
-    VERSION = "0.5.0"
+    VERSION = "0.7.0"
   end
 end

data/lib/tasks/lostcoords_ui.rake

@@ -13,3 +13,14 @@ namespace :lostcoords do
     end
   end
 end
+
+# Runs with tailwindcss-rails' own engines step, before every tailwindcss:build and tailwindcss:watch.
+# Apps without tailwindcss-rails import the gem's stylesheets by path instead.
+if defined?(Tailwindcss::Engines)
+  namespace :tailwindcss do
+    task :engines do
+      require "lostcoords/ui/stylesheets"
+      Lostcoords::Ui::Stylesheets.write(Rails.root.join("app/assets/builds/tailwind"))
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lostcoords-ui
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Lost Coordinates
@@ -90,20 +90,31 @@ files:
 - app/assets/tailwind/lostcoords/ui/card.css
 - app/assets/tailwind/lostcoords/ui/choice.css
 - app/assets/tailwind/lostcoords/ui/code-block.css
+- app/assets/tailwind/lostcoords/ui/collapsible.css
 - app/assets/tailwind/lostcoords/ui/components.css
+- app/assets/tailwind/lostcoords/ui/components/code-block.css
+- app/assets/tailwind/lostcoords/ui/components/collapsible.css
+- app/assets/tailwind/lostcoords/ui/components/dialog.css
+- app/assets/tailwind/lostcoords/ui/components/emoji-picker.css
+- app/assets/tailwind/lostcoords/ui/components/menu.css
+- app/assets/tailwind/lostcoords/ui/components/prose.css
+- app/assets/tailwind/lostcoords/ui/components/table.css
+- app/assets/tailwind/lostcoords/ui/components/toast.css
+- app/assets/tailwind/lostcoords/ui/components/tooltip.css
 - app/assets/tailwind/lostcoords/ui/copy-button.css
+- app/assets/tailwind/lostcoords/ui/core.css
 - app/assets/tailwind/lostcoords/ui/dialog.css
-- app/assets/tailwind/lostcoords/ui/disclosure.css
 - app/assets/tailwind/lostcoords/ui/emoji-picker.css
 - app/assets/tailwind/lostcoords/ui/field.css
 - app/assets/tailwind/lostcoords/ui/glass.css
 - app/assets/tailwind/lostcoords/ui/layout.css
 - app/assets/tailwind/lostcoords/ui/popover.css
-- app/assets/tailwind/lostcoords/ui/reading.css
+- app/assets/tailwind/lostcoords/ui/prose.css
 - app/assets/tailwind/lostcoords/ui/sheet.css
 - app/assets/tailwind/lostcoords/ui/squircle.css
 - app/assets/tailwind/lostcoords/ui/table.css
 - app/assets/tailwind/lostcoords/ui/theme.css
+- app/assets/tailwind/lostcoords/ui/toast.css
 - app/assets/tailwind/lostcoords/ui/tooltip.css
 - app/assets/tailwind/lostcoords/ui/typography.css
 - app/assets/tailwind/lostcoords/ui/ui.css
@@ -114,6 +125,7 @@ files:
 - app/helpers/lostcoords/ui/card_helper.rb
 - app/helpers/lostcoords/ui/choice_helper.rb
 - app/helpers/lostcoords/ui/code_block_helper.rb
+- app/helpers/lostcoords/ui/collapsible_helper.rb
 - app/helpers/lostcoords/ui/copy_button_helper.rb
 - app/helpers/lostcoords/ui/description_list_helper.rb
 - app/helpers/lostcoords/ui/dialog_helper.rb
@@ -125,7 +137,6 @@ files:
 - app/helpers/lostcoords/ui/layout_helper.rb
 - app/helpers/lostcoords/ui/menu_helper.rb
 - app/helpers/lostcoords/ui/navigation_helper.rb
-- app/helpers/lostcoords/ui/overlay_helper.rb
 - app/helpers/lostcoords/ui/primitives_helper.rb
 - app/helpers/lostcoords/ui/reading_helper.rb
 - app/helpers/lostcoords/ui/render_attributes_helper.rb
@@ -133,6 +144,8 @@ files:
 - app/helpers/lostcoords/ui/structures_helper.rb
 - app/helpers/lostcoords/ui/table_helper.rb
 - app/helpers/lostcoords/ui/tailwind_helper.rb
+- app/helpers/lostcoords/ui/toast_helper.rb
+- app/helpers/lostcoords/ui/tooltip_helper.rb
 - app/helpers/lostcoords/ui/translation_helper.rb
 - app/helpers/lostcoords/ui/typography_helper.rb
 - app/javascript/lostcoords/ui/controllers/lc_code_block_controller.js
@@ -141,12 +154,15 @@ files:
 - app/javascript/lostcoords/ui/controllers/lc_copy_controller.js
 - app/javascript/lostcoords/ui/controllers/lc_dialog_controller.js
 - app/javascript/lostcoords/ui/controllers/lc_emoji_picker_controller.js
+- app/javascript/lostcoords/ui/controllers/lc_kbd_controller.js
 - app/javascript/lostcoords/ui/controllers/lc_menu_controller.js
 - app/javascript/lostcoords/ui/controllers/lc_popover_controller.js
 - app/javascript/lostcoords/ui/controllers/lc_selection_controller.js
 - app/javascript/lostcoords/ui/controllers/lc_sheet_controller.js
+- app/javascript/lostcoords/ui/controllers/lc_shortcut_controller.js
 - app/javascript/lostcoords/ui/controllers/lc_tabs_controller.js
 - app/javascript/lostcoords/ui/controllers/lc_toast_controller.js
+- app/javascript/lostcoords/ui/controllers/lc_toast_region_controller.js
 - app/javascript/lostcoords/ui/controllers/lc_toggle_controller.js
 - app/javascript/lostcoords/ui/controllers/lc_tooltip_controller.js
 - app/javascript/lostcoords/ui/helpers/catalog_picker.js
@@ -155,7 +171,9 @@ files:
 - app/javascript/lostcoords/ui/helpers/dismiss_stack.js
 - app/javascript/lostcoords/ui/helpers/floating_panel.js
 - app/javascript/lostcoords/ui/helpers/menu_keys.js
+- app/javascript/lostcoords/ui/helpers/roving_focus.js
 - app/javascript/lostcoords/ui/helpers/sheet_motion.js
+- app/javascript/lostcoords/ui/helpers/shortcuts.js
 - app/javascript/lostcoords/ui/helpers/top_layer.js
 - app/javascript/lostcoords/ui/helpers/viewport.js
 - app/javascript/lostcoords/ui/index.js
@@ -168,7 +186,6 @@ files:
 - config/emoji_search_aliases.yml
 - config/emoji_search_names.yml
 - config/emoji_search_names_ja.yml
-- config/helper_renames.json
 - config/importmap.rb
 - config/locales/en.yml
 - config/locales/es.yml
@@ -184,10 +201,10 @@ files:
 - lib/lostcoords/ui/parts.rb
 - lib/lostcoords/ui/rails.rb
 - lib/lostcoords/ui/resources.rb
+- lib/lostcoords/ui/stylesheets.rb
 - lib/lostcoords/ui/tokens.rb
 - lib/lostcoords/ui/version.rb
 - lib/tasks/lostcoords_ui.rake
-- script/migrate_helpers.rb
 - vendor/heroicons/LICENSE
 - vendor/heroicons/icons.json
 homepage: https://github.com/lostcoords/ui

data/config/helper_renames.json

@@ -1,111 +0,0 @@
-{
-  "avatar_class": "lc_avatar_class",
-  "avatar_stack_class": "lc_avatar_stack_class",
-  "avatar_stack_row_class": "lc_avatar_stack_row_class",
-  "badge_class": "lc_badge_class",
-  "button_class": "lc_button_class",
-  "button_variants": "lc_button_variants",
-  "card_class": "lc_card_class",
-  "card_surface_class": "lc_card_class",
-  "container_class": "lc_container_class",
-  "dialog_class": "lc_dialog_class",
-  "dialog_kinds": "lc_dialog_kinds",
-  "dialog_surface_class": "lc_dialog_surface_class",
-  "dropdown_trigger_class": "lc_dropdown_trigger_class",
-  "emoji_picker_count": "lc_emoji_picker_count",
-  "emoji_picker_groups": "lc_emoji_picker_groups",
-  "emoji_picker_search_labels": "lc_emoji_picker_search_labels",
-  "emoji_picker_search_name": "lc_emoji_picker_search_name",
-  "emoji_picker_search_text": "lc_emoji_picker_search_text",
-  "emoji_picker_toneable?": "lc_emoji_picker_toneable?",
-  "emoji_picker_version": "lc_emoji_picker_version",
-  "empty_state_class": "lc_empty_state_class",
-  "field_class": "lc_field_class",
-  "field_label_class": "lc_field_label_class",
-  "form_actions_class": "lc_inline_class",
-  "form_alert_class": "lc_alert_class",
-  "form_alert_icon": "lc_alert_icon",
-  "form_card_class": "lc_card_class",
-  "glass_class": "lc_glass_class",
-  "heading_class": "lc_heading_class",
-  "heroicon": "lc_icon",
-  "icon_badge_class": "lc_icon_badge_class",
-  "icon_button_class": "lc_icon_button_class",
-  "icon_medallion_class": "lc_icon_badge_class",
-  "inline_class": "lc_inline_class",
-  "input_class": "lc_input_class",
-  "menu_option_class": "lc_menu_option_class",
-  "menu_popover_class": "lc_menu_popover_class",
-  "pill_class": "lc_toggle_class",
-  "pill_row_class": "lc_inline_class",
-  "popover_class": "lc_popover_class",
-  "prose_class": "lc_prose_class",
-  "section_header_class": "lc_section_header_class",
-  "segmented_class": "lc_toggle_group_class",
-  "segmented_tab_class": "lc_toggle_group_item_class",
-  "select_class": "lc_select_class",
-  "sheet_chip_class": "lc_sheet_chip_class",
-  "sheet_data": "lc_sheet_data",
-  "sheet_datetime_input_class": "lc_sheet_datetime_input_class",
-  "sheet_row_class": "lc_sheet_row_class",
-  "sheet_row_label_class": "lc_sheet_row_label_class",
-  "sheet_text_input_class": "lc_sheet_text_input_class",
-  "skeleton_class": "lc_skeleton_class",
-  "spinner_class": "lc_spinner_class",
-  "stack_class": "lc_stack_class",
-  "status_pill_class": "lc_badge_class",
-  "text_class": "lc_text_class",
-  "textarea_class": "lc_textarea_class",
-  "tw": "lc_tw",
-  "ui_attributes": "lc_attributes",
-  "ui_avatar": "lc_avatar",
-  "ui_avatar_stack": "lc_avatar_stack",
-  "ui_badge": "lc_badge",
-  "ui_button": "lc_button",
-  "ui_button_attributes": "lc_button_attributes",
-  "ui_button_content": "lc_button_content",
-  "ui_button_link_to": "lc_button_link_to",
-  "ui_button_to": "lc_button_to",
-  "ui_card": "lc_card",
-  "ui_card_surface": "lc_card",
-  "ui_container": "lc_container",
-  "ui_copy_button": "lc_copy_button",
-  "ui_copy_content": "lc_copy_content",
-  "ui_dialog": "lc_dialog",
-  "ui_disclosure": "lc_collapsible",
-  "ui_emoji_picker": "lc_emoji_picker",
-  "ui_empty_state": "lc_empty_state",
-  "ui_field": "lc_field",
-  "ui_form_actions": "lc_inline",
-  "ui_form_alert": "lc_alert",
-  "ui_form_card": "lc_card",
-  "ui_heading": "lc_heading",
-  "ui_icon_badge": "lc_icon_badge",
-  "ui_icon_button": "lc_icon_button",
-  "ui_inline": "lc_inline",
-  "ui_input": "lc_input",
-  "ui_label!": "lc_label!",
-  "ui_medallion": "lc_icon_badge",
-  "ui_menu": "lc_menu",
-  "ui_menu_option": "lc_menu_option",
-  "ui_normalize_attributes": "lc_normalize_attributes",
-  "ui_option!": "lc_option!",
-  "ui_pill": "lc_toggle",
-  "ui_pill_row": "lc_inline",
-  "ui_popover": "lc_popover",
-  "ui_prose": "lc_prose",
-  "ui_render_dialog": "lc_render_dialog",
-  "ui_render_panel": "lc_render_panel",
-  "ui_section": "lc_section",
-  "ui_segmented": "lc_toggle_group",
-  "ui_segmented_tab": "lc_toggle_group_item",
-  "ui_select": "lc_select",
-  "ui_sheet": "lc_dialog",
-  "ui_skeleton": "lc_skeleton",
-  "ui_spinner": "lc_spinner",
-  "ui_stack": "lc_stack",
-  "ui_status_pill": "lc_badge",
-  "ui_text": "lc_text",
-  "ui_textarea": "lc_textarea",
-  "ui_toast": "lc_toast"
-}

data/script/migrate_helpers.rb

@@ -1,136 +0,0 @@
-#!/usr/bin/env ruby
-
-require "json"
-require "find"
-require "optparse"
-require "ripper"
-
-module HelperMigration
-  LIBRARY = File.expand_path("..", __dir__)
-  NAMES = JSON.parse(File.read(File.join(LIBRARY, "config/helper_renames.json"))).freeze
-  PARTIALS = %w[dialog disclosure].to_h do |name|
-    [ "lostcoords/ui/components/ui_#{name}", "lostcoords/ui/components/lc_#{name}" ]
-  end.freeze
-
-  def self.method_locations(node, locations = {})
-    return locations unless node.is_a?(Array)
-
-    name = case node.first
-    when :def, :vcall, :fcall, :command, :symbol then node[1]
-    when :defs, :call, :command_call then node[3]
-    end
-    locations[name[2]] = true if name.is_a?(Array) && name.first == :@ident
-    node.each { |child| method_locations(child, locations) }
-    locations
-  end
-
-  def self.rewrite(source, program: source, prefix_lines: 0)
-    syntax = Ripper.sexp(program)
-    raise ArgumentError, "Cannot parse Ruby source for helper migration" unless syntax
-
-    methods = method_locations(syntax)
-    offsets = [ 0 ]
-    source.each_line { |line| offsets << offsets.last + line.bytesize }
-    contexts = []
-    edits = Ripper.lex(program).filter_map do |position, type, value, _|
-      replacement = case type
-      when :on_ident then NAMES[value] if methods[position]
-      when :on_tstring_content then contexts.last == :symbol ? NAMES[value] : PARTIALS[value]
-      end
-      case type
-      when :on_symbeg then contexts << :symbol unless value == ":"
-      when :on_qsymbols_beg, :on_symbols_beg then contexts << :symbol
-      when :on_tstring_beg, :on_heredoc_beg, :on_qwords_beg, :on_words_beg, :on_regexp_beg then contexts << :string
-      when :on_tstring_end, :on_heredoc_end, :on_regexp_end then contexts.pop
-      end
-      line = position[0] - prefix_lines
-      [ offsets.fetch(line - 1) + position[1], value.bytesize, replacement ] if replacement && line.positive?
-    end
-    updated = source.b
-    edits.reverse_each { |offset, length, value| updated[offset, length] = value.b }
-    updated.force_encoding(source.encoding)
-  end
-
-  def self.ruby(source)
-    rewrite(source)
-  end
-
-  def self.erb(source)
-    program = source.b.gsub(/[^\r\n]/n, " ")
-    source.to_enum(:scan, /(<%(?!%)(?:==?|-)?)(.*?)(-?%>)/m).each do
-      match = Regexp.last_match
-      opening, body, closing = match.captures
-      next if body.start_with?("#")
-
-      start = match.pre_match.bytesize + opening.bytesize
-      program[start, body.bytesize] = body.b
-      program[start + body.bytesize, closing.bytesize] = ";" + " " * (closing.bytesize - 1)
-    end
-    signature = source[/<%#\s*locals:\s*\((.*?)\)\s*%>/m, 1]
-    prefix = "def __template(#{signature})\n"
-    suffix = "\nend"
-    rewrite(source, program: prefix + program.force_encoding(source.encoding) + suffix, prefix_lines: prefix.count("\n"))
-  end
-
-  def self.markdown(source)
-    source = source.gsub(/(^```(ruby|rb|erb)[^\n]*\n)(.*?)(^```[ \t]*$)/m) do
-      opening, language, body, closing = Regexp.last_match.captures
-      "#{opening}#{language == 'erb' ? erb(body) : ruby(body)}#{closing}"
-    end
-    source.gsub(/`([^`\n]+)`/) { |match| NAMES.key?(Regexp.last_match[1]) ? "`#{NAMES.fetch(Regexp.last_match[1])}`" : match }
-  end
-
-  def self.changes(root)
-    files = Find.find(root).filter_map do |path|
-      next if File.symlink?(path)
-      if File.directory?(path)
-        name = File.basename(path)
-        Find.prune if path != root && (name.start_with?(".") || %w[node_modules vendor tmp log storage pkg coverage builds dist].include?(name))
-        next
-      end
-      path.delete_prefix("#{root}/")
-    end
-    files.sort.filter_map do |relative|
-      path = File.join(root, relative)
-      next if File.symlink?(path) || relative.start_with?("vendor/")
-      next if root == LIBRARY && (relative == "README.md" || relative.start_with?("docs/", "plans/"))
-
-      extension = File.extname(path)
-      next unless %w[.rb .erb .md].include?(extension) || extension.empty?
-
-      source = File.binread(path).force_encoding(Encoding::UTF_8)
-      updated = case extension
-      when ".rb" then ruby(source)
-      when ".erb" then erb(source)
-      when ".md" then markdown(source)
-      else ruby(source) if source.lines.first&.match?(/\A#!.*ruby/)
-      end
-      next unless updated
-
-      name = File.basename(path).sub(/\A_ui_(dialog|disclosure)\.html\.erb\z/, '_lc_\1.html.erb')
-      destination = File.join(File.dirname(path), name)
-      abort "Refusing to overwrite #{destination}" if destination != path && (File.exist?(destination) || File.symlink?(destination))
-      [ path, destination, updated ] if updated != source || destination != path
-    end
-  end
-end
-
-if $PROGRAM_NAME == __FILE__
-  write = false
-  OptionParser.new do |options|
-    options.banner = "Usage: ruby migrate_helpers.rb [checkout] [--write]"
-    options.on("--write", "Apply the migration after checking every destination") { write = true }
-  end.parse!
-  abort "Expected one checkout path" if ARGV.size > 1
-  root = File.realpath(ARGV.first || Dir.pwd)
-  changes = HelperMigration.changes(root)
-  changes.each do |path, destination, source|
-    puts path.delete_prefix("#{root}/")
-    next unless write
-
-    File.binwrite(path, source)
-    File.rename(path, destination) unless path == destination
-  end
-  puts "#{changes.size} files #{write ? 'updated' : 'would change'}"
-  exit 1 if changes.any? && !write
-end