design_system 0.13.2 → 0.15.0

data/lib/design_system/generic/builders/code.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Generic
+    module Builders
+      # Renders a code block with copy button.
+      class Code < Base
+        def render_code(code, language)
+          content_tag(:div, class: 'app-example__code', data: { controller: 'ds--clipboard' }) do
+            content_tag(:button, 'Copy', class: 'app-example__copy-button',
+                                         data: { action: 'click->ds--clipboard#copy', 'ds--clipboard-target': 'buttonText' }) +
+              content_tag(:div, class: 'app-example__scroll', tabindex: 0) do
+                content_tag(:pre, data: { 'ds--clipboard-target': 'source' }) do
+                  content_tag(:code, code, data: { controller: 'ds--code-highlight' },
+                                           class: "hljs language-#{language}")
+                end
+              end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/design_system/generic/builders/elements/breadcrumbs.rb

@@ -2,7 +2,8 @@ module DesignSystem
   module Generic
     module Builders
       module Elements
-        # This mixin module is used to provide breadcrumbs.
+        # This mixin accumulates breadcrumbs and renders them into the
+        # :breadcrumbs content_for slot via the per-brand BreadcrumbsComponent.
         module Breadcrumbs
           def breadcrumb(label, path)
             @breadcrumbs ||= []
@@ -13,31 +14,10 @@ module DesignSystem
 
           def content_for_breadcrumbs
             content_for(:breadcrumbs) do
-              safe_buffer = ActiveSupport::SafeBuffer.new
-
-              @breadcrumbs.each do |breadcrumb|
-                safe_buffer.concat(render_breadcrumb(breadcrumb))
-                safe_buffer.concat(' > ') unless @breadcrumbs.last == breadcrumb
-              end
-
-              safe_buffer
+              component = ::DesignSystem::Registry.component(brand, :breadcrumbs).new(breadcrumbs: @breadcrumbs)
+              @context.render(component)
             end
           end
-
-          def home_path?(path)
-            root_hash = Rails.application.routes.recognize_path(@context.root_path)
-            path_hash = Rails.application.routes.recognize_path(path)
-
-            %i[controller action].each do |key|
-              return false if root_hash[key] != path_hash[key]
-            end
-
-            true
-          end
-
-          def render_breadcrumb(breadcrumb)
-            link_to_unless_current(breadcrumb[:label], breadcrumb[:path])
-          end
         end
       end
     end

data/lib/design_system/generic/builders/elements/headings.rb

@@ -15,8 +15,9 @@ module DesignSystem
             safe_buffer = ActiveSupport::SafeBuffer.new
 
             safe_buffer.concat(render_caption) if @caption
-            safe_buffer.concat(DesignSystem::Registry.builder(brand, 'heading', self).render_heading(@main_heading,
-                                                                                                     level: 1))
+            safe_buffer.concat(
+              DesignSystem::Registry.component(brand, :heading).new(@main_heading, level: 1).render_in(@context)
+            )
 
             safe_buffer
           end

data/lib/design_system/generic/builders/pagination_renderer.rb

@@ -7,7 +7,7 @@ module DesignSystem
     module Builders
       # This class is used to provide will_paginate renderer.
       class PaginationRenderer < WillPaginate::ActionView::LinkRenderer
-        include DesignSystem::Generic::Builders::Concerns::BrandDerivable
+        include DesignSystem::BrandDerivable
 
         def initialize(context)
           @context = context
@@ -49,12 +49,13 @@ module DesignSystem
                 'aria-label': aria_label)
         end
 
-        def disabled_link_with_title(text, title, aria_label = nil)
+        def disabled_link_with_title(text, title, _aria_label = nil)
+          # No aria-label here: it is prohibited on a role-less <span>. The visible
+          # title plus the visually-hidden text already provide an accessible name.
           tag(:span,
               tag(:span, title, class: "#{brand}-pagination__title") +
               tag(:span, text, class: "#{brand}-u-visually-hidden"),
-              class: "#{brand}-pagination__link disabled",
-              'aria-label': aria_label)
+              class: "#{brand}-pagination__link disabled")
         end
 
         # SVG for the "Previous" icon

data/lib/design_system/generic.rb

@@ -2,19 +2,6 @@
 
 # This is the generic (unbranded) adapter for design system
 
-require_relative 'generic/builders/concerns/brand_derivable'
-require_relative 'generic/builders/button'
-require_relative 'generic/builders/callout'
-require_relative 'generic/builders/details'
+require_relative 'generic/builders/code'
 require_relative 'generic/builders/fixed_elements'
-require_relative 'generic/builders/grid'
-require_relative 'generic/builders/heading'
-require_relative 'generic/builders/inset_text'
-require_relative 'generic/builders/link'
-require_relative 'generic/builders/list'
-require_relative 'generic/builders/notification'
 require_relative 'generic/builders/pagination_renderer'
