design_system 0.12.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 682961e5ace6d1fb7a0e9efbd5f5bf9d588eb4858f7ec7013db2188771d25de8
-  data.tar.gz: 9ea72be49b3b50294ef562c7254e94b2b29f908e4f064700106bd22231033be0
+  metadata.gz: b61d6a51f578ccedbe93a430fa8b94388a78b870eab9fc271088750e9c66fca3
+  data.tar.gz: 5dfe10f8b92f07a277716996c7d1c6378ce80f331aaaf29f474e0e3c2ee24c4f
 SHA512:
-  metadata.gz: 4a65a069154023e6768451a889247e824a2dd6a5842d8a219ce4f76e1575b567f369395c0652ea3468bb2a428ab9d29bc95c5894755eadbc9ef2aeafd5f23fc6
-  data.tar.gz: fefa5477b56eaf6dddd30c22697bfbb506842e008c4f8650aa33a5f93b29470a1b576636b22fd06b6c97e0bd68bc44bb225536e7c309fd064c85010db13ccd04
+  metadata.gz: 1a9431fa199c5e2e655029c0bb902de07ebd580668b5eb891cf6a08e9f0c2d00795498ca03f73a936db36255eec48df0cc0bee61e49c6d5ac9cfca8935c44a66
+  data.tar.gz: 5e6635813ca0e9d64a7854f1b276733fa00bd6c767dd652c39f79bc8f40fe3d0b2519fca32907592cd8943d6ffb9beabd0d2bd5b778092a0d68c11468dcc78e1

data/app/helpers/design_system_helper.rb

@@ -78,8 +78,8 @@ module DesignSystemHelper
     DesignSystem::Registry.builder(brand, 'notification', self).render_alert(message, &)
   end
 
-  def ds_notice(message = nil, &)
-    DesignSystem::Registry.builder(brand, 'notification', self).render_notice(message, &)
+  def ds_notice(message = nil, header: nil, type: :information, &)
+    DesignSystem::Registry.builder(brand, 'notification', self).render_notice(message, header:, type:, &)
   end
 
   def ds_heading(text, level: 2, **options)
@@ -118,4 +118,22 @@ module DesignSystemHelper
   def ds_action_link(name = nil, options = nil, html_options = nil)
     DesignSystem::Registry.builder(brand, 'action_link', self).render_action_link(name, options, html_options)
   end
+
+  def ds_grid(options = {}, &)
+    raise ArgumentError unless block_given?
+
+    DesignSystem::Registry.builder(brand, 'grid', self).render_grid(options, &)
+  end
+
+  def ds_paragraph(text = nil, size: nil, **options, &block)
+    DesignSystem::Registry.builder(brand, 'paragraph', self).render_paragraph(text, size:, **options, &block)
+  end
+
+  def ds_list(type: :default, **options, &block)
+    DesignSystem::Registry.builder(brand, 'list', self).render_list(type:, **options, &block)
+  end
+
+  def ds_inset_text(text = nil, ...)
+    DesignSystem::Registry.builder(brand, 'inset_text', self).render_inset_text(text, ...)
+  end
 end

data/lib/design_system/components/grid.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Components
+    # This class provides a grid component.
+    class Grid
+      attr_accessor :columns
+
+      WIDTHS = {
+        full: { class: 'full', fraction: Rational(1, 1) },
+        half: { class: 'one-half', fraction: Rational(1, 2) },
+        one_half: { class: 'one-half', fraction: Rational(1, 2) },
+        two_thirds: { class: 'two-thirds', fraction: Rational(2, 3) },
+        one_third: { class: 'one-third', fraction: Rational(1, 3) },
+        three_quarters: { class: 'three-quarters', fraction: Rational(3, 4) },
+        quarter: { class: 'one-quarter', fraction: Rational(1, 4) },
+        one_quarter: { class: 'one-quarter', fraction: Rational(1, 4) }
+      }.freeze
+
+      def initialize
+        @columns = []
+      end
+
+      def add_column(width, options = {}, &block)
+        @columns << { width:, options:, block: }
+      end
+
+      def validate_total_width!
+        total = columns.sum { |col| width_to_fraction(col[:width]) }
+        raise ArgumentError, 'Total grid width exceeds 100%' if total > 1
+      end
+
+      private
+
+      def width_to_fraction(width)
+        config = WIDTHS[width]
+        raise ArgumentError, "Unknown grid width: #{width}" unless config
+
+        config[:fraction]
+      end
+    end
+  end
+end

