ariadne_view_components 0.0.6 → 0.0.9

data/app/lib/ariadne/form_builder.rb

@@ -5,64 +5,64 @@ module Ariadne
   class FormBuilder < ActionView::Helpers::FormBuilder
     include ClassNameHelper
 
-    DEFAULT_SECTION_CLASSES = "pt-8 space-y-6 sm:pt-10 sm:space-y-5"
+    DEFAULT_SECTION_CLASSES = "ariadne-pt-8 ariadne-space-y-6 sm:ariadne-pt-10 sm:ariadne-space-y-5"
     def section(classes: "", attributes: {}, &block)
       actual_classes = class_names(DEFAULT_SECTION_CLASSES, classes)
       options = { class: actual_classes, **attributes }
       @template.content_tag(:div, **options, &block)
     end
 
-    DEFAULT_SECTION_HEADING_CLASSES = "text-lg leading-6 font-medium text-gray-900"
+    DEFAULT_SECTION_HEADING_CLASSES = "ariadne-text-lg ariadne-leading-6 ariadne-font-medium ariadne-text-gray-900"
     def heading(tag: :h3, classes: "", attributes: {}, &block)
       actual_classes = class_names(DEFAULT_SECTION_HEADING_CLASSES, classes)
       options = { class: actual_classes, **attributes }
       @template.content_tag(tag, **options, &block)
     end
 
-    DEFAULT_SECTION_SUBHEADING_CLASSES = "mt-1 max-w-2xl text-sm text-gray-500"
+    DEFAULT_SECTION_SUBHEADING_CLASSES = "ariadne-mt-1 ariadne-max-w-2xl ariadne-text-sm ariadne-text-gray-500"
     def subheading(classes: "", attributes: {}, &block)
       actual_classes = class_names(DEFAULT_SECTION_SUBHEADING_CLASSES, classes)
       options = { class: actual_classes, **attributes }
       @template.content_tag(:p, **options, &block)
     end
 
-    DEFAULT_LABEL_CLASSES = "block text-sm font-medium text-gray-700 pl-2"
+    DEFAULT_LABEL_CLASSES = "ariadne-block ariadne-text-sm ariadne-font-medium ariadne-text-gray-700 ariadne-pl-2"
     def label(object_name, content, ptions = {}, &block)
       options[:class] = class_names(DEFAULT_LABEL_CLASSES, options.delete(:classes))
       super(object_name, content, options, &block)
     end
 
-    DEFAULT_TEXT_CLASSES = "shadow-sm focus:ring-indigo-500 focus:border-indigo-500 block w-full sm:text-sm border-gray-300 rounded-md"
+    DEFAULT_TEXT_CLASSES = "ariadne-shadow-sm focus:ariadne-ring-indigo-500 focus:ariadne-border-indigo-500 ariadne-block ariadne-w-full sm:ariadne-text-sm ariadne-border-gray-300 ariadne-rounded-md"
     def text_field(method, options = {})
       options[:class] = class_names(DEFAULT_TEXT_CLASSES, options.delete(:classes))
       super(method, **options)
     end
 
-    DEFAULT_CHECKBOX_CLASSES = "focus:ring-indigo-500 h-4 w-4 text-indigo-600 border-gray-300 rounded"
+    DEFAULT_CHECKBOX_CLASSES = "focus:ariadne-ring-indigo-500 ariadne-h-4 ariadne-w-4 ariadne-text-indigo-600 ariadne-border-gray-300 ariadne-rounded"
     def check_box(method, options = {}, checked_value = "1", unchecked_value = "0")
       options[:class] = class_names(DEFAULT_CHECKBOX_CLASSES, options.delete(:classes))
       super(method, options, checked_value, unchecked_value)
     end
 
-    DEFAULT_RADIO_CLASSES = "focus:ring-indigo-500 h-4 w-4 text-indigo-600 border-gray-300 rounded"
+    DEFAULT_RADIO_CLASSES = "focus:ariadne-ring-indigo-500 ariadne-h-4 ariadne-w-4 ariadne-text-indigo-600 ariadne-border-gray-300 ariadne-rounded"
     def radio_button(method, tag_value, options = {})
       options[:class] = class_names(DEFAULT_RADIO_CLASSES, options.delete(:classes))
       super(method, tag_value, **options)
     end
 
