ariadne_view_components 0.0.44-arm64-darwin → 0.0.46-arm64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71c4663938f83f8360cb7901f37c7fb2d8ae82ac49464f14f128c44d6fce8474
-  data.tar.gz: 978ce212563e070eb15087a0d6a9c81591a2953286a7733af6e4d4cec5577f9a
+  metadata.gz: b93c6655d9e580374c658a8886eb2c46396295fbc46c4c06167135803df1a098
+  data.tar.gz: 9f2a463ae9d84e5e9264c5d66f39a41c00a49c383da58df6a8c30161e0e383b2
 SHA512:
-  metadata.gz: 05e1e289dd369402a26dc5a3fff3f7bb6eee5ff2b0c8535f505ddccf2dea188d06313bf030ad0940b3041d5a102ea0115128ac06e4ca1793fe1145d724c9f79d
-  data.tar.gz: 48f60ce45e150b114ae23b3a5bcc9a0e0a2a4c56c27c85830324ccb964a40f4a827b63954ec2ffedef536f1d2a6dcbccf8516b6f4a2870538fc66630d209dffe
+  metadata.gz: 81495b17e7196ac81679f7dbbe207900fd60a576fc4a6e47b9873db11eee1a6e92abf1f338f503292743580cabae470a17bd754871c3ace85d04961a7d939b0b
+  data.tar.gz: '028cebabb299445af1725a47de65167c916052736d20ee54458d8907174db7760e96d786620e06372d0f45f103f3f90e30bdf3c0bdf730b6459d80449c4ad0a3'

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [v0.0.45](https://github.com/yettoapp/ariadne/tree/v0.0.45) (2023-05-04)
+
+[Full Changelog](https://github.com/yettoapp/ariadne/compare/v0.0.44...v0.0.45)
+
+## [v0.0.44](https://github.com/yettoapp/ariadne/tree/v0.0.44) (2023-05-04)
+
+[Full Changelog](https://github.com/yettoapp/ariadne/compare/v0.0.43...v0.0.44)
+
+**Merged pull requests:**
+
+- build\(deps-dev\): bump @typescript-eslint/eslint-plugin from 5.59.1 to 5.59.2 [\#298](https://github.com/yettoapp/ariadne/pull/298) ([dependabot[bot]](https://github.com/apps/dependabot))
+- \[auto-browserslist\] Update Browserslist db [\#296](https://github.com/yettoapp/ariadne/pull/296) ([sisyphusbot](https://github.com/sisyphusbot))
+
 ## [v0.0.43](https://github.com/yettoapp/ariadne/tree/v0.0.43) (2023-05-02)
 
 [Full Changelog](https://github.com/yettoapp/ariadne/compare/v0.0.42...v0.0.43)

data/app/lib/ariadne/action_view_extensions/form_helper.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Ariadne
+  module ActionViewExtensions
+    # :nodoc:
+    module FormHelper
+      include ClassNameHelper
+
+      DEFAULT_FORM_CLASSES = "ariadne-space-y-8 sm:ariadne-space-y-5"
+      def ariadne_form_with(model: nil, scope: nil, url: nil, format: nil, classes: "", attributes: {}, **options, &block)
+        options[:class] = merge_class_names(DEFAULT_FORM_CLASSES, options[:class])
+        options[:builder] ||= Ariadne::FormBuilder
+        options[:html] = attributes
+
+        data_controller = options[:html].fetch(:"data-controller", "")
+        options[:html][:"data-controller"] = if data_controller.present?
+          "#{data_controller} ariadne-form"
+        else
+          "ariadne-form"
+        end
+
+        form_with(model: model, scope: scope, url: url, format: format, **options, &block)
+      end
+    end
+  end
+end
+
+ActiveSupport.on_load(:action_view) do
+  include Ariadne::ActionViewExtensions::FormHelper
+end

data/app/lib/ariadne/audited/dsl.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require "active_support/concern"
+
+module Ariadne
+  # :nodoc:
+  module Audited
+    # DSL to register when a component has passed an accessibility audit.
+    #
+    # Example:
+    #
+    # class MyComponent < ViewComponent::Base
+    #   include Ariadne::Audited::Dsl
+    #   audited_at 'YYYY-MM-DD'
+    # end
+    module Dsl
+      extend ActiveSupport::Concern
+
+      included do
+        class_attribute :audit_date, instance_writer: false
+      end
+
+      class_methods do
+        def audited_at(date = nil)
+          return audit_date if date.nil?
+
+          self.audit_date = date
+        end
+      end
+    end
+  end
+end

data/app/lib/ariadne/class_name_helper.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# Helps build a list of conditional class names
+module Ariadne
+  # :nodoc:
+  module ClassNameHelper
+    def merge_class_names(*args)
+      [].tap do |classes|
+        args.each do |class_name|
+          next if class_name.blank?
+
+          case class_name
+          when String
+            classes << class_name
+          else
+            raise ArgumentError, "Expected String class name, got #{class_name.class}"
+          end
+        end
+      end.join(" ")
+    end
+  end
+end

data/app/lib/ariadne/fetch_or_fallback_helper.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+# Ariadne::FetchOrFallbackHelper
+# A little helper to enable graceful fallbacks
+#
+# Use this helper to quietly ensure a value is
+# one that you expect:
+#
+# allowed_values    - allowed options for *value*
+# given_value       - input being coerced
+# fallback          - returned if *given_value* is not included in *allowed_values*
+#
+# fetch_or_raise([1,2,3], 5) => 2
+# fetch_or_raise([1,2,3], 1) => 1
+# fetch_or_raise([1,2,3], nil) => 2
+module Ariadne
+  # :nodoc:
+  module FetchOrFallbackHelper
+    include LoggerHelper
+
+    mattr_accessor :fallback_raises, default: true
+
+    InvalidValueError = Class.new(StandardError)
+
+    TRUE_OR_FALSE = Set.new([true, false]).freeze
+
+    INTEGER_TYPES = Set.new(["Integer"]).freeze
+
+    def fetch_or_raise(allowed_values, given_value, against: nil)
+      if !allowed_values.is_a?(Array) && !allowed_values.is_a?(Set)
+        raise ArgumentError, "allowed_values must be an array or a set; it was #{allowed_values.class}"
+      end
+
+      check_against_given_value = against || given_value
+      if allowed_values.include?(check_against_given_value)
+        given_value
+      else
+        raise InvalidValueError, <<~MSG
+          fetch_or_raise was called with an invalid value.
+
+          Expected one of: #{allowed_values.inspect}
+          Got: #{given_value.inspect}
+        MSG
+      end
+    end
+
+    # TODO: use these two more
+    def fetch_or_raise_boolean(given_value)
+      fetch_or_raise(TRUE_OR_FALSE, given_value)
+    end
+
+    def fetch_or_raise_integer(given_value)
+      fetch_or_raise(INTEGER_TYPES, given_value, against: given_value.class.name)
+    end
+
+    # TODO: test this
+    def check_incoming_tag(preferred_tag, given_tag)
+      return preferred_tag if given_tag.blank? || preferred_tag == given_tag
+
+      unless silence_warnings?
+        message = <<~MSG
+          Ariadne: note that `#{preferred_tag}` is the preferred tag here;
+          you passed `#{given_tag}` (which will still be used)
+        MSG
+
+        logger.warn(message)
+      end
+
+      given_tag
+    end
+
+    # TODO: test this
+    def check_incoming_attribute(preferred_attribute, given_attribute)
+      return preferred_attribute if given_attribute.blank? || preferred_attribute != given_attribute
+
+      unless silence_warnings?
+        message = <<~MSG
+          Ariadne: note that `#{preferred_attribute}` is the preferred attribute here;
+          you passed `#{given_attribute}` (which will still be used)
+        MSG
+
+        logger.warn(message)
+      end
+
+      given_attribute
+    end
+
+    # TODO: test this
+    def check_incoming_value(preferred_value, given_pair)
+      return preferred_value if given_pair.blank? || !given_pair.is_a?(Hash)
+
+      given_key = given_pair.keys.first
+      given_value = given_pair.values.first
+
+      return preferred_value if given_value.blank?
+
+      unless silence_warnings?
+
+        message = <<~MSG
+          Ariadne: note that `#{preferred_value}` is the preferred value for `#{given_key}` here;
+          you passed `#{given_value}` (which will still be used)
+        MSG
+
+        logger.warn(message)
+      end
+
+      given_value
+    end
+  end
+end

data/app/lib/ariadne/form_builder.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # :nodoc:
+  # Many of the form methods simply call out to the corresponding ActionView::Helpers::FormBuilder methods,
+  # documented at https://api.rubyonrails.org/classes/ActionView/Helpers/FormBuilder.html, with
+  # default Tailwind classes applied.
+  class FormBuilder < ActionView::Helpers::FormBuilder
+    include ClassNameHelper
+
+    DEFAULT_SECTION_CLASSES = "ariadne-space-y-6 ariadne-px-4"
+    def section(classes: "", attributes: {}, &block)
+      actual_classes = merge_class_names(DEFAULT_SECTION_CLASSES, classes)
+      options = { class: actual_classes, **attributes }
+      @template.content_tag(:div, **options, &block)
+    end
+
+    DEFAULT_SECTION_HEADING_CLASSES = "ariadne-text-lg ariadne-leading-6 ariadne-py-4 ariadne-font-medium ariadne-text-gray-900"
+    def heading(tag: :h3, classes: "", attributes: {}, &block)
+      actual_classes = merge_class_names(DEFAULT_SECTION_HEADING_CLASSES, classes)
+      options = { class: actual_classes, **attributes }
+      @template.content_tag(tag, **options, &block)
+    end
+
+    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 = merge_class_names(DEFAULT_SECTION_SUBHEADING_CLASSES, classes)
+      options = { class: actual_classes, **attributes }
+      @template.content_tag(:p, **options, &block)
+    end
+
+    DEFAULT_LABEL_CLASSES = "ariadne-block ariadne-text-sm ariadne-font-medium ariadne-text-gray-700 ariadne-pl-2"
+    def label(method, text = nil, options = {}, &block)
+      options[:class] = merge_class_names(DEFAULT_LABEL_CLASSES, options.delete(:classes))
+      super(method, text, options, &block)
+    end
+
+    DEFAULT_TEXT_CLASSES = "ariadne-shadow-sm focus:ariadne-ring-slate-500 focus:ariadne-border-slate-500 ariadne-block ariadne-w-full sm:ariadne-text-sm ariadne-border-gray-300 ariadne-rounded-md"
+    def text_field(method, options = {})
+      options[:class] = merge_class_names(DEFAULT_TEXT_CLASSES, options.delete(:classes))
+      super(method, **options)
+    end
+
+    DEFAULT_CHECKBOX_CLASSES = "focus:ariadne-ring-slate-500 ariadne-h-4 ariadne-w-4 ariadne-text-slate-600 ariadne-border-slate-300 ariadne-rounded"
+    def check_box(method, options = {}, checked_value = "1", unchecked_value = "0")
+      options[:class] = merge_class_names(DEFAULT_CHECKBOX_CLASSES, options.delete(:classes))
+      super(method, options, checked_value, unchecked_value)
+    end
+
+    DEFAULT_RADIO_CLASSES = "focus:ariadne-ring-slate-500 ariadne-h-4 ariadne-w-4 ariadne-text-slate-600 ariadne-border-gray-300 ariadne-rounded"
+    def radio_button(method, tag_value, options = {})
+      options[:class] = merge_class_names(DEFAULT_RADIO_CLASSES, options.delete(:classes))
+      super(method, tag_value, **options)
+    end
+
+    DEFAULT_TEXTAREA_CLASSES = "ariadne-shadow-sm focus:ariadne-ring-slate-500 focus:ariadne-border-slate-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] = merge_class_names(DEFAULT_TEXTAREA_CLASSES, options.delete(:classes))
+      super(method, **options)
+    end
+
+    DEFAULT_EMAIL_CLASSES = "ariadne-shadow-sm focus:ariadne-ring-slate-500 focus:ariadne-border-slate-500 ariadne-block ariadne-w-full sm:ariadne-text-sm ariadne-border-gray-300 ariadne-rounded-md"
+    def email_field(method, options = {})
+      options[:class] = merge_class_names(DEFAULT_EMAIL_CLASSES, options.delete(:classes))
+      super(method, **options)
+    end
+
+    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-slate-500 focus:ariadne-border-slate-500 sm:ariadne-text-sm"
+    def password_field(method, options = {})
+      options[:class] = merge_class_names(DEFAULT_PASSWORD_CLASSES, options.delete(:classes))
+      super(method, **options)
+    end
+  end
+end

data/app/lib/ariadne/icon_helper.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+# Ariadne::IconHelper
+# A helper that insists on certain values when
+# checking herocions and their varients.
+#
+# Use this helper to loudly ensure a value is
+# one that you expect.
+module Ariadne
+  # :nodoc:
+  module IconHelper
+    include FetchOrFallbackHelper
+
+    def check_icon_presence!(icon, variant)
+      return true unless has_partial_icon?(icon, variant)
+
+      icon_presence!(icon, variant)
+      variant_presence!(icon, variant)
+      ensure_valid_variant(variant)
+
+      true
+    end
+
+    def ensure_valid_variant(variant)
+      check_variant = if variant.blank? || !variant.respond_to?(:to_s)
+        ""
+      else
+        variant.to_s
+      end
+
+      fetch_or_raise(HeroiconsHelper::Icon::VALID_VARIANTS, check_variant)
+    end
+    module_function :ensure_valid_variant
+
+    def has_partial_icon?(icon, variant)
+      icon.present? || variant.present?
+    end
+
+    def icon_presence!(icon, variant)
+      raise(ArgumentError, "You must provide an `icon` when providing a `variant`.") if icon.blank? && variant.present?
+
+      true
+    end
+
+    def variant_presence!(icon, variant)
+      raise(ArgumentError, "You must provide a `variant` when providing an `icon`.") if icon.present? && variant.blank?
+
+      true
+    end
+  end
+end

data/app/lib/ariadne/logger_helper.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # :nodoc:
+  module LoggerHelper
+    def logger
+      return Rails.logger if defined?(Rails) && Rails.logger
+
+      require "logger"
+      Logger.new($stderr)
+    end
+
+    # TODO: test
+    def silence_deprecations?
+      Rails.application.config.ariadne_view_components.silence_deprecations
+    end
+
+    # TODO: test
+    def silence_warnings?
+      Rails.application.config.ariadne_view_components.silence_warnings
+    end
+  end
+end

data/app/lib/ariadne/status/dsl.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require "active_support/concern"
+
+module Ariadne
+  # :nodoc:
+  module Status
+    # DSL to allow components to register their status.
+    #
+    # Example:
+    #
+    # class MyComponent < ViewComponent::Base
+    #   include Ariadne::Status::Dsl
+    #   status :experimental
+    # end
+    module Dsl
+      extend ActiveSupport::Concern
+
+      STATUSES = {
+        experimental: :experimental,
+        stable: :stable,
+      }.freeze
+
+      class UnknownStatusError < StandardError; end
+
+      included do
+        class_attribute :component_status, instance_writer: false, default: STATUSES[:stable]
+      end
+
+      class_methods do
+        def status(status = nil)
+          return component_status if status.nil?
+
+          raise UnknownStatusError, "status #{status} does not exist" if STATUSES[status].nil?
+
+          self.component_status = STATUSES[status]
+        end
+      end
+    end
+  end
+end

data/app/lib/ariadne/view_helper.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# :nocov:
+module Ariadne
+  # Module to allow shorthand calls for Ariadne components
+  module ViewHelper
+    class ViewHelperNotFound < StandardError; end
+
+    HELPERS = {
+      heroicon: "Ariadne::HeroiconComponent",
+      heading: "Ariadne::HeadingComponent",
+      time_ago: "Ariadne::TimeAgoComponent",
+      image: "Ariadne::ImageComponent",
+    }.freeze
+
+    HELPERS.each do |name, component|
+      define_method "ariadne_#{name}" do |*args, **kwargs, &block|
+        render component.constantize.new(*args, **kwargs), &block
+      end
+    end
+  end
+end

data/lib/ariadne/view_components/version.rb

@@ -3,6 +3,6 @@
 # :nocov:
 module Ariadne
   module ViewComponents
-    VERSION = "0.0.44"
+    VERSION = "0.0.46"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ariadne_view_components
 version: !ruby/object:Gem::Version
-  version: 0.0.44
+  version: 0.0.46
 platform: arm64-darwin
 authors:
 - Garen J. Torikian
@@ -222,6 +222,15 @@ files:
 - app/components/ariadne/tooltip_component/tooltip-component.js
 - app/components/ariadne/tooltip_component/tooltip-component.ts
 - app/components/ariadne/tooltip_component/tooltip_component.html.erb
+- app/lib/ariadne/action_view_extensions/form_helper.rb
+- app/lib/ariadne/audited/dsl.rb
+- app/lib/ariadne/class_name_helper.rb
+- app/lib/ariadne/fetch_or_fallback_helper.rb
+- app/lib/ariadne/form_builder.rb
+- app/lib/ariadne/icon_helper.rb
+- app/lib/ariadne/logger_helper.rb
+- app/lib/ariadne/status/dsl.rb
+- app/lib/ariadne/view_helper.rb
 - config/importmap.rb
 - exe/arm64-darwin/tailwindcss
 - exe/tailwindcss
@@ -241,17 +250,6 @@ files:
 - lib/rubocop/cop/ariadne.rb
 - lib/rubocop/cop/ariadne/base_cop.rb
 - lib/rubocop/cop/ariadne/no_tag_memoize.rb
-- lib/tasks/ariadne_view_components.rake
-- lib/tasks/build.rake
-- lib/tasks/coverage.rake
-- lib/tasks/docs.rake
-- lib/tasks/helpers/ast_processor.rb
-- lib/tasks/helpers/ast_traverser.rb
-- lib/tasks/static.rake
-- lib/tasks/test.rake
-- lib/yard/docs_helper.rb
-- lib/yard/renders_many_handler.rb
-- lib/yard/renders_one_handler.rb
 - static/arguments.yml
 - static/assets/view-components.svg
 - static/audited_at.json

data/lib/tasks/ariadne_view_components.rake

@@ -1,48 +0,0 @@
-# frozen_string_literal: true
-
-ERB_GLOB = "**/*.html{+*,}.erb"
-RB_GLOB = "**/*.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"
-  task :report, [:paths] do |_, args|
-    require "rubocop"
-    require "better_html"
-    require "better_html/parser"
-    require "erb_lint/processed_source"
-    require_relative "helpers/ast_processor"
-
-    paths = args[:paths].split
-    stats = {}
-
-    rb_files = paths.reduce([]) { |mem, path| mem + Dir[File.join(path, RB_GLOB)] }
-
-    rb_files.each do |f|
-      ast = RuboCop::AST::ProcessedSource.from_file(f, RUBY_VERSION.to_f).ast
-      AstProcessor.process_ast(ast, stats)
-    end
-
-    erb_files = paths.reduce([]) { |mem, path| mem + Dir[File.join(path, ERB_GLOB)] }
-
-    erb_files.each do |f|
-      erb_ast = ERBLint::ProcessedSource.new(f, File.read(f)).ast
-
-      erb_ast.descendants(:erb).each do |erb_node|
-        indicator, _, code_node, = *erb_node
-
-        next if indicator&.children&.first == "#" # don't analyze comments
-
-        trimmed_source = code_node.loc.source.sub(BLOCK_EXPR, "").strip
-        ast = RuboCop::AST::ProcessedSource.new(trimmed_source, RUBY_VERSION.to_f).ast
-        AstProcessor.process_ast(ast, stats)
-      end
-    end
-
-    File.open(".ariadne-view-components-report.json", "w") do |f|
-      f.write(JSON.pretty_generate(stats))
-      f.write($INPUT_RECORD_SEPARATOR)
-    end
-  end
-end

data/lib/tasks/build.rake

@@ -1,30 +0,0 @@
-# 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/coverage.rake

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-namespace :coverage do
-  desc "Run coverage report. This should ideally be done only on CI."
-  task :report do
-    require "simplecov"
-    require "simplecov-console"
-
-    SimpleCov.collate(Dir["coverage/.resultset.json"], "rails") do
-      formatter SimpleCov::Formatter::Console
-
-      minimum_coverage 100
-      maximum_coverage_drop 2
-
-      add_group "Ignored Code" do |src_file|
-        File.readlines(src_file.filename).grep(/:nocov:/).any?
-      end
-    end
-  end
-end