data/lib/design_system/components/list.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Components
+    # Simple list component used by the generic list builder.
+    class List
+      attr_reader :items
+
+      def initialize
+        @items = []
+      end
+
+      def add_item(content = nil, &block)
+        @items << (block_given? ? block : content)
+      end
+    end
+  end
+end

data/lib/design_system/components/summary_list.rb

@@ -2,6 +2,7 @@
 
 module DesignSystem
   module Components
+    # This class provides a summary list component.
     class SummaryList
       attr_accessor :rows
 
@@ -23,6 +24,7 @@ module DesignSystem
       end
     end
 
+    # This class provides a builder for a summary list row.
     class SummaryListRowBuilder
       attr_reader :row
 

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Generic
+    module Builders
+      module Elements
+        # This mixin module is used to provide lead paragraphs.
+        module LeadParagraph
+          def lead_paragraph(text = nil, &)
+            raise ArgumentError, 'Lead paragraph can only be used once per page' if @lead_paragraph
+
+            @lead_paragraph = block_given? ? capture(&) : text
+          end
+
+          private
+
+          def render_lead_paragraph
+            # Lead paragraph is a large body paragraph that should be used at the page top and once per page.
+            return unless @lead_paragraph
+
+            content_tag('p', @lead_paragraph, class: "#{brand}-body-l")
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -9,6 +9,7 @@ module DesignSystem
         include Elements::Breadcrumbs
         include Elements::Form
         include Elements::Headings
+        include Elements::LeadParagraph
 
         def render
           raise ArgumentError, 'Cannot use both backlink and breadcrumbs' if @backlink && @breadcrumbs.present?
@@ -20,6 +21,7 @@ module DesignSystem
             safe_buffer = ActiveSupport::SafeBuffer.new
 
             safe_buffer.concat(render_main_heading) if @main_heading
+            safe_buffer.concat(render_lead_paragraph) if @lead_paragraph
             safe_buffer.concat(render_form) if @form_object
 
             safe_buffer

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

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Generic
+    module Builders
+      # This class provides a generic grid builder.
+      class Grid < Base
+        include ActionView::Helpers::OutputSafetyHelper
+
+        def render_grid(options = {})
+          @grid = ::DesignSystem::Components::Grid.new
+          yield @grid
+          @grid.validate_total_width!
+
+          row_options = css_class_options_merge(options, ["#{brand}-grid-row"])
+          content_tag(:div, **row_options) do
+            safe_buffer = ActiveSupport::SafeBuffer.new
+            safe_buffer.concat(render_columns)
+
+            safe_buffer
+          end
+        end
+
+        private
+
+        def render_columns
+          @grid.columns.each_with_object(ActiveSupport::SafeBuffer.new) do |column, buffer|
+            column_options = column[:options].dup
+            column_class = grid_class(column[:width])
+            column_options = css_class_options_merge(column_options, [column_class])
+
+            block = column[:block]
+            content = capture(&block) if block
+            buffer.concat(content_tag(:div, content, **column_options))
+          end
+        end
+
+        def grid_class(width)
+          "#{brand}-grid-column-#{::DesignSystem::Components::Grid::WIDTHS[width][:class]}"
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Generic
+    module Builders
+      # This generates html for rendering inset text to help users identify and understand important content on the page.
+      class InsetText < Base
+        def render_inset_text(text = nil, **options, &)
+          content = block_given? ? capture(&) : text
+          return if content.blank?
+
+          div_options = css_class_options_merge(options, ["#{brand}-inset-text"])
+          content_tag(:div, content, **div_options)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Generic
+    module Builders
+      # Generic list builder.
+      class List < Base
+        # type: :bullet, :number
+        def render_list(type: :default, **options)
+          raise ArgumentError, 'block required' unless block_given?
+
+          @list = ::DesignSystem::Components::List.new
+          yield @list
+
+          tag_name = type.to_sym == :number ? :ol : :ul
+
+          classes = ["#{brand}-list"]
+          classes << "#{brand}-list--bullet" if type == :bullet
+          classes << "#{brand}-list--number" if type == :number
+
+          options = css_class_options_merge(options, classes)
+
+          content_tag(tag_name, **options) do
+            render_items
+          end
+        end
+
+        private
+
+        def render_items
+          @list.items.each_with_object(ActiveSupport::SafeBuffer.new) do |item, buffer|
+            content = item.is_a?(Proc) ? capture(&item) : item
+            next if content.blank?
+
+            buffer.concat(content_tag(:li, content))
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -16,23 +16,28 @@ module DesignSystem
           end
         end
 