-    DEFAULT_TEXTAREA_CLASSES = "shadow-sm focus:ring-indigo-500 focus:border-indigo-500 block w-full sm:text-sm border border-gray-300 rounded-md"
+    DEFAULT_TEXTAREA_CLASSES = "ariadne-shadow-sm focus:ariadne-ring-indigo-500 focus:ariadne-border-indigo-500 ariadne-block ariadne-w-full sm:ariadne-text-sm ariadne-border ariadne-border-gray-300 ariadne-rounded-md"
     def text_area(method, options = {})
       options[:class] = class_names(DEFAULT_TEXTAREA_CLASSES, options.delete(:classes))
       super(method, **options)
     end
 
-    DEFAULT_EMAIL_CLASSES = "shadow-sm focus:ring-indigo-500 focus:border-indigo-500 block w-full sm:text-sm border-gray-300 rounded-md"
+    DEFAULT_EMAIL_CLASSES = "ariadne-shadow-sm focus:ariadne-ring-indigo-500 focus:ariadne-border-indigo-500 ariadne-block ariadne-w-full sm:ariadne-text-sm ariadne-border-gray-300 ariadne-rounded-md"
     def email_field(method, options = {})
       options[:class] = class_names(DEFAULT_EMAIL_CLASSES, options.delete(:classes))
       super(method, **options)
     end
 
-    DEFAULT_PASSWORD_CLASSES = "appearance-none block w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm placeholder-gray-400 focus:outline-none focus:ring-indigo-500 focus:border-indigo-500 sm:text-sm"
+    DEFAULT_PASSWORD_CLASSES = "ariadne-appearance-none ariadne-block ariadne-w-full ariadne-px-3 ariadne-py-2 ariadne-border ariadne-border-gray-300 ariadne-rounded-md ariadne-shadow-sm ariadne-placeholder-gray-400 focus:ariadne-outline-none focus:ariadne-ring-indigo-500 focus:ariadne-border-indigo-500 sm:ariadne-text-sm"
     def password_field(method, options = {})
       options[:class] = class_names(DEFAULT_PASSWORD_CLASSES, options.delete(:classes))
       super(method, **options)

data/app/lib/ariadne/icon_helper.rb

@@ -23,7 +23,7 @@ module Ariadne
 
       icon_presence!(icon, variant)
       variant_presence!(icon, variant)
-      fetch_or_raise(HeroiconsHelper::Icon::VARIANTS, variant)
+      fetch_or_raise(HeroiconsHelper::Icon::VALID_VARIANTS, variant)
 
       true
     end

data/exe/tailwindcss

@@ -0,0 +1,21 @@
+#! /usr/bin/env ruby
+# frozen_string_literal: true
+
+# because rubygems shims assume a gem's executables are Ruby
+
+require "ariadne/view_components/commands"
+
+begin
+  command = [Ariadne::ViewComponents::Commands.executable, *ARGV]
+  puts command.inspect
+  if Gem.win_platform?
+    # use system rather than exec as exec inexplicably fails to find the executable on Windows
+    # see related https://github.com/rubys/sprockets-esbuild/pull/4
+    system(*command, exception: true)
+  else
+    exec(*command)
+  end
+rescue Ariadne::ViewComponents::Commands::UnsupportedPlatformException, Ariadne::ViewComponents::Commands::ExecutableNotFoundException => e
+  $stderr.puts("ERROR: " + e.message)
+  exit(1)
+end

