govuk-components 3.0.0b1 → 3.0.0b2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9916c5fc5a9e7cc9929b62cb227c0a0b39fdf5cb5d3c9108fc95cb6184ce3ea8
-  data.tar.gz: 6b9da5d40f0966423d06e68c948cb71d8ead87335dbcb5ce4f8a9131bd8980a2
+  metadata.gz: ae11984437c0a4e6631d19c4db1211886178b8a70498f3d2592175cb7ba466e9
+  data.tar.gz: 6cfbbf6933643393abf51f6dc6c8b6d6c62c36b5a93e62dbfdd955f3ab845fe1
 SHA512:
-  metadata.gz: d42827c400d5747af53352388f928d546919be9a74d88dcbcb657cbe12c8b7fb924c59df73bde3936760e4596cbacd62b23252a70b45574c3c27f216be0d5b55
-  data.tar.gz: ac8158fdd29aa936270a833ea3c351a6e8374dd932456610532b070fc70af4e8f1e0e22eff32a1c6d75dbdfa939269a1c9e297c52823c397bea1ea00c7fff858
+  metadata.gz: 82da69e1477bd8e07b7c778aff87da77886eb2008bbe470996635445b73de841b03b3fb91b0000d7067072b98a6998ccaafa204447e2ed284b8411204e1ff435
+  data.tar.gz: eb1ce8afdb5562b9de0eeda99bb62122101ac42656ab0a5999f10372ed343c153f8769cc8ab420e06c790c21407e94fb79932c7448c7a36da41a3d02629e62e1

data/README.md

