Deprecate govuk/all.scss and only reference govuk/index.scss internally

.github/workflows/sass.yaml

@@ -38,12 +38,12 @@ jobs:
       - name: Run command
         run: |
           mkdir -p .tmp
-          time sass packages/govuk-frontend/src/govuk/all.scss > .tmp/all.css
+          time sass packages/govuk-frontend/src/govuk/index.scss > .tmp/index.css
 
       # Check output for uncompiled Sass
       - name: Check output
         run: |
-          ! grep "\$govuk-" .tmp/all.css
+          ! grep "\$govuk-" .tmp/index.css
 
   dart-sass-latest:
     name: Dart Sass v1 (latest)
@@ -73,12 +73,12 @@ jobs:
       - name: Run command
         run: |
           mkdir -p .tmp
-          time sh -c 'echo "@import "\""govuk/all"\"";" | sass --stdin --quiet-deps --load-path=packages/govuk-frontend/src > .tmp/all.css'
+          time sh -c 'echo "@import "\""govuk/all"\"";" | sass --stdin --quiet-deps --load-path=packages/govuk-frontend/src > .tmp/index.css'
 
       # Check output for uncompiled Sass
       - name: Check output
         run: |
-          ! grep "\$govuk-" .tmp/all.css
+          ! grep "\$govuk-" .tmp/index.css
 
   # Node Sass v3.7.0 = LibSass v3.5.0
   lib-sass:
@@ -103,12 +103,12 @@ jobs:
       - name: Run command
         run: |
           mkdir -p .tmp
-          time node-sass packages/govuk-frontend/src/govuk/all.scss > .tmp/all.css
+          time node-sass packages/govuk-frontend/src/govuk/index.scss > .tmp/index.css
 
       # Check output for uncompiled Sass
       - name: Check output
         run: |
-          ! grep "\$govuk-" .tmp/all.css
+          ! grep "\$govuk-" .tmp/index.css
 
   # Node Sass v8.x = LibSass v3 latest
   lib-sass-latest:
@@ -133,12 +133,12 @@ jobs:
       - name: Run command
         run: |
           mkdir -p .tmp
-          time node-sass packages/govuk-frontend/src/govuk/all.scss > .tmp/all.css
+          time node-sass packages/govuk-frontend/src/govuk/index.scss > .tmp/index.css
 
       # Check output for uncompiled Sass
       - name: Check output
         run: |
-          ! grep "\$govuk-" .tmp/all.css
+          ! grep "\$govuk-" .tmp/index.css
 
   ruby-sass:
     name: Ruby Sass v3.4.0 (deprecated)
@@ -161,12 +161,12 @@ jobs:
       - name: Run command
         run: |
           mkdir -p .tmp
-          time sass packages/govuk-frontend/src/govuk/all.scss > .tmp/all.css
+          time sass packages/govuk-frontend/src/govuk/index.scss > .tmp/index.css
 
       # Check output for uncompiled Sass
       - name: Check output
         run: |
-          ! grep "\$govuk-" .tmp/all.css
+          ! grep "\$govuk-" .tmp/index.css
 
   ruby-sass-latest:
     name: Ruby Sass v3 (latest, deprecated)
@@ -189,9 +189,9 @@ jobs:
       - name: Run command
         run: |
           mkdir -p .tmp
-          time sass packages/govuk-frontend/src/govuk/all.scss > .tmp/all.css
+          time sass packages/govuk-frontend/src/govuk/index.scss > .tmp/index.css
 
       # Check output for uncompiled Sass
       - name: Check output
         run: |
-          ! grep "\$govuk-" .tmp/all.css
+          ! grep "\$govuk-" .tmp/index.css

docs/contributing/coding-standards/components.md

@@ -12,7 +12,7 @@ When creating your component, you should create the following files in the compo
 
 - `README.md` - Summary documentation with links to the installation instructions and component documentation on <https://design-system.service.gov.uk/>
 - `_[component-name].scss` - An SCSS file to generate the styles for this component only. It delegates the CSS generation to the \_index.scss file.