-        def render_notice(msg = nil, &)
+        def render_notice(msg = nil, header: nil, type: :information, &)
           @context.instance_variable_set(:@link_context, :notification_banner)
 
+          raise ArgumentError,
+                "Invalid notification type: #{type}. Must be one of: #{notification_type_hash.keys.join(', ')}" unless notification_type_hash.key?(type)
+
+          header ||= notification_type_hash.dig(type, :header)
+
           content_to_display = block_given? ? capture(&) : msg
-          content_tag(:div, class: "#{brand}-notification-banner", role: 'region',
+          content_tag(:div, class: notification_type_hash.dig(type, :class), role: notification_type_hash.dig(type, :role),
                             'aria-labelledby': "#{brand}-notification-banner-title",
                             'data-module': "#{brand}-notification-banner") do
-            banner_tile + banner_content(content_to_display)
+            banner_tile(header) + banner_content(content_to_display)
           end
         end
 
         private
 
-        def banner_tile
+        def banner_tile(header)
           content_tag(:div, class: "#{brand}-notification-banner__header") do
-            content_tag(:h2, 'Important', class: "#{brand}-notification-banner__title",
-                                          id: "#{brand}-notification-banner-title")
+            content_tag(:h2, header, class: "#{brand}-notification-banner__title",
+                                     id: "#{brand}-notification-banner-title")
           end
         end
 
@@ -42,6 +47,21 @@ module DesignSystem
                         class: "#{brand}-notification-banner__heading")
           end
         end
+
+        def notification_type_hash
+          {
+            information: {
+              header: 'Important',
+              class: "#{brand}-notification-banner",
+              role: 'region'
+            },
+            success: {
+              header: 'Success',
+              class: "#{brand}-notification-banner #{brand}-notification-banner--success",
+              role: 'alert'
+            }
+          }
+        end
       end
     end
   end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Generic
+    module Builders
+      # This class provides generic methods to display paragraphs with typography styles.
+      class Paragraph < Base
+        FONT_SIZES = %i[s].freeze
+
+        def render_paragraph(text = nil, size: nil, **options, &block)
+          content = block_given? ? capture(&block) : text
+          return if content.blank?
+
+          content_tag('p', content, class: classes(size), **options)
+        end
+
+        private
+
+        def classes(size)
+          return "#{brand}-body" if size.nil?
+          raise ArgumentError, "Invalid size: #{size}" unless size.in?(FONT_SIZES)
+
+          "#{brand}-body-#{size}"
+        end
+      end
+    end
+  end
+end

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

@@ -3,6 +3,7 @@
 module DesignSystem
   module Generic
     module Builders
+      # This class provides generic summary list.
       class SummaryList < Base
         include ActionView::Helpers::OutputSafetyHelper
 
@@ -25,7 +26,10 @@ module DesignSystem
         end
 
         def render_row(row)
-          content_tag(:div, class: "#{brand}-summary-list__row") do
+          row_classes = ["#{brand}-summary-list__row"]
+          row_classes << "#{brand}-summary-list__row--no-actions" if row[:actions].blank?
+
+          content_tag(:div, class: row_classes.join(' ')) do
             [render_key(row),
              render_value(row),
              render_actions(row)].compact.join.html_safe
@@ -37,10 +41,10 @@ module DesignSystem
         end
 
         def render_value(row)
-          return if row[:values].nil? || row[:values].empty?
-
           content_tag(:dd, class: "#{brand}-summary-list__value") do
-            if row[:values].length == 1
+            if row[:values].blank?
+              ''
+            elsif row[:values].length == 1
               row[:values].first[:content]
             else
               row[:values].map { |value| content_tag(:p, value[:content], class: "#{brand}-body") }.join.html_safe
@@ -49,7 +53,7 @@ module DesignSystem
         end
 
         def render_actions(row)
