From 4789ed802be7ff418cfa0a8604e945b5b34c57c4 Mon Sep 17 00:00:00 2001
From: Nick Colley <nick.colley@digital.cabinet-office.gov.uk>
Date: Fri, 1 Jun 2018 13:17:08 +0100
Subject: [PATCH 1/2] Update JavaScript global namespace from 'all' to
 'GOVUKFrontend'

This allows JavaScript to be accessed when not using a bundler.

The pre-existing convention for JavaScript on GOV.UK uses
`window.GOVUK`, to avoid conflicting with this we are using a different namespace.
---
 src/all.test.js              | 28 ++++++++++++++++++++++++++++
 tasks/gulp/compile-assets.js |  2 ++
 2 files changed, 30 insertions(+)

diff --git a/src/all.test.js b/src/all.test.js
index 4a458c4cb9..0bade8ee51 100644
--- a/src/all.test.js
+++ b/src/all.test.js
@@ -1,8 +1,12 @@
+/**
+ * @jest-environment ./lib/puppeteer/environment.js
+ */
 /* eslint-env jest */
 
 const util = require('util')
 
 const configPaths = require('../config/paths.json')
+const PORT = configPaths.ports.test
 
 const sass = require('node-sass')
 const sassRender = util.promisify(sass.render)
@@ -11,7 +15,31 @@ const sassConfig = {
   includePaths: [ configPaths.src ]
 }
 
+let browser
+let page
+let baseUrl = 'http://localhost:' + PORT
+
+beforeAll(async (done) => {
+  browser = global.__BROWSER__
+  page = await browser.newPage()
+  done()
+})
+
+afterAll(async (done) => {
+  await page.close()
+  done()
+})
+
 describe('GOV.UK Frontend', () => {
+  describe('javascript', async() => {
+    it('can be accessed via `GOVUKFrontend`', async () => {
+      await page.goto(baseUrl + '/', { waitUntil: 'load' })
+
+      const GOVUKFrontendGlobal = await page.evaluate(() => window.GOVUKFrontend)
+
+      expect(typeof GOVUKFrontendGlobal).toBe('object')
+    })
+  })
   describe('global styles', async() => {
     it('are disabled by default', async () => {
       const sass = `
diff --git a/tasks/gulp/compile-assets.js b/tasks/gulp/compile-assets.js
index 74b2895f43..077ee4c491 100644
--- a/tasks/gulp/compile-assets.js
+++ b/tasks/gulp/compile-assets.js
@@ -104,6 +104,8 @@ gulp.task('js:compile', () => {
     srcFiles
   ])
     .pipe(rollup({
+      // Used to set the `window` global and UMD/AMD export name.
+      name: 'GOVUKFrontend',
       // Legacy mode is required for IE8 support
       legacy: true,
       // UMD allows the published bundle to work in CommonJS and in the browser.

From 111e455a00c204ebde343d2fa36dcef5bca8018b Mon Sep 17 00:00:00 2001
From: Nick Colley <nick.colley@digital.cabinet-office.gov.uk>
Date: Fri, 1 Jun 2018 14:47:32 +0100
Subject: [PATCH 2/2] Update CHANGELOG

---
 CHANGELOG.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 438b5c9d70..ac6ce4ef28 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -19,6 +19,11 @@ Note: We're not following semantic versioning yet, we are going to talk about th
   nunjucks paths.
   ([PR #743](https://github.com/alphagov/govuk-frontend/pull/743))
 
+- Update JavaScript global namespace from 'all' to 'GOVUKFrontend',
+  we intend to allow users to initialize components from this namespace.
+  ([PR #747](https://github.com/alphagov/govuk-frontend/pull/747))
+
+
 🆕 New features:
 
 - Add `beforeContent` block to the template, for content that does not belong inside `<main>` element.