sdr_view_components 0.1.8 → 0.1.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ed77ab15d611e21337871d3d410b784454ec8e1a356fe91050b2250d7bc7d14
-  data.tar.gz: 10f9d789b3ca10d8b1bef44adf1dbb61639267115340f6d113d08d2d70d54002
+  metadata.gz: 296ea41f2742301fbcbfe4e4997327a0a88f9062789f0e987298b023704695b8
+  data.tar.gz: b763fa492037241155bb55464d27437d3316df043b3c8cafc86e4e72d51f29a8
 SHA512:
-  metadata.gz: 05475af8c2288f5f14ccfc0590fdb86374f530df207cf3fd82aa877d2377dbc91af5fde8742db8a74b16f6ef3dd1135a03450ec0a0bc083d0e4d4de404656844
-  data.tar.gz: fe4975a4869e202997e972c67999d66f9e729e7edc0e26f68ab83aaa7b6690579b6e0fa06a263f083c42f0fad2e81c1fead6d527235079dedb6fae7ff7c6e0b8
+  metadata.gz: fed14277e8b2afcc9e8a2ba17dcd7b42cf44c1396b7b93aa2b0ef90a6880de1eb43840f87fa308a1eeea3c4431be25e75969bccfd0cb384cef88a488c3912f31
+  data.tar.gz: f0b094384fa97b827ccd899fe40e3deb03cdf180ff9165ca2cc78dba1b8dd35d60c4a1fd19e71e79b7cc36b8d1f0022eca271b469a0509bb9211268fa638f5c3

data/app/components/sdr_view_components/elements/alert_component.html.erb

@@ -1,12 +1,12 @@
 <%= tag.div role:, class: classes, data:, id: do %>
   <% if icon? %>
-    <%= tag.div class: icon_classes, role: 'img', 'aria-label': "#{variant} alert icon" %>
+    <div class="fs-3 me-3 align-self-center d-flex justify-content-center"><%= icon %></div>
   <% end %>
   <div class="text-body">
     <% if title.present? %>
         <div class="fw-semibold"><%= title %></div>
     <% end %>
-    <%= content %>
+    <%= content || text %>
   </div>
   <% if dismissible? %>
     <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>

data/app/components/sdr_view_components/elements/alert_component.rb

@@ -4,34 +4,24 @@ module SdrViewComponents
   module Elements
     # Component for rendering an alert.
     class AlertComponent < BaseComponent
-      # NOTE: This component has been altered from the H3 version.
-
-      ICONS = {
-        danger: 'bi bi-exclamation-triangle-fill',
-        success: 'bi bi-check-circle-fill',
-        note: 'bi bi-exclamation-circle-fill',
-        info: 'bi bi-info-circle-fill',
-        warning: 'bi bi-exclamation-triangle-fill'
-      }.freeze
-
       # Variants are :danger, :success, :note, :info, :warning, :input
       # input is not part of the component library
-      def initialize(title: nil, variant: :info, dismissible: false, data: {}, classes: [], id: nil, # rubocop:disable Metrics/ParameterLists
-                     role: 'alert')
-        raise ArgumentError, 'Invalid variant' unless %i[danger success note info warning
-                                                         input].include?(variant.to_sym)
+      def initialize(title: nil, variant: :info, dismissible: false, # rubocop:disable Metrics/ParameterLists
+                     data: {}, classes: [], id: nil, role: 'alert', text: nil)
+        raise ArgumentError, 'Invalid variant' unless %i[danger success note info warning input].include?(variant.to_sym)
 
         @title = title
-        @variant = variant.to_sym
+        @variant = variant
         @dismissible = dismissible
         @data = data
         @classes = classes
         @id = id
         @role = role
+        @text = text
         super()
       end
 
-      attr_reader :title, :variant, :data, :id, :role
+      attr_reader :title, :variant, :data, :id, :role, :text
 
       def classes
         merge_classes(%w[alert d-flex shadow-sm align-items-center], variant_class, dismissible_class, @classes)