@@ -6,43 +6,43 @@
 [![GitHub license](https://img.shields.io/github/license/DFE-Digital/govuk-components)](https://github.com/DFE-Digital/govuk-components/blob/master/LICENSE)
 [![GOV.UK Design System Version](https://img.shields.io/badge/GOV.UK%20Design%20System-3.13.1-brightgreen)](https://design-system.service.gov.uk)
 
-This gem provides a suite of reusable components for the [GOV.UK Design System](https://design-system.service.gov.uk/). It is intended to provide a lightweight alternative to the [GOV.UK Publishing Components](https://github.com/alphagov/govuk_publishing_components) library and is built with Github's [ViewComponent](https://github.com/github/view_component) framework.
+This gem provides a suite of reusable components for the [GOV.UK Design System](https://design-system.service.gov.uk/). It is intended to provide a lightweight alternative to the [GOV.UK Publishing Components](https://github.com/alphagov/govuk_publishing_components) library and is built with GitHub’s [ViewComponent](https://github.com/github/view_component) framework.
 
 It aims to implement the functionality from the original Nunjucks macros in a way that will feel more familiar to Rails developers. Blocks are preferred over strings of HTML, beneath the surface each component is just a Ruby object, everything is inheritable and overrideable.
 
-## What's included?
+## What’s included?
 
-All of the non-form components from the GOV.UK Design System are implmented by this library as ViewComponents. Form components are implemented by the [form builder](https://govuk-form-builder.netlify.app/).
+All of the non-form components from the GOV.UK Design System are implemented by this library as ViewComponents. Form components are implemented by the [GOV.UK Form Builder](https://govuk-form-builder.netlify.app/).
 
 The provided components are:
 
-* [Accordion](https://dfe-digital.github.io/govuk-components/#accordion)
-* [Back link](https://dfe-digital.github.io/govuk-components/#back-links)
-* [Back to top link](https://dfe-digital.github.io/govuk-components/#back-to-top-link)
-* [Breadcrumbs](https://dfe-digital.github.io/govuk-components/#breadcrumbs)
-* [Cookie banner](https://dfe-digital.github.io/govuk-components/#cookie-banner)
-* [Details](https://dfe-digital.github.io/govuk-components/#details)
-* [Footer](https://dfe-digital.github.io/govuk-components/#footer)
-* [Header](https://dfe-digital.github.io/govuk-components/#header)
-* [Inset text](https://dfe-digital.github.io/govuk-components/#inset-text)
-* [Notification banner](https://dfe-digital.github.io/govuk-components/#notification-banner)
-* [Panel](https://dfe-digital.github.io/govuk-components/#panel)
-* [Phase banner](https://dfe-digital.github.io/govuk-components/#phase-banner)
-* [Skip link](https://dfe-digital.github.io/govuk-components/#skip-link)
-* [Start button](https://dfe-digital.github.io/govuk-components/#start-button)
-* [Summary list](https://dfe-digital.github.io/govuk-components/#summary-list)
-* [Tabs](https://dfe-digital.github.io/govuk-components/#tabs)
-* [Tables](https://dfe-digital.github.io/govuk-components/#table)
-* [Tags](https://dfe-digital.github.io/govuk-components/#tags)
-* [Warning text](https://dfe-digital.github.io/govuk-components/#warning-text)
-
-This library also provides [several link helpers](https://dfe-digital.github.io/govuk-components/#links-and-buttons) that are commonly used in services, including `#govuk_link_to` and `#govuk_button_to`.
+* [Accordion](https://govuk-components.netlify.app/components/accordion)
+* [Back link](https://govuk-components.netlify.app/components/back-links)
+* [Back to top link](https://govuk-components.netlify.app/components/back-to-top-link)
+* [Breadcrumbs](https://govuk-components.netlify.app/components/breadcrumbs)
+* [Cookie banner](https://govuk-components.netlify.app/components/cookie-banner)
+* [Details](https://govuk-components.netlify.app/components/details)
+* [Footer](https://govuk-components.netlify.app/components/footer)
+* [Header](https://govuk-components.netlify.app/components/header)
+* [Inset text](https://govuk-components.netlify.app/components/inset-text)
+* [Notification banner](https://govuk-components.netlify.app/components/notification-banner)
+* [Panel](https://govuk-components.netlify.app/components/panel)
+* [Phase banner](https://govuk-components.netlify.app/components/phase-banner)
+* [Skip link](https://govuk-components.netlify.app/components/skip-link)
+* [Start button](https://govuk-components.netlify.app/components/start-button)
+* [Summary list](https://govuk-components.netlify.app/components/summary-list)
+* [Tabs](https://govuk-components.netlify.app/components/tabs)
+* [Tables](https://govuk-components.netlify.app/components/table)
+* [Tags](https://govuk-components.netlify.app/components/tags)
+* [Warning text](https://govuk-components.netlify.app/components/warning-text)
+
+This library also provides [link](https://govuk-components.netlify.app/helpers/link) and [button](https://govuk-components.netlify.app/helpers/button) helpers.
 
 ## Alternative syntax
 
 All of the components can be rendered in two ways:
 
-* directly using Rails' `#render` method:
+* directly using Rails’ `#render` method:
 
   ```erb
     <%= render GovukComponent::WarningTextComponent.new do %>
@@ -58,25 +58,24 @@ All of the components can be rendered in two ways:
     <% end %>
   ```
 
-  The naming convention for helpers is `govuk_` followed by the component's name in snake case. You can
-  see the full list in [GovukComponentsHelper](app/helpers/govuk_components_helper.rb).
+  The naming convention for helpers is `govuk_` followed by the component’s name in snake case. You can see the full list in [GovukComponentsHelper](app/helpers/govuk_components_helper.rb).
 
 ## Example use
 
-This library allows components to be rendered with Rails' `render` method or via the provided helpers. Here we'll use the `govuk_tabs` to render three tabbed sections:
+This library allows components to be rendered with Rails’ `render` method or via the provided helpers. Here we’ll use the `govuk_tabs` to render three tabbed sections:
 
 ```erb
 <%= govuk_tabs(title: 'Days of the week') do |component| %>
   <% component.tab(label: 'Monday') do %>
-    <p>Monday's child is fair of face</p>
+    <p>Monday’s child is fair of face</p>
   <% end %>
 
   <% component.tab(label: 'Tuesday') do %>
-    <p>Tuesday's child is full of grace</p>
+    <p>Tuesday’s child is full of grace</p>
   <% end %>
 
   <% component.tab(label: 'Wednesday') do %>
-    <p>Wednesday's child is full of woe</p>
+    <p>Wednesday’s child is full of woe</p>
   <% end %>
 <% end %>
 
@@ -107,20 +106,22 @@ require "govuk/components"
 
 ## Installation
 
-Add this line to your application's Gemfile:
+Add this line to your application’s Gemfile:
 
 ```ruby
 gem 'govuk-components'
 ```
 
 And then execute:
-```bash
-$ bundle
+
+```sh
+bundle
 ```
 
 Or install it yourself as:
-```bash
-$ gem install govuk-components
+
+```sh
+gem install govuk-components
 ```
 
 ## Contributing

data/app/components/govuk_component/cookie_banner_component.rb

@@ -1,25 +1,27 @@
-class GovukComponent::CookieBannerComponent < GovukComponent::Base
-  renders_many :messages, GovukComponent::CookieBannerComponent::MessageComponent
+module GovukComponent
+  class CookieBannerComponent < GovukComponent::Base
+    renders_many :messages, "GovukComponent::CookieBannerComponent::MessageComponent"
 
-  attr_accessor :aria_label, :hidden, :hide_in_print
+    attr_accessor :aria_label, :hidden, :hide_in_print
 
-  def initialize(aria_label: "Cookie banner", hidden: false, hide_in_print: true, classes: [], html_attributes: {})
-    super(classes: classes, html_attributes: html_attributes)
+    def initialize(aria_label: "Cookie banner", hidden: false, hide_in_print: true, classes: [], html_attributes: {})
+      super(classes: classes, html_attributes: html_attributes)
 
-    @aria_label    = aria_label
-    @hidden        = hidden
-    @hide_in_print = hide_in_print
-  end
+      @aria_label    = aria_label
+      @hidden        = hidden
+      @hide_in_print = hide_in_print
+    end
 
-  def call
-    tag.div(class: classes, role: "region", aria: { label: aria_label }, data: { nosnippet: true }, hidden: hidden, **html_attributes) do
-      safe_join(messages)
+    def call
+      tag.div(class: classes, role: "region", aria: { label: aria_label }, data: { nosnippet: true }, hidden: hidden, **html_attributes) do
+        safe_join(messages)
+      end
     end
-  end
 
-private
+  private
 
-  def default_classes
-    class_names("govuk-cookie-banner", "govuk-!-display-none-print" => hide_in_print).split
+    def default_classes
+      class_names("govuk-cookie-banner", "govuk-!-display-none-print" => hide_in_print).split
+    end
   end
 end

data/app/components/govuk_component/summary_list_component.rb

@@ -1,29 +1,31 @@
-class GovukComponent::SummaryListComponent < GovukComponent::Base
-  attr_reader :borders
+module GovukComponent
+  class SummaryListComponent < GovukComponent::Base
+    attr_reader :borders
 
-  renders_many :rows, GovukComponent::SummaryListComponent::RowComponent
+    renders_many :rows, "GovukComponent::SummaryListComponent::RowComponent"
 
-  def initialize(borders: true, classes: [], html_attributes: {})
-    super(classes: classes, html_attributes: html_attributes)
+    def initialize(borders: true, classes: [], html_attributes: {})
+      super(classes: classes, html_attributes: html_attributes)
 
-    @borders = borders
-  end
+      @borders = borders
+    end
 
-  def any_row_has_actions?
-    rows.any? { |row| row.href.present? }
-  end
+    def any_row_has_actions?
+      rows.any? { |row| row.href.present? }
+    end
 
-  def classes
-    super.append(borders_class).compact
-  end
+    def classes
+      super.append(borders_class).compact
+    end
 
-private
+  private
 
-  def borders_class
-    %(govuk-summary-list--no-border) unless borders
-  end
+    def borders_class
+      %(govuk-summary-list--no-border) unless borders
+    end
 
-  def default_classes
-    %w(govuk-summary-list)
+    def default_classes
+      %w(govuk-summary-list)
+    end
   end
 end

data/app/components/govuk_component/table_component/body_component.rb

@@ -1,5 +1,5 @@
 class GovukComponent::TableComponent::BodyComponent < GovukComponent::Base
-  renders_many :rows, GovukComponent::TableComponent::RowComponent
+  renders_many :rows, "GovukComponent::TableComponent::RowComponent"
 
   def initialize(rows: nil, first_cell_is_header: false, classes: [], html_attributes: {})
     super(classes: classes, html_attributes: html_attributes)

data/app/components/govuk_component/table_component/cell_component.rb

@@ -4,12 +4,12 @@ class GovukComponent::TableComponent::CellComponent < GovukComponent::Base
   alias_method :numeric?, :numeric
 
   WIDTHS = {
-    "full"           => "govuk-input govuk-!-width-full",
-    "three-quarters" => "govuk-input govuk-!-width-three-quarters",
-    "two-thirds"     => "govuk-input govuk-!-width-two-thirds",
-    "one-half"       => "govuk-input govuk-!-width-one-half",
-    "one-third"      => "govuk-input govuk-!-width-one-third",
-    "one-quarter"    => "govuk-input govuk-!-width-one-quarter",
+    "full"           => "govuk-!-width-full",
+    "three-quarters" => "govuk-!-width-three-quarters",
+    "two-thirds"     => "govuk-!-width-two-thirds",
+    "one-half"       => "govuk-!-width-one-half",
+    "one-third"      => "govuk-!-width-one-third",
+    "one-quarter"    => "govuk-!-width-one-quarter",
   }.freeze
 
   def initialize(header: false, text: nil, numeric: false, width: nil, classes: [], html_attributes: {})

data/app/components/govuk_component/table_component/head_component.rb

@@ -1,5 +1,5 @@
 class GovukComponent::TableComponent::HeadComponent < GovukComponent::Base
-  renders_many :rows, GovukComponent::TableComponent::RowComponent
+  renders_many :rows, "GovukComponent::TableComponent::RowComponent"
 
   attr_reader :row_data
 

data/app/components/govuk_component/table_component/row_component.rb

@@ -1,5 +1,5 @@
 class GovukComponent::TableComponent::RowComponent < GovukComponent::Base
-  renders_many :cells, GovukComponent::TableComponent::CellComponent
+  renders_many :cells, "GovukComponent::TableComponent::CellComponent"
 
   attr_reader :header, :first_cell_is_header
 

data/app/components/govuk_component/table_component.rb

@@ -1,33 +1,35 @@
-class GovukComponent::TableComponent < GovukComponent::Base
-  renders_one :caption, GovukComponent::TableComponent::CaptionComponent
-  renders_one :head, GovukComponent::TableComponent::HeadComponent
-  renders_many :bodies, GovukComponent::TableComponent::BodyComponent
+module GovukComponent
+  class TableComponent < GovukComponent::Base
+    renders_one :caption, "GovukComponent::TableComponent::CaptionComponent"
+    renders_one :head, "GovukComponent::TableComponent::HeadComponent"
+    renders_many :bodies, "GovukComponent::TableComponent::BodyComponent"
 
-  attr_accessor :id, :first_cell_is_header, :caption_text
+    attr_accessor :id, :first_cell_is_header, :caption_text
 
-  def initialize(id: nil, rows: nil, head: nil, caption: nil, first_cell_is_header: false, classes: [], html_attributes: {})
-    super(classes: classes, html_attributes: html_attributes)
+    def initialize(id: nil, rows: nil, head: nil, caption: nil, first_cell_is_header: false, classes: [], html_attributes: {})
+      super(classes: classes, html_attributes: html_attributes)
 
-    @id                   = id
-    @first_cell_is_header = first_cell_is_header
-    @caption_text         = caption
+      @id                   = id
+      @first_cell_is_header = first_cell_is_header
+      @caption_text         = caption
 
-    # when no rows are passed in it's likely we're taking the slot approach
-    return unless rows.presence
+      # when no rows are passed in it's likely we're taking the slot approach
+      return unless rows.presence
 
-    # if no head is passed in,use the first row for headers
-    build(*(head ? [head, rows] : [rows[0], rows[1..]]), caption_text)
-  end
+      # if no head is passed in,use the first row for headers
+      build(*(head ? [head, rows] : [rows[0], rows[1..]]), caption_text)
+    end
 
-private
+  private
 
-  def build(head_data, body_data, caption_text)
-    caption(text: caption_text)
-    head(rows: [head_data])
-    body(rows: body_data, first_cell_is_header: first_cell_is_header)
-  end
+    def build(head_data, body_data, caption_text)
+      caption(text: caption_text)
+      head(rows: [head_data])
+      body(rows: body_data, first_cell_is_header: first_cell_is_header)
+    end
 
-  def default_classes
-    %w(govuk-table)
+    def default_classes
+      %w(govuk-table)
+    end
   end
 end

data/app/components/govuk_component/traits.rb

@@ -0,0 +1 @@
+module GovukComponent::Traits; end

data/app/components/govuk_component.rb

@@ -0,0 +1 @@
+module GovukComponent; end

data/app/helpers/govuk_link_helper.rb

@@ -56,7 +56,11 @@ module GovukLinkHelper
     html_options = build_html_options(extra_options, style: :button)
 
     if block_given?
-      button_to(name, html_options, &block)
+      if Rails.version >= "7.0.0" && name.is_a?(Hash)
+        button_to(name.merge(html_options), &block)
+      else
+        button_to(name, html_options, &block)
+      end
     else
       button_to(name, options, html_options)
     end
@@ -114,7 +118,7 @@ private
     attributes ||= {}
 
     attributes.with_indifferent_access.tap do |attrs|
-      attrs[:class] = Array.wrap(attrs[:class]).prepend(class_name).flatten
+      attrs[:class] = Array.wrap(attrs[:class]).prepend(class_name).flatten.join(" ")
     end
   end
 end

data/lib/govuk/components/version.rb

@@ -1,5 +1,5 @@
 module Govuk
   module Components
-    VERSION = '3.0.0b1'.freeze
+    VERSION = '3.0.0b2'.freeze
   end
 end

metadata

@@ -1,43 +1,55 @@
 --- !ruby/object:Gem::Specification
 name: govuk-components
 version: !ruby/object:Gem::Version
-  version: 3.0.0b1
+  version: 3.0.0b2
 platform: ruby
 authors:
 - DfE developers
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-12-21 00:00:00.000000000 Z
+date: 2022-01-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
   requirement: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 6.1.4.4
     - - ">="
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '6.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 6.1.4.4
     - - ">="
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '6.1'
 - !ruby/object:Gem::Dependency
   name: railties
   requirement: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 6.1.4.4
     - - ">="
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '6.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 6.1.4.4
     - - ">="
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '6.1'
 - !ruby/object:Gem::Dependency
   name: view_component
   requirement: !ruby/object:Gem::Requirement
@@ -150,6 +162,132 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: htmlbeautifier
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.1
+- !ruby/object:Gem::Dependency
+  name: nanoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.11'
+- !ruby/object:Gem::Dependency
+  name: rouge
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.27.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.27.0
+- !ruby/object:Gem::Dependency
+  name: rubypants
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+- !ruby/object:Gem::Dependency
+  name: sass
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sassc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.4.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.4.0
+- !ruby/object:Gem::Dependency
+  name: slim
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.1.0
+- !ruby/object:Gem::Dependency
+  name: slim_lint
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.22.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.22.0
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.0
 description: A collection of components intended to ease the building of GOV.UK Design
   System web applications
 email:
@@ -161,6 +299,7 @@ files:
 - MIT-LICENSE
 - README.md
 - Rakefile
+- app/components/govuk_component.rb
 - app/components/govuk_component/accordion_component.html.erb
 - app/components/govuk_component/accordion_component.rb
 - app/components/govuk_component/accordion_component/section_component.html.erb
@@ -203,6 +342,7 @@ files:
 - app/components/govuk_component/table_component/row_component.html.erb
 - app/components/govuk_component/table_component/row_component.rb
 - app/components/govuk_component/tag_component.rb
+- app/components/govuk_component/traits.rb
 - app/components/govuk_component/traits/custom_classes.rb
 - app/components/govuk_component/traits/custom_html_attributes.rb
 - app/components/govuk_component/warning_text_component.rb
@@ -235,7 +375,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.2.32
 signing_key:
 specification_version: 4
 summary: Lightweight set of reusable GOV.UK Design System components