-require_relative 'generic/builders/panel'
-require_relative 'generic/builders/paragraph'
-require_relative 'generic/builders/tab'
-require_relative 'generic/builders/table'

data/lib/design_system/govuk/builders/code.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Govuk
+    module Builders
+      # This class provides GOVUK methods to display code blocks.
+      class Code < ::DesignSystem::Generic::Builders::Code
+      end
+    end
+  end
+end

data/lib/design_system/govuk/builders/fixed_elements.rb

@@ -5,7 +5,6 @@ module DesignSystem
     module Builders
       # This class is used to provide the GOVUK fixed elements builder.
       class FixedElements < ::DesignSystem::Generic::Builders::FixedElements
-        include Elements::Breadcrumbs
         include Elements::Headings
       end
     end

data/lib/design_system/govuk.rb

@@ -2,20 +2,9 @@
 
 # This is the GOV.UK adapter for the design system
 
-require_relative 'govuk/builders/button'
-require_relative 'govuk/builders/callout'
-require_relative 'govuk/builders/details'
+require_relative 'govuk/builders/code'
 require_relative 'govuk/builders/fixed_elements'
-require_relative 'govuk/builders/heading'
-require_relative 'govuk/builders/link'
-require_relative 'govuk/builders/list'
-require_relative 'govuk/builders/notification'
 require_relative 'govuk/builders/pagination_renderer'
-require_relative 'govuk/builders/panel'
-require_relative 'govuk/builders/paragraph'
-require_relative 'govuk/builders/summary_list'
-require_relative 'govuk/builders/tab'
-require_relative 'govuk/builders/table'
 
 require_relative 'govuk/form_builder'
 

data/lib/design_system/nhsuk/builders/code.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Nhsuk
+    module Builders
+      # This class provides NHSUK methods to display code blocks.
+      class Code < ::DesignSystem::Generic::Builders::Code
+      end
+    end
+  end
+end

data/lib/design_system/nhsuk/builders/fixed_elements.rb

@@ -5,7 +5,6 @@ module DesignSystem
     module Builders
       # This class is used to provide the NHSUK fixed elements builder.
       class FixedElements < ::DesignSystem::Govuk::Builders::FixedElements
-        include Elements::Breadcrumbs
       end
     end
   end

data/lib/design_system/nhsuk.rb

@@ -1,19 +1,8 @@
 # frozen_string_literal: true
 
-require_relative 'nhsuk/builders/button'
-require_relative 'nhsuk/builders/callout'
+require_relative 'nhsuk/builders/code'
 require_relative 'nhsuk/builders/fixed_elements'
-require_relative 'nhsuk/builders/details'
-require_relative 'nhsuk/builders/heading'
-require_relative 'nhsuk/builders/link'
-require_relative 'nhsuk/builders/list'
-require_relative 'nhsuk/builders/notification'
 require_relative 'nhsuk/builders/pagination_renderer'
-require_relative 'nhsuk/builders/panel'
-require_relative 'nhsuk/builders/paragraph'
-require_relative 'nhsuk/builders/summary_list'
-require_relative 'nhsuk/builders/tab'
-require_relative 'nhsuk/builders/table'
 
 require_relative 'nhsuk/form_builder'
 

data/lib/design_system/registry.rb

@@ -22,14 +22,32 @@ module DesignSystem
         klass.new(context)
       end
 
+      # Resolves a per-brand component class. The component is responsible for
+      # rendering — call `render(component(brand, :panel).new(...))` from a
+      # helper. Coexists with `builder` during the gradual migration from
+      # PORO builders to ViewComponents.
+      def component(brand, name)
+        raise ArgumentError, "Unknown brand: #{brand}" unless registered?(brand)
+
+        klass_name = "DesignSystem::#{brand.camelize}::#{name.to_s.camelize}Component"
+        klass_name.safe_constantize ||
+          raise(ArgumentError, "Unknown component: #{name} for brand #{brand}")
+      end
+
       def form_builder(brand)
+        raise ArgumentError, "Unknown brand: #{brand}" unless registered?(brand)
+
         "DesignSystem::#{brand.camelcase}::FormBuilder".constantize
       end
 
+      def registered?(brand)
+        Array(design_systems).include?(brand)
+      end
+
       private
 
       def namespaced_builder_klass(brand, klass_name)
-        raise ArgumentError, "Unknown brand: #{brand}" unless design_systems.include?(brand)
+        raise ArgumentError, "Unknown brand: #{brand}" unless registered?(brand)
 
         "DesignSystem::#{brand.camelize}::Builders::#{klass_name.camelize}".constantize
       end

data/lib/design_system/version.rb

@@ -1,3 +1,3 @@
 module DesignSystem
-  VERSION = '0.13.2'.freeze
+  VERSION = '0.15.0'.freeze
 end