lostcoords-ui 0.4.1

data/config/helper_renames.json

@@ -0,0 +1,113 @@
+{
+  "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_surface_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",
+  "eyebrow_class": "lc_eyebrow_class",
+  "field_class": "lc_field_class",
+  "field_label_class": "lc_field_label_class",
+  "form_actions_class": "lc_form_actions_class",
+  "form_alert_class": "lc_form_alert_class",
+  "form_alert_icon": "lc_form_alert_icon",
+  "form_card_class": "lc_form_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_medallion_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_pill_class",
+  "pill_row_class": "lc_pill_row_class",
+  "popover_class": "lc_popover_class",
+  "prose_class": "lc_prose_class",
+  "section_header_class": "lc_section_header_class",
+  "segmented_class": "lc_segmented_class",
+  "segmented_tab_class": "lc_segmented_tab_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_status_pill_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_surface",
+  "ui_container": "lc_container",
+  "ui_copy_button": "lc_copy_button",
+  "ui_copy_content": "lc_copy_content",
+  "ui_dialog": "lc_dialog",
+  "ui_disclosure": "lc_disclosure",
+  "ui_emoji_picker": "lc_emoji_picker",
+  "ui_empty_state": "lc_empty_state",
+  "ui_eyebrow": "lc_eyebrow",
+  "ui_field": "lc_field",
+  "ui_form_actions": "lc_form_actions",
+  "ui_form_alert": "lc_form_alert",
+  "ui_form_card": "lc_form_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_medallion",
+  "ui_menu": "lc_menu",
+  "ui_menu_option": "lc_menu_option",
+  "ui_normalize_attributes": "lc_normalize_attributes",
+  "ui_option!": "lc_option!",
+  "ui_pill": "lc_pill",
+  "ui_pill_row": "lc_pill_row",
+  "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_segmented",
+  "ui_segmented_tab": "lc_segmented_tab",
+  "ui_select": "lc_select",
+  "ui_sheet": "lc_sheet",
+  "ui_skeleton": "lc_skeleton",
+  "ui_spinner": "lc_spinner",
+  "ui_stack": "lc_stack",
+  "ui_status_pill": "lc_status_pill",
+  "ui_text": "lc_text",
+  "ui_textarea": "lc_textarea",
+  "ui_toast": "lc_toast"
+}

data/config/importmap.rb

@@ -0,0 +1,3 @@
+# Keys match the host's own helpers/ and controllers/ pins, so imports and stimulus-loading resolve the same way.
+pin_all_from Lostcoords::Ui::Engine.root.join("app/javascript/lostcoords/ui/controllers"), under: "controllers", to: "lostcoords/ui/controllers", preload: false
+pin_all_from Lostcoords::Ui::Engine.root.join("app/javascript/lostcoords/ui/helpers"), under: "helpers", to: "lostcoords/ui/helpers", preload: false

data/config/locales/en.yml

@@ -0,0 +1,33 @@
+en:
+  lostcoords:
+    ui:
+      copy_button:
+        label: "Copy"
+        copied: "Copied"
+        retry: "Retry"
+        error: "Could not copy. Select the text and copy it manually."
+      emoji_picker:
+        recently_used: "Recently used"
+        search_label: "Search emoji"
+        search_placeholder: "Search emoji"
+        no_results: "No emoji found."
+        search_results: "Search results"
+        categories_nav: "Emoji categories"
+        skin_tone: "Skin tone"
+        skin_tones:
+          default: "Default"
+          light: "Light"
+          medium_light: "Medium-light"
+          medium: "Medium"
+          medium_dark: "Medium-dark"
+          dark: "Dark"
+        categories:
+          smileys_emotion: "Smileys & Emotion"
+          people_body: "People & Body"
+          animals_nature: "Animals & Nature"
+          food_drink: "Food & Drink"
+          travel_places: "Travel & Places"
+          activities: "Activities"
+          objects: "Objects"
+          symbols: "Symbols"
+          flags: "Flags"

data/config/locales/es.yml