-- `_index.scss` - The actual styles for the component that you can import in 2 ways - [on their own using `[component-name].scss`](https://frontend.design-system.service.gov.uk/importing-css-assets-and-javascript/#import-specific-parts-of-the-css) or [alongside other components in `components/_all.scss`](https://frontend.design-system.service.gov.uk/importing-css-assets-and-javascript/#import-specific-parts-of-the-css)
+- `_index.scss` - The actual styles for the component that you can import in 2 ways - [on their own using `[component-name].scss`](https://frontend.design-system.service.gov.uk/importing-css-assets-and-javascript/#import-specific-parts-of-the-css) or [alongside other components in `components/_index.scss`](https://frontend.design-system.service.gov.uk/importing-css-assets-and-javascript/#import-specific-parts-of-the-css)
 - `[component-name].yaml` - Lists the component's Nunjucks macro options and includes examples using these options. Both the options and examples are used to generate component documentation in the review app. The examples are also used to test component behaviour, and to generate [fixtures for testing alternative implementations of the design system](https://frontend.design-system.service.gov.uk/testing-your-html/).
 - `macro.njk` - The main entry point for rendering the component. It provides a `govuk[ComponentName](params)` macro, delegating render to the `template.njk` file
 - `template.njk` - The template used for rendering the component using any `params` provided to the macro

packages/govuk-frontend-review/src/stylesheets/app.scss

@@ -4,7 +4,7 @@ $govuk-new-organisation-colours: true;
 
 $govuk-suppressed-warnings: ("organisation-colours");
 
-@import "govuk/all";
+@import "govuk/index";
 @import "partials/app";
 @import "partials/code";
 @import "partials/banner";

packages/govuk-frontend-review/tasks/watch.mjs

@@ -43,7 +43,7 @@ function getTasks(options) {
     ),
     'compile:scss watch': () =>
       gulp.watch(
-        ['**/*.scss', join(paths.package, 'dist/govuk/all.scss')],
+        ['**/*.scss', join(paths.package, 'dist/govuk/index.scss')],
         {
           awaitWriteFinish: true,
           cwd: options.srcPath,

packages/govuk-frontend/package.json

@@ -4,7 +4,7 @@
   "version": "5.7.1",
   "main": "dist/govuk/all.bundle.js",
   "module": "dist/govuk/all.mjs",
-  "sass": "dist/govuk/all.scss",
+  "sass": "dist/govuk/index.scss",
   "files": [
     "dist",
     "govuk-prototype-kit.config.json",
@@ -13,7 +13,7 @@
   ],
   "exports": {
     ".": {
-      "sass": "./dist/govuk/all.scss",
+      "sass": "./dist/govuk/index.scss",
       "import": "./dist/govuk/all.mjs",
       "require": "./dist/govuk/all.bundle.js",
       "default": "./dist/govuk/all.bundle.js"

packages/govuk-frontend/src/govuk/all.scss

@@ -1 +1,8 @@
+@import "settings/warnings";
 @import "index";
+
+@include _warning(
+  "import-using-all",
+  "Importing using 'govuk/all' is deprecated. Update your import statement to import 'govuk/index'.",
+  $silence-further-warnings: false
+);

packages/govuk-frontend/src/govuk/all.unit.test.mjs

@@ -114,6 +114,20 @@ describe('GOV.UK Frontend', () => {
       }
     })
 
+    it('outputs a warning when importing the "all" file at root', async () => {
+      const sass = `
+      @import "all";
+      `
+
+      await compileSassString(sass, sassConfig)
+
+      expect(mockWarnFunction.mock.calls[0]).toEqual(
+        expect.arrayContaining([
+          `Importing using 'govuk/all' is deprecated. Update your import statement to import 'govuk/index'. To silence this warning, update $govuk-suppressed-warnings with key: "import-using-all"`
+        ])
+      )
+    })
+
     it('outputs a warning for each layer that has an "all" file', async () => {
       const sass = `
       /* equivalent to importing 'base' */

packages/govuk-frontend/tasks/build/package.unit.test.mjs

@@ -109,8 +109,8 @@ describe('packages/govuk-frontend/dist/', () => {
 
       // Only sass package entry is compiled to minified CSS bundle
       .flatMap(
-        mapPathTo(['**/govuk/all.scss'], ({ dir: requirePath }) => [
-          join(requirePath, 'all.scss'),
+        mapPathTo(['**/govuk/index.scss'], ({ dir: requirePath }) => [
+          join(requirePath, 'index.scss'),
 
           // CSS bundle, minified
           join(requirePath, 'govuk-frontend.min.css'),
@@ -163,9 +163,9 @@ describe('packages/govuk-frontend/dist/', () => {
   })
 
   describe('Sass stylesheets', () => {
-    describe('all.scss', () => {
+    describe('index.scss', () => {
       it('should compile without throwing an exception', async () => {
-        const file = join(paths.package, 'dist/govuk/all.scss')
+        const file = join(paths.package, 'dist/govuk/index.scss')
         await expect(compileSassFile(file)).resolves.not.toThrow()
       })
     })

packages/govuk-frontend/tasks/build/release.mjs

@@ -46,7 +46,7 @@ export default (options) =>
 
     // Compile GOV.UK Frontend Sass
     task.name('compile:scss', () =>
-      styles.compile('all.scss', {
+      styles.compile('index.scss', {
         ...options,
 
         srcPath: join(options.srcPath, 'govuk'),

packages/govuk-frontend/tasks/build/release.unit.test.mjs

@@ -81,7 +81,7 @@ describe('dist/', () => {
 
     it('should contain relative paths to sources', () => {
       expect(sourcemap.sources).toContain(
-        '../packages/govuk-frontend/src/govuk/all.scss'
+        '../packages/govuk-frontend/src/govuk/index.scss'
       )
       expect(sourcemap.sources).toContain(
         '../packages/govuk-frontend/src/govuk/core/_govuk-frontend-properties.scss'

packages/govuk-frontend/tasks/styles.mjs

@@ -15,7 +15,7 @@ export const compile = (options) =>
      * Compile GOV.UK Frontend Sass
      */
     task.name('compile:scss', () =>
-      styles.compile('all.scss', {
+      styles.compile('index.scss', {
         ...options,
 
         srcPath: join(options.srcPath, 'govuk'),