@nationalarchives/frontend 0.34.1 → 0.35.0

package/govuk-prototype-kit.config.json

@@ -9,22 +9,22 @@
   "templates": [
     {
       "name": "Plain text",
-      "path": "/nationalarchives/templates/plain.njk",
+      "path": "/nationalarchives/templates/prototype-kit/plain.njk",
       "type": "nunjucks"
     },
     {
       "name": "Listing page",
-      "path": "/nationalarchives/templates/list.njk",
+      "path": "/nationalarchives/templates/prototype-kit/list.njk",
       "type": "nunjucks"
     },
     {
       "name": "Index grid page",
-      "path": "/nationalarchives/templates/index-grid.njk",
+      "path": "/nationalarchives/templates/prototype-kit/index-grid.njk",
       "type": "nunjucks"
     },
     {
       "name": "Page not found error page",
-      "path": "/nationalarchives/templates/error-page-not-found.njk",
+      "path": "/nationalarchives/templates/prototype-kit/error-page-not-found.njk",
       "type": "nunjucks"
     }
   ]

package/nationalarchives/components/accordion/macro-options.json

@@ -68,7 +68,8 @@
         "name": "enabled",
         "type": "boolean",
         "required": true,
-        "description": "If `true`, add a button above the accordion that allows the user to open or close all sections."
+        "description": "If `true`, add a button above the accordion that allows the user to open or close all sections.",
+        "default": false
       },
       {
         "name": "openAllLabel",

package/nationalarchives/components/button/macro-options.json

@@ -39,43 +39,50 @@
     "name": "accent",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, set the colour of the button to the page’s accent colour."
+    "description": "If `true`, set the colour of the button to the page’s accent colour.",
+    "default": false
   },
   {
     "name": "small",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, make the button smaller."
+    "description": "If `true`, make the button smaller.",
+    "default": false
   },
   {
     "name": "plain",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, remove the background colour of the button and make it look more like a link."
+    "description": "If `true`, remove the background colour of the button and make it look more like a link.",
+    "default": false
   },
   {
     "name": "iconOnly",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, don’t show the text of the button."
+    "description": "If `true`, don’t show the text of the button.",
+    "default": false
   },
   {
     "name": "iconOnlyOnMobile",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, show both the text and icon on larger devices but only show the icon on smaller devices."
+    "description": "If `true`, show both the text and icon on larger devices but only show the icon on smaller devices.",
+    "default": false
   },
   {
     "name": "rightAlignIcon",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, align the icon to the right hand side of the button."
+    "description": "If `true`, align the icon to the right hand side of the button.",
+    "default": false
   },
   {
     "name": "buttonElement",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, use a `<button>` element for the button. This makes the `href` attribute redundant."
+    "description": "If `true`, use a `<button>` element for the button. This makes the `href` attribute redundant.",
+    "default": false
   },
   {
     "name": "buttonType",

package/nationalarchives/components/card/macro-options.json

@@ -114,7 +114,8 @@
     "name": "lazyImage",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, make the image a lazily-loaded image."
+    "description": "If `true`, make the image a lazily-loaded image.",
+    "default": false
   },
   {
     "name": "label",
@@ -158,13 +159,15 @@
     "name": "metaStacked",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, stack the list of meta information vertically."
+    "description": "If `true`, stack the list of meta information vertically.",
+    "default": false
   },
   {
     "name": "accentMeta",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, apply an accented background to the meta items."
+    "description": "If `true`, apply an accented background to the meta items.",
+    "default": false
   },
   {
     "name": "body",
@@ -220,31 +223,36 @@
     "name": "fullAreaClick",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, `href` is set and there are no actions, allow users to click anywhere on the card to follow the link."
+    "description": "If `true`, `href` is set and there are no actions, allow users to click anywhere on the card to follow the link.",
+    "default": false
   },
   {
     "name": "horizontal",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, change the card to a horizontal layout, placing the image to the left of the content. This layout changes back to vertical on smaller devices."
+    "description": "If `true`, change the card to a horizontal layout, placing the image to the left of the content. This layout changes back to vertical on smaller devices.",
+    "default": false
   },
   {
     "name": "horizontalOnSmall",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, use a horizontal layout on small devices."
+    "description": "If `true`, use a horizontal layout on small devices.",
+    "default": false
   },
   {
     "name": "horizontalFlipped",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, place the image on the right when using horizontal layouts."
+    "description": "If `true`, place the image on the right when using horizontal layouts.",
+    "default": false
   },
   {
     "name": "horizontalSmallImage",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, use a smaller image when using horizontal layouts."
+    "description": "If `true`, use a smaller image when using horizontal layouts.",
+    "default": false
   },
   {
     "name": "style",
@@ -256,13 +264,15 @@
     "name": "plainSupertitle",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, remove the accent or contrast colour from the card supertitle."
+    "description": "If `true`, remove the accent or contrast colour from the card supertitle.",
+    "default": false
   },
   {
     "name": "accentMeta",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, meta tags adopt an accented style."
+    "description": "If `true`, meta tags adopt an accented style.",
+    "default": false
   },
   {
     "name": "htmlElement",

package/nationalarchives/components/checkboxes/macro-options.json

@@ -78,7 +78,8 @@
         "name": "checked",
         "type": "boolean",
         "required": false,
-        "description": "If `true`, the checkbox will be checked."
+        "description": "If `true`, the checkbox will be checked.",
+        "default": false
       }
     ]
   },