data/lib/ariadne/view_components/commands.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require_relative "upstream"
+
+module Ariadne
+  module ViewComponents
+    # commands related to the upstream Tailwindcss project
+    module Commands
+      # raised when the host platform is not supported by upstream tailwindcss's binary releases
+      class UnsupportedPlatformException < StandardError
+      end
+
+      # raised when the tailwindcss executable could not be found where we expected it to be
+      class ExecutableNotFoundException < StandardError
+      end
+
+      class << self
+        def platform
+          [:cpu, :os].map { |m| Gem::Platform.local.send(m) }.join("-")
+        end
+
+        def executable(
+          exe_path: File.expand_path(File.join(__dir__, "..", "..", "exe"))
+        )
+          if Ariadne::ViewComponents::Upstream::NATIVE_PLATFORMS.keys.none? { |p| Gem::Platform.match(p) }
+            raise UnsupportedPlatformException, <<~MESSAGE
+              ariadne_view_components does not support the #{platform} platform
+              Please install tailwindcss following instructions at https://tailwindcss.com/docs/installation
+            MESSAGE
+          end
+
+          exe_path = Dir.glob(File.expand_path(File.join(exe_path, "*", "tailwindcss"))).find do |f|
+            Gem::Platform.match(File.basename(File.dirname(f)))
+          end
+
+          if exe_path.nil?
+            raise ExecutableNotFoundException, <<~MESSAGE
+              Cannot find the tailwindcss executable for #{platform} in #{exe_path}
+
+              If you're using bundler, please make sure you're on the latest bundler version:
+
+                  gem install bundler
+                  bundle update --bundler
+
+              Then make sure your lock file includes this platform by running:
+
+                  bundle lock --add-platform #{platform}
+                  bundle install
+
+              See `bundle lock --help` output for details.
+
+              If you're still seeing this message after taking those steps, try running
+              `bundle config` and ensure `force_ruby_platform` isn't set to `true`. See
+              https://github.com/rails/tailwindcss-rails#check-bundle_force_ruby_platform
+              for more details.
+            MESSAGE
+          end
+
+          exe_path
+        end
+
+        def compile_command(debug: false, **kwargs)
+          [
+            executable(**kwargs),
+            "-i", relative_path("app/assets/stylesheets/ariadne_view_components.css"),
+            "-o", relative_path("app/assets/builds/ariadne_view_components.css"),
+            "-c", relative_path("tailwind.config.js"),
+          ].tap do |command|
+            command << "--minify" unless debug
+          end
+        end
+
+        def watch_command(poll: false, **kwargs)
+          compile_command(**kwargs).tap do |command|
+            command << "-w"
+            command << "-p" if poll
+          end
+        end
+
+        def relative_path(path)
+          if defined?(Rails)
+            Rails.root.join(path).to_s
+          else
+            path
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ariadne/view_components/engine.rb

@@ -3,14 +3,21 @@
 require "rails/engine"
 
 require "view_component"
-require "ariadne/classify/utilities"
+
+require "tailwind_merge"
 
 module Ariadne
+  # The Ariadne gem is a collection of ViewComponents that can be used to build
+  # accessible, responsive, and consistent UIs for Yetto.
   module ViewComponents
+    mattr_accessor :tailwind_merger
+
     # :nodoc:
     class Engine < ::Rails::Engine
       isolate_namespace Ariadne::ViewComponents
-      config.eager_load_paths = ["#{root}/app/components", "#{root}/app/lib"]
+
+      config.autoload_paths = ["#{root}/lib"]
+      config.eager_load_paths = ["#{root}/app/components", "#{root}/app/helpers", "#{root}/app/lib"]
 
       config.ariadne_view_components = ActiveSupport::OrderedOptions.new
 
@@ -30,8 +37,38 @@ module Ariadne
         end
       end
 
-      config.after_initialize do |app|
-        ::Ariadne::Classify::Utilities.validate_class_names = app.config.ariadne_view_components.delete(:validate_class_names)
+      initializer "ariadne_view_components.zeitwerk_ignore" do
+        Rails.autoloaders.each do |autoloader|
+          autoloader.ignore(Engine.root.join("lib", "ariadne", "view_components", "linters.rb"))
+          autoloader.ignore(Engine.root.join("lib", "ariadne", "view_components", "linters", "**", "*.rb"))
+          autoloader.ignore(Engine.root.join("lib", "ariadne", "view_components", "statuses.rb"))
+        end
+      end
+
+      config.after_initialize do |_app|
+        # TODO: is any of this necessary???
+        ActionView::Base.field_error_proc = proc do |html_tag, instance_tag|
+          fragment = Nokogiri::HTML.fragment(html_tag)
+          field = fragment.at("input,select,textarea")
+
+          model = instance_tag.object
+          error_message = model.errors.full_messages.join(", ")
+
+          html = if field
+            field["class"] = "#{field["class"]} invalid"
+            html = <<-HTML
+                      #{fragment}
+                      <p class="error">#{error_message}</p>
+            HTML
+            html
+          else
+            html_tag
+          end
+
+          html.html_safe # rubocop:disable Rails/OutputSafety
+        end
+
+        Ariadne::ViewComponents.tailwind_merger = TailwindMerge::Merger.new
       end
     end
   end