@@ -0,0 +1,33 @@
+es:
+  lostcoords:
+    ui:
+      copy_button:
+        label: "Copiar"
+        copied: "Copiado"
+        retry: "Reintentar"
+        error: "No se pudo copiar. Selecciona el texto y cópialo manualmente."
+      emoji_picker:
+        recently_used: "Usados recientemente"
+        search_label: "Buscar emoji"
+        search_placeholder: "Buscar emoji"
+        no_results: "No se encontraron emojis."
+        search_results: "Resultados"
+        categories_nav: "Categorías de emojis"
+        skin_tone: "Tono de piel"
+        skin_tones:
+          default: "Predeterminado"
+          light: "Claro"
+          medium_light: "Medio claro"
+          medium: "Medio"
+          medium_dark: "Medio oscuro"
+          dark: "Oscuro"
+        categories:
+          smileys_emotion: "Caras y emociones"
+          people_body: "Personas y cuerpo"
+          animals_nature: "Animales y naturaleza"
+          food_drink: "Comida y bebida"
+          travel_places: "Viajes y lugares"
+          activities: "Actividades"
+          objects: "Objetos"
+          symbols: "Símbolos"
+          flags: "Banderas"

data/config/locales/ja.yml

@@ -0,0 +1,33 @@
+ja:
+  lostcoords:
+    ui:
+      copy_button:
+        label: "コピー"
+        copied: "コピー済み"
+        retry: "再試行"
+        error: "コピーできませんでした。テキストを選択して手動でコピーしてください。"
+      emoji_picker:
+        recently_used: "最近使った絵文字"
+        search_label: "絵文字を検索"
+        search_placeholder: "絵文字を検索"
+        no_results: "一致する絵文字がありません。"
+        search_results: "検索結果"
+        categories_nav: "絵文字のカテゴリ"
+        skin_tone: "肌の色"
+        skin_tones:
+          default: "標準"
+          light: "薄い"
+          medium_light: "やや薄い"
+          medium: "中間"
+          medium_dark: "やや濃い"
+          dark: "濃い"
+        categories:
+          smileys_emotion: "表情と感情"
+          people_body: "人と体"
+          animals_nature: "動物と自然"
+          food_drink: "食べ物と飲み物"
+          travel_places: "旅行と場所"
+          activities: "アクティビティ"
+          objects: "もの"
+          symbols: "記号"
+          flags: "旗"

data/lib/lostcoords/ui/action_view.rb

@@ -0,0 +1,10 @@
+require "bigdecimal"
+require "action_view"
+require "active_support/core_ext/hash"
+require "active_support/core_ext/object/blank"
+require "tailwind_merge"
+require "lostcoords/ui/resources"
+require "lostcoords/ui/icons"
+require "lostcoords/ui/helpers"
+
+Lostcoords::Ui.load_translations!

data/lib/lostcoords/ui/builders.rb

@@ -0,0 +1,42 @@
+require "prism"
+require_relative "version"
+
+module Lostcoords::Ui
+  module Builders
+    HELPERS = File.expand_path("../../../app/helpers/lostcoords/ui", __dir__)
+
+    Builder = Data.define(:helper, :name, :parameters, :path, :line) do
+      def signature = parameters ? "#{name}(#{parameters})" : name.to_s
+
+      def component?
+        !name.to_s.end_with?("_class") &&
+          !%i[lc_tw lc_sheet_data lc_form_alert_icon].include?(name) &&
+          helper != "EmojiPickerHelper"
+      end
+    end
+
+    def self.all
+      definitions.reject(&:component?)
+    end
+
+    def self.definitions
+      Dir["#{HELPERS}/*_helper.rb"].sort.flat_map { |path| public_instance_methods_in(path) }
+    end
+
+    def self.markdown
+      all.map { |builder| "- `#{builder.signature}` (#{builder.helper})" }.join("\n")
+    end
+
+    def self.public_instance_methods_in(path)
+      namespace = Prism.parse_file(path).value.statements.body.grep(Prism::ModuleNode).first
+      helper = namespace.body.body.first
+      visible = true
+      helper.body.body.filter_map do |node|
+        visible = false if node.is_a?(Prism::CallNode) && node.name == :private && node.arguments.nil?
+        next unless visible && node.is_a?(Prism::DefNode) && node.receiver.nil?
+
+        Builder.new(helper.constant_path.slice, node.name, node.parameters&.slice, path, node.location.start_line)
+      end
+    end
+  end
+end

data/lib/lostcoords/ui/components.rb

@@ -0,0 +1,13 @@
+require_relative "builders"
+
+module Lostcoords::Ui
+  module Components
+    def self.all
+      Builders.definitions.select(&:component?)
+    end
+
+    def self.markdown
+      all.map { |component| "- `#{component.signature}`" }.join("\n")
+    end
+  end
+end

data/lib/lostcoords/ui/engine.rb