@@ -86,13 +87,15 @@
     "name": "small",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, show smaller checkboxes."
+    "description": "If `true`, show smaller checkboxes.",
+    "default": false
   },
   {
     "name": "inline",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, show the checkboxes inline rather than vertical."
+    "description": "If `true`, show the checkboxes inline rather than vertical.",
+    "default": false
   },
   {
     "name": "formItemClasses",

package/nationalarchives/components/checkboxes/template.njk

@@ -1,5 +1,5 @@
-{% from "nationalarchives/components/fieldset/macro.njk" import tnaFieldset %}
-{% from "nationalarchives/utilities/forms/form-item.njk" import tnaFormItem %}
+{%- from "nationalarchives/components/fieldset/macro.njk" import tnaFieldset -%}
+{%- from "nationalarchives/utilities/forms/form-item.njk" import tnaFormItem -%}
 
 {% macro checkboxes(params) %}
   <div class="tna-checkboxes{% if params.small or params.inline %} tna-checkboxes--small{% endif %}{% if params.inline %} tna-checkboxes--inline{% endif %}"{% if (params.items | length != 1) %} id="{{ params.id }}"{% endif %}>

package/nationalarchives/components/cookie-banner/template.njk

@@ -1,4 +1,4 @@
-{% from "nationalarchives/components/button/macro.njk" import tnaButton %}
+{%- from "nationalarchives/components/button/macro.njk" import tnaButton -%}
 
 {%- set containerClasses = [params.classes] if params.classes else [] -%}
 {%- if params.style == "contrast" -%}

package/nationalarchives/components/date-input/macro-options.json

@@ -86,7 +86,8 @@
     "name": "progressive",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, order the date fields in a year-month-day order and only show the next field when the previous has a valid value."
+    "description": "If `true`, order the date fields in a year-month-day order and only show the next field when the previous has a valid value.",
+    "default": false
   },
   {
     "name": "formItemClasses",

package/nationalarchives/components/date-input/template.njk

@@ -1,7 +1,7 @@
-{% from "nationalarchives/components/fieldset/macro.njk" import tnaFieldset %}
-{% from "nationalarchives/components/date-input/date-input-day.njk" import tnaDateInputDayElement %}
-{% from "nationalarchives/components/date-input/date-input-month.njk" import tnaDateInputMonthElement %}
-{% from "nationalarchives/components/date-input/date-input-year.njk" import tnaDateInputYearElement %}
+{%- from "nationalarchives/components/fieldset/macro.njk" import tnaFieldset -%}
+{%- from "nationalarchives/components/date-input/date-input-day.njk" import tnaDateInputDayElement -%}
+{%- from "nationalarchives/components/date-input/date-input-month.njk" import tnaDateInputMonthElement -%}
+{%- from "nationalarchives/components/date-input/date-input-year.njk" import tnaDateInputYearElement -%}
 
 {%- call tnaFieldset({
   headingLevel: params.headingLevel,

package/nationalarchives/components/date-search/macro-options.json

@@ -60,7 +60,8 @@
     "name": "maxWidth",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, make the date search field expand to the full width of the container."
+    "description": "If `true`, make the date search field expand to the full width of the container.",
+    "default": false
   },
   {
     "name": "formItemClasses",

package/nationalarchives/components/date-search/template.njk

@@ -1,4 +1,4 @@
-{% from "nationalarchives/utilities/forms/form-item.njk" import tnaFormItem %}
+{%- from "nationalarchives/utilities/forms/form-item.njk" import tnaFormItem -%}
 
 {%- call tnaFormItem({
   headingLevel: params.headingLevel,

package/nationalarchives/components/details/macro-options.json

@@ -21,7 +21,8 @@
     "name": "open",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, open the details component."
+    "description": "If `true`, open the details component by default.",
+    "default": false
   },
   {
     "name": "classes",

package/nationalarchives/components/error-summary/macro-options.json

@@ -37,7 +37,8 @@
     "name": "disableAutoFocus",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, disables the automatic focusing of the error summary when the page loads."
+    "description": "If `true`, disables the automatic focusing of the error summary when the page loads.",
+    "default": false
   },
   {
     "name": "classes",

package/nationalarchives/components/fieldset/macro-options.json

@@ -40,7 +40,8 @@
     "name": "smallerHint",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, make the fieldset hint smaller to match other form field components."
+    "description": "If `true`, make the fieldset hint smaller to match other form field components.",
+    "default": false
   },
   {
     "name": "error",

package/nationalarchives/components/file-input/template.njk

@@ -1,4 +1,4 @@
-{% from "nationalarchives/utilities/forms/form-item.njk" import tnaFormItem %}
+{%- from "nationalarchives/utilities/forms/form-item.njk" import tnaFormItem -%}
 
 {%- call tnaFormItem({
   headingLevel: params.headingLevel,

package/nationalarchives/components/files-list/macro-options.json

@@ -65,7 +65,8 @@
     "name": "fullAreaClick",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, allow users to click anywhere on one of the files to follow the link."
+    "description": "If `true`, allow users to click anywhere on one of the files to follow the link.",
+    "default": false
   },
   {
     "name": "classes",

package/nationalarchives/components/footer/macro-options.json

@@ -3,7 +3,8 @@
     "name": "defaultContent",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, use the default content for the footer."
+    "description": "If `true`, use the default content for the footer.",
+    "default": false
   },
   {
     "name": "defaultContentBaseURL",
@@ -73,7 +74,8 @@
         "name": "hideTitle",
         "type": "boolean",
         "required": false,
-        "description": "If `true`, hide the title of the navigation section."
+        "description": "If `true`, hide the title of the navigation section.",
+        "default": false
       },
       {
         "name": "items",
@@ -103,7 +105,8 @@
             "name": "newTab",
             "type": "boolean",
             "required": false,
-            "description": "If `true`, open the link in a new tab."
+            "description": "If `true`, open the link in a new tab.",
+            "default": false
           }
         ]
       }
@@ -139,7 +142,8 @@
     "name": "themeSelector",
     "type": "boolean",
     "required": false,
-    "description": "Enable the theme selector (once settings cookies have been accepted)."
+    "description": "If `true`, display the theme selector.",
+    "default": false
   },
   {
     "name": "currentTheme",

package/nationalarchives/components/footer/template.njk

@@ -1,5 +1,5 @@
-{% from "nationalarchives/components/button/macro.njk" import tnaButton %}
-{% from "nationalarchives/templates/partials/logo.njk" import tnaLogo %}
+{%- from "nationalarchives/components/button/macro.njk" import tnaButton -%}
+{%- from "nationalarchives/templates/partials/logo/macro.njk" import tnaLogo -%}
 
 {%- set containerClasses = [params.classes] if params.classes else [] -%}
 {%- set classes = containerClasses | join(' ') -%}

package/nationalarchives/components/gallery/macro-options.json

@@ -78,7 +78,8 @@
     "name": "bounded",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, add a background to the gallery to separate it from surrounding contnet."
+    "description": "If `true`, add a background to the gallery to separate it from surrounding contnet.",
+    "default": false
   },
   {
     "name": "classes",

package/nationalarchives/components/gallery/template.njk

@@ -1,4 +1,4 @@
-{% from "nationalarchives/components/button/macro.njk" import tnaButton %}
+{%- from "nationalarchives/components/button/macro.njk" import tnaButton -%}
 
 {%- set containerClasses = [params.classes] if params.classes else [] -%}
 {%- if params.bounded -%}

package/nationalarchives/components/global-header/macro-options.json

@@ -3,7 +3,8 @@
     "name": "defaultContent",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, use the default content for the global header."
+    "description": "If `true`, use the default content for the global header.",
+    "default": false
   },
   {
     "name": "defaultContentBaseURL",

package/nationalarchives/components/global-header/template.njk

@@ -1,5 +1,5 @@
-{% from "nationalarchives/components/phase-banner/macro.njk" import tnaPhaseBanner %}
-{% from "nationalarchives/templates/partials/logo.njk" import tnaLogo %}
+{%- from "nationalarchives/components/phase-banner/macro.njk" import tnaPhaseBanner -%}
+{%- from "nationalarchives/templates/partials/logo/macro.njk" import tnaLogo -%}
 
 {%- set containerClasses = [params.classes] if params.classes else [] -%}
 {%- if params.collapseOnMedium -%}

package/nationalarchives/components/header/macro-options.json

@@ -53,7 +53,8 @@
         "name": "selected",
         "type": "boolean",
         "required": false,
-        "description": "If `true`, highlight this navigation item as the currently selected page or section."
+        "description": "If `true`, highlight this navigation item as the currently selected page or section.",
+        "default": false
       }
     ]
   },
@@ -93,7 +94,8 @@
     "name": "accent",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, use the page's accent colour as the background colour for the header."
+    "description": "If `true`, use the page's accent colour as the background colour for the header.",
+    "default": false
   },
   {
     "name": "navigationId",

package/nationalarchives/components/header/template.njk

@@ -1,5 +1,5 @@
-{% from "nationalarchives/components/phase-banner/macro.njk" import tnaPhaseBanner %}
-{% from "nationalarchives/templates/partials/logo.njk" import tnaLogo %}
+{%- from "nationalarchives/components/phase-banner/macro.njk" import tnaPhaseBanner -%}
+{%- from "nationalarchives/templates/partials/logo/macro.njk" import tnaLogo -%}
 
 {%- set containerClasses = [params.classes] if params.classes else [] -%}
 {%- if params.accent -%}

package/nationalarchives/components/hero/macro-options.json

@@ -139,7 +139,8 @@
         "name": "rightAlignIcon",
         "type": "boolean",
         "required": false,
-        "description": "If `true`, align the icon to the right hand side of the button."
+        "description": "If `true`, align the icon to the right hand side of the button.",
+        "default": false
       },
       {
         "name": "classes",
@@ -171,7 +172,8 @@
     "name": "narrow",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, use a narrower style hero image."
+    "description": "If `true`, use a narrower style hero image.",
+    "default": false
   },
   {
     "name": "classes",

package/nationalarchives/components/hero/template.njk

@@ -1,4 +1,4 @@
-{% from "nationalarchives/components/button/macro.njk" import tnaButton %}
+{%- from "nationalarchives/components/button/macro.njk" import tnaButton -%}
 
 {%- set containerClasses = [params.classes] if params.classes else [] -%}
 {%- if params.style == "contrast" -%}

package/nationalarchives/components/index-grid/macro-options.json

@@ -114,7 +114,8 @@
     "name": "lazyImages",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, make the images a lazily-loaded."
+    "description": "If `true`, make the images a lazily-loaded.",
+    "default": false
   },
   {
     "name": "columns",

package/nationalarchives/components/pagination/macro-options.json

@@ -54,13 +54,15 @@
         "name": "current",
         "type": "boolean",
         "required": false,
-        "description": "If `true`, highlight this item as the current page."
+        "description": "If `true`, highlight this item as the current page.",
+        "default": false
       },
       {
         "name": "ellipsis",
         "type": "boolean",
         "required": false,
-        "description": "Use this option if you want to specify an ellipsis at a given point between numbers. If you set this option as `true`, any other options for the item are ignored."
+        "description": "Use this option to specify an ellipsis at a given point between numbers. If you set this option as `true`, any other options for the item are ignored.",
+        "default": false
       }
     ]
   },

package/nationalarchives/components/pagination/template.njk

@@ -1,4 +1,4 @@
-{% from "nationalarchives/components/button/macro.njk" import tnaButton %}
+{%- from "nationalarchives/components/button/macro.njk" import tnaButton -%}
 
 {%- set containerClasses = [params.classes] if params.classes else [] -%}
 {%- set classes = containerClasses | join(' ') -%}

package/nationalarchives/components/picture/template.njk

@@ -1,4 +1,4 @@
-{% from "nationalarchives/components/tabs/macro.njk" import tnaTabs %}
+{%- from "nationalarchives/components/tabs/macro.njk" import tnaTabs -%}
 
 {%- set containerClasses = [params.classes] if params.classes else [] -%}
 {%- set classes = containerClasses | join(' ') -%}

package/nationalarchives/components/quick-filters/macro-options.json

@@ -27,7 +27,8 @@
         "name": "selected",
         "type": "boolean",
         "required": false,
-        "description": "If `true`, highlight the quick filter as selected."
+        "description": "If `true`, highlight the quick filter as selected.",
+        "default": false
       }
     ]
   },