data/lib/ariadne/view_components/upstream.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Ariadne
+  module ViewComponents
+    # constants describing the upstream tailwindcss project
+    module Upstream
+      VERSION = "v3.1.8"
+
+      # rubygems platform name => upstream release filename
+      NATIVE_PLATFORMS = {
+        "arm64-darwin" => "tailwindcss-macos-arm64",
+        "x64-mingw32" => "tailwindcss-windows-x64.exe",
+        "x64-mingw-ucrt" => "tailwindcss-windows-x64.exe",
+        "x86_64-darwin" => "tailwindcss-macos-x64",
+        "x86_64-linux" => "tailwindcss-linux-x64",
+        "aarch64-linux" => "tailwindcss-linux-arm64",
+      }
+    end
+  end
+end

data/lib/ariadne/view_components/version.rb

@@ -2,6 +2,6 @@
 
 module Ariadne
   module ViewComponents
-    VERSION = "0.0.6"
+    VERSION = "0.0.9"
   end
 end

data/lib/ariadne/view_components.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-require "ariadne/classify"
 require "ariadne/view_components/version"
 require "ariadne/view_components/engine"
 require "ariadne/view_components/constants"
+require "ariadne/view_components/commands"
 
 module Ariadne
   # :nodoc:

data/lib/rubocop/config/default.yml

@@ -4,11 +4,5 @@ require:
 AllCops:
   DisabledByDefault: true
 
-Ariadne/SystemArgumentInsteadOfClass:
-  Enabled: true
-
 Ariadne/NoTagMemoize:
-  Enabled: false
-
-Ariadne/AriadneHeroicon:
   Enabled: true

data/lib/rubocop/cop/ariadne/no_tag_memoize.rb

@@ -16,6 +16,7 @@ module RuboCop
       #
       # good
       # @attributes[:tag] = :h2
+      # TODO: TEST THIS
       class NoTagMemoize < RuboCop::Cop::Cop
         INVALID_MESSAGE = <<~STR
           Avoid `[:tag] ||=`. Instead, try one of the following:

data/lib/tasks/ariadne_view_components.rake

@@ -2,7 +2,8 @@
 
 ERB_GLOB = "**/*.html{+*,}.erb"
 RB_GLOB = "**/*.rb"
-BLOCK_EXPR = /\s*((\s+|\))do|\{)(\s*\|[^|]*\|)?\s*\Z/.freeze # copied from Rails: action_view/template/handlers/erb/erubi.rb
+# copied from Rails: action_view/template/handlers/erb/erubi.rb
+BLOCK_EXPR = /\s*((\s+|\))do|\{)(\s*\|[^|]*\|)?\s*\Z/
 
 namespace :ariadne_view_components do
   desc "Report arguments used in each component"

data/lib/tasks/build.rake

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "ariadne/view_components/commands"
+
+namespace :ariadne_view_components do
+  desc "Build Ariadne View Components CSS"
+  task :build do |_, args|
+    debug = args.extras.include?("debug")
+    command = Ariadne::ViewComponents::Commands.compile_command(debug: debug)
+    puts command.inspect
+    system(*command, exception: true)
+  end
+
+  desc "Watch and build Ariadne View Components CSS on file changes"
+  task :watch do |_, args|
+    debug = args.extras.include?("debug")
+    poll = args.extras.include?("poll")
+    command = Ariadne::ViewComponents::Commands.watch_command(debug: debug, poll: poll)
+    puts command.inspect
+    system(*command)
+  end
+end
+
+Rake::Task["assets:precompile"].enhance(["ariadne_view_components:build"]) if Rake::Task.task_defined?("assets:precompile")
+
+if Rake::Task.task_defined?("test:prepare")
+  Rake::Task["test:prepare"].enhance(["ariadne_view_components:build"])
+elsif Rake::Task.task_defined?("db:test:prepare")
+  Rake::Task["db:test:prepare"].enhance(["ariadne_view_components:build"])
+end