@@ -0,0 +1,22 @@
+module Lostcoords::Ui
+  class Engine < ::Rails::Engine
+    isolate_namespace Lostcoords::Ui
+
+    initializer "lostcoords.ui.assets" do |app|
+      next unless app.config.respond_to?(:assets)
+
+      app.config.assets.paths << root.join("app/javascript")
+    end
+
+    initializer "lostcoords.ui.importmap", before: "importmap" do |app|
+      next unless app.config.respond_to?(:importmap)
+
+      app.config.importmap.paths << root.join("config/importmap.rb")
+      app.config.importmap.cache_sweepers << root.join("app/javascript")
+    end
+
+    initializer "lostcoords.ui.helpers" do
+      ActiveSupport.on_load(:action_view) { include Lostcoords::Ui::Helpers }
+    end
+  end
+end

data/lib/lostcoords/ui/helpers.rb

@@ -0,0 +1,11 @@
+module Lostcoords::Ui
+  module Helpers
+    paths = Dir[Lostcoords::Ui.root.join("app/helpers/lostcoords/ui/*_helper.rb")].sort_by do |path|
+      [ %w[tailwind_helper.rb button_helper.rb].index(File.basename(path)) || 2, path ]
+    end
+    paths.each do |path|
+      require path
+      include Lostcoords::Ui.const_get(File.basename(path, ".rb").camelize)
+    end
+  end
+end

data/lib/lostcoords/ui/icons.rb

@@ -0,0 +1,24 @@
+require "json"
+require "nokogiri"
+
+module Lostcoords::Ui
+  module Icons
+    TEMPLATES = {}
+    LOCK = Mutex.new
+
+    def self.fetch(name, variant)
+      LOCK.synchronize do
+        @catalog ||= JSON.parse(File.read(Lostcoords::Ui.root.join("vendor/heroicons/icons.json")), freeze: true).fetch("icons")
+        source = @catalog.fetch(variant.to_s).fetch(name.to_s)
+        template = TEMPLATES[source] ||= begin
+          document = Nokogiri::XML(source) { |config| config.strict.nonet }
+          document.xpath("//text()[normalize-space(.) = '']").remove
+          document
+        end
+        template.dup.root
+      end
+    rescue KeyError
+      raise ArgumentError, "Unknown Heroicon #{name.inspect} with variant #{variant.inspect}"
+    end
+  end
+end

data/lib/lostcoords/ui/rails.rb

@@ -0,0 +1,3 @@
+require "rails/engine"
+require "lostcoords/ui/action_view"
+require "lostcoords/ui/engine"

data/lib/lostcoords/ui/resources.rb

@@ -0,0 +1,17 @@
+require "pathname"
+require_relative "version"
+
+module Lostcoords::Ui
+  def self.root
+    @root ||= Pathname.new(File.expand_path("../../..", __dir__)).freeze
+  end
+
+  def self.view_paths
+    [ root.join("app/views").to_s ]
+  end
+
+  def self.load_translations!
+    paths = (Dir[root.join("config/locales/*.yml")] + I18n.load_path).uniq
+    I18n.load_path = paths unless I18n.load_path == paths
+  end
+end

data/lib/lostcoords/ui/tokens.rb

@@ -0,0 +1,14 @@
+require_relative "version"
+
+module Lostcoords::Ui
+  module Tokens
+    THEME_PATH = File.expand_path("../../../app/assets/tailwind/lostcoords/ui/theme.css", __dir__)
+    DECLARATION = /(?<![\w-])(--[\w-]+)\s*:/
+
+    def self.names
+      File.read(THEME_PATH).scan(DECLARATION).flatten.uniq.sort
+    end
+  end
+
+  TOKENS = Tokens.names.freeze
+end

data/lib/lostcoords/ui/version.rb

@@ -0,0 +1,5 @@
+module Lostcoords
+  module Ui
+    VERSION = "0.4.1"
+  end
+end

data/lib/lostcoords/ui.rb

@@ -0,0 +1,2 @@
+require "lostcoords/ui/action_view"
+require "lostcoords/ui/rails" if defined?(::Rails::Engine)

data/lib/tasks/lostcoords_ui.rake

@@ -0,0 +1,15 @@
+namespace :lostcoords do
+  namespace :ui do
+    desc "Print the component rendering helpers and their signatures"
+    task :components do
+      require "lostcoords/ui/components"
+      puts Lostcoords::Ui::Components.markdown
+    end
+
+    desc "Print the style builders and their signatures"
+    task :builders do
+      require "lostcoords/ui/builders"
+      puts Lostcoords::Ui::Builders.markdown
+    end
+  end
+end

data/script/migrate_helpers.rb

@@ -0,0 +1,136 @@
+#!/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

data/vendor/heroicons/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Tailwind Labs, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+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.