@@ -50,15 +40,15 @@ module SdrViewComponents
       end
 
       def icon?
-        ICONS.key?(variant)
+        helpers.respond_to?(:"#{variant}_icon")
       end
 
-      def icon_classes
-        merge_classes('fs-3 me-3 align-self-center d-flex justify-content-center', ICONS[variant])
+      def icon
+        helpers.public_send(:"#{variant}_icon", role: 'img', aria: { label: "#{variant} alert icon" })
       end
 
       def render?
-        title.present? || content.present?
+        title.present? || content.present? || text.present?
       end
     end
   end

data/app/components/sdr_view_components/elements/breadcrumb_nav_component.rb

@@ -17,7 +17,7 @@ module SdrViewComponents
       }
 
       def page_title_from_breadcrumbs
-        breadcrumbs.filter_map(&:truncated_text).unshift('SDR').join(' | ')
+        CGI.unescapeHTML(breadcrumbs.filter_map(&:truncated_text).unshift('SDR').join(' | '))
       end
     end
   end

data/app/components/sdr_view_components/forms/basic_file_component.rb

@@ -7,6 +7,10 @@ module SdrViewComponents
       def call
         form.file_field field_name, class: classes, **args
       end
+
+      def classes
+        merge_classes('form-control', @classes)
+      end
     end
   end
 end

data/app/components/sdr_view_components/forms/checkbox_component.rb

@@ -7,6 +7,7 @@ module SdrViewComponents
       def initialize(**args)
         args[:container_classes] = merge_classes('form-check', args[:container_classes])
         args[:label_default_class] = 'form-check-label'
+        args[:variant] = :help_text_below
         super
       end
 

data/app/components/sdr_view_components/forms/field_component.html.erb

@@ -1,8 +1,9 @@
 <%= tag.div class: container_classes, **container_args do %>
   <%= render SdrViewComponents::Forms::LabelComponent.new(form:, field_name: label_field_name, **label_args) %>
-  <%= render SdrViewComponents::Forms::HelpTextComponent.new(**help_text_args) %>
+  <%= render SdrViewComponents::Forms::HelpTextComponent.new(**help_text_args) unless help_text_below? %>
   <%= render input_component %>
   <%= render SdrViewComponents::Forms::InvalidFeedbackComponent.new(form:, field_name:, **error_args) %>
+  <%= render SdrViewComponents::Forms::HelpTextComponent.new(**help_text_args) if help_text_below? %>
 
   <%= additional_container_content %>
 <% end %>

data/app/components/sdr_view_components/forms/field_component.rb

@@ -6,15 +6,20 @@ module SdrViewComponents
     class FieldComponent < BaseComponent
       renders_one :additional_container_content
 
-      def initialize(form:, field_name:, container_classes: [], **args)
+      def initialize(form:, field_name:, container_classes: [], variant: :default, **args)
         @form = form
         @field_name = field_name
         @container_classes = container_classes
+        @variant = variant
+        # In the help_text_below variant, the help text is rendered below the input field.
+        # This is necessary for some types of fields such as checkboxes.
+        raise ArgumentError, 'invalid variant' unless %i[default help_text_below].include?(@variant)
+
         @args = args
         super()
       end
 
-      attr_reader :form, :args, :field_name
+      attr_reader :form, :args, :field_name, :variant
 
       # Any component that inherits from FieldComponent must implement this method
       # or provide its own template.
@@ -71,6 +76,10 @@ module SdrViewComponents
       def container_classes
         merge_classes(@container_classes)
       end
+
+      def help_text_below?
+        variant == :help_text_below
+      end
       ##########################################################################
 
       private

data/lib/sdr_view_components/engine.rb

@@ -21,5 +21,11 @@ module SdrViewComponents
       app.config.assets.paths << Engine.root.join('app', 'assets', 'stylesheets').to_s
       app.config.assets.precompile += %w[sdr_view_components.css]
     end
+
+    initializer 'sdr_view_components.helpers' do
+      ActiveSupport.on_load(:action_view) do
+        include SdrViewComponents::Helpers
+      end
+    end
   end
 end