-          return if row[:actions].nil? || row[:actions].empty?
+          return if row[:actions].blank?
 
           content_tag(:dd, class: "#{brand}-summary-list__actions") do
             if row[:actions].length == 1
@@ -65,8 +69,12 @@ module DesignSystem
         end
 
         def render_action(action)
-          link_to(action[:options][:path] || '#', class: "#{brand}-link") do
-            safe_join([action[:content], render_hidden_text(action[:options][:hidden_text])])
+          options = action[:options].dup
+          path = options.delete(:path) || '#'
+          hidden_text = options.delete(:hidden_text)
+
+          link_to(path, { class: "#{brand}-link" }.merge(options)) do
+            safe_join([action[:content], render_hidden_text(hidden_text)])
           end
         end
 

data/lib/design_system/generic.rb

@@ -7,10 +7,14 @@ require_relative 'generic/builders/button'
 require_relative 'generic/builders/callout'
 require_relative 'generic/builders/details'
 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/grid.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Govuk
+    module Builders
+      # GOV UK specific grid implementation
+      # Inherits all functionality from generic builder
+      class Grid < ::DesignSystem::Generic::Builders::Grid
+      end
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Govuk
+    module Builders
+      # This generates html for rendering inset text for Govuk
+      class InsetText < ::DesignSystem::Generic::Builders::InsetText
+      end
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Govuk
+    module Builders
+      # GOVUK specific list builder.
+      class List < ::DesignSystem::Generic::Builders::List
+      end
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Govuk
+    module Builders
+      # This class provides GOVUK methods to display paragraphs in page content.
+      class Paragraph < ::DesignSystem::Generic::Builders::Paragraph
+      end
+    end
+  end
+end

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

@@ -3,25 +3,15 @@
 module DesignSystem
   module Govuk
     module Builders
+      # This class provides GOVUK Summary List.
       class SummaryList < ::DesignSystem::Generic::Builders::SummaryList
         private
 
-        def render_row(row)
-          row_classes = ['govuk-summary-list__row']
-          row_classes << 'govuk-summary-list__row--no-actions' if row[:actions].empty?
-
-          content_tag(:div, class: row_classes.join(' ')) do
-            [render_key(row),
-             render_value(row),
-             render_actions(row)].compact.join.html_safe
-          end
-        end
-
         def render_value(row)
-          return if row[:values].nil? || row[:values].empty?
-
           content_tag(:dd, class: 'govuk-summary-list__value') do
-            if row[:values].length == 1
+            if row[:values].blank?
+              ''
+            elsif row[:values].length == 1
               wrap_value(row[:values].first)
             else
               row[:values].map { |value| wrap_value(value) }.join.html_safe

data/lib/design_system/govuk/form_builder.rb

@@ -389,9 +389,9 @@ module DesignSystem
 
       def translated_label(method)
         # We need to retrieve the label translation in the same way as Tags::Label
-        content ||= ActionView::Helpers::Tags::Translator.
-                    new(object, object_name, method, scope: 'helpers.label').
-                    translate
+        content ||= ActionView::Helpers::Tags::Translator
+                    .new(object, object_name, method, scope: 'helpers.label')
+                    .translate
         content || method.humanize
       end
 
@@ -399,9 +399,12 @@ module DesignSystem
         # This method is used to translate the label for a given value
         # Example: assign an alternative name for checkbox items
         method_and_value = "#{method}.#{value}"
-        translation = ActionView::Helpers::Tags::Translator.
-                      new(object, object_name, method_and_value, scope: 'helpers.options').
-                      translate
+        translation = ActionView::Helpers::Tags::Translator
+                      .new(object, object_name, method_and_value, scope: 'helpers.options')
+                      .translate
+
+        return value.to_s if translation.nil?
+
         # If translation returns the humanized version of the value,
         # it means no translation was found, so return the original value
         # Extra condition: if value contains dots and translation is only the last part

data/lib/design_system/govuk.rb

@@ -8,9 +8,11 @@ require_relative 'govuk/builders/details'
 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'

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

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Nhsuk
+    module Builders
+      # NHS UK specific grid implementation
+      # Inherits all functionality from generic builder
+      class Grid < ::DesignSystem::Generic::Builders::Grid
+      end
+    end
+  end
+end

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