@@ -35,7 +36,8 @@
     "name": "stack",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, stack the quick filters vertically."
+    "description": "If `true`, stack the quick filters vertically.",
+    "default": false
   },
   {
     "name": "classes",

package/nationalarchives/components/radios/macro-options.json

@@ -86,13 +86,15 @@
     "name": "small",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, show smaller radios."
+    "description": "If `true`, show smaller radios.",
+    "default": false
   },
   {
     "name": "inline",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, show the radios inline rather than vertical."
+    "description": "If `true`, show the radios inline rather than vertical.",
+    "default": false
   },
   {
     "name": "formItemClasses",

package/nationalarchives/components/radios/template.njk

@@ -1,4 +1,4 @@
-{% from "nationalarchives/components/fieldset/macro.njk" import tnaFieldset %}
+{%- from "nationalarchives/components/fieldset/macro.njk" import tnaFieldset -%}
 
 {%- call tnaFieldset({
   headingLevel: params.headingLevel,

package/nationalarchives/components/search-field/template.njk

@@ -1,5 +1,5 @@
-{% from "nationalarchives/components/button/macro.njk" import tnaButton %}
-{% from "nationalarchives/utilities/forms/form-item.njk" import tnaFormItem %}
+{%- from "nationalarchives/components/button/macro.njk" import tnaButton -%}
+{%- from "nationalarchives/utilities/forms/form-item.njk" import tnaFormItem -%}
 
 {%- call tnaFormItem({
   headingLevel: params.headingLevel,

package/nationalarchives/components/secondary-navigation/macro-options.json

@@ -40,7 +40,8 @@
         "name": "current",
         "type": "boolean",
         "required": false,
-        "description": "If `true`, highlight the navigation item as the current page."
+        "description": "If `true`, highlight the navigation item as the current page.",
+        "default": false
       }
     ]
   },
@@ -48,19 +49,22 @@
     "name": "noBottomBorder",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, hide the bottom border of the secondary navigation. This can be useful when the secondary navigation is placed at the bottom of a coloured block."
+    "description": "If `true`, hide the bottom border of the secondary navigation. This can be useful when the secondary navigation is placed at the bottom of a coloured block.",
+    "default": false
   },
   {
     "name": "overflow",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, enable horizontal scrolling for the secondary navigation when the list of items becomes too long."
+    "description": "If `true`, enable horizontal scrolling for the secondary navigation when the list of items becomes too long.",
+    "default": false
   },
   {
     "name": "noUnindentation",
     "type": "boolean",
     "required": false,
-    "description": "If `true`, don't apply 'unindentation' to the secondary navigation. Used for when the secondary navigation is placed inside a nested container."
+    "description": "If `true`, don't apply 'unindentation' to the secondary navigation. Used for when the secondary navigation is placed inside a nested container.",
+    "default": false
   },
   {
     "name": "classes",

package/nationalarchives/components/select/template.njk

@@ -1,4 +1,4 @@
-{% from "nationalarchives/utilities/forms/form-item.njk" import tnaFormItem %}
+{%- from "nationalarchives/utilities/forms/form-item.njk" import tnaFormItem -%}
 
 {%- set containerClasses = [params.formItemClasses] if params.formItemClasses else [] -%}
 {%- if params.inline -%}