data/lib/tasks/docs.rake

@@ -47,7 +47,7 @@ namespace :docs do
     # Rails controller for rendering arbitrary ERB
     view_context = ApplicationController.new.tap { |c| c.request = ActionDispatch::TestRequest.create }.view_context
     components = [
-      Ariadne::FlexComponent,
+      Ariadne::RichTextAreaComponent,
       Ariadne::CommentComponent,
       Ariadne::BodyComponent,
       Ariadne::BlankslateComponent,
@@ -58,6 +58,7 @@ namespace :docs do
       Ariadne::CounterComponent,
       Ariadne::GridComponent,
       Ariadne::FlashComponent,
+      Ariadne::FlexComponent,
       Ariadne::FooterComponent,
       Ariadne::HeaderComponent,
       Ariadne::HeadingComponent,
@@ -67,8 +68,12 @@ namespace :docs do
       Ariadne::LinkComponent,
       Ariadne::ListComponent,
       Ariadne::MainComponent,
+      Ariadne::NarrowContainerComponent,
+      Ariadne::PanelBarComponent,
       Ariadne::PillComponent,
       Ariadne::SlideoverComponent,
+      Ariadne::TabComponent,
+      Ariadne::TabBarComponent,
       Ariadne::Text,
       Ariadne::TimeAgoComponent,
       Ariadne::TimelineComponent,

data/static/arguments.yml

@@ -62,7 +62,7 @@
   - name: scheme
     type: Symbol
     default: "`:default`"
-    description: One of `:danger`, `:default`, `:info`, `:success`, or `:warning`.
+    description: One of `:danger`, `:default`, `:info`, `:none`, `:success`, or `:warning`.
   - name: size
     type: Symbol
     default: "`BaseButton::DEFAULT_SIZE`"
@@ -110,10 +110,18 @@
 - component: Comment
   source: https://github.com/yettoapp/ariadne/ruby/view_components/tree/main/app/components/ariadne/comment_component.rb
   parameters:
-  - name: action
+  - name: url
+    type: String
+    default: N/A
+    description: The URL to take action against.
+  - name: method
+    type: String
+    default: N/A
+    description: The method to use when submitting the form.
+  - name: sr_label
     type: String
     default: N/A
-    description: The action to take when the form is submitted.
+    description: A label to introduce these tabs for screen readers.
   - name: classes
     type: String
     default: '`""`'
@@ -282,7 +290,7 @@
   - name: variant
     type: String
     default: N/A
-    description: One of `outline` and `solid`.
+    description: One of `outline`, `solid`, or `mini`.
   - name: size
     type: Symbol
     default: "`:sm`"
@@ -386,6 +394,32 @@
     type: Hash
     default: "`{}`"
     description: "[Classes and attributes](/classes-attributes)"
+- component: NarrowContainer
+  source: https://github.com/yettoapp/ariadne/ruby/view_components/tree/main/app/components/ariadne/narrow_container_component.rb
+  parameters:
+  - name: classes
+    type: String
+    default: '`""`'
+    description: "[Classes and attributes](/classes-attributes)"
+  - name: attributes
+    type: Hash
+    default: "`{}`"
+    description: "[Classes and attributes](/classes-attributes)"
+- component: PanelBar
+  source: https://github.com/yettoapp/ariadne/ruby/view_components/tree/main/app/components/ariadne/panel_bar_component.rb
+  parameters:
+  - name: tag
+    type: Symbol, String
+    default: N/A
+    description: The rendered tag name.
+  - name: classes
+    type: String
+    default: '`""`'
+    description: "[Classes and attributes](/classes-attributes)"
+  - name: attributes
+    type: Hash
+    default: "`{}`"
+    description: "[Classes and attributes](/classes-attributes)"
 - component: Pill
   source: https://github.com/yettoapp/ariadne/ruby/view_components/tree/main/app/components/ariadne/pill_component.rb
   parameters:
@@ -405,6 +439,29 @@
     type: Hash
     default: "`{}`"
     description: "[Classes and attributes](/classes-attributes)"
+- component: RichTextArea
+  source: https://github.com/yettoapp/ariadne/ruby/view_components/tree/main/app/components/ariadne/rich_text_area_component.rb
+  parameters:
+  - name: name
+    type: Symbol
+    default: N/A
+    description: Identifies the form/param name for this rich text area.
+  - name: sr_label
+    type: String
+    default: N/A
+    description: A label to introduce these tabs for screen readers.
+  - name: has_form
+    type: Boolean
+    default: "`true`"
+    description: Indicates whether this component is wrapped in a form.
+  - name: classes
+    type: String
+    default: '`""`'
+    description: "[Classes and attributes](/classes-attributes)"
+  - name: attributes
+    type: Hash
+    default: "`{}`"
+    description: "[Classes and attributes](/classes-attributes)"
 - component: Slideover
   source: https://github.com/yettoapp/ariadne/ruby/view_components/tree/main/app/components/ariadne/slideover_component.rb
   parameters:
@@ -436,6 +493,44 @@
     type: Hash
     default: "`{}`"
     description: "[Classes and attributes](/classes-attributes)"
+- component: TabBar
+  source: https://github.com/yettoapp/ariadne/ruby/view_components/tree/main/app/components/ariadne/tab_bar_component.rb
+  parameters:
+  - name: tag
+    type: Symbol, String
+    default: "`:nav`"
+    description: The rendered tag name.
+  - name: sr_label
+    type: String
+    default: N/A
+    description: A label to introduce these tabs for screen readers.
+  - name: classes
+    type: String
+    default: '`""`'
+    description: "[Classes and attributes](/classes-attributes)"
+  - name: attributes
+    type: Hash
+    default: "`{}`"
+    description: "[Classes and attributes](/classes-attributes)"
+- component: Tab
+  source: https://github.com/yettoapp/ariadne/ruby/view_components/tree/main/app/components/ariadne/tab_component.rb
+  parameters:
+  - name: tag
+    type: Symbol, String
+    default: "`:button`"
+    description: The rendered tag name.
+  - name: selected
+    type: Boolean
+    default: "`false`"
+    description: Whether the tab is selected or not.
+  - name: classes
+    type: String
+    default: '`""`'
+    description: "[Classes and attributes](/classes-attributes)"
+  - name: attributes
+    type: Hash
+    default: "`{}`"
+    description: "[Classes and attributes](/classes-attributes)"
 - component: Text
   source: https://github.com/yettoapp/ariadne/ruby/view_components/tree/main/app/components/ariadne/text.rb
   parameters:

data/static/audited_at.json

@@ -13,7 +13,7 @@
   "Ariadne::FlexComponent": "",
   "Ariadne::FooterComponent": "",
   "Ariadne::GridComponent": "",
-  "Ariadne::GridComponent::Item": "",
+  "Ariadne::GridComponent::GridItem": "",
   "Ariadne::HeaderComponent": "",
   "Ariadne::HeadingComponent": "",
   "Ariadne::HeroiconComponent": "",
@@ -21,10 +21,16 @@
   "Ariadne::InlineFlexComponent": "",
   "Ariadne::LinkComponent": "",
   "Ariadne::ListComponent": "",
-  "Ariadne::ListComponent::Item": "",
+  "Ariadne::ListComponent::ListItem": "",
   "Ariadne::MainComponent": "",
+  "Ariadne::NarrowContainerComponent": "",
+  "Ariadne::PanelBarComponent": "",
+  "Ariadne::PanelBarComponent::PanelItem": "",
   "Ariadne::PillComponent": "",
+  "Ariadne::RichTextAreaComponent": "",
   "Ariadne::SlideoverComponent": "",
+  "Ariadne::TabBarComponent": "",
+  "Ariadne::TabComponent": "",
   "Ariadne::Text": "",
   "Ariadne::TimeAgoComponent": "",
   "Ariadne::TimelineComponent": "",