@@ -0,0 +1,109 @@
+require 'test_helper'
+
+module DesignSystem
+  module Nhsuk
+    module Builders
+      # This tests the nhsuk grid builder
+      class GridTest < ActionView::TestCase
+        include DesignSystemHelper
+
+        setup do
+          @brand = 'nhsuk'
+          @controller.stubs(:brand).returns(@brand)
+        end
+
+        test 'should fail if width is specified' do
+          assert_raises(ArgumentError) do
+            ds_grid do |grid|
+              grid.add_column do
+                'Test content'
+              end
+            end
+          end
+        end
+
+        test 'should fail if given width is not supported' do
+          error = assert_raises(ArgumentError) do
+            ds_grid do |grid|
+              grid.add_column(:nonsense_width) do
+                'Test content'
+              end
+            end
+          end
+          assert_equal 'Unknown grid width: nonsense_width', error.message
+        end
+
+        test 'should render block of content' do
+          @output_buffer = ds_grid do |grid|
+            grid.add_column(:two_thirds) do
+              content_tag(:p, 'Test content')
+            end
+          end
+
+          assert_select "div.#{brand}-grid-row" do
+            assert_select "div.#{brand}-grid-column-two-thirds" do
+              assert_select 'p', text: 'Test content'
+            end
+          end
+        end
+
+        test 'should render multiple columns' do
+          @output_buffer = ds_grid do |grid|
+            grid.add_column(:two_thirds) do
+              content_tag(:p, 'Two thirds content')
+            end
+            grid.add_column(:one_third) do
+              content_tag(:p, 'One third content')
+            end
+          end
+          assert_select "div.#{brand}-grid-row" do
+            assert_select "div.#{brand}-grid-column-two-thirds" do
+              assert_select 'p', text: 'Two thirds content'
+            end
+            assert_select "div.#{brand}-grid-column-one-third" do
+              assert_select 'p', text: 'One third content'
+            end
+          end
+        end
+
+        test 'should raise an error if total width exceeds 100%' do
+          error = assert_raises(ArgumentError) do
+            ds_grid do |grid|
+              grid.add_column(:two_thirds) do
+                content_tag(:p, 'Two thirds content')
+              end
+              grid.add_column(:two_thirds) do
+                content_tag(:p, 'Two thirds content')
+              end
+            end
+          end
+          assert_equal 'Total grid width exceeds 100%', error.message
+        end
+
+        test 'should render nested grid' do
+          @output_buffer = ds_grid do |row|
+            row.add_column(:two_thirds) do
+              content_tag(:p, 'Outer two thirds content') +
+                ds_grid do |inner_row|
+                  inner_row.add_column(:two_thirds) do
+                    content_tag(:p, 'Inner two thirds content')
+                  end
+                end
+            end
+          end
+
+          assert_select "div.#{brand}-grid-row" do
+            assert_select "div.#{brand}-grid-column-two-thirds" do
+              assert_select 'p', text: 'Outer two thirds content'
+              assert_select "div.#{brand}-grid-row" do
+                assert_select "div.#{brand}-grid-column-two-thirds" do
+                  assert_select 'p', text: 'Inner two thirds content'
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Nhsuk
+    module Builders
+      # This generates html for rendering inset text for Nhsuk
+      class InsetText < ::DesignSystem::Generic::Builders::InsetText
+        def render_inset_text(text = nil, **options, &)
+          content = block_given? ? capture(&) : text
+          return if content.blank?
+
+          wrapped_content = block_given? ? content : content_tag(:p, content)
+
+          div_options = css_class_options_merge(options, ["#{brand}-inset-text"])
+
+          content_tag(:div, **div_options) do
+            content_tag(:span, 'Information: ', class: "#{brand}-u-visually-hidden") + wrapped_content
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Nhsuk
+    module Builders
+      # Generic list builder for NHSUK.
+      class List < ::DesignSystem::Generic::Builders::List
+      end
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module DesignSystem
+  module Nhsuk
+    module Builders
+      # This class provides NHSUK methods to display paragraphs in page content.
+      class Paragraph < ::DesignSystem::Generic::Builders::Paragraph
+      end
+    end
+  end
+end

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

@@ -3,24 +3,10 @@
 module DesignSystem
   module Nhsuk
     module Builders
+      # This class provides NHSUK Summary List.
       class SummaryList < ::DesignSystem::Generic::Builders::SummaryList
         private
 