data/lib/sdr_view_components/helpers/icon_helper.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module SdrViewComponents
+  # Helpers module for the SDR View Components gem
+  module Helpers
+    # Helper for rendering icons.
+    module IconHelper
+      extend ActionView::Helpers::TagHelper
+
+      def icon(icon_classes:, classes: nil, **)
+        all_classes = ComponentSupport::CssClasses.merge(icon_classes, classes)
+        content_tag(:i, nil, class: all_classes, **)
+      end
+
+      def right_arrow_icon(**)
+        icon(icon_classes: 'bi bi-arrow-right', **)
+      end
+
+      def danger_icon(**)
+        icon(icon_classes: 'bi bi-exclamation-triangle-fill', **)
+      end
+
+      def note_icon(**)
+        icon(icon_classes: 'bi bi-exclamation-circle-fill', **)
+      end
+
+      def success_icon(**)
+        icon(icon_classes: 'bi bi-check-circle-fill', **)
+      end
+
+      def info_icon(fill: true, **)
+        icon(icon_classes: ['bi', fill ? 'bi-info-circle-fill' : 'bi-info-circle'], **)
+      end
+
+      def warning_icon(**)
+        icon(icon_classes: 'bi bi-exclamation-triangle-fill', **)
+      end
+
+      def delete_icon(**)
+        icon(icon_classes: 'bi bi-trash', **)
+      end
+
+      def edit_icon(**)
+        icon(icon_classes: 'bi bi-pencil', **)
+      end
+
+      def first_icon(**)
+        icon(icon_classes: 'bi bi-chevron-double-left', **)
+      end
+
+      def last_icon(**)
+        icon(icon_classes: 'bi bi-chevron-double-right', **)
+      end
+
+      def next_icon(**)
+        icon(icon_classes: 'bi bi-chevron-right', **)
+      end
+
+      def previous_icon(**)
+        icon(icon_classes: 'bi bi-chevron-left', **)
+      end
+
+      def upload_icon(fill: true, **)
+        icon(icon_classes: ['bi', fill ? 'bi-cloud-upload-fill' : 'bi-cloud-upload'], **)
+      end
+
+      def move_up_icon(**)
+        icon(icon_classes: 'bi bi-arrow-up', **)
+      end
+
+      def move_down_icon(**)
+        icon(icon_classes: 'bi bi-arrow-down', **)
+      end
+
+      def calendar_icon(**)
+        icon(icon_classes: 'bi bi-calendar', **)
+      end
+
+      def search_icon(**)
+        icon(icon_classes: 'bi bi-search', **)
+      end
+
+      def bulb_icon(**)
+        icon(icon_classes: 'bi bi-lightbulb', **)
+      end
+
+      def quote_icon(**)
+        icon(icon_classes: 'bi bi-quote', **)
+      end
+
+      def download_icon(**)
+        icon(icon_classes: 'bi bi-download', **)
+      end
+    end
+  end
+end

data/lib/sdr_view_components/helpers.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module SdrViewComponents
+  # Helpers module for the SDR View Components gem
+  module Helpers
+    include IconHelper
+  end
+end

data/lib/sdr_view_components/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SdrViewComponents
-  VERSION = '0.1.8'
+  VERSION = '0.1.10'
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: sdr_view_components
 version: !ruby/object:Gem::Version
-  version: 0.1.8
+  version: 0.1.10
 platform: ruby
 authors:
 - Aaron Collier
 bindir: bin
 cert_chain: []
-date: 2025-12-17 00:00:00.000000000 Z
+date: 2026-02-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -126,6 +126,8 @@ files:
 - config/routes.rb
 - lib/sdr_view_components.rb
 - lib/sdr_view_components/engine.rb
+- lib/sdr_view_components/helpers.rb
+- lib/sdr_view_components/helpers/icon_helper.rb
 - lib/sdr_view_components/version.rb
 homepage: https://github.com/sul-dlss/sdr_view_components
 licenses: []