-        def validate_mix_actions
-          if @summary_list.rows.any? { |row| row[:actions].empty? } &&
-             @summary_list.rows.any? { |row| row[:actions].any? }
-            raise ArgumentError, "A mix of rows with and without actions is not supported for #{brand} style."
-          end
-        end
-
-        def render_rows
-          validate_mix_actions
-
-          content_tag(:dl, class: "#{brand}-summary-list") do
-            @summary_list.rows.map { |row| render_row(row) }.join.html_safe
-          end
-        end
-
         def render_hidden_text(hidden_text)
           return '' if hidden_text.blank?
 

data/lib/design_system/nhsuk.rb

@@ -6,9 +6,11 @@ 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'

data/lib/design_system/version.rb

@@ -1,3 +1,3 @@
 module DesignSystem
-  VERSION = '0.12.0'.freeze
+  VERSION = '0.13.0'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: design_system
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Filis Liu
@@ -398,6 +398,8 @@ files:
 - config/routes.rb
 - lib/design_system.rb
 - lib/design_system/all.rb
+- lib/design_system/components/grid.rb
+- lib/design_system/components/list.rb
 - lib/design_system/components/summary_list.rb
 - lib/design_system/components/tab.rb
 - lib/design_system/components/table.rb
@@ -413,12 +415,17 @@ files:
 - lib/design_system/generic/builders/elements/breadcrumbs.rb
 - lib/design_system/generic/builders/elements/form.rb
 - lib/design_system/generic/builders/elements/headings.rb
+- lib/design_system/generic/builders/elements/lead_paragraph.rb
 - lib/design_system/generic/builders/fixed_elements.rb
+- lib/design_system/generic/builders/grid.rb
 - lib/design_system/generic/builders/heading.rb
+- lib/design_system/generic/builders/inset_text.rb
 - lib/design_system/generic/builders/link.rb
+- lib/design_system/generic/builders/list.rb
 - lib/design_system/generic/builders/notification.rb
 - lib/design_system/generic/builders/pagination_renderer.rb
 - lib/design_system/generic/builders/panel.rb
+- lib/design_system/generic/builders/paragraph.rb
 - lib/design_system/generic/builders/summary_list.rb
 - lib/design_system/generic/builders/tab.rb
 - lib/design_system/generic/builders/table.rb
@@ -431,11 +438,15 @@ files:
 - lib/design_system/govuk/builders/elements/breadcrumbs.rb
 - lib/design_system/govuk/builders/elements/headings.rb
 - lib/design_system/govuk/builders/fixed_elements.rb
+- lib/design_system/govuk/builders/grid.rb
 - lib/design_system/govuk/builders/heading.rb
+- lib/design_system/govuk/builders/inset_text.rb
 - lib/design_system/govuk/builders/link.rb
+- lib/design_system/govuk/builders/list.rb
 - lib/design_system/govuk/builders/notification.rb
 - lib/design_system/govuk/builders/pagination_renderer.rb
 - lib/design_system/govuk/builders/panel.rb
+- lib/design_system/govuk/builders/paragraph.rb
 - lib/design_system/govuk/builders/summary_list.rb
 - lib/design_system/govuk/builders/tab.rb
 - lib/design_system/govuk/builders/table.rb
@@ -450,11 +461,16 @@ files:
 - lib/design_system/nhsuk/builders/details.rb
 - lib/design_system/nhsuk/builders/elements/breadcrumbs.rb
 - lib/design_system/nhsuk/builders/fixed_elements.rb
+- lib/design_system/nhsuk/builders/grid.rb
+- lib/design_system/nhsuk/builders/grid_test.rb
 - lib/design_system/nhsuk/builders/heading.rb
+- lib/design_system/nhsuk/builders/inset_text.rb
 - lib/design_system/nhsuk/builders/link.rb
+- lib/design_system/nhsuk/builders/list.rb
 - lib/design_system/nhsuk/builders/notification.rb
 - lib/design_system/nhsuk/builders/pagination_renderer.rb
 - lib/design_system/nhsuk/builders/panel.rb
+- lib/design_system/nhsuk/builders/paragraph.rb
 - lib/design_system/nhsuk/builders/summary_list.rb
 - lib/design_system/nhsuk/builders/tab.rb
 - lib/design_system/nhsuk/builders/table.rb